raptor-aios 0.1.0

package/dist/_core/dist/mcp/materializer.d.ts

@@ -0,0 +1,40 @@
+/**
+ * MCP materializer — writes declared servers into each agent's native config,
+ * preserving anything else already in those files (non-destructive merge).
+ *
+ * - JSON targets (.mcp.json, .cursor/mcp.json, .vscode/mcp.json,
+ *   .gemini/settings.json): read → set `obj[jsonKey][name]` for each targeted
+ *   server → write. Other keys (and unrelated servers) are preserved.
+ * - TOML target (.codex/config.toml): a marker-delimited managed block holds
+ *   the `[mcp_servers.*]` sections; the rest of the file is untouched.
+ */
+import type { McpServer } from "./types.js";
+export interface MaterializedServer {
+    server: string;
+    agentId: string;
+    path: string;
+}
+/** Absolute path of an agent's MCP config file, or undefined if unsupported. */
+export declare function mcpTargetPath(projectRoot: string, agentId: string): string | undefined;
+/**
+ * Materialize the full set of declared servers into every MCP-capable agent in
+ * `agentIds`. Declarative: for TOML the managed block is regenerated (so
+ * removals are reflected); for JSON the targeted server keys are (re)set.
+ */
+export declare function materializeMcp(opts: {
+    projectRoot: string;
+    servers: McpServer[];
+    agentIds: string[];
+}): MaterializedServer[];
+/**
+ * Delete a server's JSON key from every targeted agent. (TOML is handled by
+ * re-running `materializeMcp` with the remaining servers.)
+ */
+export declare function deleteServerFromJsonTargets(opts: {
+    projectRoot: string;
+    serverName: string;
+    agentIds: string[];
+}): string[];
+/** Whether a server appears materialized in an agent's native config. */
+export declare function isServerMaterialized(projectRoot: string, serverName: string, agentId: string): boolean;
+//# sourceMappingURL=materializer.d.ts.map

package/dist/_core/dist/mcp/materializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materializer.d.ts","sourceRoot":"","sources":["../../src/mcp/materializer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAUH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAK5C,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AASD,gFAAgF;AAChF,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,SAAS,CAGpB;AAyFD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,GAAG,kBAAkB,EAAE,CAQvB;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,GAAG,MAAM,EAAE,CAiBX;AAED,yEAAyE;AACzE,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,OAAO,CAWT"}

package/dist/_core/dist/mcp/materializer.js

