@adobe/data-ai 0.9.102 → 0.10.1

package/.claude/rules/ecs.md

@@ -140,6 +140,9 @@ Synchronous, deterministic atomic mutations. Receive `store` and a payload.
 - `store.resources.x = value` — mutate resources
 - `store.get(entity, 'component')` — read component value
 - `store.select(archetype.components, { where })` — query entities
+- `store.count(archetype.components, { where })` — count entities; sums archetype row
+  counts with no entity-array allocation (reactive: `db.observe.count(...)` →
+  `Observe<number>`). Prefer over `select(...).length` for membership/count computeds.
 
 ### actions
 

package/.claude/rules/features/services/main-service/computed.md

@@ -46,6 +46,12 @@ Type the parameter on the lowest database layer that exposes what it
 reads. An `index.ts` barrel re-exports every computed; `computed-database.ts`
 registers it under the `computed` facet.
 
+For a computed that only needs *how many* entities match an archetype (an
+empty-state flag, a badge count), read `db.observe.count(archetype.components,
+{ where })` — an `Observe<number>` that sums archetype row counts and re-emits
+only when the count changes, allocating no entity array. Prefer it over
+`db.observe.select(...)` mapped through `.length`.
+
 **Conform a computed to its `data/state` derivation** whenever one exists. The
 derivation co-locates `{ input, value }` cases (`Derivation<typeof fn>`), and the
 feature's single `conformance/conformance.test.ts` `Conformance.runFeature({...})`

package/.claude/rules/global/namespace.md

@@ -70,6 +70,7 @@ literal, it is a function and does not belong in `constants.ts`.
 - **`export namespace <TypeName> { ... }`** — Use `export * as <TypeName> from "./public.js"` instead.
 - **Prefixing function files with the type name** (e.g., `vec2-add.ts`) — Use `add.ts`; the folder provides context.
 - **Importing from `public.js` or `-schema.js`** outside the type folder — Consumers must import only from `<type-name>/<type-name>.ts`.
+- **A generic `functions/` folder for helpers** — a helper lives on the namespace of the type it most closely relates to (or, for a single caller, as a private declaration in that caller); never a typeless `functions/` bucket.
 
 ## Consumers
 

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "adobe-data-ai",
-  "version": "0.9.102",
+  "version": "0.10.1",
   "description": "Architecture skills for @adobe/data — data-oriented modelling, archetype iteration, hot-path performance, and related conventions.",
   "author": {
     "name": "Adobe"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/data-ai",
-  "version": "0.9.102",
+  "version": "0.10.1",
   "description": "Cross-agent architecture skills for @adobe/data — installable as a Claude Code plugin or copied into any Agent-Skills-compatible agent (Cursor, Codex).",
   "type": "module",
   "private": false,
@@ -29,12 +29,12 @@
     "skills"
   ],
   "peerDependencies": {
-    "@adobe/data": "0.9.102"
+    "@adobe/data": "0.10.1"
   },
   "devDependencies": {
     "typescript": "^5.8.3",
     "vitest": "^1.6.0",
-    "@adobe/data": "0.9.102"
+    "@adobe/data": "0.10.1"
   },
   "license": "MIT",
   "scripts": {