@almadar/skills 2.0.4 → 2.1.0

package/dist/index.d.ts

@@ -107,6 +107,21 @@ declare function generateKflowOrbitalFixingSkill(): GeneratedSkill;
  */
 declare function generateDomainLanguageSkill(): GeneratedSkill;
 
+/**
+ * Almadar Assistant Skill Generator
+ *
+ * Generates the almadar-assistant skill: a Q&A assistant that knows
+ * about Almadar, Orb, Studio, Services, and the full platform.
+ * Used by the website chat widget across all four sites.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Generate the almadar-assistant skill.
+ */
+declare function generateAlmadarAssistantSkill(): GeneratedSkill;
+
 /**
  * Lean Orbital Skill Generator
  *
@@ -217,19 +232,20 @@ declare function generateLeanFixingSkill(options?: LeanFixingSkillOptions): stri
 /**
  * Skill Generators for Builder Client
  *
- * Re-exports the 5 core skills used by the builder client:
+ * Re-exports the 6 core skills used by the builder client:
  * 1. kflow-orbitals (standard JSON generation with atomic composition)
  * 2. kflow-orbital-fixing (standard fixing)
  * 3. kflow-lean-orbitals (lean domain language generation)
  * 4. kflow-lean-fixing (lean fixing)
  * 5. domain-language (ODL understanding/summarization)
+ * 6. almadar-assistant (company/platform Q&A knowledge assistant)
  *
  * @packageDocumentation
  */
 
 /**
  * Generate all builder client skills.
- * These are the 5 skills actually used by the builder UI.
+ * These are the 6 skills actually used by the builder UI.
  */
 declare function generateAllBuilderSkills(): GeneratedSkill[];
 
