@contractspec/example.versioned-knowledge-base 1.56.1 → 1.58.0

package/package.json

@@ -1,63 +1,166 @@
 {
   "name": "@contractspec/example.versioned-knowledge-base",
-  "version": "1.56.1",
+  "version": "1.58.0",
   "description": "Example: curated, versioned knowledge base with immutable sources, rule versions, and published snapshots.",
   "type": "module",
   "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./dist/index.js",
-    "./docs": "./dist/docs/index.js",
-    "./docs/versioned-knowledge-base.docblock": "./dist/docs/versioned-knowledge-base.docblock.js",
-    "./entities": "./dist/entities/index.js",
-    "./entities/models": "./dist/entities/models.js",
-    "./events": "./dist/events.js",
-    "./example": "./dist/example.js",
-    "./handlers": "./dist/handlers/index.js",
-    "./handlers/memory.handlers": "./dist/handlers/memory.handlers.js",
-    "./operations": "./dist/operations/index.js",
-    "./operations/kb": "./dist/operations/kb.js",
-    "./versioned-knowledge-base.feature": "./dist/versioned-knowledge-base.feature.js",
-    "./*": "./*"
+    ".": "./src/index.ts",
+    "./docs": "./src/docs/index.ts",
+    "./docs/index": "./src/docs/index.ts",
+    "./docs/versioned-knowledge-base.docblock": "./src/docs/versioned-knowledge-base.docblock.ts",
+    "./entities": "./src/entities/index.ts",
+    "./entities/index": "./src/entities/index.ts",
+    "./entities/models": "./src/entities/models.ts",
+    "./events": "./src/events.ts",
+    "./example": "./src/example.ts",
+    "./handlers": "./src/handlers/index.ts",
+    "./handlers/index": "./src/handlers/index.ts",
+    "./handlers/memory.handlers": "./src/handlers/memory.handlers.ts",
+    "./operations": "./src/operations/index.ts",
+    "./operations/index": "./src/operations/index.ts",
+    "./operations/kb": "./src/operations/kb.ts",
+    "./versioned-knowledge-base.feature": "./src/versioned-knowledge-base.feature.ts"
   },
   "scripts": {
     "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
     "publish:pkg:canary": "bun publish:pkg --tag canary",
-    "build": "bun build:types && bun build:bundle",
-    "build:bundle": "tsdown",
-    "build:types": "tsc --noEmit",
-    "dev": "bun build:bundle --watch",
+    "build": "bun run prebuild && bun run build:bundle && bun run build:types",
+    "build:bundle": "contractspec-bun-build transpile",
+    "build:types": "contractspec-bun-build types",
+    "dev": "contractspec-bun-build dev",
     "clean": "rimraf dist .turbo",
     "lint": "bun lint:fix",
     "lint:fix": "eslint src --fix",
     "lint:check": "eslint src",
-    "test": "bun test"
+    "test": "bun test",
+    "prebuild": "contractspec-bun-build prebuild",
+    "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@contractspec/lib.contracts": "1.56.1",
-    "@contractspec/lib.schema": "1.56.1"
+    "@contractspec/lib.contracts": "1.58.0",
+    "@contractspec/lib.schema": "1.58.0"
   },
   "devDependencies": {
-    "@contractspec/tool.tsdown": "1.56.1",
-    "@contractspec/tool.typescript": "1.56.1",
-    "tsdown": "^0.19.0",
-    "typescript": "^5.9.3"
+    "@contractspec/tool.typescript": "1.58.0",
+    "typescript": "^5.9.3",
+    "@contractspec/tool.bun": "1.57.0"
   },
   "publishConfig": {
     "access": "public",
     "exports": {
-      ".": "./dist/index.js",
-      "./contracts": "./dist/contracts/index.js",
-      "./contracts/kb": "./dist/contracts/kb.js",
-      "./docs": "./dist/docs/index.js",
-      "./docs/versioned-knowledge-base.docblock": "./dist/docs/versioned-knowledge-base.docblock.js",
-      "./entities": "./dist/entities/index.js",
-      "./entities/models": "./dist/entities/models.js",
-      "./events": "./dist/events.js",
-      "./example": "./dist/example.js",
-      "./handlers": "./dist/handlers/index.js",
-      "./handlers/memory.handlers": "./dist/handlers/memory.handlers.js",
-      "./versioned-knowledge-base.feature": "./dist/versioned-knowledge-base.feature.js",
-      "./*": "./*"
+      ".": {
+        "types": "./dist/index.d.ts",
+        "bun": "./dist/index.js",
+        "node": "./dist/node/index.mjs",
+        "browser": "./dist/browser/index.js",
+        "default": "./dist/index.js"
+      },
+      "./docs": {
+        "types": "./dist/docs/index.d.ts",
+        "bun": "./dist/docs/index.js",
+        "node": "./dist/node/docs/index.mjs",
+        "browser": "./dist/browser/docs/index.js",
+        "default": "./dist/docs/index.js"
+      },
+      "./docs/index": {
+        "types": "./dist/docs/index.d.ts",
+        "bun": "./dist/docs/index.js",
+        "node": "./dist/node/docs/index.mjs",
+        "browser": "./dist/browser/docs/index.js",
+        "default": "./dist/docs/index.js"
+      },
+      "./docs/versioned-knowledge-base.docblock": {
+        "types": "./dist/docs/versioned-knowledge-base.docblock.d.ts",
+        "bun": "./dist/docs/versioned-knowledge-base.docblock.js",
+        "node": "./dist/node/docs/versioned-knowledge-base.docblock.mjs",
+        "browser": "./dist/browser/docs/versioned-knowledge-base.docblock.js",
+        "default": "./dist/docs/versioned-knowledge-base.docblock.js"
+      },
+      "./entities": {
+        "types": "./dist/entities/index.d.ts",
+        "bun": "./dist/entities/index.js",
+        "node": "./dist/node/entities/index.mjs",
+        "browser": "./dist/browser/entities/index.js",
+        "default": "./dist/entities/index.js"
+      },
+      "./entities/index": {
+        "types": "./dist/entities/index.d.ts",
+        "bun": "./dist/entities/index.js",
+        "node": "./dist/node/entities/index.mjs",
+        "browser": "./dist/browser/entities/index.js",
+        "default": "./dist/entities/index.js"
+      },
+      "./entities/models": {
+        "types": "./dist/entities/models.d.ts",
+        "bun": "./dist/entities/models.js",
+        "node": "./dist/node/entities/models.mjs",
+        "browser": "./dist/browser/entities/models.js",
+        "default": "./dist/entities/models.js"
+      },
+      "./events": {
+        "types": "./dist/events.d.ts",
+        "bun": "./dist/events.js",
+        "node": "./dist/node/events.mjs",
+        "browser": "./dist/browser/events.js",
+        "default": "./dist/events.js"
+      },
+      "./example": {
+        "types": "./dist/example.d.ts",
+        "bun": "./dist/example.js",
+        "node": "./dist/node/example.mjs",
+        "browser": "./dist/browser/example.js",
+        "default": "./dist/example.js"
+      },
+      "./handlers": {
+        "types": "./dist/handlers/index.d.ts",
+        "bun": "./dist/handlers/index.js",
+        "node": "./dist/node/handlers/index.mjs",
+        "browser": "./dist/browser/handlers/index.js",
+        "default": "./dist/handlers/index.js"
+      },
+      "./handlers/index": {
+        "types": "./dist/handlers/index.d.ts",
+        "bun": "./dist/handlers/index.js",
+        "node": "./dist/node/handlers/index.mjs",
+        "browser": "./dist/browser/handlers/index.js",
+        "default": "./dist/handlers/index.js"
+      },
+      "./handlers/memory.handlers": {
+        "types": "./dist/handlers/memory.handlers.d.ts",
+        "bun": "./dist/handlers/memory.handlers.js",
+        "node": "./dist/node/handlers/memory.handlers.mjs",
+        "browser": "./dist/browser/handlers/memory.handlers.js",
+        "default": "./dist/handlers/memory.handlers.js"
+      },
+      "./operations": {
+        "types": "./dist/operations/index.d.ts",
+        "bun": "./dist/operations/index.js",
+        "node": "./dist/node/operations/index.mjs",
+        "browser": "./dist/browser/operations/index.js",
+        "default": "./dist/operations/index.js"
+      },
+      "./operations/index": {
+        "types": "./dist/operations/index.d.ts",
+        "bun": "./dist/operations/index.js",
+        "node": "./dist/node/operations/index.mjs",
+        "browser": "./dist/browser/operations/index.js",
+        "default": "./dist/operations/index.js"
+      },
+      "./operations/kb": {
+        "types": "./dist/operations/kb.d.ts",
+        "bun": "./dist/operations/kb.js",
+        "node": "./dist/node/operations/kb.mjs",
+        "browser": "./dist/browser/operations/kb.js",
+        "default": "./dist/operations/kb.js"
+      },
+      "./versioned-knowledge-base.feature": {
+        "types": "./dist/versioned-knowledge-base.feature.d.ts",
+        "bun": "./dist/versioned-knowledge-base.feature.js",
+        "node": "./dist/node/versioned-knowledge-base.feature.mjs",
+        "browser": "./dist/browser/versioned-knowledge-base.feature.js",
+        "default": "./dist/versioned-knowledge-base.feature.js"
+      }
     },
     "registry": "https://registry.npmjs.org/"
   },

