@alan512/experienceengine 0.3.6 → 0.4.1

package/README.md

@@ -6,7 +6,7 @@ ExperienceEngine is a governance layer for coding agents that reuses real execut
 
 **Memory does addition. ExperienceEngine does governance.**
 
-Supported hosts today: `OpenClaw`, `Claude Code`, `Codex`
+Supported hosts today: `OpenClaw`, `Claude Code`, `Codex`, and validated Google Antigravity Agent Desktop support
 
 ## 10-Second Example
 
@@ -62,6 +62,9 @@ npm install -g @alan512/experienceengine
   - `/plugin marketplace add https://github.com/Alan-512/ExperienceEngine.git`
   - `/plugin install experienceengine@experienceengine`
   - `ee init`
+- `Google Antigravity`
+  - `ee install antigravity`
+  - `ee init`
 
 `ee init` initializes shared ExperienceEngine state after the host-specific installation step.
 
@@ -88,6 +91,7 @@ Do not use ExperienceEngine if:
 | `OpenClaw` | native plugin install | host-native | most complete today |
 | `Claude Code` | marketplace plugin, with `ee install claude-code` fallback | MCP + plugin hooks | supported |
 | `Codex` | `ee install codex`, with native MCP fallback | hooks + MCP | supported |
+| Google Antigravity Agent Desktop + `agy` CLI | `ee install antigravity`, `ee agy exec -C <project>` for CLI runs | MCP + validated native hooks | supported through user-level Antigravity plugin wiring and `ee agy exec` |
 
 ## Why It Exists
 
@@ -116,6 +120,9 @@ ExperienceEngine is not trying to remember more things than the host. Its core j
 - posttask review can revise whether a hint actually helped, harmed, or stayed uncertain
 - delivery decisions are persisted even when no hint is shipped, so skipped turns can still be explained later
 - high-match same-repo experience can move out of conservative delivery after successful reuse, while cross-repo reuse stays cautious unless there is stronger evidence
+- calculated cross-repo portability scorecards and SemVer penalties prevent unsafe sharing across different scopes
+- post-task causal trajectory attributions ensure outcome feedback is only recorded when the agent actually adopted the injected guidance
+- quarantine leases and shadow probes provide a safe, monitored recovery path to conservative delivery without erasing historical lessons
 - the product goal is production-safe reuse, not maximum recall
 
 ## Where It Sits In The Agent Loop
@@ -149,8 +156,10 @@ Each node moves through that lifecycle using real task outcomes, not just time-b
 ### Under The Hood
 
 - MCP-native interaction surfaces plus CLI/operator fallback
-- semantic retrieval with API and local fallback
-- deterministic match scorecards that separate same-repo confidence from broader cross-repo reuse
+- semantic retrieval with API and local fallback (including `strict-offline` profiles, manifest health checks, and vector migration)
+- deterministic match scorecards with portability bands (`validated_portable`, `cautiously_portable`, `incompatible`) and SemVer mismatch penalties
+- post-task causal trajectory attributions (`adoption_detected`, `non_adoption_detected`, `unverifiable`)
+- quarantine shadow-probe lease cycles with no-harm counters and conservative restoration
 - host-agent driven inspection and feedback, with CLI fallback commands such as `ee inspect --last`, `ee helped`, and `ee harmed`
 
 ### Interaction Surface Tiers
@@ -299,7 +308,7 @@ Use the `ee` CLI when you need explicit operator validation or troubleshooting:
 
 ```bash
 ee init
-ee doctor <openclaw|claude-code|codex>
+ee doctor <openclaw|claude-code|codex|antigravity>
 ee status
 ee maintenance embedding-smoke
 ```
@@ -342,6 +351,7 @@ If you need explicit per-host control as an operator or while developing the pro
 ee install openclaw
 ee install claude-code
 ee install codex
