@caiqueoak/flow 0.6.0 → 0.8.0

package/dist/artifacts/prd.mjs

@@ -0,0 +1,13 @@
+import { validateDocument } from './document.mjs';
+export function validatePrdDocument(text) {
+    return validateDocument(text, [
+        '# Product Requirements',
+        '## Purpose',
+        '## Users',
+        '## Scope',
+        '## Requirements',
+        '## Constraints',
+        '## Non-goals'
+    ]);
+}
+//# sourceMappingURL=prd.mjs.map

package/dist/artifacts/prd.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"prd.mjs","sourceRoot":"","sources":["../../src/artifacts/prd.mjs"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,MAAM,UAAU,mBAAmB,CAAC,IAAI;IACtC,OAAO,gBAAgB,CAAC,IAAI,EAAE;QAC5B,wBAAwB;QACxB,YAAY;QACZ,UAAU;QACV,UAAU;QACV,iBAAiB;QACjB,gBAAgB;QAChB,cAAc;KACf,CAAC,CAAC;AACL,CAAC"}

package/dist/artifacts/review.d.mts

@@ -0,0 +1,11 @@
+export declare function parseReview(text: any, { expectedWorkItem, source }?: {
+    expectedWorkItem?: null | undefined;
+    source?: string | undefined;
+}): {
+    schema_version: number;
+    work_item: any;
+    status: any;
+    reviewed_at?: any;
+};
+export declare const stringifyReview: (value: any) => any;
+//# sourceMappingURL=review.d.mts.map

package/dist/artifacts/review.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.mts","sourceRoot":"","sources":["../../src/artifacts/review.mjs"],"names":[],"mappings":"AAGA,wBAAgB,WAAW,CAAC,IAAI,KAAA,EAAE,EAAE,gBAAuB,EAAE,MAAsB,EAAE;;;CAAK;;;;;EAoBzF;AACD,eAAO,MAAM,eAAe,qBAAwE,CAAC"}

package/dist/artifacts/review.mjs

@@ -0,0 +1,27 @@
+import { parseDocument, stringify } from 'yaml';
+import { ArtifactValidationError } from './backlog.mjs';
+import { REVIEW_SCHEMA_VERSION, WORK_ITEM_ID } from '../domain/contracts.mjs';
+export function parseReview(text, { expectedWorkItem = null, source = 'review.yaml' } = {}) {
+    const doc = parseDocument(text, { prettyErrors: false, uniqueKeys: true });
+    if (doc.errors.length)
+        throw new ArtifactValidationError(`${source} is invalid: ${doc.errors[0].message}`);
+    const v = doc.toJS();
+    if (!v || typeof v !== 'object' || Array.isArray(v))
+        throw new ArtifactValidationError(`${source} must be a mapping.`);
+    if (v.schema_version !== REVIEW_SCHEMA_VERSION)
+        throw new ArtifactValidationError(`${source} schema_version must be ${REVIEW_SCHEMA_VERSION}.`);
+    if (!WORK_ITEM_ID.test(v.work_item ?? '') || (expectedWorkItem && v.work_item !== expectedWorkItem))
+        throw new ArtifactValidationError(`${source} has an invalid work_item.`);
+    if (!['pending', 'approved'].includes(v.status))
+        throw new ArtifactValidationError(`${source}.status must be pending or approved.`);
+    if (v.status === 'approved' && v.reviewed_at !== undefined && Number.isNaN(Date.parse(v.reviewed_at)))
+        throw new ArtifactValidationError(`${source}.reviewed_at must be ISO.`);
+    return {
+        schema_version: REVIEW_SCHEMA_VERSION,
+        work_item: v.work_item,
+        status: v.status,
+        ...(v.reviewed_at ? { reviewed_at: v.reviewed_at } : {})
+    };
+}
+export const stringifyReview = (value) => stringify(parseReview(stringify(value)), { lineWidth: 0 });
+//# sourceMappingURL=review.mjs.map

package/dist/artifacts/review.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.mjs","sourceRoot":"","sources":["../../src/artifacts/review.mjs"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC9E,MAAM,UAAU,WAAW,CAAC,IAAI,EAAE,EAAE,gBAAgB,GAAG,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,GAAG,EAAE;IACxF,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3E,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM;QAAE,MAAM,IAAI,uBAAuB,CAAC,GAAG,MAAM,gBAAgB,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3G,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACrB,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QACjD,MAAM,IAAI,uBAAuB,CAAC,GAAG,MAAM,qBAAqB,CAAC,CAAC;IACpE,IAAI,CAAC,CAAC,cAAc,KAAK,qBAAqB;QAC5C,MAAM,IAAI,uBAAuB,CAAC,GAAG,MAAM,2BAA2B,qBAAqB,GAAG,CAAC,CAAC;IAClG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,CAAC,SAAS,KAAK,gBAAgB,CAAC;QACjG,MAAM,IAAI,uBAAuB,CAAC,GAAG,MAAM,4BAA4B,CAAC,CAAC;IAC3E,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;QAC7C,MAAM,IAAI,uBAAuB,CAAC,GAAG,MAAM,sCAAsC,CAAC,CAAC;IACrF,IAAI,CAAC,CAAC,MAAM,KAAK,UAAU,IAAI,CAAC,CAAC,WAAW,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QACnG,MAAM,IAAI,uBAAuB,CAAC,GAAG,MAAM,2BAA2B,CAAC,CAAC;IAC1E,OAAO;QACL,cAAc,EAAE,qBAAqB;QACrC,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzD,CAAC;AACJ,CAAC;AACD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC"}

