progmune-runtime 3.3.7 → 3.4.0

package/dist/agent-patrol.js

@@ -0,0 +1,200 @@
+"use strict";
+/**
+ * Phase 12: Agent 免疫巡逻 (P4) —— 形态 B 第一版
+ *
+ * 监听/扫描项目 → trust_check（Trust Engine 全量评估）→ 违规报告 + 建议补丁。
+ *
+ * 修复信任悖论（设计文档铁律）：
+ *   100% 检测精度 ≠ 修复正确率。巡逻第一形态**只报告 + 建议补丁，
+ *   绝不自动合并**（autoApplied 恒为 false）——修错比不修更糟，
+ *   第一份错误修复会摧毁"免疫巡逻"信任。
+ *
+ * 感知职责：每次扫描前强制重提 IR（IR_STALE 的消费方），保证验证的是新世界。
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPatrol = runPatrol;
+exports.formatPatrolTerminal = formatPatrolTerminal;
+exports.formatPatrolMarkdown = formatPatrolMarkdown;
+exports.writePatrolReport = writePatrolReport;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const engine_1 = require("./trust/engine");
+const agent_perception_1 = require("./agent-perception");
+const extract_ir_1 = require("./extract-ir");
+// ── Main ──
+/**
+ * 运行一次免疫巡逻：重提 IR → evaluateTrust → 映射违规（含 fixPath）→ 报告。
+ */
+async function runPatrol(projectPath) {
+    const abs = path.resolve(projectPath);
+    const git = (0, agent_perception_1.collectGitContext)(abs);
+    // 感知：扫描前强制重提 IR（IR_STALE 消费方）——验证的是新世界
+    try {
+        const ir = (0, extract_ir_1.extractIR)(abs);
+        fs.writeFileSync(path.join(abs, "ir.json"), JSON.stringify(ir, null, 2));
+    }
+    catch { /* IR 提取失败不阻塞 —— trust 引擎会降级 */ }
+    const decision = await (0, engine_1.evaluateTrust)({
+        projectPath: abs,
+        projectName: path.basename(abs),
+        commit: git.available ? (git.recentCommits[0]?.split(" ")[0] || "unknown") : "unknown",
+        branch: git.available ? git.branch : undefined,
+    });
+    // fixPath 来自引擎的 violationTraces（BFS 修复路径）
+    const traces = new Map((decision.violationTraces || []).map((t) => [`${t.rule_id}|${t.file}|${t.function}`, t]));
+    const findings = decision.violations.map((v) => {
+        const trace = traces.get(`${v.rule_id}|${v.file}|${v.function}`);
+        return {
+            rule_id: v.rule_id,
+            severity: v.severity,
+            file: v.file,
+            function: v.function,
+            message: v.message,
+            fixPath: trace?.fixPath || [],
+            fix: v.fix,
+            evidence: v.evidence,
+            reasoningSteps: (trace?.steps || []).map((s) => `[${s.label}] ${s.action} → ${s.explanation}`),
+        };
+    });
+    const auditTrail = [
+        {
+            timestamp: new Date().toISOString(),
+            event: "patrol:scan",
+            detail: `decision=${decision.overall.decision} score=${decision.overall.score} ` +
+                `violations=${decision.violations.length}`,
+        },
+        {
+            timestamp: decision.timestamp,
+            event: "patrol:trust-audit",
+            detail: `checkId=${decision.auditTrail.checkId} engine=${decision.engineVersion} ` +
+                `reproducible=${decision.auditTrail.reproducible}`,
+        },
+    ];
+    return {
+        scannedAt: new Date().toISOString(),
+        project: decision.project,
+        branch: git.available ? git.branch : "",
+        commit: decision.commit,
+        decision: decision.overall.decision,
+        score: decision.overall.score,
+        confidence: decision.overall.confidence,
+        findings,
+        summary: {
+            total: decision.summary.total,
+            critical: decision.summary.critical,
+            high: decision.summary.high,
+            medium: decision.summary.medium,
+            low: decision.summary.low,
+        },
+        auditTrail,
+        engineVersion: decision.engineVersion,
+        checkId: decision.auditTrail.checkId,
+        autoApplied: false,
+        changedFiles: git.changedFiles,
+    };
+}
+// ── Formatters ──
+/** 终端一行摘要。 */
+function formatPatrolTerminal(r) {
+    const icon = r.decision === "APPROVED" ? "✅" : r.decision === "BLOCKED" ? "🛑" : "⚠️";
+    const lines = [
+        `${icon} 免疫巡逻: ${r.project} — ${r.decision} (score=${r.score}, confidence=${r.confidence})`,
+        `   违规: ${r.summary.total} (critical=${r.summary.critical} high=${r.summary.high} ` +
+            `medium=${r.summary.medium} low=${r.summary.low}) ｜ 自动合并: 永不（只报告+建议）`,
+    ];
+    for (const f of r.findings.slice(0, 10)) {
+        lines.push(`   [${f.severity}] ${f.rule_id} @ ${f.file}${f.function ? `::${f.function}` : ""}` +
+            (f.fixPath.length > 0 ? ` → 建议补丁: ${f.fixPath.join(" → ")}` : ""));
+    }
+    if (r.findings.length > 10)
+        lines.push(`   … 其余 ${r.findings.length - 10} 项见报告`);
+    return lines.join("\n");
+}
+/** 完整 Markdown 巡逻报告（含证据链回放，可入审计档案）。 */
+function formatPatrolMarkdown(r) {
+    const lines = [
+        `# 🛡️ Progmune 免疫巡逻报告`,
+        ``,
+        `- 扫描时间: ${r.scannedAt}`,
+        `- 项目: ${r.project}${r.branch ? `（分支 ${r.branch}）` : ""}`,
+        `- 提交: ${r.commit}`,
+        `- 决策: **${r.decision}** ｜ 分数: ${r.score} ｜ 置信度: ${r.confidence}`,
+        `- 引擎: ${r.engineVersion} ｜ checkId: ${r.checkId}`,
+        `- **自动合并: 永不**（只报告 + 建议补丁，修复需人工审批）`,
+        ``,
+        `## 违规摘要`,
+        ``,
+        `| 严重级 | 数量 |`,
+        `|---|---|`,
+        `| critical | ${r.summary.critical} |`,
+        `| high | ${r.summary.high} |`,
+        `| medium | ${r.summary.medium} |`,
+        `| low | ${r.summary.low} |`,
+        `| **合计** | **${r.summary.total}** |`,
+        ``,
+    ];
+    if (r.findings.length === 0) {
+        lines.push(`✅ 未发现违规。`, ``);
+    }
+    else {
+        lines.push(`## 违规明细与建议补丁`, ``);
+        r.findings.forEach((f, i) => {
+            lines.push(`### ${i + 1}. [${f.severity}] ${f.rule_id} — ${f.file}${f.function ? `::${f.function}` : ""}`, ``, `- **问题**: ${f.message}`, `- **修复建议**: ${f.fix}`);
+            if (f.fixPath.length > 0) {
+                lines.push(`- **建议补丁路径**（不自动应用）: \`${f.fixPath.join(" → ")}\``);
+            }
+            if (f.reasoningSteps.length > 0) {
+                lines.push(``, `**推理回放**:`, ``);
+                f.reasoningSteps.forEach((s) => lines.push(`  - ${s}`));
+            }
+            lines.push(``);
+        });
+    }
+    lines.push(`## 证据链（可回放）`, ``);
+    r.auditTrail.forEach((e) => lines.push(`- \`${e.timestamp}\` **${e.event}**: ${e.detail}`));
+    if (r.changedFiles.length > 0) {
+        lines.push(``, `## 扫描时变更文件`, ``);
+        r.changedFiles.forEach((f) => lines.push(`- ${f}`));
+    }
+    lines.push(``, `---`, `*由 Progmune 免疫巡逻生成。修复责任: 人工审批后应用。*`, ``);
+    return lines.join("\n");
+}
+/** 写入巡逻报告到项目目录，返回文件路径。 */
+function writePatrolReport(r, projectPath) {
+    const reportPath = path.join(path.resolve(projectPath), ".progmune_patrol_report.md");
+    fs.writeFileSync(reportPath, formatPatrolMarkdown(r), "utf-8");
+    return reportPath;
+}

