raptor-aios 0.1.0

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

@@ -0,0 +1,116 @@
+/**
+ * Clarify Model — Q&A rounds on spec.md.
+ *
+ * Phase 1b: Optional clarification step between spec and plan.
+ * Produces append-only clarification ledger and detects unresolved
+ * [NEEDS CLARIFICATION] blocks in the spec.
+ *
+ * Blueprint ref: 16.5 — "raptor clarify {feature}".
+ */
+export interface ClarifyQuestion {
+    /** Question ID within the round. */
+    id: string;
+    /** The question text. */
+    question: string;
+    /** Context from the spec that triggered this question. */
+    context?: string;
+    /** Section of the spec this relates to. */
+    section?: string;
+}
+export interface ClarifyAnswer {
+    /** Matches question.id. */
+    questionId: string;
+    /** The answer text. */
+    answer: string;
+    /** Who provided the answer. */
+    answeredBy: string;
+    /** ISO timestamp. */
+    answeredAt: string;
+}
+export interface ClarifyRound {
+    /** Round number (1-based). */
+    round: number;
+    /** ISO timestamp of round start. */
+    startedAt: string;
+    /** ISO timestamp of round completion. */
+    completedAt?: string;
+    /** Questions asked in this round. */
+    questions: ClarifyQuestion[];
+    /** Answers received. */
+    answers: ClarifyAnswer[];
+    /** Status of this round. */
+    status: "open" | "completed" | "rejected";
+}
+export interface ClarifyLedger {
+    /** Feature ID. */
+    featureId: string;
+    /** Reference to spec.md. */
+    specRef: string;
+    /** All rounds. */
+    rounds: ClarifyRound[];
+    /** Total questions across all rounds. */
+    totalQuestions: number;
+    /** Total answered. */
+    totalAnswered: number;
+}
+export interface ClarifyResult {
+    /** The updated spec body (with clarifications applied). */
+    updatedBody?: string;
+    /** Unresolved clarification markers. */
+    unresolvedMarkers: ClarifyMarker[];
+    /** Whether the spec has unresolved clarifications. */
+    hasUnresolved: boolean;
+}
+export interface ClarifyMarker {
+    /** Line number (0-based). */
+    line: number;
+    /** The marker text. */
+    text: string;
+    /** Optional label extracted from the marker. */
+    label?: string;
+}
+/**
+ * Detect [NEEDS CLARIFICATION] markers in a spec body.
+ *
+ * HTML comments (`<!-- ... -->`) are stripped before scanning to avoid
+ * false positives from template instruction blocks (T5.1).
+ */
+export declare function detectClarificationMarkers(body: string): ClarifyMarker[];
+/**
+ * Remove HTML comments from markdown content while preserving line count
+ * (replaced with empty strings to keep line numbers stable).
+ *
+ * Shared with the checklist parser (C6) and the spec parser (C1) so that
+ * instruction blocks inside `<!-- ... -->` never count as real content.
+ */
+export declare function stripHtmlComments(content: string): string;
+/**
+ * Check if a spec has unresolved clarifications.
+ * Used by gate.clarify.no_contradictions.
+ */
+export declare function hasUnresolvedClarifications(specPath: string): ClarifyResult;
+/**
+ * Get the ledger file path for a feature.
+ */
+export declare function ledgerPath(featureDir: string): string;
+/**
+ * Load or initialize a clarification ledger.
+ */
+export declare function loadLedger(featureDir: string, featureId: string): ClarifyLedger;
+/**
+ * Append a completed round to the ledger.
+ */
+export declare function appendRound(featureDir: string, round: ClarifyRound): void;
+/**
+ * Append a round rejection to the ledger.
+ */
+export declare function appendRoundRejection(featureDir: string, roundNumber: number, reason: string): void;
+/**
+ * Apply answered clarifications to the spec body.
+ * Replaces [NEEDS CLARIFICATION: <label>] with the answer text.
+ */
+export declare function applyClarifications(specBody: string, answers: Array<{
+    label: string;
+    answer: string;
+}>): string;
+//# sourceMappingURL=clarify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clarify.d.ts","sourceRoot":"","sources":["../../src/models/clarify.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgBH,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,wBAAwB;IACxB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,4BAA4B;IAC5B,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;CAC3C;AAED,MAAM,WAAW,aAAa;IAC5B,kBAAkB;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,yCAAyC;IACzC,cAAc,EAAE,MAAM,CAAC;IACvB,sBAAsB;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,iBAAiB,EAAE,aAAa,EAAE,CAAC;IACnC,sDAAsD;IACtD,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAaD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAsBxE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKzD;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAa3E;AAQD;;GAEG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,aAAa,CA0Cf;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAQzE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,IAAI,CASN;AAMD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,GAChD,MAAM,CAUR"}

