@kamilmarzynski/scifi 0.1.1

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

@@ -0,0 +1,33 @@
+import { cwd } from 'node:process';
+import { emitError, emitSuccess, jsonMode } from '../../core/output/index.js';
+import { setFeatureWorktree } from '../../core/specs/worktree.js';
+export function registerWorktreeCommand(program) {
+    const worktree = program
+        .command('worktree')
+        .description('Manage the git branch + worktree pointer recorded on a feature');
+    worktree
+        .command('set')
+        .description('Record the git branch and worktree path backing a feature')
+        .argument('<slug>', 'feature folder slug')
+        .requiredOption('--branch <branch>', 'git branch backing the feature')
+        .requiredOption('--path <path>', 'worktree path backing the feature')
+        .option('--json', 'output as structured JSON')
+        .action(async (slug, options, command) => {
+        const json = jsonMode(command);
+        try {
+            const result = await setFeatureWorktree(cwd(), slug, {
+                branch: options.branch,
+                path: options.path,
+            });
+            emitSuccess({ action: 'worktree-set', ...result }, json, [
+                `feature ${result.slug}: worktree recorded`,
+                `  branch:   ${result.branch}`,
+                `  worktree: ${result.worktreePath}`,
+            ]);
+        }
+        catch (error) {
+            emitError(error, json);
+        }
+    });
+}
+//# sourceMappingURL=worktree.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.js","sourceRoot":"","sources":["../../../../src/cli/commands/worktree.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,8BAA8B,CAAC;AAElE,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,MAAM,QAAQ,GAAG,OAAO;SACrB,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,gEAAgE,CAAC,CAAC;IAEjF,QAAQ;SACL,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,2DAA2D,CAAC;SACxE,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;SACzC,cAAc,CAAC,mBAAmB,EAAE,gCAAgC,CAAC;SACrE,cAAc,CAAC,eAAe,EAAE,mCAAmC,CAAC;SACpE,MAAM,CAAC,QAAQ,EAAE,2BAA2B,CAAC;SAC7C,MAAM,CACL,KAAK,EACH,IAAY,EACZ,OAAyD,EACzD,OAAgB,EAChB,EAAE;QACF,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE;gBACnD,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,IAAI,EAAE,OAAO,CAAC,IAAI;aACnB,CAAC,CAAC;YACH,WAAW,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE;gBACvD,WAAW,MAAM,CAAC,IAAI,qBAAqB;gBAC3C,eAAe,MAAM,CAAC,MAAM,EAAE;gBAC9B,eAAe,MAAM,CAAC,YAAY,EAAE;aACrC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACzB,CAAC;IACH,CAAC,CACF,CAAC;AACN,CAAC"}

package/dist/src/cli/index.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function buildProgram(): Command;
+export declare function isDirectExecution(moduleUrl: string, argv: readonly string[]): boolean;

package/dist/src/cli/index.js

