genesis-compiler 1.10.7 → 1.10.8

package/README.md

@@ -294,6 +294,10 @@ than in a host-private policy or a repeated user-message prefix:
 
 - `concise`
 
+## Long checks
+
+- `conservative`
+
 ## Project requirements
 
 - Nothing.
@@ -303,7 +307,7 @@ Inspect or change it without parsing Markdown yourself:
 
 ```bash
 genesis collaboration show
-genesis collaboration set direct balanced expert conclusions "Be candid."
+genesis collaboration set direct balanced expert conclusions normal "Be candid."
 ```
 
 Genesis owns the supported choices and their concise expansions. Authored
@@ -315,6 +319,26 @@ Updates should describe actual progress, findings, decisions, or blockers,
 rather than announce compliance with guidance or reassure the user about
 unrelated behavior staying unchanged.
 
+The Long checks choice sets how agents handle test suites, builds and other long
+checks. `conservative` runs each one as a single unattended, time-limited
+command that writes its output to a local file and ends with one completion
+signal; the agent does not watch it while it runs and passes this on to agents
+it delegates checks to. It saves the most tokens, and results arrive only when
+each check ends. `normal` lets the agent follow a check's progress and stop a
+clearly broken run early, reacting sooner for more tokens. Both keep the
+Engineering baseline's time limit, local output files, exit status and concise
+evidence reading.
+
+The choice belongs to the person, so Genesis never makes it for them. `genesis
+init`, migration and `setCollaboration()` calls that do not pass `longChecks`
+leave `## Long checks` out. While it is absent, `longChecks` is `null` and the
+session guidance asks the agent to put both options to the person once, early,
+before the first long check, to record the answer with `genesis collaboration
+set` (the guidance spells out the command with the current choices), and to use
+`conservative` until then. Once the section exists, the guidance carries only
+the chosen option. A present section with any other value is rejected with the
+valid choices listed.
+
 Persistent hosts should install `projectSessionContext()` once when a provider
 conversation is created or refreshed. They may then generate task prompts with
 `sessionContextInstalled: true`, preventing the stable Collaboration and

package/docs/prompt-integration.md

@@ -180,8 +180,8 @@ Genesis keeps each instruction at one useful level:
 - `genesis/blueprint.md`, `genesis/program/`, and `genesis/stack.md` are the
   project's own intent, explanation, and selected technical composition.
 - `genesis/collaboration.md` selects Genesis-owned tone, response-length,
-  assumed-experience, and explanation-style instructions plus optional authored
-  project requirements.
+  assumed-experience, explanation-style, and long-checks instructions plus
+  optional authored project requirements.
 - `profiles/engineering/*.md` owns the installed versioned engineering
   profiles. `genesis/engineering.md` selects one profile and records explicit
   project requirements. A universal complexity gate is composed ahead of the

package/package.json

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

package/profiles/engineering/baseline.md

@@ -5,5 +5,5 @@
 - Do not overengineer or overcomplicate the solution. Do not add speculative abstractions, layers, dependencies, infrastructure, compatibility paths, distributed patterns, cryptography, enterprise patterns, or other advanced machinery unless an explicit requirement or a concrete constraint makes it necessary.
 - If good software requires material complexity beyond these rules, stop before writing it. Explain the requirement, why the direct design is insufficient, and the smallest added complexity proposed, then ask the user to approve or clarify the tradeoff.
 - During implementation, run the relevant checks and batch related cases when they share setup. Follow the project's verification policy for broad or final checks; do not repeat them merely because an item finishes or a session resumes. Preserve required coverage and isolation.
-- Keep complete test output in local artifacts and preserve exit status. Read concise counts, timings and actionable failure excerpts first, expanding evidence only when needed. Do not load full passing reports or repeatedly poll unchanged logs into agent context. Retain startup and cleanup failures; retry only after a change or new evidence justifies it.
+- Bound each long check by a time limit so it ends even when it hangs; write its complete output to a local file and preserve its exit status. Afterwards read concise counts, timings and actionable failure excerpts first, expanding evidence only when needed; never load full passing reports into agent context. Retain startup and cleanup failures; retry only after a change or new evidence justifies it.
 - For browser verification, batch related actions and return only the relevant values or page region. Capture screenshots at meaningful visual checkpoints or failures, not after every action. Preserve required viewport, identity and security coverage; prefer existing automated cases for repeated checks.

