@lssm/lib.contracts-spec 17.3.2

package/dist/node/data-views/graph-spec.js

@@ -0,0 +1,80 @@
+export const tech_contracts_data_views_graph_DocBlocks=[{id:"docs.tech.contracts.data-views.graph",title:"DataViewGraphSpec & DataViewGraphSource",summary:"`DataViewGraphSpec` is the sibling-type contract for graph and timeline-graph data views. `DataViewGraphSource` is the discriminated union of three data-fetching strategies: `inline-op`, `two-op`, and `entity-declarative` (requires EntityRegistry at render time).",kind:"reference",visibility:"public",route:"/docs/tech/contracts/data-views/graph",tags:["tech","contracts","data-views","graph","timeline"],body:`# DataViewGraphSpec & DataViewGraphSource
+
+## Purpose
+
+\`DataViewGraphSpec\` extends the data-view contract system for graph and
+timeline-graph experiences. It is a **sibling type** to \`DataViewSpec\`:
+both are accepted by \`defineDataView()\`, discriminated at runtime by
+\`view.kind\`.
+
+- \`view.kind ∈ {graph, timeline-graph}\` → \`DataViewGraphSpec\` branch
+- \`view.kind ∈ {list, detail, table, grid, timeline}\` → \`DataViewSpec\` branch
+
+\`DataViewSource\` shape is **intentionally unchanged** — no \`primary?\`
+optionalisation, no \`graph?\` field added.
+
+## DataViewGraphSource variants
+
+### \`inline-op\`
+Single operation returns both nodes and edges in one payload. Paths are
+dot-notation selectors into the result object.
+
+No EntityRegistry precondition.
+
+\`\`\`typescript
+source: {
+  variant: 'inline-op',
+  primary: { key: 'graph.getContractGraph', version: '1.0.0' },
+  nodesPath: 'data.nodes',
+  edgesPath: 'data.edges',
+}
+\`\`\`
+
+### \`two-op\`
+Separate operations for nodes and edges. Use when your API splits the graph
+across two endpoints.
+
+No EntityRegistry precondition.
+
+\`\`\`typescript
+source: {
+  variant: 'two-op',
+  nodes: { key: 'graph.getNodes', version: '1.0.0' },
+  edges: { key: 'graph.getEdges', version: '1.0.0' },
+}
+\`\`\`
+
+### \`entity-declarative\`
+Derives graph structure from a registered entity slug and optional edge
+declarations. The renderer resolves the entity from the \`EntityRegistry\`
+at render time.
+
+**⚠ Precondition (C12)**: \`EntityRegistry\` MUST be loaded before this view
+renders. The renderer asserts \`EntityRegistry.isLoaded()\` and throws if the
+registry is absent. \`inline-op\` and \`two-op\` do NOT share this precondition.
+
+\`\`\`typescript
+source: {
+  variant: 'entity-declarative',
+  entity: 'user',
+  edges: [{ from: 'user', to: 'project', relation: 'has-many' }],
+}
+\`\`\`
+
+## Example
+
+\`\`\`typescript
+import { defineDataView } from '@lssm/lib.contracts-spec';
+
+export const ContractGraphView = defineDataView({
+  meta: { key: 'contractspec.graph', version: '1.0.0', entity: 'contract', ... },
+  source: {
+    variant: 'inline-op',
+    primary: { key: 'graph.getContractGraph', version: '1.0.0' },
+    nodesPath: 'nodes',
+    edgesPath: 'edges',
+  },
+  view: { kind: 'graph', layout: { kind: 'dag', direction: 'TB' }, nodeKindField: 'type' },
+});
+\`\`\`
+`}];

package/dist/node/data-views/graph-subscription.js

@@ -0,0 +1,3 @@
+export function isGraphSubscriptionEvent(n){if(typeof n!=="object"||n===null)return!1;const e=n.kind;return e==="node-added"||e==="node-updated"||e==="node-removed"||e==="edge-added"||e==="edge-updated"||e==="edge-removed"||e==="snapshot-replace"}export const graphSubscriptionEventDoc={id:"docs.contracts-spec.data-views.graph-subscription-event",title:"GraphSubscriptionEvent — live graph update discriminated union",summary:"Discriminated union covering all live graph patch events: node-added, node-updated, node-removed, edge-*, and snapshot-replace. Consumed by SSE adapters and client hooks.",kind:"reference",visibility:"public",route:"/docs/contracts-spec/data-views/graph-subscription-event",tags:["graph","subscription","sse","live","events","m3","p5"],body:["# GraphSubscriptionEvent","","Discriminated union for live graph update events.","","| `kind` | Payload | Notes |","| --- | --- | --- |","| `node-added` | `node: SubscriptionNode` | New node arrived |","| `node-updated` | `node`, `previous?` | Partial patch; previous is optional |","| `node-removed` | `nodeId: string` | Node deleted |","| `edge-added` | `edge: SubscriptionEdge` | New edge |","| `edge-updated` | `edge`, `previous?` | Edge attribute change |","| `edge-removed` | `edgeId: string` | Edge deleted |","| `snapshot-replace` | `nodes[]`, `edges[]` | Full resync — replace all state |","","`snapshot-replace` is emitted on initial connect, reconnect after gap, or server invalidation.","Clients must exhaustively switch on `kind` for forward-compatibility."].join(`
+`)},graphSubscriptionDoc={id:"docs.contracts-spec.data-views.graph-subscription",title:"GraphSubscription — live graph subscription configuration contract",summary:"Configuration sent by clients to establish an SSE graph subscription. Server validates viewKey, applies filter, and streams GraphSubscriptionEvents.",kind:"reference",visibility:"public",route:"/docs/contracts-spec/data-views/graph-subscription",tags:["graph","subscription","sse","live","contract","m3","p5"],body:["# GraphSubscription","","```typescript","interface GraphSubscription {","  id: string;        // client- or server-generated","  viewKey: string;   // DataView registry key","  filter?: Record<string, unknown>;   // optional server-side filter","  eventKinds?: GraphSubscriptionEventKind[];  // subset of events","  heartbeatMs?: number;  // default 30_000","}","```","","## SSE wire format","","Each event is serialised as a standard SSE frame:","```",'data: {"kind":"node-added","node":{"id":"n1","label":"My Node"}}',"","```","","Heartbeat comments keep the connection alive:","```",": heartbeat","","```"].join(`
+`)};

package/dist/node/data-views/i18n-constraint.d.js

@@ -0,0 +1 @@
+export{};

package/dist/node/data-views/index.d.js

@@ -0,0 +1 @@
+export{ANNOTATION_DEFAULT_COLOR,ANNOTATION_DELETE_CONFLICT_WINDOW_MS,ANNOTATION_EDIT_WINDOW_MS,ANNOTATION_SOFT_DELETE_TTL_MS,annotationDoc}from"./annotation.js";export{resolveDataViewEditForm}from"./edit-form-resolution.js";export{filterSetToClauses,pruneDataViewFilterClauses,resolveDataViewFilters,sanitizeDataViewFilterSet}from"./filter-scope.js";export{graphExportDoc}from"./graph-export.js";export{decodeFilterFromUrl,encodeFilterToUrl,graphFilterCodecDoc}from"./graph-filter-codec.js";export{graphFilterSpecDoc}from"./graph-filter-spec.js";export{graphSubscriptionDoc,graphSubscriptionEventDoc,isGraphSubscriptionEvent}from"./graph-subscription.js";export{isSyncLayout,layoutSpecDoc}from"./layout-spec.js";export{DataViewRegistry,dataViewKey}from"./registry.js";export{deserializeSavedView,isValidSavedView,MAX_ZOOM,MIN_ZOOM,SAVED_VIEW_PARAM,savedViewDoc,serializeSavedView}from"./saved-view.js";export{defineDataView}from"./spec.js";export{storySlideDoc}from"./story-slide.js";

package/dist/node/data-views/index.js

@@ -0,0 +1 @@
+export{ANNOTATION_DEFAULT_COLOR,ANNOTATION_DELETE_CONFLICT_WINDOW_MS,ANNOTATION_EDIT_WINDOW_MS,ANNOTATION_SOFT_DELETE_TTL_MS,annotationDoc}from"./annotation.js";export{resolveDataViewEditForm}from"./edit-form-resolution.js";export{filterSetToClauses,pruneDataViewFilterClauses,resolveDataViewFilters,sanitizeDataViewFilterSet}from"./filter-scope.js";export{graphExportDoc}from"./graph-export.js";export{decodeFilterFromUrl,encodeFilterToUrl,graphFilterCodecDoc}from"./graph-filter-codec.js";export{graphFilterSpecDoc}from"./graph-filter-spec.js";export{graphSubscriptionDoc,graphSubscriptionEventDoc,isGraphSubscriptionEvent}from"./graph-subscription.js";export{isSyncLayout,layoutSpecDoc}from"./layout-spec.js";export{DataViewRegistry,dataViewKey}from"./registry.js";export{deserializeSavedView,isValidSavedView,MAX_ZOOM,MIN_ZOOM,SAVED_VIEW_PARAM,savedViewDoc,serializeSavedView}from"./saved-view.js";export{defineDataView}from"./spec.js";export{storySlideDoc}from"./story-slide.js";

package/dist/node/data-views/layout-spec.js

@@ -0,0 +1,2 @@
+export function isSyncLayout(e){return e.kind==="time-axis"}export const layoutSpecDoc={id:"docs.contracts-spec.data-views.layout-spec",title:"LayoutSpec — M3 layout discriminated union",summary:"Six-variant discriminated union replacing M2 GraphLayoutKind. Variants: force, dag, radial, tree, swimlane, time-axis.",kind:"reference",visibility:"public",route:"/docs/contracts-spec/data-views/layout-spec",tags:["graph","layout","spec","m3","elkjs","d3","discriminated-union"],body:["# LayoutSpec","","Discriminated union replacing `GraphLayoutKind` from M2.","","| kind | Key config | Engine (web / native) | Async chunk |","| --- | --- | --- | --- |","| `force` | strength, alphaDecay, collisionRadius | d3-force | d3-force.chunk ≤20 KB gz |","| `dag` | rankSep, nodeSep, direction | elkjs LAYERED / dagre | elkjs-layout-engine.chunk ≤250 KB gz |","| `radial` | innerRadius, outerRadius, angularRange | d3-hierarchy | d3-hierarchy.chunk ≤15 KB gz |","| `tree` | nodeSep, levelSep, orientation | d3-hierarchy tidy | d3-hierarchy.chunk ≤15 KB gz |","| `swimlane` | laneBy (req), lanes | elkjs BOX / dag fallback | elkjs-layout-engine.chunk ≤250 KB gz |","| `time-axis` | xField (req), scale | pure TS | base bundle (sync) |","","## Migration from M2","","```ts","import { layoutKindToSpec } from '@lssm/lib.contracts-spec/data-views/layout-spec';","layoutKindToSpec('dag') // → { kind: 'dag' }","```","","Remove `layoutKindToSpec` shim in P10 alongside `GraphLayoutKind` removal."].join(`
+`)};

package/dist/node/data-views/query-generator.js

