@trac3er/oh-my-god 1.0.4 → 2.0.0-b

package/.coveragerc

@@ -0,0 +1,26 @@
+[run]
+source = .
+omit =
+    tests/*
+    */__pycache__/*
+    .venv/*
+    setup.py
+    */site-packages/*
+
+[report]
+exclude_lines =
+    pragma: no cover
+    def __repr__
+    raise AssertionError
+    raise NotImplementedError
+    if __name__ == .__main__.:
+    if TYPE_CHECKING:
+    @abstractmethod
+    @abc.abstractmethod
+    pass
+
+precision = 2
+show_missing = True
+
+[html]
+directory = htmlcov

package/.mcp.json

@@ -0,0 +1,24 @@
+{
+  "mcpServers": {
+    "context7": {
+      "command": "npx",
+      "args": ["-y", "@upstash/context7-mcp"]
+    },
+    "filesystem": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
+    },
+    "websearch": {
+      "command": "npx",
+      "args": ["-y", "@zhafron/mcp-web-search"]
+    },
+    "chrome-devtools": {
+      "command": "npx",
+      "args": ["-y", "chrome-devtools-mcp@latest"]
+    },
+    "omg-memory": {
+      "type": "http",
+      "url": "http://127.0.0.1:8765/mcp"
+    }
+  }
+}

package/OMG-setup.sh

@@ -216,6 +216,11 @@ parse_args() {
     if [ ! -t 0 ] || [ -n "${npm_lifecycle_event:-}" ] || [ -n "${npm_execpath:-}" ]; then
         NON_INTERACTIVE=true
     fi
+
+    # Auto-enable plugin mode for npm installs
+    if [ -n "${npm_execpath:-}" ] || [ -n "${npm_lifecycle_event:-}" ]; then
+        INSTALL_AS_PLUGIN=true
+    fi
 }
 
 preflight() {
@@ -660,7 +665,39 @@ install_plugin_bundle() {
     mkdir -p "$plugin_root/.claude-plugin"
     mkdir -p "$CLAUDE_DIR/hud"
     cp "$plugin_manifest_src" "$plugin_manifest_target"
-    write_plugin_mcp_file "$plugin_mcp_target" >/dev/null
+    
+    # Provide a fallback .mcp.json if not shipped in npm package
+    if [ ! -f "$SCRIPT_DIR/.mcp.json" ]; then
+        local _fallback_mcp_dir
+        _fallback_mcp_dir=$(mktemp -d)
+        cat > "$_fallback_mcp_dir/.mcp.json" <<'FALLBACK_MCP'
+{
+  "mcpServers": {
+    "context7": {
+      "command": "npx",
+      "args": ["-y", "@upstash/context7-mcp"]
+    },
+    "filesystem": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
+    },
+    "websearch": {
+      "command": "npx",
+      "args": ["-y", "@zhafron/mcp-web-search"]
+    },
+    "chrome-devtools": {
+      "command": "npx",
+      "args": ["-y", "chrome-devtools-mcp@latest"]
+    }
+  }
+}
+FALLBACK_MCP
+        SCRIPT_DIR="$_fallback_mcp_dir" write_plugin_mcp_file "$plugin_mcp_target" >/dev/null
+        rm -rf "$_fallback_mcp_dir"
+    else
+        write_plugin_mcp_file "$plugin_mcp_target" >/dev/null
+    fi
+    
     cp "$hud_src" "$hud_target"
     mkdir -p "$PLUGIN_CACHE_DIR"
     printf '%s\n' "omg-plugin-bundle-v1" > "$PLUGIN_CACHE_DIR/$PLUGIN_BUNDLE_MARKER_FILE"

package/README.md

@@ -1,13 +1,13 @@
-# OMG v1.0.4
+# OMG v2.0.0-b
 
 OMG (Oh My God) is a standalone orchestration layer for Claude Code.
-It adds structured multi-agent workflows, intelligent model routing (Claude/Codex/Gemini), and durable session state for long-running engineering tasks.
+It adds structured multi-agent workflows, intelligent model routing (Claude/Codex/Gemini/OpenCode/Kimi Code), and durable session state for long-running engineering tasks.
 
-- Version: `v1.0.4`
+- Version: `v2.0.0-b`
 - npm: `npm install @trac3er/oh-my-god`
 - Maintainer: `trac3er00`
 - Repo: `git@github.com:trac3er00/OMG.git`
-- Release: `https://github.com/trac3er00/OMG/releases/tag/v1.0.4`
+- Release: `https://github.com/trac3er00/OMG/releases/tag/v2.0.0-b`
 
 ## What OMG Solves
 
@@ -21,23 +21,40 @@ OMG is built for teams and solo developers who want:
 ## Core Capabilities
 
 - Multi-agent orchestration with role-specific agents
-- Dynamic routing to Codex and Gemini for domain-specific tasks
+- Dynamic routing to Codex, Gemini, OpenCode, and Kimi Code for domain-specific tasks
 - Failure tracking and escalation after repeated unsuccessful attempts
 - Command surface for planning, review, security, handoff, and execution modes
 - Context minimization and selective knowledge injection to reduce prompt noise
 
+## Multi-CLI Support
+
+OMG v2.0 supports 5 CLI providers with a unified provider abstraction:
+
+| CLI | Command | Auth |
+|-----|---------|------|
+| Claude | (default) | Claude Code |
+| Codex | `codex exec "<prompt>"` | `codex login` |
+| Gemini | `gemini -p "<prompt>"` | `gemini auth login` |
+| OpenCode | `opencode run "<prompt>"` | `opencode auth login` |
+| Kimi Code | `kimi --print -p "<prompt>"` | `~/.kimi/config.toml` token |
+
+All providers are auto-detected and registered at startup. Use `/OMG:setup` to configure.
+
 ## At a Glance
 
-- Hooks: 27 Python hooks
+- Hooks: 48 Python hooks
 - Core rules: 5
 - Contextual rules: 17
 - Agents: 21
-- Commands: 18 (`/OMG:*` namespace)
+- Commands: 22 (`/OMG:*` namespace)
+- CLI Providers: 5 (Claude, Codex, Gemini, OpenCode, Kimi Code)
+- Feature flags: 17 (all new in v2.0)
 
 ## Requirements
 
-- Python `3.8+`
+- Python `3.10+`
 - Claude Code with write access to `~/.claude`
+- `fastmcp>=2.0` (for memory server)
 
 ## Installation
 
@@ -124,6 +141,12 @@ Common flows:
 /OMG:handoff
 ```
 
+Run the setup wizard to configure CLI providers:
+
+```text
+/OMG:setup
+```
+
 ## Command Groups
 
 ### Core commands
@@ -138,6 +161,7 @@ Common flows:
 - `/OMG:ccg`
 - `/OMG:crazy`
 - `/OMG:compat`
+- `/OMG:setup`
 
 ### Advanced commands
 
@@ -153,12 +177,21 @@ Common flows:
 - `/OMG:ralph-stop`
 - `/OMG:theme`
 
+### v2.0 commands
+
+- `/OMG:cost` — Cost tracking and budget management (`/cost history`, `/cost budget`, `/cost reset`)
+- `/OMG:stats` — Session analytics dashboard (`/stats weekly`, `/stats files`, `/stats failures`, `/stats dashboard`)
+- `/OMG:deps` — Dependency health and CVE scanning (`/deps cves`, `/deps licenses`, `/deps outdated`)
+- `/OMG:arch` — Codebase visualization and architecture diagrams (`/arch render`, `/arch stats`, `/arch --native`)
+
 ## Agent Routing Model
 
 OMG dispatches by domain intent:
 
 - Codex path: backend logic, debugging, algorithms, security-sensitive implementation
 - Gemini path: UI/UX, layout, visual refinements, accessibility-oriented frontend work
+- OpenCode path: general-purpose tasks with OpenCode's native tool use
+- Kimi Code path: long-context tasks and document-heavy analysis
 - Claude path: orchestration, synthesis, review loops, and fallback execution
 
 ## Cognitive Modes
@@ -199,7 +232,11 @@ After `/OMG:init`, project state is created under `.omg/`:
     profile.yaml
     working-memory.md
     handoff.md
+    cli-config.yaml
     ledger/
+    dephealth/
+    dashboard.html
+    arch-diagram.png
   knowledge/
   trust/
   evidence/
@@ -218,15 +255,81 @@ omg/
   agents/
   commands/
   plugins/
+    dephealth/
+    viz/
   templates/
   runtime/
   scripts/
   OMG-setup.sh
 ```
 
+## Shared Memory (MCP Server)
+
+OMG v2.0 includes a FastMCP-based shared memory server that enables cross-CLI state sharing.
+
+### Starting the Memory Server
+
+```bash
+python3 runtime/mcp_memory_server.py
+```
+
+The server binds to `127.0.0.1:8765` by default. Configure via environment variables:
+
+- `OMG_MEMORY_HOST` — bind address (default: `127.0.0.1`)
+- `OMG_MEMORY_PORT` — port (default: `8765`)
+- `OMG_MEMORY_AUTOSTART` — auto-start on import (default: off)
+
+The server exposes 6 MCP tools: `memory_store`, `memory_search`, `memory_list`, `memory_delete`, `memory_import`, and `memory_export`. A `/health` endpoint is also available at `http://127.0.0.1:8765/health`.
+
+### Memory Import
+
+Import memories from other AI platforms:
+
+- **ChatGPT**: Export `conversations.json` from OpenAI, then parse with `runtime/memory_parsers/chatgpt_parser.py`
+- **Claude.ai**: Use the extraction prompt from `runtime/memory_parsers/claude_import.py`, paste the result
+- **Gemini Web**: Use the extraction prompt from `runtime/memory_parsers/gemini_import.py`, paste the result
+- **Kimi Web**: Use the extraction prompt from `runtime/memory_parsers/kimi_import.py`, paste the result
+
+### Memory Export
+
+Export all memories to markdown for uploading to Claude Projects or pasting into ChatGPT:
+
+```python
+from runtime.memory_store import MemoryStore
+from runtime.memory_parsers.export import export_from_store
+
+store = MemoryStore()
+export_from_store(store, "memories.md")
+```
+
 ## Versioning and Releases
 
-Current version: `v1.0.4`
+Current version: `v2.0.0-b`
+
+### v2.0.0-b release notes
+
+- Multi-CLI provider abstraction: Codex, Gemini, OpenCode, Kimi Code + Claude
+- `/OMG:setup` interactive wizard with CLI detection, auth verification, and MCP config writing
+- FastMCP shared memory MCP server (`runtime/mcp_memory_server.py`) with 6 tools
+- Memory import parsers: ChatGPT `conversations.json`, Claude.ai/Gemini/Kimi paste-based
+- Memory export to markdown for cross-platform sharing
+- MCP server lifecycle manager (`runtime/mcp_lifecycle.py`)
+- 8 capability gaps addressed: cost tracking, context management, secrets, test generation, git automation, analytics, dependency health, and codebase visualization
+- 4 new commands: `/OMG:cost`, `/OMG:stats`, `/OMG:deps`, `/OMG:arch`
+- 48 Python hooks (up from 27 in v1.0.5)
+- 6 confirmed bug fixes including critical `_oal`→`_omg` feature flag fix
+- Python minimum raised to 3.10+
+- Test suite expanded from 1523 to 1900+ tests
+
+### v1.0.5 release notes
+
+- npm `install` now auto-registers OMG as a Claude Code plugin via `postinstall` hook with npm context detection.
+- Added `.mcp.json` and `hud/` to the npm package (previously excluded by `.npmignore`).
+- `.claude-plugin/scripts/install.sh` now passes `--install-as-plugin --non-interactive` flags.
+- Added `OMG-setup.sh` fallback MCP config heredoc for npm installs missing `.mcp.json`.
+- New `runtime/tmux_session_manager.py` provides persistent tmux sessions for Codex/Gemini invocations with sentinel-based completion detection.
+- `runtime/team_router.py` now routes Codex/Gemini calls through persistent tmux sessions when available, with graceful subprocess fallback.
+- Added 20 new tests across 4 test files covering plugin auto-registration and tmux integration (1580 total tests passing).
 
 ### v1.0.4 emergency installation bug fix notes
 
@@ -246,15 +349,15 @@ Releases are automated via GitHub Actions. When a version tag is pushed, the `pu
 
 ```bash
 # bump version in package.json, then:
-git tag v1.0.4
-git push origin v1.0.4
-# → GitHub Actions auto-publishes @trac3er/oh-my-god@1.0.4 to npm
+git tag v2.0.0-b
+git push origin v2.0.0-b
+# → GitHub Actions auto-publishes @trac3er/oh-my-god@2.0.0-b to npm
 ```
 
 Manual release (if needed):
 
 ```bash
-gh release create v1.0.4 --title "OMG v1.0.4" --notes "Release notes"
+gh release create v2.0.0-b --title "OMG v2.0.0-b" --notes "Release notes"
 ```
 
 ## Compatibility Notes
@@ -287,11 +390,73 @@ bash ~/.claude/plugins/cache/oh-advanced-layer/oal/*/.claude-plugin/scripts/upda
 
 MIT
 
