@agent-native/core 0.85.7 → 0.86.0

package/dist/cli/visualize-repo.js

@@ -0,0 +1,561 @@
+import fs from "node:fs";
+import path from "node:path";
+import { assertLocalPlanFilesValid, readLocalPlanFiles, startLocalPlanBridge, verifyLocalPlanBridge, } from "./plan-local.js";
+const APP_ID = "visualize-repo";
+const MANIFEST_FILE = "agent-native.json";
+const DEFAULT_VISUAL_DOCS_ROOT = ".agent-native/visual-docs";
+const DEFAULT_VISUAL_DOCS_DIR = ".agent-native/visual-docs/repo-overview";
+const DEFAULT_TITLE = "Repo Visual Docs";
+const DEFAULT_BRIEF = "A local, repo-backed visual documentation workspace for code review and agent handoff.";
+const DEFAULT_HIDE = [
+    "**/node_modules/**",
+    "**/.git/**",
+    "**/dist/**",
+    "**/build/**",
+    "**/.agent-native/**",
+];
+const COMMANDS = new Set(["init", "serve", "open", "check", "verify", "help"]);
+function isRecord(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function normalizeSlash(value) {
+    return value.replace(/\\/g, "/");
+}
+function stringFlagValue(argv, index, flag) {
+    const value = argv[index + 1];
+    if (!value || value.startsWith("-")) {
+        throw new Error(`${flag} requires a value`);
+    }
+    return value;
+}
+function parsePort(value) {
+    const port = Number.parseInt(value, 10);
+    if (!Number.isInteger(port) || port < 0 || port > 65535) {
+        throw new Error("--port must be an integer between 0 and 65535.");
+    }
+    return port;
+}
+export function parseVisualizeRepoArgs(argv) {
+    const [first, ...rest] = argv;
+    const command = COMMANDS.has(first ?? "")
+        ? first
+        : "serve";
+    const args = command === "serve" && first && !COMMANDS.has(first) ? argv : rest;
+    const parsed = {
+        command,
+        targets: [],
+        open: true,
+        dryRun: false,
+        json: false,
+        force: false,
+        help: command === "help",
+    };
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === "help" || arg === "--help" || arg === "-h") {
+            parsed.help = true;
+        }
+        else if (arg === "--dir") {
+            parsed.dir = stringFlagValue(args, index, arg);
+            index += 1;
+        }
+        else if (arg.startsWith("--dir=")) {
+            parsed.dir = arg.slice("--dir=".length);
+        }
+        else if (arg === "--root") {
+            parsed.root = stringFlagValue(args, index, arg);
+            index += 1;
+        }
+        else if (arg.startsWith("--root=")) {
+            parsed.root = arg.slice("--root=".length);
+        }
+        else if (arg === "--target") {
+            parsed.targets.push(stringFlagValue(args, index, arg));
+            index += 1;
+        }
+        else if (arg.startsWith("--target=")) {
+            parsed.targets.push(arg.slice("--target=".length));
+        }
+        else if (arg === "--title") {
+            parsed.title = stringFlagValue(args, index, arg);
+            index += 1;
+        }
+        else if (arg.startsWith("--title=")) {
+            parsed.title = arg.slice("--title=".length);
+        }
+        else if (arg === "--brief") {
+            parsed.brief = stringFlagValue(args, index, arg);
+            index += 1;
+        }
+        else if (arg.startsWith("--brief=")) {
+            parsed.brief = arg.slice("--brief=".length);
+        }
+        else if (arg === "--app-url") {
+            parsed.appUrl = stringFlagValue(args, index, arg);
+            index += 1;
+        }
+        else if (arg.startsWith("--app-url=")) {
+            parsed.appUrl = arg.slice("--app-url=".length);
+        }
+        else if (arg === "--host") {
+            parsed.host = stringFlagValue(args, index, arg);
+            index += 1;
+        }
+        else if (arg.startsWith("--host=")) {
+            parsed.host = arg.slice("--host=".length);
+        }
+        else if (arg === "--port") {
+            parsed.port = parsePort(stringFlagValue(args, index, arg));
+            index += 1;
+        }
+        else if (arg.startsWith("--port=")) {
+            parsed.port = parsePort(arg.slice("--port=".length));
+        }
+        else if (arg === "--open") {
+            parsed.open = true;
+        }
+        else if (arg === "--no-open") {
+            parsed.open = false;
+        }
+        else if (arg === "--dry-run") {
+            parsed.dryRun = true;
+        }
+        else if (arg === "--json") {
+            parsed.json = true;
+        }
+        else if (arg === "--force") {
+            parsed.force = true;
+        }
+        else if (arg.startsWith("-")) {
+            throw new Error(`Unknown option: ${arg}`);
+        }
+        else {
+            parsed.targets.push(arg);
+        }
+    }
+    return parsed;
+}
+function findWorkspaceRoot(cwd) {
+    let current = path.resolve(cwd);
+    for (;;) {
+        if (fs.existsSync(path.join(current, MANIFEST_FILE)) ||
+            fs.existsSync(path.join(current, "package.json")) ||
+            fs.existsSync(path.join(current, ".git"))) {
+            return current;
+        }
+        const parent = path.dirname(current);
+        if (parent === current)
+            return path.resolve(cwd);
+        current = parent;
+    }
+}
+async function readManifest(manifestPath) {
+    try {
+        const parsed = JSON.parse(await fs.promises.readFile(manifestPath, "utf8"));
+        if (!isRecord(parsed)) {
+            throw new Error(`${MANIFEST_FILE} must contain a JSON object`);
+        }
+        return parsed;
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return { version: 1 };
+        }
+        throw error;
+    }
+}
+function slugify(value) {
+    const slug = normalizeSlash(value)
+        .toLowerCase()
+        .replace(/[^a-z0-9/._-]+/g, "-")
+        .replace(/[/.]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return slug || "target";
+}
+function titleFromPath(value) {
+    const clean = value
+        .replace(/\/\*\*.*$/, "")
+        .replace(/\.(tsx?|jsx?|mdx?)$/, "");
+    return (path
+        .basename(clean)
+        .replace(/[-_]+/g, " ")
+        .replace(/\s+/g, " ")
+        .trim()
+        .replace(/\b\w/g, (char) => char.toUpperCase()) || "Repo target");
+}
+function inferKind(include) {
+    const normalized = normalizeSlash(include);
+    if (normalized.includes("actions/") || normalized.endsWith("actions")) {
+        return "api";
+    }
+    if (normalized.includes("schema") || normalized.includes("db/")) {
+        return "model";
+    }
+    if (normalized.includes("components/") ||
+        normalized.endsWith("/components") ||
+        normalized === "components") {
+        return "component";
+    }
+    if (normalized.includes("pages/") || normalized.includes("routes/")) {
+        return "flow";
+    }
+    if (normalized.includes("docs/") || normalized.endsWith(".mdx")) {
+        return "docs";
+    }
+    return "area";
+}
+function blocksForKind(kind) {
+    switch (kind) {
+        case "api":
+            return ["api-endpoint", "diagram", "annotated-code"];
+        case "model":
+            return ["data-model", "diagram", "annotated-code"];
+        case "component":
+            return ["wireframe", "states", "annotated-code"];
+        case "flow":
+            return ["wireframe", "diagram", "annotated-code"];
+        case "docs":
+            return ["rich-text", "diagram"];
+        case "area":
+            return ["file-tree", "diagram", "annotated-code"];
+    }
+}
+function targetFromInclude(include) {
+    const normalized = normalizeSlash(include).replace(/^\.\/+/, "");
+    const kind = inferKind(normalized);
+    return {
+        id: slugify(normalized),
+        name: titleFromPath(normalized),
+        kind,
+        include: [normalized],
+        blocks: blocksForKind(kind),
+        policy: kind === "api" || kind === "model" ? "required-on-pr" : "seed",
+    };
+}
+function fileExists(root, rel) {
+    return fs.existsSync(path.join(root, rel));
+}
+function recommendedTargets(workspaceRoot) {
+    const candidates = [];
+    const add = (rel) => {
+        if (fileExists(workspaceRoot, rel))
+            candidates.push(rel);
+    };
+    add("actions");
+    add("app/components");
+    add("app/pages");
+    add("app/routes");
+    add("server/db/schema.ts");
+    add("server/db/schema.tsx");
+    add("src");
+    add("packages");
+    add("templates");
+    add("docs");
+    add("content");
+    return candidates.slice(0, 12).map(targetFromInclude);
+}
+function normalizeTargets(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.filter(isRecord).map((entry) => {
+        const include = Array.isArray(entry.include)
+            ? entry.include.filter((item) => typeof item === "string")
+            : typeof entry.path === "string"
+                ? [entry.path]
+                : [];
+        const first = include[0] ?? "target";
+        const kind = typeof entry.kind === "string"
+            ? entry.kind
+            : inferKind(first);
+        return {
+            id: typeof entry.id === "string" ? entry.id : slugify(first),
+            name: typeof entry.name === "string" ? entry.name : titleFromPath(first),
+            kind,
+            include,
+            blocks: Array.isArray(entry.blocks)
+                ? entry.blocks.filter((item) => typeof item === "string")
+                : blocksForKind(kind),
+            policy: entry.policy === "required-on-pr" ||
+                entry.policy === "update-when-touched" ||
+                entry.policy === "seed"
+                ? entry.policy
+                : "seed",
+        };
+    });
+}
+function mergeTargets(existing, incoming) {
+    const byId = new Map();
+    for (const target of existing)
+        byId.set(target.id, target);
+    for (const target of incoming)
+        byId.set(target.id, target);
+    return Array.from(byId.values());
+}
+function upsertVisualizeManifest(manifest, input) {
+    const next = {
+        ...manifest,
+        version: manifest.version ?? 1,
+    };
+    const apps = isRecord(next.apps) ? { ...next.apps } : {};
+    const existing = isRecord(apps[APP_ID]) ? { ...apps[APP_ID] } : {};
+    apps[APP_ID] = {
+        ...existing,
+        mode: "local-files",
+        root: normalizeSlash(input.docsRoot),
+        entry: normalizeSlash(input.planDir),
+        targets: input.targets,
+        hide: Array.isArray(existing.hide) ? existing.hide : DEFAULT_HIDE,
+    };
+    next.apps = apps;
+    return next;
+}
+function escapeYamlString(value) {
+    return value.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+function targetAnchorList(target) {
+    return target.include.map((item) => `\`${item}\``).join(", ");
+}
+function fileTreeEntries(targets) {
+    return JSON.stringify(targets.flatMap((target) => target.include.map((include) => ({
+        path: include,
+        note: `${target.kind}; ${target.blocks.join(", ")}`,
+    }))));
+}
+function buildPlanMdx(input) {
+    const targetSections = input.targets.flatMap((target, index) => [
+        `## ${index + 1}. ${target.name}`,
+        "",
+        `Source anchors: ${targetAnchorList(target)}`,
+        "",
+        `Recommended blocks: ${target.blocks.map((block) => `\`${block}\``).join(", ")}`,
+        "",
+        `Freshness policy: \`${target.policy}\``,
+        "",
+        "Use this section as the durable visual contract for the code above. Keep it sparse until the target earns more detail, then add API specs, data models, wireframes, diagrams, or annotated code blocks beside the prose.",
+        "",
+    ]);
+    return [
+        "---",
+        `title: "${escapeYamlString(input.title)}"`,
+        `brief: "${escapeYamlString(input.brief)}"`,
+        'kind: "plan"',
+        "localOnly: true",
+        "---",
+        "",
+        `# ${input.title}`,
+        "",
+        input.brief,
+        "",
+        "This workspace is repo-native: the MDX files are local source files, comments stay beside them in `comments.json`, and the Plan UI reads them through the localhost bridge instead of writing the plan to hosted storage.",
+        "",
+        `Manifest: \`${input.manifestRel}\``,
+        "",
+        "## Visualized Targets",
+        "",
+        `<FileTree id="visualized-targets" title="Visualized targets" entries={${fileTreeEntries(input.targets)}} />`,
+        "",
+        ...targetSections,
+        "## Review And Agent Handoff",
+        "",
+        "Comment on sections, diagrams, specs, or wireframes in the local Plan UI. Agent-targeted comments are the queue for a coding agent to update the repo and then patch these MDX files so the visual docs stay current with code.",
+        "",
+    ].join("\n");
+}
+function buildStateJson(input) {
+    return `${JSON.stringify({
+        localOnly: true,
+        kind: "plan",
+        visualDocs: {
+            manifest: input.manifestRel,
+            targets: input.targets.map((target) => target.id),
+        },
+        createdAt: new Date().toISOString(),
+    }, null, 2)}\n`;
+}
+export async function prepareVisualizeRepoWorkspace(options) {
+    const workspaceRoot = findWorkspaceRoot(options.cwd ?? process.cwd());
+    const manifestPath = path.join(workspaceRoot, MANIFEST_FILE);
+    const manifest = await readManifest(manifestPath);
+    const existingApp = isRecord(isRecord(manifest.apps) ? manifest.apps[APP_ID] : undefined)
+        ? manifest.apps[APP_ID]
+        : undefined;
+    const existingRoot = isRecord(existingApp) && typeof existingApp.root === "string"
+        ? existingApp.root
+        : undefined;
+    const existingEntry = isRecord(existingApp) && typeof existingApp.entry === "string"
+        ? existingApp.entry
+        : undefined;
+    const docsRoot = normalizeSlash(options.root ?? existingRoot ?? DEFAULT_VISUAL_DOCS_ROOT);
+    const planDir = normalizeSlash(options.dir ?? existingEntry ?? DEFAULT_VISUAL_DOCS_DIR);
+    const existingTargets = normalizeTargets(isRecord(existingApp) ? existingApp.targets : undefined);
+    const requestedTargets = (options.targets ?? []).map(targetFromInclude);
+    const seedTargets = requestedTargets.length > 0
+        ? mergeTargets(existingTargets, requestedTargets)
+        : existingTargets.length > 0
+            ? existingTargets
+            : recommendedTargets(workspaceRoot);
+    const targets = seedTargets.length > 0 ? seedTargets : [targetFromInclude("src")];
+    const nextManifest = upsertVisualizeManifest(manifest, {
+        docsRoot,
+        planDir,
+        targets,
+    });
+    const absolutePlanDir = path.join(workspaceRoot, planDir);
+    const planPath = path.join(absolutePlanDir, "plan.mdx");
+    const statePath = path.join(absolutePlanDir, ".plan-state.json");
+    const manifestRel = normalizeSlash(path.relative(absolutePlanDir, manifestPath));
+    const shouldWritePlan = options.force || !fs.existsSync(planPath);
+    if (!options.dryRun) {
+        await fs.promises.writeFile(manifestPath, `${JSON.stringify(nextManifest, null, 2)}\n`);
+        await fs.promises.mkdir(absolutePlanDir, { recursive: true });
+        if (shouldWritePlan) {
+            await fs.promises.writeFile(planPath, buildPlanMdx({
+                title: options.title ?? DEFAULT_TITLE,
+                brief: options.brief ?? DEFAULT_BRIEF,
+                targets,
+                manifestRel,
+            }));
+            await fs.promises.writeFile(statePath, buildStateJson({ manifestRel, targets }));
+        }
+        else if (!fs.existsSync(statePath)) {
+            await fs.promises.writeFile(statePath, buildStateJson({ manifestRel, targets }));
+        }
+    }
+    return {
+        workspaceRoot,
+        manifestPath,
+        docsRoot: path.join(workspaceRoot, docsRoot),
+        planDir: absolutePlanDir,
+        planPath,
+        statePath,
+        manifest: nextManifest,
+        targets,
+        created: shouldWritePlan && !options.dryRun,
+    };
+}
+function printHelp() {
+    process.stdout
+        .write(`agent-native visualize-repo — local visual docs workspace
+
+Usage:
+  agent-native visualize-repo [serve] [--target <path-or-glob>] [--open]
+  agent-native visualize-repo init [--target <path-or-glob>] [--force]
+  agent-native visualize-repo check [--dir <folder>]
+  agent-native visualize-repo verify [--dir <folder>] [--app-url <url>]
+
+Options:
+  --target <path-or-glob>  Add a visualized source target. Repeatable.
+  --root <folder>          Visual docs root in agent-native.json (default ${DEFAULT_VISUAL_DOCS_ROOT})
+  --dir <folder>           Local Plan MDX folder (default ${DEFAULT_VISUAL_DOCS_DIR})
+  --title <text>           Starter document title
+  --brief <text>           Starter document brief
+  --app-url <url>          Plan app URL for local bridge preview/verify
+  --host <host>            Local bridge host
+  --port <number>          Local bridge port; 0 means random
+  --open / --no-open       Open the Plan UI after starting the bridge (default open)
+  --force                  Regenerate plan.mdx if it already exists
+  --dry-run                Print the setup plan without writing files
+  --json                   Print machine-readable output
+
+When ${MANIFEST_FILE} is missing, init/serve creates one with an apps.visualize-repo
+local-files section and a small recommended target set from the repo structure.
+The generated MDX stays local and is served through the Plan local bridge.
+`);
+}
+function summarizeWorkspace(workspace) {
+    return {
+        ok: true,
+        workspaceRoot: workspace.workspaceRoot,
+        manifestPath: workspace.manifestPath,
+        docsRoot: workspace.docsRoot,
+        planDir: workspace.planDir,
+        planPath: workspace.planPath,
+        targets: workspace.targets,
+        created: workspace.created,
+    };
+}
+export async function runVisualizeRepo(argv) {
+    const parsed = parseVisualizeRepoArgs(argv);
+    if (parsed.help) {
+        printHelp();
+        return 0;
+    }
+    const readOnlyCommand = parsed.command === "check" || parsed.command === "verify";
+    const workspace = await prepareVisualizeRepoWorkspace({
+        dir: parsed.dir,
+        root: parsed.root,
+        targets: parsed.targets,
+        title: parsed.title,
+        brief: parsed.brief,
+        dryRun: parsed.dryRun || readOnlyCommand,
+        force: parsed.force,
+    });
+    if (parsed.dryRun || parsed.command === "init") {
+        process.stdout.write(`${JSON.stringify(summarizeWorkspace(workspace), null, 2)}\n`);
+        return 0;
+    }
+    if (parsed.command === "check") {
+        const files = readLocalPlanFiles(workspace.planDir);
+        assertLocalPlanFilesValid(files);
+        process.stdout.write(`${JSON.stringify({ ...summarizeWorkspace(workspace), validation: "lint-passed" }, null, 2)}\n`);
+        return 0;
+    }
+    if (parsed.command === "verify") {
+        const result = await verifyLocalPlanBridge({
+            dir: workspace.planDir,
+            kind: "plan",
+            title: parsed.title ?? DEFAULT_TITLE,
+            brief: parsed.brief ?? DEFAULT_BRIEF,
+            appUrl: parsed.appUrl,
+            host: parsed.host,
+            port: parsed.port,
+            urlFile: false,
+        });
+        process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+        return result.ok ? 0 : 1;
+    }
+    const bridge = await startLocalPlanBridge({
+        dir: workspace.planDir,
+        kind: "plan",
+        title: parsed.title ?? DEFAULT_TITLE,
+        brief: parsed.brief ?? DEFAULT_BRIEF,
+        appUrl: parsed.appUrl,
+        host: parsed.host,
+        port: parsed.port,
+        open: parsed.open,
+    });
+    process.stdout.write(`${JSON.stringify({
+        ...summarizeWorkspace(workspace),
+        url: bridge.result.url,
+        bridgeUrl: bridge.result.bridgeUrl,
+        urlFile: bridge.result.urlFile,
+    }, null, 2)}\n`);
+    process.stderr.write([
+        `Repo visual docs: ${workspace.planDir}`,
+        `Local Plan bridge running at ${bridge.result.bridgeUrl}`,
+        bridge.result.urlFile
+            ? `Open URL written to ${bridge.result.urlFile}`
+            : "",
+        "Press Ctrl+C to stop.",
+    ]
+        .filter(Boolean)
+        .join("\n") + "\n");
+    await new Promise((resolve) => {
+        let stopped = false;
+        const cleanup = () => {
+            process.off("SIGINT", stop);
+            process.off("SIGTERM", stop);
+        };
+        const stop = () => {
+            if (stopped)
+                return;
+            stopped = true;
+            cleanup();
+            bridge.server.close(() => resolve());
+        };
+        process.once("SIGINT", stop);
+        process.once("SIGTERM", stop);
+    });
+    return 0;
+}
+//# sourceMappingURL=visualize-repo.js.map

