@gluecharm-lab/easyspecs-cli 0.1.1 → 0.2.1

package/dist/main.cjs

@@ -959,8 +959,8 @@ var require_command = __commonJS({
   "node_modules/commander/lib/command.js"(exports2) {
     var EventEmitter = require("node:events").EventEmitter;
     var childProcess = require("node:child_process");
-    var path60 = require("node:path");
-    var fs63 = require("node:fs");
+    var path61 = require("node:path");
+    var fs64 = require("node:fs");
     var process2 = require("node:process");
     var { Argument: Argument2, humanReadableArgName } = require_argument();
     var { CommanderError: CommanderError2 } = require_error();
@@ -1892,11 +1892,11 @@ Expecting one of '${allowedValues.join("', '")}'`);
         let launchWithNode = false;
         const sourceExt = [".js", ".ts", ".tsx", ".mjs", ".cjs"];
         function findFile(baseDir, baseName) {
-          const localBin = path60.resolve(baseDir, baseName);
-          if (fs63.existsSync(localBin)) return localBin;
-          if (sourceExt.includes(path60.extname(baseName))) return void 0;
+          const localBin = path61.resolve(baseDir, baseName);
+          if (fs64.existsSync(localBin)) return localBin;
+          if (sourceExt.includes(path61.extname(baseName))) return void 0;
           const foundExt = sourceExt.find(
-            (ext) => fs63.existsSync(`${localBin}${ext}`)
+            (ext) => fs64.existsSync(`${localBin}${ext}`)
           );
           if (foundExt) return `${localBin}${foundExt}`;
           return void 0;
@@ -1908,21 +1908,21 @@ Expecting one of '${allowedValues.join("', '")}'`);
         if (this._scriptPath) {
           let resolvedScriptPath;
           try {
-            resolvedScriptPath = fs63.realpathSync(this._scriptPath);
+            resolvedScriptPath = fs64.realpathSync(this._scriptPath);
           } catch (err) {
             resolvedScriptPath = this._scriptPath;
           }
-          executableDir = path60.resolve(
-            path60.dirname(resolvedScriptPath),
+          executableDir = path61.resolve(
+            path61.dirname(resolvedScriptPath),
             executableDir
           );
         }
         if (executableDir) {
           let localFile = findFile(executableDir, executableFile);
           if (!localFile && !subcommand._executableFile && this._scriptPath) {
-            const legacyName = path60.basename(
+            const legacyName = path61.basename(
               this._scriptPath,
-              path60.extname(this._scriptPath)
+              path61.extname(this._scriptPath)
             );
             if (legacyName !== this._name) {
               localFile = findFile(
@@ -1933,7 +1933,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
           }
           executableFile = localFile || executableFile;
         }
-        launchWithNode = sourceExt.includes(path60.extname(executableFile));
+        launchWithNode = sourceExt.includes(path61.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 = path60.basename(filename, path60.extname(filename));
+        this._name = path61.basename(filename, path61.extname(filename));
         return this;
       }
       /**
@@ -2787,9 +2787,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} [path]
        * @return {(string|null|Command)}
        */
-      executableDir(path61) {
-        if (path61 === void 0) return this._executableDir;
-        this._executableDir = path61;
+      executableDir(path62) {
+        if (path62 === void 0) return this._executableDir;
+        this._executableDir = path62;
         return this;
       }
       /**
@@ -5993,7 +5993,7 @@ var require_compile = __commonJS({
       const schOrFunc = root.refs[ref];
       if (schOrFunc)
         return schOrFunc;
-      let _sch = resolve20.call(this, root, ref);
+      let _sch = resolve23.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 resolve20(root, ref) {
+    function resolve23(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(path60) {
-      let input = path60;
+    function removeDotSegments(path61) {
+      let input = path61;
       const output = [];
       let nextSlash = -1;
       let len = 0;
@@ -6435,8 +6435,8 @@ var require_schemes = __commonJS({
         wsComponent.secure = void 0;
       }
       if (wsComponent.resourceName) {
-        const [path60, query] = wsComponent.resourceName.split("?");
-        wsComponent.path = path60 && path60 !== "/" ? path60 : void 0;
+        const [path61, query] = wsComponent.resourceName.split("?");
+        wsComponent.path = path61 && path61 !== "/" ? path61 : void 0;
         wsComponent.query = query;
         wsComponent.resourceName = void 0;
       }
@@ -6595,7 +6595,7 @@ var require_fast_uri = __commonJS({
       }
       return uri;
     }
-    function resolve20(baseURI, relativeURI, options) {
+    function resolve23(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;
@@ -6822,7 +6822,7 @@ var require_fast_uri = __commonJS({
     var fastUri = {
       SCHEMES,
       normalize: normalize8,
-      resolve: resolve20,
+      resolve: resolve23,
       resolveComponent,
       equal,
       serialize,
@@ -10622,12 +10622,12 @@ var require_dist = __commonJS({
         throw new Error(`Unknown format "${name}"`);
       return f;
     };
-    function addFormats2(ajv2, list, fs63, exportName) {
+    function addFormats2(ajv2, list, fs64, exportName) {
       var _a;
       var _b;
       (_a = (_b = ajv2.opts.code).formats) !== null && _a !== void 0 ? _a : _b.formats = (0, codegen_1._)`require("ajv-formats/dist/formats").${exportName}`;
       for (const f of list)
-        ajv2.addFormat(f, fs63[f]);
+        ajv2.addFormat(f, fs64[f]);
     }
     module2.exports = exports2 = formatsPlugin;
     Object.defineProperty(exports2, "__esModule", { value: true });
@@ -10636,8 +10636,8 @@ var require_dist = __commonJS({
 });
 
 // src/cli/main.ts
-var fs62 = __toESM(require("node:fs"));
-var path59 = __toESM(require("node:path"));
+var fs63 = __toESM(require("node:fs"));
+var path60 = __toESM(require("node:path"));
 
 // src/cli/exitCodes.ts
 var OsExit = {
@@ -10672,7 +10672,15 @@ var OsExit = {
   runSynthesisPipeline: 80,
   aceLearnTrace: 81,
   aceAutoLearnPool: 82,
-  updateContextFactory: 83
+  updateContextFactory: 83,
+  /** SRS-72 readiness gate (a): OpenCode not installed / not callable. */
+  readinessOpenCodeNotInstalled: 84,
+  /** SRS-72 readiness gate (b): credentials not ready. */
+  readinessOpenCodeCredentials: 85,
+  /** SRS-72 readiness gate (c): default model not configured. */
+  readinessOpenCodeModel: 86,
+  /** SRS-72 readiness gate (d): mandatory OpenCode config file missing. */
+  readinessOpenCodeMandatoryConfig: 87
 };
 var ExitCode = {
   ok: 0,
@@ -10765,6 +10773,14 @@ function describeExitCode(code) {
       return "ace auto-learn: one or more learn runs failed.";
     case OsExit.updateContextFactory:
       return "update context: factory run did not succeed.";
+    case OsExit.readinessOpenCodeNotInstalled:
+      return "OpenCode CLI is not installed or not callable on PATH \u2014 install `opencode` or set `easyspecs.openCode.executable`.";
+    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`.";
+    case OsExit.readinessOpenCodeMandatoryConfig:
+      return "Mandatory OpenCode project config is missing \u2014 create `opencode.json` at the repository / analysis root.";
     default:
       return `Non-zero exit (${String(code)}) \u2014 see stderr and any JSON \`error\` field for detail.`;
   }
@@ -10794,6 +10810,12 @@ var {
 } = import_index.default;
 
 // src/cli/cliProgram.ts
+function addNoWorktreeCliOption(cmd) {
+  return cmd.option(
+    "--in-place",
+    "Use repository root as the analysis checkout (no detached git worktree). Synonym: --no-worktree (see main argv rewrite)."
+  ).option("--noworktree", "Alias for --in-place (SRS-71)");
+}
 function createEasyspecsCliProgram() {
   const program2 = new Command();
   program2.name("easyspecs-cli").allowExcessArguments(false).enablePositionalOptions();
@@ -10811,7 +10833,9 @@ function createEasyspecsCliProgram() {
   const runSynthesis = run.command("synthesis").description("Run synthesis pipeline");
   runSynthesis.command("resume-missing").description("Resume remediation pool for missing artefacts").option("--worktree <path>", "Path to an analysis checkout");
   runSynthesis.command("resume-synthesis").description("Resume synthesis pipeline").option("--worktree <path>", "Path to an analysis checkout");
-  program2.command("analysis").description("Run full Factory (Generate Context)").option("--force-new-context-analysis", "Force a new analysis even when cloud cache says analyzed").addOption(new Option("--synthesis-only", "(deprecated; no effect)").hideHelp()).allowUnknownOption(true);
+  const analysisCmd = program2.command("analysis").description("Run full Factory (Generate Context)").option("--force-new-context-analysis", "Force a new analysis even when cloud cache says analyzed").addOption(new Option("--synthesis-only", "(deprecated; no effect)").hideHelp());
+  addNoWorktreeCliOption(analysisCmd);
+  analysisCmd.allowUnknownOption(true);
   const diagnose = program2.command("diagnose").description("Deterministic diagnostics");
   const addRootAndWorktree = (c) => c.option("--root <root>", "workspace|worktree").option("--worktree <path>", "Path to an analysis checkout");
   addRootAndWorktree(diagnose.command("reference-coverage").description("Compute reference coverage"));
@@ -10821,11 +10845,12 @@ function createEasyspecsCliProgram() {
   diagnose.command("zero-reference").description("Run zero-reference remediation").option("--worktree <path>", "Path to an analysis checkout");
   const context = program2.command("context").description("Context operations");
   addRootAndWorktree(context.command("link-graph").description("Validate EasySpecs navigation links in context markdown"));
-  addRootAndWorktree(
-    context.command("drift").description("Compare repo to reference docs; write drift report and update index (worktree + promote)").argument("<referencePath>", "File or directory (spec, SRS, PRD, \u2026)").option("--label <slug>", "Slug for drift-<slug>-<date>.md").option("--index <path>", "Override reference root markdown (relative to repo root)").option("--dry-run", "Validate reference only; skip worktree, agent, and writes")
-  );
+  const driftCmd = context.command("drift").description("Compare repo to reference docs; write drift report and update index (worktree + promote)").argument("<referencePath>", "File or directory (spec, SRS, PRD, \u2026)").option("--label <slug>", "Slug for drift-<slug>-<date>.md").option("--index <path>", "Override reference root markdown (relative to repo root)").option("--dry-run", "Validate reference only; skip worktree, agent, and writes");
+  addNoWorktreeCliOption(driftCmd);
+  addRootAndWorktree(driftCmd);
   const update = program2.command("update").description("Incremental context refresh");
-  update.command("context").description("Update context since last baseline (git delta, optional remediation, promote)").allowUnknownOption(true);
+  const updateContextCmd = update.command("context").description("Update context since last baseline (git delta, optional remediation, promote)").allowUnknownOption(true);
+  addNoWorktreeCliOption(updateContextCmd);
   const download = program2.command("download").description("Download resources");
   download.command("context").description("Download context from EasySpecs cloud").option("--force", "Overwrite existing local files").option("--replace-from-cloud", "Remove local files before writing cloud versions");
   const upload = program2.command("upload").description("Upload resources");
@@ -12662,7 +12687,7 @@ function stringifyForSrs13Debug(value) {
     return truncateForSrs13DebugLog(String(value));
   }
 }
-function logSrs13HttpDebug(log, path60, method, requestBody, error) {
+function logSrs13HttpDebug(log, path61, method, requestBody, error) {
   if (!log) {
     return;
   }
@@ -12672,7 +12697,7 @@ function logSrs13HttpDebug(log, path60, method, requestBody, error) {
   } catch {
     bodyBytes = 0;
   }
-  log(`[pipeline:upload] debug ${method} ${path60} \u2014 request body ~${bodyBytes} bytes (JSON below):`);
+  log(`[pipeline:upload] debug ${method} ${path61} \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;
@@ -14369,9 +14394,9 @@ function parsePsRssDarwinKilobytes(stdout) {
   return n;
 }
 function readLinuxPidRssBytes(pid) {
-  const path60 = `/proc/${pid}/status`;
+  const path61 = `/proc/${pid}/status`;
   try {
-    const content = fs18.readFileSync(path60, "utf8");
+    const content = fs18.readFileSync(path61, "utf8");
     const kb = parseVmRssKilobytesFromProcStatus(content);
     if (kb === null) {
       return { kind: "unknown", reason: "VmRSS_missing" };
@@ -14559,9 +14584,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((resolve20) => {
+  return new Promise((resolve23) => {
     if (sig?.aborted) {
-      resolve20({ ok: false, message: "Stopped by user.", cancelled: true });
+      resolve23({ 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;
@@ -14656,7 +14681,7 @@ ${truncateForDiag(outBody, DIAG_STDOUT_MAX)}`);
       if (diag) {
         finishDiag(diag.label, diag.code, diag.dumpStreams);
       }
-      resolve20(result);
+      resolve23(result);
     };
     let onAbort;
     const clearAbortHandler = () => {
@@ -19091,6 +19116,23 @@ function readHeadBranchShort(repoRoot) {
   const b = (r.stdout ?? "").trim();
   return b.length > 0 ? b : void 0;
 }
+function createInPlaceWorktreeHandle(repositoryRootAbs) {
+  const root = path27.resolve(repositoryRootAbs);
+  return {
+    path: root,
+    repoRoot: root,
+    remove() {
+    }
+  };
+}
+function resolveAnalysisCheckoutHandle(worktreePath, repositoryRoot) {
+  const wt = path27.resolve(worktreePath);
+  const repo = path27.resolve(repositoryRoot);
+  if (wt === repo) {
+    return createInPlaceWorktreeHandle(repo);
+  }
+  return attachWorktreeHandle(worktreePath, repositoryRoot);
+}
 function attachWorktreeHandle(worktreePath, repositoryRoot) {
   const wt = path27.resolve(worktreePath);
   const repo = path27.resolve(repositoryRoot);
@@ -21363,8 +21405,8 @@ async function drainWorkstationPool(p) {
   const artefactRunId = readArtefactRunSnapshot(storageContext)?.runId ?? "unknown-run";
   let active = 0;
   let wake;
-  const waitTurn = () => new Promise((resolve20) => {
-    wake = resolve20;
+  const waitTurn = () => new Promise((resolve23) => {
+    wake = resolve23;
   });
   const persist = async () => {
     const items = {};
@@ -21533,6 +21575,26 @@ async function prepareSynthesisWorktree(storageContext, repoRoot, log, options)
   if (options?.clearPriorArtefactRun !== false) {
     await clearArtefactRun(storageContext);
   }
+  if (options?.inPlace === true) {
+    const repoResolved = path32.resolve(repoRoot);
+    log(`[worktree] in-place analysis \u2014 using repository root ${repoResolved}`);
+    const handle2 = createInPlaceWorktreeHandle(repoResolved);
+    const sourceBranchAtCreation = readHeadBranchShort(repoResolved);
+    let finalized2 = false;
+    const finalize2 = () => {
+      if (finalized2) {
+        return;
+      }
+      finalized2 = true;
+      log(`[worktree] in-place mode \u2014 no teardown`);
+    };
+    return {
+      ok: true,
+      handle: handle2,
+      finalize: finalize2,
+      ...sourceBranchAtCreation ? { sourceBranchAtCreation } : {}
+    };
+  }
   const wt = createAnalysisWorktree(repoRoot, { log });
   if (!wt.ok) {
     return { ok: false, error: wt.error };
@@ -21691,6 +21753,7 @@ function promoteContextDirectoryToWorkspaceFs(sourceContextDir, workspaceRootFs)
 
 // src/shared/factoryPipelineExitConditions.ts
 var FACTORY_PIPELINE_EXIT_CONDITIONS = {
+  diagnose_readiness: "OpenCode CLI, credentials, default model, and mandatory project `opencode.json` are ready before worktree / agent work (SRS-72).",
   create_analysis_worktree: "Git analysis checkout exists under the configured temp parent (SRS-8); ready for agent materialization.",
   materialize_opencode_agents: "Bundled OpenCode agent definitions are copied into the analysis worktree (`.opencode/` tree).",
   synthesis_convergence: "Missing artefact count is 0. May run again after remediation (R5) if a refreshed check finds new expected outputs.",
@@ -21702,6 +21765,208 @@ var FACTORY_PIPELINE_EXIT_CONDITIONS = {
   backend_context_sync: "Context upload finished with no failures (quiet SRS-13 path; or cancel)."
 };
 
+// src/readiness/factoryReadiness.ts
+var fs39 = __toESM(require("node:fs"));
+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() {
+  if (process.platform === "win32") {
+    const base = process.env.APPDATA || path34.join(os6.homedir(), "AppData", "Roaming");
+    return path34.join(base, "opencode", "config.json");
+  }
+  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");
+}
+function buildOpenCodeConfigInventory(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) }));
+}
+function defaultModelFromEasyspecsConfig(cfg) {
+  const providers = cfg.easyspecs?.openCodeRuntime?.providers;
+  if (!providers || typeof providers !== "object") {
+    return void 0;
+  }
+  for (const rec of Object.values(providers)) {
+    const dm = rec?.defaultModel?.trim();
+    if (dm) {
+      return dm;
+    }
+  }
+  return void 0;
+}
+function pickString(v) {
+  return typeof v === "string" && v.trim().length > 0 ? v.trim() : void 0;
+}
+function extractModelFromOpenCodeJson(data) {
+  if (!data || typeof data !== "object") {
+    return void 0;
+  }
+  const o = data;
+  const direct = pickString(o.model) ?? pickString(o.defaultModel);
+  if (direct) {
+    return direct;
+  }
+  const models = o.models;
+  if (models && typeof models === "object") {
+    const m = models;
+    const def = pickString(m.default) ?? pickString(m.defaultModel);
+    if (def) {
+      return def;
+    }
+  }
+  const agent = o.agent;
+  if (agent && typeof agent === "object") {
+    const a = agent;
+    const am = pickString(a.model) ?? pickString(a.defaultModel);
+    if (am) {
+      return am;
+    }
+  }
+  return void 0;
+}
+function sanitizeModelSummary(raw) {
+  const t = raw.trim();
+  if (!t) {
+    return "(not configured)";
+  }
+  if (t.length > 160) {
+    return `${t.slice(0, 157)}\u2026`;
+  }
+  const lower = t.toLowerCase();
+  if (lower.includes("bearer ") || lower.includes("authorization:") || lower.startsWith("sk-")) {
+    return "(redacted)";
+  }
+  return t;
+}
+function resolveModelFromContext(ctx) {
+  const fromCfg = defaultModelFromEasyspecsConfig(ctx.repoConfig);
+  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);
+    if (m) {
+      return { configured: true, summary: sanitizeModelSummary(m) };
+    }
+  } catch {
+  }
+  return { configured: false, summary: "(not configured)" };
+}
+function buildReadinessProbeFacts(ctx) {
+  const oc = ctx.__testOnlyOpenCodeReadiness?.() ?? getOpenCodeReadiness({
+    executable: ctx.openCodeExecutable,
+    skipCredentialsCheck: ctx.openCodeSkipCredentialsCheck,
+    providerEnvFromConfig: ctx.providerEnvFromConfig
+  });
+  const openCodeConfigFiles = buildOpenCodeConfigInventory(ctx.analysisRootAbs);
+  const mandatoryOk = MANDATORY_OPEN_CODE_CONFIG_REL_PATHS.every((rel) => {
+    const abs = path34.join(path34.resolve(ctx.analysisRootAbs), rel);
+    return fs39.existsSync(abs);
+  });
+  const model = resolveModelFromContext(ctx);
+  const agentsDir = resolveOpenCodeAgentsDir(ctx.repoRootAbs, ctx.repoConfig);
+  return {
+    installed: oc.installed,
+    credentialsReady: oc.credentialsReady,
+    skipCredentialsCheck: ctx.openCodeSkipCredentialsCheck === true,
+    modelConfigured: model.configured,
+    modelSummary: model.summary,
+    mandatoryConfigPathsOk: mandatoryOk,
+    openCodeConfigFiles,
+    agentsDir,
+    agentsDirExists: fs39.existsSync(agentsDir)
+  };
+}
+function buildReadinessLineBlock(facts, ctx) {
+  const apiDisp = ctx.apiBaseUrl.trim().length > 0 ? ctx.apiBaseUrl : "(empty \u2014 stub auth only)";
+  const lines = [
+    `cliVersion=${ctx.cliVersion}`,
+    `repoRoot=${ctx.repoRootAbs}`,
+    `apiBaseUrl=${apiDisp}`,
+    `opencode installed=${String(facts.installed)} credentialsReady=${String(facts.credentialsReady)}`,
+    `opencode modelConfigured=${String(facts.modelConfigured)} modelSummary=${facts.modelSummary}`
+  ];
+  for (const e of facts.openCodeConfigFiles) {
+    lines.push(`opencodeConfigFile ${e.path} exists=${String(e.exists)}`);
+  }
+  lines.push(`agentsDir=${facts.agentsDir} exists=${String(facts.agentsDirExists)}`);
+  return lines;
+}
+function evaluateReadinessGates(facts) {
+  if (!facts.installed) {
+    return {
+      ok: false,
+      gate: "a",
+      exitCode: OsExit.readinessOpenCodeNotInstalled,
+      readinessReasonCode: READINESS_OPENCODE_NOT_INSTALLED
+    };
+  }
+  if (!facts.credentialsReady && !facts.skipCredentialsCheck) {
+    return {
+      ok: false,
+      gate: "b",
+      exitCode: OsExit.readinessOpenCodeCredentials,
+      readinessReasonCode: READINESS_OPENCODE_CREDENTIALS
+    };
+  }
+  if (!facts.modelConfigured) {
+    return {
+      ok: false,
+      gate: "c",
+      exitCode: OsExit.readinessOpenCodeModel,
+      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) {
+  return {
+    modelConfigured: facts.modelConfigured,
+    credentialsReady: facts.credentialsReady,
+    openCodeConfigFiles: facts.openCodeConfigFiles,
+    agentsDir: facts.agentsDir,
+    agentsDirExists: facts.agentsDirExists
+  };
+}
+function emitCliFactoryReadinessPreflight(log, bannerPrefix, ctx) {
+  const facts = buildReadinessProbeFacts(ctx);
+  const lines = buildReadinessLineBlock(facts, ctx);
+  log(`${bannerPrefix} \u2014 ${(/* @__PURE__ */ new Date()).toISOString()}`);
+  for (const ln of lines) {
+    log(ln);
+  }
+  const gateRes = evaluateReadinessGates(facts);
+  if (!gateRes.ok) {
+    log(`${bannerPrefix} \u2014 failed (readinessReasonCode=${gateRes.readinessReasonCode})`);
+    log(`Exit ${String(gateRes.exitCode)} \u2014 ${describeExitCode(gateRes.exitCode)}`);
+    return { ok: false, facts, failure: gateRes };
+  }
+  log(`${bannerPrefix} \u2014 succeeded (detail: all checks ok)`);
+  return { ok: true, facts };
+}
+
 // src/factory/factoryValidationFailures.ts
 function factoryFailureDisplayId(row2) {
   return row2.failureExitId;
@@ -21732,6 +21997,7 @@ function normalizeFactoryFailureRow(r) {
   return { ...base, validationExitId: r.validationExitId ?? failureExitId };
 }
 var FACTORY_VALIDATION_PHASE_ORDER = [
+  "diagnose_readiness",
   "create_analysis_worktree",
   "materialize_opencode_agents",
   "synthesis_convergence",
@@ -21747,6 +22013,7 @@ var ERROR_JOIN_MAX = 900;
 var ADDITIONAL_APPEND_MAX = 200;
 var PHASE_TO_OS_EXIT = {
   unknown_factory_phase: OsExit.factoryUnknown,
+  diagnose_readiness: OsExit.readinessOpenCodeModel,
   create_analysis_worktree: OsExit.createAnalysisWorktree,
   materialize_opencode_agents: OsExit.materializeOpenCodeAgents,
   synthesis_convergence: OsExit.synthesisConvergence,
@@ -21759,6 +22026,7 @@ var PHASE_TO_OS_EXIT = {
 };
 var TITLE_BY_PHASE = {
   unknown_factory_phase: "EasySpecs stopped: the failing pipeline phase could not be identified. Retry with --verbose; report this outcome if it persists.",
+  diagnose_readiness: "Factory readiness preflight failed: OpenCode install, credentials, default model, or mandatory `opencode.json` is not satisfied. See stderr lines above and `readinessReasonCode` in JSON.",
   create_analysis_worktree: "Could not prepare the analysis Git worktree (temporary checkout). Check disk space, repo permissions, and that the project is a valid Git checkout.",
   materialize_opencode_agents: "Could not install OpenCode agent files into the analysis worktree. Check bundled extension assets and disk permissions under the worktree path.",
   synthesis_convergence: "Context synthesis did not finish: required context files are still missing or invalid after retries. Inspect OpenCode errors and workstation logs for this phase.",
@@ -21770,6 +22038,7 @@ var TITLE_BY_PHASE = {
   backend_context_sync: "Upload / cloud sync after analysis did not succeed. Check auth, project id, network, and upload error details."
 };
 var READABLE_PHASE_LABEL = {
+  diagnose_readiness: "Diagnose readiness",
   create_analysis_worktree: "Analysis worktree",
   materialize_opencode_agents: "OpenCode agents",
   synthesis_convergence: "Synthesis",
@@ -21835,13 +22104,13 @@ function buildFactoryFailuresFromRows(phases) {
   const failed = phases.filter((p) => p.status === "failed");
   failed.sort((a, b) => phaseIndex(a.key) - phaseIndex(b.key));
   const semantic = failed.map((p) => {
-    const os7 = phaseToSemanticOsExitForGenerateContext(p.key);
+    const os8 = phaseToSemanticOsExitForGenerateContext(p.key);
     const sub = inferValidationSubcode(p.key, p.detail);
-    const fid = failureExitIdFromParts(os7, 0);
+    const fid = failureExitIdFromParts(os8, 0);
     return {
       factory: "generate_context",
       phase: p.key,
-      exitCode: os7,
+      exitCode: os8,
       failureExitId: fid,
       validationExitId: fid,
       title: titleForGenerateContextPhase(p.key),
@@ -21906,6 +22175,7 @@ function composeFactoryValidationError(orchestratorMessage, failures) {
 
 // src/factory/generateContextFactory.ts
 var FACTORY_PIPELINE_KEYS = [
+  "diagnose_readiness",
   "create_analysis_worktree",
   "materialize_opencode_agents",
   "synthesis_convergence",
@@ -21934,7 +22204,7 @@ function sleepUntilAborted(ms, signal) {
   if (signal.aborted) {
     return Promise.reject(new DOMException("The operation was aborted.", "AbortError"));
   }
-  return new Promise((resolve20, reject) => {
+  return new Promise((resolve23, reject) => {
     const onAbort = () => {
       clearTimeout(t);
       signal.removeEventListener("abort", onAbort);
@@ -21942,7 +22212,7 @@ function sleepUntilAborted(ms, signal) {
     };
     const t = setTimeout(() => {
       signal.removeEventListener("abort", onAbort);
-      resolve20();
+      resolve23();
     }, ms);
     signal.addEventListener("abort", onAbort, { once: true });
   });
@@ -22041,6 +22311,59 @@ async function runGenerateContextFactory(deps) {
   };
   let pingPong = 0;
   try {
+    if (!deps.readiness) {
+      setRowTimed("diagnose_readiness", "succeeded", "Readiness context omitted (narrow unit test).");
+      await post();
+    } else {
+      setRowTimed("diagnose_readiness", "running", "Running diagnose readiness preflight\u2026");
+      await post();
+      const facts = buildReadinessProbeFacts(deps.readiness);
+      const lines = buildReadinessLineBlock(facts, deps.readiness);
+      const gateRes = evaluateReadinessGates(facts);
+      const stamp = (/* @__PURE__ */ new Date()).toISOString();
+      const rlog = deps.readinessLog ?? deps.factoryLog;
+      rlog?.(`[factory] diagnose readiness \u2014 ${stamp}`);
+      for (const ln of lines) {
+        rlog?.(ln);
+      }
+      if (!gateRes.ok) {
+        rlog?.(
+          `[factory] diagnose readiness \u2014 failed (readinessReasonCode=${gateRes.readinessReasonCode})`
+        );
+        rlog?.(`Exit ${String(gateRes.exitCode)} \u2014 ${describeExitCode(gateRes.exitCode)}`);
+        const detail = `${gateRes.readinessReasonCode} (gate ${gateRes.gate})`;
+        setRowTimed("diagnose_readiness", "failed", detail);
+        await post();
+        const fr = {
+          factory: "generate_context",
+          phase: "diagnose_readiness",
+          exitCode: gateRes.exitCode,
+          failureExitId: failureExitIdFromParts(gateRes.exitCode, 0),
+          validationExitId: failureExitIdFromParts(gateRes.exitCode, 0),
+          title: titleForGenerateContextPhase("diagnose_readiness"),
+          detail: detail.length > 600 ? `${detail.slice(0, 597)}\u2026` : detail
+        };
+        const ff = finalizeFactoryFailuresForProcessExit([fr]);
+        const msg = `Readiness failed: ${gateRes.readinessReasonCode}`;
+        const r = {
+          ok: false,
+          message: msg,
+          totalElapsedMs: macroEnd(),
+          factoryFailures: ff,
+          readinessFailure: {
+            exitCode: gateRes.exitCode,
+            readinessReasonCode: gateRes.readinessReasonCode,
+            readinessGate: gateRes.gate
+          }
+        };
+        logFactoryEnd(r);
+        return r;
+      }
+      const joined = lines.join(" | ");
+      const okDetail = joined.length > 600 ? `${lines[0] ?? "ok"} | \u2026 (${String(lines.length)} lines)` : joined;
+      setRowTimed("diagnose_readiness", "succeeded", okDetail);
+      await post();
+    }
     outer: while (true) {
       if (isAborted(signal)) {
         setRowTimed("synthesis_convergence", "cancelled", "Stopped.");
@@ -22057,7 +22380,15 @@ async function runGenerateContextFactory(deps) {
           return fin({ ok: false, cancelled: true, message: "Factory stopped.", totalElapsedMs: macroEnd() });
         }
         if (!resumeSynthesis) {
-          setRowTimed("create_analysis_worktree", "running", "Creating git analysis worktree\u2026");
+          if (deps.analysisInPlace === true) {
+            setRowTimed(
+              "create_analysis_worktree",
+              "running",
+              "In-place analysis \u2014 preparing repository root (no temp worktree)\u2026"
+            );
+          } else {
+            setRowTimed("create_analysis_worktree", "running", "Creating git analysis worktree\u2026");
+          }
           await post();
           const wtRes = await deps.runPrepareAnalysisWorktree(false);
           if (!wtRes.ok) {
@@ -22065,7 +22396,15 @@ async function runGenerateContextFactory(deps) {
             await post();
             return fail(wtRes.error ?? "Worktree creation failed.");
           }
-          setRowTimed("create_analysis_worktree", "succeeded", "Analysis checkout ready.");
+          if (deps.analysisInPlace === true) {
+            setRowTimed(
+              "create_analysis_worktree",
+              "skipped",
+              "In-place analysis \u2014 using repository root (no detached checkout)."
+            );
+          } else {
+            setRowTimed("create_analysis_worktree", "succeeded", "Analysis checkout ready.");
+          }
           await post();
           if (isAborted(signal)) {
             setRowTimed("materialize_opencode_agents", "cancelled");
@@ -22371,8 +22710,8 @@ async function runGenerateContextFactory(deps) {
 }
 
 // src/factory/generateContextFactoryHeadlessHost.ts
-var fs47 = __toESM(require("node:fs"));
-var path43 = __toESM(require("node:path"));
+var fs48 = __toESM(require("node:fs"));
+var path44 = __toESM(require("node:path"));
 
 // src/stores/pipelineRunStore.ts
 var STORAGE_KEY2 = SRS53_PIPELINE_RUN_KEY_V2;
@@ -22472,12 +22811,12 @@ async function noteAgentsMaterialized(context) {
 }
 
 // src/pipelines/remediation/missingWorkstations.ts
-var fs40 = __toESM(require("fs"));
-var path35 = __toESM(require("path"));
+var fs41 = __toESM(require("fs"));
+var path36 = __toESM(require("path"));
 
 // src/analysis/analysisDetailMarkdownDiscovery.ts
-var fs39 = __toESM(require("fs"));
-var path34 = __toESM(require("path"));
+var fs40 = __toESM(require("fs"));
+var path35 = __toESM(require("path"));
 var SLUG4 = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
 var FE2 = /^FE-\d+$/;
 var UC2 = /^UC-\d+$/;
@@ -22498,7 +22837,7 @@ var STEM_TO_AGENT = {
 };
 function readJson5(filePath) {
   try {
-    let raw = fs39.readFileSync(filePath, "utf-8");
+    let raw = fs40.readFileSync(filePath, "utf-8");
     if (raw.length > 0 && raw.charCodeAt(0) === 65279) {
       raw = raw.slice(1);
     }
@@ -22539,7 +22878,7 @@ function expectedFeatureDetailBasenameFromRow(row2) {
   return `${code}-${slug}.md`;
 }
 function ctxPath(contextDir2, basename17) {
-  return path34.join(contextDir2, basename17);
+  return path35.join(contextDir2, basename17);
 }
 function pushTarget(targets, stem, outputBasename, taskDescription, contextDir2) {
   const meta = STEM_TO_AGENT[stem];
@@ -22555,7 +22894,7 @@ function pushTarget(targets, stem, outputBasename, taskDescription, contextDir2)
 function discoverDetailMarkdownGroups(contextDir2) {
   const groups = [];
   const featureTargets = [];
-  const flPath = path34.join(contextDir2, "features-list.json");
+  const flPath = path35.join(contextDir2, "features-list.json");
   const fl = readJson5(flPath);
   const features = Array.isArray(fl?.features) ? fl.features : [];
   for (const row2 of features) {
@@ -22585,7 +22924,7 @@ function discoverDetailMarkdownGroups(contextDir2) {
     if (!FE2.test(feCode)) {
       continue;
     }
-    const ucListPath = path34.join(contextDir2, `${feCode}-use-cases-list.json`);
+    const ucListPath = path35.join(contextDir2, `${feCode}-use-cases-list.json`);
     const ucFile = readJson5(ucListPath);
     const ucs = Array.isArray(ucFile?.useCases) ? ucFile.useCases : [];
     for (const ucRow of ucs) {
@@ -22605,7 +22944,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 = path34.join(contextDir2, `${feCode}_${ucCode}-scenarios-list.json`);
+      const scPath = path35.join(contextDir2, `${feCode}_${ucCode}-scenarios-list.json`);
       const scFile = readJson5(scPath);
       const scs = Array.isArray(scFile?.scenarios) ? scFile.scenarios : [];
       for (const scRow of scs) {
@@ -22676,7 +23015,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 = path34.join(contextDir2, "data-model-list.json");
+  const dmPath = path35.join(contextDir2, "data-model-list.json");
   const dmFile = readJson5(dmPath);
   const ents = Array.isArray(dmFile?.entities) ? dmFile.entities : [];
   for (const erow of ents) {
@@ -22705,7 +23044,7 @@ Follow bundled agent **agent-md-use-case-detail**: include **## Data inputs and
     if (!DM2.test(dmCode)) {
       continue;
     }
-    const flPath2 = path34.join(contextDir2, `${dmCode}-fields-list.json`);
+    const flPath2 = path35.join(contextDir2, `${dmCode}-fields-list.json`);
     const flFile = readJson5(flPath2);
     const flds = Array.isArray(flFile?.fields) ? flFile.fields : [];
     for (const frow of flds) {
@@ -22764,9 +23103,9 @@ function fileAndValidationFromKind(kind) {
   return { filePresentYesNo: "no", validationYesNo: "na" };
 }
 function classifyMissingWorkstationOutputFileStatus(row2, contextDir2, worktreeRoot) {
-  const abs = path35.join(contextDir2, row2.relativePath);
+  const abs = path36.join(contextDir2, row2.relativePath);
   try {
-    const st = fs40.statSync(abs);
+    const st = fs41.statSync(abs);
     if (!st.isFile()) {
       return { kind: "absent", detail: "Path exists but is not a regular file." };
     }
@@ -22803,8 +23142,8 @@ function classifyMissingWorkstationOutputFileStatus(row2, contextDir2, worktreeR
       detail: "Unknown coordination list basename \u2014 no JSON Schema mapping."
     };
   }
-  const schemaAbs = path35.join(worktreeRoot, ".opencode", "schemas", "context-lists", schemaBn);
-  if (!fs40.existsSync(schemaAbs)) {
+  const schemaAbs = path36.join(worktreeRoot, ".opencode", "schemas", "context-lists", schemaBn);
+  if (!fs41.existsSync(schemaAbs)) {
     return {
       kind: "invalid",
       detail: `Schema not found (${schemaBn}). Run **Materialize agents** on this checkout.`
@@ -22833,7 +23172,7 @@ function classifyWorkstationOutputOnDisk(item, contextDir2, worktreeRoot) {
   return classifyMissingWorkstationOutputFileStatus(row2, contextDir2, worktreeRoot).kind;
 }
 function isWorkstationRunSnapshotForWorktree(snapshot, worktreeRoot) {
-  return !!(snapshot && snapshot.overallStatus !== "running" && snapshot.overallStatus !== "idle" && path35.resolve(snapshot.analysisRoot) === path35.resolve(worktreeRoot));
+  return !!(snapshot && snapshot.overallStatus !== "running" && snapshot.overallStatus !== "idle" && path36.resolve(snapshot.analysisRoot) === path36.resolve(worktreeRoot));
 }
 function expectedBasenameForCoordPayload(p) {
   const { step, listTarget } = p;
@@ -22907,10 +23246,10 @@ function labelContextForCoordPayload(p) {
 }
 function contextPathForWorkItem(item, contextDir2) {
   if (item.kind === "markdown") {
-    return path35.join(contextDir2, item.payload.outputBasename);
+    return path36.join(contextDir2, item.payload.outputBasename);
   }
   const bn = expectedBasenameForCoordPayload(item.payload);
-  return bn ? path35.join(contextDir2, bn) : null;
+  return bn ? path36.join(contextDir2, bn) : null;
 }
 function syntheticRunnerId(key) {
   return `remediation:${key}`;
@@ -22920,7 +23259,7 @@ function rowFromSkippedItem(item, contextDir2) {
     return null;
   }
   const abs = contextPathForWorkItem(item, contextDir2);
-  const rel = abs ? path35.basename(abs) : item.kind === "markdown" ? item.payload.outputBasename : item.id;
+  const rel = abs ? path36.basename(abs) : item.kind === "markdown" ? item.payload.outputBasename : item.id;
   if (abs && nonEmptyContextFile(abs)) {
     return null;
   }
@@ -23040,7 +23379,7 @@ function listMissingWorkstations(contextDir2, worktreeRoot, snapshot) {
       }
     }
   }
-  if (!fs40.existsSync(contextDir2)) {
+  if (!fs41.existsSync(contextDir2)) {
     return [...map.values()].sort((a, b) => a.key.localeCompare(b.key));
   }
   const dynamic = discoverDynamicAnalysisTestSteps(contextDir2);
@@ -23095,7 +23434,7 @@ function toMissingWorkstationUiRows(rows, contextDir2, worktreeRoot) {
 }
 
 // src/pipelines/remediation/missingWorkstationsPool.ts
-var path36 = __toESM(require("path"));
+var path37 = __toESM(require("path"));
 function reconcileSkippedWorkItemsWithDisk(byId, contextDir2, worktreeRoot) {
   for (const item of byId.values()) {
     if (item.status !== "skipped") {
@@ -23155,7 +23494,7 @@ async function runRemediationPipelineMissingPass(p) {
     onItemComplete,
     sourceBranchAtWorktreeCreation
   } = p;
-  const contextDir2 = path36.join(worktreeRoot, ".gluecharm", "context");
+  const contextDir2 = path37.join(worktreeRoot, ".gluecharm", "context");
   const snap = readArtefactRunSnapshot(storageContext);
   const snapOk = isWorkstationRunSnapshotForWorktree(snap, worktreeRoot);
   let byId;
@@ -23221,18 +23560,18 @@ async function runRemediationPipelineMissingPass(p) {
 
 // src/pipelines/coverage/coveragePipeline.ts
 var import_child_process5 = require("child_process");
-var fs42 = __toESM(require("fs"));
-var path38 = __toESM(require("path"));
+var fs43 = __toESM(require("fs"));
+var path39 = __toESM(require("path"));
 
 // src/analysis/coverageReferenceValidationSchemaValidate.ts
-var fs41 = __toESM(require("fs"));
-var path37 = __toESM(require("path"));
+var fs42 = __toESM(require("fs"));
+var path38 = __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 path37.join(
+  return path38.join(
     resolveRepoResourcesRoot(),
     "schemas",
     "context-lists",
@@ -23255,7 +23594,7 @@ function getValidate() {
     return compiledValidate;
   }
   const schemaPath = bundledCoverageReferenceValidationSchemaPath();
-  const schemaRaw = stripUtf8Bom4(fs41.readFileSync(schemaPath, "utf-8"));
+  const schemaRaw = stripUtf8Bom4(fs42.readFileSync(schemaPath, "utf-8"));
   const schema = JSON.parse(schemaRaw);
   const ajv2 = new import__5.default({ allErrors: true, strict: false });
   compiledValidate = ajv2.compile(schema);
@@ -23271,7 +23610,7 @@ function validateCoverageReferenceValidationData(data) {
 function readAndValidateCoverageReferenceValidationFile(jsonAbsolutePath) {
   let raw;
   try {
-    raw = stripUtf8Bom4(fs41.readFileSync(jsonAbsolutePath, "utf-8"));
+    raw = stripUtf8Bom4(fs42.readFileSync(jsonAbsolutePath, "utf-8"));
   } catch (e) {
     return {
       ok: false,
@@ -23312,8 +23651,8 @@ var DEFAULT_IGNORE_DIR_BASENAMES = [
 ];
 var GIT_LS_FILES_MAX_BUFFER = 64 * 1024 * 1024;
 function tryLoadGitNonIgnoredPathSet(repositoryRootAbs) {
-  const root = path38.resolve(repositoryRootAbs);
-  if (!fs42.existsSync(path38.join(root, ".git"))) {
+  const root = path39.resolve(repositoryRootAbs);
+  if (!fs43.existsSync(path39.join(root, ".git"))) {
     return null;
   }
   const env = { ...process.env, GIT_TERMINAL_PROMPT: "0" };
@@ -23381,12 +23720,12 @@ var REFERENCE_COVERAGE_IMAGE_EXTENSIONS = /* @__PURE__ */ new Set([
   ".emf"
 ]);
 function isReferenceCoverageExcludedImagePath(relPosix) {
-  const ext = path38.extname(relPosix).toLowerCase();
+  const ext = path39.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 = path38.basename(relPosix.replace(/\\/g, "/")).toLowerCase();
+  const base = path39.basename(relPosix.replace(/\\/g, "/")).toLowerCase();
   return REFERENCE_COVERAGE_EXCLUDED_FILE_BASENAMES.has(base);
 }
 function decodeBufferForLineCount(buf) {
@@ -23423,12 +23762,12 @@ function normalizeRepoRelativePath(repoRoot, raw) {
   if (!trimmed || trimmed.includes("\0")) {
     return null;
   }
-  const abs = path38.resolve(repoRoot, trimmed);
-  const rel = path38.relative(repoRoot, abs);
-  if (rel.startsWith("..") || path38.isAbsolute(rel)) {
+  const abs = path39.resolve(repoRoot, trimmed);
+  const rel = path39.relative(repoRoot, abs);
+  if (rel.startsWith("..") || path39.isAbsolute(rel)) {
     return null;
   }
-  return rel.split(path38.sep).join("/");
+  return rel.split(path39.sep).join("/");
 }
 function collectJsonSourceReferences(node, out) {
   if (node === null || typeof node !== "object") {
@@ -23468,12 +23807,12 @@ function extractEvidenceIndexPathCitations(body) {
 function listContextFilesRecursive(dir, acc) {
   let entries;
   try {
-    entries = fs42.readdirSync(dir, { withFileTypes: true });
+    entries = fs43.readdirSync(dir, { withFileTypes: true });
   } catch {
     return;
   }
   for (const e of entries) {
-    const full = path38.join(dir, e.name);
+    const full = path39.join(dir, e.name);
     if (e.isDirectory()) {
       listContextFilesRecursive(full, acc);
     } else if (e.isFile()) {
@@ -23486,7 +23825,7 @@ function walkRepositoryFiles(repoRoot, ignoreBasenames, maxBytes, excludedOut, g
   const walk = (dir) => {
     let entries;
     try {
-      entries = fs42.readdirSync(dir, { withFileTypes: true });
+      entries = fs43.readdirSync(dir, { withFileTypes: true });
     } catch {
       return;
     }
@@ -23494,8 +23833,8 @@ function walkRepositoryFiles(repoRoot, ignoreBasenames, maxBytes, excludedOut, g
       if (ignoreBasenames.has(e.name)) {
         continue;
       }
-      const full = path38.join(dir, e.name);
-      const rel = path38.relative(repoRoot, full).split(path38.sep).join("/");
+      const full = path39.join(dir, e.name);
+      const rel = path39.relative(repoRoot, full).split(path39.sep).join("/");
       if (rel.startsWith("..")) {
         continue;
       }
@@ -23516,7 +23855,7 @@ function walkRepositoryFiles(repoRoot, ignoreBasenames, maxBytes, excludedOut, g
         }
         let st;
         try {
-          st = fs42.statSync(full);
+          st = fs43.statSync(full);
         } catch {
           continue;
         }
@@ -23526,7 +23865,7 @@ function walkRepositoryFiles(repoRoot, ignoreBasenames, maxBytes, excludedOut, g
         }
         let buf;
         try {
-          buf = fs42.readFileSync(full);
+          buf = fs43.readFileSync(full);
         } catch {
           excludedOut.push({ path: rel, reason: "read error" });
           continue;
@@ -23546,23 +23885,23 @@ function walkRepositoryFiles(repoRoot, ignoreBasenames, maxBytes, excludedOut, g
 }
 function collectReferencesFromContext(contextDirAbs, repositoryRootAbs, warnings) {
   const references = [];
-  if (!fs42.existsSync(contextDirAbs)) {
+  if (!fs43.existsSync(contextDirAbs)) {
     warnings.push(`Context directory missing: ${contextDirAbs}`);
     return references;
   }
   const allFiles = [];
   listContextFilesRecursive(contextDirAbs, allFiles);
   for (const abs of allFiles) {
-    const ext = path38.extname(abs).toLowerCase();
-    const base = path38.basename(abs);
-    const sourceArtefact = path38.relative(contextDirAbs, abs).split(path38.sep).join("/");
+    const ext = path39.extname(abs).toLowerCase();
+    const base = path39.basename(abs);
+    const sourceArtefact = path39.relative(contextDirAbs, abs).split(path39.sep).join("/");
     if (ext === ".json") {
       if (SKIP_CONTEXT_JSON.has(base)) {
         continue;
       }
       let raw;
       try {
-        raw = fs42.readFileSync(abs, "utf-8");
+        raw = fs43.readFileSync(abs, "utf-8");
       } catch (e) {
         warnings.push(`Skip JSON (read error): ${sourceArtefact} \u2014 ${e instanceof Error ? e.message : String(e)}`);
         continue;
@@ -23593,7 +23932,7 @@ function collectReferencesFromContext(contextDirAbs, repositoryRootAbs, warnings
     if (ext === ".md") {
       let text;
       try {
-        const buf = fs42.readFileSync(abs);
+        const buf = fs43.readFileSync(abs);
         text = decodeBufferForLineCount(buf);
       } catch (e) {
         warnings.push(`Skip markdown (read/decode error): ${sourceArtefact} \u2014 ${e instanceof Error ? e.message : String(e)}`);
@@ -23637,12 +23976,12 @@ function sortReferenceRows(a, b) {
   return (a.startLine ?? 0) - (b.startLine ?? 0);
 }
 function buildCoverageReferenceValidationDocument(repositoryRootAbs, contextDirAbs, options) {
-  const repoRoot = path38.resolve(repositoryRootAbs);
+  const repoRoot = path39.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(path38.resolve(contextDirAbs), repoRoot, warnings);
+  const references = collectReferencesFromContext(path39.resolve(contextDirAbs), repoRoot, warnings);
   references.sort(sortReferenceRows);
   const referencedSet = /* @__PURE__ */ new Set();
   for (const r of references) {
@@ -23650,7 +23989,7 @@ function buildCoverageReferenceValidationDocument(repositoryRootAbs, contextDirA
   }
   const excludedFiles = [];
   const gitNonIgnoredPaths = tryLoadGitNonIgnoredPathSet(repoRoot);
-  if (fs42.existsSync(path38.join(repoRoot, ".git")) && gitNonIgnoredPaths === null) {
+  if (fs43.existsSync(path39.join(repoRoot, ".git")) && gitNonIgnoredPaths === null) {
     warnings.push(
       "Repository has .git but git ls-files failed or git is unavailable; .gitignore / exclude-standard not applied."
     );
@@ -23699,12 +24038,12 @@ function buildCoverageReferenceValidationDocument(repositoryRootAbs, contextDirA
   return { document: doc, warnings };
 }
 function runCoveragePipeline(opts) {
-  const repoRoot = path38.resolve(opts.repositoryRootAbs);
-  const contextDir2 = path38.resolve(opts.contextDirAbs);
-  if (!fs42.existsSync(repoRoot)) {
+  const repoRoot = path39.resolve(opts.repositoryRootAbs);
+  const contextDir2 = path39.resolve(opts.contextDirAbs);
+  if (!fs43.existsSync(repoRoot)) {
     return { ok: false, error: `Repository root does not exist: ${repoRoot}` };
   }
-  if (!fs42.existsSync(contextDir2)) {
+  if (!fs43.existsSync(contextDir2)) {
     return {
       ok: false,
       error: `Missing .gluecharm/context: ${contextDir2}`
@@ -23722,11 +24061,11 @@ ${schemaCheck.errors.join("\n")}`,
       warnings
     };
   }
-  const outPath = path38.join(contextDir2, COVERAGE_REFERENCE_VALIDATION_BASENAME);
+  const outPath = path39.join(contextDir2, COVERAGE_REFERENCE_VALIDATION_BASENAME);
   if (opts.write) {
     try {
       const payload = stableStringifyCoverageDocument(document);
-      fs42.writeFileSync(outPath, payload, "utf-8");
+      fs43.writeFileSync(outPath, payload, "utf-8");
     } catch (e) {
       return {
         ok: false,
@@ -23740,12 +24079,12 @@ ${schemaCheck.errors.join("\n")}`,
 
 // src/pipelines/remediation/zeroReferenceWorkstationChain.ts
 var crypto = __toESM(require("crypto"));
-var fs44 = __toESM(require("fs"));
-var path40 = __toESM(require("path"));
+var fs45 = __toESM(require("fs"));
+var path41 = __toESM(require("path"));
 
 // src/analysis/zeroReferenceRemediationSchemaValidate.ts
-var fs43 = __toESM(require("fs"));
-var path39 = __toESM(require("path"));
+var fs44 = __toESM(require("fs"));
+var path40 = __toESM(require("path"));
 var import__6 = __toESM(require__());
 function stripUtf8Bom5(s) {
   return s.length > 0 && s.charCodeAt(0) === 65279 ? s.slice(1) : s;
@@ -23765,8 +24104,8 @@ function formatAjvErrors6(errors) {
 }
 var ajv = new import__6.default({ allErrors: true, strict: false });
 function compileSchema(basename17) {
-  const schemaPath = path39.join(schemasDir(), basename17);
-  const schemaRaw = stripUtf8Bom5(fs43.readFileSync(schemaPath, "utf-8"));
+  const schemaPath = path40.join(schemasDir(), basename17);
+  const schemaRaw = stripUtf8Bom5(fs44.readFileSync(schemaPath, "utf-8"));
   const schema = JSON.parse(schemaRaw);
   return ajv.compile(schema);
 }
@@ -23810,7 +24149,7 @@ var ZERO_REF_STAGING_JSON_TOTAL_ATTEMPTS = 5;
 var ZERO_REF_STAGING_FILE_PREVIEW_MAX_CHARS = 6e3;
 function readStagingOutputPreview(outAbs) {
   try {
-    const s = fs44.readFileSync(outAbs, "utf-8");
+    const s = fs45.readFileSync(outAbs, "utf-8");
     if (s.length <= ZERO_REF_STAGING_FILE_PREVIEW_MAX_CHARS) {
       return s;
     }
@@ -24060,17 +24399,17 @@ function expandArgvTemplate4(template, vars) {
   });
 }
 function schemaRef2(worktreeRoot, schemaBasename) {
-  return path40.join(worktreeRoot, ".opencode", "schemas", "context-lists", schemaBasename);
+  return path41.join(worktreeRoot, ".opencode", "schemas", "context-lists", schemaBasename);
 }
 function stagingDir(contextDirAbs) {
-  return path40.join(contextDirAbs, "_zero-ref-staging");
+  return path41.join(contextDirAbs, "_zero-ref-staging");
 }
 function stagingPathForTarget(contextDirAbs, kind, targetFilePathPosix) {
   const h = crypto.createHash("sha256").update(targetFilePathPosix, "utf8").digest("hex").slice(0, 16);
-  return path40.join(stagingDir(contextDirAbs), `${kind}-${h}.json`);
+  return path41.join(stagingDir(contextDirAbs), `${kind}-${h}.json`);
 }
 function readNonReferencedFilesFromRepositoryRoot(repositoryRootAbs) {
-  const p = path40.join(repositoryRootAbs, ".gluecharm", "context", "coverage-reference-validation.json");
+  const p = path41.join(repositoryRootAbs, ".gluecharm", "context", "coverage-reference-validation.json");
   const r = readAndValidateCoverageReferenceValidationFile(p);
   if (!r.ok) {
     return { ok: false, error: r.errors.join("; ") };
@@ -24093,14 +24432,14 @@ function readNonReferencedFilesFromRepositoryRoot(repositoryRootAbs) {
   return { ok: true, paths, ...generatedAt ? { generatedAt } : {} };
 }
 function readOrInitRoutingDoc(routingAbs, coverageReferenceGeneratedAt) {
-  if (!fs44.existsSync(routingAbs)) {
+  if (!fs45.existsSync(routingAbs)) {
     return {
       schemaVersion: ROUTING_SCHEMA_VERSION,
       ...coverageReferenceGeneratedAt ? { coverageReferenceGeneratedAt } : {},
       records: {}
     };
   }
-  const raw = fs44.readFileSync(routingAbs, "utf-8");
+  const raw = fs45.readFileSync(routingAbs, "utf-8");
   const data = JSON.parse(raw);
   if (!data.records || typeof data.records !== "object") {
     return {
@@ -24112,10 +24451,10 @@ function readOrInitRoutingDoc(routingAbs, coverageReferenceGeneratedAt) {
   return data;
 }
 function readOrInitTriageDoc(triageAbs) {
-  if (!fs44.existsSync(triageAbs)) {
+  if (!fs45.existsSync(triageAbs)) {
     return { schemaVersion: TRIAGE_SCHEMA_VERSION, records: {} };
   }
-  const raw = fs44.readFileSync(triageAbs, "utf-8");
+  const raw = fs45.readFileSync(triageAbs, "utf-8");
   const data = JSON.parse(raw);
   if (!data.records || typeof data.records !== "object") {
     return { schemaVersion: TRIAGE_SCHEMA_VERSION, records: {} };
@@ -24163,10 +24502,10 @@ function slugifyFeatureLabel(s) {
   return t.length > 0 ? t : "feature";
 }
 function lineCountRepoFile(worktreeRootAbs, relPosix) {
-  const abs = path40.join(worktreeRootAbs, ...relPosix.split("/"));
+  const abs = path41.join(worktreeRootAbs, ...relPosix.split("/"));
   let buf;
   try {
-    buf = fs44.readFileSync(abs);
+    buf = fs45.readFileSync(abs);
   } catch {
     return 1;
   }
@@ -24218,9 +24557,9 @@ var LIST_STEP_HINT = {
 };
 async function applyCoordinationListTriageMerge(input) {
   const cfg = LIST_MERGE_CFG[input.listKind];
-  const listPath = path40.join(input.contextDirAbs, cfg.listBasename);
-  const schemaPath = path40.join(resolveContextListSchemasDir(), cfg.schemaBasename);
-  if (!fs44.existsSync(listPath)) {
+  const listPath = path41.join(input.contextDirAbs, cfg.listBasename);
+  const schemaPath = path41.join(resolveContextListSchemasDir(), cfg.schemaBasename);
+  if (!fs45.existsSync(listPath)) {
     return {
       ok: false,
       message: `${cfg.listBasename} not found \u2014 run coordination step ${LIST_STEP_HINT[input.listKind]} first.`
@@ -24231,7 +24570,7 @@ async function applyCoordinationListTriageMerge(input) {
     return withCoordinationListFileLock(listPath, {}, async () => {
       let raw;
       try {
-        raw = fs44.readFileSync(listPath, "utf-8");
+        raw = fs45.readFileSync(listPath, "utf-8");
       } catch (e) {
         return { ok: false, message: e instanceof Error ? e.message : String(e) };
       }
@@ -24299,7 +24638,7 @@ async function applyCoordinationListTriageMerge(input) {
       });
       const tmp = `${listPath}.tmp.${process.pid}`;
       try {
-        fs44.writeFileSync(tmp, `${JSON.stringify(doc, null, 2)}
+        fs45.writeFileSync(tmp, `${JSON.stringify(doc, null, 2)}
 `, "utf-8");
       } catch (e) {
         return { ok: false, message: e instanceof Error ? e.message : String(e) };
@@ -24307,13 +24646,13 @@ async function applyCoordinationListTriageMerge(input) {
       const v = validateCoordinationListJson(tmp, schemaPath);
       if (!v.ok) {
         try {
-          fs44.unlinkSync(tmp);
+          fs45.unlinkSync(tmp);
         } catch {
         }
         return { ok: false, message: `${cfg.listBasename} validation failed: ${JSON.stringify(v.failure)}` };
       }
       try {
-        fs44.renameSync(tmp, listPath);
+        fs45.renameSync(tmp, listPath);
       } catch (e) {
         return { ok: false, message: e instanceof Error ? e.message : String(e) };
       }
@@ -24323,10 +24662,10 @@ async function applyCoordinationListTriageMerge(input) {
 }
 async function runClassifierAgent(common, contextDirAbs, targetFilePathPosix, workspaceLabel) {
   const outAbs = stagingPathForTarget(contextDirAbs, "classifier", targetFilePathPosix);
-  fs44.mkdirSync(path40.dirname(outAbs), { recursive: true });
-  const runDir = path40.join(common.worktreeRoot, ".opencode", "_run");
-  fs44.mkdirSync(runDir, { recursive: true });
-  const outputBasename = path40.basename(outAbs);
+  fs45.mkdirSync(path41.dirname(outAbs), { recursive: true });
+  const runDir = path41.join(common.worktreeRoot, ".opencode", "_run");
+  fs45.mkdirSync(runDir, { recursive: true });
+  const outputBasename = path41.basename(outAbs);
   const listTaskDescription = [
     `Target file (repo-relative, POSIX): **${targetFilePathPosix}**`,
     `Workspace label hint: **${workspaceLabel}**.`,
@@ -24362,8 +24701,8 @@ async function runClassifierAgent(common, contextDirAbs, targetFilePathPosix, wo
       parentContextBlock: "",
       ...repairAppendix ? { repairAppendix } : {}
     });
-    const promptPath = path40.join(runDir, `zero-ref-classify-a${attempt}-${Date.now()}.prompt.txt`);
-    fs44.writeFileSync(promptPath, body, "utf-8");
+    const promptPath = path41.join(runDir, `zero-ref-classify-a${attempt}-${Date.now()}.prompt.txt`);
+    fs45.writeFileSync(promptPath, body, "utf-8");
     const argv = expandArgvTemplate4(common.argvTemplate, {
       promptFile: promptPath,
       agentId: ZERO_REF_CLASSIFY_AGENT_STEM,
@@ -24390,7 +24729,7 @@ async function runClassifierAgent(common, contextDirAbs, targetFilePathPosix, wo
     const canRetry = attempt < ZERO_REF_STAGING_JSON_TOTAL_ATTEMPTS - 1;
     let st;
     try {
-      st = fs44.statSync(outAbs);
+      st = fs45.statSync(outAbs);
     } catch {
       st = void 0;
     }
@@ -24412,7 +24751,7 @@ async function runClassifierAgent(common, contextDirAbs, targetFilePathPosix, wo
     }
     let parsed;
     try {
-      parsed = JSON.parse(fs44.readFileSync(outAbs, "utf-8"));
+      parsed = JSON.parse(fs45.readFileSync(outAbs, "utf-8"));
     } catch (e) {
       const msg = e instanceof Error ? e.message : String(e);
       lastFailureMessage = `Classifier output not valid JSON: ${msg}`;
@@ -24494,10 +24833,10 @@ var TRIAGE_SCOPE_META = {
 };
 async function runMarkdownReferenceAgent(common, contextDirAbs, targetFilePathPosix, routingSummary, which) {
   const mdBasename = which === "project" ? "project.md" : "architecture.md";
-  const mdAbs = path40.join(contextDirAbs, mdBasename);
+  const mdAbs = path41.join(contextDirAbs, mdBasename);
   const agentStem = which === "project" ? ZERO_REF_ADD_REF_PROJECT_AGENT_STEM : ZERO_REF_ADD_REF_ARCH_AGENT_STEM;
-  const runDir = path40.join(common.worktreeRoot, ".opencode", "_run");
-  fs44.mkdirSync(runDir, { recursive: true });
+  const runDir = path41.join(common.worktreeRoot, ".opencode", "_run");
+  fs45.mkdirSync(runDir, { recursive: true });
   const lines = [
     `# SRS-30 \u2014 Add reference to ${mdBasename}`,
     ``,
@@ -24512,8 +24851,8 @@ 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 = path40.join(runDir, `zero-ref-md-${which}-${Date.now()}.prompt.txt`);
-  fs44.writeFileSync(promptPath, lines.join("\n"), "utf-8");
+  const promptPath = path41.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,
     agentId: agentStem,
@@ -24540,10 +24879,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);
-  fs44.mkdirSync(path40.dirname(outAbs), { recursive: true });
-  const runDir = path40.join(common.worktreeRoot, ".opencode", "_run");
-  fs44.mkdirSync(runDir, { recursive: true });
-  const outputBasename = path40.basename(outAbs);
+  fs45.mkdirSync(path41.dirname(outAbs), { recursive: true });
+  const runDir = path41.join(common.worktreeRoot, ".opencode", "_run");
+  fs45.mkdirSync(runDir, { recursive: true });
+  const outputBasename = path41.basename(outAbs);
   const listTaskDescription = [
     `Target file: **${targetFilePathPosix}** (${workspaceLabel})`,
     "**Classifier summary:**",
@@ -24573,8 +24912,8 @@ async function runCoordinationTriageAgent(common, contextDirAbs, targetFilePathP
       parentContextBlock: "",
       ...repairAppendix ? { repairAppendix } : {}
     });
-    const promptPath = path40.join(runDir, `zero-ref-triage-a${attempt}-${Date.now()}.prompt.txt`);
-    fs44.writeFileSync(promptPath, body, "utf-8");
+    const promptPath = path41.join(runDir, `zero-ref-triage-a${attempt}-${Date.now()}.prompt.txt`);
+    fs45.writeFileSync(promptPath, body, "utf-8");
     const argv = expandArgvTemplate4(common.argvTemplate, {
       promptFile: promptPath,
       agentId: ZERO_REF_TRIAGE_COORD_AGENT_STEM,
@@ -24601,7 +24940,7 @@ async function runCoordinationTriageAgent(common, contextDirAbs, targetFilePathP
     const canRetry = attempt < ZERO_REF_STAGING_JSON_TOTAL_ATTEMPTS - 1;
     let st;
     try {
-      st = fs44.statSync(outAbs);
+      st = fs45.statSync(outAbs);
     } catch {
       st = void 0;
     }
@@ -24623,7 +24962,7 @@ async function runCoordinationTriageAgent(common, contextDirAbs, targetFilePathP
     }
     let parsed;
     try {
-      parsed = JSON.parse(fs44.readFileSync(outAbs, "utf-8"));
+      parsed = JSON.parse(fs45.readFileSync(outAbs, "utf-8"));
     } catch (e) {
       const msg = e instanceof Error ? e.message : String(e);
       lastFailureMessage = `Triage output not valid JSON: ${msg}`;
@@ -24679,7 +25018,7 @@ async function runCoordinationTriageAgent(common, contextDirAbs, targetFilePathP
       return { ok: false, message: lastFailureMessage, stagingPath: outAbs };
     }
     try {
-      fs44.writeFileSync(outAbs, `${JSON.stringify(parsed, null, 2)}
+      fs45.writeFileSync(outAbs, `${JSON.stringify(parsed, null, 2)}
 `, "utf-8");
     } catch {
     }
@@ -24688,8 +25027,8 @@ async function runCoordinationTriageAgent(common, contextDirAbs, targetFilePathP
   return { ok: false, message: lastFailureMessage, stagingPath: outAbs };
 }
 async function runOneUnreferencedFilePipeline(p) {
-  const routingAbs = path40.join(p.contextDirAbs, ZERO_REF_ROUTING_BASENAME);
-  const triageAbs = path40.join(p.contextDirAbs, ZERO_REF_TRIAGE_BASENAME);
+  const routingAbs = path41.join(p.contextDirAbs, ZERO_REF_ROUTING_BASENAME);
+  const triageAbs = path41.join(p.contextDirAbs, ZERO_REF_TRIAGE_BASENAME);
   const key = p.targetFilePathPosix;
   const cr = await runClassifierAgent(p, p.contextDirAbs, key, p.workspaceLabel);
   if (!cr.ok) {
@@ -24697,7 +25036,7 @@ async function runOneUnreferencedFilePipeline(p) {
   }
   let stagingParsed;
   try {
-    stagingParsed = JSON.parse(fs44.readFileSync(cr.stagingPath, "utf-8"));
+    stagingParsed = JSON.parse(fs45.readFileSync(cr.stagingPath, "utf-8"));
   } catch (e) {
     return { ok: false, message: String(e) };
   }
@@ -24713,8 +25052,8 @@ async function runOneUnreferencedFilePipeline(p) {
     if (!s.ok) {
       throw new Error(s.errors.join("; "));
     }
-    fs44.mkdirSync(path40.dirname(routingAbs), { recursive: true });
-    fs44.writeFileSync(routingAbs, s.json, "utf-8");
+    fs45.mkdirSync(path41.dirname(routingAbs), { recursive: true });
+    fs45.writeFileSync(routingAbs, s.json, "utf-8");
   });
   const routing = stagingParsed.routing;
   const routingSummary = typeof stagingParsed.projectRelationSummary === "string" ? stagingParsed.projectRelationSummary : "";
@@ -24745,7 +25084,7 @@ async function runOneUnreferencedFilePipeline(p) {
   }
   let triageParsed;
   try {
-    triageParsed = JSON.parse(fs44.readFileSync(tr.stagingPath, "utf-8"));
+    triageParsed = JSON.parse(fs45.readFileSync(tr.stagingPath, "utf-8"));
   } catch (e) {
     return { ok: false, message: String(e) };
   }
@@ -24762,8 +25101,8 @@ async function runOneUnreferencedFilePipeline(p) {
     if (!s.ok) {
       throw new Error(s.errors.join("; "));
     }
-    fs44.mkdirSync(path40.dirname(triageAbs), { recursive: true });
-    fs44.writeFileSync(triageAbs, s.json, "utf-8");
+    fs45.mkdirSync(path41.dirname(triageAbs), { recursive: true });
+    fs45.writeFileSync(triageAbs, s.json, "utf-8");
   });
   const decision = triageParsed.decision;
   if (decision === "new_item" || decision === "enrich_existing") {
@@ -24790,11 +25129,11 @@ async function runOneUnreferencedFilePipeline(p) {
   return { ok: true, message: `Triage ${decision}.` };
 }
 async function runRemediationPipelineZeroRefPass(p) {
-  const contextDirAbs = path40.join(p.worktreeRoot, ".gluecharm", "context");
+  const contextDirAbs = path41.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 = path40.basename(p.worktreeRoot);
+  const workspaceLabel = path41.basename(p.worktreeRoot);
   const routingMutex = new AsyncMutex();
   const triageMutex = new AsyncMutex();
   const paths = [...p.paths];
@@ -24851,8 +25190,8 @@ async function runRemediationPipelineZeroRefPass(p) {
 }
 
 // src/pipelines/coverage/coverageExecutionReport.ts
-var fs45 = __toESM(require("fs"));
-var path41 = __toESM(require("path"));
+var fs46 = __toESM(require("fs"));
+var path42 = __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();
@@ -24948,7 +25287,7 @@ function collectNoActionRowsFromRoutingDoc(doc) {
   return rows;
 }
 function readRoutingDocFromDisk(routingAbs) {
-  if (!fs45.existsSync(routingAbs)) {
+  if (!fs46.existsSync(routingAbs)) {
     return {
       ok: true,
       doc: { schemaVersion: "1", records: {} }
@@ -24956,7 +25295,7 @@ function readRoutingDocFromDisk(routingAbs) {
   }
   let raw;
   try {
-    raw = fs45.readFileSync(routingAbs, "utf-8");
+    raw = fs46.readFileSync(routingAbs, "utf-8");
   } catch (e) {
     return { ok: false, error: e instanceof Error ? e.message : String(e) };
   }
@@ -24976,10 +25315,10 @@ async function runCoverageExecutionReport(p) {
   if (p.abortSignal?.aborted) {
     return { ok: false, error: "Stopped.", cancelled: true };
   }
-  const contextDirAbs = path41.join(p.repositoryRootAbs, ".gluecharm", "context");
-  const coverageAbs = path41.join(contextDirAbs, "coverage-reference-validation.json");
-  const routingAbs = path41.join(contextDirAbs, "zero-reference-routing.json");
-  const outAbs = path41.join(contextDirAbs, REFERENCE_COVERAGE_EXECUTION_REPORT_BASENAME);
+  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 cov = readAndValidateCoverageReferenceValidationFile(coverageAbs);
   if (!cov.ok) {
     return { ok: false, error: `Coverage JSON: ${cov.errors.join("; ")}` };
@@ -24996,20 +25335,20 @@ async function runCoverageExecutionReport(p) {
   }
   let previous;
   try {
-    if (fs45.existsSync(outAbs)) {
-      previous = fs45.readFileSync(outAbs, "utf-8");
+    if (fs46.existsSync(outAbs)) {
+      previous = fs46.readFileSync(outAbs, "utf-8");
     }
   } catch {
     previous = void 0;
   }
   try {
-    fs45.mkdirSync(path41.dirname(outAbs), { recursive: true });
-    fs45.writeFileSync(outAbs, md, "utf-8");
+    fs46.mkdirSync(path42.dirname(outAbs), { recursive: true });
+    fs46.writeFileSync(outAbs, md, "utf-8");
   } catch (e) {
     const msg = e instanceof Error ? e.message : String(e);
     if (previous !== void 0) {
       try {
-        fs45.writeFileSync(outAbs, previous, "utf-8");
+        fs46.writeFileSync(outAbs, previous, "utf-8");
       } catch {
       }
     }
@@ -25020,8 +25359,8 @@ async function runCoverageExecutionReport(p) {
 }
 
 // src/gluecharm/minimalGluecharmLayout.ts
-var fs46 = __toESM(require("node:fs"));
-var path42 = __toESM(require("node:path"));
+var fs47 = __toESM(require("node:fs"));
+var path43 = __toESM(require("node:path"));
 var MINIMAL_GLUECHARM_RELATIVE_DIRS = [
   [".gluecharm", "docs", "srs"],
   [".gluecharm", "content"],
@@ -25029,11 +25368,11 @@ var MINIMAL_GLUECHARM_RELATIVE_DIRS = [
   [".gluecharm", "context"]
 ];
 function ensureMinimalGluecharmLayoutNode(repoRootAbs) {
-  const root = path42.resolve(repoRootAbs);
+  const root = path43.resolve(repoRootAbs);
   for (const segments of MINIMAL_GLUECHARM_RELATIVE_DIRS) {
-    const dir = path42.join(root, ...segments);
+    const dir = path43.join(root, ...segments);
     try {
-      fs46.mkdirSync(dir, { recursive: true });
+      fs47.mkdirSync(dir, { recursive: true });
     } catch (e) {
       const err = e;
       const msg = e instanceof Error ? e.message : String(e);
@@ -25148,6 +25487,7 @@ function buildFactoryPipelineRegistry(cb) {
 // src/factory/generateContextFactoryHeadlessHost.ts
 function buildFactoryDepsHeadless(input) {
   const { storageContext, repoRoot, agentsDirFs, buildOpenCodeOptions, log, signal, macroConfig } = input;
+  const inPlace = input.inPlace === true;
   let adHocWorktree;
   let macroFinalize;
   let macroSourceBranch;
@@ -25162,7 +25502,7 @@ function buildFactoryDepsHeadless(input) {
       if (!layout.ok) {
         return { ok: false, error: layout.error };
       }
-      const ctxDir = path43.join(ar, ".gluecharm", "context");
+      const ctxDir = path44.join(ar, ".gluecharm", "context");
       const snap = readArtefactRunSnapshot(storageContext);
       const rows = listMissingWorkstations(ctxDir, ar, snap);
       if (rows.length === 0) {
@@ -25176,7 +25516,7 @@ function buildFactoryDepsHeadless(input) {
         storageContext,
         repositoryRoot: repoRoot,
         worktreeRoot: ar,
-        workspaceLabel: path43.basename(ar),
+        workspaceLabel: path44.basename(ar),
         oc: {
           ...oc,
           aceEnabled: getAceAnalysisEnabledForCheckout(ar),
@@ -25204,7 +25544,7 @@ function buildFactoryDepsHeadless(input) {
     }
     try {
       await startPipelineRun(storageContext, repoRoot);
-      const folderName = path43.basename(repoRoot);
+      const folderName = path44.basename(repoRoot);
       const oc = buildOpenCodeOptions(handle.path);
       const result = await runSynthesisPipelineDrainFromPreparedWorktree(
         storageContext,
@@ -25261,7 +25601,7 @@ function buildFactoryDepsHeadless(input) {
     if (!ar) {
       return 0;
     }
-    const ctxDir = path43.join(ar, ".gluecharm", "context");
+    const ctxDir = path44.join(ar, ".gluecharm", "context");
     const snap = readArtefactRunSnapshot(storageContext);
     return listMissingWorkstations(ctxDir, ar, snap).length;
   };
@@ -25274,7 +25614,7 @@ function buildFactoryDepsHeadless(input) {
     if (!layout.ok) {
       return { ok: false, message: layout.error };
     }
-    const contextDir2 = path43.join(ar, ".gluecharm", "context");
+    const contextDir2 = path44.join(ar, ".gluecharm", "context");
     log(`[factory] reference coverage (worktree) \u2014 ${ar}`);
     const res = runCoveragePipeline({
       repositoryRootAbs: ar,
@@ -25334,7 +25674,7 @@ function buildFactoryDepsHeadless(input) {
       diagnosticLog: log
     });
     if (res.ok) {
-      return { ok: true, message: `Report: ${path43.basename(res.outputAbsolutePath)}` };
+      return { ok: true, message: `Report: ${path44.basename(res.outputAbsolutePath)}` };
     }
     if (res.cancelled) {
       return { ok: false, cancelled: true, message: "Report generation stopped." };
@@ -25350,7 +25690,7 @@ function buildFactoryDepsHeadless(input) {
     if (!lmLayout.ok) {
       return { ok: false, message: lmLayout.error };
     }
-    const contextDir2 = path43.join(snap.adHocWorktreePath, ".gluecharm", "context");
+    const contextDir2 = path44.join(snap.adHocWorktreePath, ".gluecharm", "context");
     const linkGraph = runLinkMappingPipeline(contextDir2, { log });
     if (!linkGraph.ok) {
       return { ok: false, message: linkGraph.error };
@@ -25366,7 +25706,7 @@ function buildFactoryDepsHeadless(input) {
     if (!idxLayout.ok) {
       return { ok: false, message: idxLayout.error };
     }
-    const contextDir2 = path43.join(snap.adHocWorktreePath, ".gluecharm", "context");
+    const contextDir2 = path44.join(snap.adHocWorktreePath, ".gluecharm", "context");
     try {
       writeIndexApplicationContext(contextDir2, void 0, {
         sourceBranchAtWorktreeCreation: snap.adHocSourceBranchAtCreation
@@ -25406,6 +25746,12 @@ function buildFactoryDepsHeadless(input) {
   return {
     signal,
     factoryLog: log,
+    readinessLog: (line) => {
+      process.stderr.write(`${line}
+`);
+    },
+    ...inPlace ? { analysisInPlace: true } : {},
+    readiness: input.readiness,
     config: { ...macroConfig, ...input.synthesisOnly ? { synthesisOnly: true } : {} },
     sleep: (ms) => sleepUntilAborted(ms, signal),
     post: (payload) => {
@@ -25415,14 +25761,14 @@ function buildFactoryDepsHeadless(input) {
     },
     runPrepareAnalysisWorktree: async (resume) => {
       if (resume) {
-        if (adHocWorktree && fs47.existsSync(path43.join(adHocWorktree.path, ".git"))) {
+        if (adHocWorktree && fs48.existsSync(path44.join(adHocWorktree.path, ".git"))) {
           return { ok: true };
         }
         const snap = readAnalysisWorkspaceSnapshot(storageContext);
         const wtPath = snap?.adHocWorktreePath?.trim();
         const repo = snap?.adHocRepositoryRoot?.trim() || repoRoot;
-        if (wtPath && fs47.existsSync(path43.join(wtPath, ".git"))) {
-          adHocWorktree = attachWorktreeHandle(wtPath, repo);
+        if (wtPath && fs48.existsSync(path44.join(wtPath, ".git"))) {
+          adHocWorktree = resolveAnalysisCheckoutHandle(wtPath, repo);
           macroSourceBranch = snap?.adHocSourceBranchAtCreation;
           macroFinalize = () => {
             try {
@@ -25444,8 +25790,10 @@ function buildFactoryDepsHeadless(input) {
       }
       macroFinalize = void 0;
       macroSourceBranch = void 0;
-      log(`[factory] create analysis worktree \u2014 ${(/* @__PURE__ */ new Date()).toISOString()}`);
-      const prep = await prepareSynthesisWorktree(storageContext, repoRoot, log);
+      log(
+        inPlace ? `[factory] in-place analysis checkout \u2014 ${(/* @__PURE__ */ new Date()).toISOString()}` : `[factory] create analysis worktree \u2014 ${(/* @__PURE__ */ new Date()).toISOString()}`
+      );
+      const prep = await prepareSynthesisWorktree(storageContext, repoRoot, log, { inPlace });
       if (!prep.ok) {
         prep.finalize?.();
         return { ok: false, error: prep.error };
@@ -25637,11 +25985,11 @@ function stderrLinesForFactoryFailures(failures, exitCode) {
 }
 
 // src/factory/updateContext/runUpdateContextFactory.ts
-var path48 = __toESM(require("node:path"));
+var path49 = __toESM(require("node:path"));
 
 // src/factory/updateContext/updateContextBaseline.ts
-var fs48 = __toESM(require("node:fs"));
-var path44 = __toESM(require("node:path"));
+var fs49 = __toESM(require("node:fs"));
+var path45 = __toESM(require("node:path"));
 function isValidIso(s) {
   const t = Date.parse(s);
   return Number.isFinite(t);
@@ -25651,17 +25999,17 @@ function maxMtimeRegularFilesUnderDir(dirAbs) {
   const walk = (d) => {
     let entries;
     try {
-      entries = fs48.readdirSync(d, { withFileTypes: true });
+      entries = fs49.readdirSync(d, { withFileTypes: true });
     } catch {
       return;
     }
     for (const e of entries) {
-      const p = path44.join(d, e.name);
+      const p = path45.join(d, e.name);
       if (e.isDirectory()) {
         walk(p);
       } else if (e.isFile()) {
         try {
-          const st = fs48.statSync(p);
+          const st = fs49.statSync(p);
           const m = st.mtimeMs;
           if (best === null || m > best) {
             best = m;
@@ -25682,8 +26030,8 @@ function resolveUpdateContextBaseline(repoRootAbs, repoConfig) {
   if (last.length > 0 && isValidIso(last)) {
     return { baselineIsoUtc: new Date(last).toISOString(), source: "lastRunAt" };
   }
-  const ctxDir = path44.join(repoRootAbs, ".gluecharm", "context");
-  if (!fs48.existsSync(ctxDir)) {
+  const ctxDir = path45.join(repoRootAbs, ".gluecharm", "context");
+  if (!fs49.existsSync(ctxDir)) {
     return null;
   }
   const maxMs = maxMtimeRegularFilesUnderDir(ctxDir);
@@ -25706,8 +26054,8 @@ function persistUpdateContextLastRunAt(repoRootAbs, isoUtc) {
 
 // src/factory/updateContext/updateContextGitWindow.ts
 var import_node_child_process3 = require("node:child_process");
-var fs49 = __toESM(require("node:fs"));
-var path45 = __toESM(require("node:path"));
+var fs50 = __toESM(require("node:fs"));
+var path46 = __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], {
@@ -25731,8 +26079,8 @@ function parseGitLogIso(line) {
   return { hash, iso };
 }
 function discoverCommitWindowAndTouchedPaths(repoRootAbs, baselineIsoUtc) {
-  const root = path45.resolve(repoRootAbs);
-  if (!fs49.existsSync(path45.join(root, ".git"))) {
+  const root = path46.resolve(repoRootAbs);
+  if (!fs50.existsSync(path46.join(root, ".git"))) {
     return { ok: false, error: "Not a git repository (missing .git)." };
   }
   const baselineMs = Date.parse(baselineIsoUtc);
@@ -25791,13 +26139,13 @@ function discoverCommitWindowAndTouchedPaths(repoRootAbs, baselineIsoUtc) {
   };
 }
 function filterPathsExistingInWorktree(worktreeRootAbs, pathsPosix) {
-  const root = path45.resolve(worktreeRootAbs);
+  const root = path46.resolve(worktreeRootAbs);
   const out = [];
   for (const p of pathsPosix) {
     const rel = p.replace(/\\/g, "/");
-    const abs = path45.join(root, ...rel.split("/"));
+    const abs = path46.join(root, ...rel.split("/"));
     try {
-      if (fs49.existsSync(abs) && fs49.statSync(abs).isFile()) {
+      if (fs50.existsSync(abs) && fs50.statSync(abs).isFile()) {
         out.push(rel);
       }
     } catch {
@@ -25807,8 +26155,8 @@ function filterPathsExistingInWorktree(worktreeRootAbs, pathsPosix) {
 }
 
 // src/factory/updateContext/updateContextReport.ts
-var fs50 = __toESM(require("node:fs"));
-var path46 = __toESM(require("node:path"));
+var fs51 = __toESM(require("node:fs"));
+var path47 = __toESM(require("node:path"));
 var CHANGES_SINCE_DATE_BASENAME = "changes-since-date.md";
 function renderChangesSinceDateMarkdown(p) {
   const lines = [
@@ -25849,9 +26197,9 @@ function renderChangesSinceDateMarkdown(p) {
 }
 function writeChangesSinceDateReport(contextDirAbs, body) {
   try {
-    fs50.mkdirSync(contextDirAbs, { recursive: true });
-    const target = path46.join(contextDirAbs, CHANGES_SINCE_DATE_BASENAME);
-    fs50.writeFileSync(target, body, "utf-8");
+    fs51.mkdirSync(contextDirAbs, { recursive: true });
+    const target = path47.join(contextDirAbs, CHANGES_SINCE_DATE_BASENAME);
+    fs51.writeFileSync(target, body, "utf-8");
     return { ok: true };
   } catch (e) {
     return { ok: false, error: e instanceof Error ? e.message : String(e) };
@@ -25859,13 +26207,13 @@ function writeChangesSinceDateReport(contextDirAbs, body) {
 }
 
 // src/factory/updateContext/updateContextSeedCheck.ts
-var fs51 = __toESM(require("node:fs"));
-var path47 = __toESM(require("node:path"));
+var fs52 = __toESM(require("node:fs"));
+var path48 = __toESM(require("node:path"));
 var INDEX_BASENAME = "index-application-context.json";
 var CHANGES_REPORT = "changes-since-date.md";
 function tryParseJsonFile(abs) {
   try {
-    const raw = fs51.readFileSync(abs, "utf-8");
+    const raw = fs52.readFileSync(abs, "utf-8");
     JSON.parse(raw);
     return true;
   } catch {
@@ -25873,16 +26221,16 @@ function tryParseJsonFile(abs) {
   }
 }
 function isWorktreeContextSeeded(contextDirAbs) {
-  if (!fs51.existsSync(contextDirAbs)) {
+  if (!fs52.existsSync(contextDirAbs)) {
     return false;
   }
-  const indexAbs = path47.join(contextDirAbs, INDEX_BASENAME);
-  if (fs51.existsSync(indexAbs) && fs51.statSync(indexAbs).isFile() && tryParseJsonFile(indexAbs)) {
+  const indexAbs = path48.join(contextDirAbs, INDEX_BASENAME);
+  if (fs52.existsSync(indexAbs) && fs52.statSync(indexAbs).isFile() && tryParseJsonFile(indexAbs)) {
     return true;
   }
   let names;
   try {
-    names = fs51.readdirSync(contextDirAbs);
+    names = fs52.readdirSync(contextDirAbs);
   } catch {
     return false;
   }
@@ -25894,9 +26242,9 @@ function isWorktreeContextSeeded(contextDirAbs) {
     if (!name.endsWith(".md") && !name.endsWith(".json")) {
       continue;
     }
-    const p = path47.join(contextDirAbs, name);
+    const p = path48.join(contextDirAbs, name);
     try {
-      if (fs51.statSync(p).isFile()) {
+      if (fs52.statSync(p).isFile()) {
         distinct.add(name);
       }
     } catch {
@@ -25908,12 +26256,14 @@ function isWorktreeContextSeeded(contextDirAbs) {
 // src/factory/updateContext/runUpdateContextFactory.ts
 var REMEDIATION_CHUNK_MAX = 40;
 function contextDirUnderRoot(wtRoot) {
-  return path48.join(wtRoot, ".gluecharm", "context");
+  return path49.join(wtRoot, ".gluecharm", "context");
 }
 async function runUpdateContextFactory(deps) {
+  const inPlace = deps.inPlace === true;
   const baseMeta = {
     command: "update_context",
-    uploadRequested: false
+    uploadRequested: false,
+    ...inPlace ? { analysisInPlace: true } : {}
   };
   const baseline = resolveUpdateContextBaseline(deps.repoRootAbs, deps.repoConfig);
   if (!baseline) {
@@ -25938,8 +26288,42 @@ async function runUpdateContextFactory(deps) {
     };
   }
   const shortNoCommits = gitWin.commitsInOrder.length === 0;
+  const cliVersion = deps.cliVersion?.trim() || "0.0.0";
+  const readinessCtx = {
+    cliVersion,
+    repoRootAbs: deps.repoRootAbs,
+    analysisRootAbs: deps.repoRootAbs,
+    apiBaseUrl: deps.merged.apiBaseUrl,
+    openCodeExecutable: deps.merged.openCodeExecutable,
+    openCodeSkipCredentialsCheck: deps.merged.openCodeSkipCredentialsCheck,
+    providerEnvFromConfig: deps.merged.openCodeChildEnv,
+    repoConfig: deps.repoConfig
+  };
+  const rlog = deps.readinessLog ?? deps.log;
+  const pre = emitCliFactoryReadinessPreflight(rlog, "[factory] update context readiness", readinessCtx);
+  if (!pre.ok) {
+    const g = pre.failure;
+    return {
+      exitOk: false,
+      ok: false,
+      code: "READINESS_FAILED",
+      error: `Factory readiness failed (${g.readinessReasonCode}).`,
+      readinessExitCode: g.exitCode,
+      readinessReasonCode: g.readinessReasonCode,
+      readinessGate: g.gate,
+      openCodeConfigFiles: pre.facts.openCodeConfigFiles,
+      modelConfigured: pre.facts.modelConfigured,
+      baselineDate: baseline.baselineIsoUtc,
+      baselineSource: baseline.source,
+      headCommit: gitWin.headCommit,
+      rangeStartCommit: gitWin.rangeStartCommit,
+      commitsReviewed: gitWin.commitsInOrder.length,
+      ...baseMeta
+    };
+  }
   const prep = await prepareSynthesisWorktree(deps.storage, deps.repoRootAbs, deps.log, {
-    clearPriorArtefactRun: true
+    clearPriorArtefactRun: true,
+    inPlace
   });
   if (!prep.ok) {
     prep.finalize?.();
@@ -25960,7 +26344,7 @@ async function runUpdateContextFactory(deps) {
   const finalizeWt = prep.finalize;
   const wsCtxDir = contextDirUnderRoot(deps.repoRootAbs);
   let ctxDirAbs = contextDirUnderRoot(handle.path);
-  if (!isWorktreeContextSeeded(ctxDirAbs) && isWorktreeContextSeeded(wsCtxDir)) {
+  if (!inPlace && !isWorktreeContextSeeded(ctxDirAbs) && isWorktreeContextSeeded(wsCtxDir)) {
     deps.log("[update-context] seeding worktree context from workspace .gluecharm/context/");
     promoteContextDirectoryToWorkspaceFs(wsCtxDir, handle.path);
     ctxDirAbs = contextDirUnderRoot(handle.path);
@@ -26139,30 +26523,34 @@ async function runUpdateContextFactory(deps) {
   }
   let promoted = false;
   if (deps.merged.promoteContextToWorkspace && ctxDirAbs) {
-    try {
-      const { filesCopied } = promoteContextDirectoryToWorkspaceFs(ctxDirAbs, deps.repoRootAbs);
-      deps.log(`[update-context] promoted ${String(filesCopied)} file(s) \u2192 ${deps.repoRootAbs}`);
-      promoted = filesCopied > 0;
-    } catch (e) {
-      finalizeWt?.();
-      return {
-        exitOk: false,
-        ok: false,
-        code: "PROMOTE_FAILED",
-        error: e instanceof Error ? e.message : String(e),
-        baselineDate: baseline.baselineIsoUtc,
-        baselineSource: baseline.source,
-        headCommit: gitWin.headCommit,
-        rangeStartCommit: gitWin.rangeStartCommit,
-        commitsReviewed: gitWin.commitsInOrder.length,
-        filesDetected: inventory.length,
-        filesRemediated,
-        analysisWorktreeRoot: handle.path,
-        changesReportRelativePath: ".gluecharm/context/changes-since-date.md",
-        remediationSkipped,
-        ...remediationSkipReason ? { skipReason: remediationSkipReason } : {},
-        ...baseMeta
-      };
+    if (inPlace) {
+      deps.log("[update-context] in-place analysis \u2014 promote skipped (context already at repository root)");
+    } else {
+      try {
+        const { filesCopied } = promoteContextDirectoryToWorkspaceFs(ctxDirAbs, deps.repoRootAbs);
+        deps.log(`[update-context] promoted ${String(filesCopied)} file(s) \u2192 ${deps.repoRootAbs}`);
+        promoted = filesCopied > 0;
+      } catch (e) {
+        finalizeWt?.();
+        return {
+          exitOk: false,
+          ok: false,
+          code: "PROMOTE_FAILED",
+          error: e instanceof Error ? e.message : String(e),
+          baselineDate: baseline.baselineIsoUtc,
+          baselineSource: baseline.source,
+          headCommit: gitWin.headCommit,
+          rangeStartCommit: gitWin.rangeStartCommit,
+          commitsReviewed: gitWin.commitsInOrder.length,
+          filesDetected: inventory.length,
+          filesRemediated,
+          analysisWorktreeRoot: handle.path,
+          changesReportRelativePath: ".gluecharm/context/changes-since-date.md",
+          remediationSkipped,
+          ...remediationSkipReason ? { skipReason: remediationSkipReason } : {},
+          ...baseMeta
+        };
+      }
     }
   }
   const uploadSkipped = true;
@@ -26198,12 +26586,12 @@ async function runUpdateContextFactory(deps) {
 }
 
 // src/factory/contextDrift/runContextDriftFactory.ts
-var fs57 = __toESM(require("node:fs"));
-var path53 = __toESM(require("node:path"));
+var fs58 = __toESM(require("node:fs"));
+var path54 = __toESM(require("node:path"));
 
 // src/factory/contextDrift/contextDriftManifest.ts
-var fs52 = __toESM(require("node:fs"));
-var path49 = __toESM(require("node:path"));
+var fs53 = __toESM(require("node:fs"));
+var path50 = __toESM(require("node:path"));
 var MAX_REFERENCE_BYTES = 256 * 1024;
 var MAX_EVIDENCE_FILES = 300;
 var MAX_EVIDENCE_READ = 512 * 1024;
@@ -26211,7 +26599,7 @@ var MAX_EXCERPT = 4e3;
 function readFileLimited(abs, maxBytes) {
   let buf;
   try {
-    buf = fs52.readFileSync(abs);
+    buf = fs53.readFileSync(abs);
   } catch {
     return { text: "", truncated: false };
   }
@@ -26223,16 +26611,16 @@ function collectEvidencePaths(repoRoot) {
   const out = [];
   const roots = ["src", "test", "tests", "packages", ".gluecharm", "scripts"];
   for (const rel of roots) {
-    const abs = path49.join(repoRoot, rel);
-    if (!fs52.existsSync(abs)) {
+    const abs = path50.join(repoRoot, rel);
+    if (!fs53.existsSync(abs)) {
       continue;
     }
     walkFiles(abs, repoRoot, out, 0);
   }
   for (const leaf of ["package.json", "tsconfig.json"]) {
-    const abs = path49.join(repoRoot, leaf);
-    if (fs52.existsSync(abs) && fs52.statSync(abs).isFile()) {
-      const r = path49.relative(repoRoot, abs).split(path49.sep).join("/");
+    const abs = path50.join(repoRoot, leaf);
+    if (fs53.existsSync(abs) && fs53.statSync(abs).isFile()) {
+      const r = path50.relative(repoRoot, abs).split(path50.sep).join("/");
       out.push(r);
     }
   }
@@ -26249,7 +26637,7 @@ function walkFiles(dir, repoRoot, out, depth) {
   }
   let entries;
   try {
-    entries = fs52.readdirSync(dir, { withFileTypes: true });
+    entries = fs53.readdirSync(dir, { withFileTypes: true });
   } catch {
     return;
   }
@@ -26257,13 +26645,13 @@ function walkFiles(dir, repoRoot, out, depth) {
     if (e.name === "node_modules" || e.name === ".git" || e.name === "dist" || e.name === "out") {
       continue;
     }
-    const full = path49.join(dir, e.name);
+    const full = path50.join(dir, e.name);
     if (e.isDirectory()) {
       walkFiles(full, repoRoot, out, depth + 1);
     } else if (e.isFile()) {
-      const ext = path49.extname(e.name).toLowerCase();
+      const ext = path50.extname(e.name).toLowerCase();
       if ([".ts", ".tsx", ".js", ".mjs", ".cjs", ".json", ".md", ".yaml", ".yml"].includes(ext) || e.name === "Dockerfile") {
-        const rel = path49.relative(repoRoot, full).split(path49.sep).join("/");
+        const rel = path50.relative(repoRoot, full).split(path50.sep).join("/");
         out.push(rel);
       }
     }
@@ -26273,7 +26661,7 @@ function buildComparisonManifest(args) {
   const references = [];
   let referenceTruncated = false;
   for (const abs of args.bundleAbsFiles) {
-    const rel = path49.relative(args.worktreeRoot, abs).split(path49.sep).join("/");
+    const rel = path50.relative(args.worktreeRoot, abs).split(path50.sep).join("/");
     const { text, truncated } = readFileLimited(abs, MAX_REFERENCE_BYTES);
     references.push({ path: rel, content: text, truncated });
     if (truncated) {
@@ -26285,8 +26673,8 @@ function buildComparisonManifest(args) {
   const omitted = Math.max(0, allEvidence.length - evidencePathsTrimmed.length);
   const evidenceFiles = [];
   for (const rel of evidencePathsTrimmed) {
-    const abs = path49.join(args.worktreeRoot, ...rel.split("/"));
-    const st = fs52.existsSync(abs) ? fs52.statSync(abs) : null;
+    const abs = path50.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);
     const excerpt = truncated ? `${text.slice(0, MAX_EXCERPT)}
@@ -26296,7 +26684,7 @@ function buildComparisonManifest(args) {
   }
   return {
     runDate: args.runDate,
-    referenceRelPaths: args.bundleAbsFiles.map((a) => path49.relative(args.worktreeRoot, a).split(path49.sep).join("/")),
+    referenceRelPaths: args.bundleAbsFiles.map((a) => path50.relative(args.worktreeRoot, a).split(path50.sep).join("/")),
     references,
     evidenceFiles,
     evidencePathsOnly: [],
@@ -26308,8 +26696,8 @@ function buildComparisonManifest(args) {
 }
 
 // src/factory/contextDrift/contextDriftAgent.ts
-var fs53 = __toESM(require("node:fs"));
-var path50 = __toESM(require("node:path"));
+var fs54 = __toESM(require("node:fs"));
+var path51 = __toESM(require("node:path"));
 
 // src/factory/contextDrift/contextDriftPayload.ts
 function isNonEmptyString2(v) {
@@ -26454,17 +26842,17 @@ function buildDriftPrompt(args) {
   ].join("\n");
 }
 async function runDriftComparisonOpenCode(args) {
-  const runDir = path50.join(args.worktreeRoot, ".opencode", "_run");
-  fs53.mkdirSync(runDir, { recursive: true });
-  const manifestPath = path50.join(runDir, "context-drift-manifest.json");
-  const outputPath = path50.join(runDir, "context-drift-payload.json");
-  fs53.writeFileSync(manifestPath, `${JSON.stringify(args.manifestObject, null, 2)}
+  const runDir = path51.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");
+  fs54.writeFileSync(manifestPath, `${JSON.stringify(args.manifestObject, null, 2)}
 `, "utf8");
-  if (fs53.existsSync(outputPath)) {
-    fs53.unlinkSync(outputPath);
+  if (fs54.existsSync(outputPath)) {
+    fs54.unlinkSync(outputPath);
   }
-  const promptPath = path50.join(runDir, `context-drift-${Date.now()}.prompt.txt`);
-  fs53.writeFileSync(
+  const promptPath = path51.join(runDir, `context-drift-${Date.now()}.prompt.txt`);
+  fs54.writeFileSync(
     promptPath,
     buildDriftPrompt({
       worktreeRoot: args.worktreeRoot,
@@ -26481,7 +26869,7 @@ async function runDriftComparisonOpenCode(args) {
   });
   const title = buildOpenCodeSessionTitle({
     runId: "context-drift",
-    workItemId: path50.basename(args.worktreeRoot).slice(0, 24) || "wt",
+    workItemId: path51.basename(args.worktreeRoot).slice(0, 24) || "wt",
     stepLabel: "context-drift"
   });
   const argv = injectPrimaryOpenCodeSessionArgv(expanded, title);
@@ -26506,7 +26894,7 @@ async function runDriftComparisonOpenCode(args) {
   }
   let raw;
   try {
-    const txt = fs53.readFileSync(outputPath, "utf8");
+    const txt = fs54.readFileSync(outputPath, "utf8");
     raw = JSON.parse(txt);
   } catch (e) {
     return {
@@ -26523,9 +26911,9 @@ async function runDriftComparisonOpenCode(args) {
 
 // src/factory/contextDrift/contextDriftPaths.ts
 var crypto2 = __toESM(require("node:crypto"));
-var fs54 = __toESM(require("node:fs"));
-var path51 = __toESM(require("node:path"));
-var DRIFT_CONTEXT_SUBDIR = path51.join(".gluecharm", "context", "drift");
+var fs55 = __toESM(require("node:fs"));
+var path52 = __toESM(require("node:path"));
+var DRIFT_CONTEXT_SUBDIR = path52.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";
@@ -26534,9 +26922,9 @@ function utcDateString(d) {
   return d.toISOString().slice(0, 10);
 }
 function resolveInsideRepo(repoRootAbs, userPath) {
-  const abs = path51.isAbsolute(userPath) ? path51.normalize(userPath) : path51.resolve(repoRootAbs, userPath);
-  const rel = path51.relative(repoRootAbs, abs);
-  if (rel.startsWith("..") || path51.isAbsolute(rel)) {
+  const abs = path52.isAbsolute(userPath) ? path52.normalize(userPath) : path52.resolve(repoRootAbs, userPath);
+  const rel = path52.relative(repoRootAbs, abs);
+  if (rel.startsWith("..") || path52.isAbsolute(rel)) {
     return { ok: false };
   }
   return { ok: true, abs };
@@ -26546,7 +26934,7 @@ function computeSlug(args) {
     return sanitizeSlug(args.label.trim());
   }
   const r = resolveInsideRepo(args.repoRootAbs, args.referencePath);
-  const base = r.ok ? path51.basename(r.abs) : path51.basename(args.referencePath);
+  const base = r.ok ? path52.basename(r.abs) : path52.basename(args.referencePath);
   return sanitizeSlug(base);
 }
 function driftFilename(slug, runDate) {
@@ -26562,7 +26950,7 @@ function maybeDedupeSlug(slug, referenceRelPosix) {
 function discoverReferenceBundle(worktreeRoot, referenceAbsInWorktree) {
   let st;
   try {
-    st = fs54.statSync(referenceAbsInWorktree);
+    st = fs55.statSync(referenceAbsInWorktree);
   } catch {
     return { ok: false, error: `Reference path not found in analysis worktree: ${referenceAbsInWorktree}` };
   }
@@ -26583,12 +26971,12 @@ function discoverReferenceBundle(worktreeRoot, referenceAbsInWorktree) {
     }
     let entries;
     try {
-      entries = fs54.readdirSync(dir, { withFileTypes: true });
+      entries = fs55.readdirSync(dir, { withFileTypes: true });
     } catch {
       return;
     }
     for (const e of entries) {
-      const full = path51.join(dir, e.name);
+      const full = path52.join(dir, e.name);
       if (e.isDirectory()) {
         if (e.name === "node_modules" || e.name === ".git") {
           continue;
@@ -26608,7 +26996,7 @@ function discoverReferenceBundle(worktreeRoot, referenceAbsInWorktree) {
 }
 function pickReferenceRootDocument(args) {
   if (args.indexOverrideAbs) {
-    if (!fs54.existsSync(args.indexOverrideAbs) || !args.indexOverrideAbs.endsWith(".md")) {
+    if (!fs55.existsSync(args.indexOverrideAbs) || !args.indexOverrideAbs.endsWith(".md")) {
       return { ok: false, error: "--index must point to an existing .md file under the repo." };
     }
     return { ok: true, path: args.indexOverrideAbs };
@@ -26618,8 +27006,8 @@ function pickReferenceRootDocument(args) {
   }
   const dir = args.referenceAbsInWorktree;
   for (const name of ["index.md", "README.md"]) {
-    const p = path51.join(dir, name);
-    if (fs54.existsSync(p) && fs54.statSync(p).isFile()) {
+    const p = path52.join(dir, name);
+    if (fs55.existsSync(p) && fs55.statSync(p).isFile()) {
       return { ok: true, path: p };
     }
   }
@@ -26629,20 +27017,20 @@ function pickReferenceRootDocument(args) {
   };
 }
 function toWorktreeRelative(worktreeRoot, absolute) {
-  return path51.relative(worktreeRoot, absolute).split(path51.sep).join("/");
+  return path52.relative(worktreeRoot, absolute).split(path52.sep).join("/");
 }
 function toPosixPath(p) {
-  return p.split(path51.sep).join("/");
+  return p.split(path52.sep).join("/");
 }
 
 // src/factory/contextDrift/contextDriftIndex.ts
-var fs55 = __toESM(require("node:fs"));
+var fs56 = __toESM(require("node:fs"));
 var START = "<!-- easyspecs-drift-links:start -->";
 var END = "<!-- easyspecs-drift-links:end -->";
 function patchReferenceIndexWithDriftLink(args) {
   let body;
   try {
-    body = fs55.readFileSync(args.referenceRootAbsolute, "utf8");
+    body = fs56.readFileSync(args.referenceRootAbsolute, "utf8");
   } catch (e) {
     return { ok: false, error: e instanceof Error ? e.message : String(e) };
   }
@@ -26663,7 +27051,7 @@ ${block}
 `;
   }
   try {
-    fs55.writeFileSync(args.referenceRootAbsolute, next, "utf8");
+    fs56.writeFileSync(args.referenceRootAbsolute, next, "utf8");
   } catch (e) {
     return { ok: false, error: e instanceof Error ? e.message : String(e) };
   }
@@ -26674,19 +27062,32 @@ function escapeRe(s) {
 }
 
 // src/factory/contextDrift/contextDriftPromote.ts
-var fs56 = __toESM(require("node:fs"));
-var path52 = __toESM(require("node:path"));
+var fs57 = __toESM(require("node:fs"));
+var path53 = __toESM(require("node:path"));
 function copyWorktreeFileToWorkspace(args) {
-  const src = path52.join(args.worktreeRoot, ...args.relativePosix.split("/"));
-  const dest = path52.join(args.workspaceRoot, ...args.relativePosix.split("/"));
-  fs56.mkdirSync(path52.dirname(dest), { recursive: true });
-  fs56.copyFileSync(src, dest);
+  const wt = path53.resolve(args.worktreeRoot);
+  const ws = path53.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)) {
+    return;
+  }
+  fs57.mkdirSync(path53.dirname(dest), { recursive: true });
+  fs57.copyFileSync(src, dest);
 }
 
 // src/factory/contextDrift/runContextDriftFactory.ts
 async function runContextDriftFactory(deps) {
   const runDate = utcDateString(/* @__PURE__ */ new Date());
-  const baseMeta = { command: "context_drift", referencePath: deps.referencePathArg };
+  const inPlace = deps.inPlace === true;
+  const baseMeta = {
+    command: "context_drift",
+    referencePath: deps.referencePathArg,
+    ...inPlace ? { analysisInPlace: true } : {}
+  };
   const resolved = resolveInsideRepo(deps.repoRootAbs, deps.referencePathArg);
   if (!resolved.ok) {
     return {
@@ -26699,7 +27100,7 @@ async function runContextDriftFactory(deps) {
     };
   }
   const refAbsWorkspace = resolved.abs;
-  if (!fs57.existsSync(refAbsWorkspace)) {
+  if (!fs58.existsSync(refAbsWorkspace)) {
     return {
       exitOk: false,
       ok: false,
@@ -26712,7 +27113,7 @@ async function runContextDriftFactory(deps) {
   let indexOverrideAbsWorkspace;
   if (deps.indexOverrideArg?.trim()) {
     const ir = resolveInsideRepo(deps.repoRootAbs, deps.indexOverrideArg.trim());
-    if (!ir.ok || !fs57.existsSync(ir.abs)) {
+    if (!ir.ok || !fs58.existsSync(ir.abs)) {
       return {
         exitOk: false,
         ok: false,
@@ -26730,7 +27131,7 @@ async function runContextDriftFactory(deps) {
       ok: true,
       code: "DRY_RUN",
       ...baseMeta,
-      referenceRootDocument: toPosixPath(path53.relative(deps.repoRootAbs, refAbsWorkspace)) + (fs57.statSync(refAbsWorkspace).isDirectory() ? "/" : ""),
+      referenceRootDocument: toPosixPath(path54.relative(deps.repoRootAbs, refAbsWorkspace)) + (fs58.statSync(refAbsWorkspace).isDirectory() ? "/" : ""),
       driftReportPath: null,
       analysisWorktreeRoot: "",
       promoted: false,
@@ -26740,8 +27141,38 @@ async function runContextDriftFactory(deps) {
       dryRun: true
     };
   }
+  const cliVersion = deps.cliVersion?.trim() || "0.0.0";
+  const readinessCtx = {
+    cliVersion,
+    repoRootAbs: deps.repoRootAbs,
+    analysisRootAbs: deps.repoRootAbs,
+    apiBaseUrl: deps.merged.apiBaseUrl,
+    openCodeExecutable: deps.merged.openCodeExecutable,
+    openCodeSkipCredentialsCheck: deps.merged.openCodeSkipCredentialsCheck,
+    providerEnvFromConfig: deps.merged.openCodeChildEnv,
+    repoConfig: deps.repoConfig
+  };
+  const rlog = deps.readinessLog ?? deps.log;
+  const pre = emitCliFactoryReadinessPreflight(rlog, "[factory] context drift readiness", readinessCtx);
+  if (!pre.ok) {
+    const g = pre.failure;
+    return {
+      exitOk: false,
+      ok: false,
+      code: "READINESS_FAILED",
+      error: `Factory readiness failed (${g.readinessReasonCode}).`,
+      readinessExitCode: g.exitCode,
+      readinessReasonCode: g.readinessReasonCode,
+      readinessGate: g.gate,
+      openCodeConfigFiles: pre.facts.openCodeConfigFiles,
+      modelConfigured: pre.facts.modelConfigured,
+      driftReportPath: null,
+      ...baseMeta
+    };
+  }
   const prep = await prepareSynthesisWorktree(deps.storage, deps.repoRootAbs, deps.log, {
-    clearPriorArtefactRun: false
+    clearPriorArtefactRun: false,
+    inPlace
   });
   if (!prep.ok) {
     prep.finalize?.();
@@ -26757,8 +27188,8 @@ async function runContextDriftFactory(deps) {
   const handle = prep.handle;
   const finalizeWt = prep.finalize;
   const wt = handle.path;
-  const refRel = path53.relative(deps.repoRootAbs, refAbsWorkspace).split(path53.sep).join("/");
-  const refAbsWt = path53.join(wt, ...refRel.split("/"));
+  const refRel = path54.relative(deps.repoRootAbs, refAbsWorkspace).split(path54.sep).join("/");
+  const refAbsWt = path54.join(wt, ...refRel.split("/"));
   try {
     materializeOpenCodeAgentsWithAce(deps.agentsDirFs, wt, {
       enabled: getAceAnalysisEnabledForCheckout(wt),
@@ -26797,9 +27228,9 @@ async function runContextDriftFactory(deps) {
       ...baseMeta
     };
   }
-  const indexWt = indexOverrideAbsWorkspace ? path53.join(wt, ...path53.relative(deps.repoRootAbs, indexOverrideAbsWorkspace).split(path53.sep)) : void 0;
+  const indexWt = indexOverrideAbsWorkspace ? path54.join(wt, ...path54.relative(deps.repoRootAbs, indexOverrideAbsWorkspace).split(path54.sep)) : void 0;
   const rootPick = pickReferenceRootDocument({
-    referencePathIsFile: fs57.statSync(refAbsWt).isFile(),
+    referencePathIsFile: fs58.statSync(refAbsWt).isFile(),
     referenceAbsInWorktree: refAbsWt,
     bundleFiles: bundle.bundleFiles,
     indexOverrideAbs: indexWt
@@ -26825,9 +27256,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 = path53.join(wt, DRIFT_CONTEXT_SUBDIR);
-  fs57.mkdirSync(driftDirWt, { recursive: true });
-  const driftAbsWt = path53.join(driftDirWt, driftBase);
+  const driftDirWt = path54.join(wt, DRIFT_CONTEXT_SUBDIR);
+  fs58.mkdirSync(driftDirWt, { recursive: true });
+  const driftAbsWt = path54.join(driftDirWt, driftBase);
   let payload;
   if (deps.testOnlyFixturePayload) {
     payload = deps.testOnlyFixturePayload;
@@ -26863,7 +27294,7 @@ async function runContextDriftFactory(deps) {
     manifestTruncation: manifest.truncation
   });
   try {
-    fs57.writeFileSync(driftAbsWt, md, "utf8");
+    fs58.writeFileSync(driftAbsWt, md, "utf8");
   } catch (e) {
     finalizeWt?.();
     return {
@@ -26876,7 +27307,7 @@ async function runContextDriftFactory(deps) {
       ...baseMeta
     };
   }
-  const driftRelFromRootDir = path53.relative(path53.dirname(refRootAbsWt), driftAbsWt).split(path53.sep).join("/");
+  const driftRelFromRootDir = path54.relative(path54.dirname(refRootAbsWt), driftAbsWt).split(path54.sep).join("/");
   const linkRes = patchReferenceIndexWithDriftLink({
     referenceRootAbsolute: refRootAbsWt,
     relativeLinkFromRootToDrift: driftRelFromRootDir,
@@ -26895,10 +27326,10 @@ async function runContextDriftFactory(deps) {
       ...baseMeta
     };
   }
-  const driftRelPosix = toPosixPath(path53.relative(wt, driftAbsWt));
-  const rootRelPosix = toPosixPath(path53.relative(wt, refRootAbsWt));
+  const driftRelPosix = toPosixPath(path54.relative(wt, driftAbsWt));
+  const rootRelPosix = toPosixPath(path54.relative(wt, refRootAbsWt));
   const promoteEffective = deps.merged.promoteContextToWorkspace !== false;
-  if (promoteEffective) {
+  if (promoteEffective && !inPlace) {
     try {
       copyWorktreeFileToWorkspace({
         worktreeRoot: wt,
@@ -26923,8 +27354,10 @@ async function runContextDriftFactory(deps) {
         ...baseMeta
       };
     }
+  } else if (promoteEffective && inPlace) {
+    deps.log("[context-drift] in-place analysis \u2014 promote skipped (artefacts already under repository root)");
   }
-  const driftReportPathFs = promoteEffective ? path53.join(deps.repoRootAbs, ...driftRelPosix.split("/")) : driftAbsWt;
+  const driftReportPathFs = promoteEffective ? path54.join(deps.repoRootAbs, ...driftRelPosix.split("/")) : driftAbsWt;
   return {
     exitOk: true,
     ok: true,
@@ -26933,7 +27366,7 @@ async function runContextDriftFactory(deps) {
     referenceRootDocument: rootRelPosix,
     driftReportPath: driftReportPathFs,
     analysisWorktreeRoot: wt,
-    promoted: promoteEffective,
+    promoted: promoteEffective && !inPlace,
     nameOfChangeSlug: slug,
     runDate,
     agentInvoked: !deps.testOnlyFixturePayload,
@@ -26942,8 +27375,8 @@ async function runContextDriftFactory(deps) {
 }
 
 // src/analysis/coordinationDuplicatesDiagnosis.ts
-var fs58 = __toESM(require("fs"));
-var path54 = __toESM(require("path"));
+var fs59 = __toESM(require("fs"));
+var path55 = __toESM(require("path"));
 var import__7 = __toESM(require__());
 var COORDINATION_DUPLICATES_REPORT_BASENAME = "coordination-duplicates-report.json";
 var COORDINATION_LIST_SCAN_ENTRIES = [
@@ -26969,7 +27402,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 !== path54.basename(basename17) || !/\.md$/i.test(basename17)) {
+  if (!basename17 || basename17 !== path55.basename(basename17) || !/\.md$/i.test(basename17)) {
     return false;
   }
   if (STAPLE_CONTEXT_MARKDOWN_BASENAMES.has(basename17)) {
@@ -26978,12 +27411,12 @@ 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 = path54.join(contextDirAbs, "features-list.json");
-  if (!fs58.existsSync(p)) {
+  const p = path55.join(contextDirAbs, "features-list.json");
+  if (!fs59.existsSync(p)) {
     return [];
   }
   try {
-    const raw = stripUtf8Bom6(fs58.readFileSync(p, "utf-8"));
+    const raw = stripUtf8Bom6(fs59.readFileSync(p, "utf-8"));
     const doc = JSON.parse(raw);
     return Array.isArray(doc.features) ? doc.features : [];
   } catch {
@@ -27018,7 +27451,7 @@ function findOrphanCoordinationMarkdown(contextDirAbs) {
   const featureRows = loadRawFeatureRows(contextDirAbs);
   let dirents;
   try {
-    dirents = fs58.readdirSync(contextDirAbs, { withFileTypes: true });
+    dirents = fs59.readdirSync(contextDirAbs, { withFileTypes: true });
   } catch {
     return [];
   }
@@ -27271,14 +27704,14 @@ function buildCoordinationDuplicatesReport(input) {
   const lists = [];
   const duplicateGroups = [];
   for (const entry of COORDINATION_LIST_SCAN_ENTRIES) {
-    const filePath = path54.join(input.contextDirAbsolute, entry.basename);
-    if (!fs58.existsSync(filePath)) {
+    const filePath = path55.join(input.contextDirAbsolute, entry.basename);
+    if (!fs59.existsSync(filePath)) {
       lists.push({ basename: entry.basename, status: "missing" });
       continue;
     }
     let raw;
     try {
-      raw = stripUtf8Bom6(fs58.readFileSync(filePath, "utf-8"));
+      raw = stripUtf8Bom6(fs59.readFileSync(filePath, "utf-8"));
     } catch (e) {
       lists.push({
         basename: entry.basename,
@@ -27326,8 +27759,8 @@ var validateReportCompiled;
 function validateReportData(data) {
   if (!validateReportCompiled) {
     const ajv2 = new import__7.default({ allErrors: true, strict: false });
-    const schemaPath = path54.join(resolveContextListSchemasDir(), "coordination-duplicates-report.schema.json");
-    const schemaRaw = stripUtf8Bom6(fs58.readFileSync(schemaPath, "utf-8"));
+    const schemaPath = path55.join(resolveContextListSchemasDir(), "coordination-duplicates-report.schema.json");
+    const schemaRaw = stripUtf8Bom6(fs59.readFileSync(schemaPath, "utf-8"));
     validateReportCompiled = ajv2.compile(JSON.parse(schemaRaw));
   }
   if (validateReportCompiled(data)) {
@@ -27345,20 +27778,20 @@ function runCoordinationDuplicatesDiagnosis(input) {
   if (!v.ok) {
     return { ok: false, message: `Report validation failed: ${v.errors.join("; ")}` };
   }
-  const outPath = path54.join(input.contextDirAbsolute, COORDINATION_DUPLICATES_REPORT_BASENAME);
+  const outPath = path55.join(input.contextDirAbsolute, COORDINATION_DUPLICATES_REPORT_BASENAME);
   const payload = `${JSON.stringify(report, null, 2)}
 `;
   const tmp = `${outPath}.tmp.${process.pid}`;
   try {
-    fs58.writeFileSync(tmp, payload, "utf-8");
+    fs59.writeFileSync(tmp, payload, "utf-8");
   } catch (e) {
     return { ok: false, message: e instanceof Error ? e.message : String(e) };
   }
   try {
-    fs58.renameSync(tmp, outPath);
+    fs59.renameSync(tmp, outPath);
   } catch (e) {
     try {
-      fs58.unlinkSync(tmp);
+      fs59.unlinkSync(tmp);
     } catch {
     }
     return { ok: false, message: e instanceof Error ? e.message : String(e) };
@@ -27392,8 +27825,8 @@ function runCoordinationDuplicatesDiagnosis(input) {
 }
 
 // src/pipelines/download/downloadPipeline.ts
-var fs59 = __toESM(require("node:fs"));
-var path55 = __toESM(require("node:path"));
+var fs60 = __toESM(require("node:fs"));
+var path56 = __toESM(require("node:path"));
 var SRS_DISCOVERY_BATCH_GET_CHUNK_SIZE = 200;
 function isRecord7(v) {
   return Boolean(v) && typeof v === "object" && !Array.isArray(v);
@@ -27483,9 +27916,9 @@ function resolveSafeContextOutputPath(contextDirAbs, nameRaw) {
       return null;
     }
   }
-  const resolved = path55.resolve(contextDirAbs, ...segments);
-  const rel = path55.relative(contextDirAbs, resolved);
-  if (rel.startsWith("..") || path55.isAbsolute(rel)) {
+  const resolved = path56.resolve(contextDirAbs, ...segments);
+  const rel = path56.relative(contextDirAbs, resolved);
+  if (rel.startsWith("..") || path56.isAbsolute(rel)) {
     return null;
   }
   return resolved;
@@ -27498,37 +27931,37 @@ function chunkIds(ids, size) {
   return out;
 }
 function clearContextDirectoryForCloudReplace(contextDirAbs) {
-  if (!fs59.existsSync(contextDirAbs) || !fs59.statSync(contextDirAbs).isDirectory()) {
+  if (!fs60.existsSync(contextDirAbs) || !fs60.statSync(contextDirAbs).isDirectory()) {
     return { filesRemoved: 0 };
   }
-  const preserveAbs = path55.resolve(contextDirAbs, UPLOAD_TARGET_FILENAME);
+  const preserveAbs = path56.resolve(contextDirAbs, UPLOAD_TARGET_FILENAME);
   const preserveSet = /* @__PURE__ */ new Set();
-  if (fs59.existsSync(preserveAbs) && fs59.statSync(preserveAbs).isFile()) {
+  if (fs60.existsSync(preserveAbs) && fs60.statSync(preserveAbs).isFile()) {
     preserveSet.add(preserveAbs);
   }
   let filesRemoved = 0;
   const walkRm = (dir) => {
     let entries;
     try {
-      entries = fs59.readdirSync(dir, { withFileTypes: true });
+      entries = fs60.readdirSync(dir, { withFileTypes: true });
     } catch {
       return;
     }
     for (const e of entries) {
-      const full = path55.join(dir, e.name);
+      const full = path56.join(dir, e.name);
       if (e.isDirectory()) {
         walkRm(full);
         try {
-          fs59.rmdirSync(full);
+          fs60.rmdirSync(full);
         } catch {
         }
       } else if (e.isFile()) {
-        const abs = path55.resolve(full);
+        const abs = path56.resolve(full);
         if (preserveSet.has(abs)) {
           continue;
         }
         try {
-          fs59.unlinkSync(abs);
+          fs60.unlinkSync(abs);
           filesRemoved += 1;
         } catch {
         }
@@ -27596,7 +28029,7 @@ async function runDownloadPipeline(opts) {
       failed.push({ id, message: "Missing name on srs_discovery node." });
       continue;
     }
-    if (name === UPLOAD_TARGET_FILENAME || path55.basename(name) === UPLOAD_TARGET_FILENAME) {
+    if (name === UPLOAD_TARGET_FILENAME || path56.basename(name) === UPLOAD_TARGET_FILENAME) {
       skipped += 1;
       log?.(`[pipeline:download] skip ${name} (upload target row).`);
       continue;
@@ -27607,15 +28040,15 @@ async function runDownloadPipeline(opts) {
       failed.push({ id, name, message: "Unsafe or invalid name for local path." });
       continue;
     }
-    fs59.mkdirSync(path55.dirname(outAbs), { recursive: true });
-    const exists = fs59.existsSync(outAbs);
+    fs60.mkdirSync(path56.dirname(outAbs), { recursive: true });
+    const exists = fs60.existsSync(outAbs);
     if (exists && !opts.force && !opts.replaceFromCloud) {
       skipped += 1;
       log?.(`[pipeline:download] skip existing ${name} (use --force to overwrite).`);
       continue;
     }
     try {
-      fs59.writeFileSync(outAbs, bodyText, "utf8");
+      fs60.writeFileSync(outAbs, bodyText, "utf8");
       downloaded += 1;
       succeededIds[outAbs] = id;
     } catch (e) {
@@ -27690,12 +28123,12 @@ function toFetchErrorMessage(e) {
 
 // src/auth/gluecharmContentNegotiation.ts
 var GLUECHARM_WS_LEGACY_JSON = "application/vnd.gluecharm.v1.ws-legacy+json";
-function pathWithoutQuery(path60) {
-  const q = path60.indexOf("?");
-  return q === -1 ? path60 : path60.slice(0, q);
+function pathWithoutQuery(path61) {
+  const q = path61.indexOf("?");
+  return q === -1 ? path61 : path61.slice(0, q);
 }
-function isGluecharmContentApiPath(path60) {
-  const p = pathWithoutQuery(path60);
+function isGluecharmContentApiPath(path61) {
+  const p = pathWithoutQuery(path61);
   return p.startsWith("/api/content/") || p.startsWith("/api/batch/content/");
 }
 function gluecharmContentHeaders(method) {
@@ -27733,7 +28166,7 @@ async function fetchWithTimeout2(url, init, fetchImpl, timeoutMs, externalSignal
 }
 function createAuthenticatedRequestJson(deps) {
   const fetchImpl = deps.fetchImpl ?? fetch;
-  async function requestJson(path60, options = {}) {
+  async function requestJson(path61, options = {}) {
     const base = deps.getApiBaseUrl();
     if (!base) {
       const err = { status: 0, message: "easyspecs.apiBaseUrl is not configured." };
@@ -27741,7 +28174,7 @@ function createAuthenticatedRequestJson(deps) {
     }
     const method = options.method ?? "GET";
     const headers = { ...options.headers };
-    if (isGluecharmContentApiPath(path60)) {
+    if (isGluecharmContentApiPath(path61)) {
       Object.assign(headers, gluecharmContentHeaders(method));
     } else {
       if (!headers.Accept) {
@@ -27755,7 +28188,7 @@ function createAuthenticatedRequestJson(deps) {
     if (options.withAuth !== false && access) {
       headers.Authorization = `Bearer ${access}`;
     }
-    const url = `${base}${path60}`;
+    const url = `${base}${path61}`;
     const timeoutMs = options.timeoutMs ?? API_TIMEOUT_MS;
     const response = await fetchWithTimeout2(
       url,
@@ -27776,7 +28209,7 @@ function createAuthenticatedRequestJson(deps) {
     if (shouldRetryUnauthorized) {
       const refreshed = await deps.refreshSession();
       if (refreshed) {
-        return requestJson(path60, { ...options, retryOnUnauthorized: false });
+        return requestJson(path61, { ...options, retryOnUnauthorized: false });
       }
     }
     const fallback = payload == null ? `${response.statusText || "HTTP error"} (response body empty or not JSON)` : "Request failed.";
@@ -27786,15 +28219,15 @@ function createAuthenticatedRequestJson(deps) {
 }
 
 // src/cli/cliSession.ts
-var fs60 = __toESM(require("node:fs"));
-var os6 = __toESM(require("node:os"));
-var path56 = __toESM(require("node:path"));
+var fs61 = __toESM(require("node:fs"));
+var os7 = __toESM(require("node:os"));
+var path57 = __toESM(require("node:path"));
 function defaultSessionPath() {
-  return path56.join(os6.homedir(), ".easyspecs", "cli-session.json");
+  return path57.join(os7.homedir(), ".easyspecs", "cli-session.json");
 }
 var configSessionPath;
 function setCliSessionPathFromConfig(absPath) {
-  configSessionPath = absPath?.trim() ? path56.resolve(absPath) : void 0;
+  configSessionPath = absPath?.trim() ? path57.resolve(absPath) : void 0;
 }
 function applyCliSessionPathFromRepoConfig(repoRoot, cfg) {
   const raw = cfg.easyspecs?.cliSessionPath?.trim();
@@ -27802,7 +28235,7 @@ function applyCliSessionPathFromRepoConfig(repoRoot, cfg) {
     setCliSessionPathFromConfig(void 0);
     return;
   }
-  const abs = path56.isAbsolute(raw) ? raw : path56.join(repoRoot, raw);
+  const abs = path57.isAbsolute(raw) ? raw : path57.join(repoRoot, raw);
   setCliSessionPathFromConfig(abs);
 }
 function normalizeCliSessionPathForConfig(repoRoot, raw) {
@@ -27810,15 +28243,15 @@ function normalizeCliSessionPathForConfig(repoRoot, raw) {
   if (!t) {
     return "";
   }
-  const resolvedRepo = path56.resolve(repoRoot);
-  const abs = path56.isAbsolute(t) ? path56.normalize(t) : path56.resolve(resolvedRepo, t);
-  const rel = path56.relative(resolvedRepo, abs);
+  const resolvedRepo = path57.resolve(repoRoot);
+  const abs = path57.isAbsolute(t) ? path57.normalize(t) : path57.resolve(resolvedRepo, t);
+  const rel = path57.relative(resolvedRepo, abs);
   if (rel === "") {
     return abs;
   }
-  const underRepo = !rel.startsWith("..") && !path56.isAbsolute(rel);
+  const underRepo = !rel.startsWith("..") && !path57.isAbsolute(rel);
   if (underRepo) {
-    return rel.split(path56.sep).join("/");
+    return rel.split(path57.sep).join("/");
   }
   return abs;
 }
@@ -27831,10 +28264,10 @@ function effectiveCliSessionPath() {
 function readCliSession() {
   const p = effectiveCliSessionPath();
   try {
-    if (!fs60.existsSync(p)) {
+    if (!fs61.existsSync(p)) {
       return void 0;
     }
-    const j = JSON.parse(fs60.readFileSync(p, "utf8"));
+    const j = JSON.parse(fs61.readFileSync(p, "utf8"));
     const apiBaseUrl = typeof j.apiBaseUrl === "string" ? j.apiBaseUrl.trim() : "";
     const accessToken = typeof j.accessToken === "string" ? j.accessToken : "";
     const refreshToken = typeof j.refreshToken === "string" ? j.refreshToken : "";
@@ -27848,33 +28281,33 @@ function readCliSession() {
 }
 function writeCliSession(s) {
   const p = effectiveCliSessionPath();
-  fs60.mkdirSync(path56.dirname(p), { recursive: true });
-  fs60.writeFileSync(p, `${JSON.stringify(s, null, 2)}
+  fs61.mkdirSync(path57.dirname(p), { recursive: true });
+  fs61.writeFileSync(p, `${JSON.stringify(s, null, 2)}
 `, "utf8");
 }
 function clearCliSession() {
   const p = effectiveCliSessionPath();
   try {
-    fs60.unlinkSync(p);
+    fs61.unlinkSync(p);
   } catch {
   }
 }
 
 // src/analysis/acePendingTraces.ts
-var fs61 = __toESM(require("fs"));
-var path57 = __toESM(require("path"));
+var fs62 = __toESM(require("fs"));
+var path58 = __toESM(require("path"));
 function normalizeAceTraceRelativePath(rel) {
   return rel.split(/[/\\]/).join("/");
 }
 function readCompletedTraceRelativePaths(contextDir2) {
   const set = /* @__PURE__ */ new Set();
   const jsonlPath = aceConsolidatedSessionsJsonlPath(contextDir2);
-  if (!fs61.existsSync(jsonlPath)) {
+  if (!fs62.existsSync(jsonlPath)) {
     return set;
   }
   let raw;
   try {
-    raw = fs61.readFileSync(jsonlPath, "utf8");
+    raw = fs62.readFileSync(jsonlPath, "utf8");
   } catch {
     return set;
   }
@@ -27905,14 +28338,14 @@ function readCompletedTraceRelativePaths(contextDir2) {
 }
 function listPendingAceTraceFiles(contextDir2, worktreeRoot) {
   const traceSchema = opencodeAceSchemaPath(worktreeRoot, ACE_SCHEMA_TRACE);
-  if (!fs61.existsSync(traceSchema)) {
+  if (!fs62.existsSync(traceSchema)) {
     return [];
   }
   const completed = readCompletedTraceRelativePaths(contextDir2);
   const allAbs = listAceTraceFiles(contextDir2);
   const pending = [];
   for (const abs of allAbs) {
-    const rel = normalizeAceTraceRelativePath(path57.relative(contextDir2, abs));
+    const rel = normalizeAceTraceRelativePath(path58.relative(contextDir2, abs));
     const v = validateAceJsonFile(abs, traceSchema);
     if (!v.ok) {
       continue;
@@ -27927,7 +28360,7 @@ function listPendingAceTraceFiles(contextDir2, worktreeRoot) {
 }
 
 // src/analysis/aceAutoLearnPool.ts
-var path58 = __toESM(require("path"));
+var path59 = __toESM(require("path"));
 function clampConcurrency2(n) {
   if (!Number.isFinite(n)) {
     return DEFAULT_MAX_CONCURRENT_AI;
@@ -27962,8 +28395,8 @@ async function runAceAutoLearnPool(p) {
   };
   const currentCap = () => Math.min(staticMaxC, adaptiveMax);
   let wake;
-  const waitTurn = () => new Promise((resolve20) => {
-    wake = resolve20;
+  const waitTurn = () => new Promise((resolve23) => {
+    wake = resolve23;
   });
   const pump = () => {
     wake?.();
@@ -27985,7 +28418,7 @@ async function runAceAutoLearnPool(p) {
       poolAbortListenerRegistered = true;
     }
   }
-  const traceRel = (abs) => path58.relative(contextDir2, abs).split(path58.sep).join("/");
+  const traceRel = (abs) => path59.relative(contextDir2, abs).split(path59.sep).join("/");
   const runOne = async (traceAbs) => {
     if (abortSignal?.aborted) {
       active -= 1;
@@ -28077,8 +28510,13 @@ function parseContextDriftTail(tail) {
   let label;
   let index;
   let dryRun = false;
+  let inPlace = false;
   for (let i = 0; i < tail.length; i += 1) {
     const a = tail[i] ?? "";
+    if (a === "--no-worktree" || a === "--noworktree" || a === "--in-place") {
+      inPlace = true;
+      continue;
+    }
     if (a === "--label" && tail[i + 1]) {
       label = tail[i + 1];
       i += 1;
@@ -28095,7 +28533,7 @@ function parseContextDriftTail(tail) {
     }
     rest.push(a);
   }
-  return { label, index, dryRun, rest };
+  return { label, index, dryRun, inPlace, rest };
 }
 function stripRootWorktreeTokens(tokens) {
   const out = [...tokens];
@@ -28511,7 +28949,7 @@ function formatCliStderrLine(line, useAnsi) {
 }
 
 // src/cli/main.ts
-var PKG_VERSION = "0.1.1";
+var PKG_VERSION = "0.2.1";
 function isNonEmptyFactoryFailureArray(x) {
   if (!Array.isArray(x) || x.length === 0) {
     return false;
@@ -28600,12 +29038,16 @@ function extractLegacyPositionals(argv) {
   }
   return [];
 }
+function rewriteArgvForCommanderParse(argv) {
+  return argv.map((t) => t === "--no-worktree" ? "--in-place" : t);
+}
 function parseCliWithCommander(argv) {
   const program2 = createEasyspecsCliProgram();
   program2.version(PKG_VERSION, "--version", "output the version number");
   program2.exitOverride();
+  const rawArgv = [...argv];
   try {
-    program2.parse(argv, { from: "user" });
+    program2.parse(rewriteArgvForCommanderParse(rawArgv), { from: "user" });
   } catch (e) {
     const code = e?.code;
     if (code === "commander.helpDisplayed" || code === "commander.version") {
@@ -28628,7 +29070,7 @@ function parseCliWithCommander(argv) {
     help: false,
     version: false
   };
-  const positionals = extractLegacyPositionals(argv);
+  const positionals = extractLegacyPositionals(rawArgv);
   return { flags, positionals };
 }
 function printHelp() {
@@ -28649,23 +29091,23 @@ function resolveAnalysisRoot(repoRoot, rootKind, worktreePath) {
     return repoRoot;
   }
   const wt = worktreePath?.trim();
-  if (wt && fs62.existsSync(path59.join(wt, ".git"))) {
-    return path59.resolve(wt);
+  if (wt && fs63.existsSync(path60.join(wt, ".git"))) {
+    return path60.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 = path59.resolve(w);
-    if (fs62.existsSync(path59.join(abs, ".git"))) {
+    const abs = path60.resolve(w);
+    if (fs63.existsSync(path60.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 && fs62.existsSync(path59.join(p, ".git"))) {
+  if (p && fs63.existsSync(path60.join(p, ".git"))) {
     return p;
   }
   throw new Error("No analysis checkout: run `easyspecs-cli run synthesis` first or pass `--worktree <path>`.");
@@ -28692,7 +29134,7 @@ async function runResumeRemediationPool(storage, repoRoot, analysisRoot, merged,
   requireOpenCode(merged, flags);
   const agentsDir = resolveOpenCodeAgentsDir(repoRoot, repoConfig);
   assertAgentsDirExists(agentsDir);
-  const ctxDir = path59.join(analysisRoot, ".gluecharm", "context");
+  const ctxDir = path60.join(analysisRoot, ".gluecharm", "context");
   const snap = readArtefactRunSnapshot(storage);
   const rows = listMissingWorkstations(ctxDir, analysisRoot, snap);
   if (rows.length === 0) {
@@ -28710,7 +29152,7 @@ async function runResumeRemediationPool(storage, repoRoot, analysisRoot, merged,
     storageContext: storage,
     repositoryRoot: repoRoot,
     worktreeRoot: analysisRoot,
-    workspaceLabel: path59.basename(analysisRoot),
+    workspaceLabel: path60.basename(analysisRoot),
     oc,
     log: (line) => logErr(flags, line),
     abortSignal: void 0,
@@ -28887,17 +29329,17 @@ async function main() {
         { easyspecs: { defaultGitRemoteUrl: url } },
         { warnMigration: (m) => logErr(flags, `[EasySpecs] ${m}`) }
       );
-      const path60 = easyspecsConfigPath(repoRoot);
+      const path61 = easyspecsConfigPath(repoRoot);
       if (flags.json) {
         printJsonLine({
           command: "config set-git-remote",
           durationMs: Date.now() - t0,
           ok: true,
-          path: path60,
+          path: path61,
           defaultGitRemoteUrl: cfg.easyspecs?.defaultGitRemoteUrl ?? ""
         });
       } else {
-        console.log(`Updated ${path60} \u2014 easyspecs.defaultGitRemoteUrl`);
+        console.log(`Updated ${path61} \u2014 easyspecs.defaultGitRemoteUrl`);
       }
       process.exit(ExitCode.ok);
     } catch (e) {
@@ -28930,7 +29372,7 @@ async function main() {
   applyCliSessionPathFromRepoConfig(repoRoot, repoConfig);
   if (flags.sessionPath?.trim()) {
     const sp = flags.sessionPath.trim();
-    const abs = path59.isAbsolute(sp) ? path59.normalize(sp) : path59.resolve(repoRoot, sp);
+    const abs = path60.isAbsolute(sp) ? path60.normalize(sp) : path60.resolve(repoRoot, sp);
     setCliSessionPathFromConfig(abs);
   }
   const apiResolved = initApiBaseUrlForCli(repoRoot, flags, repoConfig);
@@ -28987,20 +29429,18 @@ async function main() {
         logExitCodeSummary(ExitCode.usage, flags);
         process.exit(ExitCode.usage);
       }
-      const agentsDir = resolveOpenCodeAgentsDir(repoRoot, repoConfig);
-      const agentsOk = fs62.existsSync(agentsDir);
-      const oc = getOpenCodeReadiness({
-        executable: merged.openCodeExecutable,
-        skipCredentialsCheck: merged.openCodeSkipCredentialsCheck,
-        providerEnvFromConfig: merged.openCodeChildEnv
-      });
-      const lines = [
-        `cliVersion=${PKG_VERSION}`,
-        `repoRoot=${repoRoot}`,
-        `apiBaseUrl=${apiResolved || "(empty \u2014 stub auth only)"}`,
-        `opencode installed=${String(oc.installed)} credentialsReady=${String(oc.credentialsReady)}`,
-        `agentsDir=${agentsDir} exists=${String(agentsOk)}`
-      ];
+      const readinessCtx = {
+        cliVersion: PKG_VERSION,
+        repoRootAbs: repoRoot,
+        analysisRootAbs: repoRoot,
+        apiBaseUrl: merged.apiBaseUrl,
+        openCodeExecutable: merged.openCodeExecutable,
+        openCodeSkipCredentialsCheck: merged.openCodeSkipCredentialsCheck,
+        providerEnvFromConfig: merged.openCodeChildEnv,
+        repoConfig
+      };
+      const facts = buildReadinessProbeFacts(readinessCtx);
+      const lines = buildReadinessLineBlock(facts, readinessCtx);
       const inspectPayload = buildDoctorInspectPayload(merged, repoConfig);
       if (!flags.json) {
         const parts = [];
@@ -29016,6 +29456,12 @@ async function main() {
       if (modes.readiness) {
         envelope.lines = lines;
         envelope.cliVersion = PKG_VERSION;
+        const jf = buildReadinessJsonFields(facts);
+        envelope.modelConfigured = jf.modelConfigured;
+        envelope.credentialsReady = jf.credentialsReady;
+        envelope.openCodeConfigFiles = jf.openCodeConfigFiles;
+        envelope.agentsDir = jf.agentsDir;
+        envelope.agentsDirExists = jf.agentsDirExists;
       }
       if (modes.inspectConfig) {
         envelope.config = inspectPayload;
@@ -29167,7 +29613,7 @@ async function main() {
       const result = await runSynthesisPipeline(
         storage,
         repoRoot,
-        path59.basename(repoRoot),
+        path60.basename(repoRoot),
         agentsDir,
         {
           ...merged.pipelineOpenCode
@@ -29222,7 +29668,7 @@ async function main() {
       if (sub === "reference-coverage") {
         const rootAbs = resolveAnalysisRoot(repoRoot, rootKind, worktree);
         requireMinimalGluecharmLayoutAt(rootAbs);
-        const contextDir2 = path59.join(rootAbs, ".gluecharm", "context");
+        const contextDir2 = path60.join(rootAbs, ".gluecharm", "context");
         const res = runCoveragePipeline({
           repositoryRootAbs: rootAbs,
           contextDirAbs: contextDir2,
@@ -29245,7 +29691,7 @@ async function main() {
       if (sub === "coordination-duplicates") {
         const rootAbs = resolveAnalysisRoot(repoRoot, rootKind, worktree);
         requireMinimalGluecharmLayoutAt(rootAbs);
-        const contextDir2 = path59.join(rootAbs, ".gluecharm", "context");
+        const contextDir2 = path60.join(rootAbs, ".gluecharm", "context");
         const res = runCoordinationDuplicatesDiagnosis({
           contextDirAbsolute: contextDir2,
           sourceRoot: rootKind === "worktree" ? "worktree" : "workspace"
@@ -29281,7 +29727,7 @@ async function main() {
       if (sub === "missing-artefacts") {
         const rootAbs = resolveAnalysisRoot(repoRoot, rootKind, worktree);
         requireMinimalGluecharmLayoutAt(rootAbs);
-        const ctxDir = path59.join(rootAbs, ".gluecharm", "context");
+        const ctxDir = path60.join(rootAbs, ".gluecharm", "context");
         const storage = createFileBackedWorkspaceState(repoRoot);
         const snap = readArtefactRunSnapshot(storage);
         const rows = listMissingWorkstations(ctxDir, rootAbs, snap);
@@ -29331,7 +29777,7 @@ async function main() {
           });
           const bad = poolRes.cancelled || poolRes.failures > 0;
           if (!bad) {
-            const ctxDir = path59.join(analysisRoot, ".gluecharm", "context");
+            const ctxDir = path60.join(analysisRoot, ".gluecharm", "context");
             const lg = runLinkMappingPipeline(ctxDir, { log: (line) => logErr(flags, line) });
             if (!lg.ok) {
               finish(OsExit.diagnoseZeroReferenceLinkMapping, {
@@ -29361,7 +29807,7 @@ async function main() {
       const worktree = wtExplicit ?? wtFromRoot;
       const rootAbs = resolveAnalysisRoot(repoRoot, rootKind, worktree);
       requireMinimalGluecharmLayoutAt(rootAbs);
-      const contextDir2 = path59.join(rootAbs, ".gluecharm", "context");
+      const contextDir2 = path60.join(rootAbs, ".gluecharm", "context");
       const res = runLinkMappingPipeline(contextDir2, {
         log: (line) => logErr(flags, line)
       });
@@ -29380,10 +29826,19 @@ async function main() {
       if (!refPath) {
         finish(ExitCode.usage, {
           ok: false,
-          error: "Usage: easyspecs-cli context drift <referencePath> [--label <slug>] [--index <path>] [--dry-run]"
+          error: "Usage: easyspecs-cli context drift <referencePath> [--label <slug>] [--index <path>] [--dry-run] [--in-place|--no-worktree|--noworktree]"
         });
       }
       const parsedTail = parseContextDriftTail(pos.slice(3));
+      const { rootKind, worktree: wtFromRoot } = parseTailFlags(parsedTail.rest);
+      const { worktree: wtExplicit } = parseWorktreeFlag(parsedTail.rest);
+      const extWorktree = wtExplicit ?? wtFromRoot;
+      if (parsedTail.inPlace && (rootKind === "worktree" || typeof extWorktree === "string" && extWorktree.trim().length > 0)) {
+        finish(ExitCode.usage, {
+          ok: false,
+          error: "`--no-worktree` cannot be combined with `--root worktree` or `--worktree <path>`."
+        });
+      }
       const leftover = stripRootWorktreeTokens(parsedTail.rest);
       if (leftover.length > 0) {
         finish(ExitCode.usage, {
@@ -29392,11 +29847,11 @@ async function main() {
         });
       }
       requireMinimalGluecharmLayoutAt(repoRoot);
-      if (!parsedTail.dryRun) {
-        requireOpenCode(merged, flags);
-      }
+      const readinessLog = (line) => {
+        process.stderr.write(`${line}
+`);
+      };
       const agentsDir = resolveOpenCodeAgentsDir(repoRoot, repoConfig);
-      assertAgentsDirExists(agentsDir);
       const storage = createFileBackedWorkspaceState(repoRoot);
       const ctrl = new AbortController();
       const dres = await runContextDriftFactory({
@@ -29409,8 +29864,11 @@ async function main() {
         label: parsedTail.label,
         indexOverrideArg: parsedTail.index,
         dryRun: parsedTail.dryRun,
+        inPlace: parsedTail.inPlace,
         signal: ctrl.signal,
-        log: (line) => logErr(flags, line)
+        log: (line) => logErr(flags, line),
+        cliVersion: PKG_VERSION,
+        readinessLog
       });
       if (dres.exitOk && dres.ok) {
         if (dres.driftReportPath && !flags.json && !dres.dryRun) {
@@ -29420,19 +29878,29 @@ async function main() {
         finish(ExitCode.ok, driftPayload);
       }
       if (dres.ok === false) {
-        const row2 = contextDriftFactoryFailureRow(dres.code, dres.error);
-        const driftExit = contextDriftExitCodeFor(dres.code, dres.error);
-        const { exitOk: _driftOkB, ...driftRest } = dres;
-        const envelope = {
-          ...driftRest,
-          ok: false,
-          factoryFailures: [row2],
-          error: composeFactoryValidationError(dres.error, [row2])
-        };
-        if (isContextDriftSrs70ValidationExit(driftExit)) {
-          Object.assign(envelope, primaryFailureAliases([row2]));
+        if (dres.code === "READINESS_FAILED") {
+          const ec = dres.readinessExitCode ?? OsExit.readinessOpenCodeCredentials;
+          const { exitOk: _ex, ...driftRest } = dres;
+          finish(ec, {
+            ...driftRest,
+            ok: false,
+            exitCode: ec
+          });
+        } else {
+          const row2 = contextDriftFactoryFailureRow(dres.code, dres.error);
+          const driftExit = contextDriftExitCodeFor(dres.code, dres.error);
+          const { exitOk: _driftOkB, ...driftRest } = dres;
+          const envelope = {
+            ...driftRest,
+            ok: false,
+            factoryFailures: [row2],
+            error: composeFactoryValidationError(dres.error, [row2])
+          };
+          if (isContextDriftSrs70ValidationExit(driftExit)) {
+            Object.assign(envelope, primaryFailureAliases([row2]));
+          }
+          finish(driftExit, envelope);
         }
-        finish(driftExit, envelope);
       }
       finish(ExitCode.internal, { ok: false, error: "Unexpected context drift result shape." });
     }
@@ -29441,6 +29909,9 @@ async function main() {
         if (a === "--force-new-context-analysis") {
           continue;
         }
+        if (a === "--no-worktree" || a === "--noworktree" || a === "--in-place") {
+          continue;
+        }
         if (a === "--upload") {
           finish(ExitCode.usage, {
             ok: false,
@@ -29455,10 +29926,11 @@ async function main() {
         }
         finish(ExitCode.usage, {
           ok: false,
-          error: `unknown analysis flag: ${a} (allowed: --force-new-context-analysis)`
+          error: `unknown analysis flag: ${a} (allowed: --force-new-context-analysis, --in-place, --no-worktree, --noworktree)`
         });
       }
       const forceNewContextAnalysis = positionals.includes("--force-new-context-analysis");
+      const analysisInPlace = positionals.includes("--no-worktree") || positionals.includes("--noworktree") || positionals.includes("--in-place");
       const cloudCached = readEasyspecsMergedSetting(
         repoConfig.easyspecs,
         "easyspecs.factory.cloudContextAnalyzed"
@@ -29481,11 +29953,19 @@ async function main() {
         });
       }
       requireMinimalGluecharmLayoutAt(repoRoot);
-      requireOpenCode(merged, flags);
       const agentsDir = resolveOpenCodeAgentsDir(repoRoot, repoConfig);
-      assertAgentsDirExists(agentsDir);
       const storage = createFileBackedWorkspaceState(repoRoot);
       const ctrl = new AbortController();
+      const analysisReadinessCtx = {
+        cliVersion: PKG_VERSION,
+        repoRootAbs: repoRoot,
+        analysisRootAbs: repoRoot,
+        apiBaseUrl: merged.apiBaseUrl,
+        openCodeExecutable: merged.openCodeExecutable,
+        openCodeSkipCredentialsCheck: merged.openCodeSkipCredentialsCheck,
+        providerEnvFromConfig: merged.openCodeChildEnv,
+        repoConfig
+      };
       const deps = buildFactoryDepsHeadless({
         storageContext: storage,
         repoRoot,
@@ -29496,15 +29976,22 @@ async function main() {
         }),
         log: (line) => logErr(flags, line),
         signal: ctrl.signal,
-        skipBackendSync: true
+        skipBackendSync: true,
+        inPlace: analysisInPlace,
+        readiness: analysisReadinessCtx
       });
       const res = await runGenerateContextFactory(deps);
       if (res.ok && res.cancelled !== true && flags.promote !== false) {
         const snap = readAnalysisWorkspaceSnapshot(storage);
         const wt = snap?.adHocWorktreePath?.trim();
         if (wt) {
-          const sourceCtx = path59.join(wt, ".gluecharm", "context");
-          if (fs62.existsSync(sourceCtx)) {
+          const sourceCtx = path60.join(wt, ".gluecharm", "context");
+          if (path60.resolve(wt) === path60.resolve(repoRoot)) {
+            logErr(
+              flags,
+              "[pipeline:analysis] promote skipped (in-place: analysis checkout is the repository root)"
+            );
+          } else if (fs63.existsSync(sourceCtx)) {
             const n = promoteContextDirectoryToWorkspaceFs(sourceCtx, repoRoot);
             logErr(flags, `[pipeline:analysis] promoted ${String(n.filesCopied)} file(s) \u2192 ${repoRoot}`);
           } else {
@@ -29524,19 +30011,24 @@ async function main() {
         ok: res.ok,
         cancelled: res.cancelled,
         totalElapsedMs: res.totalElapsedMs,
-        error: res.message
+        error: res.message,
+        ...analysisInPlace ? { analysisInPlace: true } : {}
       };
       if (!res.ok && !res.cancelled && res.factoryFailures && res.factoryFailures.length > 0) {
         analysisEnvelope.factoryFailures = res.factoryFailures;
         Object.assign(analysisEnvelope, primaryFailureAliases(res.factoryFailures));
         analysisEnvelope.error = composeFactoryValidationError(res.message, res.factoryFailures);
       }
+      if (res.readinessFailure) {
+        Object.assign(analysisEnvelope, res.readinessFailure);
+      }
       finish(
         res.ok ? ExitCode.ok : res.cancelled ? ExitCode.cancelled : processExitFromNormalizedFactoryFailures(res.factoryFailures),
         analysisEnvelope
       );
     }
     if (pos[0] === "update" && pos[1] === "context") {
+      let updateContextInPlace = false;
       for (const a of pos.slice(2)) {
         if (a === "--upload") {
           finish(ExitCode.usage, {
@@ -29544,14 +30036,20 @@ async function main() {
             error: "Removed flag: update context --upload. Run `easyspecs-cli upload context` or `upload republish` after update context completes."
           });
         }
+        if (a === "--no-worktree" || a === "--noworktree" || a === "--in-place") {
+          updateContextInPlace = true;
+          continue;
+        }
         finish(ExitCode.usage, { ok: false, error: `unknown update context flag: ${a}` });
       }
       requireMinimalGluecharmLayoutAt(repoRoot);
-      requireOpenCode(merged, flags);
       const agentsDir = resolveOpenCodeAgentsDir(repoRoot, repoConfig);
-      assertAgentsDirExists(agentsDir);
       const storage = createFileBackedWorkspaceState(repoRoot);
       const ctrl = new AbortController();
+      const readinessLog = (line) => {
+        process.stderr.write(`${line}
+`);
+      };
       const ures = await runUpdateContextFactory({
         repoRootAbs: repoRoot,
         repoConfig,
@@ -29559,10 +30057,13 @@ async function main() {
         agentsDirFs: agentsDir,
         storage,
         signal: ctrl.signal,
-        log: (line) => logErr(flags, line)
+        log: (line) => logErr(flags, line),
+        inPlace: updateContextInPlace,
+        cliVersion: PKG_VERSION,
+        readinessLog
       });
       const { exitOk, ...payload } = ures;
-      const code = exitOk ? ExitCode.ok : ures.code === "MISSING_BASELINE" ? ExitCode.usage : OsExit.updateContextFactory;
+      const code = exitOk ? ExitCode.ok : ures.code === "MISSING_BASELINE" ? ExitCode.usage : ures.code === "READINESS_FAILED" && typeof ures.readinessExitCode === "number" ? ures.readinessExitCode : OsExit.updateContextFactory;
       finish(code, payload);
     }
     if (pos[0] === "download" && pos[1] === "context") {
@@ -29587,10 +30088,10 @@ async function main() {
         finish(ExitCode.usage, { ok: false, error: `unknown download context flag: ${a}` });
       }
       requireMinimalGluecharmLayoutAt(repoRoot);
-      const ctxDir = path59.resolve(path59.join(repoRoot, ".gluecharm", "context"));
-      const gluecharmParent = path59.dirname(ctxDir);
-      if (path59.basename(gluecharmParent) === ".gluecharm" && path59.basename(ctxDir) === "context") {
-        requireMinimalGluecharmLayoutAt(path59.dirname(gluecharmParent));
+      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 appIdRaw = getEasyspecsProjectIdFromRepoConfig(repoConfig)?.trim();
       if (!appIdRaw) {
@@ -29673,16 +30174,16 @@ async function main() {
       }
       const sess = sessRaw;
       requireMinimalGluecharmLayoutAt(repoRoot);
-      let ctxDir = path59.join(repoRoot, ".gluecharm", "context");
+      let ctxDir = path60.join(repoRoot, ".gluecharm", "context");
       if (pos[1] === "republish") {
         const fromCfg = repoConfig.easyspecs?.upload?.contextDirectory?.trim();
-        const resolvedOverride = fromCfg && fromCfg.length > 0 ? path59.isAbsolute(fromCfg) ? path59.normalize(fromCfg) : path59.resolve(repoRoot, fromCfg) : "";
-        if (resolvedOverride && fs62.existsSync(path59.join(resolvedOverride, ".."))) {
+        const resolvedOverride = fromCfg && fromCfg.length > 0 ? path60.isAbsolute(fromCfg) ? path60.normalize(fromCfg) : path60.resolve(repoRoot, fromCfg) : "";
+        if (resolvedOverride && fs63.existsSync(path60.join(resolvedOverride, ".."))) {
           ctxDir = resolvedOverride;
         } else {
           const storage = createFileBackedWorkspaceState(repoRoot);
           const snap = readAnalysisWorkspaceSnapshot(storage);
-          const wt = snap?.adHocWorktreePath && fs62.existsSync(path59.join(snap.adHocWorktreePath, ".gluecharm", "context")) ? path59.join(snap.adHocWorktreePath, ".gluecharm", "context") : "";
+          const wt = snap?.adHocWorktreePath && fs63.existsSync(path60.join(snap.adHocWorktreePath, ".gluecharm", "context")) ? path60.join(snap.adHocWorktreePath, ".gluecharm", "context") : "";
           if (!wt) {
             finish(ExitCode.misconfiguration, {
               ok: false,
@@ -29692,10 +30193,10 @@ async function main() {
           ctxDir = wt;
         }
       }
-      const ctxResolved = path59.resolve(ctxDir);
-      const gluecharmParent = path59.dirname(ctxResolved);
-      if (path59.basename(gluecharmParent) === ".gluecharm" && path59.basename(ctxResolved) === "context") {
-        requireMinimalGluecharmLayoutAt(path59.dirname(gluecharmParent));
+      const ctxResolved = path60.resolve(ctxDir);
+      const gluecharmParent = path60.dirname(ctxResolved);
+      if (path60.basename(gluecharmParent) === ".gluecharm" && path60.basename(ctxResolved) === "context") {
+        requireMinimalGluecharmLayoutAt(path60.dirname(gluecharmParent));
       }
       const appIdRaw = getEasyspecsProjectIdFromRepoConfig(repoConfig)?.trim();
       if (!appIdRaw) {
@@ -29799,18 +30300,18 @@ async function main() {
       finish(failed ? ExitCode.upload : ExitCode.ok, primary);
     }
     if (pos[0] === "ace" && pos[1] === "clear") {
-      const learnings = path59.join(repoRoot, ".gluecharm", "context", "learnings");
-      if (!fs62.existsSync(learnings)) {
+      const learnings = path60.join(repoRoot, ".gluecharm", "context", "learnings");
+      if (!fs63.existsSync(learnings)) {
         finish(ExitCode.ok, { ok: true, message: "nothing to clear" });
       }
-      fs62.rmSync(learnings, { recursive: true, force: true });
+      fs63.rmSync(learnings, { recursive: true, force: true });
       finish(ExitCode.ok, { ok: true, message: `cleared ${learnings}` });
     }
     if (pos[0] === "ace" && pos[1] === "learn") {
       requireOpenCode(merged, flags);
       const { worktree } = parseWorktreeFlag(pos.slice(2));
-      const root = worktree && fs62.existsSync(path59.join(worktree, ".opencode", "schemas", "ace")) ? worktree : repoRoot;
-      const contextDir2 = path59.join(root, ".gluecharm", "context");
+      const root = worktree && fs63.existsSync(path60.join(worktree, ".opencode", "schemas", "ace")) ? worktree : repoRoot;
+      const contextDir2 = path60.join(root, ".gluecharm", "context");
       const traces = listAceTraceFiles(contextDir2);
       if (traces.length === 0) {
         finish(ExitCode.ok, { ok: true, message: "no traces", traceCount: 0 });
@@ -29834,8 +30335,8 @@ async function main() {
     if (pos[0] === "ace" && pos[1] === "auto-learn") {
       requireOpenCode(merged, flags);
       const { worktree } = parseWorktreeFlag(pos.slice(2));
-      const root = worktree && fs62.existsSync(path59.join(worktree, ".git")) ? worktree : repoRoot;
-      const contextDir2 = path59.join(root, ".gluecharm", "context");
+      const root = worktree && fs63.existsSync(path60.join(worktree, ".git")) ? worktree : repoRoot;
+      const contextDir2 = path60.join(root, ".gluecharm", "context");
       const pending = listPendingAceTraceFiles(contextDir2, root);
       if (pending.length === 0) {
         finish(ExitCode.ok, { ok: true, pending: 0 });