genesis-compiler 1.10.7 → 1.10.9

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/docs/stack-components.md

@@ -223,8 +223,11 @@ the installed Skill do not rewrite what an already-run command proved.
 
 `City regions` and `Indexers` control only the derived structural maps. Indexers
 identify language adapters. City regions can exclude test/spec paths and group
-indexed files into deterministic regions and campuses. Both projections are
-navigation data, not proof of complete runtime behavior.
+indexed files into deterministic regions and campuses. A project adds its own
+exclusions, such as example fixtures, in a `## City exclusions` section of
+`genesis/stack.md` with the same ``- Ignore `glob` `` lines (or `- Nothing.`);
+they add to the component exclusions. Both projections are navigation data, not
+proof of complete runtime behavior.
 
 ## Project customization
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "genesis-compiler",
-  "version": "1.10.7",
+  "version": "1.10.9",
   "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.9",
   "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/skills/genesis-project/SKILL.md

@@ -151,13 +151,26 @@ technology's workspace substrate exists. Finishing an item or resuming a
 session does not itself require a broad verification run. Keep full output in
 local artifacts, preserve exit status, and read summaries and relevant failure
 excerpts before expanding logs. Do not weaken assertions or omit required
-coverage to save time or tokens. An unconfigured result
-means the declared workspace or checks do not exist yet; it is not a failing
-check. Before reporting completion, compare the requested observable behavior,
-required inputs and resources, declared project operations, and focused evidence
-with what actually exists. Report files changed, checks actually run,
-anything not proven, and anything still requiring attention. Never claim that
-an unrun check passed or that passing checks prove the whole product.
+coverage to save time or tokens.
+
+A change to user-visible behavior ships with the browser specs that cover it
+updated and run in the same change, before pushing. When an existing spec
+fails, first classify it as outdated (the behavior changed on purpose) or as a
+regression. Fix regressions in the product, and change a spec only for an
+intended change, naming the change that made it outdated. Test resources a
+managed host supplies, such as a login state, base URL, browser, or ports, are
+the host's contract. If they do not work (for example, tests run signed out
+despite a supplied login), report the host defect with evidence and stop; never
+compensate in the project by rewriting cookies or adding its own login or
+browser.
+
+An unconfigured result means the declared workspace or checks do not exist
+yet; it is not a failing check. Before reporting completion, compare the
+requested observable behavior, required inputs and resources, declared project
+operations, and focused evidence with what actually exists. Report files
+changed, checks actually run, anything not proven, and anything still requiring
+attention. Never claim that an unrun check passed or that passing checks prove
+the whole product.
 
 ## Subsystem maintenance
 

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.',
   };
 }

package/src/index/stack-city-presentation.js

@@ -7,8 +7,8 @@ const FALLBACK_LINE = /^- Fallback `([^`]+)` as `([^`]+)`[ \t]*$/u;
 const REGEXP_SPECIAL = /[.+^${}()|[\]\\]/u;
 const compiledGlobPatterns = new Map();
 
-function invalid(piecePath, message) {
-  throw new GenesisError('STACK_PIECE_INVALID', message, { path: piecePath });
+function invalid(piecePath, message, code = 'STACK_PIECE_INVALID') {
+  throw new GenesisError(code, message, { path: piecePath });
 }
 
 function normalizedPrefix(value, piecePath) {
@@ -25,7 +25,7 @@ function normalizedPrefix(value, piecePath) {
   return prefix;
 }
 
-function normalizedGlob(value, piecePath) {
+function normalizedGlob(value, piecePath, { code, section = 'City regions' } = {}) {
   const pattern = String(value || '').trim();
   if (
     !pattern
@@ -37,7 +37,8 @@ function normalizedGlob(value, piecePath) {
   ) {
     invalid(
       piecePath,
-      '## City regions ignore patterns must be canonical project-relative globs using only * and ** wildcards.',
+      `## ${section} ignore patterns must be canonical project-relative globs using only * and ** wildcards.`,
+      code,
     );
   }
   return pattern;
@@ -156,6 +157,27 @@ export function parseStackCityPresentationLines(lines, { path = 'stack piece' }
   return { exclusions, regions };
 }
 
+/**
+ * A project's own `## City exclusions` section removes paths no selected
+ * component can know about, such as example fixtures. It uses the City regions
+ * Ignore grammar and adds to the component exclusions.
+ */
+export function parseProjectCityExclusionLines(lines, { path }) {
+  if (lines === undefined) return [];
+  const content = lines.filter((line) => line.trim());
+  if (content.length === 1 && content[0].trim() === '- Nothing.') return [];
+  const options = { code: 'STACK_INVALID', section: 'City exclusions' };
+  const exclusions = content.map((line) => {
+    const ignore = line.match(IGNORE_LINE);
+    if (!ignore) invalid(path, '## City exclusions entries must each be one Ignore with a glob.', options.code);
+    return normalizedGlob(ignore[1], path, options);
+  });
+  if (exclusions.length === 0 || new Set(exclusions).size !== exclusions.length) {
+    invalid(path, '## City exclusions needs distinct Ignore entries or `- Nothing.`.', options.code);
+  }
+  return exclusions;
+}
+
 export function composeStackCityPresentation(components = []) {
   const owners = components.filter((component) => (
     component.cityRegions.length > 0 || component.cityExclusions.length > 0

package/src/index/stack.js

@@ -7,7 +7,10 @@ import {
   normalizeStackPackageName,
   readStackCatalog,
 } from './stack-catalog.js';
-import { composeStackCityPresentation } from './stack-city-presentation.js';
+import {
+  composeStackCityPresentation,
+  parseProjectCityExclusionLines,
+} from './stack-city-presentation.js';
 import { parseUiDiscovery } from './stack-ui-discovery.js';
 import { parsePackageDiscovery } from './stack-package-discovery.js';
 import { resolveStackPieces } from './stack-composition.js';
@@ -371,6 +374,13 @@ async function readStackWithContractMode(projectRoot, {
     source: 'project',
     diagnostics: [],
   }));
+  const cityExclusions = [...new Set([
+    ...cityPresentation.exclusions,
+    ...parseProjectCityExclusionLines(
+      extensions.find(entry => entry.name === 'City exclusions')?.lines,
+      { path: STACK_PATH },
+    ),
+  ])];
   const uiDiscovery = parseUiDiscovery(extensions.find(entry => entry.name === 'UI discovery')?.lines);
   const packageDiscovery = parsePackageDiscovery(extensions.find(entry => entry.name === 'Package discovery')?.lines);
   return {
@@ -378,7 +388,7 @@ async function readStackWithContractMode(projectRoot, {
     identityHash: sha256(stableJson({
       stackPackages: declaredPackages,
       components: components.map(({ id }) => id),
-      cityExclusions: cityPresentation.exclusions,
+      cityExclusions,
       cityRegions: cityPresentation.regions,
       verificationCommands: verificationCommands.map(({ label, argv }) => ({ label, argv })),
       environmentDefaults,
@@ -388,7 +398,7 @@ async function readStackWithContractMode(projectRoot, {
     })),
     components,
     stackPackages: declaredPackages,
-    cityExclusions: cityPresentation.exclusions,
+    cityExclusions,
     cityRegions: cityPresentation.regions,
     uiDiscovery,
     packageDiscovery,