-## New in v1.1 (Enhancement Release)
+## New in v2.0
+
+v2.0 addresses 8 capability gaps identified through production usage. All features are disabled by default and fully backward-compatible with v1.x workflows.
+
+### Gap 1: Real-Time Cost & Token Budget Management
+
+Inspired by BATS (Budget-Aware Token Scheduling) and FrugalGPT cost-optimization research. Tracks token usage and USD spend per tool call, fires threshold alerts at 50%/80%/95% budget, and provides a full cost breakdown by tool and session.
+
+- Hook: `budget_governor.py` (PostToolUse)
+- Command: `/OMG:cost`
+- Flag: `COST_TRACKING`
+
+### Gap 2: Intelligent Context Window Manager
+
+Enhanced with Acon (Adaptive Context) and MemGPT-inspired memory tiering. Manages context window pressure by selectively compressing or evicting stale context while preserving high-value working memory.
+
+- Hook: `context_manager.py`
+- Flag: built into core context management
+
+### Gap 3: Secrets & Environment Vault Upgrades
+
+Adds allowlisting, audit logging, and expiry tracking to the existing secrets vault. Prevents accidental exposure of credentials in tool outputs and tracks secret access patterns.
+
+- Hook: `secrets_vault.py`
+- Flag: built into core secrets handling
+
+### Gap 4: Automated Test Generation Engine
+
+CodaMosa-inspired iterative test generation. Analyzes uncovered code paths and generates targeted test cases, prioritizing edge cases and boundary conditions that manual test writing tends to miss.
+
+- Plugin: `plugins/testgen/`
+- Flag: `TEST_GENERATION`
 
