@bett3r-dev/blueprint-schema 1.6.0

package/build/cjs/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/cjs/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/cjs/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/cjs/nodes.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NODE_TYPE_BY_ABBREV = exports.NODE_ABBREV = exports.NODE_TYPES = void 0;
+exports.NODE_TYPES = [
+    'aggregate',
+    'system',
+    'command',
+    'event',
+    'policy',
+    'read-model',
+    'external-system',
+    'datastore',
+    'cache',
+    'ui',
+    'postgres-view'
+];
+exports.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'
+};
+exports.NODE_TYPE_BY_ABBREV = Object.fromEntries(exports.NODE_TYPES.map(type => [exports.NODE_ABBREV[type], type]));
+//# sourceMappingURL=nodes.js.map

package/build/cjs/nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodes.js","sourceRoot":"","sources":["../../src/nodes.ts"],"names":[],"mappings":";;;AA8Ba,QAAA,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;AAEE,QAAA,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;AAEW,QAAA,mBAAmB,GAAuC,MAAM,CAAC,WAAW,CACvF,kBAAU,CAAC,GAAG,CAAE,IAAI,CAAC,EAAE,CAAC,CAAE,mBAAW,CAAE,IAAI,CAAE,EAAE,IAAI,CAAE,CAAE,CACxD,CAAC"}

