@wandoupeas/coding-forge 0.1.0

package/dist/core/superpowers-runs.js

@@ -0,0 +1,231 @@
+import { existsSync } from 'fs';
+import { basename, isAbsolute, join, relative, resolve } from 'path';
+import { setRuntimeWorkflowContext } from './runtime.js';
+import { applySessionWorkflowContext } from './session.js';
+import { upsertThreadLink } from './threads.js';
+import { toWorkflowContext } from './workflow-context.js';
+import { readJson, writeJson } from '../utils/file.js';
+const SUPERPOWERS_RUNS_FILE = '.webforge/superpowers-runs.json';
+const TASKS_FILE = '.webforge/tasks.json';
+export async function loadSuperpowersRuns(basePath) {
+    const path = join(basePath, SUPERPOWERS_RUNS_FILE);
+    if (!existsSync(path)) {
+        return [];
+    }
+    const raw = await readJson(path);
+    return normalizeSuperpowersRuns(raw);
+}
+export async function getLatestSuperpowersRun(basePath) {
+    const runs = await loadSuperpowersRuns(basePath);
+    return runs[0] ?? null;
+}
+export async function recordSuperpowersRun(basePath, input) {
+    const runs = await loadSuperpowersRuns(basePath);
+    const recordedAt = new Date().toISOString();
+    const run = {
+        id: buildRunId(),
+        workflow: input.workflow,
+        recordedAt,
+        summary: input.summary,
+        taskId: input.taskId,
+        sessionId: input.sessionId,
+        artifacts: input.artifacts.map((artifact) => normalizeArtifact(basePath, artifact)),
+        metadata: normalizeRunMetadata(basePath, input.metadata)
+    };
+    const workflowContext = toWorkflowContext(run);
+    if (run.taskId) {
+        await attachRunToTask(basePath, run, workflowContext);
+    }
+    if (run.sessionId) {
+        await applySessionWorkflowContext(run.sessionId, workflowContext, basePath);
+    }
+    await attachRunToRuntime(basePath, run, workflowContext);
+    if (run.metadata?.threadId) {
+        await upsertThreadLink(basePath, {
+            id: run.metadata.threadId,
+            recordedAt: run.recordedAt,
+            workflow: run.workflow,
+            summary: run.summary,
+            runId: run.id,
+            taskId: run.taskId,
+            sessionId: run.sessionId,
+            owner: run.metadata.owner,
+            branch: run.metadata.branch,
+            worktreePath: run.metadata.worktreePath,
+            artifacts: run.artifacts.map((artifact) => artifact.path)
+        });
+    }
+    await writeJson(join(basePath, SUPERPOWERS_RUNS_FILE), {
+        runs: [run, ...runs]
+    });
+    return run;
+}
+export function inspectSuperpowersRun(basePath, run) {
+    const missingArtifacts = run.artifacts
+        .map((artifact) => artifact.path)
+        .filter((path) => !existsSync(resolveStoredPath(basePath, path)));
+    const missingWorktreePath = run.metadata?.worktreePath &&
+        !existsSync(resolveStoredPath(basePath, run.metadata.worktreePath))
+        ? run.metadata.worktreePath
+        : null;
+    const missingCompactSessionId = run.metadata?.compactFromSession &&
+        !existsSync(resolveStoredPath(basePath, `.webforge/sessions/${run.metadata.compactFromSession}.json`))
+        ? run.metadata.compactFromSession
+        : null;
+    return {
+        missingArtifacts,
+        missingWorktreePath,
+        missingCompactSessionId
+    };
+}
+function normalizeSuperpowersRuns(raw) {
+    if (Array.isArray(raw)) {
+        return raw.map(normalizeRun).filter((item) => item !== null);
+    }
+    if (isRecord(raw) && Array.isArray(raw.runs)) {
+        return raw.runs
+            .map(normalizeRun)
+            .filter((item) => item !== null)
+            .sort((left, right) => right.recordedAt.localeCompare(left.recordedAt));
+    }
+    return [];
+}
+function normalizeRun(raw) {
+    if (!isRecord(raw) || typeof raw.id !== 'string' || typeof raw.workflow !== 'string') {
+        return null;
+    }
+    return {
+        id: raw.id,
+        workflow: raw.workflow,
+        recordedAt: typeof raw.recordedAt === 'string' ? raw.recordedAt : new Date().toISOString(),
+        summary: typeof raw.summary === 'string' ? raw.summary : '',
+        taskId: typeof raw.taskId === 'string' ? raw.taskId : undefined,
+        sessionId: typeof raw.sessionId === 'string' ? raw.sessionId : undefined,
+        artifacts: Array.isArray(raw.artifacts)
+            ? raw.artifacts
+                .map(normalizeArtifactShape)
+                .filter((item) => item !== null)
+            : [],
+        metadata: normalizeRunMetadata(undefined, raw.metadata)
+    };
+}
+function normalizeArtifact(basePath, artifact) {
+    const absolutePath = resolveStoredPath(basePath, artifact.path);
+    if (!existsSync(absolutePath)) {
+        throw new Error(`artifact not found: ${artifact.path}`);
+    }
+    return {
+        kind: artifact.kind,
+        path: normalizeStoredPath(basePath, absolutePath),
+        label: artifact.label ?? basename(artifact.path)
+    };
+}
+function normalizeArtifactShape(raw) {
+    if (!isRecord(raw) || typeof raw.path !== 'string') {
+        return null;
+    }
+    return {
+        kind: normalizeArtifactKind(raw.kind),
+        path: raw.path,
+        label: typeof raw.label === 'string' ? raw.label : undefined
+    };
+}
+function normalizeRunMetadata(basePath, raw) {
+    if (!isRecord(raw)) {
+        return undefined;
+    }
+    const metadata = {};
+    if (typeof raw.owner === 'string' && raw.owner.length > 0) {
+        metadata.owner = raw.owner;
+    }
+    if (typeof raw.waveId === 'string' && raw.waveId.length > 0) {
+        metadata.waveId = raw.waveId;
+    }
+    if (typeof raw.threadId === 'string' && raw.threadId.length > 0) {
+        metadata.threadId = raw.threadId;
+    }
+    if (typeof raw.branch === 'string' && raw.branch.length > 0) {
+        metadata.branch = raw.branch;
+    }
+    if (typeof raw.compactFromSession === 'string' && raw.compactFromSession.length > 0) {
+        metadata.compactFromSession = raw.compactFromSession;
+    }
+    if (typeof raw.worktreePath === 'string' && raw.worktreePath.length > 0) {
+        metadata.worktreePath =
+            basePath === undefined
+                ? raw.worktreePath
+                : normalizeStoredPath(basePath, resolveStoredPath(basePath, raw.worktreePath));
+    }
+    return Object.keys(metadata).length > 0 ? metadata : undefined;
+}
+async function attachRunToTask(basePath, run, workflowContext) {
+    const taskId = run.taskId;
+    if (!taskId) {
+        return;
+    }
+    const tasksPath = join(basePath, TASKS_FILE);
+    const tasksData = await readJson(tasksPath);
+    const task = tasksData.tasks.find((item) => item.id === taskId);
+    if (!task) {
+        throw new Error(`task not found: ${taskId}`);
+    }
+    task.metadata = {
+        ...task.metadata,
+        workflow_context: workflowContext,
+        superpowers_run: {
+            runId: run.id,
+            workflow: run.workflow,
+            recordedAt: run.recordedAt,
+            summary: run.summary,
+            artifacts: run.artifacts.map((artifact) => artifact.path),
+            metadata: run.metadata ?? {}
+        }
+    };
+    task.workflowContext = workflowContext;
+    await writeJson(tasksPath, tasksData);
+}
+async function attachRunToRuntime(basePath, run, workflowContext) {
+    const runtimePath = join(basePath, '.webforge', 'runtime.json');
+    if (!existsSync(runtimePath)) {
+        return;
+    }
+    const runtime = await readJson(runtimePath);
+    const sessionMatches = typeof runtime.sessionId === 'string' &&
+        typeof run.sessionId === 'string' &&
+        runtime.sessionId === run.sessionId;
+    const taskMatches = typeof runtime.taskId === 'string' &&
+        typeof run.taskId === 'string' &&
+        runtime.taskId === run.taskId;
+    if (!sessionMatches && !taskMatches) {
+        return;
+    }
+    await setRuntimeWorkflowContext(basePath, workflowContext);
+}
+function buildRunId() {
+    return `spr-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+}
+function normalizeStoredPath(basePath, absolutePath) {
+    const relativePath = relative(basePath, absolutePath).replace(/\\/g, '/');
+    return relativePath.startsWith('..') ? absolutePath : relativePath || '.';
+}
+function resolveStoredPath(basePath, targetPath) {
+    return isAbsolute(targetPath) ? targetPath : resolve(basePath, targetPath);
+}
+function normalizeArtifactKind(raw) {
+    switch (raw) {
+        case 'knowledge':
+        case 'decision':
+        case 'plan':
+        case 'compact-handoff':
+        case 'thread':
+        case 'worktree-metadata':
+            return raw;
+        case 'note':
+        default:
+            return 'note';
+    }
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=superpowers-runs.js.map

package/dist/core/superpowers-runs.js.map

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

package/dist/core/task.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 任务系统核心模块
+ * 负责任务图、状态流转和阶段进度
+ */
+import { Phase, Task, TaskStatus } from '../types/index.js';
+export declare class TaskManager {
+    private readonly tasks;
+    private readonly phases;
+    private readonly basePath;
+    constructor(basePath?: string);
+    load(): Promise<void>;
+    save(): Promise<void>;
+    createTask(taskData: Omit<Task, 'id' | 'created_at' | 'updated_at'>): Task;
+    createPhase(phaseData: Omit<Phase, 'created_at' | 'updated_at' | 'progress'>): Phase;
+    getTask(id: string): Task | undefined;
+    getPhase(id: string): Phase | undefined;
+    getAllTasks(): Task[];
+    getTasksByStatus(status: TaskStatus): Task[];
+    getReadyTasks(options?: {
+        limit?: number;
+    }): Task[];
+    getTasksByPhase(phaseId: string): Task[];
+    getAllPhases(): Phase[];
+    claimTask(taskId: string, workerId: string): Promise<Task | undefined>;
+    updateTaskStatus(taskId: string, status: TaskStatus, metadata?: Record<string, any>): Promise<Task | undefined>;
+    checkDependencies(taskId: string): boolean;
+    checkPhaseDependencies(completedPhaseId: string): Promise<void>;
+    updatePhaseProgress(phaseId: string): Promise<void>;
+    isPhaseReady(phaseId: string): boolean;
+    getStats(): {
+        total: number;
+        pending: number;
+        ready: number;
+        inProgress: number;
+        completed: number;
+        failed: number;
+        blocked: number;
+    };
+    private checkDependentTasks;
+    private generateTaskId;
+}
+export declare const taskManager: TaskManager;
+//# sourceMappingURL=task.d.ts.map

package/dist/core/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/core/task.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAO5D,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;IACxD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,QAAQ,GAAE,MAAsB;IAItC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,YAAY,GAAG,YAAY,CAAC,GAAG,IAAI;IAoB1E,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,GAAG,UAAU,CAAC,GAAG,KAAK;IAapF,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIrC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAIvC,WAAW,IAAI,IAAI,EAAE;IAMrB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,EAAE;IAI5C,aAAa,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,EAAE;IAsBnD,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE;IAIxC,YAAY,IAAI,KAAK,EAAE;IAMjB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC;IActE,gBAAgB,CACpB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,UAAU,EAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC7B,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC;IA2B5B,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAYpC,sBAAsB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB/D,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BzD,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAYtC,QAAQ,IAAI;QACV,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;KACjB;YAaa,mBAAmB;IAajC,OAAO,CAAC,cAAc;CAQvB;AAED,eAAO,MAAM,WAAW,aAAoB,CAAC"}

package/dist/core/task.js

@@ -0,0 +1,232 @@
+/**
+ * 任务系统核心模块
+ * 负责任务图、状态流转和阶段进度
+ */
+import { join } from 'path';
+import { readJson, writeJson } from '../utils/file.js';
+const TASKS_FILE = '.webforge/tasks.json';
+const PHASES_FILE = '.webforge/phases.json';
+export class TaskManager {
+    tasks = new Map();
+    phases = new Map();
+    basePath;
+    constructor(basePath = process.cwd()) {
+        this.basePath = basePath;
+    }
+    async load() {
+        this.tasks.clear();
+        this.phases.clear();
+        try {
+            const tasksData = await readJson(join(this.basePath, TASKS_FILE));
+            for (const task of tasksData.tasks) {
+                this.tasks.set(task.id, task);
+            }
+        }
+        catch {
+            // keep empty state
+        }
+        try {
+            const phasesData = await readJson(join(this.basePath, PHASES_FILE));
+            for (const phase of phasesData.phases) {
+                this.phases.set(phase.id, phase);
+            }
+        }
+        catch {
+            // keep empty state
+        }
+    }
+    async save() {
+        await writeJson(join(this.basePath, TASKS_FILE), {
+            tasks: this.getAllTasks()
+        });
+        await writeJson(join(this.basePath, PHASES_FILE), {
+            phases: this.getAllPhases()
+        });
+    }
+    createTask(taskData) {
+        const now = new Date().toISOString();
+        const id = this.generateTaskId();
+        const status = taskData.status === 'pending' && !taskData.depends_on?.length
+            ? 'ready'
+            : taskData.status;
+        const task = {
+            ...taskData,
+            id,
+            status,
+            created_at: now,
+            updated_at: now
+        };
+        this.tasks.set(id, task);
+        return task;
+    }
+    createPhase(phaseData) {
+        const now = new Date().toISOString();
+        const phase = {
+            ...phaseData,
+            progress: 0,
+            created_at: now,
+            updated_at: now
+        };
+        this.phases.set(phase.id, phase);
+        return phase;
+    }
+    getTask(id) {
+        return this.tasks.get(id);
+    }
+    getPhase(id) {
+        return this.phases.get(id);
+    }
+    getAllTasks() {
+        return Array.from(this.tasks.values()).sort((left, right) => left.id.localeCompare(right.id));
+    }
+    getTasksByStatus(status) {
+        return this.getAllTasks().filter((task) => task.status === status);
+    }
+    getReadyTasks(options) {
+        const readyTasks = this.getTasksByStatus('ready').sort((left, right) => {
+            if (left.priority !== right.priority) {
+                return left.priority - right.priority;
+            }
+            const createdAtDiff = new Date(left.created_at).getTime() - new Date(right.created_at).getTime();
+            if (createdAtDiff !== 0) {
+                return createdAtDiff;
+            }
+            return left.id.localeCompare(right.id);
+        });
+        if (options?.limit === undefined) {
+            return readyTasks;
+        }
+        return readyTasks.slice(0, options.limit);
+    }
+    getTasksByPhase(phaseId) {
+        return this.getAllTasks().filter((task) => task.phase === phaseId);
+    }
+    getAllPhases() {
+        return Array.from(this.phases.values()).sort((left, right) => left.id.localeCompare(right.id));
+    }
+    async claimTask(taskId, workerId) {
+        const task = this.tasks.get(taskId);
+        if (!task || task.status !== 'ready') {
+            return undefined;
+        }
+        task.status = 'in_progress';
+        task.assignee = workerId;
+        task.updated_at = new Date().toISOString();
+        await this.save();
+        return task;
+    }
+    async updateTaskStatus(taskId, status, metadata) {
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            return undefined;
+        }
+        task.status = status;
+        task.updated_at = new Date().toISOString();
+        if (status === 'completed' || status === 'failed') {
+            task.completed_at = task.updated_at;
+        }
+        if (metadata) {
+            task.metadata = { ...task.metadata, ...metadata };
+        }
+        if (status === 'completed') {
+            await this.checkDependentTasks(taskId);
+            await this.updatePhaseProgress(task.phase);
+            return task;
+        }
+        await this.save();
+        return task;
+    }
+    checkDependencies(taskId) {
+        const task = this.tasks.get(taskId);
+        if (!task || !task.depends_on?.length) {
+            return true;
+        }
+        return task.depends_on.every((dependencyId) => {
+            const dependency = this.tasks.get(dependencyId);
+            return dependency?.status === 'completed';
+        });
+    }
+    async checkPhaseDependencies(completedPhaseId) {
+        for (const phase of this.phases.values()) {
+            if (!phase.depends_on?.includes(completedPhaseId) || !this.isPhaseReady(phase.id)) {
+                continue;
+            }
+            for (const task of this.tasks.values()) {
+                if (task.phase === phase.id &&
+                    task.status === 'pending' &&
+                    task.depends_on.length === 0) {
+                    task.status = 'ready';
+                    task.updated_at = new Date().toISOString();
+                }
+            }
+        }
+        await this.save();
+    }
+    async updatePhaseProgress(phaseId) {
+        const phase = this.phases.get(phaseId);
+        if (!phase) {
+            return;
+        }
+        const phaseTasks = this.getTasksByPhase(phaseId);
+        if (phaseTasks.length === 0) {
+            return;
+        }
+        const completedCount = phaseTasks.filter((task) => task.status === 'completed').length;
+        phase.progress = Math.round((completedCount / phaseTasks.length) * 100);
+        phase.updated_at = new Date().toISOString();
+        const wasCompleted = phase.status === 'completed';
+        if (phase.progress === 100) {
+            phase.status = 'completed';
+            phase.completed_at = phase.updated_at;
+            if (!wasCompleted) {
+                await this.checkPhaseDependencies(phaseId);
+                return;
+            }
+        }
+        else if (phase.progress > 0) {
+            phase.status = 'in_progress';
+        }
+        await this.save();
+    }
+    isPhaseReady(phaseId) {
+        const phase = this.phases.get(phaseId);
+        if (!phase || !phase.depends_on?.length) {
+            return true;
+        }
+        return phase.depends_on.every((dependencyId) => {
+            const dependency = this.phases.get(dependencyId);
+            return dependency?.status === 'completed';
+        });
+    }
+    getStats() {
+        const tasks = this.getAllTasks();
+        return {
+            total: tasks.length,
+            pending: tasks.filter((task) => task.status === 'pending').length,
+            ready: tasks.filter((task) => task.status === 'ready').length,
+            inProgress: tasks.filter((task) => task.status === 'in_progress').length,
+            completed: tasks.filter((task) => task.status === 'completed').length,
+            failed: tasks.filter((task) => task.status === 'failed').length,
+            blocked: tasks.filter((task) => task.status === 'blocked').length
+        };
+    }
+    async checkDependentTasks(completedTaskId) {
+        for (const task of this.tasks.values()) {
+            if (task.depends_on?.includes(completedTaskId) &&
+                task.status === 'pending' &&
+                this.checkDependencies(task.id)) {
+                task.status = 'ready';
+                task.updated_at = new Date().toISOString();
+            }
+        }
+    }
+    generateTaskId() {
+        const existing = Array.from(this.tasks.keys())
+            .map((id) => Number.parseInt(id.replace('T', ''), 10))
+            .filter((id) => !Number.isNaN(id));
+        const max = existing.length > 0 ? Math.max(...existing) : 0;
+        return `T${String(max + 1).padStart(3, '0')}`;
+    }
+}
+export const taskManager = new TaskManager();
+//# sourceMappingURL=task.js.map

package/dist/core/task.js.map

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

package/dist/core/threads.d.ts

@@ -0,0 +1,23 @@
+import type { WorkspaceThreadLink } from '../types/index.js';
+export interface UpsertThreadLinkInput {
+    id: string;
+    recordedAt: string;
+    workflow: string;
+    summary: string;
+    runId?: string;
+    taskId?: string;
+    sessionId?: string;
+    owner?: string;
+    branch?: string;
+    worktreePath?: string;
+    artifacts: string[];
+}
+export interface ThreadLinkReadiness {
+    missingArtifacts: string[];
+    missingWorktreePath: string | null;
+}
+export declare function loadThreadLinks(basePath: string): Promise<WorkspaceThreadLink[]>;
+export declare function getThreadLink(basePath: string, threadId: string): Promise<WorkspaceThreadLink | null>;
+export declare function upsertThreadLink(basePath: string, input: UpsertThreadLinkInput): Promise<WorkspaceThreadLink>;
+export declare function inspectThreadLink(basePath: string, link: WorkspaceThreadLink): ThreadLinkReadiness;
+//# sourceMappingURL=threads.d.ts.map

package/dist/core/threads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"threads.d.ts","sourceRoot":"","sources":["../../src/core/threads.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAQ7D,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAQhC;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAGrC;AAED,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,mBAAmB,CAAC,CAyB9B;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,mBAAmB,GACxB,mBAAmB,CAarB"}

package/dist/core/threads.js

@@ -0,0 +1,92 @@
+import { existsSync } from 'fs';
+import { isAbsolute, join, resolve } from 'path';
+import { readJson, writeJson } from '../utils/file.js';
+const THREADS_FILE = '.webforge/threads.json';
+export async function loadThreadLinks(basePath) {
+    const path = join(basePath, THREADS_FILE);
+    if (!existsSync(path)) {
+        return [];
+    }
+    const raw = await readJson(path);
+    return normalizeThreadLinks(raw);
+}
+export async function getThreadLink(basePath, threadId) {
+    const links = await loadThreadLinks(basePath);
+    return links.find((link) => link.id === threadId) ?? null;
+}
+export async function upsertThreadLink(basePath, input) {
+    const links = await loadThreadLinks(basePath);
+    const next = {
+        id: input.id,
+        recordedAt: input.recordedAt,
+        workflow: input.workflow,
+        summary: input.summary,
+        runId: input.runId,
+        taskId: input.taskId,
+        sessionId: input.sessionId,
+        owner: input.owner,
+        branch: input.branch,
+        worktreePath: input.worktreePath,
+        artifacts: input.artifacts
+    };
+    const updated = [next, ...links.filter((link) => link.id !== input.id)].sort((left, right) => right.recordedAt.localeCompare(left.recordedAt));
+    await writeJson(join(basePath, THREADS_FILE), {
+        threads: updated
+    });
+    return next;
+}
+export function inspectThreadLink(basePath, link) {
+    const missingArtifacts = link.artifacts.filter((artifact) => !existsSync(resolveThreadPath(basePath, artifact)));
+    const missingWorktreePath = link.worktreePath && !existsSync(resolveThreadPath(basePath, link.worktreePath))
+        ? link.worktreePath
+        : null;
+    return {
+        missingArtifacts,
+        missingWorktreePath
+    };
+}
+function normalizeThreadLinks(raw) {
+    if (Array.isArray(raw)) {
+        return raw
+            .map(normalizeThreadLink)
+            .filter((link) => link !== null)
+            .sort((left, right) => right.recordedAt.localeCompare(left.recordedAt));
+    }
+    if (isRecord(raw) && Array.isArray(raw.threads)) {
+        return raw.threads
+            .map(normalizeThreadLink)
+            .filter((link) => link !== null)
+            .sort((left, right) => right.recordedAt.localeCompare(left.recordedAt));
+    }
+    return [];
+}
+function normalizeThreadLink(raw) {
+    if (!isRecord(raw) || typeof raw.id !== 'string' || raw.id.length === 0) {
+        return null;
+    }
+    const artifacts = Array.isArray(raw.artifacts)
+        ? raw.artifacts.filter((artifact) => typeof artifact === 'string' && artifact.length > 0)
+        : [];
+    return {
+        id: raw.id,
+        recordedAt: typeof raw.recordedAt === 'string' && raw.recordedAt.length > 0
+            ? raw.recordedAt
+            : new Date().toISOString(),
+        workflow: typeof raw.workflow === 'string' ? raw.workflow : 'unknown',
+        summary: typeof raw.summary === 'string' ? raw.summary : '',
+        runId: typeof raw.runId === 'string' ? raw.runId : undefined,
+        taskId: typeof raw.taskId === 'string' ? raw.taskId : undefined,
+        sessionId: typeof raw.sessionId === 'string' ? raw.sessionId : undefined,
+        owner: typeof raw.owner === 'string' ? raw.owner : undefined,
+        branch: typeof raw.branch === 'string' ? raw.branch : undefined,
+        worktreePath: typeof raw.worktreePath === 'string' ? raw.worktreePath : undefined,
+        artifacts
+    };
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function resolveThreadPath(basePath, targetPath) {
+    return isAbsolute(targetPath) ? targetPath : resolve(basePath, targetPath);
+}
+//# sourceMappingURL=threads.js.map