project-librarian 0.2.0

package/dist/hooks.js

@@ -0,0 +1,321 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.gitWikiCommitTrailersScript = exports.gitPrepareCommitMsgHook = exports.hookScript = void 0;
+exports.upsertGitHooksPath = upsertGitHooksPath;
+exports.upsertHookConfig = upsertHookConfig;
+exports.upsertClaudeHookConfig = upsertClaudeHookConfig;
+const childProcess = __importStar(require("node:child_process"));
+const args_1 = require("./args");
+const workspace_1 = require("./workspace");
+function upsertGitHooksPath() {
+    if (args_1.noGitConfigMode)
+        return "skipped-no-git-config";
+    if (!(0, workspace_1.isGitRepository)())
+        return "skipped-no-git";
+    let previous = "";
+    try {
+        previous = childProcess.execFileSync("git", ["config", "--get", "core.hooksPath"], {
+            cwd: workspace_1.root,
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+    }
+    catch {
+        previous = "";
+    }
+    if (previous === ".githooks")
+        return "exists";
+    if (previous)
+        return `skipped-existing-hooksPath ${previous}`;
+    childProcess.execFileSync("git", ["config", "core.hooksPath", ".githooks"], {
+        cwd: workspace_1.root,
+        stdio: "ignore",
+    });
+    return previous ? `updated from ${previous}` : "configured";
+}
+function buildHookCommand(command, timeout) {
+    const hook = { type: "command", command };
+    if (typeof timeout === "number")
+        hook.timeout = timeout;
+    return hook;
+}
+function upsertSessionStartHookConfig(relativePath, command, matchers, timeout) {
+    const config = (0, workspace_1.parseJson)(relativePath, { hooks: {} });
+    if (!config.hooks || typeof config.hooks !== "object" || Array.isArray(config.hooks)) {
+        config.hooks = {};
+    }
+    if (!Array.isArray(config.hooks.SessionStart))
+        config.hooks.SessionStart = [];
+    const sessionStart = config.hooks.SessionStart.flatMap((entry) => {
+        if (!Array.isArray(entry?.hooks))
+            return [entry];
+        const hooks = entry.hooks.filter((hook) => hook?.command !== command);
+        return hooks.length > 0 ? [{ ...entry, hooks }] : [];
+    });
+    for (const matcher of matchers) {
+        const existing = sessionStart.find((entry) => entry?.matcher === matcher && Array.isArray(entry.hooks));
+        if (existing) {
+            existing.hooks = [...existing.hooks, buildHookCommand(command, timeout)];
+        }
+        else {
+            sessionStart.push({
+                matcher,
+                hooks: [buildHookCommand(command, timeout)],
+            });
+        }
+    }
+    config.hooks.SessionStart = sessionStart;
+    const next = `${JSON.stringify(config, null, 2)}\n`;
+    const previous = (0, workspace_1.exists)(relativePath) ? (0, workspace_1.read)(relativePath) : "";
+    (0, workspace_1.write)(relativePath, next);
+    return previous === next ? "exists" : previous ? "updated" : "created";
+}
+function upsertHookConfig() {
+    return upsertSessionStartHookConfig(".codex/hooks.json", "node .codex/hooks/wiki-session-start.js", ["startup|resume|clear"], 10);
+}
+function upsertClaudeHookConfig() {
+    return upsertSessionStartHookConfig(".claude/settings.json", "node .claude/hooks/wiki-session-start.js", ["startup", "resume", "clear", "compact"]);
+}
+exports.hookScript = `#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+
+function readHookInput() {
+  try {
+    const stat = fs.fstatSync(0);
+    if (!stat.isFIFO() && !stat.isFile()) return {};
+    const raw = fs.readFileSync(0, "utf8").trim();
+    if (!raw) return {};
+    return JSON.parse(raw);
+  } catch {
+    return {};
+  }
+}
+
+const hookInput = readHookInput();
+const cwd = process.env.CODEX_WORKSPACE_DIR || hookInput.cwd || process.cwd();
+
+function readIfExists(relativePath, maxChars) {
+  const filePath = path.join(cwd, relativePath);
+  try {
+    const text = fs.readFileSync(filePath, "utf8").trim();
+    if (text.length <= maxChars) return text;
+    return \`\${text.slice(0, maxChars)}\\n\\n[truncated: \${relativePath}]\`;
+  } catch {
+    return "";
+  }
+}
+
+const files = [
+  ["wiki/startup.md", 3500],
+  ["wiki/index.md", 4500],
+];
+
+const sections = files
+  .map(([relativePath, maxChars]) => {
+    const text = readIfExists(relativePath, maxChars);
+    if (!text) return "";
+    return \`## \${relativePath}\\n\\n\${text}\`;
+  })
+  .filter(Boolean);
+
+const additionalContext = [
+  "[Project wiki startup review]",
+  "Use ./wiki as the project-planning source of truth only. Start with compact routing context; read detailed project canonical, decision, or meta files on demand.",
+  "Project canonical content language is selected from user/project context; do not assume a fixed default language.",
+  "When project planning content is added, changed, or removed, update ./wiki in the same turn.",
+  "Do not put non-project LLM memory or collaboration instructions in project canonical/decision docs; use AGENTS.md, wiki/AGENTS.md, hooks, or skills.",
+  "",
+  ...sections,
+].join("\\n");
+
+process.stdout.write(JSON.stringify({
+  continue: true,
+  hookSpecificOutput: { hookEventName: "SessionStart", additionalContext },
+}));
+`;
+exports.gitPrepareCommitMsgHook = `#!/bin/sh
+MSG_FILE="$1"
+SOURCE="$2"
+
+case "$SOURCE" in
+  merge|squash|commit)
+    exit 0
+    ;;
+esac
+
+if command -v node >/dev/null 2>&1 && [ -f ".githooks/wiki-commit-trailers.js" ]; then
+  node .githooks/wiki-commit-trailers.js "$MSG_FILE"
+fi
+`;
+exports.gitWikiCommitTrailersScript = `#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+const childProcess = require("child_process");
+
+const messagePath = process.argv[2];
+if (!messagePath) process.exit(0);
+
+function runGit(args) {
+  try {
+    return childProcess.execFileSync("git", args, { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+  } catch {
+    return "";
+  }
+}
+
+function commandOk(command, args) {
+  try {
+    childProcess.execFileSync(command, args, { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function existingFile(relativePath) {
+  try {
+    return fs.readFileSync(relativePath, "utf8");
+  } catch {
+    return "";
+  }
+}
+
+function truncateList(items) {
+  if (items.length === 0) return "none";
+  if (items.length <= 3) return items.join(", ");
+  return items.slice(0, 3).join(", ") + ", +" + String(items.length - 3);
+}
+
+function metadataLine(text, label) {
+  const match = text.match(new RegExp("^- " + label + ":\\\\s*(.+)$", "m"));
+  return match ? match[1].trim() : "";
+}
+
+function migrationStatus(files) {
+  const hasMigration = files.some((file) => file.startsWith("wiki/migration/") || file.endsWith("/migration-inbox.md"));
+  if (!hasMigration) return "n/a";
+  const text = existingFile("wiki/migration/verification.md") + "\\n" + existingFile("wiki/migration/review.md");
+  const coverage = metadataLine(text, "coverage") || "unknown";
+  const semantic = metadataLine(text, "semantic migration complete") || "unknown";
+  const pending = metadataLine(text, "pending") || "unknown";
+  const needsHuman = metadataLine(text, "needs-human-review") || "unknown";
+  return "coverage " + coverage + "; semantic complete " + semantic + "; pending " + pending + "; needs-human-review " + needsHuman;
+}
+
+function wikiScope(files) {
+  const scopes = [];
+  const add = (name) => {
+    if (!scopes.includes(name)) scopes.push(name);
+  };
+  for (const file of files) {
+    if (file.startsWith("wiki/canonical/")) add("canonical");
+    else if (file.startsWith("wiki/decisions/")) add("decisions");
+    else if (file.startsWith("wiki/meta/")) add("meta");
+    else if (file.startsWith("wiki/sources/")) add("sources");
+    else if (file.startsWith("wiki/migration/") || file.endsWith("/migration-inbox.md")) add("migration");
+    else if (file === "wiki/startup.md") add("startup");
+    else if (file === "wiki/index.md") add("index");
+    else if (file.startsWith(".codex/hooks/") || file === ".codex/hooks.json") add("codex-hooks");
+    else if (file.startsWith(".claude/hooks/") || file === ".claude/settings.json") add("claude-hooks");
+    else if (file === "AGENTS.md" || file === "CLAUDE.md") add("agents");
+    else if (file.startsWith(".githooks/")) add("git-hooks");
+    else if (file.startsWith("tools/project-librarian/")) add("skill");
+  }
+  return scopes.length === 0 ? "none" : scopes.join(", ");
+}
+
+function validationTrailers() {
+  const home = process.env.HOME || "";
+  const lintScript = [
+    "tools/project-librarian/dist/init-project-wiki.js",
+    path.join(home, ".codex/skills/project-librarian/dist/init-project-wiki.js"),
+    path.join(home, ".claude/skills/project-librarian/dist/init-project-wiki.js"),
+  ].find((candidate) => fs.existsSync(candidate));
+  const lintOk = Boolean(lintScript) && commandOk("node", [lintScript, "--lint"]);
+  const codexSessionHookOk = fs.existsSync(".codex/hooks/wiki-session-start.js") && commandOk("node", [".codex/hooks/wiki-session-start.js"]);
+  const claudeSessionHookOk = fs.existsSync(".claude/hooks/wiki-session-start.js") && commandOk("node", [".claude/hooks/wiki-session-start.js"]);
+  if (lintOk && codexSessionHookOk && claudeSessionHookOk) return { tested: "project wiki lint; Codex and Claude wiki session-start hooks", notTested: "none" };
+  const gaps = [];
+  if (!lintOk) gaps.push("project wiki lint");
+  if (!codexSessionHookOk) gaps.push("Codex wiki session-start hook");
+  if (!claudeSessionHookOk) gaps.push("Claude wiki session-start hook");
+  return { tested: "prepare-commit-msg generated wiki trailers", notTested: gaps.join("; ") || "unknown" };
+}
+
+const staged = runGit(["diff", "--cached", "--name-only", "--diff-filter=ACMR"])
+  .split(/\\r?\\n/)
+  .map((line) => line.trim())
+  .filter(Boolean);
+
+const wikiFiles = staged.filter((file) => {
+  return file.startsWith("wiki/")
+    || file === "AGENTS.md"
+    || file === "CLAUDE.md"
+    || file === ".codex/hooks.json"
+    || file.startsWith(".codex/hooks/")
+    || file === ".claude/settings.json"
+    || file.startsWith(".claude/hooks/")
+    || file.startsWith(".githooks/")
+    || file.startsWith("tools/project-librarian/");
+});
+
+if (wikiFiles.length === 0) process.exit(0);
+
+let message = fs.readFileSync(messagePath, "utf8");
+if (/^Wiki-scope:/m.test(message)) process.exit(0);
+
+const decisionRefs = wikiFiles.filter((file) => file.startsWith("wiki/decisions/") || file === "wiki/meta/wiki-ops-v1-decisions.md");
+const validation = validationTrailers();
+const trailers = [
+  ["Wiki-scope", wikiScope(wikiFiles)],
+  ["Canonical-updated", truncateList(wikiFiles.filter((file) => file.startsWith("wiki/canonical/") && !file.endsWith("/migration-inbox.md")))],
+  ["Decision-ref", truncateList(decisionRefs)],
+  ["Startup-updated", wikiFiles.includes("wiki/startup.md") ? "yes" : "no"],
+  ["Index-updated", wikiFiles.includes("wiki/index.md") ? "yes" : "no"],
+  ["Migration-status", migrationStatus(wikiFiles)],
+  ["Tested", validation.tested],
+  ["Not-tested", validation.notTested],
+];
+
+const lines = [];
+for (const [key, value] of trailers) {
+  if (!new RegExp("^" + key + ":", "m").test(message)) lines.push(key + ": " + value);
+}
+if (lines.length > 0) fs.writeFileSync(messagePath, message.replace(/\\s*$/, "") + "\\n\\n" + lines.join("\\n") + "\\n");
+`;

package/dist/init-project-wiki.js

@@ -0,0 +1,246 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const args_1 = require("./args");
+const hooks_1 = require("./hooks");
+const install_skill_1 = require("./install-skill");
+const modes_1 = require("./modes");
+const migration_1 = require("./migration");
+const templates_1 = require("./templates");
+const workspace_1 = require("./workspace");
+const wiki_files_1 = require("./wiki-files");
+function codeIndex() {
+    return require("./code-index");
+}
+function printUsage() {
+    console.log(`Usage:
+  project-librarian [init] [options]
+  project-librarian install-skill [--scope user|project] [--agents codex|claude|both]
+
+Options:
+  --migrate, --adopt-existing      Preserve an existing wiki as wiki_legacy and create migration inboxes.
+  --lint                           Validate the generated project wiki setup without editing files.
+  --link-check                     Report broken wiki links, duplicate routes, and orphan pages.
+  --quality-check                  Report stale, conflicting, and low-quality wiki document signals.
+  --doctor                         Run lint, link-check, and quality-check together.
+  --fix                            With --doctor, safely refresh generated index routing.
+  --issue-create                   Create a GitHub issue with gh issue create after explicit user approval.
+  --issue-draft                    Print a problem/side-effect GitHub issue body draft.
+  --issue-body-file <path>         With --issue-create, use an existing Markdown body file.
+  --issue-title <title>            Override the generated issue draft title.
+  --query <terms>                  Search wiki paths, metadata, titles, and bodies.
+  --refresh-index                  Update the managed auto-discovered wiki index block.
+  --capture-inbox                  Append a candidate note with --title, --content, and optional --category.
+  --glossary-init                  Create and route the optional glossary page.
+  --prune-check                    Report active pages with stale or unresolved signals.
+  --review-migration               Sync migration inbox statuses into migration review files.
+  --no-git-config                  Install hook files without changing git core.hooksPath.
+  --code-index                     Build the disposable .project-wiki code evidence index.
+  --incremental                    With --code-index, require an existing compatible index and update only changes.
+  --code-index-full                With --code-index, force a full rebuild even when incremental update is possible.
+  --code-parser <mode>             With --code-index, use parser mode default or tree-sitter.
+  --code-query <sql>               Run conservative read-only SQL over the code evidence index.
+  --code-status, --code-files      Inspect the code evidence index.
+  --code-report                    Print architecture and ownership summaries from the code evidence index.
+  --code-report-section <section>  With --code-report, print one section: coverage, ownership, languages, parsers, workspaces, workspace-graph, routes, hotspots, configs, or edges.
+  --code-impact <term>             Show file, symbol, route, import, and edge impact evidence for a term.
+  --code-search-symbol <term>      Search indexed symbols.
+  --help                           Show this help.`);
+}
+if (args_1.helpMode) {
+    printUsage();
+    process.exit(0);
+}
+if (args_1.unknownCommand) {
+    console.error(`unknown command: ${args_1.unknownCommand}`);
+    printUsage();
+    process.exit(1);
+}
+if (args_1.unknownOptions.length > 0) {
+    console.error(`unknown option${args_1.unknownOptions.length === 1 ? "" : "s"}: ${args_1.unknownOptions.join(", ")}`);
+    printUsage();
+    process.exit(1);
+}
+if (args_1.unexpectedValueOptions.length > 0) {
+    console.error(`option${args_1.unexpectedValueOptions.length === 1 ? "" : "s"} do${args_1.unexpectedValueOptions.length === 1 ? "es" : ""} not take a value: ${args_1.unexpectedValueOptions.join(", ")}`);
+    printUsage();
+    process.exit(1);
+}
+if (args_1.missingValueOptions.length > 0) {
+    console.error(`missing value for option${args_1.missingValueOptions.length === 1 ? "" : "s"}: ${args_1.missingValueOptions.join(", ")}`);
+    printUsage();
+    process.exit(1);
+}
+if (args_1.fixMode && !args_1.doctorMode) {
+    console.error("--fix is only supported with --doctor.");
+    process.exit(1);
+}
+if (args_1.issueCreateMode && args_1.issueDraftMode) {
+    console.error("Use one issue mode at a time: --issue-draft or --issue-create.");
+    process.exit(1);
+}
+if (args_1.codeReportSection && !args_1.codeReportMode) {
+    console.error("--code-report-section is only supported with --code-report.");
+    process.exit(1);
+}
+if (args_1.codeIndexIncrementalMode && !args_1.codeIndexMode) {
+    console.error("--incremental is only supported with --code-index.");
+    process.exit(1);
+}
+if (args_1.codeIndexFullMode && !args_1.codeIndexMode) {
+    console.error("--code-index-full is only supported with --code-index.");
+    process.exit(1);
+}
+if (args_1.codeParserMode && !args_1.codeIndexMode) {
+    console.error("--code-parser is only supported with --code-index.");
+    process.exit(1);
+}
+if (args_1.codeIndexIncrementalMode && args_1.codeIndexFullMode) {
+    console.error("Use one code index update mode at a time: --incremental or --code-index-full.");
+    process.exit(1);
+}
+if (args_1.command === "install-skill") {
+    (0, install_skill_1.runInstallSkillMode)();
+    process.exit(0);
+}
+const activeCodeModes = [args_1.codeQueryMode, args_1.codeReportMode, args_1.codeStatusMode, args_1.codeFilesMode, args_1.codeImpactMode, args_1.codeSearchSymbolMode, args_1.codeIndexMode].filter(Boolean).length;
+if (activeCodeModes > 1) {
+    console.error("Use one code evidence mode at a time: --code-index, --code-query, --code-report, --code-status, --code-files, --code-impact, or --code-search-symbol.");
+    process.exit(1);
+}
+if (args_1.codeQueryMode) {
+    codeIndex().runCodeQueryMode();
+    process.exit(0);
+}
+if (args_1.codeReportMode) {
+    codeIndex().runCodeReportMode();
+    process.exit(0);
+}
+if (args_1.codeStatusMode) {
+    codeIndex().runCodeStatusMode();
+    process.exit(0);
+}
+if (args_1.codeFilesMode) {
+    codeIndex().runCodeFilesMode();
+    process.exit(0);
+}
+if (args_1.codeImpactMode) {
+    codeIndex().runCodeImpactMode();
+    process.exit(0);
+}
+if (args_1.codeSearchSymbolMode) {
+    codeIndex().runCodeSearchSymbolMode();
+    process.exit(0);
+}
+if (args_1.codeIndexMode) {
+    codeIndex().runCodeIndexMode();
+    process.exit(0);
+}
+if (args_1.queryTerm) {
+    (0, modes_1.runQueryMode)();
+    process.exit(0);
+}
+if (args_1.issueCreateMode) {
+    (0, modes_1.runIssueCreateMode)();
+    process.exit(0);
+}
+if (args_1.issueDraftMode) {
+    (0, modes_1.runIssueDraftMode)();
+    process.exit(0);
+}
+if (args_1.pruneCheckMode) {
+    (0, modes_1.runPruneCheckMode)();
+    process.exit(0);
+}
+if (args_1.reviewMigrationMode) {
+    (0, migration_1.runReviewMigrationMode)();
+    process.exit(0);
+}
+if (args_1.doctorMode) {
+    (0, modes_1.runDoctorMode)(args_1.fixMode);
+    process.exit(0);
+}
+if (args_1.linkCheckMode) {
+    (0, modes_1.runLinkCheckMode)();
+    process.exit(0);
+}
+if (args_1.qualityCheckMode) {
+    (0, modes_1.runQualityCheckMode)();
+    process.exit(0);
+}
+if (args_1.lintMode) {
+    (0, modes_1.runLintMode)();
+    process.exit(0);
+}
+const migrationState = args_1.migrateMode ? (0, migration_1.prepareMigrationMode)() : null;
+const results = [];
+if (migrationState)
+    results.push(["migration prepare", migrationState.note]);
+(0, workspace_1.mkdirp)("wiki/canonical");
+(0, workspace_1.mkdirp)("wiki/decisions");
+(0, workspace_1.mkdirp)("wiki/inbox");
+(0, workspace_1.mkdirp)("wiki/meta");
+(0, workspace_1.mkdirp)("wiki/sources");
+(0, workspace_1.mkdirp)(".codex/hooks");
+(0, workspace_1.mkdirp)(".claude/hooks");
+(0, workspace_1.mkdirp)(".githooks");
+results.push(["AGENTS.md", (0, workspace_1.upsertMarkedSection)("AGENTS.md", "<!-- PROJECT-WIKI-FIRST:START -->", "<!-- PROJECT-WIKI-FIRST:END -->", templates_1.agentsSection)]);
+results.push(["CLAUDE.md", (0, workspace_1.upsertMarkedSection)("CLAUDE.md", "<!-- PROJECT-WIKI-CLAUDE:START -->", "<!-- PROJECT-WIKI-CLAUDE:END -->", templates_1.claudeSection)]);
+results.push(["wiki/AGENTS.md", (0, workspace_1.upsertMarkedSection)("wiki/AGENTS.md", "<!-- PROJECT-WIKI-INTERNAL:START -->", "<!-- PROJECT-WIKI-INTERNAL:END -->", templates_1.wikiAgentsSection)]);
+results.push([".githooks/prepare-commit-msg", (0, workspace_1.writeManaged)(".githooks/prepare-commit-msg", hooks_1.gitPrepareCommitMsgHook)]);
+(0, workspace_1.makeExecutable)(".githooks/prepare-commit-msg");
+results.push([".githooks/wiki-commit-trailers.js", (0, workspace_1.writeManaged)(".githooks/wiki-commit-trailers.js", hooks_1.gitWikiCommitTrailersScript)]);
+(0, workspace_1.makeExecutable)(".githooks/wiki-commit-trailers.js");
+results.push(["git core.hooksPath", (0, hooks_1.upsertGitHooksPath)()]);
+results.push([".codex/hooks.json", (0, hooks_1.upsertHookConfig)()]);
+results.push([".codex/hooks/wiki-session-start.js", (0, workspace_1.writeManaged)(".codex/hooks/wiki-session-start.js", hooks_1.hookScript)]);
+results.push([".claude/settings.json", (0, hooks_1.upsertClaudeHookConfig)()]);
+results.push([".claude/hooks/wiki-session-start.js", (0, workspace_1.writeManaged)(".claude/hooks/wiki-session-start.js", hooks_1.hookScript)]);
+results.push(["wiki/startup.md", (0, workspace_1.writeManaged)("wiki/startup.md", (0, wiki_files_1.withPreservedMarkedSections)("wiki/startup.md", templates_1.startup, [["<!-- PROJECT-WIKI-MIGRATION:START -->", "<!-- PROJECT-WIKI-MIGRATION:END -->"]]))]);
+results.push(["wiki/index.md", (0, workspace_1.writeManaged)("wiki/index.md", (0, wiki_files_1.withPreservedMarkedSections)("wiki/index.md", templates_1.index, [
+        ["<!-- PROJECT-WIKI-MIGRATION:START -->", "<!-- PROJECT-WIKI-MIGRATION:END -->"],
+        ["<!-- PROJECT-WIKI-GLOSSARY:START -->", "<!-- PROJECT-WIKI-GLOSSARY:END -->"],
+        ["<!-- PROJECT-WIKI-INBOX:START -->", "<!-- PROJECT-WIKI-INBOX:END -->"],
+        ["<!-- PROJECT-WIKI-AUTO-INDEX:START -->", "<!-- PROJECT-WIKI-AUTO-INDEX:END -->"],
+    ]))]);
+results.push(["wiki/meta/operating-model.md", (0, workspace_1.writeManaged)("wiki/meta/operating-model.md", templates_1.wikiOperatingModel)]);
+results.push(["wiki/meta/decision-policy.md", (0, workspace_1.writeManaged)("wiki/meta/decision-policy.md", templates_1.decisionPolicy)]);
+results.push(["wiki/canonical/wiki-operating-model.md", (0, workspace_1.deleteIfGenerated)("wiki/canonical/wiki-operating-model.md", ["# Wiki Operating Model"])]);
+results.push(["wiki/canonical/decision-policy.md", (0, workspace_1.deleteIfGenerated)("wiki/canonical/decision-policy.md", ["# Decision Policy"])]);
+results.push(["wiki/decisions/wiki-v1-decisions.md", (0, workspace_1.deleteIfGenerated)("wiki/decisions/wiki-v1-decisions.md", ["# Wiki v1 Decisions", "# Wiki Operations v1 Decisions"])]);
+for (const [relativePath, content] of Object.entries(templates_1.starterFiles)) {
+    results.push([relativePath, (0, workspace_1.writeStarter)(relativePath, content)]);
+}
+results.push(["wiki/meta/wiki-ops-v1-decisions.md", (0, workspace_1.writeManaged)("wiki/meta/wiki-ops-v1-decisions.md", templates_1.starterFiles["wiki/meta/wiki-ops-v1-decisions.md"])]);
+if (args_1.glossaryMode) {
+    results.push(["wiki/canonical/glossary.md", (0, workspace_1.writeStarter)("wiki/canonical/glossary.md", templates_1.glossary)]);
+    results.push(["wiki/index.md glossary router", (0, workspace_1.upsertMarkedSection)("wiki/index.md", "<!-- PROJECT-WIKI-GLOSSARY:START -->", "<!-- PROJECT-WIKI-GLOSSARY:END -->", templates_1.glossaryIndexBlock)]);
+}
+if (args_1.captureInboxMode) {
+    results.push(["wiki/inbox/project-candidates.md", (0, modes_1.appendCaptureInbox)()]);
+    results.push(["wiki/index.md inbox router", (0, workspace_1.upsertMarkedSection)("wiki/index.md", "<!-- PROJECT-WIKI-INBOX:START -->", "<!-- PROJECT-WIKI-INBOX:END -->", templates_1.inboxIndexBlock)]);
+}
+if (args_1.refreshIndexMode) {
+    results.push(["wiki/index.md auto-discovered pages", (0, workspace_1.upsertMarkedSection)("wiki/index.md", "<!-- PROJECT-WIKI-AUTO-INDEX:START -->", "<!-- PROJECT-WIKI-AUTO-INDEX:END -->", (0, modes_1.buildRefreshIndexBlock)())]);
+}
+if (args_1.migrateMode && migrationState) {
+    const migration = (0, migration_1.runMigrationMode)(migrationState);
+    for (const result of migration.results)
+        results.push(result);
+    results.push(["migration summary", `${migration.total} files from ${migration.legacyPath || "no legacy"}`]);
+}
+const modes = [];
+if (args_1.migrateMode)
+    modes.push("migration");
+if (args_1.glossaryMode)
+    modes.push("glossary");
+if (args_1.captureInboxMode)
+    modes.push("capture-inbox");
+if (args_1.refreshIndexMode)
+    modes.push("refresh-index");
+if (args_1.noGitConfigMode)
+    modes.push("no-git-config");
+console.log(modes.length > 0 ? `Project Librarian + ${modes.join(" + ")} complete.` : "Project Librarian complete.");
+for (const [relativePath, status] of results) {
+    console.log(`${String(status).padEnd(7)} ${relativePath}`);
+}