feat(evolution): integrate drift-scan into analyze + on-report trigger mode (XSPEC-004 Phase 4.5b).

Add DriftDetectionConfig to EvolutionConfig; extend devap evolution analyze
to run DriftDetector as [4/4] step; export loadEvolutionConfig/executeEvolutionAnalyze
from CLI; add on-report trigger in devap run that auto-invokes evolution analyze.

新增 DriftDetectionConfig 至 EvolutionConfig.analyzers；
devap evolution analyze 整合 drift-scan 為第 [4/4] 步驟；
匯出 loadEvolutionConfig / executeEvolutionAnalyze 供 devap run 呼叫；
devap run 完成後若設定 on-report 模式，自動觸發演進分析。

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: AsiaOstrich

packages/cli/src/commands/evolution.ts

@@ -24,7 +24,7 @@ import {
   QualityStrategyProposalGenerator,
   ApprovalManager,
 } from "@devap/core";
-import type { EvolutionConfig, AnalyzerConfig, QualityStrategyConfig, ProposalStatus } from "@devap/core";
+import type { EvolutionConfig, AnalyzerConfig, QualityStrategyConfig, DriftDetectionConfig, ProposalStatus } from "@devap/core";
 
 // ─── 預設配置 ───────────────────────────────────────────────
 
@@ -48,20 +48,25 @@ const DEFAULT_QUALITY_STRATEGY_CONFIG: QualityStrategyConfig = {
   token_overhead_ratio: 1.5,
 };
 
+const DEFAULT_DRIFT_DETECTION_CONFIG: DriftDetectionConfig = {
+  enabled: true,
+};
+
 const DEFAULT_EVOLUTION_CONFIG: EvolutionConfig = {
   enabled: true,
   analyzers: {
     "token-cost": DEFAULT_TOKEN_COST_CONFIG,
     "hook-efficiency": DEFAULT_HOOK_EFFICIENCY_CONFIG,
     "quality-strategy": DEFAULT_QUALITY_STRATEGY_CONFIG,
+    "drift-detection": DEFAULT_DRIFT_DETECTION_CONFIG,
   },
   trigger: { mode: "manual" },
   approval: { required: true },
 };
 
 // ─── Config 載入 ────────────────────────────────────────────
 