package/dist/artifacts/spec.d.mts

@@ -0,0 +1,14 @@
+export declare const SPEC_HEADINGS: readonly string[];
+export declare function parseWorkItemSpec(text: any, { expectedWorkItem }?: {
+    expectedWorkItem?: null | undefined;
+}): {
+    metadata: any;
+    body: any;
+};
+export declare function validateSpec(text: any, options?: {}): {
+    metadata: any;
+    body: any;
+    valid: boolean;
+    errors: string[];
+};
+//# sourceMappingURL=spec.d.mts.map

package/dist/artifacts/spec.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.mts","sourceRoot":"","sources":["../../src/artifacts/spec.mjs"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,mBAaxB,CAAC;AAKH,wBAAgB,iBAAiB,CAAC,IAAI,KAAA,EAAE,EAAE,gBAAuB,EAAE;;CAAK;IAuB7D,QAAQ;IAAK,IAAI;EAC3B;AACD,wBAAgB,YAAY,CAAC,IAAI,KAAA,EAAE,OAAO,KAAK;;;;;EAM9C"}

package/dist/artifacts/spec.mjs

@@ -0,0 +1,50 @@
+export const SPEC_HEADINGS = Object.freeze([
+    '# Work Item Specification',
+    '## Problem',
+    '## Scope',
+    '## Non-goals',
+    '## Requirements',
+    '## Acceptance criteria',
+    '## Contracts',
+    '## Data and APIs',
+    '## Edge cases',
+    '## Risks',
+    '## Decisions',
+    '## Gates'
+]);
+import { parseDocument } from 'yaml';
+import { ArtifactValidationError } from './backlog.mjs';
+import { WORK_ITEM_ID } from '../domain/contracts.mjs';
+export function parseWorkItemSpec(text, { expectedWorkItem = null } = {}) {
+    const match = text.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
+    if (!match)
+        throw new ArtifactValidationError('spec.md requires YAML frontmatter.');
+    const doc = parseDocument(match[1], { prettyErrors: false, uniqueKeys: true });
+    if (doc.errors.length)
+        throw new ArtifactValidationError(`spec.md frontmatter is invalid: ${doc.errors[0].message}`);
+    const m = doc.toJS();
+    if (!m ||
+        m.schema_version !== 1 ||
+        !WORK_ITEM_ID.test(m.work_item ?? '') ||
+        (expectedWorkItem && m.work_item !== expectedWorkItem))
+        throw new ArtifactValidationError('spec.md has invalid schema_version or work_item.');
+    if (!m.title?.trim() ||
+        !['feature', 'technical', 'maintenance'].includes(m.kind) ||
+        !Number.isInteger(m.priority) ||
+        m.priority < 1 ||
+        !['outlined', 'ready'].includes(m.maturity))
+        throw new ArtifactValidationError('spec.md has invalid canonical metadata.');
+    for (const key of ['depends_on', 'blockers'])
+        if (!Array.isArray(m[key]))
+            throw new ArtifactValidationError(`spec.md ${key} must be a list.`);
+    return { metadata: m, body: match[2] };
+}
+export function validateSpec(text, options = {}) {
+    const parsed = parseWorkItemSpec(text, options);
+    if (parsed.metadata.maturity === 'outlined')
+        return { valid: true, errors: [], ...parsed };
+    const lines = new Set(parsed.body.split(/\r?\n/));
+    const errors = SPEC_HEADINGS.filter((heading) => !lines.has(heading)).map((heading) => `Missing ${heading}.`);
+    return { valid: errors.length === 0, errors, ...parsed };
+}
+//# sourceMappingURL=spec.mjs.map

