@rasensio/aidlc 1.5.0 → 1.7.0

package/dist/tasks/gate-criterion.js

@@ -0,0 +1,180 @@
+/**
+ * Tasks gate criterion (FR3): computed live at the command layer after
+ * `evaluateGate`, following the traceability precedent — it evaluates even
+ * when phase state is `complete` (AC-11) and never touches `evaluateGate`'s
+ * contract.
+ *
+ * Applicability tri-state (DD7):
+ *   null                      phase ≠ implementation, phase-implementation.yaml
+ *                             absent (AC-30), or opt-in with no task-shaped
+ *                             lines / missing file (AC-6)
+ *   result, empty entries     only near-misses — warnings surface (AC-5), or
+ *                             the required-scope backstops fired (AC-17, AC-28)
+ *   result with entries       ≥1 valid task — full evaluation
+ *
+ * Bare AC refs resolve to the owning instance (DD8): a tasks file lives in
+ * one instance's state dir, so its bare `AC-n` means this instance's AC-n —
+ * traceability's cross-instance uniqueness rule (for free-floating test
+ * files) does not transfer.
+ *
+ * Requirements: task-breakdown/AC-6, AC-11..AC-17, AC-28, AC-30
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { loadRegistry } from '../traceability/gate-criterion.js';
+import { parseTasks } from './parser.js';
+/** Message template for open tasks (DD6). */
+export function openTaskMessage(id, title) {
+    return `task T${id} "${title}" is open (tasks)`;
+}
+/** Message template for malformed deferrals (AC-2, DD6). */
+export function malformedDeferralMessage(id) {
+    return `task T${id} has a malformed deferral (tasks)`;
+}
+/** Message for the missing/empty required-scope backstops (AC-17, AC-28). */
+export function missingTasksMessage(kind) {
+    return kind === 'file'
+        ? 'required artifact tasks.md is missing (tasks)'
+        : 'tasks.md defines no tasks (tasks)';
+}
+/**
+ * Required-scope determination (AC-27, DD5): the template requires tasks.md
+ * at design AND the instance's phase-design.yaml carries a tasks.md artifact
+ * entry (legacy instances without the entry are legacy-allowed).
+ */
+function isRequiredScope(instanceDir, template) {
+    if (!template)
+        return false;
+    const designPhase = template.phases.find((p) => p.name === 'design');
+    const templateRequires = designPhase?.required_artifacts?.some((a) => a.name === 'tasks.md');
+    if (!templateRequires)
+        return false;
+    try {
+        const state = parseYaml(readFileSync(join(instanceDir, 'phase-design.yaml'), 'utf8'));
+        return Boolean(state?.artifacts?.some((a) => a?.name === 'tasks.md'));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Evaluate the tasks criterion for one instance.
+ *
+ * @param template - Resolved template; null degrades to opt-in semantics
+ *   with a warning (defensive — both CLI call sites early-exit before this
+ *   on resolution failure).
+ * @returns null when the criterion does not evaluate (AC-6, AC-30);
+ *   otherwise a result whose `openTasks`/`malformed`/`missing` the caller
+ *   turns into unsatisfied criteria / gate violations via the message
+ *   helpers above.
+ */
+export function evaluateTasksCriterion(projectRoot, instanceName, phaseName, template) {
+    if (phaseName !== 'implementation')
+        return null;
+    const instanceDir = join(projectRoot, '.aidlc', 'state', instanceName);
+    if (!existsSync(join(instanceDir, 'phase-implementation.yaml')))
+        return null;
+    const tasksPath = `.aidlc/state/${instanceName}/tasks.md`;
+    const warnings = [];
+    if (template === null) {
+        warnings.push('template unresolvable — tasks criterion degrades to opt-in');
+    }
+    const required = isRequiredScope(instanceDir, template);
+    let content = null;
+    try {
+        content = readFileSync(join(instanceDir, 'tasks.md'), 'utf8');
+    }
+    catch (err) {
+        if (err.code !== 'ENOENT') {
+            warnings.push(`tasks.md is unreadable (${err.message}) — treated as missing`);
+        }
+        if (!required)
+            return null;
+        return { tasksPath, entries: [], warnings, openTasks: [], malformed: [], missing: 'file' };
+    }
+    const parsed = parseTasks(content);
+    warnings.push(...parsed.warnings);
+    if (parsed.tasks.length === 0 && parsed.malformedDeferrals.length === 0) {
+        if (required) {
+            // AC-28: exists but defines no tasks — near-miss warnings surface.
+            return { tasksPath, entries: [], warnings, openTasks: [], malformed: [], missing: 'empty' };
+        }
+        if (parsed.taskShapedLines === 0)
+            return null; // AC-6
+        // Tri-state case 2: only near-misses — visible, not silent.
+        return { tasksPath, entries: [], warnings, openTasks: [], malformed: [] };
+    }
+    // Registry linkage (AC-14..16): skipped when this instance defines no ACs.
+    const registry = loadRegistry(projectRoot);
+    const own = registry.get(instanceName);
+    if (!own || own.defs.length === 0) {
+        if (parsed.tasks.some((t) => t.acRefs.length > 0)) {
+            warnings.push(`instance defines no acceptance criteria — task AC references are not checked`);
+        }
+    }
+    else {
+        const ownActive = new Set(own.defs.filter((d) => d.status === 'active').map((d) => d.id));
+        const ownById = new Map(own.defs.map((d) => [d.id, d]));
+        const claimed = new Set();
+        for (const task of parsed.tasks) {
+            if (task.acRefs.length === 0) {
+                // AC-15: chore tasks are legitimate; the gap is made visible.
+                warnings.push(`task T${task.id} references no acceptance criteria`);
+                continue;
+            }
+            for (const ref of task.acRefs) {
+                const isSelf = ref.instance === null || ref.instance === instanceName;
+                if (isSelf) {
+                    const def = ownById.get(ref.id);
+                    if (!def) {
+                        warnings.push(`task T${task.id} references unknown AC-${ref.id}`);
+                    }
+                    else if (def.status === 'retired') {
+                        warnings.push(`task T${task.id} references retired AC-${ref.id}`);
+                    }
+                    else {
+                        claimed.add(ref.id); // bare and qualified self-refs count (AC-16)
+                    }
+                    continue;
+                }
+                // Cross-instance ref: validated, never satisfies AC-16 (AC-14).
+                const other = registry.get(ref.instance);
+                const def = other?.defs.find((d) => d.id === ref.id);
+                if (!def) {
+                    warnings.push(`task T${task.id} references unknown ${ref.instance}/AC-${ref.id}`);
+                }
+                else if (def.status === 'retired') {
+                    warnings.push(`task T${task.id} references retired ${ref.instance}/AC-${ref.id}`);
+                }
+            }
+        }
+        // AC-16: unclaimed active ACs of this instance — decomposition gaps.
+        for (const id of [...ownActive].sort((a, b) => a - b)) {
+            if (!claimed.has(id)) {
+                warnings.push(`AC-${id} is claimed by no task`);
+            }
+        }
+    }
+    // Deferred tasks surface as warnings, never failures (AC-13).
+    for (const task of parsed.tasks) {
+        if (task.state === 'deferred') {
+            warnings.push(`task T${task.id} is deferred: ${task.deferReason}`);
+        }
+    }
+    const entries = parsed.tasks.map((t) => ({
+        id: t.id,
+        state: t.state,
+        title: t.title,
+        acRefs: t.acRefs.map((r) => (r.instance ? `${r.instance}/AC-${r.id}` : `AC-${r.id}`)),
+        ...(t.deferReason !== undefined && { deferReason: t.deferReason }),
+    }));
+    return {
+        tasksPath,
+        entries,
+        warnings,
+        openTasks: parsed.tasks.filter((t) => t.state === 'open').map((t) => t.id),
+        malformed: parsed.malformedDeferrals.map((m) => m.id),
+    };
+}
+//# sourceMappingURL=gate-criterion.js.map

package/dist/tasks/gate-criterion.js.map

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

package/dist/tasks/parser.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Task-line parser: closed grammar over tasks.md (FR1).
+ *
+ * Accepted forms (column-0 dash bullets only; indented task-shaped lines are
+ * near-misses, F7):
+ *   - [ ] T<n>: <title>
+ *   - [ ] T<n>: <title> (AC-1, other-instance/AC-2)
+ *   - [x] T<n>: <title> (AC-3)
+ *   - [>] T<n>: <title> [(AC-list)] (deferred YYYY-MM-DD: <reason>)
+ *
+ * Structural groups are extracted right-to-left (DD2): trailing parenthesized
+ * groups are structural when their content is deferral-shaped, keyword-colon,
+ * or AC-shaped; the first non-structural group ends the unwind (title prose).
+ * An AC-shaped group failing the strict list grammar is a near-miss (F5) —
+ * intended refs must never silently drop. Unrecognized keyword-colon groups
+ * (e.g. the reserved v2 `owner:`) keep the task and warn (AC-29).
+ *
+ * Anything task-shaped that fails the strict grammar warns rather than
+ * silently dropping out of gate coverage (AC-5).
+ *
+ * Requirements: task-breakdown/AC-1..AC-5, AC-29
+ */
+import type { ParsedTasks } from './types.js';
+/**
+ * Parse one tasks.md for task lines.
+ *
+ * @param content - File content (UTF-8). Never throws.
+ */
+export declare function parseTasks(content: string): ParsedTasks;
+//# sourceMappingURL=parser.d.ts.map

package/dist/tasks/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/tasks/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAkC,MAAM,YAAY,CAAC;AAsH9E;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CA4FvD"}

package/dist/tasks/parser.js

@@ -0,0 +1,200 @@
+/**
+ * Task-line parser: closed grammar over tasks.md (FR1).
+ *
+ * Accepted forms (column-0 dash bullets only; indented task-shaped lines are
+ * near-misses, F7):
+ *   - [ ] T<n>: <title>
+ *   - [ ] T<n>: <title> (AC-1, other-instance/AC-2)
+ *   - [x] T<n>: <title> (AC-3)
+ *   - [>] T<n>: <title> [(AC-list)] (deferred YYYY-MM-DD: <reason>)
+ *
+ * Structural groups are extracted right-to-left (DD2): trailing parenthesized
+ * groups are structural when their content is deferral-shaped, keyword-colon,
+ * or AC-shaped; the first non-structural group ends the unwind (title prose).
+ * An AC-shaped group failing the strict list grammar is a near-miss (F5) —
+ * intended refs must never silently drop. Unrecognized keyword-colon groups
+ * (e.g. the reserved v2 `owner:`) keep the task and warn (AC-29).
+ *
+ * Anything task-shaped that fails the strict grammar warns rather than
+ * silently dropping out of gate coverage (AC-5).
+ *
+ * Requirements: task-breakdown/AC-1..AC-5, AC-29
+ */
+// Loose: any bullet (numbered included, like the AC lint) + checkbox-ish +
+// T<n>-ish token → near-miss candidate (AC-5). Keeps leading whitespace so
+// indented task-shaped lines warn (F7).
+const TASK_SHAPED_RE = /^\s*(?:[-*+]|\d+\.)\s+\[[^\]]?\]\s*T\d+/i;
+// Strict prefix: column-0 dash bullet, exact checkbox, exact ID, colon,
+// non-empty rest (F13).
+const TASK_PREFIX_RE = /^-\s+\[( |x|>)\]\s+T([1-9][0-9]*):\s+(\S.*)$/;
+// A trailing parenthesized group is structural when its content starts with
+// a deferral keyword, a lowercase keyword-colon, or an AC token (F1, F11).
+const STRUCTURAL_SHAPED_RE = /^(?:deferred[ :]|[a-z][a-z-]*:|AC-\d|[a-z0-9-]+\/AC-\d)/;
+const DEFERRAL_RE = /^deferred (\d{4}-\d{2}-\d{2}): (.+)$/;
+const AC_ITEM = String.raw `(?:([a-z0-9-]+)\/)?AC-([1-9][0-9]*)`;
+const AC_LIST_RE = new RegExp(String.raw `^${AC_ITEM}(?:,\s*${AC_ITEM})*$`);
+const AC_ITEM_G = new RegExp(AC_ITEM, 'g');
+// Groups that begin with an AC token belong to the AC-list grammar; failing
+// it is a near-miss (F5), not an AC-29 unrecognized token.
+const AC_SHAPED_GROUP_RE = /^(?:AC-\d|[a-z0-9-]+\/AC-\d)/;
+const STATE_BY_MARKER = { ' ': 'open', x: 'done', '>': 'deferred' };
+// Most-blocking wins on duplicate IDs with conflicting states (AC-3, DD3).
+const BLOCK_RANK = { open: 0, deferred: 1, done: 2 };
+function excerpt(line) {
+    const trimmed = line.trim();
+    return trimmed.length > 60 ? `${trimmed.slice(0, 57)}...` : trimmed;
+}
+/**
+ * Unwind trailing parenthesized groups right-to-left (DD2), classifying each
+ * against the normative order `<title> [(AC-list)] [(deferral)]`.
+ */
+function extractGroups(rest) {
+    const result = {
+        title: rest,
+        acList: null,
+        deferral: null,
+        unrecognized: [],
+        nearMiss: null,
+    };
+    const groups = [];
+    let remainder = rest;
+    for (;;) {
+        const m = /^(.*?)\s*\(([^()]*)\)$/.exec(remainder);
+        if (!m || !STRUCTURAL_SHAPED_RE.test(m[2]))
+            break;
+        groups.unshift(m[2]);
+        remainder = m[1];
+    }
+    result.title = remainder;
+    // Groups are now in left-to-right order; enforce [AC-list] [deferral].
+    let sawDeferral = false;
+    for (const content of groups) {
+        if (content.startsWith('deferred')) {
+            const d = DEFERRAL_RE.exec(content);
+            if (!d) {
+                result.nearMiss = 'malformed deferral marker';
+                return result;
+            }
+            if (result.deferral) {
+                result.nearMiss = 'duplicate deferral marker';
+                return result;
+            }
+            result.deferral = { date: d[1], reason: d[2] };
+            sawDeferral = true;
+            continue;
+        }
+        if (sawDeferral) {
+            result.nearMiss = 'structural group after the deferral marker';
+            return result;
+        }
+        if (AC_SHAPED_GROUP_RE.test(content)) {
+            if (!AC_LIST_RE.test(content)) {
+                result.nearMiss = 'malformed AC list';
+                return result;
+            }
+            if (result.acList !== null) {
+                result.nearMiss = 'duplicate AC list';
+                return result;
+            }
+            result.acList = content;
+            continue;
+        }
+        // Keyword-colon group with an unrecognized keyword: keep and warn (AC-29).
+        result.unrecognized.push(content);
+    }
+    if (result.title.length === 0) {
+        result.nearMiss = 'empty title';
+    }
+    return result;
+}
+function parseAcRefs(acList) {
+    const refs = [];
+    for (const m of acList.matchAll(AC_ITEM_G)) {
+        refs.push({ instance: m[1] ?? null, id: Number(m[2]) });
+    }
+    return refs;
+}
+/**
+ * Parse one tasks.md for task lines.
+ *
+ * @param content - File content (UTF-8). Never throws.
+ */
+export function parseTasks(content) {
+    const warnings = [];
+    const malformedDeferrals = [];
+    const byId = new Map();
+    let taskShapedLines = 0;
+    const lines = content.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const lineNo = i + 1;
+        if (!TASK_SHAPED_RE.test(line))
+            continue;
+        taskShapedLines++;
+        const prefix = TASK_PREFIX_RE.exec(line);
+        if (!prefix) {
+            warnings.push(`line ${lineNo}: "${excerpt(line)}" resembles a task but does not match the grammar`);
+            continue;
+        }
+        const state = STATE_BY_MARKER[prefix[1]];
+        const id = Number(prefix[2]);
+        const groups = extractGroups(prefix[3]);
+        if (groups.nearMiss) {
+            // A [>] line whose deferral itself is malformed is the AC-2 parse
+            // error, not an ordinary near-miss — it must fail the gate.
+            if (state === 'deferred' && groups.nearMiss.includes('deferral')) {
+                malformedDeferrals.push({ id, line: lineNo });
+                warnings.push(`line ${lineNo}: task T${id} has a malformed deferral marker`);
+            }
+            else {
+                warnings.push(`line ${lineNo}: "${excerpt(line)}" — ${groups.nearMiss}`);
+            }
+            continue;
+        }
+        if (state === 'deferred' && !groups.deferral) {
+            malformedDeferrals.push({ id, line: lineNo });
+            warnings.push(`line ${lineNo}: task T${id} is deferred without a (deferred YYYY-MM-DD: reason) marker`);
+            continue;
+        }
+        if (state !== 'deferred' && groups.deferral) {
+            warnings.push(`line ${lineNo}: "${excerpt(line)}" — deferral marker on a ${state} task`);
+            continue;
+        }
+        for (const token of groups.unrecognized) {
+            warnings.push(`line ${lineNo}: task T${id} has an unrecognized trailing token "(${token})"`);
+        }
+        const task = {
+            id,
+            state,
+            title: groups.title,
+            acRefs: groups.acList ? parseAcRefs(groups.acList) : [],
+            line: lineNo,
+            ...(groups.deferral && {
+                deferReason: groups.deferral.reason,
+                deferDate: groups.deferral.date,
+            }),
+        };
+        const existing = byId.get(id);
+        if (existing) {
+            warnings.push(`duplicate T${id}: lines ${existing.line} and ${lineNo} (${existing.state === task.state
+                ? 'first occurrence wins'
+                : 'most-blocking state wins'})`);
+            if (BLOCK_RANK[task.state] < BLOCK_RANK[existing.state]) {
+                byId.set(id, task);
+            }
+            continue;
+        }
+        byId.set(id, task);
+    }
+    // Sequence gaps (AC-4), over parsed ids.
+    if (byId.size > 0) {
+        const maxId = Math.max(...byId.keys());
+        for (let n = 1; n <= maxId; n++) {
+            if (!byId.has(n))
+                warnings.push(`T${n} is never defined (sequence gap)`);
+        }
+    }
+    const tasks = [...byId.values()].sort((a, b) => a.id - b.id);
+    return { tasks, malformedDeferrals, warnings, taskShapedLines };
+}
+//# sourceMappingURL=parser.js.map

