@bett3r-dev/blueprint-schema 1.6.0

package/build/cjs/handler-scope.d.ts

@@ -0,0 +1,27 @@
+import { HandlerScopeIssue } from './diagnostics.js';
+import { EdgeKind } from './edges.js';
+import { BlueprintNode, NodeType } from './nodes.js';
+export type HandlerAttachment = {
+    discriminator: NodeType;
+    via: EdgeKind;
+};
+export declare const HANDLER_ATTACHMENTS: Readonly<Partial<Record<NodeType, HandlerAttachment>>>;
+export type HandlerScopeRejection = {
+    handlerId: string;
+    issue: HandlerScopeIssue;
+};
+export type HandlerScopeResult = {
+    handlers: string[] | undefined;
+    rejected: HandlerScopeRejection[];
+};
+export type HandlerScopeIndex = {
+    nodesById: ReadonlyMap<string, BlueprintNode>;
+    attachments: ReadonlySet<string>;
+};
+export declare function buildHandlerScopeIndex(nodes: Iterable<BlueprintNode>, edges: Iterable<{
+    from: string;
+    to: string;
+    kind: EdgeKind;
+}>): HandlerScopeIndex;
+export declare function resolveHandlerScope(source: string, declared: readonly string[] | undefined, index: HandlerScopeIndex): HandlerScopeResult;
+//# sourceMappingURL=handler-scope.d.ts.map

package/build/cjs/handler-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-scope.d.ts","sourceRoot":"","sources":["../../src/handler-scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,aAAa,EAAE,QAAQ,CAAC;IACxB,GAAG,EAAE,QAAQ,CAAC;CACf,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAKtF,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,iBAAiB,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC/B,QAAQ,EAAE,qBAAqB,EAAE,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC9C,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAClC,CAAC;AAKF,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC9B,KAAK,EAAE,QAAQ,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,GAC5D,iBAAiB,CAenB;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EACvC,KAAK,EAAE,iBAAiB,GACvB,kBAAkB,CA4BpB"}

package/build/cjs/handler-scope.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HANDLER_ATTACHMENTS = void 0;
+exports.buildHandlerScopeIndex = buildHandlerScopeIndex;
+exports.resolveHandlerScope = resolveHandlerScope;
+exports.HANDLER_ATTACHMENTS = {
+    aggregate: { discriminator: 'command', via: 'handled-by' },
+    system: { discriminator: 'command', via: 'handled-by' },
+    policy: { discriminator: 'event', via: 'triggers' },
+    'read-model': { discriminator: 'event', via: 'projected-to' }
+};
+const attachmentKey = (artifactId, messageId) => `${artifactId}|${messageId}`;
+function buildHandlerScopeIndex(nodes, edges) {
+    const nodesById = new Map();
+    for (const node of nodes) {
+        nodesById.set(node.id, node);
+    }
+    const attachments = new Set();
+    for (const edge of edges) {
+        if (edge.kind !== 'handled-by' && edge.kind !== 'triggers' && edge.kind !== 'projected-to') {
+            continue;
+        }
+        attachments.add(attachmentKey(edge.to, edge.from));
+    }
+    return { nodesById, attachments };
+}
+function resolveHandlerScope(source, declared, index) {
+    if (declared === undefined || declared.length === 0) {
+        return { handlers: undefined, rejected: [] };
+    }
+    const sourceType = index.nodesById.get(source)?.type;
+    const attachment = sourceType === undefined ? undefined : exports.HANDLER_ATTACHMENTS[sourceType];
+    const handlers = [];
+    const rejected = [];
+    for (const handlerId of declared) {
+        const node = index.nodesById.get(handlerId);
+        if (node === undefined) {
+            rejected.push({ handlerId, issue: 'unresolved' });
+            continue;
+        }
+        if (attachment === undefined || node.type !== attachment.discriminator) {
+            rejected.push({ handlerId, issue: 'wrong-type' });
+            continue;
+        }
+        if (!index.attachments.has(attachmentKey(source, handlerId))) {
+            rejected.push({ handlerId, issue: 'unconnected' });
+            continue;
+        }
+        if (!handlers.includes(handlerId))
+            handlers.push(handlerId);
+    }
+    return { handlers: handlers.length > 0 ? handlers : undefined, rejected };
+}
+//# sourceMappingURL=handler-scope.js.map

