@gluecharm-lab/easyspecs-cli 0.3.0 → 0.3.2

package/commands.md

@@ -38,7 +38,7 @@ When `**easyspecs-cli analysis`** exits **non-zero** with factory failures, huma
 | `**error**`            | Orchestrator message; if several phases failed, a short appendix lists extra `**failureExitId`**s (see `[factoryValidationFailures.ts](../../src/factory/factoryValidationFailures.ts)`).                                                  |
 
 
-**Phase → OS exit (generate_context):** **84–86** **`diagnose_readiness`** when a **readiness gate (a)–(c)** fails (**SRS-72** — install, credentials, model); **87** is reserved (mandatory **`opencode.json`** no longer blocks once **(a)–(c)** pass); **50** `create_analysis_worktree`, **51** `materialize_opencode_agents`, **52** `synthesis_convergence`, **53** `reference_coverage`, **54** `zero_reference_remediation_convergence`, **55** `reference_coverage_execution_report`, **56** `link_mapping_pipeline`, **57** `assemble_application_context_index`, **58** `backend_context_sync`, **49** unknown / unattributed. Full table: `[error-code.md](./error-code.md)`.
+**Phase → OS exit (generate_context):** **84–85** **`diagnose_readiness`** when a **readiness gate (a)** or **(b)** fails (**SRS-72** — OpenCode not installed, or credentials not ready); **86–87** are **reserved** (readiness no longer exits for a missing default model when **(a)** and **(b)** pass); **50** `create_analysis_worktree`, **51** `materialize_opencode_agents`, **52** `synthesis_convergence`, **53** `reference_coverage`, **54** `zero_reference_remediation_convergence`, **55** `reference_coverage_execution_report`, **56** `link_mapping_pipeline`, **57** `assemble_application_context_index`, **58** `backend_context_sync`, **49** unknown / unattributed. Full table: `[error-code.md](./error-code.md)`.
 
 **Optional `validationSubcode` (v1):** `**R5_MACRO_PING_PONG`** when synthesis `**detail**` notes **R5** unstable convergence; `**COVERAGE_PERCENT_THRESHOLD`** when reference-coverage `**detail**` matches the strict percent gate pattern.
 

package/dist/main.cjs

@@ -10677,7 +10677,7 @@ var OsExit = {
   readinessOpenCodeNotInstalled: 84,
   /** SRS-72 readiness gate (b): credentials not ready. */
   readinessOpenCodeCredentials: 85,
-  /** SRS-72 readiness gate (c): default model not configured. */
+  /** SRS-72: reserved — readiness no longer exits for missing default model when install + credentials pass. */
   readinessOpenCodeModel: 86,
   /** SRS-72 readiness gate (d): mandatory OpenCode config file missing. */
   readinessOpenCodeMandatoryConfig: 87
@@ -10778,9 +10778,9 @@ function describeExitCode(code) {
     case OsExit.readinessOpenCodeCredentials:
       return "OpenCode credentials not ready for factory run.";
     case OsExit.readinessOpenCodeModel:
-      return "OpenCode default model is not configured \u2014 add `model` (or equivalent) in repo `opencode.json` / `opencode.jsonc`, global `~/.config/opencode/opencode.json`, `OPENCODE_CONFIG` / `OPENCODE_CONFIG_DIR`, managed config (see OpenCode docs), or `easyspecs.openCodeRuntime.providers`.";
+      return "Reserved exit code 86 \u2014 factory readiness no longer fails solely for a missing OpenCode default model when the CLI is installed and credentials are ready; configure a model in OpenCode or EasySpecs settings if agent runs fail later.";
     case OsExit.readinessOpenCodeMandatoryConfig:
-      return "Readiness gate (d) reserved \u2014 repo-root `opencode.json` is optional when OpenCode is installed, credentials are ready, and a model is configured.";
+      return "Reserved exit code 87 \u2014 factory readiness does not fail for a missing repo-root `opencode.json` in the current product rules.";
     default:
       return `Non-zero exit (${String(code)}) \u2014 see stderr and any JSON \`error\` field for detail.`;
   }
@@ -14603,7 +14603,7 @@ function runOpenCodeAgent(cwd, args, options) {
       cwd,
       shell: USE_SHELL,
       env: spawnEnv,
-      stdio: ["ignore", "pipe", "pipe"]
+      stdio: ["pipe", "pipe", "pipe"]
     });
     let childResourceLogged = false;
     let cpuBaseline;
