genesis-compiler 1.7.6 → 1.7.8

package/README.md

@@ -946,7 +946,13 @@ detailed Machine City and simple Program City projections.
 public non-secret defaults, value-free missing-input diagnostics, and dotenv
 projection paths without returning any supplied environment value.
 `inspectStackSection()` returns one exact consumer-owned section without
-interpreting or executing its contents.
+interpreting or executing its contents. Its default `rootMode: "repository"`
+uses Git discovery. For an authorized source snapshot without Git metadata,
+hosts may pass `rootMode: "directory"` and an explicit absolute `projectRoot`.
+This reads that exact directory, including when it sits inside another Git
+repository. It retains the same Stack validation and performs no writes or
+commands. Missing/invalid roots fail; this is never an automatic fallback from
+Git ownership or discovery errors.
 
 Hosts that already validate access to a shared worktree may wrap an operation
 in `withTrustedGitRepository(absoluteWorktreeRoot, () => inspectEnvironment({

package/docs/prompt-integration.md

@@ -82,7 +82,25 @@ JSON on stdin:
 ```
 
 For `genesis hook turn`, the input has the same shape with `scope: "turn"`.
-The executable returns only the requested host contribution as text. Codex and Claude Code
+The executable returns exactly one JSON result:
+
+- `{"kind":"unclaimed"}`: this native conversation is not managed by the host;
+  Genesis delivers its standalone guide.
+- `{"kind":"contribution","text":"..."}`: Genesis composes this bounded host
+  contribution with its own session guide (or bounded turn contribution).
+- `{"kind":"delivery","text":"..."}`: the host owns the complete session
+  delivery; Genesis forwards it without adding its standalone copy. Empty text
+  means the host already delivers through a native system field. This result
+  is valid only for session scope.
+
+Malformed results and configured-resolver failures fail the hook. An unavailable
+claimed owner must fail rather than returning `unclaimed`. Ownership belongs to
+the native conversation: these results do not change project hook files, so
+independent CLI and managed conversations can use the same project. The host
+owns durable bindings, ancestry verification and restoration across reconnection.
+No host framework dependency is added to Genesis.
+
+Codex and Claude Code
 hook input and OpenCode's transform callbacks supply the native session id;
 Genesis extracts that id but does not understand the host registry or the
 provider's prompt-placement rules. The Codex and Claude prompt hooks and OpenCode message
@@ -104,8 +122,8 @@ Codex hook settings. A host can render these fields as an actionable failure
 instead of displaying the runtime stack.
 
 The OpenCode session adapter also includes verified native `parentSessionIds`
-in `GENESIS_HOST_CONTEXT_INPUT` for host command shims. The resolver still
-receives the actual child's `providerSessionId`; Genesis does not interpret a
+in `GENESIS_HOST_CONTEXT_INPUT` for host command shims and in the resolver
+request when present (at most 32 IDs). The resolver receives the actual child's `providerSessionId`; Genesis does not interpret a
 host's ownership rules.
 
 After updating Genesis, hosts can inspect all generated integrations with

package/docs/stack-components.md

@@ -177,6 +177,13 @@ The named consumer then owns all interpretation and action. This boundary works
 equally for web applications, libraries, command-line tools, native programs,
 firmware, desktop software, and future systems Genesis has never seen.
 
+The library can inspect a source snapshot without Git metadata with
+`inspectStackSection({ name, projectRoot: absoluteDirectory, rootMode: "directory" })`.
+It uses the exact directory and the same Stack parser without repository
+discovery. Default library and CLI inspection continue to use the enclosing
+Git repository and its trust checks. Invalid modes or directory roots fail;
+there is no automatic fallback.
+
 ## Selection and identity
 
 `genesis stack add` records selected packages and component dependency closure,

package/package.json

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

package/src/cli.js

@@ -426,8 +426,8 @@ function writeResult(command, result) {
   line(process.stdout, `${command}: ${result.status}`);
 }
 