package/dist/_core/dist/models/clarify.js

@@ -0,0 +1,166 @@
+/**
+ * Clarify Model — Q&A rounds on spec.md.
+ *
+ * Phase 1b: Optional clarification step between spec and plan.
+ * Produces append-only clarification ledger and detects unresolved
+ * [NEEDS CLARIFICATION] blocks in the spec.
+ *
+ * Blueprint ref: 16.5 — "raptor clarify {feature}".
+ */
+import { readFileSync, existsSync, appendFileSync, } from "node:fs";
+import { join } from "node:path";
+import { parseFrontmatter } from "../frontmatter/index.js";
+// ---------------------------------------------------------------------------
+// Clarification marker detection
+// ---------------------------------------------------------------------------
+// Matches `[NEEDS CLARIFICATION]`, `[NEEDS CLARIFICATION: <q>]`, and the
+// colon-less form `[NEEDS CLARIFICATION <q>]` / `[NEEDS CLARIFICATION — <q>]`
+// that the canonical templates embed (e.g. spec.md.hbs `[NEEDS CLARIFICATION
+// which flows]`). The optional separator group accepts `:`, whitespace, or a
+// dash/em-dash before the label so none of those forms is missed (C2).
+const CLARIFICATION_RE = /\[NEEDS CLARIFICATION(?:[:\s—-]+([^\]]*))?\]/g;
+/**
+ * Detect [NEEDS CLARIFICATION] markers in a spec body.
+ *
+ * HTML comments (`<!-- ... -->`) are stripped before scanning to avoid
+ * false positives from template instruction blocks (T5.1).
+ */
+export function detectClarificationMarkers(body) {
+    const markers = [];
+    // T5.1: Strip HTML comments to avoid flagging markers inside instruction blocks
+    const stripped = stripHtmlComments(body);
+    const lines = stripped.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        let m;
+        const re = new RegExp(CLARIFICATION_RE);
+        while ((m = re.exec(line)) !== null) {
+            markers.push({
+                line: i,
+                text: m[0],
+                label: m[1]?.trim() || undefined,
+            });
+        }
+    }
+    return markers;
+}
+/**
+ * Remove HTML comments from markdown content while preserving line count
+ * (replaced with empty strings to keep line numbers stable).
+ *
+ * Shared with the checklist parser (C6) and the spec parser (C1) so that
+ * instruction blocks inside `<!-- ... -->` never count as real content.
+ */
+export function stripHtmlComments(content) {
+    return content.replace(/<!--[\s\S]*?-->/g, (match) => {
+        // Preserve newlines to keep line numbers accurate
+        return match.replace(/[^\n]/g, "");
+    });
+}
+/**
+ * Check if a spec has unresolved clarifications.
+ * Used by gate.clarify.no_contradictions.
+ */
+export function hasUnresolvedClarifications(specPath) {
+    if (!existsSync(specPath)) {
+        return { unresolvedMarkers: [], hasUnresolved: false };
+    }
+    const raw = readFileSync(specPath, "utf8");
+    const { body } = parseFrontmatter(raw);
+    const markers = detectClarificationMarkers(body);
+    return {
+        unresolvedMarkers: markers,
+        hasUnresolved: markers.length > 0,
+    };
+}
+// ---------------------------------------------------------------------------
+// Clarification ledger management
+// ---------------------------------------------------------------------------
+const LEDGER_FILENAME = "spec.md.clarifications.jsonl";
+/**
+ * Get the ledger file path for a feature.
+ */
+export function ledgerPath(featureDir) {
+    return join(featureDir, LEDGER_FILENAME);
+}
+/**
+ * Load or initialize a clarification ledger.
+ */
+export function loadLedger(featureDir, featureId) {
+    const path = ledgerPath(featureDir);
+    if (!existsSync(path)) {
+        return {
+            featureId,
+            specRef: "",
+            rounds: [],
+            totalQuestions: 0,
+            totalAnswered: 0,
+        };
+    }
+    const lines = readFileSync(path, "utf8")
+        .split("\n")
+        .filter((l) => l.trim());
+    const rounds = [];
+    for (const line of lines) {
+        try {
+            const event = JSON.parse(line);
+            if (event.type === "round.completed" && event.round) {
+                rounds.push(event.round);
+            }
+        }
+        catch {
+            // Malformed line, skip
+        }
+    }
+    const totalQuestions = rounds.reduce((s, r) => s + r.questions.length, 0);
+    const totalAnswered = rounds.reduce((s, r) => s + r.answers.length, 0);
+    return {
+        featureId,
+        specRef: "",
+        rounds,
+        totalQuestions,
+        totalAnswered,
+    };
+}
+/**
+ * Append a completed round to the ledger.
+ */
+export function appendRound(featureDir, round) {
+    const path = ledgerPath(featureDir);
+    const event = {
+        type: "round.completed",
+        timestamp: new Date().toISOString(),
+        round,
+    };
+    appendFileSync(path, JSON.stringify(event) + "\n");
+}
+/**
+ * Append a round rejection to the ledger.
+ */
+export function appendRoundRejection(featureDir, roundNumber, reason) {
+    const path = ledgerPath(featureDir);
+    const event = {
+        type: "round.rejected",
+        timestamp: new Date().toISOString(),
+        round: roundNumber,
+        reason,
+    };
+    appendFileSync(path, JSON.stringify(event) + "\n");
+}
+// ---------------------------------------------------------------------------
+// Spec update with clarifications
+// ---------------------------------------------------------------------------
+/**
+ * Apply answered clarifications to the spec body.
+ * Replaces [NEEDS CLARIFICATION: <label>] with the answer text.
+ */
+export function applyClarifications(specBody, answers) {
+    let result = specBody;
+    for (const { label, answer } of answers) {
+        const escapedLabel = label.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+        const re = new RegExp(`\\[NEEDS CLARIFICATION:\\s*${escapedLabel}\\]`, "g");
+        result = result.replace(re, answer);
+    }
+    return result;
+}
+//# sourceMappingURL=clarify.js.map

