@bett3r-dev/blueprint-schema 1.6.0

package/build/esm/design.js

@@ -0,0 +1,43 @@
+export const BLUEPRINT_DESIGN_FILENAME = 'design.json';
+export const MODIFIABLE_NODE_FIELDS = [
+    'label',
+    'subdomain',
+    'resourceKey',
+    'queries'
+];
+const MENTION_TOKEN = /@([A-Za-z0-9._-]+)/g;
+export const resolveMentions = (text, directory) => {
+    const ids = [];
+    for (const match of text.matchAll(MENTION_TOKEN)) {
+        const typed = match[1]?.toLowerCase();
+        const member = directory.find((entry) => entry.name.toLowerCase() === typed);
+        if (member && !ids.includes(member.id))
+            ids.push(member.id);
+    }
+    return ids;
+};
+export function isEdgeRefAnchor(anchor) {
+    if (anchor === null || typeof anchor !== 'object')
+        return false;
+    const ref = anchor;
+    return typeof ref.from === 'string' && typeof ref.to === 'string' && typeof ref.kind === 'string';
+}
+export function isCommentIdAnchor(anchor) {
+    if (anchor === null || typeof anchor !== 'object')
+        return false;
+    const ref = anchor;
+    return typeof ref.commentId === 'string';
+}
+export function commentAnchorKey(anchor) {
+    if (anchor === null || anchor === undefined)
+        return 'design';
+    if (typeof anchor === 'string')
+        return `node:${anchor}`;
+    if (isCommentIdAnchor(anchor))
+        return `comment:${anchor.commentId}`;
+    return `edge:${anchor.from}|${anchor.to}|${anchor.kind}`;
+}
+export function emptyDesign() {
+    return { schemaVersion: 1 };
+}
+//# sourceMappingURL=design.js.map

package/build/esm/design.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"design.js","sourceRoot":"","sources":["../../src/design.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,yBAAyB,GAAG,aAAa,CAAC;AA+BvD,MAAM,CAAC,MAAM,sBAAsB,GAA8C;IAC/E,OAAO;IACP,WAAW;IACX,aAAa;IACb,SAAS;CACD,CAAC;AAqCX,MAAM,aAAa,GAAG,qBAAqB,CAAC;AAE5C,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,IAAY,EACZ,SAA+B,EACrB,EAAE;IACZ,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAM,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAE,aAAa,CAAE,EAAG,CAAC;QACrD,MAAM,KAAK,GAAG,KAAK,CAAE,CAAC,CAAE,EAAE,WAAW,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAE,CAAE,KAAK,EAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,KAAK,CAAE,CAAC;QACjF,IAAK,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAE,MAAM,CAAC,EAAE,CAAE;YAAG,GAAG,CAAC,IAAI,CAAE,MAAM,CAAC,EAAE,CAAE,CAAC;IACpE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAOF,MAAM,UAAU,eAAe,CAAE,MAAe;IAC9C,IAAK,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAG,OAAO,KAAK,CAAC;IAClE,MAAM,GAAG,GAAG,MAA0B,CAAC;IACvC,OAAO,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC;AACpG,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAE,MAAe;IAChD,IAAK,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAG,OAAO,KAAK,CAAC;IAClE,MAAM,GAAG,GAAG,MAA+B,CAAC;IAC5C,OAAO,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAE,MAAqB;IACrD,IAAK,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS;QAAG,OAAO,QAAQ,CAAC;IAC/D,IAAK,OAAO,MAAM,KAAK,QAAQ;QAAG,OAAO,QAAS,MAAO,EAAE,CAAC;IAC5D,IAAK,iBAAiB,CAAE,MAAM,CAAE;QAAE,OAAO,WAAY,MAAM,CAAC,SAAU,EAAE,CAAC;IACzE,OAAO,QAAS,MAAM,CAAC,IAAK,IAAK,MAAM,CAAC,EAAG,IAAK,MAAM,CAAC,IAAK,EAAE,CAAC;AACjE,CAAC;AAgBD,MAAM,UAAU,WAAW;IACzB,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;AAC9B,CAAC"}