-### Feature Flags
+### Gap 5: Advanced Git Workflow Automation
 
-All new features are disabled by default. Enable via environment variables or `settings.json`:
+Extends git integration beyond status checks to full commit execution, branch management, and PR creation. Supports conventional commit formatting, branch naming conventions, and automated PR descriptions.
+
+- Hook: `git_workflow.py`
+- Flag: `GIT_WORKFLOW`
+
+### Gap 6: Session Analytics & Productivity Dashboard
+
+Unified query layer over all OMG state files. Surfaces tool usage trends, file heatmaps, failure patterns, and escalation effectiveness. Generates a self-contained HTML dashboard at `.omg/state/dashboard.html`.
+
+- Hook: `session_tracker.py`
+- Command: `/OMG:stats`
+- Flag: `SESSION_ANALYTICS`
+
+### Gap 7: Dependency Health & License Compliance
+
+CVE scanning via the OSV batch API with reachability analysis (direct vs. transitive imports). License compatibility checker with tiered model: permissive > weak-copyleft > copyleft. Supports npm, pip, Cargo, Go modules, and RubyGems.
+
+- Plugin: `plugins/dephealth/`
+- Command: `/OMG:deps`
+- Flag: `DEP_HEALTH`
+
+### Gap 8: Codebase Visualization
+
+AST-based dependency graph builder for Python (stdlib `ast`), with regex fallback for JS/TS/Go. Generates Mermaid and D2 diagrams, renders to PNG via mermaid.ink, and supports native toolchain parsing (`go list`, `tsc`, `cargo metadata`) for ~95% accuracy.
+
+- Plugin: `plugins/viz/`
+- Command: `/OMG:arch`
+- Flag: `CODEBASE_VIZ`
+
+## Feature Flags
+
+All features are disabled by default. Enable via environment variables or `settings.json`:
 
 | Feature | Env Var | Default |
 |---------|---------|---------|