package/dist/tasks/parser.js.map

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

package/dist/tasks/status.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Task summary for the `aidlc status` column (task-breakdown AC-21).
+ *
+ * One file read per task-bearing instance, no glob, no cache (NFR4/DD4 —
+ * unlike traceability, there is no repo scan to amortize). Phase visibility
+ * (design-or-later, with an implementation anchor for templates without a
+ * design phase, F3) is checked by the caller, matching the
+ * `isTestingOrLater` precedent.
+ */
+import type { TasksSummary } from './types.js';
+/**
+ * Read and summarize one instance's tasks.md.
+ *
+ * @returns null when the file is absent, unreadable, or defines no tasks —
+ *   the column renders `-`.
+ */
+export declare function tasksForStatus(projectRoot: string, instanceName: string): TasksSummary | null;
+/** Format for the status table: `done/total`, plus ` ▸n` when deferred (AC-21). */
+export declare function formatTasks(summary: TasksSummary): string;
+//# sourceMappingURL=status.d.ts.map

package/dist/tasks/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/tasks/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAc7F;AAED,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAGzD"}

package/dist/tasks/status.js

@@ -0,0 +1,41 @@
+/**
+ * Task summary for the `aidlc status` column (task-breakdown AC-21).
+ *
+ * One file read per task-bearing instance, no glob, no cache (NFR4/DD4 —
+ * unlike traceability, there is no repo scan to amortize). Phase visibility
+ * (design-or-later, with an implementation anchor for templates without a
+ * design phase, F3) is checked by the caller, matching the
+ * `isTestingOrLater` precedent.
+ */
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { parseTasks } from './parser.js';
+/**
+ * Read and summarize one instance's tasks.md.
+ *
+ * @returns null when the file is absent, unreadable, or defines no tasks —
+ *   the column renders `-`.
+ */
+export function tasksForStatus(projectRoot, instanceName) {
+    let content;
+    try {
+        content = readFileSync(join(projectRoot, '.aidlc', 'state', instanceName, 'tasks.md'), 'utf8');
+    }
+    catch {
+        return null;
+    }
+    const { tasks } = parseTasks(content);
+    if (tasks.length === 0)
+        return null;
+    return {
+        done: tasks.filter((t) => t.state === 'done').length,
+        deferred: tasks.filter((t) => t.state === 'deferred').length,
+        total: tasks.length,
+    };
+}
+/** Format for the status table: `done/total`, plus ` ▸n` when deferred (AC-21). */
+export function formatTasks(summary) {
+    const base = `${summary.done}/${summary.total}`;
+    return summary.deferred > 0 ? `${base} ▸${summary.deferred}` : base;
+}
+//# sourceMappingURL=status.js.map

