@iq-context/core 0.1.0

package/dist/save.d.ts

@@ -0,0 +1,2 @@
+import type { SaveOptions, SaveResult } from "./types.js";
+export declare function saveProgress(options: SaveOptions): SaveResult;

package/dist/save.js

@@ -0,0 +1,61 @@
+import { loadResumeState, loadWorkstreamState, resolveProjectRoot, resolveTargetWorkstream, updateFocusAfterSave, writeResumeState, writeWorkstreamState, } from "./state.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 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),
+        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),
+        updated_at: timestamp,
+    };
+    writeWorkstreamState(projectRoot, nextWorkstreamState);
+    writeResumeState(projectRoot, workstreamId, nextResumeState);
+    updateFocusAfterSave(projectRoot, nextWorkstreamState, nextResumeState);
+    return {
+        projectRoot,
+        workstreamState: nextWorkstreamState,
+        resumeState: nextResumeState,
+    };
+}
+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

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

package/dist/staleness.d.ts

@@ -0,0 +1,9 @@
+import type { ResolvedTrackedArtifact } from "./trackedArtifacts.js";
+import type { FocusState, ProjectState, ResumeState, 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;

package/dist/staleness.js

@@ -0,0 +1,272 @@
+import fs from "node:fs";
+import path from "node:path";
+import { execFileSync } from "node:child_process";
+import { loadFocusState, loadProjectState, loadResumeState, loadWorkstreamState, writeFocusState, } from "./state.js";
+import { loadProjectConfig } from "./config.js";
+import { resolveTrackedArtifacts } from "./trackedArtifacts.js";
+const CHANGE_GRACE_MS = 1000;
+const NON_STALE_LIFECYCLE_STATUSES = new Set(["completed", "abandoned"]);
+export function refreshStaleness(projectRoot, workstreamId, configuredArtifacts) {
+    const projectState = loadProjectState(projectRoot);
+    const focusState = loadFocusState(projectRoot);
+    const workstreamState = loadWorkstreamState(projectRoot, workstreamId);
+    const resumeState = loadResumeState(projectRoot, workstreamId);
+    const staleness = evaluateStaleness(projectRoot, workstreamState, resumeState, configuredArtifacts);
+    const timestamp = new Date().toISOString();
+    const nextFocusState = {
+        ...focusState,
+        stale: staleness.level === "stale",
+        mismatch_flags: staleness.mismatchFlags,
+        resume_from: resumeState.resume_from || workstreamState.continuation_hint || focusState.resume_from,
+        updated_at: (focusState.stale === (staleness.level === "stale")
+            && focusState.mismatch_flags.join("\n") === staleness.mismatchFlags.join("\n"))
+            ? focusState.updated_at
+            : timestamp,
+    };
+    writeFocusState(projectRoot, nextFocusState);
+    return {
+        projectState,
+        focusState: nextFocusState,
+        staleness,
+    };
+}
+export function evaluateStaleness(projectRoot, workstreamState, resumeState, configuredArtifacts) {
+    if (NON_STALE_LIFECYCLE_STATUSES.has(workstreamState.lifecycle_status)) {
+        return {
+            level: "fresh",
+            warnings: [],
+            warningDetails: [],
+            mismatchFlags: [],
+        };
+    }
+    const missingWarnings = findMissingTrackedPaths(projectRoot, workstreamState);
+    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
+            ? "stale"
+            : changedWarnings.length > 0 || trackedArtifactWarnings.length > 0
+                ? "warning"
+                : "fresh",
+        warnings,
+        warningDetails,
+        mismatchFlags,
+    };
+}
+function findChangedConfiguredArtifacts(projectRoot, workstreamState, workstreamChangedPaths, configuredArtifacts) {
+    const checkpointTime = latestCheckpointTime(workstreamState);
+    if (!checkpointTime) {
+        return [];
+    }
+    let artifacts = configuredArtifacts;
+    if (!artifacts) {
+        let patterns;
+        try {
+            patterns = loadProjectConfig(projectRoot).tracked_artifacts;
+        }
+        catch {
+            // Staleness stays available while doctor reports invalid project configuration.
+            return [];
+        }
+        artifacts = resolveTrackedArtifacts(projectRoot, patterns);
+    }
+    return artifacts.flatMap((artifact) => {
+        if (workstreamChangedPaths.has(artifact.relativePath)) {
+            return [];
+        }
+        try {
+            if (fs.statSync(artifact.absolutePath).mtimeMs <= checkpointTime.getTime() + CHANGE_GRACE_MS) {
+                return [];
+            }
+            return [{
+                    message: `Tracked artifact changed after the last checkpoint: ${artifact.relativePath}`,
+                    scope: "project",
+                    sourceKind: "tracked_artifact",
+                    reason: "changed_after_checkpoint",
+                    path: artifact.relativePath,
+                }];
+        }
+        catch {
+            // The artifact may disappear between resolution and stat while files are being rewritten.
+            return [];
+        }
+    });
+}
+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))) {
+            warnings.push({
+                message: `${reference.label} is missing: ${reference.filePath}`,
+                scope: "workstream",
+                sourceKind: reference.sourceKind,
+                reason: "missing",
+                path: reference.filePath,
+            });
+        }
+    }
+    return warnings;
+}
+function findChangedTrackedPaths(projectRoot, workstreamState) {
+    const checkpointTime = latestCheckpointTime(workstreamState);
+    if (!checkpointTime) {
+        return [];
+    }
+    const warnings = [];
+    for (const reference of trackedPathReferences(workstreamState)) {
+        const absolutePath = path.join(projectRoot, reference.filePath);
+        if (!fs.existsSync(absolutePath)) {
+            continue;
+        }
+        const stats = fs.statSync(absolutePath);
+        if (stats.isFile() && stats.mtimeMs > checkpointTime.getTime() + CHANGE_GRACE_MS) {
+            warnings.push({
+                message: `${reference.label} changed after the last checkpoint: ${reference.filePath}`,
+                scope: "workstream",
+                sourceKind: reference.sourceKind,
+                reason: "changed_after_checkpoint",
+                path: reference.filePath,
+            });
+        }
+    }
+    return warnings;
+}
+function findMismatchWarnings(projectRoot, workstreamState) {
+    const currentBranch = detectGitBranch(projectRoot);
+    if (!currentBranch || !workstreamState.branch || currentBranch === workstreamState.branch) {
+        return [];
+    }
+    return [{
+            message: `Current branch '${currentBranch}' differs from workstream branch '${workstreamState.branch}'.`,
+            scope: "focus",
+            sourceKind: "branch",
+            reason: "mismatch",
+        }];
+}
+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 });
+    }
+    for (const filePath of workstreamState.active_artifacts) {
+        references.push({ label: "Active artifact", sourceKind: "active_artifact", filePath });
+    }
+    return uniqueReferences(references);
+}
+function latestCheckpointTime(workstreamState) {
+    const timestamps = [
+        workstreamState.last_saved_at,
+        workstreamState.last_wrapped_at,
+    ]
+        .filter((value) => Boolean(value))
+        .map((value) => new Date(value))
+        .filter((value) => !Number.isNaN(value.getTime()));
+    if (timestamps.length === 0) {
+        return null;
+    }
+    return new Date(Math.max(...timestamps.map((value) => value.getTime())));
+}
+function uniqueReferences(references) {
+    const seen = new Set();
+    return references.filter((reference) => {
+        const key = `${reference.label}:${reference.filePath}`;
+        if (seen.has(key)) {
+            return false;
+        }
+        seen.add(key);
+        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

@@ -0,0 +1 @@
+{"version":3,"file":"staleness.js","sourceRoot":"","sources":["../src/staleness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAWhE,MAAM,eAAe,GAAG,IAAI,CAAC;AAC7B,MAAM,4BAA4B,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;AAQzE,MAAM,UAAU,gBAAgB,CAC9B,WAAmB,EACnB,YAAoB,EACpB,mBAA+C;IAE/C,MAAM,YAAY,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,eAAe,GAAG,mBAAmB,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IACvE,MAAM,WAAW,GAAG,eAAe,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,iBAAiB,CAAC,WAAW,EAAE,eAAe,EAAE,WAAW,EAAE,mBAAmB,CAAC,CAAC;IACpG,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,cAAc,GAAG;QACrB,GAAG,UAAU;QACb,KAAK,EAAE,SAAS,CAAC,KAAK,KAAK,OAAO;QAClC,cAAc,EAAE,SAAS,CAAC,aAAa;QACvC,WAAW,EAAE,WAAW,CAAC,WAAW,IAAI,eAAe,CAAC,iBAAiB,IAAI,UAAU,CAAC,WAAW;QACnG,UAAU,EAAE,CACV,UAAU,CAAC,KAAK,KAAK,CAAC,SAAS,CAAC,KAAK,KAAK,OAAO,CAAC;eAC/C,UAAU,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAC/E;YACC,CAAC,CAAC,UAAU,CAAC,UAAU;YACvB,CAAC,CAAC,SAAS;KACd,CAAC;IAEF,eAAe,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAE7C,OAAO;QACL,YAAY;QACZ,UAAU,EAAE,cAAc;QAC1B,SAAS;KACV,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,WAAmB,EACnB,eAAgC,EAChC,WAAwB,EACxB,mBAA+C;IAE/C,IAAI,4BAA4B,CAAC,GAAG,CAAC,eAAe,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACvE,OAAO;YACL,KAAK,EAAE,OAAO;YACd,QAAQ,EAAE,EAAE;YACZ,cAAc,EAAE,EAAE;YAClB,aAAa,EAAE,EAAE;SAClB,CAAC;IACJ,CAAC;IAED,MAAM,eAAe,GAAG,uBAAuB,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;IAC9E,MAAM,eAAe,GAAG,uBAAuB,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;IAC9E,MAAM,uBAAuB,GAAG,8BAA8B,CAC5D,WAAW,EACX,eAAe,EACf,IAAI,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EACjF,mBAAmB,CACpB,CAAC;IACF,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;IAC5E,MAAM,cAAc,GAAG,uBAAuB,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC;IAC7E,MAAM,cAAc,GAAG;QACrB,GAAG,eAAe;QAClB,GAAG,eAAe;QAClB,GAAG,uBAAuB;QAC1B,GAAG,gBAAgB;QACnB,GAAG,cAAc;KAClB,CAAC;IACF,MAAM,QAAQ,GAAG,cAAc;SAC5B,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,KAAK,UAAU,CAAC;SAClD,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,aAAa,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAEzE,OAAO;QACL,KAAK,EAAE,eAAe,CAAC,MAAM,GAAG,CAAC,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC;YAC3F,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,IAAI,uBAAuB,CAAC,MAAM,GAAG,CAAC;gBAChE,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,OAAO;QACb,QAAQ;QACR,cAAc;QACd,aAAa;KACd,CAAC;AACJ,CAAC;AAED,SAAS,8BAA8B,CACrC,WAAmB,EACnB,eAAgC,EAChC,sBAAmC,EACnC,mBAA+C;IAE/C,MAAM,cAAc,GAAG,oBAAoB,CAAC,eAAe,CAAC,CAAC;IAC7D,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,SAAS,GAAG,mBAAmB,CAAC;IACpC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,IAAI,QAAkB,CAAC;QACvB,IAAI,CAAC;YACH,QAAQ,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC,iBAAiB,CAAC;QAC9D,CAAC;QAAC,MAAM,CAAC;YACP,gFAAgF;YAChF,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,SAAS,GAAG,uBAAuB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAsB,EAAE;QACxD,IAAI,sBAAsB,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;YACtD,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,IAAI,CAAC;YACH,IAAI,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,OAAO,IAAI,cAAc,CAAC,OAAO,EAAE,GAAG,eAAe,EAAE,CAAC;gBAC7F,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,OAAO,CAAC;oBACN,OAAO,EAAE,uDAAuD,QAAQ,CAAC,YAAY,EAAE;oBACvF,KAAK,EAAE,SAAkB;oBACzB,UAAU,EAAE,kBAA2B;oBACvC,MAAM,EAAE,0BAAmC;oBAC3C,IAAI,EAAE,QAAQ,CAAC,YAAY;iBAC5B,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,0FAA0F;YAC1F,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,uBAAuB,CAC9B,eAAgC,EAChC,WAAwB;IAExB,MAAM,QAAQ,GAAuB,EAAE,CAAC;IACxC,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,eAAe,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC,CAAC;IACzF,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,eAAe,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC,CAAC;IAEzF,KAAK,MAAM,aAAa,IAAI,WAAW,CAAC,eAAe,EAAE,CAAC;QACxD,IAAI,cAAc,CAAC,GAAG,CAAC,uBAAuB,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC;YAC/D,QAAQ,CAAC,IAAI,CAAC;gBACZ,OAAO,EAAE,2DAA2D,aAAa,EAAE;gBACnF,KAAK,EAAE,YAAY;gBACnB,UAAU,EAAE,cAAc;gBAC1B,MAAM,EAAE,YAAY;aACrB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,IAAI,WAAW,CAAC,SAAS,IAAI,cAAc,CAAC,GAAG,CAAC,uBAAuB,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QAChG,QAAQ,CAAC,IAAI,CAAC;YACZ,OAAO,EAAE,kDAAkD,WAAW,CAAC,SAAS,EAAE;YAClF,KAAK,EAAE,YAAY;YACnB,UAAU,EAAE,cAAc;YAC1B,MAAM,EAAE,YAAY;SACrB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,yBAAyB,GAAG,WAAW,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QAC1E,MAAM,cAAc,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;QACrD,OAAO,cAAc,CAAC,MAAM,GAAG,CAAC,IAAI,uBAAuB,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IAChH,CAAC,CAAC,CAAC;IAEH,IAAI,yBAAyB,EAAE,CAAC;QAC9B,QAAQ,CAAC,IAAI,CAAC;YACZ,OAAO,EAAE,uDAAuD,yBAAyB,EAAE;YAC3F,KAAK,EAAE,YAAY;YACnB,UAAU,EAAE,cAAc;YAC1B,MAAM,EAAE,YAAY;SACrB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,6BAA6B,GAAG,WAAW,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QAC9E,MAAM,cAAc,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;QACrD,OAAO,cAAc,CAAC,MAAM,GAAG,CAAC,IAAI,uBAAuB,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IAC1H,CAAC,CAAC,CAAC;IAEH,2GAA2G;IAC3G,IAAI,6BAA6B,IAAI,6BAA6B,KAAK,yBAAyB,EAAE,CAAC;QACjG,QAAQ,CAAC,IAAI,CAAC;YACZ,OAAO,EAAE,6DAA6D,6BAA6B,EAAE;YACrG,KAAK,EAAE,YAAY;YACnB,UAAU,EAAE,cAAc;YAC1B,MAAM,EAAE,YAAY;SACrB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,cAAc,CAAC,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAa;IAC5C,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,cAAc,CAAC,QAA4B;IAClD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE;QACjC,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QAC1F,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAClB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,uBAAuB,CAAC,WAAmB,EAAE,eAAgC;IACpF,MAAM,QAAQ,GAAuB,EAAE,CAAC;IAExC,KAAK,MAAM,SAAS,IAAI,qBAAqB,CAAC,eAAe,CAAC,EAAE,CAAC;QAC/D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YAC/D,QAAQ,CAAC,IAAI,CAAC;gBACZ,OAAO,EAAE,GAAG,SAAS,CAAC,KAAK,gBAAgB,SAAS,CAAC,QAAQ,EAAE;gBAC/D,KAAK,EAAE,YAAY;gBACnB,UAAU,EAAE,SAAS,CAAC,UAAU;gBAChC,MAAM,EAAE,SAAS;gBACjB,IAAI,EAAE,SAAS,CAAC,QAAQ;aACzB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,uBAAuB,CAAC,WAAmB,EAAE,eAAgC;IACpF,MAAM,cAAc,GAAG,oBAAoB,CAAC,eAAe,CAAC,CAAC;IAC7D,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,QAAQ,GAAuB,EAAE,CAAC;IAExC,KAAK,MAAM,SAAS,IAAI,qBAAqB,CAAC,eAAe,CAAC,EAAE,CAAC;QAC/D,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;QAChE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACjC,SAAS;QACX,CAAC;QAED,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QACxC,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,OAAO,GAAG,cAAc,CAAC,OAAO,EAAE,GAAG,eAAe,EAAE,CAAC;YACjF,QAAQ,CAAC,IAAI,CAAC;gBACZ,OAAO,EAAE,GAAG,SAAS,CAAC,KAAK,uCAAuC,SAAS,CAAC,QAAQ,EAAE;gBACtF,KAAK,EAAE,YAAY;gBACnB,UAAU,EAAE,SAAS,CAAC,UAAU;gBAChC,MAAM,EAAE,0BAA0B;gBAClC,IAAI,EAAE,SAAS,CAAC,QAAQ;aACzB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,oBAAoB,CAAC,WAAmB,EAAE,eAAgC;IACjF,MAAM,aAAa,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IACnD,IAAI,CAAC,aAAa,IAAI,CAAC,eAAe,CAAC,MAAM,IAAI,aAAa,KAAK,eAAe,CAAC,MAAM,EAAE,CAAC;QAC1F,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,CAAC;YACN,OAAO,EAAE,mBAAmB,aAAa,qCAAqC,eAAe,CAAC,MAAM,IAAI;YACxG,KAAK,EAAE,OAAO;YACd,UAAU,EAAE,QAAQ;YACpB,MAAM,EAAE,UAAU;SACnB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,qBAAqB,CAC5B,eAAgC;IAEhC,MAAM,UAAU,GAA2F,EAAE,CAAC;IAE9G,IAAI,eAAe,CAAC,WAAW,EAAE,CAAC;QAChC,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,eAAe,CAAC,WAAW,EAAE,CAAC,CAAC;IAC9G,CAAC;IAED,KAAK,MAAM,QAAQ,IAAI,eAAe,CAAC,YAAY,EAAE,CAAC;QACpD,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC,CAAC;IACjF,CAAC;IAED,KAAK,MAAM,QAAQ,IAAI,eAAe,CAAC,gBAAgB,EAAE,CAAC;QACxD,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,iBAAiB,EAAE,QAAQ,EAAE,CAAC,CAAC;IACzF,CAAC;IAED,OAAO,gBAAgB,CAAC,UAAU,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,oBAAoB,CAAC,eAAgC;IAC5D,MAAM,UAAU,GAAG;QACjB,eAAe,CAAC,aAAa;QAC7B,eAAe,CAAC,eAAe;KAChC;SACE,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;SAClD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;SAC/B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAErD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,gBAAgB,CACvB,UAAkG;IAElG,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE;QACrC,MAAM,GAAG,GAAG,GAAG,SAAS,CAAC,KAAK,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;QACvD,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAClB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CAAC,WAAmB;IAC1C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,gBAAgB,CAAC,EAAE;YAC/D,GAAG,EAAE,WAAW;YAChB,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC,CAAC,IAAI,EAAE,CAAC;QAEV,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/state.d.ts

@@ -0,0 +1,18 @@
+import type { FocusState, ProjectPaths, ProjectState, ResumeState, WorkstreamState } from "./types.js";
+export declare function resolveProjectRoot(startDir: string, explicitProjectRoot?: string): string;
+export declare function getProjectPaths(projectRoot: string): ProjectPaths;
+export declare function loadProjectState(projectRoot: string): ProjectState;
+export declare function writeProjectState(projectRoot: string, projectState: ProjectState): void;
+export declare function loadFocusState(projectRoot: string): FocusState;
+export declare function listWorkstreamIds(projectRoot: string): string[];
+export declare function loadWorkstreamState(projectRoot: string, workstreamId: string): WorkstreamState;
+export declare function loadResumeState(projectRoot: string, workstreamId: string): ResumeState;
+export declare function writeFocusState(projectRoot: string, focusState: FocusState): void;
+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 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;

package/dist/state.js

@@ -0,0 +1,176 @@
+import fs from "node:fs";
+import path from "node:path";
+import { discoverProjectRoot } from "./discovery.js";
+import { writeJsonFileAtomic, writeTextFileAtomic } from "./persistence.js";
+const LIVE_WORKSTREAM_STATUSES = new Set(["active", "paused", "blocked"]);
+export function resolveProjectRoot(startDir, explicitProjectRoot) {
+    const projectRoot = explicitProjectRoot
+        ? path.resolve(explicitProjectRoot)
+        : discoverProjectRoot(startDir);
+    if (!projectRoot) {
+        throw new Error("No iq-context project found. Run iq-context init first.");
+    }
+    const configPath = path.join(projectRoot, ".iq-context", "config.yaml");
+    if (!fs.existsSync(configPath)) {
+        throw new Error(`Missing iq-context config at ${configPath}.`);
+    }
+    return projectRoot;
+}
+export function getProjectPaths(projectRoot) {
+    return {
+        projectRoot,
+        configPath: path.join(projectRoot, ".iq-context", "config.yaml"),
+        projectStatePath: path.join(projectRoot, ".iq-context", "project-state.json"),
+        focusStatePath: path.join(projectRoot, ".iq-context", "focus-state.json"),
+        workstreamsDir: path.join(projectRoot, ".iq-context", "workstreams"),
+        currentWorkstreamPath: path.join(projectRoot, ".iq-context", "workstreams", "current.txt"),
+    };
+}
+export function loadProjectState(projectRoot) {
+    const paths = getProjectPaths(projectRoot);
+    return readJsonFile(paths.projectStatePath);
+}
+export function writeProjectState(projectRoot, projectState) {
+    const paths = getProjectPaths(projectRoot);
+    writeJsonFile(paths.projectStatePath, projectState);
+}
+export function loadFocusState(projectRoot) {
+    const paths = getProjectPaths(projectRoot);
+    return readJsonFile(paths.focusStatePath);
+}
+export function listWorkstreamIds(projectRoot) {
+    const paths = getProjectPaths(projectRoot);
+    if (!fs.existsSync(paths.workstreamsDir)) {
+        return [];
+    }
+    return fs.readdirSync(paths.workstreamsDir, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory())
+        .map((entry) => entry.name)
+        .sort();
+}
+export function loadWorkstreamState(projectRoot, workstreamId) {
+    return readJsonFile(path.join(projectRoot, ".iq-context", "workstreams", workstreamId, "state.json"));
+}
+export function loadResumeState(projectRoot, workstreamId) {
+    return readJsonFile(path.join(projectRoot, ".iq-context", "workstreams", workstreamId, "resume-state.json"));
+}
+export function writeFocusState(projectRoot, focusState) {
+    const paths = getProjectPaths(projectRoot);
+    writeJsonFile(paths.focusStatePath, focusState);
+}
+export function writeWorkstreamState(projectRoot, workstreamState) {
+    writeJsonFile(path.join(projectRoot, ".iq-context", "workstreams", workstreamState.workstream_id, "state.json"), workstreamState);
+}
+export function writeResumeState(projectRoot, workstreamId, resumeState) {
+    writeJsonFile(path.join(projectRoot, ".iq-context", "workstreams", workstreamId, "resume-state.json"), resumeState);
+}
+export function writeCurrentWorkstreamPointer(projectRoot, workstreamId) {
+    const paths = getProjectPaths(projectRoot);
+    writeTextFileAtomic(paths.currentWorkstreamPath, `${workstreamId}\n`);
+}
+export function resolveTargetWorkstream(projectRoot, explicitWorkstreamId) {
+    const paths = getProjectPaths(projectRoot);
+    if (explicitWorkstreamId) {
+        ensureWorkstreamExists(projectRoot, explicitWorkstreamId);
+        return explicitWorkstreamId;
+    }
+    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);
+    if (currentPointer && isLiveWorkstream(projectRoot, currentPointer)) {
+        return currentPointer;
+    }
+    const liveWorkstreams = listWorkstreamIds(projectRoot)
+        .filter((workstreamId) => isLiveWorkstream(projectRoot, workstreamId));
+    if (liveWorkstreams.length === 1) {
+        return liveWorkstreams[0];
+    }
+    if (liveWorkstreams.length > 1) {
+        throw new Error(`Multiple live workstreams found (${liveWorkstreams.join(", ")}). Re-run with --workstream <id>.`);
+    }
+    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>.");
+    }
+    throw new Error("No workstream could be resolved. Run iq-context init first.");
+}
+export function updateFocusAfterGo(projectRoot, workstreamState, resumeState) {
+    const focusState = loadFocusState(projectRoot);
+    writeFocusState(projectRoot, buildNextFocusState(focusState, workstreamState, resumeState, "go"));
+}
+export function updateFocusAfterSave(projectRoot, workstreamState, resumeState) {
+    const focusState = loadFocusState(projectRoot);
+    writeFocusState(projectRoot, buildNextFocusState(focusState, workstreamState, resumeState, "save"));
+}
+export function updateFocusAfterWrap(projectRoot, workstreamState, resumeState) {
+    const focusState = loadFocusState(projectRoot);
+    const timestamp = new Date().toISOString();
+    const nextFocusState = buildNextFocusState(focusState, workstreamState, resumeState, "wrap");
+    writeFocusState(projectRoot, {
+        ...nextFocusState,
+        last_wrapped_at: timestamp,
+    });
+}
+export function switchFocusToWorkstream(projectRoot, workstreamState, resumeState) {
+    const focusState = loadFocusState(projectRoot);
+    const timestamp = new Date().toISOString();
+    writeCurrentWorkstreamPointer(projectRoot, workstreamState.workstream_id);
+    writeFocusState(projectRoot, {
+        ...focusState,
+        current_workstream_id: workstreamState.workstream_id,
+        current_environment_id: workstreamState.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",
+        updated_at: timestamp,
+    });
+}
+function buildNextFocusState(focusState, workstreamState, resumeState, lastCommand) {
+    const timestamp = new Date().toISOString();
+    return {
+        ...focusState,
+        current_workstream_id: workstreamState.workstream_id,
+        current_environment_id: workstreamState.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,
+        last_saved_at: lastCommand === "save" ? timestamp : focusState.last_saved_at,
+        stale: focusState.stale ?? false,
+        mismatch_flags: focusState.mismatch_flags ?? [],
+        updated_at: timestamp,
+    };
+}
+function ensureWorkstreamExists(projectRoot, workstreamId) {
+    const statePath = path.join(projectRoot, ".iq-context", "workstreams", 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);
+    }
+    catch {
+        return false;
+    }
+}
+function readCurrentWorkstreamPointer(pointerPath) {
+    if (!fs.existsSync(pointerPath)) {
+        return null;
+    }
+    const value = fs.readFileSync(pointerPath, "utf8").trim();
+    return value.length > 0 ? value : null;
+}
+function readJsonFile(filePath) {
+    if (!fs.existsSync(filePath)) {
+        throw new Error(`Missing required state file: ${filePath}`);
+    }
+    return JSON.parse(fs.readFileSync(filePath, "utf8"));
+}
+function writeJsonFile(filePath, value) {
+    writeJsonFileAtomic(filePath, value);
+}
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAS5E,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;AAE1E,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,mBAA4B;IAC/E,MAAM,WAAW,GAAG,mBAAmB;QACrC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC;QACnC,CAAC,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAElC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;IACxE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,gCAAgC,UAAU,GAAG,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,WAAmB;IACjD,OAAO;QACL,WAAW;QACX,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,aAAa,CAAC;QAChE,gBAAgB,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,oBAAoB,CAAC;QAC7E,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,kBAAkB,CAAC;QACzE,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,aAAa,CAAC;QACpE,qBAAqB,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,CAAC;KAC3F,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,WAAmB;IAClD,MAAM,KAAK,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAC3C,OAAO,YAAY,CAAe,KAAK,CAAC,gBAAgB,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,WAAmB,EAAE,YAA0B;IAC/E,MAAM,KAAK,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAC3C,aAAa,CAAC,KAAK,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,WAAmB;IAChD,MAAM,KAAK,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAC3C,OAAO,YAAY,CAAa,KAAK,CAAC,cAAc,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACnD,MAAM,KAAK,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAC3C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC;QACzC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,cAAc,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SACjE,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;SACtC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;SAC1B,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,WAAmB,EAAE,YAAoB;IAC3E,OAAO,YAAY,CACjB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,CAAC,CACjF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,WAAmB,EAAE,YAAoB;IACvE,OAAO,YAAY,CACjB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,mBAAmB,CAAC,CACxF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,WAAmB,EAAE,UAAsB;IACzE,MAAM,KAAK,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAC3C,aAAa,CAAC,KAAK,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,WAAmB,EAAE,eAAgC;IACxF,aAAa,CACX,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,CAAC,aAAa,EAAE,YAAY,CAAC,EACjG,eAAe,CAChB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,WAAmB,EAAE,YAAoB,EAAE,WAAwB;IAClG,aAAa,CACX,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,mBAAmB,CAAC,EACvF,WAAW,CACZ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,WAAmB,EAAE,YAAoB;IACrF,MAAM,KAAK,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAC3C,mBAAmB,CAAC,KAAK,CAAC,qBAAqB,EAAE,GAAG,YAAY,IAAI,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,WAAmB,EAAE,oBAA6B;IACxF,MAAM,KAAK,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAE3C,IAAI,oBAAoB,EAAE,CAAC;QACzB,sBAAsB,CAAC,WAAW,EAAE,oBAAoB,CAAC,CAAC;QAC1D,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAED,MAAM,UAAU,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAC/C,IAAI,UAAU,CAAC,qBAAqB,IAAI,gBAAgB,CAAC,WAAW,EAAE,UAAU,CAAC,qBAAqB,CAAC,EAAE,CAAC;QACxG,OAAO,UAAU,CAAC,qBAAqB,CAAC;IAC1C,CAAC;IAED,MAAM,cAAc,GAAG,4BAA4B,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACjF,IAAI,cAAc,IAAI,gBAAgB,CAAC,WAAW,EAAE,cAAc,CAAC,EAAE,CAAC;QACpE,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,MAAM,eAAe,GAAG,iBAAiB,CAAC,WAAW,CAAC;SACnD,MAAM,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,gBAAgB,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC;IAEzE,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,eAAe,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CACb,oCAAoC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,mCAAmC,CAClG,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;IACrD,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,oJAAoJ,CACrJ,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,WAAmB,EAAE,eAAgC,EAAE,WAAwB;IAChH,MAAM,UAAU,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAC/C,eAAe,CAAC,WAAW,EAAE,mBAAmB,CAAC,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC;AACpG,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,WAAmB,EAAE,eAAgC,EAAE,WAAwB;IAClH,MAAM,UAAU,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAC/C,eAAe,CAAC,WAAW,EAAE,mBAAmB,CAAC,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;AACtG,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,WAAmB,EAAE,eAAgC,EAAE,WAAwB;IAClH,MAAM,UAAU,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,cAAc,GAAG,mBAAmB,CAAC,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;IAC7F,eAAe,CAAC,WAAW,EAAE;QAC3B,GAAG,cAAc;QACjB,eAAe,EAAE,SAAS;KAC3B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,WAAmB,EAAE,eAAgC,EAAE,WAAwB;IACrH,MAAM,UAAU,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE3C,6BAA6B,CAAC,WAAW,EAAE,eAAe,CAAC,aAAa,CAAC,CAAC;IAC1E,eAAe,CAAC,WAAW,EAAE;QAC3B,GAAG,UAAU;QACb,qBAAqB,EAAE,eAAe,CAAC,aAAa;QACpD,sBAAsB,EAAE,eAAe,CAAC,cAAc,IAAI,UAAU,CAAC,sBAAsB;QAC3F,cAAc,EAAE,eAAe,CAAC,MAAM,IAAI,UAAU,CAAC,cAAc;QACnE,WAAW,EAAE,WAAW,CAAC,WAAW,IAAI,eAAe,CAAC,iBAAiB,IAAI,UAAU,CAAC,WAAW;QACnG,YAAY,EAAE,mBAAmB;QACjC,UAAU,EAAE,SAAS;KACtB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,mBAAmB,CAC1B,UAAsB,EACtB,eAAgC,EAChC,WAAwB,EACxB,WAAmB;IAEnB,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE3C,OAAO;QACL,GAAG,UAAU;QACb,qBAAqB,EAAE,eAAe,CAAC,aAAa;QACpD,sBAAsB,EAAE,eAAe,CAAC,cAAc,IAAI,UAAU,CAAC,sBAAsB;QAC3F,cAAc,EAAE,eAAe,CAAC,MAAM,IAAI,UAAU,CAAC,cAAc;QACnE,WAAW,EAAE,WAAW,CAAC,WAAW,IAAI,eAAe,CAAC,iBAAiB,IAAI,UAAU,CAAC,WAAW;QACnG,YAAY,EAAE,WAAW;QACzB,aAAa,EAAE,WAAW,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa;QAC5E,KAAK,EAAE,UAAU,CAAC,KAAK,IAAI,KAAK;QAChC,cAAc,EAAE,UAAU,CAAC,cAAc,IAAI,EAAE;QAC/C,UAAU,EAAE,SAAS;KACtB,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAAC,WAAmB,EAAE,YAAoB;IACvE,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;IACnG,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,uBAAuB,YAAY,EAAE,CAAC,CAAC;IACzD,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,WAAmB,EAAE,YAAoB;IACjE,IAAI,CAAC;QACH,MAAM,eAAe,GAAG,mBAAmB,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QACvE,OAAO,wBAAwB,CAAC,GAAG,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,4BAA4B,CAAC,WAAmB;IACvD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1D,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AACzC,CAAC;AAED,SAAS,YAAY,CAAI,QAAgB;IACvC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,gCAAgC,QAAQ,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAM,CAAC;AAC5D,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB,EAAE,KAAc;IACrD,mBAAmB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AACvC,CAAC"}

package/dist/status.d.ts

@@ -0,0 +1,2 @@
+import type { StatusOptions, StatusResult } from "./types.js";
+export declare function getStatus(options: StatusOptions): StatusResult;

package/dist/status.js

@@ -0,0 +1,18 @@
+import { loadFocusState, loadProjectState, loadResumeState, loadWorkstreamState, resolveProjectRoot, resolveTargetWorkstream, } from "./state.js";
+import { evaluateStaleness } from "./staleness.js";
+export function getStatus(options) {
+    const projectRoot = resolveProjectRoot(options.startDir, options.projectRoot);
+    const workstreamId = resolveTargetWorkstream(projectRoot, options.workstreamId);
+    const workstreamState = loadWorkstreamState(projectRoot, workstreamId);
+    const resumeState = loadResumeState(projectRoot, workstreamId);
+    const staleness = evaluateStaleness(projectRoot, workstreamState, resumeState);
+    return {
+        projectRoot,
+        projectState: loadProjectState(projectRoot),
+        focusState: loadFocusState(projectRoot),
+        workstreamState,
+        resumeState,
+        staleness,
+    };
+}
+//# sourceMappingURL=status.js.map

package/dist/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGnD,MAAM,UAAU,SAAS,CAAC,OAAsB;IAC9C,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,eAAe,GAAG,mBAAmB,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IACvE,MAAM,WAAW,GAAG,eAAe,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,iBAAiB,CAAC,WAAW,EAAE,eAAe,EAAE,WAAW,CAAC,CAAC;IAE/E,OAAO;QACL,WAAW;QACX,YAAY,EAAE,gBAAgB,CAAC,WAAW,CAAC;QAC3C,UAAU,EAAE,cAAc,CAAC,WAAW,CAAC;QACvC,eAAe;QACf,WAAW;QACX,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/trackedArtifacts.d.ts

@@ -0,0 +1,12 @@
+export interface ResolvedTrackedArtifact {
+    absolutePath: string;
+    relativePath: string;
+    patterns: string[];
+}
+/**
+ * Resolve configured artifact patterns against regular files in the project.
+ *
+ * Patterns are project-relative and use `/` separators. `*` and `?` match
+ * within one path segment, while `**` crosses directory boundaries.
+ */
+export declare function resolveTrackedArtifacts(projectRoot: string, patterns: string[]): ResolvedTrackedArtifact[];