@owlmeans/planning 0.1.18-rc.0

package/build/helpers/apply.js

@@ -0,0 +1,162 @@
+import { IntrinsicStatus, TransitionAction } from '../consts.js';
+import { PlanningError } from '../errors.js';
+/** Never written by a transition's `changes`: the fold takes them from the transition itself. */
+const IDENTITY_KEYS = new Set(['id', 'kind', 'type', 'entityId', 'seq', 'head', 'createdAt']);
+/** Cannot be cleared: a record without them is not a record. */
+const REQUIRED_KEYS = new Set([
+    ...IDENTITY_KEYS, 'title', 'parents', 'status', 'intrinsic', 'flows', 'labels', 'fields',
+]);
+/** Merged shallowly into the card's own map rather than replacing it. */
+const MERGED_KEYS = new Set(['fields', 'flows']);
+const clean = (record) => Object.fromEntries(Object.entries(record).filter(([, value]) => value !== undefined));
+const outOfOrder = (card, transition) => new PlanningError(`fold:out-of-order:${transition.card}:${card?.seq ?? 0}:${transition.seq}`);
+const unsetOn = (record, paths) => {
+    for (const path of paths ?? []) {
+        const dot = path.indexOf('.');
+        if (dot > 0) {
+            const head = path.slice(0, dot);
+            const map = record[head];
+            if (MERGED_KEYS.has(head) && map != null && typeof map === 'object') {
+                delete map[path.slice(dot + 1)];
+            }
+            continue;
+        }
+        if (!REQUIRED_KEYS.has(path)) {
+            delete record[path];
+        }
+    }
+};
+const writeChanges = (record, changes) => {
+    for (const [key, value] of Object.entries(changes)) {
+        if (value === undefined || IDENTITY_KEYS.has(key)) {
+            continue;
+        }
+        if (MERGED_KEYS.has(key)) {
+            const merged = { ...(record[key] ?? {}) };
+            for (const [entry, entryValue] of Object.entries(value ?? {})) {
+                if (entryValue === null) {
+                    delete merged[entry];
+                }
+                else if (entryValue !== undefined) {
+                    merged[entry] = entryValue;
+                }
+            }
+            record[key] = merged;
+            continue;
+        }
+        if (value === null) {
+            if (!REQUIRED_KEYS.has(key)) {
+                delete record[key];
+            }
+            continue;
+        }
+        record[key] = value;
+    }
+};
+/**
+ * THE fold: the card after one transition. Pure, total, no I/O — every store (memory, Mongo, a
+ * client mirror) folds with this and nothing else, so one log always means one card.
+ *
+ * - An already-applied transition (`seq <= card.seq`) returns the card unchanged: re-folding is
+ *   safe.
+ * - Anything but the next seq (`card.seq + 1`, or 1 for a create with no card) is refused with
+ *   `PlanningError('fold:out-of-order')`.
+ * - `create` builds the whole record from `changes` plus the transition's identity; `delete`
+ *   answers `null`; `link`/`unlink` only move `seq`/`head`/`updatedAt` (the edges are
+ *   {@link applyRelationship}'s); `update`/`transit` write `changes` — `fields` and `flows` merge,
+ *   everything else replaces — and clear `unset`.
+ * - Every result has `seq = transition.seq`, `head = max(head, seq)`, `updatedAt = transition.at`.
+ *
+ * @throws {PlanningError} `planning:fold:out-of-order:…`
+ */
+export const applyTransition = (card, transition) => {
+    if (card != null && transition.seq <= card.seq) {
+        return card;
+    }
+    if (card == null) {
+        if (transition.action === TransitionAction.Delete) {
+            return null;
+        }
+        if (transition.action !== TransitionAction.Create || transition.seq !== 1) {
+            throw outOfOrder(card, transition);
+        }
+    }
+    else if (transition.seq !== card.seq + 1) {
+        throw outOfOrder(card, transition);
+    }
+    if (transition.action === TransitionAction.Delete) {
+        return null;
+    }
+    const head = Math.max(card?.head ?? card?.seq ?? 0, transition.seq);
+    const changes = structuredClone(transition.changes ?? {});
+    if (transition.action === TransitionAction.Create) {
+        const record = {
+            parents: [], labels: [], fields: {}, flows: {}, status: '', intrinsic: IntrinsicStatus.Planned,
+        };
+        writeChanges(record, changes);
+        unsetOn(record, transition.unset);
+        return clean({
+            ...record,
+            id: transition.card,
+            kind: transition.kind,
+            type: transition.type,
+            entityId: transition.entityId,
+            seq: transition.seq,
+            head,
+            createdAt: transition.at,
+            updatedAt: transition.at,
+        });
+    }
+    const record = structuredClone(card);
+    if (transition.action === TransitionAction.Update || transition.action === TransitionAction.Transit) {
+        writeChanges(record, changes);
+        unsetOn(record, transition.unset);
+    }
+    record.seq = transition.seq;
+    record.head = head;
+    record.updatedAt = transition.at;
+    return clean(record);
+};
+const edgeOf = (transition, draft) => clean({
+    entityId: transition.entityId,
+    type: draft.type,
+    from: draft.from ?? transition.card,
+    to: draft.to,
+    project: transition.project,
+    fields: draft.fields == null ? undefined : structuredClone(draft.fields),
+    createdAt: transition.at,
+    transition: transition.id,
+});
+const sameEdge = (left, right) => left.entityId === right.entityId && left.from === right.from && left.to === right.to && left.type === right.type;
+/**
+ * The relationships after one transition. Pure and total, like {@link applyTransition}.
+ *
+ * `create` adds its `links`, `link` adds its `link`, `unlink` removes the matching edge, and a
+ * `delete` removes every edge touching the card. An edge that already exists is kept as it is, so
+ * re-folding adds nothing. Every other action answers the list unchanged. Always a new array.
+ */
+export const applyRelationship = (links, transition) => {
+    const add = (drafts) => drafts.reduce((result, draft) => {
+        const edge = edgeOf(transition, draft);
+        return result.some(existing => sameEdge(existing, edge)) ? result : [...result, edge];
+    }, [...links]);
+    switch (transition.action) {
+        case TransitionAction.Create:
+            return add(transition.links ?? []);
+        case TransitionAction.Link:
+            return add(transition.link == null ? [] : [transition.link]);
+        case TransitionAction.Unlink: {
+            if (transition.link == null) {
+                return [...links];
+            }
+            const edge = edgeOf(transition, transition.link);
+            return links.filter(existing => !sameEdge(existing, edge));
+        }
+        case TransitionAction.Delete:
+            return links.filter(existing => existing.entityId !== transition.entityId
+                || (existing.from !== transition.card && existing.to !== transition.card));
+        default:
+            return [...links];
+    }
+};
+//# sourceMappingURL=apply.js.map