package/dist/_core/dist/models/clarify.js.map

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

package/dist/_core/dist/models/impl-log.d.ts

@@ -0,0 +1,64 @@
+/**
+ * ImplLog Model — implementation log and M7 trace source.
+ *
+ * This file tracks the execution of tasks and the artifacts produced,
+ * mapping them back to acceptance criteria for M7 conformance.
+ *
+ * Blueprint ref: 18.3.2 — "trace.artifact_to_task (em impl-log.md)".
+ */
+export type EvidenceKind = "code" | "test" | "config" | "doc" | "integration" | "e2e" | "contract" | "policy" | "human-review" | "deferred";
+export interface ImplArtifact {
+    path: string;
+    hash: string;
+    traces_acceptance: string[];
+    evidence_kind: EvidenceKind;
+    diff_ref?: string;
+    justification?: string;
+}
+export interface TaskExecution {
+    task_id: string;
+    status: "completed" | "failed" | "skipped";
+    completed_at: string;
+    artifacts: ImplArtifact[];
+}
+export interface ImplLogFrontmatter {
+    id: string;
+    slug: string;
+    executions: TaskExecution[];
+}
+export interface ImplLogFile {
+    data: ImplLogFrontmatter;
+    body: string;
+    raw: string;
+}
+/**
+ * Parse an impl-log.md file.
+ */
+export declare function parseImplLog(filePathOrContent: string): ImplLogFile;
+/**
+ * Append or update a task execution in the impl-log.md content.
+ */
+export declare function updateImplLogExecution(rawContent: string, execution: TaskExecution): string;
+export interface AcceptanceEvidence {
+    kind: EvidenceKind;
+    path: string;
+    task_id: string;
+    hash: string;
+    justification?: string;
+}
+/**
+ * Compute the projection of acceptance criteria to evidence.
+ * Maps each Ak to a list of artifacts/evidences covering it.
+ */
+export declare function computeAcceptanceCoverage(specAcceptanceIds: string[], taskToAcceptance: Record<string, string[]>, implLog: ImplLogFile): Record<string, AcceptanceEvidence[]>;
+/**
+ * Infer the evidence kind from a file path.
+ *
+ * Priority:
+ *   1. Test files (*.test.*, *.spec.*, /tests/, etc.) → "test"
+ *   2. Config files (*.yml, *.json, *.toml, etc.)    → "config"
+ *   3. Documentation (*.md, *.txt, *.adoc)           → "doc"
+ *   4. Everything else                                → "code"
+ */
+export declare function inferEvidenceKind(filePath: string): EvidenceKind;
+//# sourceMappingURL=impl-log.d.ts.map

