@almadar/std 3.1.1 → 3.1.3

package/dist/behaviors/exports/molecules/std-list.orb

@@ -5,7 +5,8 @@
       "name": "ItemOrbital",
       "entity": {
         "name": "Item",
-        "persistence": "runtime",
+        "persistence": "persistent",
+        "collection": "items",
         "fields": [
           {
             "name": "id",
@@ -950,5 +951,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "CRUD list molecule. Composes atoms via shared event bus: - stdBrowse: data-grid with item actions (fires CREATE, VIEW, EDIT, DELETE) - stdModal (x3): create form, edit form, detail view (responds to matching events) - stdConfirmation: delete confirmation (responds to DELETE) No emits/listens wiring. Traits on the same page share the event bus. Only the trait with a matching transition from its current state responds."
 }

package/dist/behaviors/exports/molecules/std-messaging.orb

@@ -581,5 +581,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Messaging molecule. Composes atoms via shared event bus: - stdBrowse: message list with \"Compose\" header action, \"View\" item action - stdModal (compose): compose/send message form (COMPOSE -> SEND) - stdModal (view): view message detail (VIEW with id payload) No emits/listens wiring. Traits on the same page share the event bus. Only the trait with a matching transition from its current state responds."
 }

package/dist/behaviors/exports/molecules/std-negotiator-game.orb

@@ -179,5 +179,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Educational game molecule: menu -> playing -> complete. Uses the `negotiator-board` pattern for the playing state."
 }

package/dist/behaviors/exports/molecules/std-platformer-game.orb

@@ -492,5 +492,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Side-scrolling platformer game molecule. Composes game atoms into a two-trait orbital: 1. PlatformerFlow trait (primary): menu -> playing -> paused -> gameover    Renders game-menu, platformer-canvas, game-over-screen per state. 2. PlatformerCanvas trait (secondary): extracted from stdPlatformerCanvas,    INIT render-ui removed (standalone: false pattern) so the flow trait    owns the main render slot."
 }

package/dist/behaviors/exports/molecules/std-puzzle-game.orb

@@ -523,5 +523,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Puzzle game molecule. Composes game atoms into a two-trait orbital: 1. PuzzleFlow trait (primary): menu -> playing -> paused -> gameover    Renders game-menu, game-canvas-2d with score-board, game-over-screen. 2. PuzzleScore trait (secondary): extracted from stdScoreBoard,    INIT render-ui removed (standalone: false pattern) so the flow trait    owns the main render slot."
 }

package/dist/behaviors/exports/molecules/std-sequencer-game.orb

@@ -179,5 +179,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Educational game molecule: menu -> playing -> complete. Uses the `sequencer-board` pattern for the playing state."
 }

package/dist/behaviors/exports/molecules/std-simulator-game.orb

@@ -179,5 +179,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Educational game molecule: menu -> playing -> complete. Uses the `simulator-board` pattern for the playing state."
 }

package/dist/behaviors/exports/molecules/std-turn-based-battle.orb

@@ -439,5 +439,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Turn-based strategy game molecule (Fire Emblem, XCOM style). Composes game atoms into a two-trait orbital: 1. BattleFlow trait (primary): menu -> playing -> paused -> gameover    Renders game-menu, game-hud + combat-log, game-over-screen per state. 2. BattleLog trait (secondary): idle state, combat-log pattern.    Only renders when LOG_EVENT fires from the shared event bus. Composition pattern: extractTrait from atom orbitals, assemble into one orbital with one shared entity and one page."
 }

package/dist/behaviors/exports/organisms/std-api-gateway.orb

@@ -2292,5 +2292,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "API gateway management organism. Composes: stdList(Route) + stdCircuitBreaker(Backend) + stdDisplay(Analytics) Pages: /routes (initial), /backends, /analytics"
 }

package/dist/behaviors/exports/organisms/std-arcade-game.orb

@@ -829,5 +829,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Arcade game organism. Composes: stdGameflow(ArcadeState) + stdGameCanvas2d(ArcadeCanvas)         + stdScoreBoard(ArcadeScore) + stdGameHud(ArcadeHud) Pages: /game (initial), /scores"
 }

package/dist/behaviors/exports/organisms/std-booking-system.orb

@@ -3973,5 +3973,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Booking system organism. Composes molecules via compose: - stdList(Provider): provider directory with CRUD - stdWizard(Booking): booking wizard - stdList(Appointment): appointment list with CRUD - stdDisplay(Schedule): schedule overview dashboard Cross-orbital connections: - BOOK: ProviderBrowse -> BookingWizard - CONFIRM: BookingWizard -> AppointmentBrowse"
 }

