genesis-compiler 1.8.5 → 1.8.6

package/README.md

@@ -1005,6 +1005,13 @@ 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.
 
+`inspectStackSections({ names, projectRoot, rootMode, stackPackages })` returns
+an array of those same section results in the requested order. Names must be
+distinct and the array must be nonempty. It discovers the root once and reads
+the Stack once, so related sections share one Stack identity. Each call reads
+current files; results are not cached across calls. Missing sections retain
+their ordinary `unconfigured` result and repository/directory rules are unchanged.
+
 Hosts that already validate access to a shared worktree may wrap an operation
 in `withTrustedGitRepository(absoluteWorktreeRoot, () => inspectEnvironment({
 projectRoot: absoluteWorktreeRoot }))`. This explicitly trusts that one

package/docs/prompt-integration.md

@@ -99,6 +99,10 @@ The executable returns exactly one JSON result:
   means the host already delivers through a native system field. This result
   is valid only for session scope.
 
+A validated complete host delivery is resolved before CLI project-format, Git
+root, or Stack inspection. Unclaimed conversations and host contributions retain
+the normal project diagnostics and composition. The resolver runs once per hook.
+
 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

package/docs/stack-components.md

@@ -184,6 +184,13 @@ 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.
 
+When a consumer needs several related declarations, use
+`inspectStackSections({ names: ['First operation', 'Second operation'], projectRoot })`.
+It returns an array of the same `genesis.stack-section.v1` results in the requested
+order, using one repository discovery and one fresh Stack read. All results have
+the same Stack hash. The names array must be nonempty and contain no duplicates.
+The explicit directory mode is also supported; no cross-call cache is retained.
+
 ## Selection and identity
 
 `genesis stack add` records selected packages and component dependency closure,
@@ -265,3 +272,21 @@ previously effective declarations once and writing them into
 `genesis/stack.md`. Existing project sections win exactly as they did before.
 Current-format reads reject a selected component whose required contract was
 not materialized, so a tool upgrade cannot quietly substitute a new proposal.
+
+`genesis migrate` does not materialize newly added catalog proposals when the
+project already uses the current format. Reconcile those explicitly with the
+existing `genesis stack add` operation for an already-selected component. For
+example, if `nodejs` is selected and the missing heading is
+`## Connected development`, run `genesis stack add nodejs` and review its
+preparation prompt. This adds the Node `npm` default without choosing connected
+repositories or installing dependencies. Existing complete project sections
+remain authoritative; reconcile any proposed operation against the real source.
+Use the project's pinned compiler invocation when it declares `genesis-compiler`:
+`npm exec --no -- genesis stack add nodejs`.
+
+Before rolling out a catalog that adds operation proposals, operators should
+run read-only project inspection against representative existing projects with
+the candidate compiler and catalog. Arrange explicit reconciliation of affected
+projects before rollout. A format marker alone does not establish compatibility
+with new catalog proposals. Do not repair project contracts through opening,
+status reads or another lazy write path.

package/docs/templates.md

@@ -14,6 +14,9 @@ application has been described or that an application has been created.
 `genesis inspect project --json` is a read-only opening inspection shared by
 the CLI, session guidance, and hosts such as Vibe64:
 
+The diagnostics list reports each identical failure once, even when separate
+inspectors encounter it. Distinct failures remain available for repair.
+
 | State | Evidence | Next step |
 | --- | --- | --- |
 | `new` | No content beyond known bootstrap files | Choose a template or create through conversation |

package/package.json

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

package/src/cli.js

@@ -471,7 +471,7 @@ async function cliStackPackages(projectRoot, supplied) {
   return installedFirstPartyStackPackages({ projectRoot });
 }
 