package/tsdown.config.js

@@ -1,5 +1,4 @@
-import { defineConfig } from 'tsdown';
-import { moduleLibrary, withDevExports } from '@contractspec/tool.tsdown';
+import { defineConfig, moduleLibrary, withDevExports } from '@contractspec/tool.bun';
 
 export default defineConfig(() => ({
   ...moduleLibrary,

package/.turbo/turbo-build$colon$bundle.log

@@ -1,47 +0,0 @@
-$ tsdown
-ℹ tsdown v0.19.0 powered by rolldown v1.0.0-beta.59
-ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/versioned-knowledge-base/tsdown.config.js 
-ℹ entry: src/events.ts, src/example.ts, src/index.ts, src/versioned-knowledge-base.feature.ts, src/docs/index.ts, src/docs/versioned-knowledge-base.docblock.ts, src/entities/index.ts, src/entities/models.ts, src/handlers/index.ts, src/handlers/memory.handlers.ts, src/operations/index.ts, src/operations/kb.ts
-ℹ target: esnext
-ℹ tsconfig: tsconfig.json
-ℹ Build start
-ℹ Cleaning 41 files
-ℹ dist/operations/kb.js                               6.46 kB │ gzip: 1.58 kB
-ℹ dist/handlers/memory.handlers.js                    3.45 kB │ gzip: 1.20 kB
-ℹ dist/entities/models.js                             3.39 kB │ gzip: 0.67 kB
-ℹ dist/events.js                                      3.15 kB │ gzip: 0.67 kB
-ℹ dist/docs/versioned-knowledge-base.docblock.js      1.52 kB │ gzip: 0.66 kB
-ℹ dist/versioned-knowledge-base.feature.js            1.34 kB │ gzip: 0.50 kB
-ℹ dist/index.js                                       1.16 kB │ gzip: 0.35 kB
-ℹ dist/example.js                                     1.07 kB │ gzip: 0.54 kB
-ℹ dist/operations/index.js                            0.29 kB │ gzip: 0.13 kB
-ℹ dist/entities/index.js                              0.21 kB │ gzip: 0.11 kB
-ℹ dist/handlers/index.js                              0.14 kB │ gzip: 0.09 kB
-ℹ dist/docs/index.js                                  0.05 kB │ gzip: 0.07 kB
-ℹ dist/operations/kb.js.map                           9.51 kB │ gzip: 2.10 kB
-ℹ dist/handlers/memory.handlers.js.map                8.44 kB │ gzip: 2.43 kB
-ℹ dist/entities/models.js.map                         5.09 kB │ gzip: 1.00 kB
-ℹ dist/events.js.map                                  4.72 kB │ gzip: 0.98 kB
-ℹ dist/docs/versioned-knowledge-base.docblock.js.map  2.02 kB │ gzip: 0.84 kB
-ℹ dist/versioned-knowledge-base.feature.js.map        1.94 kB │ gzip: 0.73 kB
-ℹ dist/example.js.map                                 1.53 kB │ gzip: 0.74 kB
-ℹ dist/handlers/memory.handlers.d.ts.map              1.17 kB │ gzip: 0.53 kB
-ℹ dist/operations/kb.d.ts.map                         1.11 kB │ gzip: 0.39 kB
-ℹ dist/entities/models.d.ts.map                       0.69 kB │ gzip: 0.32 kB
-ℹ dist/events.d.ts.map                                0.67 kB │ gzip: 0.28 kB
-ℹ dist/versioned-knowledge-base.feature.d.ts.map      0.19 kB │ gzip: 0.15 kB
-ℹ dist/example.d.ts.map                               0.14 kB │ gzip: 0.13 kB
-ℹ dist/operations/kb.d.ts                             7.75 kB │ gzip: 0.63 kB
-ℹ dist/entities/models.d.ts                           3.88 kB │ gzip: 0.51 kB
-ℹ dist/events.d.ts                                    2.14 kB │ gzip: 0.39 kB
-ℹ dist/handlers/memory.handlers.d.ts                  1.94 kB │ gzip: 0.61 kB
-ℹ dist/index.d.ts                                     1.18 kB │ gzip: 0.35 kB
-ℹ dist/versioned-knowledge-base.feature.d.ts          0.34 kB │ gzip: 0.20 kB
-ℹ dist/operations/index.d.ts                          0.29 kB │ gzip: 0.13 kB
-ℹ dist/example.d.ts                                   0.25 kB │ gzip: 0.17 kB
-ℹ dist/entities/index.d.ts                            0.21 kB │ gzip: 0.11 kB
-ℹ dist/handlers/index.d.ts                            0.20 kB │ gzip: 0.10 kB
-ℹ dist/docs/index.d.ts                                0.01 kB │ gzip: 0.03 kB
-ℹ dist/docs/versioned-knowledge-base.docblock.d.ts    0.01 kB │ gzip: 0.03 kB
-ℹ 37 files, total: 77.65 kB
-✔ Build complete in 23952ms

package/dist/docs/versioned-knowledge-base.docblock.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"versioned-knowledge-base.docblock.js","names":[],"sources":["../../src/docs/versioned-knowledge-base.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts/docs';\nimport { registerDocBlocks } from '@contractspec/lib.contracts/docs';\n\nconst docBlocks: DocBlock[] = [\n  {\n    id: 'docs.examples.versioned-knowledge-base.goal',\n    title: 'Versioned Knowledge Base — Goal',\n    summary:\n      'Curated KB with immutable sources, versioned rules, and published snapshots referenced by answers.',\n    kind: 'goal',\n    visibility: 'public',\n    route: '/docs/examples/versioned-knowledge-base/goal',\n    tags: ['knowledge', 'versioning', 'snapshots', 'traceability'],\n    body: `## Why it matters\n- Separates raw sources from curated knowledge.\\n- Ensures assistant answers cite a published snapshot.\\n- Makes change review and safe regeneration possible.\\n\\n## Core invariants\\n- Sources are immutable and content-addressed (hash).\\n- Rule versions must cite at least one source.\\n- Snapshots include only approved rule versions.`,\n  },\n  {\n    id: 'docs.examples.versioned-knowledge-base.reference',\n    title: 'Versioned Knowledge Base — Reference',\n    summary: 'Entities, contracts, and events for the versioned KB example.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/examples/versioned-knowledge-base',\n    tags: ['knowledge', 'reference'],\n    body: `## Contracts\\n- kb.ingestSource\\n- kb.upsertRuleVersion\\n- kb.approveRuleVersion\\n- kb.publishSnapshot\\n- kb.search\\n\\n## Events\\n- kb.source.ingested\\n- kb.ruleVersion.created\\n- kb.ruleVersion.approved\\n- kb.snapshot.published`,\n  },\n];\n\nregisterDocBlocks(docBlocks);\n"],"mappings":";;;AA4BA,kBAzB8B,CAC5B;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EAAC;EAAa;EAAc;EAAa;EAAe;CAC9D,MAAM;;CAEP,EACD;CACE,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM,CAAC,aAAa,YAAY;CAChC,MAAM;CACP,CACF,CAE2B"}

package/dist/entities/models.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"models.js","names":[],"sources":["../../src/entities/models.ts"],"sourcesContent":["import { ScalarTypeEnum, defineSchemaModel } from '@contractspec/lib.schema';\n\nexport const SourceDocumentModel = defineSchemaModel({\n  name: 'SourceDocument',\n  description:\n    'Immutable raw source document metadata referencing a stored file.',\n  fields: {\n    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    authority: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    title: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    fetchedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n    hash: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    fileId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nexport const SourceRefModel = defineSchemaModel({\n  name: 'SourceRef',\n  description: 'Reference to a source document used to justify a rule version.',\n  fields: {\n    sourceDocumentId: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    excerpt: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n  },\n});\n\nexport const RuleModel = defineSchemaModel({\n  name: 'Rule',\n  description:\n    'Curated rule (stable identity) with topic + jurisdiction scope.',\n  fields: {\n    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    topicKey: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nexport const RuleVersionModel = defineSchemaModel({\n  name: 'RuleVersion',\n  description:\n    'A versioned rule content with source references and approval status.',\n  fields: {\n    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    ruleId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    topicKey: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    version: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    content: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    sourceRefs: { type: SourceRefModel, isArray: true, isOptional: false },\n    status: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }, // draft|approved|rejected\n    approvedBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    approvedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },\n    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nexport const KBSnapshotModel = defineSchemaModel({\n  name: 'KBSnapshot',\n  description:\n    'Published KB snapshot (as-of) referencing approved rule versions.',\n  fields: {\n    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    asOfDate: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n    includedRuleVersionIds: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isArray: true,\n      isOptional: false,\n    },\n    publishedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n"],"mappings":";;;AAEA,MAAa,sBAAsB,kBAAkB;CACnD,MAAM;CACN,aACE;CACF,QAAQ;EACN,IAAI;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACjE,cAAc;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EAC3E,WAAW;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACxE,OAAO;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACpE,WAAW;GAAE,MAAM,eAAe,UAAU;GAAE,YAAY;GAAO;EACjE,MAAM;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACnE,QAAQ;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACtE;CACF,CAAC;AAEF,MAAa,iBAAiB,kBAAkB;CAC9C,MAAM;CACN,aAAa;CACb,QAAQ;EACN,kBAAkB;GAChB,MAAM,eAAe,iBAAiB;GACtC,YAAY;GACb;EACD,SAAS;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAM;EACtE;CACF,CAAC;AAEF,MAAa,YAAY,kBAAkB;CACzC,MAAM;CACN,aACE;CACF,QAAQ;EACN,IAAI;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACjE,cAAc;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EAC3E,UAAU;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACxE;CACF,CAAC;AAEF,MAAa,mBAAmB,kBAAkB;CAChD,MAAM;CACN,aACE;CACF,QAAQ;EACN,IAAI;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACjE,QAAQ;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACrE,cAAc;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EAC3E,UAAU;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACvE,SAAS;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACtE,SAAS;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACtE,YAAY;GAAE,MAAM;GAAgB,SAAS;GAAM,YAAY;GAAO;EACtE,QAAQ;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACrE,YAAY;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAM;EACxE,YAAY;GAAE,MAAM,eAAe,UAAU;GAAE,YAAY;GAAM;EACjE,WAAW;GAAE,MAAM,eAAe,UAAU;GAAE,YAAY;GAAO;EAClE;CACF,CAAC;AAEF,MAAa,kBAAkB,kBAAkB;CAC/C,MAAM;CACN,aACE;CACF,QAAQ;EACN,IAAI;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACjE,cAAc;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EAC3E,UAAU;GAAE,MAAM,eAAe,UAAU;GAAE,YAAY;GAAO;EAChE,wBAAwB;GACtB,MAAM,eAAe,iBAAiB;GACtC,SAAS;GACT,YAAY;GACb;EACD,aAAa;GAAE,MAAM,eAAe,UAAU;GAAE,YAAY;GAAO;EACpE;CACF,CAAC"}

package/dist/events.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"events.js","names":[],"sources":["../src/events.ts"],"sourcesContent":["import { defineEvent, defineSchemaModel } from '@contractspec/lib.contracts';\nimport { ScalarTypeEnum } from '@contractspec/lib.schema';\n\nconst KbSourceIngestedPayload = defineSchemaModel({\n  name: 'KbSourceIngestedPayload',\n  description: 'Emitted when a source document is ingested.',\n  fields: {\n    sourceDocumentId: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    hash: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nexport const KbSourceIngestedEvent = defineEvent({\n  meta: {\n    key: 'kb.source.ingested',\n    version: '1.0.0',\n    description: 'Source document ingested (immutable).',\n    stability: 'experimental',\n    owners: ['@examples'],\n    tags: ['knowledge'],\n  },\n  payload: KbSourceIngestedPayload,\n});\n\nconst KbRuleVersionCreatedPayload = defineSchemaModel({\n  name: 'KbRuleVersionCreatedPayload',\n  description: 'Emitted when a rule version draft is created.',\n  fields: {\n    ruleVersionId: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    ruleId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    status: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nexport const KbRuleVersionCreatedEvent = defineEvent({\n  meta: {\n    key: 'kb.ruleVersion.created',\n    version: '1.0.0',\n    description: 'Rule version created (draft).',\n    stability: 'experimental',\n    owners: ['@examples'],\n    tags: ['knowledge'],\n  },\n  payload: KbRuleVersionCreatedPayload,\n});\n\nconst KbRuleVersionApprovedPayload = defineSchemaModel({\n  name: 'KbRuleVersionApprovedPayload',\n  description: 'Emitted when a rule version is approved.',\n  fields: {\n    ruleVersionId: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    approver: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nexport const KbRuleVersionApprovedEvent = defineEvent({\n  meta: {\n    key: 'kb.ruleVersion.approved',\n    version: '1.0.0',\n    description: 'Rule version approved (human verified).',\n    stability: 'experimental',\n    owners: ['@examples'],\n    tags: ['knowledge'],\n  },\n  payload: KbRuleVersionApprovedPayload,\n});\n\nconst KbSnapshotPublishedPayload = defineSchemaModel({\n  name: 'KbSnapshotPublishedPayload',\n  description: 'Emitted when a KB snapshot is published.',\n  fields: {\n    snapshotId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    includedRuleVersionsCount: {\n      type: ScalarTypeEnum.Int_unsecure(),\n      isOptional: false,\n    },\n  },\n});\n\nexport const KbSnapshotPublishedEvent = defineEvent({\n  meta: {\n    key: 'kb.snapshot.published',\n    version: '1.0.0',\n    description: 'KB snapshot published.',\n    stability: 'experimental',\n    owners: ['@examples'],\n    tags: ['knowledge'],\n  },\n  payload: KbSnapshotPublishedPayload,\n});\n"],"mappings":";;;;AAGA,MAAM,0BAA0B,kBAAkB;CAChD,MAAM;CACN,aAAa;CACb,QAAQ;EACN,kBAAkB;GAChB,MAAM,eAAe,iBAAiB;GACtC,YAAY;GACb;EACD,cAAc;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EAC3E,MAAM;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACpE;CACF,CAAC;AAEF,MAAa,wBAAwB,YAAY;CAC/C,MAAM;EACJ,KAAK;EACL,SAAS;EACT,aAAa;EACb,WAAW;EACX,QAAQ,CAAC,YAAY;EACrB,MAAM,CAAC,YAAY;EACpB;CACD,SAAS;CACV,CAAC;AAEF,MAAM,8BAA8B,kBAAkB;CACpD,MAAM;CACN,aAAa;CACb,QAAQ;EACN,eAAe;GACb,MAAM,eAAe,iBAAiB;GACtC,YAAY;GACb;EACD,QAAQ;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACrE,cAAc;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EAC3E,QAAQ;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACtE;CACF,CAAC;AAEF,MAAa,4BAA4B,YAAY;CACnD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,aAAa;EACb,WAAW;EACX,QAAQ,CAAC,YAAY;EACrB,MAAM,CAAC,YAAY;EACpB;CACD,SAAS;CACV,CAAC;AAEF,MAAM,+BAA+B,kBAAkB;CACrD,MAAM;CACN,aAAa;CACb,QAAQ;EACN,eAAe;GACb,MAAM,eAAe,iBAAiB;GACtC,YAAY;GACb;EACD,UAAU;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACxE;CACF,CAAC;AAEF,MAAa,6BAA6B,YAAY;CACpD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,aAAa;EACb,WAAW;EACX,QAAQ,CAAC,YAAY;EACrB,MAAM,CAAC,YAAY;EACpB;CACD,SAAS;CACV,CAAC;AAEF,MAAM,6BAA6B,kBAAkB;CACnD,MAAM;CACN,aAAa;CACb,QAAQ;EACN,YAAY;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACzE,cAAc;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EAC3E,2BAA2B;GACzB,MAAM,eAAe,cAAc;GACnC,YAAY;GACb;EACF;CACF,CAAC;AAEF,MAAa,2BAA2B,YAAY;CAClD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,aAAa;EACb,WAAW;EACX,QAAQ,CAAC,YAAY;EACrB,MAAM,CAAC,YAAY;EACpB;CACD,SAAS;CACV,CAAC"}

