@gluecharm-lab/easyspecs-cli 0.2.1 → 0.3.0

package/dist/main.cjs

@@ -959,7 +959,7 @@ var require_command = __commonJS({
   "node_modules/commander/lib/command.js"(exports2) {
     var EventEmitter = require("node:events").EventEmitter;
     var childProcess = require("node:child_process");
-    var path61 = require("node:path");
+    var path62 = require("node:path");
     var fs64 = require("node:fs");
     var process2 = require("node:process");
     var { Argument: Argument2, humanReadableArgName } = require_argument();
@@ -1892,9 +1892,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
         let launchWithNode = false;
         const sourceExt = [".js", ".ts", ".tsx", ".mjs", ".cjs"];
         function findFile(baseDir, baseName) {
-          const localBin = path61.resolve(baseDir, baseName);
+          const localBin = path62.resolve(baseDir, baseName);
           if (fs64.existsSync(localBin)) return localBin;
-          if (sourceExt.includes(path61.extname(baseName))) return void 0;
+          if (sourceExt.includes(path62.extname(baseName))) return void 0;
           const foundExt = sourceExt.find(
             (ext) => fs64.existsSync(`${localBin}${ext}`)
           );
@@ -1912,17 +1912,17 @@ Expecting one of '${allowedValues.join("', '")}'`);
           } catch (err) {
             resolvedScriptPath = this._scriptPath;
           }
-          executableDir = path61.resolve(
-            path61.dirname(resolvedScriptPath),
+          executableDir = path62.resolve(
+            path62.dirname(resolvedScriptPath),
             executableDir
           );
         }
         if (executableDir) {
           let localFile = findFile(executableDir, executableFile);
           if (!localFile && !subcommand._executableFile && this._scriptPath) {
-            const legacyName = path61.basename(
+            const legacyName = path62.basename(
               this._scriptPath,
-              path61.extname(this._scriptPath)
+              path62.extname(this._scriptPath)
             );
             if (legacyName !== this._name) {
               localFile = findFile(
@@ -1933,7 +1933,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
           }
           executableFile = localFile || executableFile;
         }
-        launchWithNode = sourceExt.includes(path61.extname(executableFile));
+        launchWithNode = sourceExt.includes(path62.extname(executableFile));
         let proc;
         if (process2.platform !== "win32") {
           if (launchWithNode) {
@@ -2773,7 +2773,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @return {Command}
        */
       nameFromFilename(filename) {
-        this._name = path61.basename(filename, path61.extname(filename));
+        this._name = path62.basename(filename, path62.extname(filename));
         return this;
       }
       /**
@@ -2787,9 +2787,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} [path]
        * @return {(string|null|Command)}
        */
-      executableDir(path62) {
-        if (path62 === void 0) return this._executableDir;
-        this._executableDir = path62;
+      executableDir(path63) {
+        if (path63 === void 0) return this._executableDir;
+        this._executableDir = path63;
         return this;
       }
       /**
@@ -5244,8 +5244,8 @@ var require_resolve = __commonJS({
       }
       return count;
     }
-    function getFullPath(resolver, id = "", normalize8) {
-      if (normalize8 !== false)
+    function getFullPath(resolver, id = "", normalize9) {
+      if (normalize9 !== false)
         id = normalizeId(id);
       const p = resolver.parse(id);
       return _getFullPath(resolver, p);
@@ -5993,7 +5993,7 @@ var require_compile = __commonJS({
       const schOrFunc = root.refs[ref];
       if (schOrFunc)
         return schOrFunc;
-      let _sch = resolve23.call(this, root, ref);
+      let _sch = resolve24.call(this, root, ref);
       if (_sch === void 0) {
         const schema = (_a = root.localRefs) === null || _a === void 0 ? void 0 : _a[ref];
         const { schemaId } = this.opts;
@@ -6020,7 +6020,7 @@ var require_compile = __commonJS({
     function sameSchemaEnv(s1, s2) {
       return s1.schema === s2.schema && s1.root === s2.root && s1.baseId === s2.baseId;
     }
-    function resolve23(root, ref) {
+    function resolve24(root, ref) {
       let sch;
       while (typeof (sch = this.refs[ref]) == "string")
         ref = sch;
@@ -6235,8 +6235,8 @@ var require_utils = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path61) {
-      let input = path61;
+    function removeDotSegments(path62) {
+      let input = path62;
       const output = [];
       let nextSlash = -1;
       let len = 0;
@@ -6435,8 +6435,8 @@ var require_schemes = __commonJS({
         wsComponent.secure = void 0;
       }
       if (wsComponent.resourceName) {
-        const [path61, query] = wsComponent.resourceName.split("?");
-        wsComponent.path = path61 && path61 !== "/" ? path61 : void 0;
+        const [path62, query] = wsComponent.resourceName.split("?");
+        wsComponent.path = path62 && path62 !== "/" ? path62 : void 0;
         wsComponent.query = query;
         wsComponent.resourceName = void 0;
       }
@@ -6585,7 +6585,7 @@ var require_fast_uri = __commonJS({
     "use strict";
     var { normalizeIPv6, removeDotSegments, recomposeAuthority, normalizeComponentEncoding, isIPv4, nonSimpleDomain } = require_utils();
     var { SCHEMES, getSchemeHandler } = require_schemes();
-    function normalize8(uri, options) {
+    function normalize9(uri, options) {
       if (typeof uri === "string") {
         uri = /** @type {T} */
         serialize(parse(uri, options), options);
@@ -6595,7 +6595,7 @@ var require_fast_uri = __commonJS({
       }
       return uri;
     }
-    function resolve23(baseURI, relativeURI, options) {
+    function resolve24(baseURI, relativeURI, options) {
       const schemelessOptions = options ? Object.assign({ scheme: "null" }, options) : { scheme: "null" };
       const resolved = resolveComponent(parse(baseURI, schemelessOptions), parse(relativeURI, schemelessOptions), schemelessOptions, true);
       schemelessOptions.skipEscape = true;
@@ -6821,8 +6821,8 @@ var require_fast_uri = __commonJS({
     }
     var fastUri = {
       SCHEMES,
-      normalize: normalize8,
-      resolve: resolve23,
+      normalize: normalize9,
+      resolve: resolve24,
       resolveComponent,
       equal,
       serialize,
@@ -10637,7 +10637,7 @@ var require_dist = __commonJS({
 
 // src/cli/main.ts
 var fs63 = __toESM(require("node:fs"));
-var path60 = __toESM(require("node:path"));
+var path61 = __toESM(require("node:path"));
 
 // src/cli/exitCodes.ts
 var OsExit = {
@@ -10778,9 +10778,9 @@ function describeExitCode(code) {
     case OsExit.readinessOpenCodeCredentials:
       return "OpenCode credentials not ready for factory run.";
     case OsExit.readinessOpenCodeModel:
-      return "OpenCode default model is not configured \u2014 add a model in repo `opencode.json` or `easyspecs.openCodeRuntime.providers`.";
+      return "OpenCode default model is not configured \u2014 add `model` (or equivalent) in repo `opencode.json` / `opencode.jsonc`, global `~/.config/opencode/opencode.json`, `OPENCODE_CONFIG` / `OPENCODE_CONFIG_DIR`, managed config (see OpenCode docs), or `easyspecs.openCodeRuntime.providers`.";
     case OsExit.readinessOpenCodeMandatoryConfig:
-      return "Mandatory OpenCode project config is missing \u2014 create `opencode.json` at the repository / analysis root.";
+      return "Readiness gate (d) reserved \u2014 repo-root `opencode.json` is optional when OpenCode is installed, credentials are ready, and a model is configured.";
     default:
       return `Non-zero exit (${String(code)}) \u2014 see stderr and any JSON \`error\` field for detail.`;
   }
@@ -12687,7 +12687,7 @@ function stringifyForSrs13Debug(value) {
     return truncateForSrs13DebugLog(String(value));
   }
 }
-function logSrs13HttpDebug(log, path61, method, requestBody, error) {
+function logSrs13HttpDebug(log, path62, method, requestBody, error) {
   if (!log) {
     return;
   }
@@ -12697,7 +12697,7 @@ function logSrs13HttpDebug(log, path61, method, requestBody, error) {
   } catch {
     bodyBytes = 0;
   }
-  log(`[pipeline:upload] debug ${method} ${path61} \u2014 request body ~${bodyBytes} bytes (JSON below):`);
+  log(`[pipeline:upload] debug ${method} ${path62} \u2014 request body ~${bodyBytes} bytes (JSON below):`);
   log(stringifyForSrs13Debug(requestBody));
   const raw = httpApiResponseBody(error);
   const status = error && typeof error === "object" && "status" in error ? Number(error.status) : void 0;
@@ -14394,9 +14394,9 @@ function parsePsRssDarwinKilobytes(stdout) {
   return n;
 }
 function readLinuxPidRssBytes(pid) {
-  const path61 = `/proc/${pid}/status`;
+  const path62 = `/proc/${pid}/status`;
   try {
-    const content = fs18.readFileSync(path61, "utf8");
+    const content = fs18.readFileSync(path62, "utf8");
     const kb = parseVmRssKilobytesFromProcStatus(content);
     if (kb === null) {
       return { kind: "unknown", reason: "VmRSS_missing" };
@@ -14497,7 +14497,16 @@ var PROVIDER_ENV_KEYS = [
   "OPENAI_API_KEY",
   "OPENROUTER_API_KEY",
   "GOOGLE_API_KEY",
-  "OPENCODE_API_KEY"
+  "GEMINI_API_KEY",
+  "GOOGLE_GENERATIVE_AI_API_KEY",
+  "OPENCODE_API_KEY",
+  "MISTRAL_API_KEY",
+  "GROQ_API_KEY",
+  "COHERE_API_KEY",
+  "XAI_API_KEY",
+  "DEEPSEEK_API_KEY",
+  "AZURE_OPENAI_API_KEY",
+  "AWS_BEARER_TOKEN_BEDROCK"
 ];
 function hasProviderEnvConfigured() {
   for (const k of PROVIDER_ENV_KEYS) {
@@ -14584,9 +14593,9 @@ function runOpenCodeAgent(cwd, args, options) {
   log?.(`${procTag} command: ${formatCliCommandForLog(cmd, args)}`);
   log?.(`${procTag} cwd: ${JSON.stringify(cwd)}`);
   log?.(`${procTag} argv: ${JSON.stringify(args)}`);
-  return new Promise((resolve23) => {
+  return new Promise((resolve24) => {
     if (sig?.aborted) {
-      resolve23({ ok: false, message: "Stopped by user.", cancelled: true });
+      resolve24({ ok: false, message: "Stopped by user.", cancelled: true });
       return;
     }
     const spawnEnv = options?.childEnv && Object.keys(options.childEnv).length > 0 ? { ...process.env, ...options.childEnv } : process.env;
@@ -14681,7 +14690,7 @@ ${truncateForDiag(outBody, DIAG_STDOUT_MAX)}`);
       if (diag) {
         finishDiag(diag.label, diag.code, diag.dumpStreams);
       }
-      resolve23(result);
+      resolve24(result);
     };
     let onAbort;
     const clearAbortHandler = () => {
@@ -21405,8 +21414,8 @@ async function drainWorkstationPool(p) {
   const artefactRunId = readArtefactRunSnapshot(storageContext)?.runId ?? "unknown-run";
   let active = 0;
   let wake;
-  const waitTurn = () => new Promise((resolve23) => {
-    wake = resolve23;
+  const waitTurn = () => new Promise((resolve24) => {
+    wake = resolve24;
   });
   const persist = async () => {
     const items = {};
@@ -21767,30 +21776,81 @@ var FACTORY_PIPELINE_EXIT_CONDITIONS = {
 
 // src/readiness/factoryReadiness.ts
 var fs39 = __toESM(require("node:fs"));
+var path35 = __toESM(require("node:path"));
+
+// src/readiness/openCodeConfigCandidates.ts
 var os6 = __toESM(require("node:os"));
 var path34 = __toESM(require("node:path"));
-var MANDATORY_OPEN_CODE_CONFIG_REL_PATHS = ["opencode.json"];
-var READINESS_OPENCODE_NOT_INSTALLED = "READINESS_OPENCODE_NOT_INSTALLED";
-var READINESS_OPENCODE_CREDENTIALS = "READINESS_OPENCODE_CREDENTIALS";
-var READINESS_OPENCODE_MODEL = "READINESS_OPENCODE_MODEL";
-var READINESS_OPENCODE_MANDATORY_CONFIG = "READINESS_OPENCODE_MANDATORY_CONFIG";
-function userOpenCodeConfigPath() {
+function openCodeUserConfigDir() {
   if (process.platform === "win32") {
     const base = process.env.APPDATA || path34.join(os6.homedir(), "AppData", "Roaming");
-    return path34.join(base, "opencode", "config.json");
+    return path34.join(base, "opencode");
   }
   const xdg = process.env.XDG_CONFIG_HOME?.trim();
   const cfgRoot = xdg && xdg.length > 0 ? xdg : path34.join(os6.homedir(), ".config");
-  return path34.join(cfgRoot, "opencode", "config.json");
+  return path34.join(cfgRoot, "opencode");
 }
-function buildOpenCodeConfigInventory(analysisRootAbs) {
+function managedOpenCodeConfigDir() {
+  if (process.platform === "darwin") {
+    return "/Library/Application Support/opencode";
+  }
+  if (process.platform === "linux") {
+    return path34.join("/etc", "opencode");
+  }
+  if (process.platform === "win32") {
+    const pd = process.env.ProgramData?.trim() || "C:\\ProgramData";
+    return path34.join(pd, "opencode");
+  }
+  return void 0;
+}
+function pushConfigBasenames(out, dir) {
+  const d = path34.normalize(dir);
+  out.push(path34.join(d, "opencode.json"));
+  out.push(path34.join(d, "opencode.jsonc"));
+  out.push(path34.join(d, "config.json"));
+}
+function dedupeStablePaths(paths) {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const p of paths) {
+    const n = path34.normalize(p.trim());
+    if (n.length === 0 || seen.has(n)) {
+      continue;
+    }
+    seen.add(n);
+    out.push(n);
+  }
+  return out;
+}
+function openCodeJsonModelFileCandidates(analysisRootAbs) {
   const root = path34.resolve(analysisRootAbs);
-  const list = [
-    { path: path34.join(root, "opencode.json"), exists: false },
-    { path: path34.join(root, ".opencode", "config.json"), exists: false },
-    { path: userOpenCodeConfigPath(), exists: false }
-  ];
-  return list.map((e) => ({ ...e, exists: fs39.existsSync(e.path) }));
+  const acc = [];
+  const oc = process.env.OPENCODE_CONFIG?.trim();
+  if (oc) {
+    acc.push(path34.resolve(oc));
+  }
+  pushConfigBasenames(acc, root);
+  pushConfigBasenames(acc, path34.join(root, ".opencode"));
+  const ocd = process.env.OPENCODE_CONFIG_DIR?.trim();
+  if (ocd) {
+    pushConfigBasenames(acc, path34.resolve(ocd));
+  }
+  pushConfigBasenames(acc, openCodeUserConfigDir());
+  pushConfigBasenames(acc, path34.join(os6.homedir(), ".opencode"));
+  const managed = managedOpenCodeConfigDir();
+  if (managed) {
+    pushConfigBasenames(acc, managed);
+  }
+  return dedupeStablePaths(acc);
+}
+
+// src/readiness/factoryReadiness.ts
+var MANDATORY_OPEN_CODE_CONFIG_REL_PATHS = ["opencode.json"];
+var READINESS_OPENCODE_NOT_INSTALLED = "READINESS_OPENCODE_NOT_INSTALLED";
+var READINESS_OPENCODE_CREDENTIALS = "READINESS_OPENCODE_CREDENTIALS";
+var READINESS_OPENCODE_MODEL = "READINESS_OPENCODE_MODEL";
+function buildOpenCodeConfigInventory(analysisRootAbs) {
+  return openCodeJsonModelFileCandidates(analysisRootAbs).map((p) => ({ path: p, exists: fs39.existsSync(p) }));
 }
 function defaultModelFromEasyspecsConfig(cfg) {
   const providers = cfg.easyspecs?.openCodeRuntime?.providers;
@@ -21835,6 +21895,40 @@ function extractModelFromOpenCodeJson(data) {
   }
   return void 0;
 }
+function parseOpenCodeConfigText(raw) {
+  const t = raw.trim();
+  if (!t) {
+    return void 0;
+  }
+  try {
+    return JSON.parse(t);
+  } catch {
+    const noBlock = t.replace(/\/\*[\s\S]*?\*\//g, "");
+    const noLine = noBlock.replace(/^\s*\/\/[^\n\r]*/gm, "");
+    try {
+      return JSON.parse(noLine);
+    } catch {
+      return void 0;
+    }
+  }
+}
+function modelFromOpencodeConfigContentEnv() {
+  const v = process.env.OPENCODE_CONFIG_CONTENT?.trim();
+  if (!v) {
+    return void 0;
+  }
+  const data = parseOpenCodeConfigText(v);
+  return data !== void 0 ? extractModelFromOpenCodeJson(data) : void 0;
+}
+function tryModelFromConfigFile(absPath) {
+  try {
+    const txt = fs39.readFileSync(absPath, "utf-8");
+    const data = parseOpenCodeConfigText(txt);
+    return data !== void 0 ? extractModelFromOpenCodeJson(data) : void 0;
+  } catch {
+    return void 0;
+  }
+}
 function sanitizeModelSummary(raw) {
   const t = raw.trim();
   if (!t) {
@@ -21854,15 +21948,15 @@ function resolveModelFromContext(ctx) {
   if (fromCfg) {
     return { configured: true, summary: sanitizeModelSummary(fromCfg) };
   }
-  const p = path34.join(path34.resolve(ctx.analysisRootAbs), "opencode.json");
-  try {
-    const txt = fs39.readFileSync(p, "utf-8");
-    const data = JSON.parse(txt);
-    const m = extractModelFromOpenCodeJson(data);
+  const fromInline = modelFromOpencodeConfigContentEnv();
+  if (fromInline) {
+    return { configured: true, summary: sanitizeModelSummary(fromInline) };
+  }
+  for (const p of openCodeJsonModelFileCandidates(ctx.analysisRootAbs)) {
+    const m = tryModelFromConfigFile(p);
     if (m) {
       return { configured: true, summary: sanitizeModelSummary(m) };
     }
-  } catch {
   }
   return { configured: false, summary: "(not configured)" };
 }
@@ -21874,7 +21968,7 @@ function buildReadinessProbeFacts(ctx) {
   });
   const openCodeConfigFiles = buildOpenCodeConfigInventory(ctx.analysisRootAbs);
   const mandatoryOk = MANDATORY_OPEN_CODE_CONFIG_REL_PATHS.every((rel) => {
-    const abs = path34.join(path34.resolve(ctx.analysisRootAbs), rel);
+    const abs = path35.join(path35.resolve(ctx.analysisRootAbs), rel);
     return fs39.existsSync(abs);
   });
   const model = resolveModelFromContext(ctx);
@@ -21898,7 +21992,8 @@ function buildReadinessLineBlock(facts, ctx) {
     `repoRoot=${ctx.repoRootAbs}`,
     `apiBaseUrl=${apiDisp}`,
     `opencode installed=${String(facts.installed)} credentialsReady=${String(facts.credentialsReady)}`,
-    `opencode modelConfigured=${String(facts.modelConfigured)} modelSummary=${facts.modelSummary}`
+    `opencode modelConfigured=${String(facts.modelConfigured)} modelSummary=${facts.modelSummary}`,
+    `mandatoryRepoOpenCodeJsonPathsOk=${String(facts.mandatoryConfigPathsOk)} (informational)`
   ];
   for (const e of facts.openCodeConfigFiles) {
     lines.push(`opencodeConfigFile ${e.path} exists=${String(e.exists)}`);
@@ -21931,14 +22026,6 @@ function evaluateReadinessGates(facts) {
       readinessReasonCode: READINESS_OPENCODE_MODEL
     };
   }
-  if (!facts.mandatoryConfigPathsOk) {
-    return {
-      ok: false,
-      gate: "d",
-      exitCode: OsExit.readinessOpenCodeMandatoryConfig,
-      readinessReasonCode: READINESS_OPENCODE_MANDATORY_CONFIG
-    };
-  }
   return { ok: true };
 }
 function buildReadinessJsonFields(facts) {
@@ -22204,7 +22291,7 @@ function sleepUntilAborted(ms, signal) {
   if (signal.aborted) {
     return Promise.reject(new DOMException("The operation was aborted.", "AbortError"));
   }
-  return new Promise((resolve23, reject) => {
+  return new Promise((resolve24, reject) => {
     const onAbort = () => {
       clearTimeout(t);
       signal.removeEventListener("abort", onAbort);
@@ -22212,7 +22299,7 @@ function sleepUntilAborted(ms, signal) {
     };
     const t = setTimeout(() => {
       signal.removeEventListener("abort", onAbort);
-      resolve23();
+      resolve24();
     }, ms);
     signal.addEventListener("abort", onAbort, { once: true });
   });
@@ -22711,7 +22798,7 @@ async function runGenerateContextFactory(deps) {
 
 // src/factory/generateContextFactoryHeadlessHost.ts
 var fs48 = __toESM(require("node:fs"));
-var path44 = __toESM(require("node:path"));
+var path45 = __toESM(require("node:path"));
 
 // src/stores/pipelineRunStore.ts
 var STORAGE_KEY2 = SRS53_PIPELINE_RUN_KEY_V2;
@@ -22812,11 +22899,11 @@ async function noteAgentsMaterialized(context) {
 
 // src/pipelines/remediation/missingWorkstations.ts
 var fs41 = __toESM(require("fs"));
-var path36 = __toESM(require("path"));
+var path37 = __toESM(require("path"));
 
 // src/analysis/analysisDetailMarkdownDiscovery.ts
 var fs40 = __toESM(require("fs"));
-var path35 = __toESM(require("path"));
+var path36 = __toESM(require("path"));
 var SLUG4 = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
 var FE2 = /^FE-\d+$/;
 var UC2 = /^UC-\d+$/;
@@ -22878,7 +22965,7 @@ function expectedFeatureDetailBasenameFromRow(row2) {
   return `${code}-${slug}.md`;
 }
 function ctxPath(contextDir2, basename17) {
-  return path35.join(contextDir2, basename17);
+  return path36.join(contextDir2, basename17);
 }
 function pushTarget(targets, stem, outputBasename, taskDescription, contextDir2) {
   const meta = STEM_TO_AGENT[stem];
@@ -22894,7 +22981,7 @@ function pushTarget(targets, stem, outputBasename, taskDescription, contextDir2)
 function discoverDetailMarkdownGroups(contextDir2) {
   const groups = [];
   const featureTargets = [];
-  const flPath = path35.join(contextDir2, "features-list.json");
+  const flPath = path36.join(contextDir2, "features-list.json");
   const fl = readJson5(flPath);
   const features = Array.isArray(fl?.features) ? fl.features : [];
   for (const row2 of features) {
@@ -22924,7 +23011,7 @@ function discoverDetailMarkdownGroups(contextDir2) {
     if (!FE2.test(feCode)) {
       continue;
     }
-    const ucListPath = path35.join(contextDir2, `${feCode}-use-cases-list.json`);
+    const ucListPath = path36.join(contextDir2, `${feCode}-use-cases-list.json`);
     const ucFile = readJson5(ucListPath);
     const ucs = Array.isArray(ucFile?.useCases) ? ucFile.useCases : [];
     for (const ucRow of ucs) {
@@ -22944,7 +23031,7 @@ function discoverDetailMarkdownGroups(contextDir2) {
 Follow bundled agent **agent-md-use-case-detail**: include **## Data inputs and validation** (concrete fields, mandatory vs optional, rules, failure behaviour). **## Code flow** must trace **implementation order** (entrypoint \u2192 validation \u2192 business rules \u2192 persistence \u2192 response) with **real** symbols and files\u2014not generic \u201Cuser does X\u201D. Add a **Mermaid** fenced diagram under Code flow when there are **two or more** implementation stages. **## Evidence index** must cite **each major stage** (validation, persistence, response), not only the outer entrypoint.`,
         contextDir2
       );
-      const scPath = path35.join(contextDir2, `${feCode}_${ucCode}-scenarios-list.json`);
+      const scPath = path36.join(contextDir2, `${feCode}_${ucCode}-scenarios-list.json`);
       const scFile = readJson5(scPath);
       const scs = Array.isArray(scFile?.scenarios) ? scFile.scenarios : [];
       for (const scRow of scs) {
@@ -23015,7 +23102,7 @@ Follow bundled agent **agent-md-use-case-detail**: include **## Data inputs and
   groups.push({ id: "detail-services", label: "Detail markdown \u2014 Services", targets: svcTargets });
   groups.push({ id: "detail-methods", label: "Detail markdown \u2014 Methods", targets: meTargets });
   const entTargets = [];
-  const dmPath = path35.join(contextDir2, "data-model-list.json");
+  const dmPath = path36.join(contextDir2, "data-model-list.json");
   const dmFile = readJson5(dmPath);
   const ents = Array.isArray(dmFile?.entities) ? dmFile.entities : [];
   for (const erow of ents) {
@@ -23044,7 +23131,7 @@ Follow bundled agent **agent-md-use-case-detail**: include **## Data inputs and
     if (!DM2.test(dmCode)) {
       continue;
     }
-    const flPath2 = path35.join(contextDir2, `${dmCode}-fields-list.json`);
+    const flPath2 = path36.join(contextDir2, `${dmCode}-fields-list.json`);
     const flFile = readJson5(flPath2);
     const flds = Array.isArray(flFile?.fields) ? flFile.fields : [];
     for (const frow of flds) {
@@ -23103,7 +23190,7 @@ function fileAndValidationFromKind(kind) {
   return { filePresentYesNo: "no", validationYesNo: "na" };
 }
 function classifyMissingWorkstationOutputFileStatus(row2, contextDir2, worktreeRoot) {
-  const abs = path36.join(contextDir2, row2.relativePath);
+  const abs = path37.join(contextDir2, row2.relativePath);
   try {
     const st = fs41.statSync(abs);
     if (!st.isFile()) {
@@ -23142,7 +23229,7 @@ function classifyMissingWorkstationOutputFileStatus(row2, contextDir2, worktreeR
       detail: "Unknown coordination list basename \u2014 no JSON Schema mapping."
     };
   }
-  const schemaAbs = path36.join(worktreeRoot, ".opencode", "schemas", "context-lists", schemaBn);
+  const schemaAbs = path37.join(worktreeRoot, ".opencode", "schemas", "context-lists", schemaBn);
   if (!fs41.existsSync(schemaAbs)) {
     return {
       kind: "invalid",
@@ -23172,7 +23259,7 @@ function classifyWorkstationOutputOnDisk(item, contextDir2, worktreeRoot) {
   return classifyMissingWorkstationOutputFileStatus(row2, contextDir2, worktreeRoot).kind;
 }
 function isWorkstationRunSnapshotForWorktree(snapshot, worktreeRoot) {
-  return !!(snapshot && snapshot.overallStatus !== "running" && snapshot.overallStatus !== "idle" && path36.resolve(snapshot.analysisRoot) === path36.resolve(worktreeRoot));
+  return !!(snapshot && snapshot.overallStatus !== "running" && snapshot.overallStatus !== "idle" && path37.resolve(snapshot.analysisRoot) === path37.resolve(worktreeRoot));
 }
 function expectedBasenameForCoordPayload(p) {
   const { step, listTarget } = p;
@@ -23246,10 +23333,10 @@ function labelContextForCoordPayload(p) {
 }
 function contextPathForWorkItem(item, contextDir2) {
   if (item.kind === "markdown") {
-    return path36.join(contextDir2, item.payload.outputBasename);
+    return path37.join(contextDir2, item.payload.outputBasename);
   }
   const bn = expectedBasenameForCoordPayload(item.payload);
-  return bn ? path36.join(contextDir2, bn) : null;
+  return bn ? path37.join(contextDir2, bn) : null;
 }
 function syntheticRunnerId(key) {
   return `remediation:${key}`;
@@ -23259,7 +23346,7 @@ function rowFromSkippedItem(item, contextDir2) {
     return null;
   }
   const abs = contextPathForWorkItem(item, contextDir2);
-  const rel = abs ? path36.basename(abs) : item.kind === "markdown" ? item.payload.outputBasename : item.id;
+  const rel = abs ? path37.basename(abs) : item.kind === "markdown" ? item.payload.outputBasename : item.id;
   if (abs && nonEmptyContextFile(abs)) {
     return null;
   }
@@ -23434,7 +23521,7 @@ function toMissingWorkstationUiRows(rows, contextDir2, worktreeRoot) {
 }
 
 // src/pipelines/remediation/missingWorkstationsPool.ts
-var path37 = __toESM(require("path"));
+var path38 = __toESM(require("path"));
 function reconcileSkippedWorkItemsWithDisk(byId, contextDir2, worktreeRoot) {
   for (const item of byId.values()) {
     if (item.status !== "skipped") {
@@ -23494,7 +23581,7 @@ async function runRemediationPipelineMissingPass(p) {
     onItemComplete,
     sourceBranchAtWorktreeCreation
   } = p;
-  const contextDir2 = path37.join(worktreeRoot, ".gluecharm", "context");
+  const contextDir2 = path38.join(worktreeRoot, ".gluecharm", "context");
   const snap = readArtefactRunSnapshot(storageContext);
   const snapOk = isWorkstationRunSnapshotForWorktree(snap, worktreeRoot);
   let byId;
@@ -23561,17 +23648,17 @@ async function runRemediationPipelineMissingPass(p) {
 // src/pipelines/coverage/coveragePipeline.ts
 var import_child_process5 = require("child_process");
 var fs43 = __toESM(require("fs"));
-var path39 = __toESM(require("path"));
+var path40 = __toESM(require("path"));
 
 // src/analysis/coverageReferenceValidationSchemaValidate.ts
 var fs42 = __toESM(require("fs"));
-var path38 = __toESM(require("path"));
+var path39 = __toESM(require("path"));
 var import__5 = __toESM(require__());
 function stripUtf8Bom4(s) {
   return s.length > 0 && s.charCodeAt(0) === 65279 ? s.slice(1) : s;
 }
 function bundledCoverageReferenceValidationSchemaPath() {
-  return path38.join(
+  return path39.join(
     resolveRepoResourcesRoot(),
     "schemas",
     "context-lists",
@@ -23651,8 +23738,8 @@ var DEFAULT_IGNORE_DIR_BASENAMES = [
 ];
 var GIT_LS_FILES_MAX_BUFFER = 64 * 1024 * 1024;
 function tryLoadGitNonIgnoredPathSet(repositoryRootAbs) {
-  const root = path39.resolve(repositoryRootAbs);
-  if (!fs43.existsSync(path39.join(root, ".git"))) {
+  const root = path40.resolve(repositoryRootAbs);
+  if (!fs43.existsSync(path40.join(root, ".git"))) {
     return null;
   }
   const env = { ...process.env, GIT_TERMINAL_PROMPT: "0" };
@@ -23720,12 +23807,12 @@ var REFERENCE_COVERAGE_IMAGE_EXTENSIONS = /* @__PURE__ */ new Set([
   ".emf"
 ]);
 function isReferenceCoverageExcludedImagePath(relPosix) {
-  const ext = path39.extname(relPosix).toLowerCase();
+  const ext = path40.extname(relPosix).toLowerCase();
   return ext.length > 0 && REFERENCE_COVERAGE_IMAGE_EXTENSIONS.has(ext);
 }
 var REFERENCE_COVERAGE_EXCLUDED_FILE_BASENAMES = /* @__PURE__ */ new Set([".gitignore"]);
 function isReferenceCoverageExcludedDefaultBasename(relPosix) {
-  const base = path39.basename(relPosix.replace(/\\/g, "/")).toLowerCase();
+  const base = path40.basename(relPosix.replace(/\\/g, "/")).toLowerCase();
   return REFERENCE_COVERAGE_EXCLUDED_FILE_BASENAMES.has(base);
 }
 function decodeBufferForLineCount(buf) {
@@ -23762,12 +23849,12 @@ function normalizeRepoRelativePath(repoRoot, raw) {
   if (!trimmed || trimmed.includes("\0")) {
     return null;
   }
-  const abs = path39.resolve(repoRoot, trimmed);
-  const rel = path39.relative(repoRoot, abs);
-  if (rel.startsWith("..") || path39.isAbsolute(rel)) {
+  const abs = path40.resolve(repoRoot, trimmed);
+  const rel = path40.relative(repoRoot, abs);
+  if (rel.startsWith("..") || path40.isAbsolute(rel)) {
     return null;
   }
-  return rel.split(path39.sep).join("/");
+  return rel.split(path40.sep).join("/");
 }
 function collectJsonSourceReferences(node, out) {
   if (node === null || typeof node !== "object") {
@@ -23812,7 +23899,7 @@ function listContextFilesRecursive(dir, acc) {
     return;
   }
   for (const e of entries) {
-    const full = path39.join(dir, e.name);
+    const full = path40.join(dir, e.name);
     if (e.isDirectory()) {
       listContextFilesRecursive(full, acc);
     } else if (e.isFile()) {
@@ -23833,8 +23920,8 @@ function walkRepositoryFiles(repoRoot, ignoreBasenames, maxBytes, excludedOut, g
       if (ignoreBasenames.has(e.name)) {
         continue;
       }
-      const full = path39.join(dir, e.name);
-      const rel = path39.relative(repoRoot, full).split(path39.sep).join("/");
+      const full = path40.join(dir, e.name);
+      const rel = path40.relative(repoRoot, full).split(path40.sep).join("/");
       if (rel.startsWith("..")) {
         continue;
       }
@@ -23892,9 +23979,9 @@ function collectReferencesFromContext(contextDirAbs, repositoryRootAbs, warnings
   const allFiles = [];
   listContextFilesRecursive(contextDirAbs, allFiles);
   for (const abs of allFiles) {
-    const ext = path39.extname(abs).toLowerCase();
-    const base = path39.basename(abs);
-    const sourceArtefact = path39.relative(contextDirAbs, abs).split(path39.sep).join("/");
+    const ext = path40.extname(abs).toLowerCase();
+    const base = path40.basename(abs);
+    const sourceArtefact = path40.relative(contextDirAbs, abs).split(path40.sep).join("/");
     if (ext === ".json") {
       if (SKIP_CONTEXT_JSON.has(base)) {
         continue;
@@ -23976,12 +24063,12 @@ function sortReferenceRows(a, b) {
   return (a.startLine ?? 0) - (b.startLine ?? 0);
 }
 function buildCoverageReferenceValidationDocument(repositoryRootAbs, contextDirAbs, options) {
-  const repoRoot = path39.resolve(repositoryRootAbs);
+  const repoRoot = path40.resolve(repositoryRootAbs);
   const warnings = [];
   const ignoreDirs = [...DEFAULT_IGNORE_DIR_BASENAMES];
   const ignoreSet = new Set(ignoreDirs);
   const maxBytes = options?.maxFileBytes ?? MAX_FILE_BYTES;
-  const references = collectReferencesFromContext(path39.resolve(contextDirAbs), repoRoot, warnings);
+  const references = collectReferencesFromContext(path40.resolve(contextDirAbs), repoRoot, warnings);
   references.sort(sortReferenceRows);
   const referencedSet = /* @__PURE__ */ new Set();
   for (const r of references) {
@@ -23989,7 +24076,7 @@ function buildCoverageReferenceValidationDocument(repositoryRootAbs, contextDirA
   }
   const excludedFiles = [];
   const gitNonIgnoredPaths = tryLoadGitNonIgnoredPathSet(repoRoot);
-  if (fs43.existsSync(path39.join(repoRoot, ".git")) && gitNonIgnoredPaths === null) {
+  if (fs43.existsSync(path40.join(repoRoot, ".git")) && gitNonIgnoredPaths === null) {
     warnings.push(
       "Repository has .git but git ls-files failed or git is unavailable; .gitignore / exclude-standard not applied."
     );
@@ -24038,8 +24125,8 @@ function buildCoverageReferenceValidationDocument(repositoryRootAbs, contextDirA
   return { document: doc, warnings };
 }
 function runCoveragePipeline(opts) {
-  const repoRoot = path39.resolve(opts.repositoryRootAbs);
-  const contextDir2 = path39.resolve(opts.contextDirAbs);
+  const repoRoot = path40.resolve(opts.repositoryRootAbs);
+  const contextDir2 = path40.resolve(opts.contextDirAbs);
   if (!fs43.existsSync(repoRoot)) {
     return { ok: false, error: `Repository root does not exist: ${repoRoot}` };
   }
@@ -24061,7 +24148,7 @@ ${schemaCheck.errors.join("\n")}`,
       warnings
     };
   }
-  const outPath = path39.join(contextDir2, COVERAGE_REFERENCE_VALIDATION_BASENAME);
+  const outPath = path40.join(contextDir2, COVERAGE_REFERENCE_VALIDATION_BASENAME);
   if (opts.write) {
     try {
       const payload = stableStringifyCoverageDocument(document);
@@ -24080,11 +24167,11 @@ ${schemaCheck.errors.join("\n")}`,
 // src/pipelines/remediation/zeroReferenceWorkstationChain.ts
 var crypto = __toESM(require("crypto"));
 var fs45 = __toESM(require("fs"));
-var path41 = __toESM(require("path"));
+var path42 = __toESM(require("path"));
 
 // src/analysis/zeroReferenceRemediationSchemaValidate.ts
 var fs44 = __toESM(require("fs"));
-var path40 = __toESM(require("path"));
+var path41 = __toESM(require("path"));
 var import__6 = __toESM(require__());
 function stripUtf8Bom5(s) {
   return s.length > 0 && s.charCodeAt(0) === 65279 ? s.slice(1) : s;
@@ -24104,7 +24191,7 @@ function formatAjvErrors6(errors) {
 }
 var ajv = new import__6.default({ allErrors: true, strict: false });
 function compileSchema(basename17) {
-  const schemaPath = path40.join(schemasDir(), basename17);
+  const schemaPath = path41.join(schemasDir(), basename17);
   const schemaRaw = stripUtf8Bom5(fs44.readFileSync(schemaPath, "utf-8"));
   const schema = JSON.parse(schemaRaw);
   return ajv.compile(schema);
@@ -24399,17 +24486,17 @@ function expandArgvTemplate4(template, vars) {
   });
 }
 function schemaRef2(worktreeRoot, schemaBasename) {
-  return path41.join(worktreeRoot, ".opencode", "schemas", "context-lists", schemaBasename);
+  return path42.join(worktreeRoot, ".opencode", "schemas", "context-lists", schemaBasename);
 }
 function stagingDir(contextDirAbs) {
-  return path41.join(contextDirAbs, "_zero-ref-staging");
+  return path42.join(contextDirAbs, "_zero-ref-staging");
 }
 function stagingPathForTarget(contextDirAbs, kind, targetFilePathPosix) {
   const h = crypto.createHash("sha256").update(targetFilePathPosix, "utf8").digest("hex").slice(0, 16);
-  return path41.join(stagingDir(contextDirAbs), `${kind}-${h}.json`);
+  return path42.join(stagingDir(contextDirAbs), `${kind}-${h}.json`);
 }
 function readNonReferencedFilesFromRepositoryRoot(repositoryRootAbs) {
-  const p = path41.join(repositoryRootAbs, ".gluecharm", "context", "coverage-reference-validation.json");
+  const p = path42.join(repositoryRootAbs, ".gluecharm", "context", "coverage-reference-validation.json");
   const r = readAndValidateCoverageReferenceValidationFile(p);
   if (!r.ok) {
     return { ok: false, error: r.errors.join("; ") };
@@ -24502,7 +24589,7 @@ function slugifyFeatureLabel(s) {
   return t.length > 0 ? t : "feature";
 }
 function lineCountRepoFile(worktreeRootAbs, relPosix) {
-  const abs = path41.join(worktreeRootAbs, ...relPosix.split("/"));
+  const abs = path42.join(worktreeRootAbs, ...relPosix.split("/"));
   let buf;
   try {
     buf = fs45.readFileSync(abs);
@@ -24557,8 +24644,8 @@ var LIST_STEP_HINT = {
 };
 async function applyCoordinationListTriageMerge(input) {
   const cfg = LIST_MERGE_CFG[input.listKind];
-  const listPath = path41.join(input.contextDirAbs, cfg.listBasename);
-  const schemaPath = path41.join(resolveContextListSchemasDir(), cfg.schemaBasename);
+  const listPath = path42.join(input.contextDirAbs, cfg.listBasename);
+  const schemaPath = path42.join(resolveContextListSchemasDir(), cfg.schemaBasename);
   if (!fs45.existsSync(listPath)) {
     return {
       ok: false,
@@ -24662,10 +24749,10 @@ async function applyCoordinationListTriageMerge(input) {
 }
 async function runClassifierAgent(common, contextDirAbs, targetFilePathPosix, workspaceLabel) {
   const outAbs = stagingPathForTarget(contextDirAbs, "classifier", targetFilePathPosix);
-  fs45.mkdirSync(path41.dirname(outAbs), { recursive: true });
-  const runDir = path41.join(common.worktreeRoot, ".opencode", "_run");
+  fs45.mkdirSync(path42.dirname(outAbs), { recursive: true });
+  const runDir = path42.join(common.worktreeRoot, ".opencode", "_run");
   fs45.mkdirSync(runDir, { recursive: true });
-  const outputBasename = path41.basename(outAbs);
+  const outputBasename = path42.basename(outAbs);
   const listTaskDescription = [
     `Target file (repo-relative, POSIX): **${targetFilePathPosix}**`,
     `Workspace label hint: **${workspaceLabel}**.`,
@@ -24701,7 +24788,7 @@ async function runClassifierAgent(common, contextDirAbs, targetFilePathPosix, wo
       parentContextBlock: "",
       ...repairAppendix ? { repairAppendix } : {}
     });
-    const promptPath = path41.join(runDir, `zero-ref-classify-a${attempt}-${Date.now()}.prompt.txt`);
+    const promptPath = path42.join(runDir, `zero-ref-classify-a${attempt}-${Date.now()}.prompt.txt`);
     fs45.writeFileSync(promptPath, body, "utf-8");
     const argv = expandArgvTemplate4(common.argvTemplate, {
       promptFile: promptPath,
@@ -24833,9 +24920,9 @@ var TRIAGE_SCOPE_META = {
 };
 async function runMarkdownReferenceAgent(common, contextDirAbs, targetFilePathPosix, routingSummary, which) {
   const mdBasename = which === "project" ? "project.md" : "architecture.md";
-  const mdAbs = path41.join(contextDirAbs, mdBasename);
+  const mdAbs = path42.join(contextDirAbs, mdBasename);
   const agentStem = which === "project" ? ZERO_REF_ADD_REF_PROJECT_AGENT_STEM : ZERO_REF_ADD_REF_ARCH_AGENT_STEM;
-  const runDir = path41.join(common.worktreeRoot, ".opencode", "_run");
+  const runDir = path42.join(common.worktreeRoot, ".opencode", "_run");
   fs45.mkdirSync(runDir, { recursive: true });
   const lines = [
     `# SRS-30 \u2014 Add reference to ${mdBasename}`,
@@ -24851,7 +24938,7 @@ async function runMarkdownReferenceAgent(common, contextDirAbs, targetFilePathPo
     `- If the file is short, \`${targetFilePathPosix}:1-<lastLine>\` is acceptable.`,
     `- Do not remove unrelated content; append or extend the most appropriate section.`
   ];
-  const promptPath = path41.join(runDir, `zero-ref-md-${which}-${Date.now()}.prompt.txt`);
+  const promptPath = path42.join(runDir, `zero-ref-md-${which}-${Date.now()}.prompt.txt`);
   fs45.writeFileSync(promptPath, lines.join("\n"), "utf-8");
   const argv = expandArgvTemplate4(common.argvTemplate, {
     promptFile: promptPath,
@@ -24879,10 +24966,10 @@ async function runMarkdownReferenceAgent(common, contextDirAbs, targetFilePathPo
 async function runCoordinationTriageAgent(common, contextDirAbs, targetFilePathPosix, routingSummary, workspaceLabel, triageScope) {
   const meta = TRIAGE_SCOPE_META[triageScope];
   const outAbs = stagingPathForTarget(contextDirAbs, "triage", targetFilePathPosix);
-  fs45.mkdirSync(path41.dirname(outAbs), { recursive: true });
-  const runDir = path41.join(common.worktreeRoot, ".opencode", "_run");
+  fs45.mkdirSync(path42.dirname(outAbs), { recursive: true });
+  const runDir = path42.join(common.worktreeRoot, ".opencode", "_run");
   fs45.mkdirSync(runDir, { recursive: true });
-  const outputBasename = path41.basename(outAbs);
+  const outputBasename = path42.basename(outAbs);
   const listTaskDescription = [
     `Target file: **${targetFilePathPosix}** (${workspaceLabel})`,
     "**Classifier summary:**",
@@ -24912,7 +24999,7 @@ async function runCoordinationTriageAgent(common, contextDirAbs, targetFilePathP
       parentContextBlock: "",
       ...repairAppendix ? { repairAppendix } : {}
     });
-    const promptPath = path41.join(runDir, `zero-ref-triage-a${attempt}-${Date.now()}.prompt.txt`);
+    const promptPath = path42.join(runDir, `zero-ref-triage-a${attempt}-${Date.now()}.prompt.txt`);
     fs45.writeFileSync(promptPath, body, "utf-8");
     const argv = expandArgvTemplate4(common.argvTemplate, {
       promptFile: promptPath,
@@ -25027,8 +25114,8 @@ async function runCoordinationTriageAgent(common, contextDirAbs, targetFilePathP
   return { ok: false, message: lastFailureMessage, stagingPath: outAbs };
 }
 async function runOneUnreferencedFilePipeline(p) {
-  const routingAbs = path41.join(p.contextDirAbs, ZERO_REF_ROUTING_BASENAME);
-  const triageAbs = path41.join(p.contextDirAbs, ZERO_REF_TRIAGE_BASENAME);
+  const routingAbs = path42.join(p.contextDirAbs, ZERO_REF_ROUTING_BASENAME);
+  const triageAbs = path42.join(p.contextDirAbs, ZERO_REF_TRIAGE_BASENAME);
   const key = p.targetFilePathPosix;
   const cr = await runClassifierAgent(p, p.contextDirAbs, key, p.workspaceLabel);
   if (!cr.ok) {
@@ -25052,7 +25139,7 @@ async function runOneUnreferencedFilePipeline(p) {
     if (!s.ok) {
       throw new Error(s.errors.join("; "));
     }
-    fs45.mkdirSync(path41.dirname(routingAbs), { recursive: true });
+    fs45.mkdirSync(path42.dirname(routingAbs), { recursive: true });
     fs45.writeFileSync(routingAbs, s.json, "utf-8");
   });
   const routing = stagingParsed.routing;
@@ -25101,7 +25188,7 @@ async function runOneUnreferencedFilePipeline(p) {
     if (!s.ok) {
       throw new Error(s.errors.join("; "));
     }
-    fs45.mkdirSync(path41.dirname(triageAbs), { recursive: true });
+    fs45.mkdirSync(path42.dirname(triageAbs), { recursive: true });
     fs45.writeFileSync(triageAbs, s.json, "utf-8");
   });
   const decision = triageParsed.decision;
@@ -25129,11 +25216,11 @@ async function runOneUnreferencedFilePipeline(p) {
   return { ok: true, message: `Triage ${decision}.` };
 }
 async function runRemediationPipelineZeroRefPass(p) {
-  const contextDirAbs = path41.join(p.worktreeRoot, ".gluecharm", "context");
+  const contextDirAbs = path42.join(p.worktreeRoot, ".gluecharm", "context");
   const covRoot = p.coverageRepositoryRootAbs ?? p.workspaceRootAbs;
   const cov = readNonReferencedFilesFromRepositoryRoot(covRoot);
   const coverageAt = cov.ok ? cov.generatedAt : void 0;
-  const workspaceLabel = path41.basename(p.worktreeRoot);
+  const workspaceLabel = path42.basename(p.worktreeRoot);
   const routingMutex = new AsyncMutex();
   const triageMutex = new AsyncMutex();
   const paths = [...p.paths];
@@ -25191,7 +25278,7 @@ async function runRemediationPipelineZeroRefPass(p) {
 
 // src/pipelines/coverage/coverageExecutionReport.ts
 var fs46 = __toESM(require("fs"));
-var path42 = __toESM(require("path"));
+var path43 = __toESM(require("path"));
 var REFERENCE_COVERAGE_EXECUTION_REPORT_BASENAME = "reference-coverage-execution-report.md";
 function inlineMdText(s) {
   const t = s.replace(/\r\n/g, "\n").replace(/\n/g, " ").trim();
@@ -25315,10 +25402,10 @@ async function runCoverageExecutionReport(p) {
   if (p.abortSignal?.aborted) {
     return { ok: false, error: "Stopped.", cancelled: true };
   }
-  const contextDirAbs = path42.join(p.repositoryRootAbs, ".gluecharm", "context");
-  const coverageAbs = path42.join(contextDirAbs, "coverage-reference-validation.json");
-  const routingAbs = path42.join(contextDirAbs, "zero-reference-routing.json");
-  const outAbs = path42.join(contextDirAbs, REFERENCE_COVERAGE_EXECUTION_REPORT_BASENAME);
+  const contextDirAbs = path43.join(p.repositoryRootAbs, ".gluecharm", "context");
+  const coverageAbs = path43.join(contextDirAbs, "coverage-reference-validation.json");
+  const routingAbs = path43.join(contextDirAbs, "zero-reference-routing.json");
+  const outAbs = path43.join(contextDirAbs, REFERENCE_COVERAGE_EXECUTION_REPORT_BASENAME);
   const cov = readAndValidateCoverageReferenceValidationFile(coverageAbs);
   if (!cov.ok) {
     return { ok: false, error: `Coverage JSON: ${cov.errors.join("; ")}` };
@@ -25342,7 +25429,7 @@ async function runCoverageExecutionReport(p) {
     previous = void 0;
   }
   try {
-    fs46.mkdirSync(path42.dirname(outAbs), { recursive: true });
+    fs46.mkdirSync(path43.dirname(outAbs), { recursive: true });
     fs46.writeFileSync(outAbs, md, "utf-8");
   } catch (e) {
     const msg = e instanceof Error ? e.message : String(e);
@@ -25360,7 +25447,7 @@ async function runCoverageExecutionReport(p) {
 
 // src/gluecharm/minimalGluecharmLayout.ts
 var fs47 = __toESM(require("node:fs"));
-var path43 = __toESM(require("node:path"));
+var path44 = __toESM(require("node:path"));
 var MINIMAL_GLUECHARM_RELATIVE_DIRS = [
   [".gluecharm", "docs", "srs"],
   [".gluecharm", "content"],
@@ -25368,9 +25455,9 @@ var MINIMAL_GLUECHARM_RELATIVE_DIRS = [
   [".gluecharm", "context"]
 ];
 function ensureMinimalGluecharmLayoutNode(repoRootAbs) {
-  const root = path43.resolve(repoRootAbs);
+  const root = path44.resolve(repoRootAbs);
   for (const segments of MINIMAL_GLUECHARM_RELATIVE_DIRS) {
-    const dir = path43.join(root, ...segments);
+    const dir = path44.join(root, ...segments);
     try {
       fs47.mkdirSync(dir, { recursive: true });
     } catch (e) {
@@ -25502,7 +25589,7 @@ function buildFactoryDepsHeadless(input) {
       if (!layout.ok) {
         return { ok: false, error: layout.error };
       }
-      const ctxDir = path44.join(ar, ".gluecharm", "context");
+      const ctxDir = path45.join(ar, ".gluecharm", "context");
       const snap = readArtefactRunSnapshot(storageContext);
       const rows = listMissingWorkstations(ctxDir, ar, snap);
       if (rows.length === 0) {
@@ -25516,7 +25603,7 @@ function buildFactoryDepsHeadless(input) {
         storageContext,
         repositoryRoot: repoRoot,
         worktreeRoot: ar,
-        workspaceLabel: path44.basename(ar),
+        workspaceLabel: path45.basename(ar),
         oc: {
           ...oc,
           aceEnabled: getAceAnalysisEnabledForCheckout(ar),
@@ -25544,7 +25631,7 @@ function buildFactoryDepsHeadless(input) {
     }
     try {
       await startPipelineRun(storageContext, repoRoot);
-      const folderName = path44.basename(repoRoot);
+      const folderName = path45.basename(repoRoot);
       const oc = buildOpenCodeOptions(handle.path);
       const result = await runSynthesisPipelineDrainFromPreparedWorktree(
         storageContext,
@@ -25601,7 +25688,7 @@ function buildFactoryDepsHeadless(input) {
     if (!ar) {
       return 0;
     }
-    const ctxDir = path44.join(ar, ".gluecharm", "context");
+    const ctxDir = path45.join(ar, ".gluecharm", "context");
     const snap = readArtefactRunSnapshot(storageContext);
     return listMissingWorkstations(ctxDir, ar, snap).length;
   };
@@ -25614,7 +25701,7 @@ function buildFactoryDepsHeadless(input) {
     if (!layout.ok) {
       return { ok: false, message: layout.error };
     }
-    const contextDir2 = path44.join(ar, ".gluecharm", "context");
+    const contextDir2 = path45.join(ar, ".gluecharm", "context");
     log(`[factory] reference coverage (worktree) \u2014 ${ar}`);
     const res = runCoveragePipeline({
       repositoryRootAbs: ar,
@@ -25674,7 +25761,7 @@ function buildFactoryDepsHeadless(input) {
       diagnosticLog: log
     });
     if (res.ok) {
-      return { ok: true, message: `Report: ${path44.basename(res.outputAbsolutePath)}` };
+      return { ok: true, message: `Report: ${path45.basename(res.outputAbsolutePath)}` };
     }
     if (res.cancelled) {
       return { ok: false, cancelled: true, message: "Report generation stopped." };
@@ -25690,7 +25777,7 @@ function buildFactoryDepsHeadless(input) {
     if (!lmLayout.ok) {
       return { ok: false, message: lmLayout.error };
     }
-    const contextDir2 = path44.join(snap.adHocWorktreePath, ".gluecharm", "context");
+    const contextDir2 = path45.join(snap.adHocWorktreePath, ".gluecharm", "context");
     const linkGraph = runLinkMappingPipeline(contextDir2, { log });
     if (!linkGraph.ok) {
       return { ok: false, message: linkGraph.error };
@@ -25706,7 +25793,7 @@ function buildFactoryDepsHeadless(input) {
     if (!idxLayout.ok) {
       return { ok: false, message: idxLayout.error };
     }
-    const contextDir2 = path44.join(snap.adHocWorktreePath, ".gluecharm", "context");
+    const contextDir2 = path45.join(snap.adHocWorktreePath, ".gluecharm", "context");
     try {
       writeIndexApplicationContext(contextDir2, void 0, {
         sourceBranchAtWorktreeCreation: snap.adHocSourceBranchAtCreation
@@ -25761,13 +25848,13 @@ function buildFactoryDepsHeadless(input) {
     },
     runPrepareAnalysisWorktree: async (resume) => {
       if (resume) {
-        if (adHocWorktree && fs48.existsSync(path44.join(adHocWorktree.path, ".git"))) {
+        if (adHocWorktree && fs48.existsSync(path45.join(adHocWorktree.path, ".git"))) {
           return { ok: true };
         }
         const snap = readAnalysisWorkspaceSnapshot(storageContext);
         const wtPath = snap?.adHocWorktreePath?.trim();
         const repo = snap?.adHocRepositoryRoot?.trim() || repoRoot;
-        if (wtPath && fs48.existsSync(path44.join(wtPath, ".git"))) {
+        if (wtPath && fs48.existsSync(path45.join(wtPath, ".git"))) {
           adHocWorktree = resolveAnalysisCheckoutHandle(wtPath, repo);
           macroSourceBranch = snap?.adHocSourceBranchAtCreation;
           macroFinalize = () => {
@@ -25985,11 +26072,11 @@ function stderrLinesForFactoryFailures(failures, exitCode) {
 }
 
 // src/factory/updateContext/runUpdateContextFactory.ts
-var path49 = __toESM(require("node:path"));
+var path50 = __toESM(require("node:path"));
 
 // src/factory/updateContext/updateContextBaseline.ts
 var fs49 = __toESM(require("node:fs"));
-var path45 = __toESM(require("node:path"));
+var path46 = __toESM(require("node:path"));
 function isValidIso(s) {
   const t = Date.parse(s);
   return Number.isFinite(t);
@@ -26004,7 +26091,7 @@ function maxMtimeRegularFilesUnderDir(dirAbs) {
       return;
     }
     for (const e of entries) {
-      const p = path45.join(d, e.name);
+      const p = path46.join(d, e.name);
       if (e.isDirectory()) {
         walk(p);
       } else if (e.isFile()) {
@@ -26030,7 +26117,7 @@ function resolveUpdateContextBaseline(repoRootAbs, repoConfig) {
   if (last.length > 0 && isValidIso(last)) {
     return { baselineIsoUtc: new Date(last).toISOString(), source: "lastRunAt" };
   }
-  const ctxDir = path45.join(repoRootAbs, ".gluecharm", "context");
+  const ctxDir = path46.join(repoRootAbs, ".gluecharm", "context");
   if (!fs49.existsSync(ctxDir)) {
     return null;
   }
@@ -26055,7 +26142,7 @@ function persistUpdateContextLastRunAt(repoRootAbs, isoUtc) {
 // src/factory/updateContext/updateContextGitWindow.ts
 var import_node_child_process3 = require("node:child_process");
 var fs50 = __toESM(require("node:fs"));
-var path46 = __toESM(require("node:path"));
+var path47 = __toESM(require("node:path"));
 var GIT_ENV = { ...process.env, GIT_TERMINAL_PROMPT: "0" };
 function gitLines(repoRootAbs, args) {
   const r = (0, import_node_child_process3.execFileSync)("git", ["-c", "core.quotepath=false", ...args], {
@@ -26079,8 +26166,8 @@ function parseGitLogIso(line) {
   return { hash, iso };
 }
 function discoverCommitWindowAndTouchedPaths(repoRootAbs, baselineIsoUtc) {
-  const root = path46.resolve(repoRootAbs);
-  if (!fs50.existsSync(path46.join(root, ".git"))) {
+  const root = path47.resolve(repoRootAbs);
+  if (!fs50.existsSync(path47.join(root, ".git"))) {
     return { ok: false, error: "Not a git repository (missing .git)." };
   }
   const baselineMs = Date.parse(baselineIsoUtc);
@@ -26139,11 +26226,11 @@ function discoverCommitWindowAndTouchedPaths(repoRootAbs, baselineIsoUtc) {
   };
 }
 function filterPathsExistingInWorktree(worktreeRootAbs, pathsPosix) {
-  const root = path46.resolve(worktreeRootAbs);
+  const root = path47.resolve(worktreeRootAbs);
   const out = [];
   for (const p of pathsPosix) {
     const rel = p.replace(/\\/g, "/");
-    const abs = path46.join(root, ...rel.split("/"));
+    const abs = path47.join(root, ...rel.split("/"));
     try {
       if (fs50.existsSync(abs) && fs50.statSync(abs).isFile()) {
         out.push(rel);
@@ -26156,7 +26243,7 @@ function filterPathsExistingInWorktree(worktreeRootAbs, pathsPosix) {
 
 // src/factory/updateContext/updateContextReport.ts
 var fs51 = __toESM(require("node:fs"));
-var path47 = __toESM(require("node:path"));
+var path48 = __toESM(require("node:path"));
 var CHANGES_SINCE_DATE_BASENAME = "changes-since-date.md";
 function renderChangesSinceDateMarkdown(p) {
   const lines = [
@@ -26198,7 +26285,7 @@ function renderChangesSinceDateMarkdown(p) {
 function writeChangesSinceDateReport(contextDirAbs, body) {
   try {
     fs51.mkdirSync(contextDirAbs, { recursive: true });
-    const target = path47.join(contextDirAbs, CHANGES_SINCE_DATE_BASENAME);
+    const target = path48.join(contextDirAbs, CHANGES_SINCE_DATE_BASENAME);
     fs51.writeFileSync(target, body, "utf-8");
     return { ok: true };
   } catch (e) {
@@ -26208,7 +26295,7 @@ function writeChangesSinceDateReport(contextDirAbs, body) {
 
 // src/factory/updateContext/updateContextSeedCheck.ts
 var fs52 = __toESM(require("node:fs"));
-var path48 = __toESM(require("node:path"));
+var path49 = __toESM(require("node:path"));
 var INDEX_BASENAME = "index-application-context.json";
 var CHANGES_REPORT = "changes-since-date.md";
 function tryParseJsonFile(abs) {
@@ -26224,7 +26311,7 @@ function isWorktreeContextSeeded(contextDirAbs) {
   if (!fs52.existsSync(contextDirAbs)) {
     return false;
   }
-  const indexAbs = path48.join(contextDirAbs, INDEX_BASENAME);
+  const indexAbs = path49.join(contextDirAbs, INDEX_BASENAME);
   if (fs52.existsSync(indexAbs) && fs52.statSync(indexAbs).isFile() && tryParseJsonFile(indexAbs)) {
     return true;
   }
@@ -26242,7 +26329,7 @@ function isWorktreeContextSeeded(contextDirAbs) {
     if (!name.endsWith(".md") && !name.endsWith(".json")) {
       continue;
     }
-    const p = path48.join(contextDirAbs, name);
+    const p = path49.join(contextDirAbs, name);
     try {
       if (fs52.statSync(p).isFile()) {
         distinct.add(name);
@@ -26256,7 +26343,7 @@ function isWorktreeContextSeeded(contextDirAbs) {
 // src/factory/updateContext/runUpdateContextFactory.ts
 var REMEDIATION_CHUNK_MAX = 40;
 function contextDirUnderRoot(wtRoot) {
-  return path49.join(wtRoot, ".gluecharm", "context");
+  return path50.join(wtRoot, ".gluecharm", "context");
 }
 async function runUpdateContextFactory(deps) {
   const inPlace = deps.inPlace === true;
@@ -26587,11 +26674,11 @@ async function runUpdateContextFactory(deps) {
 
 // src/factory/contextDrift/runContextDriftFactory.ts
 var fs58 = __toESM(require("node:fs"));
-var path54 = __toESM(require("node:path"));
+var path55 = __toESM(require("node:path"));
 
 // src/factory/contextDrift/contextDriftManifest.ts
 var fs53 = __toESM(require("node:fs"));
-var path50 = __toESM(require("node:path"));
+var path51 = __toESM(require("node:path"));
 var MAX_REFERENCE_BYTES = 256 * 1024;
 var MAX_EVIDENCE_FILES = 300;
 var MAX_EVIDENCE_READ = 512 * 1024;
@@ -26611,16 +26698,16 @@ function collectEvidencePaths(repoRoot) {
   const out = [];
   const roots = ["src", "test", "tests", "packages", ".gluecharm", "scripts"];
   for (const rel of roots) {
-    const abs = path50.join(repoRoot, rel);
+    const abs = path51.join(repoRoot, rel);
     if (!fs53.existsSync(abs)) {
       continue;
     }
     walkFiles(abs, repoRoot, out, 0);
   }
   for (const leaf of ["package.json", "tsconfig.json"]) {
-    const abs = path50.join(repoRoot, leaf);
+    const abs = path51.join(repoRoot, leaf);
     if (fs53.existsSync(abs) && fs53.statSync(abs).isFile()) {
-      const r = path50.relative(repoRoot, abs).split(path50.sep).join("/");
+      const r = path51.relative(repoRoot, abs).split(path51.sep).join("/");
       out.push(r);
     }
   }
@@ -26645,13 +26732,13 @@ function walkFiles(dir, repoRoot, out, depth) {
     if (e.name === "node_modules" || e.name === ".git" || e.name === "dist" || e.name === "out") {
       continue;
     }
-    const full = path50.join(dir, e.name);
+    const full = path51.join(dir, e.name);
     if (e.isDirectory()) {
       walkFiles(full, repoRoot, out, depth + 1);
     } else if (e.isFile()) {
-      const ext = path50.extname(e.name).toLowerCase();
+      const ext = path51.extname(e.name).toLowerCase();
       if ([".ts", ".tsx", ".js", ".mjs", ".cjs", ".json", ".md", ".yaml", ".yml"].includes(ext) || e.name === "Dockerfile") {
-        const rel = path50.relative(repoRoot, full).split(path50.sep).join("/");
+        const rel = path51.relative(repoRoot, full).split(path51.sep).join("/");
         out.push(rel);
       }
     }
@@ -26661,7 +26748,7 @@ function buildComparisonManifest(args) {
   const references = [];
   let referenceTruncated = false;
   for (const abs of args.bundleAbsFiles) {
-    const rel = path50.relative(args.worktreeRoot, abs).split(path50.sep).join("/");
+    const rel = path51.relative(args.worktreeRoot, abs).split(path51.sep).join("/");
     const { text, truncated } = readFileLimited(abs, MAX_REFERENCE_BYTES);
     references.push({ path: rel, content: text, truncated });
     if (truncated) {
@@ -26673,7 +26760,7 @@ function buildComparisonManifest(args) {
   const omitted = Math.max(0, allEvidence.length - evidencePathsTrimmed.length);
   const evidenceFiles = [];
   for (const rel of evidencePathsTrimmed) {
-    const abs = path50.join(args.worktreeRoot, ...rel.split("/"));
+    const abs = path51.join(args.worktreeRoot, ...rel.split("/"));
     const st = fs53.existsSync(abs) ? fs53.statSync(abs) : null;
     const size = st && st.isFile() ? st.size : 0;
     const { text, truncated } = readFileLimited(abs, MAX_EVIDENCE_READ);
@@ -26684,7 +26771,7 @@ function buildComparisonManifest(args) {
   }
   return {
     runDate: args.runDate,
-    referenceRelPaths: args.bundleAbsFiles.map((a) => path50.relative(args.worktreeRoot, a).split(path50.sep).join("/")),
+    referenceRelPaths: args.bundleAbsFiles.map((a) => path51.relative(args.worktreeRoot, a).split(path51.sep).join("/")),
     references,
     evidenceFiles,
     evidencePathsOnly: [],
@@ -26697,7 +26784,7 @@ function buildComparisonManifest(args) {
 
 // src/factory/contextDrift/contextDriftAgent.ts
 var fs54 = __toESM(require("node:fs"));
-var path51 = __toESM(require("node:path"));
+var path52 = __toESM(require("node:path"));
 
 // src/factory/contextDrift/contextDriftPayload.ts
 function isNonEmptyString2(v) {
@@ -26842,16 +26929,16 @@ function buildDriftPrompt(args) {
   ].join("\n");
 }
 async function runDriftComparisonOpenCode(args) {
-  const runDir = path51.join(args.worktreeRoot, ".opencode", "_run");
+  const runDir = path52.join(args.worktreeRoot, ".opencode", "_run");
   fs54.mkdirSync(runDir, { recursive: true });
-  const manifestPath = path51.join(runDir, "context-drift-manifest.json");
-  const outputPath = path51.join(runDir, "context-drift-payload.json");
+  const manifestPath = path52.join(runDir, "context-drift-manifest.json");
+  const outputPath = path52.join(runDir, "context-drift-payload.json");
   fs54.writeFileSync(manifestPath, `${JSON.stringify(args.manifestObject, null, 2)}
 `, "utf8");
   if (fs54.existsSync(outputPath)) {
     fs54.unlinkSync(outputPath);
   }
-  const promptPath = path51.join(runDir, `context-drift-${Date.now()}.prompt.txt`);
+  const promptPath = path52.join(runDir, `context-drift-${Date.now()}.prompt.txt`);
   fs54.writeFileSync(
     promptPath,
     buildDriftPrompt({
@@ -26869,7 +26956,7 @@ async function runDriftComparisonOpenCode(args) {
   });
   const title = buildOpenCodeSessionTitle({
     runId: "context-drift",
-    workItemId: path51.basename(args.worktreeRoot).slice(0, 24) || "wt",
+    workItemId: path52.basename(args.worktreeRoot).slice(0, 24) || "wt",
     stepLabel: "context-drift"
   });
   const argv = injectPrimaryOpenCodeSessionArgv(expanded, title);
@@ -26912,8 +26999,8 @@ async function runDriftComparisonOpenCode(args) {
 // src/factory/contextDrift/contextDriftPaths.ts
 var crypto2 = __toESM(require("node:crypto"));
 var fs55 = __toESM(require("node:fs"));
-var path52 = __toESM(require("node:path"));
-var DRIFT_CONTEXT_SUBDIR = path52.join(".gluecharm", "context", "drift");
+var path53 = __toESM(require("node:path"));
+var DRIFT_CONTEXT_SUBDIR = path53.join(".gluecharm", "context", "drift");
 function sanitizeSlug(raw) {
   const s = raw.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 64);
   return s.length > 0 ? s : "drift";
@@ -26922,9 +27009,9 @@ function utcDateString(d) {
   return d.toISOString().slice(0, 10);
 }
 function resolveInsideRepo(repoRootAbs, userPath) {
-  const abs = path52.isAbsolute(userPath) ? path52.normalize(userPath) : path52.resolve(repoRootAbs, userPath);
-  const rel = path52.relative(repoRootAbs, abs);
-  if (rel.startsWith("..") || path52.isAbsolute(rel)) {
+  const abs = path53.isAbsolute(userPath) ? path53.normalize(userPath) : path53.resolve(repoRootAbs, userPath);
+  const rel = path53.relative(repoRootAbs, abs);
+  if (rel.startsWith("..") || path53.isAbsolute(rel)) {
     return { ok: false };
   }
   return { ok: true, abs };
@@ -26934,7 +27021,7 @@ function computeSlug(args) {
     return sanitizeSlug(args.label.trim());
   }
   const r = resolveInsideRepo(args.repoRootAbs, args.referencePath);
-  const base = r.ok ? path52.basename(r.abs) : path52.basename(args.referencePath);
+  const base = r.ok ? path53.basename(r.abs) : path53.basename(args.referencePath);
   return sanitizeSlug(base);
 }
 function driftFilename(slug, runDate) {
@@ -26976,7 +27063,7 @@ function discoverReferenceBundle(worktreeRoot, referenceAbsInWorktree) {
       return;
     }
     for (const e of entries) {
-      const full = path52.join(dir, e.name);
+      const full = path53.join(dir, e.name);
       if (e.isDirectory()) {
         if (e.name === "node_modules" || e.name === ".git") {
           continue;
@@ -27006,7 +27093,7 @@ function pickReferenceRootDocument(args) {
   }
   const dir = args.referenceAbsInWorktree;
   for (const name of ["index.md", "README.md"]) {
-    const p = path52.join(dir, name);
+    const p = path53.join(dir, name);
     if (fs55.existsSync(p) && fs55.statSync(p).isFile()) {
       return { ok: true, path: p };
     }
@@ -27017,10 +27104,10 @@ function pickReferenceRootDocument(args) {
   };
 }
 function toWorktreeRelative(worktreeRoot, absolute) {
-  return path52.relative(worktreeRoot, absolute).split(path52.sep).join("/");
+  return path53.relative(worktreeRoot, absolute).split(path53.sep).join("/");
 }
 function toPosixPath(p) {
-  return p.split(path52.sep).join("/");
+  return p.split(path53.sep).join("/");
 }
 
 // src/factory/contextDrift/contextDriftIndex.ts
@@ -27063,19 +27150,19 @@ function escapeRe(s) {
 
 // src/factory/contextDrift/contextDriftPromote.ts
 var fs57 = __toESM(require("node:fs"));
-var path53 = __toESM(require("node:path"));
+var path54 = __toESM(require("node:path"));
 function copyWorktreeFileToWorkspace(args) {
-  const wt = path53.resolve(args.worktreeRoot);
-  const ws = path53.resolve(args.workspaceRoot);
+  const wt = path54.resolve(args.worktreeRoot);
+  const ws = path54.resolve(args.workspaceRoot);
   if (wt === ws) {
     return;
   }
-  const src = path53.join(args.worktreeRoot, ...args.relativePosix.split("/"));
-  const dest = path53.join(args.workspaceRoot, ...args.relativePosix.split("/"));
-  if (path53.resolve(src) === path53.resolve(dest)) {
+  const src = path54.join(args.worktreeRoot, ...args.relativePosix.split("/"));
+  const dest = path54.join(args.workspaceRoot, ...args.relativePosix.split("/"));
+  if (path54.resolve(src) === path54.resolve(dest)) {
     return;
   }
-  fs57.mkdirSync(path53.dirname(dest), { recursive: true });
+  fs57.mkdirSync(path54.dirname(dest), { recursive: true });
   fs57.copyFileSync(src, dest);
 }
 
@@ -27131,7 +27218,7 @@ async function runContextDriftFactory(deps) {
       ok: true,
       code: "DRY_RUN",
       ...baseMeta,
-      referenceRootDocument: toPosixPath(path54.relative(deps.repoRootAbs, refAbsWorkspace)) + (fs58.statSync(refAbsWorkspace).isDirectory() ? "/" : ""),
+      referenceRootDocument: toPosixPath(path55.relative(deps.repoRootAbs, refAbsWorkspace)) + (fs58.statSync(refAbsWorkspace).isDirectory() ? "/" : ""),
       driftReportPath: null,
       analysisWorktreeRoot: "",
       promoted: false,
@@ -27188,8 +27275,8 @@ async function runContextDriftFactory(deps) {
   const handle = prep.handle;
   const finalizeWt = prep.finalize;
   const wt = handle.path;
-  const refRel = path54.relative(deps.repoRootAbs, refAbsWorkspace).split(path54.sep).join("/");
-  const refAbsWt = path54.join(wt, ...refRel.split("/"));
+  const refRel = path55.relative(deps.repoRootAbs, refAbsWorkspace).split(path55.sep).join("/");
+  const refAbsWt = path55.join(wt, ...refRel.split("/"));
   try {
     materializeOpenCodeAgentsWithAce(deps.agentsDirFs, wt, {
       enabled: getAceAnalysisEnabledForCheckout(wt),
@@ -27228,7 +27315,7 @@ async function runContextDriftFactory(deps) {
       ...baseMeta
     };
   }
-  const indexWt = indexOverrideAbsWorkspace ? path54.join(wt, ...path54.relative(deps.repoRootAbs, indexOverrideAbsWorkspace).split(path54.sep)) : void 0;
+  const indexWt = indexOverrideAbsWorkspace ? path55.join(wt, ...path55.relative(deps.repoRootAbs, indexOverrideAbsWorkspace).split(path55.sep)) : void 0;
   const rootPick = pickReferenceRootDocument({
     referencePathIsFile: fs58.statSync(refAbsWt).isFile(),
     referenceAbsInWorktree: refAbsWt,
@@ -27256,9 +27343,9 @@ async function runContextDriftFactory(deps) {
   let slug = computeSlug({ label: deps.label, referencePath: deps.referencePathArg, repoRootAbs: deps.repoRootAbs });
   slug = maybeDedupeSlug(slug, refRel);
   const driftBase = driftFilename(slug, runDate);
-  const driftDirWt = path54.join(wt, DRIFT_CONTEXT_SUBDIR);
+  const driftDirWt = path55.join(wt, DRIFT_CONTEXT_SUBDIR);
   fs58.mkdirSync(driftDirWt, { recursive: true });
-  const driftAbsWt = path54.join(driftDirWt, driftBase);
+  const driftAbsWt = path55.join(driftDirWt, driftBase);
   let payload;
   if (deps.testOnlyFixturePayload) {
     payload = deps.testOnlyFixturePayload;
@@ -27307,7 +27394,7 @@ async function runContextDriftFactory(deps) {
       ...baseMeta
     };
   }
-  const driftRelFromRootDir = path54.relative(path54.dirname(refRootAbsWt), driftAbsWt).split(path54.sep).join("/");
+  const driftRelFromRootDir = path55.relative(path55.dirname(refRootAbsWt), driftAbsWt).split(path55.sep).join("/");
   const linkRes = patchReferenceIndexWithDriftLink({
     referenceRootAbsolute: refRootAbsWt,
     relativeLinkFromRootToDrift: driftRelFromRootDir,
@@ -27326,8 +27413,8 @@ async function runContextDriftFactory(deps) {
       ...baseMeta
     };
   }
-  const driftRelPosix = toPosixPath(path54.relative(wt, driftAbsWt));
-  const rootRelPosix = toPosixPath(path54.relative(wt, refRootAbsWt));
+  const driftRelPosix = toPosixPath(path55.relative(wt, driftAbsWt));
+  const rootRelPosix = toPosixPath(path55.relative(wt, refRootAbsWt));
   const promoteEffective = deps.merged.promoteContextToWorkspace !== false;
   if (promoteEffective && !inPlace) {
     try {
@@ -27357,7 +27444,7 @@ async function runContextDriftFactory(deps) {
   } else if (promoteEffective && inPlace) {
     deps.log("[context-drift] in-place analysis \u2014 promote skipped (artefacts already under repository root)");
   }
-  const driftReportPathFs = promoteEffective ? path54.join(deps.repoRootAbs, ...driftRelPosix.split("/")) : driftAbsWt;
+  const driftReportPathFs = promoteEffective ? path55.join(deps.repoRootAbs, ...driftRelPosix.split("/")) : driftAbsWt;
   return {
     exitOk: true,
     ok: true,
@@ -27376,7 +27463,7 @@ async function runContextDriftFactory(deps) {
 
 // src/analysis/coordinationDuplicatesDiagnosis.ts
 var fs59 = __toESM(require("fs"));
-var path55 = __toESM(require("path"));
+var path56 = __toESM(require("path"));
 var import__7 = __toESM(require__());
 var COORDINATION_DUPLICATES_REPORT_BASENAME = "coordination-duplicates-report.json";
 var COORDINATION_LIST_SCAN_ENTRIES = [
@@ -27402,7 +27489,7 @@ var RE_MD_DM_FD = /^DM-\d+_FD-\d+-.+\.md$/i;
 var RE_MD_DM = /^DM-\d+-.+\.md$/i;
 var RE_MD_TS = /^TS-\d+-.+\.md$/i;
 function looksLikeCoordinationDetailMarkdownBasename(basename17) {
-  if (!basename17 || basename17 !== path55.basename(basename17) || !/\.md$/i.test(basename17)) {
+  if (!basename17 || basename17 !== path56.basename(basename17) || !/\.md$/i.test(basename17)) {
     return false;
   }
   if (STAPLE_CONTEXT_MARKDOWN_BASENAMES.has(basename17)) {
@@ -27411,7 +27498,7 @@ function looksLikeCoordinationDetailMarkdownBasename(basename17) {
   return RE_MD_FE_UC_SC.test(basename17) || RE_MD_FE_UC_SLUG.test(basename17) || RE_MD_FE_UC_PLAIN.test(basename17) || RE_MD_FE_FEATURE.test(basename17) || RE_MD_XP_BH.test(basename17) || RE_MD_XP_VIEW.test(basename17) || RE_MD_SV_ME.test(basename17) || RE_MD_SV.test(basename17) || RE_MD_DM_FD.test(basename17) || RE_MD_DM.test(basename17) || RE_MD_TS.test(basename17);
 }
 function loadRawFeatureRows(contextDirAbs) {
-  const p = path55.join(contextDirAbs, "features-list.json");
+  const p = path56.join(contextDirAbs, "features-list.json");
   if (!fs59.existsSync(p)) {
     return [];
   }
@@ -27704,7 +27791,7 @@ function buildCoordinationDuplicatesReport(input) {
   const lists = [];
   const duplicateGroups = [];
   for (const entry of COORDINATION_LIST_SCAN_ENTRIES) {
-    const filePath = path55.join(input.contextDirAbsolute, entry.basename);
+    const filePath = path56.join(input.contextDirAbsolute, entry.basename);
     if (!fs59.existsSync(filePath)) {
       lists.push({ basename: entry.basename, status: "missing" });
       continue;
@@ -27759,7 +27846,7 @@ var validateReportCompiled;
 function validateReportData(data) {
   if (!validateReportCompiled) {
     const ajv2 = new import__7.default({ allErrors: true, strict: false });
-    const schemaPath = path55.join(resolveContextListSchemasDir(), "coordination-duplicates-report.schema.json");
+    const schemaPath = path56.join(resolveContextListSchemasDir(), "coordination-duplicates-report.schema.json");
     const schemaRaw = stripUtf8Bom6(fs59.readFileSync(schemaPath, "utf-8"));
     validateReportCompiled = ajv2.compile(JSON.parse(schemaRaw));
   }
@@ -27778,7 +27865,7 @@ function runCoordinationDuplicatesDiagnosis(input) {
   if (!v.ok) {
     return { ok: false, message: `Report validation failed: ${v.errors.join("; ")}` };
   }
-  const outPath = path55.join(input.contextDirAbsolute, COORDINATION_DUPLICATES_REPORT_BASENAME);
+  const outPath = path56.join(input.contextDirAbsolute, COORDINATION_DUPLICATES_REPORT_BASENAME);
   const payload = `${JSON.stringify(report, null, 2)}
 `;
   const tmp = `${outPath}.tmp.${process.pid}`;
@@ -27826,7 +27913,7 @@ function runCoordinationDuplicatesDiagnosis(input) {
 
 // src/pipelines/download/downloadPipeline.ts
 var fs60 = __toESM(require("node:fs"));
-var path56 = __toESM(require("node:path"));
+var path57 = __toESM(require("node:path"));
 var SRS_DISCOVERY_BATCH_GET_CHUNK_SIZE = 200;
 function isRecord7(v) {
   return Boolean(v) && typeof v === "object" && !Array.isArray(v);
@@ -27916,9 +28003,9 @@ function resolveSafeContextOutputPath(contextDirAbs, nameRaw) {
       return null;
     }
   }
-  const resolved = path56.resolve(contextDirAbs, ...segments);
-  const rel = path56.relative(contextDirAbs, resolved);
-  if (rel.startsWith("..") || path56.isAbsolute(rel)) {
+  const resolved = path57.resolve(contextDirAbs, ...segments);
+  const rel = path57.relative(contextDirAbs, resolved);
+  if (rel.startsWith("..") || path57.isAbsolute(rel)) {
     return null;
   }
   return resolved;
@@ -27934,7 +28021,7 @@ function clearContextDirectoryForCloudReplace(contextDirAbs) {
   if (!fs60.existsSync(contextDirAbs) || !fs60.statSync(contextDirAbs).isDirectory()) {
     return { filesRemoved: 0 };
   }
-  const preserveAbs = path56.resolve(contextDirAbs, UPLOAD_TARGET_FILENAME);
+  const preserveAbs = path57.resolve(contextDirAbs, UPLOAD_TARGET_FILENAME);
   const preserveSet = /* @__PURE__ */ new Set();
   if (fs60.existsSync(preserveAbs) && fs60.statSync(preserveAbs).isFile()) {
     preserveSet.add(preserveAbs);
@@ -27948,7 +28035,7 @@ function clearContextDirectoryForCloudReplace(contextDirAbs) {
       return;
     }
     for (const e of entries) {
-      const full = path56.join(dir, e.name);
+      const full = path57.join(dir, e.name);
       if (e.isDirectory()) {
         walkRm(full);
         try {
@@ -27956,7 +28043,7 @@ function clearContextDirectoryForCloudReplace(contextDirAbs) {
         } catch {
         }
       } else if (e.isFile()) {
-        const abs = path56.resolve(full);
+        const abs = path57.resolve(full);
         if (preserveSet.has(abs)) {
           continue;
         }
@@ -28029,7 +28116,7 @@ async function runDownloadPipeline(opts) {
       failed.push({ id, message: "Missing name on srs_discovery node." });
       continue;
     }
-    if (name === UPLOAD_TARGET_FILENAME || path56.basename(name) === UPLOAD_TARGET_FILENAME) {
+    if (name === UPLOAD_TARGET_FILENAME || path57.basename(name) === UPLOAD_TARGET_FILENAME) {
       skipped += 1;
       log?.(`[pipeline:download] skip ${name} (upload target row).`);
       continue;
@@ -28040,7 +28127,7 @@ async function runDownloadPipeline(opts) {
       failed.push({ id, name, message: "Unsafe or invalid name for local path." });
       continue;
     }
-    fs60.mkdirSync(path56.dirname(outAbs), { recursive: true });
+    fs60.mkdirSync(path57.dirname(outAbs), { recursive: true });
     const exists = fs60.existsSync(outAbs);
     if (exists && !opts.force && !opts.replaceFromCloud) {
       skipped += 1;
@@ -28123,12 +28210,12 @@ function toFetchErrorMessage(e) {
 
 // src/auth/gluecharmContentNegotiation.ts
 var GLUECHARM_WS_LEGACY_JSON = "application/vnd.gluecharm.v1.ws-legacy+json";
-function pathWithoutQuery(path61) {
-  const q = path61.indexOf("?");
-  return q === -1 ? path61 : path61.slice(0, q);
+function pathWithoutQuery(path62) {
+  const q = path62.indexOf("?");
+  return q === -1 ? path62 : path62.slice(0, q);
 }
-function isGluecharmContentApiPath(path61) {
-  const p = pathWithoutQuery(path61);
+function isGluecharmContentApiPath(path62) {
+  const p = pathWithoutQuery(path62);
   return p.startsWith("/api/content/") || p.startsWith("/api/batch/content/");
 }
 function gluecharmContentHeaders(method) {
@@ -28166,7 +28253,7 @@ async function fetchWithTimeout2(url, init, fetchImpl, timeoutMs, externalSignal
 }
 function createAuthenticatedRequestJson(deps) {
   const fetchImpl = deps.fetchImpl ?? fetch;
-  async function requestJson(path61, options = {}) {
+  async function requestJson(path62, options = {}) {
     const base = deps.getApiBaseUrl();
     if (!base) {
       const err = { status: 0, message: "easyspecs.apiBaseUrl is not configured." };
@@ -28174,7 +28261,7 @@ function createAuthenticatedRequestJson(deps) {
     }
     const method = options.method ?? "GET";
     const headers = { ...options.headers };
-    if (isGluecharmContentApiPath(path61)) {
+    if (isGluecharmContentApiPath(path62)) {
       Object.assign(headers, gluecharmContentHeaders(method));
     } else {
       if (!headers.Accept) {
@@ -28188,7 +28275,7 @@ function createAuthenticatedRequestJson(deps) {
     if (options.withAuth !== false && access) {
       headers.Authorization = `Bearer ${access}`;
     }
-    const url = `${base}${path61}`;
+    const url = `${base}${path62}`;
     const timeoutMs = options.timeoutMs ?? API_TIMEOUT_MS;
     const response = await fetchWithTimeout2(
       url,
@@ -28209,7 +28296,7 @@ function createAuthenticatedRequestJson(deps) {
     if (shouldRetryUnauthorized) {
       const refreshed = await deps.refreshSession();
       if (refreshed) {
-        return requestJson(path61, { ...options, retryOnUnauthorized: false });
+        return requestJson(path62, { ...options, retryOnUnauthorized: false });
       }
     }
     const fallback = payload == null ? `${response.statusText || "HTTP error"} (response body empty or not JSON)` : "Request failed.";
@@ -28221,13 +28308,13 @@ function createAuthenticatedRequestJson(deps) {
 // src/cli/cliSession.ts
 var fs61 = __toESM(require("node:fs"));
 var os7 = __toESM(require("node:os"));
-var path57 = __toESM(require("node:path"));
+var path58 = __toESM(require("node:path"));
 function defaultSessionPath() {
-  return path57.join(os7.homedir(), ".easyspecs", "cli-session.json");
+  return path58.join(os7.homedir(), ".easyspecs", "cli-session.json");
 }
 var configSessionPath;
 function setCliSessionPathFromConfig(absPath) {
-  configSessionPath = absPath?.trim() ? path57.resolve(absPath) : void 0;
+  configSessionPath = absPath?.trim() ? path58.resolve(absPath) : void 0;
 }
 function applyCliSessionPathFromRepoConfig(repoRoot, cfg) {
   const raw = cfg.easyspecs?.cliSessionPath?.trim();
@@ -28235,7 +28322,7 @@ function applyCliSessionPathFromRepoConfig(repoRoot, cfg) {
     setCliSessionPathFromConfig(void 0);
     return;
   }
-  const abs = path57.isAbsolute(raw) ? raw : path57.join(repoRoot, raw);
+  const abs = path58.isAbsolute(raw) ? raw : path58.join(repoRoot, raw);
   setCliSessionPathFromConfig(abs);
 }
 function normalizeCliSessionPathForConfig(repoRoot, raw) {
@@ -28243,15 +28330,15 @@ function normalizeCliSessionPathForConfig(repoRoot, raw) {
   if (!t) {
     return "";
   }
-  const resolvedRepo = path57.resolve(repoRoot);
-  const abs = path57.isAbsolute(t) ? path57.normalize(t) : path57.resolve(resolvedRepo, t);
-  const rel = path57.relative(resolvedRepo, abs);
+  const resolvedRepo = path58.resolve(repoRoot);
+  const abs = path58.isAbsolute(t) ? path58.normalize(t) : path58.resolve(resolvedRepo, t);
+  const rel = path58.relative(resolvedRepo, abs);
   if (rel === "") {
     return abs;
   }
-  const underRepo = !rel.startsWith("..") && !path57.isAbsolute(rel);
+  const underRepo = !rel.startsWith("..") && !path58.isAbsolute(rel);
   if (underRepo) {
-    return rel.split(path57.sep).join("/");
+    return rel.split(path58.sep).join("/");
   }
   return abs;
 }
@@ -28281,7 +28368,7 @@ function readCliSession() {
 }
 function writeCliSession(s) {
   const p = effectiveCliSessionPath();
-  fs61.mkdirSync(path57.dirname(p), { recursive: true });
+  fs61.mkdirSync(path58.dirname(p), { recursive: true });
   fs61.writeFileSync(p, `${JSON.stringify(s, null, 2)}
 `, "utf8");
 }
@@ -28295,7 +28382,7 @@ function clearCliSession() {
 
 // src/analysis/acePendingTraces.ts
 var fs62 = __toESM(require("fs"));
-var path58 = __toESM(require("path"));
+var path59 = __toESM(require("path"));
 function normalizeAceTraceRelativePath(rel) {
   return rel.split(/[/\\]/).join("/");
 }
@@ -28345,7 +28432,7 @@ function listPendingAceTraceFiles(contextDir2, worktreeRoot) {
   const allAbs = listAceTraceFiles(contextDir2);
   const pending = [];
   for (const abs of allAbs) {
-    const rel = normalizeAceTraceRelativePath(path58.relative(contextDir2, abs));
+    const rel = normalizeAceTraceRelativePath(path59.relative(contextDir2, abs));
     const v = validateAceJsonFile(abs, traceSchema);
     if (!v.ok) {
       continue;
@@ -28360,7 +28447,7 @@ function listPendingAceTraceFiles(contextDir2, worktreeRoot) {
 }
 
 // src/analysis/aceAutoLearnPool.ts
-var path59 = __toESM(require("path"));
+var path60 = __toESM(require("path"));
 function clampConcurrency2(n) {
   if (!Number.isFinite(n)) {
     return DEFAULT_MAX_CONCURRENT_AI;
@@ -28395,8 +28482,8 @@ async function runAceAutoLearnPool(p) {
   };
   const currentCap = () => Math.min(staticMaxC, adaptiveMax);
   let wake;
-  const waitTurn = () => new Promise((resolve23) => {
-    wake = resolve23;
+  const waitTurn = () => new Promise((resolve24) => {
+    wake = resolve24;
   });
   const pump = () => {
     wake?.();
@@ -28418,7 +28505,7 @@ async function runAceAutoLearnPool(p) {
       poolAbortListenerRegistered = true;
     }
   }
-  const traceRel = (abs) => path59.relative(contextDir2, abs).split(path59.sep).join("/");
+  const traceRel = (abs) => path60.relative(contextDir2, abs).split(path60.sep).join("/");
   const runOne = async (traceAbs) => {
     if (abortSignal?.aborted) {
       active -= 1;
@@ -28949,7 +29036,7 @@ function formatCliStderrLine(line, useAnsi) {
 }
 
 // src/cli/main.ts
-var PKG_VERSION = "0.2.1";
+var PKG_VERSION = "0.3.0";
 function isNonEmptyFactoryFailureArray(x) {
   if (!Array.isArray(x) || x.length === 0) {
     return false;
@@ -29091,23 +29178,23 @@ function resolveAnalysisRoot(repoRoot, rootKind, worktreePath) {
     return repoRoot;
   }
   const wt = worktreePath?.trim();
-  if (wt && fs63.existsSync(path60.join(wt, ".git"))) {
-    return path60.resolve(wt);
+  if (wt && fs63.existsSync(path61.join(wt, ".git"))) {
+    return path61.resolve(wt);
   }
   throw new Error("worktree mode requires --worktree <path> to an existing analysis checkout.");
 }
 function resolveAdHocCheckoutRoot(_repoRoot, storage, worktreeFlag) {
   const w = worktreeFlag?.trim();
   if (w) {
-    const abs = path60.resolve(w);
-    if (fs63.existsSync(path60.join(abs, ".git"))) {
+    const abs = path61.resolve(w);
+    if (fs63.existsSync(path61.join(abs, ".git"))) {
       return abs;
     }
     throw new Error(`Invalid --worktree (not a git checkout): ${abs}`);
   }
   const snap = readAnalysisWorkspaceSnapshot(storage);
   const p = snap?.adHocWorktreePath?.trim();
-  if (p && fs63.existsSync(path60.join(p, ".git"))) {
+  if (p && fs63.existsSync(path61.join(p, ".git"))) {
     return p;
   }
   throw new Error("No analysis checkout: run `easyspecs-cli run synthesis` first or pass `--worktree <path>`.");
@@ -29134,7 +29221,7 @@ async function runResumeRemediationPool(storage, repoRoot, analysisRoot, merged,
   requireOpenCode(merged, flags);
   const agentsDir = resolveOpenCodeAgentsDir(repoRoot, repoConfig);
   assertAgentsDirExists(agentsDir);
-  const ctxDir = path60.join(analysisRoot, ".gluecharm", "context");
+  const ctxDir = path61.join(analysisRoot, ".gluecharm", "context");
   const snap = readArtefactRunSnapshot(storage);
   const rows = listMissingWorkstations(ctxDir, analysisRoot, snap);
   if (rows.length === 0) {
@@ -29152,7 +29239,7 @@ async function runResumeRemediationPool(storage, repoRoot, analysisRoot, merged,
     storageContext: storage,
     repositoryRoot: repoRoot,
     worktreeRoot: analysisRoot,
-    workspaceLabel: path60.basename(analysisRoot),
+    workspaceLabel: path61.basename(analysisRoot),
     oc,
     log: (line) => logErr(flags, line),
     abortSignal: void 0,
@@ -29329,17 +29416,17 @@ async function main() {
         { easyspecs: { defaultGitRemoteUrl: url } },
         { warnMigration: (m) => logErr(flags, `[EasySpecs] ${m}`) }
       );
-      const path61 = easyspecsConfigPath(repoRoot);
+      const path62 = easyspecsConfigPath(repoRoot);
       if (flags.json) {
         printJsonLine({
           command: "config set-git-remote",
           durationMs: Date.now() - t0,
           ok: true,
-          path: path61,
+          path: path62,
           defaultGitRemoteUrl: cfg.easyspecs?.defaultGitRemoteUrl ?? ""
         });
       } else {
-        console.log(`Updated ${path61} \u2014 easyspecs.defaultGitRemoteUrl`);
+        console.log(`Updated ${path62} \u2014 easyspecs.defaultGitRemoteUrl`);
       }
       process.exit(ExitCode.ok);
     } catch (e) {
@@ -29372,7 +29459,7 @@ async function main() {
   applyCliSessionPathFromRepoConfig(repoRoot, repoConfig);
   if (flags.sessionPath?.trim()) {
     const sp = flags.sessionPath.trim();
-    const abs = path60.isAbsolute(sp) ? path60.normalize(sp) : path60.resolve(repoRoot, sp);
+    const abs = path61.isAbsolute(sp) ? path61.normalize(sp) : path61.resolve(repoRoot, sp);
     setCliSessionPathFromConfig(abs);
   }
   const apiResolved = initApiBaseUrlForCli(repoRoot, flags, repoConfig);
@@ -29613,7 +29700,7 @@ async function main() {
       const result = await runSynthesisPipeline(
         storage,
         repoRoot,
-        path60.basename(repoRoot),
+        path61.basename(repoRoot),
         agentsDir,
         {
           ...merged.pipelineOpenCode
@@ -29668,7 +29755,7 @@ async function main() {
       if (sub === "reference-coverage") {
         const rootAbs = resolveAnalysisRoot(repoRoot, rootKind, worktree);
         requireMinimalGluecharmLayoutAt(rootAbs);
-        const contextDir2 = path60.join(rootAbs, ".gluecharm", "context");
+        const contextDir2 = path61.join(rootAbs, ".gluecharm", "context");
         const res = runCoveragePipeline({
           repositoryRootAbs: rootAbs,
           contextDirAbs: contextDir2,
@@ -29691,7 +29778,7 @@ async function main() {
       if (sub === "coordination-duplicates") {
         const rootAbs = resolveAnalysisRoot(repoRoot, rootKind, worktree);
         requireMinimalGluecharmLayoutAt(rootAbs);
-        const contextDir2 = path60.join(rootAbs, ".gluecharm", "context");
+        const contextDir2 = path61.join(rootAbs, ".gluecharm", "context");
         const res = runCoordinationDuplicatesDiagnosis({
           contextDirAbsolute: contextDir2,
           sourceRoot: rootKind === "worktree" ? "worktree" : "workspace"
@@ -29727,7 +29814,7 @@ async function main() {
       if (sub === "missing-artefacts") {
         const rootAbs = resolveAnalysisRoot(repoRoot, rootKind, worktree);
         requireMinimalGluecharmLayoutAt(rootAbs);
-        const ctxDir = path60.join(rootAbs, ".gluecharm", "context");
+        const ctxDir = path61.join(rootAbs, ".gluecharm", "context");
         const storage = createFileBackedWorkspaceState(repoRoot);
         const snap = readArtefactRunSnapshot(storage);
         const rows = listMissingWorkstations(ctxDir, rootAbs, snap);
@@ -29777,7 +29864,7 @@ async function main() {
           });
           const bad = poolRes.cancelled || poolRes.failures > 0;
           if (!bad) {
-            const ctxDir = path60.join(analysisRoot, ".gluecharm", "context");
+            const ctxDir = path61.join(analysisRoot, ".gluecharm", "context");
             const lg = runLinkMappingPipeline(ctxDir, { log: (line) => logErr(flags, line) });
             if (!lg.ok) {
               finish(OsExit.diagnoseZeroReferenceLinkMapping, {
@@ -29807,7 +29894,7 @@ async function main() {
       const worktree = wtExplicit ?? wtFromRoot;
       const rootAbs = resolveAnalysisRoot(repoRoot, rootKind, worktree);
       requireMinimalGluecharmLayoutAt(rootAbs);
-      const contextDir2 = path60.join(rootAbs, ".gluecharm", "context");
+      const contextDir2 = path61.join(rootAbs, ".gluecharm", "context");
       const res = runLinkMappingPipeline(contextDir2, {
         log: (line) => logErr(flags, line)
       });
@@ -29985,8 +30072,8 @@ async function main() {
         const snap = readAnalysisWorkspaceSnapshot(storage);
         const wt = snap?.adHocWorktreePath?.trim();
         if (wt) {
-          const sourceCtx = path60.join(wt, ".gluecharm", "context");
-          if (path60.resolve(wt) === path60.resolve(repoRoot)) {
+          const sourceCtx = path61.join(wt, ".gluecharm", "context");
+          if (path61.resolve(wt) === path61.resolve(repoRoot)) {
             logErr(
               flags,
               "[pipeline:analysis] promote skipped (in-place: analysis checkout is the repository root)"
@@ -30088,10 +30175,10 @@ async function main() {
         finish(ExitCode.usage, { ok: false, error: `unknown download context flag: ${a}` });
       }
       requireMinimalGluecharmLayoutAt(repoRoot);
-      const ctxDir = path60.resolve(path60.join(repoRoot, ".gluecharm", "context"));
-      const gluecharmParent = path60.dirname(ctxDir);
-      if (path60.basename(gluecharmParent) === ".gluecharm" && path60.basename(ctxDir) === "context") {
-        requireMinimalGluecharmLayoutAt(path60.dirname(gluecharmParent));
+      const ctxDir = path61.resolve(path61.join(repoRoot, ".gluecharm", "context"));
+      const gluecharmParent = path61.dirname(ctxDir);
+      if (path61.basename(gluecharmParent) === ".gluecharm" && path61.basename(ctxDir) === "context") {
+        requireMinimalGluecharmLayoutAt(path61.dirname(gluecharmParent));
       }
       const appIdRaw = getEasyspecsProjectIdFromRepoConfig(repoConfig)?.trim();
       if (!appIdRaw) {
@@ -30174,16 +30261,16 @@ async function main() {
       }
       const sess = sessRaw;
       requireMinimalGluecharmLayoutAt(repoRoot);
-      let ctxDir = path60.join(repoRoot, ".gluecharm", "context");
+      let ctxDir = path61.join(repoRoot, ".gluecharm", "context");
       if (pos[1] === "republish") {
         const fromCfg = repoConfig.easyspecs?.upload?.contextDirectory?.trim();
-        const resolvedOverride = fromCfg && fromCfg.length > 0 ? path60.isAbsolute(fromCfg) ? path60.normalize(fromCfg) : path60.resolve(repoRoot, fromCfg) : "";
-        if (resolvedOverride && fs63.existsSync(path60.join(resolvedOverride, ".."))) {
+        const resolvedOverride = fromCfg && fromCfg.length > 0 ? path61.isAbsolute(fromCfg) ? path61.normalize(fromCfg) : path61.resolve(repoRoot, fromCfg) : "";
+        if (resolvedOverride && fs63.existsSync(path61.join(resolvedOverride, ".."))) {
           ctxDir = resolvedOverride;
         } else {
           const storage = createFileBackedWorkspaceState(repoRoot);
           const snap = readAnalysisWorkspaceSnapshot(storage);
-          const wt = snap?.adHocWorktreePath && fs63.existsSync(path60.join(snap.adHocWorktreePath, ".gluecharm", "context")) ? path60.join(snap.adHocWorktreePath, ".gluecharm", "context") : "";
+          const wt = snap?.adHocWorktreePath && fs63.existsSync(path61.join(snap.adHocWorktreePath, ".gluecharm", "context")) ? path61.join(snap.adHocWorktreePath, ".gluecharm", "context") : "";
           if (!wt) {
             finish(ExitCode.misconfiguration, {
               ok: false,
@@ -30193,10 +30280,10 @@ async function main() {
           ctxDir = wt;
         }
       }
-      const ctxResolved = path60.resolve(ctxDir);
-      const gluecharmParent = path60.dirname(ctxResolved);
-      if (path60.basename(gluecharmParent) === ".gluecharm" && path60.basename(ctxResolved) === "context") {
-        requireMinimalGluecharmLayoutAt(path60.dirname(gluecharmParent));
+      const ctxResolved = path61.resolve(ctxDir);
+      const gluecharmParent = path61.dirname(ctxResolved);
+      if (path61.basename(gluecharmParent) === ".gluecharm" && path61.basename(ctxResolved) === "context") {
+        requireMinimalGluecharmLayoutAt(path61.dirname(gluecharmParent));
       }
       const appIdRaw = getEasyspecsProjectIdFromRepoConfig(repoConfig)?.trim();
       if (!appIdRaw) {
@@ -30300,7 +30387,7 @@ async function main() {
       finish(failed ? ExitCode.upload : ExitCode.ok, primary);
     }
     if (pos[0] === "ace" && pos[1] === "clear") {
-      const learnings = path60.join(repoRoot, ".gluecharm", "context", "learnings");
+      const learnings = path61.join(repoRoot, ".gluecharm", "context", "learnings");
       if (!fs63.existsSync(learnings)) {
         finish(ExitCode.ok, { ok: true, message: "nothing to clear" });
       }
@@ -30310,8 +30397,8 @@ async function main() {
     if (pos[0] === "ace" && pos[1] === "learn") {
       requireOpenCode(merged, flags);
       const { worktree } = parseWorktreeFlag(pos.slice(2));
-      const root = worktree && fs63.existsSync(path60.join(worktree, ".opencode", "schemas", "ace")) ? worktree : repoRoot;
-      const contextDir2 = path60.join(root, ".gluecharm", "context");
+      const root = worktree && fs63.existsSync(path61.join(worktree, ".opencode", "schemas", "ace")) ? worktree : repoRoot;
+      const contextDir2 = path61.join(root, ".gluecharm", "context");
       const traces = listAceTraceFiles(contextDir2);
       if (traces.length === 0) {
         finish(ExitCode.ok, { ok: true, message: "no traces", traceCount: 0 });
@@ -30335,8 +30422,8 @@ async function main() {
     if (pos[0] === "ace" && pos[1] === "auto-learn") {
       requireOpenCode(merged, flags);
       const { worktree } = parseWorktreeFlag(pos.slice(2));
-      const root = worktree && fs63.existsSync(path60.join(worktree, ".git")) ? worktree : repoRoot;
-      const contextDir2 = path60.join(root, ".gluecharm", "context");
+      const root = worktree && fs63.existsSync(path61.join(worktree, ".git")) ? worktree : repoRoot;
+      const contextDir2 = path61.join(root, ".gluecharm", "context");
       const pending = listPendingAceTraceFiles(contextDir2, root);
       if (pending.length === 0) {
         finish(ExitCode.ok, { ok: true, pending: 0 });