@trac3er/oh-my-god 2.0.4 → 2.0.7

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

@@ -0,0 +1,225 @@
+---
+description: "Display session analytics, tool usage trends, file heatmaps, and failure patterns."
+allowed-tools: Read, Bash(python*:*), Grep
+argument-hint: "[weekly|files|failures|dashboard]"
+---
+
+# /OMG:stats — Session Analytics
+
+Display session analytics, tool usage trends, file heatmaps, and failure patterns.
+
+## Usage
+
+```
+/OMG:stats
+/OMG:stats weekly
+/OMG:stats files
+/OMG:stats failures
+/OMG:stats dashboard
+```
+
+## Sub-Commands
+
+### `/OMG:stats` (default)
+
+Show current session summary: duration, tool calls, success rate, cost, and test runs.
+
+```python
+from hooks.query import get_session_summary
+
+summary = get_session_summary(".")
+duration_m = summary["duration"] // 60
+duration_s = summary["duration"] % 60
+print(f"Duration:       {duration_m}m {duration_s}s")
+print(f"Tool calls:     {summary['tool_calls']}")
+print(f"Success rate:   {summary['success_rate']:.1%}")
+print(f"Files modified: {summary['files_modified']}")
+print(f"Tests run:      {summary['tests_run']}")
+print(f"Tokens used:    {summary['tokens_used']:,}")
+print(f"Cost:           ${summary['cost_usd']:.4f}")
+```
+
+### `/OMG:stats weekly`
+
+Show last 7 days trend analysis by aggregating tool stats and escalation effectiveness.
+
+```python
+from hooks.query import get_tool_stats, get_escalation_effectiveness
+
+tools = get_tool_stats(".")
+escalations = get_escalation_effectiveness(".")
+
+# Per-tool breakdown
+for tool, stats in sorted(tools.items(), key=lambda x: x[1]["count"], reverse=True):
+    print(f"  {tool}: {stats['count']} calls, {stats['success_rate']:.0%} success, {stats['avg_tokens']:.0f} avg tokens")
+
+# Escalation summary
+print(f"\nEscalations: {escalations['escalations']} total, {escalations['resolved']} resolved, {escalations['unresolved']} unresolved")
+```
+
+### `/OMG:stats files`
+
+Show file-level heatmap of the most read, written, and edited files.
+
+```python
+from hooks.query import get_file_heatmap
+
+heatmap = get_file_heatmap(".")
+
+# Sort by total interactions (reads + writes + edits)
+ranked = sorted(
+    heatmap.items(),
+    key=lambda x: x[1]["reads"] + x[1]["writes"] + x[1]["edits"],
+    reverse=True,
+)
+
+print(f"{'File':<50} {'Reads':>6} {'Writes':>7} {'Edits':>6}")
+print("-" * 73)
+for path, counts in ranked[:20]:
+    total = counts["reads"] + counts["writes"] + counts["edits"]
+    print(f"{path:<50} {counts['reads']:>6} {counts['writes']:>7} {counts['edits']:>6}")
+```
+
+### `/OMG:stats failures`
+
+Show top failure patterns and their resolution status.
+
+```python
+from hooks.query import get_failure_hotspots, get_escalation_effectiveness
+
+hotspots = get_failure_hotspots(".")
+escalations = get_escalation_effectiveness(".")
+
+for pattern, details in sorted(hotspots.items(), key=lambda x: x[1]["count"], reverse=True):
+    status = "ESCALATED" if details["escalated"] else "active"
+    print(f"  [{status}] {pattern}: {details['count']} failures")
+    for err in details["last_3_errors"]:
+        print(f"    - {err[:100]}")
+
+print(f"\nResolution: {escalations['resolved']}/{escalations['escalations']} escalations resolved")
+```
+
+### `/OMG:stats dashboard`
+
+Generate a self-contained HTML dashboard at `.omg/state/dashboard.html`.
+
+The dashboard includes:
+- Session summary cards (duration, tool calls, cost, success rate)
+- Tool usage bar chart (via CDN Chart.js)
+- File heatmap table (top 20 files by interaction count)
+- Failure pattern list with escalation status
+
+```python
+import json
+import os
+from hooks.query import (
+    get_session_summary,
+    get_tool_stats,
+    get_file_heatmap,
+    get_failure_hotspots,
+)
+
+summary = get_session_summary(".")
+tools = get_tool_stats(".")
+heatmap = get_file_heatmap(".")
+failures = get_failure_hotspots(".")
+
+dashboard_data = {
+    "summary": summary,
+    "tools": tools,
+    "heatmap": dict(sorted(
+        heatmap.items(),
+        key=lambda x: x[1]["reads"] + x[1]["writes"] + x[1]["edits"],
+        reverse=True,
+    )[:20]),
+    "failures": failures,
+}
+
+# Write self-contained HTML with embedded Chart.js
+output_path = os.path.join(".omg", "state", "dashboard.html")
+os.makedirs(os.path.dirname(output_path), exist_ok=True)
+# ... (HTML template with CDN Chart.js and embedded JSON data)
+print(f"Dashboard written to {output_path}")
+```
+
+## Feature Flag
+
+- **Flag name**: `OMG_SESSION_ANALYTICS_ENABLED`
+- **Default**: `False` (disabled)
+- **Enable**: `export OMG_SESSION_ANALYTICS_ENABLED=1`
+
+Or set in `settings.json`:
+
+```json
+{
+  "_omg": {
+    "features": {
+      "SESSION_ANALYTICS": true
+    }
+  }
+}
+```
+
+## Output Example
+
+```
+============================================================
+  OMG Session Analytics — Summary
+============================================================
+
+  Duration:       23m 47s
+  Tool calls:     142
+  Success rate:   94.4%
+  Files modified: 18
+  Tests run:      6
+  Tokens used:    287,450
+  Cost:           $1.1142
+
+  Top Tools:
+    Bash:           58 calls, 95% success, 1,240 avg tokens
+    Read:           34 calls, 100% success, 890 avg tokens
+    Edit:           22 calls, 91% success, 1,100 avg tokens
+    Write:          16 calls, 100% success, 950 avg tokens
+    Grep:           12 calls, 100% success, 320 avg tokens
+
+  Failure Hotspots:
+    [ESCALATED] hooks/budget_governor.py: 4 failures
+    [active] tests/test_integration.py: 2 failures
+
+  Escalations: 1 total, 0 resolved, 1 unresolved
+
+============================================================
+```
+
+## Safety
+
+- **Read-only**: All sub-commands only read from existing ledger/tracker files
+- **Feature-gated**: Requires `SESSION_ANALYTICS` flag enabled
+- **No mutations**: Never modifies ledger data, failure tracker, or working memory
+- **Crash-isolated**: All query operations exit 0 on failure (via query.py internals)
+- **Dashboard**: Writes only to `.omg/state/dashboard.html` (inside managed state directory)
+
+## API
+
+```python
+from hooks.query import (
+    get_session_summary,
+    get_tool_stats,
+    get_failure_hotspots,
+    get_escalation_effectiveness,
+    get_file_heatmap,
+)
+
+# Current session summary
+summary = get_session_summary(".")
+
+# Per-tool statistics
+tools = get_tool_stats(".")
+
+# Failure patterns and escalation status
+failures = get_failure_hotspots(".")
+escalations = get_escalation_effectiveness(".")
+
+# File interaction heatmap
+heatmap = get_file_heatmap(".")
+```

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