@@ -21762,7 +21762,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).",
+  diagnose_readiness: "OpenCode CLI and credentials are required before worktree / agent work; default model is reported (informational) but does not block readiness when install and credentials pass (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.",
@@ -21790,6 +21790,21 @@ function openCodeUserConfigDir() {
   const cfgRoot = xdg && xdg.length > 0 ? xdg : path34.join(os6.homedir(), ".config");
   return path34.join(cfgRoot, "opencode");
 }
+function openCodeMacUserApplicationSupportDir() {
+  if (process.platform === "darwin") {
+    return path34.join(os6.homedir(), "Library", "Application Support", "opencode");
+  }
+  return void 0;
+}
+function openCodeWindowsLocalAppDataDir() {
+  if (process.platform === "win32") {
+    const la = process.env.LOCALAPPDATA?.trim();
+    if (la && la.length > 0) {
+      return path34.join(la, "opencode");
+    }
+  }
+  return void 0;
+}
 function managedOpenCodeConfigDir() {
   if (process.platform === "darwin") {
     return "/Library/Application Support/opencode";
@@ -21829,14 +21844,22 @@ function openCodeJsonModelFileCandidates(analysisRootAbs) {
   if (oc) {
     acc.push(path34.resolve(oc));
   }
-  pushConfigBasenames(acc, root);
-  pushConfigBasenames(acc, path34.join(root, ".opencode"));
+  pushConfigBasenames(acc, openCodeUserConfigDir());
+  const macAs = openCodeMacUserApplicationSupportDir();
+  if (macAs) {
+    pushConfigBasenames(acc, macAs);
+  }
+  const winLoc = openCodeWindowsLocalAppDataDir();
+  if (winLoc) {
+    pushConfigBasenames(acc, winLoc);
+  }
+  pushConfigBasenames(acc, path34.join(os6.homedir(), ".opencode"));
   const ocd = process.env.OPENCODE_CONFIG_DIR?.trim();
   if (ocd) {
     pushConfigBasenames(acc, path34.resolve(ocd));
   }
-  pushConfigBasenames(acc, openCodeUserConfigDir());
-  pushConfigBasenames(acc, path34.join(os6.homedir(), ".opencode"));
+  pushConfigBasenames(acc, root);
+  pushConfigBasenames(acc, path34.join(root, ".opencode"));
   const managed = managedOpenCodeConfigDir();
   if (managed) {
     pushConfigBasenames(acc, managed);
@@ -21848,7 +21871,6 @@ function openCodeJsonModelFileCandidates(analysisRootAbs) {
 var MANDATORY_OPEN_CODE_CONFIG_REL_PATHS = ["opencode.json"];
 var READINESS_OPENCODE_NOT_INSTALLED = "READINESS_OPENCODE_NOT_INSTALLED";
 var READINESS_OPENCODE_CREDENTIALS = "READINESS_OPENCODE_CREDENTIALS";
-var READINESS_OPENCODE_MODEL = "READINESS_OPENCODE_MODEL";
 function buildOpenCodeConfigInventory(analysisRootAbs) {
   return openCodeJsonModelFileCandidates(analysisRootAbs).map((p) => ({ path: p, exists: fs39.existsSync(p) }));
 }
@@ -21868,19 +21890,37 @@ function defaultModelFromEasyspecsConfig(cfg) {
 function pickString(v) {
   return typeof v === "string" && v.trim().length > 0 ? v.trim() : void 0;
 }
+function pickModelLike(v) {
+  const s = pickString(v);
+  if (s) {
+    return s;
+  }
+  if (v && typeof v === "object") {
+    const r = v;
+    return pickString(r.id) ?? pickString(r.name) ?? pickString(r.model);
+  }
+  return void 0;
+}
+function modelFromEasyspecsProjectConfigOverlay(cfg) {
+  const overlay = cfg.easyspecs?.openCodeRuntime?.projectConfigOverlay;
+  if (!overlay || typeof overlay !== "object") {
+    return void 0;
+  }
+  return extractModelFromOpenCodeJson(overlay);
+}
 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 top = pickModelLike(o.model) ?? pickString(o.defaultModel) ?? pickModelLike(o.small_model) ?? pickString(o.smallModel);
+  if (top) {
+    return top;
   }
   const models = o.models;
   if (models && typeof models === "object") {
     const m = models;
-    const def = pickString(m.default) ?? pickString(m.defaultModel);
+    const def = pickModelLike(m.default) ?? pickString(m.defaultModel);
     if (def) {
       return def;
     }
@@ -21888,11 +21928,23 @@ function extractModelFromOpenCodeJson(data) {
   const agent = o.agent;
   if (agent && typeof agent === "object") {
     const a = agent;
-    const am = pickString(a.model) ?? pickString(a.defaultModel);
+    const am = pickModelLike(a.model) ?? pickString(a.defaultModel);
     if (am) {
       return am;
     }
   }
+  const prov = o.provider;
+  if (prov && typeof prov === "object") {
+    for (const v of Object.values(prov)) {
+      if (v && typeof v === "object") {
+        const rec = v;
+        const pm = pickModelLike(rec.model);
+        if (pm) {
+          return pm;
+        }
+      }
+    }
+  }
   return void 0;
 }
 function parseOpenCodeConfigText(raw) {
@@ -21948,6 +22000,10 @@ function resolveModelFromContext(ctx) {
   if (fromCfg) {
     return { configured: true, summary: sanitizeModelSummary(fromCfg) };
   }
+  const fromOverlay = modelFromEasyspecsProjectConfigOverlay(ctx.repoConfig);
+  if (fromOverlay) {
+    return { configured: true, summary: sanitizeModelSummary(fromOverlay) };
+  }
   const fromInline = modelFromOpencodeConfigContentEnv();
   if (fromInline) {
     return { configured: true, summary: sanitizeModelSummary(fromInline) };
@@ -22018,14 +22074,6 @@ function evaluateReadinessGates(facts) {
       readinessReasonCode: READINESS_OPENCODE_CREDENTIALS
     };
   }
-  if (!facts.modelConfigured) {
-    return {
-      ok: false,
-      gate: "c",
-      exitCode: OsExit.readinessOpenCodeModel,
-      readinessReasonCode: READINESS_OPENCODE_MODEL
-    };
-  }
   return { ok: true };
 }
 function buildReadinessJsonFields(facts) {
@@ -22100,7 +22148,8 @@ var ERROR_JOIN_MAX = 900;
 var ADDITIONAL_APPEND_MAX = 200;
 var PHASE_TO_OS_EXIT = {
   unknown_factory_phase: OsExit.factoryUnknown,
-  diagnose_readiness: OsExit.readinessOpenCodeModel,
+  /** Fallback when a failed row lacks an explicit exitCode; real readiness failures embed 84/85 from gates. */
+  diagnose_readiness: OsExit.readinessOpenCodeNotInstalled,
   create_analysis_worktree: OsExit.createAnalysisWorktree,
   materialize_opencode_agents: OsExit.materializeOpenCodeAgents,
   synthesis_convergence: OsExit.synthesisConvergence,
@@ -22113,7 +22162,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.",
+  diagnose_readiness: "Factory readiness preflight failed \u2014 see stderr lines above and `readinessReasonCode` / `readinessGate` 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.",
@@ -29036,7 +29085,7 @@ function formatCliStderrLine(line, useAnsi) {
 }
 
 // src/cli/main.ts
-var PKG_VERSION = "0.3.0";
+var PKG_VERSION = "0.3.2";
 function isNonEmptyFactoryFailureArray(x) {
   if (!Array.isArray(x) || x.length === 0) {
     return false;