@kamilmarzynski/scifi 0.1.1

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

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+declare const skillManifestSchema: z.ZodObject<{
+    id: z.ZodString;
+    description: z.ZodString;
+    allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    argumentHint: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export { skillManifestSchema };
+export type SkillManifest = z.infer<typeof skillManifestSchema>;
+export interface SkillAsset {
+    readonly name: string;
+    readonly contents: string;
+}
+export interface SkillBundle {
+    readonly manifest: SkillManifest;
+    readonly body: string;
+    readonly assets: readonly SkillAsset[];
+}

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

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+const skillManifestSchema = z.object({
+    id: z.string().min(1),
+    description: z.string().min(1),
+    allowedTools: z.array(z.string()).optional(),
+    argumentHint: z.string().optional(),
+});
+export { skillManifestSchema };
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/core/skills/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC5C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC;AAEH,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/src/core/slugify.d.ts

@@ -0,0 +1,2 @@
+export declare function assertSafeSlug(value: string, label: string): void;
+export declare function slugify(text: string): string;

package/dist/src/core/slugify.js

@@ -0,0 +1,13 @@
+const SAFE_SLUG_RE = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+export function assertSafeSlug(value, label) {
+    if (!SAFE_SLUG_RE.test(value)) {
+        throw new Error(`Invalid ${label} "${value}". Use lowercase letters, numbers, and single hyphens.`);
+    }
+}
+export function slugify(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+//# sourceMappingURL=slugify.js.map

package/dist/src/core/slugify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slugify.js","sourceRoot":"","sources":["../../../src/core/slugify.ts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAAG,0BAA0B,CAAC;AAEhD,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,KAAa;IACzD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,WAAW,KAAK,KAAK,KAAK,wDAAwD,CACnF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,IAAI;SACR,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC"}

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

@@ -0,0 +1,11 @@
+export interface CreateFeatureOptions {
+    projectRoot: string;
+    slug: string;
+    title?: string;
+    now: string;
+}
+export interface CreateFeatureResult {
+    featureDirectoryPath: string;
+    metadataPath: string;
+}
+export declare function createFeature(options: CreateFeatureOptions): Promise<CreateFeatureResult>;

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

@@ -0,0 +1,35 @@
+import { mkdir, stat, writeFile } from 'node:fs/promises';
+import { ScifiError } from '../output/errors.js';
+import { createInitialFeatureMetadata } from './metadata.js';
+import { buildFeatureDirectoryPath, buildFeatureMetadataPath, buildFeaturesRootPath, } from './paths.js';
+export async function createFeature(options) {
+    const { projectRoot, slug, title, now } = options;
+    const featuresRootPath = buildFeaturesRootPath(projectRoot);
+    const featureDirectoryPath = buildFeatureDirectoryPath(projectRoot, slug);
+    const metadataPath = buildFeatureMetadataPath(projectRoot, slug);
+    const existingFeatureDirectory = await stat(featureDirectoryPath).catch((error) => {
+        if (isMissingPathError(error)) {
+            return null;
+        }
+        throw error;
+    });
+    if (existingFeatureDirectory !== null) {
+        throw new ScifiError('CONFLICT', `Cannot create feature ${slug}: ${featureDirectoryPath} already exists.`, { hint: 'Choose a different slug or inspect it with `scifi status <slug>`.' });
+    }
+    await mkdir(featuresRootPath, { recursive: true });
+    await mkdir(featureDirectoryPath, { recursive: false });
+    const metadata = createInitialFeatureMetadata({
+        slug,
+        ...(title !== undefined && { title }),
+        createdAt: now,
+    });
+    await writeFile(metadataPath, `${JSON.stringify(metadata, null, 2)}\n`, 'utf8');
+    return {
+        featureDirectoryPath,
+        metadataPath,
+    };
+}
+function isMissingPathError(error) {
+    return error instanceof Error && 'code' in error && error.code === 'ENOENT';
+}
+//# sourceMappingURL=create.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../../src/core/specs/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAcpB,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAA6B;IAC/D,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IAClD,MAAM,gBAAgB,GAAG,qBAAqB,CAAC,WAAW,CAAC,CAAC;IAC5D,MAAM,oBAAoB,GAAG,yBAAyB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAC1E,MAAM,YAAY,GAAG,wBAAwB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAEjE,MAAM,wBAAwB,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,CAAC,KAAK,CACrE,CAAC,KAAc,EAAQ,EAAE;QACvB,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,KAAK,CAAC;IACd,CAAC,CACF,CAAC;IAEF,IAAI,wBAAwB,KAAK,IAAI,EAAE,CAAC;QACtC,MAAM,IAAI,UAAU,CAClB,UAAU,EACV,yBAAyB,IAAI,KAAK,oBAAoB,kBAAkB,EACxE,EAAE,IAAI,EAAE,mEAAmE,EAAE,CAC9E,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,CAAC,gBAAgB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEnD,MAAM,KAAK,CAAC,oBAAoB,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IAExD,MAAM,QAAQ,GAAG,4BAA4B,CAAC;QAC5C,IAAI;QACJ,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,CAAC;QACrC,SAAS,EAAE,GAAG;KACf,CAAC,CAAC;IAEH,MAAM,SAAS,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAEhF,OAAO;QACL,oBAAoB;QACpB,YAAY;KACb,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACxC,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;AAC9E,CAAC"}

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

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

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

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

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

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

package/dist/src/core/specs/lifecycle.d.ts

@@ -0,0 +1,17 @@
+import type { FeatureMetadata, FeatureStatus } from './types.js';
+export interface FeatureArtifacts {
+    specExists: boolean;
+    designExists: boolean;
+    taskFileCount: number;
+}
+export interface FeatureLifecycle {
+    metadata: FeatureMetadata;
+    artifacts: FeatureArtifacts;
+}
+export declare function inspectFeatureLifecycle(projectRoot: string, slug: string): Promise<FeatureLifecycle>;
+interface ValidationContext {
+    currentStatus?: FeatureStatus;
+    allTasksDone?: boolean;
+}
+export declare function validateStatusTransition(artifacts: FeatureArtifacts, targetStatus: FeatureStatus, context?: ValidationContext): Promise<void>;
+export {};

package/dist/src/core/specs/lifecycle.js

@@ -0,0 +1,97 @@
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+import { ScifiError } from '../output/errors.js';
+import { buildFeatureDirectoryPath, buildFeatureMetadataPath } from './paths.js';
+function isMissingPathError(error) {
+    return error instanceof Error && 'code' in error && error.code === 'ENOENT';
+}
+async function pathIsRegularFile(filePath) {
+    try {
+        const entry = await stat(filePath);
+        return entry.isFile();
+    }
+    catch (error) {
+        if (isMissingPathError(error)) {
+            return false;
+        }
+        throw error;
+    }
+}
+function isValidFeatureMetadata(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const obj = value;
+    return ('version' in obj &&
+        typeof obj.version === 'number' &&
+        'slug' in obj &&
+        typeof obj.slug === 'string' &&
+        'status' in obj &&
+        typeof obj.status === 'string' &&
+        'createdAt' in obj &&
+        typeof obj.createdAt === 'string' &&
+        'updatedAt' in obj &&
+        typeof obj.updatedAt === 'string');
+}
+export async function inspectFeatureLifecycle(projectRoot, slug) {
+    const featureRoot = buildFeatureDirectoryPath(projectRoot, slug);
+    const metadataPath = buildFeatureMetadataPath(projectRoot, slug);
+    const rawMetadata = await readFile(metadataPath, 'utf8').catch((error) => {
+        if (isMissingPathError(error)) {
+            throw new ScifiError('NOT_FOUND', `Feature "${slug}" does not exist.`, {
+                hint: `Create it with \`scifi spec ${slug}\`.`,
+                cause: error,
+            });
+        }
+        throw error;
+    });
+    const parsed = JSON.parse(rawMetadata);
+    if (!isValidFeatureMetadata(parsed)) {
+        throw new ScifiError('INTERNAL', `Invalid metadata file at ${metadataPath}`);
+    }
+    const metadata = parsed;
+    const specExists = await pathIsRegularFile(join(featureRoot, 'spec.md'));
+    const designExists = await pathIsRegularFile(join(featureRoot, 'design.md'));
+    const taskEntries = await readdir(join(featureRoot, 'tasks'), {
+        withFileTypes: true,
+    }).catch((error) => {
+        if (isMissingPathError(error)) {
+            return [];
+        }
+        throw error;
+    });
+    const taskFileCount = taskEntries.filter((entry) => entry.isFile() && entry.name.endsWith('.md')).length;
+    return {
+        metadata,
+        artifacts: {
+            specExists,
+            designExists,
+            taskFileCount,
+        },
+    };
+}
+export async function validateStatusTransition(artifacts, targetStatus, context) {
+    if (targetStatus === 'spec-ready' && !artifacts.specExists) {
+        throw new ScifiError('PRECONDITION_FAILED', 'Cannot mark feature as spec-ready: spec.md is missing.', { hint: 'Write spec.md in the feature directory, then retry.' });
+    }
+    if (targetStatus === 'plan-ready') {
+        if (!artifacts.designExists) {
+            throw new ScifiError('PRECONDITION_FAILED', 'Cannot mark feature as plan-ready: design.md is missing.', { hint: 'Write design.md in the feature directory, then retry.' });
+        }
+        if (artifacts.taskFileCount < 1) {
+            throw new ScifiError('PRECONDITION_FAILED', 'Cannot mark feature as plan-ready: no task files were found.', { hint: "Add at least one task under the feature's tasks/ directory." });
+        }
+    }
+    if (targetStatus === 'in-progress' &&
+        context?.currentStatus !== undefined &&
+        context.currentStatus !== 'plan-ready' &&
+        // Starting an already in-progress feature is an idempotent no-op so a
+        // resumed run (e.g. via sf-continue) passes through instead of failing.
+        context.currentStatus !== 'in-progress') {
+        throw new ScifiError('PRECONDITION_FAILED', 'Cannot start feature: feature must be plan-ready before starting implementation.', { hint: 'Run `scifi plan-ready <slug>` first.' });
+    }
+    if (targetStatus === 'done' && context?.allTasksDone === false) {
+        throw new ScifiError('PRECONDITION_FAILED', 'Cannot mark feature as done: not all tasks are complete.', { hint: 'Finish remaining tasks with `scifi task done <slug> <task>`.' });
+    }
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/src/core/specs/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../../../src/core/specs/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAcjF,SAAS,kBAAkB,CAAC,KAAc;IACxC,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;AAC9E,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,QAAgB;IAC/C,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAc;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,GAAG,GAAG,KAAgC,CAAC;IAE7C,OAAO,CACL,SAAS,IAAI,GAAG;QAChB,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;QAC/B,MAAM,IAAI,GAAG;QACb,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;QAC5B,QAAQ,IAAI,GAAG;QACf,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ;QAC9B,WAAW,IAAI,GAAG;QAClB,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ;QACjC,WAAW,IAAI,GAAG;QAClB,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,CAClC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,WAAmB,EACnB,IAAY;IAEZ,MAAM,WAAW,GAAG,yBAAyB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IACjE,MAAM,YAAY,GAAG,wBAAwB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IACjE,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAS,EAAE;QACvF,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,UAAU,CAAC,WAAW,EAAE,YAAY,IAAI,mBAAmB,EAAE;gBACrE,IAAI,EAAE,+BAA+B,IAAI,KAAK;gBAC9C,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAEvC,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,UAAU,CAAC,UAAU,EAAE,4BAA4B,YAAY,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC;IAExB,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;IACzE,MAAM,YAAY,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;IAC7E,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE;QAC5D,aAAa,EAAE,IAAI;KACpB,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QAC1B,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC,CAAC,CAAC;IACH,MAAM,aAAa,GAAG,WAAW,CAAC,MAAM,CACtC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CACxD,CAAC,MAAM,CAAC;IAET,OAAO;QACL,QAAQ;QACR,SAAS,EAAE;YACT,UAAU;YACV,YAAY;YACZ,aAAa;SACd;KACF,CAAC;AACJ,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,SAA2B,EAC3B,YAA2B,EAC3B,OAA2B;IAE3B,IAAI,YAAY,KAAK,YAAY,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;QAC3D,MAAM,IAAI,UAAU,CAClB,qBAAqB,EACrB,wDAAwD,EACxD,EAAE,IAAI,EAAE,qDAAqD,EAAE,CAChE,CAAC;IACJ,CAAC;IAED,IAAI,YAAY,KAAK,YAAY,EAAE,CAAC;QAClC,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC;YAC5B,MAAM,IAAI,UAAU,CAClB,qBAAqB,EACrB,0DAA0D,EAC1D,EAAE,IAAI,EAAE,uDAAuD,EAAE,CAClE,CAAC;QACJ,CAAC;QACD,IAAI,SAAS,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,UAAU,CAClB,qBAAqB,EACrB,8DAA8D,EAC9D,EAAE,IAAI,EAAE,6DAA6D,EAAE,CACxE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IACE,YAAY,KAAK,aAAa;QAC9B,OAAO,EAAE,aAAa,KAAK,SAAS;QACpC,OAAO,CAAC,aAAa,KAAK,YAAY;QACtC,sEAAsE;QACtE,wEAAwE;QACxE,OAAO,CAAC,aAAa,KAAK,aAAa,EACvC,CAAC;QACD,MAAM,IAAI,UAAU,CAClB,qBAAqB,EACrB,kFAAkF,EAClF,EAAE,IAAI,EAAE,sCAAsC,EAAE,CACjD,CAAC;IACJ,CAAC;IAED,IAAI,YAAY,KAAK,MAAM,IAAI,OAAO,EAAE,YAAY,KAAK,KAAK,EAAE,CAAC;QAC/D,MAAM,IAAI,UAAU,CAClB,qBAAqB,EACrB,0DAA0D,EAC1D,EAAE,IAAI,EAAE,8DAA8D,EAAE,CACzE,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,6 @@
+import type { FeatureMetadata, FeatureStatus } from './types.js';
+export interface ListFeaturesOptions {
+    projectRoot: string;
+    status?: FeatureStatus;
+}
+export declare function listFeatures(options: ListFeaturesOptions): Promise<FeatureMetadata[]>;

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

@@ -0,0 +1,43 @@
+import { readdir, readFile } from 'node:fs/promises';
+import { buildFeatureMetadataPath, buildFeaturesRootPath } from './paths.js';
+function isMissingPathError(error) {
+    return error instanceof Error && 'code' in error && error.code === 'ENOENT';
+}
+function isValidFeatureMetadata(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const obj = value;
+    return ('version' in obj &&
+        typeof obj.version === 'number' &&
+        'slug' in obj &&
+        typeof obj.slug === 'string' &&
+        'status' in obj &&
+        typeof obj.status === 'string' &&
+        'createdAt' in obj &&
+        typeof obj.createdAt === 'string' &&
+        'updatedAt' in obj &&
+        typeof obj.updatedAt === 'string');
+}
+export async function listFeatures(options) {
+    const { projectRoot, status } = options;
+    const specsRoot = buildFeaturesRootPath(projectRoot);
+    const entries = await readdir(specsRoot, { withFileTypes: true }).catch((error) => {
+        if (isMissingPathError(error))
+            return [];
+        throw error;
+    });
+    const featureDirs = entries.filter((entry) => entry.isDirectory());
+    const allResults = await Promise.all(featureDirs.map(async (dir) => {
+        const metadataPath = buildFeatureMetadataPath(projectRoot, dir.name);
+        const raw = JSON.parse(await readFile(metadataPath, 'utf8'));
+        if (!isValidFeatureMetadata(raw))
+            return null;
+        return raw;
+    }));
+    const features = allResults.filter((m) => m !== null);
+    if (status !== undefined) {
+        return features.filter((f) => f.status === status);
+    }
+    return features;
+}
+//# sourceMappingURL=list.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../src/core/specs/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAG7E,SAAS,kBAAkB,CAAC,KAAc;IACxC,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;AAC9E,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAc;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,OAAO,CACL,SAAS,IAAI,GAAG;QAChB,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;QAC/B,MAAM,IAAI,GAAG;QACb,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;QAC5B,QAAQ,IAAI,GAAG;QACf,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ;QAC9B,WAAW,IAAI,GAAG;QAClB,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ;QACjC,WAAW,IAAI,GAAG;QAClB,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,CAClC,CAAC;AACJ,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAA4B;IAC7D,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IACxC,MAAM,SAAS,GAAG,qBAAqB,CAAC,WAAW,CAAC,CAAC;IAErD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QACzF,IAAI,kBAAkB,CAAC,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACzC,MAAM,KAAK,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IAEnE,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,GAAG,CAClC,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAC5B,MAAM,YAAY,GAAG,wBAAwB,CAAC,WAAW,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QACrE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAY,CAAC;QACxE,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAC9C,OAAO,GAAG,CAAC;IACb,CAAC,CAAC,CACH,CAAC;IAEF,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAwB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IAE5E,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/src/core/specs/metadata.d.ts

@@ -0,0 +1,3 @@
+import type { CreateFeatureMetadataInput, FeatureMetadata } from './types.js';
+export { buildFeatureDirectoryPath, buildFeatureMetadataPath, } from './paths.js';
+export declare function createInitialFeatureMetadata(input: CreateFeatureMetadataInput): FeatureMetadata;

package/dist/src/core/specs/metadata.js

@@ -0,0 +1,13 @@
+export { buildFeatureDirectoryPath, buildFeatureMetadataPath, } from './paths.js';
+export function createInitialFeatureMetadata(input) {
+    const { slug, title, createdAt } = input;
+    return {
+        version: 1,
+        slug,
+        ...(title !== undefined && { title }),
+        status: 'created',
+        createdAt,
+        updatedAt: createdAt,
+    };
+}
+//# sourceMappingURL=metadata.js.map

package/dist/src/core/specs/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../../../src/core/specs/metadata.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AAEpB,MAAM,UAAU,4BAA4B,CAAC,KAAiC;IAC5E,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;IAEzC,OAAO;QACL,OAAO,EAAE,CAAC;QACV,IAAI;QACJ,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,CAAC;QACrC,MAAM,EAAE,SAAS;QACjB,SAAS;QACT,SAAS,EAAE,SAAS;KACrB,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,3 @@
+export declare function buildFeaturesRootPath(projectRoot: string): string;
+export declare function buildFeatureDirectoryPath(projectRoot: string, slug: string): string;
+export declare function buildFeatureMetadataPath(projectRoot: string, slug: string): string;

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

@@ -0,0 +1,13 @@
+import { join } from 'node:path';
+import { assertSafeSlug } from '../slugify.js';
+export function buildFeaturesRootPath(projectRoot) {
+    return join(projectRoot, 'docs', 'scifi', 'specs');
+}
+export function buildFeatureDirectoryPath(projectRoot, slug) {
+    assertSafeSlug(slug, 'feature slug');
+    return join(buildFeaturesRootPath(projectRoot), slug);
+}
+export function buildFeatureMetadataPath(projectRoot, slug) {
+    return join(buildFeatureDirectoryPath(projectRoot, slug), '.scifi.json');
+}
+//# sourceMappingURL=paths.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../../src/core/specs/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,UAAU,qBAAqB,CAAC,WAAmB;IACvD,OAAO,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,WAAmB,EAAE,IAAY;IACzE,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IACrC,OAAO,IAAI,CAAC,qBAAqB,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,WAAmB,EAAE,IAAY;IACxE,OAAO,IAAI,CAAC,yBAAyB,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,aAAa,CAAC,CAAC;AAC3E,CAAC"}

package/dist/src/core/specs/plan-session.d.ts

@@ -0,0 +1,18 @@
+import type { FeatureStatus } from './types.js';
+/**
+ * Where a feature sits relative to its planning session.
+ *
+ * - `ready-to-plan`  — spec-ready, no design/tasks written yet (start fresh).
+ * - `in-progress`    — spec-ready with partial design/tasks (resume).
+ * - `already-planned`— plan-ready or beyond (offer continue vs restart).
+ */
+export type PlanSessionState = 'ready-to-plan' | 'in-progress' | 'already-planned';
+export interface PlanSession {
+    slug: string;
+    title?: string;
+    status: FeatureStatus;
+    state: PlanSessionState;
+    designExists: boolean;
+    taskFileCount: number;
+}
+export declare function inspectPlanSession(projectRoot: string, slug: string): Promise<PlanSession>;

package/dist/src/core/specs/plan-session.js

@@ -0,0 +1,24 @@
+import { ScifiError } from '../output/errors.js';
+import { inspectFeatureLifecycle } from './lifecycle.js';
+export async function inspectPlanSession(projectRoot, slug) {
+    const { metadata, artifacts } = await inspectFeatureLifecycle(projectRoot, slug);
+    if (metadata.status === 'created') {
+        throw new ScifiError('PRECONDITION_FAILED', `Cannot plan "${slug}": feature is not spec-ready yet.`, { hint: `Finish the spec and run \`scifi spec-ready ${slug}\` first.` });
+    }
+    let state;
+    if (metadata.status === 'spec-ready') {
+        state = artifacts.designExists || artifacts.taskFileCount > 0 ? 'in-progress' : 'ready-to-plan';
+    }
+    else {
+        state = 'already-planned';
+    }
+    return {
+        slug: metadata.slug,
+        ...(metadata.title !== undefined && { title: metadata.title }),
+        status: metadata.status,
+        state,
+        designExists: artifacts.designExists,
+        taskFileCount: artifacts.taskFileCount,
+    };
+}
+//# sourceMappingURL=plan-session.js.map

package/dist/src/core/specs/plan-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-session.js","sourceRoot":"","sources":["../../../../src/core/specs/plan-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAqBzD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,WAAmB,EAAE,IAAY;IACxE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM,uBAAuB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAEjF,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,IAAI,UAAU,CAClB,qBAAqB,EACrB,gBAAgB,IAAI,mCAAmC,EACvD,EAAE,IAAI,EAAE,8CAA8C,IAAI,WAAW,EAAE,CACxE,CAAC;IACJ,CAAC;IAED,IAAI,KAAuB,CAAC;IAC5B,IAAI,QAAQ,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;QACrC,KAAK,GAAG,SAAS,CAAC,YAAY,IAAI,SAAS,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,eAAe,CAAC;IAClG,CAAC;SAAM,CAAC;QACN,KAAK,GAAG,iBAAiB,CAAC;IAC5B,CAAC;IAED,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,GAAG,CAAC,QAAQ,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;QAC9D,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,KAAK;QACL,YAAY,EAAE,SAAS,CAAC,YAAY;QACpC,aAAa,EAAE,SAAS,CAAC,aAAa;KACvC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,8 @@
+import type { FeatureStatus } from './types.js';
+export interface UpdateFeatureStatusResult {
+    slug: string;
+    previousStatus: FeatureStatus;
+    newStatus: FeatureStatus;
+    timestamp: string;
+}
+export declare function updateFeatureStatus(projectRoot: string, slug: string, targetStatus: FeatureStatus, now: string): Promise<UpdateFeatureStatusResult>;

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

@@ -0,0 +1,33 @@
+import { writeFile } from 'node:fs/promises';
+import { listTasks } from '../tasks/list.js';
+import { inspectFeatureLifecycle, validateStatusTransition } from './lifecycle.js';
+import { buildFeatureMetadataPath } from './paths.js';
+export async function updateFeatureStatus(projectRoot, slug, targetStatus, now) {
+    const lifecycle = await inspectFeatureLifecycle(projectRoot, slug);
+    const tasks = await listTasks(projectRoot, slug);
+    const allTasksDone = tasks.length > 0 && tasks.every((t) => t.status === 'done');
+    await validateStatusTransition(lifecycle.artifacts, targetStatus, {
+        currentStatus: lifecycle.metadata.status,
+        allTasksDone,
+    });
+    const metadata = lifecycle.metadata;
+    const updatedMetadata = {
+        version: metadata.version,
+        slug: metadata.slug,
+        ...(metadata.title !== undefined && { title: metadata.title }),
+        status: targetStatus,
+        createdAt: metadata.createdAt,
+        updatedAt: now,
+        ...(metadata.branch !== undefined && { branch: metadata.branch }),
+        ...(metadata.worktreePath !== undefined && { worktreePath: metadata.worktreePath }),
+    };
+    const metadataPath = buildFeatureMetadataPath(projectRoot, slug);
+    await writeFile(metadataPath, `${JSON.stringify(updatedMetadata, null, 2)}\n`, 'utf8');
+    return {
+        slug: metadata.slug,
+        previousStatus: metadata.status,
+        newStatus: targetStatus,
+        timestamp: now,
+    };
+}
+//# sourceMappingURL=transition.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transition.js","sourceRoot":"","sources":["../../../../src/core/specs/transition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AACnF,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAUtD,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,WAAmB,EACnB,IAAY,EACZ,YAA2B,EAC3B,GAAW;IAEX,MAAM,SAAS,GAAG,MAAM,uBAAuB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IACnE,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IACjD,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IAEjF,MAAM,wBAAwB,CAAC,SAAS,CAAC,SAAS,EAAE,YAAY,EAAE;QAChE,aAAa,EAAE,SAAS,CAAC,QAAQ,CAAC,MAAM;QACxC,YAAY;KACb,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;IACpC,MAAM,eAAe,GAAoB;QACvC,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,GAAG,CAAC,QAAQ,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;QAC9D,MAAM,EAAE,YAAY;QACpB,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,SAAS,EAAE,GAAG;QACd,GAAG,CAAC,QAAQ,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;QACjE,GAAG,CAAC,QAAQ,CAAC,YAAY,KAAK,SAAS,IAAI,EAAE,YAAY,EAAE,QAAQ,CAAC,YAAY,EAAE,CAAC;KACpF,CAAC;IAEF,MAAM,YAAY,GAAG,wBAAwB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IACjE,MAAM,SAAS,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAEvF,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,cAAc,EAAE,QAAQ,CAAC,MAAM;QAC/B,SAAS,EAAE,YAAY;QACvB,SAAS,EAAE,GAAG;KACf,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,17 @@
+export declare const FEATURE_STATUS_VALUES: readonly ["created", "spec-ready", "plan-ready", "in-progress", "done"];
+export type FeatureStatus = (typeof FEATURE_STATUS_VALUES)[number];
+export interface FeatureMetadata {
+    version: 1;
+    slug: string;
+    title?: string;
+    status: FeatureStatus;
+    createdAt: string;
+    updatedAt: string;
+    branch?: string;
+    worktreePath?: string;
+}
+export interface CreateFeatureMetadataInput {
+    slug: string;
+    title?: string;
+    createdAt: string;
+}

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

@@ -0,0 +1,8 @@
+export const FEATURE_STATUS_VALUES = [
+    'created',
+    'spec-ready',
+    'plan-ready',
+    'in-progress',
+    'done',
+];
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/core/specs/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,SAAS;IACT,YAAY;IACZ,YAAY;IACZ,aAAa;IACb,MAAM;CACE,CAAC"}

package/dist/src/core/specs/worktree.d.ts

@@ -0,0 +1,10 @@
+export interface SetFeatureWorktreeInput {
+    branch: string;
+    path: string;
+}
+export interface SetFeatureWorktreeResult {
+    slug: string;
+    branch: string;
+    worktreePath: string;
+}
+export declare function setFeatureWorktree(projectRoot: string, slug: string, input: SetFeatureWorktreeInput): Promise<SetFeatureWorktreeResult>;

package/dist/src/core/specs/worktree.js

@@ -0,0 +1,32 @@
+import { writeFile } from 'node:fs/promises';
+import { ScifiError } from '../output/errors.js';
+import { inspectFeatureLifecycle } from './lifecycle.js';
+import { buildFeatureMetadataPath } from './paths.js';
+export async function setFeatureWorktree(projectRoot, slug, input) {
+    const branch = input.branch.trim();
+    const worktreePath = input.path.trim();
+    if (branch.length === 0) {
+        throw new ScifiError('INVALID_ARGUMENT', 'Branch must not be empty.', {
+            hint: 'Pass --branch <branch-name>.',
+        });
+    }
+    if (worktreePath.length === 0) {
+        throw new ScifiError('INVALID_ARGUMENT', 'Worktree path must not be empty.', {
+            hint: 'Pass --path <worktree-path>.',
+        });
+    }
+    const { metadata } = await inspectFeatureLifecycle(projectRoot, slug);
+    const updatedMetadata = {
+        ...metadata,
+        branch,
+        worktreePath,
+    };
+    const metadataPath = buildFeatureMetadataPath(projectRoot, slug);
+    await writeFile(metadataPath, `${JSON.stringify(updatedMetadata, null, 2)}\n`, 'utf8');
+    return {
+        slug: metadata.slug,
+        branch,
+        worktreePath,
+    };
+}
+//# sourceMappingURL=worktree.js.map

package/dist/src/core/specs/worktree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.js","sourceRoot":"","sources":["../../../../src/core/specs/worktree.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AActD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,WAAmB,EACnB,IAAY,EACZ,KAA8B;IAE9B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACnC,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAEvC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,UAAU,CAAC,kBAAkB,EAAE,2BAA2B,EAAE;YACpE,IAAI,EAAE,8BAA8B;SACrC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,UAAU,CAAC,kBAAkB,EAAE,kCAAkC,EAAE;YAC3E,IAAI,EAAE,8BAA8B;SACrC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,uBAAuB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAEtE,MAAM,eAAe,GAAoB;QACvC,GAAG,QAAQ;QACX,MAAM;QACN,YAAY;KACb,CAAC;IAEF,MAAM,YAAY,GAAG,wBAAwB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IACjE,MAAM,SAAS,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAEvF,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,MAAM;QACN,YAAY;KACb,CAAC;AACJ,CAAC"}

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

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

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

@@ -0,0 +1,53 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+import { TASK_STATUS_VALUES } from './types.js';
+function isValidTaskStatus(value) {
+    return typeof value === 'string' && TASK_STATUS_VALUES.includes(value);
+}
+function isValidRawFrontmatter(raw) {
+    if (typeof raw !== 'object' || raw === null)
+        return false;
+    const obj = raw;
+    const allowedKeys = new Set(['id', 'slug', 'status', 'depends-on']);
+    if (Object.keys(obj).some((key) => !allowedKeys.has(key)))
+        return false;
+    return (typeof obj.id === 'string' &&
+        typeof obj.slug === 'string' &&
+        isValidTaskStatus(obj.status) &&
+        Array.isArray(obj['depends-on']));
+}
+const FRONTMATTER_PATTERN = /^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/;
+export async function readTaskFile(filePath) {
+    const content = await readFile(filePath, 'utf8');
+    const match = FRONTMATTER_PATTERN.exec(content);
+    if (!match) {
+        throw new Error(`Task file at ${filePath} is missing YAML frontmatter.`);
+    }
+    const yamlPart = match[1] ?? '';
+    const body = match[2] ?? '';
+    const raw = parseYaml(yamlPart);
+    if (!isValidRawFrontmatter(raw)) {
+        throw new Error(`Task file at ${filePath} has invalid frontmatter.`);
+    }
+    const dependsOnRaw = raw['depends-on'];
+    return {
+        frontmatter: {
+            id: raw.id,
+            slug: raw.slug,
+            status: raw.status,
+            dependsOn: dependsOnRaw.filter((v) => typeof v === 'string'),
+        },
+        body,
+    };
+}
+export async function writeTaskFile(filePath, file) {
+    const rawFrontmatter = {
+        id: file.frontmatter.id,
+        slug: file.frontmatter.slug,
+        status: file.frontmatter.status,
+    };
+    rawFrontmatter['depends-on'] = file.frontmatter.dependsOn;
+    const content = `---\n${stringifyYaml(rawFrontmatter)}---\n${file.body}`;
+    await writeFile(filePath, content, 'utf8');
+}
+//# sourceMappingURL=frontmatter.js.map

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

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

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

@@ -0,0 +1,2 @@
+import type { TaskFrontmatter } from './types.js';
+export declare function listTasks(projectRoot: string, featureSlug: string): Promise<TaskFrontmatter[]>;

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

@@ -0,0 +1,18 @@
+import { readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { readTaskFile } from './frontmatter.js';
+import { buildTasksDirectoryPath } from './paths.js';
+function isMissingPathError(error) {
+    return error instanceof Error && 'code' in error && error.code === 'ENOENT';
+}
+export async function listTasks(projectRoot, featureSlug) {
+    const tasksDir = buildTasksDirectoryPath(projectRoot, featureSlug);
+    const entries = await readdir(tasksDir, { withFileTypes: true }).catch((error) => {
+        if (isMissingPathError(error))
+            return [];
+        throw error;
+    });
+    const taskFiles = entries.filter((entry) => entry.isFile() && entry.name.endsWith('.md'));
+    return Promise.all(taskFiles.map((entry) => readTaskFile(join(tasksDir, entry.name)).then((file) => file.frontmatter)));
+}
+//# sourceMappingURL=list.js.map