package/build/cjs/handler-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-scope.js","sourceRoot":"","sources":["../../src/handler-scope.ts"],"names":[],"mappings":";;;AAkCA,wDAkBC;AAED,kDAgCC;AA7EY,QAAA,mBAAmB,GAA2D;IACzF,SAAS,EAAE,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,EAAE,YAAY,EAAE;IAC1D,MAAM,EAAE,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,EAAE,YAAY,EAAE;IACvD,MAAM,EAAE,EAAE,aAAa,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE;IACnD,YAAY,EAAE,EAAE,aAAa,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE;CAC9D,CAAC;AAiBF,MAAM,aAAa,GAAG,CAAE,UAAkB,EAAE,SAAiB,EAAW,EAAE,CACxE,GAAI,UAAW,IAAK,SAAU,EAAE,CAAC;AAEnC,SAAgB,sBAAsB,CACpC,KAA8B,EAC9B,KAA6D;IAE7D,MAAM,SAAS,GAAG,IAAI,GAAG,EAAyB,CAAC;IACnD,KAAM,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,SAAS,CAAC,GAAG,CAAE,IAAI,CAAC,EAAE,EAAE,IAAI,CAAE,CAAC;IACjC,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,KAAM,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAK,IAAI,CAAC,IAAI,KAAK,YAAY,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YAC5F,SAAS;QACX,CAAC;QACD,WAAW,CAAC,GAAG,CAAE,aAAa,CAAE,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAE,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;AACpC,CAAC;AAED,SAAgB,mBAAmB,CACjC,MAAc,EACd,QAAuC,EACvC,KAAwB;IAExB,IAAK,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAC/C,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,CAAE,MAAM,CAAE,EAAE,IAAI,CAAC;IACvD,MAAM,UAAU,GAAG,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,2BAAmB,CAAE,UAAU,CAAE,CAAC;IAC5F,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAA4B,EAAE,CAAC;IAE7C,KAAM,MAAM,SAAS,IAAI,QAAQ,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,CAAE,SAAS,CAAE,CAAC;QAC9C,IAAK,IAAI,KAAK,SAAS,EAAE,CAAC;YACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;YAClD,SAAS;QACX,CAAC;QACD,IAAK,UAAU,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,aAAa,EAAE,CAAC;YACxE,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;YAClD,SAAS;QACX,CAAC;QACD,IAAK,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAE,aAAa,CAAE,MAAM,EAAE,SAAS,CAAE,CAAC,EAAC,CAAC;YAChE,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC;YACnD,SAAS;QACX,CAAC;QACD,IAAK,CAAC,QAAQ,CAAC,QAAQ,CAAE,SAAS,CAAE;YAAE,QAAQ,CAAC,IAAI,CAAE,SAAS,CAAE,CAAC;IACnE,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC;AAC5E,CAAC"}

package/build/cjs/index.d.ts

@@ -0,0 +1,27 @@
+export * from './nodes.js';
+export * from './edges.js';
+export * from './graph.js';
+export * from './topology.js';
+export * from './handler-scope.js';
+export * from './flow-traversal.js';
+export * from './reachability.js';
+export * from './entry-points.js';
+export * from './diagnostics.js';
+export * from './overrides.js';
+export * from './find-orphan-nodes.js';
+export * from './apply-overrides.js';
+export * from './design.js';
+export * from './ops.js';
+export * from './op-chain.js';
+export * from './validate-design.js';
+export * from './apply-design.js';
+export * from './reality-check.js';
+export * from './convergence.js';
+export * from './replication.js';
+export * from './session.js';
+export * from './organisation.js';
+export * from './retention.js';
+export * from './map-vocabulary.js';
+export * from './map-structure.js';
+export * from './map-links.js';
+//# sourceMappingURL=index.d.ts.map

package/build/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC"}

package/build/cjs/index.js