@@ -0,0 +1,39 @@
+---
+description: OMG internal team routing (standalone). Standalone team routing.
+allowed-tools: Read, Grep, Glob, Bash(git:*), Bash(rg:*), Bash(find:*), Bash(cat:*), Bash(python3:*)
+argument-hint: "[codex|gemini|ccg|auto] 'problem statement'"
+---
+
+# /OMG:teams — Standalone Internal Router
+
+Use OMG's internal router using internal routing.
+
+## Input contract
+- target: `auto|codex|gemini|ccg`
+- problem: clear issue statement
+- context: optional constraints
+- files: optional focus paths
+- expected_outcome: optional acceptance target
+
+## Execution
+Use internal CLI router:
+
+```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" teams --target auto --problem "[problem]"
+```
+
+For explicit target:
+
+```bash
+python3 "$OMG_CLI" teams --target codex --problem "[problem]"
+```
+
+## Output schema
+`TeamDispatchResult { status, findings[], actions[], evidence{} }`
+
+## Full-power sub-agent protocol
+- For non-trivial tasks, launch multiple sub-agents in parallel (`run_in_background=true`) for independent tracks.
+- Collect all task outputs before responding (`background_output` per task id).
+- Run a `sequential-thinking` merge step to produce one dependency-ordered execution plan.

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