package/build/cjs/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/cjs/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/cjs/op-chain.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OP_CHAIN_GENESIS = exports.OP_CHAIN_VERSION = exports.OP_CHAIN_DOMAIN = void 0;
+exports.isChainedOp = isChainedOp;
+exports.canonicalJson = canonicalJson;
+exports.opChainPreimage = opChainPreimage;
+exports.OP_CHAIN_DOMAIN = 'blueprint-ops-chain';
+exports.OP_CHAIN_VERSION = 'v1';
+exports.OP_CHAIN_GENESIS = 'b369ef2317f5bd6bd22ddd3ebce94632849a553fa19d0b756a23745546627639';
+function isChainedOp(op) {
+    return typeof op.prevHash === 'string' && op.prevHash.length > 0;
+}
+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;
+}
+function opChainPreimage(op) {
+    return [
+        exports.OP_CHAIN_DOMAIN,
+        exports.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/cjs/op-chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"op-chain.js","sourceRoot":"","sources":["../../src/op-chain.ts"],"names":[],"mappings":";;;AAWA,kCAEC;AAED,sCAEC;AAWD,0CAcC;AAxCY,QAAA,eAAe,GAAG,qBAAqB,CAAC;AAExC,QAAA,gBAAgB,GAAG,IAAI,CAAC;AAExB,QAAA,gBAAgB,GAC3B,kEAAkE,CAAC;AAIrE,SAAgB,WAAW,CAAE,EAAM;IACjC,OAAO,OAAO,EAAE,CAAC,QAAQ,KAAK,QAAQ,IAAI,EAAE,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;AACnE,CAAC;AAED,SAAgB,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,SAAgB,eAAe,CAAE,EAAa;IAC5C,OAAO;QACL,uBAAe;QACf,wBAAgB;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"}

package/build/cjs/ops.d.ts

@@ -0,0 +1,158 @@
+import { HandlerScopeIssue } from './diagnostics.js';
+import { StrandingReport } from './reachability.js';
+import { VerbSubject } from './reality-check.js';
+import { DesignAuthor, DesignStatus } from './nodes.js';
+import type { MapEntryId, MapForkStatus, MapLink, MapWithdrawal } from './map-structure.js';
+import { DesignComment, ModifyEntry, ProposedEdge, ProposedNode, RemoveEntry, ResolveEntry } from './design.js';
+export type OpsSchemaVersion = 1;
+export declare const BLUEPRINT_OPS_FILENAME = "ops.jsonl";
+export type OpClass = 'semantic' | 'layout' | 'operational';
+export type OpVerb = 'propose' | 'modify' | 'remove' | 'comment' | 'resolve' | 'reclassify' | 'position' | 'lock-takeover' | 'anchor-attach' | 'anchor-detach' | 'session-freeze' | 'session-reopen' | 'pr-link' | 'pr-merged' | 'pr-closed' | 'undo' | 'map-ground' | 'map-post' | 'map-strike' | 'map-choose' | 'map-link' | 'map-unlink';
+export type MapOpVerb = Extract<OpVerb, `map-${string}`>;
+export type StrandingOpDiagnostic = {
+    strandedProposals?: StrandingReport;
+};
+export type ProposeOpPayload = StrandingOpDiagnostic & {
+    nodes: ProposedNode[];
+    edges: ProposedEdge[];
+};
+export type ModifyOpPayload = {
+    entries: ModifyEntry[];
+};
+export type RemoveOpPayload = StrandingOpDiagnostic & {
+    entries: RemoveEntry[];
+};
+export type CommentOpPayload = {
+    entries: DesignComment[];
+};
+export type ResolveOpPayload = {
+    entries: ResolveEntry[];
+};
+export type OperationalOpVerb = 'reality-moved' | 'scope' | 'chain-break';
+export type ScopeOpPayload = {
+    saved: Array<{
+        name: string;
+        subdomains: string[];
+        text: string;
+        all?: boolean;
+        design?: {
+            authors: readonly DesignAuthor[];
+            statuses: readonly DesignStatus[];
+        };
+    }>;
+    removed: string[];
+};
+export type RealityMovedOpPayload = {
+    note: string;
+    satisfied: number;
+    stale: number;
+    staleVerbs: Array<{
+        path: string;
+        reason: string;
+        subject?: VerbSubject;
+    }>;
+    degraded?: number;
+    degradedScopes?: Array<{
+        path: string;
+        handlerId: string;
+        issue: HandlerScopeIssue;
+    }>;
+};
+export type LockTakeoverOpPayload = {
+    pid: number;
+    writerId: string;
+    heldForMs: number;
+    reason: 'holder-dead' | 'stale';
+};
+export type AnchorAttachOpPayload = {
+    sessionId: string;
+    realityProvider: string;
+    realitySha: string;
+    realityAt: string;
+    repoPath: string;
+    previousProvider?: string;
+    previousRealitySha?: string;
+};
+export type AnchorDetachObservation = 'recorded' | 'inferred';
+export type AnchorDetachOpPayload = {
+    sessionId: string;
+    realityProvider: string;
+    reason: string;
+    detachedAt: string;
+    observed: AnchorDetachObservation;
+};
+export type SessionReopenOpPayload = {
+    actor: string;
+    reason: string;
+};
+export type PullRequestProvider = 'github' | 'stub';
+export type PrLinkOpPayload = {
+    ref: string;
+    provider: PullRequestProvider;
+    url: string;
+    actor: string;
+};
+export type PrMergedOpPayload = {
+    ref: string;
+    mergeCommitSha: string;
+    mergedAt: string;
+};
+export type PrClosedOpPayload = {
+    ref: string;
+};
+export declare const UNDOABLE_OP_VERBS: readonly ["propose", "modify", "remove", "comment", "map-post", "map-choose", "map-link", "map-unlink"];
+export type UndoableOpVerb = (typeof UNDOABLE_OP_VERBS)[number];
+export type UndoFold = 'design' | 'map';
+export type DesignUndoableOpVerb = Exclude<UndoableOpVerb, MapUndoableOpVerb>;
+export type MapUndoableOpVerb = 'map-post' | 'map-choose' | 'map-link' | 'map-unlink';
+export declare function isUndoableOpVerb(verb: unknown): verb is UndoableOpVerb;
+export type UndoWithdrawal = {
+    nodes?: ProposedNode[];
+    edges?: ProposedEdge[];
+    modify?: ModifyEntry[];
+    comments?: DesignComment[];
+    remove?: RemoveEntry[];
+};
+export type DesignUndoOpPayload = {
+    fold?: 'design';
+    undoes: number;
+    undoneVerb: DesignUndoableOpVerb;
+    withdraw: UndoWithdrawal;
+};
+export type MapPostUndoOpPayload = {
+    fold: 'map';
+    undoes: number;
+    undoneVerb: 'map-post';
+    withdraw: MapWithdrawal;
+};
+export type MapChooseUndoOpPayload = {
+    fold: 'map';
+    undoes: number;
+    undoneVerb: 'map-choose';
+    restore: MapStatusRestore;
+};
+export type MapStatusRestore = {
+    id: MapEntryId;
+    status: MapForkStatus;
+};
+export type MapLinkUndoOpPayload = {
+    fold: 'map';
+    undoes: number;
+    undoneVerb: 'map-link' | 'map-unlink';
+    link: MapLink;
+    changed?: false;
+};
+export type MapUndoOpPayload = MapPostUndoOpPayload | MapChooseUndoOpPayload | MapLinkUndoOpPayload;
+export type UndoOpPayload = DesignUndoOpPayload | MapUndoOpPayload;
+export type Op = {
+    seq: number;
+    ts: string;
+    author: DesignAuthor | 'system';
+    class: OpClass;
+    verb: OpVerb | OperationalOpVerb;
+    payload: unknown;
+    writerSha: string;
+    writerId: string;
+    prevHash?: string;
+};
+//# sourceMappingURL=ops.d.ts.map

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

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

package/build/cjs/ops.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UNDOABLE_OP_VERBS = exports.BLUEPRINT_OPS_FILENAME = void 0;
+exports.isUndoableOpVerb = isUndoableOpVerb;
+exports.BLUEPRINT_OPS_FILENAME = 'ops.jsonl';
+exports.UNDOABLE_OP_VERBS = ['propose', 'modify', 'remove', 'comment', 'map-post', 'map-choose', 'map-link', 'map-unlink'];
+function isUndoableOpVerb(verb) {
+    return typeof verb === 'string'
+        && exports.UNDOABLE_OP_VERBS.includes(verb);
+}
+//# sourceMappingURL=ops.js.map

package/build/cjs/ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ops.js","sourceRoot":"","sources":["../../src/ops.ts"],"names":[],"mappings":";;;AA0JA,4CAGC;AA7IY,QAAA,sBAAsB,GAAG,WAAW,CAAC;AAgIrC,QAAA,iBAAiB,GAAG,CAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,CAAW,CAAC;AAU3I,SAAgB,gBAAgB,CAAE,IAAa;IAC7C,OAAO,OAAO,IAAI,KAAK,QAAQ;WACxB,yBAAwC,CAAC,QAAQ,CAAE,IAAI,CAAE,CAAC;AACnE,CAAC"}

package/build/cjs/organisation.d.ts

@@ -0,0 +1,10 @@
+export type OrgId = string;
+export declare const DEFAULT_ORG: OrgId;
+export type OrgScope = {
+    boundOrg: OrgId;
+};
+export declare class UnscopedOrgError extends Error {
+    constructor();
+}
+export declare function orgScope(boundOrg: OrgId): OrgScope;
+//# sourceMappingURL=organisation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"organisation.d.ts","sourceRoot":"","sources":["../../src/organisation.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC;AAE3B,eAAO,MAAM,WAAW,EAAE,KAAkB,CAAC;AAE7C,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,EAAE,KAAK,CAAC;CACjB,CAAC;AAEF,qBAAa,gBAAiB,SAAQ,KAAK;;CAU1C;AAED,wBAAgB,QAAQ,CAAE,QAAQ,EAAE,KAAK,GAAI,QAAQ,CAGpD"}

package/build/cjs/organisation.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnscopedOrgError = exports.DEFAULT_ORG = void 0;
+exports.orgScope = orgScope;
+exports.DEFAULT_ORG = 'personal';
+class UnscopedOrgError extends Error {
+    constructor() {
+        super('refusing an unscoped access: no bound org. An access with no org would read every org in ' +
+            'the store, which is not a broad query but a tenancy failure — and its result is ' +
+            'indistinguishable from a correct one. Bind the org from injected configuration ' +
+            '(DEFAULT_ORG locally; a hosted substrate must supply one and refuse without it).');
+        this.name = 'UnscopedOrgError';
+    }
+}
+exports.UnscopedOrgError = UnscopedOrgError;
+function orgScope(boundOrg) {
+    if (!boundOrg || boundOrg.trim() === '')
+        throw new UnscopedOrgError();
+    return { boundOrg };
+}
+//# sourceMappingURL=organisation.js.map

package/build/cjs/organisation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"organisation.js","sourceRoot":"","sources":["../../src/organisation.ts"],"names":[],"mappings":";;;AAoBA,4BAGC;AArBY,QAAA,WAAW,GAAU,UAAU,CAAC;AAM7C,MAAa,gBAAiB,SAAQ,KAAK;IACzC;QACE,KAAK,CACH,2FAA2F;YAC3F,kFAAkF;YAClF,iFAAiF;YACjF,kFAAkF,CACnF,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAVD,4CAUC;AAED,SAAgB,QAAQ,CAAE,QAAe;IACvC,IAAK,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE;QAAG,MAAM,IAAI,gBAAgB,EAAE,CAAC;IACxE,OAAO,EAAE,QAAQ,EAAE,CAAC;AACtB,CAAC"}

