@caiqueoak/flow 0.7.0 → 0.8.0

package/dist/commands/sync.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.mjs","sourceRoot":"","sources":["../../src/commands/sync.mjs"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;IAC5B,MAAM,IAAI,GAAG,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC;IACxD,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7B,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAC5B,CAAC,CAAC;AACF,MAAM,UAAU,WAAW,CAAC,IAAI;IAC9B,kFAAkF;IAClF,MAAM,OAAO,GAAG,cAAc,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IAClD,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,kBAAkB,CAAC,CAAC;IACrH,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;IAClD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,CAAC;IAC7C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;IACnE,OAAO,OAAO,CAAC;AACjB,CAAC;AACD,MAAM,UAAU,OAAO,CAAC,EAAE,IAAI,EAAE;IAC9B,MAAM,MAAM,GAAG,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9C,IAAI,CAAC,UAAU,MAAM,CAAC,UAAU,CAAC,MAAM,0EAA0E,CAAC,CAAC;AACrH,CAAC"}

package/dist/commands/trace.d.mts

@@ -0,0 +1,30 @@
+export declare function traceTask(root: any, id: any): {
+    task: any;
+    status: string;
+    commit: {
+        task: any;
+        sha: any;
+        title: any;
+        files: any;
+    } | null;
+    invalid_commits: any;
+};
+export declare function traceTasks(root: any, ids: any): Map<any, any>;
+export declare function traceWorkItem(root: any, id: any): {
+    work_item_id: any;
+    tasks: any;
+    review: {
+        status: string;
+        commit: {
+            task: any;
+            sha: any;
+            title: any;
+            files: any;
+        } | null;
+        invalid_commits: any;
+    };
+};
+export declare function runTrace({ args }: {
+    args: any;
+}): void;
+//# sourceMappingURL=trace.d.mts.map

package/dist/commands/trace.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.mts","sourceRoot":"","sources":["../../src/commands/trace.mjs"],"names":[],"mappings":"AAkEA,wBAAgB,SAAS,CAAC,IAAI,KAAA,EAAE,EAAE,KAAA;IAI9B,IAAI;IACJ,MAAM;IACN,MAAM;;;;;;IACN,eAAe;EAElB;AACD,wBAAgB,UAAU,CAAC,IAAI,KAAA,EAAE,GAAG,KAAA,iBAEnC;AACD,wBAAgB,aAAa,CAAC,IAAI,KAAA,EAAE,EAAE,KAAA;IASlC,YAAY;IACZ,KAAK;IACL,MAAM;QACJ,MAAM;QACN,MAAM;;;;;;QACN,eAAe;;EAGpB;AAID,wBAAgB,QAAQ,CAAC,EAAE,IAAI,EAAE;;CAAA,QAQhC"}

package/dist/commands/trace.mjs