package/dist/behaviors/exports/organisms/std-cicd-pipeline.orb

@@ -2210,5 +2210,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "CI/CD pipeline organism. Composes: stdList(Build) + stdDisplay(Stage) + stdAsync(Deployment) Pages: /builds (initial), /stages, /deploy"
 }

package/dist/behaviors/exports/organisms/std-cms.orb

@@ -2640,5 +2640,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Content management organism. Composes molecules via compose: - stdList(Article): article management with CRUD - stdDetail(MediaAsset): media library browse + view - stdList(Category): category management Cross-orbital connections: - PUBLISH: ArticleBrowse -> MediaAssetBrowse - CATEGORIZE: ArticleBrowse -> CategoryBrowse"
 }

package/dist/behaviors/exports/organisms/std-coding-academy.orb

@@ -1390,5 +1390,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Coding academy organism. Composes: stdSequencerGame(SeqChallenge) + stdBuilderGame(BuildChallenge)         + stdEventHandlerGame(EventChallenge) + stdDisplay(StudentProgress) Pages: /sequencer (initial), /builder, /events, /progress"
 }

package/dist/behaviors/exports/organisms/std-crm.orb

@@ -3537,5 +3537,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Customer relationship management organism. Composes molecules via compose: - stdList(Contact): CRUD list of contacts - stdList(Deal): CRUD list of deals - stdDisplay(Pipeline): read-only pipeline dashboard - stdMessaging(Note): notes/communication thread Pages: /contacts (initial), /deals, /pipeline, /notes Connections: CONVERT_LEAD (contacts->deals), CLOSE_DEAL (deals->pipeline)"
 }

package/dist/behaviors/exports/organisms/std-devops-dashboard.orb

@@ -3130,5 +3130,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "DevOps monitoring organism. Composes: stdCircuitBreaker(ServiceNode) + stdDisplay(AlertMetric)         + stdList(LogEntry) + stdDisplay(SystemMetric) Pages: /services (initial), /alerts, /logs, /metrics"
 }

package/dist/behaviors/exports/organisms/std-ecommerce.orb

@@ -3739,5 +3739,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "E-commerce organism. Composes molecules via compose: - stdList(Product): product catalog with CRUD - stdCart(CartItem): shopping cart with add/remove - stdWizard(Checkout): checkout wizard - stdList(OrderRecord): order history Cross-orbital connections: - ADD_TO_CART: ProductBrowse -> CartItemCartBrowse - CHECKOUT_STARTED: CartItemCartBrowse -> CheckoutWizard - ORDER_PLACED: CheckoutWizard -> OrderRecordBrowse"
 }

package/dist/behaviors/exports/organisms/std-finance-tracker.orb

@@ -2381,5 +2381,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Finance tracker organism. Composes: stdList(Transaction) + stdDisplay(FinanceSummary) + stdDetail(FinanceReport) Pages: /transactions (initial), /summary, /reports"
 }

package/dist/behaviors/exports/organisms/std-healthcare.orb

@@ -4675,5 +4675,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Healthcare organism. Composes molecules via compose: - stdList(Patient): patient registry with CRUD - stdList(Appointment): appointment management - stdWizard(IntakeForm): patient intake wizard - stdDetail(Prescription): prescription browse + view - stdDisplay(Dashboard): clinic dashboard KPIs Cross-orbital connections: - INTAKE_COMPLETE: IntakeFormWizard -> PatientBrowse - PRESCRIBE: AppointmentBrowse -> PrescriptionBrowse"
 }

package/dist/behaviors/exports/organisms/std-helpdesk.orb

@@ -2560,5 +2560,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Helpdesk organism. Composes molecules via compose: - stdList(Ticket): CRUD list of support tickets - stdMessaging(Response): messaging thread for ticket responses - stdDisplay(SupportMetrics): read-only metrics dashboard Pages: /tickets (initial), /responses, /metrics Connections: ASSIGN (tickets->responses), RESOLVE (responses->metrics)"
 }

package/dist/behaviors/exports/organisms/std-hr-portal.orb

