@wandoupeas/coding-forge 0.1.0

package/dist/core/mailbox.js

@@ -0,0 +1,225 @@
+/**
+ * 邮箱系统核心模块
+ * 实现 Worker 间的异步消息通信
+ */
+import { readText, writeText, readJson, writeJson } from '../utils/file.js';
+import { ensureDir } from '../utils/file.js';
+import { dirname } from 'path';
+import { join } from 'path';
+import { existsSync } from 'fs';
+import { appendFile } from 'fs/promises';
+import { withFileLock } from '../utils/lock.js';
+const MAILBOX_DIR = '.webforge/mailboxes';
+/**
+ * 邮箱管理器
+ */
+export class Mailbox {
+    workerId;
+    basePath;
+    mailboxPath;
+    statePath;
+    mailboxLockPath;
+    constructor(workerId, basePath = process.cwd()) {
+        this.workerId = workerId;
+        this.basePath = basePath;
+        this.mailboxPath = join(basePath, MAILBOX_DIR, `${workerId}.jsonl`);
+        this.statePath = join(basePath, MAILBOX_DIR, '.state', `${workerId}.json`);
+        this.mailboxLockPath = join(basePath, MAILBOX_DIR, '.locks', `${workerId}.lock`);
+    }
+    /**
+     * 初始化邮箱
+     */
+    async init() {
+        await ensureDir(join(this.basePath, MAILBOX_DIR));
+        await ensureDir(dirname(this.statePath));
+        await ensureDir(dirname(this.mailboxLockPath));
+    }
+    /**
+     * 发送消息到指定 Worker
+     */
+    async send(to, type, content, options) {
+        const message = {
+            id: this.generateMessageId(),
+            from: this.workerId,
+            to,
+            type,
+            content,
+            task_id: options?.taskId,
+            timestamp: new Date().toISOString(),
+            read: false,
+            metadata: options?.metadata
+        };
+        const targetMailbox = join(this.basePath, MAILBOX_DIR, `${to}.jsonl`);
+        const targetLock = join(this.basePath, MAILBOX_DIR, '.locks', `${to}.lock`);
+        await withFileLock(targetLock, async () => {
+            await this.appendMessage(targetMailbox, message);
+        });
+        return message;
+    }
+    /**
+     * 广播消息给所有 Worker
+     */
+    async broadcast(type, content, recipients, options) {
+        const messages = [];
+        for (const recipient of recipients) {
+            if (recipient !== this.workerId) {
+                const msg = await this.send(recipient, type, content, options);
+                messages.push(msg);
+            }
+        }
+        return messages;
+    }
+    /**
+     * 接收消息
+     */
+    async receive(options) {
+        if (options?.markAsRead) {
+            return withFileLock(this.mailboxLockPath, async () => {
+                const messages = await this.loadMessages();
+                const filtered = options?.unreadOnly
+                    ? messages.filter(message => !message.read)
+                    : messages;
+                const limit = options?.limit ?? 10;
+                const result = filtered.slice(-limit);
+                const unreadIds = result
+                    .filter(message => !message.read)
+                    .map(message => message.id);
+                if (unreadIds.length > 0) {
+                    await this.markMessageIdsAsRead(unreadIds);
+                    for (const msg of result) {
+                        msg.read = true;
+                    }
+                }
+                return result;
+            });
+        }
+        const messages = await this.loadMessages();
+        let filtered = messages;
+        if (options?.unreadOnly) {
+            filtered = filtered.filter(m => !m.read);
+        }
+        const limit = options?.limit ?? 10;
+        return filtered.slice(-limit);
+    }
+    /**
+     * 等待特定类型的消息
+     */
+    async waitFor(type, options) {
+        const timeout = options?.timeout ?? 30000;
+        const startTime = Date.now();
+        while (Date.now() - startTime < timeout) {
+            const match = await withFileLock(this.mailboxLockPath, async () => {
+                const messages = await this.loadMessages();
+                const unread = messages.filter(message => !message.read);
+                const found = unread.find(message => {
+                    if (message.type !== type)
+                        return false;
+                    if (options?.from && message.from !== options.from)
+                        return false;
+                    if (options?.taskId && message.task_id !== options.taskId)
+                        return false;
+                    return true;
+                });
+                if (!found) {
+                    return null;
+                }
+                await this.markMessageIdsAsRead([found.id]);
+                return {
+                    ...found,
+                    read: true
+                };
+            });
+            if (match) {
+                return match;
+            }
+            // 等待一段时间后重试
+            await sleep(1000);
+        }
+        return null;
+    }
+    /**
+     * 获取未读消息数量
+     */
+    async getUnreadCount() {
+        const messages = await this.loadMessages();
+        return messages.filter(m => !m.read).length;
+    }
+    /**
+     * 清空邮箱
+     */
+    async clear() {
+        await withFileLock(this.mailboxLockPath, async () => {
+            await writeText(this.mailboxPath, '');
+            await this.saveReadState({ readMessageIds: [] });
+        });
+    }
+    // ==================== 私有方法 ====================
+    async loadMessages() {
+        try {
+            const content = await readText(this.mailboxPath);
+            const lines = content.trim().split('\n').filter(Boolean);
+            const readState = await this.loadReadState();
+            const readIds = new Set(readState.readMessageIds);
+            return lines.map(line => {
+                const message = JSON.parse(line);
+                return {
+                    ...message,
+                    read: message.read === true || readIds.has(message.id)
+                };
+            });
+        }
+        catch {
+            return [];
+        }
+    }
+    async appendMessage(path, message) {
+        const line = JSON.stringify(message) + '\n';
+        await ensureDir(dirname(path));
+        await appendFile(path, line, 'utf-8');
+    }
+    async markMessageIdsAsRead(ids) {
+        if (ids.length === 0) {
+            return;
+        }
+        const current = await this.loadReadState();
+        const merged = new Set(current.readMessageIds);
+        for (const id of ids) {
+            merged.add(id);
+        }
+        await this.saveReadState({ readMessageIds: Array.from(merged) });
+    }
+    async loadReadState() {
+        try {
+            if (!existsSync(this.statePath)) {
+                return { readMessageIds: [] };
+            }
+            const state = await readJson(this.statePath);
+            if (!Array.isArray(state.readMessageIds)) {
+                return { readMessageIds: [] };
+            }
+            return state;
+        }
+        catch {
+            return { readMessageIds: [] };
+        }
+    }
+    async saveReadState(state) {
+        await writeJson(this.statePath, state);
+    }
+    generateMessageId() {
+        return `msg-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+    }
+}
+/**
+ * 睡眠函数
+ */
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * 获取所有 Worker 的邮箱
+ */
+export async function getAllMailboxes(workerIds, basePath) {
+    return workerIds.map(id => new Mailbox(id, basePath));
+}
+//# sourceMappingURL=mailbox.js.map

package/dist/core/mailbox.js.map

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

package/dist/core/planning.d.ts

@@ -0,0 +1,110 @@
+import type { Phase, Task } from '../types/index.js';
+export { buildExecutionContext } from './context.js';
+export interface PlanOptions {
+    template?: string;
+    force?: boolean;
+    superpowers?: boolean;
+    execution?: 'subagent' | 'inline';
+    techStack?: TechStack;
+    resolveTechStack?: (analysis: KnowledgeAnalysis) => Promise<TechStack | undefined>;
+}
+export interface TechStack {
+    backend: string;
+    frontend: string;
+    database: string;
+    infrastructure: string[];
+}
+export interface KnowledgeAnalysis {
+    documents: string[];
+    contents: Record<string, string>;
+    projectType?: string;
+    keywords: string[];
+    techStack: string[];
+}
+export interface PlanningResult {
+    phases: Phase[];
+    tasks: Task[];
+    analysis: KnowledgeAnalysis;
+    requiredSkills: string[];
+    template: string;
+    techStack: TechStack;
+    reusedExistingPlan: boolean;
+    planDocumentPath?: string;
+}
+interface SkillCatalogEntry {
+    name: string;
+    patterns: string[];
+    description: string;
+    category: 'frontend' | 'backend' | 'database' | 'language' | 'testing' | 'document' | 'ai' | 'other';
+    priority: number;
+}
+export declare const TECH_STACK_OPTIONS: {
+    readonly backend: readonly [{
+        readonly name: "Node.js + TypeScript + NestJS";
+        readonly value: "nodejs-nestjs";
+        readonly skills: readonly ["backend-patterns", "tdd-workflow"];
+    }, {
+        readonly name: "Go + Gin";
+        readonly value: "go-gin";
+        readonly skills: readonly ["golang-patterns", "backend-patterns"];
+    }, {
+        readonly name: "Java + Spring Boot";
+        readonly value: "java-spring";
+        readonly skills: readonly ["backend-patterns"];
+    }, {
+        readonly name: "Python + FastAPI";
+        readonly value: "python-fastapi";
+        readonly skills: readonly ["backend-patterns"];
+    }];
+    readonly frontend: readonly [{
+        readonly name: "Vue 3 + TypeScript";
+        readonly value: "vue3";
+        readonly skills: readonly ["vue-best-practices", "frontend-design"];
+    }, {
+        readonly name: "React 18 + TypeScript";
+        readonly value: "react";
+        readonly skills: readonly ["frontend-design"];
+    }, {
+        readonly name: "Angular";
+        readonly value: "angular";
+        readonly skills: readonly ["frontend-design"];
+    }];
+    readonly database: readonly [{
+        readonly name: "PostgreSQL";
+        readonly value: "postgresql";
+        readonly skills: readonly ["postgres-patterns"];
+    }, {
+        readonly name: "MySQL";
+        readonly value: "mysql";
+        readonly skills: readonly [];
+    }, {
+        readonly name: "MongoDB";
+        readonly value: "mongodb";
+        readonly skills: readonly [];
+    }, {
+        readonly name: "PostgreSQL + Redis";
+        readonly value: "postgres-redis";
+        readonly skills: readonly ["postgres-patterns"];
+    }];
+    readonly infrastructure: readonly [{
+        readonly name: "Docker";
+        readonly value: "docker";
+        readonly skills: readonly [];
+    }, {
+        readonly name: "Docker + Kubernetes";
+        readonly value: "docker-k8s";
+        readonly skills: readonly [];
+    }, {
+        readonly name: "AWS";
+        readonly value: "aws";
+        readonly skills: readonly [];
+    }, {
+        readonly name: "阿里云";
+        readonly value: "aliyun";
+        readonly skills: readonly [];
+    }];
+};
+export declare const AVAILABLE_SKILLS: Record<string, SkillCatalogEntry>;
+export declare function buildPlanFromKnowledge(basePath: string, options?: PlanOptions): Promise<PlanningResult>;
+export declare function getTechStackName(category: keyof typeof TECH_STACK_OPTIONS, value: string): string;
+//# sourceMappingURL=planning.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"planning.d.ts","sourceRoot":"","sources":["../../src/core/planning.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAgC,MAAM,mBAAmB,CAAC;AAEnF,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;IAClC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,gBAAgB,CAAC,EAAE,CACjB,QAAQ,EAAE,iBAAiB,KACxB,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,SAAS,CAAC;IACrB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EACJ,UAAU,GACV,SAAS,GACT,UAAU,GACV,UAAU,GACV,SAAS,GACT,UAAU,GACV,IAAI,GACJ,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwBrB,CAAC;AAEX,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAiH9D,CAAC;AAEF,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,cAAc,CAAC,CAsEzB;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,OAAO,kBAAkB,EACzC,KAAK,EAAE,MAAM,GACZ,MAAM,CAGR"}