package/dist/artifacts/spec.mjs.map

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

package/dist/artifacts/state.d.mts

@@ -0,0 +1,44 @@
+export declare const WORKFLOW_STEPS: Readonly<{
+    discovery: string[];
+    prd: string[];
+    engineering: string[];
+    backlog: string[];
+    specification: string[];
+    planning: string[];
+    implementation: string[];
+    review: string[];
+    reconcile: string[];
+    complete: string[];
+}>;
+export declare function emptyState(): {
+    schema_version: number;
+    execution: {
+        phase: string;
+        step: string;
+    };
+    active: {
+        work_item: null;
+        task: null;
+    };
+    stop_reason: null;
+    migration: {
+        status: string;
+    };
+};
+export declare function parseState(text: any, { source }?: {
+    source?: string | undefined;
+}): {
+    schema_version: number;
+    execution: {
+        phase: any;
+        step: any;
+    };
+    active: {
+        work_item: any;
+        task: any;
+    };
+    stop_reason: any;
+    migration: any;
+};
+export declare function stringifyState(state: any): any;
+//# sourceMappingURL=state.d.mts.map

package/dist/artifacts/state.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.mts","sourceRoot":"","sources":["../../src/artifacts/state.mjs"],"names":[],"mappings":"AAKA,eAAO,MAAM,cAAc;;;;;;;;;;;EAAW,CAAC;AAGvC,wBAAgB,UAAU;;;QAGT,KAAK;QAAe,IAAI;;;QAC3B,SAAS;QAAQ,IAAI;;;;QAElB,MAAM;;EAEtB;AAED,wBAAgB,UAAU,CAAC,IAAI,KAAA,EAAE,EAAE,MAAqB,EAAE;;CAAK;;;;;;;QAgCzD,SAAS;QACT,IAAI;;;;EAKT;AAED,wBAAgB,cAAc,CAAC,KAAK,KAAA,OAEnC"}

package/dist/artifacts/state.mjs

