@proletariat/cli 0.1.4 → 0.3.0

package/dist/commands/spec/link/duplicates.js

@@ -0,0 +1,63 @@
+import { Args, Flags } from '@oclif/core';
+import inquirer from 'inquirer';
+import { PMOCommand, pmoBaseFlags } from '../../../lib/pmo/index.js';
+import { styles } from '../../../lib/styles.js';
+import { shouldOutputJson, outputPromptAsJson, outputErrorAsJson, createMetadata, buildPromptConfig, } from '../../../lib/prompt-json.js';
+export default class SpecLinkDuplicates extends PMOCommand {
+    static description = 'Mark a spec as duplicate of another';
+    static examples = ['<%= config.bin %> <%= command.id %> my-feature other-spec'];
+    static args = {
+        id: Args.string({ description: 'Duplicate spec ID', required: true }),
+        original: Args.string({ description: 'Original spec ID', required: false }),
+    };
+    static flags = {
+        ...pmoBaseFlags,
+        json: Flags.boolean({
+            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
+            default: false,
+        }),
+    };
+    async execute() {
+        const { args, flags } = await this.parse(SpecLinkDuplicates);
+        // Check if JSON output mode is active
+        const jsonMode = shouldOutputJson(flags);
+        // Helper to handle errors in JSON mode
+        const handleError = (code, message) => {
+            if (jsonMode) {
+                outputErrorAsJson(code, message, createMetadata('spec link duplicates', flags));
+                this.exit(1);
+            }
+            this.error(message);
+        };
+        const spec = await this.storage.getSpec(args.id);
+        if (!spec)
+            return handleError('SPEC_NOT_FOUND', `Spec not found: ${args.id}`);
+        let originalId = args.original;
+        if (!originalId) {
+            const allSpecs = await this.storage.listSpecs();
+            const otherSpecs = allSpecs.filter(s => s.id !== args.id);
+            if (otherSpecs.length === 0) {
+                if (jsonMode) {
+                    outputErrorAsJson('NO_OTHER_SPECS', 'No other specs.', createMetadata('spec link duplicates', flags));
+                    return;
+                }
+                this.log(styles.muted('\nNo other specs.'));
+                return;
+            }
+            // In JSON mode, output spec selection prompt
+            if (jsonMode) {
+                const specChoices = otherSpecs.map(s => ({ name: `${s.id} - ${s.title}`, value: s.id }));
+                outputPromptAsJson(buildPromptConfig('list', 'original', `Select the original spec (${args.id} is a duplicate of):`, specChoices), createMetadata('spec link duplicates', flags));
+                return;
+            }
+            const { selected } = await inquirer.prompt([{ type: 'list', name: 'selected', message: `Select the original spec (${args.id} is a duplicate of):`,
+                    choices: otherSpecs.map(s => ({ name: `${s.id} - ${s.title}`, value: s.id })) }]);
+            originalId = selected;
+        }
+        const originalSpec = await this.storage.getSpec(originalId);
+        if (!originalSpec)
+            this.error(`Spec not found: ${originalId}`);
+        await this.storage.createSpecDependency(args.id, originalId, 'duplicates');
+        this.log(styles.success(`\n✅ ${styles.emphasis(args.id)} duplicates ${styles.emphasis(originalId)}`));
+    }
+}

package/dist/commands/spec/link/index.d.ts

@@ -0,0 +1,19 @@
+import { PMOCommand } from '../../../lib/pmo/index.js';
+export default class SpecLink extends PMOCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        depends: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        relates: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        duplicates: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        all: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    execute(): Promise<void>;
+    private addDependency;
+    private viewDependencies;
+}

package/dist/commands/spec/link/index.js

