@structured-vibe-coding/core 0.16.1 → 0.16.2

package/README.md

@@ -10,11 +10,31 @@ Used by [`@structured-vibe-coding/cli`](https://www.npmjs.com/package/@structure
 npm install @structured-vibe-coding/core
 ```
 
+## Architecture
+
+```text
+cli  →  core  →  fs / zod / yaml / MCP SDK / typescript
+```
+
+- **Public API:** only what is exported from `src/index.ts`.
+- **Do not** import deep paths (`@structured-vibe-coding/core/src/...`) from apps.
+- CLI owns UX (prompts, colors, agent launch). Core owns process state and pure logic.
+
+## Public surface (stable intent)
+
+| Area | Examples |
+|------|----------|
+| Lifecycle | `initProject`, `createChange`, `advanceStage`, `completeChange` |
+| Gates | `canLeaveStage`, `approveGate` |
+| Greenfield | `startGreenfield`, `startFeatureFromBacklog` |
+| Code context | `generateCodeContext` |
+| MCP *client* | `loadMcpConfig`, `addMcpSource`, `gatherMcpContext` |
+| Errors | `SddError`, `isSddError` |
+
 ## Docs
 
-- **Site (GitHub Pages):** https://harsha09.github.io/spec-driven-development/
-- [First change tutorial](https://harsha09.github.io/spec-driven-development/tutorials/first-change/)
-- [Greenfield](https://harsha09.github.io/spec-driven-development/guides/greenfield/)
+- **Site:** https://harsha09.github.io/spec-driven-development/
+- [MCP sources](https://harsha09.github.io/spec-driven-development/guides/mcp/)
 - [Repository](https://github.com/harsha09/spec-driven-development)
 
 ## License

package/dist/{agents-TJQMAD24.js → agents-3MD2GPYI.js}

@@ -19,11 +19,12 @@ import {
   removeOtherAgentHosts,
   renderThinAgent,
   writeAgentHandoff
-} from "./chunk-AOIPJ4FM.js";
-import "./chunk-M7YRPPNU.js";
-import "./chunk-OJFMJHNL.js";
+} from "./chunk-BTUI2WYQ.js";
+import "./chunk-BCLKMBKF.js";
+import "./chunk-WHDG6OTG.js";
 import "./chunk-A752UVPF.js";
 import "./chunk-67AUAGNV.js";
+import "./chunk-MHODNFIL.js";
 import "./chunk-7MJYPJMR.js";
 import "./chunk-EPFURATC.js";
 export {

package/dist/{chunk-VD3CPFAI.js → chunk-2C3WHUAR.js}

@@ -3,22 +3,71 @@ import {
   interpolateArgs,
   loadMcpConfig
 } from "./chunk-KYWETNFU.js";
+import {
+  SddError
+} from "./chunk-MHODNFIL.js";
 
 // src/mcp/client.ts
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+
+// src/env.ts
+function toProcessEnv(base, extra) {
+  const out = {};
+  for (const [k, v] of Object.entries(base)) {
+    if (v !== void 0) out[k] = String(v);
+  }
+  if (extra) {
+    for (const [k, v] of Object.entries(extra)) {
+      if (v !== void 0) out[k] = String(v);
+    }
+  }
+  return out;
+}
+
+// src/version.ts
+var SDD_CORE_VERSION = "0.16.2" ? "0.16.2" : "0.0.0-dev";
+
+// src/mcp/client.ts
+function mcpTimeoutMs() {
+  const raw = process.env.SDD_MCP_TIMEOUT_MS;
+  if (raw) {
+    const n = Number(raw);
+    if (Number.isFinite(n) && n > 0) return n;
+  }
+  return 3e4;
+}
 function contentToText(result) {
   const parts = result.content ?? [];
   return parts.map((p) => p.type === "text" ? p.text ?? "" : JSON.stringify(p)).join("\n").trim();
 }
+async function withTimeout(promise, ms, label) {
+  let timer;
+  try {
+    return await Promise.race([
+      promise,
+      new Promise((_, reject) => {
+        timer = setTimeout(() => {
+          reject(
+            new SddError(`MCP ${label} timed out after ${ms}ms`, {
+              code: "MCP_TIMEOUT",
+              hint: "Raise SDD_MCP_TIMEOUT_MS or fix the source server."
+            })
+          );
+        }, ms);
+      })
+    ]);
+  } finally {
+    if (timer) clearTimeout(timer);
+  }
+}
 async function withMcpSource(source, projectRoot, fn) {
   const vars = { projectRoot };
   const cwd = source.cwd ? interpolate(source.cwd, vars) : projectRoot;
-  const env = {
-    ...process.env,
+  const env = toProcessEnv(process.env, {
     ...source.env,
     SDD_PROJECT_ROOT: projectRoot
-  };
+  });
   const transport = new StdioClientTransport({
     command: source.command,
     args: source.args,
@@ -27,11 +76,12 @@ async function withMcpSource(source, projectRoot, fn) {
   });
   const client = new Client({
     name: "sdd-mcp-client",
-    version: "0.14.0"
+    version: SDD_CORE_VERSION
   });
-  await client.connect(transport);
+  const ms = mcpTimeoutMs();
+  await withTimeout(client.connect(transport), ms, `connect (${source.id})`);
   try {
-    return await fn(client);
+    return await withTimeout(fn(client), ms, `call (${source.id})`);
   } finally {
     try {
       await client.close();
@@ -156,16 +206,8 @@ async function gatherMcpContext(opts) {
       continue;
     }
     const baseArgs = opts.args ?? source.invoke?.args ?? {};
-    const args = interpolateArgs(
-      baseArgs,
-      vars
-    );
-    const called = await callMcpSourceTool(
-      source,
-      opts.projectRoot,
-      tool,
-      args
-    );
+    const args = interpolateArgs(baseArgs, vars);
+    const called = await callMcpSourceTool(source, opts.projectRoot, tool, args);
     const max = cfg.max_chars_per_source ?? 6e3;
     let text = called.text;
     if (text.length > max) {
@@ -224,6 +266,9 @@ function listMatchingSourceIds(sources, match) {
 }
 
 export {
+  toProcessEnv,
+  SDD_CORE_VERSION,
+  mcpTimeoutMs,
   withMcpSource,
   listMcpSourceTools,
   callMcpSourceTool,

package/dist/{chunk-M7YRPPNU.js → chunk-BCLKMBKF.js}

@@ -50,9 +50,7 @@ async function buildAgentPrompt(ctx, config, projectRoot) {
   parts.push(`- Title: ${ctx.meta.title}`);
   parts.push(`- ID: ${ctx.id}`);
   parts.push(`- Workflow: ${ctx.meta.workflow}`);
-  parts.push(
-    `- Current stage: ${ctx.meta.stage}${stage?.title ? ` (${stage.title})` : ""}`
-  );
+  parts.push(`- Current stage: ${ctx.meta.stage}${stage?.title ? ` (${stage.title})` : ""}`);
   parts.push(`- Change path: ${ctx.path}`);
   parts.push("");
   if (stage?.summary) {
@@ -93,53 +91,41 @@ async function buildAgentPrompt(ctx, config, projectRoot) {
   if (stageId === "implement" || stageId === "local_verify") {
     parts.push(`## Code context (product code)`);
     parts.push("");
-    parts.push(
-      `Process context above is not enough for product code structure.`
-    );
-    parts.push(
-      `When you need symbols, callers, or package-boundary context:`
-    );
+    parts.push(`Process context above is not enough for product code structure.`);
+    parts.push(`When you need symbols, callers, or package-boundary context:`);
     parts.push(
       `1. Run: \`sdd context\` (optional: \`--path \u2026\`, \`--symbol \u2026\`, \`--out change\`)`
     );
-    parts.push(
-      `2. If present, read: \`changes/${ctx.id}/code-context.md\` (regenerate if stale)`
-    );
+    parts.push(`2. If present, read: \`changes/${ctx.id}/code-context.md\` (regenerate if stale)`);
     parts.push(
       `3. Org libraries / remote AST: \`.sdd/mcp.yaml\` sources via \`sdd mcp sources\` / \`sdd mcp fetch\``
     );
-    parts.push(
-      `Do not dump unbounded source into the prompt; prefer sliced / MCP output.`
-    );
+    parts.push(`Do not dump unbounded source into the prompt; prefer sliced / MCP output.`);
     parts.push("");
   }
   try {
     const { loadMcpConfig } = await import("./sources-PF45EUH2.js");
-    const {
-      gatherMcpContextForChange,
-      formatMcpContextForHandoff
-    } = await import("./gather-74DQ35QX.js");
+    const { gatherMcpContextForChange, formatMcpContextForHandoff } = await import("./gather-2LQ464XU.js");
     const mcpCfg = await loadMcpConfig(projectRoot);
     if (mcpCfg.auto_fetch_on_handoff && mcpCfg.sources.length) {
       const fetched = await gatherMcpContextForChange(projectRoot, ctx);
-      const block = formatMcpContextForHandoff(
-        fetched.filter((r) => r.ok || r.error)
-      );
+      const block = formatMcpContextForHandoff(fetched.filter((r) => r.ok || r.error));
       if (block) {
         parts.push(block);
       }
     } else if (mcpCfg.sources.length === 0) {
       parts.push(`## External MCP sources`);
       parts.push("");
-      parts.push(
-        `No sources in \`.sdd/mcp.yaml\` yet. To attach org libraries / AST engines:`
-      );
-      parts.push(
-        `\`sdd mcp sources add --help\` \xB7 docs: Configure MCP sources`
-      );
+      parts.push(`No sources in \`.sdd/mcp.yaml\` yet. To attach org libraries / AST engines:`);
+      parts.push(`\`sdd mcp sources add --help\` \xB7 docs: Configure MCP sources`);
       parts.push("");
     }
-  } catch {
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    parts.push(`## External MCP sources`);
+    parts.push("");
+    parts.push(`_MCP auto-fetch skipped (non-fatal): ${msg}_`);
+    parts.push("");
   }
   parts.push(
     `When done with this stage, the human will run \`sdd next\` or \`sdd verify\` / \`sdd complete\`.`

package/dist/{chunk-AOIPJ4FM.js → chunk-BTUI2WYQ.js}

@@ -1,10 +1,10 @@
 import {
   buildAgentPrompt,
   formatStatus
-} from "./chunk-M7YRPPNU.js";
+} from "./chunk-BCLKMBKF.js";
 import {
   loadConfig
-} from "./chunk-OJFMJHNL.js";
+} from "./chunk-WHDG6OTG.js";
 import {
   buildContext,
   getActiveChangeId
@@ -86,14 +86,7 @@ var AGENT_TARGET_OPTIONS = AGENT_INTEGRATIONS.map(
     installUrl
   })
 );
