@bett3r-dev/blueprint-schema 1.6.0

package/build/esm/index.js

@@ -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.js.map

package/build/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","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/esm/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/esm/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/esm/map-links.js

@@ -0,0 +1,56 @@
+import { proposedNodeId } from './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(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;
+}
+export 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/esm/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/esm/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/esm/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/esm/map-structure.js

@@ -0,0 +1,46 @@
+import { isDecidedSource } from './map-vocabulary.js';
+export const MAP_STRUCTURE_VERSION = 1;
+export const LEGACY_MAP_STRUCTURE_VERSIONS = [0];
+export function isMapForkStatus(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    const status = value;
+    switch (status.kind) {
+        case 'open': return true;
+        case 'decided': return isDecidedSource(status.source) && typeof status.option === 'string';
+        case 'moot': return typeof status.reason === 'string';
+        default: return false;
+    }
+}
+export const MAP_ID_PATTERN = /^[A-Za-z0-9-]+$/;
+export function isMapId(value) {
+    return typeof value === 'string' && MAP_ID_PATTERN.test(value);
+}
+export function isMapFork(entry) {
+    return !('level' in entry);
+}
+export function emptyMap() {
+    return { structureVersion: MAP_STRUCTURE_VERSION, grounded: false, nodes: [], forks: [], links: [] };
+}
+export 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 === MAP_STRUCTURE_VERSION)
+        return { map: document, status: 'ok' };
+    if (observed === undefined || LEGACY_MAP_STRUCTURE_VERSIONS.includes(observed)) {
+        return {
+            map: { ...document, structureVersion: MAP_STRUCTURE_VERSION },
+            status: 'migrated'
+        };
+    }
+    return {
+        map: emptyMap(),
+        status: 'unsupported-structure-version',
+        error: `the map document has structureVersion ${JSON.stringify(observed)}; this build reads `
+            + `${[...LEGACY_MAP_STRUCTURE_VERSIONS, MAP_STRUCTURE_VERSION].join(', ')}`
+    };
+}
+//# sourceMappingURL=map-structure.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"map-structure.js","sourceRoot":"","sources":["../../src/map-structure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwD,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAI5G,MAAM,CAAC,MAAM,qBAAqB,GAAwB,CAAC,CAAC;AAE5D,MAAM,CAAC,MAAM,6BAA6B,GAAsB,CAAE,CAAC,CAAE,CAAC;AAmBtE,MAAM,UAAU,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,eAAe,CAAE,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;AAmFD,MAAM,CAAC,MAAM,cAAc,GAAG,iBAAiB,CAAC;AAEhD,MAAM,UAAU,OAAO,CAAE,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,cAAc,CAAC,IAAI,CAAE,KAAK,CAAE,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,SAAS,CAAE,KAAe;IACxC,OAAO,CAAC,CAAE,OAAO,IAAI,KAAK,CAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AACvG,CAAC;AAcD,MAAM,UAAU,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,qBAAqB;QAAG,OAAO,EAAE,GAAG,EAAE,QAAmB,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAE5F,IAAK,QAAQ,KAAK,SAAS,IAAI,6BAA6B,CAAC,QAAQ,CAAE,QAAkB,CAAE,EAAC,CAAC;QAC3F,OAAO;YACL,GAAG,EAAE,EAAE,GAAK,QAAqB,EAAE,gBAAgB,EAAE,qBAAqB,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,6BAA6B,EAAE,qBAAqB,CAAE,CAAC,IAAI,CAAE,IAAI,CAAG,EAAE;KACpF,CAAC;AACJ,CAAC"}

package/build/esm/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/esm/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/esm/map-vocabulary.js

