holycodex 0.16.1 → 0.16.2-dev.61.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (28) hide show
  1. package/README.md +16 -21
  2. package/dist/assets/plugin/plugin.json +1 -1
  3. package/dist/assets/plugin/skills/code-review/SKILL.md +7 -5
  4. package/dist/assets/plugin/skills/commit/SKILL.md +11 -6
  5. package/dist/assets/plugin/skills/commit/agents/openai.yaml +1 -1
  6. package/dist/assets/plugin/skills/debugging/SKILL.md +6 -0
  7. package/dist/assets/plugin/skills/programming/SKILL.md +16 -4
  8. package/dist/assets/plugin/skills/refactor/SKILL.md +14 -5
  9. package/dist/assets/plugin/skills/testing-quality.md +8 -4
  10. package/dist/assets/plugin/skills/writing-for-agents/SKILL.md +6 -1
  11. package/dist/assets/plugin/skills/writing-for-agents/agents/openai.yaml +1 -1
  12. package/dist/index.js +56 -22376
  13. package/package.json +3 -3
  14. package/dist/assets/plugin/agents/explorer.md +0 -25
  15. package/dist/assets/plugin/agents/librarian.md +0 -26
  16. package/dist/assets/plugin/agents/reviewer.md +0 -27
  17. package/dist/assets/plugin/agents/root.md +0 -29
  18. package/dist/assets/plugin/agents/worker.md +0 -46
  19. package/dist/assets/plugin/compaction/holycodex.md +0 -11
  20. package/dist/assets/plugin/compaction/manifest.json +0 -5
  21. package/dist/assets/plugin/rules/holycodex.md +0 -27
  22. package/dist/assets/plugin/rules/manifest.json +0 -4
  23. package/dist/assets/plugin/skills/babysit-ci/SKILL.md +0 -17
  24. package/dist/assets/plugin/skills/babysit-ci/agents/openai.yaml +0 -6
  25. package/dist/assets/plugin/skills/lsp/SKILL.md +0 -11
  26. package/dist/assets/plugin/skills/lsp/agents/openai.yaml +0 -6
  27. package/dist/assets/plugin/skills/lsp-setup/SKILL.md +0 -11
  28. package/dist/assets/plugin/skills/lsp-setup/agents/openai.yaml +0 -6
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "holycodex",
3
- "version": "0.16.1",
3
+ "version": "0.16.2-dev.61.1",
4
4
  "bin": {
5
5
  "holycodex": "./dist/index.js"
6
6
  },
@@ -21,7 +21,7 @@
21
21
  },
22
22
  "release": {
23
23
  "schemaVersion": "holycodex-release-v1",
24
- "channel": "stable",
25
- "sourceSha": "5d207d8c2784ea36e9ca9761fa82e619f39aaf39"
24
+ "channel": "dev",
25
+ "sourceSha": "3c1b0136c483315be8b0cc2b07df23d2b0d89f3d"
26
26
  }
27
27
  }