-var IDE_NAMES = /* @__PURE__ */ new Set([
-  "intellij",
-  "idea",
-  "jetbrains",
-  "vscode",
-  "vs-code",
-  "cursor"
-]);
+var IDE_NAMES = /* @__PURE__ */ new Set(["intellij", "idea", "jetbrains", "vscode", "vs-code", "cursor"]);
 function getIntegration(target) {
   const found = AGENT_INTEGRATIONS.find((i) => i.id === target);
   if (!found) throw new Error(`Unknown agent integration: ${target}`);

package/dist/chunk-MHODNFIL.js

@@ -0,0 +1,26 @@
+// src/errors.ts
+var SddError = class extends Error {
+  code;
+  hint;
+  exitCode;
+  constructor(message, options) {
+    super(message, options?.cause !== void 0 ? { cause: options.cause } : void 0);
+    this.name = "SddError";
+    this.code = options?.code ?? "SDD_ERROR";
+    this.hint = options?.hint;
+    this.exitCode = options?.exitCode ?? 1;
+  }
+};
+function isSddError(err) {
+  return err instanceof SddError;
+}
+function errorMessage(err) {
+  if (err instanceof Error) return err.message;
+  return String(err);
+}
+
+export {
+  SddError,
+  isSddError,
+  errorMessage
+};

package/dist/{chunk-BIY3WKP3.js → chunk-TNZHQ6B5.js}

@@ -40,12 +40,6 @@ import {
 // src/greenfield.ts
 import { join as join3 } from "pathe";
 
-// src/change.ts
-import { join as join2 } from "pathe";
-
-// src/stage-gates.ts
-import { join } from "pathe";
-
 // src/artifacts.ts
 function isSubstantiveArtifactContent(content) {
   const stripped = content.replace(/<!--[\s\S]*?-->/g, "").replace(/^#{1,6}\s+.*$/gm, "").replace(/^>\s.*$/gm, "").replace(/^\s*[-*+]\s*$/gm, "").replace(/^\s*[-*+]\s*\.\.\.\s*$/gm, "").replace(/^\s*[-*+]\s*TBD\s*$/gim, "").replace(/^\s*[-*+]\s*TODO\s*$/gim, "").replace(/^\s*\|.*\|\s*$/gm, "").replace(/`+/g, "").trim();
@@ -73,7 +67,11 @@ function incompleteArtifactReason(path, content) {
   return null;
 }
 
+// src/change.ts
+import { join as join2 } from "pathe";
+
 // src/stage-gates.ts
+import { join } from "pathe";
 async function checkRequiredArtifacts(changePath2, stageId, artifacts) {
   const errors = [];
   for (const artifact of artifacts) {
@@ -110,11 +108,7 @@ async function incompletePriorStageErrors(ctx) {
     }
     const required = stage.artifacts.filter((a) => a.required);
     if (!required.length && stage.optional) continue;
-    const stageErrors = await checkRequiredArtifacts(
-      ctx.path,
-      stage.id,
-      stage.artifacts
-    );
+    const stageErrors = await checkRequiredArtifacts(ctx.path, stage.id, stage.artifacts);
     if (stageErrors.length) {
       errors.push(
         `Prior stage "${stage.id}" is not complete \u2014 finish it or \`sdd skip ${stage.id} -r "\u2026"\` if optional.`
@@ -132,9 +126,7 @@ async function canLeaveStage(ctx, config) {
     return { ok: false, errors: [`Unknown stage: ${ctx.meta.stage}`], warnings };
   }
   errors.push(...await incompletePriorStageErrors(ctx));
-  errors.push(
-    ...await checkRequiredArtifacts(ctx.path, stage.id, stage.artifacts)
-  );
+  errors.push(...await checkRequiredArtifacts(ctx.path, stage.id, stage.artifacts));
   const declared = stage.gate?.type ?? "soft";
   let effectiveGate = declared;
   if (config.policy.gates === "hard" && declared === "soft") {
@@ -149,9 +141,7 @@ async function canLeaveStage(ctx, config) {
     }
   } else if (effectiveGate === "soft" && stage.gate?.checklist?.length) {
     if (!gateState || gateState.status === "pending") {
-      warnings.push(
-        `Soft gate checklist not signed off on "${stage.id}" (proceeding allowed).`
-      );
+      warnings.push(`Soft gate checklist not signed off on "${stage.id}" (proceeding allowed).`);
     }
   }
   const requiredCmds = stage.verify?.commands?.filter((c) => c.required) ?? [];
@@ -245,7 +235,7 @@ async function createChange(input) {
   await materializeStageArtifacts(projectRoot, config, id, workflow, meta, firstStage);
   await setActiveChange(projectRoot, config, id);
   try {
-    const { refreshActiveAgentContext } = await import("./agents-TJQMAD24.js");
+    const { refreshActiveAgentContext } = await import("./agents-3MD2GPYI.js");
     await refreshActiveAgentContext(projectRoot);
   } catch {
   }
@@ -312,7 +302,7 @@ function defaultArtifactContent(artifactId, meta, stage, workflow) {
 `;
 }
 async function advanceStage(projectRoot, config, changeId, opts) {
-  let ctx = await buildContext(projectRoot, config, changeId);
+  const ctx = await buildContext(projectRoot, config, changeId);
   const warnings = [];
   if (ctx.meta.status === "completed") {
     throw new Error("Change is already completed.");
@@ -333,7 +323,7 @@ async function advanceStage(projectRoot, config, changeId, opts) {
         stage2
       );
       try {
-        const { refreshActiveAgentContext } = await import("./agents-TJQMAD24.js");
+        const { refreshActiveAgentContext } = await import("./agents-3MD2GPYI.js");
         await refreshActiveAgentContext(projectRoot);
       } catch {
       }
@@ -380,7 +370,7 @@ async function advanceStage(projectRoot, config, changeId, opts) {
     stage
   );
   try {
-    const { refreshActiveAgentContext } = await import("./agents-TJQMAD24.js");
+    const { refreshActiveAgentContext } = await import("./agents-3MD2GPYI.js");
     await refreshActiveAgentContext(projectRoot);
   } catch {
   }
@@ -412,10 +402,7 @@ async function skipStage(projectRoot, config, changeId, stageId, reason) {
   const skip_stages = new Set(ctx.meta.overrides.skip_stages ?? []);
   skip_stages.add(stageId);
   ctx.meta.overrides.skip_stages = [...skip_stages];
-  ctx.meta.skipped = [
-    ...ctx.meta.skipped ?? [],
-    { stage: stageId, reason, at: nowIso() }
-  ];
+  ctx.meta.skipped = [...ctx.meta.skipped ?? [], { stage: stageId, reason, at: nowIso() }];
   if (ctx.meta.stage === stageId) {
     const next = nextStageId(ctx.workflow, ctx.meta);
     if (next) {
@@ -484,7 +471,7 @@ async function completeChange(projectRoot, config, changeId) {
   let promoted;
   if (ctx.meta.workflow === "greenfield" || ctx.meta.flags?.greenfield === true) {
     try {
-      const { promoteGreenfieldToMemory: promoteGreenfieldToMemory2 } = await import("./greenfield-PKVWSKHN.js");
+      const { promoteGreenfieldToMemory: promoteGreenfieldToMemory2 } = await import("./greenfield-YUAMU7F3.js");
       promoted = await promoteGreenfieldToMemory2(projectRoot, config, changeId);
     } catch {
     }
@@ -529,7 +516,9 @@ var FEATURE_HEADER = /^##\s+(F-\d+)\s*:\s*(.+?)\s*$/i;
 async function startGreenfield(input) {
   const idea = input.idea.trim();
   if (!idea || idea.length < 3) {
-    throw new Error('Provide a one-line product idea, e.g. sdd greenfield "Team expense tracker for remote startups"');
+    throw new Error(
+      'Provide a one-line product idea, e.g. sdd greenfield "Team expense tracker for remote startups"'
+    );
   }
   const title = idea.length > 80 ? `Greenfield: ${idea.slice(0, 77)}\u2026` : `Greenfield: ${idea}`;
   const ctx = await createChange({
@@ -546,14 +535,11 @@ async function startGreenfield(input) {
       body = body.replaceAll("{{idea}}", idea);
       await writeText(visionPath, body);
     } else if (!body.includes(idea)) {
-      body = body.replace(
-        /## One-liner\n+(\s*[-–—]\s*\n)?/,
-        `## One-liner
+      body = body.replace(/## One-liner\n+(\s*[-–—]\s*\n)?/, `## One-liner
 
 ${idea}
 
-`
-      );
+`);
       if (!body.includes(idea)) {
         body = `${body.trim()}
 
@@ -647,9 +633,7 @@ async function listBacklogFeatures(projectRoot, config) {
   }
   const features = parseFeaturesBacklog(await readText(path), path);
   if (!features.length) {
-    throw new Error(
-      `No F-NNN features parsed in ${path}. Use headings like: ## F-001: Short name`
-    );
+    throw new Error(`No F-NNN features parsed in ${path}. Use headings like: ## F-001: Short name`);
   }
   return { path, features };
 }
@@ -658,10 +642,7 @@ async function startFeatureFromBacklog(input) {
   if (!/^F-\d+$/i.test(id)) {
     throw new Error(`Feature id must look like F-001 (got "${input.featureId}")`);
   }
-  const { path, features } = await listBacklogFeatures(
-    input.projectRoot,
-    input.config
-  );
+  const { path, features } = await listBacklogFeatures(input.projectRoot, input.config);
   const feature = features.find((f) => f.id === id);
   if (!feature) {
     const known = features.map((f) => f.id).join(", ");

package/dist/{chunk-OJFMJHNL.js → chunk-WHDG6OTG.js}

@@ -1,6 +1,9 @@
 import {
   ConfigSchema
 } from "./chunk-67AUAGNV.js";
+import {
+  SddError
+} from "./chunk-MHODNFIL.js";
 import {
   configPath,
   sddRoot
@@ -19,9 +22,10 @@ async function isInitialized(projectRoot) {
 async function loadConfig(projectRoot) {
   const path = configPath(projectRoot);
   if (!await pathExists(path)) {
-    throw new Error(
-      `SDD is not initialized in ${projectRoot}. Run \`sdd init\` first.`
-    );
+    throw new SddError(`SDD is not initialized in ${projectRoot}. Run \`sdd init\` first.`, {
+      code: "NOT_INITIALIZED",
+      hint: "cd into your app and run: sdd init --here --ai copilot"
+    });
   }
   const raw = await readYaml(path);
   return ConfigSchema.parse(raw);

package/dist/{config-ZYEEIRXJ.js → config-X5VDBVR4.js}

@@ -3,8 +3,9 @@ import {
   isInitialized,
   loadConfig,
   saveConfig
-} from "./chunk-OJFMJHNL.js";
+} from "./chunk-WHDG6OTG.js";
 import "./chunk-67AUAGNV.js";
+import "./chunk-MHODNFIL.js";
 import "./chunk-7MJYPJMR.js";
 import "./chunk-EPFURATC.js";
 export {

package/dist/{gather-74DQ35QX.js → gather-2LQ464XU.js}

@@ -3,8 +3,9 @@ import {
   gatherMcpContext,
   gatherMcpContextForChange,
   listMatchingSourceIds
-} from "./chunk-VD3CPFAI.js";
+} from "./chunk-2C3WHUAR.js";
 import "./chunk-KYWETNFU.js";
+import "./chunk-MHODNFIL.js";
 import "./chunk-7MJYPJMR.js";
 import "./chunk-EPFURATC.js";
 export {

package/dist/{greenfield-PKVWSKHN.js → greenfield-YUAMU7F3.js}

@@ -6,8 +6,8 @@ import {
   startFeatureFromBacklog,
   startGreenfield,
   updateFeatureStatus
-} from "./chunk-BIY3WKP3.js";
-import "./chunk-M7YRPPNU.js";
+} from "./chunk-TNZHQ6B5.js";
+import "./chunk-BCLKMBKF.js";
 import "./chunk-A752UVPF.js";
 import "./chunk-67AUAGNV.js";
 import "./chunk-7MJYPJMR.js";

package/dist/index.d.ts

@@ -1431,6 +1431,33 @@ declare function copyDirSkipExisting(src: string, dest: string): Promise<void>;
 declare function writeTextIfMissing(path: string, content: string): Promise<boolean>;
 declare function removePath(path: string): Promise<void>;
 
+/**
+ * Typed, user-facing errors for sdd core.
+ * CLI maps these to exit codes and optional hints.
+ */
+declare class SddError extends Error {
+    readonly code: string;
+    readonly hint?: string;
+    readonly exitCode: number;
+    constructor(message: string, options?: {
+        code?: string;
+        hint?: string;
+        exitCode?: number;
+        cause?: unknown;
+    });
+}
+declare function isSddError(err: unknown): err is SddError;
+/** Normalize unknown throws into Error for logging. */
+declare function errorMessage(err: unknown): string;
+
+/**
+ * Sanitize env maps for child processes (MCP stdio, verify commands).
+ */
+/** Drop undefined; coerce values to strings for spawn env. */
+declare function toProcessEnv(base: NodeJS.ProcessEnv | Record<string, string | undefined>, extra?: Record<string, string | undefined>): Record<string, string>;
+
+declare const SDD_CORE_VERSION: string;
+
 /**
  * Public + internal types for the on-demand structure-aware code context pipeline.
  * Contracts: LLD §2.1 / research §6.5.
@@ -2122,6 +2149,8 @@ declare function explainMatch(source: McpSource, ctx: McpMatchContext): string;
  * sdd as MCP *client* — connect to external stdio MCP servers and call tools.
  */
 
+/** Default timeout for connect + tool call (ms). Override with SDD_MCP_TIMEOUT_MS. */
+declare function mcpTimeoutMs(): number;
 interface CallMcpToolResult {
     ok: boolean;
     text: string;
@@ -2159,4 +2188,4 @@ declare function gatherMcpContextForChange(projectRoot: string, ctx: ChangeConte
 declare function formatMcpContextForHandoff(results: McpFetchResult[]): string;
 declare function listMatchingSourceIds(sources: McpSource[], match: McpMatchContext): string[];
 
-export { AGENT_INTEGRATIONS, AGENT_TARGET_OPTIONS, ALL_AGENT_TARGETS, type AdapterExtractResult, AdapterRegistry, type AdvanceResult, type AgentIntegration, type AgentTarget, type AgentTargetOption, type ArtifactDef, ArtifactDefSchema, type BuildRefinePlanOptions, type CallMcpToolResult, type ChangeContext, type ChangeMeta, ChangeMetaSchema, type CodeContextCaps, type CodeContextGap, type CodeContextGapCode, type CodeContextRequest, type CodeContextResult, type CodeContextSummary, type CodeSlice, type Complexity, type Config, ConfigSchema, type CreateChangeInput, DEFAULT_CODE_CONTEXT_CAPS, DEFAULT_INIT_INTEGRATION, type FocusPlan, type Gate, GateSchema, type GatherMcpOptions, type GenerateCodeContextDeps, type GreenfieldFeature, type InitOptions, type InitResult, type InstallAgentOptions, type InstallAgentResult, type InstallAgentsOptions, type InstallAgentsResult, type InstalledAgentSnapshot, type LanguageAdapter, type McpConfig, McpConfigSchema, type McpFetchResult, type McpInvoke, McpInvokeSchema, type McpMatchContext, type McpSource, McpSourceSchema, type McpWhen, McpWhenSchema, PROTOCOL_MD, type RefineArtifactRef, type RefineMode, type RefinePlan, SDD_AGENT_ROLES, SDD_DIR, type SddAgentRole, type SddAgentRoleId, type Stage, StageSchema, type StartFeatureInput, type StartGreenfieldInput, type StartGreenfieldResult, type SymbolInfo, type SymbolKind, VerifyCommandSchema, type VerifyResult, type Workflow, WorkflowSchema, activePointerPath, activeStages, addMcpSource, advanceStage, agentHostPaths, agentKickoffMessage, approveGate, archiveDir, buildAgentPrompt, buildContext, buildRefinePlan, callMcpSourceTool, canLeaveStage, changeDirName, changeMetaPath, changePath, changesDir, classifyPath, clearActiveIf, completeChange, configPath, copyDir, copyDirSkipExisting, createChange, defaultConfig, defaultMcpConfig, defaultMcpYamlPath, defaultMemoryDir, defaultTemplatesDir, defaultWorkflowsDir, defaultsRoot, domainsDir, ensureDir, ensureMcpConfig, explainMatch, fallbackAdapter, fallbackIncompleteStageId, findFeaturesBacklogPath, firstActiveStageId, formatJsonSummary, formatMcpContextForHandoff, formatStatus, gatherMcpContext, gatherMcpContextForChange, generateCodeContext, getActiveChangeId, getIntegration, getStage, incompletePriorStageErrors, inferComplexity, initProject, installAgentIntegration, installAgentIntegrations, integrationKeyFor, interpolate, interpolateArgs, isIgnoredPath, isInitialized, isSecretPath, isStageSkipped, isSubstantiveArtifactContent, listBacklogFeatures, listChanges, listDirs, listFiles, listMatchingSourceIds, listMcpSourceTools, listWorkflowNames, loadChangeMeta, loadConfig, loadInstalledAgent, loadMcpConfig, loadWorkflow, matchMcpSources, mcpConfigPath, memoryDir, mergeCaps, nextStageId, nowIso, optionForTarget, parseAgentTargets, parseFeaturesBacklog, parseIntegration, pathExists, promoteGreenfieldToMemory, readText, readYaml, recommendWorkflow, refreshActiveAgentContext, removeMcpSource, removeOtherAgentHosts, removePath, renderThinAgent, resolveChangeId, resolveFocus, resolveStages, runLocalVerify, saveChangeMeta, saveConfig, saveMcpConfig, sddRoot, setActiveChange, shouldAutoSkip, skipStage, slugify, startFeatureFromBacklog, startGreenfield, switchWorkflow, templatesDir, todayIsoDate, tokenizeKeywords, typescriptAdapter, uniqueChangeDirName, updateFeatureStatus, withMcpSource, workflowsDir, writeAgentHandoff, writeRefineBrief, writeText, writeTextIfMissing, writeYaml };
+export { AGENT_INTEGRATIONS, AGENT_TARGET_OPTIONS, ALL_AGENT_TARGETS, type AdapterExtractResult, AdapterRegistry, type AdvanceResult, type AgentIntegration, type AgentTarget, type AgentTargetOption, type ArtifactDef, ArtifactDefSchema, type BuildRefinePlanOptions, type CallMcpToolResult, type ChangeContext, type ChangeMeta, ChangeMetaSchema, type CodeContextCaps, type CodeContextGap, type CodeContextGapCode, type CodeContextRequest, type CodeContextResult, type CodeContextSummary, type CodeSlice, type Complexity, type Config, ConfigSchema, type CreateChangeInput, DEFAULT_CODE_CONTEXT_CAPS, DEFAULT_INIT_INTEGRATION, type FocusPlan, type Gate, GateSchema, type GatherMcpOptions, type GenerateCodeContextDeps, type GreenfieldFeature, type InitOptions, type InitResult, type InstallAgentOptions, type InstallAgentResult, type InstallAgentsOptions, type InstallAgentsResult, type InstalledAgentSnapshot, type LanguageAdapter, type McpConfig, McpConfigSchema, type McpFetchResult, type McpInvoke, McpInvokeSchema, type McpMatchContext, type McpSource, McpSourceSchema, type McpWhen, McpWhenSchema, PROTOCOL_MD, type RefineArtifactRef, type RefineMode, type RefinePlan, SDD_AGENT_ROLES, SDD_CORE_VERSION, SDD_DIR, type SddAgentRole, type SddAgentRoleId, SddError, type Stage, StageSchema, type StartFeatureInput, type StartGreenfieldInput, type StartGreenfieldResult, type SymbolInfo, type SymbolKind, VerifyCommandSchema, type VerifyResult, type Workflow, WorkflowSchema, activePointerPath, activeStages, addMcpSource, advanceStage, agentHostPaths, agentKickoffMessage, approveGate, archiveDir, buildAgentPrompt, buildContext, buildRefinePlan, callMcpSourceTool, canLeaveStage, changeDirName, changeMetaPath, changePath, changesDir, classifyPath, clearActiveIf, completeChange, configPath, copyDir, copyDirSkipExisting, createChange, defaultConfig, defaultMcpConfig, defaultMcpYamlPath, defaultMemoryDir, defaultTemplatesDir, defaultWorkflowsDir, defaultsRoot, domainsDir, ensureDir, ensureMcpConfig, errorMessage, explainMatch, fallbackAdapter, fallbackIncompleteStageId, findFeaturesBacklogPath, firstActiveStageId, formatJsonSummary, formatMcpContextForHandoff, formatStatus, gatherMcpContext, gatherMcpContextForChange, generateCodeContext, getActiveChangeId, getIntegration, getStage, incompletePriorStageErrors, inferComplexity, initProject, installAgentIntegration, installAgentIntegrations, integrationKeyFor, interpolate, interpolateArgs, isIgnoredPath, isInitialized, isSddError, isSecretPath, isStageSkipped, isSubstantiveArtifactContent, listBacklogFeatures, listChanges, listDirs, listFiles, listMatchingSourceIds, listMcpSourceTools, listWorkflowNames, loadChangeMeta, loadConfig, loadInstalledAgent, loadMcpConfig, loadWorkflow, matchMcpSources, mcpConfigPath, mcpTimeoutMs, memoryDir, mergeCaps, nextStageId, nowIso, optionForTarget, parseAgentTargets, parseFeaturesBacklog, parseIntegration, pathExists, promoteGreenfieldToMemory, readText, readYaml, recommendWorkflow, refreshActiveAgentContext, removeMcpSource, removeOtherAgentHosts, removePath, renderThinAgent, resolveChangeId, resolveFocus, resolveStages, runLocalVerify, saveChangeMeta, saveConfig, saveMcpConfig, sddRoot, setActiveChange, shouldAutoSkip, skipStage, slugify, startFeatureFromBacklog, startGreenfield, switchWorkflow, templatesDir, toProcessEnv, todayIsoDate, tokenizeKeywords, typescriptAdapter, uniqueChangeDirName, updateFeatureStatus, withMcpSource, workflowsDir, writeAgentHandoff, writeRefineBrief, writeText, writeTextIfMissing, writeYaml };

package/dist/index.js

@@ -16,8 +16,9 @@ import {
   startGreenfield,
   switchWorkflow,
   updateFeatureStatus
-} from "./chunk-BIY3WKP3.js";
+} from "./chunk-TNZHQ6B5.js";
 import {
+  SDD_CORE_VERSION,
   callMcpSourceTool,
   explainMatch,
   formatMcpContextForHandoff,
@@ -26,8 +27,10 @@ import {
   listMatchingSourceIds,
   listMcpSourceTools,
   matchMcpSources,
+  mcpTimeoutMs,
+  toProcessEnv,
   withMcpSource
-} from "./chunk-VD3CPFAI.js";
+} from "./chunk-2C3WHUAR.js";
 import {
   McpConfigSchema,
   McpInvokeSchema,
@@ -64,17 +67,17 @@ import {
   removeOtherAgentHosts,
   renderThinAgent,
   writeAgentHandoff
-} from "./chunk-AOIPJ4FM.js";
+} from "./chunk-BTUI2WYQ.js";
 import {
   buildAgentPrompt,
   formatStatus
-} from "./chunk-M7YRPPNU.js";
+} from "./chunk-BCLKMBKF.js";
 import {
   defaultConfig,
   isInitialized,
   loadConfig,
   saveConfig
-} from "./chunk-OJFMJHNL.js";
+} from "./chunk-WHDG6OTG.js";
 import {
   activeStages,
   buildContext,
@@ -110,6 +113,11 @@ import {
   VerifyCommandSchema,
   WorkflowSchema
 } from "./chunk-67AUAGNV.js";
+import {
+  SddError,
+  errorMessage,
+  isSddError
+} from "./chunk-MHODNFIL.js";
 import {
   SDD_DIR,
   activePointerPath,
@@ -448,14 +456,11 @@ async function runLocalVerify(projectRoot, config, changeId, opts) {
       });
       if (evidenceDir) {
         const logPath = join3(evidenceDir, `${cmd.name.replace(/\s+/g, "-")}.log`);
-        await writeText(
-          logPath,
-          `# ${cmd.name}
+        await writeText(logPath, `# ${cmd.name}
 $ ${cmd.run}
 exit: ${exitCode}
 
-${output}`
-        );
+${output}`);
       }
     }
   }
@@ -506,10 +511,7 @@ ${output}`
     }
     if (evidenceDir) {
       const stamp = nowIso();
-      await writeText(
-        join3(evidenceDir, `run-${stamp.replace(/[:.]/g, "-")}.md`),
-        summaryBody
-      );
+      await writeText(join3(evidenceDir, `run-${stamp.replace(/[:.]/g, "-")}.md`), summaryBody);
     }
   } else {
     await writeText(summaryPath, summaryBody);
@@ -539,8 +541,8 @@ import { extname as extname4, join as join6, normalize as normalize5 } from "pat
 import { extname as extname2 } from "pathe";
 
 // src/code-context/adapters/typescript.ts
-import ts from "typescript";
 import { extname } from "pathe";
+import ts from "typescript";
 var TS_JS_EXTENSIONS = [
   ".ts",
   ".tsx",
@@ -733,127 +735,6 @@ var AdapterRegistry = class {
   }
 };
 
-// src/code-context/formatter.ts
-function fenceLang(filePath) {
-  const lower = filePath.toLowerCase();
-  if (lower.endsWith(".tsx") || lower.endsWith(".jsx")) return "tsx";
-  if (lower.endsWith(".ts") || lower.endsWith(".mts") || lower.endsWith(".cts")) {
-    return "ts";
-  }
-  if (lower.endsWith(".js") || lower.endsWith(".mjs") || lower.endsWith(".cjs")) {
-    return "js";
-  }
-  return "";
-}
-function formatMarkdown(input) {
-  const lines = [];
-  lines.push("# Code context");
-  lines.push("");
-  lines.push(
-    "> Generated on-demand for agents. Not a substitute for process context"
-  );
-  lines.push(
-    "> (.sdd/protocol.md, active-context, change packs)."
-  );
-  lines.push(
-    "> Regenerable \u2014 run `sdd context --out change` (or pass `--path` / `--symbol`)."
-  );
-  lines.push("");
-  lines.push("## Summary");
-  lines.push(
-    `- Change: ${input.changeTitle ?? input.plan.changeId ?? "(none)"}`
-  );
-  lines.push(
-    `- Focus paths: ${input.summary.focusPaths.length ? input.summary.focusPaths.join(", ") : "(none)"}`
-  );
-  lines.push(
-    `- Focus symbols: ${input.summary.focusSymbols.length ? input.summary.focusSymbols.join(", ") : "(none)"}`
-  );
-  lines.push(
-    `- Keywords: ${input.summary.keywords.length ? input.summary.keywords.join(", ") : "(none)"}`
-  );
-  lines.push(
-    `- Files analyzed: ${input.summary.filesAnalyzed} \xB7 Symbols: ${input.summary.symbolsExtracted} \xB7 Slices: ${input.summary.slicesEmitted}`
-  );
-  lines.push(`- Truncated: ${input.summary.truncated ? "yes" : "no"}`);
-  if (input.plan.notes.length) {
-    lines.push(`- Notes: ${input.plan.notes.join("; ")}`);
-  }
-  lines.push("");
-  lines.push("## Gaps");
-  if (!input.gaps.length) {
-    lines.push("_None._");
-  } else {
-    for (const g of input.gaps) {
-      const pathPart = g.path ? ` \u2014 \`${g.path}\`` : "";
-      lines.push(`- (\`${g.code}\`) ${g.message}${pathPart}`);
-    }
-  }
-  lines.push("");
-  lines.push("## Slices");
-  lines.push("");
-  let truncated = input.summary.truncated;
-  const maxLines = input.maxOutputLines ?? 8e3;
-  const maxTokens = input.maxTokensApprox ?? 12e3;
-  let approxTokens = 0;
-  for (const slice of input.slices) {
-    if (lines.length >= maxLines) {
-      truncated = true;
-      break;
-    }
-    const header = `### \`${slice.filePath}\`${slice.symbolName ? ` \xB7 \`${slice.symbolName}\`` : ""} (lines ${slice.startLine}\u2013${slice.endLine}) \xB7 ${slice.reason}`;
-    lines.push(header);
-    lines.push("```" + fenceLang(slice.filePath));
-    lines.push(slice.body);
-    lines.push("```");
-    lines.push("");
-    approxTokens += Math.ceil((header.length + slice.body.length) / 4);
-    if (approxTokens > maxTokens) {
-      truncated = true;
-      break;
-    }
-  }
-  if (!input.slices.length) {
-    lines.push("_No slices emitted._");
-    lines.push("");
-  }
-  lines.push("## Structural notes");
-  const topFiles = [
-    ...new Set(input.slices.map((s) => s.filePath))
-  ].slice(0, 15);
-  if (topFiles.length) {
-    lines.push(`- Ranked files (sample): ${topFiles.join(", ")}`);
-  } else {
-    lines.push("- No structural neighborhood (empty analysis set).");
-  }
-  lines.push("");
-  let markdown = lines.join("\n");
-  if (Math.ceil(markdown.length / 4) > maxTokens) {
-    truncated = true;
-    markdown = markdown.slice(0, maxTokens * 4) + "\n\n\u2026(truncated)\n";
-  }
-  return { markdown, truncated };
-}
-function formatJsonSummary(summary, gaps, slices, ok) {
-  return JSON.stringify(
-    {
-      ok,
-      summary,
-      gaps,
-      slices: slices.map((s) => ({
-        id: s.id,
-        filePath: s.filePath,
-        startLine: s.startLine,
-        endLine: s.endLine,
-        symbolName: s.symbolName,
-        reason: s.reason
-      }))
-    },
-    null,
-    2
-  );
-}
-
 // src/code-context/focus.ts
 import { promises as fs } from "fs";
 import { isAbsolute, join as join4, normalize as normalize3, relative } from "pathe";
@@ -1252,12 +1133,7 @@ async function resolveFocus(request, options) {
       }
     }
     if (!request.paths?.length && (keywords.length || seedSymbols.length)) {
-      const found = await searchByKeywords(
-        projectRoot,
-        keywords,
-        seedSymbols,
-        maxWalk
-      );
+      const found = await searchByKeywords(projectRoot, keywords, seedSymbols, maxWalk);
       for (const f of found) {
         if (!candidatePaths.includes(f)) candidatePaths.push(f);
         if (!seedPaths.includes(f) && seedPaths.length < 20) seedPaths.push(f);
@@ -1267,12 +1143,7 @@ async function resolveFocus(request, options) {
   }
   if (!request.paths?.length && !change && (request.query || seedSymbols.length)) {
     notes.push("Focus from query/symbols only");
-    const found = await searchByKeywords(
-      projectRoot,
-      keywords,
-      seedSymbols,
-      maxWalk
-    );
+    const found = await searchByKeywords(projectRoot, keywords, seedSymbols, maxWalk);
     for (const f of found) {
       if (!candidatePaths.includes(f)) candidatePaths.push(f);
       if (!seedPaths.includes(f)) seedPaths.push(f);
@@ -1311,6 +1182,117 @@ async function resolveFocus(request, options) {
   };
 }
 
+// src/code-context/formatter.ts
+function fenceLang(filePath) {
+  const lower = filePath.toLowerCase();
+  if (lower.endsWith(".tsx") || lower.endsWith(".jsx")) return "tsx";
+  if (lower.endsWith(".ts") || lower.endsWith(".mts") || lower.endsWith(".cts")) {
+    return "ts";
+  }
+  if (lower.endsWith(".js") || lower.endsWith(".mjs") || lower.endsWith(".cjs")) {
+    return "js";
+  }
+  return "";
+}
+function formatMarkdown(input) {
+  const lines = [];
+  lines.push("# Code context");
+  lines.push("");
+  lines.push("> Generated on-demand for agents. Not a substitute for process context");
+  lines.push("> (.sdd/protocol.md, active-context, change packs).");
+  lines.push("> Regenerable \u2014 run `sdd context --out change` (or pass `--path` / `--symbol`).");
+  lines.push("");
+  lines.push("## Summary");
+  lines.push(`- Change: ${input.changeTitle ?? input.plan.changeId ?? "(none)"}`);
+  lines.push(
+    `- Focus paths: ${input.summary.focusPaths.length ? input.summary.focusPaths.join(", ") : "(none)"}`
+  );
+  lines.push(
+    `- Focus symbols: ${input.summary.focusSymbols.length ? input.summary.focusSymbols.join(", ") : "(none)"}`
+  );
+  lines.push(
+    `- Keywords: ${input.summary.keywords.length ? input.summary.keywords.join(", ") : "(none)"}`
+  );
+  lines.push(
+    `- Files analyzed: ${input.summary.filesAnalyzed} \xB7 Symbols: ${input.summary.symbolsExtracted} \xB7 Slices: ${input.summary.slicesEmitted}`
+  );
+  lines.push(`- Truncated: ${input.summary.truncated ? "yes" : "no"}`);
+  if (input.plan.notes.length) {
+    lines.push(`- Notes: ${input.plan.notes.join("; ")}`);
+  }
+  lines.push("");
+  lines.push("## Gaps");
+  if (!input.gaps.length) {
+    lines.push("_None._");
+  } else {
+    for (const g of input.gaps) {
+      const pathPart = g.path ? ` \u2014 \`${g.path}\`` : "";
+      lines.push(`- (\`${g.code}\`) ${g.message}${pathPart}`);
+    }
+  }
+  lines.push("");
+  lines.push("## Slices");
+  lines.push("");
+  let truncated = input.summary.truncated;
+  const maxLines = input.maxOutputLines ?? 8e3;
+  const maxTokens = input.maxTokensApprox ?? 12e3;
+  let approxTokens = 0;
+  for (const slice of input.slices) {
+    if (lines.length >= maxLines) {
+      truncated = true;
+      break;
+    }
+    const header = `### \`${slice.filePath}\`${slice.symbolName ? ` \xB7 \`${slice.symbolName}\`` : ""} (lines ${slice.startLine}\u2013${slice.endLine}) \xB7 ${slice.reason}`;
+    lines.push(header);
+    lines.push("```" + fenceLang(slice.filePath));
+    lines.push(slice.body);
+    lines.push("```");
+    lines.push("");
+    approxTokens += Math.ceil((header.length + slice.body.length) / 4);
+    if (approxTokens > maxTokens) {
+      truncated = true;
+      break;
+    }
+  }
+  if (!input.slices.length) {
+    lines.push("_No slices emitted._");
+    lines.push("");
+  }
+  lines.push("## Structural notes");
+  const topFiles = [...new Set(input.slices.map((s) => s.filePath))].slice(0, 15);
+  if (topFiles.length) {
+    lines.push(`- Ranked files (sample): ${topFiles.join(", ")}`);
+  } else {
+    lines.push("- No structural neighborhood (empty analysis set).");
+  }
+  lines.push("");
+  let markdown = lines.join("\n");
+  if (Math.ceil(markdown.length / 4) > maxTokens) {
+    truncated = true;
+    markdown = markdown.slice(0, maxTokens * 4) + "\n\n\u2026(truncated)\n";
+  }
+  return { markdown, truncated };
+}
+function formatJsonSummary(summary, gaps, slices, ok) {
+  return JSON.stringify(
+    {
+      ok,
+      summary,
+      gaps,
+      slices: slices.map((s) => ({
+        id: s.id,
+        filePath: s.filePath,
+        startLine: s.startLine,
+        endLine: s.endLine,
+        symbolName: s.symbolName,
+        reason: s.reason
+      }))
+    },
+    null,
+    2
+  );
+}
+
 // src/code-context/graph.ts
 import { dirname as dirname2, join as join5, normalize as normalize4 } from "pathe";
 var GraphLite = class {
@@ -1419,9 +1401,7 @@ function scoreSymbol(symbol, plan, graph, caps) {
       score += 100;
       reasons.push("exact-symbol");
     } else {
-      const ci = seedSymbols.find(
-        (s) => s.toLowerCase() === symbol.name.toLowerCase()
-      );
+      const ci = seedSymbols.find((s) => s.toLowerCase() === symbol.name.toLowerCase());
       if (ci) {
         score += 90;
         reasons.push("symbol-ci");
@@ -1540,12 +1520,11 @@ function emitSlices(ranked, graph, caps, options) {
     if (isSecretPath(sym.filePath)) continue;
     const source = graph.getSource(sym.filePath);
     if (!source) continue;
-    const { body, end, truncated: lineTrunc } = sliceBody(
-      source,
-      sym.startLine,
-      sym.endLine,
-      caps.maxLinesPerSlice
-    );
+    const {
+      body,
+      end,
+      truncated: lineTrunc
+    } = sliceBody(source, sym.startLine, sym.endLine, caps.maxLinesPerSlice);
     if (lineTrunc) truncated = true;
     const id = `${sym.filePath}:${sym.startLine}-${end}:${sym.name}`;
     if (seen.has(id)) continue;
@@ -1569,12 +1548,7 @@ function emitSlices(ranked, graph, caps, options) {
         if (!nSource || !nNode) continue;
         const nSym = nNode.extract.symbols.find((s) => s.exported) ?? nNode.extract.symbols[0];
         if (!nSym) continue;
-        const nb = sliceBody(
-          nSource,
-          nSym.startLine,
-          nSym.endLine,
-          caps.maxLinesPerSlice
-        );
+        const nb = sliceBody(nSource, nSym.startLine, nSym.endLine, caps.maxLinesPerSlice);
         const nid = `${nSym.filePath}:${nSym.startLine}-${nb.end}:${nSym.name}:neighbor`;
         if (seen.has(nid)) continue;
         seen.add(nid);
@@ -1665,9 +1639,7 @@ function hardFailure(gaps, message, summary) {
     `- Error: ${message}`,
     "",
     "## Gaps",
-    ...gaps.map(
-      (g) => `- (\`${g.code}\`) ${g.message}${g.path ? ` \u2014 \`${g.path}\`` : ""}`
-    ),
+    ...gaps.map((g) => `- (\`${g.code}\`) ${g.message}${g.path ? ` \u2014 \`${g.path}\`` : ""}`),
     "",
     "## Slices",
     "",
@@ -1866,7 +1838,7 @@ async function generateCodeContext(request, deps) {
         plan.changeId,
         "meta.yaml"
       );
-      const { loadConfig: loadConfig2 } = await import("./config-ZYEEIRXJ.js");
+      const { loadConfig: loadConfig2 } = await import("./config-X5VDBVR4.js");
       const { changePath: changePath2 } = await import("./paths-64GA32IZ.js");
       const config = await loadConfig2(projectRoot);
       const mp = join6(changePath2(projectRoot, config, plan.changeId), "meta.yaml");
@@ -1941,11 +1913,7 @@ function listMarkdown(refs) {
   ).join("\n");
 }
 async function buildRefinePlan(opts) {
-  const ctx = await buildContext(
-    opts.projectRoot,
-    opts.config,
-    opts.changeId
-  );
+  const ctx = await buildContext(opts.projectRoot, opts.config, opts.changeId);
   const mode = opts.mode ?? "refine";
   const focusOnly = Boolean(opts.focusOnly);
   const focusStageId = opts.stageId?.trim() || ctx.meta.stage;
@@ -2139,7 +2107,9 @@ export {
   McpWhenSchema,
   PROTOCOL_MD,
   SDD_AGENT_ROLES,
+  SDD_CORE_VERSION,
   SDD_DIR,
+  SddError,
   StageSchema,
   VerifyCommandSchema,
   WorkflowSchema,
@@ -2177,6 +2147,7 @@ export {
   domainsDir,
   ensureDir,
   ensureMcpConfig,
+  errorMessage,
   explainMatch,
   fallbackAdapter,
   fallbackIncompleteStageId,
@@ -2201,6 +2172,7 @@ export {
   interpolateArgs,
   isIgnoredPath,
   isInitialized,
+  isSddError,
   isSecretPath,
   isStageSkipped,
   isSubstantiveArtifactContent,
@@ -2218,6 +2190,7 @@ export {
   loadWorkflow,
   matchMcpSources,
   mcpConfigPath,
+  mcpTimeoutMs,
   memoryDir,
   mergeCaps,
   nextStageId,
@@ -2252,6 +2225,7 @@ export {
   startGreenfield,
   switchWorkflow,
   templatesDir,
+  toProcessEnv,
   todayIsoDate,
   tokenizeKeywords,
   typescriptAdapter,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@structured-vibe-coding/core",
-  "version": "0.16.1",
+  "version": "0.16.2",
   "description": "Core engine for sdd — local Spec-Driven Development workflows, change packs, greenfield, and agent handoff",
   "type": "module",
   "main": "./dist/index.js",
@@ -57,11 +57,11 @@
     "local-sdd"
   ],
   "scripts": {
-    "build": "tsup src/index.ts --format esm --dts --clean",
-    "dev": "tsup src/index.ts --format esm --dts --watch",
+    "build": "tsup",
+    "dev": "tsup --watch",
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit",
-    "lint": "tsc --noEmit"
+    "lint": "cd ../.. && biome check packages/core/src"
   }
 }