@trac3er/oh-my-god 2.0.4 → 2.0.7

package/plugins/advanced/commands/OMG:deep-plan.md

@@ -10,6 +10,8 @@ argument-hint: "[feature or goal to plan]"
 Regular planning = "what steps to take."
 Deep planning = "understand WHY the user wants this, WHAT direction they're heading, and HOW it fits the bigger picture."
 
+This command is the compatibility front door to the canonical `plan-council` bundle.
+
 ## Step 1: Direction Discovery (MANDATORY)
 
 Do not assume goals, constraints, or context. Extract direction from:
@@ -54,10 +56,12 @@ If DDD reference patterns exist (see .omg/knowledge/ or existing domain modules)
 - Plan the new feature to MATCH the pattern
 - Note any intentional deviations with WHY
 
-## Step 3: Create the Deep Plan
+## Step 3: Create the Deep Plan (Plan Council Artifacts)
 
-Use Bash heredoc to write `.omg/state/_plan.md` (and `.omg/idea.yml`). Do NOT use the `Write` tool — it requires a prior Read which is unnecessary for fresh plan creation:
+Generate the canonical `plan-council` artifacts. Use Bash heredoc to write these files.
+Required artifacts: `.omg/plans/deep-plan.md`, `.omg/plans/deep-plan.json`, `.omg/plans/dissent.json`, `.omg/evidence/plan-council.json`.
 
+### Artifact 1: `.omg/plans/deep-plan.md` (Human-readable)
 ```markdown
 # Deep Plan: [Feature Name]
 Created: [date]
@@ -85,9 +89,9 @@ Key interfaces: [list the interfaces/types this touches]
 3. [ ] [specific action]
 4. [ ] [specific action]
 
-### Phase 3: Integration + Security [N files, ~M lines]
+### Phase 3: Integration + Verification [N files, ~M lines]
 5. [ ] [specific action]
-6. [ ] Security review: /OMG:security-check [affected files]
+6. [ ] Verification: /OMG:security-check [affected files]
 
 ### Phase 4: Verification
 7. [ ] Tests: [what to test, how]
@@ -105,8 +109,48 @@ Key interfaces: [list the interfaces/types this touches]
 ## Files to Read Before Starting
 1. [file] — [why: contains the reference pattern]
 2. [file] — [why: defines the interface this must implement]
+
+## Plan Council Requirements
+### Assumptions
+List your assumptions below:
+- [Assumption 1]
+- [Assumption 2]
+
+### Objections and Dissent
+Record any objections or dissent:
+- [Dissent 1]
+- [Dissent 2]
+
+### Rollback Plan
+Define the rollback plan:
+- [Step 1 to revert]
+- [Step 2 to revert]
+
+### Verification Commands
+List the verification commands:
+- [Command 1]
+- [Command 2]
+
+### Evidence Requirements
+Define the evidence requirements:
+- [Requirement 1]
+- [Requirement 2]
+
+### What would falsify this plan?
+Define what would falsify this plan:
+- [Condition 1]
+- [Condition 2]
 ```
 
+### Artifact 2: `.omg/plans/deep-plan.json` (Machine-readable)
+Include the full task plan, workflow stages, and metadata.
+
+### Artifact 3: `.omg/plans/dissent.json` (Dissent log)
+Record all objections, risks, and counter-arguments raised during planning.
+
+### Artifact 4: `.omg/evidence/plan-council.json` (Planning evidence)
+Record the planning process evidence, including tool outputs and validation results.
+
 ## Step 4: Present and Iterate
 
 Show the plan to the user. Ask:
@@ -191,8 +235,8 @@ Rules:
    - `production=ready` only when QA/simulation/final_test gates pass.
 
 Persist this contract into planning artifacts:
-- `.omg/state/_plan.md` (human-readable plan)
-- `.omg/state/_checklist.md` (atomic execution items)
+- `.omg/plans/deep-plan.md` (human-readable plan)
+- `.omg/plans/deep-plan.json` (machine-readable plan)
 - include structured task metadata in the plan output (`stage`, `title`, `detail`, `source`).
 
 ## Integration with DDD

package/plugins/advanced/commands/OMG:ship.md

@@ -13,7 +13,7 @@ argument-hint: "[goal or optional path to .omg/idea.yml]"
 
 ## Step 2: Convert idea to execution plan
 - Consume plan artifacts generated by `/OMG:deep-plan`.
