@owlmeans/planning 0.1.18-rc.15 → 0.1.18-rc.16

package/README.md

@@ -9,7 +9,7 @@ the executor with `@owlmeans/server-planning` and reads remotely with `@owlmeans
 ## Installation
 
 ```sh
-bun add @owlmeans/planning@^0.1.18-rc.15 ajv ajv-formats
+bun add @owlmeans/planning@^0.1.18-rc.16 ajv ajv-formats
 ```
 
 ## Concepts

package/agent-meta/manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
   "package": "@owlmeans/planning",
-  "version": "0.1.18-rc.15",
-  "generatedAt": "2026-10-03T11:19:50.783Z",
+  "version": "0.1.18-rc.16",
+  "generatedAt": "2026-10-03T15:33:53.021Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/planning/SKILL.md

@@ -8,7 +8,7 @@ user-invocable: false
 # @owlmeans/planning
 
 **Layer:** Cross-cutting domain
-**Install:** `"@owlmeans/planning": "^0.1.18-rc.15"` in `dependencies` (`ajv` and `ajv-formats` are peers)
+**Install:** `"@owlmeans/planning": "^0.1.18-rc.16"` in `dependencies` (`ajv` and `ajv-formats` are peers)
 
 The contracts of project planning: record shapes, schemas, refusals, the protocol tree, the pure
 fold and the models. No database, no fastify, no React. The executor, the plugin registry, the
@@ -268,6 +268,22 @@ A client calls `encodeWorkcardQuery(query)` before `call({ query })`; a handler
 - `actor` in an execute body is ignored on the wire: the server fills it from the request.
 - Responses carry no runtime schema (typed only), so a serializer never strips `fields`.
 
+## Mounting in a target
+
+A generated target serves this tree as it is — no hand-written card, transition or schema routes:
+
+- **common**: `makePlanningProtocols({ base: { alias: 'api:planning' }, guards: DEFAULT_GUARD,
+  definitions: true })`, beside the `PLANNING` plugin in `sources/common/src/planning.ts`.
+- **api**: `servePlanningEntrypoints(tree, { access })` minus the `commit.events` socket entry; the
+  resolver answers `{ entityId, projects, writes, grants }` (view ids, modify ids, create/admin
+  grants) — `server-planning` → The access resolver.
+- **web**: `appendPlanningClient({ protocols, bind: false })` + `appendPlanningStores`, long poll
+  only — `client-planning` → Mounting in a target.
+- **Kit literals**: card types and flows are LITERAL objects inside `PLANNING.schemas.flows` /
+  `.types`, above the `// owlmeans: add planning flows|types above this line` sentinels (a spread
+  hides them from the library's registration checks); card types and flows `overridable: true`,
+  `fields` open (`additionalProperties: true`), the container project type `scopedCardTypes: true`.
+
 ## Models
 
 `makeWorkcardModel(record, facade)` (and `makeProjectModel`, `makeSpecificationModel`, `modelOf`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/planning",
-  "version": "0.1.18-rc.15",
+  "version": "0.1.18-rc.16",
   "license": "MIT",
   "description": "Runtime-free project-planning contracts — the workcard super type, projects, specifications, typed relationships, status flows with three intrinsic states, the transition event and its pure fold, the schema registry, the models and the protocol tree.",
   "type": "module",