@trac3er/oh-my-god 2.1.9 → 2.2.2

package/artifacts/public/dist/public/bundle/plugins/advanced/commands/OMG:learn.md

@@ -0,0 +1,110 @@
+---
+description: Create a reusable skill from a pattern you just did. Auto-detects repetitive work and offers to skill-ify it.
+allowed-tools: Read, Write, Edit, MultiEdit, Bash(git:*), Bash(cat:*), Bash(find:*), Bash(ls:*), Bash(mkdir:*), Bash(tee:*), Grep, Glob
+argument-hint: "[skill name] or 'auto' to detect from recent work"
+---
+
+# /OMG:learn — Auto-Skill Creator
+
+## What This Does
+Takes something you just did (test pattern, implementation approach, debugging method)
+and turns it into a reusable Claude Code skill that activates automatically next time.
+
+## Usage
+
+### Manual: /OMG:learn [skill-name]
+Claude asks you what the pattern is and creates a skill.
+
+### Auto: /OMG:learn auto
+Claude analyzes recent tool-ledger entries to detect repetitive patterns.
+
+## Step 1: Detect Pattern
+
+### If "auto":
+Read .omg/state/ledger/tool-ledger.jsonl (last 50 entries).
+Look for:
+- Same file types being created repeatedly (e.g., always creating .test.ts with same structure)
+- Same command sequences repeated (e.g., lint → typecheck → test → format)
+- Same file reading patterns (e.g., always reading ARCHITECTURE_TOC.md before edits)
+- Same error→fix sequences (e.g., import error → add import → retry)
+
+Present findings: "I noticed you repeatedly [pattern]. Want me to make this a skill?"
+
+### If manual:
+Ask: "Describe the pattern you want to save. What triggers it? What should happen?"
+
+## Step 2: Create Skill
+
+Skills live in: ~/.config/omg/skills/ (personal) or .omg/skills/ (project)
+
+```
+~/.config/omg/skills/[skill-name]/
+├── SKILL.md          # Instructions Claude follows
+├── templates/        # Template files (optional)
+└── scripts/          # Helper scripts (optional)
+```
+
+### SKILL.md Format:
+```markdown
+# [Skill Name]
+
+## When to activate
+[Trigger conditions — what keywords, file types, or situations activate this]
+
+## Steps
+1. [Step 1]
+2. [Step 2]
+...
+
+## Templates
+[If the skill creates files, include template content or reference templates/]
+
+## Quality check
+[How to verify the skill worked correctly]
+
+## Examples
+[1-2 examples of good output]
+```
+
+## Step 3: Register
+
+Add skill to .omg/skills-index.json:
+```json
+{
+  "skills": [
+    {
+      "name": "api-test-pattern",
+      "trigger": ["test", "api", "endpoint"],
+      "path": "~/.config/omg/skills/api-test-pattern/SKILL.md",
+      "description": "Creates API endpoint tests with auth, validation, edge cases"
+    }
+  ]
+}
+```
+
+## Step 4: Verify
+- Create a test invocation
+- Confirm the skill produces correct output
+- Tell user: "Skill '[name]' saved. It'll activate when you [trigger condition]."
+
+## Built-in Skill Candidates (suggest these)
+When detecting patterns, especially look for:
+- **Test patterns**: How tests are structured for this project
+- **Component patterns**: How new React/Vue/etc components are created
+- **API patterns**: How new endpoints are added (route + handler + validation + test)
+- **Migration patterns**: How DB migrations are created and verified
+- **PR patterns**: How PRs are structured (description, checklist, labels)
+- **Debug patterns**: Project-specific debugging steps (log locations, common fixes)
+
+## Aggregated Patterns (Auto)
+When you run `/OMG:learn auto`, OMG reads all learning files from `.omg/state/learnings/` and generates `.omg/knowledge/critical-patterns.md` with your top tool and file patterns.
+
+Run: `python3 -c "import sys; sys.path.insert(0,'hooks'); from _learnings import save_critical_patterns; save_critical_patterns('.')"`
+## File Write Fallback
+If `Write` fails (file exists), use `Edit` or Bash heredoc:
+```bash
+cat > path/to/skill.md << 'SKILLEOF'
+[content]
+SKILLEOF
+```
+Always READ the file after writing to verify changes.

package/artifacts/public/dist/public/bundle/plugins/advanced/commands/OMG:maintainer.md