-- Require `.omg/state/_plan.md` and `.omg/state/_checklist.md` to already encode the business workflow contract.
+- Require `.omg/plans/deep-plan.md` and `.omg/plans/deep-plan.json` to already encode the business workflow contract.
 - If missing, invoke `/OMG:deep-plan` first and return after those artifacts are created.
 - Use the deep-plan workflow path and task metadata as the execution source of truth.
 

package/plugins/advanced/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "omg-advanced",
-  "version": "1.0.5",
+  "version": "2.0.7",
   "description": "Advanced OMG commands - deep planning, learning, code review, and specialized workflows",
   "type": "omg-plugin",
   "commands": {
@@ -48,11 +48,6 @@
       "path": "commands/OMG:ralph-stop.md",
       "description": "Stop Ralph autonomous loop",
       "category": "automation"
-    },
-    "theme": {
-      "path": "commands/OMG:theme.md",
-      "description": "Interactive theme selector with list, preview, set, and auto modes",
-      "category": "config"
     }
   },
   "categories": {
@@ -87,10 +82,6 @@
     "oss": {
       "description": "Open source maintainer tools",
       "commands": ["maintainer"]
-    },
-    "config": {
-      "description": "Configuration and settings",
-      "commands": ["theme"]
     }
   }
 }

package/plugins/core/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "omg-core",
-  "version": "2.0.4",
+  "version": "2.0.7",
   "description": "Core OMG commands - native setup, routing, orchestration, and verification surfaces",
   "type": "omg-plugin",
   "commands": {
@@ -135,5 +135,11 @@
       "description": "Codebase visualization and architecture diagrams",
       "commands": ["arch"]
     }
+  },
+  "roles": {
+    "plan-council": {
+      "description": "Canonical council-style planning role",
+      "bundle": "plan-council"
+    }
   }
 }

package/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "oh-my-god"
-version = "2.0.4"
-description = "OMG (Oh My God) — Multi-agent orchestration, intelligent model routing, and durable session state for Claude Code"
+version = "2.0.7"
+description = "OMG (Oh My God) — Multi-agent orchestration, evidence-backed verification, and durable session state for Claude Code, Codex, and supported agent hosts"
 readme = "README.md"
 requires-python = ">=3.10"
 license = {text = "MIT"}
@@ -42,7 +42,43 @@ Repository = "https://github.com/trac3er00/OMG.git"
 Issues = "https://github.com/trac3er00/OMG/issues"
 
 [tool.setuptools]