@@ -0,0 +1,43 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./nodes.js"), exports);
+__exportStar(require("./edges.js"), exports);
+__exportStar(require("./graph.js"), exports);
+__exportStar(require("./topology.js"), exports);
+__exportStar(require("./handler-scope.js"), exports);
+__exportStar(require("./flow-traversal.js"), exports);
+__exportStar(require("./reachability.js"), exports);
+__exportStar(require("./entry-points.js"), exports);
+__exportStar(require("./diagnostics.js"), exports);
+__exportStar(require("./overrides.js"), exports);
+__exportStar(require("./find-orphan-nodes.js"), exports);
+__exportStar(require("./apply-overrides.js"), exports);
+__exportStar(require("./design.js"), exports);
+__exportStar(require("./ops.js"), exports);
+__exportStar(require("./op-chain.js"), exports);
+__exportStar(require("./validate-design.js"), exports);
+__exportStar(require("./apply-design.js"), exports);
+__exportStar(require("./reality-check.js"), exports);
+__exportStar(require("./convergence.js"), exports);
+__exportStar(require("./replication.js"), exports);
+__exportStar(require("./session.js"), exports);
+__exportStar(require("./organisation.js"), exports);
+__exportStar(require("./retention.js"), exports);
+__exportStar(require("./map-vocabulary.js"), exports);
+__exportStar(require("./map-structure.js"), exports);
+__exportStar(require("./map-links.js"), exports);
+//# sourceMappingURL=index.js.map

package/build/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,6CAA2B;AAC3B,6CAA2B;AAC3B,gDAA8B;AAC9B,qDAAmC;AACnC,sDAAoC;AACpC,oDAAkC;AAClC,oDAAkC;AAClC,mDAAiC;AACjC,iDAA+B;AAC/B,yDAAuC;AACvC,uDAAqC;AACrC,8CAA4B;AAC5B,2CAAyB;AACzB,gDAA8B;AAC9B,uDAAqC;AACrC,oDAAkC;AAClC,qDAAmC;AACnC,mDAAiC;AACjC,mDAAiC;AACjC,+CAA6B;AAC7B,oDAAkC;AAClC,iDAA+B;AAC/B,sDAAoC;AACpC,qDAAmC;AACnC,iDAA+B"}

package/build/cjs/map-links.d.ts

@@ -0,0 +1,12 @@
+import type { DesignFile } from './design.js';
+import type { BlueprintGraph } from './graph.js';
+import type { MapEntryId, MapFile, MapLink } from './map-structure.js';
+export type MapLinkReport = {
+    unlinked: string[];
+    orphaned: string[];
+    orphanedBy: Record<MapEntryId, string[]>;
+    dangling: MapLink[];
+    removed: MapLink[];
+};
+export declare function joinMapLinks(merged: BlueprintGraph, design: DesignFile, map: MapFile): MapLinkReport;
+//# sourceMappingURL=map-links.d.ts.map

package/build/cjs/map-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-links.d.ts","sourceRoot":"","sources":["../../src/map-links.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAEvE,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;IACzC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,OAAO,EAAE,OAAO,EAAE,CAAC;CACpB,CAAC;AAgBF,wBAAgB,YAAY,CAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,GAAI,aAAa,CA2CtG"}

