@rasensio/aidlc 1.4.0 → 1.6.0

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.4.0",
+  "version": "1.6.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.4.0"
+    "@rasensio/aidlc-content": "1.6.0"
   },
   "devDependencies": {
     "@types/node": "22.15.32",