@kamilmarzynski/scifi 0.1.1

package/dist/src/cli/commands/fix.js

@@ -0,0 +1,60 @@
+import { relative } from 'node:path';
+import { cwd } from 'node:process';
+import { createFix } from '../../core/fixes/create.js';
+import { updateFixStatus } from '../../core/fixes/transition.js';
+import { emitError, emitSuccess, jsonMode } from '../../core/output/index.js';
+function createTimestamp() {
+    return new Date().toISOString();
+}
+export function registerFixCommand(program) {
+    const fix = program.command('fix').description('Manage fixes within a feature');
+    fix
+        .command('create')
+        .description("Create a fix inside a feature's fixes/ directory (blocks finish until resolved)")
+        .argument('<description>', 'short description of the fix')
+        .requiredOption('--feature <slug>', 'feature slug to attach this fix to')
+        .option('--json', 'output as structured JSON')
+        .action(async (description, options, command) => {
+        const json = jsonMode(command);
+        try {
+            const projectRoot = cwd();
+            const result = await createFix({
+                projectRoot,
+                description,
+                featureSlug: options.feature,
+                now: createTimestamp(),
+            });
+            const path = relative(projectRoot, result.filePath);
+            emitSuccess({ action: 'fix-create', id: result.id, description, feature: options.feature, path }, json, [
+                `Fix created: ${result.id}`,
+                `  Description: ${description}`,
+                `  Feature: ${options.feature}`,
+                `  Path: ${path}`,
+            ]);
+        }
+        catch (error) {
+            emitError(error, json);
+        }
+    });
+    registerTransitionSubcommand(fix, 'resolve', 'resolved', 'Mark a fix as resolved');
+    registerTransitionSubcommand(fix, 'wont-fix', 'wont-fix', 'Mark a fix as wont-fix');
+}
+function registerTransitionSubcommand(fix, name, targetStatus, description) {
+    fix
+        .command(name)
+        .description(description)
+        .argument('<slug>', 'feature folder slug')
+        .argument('<id>', 'fix id (e.g. FIX-0001)')
+        .option('--json', 'output as structured JSON')
+        .action(async (slug, id, _options, command) => {
+        const json = jsonMode(command);
+        try {
+            const result = await updateFixStatus(cwd(), slug, id, targetStatus);
+            emitSuccess({ action: `fix-${name}`, ...result }, json, `fix ${result.id} (feature: ${result.featureSlug}): ${result.previousStatus} → ${result.newStatus}`);
+        }
+        catch (error) {
+            emitError(error, json);
+        }
+    });
+}
+//# sourceMappingURL=fix.js.map

package/dist/src/cli/commands/fix.js.map

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

package/dist/src/cli/commands/init.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerInitCommand(program: Command): void;

package/dist/src/cli/commands/init.js