-async function execute({ command, operands, options }, { signal } = {}) {
+async function execute({ command, operands, options }, { signal, hostContext = null } = {}) {
   if (command === 'parsers') {
     const parserOptions = {
       languages: operands.slice(1), all: options.all, directory: options.directory, signal,
@@ -576,23 +576,6 @@ async function execute({ command, operands, options }, { signal } = {}) {
       return { kind: 'discover', ...await codexAdoptionRecommendation({ projectRoot }) };
     }
     const scope = operands[0];
-    if (scope === 'turn' && process.env.GENESIS_TURN_CONTEXT_ENABLED === '0') {
-      return { kind: 'turn', status: 'ready', output: '' };
-    }
-    if (scope === 'session' && process.env[SESSION_CONTEXT_INSTALLED_ENV] === '1') {
-      return { kind: 'session', status: 'ready', output: '' };
-    }
-    const nativeSession = await hookSessionInput();
-    const hostContext = await resolveConfiguredHostContext({
-      projectRoot,
-      ...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: '' }
@@ -669,7 +652,25 @@ export async function runCli(argv = process.argv.slice(2)) {
       return 0;
     }
     options = parsed.options;
-    const projectFormat = parsed.command === 'parsers' ? null : await optionalProjectFormat(options.projectRoot || process.cwd());
+    const projectRoot = options.projectRoot || process.cwd();
+    let hookResult = null;
+    let hostContext = null;
+    if (parsed.command === 'hook' && parsed.operands[0] !== 'discover') {
+      const scope = parsed.operands[0];
+      if ((scope === 'turn' && process.env.GENESIS_TURN_CONTEXT_ENABLED === '0') ||
+          (scope === 'session' && process.env[SESSION_CONTEXT_INSTALLED_ENV] === '1')) {
+        hookResult = { kind: scope, status: 'ready', output: '' };
+      } else {
+        const nativeSession = await hookSessionInput();
+        hostContext = await resolveConfiguredHostContext({ projectRoot, ...nativeSession, scope });
+        // A validated owner supplies the complete delivery; project composition is unused.
+        if (hostContext?.kind === 'delivery') {
+          hookResult = { kind: 'session', status: 'ready', output: hostContext.text };
+        }
+      }
+    }
+    const projectFormat = hookResult || parsed.command === 'parsers'
+      ? null : await optionalProjectFormat(projectRoot);
     const formatDiagnostic = projectFormatDiagnostic(projectFormat);
     if (formatDiagnostic && !options.json) {
       line(process.stderr, `WARNING: ${formatDiagnostic.message}`);
@@ -680,7 +681,7 @@ export async function runCli(argv = process.argv.slice(2)) {
     process.once('SIGINT', abort);
     process.once('SIGTERM', abort);
     const result = withProjectFormatWarning(
-      await withParserCancellation(controller.signal, () => execute(parsed, { signal: controller.signal })),
+      hookResult ?? await withParserCancellation(controller.signal, () => execute(parsed, { signal: controller.signal, hostContext })),
       projectFormat,
       formatDiagnostic,
     );

package/src/index/project-inspection.js

@@ -1,5 +1,6 @@
 import { readFile } from 'node:fs/promises';
 import path from 'node:path';
+import { isDeepStrictEqual } from 'node:util';
 
 import { readBlueprint } from './blueprint.js';
 import { readCollaboration } from './collaboration.js';
@@ -125,6 +126,9 @@ export async function inspectProject({ projectRoot, stackPackages = [] } = {}) {
     try { await read(root); } catch (error) { result.diagnostics.push(asDiagnostic(error)); }
   }
   try { await inspectProgram(root); } catch (error) { result.diagnostics.push(asDiagnostic(error)); }
+  // Program resource validation can encounter the same Stack failure already reported above.
+  result.diagnostics = result.diagnostics.filter((diagnostic, index, diagnostics) =>
+    !diagnostics.slice(0, index).some((previous) => isDeepStrictEqual(previous, diagnostic)));
   if (result.diagnostics.length) return result;
   if (content.kind !== 'existing') {
     return { ...result, state: 'new', templateEligible: true, nextAction: 'create' };

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

@@ -10,11 +10,25 @@ import { sha256, stableJson } from './utils.js';
 /** Inspect one consumer-owned Stack section without interpreting its contents. */
 export async function inspectProjectStackSection({
   name,
+  ...options
+} = {}) {
+  return (await inspectProjectStackSections({ ...options, names: [name] }))[0];
+}
+
+/** Inspect several sections from one fresh Stack read, in the requested order. */
+export async function inspectProjectStackSections({
+  names,
   projectRoot,
   rootMode = 'repository',
   stackPackages = [],
 } = {}) {
-  const sectionName = normalizeStackSectionName(name);
+  if (!Array.isArray(names) || names.length === 0) {
+    throw new TypeError('Stack section inspection requires a nonempty names array.');
+  }
+  const sectionNames = names.map(normalizeStackSectionName);
+  if (new Set(sectionNames).size !== sectionNames.length) {
+    throw new TypeError('Stack section inspection requires distinct names.');
+  }
   let root;
   if (rootMode === 'repository') {
     root = (await gitContext(projectRoot)).repositoryRoot;
@@ -28,20 +42,22 @@ export async function inspectProjectStackSection({
     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 || [])];
-  const status = diagnostics.length > 0 ? 'blocked' : section ? 'ready' : 'unconfigured';
-  const lines = section ? [...section.lines] : [];
-  return {
-    contract: GENESIS_CONTRACTS.stackSection,
-    status,
-    stackHash: stack.identityHash,
-    sectionHash: status === 'ready' ? sha256(stableJson({ name: sectionName, lines })) : '',
-    components: stack.components.map(({ id }) => id),
-    name: sectionName,
-    source: section?.source || null,
-    content: lines.join('\n'),
-    lines,
-    diagnostics,
-  };
+  return sectionNames.map((sectionName) => {
+    const section = stack.extensions.find((candidate) => candidate.name === sectionName);
+    const diagnostics = [...(section?.diagnostics || [])];
+    const status = diagnostics.length > 0 ? 'blocked' : section ? 'ready' : 'unconfigured';
+    const lines = section ? [...section.lines] : [];
+    return {
+      contract: GENESIS_CONTRACTS.stackSection,
+      status,
+      stackHash: stack.identityHash,
+      sectionHash: status === 'ready' ? sha256(stableJson({ name: sectionName, lines })) : '',
+      components: stack.components.map(({ id }) => id),
+      name: sectionName,
+      source: section?.source || null,
+      content: lines.join('\n'),
+      lines,
+      diagnostics,
+    };
+  });
 }

package/src/index.js

@@ -21,7 +21,7 @@ import { initializeProject } from './index/init.js';
 import { migrateProject } from './index/migration.js';
 import { installCodexPlugin } from './index/codex-plugin.js';
 import { inspectProjectEnvironment } from './index/environment-files.js';
-import { inspectProjectStackSection } from './index/stack-section-inspection.js';
+import { inspectProjectStackSection, inspectProjectStackSections } from './index/stack-section-inspection.js';
 import { listStackCatalogPieces } from './index/stack-catalog.js';
 import { addStackPieces, readStack } from './index/stack.js';
 import { uniqueSorted } from './index/utils.js';
@@ -161,6 +161,10 @@ export function inspectStackSection(options) {
   return inspectProjectStackSection(options);
 }
 
+export function inspectStackSections(options) {
+  return inspectProjectStackSections(options);
+}
+
 export function listEngineeringProfiles() {
   return listEngineeringProfileCatalog();
 }