genesis-compiler 1.8.1 → 1.8.3

package/README.md

@@ -915,6 +915,7 @@ import {
   inspectCollaboration,
   inspectEngineering,
   inspectEnvironment,
+  inspectProjectFormat,
   inspectSkills,
   inspectStackSection,
   installCodex,
@@ -947,6 +948,12 @@ The CLI can also prepare and verify parsers for an offline host; see
 [language parser management](docs/parsers.md).
 `migrate()` updates recognized older Genesis project-file formats and returns
 the resulting structural check for hosts such as Vibe64.
+`inspectProjectFormat({ projectRoot })` returns only the format marker's `path`,
+`status`, `projectVersion`, `supportedVersion`, `action`, and diagnostic when
+invalid. It retains Git repository discovery and trust checks, but does not
+enumerate application files, load Stack catalogs, or inspect project guidance.
+Missing markers distinguish uninitialized projects from unversioned Genesis
+material. Each call reads current state; it neither migrates nor writes files.
 `adoptProject()` also returns the initial `adopt` prompt for an existing
 codebase. `installCodex()` installs the optional global discovery plugin.
 `listEngineeringProfiles()`, `inspectEngineering()`, and

package/docs/templates.md

@@ -84,6 +84,9 @@ Genesis never treats partial application code as an empty destination.
 
 The destination keeps its Git history, remotes, branch, meaningful Blueprint,
 collaboration/engineering choices, and authored Stack operation sections.
+An empty bootstrap subsystem map yields to the starter's authored map, keeping
+the imported Program connected to its source. A nonempty destination map remains
+authored project context; incompatible declarations fail validation before copying.
 Template Stack components/packages are combined with existing selections;
 existing complete operation sections take precedence. No dependency command,
 database command, agent, or Git commit runs during import. The result reports

package/package.json

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

package/src/index/template-project.js

@@ -12,6 +12,7 @@ import { runGit, runGitText } from './process.js';
 import { listTemplates, resolveTemplate } from './template-catalog.js';
 import { readGitSnapshot } from './template-source.js';
 import { readStack } from './stack.js';
+import { inspectSubsystems } from './subsystems.js';
 import { writeFileAtomic } from './utils.js';
 import { claudeSkillLinkTarget } from './claude-hooks.js';
 
@@ -111,6 +112,7 @@ export async function applyTemplate({ projectRoot, templateId, stackPackages = [
       if (previous === null || name.startsWith('.genesis/')) continue;
       const { contents, linkTarget } = previous;
       if (name === 'genesis/blueprint.md' && !parseBlueprintSource(contents.toString('utf8')).description) continue;
+      if (name === 'genesis/subsystems.md' && (await inspectSubsystems({ projectRoot: root })).status === 'empty') continue;
       let value = contents;
       if (name === 'genesis/stack.md') value = mergeTemplateStack(stackFile.contents.toString('utf8'), contents.toString('utf8'));
       const location = path.join(stagingRoot, name);

package/src/index.js

@@ -31,6 +31,7 @@ import { projectSessionContext, projectTurnContext } from './index/session-conte
 import { withTrustedGitRepository } from './index/process.js';
 
 export { inspectProject };
+export { inspectProjectFormat } from './index/project-format.js';
 export { SOURCE_EXPLANATION_PROMPT_VERSION, sourceExplanationGuidance, sourceExplanationReviewGuidance } from './index/source-explanation.js';
 export { inspectClaudeHooks, installClaudeHooks as syncClaudeHooks } from './index/claude-hooks.js';
 export { inspectAgentIntegrations, syncAgentIntegrations } from './index/agent-integrations.js';