package/build/helpers/apply.js.map

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

package/build/helpers/card.d.ts

@@ -0,0 +1,17 @@
+import type { Card, Project, Specification, Workcard, WorkcardDraft } from '../types.js';
+export declare const isProject: (card?: Workcard | null) => card is Project;
+export declare const isCard: (card?: Workcard | null) => card is Card;
+export declare const isSpecification: (card?: Workcard | null) => card is Specification;
+/** `parents` with `parent` first and no repeats — the invariant every record keeps. */
+export declare const normalizeParents: (parent?: string | null, parents?: string[] | null) => string[];
+/** A draft with the collections every record carries filled in. */
+export declare const cardDefaults: (draft: WorkcardDraft) => WorkcardDraft & Required<Pick<WorkcardDraft, 'parents' | 'labels' | 'fields'>>;
+/** A transition was allocated for the card and has not been folded yet. */
+export declare const isPending: (card: Pick<Workcard, 'seq' | 'head'>) => boolean;
+export declare const parentOf: (card: Workcard) => string | undefined;
+/**
+ * The project a card belongs to: a project is its own; a card under a project is that project's;
+ * anything deeper is its parent's project, which needs the parent to answer.
+ */
+export declare const projectOf: (card: Workcard, parent?: Workcard | null) => string | undefined;
+//# sourceMappingURL=card.d.ts.map

