autosnippet 3.2.21 → 3.3.2

package/dist/bin/cli.js

@@ -10,12 +10,12 @@
  *   asd search <query>  - 搜索知识库
  *   asd guard <file>    - Guard 检查
  *   asd guard:ci [path] - CI/CD Guard 合规检查
- *   asd watch           - 文件监控
  *   asd server          - 启动 API 服务
  *   asd ui              - 启动 Dashboard UI
  *   asd upgrade         - 升级 IDE 集成
  *   asd mirror          - 镜像 .cursor/ → .qoder/ .trae/
  *   asd status          - 环境状态
+ *   asd health          - 综合健康报告
  */
 import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, } from 'node:fs';
 import { join, resolve } from 'node:path';
@@ -476,6 +476,8 @@ program
     .option('--fail-on-error', '有 error 级违规时 exit 1', true)
     .option('--fail-on-warning', '超过 warning 阈值时 exit 2')
     .option('--max-warnings <n>', 'warning 阈值', '20')
+    .option('--max-uncertain <n>', 'uncertain 条目阈值 (超出时 exit 2)', '50')
+    .option('--min-coverage <n>', '最低覆盖率 (0-100，低于时 exit 3)', '0')
     .option('--report <format>', '报告格式: json | text | markdown', 'text')
     .option('--output <file>', '报告输出文件')
     .option('--min-score <n>', 'Quality Gate 最低分', '70')
@@ -514,10 +516,18 @@ program
             writeFileSync(opts.output, JSON.stringify(report, null, 2), 'utf8');
         }
         await bootstrap.shutdown();
-        // Exit code
+        // Exit code: 0=PASS, 1=FAIL(violations), 2=WARN(uncertain/warnings), 3=FAIL(coverage)
+        const maxUncertain = parseInt(opts.maxUncertain, 10);
+        const minCoverage = parseInt(opts.minCoverage, 10);
         if (report.qualityGate.status === 'FAIL') {
             process.exit(report.summary.errors > 0 ? 1 : 2);
         }
+        if (minCoverage > 0 && (report.coverageScore ?? 100) < minCoverage) {
+            process.exit(3);
+        }
+        if (maxUncertain > 0 && (report.uncertainSummary?.total ?? 0) > maxUncertain) {
+            process.exit(2);
+        }
         process.exit(0);
     }
     catch (err) {
@@ -605,45 +615,78 @@ program
     }
 });
 // ─────────────────────────────────────────────────────
-// watch 命令
+// panorama 命令
 // ─────────────────────────────────────────────────────
 program
