planfs-cli 1.2.0 → 1.4.0

package/dist/entity-commands.js

@@ -0,0 +1,230 @@
+"use strict";
+/**
+ * CLI command registration.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerEntityCommands = registerEntityCommands;
+const next_1 = require("./commands/next");
+const list_1 = require("./commands/list");
+const show_1 = require("./commands/show");
+const inspect_1 = require("./commands/inspect");
+const create_1 = require("./commands/create");
+function registerEntityCommands(cli) {
+    return cli
+        .command('next', 'List ranked next-work candidates', (y) => y
+        .option('assignee', {
+        type: 'string',
+        description: 'Filter by assignee'
+    })
+        .option('epic', {
+        type: 'string',
+        description: 'Filter by epic'
+    })
+        .option('milestone', {
+        type: 'string',
+        description: 'Filter by milestone'
+    })
+        .option('tag', {
+        type: 'array',
+        string: true,
+        description: 'Filter by tag'
+    })
+        .option('status', {
+        type: 'array',
+        string: true,
+        choices: ['todo', 'in-progress', 'review', 'done'],
+        description: 'Filter by status'
+    })
+        .option('include-blocked', {
+        type: 'boolean',
+        default: false,
+        description: 'Include blocked and missing-dependency tasks'
+    })
+        .option('explain', {
+        type: 'boolean',
+        default: false,
+        description: 'Show all ranking reasons'
+    })
+        .option('limit', {
+        type: 'number',
+        description: 'Maximum number of candidates to show'
+    })
+        .option('format', {
+        type: 'string',
+        choices: ['text', 'json'],
+        default: 'text',
+        description: 'Output format'
+    }), async (args) => {
+        const exitCode = await (0, next_1.nextCommand)(process.cwd(), {
+            assignee: args.assignee,
+            epic: args.epic,
+            milestone: args.milestone,
+            tag: args.tag,
+            status: args.status,
+            includeBlocked: args.includeBlocked,
+            explain: args.explain,
+            limit: args.limit,
+            format: args.format
+        });
+        process.exit(exitCode);
+    })
+        .command('list [type]', 'List entities', (y) => y
+        .positional('type', {
+        describe: 'Entity type to list',
+        choices: ['tasks', 'epics', 'milestones', 'decisions'],
+        default: 'tasks'
+    })
+        .option('status', {
+        type: 'string',
+        description: 'Filter by status'
+    })
+        .option('assignee', {
+        type: 'string',
+        description: 'Filter by assignee'
+    })
+        .option('epic', {
+        type: 'string',
+        description: 'Filter by epic'
+    })
+        .option('format', {
+        type: 'string',
+        choices: ['table', 'json'],
+        default: 'table',
+        description: 'Output format'
+    }), async (args) => {
+        const exitCode = await (0, list_1.listCommand)(process.cwd(), {
+            type: args.type,
+            status: args.status,
+            assignee: args.assignee,
+            epic: args.epic,
+            format: args.format
+        });
+        process.exit(exitCode);
+    })
+        .command('show <id>', 'Show entity details', (y) => y
+        .positional('id', {
+        describe: 'Entity ID to show'
+    })
+        .option('format', {
+        type: 'string',
+        choices: ['pretty', 'json'],
+        default: 'pretty'
+    })
+        .option('nlp', {
+        type: 'boolean',
+        default: false,
+        description: 'Enable local advisory prose analysis'
+    })
+        .option('language', {
+        type: 'string',
+        default: 'en',
+        description: 'Language for advisory prose analysis'
+    }), async (args) => {
+        const exitCode = await (0, show_1.showCommand)(process.cwd(), args.id, {
+            format: args.format,
+            nlp: args.nlp,
+            language: args.language
+        });
+        process.exit(exitCode);
+    })
+        .command('inspect <id>', 'Inspect normalized semantic content and advisory suggestions', (y) => y
+        .positional('id', {
+        describe: 'Entity ID to inspect'
+    })
+        .option('format', {
+        type: 'string',
+        choices: ['pretty', 'json'],
+        default: 'pretty'
+    })
+        .option('view', {
+        type: 'string',
+        choices: [
+            'all',
+            'acceptance-criteria',
+            'findings',
+            'sections',
+            'mentions',
+            'relationships',
+            'raw'
+        ],
+        default: 'all',
+        description: 'Select a focused semantic view'
+    })
+        .option('nlp', {
+        type: 'boolean',
+        default: true,
+        description: 'Run local advisory analysis (disable with --no-nlp)'
+    })
+        .option('language', {
+        type: 'string',
+        default: 'en',
+        description: 'Language for local advisory analysis'
+    }), async (args) => {
+        const exitCode = await (0, inspect_1.inspectCommand)(process.cwd(), args.id, {
+            format: args.format,
+            view: args.view,
+            nlp: args.nlp,
+            language: args.language
+        });
+        process.exitCode = exitCode;
+    })
+        .command('create <type>', 'Create new entity', (y) => y
+        .positional('type', {
+        describe: 'Entity type to create',
+        choices: ['task', 'epic', 'milestone', 'decision']
+    })
+        .option('title', {
+        alias: 't',
+        type: 'string',
+        description: 'Entity title'
+    })
+        .option('status', {
+        type: 'string',
+        description: 'Initial status'
+    })
+        .option('priority', {
+        type: 'string',
+        description: 'Priority (for tasks)'
+    })
+        .option('assignee', {
+        type: 'string',
+        description: 'Assignee'
+    })
+        .option('owner', {
+        type: 'string',
+        description: 'Owner for epics and milestones'
+    })
+        .option('description', {
+        type: 'string',
+        description: 'Description/body for epics and milestones'
+    })
+        .option('target-date', {
+        type: 'string',
+        description: 'Target date for milestones'
+    })
+        .option('dry-run', {
+        type: 'boolean',
+        default: false,
+        description: 'Preview created Markdown without writing files'
+    })
+        .option('format', {
+        type: 'string',
+        choices: ['text', 'json'],
+        default: 'text',
+        description: 'Output format'
+    }), async (args) => {
+        const exitCode = await (0, create_1.createCommand)(process.cwd(), args.type, {
+            title: args.title,
+            status: args.status,
+            priority: args.priority,
+            assignee: args.assignee,
+            owner: args.owner,
+            description: args.description,
+            targetDate: args.targetDate,
+            dryRun: args.dryRun,
+            format: args.format
+        });
+        process.exit(exitCode);
+    });
+}
+//# sourceMappingURL=entity-commands.js.map

package/dist/entity-commands.js.map

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

package/dist/planning-commands.d.ts

@@ -0,0 +1,5 @@
+/**
+ * CLI command registration.
+ */
+import type { Argv } from 'yargs';
+export declare function registerPlanningCommands(cli: Argv): Argv;

