genesis-compiler 1.7.4 → 1.7.5

package/docs/prompt-integration.md

@@ -198,6 +198,15 @@ init`. All receive the same short operating guide for a new session and after
 compaction. The Codex session hook sets `additionalContextLimit: 0` so native
 truncation cannot remove part of the bounded guide or host contribution.
 Codex and Claude Code use `SessionStart` for startup, resume, clear, and compact events.
+Claude's generated session hooks use `genesis hook session --claude-part <1-4>`.
+Claude caps each hook output at 10,000 characters, so four hooks deliver the
+unchanged guide in numbered parts below that limit. Empty parts emit nothing.
+A guide above 36,000 characters delivers an explicit guidance-unavailable
+warning instead of a partial guide. Claude does not enforce startup hook stop
+requests; this warning instructs the model to report the problem before work,
+and is not a runtime admission control. Turn guidance is already bounded at 512
+bytes and uses the ordinary turn command. This is provider transport only;
+composition and the host bridge remain shared.
 Claude settings preserve unrelated hooks and configuration. The common operating
 guide lists installed project skills and their canonical `.agents/skills/` paths;
 an agent reads the relevant skill before following its workflow. Genesis exposes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "genesis-compiler",
-  "version": "1.7.4",
+  "version": "1.7.5",
   "type": "module",
   "description": "An agent-independent prompt, multi-language code-index, cleanup, and verification companion with project agent guidance.",
   "repository": {

package/src/cli.js

@@ -88,6 +88,7 @@ Options:
   --directory <path>     Parser cache directory (parsers commands only)
   --all                  Select every parser (parsers install/verify only)
   --json                 Emit one machine-readable result
+  --claude-part <1-4>    Emit one bounded Claude session-hook part
   -h, --help             Show this help
 
 Genesis generates prompts; it never starts or manages an AI agent. Give the
@@ -111,6 +112,7 @@ function parseCommand(argv) {
       strict: true,
       options: {
         json: { type: 'boolean', default: false },
+        'claude-part': { type: 'string' },
         all: { type: 'boolean', default: false },
         directory: { type: 'string' },
         'project-root': { type: 'string' },
@@ -124,6 +126,7 @@ function parseCommand(argv) {
   }
   const options = {
     json: parsed.values.json,
+    claudePart: parsed.values['claude-part'],
     all: parsed.values.all,
     directory: parsed.values.directory,
     projectRoot: parsed.values['project-root'],
@@ -138,6 +141,9 @@ function parseCommand(argv) {
     task: parsed.values.task,
   };
   const operands = parsed.positionals;
+  if (options.claudePart !== undefined && (command !== 'hook' || operands[0] !== 'session' || !/^[1-4]$/u.test(options.claudePart) || options.json)) {
+    fail('CLI_OPTION_NOT_APPLICABLE', 'Option --claude-part requires hook session, a part from 1 to 4, and no --json.');
+  }
   if (command !== 'parsers' && (options.all || options.directory !== undefined)) {
     fail('CLI_OPTION_NOT_APPLICABLE', 'Options --all and --directory apply only to parsers commands.');
   }
@@ -665,9 +671,24 @@ export async function runCli(argv = process.argv.slice(2)) {
       projectFormat,
       formatDiagnostic,
     );
-    if (options.json) line(process.stdout, JSON.stringify(result));
-    else {
-      writeResult(parsed.command, result);
+    if (options.claudePart !== undefined) {
+      // Claude spills each hook output over 10,000 characters to a file.
+      // Four native hooks deliver the exact text in bounded parts instead.
+      if (result.output.length > 36000) {
+        if (options.claudePart === '1') line(process.stdout,
+          'GENESIS GUIDANCE UNAVAILABLE: The session guide exceeds the Claude hook capacity of 36,000 characters. The guide was not delivered. Tell the user before doing project work. Shorten the project guidance and restart the conversation to load it completely.');
+        return 0;
+      }
+      let start = (Number(options.claudePart) - 1) * 9000;
+      let end = start + 9000;
+      // Keep UTF-16 surrogate pairs together at the shared part boundaries.
+      if (/[\uDC00-\uDFFF]/u.test(result.output[start] || '')) start--;
+      if (/[\uDC00-\uDFFF]/u.test(result.output[end] || '')) end--;
+      const part = result.output.slice(start, end);
+      if (part) process.stdout.write(`Genesis session guidance, part ${options.claudePart} of ${Math.ceil(result.output.length / 9000)} (read in numeric order):\n${part}`);
+    } else if (options.json) line(process.stdout, JSON.stringify(result));
+    else writeResult(parsed.command, result);
+    if (!options.json) {
       for (const warning of result.warnings || []) {
         if (warning.code !== formatDiagnostic?.code) line(process.stderr, `WARNING: ${warning.code}: ${warning.message}`);
       }

package/src/index/claude-hooks.js

@@ -7,8 +7,11 @@ import { genesisHookCommand } from './hook-command.js';
 import { writeFileAtomic } from './utils.js';
 
 const SETTINGS_PATH = '.claude/settings.json';
-const SESSION_COMMAND = genesisHookCommand('session');
+const SESSION_COMMANDS = [1, 2, 3, 4].map((claudePart) => genesisHookCommand('session', { claudePart }));
 const TURN_COMMAND = genesisHookCommand('turn');
+// Refresh exact generated commands, including the previous plain-text output.
+const OWNED_COMMANDS = new Set([...SESSION_COMMANDS, TURN_COMMAND,
+  genesisHookCommand('session')]);
 
 async function renderedSettings(projectRoot) {
   const root = (await gitContext(projectRoot)).repositoryRoot;
@@ -34,13 +37,13 @@ async function renderedSettings(projectRoot) {
     }
     value.hooks[event] = groups.flatMap((group) => {
       if (!Array.isArray(group?.hooks)) return [group];
-      const hooks = group.hooks.filter((hook) => ![SESSION_COMMAND, TURN_COMMAND].includes(hook?.command));
+      const hooks = group.hooks.filter((hook) => !OWNED_COMMANDS.has(hook?.command));
       return hooks.length ? [{ ...group, hooks }] : [];
     });
   }
   (value.hooks.SessionStart ||= []).push({
     matcher: '^(startup|resume|clear|compact)$',
-    hooks: [{ type: 'command', command: SESSION_COMMAND, timeout: 30 }],
+    hooks: SESSION_COMMANDS.map((command) => ({ type: 'command', command, timeout: 30 })),
   });
   (value.hooks.UserPromptSubmit ||= []).push({
     hooks: [{ type: 'command', command: TURN_COMMAND, timeout: 30 }],

package/src/index/hook-command.js

@@ -1,4 +1,4 @@
-export function genesisHookCommand(action) {
-  const local = `const {runCli}=await import('genesis-compiler/cli');process.exitCode=await runCli(['hook','${action}'])`;
-  return `if command -v genesis >/dev/null 2>&1; then genesis hook ${action}; else node --input-type=module --eval "${local}"; fi`;
+export function genesisHookCommand(action, { claudePart } = {}) {
+  const local = `const {runCli}=await import('genesis-compiler/cli');process.exitCode=await runCli(['hook','${action}'${claudePart ? `,'--claude-part','${claudePart}'` : ''}])`;
+  return `if command -v genesis >/dev/null 2>&1; then genesis hook ${action}${claudePart ? ` --claude-part ${claudePart}` : ''}; else node --input-type=module --eval "${local}"; fi`;
 }