+ee install antigravity
 ```
 
 <details>
@@ -359,6 +369,7 @@ Notes:
 - `Codex` installs Codex-native hooks plus the shared ExperienceEngine MCP server. `ee codex exec` remains the deterministic non-interactive fallback.
 - Codex `UserPromptSubmit` stays synchronous because it owns prompt-time experience injection. `PostToolUse` and `Stop` are queued for background processing by default. `PreToolUse` is not registered by default; set `EXPERIENCE_ENGINE_CODEX_PRETOOL_HOOK_ENABLED=1` only for synchronous gating experiments.
 - Codex App and Codex CLI both load repo-level project hooks when they open the same repo. If Codex says hooks need review, open `/hooks` and approve ExperienceEngine's `UserPromptSubmit`, `PostToolUse`, and `Stop` hooks. If `EXPERIENCE_ENGINE_CODEX_PRETOOL_HOOK_ENABLED=1` was used, approve `PreToolUse` too.
+- `Google Antigravity` currently means Antigravity Agent Desktop, the standalone `agy` CLI, and Antigravity IDE for validated lifecycle automation. The IDE shell is tracked independently because it stores MCP tool cache under `~/.gemini/antigravity-ide`, but real-host validation showed it loads the shared global plugin hooks from `~/.gemini/config/plugins/experienceengine/hooks.json`. `ee doctor antigravity` reports whether the IDE command exists, whether IDE MCP tool cache files are observed, and whether IDE hooks are observed through the global plugin surface. EE data remains user-level under the configured ExperienceEngine home and project experience remains scope-isolated. `ee install antigravity` records user-level adapter capability and installs Antigravity user-level plugin/MCP wiring for Agent Desktop and `agy` CLI. `ee antigravity activate-project -C <project>` remains a project-local fallback. For CLI runs, prefer `ee agy exec -C <project> "<prompt>"`; it invokes `agy --add-dir <project> --print ...` because direct `agy` project auto-discovery can fail on Windows if symlink creation is not permitted. Antigravity supports both routine stdio MCP calls and an advanced artifact-assisted analyzer that automatically parses planning/verification markdown files (`task.md`, `walkthrough.md`, `implementation_plan.md`) for task outcomes, and reconciles them with runtime finalization telemetry.
 - `ee install ...` and `ee doctor ...` now warn if `npm` or `pnpm` uses a non-official registry, because managed model downloads are most reliable with `https://registry.npmjs.org`.
 - successful `ee install ...` also explains the cold-start expectation: capture starts immediately, but formal experience usually appears after a few similar tasks in the same repo.
 

package/README.zh-CN.md

@@ -6,7 +6,7 @@ ExperienceEngine 是一个面向编程 Agent 的治理层。它复用真实执
 
 **Memory 做加法，ExperienceEngine 做治理。**
 
-当前支持的宿主：`OpenClaw`、`Claude Code`、`Codex`
+当前支持的宿主：`OpenClaw`、`Claude Code`、`Codex`、`Google Antigravity Agent Desktop`
 
 ## 10 秒理解
 
@@ -62,6 +62,9 @@ npm install -g @alan512/experienceengine
   - `/plugin marketplace add https://github.com/Alan-512/ExperienceEngine.git`
   - `/plugin install experienceengine@experienceengine`
   - `ee init`
+- `Google Antigravity`
+  - `ee install antigravity`
+  - `ee init`
 
 `ee init` 用于在宿主安装完成后初始化共享的 ExperienceEngine 状态。
 
@@ -88,6 +91,7 @@ npm install -g @alan512/experienceengine
 | `OpenClaw` | 原生插件安装 | 宿主原生 | 当前最完整 |
 | `Claude Code` | marketplace 插件，保留 `ee install claude-code` fallback | MCP + plugin hooks | 已支持 |
 | `Codex` | `ee install codex`，保留原生 MCP fallback | hooks + MCP | 已支持 |
+| `Google Antigravity Agent Desktop` + `agy` CLI | `ee install antigravity`，CLI 运行使用 `ee agy exec -C <project>` | MCP + 已验证的原生 hooks | 通过用户级 Antigravity plugin wiring 与 `ee agy exec` 支持 |
 
 ## 为什么要做这个
 
@@ -116,6 +120,9 @@ ExperienceEngine 不是想比宿主“记住更多东西”。它的核心价值
 - 任务结束后的审查会继续判断这条 hint 到底是帮到了、伤害了，还是仍然不确定
 - 即使这次没有注入 hint，delivery decision 也会被记录下来，所以之后仍然能解释为什么跳过
 - 同仓库高匹配经验在成功复用后可以从保守投放提升到正常投放；跨仓库复用默认仍保持保守，除非后续证据更强
