@principles/pd-cli 1.130.0 → 1.131.0

package/dist/commands/__tests__/intent-flag-wiring.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * PRI-466: pd intent — parser-level flag wiring tests.
+ *
+ * Exercises the real Commander command tree via registerIntentCommand,
+ * verifying option metadata and parser-level dispatch (CLI Operator Gate
+ * rule 7). No handler logic is invoked — actions are captured.
+ */
+export {};
+//# sourceMappingURL=intent-flag-wiring.test.d.ts.map

package/dist/commands/__tests__/intent-flag-wiring.test.d.ts.map

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

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

@@ -0,0 +1,166 @@
+/**
+ * PRI-466: pd intent — parser-level flag wiring tests.
+ *
+ * Exercises the real Commander command tree via registerIntentCommand,
+ * verifying option metadata and parser-level dispatch (CLI Operator Gate
+ * rule 7). No handler logic is invoked — actions are captured.
+ */
+import { describe, it, expect } from 'vitest';
+import { Command } from 'commander';
+import { registerIntentCommand } from '../intent.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;
+            }
+        }
+        state.opts = optsArg && typeof optsArg === 'object' ? optsArg : {};
+    });
+}
+function freshProgram() {
+    const program = new Command();
+    program.name('pd').exitOverride();
+    return program;
+}
+function requireCmd(cmd, name) {
+    if (cmd === undefined) {
+        throw new Error(`Command '${name}' not found in tree`);
+    }
+    return cmd;
+}
+describe('pd intent — command registration', () => {
+    it('registers "intent" command with "init" and "show" subcommands', () => {
+        const program = freshProgram();
+        registerIntentCommand(program);
+        const intentCmd = requireCmd(program.commands.find((c) => c.name() === 'intent'), 'intent');
+        const subNames = intentCmd.commands.map((c) => c.name());
+        expect(subNames).toContain('init');
+        expect(subNames).toContain('show');
+    });
+});
+describe('pd intent init — option metadata', () => {
+    it('has --workspace (-w), --force, --dry-run, --confirm, and --json options', () => {
+        const program = freshProgram();
+        registerIntentCommand(program);
+        const intentCmd = requireCmd(program.commands.find((c) => c.name() === 'intent'), 'intent');
+        const initCmd = requireCmd(intentCmd.commands.find((c) => c.name() === 'init'), 'init');
+        expect(initCmd.options.find((o) => o.long === '--workspace')).toBeDefined();
+        expect(initCmd.options.find((o) => o.long === '--workspace')?.short).toBe('-w');
+        expect(initCmd.options.find((o) => o.long === '--force')).toBeDefined();
+        expect(initCmd.options.find((o) => o.long === '--dry-run')).toBeDefined();
+        expect(initCmd.options.find((o) => o.long === '--confirm')).toBeDefined();
+        expect(initCmd.options.find((o) => o.long === '--json')).toBeDefined();
+    });
+    it('does not register --no-json or --no-force negations', () => {
+        const program = freshProgram();
+        registerIntentCommand(program);
+        const intentCmd = requireCmd(program.commands.find((c) => c.name() === 'intent'), 'intent');
+        const initCmd = requireCmd(intentCmd.commands.find((c) => c.name() === 'init'), 'init');
+        const noJson = initCmd.options.find((o) => o.long === '--no-json');
+        const noForce = initCmd.options.find((o) => o.long === '--no-force');
+        expect(noJson).toBeUndefined();
+        expect(noForce).toBeUndefined();
+    });
+});
+describe('pd intent show — option metadata', () => {
+    it('has --workspace (-w) and --json options, no --force', () => {
+        const program = freshProgram();
+        registerIntentCommand(program);
+        const intentCmd = requireCmd(program.commands.find((c) => c.name() === 'intent'), 'intent');
+        const showCmd = requireCmd(intentCmd.commands.find((c) => c.name() === 'show'), 'show');
+        expect(showCmd.options.find((o) => o.long === '--workspace')).toBeDefined();
+        expect(showCmd.options.find((o) => o.long === '--workspace')?.short).toBe('-w');
+        expect(showCmd.options.find((o) => o.long === '--json')).toBeDefined();
+        expect(showCmd.options.find((o) => o.long === '--force')).toBeUndefined();
+    });
+});
+describe('pd intent init — parser-level dispatch', () => {
+    it('parses --json as true', async () => {
+        const program = freshProgram();
+        const intentCmd = registerIntentCommand(program);
+        const initCmd = requireCmd(intentCmd.commands.find((c) => c.name() === 'init'), 'init');
+        const captured = { opts: null };
+        attachCapture(initCmd, captured);
+        await program.parseAsync(['node', 'pd', 'intent', 'init', '--json']);
+        expect(captured.opts).not.toBeNull();
+        expect(captured.opts?.json).toBe(true);
+    });
+    it('parses --force as true', async () => {
+        const program = freshProgram();
+        const intentCmd = registerIntentCommand(program);
+        const initCmd = requireCmd(intentCmd.commands.find((c) => c.name() === 'init'), 'init');
+        const captured = { opts: null };
+        attachCapture(initCmd, captured);
+        await program.parseAsync(['node', 'pd', 'intent', 'init', '--force']);
+        expect(captured.opts).not.toBeNull();
+        expect(captured.opts?.force).toBe(true);
+    });
+    it('parses -w as --workspace', async () => {
+        const program = freshProgram();
+        const intentCmd = registerIntentCommand(program);
+        const initCmd = requireCmd(intentCmd.commands.find((c) => c.name() === 'init'), 'init');
+        const captured = { opts: null };
+        attachCapture(initCmd, captured);
+        await program.parseAsync(['node', 'pd', 'intent', 'init', '-w', '/tmp/ws']);
+        expect(captured.opts).not.toBeNull();
+        expect(captured.opts?.workspace).toBe('/tmp/ws');
+    });
+    it('defaults json and force to undefined when not passed', async () => {
+        const program = freshProgram();
+        const intentCmd = registerIntentCommand(program);
+        const initCmd = requireCmd(intentCmd.commands.find((c) => c.name() === 'init'), 'init');
+        const captured = { opts: null };
+        attachCapture(initCmd, captured);
+        await program.parseAsync(['node', 'pd', 'intent', 'init']);
+        expect(captured.opts).not.toBeNull();
+        expect(captured.opts?.json).toBeUndefined();
+        expect(captured.opts?.force).toBeUndefined();
+    });
+    it('parses --dry-run as true', async () => {
+        const program = freshProgram();
+        const intentCmd = registerIntentCommand(program);
+        const initCmd = requireCmd(intentCmd.commands.find((c) => c.name() === 'init'), 'init');
+        const captured = { opts: null };
+        attachCapture(initCmd, captured);
+        await program.parseAsync(['node', 'pd', 'intent', 'init', '--dry-run']);
+        expect(captured.opts).not.toBeNull();
+        expect(captured.opts?.dryRun).toBe(true);
+    });
+    it('parses --confirm as true', async () => {
+        const program = freshProgram();
+        const intentCmd = registerIntentCommand(program);
+        const initCmd = requireCmd(intentCmd.commands.find((c) => c.name() === 'init'), 'init');
+        const captured = { opts: null };
+        attachCapture(initCmd, captured);
+        await program.parseAsync(['node', 'pd', 'intent', 'init', '--confirm']);
+        expect(captured.opts).not.toBeNull();
+        expect(captured.opts?.confirm).toBe(true);
+    });
+});
+describe('pd intent show — parser-level dispatch', () => {
+    it('parses --json as true', async () => {
+        const program = freshProgram();
+        const intentCmd = registerIntentCommand(program);
+        const showCmd = requireCmd(intentCmd.commands.find((c) => c.name() === 'show'), 'show');
+        const captured = { opts: null };
+        attachCapture(showCmd, captured);
+        await program.parseAsync(['node', 'pd', 'intent', 'show', '--json']);
+        expect(captured.opts).not.toBeNull();
+        expect(captured.opts?.json).toBe(true);
+    });
+    it('parses -w as --workspace', async () => {
+        const program = freshProgram();
+        const intentCmd = registerIntentCommand(program);
+        const showCmd = requireCmd(intentCmd.commands.find((c) => c.name() === 'show'), 'show');
+        const captured = { opts: null };
+        attachCapture(showCmd, captured);
+        await program.parseAsync(['node', 'pd', 'intent', 'show', '-w', '/tmp/ws']);
+        expect(captured.opts).not.toBeNull();
+        expect(captured.opts?.workspace).toBe('/tmp/ws');
+    });
+});
+//# sourceMappingURL=intent-flag-wiring.test.js.map

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

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