package/build/esm/diagnostics.d.ts

@@ -0,0 +1,74 @@
+import { EdgeKind } from './edges.js';
+import { NodeType } from './nodes.js';
+export type UnresolvedEdgeDirection = 'source' | 'target';
+export type UnresolvedEdge = {
+    anchorId: string;
+    direction: UnresolvedEdgeDirection;
+    kind: EdgeKind;
+    targetName: string;
+    file: string;
+    line: number;
+};
+export type DynamicNameSite = {
+    kind: EdgeKind;
+    expression: string;
+    file: string;
+    line: number;
+};
+export type NameCollision = {
+    name: string;
+    type: NodeType;
+    sites: Array<{
+        file: string;
+        line: number;
+    }>;
+};
+export type LeafResourceLabelCollision = {
+    label: string;
+    type: NodeType;
+    subdomain: string;
+    sites: Array<{
+        id: string;
+        resourceKey: string | undefined;
+        file: string;
+        line: number;
+    }>;
+};
+export type OrphanNode = {
+    id: string;
+    type: NodeType;
+};
+export type OpaqueAccessSite = {
+    artifactId: string;
+    kind: NodeType;
+    file: string;
+    line: number;
+};
+export type HandlerScopeIssue = 'unresolved' | 'wrong-type' | 'unconnected';
+export type TopologyViolation = {
+    from: string;
+    to: string;
+    kind: EdgeKind;
+    fromType: NodeType;
+    toType: NodeType;
+    handlerId?: string;
+    handlerIssue?: HandlerScopeIssue;
+};
+export type StaleOverride = {
+    category: 'add-edge' | 'add-edge-handler' | 'patch-node' | 'suppress-node' | 'suppress-edge' | 'suppress-unresolved-edge';
+    description: string;
+    missingRef: string;
+    note?: string;
+};
+export type Diagnostics = {
+    unresolvedEdges: UnresolvedEdge[];
+    dynamicNameSites: DynamicNameSite[];
+    nameCollisions: NameCollision[];
+    leafResourceLabelCollisions: LeafResourceLabelCollision[];
+    orphanNodes: OrphanNode[];
+    topologyViolations: TopologyViolation[];
+    staleOverrides: StaleOverride[];
+    opaqueAccessSites: OpaqueAccessSite[];
+};
+export declare function emptyDiagnostics(): Diagnostics;
+//# sourceMappingURL=diagnostics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,MAAM,MAAM,uBAAuB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE1D,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,uBAAuB,CAAC;IACnC,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;QAChC,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;CACJ,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,YAAY,GAAG,aAAa,CAAC;AAE5E,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,QAAQ,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,iBAAiB,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EACJ,UAAU,GACV,kBAAkB,GAClB,YAAY,GACZ,eAAe,GACf,eAAe,GACf,0BAA0B,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,2BAA2B,EAAE,0BAA0B,EAAE,CAAC;IAC1D,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,kBAAkB,EAAE,iBAAiB,EAAE,CAAC;IACxC,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;CACvC,CAAC;AAEF,wBAAgB,gBAAgB,IAAI,WAAW,CAW9C"}

package/build/esm/diagnostics.js

@@ -0,0 +1,13 @@
+export function emptyDiagnostics() {
+    return {
+        unresolvedEdges: [],
+        dynamicNameSites: [],
+        nameCollisions: [],
+        leafResourceLabelCollisions: [],
+        orphanNodes: [],
+        topologyViolations: [],
+        staleOverrides: [],
+        opaqueAccessSites: []
+    };
+}
+//# sourceMappingURL=diagnostics.js.map