@@ -0,0 +1 @@
+export class DataViewQueryGenerator{spec;constructor(e){this.spec=e}generate(e){const{primary:r}=this.spec.source,t=e.pagination?.mode==="cursor"?"cursor":"offset",i=Math.max(1,e.pagination?.page??1),n=e.pagination?.pageSize??e.pagination?.limit??k(this.spec.view)??20,s=(i-1)*n,c=n,o=Array.isArray(e.sort)?e.sort:e.sort?[e.sort]:[],a=t==="cursor"?{mode:"cursor",cursor:e.pagination?.cursor,limit:c,direction:e.pagination?.direction??"forward"}:{mode:"offset",offset:s,limit:c,page:i,pageSize:n},d=a.mode==="cursor"?{skip:s,take:c,cursor:a.cursor,limit:a.limit,...e.filters}:{skip:s,take:c,...e.filters};if(e.search)d.search=e.search;if(o.length)d.orderBy=Object.fromEntries(o.map((u)=>[u.field,u.direction]));const l={operation:{key:r.key,version:r.version},search:e.search?.trim()||void 0,filters:Object.entries(e.filters??{}).map(([u,y])=>({field:u,operator:"eq",value:b(y)})),sort:o,pagination:a,cache:e.cache};return{operationName:r.key,input:d,meta:{pagination:a,canonical:l,sorting:o[0],database:p(this.spec.source.database,e,a)}}}validateParams(e){const r=[];if(e.filters&&this.spec.view.filters)for(const i of Object.keys(e.filters)){const n=this.spec.view.filters.find((c)=>c.key===i);if(!n){r.push(`Unknown filter key: ${i}`);continue}const s=m(n,e.filters[i]);if(s)r.push(s)}const t=Array.isArray(e.sort)?e.sort:e.sort?[e.sort]:[];for(const i of t){const n=this.spec.view.fields.find((s)=>s.key===i.field);if(!n)r.push(`Unknown sort field: ${i.field}`);else if(n.sortable===!1)r.push(`Field is not sortable: ${i.field}`)}return r}}function p(e,r,t){if(!e)return;const i=[...e.defaultFilters??[],...Object.entries(r.filters??{}).flatMap(([o,a])=>a===void 0?[]:[{filterKey:o,field:o,operator:"eq",value:w(a)}])],n=Array.isArray(r.sort)?r.sort:r.sort?[r.sort]:void 0,s=n?n:(e.defaultSort??[]).map((o)=>({field:o.field,direction:o.direction})),c=g(s,e);return{operationRef:{key:"database.query.readonly",version:"2.0.0"},sourceKey:e.sourceKey,resource:e.resource,select:e.fields.filter((o)=>o.select!==!1),filters:i,sort:t.mode==="cursor"?c:s,pagination:t.mode==="cursor"?{mode:"cursor",cursor:t.cursor,limit:t.limit,direction:t.direction??"forward"}:{mode:"offset",skip:t.offset,take:t.limit},policyRefs:e.policyRefs,provenance:e.provenance}}function g(e,r){if(r.pagination?.mode!=="cursor")return e;const t=[...e],i=r.pagination.cursorField;if(i&&!t.some((n)=>n.field===i))t.push({field:i,direction:"asc"});return t}function w(e){if(f(e))return e;if(typeof e==="string"||typeof e==="number"||typeof e==="boolean")return{kind:"single",value:e};return{kind:"single",value:String(e)}}function b(e){return typeof e==="string"||typeof e==="number"||typeof e==="boolean"||e===null?e:String(e)}function k(e){if(e.kind==="detail"||e.kind==="timeline"||e.kind==="timeline-graph")return;return e.collection?.pagination?.pageSize}function m(e,r){if(r==null)return;const t=D(r);switch(e.type){case"number":case"percent":case"currency":case"duration":return V(e.key,t);case"boolean":return typeof t==="boolean"?void 0:`Filter must be boolean: ${e.key}`;case"date":case"time":case"datetime":return h(e.key,t);case"search":case"enum":default:return}}function D(e){if(!f(e))return e;switch(e.kind){case"single":return e.value;case"multi":return e.values;case"range":return[e.from,e.to].filter((r)=>r!=null);case"composite":return}}function f(e){return typeof e==="object"&&e!=null&&"kind"in e&&typeof e.kind==="string"}function V(e,r){return(Array.isArray(r)?r:[r]).every((i)=>typeof i==="number")?void 0:`Filter must be numeric: ${e}`}function h(e,r){return(Array.isArray(r)?r:[r]).every((i)=>typeof i==="string"||typeof i==="number")?void 0:`Filter must be comparable: ${e}`}

package/dist/node/data-views/registry.js

@@ -0,0 +1 @@
+import{SpecContractRegistry as t}from"../registry.js";export function dataViewKey(e){return`${e.meta.key}.v${e.meta.version}`}export class DataViewRegistry extends t{constructor(e){super("data-view",e)}}

package/dist/node/data-views/report/contractVerificationTable.js

@@ -0,0 +1,29 @@
+import{GetContractVerificationStatusQuery as e}from"../../operations/report/getContractVerificationStatus.js";import{StabilityEnum as t}from"../../ownership.js";import{defineTranslation as i}from"../../translations/index.js";import{defineDataView as a}from"../spec.js";const r=i({meta:{key:"report.contractVerificationTable.i18n",version:"1.0.0",domain:"report",owners:["platform.core"]},locale:"en",messages:{"field.name.label":{value:"Contract / Endpoint / Event"},"field.timeSinceVerified.label":{value:"Time since verified"},"field.driftMismatches.label":{value:"Drift debt"},"field.surfaces.label":{value:"Surfaces covered"},"field.lastVerifiedSha.label":{value:"Last verified commit"}}});export const ContractVerificationTableDataView=a(r,{meta:{key:"report.contractVerificationTable",title:"Contract Verification Table",version:"1.0.0",description:"Table view of per-contract verification status for the impact report.",domain:"report",owners:["platform.core"],tags:["report","data-view","verification"],stability:t.Experimental,entity:"contract-verification"},source:{primary:{key:e.meta.key,version:e.meta.version}},view:{kind:"table",fields:[{key:"name",label:"field.name.label",dataPath:"name"},{key:"timeSinceVerified",label:"field.timeSinceVerified.label",dataPath:"lastVerifiedDate"},{key:"driftMismatches",label:"field.driftMismatches.label",dataPath:"driftMismatches",format:"number",sortable:!0},{key:"surfaces",label:"field.surfaces.label",dataPath:"surfaces",format:"badge"},{key:"lastVerifiedSha",label:"field.lastVerifiedSha.label",dataPath:"lastVerifiedSha",width:"sm"}],primaryField:"name",secondaryFields:["driftMismatches","timeSinceVerified"],columns:[{field:"name",width:"lg"},{field:"lastVerifiedSha",width:"sm"},{field:"timeSinceVerified",width:"sm"},{field:"surfaces",width:"md"},{field:"driftMismatches",width:"xs",align:"right"}]},policy:{flags:[],pii:[]}}),reportVerificationTableDocBlocks=[{id:"docs.tech.report-verification-table",title:"Contract Verification Table",summary:"How the impact report renders per-contract verification status.",kind:"how",visibility:"public",route:"/docs/tech/report/verification-table",tags:["report","drift","verification","impact"],owners:["platform.core"],domain:"report",body:`# Contract Verification Table
+
+The impact report includes an optional per-contract verification table that summarises the health of each contract at a glance.
+
+## Columns
+
+| Column | Description |
+|--------|-------------|
+| Contract / Endpoint / Event | Fully qualified contract name (e.g. \`user.create\`) |
+| Drift debt | Number of mismatches currently detected |
+| Time since verified | Human-friendly elapsed time (e.g. "23 days") or "Never" |
+| Surfaces covered | Comma-separated list (API, runtime validation, UI form, docs/examples, permissions) |
+| Last verified commit | Short SHA of the last drift-free commit |
+
+## Data flow
+
+1. The drift detector produces per-contract mismatch counts.
+2. \`.contractspec/verified.json\` records the last clean commit per contract.
+3. The report script reads both sources and renders the Markdown table.
+
+## Backward compatibility
+
+When \`contracts\` is absent from the report JSON, the table is skipped and the existing report sections render unchanged.
+
+## Contracts
+
+- Query: \`report.getContractVerificationStatus\` (v1.0.0)
+- Data view: \`report.contractVerificationTable\` (v1.0.0)
+`}];

package/dist/node/data-views/runtime.js

@@ -0,0 +1 @@
+function a(t){return typeof t==="object"&&t!==null&&"items"in t&&Array.isArray(t.items)}export class DataViewRuntime{config;cache=new Map;subscriptions=new Map;constructor(t){this.config=t}register(t){this.config.registry.register(t)}getSpec(t,r){return this.config.registry.get(t,r)}async executeQuery(t,r,s){const n=this.getSpec(t);if(!n)throw Error(`DataView spec not found: ${t}`);const i=n.source.primary;if(!i)throw Error(`DataView spec ${t} missing primary source`);try{const e=await this.config.operationRegistry.execute(i.key,i.version,r,s);if(Array.isArray(e))return{data:e,total:e.length,loading:!1};if(a(e))return{data:e.items,total:e.total??e.items.length,loading:!1};return{data:[e],total:1,loading:!1}}catch(e){return{data:[],total:0,loading:!1,error:e instanceof Error?e:Error(String(e))}}}invalidate(t){this.cache.delete(t);this.notifySubscribers(t)}subscribe(t,r){if(!this.subscriptions.has(t))this.subscriptions.set(t,new Set);this.subscriptions.get(t)?.add(r);return()=>{this.subscriptions.get(t)?.delete(r)}}notifySubscribers(t){this.subscriptions.get(t)?.forEach((r)=>r())}}

package/dist/node/data-views/saved-view.js

@@ -0,0 +1,19 @@
+export const SAVED_VIEW_PARAM="gv",MIN_ZOOM=0.05,MAX_ZOOM=10;export function serializeSavedView(n){return btoa(unescape(encodeURIComponent(JSON.stringify(n))))}export function deserializeSavedView(n){try{const e=decodeURIComponent(escape(atob(n))),t=JSON.parse(e);if(!isValidSavedView(t))return null;return{...t,viewport:{...t.viewport,zoom:Math.max(MIN_ZOOM,Math.min(MAX_ZOOM,t.viewport.zoom))}}}catch{return null}}export function isValidSavedView(n){if(typeof n!=="object"||n===null)return!1;const e=n;if(typeof e.id!=="string"||e.id.length===0)return!1;if(typeof e.name!=="string")return!1;if(typeof e.savedAt!=="string"||e.savedAt.length===0)return!1;const t=e.viewport;if(typeof t!=="object"||t===null)return!1;const r=t;if(typeof r.x!=="number")return!1;if(typeof r.y!=="number")return!1;if(typeof r.zoom!=="number")return!1;return!0}export const savedViewDoc={id:"docs.contracts-spec.data-views.saved-view",title:"SavedView — serialisable graph viewport + filter + layout snapshot",summary:"Encodes graph viewport, active filter, and layout as a base64 URL param (?gv=). Use serializeSavedView / deserializeSavedView to persist and restore. useSavedViewRestore reads ?gv= on mount and applies the snapshot.",kind:"reference",visibility:"public",route:"/docs/contracts-spec/data-views/saved-view",tags:["graph","saved-view","url","restore","viewport","m3"],body:`# SavedView
+
+Serialisable snapshot of the current graph state stored in \`?gv=<base64>\`.
+
+## Fields
+
+| Field | Type | Description |
+|---|---|---|
+| \`id\` | \`string\` | Unique view identifier |
+| \`name\` | \`string\` | Human-readable label |
+| \`viewport\` | \`SavedViewport\` | Pan + zoom state |
+| \`filter\` | \`GraphFilterSpec?\` | Active filter snapshot |
+| \`layout\` | \`string?\` | Layout kind key |
+| \`savedAt\` | \`string\` | ISO 8601 timestamp |
+
+## URL encoding
+
+Zoom is clamped to \`[${MIN_ZOOM}, ${MAX_ZOOM}]\` on decode. Invalid or absent \`?gv=\` always yields \`null\`.
+`};

package/dist/node/data-views/spec.js

@@ -0,0 +1,23 @@
+export function defineDataView(t,e){return{...e,meta:{...e.meta,translationKey:t.meta.key}}}export const tech_contracts_data_views_DocBlocks=[{id:"docs.tech.contracts.data-views",title:"DataViewSpec Overview",summary:"`DataViewSpec` is the declarative contract for projecting entities into list/detail/table/grid experiences. Each spec ties to contract operations (`source.primary`, `source.item`) and describes how the UI should present, sort, filter, paginate, pin records, and optionally compose adaptive entity-management command centers.",kind:"reference",visibility:"public",route:"/docs/tech/contracts/data-views",tags:["tech","contracts","data-views"],body:`# DataViewSpec Overview
+
+## Purpose
+
+\`DataViewSpec\` is the declarative contract for projecting entities into list/detail/table/grid experiences. Each spec ties to contract operations (\`source.primary\`, \`source.item\`) and describes how the UI should present, sort, filter, paginate, pin records, and optionally compose adaptive entity-management command centers.
+
+## Schema Highlights
+
+- **DataViewMeta**: ownership metadata plus an entity slug.
+- **DataViewSource**: primary/item operation refs, mutation operation refs, refresh events, and optional database binding.
+- **DataViewConfig**: list/detail/table/grid definitions with fields, filters, actions, collection preferences, and optional \`view.management\` metadata.
+- **DataViewAction**: declarative actions with optional placement, intent, selection scope, approval/destructive boundary, and operation refs.
+- **DataViewConfig.management**: optional command-center metadata for header copy, master-detail layout, toolbar groups, selection/bulk actions, detail empty states, personalization keys, and RoleMorph refs.
+- **DataViewSections**: detail-view sections discriminated by \`kind\` (default \`'fields'\`). A \`'relationship'\` section carries a \`relationship: DataViewSectionRelationship\` (\`key\`, \`cardinality\`, \`dataPath?\`/\`source?\`/\`specKey?\`/inline \`fields?\`, \`displayMode?\`, \`limit?\`, \`emptyState?\`) and renders a related-record collection. The declared relation \`OpRef\` is host-executed; the design-system performs no I/O.
+
+## Authoring Guidelines
+
+1. Keep fetching logic inside contract operations; DataViewSpec only references them via \`source\`.
+2. Use \`view.management\` for entity-management projection metadata only.
+3. Keep persistence, validation, modal flow, destructive confirmations, and network side effects host-owned or FormSpec-owned.
+4. Prefer additive metadata and version specs deliberately when field membership, ordering, or semantics change.
+5. Declare relationships via a \`kind: 'relationship'\` section; supply related records embedded (\`dataPath\`) or host-supplied — the design-system never executes the relation \`OpRef\`.
+`}];