package/build/cjs/map-links.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.joinMapLinks = joinMapLinks;
+const apply_design_js_1 = require("./apply-design.js");
+function byString(a, b) {
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+function universeOf(merged, design) {
+    const ids = new Set();
+    for (const node of design.propose?.nodes ?? [])
+        ids.add((0, apply_design_js_1.proposedNodeId)(node));
+    for (const entry of design.modify ?? [])
+        ids.add(entry.id);
+    for (const node of merged.nodes) {
+        if (node.status === 'removed')
+            ids.delete(node.id);
+    }
+    return ids;
+}
+function joinMapLinks(merged, design, map) {
+    const universe = universeOf(merged, design);
+    const nodeIds = new Set(merged.nodes.map(node => node.id));
+    const removedIds = new Set(merged.nodes.filter(node => node.status === 'removed').map(node => node.id));
+    const mapNodes = new Map(map.nodes.map(node => [node.id, node]));
+    const deliverablesOf = new Map();
+    for (const link of map.links) {
+        deliverablesOf.set(link.esId, [...(deliverablesOf.get(link.esId) ?? []), link.deliverableId]);
+    }
+    const isDead = (deliverableId) => {
+        const node = mapNodes.get(deliverableId);
+        return node === undefined || node.struck !== undefined;
+    };
+    const unlinked = [];
+    const orphaned = [];
+    const orphanedBy = {};
+    for (const id of [...universe].sort(byString)) {
+        const deliverables = deliverablesOf.get(id);
+        if (deliverables === undefined) {
+            unlinked.push(id);
+            continue;
+        }
+        if (!deliverables.every(isDead))
+            continue;
+        orphaned.push(id);
+        for (const deliverableId of deliverables) {
+            (orphanedBy[deliverableId] ??= []).push(id);
+        }
+    }
+    const dangling = map.links
+        .filter(link => !nodeIds.has(link.esId) || !mapNodes.has(link.deliverableId))
+        .map(link => ({ esId: link.esId, deliverableId: link.deliverableId }))
+        .sort((a, b) => byString(a.esId, b.esId) || byString(a.deliverableId, b.deliverableId));
+    const removed = map.links
+        .filter(link => mapNodes.has(link.deliverableId) && removedIds.has(link.esId))
+        .map(link => ({ esId: link.esId, deliverableId: link.deliverableId }))
+        .sort((a, b) => byString(a.esId, b.esId) || byString(a.deliverableId, b.deliverableId));
+    return { unlinked, orphaned, orphanedBy, dangling, removed };
+}
+//# sourceMappingURL=map-links.js.map

package/build/cjs/map-links.js.map

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

package/build/cjs/map-structure.d.ts

@@ -0,0 +1,110 @@
+import { type DecidedSource, type MapNodeLevel, type MapShape } from './map-vocabulary.js';
+export type MapStructureVersion = 1;
+export declare const MAP_STRUCTURE_VERSION: MapStructureVersion;
+export declare const LEGACY_MAP_STRUCTURE_VERSIONS: readonly number[];
+export type MapEntryId = string;
+export type MapOptionId = string;
+export type MapNode = {
+    id: MapEntryId;
+    level: MapNodeLevel;
+    title: string;
+    parents: MapEntryId[];
+    struck?: {
+        reason: string;
+    };
+};
+export type MapForkStatus = {
+    kind: 'open';
+} | {
+    kind: 'decided';
+    source: DecidedSource;
+    option: MapOptionId;
+} | {
+    kind: 'moot';
+    reason: string;
+};
+export declare function isMapForkStatus(value: unknown): value is MapForkStatus;
+export type MapOptionWalk = {
+    scenario: string;
+    text: string;
+};
+export type MapOption = {
+    id: MapOptionId;
+    label: string;
+    walks: MapOptionWalk[];
+    rejectedBecause?: string;
+    evidence?: string[];
+};
+export type MapForkCard = {
+    problem: string;
+    useCases: string[];
+    options: MapOption[];
+    recommendation: {
+        option: MapOptionId;
+        why: string;
+    };
+    ifOverturned: string;
+};
+export type MapFork = {
+    id: MapEntryId;
+    title: string;
+    card?: MapForkCard;
+    anchor?: MapEntryId;
+    restsOn: MapEntryId[];
+    status: MapForkStatus;
+    testable?: false;
+};
+export type MapEntry = MapNode | MapFork;
+export type MapLink = {
+    esId: string;
+    deliverableId: MapEntryId;
+};
+export type MapFile = {
+    structureVersion: MapStructureVersion;
+    shape?: MapShape;
+    grounded: boolean;
+    nodes: MapNode[];
+    forks: MapFork[];
+    links: MapLink[];
+};
+export type MapGroundOpPayload = {
+    shape: MapShape;
+};
+export type MapPostNodeEntry = Omit<MapNode, 'struck'>;
+export type MapPostForkEntry = Omit<MapFork, 'status'> & {
+    level: 'fork';
+};
+export type MapPostEntry = MapPostNodeEntry | MapPostForkEntry;
+export type MapPostOpPayload = MapPostEntry & {
+    prior?: MapEntry;
+};
+export type MapWithdrawal = {
+    entries: MapEntry[];
+    prior?: MapEntry[];
+};
+export type MapStrikeOpPayload = {
+    id: MapEntryId;
+    reason: string;
+};
+export type MapChooseOpPayload = {
+    fork: MapEntryId;
+    option: MapOptionId;
+    seenSeq: number;
+    source: DecidedSource;
+    prior?: MapForkStatus;
+};
+export type MapLinkOpPayload = MapLink & {
+    added?: false;
+};
+export declare const MAP_ID_PATTERN: RegExp;
+export declare function isMapId(value: unknown): value is MapEntryId;
+export declare function isMapFork(entry: MapEntry): entry is MapFork;
+export declare function emptyMap(): MapFile;
+export type MapReadStatus = 'ok' | 'migrated' | 'unreadable' | 'unsupported-structure-version';
+export type MapRead = {
+    map: MapFile;
+    status: MapReadStatus;
+    error?: string;
+};
+export declare function readMapDocument(value: unknown): MapRead;
+//# sourceMappingURL=map-structure.d.ts.map

package/build/cjs/map-structure.d.ts.map

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

package/build/cjs/map-structure.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAP_ID_PATTERN = exports.LEGACY_MAP_STRUCTURE_VERSIONS = exports.MAP_STRUCTURE_VERSION = void 0;
+exports.isMapForkStatus = isMapForkStatus;
+exports.isMapId = isMapId;
+exports.isMapFork = isMapFork;
+exports.emptyMap = emptyMap;
+exports.readMapDocument = readMapDocument;
+const map_vocabulary_js_1 = require("./map-vocabulary.js");
+exports.MAP_STRUCTURE_VERSION = 1;
+exports.LEGACY_MAP_STRUCTURE_VERSIONS = [0];
+function isMapForkStatus(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    const status = value;
+    switch (status.kind) {
+        case 'open': return true;
+        case 'decided': return (0, map_vocabulary_js_1.isDecidedSource)(status.source) && typeof status.option === 'string';
+        case 'moot': return typeof status.reason === 'string';
+        default: return false;
+    }
+}
+exports.MAP_ID_PATTERN = /^[A-Za-z0-9-]+$/;
+function isMapId(value) {
+    return typeof value === 'string' && exports.MAP_ID_PATTERN.test(value);
+}
+function isMapFork(entry) {
+    return !('level' in entry);
+}
+function emptyMap() {
+    return { structureVersion: exports.MAP_STRUCTURE_VERSION, grounded: false, nodes: [], forks: [], links: [] };
+}
+function readMapDocument(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        return { map: emptyMap(), status: 'unreadable', error: 'the map document is not an object' };
+    }
+    const document = value;
+    const observed = document.structureVersion;
+    if (observed === exports.MAP_STRUCTURE_VERSION)
+        return { map: document, status: 'ok' };
+    if (observed === undefined || exports.LEGACY_MAP_STRUCTURE_VERSIONS.includes(observed)) {
+        return {
+            map: { ...document, structureVersion: exports.MAP_STRUCTURE_VERSION },
+            status: 'migrated'
+        };
+    }
+    return {
+        map: emptyMap(),
+        status: 'unsupported-structure-version',
+        error: `the map document has structureVersion ${JSON.stringify(observed)}; this build reads `
+            + `${[...exports.LEGACY_MAP_STRUCTURE_VERSIONS, exports.MAP_STRUCTURE_VERSION].join(', ')}`
+    };
+}
+//# sourceMappingURL=map-structure.js.map