@@ -0,0 +1,60 @@
+import { parseDocument, stringify } from 'yaml';
+import { ArtifactValidationError } from './backlog.mjs';
+import { STATE_SCHEMA_VERSION, WORKFLOW, WORK_ITEM_ID, QUALIFIED_TASK_ID } from '../domain/contracts.mjs';
+const PHASES = new Set(Object.keys(WORKFLOW));
+export const WORKFLOW_STEPS = WORKFLOW;
+const STOP_REASONS = new Set([null, 'consequential_decision', 'external_action', 'unrecoverable_blocker', 'finished']);
+export function emptyState() {
+    return {
+        schema_version: STATE_SCHEMA_VERSION,
+        execution: { phase: 'discovery', step: 'define_problem' },
+        active: { work_item: null, task: null },
+        stop_reason: null,
+        migration: { status: 'not_required' }
+    };
+}
+export function parseState(text, { source = 'state.yaml' } = {}) {
+    const document = parseDocument(text, { prettyErrors: false, uniqueKeys: true });
+    if (document.errors.length)
+        throw new ArtifactValidationError(`${source} is invalid: ${document.errors[0].message}`);
+    const value = document.toJS();
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        throw new ArtifactValidationError(`${source} must be a mapping.`);
+    if (value.schema_version !== STATE_SCHEMA_VERSION)
+        throw new ArtifactValidationError(`${source} schema_version must be ${STATE_SCHEMA_VERSION}.`);
+    const phase = value.execution?.phase;
+    if (!PHASES.has(phase))
+        throw new ArtifactValidationError(`${source} execution.phase is invalid.`);
+    const step = value.execution?.step;
+    if (!WORKFLOW_STEPS[phase].includes(step))
+        throw new ArtifactValidationError(`${source} execution.step '${step}' is invalid for phase '${phase}'.`);
+    if (!STOP_REASONS.has(value.stop_reason ?? null))
+        throw new ArtifactValidationError(`${source} stop_reason is invalid.`);
+    if (!['not_required', 'pending_reconciliation', 'completed'].includes(value.migration?.status ?? 'not_required'))
+        throw new ArtifactValidationError(`${source} migration.status is invalid.`);
+    const activeWorkItem = value.active?.work_item ?? null;
+    const activeTask = value.active?.task ?? null;
+    if (activeWorkItem !== null && !WORK_ITEM_ID.test(activeWorkItem))
+        throw new ArtifactValidationError(`${source} active.work_item is invalid.`);
+    if (activeTask !== null && !QUALIFIED_TASK_ID.test(activeTask))
+        throw new ArtifactValidationError(`${source} active.task is invalid.`);
+    if (activeTask && activeWorkItem && !activeTask.startsWith(`${activeWorkItem}-`))
+        throw new ArtifactValidationError(`${source} active.task does not belong to active.work_item.`);
+    return {
+        schema_version: STATE_SCHEMA_VERSION,
+        execution: {
+            phase,
+            step
+        },
+        active: {
+            work_item: activeWorkItem,
+            task: activeTask
+        },
+        stop_reason: value.stop_reason ?? null,
+        migration: value.migration ?? { status: 'not_required' }
+    };
+}
+export function stringifyState(state) {
+    return stringify(state, { lineWidth: 0 });
+}
+//# sourceMappingURL=state.mjs.map

package/dist/artifacts/state.mjs.map

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

package/dist/artifacts/tasks.d.mts

@@ -0,0 +1,10 @@
+export declare function parseTasks(text: any, { source, expectedWorkItem }?: {
+    expectedWorkItem?: null | undefined;
+    source?: string | undefined;
+}): {
+    schema_version: number;
+    work_item: any;
+    tasks: any;
+};
+export declare function qualifiedTaskId(workItem: any, task: any): string;
+//# sourceMappingURL=tasks.d.mts.map

package/dist/artifacts/tasks.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.mts","sourceRoot":"","sources":["../../src/artifacts/tasks.mjs"],"names":[],"mappings":"AAmBA,wBAAgB,UAAU,CAAC,IAAI,KAAA,EAAE,EAAE,MAAqB,EAAE,gBAAuB,EAAE;;;CAAK;;;;EAsDvF;AAoBD,wBAAgB,eAAe,CAAC,QAAQ,KAAA,EAAE,IAAI,KAAA,UAE7C"}

package/dist/artifacts/tasks.mjs