@@ -0,0 +1,92 @@
+import { cwd, stdin, stdout } from 'node:process';
+import { createInterface } from 'node:readline/promises';
+import { writeConfig } from '../../core/init/config.js';
+import { installSkills } from '../../core/init/install-skills.js';
+import { resolveHarness } from '../../core/init/prompt-harness.js';
+import { scaffoldInit } from '../../core/init/scaffold.js';
+import { emitError, emitSuccess, isInteractive, jsonMode, ScifiError, } from '../../core/output/index.js';
+import { findPackageRoot } from '../../core/package-root.js';
+import { HarnessNotImplementedError, InvalidHarnessError, KNOWN_HARNESS_IDS, } from '../../core/skills/harness/adapter.js';
+import { getAdapter } from '../../core/skills/harness/registry.js';
+const BOOTSTRAP_FILES = ['CONTEXT.md'];
+export function registerInitCommand(program) {
+    program
+        .command('init')
+        .description('Initialize scifi in the current repository')
+        .option('--harness <id>', 'harness adapter to install skills for')
+        .option('--yes', 'skip prompts and use defaults')
+        .option('--json', 'output as structured JSON')
+        .action(async (options, command) => {
+        const json = jsonMode(command);
+        try {
+            const projectRoot = cwd();
+            const packageRoot = findPackageRoot(import.meta.url);
+            if (options.harness === undefined && options.yes !== true && !isInteractive()) {
+                throw new ScifiError('INVALID_ARGUMENT', 'harness selection requires --harness <id> when running non-interactively.', { hint: `Available harnesses: ${KNOWN_HARNESS_IDS.join(', ')}.` });
+            }
+            const harness = await resolveHarness({
+                flag: options.harness,
+                yes: options.yes === true,
+                ask: askInteractively,
+            });
+            // Validate the adapter is implemented before touching the filesystem.
+            getAdapter(harness);
+            await scaffoldInit({ projectRoot, harness });
+            const skills = await installSkills({ projectRoot, harness, packageRoot });
+            await writeConfig({ projectRoot, harness });
+            emitSuccess({
+                action: 'init',
+                root: 'docs/scifi',
+                harness,
+                files: BOOTSTRAP_FILES,
+                skills,
+            }, json, [
+                `scifi initialized successfully.`,
+                `  Root:    docs/scifi`,
+                `  Harness: ${harness}`,
+                `  Files:   ${BOOTSTRAP_FILES.join(', ')}`,
+                `  Skills:  ${skills.join(', ')}`,
+                ``,
+                `Next: read docs/scifi/CONTEXT.md,`,
+                `then create a spec with \`scifi spec <slug> --title "Your Feature"\``,
+            ]);
+        }
+        catch (error) {
+            emitError(normalizeInitError(error), json);
+        }
+    });
+}
+function normalizeInitError(error) {
+    if (error instanceof InvalidHarnessError || error instanceof HarnessNotImplementedError) {
+        return new ScifiError('INVALID_ARGUMENT', error.message, {
+            hint: `Available harnesses: ${KNOWN_HARNESS_IDS.join(', ')}.`,
+            cause: error,
+        });
+    }
+    return error;
+}
+async function askInteractively(choices) {
+    const rl = createInterface({ input: stdin, output: stdout });
+    try {
+        const numbered = choices.map((id, index) => `  ${index + 1}) ${id}`).join('\n');
+        const prompt = `Pick a harness:\n${numbered}\nEnter number (default 1): `;
+        const answer = (await rl.question(prompt)).trim();
+        if (answer === '') {
+            const first = choices[0];
+            if (first === undefined) {
+                throw new Error('No harness choices available');
+            }
+            return first;
+        }
+        const index = Number.parseInt(answer, 10) - 1;
+        const picked = choices[index];
+        if (picked === undefined) {
+            return answer;
+        }
+        return picked;
+    }
+    finally {
+        rl.close();
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/src/cli/commands/init.js.map

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

package/dist/src/cli/commands/list.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerListCommand(program: Command): void;

package/dist/src/cli/commands/list.js

@@ -0,0 +1,52 @@
+import { cwd } from 'node:process';
+import { listOpenFixes } from '../../core/fixes/list.js';
+import { emitError, emitList, jsonMode } from '../../core/output/index.js';
+import { listFeatures } from '../../core/specs/list.js';
+import { FEATURE_STATUS_VALUES } from '../../core/specs/types.js';
+export function registerListCommand(program) {
+    program
+        .command('list')
+        .description('List all features')
+        .option('--status <status>', 'filter by lifecycle status')
+        .option('--json', 'output as structured JSON (NDJSON)')
+        .action(async (options, command) => {
+        const json = jsonMode(command);
+        try {
+            const projectRoot = cwd();
+            const statusFilter = options.status !== undefined &&
+                FEATURE_STATUS_VALUES.includes(options.status)
+                ? options.status
+                : undefined;
+            const listOptions = { projectRoot };
+            if (statusFilter !== undefined) {
+                listOptions.status = statusFilter;
+            }
+            const features = await listFeatures(listOptions);
+            const rows = await Promise.all(features.map(async (feature) => {
+                const openFixes = await listOpenFixes(projectRoot, feature.slug);
+                return {
+                    slug: feature.slug,
+                    status: feature.status,
+                    openFixes: openFixes.length,
+                    title: feature.title ?? '',
+                };
+            }));
+            const humanLines = [
+                ['SLUG', 'STATUS', 'OPEN FIXES', 'TITLE'].join('\t'),
+                ...rows.map((row) => [
+                    row.slug,
+                    row.status,
+                    row.openFixes > 0
+                        ? `${row.openFixes} open fix${row.openFixes === 1 ? '' : 'es'}`
+                        : '-',
+                    row.title,
+                ].join('\t')),
+            ];
+            emitList(rows, json, humanLines);
+        }
+        catch (error) {
+            emitError(error, json);
+        }
+    });
+}
+//# sourceMappingURL=list.js.map

package/dist/src/cli/commands/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../src/cli/commands/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,mBAAmB,CAAC;SAChC,MAAM,CAAC,mBAAmB,EAAE,4BAA4B,CAAC;SACzD,MAAM,CAAC,QAAQ,EAAE,oCAAoC,CAAC;SACtD,MAAM,CAAC,KAAK,EAAE,OAA4C,EAAE,OAAgB,EAAE,EAAE;QAC/E,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC;YAC1B,MAAM,YAAY,GAChB,OAAO,CAAC,MAAM,KAAK,SAAS;gBAC3B,qBAA2C,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC;gBACnE,CAAC,CAAE,OAAO,CAAC,MAAwB;gBACnC,CAAC,CAAC,SAAS,CAAC;YAEhB,MAAM,WAAW,GAAG,EAAE,WAAW,EAAE,CAAC;YACpC,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;gBAC9B,WAA0C,CAAC,MAAM,GAAG,YAAY,CAAC;YACpE,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC,CAAC;YAEjD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,GAAG,CAC5B,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;gBAC7B,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;gBACjE,OAAO;oBACL,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,SAAS,EAAE,SAAS,CAAC,MAAM;oBAC3B,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;iBAC3B,CAAC;YACJ,CAAC,CAAC,CACH,CAAC;YAEF,MAAM,UAAU,GAAG;gBACjB,CAAC,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;gBACpD,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAClB;oBACE,GAAG,CAAC,IAAI;oBACR,GAAG,CAAC,MAAM;oBACV,GAAG,CAAC,SAAS,GAAG,CAAC;wBACf,CAAC,CAAC,GAAG,GAAG,CAAC,SAAS,YAAY,GAAG,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE;wBAC/D,CAAC,CAAC,GAAG;oBACP,GAAG,CAAC,KAAK;iBACV,CAAC,IAAI,CAAC,IAAI,CAAC,CACb;aACF,CAAC;YAEF,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACzB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/src/cli/commands/plan-ready.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerPlanReadyCommand(program: Command): void;

package/dist/src/cli/commands/plan-ready.js

@@ -0,0 +1,27 @@
+import { cwd } from 'node:process';
+import { emitError, emitSuccess, jsonMode } from '../../core/output/index.js';
+import { updateFeatureStatus } from '../../core/specs/transition.js';
+function createTimestamp() {
+    return new Date().toISOString();
+}
+export function registerPlanReadyCommand(program) {
+    program
+        .command('plan-ready')
+        .description('Mark a feature as plan-ready (validates design.md and tasks/ exist)')
+        .argument('<slug>', 'feature folder slug')
+        .option('--json', 'output as structured JSON')
+        .action(async (slug, _options, command) => {
+        const json = jsonMode(command);
+        try {
+            const result = await updateFeatureStatus(cwd(), slug, 'plan-ready', createTimestamp());
+            emitSuccess({ action: 'plan-ready', ...result }, json, [
+                `feature ${result.slug}: ${result.previousStatus} → ${result.newStatus}`,
+                `  Timestamp: ${result.timestamp}`,
+            ]);
+        }
+        catch (error) {
+            emitError(error, json);
+        }
+    });
+}
+//# sourceMappingURL=plan-ready.js.map

package/dist/src/cli/commands/plan-ready.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-ready.js","sourceRoot":"","sources":["../../../../src/cli/commands/plan-ready.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAErE,SAAS,eAAe;IACtB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,OAAgB;IACvD,OAAO;SACJ,OAAO,CAAC,YAAY,CAAC;SACrB,WAAW,CAAC,qEAAqE,CAAC;SAClF,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;SACzC,MAAM,CAAC,QAAQ,EAAE,2BAA2B,CAAC;SAC7C,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,QAAiB,EAAE,OAAgB,EAAE,EAAE;QAClE,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC,CAAC;YACvF,WAAW,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE;gBACrD,WAAW,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,cAAc,MAAM,MAAM,CAAC,SAAS,EAAE;gBACxE,gBAAgB,MAAM,CAAC,SAAS,EAAE;aACnC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACzB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/src/cli/commands/plan.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerPlanCommand(program: Command): void;

package/dist/src/cli/commands/plan.js

@@ -0,0 +1,43 @@
+import { cwd } from 'node:process';
+import { emitError, emitSuccess, jsonMode } from '../../core/output/index.js';
+import { inspectPlanSession } from '../../core/specs/plan-session.js';
+export function registerPlanCommand(program) {
+    program
+        .command('plan')
+        .description('Open a planning session for a spec-ready feature (reports plan progress)')
+        .argument('<slug>', 'feature folder slug')
+        .option('--json', 'output as structured JSON')
+        .action(async (slug, _options, command) => {
+        const json = jsonMode(command);
+        try {
+            const session = await inspectPlanSession(cwd(), slug);
+            const guidance = session.state === 'ready-to-plan'
+                ? [
+                    'No design.md or tasks yet — start the plan from scratch.',
+                    `Next: write design.md and tasks/, then run \`scifi plan-ready ${session.slug}\`.`,
+                ]
+                : session.state === 'in-progress'
+                    ? [
+                        'Planning already started but is incomplete.',
+                        `  design.md: ${session.designExists ? 'present' : 'missing'}`,
+                        `  tasks:     ${session.taskFileCount} file${session.taskFileCount === 1 ? '' : 's'}`,
+                        'Continue where it left off, or rewrite from scratch if the approach changed.',
+                    ]
+                    : [
+                        'This feature is already planned (status is past spec-ready).',
+                        `  design.md: ${session.designExists ? 'present' : 'missing'}`,
+                        `  tasks:     ${session.taskFileCount} file${session.taskFileCount === 1 ? '' : 's'}`,
+                        'Ask the user whether to continue refining the existing plan or start over.',
+                    ];
+            emitSuccess({ action: 'plan', ...session }, json, [
+                `feature ${session.slug}: ${session.status} (plan ${session.state})`,
+                '',
+                ...guidance,
+            ]);
+        }
+        catch (error) {
+            emitError(error, json);
+        }
+    });
+}
+//# sourceMappingURL=plan.js.map

package/dist/src/cli/commands/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../../../src/cli/commands/plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAEtE,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,0EAA0E,CAAC;SACvF,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;SACzC,MAAM,CAAC,QAAQ,EAAE,2BAA2B,CAAC;SAC7C,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,QAAiB,EAAE,OAAgB,EAAE,EAAE;QAClE,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;YAEtD,MAAM,QAAQ,GACZ,OAAO,CAAC,KAAK,KAAK,eAAe;gBAC/B,CAAC,CAAC;oBACE,0DAA0D;oBAC1D,iEAAiE,OAAO,CAAC,IAAI,KAAK;iBACnF;gBACH,CAAC,CAAC,OAAO,CAAC,KAAK,KAAK,aAAa;oBAC/B,CAAC,CAAC;wBACE,6CAA6C;wBAC7C,gBAAgB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE;wBAC9D,gBAAgB,OAAO,CAAC,aAAa,QAAQ,OAAO,CAAC,aAAa,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE;wBACrF,8EAA8E;qBAC/E;oBACH,CAAC,CAAC;wBACE,8DAA8D;wBAC9D,gBAAgB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE;wBAC9D,gBAAgB,OAAO,CAAC,aAAa,QAAQ,OAAO,CAAC,aAAa,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE;wBACrF,4EAA4E;qBAC7E,CAAC;YAEV,WAAW,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,EAAE;gBAChD,WAAW,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM,UAAU,OAAO,CAAC,KAAK,GAAG;gBACpE,EAAE;gBACF,GAAG,QAAQ;aACZ,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACzB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/src/cli/commands/spec-ready.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerSpecReadyCommand(program: Command): void;

package/dist/src/cli/commands/spec-ready.js

@@ -0,0 +1,27 @@
+import { cwd } from 'node:process';
+import { emitError, emitSuccess, jsonMode } from '../../core/output/index.js';
+import { updateFeatureStatus } from '../../core/specs/transition.js';
+function createTimestamp() {
+    return new Date().toISOString();
+}
+export function registerSpecReadyCommand(program) {
+    program
+        .command('spec-ready')
+        .description('Mark a feature as spec-ready (validates spec.md exists)')
+        .argument('<slug>', 'feature folder slug')
+        .option('--json', 'output as structured JSON')
+        .action(async (slug, _options, command) => {
+        const json = jsonMode(command);
+        try {
+            const result = await updateFeatureStatus(cwd(), slug, 'spec-ready', createTimestamp());
+            emitSuccess({ action: 'spec-ready', ...result }, json, [
+                `feature ${result.slug}: ${result.previousStatus} → ${result.newStatus}`,
+                `  Timestamp: ${result.timestamp}`,
+            ]);
+        }
+        catch (error) {
+            emitError(error, json);
+        }
+    });
+}
+//# sourceMappingURL=spec-ready.js.map

package/dist/src/cli/commands/spec-ready.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-ready.js","sourceRoot":"","sources":["../../../../src/cli/commands/spec-ready.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAErE,SAAS,eAAe;IACtB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,OAAgB;IACvD,OAAO;SACJ,OAAO,CAAC,YAAY,CAAC;SACrB,WAAW,CAAC,yDAAyD,CAAC;SACtE,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;SACzC,MAAM,CAAC,QAAQ,EAAE,2BAA2B,CAAC;SAC7C,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,QAAiB,EAAE,OAAgB,EAAE,EAAE;QAClE,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC,CAAC;YACvF,WAAW,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE;gBACrD,WAAW,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,cAAc,MAAM,MAAM,CAAC,SAAS,EAAE;gBACxE,gBAAgB,MAAM,CAAC,SAAS,EAAE;aACnC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACzB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/src/cli/commands/spec.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerSpecCommand(program: Command): void;

package/dist/src/cli/commands/spec.js

@@ -0,0 +1,46 @@
+import { relative } from 'node:path';
+import { cwd } from 'node:process';
+import { emitError, emitSuccess, jsonMode } from '../../core/output/index.js';
+import { createFeature } from '../../core/specs/create.js';
+function createTimestamp() {
+    return new Date().toISOString();
+}
+export function registerSpecCommand(program) {
+    program
+        .command('spec')
+        .description('Create a scifi-managed feature container')
+        .argument('<slug>', 'feature folder slug')
+        .option('--title <title>', 'display title for the feature')
+        .option('--json', 'output as structured JSON')
+        .action(async (slug, options, command) => {
+        const json = jsonMode(command);
+        try {
+            const projectRoot = cwd();
+            const result = await createFeature({
+                projectRoot,
+                slug,
+                ...(options.title !== undefined && { title: options.title }),
+                now: createTimestamp(),
+            });
+            const path = relative(projectRoot, result.featureDirectoryPath);
+            const metadataPath = relative(projectRoot, result.metadataPath);
+            emitSuccess({
+                action: 'spec',
+                slug,
+                path,
+                status: 'created',
+                metadataPath,
+            }, json, [
+                `Feature created: ${slug}`,
+                `  Path:   ${path}`,
+                `  Status: created`,
+                ``,
+                `Next: write spec.md, then run \`scifi spec-ready ${slug}\``,
+            ]);
+        }
+        catch (error) {
+            emitError(error, json);
+        }
+    });
+}
+//# sourceMappingURL=spec.js.map

package/dist/src/cli/commands/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../../../src/cli/commands/spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,SAAS,eAAe;IACtB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,0CAA0C,CAAC;SACvD,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;SACzC,MAAM,CAAC,iBAAiB,EAAE,+BAA+B,CAAC;SAC1D,MAAM,CAAC,QAAQ,EAAE,2BAA2B,CAAC;SAC7C,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,OAA2C,EAAE,OAAgB,EAAE,EAAE;QAC5F,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC;gBACjC,WAAW;gBACX,IAAI;gBACJ,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;gBAC5D,GAAG,EAAE,eAAe,EAAE;aACvB,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,oBAAoB,CAAC,CAAC;YAChE,MAAM,YAAY,GAAG,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;YAEhE,WAAW,CACT;gBACE,MAAM,EAAE,MAAM;gBACd,IAAI;gBACJ,IAAI;gBACJ,MAAM,EAAE,SAAS;gBACjB,YAAY;aACb,EACD,IAAI,EACJ;gBACE,oBAAoB,IAAI,EAAE;gBAC1B,aAAa,IAAI,EAAE;gBACnB,mBAAmB;gBACnB,EAAE;gBACF,oDAAoD,IAAI,IAAI;aAC7D,CACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACzB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/src/cli/commands/start.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerStartCommand(program: Command): void;

package/dist/src/cli/commands/start.js

@@ -0,0 +1,27 @@
+import { cwd } from 'node:process';
+import { emitError, emitSuccess, jsonMode } from '../../core/output/index.js';
+import { updateFeatureStatus } from '../../core/specs/transition.js';
+function createTimestamp() {
+    return new Date().toISOString();
+}
+export function registerStartCommand(program) {
+    program
+        .command('start')
+        .description('Mark a feature as in-progress (requires plan-ready status)')
+        .argument('<slug>', 'feature folder slug')
+        .option('--json', 'output as structured JSON')
+        .action(async (slug, _options, command) => {
+        const json = jsonMode(command);
+        try {
+            const result = await updateFeatureStatus(cwd(), slug, 'in-progress', createTimestamp());
+            emitSuccess({ action: 'start', ...result }, json, [
+                `feature ${result.slug}: ${result.previousStatus} → ${result.newStatus}`,
+                `  Timestamp: ${result.timestamp}`,
+            ]);
+        }
+        catch (error) {
+            emitError(error, json);
+        }
+    });
+}
+//# sourceMappingURL=start.js.map

package/dist/src/cli/commands/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../../../src/cli/commands/start.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAErE,SAAS,eAAe;IACtB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,4DAA4D,CAAC;SACzE,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;SACzC,MAAM,CAAC,QAAQ,EAAE,2BAA2B,CAAC;SAC7C,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,QAAiB,EAAE,OAAgB,EAAE,EAAE;QAClE,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,eAAe,EAAE,CAAC,CAAC;YACxF,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE;gBAChD,WAAW,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,cAAc,MAAM,MAAM,CAAC,SAAS,EAAE;gBACxE,gBAAgB,MAAM,CAAC,SAAS,EAAE;aACnC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACzB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/src/cli/commands/status.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerStatusCommand(program: Command): void;

package/dist/src/cli/commands/status.js

@@ -0,0 +1,62 @@
+import { cwd } from 'node:process';
+import { listFixes } from '../../core/fixes/list.js';
+import { emitError, emitSuccess, jsonMode } from '../../core/output/index.js';
+import { inspectFeatureLifecycle } from '../../core/specs/lifecycle.js';
+import { listTasks } from '../../core/tasks/list.js';
+export function registerStatusCommand(program) {
+    program
+        .command('status')
+        .description('Show lifecycle status and artifact inventory for a feature')
+        .argument('<slug>', 'feature folder slug')
+        .option('--json', 'output as structured JSON')
+        .action(async (slug, _options, command) => {
+        const json = jsonMode(command);
+        try {
+            const projectRoot = cwd();
+            const lifecycle = await inspectFeatureLifecycle(projectRoot, slug);
+            const tasks = await listTasks(projectRoot, slug);
+            const fixes = await listFixes(projectRoot, slug);
+            const { metadata, artifacts } = lifecycle;
+            const data = {
+                slug: metadata.slug,
+                ...(metadata.title !== undefined && { title: metadata.title }),
+                status: metadata.status,
+                ...(metadata.branch !== undefined && { branch: metadata.branch }),
+                ...(metadata.worktreePath !== undefined && { worktree: metadata.worktreePath }),
+                artifacts: {
+                    spec: artifacts.specExists,
+                    design: artifacts.designExists,
+                    taskCount: artifacts.taskFileCount,
+                },
+                tasks: tasks.map((task) => ({ slug: task.slug, status: task.status })),
+                fixes: fixes.map((fix) => ({
+                    id: fix.id,
+                    slug: fix.slug,
+                    status: fix.status,
+                })),
+            };
+            const title = metadata.title !== undefined ? ` (${metadata.title})` : '';
+            const humanLines = [
+                `slug:    ${metadata.slug}${title}`,
+                `status:  ${metadata.status}`,
+                ...(metadata.branch !== undefined ? [`branch:  ${metadata.branch}`] : []),
+                ...(metadata.worktreePath !== undefined ? [`worktree: ${metadata.worktreePath}`] : []),
+                ``,
+                `spec.md:    ${artifacts.specExists ? 'present' : 'missing'}`,
+                `design.md:  ${artifacts.designExists ? 'present' : 'missing'}`,
+                `tasks:      ${artifacts.taskFileCount} file${artifacts.taskFileCount === 1 ? '' : 's'}`,
+                ...(tasks.length > 0
+                    ? ['', ...tasks.map((task) => `  ${task.slug}\t${task.status}`)]
+                    : []),
+                ...(fixes.length > 0
+                    ? ['', 'fixes:', ...fixes.map((fix) => `  ${fix.id}  ${fix.status}  ${fix.slug}`)]
+                    : []),
+            ];
+            emitSuccess(data, json, humanLines);
+        }
+        catch (error) {
+            emitError(error, json);
+        }
+    });
+}
+//# sourceMappingURL=status.js.map

package/dist/src/cli/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../../src/cli/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,4DAA4D,CAAC;SACzE,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;SACzC,MAAM,CAAC,QAAQ,EAAE,2BAA2B,CAAC;SAC7C,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,QAAiB,EAAE,OAAgB,EAAE,EAAE;QAClE,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC;YAC1B,MAAM,SAAS,GAAG,MAAM,uBAAuB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YACnE,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YACjD,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YAEjD,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,SAAS,CAAC;YAE1C,MAAM,IAAI,GAAG;gBACX,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,GAAG,CAAC,QAAQ,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;gBAC9D,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,GAAG,CAAC,QAAQ,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;gBACjE,GAAG,CAAC,QAAQ,CAAC,YAAY,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,YAAY,EAAE,CAAC;gBAC/E,SAAS,EAAE;oBACT,IAAI,EAAE,SAAS,CAAC,UAAU;oBAC1B,MAAM,EAAE,SAAS,CAAC,YAAY;oBAC9B,SAAS,EAAE,SAAS,CAAC,aAAa;iBACnC;gBACD,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;gBACtE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;oBACzB,EAAE,EAAE,GAAG,CAAC,EAAE;oBACV,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,MAAM,EAAE,GAAG,CAAC,MAAM;iBACnB,CAAC,CAAC;aACJ,CAAC;YAEF,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACzE,MAAM,UAAU,GAAG;gBACjB,YAAY,QAAQ,CAAC,IAAI,GAAG,KAAK,EAAE;gBACnC,YAAY,QAAQ,CAAC,MAAM,EAAE;gBAC7B,GAAG,CAAC,QAAQ,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,YAAY,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzE,GAAG,CAAC,QAAQ,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,aAAa,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtF,EAAE;gBACF,eAAe,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE;gBAC7D,eAAe,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE;gBAC/D,eAAe,SAAS,CAAC,aAAa,QAAQ,SAAS,CAAC,aAAa,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE;gBACxF,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;oBAClB,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;oBAChE,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;oBAClB,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;oBAClF,CAAC,CAAC,EAAE,CAAC;aACR,CAAC;YAEF,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACzB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/src/cli/commands/task.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerTaskCommand(program: Command): void;

package/dist/src/cli/commands/task.js

@@ -0,0 +1,64 @@
+import { cwd } from 'node:process';
+import { emitError, emitList, emitSuccess, jsonMode } from '../../core/output/index.js';
+import { listTasks } from '../../core/tasks/list.js';
+import { updateTaskStatus } from '../../core/tasks/transition.js';
+export function registerTaskCommand(program) {
+    const task = program.command('task').description('Manage tasks within a feature');
+    task
+        .command('list')
+        .description('List all tasks for a feature with their status')
+        .argument('<slug>', 'feature folder slug')
+        .option('--json', 'output as structured JSON (NDJSON)')
+        .action(async (slug, _options, command) => {
+        const json = jsonMode(command);
+        try {
+            const tasks = await listTasks(cwd(), slug);
+            const rows = tasks.map((t) => ({
+                slug: t.slug,
+                status: t.status,
+                dependsOn: t.dependsOn,
+            }));
+            const humanLines = [
+                ['TASK', 'STATUS', 'DEPENDS-ON'].join('\t'),
+                ...rows.map((row) => [row.slug, row.status, row.dependsOn.join(',')].join('\t')),
+            ];
+            emitList(rows, json, humanLines);
+        }
+        catch (error) {
+            emitError(error, json);
+        }
+    });
+    task
+        .command('start')
+        .description('Mark a task as in-progress')
+        .argument('<slug>', 'feature folder slug')
+        .argument('<task>', 'task slug')
+        .option('--json', 'output as structured JSON')
+        .action(async (slug, taskSlug, _options, command) => {
+        const json = jsonMode(command);
+        try {
+            const result = await updateTaskStatus(cwd(), slug, taskSlug, 'in-progress');
+            emitSuccess({ action: 'task-start', ...result }, json, `task ${result.taskSlug} (feature: ${result.featureSlug}): ${result.previousStatus} → ${result.newStatus}`);
+        }
+        catch (error) {
+            emitError(error, json);
+        }
+    });
+    task
+        .command('done')
+        .description('Mark a task as done (requires task to be in-progress)')
+        .argument('<slug>', 'feature folder slug')
+        .argument('<task>', 'task slug')
+        .option('--json', 'output as structured JSON')
+        .action(async (slug, taskSlug, _options, command) => {
+        const json = jsonMode(command);
+        try {
+            const result = await updateTaskStatus(cwd(), slug, taskSlug, 'done');
+            emitSuccess({ action: 'task-done', ...result }, json, `task ${result.taskSlug} (feature: ${result.featureSlug}): ${result.previousStatus} → ${result.newStatus}`);
+        }
+        catch (error) {
+            emitError(error, json);
+        }
+    });
+}
+//# sourceMappingURL=task.js.map

package/dist/src/cli/commands/task.js.map

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

package/dist/src/cli/commands/worktree.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerWorktreeCommand(program: Command): void;