@iq-context/core 0.1.0

package/dist/trackedArtifacts.js

@@ -0,0 +1,138 @@
+import fs from "node:fs";
+import path from "node:path";
+const EXCLUDED_DIRECTORIES = new Set([".git", ".iq-context", "node_modules"]);
+/**
+ * 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 function resolveTrackedArtifacts(projectRoot, patterns) {
+    const normalizedPatterns = patterns
+        .map(normalizePattern)
+        .filter((pattern) => pattern !== null);
+    if (normalizedPatterns.length === 0) {
+        return [];
+    }
+    const matches = new Map();
+    for (const pattern of normalizedPatterns) {
+        const matcher = globToRegExp(pattern);
+        for (const relativePath of listPatternCandidates(projectRoot, pattern)) {
+            if (!matcher.test(relativePath)) {
+                continue;
+            }
+            const existing = matches.get(relativePath);
+            if (existing) {
+                existing.patterns.push(pattern);
+                continue;
+            }
+            matches.set(relativePath, {
+                absolutePath: path.join(projectRoot, ...relativePath.split("/")),
+                relativePath,
+                patterns: [pattern],
+            });
+        }
+    }
+    return Array.from(matches.values()).sort((left, right) => {
+        return comparePaths(left.relativePath, right.relativePath);
+    });
+}
+function normalizePattern(pattern) {
+    const normalized = pattern.trim().replaceAll("\\", "/").replace(/^\.\//, "");
+    if (normalized.length === 0
+        || normalized.startsWith("/")
+        || normalized === ".."
+        || normalized.startsWith("../")
+        || normalized.includes("/../")) {
+        return null;
+    }
+    if (normalized.split("/").some((segment) => EXCLUDED_DIRECTORIES.has(segment))) {
+        return null;
+    }
+    return normalized;
+}
+function listPatternCandidates(projectRoot, pattern) {
+    const firstGlobIndex = pattern.search(/[?*]/);
+    if (firstGlobIndex === -1) {
+        const absolutePath = path.join(projectRoot, ...pattern.split("/"));
+        try {
+            return fs.lstatSync(absolutePath).isFile() ? [pattern] : [];
+        }
+        catch {
+            return [];
+        }
+    }
+    const staticPrefix = pattern.slice(0, firstGlobIndex);
+    const lastSlashIndex = staticPrefix.lastIndexOf("/");
+    const relativeStart = lastSlashIndex === -1 ? "" : staticPrefix.slice(0, lastSlashIndex);
+    const absoluteStart = relativeStart.length === 0
+        ? projectRoot
+        : path.join(projectRoot, ...relativeStart.split("/"));
+    try {
+        if (!fs.statSync(absoluteStart).isDirectory()) {
+            return [];
+        }
+    }
+    catch {
+        return [];
+    }
+    const files = [];
+    function visit(directoryPath, relativeDirectory) {
+        const entries = fs.readdirSync(directoryPath, { withFileTypes: true })
+            .sort((left, right) => comparePaths(left.name, right.name));
+        for (const entry of entries) {
+            if (entry.isDirectory() && EXCLUDED_DIRECTORIES.has(entry.name)) {
+                continue;
+            }
+            const absolutePath = path.join(directoryPath, entry.name);
+            const relativePath = relativeDirectory.length === 0
+                ? entry.name
+                : `${relativeDirectory}/${entry.name}`;
+            if (entry.isDirectory()) {
+                visit(absolutePath, relativePath);
+            }
+            else if (entry.isFile()) {
+                files.push(relativePath);
+            }
+        }
+    }
+    visit(absoluteStart, relativeStart);
+    return files;
+}
+function comparePaths(left, right) {
+    if (left < right) {
+        return -1;
+    }
+    if (left > right) {
+        return 1;
+    }
+    return 0;
+}
+function globToRegExp(pattern) {
+    let source = "^";
+    for (let index = 0; index < pattern.length; index += 1) {
+        const character = pattern[index];
+        if (character === "*") {
+            const isGlobstar = pattern[index + 1] === "*";
+            if (isGlobstar) {
+                const followedBySlash = pattern[index + 2] === "/";
+                source += followedBySlash ? "(?:.*/)?" : ".*";
+                index += followedBySlash ? 2 : 1;
+            }
+            else {
+                source += "[^/]*";
+            }
+            continue;
+        }
+        if (character === "?") {
+            source += "[^/]";
+            continue;
+        }
+        source += escapeRegExp(character);
+    }
+    return new RegExp(`${source}$`);
+}
+function escapeRegExp(character) {
+    return /[\\^$.*+?()[\]{}|]/.test(character) ? `\\${character}` : character;
+}
+//# sourceMappingURL=trackedArtifacts.js.map