package/build/esm/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/diagnostics.ts"],"names":[],"mappings":"AAuFA,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,eAAe,EAAE,EAAE;QACnB,gBAAgB,EAAE,EAAE;QACpB,cAAc,EAAE,EAAE;QAClB,2BAA2B,EAAE,EAAE;QAC/B,WAAW,EAAE,EAAE;QACf,kBAAkB,EAAE,EAAE;QACtB,cAAc,EAAE,EAAE;QAClB,iBAAiB,EAAE,EAAE;KACtB,CAAC;AACJ,CAAC"}

package/build/esm/edges.d.ts

@@ -0,0 +1,17 @@
+import { DesignStatus, Origin } from './nodes.js';
+export type EdgeKind = 'handled-by' | 'produces' | 'emits' | 'triggers' | 'issues' | 'projected-to' | 'reads-from' | 'transactionally-writes-to' | 'writes-to' | 'calls' | 'uses-cache' | 'causes' | 'invokes' | 'subscribes-to';
+export declare const EDGE_KINDS: readonly EdgeKind[];
+export type EdgeKindSource = 'chosen' | 'guessed';
+export declare const EDGE_KIND_SOURCES: readonly EdgeKindSource[];
+export type BlueprintEdge = {
+    from: string;
+    to: string;
+    kind: EdgeKind;
+    via?: string;
+    origin?: Origin;
+    status?: DesignStatus;
+    kindSource?: EdgeKindSource;
+    note?: string;
+    handlers?: string[];
+};
+//# sourceMappingURL=edges.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"edges.d.ts","sourceRoot":"","sources":["../../src/edges.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,MAAM,QAAQ,GAChB,YAAY,GACZ,UAAU,GACV,OAAO,GACP,UAAU,GACV,QAAQ,GACR,cAAc,GACd,YAAY,GACZ,2BAA2B,GAC3B,WAAW,GACX,OAAO,GACP,YAAY,GACZ,QAAQ,GACR,SAAS,GACT,eAAe,CAAC;AAEpB,eAAO,MAAM,UAAU,EAAE,SAAS,QAAQ,EAehC,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,SAAS,CAAC;AAElD,eAAO,MAAM,iBAAiB,EAAE,SAAS,cAAc,EAAqC,CAAC;AAE7F,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC"}

package/build/esm/edges.js

@@ -0,0 +1,18 @@
+export const EDGE_KINDS = [
+    'handled-by',
+    'produces',
+    'emits',
+    'triggers',
+    'issues',
+    'projected-to',
+    'reads-from',
+    'transactionally-writes-to',
+    'writes-to',
+    'calls',
+    'uses-cache',
+    'causes',
+    'invokes',
+    'subscribes-to'
+];
+export const EDGE_KIND_SOURCES = ['chosen', 'guessed'];
+//# sourceMappingURL=edges.js.map

package/build/esm/edges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edges.js","sourceRoot":"","sources":["../../src/edges.ts"],"names":[],"mappings":"AAkBA,MAAM,CAAC,MAAM,UAAU,GAAwB;IAC7C,YAAY;IACZ,UAAU;IACV,OAAO;IACP,UAAU;IACV,QAAQ;IACR,cAAc;IACd,YAAY;IACZ,2BAA2B;IAC3B,WAAW;IACX,OAAO;IACP,YAAY;IACZ,QAAQ;IACR,SAAS;IACT,eAAe;CACP,CAAC;AAIX,MAAM,CAAC,MAAM,iBAAiB,GAA8B,CAAE,QAAQ,EAAE,SAAS,CAAW,CAAC"}

package/build/esm/entry-points.d.ts

