contract-driven-delivery 2.0.8 → 2.0.10

package/dist/cli/index.js

@@ -391,8 +391,11 @@ function sha256OfFile(path) {
     return "";
   }
 }
-function inputsDigest(paths) {
-  const combined = paths.slice().sort().map((p) => `${p}:${sha256OfFile(p)}`).join("\n");
+function inputsDigest(paths, cwd) {
+  const combined = paths.slice().sort().map((p) => {
+    const rel = relative2(cwd, p).replace(/\\/g, "/");
+    return `${rel}:${sha256OfFile(p)}`;
+  }).join("\n");
   return createHash2("sha256").update(combined).digest("hex");
 }
 function stripGlobSuffix(pattern) {
@@ -415,7 +418,14 @@ function getForbiddenPaths(cwd) {
 }
 function isForbidden(relPath, forbidden) {
   const normalized = relPath.replace(/\\/g, "/");
-  return forbidden.some((pattern) => normalized === pattern || normalized.startsWith(`${pattern}/`));
+  if (forbidden.some((pattern) => normalized === pattern || normalized.startsWith(`${pattern}/`))) {
+    return true;
+  }
+  for (const segment of normalized.split("/")) {
+    if (FORBIDDEN_DIRECTORY_NAMES.has(segment))
+      return true;
+  }
+  return false;
 }
 function buildTree(dir, cwd, forbidden, stats, prefix = "", depth = 0) {
   const entries = readdirSync4(dir, { withFileTypes: true }).sort((a, b) => {
@@ -542,7 +552,7 @@ async function contextScan(opts = {}) {
       `visible-files: ${treeStats.files}`,
       `omitted-dirs: ${treeStats.omittedDirs}`,
       `truncated-dirs: ${treeStats.truncatedDirs}`,
-      `inputs-digest: ${inputsDigest(projectMapInputs)}`,
+      `inputs-digest: ${inputsDigest(projectMapInputs, cwd)}`,
       "---",
       "",
       "# Project Map",
@@ -608,7 +618,7 @@ async function contextScan(opts = {}) {
     "schema-version: 1",
     `contract-count: ${contractFiles.length}`,
     `missing-summary-count: ${missingSummary}`,
-    `inputs-digest: ${inputsDigest(contractFiles)}`,
+    `inputs-digest: ${inputsDigest(contractFiles, cwd)}`,
     "---",
     "",
     "# Contracts Index",
@@ -632,7 +642,7 @@ async function contextScan(opts = {}) {
     log.ok("Created specs/context/contracts-index.md");
   }
 }
-var DEFAULT_FORBIDDEN, PER_DIR_ENTRY_CAP;
+var DEFAULT_FORBIDDEN, FORBIDDEN_DIRECTORY_NAMES, PER_DIR_ENTRY_CAP;
 var init_context_scan = __esm({
   "src/commands/context-scan.ts"() {
     "use strict";
@@ -645,8 +655,47 @@ var init_context_scan = __esm({
       "build",
       "assets",
       "specs/archive",
-      "specs/changes"
+      "specs/changes",
+      // cdd-kit runtime artifacts. Without these the user's local backups land
+      // in `specs/context/project-map.md`, polluting it and breaking the
+      // inputs-digest match for any fresh clone.
+      ".cdd/.refresh-backup",
+      ".cdd/migrate-backup",
+      ".cdd/runtime"
     ];
+    FORBIDDEN_DIRECTORY_NAMES = /* @__PURE__ */ new Set([
+      // Node / generic build outputs — also in DEFAULT_FORBIDDEN at top level,
+      // but nested cases like `frontend/dist`, `apps/foo/build`, `packages/x/out`
+      // require basename matching.
+      "node_modules",
+      "dist",
+      "build",
+      "out",
+      // Python
+      "__pycache__",
+      ".pytest_cache",
+      ".mypy_cache",
+      ".ruff_cache",
+      ".tox",
+      // JS/TS frameworks
+      ".next",
+      ".nuxt",
+      ".svelte-kit",
+      ".parcel-cache",
+      ".turbo",
+      ".nyc_output",
+      // Generic build / coverage caches
+      "coverage",
+      "htmlcov",
+      ".cache",
+      // Virtualenvs
+      "venv",
+      ".venv",
+      // IDE / OS noise
+      ".idea",
+      ".vscode",
+      ".DS_Store"
+    ]);
     PER_DIR_ENTRY_CAP = 50;
   }
 });
@@ -4221,49 +4270,49 @@ var require_fast_uri = __commonJS({
       schemelessOptions.skipEscape = true;
       return serialize(resolved, schemelessOptions);
     }
-    function resolveComponent(base, relative6, options, skipNormalization) {
+    function resolveComponent(base, relative9, options, skipNormalization) {
       const target = {};
       if (!skipNormalization) {
         base = parse3(serialize(base, options), options);
-        relative6 = parse3(serialize(relative6, options), options);
+        relative9 = parse3(serialize(relative9, options), options);
       }
       options = options || {};
-      if (!options.tolerant && relative6.scheme) {
-        target.scheme = relative6.scheme;
-        target.userinfo = relative6.userinfo;
-        target.host = relative6.host;
-        target.port = relative6.port;
-        target.path = removeDotSegments(relative6.path || "");
-        target.query = relative6.query;
+      if (!options.tolerant && relative9.scheme) {
+        target.scheme = relative9.scheme;
+        target.userinfo = relative9.userinfo;
+        target.host = relative9.host;
+        target.port = relative9.port;
+        target.path = removeDotSegments(relative9.path || "");
+        target.query = relative9.query;
       } else {
-        if (relative6.userinfo !== void 0 || relative6.host !== void 0 || relative6.port !== void 0) {
-          target.userinfo = relative6.userinfo;
-          target.host = relative6.host;
-          target.port = relative6.port;
-          target.path = removeDotSegments(relative6.path || "");
-          target.query = relative6.query;
+        if (relative9.userinfo !== void 0 || relative9.host !== void 0 || relative9.port !== void 0) {
+          target.userinfo = relative9.userinfo;
+          target.host = relative9.host;
+          target.port = relative9.port;
+          target.path = removeDotSegments(relative9.path || "");
+          target.query = relative9.query;
         } else {
-          if (!relative6.path) {
+          if (!relative9.path) {
             target.path = base.path;
-            if (relative6.query !== void 0) {
-              target.query = relative6.query;
+            if (relative9.query !== void 0) {
+              target.query = relative9.query;
             } else {
               target.query = base.query;
             }
           } else {
-            if (relative6.path[0] === "/") {
-              target.path = removeDotSegments(relative6.path);
+            if (relative9.path[0] === "/") {
+              target.path = removeDotSegments(relative9.path);
             } else {
               if ((base.userinfo !== void 0 || base.host !== void 0 || base.port !== void 0) && !base.path) {
-                target.path = "/" + relative6.path;
+                target.path = "/" + relative9.path;
               } else if (!base.path) {
-                target.path = relative6.path;
+                target.path = relative9.path;
               } else {
-                target.path = base.path.slice(0, base.path.lastIndexOf("/") + 1) + relative6.path;
+                target.path = base.path.slice(0, base.path.lastIndexOf("/") + 1) + relative9.path;
               }
               target.path = removeDotSegments(target.path);
             }
-            target.query = relative6.query;
+            target.query = relative9.query;
           }
           target.userinfo = base.userinfo;
           target.host = base.host;
@@ -4271,7 +4320,7 @@ var require_fast_uri = __commonJS({
         }
         target.scheme = base.scheme;
       }
-      target.fragment = relative6.fragment;
+      target.fragment = relative9.fragment;
       return target;
     }
     function equal(uriA, uriB, options) {
@@ -7583,1545 +7632,1609 @@ var init_include_exclude = __esm({
   }
 });
 
-// src/code-map/freshness.ts
-var freshness_exports = {};
-__export(freshness_exports, {
-  checkCodeMapFreshness: () => checkCodeMapFreshness
-});
-import { existsSync as existsSync11, statSync as statSync3 } from "fs";
-import { join as join13 } from "path";
-function checkCodeMapFreshness(cwd, mapRel = ".cdd/code-map.yml", include, exclude) {
-  const mapPath = join13(cwd, mapRel);
-  let cfg;
-  try {
-    cfg = loadCodeMapConfig(cwd);
-  } catch (err) {
-    return {
-      status: "config-error",
-      staleFiles: [],
-      staleCount: 0,
-      mapPath,
-      configError: err.message
-    };
+// src/code-map/yaml-writer.ts
+function quoteScalar(s) {
+  if (s.startsWith(".") || YAML_RESERVED.test(s) || s.includes(" ") || s === "" || s === "null" || s === "true" || s === "false") {
+    return `'${s.replace(/'/g, "''")}'`;
   }
-  const includeFinal = [...cfg.include, ...include ?? []];
-  const excludeFinal = [...cfg.exclude, ...exclude ?? []];
-  const sourceFiles = walkRepo(cwd, { include: includeFinal, exclude: excludeFinal });
-  if (!existsSync11(mapPath)) {
-    if (sourceFiles.length === 0) {
-      return { status: "missing-greenfield", staleFiles: [], staleCount: 0, mapPath };
+  return s;
+}
+function quotePath(p) {
+  if (YAML_RESERVED.test(p) || p.includes(" ")) {
+    return `'${p.replace(/'/g, "''")}'`;
+  }
+  return p;
+}
+function renderItems(items) {
+  if (items.length === 0)
+    return "[]";
+  return `[${items.map(quoteScalar).join(", ")}]`;
+}
+function truncateDecorator(d, max = 80) {
+  const cleaned = d.replace(/\r?\n/g, " ");
+  return cleaned.length <= max ? cleaned : cleaned.slice(0, max) + "...";
+}
+function renderClass(c) {
+  const lines = [];
+  lines.push(`    - name: ${c.name}`);
+  lines.push(`      lines: ${c.lines[0]}-${c.lines[1]}`);
+  if (c.methods.length > 0) {
+    lines.push("      methods:");
+    for (const m of c.methods) {
+      const asyncPrefix = m.async ? "async " : "";
+      lines.push(`        - { name: ${asyncPrefix}${m.name}, lines: ${m.lines[0]}-${m.lines[1]} }`);
     }
-    return { status: "missing-with-sources", staleFiles: [], staleCount: 0, mapPath };
   }
-  const mapMtime = statSync3(mapPath).mtimeMs;
-  const staleAll = [];
-  for (const absPath of sourceFiles) {
+  return lines;
+}
+function renderFunction(f) {
+  const asyncPrefix = f.async ? "async " : "";
+  let comment = "";
+  if (f.decorators.length > 0) {
+    const truncated = truncateDecorator(f.decorators[0]);
+    comment = `  # @${truncated}`;
+  }
+  return `    - { name: ${asyncPrefix}${f.name}, lines: ${f.lines[0]}-${f.lines[1]} }${comment}`;
+}
+function renderTypeDef(t) {
+  const exportedSuffix = t.exported ? "" : "  # local";
+  return `    - { name: ${t.name}, lines: ${t.lines[0]}-${t.lines[1]} }${exportedSuffix}`;
+}
+function renderEnum(e) {
+  const lines = [];
+  const exportedSuffix = e.exported ? "" : "  # local";
+  lines.push(`    - name: ${e.name}`);
+  lines.push(`      lines: ${e.lines[0]}-${e.lines[1]}${exportedSuffix}`);
+  if (e.members.length > 0) {
+    lines.push(`      members: [${e.members.join(", ")}]`);
+  }
+  return lines;
+}
+function renderYaml(entries, opts) {
+  const now = (/* @__PURE__ */ new Date()).toISOString().replace(/\.\d+Z$/, "Z");
+  const totalSrc = entries.reduce((s, e) => s + e.total_lines, 0);
+  const bodyLines = [];
+  for (let i = 0; i < entries.length; i++) {
+    const e = entries[i];
+    if (i > 0)
+      bodyLines.push("");
+    const pathKey = quotePath(e.path);
+    bodyLines.push(`${pathKey}:  # ${e.total_lines} lines`);
+    if (e.imports.length > 0) {
+      bodyLines.push("  imports:");
+      for (const imp of e.imports) {
+        const mod = quoteScalar(imp.module);
+        bodyLines.push(`    - { module: ${mod}, items: ${renderItems(imp.items)}, line: ${imp.line} }`);
+      }
+    }
+    if (e.constants.length > 0) {
+      bodyLines.push("  constants:");
+      for (const c of e.constants) {
+        bodyLines.push(`    - { name: ${c.name}, line: ${c.line} }`);
+      }
+    }
+    if (e.classes.length > 0) {
+      bodyLines.push("  classes:");
+      for (const c of e.classes) {
+        bodyLines.push(...renderClass(c));
+      }
+    }
+    if (e.functions.length > 0) {
+      bodyLines.push("  functions:");
+      for (const f of e.functions) {
+        bodyLines.push(renderFunction(f));
+      }
+    }
+    if (e.interfaces && e.interfaces.length > 0) {
+      bodyLines.push("  interfaces:");
+      for (const t of e.interfaces) {
+        bodyLines.push(renderTypeDef(t));
+      }
+    }
+    if (e.types && e.types.length > 0) {
+      bodyLines.push("  types:");
+      for (const t of e.types) {
+        bodyLines.push(renderTypeDef(t));
+      }
+    }
+    if (e.enums && e.enums.length > 0) {
+      bodyLines.push("  enums:");
+      for (const en of e.enums) {
+        bodyLines.push(...renderEnum(en));
+      }
+    }
+  }
+  const headerLineCount = opts.sourcesDigest ? 3 : 2;
+  const mapLines = bodyLines.length + headerLineCount;
+  const compression = totalSrc === 0 ? 0 : totalSrc / mapLines;
+  const fileCount = entries.length;
+  const header = [
+    `# generated: ${now} by ${opts.generator}`,
+    `# files: ${fileCount}, src-lines: ${totalSrc}, map-lines: ${mapLines}, compression: ${compression.toFixed(1)}x`
+  ];
+  if (opts.sourcesDigest) {
+    header.push(`# sources-digest: ${opts.sourcesDigest}`);
+  }
+  return [...header, ...bodyLines].join("\n") + "\n";
+}
+var YAML_RESERVED;
+var init_yaml_writer = __esm({
+  "src/code-map/yaml-writer.ts"() {
+    "use strict";
+    YAML_RESERVED = /[:[\]{},&*!|>'"%@`#]/;
+  }
+});
+
+// src/code-map/orchestrator.ts
+async function scanInProcess(scanner, absolutePaths, repoRoot) {
+  const entries = [];
+  const warnings = [];
+  for (const absPath of absolutePaths) {
     try {
-      const mtime = statSync3(absPath).mtimeMs;
-      if (mtime > mapMtime) {
-        const rel = absPath.replace(/\\/g, "/").replace(cwd.replace(/\\/g, "/") + "/", "");
-        staleAll.push(rel);
+      const entry = await scanner.scan(absPath, repoRoot);
+      if (entry === null) {
+        const rel = absPath.replace(/\\/g, "/").replace(repoRoot.replace(/\\/g, "/") + "/", "");
+        warnings.push({ path: rel, message: "parse error (scanner returned null)" });
+      } else {
+        entries.push(entry);
       }
-    } catch {
+    } catch (err) {
+      const rel = absPath.replace(/\\/g, "/").replace(repoRoot.replace(/\\/g, "/") + "/", "");
+      warnings.push({ path: rel, message: `IO error: ${err.message}` });
     }
   }
-  if (staleAll.length === 0) {
-    return { status: "ok", staleFiles: [], staleCount: 0, mapPath };
+  return { entries, warnings };
+}
+function bucketByExtension(files) {
+  const out = {};
+  for (const f of files) {
+    const dot = f.lastIndexOf(".");
+    const ext = dot >= 0 ? f.slice(dot).toLowerCase() : "";
+    if (!out[ext])
+      out[ext] = [];
+    out[ext].push(f);
   }
-  return {
-    status: "stale",
-    staleFiles: staleAll.slice(0, 5),
-    staleCount: staleAll.length,
-    mapPath
-  };
+  return out;
 }
-var init_freshness = __esm({
-  "src/code-map/freshness.ts"() {
+var init_orchestrator = __esm({
+  "src/code-map/orchestrator.ts"() {
     "use strict";
     init_include_exclude();
-    init_config();
   }
 });
 
-// src/commands/migrate.ts
-var migrate_exports = {};
-__export(migrate_exports, {
-  migrate: () => migrate
+// src/code-map/scanners/common.ts
+import { relative as relative4 } from "path";
+function canonicalRelPath(absolutePath, repoRoot) {
+  const rel = relative4(repoRoot, absolutePath);
+  return rel.replace(/\\/g, "/").normalize("NFC");
+}
+function isAllCapsConst(name) {
+  return name.length >= 2 && /^[A-Z][A-Z0-9_]*$/.test(name);
+}
+function isBinary(content) {
+  const head = content.slice(0, 4096);
+  return head.includes("\0");
+}
+var init_common = __esm({
+  "src/code-map/scanners/common.ts"() {
+    "use strict";
+  }
 });
-import { join as join16 } from "path";
-import { cpSync as cpSync2, existsSync as existsSync14, mkdirSync as mkdirSync6, readdirSync as readdirSync8, readFileSync as readFileSync11, renameSync, rmSync as rmSync2, writeFileSync as writeFileSync6 } from "fs";
-import yaml3 from "js-yaml";
-function backupChangeDir(cwd, changeId, sessionStamp) {
-  const backupRoot = join16(cwd, ".cdd", "migrate-backup", sessionStamp);
-  const backupDir2 = join16(backupRoot, changeId);
-  mkdirSync6(backupRoot, { recursive: true });
-  const sourceDir = join16(cwd, "specs", "changes", changeId);
-  if (existsSync14(sourceDir)) {
-    cpSync2(sourceDir, backupDir2, { recursive: true });
+
+// src/code-map/scanners/python.ts
+var python_exports = {};
+__export(python_exports, {
+  pythonScanner: () => pythonScanner
+});
+import { spawnSync as spawnSync2 } from "child_process";
+import { writeFileSync as writeFileSync5, unlinkSync } from "fs";
+import { join as join13 } from "path";
+import { tmpdir } from "os";
+function detectPython2() {
+  for (const candidate of ["python3", "python"]) {
+    try {
+      const result = spawnSync2(candidate, ["--version"], {
+        encoding: "utf8",
+        timeout: 5e3
+      });
+      if (result.status === 0)
+        return candidate;
+    } catch {
+    }
   }
-  return backupDir2;
+  return null;
 }
-function buildLegacyContextManifest(changeId) {
-  return [
-    "# Context Manifest",
-    "",
-    "Generated by `cdd-kit migrate` for an existing change.",
-    "Legacy manifest. Forbidden paths come from `.cdd/context-policy.json`.",
-    "",
-    "## Affected Surfaces",
-    "- legacy-unknown",
-    "",
-    "## Allowed Paths",
-    `- specs/changes/${changeId}/`,
-    "",
-    "## Required Contracts",
-    "- legacy-unknown",
-    "",
-    "## Required Tests",
-    "- legacy-unknown",
-    "",
-    "## Agent Work Packets",
-    "",
-    "## Context Expansion Requests",
-    "-",
-    "",
-    "## Approved Expansions",
-    "-",
-    ""
-  ].join("\n");
-}
-function buildContextGovernedManifest(changeId) {
-  return [
-    "# Context Manifest",
-    "",
-    "Generated by `cdd-kit migrate --enable-context-governance` for an existing change.",
-    "Review and narrow the allowed paths before assigning implementation work.",
-    "Forbidden paths come from `.cdd/context-policy.json`.",
-    "",
-    "## Affected Surfaces",
-    "- legacy-unknown",
-    "",
-    "## Allowed Paths",
-    `- specs/changes/${changeId}/`,
-    "- specs/context/project-map.md",
-    "- specs/context/contracts-index.md",
-    "",
-    "## Required Contracts",
-    "- legacy-unknown",
-    "",
-    "## Required Tests",
-    "- legacy-unknown",
-    "",
-    "## Agent Work Packets",
-    "",
-    "### change-classifier",
-    "- allowed:",
-    `  - specs/changes/${changeId}/`,
-    "  - specs/context/project-map.md",
-    "  - specs/context/contracts-index.md",
-    "",
-    "## Context Expansion Requests",
-    "",
-    "<!--",
-    "Agents must request context expansion instead of reading outside their work packet.",
-    "Use this format only for real requests:",
-    "",
-    "- request-id: CER-001",
-    "  requested_paths:",
-    "    - src/example.ts",
-    "  reason: why this file is required",
-    "  status: pending",
-    "-->",
-    "",
-    "## Approved Expansions",
-    "-",
-    ""
-  ].join("\n");
-}
-function parseLegacyFrontmatter(content) {
-  const m = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
-  if (!m)
-    return {};
-  const out = {};
-  for (const line of m[1].split(/\r?\n/)) {
-    const colon = line.indexOf(":");
-    if (colon === -1)
-      continue;
-    const key = line.slice(0, colon).trim();
-    if (!key)
-      continue;
-    out[key] = line.slice(colon + 1).trim();
-  }
-  return out;
-}
-function parseListField(raw) {
-  if (!raw)
-    return [];
-  const trimmed = raw.trim();
-  if (!trimmed || trimmed === "[]")
-    return [];
-  const inner = trimmed.startsWith("[") && trimmed.endsWith("]") ? trimmed.slice(1, -1) : trimmed;
-  return inner.split(",").map((item) => item.trim().replace(/^["']|["']$/g, "")).filter(Boolean);
-}
-function parseLegacyTaskList(body) {
-  const lines = body.split(/\r?\n/);
-  const rows = [];
-  let currentSection;
-  for (const raw of lines) {
-    const headerMatch = raw.match(/^##\s+\d+\.\s+(.*)\s*$/);
-    if (headerMatch) {
-      currentSection = headerMatch[1].trim();
-      continue;
-    }
-    const itemMatch = raw.match(/^\s*-\s*\[([ xX\-])\]\s+(\d+(?:\.\d+)*)\s+(.*)\s*$/);
-    if (!itemMatch)
-      continue;
-    const mark = itemMatch[1];
-    const id = itemMatch[2];
-    const title = itemMatch[3].trim();
-    let status = "pending";
-    if (mark === "x" || mark === "X")
-      status = "done";
-    else if (mark === "-")
-      status = "skipped";
-    rows.push({ id, title, status, section: currentSection });
-  }
-  return rows;
-}
-function migrateTasksFile(changeId, changeDir, enableContextGovernance, detectedTier, changed, warnings, pendingWrites, pendingDeletes) {
-  const newPath = join16(changeDir, "tasks.yml");
-  const legacyPath = join16(changeDir, "tasks.md");
-  if (existsSync14(newPath)) {
-    return;
-  }
-  if (!existsSync14(legacyPath)) {
-    warnings.push("tasks.md not found and tasks.yml missing \u2014 skipping tasks migration");
-    return;
-  }
-  const raw = readFileSync11(legacyPath, "utf8");
-  const fm = parseLegacyFrontmatter(raw);
-  const bodyMatch = raw.match(/^---\r?\n[\s\S]*?\r?\n---\r?\n?([\s\S]*)$/);
-  const body = bodyMatch ? bodyMatch[1] : raw;
-  const tasksRows = parseLegacyTaskList(body);
-  const data = {};
-  data["change-id"] = fm["change-id"] || changeId;
-  data["status"] = fm["status"] || "in-progress";
-  if (fm["tier"] && /^\d+$/.test(fm["tier"])) {
-    data["tier"] = parseInt(fm["tier"], 10);
-  } else if (detectedTier) {
-    data["tier"] = parseInt(detectedTier, 10);
-  } else {
-    data["tier"] = null;
-  }
-  if (enableContextGovernance || fm["context-governance"] === "v1") {
-    data["context-governance"] = "v1";
-  }
-  const archive2 = parseListField(fm["archive-tasks"]);
-  data["archive-tasks"] = archive2.length > 0 ? archive2 : ["7.1", "7.2"];
-  const deps = parseListField(fm["depends-on"]);
-  data["depends-on"] = deps;
-  data["tasks"] = tasksRows.map((r) => {
-    const out = { id: r.id, title: r.title, status: r.status };
-    if (r.section)
-      out["section"] = r.section;
-    return out;
-  });
-  const yamlOut = yaml3.dump(data, { lineWidth: -1, noRefs: true });
-  pendingWrites.push({ path: newPath, content: yamlOut });
-  pendingDeletes.push({ path: legacyPath });
-  changed.push(`tasks.md -> tasks.yml (${tasksRows.length} task(s) migrated)`);
-}
-function parseLegacyAgentLog(content) {
-  const lines = content.split(/\r?\n/);
-  const data = {};
-  let i = 0;
-  const topFieldRe = /^[ ]{0,1}-\s*([\w-]+):\s*(.*)$/;
-  while (i < lines.length) {
-    const line = lines[i];
-    const fieldMatch = line.match(topFieldRe);
-    if (!fieldMatch) {
-      i++;
-      continue;
-    }
-    const key = fieldMatch[1];
-    const inline = fieldMatch[2].trim();
-    if (key === "files-read" || key === "artifacts") {
-      const items = [];
-      let j = i + 1;
-      while (j < lines.length) {
-        const sub = lines[j];
-        if (topFieldRe.test(sub))
-          break;
-        if (/^#/.test(sub))
-          break;
-        const itemMatch = sub.match(/^\s{2,}-\s+(.+?)\s*$/);
-        if (itemMatch) {
-          items.push(itemMatch[1].trim());
+var TIMEOUT_MS, PythonScanner, pythonScanner;
+var init_python = __esm({
+  "src/code-map/scanners/python.ts"() {
+    "use strict";
+    init_paths();
+    init_common();
+    TIMEOUT_MS = parseInt(process.env["CDD_CODE_MAP_TIMEOUT_MS"] ?? "30000", 10);
+    PythonScanner = class {
+      extensions = [".py"];
+      _interpreter = void 0;
+      getInterpreter() {
+        if (this._interpreter === void 0) {
+          this._interpreter = detectPython2();
         }
-        j++;
+        return this._interpreter;
       }
-      if (key === "files-read") {
-        data["files-read"] = items;
-      } else {
-        data["artifacts"] = items.map((s) => {
-          const idx = s.indexOf(":");
-          if (idx === -1) {
-            return { type: "note", pointer: s };
+      async scan(absolutePath, repoRoot) {
+        const result = await this.scanBatch([absolutePath], repoRoot);
+        return result.entries[0] ?? null;
+      }
+      async scanBatch(absolutePaths, repoRoot) {
+        const interpreter = this.getInterpreter();
+        const entries = [];
+        const warnings = [];
+        if (!interpreter) {
+          const count = absolutePaths.length;
+          warnings.push({
+            path: "",
+            message: `python interpreter not found on PATH; skipping ${count} .py file${count === 1 ? "" : "s"}`
+          });
+          return { entries, warnings };
+        }
+        const scriptPath = ASSET.codeMapPython;
+        const rand = Math.random().toString(36).slice(2);
+        const listFile = join13(tmpdir(), `cdd-codemap-${process.pid}-${rand}.txt`);
+        writeFileSync5(listFile, absolutePaths.join("\n") + "\n", "utf8");
+        let stdout = "";
+        let stderr = "";
+        let exitCode = 0;
+        try {
+          const result = spawnSync2(
+            interpreter,
+            [scriptPath, "--batch-file", listFile, "--repo-root", repoRoot],
+            {
+              encoding: "utf8",
+              timeout: TIMEOUT_MS,
+              maxBuffer: 50 * 1024 * 1024
+              // 50MB
+            }
+          );
+          stdout = result.stdout ?? "";
+          stderr = result.stderr ?? "";
+          exitCode = result.status ?? -1;
+          if (result.error) {
+            const errMsg = result.error.message ?? String(result.error);
+            if (errMsg.includes("ENOENT")) {
+              warnings.push({
+                path: "",
+                message: `python interpreter not found (ENOENT); skipping ${absolutePaths.length} .py file(s)`
+              });
+              return { entries, warnings };
+            }
+            if (errMsg.includes("ETIMEDOUT") || errMsg.includes("timeout")) {
+              warnings.push({
+                path: "",
+                message: `python scanner timed out after ${TIMEOUT_MS}ms; skipping .py files`
+              });
+              return { entries, warnings };
+            }
+            warnings.push({
+              path: "",
+              message: `python scanner error: ${errMsg}; skipping .py files`
+            });
+            return { entries, warnings };
           }
-          const type = s.slice(0, idx).trim();
-          const pointer = s.slice(idx + 1).trim();
-          return { type, pointer };
-        });
+        } finally {
+          try {
+            unlinkSync(listFile);
+          } catch {
+          }
+        }
+        if (exitCode === 3) {
+          warnings.push({
+            path: "",
+            message: "python interpreter is < 3.9 (need ast.unparse); skipping .py files"
+          });
+          return { entries, warnings };
+        }
+        for (const line of stdout.split("\n")) {
+          const trimmed = line.trim();
+          if (!trimmed)
+            continue;
+          let parsed;
+          try {
+            parsed = JSON.parse(trimmed);
+          } catch {
+            continue;
+          }
+          if (!parsed.ok) {
+            warnings.push({ path: parsed.path, message: parsed.error });
+            continue;
+          }
+          const r = parsed;
+          entries.push({
+            path: canonicalRelPath(join13(repoRoot, r.path), repoRoot),
+            total_lines: r.total_lines,
+            imports: r.imports ?? [],
+            constants: r.constants ?? [],
+            classes: (r.classes ?? []).map((c) => ({
+              name: c.name,
+              lines: [c.lines[0], c.lines[1]],
+              methods: (c.methods ?? []).map((m) => ({
+                name: m.name,
+                lines: [m.lines[0], m.lines[1]],
+                async: m.async
+              }))
+            })),
+            functions: (r.functions ?? []).map((f) => ({
+              name: f.name,
+              lines: [f.lines[0], f.lines[1]],
+              decorators: f.decorators ?? [],
+              async: f.async
+            }))
+          });
+        }
+        if (exitCode === 2) {
+          warnings.push({
+            path: "",
+            message: `python scanner exited with code 2 (fatal); partial results only. stderr: ${stderr.slice(0, 200)}`
+          });
+        }
+        return { entries, warnings };
       }
-      i = j;
-      continue;
-    }
-    data[key] = inline;
-    i++;
+    };
+    pythonScanner = new PythonScanner();
   }
-  return data;
+});
+
+// src/code-map/scanners/javascript.ts
+var javascript_exports = {};
+__export(javascript_exports, {
+  COMMON_PLUGINS: () => COMMON_PLUGINS,
+  countSourceLines: () => countSourceLines,
+  jsScanner: () => jsScanner,
+  parseAndExtract: () => parseAndExtract,
+  parseJsSource: () => parseJsSource,
+  parseSourceWithPlugins: () => parseSourceWithPlugins
+});
+import { readFileSync as readFileSync10 } from "fs";
+import { parse } from "@babel/parser";
+function parseSourceWithPlugins(source, plugins) {
+  return parse(source, {
+    sourceType: "unambiguous",
+    allowReturnOutsideFunction: true,
+    allowAwaitOutsideFunction: true,
+    errorRecovery: true,
+    plugins
+  });
+}
+function isCallExpression(node, callee) {
+  if (!node || node.type !== "CallExpression")
+    return false;
+  const c = node.callee;
+  return c.type === "Identifier" && c.name === callee;
+}
+function extractRequireModule(node) {
+  if (!node || node.type !== "CallExpression")
+    return null;
+  const c = node.callee;
+  if (c.type !== "Identifier" || c.name !== "require")
+    return null;
+  const arg = node.arguments[0];
+  if (!arg || arg.type !== "StringLiteral")
+    return null;
+  return arg.value;
 }
-function migrateAgentLogs(changeDir, changed, pendingWrites, pendingDeletes) {
-  const agentLogDir = join16(changeDir, "agent-log");
-  if (!existsSync14(agentLogDir))
-    return;
-  const mdLogs = readdirSync8(agentLogDir).filter((f) => f.endsWith(".md"));
-  for (const f of mdLogs) {
-    const fullPath = join16(agentLogDir, f);
-    const yamlName = f.replace(/\.md$/, ".yml");
-    const yamlFull = join16(agentLogDir, yamlName);
-    if (existsSync14(yamlFull))
-      continue;
-    const raw = readFileSync11(fullPath, "utf8");
-    const parsed = parseLegacyAgentLog(raw);
-    const yamlOut = yaml3.dump(parsed, { lineWidth: -1, noRefs: true });
-    pendingWrites.push({ path: yamlFull, content: yamlOut });
-    pendingDeletes.push({ path: fullPath });
-    changed.push(`agent-log/${f} -> agent-log/${yamlName}`);
-  }
+function getLineRange(node) {
+  const start = node.loc?.start.line ?? 1;
+  const end = node.loc?.end.line ?? start;
+  return [start, end];
 }
-function migrateOne(changeId, changeDir, enableContextGovernance) {
-  const changed = [];
-  const warnings = [];
-  const pending = [];
-  const deletes = [];
-  let detectedTier = null;
-  const classifPath = join16(changeDir, "change-classification.md");
-  if (existsSync14(classifPath)) {
-    const content = readFileSync11(classifPath, "utf8");
-    const hasNewTierFormat = /^## Tier\s*\n\s*-\s*\d\s*$/m.test(content);
-    const oldMatch = content.match(/\*\*Tier[:\*]+\s*(?:Tier\s*)?(\d)/i) ?? content.match(/^-?\s*Tier:\s*(?:Tier\s*)?(\d)/mi);
-    if (oldMatch)
-      detectedTier = oldMatch[1];
-    if (!hasNewTierFormat) {
-      if (detectedTier) {
-        const addition = `
-## Tier
-- ${detectedTier}
-`;
-        if (!content.includes("\n## Tier\n")) {
-          changed.push(
-            `change-classification.md: appended "## Tier\\n- ${detectedTier}" (converted from old format)`
-          );
-          pending.push({ path: classifPath, content: content + addition });
-        }
-      } else {
-        warnings.push(
-          "change-classification.md: could not detect tier (no **Tier:** N or ## Tier N found). Set `tier: <0-5>` in tasks.yml frontmatter to enable tier-based gate checks."
-        );
-      }
-    } else {
-      const structured = content.match(/^## Tier\s*\n\s*-\s*(\d)\s*$/m);
-      if (structured)
-        detectedTier = structured[1];
+function processImportDeclaration(node) {
+  const items = [];
+  for (const spec of node.specifiers) {
+    if (spec.type === "ImportDefaultSpecifier") {
+      items.push(`default:${spec.local.name}`);
+    } else if (spec.type === "ImportNamespaceSpecifier") {
+      items.push(`*:${spec.local.name}`);
+    } else if (spec.type === "ImportSpecifier") {
+      const imported = spec.imported;
+      items.push(imported.type === "Identifier" ? imported.name : spec.local.name);
     }
   }
-  migrateTasksFile(changeId, changeDir, enableContextGovernance, detectedTier, changed, warnings, pending, deletes);
-  migrateAgentLogs(changeDir, changed, pending, deletes);
-  const manifestPath = join16(changeDir, "context-manifest.md");
-  if (!existsSync14(manifestPath)) {
-    changed.push(enableContextGovernance ? "context-manifest.md: added context-governance v1 manifest scaffold" : "context-manifest.md: added legacy context manifest scaffold");
-    pending.push({
-      path: manifestPath,
-      content: enableContextGovernance ? buildContextGovernedManifest(changeId) : buildLegacyContextManifest(changeId)
-    });
-  } else if (enableContextGovernance) {
-    warnings.push("context-manifest.md already exists \u2014 review allowed paths before relying on context-governance: v1");
-  }
-  return { result: { changed, warnings }, pending, deletes };
+  return {
+    module: node.source.value,
+    items,
+    line: node.loc?.start.line ?? 1
+  };
 }
-function commitWritesAtomically(pending, deletes) {
-  const renames = [];
-  try {
-    for (const write of pending) {
-      const tmp = `${write.path}.cdd-migrate.tmp`;
-      writeFileSync6(tmp, write.content, "utf8");
-      renames.push({ tmp, final: write.path });
-    }
-  } catch (err) {
-    for (const r of renames) {
-      try {
-        rmSync2(r.tmp, { force: true });
-      } catch {
+function processFunctionDeclaration(node, nameOverride) {
+  const name = nameOverride ?? node.id?.name;
+  if (!name)
+    return null;
+  return {
+    name,
+    lines: getLineRange(node),
+    decorators: [],
+    async: node.async
+  };
+}
+function processClassDeclaration(node, nameOverride) {
+  const name = nameOverride ?? node.id?.name;
+  if (!name)
+    return null;
+  const methods = [];
+  for (const member of node.body.body) {
+    if (member.type === "ClassMethod" || member.type === "ClassPrivateMethod") {
+      const m = member;
+      let methodName;
+      if (m.key.type === "Identifier") {
+        methodName = m.key.name;
+      } else if (m.key.type === "PrivateName") {
+        methodName = `#${m.key.id.name}`;
+      } else {
+        methodName = "<computed>";
       }
-    }
-    throw err;
-  }
-  for (const r of renames) {
-    renameSync(r.tmp, r.final);
-  }
-  for (const d of deletes) {
-    try {
-      rmSync2(d.path, { force: true });
-    } catch {
+      methods.push({
+        name: methodName,
+        lines: getLineRange(m),
+        async: m.async
+      });
     }
   }
+  return {
+    name,
+    lines: getLineRange(node),
+    methods
+  };
 }
-async function migrate(changeId, opts = {}) {
-  const cwd = process.cwd();
-  const dryRun = opts.dryRun ?? false;
-  const enableContextGovernance = opts.enableContextGovernance ?? false;
-  const noBackup = opts.noBackup ?? false;
-  const idsToMigrate = [];
-  if (opts.all) {
-    const changesDir = join16(cwd, "specs", "changes");
-    if (!existsSync14(changesDir)) {
-      log.info("No specs/changes/ directory found \u2014 nothing to migrate.");
-      return;
-    }
-    idsToMigrate.push(
-      ...readdirSync8(changesDir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name)
-    );
-  } else if (changeId) {
-    const specificDir = join16(cwd, "specs", "changes", changeId);
-    if (!existsSync14(specificDir)) {
-      log.error(`Change not found: specs/changes/${changeId}`);
-      process.exit(1);
-    }
-    idsToMigrate.push(changeId);
-  } else {
-    log.error("Usage: cdd-kit migrate <change-id>  |  cdd-kit migrate --all  [--dry-run] [--no-backup]");
-    process.exit(1);
-  }
-  if (idsToMigrate.length === 0) {
-    log.info("No changes found to migrate.");
-    return;
-  }
-  if (dryRun) {
-    log.info("Dry run \u2014 no files will be written.");
-    log.blank();
-  }
-  const sessionStamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
-  let migratedCount = 0;
-  let upToDateCount = 0;
-  const backupRoot = join16(cwd, ".cdd", "migrate-backup", sessionStamp);
-  for (const id of idsToMigrate) {
-    const changeDir = join16(cwd, "specs", "changes", id);
-    if (!existsSync14(changeDir)) {
-      log.warn(`  ${id}: directory not found \u2014 skipping`);
-      continue;
-    }
-    const { result, pending, deletes } = migrateOne(id, changeDir, enableContextGovernance);
-    const { changed, warnings } = result;
-    if (changed.length === 0) {
-      log.info(`  ${id}: already up to date`);
-      upToDateCount++;
-      for (const w of warnings)
-        log.warn(`  ${id}: ${w}`);
+function processVariableDeclaration(node, imports, constants, functions) {
+  for (const decl of node.declarations) {
+    if (!decl.id || decl.id.type !== "Identifier")
       continue;
-    }
-    if (!dryRun) {
-      try {
-        if (!noBackup)
-          backupChangeDir(cwd, id, sessionStamp);
-        commitWritesAtomically(pending, deletes);
-      } catch (err) {
-        log.error(`  ${id}: migration failed \u2014 ${err.message}`);
-        if (!noBackup) {
-          log.error(`  ${id}: restore from .cdd/migrate-backup/${sessionStamp}/${id}/`);
-        }
-        process.exit(1);
+    const varName = decl.id.name;
+    const init2 = decl.init;
+    if (init2 && isCallExpression(init2, "require")) {
+      const mod = extractRequireModule(init2);
+      if (mod) {
+        imports.push({ module: mod, items: [`default:${varName}`], line: node.loc?.start.line ?? 1 });
       }
-    }
-    log.ok(`  ${id}: migrated`);
-    for (const c of changed)
-      log.info(`    + ${c}`);
-    migratedCount++;
-    for (const w of warnings)
-      log.warn(`  ${id}: ${w}`);
-  }
-  log.blank();
-  if (dryRun) {
-    log.info(`Dry run complete: ${migratedCount} change(s) would be updated, ${upToDateCount} already up to date.`);
-  } else {
-    log.ok(`Migration complete: ${migratedCount} updated, ${upToDateCount} already up to date.`);
-    if (migratedCount > 0 && !noBackup) {
-      log.info(`Backup: ${backupRoot}`);
-      log.info('Next: git add specs/changes/ && git commit -m "chore: migrate changes to YAML format"');
-      log.info("When stable, remove backup: rm -rf .cdd/migrate-backup/");
-    }
-  }
-}
-var init_migrate = __esm({
-  "src/commands/migrate.ts"() {
-    "use strict";
-    init_logger();
-  }
-});
-
-// src/commands/upgrade.ts
-var upgrade_exports = {};
-__export(upgrade_exports, {
-  upgrade: () => upgrade
-});
-import { existsSync as existsSync15, mkdirSync as mkdirSync7, readdirSync as readdirSync9, copyFileSync as copyFileSync3, readFileSync as readFileSync12, writeFileSync as writeFileSync7 } from "fs";
-import { dirname as dirname4, join as join17, relative as relative3 } from "path";
-function planMissingFiles(srcDir, destDir, label, planned) {
-  if (!existsSync15(srcDir))
-    return;
-  for (const entry of readdirSync9(srcDir, { withFileTypes: true })) {
-    const src = join17(srcDir, entry.name);
-    const dest = join17(destDir, entry.name);
-    if (entry.isDirectory()) {
-      planMissingFiles(src, dest, join17(label, entry.name), planned);
       continue;
     }
-    if (!existsSync15(dest)) {
-      planned.push({ src, dest, rel: join17(label, relative3(srcDir, src)) });
-    }
-  }
-}
-function planProviderGuidance(cwd, provider, planned) {
-  if (provider === "claude" || provider === "both") {
-    if (!existsSync15(join17(cwd, "CLAUDE.md"))) {
-      planned.push({ src: ASSET.claudeTemplate, dest: join17(cwd, "CLAUDE.md"), rel: "CLAUDE.md" });
+    if (isAllCapsConst(varName) && init2 !== null && init2 !== void 0) {
+      constants.push({ name: varName, line: node.loc?.start.line ?? 1 });
+      continue;
     }
-    if (!existsSync15(join17(cwd, "AGENTS.md"))) {
-      planned.push({ src: ASSET.agentsTemplate, dest: join17(cwd, "AGENTS.md"), rel: "AGENTS.md" });
+    if (init2 && (init2.type === "ArrowFunctionExpression" || init2.type === "FunctionExpression")) {
+      functions.push({
+        name: varName,
+        lines: getLineRange(node),
+        decorators: [],
+        async: init2.async
+      });
+    } else if (init2 && init2.type === "CallExpression" && /^[A-Z]/.test(varName)) {
+      functions.push({
+        name: varName,
+        lines: getLineRange(node),
+        decorators: [],
+        async: false
+      });
     }
   }
-  if ((provider === "codex" || provider === "both") && !existsSync15(join17(cwd, "CODEX.md"))) {
-    planned.push({ src: ASSET.codexTemplate, dest: join17(cwd, "CODEX.md"), rel: "CODEX.md" });
-  }
 }
-function applyCopy(plan) {
-  for (const item of plan) {
-    mkdirSync7(dirname4(item.dest), { recursive: true });
-    copyFileSync3(item.src, item.dest);
-  }
+function processTsInterfaceDeclaration(node, exported) {
+  if (!node || node.type !== "TSInterfaceDeclaration")
+    return null;
+  if (!node.id || node.id.type !== "Identifier")
+    return null;
+  return {
+    name: node.id.name,
+    lines: getLineRange(node),
+    exported
+  };
 }
-async function upgrade(opts = {}) {
-  const cwd = process.cwd();
-  const requestedProvider = opts.provider ?? "auto";
-  if (!validateProviderOption(requestedProvider)) {
-    log.error(`Invalid provider: ${requestedProvider}. Use auto, claude, codex, or both.`);
-    process.exit(1);
+function processTsTypeAliasDeclaration(node, exported) {
+  if (!node || node.type !== "TSTypeAliasDeclaration")
+    return null;
+  if (!node.id || node.id.type !== "Identifier")
+    return null;
+  return {
+    name: node.id.name,
+    lines: getLineRange(node),
+    exported
+  };
+}
+function processTsEnumDeclaration(node, exported) {
+  if (!node || node.type !== "TSEnumDeclaration")
+    return null;
+  if (!node.id || node.id.type !== "Identifier")
+    return null;
+  const members = [];
+  for (const m of node.members ?? []) {
+    if (!m || !m.id)
+      continue;
+    if (m.id.type === "Identifier")
+      members.push(m.id.name);
+    else if (m.id.type === "StringLiteral")
+      members.push(m.id.value);
   }
-  const provider = inferProvider(cwd, requestedProvider);
-  const plan = [];
-  planMissingFiles(ASSET.contracts, join17(cwd, "contracts"), "contracts", plan);
-  planMissingFiles(ASSET.specsTemplates, join17(cwd, "specs", "templates"), "specs/templates", plan);
-  planMissingFiles(ASSET.testsTemplates, join17(cwd, "tests", "templates"), "tests/templates", plan);
-  planMissingFiles(ASSET.ci, join17(cwd, "ci"), "ci", plan);
-  planMissingFiles(ASSET.githubWorkflows, join17(cwd, ".github", "workflows"), ".github/workflows", plan);
-  planMissingFiles(ASSET.cddConfig, join17(cwd, ".cdd"), ".cdd", plan);
-  planProviderGuidance(cwd, provider, plan);
-  log.blank();
-  log.info(`Upgrade provider: ${provider}`);
-  if (plan.length === 0) {
-    log.ok("No missing cdd-kit project files found.");
-    if (opts.migrateChanges) {
-      log.blank();
-      log.info("Running change migration flow...");
-      await migrate(void 0, {
-        all: true,
-        dryRun: !opts.yes,
-        enableContextGovernance: opts.enableContextGovernance
-      });
-    }
-    log.blank();
+  return {
+    name: node.id.name,
+    lines: getLineRange(node),
+    exported,
+    members
+  };
+}
+function processStatement(stmt, buckets, extractTsTypes, exportedFromWrapper = false) {
+  if (stmt.type === "ExportNamedDeclaration" && stmt.declaration) {
+    processStatement(stmt.declaration, buckets, extractTsTypes, true);
     return;
   }
-  log.info(`${plan.length} missing file(s) detected:`);
-  for (const item of plan)
-    log.dim(`  + ${item.rel.replace(/\\/g, "/")}`);
-  if (!opts.yes) {
-    log.blank();
-    log.info("Dry run only. Re-run with --yes to write missing files.");
-    if (opts.migrateChanges) {
-      log.blank();
-      log.info("Previewing existing change migration because --migrate-changes was requested.");
-      await migrate(void 0, {
-        all: true,
-        dryRun: true,
-        enableContextGovernance: opts.enableContextGovernance
-      });
+  if (stmt.type === "ExportDefaultDeclaration") {
+    const decl = stmt.declaration;
+    if (decl.type === "FunctionDeclaration") {
+      const fe = processFunctionDeclaration(decl, decl.id?.name ?? "default");
+      if (fe)
+        buckets.functions.push(fe);
+    } else if (decl.type === "ClassDeclaration") {
+      const ce = processClassDeclaration(decl, decl.id?.name ?? "default");
+      if (ce)
+        buckets.classes.push(ce);
     }
-    log.blank();
     return;
   }
-  applyCopy(plan);
-  const modelPolicyPath = join17(cwd, ".cdd", "model-policy.json");
-  if (existsSync15(modelPolicyPath)) {
-    let existing = {};
-    try {
-      existing = JSON.parse(readFileSync12(modelPolicyPath, "utf8"));
-    } catch {
-    }
-    const merged = {
-      ...existing,
-      provider,
-      generated_at: (/* @__PURE__ */ new Date()).toISOString(),
-      roles: existing.roles && typeof existing.roles === "object" ? existing.roles : {}
-    };
-    writeFileSync7(modelPolicyPath, JSON.stringify(merged, null, 2) + "\n", "utf8");
-  }
-  log.blank();
-  log.ok(`Upgrade complete: ${plan.length} missing file(s) added.`);
-  log.info("Existing project guidance and contracts were preserved.");
-  if (opts.migrateChanges) {
-    log.blank();
-    log.info("Running change migration flow...");
-    await migrate(void 0, {
-      all: true,
-      dryRun: false,
-      enableContextGovernance: opts.enableContextGovernance
-    });
-  }
-  log.blank();
-}
-var init_upgrade = __esm({
-  "src/commands/upgrade.ts"() {
-    "use strict";
-    init_paths();
-    init_logger();
-    init_provider();
-    init_migrate();
-  }
-});
-
-// src/code-map/yaml-writer.ts
-function quoteScalar(s) {
-  if (s.startsWith(".") || YAML_RESERVED.test(s) || s.includes(" ") || s === "" || s === "null" || s === "true" || s === "false") {
-    return `'${s.replace(/'/g, "''")}'`;
-  }
-  return s;
-}
-function quotePath(p) {
-  if (YAML_RESERVED.test(p) || p.includes(" ")) {
-    return `'${p.replace(/'/g, "''")}'`;
+  if (stmt.type === "ImportDeclaration") {
+    buckets.imports.push(processImportDeclaration(stmt));
+    return;
   }
-  return p;
-}
-function renderItems(items) {
-  if (items.length === 0)
-    return "[]";
-  return `[${items.map(quoteScalar).join(", ")}]`;
-}
-function truncateDecorator(d, max = 80) {
-  const cleaned = d.replace(/\r?\n/g, " ");
-  return cleaned.length <= max ? cleaned : cleaned.slice(0, max) + "...";
-}
-function renderClass(c) {
-  const lines = [];
-  lines.push(`    - name: ${c.name}`);
-  lines.push(`      lines: ${c.lines[0]}-${c.lines[1]}`);
-  if (c.methods.length > 0) {
-    lines.push("      methods:");
-    for (const m of c.methods) {
-      const asyncPrefix = m.async ? "async " : "";
-      lines.push(`        - { name: ${asyncPrefix}${m.name}, lines: ${m.lines[0]}-${m.lines[1]} }`);
-    }
+  if (stmt.type === "FunctionDeclaration") {
+    const fe = processFunctionDeclaration(stmt);
+    if (fe)
+      buckets.functions.push(fe);
+    return;
   }
-  return lines;
-}
-function renderFunction(f) {
-  const asyncPrefix = f.async ? "async " : "";
-  let comment = "";
-  if (f.decorators.length > 0) {
-    const truncated = truncateDecorator(f.decorators[0]);
-    comment = `  # @${truncated}`;
+  if (stmt.type === "ClassDeclaration") {
+    const ce = processClassDeclaration(stmt);
+    if (ce)
+      buckets.classes.push(ce);
+    return;
   }
-  return `    - { name: ${asyncPrefix}${f.name}, lines: ${f.lines[0]}-${f.lines[1]} }${comment}`;
-}
-function renderTypeDef(t) {
-  const exportedSuffix = t.exported ? "" : "  # local";
-  return `    - { name: ${t.name}, lines: ${t.lines[0]}-${t.lines[1]} }${exportedSuffix}`;
-}
-function renderEnum(e) {
-  const lines = [];
-  const exportedSuffix = e.exported ? "" : "  # local";
-  lines.push(`    - name: ${e.name}`);
-  lines.push(`      lines: ${e.lines[0]}-${e.lines[1]}${exportedSuffix}`);
-  if (e.members.length > 0) {
-    lines.push(`      members: [${e.members.join(", ")}]`);
+  if (stmt.type === "VariableDeclaration") {
+    processVariableDeclaration(stmt, buckets.imports, buckets.constants, buckets.functions);
+    return;
   }
-  return lines;
-}
-function renderYaml(entries, opts) {
-  const now = (/* @__PURE__ */ new Date()).toISOString().replace(/\.\d+Z$/, "Z");
-  const totalSrc = entries.reduce((s, e) => s + e.total_lines, 0);
-  const bodyLines = [];
-  for (let i = 0; i < entries.length; i++) {
-    const e = entries[i];
-    if (i > 0)
-      bodyLines.push("");
-    const pathKey = quotePath(e.path);
-    bodyLines.push(`${pathKey}:  # ${e.total_lines} lines`);
-    if (e.imports.length > 0) {
-      bodyLines.push("  imports:");
-      for (const imp of e.imports) {
-        const mod = quoteScalar(imp.module);
-        bodyLines.push(`    - { module: ${mod}, items: ${renderItems(imp.items)}, line: ${imp.line} }`);
-      }
-    }
-    if (e.constants.length > 0) {
-      bodyLines.push("  constants:");
-      for (const c of e.constants) {
-        bodyLines.push(`    - { name: ${c.name}, line: ${c.line} }`);
-      }
-    }
-    if (e.classes.length > 0) {
-      bodyLines.push("  classes:");
-      for (const c of e.classes) {
-        bodyLines.push(...renderClass(c));
-      }
-    }
-    if (e.functions.length > 0) {
-      bodyLines.push("  functions:");
-      for (const f of e.functions) {
-        bodyLines.push(renderFunction(f));
-      }
-    }
-    if (e.interfaces && e.interfaces.length > 0) {
-      bodyLines.push("  interfaces:");
-      for (const t of e.interfaces) {
-        bodyLines.push(renderTypeDef(t));
-      }
+  if (extractTsTypes) {
+    const anyStmt = stmt;
+    if (anyStmt.type === "TSInterfaceDeclaration") {
+      const e = processTsInterfaceDeclaration(anyStmt, exportedFromWrapper);
+      if (e)
+        buckets.interfaces.push(e);
+      return;
     }
-    if (e.types && e.types.length > 0) {
-      bodyLines.push("  types:");
-      for (const t of e.types) {
-        bodyLines.push(renderTypeDef(t));
-      }
+    if (anyStmt.type === "TSTypeAliasDeclaration") {
+      const e = processTsTypeAliasDeclaration(anyStmt, exportedFromWrapper);
+      if (e)
+        buckets.types.push(e);
+      return;
     }
-    if (e.enums && e.enums.length > 0) {
-      bodyLines.push("  enums:");
-      for (const en of e.enums) {
-        bodyLines.push(...renderEnum(en));
-      }
+    if (anyStmt.type === "TSEnumDeclaration") {
+      const e = processTsEnumDeclaration(anyStmt, exportedFromWrapper);
+      if (e)
+        buckets.enums.push(e);
+      return;
     }
   }
-  const mapLines = bodyLines.length + 2;
-  const compression = totalSrc === 0 ? 0 : totalSrc / mapLines;
-  const fileCount = entries.length;
-  const header = [
-    `# generated: ${now} by ${opts.generator}`,
-    `# files: ${fileCount}, src-lines: ${totalSrc}, map-lines: ${mapLines}, compression: ${compression.toFixed(1)}x`
-  ];
-  return [...header, ...bodyLines].join("\n") + "\n";
-}
-var YAML_RESERVED;
-var init_yaml_writer = __esm({
-  "src/code-map/yaml-writer.ts"() {
-    "use strict";
-    YAML_RESERVED = /[:[\]{},&*!|>'"%@`#]/;
-  }
-});
-
-// src/code-map/orchestrator.ts
-async function scanInProcess(scanner, absolutePaths, repoRoot) {
-  const entries = [];
-  const warnings = [];
-  for (const absPath of absolutePaths) {
-    try {
-      const entry = await scanner.scan(absPath, repoRoot);
-      if (entry === null) {
-        const rel = absPath.replace(/\\/g, "/").replace(repoRoot.replace(/\\/g, "/") + "/", "");
-        warnings.push({ path: rel, message: "parse error (scanner returned null)" });
-      } else {
-        entries.push(entry);
+  if (stmt.type === "ExpressionStatement") {
+    const expr = stmt.expression;
+    if (isCallExpression(expr, "require")) {
+      const mod = extractRequireModule(expr);
+      if (mod) {
+        buckets.imports.push({ module: mod, items: [], line: stmt.loc?.start.line ?? 1 });
       }
-    } catch (err) {
-      const rel = absPath.replace(/\\/g, "/").replace(repoRoot.replace(/\\/g, "/") + "/", "");
-      warnings.push({ path: rel, message: `IO error: ${err.message}` });
     }
   }
-  return { entries, warnings };
 }
-function bucketByExtension(files) {
-  const out = {};
-  for (const f of files) {
-    const dot = f.lastIndexOf(".");
-    const ext = dot >= 0 ? f.slice(dot).toLowerCase() : "";
-    if (!out[ext])
-      out[ext] = [];
-    out[ext].push(f);
+function parseAndExtract(source, opts) {
+  let ast;
+  try {
+    ast = parseSourceWithPlugins(source, opts.plugins);
+  } catch {
+    return null;
   }
-  return out;
-}
-var init_orchestrator = __esm({
-  "src/code-map/orchestrator.ts"() {
-    "use strict";
-    init_include_exclude();
+  const buckets = {
+    imports: [],
+    constants: [],
+    functions: [],
+    classes: [],
+    interfaces: [],
+    types: [],
+    enums: []
+  };
+  for (const stmt of ast.program.body) {
+    processStatement(stmt, buckets, !!opts.extractTsTypes);
   }
-});
-
-// src/code-map/scanners/common.ts
-import { relative as relative4 } from "path";
-function canonicalRelPath(absolutePath, repoRoot) {
-  const rel = relative4(repoRoot, absolutePath);
-  return rel.replace(/\\/g, "/").normalize("NFC");
+  return buckets;
 }
-function isAllCapsConst(name) {
-  return name.length >= 2 && /^[A-Z][A-Z0-9_]*$/.test(name);
+function countSourceLines(source) {
+  if (source === "")
+    return 0;
+  return source.split(/\r?\n/).length - (source.endsWith("\n") || source.endsWith("\r\n") ? 1 : 0);
 }
-function isBinary(content) {
-  const head = content.slice(0, 4096);
-  return head.includes("\0");
+function parseJsSource(source, relPath) {
+  const total_lines = countSourceLines(source);
+  const r = parseAndExtract(source, { plugins: JS_PLUGINS, extractTsTypes: false });
+  if (!r)
+    return null;
+  return {
+    path: relPath,
+    total_lines,
+    imports: r.imports,
+    constants: r.constants,
+    classes: r.classes,
+    functions: r.functions
+  };
 }
-var init_common = __esm({
-  "src/code-map/scanners/common.ts"() {
+var COMMON_PLUGINS, JS_PLUGINS, JavaScriptScanner, jsScanner;
+var init_javascript = __esm({
+  "src/code-map/scanners/javascript.ts"() {
     "use strict";
+    init_common();
+    COMMON_PLUGINS = [
+      "classProperties",
+      "classPrivateProperties",
+      "classPrivateMethods",
+      "decorators-legacy",
+      "topLevelAwait",
+      "dynamicImport",
+      "optionalChaining",
+      "nullishCoalescingOperator",
+      "objectRestSpread",
+      "asyncGenerators",
+      "numericSeparator",
+      "logicalAssignment"
+    ];
+    JS_PLUGINS = ["jsx", ...COMMON_PLUGINS];
+    JavaScriptScanner = class {
+      extensions = [".js"];
+      async scan(absolutePath, repoRoot) {
+        let source;
+        try {
+          source = readFileSync10(absolutePath, "utf8");
+        } catch (err) {
+          throw err;
+        }
+        if (isBinary(source)) {
+          return null;
+        }
+        const relPath = canonicalRelPath(absolutePath, repoRoot);
+        return parseJsSource(source, relPath);
+      }
+    };
+    jsScanner = new JavaScriptScanner();
   }
 });
 
-// src/code-map/scanners/python.ts
-var python_exports = {};
-__export(python_exports, {
-  pythonScanner: () => pythonScanner
+// src/code-map/scanners/typescript.ts
+var typescript_exports = {};
+__export(typescript_exports, {
+  tsScanner: () => tsScanner
 });
-import { spawnSync as spawnSync2 } from "child_process";
-import { writeFileSync as writeFileSync8, unlinkSync } from "fs";
-import { join as join18 } from "path";
-import { tmpdir } from "os";
-function detectPython2() {
-  for (const candidate of ["python3", "python"]) {
-    try {
-      const result = spawnSync2(candidate, ["--version"], {
-        encoding: "utf8",
-        timeout: 5e3
-      });
-      if (result.status === 0)
-        return candidate;
-    } catch {
-    }
-  }
-  return null;
-}
-var TIMEOUT_MS, PythonScanner, pythonScanner;
-var init_python = __esm({
-  "src/code-map/scanners/python.ts"() {
+import { readFileSync as readFileSync11 } from "fs";
+var TypeScriptScanner, tsScanner;
+var init_typescript = __esm({
+  "src/code-map/scanners/typescript.ts"() {
     "use strict";
-    init_paths();
     init_common();
-    TIMEOUT_MS = parseInt(process.env["CDD_CODE_MAP_TIMEOUT_MS"] ?? "30000", 10);
-    PythonScanner = class {
-      extensions = [".py"];
-      _interpreter = void 0;
-      getInterpreter() {
-        if (this._interpreter === void 0) {
-          this._interpreter = detectPython2();
-        }
-        return this._interpreter;
-      }
+    init_javascript();
+    TypeScriptScanner = class {
+      extensions = [".ts", ".tsx"];
       async scan(absolutePath, repoRoot) {
-        const result = await this.scanBatch([absolutePath], repoRoot);
-        return result.entries[0] ?? null;
-      }
-      async scanBatch(absolutePaths, repoRoot) {
-        const interpreter = this.getInterpreter();
-        const entries = [];
-        const warnings = [];
-        if (!interpreter) {
-          const count = absolutePaths.length;
-          warnings.push({
-            path: "",
-            message: `python interpreter not found on PATH; skipping ${count} .py file${count === 1 ? "" : "s"}`
-          });
-          return { entries, warnings };
+        let source;
+        try {
+          source = readFileSync11(absolutePath, "utf8");
+        } catch (err) {
+          throw err;
         }
-        const scriptPath = ASSET.codeMapPython;
-        const rand = Math.random().toString(36).slice(2);
-        const listFile = join18(tmpdir(), `cdd-codemap-${process.pid}-${rand}.txt`);
-        writeFileSync8(listFile, absolutePaths.join("\n") + "\n", "utf8");
-        let stdout = "";
-        let stderr = "";
-        let exitCode = 0;
+        if (isBinary(source)) {
+          return null;
+        }
+        const isTsx = absolutePath.toLowerCase().endsWith(".tsx");
+        const plugins = isTsx ? ["typescript", "jsx", ...COMMON_PLUGINS] : ["typescript", ...COMMON_PLUGINS];
+        const r = parseAndExtract(source, { plugins, extractTsTypes: true });
+        if (!r)
+          return null;
+        const relPath = canonicalRelPath(absolutePath, repoRoot);
+        const total_lines = countSourceLines(source);
+        return {
+          path: relPath,
+          total_lines,
+          imports: r.imports,
+          constants: r.constants,
+          classes: r.classes,
+          functions: r.functions,
+          interfaces: r.interfaces,
+          types: r.types,
+          enums: r.enums
+        };
+      }
+    };
+    tsScanner = new TypeScriptScanner();
+  }
+});
+
+// src/code-map/scanners/vue.ts
+var vue_exports = {};
+__export(vue_exports, {
+  vueScanner: () => vueScanner
+});
+import { readFileSync as readFileSync12 } from "fs";
+import { parse as parse2 } from "@vue/compiler-sfc";
+var VueScanner, vueScanner;
+var init_vue = __esm({
+  "src/code-map/scanners/vue.ts"() {
+    "use strict";
+    init_common();
+    init_javascript();
+    VueScanner = class {
+      extensions = [".vue"];
+      async scan(absolutePath, repoRoot) {
+        let source;
         try {
-          const result = spawnSync2(
-            interpreter,
-            [scriptPath, "--batch-file", listFile, "--repo-root", repoRoot],
-            {
-              encoding: "utf8",
-              timeout: TIMEOUT_MS,
-              maxBuffer: 50 * 1024 * 1024
-              // 50MB
-            }
-          );
-          stdout = result.stdout ?? "";
-          stderr = result.stderr ?? "";
-          exitCode = result.status ?? -1;
-          if (result.error) {
-            const errMsg = result.error.message ?? String(result.error);
-            if (errMsg.includes("ENOENT")) {
-              warnings.push({
-                path: "",
-                message: `python interpreter not found (ENOENT); skipping ${absolutePaths.length} .py file(s)`
-              });
-              return { entries, warnings };
-            }
-            if (errMsg.includes("ETIMEDOUT") || errMsg.includes("timeout")) {
-              warnings.push({
-                path: "",
-                message: `python scanner timed out after ${TIMEOUT_MS}ms; skipping .py files`
-              });
-              return { entries, warnings };
-            }
-            warnings.push({
-              path: "",
-              message: `python scanner error: ${errMsg}; skipping .py files`
-            });
-            return { entries, warnings };
-          }
-        } finally {
-          try {
-            unlinkSync(listFile);
-          } catch {
-          }
+          source = readFileSync12(absolutePath, "utf8");
+        } catch (err) {
+          throw err;
         }
-        if (exitCode === 3) {
-          warnings.push({
-            path: "",
-            message: "python interpreter is < 3.9 (need ast.unparse); skipping .py files"
-          });
-          return { entries, warnings };
+        if (isBinary(source)) {
+          return null;
         }
-        for (const line of stdout.split("\n")) {
-          const trimmed = line.trim();
-          if (!trimmed)
+        const relPath = canonicalRelPath(absolutePath, repoRoot);
+        const total_lines = source.split(/\r?\n/).length - (source.endsWith("\n") || source.endsWith("\r\n") ? 1 : 0);
+        const { descriptor } = parse2(source, { filename: absolutePath });
+        const allImports = [];
+        const allConstants = [];
+        const allFunctions = [];
+        const allClasses = [];
+        const warnings = [];
+        const scriptBlocks = [descriptor.script, descriptor.scriptSetup].filter(Boolean);
+        if (scriptBlocks.length === 0) {
+          return {
+            path: relPath,
+            total_lines,
+            imports: [],
+            constants: [],
+            classes: [],
+            functions: []
+          };
+        }
+        for (const block of scriptBlocks) {
+          if (!block)
             continue;
-          let parsed;
-          try {
-            parsed = JSON.parse(trimmed);
-          } catch {
+          if (block.lang === "ts" || block.lang === "tsx") {
+            warnings.push({
+              path: relPath,
+              message: `skipping <script lang=${block.lang}> block (TypeScript not supported in v1)`
+            });
             continue;
           }
-          if (!parsed.ok) {
-            warnings.push({ path: parsed.path, message: parsed.error });
+          const blockContent = block.content;
+          const lineOffset = block.loc.start.line;
+          const scriptEntry = parseJsSource(blockContent, relPath);
+          if (!scriptEntry) {
+            warnings.push({ path: relPath, message: "parse error in script block" });
             continue;
           }
-          const r = parsed;
-          entries.push({
-            path: canonicalRelPath(join18(repoRoot, r.path), repoRoot),
-            total_lines: r.total_lines,
-            imports: r.imports ?? [],
-            constants: r.constants ?? [],
-            classes: (r.classes ?? []).map((c) => ({
-              name: c.name,
-              lines: [c.lines[0], c.lines[1]],
-              methods: (c.methods ?? []).map((m) => ({
-                name: m.name,
-                lines: [m.lines[0], m.lines[1]],
-                async: m.async
+          const offset = lineOffset - 1;
+          for (const imp of scriptEntry.imports) {
+            allImports.push({ ...imp, line: imp.line + offset });
+          }
+          for (const c of scriptEntry.constants) {
+            allConstants.push({ ...c, line: c.line + offset });
+          }
+          for (const fn of scriptEntry.functions) {
+            allFunctions.push({
+              ...fn,
+              lines: [fn.lines[0] + offset, fn.lines[1] + offset]
+            });
+          }
+          for (const cls of scriptEntry.classes) {
+            allClasses.push({
+              ...cls,
+              lines: [cls.lines[0] + offset, cls.lines[1] + offset],
+              methods: cls.methods.map((m) => ({
+                ...m,
+                lines: [m.lines[0] + offset, m.lines[1] + offset]
               }))
-            })),
-            functions: (r.functions ?? []).map((f) => ({
-              name: f.name,
-              lines: [f.lines[0], f.lines[1]],
-              decorators: f.decorators ?? [],
-              async: f.async
-            }))
-          });
-        }
-        if (exitCode === 2) {
-          warnings.push({
-            path: "",
-            message: `python scanner exited with code 2 (fatal); partial results only. stderr: ${stderr.slice(0, 200)}`
-          });
+            });
+          }
         }
-        return { entries, warnings };
+        return {
+          path: relPath,
+          total_lines,
+          imports: allImports,
+          constants: allConstants,
+          classes: allClasses,
+          functions: allFunctions
+        };
       }
     };
-    pythonScanner = new PythonScanner();
+    vueScanner = new VueScanner();
   }
 });
 
-// src/code-map/scanners/javascript.ts
-var javascript_exports = {};
-__export(javascript_exports, {
-  COMMON_PLUGINS: () => COMMON_PLUGINS,
-  countSourceLines: () => countSourceLines,
-  jsScanner: () => jsScanner,
-  parseAndExtract: () => parseAndExtract,
-  parseJsSource: () => parseJsSource,
-  parseSourceWithPlugins: () => parseSourceWithPlugins
+// src/commands/code-map.ts
+var code_map_exports = {};
+__export(code_map_exports, {
+  codeMap: () => codeMap,
+  computeSourcesDigest: () => computeSourcesDigest
 });
-import { readFileSync as readFileSync14 } from "fs";
-import { parse } from "@babel/parser";
-function parseSourceWithPlugins(source, plugins) {
-  return parse(source, {
-    sourceType: "unambiguous",
-    allowReturnOutsideFunction: true,
-    allowAwaitOutsideFunction: true,
-    errorRecovery: true,
-    plugins
+import { existsSync as existsSync11, mkdirSync as mkdirSync5, readFileSync as readFileSync13, writeFileSync as writeFileSync6 } from "fs";
+import { resolve, dirname as dirname4, relative as relative5 } from "path";
+import { createHash as createHash4 } from "crypto";
+import { createRequire } from "module";
+import { fileURLToPath as fileURLToPath2 } from "url";
+import { join as join14 } from "path";
+function computeSourcesDigest(absolutePaths, cwd) {
+  const lines = absolutePaths.slice().sort().map((p) => {
+    const rel = relative5(cwd, p).replace(/\\/g, "/");
+    let contentHash;
+    try {
+      contentHash = createHash4("sha256").update(readFileSync13(p)).digest("hex");
+    } catch {
+      contentHash = "missing";
+    }
+    return `${rel}:${contentHash}`;
   });
+  return createHash4("sha256").update(lines.join("\n")).digest("hex");
 }
-function isCallExpression(node, callee) {
-  if (!node || node.type !== "CallExpression")
-    return false;
-  const c = node.callee;
-  return c.type === "Identifier" && c.name === callee;
-}
-function extractRequireModule(node) {
-  if (!node || node.type !== "CallExpression")
-    return null;
-  const c = node.callee;
-  if (c.type !== "Identifier" || c.name !== "require")
-    return null;
-  const arg = node.arguments[0];
-  if (!arg || arg.type !== "StringLiteral")
-    return null;
-  return arg.value;
-}
-function getLineRange(node) {
-  const start = node.loc?.start.line ?? 1;
-  const end = node.loc?.end.line ?? start;
-  return [start, end];
-}
-function processImportDeclaration(node) {
-  const items = [];
-  for (const spec of node.specifiers) {
-    if (spec.type === "ImportDefaultSpecifier") {
-      items.push(`default:${spec.local.name}`);
-    } else if (spec.type === "ImportNamespaceSpecifier") {
-      items.push(`*:${spec.local.name}`);
-    } else if (spec.type === "ImportSpecifier") {
-      const imported = spec.imported;
-      items.push(imported.type === "Identifier" ? imported.name : spec.local.name);
+async function codeMap(opts) {
+  const root = resolve(process.cwd(), opts.path);
+  const start = Date.now();
+  let cfg;
+  try {
+    cfg = loadCodeMapConfig(root);
+  } catch (err) {
+    log.error(`code-map: ${err.message}`);
+    return 1;
+  }
+  const include = [...cfg.include, ...opts.include];
+  const exclude = [...cfg.exclude, ...opts.exclude];
+  const files = walkRepo(root, { include, exclude });
+  const buckets = bucketByExtension(files);
+  const result = { entries: [], warnings: [] };
+  const tasks = [];
+  if (buckets[".py"]?.length) {
+    const { pythonScanner: pythonScanner2 } = await Promise.resolve().then(() => (init_python(), python_exports));
+    if (pythonScanner2.scanBatch) {
+      tasks.push(pythonScanner2.scanBatch(buckets[".py"], root));
     }
   }
-  return {
-    module: node.source.value,
-    items,
-    line: node.loc?.start.line ?? 1
-  };
-}
-function processFunctionDeclaration(node, nameOverride) {
-  const name = nameOverride ?? node.id?.name;
-  if (!name)
-    return null;
-  return {
-    name,
-    lines: getLineRange(node),
-    decorators: [],
-    async: node.async
-  };
-}
-function processClassDeclaration(node, nameOverride) {
-  const name = nameOverride ?? node.id?.name;
-  if (!name)
-    return null;
-  const methods = [];
-  for (const member of node.body.body) {
-    if (member.type === "ClassMethod" || member.type === "ClassPrivateMethod") {
-      const m = member;
-      let methodName;
-      if (m.key.type === "Identifier") {
-        methodName = m.key.name;
-      } else if (m.key.type === "PrivateName") {
-        methodName = `#${m.key.id.name}`;
-      } else {
-        methodName = "<computed>";
-      }
-      methods.push({
-        name: methodName,
-        lines: getLineRange(m),
-        async: m.async
+  const jsFiles = [
+    ...buckets[".js"] ?? [],
+    ...buckets[".jsx"] ?? [],
+    ...buckets[".mjs"] ?? [],
+    ...buckets[".cjs"] ?? []
+  ];
+  if (jsFiles.length) {
+    const { jsScanner: jsScanner2 } = await Promise.resolve().then(() => (init_javascript(), javascript_exports));
+    tasks.push(scanInProcess(jsScanner2, jsFiles, root));
+  }
+  const tsFiles = [
+    ...buckets[".ts"] ?? [],
+    ...buckets[".tsx"] ?? []
+  ];
+  if (tsFiles.length) {
+    const { tsScanner: tsScanner2 } = await Promise.resolve().then(() => (init_typescript(), typescript_exports));
+    tasks.push(scanInProcess(tsScanner2, tsFiles, root));
+  }
+  if (buckets[".vue"]?.length) {
+    const { vueScanner: vueScanner2 } = await Promise.resolve().then(() => (init_vue(), vue_exports));
+    tasks.push(scanInProcess(vueScanner2, buckets[".vue"], root));
+  }
+  for (const r of await Promise.all(tasks)) {
+    result.entries.push(...r.entries);
+    result.warnings.push(...r.warnings);
+  }
+  result.entries.sort((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0);
+  for (const e of result.entries) {
+    if (e.total_lines > opts.maxLines) {
+      result.warnings.push({
+        path: e.path,
+        message: `file exceeds --max-lines (${e.total_lines} > ${opts.maxLines})`
       });
     }
   }
-  return {
-    name,
-    lines: getLineRange(node),
-    methods
-  };
+  const sourcesDigest = computeSourcesDigest(files, root);
+  const yamlBody = renderYaml(result.entries, {
+    generator: `cdd-kit ${_pkg.version}`,
+    sourcesDigest
+  });
+  const totalSrc = result.entries.reduce((s, e) => s + e.total_lines, 0);
+  const mapLines = yamlBody.split("\n").length;
+  const compression = totalSrc === 0 ? 0 : totalSrc / mapLines;
+  const summaryLine = `scanned ${result.entries.length} files, ${totalSrc} src lines -> ${opts.out} (${mapLines} lines, compression ${compression.toFixed(1)}x)`;
+  for (const w of result.warnings) {
+    log.warn(`${w.path}: ${w.message}`);
+  }
+  if (opts.check) {
+    const existing = existsSync11(opts.out) ? readFileSync13(opts.out, "utf8") : "";
+    const normalize = (s) => s.replace(/^# generated: [^\n]+\n/m, "# generated: <normalized>\n");
+    if (normalize(existing) !== normalize(yamlBody)) {
+      log.error(`code-map out of date: ${opts.out} would change. Run \`cdd-kit code-map\` to regenerate.`);
+      return 1;
+    }
+    log.ok(`code-map up to date: ${opts.out}`);
+    return 0;
+  }
+  mkdirSync5(dirname4(opts.out), { recursive: true });
+  writeFileSync6(opts.out, yamlBody, "utf8");
+  log.ok(`${summaryLine} (${Date.now() - start}ms)`);
+  return 0;
 }
-function processVariableDeclaration(node, imports, constants, functions) {
-  for (const decl of node.declarations) {
-    if (!decl.id || decl.id.type !== "Identifier")
-      continue;
-    const varName = decl.id.name;
-    const init2 = decl.init;
-    if (init2 && isCallExpression(init2, "require")) {
-      const mod = extractRequireModule(init2);
-      if (mod) {
-        imports.push({ module: mod, items: [`default:${varName}`], line: node.loc?.start.line ?? 1 });
-      }
-      continue;
+var _require, _pkgPath, _pkg;
+var init_code_map = __esm({
+  "src/commands/code-map.ts"() {
+    "use strict";
+    init_logger();
+    init_yaml_writer();
+    init_orchestrator();
+    init_config();
+    _require = createRequire(import.meta.url);
+    _pkgPath = join14(fileURLToPath2(import.meta.url), "..", "..", "..", "package.json");
+    _pkg = JSON.parse(readFileSync13(_pkgPath, "utf8"));
+  }
+});
+
+// src/code-map/freshness.ts
+var freshness_exports = {};
+__export(freshness_exports, {
+  checkCodeMapFreshness: () => checkCodeMapFreshness
+});
+import { existsSync as existsSync12, readFileSync as readFileSync14, statSync as statSync3 } from "fs";
+import { join as join15 } from "path";
+function checkCodeMapFreshness(cwd, mapRel = ".cdd/code-map.yml", include, exclude) {
+  const mapPath = join15(cwd, mapRel);
+  let cfg;
+  try {
+    cfg = loadCodeMapConfig(cwd);
+  } catch (err) {
+    return {
+      status: "config-error",
+      staleFiles: [],
+      staleCount: 0,
+      mapPath,
+      configError: err.message
+    };
+  }
+  const includeFinal = [...cfg.include, ...include ?? []];
+  const excludeFinal = [...cfg.exclude, ...exclude ?? []];
+  const sourceFiles = walkRepo(cwd, { include: includeFinal, exclude: excludeFinal });
+  if (!existsSync12(mapPath)) {
+    if (sourceFiles.length === 0) {
+      return { status: "missing-greenfield", staleFiles: [], staleCount: 0, mapPath };
     }
-    if (isAllCapsConst(varName) && init2 !== null && init2 !== void 0) {
-      constants.push({ name: varName, line: node.loc?.start.line ?? 1 });
-      continue;
+    return { status: "missing-with-sources", staleFiles: [], staleCount: 0, mapPath };
+  }
+  const mapMtime = statSync3(mapPath).mtimeMs;
+  const staleAll = [];
+  for (const absPath of sourceFiles) {
+    try {
+      const mtime = statSync3(absPath).mtimeMs;
+      if (mtime > mapMtime) {
+        const rel = absPath.replace(/\\/g, "/").replace(cwd.replace(/\\/g, "/") + "/", "");
+        staleAll.push(rel);
+      }
+    } catch {
     }
-    if (init2 && (init2.type === "ArrowFunctionExpression" || init2.type === "FunctionExpression")) {
-      functions.push({
-        name: varName,
-        lines: getLineRange(node),
-        decorators: [],
-        async: init2.async
-      });
-    } else if (init2 && init2.type === "CallExpression" && /^[A-Z]/.test(varName)) {
-      functions.push({
-        name: varName,
-        lines: getLineRange(node),
-        decorators: [],
-        async: false
-      });
+  }
+  if (staleAll.length === 0) {
+    return { status: "ok", staleFiles: [], staleCount: 0, mapPath };
+  }
+  const declaredDigest = readSourcesDigest(mapPath);
+  if (declaredDigest !== null) {
+    const actualDigest = computeSourcesDigest(sourceFiles, cwd);
+    if (actualDigest === declaredDigest) {
+      return { status: "ok", staleFiles: [], staleCount: 0, mapPath };
     }
   }
-}
-function processTsInterfaceDeclaration(node, exported) {
-  if (!node || node.type !== "TSInterfaceDeclaration")
-    return null;
-  if (!node.id || node.id.type !== "Identifier")
-    return null;
   return {
-    name: node.id.name,
-    lines: getLineRange(node),
-    exported
+    status: "stale",
+    staleFiles: staleAll.slice(0, 5),
+    staleCount: staleAll.length,
+    mapPath
   };
 }
-function processTsTypeAliasDeclaration(node, exported) {
-  if (!node || node.type !== "TSTypeAliasDeclaration")
-    return null;
-  if (!node.id || node.id.type !== "Identifier")
+function readSourcesDigest(mapPath) {
+  try {
+    const head = readFileSync14(mapPath, "utf8").slice(0, 2048);
+    const m = head.match(/^# sources-digest:\s*([a-f0-9]+)/m);
+    return m ? m[1] : null;
+  } catch {
     return null;
-  return {
-    name: node.id.name,
-    lines: getLineRange(node),
-    exported
-  };
+  }
+}
+var init_freshness = __esm({
+  "src/code-map/freshness.ts"() {
+    "use strict";
+    init_include_exclude();
+    init_config();
+    init_code_map();
+  }
+});
+
+// src/commands/migrate.ts
+var migrate_exports = {};
+__export(migrate_exports, {
+  migrate: () => migrate
+});
+import { join as join18 } from "path";
+import { cpSync as cpSync2, existsSync as existsSync15, mkdirSync as mkdirSync7, readdirSync as readdirSync8, readFileSync as readFileSync17, renameSync, rmSync as rmSync2, writeFileSync as writeFileSync8 } from "fs";
+import yaml3 from "js-yaml";
+function backupChangeDir(cwd, changeId, sessionStamp) {
+  const backupRoot = join18(cwd, ".cdd", "migrate-backup", sessionStamp);
+  const backupDir2 = join18(backupRoot, changeId);
+  mkdirSync7(backupRoot, { recursive: true });
+  const sourceDir = join18(cwd, "specs", "changes", changeId);
+  if (existsSync15(sourceDir)) {
+    cpSync2(sourceDir, backupDir2, { recursive: true });
+  }
+  return backupDir2;
+}
+function buildLegacyContextManifest(changeId) {
+  return [
+    "# Context Manifest",
+    "",
+    "Generated by `cdd-kit migrate` for an existing change.",
+    "Legacy manifest. Forbidden paths come from `.cdd/context-policy.json`.",
+    "",
+    "## Affected Surfaces",
+    "- legacy-unknown",
+    "",
+    "## Allowed Paths",
+    `- specs/changes/${changeId}/`,
+    "",
+    "## Required Contracts",
+    "- legacy-unknown",
+    "",
+    "## Required Tests",
+    "- legacy-unknown",
+    "",
+    "## Agent Work Packets",
+    "",
+    "## Context Expansion Requests",
+    "-",
+    "",
+    "## Approved Expansions",
+    "-",
+    ""
+  ].join("\n");
+}
+function buildContextGovernedManifest(changeId) {
+  return [
+    "# Context Manifest",
+    "",
+    "Generated by `cdd-kit migrate --enable-context-governance` for an existing change.",
+    "Review and narrow the allowed paths before assigning implementation work.",
+    "Forbidden paths come from `.cdd/context-policy.json`.",
+    "",
+    "## Affected Surfaces",
+    "- legacy-unknown",
+    "",
+    "## Allowed Paths",
+    `- specs/changes/${changeId}/`,
+    "- specs/context/project-map.md",
+    "- specs/context/contracts-index.md",
+    "",
+    "## Required Contracts",
+    "- legacy-unknown",
+    "",
+    "## Required Tests",
+    "- legacy-unknown",
+    "",
+    "## Agent Work Packets",
+    "",
+    "### change-classifier",
+    "- allowed:",
+    `  - specs/changes/${changeId}/`,
+    "  - specs/context/project-map.md",
+    "  - specs/context/contracts-index.md",
+    "",
+    "## Context Expansion Requests",
+    "",
+    "<!--",
+    "Agents must request context expansion instead of reading outside their work packet.",
+    "Use this format only for real requests:",
+    "",
+    "- request-id: CER-001",
+    "  requested_paths:",
+    "    - src/example.ts",
+    "  reason: why this file is required",
+    "  status: pending",
+    "-->",
+    "",
+    "## Approved Expansions",
+    "-",
+    ""
+  ].join("\n");
 }
-function processTsEnumDeclaration(node, exported) {
-  if (!node || node.type !== "TSEnumDeclaration")
-    return null;
-  if (!node.id || node.id.type !== "Identifier")
-    return null;
-  const members = [];
-  for (const m of node.members ?? []) {
-    if (!m || !m.id)
+function parseLegacyFrontmatter(content) {
+  const m = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  if (!m)
+    return {};
+  const out = {};
+  for (const line of m[1].split(/\r?\n/)) {
+    const colon = line.indexOf(":");
+    if (colon === -1)
       continue;
-    if (m.id.type === "Identifier")
-      members.push(m.id.name);
-    else if (m.id.type === "StringLiteral")
-      members.push(m.id.value);
+    const key = line.slice(0, colon).trim();
+    if (!key)
+      continue;
+    out[key] = line.slice(colon + 1).trim();
   }
-  return {
-    name: node.id.name,
-    lines: getLineRange(node),
-    exported,
-    members
-  };
+  return out;
 }
-function processStatement(stmt, buckets, extractTsTypes, exportedFromWrapper = false) {
-  if (stmt.type === "ExportNamedDeclaration" && stmt.declaration) {
-    processStatement(stmt.declaration, buckets, extractTsTypes, true);
-    return;
-  }
-  if (stmt.type === "ExportDefaultDeclaration") {
-    const decl = stmt.declaration;
-    if (decl.type === "FunctionDeclaration") {
-      const fe = processFunctionDeclaration(decl, decl.id?.name ?? "default");
-      if (fe)
-        buckets.functions.push(fe);
-    } else if (decl.type === "ClassDeclaration") {
-      const ce = processClassDeclaration(decl, decl.id?.name ?? "default");
-      if (ce)
-        buckets.classes.push(ce);
+function parseListField(raw) {
+  if (!raw)
+    return [];
+  const trimmed = raw.trim();
+  if (!trimmed || trimmed === "[]")
+    return [];
+  const inner = trimmed.startsWith("[") && trimmed.endsWith("]") ? trimmed.slice(1, -1) : trimmed;
+  return inner.split(",").map((item) => item.trim().replace(/^["']|["']$/g, "")).filter(Boolean);
+}
+function parseLegacyTaskList(body) {
+  const lines = body.split(/\r?\n/);
+  const rows = [];
+  let currentSection;
+  for (const raw of lines) {
+    const headerMatch = raw.match(/^##\s+\d+\.\s+(.*)\s*$/);
+    if (headerMatch) {
+      currentSection = headerMatch[1].trim();
+      continue;
     }
-    return;
+    const itemMatch = raw.match(/^\s*-\s*\[([ xX\-])\]\s+(\d+(?:\.\d+)*)\s+(.*)\s*$/);
+    if (!itemMatch)
+      continue;
+    const mark = itemMatch[1];
+    const id = itemMatch[2];
+    const title = itemMatch[3].trim();
+    let status = "pending";
+    if (mark === "x" || mark === "X")
+      status = "done";
+    else if (mark === "-")
+      status = "skipped";
+    rows.push({ id, title, status, section: currentSection });
   }
-  if (stmt.type === "ImportDeclaration") {
-    buckets.imports.push(processImportDeclaration(stmt));
+  return rows;
+}
+function migrateTasksFile(changeId, changeDir, enableContextGovernance, detectedTier, changed, warnings, pendingWrites, pendingDeletes) {
+  const newPath = join18(changeDir, "tasks.yml");
+  const legacyPath = join18(changeDir, "tasks.md");
+  if (existsSync15(newPath)) {
     return;
   }
-  if (stmt.type === "FunctionDeclaration") {
-    const fe = processFunctionDeclaration(stmt);
-    if (fe)
-      buckets.functions.push(fe);
+  if (!existsSync15(legacyPath)) {
+    warnings.push("tasks.md not found and tasks.yml missing \u2014 skipping tasks migration");
     return;
   }
-  if (stmt.type === "ClassDeclaration") {
-    const ce = processClassDeclaration(stmt);
-    if (ce)
-      buckets.classes.push(ce);
-    return;
+  const raw = readFileSync17(legacyPath, "utf8");
+  const fm = parseLegacyFrontmatter(raw);
+  const bodyMatch = raw.match(/^---\r?\n[\s\S]*?\r?\n---\r?\n?([\s\S]*)$/);
+  const body = bodyMatch ? bodyMatch[1] : raw;
+  const tasksRows = parseLegacyTaskList(body);
+  const data = {};
+  data["change-id"] = fm["change-id"] || changeId;
+  data["status"] = fm["status"] || "in-progress";
+  if (fm["tier"] && /^\d+$/.test(fm["tier"])) {
+    data["tier"] = parseInt(fm["tier"], 10);
+  } else if (detectedTier) {
+    data["tier"] = parseInt(detectedTier, 10);
+  } else {
+    data["tier"] = null;
   }
-  if (stmt.type === "VariableDeclaration") {
-    processVariableDeclaration(stmt, buckets.imports, buckets.constants, buckets.functions);
-    return;
+  if (enableContextGovernance || fm["context-governance"] === "v1") {
+    data["context-governance"] = "v1";
   }
-  if (extractTsTypes) {
-    const anyStmt = stmt;
-    if (anyStmt.type === "TSInterfaceDeclaration") {
-      const e = processTsInterfaceDeclaration(anyStmt, exportedFromWrapper);
-      if (e)
-        buckets.interfaces.push(e);
-      return;
-    }
-    if (anyStmt.type === "TSTypeAliasDeclaration") {
-      const e = processTsTypeAliasDeclaration(anyStmt, exportedFromWrapper);
-      if (e)
-        buckets.types.push(e);
-      return;
+  const archive2 = parseListField(fm["archive-tasks"]);
+  data["archive-tasks"] = archive2.length > 0 ? archive2 : ["7.1", "7.2"];
+  const deps = parseListField(fm["depends-on"]);
+  data["depends-on"] = deps;
+  data["tasks"] = tasksRows.map((r) => {
+    const out = { id: r.id, title: r.title, status: r.status };
+    if (r.section)
+      out["section"] = r.section;
+    return out;
+  });
+  const yamlOut = yaml3.dump(data, { lineWidth: -1, noRefs: true });
+  pendingWrites.push({ path: newPath, content: yamlOut });
+  pendingDeletes.push({ path: legacyPath });
+  changed.push(`tasks.md -> tasks.yml (${tasksRows.length} task(s) migrated)`);
+}
+function parseLegacyAgentLog(content) {
+  const lines = content.split(/\r?\n/);
+  const data = {};
+  let i = 0;
+  const topFieldRe = /^[ ]{0,1}-\s*([\w-]+):\s*(.*)$/;
+  while (i < lines.length) {
+    const line = lines[i];
+    const fieldMatch = line.match(topFieldRe);
+    if (!fieldMatch) {
+      i++;
+      continue;
     }
-    if (anyStmt.type === "TSEnumDeclaration") {
-      const e = processTsEnumDeclaration(anyStmt, exportedFromWrapper);
-      if (e)
-        buckets.enums.push(e);
-      return;
+    const key = fieldMatch[1];
+    const inline = fieldMatch[2].trim();
+    if (key === "files-read" || key === "artifacts") {
+      const items = [];
+      let j = i + 1;
+      while (j < lines.length) {
+        const sub = lines[j];
+        if (topFieldRe.test(sub))
+          break;
+        if (/^#/.test(sub))
+          break;
+        const itemMatch = sub.match(/^\s{2,}-\s+(.+?)\s*$/);
+        if (itemMatch) {
+          items.push(itemMatch[1].trim());
+        }
+        j++;
+      }
+      if (key === "files-read") {
+        data["files-read"] = items;
+      } else {
+        data["artifacts"] = items.map((s) => {
+          const idx = s.indexOf(":");
+          if (idx === -1) {
+            return { type: "note", pointer: s };
+          }
+          const type = s.slice(0, idx).trim();
+          const pointer = s.slice(idx + 1).trim();
+          return { type, pointer };
+        });
+      }
+      i = j;
+      continue;
     }
+    data[key] = inline;
+    i++;
   }
-  if (stmt.type === "ExpressionStatement") {
-    const expr = stmt.expression;
-    if (isCallExpression(expr, "require")) {
-      const mod = extractRequireModule(expr);
-      if (mod) {
-        buckets.imports.push({ module: mod, items: [], line: stmt.loc?.start.line ?? 1 });
+  return data;
+}
+function migrateAgentLogs(changeDir, changed, pendingWrites, pendingDeletes) {
+  const agentLogDir = join18(changeDir, "agent-log");
+  if (!existsSync15(agentLogDir))
+    return;
+  const mdLogs = readdirSync8(agentLogDir).filter((f) => f.endsWith(".md"));
+  for (const f of mdLogs) {
+    const fullPath = join18(agentLogDir, f);
+    const yamlName = f.replace(/\.md$/, ".yml");
+    const yamlFull = join18(agentLogDir, yamlName);
+    if (existsSync15(yamlFull))
+      continue;
+    const raw = readFileSync17(fullPath, "utf8");
+    const parsed = parseLegacyAgentLog(raw);
+    const yamlOut = yaml3.dump(parsed, { lineWidth: -1, noRefs: true });
+    pendingWrites.push({ path: yamlFull, content: yamlOut });
+    pendingDeletes.push({ path: fullPath });
+    changed.push(`agent-log/${f} -> agent-log/${yamlName}`);
+  }
+}
+function migrateOne(changeId, changeDir, enableContextGovernance) {
+  const changed = [];
+  const warnings = [];
+  const pending = [];
+  const deletes = [];
+  let detectedTier = null;
+  const classifPath = join18(changeDir, "change-classification.md");
+  if (existsSync15(classifPath)) {
+    const content = readFileSync17(classifPath, "utf8");
+    const hasNewTierFormat = /^## Tier\s*\n\s*-\s*\d\s*$/m.test(content);
+    const oldMatch = content.match(/\*\*Tier[:\*]+\s*(?:Tier\s*)?(\d)/i) ?? content.match(/^-?\s*Tier:\s*(?:Tier\s*)?(\d)/mi);
+    if (oldMatch)
+      detectedTier = oldMatch[1];
+    if (!hasNewTierFormat) {
+      if (detectedTier) {
+        const addition = `
+## Tier
+- ${detectedTier}
+`;
+        if (!content.includes("\n## Tier\n")) {
+          changed.push(
+            `change-classification.md: appended "## Tier\\n- ${detectedTier}" (converted from old format)`
+          );
+          pending.push({ path: classifPath, content: content + addition });
+        }
+      } else {
+        warnings.push(
+          "change-classification.md: could not detect tier (no **Tier:** N or ## Tier N found). Set `tier: <0-5>` in tasks.yml frontmatter to enable tier-based gate checks."
+        );
       }
+    } else {
+      const structured = content.match(/^## Tier\s*\n\s*-\s*(\d)\s*$/m);
+      if (structured)
+        detectedTier = structured[1];
     }
   }
-}
-function parseAndExtract(source, opts) {
-  let ast;
-  try {
-    ast = parseSourceWithPlugins(source, opts.plugins);
-  } catch {
-    return null;
-  }
-  const buckets = {
-    imports: [],
-    constants: [],
-    functions: [],
-    classes: [],
-    interfaces: [],
-    types: [],
-    enums: []
-  };
-  for (const stmt of ast.program.body) {
-    processStatement(stmt, buckets, !!opts.extractTsTypes);
+  migrateTasksFile(changeId, changeDir, enableContextGovernance, detectedTier, changed, warnings, pending, deletes);
+  migrateAgentLogs(changeDir, changed, pending, deletes);
+  const manifestPath = join18(changeDir, "context-manifest.md");
+  if (!existsSync15(manifestPath)) {
+    changed.push(enableContextGovernance ? "context-manifest.md: added context-governance v1 manifest scaffold" : "context-manifest.md: added legacy context manifest scaffold");
+    pending.push({
+      path: manifestPath,
+      content: enableContextGovernance ? buildContextGovernedManifest(changeId) : buildLegacyContextManifest(changeId)
+    });
+  } else if (enableContextGovernance) {
+    warnings.push("context-manifest.md already exists \u2014 review allowed paths before relying on context-governance: v1");
   }
-  return buckets;
-}
-function countSourceLines(source) {
-  if (source === "")
-    return 0;
-  return source.split(/\r?\n/).length - (source.endsWith("\n") || source.endsWith("\r\n") ? 1 : 0);
-}
-function parseJsSource(source, relPath) {
-  const total_lines = countSourceLines(source);
-  const r = parseAndExtract(source, { plugins: JS_PLUGINS, extractTsTypes: false });
-  if (!r)
-    return null;
-  return {
-    path: relPath,
-    total_lines,
-    imports: r.imports,
-    constants: r.constants,
-    classes: r.classes,
-    functions: r.functions
-  };
+  return { result: { changed, warnings }, pending, deletes };
 }
-var COMMON_PLUGINS, JS_PLUGINS, JavaScriptScanner, jsScanner;
-var init_javascript = __esm({
-  "src/code-map/scanners/javascript.ts"() {
-    "use strict";
-    init_common();
-    COMMON_PLUGINS = [
-      "classProperties",
-      "classPrivateProperties",
-      "classPrivateMethods",
-      "decorators-legacy",
-      "topLevelAwait",
-      "dynamicImport",
-      "optionalChaining",
-      "nullishCoalescingOperator",
-      "objectRestSpread",
-      "asyncGenerators",
-      "numericSeparator",
-      "logicalAssignment"
-    ];
-    JS_PLUGINS = ["jsx", ...COMMON_PLUGINS];
-    JavaScriptScanner = class {
-      extensions = [".js"];
-      async scan(absolutePath, repoRoot) {
-        let source;
-        try {
-          source = readFileSync14(absolutePath, "utf8");
-        } catch (err) {
-          throw err;
-        }
-        if (isBinary(source)) {
-          return null;
-        }
-        const relPath = canonicalRelPath(absolutePath, repoRoot);
-        return parseJsSource(source, relPath);
+function commitWritesAtomically(pending, deletes) {
+  const renames = [];
+  try {
+    for (const write of pending) {
+      const tmp = `${write.path}.cdd-migrate.tmp`;
+      writeFileSync8(tmp, write.content, "utf8");
+      renames.push({ tmp, final: write.path });
+    }
+  } catch (err) {
+    for (const r of renames) {
+      try {
+        rmSync2(r.tmp, { force: true });
+      } catch {
       }
-    };
-    jsScanner = new JavaScriptScanner();
+    }
+    throw err;
   }
-});
-
-// src/code-map/scanners/typescript.ts
-var typescript_exports = {};
-__export(typescript_exports, {
-  tsScanner: () => tsScanner
-});
-import { readFileSync as readFileSync15 } from "fs";
-var TypeScriptScanner, tsScanner;
-var init_typescript = __esm({
-  "src/code-map/scanners/typescript.ts"() {
-    "use strict";
-    init_common();
-    init_javascript();
-    TypeScriptScanner = class {
-      extensions = [".ts", ".tsx"];
-      async scan(absolutePath, repoRoot) {
-        let source;
-        try {
-          source = readFileSync15(absolutePath, "utf8");
-        } catch (err) {
-          throw err;
-        }
-        if (isBinary(source)) {
-          return null;
-        }
-        const isTsx = absolutePath.toLowerCase().endsWith(".tsx");
-        const plugins = isTsx ? ["typescript", "jsx", ...COMMON_PLUGINS] : ["typescript", ...COMMON_PLUGINS];
-        const r = parseAndExtract(source, { plugins, extractTsTypes: true });
-        if (!r)
-          return null;
-        const relPath = canonicalRelPath(absolutePath, repoRoot);
-        const total_lines = countSourceLines(source);
-        return {
-          path: relPath,
-          total_lines,
-          imports: r.imports,
-          constants: r.constants,
-          classes: r.classes,
-          functions: r.functions,
-          interfaces: r.interfaces,
-          types: r.types,
-          enums: r.enums
-        };
-      }
-    };
-    tsScanner = new TypeScriptScanner();
+  for (const r of renames) {
+    renameSync(r.tmp, r.final);
   }
-});
-
-// src/code-map/scanners/vue.ts
-var vue_exports = {};
-__export(vue_exports, {
-  vueScanner: () => vueScanner
-});
-import { readFileSync as readFileSync16 } from "fs";
-import { parse as parse2 } from "@vue/compiler-sfc";
-var VueScanner, vueScanner;
-var init_vue = __esm({
-  "src/code-map/scanners/vue.ts"() {
-    "use strict";
-    init_common();
-    init_javascript();
-    VueScanner = class {
-      extensions = [".vue"];
-      async scan(absolutePath, repoRoot) {
-        let source;
-        try {
-          source = readFileSync16(absolutePath, "utf8");
-        } catch (err) {
-          throw err;
-        }
-        if (isBinary(source)) {
-          return null;
-        }
-        const relPath = canonicalRelPath(absolutePath, repoRoot);
-        const total_lines = source.split(/\r?\n/).length - (source.endsWith("\n") || source.endsWith("\r\n") ? 1 : 0);
-        const { descriptor } = parse2(source, { filename: absolutePath });
-        const allImports = [];
-        const allConstants = [];
-        const allFunctions = [];
-        const allClasses = [];
-        const warnings = [];
-        const scriptBlocks = [descriptor.script, descriptor.scriptSetup].filter(Boolean);
-        if (scriptBlocks.length === 0) {
-          return {
-            path: relPath,
-            total_lines,
-            imports: [],
-            constants: [],
-            classes: [],
-            functions: []
-          };
-        }
-        for (const block of scriptBlocks) {
-          if (!block)
-            continue;
-          if (block.lang === "ts" || block.lang === "tsx") {
-            warnings.push({
-              path: relPath,
-              message: `skipping <script lang=${block.lang}> block (TypeScript not supported in v1)`
-            });
-            continue;
-          }
-          const blockContent = block.content;
-          const lineOffset = block.loc.start.line;
-          const scriptEntry = parseJsSource(blockContent, relPath);
-          if (!scriptEntry) {
-            warnings.push({ path: relPath, message: "parse error in script block" });
-            continue;
-          }
-          const offset = lineOffset - 1;
-          for (const imp of scriptEntry.imports) {
-            allImports.push({ ...imp, line: imp.line + offset });
-          }
-          for (const c of scriptEntry.constants) {
-            allConstants.push({ ...c, line: c.line + offset });
-          }
-          for (const fn of scriptEntry.functions) {
-            allFunctions.push({
-              ...fn,
-              lines: [fn.lines[0] + offset, fn.lines[1] + offset]
-            });
-          }
-          for (const cls of scriptEntry.classes) {
-            allClasses.push({
-              ...cls,
-              lines: [cls.lines[0] + offset, cls.lines[1] + offset],
-              methods: cls.methods.map((m) => ({
-                ...m,
-                lines: [m.lines[0] + offset, m.lines[1] + offset]
-              }))
-            });
-          }
+  for (const d of deletes) {
+    try {
+      rmSync2(d.path, { force: true });
+    } catch {
+    }
+  }
+}
+async function migrate(changeId, opts = {}) {
+  const cwd = process.cwd();
+  const dryRun = opts.dryRun ?? false;
+  const enableContextGovernance = opts.enableContextGovernance ?? false;
+  const noBackup = opts.noBackup ?? false;
+  const idsToMigrate = [];
+  if (opts.all) {
+    const changesDir = join18(cwd, "specs", "changes");
+    if (!existsSync15(changesDir)) {
+      log.info("No specs/changes/ directory found \u2014 nothing to migrate.");
+      return;
+    }
+    idsToMigrate.push(
+      ...readdirSync8(changesDir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name)
+    );
+  } else if (changeId) {
+    const specificDir = join18(cwd, "specs", "changes", changeId);
+    if (!existsSync15(specificDir)) {
+      log.error(`Change not found: specs/changes/${changeId}`);
+      process.exit(1);
+    }
+    idsToMigrate.push(changeId);
+  } else {
+    log.error("Usage: cdd-kit migrate <change-id>  |  cdd-kit migrate --all  [--dry-run] [--no-backup]");
+    process.exit(1);
+  }
+  if (idsToMigrate.length === 0) {
+    log.info("No changes found to migrate.");
+    return;
+  }
+  if (dryRun) {
+    log.info("Dry run \u2014 no files will be written.");
+    log.blank();
+  }
+  const sessionStamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+  let migratedCount = 0;
+  let upToDateCount = 0;
+  const backupRoot = join18(cwd, ".cdd", "migrate-backup", sessionStamp);
+  for (const id of idsToMigrate) {
+    const changeDir = join18(cwd, "specs", "changes", id);
+    if (!existsSync15(changeDir)) {
+      log.warn(`  ${id}: directory not found \u2014 skipping`);
+      continue;
+    }
+    const { result, pending, deletes } = migrateOne(id, changeDir, enableContextGovernance);
+    const { changed, warnings } = result;
+    if (changed.length === 0) {
+      log.info(`  ${id}: already up to date`);
+      upToDateCount++;
+      for (const w of warnings)
+        log.warn(`  ${id}: ${w}`);
+      continue;
+    }
+    if (!dryRun) {
+      try {
+        if (!noBackup)
+          backupChangeDir(cwd, id, sessionStamp);
+        commitWritesAtomically(pending, deletes);
+      } catch (err) {
+        log.error(`  ${id}: migration failed \u2014 ${err.message}`);
+        if (!noBackup) {
+          log.error(`  ${id}: restore from .cdd/migrate-backup/${sessionStamp}/${id}/`);
         }
-        return {
-          path: relPath,
-          total_lines,
-          imports: allImports,
-          constants: allConstants,
-          classes: allClasses,
-          functions: allFunctions
-        };
+        process.exit(1);
       }
-    };
-    vueScanner = new VueScanner();
+    }
+    log.ok(`  ${id}: migrated`);
+    for (const c of changed)
+      log.info(`    + ${c}`);
+    migratedCount++;
+    for (const w of warnings)
+      log.warn(`  ${id}: ${w}`);
+  }
+  log.blank();
+  if (dryRun) {
+    log.info(`Dry run complete: ${migratedCount} change(s) would be updated, ${upToDateCount} already up to date.`);
+  } else {
+    log.ok(`Migration complete: ${migratedCount} updated, ${upToDateCount} already up to date.`);
+    if (migratedCount > 0 && !noBackup) {
+      log.info(`Backup: ${backupRoot}`);
+      if (ensureGitignoreEntry(cwd, ".cdd/migrate-backup/")) {
+        log.info("Added `.cdd/migrate-backup/` to .gitignore");
+      }
+      log.info('Next: git add specs/changes/ && git commit -m "chore: migrate changes to YAML format"');
+      log.info("When stable, remove backup: rm -rf .cdd/migrate-backup/");
+    }
+  }
+}
+function ensureGitignoreEntry(cwd, entry) {
+  const path = join18(cwd, ".gitignore");
+  const trimmed = entry.trim();
+  if (!trimmed)
+    return false;
+  const re = new RegExp(`^\\s*${trimmed.replace(/[.*+?^${}()|[\\]\\\\]/g, "\\$&")}\\s*$`, "m");
+  let existing = "";
+  if (existsSync15(path))
+    existing = readFileSync17(path, "utf8");
+  if (re.test(existing))
+    return false;
+  const sep = existing.length > 0 && !existing.endsWith("\n") ? "\n" : "";
+  const block = existing.length === 0 ? `# cdd-kit generated backups (do not commit)
+${trimmed}
+` : `${sep}
+# cdd-kit generated backups (do not commit)
+${trimmed}
+`;
+  writeFileSync8(path, existing + block, "utf8");
+  return true;
+}
+var init_migrate = __esm({
+  "src/commands/migrate.ts"() {
+    "use strict";
+    init_logger();
   }
 });
 
-// src/commands/code-map.ts
-var code_map_exports = {};
-__export(code_map_exports, {
-  codeMap: () => codeMap
+// src/commands/upgrade.ts
+var upgrade_exports = {};
+__export(upgrade_exports, {
+  upgrade: () => upgrade
 });
-import { existsSync as existsSync16, mkdirSync as mkdirSync8, readFileSync as readFileSync17, writeFileSync as writeFileSync9 } from "fs";
-import { resolve, dirname as dirname5 } from "path";
-import { createRequire } from "module";
-import { fileURLToPath as fileURLToPath2 } from "url";
-import { join as join19 } from "path";
-async function codeMap(opts) {
-  const root = resolve(process.cwd(), opts.path);
-  const start = Date.now();
-  let cfg;
-  try {
-    cfg = loadCodeMapConfig(root);
-  } catch (err) {
-    log.error(`code-map: ${err.message}`);
-    return 1;
-  }
-  const include = [...cfg.include, ...opts.include];
-  const exclude = [...cfg.exclude, ...opts.exclude];
-  const files = walkRepo(root, { include, exclude });
-  const buckets = bucketByExtension(files);
-  const result = { entries: [], warnings: [] };
-  const tasks = [];
-  if (buckets[".py"]?.length) {
-    const { pythonScanner: pythonScanner2 } = await Promise.resolve().then(() => (init_python(), python_exports));
-    if (pythonScanner2.scanBatch) {
-      tasks.push(pythonScanner2.scanBatch(buckets[".py"], root));
+import { existsSync as existsSync16, mkdirSync as mkdirSync8, readdirSync as readdirSync9, copyFileSync as copyFileSync3, readFileSync as readFileSync18, writeFileSync as writeFileSync9 } from "fs";
+import { dirname as dirname5, join as join19, relative as relative6 } from "path";
+function planMissingFiles(srcDir, destDir, label, planned) {
+  if (!existsSync16(srcDir))
+    return;
+  for (const entry of readdirSync9(srcDir, { withFileTypes: true })) {
+    const src = join19(srcDir, entry.name);
+    const dest = join19(destDir, entry.name);
+    if (entry.isDirectory()) {
+      planMissingFiles(src, dest, join19(label, entry.name), planned);
+      continue;
+    }
+    if (!existsSync16(dest)) {
+      planned.push({ src, dest, rel: join19(label, relative6(srcDir, src)) });
     }
   }
-  const jsFiles = [
-    ...buckets[".js"] ?? [],
-    ...buckets[".jsx"] ?? [],
-    ...buckets[".mjs"] ?? [],
-    ...buckets[".cjs"] ?? []
-  ];
-  if (jsFiles.length) {
-    const { jsScanner: jsScanner2 } = await Promise.resolve().then(() => (init_javascript(), javascript_exports));
-    tasks.push(scanInProcess(jsScanner2, jsFiles, root));
+}
+function planProviderGuidance(cwd, provider, planned) {
+  if (provider === "claude" || provider === "both") {
+    if (!existsSync16(join19(cwd, "CLAUDE.md"))) {
+      planned.push({ src: ASSET.claudeTemplate, dest: join19(cwd, "CLAUDE.md"), rel: "CLAUDE.md" });
+    }
+    if (!existsSync16(join19(cwd, "AGENTS.md"))) {
+      planned.push({ src: ASSET.agentsTemplate, dest: join19(cwd, "AGENTS.md"), rel: "AGENTS.md" });
+    }
   }
-  const tsFiles = [
-    ...buckets[".ts"] ?? [],
-    ...buckets[".tsx"] ?? []
-  ];
-  if (tsFiles.length) {
-    const { tsScanner: tsScanner2 } = await Promise.resolve().then(() => (init_typescript(), typescript_exports));
-    tasks.push(scanInProcess(tsScanner2, tsFiles, root));
+  if ((provider === "codex" || provider === "both") && !existsSync16(join19(cwd, "CODEX.md"))) {
+    planned.push({ src: ASSET.codexTemplate, dest: join19(cwd, "CODEX.md"), rel: "CODEX.md" });
   }
-  if (buckets[".vue"]?.length) {
-    const { vueScanner: vueScanner2 } = await Promise.resolve().then(() => (init_vue(), vue_exports));
-    tasks.push(scanInProcess(vueScanner2, buckets[".vue"], root));
+}
+function applyCopy(plan) {
+  for (const item of plan) {
+    mkdirSync8(dirname5(item.dest), { recursive: true });
+    copyFileSync3(item.src, item.dest);
   }
-  for (const r of await Promise.all(tasks)) {
-    result.entries.push(...r.entries);
-    result.warnings.push(...r.warnings);
+}
+async function upgrade(opts = {}) {
+  const cwd = process.cwd();
+  const requestedProvider = opts.provider ?? "auto";
+  if (!validateProviderOption(requestedProvider)) {
+    log.error(`Invalid provider: ${requestedProvider}. Use auto, claude, codex, or both.`);
+    process.exit(1);
   }
-  result.entries.sort((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0);
-  for (const e of result.entries) {
-    if (e.total_lines > opts.maxLines) {
-      result.warnings.push({
-        path: e.path,
-        message: `file exceeds --max-lines (${e.total_lines} > ${opts.maxLines})`
+  const provider = inferProvider(cwd, requestedProvider);
+  const plan = [];
+  planMissingFiles(ASSET.contracts, join19(cwd, "contracts"), "contracts", plan);
+  planMissingFiles(ASSET.specsTemplates, join19(cwd, "specs", "templates"), "specs/templates", plan);
+  planMissingFiles(ASSET.testsTemplates, join19(cwd, "tests", "templates"), "tests/templates", plan);
+  planMissingFiles(ASSET.ci, join19(cwd, "ci"), "ci", plan);
+  planMissingFiles(ASSET.githubWorkflows, join19(cwd, ".github", "workflows"), ".github/workflows", plan);
+  planMissingFiles(ASSET.cddConfig, join19(cwd, ".cdd"), ".cdd", plan);
+  planProviderGuidance(cwd, provider, plan);
+  log.blank();
+  log.info(`Upgrade provider: ${provider}`);
+  if (plan.length === 0) {
+    log.ok("No missing cdd-kit project files found.");
+    if (opts.migrateChanges) {
+      log.blank();
+      log.info("Running change migration flow...");
+      await migrate(void 0, {
+        all: true,
+        dryRun: !opts.yes,
+        enableContextGovernance: opts.enableContextGovernance
       });
     }
+    log.blank();
+    return;
   }
-  const yamlBody = renderYaml(result.entries, { generator: `cdd-kit ${_pkg.version}` });
-  const totalSrc = result.entries.reduce((s, e) => s + e.total_lines, 0);
-  const mapLines = yamlBody.split("\n").length;
-  const compression = totalSrc === 0 ? 0 : totalSrc / mapLines;
-  const summaryLine = `scanned ${result.entries.length} files, ${totalSrc} src lines -> ${opts.out} (${mapLines} lines, compression ${compression.toFixed(1)}x)`;
-  for (const w of result.warnings) {
-    log.warn(`${w.path}: ${w.message}`);
+  log.info(`${plan.length} missing file(s) detected:`);
+  for (const item of plan)
+    log.dim(`  + ${item.rel.replace(/\\/g, "/")}`);
+  if (!opts.yes) {
+    log.blank();
+    log.info("Dry run only. Re-run with --yes to write missing files.");
+    if (opts.migrateChanges) {
+      log.blank();
+      log.info("Previewing existing change migration because --migrate-changes was requested.");
+      await migrate(void 0, {
+        all: true,
+        dryRun: true,
+        enableContextGovernance: opts.enableContextGovernance
+      });
+    }
+    log.blank();
+    return;
   }
-  if (opts.check) {
-    const existing = existsSync16(opts.out) ? readFileSync17(opts.out, "utf8") : "";
-    const normalize = (s) => s.replace(/^# generated: [^\n]+\n/m, "# generated: <normalized>\n");
-    if (normalize(existing) !== normalize(yamlBody)) {
-      log.error(`code-map out of date: ${opts.out} would change. Run \`cdd-kit code-map\` to regenerate.`);
-      return 1;
+  applyCopy(plan);
+  const modelPolicyPath = join19(cwd, ".cdd", "model-policy.json");
+  if (existsSync16(modelPolicyPath)) {
+    let existing = {};
+    try {
+      existing = JSON.parse(readFileSync18(modelPolicyPath, "utf8"));
+    } catch {
     }
-    log.ok(`code-map up to date: ${opts.out}`);
-    return 0;
+    const merged = {
+      ...existing,
+      provider,
+      generated_at: (/* @__PURE__ */ new Date()).toISOString(),
+      roles: existing.roles && typeof existing.roles === "object" ? existing.roles : {}
+    };
+    writeFileSync9(modelPolicyPath, JSON.stringify(merged, null, 2) + "\n", "utf8");
   }
-  mkdirSync8(dirname5(opts.out), { recursive: true });
-  writeFileSync9(opts.out, yamlBody, "utf8");
-  log.ok(`${summaryLine} (${Date.now() - start}ms)`);
-  return 0;
+  log.blank();
+  log.ok(`Upgrade complete: ${plan.length} missing file(s) added.`);
+  log.info("Existing project guidance and contracts were preserved.");
+  if (opts.migrateChanges) {
+    log.blank();
+    log.info("Running change migration flow...");
+    await migrate(void 0, {
+      all: true,
+      dryRun: false,
+      enableContextGovernance: opts.enableContextGovernance
+    });
+  }
+  log.blank();
 }
-var _require, _pkgPath, _pkg;
-var init_code_map = __esm({
-  "src/commands/code-map.ts"() {
+var init_upgrade = __esm({
+  "src/commands/upgrade.ts"() {
     "use strict";
+    init_paths();
     init_logger();
-    init_yaml_writer();
-    init_orchestrator();
-    init_config();
-    _require = createRequire(import.meta.url);
-    _pkgPath = join19(fileURLToPath2(import.meta.url), "..", "..", "..", "package.json");
-    _pkg = JSON.parse(readFileSync17(_pkgPath, "utf8"));
+    init_provider();
+    init_migrate();
   }
 });
 
@@ -9130,11 +9243,11 @@ var refresh_exports = {};
 __export(refresh_exports, {
   refresh: () => refresh
 });
-import { existsSync as existsSync17, mkdirSync as mkdirSync9, readdirSync as readdirSync10, copyFileSync as copyFileSync4, readFileSync as readFileSync18, writeFileSync as writeFileSync10 } from "fs";
-import { dirname as dirname6, join as join20, relative as relative5 } from "path";
-import { createHash as createHash4 } from "crypto";
+import { existsSync as existsSync17, mkdirSync as mkdirSync9, readdirSync as readdirSync10, copyFileSync as copyFileSync4, readFileSync as readFileSync19, writeFileSync as writeFileSync10 } from "fs";
+import { dirname as dirname6, join as join20, relative as relative7 } from "path";
+import { createHash as createHash5 } from "crypto";
 function fileHash2(filePath) {
-  return createHash4("sha256").update(readFileSync18(filePath)).digest("hex");
+  return createHash5("sha256").update(readFileSync19(filePath)).digest("hex");
 }
 function planForceRefresh(srcDir, destDir, sectionLabel) {
   const plan = [];
@@ -9156,7 +9269,7 @@ function planForceRefresh(srcDir, destDir, sectionLabel) {
       }
       if (!item.isFile())
         continue;
-      const rel = join20(sectionLabel, relative5(srcDir, sp)).replace(/\\/g, "/");
+      const rel = join20(sectionLabel, relative7(srcDir, sp)).replace(/\\/g, "/");
       if (!existsSync17(dp)) {
         plan.push({ src: sp, dest: dp, rel, action: "add" });
       } else if (fileHash2(sp) !== fileHash2(dp)) {
@@ -9178,6 +9291,27 @@ function planSingleFile(src, dest, rel) {
     return { src, dest, rel, action: "overwrite" };
   return { src, dest, rel, action: "skip" };
 }
+function ensureGitignoreEntry2(cwd, entry) {
+  const path = join20(cwd, ".gitignore");
+  const trimmed = entry.trim();
+  if (!trimmed)
+    return false;
+  const re = new RegExp(`^\\s*${trimmed.replace(/[.*+?^${}()|[\\]\\\\]/g, "\\$&")}\\s*$`, "m");
+  let existing = "";
+  if (existsSync17(path))
+    existing = readFileSync19(path, "utf8");
+  if (re.test(existing))
+    return false;
+  const sep = existing.length > 0 && !existing.endsWith("\n") ? "\n" : "";
+  const block = existing.length === 0 ? `# cdd-kit generated backups (do not commit)
+${trimmed}
+` : `${sep}
+# cdd-kit generated backups (do not commit)
+${trimmed}
+`;
+  writeFileSync10(path, existing + block, "utf8");
+  return true;
+}
 function applyPlan(plan, backupRoot) {
   let added = 0;
   let overwritten = 0;
@@ -9221,7 +9355,7 @@ function resyncModelPolicy(cwd) {
   const desired = {};
   const agentFiles = readdirSync10(AGENTS_HOME, { withFileTypes: true }).filter((d) => d.isFile() && d.name.endsWith(".md"));
   for (const f of agentFiles) {
-    const content = readFileSync18(join20(AGENTS_HOME, f.name), "utf8");
+    const content = readFileSync19(join20(AGENTS_HOME, f.name), "utf8");
     const fm = parseAgentFrontmatter(content);
     if (fm.name && fm.model)
       desired[fm.name] = fm.model;
@@ -9231,7 +9365,7 @@ function resyncModelPolicy(cwd) {
   let existing = {};
   if (existsSync17(policyPath)) {
     try {
-      existing = JSON.parse(readFileSync18(policyPath, "utf8"));
+      existing = JSON.parse(readFileSync19(policyPath, "utf8"));
     } catch {
     }
   }
@@ -9335,7 +9469,10 @@ async function refresh(opts) {
         templateOverwritten = result.overwritten;
         log.ok(`  applied: +${templateAdded} added, ~${templateOverwritten} overwritten`);
         if (templateOverwritten > 0) {
-          log.info(`  backup saved to: ${relative5(cwd, backupRoot).replace(/\\/g, "/")}`);
+          log.info(`  backup saved to: ${relative7(cwd, backupRoot).replace(/\\/g, "/")}`);
+          if (ensureGitignoreEntry2(cwd, ".cdd/.refresh-backup/")) {
+            log.info("  added `.cdd/.refresh-backup/` to .gitignore");
+          }
         }
       } else {
         log.dim("  (dry-run \u2014 no changes written)");
@@ -9408,7 +9545,7 @@ async function refresh(opts) {
   if (apply) {
     log.ok("refresh complete.");
     if (backupRoot) {
-      log.info(`Backup of overwritten templates: ${relative5(cwd, backupRoot).replace(/\\/g, "/")}`);
+      log.info(`Backup of overwritten templates: ${relative7(cwd, backupRoot).replace(/\\/g, "/")}`);
     }
     log.info("Next: review changes with `git diff`, then commit:");
     log.dim("  git add .cdd/code-map.yml .cdd/model-policy.json specs/templates tests/templates ci-templates .github/workflows");
@@ -9437,9 +9574,9 @@ var doctor_exports = {};
 __export(doctor_exports, {
   doctor: () => doctor
 });
-import { existsSync as existsSync18, readdirSync as readdirSync11, readFileSync as readFileSync19 } from "fs";
-import { createHash as createHash5 } from "crypto";
-import { join as join21 } from "path";
+import { existsSync as existsSync18, readdirSync as readdirSync11, readFileSync as readFileSync20 } from "fs";
+import { createHash as createHash6 } from "crypto";
+import { join as join21, relative as relative8 } from "path";
 function fileExists(cwd, relPath) {
   return existsSync18(join21(cwd, relPath));
 }
@@ -9457,19 +9594,22 @@ function findFiles(dir, predicate, found = []) {
 }
 function sha256OfFile3(path) {
   try {
-    return createHash5("sha256").update(readFileSync19(path)).digest("hex");
+    return createHash6("sha256").update(readFileSync20(path)).digest("hex");
   } catch {
     return "";
   }
 }
-function inputDigest(paths) {
-  const combined = paths.slice().sort().map((p) => `${p}:${sha256OfFile3(p)}`).join("\n");
-  return createHash5("sha256").update(combined).digest("hex");
+function inputDigest(paths, cwd) {
+  const combined = paths.slice().sort().map((p) => {
+    const rel = relative8(cwd, p).replace(/\\/g, "/");
+    return `${rel}:${sha256OfFile3(p)}`;
+  }).join("\n");
+  return createHash6("sha256").update(combined).digest("hex");
 }
 function readContextIndexMetadata(filePath) {
   if (!existsSync18(filePath))
     return {};
-  const text = readFileSync19(filePath, "utf8");
+  const text = readFileSync20(filePath, "utf8");
   const out = {};
   const digestMatch = text.match(/^inputs-digest:\s*([a-f0-9]+)/m);
   if (digestMatch)
@@ -9497,7 +9637,7 @@ function checkContextFreshness(cwd) {
   }
   const projectMapMeta = readContextIndexMetadata(projectMap);
   const contractsIndexMeta = readContextIndexMetadata(contractsIndex);
-  const projectInputDigest = inputDigest([contextPolicy].filter(existsSync18));
+  const projectInputDigest = inputDigest([contextPolicy].filter(existsSync18), cwd);
   if (projectMapMeta.inputsDigest === void 0) {
     findings.push({
       level: "warning",
@@ -9509,7 +9649,7 @@ function checkContextFreshness(cwd) {
       message: "specs/context/project-map.md inputs changed (.cdd/context-policy.json); re-run cdd-kit context-scan"
     });
   }
-  const contractsInputDigest = inputDigest(contractFiles);
+  const contractsInputDigest = inputDigest(contractFiles, cwd);
   if (contractsIndexMeta.inputsDigest === void 0) {
     findings.push({
       level: "warning",
@@ -9534,7 +9674,7 @@ function checkContextFreshness(cwd) {
 }
 function readAgentModel(path) {
   try {
-    const text = readFileSync19(path, "utf8");
+    const text = readFileSync20(path, "utf8");
     const m = text.match(/^model:\s*(\S+)/m);
     return m ? m[1] : null;
   } catch {
@@ -9547,7 +9687,7 @@ function checkModelPolicyDrift(cwd) {
     return [];
   let policy;
   try {
-    policy = JSON.parse(readFileSync19(policyPath, "utf8"));
+    policy = JSON.parse(readFileSync20(policyPath, "utf8"));
   } catch {
     return [{ level: "warning", message: ".cdd/model-policy.json is not valid JSON" }];
   }
@@ -9648,7 +9788,7 @@ function checkCodeMap(cwd) {
     const more = probe.staleCount > 3 ? ` (+${probe.staleCount - 3} more)` : "";
     findings.push({ level: "warning", message: `code-map stale: ${top}${more}; run \`cdd-kit code-map\`` });
   }
-  const text = readFileSync19(mapPath, "utf8");
+  const text = readFileSync20(mapPath, "utf8");
   const m = text.match(/^# files: (\d+), src-lines: (\d+), map-lines: (\d+), compression: ([\d.]+)x/m);
   if (m) {
     findings.push({ level: "ok", message: `code-map: ${m[1]} files, ${m[4]}x compression` });
@@ -9728,7 +9868,7 @@ async function attemptAutoFixes(cwd, report) {
       try {
         let existing = {};
         try {
-          existing = JSON.parse(readFileSync19(policyPath, "utf8"));
+          existing = JSON.parse(readFileSync20(policyPath, "utf8"));
         } catch {
         }
         const merged = {
@@ -9829,7 +9969,7 @@ var lint_agents_exports = {};
 __export(lint_agents_exports, {
   lintAgents: () => lintAgents
 });
-import { readdirSync as readdirSync12, readFileSync as readFileSync20 } from "fs";
+import { readdirSync as readdirSync12, readFileSync as readFileSync21 } from "fs";
 import { join as join22 } from "path";
 import { load as yamlLoad2 } from "js-yaml";
 function extractRequiredArtifactsSection(content) {
@@ -9884,7 +10024,7 @@ async function lintAgents(opts) {
     const filePath = join22(agentsDir, filename);
     let content;
     try {
-      content = readFileSync20(filePath, "utf8");
+      content = readFileSync21(filePath, "utf8");
     } catch {
       violations.push({
         file: filename,
@@ -9997,7 +10137,7 @@ __export(archive_exports, {
   archive: () => archive
 });
 import { join as join23 } from "path";
-import { existsSync as existsSync19, mkdirSync as mkdirSync10, renameSync as renameSync2, readFileSync as readFileSync21, writeFileSync as writeFileSync11, appendFileSync, cpSync as cpSync3, rmSync as rmSync3 } from "fs";
+import { existsSync as existsSync19, mkdirSync as mkdirSync10, renameSync as renameSync2, readFileSync as readFileSync22, writeFileSync as writeFileSync11, appendFileSync, cpSync as cpSync3, rmSync as rmSync3 } from "fs";
 import yaml4 from "js-yaml";
 async function archive(changeId) {
   const cwd = process.cwd();
@@ -10017,7 +10157,7 @@ async function archive(changeId) {
   const tasksPath = join23(changeDir, "tasks.yml");
   if (existsSync19(tasksPath)) {
     try {
-      const raw = readFileSync21(tasksPath, "utf8");
+      const raw = readFileSync22(tasksPath, "utf8");
       const data = yaml4.load(raw);
       if (data?.status === "gate-blocked") {
         log.warn("tasks.yml has status: gate-blocked \u2014 archiving anyway (change was paused).");
@@ -10073,7 +10213,7 @@ __export(abandon_exports, {
   abandon: () => abandon
 });
 import { join as join24 } from "path";
-import { existsSync as existsSync20, readFileSync as readFileSync22, writeFileSync as writeFileSync12, appendFileSync as appendFileSync2, mkdirSync as mkdirSync11 } from "fs";
+import { existsSync as existsSync20, readFileSync as readFileSync23, writeFileSync as writeFileSync12, appendFileSync as appendFileSync2, mkdirSync as mkdirSync11 } from "fs";
 import yaml5 from "js-yaml";
 async function abandon(changeId, opts) {
   const cwd = process.cwd();
@@ -10084,7 +10224,7 @@ async function abandon(changeId, opts) {
     process.exit(1);
   }
   if (existsSync20(tasksPath)) {
-    const raw = readFileSync22(tasksPath, "utf8");
+    const raw = readFileSync23(tasksPath, "utf8");
     const data = yaml5.load(raw) ?? {};
     data["status"] = "abandoned";
     if (!data["change-id"]) {
@@ -10127,7 +10267,7 @@ __export(list_changes_exports, {
   listChanges: () => listChanges
 });
 import { join as join25 } from "path";
-import { existsSync as existsSync21, readdirSync as readdirSync13, readFileSync as readFileSync23 } from "fs";
+import { existsSync as existsSync21, readdirSync as readdirSync13, readFileSync as readFileSync24 } from "fs";
 import yaml6 from "js-yaml";
 async function listChanges() {
   const cwd = process.cwd();
@@ -10147,7 +10287,7 @@ async function listChanges() {
       let pending = 0;
       if (existsSync21(tasksPath)) {
         try {
-          const raw = readFileSync23(tasksPath, "utf8");
+          const raw = readFileSync24(tasksPath, "utf8");
           const data = yaml6.load(raw);
           if (data?.status)
             status = data.status;
@@ -10178,7 +10318,7 @@ __export(context_exports, {
   rejectContextExpansion: () => rejectContextExpansion,
   requestContextExpansion: () => requestContextExpansion
 });
-import { existsSync as existsSync22, readFileSync as readFileSync24, writeFileSync as writeFileSync13 } from "fs";
+import { existsSync as existsSync22, readFileSync as readFileSync25, writeFileSync as writeFileSync13 } from "fs";
 import { join as join26 } from "path";
 function normalizePath(path) {
   return path.replace(/\\/g, "/").replace(/^\.\//, "").trim();
@@ -10201,7 +10341,7 @@ function readManifest(changeId) {
     log.error(`context manifest not found: specs/changes/${changeId}/context-manifest.md`);
     process.exit(1);
   }
-  return readFileSync24(manifestPath, "utf8");
+  return readFileSync25(manifestPath, "utf8");
 }
 function writeManifest(changeId, content) {
   writeFileSync13(manifestPathFor(changeId), content.endsWith("\n") ? content : `${content}
@@ -10429,7 +10569,7 @@ var init_context = __esm({
 });
 
 // src/cli/index.ts
-import { readFileSync as readFileSync25 } from "fs";
+import { readFileSync as readFileSync26 } from "fs";
 import { fileURLToPath as fileURLToPath3 } from "url";
 import { dirname as dirname7, join as join27 } from "path";
 import { Command } from "commander";
@@ -10851,7 +10991,7 @@ init_update();
 
 // src/commands/new-change.ts
 init_paths();
-import { join as join9 } from "path";
+import { join as join9, relative as relative3 } from "path";
 import { createHash as createHash3 } from "crypto";
 import { existsSync as existsSync8, readFileSync as readFileSync7, readdirSync as readdirSync5, writeFileSync as writeFileSync4 } from "fs";
 import yaml from "js-yaml";
@@ -10864,8 +11004,11 @@ function sha256OfFile2(path) {
     return "";
   }
 }
-function inputsDigest2(paths) {
-  const combined = paths.slice().sort().map((p) => `${p}:${sha256OfFile2(p)}`).join("\n");
+function inputsDigest2(paths, cwd) {
+  const combined = paths.slice().sort().map((p) => {
+    const rel = relative3(cwd, p).replace(/\\/g, "/");
+    return `${rel}:${sha256OfFile2(p)}`;
+  }).join("\n");
   return createHash3("sha256").update(combined).digest("hex");
 }
 function findContractFiles2(dir, found = []) {
@@ -10893,8 +11036,8 @@ async function ensureFreshContextIndexes(cwd) {
   const policyPath = join9(cwd, ".cdd", "context-policy.json");
   const policyInputs = [policyPath].filter(existsSync8);
   const contractFiles = findContractFiles2(join9(cwd, "contracts"));
-  const wantProjectDigest = inputsDigest2(policyInputs);
-  const wantContractsDigest = inputsDigest2(contractFiles);
+  const wantProjectDigest = inputsDigest2(policyInputs, cwd);
+  const wantContractsDigest = inputsDigest2(contractFiles, cwd);
   const haveProjectDigest = readIndexDigest(projectMap);
   const haveContractsDigest = readIndexDigest(contractsIndex);
   const needsScan = !existsSync8(projectMap) || !existsSync8(contractsIndex) || haveProjectDigest !== wantProjectDigest || haveContractsDigest !== wantContractsDigest;
@@ -11080,9 +11223,9 @@ async function validate(opts) {
 var import_ajv = __toESM(require_ajv(), 1);
 var import_ajv_formats = __toESM(require_dist(), 1);
 init_logger();
-import { existsSync as existsSync12, readFileSync as readFileSync9, readdirSync as readdirSync7 } from "fs";
+import { existsSync as existsSync13, readFileSync as readFileSync15, readdirSync as readdirSync7 } from "fs";
 import { homedir as homedir3 } from "os";
-import { join as join14 } from "path";
+import { join as join16 } from "path";
 import yaml2 from "js-yaml";
 import picomatch2 from "picomatch";
 
@@ -11260,15 +11403,15 @@ function parseContextManifest(content) {
 }
 function extractRequiredArtifactTypes(cwd, agentName) {
   const candidates = [
-    join14(cwd, ".claude", "agents", `${agentName}.md`),
-    join14(homedir3(), ".claude", "agents", `${agentName}.md`)
+    join16(cwd, ".claude", "agents", `${agentName}.md`),
+    join16(homedir3(), ".claude", "agents", `${agentName}.md`)
   ];
   let content = null;
   for (const candidate of candidates) {
-    if (!existsSync12(candidate))
+    if (!existsSync13(candidate))
       continue;
     try {
-      content = readFileSync9(candidate, "utf8");
+      content = readFileSync15(candidate, "utf8");
       break;
     } catch {
     }
@@ -11305,11 +11448,11 @@ function loadContextPolicy(cwd) {
       unknownFilesRead: "warn-for-legacy-fail-for-new"
     }
   };
-  const policyPath = join14(cwd, ".cdd", "context-policy.json");
-  if (!existsSync12(policyPath))
+  const policyPath = join16(cwd, ".cdd", "context-policy.json");
+  if (!existsSync13(policyPath))
     return defaults;
   try {
-    const custom = JSON.parse(readFileSync9(policyPath, "utf8"));
+    const custom = JSON.parse(readFileSync15(policyPath, "utf8"));
     return {
       ...defaults,
       ...custom,
@@ -11323,7 +11466,7 @@ function loadContextPolicy(cwd) {
 }
 function loadYamlFile(path) {
   try {
-    const raw = readFileSync9(path, "utf8");
+    const raw = readFileSync15(path, "utf8");
     return { data: yaml2.load(raw), parseError: null };
   } catch (err) {
     return { data: null, parseError: err.message };
@@ -11354,8 +11497,8 @@ function ajvErrorsToMessages(errors, prefix, knownKeys) {
   return out;
 }
 function isContextGovernedChange(changeDir) {
-  const tasksPath = join14(changeDir, "tasks.yml");
-  if (!existsSync12(tasksPath))
+  const tasksPath = join16(changeDir, "tasks.yml");
+  if (!existsSync13(tasksPath))
     return false;
   const { data } = loadYamlFile(tasksPath);
   return data?.["context-governance"] === "v1";
@@ -11383,12 +11526,12 @@ function lintTasksFile(tasksPath, errors, warnings) {
   return data;
 }
 function resolveTier(changeDir) {
-  const classifPath = join14(changeDir, "change-classification.md");
-  const classificationPresent = existsSync12(classifPath);
-  const classificationText = classificationPresent ? readFileSync9(classifPath, "utf8") : "";
+  const classifPath = join16(changeDir, "change-classification.md");
+  const classificationPresent = existsSync13(classifPath);
+  const classificationText = classificationPresent ? readFileSync15(classifPath, "utf8") : "";
   const classificationHasLooseMarker = classificationPresent && TIER_PATTERN.test(classificationText);
-  const tasksPath = join14(changeDir, "tasks.yml");
-  if (existsSync12(tasksPath)) {
+  const tasksPath = join16(changeDir, "tasks.yml");
+  if (existsSync13(tasksPath)) {
     const { data } = loadYamlFile(tasksPath);
     const t = data?.tier;
     if (typeof t === "number" && t >= 0 && t <= 5) {
@@ -11434,7 +11577,7 @@ function enforceTierRequirements(changeDir, agentLogDir, errors, warnings) {
     return;
   }
   const tier = resolution.tier;
-  const agentLogFiles = agentLogDir && existsSync12(agentLogDir) ? readdirSync7(agentLogDir).map((f) => f.replace(/\.ya?ml$/, "")) : [];
+  const agentLogFiles = agentLogDir && existsSync13(agentLogDir) ? readdirSync7(agentLogDir).map((f) => f.replace(/\.ya?ml$/, "")) : [];
   if (tier <= 1) {
     for (const required of ["e2e-resilience-engineer", "monkey-test-engineer", "stress-soak-engineer"]) {
       if (!agentLogFiles.includes(required)) {
@@ -11450,7 +11593,7 @@ function enforceTierRequirements(changeDir, agentLogDir, errors, warnings) {
     }
   }
   if (resolution.source === "tasks-frontmatter" && resolution.classificationPresent) {
-    const text = readFileSync9(join14(changeDir, "change-classification.md"), "utf8");
+    const text = readFileSync15(join16(changeDir, "change-classification.md"), "utf8");
     const structured = text.match(/^## Tier\s*\n\s*-\s*(\d)\s*$/m);
     const bold = text.match(/\*\*Tier:\*\*\s*Tier\s*(\d)\b/i);
     const classifTier = structured ? parseInt(structured[1], 10) : bold ? parseInt(bold[1], 10) : NaN;
@@ -11462,11 +11605,11 @@ function enforceTierRequirements(changeDir, agentLogDir, errors, warnings) {
   }
 }
 function isArchivedChange(cwd, changeId) {
-  const archiveRoot = join14(cwd, "specs", "archive");
-  if (!existsSync12(archiveRoot))
+  const archiveRoot = join16(cwd, "specs", "archive");
+  if (!existsSync13(archiveRoot))
     return false;
   const years = readdirSync7(archiveRoot, { withFileTypes: true }).filter((d) => d.isDirectory());
-  return years.some((year) => existsSync12(join14(archiveRoot, year.name, changeId)));
+  return years.some((year) => existsSync13(join16(archiveRoot, year.name, changeId)));
 }
 function detectDependencyCycle(cwd, startChangeId) {
   const visited = /* @__PURE__ */ new Set();
@@ -11479,8 +11622,8 @@ function detectDependencyCycle(cwd, startChangeId) {
       return null;
     visited.add(id);
     stack.push(id);
-    const tasksPath = join14(cwd, "specs", "changes", id, "tasks.yml");
-    if (existsSync12(tasksPath)) {
+    const tasksPath = join16(cwd, "specs", "changes", id, "tasks.yml");
+    if (existsSync13(tasksPath)) {
       const { data } = loadYamlFile(tasksPath);
       const deps = data?.["depends-on"] ?? [];
       for (const dep of deps) {
@@ -11495,8 +11638,8 @@ function detectDependencyCycle(cwd, startChangeId) {
   return visit(startChangeId);
 }
 function validateDependencies(cwd, changeId, changeDir) {
-  const tasksPath = join14(changeDir, "tasks.yml");
-  if (!existsSync12(tasksPath))
+  const tasksPath = join16(changeDir, "tasks.yml");
+  if (!existsSync13(tasksPath))
     return [];
   const { data } = loadYamlFile(tasksPath);
   const dependencies = data?.["depends-on"] ?? [];
@@ -11510,10 +11653,10 @@ function validateDependencies(cwd, changeId, changeDir) {
       errors.push(`tasks.yml: change cannot depend on itself (${dep})`);
       continue;
     }
-    const upstreamDir = join14(cwd, "specs", "changes", dep);
-    if (existsSync12(upstreamDir)) {
-      const upstreamTasks = join14(upstreamDir, "tasks.yml");
-      if (!existsSync12(upstreamTasks)) {
+    const upstreamDir = join16(cwd, "specs", "changes", dep);
+    if (existsSync13(upstreamDir)) {
+      const upstreamTasks = join16(upstreamDir, "tasks.yml");
+      if (!existsSync13(upstreamTasks)) {
         errors.push(`dependency ${dep}: missing tasks.yml`);
         continue;
       }
@@ -11534,8 +11677,8 @@ async function gate(changeId, opts = {}) {
   const strict = opts.strict ?? false;
   const lax = opts.lax ?? false;
   const cwd = process.cwd();
-  const changeDir = join14(cwd, "specs", "changes", changeId);
-  if (!existsSync12(changeDir)) {
+  const changeDir = join16(cwd, "specs", "changes", changeId);
+  if (!existsSync13(changeDir)) {
     log.error(`change not found: ${changeId} (looked in ${changeDir})`);
     process.exit(1);
   }
@@ -11561,13 +11704,13 @@ async function gate(changeId, opts = {}) {
   }
   const contextPolicy = loadContextPolicy(cwd);
   const isNewChange = isContextGovernedChange(changeDir);
-  const manifestPath = join14(changeDir, "context-manifest.md");
-  const hasManifest = existsSync12(manifestPath);
+  const manifestPath = join16(changeDir, "context-manifest.md");
+  const hasManifest = existsSync13(manifestPath);
   let allowedPaths = [];
   let approvedExpansions = [];
   errors.push(...validateDependencies(cwd, changeId, changeDir));
   if (hasManifest) {
-    const manifest = parseContextManifest(readFileSync9(manifestPath, "utf8"));
+    const manifest = parseContextManifest(readFileSync15(manifestPath, "utf8"));
     allowedPaths = manifest.allowedPaths;
     approvedExpansions = manifest.approvedExpansions;
     if (manifest.pendingExpansions > 0) {
@@ -11585,7 +11728,7 @@ async function gate(changeId, opts = {}) {
       }
       continue;
     }
-    if (!existsSync12(join14(changeDir, f))) {
+    if (!existsSync13(join16(changeDir, f))) {
       errors.push(`missing required artifact: ${f}`);
     }
   }
@@ -11595,21 +11738,21 @@ async function gate(changeId, opts = {}) {
         continue;
       if (f === "tasks.yml")
         continue;
-      const content = readFileSync9(join14(changeDir, f), "utf8");
+      const content = readFileSync15(join16(changeDir, f), "utf8");
       const minChars = MIN_CHARS[f] ?? 100;
       if (meaningfulChars(content) < minChars) {
         errors.push(`${f}: appears to be a stub (< ${minChars} meaningful chars)`);
       }
     }
-    const classifPath = join14(changeDir, "change-classification.md");
+    const classifPath = join16(changeDir, "change-classification.md");
     const tierResolution = resolveTier(changeDir);
-    if (tierResolution.tier === null && existsSync12(classifPath) && !tierResolution.classificationHasLooseMarker) {
+    if (tierResolution.tier === null && existsSync13(classifPath) && !tierResolution.classificationHasLooseMarker) {
       errors.push("change-classification.md: missing tier/risk marker (set tier in tasks.yml frontmatter, or include Tier 0-5 / low|medium|high|critical in change-classification.md)");
     }
   }
-  const tasksPath = join14(changeDir, "tasks.yml");
+  const tasksPath = join16(changeDir, "tasks.yml");
   let tasksData = null;
-  if (existsSync12(tasksPath)) {
+  if (existsSync13(tasksPath)) {
     tasksData = lintTasksFile(tasksPath, errors, warnings);
   }
   if (tasksData) {
@@ -11623,11 +11766,11 @@ async function gate(changeId, opts = {}) {
       }
     }
   }
-  const agentLogDir = join14(changeDir, "agent-log");
-  if (existsSync12(agentLogDir)) {
+  const agentLogDir = join16(changeDir, "agent-log");
+  if (existsSync13(agentLogDir)) {
     const logFiles = readdirSync7(agentLogDir).filter((f) => f.endsWith(".yml"));
     for (const f of logFiles) {
-      const fullPath = join14(agentLogDir, f);
+      const fullPath = join16(agentLogDir, f);
       const { data, parseError } = loadYamlFile(fullPath);
       if (parseError) {
         errors.push(`agent-log/${f}: invalid YAML: ${parseError}`);
@@ -11695,9 +11838,9 @@ async function gate(changeId, opts = {}) {
             errors.push(`agent-log/${f}: read unauthorized path -> ${p} (not in allowed paths or approved expansions)`);
           }
         }
-        const runtimeLog = join14(cwd, ".cdd", "runtime", `${changeId}-files-read.jsonl`);
-        if (existsSync12(runtimeLog)) {
-          const runtimePaths = readFileSync9(runtimeLog, "utf8").split("\n").filter(Boolean).map((line) => {
+        const runtimeLog = join16(cwd, ".cdd", "runtime", `${changeId}-files-read.jsonl`);
+        if (existsSync13(runtimeLog)) {
+          const runtimePaths = readFileSync15(runtimeLog, "utf8").split("\n").filter(Boolean).map((line) => {
             try {
               return JSON.parse(line).path;
             } catch {
@@ -11733,8 +11876,8 @@ async function gate(changeId, opts = {}) {
             continue;
           const pathPart = pointer.split(":")[0];
           if (pathPart.includes("/") && !pointer.startsWith("http")) {
-            const abs = join14(cwd, pathPart);
-            if (!existsSync12(abs)) {
+            const abs = join16(cwd, pathPart);
+            if (!existsSync13(abs)) {
               errors.push(`agent-log/${f}: artifact pointer not found: ${pathPart}`);
             }
           }
@@ -11783,26 +11926,26 @@ async function gate(changeId, opts = {}) {
 // src/commands/install-hooks.ts
 init_paths();
 init_logger();
-import { existsSync as existsSync13, readFileSync as readFileSync10, writeFileSync as writeFileSync5, chmodSync as chmodSync2, mkdirSync as mkdirSync5 } from "fs";
-import { join as join15 } from "path";
+import { existsSync as existsSync14, readFileSync as readFileSync16, writeFileSync as writeFileSync7, chmodSync as chmodSync2, mkdirSync as mkdirSync6 } from "fs";
+import { join as join17 } from "path";
 var START_MARKER2 = "# cdd-kit-managed-block-start";
 var END_MARKER2 = "# cdd-kit-managed-block-end";
 async function installHooks() {
   const cwd = process.cwd();
-  const gitDir = join15(cwd, ".git");
-  if (!existsSync13(gitDir)) {
+  const gitDir = join17(cwd, ".git");
+  if (!existsSync14(gitDir)) {
     log.error("not a git repository (no .git/ found in cwd)");
     process.exit(1);
   }
-  const hooksDir = join15(gitDir, "hooks");
-  mkdirSync5(hooksDir, { recursive: true });
-  const dest = join15(hooksDir, "pre-commit");
-  const ourHook = readFileSync10(join15(ASSET.hooks, "pre-commit"), "utf8");
+  const hooksDir = join17(gitDir, "hooks");
+  mkdirSync6(hooksDir, { recursive: true });
+  const dest = join17(hooksDir, "pre-commit");
+  const ourHook = readFileSync16(join17(ASSET.hooks, "pre-commit"), "utf8");
   let final;
-  if (!existsSync13(dest)) {
+  if (!existsSync14(dest)) {
     final = ourHook;
   } else {
-    const existing = readFileSync10(dest, "utf8");
+    const existing = readFileSync16(dest, "utf8");
     const startIdx = existing.indexOf(START_MARKER2);
     const endIdx = existing.indexOf(END_MARKER2);
     if (startIdx >= 0 && endIdx > startIdx) {
@@ -11826,7 +11969,7 @@ async function installHooks() {
       }
     }
   }
-  writeFileSync5(dest, final, "utf8");
+  writeFileSync7(dest, final, "utf8");
   try {
     chmodSync2(dest, 493);
   } catch {
@@ -11837,7 +11980,7 @@ async function installHooks() {
 
 // src/cli/index.ts
 var __dirname2 = dirname7(fileURLToPath3(import.meta.url));
-var pkg = JSON.parse(readFileSync25(join27(__dirname2, "..", "..", "package.json"), "utf8"));
+var pkg = JSON.parse(readFileSync26(join27(__dirname2, "..", "..", "package.json"), "utf8"));
 var program = new Command();
 program.name("cdd-kit").description("Contract-Driven Delivery Kit CLI").version(pkg.version);
 program.command("init").description(