opc-agent 4.2.13 → 5.0.0-alpha.1

package/TASK.md

@@ -0,0 +1,49 @@
+# Task: E2E 跑通 — opc init → opc run → opc studio
+
+目标：让 v2 代码真正能跑起来，不是只编译通过。
+
+## 测试流程
+在一个干净的临时目录里执行：
+
+```bash
+mkdir /tmp/opc-e2e-test && cd /tmp/opc-e2e-test
+node C:\Users\mingjwan\opc-agent\dist\cli.js init --yes
+node C:\Users\mingjwan\opc-agent\dist\cli.js studio
+# Studio 应该在 localhost:4000 启动
+```
+
+## 需要修复的问题
+
+### 1. opc init
+确保 init 命令能正常运行：
+- 创建 EGO.md（如果用户没有 SOUL.md 也没有 EGO.md）
+- 创建 DEEPBRAIN.md（或兼容已有 MEMORY.md）
+- 创建 .opc/ 目录
+- 创建 oad.yaml 配置文件
+- 如果有 SOUL.md/MEMORY.md 不要覆盖，保持兼容
+
+### 2. opc studio
+确保 studio 命令能启动 Express server：
+- server.ts 中的 StudioServer class 必须有 start() 方法
+- 绑定端口 4000
+- 返回 studio-ui/index.html 
+- API routes: /api/agents, /api/models, /api/brain/stats 等
+- 不要因为 Ollama 不可用就崩溃
+
+### 3. opc chat
+确保 TUI 聊天能工作（至少不崩溃）：
+- 读取 EGO.md/DEEPBRAIN.md
+- 初始化 DeepBrain
+- 连接 model provider（Ollama 优先，不可用就报错提示）
+- readline 循环
+
+### 4. opc brain recall/stats
+- brain recall "test" → 应该返回空结果（新数据库）
+- brain stats → 应该返回 {total: 0, byLayer: {}, bySource: {}}
+
+## 关键约束
+- 不要改 tsconfig.json
+- 修复运行时错误（import 路径、missing exports、undefined 变量等）
+- 每修一个问题就重新 build (`npx tsc`) 验证
+- 最终 `npx tsc` 零报错 + 上述 4 个命令都能跑
+- 完成后 git commit

package/dist/channels/api.d.ts