@@ -0,0 +1,31 @@
+---
+description: Open-source maintainer workflow — issue triage, release notes, review assistance, impact evidence pack
+allowed-tools: Read, Write, Edit, MultiEdit, Grep, Glob, Bash(git:*), Bash(rg:*), Bash(find:*), Bash(cat:*), Bash(ls:*)
+argument-hint: "[triage|release|review|impact]"
+---
+
+# /OMG:maintainer — OSS Maintainer Kit
+
+## Modes
+1. `triage`: summarize new issues, propose labels/priority/owner.
+2. `release`: draft release notes from recent commits and notable changes.
+3. `review`: review open changes with risk tags and test gaps.
+4. `impact`: generate Ecosystem Impact evidence draft.
+
+## Ecosystem Impact Evidence Pack
+Create `.omg/evidence/oss-impact.json` with:
+- `activity`: commits/reviews/releases in recent window
+- `dependents`: direct/transitive usage indicators (if available)
+- `stability`: test pass/fail trend and security findings
+- `adoption_signals`: downloads/stars/changelog cadence (factual only)
+- `summary_500_words`: draft narrative for application forms
+
+## Integrity Policy
+- Never fabricate stats.
+- Never suggest metric manipulation (stars/download inflation).
+- Mark unknown metrics as `unverified`.
+
+## Output format
+- Findings first
+- Risks and unknowns
+- Actionable next 3 maintainer tasks

package/artifacts/public/dist/public/bundle/plugins/advanced/commands/OMG:ralph-start.md

@@ -0,0 +1,43 @@
+---
+description: "Start Ralph autonomous loop — continues working until all tasks complete or max iterations reached."
+allowed-tools: Read, Write, Edit, Bash, Grep, Glob
+argument-hint: "[goal description]"
+---
+
+# /OMG:ralph-start — Start Ralph Autonomous Loop
+
+## Purpose
+Starts a Ralph loop that autonomously continues working until all tasks in the goal are complete or max iterations reached.
+
+## Usage
+```
+/OMG:ralph-start [goal description]
+```
+
+## How it Works
+1. Ask the user for a goal description if not provided
+2. Create `.omg/state/ralph-loop.json` with:
+   - `active: true`
+   - `iteration: 0`
+   - `max_iterations: 50`
+   - `original_prompt: [goal]`
+   - `started_at: [ISO8601 timestamp]`
+   - `checklist_path: ".omg/state/_checklist.md"` (if exists)
+3. Confirm: "Ralph loop started. Will continue working on: [goal]"
+
+## State File Format
+```json
+{
+  "active": true,
+  "iteration": 0,
+  "max_iterations": 50,
+  "original_prompt": "fix all failing tests",
+  "started_at": "2026-02-28T10:00:00Z",
+  "checklist_path": ".omg/state/_checklist.md"
+}
+```
+
+## Stop Condition
+- Reaches max_iterations (50 by default)
+- User runs `/OMG:ralph-stop`
+- User deletes `.omg/state/ralph-loop.json`

package/artifacts/public/dist/public/bundle/plugins/advanced/commands/OMG:ralph-stop.md

@@ -0,0 +1,23 @@
+---
+description: "Stop Ralph autonomous loop — deactivates the state file."
+allowed-tools: Read, Write, Edit, Bash
+argument-hint: ""
+---
+
+# /OMG:ralph-stop — Stop Ralph Autonomous Loop
+
+## Purpose
+Stops an active Ralph loop by deactivating the state file.
+
+## Usage
+```
+/OMG:ralph-stop
+```
+
+## How it Works
+1. Read `.omg/state/ralph-loop.json`
+2. Set `active: false` in the state file (preserve iteration count for review)
+3. Report: "Ralph loop stopped after N iterations. Gomg was: [original_prompt]"
+
+## If No Active Loop
+Report: "No active Ralph loop found. Nothing to stop."

package/artifacts/public/dist/public/bundle/plugins/advanced/commands/OMG:security-review.md

@@ -0,0 +1,16 @@
+---
+description: Deprecated alias to OMG's canonical security-check pipeline.
+allowed-tools: Read, Grep, Glob, Bash(python3:*), Bash(rg:*)
+argument-hint: "[path or '.' for the current project]"
+---
+
+# /OMG:security-review — Deprecated Alias
+
+`/OMG:security-review` remains available only for compatibility.
+
+Use `/OMG:security-check` instead. The canonical pipeline now owns:
+
+- normalized security findings
+- dependency and AST enrichment
+- evidence-ready provenance and trust scores
+- reuse across CLI, compat routing, control plane, MCP, and ship flows

