oh-my-opencode 5.0.0-beta.33 → 5.0.0-beta.35

package/packages/omo-codex/scripts/install-git-bash-mcp-env.test.mjs

@@ -62,30 +62,6 @@ test("#given a non-Windows install #when stamping #then the manifest stays byte-
 	assert.equal(await readFile(join(pluginRoot, ".mcp.json"), "utf8"), MANIFEST);
 });
 
-test("#given a package-relative CodeGraph MCP path #when stamping on non-Windows #then codegraph server arg becomes absolute", async (t) => {
-	const pluginRoot = await mkdtemp(join(tmpdir(), "git-bash-mcp-env-"));
-	t.after(() => rm(pluginRoot, { recursive: true, force: true }));
-	await writeFile(
-		join(pluginRoot, ".mcp.json"),
-		`${JSON.stringify(
-			{
-				mcpServers: {
-					codegraph: { args: ["components/codegraph/dist/serve.js"], command: "node" },
-					git_bash: { command: "node", args: ["../../git-bash-mcp/dist/cli.js", "mcp"] },
-				},
-			},
-			null,
-			"\t",
-		)}\n`,
-	);
-
-	const changed = await stampGitBashMcpEnv({ pluginRoot, env: {}, platform: "darwin" });
-
-	assert.equal(changed, true);
-	const parsed = JSON.parse(await readFile(join(pluginRoot, ".mcp.json"), "utf8"));
-	assert.deepEqual(parsed.mcpServers.codegraph.args, [join(pluginRoot, "components", "codegraph", "dist", "serve.js")]);
-});
-
 test("#given the override already stamped #when stamping again #then nothing changes", async (t) => {
 	const pluginRoot = await createPluginRoot();
 	t.after(() => rm(pluginRoot, { recursive: true, force: true }));
@@ -102,7 +78,7 @@ test("#given the override already stamped #when stamping again #then nothing cha
 test("#given a manifest without a git_bash server #when stamping #then the manifest stays byte-identical", async (t) => {
 	const pluginRoot = await mkdtemp(join(tmpdir(), "git-bash-mcp-env-"));
 	t.after(() => rm(pluginRoot, { recursive: true, force: true }));
-	const manifest = `${JSON.stringify({ mcpServers: { codegraph: { command: "node" } } }, null, "\t")}\n`;
+	const manifest = `${JSON.stringify({ mcpServers: { lsp: { command: "node" } } }, null, "\t")}\n`;
 	await writeFile(join(pluginRoot, ".mcp.json"), manifest);
 
 	const changed = await stampGitBashMcpEnv({

package/packages/omo-codex/scripts/install-mcp-runtime.test.mjs

@@ -104,42 +104,6 @@ test("#given plugin-local MCP runtime #when installing cached plugin #then manif
 	assert.deepEqual(cachedMcp.mcpServers.omo.args, [join(result.path, "dist", "cli.js")]);
 });
 
-test("#given CodeGraph MCP runtime in plugin cache #when installing cached plugin #then manifest points at cached plugin before bootstrap", async () => {
-	const repoRoot = await makeTempDir();
-	const codexHome = await makeTempDir();
-	const sourceRoot = join(repoRoot, "packages", "omo-codex", "plugin");
-
-	await writeJson(join(sourceRoot, "package.json"), {
-		name: "@example/omo",
-		version: "0.1.0",
-	});
-	await writeJson(join(sourceRoot, ".mcp.json"), {
-		mcpServers: {
-			codegraph: {
-				command: "node",
-				args: ["components/codegraph/dist/serve.js"],
-				cwd: ".",
-				required: false,
-			},
-		},
-	});
-	await writeJson(join(sourceRoot, "components", "codegraph", "dist", "serve.js"), { executable: true });
-
-	const result = await installCachedPlugin({
-		codexHome,
-		marketplaceName: "sisyphuslabs",
-		name: "omo",
-		runCommand: async () => {},
-		sourcePath: sourceRoot,
-		version: "0.1.0",
-	});
-
-	const cachedMcp = JSON.parse(await readFile(join(result.path, ".mcp.json"), "utf8"));
-
-	assert.deepEqual(cachedMcp.mcpServers.codegraph.args, [join(result.path, "components", "codegraph", "dist", "serve.js")]);
-	assert.equal(Object.hasOwn(cachedMcp.mcpServers.codegraph, "cwd"), false);
-});
-
 test("#given external MCP package not in the generated bundled runtime set #when installing cached plugin #then manifest args point at source", async () => {
 	const repoRoot = await makeTempDir();
 	const codexHome = await makeTempDir();

package/packages/shared-skills/skills/init-deep/SKILL.md

@@ -20,7 +20,7 @@ Generate hierarchical AGENTS.md files. Root + complexity-scored subdirectories.
 
 1. **Discovery + Analysis** (concurrent)
    - Fire background explore agents immediately
-   - Main session: bash structure + LSP/codegraph code map + read existing AGENTS.md
+   - Main session: bash structure + LSP/ast-grep code map + read existing AGENTS.md
 2. **Score & Decide** - Determine AGENTS.md locations from merged findings
 3. **Generate** - Root first, then subdirs in parallel
 4. **Review** - Deduplicate, trim, validate
@@ -29,7 +29,7 @@ Generate hierarchical AGENTS.md files. Root + complexity-scored subdirectories.
 **TodoWrite ALL phases. Mark in_progress → completed in real-time.**
 ```
 TodoWrite([
-  { id: "discovery", content: "Fire explore agents + LSP/codegraph map + read existing", status: "pending", priority: "high" },
+  { id: "discovery", content: "Fire explore agents + LSP/ast-grep map + read existing", status: "pending", priority: "high" },
   { id: "scoring", content: "Score directories, determine locations", status: "pending", priority: "high" },
   { id: "generate", content: "Generate AGENTS.md files (root + subdirs)", status: "pending", priority: "high" },
   { id: "review", content: "Deduplicate, validate, trim", status: "pending", priority: "medium" }
@@ -45,16 +45,16 @@ TodoWrite([
 
 ### Fire Background Explore Agents IMMEDIATELY
 
-Don't wait-these run async while main session works. **Equip every agent with the code graph**: any task touching structure, entry points, dependencies, or hotspots MUST query `codegraph_*` (explore/search/callers/callees/impact) and `lsp_symbols` when present, and ground its claims in that data instead of guessing from conventions. Richer real-graph context per agent = a more accurate project map.
+Don't wait-these run async while main session works. **Ground every agent in real symbol data**: any task touching structure, entry points, dependencies, or hotspots MUST query `lsp_symbols`/`lsp_find_references` and the ast-grep skill (`sg`) when present, and ground its claims in that data instead of guessing from conventions. Richer real context per agent = a more accurate project map.
 
 ```
 // Fire all at once, collect results later
-task(subagent_type="explore", load_skills=[], description="Explore project structure", run_in_background=true, prompt="Project structure: map real layout via codegraph_explore/codegraph_files → REPORT deviations from standard patterns")
-task(subagent_type="explore", load_skills=[], description="Find entry points", run_in_background=true, prompt="Entry points: FIND main files, trace reach via codegraph_callees + lsp_symbols → REPORT non-standard organization")
+task(subagent_type="explore", load_skills=[], description="Explore project structure", run_in_background=true, prompt="Project structure: map real layout via glob + lsp_symbols scope=workspace → REPORT deviations from standard patterns")
+task(subagent_type="explore", load_skills=[], description="Find entry points", run_in_background=true, prompt="Entry points: FIND main files, trace reach via lsp_symbols + lsp_find_references → REPORT non-standard organization")
 task(subagent_type="explore", load_skills=[], description="Find conventions", run_in_background=true, prompt="Conventions: FIND config files (.eslintrc, pyproject.toml, .editorconfig) → REPORT project-specific rules")
 task(subagent_type="explore", load_skills=[], description="Find anti-patterns", run_in_background=true, prompt="Anti-patterns: FIND 'DO NOT', 'NEVER', 'ALWAYS', 'DEPRECATED' comments → LIST forbidden patterns")
 task(subagent_type="explore", load_skills=[], description="Explore build/CI", run_in_background=true, prompt="Build/CI: FIND .github/workflows, Makefile → REPORT non-standard patterns")
-task(subagent_type="explore", load_skills=[], description="Find test patterns", run_in_background=true, prompt="Test patterns: FIND test configs/structure; codegraph_callers on core modules to see what is covered → REPORT unique conventions")
+task(subagent_type="explore", load_skills=[], description="Find test patterns", run_in_background=true, prompt="Test patterns: FIND test configs/structure; lsp_find_references on core modules to see what is covered → REPORT unique conventions")
 ```
 
 <dynamic-agents>
@@ -116,7 +116,7 @@ For each existing file found:
 
 If `--create-new`: Read all existing first (preserve context) → then delete all → regenerate.
 
-#### 3. Code Map - drive LSP AND codegraph (do NOT skip)
+#### 3. Code Map - drive LSP AND ast-grep (do NOT skip)
 
 Highest-signal source for the CODE MAP and the Symbol/Export/Reference scoring rows. Complementary, not alternatives - run BOTH when present, alongside the explore agents.
 
@@ -125,10 +125,10 @@ Highest-signal source for the CODE MAP and the Symbol/Export/Reference scoring r
 - `lsp_symbols` scope="workspace", query by kind (class/interface/function) -> symbol inventory.
 - `lsp_find_references` on top exports (line/character from the symbols result) -> reference centrality.
 
-**codegraph** - when `codegraph_*` tools exist (check `codegraph_status`); a first-class peer to LSP, NOT a last resort:
-- `codegraph_explore` -> overview; `codegraph_callers`/`codegraph_callees`/`codegraph_impact` -> centrality + blast radius for the scoring matrix; `codegraph_search`/`codegraph_files` -> symbol/file inventory.
+**ast-grep** - load the ast-grep skill; a first-class peer to LSP, NOT a last resort:
+- `sg --pattern 'export $$$' --lang <lang>` -> export inventory; `sg --pattern 'import $$$ from "$MOD"'` -> dependency edges between modules for the scoring matrix.
 
-Only if NEITHER exists: explore agents + the ast-grep skill (`sg`), and mark centrality unmeasured in the CODE MAP.
+Only if LSP is unavailable: explore agents + ast-grep alone, and mark reference centrality unmeasured in the CODE MAP.
 
 ### Collect Background Results
 
@@ -137,7 +137,7 @@ Only if NEITHER exists: explore agents + the ast-grep skill (`sg`), and mark cen
 for each background task ID (`bg_...`): background_output(task_id="bg_...")
 ```
 
-**Merge: bash + LSP/codegraph + existing + explore findings. Mark "discovery" as completed.**
+**Merge: bash + LSP/ast-grep + existing + explore findings. Mark "discovery" as completed.**
 
 ---
 
@@ -213,7 +213,7 @@ NEVER use Write to overwrite an existing file. ALWAYS check existence first via
 |------|----------|-------|
 
 ## CODE MAP
-{From LSP/codegraph - skip only if neither exists or project <10 files}
+{From LSP/ast-grep - skip only if neither exists or project <10 files}
 
 | Symbol | Type | Location | Refs | Role |
 |--------|------|----------|------|------|
@@ -296,7 +296,7 @@ Hierarchy:
 ## Anti-Patterns
 
 - **Static agent count**: MUST vary agents based on project size/depth
-- **Sequential execution**: MUST parallel (explore + LSP + codegraph concurrent)
+- **Sequential execution**: MUST parallel (explore + LSP + ast-grep concurrent)
 - **Ignoring existing**: ALWAYS read existing first, even with --create-new
 - **Over-documenting**: Not every dir needs AGENTS.md
 - **Redundancy**: Child never repeats parent

package/packages/shared-skills/skills/ulw-plan/SKILL.md

@@ -71,7 +71,6 @@ When producing the plan, encode every executable item as a column-zero Markdown
 - **Decision-complete is the north star.** The executor has NO interview context - spell out exact paths, "every X in Y", and an explicit Must-NOT-Have. Leave the implementer ZERO judgment calls.
 - **Full scope is the default.** Plan the ENTIRE request; "MVP", "v1", "phase 1", or any reduced subset is never an option you invent or ask about - it exists only if the user introduces it. Scope OUT / Must-NOT-Have entries are guardrails against unrequested additions, never reductions of the request.
 - **Explore before asking.** Discoverable facts (repo/system/docs truth) -> research and cite, never ask. Preferences/tradeoffs -> the only things you bring to the user. When unsure which, treat it as a user-decision.
-- **CodeGraph first when present.** Use `codegraph_explore` for repo how/where/what/flow questions before wider reads; if codegraph_* tools are absent, inactive/uninitialized, or cold-start unavailable, continue with Read/Grep/Glob/LSP and the ast-grep skill.
 - **Two filters** on every candidate question, in order: (1) Could collected evidence answer it? -> explore instead. (2) Could the user's stated intent plus a defensible default answer it? -> adopt the default, record it, do not ask - UNLESS it is an owner-decision, which always survives as a question even when a default exists: anything irreversible / destructive / safety-critical, or a cross-cutting product choice the user lives with (public config surface, distribution / packaging, external dependency or pinned SHA, data / schema shape, real budget / paid-service spend, expected scale or capacity target, target-audience / compliance limits). Extrinsic constraints (budget, mandated stack, scale, audience) leave no repo evidence, so exploration can never surface them - sweep those axes explicitly once per plan and classify each as explored, defaulted (ledger), or asked. Default the reversible internals; surface the owner-decisions.
 - **Explore to sufficiency, then STOP.** One research wave per open question; stop when the clearance check is answerable; never re-explore to double-check.
 - **Parallel-dispatch** independent research in ONE turn and keep working while it runs. Subagent outputs are CLAIMS until you independently verify them.

package/dist/config/schema/codegraph.d.ts

@@ -1,12 +0,0 @@
-import { z } from "zod";
-export declare const CodegraphConfigSchema: z.ZodObject<{
-    auto_init: z.ZodDefault<z.ZodBoolean>;
-    auto_provision: z.ZodDefault<z.ZodBoolean>;
-    daemon: z.ZodDefault<z.ZodBoolean>;
-    enabled: z.ZodDefault<z.ZodBoolean>;
-    excluded_roots: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    install_dir: z.ZodOptional<z.ZodString>;
-    telemetry: z.ZodOptional<z.ZodBoolean>;
-    watch_debounce_ms: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
-export type CodegraphConfig = z.infer<typeof CodegraphConfigSchema>;

package/dist/hooks/codegraph-bootstrap/command-runner.d.ts

@@ -1,17 +0,0 @@
-export interface CodegraphCommandResult {
-    readonly exitCode: number;
-    readonly stderr?: string;
-    readonly stdout: string;
-    readonly timedOut: boolean;
-}
-export interface RunCodegraphCommandOptions {
-    readonly env: Record<string, string>;
-    readonly timeoutSignal?: AbortSignal;
-    readonly timeoutMs: number;
-}
-export interface CodegraphCommandInvocation {
-    readonly args: readonly string[];
-    readonly command: string;
-}
-export declare function runCodegraphCommand(projectRoot: string, command: string, args: readonly string[], options: RunCodegraphCommandOptions): Promise<CodegraphCommandResult>;
-export declare function resolveCodegraphCommandInvocation(command: string, args: readonly string[], platform?: NodeJS.Platform): CodegraphCommandInvocation;

package/dist/hooks/codegraph-bootstrap/hook.d.ts

@@ -1,35 +0,0 @@
-import { CODEGRAPH_PINNED_VERSION, type BuildCodegraphEnvOptions, type CodegraphCommandResolution, type CodegraphProjectExclusionDecision, type CodegraphProjectExclusionOptions, type CodegraphNodeSupport, type CodegraphProvisionResult, type CodegraphWorkspacePreparation, type PrepareCodegraphWorkspaceOptions, type ResolveCodegraphCommandOptions } from "@oh-my-opencode/utils";
-import type { CodegraphConfig } from "../../config";
-import type { CodegraphCommandResult } from "./command-runner";
-export interface CodegraphBootstrapContext {
-    readonly directory: string;
-}
-export interface CodegraphBootstrapEventInput {
-    readonly event: {
-        readonly properties?: unknown;
-        readonly type: string;
-    };
-}
-export interface CodegraphBootstrapDeps {
-    readonly buildEnv: (options?: BuildCodegraphEnvOptions) => Record<string, string>;
-    readonly ensureGitignored: (projectRoot: string) => boolean;
-    readonly excludeProject: (projectRoot: string, options?: CodegraphProjectExclusionOptions) => CodegraphProjectExclusionDecision;
-    readonly ensureProvisioned: (options: {
-        readonly installDir?: string;
-        readonly lockDir: string;
-        readonly version: typeof CODEGRAPH_PINNED_VERSION;
-    }) => Promise<CodegraphProvisionResult>;
-    readonly log: (message: string, data?: Record<string, unknown>) => void;
-    readonly nodeSupport: () => CodegraphNodeSupport;
-    readonly prepareWorkspace: (projectRoot: string, options?: PrepareCodegraphWorkspaceOptions) => CodegraphWorkspacePreparation;
-    readonly resolveCommand: (options?: ResolveCodegraphCommandOptions) => CodegraphCommandResolution;
-    readonly runCommand: (projectRoot: string, command: string, args: readonly string[], options: {
-        readonly env: Record<string, string>;
-        readonly timeoutMs: number;
-    }) => Promise<CodegraphCommandResult>;
-    readonly schedule: (task: () => Promise<void>) => void;
-}
-export declare function clearCodegraphBootstrapProjectsForTesting(): void;
-export declare function createCodegraphBootstrapHook(ctx: CodegraphBootstrapContext, config: Partial<CodegraphConfig> | undefined, depsOverride?: Partial<CodegraphBootstrapDeps>): {
-    event(input: CodegraphBootstrapEventInput): void;
-};

package/dist/hooks/codegraph-bootstrap/index.d.ts

@@ -1 +0,0 @@
-export { clearCodegraphBootstrapProjectsForTesting, createCodegraphBootstrapHook, type CodegraphBootstrapContext, type CodegraphBootstrapDeps, type CodegraphBootstrapEventInput, } from "./hook";

package/dist/hooks/codegraph-bootstrap/project-root.d.ts

@@ -1 +0,0 @@
-export declare function resolveCodegraphProjectRoot(properties: unknown, fallbackDirectory: string): string;

package/dist/hooks/codegraph-bootstrap/status.d.ts

@@ -1,11 +0,0 @@
-import type { CodegraphCommandResult } from "./command-runner";
-type CodegraphStatusDecision = {
-    readonly kind: "init";
-} | {
-    readonly kind: "skip";
-    readonly reason: string;
-} | {
-    readonly kind: "sync";
-};
-export declare function decideCodegraphStartupAction(status: CodegraphCommandResult): CodegraphStatusDecision;
-export {};

package/dist/mcp/codegraph.d.ts

@@ -1,16 +0,0 @@
-import type { ResolveCodegraphCommandOptions } from "@oh-my-opencode/utils";
-import type { CodegraphConfig } from "../config/schema/codegraph";
-import type { LocalMcpConfig } from "./lsp";
-import { type RuntimeExecutableResolver } from "./runtime-executable";
-export type CodegraphMcpConfigOptions = {
-    readonly config?: Partial<CodegraphConfig>;
-    readonly cwd?: string;
-    readonly env?: ResolveCodegraphCommandOptions["env"];
-    readonly fileExists?: ResolveCodegraphCommandOptions["fileExists"];
-    readonly homeDir?: string;
-    readonly nodeVersionForExecutable?: ResolveCodegraphCommandOptions["nodeVersion"];
-    readonly provisioned?: ResolveCodegraphCommandOptions["provisioned"];
-    readonly requireResolve?: ResolveCodegraphCommandOptions["requireResolve"];
-    readonly resolveExecutable?: RuntimeExecutableResolver;
-};
-export declare function createCodegraphMcpConfig(options?: CodegraphMcpConfigOptions): LocalMcpConfig;

package/packages/omo-codex/plugin/components/codegraph/AGENTS.md

@@ -1,58 +0,0 @@
-# packages/omo-codex/plugin/components/codegraph/ (CodeGraph MCP Wrapper + Bootstrap Hooks)
-
-**Generated:** 2026-07-17 (7d664b96b)
-
-## OVERVIEW
-
-`@sisyphuslabs/codex-codegraph` (private, Node >=20, bin `omo-codegraph`). Wraps the external CodeGraph CLI (`@colbymchenry/codegraph`, pinned `1.5.0` through the shared `CODEGRAPH_PINNED_VERSION` and the component optionalDependency) behind a stdio MCP server plus Codex lifecycle hooks. Two committed dists ship in the published payload; rebuild `dist/` in the same change as `src/` edits.
-
-Codex wiring (all repo-relative to `packages/omo-codex/plugin/`):
-- **MCP:** `.mcp.json` server `codegraph` → `node components/codegraph/dist/serve.js` (`required: false`).
-- **SessionStart hook:** `hooks/session-start-checking-codegraph-bootstrap.json` → `dist/cli.js hook session-start` (timeout 5).
-- **PostToolUse hook:** `hooks/post-tool-use-checking-codegraph-init-guidance.json`, matcher `^(codegraph[._].*|mcp__codegraph__.*)$` → `dist/cli.js hook post-tool-use`.
-- Both hooks registered in `.codex-plugin/plugin.json`; Windows variants dispatch via `components/bootstrap/scripts/node-dispatch.ps1`.
-
-Serve pipeline (`src/serve.ts`): OMO SOT config gate (`[codex].codegraph.enabled=false` → unavailable stub) → resolve binary (`OMO_CODEGRAPH_BIN` env → bundled → provisioned `~/.omo/codegraph/bin` → PATH) → Node support gate (major 20-24; >=25 crashes CodeGraph mid-indexing; `CODEGRAPH_ALLOW_UNSAFE_NODE=1` overrides) → auto-provision into `~/.omo/codegraph` unless `codegraph.auto_provision=false` → bridge JSON-RPC to `codegraph serve --mcp`. Project cwd resolved from `OMO_CODEGRAPH_PROJECT_CWD` → `OMO_CODEGRAPH_SESSION_START_CWD` → `PWD` → wrapper cwd. When the binary is missing/disabled, `mcp-unavailable.ts` still answers `initialize`/`tools/*` with the skip reason so Codex startup never fails.
-
-Hook pipeline (`src/hook.ts` + `src/session-start-*.ts`): `hook session-start` checks only the exact filesystem marker `<projectRoot>/.codegraph/codegraph.db`; it never invokes the upstream CLI for status. An exact database skips as initialized, an ancestor database records `skipped-nested-root`, and only a definitive no-database result may acquire the per-project atomic lock and spawn `hook session-start-worker`. Live locks record `skipped-locked`; stale locks recover into an exponential cooldown instead of spawning immediately. Worker failures and skips persist a cooldown stamp (15 minutes by default, doubling to a 24-hour cap; configurable with Codex-only `codegraph.session_start_cooldown_ms`, minimum 60000), while success clears it. The worker prepares the workspace, invokes only `codegraph init` with a 60-second tree timeout, and records success only after the exact project database appears. Hook suppressions and worker outcomes append to `~/.omo/codegraph/session-start.jsonl`. `hook post-tool-use` emits init guidance when a codegraph tool result indicates an uninitialized project. `cli.js` with no hook subcommand falls through to serve.
-
-## includeCode CONTRACT (commit 4cf383c5b)
-
-`src/mcp-bridge.ts` rewrites the upstream `codegraph_node` contract in-flight: `tools/list` responses get a clarified description + `includeCode` schema description, and `tools/call` results replace "Structural outline only" text. Contract: `includeCode=true` returns leaf-symbol source only; container symbols (classes, interfaces, structs, enums, modules, namespaces) return structural outlines with member lists BY DESIGN: for container source, request a specific member symbol or file mode with `symbolsOnly=false` plus `offset`/`limit`. Pinned by `test/serve-mcp-bridge.test.ts`.
-
-## KEY FILES
-
-| File | Purpose |
-|------|---------|
-| `src/serve.ts` | MCP entry: config/resolution/Node gates, provisioning, bridge or unavailable stub |
-| `src/cli.ts` | Hook CLI router: `hook session-start` / `hook post-tool-use` / `hook session-start-worker` / serve fallback |
-| `src/hook.ts` | SessionStart exact-root decision pipeline + detached worker spawn |
-| `src/post-tool-use-hook.ts` | PostToolUse init guidance emission |
-| `src/session-start-project.ts` | Exact database and ancestor-coverage filesystem probes |
-| `src/session-start-lock.ts` | Atomic per-project worker lock + stale recovery |
-| `src/session-start-cooldown.ts` | Persistent exponential failure cooldown state |
-| `src/session-start-worker.ts` | Background bootstrap orchestration and lock lifecycle |
-| `src/session-start-command.ts` | Provision/resolve + bounded `codegraph init` invocation |
-| `src/session-start-outcome.ts` | `session-start.jsonl` outcome writer |
-| `src/mcp-bridge.ts` | Stdio JSON-RPC forwarder; per-request framed/line response-mode tracking; codegraph_node contract rewrites; awaits stdio writes and SIGKILLs the child on response-forwarding failure |
-| `src/mcp-unavailable.ts` | Reason-bearing stub MCP server for disabled/missing binary |
-| `src/serve-invocation.ts` | win32 invocation shim: `.cmd`/`.bat` via `cmd.exe /d /s /c`, `.js`/`.mjs`/`.cjs` via `process.execPath` (mirrored by `resolveCodegraphCommandInvocation` in session-start-worker) |
-| `src/hook-types.ts` | Shared hook/worker option + outcome types |
-
-## WHERE TO LOOK
-
-| Task | Location |
-|------|----------|
-| Resolution order, provisioning, Node gate, env, gitignore/workspace prep | `packages/utils/src/codegraph/` (`resolve.ts`, `provision.ts`, `node-support.ts`, `env.ts`, `workspace.ts`, `guidance.ts`), bundled at build time |
-| `[codex].codegraph` config keys (`enabled`, `auto_provision`, `trustedCodegraphInstallDir`) | `packages/omo-codex/plugin/shared/src/config-loader.ts` |
-| JSON-RPC framing primitives | `packages/mcp-stdio-core/src/` |
-| Build / test / typecheck | `bun run build` (bun build → `dist/serve.js` + `dist/cli.js`, target node ESM), `bun test ./test`, `tsc --noEmit` |
-
-## NOTES
-
-- This component tests with `bun test` (unlike the vitest-based `lsp` sibling); given/when/then style.
-- `src/` imports reach sibling packages via relative paths (`../../../../../utils/src/...`); they are inlined by `bun build`, so runtime `dist/` has zero deps beyond Node.
-- `serve.ts` and SessionStart command provisioning derive their version from the shared `CODEGRAPH_PINNED_VERSION`; the component optionalDependency must match that pin.
-- `trustedCodegraphInstallDir` overrides the `~/.omo/codegraph` install dir and is forwarded to children as `CODEGRAPH_INSTALL_DIR`.
-- `resolution.source === "env"` is never auto-provisioned over: a user-set `OMO_CODEGRAPH_BIN` pointing at a missing file skips the MCP instead of silently substituting a download.
-- `runBridgedCodegraphProcess` awaits every stdio write and races `childExit` against response forwarding; a forwarding error (e.g. parent stdout `EPIPE`) rejects the serve promise, destroys the child pipes, and `SIGKILL`s the codegraph child if still alive so a held-open child is never orphaned. Pinned by `test/serve-mcp-bridge-lifecycle.test.ts` and the held-open case in `test/serve-mcp-bridge.test.ts`.

package/packages/omo-codex/plugin/components/codegraph/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Yeongyu Kim
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.