raptor-aios 0.1.0

package/dist/commands/approve.js

@@ -0,0 +1,116 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { basename, join } from 'node:path';
+import { appendAuditEvent, hashString, updateFrontmatter } from '../_core/dist/index.js';
+import { currentActor, featureDir, requireProjectRoot } from '../shared/project.js';
+import { runAfterHook, runBeforeHook } from '../shared/hooks.js';
+const ARTIFACTS = ['spec', 'plan', 'tasks'];
+export default class Approve extends Command {
+    static description = 'Mark a feature artifact as approved (spec, plan, or tasks). Required by C3 before tasks/implement.';
+    static examples = [
+        '<%= config.bin %> approve login-biometrico --artifact=spec',
+        '<%= config.bin %> approve login-biometrico --artifact=plan --phase-minus-one=passed',
+        '<%= config.bin %> approve login-biometrico --artifact=tasks',
+    ];
+    static args = {
+        feature: Args.string({
+            description: 'Feature slug or NNN-slug',
+            required: true,
+        }),
+    };
+    static flags = {
+        artifact: Flags.string({
+            description: 'Which artifact to approve',
+            options: [...ARTIFACTS],
+            required: true,
+        }),
+        'phase-minus-one': Flags.string({
+            description: '(plan only) Phase -1 outcome: passed | justified | violated',
+            options: ['passed', 'justified', 'violated'],
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Approve);
+        const root = requireProjectRoot();
+        const dir = featureDir(root, args.feature);
+        const featureName = basename(dir);
+        const artifact = flags.artifact;
+        const path = join(dir, `${artifact}.md`);
+        if (!existsSync(path))
+            this.error(`${artifact}.md missing at ${path}`);
+        const actor = currentActor('human');
+        runBeforeHook(this, {
+            event: 'before_approve',
+            command: `raptor approve ${args.feature} --artifact=${artifact}`,
+            projectRoot: root,
+            feature: featureName,
+            featureDir: dir,
+            actor: { user: actor.email ?? actor.user, via: actor.via },
+            extra: { artifact, ...(flags['phase-minus-one'] ? { phase_minus_one: flags['phase-minus-one'] } : {}) },
+        });
+        if (artifact === 'plan' && !actor.email) {
+            this.error('C5 violation: plan approval is a critical gate and requires an identifiable human approver. ' +
+                'No git user.email detected — set `git config user.email` before approving plans.');
+        }
+        if ((artifact === 'spec' || artifact === 'tasks') && !actor.email) {
+            this.warn(`No git user.email detected. ${artifact} approval is non-critical but identifiable approvers are recommended.`);
+        }
+        const raw = readFileSync(path, 'utf8');
+        const now = new Date().toISOString();
+        let patch = { status: 'approved' };
+        if (artifact === 'plan') {
+            const pmone = flags['phase-minus-one'];
+            if (!pmone) {
+                this.error(`--phase-minus-one is required when approving a plan (passed | justified | violated)`);
+            }
+            if (pmone === 'violated') {
+                this.error(`Refusing to approve plan with phase_minus_one=violated. A critical gate violation requires a framework amendment (C4), not an approval.`);
+            }
+            patch = {
+                ...patch,
+                phase_minus_one: pmone,
+                approved_by: actor.email ?? actor.user,
+                approved_at: now,
+            };
+        }
+        const updated = updateFrontmatter(raw, patch);
+        writeFileSync(path, updated);
+        const auditPath = join(dir, 'audit.jsonl');
+        const event = artifact === 'plan'
+            ? 'plan.approved'
+            : artifact === 'tasks'
+                ? 'tasks.approved'
+                : 'spec.updated';
+        appendAuditEvent(auditPath, {
+            event,
+            feature: featureName,
+            command: `raptor approve --artifact=${artifact}`,
+            actor: { user: actor.email ?? actor.user, via: 'human' },
+            inputs: [{ path: `specs/${featureName}/${artifact}.md`, hash: hashString(raw) }],
+            outputs: [{ path: `specs/${featureName}/${artifact}.md`, hash: hashString(updated) }],
+            meta: artifact === 'plan'
+                ? { phase_minus_one: flags['phase-minus-one'] }
+                : { status: 'approved' },
+        });
+        this.log(`✓ Approved ${artifact}.md for ${featureName}`);
+        this.log(`  Approver: ${actor.email ?? actor.user}`);
+        if (artifact === 'plan') {
+            this.log(`  Phase -1: ${flags['phase-minus-one']}`);
+        }
+        runAfterHook(this, {
+            event: 'after_approve',
+            command: `raptor approve ${args.feature} --artifact=${artifact}`,
+            projectRoot: root,
+            feature: featureName,
+            featureDir: dir,
+            actor: { user: actor.email ?? actor.user, via: actor.via },
+            extra: { artifact, ...(flags['phase-minus-one'] ? { phase_minus_one: flags['phase-minus-one'] } : {}) },
+        });
+        if (artifact === 'plan') {
+            this.log('');
+            this.log('Next steps:');
+            this.log(`  1. Run 'raptor tasks ${args.feature}' to generate tasks.md`);
+        }
+    }
+}
+//# sourceMappingURL=approve.js.map

package/dist/commands/approve.js.map

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

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

@@ -0,0 +1,23 @@
+import { Command } from "@oclif/core";
+export default class AuditQueryCmd extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        feature: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        all: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        event: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        article: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "gate-level": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "gate-id": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        task: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "actor-via": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        since: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private allFeatureDirs;
+    private format;
+}
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/commands/audit/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,OAAO,EAAS,MAAM,aAAa,CAAC;AAWnD,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,OAAO;IAChD,OAAgB,WAAW,SAEiB;IAE5C,OAAgB,QAAQ,WAKtB;IAEF,OAAgB,IAAI;;MAKlB;IAEF,OAAgB,KAAK;;;;;;;;;;MA2BnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IA0C1B,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,MAAM;CAef"}