@@ -0,0 +1,200 @@
+import { Args, Flags } from '@oclif/core';
+import inquirer from 'inquirer';
+import { PMOCommand, pmoBaseFlags } from '../../../lib/pmo/index.js';
+import { styles } from '../../../lib/styles.js';
+import { shouldOutputJson, outputPromptAsJson, outputErrorAsJson, createMetadata, buildPromptConfig, } from '../../../lib/prompt-json.js';
+export default class SpecLink extends PMOCommand {
+    static description = 'Manage spec dependencies (links)';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> my-feature                      # List dependencies',
+        '<%= config.bin %> <%= command.id %> my-feature --depends other-spec # my-feature depends on other-spec',
+        '<%= config.bin %> <%= command.id %> my-feature --relates other-spec # my-feature relates to other-spec',
+        '<%= config.bin %> <%= command.id %> my-feature --duplicates other-spec',
+        '<%= config.bin %> <%= command.id %> my-feature --all                # Show all links',
+    ];
+    static args = {
+        id: Args.string({ description: 'Spec ID', required: false }),
+    };
+    static flags = {
+        ...pmoBaseFlags,
+        json: Flags.boolean({
+            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
+            default: false,
+        }),
+        depends: Flags.string({ char: 'd', description: 'Add depends_on dependency' }),
+        relates: Flags.string({ char: 'r', description: 'Add relates_to dependency' }),
+        duplicates: Flags.string({ description: 'Add duplicates dependency' }),
+        all: Flags.boolean({ char: 'a', description: 'Show all dependencies', default: false }),
+    };
+    async execute() {
+        const { args, flags } = await this.parse(SpecLink);
+        // Check if JSON output mode is active
+        const jsonMode = shouldOutputJson(flags);
+        let specId = args.id;
+        if (!specId) {
+            const specs = await this.storage.listSpecs();
+            if (specs.length === 0) {
+                if (jsonMode) {
+                    outputErrorAsJson('NO_SPECS', 'No specs found.', createMetadata('spec link', flags));
+                    return;
+                }
+                this.log(styles.muted('\nNo specs found.'));
+                return;
+            }
+            // In JSON mode, output spec selection prompt
+            if (jsonMode) {
+                const specChoices = specs.map(s => ({ name: `${s.id} - ${s.title}`, value: s.id }));
+                outputPromptAsJson(buildPromptConfig('list', 'id', 'Select spec to manage dependencies:', specChoices), createMetadata('spec link', flags));
+                return;
+            }
+            const { selected } = await inquirer.prompt([{
+                    type: 'list',
+                    name: 'selected',
+                    message: 'Select spec to manage dependencies:',
+                    choices: specs.map(s => ({ name: `${s.id} - ${s.title}`, value: s.id })),
+                }]);
+            specId = selected;
+        }
+        const spec = await this.storage.getSpec(specId);
+        if (!spec)
+            this.error(`Spec not found: ${specId}`);
+        // If a dependency flag is provided, add the dependency directly
+        if (flags.depends || flags.relates || flags.duplicates) {
+            const targetId = flags.depends || flags.relates || flags.duplicates;
+            const dependencyType = flags.depends ? 'depends_on' :
+                flags.relates ? 'relates_to' : 'duplicates';
+            await this.addDependency(specId, targetId, dependencyType, spec.title);
+            return;
+        }
+        // Interactive mode: show menu in a loop
+        let continueLoop = true;
+        while (continueLoop) {
+            const allSpecs = await this.storage.listSpecs();
+            const otherSpecs = allSpecs.filter(s => s.id !== specId);
+            const { action } = await inquirer.prompt([{
+                    type: 'list',
+                    name: 'action',
+                    message: `Dependencies for ${spec.id}:`,
+                    choices: [
+                        { name: 'View dependencies', value: 'view' },
+                        { name: 'Add depends_on dependency', value: 'depends_on' },
+                        { name: 'Add relates_to dependency', value: 'relates_to' },
+                        { name: 'Add duplicates dependency', value: 'duplicates' },
+                        new inquirer.Separator(),
+                        { name: 'Remove dependency', value: 'remove' },
+                        { name: 'Done', value: 'done' },
+                    ],
+                }]);
+            if (action === 'done') {
+                continueLoop = false;
+                continue;
+            }
+            if (action === 'view') {
+                await this.viewDependencies(specId, spec, flags.all);
+                continue;
+            }
+            if (action === 'remove') {
+                const dependencies = await this.storage.listSpecDependencies(specId);
+                if (dependencies.length === 0) {
+                    this.log(styles.muted('\nNo dependencies to remove.'));
+                    continue;
+                }
+                const choices = await Promise.all(dependencies.map(async (dep) => {
+                    const depSpec = await this.storage.getSpec(dep.dependsOnSpecId);
+                    return {
+                        name: `${dep.dependsOnSpecId} - ${depSpec?.title || 'Unknown'} (${dep.dependencyType})`,
+                        value: { targetId: dep.dependsOnSpecId, type: dep.dependencyType }
+                    };
+                }));
+                const { selected } = await inquirer.prompt([{
+                        type: 'list',
+                        name: 'selected',
+                        message: 'Select dependency to remove:',
+                        choices,
+                    }]);
+                await this.storage.deleteSpecDependency(specId, selected.targetId, selected.type);
+                this.log(styles.success(`\n✅ Removed dependency: ${specId} → ${selected.targetId}`));
+                continue;
+            }
+            // Add dependency
+            if (otherSpecs.length === 0) {
+                this.log(styles.muted('\nNo other specs to link to.'));
+                continue;
+            }
+            const { targetId } = await inquirer.prompt([{
+                    type: 'list',
+                    name: 'targetId',
+                    message: `Select spec that ${specId} ${action === 'depends_on' ? 'depends on' : action === 'relates_to' ? 'relates to' : 'duplicates'}:`,
+                    choices: otherSpecs.map(s => ({ name: `${s.id} - ${s.title}`, value: s.id })),
+                }]);
+            await this.addDependency(specId, targetId, action, spec.title);
+        }
+    }
+    async addDependency(specId, targetId, dependencyType, specTitle) {
+        const targetSpec = await this.storage.getSpec(targetId);
+        if (!targetSpec) {
+            this.error(`Spec not found: ${targetId}`);
+        }
+        try {
+            await this.storage.createSpecDependency(specId, targetId, dependencyType);
+            const typeLabel = dependencyType === 'depends_on' ? 'depends on' :
+                dependencyType === 'relates_to' ? 'relates to' : 'duplicates';
+            this.log(styles.success(`\n✅ ${styles.emphasis(specId)} ${typeLabel} ${styles.emphasis(targetId)}`));
+            this.log(styles.muted(`   ${specTitle}`));
+            this.log(styles.muted(`   ${typeLabel} ${targetSpec.title}`));
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                if (error.message.includes('already exists')) {
+                    this.error('Dependency already exists');
+                }
+                if (error.message.includes('self-dependency')) {
+                    this.error('Cannot create self-dependency');
+                }
+            }
+            throw error;
+        }
+    }
+    async viewDependencies(specId, spec, showAll) {
+        const dependencies = await this.storage.listSpecDependencies(specId);
+        this.log(`\n${styles.emphasis(spec.id)}: ${spec.title}`);
+        const dependsOn = dependencies.filter(d => d.dependencyType === 'depends_on');
+        if (dependsOn.length > 0) {
+            this.log(styles.muted('\n  Depends on:'));
+            for (const dep of dependsOn) {
+                const depSpec = await this.storage.getSpec(dep.dependsOnSpecId);
+                if (depSpec)
+                    this.log(`    - ${depSpec.id}: ${depSpec.title}`);
+            }
+        }
+        const otherDeps = dependencies.filter(d => d.dependencyType !== 'depends_on');
+        if (otherDeps.length > 0) {
+            this.log(styles.muted('\n  Related:'));
+            for (const dep of otherDeps) {
+                const relatedSpec = await this.storage.getSpec(dep.dependsOnSpecId);
+                if (relatedSpec)
+                    this.log(`    - ${dep.dependencyType}: ${relatedSpec.id} - ${relatedSpec.title}`);
+            }
+        }
+        if (showAll) {
+            const allSpecs = await this.storage.listSpecs();
+            const dependedBy = [];
+            for (const otherSpec of allSpecs) {
+                if (otherSpec.id === specId)
+                    continue;
+                const otherDeps = await this.storage.listSpecDependencies(otherSpec.id);
+                const dep = otherDeps.find(d => d.dependsOnSpecId === specId);
+                if (dep)
+                    dependedBy.push({ spec: otherSpec, type: dep.dependencyType });
+            }
+            if (dependedBy.length > 0) {
+                this.log(styles.muted('\n  Depended by:'));
+                for (const { spec: depSpec, type } of dependedBy)
+                    this.log(`    - ${depSpec.id}: ${depSpec.title} (${type})`);
+            }
+        }
+        if (dependencies.length === 0)
+            this.log(styles.muted('\n  No dependencies.'));
+        this.log('');
+    }
+}