@@ -0,0 +1,17 @@
+import { BlueprintGraph } from './graph.js';
+import { BlueprintNode } from './nodes.js';
+export type EntryPointIndex = {
+    entryPoints: ReadonlySet<string>;
+    crossSubdomainEntryPoints: ReadonlySet<string>;
+};
+export type EntryPointFlags = {
+    isEntryPoint: boolean;
+    isCrossSubdomainEntryPoint: boolean;
+};
+export type PromotionOptions = {
+    showInboundTriggers?: boolean;
+};
+export declare const buildEntryPointIndex: (graph: BlueprintGraph, nodesById?: ReadonlyMap<string, BlueprintNode>) => EntryPointIndex;
+export declare const isPromotableEntryPoint: (flags: EntryPointFlags, options?: PromotionOptions) => boolean;
+export declare const isPromotableId: (id: string, index: EntryPointIndex, options?: PromotionOptions) => boolean;
+//# sourceMappingURL=entry-points.d.ts.map

package/build/esm/entry-points.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-points.d.ts","sourceRoot":"","sources":["../../src/entry-points.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,MAAM,eAAe,GAAG;IAC5B,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC,yBAAyB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,YAAY,EAAE,OAAO,CAAC;IACtB,0BAA0B,EAAE,OAAO,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,OAAO,cAAc,EACrB,YAAW,WAAW,CAAC,MAAM,EAAE,aAAa,CAE3C,KACA,eA0CF,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,OAAO,eAAe,EACtB,UAAS,gBAAqB,KAC7B,OAE2E,CAAC;AAE/E,eAAO,MAAM,cAAc,GACzB,IAAI,MAAM,EACV,OAAO,eAAe,EACtB,UAAS,gBAAqB,KAC7B,OAOA,CAAC"}

package/build/esm/entry-points.js

@@ -0,0 +1,52 @@
+export const buildEntryPointIndex = (graph, nodesById = new Map(graph.nodes.map((node) => [node.id, node]))) => {
+    const issuedTargets = new Set();
+    const uiInvokedTargets = new Set();
+    const policyTriggerSubdomains = new Map();
+    for (const edge of graph.edges) {
+        if (edge.kind === 'issues')
+            issuedTargets.add(edge.to);
+        if (edge.kind === 'invokes')
+            uiInvokedTargets.add(edge.to);
+        if (edge.kind === 'triggers') {
+            const evtNode = nodesById.get(edge.from);
+            if (evtNode) {
+                const subs = policyTriggerSubdomains.get(edge.to) ?? new Set();
+                subs.add(evtNode.subdomain);
+                policyTriggerSubdomains.set(edge.to, subs);
+            }
+        }
+    }
+    const crossSubdomainEntryPoints = new Set();
+    for (const edge of graph.edges) {
+        if (edge.kind !== 'issues')
+            continue;
+        const commandNode = nodesById.get(edge.to);
+        if (!commandNode)
+            continue;
+        const triggerSubdomains = policyTriggerSubdomains.get(edge.from);
+        if (!triggerSubdomains)
+            continue;
+        for (const sub of triggerSubdomains) {
+            if (sub !== commandNode.subdomain) {
+                crossSubdomainEntryPoints.add(edge.to);
+                break;
+            }
+        }
+    }
+    const entryPoints = new Set();
+    for (const node of graph.nodes) {
+        if (node.type !== 'command')
+            continue;
+        if (!issuedTargets.has(node.id) || uiInvokedTargets.has(node.id)) {
+            entryPoints.add(node.id);
+        }
+    }
+    return { entryPoints, crossSubdomainEntryPoints };
+};
+export const isPromotableEntryPoint = (flags, options = {}) => flags.isEntryPoint ||
+    (options.showInboundTriggers === true && flags.isCrossSubdomainEntryPoint);
+export const isPromotableId = (id, index, options = {}) => isPromotableEntryPoint({
+    isEntryPoint: index.entryPoints.has(id),
+    isCrossSubdomainEntryPoint: index.crossSubdomainEntryPoints.has(id)
+}, options);
+//# sourceMappingURL=entry-points.js.map

package/build/esm/entry-points.js.map

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

package/build/esm/find-orphan-nodes.d.ts

@@ -0,0 +1,5 @@
+import { BlueprintEdge } from './edges.js';
+import { BlueprintNode } from './nodes.js';
+import { OrphanNode } from './diagnostics.js';
+export declare function findOrphanNodes(nodes: BlueprintNode[], edges: BlueprintEdge[]): OrphanNode[];
+//# sourceMappingURL=find-orphan-nodes.d.ts.map