+- 计算跨仓库的 portability scorecard 和 SemVer 兼容惩罚，防范跨 scope 的不安全经验复用
+- 任务结束后的因果轨迹归因（Causal Trajectory Attribution）确保只有在 agent 真正采纳了注入约束时，才计入 outcome 反馈
+- 提供隔离租期（quarantine lease）与 shadow probe 周期，引导隔离节点通过无害验证后安全、保守地恢复，同时完整保留历史记录
 - 这个产品追求的是“生产安全的经验复用”，不是“尽量多记、尽量多召回”
 
 ## 它在 Agent Loop 里的位置
@@ -148,8 +155,10 @@ ExperienceEngine 工作在 context 层，不会修改宿主模型权重。
 ### 底层实现
 
 - MCP 原生交互面，加上 CLI / operator fallback
-- 支持 API 与本地回退的语义检索
-- 确定性的 match scorecard，用来区分同仓库高置信匹配和更宽泛的跨仓库复用
+- 支持 API 与本地回退的语义检索（包含 `strict-offline` 离线配置、模型 manifest 校验和向量迁移状态）
+- 确定性的 match scorecard 包含移植分级（`validated_portable`、`cautiously_portable`、`incompatible`）与 SemVer 版本偏差惩罚
+- 任务后的因果轨迹归因评分（`adoption_detected`、`non_adoption_detected`、`unverifiable`）
+- 隔离节点的 shadow-probe 租期管理，包含无害通过计数器与保守恢复机制
 - 宿主 agent 内可直接查看和反馈经验，CLI fallback 包括 `ee inspect --last`、`ee helped`、`ee harmed`
 
 如果你想看 ExperienceNode 结构和治理字段，见：
@@ -289,7 +298,7 @@ ExperienceEngine 的交互面分成三层：
 
 ```bash
 ee init
-ee doctor <openclaw|claude-code|codex>
+ee doctor <openclaw|claude-code|codex|antigravity>
 ee status
 ee maintenance embedding-smoke
 ```
@@ -332,6 +341,7 @@ ExperienceEngine 明确拆分：
 ee install openclaw
 ee install claude-code
 ee install codex
