holycodex 0.5.3 → 0.7.0-dev.29548214169.1

package/README.md

@@ -1,95 +1,12 @@
-# HolyCodex
+# holycodex
 
-HolyCodex is a modified, standalone Codex-only hard fork of [oh-my-openagent](https://github.com/code-yeongyu/oh-my-openagent). It keeps the parts that make Codex better at software work, removes the OpenCode runtime and organizational agent machinery, and compresses persistent instructions for lower ChatGPT Plus usage.
-
-## What
-
-HolyCodex installs one focused Codex toolkit:
-
-- 16 on-demand skills for programming, debugging, frontend, LSP, AST search, security research, planning, handoffs, goal definition, compression, and related workflows.
-- Three optional subagents: `explorer` for internal inspection, `librarian` for external research, and `worker` for bounded implementation.
-- Three MCP defaults: `git_bash`, `lsp`, and `context7`.
-- Small command hooks for readiness and scoped rules.
-- A Node-compatible installer and prebuilt runtime usable through npm or Bun.
-
-The primary agent owns intent, scope, architecture, decisions, integration, and final verification. Subagents only reduce cost on narrow independent work; skills own their declared methods and gates.
-
-## Why
-
-Large always-on prompts, agent hierarchies, review loops, and duplicated context consume tokens before useful work begins. HolyCodex takes a smaller approach:
-
-- Skills load only when descriptions match the task and state activation, exclusions, outcome, and adjacent boundary.
-- Rules are path-scoped, size-limited, cached, and deduplicated; `AGENTS.md` is never reinjected.
-- Concurrent delegation is capped at two; every delegated slice has fixed scope, evidence, acceptance, and stop conditions under primary-agent control.
-- Explorer and librarian use GPT-5.6 Luna low; worker uses GPT-5.6 Luna medium.
-- Git Bash shell execution is required only on native Windows when its MCP run tool is available; other environments use their native shell directly.
-- OMO workflows and retained references are rewritten with caveman-style token efficiency.
-- The OMO frontend skill is merged with GPT Taste instead of shipping another overlapping skill.
-
-The result aims to keep strong engineering behavior while spending fewer Plus tokens on ceremony and repeated instructions.
-
-## How
-
-### Install
-
-Use either runtime:
+HolyCodex installer and doctor CLI. Plugin prompts, skills, agents, hooks, and runtime assets ship through the exact-version `@holycodex/plugin` dependency.
 
 ```sh
-npx holycodex install
-bunx holycodex install
+bunx holycodex@dev install
+bunx holycodex@dev doctor
 ```
 
-Installation is noninteractive. It:
-
-1. Backs up every affected existing file or managed cache under the OS temporary directory.
-2. Removes legacy OMO configuration and cache after backup.
-3. Preserves unrelated Codex settings and explicit model or agent preferences.
-4. Installs the HolyCodex marketplace, plugin, agents, skills, hooks, and MCP definitions.
-5. Sets `max_concurrent_threads_per_session = 2` and defaults the root model to GPT-5.6 Sol low only when no root preference exists.
-
-Codex may still ask you to review and trust the installed command hooks. This security review is the only manual installation step.
-
-Options:
-
-```sh
-holycodex install --json
-holycodex install
-holycodex --help
-holycodex --version
-```
-
-### Cleanup
-
-```sh
-npx holycodex cleanup
-# or
-bunx holycodex cleanup
-```
-
-Cleanup backs up affected files, removes only HolyCodex-owned configuration and artifacts, and preserves unrelated settings. Install and cleanup are idempotent.
-
-### Repository layout
-
-- `plugin/skills/` — shipped skill catalogue and on-demand references.
-- `plugin/agents/` — the three cost-focused subagent definitions.
-- `plugin/hooks/` — supported command hooks for readiness and scoped rules.
-- `plugin/.mcp.json` — local and remote MCP defaults.
-- `plugin/runtime/` — prebuilt Node-compatible CLI, rules, Git Bash, and LSP runtime.
-- `src/` — installer, cleanup, bootstrap, and scoped-rules source.
-- `packages/` — Git Bash and LSP MCP source.
-- `test/` — CLI, lifecycle, catalogue, rules, bootstrap, and MCP tests.
-
-## Thanks
-
-HolyCodex exists because of the work of:
-
-- [YeonGyu Kim and the oh-my-openagent contributors](https://github.com/code-yeongyu/oh-my-openagent), whose project, history, workflows, and Codex integrations form the foundation of this hard fork.
-- [Julius Brussee and caveman contributors](https://github.com/JuliusBrussee/caveman), for the token-efficient communication approach adapted here.
-- The authors credited in [`plugin/skills/frontend/ATTRIBUTION.md`](plugin/skills/frontend/ATTRIBUTION.md), whose frontend design, performance, and UI/UX resources remain attributed under their original terms.
-- Every upstream library and tool author whose work is preserved in the Git history and third-party notices.
-
-## Licenses
-
-HolyCodex uses the same [Sustainable Use License 1.0](LICENSE.md) as oh-my-openagent. This is not the MIT License: use and distribution are subject to the limitations in `LICENSE.md`.
+Use `holycodex --help` for commands and autonomy options. Stable releases use `bunx holycodex`; development releases use npm's `dev` dist-tag.
 
-Third-party components retain their original licenses. Relevant notices and bundled license files are preserved in [THIRD-PARTY-NOTICES.md](THIRD-PARTY-NOTICES.md) and alongside the applicable skills or components.
+Repository, documentation, license, and security notices: https://github.com/davidbasilefilho/holycodex

package/THIRD-PARTY-NOTICES.md

@@ -2,6 +2,10 @@
 
 HolyCodex began as a one-time hard fork of `code-yeongyu/oh-my-openagent` and preserves its Git history. The repository uses the same Sustainable Use License 1.0. Third-party components retain their original licenses.
 
-The caveman communication concept is adapted from `juliusbrussee/caveman`, with attribution preserved here. Copyright belongs to its authors and contributors; used under its published license.
+The caveman communication concept is adapted from [juliusbrussee/caveman](https://github.com/JuliusBrussee/caveman). Copyright belongs to its authors and contributors; use remains subject to that project's published license.
 
-The bundled LSP runtime at `plugin/runtime/lsp.js` is derived from `code-yeongyu/oh-my-openagent`'s `lsp-tools-mcp`. Copyright (c) 2026 Yeongyu Kim; used under the MIT License preserved at `plugin/runtime/LICENSE-LSP-MIT.txt`.
+`packages/plugin/plugin/skills/remove-slop` adapts the scoped behavior-locking process from [code-yeongyu/oh-my-openagent](https://github.com/code-yeongyu/oh-my-openagent) `remove-ai-slops` at commit `dec381ed201a1326883db9f42bdb3c2add91b299`, under the upstream Sustainable Use License 1.0. OpenCode-specific task mechanics were not copied. [pols.dev/slop.md](https://pols.dev/slop.md) is cited as frontend anti-slop guidance; no text is bundled from that page, and its visual classifications apply only to matching frontend scope.
+
+HolyCodex agent routing and orchestration instructions adapt bounded-role, task-ownership, non-overlapping-write, session-reuse, and verification-planning concepts from [alvinunreal/oh-my-opencode-slim](https://github.com/alvinunreal/oh-my-opencode-slim) at commit `7bc7b56856ee693812d87d68615757d4d1c2e218`, principally `src/agents/{orchestrator,explorer,librarian,fixer}.ts`, `src/skills/verification-planning/SKILL.md`, and `docs/background-orchestration.md`. OpenCode runtime APIs, hooks, council, ACP, companion, and background-session mechanics were not copied. Upstream material is MIT licensed; its license is preserved in `packages/plugin/plugin/LICENSE-OH-MY-OPENCODE-SLIM-MIT.txt`.
+
+The bundled LSP runtime at `packages/plugin/plugin/runtime/lsp.js` is derived from `code-yeongyu/oh-my-openagent`'s `lsp-tools-mcp`. Copyright (c) 2026 Yeongyu Kim; used under the MIT License preserved at `packages/plugin/plugin/runtime/LICENSE-LSP-MIT.txt`.

package/bin/holycodex.js

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-import "../plugin/runtime/cli.js";
+import "../dist/cli.js";