-    .command('watch')
-    .option('-d, --dir <path>', '监控目录', '.')
-    .option('-e, --ext <exts>', '文件扩展名（逗号分隔，留空则自动检测）')
-    .option('--guard', '自动运行 Guard 检查', true)
-    .action(async (opts) => {
+    .command('panorama [path]')
+    .description('项目全景分析：架构层级、覆盖率、知识空白')
+    .option('--json', '以 JSON 格式输出')
+    .option('--gaps', '仅显示知识空白区')
+    .option('--health', '仅显示健康度评分')
+    .action(async (scanPath, opts) => {
     try {
-        const dir = resolve(opts.dir);
-        let bootstrap;
-        try {
-            const result = await initContainer({ projectRoot: dir });
-            bootstrap = result.bootstrap;
+        const projectRoot = resolve(scanPath || '.');
+        const { bootstrap, container } = await initContainer({ projectRoot });
+        const panoramaService = container.get('panoramaService');
+        if (opts.gaps) {
+            const gaps = panoramaService.getGaps();
+            if (opts.json) {
+                cli.log(JSON.stringify(gaps, null, 2));
+            }
+            else {
+                cli.log(`\n🔍 Knowledge Gaps: ${gaps.length} found\n`);
+                for (const g of gaps.slice(0, 20)) {
+                    const priority = g.priority === 'high' ? '🔴' : g.priority === 'medium' ? '🟡' : '🔵';
+                    cli.log(`  ${priority} [${g.dimensionName}] ${g.recipeCount} recipes (${g.status}) — ${g.suggestedTopics.join(', ')}`);
+                }
+                if (gaps.length > 20) {
+                    cli.log(`\n  ... and ${gaps.length - 20} more gaps`);
+                }
+            }
+            await bootstrap.shutdown();
+            return;
         }
-        catch {
-            // ServiceContainer 初始化失败不阻塞 watch（HTTP fallback 仍可用）
-            bootstrap = await initBootstrap();
-        }
-        const Paths = await import('../lib/infrastructure/config/Paths.js');
-        const specPath = Paths.getProjectSpecPath(dir);
-        // IDE + 扩展名自动检测
-        let exts = null;
-        if (opts.ext) {
-            exts = opts.ext.split(',').map((e) => e.trim());
-        }
-        // 不指定 --ext 时，FileWatcher 内部根据 IDE 检测结果使用默认模式
-        const { FileWatcher } = await import('../lib/service/automation/FileWatcher.js');
-        const watcher = new FileWatcher(specPath, dir, {
-            quiet: false,
-            exts,
-        });
-        watcher.start();
-        // 优雅退出
-        process.on('SIGINT', async () => {
-            await watcher.stop();
+        if (opts.health) {
+            const health = panoramaService.getHealth();
+            if (opts.json) {
+                cli.log(JSON.stringify(health, null, 2));
+            }
+            else {
+                const icon = health.healthScore >= 80 ? '✅' : health.healthScore >= 50 ? '⚠️' : '❌';
+                cli.log(`\n${icon} Panorama Health: ${health.healthScore}/100\n`);
+                cli.log(`  Dimension Coverage: ${health.healthRadar.dimensionCoverage}%`);
+                cli.log(`  Avg Coupling: ${health.avgCoupling}`);
+                cli.log(`  Modules:      ${health.moduleCount}`);
+                cli.log(`  Cycles:       ${health.cycleCount}`);
+                cli.log(`  Gaps:         ${health.gapCount} (${health.highPriorityGaps} high-priority)`);
+            }
             await bootstrap.shutdown();
-            process.exit(0);
-        });
+            return;
+        }
+        // 默认: 全景概览
+        const overview = panoramaService.getOverview();
+        if (opts.json) {
+            cli.log(JSON.stringify(overview, null, 2));
+        }
+        else {
+            cli.log(`\n📐 Panorama Overview\n`);
+            cli.log(`  Project:  ${overview.projectRoot}`);
+            cli.log(`  Modules:  ${overview.moduleCount}`);
+            cli.log(`  Layers:   ${overview.layerCount}`);
+            cli.log(`  Files:    ${overview.totalFiles}`);
+            cli.log(`  Recipes:  ${overview.totalRecipes}`);
+            cli.log(`  Coverage: ${overview.overallCoverage}%`);
+            cli.log(`  Cycles:   ${overview.cycleCount}`);
+            cli.log(`  Gaps:     ${overview.gapCount}`);
+            if (overview.layers && overview.layers.length > 0) {
+                cli.log(`\n  Layers:`);
+                for (const layer of overview.layers) {
+                    const totalFiles = layer.modules.reduce((sum, m) => sum + m.fileCount, 0);
+                    cli.log(`    ${layer.name}: ${layer.modules.length} modules, ${totalFiles} files`);
+                }
+            }
+        }
+        await bootstrap.shutdown();
     }
     catch (err) {
         cli.error(`Error: ${err.message}`);
@@ -766,91 +809,6 @@ program
             cli.warn(`⚠️  SignalCollector failed to start: ${scErr.message}`);
             cli.debug(scErr.stack);
         }
-        // 3. 启动文件监听器（仅 iOS/macOS 项目 — Xcode 工作流）
-        //    VSCode 用户通过 AutoSnippet 扩展原生处理 as:s/as:c/as:a 指令
-        const isAppleProject = (() => {
-            try {
-                const entries = readdirSync(projectRoot, { withFileTypes: true });
-                // ── Level 1: 项目配置文件（确定性高）──
-                const hasAppleConfig = entries.some((e) => e.name === 'Package.swift' || // SPM
-                    e.name === 'Podfile' || // CocoaPods
-                    e.name === 'Cartfile' || // Carthage
-                    e.name === 'project.yml' || // XcodeGen
-                    e.name.endsWith('.xcodeproj') || // Xcode project
-                    e.name.endsWith('.xcworkspace') // Xcode workspace
-                );
-                if (hasAppleConfig) {
-                    return true;
-                }
-                // ── Level 2: 目录结构特征 ──
-                const hasAppleDir = entries.some((e) => e.isDirectory() &&
-                    (e.name === 'Tuist' || // Tuist 项目
-                        e.name === 'Pods' || // CocoaPods 产物
-                        e.name === 'Carthage' || // Carthage 产物
-                        e.name === 'DerivedData') // Xcode 构建产物
-                );
-                if (hasAppleDir) {
-                    return true;
-                }
-                // ── Level 3: 向下扫一层（处理 monorepo 或 Sources/ 下有 .swift 的情况）──
-                const APPLE_EXTS = new Set(['.swift', '.m', '.mm', '.h']);
-                const SCAN_DIRS = ['Sources', 'Source', 'src', 'App', 'Classes', 'ios', 'iOS'];
-                for (const e of entries) {
-                    // 根目录直接有 .swift/.m 文件
-                    if (!e.isDirectory() && APPLE_EXTS.has(e.name.slice(e.name.lastIndexOf('.')))) {
-                        return true;
-                    }
-                    // 常见源码目录下有 Apple 文件
-                    if (e.isDirectory() && SCAN_DIRS.includes(e.name)) {
-                        try {
-                            const subEntries = readdirSync(join(projectRoot, e.name));
-                            if (subEntries.some((f) => APPLE_EXTS.has(f.slice(f.lastIndexOf('.'))))) {
-                                return true;
-                            }
-                        }
-                        catch {
-                            /* 读取失败忽略 */
-                        }
-                    }
-                }
-                return false;
-            }
-            catch {
-                return false;
-            }
-        })();
-        if (isAppleProject) {
-            try {
-                const Paths = await import('../lib/infrastructure/config/Paths.js');
-                const specPath = Paths.getProjectSpecPath(projectRoot);
-                const isDebugMode = process.env.ASD_DEBUG === '1';
-                // 设置 Dashboard URL 供 watcher 跳转浏览器使用
-                // 生产模式用 API 同端口，开发模式用 vite dev 5173
-                const dashDirCheck = DASHBOARD_DIR;
-                const isProductionDashboard = existsSync(join(dashDirCheck, 'dist', 'index.html')) &&
-                    !existsSync(join(dashDirCheck, 'src'));
-                if (!opts.apiOnly) {
-                    process.env.ASD_DASHBOARD_URL = isProductionDashboard
-                        ? `http://127.0.0.1:${port}`
-                        : `http://localhost:5173`;
-                }
-                else {
-                    process.env.ASD_DASHBOARD_URL =
-                        process.env.ASD_DASHBOARD_URL || `http://${host}:${port}`;
-                }
-                const { FileWatcher } = await import('../lib/service/automation/FileWatcher.js');
-                const watcher = new FileWatcher(specPath, projectRoot, { quiet: !isDebugMode });
-                watcher.start();
-                if (isDebugMode) {
-                }
-            }
-            catch (watchErr) {
-                cli.warn(`⚠️  File watcher failed to start: ${watchErr.message}`);
-                cli.debug(watchErr.stack);
-            }
-        }
-        else if (process.env.ASD_DEBUG === '1') {
-        }
         if (opts.apiOnly) {
             return;
         }
@@ -910,7 +868,8 @@ program
 program
     .command('status')
     .description('检查环境状态')
-    .action(async () => {
+    .option('--json', 'JSON 格式输出')
+    .action(async (opts) => {
     cli.log('\n  AutoSnippet Environment Status');
     cli.log(`  ${'─'.repeat(40)}`);
     // AI 配置
@@ -943,9 +902,165 @@ program
             cli.log(`    ❌ ${dep} (missing)`);
         }
     }
+    // 如果数据库存在，加载知识库统计
+    if (dbExists) {
+        try {
+            const projectRoot = resolve('.');
+            const { bootstrap, container } = await initContainer({ projectRoot });
+            const knowledgeService = container.get('knowledgeService');
+            const stats = (await knowledgeService.getStats());
+            if (stats) {
+                cli.log('  Knowledge:');
+                cli.log(`    Total: ${stats.total ?? 0}  Active: ${stats.active ?? 0}  Staging: ${stats.staging ?? 0}  Evolving: ${stats.evolving ?? 0}  Decaying: ${stats.decaying ?? 0}  Pending: ${stats.pending ?? 0}  Deprecated: ${stats.deprecated ?? 0}`);
+                cli.log(`    Rules: ${stats.rules ?? 0}  Patterns: ${stats.patterns ?? 0}  Facts: ${stats.facts ?? 0}`);
+            }
+            // Signal Bus 统计
+            const signalBus = container.get('signalBus');
+            if (signalBus) {
+                const bus = signalBus;
+                cli.log('  Signals:');
+                cli.log(`    Emitted: ${bus.emitCount ?? 0}  Listeners: ${bus.listenerCount ?? 0}`);
+            }
+            await bootstrap.shutdown();
+        }
+        catch {
+            // 降级: 无法加载容器时只展示基础状态
+        }
+    }
+    if (opts.json) {
+        // 简化 JSON 输出模式
+        const result = {
+            aiProvider: aiInfo.provider ?? 'ide-agent',
+            aiModel: aiInfo.model ?? null,
+            database: dbExists,
+            workspace: existsSync(asdDir),
+        };
+        cli.json(result);
+    }
     cli.blank();
 });
 // ─────────────────────────────────────────────────────
+// health 命令
+// ─────────────────────────────────────────────────────
+program
+    .command('health')
+    .description('综合健康报告：系统状态、知识生命周期、Guard 合规、信号统计')
+    .option('-d, --dir <path>', '项目目录', '.')
+    .option('--json', '以 JSON 格式输出')
+    .action(async (opts) => {
+    const projectRoot = resolve(opts.dir);
+    const { getAiConfigInfo } = await import('../lib/external/ai/AiFactory.js');
+    const aiInfo = getAiConfigInfo();
+    const aiOk = !!(aiInfo.provider && aiInfo.provider !== 'none');
+    const dbPath = join(projectRoot, '.autosnippet', 'autosnippet.db');
+    const dbExists = existsSync(dbPath);
+    let dbSizeMB = 0;
+    let dbEntries = 0;
+    let guardRuleCount = 0;
+    let knowledgeStats = {};
+    let complianceScore = 0;
+    let coverageScore = 0;
+    let confidencePct = 0;
+    let signalEmitted = 0;
+    let signalListeners = 0;
+    if (dbExists) {
+        try {
+            const { statSync } = await import('node:fs');
+            const stat = statSync(dbPath);
+            dbSizeMB = +(stat.size / (1024 * 1024)).toFixed(1);
+        }
+        catch {
+            /* stat 失败不阻塞 */
+        }
+        try {
+            const { bootstrap, container } = await initContainer({ projectRoot });
+            try {
+                const knowledgeService = container.get('knowledgeService');
+                const stats = (await knowledgeService.getStats());
+                if (stats) {
+                    knowledgeStats = stats;
+                    dbEntries = stats.total ?? 0;
+                }
+            }
+            catch {
+                /* knowledge service 不可用 */
+            }
+            try {
+                const engine = container.get('guardCheckEngine');
+                const rules = engine.getRules();
+                guardRuleCount = rules.length;
+            }
+            catch {
+                /* guard engine 不可用 */
+            }
+            try {
+                const reporter = container.get('complianceReporter');
+                const report = await reporter.generate(projectRoot, {
+                    qualityGate: { maxErrors: 0, maxWarnings: 100, minScore: 0 },
+                    maxFiles: 200,
+                });
+                complianceScore = report.complianceScore ?? 0;
+                coverageScore = report.coverageScore ?? 0;
+                confidencePct = report.confidenceScore ?? 0;
+            }
+            catch {
+                /* compliance reporter 不可用 */
+            }
+            try {
+                const signalBus = container.get('signalBus');
+                signalEmitted = signalBus.emitCount ?? 0;
+                signalListeners = signalBus.listenerCount ?? 0;
+            }
+            catch {
+                /* signal bus 不可用 */
+            }
+            await bootstrap.shutdown();
+        }
+        catch {
+            /* container init 失败，降级展示基础信息 */
+        }
+    }
+    const healthData = {
+        system: {
+            ai: aiOk,
+            db: dbExists,
+            dbSizeMB,
+            dbEntries,
+            guardRules: guardRuleCount,
+        },
+        knowledge: {
+            active: knowledgeStats.active ?? 0,
+            staging: knowledgeStats.staging ?? 0,
+            evolving: knowledgeStats.evolving ?? 0,
+            decaying: knowledgeStats.decaying ?? 0,
+        },
+        guard: {
+            compliance: complianceScore,
+            coverage: coverageScore,
+            confidence: confidencePct,
+        },
+        signals: {
+            emitted: signalEmitted,
+            listeners: signalListeners,
+        },
+    };
+    if (opts.json) {
+        cli.json(healthData);
+    }
+    else {
+        const dbStatus = dbExists ? `✅(${dbSizeMB}MB, ${dbEntries} entries)` : '❌';
+        const aiIcon = aiOk ? '✅' : '❌';
+        cli.log('');
+        cli.log('AutoSnippet Health Report');
+        cli.log('═════════════════════════');
+        cli.log(`🔧 System:  AI:${aiIcon}  DB:${dbStatus}  Guard:${guardRuleCount} rules`);
+        cli.log(`📊 Knowledge: Active:${healthData.knowledge.active} Staging:${healthData.knowledge.staging} Evolving:${healthData.knowledge.evolving} Decaying:${healthData.knowledge.decaying}`);
+        cli.log(`🛡️ Guard: Compliance:${complianceScore} Coverage:${coverageScore} Confidence:${confidencePct}%`);
+        cli.log(`📡 Signals: emitted:${signalEmitted} listeners:${signalListeners}`);
+        cli.blank();
+    }
+});
+// ─────────────────────────────────────────────────────
 // embed 命令 — 构建/重建语义向量索引
 // ─────────────────────────────────────────────────────
 program
@@ -1103,150 +1218,18 @@ program
     }
 });
 // ─────────────────────────────────────────────────────
-// task 命令 — TaskGraph CLI 管理
+// task 命令 — Task 系统已迁移到 MCP (零 DB，纯内存 + JSONL)
+// CLI task 子命令已废弃，通过 MCP autosnippet_task 操作
 // ─────────────────────────────────────────────────────
 const taskCmd = program
     .command('task')
-    .description('TaskGraph 任务管理（列表 / 就绪 / 上下文恢复 / 统计）');
+    .description('Task 管理（已迁移到 MCP — 通过 autosnippet_task 操作）');
 taskCmd
     .command('list')
-    .description('列出任务')
-    .option('-d, --dir <path>', '项目目录', '.')
-    .option('-s, --status <status>', '按状态过滤（open/in_progress/closed/deferred）')
-    .option('-l, --limit <n>', '最大条数', '20')
-    .action(async (opts) => {
-    const projectRoot = resolve(opts.dir);
-    const { bootstrap, container } = await initContainer({ projectRoot });
-    try {
-        const svc = container.get('taskGraphService');
-        const filters = {};
-        if (opts.status) {
-            filters.status = opts.status;
-        }
-        const tasks = await svc.list(filters, { limit: parseInt(opts.limit, 10) });
-        if (tasks.length === 0) {
-            cli.log('No tasks found.');
-        }
-        else {
-            cli.log(`\n  ID               Status        Priority  Title`);
-            cli.log(`  ${'─'.repeat(70)}`);
-            for (const t of tasks) {
-                if (!t) {
-                    continue;
-                }
-                const j = t.toJSON ? t.toJSON() : t;
-                if (!j) {
-                    continue;
-                }
-                const id = String(j.id || '').padEnd(16);
-                const status = String(j.status || '').padEnd(13);
-                const pri = String(j.priority ?? '-').padEnd(9);
-                cli.log(`  ${id} ${status} ${pri} ${j.title}`);
-            }
-            cli.log(`\n  Total: ${tasks.length}\n`);
-        }
-    }
-    finally {
-        await bootstrap.shutdown?.();
-    }
-});
-taskCmd
-    .command('ready')
-    .description('显示就绪任务（带知识上下文）')
-    .option('-d, --dir <path>', '项目目录', '.')
-    .option('-l, --limit <n>', '最大条数', '5')
-    .action(async (opts) => {
-    const projectRoot = resolve(opts.dir);
-    const { bootstrap, container } = await initContainer({ projectRoot });
-    try {
-        const svc = container.get('taskGraphService');
-        const tasks = await svc.ready({
-            limit: parseInt(opts.limit, 10),
-            withKnowledge: true,
-        });
-        if (tasks.length === 0) {
-            cli.log('No ready tasks.');
-        }
-        else {
-            for (const t of tasks) {
-                if (!t) {
-                    continue;
-                }
-                const j = t.toJSON ? t.toJSON() : t;
-                if (!j) {
-                    continue;
-                }
-                cli.log(`\n  ▸ ${j.id} — ${j.title} (P${j.priority ?? '?'})`);
-                const kCtx = t.knowledgeContext;
-                if (kCtx?.relatedKnowledge?.length) {
-                    cli.log(`    Knowledge: ${kCtx.relatedKnowledge.map((k) => k.title).join(', ')}`);
-                }
-                if (kCtx?.guardRules?.length) {
-                    cli.log(`    Guard: ${kCtx.guardRules.map((r) => r.title).join(', ')}`);
-                }
-            }
-            cli.blank();
-        }
-    }
-    finally {
-        await bootstrap.shutdown?.();
-    }
-});
-taskCmd
-    .command('prime')
-    .description('恢复 TaskGraph 会话上下文（等同 MCP prime 操作）')
-    .option('-d, --dir <path>', '项目目录', '.')
-    .action(async (opts) => {
-    const projectRoot = resolve(opts.dir);
-    const { bootstrap, container } = await initContainer({ projectRoot });
-    try {
-        const svc = container.get('taskGraphService');
-        const result = await svc.prime({ withKnowledge: true });
-        const inProgress = result.inProgress;
-        const ready = result.ready;
-        cli.log(`\n  TaskGraph Prime`);
-        cli.log(`  ${'─'.repeat(40)}`);
-        cli.log(`  In Progress: ${inProgress.length}`);
-        cli.log(`  Ready:       ${ready.length}`);
-        cli.log(`  Stats:       ${JSON.stringify(result.stats)}`);
-        if (inProgress.length > 0) {
-            cli.log(`\n  ▸ In Progress:`);
-            for (const t of inProgress) {
-                cli.log(`    ${t.id} — ${t.title}`);
-            }
-        }
-        if (ready.length > 0) {
-            cli.log(`\n  ▸ Ready:`);
-            for (const t of ready) {
-                cli.log(`    ${t.id} — ${t.title}`);
-            }
-        }
-        cli.blank();
-    }
-    finally {
-        await bootstrap.shutdown?.();
-    }
-});
-taskCmd
-    .command('stats')
-    .description('TaskGraph 统计信息')
-    .option('-d, --dir <path>', '项目目录', '.')
-    .action(async (opts) => {
-    const projectRoot = resolve(opts.dir);
-    const { bootstrap, container } = await initContainer({ projectRoot });
-    try {
-        const svc = container.get('taskGraphService');
-        const stats = await svc.stats();
-        cli.log(`\n  TaskGraph Statistics`);
-        cli.log(`  ${'─'.repeat(30)}`);
-        for (const [key, val] of Object.entries(stats)) {
-            cli.log(`  ${key.padEnd(15)} ${val}`);
-        }
-        cli.blank();
-    }
-    finally {
-        await bootstrap.shutdown?.();
-    }
+    .description('[已废弃] Task 系统不再使用数据库。通过 MCP prime 操作获取上下文。')
+    .action(() => {
+    cli.log('\n  ⚠️ Task 系统已迁移到 MCP（零 DB，纯内存 + JSONL）。');
+    cli.log('  使用 autosnippet_task({ operation: "prime" }) 加载上下文。\n');
 });
 // ─────────────────────────────────────────────────────
 // mirror 命令

package/dist/lib/agent/context/ExplorationTracker.d.ts

@@ -21,6 +21,7 @@
  *
  * @module ExplorationTracker
  */
+import type { SignalBus } from '#infra/signal/SignalBus.js';
 import type { ExplorationBudget, ExplorationStrategy, ExplorationTrace, PipelineType } from './exploration/ExplorationStrategies.js';
 /** resolve() 选项 */
 interface ResolveOptions {
@@ -34,6 +35,7 @@ interface ResolveOptions {
 interface BudgetInput extends Partial<ExplorationBudget> {
     submitToolName?: string;
     pipelineType?: PipelineType;
+    signalBus?: SignalBus | null;
 }
 export declare class ExplorationTracker {
     #private;

package/dist/lib/agent/context/ExplorationTracker.js

@@ -36,6 +36,8 @@ export class ExplorationTracker {
     #phase;
     /** 日志器 */
     #logger;
+    /** 信号总线（可选） */
+    #signalBus;
     // ── 子模块 ──
     #signalDetector;
     #nudgeGenerator;
@@ -88,6 +90,7 @@ export class ExplorationTracker {
             budget.pipelineType || (strategy.name === 'analyst' ? 'analyst' : 'bootstrap');
         this.#phase = strategy.phases[0];
         this.#logger = Logger.getInstance();
+        this.#signalBus = budget.signalBus ?? null;
         // 初始化子模块
         this.#signalDetector = new SignalDetector(this.#metrics);
         this.#nudgeGenerator = new NudgeGenerator();
@@ -147,17 +150,17 @@ export class ExplorationTracker {
     shouldExit() {
         // Scan 管线: SUMMARIZE 无消费方，直接退出
         if (this.#isTerminalPhase() && this.#pipelineType === 'scan') {
+            this.#emitExitSignal('scan_terminal');
             return true;
         }
         // 终结阶段 + 已给了 3 轮 grace → 退出
-        // 注意: phaseRounds 在 tick() 中递增 (进入终结阶段后从 1 开始计数)
-        // 3 轮 grace 允许: round 1 (首次尝试) + round 2 (空响应重试) + 安全余量
-        // 与 AgentRuntime#callLLM 的空响应 grace 机制对齐 (grace < 2 → 在 round 1 重试)
         if (this.#isTerminalPhase() && this.#metrics.phaseRounds >= 3) {
+            this.#emitExitSignal('grace_exhausted');
             return true;
         }
         // 硬上限兜底
         if (this.#metrics.iteration >= this.#budget.maxIterations + 2) {
+            this.#emitExitSignal('hard_limit');
             return true;
         }
         // 达到 maxIterations 但未在终结阶段 → 强制转入终结阶段
@@ -170,6 +173,13 @@ export class ExplorationTracker {
         }
         return false;
     }
+    #emitExitSignal(reason) {
+        if (this.#signalBus) {
+            this.#signalBus.send('exploration', 'ExplorationTracker.exit', 0, {
+                metadata: { totalIterations: this.#metrics.iteration, reason },
+            });
+        }
+    }
     /**
      * 获取本轮的 Nudge（每轮最多一条）
      * @param trace 推理链
@@ -438,6 +448,14 @@ export class ExplorationTracker {
         this.#metrics.roundsSinceSubmit = 0;
         this.#justTransitioned = true;
         this.#logger.info(`[ExplorationTracker] ${oldPhase} → ${newPhase} (iter=${this.#metrics.iteration}, submits=${this.#metrics.submitCount})`);
+        // Phase 3: 发射阶段转换信号
+        if (this.#signalBus) {
+            const terminalPhase = this.#getTerminalPhase();
+            const value = newPhase === terminalPhase ? 1.0 : 0.5;
+            this.#signalBus.send('exploration', 'ExplorationTracker.phase', value, {
+                metadata: { from: oldPhase, to: newPhase, iteration: this.#metrics.iteration },
+            });
+        }
     }
     #isTerminalPhase() {
         return this.#phase === this.#getTerminalPhase();

package/dist/lib/agent/core/ToolExecutionPipeline.d.ts

@@ -78,7 +78,9 @@ export declare class ToolExecutionPipeline {
  * 从 LoopContext.toolSchemas 中提取允许的工具名列表，
  * 拒绝不在列表中的调用（返回 error 提示）。
  *
- * before: 如果工具不在白名单中则短路返回 error
+ * Forge 集成：不在白名单的工具如果已由 ToolForge 锻造（存在于 ToolRegistry），则放行。
+ *
+ * before: 如果工具不在白名单中且非锻造工具则短路返回 error
  */
 export declare const allowlistGate: {
     name: string;