package/build/cjs/map-structure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-structure.js","sourceRoot":"","sources":["../../src/map-structure.ts"],"names":[],"mappings":";;;AAyBA,0CASC;AAqFD,0BAEC;AAED,8BAEC;AAED,4BAEC;AAcD,0CAuBC;AAtKD,2DAA4G;AAI/F,QAAA,qBAAqB,GAAwB,CAAC,CAAC;AAE/C,QAAA,6BAA6B,GAAsB,CAAE,CAAC,CAAE,CAAC;AAmBtE,SAAgB,eAAe,CAAE,KAAc;IAC7C,IAAK,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAG,OAAO,KAAK,CAAC;IAChE,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,QAAS,MAAM,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,MAAM,CAAC,CAAC,OAAO,IAAI,CAAC;QACzB,KAAK,SAAS,CAAC,CAAC,OAAO,IAAA,mCAAe,EAAE,MAAM,CAAC,MAAM,CAAE,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC;QAC7F,KAAK,MAAM,CAAC,CAAC,OAAO,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC;QACtD,OAAO,CAAC,CAAC,OAAO,KAAK,CAAC;IACxB,CAAC;AACH,CAAC;AAmFY,QAAA,cAAc,GAAG,iBAAiB,CAAC;AAEhD,SAAgB,OAAO,CAAE,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,sBAAc,CAAC,IAAI,CAAE,KAAK,CAAE,CAAC;AACnE,CAAC;AAED,SAAgB,SAAS,CAAE,KAAe;IACxC,OAAO,CAAC,CAAE,OAAO,IAAI,KAAK,CAAE,CAAC;AAC/B,CAAC;AAED,SAAgB,QAAQ;IACtB,OAAO,EAAE,gBAAgB,EAAE,6BAAqB,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AACvG,CAAC;AAcD,SAAgB,eAAe,CAAE,KAAc;IAC7C,IAAK,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAE,KAAK,CAAE,EAAC,CAAC;QAC1E,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,mCAAmC,EAAE,CAAC;IAC/F,CAAC;IAED,MAAM,QAAQ,GAAG,KAA0D,CAAC;IAC5E,MAAM,QAAQ,GAAG,QAAQ,CAAC,gBAAgB,CAAC;IAE3C,IAAK,QAAQ,KAAK,6BAAqB;QAAG,OAAO,EAAE,GAAG,EAAE,QAAmB,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAE5F,IAAK,QAAQ,KAAK,SAAS,IAAI,qCAA6B,CAAC,QAAQ,CAAE,QAAkB,CAAE,EAAC,CAAC;QAC3F,OAAO;YACL,GAAG,EAAE,EAAE,GAAK,QAAqB,EAAE,gBAAgB,EAAE,6BAAqB,EAAE;YAC5E,MAAM,EAAE,UAAU;SACnB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,GAAG,EAAE,QAAQ,EAAE;QACf,MAAM,EAAE,+BAA+B;QACvC,KAAK,EAAE,yCAA0C,IAAI,CAAC,SAAS,CAAE,QAAQ,CAAG,qBAAqB;cAC7F,GAAI,CAAE,GAAG,qCAA6B,EAAE,6BAAqB,CAAE,CAAC,IAAI,CAAE,IAAI,CAAG,EAAE;KACpF,CAAC;AACJ,CAAC"}