@@ -0,0 +1,111 @@
+import { execFileSync } from 'node:child_process';
+import { info, fail } from '../shared/cli-io.mjs';
+import { projectRoot } from '../shared/project-path.mjs';
+const task = /^W\d{3,}-T\d{3,}$/, work = /^W\d{3,}$/;
+const subject = /^(feat|fix|docs|style|refactor|test|build|ci|chore|perf|revert)\(([a-z0-9][a-z0-9-]*)\): (.+) \[(W\d{3,}(?:-T\d{3,})?)\]$/;
+function history(root) {
+    try {
+        return execFileSync('git', ['log', 'HEAD', '--format=%H%x1f%ct%x1f%s%x1f%B%x1e'], { cwd: root, encoding: 'utf8' })
+            .split('\x1e')
+            .filter((r) => r.trim())
+            .map((r) => {
+            const [sha, timestamp, subject, body = ''] = r.trim().split('\x1f');
+            return { sha, timestamp: Number(timestamp), subject, body };
+        });
+    }
+    catch {
+        fail('git history is unavailable.');
+    }
+}
+function trailers(body) {
+    const values = new Map();
+    for (const line of body.split(/\r?\n/)) {
+        const match = line.match(/^(Flow-Work-Item|Flow-Task):\s*(\S+)\s*$/);
+        if (!match)
+            continue;
+        if (values.has(match[1]))
+            return null;
+        values.set(match[1], match[2]);
+    }
+    return values;
+}
+function isCanonicalTaskCommit(entry, id) {
+    const match = entry.subject.match(subject);
+    if (!match || match[4] !== id)
+        return false;
+    const values = trailers(entry.body);
+    return values?.get('Flow-Task') === id && values.get('Flow-Work-Item') === id.split('-')[0];
+}
+function changedFiles(root, sha) {
+    return execFileSync('git', ['show', '--format=', '--name-only', '--no-renames', sha], { cwd: root, encoding: 'utf8' })
+        .split(/\r?\n/)
+        .filter(Boolean)
+        .map((file) => file.replace(/\\/g, '/'));
+}
+function evidence(root, entry, id) {
+    const match = entry.subject.match(subject);
+    return { task: id, sha: entry.sha, title: match?.[3] ?? entry.subject, files: changedFiles(root, entry.sha) };
+}
+function invalidEvidence(entries) {
+    return entries.map((entry) => ({ sha: entry.sha, subject: entry.subject }));
+}
+function classify(entries, id) {
+    const wanted = entries.filter((e) => e.subject.endsWith(`[${id}]`)), good = wanted.filter((entry) => task.test(id)
+        ? isCanonicalTaskCommit(entry, id)
+        : (() => {
+            const match = entry.subject.match(subject);
+            return match && match[4] === id && match[1] === 'chore';
+        })()), invalid = wanted.filter((e) => !good.includes(e));
+    return {
+        status: invalid.length ? 'invalid' : !good.length ? 'missing' : good.length > 1 ? 'ambiguous' : 'resolved',
+        commits: good,
+        invalid_commits: invalid
+    };
+}
+export function traceTask(root, id) {
+    if (!task.test(id))
+        fail(`invalid qualified task ID '${id}'.`);
+    const result = classify(history(root), id);
+    return {
+        task: id,
+        status: result.status,
+        commit: result.commits.length === 1 ? evidence(root, result.commits[0], id) : null,
+        invalid_commits: invalidEvidence(result.invalid_commits)
+    };
+}
+export function traceTasks(root, ids) {
+    return new Map(ids.map((id) => [id, traceTask(root, id)]));
+}
+export function traceWorkItem(root, id) {
+    if (!work.test(id))
+        fail(`invalid work-item ID '${id}'.`);
+    const entries = history(root), tasks = entries.filter((entry) => {
+        const match = entry.subject.match(subject);
+        return match && match[4].startsWith(`${id}-T`) && isCanonicalTaskCommit(entry, match[4]);
+    }), review = classify(entries, id);
+    return {
+        work_item_id: id,
+        tasks: tasks.map((entry) => evidence(root, entry, entry.subject.match(subject)[4])),
+        review: {
+            status: review.status,
+            commit: review.commits.length === 1 ? evidence(root, review.commits[0], id) : null,
+            invalid_commits: invalidEvidence(review.invalid_commits)
+        }
+    };
+}
+function renderEvidence(record) {
+    return `${record.task} ${record.sha} ${record.title}${record.files.length ? `\n${record.files.map((file) => `  ${file}`).join('\n')}` : ''}`;
+}
+export function runTrace({ args }) {
+    const id = args.find((x, i) => !x.startsWith('-') && (i === 0 || !args[i - 1].startsWith('--'))), result = task.test(id) ? traceTask(projectRoot(args), id) : traceWorkItem(projectRoot(args), id);
+    if (!id || (!task.test(id) && !work.test(id)))
+        fail('flow trace requires W015-T003 or W015.');
+    if (args.includes('--json'))
+        return info(JSON.stringify(result, null, 2));
+    if (task.test(id) && result.status !== 'resolved')
+        fail(`${id}: ${result.status} canonical subject evidence.`);
+    if (task.test(id))
+        return info(renderEvidence(result.commit));
+    info(result.tasks.map(renderEvidence).join('\n'));
+}
+//# sourceMappingURL=trace.mjs.map