package/build/cjs/overrides.d.ts

@@ -0,0 +1,74 @@
+import { EdgeKind } from './edges.js';
+import { DesignAuthor, NodeType } from './nodes.js';
+export type OverridesSchemaVersion = 1;
+export declare const OVERRIDES_SCHEMA_VERSION = 1;
+export declare const BLUEPRINT_OVERRIDES_FILENAME = ".blueprint.overrides.json";
+export type ManualNode = {
+    id?: string;
+    type: NodeType;
+    label: string;
+    subdomain: string;
+    resourceKey?: string;
+    author?: DesignAuthor;
+    note?: string;
+};
+export type ManualEdge = {
+    from: string;
+    to: string;
+    kind: EdgeKind;
+    author?: DesignAuthor;
+    note?: string;
+    handlers?: string[];
+};
+export type NodePatch = {
+    id: string;
+    set: Partial<{
+        label: string;
+        subdomain: string;
+        resourceKey: string;
+    }>;
+    note?: string;
+};
+export type Suppression = {
+    type: 'node';
+    id: string;
+    note?: string;
+} | {
+    type: 'edge';
+    from: string;
+    to: string;
+    edgeKind: EdgeKind;
+    note?: string;
+} | {
+    type: 'unresolved-edge';
+    anchorId: string;
+    targetName: string;
+    edgeKind: EdgeKind;
+    note?: string;
+};
+export type BlueprintOverrides = {
+    schemaVersion: OverridesSchemaVersion;
+    add?: {
+        nodes?: ManualNode[];
+        edges?: ManualEdge[];
+    };
+    patch?: {
+        nodes?: NodePatch[];
+    };
+    suppress?: Suppression[];
+};
+export declare function emptyOverrides(): BlueprintOverrides;
+export type OverridesReadFailure = {
+    ok: false;
+    reason: 'not-a-document';
+} | {
+    ok: false;
+    reason: 'wrong-version';
+    observed: unknown;
+};
+export type OverridesRead = {
+    ok: true;
+    overrides: BlueprintOverrides;
+} | OverridesReadFailure;
+export declare function readOverrides(parsed: unknown): OverridesRead;
+//# sourceMappingURL=overrides.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"overrides.d.ts","sourceRoot":"","sources":["../../src/overrides.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAEvC,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,eAAO,MAAM,4BAA4B,8BAA8B,CAAC;AAExE,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,OAAO,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7E;IACE,IAAI,EAAE,iBAAiB,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEN,MAAM,MAAM,kBAAkB,GAAG;IAC/B,aAAa,EAAE,sBAAsB,CAAC;IACtC,GAAG,CAAC,EAAE;QACJ,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;QACrB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;KACtB,CAAC;IACF,KAAK,CAAC,EAAE;QACN,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;KACrB,CAAC;IACF,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;CAC1B,CAAC;AAEF,wBAAgB,cAAc,IAAI,kBAAkB,CAEnD;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,GACvC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AAE9D,MAAM,MAAM,aAAa,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,kBAAkB,CAAA;CAAE,GAAG,oBAAoB,CAAC;AAE/F,wBAAgB,aAAa,CAAE,MAAM,EAAE,OAAO,GAAI,aAAa,CAO9D"}

