@imenam/mcp-documentor 1.0.99 → 1.0.101

package/scripts/migrate-paths-to-relative.js

@@ -1,196 +1,196 @@
-#!/usr/bin/env node
-/**
- * migrate-paths-to-relative.js
- *
- * One-shot migration that rewrites the absolute paths stored in each doc's
- * `tracked_files[].path` into the portable, code-root-relative form introduced
- * alongside GitHub documentation sync. Portable paths let an agent running on a
- * different machine (where the codebase lives at a different absolute location)
- * resolve tracked files correctly.
- *
- * Resolution reuses the compiled path-resolver (dist/) so it behaves exactly
- * like the running server — RUN `npm run build` FIRST.
- *
- * The conversion uses the code roots of this machine, as the server does: the
- * default root and the per-project roots stored in <data dir>/local-state.json,
- * set from the GUI (project settings) or with the set_code_root tool.
- *
- * A tracked file whose absolute path is NOT under the project's code root is
- * left absolute and reported, so nothing is silently broken.
- *
- * The data dir is resolved like the server: --data-dir flag, else MCP_DATA_DIR,
- * else <package>/data. The MCP_DATA_DIR fallback is what makes npx usable.
- *
- * Usage (from a clone):
- *   node scripts/migrate-paths-to-relative.js [--dry-run] [--data-dir <dir>]
- *
- * Usage (npx install — no clone):
- *   MCP_DATA_DIR="<your data dir>" \
- *     npx -p @imenam/mcp-documentor mcp-documentor-migrate-paths --dry-run
- *
- * This migration is a ONE-TIME operation: run it once on the machine where the
- * stored absolute paths are valid, publish the result (sync_docs / push_docs),
- * and every other machine just pulls and sets its own code roots.
- */
-
-import fs from "fs";
-import path from "path";
-import { fileURLToPath, pathToFileURL } from "url";
-import matter from "gray-matter";
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const rootDir = path.join(__dirname, "..");
-
-const args = process.argv.slice(2);
-const dryRun = args.includes("--dry-run");
-
-// Data dir resolution mirrors the server (StorageEngine.getDataDir):
-//   --data-dir flag  >  MCP_DATA_DIR env  >  <package>/data fallback.
-// The env fallback is what makes `npx` work: the data lives in the user's
-// MCP_DATA_DIR, not inside the npx package cache.
-const dataDirArgIdx = args.indexOf("--data-dir");
-const dataDir =
-  dataDirArgIdx !== -1 && args[dataDirArgIdx + 1]
-    ? args[dataDirArgIdx + 1]
-    : process.env.MCP_DATA_DIR && process.env.MCP_DATA_DIR.trim() !== ""
-      ? process.env.MCP_DATA_DIR.trim()
-      : path.join(rootDir, "data");
-
-// ---------------------------------------------------------------------------
-// Reuse the compiled resolver so migration matches runtime behaviour exactly.
-// ---------------------------------------------------------------------------
-
-const resolverPath = path.join(rootDir, "dist", "src", "core", "path-resolver.js");
-const localStatePath = path.join(rootDir, "dist", "src", "core", "local-state.js");
-if (!fs.existsSync(resolverPath) || !fs.existsSync(localStatePath)) {
-  console.error(`[ERROR] Compiled resolver not found at: ${resolverPath}`);
-  console.error("        Run `npm run build` before this migration.");
-  process.exit(1);
-}
-const { getCodeRoot, toStoredPath, setCodeRootProvider } = await import(pathToFileURL(resolverPath).href);
-const { LocalState } = await import(pathToFileURL(localStatePath).href);
-const localState = new LocalState(dataDir);
-setCodeRootProvider((project) => localState.getCodeRoot(project));
-
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-
-function walkMdFiles(dir) {
-  if (!fs.existsSync(dir)) return [];
-  const results = [];
-  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
-    const fullPath = path.join(dir, entry.name);
-    if (entry.isDirectory()) {
-      results.push(...walkMdFiles(fullPath));
-    } else if (entry.isFile() && entry.name.endsWith(".md")) {
-      results.push(fullPath);
-    }
-  }
-  return results;
-}
-
-function filePathToDocId(filePath, projectDir) {
-  return path.relative(projectDir, filePath).replace(/\.md$/, "").split(path.sep).join("/");
-}
-
-// ---------------------------------------------------------------------------
-// Load config
-// ---------------------------------------------------------------------------
-
-const configPath = path.join(dataDir, "config.json");
-if (!fs.existsSync(configPath)) {
-  console.error(`[ERROR] config.json not found at: ${configPath}`);
-  console.error("        Make sure --data-dir points to the right directory.");
-  process.exit(1);
-}
-
-const config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
-const projects = config.projects ?? ["default"];
-
-console.log(`${dryRun ? "[DRY RUN] " : ""}migrate-paths-to-relative`);
-console.log(`Data dir : ${dataDir}`);
-console.log(`Projects : ${projects.length}`);
-console.log("");
-
-// ---------------------------------------------------------------------------
-// Migrate
-// ---------------------------------------------------------------------------
-
-let totalDocsChanged = 0;
-let totalConverted = 0;
-let totalLeftAbsolute = 0;
-const projectsWithoutRoot = [];
-
-for (const project of projects) {
-  const root = getCodeRoot(project);
-  if (!root) {
-    projectsWithoutRoot.push(project);
-    continue;
-  }
-
-  const projectDir = path.join(dataDir, "projects", project);
-  const files = walkMdFiles(projectDir);
-  if (files.length === 0) continue;
-
-  const docChanges = [];
-
-  for (const filePath of files) {
-    const fullId = filePathToDocId(filePath, projectDir);
-    const parsed = matter(fs.readFileSync(filePath, "utf-8"));
-    const tracked = parsed.data.tracked_files;
-    if (!Array.isArray(tracked) || tracked.length === 0) continue;
-
-    let docChanged = false;
-    for (const tf of tracked) {
-      if (!tf || typeof tf.path !== "string") continue;
-      if (!path.isAbsolute(tf.path)) continue; // already relative
-
-      const stored = toStoredPath(tf.path, project);
-      if (path.isAbsolute(stored)) {
-        // Outside the root (or different drive) — resolver kept it absolute.
-        totalLeftAbsolute++;
-        docChanges.push(`  [${fullId}] KEPT ABSOLUTE (outside root): ${tf.path}`);
-        continue;
-      }
-
-      docChanges.push(`  [${fullId}] "${tf.path}"  →  "${stored}"`);
-      tf.path = stored;
-      docChanged = true;
-      totalConverted++;
-    }
-
-    if (docChanged) {
-      totalDocsChanged++;
-      if (!dryRun) {
-        fs.writeFileSync(filePath, matter.stringify(parsed.content, parsed.data), "utf-8");
-      }
-    }
-  }
-
-  if (docChanges.length > 0) {
-    console.log(`### Project: ${project}  (root: ${root})`);
-    docChanges.forEach((c) => console.log(c));
-    console.log("");
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Summary
-// ---------------------------------------------------------------------------
-
-console.log("─".repeat(60));
-console.log(`Paths converted to relative : ${totalConverted}`);
-console.log(`Paths kept absolute         : ${totalLeftAbsolute}  ← outside the code root`);
-console.log(`Docs modified               : ${totalDocsChanged}`);
-if (projectsWithoutRoot.length > 0) {
-  console.log("");
-  console.log(`Projects skipped (no code root configured): ${projectsWithoutRoot.length}`);
-  console.log(`  ${projectsWithoutRoot.join(", ")}`);
-  console.log("  → set their code root (project settings in the GUI, or set_code_root) to migrate them.");
-}
-
-if (dryRun) {
-  console.log("");
-  console.log("[DRY RUN] No files were modified. Run without --dry-run to apply.");
-}
+#!/usr/bin/env node
+/**
+ * migrate-paths-to-relative.js
+ *
+ * One-shot migration that rewrites the absolute paths stored in each doc's
+ * `tracked_files[].path` into the portable, code-root-relative form introduced
+ * alongside GitHub documentation sync. Portable paths let an agent running on a
+ * different machine (where the codebase lives at a different absolute location)
+ * resolve tracked files correctly.
+ *
+ * Resolution reuses the compiled path-resolver (dist/) so it behaves exactly
+ * like the running server — RUN `npm run build` FIRST.
+ *
+ * The conversion uses the code roots of this machine, as the server does: the
+ * default root and the per-project roots stored in <data dir>/local-state.json,
+ * set from the GUI (project settings) or with the set_code_root tool.
+ *
+ * A tracked file whose absolute path is NOT under the project's code root is
+ * left absolute and reported, so nothing is silently broken.
+ *
+ * The data dir is resolved like the server: --data-dir flag, else MCP_DATA_DIR,
+ * else <package>/data. The MCP_DATA_DIR fallback is what makes npx usable.
+ *
+ * Usage (from a clone):
+ *   node scripts/migrate-paths-to-relative.js [--dry-run] [--data-dir <dir>]
+ *
+ * Usage (npx install — no clone):
+ *   MCP_DATA_DIR="<your data dir>" \
+ *     npx -p @imenam/mcp-documentor mcp-documentor-migrate-paths --dry-run
+ *
+ * This migration is a ONE-TIME operation: run it once on the machine where the
+ * stored absolute paths are valid, publish the result (sync_docs / push_docs),
+ * and every other machine just pulls and sets its own code roots.
+ */
+
+import fs from "fs";
+import path from "path";
+import { fileURLToPath, pathToFileURL } from "url";
+import matter from "gray-matter";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const rootDir = path.join(__dirname, "..");
+
+const args = process.argv.slice(2);
+const dryRun = args.includes("--dry-run");
+
+// Data dir resolution mirrors the server (StorageEngine.getDataDir):
+//   --data-dir flag  >  MCP_DATA_DIR env  >  <package>/data fallback.
+// The env fallback is what makes `npx` work: the data lives in the user's
+// MCP_DATA_DIR, not inside the npx package cache.
+const dataDirArgIdx = args.indexOf("--data-dir");
+const dataDir =
+  dataDirArgIdx !== -1 && args[dataDirArgIdx + 1]
+    ? args[dataDirArgIdx + 1]
+    : process.env.MCP_DATA_DIR && process.env.MCP_DATA_DIR.trim() !== ""
+      ? process.env.MCP_DATA_DIR.trim()
+      : path.join(rootDir, "data");
+
+// ---------------------------------------------------------------------------
+// Reuse the compiled resolver so migration matches runtime behaviour exactly.
+// ---------------------------------------------------------------------------
+
+const resolverPath = path.join(rootDir, "dist", "src", "core", "path-resolver.js");
+const localStatePath = path.join(rootDir, "dist", "src", "core", "local-state.js");
+if (!fs.existsSync(resolverPath) || !fs.existsSync(localStatePath)) {
+  console.error(`[ERROR] Compiled resolver not found at: ${resolverPath}`);
+  console.error("        Run `npm run build` before this migration.");
+  process.exit(1);
+}
+const { getCodeRoot, toStoredPath, setCodeRootProvider } = await import(pathToFileURL(resolverPath).href);
+const { LocalState } = await import(pathToFileURL(localStatePath).href);
+const localState = new LocalState(dataDir);
+setCodeRootProvider((project) => localState.getCodeRoot(project));
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+function walkMdFiles(dir) {
+  if (!fs.existsSync(dir)) return [];
+  const results = [];
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const fullPath = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      results.push(...walkMdFiles(fullPath));
+    } else if (entry.isFile() && entry.name.endsWith(".md")) {
+      results.push(fullPath);
+    }
+  }
+  return results;
+}
+
+function filePathToDocId(filePath, projectDir) {
+  return path.relative(projectDir, filePath).replace(/\.md$/, "").split(path.sep).join("/");
+}
+
+// ---------------------------------------------------------------------------
+// Load config
+// ---------------------------------------------------------------------------
+
+const configPath = path.join(dataDir, "config.json");
+if (!fs.existsSync(configPath)) {
+  console.error(`[ERROR] config.json not found at: ${configPath}`);
+  console.error("        Make sure --data-dir points to the right directory.");
+  process.exit(1);
+}
+
+const config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+const projects = config.projects ?? ["default"];
+
+console.log(`${dryRun ? "[DRY RUN] " : ""}migrate-paths-to-relative`);
+console.log(`Data dir : ${dataDir}`);
+console.log(`Projects : ${projects.length}`);
+console.log("");
+
+// ---------------------------------------------------------------------------
+// Migrate
+// ---------------------------------------------------------------------------
+
+let totalDocsChanged = 0;
+let totalConverted = 0;
+let totalLeftAbsolute = 0;
+const projectsWithoutRoot = [];
+
+for (const project of projects) {
+  const root = getCodeRoot(project);
+  if (!root) {
+    projectsWithoutRoot.push(project);
+    continue;
+  }
+
+  const projectDir = path.join(dataDir, "projects", project);
+  const files = walkMdFiles(projectDir);
+  if (files.length === 0) continue;
+
+  const docChanges = [];
+
+  for (const filePath of files) {
+    const fullId = filePathToDocId(filePath, projectDir);
+    const parsed = matter(fs.readFileSync(filePath, "utf-8"));
+    const tracked = parsed.data.tracked_files;
+    if (!Array.isArray(tracked) || tracked.length === 0) continue;
+
+    let docChanged = false;
+    for (const tf of tracked) {
+      if (!tf || typeof tf.path !== "string") continue;
+      if (!path.isAbsolute(tf.path)) continue; // already relative
+
+      const stored = toStoredPath(tf.path, project);
+      if (path.isAbsolute(stored)) {
+        // Outside the root (or different drive) — resolver kept it absolute.
+        totalLeftAbsolute++;
+        docChanges.push(`  [${fullId}] KEPT ABSOLUTE (outside root): ${tf.path}`);
+        continue;
+      }
+
+      docChanges.push(`  [${fullId}] "${tf.path}"  →  "${stored}"`);
+      tf.path = stored;
+      docChanged = true;
+      totalConverted++;
+    }
+
+    if (docChanged) {
+      totalDocsChanged++;
+      if (!dryRun) {
+        fs.writeFileSync(filePath, matter.stringify(parsed.content, parsed.data), "utf-8");
+      }
+    }
+  }
+
+  if (docChanges.length > 0) {
+    console.log(`### Project: ${project}  (root: ${root})`);
+    docChanges.forEach((c) => console.log(c));
+    console.log("");
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Summary
+// ---------------------------------------------------------------------------
+
+console.log("─".repeat(60));
+console.log(`Paths converted to relative : ${totalConverted}`);
+console.log(`Paths kept absolute         : ${totalLeftAbsolute}  ← outside the code root`);
+console.log(`Docs modified               : ${totalDocsChanged}`);
+if (projectsWithoutRoot.length > 0) {
+  console.log("");
+  console.log(`Projects skipped (no code root configured): ${projectsWithoutRoot.length}`);
+  console.log(`  ${projectsWithoutRoot.join(", ")}`);
+  console.log("  → set their code root (project settings in the GUI, or set_code_root) to migrate them.");
+}
+
+if (dryRun) {
+  console.log("");
+  console.log("[DRY RUN] No files were modified. Run without --dry-run to apply.");
+}

package/gui/dist/assets/channel-CXrvaRTy.js

@@ -1 +0,0 @@
-import{ao as r,ap as n}from"./DocContent-ByGAvCaA.js";const t=(a,o)=>r.lang.round(n.parse(a)[o]);export{t as c};