package/dist/cli/visualize-repo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visualize-repo.js","sourceRoot":"","sources":["../../src/cli/visualize-repo.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\n\nimport {\n  assertLocalPlanFilesValid,\n  readLocalPlanFiles,\n  startLocalPlanBridge,\n  verifyLocalPlanBridge,\n} from \"./plan-local.js\";\n\nconst APP_ID = \"visualize-repo\";\nconst MANIFEST_FILE = \"agent-native.json\";\nconst DEFAULT_VISUAL_DOCS_ROOT = \".agent-native/visual-docs\";\nconst DEFAULT_VISUAL_DOCS_DIR = \".agent-native/visual-docs/repo-overview\";\nconst DEFAULT_TITLE = \"Repo Visual Docs\";\nconst DEFAULT_BRIEF =\n  \"A local, repo-backed visual documentation workspace for code review and agent handoff.\";\n\nconst DEFAULT_HIDE = [\n  \"**/node_modules/**\",\n  \"**/.git/**\",\n  \"**/dist/**\",\n  \"**/build/**\",\n  \"**/.agent-native/**\",\n];\n\nconst COMMANDS = new Set([\"init\", \"serve\", \"open\", \"check\", \"verify\", \"help\"]);\n\nexport type VisualizeRepoCommand =\n  | \"init\"\n  | \"serve\"\n  | \"open\"\n  | \"check\"\n  | \"verify\"\n  | \"help\";\n\nexport interface VisualizeRepoArgs {\n  command: VisualizeRepoCommand;\n  dir?: string;\n  root?: string;\n  targets: string[];\n  title?: string;\n  brief?: string;\n  open: boolean;\n  dryRun: boolean;\n  json: boolean;\n  force: boolean;\n  appUrl?: string;\n  host?: string;\n  port?: number;\n  help: boolean;\n}\n\nexport interface VisualizeRepoTarget {\n  id: string;\n  name: string;\n  kind: \"api\" | \"model\" | \"component\" | \"flow\" | \"area\" | \"docs\";\n  include: string[];\n  blocks: string[];\n  policy: \"seed\" | \"update-when-touched\" | \"required-on-pr\";\n}\n\nexport interface VisualizeRepoWorkspace {\n  workspaceRoot: string;\n  manifestPath: string;\n  docsRoot: string;\n  planDir: string;\n  planPath: string;\n  statePath: string;\n  manifest: Record<string, unknown>;\n  targets: VisualizeRepoTarget[];\n  created: boolean;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return !!value && typeof value === \"object\" && !Array.isArray(value);\n}\n\nfunction normalizeSlash(value: string) {\n  return value.replace(/\\\\/g, \"/\");\n}\n\nfunction stringFlagValue(argv: string[], index: number, flag: string) {\n  const value = argv[index + 1];\n  if (!value || value.startsWith(\"-\")) {\n    throw new Error(`${flag} requires a value`);\n  }\n  return value;\n}\n\nfunction parsePort(value: string) {\n  const port = Number.parseInt(value, 10);\n  if (!Number.isInteger(port) || port < 0 || port > 65535) {\n    throw new Error(\"--port must be an integer between 0 and 65535.\");\n  }\n  return port;\n}\n\nexport function parseVisualizeRepoArgs(argv: string[]): VisualizeRepoArgs {\n  const [first, ...rest] = argv;\n  const command = COMMANDS.has(first ?? \"\")\n    ? (first as VisualizeRepoCommand)\n    : \"serve\";\n  const args =\n    command === \"serve\" && first && !COMMANDS.has(first) ? argv : rest;\n  const parsed: VisualizeRepoArgs = {\n    command,\n    targets: [],\n    open: true,\n    dryRun: false,\n    json: false,\n    force: false,\n    help: command === \"help\",\n  };\n\n  for (let index = 0; index < args.length; index += 1) {\n    const arg = args[index]!;\n    if (arg === \"help\" || arg === \"--help\" || arg === \"-h\") {\n      parsed.help = true;\n    } else if (arg === \"--dir\") {\n      parsed.dir = stringFlagValue(args, index, arg);\n      index += 1;\n    } else if (arg.startsWith(\"--dir=\")) {\n      parsed.dir = arg.slice(\"--dir=\".length);\n    } else if (arg === \"--root\") {\n      parsed.root = stringFlagValue(args, index, arg);\n      index += 1;\n    } else if (arg.startsWith(\"--root=\")) {\n      parsed.root = arg.slice(\"--root=\".length);\n    } else if (arg === \"--target\") {\n      parsed.targets.push(stringFlagValue(args, index, arg));\n      index += 1;\n    } else if (arg.startsWith(\"--target=\")) {\n      parsed.targets.push(arg.slice(\"--target=\".length));\n    } else if (arg === \"--title\") {\n      parsed.title = stringFlagValue(args, index, arg);\n      index += 1;\n    } else if (arg.startsWith(\"--title=\")) {\n      parsed.title = arg.slice(\"--title=\".length);\n    } else if (arg === \"--brief\") {\n      parsed.brief = stringFlagValue(args, index, arg);\n      index += 1;\n    } else if (arg.startsWith(\"--brief=\")) {\n      parsed.brief = arg.slice(\"--brief=\".length);\n    } else if (arg === \"--app-url\") {\n      parsed.appUrl = stringFlagValue(args, index, arg);\n      index += 1;\n    } else if (arg.startsWith(\"--app-url=\")) {\n      parsed.appUrl = arg.slice(\"--app-url=\".length);\n    } else if (arg === \"--host\") {\n      parsed.host = stringFlagValue(args, index, arg);\n      index += 1;\n    } else if (arg.startsWith(\"--host=\")) {\n      parsed.host = arg.slice(\"--host=\".length);\n    } else if (arg === \"--port\") {\n      parsed.port = parsePort(stringFlagValue(args, index, arg));\n      index += 1;\n    } else if (arg.startsWith(\"--port=\")) {\n      parsed.port = parsePort(arg.slice(\"--port=\".length));\n    } else if (arg === \"--open\") {\n      parsed.open = true;\n    } else if (arg === \"--no-open\") {\n      parsed.open = false;\n    } else if (arg === \"--dry-run\") {\n      parsed.dryRun = true;\n    } else if (arg === \"--json\") {\n      parsed.json = true;\n    } else if (arg === \"--force\") {\n      parsed.force = true;\n    } else if (arg.startsWith(\"-\")) {\n      throw new Error(`Unknown option: ${arg}`);\n    } else {\n      parsed.targets.push(arg);\n    }\n  }\n\n  return parsed;\n}\n\nfunction findWorkspaceRoot(cwd: string) {\n  let current = path.resolve(cwd);\n  for (;;) {\n    if (\n      fs.existsSync(path.join(current, MANIFEST_FILE)) ||\n      fs.existsSync(path.join(current, \"package.json\")) ||\n      fs.existsSync(path.join(current, \".git\"))\n    ) {\n      return current;\n    }\n    const parent = path.dirname(current);\n    if (parent === current) return path.resolve(cwd);\n    current = parent;\n  }\n}\n\nasync function readManifest(\n  manifestPath: string,\n): Promise<Record<string, unknown>> {\n  try {\n    const parsed = JSON.parse(await fs.promises.readFile(manifestPath, \"utf8\"));\n    if (!isRecord(parsed)) {\n      throw new Error(`${MANIFEST_FILE} must contain a JSON object`);\n    }\n    return parsed;\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === \"ENOENT\") {\n      return { version: 1 };\n    }\n    throw error;\n  }\n}\n\nfunction slugify(value: string) {\n  const slug = normalizeSlash(value)\n    .toLowerCase()\n    .replace(/[^a-z0-9/._-]+/g, \"-\")\n    .replace(/[/.]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n  return slug || \"target\";\n}\n\nfunction titleFromPath(value: string) {\n  const clean = value\n    .replace(/\\/\\*\\*.*$/, \"\")\n    .replace(/\\.(tsx?|jsx?|mdx?)$/, \"\");\n  return (\n    path\n      .basename(clean)\n      .replace(/[-_]+/g, \" \")\n      .replace(/\\s+/g, \" \")\n      .trim()\n      .replace(/\\b\\w/g, (char) => char.toUpperCase()) || \"Repo target\"\n  );\n}\n\nfunction inferKind(include: string): VisualizeRepoTarget[\"kind\"] {\n  const normalized = normalizeSlash(include);\n  if (normalized.includes(\"actions/\") || normalized.endsWith(\"actions\")) {\n    return \"api\";\n  }\n  if (normalized.includes(\"schema\") || normalized.includes(\"db/\")) {\n    return \"model\";\n  }\n  if (\n    normalized.includes(\"components/\") ||\n    normalized.endsWith(\"/components\") ||\n    normalized === \"components\"\n  ) {\n    return \"component\";\n  }\n  if (normalized.includes(\"pages/\") || normalized.includes(\"routes/\")) {\n    return \"flow\";\n  }\n  if (normalized.includes(\"docs/\") || normalized.endsWith(\".mdx\")) {\n    return \"docs\";\n  }\n  return \"area\";\n}\n\nfunction blocksForKind(kind: VisualizeRepoTarget[\"kind\"]) {\n  switch (kind) {\n    case \"api\":\n      return [\"api-endpoint\", \"diagram\", \"annotated-code\"];\n    case \"model\":\n      return [\"data-model\", \"diagram\", \"annotated-code\"];\n    case \"component\":\n      return [\"wireframe\", \"states\", \"annotated-code\"];\n    case \"flow\":\n      return [\"wireframe\", \"diagram\", \"annotated-code\"];\n    case \"docs\":\n      return [\"rich-text\", \"diagram\"];\n    case \"area\":\n      return [\"file-tree\", \"diagram\", \"annotated-code\"];\n  }\n}\n\nfunction targetFromInclude(include: string): VisualizeRepoTarget {\n  const normalized = normalizeSlash(include).replace(/^\\.\\/+/, \"\");\n  const kind = inferKind(normalized);\n  return {\n    id: slugify(normalized),\n    name: titleFromPath(normalized),\n    kind,\n    include: [normalized],\n    blocks: blocksForKind(kind),\n    policy: kind === \"api\" || kind === \"model\" ? \"required-on-pr\" : \"seed\",\n  };\n}\n\nfunction fileExists(root: string, rel: string) {\n  return fs.existsSync(path.join(root, rel));\n}\n\nfunction recommendedTargets(workspaceRoot: string): VisualizeRepoTarget[] {\n  const candidates: string[] = [];\n  const add = (rel: string) => {\n    if (fileExists(workspaceRoot, rel)) candidates.push(rel);\n  };\n\n  add(\"actions\");\n  add(\"app/components\");\n  add(\"app/pages\");\n  add(\"app/routes\");\n  add(\"server/db/schema.ts\");\n  add(\"server/db/schema.tsx\");\n  add(\"src\");\n  add(\"packages\");\n  add(\"templates\");\n  add(\"docs\");\n  add(\"content\");\n\n  return candidates.slice(0, 12).map(targetFromInclude);\n}\n\nfunction normalizeTargets(value: unknown): VisualizeRepoTarget[] {\n  if (!Array.isArray(value)) return [];\n  return value.filter(isRecord).map((entry) => {\n    const include = Array.isArray(entry.include)\n      ? entry.include.filter((item): item is string => typeof item === \"string\")\n      : typeof entry.path === \"string\"\n        ? [entry.path]\n        : [];\n    const first = include[0] ?? \"target\";\n    const kind =\n      typeof entry.kind === \"string\"\n        ? (entry.kind as VisualizeRepoTarget[\"kind\"])\n        : inferKind(first);\n    return {\n      id: typeof entry.id === \"string\" ? entry.id : slugify(first),\n      name: typeof entry.name === \"string\" ? entry.name : titleFromPath(first),\n      kind,\n      include,\n      blocks: Array.isArray(entry.blocks)\n        ? entry.blocks.filter(\n            (item): item is string => typeof item === \"string\",\n          )\n        : blocksForKind(kind),\n      policy:\n        entry.policy === \"required-on-pr\" ||\n        entry.policy === \"update-when-touched\" ||\n        entry.policy === \"seed\"\n          ? entry.policy\n          : \"seed\",\n    };\n  });\n}\n\nfunction mergeTargets(\n  existing: VisualizeRepoTarget[],\n  incoming: VisualizeRepoTarget[],\n) {\n  const byId = new Map<string, VisualizeRepoTarget>();\n  for (const target of existing) byId.set(target.id, target);\n  for (const target of incoming) byId.set(target.id, target);\n  return Array.from(byId.values());\n}\n\nfunction upsertVisualizeManifest(\n  manifest: Record<string, unknown>,\n  input: {\n    docsRoot: string;\n    planDir: string;\n    targets: VisualizeRepoTarget[];\n  },\n) {\n  const next: Record<string, unknown> = {\n    ...manifest,\n    version: manifest.version ?? 1,\n  };\n  const apps = isRecord(next.apps) ? { ...next.apps } : {};\n  const existing = isRecord(apps[APP_ID]) ? { ...apps[APP_ID] } : {};\n  apps[APP_ID] = {\n    ...existing,\n    mode: \"local-files\",\n    root: normalizeSlash(input.docsRoot),\n    entry: normalizeSlash(input.planDir),\n    targets: input.targets,\n    hide: Array.isArray(existing.hide) ? existing.hide : DEFAULT_HIDE,\n  };\n  next.apps = apps;\n  return next;\n}\n\nfunction escapeYamlString(value: string) {\n  return value.replace(/\\\\/g, \"\\\\\\\\\").replace(/\"/g, '\\\\\"');\n}\n\nfunction targetAnchorList(target: VisualizeRepoTarget) {\n  return target.include.map((item) => `\\`${item}\\``).join(\", \");\n}\n\nfunction fileTreeEntries(targets: VisualizeRepoTarget[]) {\n  return JSON.stringify(\n    targets.flatMap((target) =>\n      target.include.map((include) => ({\n        path: include,\n        note: `${target.kind}; ${target.blocks.join(\", \")}`,\n      })),\n    ),\n  );\n}\n\nfunction buildPlanMdx(input: {\n  title: string;\n  brief: string;\n  targets: VisualizeRepoTarget[];\n  manifestRel: string;\n}) {\n  const targetSections = input.targets.flatMap((target, index) => [\n    `## ${index + 1}. ${target.name}`,\n    \"\",\n    `Source anchors: ${targetAnchorList(target)}`,\n    \"\",\n    `Recommended blocks: ${target.blocks.map((block) => `\\`${block}\\``).join(\", \")}`,\n    \"\",\n    `Freshness policy: \\`${target.policy}\\``,\n    \"\",\n    \"Use this section as the durable visual contract for the code above. Keep it sparse until the target earns more detail, then add API specs, data models, wireframes, diagrams, or annotated code blocks beside the prose.\",\n    \"\",\n  ]);\n\n  return [\n    \"---\",\n    `title: \"${escapeYamlString(input.title)}\"`,\n    `brief: \"${escapeYamlString(input.brief)}\"`,\n    'kind: \"plan\"',\n    \"localOnly: true\",\n    \"---\",\n    \"\",\n    `# ${input.title}`,\n    \"\",\n    input.brief,\n    \"\",\n    \"This workspace is repo-native: the MDX files are local source files, comments stay beside them in `comments.json`, and the Plan UI reads them through the localhost bridge instead of writing the plan to hosted storage.\",\n    \"\",\n    `Manifest: \\`${input.manifestRel}\\``,\n    \"\",\n    \"## Visualized Targets\",\n    \"\",\n    `<FileTree id=\"visualized-targets\" title=\"Visualized targets\" entries={${fileTreeEntries(\n      input.targets,\n    )}} />`,\n    \"\",\n    ...targetSections,\n    \"## Review And Agent Handoff\",\n    \"\",\n    \"Comment on sections, diagrams, specs, or wireframes in the local Plan UI. Agent-targeted comments are the queue for a coding agent to update the repo and then patch these MDX files so the visual docs stay current with code.\",\n    \"\",\n  ].join(\"\\n\");\n}\n\nfunction buildStateJson(input: {\n  manifestRel: string;\n  targets: VisualizeRepoTarget[];\n}) {\n  return `${JSON.stringify(\n    {\n      localOnly: true,\n      kind: \"plan\",\n      visualDocs: {\n        manifest: input.manifestRel,\n        targets: input.targets.map((target) => target.id),\n      },\n      createdAt: new Date().toISOString(),\n    },\n    null,\n    2,\n  )}\\n`;\n}\n\nexport async function prepareVisualizeRepoWorkspace(options: {\n  cwd?: string;\n  dir?: string;\n  root?: string;\n  targets?: string[];\n  title?: string;\n  brief?: string;\n  dryRun?: boolean;\n  force?: boolean;\n}): Promise<VisualizeRepoWorkspace> {\n  const workspaceRoot = findWorkspaceRoot(options.cwd ?? process.cwd());\n  const manifestPath = path.join(workspaceRoot, MANIFEST_FILE);\n  const manifest = await readManifest(manifestPath);\n  const existingApp = isRecord(\n    isRecord(manifest.apps) ? manifest.apps[APP_ID] : undefined,\n  )\n    ? (manifest.apps as Record<string, unknown>)[APP_ID]\n    : undefined;\n  const existingRoot =\n    isRecord(existingApp) && typeof existingApp.root === \"string\"\n      ? existingApp.root\n      : undefined;\n  const existingEntry =\n    isRecord(existingApp) && typeof existingApp.entry === \"string\"\n      ? existingApp.entry\n      : undefined;\n  const docsRoot = normalizeSlash(\n    options.root ?? existingRoot ?? DEFAULT_VISUAL_DOCS_ROOT,\n  );\n  const planDir = normalizeSlash(\n    options.dir ?? existingEntry ?? DEFAULT_VISUAL_DOCS_DIR,\n  );\n  const existingTargets = normalizeTargets(\n    isRecord(existingApp) ? existingApp.targets : undefined,\n  );\n  const requestedTargets = (options.targets ?? []).map(targetFromInclude);\n  const seedTargets =\n    requestedTargets.length > 0\n      ? mergeTargets(existingTargets, requestedTargets)\n      : existingTargets.length > 0\n        ? existingTargets\n        : recommendedTargets(workspaceRoot);\n  const targets =\n    seedTargets.length > 0 ? seedTargets : [targetFromInclude(\"src\")];\n  const nextManifest = upsertVisualizeManifest(manifest, {\n    docsRoot,\n    planDir,\n    targets,\n  });\n  const absolutePlanDir = path.join(workspaceRoot, planDir);\n  const planPath = path.join(absolutePlanDir, \"plan.mdx\");\n  const statePath = path.join(absolutePlanDir, \".plan-state.json\");\n  const manifestRel = normalizeSlash(\n    path.relative(absolutePlanDir, manifestPath),\n  );\n  const shouldWritePlan = options.force || !fs.existsSync(planPath);\n\n  if (!options.dryRun) {\n    await fs.promises.writeFile(\n      manifestPath,\n      `${JSON.stringify(nextManifest, null, 2)}\\n`,\n    );\n    await fs.promises.mkdir(absolutePlanDir, { recursive: true });\n    if (shouldWritePlan) {\n      await fs.promises.writeFile(\n        planPath,\n        buildPlanMdx({\n          title: options.title ?? DEFAULT_TITLE,\n          brief: options.brief ?? DEFAULT_BRIEF,\n          targets,\n          manifestRel,\n        }),\n      );\n      await fs.promises.writeFile(\n        statePath,\n        buildStateJson({ manifestRel, targets }),\n      );\n    } else if (!fs.existsSync(statePath)) {\n      await fs.promises.writeFile(\n        statePath,\n        buildStateJson({ manifestRel, targets }),\n      );\n    }\n  }\n\n  return {\n    workspaceRoot,\n    manifestPath,\n    docsRoot: path.join(workspaceRoot, docsRoot),\n    planDir: absolutePlanDir,\n    planPath,\n    statePath,\n    manifest: nextManifest,\n    targets,\n    created: shouldWritePlan && !options.dryRun,\n  };\n}\n\nfunction printHelp() {\n  process.stdout\n    .write(`agent-native visualize-repo — local visual docs workspace\n\nUsage:\n  agent-native visualize-repo [serve] [--target <path-or-glob>] [--open]\n  agent-native visualize-repo init [--target <path-or-glob>] [--force]\n  agent-native visualize-repo check [--dir <folder>]\n  agent-native visualize-repo verify [--dir <folder>] [--app-url <url>]\n\nOptions:\n  --target <path-or-glob>  Add a visualized source target. Repeatable.\n  --root <folder>          Visual docs root in agent-native.json (default ${DEFAULT_VISUAL_DOCS_ROOT})\n  --dir <folder>           Local Plan MDX folder (default ${DEFAULT_VISUAL_DOCS_DIR})\n  --title <text>           Starter document title\n  --brief <text>           Starter document brief\n  --app-url <url>          Plan app URL for local bridge preview/verify\n  --host <host>            Local bridge host\n  --port <number>          Local bridge port; 0 means random\n  --open / --no-open       Open the Plan UI after starting the bridge (default open)\n  --force                  Regenerate plan.mdx if it already exists\n  --dry-run                Print the setup plan without writing files\n  --json                   Print machine-readable output\n\nWhen ${MANIFEST_FILE} is missing, init/serve creates one with an apps.visualize-repo\nlocal-files section and a small recommended target set from the repo structure.\nThe generated MDX stays local and is served through the Plan local bridge.\n`);\n}\n\nfunction summarizeWorkspace(workspace: VisualizeRepoWorkspace) {\n  return {\n    ok: true,\n    workspaceRoot: workspace.workspaceRoot,\n    manifestPath: workspace.manifestPath,\n    docsRoot: workspace.docsRoot,\n    planDir: workspace.planDir,\n    planPath: workspace.planPath,\n    targets: workspace.targets,\n    created: workspace.created,\n  };\n}\n\nexport async function runVisualizeRepo(argv: string[]) {\n  const parsed = parseVisualizeRepoArgs(argv);\n  if (parsed.help) {\n    printHelp();\n    return 0;\n  }\n\n  const readOnlyCommand =\n    parsed.command === \"check\" || parsed.command === \"verify\";\n  const workspace = await prepareVisualizeRepoWorkspace({\n    dir: parsed.dir,\n    root: parsed.root,\n    targets: parsed.targets,\n    title: parsed.title,\n    brief: parsed.brief,\n    dryRun: parsed.dryRun || readOnlyCommand,\n    force: parsed.force,\n  });\n\n  if (parsed.dryRun || parsed.command === \"init\") {\n    process.stdout.write(\n      `${JSON.stringify(summarizeWorkspace(workspace), null, 2)}\\n`,\n    );\n    return 0;\n  }\n\n  if (parsed.command === \"check\") {\n    const files = readLocalPlanFiles(workspace.planDir);\n    assertLocalPlanFilesValid(files);\n    process.stdout.write(\n      `${JSON.stringify({ ...summarizeWorkspace(workspace), validation: \"lint-passed\" }, null, 2)}\\n`,\n    );\n    return 0;\n  }\n\n  if (parsed.command === \"verify\") {\n    const result = await verifyLocalPlanBridge({\n      dir: workspace.planDir,\n      kind: \"plan\",\n      title: parsed.title ?? DEFAULT_TITLE,\n      brief: parsed.brief ?? DEFAULT_BRIEF,\n      appUrl: parsed.appUrl,\n      host: parsed.host,\n      port: parsed.port,\n      urlFile: false,\n    });\n    process.stdout.write(`${JSON.stringify(result, null, 2)}\\n`);\n    return result.ok ? 0 : 1;\n  }\n\n  const bridge = await startLocalPlanBridge({\n    dir: workspace.planDir,\n    kind: \"plan\",\n    title: parsed.title ?? DEFAULT_TITLE,\n    brief: parsed.brief ?? DEFAULT_BRIEF,\n    appUrl: parsed.appUrl,\n    host: parsed.host,\n    port: parsed.port,\n    open: parsed.open,\n  });\n\n  process.stdout.write(\n    `${JSON.stringify(\n      {\n        ...summarizeWorkspace(workspace),\n        url: bridge.result.url,\n        bridgeUrl: bridge.result.bridgeUrl,\n        urlFile: bridge.result.urlFile,\n      },\n      null,\n      2,\n    )}\\n`,\n  );\n  process.stderr.write(\n    [\n      `Repo visual docs: ${workspace.planDir}`,\n      `Local Plan bridge running at ${bridge.result.bridgeUrl}`,\n      bridge.result.urlFile\n        ? `Open URL written to ${bridge.result.urlFile}`\n        : \"\",\n      \"Press Ctrl+C to stop.\",\n    ]\n      .filter(Boolean)\n      .join(\"\\n\") + \"\\n\",\n  );\n\n  await new Promise<void>((resolve) => {\n    let stopped = false;\n    const cleanup = () => {\n      process.off(\"SIGINT\", stop);\n      process.off(\"SIGTERM\", stop);\n    };\n    const stop = () => {\n      if (stopped) return;\n      stopped = true;\n      cleanup();\n      bridge.server.close(() => resolve());\n    };\n    process.once(\"SIGINT\", stop);\n    process.once(\"SIGTERM\", stop);\n  });\n\n  return 0;\n}\n"]}