package/build/cjs/overrides.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BLUEPRINT_OVERRIDES_FILENAME = exports.OVERRIDES_SCHEMA_VERSION = void 0;
+exports.emptyOverrides = emptyOverrides;
+exports.readOverrides = readOverrides;
+exports.OVERRIDES_SCHEMA_VERSION = 1;
+exports.BLUEPRINT_OVERRIDES_FILENAME = '.blueprint.overrides.json';
+function emptyOverrides() {
+    return { schemaVersion: 1 };
+}
+function readOverrides(parsed) {
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        return { ok: false, reason: 'not-a-document' };
+    }
+    const observed = parsed.schemaVersion;
+    if (observed !== exports.OVERRIDES_SCHEMA_VERSION)
+        return { ok: false, reason: 'wrong-version', observed };
+    return { ok: true, overrides: parsed };
+}
+//# sourceMappingURL=overrides.js.map

package/build/cjs/overrides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overrides.js","sourceRoot":"","sources":["../../src/overrides.ts"],"names":[],"mappings":";;;AA6DA,wCAEC;AAQD,sCAOC;AAzEY,QAAA,wBAAwB,GAAG,CAAC,CAAC;AAE7B,QAAA,4BAA4B,GAAG,2BAA2B,CAAC;AAsDxE,SAAgB,cAAc;IAC5B,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;AAC9B,CAAC;AAQD,SAAgB,aAAa,CAAE,MAAe;IAC5C,IAAK,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAE,MAAM,CAAE,EAAG,CAAC;QAC/E,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IACjD,CAAC;IACD,MAAM,QAAQ,GAAK,MAAuC,CAAC,aAAa,CAAC;IACzE,IAAK,QAAQ,KAAK,gCAAwB;QAAG,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC;IACrG,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAA4B,EAAE,CAAC;AAC/D,CAAC"}

