@xemahq/xema 0.9.0 → 0.10.0

package/examples/01-local-native.yaml

@@ -0,0 +1,20 @@
+# Local dev on the NATIVE substrate — the contributor inner loop.
+# Every service runs as its own forked host process (distributed model);
+# peers discover each other through the KernelState adapter over etcd.
+# You run the backing infra yourself (e.g. `docker compose up`), then boot
+# the roster from your built monorepo checkout.
+#   Run: cp examples/01-local-native.yaml xema.config.yaml && xema up
+#   Or simply: xema dev   (no config file needed)
+edition: oss
+app:
+  substrate: native              # host processes from the monorepo build
+  include: all
+infra:
+  # Native substrate assumes you already run infra (e.g. docker compose up).
+  # etcd is REQUIRED — it backs cross-process service discovery.
+  # If you want the launcher to manage infra too, use the container substrate
+  # (see 02-local-container-full.yaml).
+  postgres: { mode: external, url: postgresql://postgres:postgres@127.0.0.1:5432 }
+  redis:    { mode: external, url: redis://127.0.0.1:6379 }
+  etcd:     { mode: external, url: http://127.0.0.1:2379 }
+  keycloak: { mode: external, url: http://127.0.0.1:8180, realm: xema }

package/examples/README.md

@@ -3,13 +3,13 @@
 Copy one of these to `xema.config.yaml` (or `~/.xema/config.yaml`) and edit:
 
 ```bash
-cp examples/01-local-monolith.yaml xema.config.yaml
+cp examples/01-local-native.yaml xema.config.yaml
 xema up
 ```
 
 | File | Use case |
 | --- | --- |
-| [`01-local-monolith.yaml`](./01-local-monolith.yaml) | Lowest-RAM local run — one process, SQLite, no etcd (native + monolith). |
+| [`01-local-native.yaml`](./01-local-native.yaml) | Local dev on the native substrate — one forked process per service, etcd discovery (BYO infra). |
 | [`02-local-container-full.yaml`](./02-local-container-full.yaml) | Full local stack in containers (everything + frontend). |
 | [`03-byo-infra.yaml`](./03-byo-infra.yaml) | Bring-your-own Postgres / Keycloak / object store; launcher runs only the rest. |
 | [`04-subset-knowledge.yaml`](./04-subset-knowledge.yaml) | Run only a slice (tiers / services) to save resources. |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xemahq/xema",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "license": "Apache-2.0",
   "description": "Xema OS global CLI (plan v4.3 §6 Phase J). Single binary day-0 onboarding: `npm i -g @xemahq/xema && xema dev` boots the whole stack; `xema biome scaffold` / `install` / `publish` / `lint` author and ship biomes; `xema run <capability>` invokes through the local capability-router. Multi-platform: works without pnpm or any monorepo clone.",
   "type": "commonjs",
@@ -23,8 +23,8 @@
     "@nestjs/platform-express": "11.1.13",
     "@xemahq/distribution-resolver": "^0.1.1",
     "@xemahq/kernel-contracts": "^0.22.0",
-    "@xemahq/kernel-state-runtime": "^0.1.5",
-    "@xemahq/service-registry-nest": "^0.1.9",
+    "@xemahq/kernel-state-runtime": "^0.2.0",
+    "@xemahq/service-registry-nest": "^0.2.0",
     "commander": "^12.1.0",
     "reflect-metadata": "0.2.2",
     "rxjs": "7.8.2",

package/xema.config.example.yaml

@@ -27,7 +27,7 @@ infra:
 # ── application services ─────────────────────────────────────────────────────
 app:
   substrate: container           # container | native | helm
-  processModel: distributed      # distributed (microservices) | monolith (native-only: 1 process, SQLite, no etcd)
+  processModel: distributed      # distributed (microservices, etcd discovery) — the only supported model
   include: [ all ]               # all | tier names (kernel/system/base/platform) | service names
   exclude: []                    # service names to drop
   features: []                   # curated capability bundles (union with include)

package/examples/01-local-monolith.yaml

@@ -1,18 +0,0 @@
-# Lowest-RAM local run — the memory-optimized single-process mode.
-# All in-process-capable services share ONE Node process + ONE in-process
-# registry + a SQLite KernelState file; NO etcd. Prisma-bound services that
-# can't run in-process are fail-fast skip-logged (see plan §18).
-#   Run: cp examples/01-local-monolith.yaml xema.config.yaml && xema up
-#   Or simply: xema up --monolith   (no config file needed)
-edition: oss
-app:
-  substrate: native              # monolith is native-only
-  processModel: monolith         # 1 process, SQLite, no etcd
-  include: all
-infra:
-  # Native substrate assumes you already run infra (e.g. docker compose up).
-  # If you want the launcher to manage infra too, use the container substrate
-  # (see 02-local-container-full.yaml).
-  postgres: { mode: external, url: postgresql://postgres:postgres@127.0.0.1:5432 }
-  redis:    { mode: external, url: redis://127.0.0.1:6379 }
-  keycloak: { mode: external, url: http://127.0.0.1:8180, realm: xema }