package/build/esm/find-orphan-nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-orphan-nodes.d.ts","sourceRoot":"","sources":["../../src/find-orphan-nodes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,wBAAgB,eAAe,CAAE,KAAK,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,GAAI,UAAU,EAAE,CAU9F"}

package/build/esm/find-orphan-nodes.js

@@ -0,0 +1,11 @@
+export function findOrphanNodes(nodes, edges) {
+    const incident = new Set();
+    for (const edge of edges) {
+        incident.add(edge.from);
+        incident.add(edge.to);
+    }
+    return nodes
+        .filter(node => !incident.has(node.id))
+        .map(node => ({ id: node.id, type: node.type }));
+}
+//# sourceMappingURL=find-orphan-nodes.js.map

package/build/esm/find-orphan-nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-orphan-nodes.js","sourceRoot":"","sources":["../../src/find-orphan-nodes.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,eAAe,CAAE,KAAsB,EAAE,KAAsB;IAC7E,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,KAAM,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,QAAQ,CAAC,GAAG,CAAE,IAAI,CAAC,IAAI,CAAE,CAAC;QAC1B,QAAQ,CAAC,GAAG,CAAE,IAAI,CAAC,EAAE,CAAE,CAAC;IAC1B,CAAC;IAED,OAAO,KAAK;SACT,MAAM,CAAE,IAAI,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAE,IAAI,CAAC,EAAE,CAAE,CAAC;SACzC,GAAG,CAAE,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACtD,CAAC"}

package/build/esm/flow-traversal.d.ts

@@ -0,0 +1,24 @@
+import { EdgeKind, BlueprintEdge } from './edges.js';
+import { BlueprintGraph } from './graph.js';
+import { BlueprintNode } from './nodes.js';
+export declare const TRAVERSABLE_KINDS: ReadonlySet<EdgeKind>;
+export type CrossSubdomainMode = 'full' | 'leaf' | 'exclude';
+export type ScopedDataEdge = {
+    to: string;
+    artifact: string;
+};
+export type FlowIndex = {
+    nodesById: ReadonlyMap<string, BlueprintNode>;
+    outgoing: ReadonlyMap<string, readonly string[]>;
+    scopedByHandler: ReadonlyMap<string, readonly ScopedDataEdge[]>;
+};
+export type FlowTraversalSpec = {
+    rootId: string;
+    homeSubdomain?: string;
+    homeSubdomains?: readonly string[];
+    crossSubdomainMode?: CrossSubdomainMode;
+};
+export declare function buildFlowIndex(graph: BlueprintGraph): FlowIndex;
+export declare function traverseFlow(index: FlowIndex, spec: FlowTraversalSpec): ReadonlyMap<string, number>;
+export declare function isEdgeInFlow(edge: Pick<BlueprintEdge, 'from' | 'to' | 'handlers'>, depth: ReadonlyMap<string, number>): boolean;
+//# sourceMappingURL=flow-traversal.d.ts.map

package/build/esm/flow-traversal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-traversal.d.ts","sourceRoot":"","sources":["../../src/flow-traversal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,QAAQ,CAWjD,CAAC;AAEJ,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAE7D,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC9C,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IACjD,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC,CAAC;CACjE,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACzC,CAAC;AAEF,wBAAgB,cAAc,CAAE,KAAK,EAAE,cAAc,GAAI,SAAS,CAiCjE;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,iBAAiB,GACtB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAkD7B;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,UAAU,CAAC,EACrD,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,OAAO,CAIT"}

package/build/esm/flow-traversal.js

