genesis-compiler 1.10.1 → 1.10.3

package/docs/templates.md

@@ -1,10 +1,20 @@
 # Project opening and templates
 
-The official JSKIT choices are **Basic app**, **Database app**, and **Accounts
-app**. Basic keeps the existing `jskit/public` ID and `public` branch. Database
-uses `jskit/database` and the `database` branch, adding MySQL without login.
-Accounts keeps `jskit/accounts` and the `accounts` branch. These are complete
-starter projects with ready tests; importing source still runs no setup commands.
+The official JSKIT choices are **Basic app**, **Database app**, **Accounts
+app** and **Accounts hub**. Basic keeps the existing `jskit/public` ID and
+`public` branch. Database uses `jskit/database` and the `database` branch,
+adding MySQL without login. Accounts keeps `jskit/accounts` and the `accounts`
+branch. Accounts hub uses `jskit/accounts-hub` and the `accounts-hub` branch:
+an OpenID Connect hub that gives an owner's other apps one sign-in. These are
+complete starter projects with ready tests; importing source still runs no
+setup commands.
+
+Each framework component also has one official **Basic app**: `django/basic`,
+`rails/basic`, `spring-boot/basic`, `express/basic` and `nextjs/basic`. Each is
+the `basic` branch of its `vibe64-dev/seed-<technology>` repository and stores
+notes from one form: SQLite for Django, Rails, Express and Next.js, and
+MySQL/MariaDB for Spring Boot. Only the Rails starter has sign-in, with a seeded
+development account. The catalogue lists JSKIT first, then the frameworks.
 
 `genesis init` installs the portable Genesis documents, workflow skills, and
 agent integration in an ordinary Git repository. It preserves existing source.