package/dist/agent-patrol.test.js

@@ -0,0 +1,141 @@
+"use strict";
+/**
+ * Phase 12: 免疫巡逻测试 (P4)
+ *
+ * evaluateTrust / extractIR / git 全部 mock —— 验证：
+ *   - 违规 → 报告映射（fixPath 来自 violationTraces）
+ *   - autoApplied 恒为 false（修复信任悖论）
+ *   - Markdown 报告含建议补丁 + 证据链
+ *   - 报告落盘
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const engine_1 = require("./trust/engine");
+const extract_ir_1 = require("./extract-ir");
+const child_process_1 = require("child_process");
+const agent_patrol_1 = require("./agent-patrol");
+vitest_1.vi.mock("./trust/engine", () => ({
+    evaluateTrust: vitest_1.vi.fn(),
+}));
+vitest_1.vi.mock("./extract-ir", () => ({
+    extractIR: vitest_1.vi.fn(),
+}));
+vitest_1.vi.mock("child_process", () => ({
+    execSync: vitest_1.vi.fn(),
+}));
+const mockEvaluateTrust = vitest_1.vi.mocked(engine_1.evaluateTrust);
+const mockExtractIR = vitest_1.vi.mocked(extract_ir_1.extractIR);
+const mockExecSync = vitest_1.vi.mocked(child_process_1.execSync);
+/** 构造受控的 TrustDecision */
+function trustDecision(overrides = {}) {
+    return {
+        project: "demo-patrol",
+        commit: "abc123",
+        timestamp: "2026-08-21T08:00:00.000Z",
+        engineVersion: "trust-runtime-v1.0.0",
+        overall: { score: 41, decision: "BLOCKED", confidence: "HIGH" },
+        dimensions: {},
+        violations: [
+            {
+                severity: "high",
+                rule_id: "SSG_PROTOCOL",
+                file: "bad_flow.ts",
+                function: "bad_flow",
+                message: 'SSG state violation: "generate_jwt" requires states [PASSWORD_VERIFIED]',
+                evidence: "调用序列 [generate_jwt] 违反协议",
+                why: "缺少密码验证前置",
+                fix: "在 generate_jwt 前调用 verify_password",
+                policy_ref: "REF-SSG-001",
+            },
+        ],
+        violationTraces: [
+            {
+                rule_id: "SSG_PROTOCOL",
+                file: "bad_flow.ts",
+                function: "bad_flow",
+                steps: [
+                    { step: 1, label: "状态", action: "generate_jwt", preState: "UNAUTHENTICATED", explanation: "前置 PASSWORD_VERIFIED 缺失" },
+                ],
+                fixPath: ["verify_password"],
+                estimatedReadingTimeMinutes: 1,
+            },
+        ],
+        summary: { critical: 0, high: 1, medium: 0, low: 0, total: 1 },
+        auditTrail: {
+            commit: "abc123",
+            policy: "default",
+            policyVersion: "v1.0.0",
+            engineVersion: "trust-runtime-v1.0.0",
+            generatedAt: "2026-08-21T08:00:00.000Z",
+            reproducible: true,
+            checkId: "check_abc",
+        },
+        ...overrides,
+    };
+}
+(0, vitest_1.beforeEach)(() => {
+    vitest_1.vi.clearAllMocks();
+    mockExtractIR.mockReturnValue([]);
+    mockExecSync.mockImplementation((cmd) => {
+        const c = String(cmd);
+        if (c.includes("rev-parse"))
+            return "main";
+        if (c.includes("log --oneline"))
+            return "abc123 feat: demo";
+        if (c.includes("status --porcelain"))
+            return " M bad_flow.ts";
+        throw new Error("unexpected cmd: " + c);
+    });
+});
+(0, vitest_1.describe)("agent-patrol", () => {
+    (0, vitest_1.it)("违规映射到报告：fixPath 来自 violationTraces，autoApplied 恒为 false", async () => {
+        mockEvaluateTrust.mockResolvedValue(trustDecision());
+        const r = await (0, agent_patrol_1.runPatrol)("/tmp/fake-project");
+        (0, vitest_1.expect)(r.decision).toBe("BLOCKED");
+        (0, vitest_1.expect)(r.score).toBe(41);
+        (0, vitest_1.expect)(r.summary).toEqual({ critical: 0, high: 1, medium: 0, low: 0, total: 1 });
+        (0, vitest_1.expect)(r.findings).toHaveLength(1);
+        (0, vitest_1.expect)(r.findings[0].fixPath).toEqual(["verify_password"]);
+        (0, vitest_1.expect)(r.findings[0].reasoningSteps.length).toBe(1);
+        (0, vitest_1.expect)(r.autoApplied).toBe(false); // 铁律：永不自动合并
+        (0, vitest_1.expect)(r.auditTrail.map((e) => e.event)).toContain("patrol:scan");
+    });
+    (0, vitest_1.it)("无违规时 APPROVED 报告不含明细", async () => {
+        mockEvaluateTrust.mockResolvedValue(trustDecision({
+            overall: { score: 95, decision: "APPROVED", confidence: "HIGH" },
+            violations: [],
+            violationTraces: [],
+            summary: { critical: 0, high: 0, medium: 0, low: 0, total: 0 },
+        }));
+        const r = await (0, agent_patrol_1.runPatrol)("/tmp/fake-project");
+        (0, vitest_1.expect)(r.decision).toBe("APPROVED");
+        (0, vitest_1.expect)(r.findings).toHaveLength(0);
+        const md = (0, agent_patrol_1.formatPatrolMarkdown)(r);
+        (0, vitest_1.expect)(md).toContain("未发现违规");
+        (0, vitest_1.expect)(md).toContain("自动合并: 永不");
+    });
+    (0, vitest_1.it)("Markdown 报告含建议补丁路径与证据链回放", async () => {
+        mockEvaluateTrust.mockResolvedValue(trustDecision());
+        const r = await (0, agent_patrol_1.runPatrol)("/tmp/fake-project");
+        const md = (0, agent_patrol_1.formatPatrolMarkdown)(r);
+        (0, vitest_1.expect)(md).toContain("免疫巡逻报告");
+        (0, vitest_1.expect)(md).toContain("SSG_PROTOCOL");
+        (0, vitest_1.expect)(md).toContain("建议补丁路径");
+        (0, vitest_1.expect)(md).toContain("verify_password");
+        (0, vitest_1.expect)(md).toContain("推理回放");
+        (0, vitest_1.expect)(md).toContain("证据链（可回放）");
+        (0, vitest_1.expect)(md).toContain("checkId: check_abc");
+    });
+    (0, vitest_1.it)("writePatrolReport 落盘到项目目录", async () => {
+        const fs = require("fs");
+        const os = require("os");
+        const path = require("path");
+        const dir = fs.mkdtempSync(path.join(os.tmpdir(), "pm-patrol-"));
+        mockEvaluateTrust.mockResolvedValue(trustDecision());
+        const r = await (0, agent_patrol_1.runPatrol)(dir);
+        const reportPath = (0, agent_patrol_1.writePatrolReport)(r, dir);
+        (0, vitest_1.expect)(fs.existsSync(reportPath)).toBe(true);
+        const content = fs.readFileSync(reportPath, "utf-8");
+        (0, vitest_1.expect)(content).toContain("免疫巡逻报告");
+    });
+});

