holycodex 0.3.0 → 0.3.2

package/README.md

@@ -79,20 +79,6 @@ Cleanup backs up affected files, removes only HolyCodex-owned configuration and
 - `packages/` — Git Bash and LSP MCP source.
 - `test/` — CLI, lifecycle, catalogue, rules, bootstrap, and MCP tests.
 
-### Versioning for maintainers
-
-HolyCodex follows [ZeroVer](https://0ver.org/): versions stay below `1.0.0`; fixes increment the third component, while breaking changes increment the second.
-
-```sh
-npm run version:check       # verify every package/runtime version matches
-npm run version:patch       # compatible release: 0.2.0 -> 0.2.1
-npm run version:minor       # breaking release: 0.2.7 -> 0.3.0
-npm run version:set -- 0.4.3
-node scripts/version.mjs patch --dry-run
-```
-
-The helper updates the root package, plugin manifest, private workspace packages, CLI/cache version, MCP server versions, and pinned tests together. It does not commit, tag, publish, or push. After a bump, review the diff and run the four checks printed by the command.
-
 ## Thanks
 
 HolyCodex exists because of the work of:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "holycodex",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Lean Codex-only agent toolkit for ChatGPT Plus",
   "keywords": [
     "agents",

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

@@ -1,6 +1,6 @@
 {
   "name": "holycodex",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "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 = "Read-only internal repository explorer. Use for a narrow unfamili
 model = "gpt-5.6-luna"
 model_reasoning_effort = "low"
 developer_instructions = """
-Inspect assigned internal area only. Use the git_bash MCP for every shell command. Read-only: search, read, diagnostics, history. No edit, install, external write, or subagent. Do not broaden scope. Return concise findings with exact paths, symbols, evidence, uncertainty. Stop when assigned question answered.
+Start: "I detect investigation intent — [reason]. [action]." Inspect assigned internal area only. Use git_bash MCP for every shell command. Read-only: search, read, diagnostics, history. No edit, install, external write, or subagent. Do not broaden scope. Return concise findings with exact paths, symbols, evidence, uncertainty. Stop when assigned question answered.
 """

package/plugin/agents/librarian.toml

@@ -2,5 +2,5 @@ description = "Read-only external-source researcher. Use when current primary do
 model = "gpt-5.6-luna"
 model_reasoning_effort = "low"
 developer_instructions = """
-Research assigned external sources only. Use the git_bash MCP for every shell command. Read-only. Prefer primary current sources. No implementation, external write, or subagent. Do not broaden query. Return concise claim, citation, version/date, conflict, uncertainty. Stop when assigned question answered.
+Start: "I detect research intent — [reason]. [action]." Research assigned external sources only. Use git_bash MCP for every shell command. Read-only. Prefer primary current sources. No implementation, external write, or subagent. Do not broaden query. Return concise claim, citation, version/date, conflict, uncertainty. Stop when assigned question answered.
 """

package/plugin/agents/worker.toml

@@ -2,5 +2,5 @@ description = "Isolated implementation worker. Use only for a bounded independen
 model = "gpt-5.6-luna"
 model_reasoning_effort = "medium"
 developer_instructions = """
-Implement only explicit files, scope, acceptance criteria. Use the git_bash MCP for every shell command. Preserve architecture, API, behavior, naming, style. Smallest correct change. No speculative cleanup, abstraction, dependency, docs, or subagent. Respect user work. Run smallest targeted proof. Return changed paths, checks, blocker.
+Start: "I detect implementation intent — [reason]. [action]." Implement only explicit files, scope, acceptance criteria. Use git_bash MCP for every shell command. Prompt, skill, or instruction task: load caveman skill first; write terse without losing constraints. Preserve architecture, API, behavior, naming, style. Smallest correct change. No speculative cleanup, abstraction, dependency, docs, or subagent. Respect user work. Run smallest targeted proof. Return changed paths, checks, blocker.
 """

package/plugin/runtime/bootstrap.js

@@ -1,3 +1,4 @@
+import { t as CORE_INSTRUCTIONS } from "./core-instructions-CKS8xwZK.js";
 import { access } from "node:fs/promises";
 import { join } from "node:path";
 //#region src/bootstrap.ts
@@ -14,7 +15,8 @@ async function readinessContext(pluginRoot) {
 		if (error instanceof Error && "code" in error && error.code === "ENOENT") missing.push(file);
 		else throw error;
 	}
-	return missing.length === 0 ? "" : `HolyCodex incomplete: missing runtime/${missing.join(", runtime/")}. Reinstall HolyCodex before using its local MCPs or hooks.`;
+	if (missing.length === 0) return CORE_INSTRUCTIONS;
+	return `${CORE_INSTRUCTIONS}\n\nHolyCodex incomplete: missing runtime/${missing.join(", runtime/")}. Reinstall HolyCodex before using its local MCPs or hooks.`;
 }
 //#endregion
 //#region src/bootstrap-cli.ts

package/plugin/runtime/cli.js

@@ -120,7 +120,7 @@ function paths(home = process.env.CODEX_HOME ?? join(homedir(), ".codex")) {
 		home,
 		config: join(home, "config.toml"),
 		cacheRoot,
-		cache: join(cacheRoot, "0.3.0"),
+		cache: join(cacheRoot, "0.3.2"),
 		agents: join(home, "holycodex", "agents"),
 		legacy: [
 			join(home, "plugins", "cache", "sisyphuslabs", "omo"),
@@ -208,7 +208,7 @@ async function cleanup(_options) {
 }
 //#endregion
 //#region src/cli.ts
-var VERSION = "0.3.0";
+var VERSION = "0.3.2";
 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\n  --json              Print machine-readable result\n`;
 async function main() {
 	const args = process$1.argv.slice(2);

package/plugin/runtime/core-instructions-CKS8xwZK.js

@@ -0,0 +1,4 @@
+//#region src/core-instructions.ts
+var CORE_INSTRUCTIONS = "HolyCodex core: Start first user-facing update: \"I detect [fix/implementation/investigation/pure question] intent — [reason]. [action].\" Then act. Use git_bash MCP for every shell command. Use exec_command only when git_bash is unavailable or work is not a shell command. Prompt, skill, or instruction task: load caveman skill first; write terse without losing constraints. Primary agent keeps control. Subagents reduce cost, never simulate an organization. Delegate bounded labor, never responsibility. Spend intelligence only where complexity requires it.";
+//#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.3.0"
+			version: "0.3.2"
 		},
 		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.3.0";
+var SERVER_VERSION = "0.3.2";
 async function handleLspMcpRequest(input) {
 	if (!isPlainRecord(input)) return errorResponse(null, -32600, "Invalid Request");
 	const id = jsonRpcId(input["id"]);

package/plugin/runtime/rules.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { t as CORE_INSTRUCTIONS } from "./core-instructions-CKS8xwZK.js";
 import { mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
 import { dirname, isAbsolute, join, relative, resolve } from "node:path";
 import { stdin, stdout } from "node:process";
@@ -44,7 +45,10 @@ async function runRulesHook(input) {
 	const cache = cachePath(input.session_id);
 	if (event === "PostCompact") {
 		await rm(cache, { force: true });
-		return "";
+		return `${JSON.stringify({ hookSpecificOutput: {
+			hookEventName: event,
+			additionalContext: CORE_INSTRUCTIONS
+		} })}\n`;
 	}
 	const target = event === "PostToolUse" ? editPath(input.tool_input, input.cwd) : void 0;
 	if (event === "PostToolUse" && target === void 0) return "";