@@ -0,0 +1,161 @@
+/**
+ * MCP materializer — writes declared servers into each agent's native config,
+ * preserving anything else already in those files (non-destructive merge).
+ *
+ * - JSON targets (.mcp.json, .cursor/mcp.json, .vscode/mcp.json,
+ *   .gemini/settings.json): read → set `obj[jsonKey][name]` for each targeted
+ *   server → write. Other keys (and unrelated servers) are preserved.
+ * - TOML target (.codex/config.toml): a marker-delimited managed block holds
+ *   the `[mcp_servers.*]` sections; the rest of the file is untouched.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { MCP_TARGETS, buildServerEntry, mcpTargetFor, } from "./targets.js";
+const TOML_BEGIN = "# >>> raptor mcp (managed — do not edit) >>>";
+const TOML_END = "# <<< raptor mcp <<<";
+function targetsServer(server, agentId) {
+    if (server.agents && server.agents.length > 0) {
+        return server.agents.includes(agentId);
+    }
+    return true;
+}
+/** Absolute path of an agent's MCP config file, or undefined if unsupported. */
+export function mcpTargetPath(projectRoot, agentId) {
+    const t = mcpTargetFor(agentId);
+    return t ? join(projectRoot, t.file) : undefined;
+}
+function readJsonFile(path) {
+    if (!existsSync(path))
+        return {};
+    const raw = readFileSync(path, "utf8").trim();
+    if (!raw)
+        return {};
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        throw new Error(`${path} is not valid JSON — refusing to overwrite. Fix or remove it.`);
+    }
+}
+function writeJsonFile(path, obj) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify(obj, null, 2) + "\n");
+}
+function tomlString(v) {
+    return `"${v.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+}
+function tomlBlockFor(servers) {
+    const lines = [TOML_BEGIN];
+    for (const s of servers) {
+        lines.push(`[mcp_servers.${s.name}]`);
+        if (s.transport === "stdio") {
+            if (s.command)
+                lines.push(`command = ${tomlString(s.command)}`);
+            if (s.args && s.args.length > 0) {
+                lines.push(`args = [${s.args.map(tomlString).join(", ")}]`);
+            }
+        }
+        else {
+            lines.push(`transport = ${tomlString(s.transport)}`);
+            if (s.url)
+                lines.push(`url = ${tomlString(s.url)}`);
+        }
+        if (s.env && Object.keys(s.env).length > 0) {
+            lines.push(`[mcp_servers.${s.name}.env]`);
+            for (const [k, val] of Object.entries(s.env)) {
+                lines.push(`${k} = ${tomlString(val)}`);
+            }
+        }
+    }
+    lines.push(TOML_END);
+    return lines.join("\n");
+}
+/** Replace (or append) the Raptor-managed block in a TOML file body. */
+function spliceTomlBlock(existing, block) {
+    const begin = existing.indexOf(TOML_BEGIN);
+    const end = existing.indexOf(TOML_END);
+    if (begin !== -1 && end !== -1 && end > begin) {
+        const before = existing.slice(0, begin);
+        const after = existing.slice(end + TOML_END.length);
+        return `${before.trimEnd()}\n${block}\n${after.trimStart()}`.trim() + "\n";
+    }
+    return existing.trim().length > 0
+        ? `${existing.trimEnd()}\n\n${block}\n`
+        : `${block}\n`;
+}
+function materializeForAgent(projectRoot, agentId, target, allServers) {
+    const targeted = allServers.filter((s) => targetsServer(s, agentId));
+    const path = join(projectRoot, target.file);
+    if (target.format === "toml") {
+        const existing = existsSync(path) ? readFileSync(path, "utf8") : "";
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, spliceTomlBlock(existing, tomlBlockFor(targeted)));
+    }
+    else {
+        const key = target.jsonKey ?? "mcpServers";
+        const obj = readJsonFile(path);
+        const map = (obj[key] && typeof obj[key] === "object"
+            ? obj[key]
+            : {});
+        for (const s of targeted)
+            map[s.name] = buildServerEntry(s);
+        obj[key] = map;
+        writeJsonFile(path, obj);
+    }
+    return targeted.map((s) => ({ server: s.name, agentId, path }));
+}
+/**
+ * Materialize the full set of declared servers into every MCP-capable agent in
+ * `agentIds`. Declarative: for TOML the managed block is regenerated (so
+ * removals are reflected); for JSON the targeted server keys are (re)set.
+ */
+export function materializeMcp(opts) {
+    const out = [];
+    for (const agentId of opts.agentIds) {
+        const target = MCP_TARGETS[agentId];
+        if (!target)
+            continue;
+        out.push(...materializeForAgent(opts.projectRoot, agentId, target, opts.servers));
+    }
+    return out;
+}
+/**
+ * Delete a server's JSON key from every targeted agent. (TOML is handled by
+ * re-running `materializeMcp` with the remaining servers.)
+ */
+export function deleteServerFromJsonTargets(opts) {
+    const removed = [];
+    for (const agentId of opts.agentIds) {
+        const target = MCP_TARGETS[agentId];
+        if (!target || target.format !== "json")
+            continue;
+        const path = join(opts.projectRoot, target.file);
+        if (!existsSync(path))
+            continue;
+        const key = target.jsonKey ?? "mcpServers";
+        const obj = readJsonFile(path);
+        const map = obj[key];
+        if (map && opts.serverName in map) {
+            delete map[opts.serverName];
+            writeJsonFile(path, obj);
+            removed.push(path);
+        }
+    }
+    return removed;
+}
+/** Whether a server appears materialized in an agent's native config. */
+export function isServerMaterialized(projectRoot, serverName, agentId) {
+    const target = MCP_TARGETS[agentId];
+    if (!target)
+        return false;
+    const path = join(projectRoot, target.file);
+    if (!existsSync(path))
+        return false;
+    if (target.format === "toml") {
+        return readFileSync(path, "utf8").includes(`[mcp_servers.${serverName}]`);
+    }
+    const key = target.jsonKey ?? "mcpServers";
+    const map = readJsonFile(path)[key];
+    return !!map && serverName in map;
+}
+//# sourceMappingURL=materializer.js.map

package/dist/_core/dist/mcp/materializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"materializer.js","sourceRoot":"","sources":["../../src/mcp/materializer.ts"],"names":[],"mappings":"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"}

package/dist/_core/dist/mcp/targets.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Per-agent MCP target descriptors — where and in what format each agent
+ * expects its MCP server config.
+ *
+ * Centralized here (rather than on each AgentAdapter) so MCP knowledge stays
+ * self-contained and the adapters remain lean.
+ */
+import type { McpServer } from "./types.js";
+export type McpFormat = "json" | "toml";
+export interface McpTarget {
+    /** Relative file path under the project root. */
+    file: string;
+    /** Serialization format. */
+    format: McpFormat;
+    /**
+     * Top-level key holding the server map (JSON only). Claude/Cursor/Gemini use
+     * `mcpServers`; VS Code / Copilot use `servers`.
+     */
+    jsonKey?: "mcpServers" | "servers";
+    /**
+     * When true (Gemini settings.json), the file holds unrelated settings too,
+     * so the materializer must preserve all other top-level keys.
+     */
+    mergeWholeFile?: boolean;
+}
+export declare const MCP_TARGETS: Record<string, McpTarget>;
+/** Agent keys that have a known MCP target. */
+export declare function mcpCapableAgents(): string[];
+export declare function mcpTargetFor(agentId: string): McpTarget | undefined;
+/**
+ * Build the native config entry (value stored under the server name) for a
+ * server. Shape follows the de-facto MCP client conventions:
+ *   stdio  → { command, args?, env? }
+ *   sse/http → { type, url, headers? }
+ */
+export declare function buildServerEntry(server: McpServer): Record<string, unknown>;
+//# sourceMappingURL=targets.d.ts.map

package/dist/_core/dist/mcp/targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.d.ts","sourceRoot":"","sources":["../../src/mcp/targets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAExC,MAAM,WAAW,SAAS;IACxB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,MAAM,EAAE,SAAS,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IACnC;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAgBjD,CAAC;AAEF,+CAA+C;AAC/C,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAE3C;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAEnE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAe3E"}

package/dist/_core/dist/mcp/targets.js

@@ -0,0 +1,56 @@
+/**
+ * Per-agent MCP target descriptors — where and in what format each agent
+ * expects its MCP server config.
+ *
+ * Centralized here (rather than on each AgentAdapter) so MCP knowledge stays
+ * self-contained and the adapters remain lean.
+ */
+export const MCP_TARGETS = {
+    "claude-code": { file: ".mcp.json", format: "json", jsonKey: "mcpServers" },
+    cursor: { file: ".cursor/mcp.json", format: "json", jsonKey: "mcpServers" },
+    copilot: { file: ".vscode/mcp.json", format: "json", jsonKey: "servers" },
+    gemini: {
+        file: ".gemini/settings.json",
+        format: "json",
+        jsonKey: "mcpServers",
+        mergeWholeFile: true,
+    },
+    antigravity: {
+        file: ".antigravity/mcp.json",
+        format: "json",
+        jsonKey: "mcpServers",
+    },
+    codex: { file: ".codex/config.toml", format: "toml" },
+};
+/** Agent keys that have a known MCP target. */
+export function mcpCapableAgents() {
+    return Object.keys(MCP_TARGETS);
+}
+export function mcpTargetFor(agentId) {
+    return MCP_TARGETS[agentId];
+}
+/**
+ * Build the native config entry (value stored under the server name) for a
+ * server. Shape follows the de-facto MCP client conventions:
+ *   stdio  → { command, args?, env? }
+ *   sse/http → { type, url, headers? }
+ */
+export function buildServerEntry(server) {
+    if (server.transport === "stdio") {
+        const entry = { command: server.command };
+        if (server.args && server.args.length > 0)
+            entry["args"] = server.args;
+        if (server.env && Object.keys(server.env).length > 0)
+            entry["env"] = server.env;
+        return entry;
+    }
+    const entry = {
+        type: server.transport,
+        url: server.url,
+    };
+    if (server.headers && Object.keys(server.headers).length > 0) {
+        entry["headers"] = server.headers;
+    }
+    return entry;
+}
+//# sourceMappingURL=targets.js.map

package/dist/_core/dist/mcp/targets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.js","sourceRoot":"","sources":["../../src/mcp/targets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAuBH,MAAM,CAAC,MAAM,WAAW,GAA8B;IACpD,aAAa,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE;IAC3E,MAAM,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE;IAC3E,OAAO,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE;IACzE,MAAM,EAAE;QACN,IAAI,EAAE,uBAAuB;QAC7B,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,YAAY;QACrB,cAAc,EAAE,IAAI;KACrB;IACD,WAAW,EAAE;QACX,IAAI,EAAE,uBAAuB;QAC7B,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,YAAY;KACtB;IACD,KAAK,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,EAAE;CACtD,CAAC;AAEF,+CAA+C;AAC/C,MAAM,UAAU,gBAAgB;IAC9B,OAAO,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,IAAI,MAAM,CAAC,SAAS,KAAK,OAAO,EAAE,CAAC;QACjC,MAAM,KAAK,GAA4B,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;QACnE,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,KAAK,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC;QACvE,IAAI,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC;YAAE,KAAK,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC;QAChF,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,KAAK,GAA4B;QACrC,IAAI,EAAE,MAAM,CAAC,SAAS;QACtB,GAAG,EAAE,MAAM,CAAC,GAAG;KAChB,CAAC;IACF,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7D,KAAK,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC;IACpC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/_core/dist/mcp/types.d.ts

@@ -0,0 +1,34 @@
+/**
+ * MCP (Model Context Protocol) — declarative server definitions that Raptor
+ * materializes into each agent's native MCP config format.
+ *
+ * Schema: raptor.mcp/v1. Source of truth: `.raptor/mcp.yml`.
+ */
+export declare const MCP_SCHEMA_V1: "raptor.mcp/v1";
+export type McpTransport = "stdio" | "sse" | "http";
+export interface McpServer {
+    /** Unique server name (used as the key in native configs). */
+    name: string;
+    /** Transport kind. `stdio` spawns a process; `sse`/`http` hit a URL. */
+    transport: McpTransport;
+    /** stdio: executable to spawn. */
+    command?: string;
+    /** stdio: arguments for `command`. */
+    args?: string[];
+    /** stdio: extra environment variables. */
+    env?: Record<string, string>;
+    /** sse/http: server URL. */
+    url?: string;
+    /** sse/http: extra request headers. */
+    headers?: Record<string, string>;
+    /**
+     * Agent keys this server targets. Omit/empty = all configured agents that
+     * support MCP. Each entry must be a known agent key.
+     */
+    agents?: string[];
+}
+export interface McpConfig {
+    schema: typeof MCP_SCHEMA_V1;
+    servers: McpServer[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/_core/dist/mcp/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,aAAa,EAAG,eAAwB,CAAC;AAEtD,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AAEpD,MAAM,WAAW,SAAS;IACxB,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,SAAS,EAAE,YAAY,CAAC;IACxB,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,OAAO,aAAa,CAAC;IAC7B,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB"}

package/dist/_core/dist/mcp/types.js

@@ -0,0 +1,8 @@
+/**
+ * MCP (Model Context Protocol) — declarative server definitions that Raptor
+ * materializes into each agent's native MCP config format.
+ *
+ * Schema: raptor.mcp/v1. Source of truth: `.raptor/mcp.yml`.
+ */
+export const MCP_SCHEMA_V1 = "raptor.mcp/v1";
+//# sourceMappingURL=types.js.map

package/dist/_core/dist/mcp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,eAAwB,CAAC"}

package/dist/_core/dist/models/analyze.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Analyze Model — cross-artifact analysis engine.
+ *
+ * Phase 3b: Optional analysis step between tasks and implement.
+ * Performs cross-referential analysis of spec ↔ plan ↔ tasks ↔ constitution
+ * to detect drift, incomplete coverage, orphan decisions, and risk signals.
+ *
+ * Blueprint ref: 16.9 — "raptor analyze {feature}".
+ */
+import type { AcceptanceEvidence } from "./impl-log.js";
+export type AnalysisTarget = "risk" | "complexity" | "effort" | "coverage" | "m7" | "all";
+export type FindingSeverity = "critical" | "warning" | "info";
+export type FindingCategory = "drift" | "coverage_gap" | "orphan_decision" | "orphan_task" | "id_mismatch" | "hash_stale" | "m7_gap" | "m7_untested_code" | "m7_invalid_evidence" | "complexity" | "risk" | "effort";
+export interface Finding {
+    /** Finding ID (F-1, F-2, ...). */
+    id: string;
+    /** Severity level. */
+    severity: FindingSeverity;
+    /** Finding category. */
+    category: FindingCategory;
+    /** Human-readable description. */
+    message: string;
+    /** Source artifact (spec.md, plan.md, tasks.md). */
+    source: string;
+    /** Traced to IDs (Ak, Dk, Tk). */
+    traces: string[];
+    /** Suggested action. */
+    recommendation?: string;
+}
+export interface AnalysisFrontmatter {
+    /** Feature ID. */
+    id: string;
+    /** Feature slug. */
+    slug: string;
+    /** Analysis target. */
+    target: AnalysisTarget;
+    /** Hash of spec at analysis time. */
+    spec_hash: string;
+    /** Hash of plan at analysis time. */
+    plan_hash: string;
+    /** Hash of tasks at analysis time. */
+    tasks_hash: string;
+    /** ISO timestamp. */
+    created: string;
+}
+export interface AnalysisResult {
+    /** Feature ID. */
+    featureId: string;
+    /** Analysis target. */
+    target: AnalysisTarget;
+    /** All findings. */
+    findings: Finding[];
+    /** Summary counts by severity. */
+    summary: AnalysisSummary;
+    /** Input hashes for provenance. */
+    inputHashes: {
+        spec: string;
+        plan: string;
+        tasks: string;
+    };
+}
+export interface AnalysisSummary {
+    total: number;
+    critical: number;
+    warning: number;
+    info: number;
+}
+/**
+ * Detect hash drift between artifacts.
+ *
+ * Checks if plan.md's spec_hash matches the current spec.md hash,
+ * and if tasks.md's plan_hash matches the current plan.md hash.
+ */
+export declare function detectDrift(artifacts: {
+    specHash: string;
+    planSpecHash: string;
+    planHash: string;
+    tasksPlanHash: string;
+}): Finding[];
+/**
+ * Detect coverage gaps in the acceptance → decision → task chain.
+ *
+ * Every acceptance criterion (Ak) should be covered by at least one
+ * decision (Dk), and every decision should be covered by at least
+ * one task (Tk).
+ */
+export declare function detectCoverageGaps(chain: {
+    acceptanceIds: string[];
+    decisionIds: string[];
+    taskIds: string[];
+    acceptanceToDecisions: Record<string, string[]>;
+    decisionToTasks: Record<string, string[]>;
+}): Finding[];
+/**
+ * Detect orphan decisions — decisions referenced in tasks
+ * that don't exist in the plan.
+ */
+export declare function detectOrphans(refs: {
+    decisionIds: Set<string>;
+    taskDecisionRefs: Array<{
+        taskId: string;
+        decisionRef: string;
+    }>;
+    taskIds: Set<string>;
+    planTaskRefs: Array<{
+        decisionId: string;
+        taskRef: string;
+    }>;
+}): Finding[];
+/**
+ * Detect ID mismatches — IDs that appear in different formats
+ * or have numbering gaps.
+ */
+export declare function detectIdIssues(ids: {
+    acceptanceIds: string[];
+    decisionIds: string[];
+    taskIds: string[];
+}): Finding[];
+/**
+ * Detect M7 gaps (Code-Spec conformance).
+ */
+export declare function detectM7Gaps(coverage: Record<string, AcceptanceEvidence[]>): Finding[];
+/**
+ * Compute summary from findings.
+ */
+export declare function summarizeFindings(findings: Finding[]): AnalysisSummary;
+/**
+ * Generate an analysis.md report from findings.
+ */
+export declare function generateAnalysisReport(result: AnalysisResult): string;
+//# sourceMappingURL=analyze.d.ts.map

package/dist/_core/dist/models/analyze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../src/models/analyze.ts"],"names":[],"mappings":"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"}