@@ -0,0 +1,146 @@
+export const MAP_SCHEMA_VERSION = 2;
+export const FORK_STATUS_KINDS = Object.freeze(['open', 'decided', 'moot']);
+export function isForkStatusKind(value) {
+    return typeof value === 'string' && FORK_STATUS_KINDS.includes(value);
+}
+export const DECIDED_SOURCES = Object.freeze(['owner', 'recommendation', 'code']);
+export function isDecidedSource(value) {
+    return typeof value === 'string' && DECIDED_SOURCES.includes(value);
+}
+export const MAP_NODE_LEVELS = Object.freeze([
+    'goal',
+    'mapActor',
+    'impact',
+    'deliverable'
+]);
+export function isMapNodeLevel(value) {
+    return typeof value === 'string' && MAP_NODE_LEVELS.includes(value);
+}
+export const MAP_SHAPES = Object.freeze(['impact', 'decision']);
+export function isMapShape(value) {
+    return typeof value === 'string' && MAP_SHAPES.includes(value);
+}
+export 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: MAP_SCHEMA_VERSION,
+        $defs: {
+            forkStatusKind: {
+                type: 'string',
+                description: 'Where a fork stands.',
+                enum: [...FORK_STATUS_KINDS]
+            },
+            decidedSource: {
+                type: 'string',
+                description: 'Who settled a decided fork.',
+                enum: [...DECIDED_SOURCES]
+            },
+            mapNodeLevel: {
+                type: 'string',
+                description: 'A node\'s level in the impact map; the who-level is spelled mapActor.',
+                enum: [...MAP_NODE_LEVELS]
+            },
+            mapShape: {
+                type: 'string',
+                description: 'How a map is drawn: impact columns or a decision tree.',
+                enum: [...MAP_SHAPES]
+            }
+        }
+    };
+}
+export function serialiseMapSchema() {
+    return JSON.stringify(mapSchemaDocument(), null, 2) + '\n';
+}
+const ALLOWED_BY_VOCABULARY = {
+    forkStatusKind: FORK_STATUS_KINDS,
+    decidedSource: DECIDED_SOURCES,
+    mapNodeLevel: MAP_NODE_LEVELS,
+    mapShape: 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(', ')}`
+    };
+}
+export 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

package/build/esm/map-vocabulary.js.map

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

package/build/esm/nodes.d.ts

@@ -0,0 +1,39 @@
+export type NodeSource = {
+    file: string;
+    line: number;
+};
+export type NodeMeta = {
+    source: NodeSource;
+};
+export type Origin = 'extracted' | 'manual' | 'human' | 'ai' | 'derived';
+export type DesignAuthor = 'human' | 'ai';
+export type DesignStatus = 'proposed' | 'modified' | 'removed' | 'satisfied';
+export type UiKind = 'end-user' | 'back-office';
+export type NodeType = 'aggregate' | 'system' | 'command' | 'event' | 'policy' | 'read-model' | 'external-system' | 'datastore' | 'cache' | 'ui' | 'postgres-view';
+export declare const NODE_TYPES: readonly NodeType[];
+export declare const NODE_ABBREV: Record<NodeType, string>;
+export declare const NODE_TYPE_BY_ABBREV: Readonly<Record<string, NodeType>>;
+export type ReadModelQuery = {
+    route: string;
+    source: NodeSource;
+};
+export type ReadModelSearchIndex = {
+    engine: string;
+    source: NodeSource;
+};
+export type BlueprintNode = {
+    id: string;
+    type: NodeType;
+    label: string;
+    subdomain: string;
+    resourceKey?: string;
+    queries?: ReadModelQuery[];
+    searchIndexes?: ReadModelSearchIndex[];
+    meta?: NodeMeta;
+    uiKind?: UiKind;
+    origin?: Origin;
+    status?: DesignStatus;
+    previousLabel?: string;
+    note?: string;
+};
+//# sourceMappingURL=nodes.d.ts.map

package/build/esm/nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodes.d.ts","sourceRoot":"","sources":["../../src/nodes.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,MAAM,EAAE,UAAU,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AAEzE,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,IAAI,CAAC;AAE1C,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,CAAC;AAE7E,MAAM,MAAM,MAAM,GAAG,UAAU,GAAG,aAAa,CAAC;AAEhD,MAAM,MAAM,QAAQ,GAChB,WAAW,GACX,QAAQ,GACR,SAAS,GACT,OAAO,GACP,QAAQ,GACR,YAAY,GACZ,iBAAiB,GACjB,WAAW,GACX,OAAO,GACP,IAAI,GACJ,eAAe,CAAC;AAEpB,eAAO,MAAM,UAAU,EAAE,SAAS,QAAQ,EAYhC,CAAC;AAEX,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAYhD,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAElE,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,aAAa,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACvC,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC"}

package/build/esm/nodes.js

@@ -0,0 +1,28 @@
+export const NODE_TYPES = [
+    'aggregate',
+    'system',
+    'command',
+    'event',
+    'policy',
+    'read-model',
+    'external-system',
+    'datastore',
+    'cache',
+    'ui',
+    'postgres-view'
+];
+export const NODE_ABBREV = {
+    'aggregate': 'agg',
+    'system': 'sys',
+    'command': 'cmd',
+    'event': 'evt',
+    'policy': 'pol',
+    'read-model': 'rm',
+    'external-system': 'ext',
+    'datastore': 'tbl',
+    'cache': 'cache',
+    'ui': 'ui',
+    'postgres-view': 'view'
+};
+export const NODE_TYPE_BY_ABBREV = Object.fromEntries(NODE_TYPES.map(type => [NODE_ABBREV[type], type]));
+//# sourceMappingURL=nodes.js.map

package/build/esm/nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodes.js","sourceRoot":"","sources":["../../src/nodes.ts"],"names":[],"mappings":"AA8BA,MAAM,CAAC,MAAM,UAAU,GAAwB;IAC7C,WAAW;IACX,QAAQ;IACR,SAAS;IACT,OAAO;IACP,QAAQ;IACR,YAAY;IACZ,iBAAiB;IACjB,WAAW;IACX,OAAO;IACP,IAAI;IACJ,eAAe;CACP,CAAC;AAEX,MAAM,CAAC,MAAM,WAAW,GAA6B;IACnD,WAAW,EAAE,KAAK;IAClB,QAAQ,EAAE,KAAK;IACf,SAAS,EAAE,KAAK;IAChB,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE,KAAK;IACf,YAAY,EAAE,IAAI;IAClB,iBAAiB,EAAE,KAAK;IACxB,WAAW,EAAE,KAAK;IAClB,OAAO,EAAE,OAAO;IAChB,IAAI,EAAE,IAAI;IACV,eAAe,EAAE,MAAM;CACxB,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAuC,MAAM,CAAC,WAAW,CACvF,UAAU,CAAC,GAAG,CAAE,IAAI,CAAC,EAAE,CAAC,CAAE,WAAW,CAAE,IAAI,CAAE,EAAE,IAAI,CAAE,CAAE,CACxD,CAAC"}

package/build/esm/op-chain.d.ts

@@ -0,0 +1,18 @@
+import type { Op } from './ops.js';
+export declare const OP_CHAIN_DOMAIN = "blueprint-ops-chain";
+export declare const OP_CHAIN_VERSION = "v1";
+export declare const OP_CHAIN_GENESIS = "b369ef2317f5bd6bd22ddd3ebce94632849a553fa19d0b756a23745546627639";
+export type ChainedOp = Op & {
+    prevHash: string;
+};
+export declare function isChainedOp(op: Op): op is ChainedOp;
+export declare function canonicalJson(value: unknown): string;
+export declare function opChainPreimage(op: ChainedOp): string;
+export type ChainBreakOpPayload = {
+    firstBrokenSeq: number;
+    opsAfterBreak: number;
+    reason: 'prev-hash-mismatch' | 'prev-hash-missing';
+    chainStartSeq?: number;
+    unattributedThroughSeq?: number;
+};
+//# sourceMappingURL=op-chain.d.ts.map

package/build/esm/op-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"op-chain.d.ts","sourceRoot":"","sources":["../../src/op-chain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAEnC,eAAO,MAAM,eAAe,wBAAwB,CAAC;AAErD,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC,eAAO,MAAM,gBAAgB,qEACuC,CAAC;AAErE,MAAM,MAAM,SAAS,GAAG,EAAE,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAElD,wBAAgB,WAAW,CAAE,EAAE,EAAE,EAAE,GAAI,EAAE,IAAI,SAAS,CAErD;AAED,wBAAgB,aAAa,CAAE,KAAK,EAAE,OAAO,GAAI,MAAM,CAEtD;AAWD,wBAAgB,eAAe,CAAE,EAAE,EAAE,SAAS,GAAI,MAAM,CAcvD;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,oBAAoB,GAAG,mBAAmB,CAAC;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,CAAC"}

package/build/esm/op-chain.js

@@ -0,0 +1,36 @@
+export const OP_CHAIN_DOMAIN = 'blueprint-ops-chain';
+export const OP_CHAIN_VERSION = 'v1';
+export const OP_CHAIN_GENESIS = 'b369ef2317f5bd6bd22ddd3ebce94632849a553fa19d0b756a23745546627639';
+export function isChainedOp(op) {
+    return typeof op.prevHash === 'string' && op.prevHash.length > 0;
+}
+export function canonicalJson(value) {
+    return JSON.stringify(sortDeep(value));
+}
+function sortDeep(value) {
+    if (Array.isArray(value))
+        return value.map(sortDeep);
+    if (value === null || typeof value !== 'object')
+        return value;
+    const source = value;
+    const sorted = {};
+    for (const key of Object.keys(source).sort())
+        sorted[key] = sortDeep(source[key]);
+    return sorted;
+}
+export function opChainPreimage(op) {
+    return [
+        OP_CHAIN_DOMAIN,
+        OP_CHAIN_VERSION,
+        op.prevHash,
+        String(op.seq),
+        op.ts,
+        op.author,
+        op.class,
+        op.verb,
+        op.writerSha,
+        op.writerId,
+        canonicalJson(op.payload)
+    ].join('\0');
+}
+//# sourceMappingURL=op-chain.js.map

package/build/esm/op-chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"op-chain.js","sourceRoot":"","sources":["../../src/op-chain.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAG,qBAAqB,CAAC;AAErD,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAErC,MAAM,CAAC,MAAM,gBAAgB,GAC3B,kEAAkE,CAAC;AAIrE,MAAM,UAAU,WAAW,CAAE,EAAM;IACjC,OAAO,OAAO,EAAE,CAAC,QAAQ,KAAK,QAAQ,IAAI,EAAE,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,aAAa,CAAE,KAAc;IAC3C,OAAO,IAAI,CAAC,SAAS,CAAE,QAAQ,CAAE,KAAK,CAAE,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,QAAQ,CAAE,KAAc;IAC/B,IAAK,KAAK,CAAC,OAAO,CAAE,KAAK,CAAE;QAAE,OAAO,KAAK,CAAC,GAAG,CAAE,QAAQ,CAAE,CAAC;IAC1D,IAAK,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAG,OAAO,KAAK,CAAC;IAChE,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAM,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAE,MAAM,CAAE,CAAC,IAAI,EAAE;QAAE,MAAM,CAAE,GAAG,CAAE,GAAG,QAAQ,CAAE,MAAM,CAAE,GAAG,CAAE,CAAC,CAAC;IAC1F,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,eAAe,CAAE,EAAa;IAC5C,OAAO;QACL,eAAe;QACf,gBAAgB;QAChB,EAAE,CAAC,QAAQ;QACX,MAAM,CAAE,EAAE,CAAC,GAAG,CAAE;QAChB,EAAE,CAAC,EAAE;QACL,EAAE,CAAC,MAAM;QACT,EAAE,CAAC,KAAK;QACR,EAAE,CAAC,IAAI;QACP,EAAE,CAAC,SAAS;QACZ,EAAE,CAAC,QAAQ;QACX,aAAa,CAAE,EAAE,CAAC,OAAO,CAAE;KAC5B,CAAC,IAAI,CAAE,IAAI,CAAE,CAAC;AACjB,CAAC"}