@trac3er/oh-my-god 2.0.1 → 2.0.3

package/.claude-plugin/marketplace.json

@@ -6,7 +6,7 @@
   },
   "metadata": {
     "description": "OMG - Oh-My-God for Claude Code",
-    "version": "2.0.1",
+    "version": "2.0.3",
     "homepage": "https://github.com/trac3er00/OMG",
     "repository": "https://github.com/trac3er00/OMG"
   },
@@ -14,7 +14,7 @@
     {
       "name": "omg",
       "description": "OMG plugin layer for Claude Code with native setup, orchestration, and interop.",
-      "version": "2.0.1",
+      "version": "2.0.3",
       "source": "./",
       "author": {
         "name": "trac3er00"
@@ -32,5 +32,5 @@
       ]
     }
   ],
-  "version": "2.0.1"
+  "version": "2.0.3"
 }

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "omg",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "description": "OMG plugin layer for Claude Code with native setup, orchestration, and interop.",
   "author": {
     "name": "trac3er00"

package/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+## 2.0.3 - 2026-03-06
+
+- removed OpenCode runtime, setup wiring, docs, and tests from the supported OMG host surface
+- merged the remaining security and trust-review hardening work into `main` and cleaned up the finished `codex/*` branches
+- published the post-merge patch release after the `v2.0.2` release target became immutable
+
+## 2.0.2 - 2026-03-06
+
+- cleaned the repo for public launch by removing internal planning docs and stale private references
+- added a public-readiness checker plus CI enforcement for docs, links, and community templates
+- rewrote the public docs funnel around install, `/OMG:setup`, `/OMG:crazy`, proof, and contribution guidance
+
+## 2.0.1 - 2026-03-06
+
+- standardized OMG public identity across docs, package metadata, plugin metadata, and CLI surfaces
+- added native adoption flow through `OMG-setup.sh` and `/OMG:setup` with `OMG-only` and `coexist` modes
+- added public-readiness hygiene checks and contributor-facing repo docs
+- rewrote the public docs funnel around host install, `/OMG:setup`, `/OMG:crazy`, and proof-backed verification

package/CODE_OF_CONDUCT.md

@@ -0,0 +1,27 @@
+# Code of Conduct
+
+## Our Standard
+
+Treat contributors with respect. Discussions should stay technical, honest, and focused on moving the work forward.
+
+Expected behavior:
+
+- assume good intent
+- critique ideas directly and respectfully
+- provide evidence for technical claims
+- avoid harassment, intimidation, or discriminatory language
+
+Unacceptable behavior:
+
+- personal attacks
+- doxxing or privacy violations
+- harassment or sustained disruption
+- abusive, discriminatory, or sexualized language
+
+## Enforcement
+
+Project maintainers may remove comments, reject contributions, or restrict participation when behavior makes the project unsafe or unproductive.
+
+## Scope
+
+This applies to issues, pull requests, discussions, and other project communication spaces.

package/CONTRIBUTING.md

@@ -0,0 +1,62 @@
+# Contributing to OMG
+
+Thanks for contributing to OMG.
+
+## Local Setup
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -r requirements.txt
+python3 -m pytest tests -q
+```
+
+If you are validating the public launch surface, also run:
+
+```bash
+python3 scripts/check-omg-public-ready.py
+python3 scripts/check-omg-standalone-clean.py
+./scripts/verify-standalone.sh
+```
+
+## Workflow
+
+1. Create a branch from `main`.
+2. Keep changes surgical and evidence-backed.
+3. Add or update tests before changing behavior.
+4. Run the relevant targeted tests while iterating.
+5. Run `python3 -m pytest tests -q` before opening a PR.
+
+## Pull Requests
+
+PRs should explain:
+
+- what changed
+- why it changed
+- how it was verified
+- any follow-up risk or known limitation
+
+Public-surface changes should also mention whether README, proof docs, install docs, and community docs stayed consistent.
+
+## Versioning and Releases
+
+- OMG uses semantic version tags such as `v2.0.1`.
+- `package.json`, plugin metadata, and release tags must agree before a release is cut.
+- npm publishing is driven by the `publish-npm.yml` workflow on version tags.
+
+Before cutting a release, run the checklist in [docs/release-checklist.md](docs/release-checklist.md).
+
+## CI Gates
+
+The public release path is expected to pass:
+
+- compat gate
+- public-readiness hygiene check
+- standalone verification
+- full pytest suite
+
+## Scope Guidance
+
+- Keep OMC, OMX, and Superpowers mentions limited to compatibility and adoption guidance.
+- Avoid adding public commands that mirror another project's branding or command names.
+- Prefer OMG-native setup and orchestration language in docs and UX.

package/OMG-setup.sh

@@ -5,7 +5,7 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 CLAUDE_DIR="${CLAUDE_CONFIG_DIR:-$HOME/.claude}"
 BACKUP_TS="$(date +%Y%m%d_%H%M%S)"
 BACKUP_DIR="$CLAUDE_DIR/.omg-backup-$BACKUP_TS"
-VERSION="2.0.1"
+VERSION="2.0.2"
 
 PLUGIN_NAME="omg"
 PLUGIN_MARKETPLACE="omg"

package/README.md

@@ -1,104 +1,89 @@
-# OMG 2.0.1
+# OMG 2.0.3
 
-OMG upgrades your agent host instead of replacing it. It gives Claude Code, Codex, OpenCode, and other supported CLIs a tighter setup flow, stronger orchestration, adoption paths from older plugin stacks, and proof-backed verification.
+[![Compat Gate](https://github.com/trac3er00/OMG/actions/workflows/omg-compat-gate.yml/badge.svg)](https://github.com/trac3er00/OMG/actions/workflows/omg-compat-gate.yml)
+[![npm version](https://img.shields.io/npm/v/%40trac3er%2Foh-my-god)](https://www.npmjs.com/package/@trac3er/oh-my-god)
+[![License](https://img.shields.io/github/license/trac3er00/OMG)](LICENSE)
+
+OMG upgrades your agent host instead of replacing it. It gives Claude Code, Codex, and other supported CLIs a tighter setup flow, stronger orchestration, native adoption from older plugin stacks, and proof-backed verification.
 
 - Brand: `OMG`
 - Repo: `https://github.com/trac3er00/OMG`
 - npm: `@trac3er/oh-my-god`
 - Plugin id: `omg`
 - Marketplace id: `omg`
-- Version: `2.0.1`
-
-## The Front Door
-
-OMG keeps the public journey small:
-
-1. Install for your host.
-2. Run `/OMG:setup`.
-3. Run `/OMG:crazy <goal>`.
+- Version: `2.0.3`
 
-Everything else is still available, but `setup` and `crazy` are the native OMG entrypoints.
+## Why OMG
 
-## What OMG Does
+- Small front door: install, run `/OMG:setup`, then `/OMG:crazy <goal>`.
+- Multi-host support: Claude Code, Codex, Gemini CLI, and Kimi CLI.
+- Native adoption: setup detects OMC, OMX, and Superpowers-style environments without exposing copycat public migration commands.
+- Proof-first delivery: verification, provider coverage, HUD artifacts, and transcripts are published instead of implied.
 
-- Upgrades Claude Code, Codex, and OpenCode with a shared orchestration layer.
-- Detects overlapping ecosystems and offers native OMG adoption instead of public migration commands.
-- Supports two adoption modes:
-  - `OMG-only`: recommended. OMG becomes the primary hooks, HUD, MCP, and orchestration layer.
-  - `coexist`: advanced. OMG preserves other ecosystems where possible and avoids destructive overlap.
-- Presets reduce feature-flag sprawl:
-  - `safe`
-  - `balanced`
-  - `interop`
-  - `labs`
-- Keeps `compat` available for legacy skill routing without making it the main onboarding story.
+![OMG HUD](docs/assets/omg-hud.svg)
 
-## Supported Hosts
+## Quickstart
 
-- Claude Code
-- Codex
-- OpenCode
-- Gemini CLI
-- Kimi CLI
-
-Claude Code, Codex, and OpenCode are the primary top-level install journeys in this release.
-
-## Install
-
-### npm
+Install with npm:
 
 ```bash
 npm install @trac3er/oh-my-god
 ```
 
-### git
+Or clone and run the setup manager:
 
 ```bash
 git clone https://github.com/trac3er00/OMG
 cd OMG
 chmod +x OMG-setup.sh
-./OMG-setup.sh install
+./OMG-setup.sh install --mode=omg-only --preset=balanced
+```
+
+Then run:
+
+```text
+/OMG:setup
+/OMG:crazy stabilize auth and dashboard flows
 ```
 
-### Host Guides
+Success looks like:
 
-- Claude Code: [docs/install/claude-code.md](/Users/cminseo/Documents/scripts/Shell/OMG/docs/install/claude-code.md)
-- Codex: [docs/install/codex.md](/Users/cminseo/Documents/scripts/Shell/OMG/docs/install/codex.md)
-- OpenCode: [docs/install/opencode.md](/Users/cminseo/Documents/scripts/Shell/OMG/docs/install/opencode.md)
+- supported hosts are detected
+- `.mcp.json` is configured
+- `.omg/state/adoption-report.json` is written when another ecosystem is present
+- OMG reports the selected preset and next step
 
+## Install Guides
+
+- Claude Code: [docs/install/claude-code.md](docs/install/claude-code.md)
+- Codex: [docs/install/codex.md](docs/install/codex.md)
 ## Native Adoption
 
-OMG can adopt setups coming from OMC, OMX, and Superpowers-style environments through `/OMG:setup` and `OMG-setup.sh`.
+OMG uses native setup language instead of public migration commands.
 
-- It detects overlapping ecosystems internally.
-- It writes an adoption report to `.omg/state/adoption-report.json`.
-- It recommends `OMG-only` and keeps `coexist` available when you want a non-destructive landing.
+- `OMG-only`: recommended. OMG becomes the primary hooks, HUD, MCP, and orchestration layer.
+- `coexist`: advanced. OMG preserves non-conflicting third-party surfaces and records overlap instead of overwriting it.
+- Presets: `safe`, `balanced`, `interop`, `labs`.
 
-Details: [docs/migration/native-adoption.md](/Users/cminseo/Documents/scripts/Shell/OMG/docs/migration/native-adoption.md)
+Compatibility references to OMC, OMX, and Superpowers are documented here: [docs/migration/native-adoption.md](docs/migration/native-adoption.md)
 
 ## Proof
 
-Trust is a product surface. OMG publishes proof for:
-
-- current verification results
-- verification status
-- provider coverage
-- adoption evidence
-- HUD artifact
-- sample transcripts
+Current local verification for this release: `2425 passed, 2 skipped` on March 6, 2026.
 
-Current local verification for this release: `2444 passed, 2 skipped` on March 6, 2026.
+- Verification and provider matrix: [docs/proof.md](docs/proof.md)
+- Sample setup transcript: [docs/transcripts/setup.md](docs/transcripts/setup.md)
+- Sample crazy transcript: [docs/transcripts/crazy.md](docs/transcripts/crazy.md)
+- Release process: [docs/release-checklist.md](docs/release-checklist.md)
 
-See [docs/proof.md](/Users/cminseo/Documents/scripts/Shell/OMG/docs/proof.md).
+## Command Surface
 
-## Commands
-
-Primary:
+Primary entry points:
 
 - `/OMG:setup`
 - `/OMG:crazy`
 
-Advanced:
+Advanced surfaces stay available for deeper workflows:
 
 - `/OMG:teams`
 - `/OMG:ccg`
@@ -106,6 +91,14 @@ Advanced:
 - `/OMG:ship`
 - `/OMG:security-review`
 
+## Contributing
+
+Public contributions are welcome.
+
+- Contribution guide: [CONTRIBUTING.md](CONTRIBUTING.md)
+- Security reporting: [SECURITY.md](SECURITY.md)
+- Changelog: [CHANGELOG.md](CHANGELOG.md)
+
 ## Positioning
 
 OMG is a plugin and orchestration layer for supported CLIs. It is not a base-model training project. The goal is to make frontier agent hosts tighter, safer, more interoperable, and more verifiable than the default experience.

package/SECURITY.md

@@ -0,0 +1,25 @@
+# Security Policy
+
+## Reporting a Vulnerability
+
+Please use GitHub's private vulnerability reporting for this repository if it is enabled.
+
+If private reporting is not available, do not open a public issue with exploit details. Open a minimal issue asking for a private contact path through the maintainer's GitHub profile instead.
+
+Include:
+
+- affected version
+- impact
+- reproduction steps
+- proof of concept if safe to share privately
+- suggested mitigation if known
+
+## Response Expectations
+
+- We will triage reports before public discussion.
+- We may ask for additional reproduction details.
+- Coordinated disclosure is preferred over immediate public disclosure.
+
+## Supported Versions
+
+Security fixes are prioritized for the latest released version.

package/commands/OMG:setup.md

@@ -10,7 +10,7 @@ Feature-gated: requires `OMG_SETUP_ENABLED=1` or `settings.json._omg.features.SE
 
 ## Overview
 
-Native OMG setup for Claude Code, Codex, OpenCode, and other supported CLIs.
+Native OMG setup for Claude Code, Codex, and other supported CLIs.
 The command keeps migration logic internal and focuses the user on a small adoption flow:
 
 1. Detect supported CLIs.
@@ -25,7 +25,6 @@ The command keeps migration logic internal and focuses the user on a small adopt
 Step 1: Detect CLIs
   - codex
   - gemini
-  - opencode
   - kimi
 
 Step 2: Detect adoption context
@@ -69,3 +68,11 @@ The command emits a final summary that includes:
 - selected preset
 - selected adoption mode
 - adoption report path
+
+## Public Path
+
+The public OMG journey is:
+
+1. install for your host
+2. run `/OMG:setup`
+3. run `/OMG:crazy <goal>`

package/hooks/credential_store.py

@@ -8,7 +8,7 @@ at .omg/state/credentials.meta.
 CLI: python hooks/credential_store.py {add,list,remove,rotate} [options]
 
 Feature flag: OMG_MULTI_CREDENTIAL_ENABLED (default off)
-Design ref: .sisyphus/credential-store-design.md
+Design note: encrypted credentials live in OMG-managed state under .omg/state
 """
 from __future__ import annotations
 

package/hooks/prompt-enhancer.py

@@ -2,7 +2,7 @@
 """
 UserPromptSubmit Hook — OMG v1
 
-Inspired by oh-my-opencode's Sisyphus agent system. Key upgrades:
+Inspired by earlier OMG routing experiments. Key upgrades:
   1. Intent classification BEFORE acting (IntentGate)
   2. Discipline enforcement — never stop halfway
   3. Agent-aware routing — Codex/Gemini/Claude orchestration

package/hooks/setup_wizard.py

@@ -24,14 +24,12 @@ from runtime.mcp_config_writers import (  # noqa: E402
     write_claude_mcp_config,
     write_codex_mcp_config,
     write_gemini_mcp_config,
-    write_opencode_mcp_config,
     write_kimi_mcp_config,
 )
 
 # Trigger provider auto-registration on import
 import runtime.providers.codex_provider  # noqa: E402, F401
 import runtime.providers.gemini_provider  # noqa: E402, F401
-import runtime.providers.opencode_provider  # noqa: E402, F401
 import runtime.providers.kimi_provider  # noqa: E402, F401
 from runtime.adoption import (  # noqa: E402
     CANONICAL_VERSION,
@@ -46,7 +44,6 @@ _logger = logging.getLogger(__name__)
 _INSTALL_HINTS: dict[str, str] = {
     "codex": "npm install -g @openai/codex",
     "gemini": "npm install -g @google/gemini-cli",
-    "opencode": "npm install -g opencode-ai  (or: curl -fsSL https://opencode.ai/install | bash)",
     "kimi": "uv tool install --python 3.13 kimi-cli",
 }
 
@@ -325,7 +322,7 @@ def get_cli_auth_instructions(provider: str) -> dict[str, str]:
     or store credentials.
 
     Args:
-        provider: CLI provider name (e.g. "codex", "gemini", "kimi", "opencode").
+        provider: CLI provider name (e.g. "codex", "gemini", or "kimi").
 
     Returns:
         Dict with keys: install, auth, verify, subscription.
@@ -350,12 +347,6 @@ def get_cli_auth_instructions(provider: str) -> dict[str, str]:
             "verify": "kimi --version",
             "subscription": "Requires Kimi API key from platform.moonshot.cn",
         },
-        "opencode": {
-            "install": "npm install -g opencode-ai",
-            "auth": "opencode auth login",
-            "verify": "opencode --version",
-            "subscription": "Requires Anthropic API key or Claude subscription",
-        },
     }
 
     return instructions.get(provider, {
@@ -412,7 +403,6 @@ def configure_mcp(
     cli_writers = {
         "codex": write_codex_mcp_config,
         "gemini": write_gemini_mcp_config,
-        "opencode": write_opencode_mcp_config,
         "kimi": write_kimi_mcp_config,
     }
 
@@ -460,7 +450,6 @@ def set_preferences(project_dir: str, preferences: dict[str, Any]) -> dict[str,
     default_cli_configs: dict[str, Any] = {
         "codex": {"subscription": "free", "max_parallel_agents": 1},
         "gemini": {"subscription": "free", "max_parallel_agents": 1},
-        "opencode": {"subscription": "free", "max_parallel_agents": 1},
         "kimi": {"subscription": "free", "max_parallel_agents": 1},
     }
     preset = resolve_preset(cast(str | None, preferences.get("preset")))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trac3er/oh-my-god",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "description": "OMG (Oh My God) — Multi-agent orchestration, intelligent model routing, and durable session state for Claude Code",
   "main": "OMG-setup.sh",
   "scripts": {

package/plugins/README.md

@@ -47,3 +47,8 @@ plugins/
 ## Adoption Notes
 
 Public migration commands are intentionally avoided. OMG uses `/OMG:setup` and `OMG-setup.sh` to detect and adopt older ecosystems internally, while `compat` remains focused on legacy skill routing.
+
+## Public Docs
+
+- Install guides live in [docs/install/claude-code.md](../docs/install/claude-code.md) and [docs/install/codex.md](../docs/install/codex.md).
+- Proof surface lives in [docs/proof.md](../docs/proof.md).

package/plugins/core/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "omg-core",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "description": "Core OMG commands - native setup, routing, orchestration, and verification surfaces",
   "type": "omg-plugin",
   "commands": {

package/runtime/adoption.py

@@ -11,7 +11,7 @@ CANONICAL_REPO_URL = "https://github.com/trac3er00/OMG"
 CANONICAL_PACKAGE_NAME = "@trac3er/oh-my-god"
 CANONICAL_PLUGIN_ID = "omg"
 CANONICAL_MARKETPLACE_ID = "omg"
-CANONICAL_VERSION = "2.0.1"
+CANONICAL_VERSION = "2.0.3"
 
 VALID_ADOPTION_MODES = ("omg-only", "coexist")
 VALID_PRESETS = ("safe", "balanced", "interop", "labs")

package/runtime/mcp_config_writers.py

@@ -93,17 +93,6 @@ def write_gemini_mcp_config(server_url: str, server_name: str = "memory-server")
     _write_json(config_path, config)
 
 
-def write_opencode_mcp_config(server_url: str, server_name: str = "memory-server") -> None:
-    config_path = Path.home() / ".config" / "opencode" / "opencode.json"
-    config = _load_json(config_path)
-    mcp = config.get("mcp")
-    if not isinstance(mcp, dict):
-        mcp = {}
-        config["mcp"] = mcp
-    mcp[server_name] = {"type": "remote", "url": server_url}
-    _write_json(config_path, config)
-
-
 def write_kimi_mcp_config(server_url: str, server_name: str = "memory-server") -> None:
     config_path = Path.home() / ".kimi" / "mcp.json"
     config = _load_json(config_path)

package/runtime/team_router.py

@@ -26,7 +26,6 @@ _logger = logging.getLogger(__name__)
 try:
     import runtime.providers.codex_provider  # noqa: F401  # pyright: ignore[reportUnusedImport]
     import runtime.providers.gemini_provider  # noqa: F401  # pyright: ignore[reportUnusedImport]
-    import runtime.providers.opencode_provider  # noqa: F401  # pyright: ignore[reportUnusedImport]
     import runtime.providers.kimi_provider  # noqa: F401  # pyright: ignore[reportUnusedImport]
 except ImportError:
     pass
@@ -550,7 +549,6 @@ def dispatch_to_model(agent_name: str, user_prompt: str, project_dir: str) -> di
         provider_name_map = {
             "codex-cli": "codex",
             "gemini-cli": "gemini",
-            "opencode-cli": "opencode",
             "kimi-cli": "kimi",
         }
         provider_name = provider_name_map.get(preferred)

package/scripts/check-omg-public-ready.py

@@ -0,0 +1,193 @@
+#!/usr/bin/env python3
+"""Check that the repo is safe and polished enough for a public launch."""
+from __future__ import annotations
+
+import argparse
+import json
+from pathlib import Path
+import re
+
+ROOT = Path(__file__).resolve().parents[1]
+
+REQUIRED_PUBLIC_DOCS = [
+    "README.md",
+    "CONTRIBUTING.md",
+    "SECURITY.md",
+    "CODE_OF_CONDUCT.md",
+    "CHANGELOG.md",
+]
+
+REQUIRED_COMMUNITY_TEMPLATES = [
+    ".github/ISSUE_TEMPLATE/bug_report.yml",
+    ".github/ISSUE_TEMPLATE/feature_request.yml",
+    ".github/pull_request_template.md",
+]
+
+PUBLIC_DOC_GLOBS = [
+    "README.md",
+    "CONTRIBUTING.md",
+    "SECURITY.md",
+    "CODE_OF_CONDUCT.md",
+    "CHANGELOG.md",
+    "docs/**/*.md",
+    "plugins/README.md",
+    ".github/**/*.md",
+]
+
+TEXT_GLOBS = [
+    "README.md",
+    "CONTRIBUTING.md",
+    "SECURITY.md",
+    "CODE_OF_CONDUCT.md",
+    "CHANGELOG.md",
+    "docs/**/*.md",
+    "commands/**/*.md",
+    "plugins/**/*.md",
+    "agents/**/*.md",
+    "rules/**/*.md",
+    "runtime/**/*.py",
+    "hooks/**/*.py",
+    "scripts/**/*.py",
+    ".github/workflows/**/*.yml",
+    ".github/workflows/**/*.yaml",
+    "OMG-setup.sh",
+    "install.sh",
+    "package.json",
+    "settings.json",
+    ".claude-plugin/**/*.json",
+    "plugins/**/*.json",
+]
+
+MARKDOWN_LINK_RE = re.compile(r"!\[[^\]]*\]\(([^)]+)\)|\[[^\]]+\]\(([^)]+)\)")
+ALLOW_PATTERN_REFERENCES = {
+    ROOT / "scripts" / "check-omg-public-ready.py",
+}
+ALLOW_DEPRECATED_MARKETPLACE = {
+    ROOT / "OMG-setup.sh",
+    ROOT / "scripts" / "check-omg-public-ready.py",
+}
+
+
+def _iter_files(root: Path, globs: list[str]) -> list[Path]:
+    files: list[Path] = []
+    for pattern in globs:
+        files.extend(path for path in root.glob(pattern) if path.is_file())
+    return sorted(set(files))
+
+
+def _read(path: Path) -> str:
+    return path.read_text(encoding="utf-8")
+
+
+def _find_text_violations(root: Path) -> list[str]:
+    violations: list[str] = []
+    for path in _iter_files(root, TEXT_GLOBS):
+        rel = path.relative_to(root)
+        content = _read(path)
+        if "/Users/" in content:
+            if path not in ALLOW_PATTERN_REFERENCES:
+                violations.append(f"{rel}: absolute local path found in public repo content")
+        if ".sisyphus/" in content:
+            if path not in ALLOW_PATTERN_REFERENCES:
+                violations.append(f"{rel}: stale internal path reference found (.sisyphus/)")
+        if "trac3er00/OAL" in content:
+            if path not in ALLOW_PATTERN_REFERENCES:
+                violations.append(f"{rel}: old repo identifier found (trac3er00/OAL)")
+        if "oh-advanced-layer" in content:
+            if path not in ALLOW_DEPRECATED_MARKETPLACE:
+                violations.append(f"{rel}: deprecated marketplace identifier found (oh-advanced-layer)")
+    return violations
+
+
+def _find_missing_docs(root: Path) -> list[str]:
+    violations: list[str] = []
+    for rel in REQUIRED_PUBLIC_DOCS:
+        if not (root / rel).exists():
+            violations.append(f"{rel}: missing required public doc")
+    return violations
+
+
+def _find_missing_templates(root: Path) -> list[str]:
+    violations: list[str] = []
+    for rel in REQUIRED_COMMUNITY_TEMPLATES:
+        if not (root / rel).exists():
+            violations.append(f"{rel}: missing required community template")
+    return violations
+
+
+def _find_internal_docs(root: Path) -> list[str]:
+    plans_dir = root / "docs" / "plans"
+    if plans_dir.exists():
+        return [f"{plans_dir.relative_to(root)}: internal planning docs must not ship in public branch"]
+    return []
+
+
+def _normalize_link_target(raw: str) -> str:
+    target = raw.strip()
+    if target.startswith("<") and target.endswith(">"):
+        target = target[1:-1].strip()
+    return target
+
+
+def _is_relative_markdown_link(target: str) -> bool:
+    if not target:
+        return False
+    if target.startswith("#"):
+        return False
+    lowered = target.lower()
+    return not (
+        lowered.startswith("http://")
+        or lowered.startswith("https://")
+        or lowered.startswith("mailto:")
+        or lowered.startswith("data:")
+        or lowered.startswith("file:")
+        or target.startswith("/")
+    )
+
+
+def _link_target_exists(doc_path: Path, target: str) -> bool:
+    file_part = target.split("#", 1)[0].split("?", 1)[0]
+    if not file_part:
+        return True
+    resolved = (doc_path.parent / file_part).resolve()
+    return resolved.exists()
+
+
+def _find_broken_markdown_links(root: Path) -> list[str]:
+    violations: list[str] = []
+    for path in _iter_files(root, PUBLIC_DOC_GLOBS):
+        rel = path.relative_to(root)
+        content = _read(path)
+        for match in MARKDOWN_LINK_RE.finditer(content):
+            target = _normalize_link_target(match.group(1) or match.group(2) or "")
+            if not _is_relative_markdown_link(target):
+                continue
+            if not _link_target_exists(path, target):
+                violations.append(f"{rel}: broken markdown link -> {target}")
+    return violations
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description="Check OMG public-readiness hygiene")
+    parser.add_argument("--root", default=str(ROOT))
+    args = parser.parse_args()
+    root = Path(args.root).resolve()
+
+    violations = []
+    violations.extend(_find_missing_docs(root))
+    violations.extend(_find_missing_templates(root))
+    violations.extend(_find_internal_docs(root))
+    violations.extend(_find_text_violations(root))
+    violations.extend(_find_broken_markdown_links(root))
+    violations = sorted(set(violations))
+
+    if violations:
+        print(json.dumps({"status": "error", "violations": violations}, indent=2))
+        return 1
+
+    print(json.dumps({"status": "ok", "message": "public readiness check passed"}, indent=2))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/scripts/omg.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""OMG 2.0.1 CLI entrypoint.
+"""OMG 2.0.3 CLI entrypoint.
 
 Implements practical command-line flows for:
 - omg ship

package/settings.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-settings.json",
-  "_comment": "OMG 2.0.1 - project-level config with hook registrations, presets, and feature flags.",
+  "_comment": "OMG 2.0.3 - project-level config with hook registrations, presets, and feature flags.",
   "permissions": {
     "allow": [
       "Agent",
@@ -262,7 +262,7 @@
     ]
   },
   "_omg": {
-    "_version": "2.0.1",
+    "_version": "2.0.3",
     "preset": "safe",
     "default_mode": "ulw+ralph",
     "vision_auto": true,

package/runtime/providers/opencode_provider.py

@@ -1,144 +0,0 @@
-"""OpenCode CLI provider -- implements CLIProvider for the ``opencode`` binary."""
-
-from __future__ import annotations
-
-import json
-import logging
-import os
-import shlex
-import shutil
-import subprocess
-import uuid
-from typing import Any
-
-from runtime.cli_provider import CLIProvider, register_provider
-from runtime.tmux_session_manager import TmuxSessionManager
-
-_logger = logging.getLogger(__name__)
-
-
-class OpenCodeProvider(CLIProvider):
-    """CLIProvider implementation for the OpenCode CLI (``opencode``)."""
-
-    # -- identity -----------------------------------------------------------
-
-    def get_name(self) -> str:  # noqa: D401
-        """Return the canonical provider name."""
-        return "opencode"
-
-    # -- detection ----------------------------------------------------------
-
-    def detect(self) -> bool:
-        """Return ``True`` when the ``opencode`` binary is available on PATH."""
-        return shutil.which("opencode") is not None
-
-    # -- authentication -----------------------------------------------------
-
-    def check_auth(self) -> tuple[bool | None, str]:
-        """Check OpenCode authentication status via ``opencode auth list``."""
-        try:
-            result = self.run_tool(["opencode", "auth", "list"], timeout=30)
-            if result.returncode == 0:
-                return True, result.stdout.strip()
-            return False, result.stderr.strip() or result.stdout.strip()
-        except Exception as exc:
-            return None, f"opencode auth check failed: {exc}"
-
-    # -- invocation ---------------------------------------------------------
-
-    def invoke(self, prompt: str, project_dir: str, timeout: int = 120) -> dict[str, Any]:  # pyright: ignore[reportExplicitAny]
-        """Invoke ``opencode run`` via subprocess."""
-        try:
-            result = self.run_tool(
-                ["opencode", "run", prompt],
-                timeout=timeout,
-            )
-            return {
-                "model": "opencode-cli",
-                "output": result.stdout,
-                "exit_code": result.returncode,
-            }
-        except subprocess.TimeoutExpired:
-            return {"error": "opencode-cli timeout", "fallback": "claude"}
-        except FileNotFoundError:
-            return {"error": "opencode-cli not found", "fallback": "claude"}
-        except Exception as exc:
-            return {"error": str(exc), "fallback": "claude"}
-
-    def invoke_json(self, prompt: str, project_dir: str, timeout: int = 120) -> dict[str, Any]:  # pyright: ignore[reportExplicitAny]
-        """Invoke ``opencode run --format json`` for raw JSON event stream output."""
-        try:
-            result = self.run_tool(
-                ["opencode", "run", "--format", "json", prompt],
-                timeout=timeout,
-            )
-            return {
-                "model": "opencode-cli",
-                "output": result.stdout,
-                "exit_code": result.returncode,
-            }
-        except subprocess.TimeoutExpired:
-            return {"error": "opencode-cli timeout", "fallback": "claude"}
-        except FileNotFoundError:
-            return {"error": "opencode-cli not found", "fallback": "claude"}
-        except Exception as exc:
-            return {"error": str(exc), "fallback": "claude"}
-
-    def invoke_tmux(self, prompt: str, project_dir: str, timeout: int = 120) -> dict[str, Any]:  # pyright: ignore[reportExplicitAny]
-        """Invoke ``opencode run`` via a persistent tmux session.
-
-        Falls back to :meth:`invoke` on failure.
-        """
-        try:
-            mgr = TmuxSessionManager()
-            session_name = mgr.make_session_name("opencode", unique_id=str(uuid.uuid4())[:8])
-            session = mgr.get_or_create_session(session_name)
-            output = mgr.send_command(session, f"opencode run {shlex.quote(prompt)}", timeout=timeout)
-            mgr.kill_session(session)
-            return {"model": "opencode-cli", "output": output, "exit_code": 0}
-        except Exception as exc:
-            _logger.warning("tmux opencode invocation failed, falling back to subprocess: %s", exc)
-            return self.invoke(prompt, project_dir, timeout=timeout)
-
-    # -- command helpers ----------------------------------------------------
-
-    def get_non_interactive_cmd(self, prompt: str) -> list[str]:
-        """Return the non-interactive command for opencode."""
-        return ["opencode", "run", prompt]
-
-    # -- configuration ------------------------------------------------------
-
-    def get_config_path(self) -> str:
-        """Return the OpenCode configuration file path."""
-        return os.path.expanduser("~/.config/opencode/opencode.json")
-
-    def write_mcp_config(self, server_url: str, server_name: str = "memory-server") -> None:
-        """Write an MCP server entry to ``~/.config/opencode/opencode.json``.
-
-        Uses JSON format with ``mcp`` key, ``type: "remote"``, and ``url`` field,
-        merging into any existing configuration.
-        """
-        config_path = self.get_config_path()
-        os.makedirs(os.path.dirname(config_path), exist_ok=True)
-
-        # Load existing config or start fresh
-        existing: dict[str, Any] = {}  # pyright: ignore[reportExplicitAny]
-        if os.path.exists(config_path):
-            with open(config_path) as fh:
-                try:
-                    existing = json.load(fh)
-                except (json.JSONDecodeError, ValueError):
-                    existing = {}
-
-        # Ensure mcp dict exists
-        if "mcp" not in existing:
-            existing["mcp"] = {}
-
-        existing["mcp"][server_name] = {"type": "remote", "url": server_url}
-
-        with open(config_path, "w") as fh:
-            json.dump(existing, fh, indent=2)
-
-
-# -- auto-register on import -----------------------------------------------
-register_provider(OpenCodeProvider())