package/dist/commands/intent.d.ts

@@ -0,0 +1,59 @@
+/**
+ * pd intent — Owner-authored INTENT.md management (PRI-466).
+ *
+ * Subcommands:
+ *   - init : create .principles/INTENT.md from the canonical template
+ *   - show : display a read-only summary of INTENT.md (sections, hash, warnings)
+ *
+ * `init` is not gated by the intent_engineering flag — the Owner can
+ * initialise the intent doc at any time. `show` IS gated: flag-off returns
+ * a structured `flag_disabled` result without touching the filesystem,
+ * matching the Console backend contract.
+ *
+ * JSON mode is strict: --json outputs exactly one parseable JSON object on
+ * stdout (CLI Operator Gate rule 1). Failure paths include structured
+ * reason + nextAction (rule 6).
+ *
+ * ERR refs:
+ *   - ERR-001 (no any): all types explicit
+ *   - ERR-005 (no as bypass): no type casts on untrusted data
+ *   - ERR-002 (graceful degradation with reason): all failure paths include
+ *     reason + nextAction
+ *   - ERR-009 (fail loud): missing file / flag-off surfaced explicitly
+ */
+import type { Command } from 'commander';
+import type { IntentDocWarning } from '@principles/core/runtime-v2';
+export interface IntentInitOutput {
+    status: 'ok' | 'skipped' | 'dry_run' | 'read_error';
+    path: string;
+    overwritten: boolean;
+    reason?: string;
+    nextAction?: string;
+}
+export interface IntentShowOutput {
+    status: 'ok' | 'flag_disabled' | 'not_found' | 'oversized' | 'read_error';
+    flagEnabled: boolean;
+    found: boolean;
+    path?: string;
+    contentHash?: string;
+    lastEditedAt?: string;
+    sections?: Record<string, string>;
+    warnings: IntentDocWarning[];
+    reason?: string;
+    nextAction?: string;
+}
+export interface IntentInitOptions {
+    workspace?: string;
+    force?: boolean;
+    json?: boolean;
+    dryRun?: boolean;
+    confirm?: boolean;
+}
+export declare function handleIntentInit(opts: IntentInitOptions): Promise<void>;
+export interface IntentShowOptions {
+    workspace?: string;
+    json?: boolean;
+}
+export declare function handleIntentShow(opts: IntentShowOptions): Promise<void>;
+export declare function registerIntentCommand(parentCmd: Command): Command;
+//# sourceMappingURL=intent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../src/commands/intent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASzC,OAAO,KAAK,EAAqB,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAYvF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,SAAS,GAAG,YAAY,CAAC;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,IAAI,GAAG,eAAe,GAAG,WAAW,GAAG,WAAW,GAAG,YAAY,CAAC;IAC1E,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA4CD,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2G7E;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmH7E;AAID,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAoCjE"}

