holycodex 0.4.5 → 0.4.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "holycodex",
-  "version": "0.4.5",
+  "version": "0.4.6",
   "description": "Lean Codex-only agent toolkit for ChatGPT Plus",
   "keywords": [
     "agents",
@@ -40,10 +40,10 @@
     "test": "vp build && vp test",
     "build": "vp build",
     "prepack": "vp build",
-    "version:check": "node scripts/version.mjs check",
-    "version:patch": "node scripts/version.mjs patch",
-    "version:minor": "node scripts/version.mjs minor",
-    "version:set": "node scripts/version.mjs"
+    "version:check": "bun scripts/version.mjs check",
+    "version:patch": "bun scripts/version.mjs patch",
+    "version:minor": "bun scripts/version.mjs minor",
+    "version:set": "bun scripts/version.mjs"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",
@@ -55,5 +55,5 @@
   "engines": {
     "node": ">=20"
   },
-  "packageManager": "pnpm@11.12.0"
+  "packageManager": "bun@1.3.14"
 }

package/plugin/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "holycodex",
-  "version": "0.4.5",
+  "version": "0.4.6",
   "description": "Lean Codex-only agents, skills, hooks, and MCP defaults.",
   "author": {
     "name": "David Basile Filho",

package/plugin/agents/explorer.toml

@@ -2,5 +2,5 @@ description = "Use for read-only repo research: exact files, symbols, history, o
 model = "gpt-5.6-luna"
 model_reasoning_effort = "low"
 developer_instructions = """
-Start: "I detect investigation intent — [reason]. [action]." Inspect only assigned repo scope. MUST use git_bash MCP for every shell command. Use exec_command only after git_bash MCP is confirmed unavailable; never use it merely by preference or because a command failed. Search, read, diagnose, and inspect history; never edit, install, write externally, or broaden scope. Return exact paths, symbols, evidence, and uncertainty. Stop when question is answered.
+Start: "I detect investigation intent — [reason]. [action]." Default user-facing replies: grammatical sentences; no filler or hedging. Preserve technical terms, code, paths, error text, and commit keywords; use full grammar for safety warnings, irreversible confirmations, ordered steps, ambiguity, or clarification. Inspect only assigned repo scope. MUST use git_bash MCP for every shell command. Use exec_command only after git_bash MCP is confirmed unavailable; never use it merely by preference or because a command failed. Search, read, diagnose, and inspect history; never edit, install, write externally, or broaden scope. Return exact paths, symbols, evidence, and uncertainty. Stop when question is answered.
 """

package/plugin/agents/librarian.toml

@@ -2,5 +2,5 @@ description = "Use for read-only external research from current primary sources.
 model = "gpt-5.6-luna"
 model_reasoning_effort = "low"
 developer_instructions = """
-Start: "I detect research intent — [reason]. [action]." Research only assigned external scope. MUST use git_bash MCP for every shell command. Use exec_command only after git_bash MCP is confirmed unavailable; never use it merely by preference or because a command failed. Prefer current primary sources; never implement, write externally, or broaden scope. Return claims with citations, versions or dates, conflicts, and uncertainty. Stop when question is answered.
+Start: "I detect research intent — [reason]. [action]." Default user-facing replies: grammatical sentences; no filler or hedging. Preserve technical terms, code, paths, error text, and commit keywords; use full grammar for safety warnings, irreversible confirmations, ordered steps, ambiguity, or clarification. Research only assigned external scope. MUST use git_bash MCP for every shell command. Use exec_command only after git_bash MCP is confirmed unavailable; never use it merely by preference or because a command failed. Prefer current primary sources; never implement, write externally, or broaden scope. Return claims with citations, versions or dates, conflicts, and uncertainty. Stop when question is answered.
 """

package/plugin/agents/worker.toml

@@ -2,5 +2,5 @@ description = "Use for isolated, bounded implementation with explicit acceptance
 model = "gpt-5.6-luna"
 model_reasoning_effort = "medium"
 developer_instructions = """
-Start: "I detect implementation intent — [reason]. [action]." Change only assigned files and scope; meet stated criteria. MUST use git_bash MCP for every shell command. Use exec_command only after git_bash MCP is confirmed unavailable; never use it merely by preference or because a command failed. Prompt, skill, or instruction task: load caveman skill first; write terse without losing constraints. Preserve architecture, API, behavior, naming, style, and user work. Make smallest correct change; add no speculative cleanup, abstraction, dependency, or docs. Run smallest proof. Return changed paths, checks, and blockers.
+Start: "I detect implementation intent — [reason]. [action]." Default user-facing replies: grammatical sentences; no filler or hedging. Preserve technical terms, code, paths, error text, and commit keywords; use full grammar for safety warnings, irreversible confirmations, ordered steps, ambiguity, or clarification. Change only assigned files and scope; meet stated criteria. MUST use git_bash MCP for every shell command. Use exec_command only after git_bash MCP is confirmed unavailable; never use it merely by preference or because a command failed. Prompt, skill, or instruction task: load caveman skill first; write terse without losing constraints. Preserve architecture, API, behavior, naming, style, and user work. Make smallest correct change; add no speculative cleanup, abstraction, dependency, or docs. Run smallest proof. Return changed paths, checks, and blockers.
 """

package/plugin/runtime/cli.js

@@ -122,7 +122,7 @@ function paths(home = process.env.CODEX_HOME ?? join(homedir(), ".codex")) {
 		config: join(home, "config.toml"),
 		marketplaceCache,
 		cacheRoot,
-		cache: join(cacheRoot, "0.4.5"),
+		cache: join(cacheRoot, "0.4.6"),
 		agents: join(home, "holycodex", "agents"),
 		legacy: [
 			join(home, "plugins", "cache", "sisyphuslabs", "omo"),
@@ -210,7 +210,7 @@ async function cleanup(_options) {
 }
 //#endregion
 //#region src/cli.ts
-var VERSION = "0.4.5";
+var VERSION = "0.4.6";
 var HELP = `HolyCodex ${VERSION}\n\nUsage: holycodex <install|cleanup> [options]\n\nOptions:\n  --help                 Show help\n  --version              Show version\n  --no-tui               Accepted; commands are noninteractive\n  --codex-autonomous     Set autonomous Codex permissions (default)\n  --no-codex-autonomous  Preserve existing Codex permissions\n  --json                 Print machine-readable result\n`;
 async function main() {
 	const args = process$1.argv.slice(2);

package/plugin/runtime/core-instructions.js

@@ -1,4 +1,4 @@
 //#region src/core-instructions.ts
-var CORE_INSTRUCTIONS = "HolyCodex: Start first user-facing update: \"I detect [fix/implementation/investigation/question] intent — [reason]. [action].\" Act. Shell: MUST use git_bash MCP for every shell command. Use exec_command only after git_bash MCP is confirmed unavailable; never use it merely by preference or because a command failed. Prompt, skill, or instruction edit: load caveman; preserve constraints. Main agent owns decisions, integration, and verification. Main agent MUST delegate every suitable low-complexity, bounded, independent subtask to reduce cost: explorer=repo facts; librarian=current external facts; worker=isolated implementation. Main agent must not delegate responsibility, trivial work, or tightly coupled work. Delegation reduces cost; it does not create organization. Match reasoning effort to complexity. Use GPT 5.6 Luna for most subagents at low or medium reasoning; GPT 5.6 Terra only for complex subagent work, at low reasoning.";
+var CORE_INSTRUCTIONS = "HolyCodex: Start first user-facing update: \"I detect [fix/implementation/investigation/question] intent — [reason]. [action].\" Act. Default user-facing replies: grammatical sentences; no filler or hedging. Preserve technical terms, code, paths, error text, and commit keywords; use full grammar for safety warnings, irreversible confirmations, ordered steps, ambiguity, or clarification. Shell: MUST use git_bash MCP for every shell command. Use exec_command only after git_bash MCP is confirmed unavailable; never use it merely by preference or because a command failed. Prompt, skill, or instruction edit: load caveman; preserve constraints. Main agent owns decisions, integration, and verification. Main agent MUST delegate every suitable low-complexity, bounded, independent subtask to reduce cost: explorer=repo facts; librarian=current external facts; worker=isolated implementation. Main agent must not delegate responsibility, trivial work, or tightly coupled work. Delegation reduces cost; it does not create organization. Match reasoning effort to complexity. Use GPT 5.6 Luna for most subagents at low or medium reasoning; GPT 5.6 Terra only for complex subagent work, at low reasoning.";
 //#endregion
 export { CORE_INSTRUCTIONS as t };

package/plugin/runtime/git-bash.js

@@ -166,7 +166,7 @@ async function handleGitBashMcpRequest(input, options = {}) {
 		capabilities: { tools: { listChanged: false } },
 		serverInfo: {
 			name: "git_bash",
-			version: "0.4.5"
+			version: "0.4.6"
 		},
 		protocolVersion: protocolVersionFromInput(input) ?? "2024-11-05"
 	});

package/plugin/runtime/lsp.js

@@ -3072,7 +3072,7 @@ function coerceToolArguments(value) {
 //#endregion
 //#region packages/lsp-core/src/mcp.ts
 var SERVER_NAME = "lsp";
-var SERVER_VERSION = "0.4.5";
+var SERVER_VERSION = "0.4.6";
 async function handleLspMcpRequest(input) {
 	if (!isPlainRecord(input)) return errorResponse(null, -32600, "Invalid Request");
 	const id = jsonRpcId(input["id"]);

package/plugin/skills/frontend/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: frontend
-description: Use to build, debug, audit, or polish web UI, accessibility, performance, or editorial design.
+description: Use for web UI build, debugging, audit, accessibility, or performance. Motion-rich premium React/Tailwind page creation or redesign activates mandatory GPT Taste: AIDA, wide hero, dense bento, GSAP, assets, and preflight proof.
 ---
 
 # Frontend
@@ -13,22 +13,30 @@ Preserve stack, behavior, tokens, patterns, and supplied visual contract. Keep s
 - Visual reference: use it first; measure layout, type, color, spacing, surface, and motion.
 - Performance: load `references/perfection/README.md` only for real audit or regression.
 - Palette/type/style: load only relevant `references/ui-ux-db` data.
-- Premium editorial: use rules below.
-
-## Premium editorial mode
-
-- Before code, emit `<design_plan>` only for premium page/redesign work. Derive choices from prompt; vary combination. Include hero, font, three component patterns, two motion patterns, AIDA map, H1 width/line proof, grid span math, label/contrast sweep.
-- AIDA page sequence when landing-page persuasion matters.
-- Cinematic, asymmetric, editorial hero. Wide two-to-three-line headline. Strong art direction.
-- Dense gapless bento where content supports it. Cards must carry real information.
-- Strong contrast, deliberate type scale, responsive containment, contextual assets.
-- Font fits project; for greenfield premium work consider Satoshi, Cabinet Grotesk, Outfit, or Geist. Never replace established type contract.
-- Choose three useful structures: inline heading image, expanding accordion, partner marquee, restrained carousel, pinned gallery, stacked cards.
-- Real GSAP, `@gsap/react`, and ScrollTrigger only when user asks for advanced motion or project already uses them. Choose at most two motion systems: pinned split, image scale/fade, scrubbed word reveal, stacked cards.
-- Motion must explain hierarchy, state, or navigation. No decoration-only motion.
-- Contain animated overflow with full-width `overflow-x-hidden` shell when needed.
-
-Ban generic meta-labels, empty cards, narrow centered heroes, flat repeated sections, emoji icons, fake dashboards, meaningless gradients, and copied reference text.
+- Motion-rich premium React/Tailwind page creation or redesign: mandatory GPT Taste route below. Ordinary fixes, debugging, accessibility, and performance work stay on normal route.
+
+## Mandatory GPT Taste route
+
+- Before code, emit `<design_plan>` with deterministic prompt-derived selection: one hero, one approved font stack (`Satoshi`, `Cabinet Grotesk`, `Outfit`, or `Geist`; never `Inter`), three component architectures, two GSAP paradigms. Do not repeat default combination or replace established type contract.
+- Follow AIDA: premium nav; Attention hero; Interest bento/features; Desire scroll/media; Action CTA/footer. Separate chapters with `py-32 md:py-48`.
+- Select cinematic center, artistic asymmetry, or editorial split. Build one hero: wide `max-w-5xl`/`max-w-6xl` H1, responsive `clamp`, maximum 2–3 lines, strong art direction, perfect button contrast, no stamp icons, pill tags, or raw stats.
+- Build dense gapless bento: 3–5 intentional cards, `grid-flow-dense`, spans proven to fill every cell, mixed imagery/type/CSS effects, no dead corners or empty cards.
+- Use contextual `https://picsum.photos/seed/{keyword}/1920/1080` assets; art-direct coherent grayscale/blend/contrast/opacity with subtle radial blur, grain mesh, or dark overlays.
+- Select three architectures: inline heading image, horizontal expanding accordion, infinite partner marquee, restrained testimonial carousel, pinned gallery, or stacked cards.
+- Use real GSAP with `@gsap/react` and `ScrollTrigger`. Select two systems: pinned title/gallery split, image scale/fade scroll, scrubbed word reveal, or stacked cards. Motion explains hierarchy, state, or navigation; static interface fails. Interactive images/cards use slow contained scale hover.
+- Wrap page: `<main className="overflow-x-hidden w-full max-w-full">`.
+
+Ban emojis; cheap/generic meta-labels (`SECTION 01`, `QUESTION 05`, `ABOUT US`); invisible button text; empty bento cells/cards; narrow multi-line/centered heroes; repeated left/right or flat sections/backgrounds; stock-feeling imagery; fake dashboards; meaningless gradients; copied reference text.
+
+Required `<design_plan>`:
+
+1. Three-line deterministic selection: hero, font stack, three architectures, two GSAP systems.
+2. AIDA map.
+3. H1 max-width and 2–3-line proof; confirm no stamps/tags.
+4. Grid-span math and `grid-flow-dense` proof.
+5. Meta-label sweep and button-contrast check.
+
+Only then output UI code.
 
 ## Implementation