@principles/pd-cli 1.119.0 → 1.120.0

package/dist/commands/__tests__/rulecode-flag-wiring.test.js

@@ -0,0 +1,179 @@
+/**
+ * Parser-level tests for `pd rulecode spec|validate|replay` flags (PRI-439 Phase 5).
+ *
+ * CLI gate rule 7: "Test the real command wiring — when behavior depends on
+ * Commander options, add a command-registration or parser test that exercises
+ * the actual flags."
+ *
+ * Tests the real `registerRulecodeCommand` helper (single source of truth
+ * shared with `index.ts`). Flag typos in production surface here at
+ * parseAsync time, not at handler dispatch.
+ *
+ * Covers:
+ *   - `spec` subcommand: --json, --workspace/-w registered; no --code
+ *   - `validate` subcommand: --code required, --code-file, --json, --workspace/-w
+ *   - `replay` subcommand: --code required, --code-file, --golden-trace required,
+ *     --json, --workspace/-w
+ *   - --no-* negations are NOT registered (no accidental negation)
+ *   - parseAsync actually dispatches the right opts to the handler
+ */
+import { describe, it, expect } from 'vitest';
+import { Command } from 'commander';
+import { registerRulecodeCommand } from '../rulecode.js';
+function attachCapture(cmd, state) {
+    cmd.action(function captureAction(...args) {
+        let optsArg = null;
+        for (let i = args.length - 1; i >= 0; i--) {
+            const arg = args[i];
+            if (arg !== null && typeof arg === 'object' && !(arg instanceof Command)) {
+                optsArg = arg;
+                break;
+            }
+        }
+        if (optsArg !== null && typeof optsArg === 'object') {
+            state.opts = optsArg;
+        }
+        else {
+            state.opts = {};
+        }
+    });
+}
+function freshProgram() {
+    const program = new Command();
+    program.name('pd').exitOverride();
+    return program;
+}
+describe('pd rulecode — flag wiring (CLI gate rule 7)', () => {
+    // ── spec subcommand ───────────────────────────────────────────────────────
+    it('registers spec subcommand with --json and --workspace', () => {
+        const program = freshProgram();
+        const rulecodeCmd = registerRulecodeCommand(program);
+        const specCmd = rulecodeCmd.commands.find((c) => c.name() === 'spec');
+        expect(specCmd).toBeDefined();
+        const jsonOpt = specCmd.options.find((o) => o.long === '--json');
+        expect(jsonOpt).toBeDefined();
+        const wsOpt = specCmd.options.find((o) => o.long === '--workspace');
+        expect(wsOpt).toBeDefined();
+        expect(wsOpt?.short).toBe('-w');
+    });
+    it('spec subcommand does NOT register --code', () => {
+        const program = freshProgram();
+        const rulecodeCmd = registerRulecodeCommand(program);
+        const specCmd = rulecodeCmd.commands.find((c) => c.name() === 'spec');
+        const codeOpt = specCmd.options.find((o) => o.long === '--code');
+        expect(codeOpt).toBeUndefined();
+    });
+    // ── validate subcommand ───────────────────────────────────────────────────
+    it('registers validate subcommand with --code, --code-file, --json, --workspace', () => {
+        const program = freshProgram();
+        const rulecodeCmd = registerRulecodeCommand(program);
+        const validateCmd = rulecodeCmd.commands.find((c) => c.name() === 'validate');
+        expect(validateCmd).toBeDefined();
+        const codeOpt = validateCmd.options.find((o) => o.long === '--code');
+        expect(codeOpt).toBeDefined();
+        const codeFileOpt = validateCmd.options.find((o) => o.long === '--code-file');
+        expect(codeFileOpt).toBeDefined();
+        const jsonOpt = validateCmd.options.find((o) => o.long === '--json');
+        expect(jsonOpt).toBeDefined();
+        const wsOpt = validateCmd.options.find((o) => o.long === '--workspace');
+        expect(wsOpt).toBeDefined();
+        expect(wsOpt?.short).toBe('-w');
+    });
+    it('validate --code is NOT required at parser level (can use --code-file instead)', async () => {
+        const program = freshProgram();
+        const rulecodeCmd = registerRulecodeCommand(program);
+        const validateCmd = rulecodeCmd.commands.find((c) => c.name() === 'validate');
+        const captured = { opts: null };
+        attachCapture(validateCmd, captured);
+        // parseAsync should NOT reject when --code is missing (handler validates)
+        await program.parseAsync(['node', 'pd', 'rulecode', 'validate', '--json']);
+        expect(captured.opts).not.toBeNull();
+        expect(captured.opts.code).toBeUndefined();
+    });
+    // ── replay subcommand ─────────────────────────────────────────────────────
+    it('registers replay subcommand with --code, --code-file, --golden-trace, --json, --workspace', () => {
+        const program = freshProgram();
+        const rulecodeCmd = registerRulecodeCommand(program);
+        const replayCmd = rulecodeCmd.commands.find((c) => c.name() === 'replay');
+        expect(replayCmd).toBeDefined();
+        const codeOpt = replayCmd.options.find((o) => o.long === '--code');
+        expect(codeOpt).toBeDefined();
+        const codeFileOpt = replayCmd.options.find((o) => o.long === '--code-file');
+        expect(codeFileOpt).toBeDefined();
+        const gtOpt = replayCmd.options.find((o) => o.long === '--golden-trace');
+        expect(gtOpt).toBeDefined();
+        const jsonOpt = replayCmd.options.find((o) => o.long === '--json');
+        expect(jsonOpt).toBeDefined();
+        const wsOpt = replayCmd.options.find((o) => o.long === '--workspace');
+        expect(wsOpt).toBeDefined();
+        expect(wsOpt?.short).toBe('-w');
+    });
+    it('replay --golden-trace is required', () => {
+        const program = freshProgram();
+        const rulecodeCmd = registerRulecodeCommand(program);
+        const replayCmd = rulecodeCmd.commands.find((c) => c.name() === 'replay');
+        const gtOpt = replayCmd.options.find((o) => o.long === '--golden-trace');
+        expect(gtOpt?.required).toBe(true);
+    });
+    // ── No accidental negations ───────────────────────────────────────────────
+    it('does NOT register --no-json on any subcommand', () => {
+        const program = freshProgram();
+        const rulecodeCmd = registerRulecodeCommand(program);
+        for (const sub of rulecodeCmd.commands) {
+            const noJson = sub.options.find((o) => o.long === '--no-json');
+            expect(noJson).toBeUndefined();
+        }
+    });
+    // ── Parser-level dispatch ─────────────────────────────────────────────────
+    it('parseAsync dispatches spec subcommand with json=true', async () => {
+        const program = freshProgram();
+        const rulecodeCmd = registerRulecodeCommand(program);
+        const specCmd = rulecodeCmd.commands.find((c) => c.name() === 'spec');
+        const captured = { opts: null };
+        attachCapture(specCmd, captured);
+        await program.parseAsync(['node', 'pd', 'rulecode', 'spec', '--json']);
+        expect(captured.opts).not.toBeNull();
+        expect(captured.opts.json).toBe(true);
+    });
+    it('parseAsync dispatches validate with --code', async () => {
+        const program = freshProgram();
+        const rulecodeCmd = registerRulecodeCommand(program);
+        const validateCmd = rulecodeCmd.commands.find((c) => c.name() === 'validate');
+        const captured = { opts: null };
+        attachCapture(validateCmd, captured);
+        await program.parseAsync([
+            'node', 'pd', 'rulecode', 'validate',
+            '--code', 'function evaluate(input, helpers) { return { decision: "allow", matched: false, reason: "x" }; }',
+            '--json',
+        ]);
+        expect(captured.opts).not.toBeNull();
+        expect(captured.opts.code).toContain('function evaluate');
+        expect(captured.opts.json).toBe(true);
+    });
+    it('parseAsync dispatches replay with --code and --golden-trace', async () => {
+        const program = freshProgram();
+        const rulecodeCmd = registerRulecodeCommand(program);
+        const replayCmd = rulecodeCmd.commands.find((c) => c.name() === 'replay');
+        const captured = { opts: null };
+        attachCapture(replayCmd, captured);
+        await program.parseAsync([
+            'node', 'pd', 'rulecode', 'replay',
+            '--code', 'function evaluate(input, helpers) { return { decision: "allow", matched: false, reason: "x" }; }',
+            '--golden-trace', '/tmp/trace.json',
+            '--json',
+        ]);
+        expect(captured.opts).not.toBeNull();
+        expect(captured.opts.code).toContain('function evaluate');
+        expect(captured.opts.goldenTrace).toBe('/tmp/trace.json');
+        expect(captured.opts.json).toBe(true);
+    });
+    it('parseAsync rejects replay without --golden-trace (requiredOption)', async () => {
+        const program = freshProgram();
+        registerRulecodeCommand(program);
+        await expect(program.parseAsync([
+            'node', 'pd', 'rulecode', 'replay',
+            '--code', 'function evaluate() {}',
+        ])).rejects.toThrow(/golden-trace/);
+    });
+});
+//# sourceMappingURL=rulecode-flag-wiring.test.js.map