package/artifacts/public/dist/public/bundle/plugins/advanced/commands/OMG:sequential-thinking.md

@@ -0,0 +1,20 @@
+---
+description: Structured multi-step reasoning using sequential-thinking tool for complex debugging and planning.
+allowed-tools: sequential-thinking_sequentialthinking, Read, Grep, Glob
+argument-hint: "[problem statement to reason through]"
+---
+
+# /OMG:sequential-thinking
+
+Use the sequential-thinking tool when the task needs explicit step-by-step reasoning,
+branching, and hypothesis verification.
+
+Execution contract:
+- Start with an initial thought budget
+- Revise or branch when new evidence appears
+- End only when a verified conclusion is reached
+
+Output contract:
+- Return final conclusion
+- Return key assumptions
+- Return verification steps used

package/artifacts/public/dist/public/bundle/plugins/advanced/commands/OMG:ship.md

@@ -0,0 +1,46 @@
+---
+description: Ship pipeline — Idea -> Plan -> Execute -> Evidence -> PR-ready summary
+allowed-tools: Read, Write, Edit, MultiEdit, Grep, Glob, Bash(git:*), Bash(rg:*), Bash(find:*), Bash(cat:*), Bash(python3:*), Bash(pytest:*), Bash(npm test:*), Bash(go test:*), Bash(cargo test:*), Bash(jest:*), Bash(vitest:*)
+argument-hint: "[goal or optional path to .omg/idea.yml]"
+---
+
+# /OMG:ship — Idea -> Evidence -> PR
+
+## Step 1: Load idea contract
+- Prefer `.omg/idea.yml`.
+- If missing, scaffold from `~/.claude/templates/omg/idea.yml` and ask user for minimum fields:
+  - `goal`, `constraints`, `acceptance`, `risk`, `evidence_required`.
+
+## Step 2: Convert idea to execution plan
+- Consume plan artifacts generated by `/OMG:deep-plan`.
+- 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.
+
+## Step 3: Execute with Shadow + Evidence discipline
+- Implement changes.
+- Run verification commands.
+- Build an evidence pack at `.omg/evidence/<run-id>.json` containing:
+  - `tests[]`, `security_scans[]`, `diff_summary`, `reproducibility`, `unresolved_risks[]`.
+
+## Step 4: Security and trust checks
+- Run `/OMG:security-check` for auth/payment/database/sensitive changes.
+- If config/hook/MCP changes are involved, ensure trust manifest is updated at `.omg/trust/manifest.lock.json`.
+
+## Step 5: PR-ready output
+Return:
+1. Goal and scope delivered
+2. Files changed
+3. Verification evidence (command + exit code)
+4. Risks/unknowns
+5. Suggested PR title + body
+
+## Full-power sub-agent protocol
+- Prefer parallel background sub-agent launches for independent workstreams.
+- Do not finalize until every launched track is collected via `background_output`.
+- Use `sequential-thinking` to reconcile conflicts and enforce execution order.
+
+## Anti-patterns
+- Do not claim done without evidence.
+- Do not edit tests to hide product bugs.
+- Do not skip trust review for `.claude/.omg` or MCP changes.

package/artifacts/public/dist/public/bundle/plugins/advanced/plugin.json