package/build/helpers/card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card.d.ts","sourceRoot":"","sources":["../../src/helpers/card.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAExF,eAAO,MAAM,SAAS,UAAW,QAAQ,GAAG,IAAI,KAAG,IAAI,IAAI,OAA8C,CAAA;AAEzG,eAAO,MAAM,MAAM,UAAW,QAAQ,GAAG,IAAI,KAAG,IAAI,IAAI,IAAwC,CAAA;AAEhG,eAAO,MAAM,eAAe,UAAW,QAAQ,GAAG,IAAI,KAAG,IAAI,IAAI,aACtB,CAAA;AAE3C,uFAAuF;AACvF,eAAO,MAAM,gBAAgB,YAAa,MAAM,GAAG,IAAI,YAAY,MAAM,EAAE,GAAG,IAAI,KAAG,MAAM,EAE/D,CAAA;AAE5B,mEAAmE;AACnE,eAAO,MAAM,YAAY,UAAW,aAAa,KAAG,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAK/H,CAAA;AAEF,2EAA2E;AAC3E,eAAO,MAAM,SAAS,SAAU,IAAI,CAAC,QAAQ,EAAE,KAAK,GAAG,MAAM,CAAC,KAAG,OAA6C,CAAA;AAE9G,eAAO,MAAM,QAAQ,SAAU,QAAQ,KAAG,MAAM,GAAG,SAA2C,CAAA;AAE9F;;;GAGG;AACH,eAAO,MAAM,SAAS,SAAU,QAAQ,WAAW,QAAQ,GAAG,IAAI,KAAG,MAAM,GAAG,SAS7E,CAAA"}

package/build/helpers/card.js

@@ -0,0 +1,31 @@
+import { WorkcardKind } from '../consts.js';
+export const isProject = (card) => card?.kind === WorkcardKind.Project;
+export const isCard = (card) => card?.kind === WorkcardKind.Card;
+export const isSpecification = (card) => card?.kind === WorkcardKind.Specification;
+/** `parents` with `parent` first and no repeats — the invariant every record keeps. */
+export const normalizeParents = (parent, parents) => [...new Set([...(parent != null && parent !== '' ? [parent] : []), ...(parents ?? [])])]
+    .filter(id => id !== '');
+/** A draft with the collections every record carries filled in. */
+export const cardDefaults = (draft) => ({
+    ...draft,
+    parents: normalizeParents(draft.parent, draft.parents),
+    labels: [...new Set(draft.labels ?? [])],
+    fields: draft.fields ?? {},
+});
+/** A transition was allocated for the card and has not been folded yet. */
+export const isPending = (card) => (card.head ?? card.seq) > card.seq;
+export const parentOf = (card) => card.parent ?? card.parents[0];
+/**
+ * The project a card belongs to: a project is its own; a card under a project is that project's;
+ * anything deeper is its parent's project, which needs the parent to answer.
+ */
+export const projectOf = (card, parent) => {
+    if (isProject(card)) {
+        return card.id;
+    }
+    if (parent != null) {
+        return isProject(parent) ? parent.id : parent.parent;
+    }
+    return card.parent;
+};
+//# sourceMappingURL=card.js.map

package/build/helpers/card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"card.js","sourceRoot":"","sources":["../../src/helpers/card.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAG3C,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAsB,EAAmB,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,YAAY,CAAC,OAAO,CAAA;AAEzG,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,IAAsB,EAAgB,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,YAAY,CAAC,IAAI,CAAA;AAEhG,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAsB,EAAyB,EAAE,CAC/E,IAAI,EAAE,IAAI,KAAK,YAAY,CAAC,aAAa,CAAA;AAE3C,uFAAuF;AACvF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAsB,EAAE,OAAyB,EAAY,EAAE,CAC9F,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,IAAI,IAAI,IAAI,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;KACrF,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;AAE5B,mEAAmE;AACnE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAoB,EAAkF,EAAE,CAAC,CAAC;IACrI,GAAG,KAAK;IACR,OAAO,EAAE,gBAAgB,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC;IACtD,MAAM,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IACxC,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE;CAC3B,CAAC,CAAA;AAEF,2EAA2E;AAC3E,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAoC,EAAW,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAA;AAE9G,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAc,EAAsB,EAAE,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;AAE9F;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAc,EAAE,MAAwB,EAAsB,EAAE;IACxF,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC,EAAE,CAAA;IAChB,CAAC;IACD,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;QACnB,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAA;IACtD,CAAC;IAED,OAAO,IAAI,CAAC,MAAM,CAAA;AACpB,CAAC,CAAA"}

