genesis-compiler 1.10.13 → 1.10.14

package/README.md

@@ -1078,7 +1078,10 @@ and diagnostics for missing, invalid, outdated, customized, or unmanaged skills.
 Synchronization returns changed paths, preservation diagnostics, and the resulting
 `inspection`. Hosts own source-write exclusion and assistant context lifecycle.
 `projectSessionContext()` composes stable project guidance with one explicitly
-supplied host-driver result. `projectTurnContext()` invokes that same optional
+supplied host-driver result. A project file Genesis cannot read does not stop
+it: the context names the file, the line and the text Genesis found there, so
+the agent can repair it. That includes an Agent Skill source and an agent
+integration file such as `.claude/settings.json`. `projectTurnContext()` invokes that same optional
 driver for the separate untrusted turn lane without accepting user-message
 text.
 `getContext()` resolves source paths to the Program modules that cite them,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "genesis-compiler",
-  "version": "1.10.13",
+  "version": "1.10.14",
   "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.13",
+  "version": "1.10.14",
   "description": "Makes Codex aware of optional Genesis adoption for existing projects.",
   "author": {
     "name": "Mobily Enterprises"

package/src/index/agent-skills.js

@@ -315,6 +315,12 @@ export async function projectSkillPlan(stack, { projectRoot } = {}) {
   if (projectRoot) {
     let manifest;
     try { manifest = JSON.parse(await readFile(path.join(projectRoot, 'package.json'), 'utf8')); } catch (error) {
+      // The manifest says whether the project declares its own genesis-compiler skills.
+      if (error instanceof SyntaxError) {
+        throw new GenesisError('AGENT_SKILL_SOURCE_INVALID',
+          `package.json is not valid JSON, so the project's genesis-compiler skills cannot be located: ${error.message}.`,
+          { path: 'package.json' });
+      }
       if (!['ENOENT', 'ENOTDIR'].includes(error?.code)) throw error;
     }
     if (manifest?.name === 'genesis-compiler') {

package/src/index/session-context.js

@@ -1,14 +1,30 @@
 import { readCollaboration } from './collaboration.js';
+import { inspectAgentIntegrations } from './agent-integrations.js';
 import { inspectProjectSkills, renderAgentSkillCatalog } from './agent-skills.js';
 import { GENESIS_CONTRACTS } from './contracts.js';
 import { readEngineering, readEngineeringBaseline } from './engineering.js';
 import { asDiagnostic } from './errors.js';
 import { gitContext } from './git.js';
+import { STACK_PATH } from './paths.js';
 import { inspectProjectAtRoot } from './project-inspection.js';
 import { readStack } from './stack.js';
 import { listStackCatalogPieces } from './stack-catalog.js';
 import { composedContext, hostContextContribution } from './host-context.js';
 
+/**
+ * A diagnostic as the agent needs it to repair the file: the file, the line and the text found there,
+ * when Genesis knows them. Stack section parsers number lines within their section.
+ */
+function diagnosticText({ message, details }) {
+  const file = typeof details?.path === 'string' ? details.path : '';
+  const line = Number.isSafeInteger(details?.line)
+    ? ` (line ${details.line}${file === STACK_PATH ? ' of its section' : ''})`
+    : '';
+  const where = file && (line || !message.includes(file)) ? `${file}${line}: ` : '';
+  const found = typeof details?.observed === 'string' ? ` Found: ${JSON.stringify(details.observed)}.` : '';
+  return `${where}${message}${found}`;
+}
+
 async function optionalStack(projectRoot, stackPackages) {
   try { return await readStack(projectRoot, { stackPackages }); } catch { return null; }
 }
@@ -68,11 +84,16 @@ export async function projectSessionContext({
     inspectProjectAtRoot(root, { stackPackages, count: false }),
   ]);
   const availableComponents = await optionalStackComponentIds(root, stack, stackPackages);
-  const skills = stack && inspection.projectFormat.status === 'current'
-    ? await inspectProjectSkills({ projectRoot: root, stack }).catch((error) => ({
-        diagnostics: [asDiagnostic(error)],
-      }))
-    : { diagnostics: [] };
+  const current = inspection.projectFormat.status === 'current';
+  const [skills, integrations] = await Promise.all([
+    stack && current
+      ? inspectProjectSkills({ projectRoot: root, stack }).catch((error) => ({
+          diagnostics: [asDiagnostic(error)],
+        }))
+      : { diagnostics: [] },
+    // Only an integration file Genesis cannot read is reported; a missing or outdated one is synchronization work.
+    current ? inspectAgentIntegrations({ projectRoot: root }).then(() => [], (error) => [asDiagnostic(error)]) : [],
+  ]);
   const selected = stack?.components.map(({ id }) => id) || [];
   const stackStatus = stack
     ? (selected.length > 0 ? selected.join(', ') : 'none')
@@ -85,7 +106,7 @@ export async function projectSessionContext({
     ] : inspection.state === 'adoption' ? [
       '- Existing project content needs description and configuration. Ask what this project does and what the user wants to run, using answers already supplied. Inspect its implementation to work backwards into Blueprint, Stack and Program. Do not offer seeds or replace existing source/history. Run `genesis adopt` and follow its prompt; initialized Genesis files already express the user’s decision to use Genesis.',
     ] : inspection.state === 'attention' ? [
-      `- Genesis needs attention: ${inspection.diagnostics.map(({ message }) => message).join(' ')} Next action: ${inspection.nextAction}. Preserve source and explain the specific issue before the relevant migration or repair. Do not offer seeds.`,
+      `- Genesis needs attention: ${inspection.diagnostics.map(diagnosticText).join(' ')} Next action: ${inspection.nextAction}. Preserve source and explain the specific issue before the relevant migration or repair. Do not offer seeds.`,
     ] : []),
     '- Opening or resuming a session only reads project metadata and content paths. Do not run verification, tests, builds, dependency installation, or database preparation just because a session started. Run relevant checks when the requested work calls for them.',
     '- Read `genesis/blueprint.md`, `genesis/collaboration.md`, `genesis/engineering.md`, and `genesis/stack.md` for product intent, collaboration approach, engineering approach, and selected technology.',
@@ -95,8 +116,9 @@ export async function projectSessionContext({
     '- When the user names an unselected technology that exactly matches this catalog, run `genesis stack list`, ask whether to add and prepare it, and wait for confirmation. If confirmed, run `genesis stack add <piece...>` and follow its returned preparation prompt in the same task; then use `genesis context` and any installed technology skill. Never infer dependency commands from a component id. If declined or unmatched, continue through authoritative technology documentation without inventing a component.',
     '- Project-owned operation sections in `genesis/stack.md` are the durable application contract. Make the implementation satisfy them or update a complete section to match evidenced reality; Genesis executes only Verification.',
     '- Use the relevant project Agent Skills below `.agents/skills/`.',
-    ...skills.diagnostics.map(({ message }) => `- Agent Skill maintenance: ${message}`),
+    ...skills.diagnostics.map((diagnostic) => `- Agent Skill maintenance: ${diagnosticText(diagnostic)}`),
     ...(skills.diagnostics.length > 0 ? ['- Skill inspection is read-only. Synchronization is an explicit source change; follow the current task authorization and host write boundary before running it.'] : []),
+    ...integrations.map((diagnostic) => `- Agent integration maintenance: ${diagnosticText(diagnostic)}`),
     '- After locating source, run `genesis context <path...>`; before adding a helper or public operation, run `genesis index <name-or-path...>` and reuse an existing owner.',
     '- If genesis/subsystems.md is missing or empty in an existing explained application, author it from source, schema and existing Program before implementation. This is ordinary explanatory adoption, not a startup blocker; do not run tests or application commands merely to create the map.',
     '- Read genesis/subsystems.md for declared subsystem responsibilities, Program membership, and data ownership/use. Maintain it in the same implementation turn when those facts change; reuse existing boundaries, verify source/schema, and require one Source Directory per subsystem and assign each Program module once; Program folder names do not assign ownership.',
@@ -118,7 +140,7 @@ export async function projectSessionContext({
     ...(skills.skills?.length ? ['', 'PROJECT AGENT SKILLS', '', renderAgentSkillCatalog(skills.skills)] : []),
     ...(hostContext ? ['', 'HOST CONTEXT', '', hostContext] : []),
   ].join('\n');
-  return { ...composedContext(GENESIS_CONTRACTS.sessionContext, output), warnings: skills.diagnostics };
+  return { ...composedContext(GENESIS_CONTRACTS.sessionContext, output), warnings: [...skills.diagnostics, ...integrations] };
 }
 
 export { projectTurnContext } from './host-context.js';