autosnippet 3.3.0 → 3.3.3

package/dist/bin/cli.js

@@ -15,6 +15,7 @@
  *   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';
@@ -475,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')
@@ -513,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) {
@@ -604,6 +615,86 @@ program
     }
 });
 // ─────────────────────────────────────────────────────
+// panorama 命令
+// ─────────────────────────────────────────────────────
+program
+    .command('panorama [path]')
+    .description('项目全景分析：架构层级、覆盖率、知识空白')
+    .option('--json', '以 JSON 格式输出')
+    .option('--gaps', '仅显示知识空白区')
+    .option('--health', '仅显示健康度评分')
+    .action(async (scanPath, opts) => {
+    try {
+        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;
+        }
+        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();
+            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}`);
+        cli.debug(err.stack);
+        process.exit(1);
+    }
+});
+// ─────────────────────────────────────────────────────
 // server 命令
 // ─────────────────────────────────────────────────────
 program
@@ -651,6 +742,17 @@ program
         httpServer = new HttpServer({ port, host });
         await httpServer.initialize();
         await httpServer.start();
+        // ── UiStartupTasks: 后台异步刷新（不阻塞 UI） ──
+        import('../lib/service/bootstrap/UiStartupTasks.js')
+            .then(({ runUiStartupTasks }) => runUiStartupTasks({ projectRoot, container }))
+            .then((report) => {
+            if (report.errors.length > 0) {
+                cli.warn(`⚠️  UiStartupTasks completed with ${report.errors.length} error(s)`);
+            }
+        })
+            .catch((err) => {
+            cli.debug(`UiStartupTasks failed: ${err.message}`);
+        });
         // ── MCP 配置检测 ──
         const cursorMcpPath = join(projectRoot, '.cursor', 'mcp.json');
         const vscodeMcpPath = join(projectRoot, '.vscode', 'mcp.json');
@@ -777,7 +879,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 配置
@@ -810,9 +913,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
@@ -970,150 +1229,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 命令
@@ -1221,7 +1348,7 @@ program
         process.exit(1);
     }
     try {
-        const report = syncService.sync(db, {
+        const report = await syncService.syncAll(db, {
             dryRun: opts.dryRun,
             force: opts.force,
         });
@@ -1231,6 +1358,21 @@ program
         cli.log(`  Updated:   ${report.updated ?? 0}`);
         cli.log(`  Unchanged: ${report.unchanged ?? 0}`);
         cli.log(`  Deleted:   ${report.deleted ?? 0}`);
+        if (report.reconcileReport) {
+            cli.log(`\n  📍 Source Refs`);
+            cli.log(`  ${'─'.repeat(40)}`);
+            cli.log(`  Inserted:  ${report.reconcileReport.inserted ?? 0}`);
+            cli.log(`  Active:    ${report.reconcileReport.active ?? 0}`);
+            cli.log(`  Stale:     ${report.reconcileReport.stale ?? 0}`);
+            cli.log(`  Skipped:   ${report.reconcileReport.skipped ?? 0}`);
+        }
+        if (report.repairReport &&
+            (report.repairReport.renamed > 0 || report.repairReport.stillStale > 0)) {
+            cli.log(`\n  🔧 Rename Repairs`);
+            cli.log(`  ${'─'.repeat(40)}`);
+            cli.log(`  Renamed:    ${report.repairReport.renamed ?? 0}`);
+            cli.log(`  Still Stale: ${report.repairReport.stillStale ?? 0}`);
+        }
         if (report.violations.length > 0) {
             cli.log(`\n  ⚠️  Violations (${report.violations.length}):`);
             for (const v of report.violations) {

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;

package/dist/lib/agent/core/ToolExecutionPipeline.js

@@ -106,7 +106,9 @@ export class ToolExecutionPipeline {
  * 从 LoopContext.toolSchemas 中提取允许的工具名列表，
  * 拒绝不在列表中的调用（返回 error 提示）。
  *
- * before: 如果工具不在白名单中则短路返回 error
+ * Forge 集成：不在白名单的工具如果已由 ToolForge 锻造（存在于 ToolRegistry），则放行。
+ *
+ * before: 如果工具不在白名单中且非锻造工具则短路返回 error
  */
 export const allowlistGate = {
     name: 'allowlistGate',
@@ -118,6 +120,11 @@ export const allowlistGate = {
         }
         const allowedNames = new Set(schemas.map((s) => s.name || s.function?.name));
         if (!allowedNames.has(call.name)) {
+            // Forge fallback: 不在白名单但已注册到 ToolRegistry（如锻造的临时工具）则放行
+            if (ctx.runtime.toolRegistry?.has(call.name)) {
+                ctx.runtime.logger.info(`[ToolPipeline] Tool "${call.name}" not in allowlist but exists in registry (forged?) — allowed`);
+                return undefined;
+            }
             ctx.runtime.logger.warn(`[ToolPipeline] ⛔ Tool "${call.name}" not in allowlist — blocked (hallucinated call)`);
             return {
                 blocked: true,

package/dist/lib/agent/forge/DynamicComposer.d.ts

@@ -0,0 +1,58 @@
+/**
+ * DynamicComposer — 运行时动态工具组合
+ *
+ * 将已有的原子工具按 sequential / parallel / conditional 策略组合成复合工具。
+ * 组合结果注册为临时工具（通过 TemporaryToolRegistry）。
+ *
+ * 与 PipelineStrategy 的区别：
+ *   - PipelineStrategy 是 Agent 执行策略（Agent 层）
+ *   - DynamicComposer 是工具组合（Tool 层），产出物是单个工具
+ */
+interface ToolRegistryLike {
+    has(name: string): boolean;
+    execute(name: string, params: Record<string, unknown>, context?: Record<string, unknown>): Promise<unknown>;
+}
+export interface CompositionStep {
+    /** 要调用的工具名 */
+    tool: string;
+    /** 静态参数或从前一步结果构造参数的函数 */
+    args: Record<string, unknown> | ((prevResult: unknown) => Record<string, unknown>);
+    /** 可选：提取该步结果中的特定字段传给下一步 */
+    extractKey?: string;
+}
+export interface CompositionSpec {
+    /** 组合工具的名称 */
+    name: string;
+    /** 描述 */
+    description: string;
+    /** 执行步骤 */
+    steps: CompositionStep[];
+    /** 合并策略 */
+    mergeStrategy: 'sequential' | 'parallel';
+    /** JSON Schema 参数定义 */
+    parameters?: Record<string, unknown>;
+}
+export interface CompositionResult {
+    /** 是否成功 */
+    success: boolean;
+    /** 组合工具 handler */
+    handler?: (params: Record<string, unknown>, context: Record<string, unknown>) => Promise<unknown>;
+    /** 失败原因 */
+    error?: string;
+}
+export declare class DynamicComposer {
+    #private;
+    constructor(registry: ToolRegistryLike);
+    /**
+     * 验证组合 spec 的可行性（所有工具是否存在）
+     */
+    validate(spec: CompositionSpec): {
+        valid: boolean;
+        missingTools: string[];
+    };
+    /**
+     * 构建组合工具
+     */
+    compose(spec: CompositionSpec): CompositionResult;
+}
+export {};