-async function loadEvolutionConfig(cwd: string): Promise<EvolutionConfig> {
+export async function loadEvolutionConfig(cwd: string): Promise<EvolutionConfig> {
   const configPath = join(cwd, ".evolution", "config.yaml");
   try {
     const raw = await readFile(configPath, "utf-8");
@@ -82,6 +87,14 @@ async function loadEvolutionConfig(cwd: string): Promise<EvolutionConfig> {
           ...DEFAULT_QUALITY_STRATEGY_CONFIG,
           ...parsed.analyzers?.["quality-strategy"],
         },
+        "drift-detection": {
+          ...DEFAULT_DRIFT_DETECTION_CONFIG,
+          ...parsed.analyzers?.["drift-detection"],
+        },
+      },
+      trigger: {
+        ...DEFAULT_EVOLUTION_CONFIG.trigger,
+        ...parsed.trigger,
       },
     };
   } catch {
@@ -132,7 +145,7 @@ export async function executeEvolutionAnalyze(opts: {
   // ── Token Cost Analysis ──────────────────────────────────
   const tokenConfig = config.analyzers["token-cost"];
   if (tokenConfig.enabled) {
-    console.log("📊 [1/3] Token 成本分析器...");
+    console.log("📊 [1/4] Token 成本分析器...");
     const tokenAnalyzer = new TokenCostAnalyzer(executionHistoryBackend, tokenConfig);
     const tokenResult = await tokenAnalyzer.analyze();
 
@@ -158,7 +171,7 @@ export async function executeEvolutionAnalyze(opts: {
   // ── Hook Efficiency Analysis ─────────────────────────────
   const hookConfig = config.analyzers["hook-efficiency"];
   if (hookConfig?.enabled) {
-    console.log("\n🪝 [2/3] Hook 效率分析器...");
+    console.log("\n🪝 [2/4] Hook 效率分析器...");
     const hookAnalyzer = new HookEfficiencyAnalyzer(cwd, hookConfig);
     const hookResult = await hookAnalyzer.analyze();
 
@@ -189,7 +202,7 @@ export async function executeEvolutionAnalyze(opts: {
   // ── Quality Strategy Analysis ────────────────────────────
   const qualityConfig = config.analyzers["quality-strategy"];
   if (qualityConfig?.enabled) {
-    console.log("\n🎯 [3/3] 品質策略分析器...");
+    console.log("\n🎯 [3/4] 品質策略分析器...");
     const qualityAnalyzer = new QualityStrategyAnalyzer(executionHistoryBackend, qualityConfig);
     const qualityResult = await qualityAnalyzer.analyze();
 
@@ -218,6 +231,33 @@ export async function executeEvolutionAnalyze(opts: {
     }
   }
 
+  // ── Drift Detection ──────────────────────────────────────
+  const driftConfig = config.analyzers["drift-detection"];
+  if (driftConfig?.enabled) {
+    console.log("\n🔍 [4/4] 文件飄移偵測...");
+    const driftDetector = new DriftDetector(cwd);
+    const driftResult = await driftDetector.analyze();
+
+    if (driftResult.skipped) {
+      console.log(`  ⏭  跳過：${driftResult.skip_reason}（找不到 .standards/ 目錄）`);
+    } else {
+      console.log(`  ✓  掃描 ${driftResult.files_scanned} 個檔案`);
+      console.log(`  📌 發現 ${driftResult.items.length} 個飄移引用`);
+
+      if (driftResult.items.length > 0) {
+        const broken = driftResult.items.filter((i) => i.drift_type === "broken_reference");
+        const stale = driftResult.items.filter((i) => i.drift_type === "stale_standard");
+        if (broken.length > 0) console.log(`     - 失效路徑引用：${broken.length} 個`);
+        if (stale.length > 0) console.log(`     - 失效標準引用：${stale.length} 個`);
+
+        const reportPath = await driftDetector.writeReport(driftResult, join(cwd, ".evolution"));
+        if (reportPath) {
+          console.log(`  📄 drift-report.md 已寫入 .evolution/proposals/`);
+        }
+      }
+    }
+  }
+
   console.log(`\n─────────────────────────────────────────────`);
   if (totalProposals > 0) {
     console.log(`✅ 分析完成，共產生 ${totalProposals} 個提案`);

packages/cli/src/index.ts

@@ -13,7 +13,7 @@ import { registerInitCommand } from "./commands/init.js";
 import { registerSyncStandardsCommand } from "./commands/sync-standards.js";
 import { registerPackageCommand } from "./commands/package.js";
 import { registerReportCommand } from "./commands/report.js";
-import { registerEvolutionCommand } from "./commands/evolution.js";
+import { registerEvolutionCommand, loadEvolutionConfig, executeEvolutionAnalyze } from "./commands/evolution.js";
 import {
   orchestrate,
   validatePlan,
@@ -177,6 +177,20 @@ program
         // 靜默失敗，不影響主流程
       }
 
+      // XSPEC-004: on-report 觸發 — 若 evolution config 設為 on-report，自動執行演進分析
+      if (!opts.dryRun) {
+        try {
+          const evoConfig = await loadEvolutionConfig(cwd);
+          if (evoConfig.enabled && evoConfig.trigger.mode === "on-report") {
+            console.log("\n─────────────────────────────────────────────");
+            console.log("🔄 [on-report] 自動觸發演進分析...");
+            await executeEvolutionAnalyze({ cwd, project: plan.project });
+          }
+        } catch {
+          // 靜默失敗，不影響主流程的 exit code
+        }
+      }
+
       // 有失敗時回傳非零 exit code
       if (report.summary.failed > 0) {
         process.exit(1);

packages/core/src/evolution/types.ts

@@ -29,13 +29,19 @@ export interface QualityStrategyConfig extends AnalyzerConfig {
   token_overhead_ratio?: number;
 }
 
+/** 飄移偵測配置（比其他 analyzer 更輕量，不需 min_samples） */
+export interface DriftDetectionConfig {
+  enabled: boolean;
+}
+
 /** Evolution 模組配置（對應 .evolution/config.yaml） */
 export interface EvolutionConfig {
   enabled: boolean;
   analyzers: {
     "token-cost": AnalyzerConfig;
     "hook-efficiency"?: AnalyzerConfig;
     "quality-strategy"?: QualityStrategyConfig;
+    "drift-detection"?: DriftDetectionConfig;
   };
   trigger: {
     mode: "manual" | "on-report" | "scheduled";

packages/core/src/index.ts

@@ -12,7 +12,7 @@ export { resolveQualityProfile, checkQualityWarnings } from "./quality-profile.j
 export { runFixLoop, buildStructuredFeedback, type ExecuteResult, type FixLoopCallbacks } from "./fix-loop.js";
 export { parseTelemetryJsonl } from "./telemetry-parser.js";
 export { TokenCostAnalyzer, ProposalGenerator, HookEfficiencyAnalyzer, HookEfficiencyProposalGenerator, QualityStrategyAnalyzer, QualityStrategyProposalGenerator, DriftDetector, ApprovalManager, serializeProposal, parseProposal } from "./evolution/index.js";
-export type { EvolutionConfig, AnalyzerConfig, QualityStrategyConfig, AnalysisResult, HookEfficiencyAnalysisResult, HookEfficiencyIssue, QualityStrategyAnalysisResult, QualityStrategyIssue, QualityStrategySignal, DriftAnalysisResult, DriftItem, DriftType, GroupKey, GroupStats, Outlier, Proposal, ProposalMeta, ProposalStatus, ProposalImpact, ProposalTarget, AnalysisLogEntry, ConfirmApplyFn, ApprovalResult } from "./evolution/index.js";
+export type { EvolutionConfig, AnalyzerConfig, QualityStrategyConfig, DriftDetectionConfig, AnalysisResult, HookEfficiencyAnalysisResult, HookEfficiencyIssue, QualityStrategyAnalysisResult, QualityStrategyIssue, QualityStrategySignal, DriftAnalysisResult, DriftItem, DriftType, GroupKey, GroupStats, Outlier, Proposal, ProposalMeta, ProposalStatus, ProposalImpact, ProposalTarget, AnalysisLogEntry, ConfirmApplyFn, ApprovalResult } from "./evolution/index.js";
 export { LocalStorageBackend } from "./execution-history/index.js";
 // SPEC-015: 打包框架
 export { loadRecipe, resolveConfig, executeTarget, interpolateCommand, orchestratePackaging } from "./packaging/index.js";