@@ -0,0 +1,96 @@
+export const TRAVERSABLE_KINDS = new Set([
+    'handled-by',
+    'produces',
+    'triggers',
+    'causes',
+    'projected-to',
+    'reads-from',
+    'transactionally-writes-to',
+    'writes-to',
+    'calls',
+    'uses-cache'
+]);
+export function buildFlowIndex(graph) {
+    const nodesById = new Map();
+    for (const node of graph.nodes) {
+        nodesById.set(node.id, node);
+    }
+    const outgoing = new Map();
+    const scopedByHandler = new Map();
+    for (const edge of graph.edges) {
+        if (!TRAVERSABLE_KINDS.has(edge.kind))
+            continue;
+        if (edge.handlers !== undefined && edge.handlers.length > 0) {
+            for (const handlerId of edge.handlers) {
+                const scoped = scopedByHandler.get(handlerId);
+                const entry = { to: edge.to, artifact: edge.from };
+                if (scoped) {
+                    scoped.push(entry);
+                }
+                else {
+                    scopedByHandler.set(handlerId, [entry]);
+                }
+            }
+            continue;
+        }
+        const list = outgoing.get(edge.from);
+        if (list) {
+            list.push(edge.to);
+        }
+        else {
+            outgoing.set(edge.from, [edge.to]);
+        }
+    }
+    return { nodesById, outgoing, scopedByHandler };
+}
+export function traverseFlow(index, spec) {
+    const crossSubdomainMode = spec.crossSubdomainMode ?? 'full';
+    const { nodesById, outgoing, scopedByHandler } = index;
+    const home = spec.homeSubdomains !== undefined
+        ? new Set(spec.homeSubdomains)
+        : spec.homeSubdomain !== undefined ? new Set([spec.homeSubdomain]) : undefined;
+    const isForeign = (id) => {
+        if (home === undefined)
+            return false;
+        const subdomain = nodesById.get(id)?.subdomain;
+        return subdomain === undefined || !home.has(subdomain);
+    };
+    const depth = new Map();
+    const queue = [{ id: spec.rootId, depth: 0 }];
+    depth.set(spec.rootId, 0);
+    const visit = (target, row) => {
+        if (!nodesById.has(target) || depth.has(target))
+            return;
+        if (crossSubdomainMode === 'exclude' && isForeign(target)) {
+            return;
+        }
+        depth.set(target, row);
+        queue.push({ id: target, depth: row });
+    };
+    while (queue.length > 0) {
+        const current = queue.shift();
+        if (crossSubdomainMode === 'leaf' && isForeign(current.id)) {
+            continue;
+        }
+        for (const target of outgoing.get(current.id) ?? []) {
+            visit(target, current.depth + 1);
+        }
+        for (const scoped of scopedByHandler.get(current.id) ?? []) {
+            const artifactDepth = depth.get(scoped.artifact);
+            if (artifactDepth === undefined)
+                continue;
+            if (crossSubdomainMode === 'leaf' && isForeign(scoped.artifact))
+                continue;
+            visit(scoped.to, artifactDepth + 1);
+        }
+    }
+    return depth;
+}
+export function isEdgeInFlow(edge, depth) {
+    if (!depth.has(edge.from) || !depth.has(edge.to))
+        return false;
+    if (edge.handlers === undefined || edge.handlers.length === 0)
+        return true;
+    return edge.handlers.some(handlerId => depth.has(handlerId));
+}
+//# sourceMappingURL=flow-traversal.js.map

package/build/esm/flow-traversal.js.map

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

package/build/esm/graph.d.ts

