@iq-context/core 0.1.0 → 0.3.0

package/dist/save.js

@@ -1,61 +1,61 @@
 import { loadResumeState, loadWorkstreamState, resolveProjectRoot, resolveTargetWorkstream, updateFocusAfterSave, writeResumeState, writeWorkstreamState, } from "./state.js";
+import { detectGitBranch } from "./git.js";
+import { deriveHeadlines } from "./headline.js";
+import { appendList, replaceList } from "./listMutation.js";
+import { normalizeTrackedPath } from "./trackedPath.js";
 export function saveProgress(options) {
     const projectRoot = resolveProjectRoot(options.startDir, options.projectRoot);
     const workstreamId = resolveTargetWorkstream(projectRoot, options.workstreamId);
     const currentWorkstreamState = loadWorkstreamState(projectRoot, workstreamId);
     const currentResumeState = loadResumeState(projectRoot, workstreamId);
     const timestamp = new Date().toISOString();
+    const clearFields = new Set(options.clearFields);
+    const delta = {
+        files: replaceList(currentWorkstreamState.active_files, options.files, clearFields.has("files"), (value) => normalizeTrackedPath(projectRoot, value)),
+        artifacts: replaceList(currentWorkstreamState.active_artifacts, options.artifacts, clearFields.has("artifacts"), (value) => normalizeTrackedPath(projectRoot, value)),
+        blockers: appendList(currentWorkstreamState.blockers, options.blockers, clearFields.has("blockers")),
+        questions: appendList(currentWorkstreamState.open_questions, options.questions, clearFields.has("questions")),
+        next: appendList(currentWorkstreamState.next_actions, options.nextActions, clearFields.has("next")),
+    };
+    const headlines = deriveHeadlines({
+        complete: false,
+        nextActions: delta.next.current,
+        summary: options.summary,
+        previousContinuationHint: currentWorkstreamState.continuation_hint,
+        previousResumeFrom: currentResumeState.resume_from,
+        preservePrevious: !clearFields.has("next"),
+    });
     const nextWorkstreamState = {
         ...currentWorkstreamState,
         mode: options.mode ?? currentWorkstreamState.mode,
         status_summary: options.summary ?? currentWorkstreamState.status_summary,
-        active_files: options.files.length > 0 ? uniqueValues(options.files) : currentWorkstreamState.active_files,
-        active_artifacts: options.artifacts.length > 0
-            ? uniqueValues(options.artifacts)
-            : currentWorkstreamState.active_artifacts,
-        blockers: options.blockers.length > 0 ? uniqueValues(options.blockers) : currentWorkstreamState.blockers,
-        open_questions: options.questions.length > 0 ? uniqueValues(options.questions) : currentWorkstreamState.open_questions,
-        next_actions: options.nextActions.length > 0 ? uniqueValues(options.nextActions) : currentWorkstreamState.next_actions,
-        continuation_hint: buildContinuationHint(options, currentWorkstreamState),
+        active_files: delta.files.current,
+        active_artifacts: delta.artifacts.current,
+        blockers: delta.blockers.current,
+        open_questions: delta.questions.current,
+        next_actions: delta.next.current,
+        continuation_hint: headlines.continuationHint,
+        branch: detectGitBranch(projectRoot) ?? currentWorkstreamState.branch,
         last_saved_at: timestamp,
         updated_at: timestamp,
     };
     const nextResumeState = {
         ...currentResumeState,
-        remaining_tasks: options.nextActions.length > 0
-            ? uniqueValues(options.nextActions)
-            : currentResumeState.remaining_tasks,
-        resume_from: buildResumeFrom(options, nextWorkstreamState, currentResumeState),
+        remaining_tasks: nextWorkstreamState.next_actions,
+        resume_from: headlines.resumeFrom,
         updated_at: timestamp,
     };
-    writeWorkstreamState(projectRoot, nextWorkstreamState);
+    // Resume state first: if the process dies between these writes, the surviving
+    // divergence is a populated remaining_tasks beside stale next_actions, which
+    // re-running the same command repairs. The reverse order strands the opposite.
     writeResumeState(projectRoot, workstreamId, nextResumeState);
+    writeWorkstreamState(projectRoot, nextWorkstreamState);
     updateFocusAfterSave(projectRoot, nextWorkstreamState, nextResumeState);
     return {
         projectRoot,
         workstreamState: nextWorkstreamState,
         resumeState: nextResumeState,
+        delta,
     };
 }