package/dist/planning-commands.js

@@ -0,0 +1,259 @@
+"use strict";
+/**
+ * CLI command registration.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerPlanningCommands = registerPlanningCommands;
+const ai_1 = require("./commands/ai");
+const init_1 = require("./commands/init");
+const validate_1 = require("./commands/validate");
+const doctor_1 = require("./commands/doctor");
+const migrate_1 = require("./commands/migrate");
+const format_1 = require("./commands/format");
+function registerPlanningCommands(cli) {
+    return cli
+        .command('ai <action>', 'AI-oriented planning summary, semantic context, and update helpers', (y) => y
+        .positional('action', {
+        describe: 'AI helper to run',
+        choices: ['summary', 'context', 'update-task', 'bulk-update-tasks', 'initialize']
+    })
+        .option('id', {
+        type: 'string',
+        description: 'Entity ID for context or task ID to update'
+    })
+        .option('ids', {
+        type: 'array',
+        string: true,
+        description: 'Task IDs to bulk update, comma-separated or repeated'
+    })
+        .option('assignee', {
+        type: 'string',
+        description: 'Scope summary or set task assignee'
+    })
+        .option('epic', {
+        type: 'string',
+        description: 'Scope summary or set task epic'
+    })
+        .option('milestone', {
+        type: 'string',
+        description: 'Scope summary or set task milestone'
+    })
+        .option('estimate', {
+        type: 'string',
+        description: 'Set task estimate'
+    })
+        .option('status', {
+        type: 'array',
+        string: true,
+        choices: ['todo', 'in-progress', 'review', 'done'],
+        description: 'Scope summary by status or set task status'
+    })
+        .option('priority', {
+        type: 'string',
+        choices: ['low', 'medium', 'high', 'critical'],
+        description: 'Set task priority'
+    })
+        .option('refinement-state', {
+        type: 'array',
+        string: true,
+        choices: ['captured', 'needs-refinement', 'ready', 'deferred', 'discarded'],
+        description: 'Scope summary by refinement state or set task refinement state'
+    })
+        .option('due-date', {
+        type: 'string',
+        description: 'Set task due date'
+    })
+        .option('tags', {
+        type: 'string',
+        description: 'Set task tags as a comma-separated list'
+    })
+        .option('limit', {
+        type: 'number',
+        description: 'Maximum number of summary items per list'
+    })
+        .option('only', {
+        type: 'string',
+        choices: ['open', 'ready', 'blocked', 'review', 'stale', 'recent'],
+        description: 'Return only one planning summary section'
+    })
+        .option('compact', {
+        type: 'boolean',
+        default: false,
+        description: 'Emit minified JSON for lower-overhead agent context'
+    })
+        .option('nlp', {
+        type: 'boolean',
+        default: false,
+        description: 'Enable local advisory prose analysis for semantic context'
+    })
+        .option('language', {
+        type: 'string',
+        default: 'en',
+        description: 'Language for advisory semantic-context analysis'
+    })
+        .option('expected-updated-at', {
+        type: 'string',
+        description: 'Refuse a task update if updatedAt changed since preview (use none for an unset timestamp)'
+    })
+        .option('command', {
+        type: 'string',
+        description: 'CLI command written by ai initialize (default: planfs)'
+    })
+        .option('dry-run', {
+        type: 'boolean',
+        default: false,
+        description: 'Preview task updates or awareness initialization without writing files'
+    })
+        .option('file', {
+        type: 'string',
+        default: 'AGENTS.md',
+        description: 'Agent instruction file to create or update'
+    })
+        .option('format', {
+        type: 'string',
+        choices: ['json', 'text'],
+        default: 'json',
+        description: 'Output format'
+    }), async (args) => {
+        const exitCode = await (0, ai_1.aiCommand)(process.cwd(), args.action, {
+            id: args.id,
+            ids: args.ids,
+            assignee: args.assignee,
+            epic: args.epic,
+            milestone: args.milestone,
+            estimate: args.estimate,
+            status: args.status,
+            priority: args.priority,
+            refinementState: args.refinementState,
+            dueDate: args.dueDate,
+            tags: args.tags,
+            limit: args.limit,
+            dryRun: args.dryRun,
+            file: args.file,
+            format: args.format,
+            only: args.only,
+            compact: args.compact,
+            nlp: args.nlp,
+            language: args.language,
+            expectedUpdatedAt: args.expectedUpdatedAt,
+            command: args.command
+        });
+        process.exit(exitCode);
+    })
+        .command('init', 'Initialize PlanFS repository structure', (y) => y.option('format', {
+        type: 'string',
+        choices: ['text', 'json'],
+        default: 'text',
+        description: 'Output format'
+    }), async (args) => {
+        const exitCode = await (0, init_1.initCommand)(process.cwd(), {
+            format: args.format
+        });
+        process.exit(exitCode);
+    })
+        .command('validate', 'Validate the PlanFS repository', (y) => y
+        .option('verbose', {
+        alias: 'v',
+        type: 'boolean',
+        description: 'Show detailed output',
+        default: false
+    })
+        .option('strict', {
+        type: 'boolean',
+        default: false,
+        description: 'Fail when validation warnings are present'
+    })
+        .option('semantic', {
+        type: 'string',
+        choices: ['baseline', 'automation-ready'],
+        description: 'Explicitly validate a semantic Markdown content tier'
+    })
+        .option('lifecycle', {
+        type: 'boolean',
+        default: false,
+        description: 'Add read-only lifecycle-sensitive semantic policy checks'
+    })
+        .option('criterion-check-state', {
+        type: 'string',
+        choices: ['ignore', 'info', 'warning', 'error'],
+        default: 'warning',
+        description: 'Severity for ordinary criteria without [ ] or [x] markers'
+    })
+        .option('nlp', {
+        type: 'boolean',
+        default: false,
+        description: 'Include optional local advisory prose analysis'
+    })
+        .option('language', {
+        type: 'string',
+        default: 'en',
+        description: 'Language for optional advisory prose analysis'
+    })
+        .option('format', {
+        type: 'string',
+        choices: ['text', 'json'],
+        default: 'text',
+        description: 'Output format'
+    }), async (args) => {
+        const exitCode = await (0, validate_1.validateCommand)(process.cwd(), {
+            verbose: args.verbose,
+            strict: args.strict,
+            format: args.format,
+            semantic: args.semantic,
+            lifecycle: args.lifecycle,
+            criterionCheckState: args.criterionCheckState,
+            nlp: args.nlp,
+            language: args.language
+        });
+        process.exitCode = exitCode;
+    })
+        .command('doctor', 'Report actionable plan-health issues separately from historical references', (y) => y.option('format', { type: 'string', choices: ['text', 'json'], default: 'text' }), async (args) => {
+        process.exit(await (0, doctor_1.doctorCommand)(process.cwd(), { format: args.format }));
+    })
+        .command('migrate', 'Preview or apply a PlanFS format migration', (y) => y.option('apply', { type: 'boolean', default: false }).option('format', { type: 'string', choices: ['text', 'json'], default: 'text' }), async (args) => {
+        process.exit(await (0, migrate_1.migrateCommand)(process.cwd(), { apply: args.apply, format: args.format }));
+    })
+        .command('format [ids..]', 'Check, preview, or explicitly apply conservative semantic Markdown formatting', (y) => y
+        .positional('ids', {
+        type: 'string',
+        array: true,
+        description: 'Entity IDs to format (comma-separated or repeated)'
+    })
+        .option('all', {
+        type: 'boolean',
+        default: false,
+        description: 'Select every active repository entity'
+    })
+        .option('check', {
+        type: 'boolean',
+        default: false,
+        description: 'Exit non-zero when a selected file needs formatting'
+    })
+        .option('apply', {
+        type: 'boolean',
+        default: false,
+        description: 'Apply a previously previewed snapshot'
+    })
+        .option('expected-fingerprint', {
+        type: 'array',
+        string: true,
+        description: 'Required apply token: sha256:... for one entity or ENTITY-ID=sha256:... for a batch'
+    })
+        .option('format', {
+        type: 'string',
+        choices: ['text', 'json'],
+        default: 'text',
+        description: 'Output format'
+    }), async (args) => {
+        const exitCode = await (0, format_1.formatCommand)(process.cwd(), {
+            ids: args.ids,
+            all: args.all,
+            check: args.check,
+            apply: args.apply,
+            expectedFingerprint: args.expectedFingerprint,
+            format: args.format
+        });
+        process.exitCode = exitCode;
+    });
+}
+//# sourceMappingURL=planning-commands.js.map

package/dist/planning-commands.js.map

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

package/dist/workflow-commands.d.ts

@@ -0,0 +1,5 @@
+/**
+ * CLI command registration.
+ */
+import type { Argv } from 'yargs';
+export declare function registerWorkflowCommands(cli: Argv): Argv;