package/dist/node/data-views/story-slide.js

@@ -0,0 +1,2 @@
+export const storySlideDoc={id:"docs.contracts-spec.data-views.story-slide",title:"StorySlide — presenter-led graph slide contract",summary:"StorySlide type, DataViewGraphStory config, StorySlideTransition, and StoryPlaybackMode for presenter-led graph sequences (M3 P6/W6.7).",kind:"reference",visibility:"public",route:"/docs/contracts-spec/data-views/story-slide",tags:["graph","story","slide","presenter","contract","m3","p6"],body:["# StorySlide contract","","Story mode is a presentation overlay — it does **not** mutate graph structure.","","## Key types","","| Type | Purpose |","|---|---|","| `StorySlide` | One step in the sequence: viewport, highlights, transition, speaker notes |","| `DataViewGraphStory` | Top-level config stored in `DataViewGraphSpec.story` |","| `StorySlideTransition` | `viewport-pan \\| fade \\| zoom-to-node \\| zoom-out \\| instant` |","| `StoryPlaybackMode` | `PRESENTER_LED` (default) or `PER_USER` |","| `ViewportState` | `{ centerX, centerY, zoom }` in graph-space |","","## Playback state","Ephemeral Yjs Awareness — not persisted in the Y.Doc.","`DataViewGraphStory.slides` is static config.","","## Reduced motion","All transitions skip-to-end-state when `prefers-reduced-motion` is active.","","## Voice narration","When `voiceNarrationEnabled: true`, transcripts become annotations on `highlightedNodeIds[0]`."].join(`
+`)};

package/dist/node/database/capabilities/databaseContext.capability.js

@@ -0,0 +1,4 @@
+import{defineCapability as e}from"../../capabilities/index.js";import{docRef as a}from"../../docs/registry.js";import{DATABASE_DOMAIN as t,DATABASE_OWNERS as o,DATABASE_STABILITY as i,DATABASE_TAGS as n}from"../constants.js";export const DatabaseContextDocBlock={id:"docs.tech.database.context",title:"Database context",summary:"Schema, migrations, dictionary, read-only query, and governed mutation surfaces.",kind:"reference",visibility:"public",route:"/docs/tech/database/context",tags:["database","context"],body:`# Database context
+
+Database context covers portable schema descriptions, migration artifact provenance, data dictionary entries, governed read-only access, and governed mutation planning/execution envelopes.
+`},DatabaseContextCapability=e({meta:{key:"database.context",version:"2.0.0",kind:"data",title:"Database Context",description:"Schema, migration, dictionary, read-only query, and governed mutation surfaces.",domain:t,owners:o,tags:[...n,"context"],stability:i,docId:[a(DatabaseContextDocBlock.id)]},provides:[{surface:"operation",key:"database.schema.describe",version:"2.0.0",description:"Describe schemas and models."},{surface:"operation",key:"database.migrations.list",version:"2.0.0",description:"List database migrations."},{surface:"operation",key:"database.dictionary.get",version:"2.0.0",description:"Get data dictionary entry."},{surface:"operation",key:"database.query.readonly",version:"2.0.0",description:"Perform read-only data query via data views."},{surface:"operation",key:"database.mutation.plan",version:"2.0.0",description:"Plan governed database mutation intent."},{surface:"operation",key:"database.mutation.execute",version:"2.0.0",description:"Execute governed database mutation intent."}]});

package/dist/node/database/capabilities/index.js

@@ -0,0 +1 @@
+export*from"./databaseContext.capability.js";

package/dist/node/database/commands/databaseMutationExecute.command.js

@@ -0,0 +1,4 @@
+import{ScalarTypeEnum as e,SchemaModel as t}from"@lssm/lib.schema";import{docRef as a}from"../../docs/registry.js";import{defineCommand as i}from"../../operations/index.js";import{DATABASE_DOMAIN as n,DATABASE_OWNERS as o,DATABASE_STABILITY as s,DATABASE_TAGS as r}from"../constants.js";const p=new t({name:"DatabaseMutationExecuteInput",fields:{mutationPlanRef:{type:e.NonEmptyString(),isOptional:!1},statementDescriptor:{type:e.JSONObject(),isOptional:!1},actorRef:{type:e.NonEmptyString(),isOptional:!1},tenantRef:{type:e.NonEmptyString(),isOptional:!1},domainCommandRef:{type:e.NonEmptyString(),isOptional:!1},policyDecisionRef:{type:e.NonEmptyString(),isOptional:!1},idempotencyKey:{type:e.NonEmptyString(),isOptional:!1},transactionBoundary:{type:e.String_unsecure(),isOptional:!1},expectedWriteSet:{type:e.JSONObject(),isOptional:!1,isArray:!0},auditEventRefs:{type:e.NonEmptyString(),isOptional:!1,isArray:!0},replayRef:{type:e.NonEmptyString(),isOptional:!1},correlationRef:{type:e.NonEmptyString(),isOptional:!1},economicEvidenceRefs:{type:e.NonEmptyString(),isOptional:!1,isArray:!0},dryRun:{type:e.Boolean(),isOptional:!1}}}),c=new t({name:"DatabaseMutationExecuteOutput",fields:{mutationExecutionRef:{type:e.NonEmptyString(),isOptional:!1},status:{type:e.String_unsecure(),isOptional:!1},rowCount:{type:e.Int_unsecure(),isOptional:!0},idempotentReplay:{type:e.Boolean(),isOptional:!1},auditEventRefs:{type:e.NonEmptyString(),isOptional:!1,isArray:!0},replayRef:{type:e.NonEmptyString(),isOptional:!1},correlationRef:{type:e.NonEmptyString(),isOptional:!1},economicEvidenceRefs:{type:e.NonEmptyString(),isOptional:!1,isArray:!0}}});export const DatabaseMutationExecuteDocBlock={id:"docs.tech.database.mutation.execute",title:"Governed database mutation execution",summary:"Execute a pre-planned database mutation through a provider adapter with audit, idempotency, and transaction evidence.",kind:"reference",visibility:"public",route:"/docs/tech/database/mutation/execute",tags:["database","mutation","execute","governance"],body:`# database.mutation.execute
+
+Executes a previously planned portable database mutation through a provider/integration binding. SQL and Drizzle rendering remain outside contracts-spec; this command only defines the governed contract envelope.
+`},DatabaseMutationExecuteCommand=i({meta:{key:"database.mutation.execute",title:"Database Mutation Execute",version:"2.0.0",description:"Execute a governed database mutation through a provider binding.",goal:"Apply durable writes only after policy, audit, idempotency, and transaction evidence exist.",context:"Used by provider-database integrations and domain command adapters after a mutation plan is approved or classified safe.",domain:n,owners:o,tags:[...r,"mutation","execute","managed-byok"],stability:s,docId:[a(DatabaseMutationExecuteDocBlock.id)]},capability:{key:"database.context",version:"2.0.0"},io:{input:p,output:c},policy:{auth:"admin",escalate:"human_review",policies:[{key:"database.mutation.governed",version:"2.0.0"}]},sideEffects:{audit:["database.mutation.execute"]},economicEvidence:{required:!0,modelVersion:"database-economic-evidence-v1",refs:[{id:"usage:operation:database.mutation.execute",kind:"usage",source:"@lssm/lib.economic-evidence"}]}});

package/dist/node/database/commands/databaseMutationPlan.command.js

@@ -0,0 +1,4 @@
+import{ScalarTypeEnum as e,SchemaModel as t}from"@lssm/lib.schema";import{docRef as a}from"../../docs/registry.js";import{defineCommand as n}from"../../operations/index.js";import{DATABASE_DOMAIN as i,DATABASE_OWNERS as o,DATABASE_STABILITY as s,DATABASE_TAGS as r}from"../constants.js";const p=new t({name:"DatabaseMutationPlanInput",fields:{mutationKey:{type:e.NonEmptyString(),isOptional:!1},resource:{type:e.JSONObject(),isOptional:!1},operation:{type:e.String_unsecure(),isOptional:!1},actorRef:{type:e.NonEmptyString(),isOptional:!1},tenantRef:{type:e.NonEmptyString(),isOptional:!1},domainCommandRef:{type:e.NonEmptyString(),isOptional:!1},policyRefs:{type:e.JSONObject(),isOptional:!1,isArray:!0},idempotencyKey:{type:e.NonEmptyString(),isOptional:!1},transactionBoundary:{type:e.String_unsecure(),isOptional:!1},expectedWriteSet:{type:e.JSONObject(),isOptional:!1,isArray:!0},auditEventRefs:{type:e.NonEmptyString(),isOptional:!1,isArray:!0},approvalRef:{type:e.String_unsecure(),isOptional:!0},riskClassification:{type:e.String_unsecure(),isOptional:!1},replayRef:{type:e.NonEmptyString(),isOptional:!1},correlationRef:{type:e.NonEmptyString(),isOptional:!1},economicEvidenceRefs:{type:e.NonEmptyString(),isOptional:!1,isArray:!0},dryRun:{type:e.Boolean(),isOptional:!1}}}),l=new t({name:"DatabaseMutationPlanOutput",fields:{mutationPlanRef:{type:e.NonEmptyString(),isOptional:!1},status:{type:e.String_unsecure(),isOptional:!1},canonicalWritePath:{type:e.String_unsecure(),isOptional:!1},domainCommandRef:{type:e.NonEmptyString(),isOptional:!1},expectedWriteSet:{type:e.JSONObject(),isOptional:!1,isArray:!0},policyRefs:{type:e.JSONObject(),isOptional:!1,isArray:!0},approvalRequired:{type:e.Boolean(),isOptional:!1},auditEventRefs:{type:e.NonEmptyString(),isOptional:!1,isArray:!0},replayRef:{type:e.NonEmptyString(),isOptional:!1},correlationRef:{type:e.NonEmptyString(),isOptional:!1},economicEvidenceRefs:{type:e.NonEmptyString(),isOptional:!1,isArray:!0}}});export const DatabaseMutationPlanDocBlock={id:"docs.tech.database.mutation.plan",title:"Governed database mutation plan",summary:"Plan a portable database mutation with domain-command authority and governance evidence.",kind:"reference",visibility:"public",route:"/docs/tech/database/mutation/plan",tags:["database","mutation","governance"],body:`# database.mutation.plan
+
+Plans portable database mutation intent without generating SQL or importing a provider runtime. Business-state writes must carry the owning domain command reference; generic mutations are reserved for bootstrap, admin, or infrastructure cases and cannot bypass domain invariants.
+`},DatabaseMutationPlanCommand=n({meta:{key:"database.mutation.plan",title:"Database Mutation Plan",version:"2.0.0",description:"Plan a governed portable database mutation before provider execution.",goal:"Capture mutation intent, domain-command authority, and governance evidence before any durable write.",context:"Used by managed/BYOK database runtimes and local compatible providers before executing state changes.",domain:i,owners:o,tags:[...r,"mutation","governance","managed-byok"],stability:s,docId:[a(DatabaseMutationPlanDocBlock.id)]},capability:{key:"database.context",version:"2.0.0"},io:{input:p,output:l},policy:{auth:"admin",escalate:"human_review",policies:[{key:"database.mutation.governed",version:"2.0.0"}]},sideEffects:{audit:["database.mutation.plan"]},economicEvidence:{required:!0,modelVersion:"database-economic-evidence-v1",refs:[{id:"usage:operation:database.mutation.plan",kind:"usage",source:"@lssm/lib.economic-evidence"}]}});

package/dist/node/database/commands/index.js