@@ -0,0 +1,107 @@
+import { parseDocument } from 'yaml';
+import { ArtifactValidationError } from './backlog.mjs';
+import { LIFECYCLE_STATES, TASKS_SCHEMA_VERSION, TASK_ID as TASK_ID_PATTERN } from '../domain/contracts.mjs';
+const STATES = new Set(LIFECYCLE_STATES);
+const TASK_ID = TASK_ID_PATTERN;
+function fail(message) {
+    throw new ArtifactValidationError(message);
+}
+function requireObject(value, label) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        fail(`${label} must be a mapping.`);
+    return value;
+}
+function requireString(value, label) {
+    if (typeof value !== 'string' || !value.trim())
+        fail(`${label} must be a non-empty string.`);
+    return value.trim();
+}
+export function parseTasks(text, { source = 'tasks.yaml', expectedWorkItem = null } = {}) {
+    const document = parseDocument(text, { prettyErrors: false, uniqueKeys: true });
+    if (document.errors.length)
+        fail(`${source} is invalid: ${document.errors[0].message}`);
+    const value = requireObject(document.toJS(), source);
+    if (value.schema_version !== TASKS_SCHEMA_VERSION)
+        fail(`${source} schema_version must be ${TASKS_SCHEMA_VERSION}.`);
+    const workItem = requireString(value.work_item, `${source} work_item`);
+    if (expectedWorkItem && workItem !== expectedWorkItem)
+        fail(`${source} belongs to ${workItem}, expected ${expectedWorkItem}.`);
+    if (!Array.isArray(value.tasks))
+        fail(`${source} tasks must be a list.`);
+    const ids = new Set();
+    const tasks = value.tasks.map((raw, index) => {
+        const label = `tasks[${index}]`;
+        const task = requireObject(raw, label);
+        const id = requireString(task.id, `${label}.id`);
+        if (!TASK_ID.test(id))
+            fail(`${label}.id must use T followed by a zero-padded numeric sequence, e.g. T003.`);
+        if (ids.has(id))
+            fail(`${source} contains duplicate task ID '${id}'.`);
+        ids.add(id);
+        const title = requireString(task.title, `${label}.title`);
+        const state = task.state ?? task.status;
+        if (!STATES.has(state))
+            fail(`${label}.state must be pending, in_progress, or completed.`);
+        if (!Array.isArray(task.depends_on ?? []))
+            fail(`${label}.depends_on must be a list.`);
+        const dependencies = [...new Set(task.depends_on ?? [])];
+        if (dependencies.length !== (task.depends_on ?? []).length)
+            fail(`${id} contains duplicate task dependencies.`);
+        for (const dependency of dependencies) {
+            if (!TASK_ID.test(dependency))
+                fail(`${id} depends on invalid task ID '${dependency}'.`);
+            if (dependency === id)
+                fail(`${id} cannot depend on itself.`);
+        }
+        if (Object.hasOwn(task, 'traceability') ||
+            Object.hasOwn(task, 'implementation') ||
+            Object.hasOwn(task, 'commit_sha'))
+            fail(`${id}: traceability, implementation and commit_sha are retired.`);
+        if (task.provenance !== undefined && task.provenance !== 'legacy_migration')
+            fail(`${id}.provenance must be legacy_migration when present.`);
+        if (task.provenance === 'legacy_migration' && state !== 'completed')
+            fail(`${id}: legacy_migration is reserved for completed migrated tasks.`);
+        return {
+            id,
+            title,
+            state,
+            depends_on: dependencies,
+            ...(task.provenance ? { provenance: task.provenance } : {}),
+            ...(task.legacy_commit ? { legacy_commit: task.legacy_commit } : {})
+        };
+    });
+    const byId = new Map(tasks.map((task) => [task.id, task]));
+    for (const task of tasks)
+        for (const dependency of task.depends_on)
+            if (!byId.has(dependency))
+                fail(`${task.id} depends on unknown task '${dependency}'.`);
+    validateTaskDag(tasks);
+    if (tasks.filter((task) => task.state === 'in_progress').length > 1)
+        fail('Only one mutating task may be in_progress.');
+    return { schema_version: TASKS_SCHEMA_VERSION, work_item: workItem, tasks };
+}
+function validateTaskDag(tasks) {
+    const indegree = new Map(tasks.map((task) => [task.id, task.depends_on.length]));
+    const dependents = new Map(tasks.map((task) => [task.id, []]));
+    for (const task of tasks)
+        for (const dependency of task.depends_on)
+            dependents.get(dependency).push(task.id);
+    const queue = tasks.filter((task) => task.depends_on.length === 0).map((task) => task.id);
+    let visited = 0;
+    while (queue.length) {
+        const id = queue.shift();
+        visited += 1;
+        for (const dependent of dependents.get(id)) {
+            const next = indegree.get(dependent) - 1;
+            indegree.set(dependent, next);
+            if (next === 0)
+                queue.push(dependent);
+        }
+    }
+    if (visited !== tasks.length)
+        fail('tasks.yaml task dependencies contain a cycle.');
+}
+export function qualifiedTaskId(workItem, task) {
+    return `${workItem}-${task}`;
+}
+//# sourceMappingURL=tasks.mjs.map