package/src/cli.js

@@ -55,7 +55,7 @@ const USAGE = `Usage:
   genesis adopt [product guidance...]
   genesis codex install
   genesis collaboration show
-  genesis collaboration set <tone> <response-length> <experience> <explanation-style> [project requirements...]
+  genesis collaboration set <tone> <response-length> <experience> <explanation-style> <long-checks> [project requirements...]
   genesis engineering list
   genesis engineering show [profile]
   genesis engineering set <profile>
@@ -178,10 +178,10 @@ function parseCommand(argv) {
     if (action === 'show' && operands.length !== 1) {
       fail('CLI_EXTRA_ARGUMENT', 'Command collaboration show accepts no extra arguments.');
     }
-    if (action === 'set' && operands.length < 5) {
+    if (action === 'set' && operands.length < 6) {
       fail(
         'CLI_COLLABORATION_VALUES_REQUIRED',
-        'Command collaboration set requires tone, response length, experience, and explanation style.',
+        'Command collaboration set requires tone, response length, experience, explanation style, and long checks.',
       );
     }
   } else if (command === 'stack') {
@@ -279,6 +279,7 @@ function writeCollaboration(result) {
   line(process.stdout, `Response length: ${result.responseLength}`);
   line(process.stdout, `Assumed experience: ${result.experience}`);
   line(process.stdout, `Explanation style: ${result.explanationStyle}`);
+  line(process.stdout, `Long checks: ${result.longChecks || 'unset (conservative until chosen)'}`);
   if (result.requirements) {
     line(process.stdout, 'Project requirements:');
     line(process.stdout, result.requirements);
@@ -516,7 +517,8 @@ async function execute({ command, operands, options }, { signal, hostContext = n
         responseLength: operands[2],
         experience: operands[3],
         explanationStyle: operands[4],
-        ...(operands.length > 5 ? { requirements: operands.slice(5).join(' ') } : {}),
+        longChecks: operands[5],
+        ...(operands.length > 6 ? { requirements: operands.slice(6).join(' ') } : {}),
       }),
     };
   }

package/src/index/collaboration.js

@@ -74,6 +74,18 @@ const DIMENSIONS = {
       guidance: 'Explain the practical reasoning behind decisions in a teaching-oriented way.',
     },
   },
+  longChecks: {
+    conservative: {
+      name: 'Conservative',
+      description: 'Saves the most tokens; results arrive only when each check ends.',
+      guidance: 'Run each long check as one unattended command, bounded by a time limit, that writes its complete output to a local file and exits with its status, so it ends with a single completion signal. Do not watch it while it runs: no progress monitors, log tails, repeated status checks or interim reports. Pass this on to any agent you delegate checks to.',
+    },
+    normal: {
+      name: 'Normal',
+      description: 'Reacts sooner, uses more tokens.',
+      guidance: 'You may follow a long check\'s progress while it runs and stop a clearly broken run early. Still keep its full output in files and read only what you need.',
+    },
+  },
 };
 
 const SECTION_FIELDS = Object.freeze({
@@ -81,8 +93,13 @@ const SECTION_FIELDS = Object.freeze({
   'Response length': 'responseLength',
   'Assumed experience': 'experience',
   'Explanation style': 'explanationStyle',
+  'Long checks': 'longChecks',
 });
 
+// A missing optional section is an unmade choice, not a default.
+const OPTIONAL_SECTIONS = new Set(['Long checks']);
+const LONG_CHECKS_UNTIL_CHOSEN = 'conservative';
+
 export const DEFAULT_COLLABORATION = Object.freeze({
   tone: 'encouraging',
   responseLength: 'concise',
@@ -196,6 +213,15 @@ function collaborationCatalog() {
   ]));
 }
 
+function unsetLongChecksGuidance(value) {
+  const choices = DIMENSIONS.longChecks;
+  return [
+    'The project has not chosen how agents handle long checks such as test suites and builds. Ask the person once, early, before running the first long check, which option they want:',
+    ...Object.entries(choices).map(([id, choice]) => `- \`${id}\`: ${choice.description}`),
+    `Record the answer with \`genesis collaboration set ${value.tone} ${value.responseLength} ${value.experience} ${value.explanationStyle} <${Object.keys(choices).join('|')}>\`. Until the person answers, use \`${LONG_CHECKS_UNTIL_CHOSEN}\`: ${choices[LONG_CHECKS_UNTIL_CHOSEN].guidance}`,
+  ].join('\n');
+}
+
 function collaborationGuidance(value) {
   return [
     'Apply the configured tone, response length, assumed experience, and explanation style to every user-facing message, including progress updates and final responses.',
@@ -217,6 +243,10 @@ function collaborationGuidance(value) {
     '## Explanation style',
     '',
     DIMENSIONS.explanationStyle[value.explanationStyle].guidance,
+    '',
+    '## Long checks',
+    '',
+    value.longChecks ? DIMENSIONS.longChecks[value.longChecks].guidance : unsetLongChecksGuidance(value),
     ...(value.requirements ? [
       '',
       '## Project requirements',
@@ -231,17 +261,17 @@ export function parseCollaborationSource(source) {
   const parsed = sections(source);
   const expected = new Set([...Object.keys(SECTION_FIELDS), 'Project requirements']);
   const unknown = [...parsed.sections.keys()].filter((name) => !expected.has(name));
-  const missing = [...expected].filter((name) => !parsed.sections.has(name));
+  const missing = [...expected].filter((name) => !parsed.sections.has(name) && !OPTIONAL_SECTIONS.has(name));
   if (unknown.length > 0 || missing.length > 0) {
     throw new GenesisError(
       'COLLABORATION_INVALID',
-      `${COLLABORATION_PATH} needs only Tone, Response length, Assumed experience, Explanation style, and Project requirements sections.`,
+      `${COLLABORATION_PATH} needs only Tone, Response length, Assumed experience, Explanation style, optional Long checks, and Project requirements sections.`,
       { path: COLLABORATION_PATH },
     );
   }
   const values = Object.fromEntries(Object.entries(SECTION_FIELDS).map(([sectionName, field]) => [
     field,
-    dimensionValue(parsed.sections, sectionName, field),
+    parsed.sections.has(sectionName) ? dimensionValue(parsed.sections, sectionName, field) : null,
   ]));
   const requirementsSource = sectionText(parsed.sections, 'Project requirements');
   if (!requirementsSource) {
@@ -296,6 +326,7 @@ function renderCollaboration(value) {
     '',
     `- \`${value.explanationStyle}\``,
     '',
+    ...(value.longChecks === null ? [] : ['## Long checks', '', `- \`${value.longChecks}\``, '']),
     '## Project requirements',
     '',
     value.requirements || '- Nothing.',
@@ -340,6 +371,7 @@ export async function inspectProjectCollaboration({ projectRoot } = {}) {
 export async function setProjectCollaboration({
   experience,
   explanationStyle,
+  longChecks,
   projectRoot,
   requirements,
   responseLength,
@@ -352,6 +384,7 @@ export async function setProjectCollaboration({
     responseLength: responseLength ?? current.responseLength,
     experience: experience ?? current.experience,
     explanationStyle: explanationStyle ?? current.explanationStyle,
+    longChecks: longChecks ?? current.longChecks,
     requirements: requirements ?? current.requirements,
   }));
   const rendered = renderCollaboration(next);
@@ -367,6 +400,7 @@ export async function setProjectCollaboration({
     responseLength: next.responseLength,
     experience: next.experience,
     explanationStyle: next.explanationStyle,
+    longChecks: next.longChecks,
     requirements: next.requirements,
     choices: collaborationCatalog(),
     guidance: collaborationGuidance(next),

package/src/index/prompt.js

@@ -167,6 +167,7 @@ function collaborationPromptContext(collaboration) {
     responseLength: collaboration.responseLength,
     experience: collaboration.experience,
     explanationStyle: collaboration.explanationStyle,
+    longChecks: collaboration.longChecks || 'unset',
     requirements: collaboration.requirements || 'Nothing.',
   };
 }