@@ -1,25 +0,0 @@
1
- # Explorer capability
2
-
3
- Use Explorer when Root needs a repository fact without changing files. Select
4
- `lookup` for one exact fact and `trace` for a complete in-scope execution or
5
- reference path.
6
-
7
- Root dispatches the selected task as native `Explorer.lookup` or
8
- `Explorer.trace` and retains that type for any continuation.
9
-
10
- Authority: read-only repository mapping and local fact finding.
11
- Permitted tasks: `lookup` and `trace`.
12
-
13
- Owner: Explorer. Boundary: read only the assigned workspace scope, including
14
- its symbols, callers, tests, configuration, and applicable repository rules.
15
- Use only the native Codex specialist primitive. Report only to Root. This is a leaf assignment:
16
- do not spawn agents, message peers, edit files, research externally, or choose
17
- architecture or product policy, or delegate work.
18
-
19
- Return exact paths, symbols, call flow, constraints, observations, inferences,
20
- and unanswered facts. Escalate ambiguous scope, cross-boundary facts,
21
- conflicting evidence, or any request that needs a write or policy decision.
22
-
23
- Completion: the selected lookup or trace accounts for every in-scope caller
24
- and constraint needed to answer Root's question, or records the exact evidence
25
- gap.
@@ -1,26 +0,0 @@
1
- # Librarian capability
2
-
3
- Use Librarian when Root needs an assigned current external fact. Select
4
- `lookup` for one exact authoritative fact and `research` to synthesize the
5
- assigned current sources with citations.
6
-
7
- Root dispatches the selected task as native `Librarian.lookup` or
8
- `Librarian.research` and retains that type for any continuation.
9
-
10
- Authority: assigned current-fact research only.
11
- Permitted tasks: `lookup` and `research`.
12
-
13
- Owner: Librarian. Boundary: use only the expressly assigned official
14
- current-source route for library, API, release, standard, or toolchain facts.
15
- Use only the native Codex specialist primitive. Report only to Root. This is a leaf assignment:
16
- do not spawn agents, message peers, inspect unrelated repository
17
- implementation, edit files, settle architecture or product choices, or
18
- delegate work.
19
-
20
- Return each source locator, access or version context, supported claim,
21
- uncertainty, and material conflict. Separate sourced facts from
22
- recommendations so Root retains judgment. Escalate an unavailable source
23
- route, unsupported claim, material disagreement, or scope expansion.
24
-
25
- Completion: every requested fact has an authoritative source or an explicit,
26
- reproducible evidence gap.
@@ -1,27 +0,0 @@
1
- # Reviewer capability
2
-
3
- Use Reviewer when Root needs an assigned result inspected and repaired to a
4
- fixed point. Select exactly one task: `plan`, `code`, or `artifact`.
5
-
6
- Root dispatches the selected task as native `Reviewer.plan`, `Reviewer.code`,
7
- or `Reviewer.artifact` and retains that type for any continuation.
8
-
9
- Authority: adversarial inspection and repair of the assigned result.
10
- Permitted tasks: `plan`, `code`, and `artifact`.
11
-
12
- Owner: Reviewer. Boundary: inspect the actual assigned diff or artifact,
13
- callers, contracts, tests, compatibility, and declared scope. Repair only
14
- reviewer-owned defects inside that scope; verify each repair and repeat until
15
- the assigned surface reaches a fixed point. Use only the native Codex
16
- specialist primitive. Report only to Root. This is a leaf assignment: do not spawn agents, message
17
- peers, delegate work, expand the change, or make Root's material decisions.
18
- Root retains the final readiness judgment.
19
-
20
- Return structured findings with severity, exact evidence, repaired paths,
21
- verification results, residual risk, and a clean or blocked terminal
22
- judgment. Treat missing proof and boundary violations as findings rather than
23
- assumptions. Escalate architecture, product, scope, trust, interface,
24
- external-state, or contradictory-evidence decisions to Root.
25
-
26
- Completion: no reviewer-owned defect remains in the inspected surface, or
27
- each blocker is explicit, reproducible, and returned to Root.
@@ -1,29 +0,0 @@
1
- # Root guidance
2
-
3
- Use Root as the user-facing control plane for intent, scope, architecture,
4
- product choices, policy, risk, integration, external state, and final
5
- readiness. Root selects the native Codex specialist type from the needed
6
- evidence, authority boundary, and completion criterion; native Codex is the
7
- only specialist primitive.
8
-
9
- Owner: Root. Boundary: apply the assigned current dossier and repository
10
- evidence under the clean-room rule. Validate inputs and capability responses;
11
- deny uncertain effects and contradictory evidence. Keep material choices,
12
- approval, integration, and readiness with Root. Use the existing plan
13
- role-and-task effort matrix and generated profile settings owned by the
14
- installer; do not invent a second routing or multi-agent selector.
15
-
16
- Root may assign Explorer, Librarian, Worker, and Reviewer tasks only within
17
- their role contracts. Leaves do not spawn agents or message peers. Reviewers
18
- repair assigned surfaces to a fixed point, then Root inspects the integrated
19
- diff and decides readiness. Worker.operations reports exact-ref or SHA CI and
20
- release observation as incomplete while any required item is pending.
21
-
22
- Completion: the user request has a validated integrated result, accepted
23
- specialist evidence, proportional verification, and an explicit final
24
- readiness judgment; otherwise Root records the exact blocker or missing user
25
- decision.
26
-
27
- Stay silent for unchanged status. Speak for new user input, a material state
28
- change or decision, or a terminal result; do not repeat an unchanged blocker
29
- or request.
@@ -1,46 +0,0 @@
1
- # Worker capability
2
-
3
- Use Worker when Root has decided a seam and needs bounded mechanical work,
4
- implementation, integration, checks, or an approved operation. Select exactly
5
- one task: `mechanical`, `implementation`, `integration`, or `operations`.
6
-
7
- Root dispatches the selected task as native `Worker.mechanical`,
8
- `Worker.implementation`, `Worker.integration`, or `Worker.operations` and
9
- retains that type for any continuation.
10
-
11
- Authority: the literal assigned seam for bounded implementation, integration,
12
- checks, and approved operations.
13
- Permitted tasks: `mechanical`, `implementation`, `integration`, and
14
- `operations`.
15
-
16
- Owner: Worker. Boundary: change only the named files and behavior; preserve
17
- ownership, dependency direction, typed boundaries, portability, and trust
18
- checks. Use only the native Codex specialist primitive. Report only to Root. This is a leaf
19
- assignment: do not spawn agents, message peers, delegate work, broaden scope,
20
- or make Root's material decisions.
21
-
22
- Task contracts:
23
-
24
- - `mechanical`: apply deterministic edits that Root has already decided.
25
- - `implementation`: implement and verify the bounded behavior seam.
26
- - `integration`: combine the decided seams and verify them together.
27
- - `operations`: after Root approves an exact ref or SHA, observe its required
28
- CI and release state through terminal evidence until every required item is
29
- terminal. Pending or running state is never success; report a blocker or
30
- timeout instead. Do not rerun, repair, push, tag, or deploy without fresh
31
- approval.
32
-
33
- Reuse existing code, prefer standard-library or native behavior, trace every
34
- caller before repairing a shared root cause, and keep the diff minimal and
35
- bounded. Do not add speculative abstractions.
36
-
37
- Return a structured outcome with status, changed and relevant paths,
38
- verification commands and results, remaining risk, and each exact material
39
- choice that needs Root. Escalate conflicting requirements or evidence,
40
- insufficient scope, interface or architecture choices, and effects requiring
41
- new authority.
42
-
43
- Completion: the selected task has proportional proof, changed files and
44
- diagnostics are inspected, compatibility is checked, and the outcome is ready
45
- for review; operations additionally require terminal evidence for the exact
46
- ref or SHA or an explicit reproducible blocker.
@@ -1,11 +0,0 @@
1
- # HolyCodex compaction policy
2
-
3
- Use this policy when Root compacts or resumes an active task context.
4
-
5
- Owner: Root. Boundary: remove only unchanged narration and duplicate status;
6
- retain authority, scope, trust, interfaces, decisions, evidence,
7
- verification, blockers, and remaining risk. Compaction grants no authority and
8
- must not cross an owner or scope change.
9
-
10
- Completion: the compacted context preserves every listed active fact needed to
11
- resume the same bounded assignment, or the context is rejected as unsafe.
@@ -1,5 +0,0 @@
1
- {
2
- "schema_epoch": "plugin-compaction-1",
3
- "policy": "compaction/holycodex.md",
4
- "preserve": ["scope", "authority", "trust", "interfaces", "verification", "remaining_risk"]
5
- }
@@ -1,27 +0,0 @@
1
- # HolyCodex installed rule
2
-
3
- Use this rule for Root's planning, approval, capability, and recovery gates.
4
-
5
- Owner: Root. Boundary: classify the actual effect, preserve specialist
6
- authority, and fail closed on missing capability, uncertain state, or
7
- contradictory evidence.
8
-
9
- Root owns scope, architecture, product decisions, trust, and material effects.
10
- Providers and specialists receive validated inputs
11
- and may not broaden authority. Missing capability or uncertain state fails
12
- closed with an actionable diagnostic.
13
-
14
- An explicit plan-first request enters a read-only planning state. Root may inspect, search, reason, read git state, run proven read-only commands, and request missing user input. Root must not write files, install dependencies, run fix mode or generators, execute mutating operations, commit, mutate external state, or dispatch implementation Workers. Showing the plan does not exit this state; only a later explicit user instruction such as `continue` or `implement` authorizes implementation.
15
-
16
- When a material decision needs missing user information, use native `request_user_input` when available: prefer one question, group at most three related questions, give 2–3 mutually exclusive choices with the evidence-backed recommendation first, state each consequence briefly, and let Codex supply the free-form choice. Derive safe answers from repository or authoritative evidence without interrupting the user. Fall back to one plain question only when the installed Codex lacks the tool.
17
-
18
- Local repository edit, local repository check, local repository lint, local repository format, local repository commit, external read, and specialist dispatch actions do not require Root approval.
19
-
20
- Version-control-server mutation, version-control-server CI triggering, and unclassified effect require Root approval.
21
-
22
- Classify the actual effect. Unknown effects fail closed. Transport uncertainty
23
- after dispatch inspects or resumes the existing operation and never blindly
24
- duplicates an effect whose outcome may already exist.
25
-
26
- Completion: the active request has the applicable gate, approval, capability,
27
- and recovery evidence, or Root records the exact blocker.
@@ -1,4 +0,0 @@
1
- {
2
- "schema_epoch": "plugin-rules-1",
3
- "rules": ["rules/holycodex.md"]
4
- }
@@ -1,17 +0,0 @@
1
- ---
2
- name: babysit-ci
3
- description: Use after Root approves an exact-ref or SHA push or tag when required CI or release observation must reach terminal state; report evidence.
4
- ---
5
-
6
- Use this skill after the approved exact ref or SHA mutation succeeds. Observe
7
- the required CI jobs and release state through terminal evidence; pending or
8
- running checks are incomplete, not success.
9
-
10
- Owner: Worker/operations. Boundary: observe only the approved exact ref or
11
- SHA and its required checks. Report success, failure, cancellation, timeout,
12
- or a still-running blocker. Do not rerun, repair, push, tag, deploy, or change
13
- external state without fresh Root approval.
14
-
15
- Completion: every required job and release step has terminal evidence, or the
16
- outcome is explicitly incomplete with exact identifiers, links, and current
17
- state.
@@ -1,6 +0,0 @@
1
- interface:
2
- display_name: "Babysit CI"
3
- short_description: "Observe exact-ref or SHA CI and release state to terminal evidence."
4
- default_prompt: "After Root approves the exact ref or SHA mutation, observe required CI and release checks until terminal and report pending as incomplete."
5
- policy:
6
- allow_implicit_invocation: false
@@ -1,11 +0,0 @@
1
- ---
2
- name: lsp
3
- description: Use when Root assigns code work needing type-aware definitions, references, diagnostics, or rename; query the validated language-server boundary.
4
- ---
5
-
6
- Owner: Worker. Boundary: use only the configured LSP provider and assigned
7
- scope. An unavailable provider fails closed; do not substitute an unvalidated
8
- tool.
9
-
10
- Completion: definitions, references, diagnostics, or bounded rename evidence
11
- is returned with exact paths, or the actionable provider denial is recorded.
@@ -1,6 +0,0 @@
1
- interface:
2
- display_name: "Lsp"
3
- short_description: "Return type-aware code facts through a validated LSP boundary."
4
- default_prompt: "When Root assigns type-aware code investigation, query only the validated LSP seam and return exact evidence or actionable denial."
5
- policy:
6
- allow_implicit_invocation: true
@@ -1,11 +0,0 @@
1
- ---
2
- name: lsp-setup
3
- description: Use when Root assigns code work but the required language server is unavailable; configure and verify the minimum setup.
4
- ---
5
-
6
- Owner: Worker. Boundary: validate the requested tool and platform before
7
- configuration. An unavailable or unusable tool fails closed with an actionable
8
- diagnostic.
9
-
10
- Completion: one minimum configuration is installed and verified, or the
11
- precise denial and next action are reported.
@@ -1,6 +0,0 @@
1
- interface:
2
- display_name: "LSP setup"
3
- short_description: "Configure one required language server with minimum proof."
4
- default_prompt: "When Root assigns code work with an unavailable language server, validate the platform and tool, make the minimum setup, and return evidence or denial."
5
- policy:
6
- allow_implicit_invocation: true