package/build/cjs/map-vocabulary.d.ts

@@ -0,0 +1,53 @@
+export type MapSchemaVersion = 2;
+export declare const MAP_SCHEMA_VERSION: MapSchemaVersion;
+export type ForkStatusKind = 'open' | 'decided' | 'moot';
+export declare const FORK_STATUS_KINDS: readonly ForkStatusKind[];
+export declare function isForkStatusKind(value: unknown): value is ForkStatusKind;
+export type DecidedSource = 'owner' | 'recommendation' | 'code';
+export declare const DECIDED_SOURCES: readonly DecidedSource[];
+export declare function isDecidedSource(value: unknown): value is DecidedSource;
+export type MapNodeLevel = 'goal' | 'mapActor' | 'impact' | 'deliverable';
+export declare const MAP_NODE_LEVELS: readonly MapNodeLevel[];
+export declare function isMapNodeLevel(value: unknown): value is MapNodeLevel;
+export type MapShape = 'impact' | 'decision';
+export declare const MAP_SHAPES: readonly MapShape[];
+export declare function isMapShape(value: unknown): value is MapShape;
+export type MapSchemaVocabulary = {
+    type: 'string';
+    description: string;
+    enum: readonly string[];
+};
+export type MapSchemaDocument = {
+    $schema: string;
+    title: string;
+    description: string;
+    schemaVersion: MapSchemaVersion;
+    $defs: {
+        forkStatusKind: MapSchemaVocabulary;
+        decidedSource: MapSchemaVocabulary;
+        mapNodeLevel: MapSchemaVocabulary;
+        mapShape: MapSchemaVocabulary;
+    };
+};
+export declare function mapSchemaDocument(): MapSchemaDocument;
+export declare function serialiseMapSchema(): string;
+export type MapVocabularyName = 'forkStatusKind' | 'decidedSource' | 'mapNodeLevel' | 'mapShape';
+export type MapVocabularyViolation = {
+    vocabulary: MapVocabularyName;
+    path: string;
+    value: unknown;
+    allowed: readonly string[];
+    message: string;
+};
+export type MapVocabularyUnreadable = {
+    path: string;
+    value: unknown;
+    message: string;
+};
+export type MapVocabularyValidation = {
+    ok: boolean;
+    violations: readonly MapVocabularyViolation[];
+    unreadable: readonly MapVocabularyUnreadable[];
+};
+export declare function validateMapVocabulary(document: unknown): MapVocabularyValidation;
+//# sourceMappingURL=map-vocabulary.d.ts.map