package/dist/example.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"example.js","names":[],"sources":["../src/example.ts"],"sourcesContent":["import { defineExample } from '@contractspec/lib.contracts';\n\nconst example = defineExample({\n  meta: {\n    key: 'versioned-knowledge-base',\n    version: '1.0.0',\n    title: 'Versioned Knowledge Base',\n    description:\n      'Curated KB with immutable sources, reviewable rule versions, and published snapshots.',\n    kind: 'knowledge',\n    visibility: 'public',\n    stability: 'experimental',\n    owners: ['@platform.core'],\n    tags: ['knowledge', 'versioning', 'snapshots'],\n  },\n  docs: {\n    rootDocId: 'docs.examples.versioned-knowledge-base',\n  },\n  entrypoints: {\n    packageName: '@contractspec/example.versioned-knowledge-base',\n    feature: './feature',\n    contracts: './contracts',\n    handlers: './handlers',\n    docs: './docs',\n  },\n  surfaces: {\n    templates: true,\n    sandbox: { enabled: true, modes: ['markdown', 'specs', 'builder'] },\n    studio: { enabled: true, installable: true },\n    mcp: { enabled: true },\n  },\n});\n\nexport default example;\n"],"mappings":";;;AAEA,MAAM,UAAU,cAAc;CAC5B,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,MAAM;EACN,YAAY;EACZ,WAAW;EACX,QAAQ,CAAC,iBAAiB;EAC1B,MAAM;GAAC;GAAa;GAAc;GAAY;EAC/C;CACD,MAAM,EACJ,WAAW,0CACZ;CACD,aAAa;EACX,aAAa;EACb,SAAS;EACT,WAAW;EACX,UAAU;EACV,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GAAE,SAAS;GAAM,OAAO;IAAC;IAAY;IAAS;IAAU;GAAE;EACnE,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF,CAAC;AAEF,sBAAe"}

