@iq-context/core 0.1.0 → 0.3.0

package/dist/invariants.js

@@ -0,0 +1,415 @@
+const REQUIREMENT_LABELS = {
+    project: "project-state.json",
+    focus: "focus-state.json",
+    config: "config.yaml",
+    pointer: "workstreams/current.txt",
+    workstreamDirs: "the workstreams directory listing",
+};
+export function pass() {
+    return { status: "pass" };
+}
+export function skipped(reason) {
+    return { status: "skipped", reason };
+}
+/**
+ * Collapses a per-scope evaluation into an outcome.
+ *
+ * Precedence: a real contradiction outranks incompleteness, so violations win
+ * and carry the unevaluated scopes along for reporting. With no violations and
+ * at least one unevaluated scope the result is "partial", never "pass".
+ */
+export function resolveOutcome(violations, skippedScopes = []) {
+    if (violations.length > 0) {
+        return { status: "violated", violations, skippedScopes };
+    }
+    if (skippedScopes.length > 0) {
+        return { status: "partial", skippedScopes };
+    }
+    return pass();
+}
+/**
+ * Unwraps a slot the invariant declared in `requires`. The evaluator guarantees
+ * it loaded, so reaching the throw means an invariant read a slot it did not
+ * declare.
+ */
+function must(result, what) {
+    if (!result.loaded) {
+        throw new Error(`Invariant evaluated without its required input: ${what}.`);
+    }
+    return result.value;
+}
+const focusTargetExists = {
+    id: "focus-target-exists",
+    description: "focus points to an existing workstream directory",
+    requires: ["focus", "workstreamDirs"],
+    evaluate(snapshot) {
+        const targetId = must(snapshot.focus, "focus").current_workstream_id;
+        const present = must(snapshot.workstreamDirs, "workstreamDirs").valid;
+        if (present.includes(targetId)) {
+            return pass();
+        }
+        return resolveOutcome([{
+                invariantId: "focus-target-exists",
+                severity: "error",
+                scope: { kind: "focus" },
+                message: `Focus points to workstream "${targetId}", which has no directory under .iq-context/workstreams.`,
+            }]);
+    },
+};
+const pointerTargetExists = {
+    id: "pointer-target-exists",
+    description: "the current workstream pointer names an existing workstream directory",
+    requires: ["pointer", "workstreamDirs"],
+    evaluate(snapshot) {
+        const targetId = must(snapshot.pointer, "pointer");
+        const present = must(snapshot.workstreamDirs, "workstreamDirs").valid;
+        if (targetId === null || present.includes(targetId)) {
+            return pass();
+        }
+        return resolveOutcome([{
+                invariantId: "pointer-target-exists",
+                severity: "warning",
+                scope: { kind: "project" },
+                message: `workstreams/current.txt points to "${targetId}", which has no directory. Runtime will fall back to focus state or live-workstream discovery.`,
+            }]);
+    },
+};
+const projectListResolves = {
+    id: "project-list-resolves",
+    description: "every workstream listed in project state has a directory",
+    requires: ["project", "workstreamDirs"],
+    evaluate(snapshot) {
+        const present = must(snapshot.workstreamDirs, "workstreamDirs").valid;
+        return resolveOutcome(must(snapshot.project, "project").workstreams
+            .filter((id) => !present.includes(id))
+            .map((id) => ({
+            invariantId: "project-list-resolves",
+            severity: "error",
+            scope: { kind: "project" },
+            message: `project-state.json lists workstream "${id}", which has no directory under .iq-context/workstreams.`,
+        })));
+    },
+};
+const noDuplicateWorkstreams = {
+    id: "no-duplicate-workstreams",
+    description: "project state lists no duplicate workstream ids",
+    requires: ["project"],
+    evaluate(snapshot) {
+        const seen = new Set();
+        const duplicates = new Set();
+        for (const id of must(snapshot.project, "project").workstreams) {
+            if (seen.has(id)) {
+                duplicates.add(id);
+            }
+            seen.add(id);
+        }
+        return resolveOutcome([...duplicates].map((id) => ({
+            invariantId: "no-duplicate-workstreams",
+            severity: "error",
+            scope: { kind: "project" },
+            message: `project-state.json lists workstream "${id}" more than once.`,
+        })));
+    },
+};
+const workstreamDirListed = {
+    id: "workstream-dir-listed",
+    description: "every workstream directory is listed in project state",
+    requires: ["project", "workstreamDirs"],
+    evaluate(snapshot) {
+        const listed = new Set(must(snapshot.project, "project").workstreams);
+        return resolveOutcome(must(snapshot.workstreamDirs, "workstreamDirs").valid
+            .filter((id) => !listed.has(id))
+            .map((id) => ({
+            invariantId: "workstream-dir-listed",
+            severity: "warning",
+            scope: { kind: "workstream", workstreamId: id },
+            message: `Workstream directory "${id}" exists but is not listed in project-state.json.`,
+        })));
+    },
+};
+const workstreamIdMatchesDir = {
+    id: "workstream-id-matches-dir",
+    description: "each workstream state file matches its directory name",
+    requires: ["workstreamDirs"],
+    evaluate(snapshot) {
+        const violations = [];
+        const skippedScopes = [];
+        for (const workstream of snapshot.workstreams) {
+            if (!workstream.state.loaded) {
+                skippedScopes.push(workstream.id);
+                continue;
+            }
+            const persistedId = workstream.state.value.workstream_id;
+            if (persistedId !== workstream.id) {
+                violations.push({
+                    invariantId: "workstream-id-matches-dir",
+                    severity: "error",
+                    scope: { kind: "workstream", workstreamId: workstream.id },
+                    message: `Workstream directory "${workstream.id}" contains state.json with workstream_id "${persistedId}".`,
+                });
+            }
+        }
+        return resolveOutcome(violations, skippedScopes);
+    },
+};
+const configMatchesProject = {
+    id: "config-matches-project",
+    description: "config defaults and tracked artifacts match project state",
+    requires: ["config", "project"],
+    evaluate(snapshot) {
+        const config = must(snapshot.config, "config");
+        const project = must(snapshot.project, "project");
+        const violations = [];
+        const scalars = [
+            ["project_id", config.project_id, project.project_id],
+            ["project_name", config.project_name, project.project_name],
+            ["default_briefing_mode", config.default_briefing_mode, project.default_briefing_mode],
+        ];
+        for (const [field, configValue, projectValue] of scalars) {
+            if (configValue !== projectValue) {
+                violations.push({
+                    invariantId: "config-matches-project",
+                    severity: "error",
+                    scope: { kind: "config" },
+                    message: `${field} mismatch: config.yaml has "${configValue}", project-state.json has "${projectValue}".`,
+                });
+            }
+        }
+        // Ordered comparison: nothing in the codebase reorders these lists, and
+        // set-normalizing would hide duplicate entries.
+        if (JSON.stringify(config.tracked_artifacts) !== JSON.stringify(project.tracked_artifacts)) {
+            violations.push({
+                invariantId: "config-matches-project",
+                severity: "error",
+                scope: { kind: "config" },
+                message: "tracked_artifacts mismatch between config.yaml and project-state.json.",
+            });
+        }
+        return resolveOutcome(violations);
+    },
+};
+const configDefaultWorkstreamResolves = {
+    id: "config-default-workstream-resolves",
+    description: "the configured default workstream has a directory",
+    requires: ["config", "workstreamDirs"],
+    evaluate(snapshot) {
+        const defaultWorkstream = must(snapshot.config, "config").default_workstream;
+        const present = must(snapshot.workstreamDirs, "workstreamDirs").valid;
+        if (present.includes(defaultWorkstream)) {
+            return pass();
+        }
+        return resolveOutcome([{
+                invariantId: "config-default-workstream-resolves",
+                severity: "warning",
+                scope: { kind: "config" },
+                message: `config.yaml default_workstream is "${defaultWorkstream}", which has no directory under .iq-context/workstreams.`,
+            }]);
+    },
+};
+const workstreamCaptureScope = {
+    id: "workstream-capture-scope",
+    description: "workstream capture entries are scoped to their own workstream",
+    requires: ["workstreamDirs"],
+    evaluate(snapshot) {
+        const violations = [];
+        const skippedScopes = [];
+        for (const workstream of snapshot.workstreams) {
+            let unparseable = 0;
+            for (const capture of workstream.captures) {
+                if (!capture.loaded) {
+                    unparseable += 1;
+                    continue;
+                }
+                const entry = capture.value;
+                if (entry.scope !== "workstream" || entry.workstream_id !== workstream.id) {
+                    violations.push({
+                        invariantId: "workstream-capture-scope",
+                        severity: "warning",
+                        scope: { kind: "workstream", workstreamId: workstream.id },
+                        message: `Capture ${entry.id} in workstream "${workstream.id}" has scope "${entry.scope}" and workstream_id "${String(entry.workstream_id)}".`,
+                    });
+                }
+            }
+            if (unparseable > 0) {
+                skippedScopes.push(`${workstream.id} (${unparseable} unreadable capture line(s))`);
+            }
+        }
+        return resolveOutcome(violations, skippedScopes);
+    },
+};
+const projectCaptureScope = {
+    id: "project-capture-scope",
+    description: "project capture entries are project-scoped",
+    requires: [],
+    evaluate(snapshot) {
+        const violations = [];
+        let unparseable = 0;
+        for (const capture of snapshot.projectCaptures) {
+            if (!capture.loaded) {
+                unparseable += 1;
+                continue;
+            }
+            const entry = capture.value;
+            if (entry.scope !== "project" || entry.workstream_id !== null) {
+                violations.push({
+                    invariantId: "project-capture-scope",
+                    severity: "warning",
+                    scope: { kind: "project" },
+                    message: `Capture ${entry.id} in the project log has scope "${entry.scope}" and workstream_id "${String(entry.workstream_id)}".`,
+                });
+            }
+        }
+        return resolveOutcome(violations, unparseable > 0 ? [`project log (${unparseable} unreadable capture line(s))`] : []);
+    },
+};
+const completedAtMatchesLifecycle = {
+    id: "completed-at-matches-lifecycle",
+    description: "completed_at is set exactly when a workstream is completed",
+    requires: ["workstreamDirs"],
+    evaluate(snapshot) {
+        const violations = [];
+        const skippedScopes = [];
+        for (const workstream of snapshot.workstreams) {
+            if (!workstream.state.loaded) {
+                skippedScopes.push(workstream.id);
+                continue;
+            }
+            const state = workstream.state.value;
+            const isCompleted = state.lifecycle_status === "completed";
+            const hasTimestamp = state.completed_at !== null;
+            if (isCompleted !== hasTimestamp) {
+                violations.push({
+                    invariantId: "completed-at-matches-lifecycle",
+                    severity: "warning",
+                    scope: { kind: "workstream", workstreamId: workstream.id },
+                    message: isCompleted
+                        ? `Workstream "${workstream.id}" is completed but has no completed_at timestamp.`
+                        : `Workstream "${workstream.id}" has completed_at set but lifecycle_status is "${state.lifecycle_status}".`,
+                });
+            }
+        }
+        return resolveOutcome(violations, skippedScopes);
+    },
+};
+const completedWorkstreamNoRemainingWork = {
+    id: "completed-workstream-no-remaining-work",
+    description: "a completed workstream carries no unfinished work",
+    requires: ["workstreamDirs"],
+    evaluate(snapshot) {
+        const violations = [];
+        const skippedScopes = [];
+        for (const workstream of snapshot.workstreams) {
+            if (!workstream.state.loaded) {
+                // Lifecycle is unknown, so this workstream may or may not have needed
+                // checking. Record it rather than assume it was irrelevant.
+                skippedScopes.push(workstream.id);
+                continue;
+            }
+            if (workstream.state.value.lifecycle_status !== "completed") {
+                // Not completed: nothing to check, so an unreadable resume file here is
+                // not a skipped scope. Recording it would strand this invariant in
+                // permanent "partial" for any project with one corrupt workstream.
+                continue;
+            }
+            if (workstream.state.value.next_actions.length > 0) {
+                violations.push({
+                    invariantId: "completed-workstream-no-remaining-work",
+                    severity: "warning",
+                    scope: { kind: "workstream", workstreamId: workstream.id },
+                    message: `Completed workstream "${workstream.id}" still lists ${workstream.state.value.next_actions.length} next action(s).`,
+                });
+            }
+            if (!workstream.resume.loaded) {
+                skippedScopes.push(workstream.id);
+                continue;
+            }
+            if (workstream.resume.value.remaining_tasks.length > 0) {
+                violations.push({
+                    invariantId: "completed-workstream-no-remaining-work",
+                    severity: "warning",
+                    scope: { kind: "workstream", workstreamId: workstream.id },
+                    message: `Completed workstream "${workstream.id}" still lists remaining resume tasks: ${workstream.resume.value.remaining_tasks.join(", ")}.`,
+                });
+            }
+        }
+        return resolveOutcome(violations, skippedScopes);
+    },
+};
+const nextActionsMatchRemainingTasks = {
+    id: "next-actions-match-remaining-tasks",
+    description: "a live workstream's next actions and resume remaining tasks agree",
+    requires: ["workstreamDirs"],
+    evaluate(snapshot) {
+        const violations = [];
+        const skippedScopes = [];
+        for (const workstream of snapshot.workstreams) {
+            if (!workstream.state.loaded) {
+                skippedScopes.push(workstream.id);
+                continue;
+            }
+            const state = workstream.state.value;
+            if (state.lifecycle_status === "completed" || state.lifecycle_status === "abandoned") {
+                continue;
+            }
+            if (!workstream.resume.loaded) {
+                skippedScopes.push(workstream.id);
+                continue;
+            }
+            const nextActions = state.next_actions.map((value) => value.trim());
+            const remainingTasks = workstream.resume.value.remaining_tasks.map((value) => value.trim());
+            if (JSON.stringify(nextActions) === JSON.stringify(remainingTasks)) {
+                continue;
+            }
+            violations.push({
+                invariantId: "next-actions-match-remaining-tasks",
+                severity: "warning",
+                scope: { kind: "workstream", workstreamId: workstream.id },
+                message: buildNextActionsRepairMessage(workstream.id, nextActions, remainingTasks.length),
+            });
+        }
+        return resolveOutcome(violations, skippedScopes);
+    },
+};
+function buildNextActionsRepairMessage(workstreamId, nextActions, remainingTaskCount) {
+    const lines = [
+        `Workstream "${workstreamId}" records ${nextActions.length} remaining actions in one place and ${remainingTaskCount} in another.`,
+    ];
+    if (nextActions.length > 0) {
+        lines.push("Repair by restating them:", `  iq-context save --workstream ${workstreamId}${nextActions
+            .map((action) => ` --next "${quoteCommandValue(action)}"`)
+            .join("")}`, "Or clear both:");
+    }
+    lines.push(`  iq-context save --workstream ${workstreamId} --clear next`);
+    return lines.join("\n");
+}
+function quoteCommandValue(value) {
+    return value.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+export const INVARIANTS = [
+    focusTargetExists,
+    pointerTargetExists,
+    projectListResolves,
+    noDuplicateWorkstreams,
+    workstreamDirListed,
+    workstreamIdMatchesDir,
+    configMatchesProject,
+    configDefaultWorkstreamResolves,
+    workstreamCaptureScope,
+    projectCaptureScope,
+    completedAtMatchesLifecycle,
+    completedWorkstreamNoRemainingWork,
+    nextActionsMatchRemainingTasks,
+];
+export function evaluateInvariants(snapshot) {
+    return INVARIANTS.map((invariant) => {
+        const unmet = invariant.requires.filter((requirement) => !snapshot[requirement].loaded);
+        if (unmet.length > 0) {
+            return {
+                invariant,
+                outcome: skipped(`${unmet.map((requirement) => REQUIREMENT_LABELS[requirement]).join(" and ")} did not load`),
+            };
+        }
+        return { invariant, outcome: invariant.evaluate(snapshot) };
+    });
+}
+//# sourceMappingURL=invariants.js.map

package/dist/invariants.js.map

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

package/dist/listMutation.d.ts

@@ -0,0 +1,4 @@
+import type { ListDelta } from "./types.js";
+export declare function replaceList(previous: string[], incoming: string[], clearRequested: boolean, normalize?: (value: string) => string): ListDelta;
+export declare function appendList(previous: string[], incoming: string[], clearRequested: boolean): ListDelta;
+export declare function clearList(previous: string[], clearRequested: boolean): ListDelta;

package/dist/listMutation.js

@@ -0,0 +1,37 @@
+export function replaceList(previous, incoming, clearRequested, normalize = (value) => value.trim()) {
+    const provided = incoming.length > 0;
+    const current = clearRequested || provided
+        ? uniqueValues(incoming, normalize)
+        : previous;
+    return buildListDelta(previous, current, clearRequested, provided);
+}
+export function appendList(previous, incoming, clearRequested) {
+    const provided = incoming.length > 0;
+    const base = clearRequested ? [] : previous;
+    const current = provided ? uniqueValues([...base, ...incoming]) : base;
+    return buildListDelta(previous, current, clearRequested, provided);
+}
+export function clearList(previous, clearRequested) {
+    return buildListDelta(previous, clearRequested ? [] : previous, clearRequested, false);
+}
+function buildListDelta(previous, current, clearRequested, provided) {
+    const previousSet = new Set(previous);
+    const currentSet = new Set(current);
+    const added = current.filter((value) => !previousSet.has(value));
+    const removed = previous.filter((value) => !currentSet.has(value));
+    return {
+        previous,
+        current,
+        added,
+        removed,
+        reordered: added.length === 0
+            && removed.length === 0
+            && previous.some((value, index) => current[index] !== value),
+        clearRequested,
+        provided,
+    };
+}
+function uniqueValues(values, normalize = (value) => value.trim()) {
+    return Array.from(new Set(values.map(normalize).filter(Boolean)));
+}
+//# sourceMappingURL=listMutation.js.map

package/dist/listMutation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listMutation.js","sourceRoot":"","sources":["../src/listMutation.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,WAAW,CACzB,QAAkB,EAClB,QAAkB,EAClB,cAAuB,EACvB,YAAuC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE;IAE9D,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,cAAc,IAAI,QAAQ;QACxC,CAAC,CAAC,YAAY,CAAC,QAAQ,EAAE,SAAS,CAAC;QACnC,CAAC,CAAC,QAAQ,CAAC;IACb,OAAO,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,QAAkB,EAClB,QAAkB,EAClB,cAAuB;IAEvB,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC5C,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACvE,OAAO,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,QAAkB,EAAE,cAAuB;IACnE,OAAO,cAAc,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,CAAC,CAAC;AACzF,CAAC;AAED,SAAS,cAAc,CACrB,QAAkB,EAClB,OAAiB,EACjB,cAAuB,EACvB,QAAiB;IAEjB,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IACtC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IACjE,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IACnE,OAAO;QACL,QAAQ;QACR,OAAO;QACP,KAAK;QACL,OAAO;QACP,SAAS,EAAE,KAAK,CAAC,MAAM,KAAK,CAAC;eACxB,OAAO,CAAC,MAAM,KAAK,CAAC;eACpB,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC;QAC9D,cAAc;QACd,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CACnB,MAAgB,EAChB,YAAuC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE;IAE9D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACpE,CAAC"}

package/dist/obligations.d.ts

@@ -0,0 +1,3 @@
+import type { Obligation, OpenObligation } from "./types.js";
+export declare function parseObligationTable(markdown: string, sourcePath: string): Obligation[];
+export declare function loadOpenObligations(projectRoot: string): OpenObligation[];

package/dist/obligations.js

@@ -0,0 +1,84 @@
+import fs from "node:fs";
+import path from "node:path";
+const CLOSED_STATUSES = new Set(["met", "closed", "retired", "done"]);
+export function parseObligationTable(markdown, sourcePath) {
+    const lines = markdown.split(/\r?\n/);
+    const headingIndex = lines.findIndex((line) => /^##\s+obligations\s*#*\s*$/i.test(line.trim()));
+    if (headingIndex === -1) {
+        return [];
+    }
+    const sectionLines = [];
+    for (const line of lines.slice(headingIndex + 1)) {
+        if (/^#{1,2}\s+/.test(line.trim())) {
+            break;
+        }
+        sectionLines.push(line);
+    }
+    const obligations = [];
+    for (let index = 0; index < sectionLines.length - 1; index += 1) {
+        const headers = parseMarkdownRow(sectionLines[index]);
+        const separator = parseMarkdownRow(sectionLines[index + 1]);
+        if (!headers
+            || !separator
+            || separator.length !== headers.length
+            || !separator.every((cell) => /^:?-{3,}:?$/.test(cell))) {
+            continue;
+        }
+        const columnIndexes = new Map(headers.map((header, columnIndex) => [header.trim().toLowerCase(), columnIndex]));
+        if (!columnIndexes.has("obligation")) {
+            continue;
+        }
+        for (const line of sectionLines.slice(index + 2)) {
+            if (line.trim().length === 0) {
+                break;
+            }
+            const cells = parseMarkdownRow(line);
+            if (!cells) {
+                continue;
+            }
+            const obligationCell = getCell(cells, columnIndexes, "obligation");
+            const separatorIndex = obligationCell.indexOf(": ");
+            if (separatorIndex <= 0 || separatorIndex >= obligationCell.length - 2) {
+                continue;
+            }
+            const id = obligationCell.slice(0, separatorIndex).trim();
+            const description = obligationCell.slice(separatorIndex + 2).trim();
+            if (!id || !description) {
+                continue;
+            }
+            obligations.push({
+                id,
+                description,
+                kind: getCell(cells, columnIndexes, "kind"),
+                trigger: getCell(cells, columnIndexes, "trigger"),
+                origin: getCell(cells, columnIndexes, "origin"),
+                status: getCell(cells, columnIndexes, "status"),
+            });
+        }
+        break;
+    }
+    return obligations;
+}
+export function loadOpenObligations(projectRoot) {
+    const sourcePath = path.join(projectRoot, "docs", "north-star-board", "board-log.md");
+    if (!fs.existsSync(sourcePath)) {
+        return [];
+    }
+    return parseObligationTable(fs.readFileSync(sourcePath, "utf8"), sourcePath)
+        .filter((obligation) => !CLOSED_STATUSES.has(obligation.status.trim().toLowerCase()));
+}
+function parseMarkdownRow(line) {
+    const trimmed = line.trim();
+    if (!trimmed.startsWith("|")) {
+        return null;
+    }
+    const row = trimmed.endsWith("|") ? trimmed.slice(1, -1) : trimmed.slice(1);
+    return row
+        .split(/(?<!\\)\|/)
+        .map((cell) => cell.replace(/\\\|/g, "|").trim());
+}
+function getCell(cells, columnIndexes, columnName) {
+    const index = columnIndexes.get(columnName);
+    return index === undefined ? "" : (cells[index] ?? "").trim();
+}
+//# sourceMappingURL=obligations.js.map

package/dist/obligations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"obligations.js","sourceRoot":"","sources":["../src/obligations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;AAEtE,MAAM,UAAU,oBAAoB,CAAC,QAAgB,EAAE,UAAkB;IACvE,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,YAAY,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,6BAA6B,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAEhG,IAAI,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,EAAE,CAAC;QACjD,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YACnC,MAAM;QACR,CAAC;QACD,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,WAAW,GAAiB,EAAE,CAAC;IAErC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAChE,MAAM,OAAO,GAAG,gBAAgB,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;QACtD,MAAM,SAAS,GAAG,gBAAgB,CAAC,YAAY,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;QAE5D,IACE,CAAC,OAAO;eACL,CAAC,SAAS;eACV,SAAS,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM;eACnC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EACvD,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,GAAG,CAC3B,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,WAAW,CAAC,CAAC,CACjF,CAAC;QACF,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;YACrC,SAAS;QACX,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,YAAY,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;YACjD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC7B,MAAM;YACR,CAAC;YAED,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;YACrC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,SAAS;YACX,CAAC;YAED,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC;YACnE,MAAM,cAAc,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACpD,IAAI,cAAc,IAAI,CAAC,IAAI,cAAc,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvE,SAAS;YACX,CAAC;YAED,MAAM,EAAE,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,IAAI,EAAE,CAAC;YAC1D,MAAM,WAAW,GAAG,cAAc,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACpE,IAAI,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;gBACxB,SAAS;YACX,CAAC;YAED,WAAW,CAAC,IAAI,CAAC;gBACf,EAAE;gBACF,WAAW;gBACX,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,CAAC;gBAC3C,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,aAAa,EAAE,SAAS,CAAC;gBACjD,MAAM,EAAE,OAAO,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,CAAC;gBAC/C,MAAM,EAAE,OAAO,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,CAAC;aAChD,CAAC,CAAC;QACL,CAAC;QAED,MAAM;IACR,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACrD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,kBAAkB,EAAE,cAAc,CAAC,CAAC;IACtF,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,oBAAoB,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,UAAU,CAAC;SACzE,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;AAC1F,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY;IACpC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC5E,OAAO,GAAG;SACP,KAAK,CAAC,WAAW,CAAC;SAClB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,OAAO,CAAC,KAAe,EAAE,aAAkC,EAAE,UAAkB;IACtF,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC5C,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAChE,CAAC"}

package/dist/persistence.js

@@ -1,3 +1,4 @@
+import { randomUUID } from "node:crypto";
 import fs from "node:fs";
 import path from "node:path";
 export class WriteConflictError extends Error {
@@ -15,14 +16,16 @@ export function writeTextFileAtomic(filePath, content) {
     }
     const directory = path.dirname(filePath);
     fs.mkdirSync(directory, { recursive: true });
-    const tempDirectory = fs.mkdtempSync(path.join(directory, `.${path.basename(filePath)}-${process.pid}-`));
-    const tempPath = path.join(tempDirectory, "write.tmp");
+    // Scratch state stays a sibling file, never a directory: some state files
+    // live in directories that are scanned, and an interrupted write must not
+    // leave behind an entry that reads as a malformed member of that directory.
+    const tempPath = path.join(directory, `.${path.basename(filePath)}-${process.pid}-${randomUUID()}.tmp`);
     try {
-        fs.writeFileSync(tempPath, content, "utf8");
+        fs.writeFileSync(tempPath, content, { encoding: "utf8", flag: "wx" });
         fs.renameSync(tempPath, filePath);
     }
     finally {
-        fs.rmSync(tempDirectory, { recursive: true, force: true });
+        fs.rmSync(tempPath, { force: true });
     }
 }
 export function isWriteConflictError(error) {

package/dist/persistence.js.map

@@ -1 +1 @@
-{"version":3,"file":"persistence.js","sourceRoot":"","sources":["../src/persistence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,UAAU,mBAAmB,CAAC,QAAgB,EAAE,KAAc;IAClE,mBAAmB,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,QAAgB,EAAE,OAAe;IACnE,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;QAC/D,MAAM,IAAI,kBAAkB,CAAC,sDAAsD,QAAQ,EAAE,CAAC,CAAC;IACjG,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzC,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE7C,MAAM,aAAa,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IAC1G,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IAEvD,IAAI,CAAC;QACH,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAC5C,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,KAAK,YAAY,kBAAkB;WACrC,CAAC,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,oBAAoB,CAAC,CAAC;AACvE,CAAC"}
+{"version":3,"file":"persistence.js","sourceRoot":"","sources":["../src/persistence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,UAAU,mBAAmB,CAAC,QAAgB,EAAE,KAAc;IAClE,mBAAmB,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,QAAgB,EAAE,OAAe;IACnE,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;QAC/D,MAAM,IAAI,kBAAkB,CAAC,sDAAsD,QAAQ,EAAE,CAAC,CAAC;IACjG,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzC,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE7C,0EAA0E;IAC1E,0EAA0E;IAC1E,4EAA4E;IAC5E,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CACxB,SAAS,EACT,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,GAAG,IAAI,UAAU,EAAE,MAAM,CACjE,CAAC;IAEF,IAAI,CAAC;QACH,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACtE,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,KAAK,YAAY,kBAAkB;WACrC,CAAC,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,oBAAoB,CAAC,CAAC;AACvE,CAAC"}