package/build/helpers/changes.d.ts

@@ -0,0 +1,51 @@
+import type { AnyTypeSchema, PlanningSchemaRegistry, SpecificationSlot, TransitionExecution, Workcard, WorkcardChanges } from '../types.js';
+type FlowLookup = Pick<PlanningSchemaRegistry, 'flow'>;
+export interface ChangeSet {
+    changes: WorkcardChanges;
+    unset: string[];
+    /** Transit only: the flow that moved, and the move. */
+    flow?: string;
+    from?: string;
+    to?: string;
+}
+/** Structural equality over JSON values. */
+export declare const sameValue: (left: unknown, right: unknown) => boolean;
+/** A shallow merge that drops keys patched to `null`. */
+export declare const mergeFields: (base?: Record<string, unknown> | null, patch?: Record<string, unknown> | null) => Record<string, unknown>;
+/** A copy of the record with the paths (`key`, `fields.key`, `flows.id`) removed. */
+export declare const applyUnset: <T extends object>(record: T, unset?: string[]) => T;
+/**
+ * Refuse an execution that writes what only the transition, the flow or the executor may write.
+ *
+ * `status`/`intrinsic`/`flows`/`closedAt` move only through `transit` (a create's draft may name
+ * the initial status); `code` is fixed once minted unless the type's policy says `mutable`;
+ * `category` is fixed; `revision`/`bodyChars` are computed.
+ *
+ * @throws {PlanningError} `planning:immutable:<field>`
+ */
+export declare const assertMutable: (exec: TransitionExecution, type: AnyTypeSchema) => void;
+/**
+ * The `changes`/`unset` a transition records (plan step 9).
+ *
+ * - `create`: the whole initial record from the draft (overlaid by `exec.changes`) — `parents`
+ *   normalized, every flow at its initial status (the draft's `status` for the primary one),
+ *   `status`/`intrinsic` mirrored, `closedAt` when it starts closed; a specification gets its
+ *   format, `bodyChars` and revision 1 when the slot is revisioned.
+ * - `update`: only what differs; `null` or `exec.unset` clears a field that has a value; a moved
+ *   `parent` replaces the old one in `parents`; a revisioned document whose content changed gets
+ *   `revision + 1`. An update that changes nothing is empty ({@link isEmptyChange}).
+ * - `transit`: `flows[flow] = rule.to`, `status` when the flow is primary, `intrinsic` when it
+ *   moves, `closedAt` set on entering closed and cleared on leaving it — plus the caller's own
+ *   changes, diffed as in an update.
+ * - `link`, `unlink`, `delete`: nothing.
+ *
+ * @throws {IllegalTransition} a transit the flow does not offer from the current status
+ * @throws {PlanningError} `malformed:*` for an execution missing what its action needs
+ */
+export declare const computeChanges: (card: Workcard | null | undefined, exec: TransitionExecution, type: AnyTypeSchema, registry: FlowLookup, at: string, opts?: {
+    slot?: SpecificationSlot | null;
+}) => ChangeSet;
+/** Nothing to write: no changed value and nothing to clear. */
+export declare const isEmptyChange: (set: Pick<ChangeSet, 'changes' | 'unset'>) => boolean;
+export {};
+//# sourceMappingURL=changes.d.ts.map