package/dist/handlers/memory.handlers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"memory.handlers.js","names":[],"sources":["../../src/handlers/memory.handlers.ts"],"sourcesContent":["interface SourceRef {\n  sourceDocumentId: string;\n  excerpt?: string;\n}\ninterface SourceDocument {\n  id: string;\n  jurisdiction: string;\n  authority: string;\n  title: string;\n  fetchedAt: Date;\n  hash: string;\n  fileId: string;\n}\ninterface Rule {\n  id: string;\n  jurisdiction: string;\n  topicKey: string;\n}\ninterface RuleVersion {\n  id: string;\n  ruleId: string;\n  jurisdiction: string;\n  topicKey: string;\n  version: string;\n  content: string;\n  sourceRefs: SourceRef[];\n  status: 'draft' | 'approved' | 'rejected';\n  approvedBy?: string;\n  approvedAt?: Date;\n  createdAt: Date;\n}\ninterface KBSnapshot {\n  id: string;\n  jurisdiction: string;\n  asOfDate: Date;\n  includedRuleVersionIds: string[];\n  publishedAt: Date;\n}\n\nexport interface MemoryKbStore {\n  sources: Map<string, SourceDocument>;\n  rules: Map<string, Rule>;\n  ruleVersions: Map<string, RuleVersion>;\n  snapshots: Map<string, KBSnapshot>;\n  nextRuleVersionNumberByRuleId: Map<string, number>;\n}\n\nexport function createMemoryKbStore(): MemoryKbStore {\n  return {\n    sources: new Map(),\n    rules: new Map(),\n    ruleVersions: new Map(),\n    snapshots: new Map(),\n    nextRuleVersionNumberByRuleId: new Map(),\n  };\n}\n\nexport interface MemoryKbHandlers {\n  createRule(rule: Rule): Promise<Rule>;\n  ingestSource(input: Omit<SourceDocument, 'id'>): Promise<SourceDocument>;\n  upsertRuleVersion(input: {\n    ruleId: string;\n    content: string;\n    sourceRefs: SourceRef[];\n  }): Promise<RuleVersion>;\n  approveRuleVersion(input: {\n    ruleVersionId: string;\n    approver: string;\n  }): Promise<RuleVersion>;\n  publishSnapshot(input: {\n    jurisdiction: string;\n    asOfDate: Date;\n  }): Promise<KBSnapshot>;\n  search(input: {\n    snapshotId: string;\n    jurisdiction: string;\n    query: string;\n  }): Promise<{ items: { ruleVersionId: string; excerpt?: string }[] }>;\n}\n\nfunction stableId(prefix: string, value: string): string {\n  return `${prefix}_${value.replace(/[^a-zA-Z0-9_-]/g, '_')}`;\n}\n\nexport function createMemoryKbHandlers(store: MemoryKbStore): MemoryKbHandlers {\n  async function createRule(rule: Rule): Promise<Rule> {\n    store.rules.set(rule.id, rule);\n    return rule;\n  }\n\n  async function ingestSource(\n    input: Omit<SourceDocument, 'id'>\n  ): Promise<SourceDocument> {\n    const id = stableId('src', `${input.jurisdiction}_${input.hash}`);\n    const doc: SourceDocument = { id, ...input };\n    store.sources.set(id, doc);\n    return doc;\n  }\n\n  async function upsertRuleVersion(input: {\n    ruleId: string;\n    content: string;\n    sourceRefs: SourceRef[];\n  }): Promise<RuleVersion> {\n    if (!input.sourceRefs.length) {\n      throw new Error('SOURCE_REFS_REQUIRED');\n    }\n    const rule = store.rules.get(input.ruleId);\n    if (!rule) {\n      throw new Error('RULE_NOT_FOUND');\n    }\n    const next =\n      (store.nextRuleVersionNumberByRuleId.get(input.ruleId) ?? 0) + 1;\n    const id = stableId('rv', `${input.ruleId}_${next}`);\n    const ruleVersion: RuleVersion = {\n      id,\n      ruleId: input.ruleId,\n      jurisdiction: rule.jurisdiction,\n      topicKey: rule.topicKey,\n      version: next.toString(),\n      content: input.content,\n      sourceRefs: input.sourceRefs,\n      status: 'draft',\n      createdAt: new Date(),\n      approvedAt: undefined,\n      approvedBy: undefined,\n    };\n    store.ruleVersions.set(id, ruleVersion);\n    return ruleVersion;\n  }\n\n  async function approveRuleVersion(input: {\n    ruleVersionId: string;\n    approver: string;\n  }): Promise<RuleVersion> {\n    const existing = store.ruleVersions.get(input.ruleVersionId);\n    if (!existing) {\n      throw new Error('RULE_VERSION_NOT_FOUND');\n    }\n    const approved: RuleVersion = {\n      ...existing,\n      status: 'approved',\n      approvedBy: input.approver,\n      approvedAt: new Date(),\n    };\n    store.ruleVersions.set(approved.id, approved);\n    return approved;\n  }\n\n  async function publishSnapshot(input: {\n    jurisdiction: string;\n    asOfDate: Date;\n  }): Promise<KBSnapshot> {\n    const approved = [...store.ruleVersions.values()].filter(\n      (rv) => rv.status === 'approved' && rv.jurisdiction === input.jurisdiction\n    );\n    if (approved.length === 0) {\n      throw new Error('NO_APPROVED_RULES');\n    }\n    const includedRuleVersionIds = approved.map((rv) => rv.id).sort();\n    const id = stableId(\n      'snap',\n      `${input.jurisdiction}_${input.asOfDate.toISOString().slice(0, 10)}_${includedRuleVersionIds.length}`\n    );\n    const snapshot: KBSnapshot = {\n      id,\n      jurisdiction: input.jurisdiction,\n      asOfDate: input.asOfDate,\n      includedRuleVersionIds,\n      publishedAt: new Date(),\n    };\n    store.snapshots.set(id, snapshot);\n    return snapshot;\n  }\n\n  async function search(input: {\n    snapshotId: string;\n    jurisdiction: string;\n    query: string;\n  }): Promise<{ items: { ruleVersionId: string; excerpt?: string }[] }> {\n    const snapshot = store.snapshots.get(input.snapshotId);\n    if (!snapshot) {\n      throw new Error('SNAPSHOT_NOT_FOUND');\n    }\n    if (snapshot.jurisdiction !== input.jurisdiction) {\n      throw new Error('JURISDICTION_MISMATCH');\n    }\n    const q = input.query.toLowerCase();\n    const tokens = q\n      .split(/\\s+/)\n      .map((t) => t.trim())\n      .filter(Boolean);\n    const items = snapshot.includedRuleVersionIds\n      .map((id) => store.ruleVersions.get(id))\n      .filter((rv): rv is RuleVersion => Boolean(rv))\n      .filter((rv) => {\n        if (tokens.length === 0) return true;\n        const hay = rv.content.toLowerCase();\n        return tokens.every((token) => hay.includes(token));\n      })\n      .map((rv) => ({\n        ruleVersionId: rv.id,\n        excerpt: rv.content.slice(0, 120),\n      }));\n    return { items };\n  }\n\n  return {\n    createRule,\n    ingestSource,\n    upsertRuleVersion,\n    approveRuleVersion,\n    publishSnapshot,\n    search,\n  };\n}\n"],"mappings":"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"}