@@ -0,0 +1 @@
+export*from"./databaseMutationExecute.command.js";export*from"./databaseMutationPlan.command.js";

package/dist/node/database/constants.js

@@ -0,0 +1 @@
+import{StabilityEnum as t,TagsEnum as A}from"../ownership.js";export const DATABASE_DOMAIN="database",DATABASE_OWNERS=["platform.data"],DATABASE_TAGS=[A.Automation,"database","schema","migrations"],DATABASE_STABILITY=t.Experimental;

package/dist/node/database/contracts.js

@@ -0,0 +1 @@
+import{DatabaseContextCapability as a}from"./capabilities/index.js";import{DatabaseMutationExecuteCommand as e,DatabaseMutationPlanCommand as r}from"./commands/index.js";import{DatabaseDictionaryGetQuery as i}from"./queries/databaseDictionaryGet.query.js";import{DatabaseMigrationsListQuery as o}from"./queries/databaseMigrationsList.query.js";import{DatabaseQueryReadonlyQuery as s}from"./queries/databaseQueryReadonly.query.js";import{DatabaseSchemaDescribeQuery as p}from"./queries/databaseSchemaDescribe.query.js";import{DatabaseSchemasDataView as n}from"./views/index.js";export const databaseOperationContracts={DatabaseSchemaDescribeQuery:p,DatabaseMigrationsListQuery:o,DatabaseDictionaryGetQuery:i,DatabaseQueryReadonlyQuery:s,DatabaseMutationPlanCommand:r,DatabaseMutationExecuteCommand:e},databaseCapabilityContracts={DatabaseContextCapability:a},databaseDataViewContracts={DatabaseSchemasDataView:n};export function registerDatabaseOperations(t){return t.register(p).register(o).register(i).register(s).register(r).register(e)}export function registerDatabaseCapabilities(t){return t.register(a)}export function registerDatabaseDataViews(t){return t.register(n)}

package/dist/node/database/database.feature.js

@@ -0,0 +1 @@
+import{defineFeature as e}from"../features/index.js";import{DATABASE_DOMAIN as a,DATABASE_OWNERS as t,DATABASE_STABILITY as s,DATABASE_TAGS as i}from"./constants.js";export const DatabaseFeature=e({meta:{key:"platform.database",version:"2.0.0",title:"Database Context",description:"Describe portable database schemas, list provenance-aware migrations, query data dictionaries, execute governed read-only queries, and plan/execute governed mutation envelopes",domain:a,owners:t,tags:[...i],stability:s},operations:[{key:"database.schema.describe",version:"2.0.0"},{key:"database.migrations.list",version:"2.0.0"},{key:"database.dictionary.get",version:"2.0.0"},{key:"database.query.readonly",version:"2.0.0"},{key:"database.mutation.plan",version:"2.0.0"},{key:"database.mutation.execute",version:"2.0.0"}],capabilities:{provides:[{key:"database.context",version:"2.0.0"}]},dataViews:[{key:"database.schema.index",version:"2.0.0"}]});

package/dist/node/database/economic-evidence.js

@@ -0,0 +1 @@
+export function propagateDatabaseEconomicEvidenceRefs(e){const n=new Set;for(const t of[e.inputRefs,e.planRefs,e.executeRefs])for(const o of t??[])if(o.length>0)n.add(o);return[...n]}

package/dist/node/database/index.js

@@ -0,0 +1 @@
+export*from"./capabilities/index.js";export*from"./commands/index.js";export*from"./constants.js";export*from"./contracts.js";export*from"./database.feature.js";export*from"./economic-evidence.js";export*from"./queries/index.js";export*from"./tables/index.js";export*from"./views/index.js";

package/dist/node/database/queries/databaseDictionaryGet.query.js

@@ -0,0 +1,4 @@
+import{ScalarTypeEnum as t,SchemaModel as e}from"@lssm/lib.schema";import{docRef as a}from"../../docs/registry.js";import{defineQuery as i}from"../../operations/index.js";import{DATABASE_DOMAIN as n,DATABASE_OWNERS as r,DATABASE_STABILITY as o,DATABASE_TAGS as s}from"../constants.js";const c=new e({name:"DatabaseDictionaryGetInput",fields:{databaseKey:{type:t.NonEmptyString(),isOptional:!1},entryKey:{type:t.NonEmptyString(),isOptional:!1}}}),y=new e({name:"DatabaseDictionaryEntry",fields:{entryKey:{type:t.String_unsecure(),isOptional:!1},description:{type:t.String_unsecure(),isOptional:!0},fieldPath:{type:t.String_unsecure(),isOptional:!0},entityName:{type:t.String_unsecure(),isOptional:!0},tableName:{type:t.String_unsecure(),isOptional:!0},columnName:{type:t.String_unsecure(),isOptional:!0},piiTags:{type:t.String_unsecure(),isOptional:!0,isArray:!0},owner:{type:t.String_unsecure(),isOptional:!0}}}),d=new e({name:"DatabaseDictionaryGetOutput",fields:{entry:{type:y,isOptional:!1}}});export const DatabaseDictionaryGetDocBlock={id:"docs.tech.database.dictionary.get",title:"Get data dictionary entry",summary:"Retrieve a dictionary entry for a schema field.",kind:"reference",visibility:"public",route:"/docs/tech/database/dictionary/get",tags:["database","dictionary"],body:`# database.dictionary.get
+
+Returns semantic descriptions, PII tags, and portable field-to-column references for database fields.
+`},DatabaseDictionaryGetQuery=i({meta:{key:"database.dictionary.get",title:"Get Data Dictionary Entry",version:"2.0.0",description:"Retrieve a data dictionary entry for a schema field.",goal:"Provide semantic context for schema fields and PII handling.",context:"Used by agents to interpret data before retrieval or export.",domain:n,owners:r,tags:[...s,"dictionary"],stability:o,docId:[a(DatabaseDictionaryGetDocBlock.id)]},capability:{key:"database.context",version:"2.0.0"},io:{input:c,output:d},policy:{auth:"admin",pii:[]}});

package/dist/node/database/queries/databaseMigrationsList.query.js

@@ -0,0 +1,4 @@
+import{ScalarTypeEnum as t,SchemaModel as i}from"@lssm/lib.schema";import{docRef as a}from"../../docs/registry.js";import{defineQuery as e}from"../../operations/index.js";import{DATABASE_DOMAIN as s,DATABASE_OWNERS as n,DATABASE_STABILITY as r,DATABASE_TAGS as o}from"../constants.js";const u=new i({name:"DatabaseMigrationsListInput",fields:{databaseKey:{type:t.NonEmptyString(),isOptional:!1},limit:{type:t.Int_unsecure(),isOptional:!0},offset:{type:t.Int_unsecure(),isOptional:!0}}}),p=new i({name:"DatabaseMigrationSummary",fields:{key:{type:t.String_unsecure(),isOptional:!1},version:{type:t.String_unsecure(),isOptional:!1},description:{type:t.String_unsecure(),isOptional:!0},status:{type:t.String_unsecure(),isOptional:!0},targetDialect:{type:t.String_unsecure(),isOptional:!0},artifactPath:{type:t.String_unsecure(),isOptional:!0},generatedFrom:{type:t.String_unsecure(),isOptional:!0},appliedAt:{type:t.DateTime(),isOptional:!0}}}),c=new i({name:"DatabaseMigrationsListOutput",fields:{migrations:{type:p,isOptional:!1,isArray:!0},total:{type:t.Int_unsecure(),isOptional:!0},nextOffset:{type:t.Int_unsecure(),isOptional:!0}}});export const DatabaseMigrationsListDocBlock={id:"docs.tech.database.migrations.list",title:"List database migrations",summary:"List migration history for a database.",kind:"reference",visibility:"public",route:"/docs/tech/database/migrations/list",tags:["database","migrations"],body:`# database.migrations.list
+
+Returns migration registry entries, statuses, target dialects, and generated artifact provenance for auditability.
+`},DatabaseMigrationsListQuery=e({meta:{key:"database.migrations.list",title:"List Database Migrations",version:"2.0.0",description:"List registered database migrations and statuses.",goal:"Provide migration context and auditability for schema changes.",context:"Used by Studio, ops, and agents before data migrations.",domain:s,owners:n,tags:[...o,"migrations"],stability:r,docId:[a(DatabaseMigrationsListDocBlock.id)]},capability:{key:"database.context",version:"2.0.0"},io:{input:u,output:c},policy:{auth:"admin",pii:[]}});

package/dist/node/database/queries/databaseQueryReadonly.query.js

@@ -0,0 +1,4 @@
+import{ScalarTypeEnum as e,SchemaModel as t}from"@lssm/lib.schema";import{docRef as a}from"../../docs/registry.js";import{defineQuery as r}from"../../operations/index.js";import{DATABASE_DOMAIN as o,DATABASE_OWNERS as i,DATABASE_STABILITY as n,DATABASE_TAGS as s}from"../constants.js";const u=new t({name:"DatabaseQueryReadonlyInput",fields:{dataViewKey:{type:e.NonEmptyString(),isOptional:!1},dataViewVersion:{type:e.String_unsecure(),isOptional:!0},databaseKey:{type:e.String_unsecure(),isOptional:!0},filters:{type:e.JSONObject(),isOptional:!0},limit:{type:e.Int_unsecure(),isOptional:!0},offset:{type:e.Int_unsecure(),isOptional:!0},sort:{type:e.JSONObject(),isOptional:!0},redactionMode:{type:e.String_unsecure(),isOptional:!0}}}),y=new t({name:"DatabaseQueryReadonlyOutput",fields:{rows:{type:e.JSONObject(),isOptional:!1,isArray:!0},total:{type:e.Int_unsecure(),isOptional:!0},nextOffset:{type:e.Int_unsecure(),isOptional:!0},schemaRef:{type:e.String_unsecure(),isOptional:!0},targetDialect:{type:e.String_unsecure(),isOptional:!0}}});export const DatabaseQueryReadonlyDocBlock={id:"docs.tech.database.query.readonly",title:"Read-only data query",summary:"Perform a governed read-only query via data views.",kind:"reference",visibility:"public",route:"/docs/tech/database/query/readonly",tags:["database","query","readonly"],body:`# database.query.readonly
+
+Executes read-only data access using governed data views over the portable database context with policy and redaction.
+`},DatabaseQueryReadonlyQuery=r({meta:{key:"database.query.readonly",title:"Read-Only Data Query",version:"2.0.0",description:"Execute a governed read-only query via a data view.",goal:"Allow safe, policy-gated data retrieval for agents and operators.",context:"Used for live data access with redaction and auditing.",domain:o,owners:i,tags:[...s,"query","readonly"],stability:n,docId:[a(DatabaseQueryReadonlyDocBlock.id)]},capability:{key:"database.context",version:"2.0.0"},io:{input:u,output:y},policy:{auth:"admin",pii:["rows"]}});

package/dist/node/database/queries/databaseRelationalQuery.query.js

