@wandoupeas/coding-forge 0.1.0

package/dist/cli/utils/logger.js

@@ -0,0 +1,57 @@
+/**
+ * CLI 日志工具
+ * 美化终端输出
+ */
+import chalk from 'chalk';
+export const logger = {
+    info(message) {
+        console.log(chalk.blue('ℹ'), message);
+    },
+    success(message) {
+        console.log(chalk.green('✔'), message);
+    },
+    warning(message) {
+        console.log(chalk.yellow('⚠'), message);
+    },
+    error(message) {
+        console.log(chalk.red('✖'), message);
+    },
+    debug(message) {
+        if (process.env.DEBUG) {
+            console.log(chalk.gray('🐛'), chalk.gray(message));
+        }
+    },
+    h1(title) {
+        console.log('\n' + chalk.bold.green(title));
+        console.log(chalk.green('═'.repeat(title.length * 2)));
+    },
+    h2(title) {
+        console.log('\n' + chalk.bold.cyan(title));
+    },
+    list(items, bullet = '  •') {
+        for (const item of items) {
+            console.log(`${bullet} ${item}`);
+        }
+    },
+    table(rows) {
+        // 简单表格实现
+        if (rows.length === 0)
+            return;
+        const colWidths = rows[0].map((_, i) => Math.max(...rows.map(row => (row[i] || '').length)));
+        for (const row of rows) {
+            const line = row.map((cell, i) => (cell || '').padEnd(colWidths[i] + 2)).join('');
+            console.log('  ' + line);
+        }
+    },
+    // 进度条
+    progress(current, total, width = 30) {
+        const ratio = total > 0 ? current / total : 0;
+        const filled = Math.round(width * ratio);
+        const empty = width - filled;
+        const bar = chalk.green('█'.repeat(filled)) + chalk.gray('░'.repeat(empty));
+        const percent = Math.round(ratio * 100);
+        return `[${bar}] ${percent}% (${current}/${total})`;
+    }
+};
+export default logger;
+//# sourceMappingURL=logger.js.map

package/dist/cli/utils/logger.js.map

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

package/dist/core/checkpoint.d.ts

@@ -0,0 +1,54 @@
+/**
+ * 检查点系统
+ * 关键节点保存快照，支持回滚
+ */
+import { Task, Phase } from '../types/index.js';
+import type { Deliverable } from './deliverable.js';
+export interface CheckpointDeliverableSnapshot extends Deliverable {
+    snapshotPath: string;
+}
+export interface Checkpoint {
+    id: string;
+    name: string;
+    createdAt: string;
+    description?: string;
+    tasks: Task[];
+    phases: Phase[];
+    gitCommit?: string;
+    deliverables: CheckpointDeliverableSnapshot[];
+}
+/**
+ * 创建检查点
+ */
+export declare function createCheckpoint(name: string, tasks: Task[], phases: Phase[], options?: {
+    description?: string;
+    gitCommit?: string;
+    basePath?: string;
+}): Promise<Checkpoint>;
+/**
+ * 列出所有检查点
+ */
+export declare function listCheckpoints(basePath?: string): Promise<Checkpoint[]>;
+/**
+ * 加载检查点
+ */
+export declare function loadCheckpoint(checkpointId: string, basePath?: string): Promise<Checkpoint | null>;
+/**
+ * 回滚到检查点
+ */
+export declare function rollbackToCheckpoint(checkpointId: string, basePath?: string, options?: {
+    restoreDeliverables?: boolean;
+}): Promise<{
+    tasks: Task[];
+    phases: Phase[];
+    deliverables?: Deliverable[];
+} | null>;
+/**
+ * 删除检查点
+ */
+export declare function deleteCheckpoint(checkpointId: string, basePath?: string): Promise<boolean>;
+/**
+ * 自动在关键节点创建检查点
+ */
+export declare function autoCheckpoint(tasks: Task[], phases: Phase[], basePath?: string): Promise<void>;
+//# sourceMappingURL=checkpoint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../src/core/checkpoint.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAQpD,MAAM,WAAW,6BAA8B,SAAQ,WAAW;IAChE,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,6BAA6B,EAAE,CAAC;CAC/C;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,IAAI,EAAE,EACb,MAAM,EAAE,KAAK,EAAE,EACf,OAAO,CAAC,EAAE;IACR,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACA,OAAO,CAAC,UAAU,CAAC,CAuBrB;AAsHD;;GAEG;AACH,wBAAsB,eAAe,CACnC,QAAQ,GAAE,MAAsB,GAC/B,OAAO,CAAC,UAAU,EAAE,CAAC,CA0BvB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,YAAY,EAAE,MAAM,EACpB,QAAQ,GAAE,MAAsB,GAC/B,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAa5B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,EACpB,QAAQ,GAAE,MAAsB,EAChC,OAAO,CAAC,EAAE;IACR,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B,GACA,OAAO,CAAC;IACT,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;CAC9B,GAAG,IAAI,CAAC,CA8BR;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,MAAM,EACpB,QAAQ,GAAE,MAAsB,GAC/B,OAAO,CAAC,OAAO,CAAC,CAclB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,IAAI,EAAE,EACb,MAAM,EAAE,KAAK,EAAE,EACf,QAAQ,GAAE,MAAsB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAwBf"}