@@ -0,0 +1,14 @@
+import type { ApiChannelConfig, IChannel, Message } from '../core/types';
+export declare class ApiChannel implements IChannel {
+    private config;
+    readonly type = "api";
+    private app;
+    private handler?;
+    private server?;
+    constructor(config: ApiChannelConfig);
+    private setupRoutes;
+    onMessage(handler: (msg: Message) => Promise<Message>): void;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/channels/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/channels/api.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAIzE,qBAAa,UAAW,YAAW,QAAQ;IAM7B,OAAO,CAAC,MAAM;IAL1B,QAAQ,CAAC,IAAI,SAAS;IACtB,OAAO,CAAC,GAAG,CAAU;IACrB,OAAO,CAAC,OAAO,CAAC,CAAqC;IACrD,OAAO,CAAC,MAAM,CAAC,CAAgC;gBAE3B,MAAM,EAAE,gBAAgB;IAM5C,OAAO,CAAC,WAAW;IAiBnB,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI;IAItD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAOtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAM5B"}

package/dist/channels/api.js

@@ -0,0 +1,58 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiChannel = void 0;
+const express_1 = __importDefault(require("express"));
+class ApiChannel {
+    config;
+    type = 'api';
+    app;
+    handler;
+    server;
+    constructor(config) {
+        this.config = config;
+        this.app = (0, express_1.default)();
+        this.app.use(express_1.default.json());
+        this.setupRoutes();
+    }
+    setupRoutes() {
+        const base = this.config.basePath ?? '/api';
+        this.app.post(`${base}/chat`, async (req, res) => {
+            if (!this.handler) {
+                res.status(503).json({ error: 'no handler' });
+                return;
+            }
+            try {
+                const msg = { id: Date.now().toString(), role: 'user', content: req.body.content ?? '', timestamp: Date.now() };
+                const reply = await this.handler(msg);
+                res.json(reply);
+            }
+            catch (err) {
+                res.status(500).json({ error: String(err) });
+            }
+        });
+        this.app.get(`${base}/health`, (_req, res) => { res.json({ status: 'ok' }); });
+    }
+    onMessage(handler) {
+        this.handler = handler;
+    }
+    async start() {
+        const port = this.config.port ?? 8080;
+        return new Promise((resolve) => {
+            this.server = this.app.listen(port, resolve);
+        });
+    }
+    async stop() {
+        return new Promise((resolve, reject) => {
+            if (!this.server) {
+                resolve();
+                return;
+            }
+            this.server.close((err) => (err ? reject(err) : resolve()));
+        });
+    }
+}
+exports.ApiChannel = ApiChannel;
+//# sourceMappingURL=api.js.map

package/dist/channels/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/channels/api.ts"],"names":[],"mappings":";;;;;;AAEA,sDAA8B;AAG9B,MAAa,UAAU;IAMD;IALX,IAAI,GAAG,KAAK,CAAC;IACd,GAAG,CAAU;IACb,OAAO,CAAsC;IAC7C,MAAM,CAAiC;IAE/C,YAAoB,MAAwB;QAAxB,WAAM,GAAN,MAAM,CAAkB;QAC1C,IAAI,CAAC,GAAG,GAAG,IAAA,iBAAO,GAAE,CAAC;QACrB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,iBAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7B,IAAI,CAAC,WAAW,EAAE,CAAC;IACrB,CAAC;IAEO,WAAW;QACjB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC;QAE5C,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;YAC/C,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;gBAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;gBAAC,OAAO;YAAC,CAAC;YAC7E,IAAI,CAAC;gBACH,MAAM,GAAG,GAAY,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;gBACzH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBACtC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,SAAS,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjF,CAAC;IAED,SAAS,CAAC,OAA2C;QACnD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC;QACtC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBAAC,OAAO,EAAE,CAAC;gBAAC,OAAO;YAAC,CAAC;YACxC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AA9CD,gCA8CC"}

package/dist/cli.js

@@ -244,6 +244,10 @@ spec:
         // CONTEXT.md
         const readmeContent = roleData.files['README.md'] || '';
         fs.writeFileSync(path.join(dir, 'CONTEXT.md'), `# Project Context\n\n## Role: ${roleDisplayName}\n\n${readmeContent}\n`);
+        // .opc/ directory — runtime state
+        fs.mkdirSync(path.join(dir, '.opc'), { recursive: true });
+        // DEEPBRAIN.md — long-term memory seed
+        fs.writeFileSync(path.join(dir, 'DEEPBRAIN.md'), `# DeepBrain Memory\n\nThis file seeds the agent's long-term knowledge store.\n`);
         // data/brain-seed.md if available
         if (roleData.files['brain-seed.md']) {
             fs.writeFileSync(path.join(dir, 'data', 'brain-seed.md'), roleData.files['brain-seed.md']);
@@ -774,6 +778,18 @@ on startup to understand the project context.
 - Add domain knowledge here
 - Add FAQ items here
 - Add company policies here
+`);
+    // .opc/ directory — runtime state (brain DB, cache, etc.)
+    fs.mkdirSync(path.join(dir, '.opc'), { recursive: true });
+    // DEEPBRAIN.md — long-term memory seed (compat with MEMORY.md)
+    fs.writeFileSync(path.join(dir, 'DEEPBRAIN.md'), `# DeepBrain Memory
+
+This file seeds the agent's long-term knowledge store (DeepBrain).
+Add knowledge entries below — they will be loaded on first run.
+
+## Core Knowledge
+
+<!-- Add domain knowledge, FAQs, policies, etc. here -->
 `);
     console.log(`\n${icon.success} Created agent project: ${color.bold(name + '/')}`);
     console.log(`   ${icon.file} oad.yaml         - Agent 配置 (${llmProvider}/${llmModel})`);
@@ -782,6 +798,8 @@ on startup to understand the project context.
     console.log(`   ${icon.file} src/skills/echo.ts - Example skill`);
     console.log(`   ${icon.file} SOUL.md          - Agent personality`);
     console.log(`   ${icon.file} CONTEXT.md       - Project context`);
+    console.log(`   ${icon.file} DEEPBRAIN.md     - Long-term memory seed`);
+    console.log(`   ${icon.file} .opc/            - Runtime state directory`);
     console.log(`   ${icon.file} package.json     - Dependencies`);
     console.log(`   ${icon.file} tsconfig.json    - TypeScript config`);
     console.log(`   ${icon.file} .env.example     - Environment template`);
@@ -1532,65 +1550,89 @@ protocolCmd.command('disable')
 // 🔄 Migrate command ────────────────────────────────────────
 program
     .command('migrate')
-    .description('Migrate OAD to latest schema version')
+    .description('Migrate project: MEMORY.md → DEEPBRAIN.md and OAD to latest schema')
     .option('-f, --file <file>', 'OAD file', 'oad.yaml')
     .option('--dry-run', 'Show changes without writing')
+    .option('--schema-only', 'Only migrate OAD schema (skip MEMORY.md → DEEPBRAIN.md)')
     .action(async (opts) => {
+    // Step 1: MEMORY.md → DEEPBRAIN.md migration
+    if (!opts.schemaOnly) {
+        console.log(`\n${icon.gear} ${color.bold('DeepBrain Migration')} (MEMORY.md → DEEPBRAIN.md)\n`);
+        try {
+            if (opts.dryRun) {
+                const memExists = fs.existsSync(path.join(process.cwd(), 'MEMORY.md'));
+                const soulExists = fs.existsSync(path.join(process.cwd(), 'SOUL.md'));
+                const dbExists = fs.existsSync(path.join(process.cwd(), '.opc', 'brain.db'));
+                console.log(`  MEMORY.md:    ${memExists ? color.cyan('found — would migrate to DEEPBRAIN.md') : color.dim('not found')}`);
+                console.log(`  SOUL.md:      ${soulExists ? color.cyan('found — would migrate to EGO.md') : color.dim('not found')}`);
+                console.log(`  .opc/brain.db:${dbExists ? color.dim(' already exists') : color.cyan(' would create')}`);
+                console.log(`\n  ${icon.info} Dry run — no changes.\n`);
+            }
+            else {
+                const { migrate: deepbrainMigrate } = require('./deepbrain/migrate');
+                await deepbrainMigrate(process.cwd());
+                console.log(`  ${icon.success} MEMORY.md → DEEPBRAIN.md migration complete.`);
+                console.log(`  ${icon.success} SOUL.md → EGO.md migration complete.`);
+                console.log(`  ${icon.success} Knowledge seeded into .opc/brain.db.\n`);
+            }
+        }
+        catch (e) {
+            console.log(`  ${icon.warn} DeepBrain migration: ${e.message}\n`);
+        }
+    }
+    // Step 2: OAD schema migration
+    console.log(`${icon.gear} ${color.bold('OAD Schema Migration')}\n`);
     try {
         const raw = fs.readFileSync(opts.file, 'utf-8');
         const config = yaml.load(raw);
         let changed = false;
-        // Migration: add apiVersion if missing
         if (!config.apiVersion) {
             config.apiVersion = 'opc/v1';
             changed = true;
         }
-        // Migration: add kind if missing
         if (!config.kind) {
             config.kind = 'Agent';
             changed = true;
         }
-        // Migration: ensure metadata.version
         if (!config.metadata?.version) {
             if (!config.metadata)
                 config.metadata = {};
             config.metadata.version = '1.0.0';
             changed = true;
         }
-        // Migration: ensure spec.channels is array
         if (config.spec?.channels && !Array.isArray(config.spec.channels)) {
             config.spec.channels = [config.spec.channels];
             changed = true;
         }
-        // Migration: ensure spec.skills is array
         if (config.spec?.skills && !Array.isArray(config.spec.skills)) {
             config.spec.skills = [config.spec.skills];
             changed = true;
         }
-        // Migration: old model format
         if (config.spec?.llm?.model && !config.spec?.model) {
             config.spec.model = config.spec.llm.model;
             delete config.spec.llm;
             changed = true;
         }
         if (!changed) {
-            console.log(`${icon.success} OAD is already up to date.`);
-            return;
+            console.log(`  ${icon.success} OAD is already up to date.\n`);
         }
-        if (opts.dryRun) {
-            console.log(`\n${icon.info} Would migrate:\n`);
+        else if (opts.dryRun) {
+            console.log(`  ${icon.info} Would migrate:\n`);
             console.log(yaml.dump(config, { lineWidth: 120 }));
         }
         else {
-            // Backup
             fs.writeFileSync(opts.file + '.bak', raw);
             fs.writeFileSync(opts.file, yaml.dump(config, { lineWidth: 120 }));
-            console.log(`${icon.success} Migrated ${color.bold(opts.file)} (backup: ${opts.file}.bak)`);
+            console.log(`  ${icon.success} Migrated ${color.bold(opts.file)} (backup: ${opts.file}.bak)\n`);
         }
     }
     catch (err) {
-        console.error(`${icon.error} Migration failed:`, err instanceof Error ? err.message : err);
-        process.exit(1);
+        if (err.code !== 'ENOENT') {
+            console.error(`  ${icon.error} OAD migration failed:`, err instanceof Error ? err.message : err);
+        }
+        else {
+            console.log(`  ${color.dim(`No OAD file found (${opts.file}) — skipping schema migration.`)}\n`);
+        }
     }
 });
 // ── Brain command ────────────────────────────────────────────
@@ -1701,6 +1743,58 @@ brainCmd
     }
     console.log();
 });
+brainCmd
+    .command('recall')
+    .argument('<query>', 'Search query')
+    .description('Query DeepBrain knowledge base')
+    .option('--top-k <n>', 'Number of results', '5')
+    .option('--layer <layer>', 'Filter by layer (l1/l2/l3/l4/workstation/job/industry)')
+    .action(async (query, opts) => {
+    console.log(`\n${icon.search} ${color.bold('DeepBrain Recall')} — ${color.cyan(query)}\n`);
+    try {
+        const { DeepBrain } = require('./deepbrain/provider');
+        const brain = new DeepBrain({ dbPath: path.join(process.cwd(), '.opc', 'brain.db'), embeddingProvider: 'none' });
+        await brain.init();
+        const result = await brain.recall({ query, topK: parseInt(opts.topK) || 5, layer: opts.layer });
+        if (result.entries.length === 0) {
+            console.log(`  ${icon.info} No results found.\n`);
+            return;
+        }
+        for (const entry of result.entries) {
+            console.log(`  ${color.cyan(`[${entry.layer}]`)} ${color.dim(entry.source)} — maturity: ${entry.maturityScore.toFixed(2)}`);
+            const preview = entry.content.length > 200 ? entry.content.slice(0, 200) + '…' : entry.content;
+            console.log(`  ${preview}`);
+            console.log();
+        }
+        console.log(`  ${color.dim(`${result.entries.length} result(s) in ${result.elapsedMs}ms`)}\n`);
+    }
+    catch (e) {
+        console.log(`  ${icon.warn} ${e.message}\n`);
+    }
+});
+brainCmd
+    .command('stats')
+    .description('Show DeepBrain knowledge base statistics')
+    .action(async () => {
+    console.log(`\n${icon.gear} ${color.bold('DeepBrain Stats')}\n`);
+    try {
+        const { DeepBrain } = require('./deepbrain/provider');
+        const brain = new DeepBrain({ dbPath: path.join(process.cwd(), '.opc', 'brain.db'), embeddingProvider: 'none' });
+        await brain.init();
+        const stats = await brain.getStats();
+        console.log(`  ${color.cyan('Total Entries'.padEnd(18))}  ${stats.totalEntries}`);
+        const layers = stats.entriesByLayer;
+        for (const [layer, count] of Object.entries(layers)) {
+            console.log(`  ${color.cyan(layer.padEnd(18))}  ${count}`);
+        }
+        console.log(`  ${color.cyan('Avg Maturity'.padEnd(18))}  ${(stats.avgMaturityScore ?? 0).toFixed(3)}`);
+        console.log(`  ${color.cyan('Last Evolution'.padEnd(18))}  ${stats.lastEvolution ?? 'never'}`);
+        console.log();
+    }
+    catch (e) {
+        console.log(`  ${icon.warn} ${e.message}\n`);
+    }
+});
 // ── Logs command ─────────────────────────────────────────────
 program
     .command('logs')
@@ -2108,6 +2202,7 @@ program
         catch { }
     }
     console.log(color.dim('Press Ctrl+C to stop'));
+    await new Promise(() => { });
 });
 program
     .command('doctor')
@@ -2316,43 +2411,6 @@ program
     }
     console.log();
 });
-// ── Search command ──────────────────────────────────────────
-program
-    .command('memory-search <query>')
-    .description('Search conversation history (requires SQLite memory)')
-    .option('-n, --limit <n>', 'Max results', '10')
-    .option('--json', 'Output as JSON')
-    .action(async (query, opts) => {
-    try {
-        const { SQLiteStore } = await Promise.resolve().then(() => __importStar(require('./memory/sqlite-store')));
-        const store = new SQLiteStore();
-        const results = await store.search(query, parseInt(opts.limit, 10));
-        const stats = await store.stats();
-        if (opts.json) {
-            console.log(JSON.stringify({ query, results, stats }, null, 2));
-            await store.close();
-            return;
-        }
-        console.log(`\n🔍 搜索: "${query}" (${results.length} 条结果, 共 ${stats.totalMessages} 条消息)\n`);
-        if (results.length === 0) {
-            console.log('  未找到匹配结果。\n');
-            await store.close();
-            return;
-        }
-        for (const msg of results) {
-            const time = new Date(msg.timestamp).toLocaleString();
-            const role = msg.role === 'user' ? '👤' : '🤖';
-            const preview = msg.content.length > 120 ? msg.content.slice(0, 120) + '...' : msg.content;
-            console.log(`  ${role} [${time}] ${preview}`);
-        }
-        console.log(`\n  💾 数据库: ${stats.dbSizeKB}KB, ${stats.sessions} 个会话\n`);
-        await store.close();
-    }
-    catch (err) {
-        console.error(`${icon.error} 搜索失败: ${err instanceof Error ? err.message : err}`);
-        console.log('  提示: 需要 sql.js 支持。运行: npm install sql.js');
-    }
-});
 // ── Keys command ──────────────────────────────────────────────
 const keys_1 = require("./security/keys");
 const approval_1 = require("./security/approval");
@@ -2661,6 +2719,40 @@ mcpCmd
         await server.serveStdio();
     }
 });
+// ── Memory Search command ────────────────────────────────────
+program
+    .command('memory-search')
+    .argument('<query>', 'Search query')
+    .description('Search agent memory (DeepBrain knowledge base)')
+    .option('--top-k <n>', 'Number of results', '5')
+    .option('--json', 'Output as JSON')
+    .action(async (query, opts) => {
+    try {
+        const { DeepBrain } = require('./deepbrain/provider');
+        const brain = new DeepBrain({ dbPath: path.join(process.cwd(), '.opc', 'brain.db'), embeddingProvider: 'none' });
+        await brain.init();
+        const result = await brain.recall({ query, topK: parseInt(opts.topK) || 5 });
+        if (opts.json) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        console.log(`\n${icon.search} ${color.bold('Memory Search')} — ${color.cyan(query)}\n`);
+        if (result.entries.length === 0) {
+            console.log(`  ${icon.info} No results found.\n`);
+            return;
+        }
+        for (const entry of result.entries) {
+            console.log(`  ${color.cyan(`[${entry.layer}]`)} ${color.dim(entry.source)}`);
+            const preview = entry.content.length > 200 ? entry.content.slice(0, 200) + '…' : entry.content;
+            console.log(`  ${preview}\n`);
+        }
+        console.log(`  ${color.dim(`${result.entries.length} result(s) in ${result.elapsedMs}ms`)}\n`);
+    }
+    catch (e) {
+        console.error(`${icon.error} Memory search failed: ${e.message}`);
+        process.exit(1);
+    }
+});
 // ── Parse CLI ────────────────────────────────────────────────
 program.parse();
 //# sourceMappingURL=cli.js.map