package/dist/commands/spec/link/relates.d.ts

@@ -0,0 +1,14 @@
+import { PMOCommand } from '../../../lib/pmo/index.js';
+export default class SpecLinkRelates extends PMOCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        target: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    execute(): Promise<void>;
+}

package/dist/commands/spec/link/relates.js

@@ -0,0 +1,63 @@
+import { Args, Flags } from '@oclif/core';
+import inquirer from 'inquirer';
+import { PMOCommand, pmoBaseFlags } from '../../../lib/pmo/index.js';
+import { styles } from '../../../lib/styles.js';
+import { shouldOutputJson, outputPromptAsJson, outputErrorAsJson, createMetadata, buildPromptConfig, } from '../../../lib/prompt-json.js';
+export default class SpecLinkRelates extends PMOCommand {
+    static description = 'Add a relates_to dependency (informational link)';
+    static examples = ['<%= config.bin %> <%= command.id %> my-feature other-spec'];
+    static args = {
+        id: Args.string({ description: 'Spec ID', required: true }),
+        target: Args.string({ description: 'Related spec ID', required: false }),
+    };
+    static flags = {
+        ...pmoBaseFlags,
+        json: Flags.boolean({
+            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
+            default: false,
+        }),
+    };
+    async execute() {
+        const { args, flags } = await this.parse(SpecLinkRelates);
+        // Check if JSON output mode is active
+        const jsonMode = shouldOutputJson(flags);
+        // Helper to handle errors in JSON mode
+        const handleError = (code, message) => {
+            if (jsonMode) {
+                outputErrorAsJson(code, message, createMetadata('spec link relates', flags));
+                this.exit(1);
+            }
+            this.error(message);
+        };
+        const spec = await this.storage.getSpec(args.id);
+        if (!spec)
+            return handleError('SPEC_NOT_FOUND', `Spec not found: ${args.id}`);
+        let targetId = args.target;
+        if (!targetId) {
+            const allSpecs = await this.storage.listSpecs();
+            const otherSpecs = allSpecs.filter(s => s.id !== args.id);
+            if (otherSpecs.length === 0) {
+                if (jsonMode) {
+                    outputErrorAsJson('NO_OTHER_SPECS', 'No other specs.', createMetadata('spec link relates', flags));
+                    return;
+                }
+                this.log(styles.muted('\nNo other specs.'));
+                return;
+            }
+            // In JSON mode, output spec selection prompt
+            if (jsonMode) {
+                const specChoices = otherSpecs.map(s => ({ name: `${s.id} - ${s.title}`, value: s.id }));
+                outputPromptAsJson(buildPromptConfig('list', 'target', `Select spec that ${args.id} relates to:`, specChoices), createMetadata('spec link relates', flags));
+                return;
+            }
+            const { selected } = await inquirer.prompt([{ type: 'list', name: 'selected', message: `Select spec that ${args.id} relates to:`,
+                    choices: otherSpecs.map(s => ({ name: `${s.id} - ${s.title}`, value: s.id })) }]);
+            targetId = selected;
+        }
+        const targetSpec = await this.storage.getSpec(targetId);
+        if (!targetSpec)
+            this.error(`Spec not found: ${targetId}`);
+        await this.storage.createSpecDependency(args.id, targetId, 'relates_to');
+        this.log(styles.success(`\n✅ ${styles.emphasis(args.id)} relates to ${styles.emphasis(targetId)}`));
+    }
+}