package/dist/_core/dist/models/impl-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"impl-log.d.ts","sourceRoot":"","sources":["../../src/models/impl-log.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,MAAM,GACN,QAAQ,GACR,KAAK,GACL,aAAa,GACb,KAAK,GACL,UAAU,GACV,QAAQ,GACR,cAAc,GACd,UAAU,CAAC;AAEf,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,aAAa,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,YAAY,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,aAAa,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,kBAAkB,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,iBAAiB,EAAE,MAAM,GAAG,WAAW,CAYnE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,aAAa,GACvB,MAAM,CAgDR;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,iBAAiB,EAAE,MAAM,EAAE,EAC3B,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAC1C,OAAO,EAAE,WAAW,GACnB,MAAM,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC,CA+BtC;AAUD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAoBhE"}

package/dist/_core/dist/models/impl-log.js

@@ -0,0 +1,137 @@
+/**
+ * ImplLog Model — implementation log and M7 trace source.
+ *
+ * This file tracks the execution of tasks and the artifacts produced,
+ * mapping them back to acceptance criteria for M7 conformance.
+ *
+ * Blueprint ref: 18.3.2 — "trace.artifact_to_task (em impl-log.md)".
+ */
+import { parseFrontmatter } from "../frontmatter/index.js";
+/**
+ * Parse an impl-log.md file.
+ */
+export function parseImplLog(filePathOrContent) {
+    const { data, body, raw } = parseFrontmatter(filePathOrContent);
+    return {
+        data: {
+            id: data.id,
+            slug: data.slug,
+            executions: data.executions || [],
+        },
+        body,
+        raw,
+    };
+}
+/**
+ * Append or update a task execution in the impl-log.md content.
+ */
+export function updateImplLogExecution(rawContent, execution) {
+    const { data, body } = parseFrontmatter(rawContent);
+    const executions = data.executions || [];
+    const existingIdx = executions.findIndex(e => e.task_id === execution.task_id);
+    if (existingIdx >= 0) {
+        executions[existingIdx] = execution;
+    }
+    else {
+        executions.push(execution);
+    }
+    // Serialize back to YAML frontmatter
+    // Note: For simplicity in this core implementation, we assume a basic YAML serializer
+    // or we just reconstruct the string. Since we have a template system, we might use it.
+    // However, for a surgical update, we'll just return the new frontmatter + body.
+    const newFrontmatter = {
+        ...data,
+        executions,
+    };
+    const fmString = JSON.stringify(newFrontmatter, null, 2); // Fallback to JSON-like for now if YAML is complex
+    // Better: use a simple YAML-like reconstruction for the known fields
+    const yamlLines = [
+        "---",
+        `id: "${newFrontmatter.id}"`,
+        `slug: "${newFrontmatter.slug}"`,
+        "executions:",
+    ];
+    for (const exe of newFrontmatter.executions) {
+        yamlLines.push(`  - task_id: "${exe.task_id}"`);
+        yamlLines.push(`    status: "${exe.status}"`);
+        yamlLines.push(`    completed_at: "${exe.completed_at}"`);
+        yamlLines.push("    artifacts:");
+        for (const art of exe.artifacts) {
+            yamlLines.push(`      - path: "${art.path}"`);
+            yamlLines.push(`        hash: "${art.hash}"`);
+            yamlLines.push(`        evidence_kind: "${art.evidence_kind}"`);
+            yamlLines.push(`        traces_acceptance: ${JSON.stringify(art.traces_acceptance)}`);
+            if (art.diff_ref)
+                yamlLines.push(`        diff_ref: "${art.diff_ref}"`);
+            if (art.justification)
+                yamlLines.push(`        justification: "${art.justification}"`);
+        }
+    }
+    yamlLines.push("---");
+    return `${yamlLines.join("\n")}\n${body}`;
+}
+/**
+ * Compute the projection of acceptance criteria to evidence.
+ * Maps each Ak to a list of artifacts/evidences covering it.
+ */
+export function computeAcceptanceCoverage(specAcceptanceIds, taskToAcceptance, implLog) {
+    const coverage = {};
+    // Initialize
+    for (const aId of specAcceptanceIds) {
+        coverage[aId] = [];
+    }
+    // Trace from impl-log
+    for (const execution of implLog.data.executions) {
+        for (const artifact of execution.artifacts) {
+            // Use explicit traces if provided in artifact
+            const aIds = artifact.traces_acceptance.length > 0
+                ? artifact.traces_acceptance
+                : (taskToAcceptance[execution.task_id] || []);
+            for (const aId of aIds) {
+                if (coverage[aId]) {
+                    coverage[aId].push({
+                        kind: artifact.evidence_kind,
+                        path: artifact.path,
+                        task_id: execution.task_id,
+                        hash: artifact.hash,
+                        justification: artifact.justification,
+                    });
+                }
+            }
+        }
+    }
+    return coverage;
+}
+// ---------------------------------------------------------------------------
+// Evidence kind inference from file path (T6.1)
+// ---------------------------------------------------------------------------
+const TEST_PATTERNS = [".test.", ".spec.", "/tests/", "/specs/", "/__tests__/", "/__mocks__/"];
+const CONFIG_EXTENSIONS = [".yml", ".yaml", ".json", ".toml", ".env", ".rc", ".ini", ".config."];
+const DOC_EXTENSIONS = [".md", ".txt", ".adoc", ".rst", ".mdx"];
+/**
+ * Infer the evidence kind from a file path.
+ *
+ * Priority:
+ *   1. Test files (*.test.*, *.spec.*, /tests/, etc.) → "test"
+ *   2. Config files (*.yml, *.json, *.toml, etc.)    → "config"
+ *   3. Documentation (*.md, *.txt, *.adoc)           → "doc"
+ *   4. Everything else                                → "code"
+ */
+export function inferEvidenceKind(filePath) {
+    const lower = filePath.toLowerCase();
+    // 1. Test files (highest priority — a .test.json is a test, not config)
+    if (TEST_PATTERNS.some((p) => lower.includes(p))) {
+        return "test";
+    }
+    // 2. Config files
+    if (CONFIG_EXTENSIONS.some((ext) => lower.endsWith(ext) || lower.includes(ext))) {
+        return "config";
+    }
+    // 3. Documentation
+    if (DOC_EXTENSIONS.some((ext) => lower.endsWith(ext))) {
+        return "doc";
+    }
+    // 4. Default
+    return "code";
+}
+//# sourceMappingURL=impl-log.js.map

