raptor-aios 0.1.0

package/dist/_core/dist/audit/logger.js

@@ -0,0 +1,93 @@
+import { appendFileSync, existsSync, readFileSync, writeFileSync, } from "node:fs";
+import { randomBytes } from "node:crypto";
+import { hashString } from "./hash.js";
+export const AUDIT_SCHEMA_V1 = "raptor.audit.v1";
+const C5_ALWAYS_HUMAN = new Set([
+    "plan.approved",
+    "constitution.upgraded",
+    "constitution.repaired",
+    "amendment",
+    "hotfix.invoked",
+    "hotfix.reconciled",
+]);
+export class C5ViolationError extends Error {
+    constructor(event, via) {
+        super(`C5 violation: event "${event}" requires actor.via="human" (got "${via}"). ` +
+            `Critical gates cannot be approved by AI agents.`);
+        this.name = "C5ViolationError";
+    }
+}
+function assertC5(event) {
+    const isCritical = C5_ALWAYS_HUMAN.has(event.event) ||
+        (event.event === "gate.approved" && event.gate?.level === "critical");
+    if (isCritical && event.actor.via !== "human") {
+        throw new C5ViolationError(event.event, event.actor.via);
+    }
+}
+export function uuidv7() {
+    const ms = BigInt(Date.now());
+    const buf = randomBytes(16);
+    buf[0] = Number((ms >> 40n) & 0xffn);
+    buf[1] = Number((ms >> 32n) & 0xffn);
+    buf[2] = Number((ms >> 24n) & 0xffn);
+    buf[3] = Number((ms >> 16n) & 0xffn);
+    buf[4] = Number((ms >> 8n) & 0xffn);
+    buf[5] = Number(ms & 0xffn);
+    buf[6] = (buf[6] & 0x0f) | 0x70;
+    buf[8] = (buf[8] & 0x3f) | 0x80;
+    const hex = buf.toString("hex");
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20, 32)}`;
+}
+export function nextSequence(jsonlPath) {
+    if (!existsSync(jsonlPath))
+        return 1;
+    const content = readFileSync(jsonlPath, "utf8");
+    const trimmed = content.trimEnd();
+    if (trimmed.length === 0)
+        return 1;
+    const lines = trimmed.split("\n");
+    const last = lines[lines.length - 1];
+    try {
+        const parsed = JSON.parse(last);
+        if (typeof parsed.sequence === "number" && parsed.sequence >= 1) {
+            return parsed.sequence + 1;
+        }
+    }
+    catch {
+        // fall through to line-count fallback
+    }
+    return lines.length + 1;
+}
+function stableStringify(obj) {
+    if (obj === null || typeof obj !== "object")
+        return JSON.stringify(obj);
+    if (Array.isArray(obj))
+        return "[" + obj.map(stableStringify).join(",") + "]";
+    const keys = Object.keys(obj).sort();
+    const parts = keys.map((k) => JSON.stringify(k) +
+        ":" +
+        stableStringify(obj[k]));
+    return "{" + parts.join(",") + "}";
+}
+export function appendAuditEvent(jsonlPath, event) {
+    const { schema, id, sequence, ts, ...rest } = event;
+    const full = {
+        schema: schema ?? AUDIT_SCHEMA_V1,
+        id: id ?? uuidv7(),
+        sequence: sequence ?? nextSequence(jsonlPath),
+        ts: ts ?? new Date().toISOString(),
+        ...rest,
+    };
+    assertC5(full);
+    if (!existsSync(jsonlPath))
+        writeFileSync(jsonlPath, "");
+    appendFileSync(jsonlPath, stableStringify(full) + "\n", "utf8");
+    return full;
+}
+export function hashPrompt(promptText) {
+    return { hash: hashString(promptText), tokens: estimateTokens(promptText) };
+}
+function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+//# sourceMappingURL=logger.js.map

package/dist/_core/dist/audit/logger.js.map

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

package/dist/_core/dist/audit/query.d.ts

@@ -0,0 +1,13 @@
+import type { AuditEvent, AuditEventType } from "./logger.js";
+export interface AuditQuery {
+    event?: AuditEventType | AuditEventType[];
+    article?: string;
+    gateLevel?: "critical" | "required" | "advisory";
+    gateId?: string;
+    taskId?: string;
+    actorVia?: AuditEvent["actor"]["via"];
+    since?: string;
+}
+export declare function readAuditEvents(jsonlPath: string): AuditEvent[];
+export declare function queryAudit(events: AuditEvent[], q: AuditQuery): AuditEvent[];
+//# sourceMappingURL=query.d.ts.map

package/dist/_core/dist/audit/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/audit/query.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE9D,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,cAAc,GAAG,cAAc,EAAE,CAAC;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAsBD,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,EAAE,CAQ/D;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE,UAAU,EAAE,EACpB,CAAC,EAAE,UAAU,GACZ,UAAU,EAAE,CAiBd"}

package/dist/_core/dist/audit/query.js

@@ -0,0 +1,57 @@
+import { existsSync, readFileSync } from "node:fs";
+function parseSince(spec) {
+    const m = spec.match(/^(\d+)([smhdw])$/);
+    if (m) {
+        const n = parseInt(m[1], 10);
+        const mult = {
+            s: 1000,
+            m: 60_000,
+            h: 3_600_000,
+            d: 86_400_000,
+            w: 7 * 86_400_000,
+        };
+        return new Date(Date.now() - n * mult[m[2]]);
+    }
+    const d = new Date(spec);
+    if (Number.isNaN(d.getTime())) {
+        throw new Error(`invalid --since value: ${spec} (use 30d, 12h, or ISO date)`);
+    }
+    return d;
+}
+export function readAuditEvents(jsonlPath) {
+    if (!existsSync(jsonlPath))
+        return [];
+    const content = readFileSync(jsonlPath, "utf8").trimEnd();
+    if (content.length === 0)
+        return [];
+    return content
+        .split("\n")
+        .filter((l) => l.length > 0)
+        .map((l) => JSON.parse(l));
+}
+export function queryAudit(events, q) {
+    const eventSet = q.event
+        ? new Set(Array.isArray(q.event) ? q.event : [q.event])
+        : null;
+    const sinceDate = q.since ? parseSince(q.since) : null;
+    return events.filter((e) => {
+        if (eventSet && !eventSet.has(e.event))
+            return false;
+        if (q.article && e.article !== q.article)
+            return false;
+        if (q.actorVia && e.actor.via !== q.actorVia)
+            return false;
+        const gate = e.gate;
+        if (q.gateLevel && gate?.level !== q.gateLevel)
+            return false;
+        if (q.gateId && gate?.id !== q.gateId)
+            return false;
+        const task = e.task;
+        if (q.taskId && task?.id !== q.taskId)
+            return false;
+        if (sinceDate && new Date(e.ts) < sinceDate)
+            return false;
+        return true;
+    });
+}
+//# sourceMappingURL=query.js.map

package/dist/_core/dist/audit/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/audit/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAanD,SAAS,UAAU,CAAC,IAAY;IAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACzC,IAAI,CAAC,EAAE,CAAC;QACN,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;QAC9B,MAAM,IAAI,GAA2B;YACnC,CAAC,EAAE,IAAI;YACP,CAAC,EAAE,MAAM;YACT,CAAC,EAAE,SAAS;YACZ,CAAC,EAAE,UAAU;YACb,CAAC,EAAE,CAAC,GAAG,UAAU;SAClB,CAAC;QACF,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAE,CAAE,CAAC,CAAC;IACjD,CAAC;IACD,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,8BAA8B,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,EAAE,CAAC;IACtC,MAAM,OAAO,GAAG,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;IAC1D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,OAAO,OAAO;SACX,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;SAC3B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAe,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,MAAoB,EACpB,CAAa;IAEb,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK;QACtB,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACvD,CAAC,CAAC,IAAI,CAAC;IACT,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACvD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACzB,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACrD,IAAI,CAAC,CAAC,OAAO,IAAK,CAA0B,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QACjF,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC3D,MAAM,IAAI,GAAI,CAAgD,CAAC,IAAI,CAAC;QACpE,IAAI,CAAC,CAAC,SAAS,IAAI,IAAI,EAAE,KAAK,KAAK,CAAC,CAAC,SAAS;YAAE,OAAO,KAAK,CAAC;QAC7D,IAAI,CAAC,CAAC,MAAM,IAAI,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QACpD,MAAM,IAAI,GAAI,CAAgC,CAAC,IAAI,CAAC;QACpD,IAAI,CAAC,CAAC,MAAM,IAAI,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QACpD,IAAI,SAAS,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS;YAAE,OAAO,KAAK,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/_core/dist/audit/schema.d.ts

@@ -0,0 +1,455 @@
+export declare const AUDIT_SCHEMA_ID = "raptor.audit.v1";
+export declare const AUDIT_SCHEMA_VERSION = "1.0.0";
+export declare const auditEventSchema: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $id: "https://raptor.dev/schemas/audit-event/1.0.0.json";
+    readonly title: "Raptor Audit Event";
+    readonly description: "One entry of .raptor/specs/<NNN-slug>/audit.jsonl. See blueprint/13-schema-audit-jsonl.md.";
+    readonly type: "object";
+    readonly required: readonly ["schema", "sequence", "ts", "event", "actor"];
+    readonly properties: {
+        readonly schema: {
+            readonly const: "raptor.audit.v1";
+            readonly description: "Schema discriminator and version. Must equal 'raptor.audit.v1' for this version.";
+        };
+        readonly id: {
+            readonly type: "string";
+            readonly format: "uuid";
+            readonly description: "UUIDv7 unique within the feature. Optional but recommended for cross-references.";
+        };
+        readonly sequence: {
+            readonly type: "integer";
+            readonly minimum: 1;
+            readonly description: "Strictly monotonic per-feature counter starting at 1.";
+        };
+        readonly ts: {
+            readonly type: "string";
+            readonly format: "date-time";
+            readonly description: "ISO 8601 with timezone, millisecond precision recommended.";
+        };
+        readonly event: {
+            readonly type: "string";
+            readonly enum: readonly ["feature.created", "feature.archived", "spec.generated", "spec.updated", "clarify.added", "clarify.scanned", "clarify.applied", "plan.generated", "plan.stale", "tasks.generated", "tasks.approved", "code.generated", "analyze.executed", "analysis.generated", "review.executed", "checklist.generated", "checklist.created", "task.completed", "gate.evaluated", "gate.skipped", "gate.approved", "plan.approved", "phase.transition", "artifact.created", "artifact.resynced", "violation", "constitution.initialized", "constitution.upgraded", "constitution.repaired", "amendment", "hotfix.invoked", "hotfix.reconciled"];
+        };
+        readonly feature: {
+            readonly type: "string";
+            readonly pattern: "^[0-9]{3,}-[a-z0-9-]+$";
+            readonly description: "NNN-slug of the feature. Must match the directory name.";
+        };
+        readonly actor: {
+            readonly $ref: "#/$defs/Actor";
+        };
+        readonly agent: {
+            readonly $ref: "#/$defs/Agent";
+        };
+        readonly command: {
+            readonly type: "string";
+            readonly description: "CLI command that triggered the entry, e.g. 'raptor specify'.";
+        };
+        readonly prompt: {
+            readonly $ref: "#/$defs/Prompt";
+        };
+        readonly inputs: {
+            readonly type: "array";
+            readonly items: {
+                readonly $ref: "#/$defs/ArtifactRef";
+            };
+        };
+        readonly outputs: {
+            readonly type: "array";
+            readonly items: {
+                readonly $ref: "#/$defs/ArtifactRef";
+            };
+        };
+        readonly gate: {
+            readonly $ref: "#/$defs/GateRef";
+        };
+        readonly task: {
+            readonly $ref: "#/$defs/TaskRef";
+        };
+        readonly article: {
+            readonly type: "string";
+            readonly pattern: "^[CPM][0-9]+$";
+            readonly description: "Constitutional article reference: C1-C5 (core), P* (project), M* (mobile preset).";
+        };
+        readonly severity: {
+            readonly type: "string";
+            readonly enum: readonly ["block", "warn", "info"];
+        };
+        readonly detector: {
+            readonly type: "string";
+        };
+        readonly justification: {
+            readonly type: "string";
+            readonly minLength: 20;
+        };
+        readonly reason: {
+            readonly type: readonly ["string", "null"];
+        };
+        readonly slug: {
+            readonly type: "string";
+        };
+        readonly branch: {
+            readonly type: "string";
+        };
+        readonly details: {
+            readonly type: "object";
+        };
+        readonly meta: {
+            readonly type: "object";
+        };
+        readonly clarifications: {
+            readonly type: "object";
+            readonly properties: {
+                readonly count: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                };
+            };
+        };
+        readonly tasks: {
+            readonly type: "object";
+            readonly properties: {
+                readonly total: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                };
+            };
+        };
+        readonly items: {
+            readonly type: "object";
+            readonly properties: {
+                readonly count: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                };
+            };
+        };
+        readonly findings: {
+            readonly type: "object";
+            readonly properties: {
+                readonly count: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                };
+            };
+        };
+    };
+    readonly additionalProperties: false;
+    readonly allOf: readonly [{
+        readonly if: {
+            readonly properties: {
+                readonly event: {
+                    readonly const: "feature.created";
+                };
+            };
+        };
+        readonly then: {
+            readonly required: readonly ["slug"];
+        };
+    }, {
+        readonly if: {
+            readonly properties: {
+                readonly event: {
+                    readonly enum: readonly ["spec.generated", "clarify.added", "plan.generated", "tasks.generated", "code.generated", "analyze.executed", "review.executed", "checklist.generated"];
+                };
+            };
+        };
+        readonly then: {
+            readonly required: readonly ["agent", "prompt"];
+        };
+    }, {
+        readonly if: {
+            readonly properties: {
+                readonly event: {
+                    readonly enum: readonly ["plan.generated", "tasks.generated"];
+                };
+            };
+        };
+        readonly then: {
+            readonly required: readonly ["inputs", "outputs"];
+        };
+    }, {
+        readonly if: {
+            readonly properties: {
+                readonly event: {
+                    readonly const: "code.generated";
+                };
+            };
+        };
+        readonly then: {
+            readonly required: readonly ["outputs", "task"];
+        };
+    }, {
+        readonly if: {
+            readonly properties: {
+                readonly event: {
+                    readonly enum: readonly ["gate.evaluated", "gate.skipped", "gate.approved"];
+                };
+            };
+        };
+        readonly then: {
+            readonly required: readonly ["gate"];
+        };
+    }, {
+        readonly if: {
+            readonly properties: {
+                readonly event: {
+                    readonly const: "gate.skipped";
+                };
+            };
+        };
+        readonly then: {
+            readonly required: readonly ["justification"];
+            readonly properties: {
+                readonly gate: {
+                    readonly properties: {
+                        readonly level: {
+                            readonly not: {
+                                readonly const: "critical";
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    }, {
+        readonly if: {
+            readonly properties: {
+                readonly event: {
+                    readonly const: "gate.approved";
+                };
+                readonly gate: {
+                    readonly properties: {
+                        readonly level: {
+                            readonly const: "critical";
+                        };
+                    };
+                };
+            };
+        };
+        readonly then: {
+            readonly properties: {
+                readonly actor: {
+                    readonly properties: {
+                        readonly via: {
+                            readonly const: "human";
+                        };
+                    };
+                };
+            };
+        };
+    }, {
+        readonly if: {
+            readonly properties: {
+                readonly event: {
+                    readonly const: "plan.approved";
+                };
+            };
+        };
+        readonly then: {
+            readonly required: readonly ["inputs"];
+            readonly properties: {
+                readonly actor: {
+                    readonly properties: {
+                        readonly via: {
+                            readonly const: "human";
+                        };
+                    };
+                };
+            };
+        };
+    }, {
+        readonly if: {
+            readonly properties: {
+                readonly event: {
+                    readonly const: "violation";
+                };
+            };
+        };
+        readonly then: {
+            readonly required: readonly ["article", "severity", "detector"];
+        };
+    }, {
+        readonly if: {
+            readonly properties: {
+                readonly event: {
+                    readonly const: "hotfix.invoked";
+                };
+            };
+        };
+        readonly then: {
+            readonly required: readonly ["slug", "article", "severity", "justification", "inputs", "outputs"];
+            readonly properties: {
+                readonly actor: {
+                    readonly properties: {
+                        readonly via: {
+                            readonly const: "human";
+                        };
+                    };
+                };
+            };
+        };
+    }, {
+        readonly if: {
+            readonly properties: {
+                readonly event: {
+                    readonly const: "hotfix.reconciled";
+                };
+            };
+        };
+        readonly then: {
+            readonly required: readonly ["slug", "inputs"];
+            readonly properties: {
+                readonly actor: {
+                    readonly properties: {
+                        readonly via: {
+                            readonly const: "human";
+                        };
+                    };
+                };
+            };
+        };
+    }];
+    readonly $defs: {
+        readonly Hash: {
+            readonly type: "string";
+            readonly pattern: "^sha256:[a-f0-9]{64}$";
+        };
+        readonly Actor: {
+            readonly type: "object";
+            readonly required: readonly ["via"];
+            readonly properties: {
+                readonly via: {
+                    readonly type: "string";
+                    readonly enum: readonly ["human", "agent", "ci", "system"];
+                };
+                readonly user: {
+                    readonly type: "string";
+                    readonly description: "Identity (e.g., git email) when via=human.";
+                };
+                readonly session: {
+                    readonly type: "string";
+                    readonly description: "CLI session id, optional.";
+                };
+            };
+            readonly additionalProperties: false;
+        };
+        readonly Agent: {
+            readonly type: "object";
+            readonly required: readonly ["key"];
+            readonly properties: {
+                readonly key: {
+                    readonly type: "string";
+                    readonly description: "Integration key, e.g. 'claude', 'cursor', 'antigravity'.";
+                };
+                readonly model: {
+                    readonly type: "string";
+                    readonly description: "Specific model id, e.g. 'claude-opus-4-7'.";
+                };
+                readonly version: {
+                    readonly type: "string";
+                    readonly description: "Agent runtime version, when available.";
+                };
+            };
+            readonly additionalProperties: false;
+        };
+        readonly Prompt: {
+            readonly type: "object";
+            readonly required: readonly ["hash"];
+            readonly properties: {
+                readonly hash: {
+                    readonly $ref: "#/$defs/Hash";
+                    readonly description: "SHA-256 of the final rendered prompt sent to the agent.";
+                };
+                readonly tokens: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                };
+                readonly template: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly id: {
+                            readonly type: "string";
+                            readonly description: "Template id, e.g. 'spec-template'.";
+                        };
+                        readonly version: {
+                            readonly type: "string";
+                        };
+                        readonly hash: {
+                            readonly $ref: "#/$defs/Hash";
+                        };
+                    };
+                    readonly additionalProperties: false;
+                };
+            };
+            readonly additionalProperties: false;
+        };
+        readonly ArtifactRef: {
+            readonly type: "object";
+            readonly required: readonly ["path", "hash"];
+            readonly properties: {
+                readonly path: {
+                    readonly type: "string";
+                    readonly description: "Repo-relative path, POSIX-style.";
+                };
+                readonly hash: {
+                    readonly $ref: "#/$defs/Hash";
+                };
+                readonly role: {
+                    readonly type: "string";
+                    readonly enum: readonly ["spec", "plan", "tasks", "constitution", "checklist", "code", "test", "config", "doc", "other"];
+                };
+                readonly bytes: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                };
+            };
+            readonly additionalProperties: false;
+        };
+        readonly GateRef: {
+            readonly type: "object";
+            readonly required: readonly ["id", "level"];
+            readonly properties: {
+                readonly id: {
+                    readonly type: "string";
+                    readonly description: "Canonical gate id, e.g. 'gate.plan.approved'.";
+                };
+                readonly level: {
+                    readonly type: "string";
+                    readonly enum: readonly ["critical", "required", "advisory"];
+                };
+                readonly outcome: {
+                    readonly type: "string";
+                    readonly enum: readonly ["passed", "failed", "warning"];
+                };
+                readonly article: {
+                    readonly type: "string";
+                    readonly pattern: "^[CPM][0-9]+$";
+                };
+            };
+            readonly additionalProperties: false;
+        };
+        readonly TaskRef: {
+            readonly type: "object";
+            readonly required: readonly ["id"];
+            readonly properties: {
+                readonly id: {
+                    readonly type: "string";
+                    readonly description: "Task id from tasks.md, e.g. 'T042'.";
+                };
+                readonly story: {
+                    readonly type: "string";
+                    readonly description: "User story label, e.g. 'US1'.";
+                };
+                readonly parallel: {
+                    readonly type: "boolean";
+                    readonly description: "True if marked [P].";
+                };
+            };
+            readonly additionalProperties: false;
+        };
+    };
+};
+export declare function getAuditEventSchema(): unknown;
+//# sourceMappingURL=schema.d.ts.map

package/dist/_core/dist/audit/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/audit/schema.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,oBAAoB,CAAC;AACjD,eAAO,MAAM,oBAAoB,UAAU,CAAC;AAE5C,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqVnB,CAAC;AAEX,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C"}