@iq-context/core 0.1.0 → 0.3.0

package/dist/stateSchemas.js

@@ -0,0 +1,212 @@
+const SUPPORTED_STATE_VERSION = 1;
+const BRIEFING_MODES = new Set(["lean", "standard", "deep"]);
+const WORKSTREAM_MODES = new Set(["design", "implement", "debug", "research", "review", "comms"]);
+const LIFECYCLE_STATUSES = new Set(["active", "paused", "blocked", "completed", "abandoned"]);
+export const STATE_SCHEMA_FIELDS = {
+    project: [
+        "version",
+        "project_id",
+        "project_name",
+        "objective",
+        "default_briefing_mode",
+        "tracked_artifacts",
+        "workstreams",
+        "created_at",
+        "updated_at",
+    ],
+    focus: [
+        "version",
+        "current_workstream_id",
+        "current_environment_id",
+        "current_branch",
+        "resume_from",
+        "last_command",
+        "last_saved_at",
+        "last_wrapped_at",
+        "stale",
+        "mismatch_flags",
+        "updated_at",
+    ],
+    workstream: [
+        "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",
+    ],
+    resume: [
+        "version",
+        "remaining_tasks",
+        "paused_reason",
+        "resume_from",
+        "updated_at",
+    ],
+};
+export function parseProjectState(value, source) {
+    const state = stateObject(value, source);
+    stringField(state, "project_id", source);
+    stringField(state, "project_name", source);
+    stringField(state, "objective", source);
+    enumField(state, "default_briefing_mode", BRIEFING_MODES, source);
+    stringArrayField(state, "tracked_artifacts", source);
+    stringArrayField(state, "workstreams", source);
+    timestampField(state, "created_at", source);
+    timestampField(state, "updated_at", source);
+    return state;
+}
+export function parseFocusState(value, source) {
+    const state = stateObject(value, source);
+    stringField(state, "current_workstream_id", source);
+    nullableStringField(state, "current_environment_id", source);
+    nullableStringField(state, "current_branch", source);
+    stringField(state, "resume_from", source);
+    stringField(state, "last_command", source);
+    nullableTimestampField(state, "last_saved_at", source);
+    nullableTimestampField(state, "last_wrapped_at", source);
+    booleanField(state, "stale", source);
+    stringArrayField(state, "mismatch_flags", source);
+    timestampField(state, "updated_at", source);
+    return state;
+}
+export function parseWorkstreamState(value, source) {
+    const state = stateObject(value, source);
+    stringField(state, "workstream_id", source);
+    stringField(state, "title", source);
+    stringField(state, "objective", source);
+    enumField(state, "lifecycle_status", LIFECYCLE_STATUSES, source);
+    enumField(state, "mode", WORKSTREAM_MODES, source);
+    stringField(state, "status_summary", source);
+    stringArrayField(state, "active_files", source);
+    stringArrayField(state, "active_artifacts", source);
+    stringArrayField(state, "blockers", source);
+    stringArrayField(state, "open_questions", source);
+    stringArrayField(state, "next_actions", source);
+    stringField(state, "continuation_hint", source);
+    nullableStringField(state, "branch", source);
+    nullableTimestampField(state, "last_saved_at", source);
+    nullableTimestampField(state, "last_wrapped_at", source);
+    nullableTimestampField(state, "completed_at", source);
+    timestampField(state, "created_at", source);
+    timestampField(state, "updated_at", source);
+    return state;
+}
+export function parseResumeState(value, source) {
+    const state = stateObject(value, source);
+    stringArrayField(state, "remaining_tasks", source);
+    stringField(state, "paused_reason", source);
+    stringField(state, "resume_from", source);
+    timestampField(state, "updated_at", source);
+    return state;
+}
+function stateObject(value, source) {
+    const state = objectValue(value, source, "state object");
+    const version = state.version;
+    if (!Number.isInteger(version)) {
+        invalid(source, "version", "expected integer 1");
+    }
+    if (version !== SUPPORTED_STATE_VERSION) {
+        throw new Error(`Unsupported state version in ${source}: expected ${SUPPORTED_STATE_VERSION}, found ${String(version)}. ` +
+            "Run iq-context doctor and upgrade or migrate this project before continuing.");
+    }
+    return state;
+}
+function stringField(value, field, source, display = field) {
+    if (typeof value[field] !== "string") {
+        invalid(source, display, "expected a string");
+    }
+}
+function nullableStringField(value, field, source) {
+    if (value[field] !== null && typeof value[field] !== "string") {
+        invalid(source, field, "expected a string or null");
+    }
+}
+function stringArrayField(value, field, source) {
+    const entries = arrayValue(value[field], source, field);
+    entries.forEach((entry, index) => {
+        if (typeof entry !== "string") {
+            invalid(source, `${field}[${index}]`, "expected a string");
+        }
+    });
+}
+function enumField(value, field, allowed, source) {
+    if (typeof value[field] !== "string" || !allowed.has(value[field])) {
+        invalid(source, field, `expected one of ${[...allowed].join(", ")}`);
+    }
+}
+function booleanField(value, field, source) {
+    if (typeof value[field] !== "boolean") {
+        invalid(source, field, "expected a boolean");
+    }
+}
+function timestampField(value, field, source) {
+    if (!isIsoTimestamp(value[field])) {
+        invalid(source, field, "expected an ISO 8601 UTC timestamp");
+    }
+}
+function nullableTimestampField(value, field, source) {
+    if (value[field] !== null && !isIsoTimestamp(value[field])) {
+        invalid(source, field, "expected an ISO 8601 UTC timestamp or null");
+    }
+}
+function isIsoTimestamp(value) {
+    return typeof value === "string"
+        && /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z$/.test(value)
+        && !Number.isNaN(Date.parse(value));
+}
+function objectValue(value, source, field) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        invalid(source, field, "expected an object");
+    }
+    return value;
+}
+function arrayValue(value, source, field) {
+    if (!Array.isArray(value)) {
+        invalid(source, field, "expected an array");
+    }
+    return value;
+}
+function invalid(source, field, expectation) {
+    throw new Error(`Invalid state schema in ${source} at ${field}: ${expectation}.`);
+}
+const CAPTURE_SCOPES = new Set(["workstream", "project"]);
+const CAPTURE_KINDS = new Set(["note", "idea", "question", "reference", "raw"]);
+const CAPTURE_INPUTS = new Set(["argument", "stdin", "files", "mixed"]);
+/**
+ * Validated per line rather than per file, so one malformed entry does not
+ * abort the rest of the log.
+ */
+export function parseCaptureEntry(value, source) {
+    const entry = objectValue(value, source, "capture entry");
+    if (entry.version !== SUPPORTED_STATE_VERSION) {
+        invalid(source, "version", "expected integer 1");
+    }
+    stringField(entry, "id", source);
+    timestampField(entry, "captured_at", source);
+    enumField(entry, "scope", CAPTURE_SCOPES, source);
+    nullableStringField(entry, "workstream_id", source);
+    enumField(entry, "kind", CAPTURE_KINDS, source);
+    nullableStringField(entry, "body", source);
+    nullableStringField(entry, "note", source);
+    stringArrayField(entry, "files", source);
+    const entrySource = objectValue(entry.source, source, "source");
+    if (entrySource.command !== "capture") {
+        invalid(source, "source.command", "expected \"capture\"");
+    }
+    enumField(entrySource, "input", CAPTURE_INPUTS, source);
+    return entry;
+}
+//# sourceMappingURL=stateSchemas.js.map

