chore: import upstream snapshot with attribution

scripts/docs/move-i18n-mirrors.mjs

@@ -0,0 +1,143 @@
+#!/usr/bin/env node
+// One-shot: FASE 3 helper, safe to delete after merge.
+//
+// Moves existing i18n mirror docs from `docs/i18n/<lang>/docs/X.md` into the
+// matching subfolder `docs/i18n/<lang>/docs/<sub>/X.md`, mirroring the new
+// docs/ layout. Uses `git mv` to preserve history.
+//
+// Usage:
+//   node scripts/docs/move-i18n-mirrors.mjs [--dry]
+//
+// Notes:
+// - Skips files that don't appear in DOC_TO_SUBFOLDER (e.g., the legacy
+//   `cloudflare-zero-trust-guide.md` or `features/` subfolder — those will be
+//   handled in FASE 5 when translations are regenerated).
+// - Idempotent: if the target already lives under a subfolder, the entry is
+//   skipped.
+
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { execFileSync } from "node:child_process";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const ROOT = path.resolve(__dirname, "..", "..");
+const I18N_DIR = path.join(ROOT, "docs", "i18n");
+
+const DRY = process.argv.includes("--dry");
+
+const DOC_TO_SUBFOLDER = {
+  // architecture
+  "ARCHITECTURE.md": "architecture",
+  "CODEBASE_DOCUMENTATION.md": "architecture",
+  "REPOSITORY_MAP.md": "architecture",
+  "AUTHZ_GUIDE.md": "architecture",
+  "RESILIENCE_GUIDE.md": "architecture",
+  // guides
+  "SETUP_GUIDE.md": "guides",
+  "USER_GUIDE.md": "guides",
+  "DOCKER_GUIDE.md": "guides",
+  "ELECTRON_GUIDE.md": "guides",
+  "TERMUX_GUIDE.md": "guides",
+  "PWA_GUIDE.md": "guides",
+  "TROUBLESHOOTING.md": "guides",
+  "UNINSTALL.md": "guides",
+  "I18N.md": "guides",
+  "FEATURES.md": "guides",
+  // reference
+  "API_REFERENCE.md": "reference",
+  "PROVIDER_REFERENCE.md": "reference",
+  "openapi.yaml": "reference",
+  "ENVIRONMENT.md": "reference",
+  "CLI-TOOLS.md": "reference",
+  "FREE_TIERS.md": "reference",
+  // frameworks
+  "MCP-SERVER.md": "frameworks",
+  "A2A-SERVER.md": "frameworks",
+  "AGENT_PROTOCOLS_GUIDE.md": "frameworks",
+  "CLOUD_AGENT.md": "frameworks",
+  "SKILLS.md": "frameworks",
+  "MEMORY.md": "frameworks",
+  "WEBHOOKS.md": "frameworks",
+  "EVALS.md": "frameworks",
+  // routing
+  "AUTO-COMBO.md": "routing",
+  "REASONING_REPLAY.md": "routing",
+  // security
+  "GUARDRAILS.md": "security",
+  "COMPLIANCE.md": "security",
+  "STEALTH_GUIDE.md": "security",
+  // compression
+  "COMPRESSION_GUIDE.md": "compression",
+  "COMPRESSION_ENGINES.md": "compression",
+  "COMPRESSION_RULES_FORMAT.md": "compression",
+  "COMPRESSION_LANGUAGE_PACKS.md": "compression",
+  "RTK_COMPRESSION.md": "compression",
+  // ops
+  "RELEASE_CHECKLIST.md": "ops",
+  "COVERAGE_PLAN.md": "ops",
+  "FLY_IO_DEPLOYMENT_GUIDE.md": "ops",
+  "VM_DEPLOYMENT_GUIDE.md": "ops",
+  "PROXY_GUIDE.md": "ops",
+  "TUNNELS_GUIDE.md": "ops",
+};
+
+let moved = 0;
+let skipped = 0;
+const seenLocales = [];
+
+for (const locale of fs.readdirSync(I18N_DIR)) {
+  const localeDir = path.join(I18N_DIR, locale);
+  const stat = fs.statSync(localeDir);
+  if (!stat.isDirectory()) continue;
+  const docsDir = path.join(localeDir, "docs");
+  if (!fs.existsSync(docsDir)) continue;
+  seenLocales.push(locale);
+
+  for (const fname of fs.readdirSync(docsDir)) {
+    const sub = DOC_TO_SUBFOLDER[fname];
+    if (!sub) continue; // not in our mapping (e.g. features/, cloudflare-zero-trust-guide.md)
+
+    const src = path.join(docsDir, fname);
+    if (!fs.statSync(src).isFile()) continue;
+
+    const subDir = path.join(docsDir, sub);
+    const dst = path.join(subDir, fname);
+
+    if (fs.existsSync(dst)) {
+      skipped++;
+      continue;
+    }
+
+    if (DRY) {
+      console.log(`would move: ${path.relative(ROOT, src)} -> ${path.relative(ROOT, dst)}`);
+      moved++;
+      continue;
+    }
+
+    if (!fs.existsSync(subDir)) fs.mkdirSync(subDir, { recursive: true });
+    const relSrc = path.relative(ROOT, src);
+    const relDst = path.relative(ROOT, dst);
+    try {
+      execFileSync("git", ["mv", "-k", "--", relSrc, relDst], {
+        cwd: ROOT,
+        stdio: "pipe",
+      });
+      moved++;
+    } catch {
+      // fallback: copy + delete; emulate `|| true` for the rm by ignoring its failure
+      fs.renameSync(src, dst);
+      try {
+        execFileSync("git", ["rm", "--cached", "--", relSrc], { cwd: ROOT, stdio: "pipe" });
+      } catch {
+        // file may not be tracked yet — safe to ignore
+      }
+      execFileSync("git", ["add", "--", relDst], { cwd: ROOT, stdio: "pipe" });
+      moved++;
+    }
+  }
+}
+
+console.log(
+  `[i18n-mirrors] locales=${seenLocales.length} moved=${moved} skipped=${skipped}${DRY ? " (dry-run)" : ""}`
+);