genesis-compiler 1.7.6 → 1.7.7

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/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.7",
   "type": "module",
   "description": "An agent-independent prompt, multi-language code-index, cleanup, and verification companion with project agent guidance.",
   "repository": {

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,
   };
 }
-