package/dist/tasks/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/tasks/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,WAAmB,EAAE,YAAoB;IACtE,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC;IACjG,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,MAAM;QACpD,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,MAAM;QAC5D,KAAK,EAAE,KAAK,CAAC,MAAM;KACpB,CAAC;AACJ,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,WAAW,CAAC,OAAqB;IAC/C,MAAM,IAAI,GAAG,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAChD,OAAO,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACtE,CAAC"}

package/dist/tasks/types.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Tasks types: task lines parsed from tasks.md, the gate-criterion result
+ * exposed via `aidlc gate --json` (task-breakdown AC-19), and the status
+ * column summary (AC-21).
+ *
+ * Design: design.md (task-breakdown) §1
+ */
+export type TaskState = 'open' | 'done' | 'deferred';
+/** One AC reference in a task line's AC list. */
+export interface TaskAcRef {
+    /** n in AC-n (≥1, no leading zeros). */
+    id: number;
+    /**
+     * Qualified instance name, or null for a bare token. Bare refs resolve to
+     * the owning instance (DD8) — never traceability's uniqueness rule.
+     */
+    instance: string | null;
+}
+/** A single task line parsed from tasks.md (FR1). */
+export interface TaskLine {
+    /** n in T<n> (≥1, no leading zeros). */
+    id: number;
+    state: TaskState;
+    /** Non-empty title prose (empty titles are near-misses). */
+    title: string;
+    acRefs: TaskAcRef[];
+    /** Present iff state === 'deferred'. */
+    deferReason?: string;
+    /** YYYY-MM-DD, shape-validated only; present iff state === 'deferred'. */
+    deferDate?: string;
+    /** 1-based line number in tasks.md. */
+    line: number;
+}
+/** Parse result for one instance's tasks.md. */
+export interface ParsedTasks {
+    /** Ordered by id (NFR3); most-blocking state wins on duplicates (AC-3). */
+    tasks: TaskLine[];
+    /**
+     * `[>]` lines without a well-formed deferral marker (AC-2) — these force
+     * the criterion unsatisfied, unlike ordinary near-misses. Only lines whose
+     * strict prefix (id included) parsed can land here; a `[>]` line with a
+     * broken prefix is an ordinary near-miss (AC-5).
+     */
+    malformedDeferrals: {
+        id: number;
+        line: number;
+    }[];
+    /** Duplicates, near-misses, sequence gaps — ordered by line (NFR3). */
+    warnings: string[];
+    /**
+     * Lines matching the loose task pattern (tasks + malformed + near-misses).
+     * Drives the applicability tri-state (DD7): 0 → criterion silent for
+     * opt-in instances; >0 with no tasks → warnings-only result.
+     */
+    taskShapedLines: number;
+}
+/** Per-task row of the gate JSON `tasks` field (AC-19). */
+export interface TaskEntry {
+    id: number;
+    state: TaskState;
+    title: string;
+    /** Rendered as written: `AC-3` or `other-instance/AC-3`. */
+    acRefs: string[];
+    deferReason?: string;
+}
+/** Full tasks result attached to GateCheckResult (AC-19). */
+export interface TasksResult {
+    /** Posix-separated, project-root-relative tasks.md path. */
+    tasksPath: string;
+    /** Sorted by id (NFR3). */
+    entries: TaskEntry[];
+    /** Ordered by line (NFR3). */
+    warnings: string[];
+    /** Open ([ ]) task ids — drive gate failure (AC-11). */
+    openTasks: number[];
+    /** Malformed-deferral task ids (AC-2) — also drive gate failure. */
+    malformed: number[];
+    /** Set when the AC-17 (file) / AC-28 (empty) backstop fails the gate. */
+    missing?: 'file' | 'empty';
+}
+/** Task summary for the `aidlc status` column (AC-21). */
+export interface TasksSummary {
+    /** [x] count — deferred is NOT counted here. */
+    done: number;
+    /** [>] count, rendered as ` ▸n` when > 0. */
+    deferred: number;
+    /** All task lines, deferred included. */
+    total: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/tasks/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tasks/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;AAErD,iDAAiD;AACjD,MAAM,WAAW,SAAS;IACxB,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX;;;OAGG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,qDAAqD;AACrD,MAAM,WAAW,QAAQ;IACvB,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,SAAS,CAAC;IACjB,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,gDAAgD;AAChD,MAAM,WAAW,WAAW;IAC1B,2EAA2E;IAC3E,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB;;;;;OAKG;IACH,kBAAkB,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACnD,uEAAuE;IACvE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB;;;;OAIG;IACH,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,2DAA2D;AAC3D,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,6DAA6D;AAC7D,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,wDAAwD;IACxD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,oEAAoE;IACpE,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5B;AAED,0DAA0D;AAC1D,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/tasks/types.js

@@ -0,0 +1,9 @@
+/**
+ * Tasks types: task lines parsed from tasks.md, the gate-criterion result
+ * exposed via `aidlc gate --json` (task-breakdown AC-19), and the status
+ * column summary (AC-21).
+ *
+ * Design: design.md (task-breakdown) §1
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tasks/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tasks/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rasensio/aidlc",
-  "version": "1.5.0",
+  "version": "1.7.0",
   "description": "AI Development Lifecycle Framework — structured lifecycle guidance for AI coding agents across platforms",
   "type": "module",
   "main": "dist/cli.js",
@@ -24,7 +24,7 @@
     "commander": "15.0.0",
     "picomatch": "4.0.5",
     "yaml": "2.9.0",
-    "@rasensio/aidlc-content": "1.5.0"
+    "@rasensio/aidlc-content": "1.7.0"
   },
   "devDependencies": {
     "@types/node": "22.15.32",