-packages = ["hooks", "runtime", "agents", "commands"]
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["agents*", "commands*", "control_plane*", "hooks*", "plugins*", "registry*", "runtime*"]
+
+[tool.setuptools.package-data]
+agents = ["*.md"]
+commands = ["*.md"]
+control_plane = ["*.yaml"]
+plugins = ["**/*.json", "**/*.md"]
+registry = ["*.json", "bundles/*.yaml"]
+runtime = ["*.json"]
+
+[tool.setuptools.data-files]
+"." = ["OMG_COMPAT_CONTRACT.md", "settings.json", ".mcp.json"]
+".claude-plugin" = [".claude-plugin/plugin.json", ".claude-plugin/marketplace.json"]
+"docs" = ["docs/release-checklist.md"]
+".agents/skills/omg" = [".agents/skills/omg/AGENTS.fragment.md", ".agents/skills/omg/codex-mcp.toml"]
+".agents/skills/omg/control-plane" = [".agents/skills/omg/control-plane/SKILL.md", ".agents/skills/omg/control-plane/openai.yaml"]
+".agents/skills/omg/hook-governor" = [".agents/skills/omg/hook-governor/SKILL.md", ".agents/skills/omg/hook-governor/openai.yaml"]
+".agents/skills/omg/lsp-pack" = [".agents/skills/omg/lsp-pack/SKILL.md", ".agents/skills/omg/lsp-pack/openai.yaml"]
+".agents/skills/omg/mcp-fabric" = [".agents/skills/omg/mcp-fabric/SKILL.md", ".agents/skills/omg/mcp-fabric/openai.yaml"]
+".agents/skills/omg/secure-worktree-pipeline" = [".agents/skills/omg/secure-worktree-pipeline/SKILL.md", ".agents/skills/omg/secure-worktree-pipeline/openai.yaml"]
+".agents/skills/omg/security-check" = [".agents/skills/omg/security-check/SKILL.md", ".agents/skills/omg/security-check/openai.yaml"]
+".agents/skills/omg/api-twin" = [".agents/skills/omg/api-twin/SKILL.md", ".agents/skills/omg/api-twin/openai.yaml"]
+".agents/skills/omg/preflight" = [".agents/skills/omg/preflight/SKILL.md", ".agents/skills/omg/preflight/openai.yaml"]
+".agents/skills/omg/robotics" = [".agents/skills/omg/robotics/SKILL.md", ".agents/skills/omg/robotics/openai.yaml"]
+".agents/skills/omg/vision" = [".agents/skills/omg/vision/SKILL.md", ".agents/skills/omg/vision/openai.yaml"]
+".agents/skills/omg/algorithms" = [".agents/skills/omg/algorithms/SKILL.md", ".agents/skills/omg/algorithms/openai.yaml"]
+".agents/skills/omg/health" = [".agents/skills/omg/health/SKILL.md", ".agents/skills/omg/health/openai.yaml"]
+".agents/skills/omg/tracebank" = [".agents/skills/omg/tracebank/SKILL.md", ".agents/skills/omg/tracebank/openai.yaml"]
+".agents/skills/omg/eval-gate" = [".agents/skills/omg/eval-gate/SKILL.md", ".agents/skills/omg/eval-gate/openai.yaml"]
+".agents/skills/omg/delta-classifier" = [".agents/skills/omg/delta-classifier/SKILL.md", ".agents/skills/omg/delta-classifier/openai.yaml"]
+".agents/skills/omg/incident-replay" = [".agents/skills/omg/incident-replay/SKILL.md", ".agents/skills/omg/incident-replay/openai.yaml"]
+".agents/skills/omg/data-lineage" = [".agents/skills/omg/data-lineage/SKILL.md", ".agents/skills/omg/data-lineage/openai.yaml"]
+".agents/skills/omg/remote-supervisor" = [".agents/skills/omg/remote-supervisor/SKILL.md", ".agents/skills/omg/remote-supervisor/openai.yaml"]
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]

package/registry/__init__.py

@@ -0,0 +1 @@
+"""Registry package for OMG."""

package/registry/bundles/algorithms.yaml

@@ -0,0 +1,45 @@
+id: algorithms
+kind: domain-pack
+version: 2.0.7
+title: OMG Algorithms Pack
+description: Determinism and benchmark attachments for algorithm-heavy work.
+hosts:
+  - claude
+  - codex
+assets:
+  references:
+    - runtime/domain_packs.py
+invocation_policy:
+  user_invocable: true
+  model_invocable: true
+  allow_implicit_invocation: false
+tool_policy:
+  side_effect_level: medium
+  allowed_tools:
+    claude:
+      - Read
+    codex:
+      - Read
+lifecycle_hooks:
+  native:
+    - PostToolUse
+  emulated:
+    - TaskCompleted
+mcp_contract:
+  servers:
+    - omg-control
+lsp_contract:
+  languages:
+    - python
+evidence_outputs:
+  artifacts:
+    - .omg/evals/latest.json
+execution_contract:
+  modes:
+    - embedded
+    - local_supervisor
+channel_overrides:
+  public:
+    benchmarks: advisory
+  enterprise:
+    benchmarks: required

package/registry/bundles/api-twin.yaml

@@ -0,0 +1,48 @@
+id: api-twin
+kind: simulation
+version: 2.0.7
+title: OMG API Twin
+description: Versioned endpoint cassette replay with latency, drift, and cost reporting.
+hosts:
+  - claude
+  - codex
+assets:
+  references:
+    - runtime/api_twin.py
+    - commands/OMG:api-twin.md
+invocation_policy:
+  user_invocable: true
+  model_invocable: true
+  allow_implicit_invocation: false
+tool_policy:
+  side_effect_level: medium
+  allowed_tools:
+    claude:
+      - Read
+      - Bash(python3:*)
+    codex:
+      - Read
+      - Bash(python3:*)
+lifecycle_hooks:
+  native:
+    - PostToolUse
+  emulated:
+    - TaskCompleted
+mcp_contract:
+  servers:
+    - omg-control
+lsp_contract:
+  languages:
+    - python
+evidence_outputs:
+  artifacts:
+    - .omg/state/api_twin.json
+execution_contract:
+  modes:
+    - embedded
+    - local_supervisor
+channel_overrides:
+  public:
+    fidelity: validated
+  enterprise:
+    fidelity: policy-required