package/build/helpers/changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changes.d.ts","sourceRoot":"","sources":["../../src/helpers/changes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EAAE,sBAAsB,EAAiB,iBAAiB,EAAE,mBAAmB,EAC5F,QAAQ,EAAE,eAAe,EAC1B,MAAM,aAAa,CAAA;AAKpB,KAAK,UAAU,GAAG,IAAI,CAAC,sBAAsB,EAAE,MAAM,CAAC,CAAA;AAEtD,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,eAAe,CAAA;IACxB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,EAAE,CAAC,EAAE,MAAM,CAAA;CACZ;AAgBD,4CAA4C;AAC5C,eAAO,MAAM,SAAS,SAAU,OAAO,SAAS,OAAO,KAAG,OAczD,CAAA;AAKD,yDAAyD;AACzD,eAAO,MAAM,WAAW,UACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,KAC5E,MAAM,CAAC,MAAM,EAAE,OAAO,CACuC,CAAA;AAEhE,qFAAqF;AACrF,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,MAAM,UAAU,CAAC,UAAU,MAAM,EAAE,KAAG,CAe1E,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,SAAU,mBAAmB,QAAQ,aAAa,KAAG,IA0B9E,CAAA;AAsID;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,cAAc,SACnB,QAAQ,GAAG,IAAI,GAAG,SAAS,QAC3B,mBAAmB,QACnB,aAAa,YACT,UAAU,MAChB,MAAM,SACH;IAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAA;CAAE,KACzC,SAsDF,CAAA;AAED,+DAA+D;AAC/D,eAAO,MAAM,aAAa,QAAS,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,KAAG,OAEW,CAAA"}

package/build/helpers/changes.js