package/dist/commands/audit/query.js

@@ -0,0 +1,118 @@
+import { Args, Command, Flags } from "@oclif/core";
+import { existsSync, readdirSync } from "node:fs";
+import { basename, join } from "node:path";
+import { queryAudit, readAuditEvents, } from "../../_core/dist/index.js";
+import { featureDir, requireProjectRoot } from "../../shared/project.js";
+export default class AuditQueryCmd extends Command {
+    static description = "Query audit.jsonl entries with filters (event/article/gate-level/task/since). " +
+        "Use --all to query across all features.";
+    static examples = [
+        "<%= config.bin %> audit query 001-foo --event plan.approved",
+        "<%= config.bin %> audit query 001-foo --event gate.evaluated --gate-level critical",
+        "<%= config.bin %> audit query 001-foo --event code.generated --task T003",
+        "<%= config.bin %> audit query --all --event violation --article C2 --since 30d",
+    ];
+    static args = {
+        feature: Args.string({
+            description: "Feature slug or NNN-slug (omit and use --all for cross-feature)",
+            required: false,
+        }),
+    };
+    static flags = {
+        all: Flags.boolean({
+            description: "Query across all features (requires no feature arg)",
+        }),
+        event: Flags.string({
+            description: "Filter by event type (comma-separated for multiple)",
+            multiple: false,
+        }),
+        article: Flags.string({
+            description: "Filter by constitutional article (e.g. C2, P1, M3)",
+        }),
+        "gate-level": Flags.string({
+            description: "Filter by gate.level",
+            options: ["critical", "required", "advisory"],
+        }),
+        "gate-id": Flags.string({ description: "Filter by gate.id" }),
+        task: Flags.string({ description: "Filter by task.id (e.g. T003)" }),
+        "actor-via": Flags.string({
+            description: "Filter by actor.via",
+            options: ["human", "agent", "ci", "system"],
+        }),
+        since: Flags.string({
+            description: "Only entries since (e.g. 30d, 12h, 2026-04-01)",
+        }),
+        json: Flags.boolean({
+            description: "Output raw JSON lines instead of pretty format",
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(AuditQueryCmd);
+        const root = requireProjectRoot();
+        if (flags.all && args.feature) {
+            this.error("--all is incompatible with a feature argument");
+        }
+        if (!flags.all && !args.feature) {
+            this.error("provide a feature slug or use --all");
+        }
+        const dirs = flags.all
+            ? this.allFeatureDirs(root)
+            : [featureDir(root, args.feature)];
+        const q = {
+            event: flags.event
+                ? flags.event.split(",").map((s) => s.trim())
+                : undefined,
+            article: flags.article,
+            gateLevel: flags["gate-level"],
+            gateId: flags["gate-id"],
+            taskId: flags.task,
+            actorVia: flags["actor-via"],
+            since: flags.since,
+        };
+        let total = 0;
+        for (const dir of dirs) {
+            const events = readAuditEvents(join(dir, "audit.jsonl"));
+            const matches = queryAudit(events, q);
+            if (matches.length === 0)
+                continue;
+            if (!flags.json)
+                this.log(`# ${basename(dir)} — ${matches.length} match(es)`);
+            for (const e of matches) {
+                if (flags.json)
+                    this.log(JSON.stringify(e));
+                else
+                    this.log(this.format(e));
+            }
+            total += matches.length;
+        }
+        if (total === 0)
+            this.log("(no matches)");
+    }
+    allFeatureDirs(root) {
+        const specsDir = join(root, ".raptor", "specs");
+        if (!existsSync(specsDir))
+            return [];
+        return readdirSync(specsDir)
+            .filter((d) => /^\d{3,}-/.test(d))
+            .map((d) => join(specsDir, d));
+    }
+    format(e) {
+        const parts = [
+            `[${e.sequence}]`,
+            e.ts,
+            e.event.padEnd(22),
+            `${e.actor.via}:${e.actor.user}`,
+        ];
+        const gate = e.gate;
+        if (gate?.id)
+            parts.push(`gate=${gate.id}/${gate.level}`);
+        const task = e.task;
+        if (task?.id)
+            parts.push(`task=${task.id}`);
+        const article = e.article;
+        if (article)
+            parts.push(`article=${article}`);
+        return "  " + parts.join("  ");
+    }
+}
+//# sourceMappingURL=query.js.map

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

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

package/dist/commands/audit/show.d.ts

@@ -0,0 +1,17 @@
+import { Command } from "@oclif/core";
+export default class AuditShow extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        feature: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        id: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        sequence: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        event: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        latest: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "include-prompt": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=show.d.ts.map

package/dist/commands/audit/show.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.d.ts","sourceRoot":"","sources":["../../../src/commands/audit/show.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,OAAO,EAAS,MAAM,aAAa,CAAC;AAUnD,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,OAAO;IAC5C,OAAgB,WAAW,SACmE;IAE9F,OAAgB,QAAQ,WAItB;IAEF,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;;;;;MAQnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA8B3B"}

package/dist/commands/audit/show.js

@@ -0,0 +1,53 @@
+import { Args, Command, Flags } from "@oclif/core";
+import { join } from "node:path";
+import { queryAudit, readAuditEvents, } from "../../_core/dist/index.js";
+import { featureDir, requireProjectRoot } from "../../shared/project.js";
+export default class AuditShow extends Command {
+    static description = "Show a single audit entry — by --id, by --sequence, or --latest matching --event/filters.";
+    static examples = [
+        "<%= config.bin %> audit show 001-foo --id 0190abc-...",
+        "<%= config.bin %> audit show 001-foo --sequence 5",
+        "<%= config.bin %> audit show 001-foo --event plan.generated --latest",
+    ];
+    static args = {
+        feature: Args.string({ description: "Feature slug or NNN-slug", required: true }),
+    };
+    static flags = {
+        id: Flags.string({ description: "Match by event id (UUIDv7)" }),
+        sequence: Flags.integer({ description: "Match by sequence number" }),
+        event: Flags.string({ description: "Filter by event type (used with --latest)" }),
+        latest: Flags.boolean({ description: "Pick the most recent matching entry" }),
+        "include-prompt": Flags.boolean({
+            description: "Include full prompt text (currently warns: prompt storage is P13.1 pending)",
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(AuditShow);
+        const root = requireProjectRoot();
+        const dir = featureDir(root, args.feature);
+        const events = readAuditEvents(join(dir, "audit.jsonl"));
+        let match;
+        if (flags.id)
+            match = events.find((e) => e.id === flags.id);
+        else if (flags.sequence != null)
+            match = events.find((e) => e.sequence === flags.sequence);
+        else if (flags.latest) {
+            const q = flags.event
+                ? { event: flags.event }
+                : {};
+            const matches = queryAudit(events, q);
+            match = matches[matches.length - 1];
+        }
+        else {
+            this.error("provide --id, --sequence, or --latest (optionally with --event)");
+        }
+        if (!match) {
+            this.error("no matching entry found");
+        }
+        if (flags["include-prompt"]) {
+            this.warn("--include-prompt is partial: full prompt text storage is P13.1 (pending). Showing prompt hash only.");
+        }
+        this.log(JSON.stringify(match, null, 2));
+    }
+}
+//# sourceMappingURL=show.js.map

package/dist/commands/audit/show.js.map

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

package/dist/commands/checklist.d.ts

@@ -0,0 +1,17 @@
+import { Command } from "@oclif/core";
+export default class Checklist extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        feature: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        init: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        validate: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        agent: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "wait-artifact": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "wait-timeout": import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=checklist.d.ts.map

package/dist/commands/checklist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checklist.d.ts","sourceRoot":"","sources":["../../src/commands/checklist.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,OAAO,EAAS,MAAM,aAAa,CAAC;AAyCnD,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,OAAO;IAC5C,OAAgB,WAAW,SAC6C;IAExE,OAAgB,QAAQ,WAItB;IAEF,OAAgB,IAAI;;MAKlB;IAEF,OAAgB,KAAK;;;;;;MAoBnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA0P3B"}

package/dist/commands/checklist.js

@@ -0,0 +1,255 @@
+import { Args, Command, Flags } from "@oclif/core";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { basename, join } from "node:path";
+import { appendAuditEvent, buildCanonicalPrompt, discoverChecklists, formatReport, gateChecklistFrontmatter, gateChecklistLinksToDecisions, gateChecklistNonEmpty, generateChecklistFrontmatter, hashString, loadAgentsConfig, parseChecklistItems, parsePlan, runGates, selectAgent, summarizeChecklist, } from "../_core/dist/index.js";
+import { parseFrontmatter } from "../_core/dist/index.js";
+import { currentActor, featureDir, requireProjectRoot, } from "../shared/project.js";
+import { writeFeaturePrompt } from "../shared/feature-prompt.js";
+import { runAfterHook, runBeforeHook } from "../shared/hooks.js";
+import { backupPhaseFile, waitForPhaseArtifact, } from "../shared/artifact-io.js";
+const KNOWN_KINDS = [
+    "security",
+    "performance",
+    "accessibility",
+    "reliability",
+    "privacy",
+];
+export default class Checklist extends Command {
+    static description = "Generate, validate, and summarize thematic checklists for a feature";
+    static examples = [
+        "<%= config.bin %> checklist login-biometrico",
+        "<%= config.bin %> checklist login-biometrico --init security",
+        "<%= config.bin %> checklist login-biometrico --validate",
+    ];
+    static args = {
+        feature: Args.string({
+            description: "Feature slug or NNN-slug",
+            required: true,
+        }),
+    };
+    static flags = {
+        init: Flags.string({
+            description: `Initialize a new checklist (${KNOWN_KINDS.join(", ")}, or custom name)`,
+        }),
+        validate: Flags.boolean({
+            description: "Run checklist gates (frontmatter, links, non-empty)",
+            default: false,
+        }),
+        agent: Flags.string({
+            description: "Agent to use for checklist (overrides agents.yml policy)",
+        }),
+        "wait-artifact": Flags.boolean({
+            description: "After writing the agent command file, block until a checklist file is produced",
+            default: false,
+        }),
+        "wait-timeout": Flags.integer({
+            description: "Timeout (seconds) for --wait-artifact",
+            default: 300,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Checklist);
+        const root = requireProjectRoot();
+        const dir = featureDir(root, args.feature);
+        const featureName = basename(dir);
+        const auditPath = join(dir, "audit.jsonl");
+        const actor = currentActor("human");
+        runBeforeHook(this, {
+            event: "before_checklist",
+            command: `raptor checklist ${args.feature}`,
+            projectRoot: root,
+            feature: featureName,
+            featureDir: dir,
+            actor: { user: actor.email ?? actor.user, via: actor.via },
+        });
+        // -----------------------------------------------------------------------
+        // Agent prompt generation
+        // -----------------------------------------------------------------------
+        let agentInfo = {
+            id: "human",
+            reason: "manual_check",
+        };
+        const agentsConfig = loadAgentsConfig(root);
+        if (agentsConfig) {
+            try {
+                const selection = selectAgent(agentsConfig, "checklist", flags.agent);
+                agentInfo = {
+                    id: selection.agentEntryId,
+                    reason: selection.reason,
+                };
+                // Build canonical prompt for checklist
+                const canonical = buildCanonicalPrompt({
+                    command: "checklist",
+                    feature: featureName,
+                    projectRoot: root,
+                    constitutionArticles: [],
+                    invariants: ["I-04", "I-06"],
+                });
+                const packedContent = selection.agent.packPrompt(canonical);
+                // Feature-scoped prompt — must NOT clobber the rich slash commands (F1).
+                agentInfo.commandFile = writeFeaturePrompt({
+                    root,
+                    featureDir: dir,
+                    command: "checklist",
+                    content: packedContent,
+                    cmd: this,
+                });
+            }
+            catch (err) {
+                this.warn(`Agent selection failed: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        // --- Mode: init ---
+        if (flags.init) {
+            const kind = flags.init;
+            const clDir = join(dir, "checklists");
+            mkdirSync(clDir, { recursive: true });
+            const clPath = join(clDir, `${kind}.md`);
+            if (existsSync(clPath)) {
+                this.error(`${kind}.md already exists at ${clPath}`);
+            }
+            // Try to get plan hash for traceability
+            const planPath = join(dir, "plan.md");
+            const specPath = join(dir, "spec.md");
+            let planHash = "";
+            let specHash = "";
+            if (existsSync(planPath)) {
+                const plan = parsePlan(planPath);
+                planHash = plan.hash;
+            }
+            if (existsSync(specPath)) {
+                specHash = hashString(readFileSync(specPath, "utf8"));
+            }
+            const fmMatch = featureName.match(/^(\d{3})-(.+)/);
+            const featureId = fmMatch?.[1] ?? "000";
+            const slug = fmMatch?.[2] ?? featureName;
+            const fm = generateChecklistFrontmatter({
+                featureId,
+                slug,
+                kind,
+                planHash,
+                specHash,
+            });
+            const body = `\n## ${kind.charAt(0).toUpperCase() + kind.slice(1)} Checklist\n\n<!-- Add checklist items below. Format:\n- [ ] **CK-1** — Description [D1] [A1]\n  Status markers: [ ] pending, [x] passed, [!] failed, [-] N/A, [~] deferred\n  [D1] = decision ref from plan.md, [A1] = acceptance ref from spec.md\n-->\n\n- [ ] **CK-1** — [NEEDS CLARIFICATION: first check item] [D1]\n`;
+            backupPhaseFile({ root, command: this }, clPath);
+            writeFileSync(clPath, fm + body);
+            appendAuditEvent(auditPath, {
+                event: "checklist.generated",
+                feature: featureName,
+                command: `raptor checklist --init ${kind}`,
+                actor: { user: actor.email ?? actor.user, via: actor.via },
+                agent: { key: agentInfo.id },
+                prompt: { hash: hashString(`checklist@${kind}@${featureName}`) },
+                outputs: [
+                    {
+                        path: `specs/${featureName}/checklists/${kind}.md`,
+                        hash: hashString(fm + body),
+                    },
+                ],
+                meta: {
+                    kind,
+                    plan_hash: planHash || undefined,
+                    agent_reason: agentInfo.reason,
+                },
+            });
+            this.log(`✓ Created ${kind} checklist at ${clPath}`);
+            this.log("");
+            this.log("Next steps:");
+            this.log(`  1. Edit ${kind}.md — add checklist items with [Dk] and [Ak] refs`);
+            this.log(`  2. Run 'raptor checklist ${args.feature}' to see summary`);
+            this.log(`  3. Run 'raptor checklist ${args.feature} --validate' to check gates`);
+            runAfterHook(this, {
+                event: "after_checklist",
+                command: `raptor checklist ${args.feature} --init ${kind}`,
+                projectRoot: root,
+                feature: featureName,
+                featureDir: dir,
+                actor: { user: actor.email ?? actor.user, via: actor.via },
+            });
+            return;
+        }
+        // --- Mode: validate ---
+        if (flags.validate) {
+            const gates = [
+                gateChecklistFrontmatter,
+                gateChecklistLinksToDecisions,
+                gateChecklistNonEmpty,
+            ];
+            const report = await runGates(gates, {
+                projectRoot: root,
+                featureDir: dir,
+            });
+            this.log(`=== Checklist Gates for ${featureName} ===`);
+            this.log(formatReport(report));
+            if (report.blocked)
+                this.exit(1);
+            runAfterHook(this, {
+                event: "after_checklist",
+                command: `raptor checklist ${args.feature} --validate`,
+                projectRoot: root,
+                feature: featureName,
+                featureDir: dir,
+                actor: { user: actor.email ?? actor.user, via: actor.via },
+            });
+            return;
+        }
+        // --- Mode: summary (default) ---
+        const checklists = discoverChecklists(dir);
+        if (checklists.length === 0) {
+            this.log(`No checklists found for ${featureName}.`);
+            this.log("");
+            this.log(`  Run 'raptor checklist ${args.feature} --init <kind>' to create one.`);
+            this.log(`  Available kinds: ${KNOWN_KINDS.join(", ")}`);
+            return;
+        }
+        this.log(`=== Checklists for ${featureName} ===\n`);
+        let totalAll = 0;
+        let passedAll = 0;
+        let failedAll = 0;
+        for (const { kind, path } of checklists) {
+            const raw = readFileSync(path, "utf8");
+            const { body } = parseFrontmatter(raw);
+            const items = parseChecklistItems(body);
+            const summary = summarizeChecklist(items);
+            totalAll += summary.total;
+            passedAll += summary.passed;
+            failedAll += summary.failed;
+            const rate = summary.passRate > 0 ? `${(summary.passRate * 100).toFixed(0)}%` : "—";
+            const icon = summary.failed > 0 ? "🔴" : summary.pending > 0 ? "🟡" : "🟢";
+            this.log(`  ${icon} ${kind}`);
+            this.log(`     Total: ${summary.total}  ✅ ${summary.passed}  ❌ ${summary.failed}  ⏳ ${summary.pending}  ⊘ ${summary.notApplicable}  ⏸ ${summary.deferred}`);
+            this.log(`     Pass rate: ${rate}  |  Linked to decisions: ${summary.linkedToDecision}/${summary.total}`);
+            this.log("");
+        }
+        this.log(`  ── Summary ──`);
+        this.log(`  ${checklists.length} checklist(s)  |  ${totalAll} items  |  ✅ ${passedAll}  ❌ ${failedAll}  ⏳ ${totalAll - passedAll - failedAll}`);
+        if (flags["wait-artifact"] && agentInfo.commandFile) {
+            const clDir = join(dir, "checklists");
+            await waitForPhaseArtifact({
+                root,
+                command: this,
+                expectedPath: `${clDir}/**`,
+                agentId: agentInfo.id,
+                timeoutMs: flags["wait-timeout"] * 1000,
+                label: clDir,
+            });
+        }
+        runAfterHook(this, {
+            event: "after_checklist",
+            command: `raptor checklist ${args.feature}`,
+            projectRoot: root,
+            feature: featureName,
+            featureDir: dir,
+            actor: { user: actor.email ?? actor.user, via: actor.via },
+            extra: {
+                agent: agentInfo.id,
+                agent_reason: agentInfo.reason,
+            },
+        });
+        if (agentInfo.commandFile) {
+            this.log(`  Agent:   ${agentInfo.id} (${agentInfo.reason})`);
+            this.log(`  Command: ${agentInfo.commandFile}`);
+        }
+    }
+}
+//# sourceMappingURL=checklist.js.map