package/dist/agent-perception.js

@@ -0,0 +1,197 @@
+"use strict";
+/**
+ * Phase 12: Agent 感知层 (P2)
+ *
+ * 为 agent loop 提供"看清世界"的能力（设计文档 P2）：
+ *   - GitContext     — 仓库扫描 + git 上下文（分支/最近提交/变更文件/源文件清单）
+ *   - extractIRWithDelta — IR 提取 + 前后函数名差集（IR 增量重提的观测面）
+ *   - RepoWatcher    — 文件变更监听（fs.watch + 防抖）→ 触发 IR 重提回调
+ *
+ * 原则：感知失败不阻塞主循环（best-effort，明确记录 unavailable）。
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RepoWatcher = void 0;
+exports.collectGitContext = collectGitContext;
+exports.extractIRWithDelta = extractIRWithDelta;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const extract_ir_1 = require("./extract-ir");
+// ── Git Context ──
+function git(projectPath, args) {
+    return (0, child_process_1.execSync)(`git -C "${projectPath}" ${args}`, {
+        encoding: "utf-8",
+        timeout: 10000,
+        stdio: "pipe",
+    });
+}
+/** 收集仓库上下文（分支、最近提交、变更文件）与源文件清单。best-effort。 */
+function collectGitContext(projectPath) {
+    try {
+        const branch = git(projectPath, "rev-parse --abbrev-ref HEAD").trim();
+        const recentCommits = git(projectPath, "log --oneline -5")
+            .split("\n").filter(Boolean);
+        // porcelain 输出首字符可能是空格（未暂存），必须整串不 trim 才能保住 3 字符状态列
+        const changedFiles = git(projectPath, "status --porcelain")
+            .split("\n").filter(Boolean).map((l) => l.slice(3).trim());
+        const sourceFiles = listSourceFiles(projectPath);
+        return { available: true, branch, recentCommits, changedFiles, sourceFiles };
+    }
+    catch (e) {
+        // 非 git 仓库等 → 只给源文件清单
+        try {
+            return {
+                available: false,
+                branch: "",
+                recentCommits: [],
+                changedFiles: [],
+                sourceFiles: listSourceFiles(projectPath),
+                error: e?.message || String(e),
+            };
+        }
+        catch {
+            return { available: false, branch: "", recentCommits: [], changedFiles: [], sourceFiles: [], error: e?.message || String(e) };
+        }
+    }
+}
+/** 浅层扫描项目源文件（不递归进依赖目录）。 */
+function listSourceFiles(projectPath) {
+    const SKIP_DIRS = new Set(["node_modules", "dist", "build", ".git", ".progmune_corpus", "__pycache__", "venv", ".venv"]);
+    const EXTS = new Set([".ts", ".js", ".py", ".tsx", ".jsx"]);
+    const out = [];
+    const stack = [projectPath];
+    const seen = new Set();
+    while (stack.length > 0 && out.length < 500) {
+        const dir = stack.pop();
+        if (seen.has(dir))
+            continue;
+        seen.add(dir);
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const e of entries) {
+            const full = path.join(dir, e.name);
+            if (e.isDirectory()) {
+                if (!SKIP_DIRS.has(e.name) && !e.name.startsWith("."))
+                    stack.push(full);
+            }
+            else if (EXTS.has(path.extname(e.name))) {
+                out.push(path.relative(projectPath, full));
+            }
+        }
+    }
+    return out.sort();
+}
+// ── IR 增量 ──
+/**
+ * 提取 IR 并计算与上次函数名集合的差集。
+ * prevNames 缺省时只返回全量 IR（delta 为空）。
+ */
+function extractIRWithDelta(projectPath, prevNames) {
+    const ir = (0, extract_ir_1.extractIR)(projectPath);
+    const names = ir.map((f) => String(f.name || "")).filter(Boolean);
+    if (!prevNames) {
+        return { ir, delta: { added: [], removed: [], functionCount: names.length } };
+    }
+    const cur = new Set(names);
+    const added = names.filter((n) => !prevNames.has(n));
+    const removed = [...prevNames].filter((n) => !cur.has(n));
+    return { ir, delta: { added, removed, functionCount: names.length } };
+}
+// ── Repo Watcher ──
+const WATCH_EXTS = new Set([".ts", ".js", ".py", ".tsx", ".jsx"]);
+/**
+ * 文件变更监听器：fs.watch 递归监听项目目录，按文件防抖后回调。
+ * 用途：agent 或用户修改文件后触发 IR 增量重提（IR_STALE 消费方）。
+ */
+class RepoWatcher {
+    constructor(projectPath, onChange, debounceMs = 500) {
+        this.projectPath = projectPath;
+        this.onChange = onChange;
+        this.debounceMs = debounceMs;
+        this.watcher = null;
+        this.timers = new Map();
+    }
+    start() {
+        if (this.watcher)
+            return;
+        try {
+            this.watcher = fs.watch(this.projectPath, { recursive: true }, (event, filename) => {
+                if (!filename)
+                    return;
+                const ext = path.extname(String(filename));
+                if (!WATCH_EXTS.has(ext))
+                    return;
+                const rel = path.relative(this.projectPath, path.join(this.projectPath, String(filename)));
+                // 防抖：同一文件的连续事件合并
+                const prev = this.timers.get(rel);
+                if (prev)
+                    clearTimeout(prev);
+                this.timers.set(rel, setTimeout(() => {
+                    this.timers.delete(rel);
+                    try {
+                        this.onChange(rel);
+                    }
+                    catch { /* 回调异常不杀死 watcher */ }
+                }, this.debounceMs));
+            });
+            this.watcher.on("error", () => { });
+        }
+        catch {
+            this.watcher = null; // recursive 不支持时降级为不可用
+        }
+    }
+    stop() {
+        for (const t of this.timers.values())
+            clearTimeout(t);
+        this.timers.clear();
+        if (this.watcher) {
+            try {
+                this.watcher.close();
+            }
+            catch { /* ignore */ }
+            this.watcher = null;
+        }
+    }
+    get active() {
+        return this.watcher !== null;
+    }
+}
+exports.RepoWatcher = RepoWatcher;