@@ -0,0 +1,277 @@
+import { IntrinsicStatus, SpecificationFormat, TransitionAction, WorkcardKind } from '../consts.js';
+import { IllegalTransition, PlanningError } from '../errors.js';
+import { normalizeParents } from './card.js';
+import { bodyCharsOf, nextRevision } from './specification.js';
+import { initialFlowsOf, initialStatusOf, primaryFlowOf, resolveIntrinsic, ruleOf } from './status.js';
+/** Never in a caller's changes: the transition itself carries them. */
+const IDENTITY_KEYS = ['id', 'kind', 'type', 'entityId', 'seq', 'head', 'createdAt'];
+/** Move only through `transit` (or a create's draft). */
+const FLOW_KEYS = ['status', 'intrinsic', 'flows', 'closedAt'];
+/** Computed by the executor, never supplied. */
+const DERIVED_KEYS = ['revision', 'bodyChars'];
+/** Cannot be cleared. */
+const REQUIRED_KEYS = ['title', 'parents', 'labels', 'fields', 'category', 'format'];
+/** Changing one of these produces a new revision of a revisioned document. */
+const CONTENT_KEYS = ['body', 'ref', 'format', 'version'];
+const isPlainObject = (value) => value != null && typeof value === 'object' && !Array.isArray(value);
+/** Structural equality over JSON values. */
+export const sameValue = (left, right) => {
+    if (left === right) {
+        return true;
+    }
+    if (Array.isArray(left) && Array.isArray(right)) {
+        return left.length === right.length && left.every((entry, index) => sameValue(entry, right[index]));
+    }
+    if (isPlainObject(left) && isPlainObject(right)) {
+        const keys = Object.keys(left).filter(key => left[key] !== undefined);
+        const other = Object.keys(right).filter(key => right[key] !== undefined);
+        return keys.length === other.length && keys.every(key => sameValue(left[key], right[key]));
+    }
+    return false;
+};
+const clean = (record) => Object.fromEntries(Object.entries(record).filter(([, value]) => value !== undefined));
+/** A shallow merge that drops keys patched to `null`. */
+export const mergeFields = (base, patch) => Object.fromEntries(Object.entries({ ...(base ?? {}), ...(patch ?? {}) })
+    .filter(([, value]) => value !== null && value !== undefined));
+/** A copy of the record with the paths (`key`, `fields.key`, `flows.id`) removed. */
+export const applyUnset = (record, unset) => {
+    const copy = structuredClone(record);
+    for (const path of unset ?? []) {
+        const [head, ...rest] = path.split('.');
+        if (rest.length > 0) {
+            const map = copy[head];
+            if (isPlainObject(map)) {
+                delete map[rest.join('.')];
+            }
+        }
+        else {
+            delete copy[head];
+        }
+    }
+    return copy;
+};
+/**
+ * Refuse an execution that writes what only the transition, the flow or the executor may write.
+ *
+ * `status`/`intrinsic`/`flows`/`closedAt` move only through `transit` (a create's draft may name
+ * the initial status); `code` is fixed once minted unless the type's policy says `mutable`;
+ * `category` is fixed; `revision`/`bodyChars` are computed.
+ *
+ * @throws {PlanningError} `planning:immutable:<field>`
+ */
+export const assertMutable = (exec, type) => {
+    const create = exec.action === TransitionAction.Create;
+    const codeFixed = type.code != null && type.code.mutable !== true;
+    const refuse = (key) => {
+        throw new PlanningError(`immutable:${FLOW_KEYS.includes(key) ? 'status' : key}`);
+    };
+    for (const [key, value] of Object.entries(exec.changes ?? {})) {
+        if (value === undefined) {
+            continue;
+        }
+        if (IDENTITY_KEYS.includes(key) || DERIVED_KEYS.includes(key)) {
+            refuse(key);
+        }
+        if (!create && (FLOW_KEYS.includes(key) || key === 'category' || (key === 'code' && codeFixed))) {
+            refuse(key);
+        }
+    }
+    for (const path of exec.unset ?? []) {
+        const head = path.split('.')[0];
+        if (IDENTITY_KEYS.includes(path) || DERIVED_KEYS.includes(path) || REQUIRED_KEYS.includes(path)
+            || FLOW_KEYS.includes(head) || (path === 'code' && codeFixed)) {
+            refuse(path);
+        }
+    }
+};
+const reach = (record, path) => path.split('.')
+    .reduce((value, step) => isPlainObject(value) ? value[step] : undefined, record);
+/** Only what differs from the card; `null` becomes an unset of a field that has a value. */
+const diffInto = (card, changes, skip, set) => {
+    const out = set.changes;
+    const current = card;
+    for (const [key, value] of Object.entries(changes ?? {})) {
+        if (value === undefined || IDENTITY_KEYS.includes(key) || skip.includes(key)) {
+            continue;
+        }
+        if (key === 'fields' || key === 'flows') {
+            const own = (current[key] ?? {});
+            const patch = {};
+            for (const [entry, entryValue] of Object.entries(value ?? {})) {
+                if (entryValue === undefined) {
+                    continue;
+                }
+                if (entryValue === null) {
+                    if (own[entry] !== undefined) {
+                        set.unset.push(`${key}.${entry}`);
+                    }
+                }
+                else if (!sameValue(own[entry], entryValue)) {
+                    patch[entry] = entryValue;
+                }
+            }
+            if (Object.keys(patch).length > 0) {
+                out[key] = patch;
+            }
+            continue;
+        }
+        if (value === null) {
+            if (current[key] != null) {
+                set.unset.push(key);
+            }
+            continue;
+        }
+        if (!sameValue(current[key], value)) {
+            out[key] = value;
+        }
+    }
+};
+const unsetInto = (card, unset, set) => {
+    for (const path of unset ?? []) {
+        if (reach(card, path) !== undefined && !set.unset.includes(path)) {
+            set.unset.push(path);
+        }
+    }
+};
+/** A moved primary parent replaces the old one in `parents`. */
+const reparent = (card, set) => {
+    const out = set.changes;
+    const moved = out.parent !== undefined || set.unset.includes('parent');
+    if (!moved || out.parents !== undefined) {
+        return;
+    }
+    const parents = normalizeParents(out.parent, card.parents.filter(parent => parent !== card.parent));
+    if (!sameValue(parents, card.parents)) {
+        out.parents = parents;
+    }
+};
+const reviseInto = (card, slot, set) => {
+    if (card.kind !== WorkcardKind.Specification) {
+        return;
+    }
+    const out = set.changes;
+    if (out.body !== undefined) {
+        out.bodyChars = bodyCharsOf(out.body);
+    }
+    else if (set.unset.includes('body') && !set.unset.includes('bodyChars')) {
+        set.unset.push('bodyChars');
+    }
+    const revised = CONTENT_KEYS.some(key => out[key] !== undefined || set.unset.includes(key));
+    if (revised) {
+        const revision = nextRevision(card, slot);
+        if (revision != null) {
+            out.revision = revision;
+        }
+    }
+};
+const createOf = (exec, type, registry, at, slot) => {
+    if (typeof exec.card === 'string') {
+        throw new PlanningError('malformed:create-without-draft');
+    }
+    const draft = exec.card;
+    const overlay = Object.fromEntries(Object.entries(exec.changes ?? {})
+        .filter(([key]) => !FLOW_KEYS.includes(key) && !IDENTITY_KEYS.includes(key) && !DERIVED_KEYS.includes(key)));
+    const parent = overlay.parent ?? draft.parent;
+    const flows = initialFlowsOf(type, registry, draft.status ?? exec.changes?.status);
+    const intrinsic = resolveIntrinsic(type, flows, registry);
+    const record = {
+        title: draft.title,
+        description: draft.description,
+        code: draft.code,
+        order: draft.order,
+        createdBy: draft.createdBy,
+        ...overlay,
+        labels: [...new Set(overlay.labels ?? draft.labels ?? [])],
+        parent,
+        parents: normalizeParents(parent, overlay.parents ?? draft.parents),
+        fields: mergeFields(draft.fields, overlay.fields),
+        flows,
+        status: flows[primaryFlowOf(type)],
+        intrinsic,
+        closedAt: intrinsic === IntrinsicStatus.Closed ? at : undefined,
+    };
+    if (draft.kind === WorkcardKind.Specification) {
+        const body = overlay.body ?? draft.body;
+        Object.assign(record, {
+            category: overlay.category ?? draft.category ?? slot?.category,
+            format: overlay.format ?? draft.format ?? slot?.format ?? SpecificationFormat.Markdown,
+            body,
+            ref: overlay.ref ?? draft.ref,
+            version: overlay.version ?? draft.version ?? slot?.version,
+            bodyChars: bodyCharsOf(body),
+            revision: nextRevision(null, slot),
+        });
+    }
+    return { changes: clean(record), unset: [] };
+};
+/**
+ * The `changes`/`unset` a transition records (plan step 9).
+ *
+ * - `create`: the whole initial record from the draft (overlaid by `exec.changes`) — `parents`
+ *   normalized, every flow at its initial status (the draft's `status` for the primary one),
+ *   `status`/`intrinsic` mirrored, `closedAt` when it starts closed; a specification gets its
+ *   format, `bodyChars` and revision 1 when the slot is revisioned.
+ * - `update`: only what differs; `null` or `exec.unset` clears a field that has a value; a moved
+ *   `parent` replaces the old one in `parents`; a revisioned document whose content changed gets
+ *   `revision + 1`. An update that changes nothing is empty ({@link isEmptyChange}).
+ * - `transit`: `flows[flow] = rule.to`, `status` when the flow is primary, `intrinsic` when it
+ *   moves, `closedAt` set on entering closed and cleared on leaving it — plus the caller's own
+ *   changes, diffed as in an update.
+ * - `link`, `unlink`, `delete`: nothing.
+ *
+ * @throws {IllegalTransition} a transit the flow does not offer from the current status
+ * @throws {PlanningError} `malformed:*` for an execution missing what its action needs
+ */
+export const computeChanges = (card, exec, type, registry, at, opts) => {
+    if (exec.action === TransitionAction.Create) {
+        return createOf(exec, type, registry, at, opts?.slot);
+    }
+    const set = { changes: {}, unset: [] };
+    if (exec.action !== TransitionAction.Update && exec.action !== TransitionAction.Transit) {
+        return set;
+    }
+    if (card == null) {
+        throw new PlanningError(`malformed:${exec.action}-without-card`);
+    }
+    if (exec.action === TransitionAction.Update) {
+        diffInto(card, exec.changes, [], set);
+        unsetInto(card, exec.unset, set);
+        reparent(card, set);
+        reviseInto(card, opts?.slot, set);
+        return set;
+    }
+    if (exec.transition == null) {
+        throw new PlanningError('malformed:transit-without-transition');
+    }
+    const primary = primaryFlowOf(type);
+    const flowId = exec.flow ?? primary;
+    const flow = registry.flow(flowId);
+    const from = card.flows[flowId] ?? (flowId === primary ? card.status : initialStatusOf(flow));
+    const rule = ruleOf(flow, exec.transition, from);
+    if (rule == null) {
+        throw new IllegalTransition(`${flowId}:${exec.transition}:${from}`);
+    }
+    diffInto(card, exec.changes, FLOW_KEYS, set);
+    unsetInto(card, exec.unset?.filter(path => !FLOW_KEYS.includes(path.split('.')[0])), set);
+    reparent(card, set);
+    reviseInto(card, opts?.slot, set);
+    const flows = { ...card.flows, [flowId]: rule.to };
+    set.changes.flows = { [flowId]: rule.to };
+    if (flowId === primary) {
+        set.changes.status = rule.to;
+    }
+    const intrinsic = resolveIntrinsic(type, flows, registry);
+    if (intrinsic !== card.intrinsic) {
+        set.changes.intrinsic = intrinsic;
+    }
+    if (intrinsic === IntrinsicStatus.Closed && card.intrinsic !== IntrinsicStatus.Closed) {
+        set.changes.closedAt = at;
+    }
+    else if (intrinsic !== IntrinsicStatus.Closed && card.closedAt != null) {
+        set.unset.push('closedAt');
+    }
+    return { ...set, flow: flowId, from, to: rule.to };
+};
+/** Nothing to write: no changed value and nothing to clear. */
+export const isEmptyChange = (set) => set.unset.length === 0 && Object.entries(set.changes).every(([, value]) => value === undefined || (isPlainObject(value) && Object.keys(value).length === 0));
+//# sourceMappingURL=changes.js.map