-function buildContinuationHint(options, currentWorkstreamState) {
-    if (options.nextActions.length > 0) {
-        return `Next: ${options.nextActions[0]}`;
-    }
-    if (options.summary) {
-        return options.summary;
-    }
-    return currentWorkstreamState.continuation_hint;
-}
-function buildResumeFrom(options, workstreamState, currentResumeState) {
-    if (options.nextActions.length > 0) {
-        return `Resume with: ${options.nextActions[0]}`;
-    }
-    if (options.summary) {
-        return options.summary;
-    }
-    return currentResumeState.resume_from || workstreamState.continuation_hint;
-}
-function uniqueValues(values) {
-    return Array.from(new Set(values.map((value) => value.trim()).filter(Boolean)));
-}
 //# sourceMappingURL=save.js.map

package/dist/save.js.map

@@ -1 +1 @@
-{"version":3,"file":"save.js","sourceRoot":"","sources":["../src/save.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAGpB,MAAM,UAAU,YAAY,CAAC,OAAoB;IAC/C,MAAM,WAAW,GAAG,kBAAkB,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9E,MAAM,YAAY,GAAG,uBAAuB,CAAC,WAAW,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAChF,MAAM,sBAAsB,GAAG,mBAAmB,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAC9E,MAAM,kBAAkB,GAAG,eAAe,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IACtE,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE3C,MAAM,mBAAmB,GAAoB;QAC3C,GAAG,sBAAsB;QACzB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,sBAAsB,CAAC,IAAI;QACjD,cAAc,EAAE,OAAO,CAAC,OAAO,IAAI,sBAAsB,CAAC,cAAc;QACxE,YAAY,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,YAAY;QAC1G,gBAAgB,EAAE,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;YAC5C,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC;YACjC,CAAC,CAAC,sBAAsB,CAAC,gBAAgB;QAC3C,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,QAAQ;QACxG,cAAc,EAAE,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,cAAc;QACtH,YAAY,EAAE,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,YAAY;QACtH,iBAAiB,EAAE,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,CAAC;QACzE,aAAa,EAAE,SAAS;QACxB,UAAU,EAAE,SAAS;KACtB,CAAC;IAEF,MAAM,eAAe,GAAgB;QACnC,GAAG,kBAAkB;QACrB,eAAe,EAAE,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;YAC7C,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC;YACnC,CAAC,CAAC,kBAAkB,CAAC,eAAe;QACtC,WAAW,EAAE,eAAe,CAAC,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,CAAC;QAC9E,UAAU,EAAE,SAAS;KACtB,CAAC;IAEF,oBAAoB,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC;IACvD,gBAAgB,CAAC,WAAW,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC;IAC7D,oBAAoB,CAAC,WAAW,EAAE,mBAAmB,EAAE,eAAe,CAAC,CAAC;IAExE,OAAO;QACL,WAAW;QACX,eAAe,EAAE,mBAAmB;QACpC,WAAW,EAAE,eAAe;KAC7B,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAoB,EAAE,sBAAuC;IAC1F,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,OAAO,SAAS,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3C,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,OAAO,CAAC,OAAO,CAAC;IACzB,CAAC;IAED,OAAO,sBAAsB,CAAC,iBAAiB,CAAC;AAClD,CAAC;AAED,SAAS,eAAe,CACtB,OAAoB,EACpB,eAAgC,EAChC,kBAA+B;IAE/B,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,OAAO,gBAAgB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IAClD,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,OAAO,CAAC,OAAO,CAAC;IACzB,CAAC;IAED,OAAO,kBAAkB,CAAC,WAAW,IAAI,eAAe,CAAC,iBAAiB,CAAC;AAC7E,CAAC;AAED,SAAS,YAAY,CAAC,MAAgB;IACpC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClF,CAAC"}
+{"version":3,"file":"save.js","sourceRoot":"","sources":["../src/save.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGxD,MAAM,UAAU,YAAY,CAAC,OAAoB;IAC/C,MAAM,WAAW,GAAG,kBAAkB,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9E,MAAM,YAAY,GAAG,uBAAuB,CAAC,WAAW,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAChF,MAAM,sBAAsB,GAAG,mBAAmB,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAC9E,MAAM,kBAAkB,GAAG,eAAe,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IACtE,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACjD,MAAM,KAAK,GAAe;QACxB,KAAK,EAAE,WAAW,CAChB,sBAAsB,CAAC,YAAY,EACnC,OAAO,CAAC,KAAK,EACb,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,EACxB,CAAC,KAAK,EAAE,EAAE,CAAC,oBAAoB,CAAC,WAAW,EAAE,KAAK,CAAC,CACpD;QACD,SAAS,EAAE,WAAW,CACpB,sBAAsB,CAAC,gBAAgB,EACvC,OAAO,CAAC,SAAS,EACjB,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,EAC5B,CAAC,KAAK,EAAE,EAAE,CAAC,oBAAoB,CAAC,WAAW,EAAE,KAAK,CAAC,CACpD;QACD,QAAQ,EAAE,UAAU,CAClB,sBAAsB,CAAC,QAAQ,EAC/B,OAAO,CAAC,QAAQ,EAChB,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAC5B;QACD,SAAS,EAAE,UAAU,CACnB,sBAAsB,CAAC,cAAc,EACrC,OAAO,CAAC,SAAS,EACjB,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,CAC7B;QACD,IAAI,EAAE,UAAU,CACd,sBAAsB,CAAC,YAAY,EACnC,OAAO,CAAC,WAAW,EACnB,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CACxB;KACF,CAAC;IACF,MAAM,SAAS,GAAG,eAAe,CAAC;QAChC,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO;QAC/B,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,wBAAwB,EAAE,sBAAsB,CAAC,iBAAiB;QAClE,kBAAkB,EAAE,kBAAkB,CAAC,WAAW;QAClD,gBAAgB,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC;KAC3C,CAAC,CAAC;IAEH,MAAM,mBAAmB,GAAoB;QAC3C,GAAG,sBAAsB;QACzB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,sBAAsB,CAAC,IAAI;QACjD,cAAc,EAAE,OAAO,CAAC,OAAO,IAAI,sBAAsB,CAAC,cAAc;QACxE,YAAY,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO;QACjC,gBAAgB,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO;QACzC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,OAAO;QAChC,cAAc,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO;QACvC,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO;QAChC,iBAAiB,EAAE,SAAS,CAAC,gBAAgB;QAC7C,MAAM,EAAE,eAAe,CAAC,WAAW,CAAC,IAAI,sBAAsB,CAAC,MAAM;QACrE,aAAa,EAAE,SAAS;QACxB,UAAU,EAAE,SAAS;KACtB,CAAC;IAEF,MAAM,eAAe,GAAgB;QACnC,GAAG,kBAAkB;QACrB,eAAe,EAAE,mBAAmB,CAAC,YAAY;QACjD,WAAW,EAAE,SAAS,CAAC,UAAU;QACjC,UAAU,EAAE,SAAS;KACtB,CAAC;IAEF,8EAA8E;IAC9E,6EAA6E;IAC7E,+EAA+E;IAC/E,gBAAgB,CAAC,WAAW,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC;IAC7D,oBAAoB,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC;IACvD,oBAAoB,CAAC,WAAW,EAAE,mBAAmB,EAAE,eAAe,CAAC,CAAC;IAExE,OAAO;QACL,WAAW;QACX,eAAe,EAAE,mBAAmB;QACpC,WAAW,EAAE,eAAe;QAC5B,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/staleness.d.ts

@@ -1,9 +1,9 @@
 import type { ResolvedTrackedArtifact } from "./trackedArtifacts.js";
-import type { FocusState, ProjectState, ResumeState, StalenessReport, WorkstreamState } from "./types.js";
+import type { FocusState, ProjectState, StalenessReport, WorkstreamState } from "./types.js";
 export interface RefreshStalenessResult {
     projectState: ProjectState;
     focusState: FocusState;
     staleness: StalenessReport;
 }
 export declare function refreshStaleness(projectRoot: string, workstreamId: string, configuredArtifacts?: ResolvedTrackedArtifact[]): RefreshStalenessResult;
-export declare function evaluateStaleness(projectRoot: string, workstreamState: WorkstreamState, resumeState: ResumeState, configuredArtifacts?: ResolvedTrackedArtifact[]): StalenessReport;
+export declare function evaluateStaleness(projectRoot: string, workstreamState: WorkstreamState, configuredArtifacts?: ResolvedTrackedArtifact[]): StalenessReport;

package/dist/staleness.js

@@ -1,9 +1,9 @@
 import fs from "node:fs";
-import path from "node:path";
-import { execFileSync } from "node:child_process";
+import { detectGitBranch } from "./git.js";
 import { loadFocusState, loadProjectState, loadResumeState, loadWorkstreamState, writeFocusState, } from "./state.js";
 import { loadProjectConfig } from "./config.js";
 import { resolveTrackedArtifacts } from "./trackedArtifacts.js";
+import { isTrackedPathOutsideProject, resolveTrackedPath } from "./trackedPath.js";
 const CHANGE_GRACE_MS = 1000;
 const NON_STALE_LIFECYCLE_STATUSES = new Set(["completed", "abandoned"]);
 export function refreshStaleness(projectRoot, workstreamId, configuredArtifacts) {
@@ -11,7 +11,7 @@ export function refreshStaleness(projectRoot, workstreamId, configuredArtifacts)
     const focusState = loadFocusState(projectRoot);
     const workstreamState = loadWorkstreamState(projectRoot, workstreamId);
     const resumeState = loadResumeState(projectRoot, workstreamId);
-    const staleness = evaluateStaleness(projectRoot, workstreamState, resumeState, configuredArtifacts);
+    const staleness = evaluateStaleness(projectRoot, workstreamState, configuredArtifacts);
     const timestamp = new Date().toISOString();
     const nextFocusState = {
         ...focusState,
@@ -30,7 +30,7 @@ export function refreshStaleness(projectRoot, workstreamId, configuredArtifacts)
         staleness,
     };
 }
-export function evaluateStaleness(projectRoot, workstreamState, resumeState, configuredArtifacts) {
+export function evaluateStaleness(projectRoot, workstreamState, configuredArtifacts) {
     if (NON_STALE_LIFECYCLE_STATUSES.has(workstreamState.lifecycle_status)) {
         return {
             level: "fresh",
@@ -43,20 +43,18 @@ export function evaluateStaleness(projectRoot, workstreamState, resumeState, con
     const changedWarnings = findChangedTrackedPaths(projectRoot, workstreamState);
     const trackedArtifactWarnings = findChangedConfiguredArtifacts(projectRoot, workstreamState, new Set(changedWarnings.flatMap((warning) => warning.path ? [warning.path] : [])), configuredArtifacts);
     const mismatchWarnings = findMismatchWarnings(projectRoot, workstreamState);
-    const resumeWarnings = findStaleResumeWarnings(workstreamState, resumeState);
     const warningDetails = [
         ...missingWarnings,
         ...changedWarnings,
         ...trackedArtifactWarnings,
         ...mismatchWarnings,
-        ...resumeWarnings,
     ];
     const warnings = warningDetails
         .filter((warning) => warning.reason !== "mismatch")
         .map((warning) => warning.message);
     const mismatchFlags = mismatchWarnings.map((warning) => warning.message);
     return {
-        level: missingWarnings.length > 0 || mismatchWarnings.length > 0 || resumeWarnings.length > 0
+        level: missingWarnings.length > 0 || mismatchWarnings.length > 0
             ? "stale"
             : changedWarnings.length > 0 || trackedArtifactWarnings.length > 0
                 ? "warning"
@@ -105,75 +103,16 @@ function findChangedConfiguredArtifacts(projectRoot, workstreamState, workstream
         }
     });
 }
-function findStaleResumeWarnings(workstreamState, resumeState) {
-    const warnings = [];
-    const completedTasks = new Set(resumeState.completed_tasks.map(normalizeComparableText));
-    const completedWaves = new Set(resumeState.completed_waves.map(normalizeComparableText));
-    for (const remainingTask of resumeState.remaining_tasks) {
-        if (completedTasks.has(normalizeComparableText(remainingTask))) {
-            warnings.push({
-                message: `Resume state still lists a completed task as remaining: ${remainingTask}`,
-                scope: "workstream",
-                sourceKind: "resume_state",
-                reason: "superseded",
-            });
-        }
-    }
-    if (resumeState.next_wave && completedWaves.has(normalizeComparableText(resumeState.next_wave))) {
-        warnings.push({
-            message: `Resume state still points at a completed wave: ${resumeState.next_wave}`,
-            scope: "workstream",
-            sourceKind: "resume_state",
-            reason: "superseded",
-        });
-    }
-    const completedTaskInResumeText = resumeState.completed_tasks.find((task) => {
-        const normalizedTask = normalizeComparableText(task);
-        return normalizedTask.length > 0 && normalizeComparableText(resumeState.resume_from).includes(normalizedTask);
-    });
-    if (completedTaskInResumeText) {
-        warnings.push({
-            message: `Continuation text still points at a completed task: ${completedTaskInResumeText}`,
-            scope: "workstream",
-            sourceKind: "continuation",
-            reason: "superseded",
-        });
-    }
-    const completedTaskInWorkstreamHint = resumeState.completed_tasks.find((task) => {
-        const normalizedTask = normalizeComparableText(task);
-        return normalizedTask.length > 0 && normalizeComparableText(workstreamState.continuation_hint).includes(normalizedTask);
-    });
-    // Avoid duplicate continuation warnings when resume_from and continuation_hint mirror the same stale task.
-    if (completedTaskInWorkstreamHint && completedTaskInWorkstreamHint !== completedTaskInResumeText) {
-        warnings.push({
-            message: `Workstream continuation still points at a completed task: ${completedTaskInWorkstreamHint}`,
-            scope: "workstream",
-            sourceKind: "continuation",
-            reason: "superseded",
-        });
-    }
-    return dedupeWarnings(warnings);
-}
-function normalizeComparableText(value) {
-    return value.trim().toLowerCase().replace(/\s+/g, " ");
-}
-function dedupeWarnings(warnings) {
-    const seen = new Set();
-    return warnings.filter((warning) => {
-        const key = `${warning.scope}:${warning.sourceKind}:${warning.reason}:${warning.message}`;
-        if (seen.has(key)) {
-            return false;
-        }
-        seen.add(key);
-        return true;
-    });
-}
 function findMissingTrackedPaths(projectRoot, workstreamState) {
     const warnings = [];
     for (const reference of trackedPathReferences(workstreamState)) {
-        if (!fs.existsSync(path.join(projectRoot, reference.filePath))) {
+        const absolutePath = resolveTrackedPath(projectRoot, reference.filePath);
+        if (!fs.existsSync(absolutePath)) {
+            const outsideProject = isTrackedPathOutsideProject(projectRoot, reference.filePath);
             warnings.push({
-                message: `${reference.label} is missing: ${reference.filePath}`,
+                message: outsideProject
+                    ? `Tracked outside the project root; not found on this host: ${reference.filePath}`
+                    : `${reference.label} is missing: ${reference.filePath}`,
                 scope: "workstream",
                 sourceKind: reference.sourceKind,
                 reason: "missing",
@@ -190,7 +129,7 @@ function findChangedTrackedPaths(projectRoot, workstreamState) {
     }
     const warnings = [];
     for (const reference of trackedPathReferences(workstreamState)) {
-        const absolutePath = path.join(projectRoot, reference.filePath);
+        const absolutePath = resolveTrackedPath(projectRoot, reference.filePath);
         if (!fs.existsSync(absolutePath)) {
             continue;
         }
@@ -221,9 +160,6 @@ function findMismatchWarnings(projectRoot, workstreamState) {
 }
 function trackedPathReferences(workstreamState) {
     const references = [];
-    if (workstreamState.active_plan) {
-        references.push({ label: "Active plan", sourceKind: "active_plan", filePath: workstreamState.active_plan });
-    }
     for (const filePath of workstreamState.active_files) {
         references.push({ label: "Active file", sourceKind: "active_file", filePath });
     }
@@ -256,17 +192,4 @@ function uniqueReferences(references) {
         return true;
     });
 }
-function detectGitBranch(projectRoot) {
-    try {
-        const branch = execFileSync("git", ["branch", "--show-current"], {
-            cwd: projectRoot,
-            encoding: "utf8",
-            stdio: ["ignore", "pipe", "ignore"],
-        }).trim();
-        return branch.length > 0 ? branch : null;
-    }
-    catch {
-        return null;
-    }
-}
 //# sourceMappingURL=staleness.js.map

package/dist/staleness.js.map

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

package/dist/state.d.ts

@@ -1,4 +1,7 @@
 import type { FocusState, ProjectPaths, ProjectState, ResumeState, WorkstreamState } from "./types.js";
+interface ResolveTargetWorkstreamOptions {
+    allowClosedFocusFallback?: boolean;
+}
 export declare function resolveProjectRoot(startDir: string, explicitProjectRoot?: string): string;
 export declare function getProjectPaths(projectRoot: string): ProjectPaths;
 export declare function loadProjectState(projectRoot: string): ProjectState;
@@ -11,8 +14,10 @@ export declare function writeFocusState(projectRoot: string, focusState: FocusSt
 export declare function writeWorkstreamState(projectRoot: string, workstreamState: WorkstreamState): void;
 export declare function writeResumeState(projectRoot: string, workstreamId: string, resumeState: ResumeState): void;
 export declare function writeCurrentWorkstreamPointer(projectRoot: string, workstreamId: string): void;
-export declare function resolveTargetWorkstream(projectRoot: string, explicitWorkstreamId?: string): string;
+export declare function resolveTargetWorkstream(projectRoot: string, explicitWorkstreamId?: string, options?: ResolveTargetWorkstreamOptions): string;
 export declare function updateFocusAfterGo(projectRoot: string, workstreamState: WorkstreamState, resumeState: ResumeState): void;
 export declare function updateFocusAfterSave(projectRoot: string, workstreamState: WorkstreamState, resumeState: ResumeState): void;
 export declare function updateFocusAfterWrap(projectRoot: string, workstreamState: WorkstreamState, resumeState: ResumeState): void;
 export declare function switchFocusToWorkstream(projectRoot: string, workstreamState: WorkstreamState, resumeState: ResumeState): void;
+export declare function loadCurrentWorkstreamPointer(pointerPath: string): string | null;
+export {};

package/dist/state.js

@@ -2,7 +2,10 @@ import fs from "node:fs";
 import path from "node:path";
 import { discoverProjectRoot } from "./discovery.js";
 import { writeJsonFileAtomic, writeTextFileAtomic } from "./persistence.js";
+import { parseFocusState, parseProjectState, parseResumeState, parseWorkstreamState, } from "./stateSchemas.js";
+import { resolveWorkstreamPath, validateWorkstreamId } from "./workstreamId.js";
 const LIVE_WORKSTREAM_STATUSES = new Set(["active", "paused", "blocked"]);
+const CLOSED_WORKSTREAM_STATUSES = new Set(["completed", "abandoned"]);
 export function resolveProjectRoot(startDir, explicitProjectRoot) {
     const projectRoot = explicitProjectRoot
         ? path.resolve(explicitProjectRoot)
@@ -28,15 +31,23 @@ export function getProjectPaths(projectRoot) {
 }
 export function loadProjectState(projectRoot) {
     const paths = getProjectPaths(projectRoot);
-    return readJsonFile(paths.projectStatePath);
+    const projectState = parseProjectState(readJsonFile(paths.projectStatePath), paths.projectStatePath);
+    projectState.workstreams.forEach((workstreamId) => {
+        validateWorkstreamId(workstreamId, `persisted workstream id in ${paths.projectStatePath}`);
+    });
+    return projectState;
 }
 export function writeProjectState(projectRoot, projectState) {
     const paths = getProjectPaths(projectRoot);
-    writeJsonFile(paths.projectStatePath, projectState);
+    const validatedState = parseProjectState(projectState, paths.projectStatePath);
+    validatedState.workstreams.forEach((workstreamId) => validateWorkstreamId(workstreamId));
+    writeJsonFile(paths.projectStatePath, validatedState);
 }
 export function loadFocusState(projectRoot) {
     const paths = getProjectPaths(projectRoot);
-    return readJsonFile(paths.focusStatePath);
+    const focusState = parseFocusState(readJsonFile(paths.focusStatePath), paths.focusStatePath);
+    validateWorkstreamId(focusState.current_workstream_id, `current_workstream_id in ${paths.focusStatePath}`);
+    return focusState;
 }
 export function listWorkstreamIds(projectRoot) {
     const paths = getProjectPaths(projectRoot);
@@ -45,40 +56,52 @@ export function listWorkstreamIds(projectRoot) {
     }
     return fs.readdirSync(paths.workstreamsDir, { withFileTypes: true })
         .filter((entry) => entry.isDirectory())
-        .map((entry) => entry.name)
+        .map((entry) => validateWorkstreamId(entry.name, "persisted workstream directory name"))
         .sort();
 }
 export function loadWorkstreamState(projectRoot, workstreamId) {
-    return readJsonFile(path.join(projectRoot, ".iq-context", "workstreams", workstreamId, "state.json"));
+    const statePath = resolveWorkstreamPath(projectRoot, workstreamId, "state.json");
+    const workstreamState = parseWorkstreamState(readJsonFile(statePath), statePath);
+    const persistedId = validateWorkstreamId(workstreamState.workstream_id, `workstream_id in ${statePath}`);
+    if (persistedId !== workstreamId) {
+        throw new Error(`Workstream ID mismatch in ${statePath}: expected ${workstreamId}, found ${persistedId}.`);
+    }
+    return workstreamState;
 }
 export function loadResumeState(projectRoot, workstreamId) {
-    return readJsonFile(path.join(projectRoot, ".iq-context", "workstreams", workstreamId, "resume-state.json"));
+    const statePath = resolveWorkstreamPath(projectRoot, workstreamId, "resume-state.json");
+    return parseResumeState(readJsonFile(statePath), statePath);
 }
 export function writeFocusState(projectRoot, focusState) {
     const paths = getProjectPaths(projectRoot);
-    writeJsonFile(paths.focusStatePath, focusState);
+    const validatedState = parseFocusState(focusState, paths.focusStatePath);
+    validateWorkstreamId(validatedState.current_workstream_id);
+    writeJsonFile(paths.focusStatePath, validatedState);
 }
 export function writeWorkstreamState(projectRoot, workstreamState) {
-    writeJsonFile(path.join(projectRoot, ".iq-context", "workstreams", workstreamState.workstream_id, "state.json"), workstreamState);
+    const statePath = resolveWorkstreamPath(projectRoot, workstreamState.workstream_id, "state.json");
+    writeJsonFile(statePath, parseWorkstreamState(workstreamState, statePath));
 }
 export function writeResumeState(projectRoot, workstreamId, resumeState) {
-    writeJsonFile(path.join(projectRoot, ".iq-context", "workstreams", workstreamId, "resume-state.json"), resumeState);
+    const statePath = resolveWorkstreamPath(projectRoot, workstreamId, "resume-state.json");
+    writeJsonFile(statePath, parseResumeState(resumeState, statePath));
 }
 export function writeCurrentWorkstreamPointer(projectRoot, workstreamId) {
     const paths = getProjectPaths(projectRoot);
-    writeTextFileAtomic(paths.currentWorkstreamPath, `${workstreamId}\n`);
+    writeTextFileAtomic(paths.currentWorkstreamPath, `${validateWorkstreamId(workstreamId)}\n`);
 }
-export function resolveTargetWorkstream(projectRoot, explicitWorkstreamId) {
+export function resolveTargetWorkstream(projectRoot, explicitWorkstreamId, options = {}) {
     const paths = getProjectPaths(projectRoot);
     if (explicitWorkstreamId) {
-        ensureWorkstreamExists(projectRoot, explicitWorkstreamId);
-        return explicitWorkstreamId;
+        const validatedId = validateWorkstreamId(explicitWorkstreamId, "--workstream value");
+        ensureWorkstreamExists(projectRoot, validatedId);
+        return validatedId;
     }
     const focusState = loadFocusState(projectRoot);
     if (focusState.current_workstream_id && isLiveWorkstream(projectRoot, focusState.current_workstream_id)) {
         return focusState.current_workstream_id;
     }
-    const currentPointer = readCurrentWorkstreamPointer(paths.currentWorkstreamPath);
+    const currentPointer = loadCurrentWorkstreamPointer(paths.currentWorkstreamPath);
     if (currentPointer && isLiveWorkstream(projectRoot, currentPointer)) {
         return currentPointer;
     }
@@ -90,6 +113,14 @@ export function resolveTargetWorkstream(projectRoot, explicitWorkstreamId) {
     if (liveWorkstreams.length > 1) {
         throw new Error(`Multiple live workstreams found (${liveWorkstreams.join(", ")}). Re-run with --workstream <id>.`);
     }
+    if (options.allowClosedFocusFallback) {
+        if (isClosedWorkstream(projectRoot, focusState.current_workstream_id)) {
+            return focusState.current_workstream_id;
+        }
+        if (currentPointer && isClosedWorkstream(projectRoot, currentPointer)) {
+            return currentPointer;
+        }
+    }
     const workstreamIds = listWorkstreamIds(projectRoot);
     if (workstreamIds.length > 0) {
         throw new Error("No live workstreams found. Reopen an existing workstream with iq-context workstream reopen <id> or create one with iq-context workstream new <id>.");
@@ -120,7 +151,7 @@ export function switchFocusToWorkstream(projectRoot, workstreamState, resumeStat
     writeFocusState(projectRoot, {
         ...focusState,
         current_workstream_id: workstreamState.workstream_id,
-        current_environment_id: workstreamState.environment_id ?? focusState.current_environment_id,
+        current_environment_id: focusState.current_environment_id,
         current_branch: workstreamState.branch ?? focusState.current_branch,
         resume_from: resumeState.resume_from || workstreamState.continuation_hint || focusState.resume_from,
         last_command: "workstream switch",
@@ -132,7 +163,7 @@ function buildNextFocusState(focusState, workstreamState, resumeState, lastComma
     return {
         ...focusState,
         current_workstream_id: workstreamState.workstream_id,
-        current_environment_id: workstreamState.environment_id ?? focusState.current_environment_id,
+        current_environment_id: focusState.current_environment_id,
         current_branch: workstreamState.branch ?? focusState.current_branch,
         resume_from: resumeState.resume_from || workstreamState.continuation_hint || focusState.resume_from,
         last_command: lastCommand,
@@ -143,26 +174,35 @@ function buildNextFocusState(focusState, workstreamState, resumeState, lastComma
     };
 }
 function ensureWorkstreamExists(projectRoot, workstreamId) {
-    const statePath = path.join(projectRoot, ".iq-context", "workstreams", workstreamId, "state.json");
+    const statePath = resolveWorkstreamPath(projectRoot, workstreamId, "state.json");
     if (!fs.existsSync(statePath)) {
         throw new Error(`Unknown workstream: ${workstreamId}`);
     }
 }
 function isLiveWorkstream(projectRoot, workstreamId) {
-    try {
-        const workstreamState = loadWorkstreamState(projectRoot, workstreamId);
-        return LIVE_WORKSTREAM_STATUSES.has(workstreamState.lifecycle_status);
+    const statePath = resolveWorkstreamPath(projectRoot, workstreamId, "state.json");
+    if (!fs.existsSync(statePath)) {
+        return false;
     }
-    catch {
+    const workstreamState = loadWorkstreamState(projectRoot, workstreamId);
+    return LIVE_WORKSTREAM_STATUSES.has(workstreamState.lifecycle_status);
+}
+function isClosedWorkstream(projectRoot, workstreamId) {
+    const statePath = resolveWorkstreamPath(projectRoot, workstreamId, "state.json");
+    if (!fs.existsSync(statePath)) {
         return false;
     }
+    const workstreamState = loadWorkstreamState(projectRoot, workstreamId);
+    return CLOSED_WORKSTREAM_STATUSES.has(workstreamState.lifecycle_status);
 }
-function readCurrentWorkstreamPointer(pointerPath) {
+export function loadCurrentWorkstreamPointer(pointerPath) {
     if (!fs.existsSync(pointerPath)) {
         return null;
     }
     const value = fs.readFileSync(pointerPath, "utf8").trim();
-    return value.length > 0 ? value : null;
+    return value.length > 0
+        ? validateWorkstreamId(value, `workstream pointer in ${pointerPath}`)
+        : null;
 }
 function readJsonFile(filePath) {
     if (!fs.existsSync(filePath)) {

package/dist/state.js.map

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

package/dist/stateSchemas.d.ts

@@ -0,0 +1,16 @@
+import type { CaptureEntry, FocusState, ProjectState, ResumeState, WorkstreamState } from "./types.js";
+export declare const STATE_SCHEMA_FIELDS: {
+    readonly project: readonly ["version", "project_id", "project_name", "objective", "default_briefing_mode", "tracked_artifacts", "workstreams", "created_at", "updated_at"];
+    readonly focus: readonly ["version", "current_workstream_id", "current_environment_id", "current_branch", "resume_from", "last_command", "last_saved_at", "last_wrapped_at", "stale", "mismatch_flags", "updated_at"];
+    readonly workstream: readonly ["version", "workstream_id", "title", "objective", "lifecycle_status", "mode", "status_summary", "active_files", "active_artifacts", "blockers", "open_questions", "next_actions", "continuation_hint", "branch", "last_saved_at", "last_wrapped_at", "completed_at", "created_at", "updated_at"];
+    readonly resume: readonly ["version", "remaining_tasks", "paused_reason", "resume_from", "updated_at"];
+};
+export declare function parseProjectState(value: unknown, source: string): ProjectState;
+export declare function parseFocusState(value: unknown, source: string): FocusState;
+export declare function parseWorkstreamState(value: unknown, source: string): WorkstreamState;
+export declare function parseResumeState(value: unknown, source: string): ResumeState;
+/**
+ * Validated per line rather than per file, so one malformed entry does not
+ * abort the rest of the log.
+ */
+export declare function parseCaptureEntry(value: unknown, source: string): CaptureEntry;