@@ -0,0 +1,9 @@
+import{ScalarTypeEnum as e,SchemaModel as t}from"@lssm/lib.schema";import{docRef as o}from"../../docs/registry.js";import{defineQuery as l}from"../../operations/index.js";import{DATABASE_DOMAIN as n,DATABASE_OWNERS as s,DATABASE_STABILITY as p,DATABASE_TAGS as d}from"../constants.js";const a=new t({name:"DatabaseRelationalResource",fields:{kind:{type:e.NonEmptyString(),isOptional:!1},name:{type:e.NonEmptyString(),isOptional:!1},schema:{type:e.String_unsecure(),isOptional:!0}}}),i=new t({name:"DatabaseRelationalSelect",fields:{fieldKey:{type:e.NonEmptyString(),isOptional:!1},column:{type:e.NonEmptyString(),isOptional:!1},select:{type:e.Boolean(),isOptional:!0}}}),r=new t({name:"DatabaseRelationalFilter",fields:{filterKey:{type:e.String_unsecure(),isOptional:!0},field:{type:e.NonEmptyString(),isOptional:!1},operator:{type:e.NonEmptyString(),isOptional:!1},value:{type:e.JSONObject(),isOptional:!0}}}),c=new t({name:"DatabaseRelationalSort",fields:{field:{type:e.NonEmptyString(),isOptional:!1},direction:{type:e.NonEmptyString(),isOptional:!1}}}),y=new t({name:"DatabaseRelationalRelation",fields:{relationKey:{type:e.NonEmptyString(),isOptional:!1},resource:{type:a,isOptional:!1},parentColumn:{type:e.NonEmptyString(),isOptional:!1},childColumn:{type:e.NonEmptyString(),isOptional:!1},select:{type:i,isOptional:!1,isArray:!0},filters:{type:r,isOptional:!1,isArray:!0}}}),u=new t({name:"DatabaseRelationalQueryInput",fields:{sourceKey:{type:e.NonEmptyString(),isOptional:!1},resource:{type:a,isOptional:!1},select:{type:i,isOptional:!1,isArray:!0},filters:{type:r,isOptional:!1,isArray:!0},sort:{type:c,isOptional:!1,isArray:!0},pagination:{type:e.JSONObject(),isOptional:!1},relations:{type:y,isOptional:!1,isArray:!0},policyRefs:{type:e.JSONObject(),isOptional:!0,isArray:!0}}}),f=new t({name:"DatabaseRelationalQueryOutput",fields:{data:{type:e.JSONObject(),isOptional:!1,isArray:!0},pageInfo:{type:e.JSONObject(),isOptional:!0},versionToken:{type:e.String_unsecure(),isOptional:!0},economicEvidenceRefs:{type:e.String_unsecure(),isOptional:!0,isArray:!0}}});export const DatabaseRelationalQueryDocBlock={id:"docs.tech.database.query.relational",title:"Governed relational read",summary:"Perform a governed relational read that nests FK children per root row.",kind:"reference",visibility:"public",route:"/docs/tech/database/query/relational",tags:["database","query","relational"],body:`# database.query.relational
+
+Executes a governed relational read over the portable database context. The root
+resource selects its allowlisted columns and each declared relation is projected
+as a nested children array via a fail-closed parent→child join. Mirrors the
+provider-database \`GovernedRelationalReadDescriptor\` builder (eq-only filters,
+identifier allowlisting). Additive to \`database.query.readonly\`; it never
+mutates state and returns a \`QueryResultEnvelope\`-shaped result.
+`},DatabaseRelationalQuery=l({meta:{key:"database.query.relational",title:"Governed Relational Read",version:"1.0.0",description:"Execute a governed relational read that nests FK children per root row.",goal:"Allow safe, policy-gated relational retrieval with nested relations.",context:"Compiles a spec-derived relational descriptor into one governed statement.",domain:n,owners:s,tags:[...d,"query","relational"],stability:p,docId:[o(DatabaseRelationalQueryDocBlock.id)]},capability:{key:"database.context",version:"2.0.0"},io:{input:u,output:f,errors:{VALIDATION:{description:"Descriptor shape, non-selectable field, or non-eq filter was rejected.",http:400,when:"Caller supplied a malformed or ungoverned relational descriptor."},FORBIDDEN:{description:"Policy/role projection rejected the relational read.",http:403,when:"Active persona lacks capability for the requested resource."},DEPENDENCY:{description:"Underlying database context is unavailable.",http:503,when:"Provider/read-model not reachable; retry with backoff."}}},policy:{auth:"admin",pii:["data"]}});

package/dist/node/database/queries/databaseSchemaDescribe.query.js

@@ -0,0 +1,4 @@
+import{ScalarTypeEnum as e,SchemaModel as a}from"@lssm/lib.schema";import{docRef as t}from"../../docs/registry.js";import{defineQuery as s}from"../../operations/index.js";import{DATABASE_DOMAIN as i,DATABASE_OWNERS as r,DATABASE_STABILITY as n,DATABASE_TAGS as c}from"../constants.js";const o=new a({name:"DatabaseSchemaDescribeInput",fields:{databaseKey:{type:e.NonEmptyString(),isOptional:!1},schemaKey:{type:e.String_unsecure(),isOptional:!0},schemaVersion:{type:e.String_unsecure(),isOptional:!0},includeModels:{type:e.Boolean(),isOptional:!0},targetDialect:{type:e.String_unsecure(),isOptional:!0}}}),u=new a({name:"DatabaseModelSummary",fields:{name:{type:e.String_unsecure(),isOptional:!1},fieldCount:{type:e.Int_unsecure(),isOptional:!0},relationCount:{type:e.Int_unsecure(),isOptional:!0},piiFields:{type:e.Int_unsecure(),isOptional:!0},tableName:{type:e.String_unsecure(),isOptional:!0},schemaName:{type:e.String_unsecure(),isOptional:!0}}}),p=new a({name:"DatabaseSchemaSummary",fields:{databaseKey:{type:e.String_unsecure(),isOptional:!1},schemaKey:{type:e.String_unsecure(),isOptional:!1},version:{type:e.String_unsecure(),isOptional:!1},description:{type:e.String_unsecure(),isOptional:!0},targetDialect:{type:e.String_unsecure(),isOptional:!1},modelCount:{type:e.Int_unsecure(),isOptional:!0},models:{type:u,isOptional:!0,isArray:!0},updatedAt:{type:e.DateTime(),isOptional:!0}}}),m=new a({name:"DatabaseSchemaDescribeOutput",fields:{schemas:{type:p,isOptional:!1,isArray:!0}}});export const DatabaseSchemaDescribeDocBlock={id:"docs.tech.database.schema.describe",title:"Describe database schema",summary:"Describe schemas and models with PII signals.",kind:"reference",visibility:"public",route:"/docs/tech/database/schema/describe",tags:["database","schema"],body:`# database.schema.describe
+
+Returns portable database schema/entity summaries for agents and operators, with PostgreSQL target metadata when available.
+`},DatabaseSchemaDescribeQuery=s({meta:{key:"database.schema.describe",title:"Describe Database Schema",version:"2.0.0",description:"Describe database schemas and models with PII indicators.",goal:"Provide deterministic schema context for agents and operators.",context:"Used before live data access to ensure schema awareness and policy checks.",domain:i,owners:r,tags:[...c,"describe"],stability:n,docId:[t(DatabaseSchemaDescribeDocBlock.id)]},capability:{key:"database.context",version:"2.0.0"},io:{input:o,output:m},policy:{auth:"admin",pii:[]}});

package/dist/node/database/queries/index.js

@@ -0,0 +1 @@
+export*from"./databaseDictionaryGet.query.js";export*from"./databaseMigrationsList.query.js";export*from"./databaseQueryReadonly.query.js";export*from"./databaseRelationalQuery.query.js";export*from"./databaseSchemaDescribe.query.js";

package/dist/node/database/tables/capabilityEdges.table.js

@@ -0,0 +1 @@
+import{registerDatabaseTable as e}from"./databaseTables.js";export const CapabilityEdgesTableSpec=e({name:"managed_companyos_capability_edges",columns:[{name:"id",type:"text",nullable:!1},{name:"tenant_id",type:"text",nullable:!1},{name:"workspace_id",type:"text",nullable:!1},{name:"from_capability_id",type:"text",nullable:!1},{name:"to_capability_id",type:"text",nullable:!1},{name:"relation",type:"text",nullable:!1},{name:"created_at",type:"timestamptz",nullable:!1,default:"now()"}],primaryKey:["id"],foreignKeys:[{relationKey:"workspace",columns:["workspace_id"],referencesTable:"managed_companyos_workspaces",referencesColumns:["workspace_id"]}],tenantColumn:"tenant_id"});

package/dist/node/database/tables/capabilityNodes.table.js

@@ -0,0 +1 @@
+import{registerDatabaseTable as e}from"./databaseTables.js";export const CapabilityNodesTableSpec=e({name:"managed_companyos_capability_nodes",columns:[{name:"id",type:"text",nullable:!1},{name:"tenant_id",type:"text",nullable:!1},{name:"workspace_id",type:"text",nullable:!1},{name:"capability_id",type:"text",nullable:!1},{name:"kind",type:"text",nullable:!1},{name:"label",type:"text",nullable:!1},{name:"status",type:"text",nullable:!1},{name:"policy_reason",type:"text",nullable:!1},{name:"source_refs",type:"jsonb",nullable:!1},{name:"redaction_level",type:"text",nullable:!1},{name:"created_at",type:"timestamptz",nullable:!1,default:"now()"},{name:"updated_at",type:"timestamptz",nullable:!1,default:"now()"}],primaryKey:["id"],foreignKeys:[{relationKey:"workspace",columns:["workspace_id"],referencesTable:"managed_companyos_workspaces",referencesColumns:["workspace_id"]}],tenantColumn:"tenant_id"});

package/dist/node/database/tables/databaseTables.js

@@ -0,0 +1 @@
+import{ScalarTypeEnum as t,SchemaModel as r}from"@lssm/lib.schema";export const DatabaseColumnSpecModel=new r({name:"DatabaseColumnSpec",description:"A single physical column declaration.",fields:{name:{type:t.NonEmptyString(),isOptional:!1},type:{type:t.NonEmptyString(),isOptional:!1},nullable:{type:t.Boolean(),isOptional:!1},default:{type:t.String_unsecure(),isOptional:!0},enumValues:{type:t.NonEmptyString(),isOptional:!0,isArray:!0}}}),DatabaseForeignKeySpecModel=new r({name:"DatabaseForeignKeySpec",description:"A foreign-key relation to a parent table.",fields:{relationKey:{type:t.String_unsecure(),isOptional:!0},columns:{type:t.NonEmptyString(),isOptional:!1,isArray:!0},referencesTable:{type:t.NonEmptyString(),isOptional:!1},referencesColumns:{type:t.NonEmptyString(),isOptional:!1,isArray:!0}}}),DatabaseUniqueConstraintSpecModel=new r({name:"DatabaseUniqueConstraintSpec",description:"A unique constraint over declared table columns.",fields:{name:{type:t.NonEmptyString(),isOptional:!1},columns:{type:t.NonEmptyString(),isOptional:!1,isArray:!0}}}),DatabaseTableSpecModel=new r({name:"DatabaseTableSpec",description:"Canonical, locale-free declaration of a single physical table.",fields:{name:{type:t.NonEmptyString(),isOptional:!1},schema:{type:t.String_unsecure(),isOptional:!0},columns:{type:DatabaseColumnSpecModel,isOptional:!1,isArray:!0},primaryKey:{type:t.NonEmptyString(),isOptional:!1,isArray:!0},foreignKeys:{type:DatabaseForeignKeySpecModel,isOptional:!1,isArray:!0},uniqueConstraints:{type:DatabaseUniqueConstraintSpecModel,isOptional:!0,isArray:!0},tenantColumn:{type:t.NonEmptyString(),isOptional:!1}}}),DatabaseUnscopedTableSpecModel=new r({name:"DatabaseUnscopedTableSpec",description:"Physical table whose authority is enforced outside an intrinsic tenant column.",fields:{name:{type:t.NonEmptyString(),isOptional:!1},schema:{type:t.String_unsecure(),isOptional:!0},columns:{type:DatabaseColumnSpecModel,isOptional:!1,isArray:!0},primaryKey:{type:t.NonEmptyString(),isOptional:!1,isArray:!0},foreignKeys:{type:DatabaseForeignKeySpecModel,isOptional:!1,isArray:!0},uniqueConstraints:{type:DatabaseUniqueConstraintSpecModel,isOptional:!0,isArray:!0}}});const i=(a,e)=>{const s=new Set(a.columns.map((n)=>n.name));if("tenantColumn"in a&&(!a.tenantColumn||!s.has(a.tenantColumn)))e.addIssue({code:"custom",path:["tenantColumn"],message:`DatabaseTableSpec.tenantColumn must reference a declared column: ${a.tenantColumn}`});for(const n of a.primaryKey)if(!s.has(n))e.addIssue({code:"custom",path:["primaryKey"],message:`DatabaseTableSpec.primaryKey references unknown column: ${n}`});const p=a.foreignKeys;for(const n of p)for(const o of n.columns)if(!s.has(o))e.addIssue({code:"custom",path:["foreignKeys"],message:`DatabaseTableSpec.foreignKeys references unknown column: ${o}`});const u=a.uniqueConstraints;for(const n of u??[])for(const o of n.columns)if(!s.has(o))e.addIssue({code:"custom",path:["uniqueConstraints"],message:`DatabaseTableSpec.uniqueConstraints references unknown column: ${o}`})},b=DatabaseTableSpecModel.getZod().superRefine(i),d=DatabaseUnscopedTableSpecModel.getZod().superRefine(i);export const defineDatabaseTable=(a)=>{const e=b.safeParse(a);if(!e.success){const[s]=e.error.issues;throw Error(s?.message??"DatabaseTableSpec failed validation")}return e.data},defineUnscopedDatabaseTable=(a)=>{const e=d.safeParse(a);if(!e.success){const[s]=e.error.issues;throw Error(s?.message??"DatabaseUnscopedTableSpec failed validation")}return e.data};const l=new Map,c=new Map;export const registerDatabaseTable=(a)=>{const e=defineDatabaseTable(a);l.set(e.name,e);return e},getDatabaseTable=(a)=>l.get(a),listDatabaseTables=()=>Array.from(l.values()),registerUnscopedDatabaseTable=(a)=>{const e=defineUnscopedDatabaseTable(a);c.set(e.name,e);return e},listUnscopedDatabaseTables=()=>Array.from(c.values()),listPhysicalDatabaseTables=()=>[...listDatabaseTables(),...listUnscopedDatabaseTables()],DatabaseTablesDocBlock={id:"docs.tech.database.tables",title:"defineDatabaseTable — physical-table contracts",summary:"Spec-first declaration of physical tables (columns, PK, FK, tenantColumn).",kind:"reference",visibility:"public",route:"/docs/tech/database/tables",tags:["database","tables","schema","tenant"],body:"# defineDatabaseTable\n\nSpec-first physical-table contracts. Each `DatabaseTableSpec` declares columns\n(type/nullable/default), primary key, foreign-key relations, and the mandatory\n`tenantColumn` anchoring row-level tenant isolation.\n\nUse `defineUnscopedDatabaseTable` when a physical table has no intrinsic\ntenant column and authority is enforced through an owning relation or an\napplication-global boundary. RLS generators must omit these tables rather than\ninventing tenant authority. Text columns may declare `enumValues` so generated\nDrizzle models preserve the closed TypeScript vocabulary.\n\n- Declared as the `DatabaseTableSpecModel` `SchemaModel`; the TS shape is its\n  Zod-inferred form.\n- `defineDatabaseTable(spec)` is fail-closed: it rejects a missing/empty\n  `tenantColumn`, a `tenantColumn` absent from `columns`, and PK/FK columns\n  that reference unknown columns.\n- `registerDatabaseTable`/`listDatabaseTables` expose the canonical registry\n  that the Drizzle generator (F2) and relational read-model (F3) compile against.\n- `listPhysicalDatabaseTables` adds explicitly registered unscoped tables for\n  consumers that need a complete typed query model.\n"};