package/build/helpers/changes.js.map

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

package/build/helpers/code.d.ts

@@ -0,0 +1,24 @@
+import type { CodePolicy, WorkcardDraft } from '../types.js';
+export interface MintCodeOptions {
+    /** Slug style: the text the slug is derived from (a title). A word slug when omitted. */
+    seed?: string;
+    /** Sequential style: how many codes the scope already holds. */
+    count?: number;
+}
+/** `Some Title!` → `some-title`. */
+export declare const slugOf: (text: string, max?: number) => string;
+/**
+ * Mint a code under a policy, asking `taken` for each candidate.
+ *
+ * `random` draws `prefix + Base58(length)` (upper-cased when asked) afresh per attempt; `slug`
+ * walks `base`, `base-2`, `base-3` from the seed (a word slug without one); `sequential` counts on
+ * from `opts.count`, zero-padded to `length`. After `attempts` taken candidates it refuses.
+ *
+ * @throws {CodeTaken}
+ */
+export declare const mintCode: (policy: CodePolicy, taken: (code: string) => boolean | Promise<boolean>, attempts?: number, opts?: MintCodeOptions) => Promise<string>;
+/** Where a draft's code must be unique: its parent, or the whole entity. */
+export declare const codeScopeOf: (policy: CodePolicy, draft: Pick<WorkcardDraft, 'parent'>) => {
+    parent?: string;
+};
+//# sourceMappingURL=code.d.ts.map

package/build/helpers/code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../src/helpers/code.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE5D,MAAM,WAAW,eAAe;IAC9B,yFAAyF;IACzF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,oCAAoC;AACpC,eAAO,MAAM,MAAM,SAAU,MAAM,QAAO,MAAM,KAAc,MAG1B,CAAA;AAmBpC;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,WACX,UAAU,SACX,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,aACzC,MAAM,SACT,eAAe,KACrB,OAAO,CAAC,MAAM,CAYhB,CAAA;AAED,4EAA4E;AAC5E,eAAO,MAAM,WAAW,WAAY,UAAU,SAAS,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,KAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAC9B,CAAA"}