package/dist/_core/dist/models/impl-log.js.map

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

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

@@ -0,0 +1,8 @@
+export * from "./spec.js";
+export * from "./plan.js";
+export * from "./tasks.js";
+export * from "./clarify.js";
+export * from "./checklist.js";
+export * from "./analyze.js";
+export * from "./impl-log.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}

package/dist/_core/dist/models/index.js

@@ -0,0 +1,8 @@
+export * from "./spec.js";
+export * from "./plan.js";
+export * from "./tasks.js";
+export * from "./clarify.js";
+export * from "./checklist.js";
+export * from "./analyze.js";
+export * from "./impl-log.js";
+//# sourceMappingURL=index.js.map

package/dist/_core/dist/models/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}

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

@@ -0,0 +1,24 @@
+export type PlanStatus = "draft" | "approved" | "stale";
+export type PhaseMinusOneStatus = "pending" | "passed" | "justified" | "violated";
+export interface PlanFrontmatter {
+    id: string;
+    slug: string;
+    spec_hash: string;
+    spec_ref: string;
+    constitution_hash: string;
+    created: string;
+    status: PlanStatus;
+    phase_minus_one: PhaseMinusOneStatus;
+    approved_by: string | null;
+    approved_at: string | null;
+    audit_ref: string | null;
+}
+export interface Plan {
+    path: string;
+    raw: string;
+    hash: string;
+    data: PlanFrontmatter;
+    body: string;
+}
+export declare function parsePlan(path: string): Plan;
+//# sourceMappingURL=plan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/models/plan.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;AACxD,MAAM,MAAM,mBAAmB,GAC3B,SAAS,GACT,QAAQ,GACR,WAAW,GACX,UAAU,CAAC;AAEf,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,CAAC;IACnB,eAAe,EAAE,mBAAmB,CAAC;IACrC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAU5C"}