package/dist/artifacts/tasks.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.mjs","sourceRoot":"","sources":["../../src/artifacts/tasks.mjs"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE7G,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,CAAC;AACzC,MAAM,OAAO,GAAG,eAAe,CAAC;AAEhC,SAAS,IAAI,CAAC,OAAO;IACnB,MAAM,IAAI,uBAAuB,CAAC,OAAO,CAAC,CAAC;AAC7C,CAAC;AACD,SAAS,aAAa,CAAC,KAAK,EAAE,KAAK;IACjC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,CAAC,GAAG,KAAK,qBAAqB,CAAC,CAAC;IACrG,OAAO,KAAK,CAAC;AACf,CAAC;AACD,SAAS,aAAa,CAAC,KAAK,EAAE,KAAK;IACjC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;QAAE,IAAI,CAAC,GAAG,KAAK,8BAA8B,CAAC,CAAC;IAC7F,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAI,EAAE,EAAE,MAAM,GAAG,YAAY,EAAE,gBAAgB,GAAG,IAAI,EAAE,GAAG,EAAE;IACtF,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;IAChF,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM;QAAE,IAAI,CAAC,GAAG,MAAM,gBAAgB,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACxF,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;IACrD,IAAI,KAAK,CAAC,cAAc,KAAK,oBAAoB;QAAE,IAAI,CAAC,GAAG,MAAM,2BAA2B,oBAAoB,GAAG,CAAC,CAAC;IACrH,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,SAAS,EAAE,GAAG,MAAM,YAAY,CAAC,CAAC;IACvE,IAAI,gBAAgB,IAAI,QAAQ,KAAK,gBAAgB;QACnD,IAAI,CAAC,GAAG,MAAM,eAAe,QAAQ,cAAc,gBAAgB,GAAG,CAAC,CAAC;IAC1E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;QAAE,IAAI,CAAC,GAAG,MAAM,wBAAwB,CAAC,CAAC;IACzE,MAAM,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;IACtB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAC3C,MAAM,KAAK,GAAG,SAAS,KAAK,GAAG,CAAC;QAChC,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACvC,MAAM,EAAE,GAAG,aAAa,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,KAAK,KAAK,CAAC,CAAC;QACjD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAAE,IAAI,CAAC,GAAG,KAAK,uEAAuE,CAAC,CAAC;QAC7G,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,IAAI,CAAC,GAAG,MAAM,gCAAgC,EAAE,IAAI,CAAC,CAAC;QACvE,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACZ,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,KAAK,QAAQ,CAAC,CAAC;QAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC;QACxC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,IAAI,CAAC,GAAG,KAAK,oDAAoD,CAAC,CAAC;QAC3F,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;YAAE,IAAI,CAAC,GAAG,KAAK,6BAA6B,CAAC,CAAC;QACvF,MAAM,YAAY,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC;QACzD,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,MAAM;YAAE,IAAI,CAAC,GAAG,EAAE,wCAAwC,CAAC,CAAC;QAChH,KAAK,MAAM,UAAU,IAAI,YAAY,EAAE,CAAC;YACtC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC;gBAAE,IAAI,CAAC,GAAG,EAAE,gCAAgC,UAAU,IAAI,CAAC,CAAC;YACzF,IAAI,UAAU,KAAK,EAAE;gBAAE,IAAI,CAAC,GAAG,EAAE,2BAA2B,CAAC,CAAC;QAChE,CAAC;QACD,IACE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC;YACnC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC;YACrC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC;YAEjC,IAAI,CAAC,GAAG,EAAE,4DAA4D,CAAC,CAAC;QAC1E,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,KAAK,kBAAkB;YACzE,IAAI,CAAC,GAAG,EAAE,oDAAoD,CAAC,CAAC;QAClE,IAAI,IAAI,CAAC,UAAU,KAAK,kBAAkB,IAAI,KAAK,KAAK,WAAW;YACjE,IAAI,CAAC,GAAG,EAAE,8DAA8D,CAAC,CAAC;QAC5E,OAAO;YACL,EAAE;YACF,KAAK;YACL,KAAK;YACL,UAAU,EAAE,YAAY;YACxB,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3D,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrE,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3D,KAAK,MAAM,IAAI,IAAI,KAAK;QACtB,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,UAAU;YACtC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC;gBAAE,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,6BAA6B,UAAU,IAAI,CAAC,CAAC;IAC3F,eAAe,CAAC,KAAK,CAAC,CAAC;IACvB,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,aAAa,CAAC,CAAC,MAAM,GAAG,CAAC;QACjE,IAAI,CAAC,4CAA4C,CAAC,CAAC;IACrD,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC9E,CAAC;AAED,SAAS,eAAe,CAAC,KAAK;IAC5B,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACjF,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/D,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,UAAU;YAAE,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7G,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1F,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,CAAC;QACb,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACzC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YAC9B,IAAI,IAAI,KAAK,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,CAAC,MAAM;QAAE,IAAI,CAAC,+CAA+C,CAAC,CAAC;AACtF,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAQ,EAAE,IAAI;IAC5C,OAAO,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAC;AAC/B,CAAC"}