package/dist/commands/__tests__/rulecode-flag-wiring.test.js.map

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

package/dist/commands/__tests__/rulecode-handler.test.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Handler tests for `pd rulecode spec|validate|replay` (PRI-439 Phase 5).
+ *
+ * Tests the actual handler logic (not Commander parser wiring — that's in
+ * rulecode-flag-wiring.test.ts). Verifies:
+ *   - spec returns the canonical RuleCode dialect spec text
+ *   - validate detects forbidden patterns, missing return fields, matched=false
+ *   - validate passes clean code
+ *   - replay runs sandbox replay against a golden trace file
+ *   - failure paths include structured reason + nextAction (CLI gate rule 6)
+ *   - --json outputs exactly one parseable JSON object (CLI gate rule 1)
+ *   - missing --code/--code-file fails loud with reason (ERR-009)
+ *   - missing/malformed --golden-trace fails loud with reason (ERR-009)
+ */
+export {};
+//# sourceMappingURL=rulecode-handler.test.d.ts.map

package/dist/commands/__tests__/rulecode-handler.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rulecode-handler.test.d.ts","sourceRoot":"","sources":["../../../src/commands/__tests__/rulecode-handler.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/commands/__tests__/rulecode-handler.test.js

@@ -0,0 +1,285 @@
+/**
+ * Handler tests for `pd rulecode spec|validate|replay` (PRI-439 Phase 5).
+ *
+ * Tests the actual handler logic (not Commander parser wiring — that's in
+ * rulecode-flag-wiring.test.ts). Verifies:
+ *   - spec returns the canonical RuleCode dialect spec text
+ *   - validate detects forbidden patterns, missing return fields, matched=false
+ *   - validate passes clean code
+ *   - replay runs sandbox replay against a golden trace file
+ *   - failure paths include structured reason + nextAction (CLI gate rule 6)
+ *   - --json outputs exactly one parseable JSON object (CLI gate rule 1)
+ *   - missing --code/--code-file fails loud with reason (ERR-009)
+ *   - missing/malformed --golden-trace fails loud with reason (ERR-009)
+ */
+import { describe, it, expect, vi } from 'vitest';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { handleRulecodeSpec, handleRulecodeValidate, handleRulecodeReplay, } from '../rulecode.js';
+// ── Helpers ──────────────────────────────────────────────────────────────────
+async function runHandler(fn) {
+    const stdoutChunks = [];
+    const stderrChunks = [];
+    const logSpy = vi.spyOn(console, 'log').mockImplementation((...args) => {
+        stdoutChunks.push(args.map(String).join(' '));
+    });
+    const errorSpy = vi.spyOn(console, 'error').mockImplementation((...args) => {
+        stderrChunks.push(args.map(String).join(' '));
+    });
+    process.exitCode = undefined;
+    try {
+        await fn();
+    }
+    finally {
+        logSpy.mockRestore();
+        errorSpy.mockRestore();
+    }
+    const exitCode = process.exitCode;
+    process.exitCode = undefined;
+    return {
+        stdout: stdoutChunks.join(''),
+        stderr: stderrChunks.join(''),
+        exitCode,
+    };
+}
+function parseJson(stdout) {
+    return JSON.parse(stdout);
+}
+const CLEAN_CODE = `function evaluate(input, helpers) {
+  if (helpers.getToolName() === 'Bash') {
+    return { decision: "block", matched: true, reason: "bash commands blocked" };
+  }
+  return { decision: "allow", matched: false, reason: "non-bash allowed" };
+}`;
+const FORBIDDEN_CODE = `function evaluate(input, helpers) {
+  require('fs');
+  return { decision: "allow", matched: false, reason: "x" };
+}`;
+const MISSING_FIELDS_CODE = `function evaluate(input, helpers) {
+  if (helpers.isRiskPath()) {
+    return { matched: true };
+  }
+  return { decision: "allow", matched: false, reason: "safe" };
+}`;
+// ── Tests ────────────────────────────────────────────────────────────────────
+describe('pd rulecode spec', () => {
+    it('returns the canonical spec text as JSON', async () => {
+        const { stdout, exitCode } = await runHandler(() => handleRulecodeSpec({ json: true }));
+        const output = parseJson(stdout);
+        expect(output.status).toBe('ok');
+        expect(output.spec).toContain('RuleCode Dialect Spec');
+        expect(output.spec).toContain('CANONICAL FORM');
+        expect(output.spec).toContain('FORBIDDEN PATTERNS');
+        expect(exitCode).toBeUndefined();
+    });
+    it('outputs text when --json is false', async () => {
+        const { stdout, exitCode } = await runHandler(() => handleRulecodeSpec({ json: false }));
+        expect(stdout).toContain('RuleCode Dialect Spec');
+        expect(stdout.startsWith('{')).toBe(false);
+        expect(exitCode).toBeUndefined();
+    });
+    it('does not set exit code on success', async () => {
+        const { exitCode } = await runHandler(() => handleRulecodeSpec({ json: true }));
+        expect(exitCode).toBeUndefined();
+    });
+});
+describe('pd rulecode validate', () => {
+    it('passes clean code with valid=true', async () => {
+        const { stdout, exitCode } = await runHandler(() => handleRulecodeValidate({ code: CLEAN_CODE, json: true }));
+        const output = parseJson(stdout);
+        expect(output.status).toBe('ok');
+        expect(output.valid).toBe(true);
+        expect(output.violationCount).toBe(0);
+        expect(output.violations).toEqual([]);
+        expect(exitCode).toBeUndefined();
+    });
+    it('detects forbidden patterns', async () => {
+        const { stdout, exitCode } = await runHandler(() => handleRulecodeValidate({ code: FORBIDDEN_CODE, json: true }));
+        const output = parseJson(stdout);
+        expect(output.status).toBe('failed');
+        expect(output.valid).toBe(false);
+        expect(output.violationCount).toBeGreaterThan(0);
+        expect(output.violations.some((v) => v.includes('forbidden pattern'))).toBe(true);
+        expect(output.reason).toBeDefined();
+        expect(output.nextAction).toBeDefined();
+        expect(exitCode).toBe(1);
+    });
+    it('detects missing return fields', async () => {
+        const { stdout, exitCode } = await runHandler(() => handleRulecodeValidate({ code: MISSING_FIELDS_CODE, json: true }));
+        const output = parseJson(stdout);
+        expect(output.valid).toBe(false);
+        expect(output.violations.length).toBeGreaterThan(0);
+        expect(exitCode).toBe(1);
+    });
+    it('fails loud when no --code or --code-file provided', async () => {
+        const { stdout, exitCode } = await runHandler(() => handleRulecodeValidate({ json: true }));
+        const output = parseJson(stdout);
+        expect(output.status).toBe('failed');
+        expect(output.valid).toBe(false);
+        expect(output.reason).toContain('no code provided');
+        expect(output.nextAction).toContain('--code');
+        expect(exitCode).toBe(1);
+    });
+    it('reads code from --code-file', async () => {
+        const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pd-rulecode-test-'));
+        const codeFile = path.join(tmpDir, 'rule.js');
+        fs.writeFileSync(codeFile, CLEAN_CODE, 'utf8');
+        try {
+            const { stdout, exitCode } = await runHandler(() => handleRulecodeValidate({ codeFile, json: true }));
+            const output = parseJson(stdout);
+            expect(output.valid).toBe(true);
+            expect(exitCode).toBeUndefined();
+        }
+        finally {
+            fs.rmSync(tmpDir, { recursive: true, force: true });
+        }
+    });
+    it('fails loud when --code-file does not exist', async () => {
+        const { stdout, exitCode } = await runHandler(() => handleRulecodeValidate({ codeFile: '/nonexistent/path/rule.js', json: true }));
+        const output = parseJson(stdout);
+        expect(output.status).toBe('failed');
+        expect(output.reason).toContain('cannot read');
+        expect(output.nextAction).toBeDefined();
+        expect(exitCode).toBe(1);
+    });
+});
+describe('pd rulecode replay', () => {
+    const GOLDEN_TRACE_CASES = [
+        {
+            caseId: 'pos-1',
+            kind: 'positive',
+            toolName: 'Write',
+            params: { normalizedPath: 'src/safe.ts' },
+            expectedDecision: 'allow',
+        },
+        {
+            caseId: 'neg-1',
+            kind: 'negative',
+            toolName: 'Bash',
+            params: { command: 'rm -rf /' },
+            expectedDecision: 'block',
+        },
+    ];
+    function writeGoldenTraceFile(cases) {
+        const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pd-rulecode-replay-'));
+        const filePath = path.join(tmpDir, 'trace.json');
+        fs.writeFileSync(filePath, JSON.stringify(cases, null, 2), 'utf8');
+        return filePath;
+    }
+    it('passes replay with clean code and valid golden trace', async () => {
+        const traceFile = writeGoldenTraceFile(GOLDEN_TRACE_CASES);
+        try {
+            const { stdout, exitCode } = await runHandler(() => handleRulecodeReplay({ code: CLEAN_CODE, goldenTrace: traceFile, json: true }));
+            const output = parseJson(stdout);
+            expect(output.status).toBe('ok');
+            expect(output.decision).toBe('accepted_shadow');
+            expect(exitCode).toBeUndefined();
+        }
+        finally {
+            fs.rmSync(path.dirname(traceFile), { recursive: true, force: true });
+        }
+    });
+    it('fails loud when --golden-trace file does not exist', async () => {
+        const { stdout, exitCode } = await runHandler(() => handleRulecodeReplay({
+            code: CLEAN_CODE,
+            goldenTrace: '/nonexistent/trace.json',
+            json: true,
+        }));
+        const output = parseJson(stdout);
+        expect(output.status).toBe('failed');
+        expect(output.reason).toContain('cannot read');
+        expect(exitCode).toBe(1);
+    });
+    it('fails loud when golden trace is not valid JSON', async () => {
+        const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pd-rulecode-replay-'));
+        const traceFile = path.join(tmpDir, 'trace.json');
+        fs.writeFileSync(traceFile, '{ not valid json', 'utf8');
+        try {
+            const { stdout, exitCode } = await runHandler(() => handleRulecodeReplay({ code: CLEAN_CODE, goldenTrace: traceFile, json: true }));
+            const output = parseJson(stdout);
+            expect(output.status).toBe('failed');
+            expect(output.reason).toContain('not valid JSON');
+            expect(exitCode).toBe(1);
+        }
+        finally {
+            fs.rmSync(tmpDir, { recursive: true, force: true });
+        }
+    });
+    it('fails loud when golden trace is not an array', async () => {
+        const traceFile = writeGoldenTraceFile({ not: 'an array' });
+        try {
+            const { stdout, exitCode } = await runHandler(() => handleRulecodeReplay({ code: CLEAN_CODE, goldenTrace: traceFile, json: true }));
+            const output = parseJson(stdout);
+            expect(output.status).toBe('failed');
+            expect(output.reason).toContain('must contain a JSON array');
+            expect(exitCode).toBe(1);
+        }
+        finally {
+            fs.rmSync(path.dirname(traceFile), { recursive: true, force: true });
+        }
+    });
+    it('fails loud when golden trace has fewer than 2 cases', async () => {
+        const traceFile = writeGoldenTraceFile([GOLDEN_TRACE_CASES[0]]);
+        try {
+            const { stdout, exitCode } = await runHandler(() => handleRulecodeReplay({ code: CLEAN_CODE, goldenTrace: traceFile, json: true }));
+            const output = parseJson(stdout);
+            expect(output.status).toBe('failed');
+            expect(output.reason).toContain('at least 2 cases');
+            expect(exitCode).toBe(1);
+        }
+        finally {
+            fs.rmSync(path.dirname(traceFile), { recursive: true, force: true });
+        }
+    });
+    it('fails loud when a golden trace case is malformed', async () => {
+        const traceFile = writeGoldenTraceFile([
+            { caseId: 'x' }, // missing required fields
+            GOLDEN_TRACE_CASES[1],
+        ]);
+        try {
+            const { stdout, exitCode } = await runHandler(() => handleRulecodeReplay({ code: CLEAN_CODE, goldenTrace: traceFile, json: true }));
+            const output = parseJson(stdout);
+            expect(output.status).toBe('failed');
+            expect(output.reason).toContain('malformed');
+            expect(exitCode).toBe(1);
+        }
+        finally {
+            fs.rmSync(path.dirname(traceFile), { recursive: true, force: true });
+        }
+    });
+    it('fails loud when no --code or --code-file provided', async () => {
+        const traceFile = writeGoldenTraceFile(GOLDEN_TRACE_CASES);
+        try {
+            const { stdout, exitCode } = await runHandler(() => handleRulecodeReplay({ goldenTrace: traceFile, json: true }));
+            const output = parseJson(stdout);
+            expect(output.status).toBe('failed');
+            expect(output.reason).toContain('no code provided');
+            expect(exitCode).toBe(1);
+        }
+        finally {
+            fs.rmSync(path.dirname(traceFile), { recursive: true, force: true });
+        }
+    });
+    it('reports sandbox failures with structured reason + nextAction', async () => {
+        const traceFile = writeGoldenTraceFile(GOLDEN_TRACE_CASES);
+        // Code with forbidden pattern — sandbox will reject
+        const badCode = `function evaluate(input, helpers) {
+      eval('1');
+      return { decision: "allow", matched: false, reason: "x" };
+    }`;
+        try {
+            const { stdout, exitCode } = await runHandler(() => handleRulecodeReplay({ code: badCode, goldenTrace: traceFile, json: true }));
+            const output = parseJson(stdout);
+            expect(output.status).toBe('failed');
+            expect(output.decision).not.toBe('accepted_shadow');
+            expect(output.reason).toBeDefined();
+            expect(output.nextAction).toBeDefined();
+            expect(exitCode).toBe(1);
+        }
+        finally {
+            fs.rmSync(path.dirname(traceFile), { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=rulecode-handler.test.js.map

package/dist/commands/__tests__/rulecode-handler.test.js.map

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

package/dist/commands/legacy-cleanup.d.ts

@@ -9,19 +9,85 @@
  * - .state/.diagnostician_report_* (archives)
  * - ~/.openclaw/cron/jobs.json (removes pd-empathy-optimizer cron jobs)
  *
+ * PRI-439 Phase 6: V1 Artificer artifact cleanup.
+ * - Identifies V1 artifacts: task_kind=artificer + artifact_kind=principle + no implementationCode
+ * - Preserves V2 artifacts (with implementationCode), pain, Dreamer, Philosopher, Scribe
+ * - --apply deletes activations → approvals → pi_artifacts (in that order, no cascade)
+ * - No V1 runtime reader — V1 artifacts are removed, not interpreted
+ *
  * Usage:
- *   pd legacy cleanup --workspace <path> --dry-run
- *   pd legacy cleanup --workspace <path> --apply
+ *   pd legacy cleanup --workspace <path>                    # dry-run (default)
+ *   pd legacy cleanup --workspace <path> --dry-run          # explicit dry-run
+ *   pd legacy cleanup --workspace <path> --apply            # apply cleanup
+ *   pd legacy cleanup --workspace <path> --apply --json     # apply with JSON output
  */
+import type { Database } from 'better-sqlite3';
 interface CleanupTarget {
     path: string;
     action: 'remove' | 'archive';
     reason: string;
     archivePath?: string;
 }
-export declare function handleLegacyCleanup(workspacePath: string, dryRun: boolean): Promise<{
-    targets: CleanupTarget[];
-    applied: number;
-}>;
+/**
+ * A V1 Artificer artifact identified for cleanup.
+ * - artifactId: pi_artifacts.artifact_id
+ * - sourceTaskId: pi_artifacts.source_task_id (references tasks.task_id with task_kind='artificer')
+ * - approvalCount: number of approvals referencing this artifact
+ * - activationCount: number of activations referencing this artifact
+ */
+export interface V1ArtifactTarget {
+    artifactId: string;
+    sourceTaskId: string;
+    createdAt: string;
+    approvalCount: number;
+    activationCount: number;
+}
+export interface LegacyCleanupOptions {
+    workspacePath: string;
+    /** Dry-run mode (default). Mutually exclusive with `apply`. */
+    dryRun?: boolean;
+    /** Apply mode. Mutually exclusive with `dryRun`. */
+    apply?: boolean;
+    /** Output raw JSON */
+    json?: boolean;
+}
+export interface LegacyCleanupResult {
+    status: 'ok' | 'partial' | 'failed';
+    mode: 'dry-run' | 'apply';
+    fileTargets: CleanupTarget[];
+    v1Artifacts: V1ArtifactTarget[];
+    appliedFiles: number;
+    appliedV1Artifacts: number;
+    appliedApprovals: number;
+    appliedActivations: number;
+    errors: string[];
+    reason?: string;
+    nextAction?: string;
+}
+/**
+ * Returns true if the parsed content_json represents a V1 Artificer output
+ * (i.e., no valid non-empty `implementationCode` string).
+ *
+ * V1 = plan-only acceptance path (removed in PRI-439).
+ * V2 = unified ArtificerRuleOutput with mandatory implementationCode.
+ *
+ * Returns false for:
+ * - V2 artifacts (with non-empty implementationCode string)
+ * - Invalid JSON (skip — do not delete corrupted artifacts)
+ * - null/non-object JSON
+ */
+export declare function isV1ArtificerArtifact(contentJson: string): boolean;
+/**
+ * Queries the SQLite DB for V1 Artificer artifacts.
+ *
+ * V1 criteria:
+ * - pi_artifacts.artifact_kind = 'principle'
+ * - tasks.task_kind = 'artificer' (joined via source_task_id)
+ * - content_json lacks a non-empty implementationCode (checked in JS via isV1ArtificerArtifact)
+ *
+ * Returns the list of V1 artifacts with their approval/activation counts.
+ */
+export declare function findV1ArtificerArtifacts(db: Database): V1ArtifactTarget[];
+export declare function handleLegacyCleanup(opts: LegacyCleanupOptions): Promise<LegacyCleanupResult>;
 export {};
 //# sourceMappingURL=legacy-cleanup.d.ts.map

package/dist/commands/legacy-cleanup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"legacy-cleanup.d.ts","sourceRoot":"","sources":["../../src/commands/legacy-cleanup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAyID,wBAAsB,mBAAmB,CACvC,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC;IAAE,OAAO,EAAE,aAAa,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAwCxD"}
+{"version":3,"file":"legacy-cleanup.d.ts","sourceRoot":"","sources":["../../src/commands/legacy-cleanup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAK/C,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAkBD;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oDAAoD;IACpD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,sBAAsB;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,QAAQ,CAAC;IACpC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;IAC1B,WAAW,EAAE,aAAa,EAAE,CAAC;IAC7B,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CA0BlE;AAaD;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,QAAQ,GAAG,gBAAgB,EAAE,CAmCzE;AA2KD,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAsJlG"}