package/build/cjs/map-vocabulary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-vocabulary.d.ts","sourceRoot":"","sources":["../../src/map-vocabulary.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAEjC,eAAO,MAAM,kBAAkB,EAAE,gBAAoB,CAAC;AAEtD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAEzD,eAAO,MAAM,iBAAiB,EAAE,SAAS,cAAc,EAEtD,CAAC;AAEF,wBAAgB,gBAAgB,CAAE,KAAK,EAAE,OAAO,GAAI,KAAK,IAAI,cAAc,CAE1E;AAED,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,gBAAgB,GAAG,MAAM,CAAC;AAEhE,eAAO,MAAM,eAAe,EAAE,SAAS,aAAa,EAEnD,CAAC;AAEF,wBAAgB,eAAe,CAAE,KAAK,EAAE,OAAO,GAAI,KAAK,IAAI,aAAa,CAExE;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,aAAa,CAAC;AAE1E,eAAO,MAAM,eAAe,EAAE,SAAS,YAAY,EAKhD,CAAC;AAEJ,wBAAgB,cAAc,CAAE,KAAK,EAAE,OAAO,GAAI,KAAK,IAAI,YAAY,CAEtE;AAED,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE7C,eAAO,MAAM,UAAU,EAAE,SAAS,QAAQ,EAA8C,CAAC;AAEzF,wBAAgB,UAAU,CAAE,KAAK,EAAE,OAAO,GAAI,KAAK,IAAI,QAAQ,CAE9D;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,gBAAgB,CAAC;IAChC,KAAK,EAAE;QACL,cAAc,EAAE,mBAAmB,CAAC;QACpC,aAAa,EAAE,mBAAmB,CAAC;QACnC,YAAY,EAAE,mBAAmB,CAAC;QAClC,QAAQ,EAAE,mBAAmB,CAAC;KAC/B,CAAC;CACH,CAAC;AAEF,wBAAgB,iBAAiB,IAAI,iBAAiB,CAgCrD;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,GAAG,eAAe,GAAG,cAAc,GAAG,UAAU,CAAC;AAEjG,MAAM,MAAM,sBAAsB,GAAG;IACnC,UAAU,EAAE,iBAAiB,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,EAAE,EAAE,OAAO,CAAC;IACZ,UAAU,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC9C,UAAU,EAAE,SAAS,uBAAuB,EAAE,CAAC;CAChD,CAAC;AA8BF,wBAAgB,qBAAqB,CAAE,QAAQ,EAAE,OAAO,GAAI,uBAAuB,CAyElF"}

package/build/cjs/map-vocabulary.js