@@ -4025,5 +4025,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "HR portal organism. Composes molecules via compose: - stdList(Employee): CRUD list of employees - stdWizard(Onboarding): multi-step onboarding wizard - stdList(TimeOff): CRUD list of time-off requests - stdDisplay(OrgChart): read-only org chart dashboard Pages: /employees (initial), /onboarding, /timeoff, /org-chart Connections: ONBOARD (employees->onboarding), APPROVE_LEAVE (timeoff->orgchart)"
 }

package/dist/behaviors/exports/organisms/std-iot-dashboard.orb

@@ -2293,5 +2293,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "IoT dashboard organism. Composes: stdDisplay(SensorReading) + stdList(Device) + stdCircuitBreaker(DeviceAlert) Pages: /sensors (initial), /devices, /alerts"
 }

package/dist/behaviors/exports/organisms/std-lms.orb

@@ -2850,5 +2850,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Learning management system organism. Composes molecules via compose: - stdList(Course): CRUD list of courses - stdWizard(Enrollment): multi-step enrollment wizard - stdDisplay(Progress): read-only progress dashboard Pages: /courses (initial), /enroll, /progress Connections: ENROLL (courses->enrollment), COMPLETE_LESSON (enrollment->progress)"
 }

package/dist/behaviors/exports/organisms/std-logic-training.orb

@@ -594,5 +594,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Logic training organism. Composes: stdDebuggerGame(DebugChallenge) + stdNegotiatorGame(NegotiateChallenge)         + stdScoreBoard(TrainingScore) Pages: /debugger (initial), /negotiator, /scores"
 }

package/dist/behaviors/exports/organisms/std-platformer-app.orb

@@ -1565,5 +1565,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Platformer game organism. Composes: stdPlatformerGame(PlatLevel) + stdScoreBoard(PlatScore) + stdInventory(Collectible) Pages: /game (initial), /scores, /collectibles"
 }

package/dist/behaviors/exports/organisms/std-project-manager.orb

@@ -3017,5 +3017,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Project management organism. Composes molecules via compose: - stdList(Task): task management with CRUD - stdList(Sprint): sprint management with CRUD - stdDisplay(Burndown): burndown chart dashboard Cross-orbital connections: - ASSIGN_TASK: SprintBrowse -> TaskBrowse - COMPLETE_SPRINT: SprintBrowse -> BurndownDisplay"
 }

package/dist/behaviors/exports/organisms/std-puzzle-app.orb

@@ -739,5 +739,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Puzzle game organism. Composes: stdPuzzleGame(PuzzleLevel) + stdScoreBoard(PuzzleScore) Pages: /puzzle (initial), /scores"
 }

package/dist/behaviors/exports/organisms/std-realtime-chat.orb

@@ -2376,5 +2376,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Realtime chat organism. Composes: stdMessaging(ChatMessage) + stdList(Channel) + stdDisplay(OnlineUser) Pages: /chat (initial), /channels, /online"
 }

package/dist/behaviors/exports/organisms/std-rpg-game.orb

@@ -2800,5 +2800,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "RPG game organism. Composes: stdTurnBasedBattle(BattleState) + stdOverworld(WorldZone)         + stdInventory(RpgItem) + stdQuest(Mission) Pages: /battle, /world (initial), /inventory, /quests Connections: ENCOUNTER_STARTED (world->battle), LOOT_DROPPED (battle->inventory),              QUEST_ACCEPTED (world->quests)"
 }

package/dist/behaviors/exports/organisms/std-social-feed.orb

@@ -1217,5 +1217,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Social feed organism. Composes molecules via compose: - stdDetail(Post): browse + create + view posts - stdMessaging(Comment): messaging thread for comments Pages: /feed (initial), /messages Connections: COMMENT event wires posts to comments."
 }

package/dist/behaviors/exports/organisms/std-stem-lab.orb

@@ -1206,5 +1206,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "STEM lab organism. Composes: stdSimulatorGame(Experiment) + stdClassifierGame(Classification)         + stdDisplay(LabResult) Pages: /simulator (initial), /classifier, /results"
 }

package/dist/behaviors/exports/organisms/std-strategy-game.orb

@@ -1757,5 +1757,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Strategy game organism. Composes: stdTurnBasedBattle(ArmyBattle) + stdOverworld(Territory) + stdDisplay(Resource) Pages: /battle, /map (initial), /resources"
 }

package/dist/behaviors/exports/organisms/std-trading-dashboard.orb

@@ -2213,5 +2213,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Trading dashboard organism. Composes: stdDisplay(Portfolio) + stdList(TradeOrder) + stdAsync(MarketFeed) Pages: /portfolio (initial), /orders, /market"
 }