package/dist/stateSchemas.js.map

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

package/dist/status.js

@@ -5,7 +5,7 @@ export function getStatus(options) {
     const workstreamId = resolveTargetWorkstream(projectRoot, options.workstreamId);
     const workstreamState = loadWorkstreamState(projectRoot, workstreamId);
     const resumeState = loadResumeState(projectRoot, workstreamId);
-    const staleness = evaluateStaleness(projectRoot, workstreamState, resumeState);
+    const staleness = evaluateStaleness(projectRoot, workstreamState);
     return {
         projectRoot,
         projectState: loadProjectState(projectRoot),

package/dist/status.js.map

@@ -1 +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"}
+{"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,CAAC,CAAC;IAElE,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/trackedPath.d.ts

@@ -0,0 +1,3 @@
+export declare function normalizeTrackedPath(projectRoot: string, value: string): string;
+export declare function resolveTrackedPath(projectRoot: string, value: string): string;
+export declare function isTrackedPathOutsideProject(projectRoot: string, value: string): boolean;

package/dist/trackedPath.js

@@ -0,0 +1,27 @@
+import os from "node:os";
+import path from "node:path";
+export function normalizeTrackedPath(projectRoot, value) {
+    const absolutePath = resolveTrackedPath(projectRoot, value);
+    const relativePath = path.relative(projectRoot, absolutePath);
+    if (!relativePath.startsWith("..") && !path.isAbsolute(relativePath)) {
+        return relativePath.length === 0 ? "." : relativePath.split(path.sep).join("/");
+    }
+    return value;
+}
+export function resolveTrackedPath(projectRoot, value) {
+    return path.resolve(projectRoot, expandLeadingTilde(value));
+}
+export function isTrackedPathOutsideProject(projectRoot, value) {
+    const relativePath = path.relative(projectRoot, resolveTrackedPath(projectRoot, value));
+    return relativePath.startsWith("..") || path.isAbsolute(relativePath);
+}
+function expandLeadingTilde(value) {
+    if (value === "~") {
+        return os.homedir();
+    }
+    if (value.startsWith("~/")) {
+        return path.join(os.homedir(), value.slice(2));
+    }
+    return value;
+}
+//# sourceMappingURL=trackedPath.js.map

package/dist/trackedPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trackedPath.js","sourceRoot":"","sources":["../src/trackedPath.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,UAAU,oBAAoB,CAAC,WAAmB,EAAE,KAAa;IACrE,MAAM,YAAY,GAAG,kBAAkB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAC5D,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAE9D,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACrE,OAAO,YAAY,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClF,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,WAAmB,EAAE,KAAa;IACnE,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,WAAmB,EAAE,KAAa;IAC5E,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;IACxF,OAAO,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACxE,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAa;IACvC,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;QAClB,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC;IACtB,CAAC;IAED,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/types.d.ts

@@ -7,8 +7,9 @@ export type CaptureInputSource = "argument" | "stdin" | "files" | "mixed";
 export type DurableArtifactKind = "decision" | "discovery" | "assumption";
 export type StalenessLevel = "fresh" | "warning" | "stale";
 export type StalenessScope = "focus" | "workstream" | "project";
-export type StalenessSourceKind = "active_plan" | "active_file" | "active_artifact" | "tracked_artifact" | "branch" | "resume_state" | "continuation";
+export type StalenessSourceKind = "active_file" | "active_artifact" | "tracked_artifact" | "branch";
 export type StalenessReason = "missing" | "changed_after_checkpoint" | "mismatch" | "superseded";
+export type ClearField = "files" | "artifacts" | "blockers" | "questions" | "next";
 export interface InitOptions {
     projectRoot: string;
     defaultWorkstream?: string;
@@ -31,11 +32,6 @@ export interface ProjectPaths {
     workstreamsDir: string;
     currentWorkstreamPath: string;
 }
-export interface Assumption {
-    id?: string;
-    text: string;
-    status: string;
-}
 export interface ProjectState {
     version: number;
     project_id: string;
@@ -43,8 +39,6 @@ export interface ProjectState {
     objective: string;
     default_briefing_mode: BriefingMode;
     tracked_artifacts: string[];
-    global_assumptions: Assumption[];
-    stale_warnings: string[];
     workstreams: string[];
     created_at: string;
     updated_at: string;
@@ -70,18 +64,13 @@ export interface WorkstreamState {
     lifecycle_status: WorkstreamLifecycleStatus;
     mode: WorkstreamMode;
     status_summary: string;
-    active_plan: string | null;
-    active_task: string | null;
     active_files: string[];
     active_artifacts: string[];
     blockers: string[];
     open_questions: string[];
     next_actions: string[];
-    assumptions: Assumption[];
     continuation_hint: string;
     branch: string | null;
-    worktree: string | null;
-    environment_id: string | null;
     last_saved_at: string | null;
     last_wrapped_at: string | null;
     completed_at: string | null;
@@ -90,10 +79,6 @@ export interface WorkstreamState {
 }
 export interface ResumeState {
     version: number;
-    plan_path: string | null;
-    completed_waves: string[];
-    next_wave: string | null;
-    completed_tasks: string[];
     remaining_tasks: string[];
     paused_reason: string;
     resume_from: string;
@@ -112,10 +97,20 @@ export interface GoResult {
     workstreamState: WorkstreamState;
     resumeState: ResumeState;
     trackedArtifacts: TrackedArtifactBriefing;
+    openObligations: OpenObligation[];
     recentCaptures: CaptureEntry[];
     warnings: string[];
     staleness: StalenessReport;
 }
+export interface Obligation {
+    id: string;
+    description: string;
+    kind: string;
+    trigger: string;
+    origin: string;
+    status: string;
+}
+export type OpenObligation = Obligation;
 export interface TrackedArtifactBriefing {
     configuredPatterns: string[];
     resolvedPaths: string[];
@@ -194,11 +189,29 @@ export interface SaveOptions {
     nextActions: string[];
     blockers: string[];
     questions: string[];
+    clearFields: ClearField[];
+}
+export interface ListDelta {
+    previous: string[];
+    current: string[];
+    added: string[];
+    removed: string[];
+    reordered: boolean;
+    clearRequested: boolean;
+    provided: boolean;
+}
+export interface StateDelta {
+    files: ListDelta;
+    artifacts: ListDelta;
+    blockers: ListDelta;
+    questions: ListDelta;
+    next: ListDelta;
 }
 export interface SaveResult {
     projectRoot: string;
     workstreamState: WorkstreamState;
     resumeState: ResumeState;
+    delta: StateDelta;
 }
 export interface WrapOptions {
     startDir: string;
@@ -213,6 +226,7 @@ export interface WrapOptions {
     assumptions: string[];
     capturePromotions: CapturePromotion[];
     complete: boolean;
+    clearFields: ClearField[];
 }
 export interface WrapResult {
     projectRoot: string;
@@ -220,6 +234,7 @@ export interface WrapResult {
     resumeState: ResumeState;
     sessionArtifactPath: string;
     durableArtifacts: string[];
+    delta: StateDelta;
 }
 export interface DoctorOptions {
     startDir: string;
@@ -227,7 +242,7 @@ export interface DoctorOptions {
 }
 export interface DoctorCheck {
     label: string;
-    status: "pass" | "warn" | "fail";
+    status: "pass" | "warn" | "fail" | "skipped" | "partial";
     message?: string;
 }
 export interface DoctorResult {

package/dist/workstream.js

@@ -82,7 +82,7 @@ function updateWorkstreamLifecycle(options, lifecycleStatus) {
         continuation_hint: lifecycleStatus === "completed"
             ? "Workstream completed."
             : "Reopened; review the latest session context before continuing.",
-        completed_at: lifecycleStatus === "completed" ? timestamp : null,
+        completed_at: lifecycleStatus === "completed" ? (currentState.completed_at ?? timestamp) : null,
         updated_at: timestamp,
         last_wrapped_at: lifecycleStatus === "completed" ? (currentState.last_wrapped_at ?? timestamp) : currentState.last_wrapped_at,
     };
@@ -108,12 +108,7 @@ function updateWorkstreamLifecycle(options, lifecycleStatus) {
     };
 }
 function getCurrentFocusWorkstreamId(projectRoot) {
-    try {
-        const focus = loadFocusState(projectRoot);
-        return typeof focus.current_workstream_id === "string" ? focus.current_workstream_id : null;
-    }
-    catch {
-        return null;
-    }
+    const focus = loadFocusState(projectRoot);
+    return focus.current_workstream_id;
 }
 //# sourceMappingURL=workstream.js.map

package/dist/workstream.js.map

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

package/dist/workstreamId.d.ts

@@ -0,0 +1,2 @@
+export declare function validateWorkstreamId(value: unknown, source?: string): string;
+export declare function resolveWorkstreamPath(projectRoot: string, workstreamId: string, ...relativeSegments: string[]): string;

package/dist/workstreamId.js

@@ -0,0 +1,67 @@
+import fs from "node:fs";
+import path from "node:path";
+const MAX_WORKSTREAM_ID_LENGTH = 64;
+const WORKSTREAM_ID_PATTERN = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/;
+const WINDOWS_RESERVED_NAMES = new Set([
+    "con",
+    "prn",
+    "aux",
+    "nul",
+    ...Array.from({ length: 9 }, (_, index) => `com${index + 1}`),
+    ...Array.from({ length: 9 }, (_, index) => `lpt${index + 1}`),
+]);
+export function validateWorkstreamId(value, source = "workstream id") {
+    if (typeof value !== "string"
+        || value.length === 0
+        || value.length > MAX_WORKSTREAM_ID_LENGTH
+        || !WORKSTREAM_ID_PATTERN.test(value)
+        || WINDOWS_RESERVED_NAMES.has(value)) {
+        throw new Error(`Invalid ${source}: ${JSON.stringify(value)}. `
+            + "Workstream IDs must be 1-64 lowercase ASCII letters, numbers, or hyphens; "
+            + "must start and end with a letter or number; and must not be a reserved platform name.");
+    }
+    return value;
+}
+export function resolveWorkstreamPath(projectRoot, workstreamId, ...relativeSegments) {
+    const validWorkstreamId = validateWorkstreamId(workstreamId);
+    const stateRoot = path.resolve(projectRoot, ".iq-context");
+    const workstreamRoot = path.resolve(stateRoot, "workstreams", validWorkstreamId);
+    const targetPath = path.resolve(workstreamRoot, ...relativeSegments);
+    if (!isWithin(workstreamRoot, targetPath)) {
+        throw new Error(`Resolved workstream path escapes ${validWorkstreamId}: ${targetPath}`);
+    }
+    assertContainedPath(stateRoot, workstreamRoot, targetPath);
+    return targetPath;
+}
+function assertContainedPath(stateRoot, workstreamRoot, targetPath) {
+    if (!isWithin(stateRoot, targetPath)) {
+        throw new Error(`Resolved state path escapes .iq-context: ${targetPath}`);
+    }
+    if (!fs.existsSync(stateRoot)) {
+        return;
+    }
+    const realStateRoot = fs.realpathSync(stateRoot);
+    let existingAncestor = targetPath;
+    while (!fs.existsSync(existingAncestor)) {
+        const parent = path.dirname(existingAncestor);
+        if (parent === existingAncestor) {
+            throw new Error(`Could not resolve a contained state path: ${targetPath}`);
+        }
+        existingAncestor = parent;
+    }
+    const realAncestor = fs.realpathSync(existingAncestor);
+    if (!isWithin(realStateRoot, realAncestor)) {
+        throw new Error(`Resolved state path escapes .iq-context through a symbolic link: ${targetPath}`);
+    }
+    if (fs.existsSync(workstreamRoot)) {
+        const realWorkstreamRoot = fs.realpathSync(workstreamRoot);
+        if (!isWithin(realWorkstreamRoot, realAncestor)) {
+            throw new Error(`Resolved workstream path escapes through a symbolic link: ${targetPath}`);
+        }
+    }
+}
+function isWithin(rootPath, candidatePath) {
+    const relative = path.relative(rootPath, candidatePath);
+    return relative === "" || (!relative.startsWith(`..${path.sep}`) && relative !== ".." && !path.isAbsolute(relative));
+}
+//# sourceMappingURL=workstreamId.js.map

package/dist/workstreamId.js.map

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