@@ -0,0 +1,44 @@
+---
+description: "Interactive theme selection, preview, and auto-detection."
+usage: "/OMG:theme [--list|--set <name>|--preview <name>|--auto]"
+---
+
+# /OMG:theme — Theme Selector
+
+Interactive theme selection, preview, and auto-detection for OMG.
+
+## Usage
+
+```
+/OMG:theme --list
+/OMG:theme --preview catppuccin-mocha
+/OMG:theme --set catppuccin-mocha
+/OMG:theme --auto
+```
+
+## What It Does
+
+1. `--list`: Returns a sorted list of available theme names.
+2. `--preview <name>`: Returns preview info `{name, colors, ansi_preview: str}` without applying.
+3. `--set <name>`: Applies and persists the theme, returns `{success, theme, applied_at}`.
+4. `--auto`: Detects dark/light mode and returns appropriate default theme name.
+
+## Feature Flag
+
+Themes are gated behind `OMG_THEMES_ENABLED` (default: `False`).
+
+Enable via environment variable:
+```bash
+export OMG_THEMES_ENABLED=true
+```
+
+Or in `settings.json`:
+```json
+{
+  "_omg": {
+    "features": {
+      "THEMES": true
+    }
+  }
+}
+```

package/build/lib/commands/__init__.py

@@ -0,0 +1 @@
+"""OMG command package marker for packaging parity."""

package/build/lib/control_plane/__init__.py

@@ -0,0 +1,2 @@
+"""Control plane package for OMG v1."""
+

package/build/lib/control_plane/openapi.yaml