-async function hookSessionId(environment = process.env) {
-  if (!environment[HOST_CONTEXT_RESOLVER_ENV]) return null;
+async function hookSessionInput(environment = process.env) {
+  if (!environment[HOST_CONTEXT_RESOLVER_ENV]) return {};
   let source = environment[HOST_CONTEXT_INPUT_ENV];
   if (source === undefined && !process.stdin.isTTY) {
     const chunks = [];
@@ -441,7 +441,7 @@ async function hookSessionId(environment = process.env) {
     }
     source = Buffer.concat(chunks).toString('utf8');
   }
-  if (!String(source || '').trim()) return null;
+  if (!String(source || '').trim()) return {};
   let input;
   try {
     input = JSON.parse(source);
@@ -449,7 +449,15 @@ async function hookSessionId(environment = process.env) {
     fail('HOST_CONTEXT_INPUT_INVALID', 'The host hook input must contain JSON.');
   }
   const sessionId = input?.sessionId ?? input?.session_id;
-  return typeof sessionId === 'string' && sessionId.trim() ? sessionId.trim() : null;
+  const parentSessionIds = input?.parentSessionIds ?? [];
+  if (!Array.isArray(parentSessionIds) || parentSessionIds.length > 32 ||
+      parentSessionIds.some(id => typeof id !== 'string' || !id.trim())) {
+    fail('HOST_CONTEXT_INPUT_INVALID', 'Native parent session ids must be a bounded list of strings.');
+  }
+  return {
+    providerSessionId: typeof sessionId === 'string' && sessionId.trim() ? sessionId.trim() : null,
+    ...(parentSessionIds.length ? { parentSessionIds } : {}),
+  };
 }
 
 async function cliStackPackages(projectRoot, supplied) {
@@ -574,19 +582,24 @@ async function execute({ command, operands, options }, { signal } = {}) {
     if (scope === 'session' && process.env[SESSION_CONTEXT_INSTALLED_ENV] === '1') {
       return { kind: 'session', status: 'ready', output: '' };
     }
-    const providerSessionId = await hookSessionId();
+    const nativeSession = await hookSessionInput();
     const hostContext = await resolveConfiguredHostContext({
       projectRoot,
-      providerSessionId,
+      ...nativeSession,
       scope,
     });
+    // Ownership is resolved for this native conversation, not for the project.
+    // A host-owned delivery already contains everything its runtime requires.
+    if (hostContext?.kind === 'delivery') {
+      return { kind: 'session', status: 'ready', output: hostContext.text };
+    }
     if (scope === 'turn') {
       return hostContext === null
         ? { kind: 'turn', status: 'ready', output: '' }
         : {
             kind: 'turn',
             ...await projectTurnContext({
-              hostDriver: () => hostContext,
+              hostDriver: () => hostContext.text,
               hostDriverInput: { scope: 'turn' },
             }),
           };
@@ -595,7 +608,7 @@ async function execute({ command, operands, options }, { signal } = {}) {
       kind: 'session',
       ...await projectSessionContext({
         ...(hostContext === null ? {} : {
-          hostDriver: () => hostContext,
+          hostDriver: () => hostContext.text,
           hostDriverInput: { scope: 'session' },
         }),
         projectRoot,

package/src/index/host-context-resolver.js

@@ -55,6 +55,7 @@ export async function resolveConfiguredHostContext({
   environment = process.env,
   projectRoot,
   providerSessionId = null,
+  parentSessionIds = [],
   scope = 'session',
 } = {}) {
   const command = configuredResolver(environment);
@@ -66,8 +67,20 @@ export async function resolveConfiguredHostContext({
     input: {
       scope,
       providerSessionId: providerSessionId || null,
+      ...(parentSessionIds.length ? { parentSessionIds } : {}),
       data: resolverData(environment),
     },
   });
-  return output;
+  let result;
+  try { result = JSON.parse(output); } catch {
+    throw resolverError('The host context resolver must return a JSON delivery result.');
+  }
+  if (!result || typeof result !== 'object' || Array.isArray(result) ||
+      !['unclaimed', 'contribution', 'delivery'].includes(result.kind) ||
+      Object.keys(result).some((key) => !['kind', 'text'].includes(key)) ||
+      (result.kind === 'unclaimed' ? Object.hasOwn(result, 'text') : typeof result.text !== 'string') ||
+      (result.kind === 'delivery' && scope !== 'session')) {
+    throw resolverError('Invalid host context delivery result.');
+  }
+  return result.kind === 'unclaimed' ? null : result;
 }

package/src/index/stack-section-inspection.js

@@ -1,3 +1,6 @@
+import { realpath, stat } from 'node:fs/promises';
+import path from 'node:path';
+
 import { GENESIS_CONTRACTS } from './contracts.js';
 import { gitContext } from './git.js';
 import { readStack } from './stack.js';
@@ -8,10 +11,22 @@ import { sha256, stableJson } from './utils.js';
 export async function inspectProjectStackSection({
   name,
   projectRoot,
+  rootMode = 'repository',
   stackPackages = [],
 } = {}) {
   const sectionName = normalizeStackSectionName(name);
-  const root = (await gitContext(projectRoot)).repositoryRoot;
+  let root;
+  if (rootMode === 'repository') {
+    root = (await gitContext(projectRoot)).repositoryRoot;
+  } else if (rootMode === 'directory') {
+    if (typeof projectRoot !== 'string' || !path.isAbsolute(projectRoot)) {
+      throw new TypeError('Directory inspection requires an explicit absolute projectRoot.');
+    }
+    root = await realpath(projectRoot);
+    if (!(await stat(root)).isDirectory()) throw new TypeError('Directory inspection requires a directory.');
+  } else {
+    throw new TypeError('Stack section rootMode must be repository or directory.');
+  }
   const stack = await readStack(root, { stackPackages });
   const section = stack.extensions.find((candidate) => candidate.name === sectionName);
   const diagnostics = [...(section?.diagnostics || [])];
@@ -30,4 +45,3 @@ export async function inspectProjectStackSection({
     diagnostics,
   };
 }
-