@@ -306,6 +471,14 @@ All new features are disabled by default. Enable via environment variables or `s
 | SSH manager | `OMG_SSH_ENABLED=1` | Off |
 | Themes | `OMG_THEMES_ENABLED=true` | Off |
 | Rust engine | `OMG_RUST_ENGINE_ENABLED=1` | Off |
+| Setup wizard | `OMG_SETUP_ENABLED=1` | Off |
+| Memory server | `OMG_MEMORY_AUTOSTART=1` | Off |
+| **Cost tracking** | `OMG_COST_TRACKING_ENABLED=1` | Off |
+| **Git workflow automation** | `OMG_GIT_WORKFLOW_ENABLED=1` | Off |
+| **Session analytics** | `OMG_SESSION_ANALYTICS_ENABLED=1` | Off |
+| **Test generation** | `OMG_TEST_GENERATION_ENABLED=1` | Off |
+| **Dependency health** | `OMG_DEP_HEALTH_ENABLED=1` | Off |
+| **Codebase visualization** | `OMG_CODEBASE_VIZ_ENABLED=1` | Off |
 
 You can also enable features in `settings.json` under `_omg.features`:
 
@@ -314,17 +487,18 @@ You can also enable features in `settings.json` under `_omg.features`:
   "_omg": {
     "features": {
       "THEMES": true,
-      "INTENTGATE": true
+      "COST_TRACKING": true,
+      "SESSION_ANALYTICS": true
     }
   }
 }
 ```
 