package/dist/operations/kb.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"kb.js","names":["defineSchemaModel"],"sources":["../../src/operations/kb.ts"],"sourcesContent":["import { defineCommand, defineQuery } from '@contractspec/lib.contracts';\nimport { ScalarTypeEnum, defineSchemaModel } from '@contractspec/lib.schema';\n\nimport {\n  KBSnapshotModel,\n  RuleVersionModel,\n  SourceDocumentModel,\n  SourceRefModel,\n} from '../entities/models';\n\nconst IngestSourceInput = defineSchemaModel({\n  name: 'KbIngestSourceInput',\n  description: 'Ingest immutable source metadata referencing a stored file.',\n  fields: {\n    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    authority: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    title: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    fetchedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n    hash: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    fileId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nconst UpsertRuleVersionInput = defineSchemaModel({\n  name: 'KbUpsertRuleVersionInput',\n  description: 'Create a new draft rule version (immutable history).',\n  fields: {\n    ruleId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    content: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    sourceRefs: { type: SourceRefModel, isArray: true, isOptional: false },\n  },\n});\n\nconst ApproveRuleVersionInput = defineSchemaModel({\n  name: 'KbApproveRuleVersionInput',\n  description: 'Approve a rule version (human verification).',\n  fields: {\n    ruleVersionId: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    approver: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nconst PublishSnapshotInput = defineSchemaModel({\n  name: 'KbPublishSnapshotInput',\n  description: 'Publish a snapshot for a jurisdiction as-of a date.',\n  fields: {\n    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    asOfDate: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nconst SearchKbInput = defineSchemaModel({\n  name: 'KbSearchInput',\n  description: 'Search within a published snapshot.',\n  fields: {\n    snapshotId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    query: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nconst SearchKbResultItem = defineSchemaModel({\n  name: 'KbSearchResultItem',\n  description: 'Search result referencing a specific rule version.',\n  fields: {\n    ruleVersionId: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    excerpt: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n  },\n});\n\nconst SearchKbOutput = defineSchemaModel({\n  name: 'KbSearchOutput',\n  description: 'Search results constrained to snapshot + jurisdiction.',\n  fields: {\n    items: { type: SearchKbResultItem, isArray: true, isOptional: false },\n  },\n});\n\nexport const KbIngestSourceContract = defineCommand({\n  meta: {\n    key: 'kb.ingestSource',\n    title: 'Ingest Source',\n    version: '1.0.0',\n    stability: 'experimental',\n    owners: ['@examples'],\n    tags: ['knowledge', 'sources', 'ingestion'],\n    description: 'Ingest immutable source document metadata.',\n    goal: 'Store traceable source documents for curated KB.',\n    context: 'Called when an admin uploads/records authoritative sources.',\n  },\n  io: {\n    input: IngestSourceInput,\n    output: SourceDocumentModel,\n  },\n  policy: { auth: 'user' },\n});\n\nexport const KbUpsertRuleVersionContract = defineCommand({\n  meta: {\n    key: 'kb.upsertRuleVersion',\n    title: 'Upsert Rule Version',\n    version: '1.0.0',\n    stability: 'experimental',\n    owners: ['@examples'],\n    tags: ['knowledge', 'rules', 'versioning'],\n    description: 'Create a new draft rule version with source references.',\n    goal: 'Propose curated knowledge updates with traceability.',\n    context: 'Automation or curators propose draft rule versions.',\n  },\n  io: {\n    input: UpsertRuleVersionInput,\n    output: RuleVersionModel,\n    errors: {\n      SOURCE_REFS_REQUIRED: {\n        description: 'Rule version must cite at least one sourceRef',\n        http: 400,\n        gqlCode: 'SOURCE_REFS_REQUIRED',\n        when: 'sourceRefs is empty',\n      },\n      RULE_NOT_FOUND: {\n        description: 'Rule does not exist',\n        http: 404,\n        gqlCode: 'RULE_NOT_FOUND',\n        when: 'ruleId is unknown',\n      },\n    },\n  },\n  policy: { auth: 'user' },\n});\n\nexport const KbApproveRuleVersionContract = defineCommand({\n  meta: {\n    key: 'kb.approveRuleVersion',\n    title: 'Approve Rule Version',\n    version: '1.0.0',\n    stability: 'experimental',\n    owners: ['@examples'],\n    tags: ['knowledge', 'rules', 'approval'],\n    description: 'Approve a draft rule version.',\n    goal: 'Human verification step before publishing snapshots.',\n    context: 'Curators/experts approve proposed KB changes.',\n  },\n  io: {\n    input: ApproveRuleVersionInput,\n    output: RuleVersionModel,\n  },\n  policy: { auth: 'user' },\n});\n\nexport const KbPublishSnapshotContract = defineCommand({\n  meta: {\n    key: 'kb.publishSnapshot',\n    title: 'Publish Snapshot',\n    version: '1.0.0',\n    stability: 'experimental',\n    owners: ['@examples'],\n    tags: ['knowledge', 'snapshots', 'publishing'],\n    description: 'Publish a KB snapshot for a jurisdiction.',\n    goal: 'Create a stable snapshot that assistant answers can cite.',\n    context:\n      'Publishing happens after approvals; snapshot is referenced by answers.',\n  },\n  io: {\n    input: PublishSnapshotInput,\n    output: KBSnapshotModel,\n    errors: {\n      NO_APPROVED_RULES: {\n        description: 'No approved rule versions available to publish',\n        http: 409,\n        gqlCode: 'NO_APPROVED_RULES',\n        when: 'jurisdiction has zero approved rule versions',\n      },\n    },\n  },\n  policy: { auth: 'user' },\n});\n\nexport const KbSearchContract = defineQuery({\n  meta: {\n    key: 'kb.search',\n    title: 'Search KB',\n    version: '1.0.0',\n    stability: 'experimental',\n    owners: ['@examples'],\n    tags: ['knowledge', 'search', 'snapshots'],\n    description: 'Search within a published KB snapshot.',\n    goal: 'Provide scoped retrieval for assistant answers.',\n    context: 'Assistant queries curated rules from a specific snapshot.',\n  },\n  io: {\n    input: SearchKbInput,\n    output: SearchKbOutput,\n  },\n  policy: { auth: 'user' },\n});\n"],"mappings":"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"}