package/dist/commands/spec/link/remove.d.ts

@@ -0,0 +1,16 @@
+import { PMOCommand } from '../../../lib/pmo/index.js';
+export default class SpecLinkRemove extends PMOCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        target: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        type: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        all: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    execute(): Promise<void>;
+}

package/dist/commands/spec/link/remove.js

@@ -0,0 +1,94 @@
+import { Args, Flags } from '@oclif/core';
+import inquirer from 'inquirer';
+import { PMOCommand, pmoBaseFlags } from '../../../lib/pmo/index.js';
+import { styles } from '../../../lib/styles.js';
+import { shouldOutputJson, outputPromptAsJson, outputErrorAsJson, createMetadata, buildPromptConfig, } from '../../../lib/prompt-json.js';
+export default class SpecLinkRemove extends PMOCommand {
+    static description = 'Remove a dependency from a spec';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> my-feature other-spec',
+        '<%= config.bin %> <%= command.id %> my-feature --all',
+    ];
+    static args = {
+        id: Args.string({ description: 'Spec ID', required: true }),
+        target: Args.string({ description: 'Target spec ID to unlink', required: false }),
+    };
+    static flags = {
+        ...pmoBaseFlags,
+        json: Flags.boolean({
+            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
+            default: false,
+        }),
+        type: Flags.string({ char: 't', description: 'Dependency type', options: ['depends_on', 'relates_to', 'duplicates'] }),
+        all: Flags.boolean({ char: 'a', description: 'Remove all dependencies', default: false }),
+    };
+    async execute() {
+        const { args, flags } = await this.parse(SpecLinkRemove);
+        // Check if JSON output mode is active
+        const jsonMode = shouldOutputJson(flags);
+        // Helper to handle errors in JSON mode
+        const handleError = (code, message) => {
+            if (jsonMode) {
+                outputErrorAsJson(code, message, createMetadata('spec link remove', flags));
+                this.exit(1);
+            }
+            this.error(message);
+        };
+        const spec = await this.storage.getSpec(args.id);
+        if (!spec)
+            return handleError('SPEC_NOT_FOUND', `Spec not found: ${args.id}`);
+        const dependencies = await this.storage.listSpecDependencies(args.id);
+        if (dependencies.length === 0) {
+            if (jsonMode) {
+                outputErrorAsJson('NO_DEPENDENCIES', `Spec ${args.id} has no dependencies.`, createMetadata('spec link remove', flags));
+                return;
+            }
+            this.log(styles.muted(`\nSpec ${args.id} has no dependencies.`));
+            return;
+        }
+        if (flags.all) {
+            // In JSON mode, output confirmation prompt
+            if (jsonMode) {
+                const confirmChoices = [
+                    { name: 'No', value: 'false' },
+                    { name: 'Yes', value: 'true' },
+                ];
+                outputPromptAsJson(buildPromptConfig('list', 'confirmed', `Remove all ${dependencies.length} dependencies?`, confirmChoices), createMetadata('spec link remove', flags));
+                return;
+            }
+            const { confirmed } = await inquirer.prompt([{
+                    type: 'list',
+                    name: 'confirmed',
+                    message: `Remove all ${dependencies.length} dependencies?`,
+                    choices: [
+                        { name: 'No', value: false },
+                        { name: 'Yes', value: true },
+                    ],
+                }]);
+            if (!confirmed) {
+                this.log(styles.muted('\nCancelled.'));
+                return;
+            }
+            for (const dep of dependencies)
+                await this.storage.deleteSpecDependency(args.id, dep.dependsOnSpecId, dep.dependencyType);
+            this.log(styles.success(`\n✅ Removed ${dependencies.length} dependencies from ${args.id}`));
+            return;
+        }
+        let targetId = args.target;
+        if (!targetId) {
+            const choices = await Promise.all(dependencies.map(async (dep) => {
+                const depSpec = await this.storage.getSpec(dep.dependsOnSpecId);
+                return { name: `${dep.dependsOnSpecId} - ${depSpec?.title || 'Unknown'} (${dep.dependencyType})`, value: dep.dependsOnSpecId };
+            }));
+            // In JSON mode, output dependency selection prompt
+            if (jsonMode) {
+                outputPromptAsJson(buildPromptConfig('list', 'target', 'Select dependency to remove:', choices), createMetadata('spec link remove', flags));
+                return;
+            }
+            const { selected } = await inquirer.prompt([{ type: 'list', name: 'selected', message: 'Select dependency to remove:', choices }]);
+            targetId = selected;
+        }
+        await this.storage.deleteSpecDependency(args.id, targetId, flags.type);
+        this.log(styles.success(`\n✅ Removed dependency: ${args.id} → ${targetId}`));
+    }
+}

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