@@ -66,8 +76,10 @@ genesis templates apply official:jskit/public
 
 The first-party JSKIT repository is
 the [JSKIT seed repository](https://github.com/vibe64-dev/seed-jskit). `public` supplies
-an adaptive public app; `accounts` adds local accounts, private Home and MySQL.
-Each branch is a complete, current Genesis project with actual application
+an adaptive public app; `accounts` adds local accounts, private Home and MySQL;
+`accounts-hub` is an OpenID Connect hub for one sign-in across apps.
+The framework starters live in `seed-django`, `seed-rails`, `seed-spring-boot`,
+`seed-express` and `seed-nextjs`, each on its `basic` branch. Each branch is a complete, current Genesis project with actual application
 source, dependency lockfile, setup/run contracts and focused checks.
 
 Applying fetches the explicitly named branch once, resolves its commit and reads
@@ -92,7 +104,11 @@ 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,
+existing complete operation sections take precedence. When the starter's Stack
+predates a section its selected components now propose, Genesis adopts the
+current proposal, as `genesis migrate` would, so a new project never starts with
+pending proposals. A section whose proposals compete still fails validation
+before copying. No dependency command,
 database command, agent, or Git commit runs during import. The result reports
 the resolved source repository, branch and commit; no provenance ledger is
 written to the project. Review the ordinary diff and commit it, or save it through the host.

package/package.json

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

package/plugins/genesis/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "genesis",
-  "version": "1.10.1",
+  "version": "1.10.3",
   "description": "Makes Codex aware of optional Genesis adoption for existing projects.",
   "author": {
     "name": "Mobily Enterprises"

package/src/index/code-indexers/parsers.js

@@ -1,5 +1,5 @@
 import { AsyncLocalStorage } from 'node:async_hooks';
-import { access, mkdir, mkdtemp, readFile, readdir, rename, rm, writeFile } from 'node:fs/promises';
+import { access, chmod, mkdir, mkdtemp, readFile, readdir, rename, rm, stat, writeFile } from 'node:fs/promises';
 import { createRequire } from 'node:module';
 import os from 'node:os';
 import path from 'node:path';
@@ -137,6 +137,10 @@ async function installParser(definition, root, { signal, onProgress, environment
       }
     }
     await verifyParser(definition, installation, signal);
+    // mkdtemp stages privately (0700); a shared parser root (for example one
+    // prepared by root for service users) needs the mode an ordinary directory
+    // beside it would have, or other users cannot load the parser.
+    await chmod(staging, (await stat(path.dirname(destination))).mode & 0o7777);
     try {
       await rename(staging, destination);
     } catch (error) {

package/src/index/prompt.js

@@ -311,11 +311,20 @@ async function generateStartPrompt({
     };
   }
   let blueprint;
+  let uninitializedNew = false;
   try {
     blueprint = await readBlueprint(root, { required: true });
   } catch (error) {
     if (error?.code !== 'BLUEPRINT_REQUIRED') throw error;
-    if (await classifyProjectKind({ projectRoot: root }) === 'new') throw error;
+    if (await classifyProjectKind({ projectRoot: root }) === 'new') {
+      // An empty repository that was never initialized still opens a new-project
+      // conversation; the agent initializes Genesis before writing intent.
+      if (inspection.projectFormat?.status !== 'uninitialized') throw error;
+      uninitializedNew = true;
+      blueprint = { path: 'genesis/blueprint.md', description: null };
+    }
+  }
+  if (!blueprint) {
     return {
       status: 'ready',
       task: 'start',
@@ -336,7 +345,10 @@ async function generateStartPrompt({
       verificationCommands: [],
     };
   }
-  const stack = await readStack(root, { stackPackages });
+  // Initialization writes the Stack; until then the selection is empty.
+  const stack = uninitializedNew
+    ? { components: [], stackPackages: [], guidance: '' }
+    : await readStack(root, { stackPackages });
   const projectKind = await classifyProjectKind({
     projectRoot: root,
     stackComponents: stack.components,
@@ -351,7 +363,9 @@ async function generateStartPrompt({
         .then((profiles) => profiles.map(({ id, name, description }) => ({ id, name, description })))
       : Promise.resolve([]),
     inspectProjectSkills({ projectRoot: root, stack }),
-    startInstructions(instructions, projectKind),
+    startInstructions(instructions, projectKind).then((text) => (uninitializedNew
+      ? `${text}\n\nGenesis is not initialized in this repository yet. Before writing the Blueprint\nor selecting Stack components, run the Genesis \`init\` operation. Applying a\nready-made template initializes the project itself.`
+      : text)),
   ]);
   return {
     status: 'ready',
@@ -367,6 +381,7 @@ async function generateStartPrompt({
           path: blueprint.path,
           description: blueprint.description,
         },
+        ...(uninitializedNew ? { genesis: { initialized: false } } : {}),
         ...sessionPrompt.context,
         stack: startStackContext(stack),
         ...(projectKind === 'new'

package/src/index/stack-preflight.js

@@ -11,19 +11,25 @@ export function missingStackResources({ environment = process.env, resources = [
     throw new TypeError('Stack resource inspection requires an environment object and resource declarations.');
   }
   return resources.flatMap(({ component, resource }) => {
-    const satisfied = resource.environmentAlternatives.some(({ bindings, allowEmpty }) => (
-      Object.entries(bindings).every(([semantic, name]) => (
-        present(environment, name, allowEmpty.includes(semantic))
-      ))
+    const missing = resource.environmentAlternatives.map(({ bindings, allowEmpty }) => (
+      Object.entries(bindings)
+        .filter(([semantic, name]) => !present(environment, name, allowEmpty.includes(semantic)))
+        .map(([, name]) => name)
     ));
-    if (satisfied) return [];
+    if (missing.some((names) => names.length === 0)) return [];
     const alternatives = resource.environmentAlternatives.map(({ bindings }) => (
       Object.values(bindings).join(' + ')
     ));
+    // Name what is still absent: defaults may already supply most bindings.
+    const described = alternatives.map((alternative, index) => (
+      missing[index].length < alternative.split(' + ').length
+        ? `${alternative} (missing ${missing[index].join(', ')})`
+        : alternative
+    ));
     return [{
       code: 'STACK_RESOURCE_MISSING',
-      message: `Stack component ${component} requires ${resource.id}: ${alternatives.join(' OR ')}.`,
-      details: { component, resource: resource.id, alternatives },
+      message: `Stack component ${component} requires ${resource.id}: ${described.join(' OR ')}.`,
+      details: { component, resource: resource.id, alternatives, missing },
     }];
   });
 }

package/src/index/template-project.js

@@ -11,7 +11,7 @@ import { GENESIS_BOOTSTRAP_PATHS, inspectProject } from './project-inspection.js
 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 { materializeProjectStackContracts, readStack } from './stack.js';
 import { inspectSubsystems } from './subsystems.js';
 import { writeFileAtomic } from './utils.js';
 import { claudeSkillLinkTarget } from './claude-hooks.js';
@@ -124,6 +124,10 @@ export async function applyTemplate({ projectRoot, templateId, stackPackages = [
         await symlink(linkTarget, location, 'dir');
       } else await writeFile(location, value);
     }
+    // A new project starts complete: adopt the current proposals of the starter's
+    // components for any section its Stack predates, as `genesis migrate` would.
+    const { pendingSections } = await readStack(stagingRoot, { allowUnresolvedSections: true, stackPackages });
+    if (pendingSections.length > 0) await materializeProjectStackContracts({ projectRoot: stagingRoot, stackPackages });
     await initializeProject({ projectRoot: stagingRoot, stackPackages });
     await buildProjectIndex({ projectRoot: stagingRoot, stackPackages });
     const prepared = await inspectProject({ projectRoot: stagingRoot, stackPackages });