package/dist/versioned-knowledge-base.feature.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"versioned-knowledge-base.feature.js","names":[],"sources":["../src/versioned-knowledge-base.feature.ts"],"sourcesContent":["import { defineFeature } from '@contractspec/lib.contracts';\n\nexport const VersionedKnowledgeBaseFeature = defineFeature({\n  meta: {\n    key: 'versioned-knowledge-base',\n    version: '1.0.0',\n    title: 'Versioned Knowledge Base',\n    description:\n      'Curated KB with immutable sources, rule versions, and published snapshots.',\n    domain: 'knowledge',\n    owners: ['@examples'],\n    tags: ['knowledge', 'versioning', 'snapshots'],\n    stability: 'experimental',\n  },\n  operations: [\n    { key: 'kb.ingestSource', version: '1.0.0' },\n    { key: 'kb.upsertRuleVersion', version: '1.0.0' },\n    { key: 'kb.approveRuleVersion', version: '1.0.0' },\n    { key: 'kb.publishSnapshot', version: '1.0.0' },\n    { key: 'kb.search', version: '1.0.0' },\n  ],\n  events: [\n    { key: 'kb.source.ingested', version: '1.0.0' },\n    { key: 'kb.ruleVersion.created', version: '1.0.0' },\n    { key: 'kb.ruleVersion.approved', version: '1.0.0' },\n    { key: 'kb.snapshot.published', version: '1.0.0' },\n  ],\n  presentations: [],\n  opToPresentation: [],\n  presentationsTargets: [],\n  capabilities: {\n    requires: [{ key: 'knowledge', version: '1.0.0' }],\n  },\n});\n"],"mappings":";;;AAEA,MAAa,gCAAgC,cAAc;CACzD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,QAAQ;EACR,QAAQ,CAAC,YAAY;EACrB,MAAM;GAAC;GAAa;GAAc;GAAY;EAC9C,WAAW;EACZ;CACD,YAAY;EACV;GAAE,KAAK;GAAmB,SAAS;GAAS;EAC5C;GAAE,KAAK;GAAwB,SAAS;GAAS;EACjD;GAAE,KAAK;GAAyB,SAAS;GAAS;EAClD;GAAE,KAAK;GAAsB,SAAS;GAAS;EAC/C;GAAE,KAAK;GAAa,SAAS;GAAS;EACvC;CACD,QAAQ;EACN;GAAE,KAAK;GAAsB,SAAS;GAAS;EAC/C;GAAE,KAAK;GAA0B,SAAS;GAAS;EACnD;GAAE,KAAK;GAA2B,SAAS;GAAS;EACpD;GAAE,KAAK;GAAyB,SAAS;GAAS;EACnD;CACD,eAAe,EAAE;CACjB,kBAAkB,EAAE;CACpB,sBAAsB,EAAE;CACxB,cAAc,EACZ,UAAU,CAAC;EAAE,KAAK;EAAa,SAAS;EAAS,CAAC,EACnD;CACF,CAAC"}