+ee install antigravity
 ```
 
 <details>
@@ -345,6 +355,7 @@ codex mcp add experienceengine --env EXPERIENCE_ENGINE_HOME=$HOME/.experienceeng
 
 说明：
 - `OpenClaw` 走 plugin/runtime integration，而不是 `src/adapters/`
+- `Google Antigravity` 当前指已验证生命周期自动化的 Antigravity Agent Desktop、独立 `agy` CLI 和 Antigravity IDE。IDE 外壳会作为单独 surface 跟踪，因为它的 MCP tool cache 位于 `~/.gemini/antigravity-ide`；真实宿主验证显示 IDE 会加载共享全局插件 hooks：`~/.gemini/config/plugins/experienceengine/hooks.json`。`ee doctor antigravity` 会报告 IDE 命令是否存在、是否观察到 IDE MCP tool cache、以及是否通过全局插件 surface 观察到 IDE hooks。EE 数据仍然是用户级，放在配置的 ExperienceEngine home 下，不同项目通过 project scope 隔离经验。`ee install antigravity` 会记录用户级 adapter 能力，并为 Agent Desktop 与 `agy` CLI 安装 Antigravity 用户级 plugin/MCP wiring；`ee antigravity activate-project -C <project>` 保留为项目级 fallback。CLI 运行优先使用 `ee agy exec -C <project> "<prompt>"`，它会调用 `agy --add-dir <project> --print ...`，因为 Windows 下直接 `agy` 项目自动发现可能因为无法创建 symlink 而不加载项目配置。Antigravity 既支持常规 stdio MCP 调用，也支持高级的“基于文档的因果归因分析器”，会自动解析规划/验证 Markdown 文件（`task.md`、`walkthrough.md`、`implementation_plan.md`）以评估任务执行状态，并与运行时 finalization 遥测数据进行对齐。
 - `Claude Code` 会安装 hooks 和共享 ExperienceEngine MCP 服务
 - `Codex` 会安装 Codex 原生 hooks 和共享 ExperienceEngine MCP 服务。`ee codex exec` 仍是确定性的非交互 fallback。
 - Codex 的 `UserPromptSubmit` 保持同步，因为它负责 prompt-time experience injection。`PostToolUse` 和 `Stop` 默认排队后在后台处理。`PreToolUse` 默认不注册；只有同步 gating 实验需要时才设置 `EXPERIENCE_ENGINE_CODEX_PRETOOL_HOOK_ENABLED=1` 启用。

package/dist/adapters/antigravity/artifact-analyzer.d.ts

@@ -0,0 +1,27 @@
+export type VerificationStatus = "passed" | "failed" | "unverified";
+export type ArtifactEvidence = {
+    tasksCompleted: number;
+    tasksTotal: number;
+    hasExperienceEngineRefs: boolean;
+    hasCausalAttribution: boolean;
+    experienceRefs: string[];
+    sessionIds: string[];
+    verdicts: Array<{
+        file: string;
+        line: string;
+        verdict: "passed" | "failed";
+    }>;
+};
+export type ArtifactAnalysisResult = {
+    verificationStatus: VerificationStatus;
+    evidence: ArtifactEvidence;
+};
+/**
+ * Parses individual file content for task items, verification verdicts, and ExperienceEngine references.
+ */
+export declare const parseArtifactContent: (content: string, filename: string) => ArtifactAnalysisResult;
+/**
+ * Searches the workspace for target planning artifacts and returns aggregate analysis results.
+ * Respects explicit runtime finalization facts by combining telemetry if available.
+ */
+export declare const analyzeWorkspaceArtifacts: (workspaceDir: string, targetFiles?: string[]) => ArtifactAnalysisResult;

package/dist/adapters/antigravity/artifact-analyzer.js

@@ -0,0 +1,151 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+/**
+ * Parses individual file content for task items, verification verdicts, and ExperienceEngine references.
+ */
+export const parseArtifactContent = (content, filename) => {
+    let tasksCompleted = 0;
+    let tasksTotal = 0;
+    let hasExperienceEngineRefs = false;
+    const experienceRefs = new Set();
+    const sessionIds = new Set();
+    const verdicts = [];
+    const lines = content.split(/\r?\n/);
+    // Check for ExperienceEngine general mentions (case insensitive)
+    if (/experience[-_]?engine/i.test(content) || /antigravity/i.test(content)) {
+        hasExperienceEngineRefs = true;
+    }
+    // Look for session IDs or UUIDs in the text
+    const uuidRegex = /[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/gi;
+    let match;
+    while ((match = uuidRegex.exec(content)) !== null) {
+        sessionIds.add(match[0].toLowerCase());
+    }
+    // Look for experience node patterns (e.g. node_xxx or experienceengine://xxx)
+    const nodeRegex = /(?:node_[a-zA-Z0-9_]+|experienceengine:\/\/[a-zA-Z0-9_\-\/]+)/gi;
+    while ((match = nodeRegex.exec(content)) !== null) {
+        experienceRefs.add(match[0]);
+    }
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // 1. Task checkbox parsing
+        // Supports - [x], - [ ], - [/], * [x], etc.
+        const checkboxMatch = trimmed.match(/^[-*]\s+`\[([ x\/])\]`/i) || trimmed.match(/^[-*]\s+\[([ x\/])\]/i);
+        if (checkboxMatch) {
+            tasksTotal++;
+            const marker = checkboxMatch[1].toLowerCase();
+            if (marker === "x") {
+                tasksCompleted++;
+            }
+        }
+        // 2. Explicit Verification Verdicts
+        // Check for explicit "verification status: passed", "verification: failed" etc.
+        const explicitPassed = trimmed.match(/(?:verification|verdict|status|result)\s*[:=-]\s*[`"']?(passed|success|helped)[`"']?/i);
+        const explicitFailed = trimmed.match(/(?:verification|verdict|status|result)\s*[:=-]\s*[`"']?(failed|harmed|misfired)[`"']?/i);
+        if (explicitPassed) {
+            verdicts.push({ file: filename, line: trimmed, verdict: "passed" });
+        }
+        else if (explicitFailed) {
+            verdicts.push({ file: filename, line: trimmed, verdict: "failed" });
+        }
+        // Check for marked checkbox lines with verification terms, e.g. - [x] Passed automated tests
+        const checkboxPassed = trimmed.match(/^[-*]\s+\[x\]\s+.*(passed|success|verified|ok|correct)/i) ||
+            trimmed.match(/^[-*]\s+`\[x\]`\s+.*(passed|success|verified|ok|correct)/i);
+        const checkboxFailed = trimmed.match(/^[-*]\s+\[x\]\s+.*(failed|broken|misfired|error)/i) ||
+            trimmed.match(/^[-*]\s+`\[x\]`\s+.*(failed|broken|misfired|error)/i);
+        if (checkboxPassed) {
+            verdicts.push({ file: filename, line: trimmed, verdict: "passed" });
+        }
+        else if (checkboxFailed) {
+            verdicts.push({ file: filename, line: trimmed, verdict: "failed" });
+        }
+    }
+    // Determine Verification Status for this single file
+    let verificationStatus = "unverified";
+    if (verdicts.some(v => v.verdict === "failed")) {
+        verificationStatus = "failed";
+    }
+    else if (verdicts.some(v => v.verdict === "passed")) {
+        verificationStatus = "passed";
+    }
+    else if (tasksTotal > 0 && tasksCompleted === tasksTotal) {
+        // If all tasks are checked off and no failures found, default to passed
+        verificationStatus = "passed";
+    }
+    return {
+        verificationStatus,
+        evidence: {
+            tasksCompleted,
+            tasksTotal,
+            hasExperienceEngineRefs,
+            hasCausalAttribution: verdicts.length > 0,
+            experienceRefs: Array.from(experienceRefs),
+            sessionIds: Array.from(sessionIds),
+            verdicts
+        }
+    };
+};
+/**
+ * Searches the workspace for target planning artifacts and returns aggregate analysis results.
+ * Respects explicit runtime finalization facts by combining telemetry if available.
+ */
+export const analyzeWorkspaceArtifacts = (workspaceDir, targetFiles = ["task.md", "walkthrough.md", "implementation_plan.md"]) => {
+    let aggregateStatus = "unverified";
+    let totalTasksCompleted = 0;
+    let totalTasksTotal = 0;
+    let hasExperienceEngineRefs = false;
+    const experienceRefs = new Set();
+    const sessionIds = new Set();
+    const allVerdicts = [];
+    for (const filename of targetFiles) {
+        const filePath = join(workspaceDir, filename);
+        if (!existsSync(filePath)) {
+            continue;
+        }
+        try {
+            const content = readFileSync(filePath, "utf8");
+            const result = parseArtifactContent(content, filename);
+            totalTasksCompleted += result.evidence.tasksCompleted;
+            totalTasksTotal += result.evidence.tasksTotal;
+            if (result.evidence.hasExperienceEngineRefs) {
+                hasExperienceEngineRefs = true;
+            }
+            for (const ref of result.evidence.experienceRefs) {
+                experienceRefs.add(ref);
+            }
+            for (const sid of result.evidence.sessionIds) {
+                sessionIds.add(sid);
+            }
+            for (const v of result.evidence.verdicts) {
+                allVerdicts.push(v);
+            }
+            // Propagate statuses: failed takes precedence over passed, passed over unverified
+            if (result.verificationStatus === "failed") {
+                aggregateStatus = "failed";
+            }
+            else if (result.verificationStatus === "passed" && aggregateStatus !== "failed") {
+                aggregateStatus = "passed";
+            }
+        }
+        catch {
+            // Ignore reading errors gracefully
+        }
+    }
+    // If no explicit verdicts but we checked off all tasks, and total > 0, aggregate is passed
+    if (aggregateStatus === "unverified" && totalTasksTotal > 0 && totalTasksCompleted === totalTasksTotal) {
+        aggregateStatus = "passed";
+    }
+    return {
+        verificationStatus: aggregateStatus,
+        evidence: {
+            tasksCompleted: totalTasksCompleted,
+            tasksTotal: totalTasksTotal,
+            hasExperienceEngineRefs,
+            hasCausalAttribution: allVerdicts.length > 0,
+            experienceRefs: Array.from(experienceRefs),
+            sessionIds: Array.from(sessionIds),
+            verdicts: allVerdicts
+        }
+    };
+};
+//# sourceMappingURL=artifact-analyzer.js.map