package/dist/_core/dist/models/plan.js

@@ -0,0 +1,15 @@
+import { readFileSync } from "node:fs";
+import { parseFrontmatter } from "../frontmatter/index.js";
+import { hashString } from "../audit/hash.js";
+export function parsePlan(path) {
+    const raw = readFileSync(path, "utf8");
+    const { data, body } = parseFrontmatter(raw);
+    return {
+        path,
+        raw,
+        hash: hashString(raw),
+        data,
+        body,
+    };
+}
+//# sourceMappingURL=plan.js.map

package/dist/_core/dist/models/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/models/plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AA+B9C,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACvC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAkB,GAAG,CAAC,CAAC;IAC9D,OAAO;QACL,IAAI;QACJ,GAAG;QACH,IAAI,EAAE,UAAU,CAAC,GAAG,CAAC;QACrB,IAAI;QACJ,IAAI;KACL,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,23 @@
+export type SpecStatus = "draft" | "approved" | "stale";
+export interface SpecFrontmatter {
+    id: string;
+    slug: string;
+    platform: string;
+    jira?: string;
+    created: string;
+    status: SpecStatus;
+    audit_ref: string | null;
+    acceptance?: {
+        ids: string[];
+    };
+}
+export interface Spec {
+    path: string;
+    raw: string;
+    hash: string;
+    data: SpecFrontmatter;
+    body: string;
+    clarifications: string[];
+}
+export declare function parseSpec(path: string): Spec;
+//# sourceMappingURL=spec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../src/models/spec.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;AAExD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,CAAC,EAAE;QACX,GAAG,EAAE,MAAM,EAAE,CAAC;KACf,CAAC;CACH;AAED,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAkB5C"}

package/dist/_core/dist/models/spec.js

@@ -0,0 +1,22 @@
+import { readFileSync } from "node:fs";
+import { parseFrontmatter } from "../frontmatter/index.js";
+import { hashString } from "../audit/hash.js";
+import { detectClarificationMarkers } from "./clarify.js";
+export function parseSpec(path) {
+    const raw = readFileSync(path, "utf8");
+    const { data, body } = parseFrontmatter(raw);
+    // Detect unresolved markers via the shared detector, which strips HTML
+    // comments before scanning. Running the raw regex over `raw` (C1) wrongly
+    // counted markers inside template instruction blocks (`<!-- ... -->`),
+    // making gate.spec.clarifications a false positive on every spec.
+    const clarifications = detectClarificationMarkers(body).map((marker) => marker.label ?? "");
+    return {
+        path,
+        raw,
+        hash: hashString(raw),
+        data,
+        body,
+        clarifications,
+    };
+}
+//# sourceMappingURL=spec.js.map

package/dist/_core/dist/models/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../src/models/spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AA0B1D,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACvC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAkB,GAAG,CAAC,CAAC;IAC9D,uEAAuE;IACvE,0EAA0E;IAC1E,uEAAuE;IACvE,kEAAkE;IAClE,MAAM,cAAc,GAAG,0BAA0B,CAAC,IAAI,CAAC,CAAC,GAAG,CACzD,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAC/B,CAAC;IACF,OAAO;QACL,IAAI;QACJ,GAAG;QACH,IAAI,EAAE,UAAU,CAAC,GAAG,CAAC;QACrB,IAAI;QACJ,IAAI;QACJ,cAAc;KACf,CAAC;AACJ,CAAC"}