@@ -0,0 +1,19 @@
+import { BlueprintEdge } from './edges.js';
+import { BlueprintNode, NodeType } from './nodes.js';
+export type SchemaVersion = 1;
+export type BlueprintGraph = {
+    schemaVersion: SchemaVersion;
+    subdomains: string[];
+    nodes: BlueprintNode[];
+    edges: BlueprintEdge[];
+};
+export declare function emptyGraph(): BlueprintGraph;
+export declare function slugify(label: string): string;
+export declare function nodeId(subdomain: string, type: NodeType, label: string): string;
+export type ParsedNodeId = {
+    subdomain: string;
+    type: NodeType;
+    slug: string;
+};
+export declare function parseNodeId(id: string): ParsedNodeId | undefined;
+//# sourceMappingURL=graph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/graph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAoC,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEvF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC;AAE9B,MAAM,MAAM,cAAc,GAAG;IAC3B,aAAa,EAAE,aAAa,CAAC;IAC7B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB,CAAC;AAEF,wBAAgB,UAAU,IAAI,cAAc,CAE3C;AAED,wBAAgB,OAAO,CAAE,KAAK,EAAE,MAAM,GAAI,MAAM,CAO/C;AAED,wBAAgB,MAAM,CAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAI,MAAM,CAEjF;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,wBAAgB,WAAW,CAAE,EAAE,EAAE,MAAM,GAAI,YAAY,GAAG,SAAS,CAOlE"}

package/build/esm/graph.js

@@ -0,0 +1,26 @@
+import { NODE_ABBREV, NODE_TYPE_BY_ABBREV } from './nodes.js';
+export function emptyGraph() {
+    return { schemaVersion: 1, subdomains: [], nodes: [], edges: [] };
+}
+export function slugify(label) {
+    return label
+        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+        .replace(/([A-Z]+)([A-Z][a-z])/g, '$1-$2')
+        .replace(/[^a-zA-Z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .toLowerCase();
+}
+export function nodeId(subdomain, type, label) {
+    return `${slugify(subdomain)}_${NODE_ABBREV[type]}_${slugify(label)}`;
+}
+export function parseNodeId(id) {
+    const segments = id.split('_');
+    if (segments.length !== 3)
+        return undefined;
+    const [subdomain, abbrev, slug] = segments;
+    const type = NODE_TYPE_BY_ABBREV[abbrev];
+    if (type === undefined || subdomain.length === 0 || slug.length === 0)
+        return undefined;
+    return { subdomain, type, slug };
+}
+//# sourceMappingURL=graph.js.map

package/build/esm/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../src/graph.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,WAAW,EAAE,mBAAmB,EAAY,MAAM,YAAY,CAAC;AAWvF,MAAM,UAAU,UAAU;IACxB,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,OAAO,CAAE,KAAa;IACpC,OAAO,KAAK;SACT,OAAO,CAAE,oBAAoB,EAAE,OAAO,CAAE;SACxC,OAAO,CAAE,uBAAuB,EAAE,OAAO,CAAE;SAC3C,OAAO,CAAE,gBAAgB,EAAE,GAAG,CAAE;SAChC,OAAO,CAAE,UAAU,EAAE,EAAE,CAAE;SACzB,WAAW,EAAE,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,MAAM,CAAE,SAAiB,EAAE,IAAc,EAAE,KAAa;IACtE,OAAO,GAAI,OAAO,CAAE,SAAS,CAAG,IAAK,WAAW,CAAE,IAAI,CAAG,IAAK,OAAO,CAAE,KAAK,CAAG,EAAE,CAAC;AACpF,CAAC;AAQD,MAAM,UAAU,WAAW,CAAE,EAAU;IACrC,MAAM,QAAQ,GAAG,EAAE,CAAC,KAAK,CAAE,GAAG,CAAE,CAAC;IACjC,IAAK,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAG,OAAO,SAAS,CAAC;IAC9C,MAAM,CAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAE,GAAG,QAAQ,CAAC;IAC7C,MAAM,IAAI,GAAG,mBAAmB,CAAE,MAAM,CAAE,CAAC;IAC3C,IAAK,IAAI,KAAK,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAG,OAAO,SAAS,CAAC;IAC1F,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACnC,CAAC"}

package/build/esm/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/esm/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/esm/handler-scope.js

@@ -0,0 +1,49 @@
+export const 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}`;
+export 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 };
+}
+export 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 : 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/esm/handler-scope.js.map

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

package/build/esm/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/esm/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"}