package/dist/trackedArtifacts.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,276 @@
+export type BriefingMode = "lean" | "standard" | "deep";
+export type WorkstreamMode = "design" | "implement" | "debug" | "research" | "review" | "comms";
+export type WorkstreamLifecycleStatus = "active" | "paused" | "blocked" | "completed" | "abandoned";
+export type CaptureScope = "workstream" | "project";
+export type CaptureKind = "note" | "idea" | "question" | "reference" | "raw";
+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 StalenessReason = "missing" | "changed_after_checkpoint" | "mismatch" | "superseded";
+export interface InitOptions {
+    projectRoot: string;
+    defaultWorkstream?: string;
+    briefingMode?: BriefingMode;
+    force: boolean;
+}
+export interface InitResult {
+    projectRoot: string;
+    defaultWorkstream: string;
+    created: string[];
+    existing: string[];
+    refreshed: string[];
+    warnings: string[];
+}
+export interface ProjectPaths {
+    projectRoot: string;
+    configPath: string;
+    projectStatePath: string;
+    focusStatePath: string;
+    workstreamsDir: string;
+    currentWorkstreamPath: string;
+}
+export interface Assumption {
+    id?: string;
+    text: string;
+    status: string;
+}
+export interface ProjectState {
+    version: number;
+    project_id: string;
+    project_name: string;
+    objective: string;
+    default_briefing_mode: BriefingMode;
+    tracked_artifacts: string[];
+    global_assumptions: Assumption[];
+    stale_warnings: string[];
+    workstreams: string[];
+    created_at: string;
+    updated_at: string;
+}
+export interface FocusState {
+    version: number;
+    current_workstream_id: string;
+    current_environment_id: string | null;
+    current_branch: string | null;
+    resume_from: string;
+    last_command: string;
+    last_saved_at: string | null;
+    last_wrapped_at: string | null;
+    stale: boolean;
+    mismatch_flags: string[];
+    updated_at: string;
+}
+export interface WorkstreamState {
+    version: number;
+    workstream_id: string;
+    title: string;
+    objective: string;
+    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;
+    created_at: string;
+    updated_at: string;
+}
+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;
+    updated_at: string;
+}
+export interface GoOptions {
+    startDir: string;
+    projectRoot?: string;
+    workstreamId?: string;
+    mode?: BriefingMode;
+}
+export interface GoResult {
+    projectRoot: string;
+    mode: BriefingMode;
+    projectState: ProjectState;
+    workstreamState: WorkstreamState;
+    resumeState: ResumeState;
+    trackedArtifacts: TrackedArtifactBriefing;
+    recentCaptures: CaptureEntry[];
+    warnings: string[];
+    staleness: StalenessReport;
+}
+export interface TrackedArtifactBriefing {
+    configuredPatterns: string[];
+    resolvedPaths: string[];
+}
+export interface CaptureOptions {
+    startDir: string;
+    projectRoot?: string;
+    workstreamId?: string;
+    scope: CaptureScope;
+    body?: string;
+    note?: string;
+    files: string[];
+    kind?: CaptureKind;
+    inputSource: CaptureInputSource;
+}
+export interface CaptureEntry {
+    version: 1;
+    id: string;
+    captured_at: string;
+    scope: CaptureScope;
+    workstream_id: string | null;
+    kind: CaptureKind;
+    body: string | null;
+    note: string | null;
+    files: string[];
+    source: {
+        command: "capture";
+        input: CaptureInputSource;
+    };
+}
+export interface CaptureResult {
+    projectRoot: string;
+    capturePath: string;
+    entry: CaptureEntry;
+}
+export interface CapturePromotion {
+    captureId: string;
+    kind: DurableArtifactKind;
+}
+export interface StatusOptions {
+    startDir: string;
+    projectRoot?: string;
+    workstreamId?: string;
+}
+export interface StatusResult {
+    projectRoot: string;
+    projectState: ProjectState;
+    focusState: FocusState;
+    workstreamState: WorkstreamState;
+    resumeState: ResumeState;
+    staleness: StalenessReport;
+}
+export interface StalenessReport {
+    level: StalenessLevel;
+    /** Legacy string projection kept for existing callers; prefer warningDetails for new logic. */
+    warnings: string[];
+    warningDetails: StalenessWarning[];
+    /** Legacy string projection kept for existing callers; prefer warningDetails for new logic. */
+    mismatchFlags: string[];
+}
+export interface StalenessWarning {
+    message: string;
+    scope: StalenessScope;
+    sourceKind: StalenessSourceKind;
+    reason: StalenessReason;
+    path?: string;
+}
+export interface SaveOptions {
+    startDir: string;
+    projectRoot?: string;
+    workstreamId?: string;
+    summary?: string;
+    mode?: WorkstreamMode;
+    files: string[];
+    artifacts: string[];
+    nextActions: string[];
+    blockers: string[];
+    questions: string[];
+}
+export interface SaveResult {
+    projectRoot: string;
+    workstreamState: WorkstreamState;
+    resumeState: ResumeState;
+}
+export interface WrapOptions {
+    startDir: string;
+    projectRoot?: string;
+    workstreamId?: string;
+    summary?: string;
+    nextActions: string[];
+    blockers: string[];
+    questions: string[];
+    decisions: string[];
+    discoveries: string[];
+    assumptions: string[];
+    capturePromotions: CapturePromotion[];
+    complete: boolean;
+}
+export interface WrapResult {
+    projectRoot: string;
+    workstreamState: WorkstreamState;
+    resumeState: ResumeState;
+    sessionArtifactPath: string;
+    durableArtifacts: string[];
+}
+export interface DoctorOptions {
+    startDir: string;
+    projectRoot?: string;
+}
+export interface DoctorCheck {
+    label: string;
+    status: "pass" | "warn" | "fail";
+    message?: string;
+}
+export interface DoctorResult {
+    projectRoot: string;
+    checks: DoctorCheck[];
+}
+export type FindScope = "all" | "state" | "sessions" | "docs" | "captures";
+export type FindSourceKind = "state" | "session" | "doc" | "capture" | "artifact";
+export interface FindOptions {
+    startDir: string;
+    projectRoot?: string;
+    workstreamId?: string;
+    query: string;
+    scope: FindScope;
+    limit?: number;
+}
+export interface FindMatch {
+    filePath: string;
+    lineNumber: number;
+    line: string;
+    sourceKind: FindSourceKind;
+}
+export interface FindResult {
+    projectRoot: string;
+    query: string;
+    scope: FindScope;
+    totalMatches: number;
+    matches: FindMatch[];
+}
+export interface WorkstreamListItem {
+    workstreamId: string;
+    title: string;
+    lifecycleStatus: WorkstreamLifecycleStatus;
+    isCurrent: boolean;
+}
+export interface WorkstreamListResult {
+    projectRoot: string;
+    items: WorkstreamListItem[];
+}
+export interface WorkstreamActionResult {
+    projectRoot: string;
+    workstreamState: WorkstreamState;
+    resumeState: ResumeState;
+    created: string[];
+    existing: string[];
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/workstream.d.ts

@@ -0,0 +1,28 @@
+import type { WorkstreamActionResult, WorkstreamListResult } from "./types.js";
+export declare function listWorkstreams(options: {
+    startDir: string;
+    projectRoot?: string;
+}): WorkstreamListResult;
+export declare function createWorkstream(options: {
+    startDir: string;
+    projectRoot?: string;
+    workstreamId: string;
+    title?: string;
+    objective?: string;
+    switchTo: boolean;
+}): WorkstreamActionResult;
+export declare function switchWorkstream(options: {
+    startDir: string;
+    projectRoot?: string;
+    workstreamId: string;
+}): WorkstreamActionResult;
+export declare function completeWorkstream(options: {
+    startDir: string;
+    projectRoot?: string;
+    workstreamId: string;
+}): WorkstreamActionResult;
+export declare function reopenWorkstream(options: {
+    startDir: string;
+    projectRoot?: string;
+    workstreamId: string;
+}): WorkstreamActionResult;

package/dist/workstream.js

@@ -0,0 +1,119 @@
+import { loadFocusState, loadProjectState, loadResumeState, loadWorkstreamState, resolveProjectRoot, switchFocusToWorkstream, writeProjectState, writeResumeState, writeWorkstreamState, listWorkstreamIds, } from "./state.js";
+import { createWorkstreamScaffold } from "./init.js";
+export function listWorkstreams(options) {
+    const projectRoot = resolveProjectRoot(options.startDir, options.projectRoot);
+    const projectState = loadProjectState(projectRoot);
+    void projectState;
+    const currentWorkstreamId = getCurrentFocusWorkstreamId(projectRoot);
+    const items = [];
+    for (const workstreamId of listWorkstreamIds(projectRoot)) {
+        const state = loadWorkstreamState(projectRoot, workstreamId);
+        items.push({
+            workstreamId,
+            title: state.title,
+            lifecycleStatus: state.lifecycle_status,
+            isCurrent: workstreamId === currentWorkstreamId,
+        });
+    }
+    return {
+        projectRoot,
+        items,
+    };
+}
+export function createWorkstream(options) {
+    const projectRoot = resolveProjectRoot(options.startDir, options.projectRoot);
+    const projectState = loadProjectState(projectRoot);
+    if (listWorkstreamIds(projectRoot).includes(options.workstreamId)) {
+        throw new Error(`Workstream already exists: ${options.workstreamId}`);
+    }
+    const scaffold = createWorkstreamScaffold({
+        projectRoot,
+        workstreamId: options.workstreamId,
+        title: options.title,
+        objective: options.objective,
+    });
+    const nextProjectState = {
+        ...projectState,
+        workstreams: Array.from(new Set([...projectState.workstreams, options.workstreamId])),
+        updated_at: new Date().toISOString(),
+    };
+    writeProjectState(projectRoot, nextProjectState);
+    const workstreamState = loadWorkstreamState(projectRoot, options.workstreamId);
+    const resumeState = loadResumeState(projectRoot, options.workstreamId);
+    if (options.switchTo) {
+        switchFocusToWorkstream(projectRoot, workstreamState, resumeState);
+    }
+    return {
+        projectRoot,
+        workstreamState,
+        resumeState,
+        created: scaffold.created,
+        existing: scaffold.existing,
+    };
+}
+export function switchWorkstream(options) {
+    const projectRoot = resolveProjectRoot(options.startDir, options.projectRoot);
+    const workstreamState = loadWorkstreamState(projectRoot, options.workstreamId);
+    const resumeState = loadResumeState(projectRoot, options.workstreamId);
+    switchFocusToWorkstream(projectRoot, workstreamState, resumeState);
+    return {
+        projectRoot,
+        workstreamState,
+        resumeState,
+        created: [],
+        existing: [],
+    };
+}
+export function completeWorkstream(options) {
+    return updateWorkstreamLifecycle(options, "completed");
+}
+export function reopenWorkstream(options) {
+    return updateWorkstreamLifecycle(options, "active");
+}
+function updateWorkstreamLifecycle(options, lifecycleStatus) {
+    const projectRoot = resolveProjectRoot(options.startDir, options.projectRoot);
+    const currentState = loadWorkstreamState(projectRoot, options.workstreamId);
+    const currentResumeState = loadResumeState(projectRoot, options.workstreamId);
+    const timestamp = new Date().toISOString();
+    const nextState = {
+        ...currentState,
+        lifecycle_status: lifecycleStatus,
+        next_actions: lifecycleStatus === "completed" ? [] : currentState.next_actions,
+        continuation_hint: lifecycleStatus === "completed"
+            ? "Workstream completed."
+            : "Reopened; review the latest session context before continuing.",
+        completed_at: lifecycleStatus === "completed" ? timestamp : null,
+        updated_at: timestamp,
+        last_wrapped_at: lifecycleStatus === "completed" ? (currentState.last_wrapped_at ?? timestamp) : currentState.last_wrapped_at,
+    };
+    writeWorkstreamState(projectRoot, nextState);
+    const nextResumeState = {
+        ...currentResumeState,
+        remaining_tasks: lifecycleStatus === "completed" ? [] : currentResumeState.remaining_tasks,
+        paused_reason: lifecycleStatus === "completed"
+            ? "Workstream marked completed."
+            : "Workstream reopened for active use.",
+        resume_from: lifecycleStatus === "completed"
+            ? "Workstream completed."
+            : "Reopened; review the latest session context before continuing.",
+        updated_at: timestamp,
+    };
+    writeResumeState(projectRoot, options.workstreamId, nextResumeState);
+    return {
+        projectRoot,
+        workstreamState: nextState,
+        resumeState: nextResumeState,
+        created: [],
+        existing: [],
+    };
+}
+function getCurrentFocusWorkstreamId(projectRoot) {
+    try {
+        const focus = loadFocusState(projectRoot);
+        return typeof focus.current_workstream_id === "string" ? focus.current_workstream_id : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=workstream.js.map

package/dist/workstream.js.map

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

package/dist/wrap.d.ts

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