package/dist/adapters/antigravity/artifact-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-analyzer.js","sourceRoot":"","sources":["../../../src/adapters/antigravity/artifact-analyzer.ts"],"names":[],"mappings":"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"}

package/dist/adapters/codex/behavior-loop.d.ts

@@ -1,40 +1,12 @@
-import type { ExperienceRuntimeService } from "../../runtime/service.js";
-import type { ToolEventStatus } from "../../types/domain.js";
-export type CodexLookupArgs = {
-    cwd?: string;
-    prompt: string;
-    sessionId?: string;
-};
-export type CodexToolResultArgs = {
-    sessionId: string;
-    toolName: string;
-    inputSummary?: string;
-    outputSummary?: string;
-    errorSignature?: string;
-    exitCode?: number;
-    status?: ToolEventStatus;
-};
-export type CodexFinalizeArgs = {
-    sessionId: string;
-    cwd?: string;
-    prompt?: string;
-    contextSummary?: string;
-    injectedNodeIds?: string[];
-};
-export type CodexHostEventArgs = {
-    cwd?: string;
-    sessionId?: string;
-    trigger: "host_startup" | "prompt_lookup" | "posttask" | "stop";
-};
-export type CodexServerOptions = {
-    env?: NodeJS.ProcessEnv;
-    homeDir?: string;
-    fetchImpl?: typeof fetch;
-    runtimeOptions?: ConstructorParameters<typeof ExperienceRuntimeService>[2];
-};
+import { type SharedLookupArgs, type SharedToolResultArgs, type SharedFinalizeArgs, type SharedHostEventArgs, type SharedServerOptions } from "../shared-mcp/behavior-loop.js";
+export type CodexLookupArgs = SharedLookupArgs;
+export type CodexToolResultArgs = SharedToolResultArgs;
+export type CodexFinalizeArgs = SharedFinalizeArgs;
+export type CodexHostEventArgs = SharedHostEventArgs;
+export type CodexServerOptions = SharedServerOptions;
 export declare const createCodexBehaviorLoop: (options?: CodexServerOptions) => {
-    lookupHints(args: CodexLookupArgs): Promise<{
-        mode: import("../../types/domain.js").InjectionMode;
+    lookupHints(args: SharedLookupArgs): Promise<{
+        mode: import("../../index.js").InjectionMode;
         text: string | undefined;
         notice: string | undefined;
         injectedNodeIds: string[] | never[];
@@ -63,25 +35,25 @@ export declare const createCodexBehaviorLoop: (options?: CodexServerOptions) =>
                 harmed: number | undefined;
             }[];
         } | undefined;
-        deliveryMode: import("../../types/domain.js").EvaluationMode | undefined;
+        deliveryMode: import("../../index.js").EvaluationMode | undefined;
         delivered: boolean | undefined;
     }>;
