specky-sdd 3.10.0 → 3.10.2

package/dist/utils/task-parser.js

@@ -0,0 +1,159 @@
+/**
+ * task-parser.ts — Dual-format TASKS.md parser.
+ *
+ * Canonical writers (sdd_write_tasks, auto_pipeline) emit markdown tables.
+ * Legacy / hand-edited files may use checkbox bullets (`- [ ] T-001: …`).
+ * This module accepts both and merges by task ID.
+ */
+import { extractRequirementIds, normalizeTaskId, TASK_ID_PATTERN, TASK_LINE_PATTERN, } from "./id-contracts.js";
+const TASK_TABLE_ROW = /^\|\s*(T-?\d{3})\s*\|\s*([^|]*?)\s*\|\s*([^|]*?)\s*\|\s*([^|]*?)\s*\|\s*([^|]*?)\s*\|\s*([^|]*?)\s*\|$/i;
+const SUBTASK_LINE = /^\s{2,}-\s+(?:\[[ x]\]\s+)?(.+)/;
+const TRAILING_TRACE_SUFFIX = /\s*[(\[]?\s*(?:traces?(?:_to)?\s*:\s*)?REQ-[A-Z]+-\d{3}(?:\s*,\s*REQ-[A-Z]+-\d{3})*\s*[)\]]?\s*$/i;
+function splitCellList(cell) {
+    const trimmed = cell.trim();
+    if (!trimmed || trimmed === "—" || trimmed === "-" || trimmed === "–")
+        return [];
+    return trimmed
+        .split(/[,;]/)
+        .map((part) => part.trim())
+        .filter((part) => part.length > 0 && part !== "—" && part !== "-" && part !== "–");
+}
+function parseDependencies(cell) {
+    const ids = [];
+    for (const token of splitCellList(cell)) {
+        for (const match of token.matchAll(TASK_ID_PATTERN)) {
+            try {
+                ids.push(normalizeTaskId(match[0]));
+            }
+            catch {
+                // skip malformed tokens
+            }
+        }
+    }
+    return [...new Set(ids)];
+}
+function parseTraces(cell, title) {
+    const fromCell = extractRequirementIds(cell);
+    const fromTitle = extractRequirementIds(title);
+    return [...new Set([...fromCell, ...fromTitle])].sort((a, b) => a.localeCompare(b));
+}
+function cleanTitle(raw) {
+    return raw.replace(TRAILING_TRACE_SUFFIX, "").trim() || raw.trim();
+}
+function isSeparatorOrHeader(line) {
+    if (/^\|\s*[-:| ]+\s*\|$/.test(line))
+        return true;
+    if (/^\|\s*ID\s*\|/i.test(line))
+        return true;
+    if (/^\|\s*\*\*/.test(line))
+        return true; // effort summary totals
+    return false;
+}
+function parseTableRows(content) {
+    const tasks = [];
+    for (const line of content.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed.startsWith("|") || isSeparatorOrHeader(trimmed))
+            continue;
+        const match = TASK_TABLE_ROW.exec(trimmed);
+        if (!match)
+            continue;
+        let id;
+        try {
+            id = normalizeTaskId(match[1]);
+        }
+        catch {
+            continue;
+        }
+        const rawTitle = match[2].trim();
+        if (!rawTitle)
+            continue;
+        const parallelCell = match[3].trim();
+        const effortCell = match[4].trim();
+        const depsCell = match[5];
+        const tracesCell = match[6];
+        tasks.push({
+            id,
+            title: cleanTitle(rawTitle),
+            parallel: /\[P\]/i.test(parallelCell) || /\[P\]/i.test(rawTitle),
+            effort: effortCell && effortCell !== "—" ? effortCell : undefined,
+            dependencies: parseDependencies(depsCell),
+            traces_to: parseTraces(tracesCell, rawTitle),
+            claimed_done: false,
+            subtasks: [],
+        });
+    }
+    return tasks;
+}
+function parseCheckboxTasks(content) {
+    const tasks = [];
+    const lines = content.split("\n");
+    const linePattern = new RegExp(TASK_LINE_PATTERN.source, "i");
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const match = linePattern.exec(line);
+        if (!match)
+            continue;
+        let id;
+        try {
+            id = normalizeTaskId(match[1]);
+        }
+        catch {
+            continue;
+        }
+        const rawTitle = (match[3] ?? "").trim();
+        const parallel = /\[P\]/i.test(line);
+        const claimed_done = /^-\s+\[x\]/i.test(line.trim());
+        const dependencySection = /depends?:\s*([^;.)]+)/i.exec(rawTitle)?.[1] ?? "";
+        const dependencies = [...dependencySection.matchAll(TASK_ID_PATTERN)].map((dep) => normalizeTaskId(dep[0]));
+        const subtasks = [];
+        for (let j = i + 1; j < lines.length; j++) {
+            const sub = SUBTASK_LINE.exec(lines[j]);
+            if (!sub)
+                break;
+            subtasks.push(sub[1].trim());
+            i = j;
+        }
+        tasks.push({
+            id,
+            title: cleanTitle(rawTitle),
+            parallel,
+            dependencies,
+            traces_to: extractRequirementIds(rawTitle),
+            claimed_done,
+            subtasks,
+        });
+    }
+    return tasks;
+}
+/**
+ * Parse TASKS.md content supporting both canonical table rows and checkbox bullets.
+ * When both formats mention the same ID, checkbox wins for claimed_done / subtasks;
+ * table wins for effort / structured dependencies when checkbox deps are empty.
+ */
+export function parseTasksFromMarkdown(content) {
+    const byId = new Map();
+    for (const task of parseTableRows(content)) {
+        byId.set(task.id, task);
+    }
+    for (const task of parseCheckboxTasks(content)) {
+        const existing = byId.get(task.id);
+        if (!existing) {
+            byId.set(task.id, task);
+            continue;
+        }
+        byId.set(task.id, {
+            ...existing,
+            title: task.title || existing.title,
+            parallel: task.parallel || existing.parallel,
+            claimed_done: task.claimed_done,
+            subtasks: task.subtasks.length > 0 ? task.subtasks : existing.subtasks,
+            dependencies: task.dependencies.length > 0 ? task.dependencies : existing.dependencies,
+            traces_to: task.traces_to.length > 0
+                ? [...new Set([...existing.traces_to, ...task.traces_to])].sort((a, b) => a.localeCompare(b))
+                : existing.traces_to,
+        });
+    }
+    return [...byId.values()].sort((a, b) => a.id.localeCompare(b.id));
+}
+//# sourceMappingURL=task-parser.js.map

package/dist/utils/task-parser.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specky-sdd",
-  "version": "3.10.0",
+  "version": "3.10.2",
   "description": "Specky — Spec-Driven Development CLI toolkit. 58 MCP tools, 13 agents, 22 prompts, 14 skills, 16 hooks. Unified `specky` CLI installs to Claude Code, GitHub Copilot, Cursor, or OpenCode on macOS, Linux, and Windows.",
   "type": "module",
   "main": "dist/index.js",

package/templates/compliance.md

@@ -12,8 +12,7 @@
 
 | Control ID | Name | Status | Evidence | Remediation |
 |-----------|------|--------|----------|-------------|
-{{#each findings}}
-| {{control_id}} | {{control_name}} | {{status}} | {{evidence}} | {{remediation}} |
+{{#each findings}}{{this}}
 {{/each}}
 
 ## Summary

package/templates/verification.md

@@ -11,8 +11,7 @@
 
 | Task | Claimed | Verified | Phantom? | Evidence |
 |------|---------|----------|----------|----------|
-{{#each results}}
-| {{task_id}} | {{claimed_status}} | {{verified_status}} | {{phantom}} | {{evidence}} |
+{{#each results}}{{this}}
 {{/each}}
 
 ## Summary