genesis-compiler 1.10.8 → 1.10.9

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.8",
+  "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.8",
+  "version": "1.10.9",
   "description": "Makes Codex aware of optional Genesis adoption for existing projects.",
   "author": {
     "name": "Mobily Enterprises"

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/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,