package/registry/bundles/claim-judge.yaml

@@ -0,0 +1,49 @@
+id: claim-judge
+kind: proof
+version: 2.0.7
+title: OMG Claim Judge
+description: Evidence-backed claim validator for structured release and completion claims.
+hosts:
+  - claude
+  - codex
+assets:
+  references:
+    - runtime/claim_judge.py
+invocation_policy:
+  user_invocable: true
+  model_invocable: true
+  allow_implicit_invocation: false
+tool_policy:
+  side_effect_level: low
+  allowed_tools:
+    claude:
+      - Read
+      - Grep
+      - Bash(python3:*)
+    codex:
+      - Read
+      - Grep
+      - Bash(python3:*)
+lifecycle_hooks:
+  native:
+    - PostToolUse
+  emulated:
+    - TaskCompleted
+mcp_contract:
+  servers:
+    - omg-control
+lsp_contract:
+  languages:
+    - python
+evidence_outputs:
+  artifacts:
+    - .omg/evidence/claim-judge-*.json
+execution_contract:
+  modes:
+    - embedded
+    - local_supervisor
+channel_overrides:
+  public:
+    posture: self-serve
+  enterprise:
+    posture: managed

package/registry/bundles/control-plane.yaml

@@ -0,0 +1,151 @@
+id: control-plane
+kind: skill
+version: 2.0.7
+title: OMG Control Plane
+description: Canonical production control plane bundle for Claude and Codex.
+hosts:
+  - claude
+  - codex
+assets:
+  references:
+    - OMG_COMPAT_CONTRACT.md
+    - docs/release-checklist.md
+invocation_policy:
+  user_invocable: true
+  model_invocable: false
+  allow_implicit_invocation: false
+tool_policy:
+  side_effect_level: medium
+  allowed_tools:
+    claude:
+      - Read
+      - Grep
+      - Bash(python3:*)
+    codex:
+      - Read
+      - Grep
+      - Bash(python3:*)
+lifecycle_hooks:
+  native:
+    - SessionStart
+    - PreToolUse
+    - PostToolUse
+  emulated:
+    - PreCompact
+    - WorktreeCreate
+    - WorktreeRemove
+mcp_contract:
+  servers:
+    - omg-control
+    - omg-memory
+  prompts:
+    - omg_contract_summary
+  resources:
+    - resource://omg/contract
+    - resource://omg/release-checklist
+lsp_contract:
+  languages:
+    - python
+    - typescript
+evidence_outputs:
+  artifacts:
+    - .omg/evidence/control-plane-compile.json
+execution_contract:
+  modes:
+    - embedded
+    - local_supervisor
+policy_model:
+  trust_tiers:
+    - name: safe
+      level: 0
+      label: Safe
+      allowed_sources:
+        - local_repo
+        - trusted_registry
+    - name: balanced
+      level: 1
+      label: Balanced
+      allowed_sources:
+        - local_repo
+        - trusted_registry
+        - reviewed_external
+    - name: interop
+      level: 2
+      label: Interop
+      allowed_sources:
+        - local_repo
+        - trusted_registry
+        - reviewed_external
+        - migration_bridge
+    - name: labs
+      level: 3
+      label: Labs
+      allowed_sources:
+        - local_repo
+        - trusted_registry
+        - reviewed_external
+        - experimental
+  tool_policies:
+    - tool_name: Read
+      allowed_tiers: [safe, balanced, interop, labs]
+      requires_approval: false
+    - tool_name: Grep
+      allowed_tiers: [safe, balanced, interop, labs]
+      requires_approval: false
+    - tool_name: Bash(python3:*)
+      allowed_tiers: [balanced, interop, labs]
+      requires_approval: true
+  protected_paths:
+    - path_pattern: .omg/**
+      required_tier: balanced
+    - path_pattern: .agents/**
+      required_tier: balanced
+    - path_pattern: .codex/**
+      required_tier: balanced
+    - path_pattern: .claude/**
+      required_tier: balanced
+  evidence_contract:
+    timestamp: timestamp
+    executor: executor
+    trace_id: trace_id
+    lineage: lineage
+  host_rules:
+    claude:
+      compilation_targets:
+        - .claude-plugin/plugin.json
+        - .claude-plugin/marketplace.json
+        - .mcp.json
+        - settings.json
+      hooks:
+        - SessionStart
+        - PreToolUse
+        - PostToolUse
+        - PreCompact
+      subagents:
+        - local_supervisor
+        - workers
+      skills:
+        - omg/control-plane
+        - omg/hook-governor
+    codex:
+      compilation_targets:
+        - .agents/skills/omg/<bundle>/SKILL.md
+        - .agents/skills/omg/<bundle>/openai.yaml
+        - .agents/skills/omg/AGENTS.fragment.md
+        - .agents/skills/omg/codex-mcp.toml
+      skills:
+        - omg/control-plane
+        - omg/mcp-fabric
+      agents_fragments:
+        - .agents/skills/omg/AGENTS.fragment.md
+      rules:
+        - protected_paths
+        - explicit_invocation
+      automations:
+        - contract-compile
+        - release-readiness
+channel_overrides:
+  public:
+    posture: self-serve
+  enterprise:
+    posture: managed

package/registry/bundles/data-lineage.yaml

@@ -0,0 +1,47 @@
+id: data-lineage
+kind: provenance
+version: 2.0.7
+title: OMG Data Lineage
+description: Provenance and privacy tracking for traces, fixtures, examples, and synthetic artifacts.
+hosts:
+  - claude
+  - codex
+assets:
+  references:
+    - runtime/data_lineage.py
+invocation_policy:
+  user_invocable: true
+  model_invocable: true
+  allow_implicit_invocation: true
+tool_policy:
+  side_effect_level: medium
+  allowed_tools:
+    claude:
+      - Read
+      - Bash(python3:*)
+    codex:
+      - Read
+      - Bash(python3:*)
+lifecycle_hooks:
+  native:
+    - PostToolUse
+  emulated:
+    - TaskCompleted
+mcp_contract:
+  servers:
+    - omg-control
+lsp_contract:
+  languages:
+    - python
+evidence_outputs:
+  artifacts:
+    - .omg/lineage/*.json
+execution_contract:
+  modes:
+    - embedded
+    - local_supervisor
+channel_overrides:
+  public:
+    provenance: required
+  enterprise:
+    provenance: required

package/registry/bundles/delta-classifier.yaml

@@ -0,0 +1,47 @@
+id: delta-classifier
+kind: routing
+version: 2.0.7
+title: OMG Delta Classifier
+description: Change classifier that attaches risk-aware checks, approvals, and packs.
+hosts:
+  - claude
+  - codex
+assets:
+  references:
+    - runtime/delta_classifier.py
+invocation_policy:
+  user_invocable: true
+  model_invocable: true
+  allow_implicit_invocation: true
+tool_policy:
+  side_effect_level: low
+  allowed_tools:
+    claude:
+      - Read
+      - Grep
+    codex:
+      - Read
+      - Grep
+lifecycle_hooks:
+  native:
+    - SessionStart
+  emulated:
+    - TaskCompleted
+mcp_contract:
+  servers:
+    - omg-control
+lsp_contract:
+  languages:
+    - python
+evidence_outputs:
+  artifacts:
+    - .omg/tracebank/events.jsonl
+execution_contract:
+  modes:
+    - embedded
+    - local_supervisor
+channel_overrides:
+  public:
+    classification: advisory
+  enterprise:
+    classification: required

package/registry/bundles/eval-gate.yaml

@@ -0,0 +1,47 @@
+id: eval-gate
+kind: evaluation
+version: 2.0.7
+title: OMG Eval Gate
+description: Reproducible evaluation gate that blocks regressions before release.
+hosts:
+  - claude
+  - codex
+assets:
+  references:
+    - runtime/eval_gate.py
+invocation_policy:
+  user_invocable: true
+  model_invocable: true
+  allow_implicit_invocation: false
+tool_policy:
+  side_effect_level: medium
+  allowed_tools:
+    claude:
+      - Read
+      - Bash(python3:*)
+    codex:
+      - Read
+      - Bash(python3:*)
+lifecycle_hooks:
+  native:
+    - PostToolUse
+  emulated:
+    - TaskCompleted
+mcp_contract:
+  servers:
+    - omg-control
+lsp_contract:
+  languages:
+    - python
+evidence_outputs:
+  artifacts:
+    - .omg/evals/latest.json
+execution_contract:
+  modes:
+    - embedded
+    - local_supervisor
+channel_overrides:
+  public:
+    regressions: block
+  enterprise:
+    regressions: block