@owlmeans/planning 0.1.18-rc.8 → 0.1.18

package/agent-meta/skills/planning/parts/types.md

@@ -0,0 +1,141 @@
+---
+name: types
+description: Declaring card, project and specification types and status flows as closed data, the application's own definition properties and base card fields (`app`), the data-defined layers (code, entity, project) and retirement, and the rules every record schema keeps.
+metadata:
+  purposes: data
+  mentions: WorkcardTypeSchema, ProjectTypeSchema, StatusFlowSchema, SpecificationSlot, CodePolicy, makeSchemaRegistry, scopedSchemaHelper, resolveScopedBundle, ScopedSchemaRecord, ScopedSchemaBundle, SchemaStore, putType, putFlow, putAssigneeType, scopedCardTypes, overridable, appSchemaHelper, PlanningAppDeclarations, PlanningAppSchema, registerApp, fieldsSchema
+---
+<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
+
+# @owlmeans/planning — Types, flows and schemas
+
+## Declaring a type
+
+A `WorkcardTypeSchema` / `ProjectTypeSchema` is plain data registered through a plugin's `schemas`
+or `makeSchemaRegistry({ types, flows })`. **Every declaration schema is closed** — these are ALL
+the keys:
+
+| Declaration | Required | Optional |
+|---|---|---|
+| card / specification type | `type` (its key), `kind`, `version`, `fields`, `flows` (at least one), `specifications` | `intrinsic`, `relationships`, `labels`, `code`, `label`, `tone`, `icon`, `overridable`, `app` |
+| project type | the same, plus `cardTypes` | `projectTypes`, `scopedCardTypes` |
+| flow | `id` (its key), `version`, `statuses` (at least one), `transitions` | `label`, `tone`, `icon`, `overridable`, `app` |
+| status | `key`, `intrinsic` | `initial`, `terminal`, `label`, `tone` |
+| transition rule | `name`, `from` (status keys or `'*'`), `to` | `label`, `explicit` |
+
+The display name is `label` everywhere; a type or a flow has no `name`, `key` or `description`
+(`key` belongs to a status, `name` to a rule). Anything else the application keeps about a type or
+a flow — a `description`, an origin's attribute — goes in its `app` bag, which the application
+declares (below). As data, `definitions` refuses an extra key with `SchemaInvalid`; in code the
+registry does not validate a declaration, so only TypeScript's excess-property check catches it —
+keep the literal typed.
+
+- `fields` — the AJV schema of `fields`; the registry compiles and caches it (`validator(type)`).
+- `specifications` — the slots this type's cards carry as children. A slot may name its
+  specification `type`; otherwise `specificationHelper.specificationTypeOf` takes the only registered specification
+  type, then the one sharing the parent type's prefix (`viable:project` → `viable:spec`).
+- `code` — `CodePolicy { prefix?, style: random|sequential|slug, length?, uppercase?, uniqueWithin:
+  parent|entity, mutable? }`. A code is fixed once minted unless `mutable`.
+- `relationships` — the edge types a card may start (`single` = at most one per card).
+- `labels` — the allowed labels (any when omitted).
+- A project type lists `cardTypes` (and `projectTypes` for nesting) its children may have;
+  `scopedCardTypes: true` also admits card types defined as data (below).
+- `overridable: true` on a code type or flow opens it to a data-defined override.
+- `tone` / `icon` (type, flow) and `tone` (status) — PRESENTATION hints the package stores as free
+  text of at most 64 characters, neither validating nor rendering them. Their standard values and
+  their standard editor and renderer are `@owlmeans/web-panel/picker`: `tone` a palette key
+  (`PICKER_COLOR_KEYS` — red … graphite, 24) or a lowercase `#rrggbb` when the editor allows custom
+  colours, `icon` a kebab-case lucide name of its catalogue (`PICKER_ICON_NAMES`). A person edits a
+  type's or a flow's mark with `IconColorPicker` and shows it with `IconTile` / `ColorDot`; a
+  status's `tone` usually names a meaning the application's own palette maps (`ColorPicker` with
+  `colors`). An unknown value renders the picker's fallback (`slate`, `circle`); server code and
+  seeds read the data React-free from `@owlmeans/web-panel/picker/vocabulary`.
+
+## Application-declared properties (`app`)
+
+Two kinds of field exist: the custom ones a data-defined type gives its cards (its `fields`,
+written by the app's people), and the ones the APPLICATION pregenerates in code for every type,
+flow or card. The latter are `PlanningAppDeclarations { type?, flow?, card? }`, declared in
+`PlanningPlugin.schemas.app` (and `PlanningServiceOptions.schemas.app`) and served in the bundle
+(`bundle.app`, `registry.app()`):
+
+```ts
+schemas: { app: {
+  type: { properties: { description: { type: 'string', maxLength: 2000 } } },
+  flow: { properties: { description: { type: 'string' } } },
+  card: { properties: { priority: { type: 'string', enum: ['low', 'high'] } } },
+} }
+// then a type: { type: 'wm:task', …, app: { description: 'Work items' } }
+```
+
+- **Closed form** (`appSchemaHelper.assertDeclarations` → `SchemaInvalid('app:<kind>:…')`): each
+  kind is `{ type?: 'object', properties, required? }` and nothing else; property names hold no
+  `.` or `$`; every `required` name is declared in the same declaration; outside a browser document
+  the schema compiles. A page never compiles (a strict `script-src` refuses Ajv's code generation):
+  building, loading or merging a registry there runs the closed-form checks only, and what it
+  registers is the bundle its server compiled when the plugins were registered.
+- **Merge** (`appSchemaHelper.merge`, run by the server's plugin registry on every `use` and by
+  the client over the served bundle): the service's own `schemas.app` first, then each plugin's in
+  plugin order (`order` ascending, registration order among equals). Per kind `properties` are
+  united — a later declaration of a name replaces the earlier one whole — and `required` is united.
+  A plugin replaced by name takes its declarations with it. The result is normalized
+  (`type: 'object'`); nothing declared → `undefined` and no `app` key in any bundle.
+- **`type` / `flow` → the definition's `app` bag**, closed over the declared properties
+  (`additionalProperties: false`; an absent bag reads `{}`, so a `required` property makes the bag
+  mandatory). Checked on every data-defined write — `define`, `put*`, `seed`, the wire
+  `schema.define` — by `assertTypeSchema(type, flows, app)` / `assertFlowSchema(flow, app)`. A kind
+  the application does not declare refuses any bag (`<kind>:<key>:app:undeclared`). Code
+  declarations are not validated (as every code declaration); a record written under earlier
+  declarations still resolves.
+- **`card` → base `fields` of every type of kind `card`**, code or data-defined
+  (`registry.fieldsSchema(type)`, compiled by `registry.validator(type)`). The type's schema stays
+  the root (its `#/…` references still resolve); each base name absent from its top-level
+  `properties` is added as `{}` — so its `additionalProperties: false` never refuses a base field —
+  and the base object schema is appended to its `allOf`. A type that declares a base name itself
+  narrows it (both apply). Projects and specifications are untouched. A required base field, like a
+  newly required type field, refuses every later write of a card that lacks it.
+- Without declarations every behavior is the previous one: `fieldsSchema(type)` IS `type.fields`.
+
+## Data-defined types and flows
+
+Card types, assignee types and status flows may also be DATA — `ScopedSchemaRecord`s a store keeps
+behind the optional `PlanningStore.schemas` port. Card types and flows layer **code → entity → project**;
+assignee types layer **code → entity** and refuse a project-local declaration:
+
+- `code` is the plugin registry (the default), `entity` an organization-wide record
+  (`project` absent), `project` a record of one project card. A project record overrides an
+  organization one of the same key.
+- **Card types, assignee types and flows are data.** A code key is sealed unless its declaration says
+  `overridable: true`; project and specification types are always code's (`scopedSchemaHelper.assertOverridable` →
+  `SchemaSealed`).
+- A record's `version` is its compare-and-set token and is written into the declaration's own
+  `version`: a write lands only at its layer's next version, 1 for a new key (`SchemaConflict`).
+- The closed-form checks are shared by every store: `scopedSchemaHelper.assertFlowSchema` (the declaration's schema,
+  unique status keys, every `to` declared, `from` `'*'` or declared statuses, the `app` bag) and
+  `scopedSchemaHelper.assertTypeSchema` (the `card` kind, the `app` bag, a `fields` schema that
+  compiles with the base card fields, unique flows that resolve) — `SchemaInvalid`.
+- **Retired** means offered for nothing new, still resolved for what uses it: a retired record
+  gives way to a live declaration below it, and a key retired in every layer resolves retired —
+  present in the bundle's `types`/`flows`, listed in `retired`. A flow cannot be retired while a
+  live type of an affected layer still runs it (`scopedSchemaHelper.flowInUse` → `SchemaInUse`).
+- `scopedSchemaHelper.resolveScopedBundle(code, records, scope)` is the ONE resolution (pure);
+  `scopedRegistryOf` is its read-only registry (`originOf`, `isRetired`; `register*`/`load` refuse). A
+  `ScopedSchemaBundle` extends the plain bundle with `scope`, `revision`, `origins`, `retired`, so a
+  reader of the plain bundle is unaffected; the code bundle's `app` passes through.
+- `SchemaStore`: `list(where)`, `put(record)` (the CAS), `purge({ entityId, project })`,
+  `revision(entityId)` (monotonic per organization), optional `watch(listener)`.
+- `PlanningFacade.definitions` (present only where the store has the port): `bundle(project?)`,
+  `registry(project?)`, `records`, `putType`/`putFlow`/`putAssigneeType` (CAS on the declaration's version),
+  `define` (each at its layer's next version, flows first), `seed` (only the keys the layer lacks),
+  `retire(kind, key, { project? })`. The declaration still carries its own `version` (any number
+  ≥ 1 for `define`/`seed`, which assign the layer's next one; the exact next one for `put*`), and
+  a project layer is `{ project: <project card id> }` in the second argument (a `define` call:
+  `server-planning` → Creating and reading a card).
+
+## Schema rules
+
+A record schema may become a Mongo `$jsonSchema`, so every exported schema keeps two rules: **no
+`integer`** (`number` only) and **every optional property `nullable: true`** (an enum then admits
+`null` too). No `oneOf`/`anyOf` inside a record schema. Build type arrays per schema, never share
+one object between schemas — ajv may extend a `type` array while compiling. The walk that pins this
+is part of the package's own tests.

package/build/aliases/types.d.ts

@@ -0,0 +1,72 @@
+/** The aliases one planning tree answers under — every one derived from the mount's base alias. */
+export interface PlanningAliases {
+    readonly base: string;
+    readonly schema: {
+        readonly list: string;
+    };
+    readonly card: {
+        readonly list: string;
+        readonly summary: string;
+        readonly get: string;
+        readonly transitions: string;
+        readonly specifications: string;
+    };
+    readonly spec: {
+        readonly get: string;
+        readonly revisions: string;
+    };
+    readonly link: {
+        readonly list: string;
+    };
+    readonly transition: {
+        readonly get: string;
+    };
+    readonly execute: string;
+    readonly commit: {
+        readonly get: string;
+        readonly events: string;
+    };
+}
+/** The aliases of the leaves a tree gains with `definitions: true`. */
+export interface PlanningDefinitionAliases {
+    readonly define: string;
+}
+export interface PlanningAliasHelper {
+    planningResourceAliases: (base: string) => PlanningResourceAliases;
+    /**
+     * The aliases one planning tree answers under, derived from the mount's base alias.
+     *
+     * Two mounts of the tree in one deployment are two base aliases, never two copies of this table —
+     * which is why nothing here is a global constant.
+     */
+    planningAliases: (base: string) => PlanningAliases;
+    /**
+     * The aliases of the leaves a tree gains with `definitions: true` — kept apart from
+     * {@link PlanningAliasHelper.planningAliases} so a tree declared without them names no alias it
+     * does not declare.
+     */
+    planningDefinitionAliases: (base: string) => PlanningDefinitionAliases;
+}
+export interface PlanningResourceAliases {
+    assignees: {
+        get: string;
+        list: string;
+        write: string;
+    };
+    teams: {
+        get: string;
+        list: string;
+        write: string;
+    };
+    comments: {
+        get: string;
+        list: string;
+        write: string;
+    };
+    mentions: {
+        get: string;
+        list: string;
+        write: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/build/aliases/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/aliases/types.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IAC1C,QAAQ,CAAC,IAAI,EAAE;QACb,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;QACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;QACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;QAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;KAChC,CAAA;IACD,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IACnE,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACxC,QAAQ,CAAC,UAAU,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CACnE;AAED,uEAAuE;AACvE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,uBAAuB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,uBAAuB,CAAA;IAClE;;;;;OAKG;IACH,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,eAAe,CAAA;IAClD;;;;OAIG;IACH,yBAAyB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,yBAAyB,CAAA;CACvE;AAED,MAAM,WAAW,uBAAuB;IAAG,SAAS,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,QAAQ,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,QAAQ,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE"}

package/build/aliases/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/aliases/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/aliases/types.ts"],"names":[],"mappings":""}

package/build/aliases.d.ts

@@ -0,0 +1,4 @@
+import type { PlanningAliasHelper } from './aliases/types.js';
+export declare const createPlanningAliasHelper: () => PlanningAliasHelper;
+export declare const planningAliasHelper: PlanningAliasHelper;
+//# sourceMappingURL=aliases.d.ts.map

package/build/aliases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aliases.d.ts","sourceRoot":"","sources":["../src/aliases.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,mBAAmB,EAAsD,MAAM,oBAAoB,CAAA;AAElI,eAAO,MAAM,yBAAyB,QAAO,mBA6B5C,CAAA;AAED,eAAO,MAAM,mBAAmB,qBAA8B,CAAA"}

package/build/aliases.js

@@ -0,0 +1,28 @@
+export const createPlanningAliasHelper = () => {
+    const planningAliases = (base) => Object.freeze({
+        base,
+        schema: Object.freeze({ list: `${base}:schema:list` }),
+        card: Object.freeze({
+            list: `${base}:card:list`,
+            summary: `${base}:card:summary`,
+            get: `${base}:card:get`,
+            transitions: `${base}:card:transitions`,
+            specifications: `${base}:card:specifications`,
+        }),
+        spec: Object.freeze({
+            get: `${base}:specification:get`,
+            revisions: `${base}:specification:revisions`,
+        }),
+        link: Object.freeze({ list: `${base}:link:list` }),
+        transition: Object.freeze({ get: `${base}:transition:get` }),
+        execute: `${base}:execute`,
+        commit: Object.freeze({ get: `${base}:commit:get`, events: `${base}:commit:events` }),
+    });
+    const planningDefinitionAliases = (base) => Object.freeze({
+        define: `${base}:schema:define`,
+    });
+    const planningResourceAliases = (base) => Object.freeze(Object.fromEntries(['assignees', 'teams', 'comments', 'mentions'].map(name => [name, Object.freeze({ get: `${base}:${name}:get`, list: `${base}:${name}:list`, write: `${base}:${name}:write` })])));
+    return { planningAliases, planningDefinitionAliases, planningResourceAliases };
+};
+export const planningAliasHelper = createPlanningAliasHelper();
+//# sourceMappingURL=aliases.js.map

package/build/aliases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aliases.js","sourceRoot":"","sources":["../src/aliases.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAwB,EAAE;IACjE,MAAM,eAAe,GAAG,CAAC,IAAY,EAAmB,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC;QACvE,IAAI;QACJ,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,GAAG,IAAI,cAAc,EAAE,CAAC;QACtD,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;YAClB,IAAI,EAAE,GAAG,IAAI,YAAY;YACzB,OAAO,EAAE,GAAG,IAAI,eAAe;YAC/B,GAAG,EAAE,GAAG,IAAI,WAAW;YACvB,WAAW,EAAE,GAAG,IAAI,mBAAmB;YACvC,cAAc,EAAE,GAAG,IAAI,sBAAsB;SAC9C,CAAC;QACF,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;YAClB,GAAG,EAAE,GAAG,IAAI,oBAAoB;YAChC,SAAS,EAAE,GAAG,IAAI,0BAA0B;SAC7C,CAAC;QACF,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,GAAG,IAAI,YAAY,EAAE,CAAC;QAClD,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,IAAI,iBAAiB,EAAE,CAAC;QAC5D,OAAO,EAAE,GAAG,IAAI,UAAU;QAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,IAAI,aAAa,EAAE,MAAM,EAAE,GAAG,IAAI,gBAAgB,EAAE,CAAC;KACtF,CAAC,CAAA;IAEF,MAAM,yBAAyB,GAAG,CAAC,IAAY,EAA6B,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC;QAC3F,MAAM,EAAE,GAAG,IAAI,gBAAgB;KAChC,CAAC,CAAA;IAEF,MAAM,uBAAuB,GAAG,CAAC,IAAY,EAA2B,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CACzG,CAAC,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,IAAI,IAAI,IAAI,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,IAAI,IAAI,OAAO,EAAE,KAAK,EAAE,GAAG,IAAI,IAAI,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,CAChL,CAAuC,CAAA;IACxC,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,CAAA;AAChF,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,yBAAyB,EAAE,CAAA"}

package/build/consts.d.ts

@@ -52,6 +52,49 @@ export declare enum CodeScope {
     Parent = "parent",
     Entity = "entity"
 }
+/** What a data-defined schema record declares: a card type or a status flow. */
+export declare enum PlanningSchemaKind {
+    Type = "type",
+    Flow = "flow",
+    AssigneeType = "assignee-type"
+}
+export declare enum AssigneeKind {
+    Human = "human",
+    NonHuman = "non-human"
+}
+export declare enum PlanningResourceKind {
+    Workcard = "workcard",
+    Assignee = "assignee",
+    Team = "team",
+    Comment = "comment",
+    Mention = "mention"
+}
+export declare enum ProjectMode {
+    Opened = "opened",
+    Closed = "closed"
+}
+export declare const PLANNING_TEAM_MEMBER = "planning:team-member";
+export declare const PLANNING_PROJECT_TEAM = "planning:project-team";
+export declare const PLANNING_REPORTER = "planning:reporter";
+export declare const PLANNING_ASSIGNEE = "planning:assignee";
+/**
+ * The layer a resolved type or flow comes from. `code` is the in-process registry (plugins),
+ * `entity` an organization-wide record, `project` a record scoped to one project card.
+ */
+export declare enum SchemaOrigin {
+    Code = "code",
+    Entity = "entity",
+    Project = "project"
+}
+/** How a `schema.define` request writes its declarations. */
+export declare enum SchemaWriteMode {
+    /** Each declaration lands at its layer's next version. */
+    Define = "define",
+    /** Compare-and-set: each declaration's `version` must be its layer's next version. */
+    Put = "put",
+    /** Only keys the layer lacks are written, at version 1. */
+    Seed = "seed"
+}
 /** Service alias of the planning facade host. Identical on the server and in a client. */
 export declare const PLANNING_SERVICE = "planning";
 /** The path segment the protocol tree answers under when the mount names none. */
@@ -89,38 +132,4 @@ export declare const REF_MAX = 1024;
 export declare const QUERY_TEXT_MAX = 256;
 /** The longest list a wire query carries in one value (ids, parents). */
 export declare const MAX_QUERY_LIST = 500;
-/**
- * The aliases one planning tree answers under, derived from the mount's base alias.
- *
- * Two mounts of the tree in one deployment are two base aliases, never two copies of this table —
- * which is why nothing here is a global constant.
- */
-export declare const planningAliases: (base: string) => Readonly<{
-    base: string;
-    schema: Readonly<{
-        list: `${string}:schema:list`;
-    }>;
-    card: Readonly<{
-        list: `${string}:card:list`;
-        summary: `${string}:card:summary`;
-        get: `${string}:card:get`;
-        transitions: `${string}:card:transitions`;
-        specifications: `${string}:card:specifications`;
-    }>;
-    spec: Readonly<{
-        get: `${string}:specification:get`;
-        revisions: `${string}:specification:revisions`;
-    }>;
-    link: Readonly<{
-        list: `${string}:link:list`;
-    }>;
-    transition: Readonly<{
-        get: `${string}:transition:get`;
-    }>;
-    execute: `${string}:execute`;
-    commit: Readonly<{
-        get: `${string}:commit:get`;
-        events: `${string}:commit:events`;
-    }>;
-}>;
 //# sourceMappingURL=consts.d.ts.map

package/build/consts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,oBAAY,YAAY;IACtB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,aAAa,kBAAkB;CAChC;AAED;;;;;GAKG;AACH,oBAAY,eAAe;IACzB,OAAO,YAAY;IACnB,UAAU,gBAAgB;IAC1B,MAAM,WAAW;CAClB;AAED,kGAAkG;AAClG,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAIpE,CAAA;AAEF,yEAAyE;AACzE,oBAAY,eAAe;IACzB,yCAAyC;IACzC,OAAO,YAAY;IACnB,+EAA+E;IAC/E,GAAG,QAAQ;CACZ;AAED,oBAAY,gBAAgB;IAC1B,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB;AAED,oBAAY,WAAW;IACrB,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,MAAM,WAAW;CAClB;AAED,oBAAY,mBAAmB;IAC7B,QAAQ,aAAa;IACrB,IAAI,SAAS;IACb,IAAI,SAAS;CACd;AAED,oBAAY,SAAS;IACnB,MAAM,WAAW;IACjB,UAAU,eAAe;IACzB,IAAI,SAAS;CACd;AAED,0CAA0C;AAC1C,oBAAY,SAAS;IACnB,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB;AAED,0FAA0F;AAC1F,eAAO,MAAM,gBAAgB,aAAa,CAAA;AAE1C,kFAAkF;AAClF,eAAO,MAAM,aAAa,cAAc,CAAA;AAExC,0DAA0D;AAC1D,eAAO,MAAM,qBAAqB,oBAAoB,CAAA;AAEtD,sFAAsF;AACtF,eAAO,MAAM,aAAa,aAAa,CAAA;AAEvC,sDAAsD;AACtD,eAAO,MAAM,UAAU,MAAM,CAAA;AAE7B,gEAAgE;AAChE,eAAO,MAAM,sBAAsB,QAAS,CAAA;AAC5C,mEAAmE;AACnE,eAAO,MAAM,mBAAmB,KAAK,CAAA;AACrC,gEAAgE;AAChE,eAAO,MAAM,eAAe,KAAK,CAAA;AACjC,sEAAsE;AACtE,eAAO,MAAM,kBAAkB,IAAI,CAAA;AACnC,2DAA2D;AAC3D,eAAO,MAAM,mBAAmB,IAAI,CAAA;AACpC,eAAO,MAAM,oBAAoB,KAAK,CAAA;AACtC,eAAO,MAAM,iBAAiB,MAAM,CAAA;AACpC,eAAO,MAAM,uBAAuB,IAAI,CAAA;AAExC,eAAO,MAAM,SAAS,OAAO,CAAA;AAC7B,eAAO,MAAM,eAAe,QAAQ,CAAA;AACpC,eAAO,MAAM,QAAQ,KAAK,CAAA;AAC1B,eAAO,MAAM,QAAQ,MAAM,CAAA;AAC3B,eAAO,MAAM,SAAS,KAAK,CAAA;AAC3B,eAAO,MAAM,UAAU,KAAK,CAAA;AAC5B,eAAO,MAAM,WAAW,KAAK,CAAA;AAC7B,eAAO,MAAM,QAAQ,UAAY,CAAA;AACjC,eAAO,MAAM,SAAS,MAAM,CAAA;AAC5B,eAAO,MAAM,OAAO,MAAM,CAAA;AAC1B,eAAO,MAAM,OAAO,OAAO,CAAA;AAC3B,eAAO,MAAM,cAAc,MAAM,CAAA;AACjC,yEAAyE;AACzE,eAAO,MAAM,cAAc,MAAM,CAAA;AAEjC;;;;;GAKG;AACH,eAAO,MAAM,eAAe,SAAU,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkB1C,CAAA"}
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,oBAAY,YAAY;IACtB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,aAAa,kBAAkB;CAChC;AAED;;;;;GAKG;AACH,oBAAY,eAAe;IACzB,OAAO,YAAY;IACnB,UAAU,gBAAgB;IAC1B,MAAM,WAAW;CAClB;AAED,kGAAkG;AAClG,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAIpE,CAAA;AAEF,yEAAyE;AACzE,oBAAY,eAAe;IACzB,yCAAyC;IACzC,OAAO,YAAY;IACnB,+EAA+E;IAC/E,GAAG,QAAQ;CACZ;AAED,oBAAY,gBAAgB;IAC1B,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB;AAED,oBAAY,WAAW;IACrB,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,MAAM,WAAW;CAClB;AAED,oBAAY,mBAAmB;IAC7B,QAAQ,aAAa;IACrB,IAAI,SAAS;IACb,IAAI,SAAS;CACd;AAED,oBAAY,SAAS;IACnB,MAAM,WAAW;IACjB,UAAU,eAAe;IACzB,IAAI,SAAS;CACd;AAED,0CAA0C;AAC1C,oBAAY,SAAS;IACnB,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB;AAED,gFAAgF;AAChF,oBAAY,kBAAkB;IAC5B,IAAI,SAAS;IACb,IAAI,SAAS;IACb,YAAY,kBAAkB;CAC/B;AAED,oBAAY,YAAY;IACtB,KAAK,UAAU;IACf,QAAQ,cAAc;CACvB;AAED,oBAAY,oBAAoB;IAC9B,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,OAAO,YAAY;CACpB;AAED,oBAAY,WAAW;IACrB,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB;AAED,eAAO,MAAM,oBAAoB,yBAAyB,CAAA;AAC1D,eAAO,MAAM,qBAAqB,0BAA0B,CAAA;AAC5D,eAAO,MAAM,iBAAiB,sBAAsB,CAAA;AACpD,eAAO,MAAM,iBAAiB,sBAAsB,CAAA;AAEpD;;;GAGG;AACH,oBAAY,YAAY;IACtB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,OAAO,YAAY;CACpB;AAED,6DAA6D;AAC7D,oBAAY,eAAe;IACzB,0DAA0D;IAC1D,MAAM,WAAW;IACjB,sFAAsF;IACtF,GAAG,QAAQ;IACX,2DAA2D;IAC3D,IAAI,SAAS;CACd;AAED,0FAA0F;AAC1F,eAAO,MAAM,gBAAgB,aAAa,CAAA;AAE1C,kFAAkF;AAClF,eAAO,MAAM,aAAa,cAAc,CAAA;AAExC,0DAA0D;AAC1D,eAAO,MAAM,qBAAqB,oBAAoB,CAAA;AAEtD,sFAAsF;AACtF,eAAO,MAAM,aAAa,aAAa,CAAA;AAEvC,sDAAsD;AACtD,eAAO,MAAM,UAAU,MAAM,CAAA;AAE7B,gEAAgE;AAChE,eAAO,MAAM,sBAAsB,QAAS,CAAA;AAC5C,mEAAmE;AACnE,eAAO,MAAM,mBAAmB,KAAK,CAAA;AACrC,gEAAgE;AAChE,eAAO,MAAM,eAAe,KAAK,CAAA;AACjC,sEAAsE;AACtE,eAAO,MAAM,kBAAkB,IAAI,CAAA;AACnC,2DAA2D;AAC3D,eAAO,MAAM,mBAAmB,IAAI,CAAA;AACpC,eAAO,MAAM,oBAAoB,KAAK,CAAA;AACtC,eAAO,MAAM,iBAAiB,MAAM,CAAA;AACpC,eAAO,MAAM,uBAAuB,IAAI,CAAA;AAExC,eAAO,MAAM,SAAS,OAAO,CAAA;AAC7B,eAAO,MAAM,eAAe,QAAQ,CAAA;AACpC,eAAO,MAAM,QAAQ,KAAK,CAAA;AAC1B,eAAO,MAAM,QAAQ,MAAM,CAAA;AAC3B,eAAO,MAAM,SAAS,KAAK,CAAA;AAC3B,eAAO,MAAM,UAAU,KAAK,CAAA;AAC5B,eAAO,MAAM,WAAW,KAAK,CAAA;AAC7B,eAAO,MAAM,QAAQ,UAAY,CAAA;AACjC,eAAO,MAAM,SAAS,MAAM,CAAA;AAC5B,eAAO,MAAM,OAAO,MAAM,CAAA;AAC1B,eAAO,MAAM,OAAO,OAAO,CAAA;AAC3B,eAAO,MAAM,cAAc,MAAM,CAAA;AACjC,yEAAyE;AACzE,eAAO,MAAM,cAAc,MAAM,CAAA"}

package/build/consts.js

@@ -64,6 +64,55 @@ export var CodeScope;
     CodeScope["Parent"] = "parent";
     CodeScope["Entity"] = "entity";
 })(CodeScope || (CodeScope = {}));
+/** What a data-defined schema record declares: a card type or a status flow. */
+export var PlanningSchemaKind;
+(function (PlanningSchemaKind) {
+    PlanningSchemaKind["Type"] = "type";
+    PlanningSchemaKind["Flow"] = "flow";
+    PlanningSchemaKind["AssigneeType"] = "assignee-type";
+})(PlanningSchemaKind || (PlanningSchemaKind = {}));
+export var AssigneeKind;
+(function (AssigneeKind) {
+    AssigneeKind["Human"] = "human";
+    AssigneeKind["NonHuman"] = "non-human";
+})(AssigneeKind || (AssigneeKind = {}));
+export var PlanningResourceKind;
+(function (PlanningResourceKind) {
+    PlanningResourceKind["Workcard"] = "workcard";
+    PlanningResourceKind["Assignee"] = "assignee";
+    PlanningResourceKind["Team"] = "team";
+    PlanningResourceKind["Comment"] = "comment";
+    PlanningResourceKind["Mention"] = "mention";
+})(PlanningResourceKind || (PlanningResourceKind = {}));
+export var ProjectMode;
+(function (ProjectMode) {
+    ProjectMode["Opened"] = "opened";
+    ProjectMode["Closed"] = "closed";
+})(ProjectMode || (ProjectMode = {}));
+export const PLANNING_TEAM_MEMBER = 'planning:team-member';
+export const PLANNING_PROJECT_TEAM = 'planning:project-team';
+export const PLANNING_REPORTER = 'planning:reporter';
+export const PLANNING_ASSIGNEE = 'planning:assignee';
+/**
+ * The layer a resolved type or flow comes from. `code` is the in-process registry (plugins),
+ * `entity` an organization-wide record, `project` a record scoped to one project card.
+ */
+export var SchemaOrigin;
+(function (SchemaOrigin) {
+    SchemaOrigin["Code"] = "code";
+    SchemaOrigin["Entity"] = "entity";
+    SchemaOrigin["Project"] = "project";
+})(SchemaOrigin || (SchemaOrigin = {}));
+/** How a `schema.define` request writes its declarations. */
+export var SchemaWriteMode;
+(function (SchemaWriteMode) {
+    /** Each declaration lands at its layer's next version. */
+    SchemaWriteMode["Define"] = "define";
+    /** Compare-and-set: each declaration's `version` must be its layer's next version. */
+    SchemaWriteMode["Put"] = "put";
+    /** Only keys the layer lacks are written, at version 1. */
+    SchemaWriteMode["Seed"] = "seed";
+})(SchemaWriteMode || (SchemaWriteMode = {}));
 /** Service alias of the planning facade host. Identical on the server and in a client. */
 export const PLANNING_SERVICE = 'planning';
 /** The path segment the protocol tree answers under when the mount names none. */
@@ -101,29 +150,4 @@ export const REF_MAX = 1024;
 export const QUERY_TEXT_MAX = 256;
 /** The longest list a wire query carries in one value (ids, parents). */
 export const MAX_QUERY_LIST = 500;
-/**
- * The aliases one planning tree answers under, derived from the mount's base alias.
- *
- * Two mounts of the tree in one deployment are two base aliases, never two copies of this table —
- * which is why nothing here is a global constant.
- */
-export const planningAliases = (base) => Object.freeze({
-    base,
-    schema: Object.freeze({ list: `${base}:schema:list` }),
-    card: Object.freeze({
-        list: `${base}:card:list`,
-        summary: `${base}:card:summary`,
-        get: `${base}:card:get`,
-        transitions: `${base}:card:transitions`,
-        specifications: `${base}:card:specifications`,
-    }),
-    spec: Object.freeze({
-        get: `${base}:specification:get`,
-        revisions: `${base}:specification:revisions`,
-    }),
-    link: Object.freeze({ list: `${base}:link:list` }),
-    transition: Object.freeze({ get: `${base}:transition:get` }),
-    execute: `${base}:execute`,
-    commit: Object.freeze({ get: `${base}:commit:get`, events: `${base}:commit:events` }),
-});
 //# sourceMappingURL=consts.js.map

package/build/consts.js.map

@@ -1 +1 @@
-{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"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"}

package/build/entrypoints/types.d.ts

@@ -0,0 +1,105 @@
+import type { PlanningReply } from '../helpers/reply/types.js';
+import type { PlanningResourceProtocols } from '../resources/protocol/types.js';
+import type { Assignee, Team, Comment, CommentMention } from '../resources/types.js';
+import type { EntrypointProtocol, OpenRequest, OpenValue } from '@owlmeans/entrypoint';
+import type { ListResult } from '@owlmeans/resource';
+import type { RouteParent } from '@owlmeans/route';
+import type { CommitEvent, CommitFeedQuery, CommitQuery, CommitStatus, ExecuteRequest, Relationship, RelationshipQueryWire, RevisionsQuery, SchemaDefineReply, SchemaDefineRequest, SchemaListQuery, ScopedSchemaBundle, Specification, SpecificationQueryWire, SpecificationRevisionList, SummaryQueryWire, SummaryView, Transition, TransitionParams, TransitionQueryWire, TransitionReceiptView, Workcard, WorkcardParams, WorkcardQueryWire } from '../types.js';
+export interface PlanningBaseOptions {
+    /** The base alias every leaf alias derives from (`planningAliases`). */
+    alias: string;
+    /** Defaults to `PLANNING_PATH`. */
+    path?: string;
+    parent?: RouteParent;
+    service?: string;
+}
+export interface PlanningProtocolOptions {
+    base: PlanningBaseOptions;
+    /** The guard(s) the base carries; every HTTP leaf inherits them. */
+    guards: string | readonly string[];
+    gate?: {
+        alias: string;
+        params?: string | readonly string[];
+    };
+    /** Mount the separate assignee, team, comment and mention protocol branches. Off by default. */
+    resources?: boolean;
+    /**
+     * The socket base the commit feed hangs under. The feed inherits THAT base's guards; the
+     * planning base when omitted.
+     */
+    socketBase?: RouteParent;
+    /**
+     * Declare the data-defined schema surface: `schema.list` takes a `project` query and answers
+     * that layer's scoped bundle, and `schema.define` writes. Off by default — a tree without it
+     * declares exactly the other leaves.
+     */
+    definitions?: boolean;
+}
+export interface PlanningProtocols {
+    assignees?: PlanningResourceProtocols<Assignee>;
+    teams?: PlanningResourceProtocols<Team>;
+    comments?: PlanningResourceProtocols<Comment>;
+    mentions?: PlanningResourceProtocols<CommentMention>;
+    base: EntrypointProtocol<OpenRequest, OpenValue>;
+    schema: {
+        /** The plain bundle — or, on a tree declared with `definitions`, a layer's scoped one. */
+        list: EntrypointProtocol<{
+            query?: SchemaListQuery;
+        }, PlanningReply<ScopedSchemaBundle>>;
+        /** Present on a tree declared with `definitions` only. */
+        define?: EntrypointProtocol<{
+            body: SchemaDefineRequest;
+        }, PlanningReply<SchemaDefineReply>>;
+    };
+    card: {
+        list: EntrypointProtocol<{
+            query: WorkcardQueryWire;
+        }, PlanningReply<ListResult<Workcard>>>;
+        summary: EntrypointProtocol<{
+            query: SummaryQueryWire;
+        }, SummaryView>;
+        get: EntrypointProtocol<{
+            params: WorkcardParams;
+        }, PlanningReply<Workcard>>;
+        transitions: EntrypointProtocol<{
+            params: WorkcardParams;
+            query: TransitionQueryWire;
+        }, PlanningReply<ListResult<Transition>>>;
+        specifications: EntrypointProtocol<{
+            params: WorkcardParams;
+            query: SpecificationQueryWire;
+        }, PlanningReply<ListResult<Specification>>>;
+    };
+    spec: {
+        get: EntrypointProtocol<{
+            params: WorkcardParams;
+        }, PlanningReply<Specification>>;
+        revisions: EntrypointProtocol<{
+            params: WorkcardParams;
+            query: RevisionsQuery;
+        }, SpecificationRevisionList>;
+    };
+    link: {
+        list: EntrypointProtocol<{
+            query: RelationshipQueryWire;
+        }, PlanningReply<ListResult<Relationship>>>;
+    };
+    transition: {
+        get: EntrypointProtocol<{
+            params: TransitionParams;
+        }, PlanningReply<Transition>>;
+    };
+    execute: EntrypointProtocol<{
+        body: ExecuteRequest;
+    }, PlanningReply<TransitionReceiptView>>;
+    commit: {
+        get: EntrypointProtocol<{
+            params: TransitionParams;
+            query: CommitQuery;
+        }, PlanningReply<CommitStatus>>;
+        events: EntrypointProtocol<{
+            query: CommitFeedQuery;
+        }, PlanningReply<CommitEvent>>;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/build/entrypoints/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/entrypoints/types.ts"],"names":[],"mappings":"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"}

package/build/entrypoints/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/entrypoints/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/entrypoints/types.ts"],"names":[],"mappings":""}

package/build/entrypoints.d.ts

@@ -1,4 +1,4 @@
-import type { PlanningProtocolOptions, PlanningProtocols } from './types.js';
+import type { PlanningProtocolOptions, PlanningProtocols } from './entrypoints/types.js';
 /**
  * Declare the planning surface — one immutable tree a server binds and a client calls.
  *
@@ -9,6 +9,10 @@ import type { PlanningProtocolOptions, PlanningProtocols } from './types.js';
  *
  * Queries travel as their `*Wire` shapes: encode with `encode*Query` before a call, decode with
  * `decode*Query` in a handler.
+ *
+ * `definitions: true` adds the data-defined schema surface: `schema.list` takes a `project` query
+ * and answers that layer's scoped bundle, and `schema.define` (POST `/schemas`) writes. Without it
+ * the tree declares exactly the other leaves.
  */
 export declare const makePlanningProtocols: (opts: PlanningProtocolOptions) => PlanningProtocols;
 //# sourceMappingURL=entrypoints.d.ts.map

package/build/entrypoints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entrypoints.d.ts","sourceRoot":"","sources":["../src/entrypoints.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAC+D,uBAAuB,EAChG,iBAAiB,EAIlB,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,SAAU,uBAAuB,KAAG,iBAiGrE,CAAA"}
+{"version":3,"file":"entrypoints.d.ts","sourceRoot":"","sources":["../src/entrypoints.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AASxF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,qBAAqB,SAAU,uBAAuB,KAAG,iBAsHrE,CAAA"}