@@ -0,0 +1,156 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAP_SHAPES = exports.MAP_NODE_LEVELS = exports.DECIDED_SOURCES = exports.FORK_STATUS_KINDS = exports.MAP_SCHEMA_VERSION = void 0;
+exports.isForkStatusKind = isForkStatusKind;
+exports.isDecidedSource = isDecidedSource;
+exports.isMapNodeLevel = isMapNodeLevel;
+exports.isMapShape = isMapShape;
+exports.mapSchemaDocument = mapSchemaDocument;
+exports.serialiseMapSchema = serialiseMapSchema;
+exports.validateMapVocabulary = validateMapVocabulary;
+exports.MAP_SCHEMA_VERSION = 2;
+exports.FORK_STATUS_KINDS = Object.freeze(['open', 'decided', 'moot']);
+function isForkStatusKind(value) {
+    return typeof value === 'string' && exports.FORK_STATUS_KINDS.includes(value);
+}
+exports.DECIDED_SOURCES = Object.freeze(['owner', 'recommendation', 'code']);
+function isDecidedSource(value) {
+    return typeof value === 'string' && exports.DECIDED_SOURCES.includes(value);
+}
+exports.MAP_NODE_LEVELS = Object.freeze([
+    'goal',
+    'mapActor',
+    'impact',
+    'deliverable'
+]);
+function isMapNodeLevel(value) {
+    return typeof value === 'string' && exports.MAP_NODE_LEVELS.includes(value);
+}
+exports.MAP_SHAPES = Object.freeze(['impact', 'decision']);
+function isMapShape(value) {
+    return typeof value === 'string' && exports.MAP_SHAPES.includes(value);
+}
+function mapSchemaDocument() {
+    return {
+        $schema: 'https://json-schema.org/draft/2020-12/schema',
+        title: 'BLUEPRINT map vocabulary',
+        description: 'The closed sets an BLUEPRINT impact map is written in. Emitted from '
+            + '@bett3r-dev/blueprint-schema; do not hand-edit, and do not extend a set '
+            + 'in a consumer.',
+        schemaVersion: exports.MAP_SCHEMA_VERSION,
+        $defs: {
+            forkStatusKind: {
+                type: 'string',
+                description: 'Where a fork stands.',
+                enum: [...exports.FORK_STATUS_KINDS]
+            },
+            decidedSource: {
+                type: 'string',
+                description: 'Who settled a decided fork.',
+                enum: [...exports.DECIDED_SOURCES]
+            },
+            mapNodeLevel: {
+                type: 'string',
+                description: 'A node\'s level in the impact map; the who-level is spelled mapActor.',
+                enum: [...exports.MAP_NODE_LEVELS]
+            },
+            mapShape: {
+                type: 'string',
+                description: 'How a map is drawn: impact columns or a decision tree.',
+                enum: [...exports.MAP_SHAPES]
+            }
+        }
+    };
+}
+function serialiseMapSchema() {
+    return JSON.stringify(mapSchemaDocument(), null, 2) + '\n';
+}
+const ALLOWED_BY_VOCABULARY = {
+    forkStatusKind: exports.FORK_STATUS_KINDS,
+    decidedSource: exports.DECIDED_SOURCES,
+    mapNodeLevel: exports.MAP_NODE_LEVELS,
+    mapShape: exports.MAP_SHAPES
+};
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function violation(vocabulary, path, value) {
+    const allowed = ALLOWED_BY_VOCABULARY[vocabulary];
+    return {
+        vocabulary,
+        path,
+        value,
+        allowed,
+        message: `${path}: ${JSON.stringify(value)} is not a ${vocabulary}; `
+            + `allowed: ${allowed.join(', ')}`
+    };
+}
+function validateMapVocabulary(document) {
+    const violations = [];
+    const unreadable = [];
+    const note = (path, value, expected) => {
+        unreadable.push({
+            path,
+            value,
+            message: `${path === '' ? '<document>' : path}: expected ${expected}, `
+                + `found ${value === undefined ? 'undefined' : JSON.stringify(value)}; `
+                + 'not checked'
+        });
+    };
+    if (!isRecord(document)) {
+        note('', document, 'an object');
+        return { ok: false, violations, unreadable };
+    }
+    if (document.shape !== undefined && !isMapShape(document.shape)) {
+        violations.push(violation('mapShape', 'shape', document.shape));
+    }
+    const collection = (key) => {
+        const value = document[key];
+        if (value === undefined)
+            return [];
+        if (!Array.isArray(value)) {
+            note(key, value, 'an array');
+            return [];
+        }
+        return value;
+    };
+    collection('nodes').forEach((node, index) => {
+        if (!isRecord(node)) {
+            note(`nodes[${index}]`, node, 'an object');
+            return;
+        }
+        const level = node.level;
+        if (!isMapNodeLevel(level)) {
+            violations.push(violation('mapNodeLevel', `nodes[${index}].level`, level));
+        }
+    });
+    collection('forks').forEach((fork, index) => {
+        if (!isRecord(fork)) {
+            note(`forks[${index}]`, fork, 'an object');
+            return;
+        }
+        const rawStatus = fork.status;
+        if (rawStatus !== undefined && !isRecord(rawStatus)) {
+            note(`forks[${index}].status`, rawStatus, 'an object');
+            return;
+        }
+        const status = isRecord(rawStatus) ? rawStatus : {};
+        const kind = status.kind;
+        if (!isForkStatusKind(kind)) {
+            violations.push(violation('forkStatusKind', `forks[${index}].status.kind`, kind));
+            return;
+        }
+        if (kind !== 'decided')
+            return;
+        const source = status.source;
+        if (!isDecidedSource(source)) {
+            violations.push(violation('decidedSource', `forks[${index}].status.source`, source));
+        }
+    });
+    return {
+        ok: violations.length === 0 && unreadable.length === 0,
+        violations,
+        unreadable
+    };
+}
+//# sourceMappingURL=map-vocabulary.js.map