genesis-compiler 1.2.24 → 1.2.26

package/src/index/init.js

@@ -6,6 +6,7 @@ import { BLUEPRINT_SKELETON_SOURCE } from './blueprint.js';
 import { installCodexHooks } from './codex-hooks.js';
 import { ENGINEERING_SKELETON_SOURCE } from './engineering.js';
 import { gitContext } from './git.js';
+import { installOpenCodePlugin } from './opencode-plugin.js';
 import {
   BLUEPRINT_PATH,
   ENGINEERING_PATH,
@@ -44,22 +45,32 @@ export async function initializeProject({ projectRoot, stackPackages = [] } = {}
   await mkdir(path.join(root, PROGRAM_ROOT), { recursive: true });
   const stack = await readStack(root, { stackPackages });
   const skills = await syncProjectSkills({ projectRoot: root, stack });
-  const hooks = await installCodexHooks({ projectRoot: root });
+  const [hooks, openCodePlugin] = await Promise.all([
+    installCodexHooks({ projectRoot: root }),
+    installOpenCodePlugin({ projectRoot: root }),
+  ]);
   const version = projectFormat.status === 'uninitialized'
     ? await createIfMissing(root, PROJECT_VERSION_PATH, CURRENT_PROJECT_FORMAT_SOURCE)
     : null;
-  const changedFiles = [...created, ...hooks.changedFiles, ...skills.changedFiles, version]
+  const changedFiles = [
+    ...created,
+    ...hooks.changedFiles,
+    ...openCodePlugin.changedFiles,
+    ...skills.changedFiles,
+    version,
+  ]
     .filter(Boolean)
     .sort();
   return {
     status: changedFiles.length > 0 ? 'updated' : 'unchanged',
     summary: changedFiles.length > 0
-      ? 'Initialized Genesis, Agent Skills, and project Codex hooks.'
-      : 'Genesis, its Agent Skills, and project Codex hooks are already initialized.',
+      ? 'Initialized Genesis, Agent Skills, and project guidance for Codex and OpenCode.'
+      : 'Genesis, its Agent Skills, and project guidance for Codex and OpenCode are already initialized.',
     changedFiles,
     diagnostics: skills.diagnostics,
     guidance: [
-      'Open Codex and use /hooks to review and trust the project hooks.',
+      'Open Codex and use /hooks to review and trust the project guidance hook.',
+      'OpenCode loads the project guidance plugin automatically.',
       'Genesis workflow skills are available in .agents/skills/.',
       'Describe product intent in genesis/blueprint.md.',
       'Choose the project engineering approach with genesis engineering set <profile>.',

package/src/index/opencode-plugin.js

@@ -0,0 +1,28 @@
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+
+import { gitContext } from './git.js';
+import { writeFileAtomic } from './utils.js';
+
+const OPENCODE_PLUGIN_PATH = '.opencode/plugins/genesis-project-guidance.js';
+const OPENCODE_PLUGIN_SOURCE = new URL('../../plugins/opencode/project-guidance.js', import.meta.url);
+
+async function existingSource(location) {
+  try {
+    return await readFile(location, 'utf8');
+  } catch (error) {
+    if (['ENOENT', 'ENOTDIR'].includes(error?.code)) return null;
+    throw error;
+  }
+}
+
+export async function installOpenCodePlugin({ projectRoot } = {}) {
+  const root = (await gitContext(projectRoot)).repositoryRoot;
+  const location = path.join(root, OPENCODE_PLUGIN_PATH);
+  const source = await readFile(OPENCODE_PLUGIN_SOURCE, 'utf8');
+  if (await existingSource(location) === source) {
+    return { status: 'unchanged', changedFiles: [] };
+  }
+  await writeFileAtomic(location, source);
+  return { status: 'updated', changedFiles: [OPENCODE_PLUGIN_PATH] };
+}

package/src/index/prompt.js

@@ -25,7 +25,7 @@ const DEFAULT_REQUEST = {
   start: 'Start a conversation about this project.',
   adopt: 'Import the existing project into a truthful Genesis project contract.',
   work: 'Implement the product intent expressed by the current Blueprint.',
-  deslop: 'Simplify the current Git-visible work without making unrelated changes.',
+  deslop: 'Deslop the latest commit.',
   program: 'Refresh the complete useful Program for the code that exists now.',
   describe: 'Create or refresh the complete Blueprint and useful Program for the codebase that exists now.',
   review: 'Review the complete useful relationship between Blueprint, code, Program, and tests.',
@@ -107,6 +107,7 @@ function renderPrompt({
   skills = '',
   guidance = '',
   cleanup = '',
+  postChange = '',
   adoption = '',
   engineeringGuidance = '',
 }) {
@@ -126,6 +127,7 @@ function renderPrompt({
     ...(guidance ? ['', 'SELECTED STACK GUIDANCE', '', guidance] : []),
     ...(adoption ? ['', 'SELECTED STACK ADOPTION GUIDANCE', '', adoption] : []),
     ...(skills ? ['', 'AVAILABLE AGENT SKILLS', '', skills] : []),
+    ...(postChange ? ['', 'SELECTED STACK POST-CHANGE GUIDANCE', '', postChange] : []),
     ...(cleanup ? ['', 'SELECTED STACK CLEANUP GUIDANCE', '', cleanup] : []),
     '',
   ].join('\n');
@@ -451,6 +453,7 @@ export async function generateProjectPrompt({
     engineeringGuidance: engineering.guidance,
     guidance: stack.guidance,
     skills: renderAgentSkillCatalog(projectSkills.skills),
+    postChange: task === 'work' ? stack.postChange : '',
     cleanup: task === 'deslop' ? stack.deslop : '',
   });
   return {

package/src/index/session-context.js

@@ -0,0 +1,55 @@
+import { readEngineering, readEngineeringBaseline } from './engineering.js';
+import { gitContext } from './git.js';
+import { readStack } from './stack.js';
+
+async function optionalStack(projectRoot, stackPackages) {
+  try { return await readStack(projectRoot, { stackPackages }); } catch { return null; }
+}
+
+async function optionalEngineering(projectRoot) {
+  try {
+    return await readEngineering(projectRoot);
+  } catch {
+    return {
+      guidance: [
+        '## Universal complexity gate',
+        '',
+        await readEngineeringBaseline(),
+        '',
+        'The project engineering profile is invalid. Do not infer a replacement; run the Genesis `check` operation and ask the user before implementation if the selected approach matters.',
+      ].join('\n'),
+      profile: null,
+    };
+  }
+}
+
+export async function projectSessionContext({ projectRoot, stackPackages = [] } = {}) {
+  const root = (await gitContext(projectRoot)).repositoryRoot;
+  const [stack, engineering] = await Promise.all([
+    optionalStack(root, stackPackages),
+    optionalEngineering(root),
+  ]);
+  const selected = stack?.components.map(({ id }) => id) || [];
+  const stackStatus = stack
+    ? (selected.length > 0 ? selected.join(', ') : 'none')
+    : 'unavailable; run the Genesis `check` operation';
+  return {
+    status: 'ready',
+    output: [
+      'This is a Genesis-enriched project.',
+      '- Read `genesis/blueprint.md`, `genesis/engineering.md`, and `genesis/stack.md` for product intent, engineering approach, and selected technology.',
+      '- Use the relevant project Agent Skills below `.agents/skills/`.',
+      '- 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.',
+      '- Program is fallible explanation; code, tests, and runtime behavior remain evidence.',
+      '- Keep Blueprint and affected Program explanations aligned with intentional observable product behavior in the same implementation turn. Private restructuring may need only source citations or no explanatory change.',
+      '- Deslop only when explicitly requested. Genesis defines its behavior-preserving committed scope; selected Stack components may add technology-specific cleanup guidance.',
+      '- This guidance is loaded for a new session and refreshed after compaction. Continue the active request without restarting completed work.',
+      `Engineering profile: ${engineering.profile?.id || 'invalid; run the Genesis `check` operation'}.`,
+      `Selected Stack components: ${stackStatus}.`,
+      '',
+      'ENGINEERING APPROACH',
+      '',
+      engineering.guidance,
+    ].join('\n'),
+  };
+}

package/prompts/reconcile.txt

@@ -1,13 +0,0 @@
-For every repository listed in the task, read and follow that repository's
-`.agents/skills/genesis-program/SKILL.md` completely, operating in focused
-post-change reconciliation mode.
-
-Use the preceding implementation turn, listed changed paths, actual Git diff or
-history, and relevant tests. Update Blueprint only for intentional observable
-product behavior. Update only affected Program modules. Private restructuring
-may require only Sources or an informational Implementation map, and may require
-no explanatory edit at all.
-
-Do not simplify or edit implementation, tests, configuration, dependencies,
-Stack, or `.genesis/` during this turn. Do not run Deslop yet. Summarize every
-explanatory change and genuine ambiguity.