package/dist/commands/intent.js

@@ -0,0 +1,350 @@
+/**
+ * pd intent — Owner-authored INTENT.md management (PRI-466).
+ *
+ * Subcommands:
+ *   - init : create .principles/INTENT.md from the canonical template
+ *   - show : display a read-only summary of INTENT.md (sections, hash, warnings)
+ *
+ * `init` is not gated by the intent_engineering flag — the Owner can
+ * initialise the intent doc at any time. `show` IS gated: flag-off returns
+ * a structured `flag_disabled` result without touching the filesystem,
+ * matching the Console backend contract.
+ *
+ * JSON mode is strict: --json outputs exactly one parseable JSON object on
+ * stdout (CLI Operator Gate rule 1). Failure paths include structured
+ * reason + nextAction (rule 6).
+ *
+ * ERR refs:
+ *   - ERR-001 (no any): all types explicit
+ *   - ERR-005 (no as bypass): no type casts on untrusted data
+ *   - ERR-002 (graceful degradation with reason): all failure paths include
+ *     reason + nextAction
+ *   - ERR-009 (fail loud): missing file / flag-off surfaced explicitly
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { INTENT_MAX_BYTES, INTENT_DOC_TEMPLATE, parseIntentDocSections, computeIntentContentHash, validateIntentDocSections, isFeatureEnabled, } from '@principles/core/runtime-v2';
+import { resolveWorkspaceDir } from '../resolve-workspace.js';
+import { loadPdConfig, computeFlagsFromLoadResult } from '../services/pd-config-loader.js';
+import { emitResult } from '../services/cli-output.js';
+// ── Constants ────────────────────────────────────────────────────────────────
+const INTENT_DIR = '.principles';
+const INTENT_FILENAME = 'INTENT.md';
+// ── Helpers ──────────────────────────────────────────────────────────────────
+function getIntentFilePath(workspaceDir) {
+    return path.join(workspaceDir, INTENT_DIR, INTENT_FILENAME);
+}
+function sectionsToRecord(sections) {
+    const record = {};
+    if (sections.why !== undefined) {
+        record.why = sections.why;
+    }
+    if (sections.desiredOutcome !== undefined) {
+        record.desiredOutcome = sections.desiredOutcome;
+    }
+    if (sections.nonNegotiables !== undefined) {
+        record.nonNegotiables = sections.nonNegotiables;
+    }
+    if (sections.stopEscalation !== undefined) {
+        record.stopEscalation = sections.stopEscalation;
+    }
+    if (sections.currentStrategicFocus !== undefined) {
+        record.currentStrategicFocus = sections.currentStrategicFocus;
+    }
+    return record;
+}
+function formatIntentShowText(o) {
+    const lines = [];
+    lines.push(`INTENT.md — ${o.path}`);
+    lines.push(`Content hash: ${o.contentHash}`);
+    lines.push(`Last edited:  ${o.lastEditedAt}`);
+    lines.push('');
+    if (o.sections) {
+        if (o.sections.why) {
+            lines.push('## 1. Why');
+            lines.push(o.sections.why);
+            lines.push('');
+        }
+        if (o.sections.desiredOutcome) {
+            lines.push('## 2. Desired Outcome');
+            lines.push(o.sections.desiredOutcome);
+            lines.push('');
+        }
+        if (o.sections.nonNegotiables) {
+            lines.push('## 3. Non-negotiables');
+            lines.push(o.sections.nonNegotiables);
+            lines.push('');
+        }
+        if (o.sections.stopEscalation) {
+            lines.push('## 4. Stop / Escalation');
+            lines.push(o.sections.stopEscalation);
+            lines.push('');
+        }
+        if (o.sections.currentStrategicFocus) {
+            lines.push('## 5. Current Strategic Focus');
+            lines.push(o.sections.currentStrategicFocus);
+            lines.push('');
+        }
+    }
+    if (o.warnings.length > 0) {
+        lines.push('Warnings:');
+        for (const w of o.warnings) {
+            lines.push(`  [${w.code}] ${w.message}`);
+        }
+    }
+    else {
+        lines.push('No warnings.');
+    }
+    return lines.join('\n');
+}
+export async function handleIntentInit(opts) {
+    // CLI Gate rule 4: --dry-run and --confirm must be mutually exclusive.
+    if (opts.dryRun && opts.confirm) {
+        const output = {
+            status: 'skipped',
+            path: '',
+            overwritten: false,
+            reason: 'flag_conflict',
+            nextAction: 'Use either --dry-run or --confirm, not both.',
+        };
+        emitResult(output, {
+            json: opts.json ?? false,
+            formatText: (o) => `Error: ${o.reason}\n→ ${o.nextAction}`,
+        });
+        process.exitCode = 1;
+        return;
+    }
+    // CLI Gate rule 6: workspace resolution inside try/catch so failures emit
+    // structured JSON with reason + nextAction instead of an uncaught stack trace.
+    let workspaceDir;
+    let filePath;
+    let dir;
+    try {
+        workspaceDir = resolveWorkspaceDir(opts.workspace);
+        filePath = getIntentFilePath(workspaceDir);
+        dir = path.dirname(filePath);
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        const output = {
+            status: 'read_error',
+            path: '',
+            overwritten: false,
+            reason,
+            nextAction: 'Provide a valid --workspace <path> argument.',
+        };
+        emitResult(output, {
+            json: opts.json ?? false,
+            formatText: (o) => `Error: ${o.reason}\n→ ${o.nextAction}`,
+        });
+        process.exitCode = 1;
+        return;
+    }
+    // CLI Gate rule 4: state-mutating command defaults to dry-run unless --confirm.
+    const isDryRun = opts.dryRun === true || opts.confirm !== true;
+    try {
+        if (fs.existsSync(filePath) && !opts.force) {
+            const output = {
+                status: 'skipped',
+                path: filePath,
+                overwritten: false,
+                reason: 'file_exists',
+                nextAction: `Use --force to overwrite: pd intent init --force --confirm --workspace "${workspaceDir}"`,
+            };
+            emitResult(output, {
+                json: opts.json ?? false,
+                formatText: (o) => `INTENT.md already exists at ${o.path}\n→ ${o.nextAction}`,
+            });
+            process.exitCode = 1;
+            return;
+        }
+        if (isDryRun) {
+            const output = {
+                status: 'dry_run',
+                path: filePath,
+                overwritten: opts.force === true,
+                reason: 'dry_run',
+                nextAction: `Confirm write: pd intent init --confirm${opts.force ? ' --force' : ''} --workspace "${workspaceDir}"`,
+            };
+            emitResult(output, {
+                json: opts.json ?? false,
+                formatText: (o) => `[dry-run] Would create INTENT.md at ${o.path}${o.overwritten ? ' (overwritten)' : ''}\n→ ${o.nextAction}`,
+            });
+            return;
+        }
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(filePath, INTENT_DOC_TEMPLATE, 'utf8');
+        const output = {
+            status: 'ok',
+            path: filePath,
+            overwritten: opts.force === true,
+        };
+        emitResult(output, {
+            json: opts.json ?? false,
+            formatText: (o) => `Created INTENT.md at ${o.path}${o.overwritten ? ' (overwritten)' : ''}\nNext: edit the file to declare your project intent, then run "pd intent show".`,
+        });
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        // CLI Gate rule 1: route through emitResult for consistent IntentInitOutput shape.
+        const output = {
+            status: 'read_error',
+            path: filePath,
+            overwritten: false,
+            reason,
+            nextAction: `Check filesystem permissions for ${filePath}`,
+        };
+        emitResult(output, {
+            json: opts.json ?? false,
+            formatText: (o) => `Error: ${o.reason}\n→ ${o.nextAction}`,
+        });
+        process.exitCode = 1;
+    }
+}
+export async function handleIntentShow(opts) {
+    // CLI Gate rule 6: workspace resolution inside try/catch for structured errors.
+    let workspaceDir;
+    try {
+        workspaceDir = resolveWorkspaceDir(opts.workspace);
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        const output = {
+            status: 'read_error',
+            flagEnabled: false,
+            found: false,
+            warnings: [],
+            reason,
+            nextAction: 'Provide a valid --workspace <path> argument.',
+        };
+        emitResult(output, {
+            json: opts.json ?? false,
+            formatText: (o) => `Error: ${o.reason}\n→ ${o.nextAction}`,
+        });
+        process.exitCode = 1;
+        return;
+    }
+    // Flag check — flag-off short-circuits without fs access
+    const configResult = loadPdConfig(workspaceDir);
+    const flagsResult = computeFlagsFromLoadResult(configResult);
+    const flagEnabled = isFeatureEnabled(flagsResult, 'intent_engineering');
+    if (!flagEnabled) {
+        const output = {
+            status: 'flag_disabled',
+            flagEnabled: false,
+            found: false,
+            warnings: [],
+            reason: 'flag_disabled',
+            nextAction: 'Enable the intent_engineering feature flag in .pd/config.yaml to read INTENT.md.',
+        };
+        emitResult(output, {
+            json: opts.json ?? false,
+            formatText: (o) => `Intent Engineering is disabled (flag off).\n→ ${o.nextAction}`,
+        });
+        return;
+    }
+    const filePath = getIntentFilePath(workspaceDir);
+    try {
+        if (!fs.existsSync(filePath)) {
+            const output = {
+                status: 'not_found',
+                flagEnabled: true,
+                found: false,
+                warnings: [],
+                reason: 'not_found',
+                nextAction: `Create INTENT.md: pd intent init --workspace "${workspaceDir}"`,
+            };
+            emitResult(output, {
+                json: opts.json ?? false,
+                formatText: (o) => `INTENT.md not found.\n→ ${o.nextAction}`,
+            });
+            return;
+        }
+        const stat = fs.statSync(filePath);
+        if (stat.size > INTENT_MAX_BYTES) {
+            const output = {
+                status: 'oversized',
+                flagEnabled: true,
+                found: true,
+                warnings: [],
+                reason: 'oversized',
+                nextAction: `INTENT.md exceeds ${INTENT_MAX_BYTES} bytes (${stat.size} bytes). Reduce content.`,
+            };
+            emitResult(output, {
+                json: opts.json ?? false,
+                formatText: (o) => `INTENT.md is too large.\n→ ${o.nextAction}`,
+            });
+            return;
+        }
+        const raw = fs.readFileSync(filePath, 'utf8');
+        const sections = parseIntentDocSections(raw);
+        const warnings = validateIntentDocSections(sections);
+        const contentHash = computeIntentContentHash(raw);
+        const output = {
+            status: 'ok',
+            flagEnabled: true,
+            found: true,
+            path: filePath,
+            contentHash,
+            lastEditedAt: stat.mtime.toISOString(),
+            sections: sectionsToRecord(sections),
+            warnings,
+        };
+        emitResult(output, {
+            json: opts.json ?? false,
+            formatText: (o) => formatIntentShowText(o),
+        });
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        const output = {
+            status: 'read_error',
+            flagEnabled: true,
+            found: false,
+            warnings: [],
+            reason,
+            nextAction: `Check filesystem permissions for ${filePath}`,
+        };
+        emitResult(output, {
+            json: opts.json ?? false,
+            formatText: (o) => `Error reading INTENT.md: ${o.reason}\n→ ${o.nextAction}`,
+        });
+        process.exitCode = 1;
+    }
+}
+// ── Command registration ─────────────────────────────────────────────────────
+export function registerIntentCommand(parentCmd) {
+    const intentCmd = parentCmd
+        .command('intent')
+        .description('Owner-authored INTENT.md management (init, show)');
+    intentCmd
+        .command('init')
+        .description('Create .principles/INTENT.md from the canonical template')
+        .option('-w, --workspace <path>', 'Workspace directory')
+        .option('--force', 'Overwrite existing INTENT.md')
+        .option('--dry-run', 'Show what would happen without writing (default)')
+        .option('--confirm', 'Actually write the file (required to create INTENT.md)')
+        .option('--json', 'Output raw JSON')
+        .action(async (opts) => {
+        await handleIntentInit({
+            workspace: opts.workspace,
+            force: opts.force === true,
+            json: opts.json === true,
+            dryRun: opts.dryRun === true,
+            confirm: opts.confirm === true,
+        });
+    });
+    intentCmd
+        .command('show')
+        .description('Display a read-only summary of INTENT.md (sections, hash, warnings)')
+        .option('-w, --workspace <path>', 'Workspace directory')
+        .option('--json', 'Output raw JSON')
+        .action(async (opts) => {
+        await handleIntentShow({
+            workspace: opts.workspace,
+            json: opts.json === true,
+        });
+    });
+    return intentCmd;
+}
+//# sourceMappingURL=intent.js.map

package/dist/commands/intent.js.map

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

package/dist/index.js

@@ -52,6 +52,7 @@ import { handleRuntimeFeaturesStatus } from './commands/runtime-features.js';
 import { handleConfigDoctor } from './commands/config-doctor.js';
 import { registerMvpCommands } from './commands/mvp-smoke.js';
 import { registerRulecodeCommand } from './commands/rulecode.js';
+import { registerIntentCommand } from './commands/intent.js';
 import { createRequire } from 'module';
 const require = createRequire(import.meta.url);
 const pkg = require('../package.json');
@@ -862,6 +863,9 @@ registerMvpCommands(program);
 // ─── RuleCode CLI (PRI-439 Phase 5) ─────────────────────────────────────────
 // Read-only commands: spec, validate, replay. No DB mutation, no artifact writes.
 registerRulecodeCommand(program);
+// ─── Intent Engineering (PRI-466) ───────────────────────────────────────────
+// Owner-authored INTENT.md management: init (create), show (read-only summary).
+registerIntentCommand(program);
 const consoleCmd = program
     .command('console')
     .description('Start the pd-console web UI for principle review (default: fallback launcher)')