package/dist/behaviors/exports/validation-report.json

@@ -0,0 +1,18 @@
+[
+  {
+    "name": "std-list",
+    "errors": 0,
+    "warnings": 1,
+    "output": [
+      "Loaded 22 services from packages/almadar-patterns/src/services-registry.json",
+      "Validating schema: /home/osamah/kflow.ai.builder/packages/almadar-std/behaviors/exports/molecules/std-list.orb",
+      "Schema validation warnings:",
+      "  ⚠️  [CIRCUIT_MODAL_EXIT_INCOMPLETE] orbitals[0].traits[0].transitions[Single(\"deleting\")->CONFIRM_DELETE->browsing]: Transition Single(\"deleting\")--[CONFIRM_DELETE]-->browsing closes modal but doesn't re-render main slot. Main view will show stale content.",
+      "     💡 Add render-ui(\"main\", {...}) alongside render-ui(\"modal\", null) to refresh the main view after closing the modal",
+      "  ⚠️  [CIRCUIT_MODAL_EXIT_INCOMPLETE] orbitals[0].traits[0].transitions[Single(\"deleting\")->CANCEL->browsing]: Transition Single(\"deleting\")--[CANCEL]-->browsing closes modal but doesn't re-render main slot. Main view will show stale content.",
+      "     💡 Add render-ui(\"main\", {...}) alongside render-ui(\"modal\", null) to refresh the main view after closing the modal",
+      "  ⚠️  [CIRCUIT_MODAL_EXIT_INCOMPLETE] orbitals[0].traits[0].transitions[Single(\"deleting\")->CLOSE->browsing]: Transition Single(\"deleting\")--[CLOSE]-->browsing closes modal but doesn't re-render main slot. Main view will show stale content.",
+      "     💡 Add render-ui(\"main\", {...}) alongside render-ui(\"modal\", null) to refresh the main view after closing the modal"
+    ]
+  }
+]

package/dist/behaviors/functions/index.d.ts

@@ -40,8 +40,26 @@ interface StdBrowseParams {
     pagePath?: string;
     isInitial?: boolean;
 }
+/**
+ * Build the browse entity.
+ *
+ * @param {StdBrowseParams} params - Browse configuration parameters
+ * @returns {Entity} The configured browse entity
+ */
 declare function stdBrowseEntity(params: StdBrowseParams): Entity;
+/**
+ * Build the browse trait.
+ *
+ * @param {StdBrowseParams} params - Browse configuration parameters
+ * @returns {Trait} The configured browse trait
+ */
 declare function stdBrowseTrait(params: StdBrowseParams): Trait;
+/**
+ * Build the browse page.
+ *
+ * @param {StdBrowseParams} params - Browse configuration parameters
+ * @returns {Page} The configured browse page
+ */
 declare function stdBrowsePage(params: StdBrowseParams): Page;
 declare function stdBrowse(params: StdBrowseParams): OrbitalDefinition;
 
@@ -496,8 +514,26 @@ interface StdUndoParams {
     pagePath?: string;
     isInitial?: boolean;
 }
+/**
+ * Build the undo entity.
+ *
+ * @param {StdUndoParams} params - Undo configuration parameters
+ * @returns {Entity} The configured undo entity
+ */
 declare function stdUndoEntity(params: StdUndoParams): Entity;
+/**
+ * Build the undo trait.
+ *
+ * @param {StdUndoParams} params - Undo configuration parameters
+ * @returns {Trait} The configured undo trait
+ */
 declare function stdUndoTrait(params: StdUndoParams): Trait;
+/**
+ * Build the undo page.
+ *
+ * @param {StdUndoParams} params - Undo configuration parameters
+ * @returns {Page} The configured undo page
+ */
 declare function stdUndoPage(params: StdUndoParams): Page;
 declare function stdUndo(params: StdUndoParams): OrbitalDefinition;
 
@@ -616,6 +652,12 @@ interface StdDisplayParams {
     isInitial?: boolean;
 }
 declare function stdDisplayEntity(params: StdDisplayParams): Entity;
+/**
+ * Build the display trait.
+ *
+ * @param {StdDisplayParams} params - Display configuration parameters
+ * @returns {Trait} The configured display trait
+ */
 declare function stdDisplayTrait(params: StdDisplayParams): Trait;
 declare function stdDisplayPage(params: StdDisplayParams): Page;
 declare function stdDisplay(params: StdDisplayParams): OrbitalDefinition;