@@ -0,0 +1,104 @@
+{
+  "name": "omg-advanced",
+  "version": "2.1.9",
+  "description": "Advanced OMG commands - deep planning, learning, code review, and specialized workflows",
+  "type": "omg-plugin",
+  "commands": {
+    "deep-plan": {
+      "path": "commands/OMG:deep-plan.md",
+      "description": "Deep strategic planning with domain awareness",
+      "category": "planning"
+    },
+    "learn": {
+      "path": "commands/OMG:learn.md",
+      "description": "Create reusable skills from patterns",
+      "category": "knowledge"
+    },
+    "code-review": {
+      "path": "commands/OMG:code-review.md",
+      "description": "Deep code review with line-by-line analysis",
+      "category": "quality"
+    },
+    "ship": {
+      "path": "commands/OMG:ship.md",
+      "description": "Ship pipeline - idea to PR-ready summary",
+      "category": "delivery"
+    },
+    "handoff": {
+      "path": "commands/OMG:handoff.md",
+      "description": "Intelligent session transfer",
+      "category": "collaboration"
+    },
+    "maintainer": {
+      "path": "commands/OMG:maintainer.md",
+      "description": "Open-source maintainer workflows",
+      "category": "oss"
+    },
+    "sequential-thinking": {
+      "path": "commands/OMG:sequential-thinking.md",
+      "description": "Structured multi-step reasoning",
+      "category": "thinking"
+    },
+    "ralph-start": {
+      "path": "commands/OMG:ralph-start.md",
+      "description": "Start Ralph autonomous loop",
+      "category": "automation"
+    },
+    "ralph-stop": {
+      "path": "commands/OMG:ralph-stop.md",
+      "description": "Stop Ralph autonomous loop",
+      "category": "automation"
+    }
+  },
+  "categories": {
+    "planning": {
+      "description": "Strategic planning and architecture",
+      "commands": [
+        "deep-plan"
+      ]
+    },
+    "quality": {
+      "description": "Code quality and review",
+      "commands": [
+        "code-review"
+      ]
+    },
+    "knowledge": {
+      "description": "Learning and skill creation",
+      "commands": [
+        "learn"
+      ]
+    },
+    "delivery": {
+      "description": "Shipping and release workflows",
+      "commands": [
+        "ship"
+      ]
+    },
+    "collaboration": {
+      "description": "Team collaboration and handoff",
+      "commands": [
+        "handoff"
+      ]
+    },
+    "automation": {
+      "description": "Autonomous execution modes",
+      "commands": [
+        "ralph-start",
+        "ralph-stop"
+      ]
+    },
+    "thinking": {
+      "description": "Structured thinking tools",
+      "commands": [
+        "sequential-thinking"
+      ]
+    },
+    "oss": {
+      "description": "Open source maintainer tools",
+      "commands": [
+        "maintainer"
+      ]
+    }
+  }
+}

package/artifacts/public/dist/public/bundle/registry/bundles/algorithms.yaml

@@ -0,0 +1,45 @@
+id: algorithms
+kind: domain-pack
+version: 2.1.9
+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/artifacts/public/dist/public/bundle/registry/bundles/api-twin.yaml

@@ -0,0 +1,48 @@
+id: api-twin
+kind: simulation
+version: 2.1.9
+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/artifacts/public/dist/public/bundle/registry/bundles/ast-pack.yaml

@@ -0,0 +1,80 @@
+id: ast-pack
+kind: governance
+version: 2.1.9
+title: OMG AST Pack Lane
+description: Governed AST search and replace lane with canonical approvals and proofs.
+hosts:
+  - claude
+  - codex
+assets:
+  references:
+    - runtime/tool_fabric.py
+    - registry/verify_artifact.py
+invocation_policy:
+  user_invocable: true
+  model_invocable: true
+  allow_implicit_invocation: false
+tool_policy:
+  side_effect_level: medium
+  allowed_tools:
+    claude:
+      - Grep
+      - Edit
+    codex:
+      - Grep
+      - Edit
+lifecycle_hooks:
+  native:
+    - PreToolUse
+    - PostToolUse
+  emulated:
+    - TaskCompleted
+mcp_contract:
+  servers:
+    - omg-control
+lsp_contract:
+  languages:
+    - python
+    - typescript
+evidence_outputs:
+  artifacts:
+    - .omg/evidence/ast-pack-{run_id}.json
+execution_contract:
+  modes:
+    - embedded
+    - local_supervisor
+tool_fabric:
+  lane: ast-pack
+  enforcement_order:
+    - tool_selection
+    - approval_state
+    - evidence_requirements
+    - attestation_proof_validation
+    - execution
+  tools:
+    - Grep
+    - Edit
+  semantic_operations:
+    - name: ast_search
+      tool: Grep
+      mutation_capable: false
+      requires_explicit_promotion: false
+    - name: ast_rewrite
+      tool: Edit
+      mutation_capable: true
+      requires_explicit_promotion: true
+  requires_signed_approval: true
+  requires_signed_approval_for_mutation: true
+  requires_attestation: false
+  requires_attestation_for_mutation: true
+  dry_run_first: true
+  require_run_scoped_evidence: true
+  require_fresh_evidence: true
+  evidence_max_age_seconds: 3600
+  required_evidence:
+    - .omg/evidence/ast-pack-{run_id}.json
+channel_overrides:
+  public:
+    posture: advisory
+  enterprise:
+    posture: managed

package/artifacts/public/dist/public/bundle/registry/bundles/claim-judge.yaml

@@ -0,0 +1,49 @@
+id: claim-judge
+kind: proof
+version: 2.1.9
+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