package/dist/artifacts/work-items.d.mts

@@ -0,0 +1,21 @@
+export declare function workItemsDirectory(root: any): any;
+export declare function loadWorkItems(root: any): any;
+export declare function lifecycle(item: any, byId: any): {
+    status: string;
+    reasons: any[];
+};
+export declare function derivedBacklog(items: any): {
+    schema_version: number;
+    work_items: {
+        id: any;
+        folder: any;
+        title: any;
+        kind: any;
+        priority: any;
+        spec_maturity: any;
+        depends_on: any;
+        blockers: any;
+        state: string;
+    }[];
+};
+//# sourceMappingURL=work-items.d.mts.map

package/dist/artifacts/work-items.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-items.d.mts","sourceRoot":"","sources":["../../src/artifacts/work-items.mjs"],"names":[],"mappings":"AASA,wBAAgB,kBAAkB,CAAC,IAAI,KAAA,OAEtC;AACD,wBAAgB,aAAa,CAAC,IAAI,KAAA,OA2BjC;AACD,wBAAgB,SAAS,CAAC,IAAI,KAAA,EAAE,IAAI,KAAA;;;EAgBnC;AACD,wBAAgB,cAAc,CAAC,KAAK,KAAA;IAGhC,cAAc;IACd,UAAU;;;;;;;;;;;EAYb"}

package/dist/artifacts/work-items.mjs