-    signalHostEvent(args: CodexHostEventArgs): Promise<{
+    signalHostEvent(args: SharedHostEventArgs): Promise<{
         status: "disabled" | "queued" | "skipped";
         reason?: "not_due" | "backoff";
         scopeId?: string;
     }>;
-    recordToolResult(args: CodexToolResultArgs): Promise<{
+    recordToolResult(args: SharedToolResultArgs): Promise<{
         status: string;
         toolName: string;
-        eventStatus: ToolEventStatus;
+        eventStatus: import("../../index.js").ToolEventStatus;
         hasErrorSignature: boolean;
         exitCode: number | undefined;
     }>;
-    finalizeTask(args: CodexFinalizeArgs): Promise<{
+    finalizeTask(args: SharedFinalizeArgs): Promise<{
         status: string;
-        taskType: import("../../types/domain.js").ResolvedTaskType;
-        outcomeSignal: import("../../types/domain.js").OutcomeSignal;
+        taskType: import("../../index.js").ResolvedTaskType;
+        outcomeSignal: import("../../index.js").OutcomeSignal;
         injectedNodeIds: string[];
         recordedToolEvents: number;
         feedbackHint: string | undefined;

package/dist/adapters/codex/behavior-loop.js

@@ -1,218 +1,5 @@
-import { loadConfig } from "../../config/load-config.js";
-import { resolveExperienceEnginePaths } from "../../config/path-resolver.js";
-import { buildRetrievalPolicyInspectionSummary } from "../../interaction/retrieval-policy-inspection.js";
-import { ExperiencePromptRuntimeService } from "../../runtime/prompt-service.js";
-const createCodexConfig = (options = {}) => {
-    const paths = resolveExperienceEnginePaths({
-        adapter: "codex",
-        env: options.env ?? process.env,
-        homeDir: options.homeDir
-    });
-    return loadConfig({
-        dataDir: paths.dataDir,
-        sqlitePath: paths.sqlitePath,
-        captureDir: paths.captureDir
-    }, {
-        env: options.env ?? process.env,
-        homeDir: options.homeDir
-    });
-};
-const createCodexPromptRuntime = (options = {}) => new ExperiencePromptRuntimeService(createCodexConfig(options));
-const createCodexRuntime = async (options = {}) => {
-    const { ExperienceRuntimeService } = await import("../../runtime/service.js");
-    return new ExperienceRuntimeService(createCodexConfig(options), undefined, {
-        ...options.runtimeOptions,
-        autonomousHygieneGovernance: {
-            enabled: true,
-            ...options.runtimeOptions?.autonomousHygieneGovernance
-        }
-    });
-};
-const summarizeActionReason = (scorecard) => {
-    if (scorecard.mode === "inject_conservative") {
-        if (scorecard.decisionReason === "ambiguous_same_family_candidate") {
-            return "ExperienceEngine found a promising same-family match and chose conservative injection instead of skipping.";
-        }
-        if (scorecard.decisionReason === "promising_candidate_quality") {
-            return "ExperienceEngine found a credible candidate, but kept the injection conservative until it has stronger runtime proof.";
-        }
-        return "ExperienceEngine chose conservative injection because the best match still needs more runtime evidence.";
-    }
-    if (scorecard.decisionReason === "mature_validated_candidate") {
-        return "A mature validated candidate cleared the fast path, so ExperienceEngine injected it normally.";
-    }
-    if (scorecard.decisionReason === "candidate_quality_positive") {
-        return "Candidate quality was strong enough to justify intervention for this task.";
-    }
-    if (scorecard.mode === "inject") {
-        return "ExperienceEngine injected the best available reusable guidance for this task.";
-    }
-    return undefined;
-};
-const summarizeTrust = (scorecard) => {
-    const primaryNode = scorecard.nodes?.[0];
-    if (!scorecard.riskLevel || !primaryNode?.state) {
-        return undefined;
-    }
-    const confidence = scorecard.confidence ? ` ${scorecard.confidence}-confidence` : "";
-    return `${scorecard.riskLevel}-risk${confidence} ${primaryNode.state} guidance with ${primaryNode.helped ?? 0} helped and ${primaryNode.harmed ?? 0} harmed signal(s).`;
-};
-const summarizeRetrievalNotes = (scorecard) => {
-    const notes = [];
-    if (scorecard.queryRewriteApplied) {
-        notes.push("Query rewrite preserved retrieval intent for this task.");
-    }
-    const rerankSource = scorecard.topCandidates?.[0]?.rerankSource;
-    if (rerankSource === "model") {
-        notes.push("Model reranking participated in the final ordering.");
-    }
-    if (scorecard.fastPathApplied) {
-        notes.push("A strong candidate fast path was used.");
-    }
-    const topCandidate = scorecard.topCandidates?.[0];
-    if (topCandidate?.retrievalReasons?.length) {
-        notes.push(`Top retrieval signals: ${topCandidate.retrievalReasons.slice(0, 2).join(", ")}.`);
-    }
-    if (topCandidate?.policyReasons?.length) {
-        notes.push(`Top policy signals: ${topCandidate.policyReasons.slice(0, 2).join(", ")}.`);
-    }
-    if (scorecard.rejectedCandidates?.length) {
-        notes.push(`Runner-up candidates withheld: ${scorecard.rejectedCandidates.map((candidate) => candidate.id).join(", ")}.`);
-    }
-    return notes;
-};
-const summarizeScorecard = (scorecard) => scorecard
-    ? {
-        mode: scorecard.mode,
-        interventionStrength: scorecard.interventionStrength,
-        riskLevel: scorecard.riskLevel,
-        recommendation: scorecard.recommendation,
-        actionReason: summarizeActionReason(scorecard),
-        trustSummary: summarizeTrust(scorecard),
-        retrievalNotes: summarizeRetrievalNotes(scorecard),
-        retrievalPolicySummary: buildRetrievalPolicyInspectionSummary(scorecard),
-        confidence: scorecard.confidence,
-        budgetClass: scorecard.budgetClass,
-        selectedCandidateIds: scorecard.selectedCandidateIds,
-        rejectedCandidates: scorecard.rejectedCandidates?.slice(0, 3).map((candidate) => ({
-            id: candidate.id,
-            reasonCodes: candidate.reasonCodes
-        })) ?? [],
-        reasons: scorecard.reasons?.slice(0, 2),
-        nodes: scorecard.nodes?.slice(0, 3).map((node) => ({
-            id: node.id,
-            state: node.state,
-            riskLevel: node.riskLevel,
-            helped: node.helped,
-            harmed: node.harmed
-        })) ?? []
-    }
-    : undefined;
+import { createSharedBehaviorLoop } from "../shared-mcp/behavior-loop.js";
 export const createCodexBehaviorLoop = (options = {}) => {
-    let promptRuntime;
-    let runtime;
-    const promptLookups = new Map();
-    const getPromptRuntime = () => {
-        promptRuntime ??= createCodexPromptRuntime(options);
-        return promptRuntime;
-    };
-    const getRuntime = async () => {
-        runtime ??= createCodexRuntime(options);
-        return runtime;
-    };
-    return {
-        async lookupHints(args) {
-            if (args.sessionId) {
-                const existingRuntime = await getRuntime();
-                existingRuntime.resetSession(args.sessionId);
-            }
-            const fullRuntime = await getRuntime();
-            await fullRuntime.signalHostEvent({
-                host: "codex",
-                sessionId: args.sessionId,
-                cwd: args.cwd,
-                userMessage: args.prompt,
-                taskSummary: args.prompt
-            }, "prompt_lookup");
-            const context = {
-                host: "codex",
-                sessionId: args.sessionId,
-                cwd: args.cwd,
-                userMessage: args.prompt,
-                taskSummary: args.prompt
-            };
-            const result = await getPromptRuntime().beforePromptBuild(context);
-            promptLookups.set(args.sessionId ?? "global", {
-                context,
-                injectedNodeIds: result.input.injected_node_ids
-            });
-            return {
-                mode: result.mode,
-                text: result.text,
-                notice: result.notice,
-                injectedNodeIds: result.input.injected_node_ids,
-                summary: summarizeScorecard(result.scorecard),
-                deliveryMode: result.deliveryMode,
-                delivered: result.delivered
-            };
-        },
-        async signalHostEvent(args) {
-            const fullRuntime = await getRuntime();
-            return fullRuntime.signalHostEvent({
-                host: "codex",
-                sessionId: args.sessionId,
-                cwd: args.cwd,
-                userMessage: "",
-                taskSummary: args.trigger
-            }, args.trigger);
-        },
-        async recordToolResult(args) {
-            const fullRuntime = await getRuntime();
-            const event = await fullRuntime.persistToolResult({
-                sessionId: args.sessionId,
-                toolName: args.toolName,
-                inputSummary: args.inputSummary,
-                outputSummary: args.outputSummary,
-                errorSignature: args.errorSignature,
-                exitCode: args.exitCode,
-                status: args.status
-            });
-            return {
-                status: "recorded",
-                toolName: event.tool_name,
-                eventStatus: event.status,
-                hasErrorSignature: Boolean(event.error_signature),
-                exitCode: event.exit_code
-            };
-        },
-        async finalizeTask(args) {
-            const fullRuntime = await getRuntime();
-            const promptLookup = promptLookups.get(args.sessionId);
-            const input = await fullRuntime.finalizeTask({
-                host: "codex",
-                sessionId: args.sessionId,
-                cwd: args.cwd ?? promptLookup?.context.cwd,
-                userMessage: args.prompt ?? "",
-                taskSummary: args.prompt ?? promptLookup?.context.taskSummary,
-                contextSummary: args.contextSummary,
-                injectedNodeIds: args.injectedNodeIds ?? promptLookup?.injectedNodeIds
-            });
-            promptLookups.delete(args.sessionId ?? "global");
-            return {
-                status: "finalized",
-                taskType: input.task_type,
-                outcomeSignal: input.outcome_signal,
-                injectedNodeIds: input.injected_node_ids,
-                recordedToolEvents: input.tool_events.length,
-                feedbackHint: input.injected_node_ids.length > 0
-                    ? "If the injected guidance helped or harmed this task, call experienceengine_quick_feedback."
-                    : undefined
-            };
-        },
-        async waitForBackgroundLearning() {
-            const fullRuntime = await getRuntime();
-            await fullRuntime.waitForBackgroundLearning();
-        }
-    };
+    return createSharedBehaviorLoop("codex", options);
 };
 //# sourceMappingURL=behavior-loop.js.map