package/dist/node/database/tables/index.js

@@ -0,0 +1 @@
+export*from"./capabilityEdges.table.js";export*from"./capabilityNodes.table.js";export*from"./databaseTables.js";export*from"./organizationGrants.table.js";export*from"./organizationTenantBindings.table.js";export*from"./workspaces.table.js";

package/dist/node/database/tables/organizationGrants.table.js

@@ -0,0 +1 @@
+import{registerDatabaseTable as e}from"./databaseTables.js";export const OrganizationGrantsTableSpec=e({name:"managed_companyos_organization_grants",columns:[{name:"id",type:"text",nullable:!1},{name:"tenant_id",type:"text",nullable:!1},{name:"organization_id",type:"text",nullable:!1},{name:"binding_id",type:"text",nullable:!1},{name:"user_id",type:"text",nullable:!1},{name:"role",type:"text",nullable:!1},{name:"capabilities",type:"jsonb",nullable:!1,default:"'[]'::jsonb"},{name:"status",type:"text",nullable:!1,default:"'disabled'"},{name:"authority_version",type:"bigint",nullable:!1,default:"1"},{name:"manifest_revision",type:"text",nullable:!1},{name:"provenance_review_ref",type:"text",nullable:!1},{name:"created_at",type:"timestamptz",nullable:!1,default:"now()"},{name:"updated_at",type:"timestamptz",nullable:!1,default:"now()"}],primaryKey:["id"],foreignKeys:[{relationKey:"organizationTenantBinding",columns:["tenant_id","binding_id","organization_id"],referencesTable:"managed_companyos_organization_tenant_bindings",referencesColumns:["tenant_id","id","organization_id"]}],uniqueConstraints:[{name:"managed_companyos_organization_grants_org_user_key",columns:["organization_id","user_id"]},{name:"managed_companyos_organization_grants_tenant_id_id_key",columns:["tenant_id","id"]}],tenantColumn:"tenant_id"});

package/dist/node/database/tables/organizationTenantBindings.table.js

@@ -0,0 +1 @@
+import{registerDatabaseTable as e}from"./databaseTables.js";export const OrganizationTenantBindingsTableSpec=e({name:"managed_companyos_organization_tenant_bindings",columns:[{name:"id",type:"text",nullable:!1},{name:"tenant_id",type:"text",nullable:!1},{name:"organization_id",type:"text",nullable:!1},{name:"organization_slug_snapshot",type:"text",nullable:!1},{name:"status",type:"text",nullable:!1,default:"'disabled'"},{name:"authority_version",type:"bigint",nullable:!1,default:"1"},{name:"manifest_revision",type:"text",nullable:!1},{name:"audit_ref",type:"text",nullable:!0},{name:"replay_ref",type:"text",nullable:!0},{name:"created_at",type:"timestamptz",nullable:!1,default:"now()"},{name:"updated_at",type:"timestamptz",nullable:!1,default:"now()"}],primaryKey:["id"],foreignKeys:[],uniqueConstraints:[{name:"managed_companyos_org_tenant_bindings_organization_key",columns:["organization_id"]},{name:"managed_companyos_org_tenant_bindings_tenant_key",columns:["tenant_id"]},{name:"managed_companyos_org_tenant_bindings_identity_key",columns:["tenant_id","id","organization_id"]}],tenantColumn:"tenant_id"});

package/dist/node/database/tables/workspaces.table.js

@@ -0,0 +1 @@
+import{registerDatabaseTable as e}from"./databaseTables.js";export const WorkspacesTableSpec=e({name:"managed_companyos_workspaces",columns:[{name:"id",type:"text",nullable:!1},{name:"tenant_id",type:"text",nullable:!1},{name:"workspace_id",type:"text",nullable:!1},{name:"display_name",type:"text",nullable:!1},{name:"customer_name",type:"text",nullable:!1},{name:"region",type:"text",nullable:!1},{name:"locale",type:"text",nullable:!1},{name:"lifecycle_status",type:"text",nullable:!1},{name:"default_capability_set",type:"jsonb",nullable:!1},{name:"created_at",type:"timestamptz",nullable:!1,default:"now()"},{name:"updated_at",type:"timestamptz",nullable:!1,default:"now()"}],primaryKey:["id"],foreignKeys:[],tenantColumn:"tenant_id"});

package/dist/node/database/views/databaseSchemas.dataView.js

@@ -0,0 +1,4 @@
+import{defineDataView as s}from"../../data-views/index.js";import{docRef as l}from"../../docs/registry.js";import{defineTranslation as i}from"../../translations/index.js";import{DATABASE_DOMAIN as e,DATABASE_OWNERS as a,DATABASE_STABILITY as d,DATABASE_TAGS as o}from"../constants.js";import{DatabaseSchemaDescribeQuery as t}from"../queries/databaseSchemaDescribe.query.js";const m=i({meta:{key:"database.schema.index.i18n",version:"1.0.0",domain:e,owners:a},locale:"en",messages:{"field.databaseKey.label":{value:"Database"},"field.schemaKey.label":{value:"Schema"},"field.version.label":{value:"Version"},"field.modelCount.label":{value:"Models"},"field.updatedAt.label":{value:"Updated"},"filter.databaseKey.label":{value:"Database"},"filter.schemaKey.label":{value:"Schema"}}});export const DatabaseSchemasDataViewDocBlock={id:"docs.tech.database.schema.index",title:"Database schema index view",summary:"Data view for listing schemas and model counts.",kind:"reference",visibility:"public",route:"/docs/tech/database/schema/index",tags:["database","data-view"],body:`# database.schema.index
+
+List view for database schemas and their metadata.
+`},DatabaseSchemasDataView=s(m,{meta:{key:"database.schema.index",title:"Database Schemas",version:"2.0.0",description:"List database schemas and model counts.",domain:e,owners:a,tags:[...o,"schema","index"],stability:d,entity:"database_schema",docId:[l(DatabaseSchemasDataViewDocBlock.id)]},source:{primary:{key:t.meta.key,version:t.meta.version}},view:{kind:"list",fields:[{key:"databaseKey",label:"field.databaseKey.label",dataPath:"databaseKey"},{key:"schemaKey",label:"field.schemaKey.label",dataPath:"schemaKey"},{key:"version",label:"field.version.label",dataPath:"version"},{key:"modelCount",label:"field.modelCount.label",dataPath:"modelCount"},{key:"updatedAt",label:"field.updatedAt.label",dataPath:"updatedAt"}],primaryField:"schemaKey",secondaryFields:["databaseKey","version"],filters:[{key:"databaseKey",label:"filter.databaseKey.label",field:"databaseKey",type:"search"},{key:"schemaKey",label:"filter.schemaKey.label",field:"schemaKey",type:"search"}]},policy:{flags:[],pii:[]}});

package/dist/node/database/views/index.js

@@ -0,0 +1 @@
+export*from"./databaseSchemas.dataView.js";

package/dist/node/decisioning/decisioning.feature.js

@@ -0,0 +1,5 @@
+import{defineFeature as i}from"../features/index.js";import{decisionEvaluationEvents as n}from"./evaluation-events.js";import{decisionLifecycleEvents as o}from"./lifecycle-events.js";import{DecisionLifecycleDocBlock as s}from"./lifecycle-operations.js";import{decisionOperations as t,decisionOperationsV2 as r}from"./operations.js";export const DecisionOperationsDocBlock={id:"decision-operations-v1",title:"Decision operations v1",summary:"Deterministic, serializable decision graphs shared by Forms, SOPs, support, and workflows.",kind:"reference",visibility:"public",route:"/docs/platform/decision-operations-v1",tags:["decisioning","forms","workflow","support"],body:`# Decision operations v1
+
+DecisionGraph is a pure, revision-pinned DAG. It evaluates typed predicates and produces replay traces; it never executes creator code or business effects.`},DecisionOperationsV2DocBlock={id:"decision-operations-v2",title:"Decision operations v2",summary:"Strict, deterministic, revision-pinned decision validation, simulation, evaluation, replay, comparison, and redacted evidence administration.",kind:"reference",visibility:"public",route:"/docs/platform/decision-operations-v2",tags:["decisioning","forms","workflow","support"],body:`# Decision operations v2
+
+DecisionGraph is a pure, revision-pinned DAG. V2 operations use strict typed envelopes and stable idempotency keys. Evidence-producing validation, simulation, evaluation, replay, and comparison never execute creator code or business effects. Evidence list and detail queries expose digest-bound traces and engine provenance through opaque fixed-watermark pagination without protected inputs, outcome payload data, or authority scope. V1 remains available through its original aggregate and feature identity during migration.`},DecisionOperationsFeature=i({meta:{key:"decision-operations-v1",version:"1.0.0",title:"Decision Operations v1",description:"Typed predicates and deterministic decision graphs.",domain:"decisioning",owners:["platform.core"],tags:["decisioning","workflow","forms"],stability:"experimental"},operations:t.map((e)=>({key:e.meta.key,version:e.meta.version})),events:o.map((e)=>({key:e.meta.key,version:e.meta.version})),docs:[DecisionOperationsDocBlock.id,s.id]}),DecisionOperationsFeatureV2=i({meta:{key:"decision-operations-v2",version:"2.0.0",title:"Decision Operations v2",description:"Strict typed predicates, deterministic evaluation, and immutable evidence.",domain:"decisioning",owners:["platform.core"],tags:["decisioning","workflow","forms","evidence"],stability:"experimental"},operations:r.map((e)=>({key:e.meta.key,version:e.meta.version})),events:[...o,...n].map((e)=>({key:e.meta.key,version:e.meta.version})),docs:[DecisionOperationsV2DocBlock.id,s.id]});

package/dist/node/decisioning/evaluation-events.d.js

@@ -0,0 +1 @@
+export{};

package/dist/node/decisioning/evaluation-events.js