@@ -0,0 +1,106 @@
+#!/usr/bin/env node
+import { existsSync, realpathSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { Command, CommanderError } from 'commander';
+import { ScifiError } from '../core/output/errors.js';
+import { emitError } from '../core/output/index.js';
+import { findPackageRoot } from '../core/package-root.js';
+import { registerFinishCommand } from './commands/finish.js';
+import { registerFixCommand } from './commands/fix.js';
+import { registerInitCommand } from './commands/init.js';
+import { registerListCommand } from './commands/list.js';
+import { registerPlanCommand } from './commands/plan.js';
+import { registerPlanReadyCommand } from './commands/plan-ready.js';
+import { registerSpecCommand } from './commands/spec.js';
+import { registerSpecReadyCommand } from './commands/spec-ready.js';
+import { registerStartCommand } from './commands/start.js';
+import { registerStatusCommand } from './commands/status.js';
+import { registerTaskCommand } from './commands/task.js';
+import { registerWorktreeCommand } from './commands/worktree.js';
+const require = createRequire(import.meta.url);
+const packageJson = require(join(findPackageRoot(import.meta.url), 'package.json'));
+function readPackageVersion(value) {
+    if (typeof value === 'object' &&
+        value !== null &&
+        'version' in value &&
+        typeof value.version === 'string') {
+        return value.version;
+    }
+    throw new Error('Unable to read version from package.json');
+}
+export function buildProgram() {
+    const program = new Command();
+    program
+        .name('scifi')
+        .description('Specification-driven CLI scaffolding for agentic workflows')
+        .version(readPackageVersion(packageJson))
+        .exitOverride();
+    registerInitCommand(program);
+    registerSpecCommand(program);
+    registerSpecReadyCommand(program);
+    registerPlanCommand(program);
+    registerPlanReadyCommand(program);
+    registerStartCommand(program);
+    registerFinishCommand(program);
+    registerListCommand(program);
+    registerStatusCommand(program);
+    registerTaskCommand(program);
+    registerFixCommand(program);
+    registerWorktreeCommand(program);
+    applyExitOverride(program);
+    return program;
+}
+function applyExitOverride(command) {
+    // Suppress Commander's own "error: ..." line so usage failures surface only
+    // through the structured emitError output (avoids double-printing).
+    command.configureOutput({ writeErr: () => { } });
+    for (const child of command.commands) {
+        child.exitOverride();
+        applyExitOverride(child);
+    }
+}
+export function isDirectExecution(moduleUrl, argv) {
+    const scriptPath = argv[1];
+    if (scriptPath === undefined) {
+        return false;
+    }
+    return normalizeExecutionPath(fileURLToPath(moduleUrl)) === normalizeExecutionPath(scriptPath);
+}
+function normalizeExecutionPath(path) {
+    const resolvedPath = resolve(path);
+    if (!existsSync(resolvedPath)) {
+        return resolvedPath;
+    }
+    return realpathSync(resolvedPath);
+}
+function handleCliError(error, argv) {
+    const json = argv.includes('--json');
+    if (error instanceof CommanderError) {
+        // Help/version requests exit cleanly; Commander already wrote output.
+        if (error.exitCode === 0) {
+            process.exitCode = 0;
+            return;
+        }
+        const message = error.message.replace(/^error:\s*/i, '');
+        emitError(new ScifiError('INVALID_ARGUMENT', message, {
+            hint: 'Run `scifi --help` (or `<command> --help`) for usage.',
+            cause: error,
+        }), json);
+        return;
+    }
+    emitError(error, json);
+}
+async function runCli(argv) {
+    try {
+        await buildProgram().parseAsync(argv);
+    }
+    catch (error) {
+        handleCliError(error, argv);
+    }
+}
+if (isDirectExecution(import.meta.url, process.argv)) {
+    await runCli(process.argv);
+}
+//# sourceMappingURL=index.js.map

package/dist/src/cli/index.js.map

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

package/dist/src/core/bugs/create.d.ts

@@ -0,0 +1,13 @@
+import type { BugSeverity } from './types.js';
+export interface CreateBugOptions {
+    projectRoot: string;
+    description: string;
+    relatedFeature?: string;
+    severity?: BugSeverity;
+    now: string;
+}
+export interface CreateBugResult {
+    id: string;
+    filePath: string;
+}
+export declare function createBug(options: CreateBugOptions): Promise<CreateBugResult>;

package/dist/src/core/bugs/create.js

@@ -0,0 +1,28 @@
+import { mkdir, readdir } from 'node:fs/promises';
+import { slugify } from '../slugify.js';
+import { writeBugFile } from './frontmatter.js';
+import { formatBugId } from './id.js';
+import { buildBugFilePath, buildBugsRootPath } from './paths.js';
+export async function createBug(options) {
+    const { projectRoot, description, relatedFeature, severity, now } = options;
+    const bugsRoot = buildBugsRootPath(projectRoot);
+    await mkdir(bugsRoot, { recursive: true });
+    const existing = await readdir(bugsRoot, { withFileTypes: true });
+    const mdCount = existing.filter((e) => e.isFile() && e.name.endsWith('.md')).length;
+    const id = formatBugId(mdCount + 1);
+    const slug = slugify(description);
+    const filePath = buildBugFilePath(projectRoot, id, slug);
+    await writeBugFile(filePath, {
+        frontmatter: {
+            id,
+            slug,
+            status: 'open',
+            ...(severity !== undefined && { severity }),
+            ...(relatedFeature !== undefined && { 'related-feature': relatedFeature }),
+            created: now,
+        },
+        body: `# ${description}\n`,
+    });
+    return { id, filePath };
+}
+//# sourceMappingURL=create.js.map

package/dist/src/core/bugs/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../../src/core/bugs/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAgBjE,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAyB;IACvD,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IAC5E,MAAM,QAAQ,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAEhD,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE3C,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IAEpF,MAAM,EAAE,GAAG,WAAW,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,WAAW,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IAEzD,MAAM,YAAY,CAAC,QAAQ,EAAE;QAC3B,WAAW,EAAE;YACX,EAAE;YACF,IAAI;YACJ,MAAM,EAAE,MAAM;YACd,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,CAAC;YAC3C,GAAG,CAAC,cAAc,KAAK,SAAS,IAAI,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAC;YAC1E,OAAO,EAAE,GAAG;SACb;QACD,IAAI,EAAE,KAAK,WAAW,IAAI;KAC3B,CAAC,CAAC;IAEH,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC;AAC1B,CAAC"}

package/dist/src/core/bugs/frontmatter.d.ts

@@ -0,0 +1,7 @@
+import { type BugFrontmatter } from './types.js';
+export interface BugFile {
+    frontmatter: BugFrontmatter;
+    body: string;
+}
+export declare function readBugFile(filePath: string): Promise<BugFile>;
+export declare function writeBugFile(filePath: string, file: BugFile): Promise<void>;

package/dist/src/core/bugs/frontmatter.js

@@ -0,0 +1,65 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+import { BUG_SEVERITY_VALUES, BUG_STATUS_VALUES, } from './types.js';
+const FRONTMATTER_PATTERN = /^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/;
+function isValidBugStatus(value) {
+    return typeof value === 'string' && BUG_STATUS_VALUES.includes(value);
+}
+function isValidBugSeverity(value) {
+    return typeof value === 'string' && BUG_SEVERITY_VALUES.includes(value);
+}
+function isValidRawBugFrontmatter(raw) {
+    if (typeof raw !== 'object' || raw === null)
+        return false;
+    const obj = raw;
+    return (typeof obj.id === 'string' &&
+        typeof obj.slug === 'string' &&
+        isValidBugStatus(obj.status) &&
+        (obj.severity === undefined || isValidBugSeverity(obj.severity)) &&
+        (typeof obj['related-feature'] === 'string' || obj['related-feature'] === undefined) &&
+        typeof obj.created === 'string');
+}
+export async function readBugFile(filePath) {
+    const content = await readFile(filePath, 'utf8');
+    const match = FRONTMATTER_PATTERN.exec(content);
+    if (!match) {
+        throw new Error(`Bug file at ${filePath} is missing YAML frontmatter.`);
+    }
+    const raw = parseYaml(match[1] ?? '');
+    if (!isValidRawBugFrontmatter(raw)) {
+        throw new Error(`Bug file at ${filePath} has invalid frontmatter.`);
+    }
+    const frontmatter = {
+        id: raw.id,
+        slug: raw.slug,
+        status: raw.status,
+        created: raw.created,
+    };
+    if (raw.severity !== undefined) {
+        frontmatter.severity = raw.severity;
+    }
+    if (raw['related-feature'] !== undefined) {
+        frontmatter['related-feature'] = raw['related-feature'];
+    }
+    return {
+        frontmatter,
+        body: match[2] ?? '',
+    };
+}
+export async function writeBugFile(filePath, file) {
+    const rawFrontmatter = {
+        id: file.frontmatter.id,
+        slug: file.frontmatter.slug,
+        status: file.frontmatter.status,
+        ...(file.frontmatter.severity !== undefined && {
+            severity: file.frontmatter.severity,
+        }),
+        ...(file.frontmatter['related-feature'] !== undefined && {
+            'related-feature': file.frontmatter['related-feature'],
+        }),
+        created: file.frontmatter.created,
+    };
+    const content = `---\n${stringifyYaml(rawFrontmatter)}---\n${file.body}`;
+    await writeFile(filePath, content, 'utf8');
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/src/core/bugs/frontmatter.js.map

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

package/dist/src/core/bugs/id.d.ts

@@ -0,0 +1 @@
+export declare function formatBugId(sequenceNumber: number): string;

package/dist/src/core/bugs/id.js

@@ -0,0 +1,4 @@
+export function formatBugId(sequenceNumber) {
+    return `BUG-${sequenceNumber.toString().padStart(4, '0')}`;
+}
+//# sourceMappingURL=id.js.map

package/dist/src/core/bugs/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../../../src/core/bugs/id.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,WAAW,CAAC,cAAsB;IAChD,OAAO,OAAO,cAAc,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AAC7D,CAAC"}

package/dist/src/core/bugs/paths.d.ts

@@ -0,0 +1,2 @@
+export declare function buildBugsRootPath(projectRoot: string): string;
+export declare function buildBugFilePath(projectRoot: string, id: string, slug: string): string;

package/dist/src/core/bugs/paths.js

@@ -0,0 +1,8 @@
+import { join } from 'node:path';
+export function buildBugsRootPath(projectRoot) {
+    return join(projectRoot, 'bugs');
+}
+export function buildBugFilePath(projectRoot, id, slug) {
+    return join(buildBugsRootPath(projectRoot), `${id}-${slug}.md`);
+}
+//# sourceMappingURL=paths.js.map

package/dist/src/core/bugs/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../../src/core/bugs/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACnD,OAAO,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,WAAmB,EAAE,EAAU,EAAE,IAAY;IAC5E,OAAO,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,EAAE,GAAG,EAAE,IAAI,IAAI,KAAK,CAAC,CAAC;AAClE,CAAC"}

package/dist/src/core/bugs/types.d.ts

@@ -0,0 +1,12 @@
+export declare const BUG_STATUS_VALUES: readonly ["open", "in-progress", "resolved", "wont-fix"];
+export type BugStatus = (typeof BUG_STATUS_VALUES)[number];
+export declare const BUG_SEVERITY_VALUES: readonly ["low", "medium", "high", "critical"];
+export type BugSeverity = (typeof BUG_SEVERITY_VALUES)[number];
+export interface BugFrontmatter {
+    id: string;
+    slug: string;
+    status: BugStatus;
+    severity?: BugSeverity;
+    'related-feature'?: string;
+    created: string;
+}

package/dist/src/core/bugs/types.js

@@ -0,0 +1,3 @@
+export const BUG_STATUS_VALUES = ['open', 'in-progress', 'resolved', 'wont-fix'];
+export const BUG_SEVERITY_VALUES = ['low', 'medium', 'high', 'critical'];
+//# sourceMappingURL=types.js.map

package/dist/src/core/bugs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/core/bugs/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,CAAU,CAAC;AAI1F,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAU,CAAC"}

package/dist/src/core/fixes/create.d.ts

@@ -0,0 +1,11 @@
+export interface CreateFixOptions {
+    projectRoot: string;
+    description: string;
+    featureSlug: string;
+    now: string;
+}
+export interface CreateFixResult {
+    id: string;
+    filePath: string;
+}
+export declare function createFix(options: CreateFixOptions): Promise<CreateFixResult>;

package/dist/src/core/fixes/create.js

@@ -0,0 +1,43 @@
+import { mkdir, readdir, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+import { ScifiError } from '../output/errors.js';
+import { slugify } from '../slugify.js';
+import { buildFeatureDirectoryPath } from '../specs/paths.js';
+import { writeFixFile } from './frontmatter.js';
+import { formatFixId } from './id.js';
+import { buildFixesDirectoryPath, buildFixFilePath } from './paths.js';
+function isMissingPathError(error) {
+    return error instanceof Error && 'code' in error && error.code === 'ENOENT';
+}
+export async function createFix(options) {
+    const { projectRoot, description, featureSlug, now } = options;
+    const featureDir = buildFeatureDirectoryPath(projectRoot, featureSlug);
+    const metadataPath = join(featureDir, '.scifi.json');
+    await stat(metadataPath).catch((error) => {
+        if (isMissingPathError(error)) {
+            throw new ScifiError('NOT_FOUND', `Feature "${featureSlug}" does not exist.`, {
+                hint: `Create it with \`scifi spec ${featureSlug}\`.`,
+            });
+        }
+        throw error;
+    });
+    const fixesDir = buildFixesDirectoryPath(projectRoot, featureSlug);
+    await mkdir(fixesDir, { recursive: true });
+    const existing = await readdir(fixesDir, { withFileTypes: true });
+    const mdCount = existing.filter((e) => e.isFile() && e.name.endsWith('.md')).length;
+    const id = formatFixId(mdCount + 1);
+    const slug = slugify(description);
+    const filePath = buildFixFilePath(projectRoot, featureSlug, id, slug);
+    await writeFixFile(filePath, {
+        frontmatter: {
+            id,
+            slug,
+            status: 'open',
+            feature: featureSlug,
+            created: now,
+        },
+        body: `# ${description}\n`,
+    });
+    return { id, filePath };
+}
+//# sourceMappingURL=create.js.map

package/dist/src/core/fixes/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../../src/core/fixes/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEvE,SAAS,kBAAkB,CAAC,KAAc;IACxC,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;AAC9E,CAAC;AAcD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAyB;IACvD,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IAE/D,MAAM,UAAU,GAAG,yBAAyB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IACvE,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IACrD,MAAM,IAAI,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QAChD,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,UAAU,CAAC,WAAW,EAAE,YAAY,WAAW,mBAAmB,EAAE;gBAC5E,IAAI,EAAE,+BAA+B,WAAW,KAAK;aACtD,CAAC,CAAC;QACL,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,uBAAuB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IACnE,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE3C,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IAEpF,MAAM,EAAE,GAAG,WAAW,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,WAAW,EAAE,WAAW,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IAEtE,MAAM,YAAY,CAAC,QAAQ,EAAE;QAC3B,WAAW,EAAE;YACX,EAAE;YACF,IAAI;YACJ,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,WAAW;YACpB,OAAO,EAAE,GAAG;SACb;QACD,IAAI,EAAE,KAAK,WAAW,IAAI;KAC3B,CAAC,CAAC;IAEH,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC;AAC1B,CAAC"}

package/dist/src/core/fixes/frontmatter.d.ts

@@ -0,0 +1,7 @@
+import { type FixFrontmatter } from './types.js';
+export interface FixFile {
+    frontmatter: FixFrontmatter;
+    body: string;
+}
+export declare function readFixFile(filePath: string): Promise<FixFile>;
+export declare function writeFixFile(filePath: string, file: FixFile): Promise<void>;

package/dist/src/core/fixes/frontmatter.js

@@ -0,0 +1,50 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+import { FIX_STATUS_VALUES } from './types.js';
+const FRONTMATTER_PATTERN = /^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/;
+function isValidFixStatus(value) {
+    return typeof value === 'string' && FIX_STATUS_VALUES.includes(value);
+}
+function isValidRawFixFrontmatter(raw) {
+    if (typeof raw !== 'object' || raw === null)
+        return false;
+    const obj = raw;
+    return (typeof obj.id === 'string' &&
+        typeof obj.slug === 'string' &&
+        isValidFixStatus(obj.status) &&
+        typeof obj.feature === 'string' &&
+        typeof obj.created === 'string');
+}
+export async function readFixFile(filePath) {
+    const content = await readFile(filePath, 'utf8');
+    const match = FRONTMATTER_PATTERN.exec(content);
+    if (!match) {
+        throw new Error(`Fix file at ${filePath} is missing YAML frontmatter.`);
+    }
+    const raw = parseYaml(match[1] ?? '');
+    if (!isValidRawFixFrontmatter(raw)) {
+        throw new Error(`Fix file at ${filePath} has invalid frontmatter.`);
+    }
+    return {
+        frontmatter: {
+            id: raw.id,
+            slug: raw.slug,
+            status: raw.status,
+            feature: raw.feature,
+            created: raw.created,
+        },
+        body: match[2] ?? '',
+    };
+}
+export async function writeFixFile(filePath, file) {
+    const rawFrontmatter = {
+        id: file.frontmatter.id,
+        slug: file.frontmatter.slug,
+        status: file.frontmatter.status,
+        feature: file.frontmatter.feature,
+        created: file.frontmatter.created,
+    };
+    const content = `---\n${stringifyYaml(rawFrontmatter)}---\n${file.body}`;
+    await writeFile(filePath, content, 'utf8');
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/src/core/fixes/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../../../src/core/fixes/frontmatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,MAAM,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAuB,MAAM,YAAY,CAAC;AAOpE,MAAM,mBAAmB,GAAG,4CAA4C,CAAC;AAEzE,SAAS,gBAAgB,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,iBAAuC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC/F,CAAC;AAED,SAAS,wBAAwB,CAAC,GAAY;IAC5C,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC1D,MAAM,GAAG,GAAG,GAA8B,CAAC;IAC3C,OAAO,CACL,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ;QAC1B,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;QAC5B,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC;QAC5B,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;QAC/B,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAChC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB;IAChD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEhD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,eAAe,QAAQ,+BAA+B,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAY,CAAC;IAEjD,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,eAAe,QAAQ,2BAA2B,CAAC,CAAC;IACtE,CAAC;IAED,OAAO;QACL,WAAW,EAAE;YACX,EAAE,EAAE,GAAG,CAAC,EAAY;YACpB,IAAI,EAAE,GAAG,CAAC,IAAc;YACxB,MAAM,EAAE,GAAG,CAAC,MAAkC;YAC9C,OAAO,EAAE,GAAG,CAAC,OAAiB;YAC9B,OAAO,EAAE,GAAG,CAAC,OAAiB;SAC/B;QACD,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;KACrB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB,EAAE,IAAa;IAChE,MAAM,cAAc,GAA4B;QAC9C,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,EAAE;QACvB,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;QAC3B,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM;QAC/B,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO;QACjC,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO;KAClC,CAAC;IAEF,MAAM,OAAO,GAAG,QAAQ,aAAa,CAAC,cAAc,CAAC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;IACzE,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAC7C,CAAC"}

package/dist/src/core/fixes/id.d.ts

@@ -0,0 +1 @@
+export declare function formatFixId(sequenceNumber: number): string;

package/dist/src/core/fixes/id.js

@@ -0,0 +1,4 @@
+export function formatFixId(sequenceNumber) {
+    return `FIX-${sequenceNumber.toString().padStart(4, '0')}`;
+}
+//# sourceMappingURL=id.js.map

package/dist/src/core/fixes/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../../../src/core/fixes/id.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,WAAW,CAAC,cAAsB;IAChD,OAAO,OAAO,cAAc,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AAC7D,CAAC"}

package/dist/src/core/fixes/list.d.ts

@@ -0,0 +1,8 @@
+import type { FixFrontmatter } from './types.js';
+export interface FixFileLocation {
+    filePath: string;
+    frontmatter: FixFrontmatter;
+}
+export declare function listFixes(projectRoot: string, featureSlug: string): Promise<FixFrontmatter[]>;
+export declare function listOpenFixes(projectRoot: string, featureSlug: string): Promise<FixFrontmatter[]>;
+export declare function findFixById(projectRoot: string, featureSlug: string, fixId: string): Promise<FixFileLocation | undefined>;

package/dist/src/core/fixes/list.js

@@ -0,0 +1,43 @@
+import { readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { readFixFile } from './frontmatter.js';
+import { buildFixesDirectoryPath } from './paths.js';
+function isMissingPathError(error) {
+    return error instanceof Error && 'code' in error && error.code === 'ENOENT';
+}
+export async function listFixes(projectRoot, featureSlug) {
+    const fixesDir = buildFixesDirectoryPath(projectRoot, featureSlug);
+    const entries = await readdir(fixesDir, { withFileTypes: true }).catch((error) => {
+        if (isMissingPathError(error))
+            return [];
+        throw error;
+    });
+    const mdFiles = entries.filter((e) => e.isFile() && e.name.endsWith('.md'));
+    const results = await Promise.all(mdFiles.map(async (entry) => {
+        const file = await readFixFile(join(fixesDir, entry.name));
+        return file.frontmatter;
+    }));
+    return results;
+}
+export async function listOpenFixes(projectRoot, featureSlug) {
+    const fixes = await listFixes(projectRoot, featureSlug);
+    return fixes.filter((f) => f.status === 'open' || f.status === 'in-progress');
+}
+export async function findFixById(projectRoot, featureSlug, fixId) {
+    const fixesDir = buildFixesDirectoryPath(projectRoot, featureSlug);
+    const entries = await readdir(fixesDir, { withFileTypes: true }).catch((error) => {
+        if (isMissingPathError(error))
+            return [];
+        throw error;
+    });
+    const mdFiles = entries.filter((e) => e.isFile() && e.name.endsWith('.md'));
+    for (const entry of mdFiles) {
+        const filePath = join(fixesDir, entry.name);
+        const file = await readFixFile(filePath);
+        if (file.frontmatter.id === fixId) {
+            return { filePath, frontmatter: file.frontmatter };
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=list.js.map

package/dist/src/core/fixes/list.js.map

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

package/dist/src/core/fixes/paths.d.ts

@@ -0,0 +1,2 @@
+export declare function buildFixesDirectoryPath(projectRoot: string, featureSlug: string): string;
+export declare function buildFixFilePath(projectRoot: string, featureSlug: string, id: string, slug: string): string;

package/dist/src/core/fixes/paths.js

@@ -0,0 +1,9 @@
+import { join } from 'node:path';
+import { buildFeatureDirectoryPath } from '../specs/paths.js';
+export function buildFixesDirectoryPath(projectRoot, featureSlug) {
+    return join(buildFeatureDirectoryPath(projectRoot, featureSlug), 'fixes');
+}
+export function buildFixFilePath(projectRoot, featureSlug, id, slug) {
+    return join(buildFixesDirectoryPath(projectRoot, featureSlug), `${id}-${slug}.md`);
+}
+//# sourceMappingURL=paths.js.map

package/dist/src/core/fixes/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../../src/core/fixes/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,MAAM,UAAU,uBAAuB,CAAC,WAAmB,EAAE,WAAmB;IAC9E,OAAO,IAAI,CAAC,yBAAyB,CAAC,WAAW,EAAE,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,WAAmB,EACnB,WAAmB,EACnB,EAAU,EACV,IAAY;IAEZ,OAAO,IAAI,CAAC,uBAAuB,CAAC,WAAW,EAAE,WAAW,CAAC,EAAE,GAAG,EAAE,IAAI,IAAI,KAAK,CAAC,CAAC;AACrF,CAAC"}

package/dist/src/core/fixes/transition.d.ts

@@ -0,0 +1,9 @@
+import type { FixStatus } from './types.js';
+export interface UpdateFixStatusResult {
+    featureSlug: string;
+    id: string;
+    slug: string;
+    previousStatus: FixStatus;
+    newStatus: FixStatus;
+}
+export declare function updateFixStatus(projectRoot: string, featureSlug: string, fixId: string, targetStatus: FixStatus): Promise<UpdateFixStatusResult>;

package/dist/src/core/fixes/transition.js

@@ -0,0 +1,26 @@
+import { ScifiError } from '../output/errors.js';
+import { readFixFile, writeFixFile } from './frontmatter.js';
+import { findFixById } from './list.js';
+export async function updateFixStatus(projectRoot, featureSlug, fixId, targetStatus) {
+    const location = await findFixById(projectRoot, featureSlug, fixId);
+    if (location === undefined) {
+        throw new ScifiError('NOT_FOUND', `Fix "${fixId}" does not exist in feature "${featureSlug}".`, { hint: "Run `scifi status <slug>` to see this feature's fixes." });
+    }
+    const previousStatus = location.frontmatter.status;
+    if (previousStatus !== 'open' && previousStatus !== 'in-progress') {
+        throw new ScifiError('PRECONDITION_FAILED', `Cannot transition fix ${fixId}: it is already ${previousStatus}.`, { hint: 'Only open or in-progress fixes can be resolved or marked wont-fix.' });
+    }
+    const file = await readFixFile(location.filePath);
+    await writeFixFile(location.filePath, {
+        ...file,
+        frontmatter: { ...file.frontmatter, status: targetStatus },
+    });
+    return {
+        featureSlug,
+        id: file.frontmatter.id,
+        slug: file.frontmatter.slug,
+        previousStatus,
+        newStatus: targetStatus,
+    };
+}
+//# sourceMappingURL=transition.js.map

package/dist/src/core/fixes/transition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transition.js","sourceRoot":"","sources":["../../../../src/core/fixes/transition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAWxC,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,WAAmB,EACnB,WAAmB,EACnB,KAAa,EACb,YAAuB;IAEvB,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,WAAW,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;IAEpE,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,UAAU,CAClB,WAAW,EACX,QAAQ,KAAK,gCAAgC,WAAW,IAAI,EAC5D,EAAE,IAAI,EAAE,wDAAwD,EAAE,CACnE,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAG,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC;IAEnD,IAAI,cAAc,KAAK,MAAM,IAAI,cAAc,KAAK,aAAa,EAAE,CAAC;QAClE,MAAM,IAAI,UAAU,CAClB,qBAAqB,EACrB,yBAAyB,KAAK,mBAAmB,cAAc,GAAG,EAClE,EAAE,IAAI,EAAE,oEAAoE,EAAE,CAC/E,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAElD,MAAM,YAAY,CAAC,QAAQ,CAAC,QAAQ,EAAE;QACpC,GAAG,IAAI;QACP,WAAW,EAAE,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE;KAC3D,CAAC,CAAC;IAEH,OAAO;QACL,WAAW;QACX,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,EAAE;QACvB,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;QAC3B,cAAc;QACd,SAAS,EAAE,YAAY;KACxB,CAAC;AACJ,CAAC"}

package/dist/src/core/fixes/types.d.ts

@@ -0,0 +1,9 @@
+export declare const FIX_STATUS_VALUES: readonly ["open", "in-progress", "resolved", "wont-fix"];
+export type FixStatus = (typeof FIX_STATUS_VALUES)[number];
+export interface FixFrontmatter {
+    id: string;
+    slug: string;
+    status: FixStatus;
+    feature: string;
+    created: string;
+}

package/dist/src/core/fixes/types.js

@@ -0,0 +1,2 @@
+export const FIX_STATUS_VALUES = ['open', 'in-progress', 'resolved', 'wont-fix'];
+//# sourceMappingURL=types.js.map

package/dist/src/core/fixes/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/core/fixes/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,CAAU,CAAC"}