-### New Commands
+### New Commands (v1.1)
 
 - `/OMG:theme` — Interactive theme selector with `--list`, `--preview`, `--set`, and `--auto` modes
 
-### New Agents
+### New Agents (v1.1)
 
 v1.1 ships with expanded agent coverage:
 
@@ -342,6 +516,37 @@ v1.1 ships with expanded agent coverage:
 
 ## Migration Guide
 
+### Upgrading from OMG v1.x to v2.0
+
+All new features default to `False` and are fully backward-compatible. Existing workflows continue unchanged.
+
+To adopt v2.0 features selectively:
+
+1. **Enable via env var** before launching Claude Code:
+   ```bash
+   export OMG_COST_TRACKING_ENABLED=1
+   export OMG_SESSION_ANALYTICS_ENABLED=1
+   export OMG_DEP_HEALTH_ENABLED=1
+   ```
+
+2. **Or enable in `settings.json`** for persistent config:
+   ```json
+   {
+     "_omg": {
+       "features": {
+         "COST_TRACKING": true,
+         "SESSION_ANALYTICS": true,
+         "DEP_HEALTH": true,
+         "CODEBASE_VIZ": true
+       }
+     }
+   }
+   ```
+
+3. **No breaking changes** — all v1.x commands, agents, and hooks remain intact.
+
+4. **New commands** are available immediately after update, each gated by its respective feature flag.
+
 ### Upgrading from OMG v1.0 to v1.1
 
 All new features default to `False` and are fully backward-compatible. Existing workflows continue unchanged.
@@ -369,3 +574,17 @@ To adopt new features selectively:
 3. **No breaking changes** — all v1.0 commands, agents, and hooks remain intact.
 
 4. **New command**: `/OMG:theme` is available immediately after update, gated by `OMG_THEMES_ENABLED`.
+
+### Upgrading from OMG v1.x to v2.0
+
+v2.0 is backward-compatible. All v1.x commands, agents, and hooks remain intact.
+
+New in v2.0:
+
+1. **Multi-CLI support** — install additional CLI tools and run `/OMG:setup` to configure them.
+
+2. **Memory server** — start `python3 runtime/mcp_memory_server.py` to enable cross-CLI memory sharing.
+
+3. **Setup wizard** — enable with `OMG_SETUP_ENABLED=1`, then run `/OMG:setup` for guided configuration.
+
+4. **Python 3.10+ required** — upgrade if you're on an older Python version.