@@ -0,0 +1 @@
+import{EnumType as a,ScalarTypeEnum as t,SchemaModel as d}from"@lssm/lib.schema";import{defineEvent as c}from"../events.js";const l=new a("DecisionEvaluationEventStatusV2",["valid","invalid","completed","no-match","limit-exceeded","matched","mismatched","equal","changed"]),p={graphRef:{type:t.ID(),isOptional:!1},revision:{type:t.Int_unsecure(),isOptional:!1},evidenceRef:{type:t.ID(),isOptional:!1},status:{type:l,isOptional:!1},digest:{type:t.String_unsecure(),isOptional:!1},relatedRevision:{type:t.Int_unsecure(),isOptional:!0},evaluationRef:{type:t.ID(),isOptional:!0},outcomeKey:{type:t.String_unsecure(),isOptional:!0}};export const DecisionEvaluationEventPayloadModelV2=new class extends d{getZod(){return super.getZod().strict().superRefine((o,n)=>{for(const e of["graphRef","evidenceRef","evaluationRef"]){const i=o[e];if(i!==void 0&&(!i.trim()||i.length>200))n.addIssue({code:"custom",path:[e],message:`${e} must be bounded`})}for(const e of["revision","relatedRevision"]){const i=o[e];if(i!==void 0&&(!Number.isSafeInteger(i)||i<1))n.addIssue({code:"custom",path:[e],message:`${e} must be positive`})}if(typeof o.digest!=="string"||!/^(?:sha256:)?[a-f0-9]{64}$/i.test(o.digest))n.addIssue({code:"custom",path:["digest"],message:"digest must be SHA-256"})})}}({name:"DecisionEvaluationEventPayloadV2",fields:p});const s=(o,n)=>c({meta:{key:o,version:"2.0.0",title:n,description:n,domain:"decisioning",owners:["platform.core"],tags:["decisioning","evaluation","evidence"],stability:"experimental"},payload:DecisionEvaluationEventPayloadModelV2,pii:[]});export const DecisionValidationCompletedEventV2=s("decision.validation.completed","Decision validation completed"),DecisionSimulationCompletedEventV2=s("decision.simulation.completed","Decision simulation completed"),DecisionEvaluationCompletedEventV2=s("decision.evaluation.completed","Decision evaluation completed"),DecisionReplayVerifiedEventV2=s("decision.replay.verified","Decision replay verified"),DecisionRevisionsComparedEventV2=s("decision.revisions.compared","Decision revisions compared"),decisionEvaluationEvents=[DecisionValidationCompletedEventV2,DecisionSimulationCompletedEventV2,DecisionEvaluationCompletedEventV2,DecisionReplayVerifiedEventV2,DecisionRevisionsComparedEventV2];

package/dist/node/decisioning/evaluation-evidence-administration-operations.js

@@ -0,0 +1 @@
+import{defineQuery as e}from"../operations/index.js";import{DecisionEvidenceDetailModelV2 as t,DecisionEvidenceGetInputModelV2 as n,DecisionEvidenceListInputModelV2 as s,DecisionEvidenceListOutputModelV2 as c}from"./evaluation-evidence-administration-schemas.js";import{decisionOperationErrorsV2 as i,decisionOperationMetaV2 as o}from"./operation-metadata.js";export const DecisionEvidenceGetQueryV2=e({meta:o("decision.evidence.get","Get decision evaluation evidence"),io:{input:n,output:t,errors:i},policy:{auth:"user",pii:[]}}),DecisionEvidenceListQueryV2=e({meta:o("decision.evidence.list","List decision evaluation evidence"),io:{input:s,output:c,errors:i},policy:{auth:"user",pii:[]}}),decisionEvidenceAdministrationOperations=[DecisionEvidenceGetQueryV2,DecisionEvidenceListQueryV2];

package/dist/node/decisioning/evaluation-evidence-administration-schemas.d.js

@@ -0,0 +1 @@
+export{};

package/dist/node/decisioning/evaluation-evidence-administration-schemas.js

@@ -0,0 +1 @@
+import{ScalarTypeEnum as t,SchemaModel as a}from"@lssm/lib.schema";import{DecisionGraphRefOutputModelV2 as l}from"./evaluation-output-primitives.js";import{validDecisionDigest as s,validDecisionPolicyVersion as p,validDecisionPredicateVersion as c,validDecisionRef as n,validDecisionRuntimeVersion as u,validDecisionTimestamp as o}from"./evaluation-schema-validation.js";import{DecisionTraceOutputModelV2 as m}from"./evaluation-trace-output-schema.js";class i extends a{getZod(){return super.getZod().strict()}}const y={evaluationRef:{type:t.ID(),isOptional:!1}};export const DecisionEvidenceGetInputModelV2=new class extends i{getZod(){return super.getZod().refine((e)=>n(e.evaluationRef),{message:"evaluationRef must be canonical and bounded"})}}({name:"DecisionEvidenceGetInputV2",fields:y});const g={graphRef:{type:t.ID(),isOptional:!0},limit:{type:t.Int_unsecure(),isOptional:!1},cursor:{type:t.ID(),isOptional:!0}};export const DecisionEvidenceListInputModelV2=new class extends i{getZod(){return super.getZod().refine((e)=>typeof e.limit==="number"&&Number.isSafeInteger(e.limit)&&e.limit>=1&&e.limit<=100&&(e.graphRef===void 0||n(e.graphRef))&&(e.cursor===void 0||n(e.cursor)),{message:"evidence list input must be canonical and bounded"})}}({name:"DecisionEvidenceListInputV2",fields:g});const r={evaluationRef:{type:t.ID(),isOptional:!1},graph:{type:l,isOptional:!1},status:{type:t.String_unsecure(),isOptional:!1},outcomeKey:{type:t.String_unsecure(),isOptional:!0},inputDigest:{type:t.String_unsecure(),isOptional:!1},evaluationDigest:{type:t.String_unsecure(),isOptional:!1},recordedAt:{type:t.String_unsecure(),isOptional:!1},runtimeVersion:{type:t.String_unsecure(),isOptional:!1},predicateVersion:{type:t.String_unsecure(),isOptional:!1},policyVersion:{type:t.String_unsecure(),isOptional:!1}};function d(e){return n(e.evaluationRef)&&e.status!==void 0&&["completed","no-match","limit-exceeded"].includes(e.status)&&(e.status==="completed"?e.outcomeKey!==void 0&&Boolean(e.outcomeKey.trim())&&e.outcomeKey.length<=200:e.outcomeKey===void 0)&&s(e.inputDigest)&&s(e.evaluationDigest)&&o(e.recordedAt)&&u(e.runtimeVersion)&&c(e.predicateVersion)&&p(e.policyVersion)}export const DecisionEvidenceSummaryModelV2=new class extends i{getZod(){return super.getZod().refine((e)=>d(e),{message:"evidence summary must be canonical and bounded"})}}({name:"DecisionEvidenceSummaryV2",fields:r});const f={...r,trace:{type:m,isOptional:!1}};export const DecisionEvidenceDetailModelV2=new class extends i{getZod(){return super.getZod().refine((e)=>d(e)&&e.graph!==void 0&&e.trace!==void 0&&e.graph.key===e.trace.graph.key&&e.graph.revision===e.trace.graph.revision&&e.graph.digest===e.trace.graph.digest&&e.inputDigest===e.trace.inputDigest,{message:"evidence detail must be canonical, bounded, and trace-bound"})}}({name:"DecisionEvidenceDetailV2",fields:f});const D={items:{type:DecisionEvidenceSummaryModelV2,isOptional:!1,isArray:!0},nextCursor:{type:t.ID(),isOptional:!0},watermark:{type:t.String_unsecure(),isOptional:!1}};export const DecisionEvidenceListOutputModelV2=new class extends i{getZod(){return super.getZod().refine((e)=>(e.items?.length??101)<=100&&(e.nextCursor===void 0||n(e.nextCursor))&&o(e.watermark),{message:"evidence list output must be bounded and timestamped"})}}({name:"DecisionEvidenceListOutputV2",fields:D});

package/dist/node/decisioning/evaluation-evidence-output-schemas.d.js

@@ -0,0 +1 @@
+export{};

package/dist/node/decisioning/evaluation-evidence-output-schemas.js

@@ -0,0 +1 @@
+import{ScalarTypeEnum as s,SchemaModel as c}from"@lssm/lib.schema";import{DecisionEvaluationOutputModelV2 as y,DecisionGraphRefOutputModelV2 as d}from"./evaluation-output-primitives.js";import{validDecisionDigest as a,validDecisionRef as t,validDecisionTimestamp as r}from"./evaluation-schema-validation.js";class i extends c{getZod(){return super.getZod().strict()}}const f={evaluationRef:{type:s.ID(),isOptional:!1},replayRef:{type:s.ID(),isOptional:!1},matched:{type:s.Boolean(),isOptional:!1},originalEvaluationDigest:{type:s.String_unsecure(),isOptional:!1},replayEvaluationDigest:{type:s.String_unsecure(),isOptional:!1},result:{type:y,isOptional:!1},replayedAt:{type:s.String_unsecure(),isOptional:!1},evidenceRef:{type:s.ID(),isOptional:!1}};export const DecisionReplayOutputModelV2=new class extends i{getZod(){return super.getZod().refine((e)=>t(e.evaluationRef)&&t(e.replayRef)&&e.replayRef===e.evidenceRef&&a(e.originalEvaluationDigest)&&a(e.replayEvaluationDigest)&&e.matched===(e.originalEvaluationDigest===e.replayEvaluationDigest)&&r(e.replayedAt),{message:"replay evidence must be canonical, consistent, and timestamped"})}}({name:"DecisionReplayOutputV2",fields:f});const g={graphKey:{type:s.ID(),isOptional:!1},from:{type:d,isOptional:!1},to:{type:d,isOptional:!1},equal:{type:s.Boolean(),isOptional:!1},addedNodeIds:{type:s.ID(),isOptional:!1,isArray:!0},removedNodeIds:{type:s.ID(),isOptional:!1,isArray:!0},changedNodeIds:{type:s.ID(),isOptional:!1,isArray:!0},addedEdgeIds:{type:s.ID(),isOptional:!1,isArray:!0},removedEdgeIds:{type:s.ID(),isOptional:!1,isArray:!0},changedEdgeIds:{type:s.ID(),isOptional:!1,isArray:!0},changedDocumentFields:{type:s.String_unsecure(),isOptional:!1,isArray:!0},comparedAt:{type:s.String_unsecure(),isOptional:!1},evidenceRef:{type:s.ID(),isOptional:!1}};export const DecisionCompareOutputModelV2=new class extends i{getZod(){return super.getZod().refine((e)=>t(e.graphKey)&&e.graphKey===l(e.from)&&e.graphKey===l(e.to)&&r(e.comparedAt)&&t(e.evidenceRef)&&n(e).length<=20000&&n(e).every(t)&&p(e).every(u)&&(e.changedDocumentFields??[]).every((o)=>m.has(o))&&e.equal===(n(e).length===0&&(e.changedDocumentFields?.length??0)===0),{message:"comparison evidence must be canonical, unique, bounded, and timestamped"})}}({name:"DecisionCompareOutputV2",fields:g});const m=new Set(["entryNodeId","version","policy","defaultLocale","localeCatalogs"]);function p(e){return[e.addedNodeIds??[],e.removedNodeIds??[],e.changedNodeIds??[],e.addedEdgeIds??[],e.removedEdgeIds??[],e.changedEdgeIds??[]]}function n(e){return p(e).flat()}function u(e){return new Set(e).size===e.length}function l(e){if(!e||typeof e!=="object")return;const o=e.key;return typeof o==="string"?o:void 0}

package/dist/node/decisioning/evaluation-input-schemas.d.js

@@ -0,0 +1 @@
+export{};

package/dist/node/decisioning/evaluation-input-schemas.js