package/dist/commands/trace.mjs.map

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

package/dist/commands/validate.d.mts

@@ -0,0 +1,8 @@
+export declare function validateProject(root: any, { preCommitTask, workItem }?: {
+    preCommitTask?: null | undefined;
+    workItem?: null | undefined;
+}): any[];
+export declare function runValidate({ args }: {
+    args: any;
+}): void;
+//# sourceMappingURL=validate.d.mts.map

package/dist/commands/validate.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.mts","sourceRoot":"","sources":["../../src/commands/validate.mjs"],"names":[],"mappings":"AASA,wBAAgB,eAAe,CAAC,IAAI,KAAA,EAAE,EAAE,aAAoB,EAAE,QAAe,EAAE;;;CAAK,SAmDnF;AACD,wBAAgB,WAAW,CAAC,EAAE,IAAI,EAAE;;CAAA,QAanC"}

package/dist/commands/validate.mjs

@@ -0,0 +1,82 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { execFileSync } from 'node:child_process';
+import { stringify, parseDocument } from 'yaml';
+import { info, fail } from '../shared/cli-io.mjs';
+import { projectRoot } from '../shared/project-path.mjs';
+import { loadWorkItems, derivedBacklog, lifecycle } from '../artifacts/work-items.mjs';
+import { validateSpec } from '../artifacts/spec.mjs';
+import { generateGraphMarkdown } from './graph.mjs';
+export function validateProject(root, { preCommitTask = null, workItem = null } = {}) {
+    const findings = [], error = (code, message) => findings.push({ level: 'error', code, message });
+    let items;
+    try {
+        items = loadWorkItems(root);
+    }
+    catch (e) {
+        error('WORK_ITEMS', e.message);
+        return findings;
+    }
+    const by = new Map(items.map((i) => [i.id, i]));
+    for (const item of items) {
+        if (workItem && item.id !== workItem)
+            continue;
+        const spec = validateSpec(fs.readFileSync(path.join(item.base, 'spec.md'), 'utf8'), { expectedWorkItem: item.id });
+        for (const message of spec.errors)
+            error('SPEC', `${item.id}: ${message}`);
+        if (item.maturity === 'outlined' && item.tasks.tasks.length)
+            error('TASKS', `${item.id}: outlined work cannot have tasks.`);
+        if (item.tasks.tasks.filter((t) => t.state === 'in_progress').length > 1)
+            error('TASKS', `${item.id}: only one task can be in_progress.`);
+        if (lifecycle(item, by).status === 'completed' && item.review.status !== 'approved')
+            error('REVIEW', `${item.id}: completed work requires approved review.`);
+    }
+    if (preCommitTask) {
+        try {
+            const staged = execFileSync('git', ['diff', '--cached', '--name-only'], { cwd: root, encoding: 'utf8' })
+                .split(/\r?\n/)
+                .filter(Boolean);
+            if (staged.some((f) => f.replace(/\\/g, '/').startsWith('_flow/generated/')))
+                error('SCOPE', `${preCommitTask}: generated projections cannot be committed.`);
+        }
+        catch (e) {
+            error('SCOPE', e.message);
+        }
+    }
+    const generated = path.join(root, '_flow', 'generated'), expected = derivedBacklog(items), backlog = stringify(expected, { lineWidth: 0 }), graph = generateGraphMarkdown(expected);
+    for (const [name, text] of [
+        ['backlog.yaml', backlog],
+        ['graph.md', graph]
+    ]) {
+        const f = path.join(generated, name);
+        if (!fs.existsSync(f))
+            error('PROJECTION_MISSING', `${name} is missing; run flow sync.`);
+        else {
+            const actual = fs.readFileSync(f, 'utf8');
+            if (name.endsWith('.yaml') && parseDocument(actual, { prettyErrors: false }).errors.length)
+                error('PROJECTION_INCONSISTENT', `${name} is malformed; run flow sync.`);
+            else if (actual !== text)
+                error('PROJECTION_STALE', `${name} differs from current canonical work-items.`);
+        }
+    }
+    return findings;
+}
+export function runValidate({ args }) {
+    const wi = args.indexOf('--work-item'), findings = validateProject(projectRoot(args), {
+        preCommitTask: args.includes('--pre-commit') ? args[args.indexOf('--pre-commit') + 1] : null,
+        workItem: wi < 0 ? null : args[wi + 1]
+    });
+    if (args.includes('--json'))
+        info(JSON.stringify({ valid: !findings.length, findings }, null, 2));
+    else if (!findings.length)
+        info('Flow project is valid.');
+    else
+        for (const f of findings)
+            info(`${f.code}: ${f.message}`);
+    if (findings.length) {
+        if (!args.includes('--json'))
+            fail(`${findings.length} validation finding(s).`);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=validate.mjs.map

package/dist/commands/validate.mjs.map

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

package/dist/domain/contracts.d.mts

@@ -0,0 +1,203 @@
+export declare const FLOW_SCHEMA_VERSION = 4;
+export declare const BACKLOG_SCHEMA_VERSION = 4;
+export declare const TASKS_SCHEMA_VERSION = 3;
+export declare const REVIEW_SCHEMA_VERSION = 1;
+export declare const STATE_SCHEMA_VERSION = 2;
+export declare const GATES_SCHEMA_VERSION = 2;
+export declare const WORK_ITEM_ID_PATTERN = "^W\\d{3,}$";
+export declare const TASK_ID_PATTERN = "^T\\d{3,}$";
+export declare const QUALIFIED_TASK_ID_PATTERN = "^W\\d{3,}-T\\d{3,}$";
+export declare const WORK_ITEM_ID: RegExp;
+export declare const TASK_ID: RegExp;
+export declare const QUALIFIED_TASK_ID: RegExp;
+export declare const LIFECYCLE_STATES: readonly string[];
+export declare const DERIVED_WORK_ITEM_STATES: readonly string[];
+export declare const SPEC_MATURITIES: readonly string[];
+export declare const WORKFLOW: Readonly<{
+    discovery: string[];
+    prd: string[];
+    engineering: string[];
+    backlog: string[];
+    specification: string[];
+    planning: string[];
+    implementation: string[];
+    review: string[];
+    reconcile: string[];
+    complete: string[];
+}>;
+export declare const JSON_SCHEMAS: Readonly<{
+    config: {
+        $schema: string;
+        $id: string;
+        type: string;
+        additionalProperties: boolean;
+        required: string[];
+        properties: {
+            schema_version: {
+                const: number;
+            };
+            flow_version: {
+                type: string;
+            };
+            runtimes: {
+                type: string;
+                items: {
+                    type: string;
+                };
+            };
+            engineering: {
+                type: string;
+            };
+        };
+    };
+    backlog: {
+        $schema: string;
+        $id: string;
+        type: string;
+        additionalProperties: boolean;
+        required: string[];
+        properties: {
+            schema_version: {
+                const: number;
+            };
+            work_items: {
+                type: string;
+                items: {
+                    type: string;
+                    required: string[];
+                    properties: {
+                        id: {
+                            type: string;
+                            pattern: any;
+                            description: any;
+                        };
+                        folder: {
+                            type: string;
+                            pattern: string;
+                        };
+                        kind: {
+                            enum: string[];
+                        };
+                        title: {
+                            type: string;
+                            minLength: number;
+                        };
+                        state: {
+                            enum: readonly string[];
+                        };
+                        priority: {
+                            type: string;
+                            minimum: number;
+                        };
+                        spec_maturity: {
+                            enum: readonly string[];
+                        };
+                        depends_on: {
+                            type: string;
+                            uniqueItems: boolean;
+                            items: {
+                                type: string;
+                                pattern: any;
+                                description: any;
+                            };
+                        };
+                        blockers: {
+                            type: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    tasks: {
+        $schema: string;
+        $id: string;
+        type: string;
+        required: string[];
+        properties: {
+            schema_version: {
+                const: number;
+            };
+            work_item: {
+                type: string;
+                pattern: any;
+                description: any;
+            };
+            tasks: {
+                type: string;
+                items: {
+                    type: string;
+                    additionalProperties: boolean;
+                    required: string[];
+                    properties: {
+                        id: {
+                            type: string;
+                            pattern: any;
+                            description: any;
+                        };
+                        title: {
+                            type: string;
+                            minLength: number;
+                        };
+                        state: {
+                            enum: readonly string[];
+                        };
+                        depends_on: {
+                            type: string;
+                            uniqueItems: boolean;
+                            items: {
+                                type: string;
+                                pattern: any;
+                                description: any;
+                            };
+                        };
+                        provenance: {
+                            enum: string[];
+                        };
+                        legacy_commit: {
+                            type: string;
+                            description: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    review: {
+        $schema: string;
+        $id: string;
+        type: string;
+        required: string[];
+        properties: {
+            schema_version: {
+                const: number;
+            };
+            work_item: {
+                type: string;
+                pattern: any;
+                description: any;
+            };
+            status: {
+                enum: string[];
+            };
+            reviewed_at: {
+                type: string;
+            };
+        };
+    };
+    gates: {
+        $schema: string;
+        $id: string;
+        type: string;
+        required: string[];
+        properties: {
+            schema_version: {
+                const: number;
+            };
+            gates: {
+                type: string;
+            };
+        };
+    };
+}>;
+//# sourceMappingURL=contracts.d.mts.map

package/dist/domain/contracts.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.mts","sourceRoot":"","sources":["../../src/domain/contracts.mjs"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,eAAO,MAAM,sBAAsB,IAAI,CAAC;AACxC,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAEtC,eAAO,MAAM,oBAAoB,eAAe,CAAC;AACjD,eAAO,MAAM,eAAe,eAAe,CAAC;AAC5C,eAAO,MAAM,yBAAyB,wBAAwB,CAAC;AAC/D,eAAO,MAAM,YAAY,QAAmC,CAAC;AAC7D,eAAO,MAAM,OAAO,QAA8B,CAAC;AACnD,eAAO,MAAM,iBAAiB,QAAwC,CAAC;AAEvE,eAAO,MAAM,gBAAgB,mBAAyD,CAAC;AACvF,eAAO,MAAM,wBAAwB,mBAOnC,CAAC;AACH,eAAO,MAAM,eAAe,mBAAuC,CAAC;AACpE,eAAO,MAAM,QAAQ;;;;;;;;;;;EAWnB,CAAC;AAGH,eAAO,MAAM,YAAY;;;;;;;;;;;;gBASH,IAAI;;;gBACR,IAAI;gBAAW,KAAK;oBAAI,IAAI;;;;gBACzB,IAAI;;;;;;;;;;;;;;;gBAYjB,IAAI;gBACJ,KAAK;oBACH,IAAI;oBACJ,QAAQ;oBACR,UAAU;wBACR,EAAE;;;;;wBACF,MAAM;4BAAI,IAAI;4BAAY,OAAO;;wBACjC,IAAI;4BAAI,IAAI;;wBACZ,KAAK;4BAAI,IAAI;4BAAY,SAAS;;wBAClC,KAAK;4BAAI,IAAI;;wBACb,QAAQ;4BAAI,IAAI;4BAAa,OAAO;;wBACpC,aAAa;4BAAI,IAAI;;wBACrB,UAAU;4BAAI,IAAI;4BAAW,WAAW;4BAAQ,KAAK;;;;;;wBACrD,QAAQ;4BAAI,IAAI;;;;;;;;;;;;;;;;;;;;;;gBAepB,IAAI;gBACJ,KAAK;oBACH,IAAI;oBACJ,oBAAoB;oBACpB,QAAQ;oBACR,UAAU;wBACR,EAAE;;;;;wBACF,KAAK;4BAAI,IAAI;4BAAY,SAAS;;wBAClC,KAAK;4BAAI,IAAI;;wBACb,UAAU;4BAAI,IAAI;4BAAW,WAAW;4BAAQ,KAAK;;;;;;wBACrD,UAAU;4BAAI,IAAI;;wBAClB,aAAa;4BAAI,IAAI;4BAAY,WAAW;;;;;;;;;;;;;;;;;;;;;;gBAcxC,IAAI;;;gBACC,IAAI;;;;;;;;;;;;;;gBAQmD,IAAI;;;;EAE9E,CAAC"}

package/dist/domain/contracts.mjs

@@ -0,0 +1,126 @@
+export const FLOW_SCHEMA_VERSION = 4;
+// Backlog and graph are generated projections, never canonical inputs.
+export const BACKLOG_SCHEMA_VERSION = 4;
+export const TASKS_SCHEMA_VERSION = 3;
+export const REVIEW_SCHEMA_VERSION = 1;
+// Kept as a migration reader compatibility constant; state.yaml is not canonical.
+export const STATE_SCHEMA_VERSION = 2;
+export const GATES_SCHEMA_VERSION = 2;
+export const WORK_ITEM_ID_PATTERN = '^W\\d{3,}$';
+export const TASK_ID_PATTERN = '^T\\d{3,}$';
+export const QUALIFIED_TASK_ID_PATTERN = '^W\\d{3,}-T\\d{3,}$';
+export const WORK_ITEM_ID = new RegExp(WORK_ITEM_ID_PATTERN);
+export const TASK_ID = new RegExp(TASK_ID_PATTERN);
+export const QUALIFIED_TASK_ID = new RegExp(QUALIFIED_TASK_ID_PATTERN);
+export const LIFECYCLE_STATES = Object.freeze(['pending', 'in_progress', 'completed']);
+export const DERIVED_WORK_ITEM_STATES = Object.freeze([
+    'outlined',
+    'blocked',
+    'eligible',
+    'in_progress',
+    'review',
+    'completed'
+]);
+export const SPEC_MATURITIES = Object.freeze(['outlined', 'ready']);
+export const WORKFLOW = Object.freeze({
+    discovery: ['define_problem', 'explore_product', 'assess_viability', 'consolidate'],
+    prd: ['draft', 'await_approval'],
+    engineering: ['draft', 'await_approval'],
+    backlog: ['outline', 'route'],
+    specification: ['deepen', 'validate', 'promote'],
+    planning: ['create_tasks', 'prepare_plan', 'await_approval'],
+    implementation: ['start_task', 'execute_task', 'verify_task', 'persist_evidence'],
+    review: ['review_work_item'],
+    reconcile: ['resolve_conflicts'],
+    complete: ['finished']
+});
+const id = (pattern, description) => ({ type: 'string', pattern, description });
+export const JSON_SCHEMAS = Object.freeze({
+    config: {
+        $schema: 'https://json-schema.org/draft/2020-12/schema',
+        $id: 'https://flow.local/schemas/config.schema.json',
+        type: 'object',
+        additionalProperties: false,
+        required: ['schema_version', 'flow_version', 'runtimes', 'engineering'],
+        properties: {
+            schema_version: { const: FLOW_SCHEMA_VERSION },
+            flow_version: { type: 'string' },
+            runtimes: { type: 'array', items: { type: 'object' } },
+            engineering: { type: 'object' }
+        }
+    },
+    backlog: {
+        $schema: 'https://json-schema.org/draft/2020-12/schema',
+        $id: 'https://flow.local/schemas/backlog.schema.json',
+        type: 'object',
+        additionalProperties: false,
+        required: ['schema_version', 'work_items'],
+        properties: {
+            schema_version: { const: BACKLOG_SCHEMA_VERSION },
+            work_items: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    required: ['id', 'folder', 'kind', 'title', 'state', 'priority', 'spec_maturity', 'depends_on', 'blockers'],
+                    properties: {
+                        id: id(WORK_ITEM_ID_PATTERN, 'Permanent work-item identifier.'),
+                        folder: { type: 'string', pattern: '^W\\d{3,}-[a-z0-9]+(?:-[a-z0-9]+)*$' },
+                        kind: { enum: ['feature', 'technical', 'maintenance'] },
+                        title: { type: 'string', minLength: 1 },
+                        state: { enum: DERIVED_WORK_ITEM_STATES },
+                        priority: { type: 'integer', minimum: 1 },
+                        spec_maturity: { enum: SPEC_MATURITIES },
+                        depends_on: { type: 'array', uniqueItems: true, items: id(WORK_ITEM_ID_PATTERN) },
+                        blockers: { type: 'array' }
+                    }
+                }
+            }
+        }
+    },
+    tasks: {
+        $schema: 'https://json-schema.org/draft/2020-12/schema',
+        $id: 'https://flow.local/schemas/tasks.schema.json',
+        type: 'object',
+        required: ['schema_version', 'work_item', 'tasks'],
+        properties: {
+            schema_version: { const: TASKS_SCHEMA_VERSION },
+            work_item: id(WORK_ITEM_ID_PATTERN),
+            tasks: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    additionalProperties: false,
+                    required: ['id', 'title', 'state', 'depends_on'],
+                    properties: {
+                        id: id(TASK_ID_PATTERN),
+                        title: { type: 'string', minLength: 1 },
+                        state: { enum: LIFECYCLE_STATES },
+                        depends_on: { type: 'array', uniqueItems: true, items: id(TASK_ID_PATTERN) },
+                        provenance: { enum: ['legacy_migration'] },
+                        legacy_commit: { type: 'string', description: 'Read-only provenance for migrated completed tasks.' }
+                    }
+                }
+            }
+        }
+    },
+    review: {
+        $schema: 'https://json-schema.org/draft/2020-12/schema',
+        $id: 'https://flow.local/schemas/review.schema.json',
+        type: 'object',
+        required: ['schema_version', 'work_item', 'status'],
+        properties: {
+            schema_version: { const: REVIEW_SCHEMA_VERSION },
+            work_item: id(WORK_ITEM_ID_PATTERN),
+            status: { enum: ['pending', 'approved'] },
+            reviewed_at: { type: 'string' }
+        }
+    },
+    gates: {
+        $schema: 'https://json-schema.org/draft/2020-12/schema',
+        $id: 'https://flow.local/schemas/gates.schema.json',
+        type: 'object',
+        required: ['schema_version', 'gates'],
+        properties: { schema_version: { const: GATES_SCHEMA_VERSION }, gates: { type: 'array' } }
+    }
+});
+//# sourceMappingURL=contracts.mjs.map

package/dist/domain/contracts.mjs.map

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

package/dist/domain/types.d.ts

@@ -0,0 +1,45 @@
+export type LifecycleState = 'pending' | 'in_progress' | 'completed';
+export type SpecMaturity = 'outlined' | 'ready';
+export type TaskProvenance = 'legacy_migration';
+export type WorkflowPhase = 'discovery' | 'prd' | 'engineering' | 'backlog' | 'specification' | 'planning' | 'implementation' | 'review' | 'reconcile' | 'complete';
+export interface Blocker {
+    id: string;
+    type: 'external_action' | 'consequential_decision';
+    description: string;
+    status: 'unresolved' | 'resolved';
+}
+export interface WorkItem {
+    id: `W${number}`;
+    folder: string;
+    kind: 'feature' | 'technical' | 'maintenance';
+    title: string;
+    state: LifecycleState;
+    priority: number;
+    spec_maturity: SpecMaturity;
+    depends_on: Array<`W${number}`>;
+    blockers: Blocker[];
+}
+export interface Task {
+    id: `T${number}`;
+    title: string;
+    state: LifecycleState;
+    depends_on: Array<`T${number}`>;
+    provenance?: TaskProvenance;
+    legacy_commit?: string;
+}
+export interface ExecutionCursor {
+    schema_version: number;
+    execution: {
+        phase: WorkflowPhase;
+        step: string;
+    };
+    active: {
+        work_item: `W${number}` | null;
+        task: `W${number}-T${number}` | null;
+    };
+    stop_reason: string | null;
+    migration: {
+        status: 'not_required' | 'pending_reconciliation' | 'completed';
+    };
+}
+//# sourceMappingURL=types.d.ts.map