raptor-aios 0.1.0

package/dist/commands/preset/info.d.ts

@@ -0,0 +1,13 @@
+import { Command } from "@oclif/core";
+export default class PresetInfo extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=info.d.ts.map

package/dist/commands/preset/info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../../../src/commands/preset/info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,OAAO,EAAS,MAAM,aAAa,CAAC;AASnD,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,OAAO;IAC7C,OAAgB,WAAW,SAC2E;IAEtG,OAAgB,QAAQ,WAGtB;IAEF,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;MAEnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAkE3B"}

package/dist/commands/preset/info.js

@@ -0,0 +1,80 @@
+import { Args, Command, Flags } from "@oclif/core";
+import { relative } from "node:path";
+import { getPreset, loadPresetsFromProject, PresetManifestError, } from "../../_core/dist/index.js";
+import { requireProjectRoot, readConfig, activePresetIds } from "../../shared/project.js";
+export default class PresetInfo extends Command {
+    static description = "Show the articles and gate ids composing a preset, plus whether the current project activates it.";
+    static examples = [
+        "<%= config.bin %> preset info mobile-opinionated",
+        "<%= config.bin %> preset info mobile-opinionated --json",
+    ];
+    static args = {
+        id: Args.string({ description: "Preset id", required: true }),
+    };
+    static flags = {
+        json: Flags.boolean({ description: "Emit JSON output.", default: false }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(PresetInfo);
+        const root = requireProjectRoot();
+        const cfg = readConfig(root);
+        const active = activePresetIds(cfg).includes(args.id);
+        const bundled = getPreset(args.id);
+        let disk;
+        try {
+            disk = loadPresetsFromProject(root).find((p) => p.manifest.id === args.id);
+        }
+        catch (err) {
+            if (err instanceof PresetManifestError)
+                this.error(err.message);
+            throw err;
+        }
+        if (!bundled && !disk) {
+            this.error(`preset "${args.id}" is not known. Run 'raptor preset list' to see available ones.`);
+        }
+        const payload = bundled
+            ? {
+                source: "bundled",
+                id: bundled.id,
+                name: bundled.name,
+                version: bundled.version,
+                description: bundled.description,
+                articles: bundled.articles,
+                gateIds: bundled.gates.map((g) => g.id),
+                active,
+            }
+            : {
+                source: "disk",
+                id: disk.manifest.id,
+                name: disk.manifest.name,
+                version: disk.manifest.version,
+                description: disk.manifest.description ?? "",
+                articles: disk.manifest.articles ?? [],
+                gateIds: disk.manifest.gates ?? [],
+                path: relative(root, disk.manifestPath),
+                active,
+            };
+        if (flags.json) {
+            this.log(JSON.stringify(payload, null, 2));
+            return;
+        }
+        this.log(`Preset: ${payload.id}`);
+        this.log(`  Name:        ${payload.name}`);
+        this.log(`  Version:     ${payload.version}`);
+        this.log(`  Source:      ${payload.source}${"path" in payload ? ` (${payload.path})` : ""}`);
+        this.log(`  Active:      ${payload.active ? "yes" : "no"}`);
+        if (payload.description) {
+            this.log(`  Description: ${payload.description}`);
+        }
+        this.log("");
+        this.log(`  Articles (${payload.articles.length}):`);
+        for (const a of payload.articles) {
+            this.log(`    - ${a.id}: ${a.title}`);
+        }
+        this.log("");
+        this.log(`  Gates (${payload.gateIds.length}):`);
+        for (const g of payload.gateIds)
+            this.log(`    - ${g}`);
+    }
+}
+//# sourceMappingURL=info.js.map

package/dist/commands/preset/info.js.map

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

package/dist/commands/preset/list.d.ts

@@ -0,0 +1,10 @@
+import { Command } from "@oclif/core";
+export default class PresetList extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/preset/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/preset/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAU7C,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,OAAO;IAC7C,OAAgB,WAAW,SAE8B;IAEzD,OAAgB,QAAQ,WAGtB;IAEF,OAAgB,KAAK;;MAEnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAmD3B"}

package/dist/commands/preset/list.js

@@ -0,0 +1,63 @@
+import { Command, Flags } from "@oclif/core";
+import { relative } from "node:path";
+import { knownPresetIds, loadPresetsFromProject, listPresets, PresetManifestError, } from "../../_core/dist/index.js";
+import { requireProjectRoot, readConfig, activePresetIds } from "../../shared/project.js";
+export default class PresetList extends Command {
+    static description = "List presets available to this project: both bundled TypeScript presets and any disk-based presets under .raptor/presets/. " +
+        "Marks which ones are active according to raptor.yml.";
+    static examples = [
+        "<%= config.bin %> preset list",
+        "<%= config.bin %> preset list --json",
+    ];
+    static flags = {
+        json: Flags.boolean({ description: "Emit JSON output.", default: false }),
+    };
+    async run() {
+        const { flags } = await this.parse(PresetList);
+        const root = requireProjectRoot();
+        const cfg = readConfig(root);
+        const active = new Set(activePresetIds(cfg));
+        const bundled = listPresets().map((p) => ({
+            id: p.id,
+            name: p.name,
+            version: p.version,
+            source: "bundled",
+            path: null,
+        }));
+        let disk;
+        try {
+            disk = loadPresetsFromProject(root).map((p) => ({
+                id: p.manifest.id,
+                name: p.manifest.name,
+                version: p.manifest.version,
+                source: "disk",
+                path: relative(root, p.manifestPath),
+            }));
+        }
+        catch (err) {
+            if (err instanceof PresetManifestError)
+                this.error(err.message);
+            throw err;
+        }
+        const bundledIds = new Set(bundled.map((b) => b.id));
+        const combined = [...bundled, ...disk.filter((d) => !bundledIds.has(d.id))];
+        const rows = combined.map((r) => ({ ...r, active: active.has(r.id) }));
+        if (flags.json) {
+            this.log(JSON.stringify({ active: [...active], presets: rows }, null, 2));
+            return;
+        }
+        if (rows.length === 0) {
+            this.log("(no presets discovered)");
+            return;
+        }
+        for (const r of rows) {
+            const tag = r.active ? "●" : "○";
+            const location = r.source === "bundled" ? "(bundled)" : `(${r.path})`;
+            this.log(`${tag} ${r.id}@${r.version} — ${r.name} ${location}`);
+        }
+        this.log("");
+        this.log(`Active: ${[...active].join(", ") || "(none)"}`);
+        this.log(`Known bundled ids: ${knownPresetIds().join(", ")}`);
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/preset/list.js.map

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

package/dist/commands/preset/remove.d.ts

@@ -0,0 +1,14 @@
+import { Command } from "@oclif/core";
+export default class PresetRemove extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "dry-run": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=remove.d.ts.map

package/dist/commands/preset/remove.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../../src/commands/preset/remove.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,OAAO,EAAS,MAAM,aAAa,CAAC;AAMnD,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,OAAO;IAC/C,OAAgB,WAAW,SAEgF;IAE3G,OAAgB,QAAQ,WAGtB;IAEF,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;;MASnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAoC3B"}

package/dist/commands/preset/remove.js

@@ -0,0 +1,60 @@
+import { Args, Command, Flags } from "@oclif/core";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+import { requireProjectRoot, activePresetIds, readConfig } from "../../shared/project.js";
+export default class PresetRemove extends Command {
+    static description = "Deactivate a preset by removing it from the `presets:` array in .raptor/raptor.yml. " +
+        "Disk files under .raptor/presets/<id>/ are NOT deleted — rerun with 'raptor preset add' to reactivate.";
+    static examples = [
+        "<%= config.bin %> preset remove mobile-opinionated",
+        "<%= config.bin %> preset remove legacy-baseline --force",
+    ];
+    static args = {
+        id: Args.string({ description: "Preset id to deactivate", required: true }),
+    };
+    static flags = {
+        force: Flags.boolean({
+            description: "Do not error when the preset is not active",
+            default: false,
+        }),
+        "dry-run": Flags.boolean({
+            description: "Print the change without updating raptor.yml",
+            default: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(PresetRemove);
+        const root = requireProjectRoot();
+        const cfg = readConfig(root);
+        const active = activePresetIds(cfg);
+        if (!active.includes(args.id)) {
+            if (flags.force) {
+                this.log(`(not active — nothing to do)`);
+                return;
+            }
+            this.error(`preset "${args.id}" is not active. Re-run with --force to suppress this error.`);
+        }
+        const ymlPath = join(root, ".raptor", "raptor.yml");
+        if (!existsSync(ymlPath)) {
+            this.error(`.raptor/raptor.yml does not exist at ${ymlPath}`);
+        }
+        const raw = readFileSync(ymlPath, "utf8");
+        const parsed = (parseYaml(raw) ?? {});
+        const next = active.filter((p) => p !== args.id);
+        if (next.length > 0)
+            parsed["presets"] = next;
+        else
+            delete parsed["presets"];
+        if ("preset" in parsed)
+            delete parsed["preset"];
+        if (flags["dry-run"]) {
+            this.log(`[dry-run] presets: ${JSON.stringify(next)}`);
+            return;
+        }
+        writeFileSync(ymlPath, stringifyYaml(parsed));
+        this.log(`✓ Removed "${args.id}"`);
+        this.log(`  Active presets: ${next.join(", ") || "(none)"}`);
+    }
+}
+//# sourceMappingURL=remove.js.map

package/dist/commands/preset/remove.js.map

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

package/dist/commands/repair/constitution.d.ts

@@ -0,0 +1,11 @@
+import { Command } from "@oclif/core";
+export default class RepairConstitution extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        confirm: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "dry-run": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=constitution.d.ts.map

package/dist/commands/repair/constitution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constitution.d.ts","sourceRoot":"","sources":["../../../src/commands/repair/constitution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAc7C,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,OAAO;IACrD,OAAgB,WAAW,SAC+I;IAE1K,OAAgB,QAAQ,WAGtB;IAEF,OAAgB,KAAK;;;MASnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA8G3B"}

package/dist/commands/repair/constitution.js

@@ -0,0 +1,117 @@
+import { Command, Flags } from "@oclif/core";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { appendAuditEvent, CORE_VERSION, coreHash, extractCoreBlock, hashString, rewriteCoreBlock, } from "../../_core/dist/index.js";
+import { currentActor, requireProjectRoot } from "../../shared/project.js";
+import { runAfterHook, runBeforeHook } from "../../shared/hooks.js";
+export default class RepairConstitution extends Command {
+    static description = "Rewrite the RAPTOR-CORE block in .raptor/constitution.md to the canonical text of the installed CLI. Records a constitution.repaired entry in amendments.log (C4/C5).";
+    static examples = [
+        "<%= config.bin %> repair constitution --confirm",
+        "<%= config.bin %> repair constitution --dry-run",
+    ];
+    static flags = {
+        confirm: Flags.boolean({
+            description: "Required acknowledgement that the block will be rewritten.",
+            default: false,
+        }),
+        "dry-run": Flags.boolean({
+            description: "Show what would change without writing or logging.",
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(RepairConstitution);
+        const root = requireProjectRoot();
+        const path = join(root, ".raptor", "constitution.md");
+        const amendmentsLog = join(root, ".raptor", "memory", "amendments.log");
+        if (!existsSync(path)) {
+            this.error(`constitution.md missing at ${path}`);
+        }
+        const actor0 = currentActor("human");
+        runBeforeHook(this, {
+            event: "before_repair_constitution",
+            command: `raptor repair constitution${flags.confirm ? " --confirm" : ""}${flags["dry-run"] ? " --dry-run" : ""}`,
+            projectRoot: root,
+            actor: { user: actor0.email ?? actor0.user, via: actor0.via },
+            extra: {
+                ...(flags.confirm ? { confirm: "1" } : {}),
+                ...(flags["dry-run"] ? { dry_run: "1" } : {}),
+            },
+        });
+        const source = readFileSync(path, "utf8");
+        const before = extractCoreBlock(source);
+        const previousFileHash = hashString(source);
+        this.log(`Constitution: ${path}`);
+        if (before) {
+            this.log(`  Current block: v=${before.version} hash=${before.declaredHash}`);
+            this.log(`  Intact=${before.isIntact} canonical=${before.isCanonical}`);
+        }
+        else {
+            this.log("  Current block: (missing — canonical block will be inserted)");
+        }
+        this.log(`  Target:        v=${CORE_VERSION} hash=${coreHash()}`);
+        if (before?.isCanonical) {
+            this.log("");
+            this.log("✓ Block is already canonical — nothing to repair.");
+            return;
+        }
+        if (flags["dry-run"]) {
+            this.log("");
+            this.log("(dry-run) Would rewrite the RAPTOR-CORE block to the canonical text.");
+            return;
+        }
+        if (!flags.confirm) {
+            this.error("Repair is destructive to the current RAPTOR-CORE block. Pass --confirm to proceed, or --dry-run to preview.");
+        }
+        const actor = currentActor("human");
+        if (!actor.email) {
+            this.error("C5: `constitution.repaired` requires a human approver — configure `git config user.email` before running repair.");
+        }
+        const next = rewriteCoreBlock(source);
+        writeFileSync(path, next);
+        const newFileHash = hashString(next);
+        appendAuditEvent(amendmentsLog, {
+            event: "constitution.repaired",
+            command: "raptor repair constitution",
+            actor: { user: actor.user, via: actor.via },
+            article: "C4",
+            inputs: [
+                {
+                    path: ".raptor/constitution.md",
+                    hash: previousFileHash,
+                    role: "constitution",
+                },
+            ],
+            outputs: [
+                {
+                    path: ".raptor/constitution.md",
+                    hash: newFileHash,
+                    role: "constitution",
+                },
+            ],
+            meta: {
+                previous_version: before?.version ?? null,
+                previous_block_hash: before?.declaredHash ?? null,
+                previous_intact: before?.isIntact ?? null,
+                previous_canonical: before?.isCanonical ?? null,
+                new_version: CORE_VERSION,
+                new_block_hash: coreHash(),
+            },
+        });
+        this.log("");
+        this.log("✓ RAPTOR-CORE block rewritten to canonical text.");
+        this.log(`  Recorded constitution.repaired in ${amendmentsLog}`);
+        runAfterHook(this, {
+            event: "after_repair_constitution",
+            command: "raptor repair constitution",
+            projectRoot: root,
+            actor: { user: actor.email ?? actor.user, via: actor.via },
+            extra: {
+                new_version: CORE_VERSION,
+                new_hash: coreHash(),
+            },
+        });
+    }
+}
+//# sourceMappingURL=constitution.js.map

package/dist/commands/repair/constitution.js.map

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

package/dist/commands/resync.d.ts

@@ -0,0 +1,22 @@
+import { Command } from "@oclif/core";
+/**
+ * resync — re-bless downstream input-hashes after an INTENTIONAL upstream edit.
+ *
+ * Editing an approved spec.md changes its hash, which makes plan.md's
+ * `spec_hash` (and transitively tasks.md's `plan_hash`) stale — blocking the
+ * staleness gates even though the change was deliberate. `resync` updates those
+ * input-hashes to the current upstream content and records an audit event, so
+ * you don't have to regenerate (and lose) authored downstream content.
+ */
+export default class Resync extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        feature: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        artifact: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=resync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resync.d.ts","sourceRoot":"","sources":["../../src/commands/resync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,OAAO,EAAS,MAAM,aAAa,CAAC;AAWnD;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,OAAO;IACzC,OAAgB,WAAW,SAC8F;IAEzH,OAAgB,QAAQ,WAGtB;IAEF,OAAgB,IAAI;;MAKlB;IAEF,OAAgB,KAAK;;MAMnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAwE3B"}

package/dist/commands/resync.js

@@ -0,0 +1,103 @@
+import { Args, Command, Flags } from "@oclif/core";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { basename, join } from "node:path";
+import { appendAuditEvent, parsePlan, parseSpec, updateFrontmatter, } from "../_core/dist/index.js";
+import { currentActor, featureDir, requireProjectRoot } from "../shared/project.js";
+/**
+ * resync — re-bless downstream input-hashes after an INTENTIONAL upstream edit.
+ *
+ * Editing an approved spec.md changes its hash, which makes plan.md's
+ * `spec_hash` (and transitively tasks.md's `plan_hash`) stale — blocking the
+ * staleness gates even though the change was deliberate. `resync` updates those
+ * input-hashes to the current upstream content and records an audit event, so
+ * you don't have to regenerate (and lose) authored downstream content.
+ */
+export default class Resync extends Command {
+    static description = "Re-point downstream input-hashes (plan.spec_hash, tasks.plan_hash) to the current upstream after an intentional edit";
+    static examples = [
+        "<%= config.bin %> resync 001-home-screen",
+        "<%= config.bin %> resync 001-home-screen --artifact plan",
+    ];
+    static args = {
+        feature: Args.string({
+            description: "Feature slug or NNN-slug",
+            required: true,
+        }),
+    };
+    static flags = {
+        artifact: Flags.string({
+            description: "Which downstream artifact to resync",
+            options: ["plan", "tasks", "all"],
+            default: "all",
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Resync);
+        const root = requireProjectRoot();
+        const dir = featureDir(root, args.feature);
+        const featureName = basename(dir);
+        const specPath = join(dir, "spec.md");
+        const planPath = join(dir, "plan.md");
+        const tasksPath = join(dir, "tasks.md");
+        const auditPath = join(dir, "audit.jsonl");
+        const actor = currentActor("human");
+        if (!existsSync(specPath))
+            this.error(`spec.md missing at ${specPath}`);
+        const target = flags.artifact;
+        const changes = [];
+        // 1. plan.spec_hash <- current spec hash
+        if (target === "plan" || target === "all") {
+            if (!existsSync(planPath)) {
+                if (target === "plan")
+                    this.error(`plan.md missing at ${planPath}`);
+            }
+            else {
+                const spec = parseSpec(specPath);
+                const planRaw = readFileSync(planPath, "utf8");
+                const planFm = parsePlan(planPath).data;
+                if (planFm.spec_hash !== spec.hash) {
+                    writeFileSync(planPath, updateFrontmatter(planRaw, { spec_hash: spec.hash }));
+                    changes.push({ artifact: "plan.md", key: "spec_hash", to: spec.hash });
+                }
+            }
+        }
+        // 2. tasks.plan_hash <- current plan hash (read AFTER any plan rewrite)
+        if (target === "tasks" || target === "all") {
+            if (!existsSync(tasksPath)) {
+                if (target === "tasks")
+                    this.error(`tasks.md missing at ${tasksPath}`);
+            }
+            else if (existsSync(planPath)) {
+                const plan = parsePlan(planPath);
+                const tasksRaw = readFileSync(tasksPath, "utf8");
+                const tasksFm = parsePlan(tasksPath).data;
+                if (tasksFm.plan_hash !== plan.hash) {
+                    writeFileSync(tasksPath, updateFrontmatter(tasksRaw, { plan_hash: plan.hash }));
+                    changes.push({ artifact: "tasks.md", key: "plan_hash", to: plan.hash });
+                }
+            }
+        }
+        if (changes.length === 0) {
+            this.log(`✓ ${featureName} already in sync — nothing to do.`);
+            return;
+        }
+        appendAuditEvent(auditPath, {
+            event: "artifact.resynced",
+            feature: featureName,
+            command: `raptor resync ${args.feature}`,
+            actor: { user: actor.email ?? actor.user, via: actor.via },
+            meta: {
+                artifact: target,
+                changes: changes.map((c) => `${c.artifact}:${c.key}`),
+            },
+        });
+        this.log(`✓ Resynced ${featureName}:`);
+        for (const c of changes) {
+            this.log(`  ${c.artifact} ${c.key} → ${c.to.slice(0, 24)}…`);
+        }
+        this.log("");
+        this.log("  Note: this re-blesses the input hash after your edit. Re-run 'raptor verify' " +
+            "and re-approve if the change is material.");
+    }
+}
+//# sourceMappingURL=resync.js.map

package/dist/commands/resync.js.map

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

package/dist/commands/skill/add.d.ts

@@ -0,0 +1,19 @@
+import { Command } from "@oclif/core";
+export default class SkillAdd extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        description: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        prompt: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "prompt-file": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        agents: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private registerInManifest;
+}
+//# sourceMappingURL=add.d.ts.map

package/dist/commands/skill/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../src/commands/skill/add.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,OAAO,EAAS,MAAM,aAAa,CAAC;AAcnD,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,OAAO;IAC3C,OAAgB,WAAW,SACkE;IAE7F,OAAgB,QAAQ,WAGtB;IAEF,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;;;;;;MAiBnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAqE1B,OAAO,CAAC,kBAAkB;CAgB3B"}