@@ -0,0 +1 @@
+import{ScalarTypeEnum as s,SchemaModel as a}from"@lssm/lib.schema";function o(e,i,t){const n=e[t];if(typeof n!=="string"||!n.trim()||n.length>200||!/^[A-Za-z0-9][A-Za-z0-9._:-]*$/.test(n))i.addIssue({code:"custom",path:[t],message:`${t} must be a canonical bounded identifier`})}function p(e,i,t){const n=e[t];if(typeof n!=="number"||!Number.isSafeInteger(n)||n<1)i.addIssue({code:"custom",path:[t],message:`${t} must be a positive safe integer`})}const d={graphRef:{type:s.ID(),isOptional:!1},revision:{type:s.Int_unsecure(),isOptional:!1},idempotencyKey:{type:s.ID(),isOptional:!1}};export const DecisionRevisionInputModelV2=new class extends a{getZod(){return super.getZod().strict().superRefine((e,i)=>{o(e,i,"graphRef");p(e,i,"revision");o(e,i,"idempotencyKey")})}}({name:"DecisionRevisionInputV2",fields:d});const r={...d,inputs:{type:s.JSONObject(),isOptional:!1}};export const DecisionSimulationInputModelV2=new class extends a{getZod(){return super.getZod().strict().superRefine((e,i)=>{o(e,i,"graphRef");p(e,i,"revision");o(e,i,"idempotencyKey")})}}({name:"DecisionSimulationInputV2",fields:r});const l={...r};export const DecisionEvaluationInputModelV2=new class extends a{getZod(){return super.getZod().strict().superRefine((e,i)=>{o(e,i,"graphRef");p(e,i,"revision");o(e,i,"idempotencyKey")})}}({name:"DecisionEvaluationInputV2",fields:l});const c={evaluationRef:{type:s.ID(),isOptional:!1},idempotencyKey:{type:s.ID(),isOptional:!1},expectedEvaluationDigest:{type:s.String_unsecure(),isOptional:!1}};export const DecisionReplayInputModelV2=new class extends a{getZod(){return super.getZod().strict().superRefine((e,i)=>{o(e,i,"evaluationRef");o(e,i,"idempotencyKey");const t=e.expectedEvaluationDigest;if(typeof t!=="string"||!/^[a-f0-9]{64}$/i.test(t))i.addIssue({code:"custom",path:["expectedEvaluationDigest"],message:"expectedEvaluationDigest must be a SHA-256 digest"})})}}({name:"DecisionReplayInputV2",fields:c});const u={graphRef:{type:s.ID(),isOptional:!1},fromRevision:{type:s.Int_unsecure(),isOptional:!1},toRevision:{type:s.Int_unsecure(),isOptional:!1},idempotencyKey:{type:s.ID(),isOptional:!1}};export const DecisionCompareInputModelV2=new class extends a{getZod(){return super.getZod().strict().superRefine((e,i)=>{o(e,i,"graphRef");p(e,i,"fromRevision");p(e,i,"toRevision");o(e,i,"idempotencyKey")})}}({name:"DecisionCompareInputV2",fields:u});

package/dist/node/decisioning/evaluation-output-primitives.d.js

@@ -0,0 +1 @@
+export*from"./evaluation-trace-output-schema.js";

package/dist/node/decisioning/evaluation-output-primitives.js

@@ -0,0 +1 @@
+import{EnumType as o,ScalarTypeEnum as t,SchemaModel as d}from"@lssm/lib.schema";import{validDecisionDigest as p,validDecisionRef as r,validPositiveRevision as l}from"./evaluation-schema-validation.js";import{DecisionTraceOutputModelV2 as c}from"./evaluation-trace-output-schema.js";import{DECISION_GRAPH_DIAGNOSTIC_CODES as u}from"./validation.js";export*from"./evaluation-trace-output-schema.js";class i extends d{getZod(){return super.getZod().strict()}}const g={key:{type:t.ID(),isOptional:!1},revision:{type:t.Int_unsecure(),isOptional:!1},digest:{type:t.String_unsecure(),isOptional:!1}};class s extends i{getZod(){return super.getZod().refine((e)=>r(e.key)&&l(e.revision)&&p(e.digest),{message:"graph reference must be canonical, positive, and digest-pinned"})}}export const DecisionGraphRefOutputModelV2=new s({name:"DecisionGraphRefOutputV2",fields:g});const m={code:{type:new o("DecisionGraphDiagnosticCodeV2",[...u]),isOptional:!1},path:{type:t.String_unsecure(),isOptional:!1},message:{type:t.String_unsecure(),isOptional:!1}};class n extends i{getZod(){return super.getZod().refine((e)=>(e.path?.length??501)<=500&&Boolean(e.message?.trim())&&(e.message?.length??1001)<=1000,{message:"diagnostic path and message must be bounded"})}}export const DecisionGraphDiagnosticOutputModelV2=new n({name:"DecisionGraphDiagnosticOutputV2",fields:m});const f={status:{type:new o("DecisionEvaluationStatusV2",["completed","no-match","limit-exceeded"]),isOptional:!1},outcomeKey:{type:t.String_unsecure(),isOptional:!0},outcomeData:{type:t.JSONObject(),isOptional:!0},trace:{type:c,isOptional:!1}};class a extends i{getZod(){return super.getZod().refine((e)=>e.status==="completed"?Boolean(e.outcomeKey?.trim())&&(e.outcomeKey?.length??0)<=200:e.outcomeKey===void 0&&e.outcomeData===void 0,{message:"evaluation status and outcome must be consistent"})}}export const DecisionEvaluationOutputModelV2=new a({name:"DecisionEvaluationOutputV2",fields:f});

package/dist/node/decisioning/evaluation-output-schemas.d.js

@@ -0,0 +1 @@
+export*from"./evaluation-evidence-output-schemas.js";export*from"./evaluation-output-primitives.js";

package/dist/node/decisioning/evaluation-output-schemas.js

@@ -0,0 +1 @@
+import{ScalarTypeEnum as t,SchemaModel as n}from"@lssm/lib.schema";import{DecisionEvaluationOutputModelV2 as a,DecisionGraphDiagnosticOutputModelV2 as l,DecisionGraphRefOutputModelV2 as d}from"./evaluation-output-primitives.js";import{validDecisionDigest as p,validDecisionRef as i,validDecisionTimestamp as o}from"./evaluation-schema-validation.js";export*from"./evaluation-evidence-output-schemas.js";export*from"./evaluation-output-primitives.js";class s extends n{getZod(){return super.getZod().strict()}}const r={graph:{type:d,isOptional:!1},valid:{type:t.Boolean(),isOptional:!1},diagnostics:{type:l,isOptional:!1,isArray:!0},validatedAt:{type:t.String_unsecure(),isOptional:!1},evidenceRef:{type:t.ID(),isOptional:!1}};export const DecisionValidationOutputModelV2=new class extends s{getZod(){return super.getZod().refine((e)=>(e.diagnostics?.length??501)<=500&&e.valid===((e.diagnostics?.length??-1)===0)&&o(e.validatedAt)&&i(e.evidenceRef),{message:"validation result must be consistent, bounded, and timestamped"})}}({name:"DecisionValidationOutputV2",fields:r});const u={simulationRef:{type:t.ID(),isOptional:!1},result:{type:a,isOptional:!1},simulatedAt:{type:t.String_unsecure(),isOptional:!1},evidenceRef:{type:t.ID(),isOptional:!1}};export const DecisionSimulationOutputModelV2=new class extends s{getZod(){return super.getZod().refine((e)=>i(e.simulationRef)&&e.simulationRef===e.evidenceRef&&o(e.simulatedAt),{message:"simulation evidence must be canonical and timestamped"})}}({name:"DecisionSimulationOutputV2",fields:u});const c={evaluationRef:{type:t.ID(),isOptional:!1},evaluationDigest:{type:t.String_unsecure(),isOptional:!1},result:{type:a,isOptional:!1},evaluatedAt:{type:t.String_unsecure(),isOptional:!1},receiptRef:{type:t.ID(),isOptional:!1},eventRef:{type:t.ID(),isOptional:!1}};export const DecisionAuthoritativeEvaluationOutputModelV2=new class extends s{getZod(){return super.getZod().refine((e)=>i(e.evaluationRef)&&p(e.evaluationDigest)&&o(e.evaluatedAt)&&i(e.receiptRef)&&i(e.eventRef),{message:"evaluation evidence must be canonical, digest-bound, and timestamped"})}}({name:"DecisionAuthoritativeEvaluationOutputV2",fields:c});

package/dist/node/decisioning/evaluation-schema-validation.js

@@ -0,0 +1 @@
+export function validDecisionRef(e){return typeof e==="string"&&e.length<=200&&/^[A-Za-z0-9][A-Za-z0-9._:-]*$/.test(e)}export function validDecisionDigest(e){return typeof e==="string"&&/^(?:sha256:)?[a-f0-9]{64}$/i.test(e)}export function validDecisionTimestamp(e){if(typeof e!=="string"||!Number.isFinite(Date.parse(e)))return!1;return new Date(e).toISOString()===e}export function validDecisionRuntimeVersion(e){return typeof e==="string"&&/^\d+\.\d+\.\d+(?:-[A-Za-z0-9.-]{1,64})?$/.test(e)}export function validDecisionPredicateVersion(e){return typeof e==="string"&&/^predicate-v[1-9]\d{0,5}$/.test(e)}export function validDecisionPolicyVersion(e){return typeof e==="string"&&/^decision-policy-v[1-9]\d{0,5}$/.test(e)}export function validPositiveRevision(e){return Number.isSafeInteger(e)&&Number(e)>0}export function validSequence(e){return Number.isSafeInteger(e)&&Number(e)>=0}

package/dist/node/decisioning/evaluation-trace-output-schema.js

@@ -0,0 +1 @@
+import{ZodSchemaType as d}from"@lssm/lib.schema";import{z as s}from"zod";import{validDecisionDigest as p,validDecisionRef as o,validPositiveRevision as T,validSequence as b}from"./evaluation-schema-validation.js";import{DECISION_GRAPH_LIMITS as c}from"./validation.js";const a=16,f=s.enum(["input","branch","decision-table","outcome","subgraph"]),u=s.object({key:s.string(),revision:s.number().int(),digest:s.string()}).strict().refine((i)=>o(i.key)&&T(i.revision)&&p(i.digest),{message:"graph reference must be canonical, positive, and digest-pinned"});function g(i){const t=i>0?m(i-1):s.never();return s.object({sequence:s.number().int().nonnegative(),nodeId:s.string(),nodeKind:f,selectedTargetNodeId:s.string().optional(),predicateMatched:s.boolean().optional(),subgraphRevision:u.optional(),subgraphTrace:t.optional()}).strict().superRefine((e,n)=>{if(!b(e.sequence)||!o(e.nodeId)||e.selectedTargetNodeId!==void 0&&!o(e.selectedTargetNodeId))n.addIssue({code:"custom",message:"trace step references and sequence must be valid"});if(e.nodeKind!=="subgraph"&&(e.subgraphRevision!==void 0||e.subgraphTrace!==void 0))n.addIssue({code:"custom",message:"only subgraph steps may contain nested trace evidence"});if(e.nodeKind==="subgraph"&&(e.subgraphRevision===void 0||e.subgraphTrace===void 0))n.addIssue({code:"custom",message:"subgraph steps require pinned nested trace evidence"});if(e.subgraphRevision&&e.subgraphTrace&&(e.subgraphRevision.key!==e.subgraphTrace.graph.key||e.subgraphRevision.revision!==e.subgraphTrace.graph.revision||e.subgraphRevision.digest!==e.subgraphTrace.graph.digest))n.addIssue({code:"custom",message:"nested trace must match its pinned subgraph revision"})})}function m(i){const t=g(i);return s.object({graph:u,inputDigest:s.string().optional(),steps:s.array(t).max(c.maxVisitedNodes)}).strict().superRefine((e,n)=>{if(e.inputDigest!==void 0&&!p(e.inputDigest)||!e.steps.every((r,h)=>r.sequence===h))n.addIssue({code:"custom",message:"trace must be digest-bound, ordered, and bounded"})})}function D(i){let t=0;const e=[i];while(e.length>0){const n=e.pop();if(!n)continue;t+=n.steps.length;if(t>c.maxVisitedNodes)return!1;for(const r of n.steps)if(r.subgraphTrace)e.push(r.subgraphTrace)}return!0}const S=m(a).superRefine((i,t)=>{if(!D(i))t.addIssue({code:"custom",message:"nested traces exceed the shared visited-node budget"})});export const DecisionTraceStepOutputModelV2=new d(g(a),{name:"DecisionTraceStepOutputV2"}),DecisionTraceOutputModelV2=new d(S,{name:"DecisionTraceOutputV2"}),DECISION_TRACE_OUTPUT_LIMITS={maxSubgraphDepth:a,maxVisitedNodes:c.maxVisitedNodes};

package/dist/node/decisioning/index.d.js

@@ -0,0 +1 @@
+export*from"./decisioning.feature.js";export*from"./evaluation.js";export*from"./evaluation-events.js";export*from"./evaluation-evidence-administration.js";export*from"./evaluation-evidence-administration-operations.js";export*from"./evaluation-evidence-administration-schemas.js";export*from"./evaluation-input-schemas.js";export*from"./evaluation-output-schemas.js";export*from"./lifecycle.js";export*from"./lifecycle-events.js";export*from"./lifecycle-operations.js";export*from"./operations.js";export*from"./predicate.js";export*from"./predicate-evaluation.js";export*from"./types.js";export*from"./validation.js";