package/dist/core/checkpoint.js

@@ -0,0 +1,227 @@
+/**
+ * 检查点系统
+ * 关键节点保存快照，支持回滚
+ */
+import { writeFile, readFile, copyFile } from 'fs/promises';
+import { dirname, join } from 'path';
+import { existsSync } from 'fs';
+import { ensureDir, readJson, writeJson } from '../utils/file.js';
+const CHECKPOINTS_DIR = '.webforge/checkpoints';
+const DELIVERABLES_INDEX = '.webforge/deliverables/index.json';
+const TASKS_FILE = '.webforge/tasks.json';
+const PHASES_FILE = '.webforge/phases.json';
+/**
+ * 创建检查点
+ */
+export async function createCheckpoint(name, tasks, phases, options) {
+    const basePath = options?.basePath ?? process.cwd();
+    const checkpointsDir = join(basePath, CHECKPOINTS_DIR);
+    await ensureDir(checkpointsDir);
+    const id = createCheckpointId();
+    const deliverables = await snapshotDeliverables(basePath, id);
+    const checkpoint = {
+        id,
+        name,
+        createdAt: new Date().toISOString(),
+        description: options?.description,
+        tasks: JSON.parse(JSON.stringify(tasks)), // 深拷贝
+        phases: JSON.parse(JSON.stringify(phases)),
+        gitCommit: options?.gitCommit,
+        deliverables
+    };
+    // 保存检查点
+    const checkpointPath = join(checkpointsDir, `${checkpoint.id}.json`);
+    await writeFile(checkpointPath, JSON.stringify(checkpoint, null, 2));
+    return checkpoint;
+}
+function createCheckpointId() {
+    // Tests and rollback flows may create multiple checkpoints under a frozen clock.
+    const suffix = Math.random().toString(36).slice(2, 8);
+    return `cp-${Date.now()}-${suffix}`;
+}
+async function snapshotDeliverables(basePath, checkpointId) {
+    const deliverables = await loadCheckpointDeliverables(basePath);
+    if (deliverables.length === 0) {
+        return [];
+    }
+    const snapshots = [];
+    for (const deliverable of deliverables) {
+        const snapshotRelativePath = buildCheckpointDeliverablePath(checkpointId, deliverable.path);
+        const snapshotPath = join(basePath, snapshotRelativePath);
+        await ensureDir(dirname(snapshotPath));
+        const sourcePath = join(basePath, deliverable.path);
+        if (existsSync(sourcePath)) {
+            await copyFile(sourcePath, snapshotPath);
+        }
+        else if (typeof deliverable.content === 'string') {
+            await writeFile(snapshotPath, deliverable.content, 'utf-8');
+        }
+        else {
+            continue;
+        }
+        snapshots.push({
+            ...deliverable,
+            snapshotPath: toPosixPath(snapshotRelativePath)
+        });
+    }
+    return snapshots;
+}
+async function loadCheckpointDeliverables(basePath) {
+    const indexPath = join(basePath, DELIVERABLES_INDEX);
+    if (!existsSync(indexPath)) {
+        return [];
+    }
+    try {
+        const data = await readJson(indexPath);
+        if (Array.isArray(data)) {
+            return data;
+        }
+        if (Array.isArray(data.items)) {
+            return data.items;
+        }
+        return [];
+    }
+    catch {
+        return [];
+    }
+}
+function buildCheckpointDeliverablePath(checkpointId, deliverablePath) {
+    const trimmedPath = deliverablePath.replace(/^\.webforge[\\/]+deliverables[\\/]+/, '');
+    return join(CHECKPOINTS_DIR, checkpointId, 'deliverables', trimmedPath || deliverablePath.split(/[\\/]/).pop() || 'deliverable');
+}
+function toPosixPath(path) {
+    return path.replace(/\\/g, '/');
+}
+async function restoreCheckpointDeliverables(checkpoint, basePath) {
+    const restored = [];
+    for (const snapshot of checkpoint.deliverables) {
+        const targetPath = join(basePath, snapshot.path);
+        const snapshotSourcePath = join(basePath, snapshot.snapshotPath);
+        await ensureDir(dirname(targetPath));
+        if (existsSync(snapshotSourcePath)) {
+            await copyFile(snapshotSourcePath, targetPath);
+        }
+        else if (typeof snapshot.content === 'string') {
+            await writeFile(targetPath, snapshot.content, 'utf-8');
+        }
+        else {
+            continue;
+        }
+        const { snapshotPath, ...deliverable } = snapshot;
+        restored.push(deliverable);
+    }
+    await writeJson(join(basePath, DELIVERABLES_INDEX), { items: restored });
+    return restored;
+}
+async function restoreCheckpointGraph(checkpoint, basePath) {
+    await writeJson(join(basePath, TASKS_FILE), {
+        tasks: checkpoint.tasks
+    });
+    await writeJson(join(basePath, PHASES_FILE), {
+        phases: checkpoint.phases
+    });
+}
+/**
+ * 列出所有检查点
+ */
+export async function listCheckpoints(basePath = process.cwd()) {
+    const checkpointsDir = join(basePath, CHECKPOINTS_DIR);
+    if (!existsSync(checkpointsDir)) {
+        return [];
+    }
+    const { readdir } = await import('fs/promises');
+    const files = await readdir(checkpointsDir);
+    const checkpoints = [];
+    for (const file of files) {
+        if (file.endsWith('.json')) {
+            try {
+                const content = await readFile(join(checkpointsDir, file), 'utf-8');
+                checkpoints.push(JSON.parse(content));
+            }
+            catch {
+                // 忽略损坏的检查点
+            }
+        }
+    }
+    // 按时间倒序
+    return checkpoints.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+}
+/**
+ * 加载检查点
+ */
+export async function loadCheckpoint(checkpointId, basePath = process.cwd()) {
+    const checkpointPath = join(basePath, CHECKPOINTS_DIR, `${checkpointId}.json`);
+    if (!existsSync(checkpointPath)) {
+        return null;
+    }
+    try {
+        const content = await readFile(checkpointPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 回滚到检查点
+ */
+export async function rollbackToCheckpoint(checkpointId, basePath = process.cwd(), options) {
+    const checkpoint = await loadCheckpoint(checkpointId, basePath);
+    if (!checkpoint) {
+        return null;
+    }
+    // 创建回滚记录
+    const { createCheckpoint } = await import('./checkpoint.js');
+    await createCheckpoint(`Rollback from ${checkpoint.name}`, checkpoint.tasks, checkpoint.phases, {
+        description: `Auto-created before rollback to ${checkpointId}`,
+        basePath
+    });
+    await restoreCheckpointGraph(checkpoint, basePath);
+    const restoredDeliverables = options?.restoreDeliverables
+        ? await restoreCheckpointDeliverables(checkpoint, basePath)
+        : undefined;
+    return {
+        tasks: checkpoint.tasks,
+        phases: checkpoint.phases,
+        deliverables: restoredDeliverables
+    };
+}
+/**
+ * 删除检查点
+ */
+export async function deleteCheckpoint(checkpointId, basePath = process.cwd()) {
+    const checkpointPath = join(basePath, CHECKPOINTS_DIR, `${checkpointId}.json`);
+    if (!existsSync(checkpointPath)) {
+        return false;
+    }
+    try {
+        const { unlink } = await import('fs/promises');
+        await unlink(checkpointPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 自动在关键节点创建检查点
+ */
+export async function autoCheckpoint(tasks, phases, basePath = process.cwd()) {
+    // 检查是否应该创建检查点
+    const completedCount = tasks.filter(t => t.status === 'completed').length;
+    const totalCount = tasks.length;
+    // 每完成 25% 创建一个检查点
+    const milestones = [0.25, 0.5, 0.75];
+    for (const milestone of milestones) {
+        const targetCount = Math.floor(totalCount * milestone);
+        if (completedCount === targetCount && completedCount > 0) {
+            const phase = phases.find(p => p.status === 'in_progress');
+            await createCheckpoint(`Phase ${phase?.name || 'Milestone'} ${milestone * 100}%`, tasks, phases, {
+                description: `Auto-checkpoint at ${completedCount}/${totalCount} tasks`,
+                basePath
+            });
+            break;
+        }
+    }
+}
+//# sourceMappingURL=checkpoint.js.map

package/dist/core/checkpoint.js.map

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

package/dist/core/context.d.ts

@@ -0,0 +1,36 @@
+import { type ObservationSnapshot, type PermissionHints, type SuperpowersHints } from './harness-hints.js';
+import type { Phase, Task, WorkspaceDeliverableIndexEntry, WorkspaceKnowledgeIndexEntry, WorkspacePaths, WorkspaceRuntime, WorkspaceSessionIndexEntry, WorkspaceWorkflowContext } from '../types/index.js';
+export interface ExecutionContext {
+    workspace: {
+        basePath: string;
+        paths: WorkspacePaths;
+    };
+    runtime: WorkspaceRuntime;
+    task: Task;
+    phase: Phase;
+    knowledge: {
+        items: WorkspaceKnowledgeIndexEntry[];
+        requirements: WorkspaceKnowledgeIndexEntry[];
+        design: WorkspaceKnowledgeIndexEntry[];
+        decisions: WorkspaceKnowledgeIndexEntry[];
+        parsed: WorkspaceKnowledgeIndexEntry[];
+        notes: WorkspaceKnowledgeIndexEntry[];
+    };
+    deliverables: {
+        items: WorkspaceDeliverableIndexEntry[];
+        task: WorkspaceDeliverableIndexEntry[];
+    };
+    sessions: {
+        items: WorkspaceSessionIndexEntry[];
+        active: WorkspaceSessionIndexEntry | null;
+        related: WorkspaceSessionIndexEntry[];
+    };
+    superpowers: SuperpowersHints;
+    workflowContext: WorkspaceWorkflowContext | null;
+    permissions: PermissionHints;
+    observation: ObservationSnapshot;
+}
+export declare function buildExecutionContext(basePath: string, taskId: string, options?: {
+    workerId?: string;
+}): Promise<ExecutionContext>;
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/core/context.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAC;AAQ5B,OAAO,KAAK,EACV,KAAK,EACL,IAAI,EACJ,8BAA8B,EAC9B,4BAA4B,EAC5B,cAAc,EACd,gBAAgB,EAChB,0BAA0B,EAC1B,wBAAwB,EACzB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE;QACT,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,cAAc,CAAC;KACvB,CAAC;IACF,OAAO,EAAE,gBAAgB,CAAC;IAC1B,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE;QACT,KAAK,EAAE,4BAA4B,EAAE,CAAC;QACtC,YAAY,EAAE,4BAA4B,EAAE,CAAC;QAC7C,MAAM,EAAE,4BAA4B,EAAE,CAAC;QACvC,SAAS,EAAE,4BAA4B,EAAE,CAAC;QAC1C,MAAM,EAAE,4BAA4B,EAAE,CAAC;QACvC,KAAK,EAAE,4BAA4B,EAAE,CAAC;KACvC,CAAC;IACF,YAAY,EAAE;QACZ,KAAK,EAAE,8BAA8B,EAAE,CAAC;QACxC,IAAI,EAAE,8BAA8B,EAAE,CAAC;KACxC,CAAC;IACF,QAAQ,EAAE;QACR,KAAK,EAAE,0BAA0B,EAAE,CAAC;QACpC,MAAM,EAAE,0BAA0B,GAAG,IAAI,CAAC;QAC1C,OAAO,EAAE,0BAA0B,EAAE,CAAC;KACvC,CAAC;IACF,WAAW,EAAE,gBAAgB,CAAC;IAC9B,eAAe,EAAE,wBAAwB,GAAG,IAAI,CAAC;IACjD,WAAW,EAAE,eAAe,CAAC;IAC7B,WAAW,EAAE,mBAAmB,CAAC;CAClC;AAED,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAClC,OAAO,CAAC,gBAAgB,CAAC,CAqE3B"}

package/dist/core/context.js

@@ -0,0 +1,71 @@
+import { resolve } from 'path';
+import { buildObservationSnapshot, loadPermissionHints, loadSuperpowersHints } from './harness-hints.js';
+import { getRuntimeWorkflowContext, getSessionWorkflowContext, getTaskWorkflowContext, pickWorkflowContext } from './workflow-context.js';
+import { loadWorkspaceState } from './workspace.js';
+export async function buildExecutionContext(basePath, taskId, options = {}) {
+    const workspace = await loadWorkspaceState(basePath);
+    const task = workspace.tasks.tasks.find((item) => item.id === taskId);
+    if (!task) {
+        throw new Error(`Task not found: ${taskId}`);
+    }
+    const phase = workspace.phases.phases.find((item) => item.id === task.phase);
+    if (!phase) {
+        throw new Error(`Phase not found for task ${taskId}: ${task.phase}`);
+    }
+    const knowledgeItems = workspace.indexes.knowledge;
+    const deliverables = workspace.indexes.deliverables;
+    const sessions = workspace.indexes.sessions;
+    const relatedSessions = sessions.filter((session) => session.currentTask === taskId ||
+        (!session.currentTask && session.currentPhase === phase.id));
+    const activeSession = pickMostRecentSession(relatedSessions.filter((session) => session.status === 'active')) ||
+        pickMostRecentSession(relatedSessions);
+    const workflowContext = pickWorkflowContext(getTaskWorkflowContext(task), getSessionWorkflowContext(activeSession), getRuntimeWorkflowContext(workspace.runtime));
+    const [superpowers, permissions, observation] = await Promise.all([
+        loadSuperpowersHints(basePath, task),
+        loadPermissionHints(basePath),
+        buildObservationSnapshot(basePath, workspace, {
+            taskId,
+            relatedSessionCount: relatedSessions.length,
+            workerId: options.workerId
+        })
+    ]);
+    return {
+        workspace: {
+            basePath: resolve(basePath),
+            paths: workspace.paths
+        },
+        runtime: workspace.runtime,
+        task,
+        phase,
+        knowledge: {
+            items: knowledgeItems,
+            requirements: knowledgeItems.filter((item) => item.type === 'requirement'),
+            design: knowledgeItems.filter((item) => item.type === 'design'),
+            decisions: knowledgeItems.filter((item) => item.type === 'decision'),
+            parsed: knowledgeItems.filter((item) => item.type === 'parsed'),
+            notes: knowledgeItems.filter((item) => item.type === 'note')
+        },
+        deliverables: {
+            items: deliverables,
+            task: deliverables.filter((item) => item.taskId === taskId)
+        },
+        sessions: {
+            items: sessions,
+            active: activeSession,
+            related: relatedSessions
+        },
+        superpowers,
+        workflowContext,
+        permissions,
+        observation
+    };
+}
+function pickMostRecentSession(sessions) {
+    if (sessions.length === 0) {
+        return null;
+    }
+    return sessions.reduce((latest, current) => new Date(current.lastActive).getTime() > new Date(latest.lastActive).getTime()
+        ? current
+        : latest);
+}
+//# sourceMappingURL=context.js.map

package/dist/core/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/core/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,oBAAoB,EAIrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AA2CpD,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,QAAgB,EAChB,MAAc,EACd,UAAiC,EAAE;IAEnC,MAAM,SAAS,GAAG,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IAEtE,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7E,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,4BAA4B,MAAM,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,cAAc,GAAG,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC;IACnD,MAAM,YAAY,GAAG,SAAS,CAAC,OAAO,CAAC,YAAY,CAAC;IACpD,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC5C,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CACrC,CAAC,OAAO,EAAE,EAAE,CACV,OAAO,CAAC,WAAW,KAAK,MAAM;QAC9B,CAAC,CAAC,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,YAAY,KAAK,KAAK,CAAC,EAAE,CAAC,CAC9D,CAAC;IACF,MAAM,aAAa,GACjB,qBAAqB,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;QACvF,qBAAqB,CAAC,eAAe,CAAC,CAAC;IACzC,MAAM,eAAe,GAAG,mBAAmB,CACzC,sBAAsB,CAAC,IAAI,CAAC,EAC5B,yBAAyB,CAAC,aAAa,CAAC,EACxC,yBAAyB,CAAC,SAAS,CAAC,OAAO,CAAC,CAC7C,CAAC;IACF,MAAM,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAChE,oBAAoB,CAAC,QAAQ,EAAE,IAAI,CAAC;QACpC,mBAAmB,CAAC,QAAQ,CAAC;QAC7B,wBAAwB,CAAC,QAAQ,EAAE,SAAS,EAAE;YAC5C,MAAM;YACN,mBAAmB,EAAE,eAAe,CAAC,MAAM;YAC3C,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC;KACH,CAAC,CAAC;IAEH,OAAO;QACL,SAAS,EAAE;YACT,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC;YAC3B,KAAK,EAAE,SAAS,CAAC,KAAK;SACvB;QACD,OAAO,EAAE,SAAS,CAAC,OAAO;QAC1B,IAAI;QACJ,KAAK;QACL,SAAS,EAAE;YACT,KAAK,EAAE,cAAc;YACrB,YAAY,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,aAAa,CAAC;YAC1E,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC;YAC/D,SAAS,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC;YACpE,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC;YAC/D,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;SAC7D;QACD,YAAY,EAAE;YACZ,KAAK,EAAE,YAAY;YACnB,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC;SAC5D;QACD,QAAQ,EAAE;YACR,KAAK,EAAE,QAAQ;YACf,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE,eAAe;SACzB;QACD,WAAW;QACX,eAAe;QACf,WAAW;QACX,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAC5B,QAAsC;IAEtC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CACzC,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE;QAC5E,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,MAAM,CACX,CAAC;AACJ,CAAC"}

package/dist/core/deliverable.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 交付物管理模块
+ * 管理 Worker 产生的可交付物（文档、代码、设计等）
+ */
+export type DeliverableType = 'document' | 'code' | 'test' | 'config' | 'design' | 'review';
+export interface Deliverable {
+    id: string;
+    taskId: string;
+    type: DeliverableType;
+    title: string;
+    content: string;
+    path: string;
+    createdBy: string;
+    createdAt: string;
+    status: 'draft' | 'pending_review' | 'approved' | 'rejected';
+    reviewComment?: string;
+}
+/**
+ * 创建交付物
+ */
+export declare function createDeliverable(taskId: string, type: DeliverableType, title: string, content: string, createdBy: string, basePath?: string): Promise<Deliverable>;
+/**
+ * 获取交付物内容
+ */
+export declare function getDeliverableContent(deliverableId: string, basePath?: string): Promise<string | null>;
+/**
+ * 审核交付物
+ */
+export declare function reviewDeliverable(deliverableId: string, approved: boolean, comment?: string, basePath?: string): Promise<void>;
+/**
+ * 列出任务的所有交付物
+ */
+export declare function listDeliverables(taskId?: string, basePath?: string): Promise<Deliverable[]>;
+//# sourceMappingURL=deliverable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deliverable.d.ts","sourceRoot":"","sources":["../../src/core/deliverable.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,MAAM,eAAe,GACvB,UAAU,GACV,MAAM,GACN,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,QAAQ,CAAC;AAEb,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,GAAG,gBAAgB,GAAG,UAAU,GAAG,UAAU,CAAC;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAUD;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,CAAC,CA+BtB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,aAAa,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAcxB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,OAAO,EACjB,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAWf;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,EAAE,CAAC,CAMxB"}

package/dist/core/deliverable.js

@@ -0,0 +1,125 @@
+/**
+ * 交付物管理模块
+ * 管理 Worker 产生的可交付物（文档、代码、设计等）
+ */
+import { writeText, readText, readJson, writeJson } from '../utils/file.js';
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { withFileLock } from '../utils/lock.js';
+const DELIVERABLES_DIR = '.webforge/deliverables';
+const DELIVERABLES_INDEX = '.webforge/deliverables/index.json';
+const DELIVERABLES_LOCK = '.webforge/deliverables/index.lock';
+/**
+ * 创建交付物
+ */
+export async function createDeliverable(taskId, type, title, content, createdBy, basePath) {
+    const id = `del-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+    const timestamp = new Date().toISOString();
+    // 确定文件扩展名
+    const ext = type === 'code' ? 'ts' :
+        type === 'config' ? 'yaml' :
+            type === 'test' ? 'test.ts' : 'md';
+    const filename = `${id}.${ext}`;
+    const filePath = join(DELIVERABLES_DIR, filename);
+    // 保存文件
+    await writeText(resolveDeliverablePath(basePath, filePath), content);
+    const deliverable = {
+        id,
+        taskId,
+        type,
+        title,
+        content,
+        path: filePath,
+        createdBy,
+        createdAt: timestamp,
+        status: 'pending_review' // 默认需要人工审核
+    };
+    // 更新索引
+    await addToIndex(deliverable, basePath);
+    return deliverable;
+}
+/**
+ * 获取交付物内容
+ */
+export async function getDeliverableContent(deliverableId, basePath) {
+    try {
+        const index = await loadIndex(basePath);
+        const del = index.items.find(d => d.id === deliverableId);
+        if (!del)
+            return null;
+        const contentPath = resolveDeliverablePath(basePath, del.path);
+        if (existsSync(contentPath)) {
+            return await readText(contentPath);
+        }
+        return del.content; // 回退到内存中的内容
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 审核交付物
+ */
+export async function reviewDeliverable(deliverableId, approved, comment, basePath) {
+    await withFileLock(resolveDeliverablePath(basePath, DELIVERABLES_LOCK), async () => {
+        const index = await loadIndex(basePath);
+        const del = index.items.find(d => d.id === deliverableId);
+        if (del) {
+            del.status = approved ? 'approved' : 'rejected';
+            del.reviewComment = comment;
+            await saveIndex(index, basePath);
+        }
+    });
+}
+/**
+ * 列出任务的所有交付物
+ */
+export async function listDeliverables(taskId, basePath) {
+    const index = await loadIndex(basePath);
+    if (taskId) {
+        return index.items.filter(d => d.taskId === taskId);
+    }
+    return index.items;
+}
+/**
+ * 加载索引
+ */
+async function loadIndex(basePath) {
+    try {
+        const indexPath = resolveDeliverablePath(basePath, DELIVERABLES_INDEX);
+        if (!existsSync(indexPath)) {
+            return { items: [] };
+        }
+        const data = await readJson(indexPath);
+        if (Array.isArray(data)) {
+            return { items: data };
+        }
+        if (data && Array.isArray(data.items)) {
+            return { items: data.items };
+        }
+        return { items: [] };
+    }
+    catch {
+        return { items: [] };
+    }
+}
+/**
+ * 保存索引
+ */
+async function saveIndex(index, basePath) {
+    await writeJson(resolveDeliverablePath(basePath, DELIVERABLES_INDEX), index);
+}
+/**
+ * 添加到索引
+ */
+async function addToIndex(deliverable, basePath) {
+    await withFileLock(resolveDeliverablePath(basePath, DELIVERABLES_LOCK), async () => {
+        const index = await loadIndex(basePath);
+        index.items.push(deliverable);
+        await saveIndex(index, basePath);
+    });
+}
+function resolveDeliverablePath(basePath, relativePath) {
+    return basePath ? join(basePath, relativePath) : relativePath;
+}
+//# sourceMappingURL=deliverable.js.map

package/dist/core/deliverable.js.map

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