@ngockhoale/ukit 2.1.5 → 2.2.2

package/CHANGELOG.md

@@ -2,6 +2,66 @@
 
 All notable changes to UKit are documented here.
 
+## 2.2.2 - 2026-08-22
+
+Running Claude Code and omp side by side exposed that they were not, in fact, running the same UKit. `CLAUDE.md` and `AGENTS.md` are hand-maintained forks of one instruction set read by different harnesses, and `AGENTS.md` had fallen three minor versions behind — so omp was never told the model-tier table existed. This wave re-unifies them and adds a test that makes the drift impossible to repeat.
+
+It also settles the three `TODO(verify)` items 2.2.1 shipped with. Those were plan-time guesses about omp's API, unresolvable at the time because omp was not installed on any machine that could answer them. omp v17.4.2 is now installed and was inspected directly — and two of the three guesses were wrong, in the quiet way where nothing errors and the feature simply never engages.
+
+### Fixed
+
+- **Auto-compact was never actually configured on omp.** `.omp/config.yml` set `compact.autoCompactWindow: 180000`, a key omp does not have — `omp config get compact.autoCompactWindow` answers "Unknown setting", so the value was inert and omp stayed on its own default. The real key is `compaction.thresholdTokens` ("Fixed token limit for context maintenance; overrides percentage if set", omp's default `-1`). Verified end-to-end against a scratch project: the nested form now reads back as `180000`, which is below `compact.hardCapTokens` (220000) as intended, so auto-compact fires before `context-hardcap-gate.sh` starts blocking tool calls.
+- **Post-compact hooks never ran on omp.** The bridge assumed omp re-emitted `session_start` after a compaction, the way Claude Code's matcher-less `SessionStart` hook fires with `source: "compact"`. It does not — it has a dedicated event instead (`session_before_compact` → `session.compacting` → `session_compact`, the last firing once compaction settles). So on omp the entire post-compact chain was lost: the run cursor stayed un-surfaced, compact pressure was never reset, and a mid-cycle handoff silently failed to resume after a compaction. `ukit-bridge.js` now maps `session_compact` onto the same script chain, keeping `hook_event_name: 'SessionStart'` in the payload so the scripts stay shared with Claude Code rather than forked.
+- **Two UNIC gateway probes could never have fired.** `unic-gateway.mjs` probed an `OMP_BASE_URL` env var and a `baseUrl` key in `.omp/config.yml`. Neither exists: omp's anthropic provider reads `ANTHROPIC_BASE_URL` (falling back to `https://api.anthropic.com`), and its settings schema declares no `baseUrl` at any level. Both probes are removed rather than left returning a permanent `false` — a probe that can never fire is worse than no probe, because it reads as coverage. Detection is unchanged in behaviour and now literally matches what the docs already claimed: routing is decided only by `ANTHROPIC_BASE_URL`, on omp for the same reason as on Claude Code.
+- **omp behaved as if UKit only had one model, because it was never told otherwise.** `templates/AGENTS.md` — the context doc omp, Codex and OpenCode read — was missing the entire `3-Tier Model Routing` block, plus `Post-Edit Sidecar Review` and `Skill Quality`, and still announced itself as `UKit v1.5.1`. `.omp/config.yml` declared `modelRoles` for all four lanes, but nothing in omp's context ever said *when* to use a tier, so everything ran inline on the session model.
+- **Five section pairs had been renamed apart** — `Core Rule`/`Core UKit Rule`, `Fast Classification`/`Fast Task Classification`, `Internal Helper Policy`/`Internal Helper Routing`, `Selective Subagent Policy`/`Subagent Policy`, `Project Snapshot`/`Environment Snapshot`. This is what let the drift hide: once the headings differ, no diff lines up and the gap is invisible. Headings are now shared, and the two docs carry byte-identical bodies for every shared section.
+- **Every session opened by being told to resume a finished cycle.** `docs/AI_HANDOFF/RUN.md` was left at `Phase: R4` after 2.2.1 shipped, so `handoff-resume.sh` — which runs in the `session_start` chain of *both* Claude Code and the omp bridge — fired a "CONTINUATION — resume immediately" banner at the start of every new, unrelated session. The cursor now reads `Phase: done`.
+- **`/ukit:*` commands re-pasted the user's whole problem statement up to seven times per file.** Only one `$ARGUMENTS` site per command is a real interpolation (the `## Problem / feature` body); the other six were *references* that expanded to the entire paragraph again mid-sentence. They now say "the **Problem / feature** section above".
+- **Eight fallback lines told the model to do something only a human can do.** `> Other tools without subagent support: manually switch to the strong model` reads, to a running model, as an instruction to itself — which it cannot follow, so it improvises. Each is now explicitly addressed: `> **For the human operator, on a tool with no agent support (Codex, OpenCode) — not an instruction to the model:**`.
+
+### Added
+
+- **`### How a tier is actually bound`** in both context docs. The main session model never changes mid-turn; a tier only takes effect when work is handed to an agent whose own definition binds that model. The section carries a harness table (Claude Code `.claude/agents/*.md` + `subagent_type`, omp `.omp/agents/*.md` + `task-agent`) and states the consequence plainly: doing everything inline is exactly what makes UKit behave as if it had one model.
+- **`tests/consistency/contextDocsParity.test.js`** (29 tests) — every `## ` section must exist in both `templates/CLAUDE.md` and `templates/AGENTS.md` with byte-identical bodies, unless allowlisted with a stated reason (currently one entry: `Session Start — OpenCode`, which exists because OpenCode does not auto-load `.claude/skills/`). Also asserts neither doc hardcodes a version, and that both manifest items declare the same variable set.
+- **`.omp/RULES.md` grew from 4 rules to 7**, targeting direct chat specifically — direct chat is steered only by static context, so what is missing there is simply never applied. New: `Classify first, then act` (Trivial / Simple / Non-trivial lanes, decided *before* the first tool call), `Auto-activate skills`, and `Delegate to bind a model tier`. It stays short on purpose: it is re-attached near every turn.
+- **The three `/ukit:*` sites that named only Claude Code now name omp too** — `handoff-fullstack.md`'s Model Split note, and the small-task-maintainer lines in `handoff-clear.md` and `handoff-status.md`.
+
+### Changed
+
+- **Four more expired one-shot guards re-anchored, same class as the two below.** `ompDocsSync` cases 3 and 6 validated "the top CHANGELOG entry" — true on the day 2.2.1 shipped, false at the next release; they now find the omp entry by version. `ompContextLayer` case 10 guarded the compact key with a `TODO(verify)` marker instead of a value, and now asserts the verified key plus its provenance. `tests/handoff/cycle4/unic-gateway.test.mjs` case 13b had never actually run (it took its skip branch because the file it checked did not exist yet) and was matching a key spelling — `@vision:` — that belongs to the agent side, not the config side.
+- **`tests/consistency/ompCommandParity.test.js` cases 4 and 5 no longer diff against `git show HEAD:`.** They were scope guards for one in-flight cycle ("TASK-005 must not modify these"), and that premise expired when the cycle shipped: against a committed baseline they pass vacuously, and against a dirty tree they block every later legitimate edit instead — which is exactly what they did. Both are re-expressed as the durable properties they stood in for (no `subagent_type` site in the two non-delegation commands; pinned per-file `Do NOT` and tier-justification-clause counts). No protection was dropped, only re-anchored.
+
+## 2.2.1 - 2026-08-22
+
+UKit gains a fourth runtime and loses one. omp (Oh My Pi) reaches full parity with the Claude Code workspace — same agents, same skills, same hooks, same `/ukit:*` commands — and the Antigravity adapter, unused and unmaintained, is gone. The parity is deliberate rather than incidental: the port reuses the existing `.claude/` assets wherever omp's discovery can already reach them, so there is one source of truth per capability, not two that drift.
+
+### Added
+
+- **omp (Oh My Pi) adapter — `ukit install --tools=omp`** (alias `--tools=oh-my-pi`). Installs 11 files: `.omp/AGENTS.md` (a thin `@../AGENTS.md` import rather than a copy, so the shared instructions have exactly one home), `.omp/RULES.md` (sticky hard rules), `.omp/config.yml`, `.omp/README.md`, `.omp/hooks/pre/ukit-bridge.js`, and the six agents under `.omp/agents/`. **No symlinks are created.** omp's discovery providers already rank its `claude` provider above nothing at all for skills and commands, so `.claude/skills/` and `.claude/commands/` are read directly — an `.omp/skills` symlink would shadow the canonical tree for no benefit. `.omp/agents/` must be real files because omp explicitly skips `.claude/agents/*.md`.
+- **All six shared agents ported to omp's task-agent contract**: `bug-debugger`, `code-reviewer`, `feature-implementer`, `handoff-planner`, `ukit-small-task-maintainer`, `ukit-vision-analyst`. The differences between each agent's Claude Code and omp form — and why each one is or is not a faithful port — are recorded in [`docs/research/2026-08-22_omp-agent-parity.md`](docs/research/2026-08-22_omp-agent-parity.md).
+- **UNIC model names survive the port.** `.omp/config.yml` ships `modelRoles` with all four lanes intact: `lite: unic-lite`, `code: unic-code`, `smart: unic-smart`, `vision: unic-vision`. The vision lane stays a capability lane, not a fourth cost tier.
+- **Hook bridge — one source of truth, two runtimes.** `.omp/hooks/pre/ukit-bridge.js` is an omp hook factory (`export default function hook(pi)`) that translates omp's events into the Claude Code hook JSON shape and then executes the **existing** `.claude/hooks/*.sh` scripts. The 20 shell hooks are not duplicated, forked, or rewritten for omp; a fix to one fixes both runtimes.
+- **Auto-compact parity.** `compact.agentContext.targets` gains an `omp` entry using `mode: 'precompact-reinject'` — the same strategy as `claude`, not Codex's `soft-handoff`. omp exposes real pre-compaction hook events, so there is nothing to work around with a state file.
+- **`agent-code-reviewer` manifest item.** `templates/.claude/agents/code-reviewer.md` had shipped as a template with no manifest item since it was introduced, and `autoDiscoverTemplates: false` meant it was therefore **silently never installed** — UKit was installing five of its six Claude agents. Both the handoff Phase 4 reviewer and the Post-Edit Sidecar Review added in 2.1.5 instruct the model to spawn an agent that was not present in any installed project. Found by the omp parity work, because the new adapter would otherwise have shipped a strictly better agent set than the one it was porting from.
+
+### Changed
+
+- **`/ukit:*` commands are phrased for whichever runtime is reading them.** The command bodies no longer assume Claude Code's spawn mechanics; each names its model tier and its delegation step in runtime-neutral terms, so the same file drives the same pipeline under Claude Code and under omp.
+- **`ukit status` reports `Oh My Pi (omp)`** and checks `.omp/config.yml`; the Antigravity row is gone.
+- **`.omp/` is TCC-protected** (`applyPlan.js`) and **git-ignored** by the managed `.gitignore` block, alongside `.claude/` and `.codex/`.
+
+### Removed
+
+- **The Antigravity adapter.** `templates/.antigravity/`, `templates/adapter-presets/antigravity/`, the five `multi-antigravity-*` manifest items, its entry in `src/cli/adapters.js`, and every user-facing mention — in `README.md`, `QUICK_START.md`, `docs/PROJECT.md`, and in the installed workspace itself: `AGENTS.md`, `.codex/README.md` and the four `/ukit:handoff-*` command files all named Antigravity as a tool you could use. `--tools=antigravity` now fails fast with `Antigravity has been removed as a UKit adapter.` plus the list of adapters that do exist, rather than silently installing nothing.
+- **Legacy cleanup is retained, not removed.** `ukit uninstall` still cleans `.antigravity/`, and `.antigravity/` keeps its TCC protection, because a stale pre-2.2.0 install still has the directory. Install-time pruning now covers it too: `.antigravity/` joined `AUTO_PRUNE_OBSOLETE_PREFIXES`, so a re-install removes the stale symlinks a pre-2.2.0 install left behind. Without it those links would dangle forever — pruning is the only pass that ever revisits them, and removing the adapter took them out of the manifest that uninstall reads. Only paths UKit itself recorded in `install.json` are considered, and a path the user has replaced with a real directory is skipped with a warning instead of being silently left behind.
+
+### Fixed
+
+- **Deselecting omp no longer orphans its agents.** `OPTIONAL_ADAPTERS`' `managedPaths` listed `.omp/agents` as a single entry, copying the shape of Codex's `.codex/agents`. Codex's is a symlink; omp's is a real directory of six real files. `removeFileOrLinkOnly` refuses real directories, so re-running `ukit install` without `omp` and confirming removal deleted nothing — while the metadata pass still dropped all six from `install.json`, leaving them on disk and untracked forever. The six paths are now listed individually, matching `uninstall.js`'s own list. Full `ukit uninstall` was never affected.
+- **The `--tools=antigravity` regression test was passing vacuously.** It asserted on a directory the install pipeline had never been pointed at, so the "no partial write" half would have held even if the error path did write. It now runs the real `bin/ukit`, and checks the exit code, the stderr text, the absence of a stack frame, and that not even the always-on `.claude/` adapter was written.
+
+**Known gap:** omp was not installed on the machine this release was built on. Every omp assertion in the test suite is against the generated `.omp/` tree and the bridge module's shape — the packed-tarball test confirms `templates/.omp/**` actually publishes, but nothing here observes omp's runtime behaviour. The three open verification items (does omp emit `session_start` on a post-compact continuation; omp's real base-URL key; omp's real auto-compact-window key) are recorded in `docs/AI_HANDOFF/tasks/TASK-008.md`.
+
 ## 2.1.5 - 2026-08-19
 
 `local-build` was the one execution contract in the daily (non-handoff) flow that let the executor claim done off write evidence alone — and it is also the busiest lane a weaker `unic-code` backend hits. This closes that gap and adds a non-blocking second opinion, without adding wait time to the main task.

package/README.md

@@ -1,6 +1,6 @@
 # UKit
 
-UKit installs a project-local AI workspace (`.claude/`, adapters, docs, and index helpers) so your team can work with Claude Code, Antigravity, OpenAI Codex, and OpenCode from the same repo setup.
+UKit installs a project-local AI workspace (`.claude/`, adapters, docs, and index helpers) so your team can work with Claude Code, OpenAI Codex, OpenCode, and omp (Oh My Pi) from the same repo setup.
 
 ## Highest-Priority Team Rule
 
@@ -57,10 +57,13 @@ If maintainers roll out a newer CLI build, the in-project workflow still stays t
 - `AGENTS.md` — shared instructions for AGENTS-compatible tools
 
 **Adapters**
-- `.antigravity/skills/` → symlink to `.claude/skills/`
-- `.antigravity/rules/` — Antigravity rules
 - `.codex/settings.json` + `.codex/settings.local.json` — Codex config
 - `opencode.json` — OpenCode project config with UKit-safe guardrails
+- `.omp/AGENTS.md` — thin `@../AGENTS.md` import so omp reads the shared instructions
+- `.omp/RULES.md` — sticky hard rules for omp sessions
+- `.omp/config.yml` — omp model roles, tool approval, and bash patterns
+- `.omp/agents/` — the six shared agents in omp's task-agent format
+- `.omp/hooks/pre/ukit-bridge.js` — bridges omp events onto the existing `.claude/hooks/*.sh`
 
 **Project support files**
 - `.claude/ukit/.ukit/` — installer manifests, metadata, backups
@@ -192,8 +195,8 @@ For deeper index development, repo-level scripts are available:
 | Tool | Instructions | Skills | Config |
 |------|-------------|--------|--------|
 | Claude Code | `CLAUDE.md` | `.claude/skills/` (canonical) | `.claude/settings.json` |
-| Antigravity | `AGENTS.md` | `.antigravity/skills/` (symlink) | `.antigravity/rules/`, `.antigravity/README.md` |
 | OpenAI Codex | `AGENTS.md` | `.claude/skills/` (referenced) | `.codex/settings.json`, `.codex/settings.local.json`, `.codex/README.md` |
 | OpenCode | `AGENTS.md` | `.claude/skills/` (native Claude-compatible support) | `opencode.json` |
+| omp (Oh My Pi) | `.omp/AGENTS.md` (imports `AGENTS.md`) | `.claude/skills/` (read via omp's claude provider — no symlink) | `.omp/config.yml`, `.omp/RULES.md`, `.omp/README.md` |
 
 All supported tools share the same SKILL.md ecosystem so the workspace is authored once and reused everywhere.

package/manifests/platform.full.yaml

@@ -110,13 +110,21 @@ items:
       - docs-project
       - docs-memory
     mergeStrategy: overwrite_with_backup
+    # Same set as root-claude-md: AGENTS.md is the same body with a different H1 plus one
+    # OpenCode-only section, so it interpolates the same variables. Kept in sync by
+    # tests/consistency/contextDocsParity.test.js.
     variables:
       - project.name
+      - project.root
       - project.stack
       - stack.frontend
       - stack.backendApi
       - stack.postgres
       - runtime.packageManager
+      - runtime.os
+      - runtime.nodeVersion
+      - providers.unic
+      - ukit.version
     enabledByDefault: true
     packs:
       - core
@@ -830,6 +838,20 @@ items:
     packs:
       - core
 
+  # The .omp/ mirror of this agent has always been installed; the .claude/ original was
+  # shipped as a template with no manifest item, so autoDiscoverTemplates:false meant it
+  # was silently never installed. Both handoff Phase 4 and the sidecar diff review need it.
+  - id: agent-code-reviewer
+    type: agent
+    sourceTemplate: .claude/agents/code-reviewer.md
+    targetPath: .claude/agents/code-reviewer.md
+    requires: []
+    mergeStrategy: overwrite_with_backup
+    variables: []
+    enabledByDefault: true
+    packs:
+      - core
+
   - id: agent-ukit-small-task-maintainer
     type: agent
     sourceTemplate: .claude/agents/ukit-small-task-maintainer.md
@@ -1517,62 +1539,137 @@ items:
 
   # ═══════════════════════════════════════════════════════════════
   # Multi-tool Adapters
-  # Symlink .claude/skills/ into Antigravity discovery paths.
   # Config files generated from templates.
   # ═══════════════════════════════════════════════════════════════
 
-  # --- Google Antigravity ---
+  # --- omp (Oh My Pi) ---
+  # No `type: link` items on purpose (PLAN.md §3 D10): omp's `claude` discovery provider
+  # already reads `.claude/skills` and `.claude/commands`, so a native-priority duplicate
+  # under `.omp/` would buy nothing. `.omp/agents/` must be real files because omp skips
+  # `.claude/agents/*.md` outright (TASK_AGENT_CONFIG_SOURCE = ".omp").
+  # `autoDiscoverTemplates: false` means a template file without an item here is silently
+  # never installed — every file under `templates/.omp/` needs exactly one entry below.
 
-  - id: multi-antigravity-skills-link
-    type: link
-    sourceTemplate: .claude/skills
-    targetPath: .antigravity/skills
+  - id: multi-omp-agents-md
+    type: config
+    sourceTemplate: .omp/AGENTS.md
+    targetPath: .omp/AGENTS.md
     requires: []
+    mergeStrategy: overwrite_with_backup
+    variables: []
     enabledByDefault: true
     packs:
       - core
 
-  - id: multi-antigravity-ukit-link
-    type: link
-    sourceTemplate: .claude/ukit
-    targetPath: .antigravity/ukit
+  - id: multi-omp-rules
+    type: config
+    sourceTemplate: .omp/RULES.md
+    targetPath: .omp/RULES.md
     requires: []
+    mergeStrategy: overwrite_with_backup
+    variables: []
     enabledByDefault: true
     packs:
       - core
 
-  - id: multi-antigravity-agents-link
-    type: link
-    sourceTemplate: .claude/agents
-    targetPath: .antigravity/agents
+  - id: multi-omp-config
+    type: config
+    sourceTemplate: .omp/config.yml
+    targetPath: .omp/config.yml
     requires: []
+    mergeStrategy: overwrite_with_backup
+    variables: []
     enabledByDefault: true
     packs:
       - core
 
-  - id: multi-antigravity-rules
+  - id: multi-omp-readme
     type: config
-    sourceTemplate: adapter-presets/antigravity/rules.md
-    targetPath: .antigravity/rules/rules.md
+    sourceTemplate: .omp/README.md
+    targetPath: .omp/README.md
     requires: []
     mergeStrategy: overwrite_with_backup
     variables:
       - project.name
+      - project.stack
       - runtime.packageManager
     enabledByDefault: true
     packs:
       - core
 
-  - id: multi-antigravity-readme
+  - id: multi-omp-hook-bridge
     type: config
-    sourceTemplate: adapter-presets/antigravity/README.md
-    targetPath: .antigravity/README.md
+    sourceTemplate: .omp/hooks/pre/ukit-bridge.js
+    targetPath: .omp/hooks/pre/ukit-bridge.js
     requires: []
     mergeStrategy: overwrite_with_backup
-    variables:
-      - project.name
-      - project.stack
-      - runtime.packageManager
+    variables: []
+    enabledByDefault: true
+    packs:
+      - core
+
+  - id: multi-omp-agent-bug-debugger
+    type: config
+    sourceTemplate: .omp/agents/bug-debugger.md
+    targetPath: .omp/agents/bug-debugger.md
+    requires: []
+    mergeStrategy: overwrite_with_backup
+    variables: []
+    enabledByDefault: true
+    packs:
+      - core
+
+  - id: multi-omp-agent-code-reviewer
+    type: config
+    sourceTemplate: .omp/agents/code-reviewer.md
+    targetPath: .omp/agents/code-reviewer.md
+    requires: []
+    mergeStrategy: overwrite_with_backup
+    variables: []
+    enabledByDefault: true
+    packs:
+      - core
+
+  - id: multi-omp-agent-feature-implementer
+    type: config
+    sourceTemplate: .omp/agents/feature-implementer.md
+    targetPath: .omp/agents/feature-implementer.md
+    requires: []
+    mergeStrategy: overwrite_with_backup
+    variables: []
+    enabledByDefault: true
+    packs:
+      - core
+
+  - id: multi-omp-agent-handoff-planner
+    type: config
+    sourceTemplate: .omp/agents/handoff-planner.md
+    targetPath: .omp/agents/handoff-planner.md
+    requires: []
+    mergeStrategy: overwrite_with_backup
+    variables: []
+    enabledByDefault: true
+    packs:
+      - core
+
+  - id: multi-omp-agent-ukit-small-task-maintainer
+    type: config
+    sourceTemplate: .omp/agents/ukit-small-task-maintainer.md
+    targetPath: .omp/agents/ukit-small-task-maintainer.md
+    requires: []
+    mergeStrategy: overwrite_with_backup
+    variables: []
+    enabledByDefault: true
+    packs:
+      - core
+
+  - id: multi-omp-agent-ukit-vision-analyst
+    type: config
+    sourceTemplate: .omp/agents/ukit-vision-analyst.md
+    targetPath: .omp/agents/ukit-vision-analyst.md
+    requires: []
+    mergeStrategy: overwrite_with_backup
+    variables: []
     enabledByDefault: true
     packs:
       - core

package/package.json

@@ -1,16 +1,17 @@
 {
   "name": "@ngockhoale/ukit",
-  "version": "2.1.5",
-  "description": "Install/update an index-first AI workspace for Claude Code, Antigravity, OpenAI Codex, and OpenCode.",
+  "version": "2.2.2",
+  "description": "Install/update an index-first AI workspace for Claude Code, OpenAI Codex, OpenCode, and omp (Oh My Pi).",
   "license": "MIT",
   "type": "module",
   "keywords": [
     "ukit",
     "claude",
     "codex",
-    "antigravity",
     "claude-code",
     "opencode",
+    "omp",
+    "oh-my-pi",
     "skills",
     "agents",
     "ai",

package/src/cli/adapters.js

@@ -1,22 +1,4 @@
 export const OPTIONAL_ADAPTERS = [
-  {
-    key: 'antigravity',
-    label: 'Antigravity',
-    itemIds: [
-      'multi-antigravity-skills-link',
-      'multi-antigravity-ukit-link',
-      'multi-antigravity-rules',
-      'multi-antigravity-readme',
-      'multi-antigravity-agents-link',
-    ],
-    managedPaths: [
-      '.antigravity/skills',
-      '.antigravity/ukit',
-      '.antigravity/rules/rules.md',
-      '.antigravity/README.md',
-      '.antigravity/agents',
-    ],
-  },
   {
     key: 'codex',
     label: 'OpenAI Codex',
@@ -47,6 +29,42 @@ export const OPTIONAL_ADAPTERS = [
       'opencode.json',
     ],
   },
+  {
+    key: 'omp',
+    label: 'Oh My Pi (omp)',
+    itemIds: [
+      'multi-omp-agents-md',
+      'multi-omp-rules',
+      'multi-omp-config',
+      'multi-omp-readme',
+      'multi-omp-hook-bridge',
+      'multi-omp-agent-bug-debugger',
+      'multi-omp-agent-code-reviewer',
+      'multi-omp-agent-feature-implementer',
+      'multi-omp-agent-handoff-planner',
+      'multi-omp-agent-ukit-small-task-maintainer',
+      'multi-omp-agent-ukit-vision-analyst',
+    ],
+    managedPaths: [
+      '.omp/AGENTS.md',
+      '.omp/RULES.md',
+      '.omp/config.yml',
+      '.omp/README.md',
+      '.omp/hooks/pre/ukit-bridge.js',
+      // Listed file-by-file, unlike Codex's single '.codex/agents' entry. Codex's is a
+      // symlink; omp's is a real directory of real files (manifest: omp skips .claude/agents,
+      // so these must be real). Deselect calls removeFileOrLinkOnly, which refuses real
+      // directories — a single '.omp/agents' entry would drop all six from install.json
+      // while leaving them on disk, orphaned and no longer tracked. Keep in sync with
+      // buildFallbackPaths in src/core/uninstall.js.
+      '.omp/agents/bug-debugger.md',
+      '.omp/agents/code-reviewer.md',
+      '.omp/agents/feature-implementer.md',
+      '.omp/agents/handoff-planner.md',
+      '.omp/agents/ukit-small-task-maintainer.md',
+      '.omp/agents/ukit-vision-analyst.md',
+    ],
+  },
 ];
 
 export const ADAPTER_BY_KEY = new Map(OPTIONAL_ADAPTERS.map((adapter) => [adapter.key, adapter]));
@@ -55,14 +73,15 @@ export const DEFAULT_OPTIONAL_TOOL_KEYS = OPTIONAL_ADAPTERS.map((adapter) => ada
 export const TOOL_ALIASES = new Map([
   ['claude', 'claude'],
   ['claude-code', 'claude'],
-  ['antigravity', 'antigravity'],
   ['codex', 'codex'],
   ['openai-codex', 'codex'],
   ['opencode', 'opencode'],
   ['open-code', 'opencode'],
+  ['omp', 'omp'],
+  ['oh-my-pi', 'omp'],
 ]);
 
-export const TOOLS_FLAG_HELP = 'all|none|claude,antigravity,codex,opencode';
+export const TOOLS_FLAG_HELP = 'all|none|claude,codex,opencode,omp';
 
 export function parseToolsArg(argv = []) {
   let toolsArg = null;
@@ -111,7 +130,14 @@ export function resolveOptionalToolKeys(toolsArg) {
     const token = rawToken.trim();
     if (!token) continue;
 
-    const normalizedTool = TOOL_ALIASES.get(token.toLowerCase()) ?? null;
+    const normalizedToken = token.toLowerCase();
+    if (normalizedToken === 'antigravity' || normalizedToken === 'google-antigravity') {
+      throw new Error(
+        `Antigravity has been removed as a UKit adapter. Allowed: ${TOOLS_FLAG_HELP}`,
+      );
+    }
+
+    const normalizedTool = TOOL_ALIASES.get(normalizedToken) ?? null;
     if (!normalizedTool) {
       throw new Error(`Unknown tool '${token}'. Allowed: ${TOOLS_FLAG_HELP}`);
     }

package/src/cli/index.js

@@ -96,8 +96,8 @@ export async function runCli({ argv, packageRoot, projectRoot, packageVersion })
     console.log('');
     console.log('Options (install / diff):');
     console.log('  --tools=<list>     Comma-separated adapters to enable (default: all)');
-    console.log('                     Values: claude, antigravity, codex, opencode');
-    console.log('                     Example: ukit install --tools=claude,codex,opencode');
+    console.log('                     Values: claude, codex, opencode, omp');
+    console.log('                     Example: ukit install --tools=claude,codex,opencode,omp');
     console.log('                     Use --tools=none to disable all optional adapters');
     console.log('  --with-codegraph   Enable CodeGraph MCP integration in CLAUDE.md');
     console.log('                     Adds routing rules that prefer codegraph_* tools for');

package/src/core/applyPlan.js

@@ -2,9 +2,12 @@ import fs from 'node:fs/promises';
 import path from 'node:path';
 import { writeFileAtomic, copyFileSafe, createDirectoryLink, removeLinkOnly } from './fileOps.js';
 
-const TCC_PROTECTED_PREFIXES = ['.codex/', '.antigravity/'];
+// legacy: '.antigravity/' stays TCC-protected — Antigravity adapter removed in v2.2.0, but a
+// stale install may still have the dir and must not lose TCC protection.
+const TCC_PROTECTED_PREFIXES = ['.codex/', '.antigravity/', '.omp/'];
 
-function isTccProtectedPath(filePath) {
+// Exported for tests: the prefix boundary is security-relevant and worth asserting directly.
+export function isTccProtectedPath(filePath) {
   const normalized = filePath.replace(/\\/g, '/');
   return TCC_PROTECTED_PREFIXES.some((prefix) => {
     const idx = normalized.indexOf(`/${prefix}`);

package/src/core/ensureGitignore.js

@@ -4,9 +4,11 @@ import { writeFileAtomic } from './fileOps.js';
 
 const UKIT_ENTRIES = [
   '.cache/',
+  // legacy: Antigravity adapter removed in v2.2.0; leftovers must stay ignored
   '.antigravity/',
   '.claude/',
   '.codex/',
+  '.omp/',
   '.ukit/',
   'opencode.json',
   'AGENTS.md',

package/src/core/runInstallPipeline.js

@@ -16,6 +16,10 @@ import { cleanupEmptyParents, readJsonIfExists, removeFileOrLinkOnly, resolvePro
 
 const AUTO_PRUNE_OBSOLETE_PREFIXES = [
   '.claude/skills/',
+  // The Antigravity adapter was removed in v2.2.0. Without this, a pre-2.2.0 install
+  // leaves its .antigravity/ links dangling forever, since nothing else ever revisits
+  // them. Only paths UKit itself recorded in install.json are considered here.
+  '.antigravity/',
 ];
 
 const AUTO_PRUNE_OBSOLETE_PATHS = new Set([
@@ -219,6 +223,21 @@ async function pruneObsoleteManagedPaths({
     if (removed) {
       removedCount += 1;
       await cleanupEmptyParents(absolutePath, projectRoot);
+      continue;
+    }
+
+    // removeFileOrLinkOnly refuses real directories. A path recorded as managed that is
+    // now a real directory means the user replaced it — say so instead of silently
+    // leaving it behind, matching the link-update warning in applyPlan.js.
+    try {
+      const stat = await fs.lstat(absolutePath);
+      if (stat.isDirectory() && !stat.isSymbolicLink()) {
+        console.warn(
+          `[UKit] Warning: skipping obsolete path ${absolutePath} — exists as a real directory (possible user content). Remove it manually if intended.`,
+        );
+      }
+    } catch {
+      // Already gone — nothing to prune and nothing to warn about.
     }
   }
 

package/src/core/runtimeConfig.js

@@ -6,7 +6,9 @@ import { buildRuntimePaths } from './runtimePaths.js';
 const require = createRequire(import.meta.url);
 const { version: PACKAGE_VERSION } = require('../../package.json');
 
-const VALID_AGENTS = new Set(['claude-code', 'codex', 'antigravity', 'opencode']);
+// legacy: 'antigravity' stays valid — Antigravity adapter removed in v2.2.0, but an existing
+// config.json naming it must not become invalid.
+const VALID_AGENTS = new Set(['claude-code', 'codex', 'antigravity', 'opencode', 'omp']);
 
 const BLOCKED_MERGE_KEYS = new Set(['__proto__', 'constructor', 'prototype']);
 
@@ -79,6 +81,9 @@ export function buildDefaultRuntimeConfig(overrides = {}) {
         targets: {
           claude: { autoCompact: true, mode: 'precompact-reinject', preserveExistingHooks: true },
           opencode: { autoCompact: true, mode: 'native-auto-prune', preserveExistingCompaction: true },
+          // 'precompact-reinject' like claude, NOT codex's 'soft-handoff': omp exposes real
+          // pre-compaction hook events, so there is nothing to work around with a state file.
+          omp: { autoCompact: true, mode: 'precompact-reinject', preserveExistingHooks: true },
           codex: {
             autoCompact: true,
             mode: 'soft-handoff',

package/src/core/status.js

@@ -11,8 +11,10 @@ import { detectProjectContext } from '../context/detectProjectContext.js';
 function formatPrimaryAgent(agentKey) {
   if (agentKey === 'claude-code') return 'Claude Code';
   if (agentKey === 'codex') return 'OpenAI Codex';
+  // legacy: Antigravity adapter removed in this release; existing config.json may still name it
   if (agentKey === 'antigravity') return 'Antigravity';
   if (agentKey === 'opencode') return 'OpenCode';
+  if (agentKey === 'omp') return 'Oh My Pi (omp)';
   return agentKey || 'Unknown';
 }
 
@@ -20,9 +22,9 @@ async function detectAdapterLabels(projectRoot, primaryAgent) {
   const labels = [formatPrimaryAgent(primaryAgent)];
 
   const checks = [
-    { label: 'Antigravity', path: '.antigravity/README.md' },
     { label: 'OpenAI Codex', path: '.codex/settings.json' },
     { label: 'OpenCode', path: 'opencode.json' },
+    { label: 'Oh My Pi (omp)', path: '.omp/config.yml' },
   ];
 
   for (const check of checks) {

package/src/core/uninstall.js

@@ -24,8 +24,10 @@ const ALLOWED_UNINSTALL_PREFIXES = [
   'AGENTS.md',
   'docs/',
   '.claude/',
+  // legacy: Antigravity adapter removed in v2.2.0; still cleaned up on repos that installed it
   '.antigravity/',
   '.codex/',
+  '.omp/',
   '.ukit/',
   'opencode.json',
 ];
@@ -77,14 +79,28 @@ function buildFallbackPaths(projectRoot) {
       path.join(projectRoot, '.claude', 'ukit', '.env.example'),
       path.join(projectRoot, '.claude', 'ukit', 'permission-usage.json'),
       path.join(projectRoot, '.claude', 'ukit', 'permission-audit.log'),
+      // legacy: Antigravity adapter removed in v2.2.0; still cleaned up on repos that installed it
       path.join(projectRoot, '.antigravity', 'rules', 'rules.md'),
       path.join(projectRoot, '.antigravity', 'README.md'),
       path.join(projectRoot, '.codex', 'README.md'),
       path.join(projectRoot, 'opencode.json'),
+      // omp adapter — 11 managed files, no symlinks (the adapter creates none)
+      path.join(projectRoot, '.omp', 'AGENTS.md'),
+      path.join(projectRoot, '.omp', 'RULES.md'),
+      path.join(projectRoot, '.omp', 'config.yml'),
+      path.join(projectRoot, '.omp', 'README.md'),
+      path.join(projectRoot, '.omp', 'hooks', 'pre', 'ukit-bridge.js'),
+      path.join(projectRoot, '.omp', 'agents', 'bug-debugger.md'),
+      path.join(projectRoot, '.omp', 'agents', 'code-reviewer.md'),
+      path.join(projectRoot, '.omp', 'agents', 'feature-implementer.md'),
+      path.join(projectRoot, '.omp', 'agents', 'handoff-planner.md'),
+      path.join(projectRoot, '.omp', 'agents', 'ukit-small-task-maintainer.md'),
+      path.join(projectRoot, '.omp', 'agents', 'ukit-vision-analyst.md'),
       path.join(projectRoot, '.ukit'),
       stateDir,
     ],
     linkPaths: [
+      // legacy: Antigravity adapter removed in v2.2.0; still cleaned up on repos that installed it
       path.join(projectRoot, '.antigravity', 'skills'),
       path.join(projectRoot, '.antigravity', 'ukit'),
       path.join(projectRoot, '.codex', 'skills'),

package/src/index/routeCatalog.js

@@ -256,7 +256,7 @@ export const ROUTE_CATALOG = [
     signals: [
       { type: 'prompt', regex: /\b(stale|refresh|cleanup|reinstall|maintenance|workspace drift|index freshness|out of date)\b/i, score: 4 },
       { type: 'command', regex: /\bukit install\b|\brefresh-index\.mjs\b|\bbuild-index\.mjs\b/i, score: 3 },
-      { type: 'file', regex: /\.claude\/|\.codex\/|\.antigravity\//i, score: 1 },
+      { type: 'file', regex: /\.claude\/|\.codex\/|\.antigravity\/|\.omp\//i, score: 1 },
     ],
   },
   {

package/src/manifest/selectItems.js

@@ -1,9 +1,4 @@
 export const OPTIONAL_ADAPTER_ITEM_IDS = new Set([
-  'multi-antigravity-skills-link',
-  'multi-antigravity-ukit-link',
-  'multi-antigravity-rules',
-  'multi-antigravity-readme',
-  'multi-antigravity-agents-link',
   'multi-codex-skills-link',
   'multi-codex-ukit-link',
   'multi-codex-readme',
@@ -11,6 +6,17 @@ export const OPTIONAL_ADAPTER_ITEM_IDS = new Set([
   'multi-codex-settings-local',
   'multi-codex-agents-link',
   'multi-opencode-config',
+  'multi-omp-agents-md',
+  'multi-omp-rules',
+  'multi-omp-config',
+  'multi-omp-readme',
+  'multi-omp-hook-bridge',
+  'multi-omp-agent-bug-debugger',
+  'multi-omp-agent-code-reviewer',
+  'multi-omp-agent-feature-implementer',
+  'multi-omp-agent-handoff-planner',
+  'multi-omp-agent-ukit-small-task-maintainer',
+  'multi-omp-agent-ukit-vision-analyst',
 ]);
 
 function resolveItemOrder(items) {

package/templates/.claude/commands/ukit/handoff-clear.md

@@ -57,7 +57,7 @@ Cleared: X worktrees removed, Y branches deleted, staged changes unstaged.
 Handoff docs reset. Ready for new cycle.
 ```
 
-> Claude Code: spawn `ukit-small-task-maintainer` (haiku).
+> Claude Code: spawn `ukit-small-task-maintainer` (haiku). omp: the `task` tool with `agent: "ukit-small-task-maintainer"`.
 > Other tools: lite model, follow steps 1–5.
 
 **Next:** `/ukit:handoff-create <new problem description>`