@structured-vibe-coding/core 0.21.0 → 0.23.0

package/dist/{chunk-AERAWOAK.js → chunk-RXQH2THQ.js}

@@ -6,8 +6,13 @@ import {
   shouldAutoSkip
 } from "./chunk-TNWFMRIA.js";
 import {
-  SddError
-} from "./chunk-MHODNFIL.js";
+  SddError,
+  callMcpSourceTool,
+  mcpTimeoutMs
+} from "./chunk-OY47H6R5.js";
+import {
+  loadMcpConfig
+} from "./chunk-4BRO7BOJ.js";
 import {
   activePointerPath,
   changesPathRel,
@@ -196,7 +201,9 @@ var SearchConfigSchema = z.object({
   k: z.number().int().min(1).max(100).default(20),
   embeddings: z.boolean().default(false),
   budgets: BudgetSchema.default({ default: 12e3 }),
-  exclude: z.array(z.string().min(1)).default([])
+  exclude: z.array(z.string().min(1)).default([]),
+  mcp_source: z.string().min(1).optional(),
+  mcp_tool: z.string().min(1).optional()
 });
 function budgetForStage(config, stage) {
   if (!stage) return config.budgets.default;
@@ -221,22 +228,13 @@ async function loadSearchConfig(projectRoot) {
 
 // src/search/pack.ts
 var EN_DASH = "\u2013";
-function searchPreamble(query, scope, budget, hybrid = false) {
-  if (hybrid) {
-    return `# Search
-Query: ${query}
-Scope: ${scope}
-Provider: builtin
-Mode: hybrid
-Budget: ${budget}
-
-`;
-  }
+function searchPreamble(query, scope, budget, hybrid = false, provider = "builtin") {
+  const mode = hybrid ? "Mode: hybrid\n" : "";
   return `# Search
 Query: ${query}
 Scope: ${scope}
-Provider: builtin
-Budget: ${budget}
+Provider: ${provider}
+${mode}Budget: ${budget}
 
 `;
 }
@@ -2331,6 +2329,173 @@ async function searchProject(projectRoot, query, options, runtime) {
   };
 }
 
+// src/search/mcp-provider.ts
+var McpSearchError = class extends Error {
+  constructor() {
+    super("Search provider is unavailable.");
+    this.name = "McpSearchError";
+  }
+};
+function emptyStats(considered = 0, reindexed = 0) {
+  return {
+    provider: "mcp",
+    files: 0,
+    chunks: 0,
+    lastIndexFilesConsidered: considered,
+    lastIndexFilesReindexed: reindexed,
+    lastIndexChunksReindexed: 0,
+    lastIndexChunksEmbedded: 0,
+    indexedCommit: null
+  };
+}
+function isSafeRelativePath(path) {
+  if (!path || path.startsWith("/") || path.startsWith("\\")) return false;
+  if (path.length >= 2 && path.charCodeAt(1) === 58) {
+    const c = path.charCodeAt(0);
+    if (c >= 65 && c <= 90 || c >= 97 && c <= 122) return false;
+  }
+  const parts = path.replaceAll("\\", "/").split("/");
+  for (const part of parts) {
+    if (part.length === 0 || part === "." || part === "..") return false;
+  }
+  return true;
+}
+function withTimeout(promise, ms) {
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(() => reject(new McpSearchError()), ms);
+    promise.then(
+      (value) => {
+        clearTimeout(timer);
+        resolve(value);
+      },
+      () => {
+        clearTimeout(timer);
+        reject(new McpSearchError());
+      }
+    );
+  });
+}
+function allowedPaths(paths, exclude) {
+  const kept = [];
+  for (const raw of paths) {
+    const path = raw.replaceAll("\\", "/");
+    if (!isSafeRelativePath(path) || exclude(path)) continue;
+    kept.push(path);
+  }
+  return kept;
+}
+function positive(value) {
+  if (typeof value !== "number" || !Number.isInteger(value) || value < 1) return void 0;
+  return value;
+}
+function firstLine(body) {
+  const nl = body.indexOf("\n");
+  return nl === -1 ? body : body.slice(0, nl);
+}
+function asHit(value, scope, exclude) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+  const rec = value;
+  if (typeof rec.path !== "string") return void 0;
+  const path = rec.path.replaceAll("\\", "/");
+  if (!isSafeRelativePath(path) || exclude(path)) return void 0;
+  const startLine2 = positive(rec.startLine);
+  const endLine2 = positive(rec.endLine);
+  if (startLine2 === void 0 || endLine2 === void 0 || endLine2 < startLine2) return void 0;
+  if (typeof rec.symbol !== "string") return void 0;
+  const symbol = rec.symbol.trim();
+  if (!symbol || typeof rec.body !== "string") return void 0;
+  const signature = typeof rec.signature === "string" ? rec.signature : firstLine(rec.body);
+  const language = typeof rec.language === "string" ? rec.language : "";
+  const score = typeof rec.score === "number" && Number.isFinite(rec.score) ? rec.score : 0;
+  return { scope, path, startLine: startLine2, endLine: endLine2, symbol, score, signature, body: rec.body, language };
+}
+function parseHits(text, scope, exclude) {
+  let parsed;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+    throw new McpSearchError();
+  }
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) throw new McpSearchError();
+  const hits = parsed.hits;
+  if (!Array.isArray(hits)) throw new McpSearchError();
+  const out = [];
+  for (const hit of hits) {
+    const row = asHit(hit, scope, exclude);
+    if (row) out.push(row);
+  }
+  return out;
+}
+async function connect(input) {
+  const exclude = await loadExcluder(input.projectRoot, input.search.exclude);
+  let sources = [];
+  try {
+    const cfg = await loadMcpConfig(input.projectRoot);
+    sources = cfg.sources.filter((source2) => source2.enabled);
+  } catch {
+    throw new McpSearchError();
+  }
+  const named = input.search.mcp_source;
+  const source = named ? sources.find((item) => item.id === named) : sources.length === 1 ? sources[0] : void 0;
+  if (!source) throw new McpSearchError();
+  const tool = input.search.mcp_tool || source.invoke?.tool;
+  if (!tool) throw new McpSearchError();
+  if (source.tools?.length && !source.tools.includes(tool)) throw new McpSearchError();
+  const call = input.call ?? (async (req) => {
+    const result = await callMcpSourceTool(source, input.projectRoot, req.tool, req.args);
+    return { ok: result.ok, text: result.text };
+  });
+  return { sourceId: source.id, tool, exclude, call };
+}
+function openMcpSearchProvider(input) {
+  const timeoutMs = input.timeoutMs ?? mcpTimeoutMs();
+  let ready3;
+  async function load() {
+    if (ready3) return ready3;
+    ready3 = await connect(input);
+    return ready3;
+  }
+  return {
+    id: "mcp",
+    async index(changed) {
+      const session = await load();
+      if (!changed) return emptyStats();
+      const paths = allowedPaths(changed, session.exclude);
+      if (paths.length === 0) return emptyStats(changed.length);
+      const result = await withTimeout(
+        session.call({ sourceId: session.sourceId, tool: session.tool, args: { paths } }),
+        timeoutMs
+      );
+      if (!result.ok) throw new McpSearchError();
+      return emptyStats(changed.length, paths.length);
+    },
+    async search(query, options) {
+      const session = await load();
+      const args = { query, scope: options.scope };
+      const result = await withTimeout(
+        session.call({ sourceId: session.sourceId, tool: session.tool, args }),
+        timeoutMs
+      );
+      if (!result.ok) throw new McpSearchError();
+      const hits = parseHits(result.text, options.scope, session.exclude);
+      const preamble = searchPreamble(query, options.scope, options.budget, false, "mcp");
+      const packed = packHits({ preamble, hits, budget: options.budget });
+      return {
+        provider: "mcp",
+        query,
+        scope: options.scope,
+        budget: options.budget,
+        usedTokens: packed.usedTokens,
+        hits: packed.hits,
+        text: packed.text
+      };
+    },
+    stats() {
+      return Promise.resolve(emptyStats());
+    }
+  };
+}
+
 // src/search/registry.ts
 var extra = /* @__PURE__ */ new Map();
 function registerSearchProvider(provider) {
@@ -2347,13 +2512,18 @@ function joinWarning(left, right) {
 ${right}`;
   return left || right;
 }
-function resolveSearchProvider(projectRoot, config, search, runtime) {
+function resolveSearchProvider(projectRoot, config, search, runtime, run) {
   const builtin = createBuiltinProvider(projectRoot, config, runtime);
   const name = search.provider || "builtin";
   if (name === "builtin") return builtin;
   const registered = extra.get(name);
-  let active = registered ?? builtin;
-  let warning = registered ? void 0 : fallbackWarning(name);
+  let active = name === "mcp" ? openMcpSearchProvider({
+    projectRoot,
+    search,
+    call: run?.mcpCall,
+    timeoutMs: run?.mcpTimeoutMs
+  }) : registered ?? builtin;
+  let warning = name === "mcp" || registered ? void 0 : fallbackWarning(name);
   const mark = () => {
     warning = fallbackWarning(name);
     active = builtin;
@@ -2373,7 +2543,6 @@ function resolveSearchProvider(projectRoot, config, search, runtime) {
       try {
         const result = await active.search(query, options);
         result.warning = joinWarning(warning, result.warning);
-        result.provider = "builtin";
         return result;
       } catch (err) {
         if (active.id === "builtin") throw err;
@@ -2404,12 +2573,11 @@ async function buildRetrievedInner(projectRoot, config, title, stage, budget, ru
     return `Retrieved context skipped: ${safeMessage(err, projectRoot)}.`;
   }
   const limit = budget ?? budgetForStage(search, stage);
-  const provider = resolveSearchProvider(projectRoot, config, search, runtime);
+  const provider = createBuiltinProvider(projectRoot, config, runtime);
   try {
     await provider.index();
   } catch (err) {
-    const message = provider.id === "builtin" ? safeMessage(err, projectRoot) : fallbackWarning(search.provider);
-    return `Retrieved context skipped: ${message}.`;
+    return `Retrieved context skipped: ${safeMessage(err, projectRoot)}.`;
   }
   const request = {
     projectRoot,
@@ -2456,13 +2624,12 @@ async function buildRetrievedInner(projectRoot, config, title, stage, budget, ru
     }
     return packed.text;
   } catch (err) {
-    const message = search.provider === "builtin" ? safeMessage(err, projectRoot) : fallbackWarning(search.provider);
-    return `Retrieved context skipped: ${message}.`;
+    return `Retrieved context skipped: ${safeMessage(err, projectRoot)}.`;
   }
 }
-async function executeSearch(projectRoot, config, query, scope, budget) {
+async function executeSearch(projectRoot, config, query, scope, budget, run) {
   const search = await loadSearchConfig(projectRoot);
-  const provider = resolveSearchProvider(projectRoot, config, search);
+  const provider = resolveSearchProvider(projectRoot, config, search, void 0, run);
   await provider.index();
   const options = {
     scope,
@@ -2668,7 +2835,7 @@ function stringList(value) {
   }
   return out;
 }
-function parseRoleDocument(name, raw) {
+function splitFrontmatter(raw) {
   const text = raw.replace(/^\uFEFF/, "");
   const nl = text.indexOf("\n");
   if (nl < 0 || text.slice(0, nl).trim() !== "---") return null;
@@ -2682,14 +2849,22 @@ function parseRoleDocument(name, raw) {
     return null;
   }
   if (!data || typeof data !== "object" || Array.isArray(data)) return null;
-  const rec = data;
+  return {
+    data,
+    body: rest.slice(close.index + close[0].length).trim()
+  };
+}
+function parseRoleDocument(name, raw) {
+  const split = splitFrontmatter(raw);
+  if (!split) return null;
+  const rec = split.data;
   const lists = emptyRoleLists();
   for (const [field2, key] of LIST_FIELDS) {
     const parsed = stringList(rec[key]);
     if (!parsed) return null;
     lists[field2] = parsed;
   }
-  const body = rest.slice(close.index + close[0].length).trim();
+  const body = split.body;
   return {
     name,
     label: asText(rec.label),
@@ -2701,7 +2876,7 @@ function parseRoleDocument(name, raw) {
     ...lists
   };
 }
-function renderRole(role) {
+function renderRole(role, routines) {
   const record = {
     name: role.name,
     label: role.label,
@@ -2710,6 +2885,7 @@ function renderRole(role) {
     pinned: role.pinned,
     hidden: role.hidden
   };
+  if (routines?.keep) record.routines = routines.value;
   for (const [field2, key] of LIST_FIELDS) {
     if (role[field2].length > 0) record[key] = role[field2];
   }
@@ -2748,8 +2924,15 @@ async function readRole(root, name) {
     return null;
   }
 }
-async function writeRole(root, role) {
-  await writeText(roleFilePath(root, role.name), renderRole(role));
+async function keptRoutines(root, name) {
+  const path = roleFilePath(root, name);
+  if (!await pathExists(path)) return void 0;
+  const split = splitFrontmatter(await readText(path));
+  if (!split || !Object.hasOwn(split.data, "routines")) return void 0;
+  return { keep: true, value: split.data.routines };
+}
+async function writeRole(root, role, routines) {
+  await writeText(roleFilePath(root, role.name), renderRole(role, routines));
 }
 async function createRole(root, input) {
   const name = canonicalRoleName(input.name);
@@ -2784,7 +2967,7 @@ async function editRole(root, nameInput, patch) {
   if (patch.description !== void 0) role.description = patch.description.trim();
   if (patch.askFirst !== void 0) role.askFirst = patch.askFirst;
   if (patch.stages !== void 0) role.stages = patch.stages;
-  await writeRole(root, role);
+  await writeRole(root, role, await keptRoutines(root, name));
   return ok();
 }
 async function setFlag(root, nameInput, flag) {
@@ -2793,7 +2976,7 @@ async function setFlag(root, nameInput, flag) {
   const role = await readRole(root, name);
   if (!role) return fail(ROLE_TEXT.notFound);
   role[flag] = true;
-  await writeRole(root, role);
+  await writeRole(root, role, await keptRoutines(root, name));
   return ok();
 }
 function pinRole(root, name) {
@@ -2836,7 +3019,7 @@ async function duplicateRole(root, nameInput) {
   const copyName = canonicalRoleName(`${name} copy`);
   if (!copyName) return fail(ROLE_TEXT.badName);
   if (await pathExists(roleFilePath(root, copyName))) return fail(ROLE_TEXT.exists);
-  await writeRole(root, { ...source, name: copyName });
+  await writeRole(root, { ...source, name: copyName }, await keptRoutines(root, name));
   return ok();
 }
 async function deleteRole(root, nameInput) {
@@ -3321,9 +3504,9 @@ async function buildAgentPrompt(ctx, config, projectRoot, budget, runtime) {
     parts.push("");
   }
   try {
-    const { loadMcpConfig } = await import("./sources-3TXUPU6V.js");
-    const { gatherMcpContextForChange, formatMcpContextForHandoff } = await import("./gather-A3Q4WSPH.js");
-    const mcpCfg = await loadMcpConfig(projectRoot);
+    const { loadMcpConfig: loadMcpConfig2 } = await import("./sources-3TXUPU6V.js");
+    const { gatherMcpContextForChange, formatMcpContextForHandoff } = await import("./gather-DDUZEIQZ.js");
+    const mcpCfg = await loadMcpConfig2(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));
@@ -3414,6 +3597,7 @@ export {
   listScopeHits,
   rankScope,
   searchProject,
+  openMcpSearchProvider,
   registerSearchProvider,
   clearRegisteredSearchProviders,
   fallbackWarning,
@@ -3429,6 +3613,7 @@ export {
   conversationDir,
   memoryDir,
   allowFilePath,
+  splitFrontmatter,
   parseRoleDocument,
   rolesListingStage,
   readRole,

package/dist/{gather-A3Q4WSPH.js → gather-DDUZEIQZ.js}

@@ -3,9 +3,9 @@ import {
   gatherMcpContext,
   gatherMcpContextForChange,
   listMatchingSourceIds
-} from "./chunk-ICRQOQWE.js";
+} from "./chunk-PFJFWZOM.js";
+import "./chunk-OY47H6R5.js";
 import "./chunk-4BRO7BOJ.js";
-import "./chunk-MHODNFIL.js";
 import "./chunk-O5SP6X5R.js";
 export {
   formatMcpContextForHandoff,

package/dist/{greenfield-QTMU2MH6.js → greenfield-6I2ML2ZB.js}

@@ -6,10 +6,11 @@ import {
   startFeatureFromBacklog,
   startGreenfield,
   updateFeatureStatus
-} from "./chunk-Z2ULYVHO.js";
-import "./chunk-AERAWOAK.js";
+} from "./chunk-KMITXC7I.js";
+import "./chunk-RXQH2THQ.js";
 import "./chunk-TNWFMRIA.js";
-import "./chunk-MHODNFIL.js";
+import "./chunk-OY47H6R5.js";
+import "./chunk-4BRO7BOJ.js";
 import "./chunk-O5SP6X5R.js";
 export {
   findFeaturesBacklogPath,

package/dist/index.d.ts

@@ -1770,6 +1770,8 @@ declare const SearchConfigSchema: z.ZodObject<{
         default: z.ZodDefault<z.ZodNumber>;
     }, z.ZodNumber, "strip">>>;
     exclude: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    mcp_source: z.ZodOptional<z.ZodString>;
+    mcp_tool: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     version: 1;
     exclude: string[];
@@ -1781,6 +1783,8 @@ declare const SearchConfigSchema: z.ZodObject<{
     } & {
         [k: string]: number;
     };
+    mcp_source?: string | undefined;
+    mcp_tool?: string | undefined;
 }, {
     version?: 1 | undefined;
     exclude?: string[] | undefined;
@@ -1790,6 +1794,8 @@ declare const SearchConfigSchema: z.ZodObject<{
     budgets?: z.objectInputType<{
         default: z.ZodDefault<z.ZodNumber>;
     }, z.ZodNumber, "strip"> | undefined;
+    mcp_source?: string | undefined;
+    mcp_tool?: string | undefined;
 }>;
 type SearchConfig = z.infer<typeof SearchConfigSchema>;
 declare function budgetForStage(config: SearchConfig, stage: string | undefined): number;
@@ -1821,7 +1827,7 @@ interface SearchHit {
     language: string;
 }
 interface SearchResult {
-    provider: "builtin";
+    provider: string;
     warning?: string;
     query: string;
     scope: SearchScope;
@@ -1831,7 +1837,7 @@ interface SearchResult {
     text: string;
 }
 interface IndexStats {
-    provider: "builtin";
+    provider: string;
     files: number;
     chunks: number;
     lastIndexFilesConsidered: number;
@@ -1862,7 +1868,7 @@ interface RawHit {
     summary?: string;
 }
 
-declare function searchPreamble(query: string, scope: string, budget: number, hybrid?: boolean): string;
+declare function searchPreamble(query: string, scope: string, budget: number, hybrid?: boolean, provider?: string): string;
 declare function renderBlock(hit: RawHit, form: "full" | "signature" | "summary"): string;
 declare function packHits(input: {
     preamble: string;
@@ -1985,12 +1991,32 @@ declare function fuseHits(keyword: readonly RawHit[], vector: readonly RawHit[])
  */
 declare function mergeRankedHits(hits: readonly RawHit[]): RawHit[];
 
+interface McpToolResult {
+    ok: boolean;
+    text: string;
+}
+type McpSearchCall = (input: {
+    sourceId: string;
+    tool: string;
+    args: Record<string, unknown>;
+}) => Promise<McpToolResult>;
+interface SearchRunOptions {
+    mcpCall?: McpSearchCall;
+    mcpTimeoutMs?: number;
+}
+declare function openMcpSearchProvider(input: {
+    projectRoot: string;
+    search: SearchConfig;
+    call?: McpSearchCall;
+    timeoutMs?: number;
+}): SearchProvider;
+
 declare function registerSearchProvider(provider: SearchProvider): void;
 declare function clearRegisteredSearchProviders(): void;
 declare function fallbackWarning(name: string): string;
-declare function resolveSearchProvider(projectRoot: string, config: Config, search: SearchConfig, runtime?: SearchRuntime): SearchProvider;
+declare function resolveSearchProvider(projectRoot: string, config: Config, search: SearchConfig, runtime?: SearchRuntime, run?: SearchRunOptions): SearchProvider;
 declare function buildRetrievedInner(projectRoot: string, config: Config, title: string, stage: string | undefined, budget: number | undefined, runtime?: SearchRuntime, activeChange?: string): Promise<string>;
-declare function executeSearch(projectRoot: string, config: Config, query: string, scope: SearchScope, budget: number | undefined): Promise<SearchResult>;
+declare function executeSearch(projectRoot: string, config: Config, query: string, scope: SearchScope, budget: number | undefined, run?: SearchRunOptions): Promise<SearchResult>;
 
 interface SyncChangeResult {
     changeId: string;
@@ -3351,6 +3377,32 @@ declare function rebuildNetwork(root: string, input: {
     now?: () => Date;
 }): Promise<RoleCommandResult>;
 
+interface IssueRecord {
+    number: number;
+    title: string;
+    state: string;
+}
+type IssueRead = {
+    ok: true;
+    issue: IssueRecord;
+} | {
+    ok: false;
+    missing: boolean;
+};
+interface IssueSource {
+    read(number: number): Promise<IssueRead>;
+}
+declare function ghIssueSource(): IssueSource;
+declare function readConnector(input: {
+    verb: string;
+    connector: string;
+    record: string;
+    source?: IssueSource;
+    projectRoot?: string;
+    config?: Config;
+}): Promise<RoleCommandResult>;
+declare function runRoutine(root: string, roleName: string, routineName: string, source?: IssueSource): Promise<RoleCommandResult>;
+
 interface RunRoleInput {
     name: string;
     task?: string;
@@ -4031,4 +4083,4 @@ declare function formatEpicGraph(nodes: StoryNode[]): {
 /** Graph errors, then open dependencies. Null means the branch may be created. */
 declare function branchBlock(nodes: StoryNode[], story: string): string | null;
 
-export { AGENT_INTEGRATIONS, AGENT_TARGET_OPTIONS, ALL_AGENT_TARGETS, type AdapterExtractResult, AdapterRegistry, type AdvanceResult, type AgentInstallPlan, AgentInstallPreflightError, type AgentIntegration, type AgentTarget, type AgentTargetOption, type AllowRoleInput, type ArtifactDef, ArtifactDefSchema, type BuildRefinePlanOptions, type CallMcpToolResult, type ChangeContext, type ChangeMeta, ChangeMetaSchema, type ChangeMetrics, ChangeMetricsSchema, type ChangePhaseOrder, 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 DecideInput, type DecisionMetric, DecisionMetricSchema, type DecisionModel, type DecisionOutcome, type Duty, EMBEDDINGS_UNAVAILABLE, EMBEDDING_MODEL, type Embedder, type FastembedHooks, type FocusPlan, type Gate, GateSchema, type GatherMcpOptions, type GenerateCodeContextDeps, type GeneratedManifest, type GeneratedState, type GitHeadRunner, type GreenfieldFeature, type IndexStats, type InitOptions, type InitResult, type InstallAgentOptions, type InstallAgentResult, type InstallAgentsOptions, type InstallAgentsResult, type InstalledAgentSnapshot, type KeptFile, type KeptReason, type LanguageAdapter, type McpConfig, McpConfigSchema, type McpFetchResult, type McpInvoke, McpInvokeSchema, type McpMatchContext, type McpSource, McpSourceSchema, type McpWhen, McpWhenSchema, type MetricsImportResult, type ModelChoice, type ModelContext, type ModelEntry, type ModelsConfig, ModelsConfigSchema, PROTOCOL_MD, type PhaseMetric, PhaseMetricSchema, type PhaseTiming, type PhaseTimingRow, type PlannedWrite, type PriceCard, type Prices, type ProductTeamMember, RRF_K, type RawHit, type ReconcileGeneratedResult, type RefineArtifactRef, type RefineMode, type RefinePlan, type RemoveAgentHostsResult, type RenderChangeReportInput, type RoleCommandResult, type RoleLists, type RoleModel, type RoleProfile, type RouteDeps, type RouteHit, type RouteItem, type RunRoleInput, SDD_AGENT_ROLES, SDD_CORE_VERSION, SDD_DIR, SETUP_STEP_IDS, SETUP_WHY, SUMMARY_TOKEN_CAP, type SddAgentRole, type SddAgentRoleId, SddError, type SearchConfig, SearchConfigError, type SearchHit, type SearchProvider, type SearchQuery, type SearchResult, type SearchRuntime, type SearchScope, type SetupModelState, type SetupRolesChoice, type SetupStatus, type SetupStepId, type SetupStepInput, type Stage, StageSchema, type StartFeatureInput, type StartGreenfieldInput, type StartGreenfieldResult, type StoryDraft, type StoryNode, type SymbolInfo, type SymbolKind, type SyncChangeResult, type TeamConfig, TeamSchema, type TokenCounts, type TokenUsageMetric, TokenUsageMetricSchema, VerifyCommandSchema, type VerifyResult, type VerifyStatus, WORK_TYPES, type WorkType, type Workflow, WorkflowSchema, acceptNetwork, activePointerPath, activeStages, addLesson, addMcpSource, advanceStage, agentHostPaths, agentKickoffMessage, allowRole, approveGate, archiveDir, assertAgentInstallable, assertSessionLogAllowed, branchBlock, budgetForStage, buildAgentPrompt, buildContext, buildRefinePlan, buildRetrievedInner, callMcpSourceTool, canLeaveStage, changeDirName, changeMetaPath, changePath, changesDir, changesPathRel, checkModels, checkTeam, chunkCode, chunkMarkdown, classifyPath, clearActiveIf, clearRegisteredSearchProviders, compareChangesByFirstPhase, completeChange, configPath, contentHash, copyDir, copyDirSkipExisting, costFor, countTokens, createBuiltinProvider, createChange, createFastembedEmbedder, createRole, createRoleFromTemplate, decide, defaultConfig, defaultMcpConfig, defaultMcpYamlPath, defaultMemoryDir, defaultPricesYamlPath, defaultSearchYamlPath, defaultTeamsDir, defaultTemplatesDir, defaultWorkflowsDir, defaultsRoot, deleteRole, describeFsError, describeKept, displayArchivePath, displayChangePath, domainsDir, duplicateRole, dutyForStage, editRole, embedSearchQuery, emptyChangeMetrics, ensureDir, ensureMcpConfig, errorMessage, executeSearch, explainMatch, explainModel, extractiveSummary, fallbackAdapter, fallbackIncompleteStageId, fallbackWarning, fastembedImportCount, findFeaturesBacklogPath, firstActiveStageId, formatDuration, formatEpicGraph, formatJsonSummary, formatMcpContextForHandoff, formatModels, formatSetupStatus, formatStatus, formatTeam, formatTokenInventory, ftsTokens, fuseByRank, fuseHits, gatherMcpContext, gatherMcpContextForChange, generateCodeContext, generatedState, getActiveChangeId, getFacts, getHeadSha, getIntegration, getStage, gitUserName, guidancePaths, handoffRole, hideRole, importSessionMetrics, incompletePriorStageErrors, indexDbPath, inferComplexity, initProject, initTeam, installAgentIntegration, installAgentIntegrations, integrationKeyFor, interpolate, interpolateArgs, isHardDenied, isIgnoredPath, isInitialized, isPrunedDir, isSddError, isSecretPath, isStageSkipped, isSubstantiveArtifactContent, isWorkType, keywordHits, listBacklogFeatures, listBundledWorkflowNames, listChanges, listDirs, listFacts, listFiles, listMatchingSourceIds, listMcpSourceTools, listRoleTemplates, listScopeHits, listTeamTemplates, listWorkflowNames, loadBrain, loadChangeMeta, loadConfig, loadEpicStories, loadExcluder, loadGeneratedManifest, loadInstalledAgent, loadMcpConfig, loadModels, loadPrices, loadProductTeam, loadSearchConfig, loadWorkflow, markGenerated, matchMcpSources, mcpConfigPath, mcpTimeoutMs, memoryDir, memoryPathRel, mergeCaps, mergeConfigDefaults, mergeRankedHits, migrateTeamMemory, missingBundledWorkflows, modelFromEnv, nextStageId, nowIso, optionForTarget, packHits, parseAgentTargets, parseFeaturesBacklog, parseIntegration, parseSetupStep, parseStoryDraft, pathExists, phaseTiming, pinRole, planAgentIntegration, planNetwork, postRoom, prepareGuide, productTeamHome, promoteGreenfieldToMemory, queueRole, rankScope, readChangeMetrics, readHandoffCodePoints, readSetupStatus, readTeamConfig, readText, readYaml, rebuildNetwork, recommendWorkflow, reconcileGeneratedTree, recordDecisionMetric, recordDecisionRequest, recordSignoff, refreshActiveAgentContext, refreshConfiguredGuidance, registerSearchProvider, removeMcpSource, removeOtherAgentHosts, removeOtherAgentHostsDetailed, removePath, renderAgentsMd, renderBlock, renderChangeReport, renderMemoryIndex, renderProductTeamSection, renderProtocolMd, renderSddReadme, renderThinAgent, repairRequiredIgnores, reportAllChanges, reportChange, resolveActiveDirectory, resolveBot, resolveChangeId, resolveEmbedder, resolveFocus, resolveSearchProvider, resolveStages, reviewRoom, roleContextBody, routeRole, rrf, runGuide, runLocalVerify, runLoop, runNetwork, runRole, runSetupStep, saveChangeMeta, saveConfig, saveGeneratedManifest, saveMcpConfig, scopeForPath, sddRoot, searchConfigPath, searchPreamble, selectModel, setActiveChange, setFact, setRoleContext, setRoleMessaging, shouldAutoSkip, showFact, showMemory, showRoleGroup, showRoles, showRoom, showTeam, skipStage, slugify, spawnModelCommand, startFeatureFromBacklog, startGreenfield, startPhase, storyIdTaken, switchWorkflow, syncChangeHead, takeRole, templatesDir, toProcessEnv, todayIsoDate, tokenizeKeywords, transitionPhase, typescriptAdapter, uniqueChangeDirName, updateFeatureStatus, validBranchName, withMcpSource, workKind, workflowUnavailableMessage, workflowsDir, writeAgentHandoff, writeRefineBrief, writeText, writeTextIfMissing, writeYaml };
+export { AGENT_INTEGRATIONS, AGENT_TARGET_OPTIONS, ALL_AGENT_TARGETS, type AdapterExtractResult, AdapterRegistry, type AdvanceResult, type AgentInstallPlan, AgentInstallPreflightError, type AgentIntegration, type AgentTarget, type AgentTargetOption, type AllowRoleInput, type ArtifactDef, ArtifactDefSchema, type BuildRefinePlanOptions, type CallMcpToolResult, type ChangeContext, type ChangeMeta, ChangeMetaSchema, type ChangeMetrics, ChangeMetricsSchema, type ChangePhaseOrder, 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 DecideInput, type DecisionMetric, DecisionMetricSchema, type DecisionModel, type DecisionOutcome, type Duty, EMBEDDINGS_UNAVAILABLE, EMBEDDING_MODEL, type Embedder, type FastembedHooks, type FocusPlan, type Gate, GateSchema, type GatherMcpOptions, type GenerateCodeContextDeps, type GeneratedManifest, type GeneratedState, type GitHeadRunner, type GreenfieldFeature, type IndexStats, type InitOptions, type InitResult, type InstallAgentOptions, type InstallAgentResult, type InstallAgentsOptions, type InstallAgentsResult, type InstalledAgentSnapshot, type IssueRead, type IssueRecord, type IssueSource, type KeptFile, type KeptReason, type LanguageAdapter, type McpConfig, McpConfigSchema, type McpFetchResult, type McpInvoke, McpInvokeSchema, type McpMatchContext, type McpSearchCall, type McpSource, McpSourceSchema, type McpToolResult, type McpWhen, McpWhenSchema, type MetricsImportResult, type ModelChoice, type ModelContext, type ModelEntry, type ModelsConfig, ModelsConfigSchema, PROTOCOL_MD, type PhaseMetric, PhaseMetricSchema, type PhaseTiming, type PhaseTimingRow, type PlannedWrite, type PriceCard, type Prices, type ProductTeamMember, RRF_K, type RawHit, type ReconcileGeneratedResult, type RefineArtifactRef, type RefineMode, type RefinePlan, type RemoveAgentHostsResult, type RenderChangeReportInput, type RoleCommandResult, type RoleLists, type RoleModel, type RoleProfile, type RouteDeps, type RouteHit, type RouteItem, type RunRoleInput, SDD_AGENT_ROLES, SDD_CORE_VERSION, SDD_DIR, SETUP_STEP_IDS, SETUP_WHY, SUMMARY_TOKEN_CAP, type SddAgentRole, type SddAgentRoleId, SddError, type SearchConfig, SearchConfigError, type SearchHit, type SearchProvider, type SearchQuery, type SearchResult, type SearchRunOptions, type SearchRuntime, type SearchScope, type SetupModelState, type SetupRolesChoice, type SetupStatus, type SetupStepId, type SetupStepInput, type Stage, StageSchema, type StartFeatureInput, type StartGreenfieldInput, type StartGreenfieldResult, type StoryDraft, type StoryNode, type SymbolInfo, type SymbolKind, type SyncChangeResult, type TeamConfig, TeamSchema, type TokenCounts, type TokenUsageMetric, TokenUsageMetricSchema, VerifyCommandSchema, type VerifyResult, type VerifyStatus, WORK_TYPES, type WorkType, type Workflow, WorkflowSchema, acceptNetwork, activePointerPath, activeStages, addLesson, addMcpSource, advanceStage, agentHostPaths, agentKickoffMessage, allowRole, approveGate, archiveDir, assertAgentInstallable, assertSessionLogAllowed, branchBlock, budgetForStage, buildAgentPrompt, buildContext, buildRefinePlan, buildRetrievedInner, callMcpSourceTool, canLeaveStage, changeDirName, changeMetaPath, changePath, changesDir, changesPathRel, checkModels, checkTeam, chunkCode, chunkMarkdown, classifyPath, clearActiveIf, clearRegisteredSearchProviders, compareChangesByFirstPhase, completeChange, configPath, contentHash, copyDir, copyDirSkipExisting, costFor, countTokens, createBuiltinProvider, createChange, createFastembedEmbedder, createRole, createRoleFromTemplate, decide, defaultConfig, defaultMcpConfig, defaultMcpYamlPath, defaultMemoryDir, defaultPricesYamlPath, defaultSearchYamlPath, defaultTeamsDir, defaultTemplatesDir, defaultWorkflowsDir, defaultsRoot, deleteRole, describeFsError, describeKept, displayArchivePath, displayChangePath, domainsDir, duplicateRole, dutyForStage, editRole, embedSearchQuery, emptyChangeMetrics, ensureDir, ensureMcpConfig, errorMessage, executeSearch, explainMatch, explainModel, extractiveSummary, fallbackAdapter, fallbackIncompleteStageId, fallbackWarning, fastembedImportCount, findFeaturesBacklogPath, firstActiveStageId, formatDuration, formatEpicGraph, formatJsonSummary, formatMcpContextForHandoff, formatModels, formatSetupStatus, formatStatus, formatTeam, formatTokenInventory, ftsTokens, fuseByRank, fuseHits, gatherMcpContext, gatherMcpContextForChange, generateCodeContext, generatedState, getActiveChangeId, getFacts, getHeadSha, getIntegration, getStage, ghIssueSource, gitUserName, guidancePaths, handoffRole, hideRole, importSessionMetrics, incompletePriorStageErrors, indexDbPath, inferComplexity, initProject, initTeam, installAgentIntegration, installAgentIntegrations, integrationKeyFor, interpolate, interpolateArgs, isHardDenied, isIgnoredPath, isInitialized, isPrunedDir, isSddError, isSecretPath, isStageSkipped, isSubstantiveArtifactContent, isWorkType, keywordHits, listBacklogFeatures, listBundledWorkflowNames, listChanges, listDirs, listFacts, listFiles, listMatchingSourceIds, listMcpSourceTools, listRoleTemplates, listScopeHits, listTeamTemplates, listWorkflowNames, loadBrain, loadChangeMeta, loadConfig, loadEpicStories, loadExcluder, loadGeneratedManifest, loadInstalledAgent, loadMcpConfig, loadModels, loadPrices, loadProductTeam, loadSearchConfig, loadWorkflow, markGenerated, matchMcpSources, mcpConfigPath, mcpTimeoutMs, memoryDir, memoryPathRel, mergeCaps, mergeConfigDefaults, mergeRankedHits, migrateTeamMemory, missingBundledWorkflows, modelFromEnv, nextStageId, nowIso, openMcpSearchProvider, optionForTarget, packHits, parseAgentTargets, parseFeaturesBacklog, parseIntegration, parseSetupStep, parseStoryDraft, pathExists, phaseTiming, pinRole, planAgentIntegration, planNetwork, postRoom, prepareGuide, productTeamHome, promoteGreenfieldToMemory, queueRole, rankScope, readChangeMetrics, readConnector, readHandoffCodePoints, readSetupStatus, readTeamConfig, readText, readYaml, rebuildNetwork, recommendWorkflow, reconcileGeneratedTree, recordDecisionMetric, recordDecisionRequest, recordSignoff, refreshActiveAgentContext, refreshConfiguredGuidance, registerSearchProvider, removeMcpSource, removeOtherAgentHosts, removeOtherAgentHostsDetailed, removePath, renderAgentsMd, renderBlock, renderChangeReport, renderMemoryIndex, renderProductTeamSection, renderProtocolMd, renderSddReadme, renderThinAgent, repairRequiredIgnores, reportAllChanges, reportChange, resolveActiveDirectory, resolveBot, resolveChangeId, resolveEmbedder, resolveFocus, resolveSearchProvider, resolveStages, reviewRoom, roleContextBody, routeRole, rrf, runGuide, runLocalVerify, runLoop, runNetwork, runRole, runRoutine, runSetupStep, saveChangeMeta, saveConfig, saveGeneratedManifest, saveMcpConfig, scopeForPath, sddRoot, searchConfigPath, searchPreamble, selectModel, setActiveChange, setFact, setRoleContext, setRoleMessaging, shouldAutoSkip, showFact, showMemory, showRoleGroup, showRoles, showRoom, showTeam, skipStage, slugify, spawnModelCommand, startFeatureFromBacklog, startGreenfield, startPhase, storyIdTaken, switchWorkflow, syncChangeHead, takeRole, templatesDir, toProcessEnv, todayIsoDate, tokenizeKeywords, transitionPhase, typescriptAdapter, uniqueChangeDirName, updateFeatureStatus, validBranchName, withMcpSource, workKind, workflowUnavailableMessage, workflowsDir, writeAgentHandoff, writeRefineBrief, writeText, writeTextIfMissing, writeYaml };