@trac3er/oh-my-god 2.0.1 → 2.0.2

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.2",
     "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.2",
       "source": "./",
       "author": {
         "name": "trac3er00"
@@ -32,5 +32,5 @@
       ]
     }
   ],
-  "version": "2.0.1"
+  "version": "2.0.2"
 }

package/.claude-plugin/plugin.json

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

package/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog
+
+## 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,91 @@
-# OMG 2.0.1
+# OMG 2.0.2
 
-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, OpenCode, 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>`.
-
-Everything else is still available, but `setup` and `crazy` are the native OMG entrypoints.
+- Version: `2.0.2`
 
-## What OMG Does
+## Why OMG
 
-- 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.
+- Small front door: install, run `/OMG:setup`, then `/OMG:crazy <goal>`.
+- Multi-host support: Claude Code, Codex, OpenCode, 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.
 
-## Supported Hosts
+![OMG HUD](docs/assets/omg-hud.svg)
 
-- Claude Code
-- Codex
-- OpenCode
-- Gemini CLI
-- Kimi CLI
+## Quickstart
 
-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
 ```
 
-### Host Guides
+Then run:
 
-- 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)
+```text
+/OMG:setup
+/OMG:crazy stabilize auth and dashboard flows
+```
 
-## Native Adoption
+Success looks like:
 
-OMG can adopt setups coming from OMC, OMX, and Superpowers-style environments through `/OMG:setup` and `OMG-setup.sh`.
+- 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
 
-- 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.
+## Install Guides
 
-Details: [docs/migration/native-adoption.md](/Users/cminseo/Documents/scripts/Shell/OMG/docs/migration/native-adoption.md)
+- Claude Code: [docs/install/claude-code.md](docs/install/claude-code.md)
+- Codex: [docs/install/codex.md](docs/install/codex.md)
+- OpenCode: [docs/install/opencode.md](docs/install/opencode.md)
 
-## Proof
+## Native Adoption
+
+OMG uses native setup language instead of public migration commands.
+
+- `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`.
 
-Trust is a product surface. OMG publishes proof for:
+Compatibility references to OMC, OMX, and Superpowers are documented here: [docs/migration/native-adoption.md](docs/migration/native-adoption.md)
 
-- current verification results
-- verification status
-- provider coverage
-- adoption evidence
-- HUD artifact
-- sample transcripts
+## Proof
 
-Current local verification for this release: `2444 passed, 2 skipped` on March 6, 2026.
+Current local verification for this release: `2452 passed, 2 skipped` on March 6, 2026.
 
-See [docs/proof.md](/Users/cminseo/Documents/scripts/Shell/OMG/docs/proof.md).
+- 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)
 
-## Commands
+## Command Surface
 
-Primary:
+Primary entry points:
 
 - `/OMG:setup`
 - `/OMG:crazy`
 
-Advanced:
+Advanced surfaces stay available for deeper workflows:
 
 - `/OMG:teams`
 - `/OMG:ccg`
@@ -106,6 +93,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

@@ -69,3 +69,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trac3er/oh-my-god",
-  "version": "2.0.1",
+  "version": "2.0.2",
   "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), [docs/install/codex.md](../docs/install/codex.md), and [docs/install/opencode.md](../docs/install/opencode.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.2",
   "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.2"
 
 VALID_ADOPTION_MODES = ("omg-only", "coexist")
 VALID_PRESETS = ("safe", "balanced", "interop", "labs")

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.2 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.2 - 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.2",
     "preset": "safe",
     "default_mode": "ulw+ralph",
     "vision_auto": true,