@almadar/skills 1.3.0 → 1.4.1

package/dist/index.js

@@ -4,6 +4,7 @@ import { generateBehaviorsDocs, getAllBehaviors, generateModulesDocs, getAllStdO
 import { OPERATORS, UI_SLOTS, PATTERN_TYPES, ViewTypeSchema } from '@almadar/core/types';
 import { getPatternPropsCompact, getPatternActionsRef, getAllPatternTypes } from '@almadar/patterns';
 import { BINDING_DOCS, CORE_BINDINGS } from '@almadar/core';
+import { generateDomainLanguageReference } from '@almadar/core/domain-language';
 
 // src/generators/utils.ts
 function formatFrontmatter(fm) {
@@ -354,22 +355,68 @@ Field types MUST be one of: \`string\`, \`number\`, \`boolean\`, \`date\`, \`tim
 { "name": "author", "type": "relation", "relation": { "entity": "User", "cardinality": "one" } }
 \`\`\`
 
-### 6. Modal State Machine Pattern
+### 6. Modal/Drawer Exit Transitions (CRITICAL \u2014 MOST COMMON ERROR)
 
-When a transition opens a modal/drawer, the target state MUST have CLOSE and CANCEL transitions:
+**EVERY state that renders to \`"modal"\` or \`"drawer"\` MUST have CANCEL and CLOSE transitions.**
+Without these, the validator rejects the schema with \`CIRCUIT_NO_OVERLAY_EXIT\`.
 
 \`\`\`json
+// Opening the modal: Browsing \u2192 Creating
 { "from": "Browsing", "to": "Creating", "event": "CREATE",
-  "effects": [["render-ui", "modal", { "type": "form-section", "cancelEvent": "CANCEL", ... }]] },
+  "effects": [["render-ui", "modal", { "type": "form-section", "entity": "Task", "submitEvent": "SAVE", "cancelEvent": "CANCEL" }]] },
+
+// REQUIRED: CANCEL exit (form cancel button)
 { "from": "Creating", "to": "Browsing", "event": "CANCEL",
   "effects": [["render-ui", "modal", null]] },
+
+// REQUIRED: CLOSE exit (click outside / press Escape)
 { "from": "Creating", "to": "Browsing", "event": "CLOSE",
   "effects": [["render-ui", "modal", null]] },
+
+// SAVE also dismisses modal
 { "from": "Creating", "to": "Browsing", "event": "SAVE",
-  "effects": [["persist", "create", "Entity", "@payload.data"], ["render-ui", "modal", null], ["emit", "INIT"]] }
+  "effects": [["persist", "create", "Task", "@payload.data"], ["render-ui", "modal", null], ["emit", "INIT"]] }
+\`\`\`
+
+**Checklist for EVERY modal/drawer state:**
+- [ ] Has \`CANCEL\` transition \u2192 previous state with \`["render-ui", "modal", null]\`
+- [ ] Has \`CLOSE\` transition \u2192 previous state with \`["render-ui", "modal", null]\`
+- [ ] Has \`SAVE\` (or other action) transition that also dismisses with \`["render-ui", "modal", null]\`
+
+**This applies to ALL states**: Creating, Editing, Viewing, Deleting \u2014 any state that renders to modal/drawer.
+
+### 7. Valid Slots ONLY
+
+render-ui slots MUST be one of: \`"main"\`, \`"modal"\`, \`"drawer"\`, \`"sidebar"\`
+
+\`\`\`json
+// WRONG - invented slots:
+["render-ui", "modal-close", null]
+["render-ui", "notification", { ... }]
+["render-ui", "confirm-modal", { ... }]
+
+// CORRECT:
+["render-ui", "modal", null]
+["render-ui", "main", { ... }]
 \`\`\`
 
-**CLOSE** = user clicks outside modal/presses Escape. **CANCEL** = form cancel button. Both needed.
+### 8. Every render-ui Pattern MUST Have "type"
+
+Every pattern object in render-ui MUST include a \`"type"\` field. This applies to the top-level pattern AND every child in a stack.
+
+\`\`\`json
+// WRONG - missing type:
+["render-ui", "main", { "entity": "Product", "columns": ["name"] }]
+
+// CORRECT:
+["render-ui", "main", { "type": "entity-table", "entity": "Product", "columns": ["name"] }]
+
+// WRONG - child missing type:
+{ "type": "stack", "children": [{ "text": "Hello" }] }
+
+// CORRECT:
+{ "type": "stack", "children": [{ "type": "typography", "text": "Hello" }] }
+\`\`\`
 `;
 }
 function getEdgeCaseErrors() {
@@ -390,12 +437,15 @@ WRONG: Two traits both render to "main" on page load
 CORRECT: ONE trait owns each slot
 \`\`\`
 
-### 9. Missing submitEvent in form-section
+### 9. Missing submitEvent / Wrong Action Pattern in form-section
 \`\`\`
 WRONG: { "type": "form-section", "entity": "Task" }
 ALSO WRONG: { "type": "form-section", "entity": "Task", "onSubmit": "SAVE" }
+ALSO WRONG: { "type": "form-section", "actions": [{"label": "Save", "event": "SAVE"}] }
 CORRECT: { "type": "form-section", "entity": "Task", "submitEvent": "SAVE", "cancelEvent": "CANCEL" }
 \`\`\`
+**form-section does NOT use \`actions\` array** \u2014 it uses \`submitEvent\` and \`cancelEvent\` strings.
+The \`actions\` prop is for \`page-header\`, \`entity-detail\`, NOT for forms.
 
 ### 10. Duplicate Transitions (Same from+event)
 \`\`\`
@@ -527,10 +577,11 @@ function getDecompositionSection() {
 | game | none | none | none | none |
 | form | wizard | drawer | page | confirm |
 
-### Step 3: Choose Traits
-- Business: EntityManagement (handles CRUD via render-ui)
+### Step 3: Choose Traits (UNIQUE NAMES REQUIRED)
+- Business: \`{Entity}Management\` naming \u2014 e.g., \`ProductManagement\`, \`OrderManagement\`, \`CustomerManagement\`
 - Game: Physics2D, Health, Score, Collision
 - Form: Wizard (multi-step) or FormSubmission (single)
+- **NEVER reuse the same trait name across orbitals. Each trait name MUST be globally unique.**
 
 ### Step 4: Define State Machine
 \`\`\`
@@ -628,10 +679,11 @@ function getDecompositionCompact() {
 | game | none | none | none | none |
 | form | wizard | drawer | page | confirm |
 
-### Step 3: Choose Traits
-- Business: EntityManagement (handles CRUD via render-ui)
+### Step 3: Choose Traits (UNIQUE NAMES REQUIRED)
+- Business: \`{Entity}Management\` naming \u2014 e.g., \`ProductManagement\`, \`OrderManagement\`, \`CustomerManagement\`
 - Game: Physics2D, Health, Score, Collision
 - Form: Wizard (multi-step) or FormSubmission (single)
+- **NEVER reuse the same trait name across orbitals. Each trait name MUST be globally unique.**
 
 ### Step 4: Define State Machine
 \`\`\`
@@ -808,10 +860,20 @@ function getBindingsGuide() {
     "",
     "| \u274C Invalid | \u2705 Correct |",
     "|------------|------------|",
-    '| `@count` | Use `stats` pattern or static text (e.g., `"Total Tasks"`) |',
-    "| `@count:status=pending` | Use filtered entity-table or static labels |",
+    '| `@count(tasks)` | Use static text `"Total Tasks"` or add a `taskCount` field to entity |',
+    "| `@find(orders, id=@payload.id)` | Use `@payload.data` \u2014 the runtime resolves entities |",
+    "| `@categories.find(c => c.id === @payload.id)` | Use `@payload.data` \u2014 no JavaScript in bindings |",
+    "| `@sum(orders, totalAmount)` | Add a `totalAmount` field to the entity |",
+    '| `@formatDate(@entity.createdAt, "MMM dd")` | Use `@entity.createdAt` \u2014 formatting is UI-side |',
+    "| `@length(items)` | Use `@entity.itemCount` \u2014 add the field to entity |",
+    "| `@filter(...)` | No function-call syntax exists in bindings |",
+    "| `@inc(@payload.delta)` | Use `@payload.data` or `@entity.field` |",
+    "| `@count` | Use static text or add a count field to entity |",
     "| `@entity.task.title` | `@entity.title` (entity type is implicit) |",
     "| `@payload.field` in `set` effect | `@entity.field` (set modifies entity only) |",
+    "| `@entity` (bare, no path) | `@entity.data` or `@entity.fieldName` \u2014 path required |",
+    "",
+    "**ABSOLUTE RULE**: Bindings are ONLY `@root.path` (e.g., `@entity.name`). NO function calls, NO JavaScript expressions, NO query syntax. If you need computed values, add a field to the entity.",
     ""
   );
   return lines.join("\n");
@@ -1893,7 +1955,7 @@ For schemas exceeding 40KB, use the **chunking tools** instead of direct editing
 | \`extract_chunk\` | Extract orbital/trait to \`.chunks/chunk-{id}.json\` |
 | \`apply_chunk\` | Merge edited chunk back into schema |
 
-**Note**: These tools work with both \`schema.json\` and \`schema.orb\` files. Changes are auto-persisted.
+**Note**: These tools work with \`schema.orb\` files. Changes are auto-persisted.
 
 ### Chunking Workflow
 
@@ -2368,7 +2430,7 @@ function getCompletionRulesSection() {
 4. Do NOT "verify" or "confirm"
 5. Do NOT validate again
 
-The validated schema.json IS your only deliverable.`;
+The validated schema.orb IS your only deliverable.`;
 }
 
 // src/prompts/skill-sections/game-guidance.ts
@@ -2914,6 +2976,21 @@ function getToolWorkflowSection() {
 Break requirements into OrbitalUnits (pure reasoning, no tools).
 
 ### Phase 2: GENERATE
+
+**Option A: Orchestrated Generation (RECOMMENDED for 3+ orbitals)**
+Use \`generate_schema_orchestrated\` for automatic complexity-based routing:
+
+\`\`\`
+generate_schema_orchestrated({ prompt: "Full app description with all entities and features" })
+\`\`\`
+
+This tool automatically:
+- Decomposes your requirements
+- Routes simple/medium (1-3 orbitals) to fast single-provider
+- Routes complex (4+ orbitals) to parallel multi-provider
+- Returns a complete schema with all orbitals
+
+**Option B: Per-Orbital Generation (for simple cases or fine-grained control)**
 Call \`generate_orbital\` for each orbital:
 
 \`\`\`
@@ -2924,8 +3001,16 @@ generate_orbital({ orbital: {...}, orbitalIndex: 1, totalOrbitals: N })
 
 Each orbital is written to \`.orbitals/<name>.json\` with ALL effects (render-ui, persist, emit, set, etc.).
 
-### Phase 3: VALIDATE (CRITICAL)
-After generating ALL orbitals, validate BEFORE calling finish_task:
+### Phase 3: COMBINE
+Call \`finish_task\` to auto-combine orbitals into schema.orb:
+
+\`\`\`
+finish_task({ appName: "App" })
+# Reads .orbitals/*.json \u2192 schema.orb \u2192 orbital validate
+\`\`\`
+
+### Phase 4: VALIDATE (CRITICAL)
+After combining, validate the schema:
 
 \`\`\`
 validate_schema()
@@ -2938,21 +3023,13 @@ validate_schema()
 
 **Common errors to fix:**
 - ORB_E_MISSING_NAME \u2192 Add entity name
-- ORB_E_NO_FIELDS \u2192 Add entity fields  
+- ORB_E_NO_FIELDS \u2192 Add entity fields
 - Missing entity field \u2192 Add entity object with name and fields
 
 **CRITICAL: Check EACH orbital file in .orbitals/ directory:**
 Use Read tool to check each orbital file has entity field.
 
-### Phase 4: COMBINE
-Call \`finish_task\` to auto-combine:
-
-\`\`\`
-finish_task({ appName: "App" })
-# Reads .orbitals/*.json \u2192 schema.json \u2192 orbital validate
-\`\`\`
-
-### Phase 4: VERIFY COMPOSITION QUALITY
+### Phase 5: VERIFY COMPOSITION QUALITY
 
 Before calling \`finish_task\`, verify each INIT transition:
 
@@ -3243,7 +3320,16 @@ Every orbital MUST have this exact structure:
 - \u274C WRONG: Missing entity field at orbital level
 - \u274C WRONG: Only linkedEntity in trait, no orbital.entity
 - \u274C WRONG: Empty fields array
+- \u274C WRONG: Using \`@count(tasks)\`, \`@find(...)\`, \`@sum(...)\` \u2014 NO function-call bindings exist
+- \u274C WRONG: Using \`actions\` array on form-section \u2014 use \`submitEvent\`/\`cancelEvent\` strings
+- \u274C WRONG: Modal state without CANCEL/CLOSE transitions
+- \u274C WRONG: Bare \`@entity\` without a field path \u2014 use \`@entity.fieldName\`
+- \u274C WRONG: \`@Product.name\`, \`@Order.status\`, \`@Customer.email\` \u2014 NEVER use entity TYPE as binding root
+- \u274C WRONG: \`@count(orders)\`, \`@sum(orders, total)\`, \`@avg(...)\` \u2014 NO aggregate functions exist
 - \u2705 CORRECT: Full entity object with name, collection, persistence, fields
+- \u2705 CORRECT: \`@entity.name\`, \`@entity.status\`, \`@entity.email\` \u2014 ALWAYS use \`@entity\` as the root
+- \u2705 CORRECT: Only valid binding roots: \`@entity\`, \`@payload\`, \`@state\`, \`@now\`, \`@config\`
+- \u2705 CORRECT: Every state rendering to modal/drawer has CANCEL + CLOSE transitions back
 
 ## Field Types
 
@@ -3263,10 +3349,21 @@ Every orbital MUST have this exact structure:
 - INIT effect: render-ui with stack containing header, metrics, entity-table
 
 **Transitions:**
-- Browsing \u2192 Creating: on CREATE
-- Creating \u2192 Browsing: on SAVE or CANCEL
-- Browsing \u2192 Editing: on EDIT
-- Editing \u2192 Browsing: on SAVE or CANCEL
+- Browsing \u2192 Creating: on CREATE (render modal with form-section using submitEvent/cancelEvent)
+- Creating \u2192 Browsing: on SAVE (persist + dismiss modal + emit INIT)
+- Creating \u2192 Browsing: on CANCEL (dismiss modal: ["render-ui", "modal", null])
+- Creating \u2192 Browsing: on CLOSE (dismiss modal: ["render-ui", "modal", null])
+- Browsing \u2192 Editing: on EDIT (render modal with form-section)
+- Editing \u2192 Browsing: on SAVE, CANCEL, CLOSE (same pattern as Creating)
+
+**CRITICAL: Every state that renders to "modal" or "drawer" MUST have CANCEL and CLOSE transitions.**
+
+## form-section Props (NOT actions)
+
+form-section uses \`submitEvent\`/\`cancelEvent\`, NOT \`actions\` array:
+\`\`\`json
+{ "type": "form-section", "entity": "Task", "fields": ["title", "status"], "submitEvent": "SAVE", "cancelEvent": "CANCEL" }
+\`\`\`
 
 ## Effects Reference
 
@@ -3274,11 +3371,32 @@ Every orbital MUST have this exact structure:
 |--------|--------|---------|
 | render-ui | ["render-ui", "main", { ... }] | Render UI pattern |
 | render-ui | ["render-ui", "modal", { ... }] | Render modal |
+| render-ui | ["render-ui", "modal", null] | Dismiss modal |
 | persist | ["persist", "create", "Entity", "@payload.data"] | Save to DB |
 | set | ["set", "@entity.field", value] | Update field |
 | emit | ["emit", "EVENT", payload] | Emit event |
 | navigate | ["navigate", "/path"] | Navigate |
 
+## Valid Slots (ONLY these exist)
+
+\`"main"\`, \`"modal"\`, \`"drawer"\`, \`"sidebar"\`
+
+NEVER use: \`"modal-close"\`, \`"notification"\`, \`"confirm-modal"\`, \`"header"\`, \`"footer"\`
+
+## Pattern Type Required
+
+EVERY pattern object in render-ui MUST have a \`"type"\` field. This includes the top-level pattern AND every child in a stack's children array.
+
+## FINAL CHECKLIST (read before generating)
+
+1. **NO aggregate bindings**: \`@count(...)\`, \`@sum(...)\`, \`@avg(...)\` DO NOT EXIST. Use static text or add a count field to the entity instead.
+2. **form-section uses submitEvent/cancelEvent**: \`{ "type": "form-section", "entity": "X", "submitEvent": "SAVE", "cancelEvent": "CANCEL" }\`. NEVER put \`"actions"\` array on form-section \u2014 \`actions\` is for page-header and entity-detail only.
+3. **Arrays not objects**: \`fields\`, \`states\`, \`events\`, \`transitions\`, \`children\` MUST be arrays \`[]\`, NEVER objects \`{}\`.
+4. **Every render-ui child needs "type"**: \`{ "type": "typography", "text": "..." }\` not \`{ "text": "..." }\`
+5. **Valid slots only**: \`"main"\`, \`"modal"\`, \`"drawer"\`, \`"sidebar"\` \u2014 nothing else.
+6. **Binding roots**: ONLY \`@entity.field\`, \`@payload.field\`, \`@state\`, \`@now\`, \`@config\`. NEVER \`@Order.field\` or \`@count()\`.
+7. **Trait naming**: Name the trait \`{Entity}Interaction\` (e.g., \`CustomerInteraction\`, \`OrderInteraction\`). The page ref MUST match: \`"traits": [{ "ref": "CustomerInteraction" }]\`.
+
 ## Output Requirements
 
 Return ONLY valid JSON. No markdown, no explanations.
@@ -3291,7 +3409,7 @@ function generateKflowOrbitalsSkill(compact = false) {
   const frontmatter = {
     name: "kflow-orbitals",
     description: "Generate KFlow schemas using the Orbitals composition model. Decomposes applications into atomic Orbital Units (Entity x Traits x Patterns) with structural caching for efficiency.",
-    allowedTools: ["Read", "Write", "Edit", "generate_orbital", "finish_task", "query_schema_structure", "extract_chunk", "apply_chunk"],
+    allowedTools: ["Read", "Write", "Edit", "generate_orbital", "generate_schema_orchestrated", "finish_task", "query_schema_structure", "extract_chunk", "apply_chunk"],
     version: "5.0.0"
     // v5.0: atomic composition (removed design_transition, single-pass design)
   };
@@ -3387,14 +3505,14 @@ ${getCompletionRulesSection()}
 
 \`\`\`
 \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
-\u2502  ALWAYS write to: schema.json                                        \u2502
+\u2502  ALWAYS write to: schema.orb                                         \u2502
 \u2502                                                                      \u2502
 \u2502  NEVER use other file names like:                                   \u2502
-\u2502  - schema_with_fixes.json  \u274C                                        \u2502
-\u2502  - new_schema.json         \u274C                                        \u2502
-\u2502  - updated_schema.json     \u274C                                        \u2502
+\u2502  - schema_with_fixes.orb   \u274C                                        \u2502
+\u2502  - new_schema.orb          \u274C                                        \u2502
+\u2502  - updated_schema.orb      \u274C                                        \u2502
 \u2502                                                                      \u2502
-\u2502  The persistence system ONLY reads from schema.json                 \u2502
+\u2502  The persistence system ONLY reads from schema.orb                  \u2502
 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
 \`\`\`
 `;
@@ -3413,7 +3531,7 @@ function generateKflowOrbitalFixingSkill() {
   const frontmatter = {
     name: metadata.name,
     description: metadata.description,
-    allowedTools: ["Read", "Edit", "Bash", "query_schema_structure", "extract_chunk", "apply_chunk"],
+    allowedTools: ["Read", "Edit", "Bash", "fix_schema_orchestrated", "query_schema_structure", "extract_chunk", "apply_chunk"],
     version: metadata.version
   };
   const content = generateLeanFixingSkill({
@@ -3427,36 +3545,6 @@ function generateKflowOrbitalFixingSkill() {
     content
   };
 }
-
-// src/generators/domain-language.ts
-var ODL_SYNTAX_REFERENCE = `
-## Domain Language Syntax
-
-Entity: \`A [Name] is a [persistent] entity that: - has [field] as [type]\`
-Page: \`[PageName] at /[path]: - shows [Entity] using [Behavior]\`
-`;
-var ODL_EXAMPLES = `
-## Examples
-
-\`\`\`
-A Task is a persistent entity that:
-  - has title as text (required)
-  - has status as enum [pending, active, done]
-
-TasksPage at /tasks:
-  - shows Task using List behavior
-\`\`\`
-`;
-var ODL_PATTERNS = `
-## Patterns
-
-Use patterns like entity-table, form-section in domain language.
-`;
-var ODL_TO_SCHEMA_MAPPING = `
-## Mapping
-
-Domain language converts to OrbitalSchema JSON via compiler.
-`;
 function generateDomainLanguageSkill() {
   const frontmatter = {
     name: "domain-language",
@@ -3490,21 +3578,9 @@ Create human-readable summaries of existing domain language definitions.
 
 Make targeted edits to existing domain language text.
 
-## Domain Language Syntax Reference
+## Domain Language Reference
 
-${ODL_SYNTAX_REFERENCE}
-
-## Patterns Reference
-
-${ODL_PATTERNS}
-
-## Full Examples
-
-${ODL_EXAMPLES}
-
-## Mapping to Schema
-
-${ODL_TO_SCHEMA_MAPPING}
+${generateDomainLanguageReference()}
 
 ## Generation Workflow
 
@@ -3665,7 +3741,7 @@ var LEAN_DECOMPOSITION_PROTOCOL = `
 3. Create pages for each entity (list, create, edit)
 4. Apply std behaviors (List, Detail, Form)
 `;
-var ODL_SYNTAX_REFERENCE2 = `
+var ODL_SYNTAX_REFERENCE = `
 ## Domain Language Syntax
 
 **Entity**:
@@ -3709,13 +3785,13 @@ var LEAN_COMMON_ERRORS = `
 - Don't create separate create/edit/view pages
 - Use std behaviors
 `;
-var ODL_PATTERNS2 = `
+var ODL_PATTERNS = `
 ## Patterns
 
 Entity patterns: entity-table, entity-list, entity-cards
 Form patterns: form-section
 `;
-var ODL_TO_SCHEMA_MAPPING2 = `
+var ODL_TO_SCHEMA_MAPPING = `
 ## Mapping
 
 Domain language is converted to OrbitalSchema JSON by the compiler.
@@ -3758,7 +3834,7 @@ ${LEAN_OUTPUT_FORMAT}
 
 ---
 
-${ODL_SYNTAX_REFERENCE2}
+${ODL_SYNTAX_REFERENCE}
 
 ---
 
@@ -3774,11 +3850,11 @@ ${LEAN_COMMON_ERRORS}
 
 ---
 
-${ODL_PATTERNS2}
+${ODL_PATTERNS}
 
 ---
 
-${ODL_TO_SCHEMA_MAPPING2}
+${ODL_TO_SCHEMA_MAPPING}
 
 ---
 
@@ -3991,7 +4067,7 @@ var LEAN_VALIDATION_RULES2 = `
 - Page paths must be unique
 - Behaviors must be from std library
 `;
-var ODL_SYNTAX_REFERENCE3 = `
+var ODL_SYNTAX_REFERENCE2 = `
 ## Domain Language Syntax
 
 See kflow-lean-orbitals skill for full syntax reference.
@@ -4001,7 +4077,7 @@ var LEAN_EFFECT_GUARD_SYNTAX2 = `
 
 Use S-expressions in domain language for guards and effects.
 `;
-var ODL_TO_SCHEMA_MAPPING3 = `
+var ODL_TO_SCHEMA_MAPPING2 = `
 ## Schema Mapping
 
 Domain language maps to OrbitalSchema JSON structure.
@@ -4157,7 +4233,7 @@ A Task is a persistent entity that:
 
 ---
 
-${ODL_SYNTAX_REFERENCE3}
+${ODL_SYNTAX_REFERENCE2}
 
 ---
 
@@ -4169,7 +4245,7 @@ ${LEAN_VALIDATION_RULES2}
 
 ---
 
-${ODL_TO_SCHEMA_MAPPING3}
+${ODL_TO_SCHEMA_MAPPING2}
 
 ---