package/build/cjs/reachability.d.ts

@@ -0,0 +1,27 @@
+import { EdgeKind } from './edges.js';
+import { DesignFile } from './design.js';
+import { PromotionOptions } from './entry-points.js';
+import { BlueprintGraph } from './graph.js';
+export declare const CAUSAL_KINDS: ReadonlySet<EdgeKind>;
+export type StrandReason = 'SYSTEM_WITHOUT_COMMAND_HANDLER' | 'CROSS_SUBDOMAIN_ENTRY_POINT_ONLY' | 'POLICY_HOP_WITHOUT_CAUSES_MIRROR' | 'NO_PATH_FROM_ANY_ROOT';
+export type StrandFrontier = {
+    id: string;
+    reason: StrandReason;
+    hint?: string;
+};
+export type StrandDownstream = {
+    id: string;
+    downstreamOf: string;
+};
+export type StrandingReport = {
+    frontier: readonly StrandFrontier[];
+    downstream: readonly StrandDownstream[];
+};
+export type StrandingFailure = {
+    code: string;
+    message: string;
+};
+export declare const strandingFailure: (cause: unknown) => StrandingFailure;
+export declare const drawableIds: (graph: BlueprintGraph, options?: PromotionOptions) => ReadonlySet<string>;
+export declare const findStrandedProposals: (graph: BlueprintGraph, design: DesignFile, options?: PromotionOptions) => StrandingReport;
+//# sourceMappingURL=reachability.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reachability.d.ts","sourceRoot":"","sources":["../../src/reachability.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAwC,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAK5C,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,QAAQ,CAI5C,CAAC;AAEJ,MAAM,MAAM,YAAY,GACpB,gCAAgC,GAChC,kCAAkC,GAClC,kCAAkC,GAClC,uBAAuB,CAAC;AAE5B,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;IACpC,UAAU,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAK,OAAO,OAAO,KAAI,gBAMnD,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,OAAO,cAAc,EACrB,UAAS,gBAAqB,KAC7B,WAAW,CAAC,MAAM,CAgCpB,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,OAAO,cAAc,EACrB,QAAQ,UAAU,EAClB,UAAS,gBAAqB,KAC7B,eAmDF,CAAC"}