@trac3er/oh-my-god 2.0.4 → 2.0.7

package/build/lib/commands/OMG:arch.md

@@ -0,0 +1,313 @@
+---
+description: "Codebase visualization — dependency graphs and architecture diagrams."
+allowed-tools: Read, Bash(python*:*), Grep
+argument-hint: "[render|module-name|stats|--native]"
+---
+
+# /OMG:arch — Architecture Visualization
+
+Visualize project dependency graphs as Mermaid diagrams, render to PNG, zoom into specific modules, and inspect graph statistics.
+
+## Usage
+
+```
+/OMG:arch
+/OMG:arch render
+/OMG:arch <module-name>
+/OMG:arch stats
+/OMG:arch --native
+```
+
+## Sub-Commands
+
+### `/OMG:arch` (default)
+
+Full project dependency graph as Mermaid text output, embeddable in Markdown.
+
+Scans all Python (.py), JavaScript/TypeScript (.js/.jsx/.ts/.tsx), and Go (.go) files. Python files are parsed via AST; JS/TS/Go files use regex-based import detection (~70% accuracy).
+
+```python
+from plugins.viz.graph_builder import build_project_graph
+from plugins.viz.diagram_generator import generate_mermaid
+
+result = build_project_graph(".")
+graph = result.get("graph", {})
+
+mermaid_text = generate_mermaid(graph)
+if mermaid_text:
+    print("```mermaid")
+    print(mermaid_text)
+    print("```")
+else:
+    print("No dependencies detected.")
+```
+
+### `/OMG:arch render`
+
+Render the dependency graph to a PNG image via the mermaid.ink public API. Saves output to `.omg/state/arch-diagram.png`.
+
+Requires network access to `https://mermaid.ink`.
+
+```python
+import os
+from plugins.viz.graph_builder import build_project_graph
+from plugins.viz.diagram_generator import generate_mermaid, render_to_png
+
+result = build_project_graph(".")
+graph = result.get("graph", {})
+mermaid_text = generate_mermaid(graph)
+
+output_path = os.path.join(".omg", "state", "arch-diagram.png")
+os.makedirs(os.path.dirname(output_path), exist_ok=True)
+
+if render_to_png(mermaid_text, output_path):
+    print(f"Diagram rendered to {output_path}")
+else:
+    print("Render failed — check network access or graph size.")
+```
+
+### `/OMG:arch <module-name>`
+
+Zoomed subgraph for a specific module. Shows only the named module and its direct dependencies.
+
+Replace `<module-name>` with the dotted module path (e.g. `plugins.viz.graph_builder`).
+
+```python
+from plugins.viz.graph_builder import build_project_graph
+from plugins.viz.diagram_generator import generate_mermaid
+
+result = build_project_graph(".")
+graph = result.get("graph", {})
+
+# Zoom into a specific module
+module_name = "<module-name>"  # e.g. "plugins.viz.graph_builder"
+mermaid_text = generate_mermaid(graph, zoom=module_name)
+
+if mermaid_text:
+    print(f"Dependencies for: {module_name}")
+    print()
+    print("```mermaid")
+    print(mermaid_text)
+    print("```")
+else:
+    print(f"Module '{module_name}' not found in dependency graph.")
+    print()
+    print("Available modules:")
+    for mod in sorted(graph.keys()):
+        print(f"  - {mod}")
+```
+
+### `/OMG:arch stats`
+
+Graph statistics: module count, edge count, max depth, circular dependencies, and coupling score.
+
+```python
+from plugins.viz.graph_builder import build_project_graph
+
+result = build_project_graph(".")
+metrics = result.get("metrics", {})
+
+module_count = metrics.get("module_count", 0)
+edge_count = metrics.get("edge_count", 0)
+max_depth = metrics.get("max_depth", 0)
+circular_deps = metrics.get("circular_deps", [])
+coupling_score = metrics.get("coupling_score", 0.0)
+
+print(f"Modules:        {module_count}")
+print(f"Edges:          {edge_count}")
+print(f"Max depth:      {max_depth}")
+print(f"Circular deps:  {len(circular_deps)}")
+print(f"Coupling score: {coupling_score:.2f}")
+
+if circular_deps:
+    print()
+    print("Circular dependency cycles:")
+    for cycle in circular_deps:
+        print(f"  {' → '.join(cycle)}")
+```
+
+### `/OMG:arch --native`
+
+Use native language toolchains for higher-accuracy dependency parsing (~95% vs ~70% with regex).
+
+Supported toolchains:
+- **Go**: `go list -json ./...` — requires `go` on PATH
+- **TypeScript**: `tsc --listFiles --noEmit` — requires `tsc` on PATH
+- **Rust**: `cargo metadata --format-version=1 --no-deps` — requires `cargo` on PATH
+
+Falls back to regex parsing when a toolchain is not available.
+
+```python
+from plugins.viz.native_parsers import (
+    is_toolchain_available,
+    parse_go_native,
+    parse_typescript_native,
+    parse_rust_native,
+)
+from plugins.viz.graph_builder import build_project_graph
+from plugins.viz.diagram_generator import generate_mermaid
+
+# Check available toolchains
+toolchains = {
+    "go": is_toolchain_available("go"),
+    "tsc": is_toolchain_available("tsc"),
+    "cargo": is_toolchain_available("cargo"),
+}
+
+print("Toolchain availability:")
+for tc, available in toolchains.items():
+    status = "available" if available else "not found"
+    print(f"  {tc}: {status}")
+print()
+
+# Parse with native toolchains where available
+native_graphs = {}
+if toolchains["go"]:
+    go_result = parse_go_native(".")
+    if "error" not in go_result:
+        native_graphs.update(go_result["graph"])
+        print(f"Go: {len(go_result['graph'])} packages (native-95% accuracy)")
+
+if toolchains["tsc"]:
+    ts_result = parse_typescript_native(".")
+    if "error" not in ts_result:
+        native_graphs.update(ts_result["graph"])
+        print(f"TypeScript: {len(ts_result['graph'])} modules (native-95% accuracy)")
+
+if toolchains["cargo"]:
+    rust_result = parse_rust_native(".")
+    if "error" not in rust_result:
+        native_graphs.update(rust_result["graph"])
+        print(f"Rust: {len(rust_result['graph'])} crates (native-95% accuracy)")
+
+# Fall back to regex-based graph for remaining files
+result = build_project_graph(".")
+graph = result.get("graph", {})
+
+# Merge: native results override regex results
+merged = {**graph, **native_graphs}
+
+mermaid_text = generate_mermaid(merged)
+if mermaid_text:
+    print()
+    print("```mermaid")
+    print(mermaid_text)
+    print("```")
+```
+
+## Feature Flag
+
+- **Flag name**: `OMG_CODEBASE_VIZ_ENABLED`
+- **Default**: `False` (disabled)
+- **Enable**: `export OMG_CODEBASE_VIZ_ENABLED=1`
+
+Or set in `settings.json`:
+
+```json
+{
+  "_omg": {
+    "features": {
+      "CODEBASE_VIZ": true
+    }
+  }
+}
+```
+
+## Output Example
+
+### `/OMG:arch` output
+
+````
+```mermaid
+graph TD
+    hooks_budget_governor["hooks.budget_governor"]
+    hooks__common["hooks._common"]
+    hooks__cost_ledger["hooks._cost_ledger"]
+    plugins_viz_graph_builder["plugins.viz.graph_builder"]
+    plugins_viz_ast_parser["plugins.viz.ast_parser"]
+    plugins_viz_regex_parser["plugins.viz.regex_parser"]
+    hooks_budget_governor --> hooks__common
+    hooks_budget_governor --> hooks__cost_ledger
+    plugins_viz_graph_builder --> plugins_viz_ast_parser
+    plugins_viz_graph_builder --> plugins_viz_regex_parser
+```
+````
+
+### `/OMG:arch stats` output
+
+```
+============================================================
+  OMG Architecture — Graph Statistics
+============================================================
+
+  Modules:        42
+  Edges:          87
+  Max depth:      6
+  Circular deps:  1
+  Coupling score: 2.07
+
+  Circular dependency cycles:
+    hooks._common → hooks.query → hooks._common
+
+============================================================
+```
+
+### `/OMG:arch --native` accuracy comparison
+
+| Method | Accuracy | Requires |
+|--------|----------|----------|
+| Regex (default) | ~70% | No external tools |
+| Native toolchain | ~95% | `go`, `tsc`, or `cargo` on PATH |
+
+## Supported Languages
+
+| Language | Extensions | Default Parser | Native Parser |
+|----------|-----------|----------------|---------------|
+| Python | `.py` | AST (`ast` stdlib) | — |
+| JavaScript/TypeScript | `.js`, `.jsx`, `.ts`, `.tsx`, `.mjs`, `.cjs` | Regex | `tsc --listFiles` |
+| Go | `.go` | Regex | `go list -json` |
+| Rust | `.rs` (via Cargo) | — | `cargo metadata` |
+
+## Safety
+
+- **Read-only**: All sub-commands only read source files and query external APIs (mermaid.ink for PNG render)
+- **Feature-gated**: Requires `CODEBASE_VIZ` flag enabled
+- **No mutations**: Never modifies source code, dependencies, or project configuration
+- **Crash-isolated**: All operations return empty/false on failure (never raise to caller)
+- **Cache**: Graph cached to `.omg/state/dependency-graph.json` with mtime-based incremental updates
+- **Network**: `/arch render` requires internet access for mermaid.ink API
+- **Subprocess safety**: Native parsers use argv lists (never `shell=True`) with 30s timeout
+
+## API
+
+```python
+from plugins.viz.graph_builder import build_project_graph
+from plugins.viz.diagram_generator import generate_mermaid, generate_d2, render_to_png
+from plugins.viz.native_parsers import (
+    parse_go_native,
+    parse_typescript_native,
+    parse_rust_native,
+    is_toolchain_available,
+)
+
+# Build full dependency graph (regex + AST)
+result = build_project_graph(".")
+# result = {"graph": {...}, "metrics": {...}}
+
+# Generate Mermaid diagram text
+mermaid_text = generate_mermaid(result["graph"])
+
+# Generate Mermaid for a single module (zoomed)
+zoomed = generate_mermaid(result["graph"], zoom="plugins.viz.graph_builder")
+
+# Generate D2 diagram text
+d2_text = generate_d2(result["graph"])
+
+# Render Mermaid to PNG via mermaid.ink
+success = render_to_png(mermaid_text, ".omg/state/arch-diagram.png")
+
+# Native toolchain parsing (higher accuracy)
+go_deps = parse_go_native(".")
+ts_deps = parse_typescript_native(".")
+rs_deps = parse_rust_native(".")
+```

package/build/lib/commands/OMG:ccg.md

@@ -0,0 +1,22 @@
+---
+description: OMG CCG mode (tri-track synthesis) in standalone mode.
+allowed-tools: Read, Grep, Glob, Bash(python3:*), Bash(git:*), Bash(rg:*), Bash(find:*), Bash(cat:*)
+argument-hint: "problem statement"
+---
+
+# /OMG:ccg — Standalone CCG
+
+Runs OMG internal tri-track routing and returns merged actions.
+
+CCG execution standard:
+- launch backend/frontend/architecture analysis in parallel sub-agents
+- collect all tracks with `background_output`
+- run `sequential-thinking` to merge tracks into one execution order
+
+```bash
+OMG_CLI="${OMG_CLI_PATH:-$HOME/.claude/omg-runtime/scripts/omg.py}"
+if [ ! -f "$OMG_CLI" ] && [ -f "scripts/omg.py" ]; then OMG_CLI="scripts/omg.py"; fi
+python3 "$OMG_CLI" ccg --problem "[problem]"
+```
+
+Use this when backend+frontend+architecture are coupled.

package/build/lib/commands/OMG:compat.md

@@ -0,0 +1,57 @@
+---
+description: Run legacy skill names on OMG standalone via compatibility dispatcher.
+allowed-tools: Read, Grep, Glob, Bash(python3:*), Bash(rg:*), Bash(find:*), Bash(cat:*)
+argument-hint: "<skill-name> [optional problem]"
+---
+
+# /OMG:compat
+
+Use this when migrating legacy workflows to OMG standalone.
+
+```bash
+OMG_CLI="${OMG_CLI_PATH:-$HOME/.claude/omg-runtime/scripts/omg.py}"
+if [ ! -f "$OMG_CLI" ] && [ -f "scripts/omg.py" ]; then OMG_CLI="scripts/omg.py"; fi
+```
+
+## List supported skills
+
+```bash
+python3 "$OMG_CLI" compat list
+```
+
+## Inspect contracts
+
+```bash
+python3 "$OMG_CLI" compat contract --all
+python3 "$OMG_CLI" compat contract --skill omg-teams
+python3 "$OMG_CLI" compat snapshot --output runtime/omg_compat_contract_snapshot.json
+python3 scripts/check-omg-compat-contract-snapshot.py --strict-version
+python3 scripts/check-omg-standalone-clean.py
+```
+
+## Generate compatibility gap report
+
+```bash
+python3 "$OMG_CLI" compat gap-report
+```
+
+## Enforce GA gate (CI/local)
+
+```bash
+python3 "$OMG_CLI" compat gate --max-bridge 0
+python3 "$OMG_CLI" compat gate --max-bridge 0 --output .omg/evidence/omg-compat-gap.json
+```
+
+## Run a legacy skill
+
+```bash
+python3 "$OMG_CLI" compat run --skill "<skill-name>" --problem "$ARGUMENTS"
+```
+
+Examples:
+
+```bash
+python3 "$OMG_CLI" compat run --skill omg-teams --problem "review auth flow"
+python3 "$OMG_CLI" compat run --skill plan --problem "ship secure release"
+python3 "$OMG_CLI" compat run --skill pipeline --problem "train model"
+```

package/build/lib/commands/OMG:cost.md

@@ -0,0 +1,181 @@
+---
+description: "Display session cost tracking, budget status, and usage history."
+allowed-tools: Read, Bash(python*:*), Grep
+argument-hint: "[history|budget|reset]"
+---
+
+# /OMG:cost — Cost Tracker
+
+Display session cost tracking, budget status, and usage history.
+
+## Usage
+
+```
+/OMG:cost
+/OMG:cost history
+/OMG:cost budget
+/OMG:cost reset
+```
+
+## Sub-Commands
+
+### `/OMG:cost` (default)
+
+Show current session cost summary: total tokens, total USD spent, and remaining budget percentage.
+
+```python
+from hooks._cost_ledger import read_cost_summary
+summary = read_cost_summary(".")
+print(f"Total tokens: {summary['total_tokens']}")
+print(f"Total cost: ${summary['total_cost_usd']:.4f}")
+print(f"Entries: {summary['entry_count']}")
+```
+
+### `/OMG:cost history`
+
+Show cost breakdown by tool and by session. Lists top consumers and per-session aggregates.
+
+```python
+from hooks._cost_ledger import read_cost_summary
+summary = read_cost_summary(".")
+
+# By tool
+for tool, stats in sorted(summary["by_tool"].items(), key=lambda x: x[1]["cost_usd"], reverse=True):
+    print(f"  {tool}: {stats['count']} calls, {stats['tokens']} tokens, ${stats['cost_usd']:.4f}")
+
+# By session
+for sid, stats in summary["by_session"].items():
+    print(f"  {sid}: {stats['count']} calls, ${stats['cost_usd']:.4f}")
+```
+
+### `/OMG:cost budget`
+
+Show budget configuration and threshold status. Reads from `_omg.cost_budget` in `settings.json`.
+
+Displays:
+- Session budget limit (USD)
+- Current spend vs limit
+- Remaining budget percentage
+- Threshold levels and which have been triggered
+
+```python
+import json
+with open("settings.json") as f:
+    config = json.load(f)
+budget = config.get("_omg", {}).get("cost_budget", {})
+print(f"Session limit: ${budget.get('session_limit_usd', 5.0):.2f}")
+print(f"Thresholds: {budget.get('thresholds', [50, 80, 95])}")
+print(f"Pricing: ${budget.get('pricing', {}).get('input_per_mtok', 3.0)}/Mtok in, ${budget.get('pricing', {}).get('output_per_mtok', 15.0)}/Mtok out")
+```
+
+### `/OMG:cost reset`
+
+Clear the cost ledger and threshold state for a fresh start.
+
+Removes:
+- `.omg/state/ledger/cost-ledger.jsonl`
+- `.omg/state/.cost-threshold-state.json`
+
+## Feature Flag
+
+- **Flag name**: `OMG_COST_TRACKING_ENABLED`
+- **Default**: `False` (disabled)
+- **Enable**: `export OMG_COST_TRACKING_ENABLED=1`
+
+Or set in `settings.json`:
+
+```json
+{
+  "_omg": {
+    "features": {
+      "COST_TRACKING": true
+    }
+  }
+}
+```
+
+## Budget Configuration
+
+Configure in `settings.json` under `_omg.cost_budget`:
+
+```json
+{
+  "_omg": {
+    "cost_budget": {
+      "session_limit_usd": 5.0,
+      "thresholds": [50, 80, 95],
+      "pricing": {
+        "input_per_mtok": 3.0,
+        "output_per_mtok": 15.0
+      }
+    }
+  }
+}
+```
+
+| Setting | Default | Description |
+|---------|---------|-------------|
+| `session_limit_usd` | `5.0` | Maximum spend per session in USD |
+| `thresholds` | `[50, 80, 95]` | Budget percentage thresholds for alerts |
+| `pricing.input_per_mtok` | `3.0` | Cost per million input tokens |
+| `pricing.output_per_mtok` | `15.0` | Cost per million output tokens |
+
+## Output Example
+
+```
+============================================================
+  OMG Cost Tracker — Session Summary
+============================================================
+
+  Total tokens:     124,350
+  Total cost:       $0.4821
+  Budget remaining: 90.4% ($4.52 of $5.00)
+  Tool calls:       47
+
+  Top consumers:
+    Bash:           23 calls, 68,200 tokens, $0.2644
+    Read:           12 calls, 34,100 tokens, $0.1322
+    Write:           8 calls, 15,050 tokens, $0.0583
+    Edit:            4 calls,  7,000 tokens, $0.0272
+
+============================================================
+```
+
+## Hook Integration
+
+The `budget_governor.py` PostToolUse hook automatically tracks costs when `COST_TRACKING` is enabled. It:
+
+1. Estimates token usage for each tool call (Tier 2 calibrated model)
+2. Appends cost entries to `.omg/state/ledger/cost-ledger.jsonl`
+3. Injects budget status into Claude's context via `additionalContext`
+4. Fires threshold alerts at 50%, 80%, and 95% budget usage
+
+## Safety
+
+- **Read-only** (default): `/cost`, `/cost history`, `/cost budget` only read data
+- **Feature-gated**: Hook and command require `COST_TRACKING` flag enabled
+- **Advisory-only**: Budget governor never blocks tool execution
+- **Crash-isolated**: All operations exit 0 on failure
+
+## API
+
+```python
+from hooks._cost_ledger import read_cost_summary, append_cost_entry, rotate_cost_ledger
+
+# Get aggregated cost summary
+summary = read_cost_summary(".")
+
+# Append a cost entry
+append_cost_entry(".", {
+    "ts": "2026-03-04T12:00:00Z",
+    "tool": "Bash",
+    "tokens_in": 500,
+    "tokens_out": 200,
+    "cost_usd": 0.0045,
+    "model": "claude-opus-4-6",
+    "session_id": "ses_abc123"
+})
+
+# Rotate ledger when > 5MB
+rotate_cost_ledger(".")
+```

package/build/lib/commands/OMG:crazy.md

@@ -0,0 +1,125 @@
+---
+description: "CRAZY mode — maximum multi-agent orchestration. Claude orchestrates, Codex deep-codes, Gemini designs. Anti-hallucination + error-loop prevention."
+allowed-tools: Read, Write, Edit, MultiEdit, Bash, Grep, Glob, Task
+argument-hint: "[task description]"
+---
+
+# /OMG:crazy — All-Agent Maximum Orchestration
+
+## Phase 1: Intent Classification (BEFORE acting)
+
+STOP. Before doing ANYTHING, say out loud:
+"I understand you want me to [INTENT]: [specific goal]."
+
+| Signal | Intent | Action |
+|--------|--------|--------|
+| fix/bug/error | **FIX** | Debug → patch source → verify |
+| build/create/add | **IMPLEMENT** | Plan → code → test |
+| refactor/clean | **REFACTOR** | Preserve behavior, verify before+after |
+| review/check | **REVIEW** | Read ALL → report → don't change |
+
+If the user hasn't confirmed, ASK. Don't assume.
+
+## Phase 1.5: Brainstorm Merge (AUTOMATIC)
+
+CRAZY mode now includes brainstorming by default. Do not run a separate brainstorm command.
+
+- Generate 2-3 viable approaches quickly
+- Compare trade-offs (risk, effort, reversibility)
+- Pick one approach and proceed immediately
+
+## Phase 2: Agent Dispatch (Parallel Sub-Agent Required)
+
+CRAZY mode must use parallel sub-agent dispatch for worker tracks.
+
+### Mandatory parallel launch pattern
+
+```python
+task(subagent_type="explore", run_in_background=true, load_skills=[], description="Architect track", prompt="...")
+task(subagent_type="explore", run_in_background=true, load_skills=[], description="Backend track", prompt="...")
+task(subagent_type="explore", run_in_background=true, load_skills=[], description="Frontend track", prompt="...")
+task(subagent_type="explore", run_in_background=true, load_skills=[], description="Security track", prompt="...")
+task(subagent_type="explore", run_in_background=true, load_skills=[], description="Verification track", prompt="...")
+```
+
+Then:
+- collect each task with `background_output(task_id="...")`
+- run a `sequential-thinking` synthesis pass to merge contradictions and produce one dependency-ordered checklist
+- only then start implementation
+
+### Claude (You — Orchestrator)
+- Break task into parallel subtasks
+- Delegate to specialists
+- Synthesize results
+- Make architecture decisions
+- Run a sequential-thinking merge before implementation
+
+### Codex — Deep Worker + Code Reviewer
+**Codex=deep-code: backend logic, security, debugging, algorithms, performance, root cause analysis**
+Use for: complex multi-file changes, security audits, root cause analysis, backend architecture
+```
+/OMG:escalate codex "
+Task: [specific implementation task]
+Context: [file paths, patterns to follow]
+Verify: [how to confirm correctness]
+"
+```
+
+### Mandatory Post-Plan Codex Validation
+After any planning step inside CRAZY mode, run a Codex validation pass before implementation:
+
+```bash
+/OMG:escalate codex "Validate this plan for gaps, ordering risks, hidden edge cases, and missing verification. Return only actionable corrections."
+```
+
+### Gemini — UI/UX + Visual Design
+**Gemini=UI/UX: frontend, visual, accessibility, responsive design, CSS, component styling**
+Use for: frontend components, styling, visual review, accessibility, responsive layouts
+```
+/OMG:escalate gemini "
+Task: [UI/design task]
+Context: [component paths, design system]
+"
+```
+
+## Phase 3: Anti-Hallucination Protocol
+
+After EVERY implementation step:
+1. **Run it** — show build/test output with exit code
+2. **Never claim "looks correct"** — evidence or it didn't happen
+3. **Never edit tests to match bugs** — fix the SOURCE code
+4. **Never change only configs/scripts** — verify source files changed
+
+## Phase 4: Error Loop Prevention
+
+```
+IF same_error >= 3:
+    STOP. Do not retry.
+    OPTIONS:
+    1. /OMG:escalate codex "debug: [error] in [file]"
+    2. Completely different approach
+    3. Ask user for guidance
+    NEVER retry the same thing a 4th time.
+```
+
+## Phase 5: Completion Gate
+
+Don't stop until ALL verified:
+- [ ] Changes compile/build (exit 0)
+- [ ] Tests pass (exit 0)
+- [ ] Security check on auth/payment/database code
+- [ ] No TODO/FIXME left in new code
+- [ ] Diff is surgical (minimal, no unnecessary changes)
+
+## Phase 6: Report
+```
+CRAZY Mode — Complete
+━━━━━━━━━━━━━━━━━━━━
+Intent: [what was requested]
+Result: [what was delivered]
+Claude: [orchestration decisions]
+Codex: [deep work done]
+Gemini: [visual work done]
+Verified: [build ✅ | test ✅ | lint ✅]
+Files: [N files, M lines changed]
+```