@@ -1061,8 +1103,26 @@ interface StdScoreBoardParams {
     pagePath?: string;
     isInitial?: boolean;
 }
+/**
+ * Build the score board entity.
+ *
+ * @param {StdScoreBoardParams} params - Score board configuration parameters
+ * @returns {Entity} The configured score board entity
+ */
 declare function stdScoreBoardEntity(params: StdScoreBoardParams): Entity;
+/**
+ * Build the score board trait.
+ *
+ * @param {StdScoreBoardParams} params - Score board configuration parameters
+ * @returns {Trait} The configured score board trait
+ */
 declare function stdScoreBoardTrait(params: StdScoreBoardParams): Trait;
+/**
+ * Build the score board page.
+ *
+ * @param {StdScoreBoardParams} params - Score board configuration parameters
+ * @returns {Page} The configured score board page
+ */
 declare function stdScoreBoardPage(params: StdScoreBoardParams): Page;
 declare function stdScoreBoard(params: StdScoreBoardParams): OrbitalDefinition;
 

package/dist/behaviors/functions/index.js

@@ -6853,7 +6853,7 @@ function resolve44(params) {
     listFields: params.listFields ?? nonIdFields.slice(0, 3).map((f) => f.name),
     detailFields: params.detailFields ?? nonIdFields.map((f) => f.name),
     formFields: params.formFields ?? nonIdFields.map((f) => f.name),
-    persistence: params.persistence ?? "runtime",
+    persistence: params.persistence ?? "persistent",
     collection: params.collection,
     pageTitle: params.pageTitle ?? p,
     createButtonLabel: params.createButtonLabel ?? `Create ${entityName}`,
@@ -7067,7 +7067,7 @@ function resolve45(params) {
     nonIdFields,
     listFields: params.listFields ?? nonIdFields.slice(0, 3).map((f) => f.name),
     formFields: params.formFields ?? nonIdFields.map((f) => f.name),
-    persistence: params.persistence ?? "runtime",
+    persistence: params.persistence ?? "persistent",
     collection: params.collection,
     pageTitle: params.pageTitle ?? "Shopping Cart",
     addButtonLabel: params.addButtonLabel ?? "Add Item",
@@ -7262,7 +7262,7 @@ function resolve46(params) {
     listFields: params.listFields ?? nonIdFields.slice(0, 3).map((f) => f.name),
     detailFields: params.detailFields ?? nonIdFields.map((f) => f.name),
     formFields: params.formFields ?? nonIdFields.map((f) => f.name),
-    persistence: params.persistence ?? "runtime",
+    persistence: params.persistence ?? "persistent",
     collection: params.collection,
     pageTitle: params.pageTitle ?? p,
     createButtonLabel: params.createButtonLabel ?? `Create ${entityName}`,
@@ -7401,7 +7401,7 @@ function resolve47(params) {
     nonIdFields,
     listFields: params.listFields ?? nonIdFields.slice(0, 3).map((f) => f.name),
     formFields: params.formFields ?? nonIdFields.map((f) => f.name),
-    persistence: params.persistence ?? "runtime",
+    persistence: params.persistence ?? "persistent",
     collection: params.collection,
     pageTitle: params.pageTitle ?? `${p} Inventory`,
     addLabel: params.addLabel ?? `Add ${entityName}`,
@@ -7570,7 +7570,7 @@ function resolve48(params) {
     listFields: params.listFields ?? nonIdFields.slice(0, 3).map((f) => f.name),
     formFields: params.formFields ?? nonIdFields.map((f) => f.name),
     detailFields: params.detailFields ?? nonIdFields.map((f) => f.name),
-    persistence: params.persistence ?? "runtime",
+    persistence: params.persistence ?? "persistent",
     collection: params.collection,
     pageTitle: params.pageTitle ?? p,
     composerTitle: params.composerTitle ?? `New ${entityName}`,
@@ -7719,7 +7719,7 @@ function resolve49(params) {
     nonIdFields,
     listFields: params.listFields ?? nonIdFields.slice(0, 3).map((f) => f.name),
     detailFields: params.detailFields ?? nonIdFields.map((f) => f.name),
-    persistence: params.persistence ?? "runtime",
+    persistence: params.persistence ?? "persistent",
     collection: params.collection,
     pageTitle: params.pageTitle ?? `${p} Picker`,
     selectLabel: params.selectLabel ?? `Select ${entityName}`,