@@ -0,0 +1,260 @@
+openapi: 3.1.0
+info:
+  title: OMG Control Plane API
+  version: 2.0.7
+  description: Policy/trust/evidence/runtime/registry/lab endpoints for OMG v2, with deprecated v1 aliases for one release.
+servers:
+  - url: https://api.omg.local
+paths:
+  /v2/policy/evaluate:
+    post:
+      summary: Evaluate policy decision
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PolicyInput'
+      responses:
+        '200':
+          description: Decision result
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/PolicyDecision'
+  /v1/policy/evaluate:
+    post:
+      deprecated: true
+      summary: Deprecated alias of /v2/policy/evaluate
+      responses:
+        '200':
+          description: Decision result
+  /v2/trust/review:
+    post:
+      summary: Review trust-sensitive config changes
+      responses:
+        '200':
+          description: Trust review report
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/TrustReview'
+  /v1/trust/review:
+    post:
+      deprecated: true
+      summary: Deprecated alias of /v2/trust/review
+      responses:
+        '200':
+          description: Trust review report
+  /v2/evidence/ingest:
+    post:
+      summary: Ingest evidence pack
+      responses:
+        '202':
+          description: Accepted
+  /v1/evidence/ingest:
+    post:
+      deprecated: true
+      summary: Deprecated alias of /v2/evidence/ingest
+      responses:
+        '202':
+          description: Accepted
+  /v2/security/check:
+    post:
+      summary: Run canonical OMG security check
+      requestBody:
+        required: false
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/SecurityCheckInput'
+      responses:
+        '200':
+          description: Security check result
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SecurityCheckResult'
+  /v1/security/check:
+    post:
+      deprecated: true
+      summary: Deprecated alias of /v2/security/check
+      responses:
+        '200':
+          description: Security check result
+  /v2/guide/assert:
+    post:
+      summary: Assert output against explicit project rules
+      responses:
+        '200':
+          description: Guide assertion result
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/GuideAssertionResult'
+  /v1/guide/assert:
+    post:
+      deprecated: true
+      summary: Deprecated alias of /v2/guide/assert
+      responses:
+        '200':
+          description: Guide assertion result
+  /v2/runtime/dispatch:
+    post:
+      summary: Dispatch job to runtime adapter
+      responses:
+        '200':
+          description: Runtime dispatch result
+  /v1/runtime/dispatch:
+    post:
+      deprecated: true
+      summary: Deprecated alias of /v2/runtime/dispatch
+      responses:
+        '200':
+          description: Runtime dispatch result
+  /v2/registry/verify:
+    post:
+      summary: Verify supply-chain artifact
+      responses:
+        '200':
+          description: Verification decision
+  /v1/registry/verify:
+    post:
+      deprecated: true
+      summary: Deprecated alias of /v2/registry/verify
+      responses:
+        '200':
+          description: Verification decision
+  /v2/lab/jobs:
+    post:
+      summary: Create lab pipeline job
+      responses:
+        '201':
+          description: Created
+  /v1/lab/jobs:
+    post:
+      deprecated: true
+      summary: Deprecated alias of /v2/lab/jobs
+      responses:
+        '201':
+          description: Created
+  /v2/scoreboard/baseline:
+    get:
+      summary: Return baseline scorecard
+      responses:
+        '200':
+          description: KPI baseline snapshot
+  /v1/scoreboard/baseline:
+    get:
+      deprecated: true
+      summary: Deprecated alias of /v2/scoreboard/baseline
+      responses:
+        '200':
+          description: KPI baseline snapshot
+components:
+  schemas:
+    PolicyInput:
+      type: object
+      properties:
+        tool:
+          type: string
+        input:
+          type: object
+      additionalProperties: true
+    PolicyDecision:
+      type: object
+      required: [action, risk_level, reason, controls]
+      properties:
+        action:
+          type: string
+          enum: [allow, ask, deny]
+        risk_level:
+          type: string
+          enum: [low, med, high, critical]
+        reason:
+          type: string
+        controls:
+          type: array
+          items:
+            type: string
+    TrustReview:
+      type: object
+      required: [changed_files, mcp_changes, hook_changes, env_changes, risk_score, verdict]
+      properties:
+        changed_files:
+          type: array
+          items: { type: string }
+        mcp_changes:
+          type: array
+          items: { type: object }
+        hook_changes:
+          type: object
+        env_changes:
+          type: array
+          items: { type: object }
+        risk_score:
+          type: integer
+        verdict:
+          type: string
+    SecurityCheckInput:
+      type: object
+      properties:
+        scope:
+          type: string
+          default: "."
+          description: Directory scope to scan
+        include_live_enrichment:
+          type: boolean
+          default: false
+          description: Whether to include live enrichment data
+        external_inputs:
+          type: array
+          nullable: true
+          items:
+            type: object
+          description: External input sources to include in provenance
+        waivers:
+          type: array
+          nullable: true
+          items:
+            oneOf:
+              - type: string
+              - type: object
+          description: Finding identifiers or waiver objects to suppress matched findings
+      additionalProperties: false
+    SecurityCheckResult:
+      type: object
+      required: [schema, status, scope, findings, summary, provenance, trust_scores]
+      properties:
+        schema:
+          type: string
+        status:
+          type: string
+        scope:
+          type: string
+        findings:
+          type: array
+          items:
+            type: object
+        summary:
+          type: object
+        provenance:
+          type: array
+          items:
+            type: object
+        trust_scores:
+          type: object
+    GuideAssertionResult:
+      type: object
+      required: [schema, verdict, violations, summary]
+      properties:
+        schema:
+          type: string
+        verdict:
+          type: string
+        violations:
+          type: array
+          items:
+            type: object
+        summary:
+          type: object