@@ -741,4 +757,4 @@ type SkillsServiceActions = {
  */
 type SkillsServiceContract = ServiceContract<SkillsServiceActions>;
 
-export { type CompositionMetrics, EVAL_CASES, type EvalCase, type EvalResult, type GeneratedSkill, type ProviderComparison, type ScoreBreakdown, type SkillFrontmatter, type SkillsServiceActions, type SkillsServiceContract, analyzeComposition, calculateTotalScore, formatFrontmatter, generateAllBuilderSkills, generateComparisonMatrix, generateDomainLanguageSkill, generateKflowOrbitalFixingSkill, generateKflowOrbitalsSkill, generateLeanFixingSkill$1 as generateLeanFixingSkill, generateLeanFixingSkill as generateLeanFixingSkillFull, generateLeanOrbitalSkill$1 as generateLeanOrbitalSkill, generateLeanOrbitalSkill as generateLeanOrbitalSkillFull, getArchitectureSection, getAssetRefSection, getBannedProps, getBindingContextRules, getBindingsCompact, getBindingsGuide, getCommonErrorsSection, getCommonFixPatternsSection, getCompletionRulesSection, getConnectivityCompact, getContextUsageCompact, getContextUsageSection, getCustomTraitCompact, getCustomTraitSection, getDecompositionChecklist, getDecompositionCompact, getDecompositionSection, getDesignErrorsCompact, getDesignErrorsSection, getEfficiencySection, getFieldTypesCompact, getFixingWorkflowSection, getFlowPatternSection, getFullOrbitalPrompt, getGameAsOrbitalsSection, getGameEntityTemplatesSection, getGamePatternsSection, getGameTraitsSection, getGameTypesSection, getIconLibraryCompact, getIconLibrarySection, getKeyBehaviorsReference, getMinimalTypeReference, getMultiFileSection, getOrbitalConnectivitySection, getOrbitalDecompositionPrompt, getOverGenerationSection, getPatternTypesCompact, getPortableOrbitalOutputSection, getRenderUIDesignGuide, getRenderUIQuickRef, getRequirementsDecomposePrompt, getRequirementsTraitPrompt, getSExprQuickRef, getSchemaUpdateCompact, getSchemaUpdateSection, getSubagentSystemPrompt, getThemeGuide, getUsesImportCompact, getUsesImportSection, getValidationHintsSection, writeAllSkills, writeSkill };
+export { type CompositionMetrics, EVAL_CASES, type EvalCase, type EvalResult, type GeneratedSkill, type ProviderComparison, type ScoreBreakdown, type SkillFrontmatter, type SkillsServiceActions, type SkillsServiceContract, analyzeComposition, calculateTotalScore, formatFrontmatter, generateAllBuilderSkills, generateAlmadarAssistantSkill, generateComparisonMatrix, generateDomainLanguageSkill, generateKflowOrbitalFixingSkill, generateKflowOrbitalsSkill, generateLeanFixingSkill$1 as generateLeanFixingSkill, generateLeanFixingSkill as generateLeanFixingSkillFull, generateLeanOrbitalSkill$1 as generateLeanOrbitalSkill, generateLeanOrbitalSkill as generateLeanOrbitalSkillFull, getArchitectureSection, getAssetRefSection, getBannedProps, getBindingContextRules, getBindingsCompact, getBindingsGuide, getCommonErrorsSection, getCommonFixPatternsSection, getCompletionRulesSection, getConnectivityCompact, getContextUsageCompact, getContextUsageSection, getCustomTraitCompact, getCustomTraitSection, getDecompositionChecklist, getDecompositionCompact, getDecompositionSection, getDesignErrorsCompact, getDesignErrorsSection, getEfficiencySection, getFieldTypesCompact, getFixingWorkflowSection, getFlowPatternSection, getFullOrbitalPrompt, getGameAsOrbitalsSection, getGameEntityTemplatesSection, getGamePatternsSection, getGameTraitsSection, getGameTypesSection, getIconLibraryCompact, getIconLibrarySection, getKeyBehaviorsReference, getMinimalTypeReference, getMultiFileSection, getOrbitalConnectivitySection, getOrbitalDecompositionPrompt, getOverGenerationSection, getPatternTypesCompact, getPortableOrbitalOutputSection, getRenderUIDesignGuide, getRenderUIQuickRef, getRequirementsDecomposePrompt, getRequirementsTraitPrompt, getSExprQuickRef, getSchemaUpdateCompact, getSchemaUpdateSection, getSubagentSystemPrompt, getThemeGuide, getUsesImportCompact, getUsesImportSection, getValidationHintsSection, writeAllSkills, writeSkill };

package/dist/index.js

@@ -419,6 +419,62 @@ Every pattern object in render-ui MUST include a \`"type"\` field. This applies
 // CORRECT:
 { "type": "stack", "children": [{ "type": "typography", "text": "Hello" }] }
 \`\`\`
+
+### 9. Form Actions on Non-Form Patterns (CIRCUIT_ACTION_COMPONENT_MISMATCH)
+
+**CANCEL, SAVE, SUBMIT, RESET are FORM actions.** They are ONLY valid in states that render form patterns (\`form-section\`, \`form\`).
+
+Delete confirmation dialogs use \`alert\` or \`confirmation\` patterns, NOT \`form-section\`. So they must NOT use \`CANCEL\` as an action event.
+
+\`\`\`json
+// WRONG - CANCEL is a form action, but alert is NOT a form pattern:
+{ "from": "Browsing", "to": "Deleting", "event": "DELETE",
+  "effects": [["render-ui", "modal", {
+    "type": "alert", "variant": "danger", "title": "Delete?",
+    "actions": [
+      { "label": "Cancel", "event": "CANCEL" },
+      { "label": "Delete", "event": "CONFIRM_DELETE" }
+    ]
+  }]] }
+
+// CORRECT - use CLOSE (not CANCEL) to dismiss non-form modals:
+{ "from": "Browsing", "to": "Deleting", "event": "DELETE",
+  "effects": [["render-ui", "modal", {
+    "type": "alert", "variant": "danger", "title": "Delete?",
+    "actions": [
+      { "label": "Cancel", "event": "CLOSE" },
+      { "label": "Delete", "event": "CONFIRM_DELETE" }
+    ]
+  }]] }
+\`\`\`
+
+**Rule:** In non-form modal states (alert, confirmation, detail-panel), use \`CLOSE\` to dismiss. Reserve \`CANCEL\` for \`form-section\` states only.
+
+### 10. Dead Handler: Action Fires Event With No Transition From Current State (CIRCUIT_DEAD_HANDLER)
+
+If a render-ui pattern in state X has an action that fires event E, there MUST be a transition \`from: X, event: E\`. A transition handling E from a DIFFERENT state does not count.
+
+\`\`\`json
+// WRONG - detail-panel in "Viewing" has Edit action firing EDIT,
+// but only Browsing handles EDIT:
+{ "from": "Browsing", "to": "Viewing", "event": "VIEW",
+  "effects": [["render-ui", "drawer", {
+    "type": "detail-panel", "entity": "Todo",
+    "actions": [{ "label": "Edit", "event": "EDIT" }]
+  }]] }
+{ "from": "Browsing", "to": "Editing", "event": "EDIT", ... }
+// No transition from: "Viewing", event: "EDIT" -> CIRCUIT_DEAD_HANDLER!
+
+// CORRECT - add transition from Viewing state:
+{ "from": "Viewing", "to": "Editing", "event": "EDIT",
+  "effects": [
+    ["render-ui", "drawer", null],
+    ["fetch", "Todo", "@payload.id"],
+    ["render-ui", "modal", { "type": "form-section", "entity": "Todo", "submitEvent": "SAVE", "cancelEvent": "CANCEL" }]
+  ] }
+\`\`\`
+
+**Rule:** For every action \`{ "event": "X" }\` in a render-ui effect of state S, verify there is a transition \`from: S, event: X\`.
 `;
 }
 function getEdgeCaseErrors() {
@@ -508,6 +564,7 @@ Use a singleton entity for filter state + \`query\` prop on entity-table:
     "fields": [{ "name": "status", "type": "string" }, { "name": "search", "type": "string" }] } }
 \`\`\`
 Reference: \`["render-ui", "main", { "type": "entity-table", "entity": "Task", "query": "@TaskQuery" }]\`
+
 `;
 }
 function getValidationHintsSection() {
@@ -527,6 +584,12 @@ function getValidationHintsSection() {
 | ORB_EFF_SET_REQUIRES_ENTITY | Change @payload.field to @entity.field in set effects |
 | ORB_RUI_UNKNOWN_ITEM_ACTION_PROP | Remove invalid props (like \`condition\`), use \`showWhen\` |
 | ORB_MODAL_NO_CLOSE | Add CLOSE/CANCEL transitions from modal states with \`["render-ui", "modal", null]\` |
+| ORB_T_EVT_UNDECLARED | Event emitted via ["emit","X"] but not in trait's emits array. Add \`{ "event": "X", "scope": "internal" }\` to emits. Use "event"+"scope" format, NOT "key"+"name". |
+| ORB_BINDING_SET_TARGET_MISSING_PATH | set target like \`@entity\` or \`@state\` has no field path. Use \`@entity.fieldName\` |
+| ORB_BINDING_STATE_NO_PATH | \`@state\` used with a field path like \`@state.field\`. \`@state\` is bare, no paths allowed. Use \`@entity.field\` instead. |
+| ORB_BINDING_ENTITY_FIELD_NOT_FOUND | Binding references \`@entity.field\` but that field doesn't exist on the entity. Add the field to entity.fields or fix the binding. |
+| ORB_T_UNDEFINED_TRAIT | Trait name in page refs doesn't match any trait definition. Often caused by malformed emits (using events format instead of emits format). |
+| ORB_EFF_FETCH_INVALID_ENTITY | fetch effect has wrong syntax. Use \`["fetch", "EntityName"]\` or \`["fetch", "EntityName", "@payload.id"]\`. NOT \`["fetch", "load", "Entity"]\`. |
 `;
 }
 
@@ -3275,6 +3338,7 @@ Every orbital MUST have this exact structure:
       "name": "TraitName",
       "category": "interaction",
       "linkedEntity": "EntityName",
+      "emits": [{ "event": "INIT", "scope": "internal" }],
       "stateMachine": {
         "states": [
           { "name": "Browsing", "isInitial": true },
@@ -3333,6 +3397,9 @@ Every orbital MUST have this exact structure:
 2. **Entity Name**: Must match the orbital's primary entity
 3. **Collection**: Plural lowercase version of entity name (e.g., "products" for Product)
 4. **Fields**: At minimum, include id, name, and relevant fields from input
+5. **Emits format**: \`"emits": [{ "event": "EVENT_NAME", "scope": "internal" }]\`. NOT \`{ "key": "...", "name": "..." }\`. The emits array declares which events the trait emits via \`["emit", "X"]\` effects.
+6. **@state is bare**: \`@state\` has NO field paths. Never write \`@state.field\`. Use \`@entity.field\` instead.
+7. **set targets @entity.field**: \`["set", "@entity.fieldName", value]\`. Never \`["set", "@state", ...]\` or \`["set", "@entity", ...]\` without a field path.
 
 ## Common Mistakes to Avoid
 
@@ -3345,10 +3412,17 @@ Every orbital MUST have this exact structure:
 - \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
+- \u274C WRONG: \`["fetch", "load", "Product"]\` or \`["fetch", "get", "Product"]\` \u2014 fetch takes entity name directly, NOT an action verb
+- \u274C WRONG: \`"emits": [{ "key": "INIT", "name": "Initialize" }]\` \u2014 this is the EVENTS format, not emits
+- \u274C WRONG: \`@state.fieldName\` \u2014 \`@state\` is bare, it has NO field paths
+- \u274C WRONG: \`["set", "@state.field", value]\` or \`["set", "@state", value]\` \u2014 set target must be \`@entity.field\`
 - \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
+- \u2705 CORRECT: \`"emits": [{ "event": "INIT", "scope": "internal" }]\` \u2014 emits uses "event"+"scope" keys
+- \u2705 CORRECT: \`@state\` is used bare (no path) \u2014 it refers to the current state name
+- \u2705 CORRECT: \`["set", "@entity.status", "active"]\` \u2014 set ALWAYS targets @entity.fieldName
 
 ## Field Types
 
@@ -3391,7 +3465,11 @@ form-section uses \`submitEvent\`/\`cancelEvent\`, NOT \`actions\` array:
 | render-ui | ["render-ui", "main", { ... }] | Render UI pattern |
 | render-ui | ["render-ui", "modal", { ... }] | Render modal |
 | render-ui | ["render-ui", "modal", null] | Dismiss modal |
+| fetch | ["fetch", "EntityName"] | Fetch all entities |
+| fetch | ["fetch", "EntityName", "@payload.id"] | Fetch one by ID |
 | persist | ["persist", "create", "Entity", "@payload.data"] | Save to DB |
+| persist | ["persist", "update", "Entity", "@payload.id", "@payload.data"] | Update entity |
+| persist | ["persist", "delete", "Entity", "@payload.id"] | Delete entity |
 | set | ["set", "@entity.field", value] | Update field |
 | emit | ["emit", "EVENT", payload] | Emit event |
 | navigate | ["navigate", "/path"] | Navigate |
@@ -3413,8 +3491,9 @@ EVERY pattern object in render-ui MUST have a \`"type"\` field. This includes th
 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()\`.
+6. **Binding roots**: ONLY \`@entity.field\`, \`@payload.field\`, \`@state\`, \`@now\`, \`@config\`. NEVER \`@Order.field\` or \`@count()\`. \`@state\` is bare (no field path). \`set\` targets MUST be \`@entity.fieldName\`.
 7. **Trait naming**: Name the trait \`{Entity}Interaction\` (e.g., \`CustomerInteraction\`, \`OrderInteraction\`). The page ref MUST match: \`"traits": [{ "ref": "CustomerInteraction" }]\`.
+8. **Emits format**: \`"emits": [{ "event": "INIT", "scope": "internal" }]\`. Every event used in \`["emit", "X"]\` effects MUST appear in the trait's emits array. The emits format uses \`"event"\`+\`"scope"\` keys, NOT \`"key"\`+\`"name"\`+\`"payload"\` (that's the stateMachine.events format).
 
 ## Output Requirements
 
@@ -3718,6 +3797,285 @@ Output the complete updated domain language text.
   };
 }
 
+// src/generators/almadar-assistant.ts
+function generateAlmadarAssistantSkill() {
+  const frontmatter = {
+    name: "almadar-assistant",
+    description: "Almadar knowledge assistant. Answers questions about the company, Orb language, Studio, Services, AI pipeline, and technical architecture.",
+    version: "1.0.0"
+  };
+  const content = `
+# Almadar Assistant
+
+You are the Almadar knowledge assistant. You answer questions about Almadar, its products, technology, and vision. You speak with authority because you have deep knowledge of the entire platform.
+
+## Persona
+
+- Friendly, direct, technical when needed, accessible when not
+- Never say "I don't know" if the answer is in your knowledge below
+- Keep answers concise (2-4 sentences for simple questions, longer for technical deep dives)
+- Use concrete examples and numbers when available
+- If asked about pricing, point users to the relevant product site
+
+## Who is Almadar?
+
+Almadar is an AI-native platform company based in Slovenia. We build three things:
+
+1. **Orb**: A formal language that describes how software systems behave, the way physics equations describe how the physical world behaves. Write the model. The compiler proves it correct. AI generates and consumes it natively. Open source.
+
+2. **Almadar Studio**: The builder where humans and AI agents collaborate to create software. Describe what you want in plain language. The AI agent generates a working .orb program. Edit it visually or in code. Preview it live. Deploy it. Every project is a Git repository.
+
+3. **Almadar Services**: AI-native infrastructure. Compute, storage, authentication, event routing, AI model hosting, observability. Every service is defined in .orb, so agents can discover, understand, and provision services programmatically.
+
+**Tagline:** "The Physics of Software. World models for the agentic era."
+
+**One sentence:** Almadar builds the language, intelligence, and infrastructure for software that understands itself.
+
+## The Core Idea: World Models of Software
+
+Traditional programming tells computers what to do step by step. Every instruction is tied to a specific framework, database, and platform. Change any of those, rewrite everything. Ask AI to generate it, and you get plausible-looking code that might work.
+
+A world model describes how things work: "A Task has a status. It starts as pending. When someone marks it complete, verify it has an assignee, transition to done, save the change, and show the updated list." That description is independent of any implementation. A compiler can turn it into a web app today, a mobile app tomorrow, or something that doesn't exist yet. The model stays the same.
+
+This is what .orb is. Not a configuration file. Not a database schema. A formal model of how a software system behaves. Because the behavior is formally specified, you can prove it correct before running it, AI can generate it reliably, and both humans and machines can reason about the same model.
+
+The parallel to physics is deliberate. A physics equation doesn't care whether you simulate it on a supercomputer or solve it on paper. It describes reality. .orb describes how software behaves regardless of what platform runs it.
+
+## What We Believe
+
+- **Software should be shared, not siloed.** Real communities need systems that can coexist, coordinate, and survive beyond any single organization.
+- **AI should build and consume software, not just assist humans using it.** The next wave is AI agents that build, deploy, and operate software systems autonomously. That requires software designed from the ground up for machines to contextualize easily.
+- **Correctness should be guaranteed, not hoped for.** If a system compiles, it works. The compiler proves every possible state is valid before a single line of code runs.
+- **Languages are the moat.** Frameworks come and go. Languages endure. SQL has been the interface to relational data for 40+ years. .orb is built to be that kind of enduring interface for application behavior.
+
+## The Orb Language
+
+### Core Formula
+
+\`\`\`
+Orbital Unit = Entity + Traits + Pages
+Application  = Sum of Orbital Units
+\`\`\`
+
+- **Entity**: Data shape (persistent, runtime, or singleton). Fields can be string, number, boolean, date, array, enum, relation, etc.
+- **Trait**: A state machine with guards, effects, and UI rendering. Every user action triggers: Event -> Guard -> Transition -> Effects -> UI Response -> back to Event (Closed Circuit Pattern).
+- **Page**: A route that binds traits to URLs and renders UI in slots (main, modal, sidebar, overlay).
+
+### Closed Circuit Pattern
+
+Every UI interaction must complete a full circuit back to the state machine. No orphan buttons. No dead-end modals. The compiler enforces this.
+
+### Effects (what traits can do)
+
+- \`render-ui\`: Show a UI pattern in a slot
+- \`persist\`: Create, update, or delete data
+- \`fetch\`: Load data from the server
+- \`emit\`: Fire a cross-orbital event
+- \`set\`: Update entity fields
+- \`navigate\`: Change the current route
+- \`notify\`: Show a notification
+- \`call-service\`: Call an external service
+
+### S-Expressions
+
+Guards and computed values use S-expressions:
+- Guards: \`["=", "@entity.status", "active"]\`, \`["and", cond1, cond2]\`
+- Math: \`["+", a, b]\`, \`["*", price, quantity]\`
+- Array: \`["count", arr]\`, \`["filter", arr, predicate]\`
+- String: \`["str/concat", a, b]\`, \`["str/upper", s]\`
+- Standard library: math/*, str/*, array/*, time/*, format/*, validate/*
+
+### Compiler Pipeline (Rust)
+
+\`\`\`
+.orb -> Parse -> Validate -> Enrich -> Inline -> Resolve -> OIR -> Backend -> Code
+\`\`\`
+
+The compiler is written in Rust. It validates with 14 validators (ORB_* error codes), converts to OIR (Orbital Intermediate Representation), then generates code for the target platform.
+
+Supported targets: TypeScript (production), Python, Rust, Android, Swift.
+
+Commands:
+- \`orbital validate schema.orb\` (validate)
+- \`orbital compile schema.orb --shell typescript\` (compile)
+- \`orbital dev schema.orb\` (dev server)
+
+## Standard Library
+
+129 reusable behaviors across 18 domains:
+
+- **Core Framework** (39): list, detail, form, modal, tabs, wizard, pagination, search, filter, sort, loading, fetch, submit, retry, notification, confirmation, undo, circuit-breaker, rate-limiter, cache, saga, and more
+- **Games** (15): platformer, RPG, strategy, puzzle mechanics
+- **Business** (22): cart, checkout, catalog, pricing, order-tracking
+- **Content** (5): article, reader, bookmark, annotation, feed
+- **Dashboard** (4): stats-panel, chart-view, KPI, report
+- **Scheduling** (4): calendar, booking, availability, reminder
+- **Workflow** (4): approval, pipeline, kanban, review
+- **Social** (4): feed, messaging, profile, reactions
+- **Education** (4): quiz, progress-tracker, grading, curriculum
+- **Media** (4): gallery, player, playlist, upload
+- **Geospatial** (3): map-view, location-picker, route-planner
+- **Finance** (3): ledger, transaction, portfolio
+- **Healthcare** (3): vitals, intake-form, prescription
+- **IoT** (3): sensor-feed, alert-threshold, device-mgmt
+- **Simulation** (3): agent-sim, rule-engine, time-step
+
+These are production-quality building blocks, not toy examples.
+
+## Our AI Identity
+
+We are not a company that wraps LLM APIs and calls it AI. We train our own models.
+
+Our neural pipeline understands software structure the way a chess engine understands board positions. It predicts errors before they happen. It evaluates thousands of potential fixes in milliseconds. It generates valid software structures from scratch.
+
+We still use LLMs (multiple providers) for natural language understanding and complex reasoning. But the core structural intelligence is ours: small, specialized models that cost almost nothing to train and nothing to run.
+
+### Neural Pipeline (6 phases)
+
+1. **Mutator**: Generates synthetic training data by mutating valid schemas
+2. **Classifier**: Predicts whether a schema is valid or invalid
+3. **Graph Transformer**: Understands schema structure as a graph
+4. **Edit Predictor**: Predicts which edits will fix a broken schema
+5. **GFlowNet**: Generates valid schemas from scratch using generative flow networks
+6. **Integration**: Combines all models into the production pipeline
+
+### AI Generation Costs
+
+- Simple app (1 orbital): ~$0.05
+- Medium app (2-3 orbitals): ~$0.10-0.15
+- Complex app (4+ orbitals): ~$0.20-0.35
+
+### Provider Strategy
+
+- Simple: Qwen 397B (~45s)
+- Medium: Qwen 397B (~2-3min)
+- Complex: Multi-provider (DeepSeek + Qwen parallel, ~5min)
+
+## Almadar Studio
+
+The builder IDE where humans and AI collaborate to create software.
+
+- Describe what you want in plain language
+- AI agent generates a working .orb program
+- Edit visually or in code
+- Preview live
+- Deploy with one click
+- Every project is a Git repository, every change is a commit
+- Desktop app and web app
+
+**Business model:** Freemium. Free for personal use. Paid tiers for teams, private projects, priority AI, managed deployment.
+
+**URL:** studio.almadar.io
+
+## Almadar Services
+
+AI-native infrastructure for the agentic era.
+
+- Compute, storage, authentication, event routing
+- AI model hosting, observability
+- Every service defined in .orb (agents can discover and provision programmatically)
+- Agents reason about: what is true (data), how decisions are made (rules), what happened (events)
+
+**Business model:** Usage-based. Pay for compute time, storage, AI tokens, events processed.
+
+**URL:** services.almadar.io
+
+## Pattern System
+
+114+ UI patterns organized by category: display, form, header, filter, navigation, layout, game, state.
+
+Components follow the atomic design hierarchy:
+- **Atoms**: Button, Input, Typography, Badge, Icon, Avatar, Spinner, etc.
+- **Molecules**: Card, Alert, Modal, Tabs, DataGrid, DataList, etc.
+- **Organisms**: Complex compositions with state logic
+- **Templates**: Full page layouts
+
+All components use VStack/HStack/Box for layout (never raw HTML elements), Typography for text, Button for interactions. Every component supports className, isLoading, error, entity props.
+
+## Design System
+
+@almadar/ui provides 100+ components. Key ones:
+- Layout: VStack, HStack, Box, SimpleGrid
+- Text: Typography (heading, body, label, caption variants)
+- Data: DataGrid, DataList, Card, Badge
+- Forms: Input, TextArea, Select, Checkbox, RadioGroup, DatePicker
+- Feedback: Alert, Toast, Spinner, LoadingState, ErrorState, EmptyState
+- Navigation: Tabs, Breadcrumbs, Sidebar
+- Overlay: Modal, Drawer, Popover
+- Media: Avatar, Icon (1517 Lucide icons)
+- Game: IsometricGameCanvas, GameHud
+
+## Runtime Architecture
+
+Dual execution model:
+- **Client**: render-ui, navigate, notify, emit, set
+- **Server**: persist, fetch, call-service, emit, set
+
+Core modules:
+- StateMachineCore: findTransition(), evaluateGuard()
+- EffectExecutor: dispatch effects to handlers
+- BindingResolver: resolve @entity/@payload/@state bindings
+- EventBus: pub/sub cross-orbital events
+
+Available in TypeScript (@almadar/runtime) and Rust (orbital-rust).
+
+## Verification Pipeline
+
+5-phase verification:
+1. **Static Analysis**: orbital validate with BFS state walk
+2. **Compile + Install**: Full compilation and dependency install
+3. **Server Verification**: 10 test sections via HTTP (health, auth, transitions, effects)
+4. **Browser Verification**: Playwright tests (DOM patterns, interactions, data mutations)
+5. **Screenshot Review**: Multimodal AI analysis of rendered pages
+
+## The Shared Digital Reality (Long-term Vision)
+
+When software is described as a formal world model, different systems can share meaning safely. A hospital and a pharmacy can publish their .orb models. The models describe what data exists, what rules govern it, and what events other systems should know about. A new system can compose these models together, and the compiler guarantees the composition is valid.
+
+This is what we mean by shared digital reality: software that coexists, coordinates, and evolves together across organizational boundaries.
+
+## Website Architecture
+
+\`\`\`
+almadar.io             -> Vision, philosophy, company, blog
+  studio.almadar.io    -> Builder IDE (desktop + web)
+  services.almadar.io  -> Infrastructure platform + dashboard
+  orb.almadar.io       -> Language docs, spec, playground, stdlib
+\`\`\`
+
+## Team
+
+Founded by Al-Madari. Based in Slovenia. AI-native from day one.
+
+## Quick Facts
+
+- 129 standard behaviors across 18 domains
+- 7 production projects deployed
+- $0.05-$0.35 AI compute cost per application
+- 114+ UI patterns
+- 1517 Lucide icons supported
+- Compiler written in Rust
+- 5 compilation targets (TypeScript, Python, Rust, Android, Swift)
+- Open source language (Orb)
+
+## Response Guidelines
+
+When answering:
+1. Be specific. Use numbers, component names, and concrete examples.
+2. If someone asks "what can I build with Almadar?", give real examples from the standard library domains.
+3. If someone asks about technical details, go deep. You have the knowledge.
+4. If someone asks about pricing, direct them to studio.almadar.io or services.almadar.io.
+5. If someone asks how to get started, point them to Orb (orb.almadar.io) for the language and Studio (studio.almadar.io) to build.
+6. Never invent features that aren't described above.
+7. When comparing to competitors, focus on what makes Almadar different: formal verification, trained AI models (not LLM wrappers), world models, multi-platform compilation.
+`.trim();
+  return {
+    name: "almadar-assistant",
+    frontmatter,
+    content
+  };
+}
+
 // src/orbitals-skills-generators/lean/lean-orbital-generator.ts
 var LEAN_CORE_INSTRUCTIONS = `
 ## Core Instructions
@@ -4313,7 +4671,8 @@ function generateAllBuilderSkills() {
       },
       content: generateLeanFixingSkill2()
     },
-    generateDomainLanguageSkill()
+    generateDomainLanguageSkill(),
+    generateAlmadarAssistantSkill()
   ];
 }
 function getMinimalTypeReference() {
@@ -4947,6 +5306,6 @@ function generateComparisonMatrix(comparisons) {
   return markdown;
 }
 
-export { EVAL_CASES, analyzeComposition, calculateTotalScore, formatFrontmatter, generateAllBuilderSkills, generateComparisonMatrix, generateDomainLanguageSkill, generateKflowOrbitalFixingSkill, generateKflowOrbitalsSkill, generateLeanFixingSkill2 as generateLeanFixingSkill, generateLeanFixingSkill as generateLeanFixingSkillFull, generateLeanOrbitalSkill2 as generateLeanOrbitalSkill, generateLeanOrbitalSkill as generateLeanOrbitalSkillFull, getArchitectureSection, getAssetRefSection, getBannedProps, getBindingContextRules, getBindingsCompact, getBindingsGuide, getCommonErrorsSection, getCommonFixPatternsSection, getCompletionRulesSection, getConnectivityCompact, getContextUsageCompact, getContextUsageSection, getCustomTraitCompact, getCustomTraitSection, getDecompositionChecklist, getDecompositionCompact, getDecompositionSection, getDesignErrorsCompact, getDesignErrorsSection, getEfficiencySection, getFieldTypesCompact, getFixingWorkflowSection, getFlowPatternSection, getFullOrbitalPrompt, getGameAsOrbitalsSection, getGameEntityTemplatesSection, getGamePatternsSection, getGameTraitsSection, getGameTypesSection, getIconLibraryCompact, getIconLibrarySection, getKeyBehaviorsReference2 as getKeyBehaviorsReference, getMinimalTypeReference, getMultiFileSection, getOrbitalConnectivitySection, getOrbitalDecompositionPrompt, getOverGenerationSection, getPatternTypesCompact, getPortableOrbitalOutputSection, getRenderUIDesignGuide, getRenderUIQuickRef2 as getRenderUIQuickRef, getRequirementsDecomposePrompt, getRequirementsTraitPrompt, getSExprQuickRef2 as getSExprQuickRef, getSchemaUpdateCompact, getSchemaUpdateSection, getSubagentSystemPrompt, getThemeGuide, getUsesImportCompact, getUsesImportSection, getValidationHintsSection, writeAllSkills, writeSkill };
+export { EVAL_CASES, analyzeComposition, calculateTotalScore, formatFrontmatter, generateAllBuilderSkills, generateAlmadarAssistantSkill, generateComparisonMatrix, generateDomainLanguageSkill, generateKflowOrbitalFixingSkill, generateKflowOrbitalsSkill, generateLeanFixingSkill2 as generateLeanFixingSkill, generateLeanFixingSkill as generateLeanFixingSkillFull, generateLeanOrbitalSkill2 as generateLeanOrbitalSkill, generateLeanOrbitalSkill as generateLeanOrbitalSkillFull, getArchitectureSection, getAssetRefSection, getBannedProps, getBindingContextRules, getBindingsCompact, getBindingsGuide, getCommonErrorsSection, getCommonFixPatternsSection, getCompletionRulesSection, getConnectivityCompact, getContextUsageCompact, getContextUsageSection, getCustomTraitCompact, getCustomTraitSection, getDecompositionChecklist, getDecompositionCompact, getDecompositionSection, getDesignErrorsCompact, getDesignErrorsSection, getEfficiencySection, getFieldTypesCompact, getFixingWorkflowSection, getFlowPatternSection, getFullOrbitalPrompt, getGameAsOrbitalsSection, getGameEntityTemplatesSection, getGamePatternsSection, getGameTraitsSection, getGameTypesSection, getIconLibraryCompact, getIconLibrarySection, getKeyBehaviorsReference2 as getKeyBehaviorsReference, getMinimalTypeReference, getMultiFileSection, getOrbitalConnectivitySection, getOrbitalDecompositionPrompt, getOverGenerationSection, getPatternTypesCompact, getPortableOrbitalOutputSection, getRenderUIDesignGuide, getRenderUIQuickRef2 as getRenderUIQuickRef, getRequirementsDecomposePrompt, getRequirementsTraitPrompt, getSExprQuickRef2 as getSExprQuickRef, getSchemaUpdateCompact, getSchemaUpdateSection, getSubagentSystemPrompt, getThemeGuide, getUsesImportCompact, getUsesImportSection, getValidationHintsSection, writeAllSkills, writeSkill };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map