@@ -0,0 +1,81 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { parseWorkItemSpec } from './spec.mjs';
+import { parseTasks } from './tasks.mjs';
+import { parseReview } from './review.mjs';
+import { validateAcyclic, ArtifactValidationError, topologicalOrder } from './backlog.mjs';
+const folderPattern = /^(W\d{3,})-[a-z0-9]+(?:-[a-z0-9]+)*$/;
+const read = (file) => fs.readFileSync(file, 'utf8');
+export function workItemsDirectory(root) {
+    return path.join(root, '_flow', 'work-items');
+}
+export function loadWorkItems(root) {
+    const dir = workItemsDirectory(root);
+    if (!fs.existsSync(dir))
+        return [];
+    const items = fs
+        .readdirSync(dir, { withFileTypes: true })
+        .filter((e) => e.isDirectory())
+        .map((entry) => {
+        const match = entry.name.match(folderPattern);
+        if (!match)
+            throw new ArtifactValidationError(`Invalid work-item folder '${entry.name}'.`);
+        const base = path.join(dir, entry.name);
+        const id = match[1];
+        for (const name of ['spec.md', 'tasks.yaml', 'implementation-plan.md', 'review.yaml'])
+            if (!fs.existsSync(path.join(base, name)))
+                throw new ArtifactValidationError(`${id} is missing ${name}.`);
+        const spec = parseWorkItemSpec(read(path.join(base, 'spec.md')), { expectedWorkItem: id });
+        const tasks = parseTasks(read(path.join(base, 'tasks.yaml')), { expectedWorkItem: id });
+        const review = parseReview(read(path.join(base, 'review.yaml')), { expectedWorkItem: id });
+        return { id, folder: entry.name, ...spec.metadata, specBody: spec.body, tasks, review, base };
+    })
+        .sort((a, b) => a.id.localeCompare(b.id, undefined, { numeric: true }));
+    const ids = new Set(items.map((i) => i.id));
+    for (const item of items)
+        for (const dep of item.depends_on) {
+            if (!ids.has(dep))
+                throw new ArtifactValidationError(`${item.id} depends on unknown work item '${dep}'.`);
+            if (dep === item.id)
+                throw new ArtifactValidationError(`${item.id} cannot depend on itself.`);
+        }
+    validateAcyclic(items);
+    return items;
+}
+export function lifecycle(item, byId) {
+    if (item.maturity === 'outlined')
+        return { status: 'outlined', reasons: [] };
+    const incomplete = item.depends_on.filter((id) => lifecycle(byId.get(id), byId).status !== 'completed');
+    const blockers = item.blockers.filter((b) => b.status === 'unresolved');
+    if (incomplete.length || blockers.length)
+        return {
+            status: 'blocked',
+            reasons: [
+                ...incomplete.map((ref) => ({ type: 'dependency', ref })),
+                ...blockers.map((b) => ({ type: 'blocker', ref: b.id }))
+            ]
+        };
+    if (item.tasks.tasks.some((t) => t.state === 'in_progress'))
+        return { status: 'in_progress', reasons: [] };
+    if (item.tasks.tasks.length && item.tasks.tasks.every((t) => t.state === 'completed'))
+        return { status: item.review.status === 'approved' ? 'completed' : 'review', reasons: [] };
+    return { status: 'eligible', reasons: [] };
+}
+export function derivedBacklog(items) {
+    const byId = new Map(items.map((i) => [i.id, i]));
+    return {
+        schema_version: 4,
+        work_items: topologicalOrder(items).map((i) => ({
+            id: i.id,
+            folder: i.folder,
+            title: i.title,
+            kind: i.kind,
+            priority: i.priority,
+            spec_maturity: i.maturity,
+            depends_on: i.depends_on,
+            blockers: i.blockers,
+            state: lifecycle(i, byId).status
+        }))
+    };
+}
+//# sourceMappingURL=work-items.mjs.map

package/dist/artifacts/work-items.mjs.map

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