@@ -0,0 +1,12 @@
+import { PMOCommand } from '../../lib/pmo/index.js';
+export default class SpecList extends PMOCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        status: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        type: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        search: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    execute(): Promise<void>;
+}

package/dist/commands/spec/list.js

@@ -0,0 +1,75 @@
+import { Flags } from '@oclif/core';
+import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
+import { styles } from '../../lib/styles.js';
+export default class SpecList extends PMOCommand {
+    static description = 'List all specs';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --status active',
+        '<%= config.bin %> <%= command.id %> --type product',
+    ];
+    static flags = {
+        ...pmoBaseFlags,
+        status: Flags.string({
+            char: 's',
+            description: 'Filter by status',
+            options: ['draft', 'active', 'implemented'],
+        }),
+        type: Flags.string({
+            char: 't',
+            description: 'Filter by type',
+            options: ['product', 'platform', 'infra', 'integration'],
+        }),
+        search: Flags.string({
+            description: 'Search in title/problem/solution',
+        }),
+    };
+    async execute() {
+        const { flags } = await this.parse(SpecList);
+        // List specs with filters
+        const specs = await this.storage.listSpecs({
+            status: flags.status,
+            type: flags.type,
+            search: flags.search,
+        });
+        if (specs.length === 0) {
+            this.log(styles.warning('\nNo specs found'));
+            this.log(styles.muted('  Create your first spec: prlt spec create'));
+            return;
+        }
+        // Display specs grouped by status
+        this.log(styles.title('\n📄 Specs'));
+        this.log(styles.muted('═'.repeat(60)));
+        // Group by status
+        const byStatus = {};
+        for (const spec of specs) {
+            if (!byStatus[spec.status])
+                byStatus[spec.status] = [];
+            byStatus[spec.status].push(spec);
+        }
+        for (const status of ['draft', 'active', 'implemented']) {
+            const statusSpecs = byStatus[status];
+            if (!statusSpecs || statusSpecs.length === 0)
+                continue;
+            const statusEmoji = status === 'draft' ? '📝' : status === 'active' ? '🟢' : '✅';
+            this.log(styles.emphasis(`\n${statusEmoji} ${status.toUpperCase()} (${statusSpecs.length})`));
+            for (const spec of statusSpecs) {
+                const typeTag = spec.type ? ` (${spec.type})` : '';
+                const tags = spec.tags && spec.tags.length > 0 ? ` [${spec.tags.join(', ')}]` : '';
+                this.log(`  ${styles.code(spec.id)}: ${spec.title}${typeTag}${tags}`);
+                if (spec.problem) {
+                    const preview = spec.problem.length > 60
+                        ? spec.problem.substring(0, 60) + '...'
+                        : spec.problem;
+                    this.log(styles.muted(`     ${preview}`));
+                }
+            }
+        }
+        this.log(styles.muted('\n' + '═'.repeat(60)));
+        this.log(styles.emphasis(`Total: ${specs.length} spec${specs.length === 1 ? '' : 's'}`));
+        this.log(styles.muted('\nCommands:'));
+        this.log(styles.primary('  prlt spec create      ') + styles.muted('Create a new spec'));
+        this.log(styles.primary('  prlt spec view <id>   ') + styles.muted('View spec details'));
+        this.log(styles.primary('  prlt spec plan <id>   ') + styles.muted('Generate tickets from spec'));
+    }
+}

package/dist/commands/spec/plan.d.ts

@@ -0,0 +1,15 @@
+import { PMOCommand } from '../../lib/pmo/index.js';
+export default class SpecPlan extends PMOCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        spec: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        spec: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    execute(): Promise<void>;
+}