feat(omo-codex): scaffold @oh-my-opencode/omo-codex workspace package

2026-05-25 22:24:51 +09:00
parent 2415f37bc0
commit 400006ec2c
9 changed files with 132 additions and 5 deletions
@@ -0,0 +1,56 @@
+# @oh-my-opencode/omo-codex
+
+Codex harness adapter for **oh-my-openagent**. Brings the OMO experience (rules injection, comment checker, LSP MCP, ultrawork, ultragoal) into [OpenAI Codex CLI](https://github.com/openai/codex) through Codex's native plugin system.
+
+## Layout
+
+| Path | Purpose |
+|------|---------|
+| `plugin/` | Vendored Codex plugin namespace `omo` with 5 components. Shipped to the user via `~/.codex/plugins/cache/`. |
+| `marketplace.json` | Codex marketplace manifest. Identifies `omo` as the single installable plugin. |
+| `scripts/` | Node ESM build scripts (port of the original `codex-plugins/scripts/install-local.mjs`). |
+| `src/` | TypeScript runtime: installer + telemetry consumed by the omodex CLI. |
+| `MARKETPLACE.md` | Vendored upstream marketplace README. |
+
+## Components Vendored
+
+- `rules` (TypeScript) - injects `AGENTS.md` / `CLAUDE.md` / `.omo/rules/**` into context via `SessionStart`, `UserPromptSubmit`, `PostToolUse`, `PostCompact`.
+- `comment-checker` (TypeScript) - runs `@code-yeongyu/comment-checker` after `apply_patch` / `edit` / `write` tool use.
+- `lsp` (TypeScript + LSP MCP) - exposes LSP diagnostics, navigation, symbols, rename via MCP + post-edit hooks.
+- `ultrawork` (Python) - keyword detector (`ulw` / `ultrawork`) that injects the full ultrawork directive, plus a `SessionStart` hook that syncs bundled agent TOML files into `CODEX_HOME/agents`.
+- `ultragoal` (TypeScript) - durable multi-goal orchestration backed by `.omo/ultragoal/` evidence audit.
+
+## Install
+
+End users invoke through the omodex CLI:
+
+```bash
+bunx omo install --codex=yes
+# or, equivalently:
+bunx oh-my-opencode install --codex=yes
+bunx oh-my-openagent install --codex=yes
+```
+
+The installer copies the built plugin into `~/.codex/plugins/cache/code-yeongyu-codex-plugins/omo/<version>/`, enables it in `~/.codex/config.toml`, and links the per-component binaries into `~/.local/bin/` (or `CODEX_LOCAL_BIN_DIR`).
+
+## Telemetry
+
+Anonymous telemetry uses the same PostHog project as oh-my-openagent but emits the distinct event `omo_codex_daily_active`. Opt out with:
+
+```bash
+export OMO_CODEX_DISABLE_POSTHOG=1
+# or globally for every OMO product:
+export OMO_DISABLE_POSTHOG=1
+```
+
+See `/Users/yeongyu/local-workspaces/omodex/docs/legal/privacy-policy.md` for the full disclosure.
+
+## Provenance
+
+Vendored from [`code-yeongyu/codex-plugins`](https://github.com/code-yeongyu/codex-plugins) at the snapshot present in `/Users/yeongyu/local-workspaces/codex-plugins/` on 2026-05-25. Per-component upstream:
+
+- [code-yeongyu/codex-rules](https://github.com/code-yeongyu/codex-rules)
+- [code-yeongyu/codex-comment-checker](https://github.com/code-yeongyu/codex-comment-checker)
+- [code-yeongyu/codex-lsp](https://github.com/code-yeongyu/codex-lsp)
+- [code-yeongyu/codex-ultrawork](https://github.com/code-yeongyu/codex-ultrawork)
+- [code-yeongyu/codex-ultragoal](https://github.com/code-yeongyu/codex-ultragoal)
@@ -0,0 +1 @@
+export * from "./src/index";
@@ -0,0 +1,29 @@
+{
+  "name": "@oh-my-opencode/omo-codex",
+  "version": "0.1.0",
+  "type": "module",
+  "private": true,
+  "description": "Codex harness adapter for oh-my-openagent. Vendored Codex plugin namespace (omo) + TypeScript installer + telemetry.",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./src/index.ts"
+    },
+    "./telemetry": "./src/telemetry/index.ts",
+    "./marketplace.json": "./marketplace.json"
+  },
+  "types": "./index.d.ts",
+  "scripts": {
+    "typecheck": "tsgo --noEmit -p tsconfig.json",
+    "test": "bun test src/**/*.test.ts",
+    "build:plugin": "node ./scripts/build-plugin.mjs",
+    "sync:skills": "node plugin/scripts/sync-skills.mjs"
+  },
+  "dependencies": {
+    "@oh-my-opencode/utils": "workspace:*",
+    "posthog-node": "^5.34.3"
+  },
+  "devDependencies": {
+    "bun-types": "1.3.14"
+  }
+}
@@ -0,0 +1,2 @@
+export * from "./telemetry"
+export * from "./install"
@@ -0,0 +1,4 @@
+// Codex install module entry point. Implemented in subsequent commits.
+// Hosts the TypeScript port of scripts/install-local.mjs invoked from the
+// omodex CLI when the user passes `--codex=yes` to `bunx omo install`.
+export {}
@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "lib": ["ESNext"],
+    "types": ["bun-types"]
+  },
+  "include": ["src/**/*"]
+}