package/dist/agent-perception.test.js

@@ -0,0 +1,125 @@
+"use strict";
+/**
+ * Phase 12: 感知层测试 (P2)
+ *
+ * collectGitContext / extractIRWithDelta：mock git 与 IR，不触真实仓库。
+ * RepoWatcher：真实临时目录（fs.watch 需要真实文件系统）。
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const child_process_1 = require("child_process");
+const extract_ir_1 = require("./extract-ir");
+const agent_perception_1 = require("./agent-perception");
+vitest_1.vi.mock("child_process", () => ({
+    execSync: vitest_1.vi.fn(),
+}));
+vitest_1.vi.mock("./extract-ir", () => ({
+    extractIR: vitest_1.vi.fn(),
+}));
+const mockExecSync = vitest_1.vi.mocked(child_process_1.execSync);
+const mockExtractIR = vitest_1.vi.mocked(extract_ir_1.extractIR);
+(0, vitest_1.beforeEach)(() => {
+    vitest_1.vi.clearAllMocks();
+});
+(0, vitest_1.describe)("agent-perception", () => {
+    (0, vitest_1.it)("collectGitContext 解析分支/提交/变更文件/源文件清单", () => {
+        mockExecSync.mockImplementation((cmd) => {
+            const c = String(cmd);
+            if (c.includes("rev-parse"))
+                return "main";
+            if (c.includes("log --oneline"))
+                return "abc123 feat: login\nbcd456 fix: session";
+            if (c.includes("status --porcelain"))
+                return " M src/auth.ts\n?? src/new.ts";
+            throw new Error("unexpected cmd: " + c);
+        });
+        const ctx = (0, agent_perception_1.collectGitContext)("/tmp/fake-project");
+        (0, vitest_1.expect)(ctx.available).toBe(true);
+        (0, vitest_1.expect)(ctx.branch).toBe("main");
+        (0, vitest_1.expect)(ctx.recentCommits).toHaveLength(2);
+        (0, vitest_1.expect)(ctx.changedFiles).toEqual(["src/auth.ts", "src/new.ts"]);
+        (0, vitest_1.expect)(ctx.sourceFiles.length).toBeGreaterThanOrEqual(0);
+    });
+    (0, vitest_1.it)("collectGitContext 非 git 仓库时降级为 available=false 且不抛", () => {
+        mockExecSync.mockImplementation(() => {
+            throw new Error("fatal: not a git repository");
+        });
+        const ctx = (0, agent_perception_1.collectGitContext)("/tmp/fake-project");
+        (0, vitest_1.expect)(ctx.available).toBe(false);
+        (0, vitest_1.expect)(ctx.error).toContain("not a git repository");
+    });
+    (0, vitest_1.it)("extractIRWithDelta 计算新增/消失函数差集", () => {
+        mockExtractIR.mockReturnValue([
+            { name: "verify_password" },
+            { name: "main" },
+        ]);
+        const prev = new Set(["verify_password", "logout"]);
+        const { delta } = (0, agent_perception_1.extractIRWithDelta)("/tmp/fake-project", prev);
+        (0, vitest_1.expect)(delta.added).toEqual(["main"]);
+        (0, vitest_1.expect)(delta.removed).toEqual(["logout"]);
+        (0, vitest_1.expect)(delta.functionCount).toBe(2);
+    });
+    (0, vitest_1.it)("RepoWatcher 文件变更防抖回调", async () => {
+        const fs = await Promise.resolve().then(() => __importStar(require("fs")));
+        const os = await Promise.resolve().then(() => __importStar(require("os")));
+        const path = await Promise.resolve().then(() => __importStar(require("path")));
+        const dir = fs.mkdtempSync(path.join(os.tmpdir(), "pm-watch-"));
+        const changed = [];
+        const w = new agent_perception_1.RepoWatcher(dir, (f) => changed.push(f), 50);
+        w.start();
+        // 等待 watcher 就绪后写文件
+        await new Promise((r) => setTimeout(r, 100));
+        fs.writeFileSync(path.join(dir, "new.ts"), "export function f() {}");
+        await new Promise((r) => setTimeout(r, 300));
+        w.stop();
+        (0, vitest_1.expect)(changed).toContain("new.ts");
+        (0, vitest_1.expect)(w.active).toBe(false);
+    });
+    (0, vitest_1.it)("RepoWatcher 忽略非源文件扩展名", async () => {
+        const fs = await Promise.resolve().then(() => __importStar(require("fs")));
+        const os = await Promise.resolve().then(() => __importStar(require("os")));
+        const path = await Promise.resolve().then(() => __importStar(require("path")));
+        const dir = fs.mkdtempSync(path.join(os.tmpdir(), "pm-watch2-"));
+        const changed = [];
+        const w = new agent_perception_1.RepoWatcher(dir, (f) => changed.push(f), 50);
+        w.start();
+        await new Promise((r) => setTimeout(r, 100));
+        fs.writeFileSync(path.join(dir, "notes.txt"), "hello");
+        await new Promise((r) => setTimeout(r, 300));
+        w.stop();
+        (0, vitest_1.expect)(changed).toHaveLength(0);
+    });
+});