@contractspec/example.versioned-knowledge-base 1.57.0 → 1.59.0

package/.turbo/turbo-build.log

@@ -1,53 +1,53 @@
-$ bun build:types && bun build:bundle
-$ tsc --noEmit
-$ tsdown
-ℹ tsdown v0.20.3 powered by rolldown v1.0.0-rc.3
-ℹ 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
-ℹ 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.14 kB │ gzip: 0.34 kB
-ℹ dist/example.js                                     1.03 kB │ gzip: 0.53 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.52 kB │ gzip: 0.73 kB
-ℹ dist/handlers/memory.handlers.d.ts.map              1.28 kB │ gzip: 0.46 kB
-ℹ dist/operations/kb.d.ts.map                         0.74 kB │ gzip: 0.25 kB
-ℹ dist/entities/models.d.ts.map                       0.43 kB │ gzip: 0.20 kB
-ℹ dist/events.d.ts.map                                0.40 kB │ gzip: 0.18 kB
-ℹ dist/versioned-knowledge-base.feature.d.ts.map      0.18 kB │ gzip: 0.14 kB
-ℹ dist/example.d.ts.map                               0.13 kB │ gzip: 0.13 kB
-ℹ dist/operations/kb.d.ts                             7.68 kB │ gzip: 0.62 kB
-ℹ dist/entities/models.d.ts                           3.84 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
-[PLUGIN_TIMINGS] Warning: Your build spent significant time in plugins. Here is a breakdown:
-ℹ dist/docs/versioned-knowledge-base.docblock.d.ts    0.01 kB │ gzip: 0.03 kB
-  - tsdown:external (71%)
-ℹ 37 files, total: 76.66 kB
-  - rolldown-plugin-dts:generate (27%)
-See https://rolldown.rs/options/checks#plugintimings for more details.
+$ contractspec-bun-build prebuild
+$ bun run prebuild && bun run build:bundle && bun run build:types
+$ contractspec-bun-build prebuild
+$ contractspec-bun-build transpile
+[contractspec-bun-build] transpile target=bun root=src entries=12
+Bundled 12 modules in 30ms
 
-✔ Build complete in 28127ms
+  docs/index.js                               1.51 KB   (entry point)
+  ./index.js                                  20.10 KB  (entry point)
+  operations/index.js                         9.55 KB   (entry point)
+  operations/kb.js                            9.55 KB   (entry point)
+  ./versioned-knowledge-base.feature.js       1.22 KB   (entry point)
+  docs/versioned-knowledge-base.docblock.js   1.51 KB   (entry point)
+  entities/index.js                           3.22 KB   (entry point)
+  entities/models.js                          3.22 KB   (entry point)
+  ./events.js                                 3.17 KB   (entry point)
+  ./example.js                                1.0 KB    (entry point)
+  handlers/index.js                           3.56 KB   (entry point)
+  handlers/memory.handlers.js                 3.56 KB   (entry point)
+
+[contractspec-bun-build] transpile target=node root=src entries=12
+Bundled 12 modules in 27ms
+
+  docs/index.js                               1.50 KB  (entry point)
+  ./index.js                                  20.1 KB  (entry point)
+  operations/index.js                         9.54 KB  (entry point)
+  operations/kb.js                            9.54 KB  (entry point)
+  ./versioned-knowledge-base.feature.js       1.21 KB  (entry point)
+  docs/versioned-knowledge-base.docblock.js   1.50 KB  (entry point)
+  entities/index.js                           3.22 KB  (entry point)
+  entities/models.js                          3.22 KB  (entry point)
+  ./events.js                                 3.16 KB  (entry point)
+  ./example.js                                1.0 KB   (entry point)
+  handlers/index.js                           3.55 KB  (entry point)
+  handlers/memory.handlers.js                 3.55 KB  (entry point)
+
+[contractspec-bun-build] transpile target=browser root=src entries=12
+Bundled 12 modules in 37ms
+
+  docs/index.js                               1.50 KB  (entry point)
+  ./index.js                                  20.1 KB  (entry point)
+  operations/index.js                         9.54 KB  (entry point)
+  operations/kb.js                            9.54 KB  (entry point)
+  ./versioned-knowledge-base.feature.js       1.21 KB  (entry point)
+  docs/versioned-knowledge-base.docblock.js   1.50 KB  (entry point)
+  entities/index.js                           3.22 KB  (entry point)
+  entities/models.js                          3.22 KB  (entry point)
+  ./events.js                                 3.16 KB  (entry point)
+  ./example.js                                1.0 KB   (entry point)
+  handlers/index.js                           3.55 KB  (entry point)
+  handlers/memory.handlers.js                 3.55 KB  (entry point)
+
+$ contractspec-bun-build types

package/.turbo/turbo-prebuild.log

@@ -0,0 +1 @@
+$ contractspec-bun-build prebuild

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # @contractspec/example.versioned-knowledge-base
 
+## 1.59.0
+
+### Minor Changes
+
+- 1a0cf44: fix: publishConfig not supported by bun
+
+### Patch Changes
+
+- Updated dependencies [1a0cf44]
+  - @contractspec/lib.contracts@1.59.0
+  - @contractspec/lib.schema@1.59.0
+
+## 1.58.0
+
+### Minor Changes
+
+- d1f0fd0: chore: Migrate non-app package builds from tsdown to shared Bun tooling, add `@contractspec/tool.bun`, and standardize `prebuild`/`build`/`typecheck` with platform-aware exports and `tsc` declaration emission into `dist`.
+
+### Patch Changes
+
+- Updated dependencies [d1f0fd0]
+- Updated dependencies [4355a9e]
+  - @contractspec/lib.contracts@1.58.0
+  - @contractspec/lib.schema@1.58.0
+
 ## 1.57.0
 
 ### Minor Changes

package/dist/browser/docs/index.js

@@ -0,0 +1,44 @@
+// src/docs/versioned-knowledge-base.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var docBlocks = [
+  {
+    id: "docs.examples.versioned-knowledge-base.goal",
+    title: "Versioned Knowledge Base — Goal",
+    summary: "Curated KB with immutable sources, versioned rules, and published snapshots referenced by answers.",
+    kind: "goal",
+    visibility: "public",
+    route: "/docs/examples/versioned-knowledge-base/goal",
+    tags: ["knowledge", "versioning", "snapshots", "traceability"],
+    body: `## Why it matters
+- Separates raw sources from curated knowledge.
+- Ensures assistant answers cite a published snapshot.
+- Makes change review and safe regeneration possible.
+
+## Core invariants
+- Sources are immutable and content-addressed (hash).
+- Rule versions must cite at least one source.
+- Snapshots include only approved rule versions.`
+  },
+  {
+    id: "docs.examples.versioned-knowledge-base.reference",
+    title: "Versioned Knowledge Base — Reference",
+    summary: "Entities, contracts, and events for the versioned KB example.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/examples/versioned-knowledge-base",
+    tags: ["knowledge", "reference"],
+    body: `## Contracts
+- kb.ingestSource
+- kb.upsertRuleVersion
+- kb.approveRuleVersion
+- kb.publishSnapshot
+- kb.search
+
+## Events
+- kb.source.ingested
+- kb.ruleVersion.created
+- kb.ruleVersion.approved
+- kb.snapshot.published`
+  }
+];
+registerDocBlocks(docBlocks);

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

@@ -0,0 +1,44 @@
+// src/docs/versioned-knowledge-base.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var docBlocks = [
+  {
+    id: "docs.examples.versioned-knowledge-base.goal",
+    title: "Versioned Knowledge Base — Goal",
+    summary: "Curated KB with immutable sources, versioned rules, and published snapshots referenced by answers.",
+    kind: "goal",
+    visibility: "public",
+    route: "/docs/examples/versioned-knowledge-base/goal",
+    tags: ["knowledge", "versioning", "snapshots", "traceability"],
+    body: `## Why it matters
+- Separates raw sources from curated knowledge.
+- Ensures assistant answers cite a published snapshot.
+- Makes change review and safe regeneration possible.
+
+## Core invariants
+- Sources are immutable and content-addressed (hash).
+- Rule versions must cite at least one source.
+- Snapshots include only approved rule versions.`
+  },
+  {
+    id: "docs.examples.versioned-knowledge-base.reference",
+    title: "Versioned Knowledge Base — Reference",
+    summary: "Entities, contracts, and events for the versioned KB example.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/examples/versioned-knowledge-base",
+    tags: ["knowledge", "reference"],
+    body: `## Contracts
+- kb.ingestSource
+- kb.upsertRuleVersion
+- kb.approveRuleVersion
+- kb.publishSnapshot
+- kb.search
+
+## Events
+- kb.source.ingested
+- kb.ruleVersion.created
+- kb.ruleVersion.approved
+- kb.snapshot.published`
+  }
+];
+registerDocBlocks(docBlocks);

package/dist/browser/entities/index.js

@@ -0,0 +1,74 @@
+// src/entities/models.ts
+import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+var SourceDocumentModel = defineSchemaModel({
+  name: "SourceDocument",
+  description: "Immutable raw source document metadata referencing a stored file.",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    authority: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    title: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    fetchedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+    hash: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    fileId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
+  }
+});
+var SourceRefModel = defineSchemaModel({
+  name: "SourceRef",
+  description: "Reference to a source document used to justify a rule version.",
+  fields: {
+    sourceDocumentId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    excerpt: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
+  }
+});
+var RuleModel = defineSchemaModel({
+  name: "Rule",
+  description: "Curated rule (stable identity) with topic + jurisdiction scope.",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    topicKey: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
+  }
+});
+var RuleVersionModel = defineSchemaModel({
+  name: "RuleVersion",
+  description: "A versioned rule content with source references and approval status.",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    ruleId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    topicKey: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    version: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    content: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    sourceRefs: { type: SourceRefModel, isArray: true, isOptional: false },
+    status: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    approvedBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    approvedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
+    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var KBSnapshotModel = defineSchemaModel({
+  name: "KBSnapshot",
+  description: "Published KB snapshot (as-of) referencing approved rule versions.",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    asOfDate: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+    includedRuleVersionIds: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isArray: true,
+      isOptional: false
+    },
+    publishedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+export {
+  SourceRefModel,
+  SourceDocumentModel,
+  RuleVersionModel,
+  RuleModel,
+  KBSnapshotModel
+};

package/dist/browser/entities/models.js

@@ -0,0 +1,74 @@
+// src/entities/models.ts
+import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+var SourceDocumentModel = defineSchemaModel({
+  name: "SourceDocument",
+  description: "Immutable raw source document metadata referencing a stored file.",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    authority: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    title: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    fetchedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+    hash: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    fileId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
+  }
+});
+var SourceRefModel = defineSchemaModel({
+  name: "SourceRef",
+  description: "Reference to a source document used to justify a rule version.",
+  fields: {
+    sourceDocumentId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    excerpt: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
+  }
+});
+var RuleModel = defineSchemaModel({
+  name: "Rule",
+  description: "Curated rule (stable identity) with topic + jurisdiction scope.",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    topicKey: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
+  }
+});
+var RuleVersionModel = defineSchemaModel({
+  name: "RuleVersion",
+  description: "A versioned rule content with source references and approval status.",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    ruleId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    topicKey: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    version: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    content: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    sourceRefs: { type: SourceRefModel, isArray: true, isOptional: false },
+    status: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    approvedBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    approvedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
+    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var KBSnapshotModel = defineSchemaModel({
+  name: "KBSnapshot",
+  description: "Published KB snapshot (as-of) referencing approved rule versions.",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    asOfDate: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+    includedRuleVersionIds: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isArray: true,
+      isOptional: false
+    },
+    publishedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+export {
+  SourceRefModel,
+  SourceDocumentModel,
+  RuleVersionModel,
+  RuleModel,
+  KBSnapshotModel
+};

package/dist/browser/events.js

@@ -0,0 +1,101 @@
+// src/events.ts
+import { defineEvent, defineSchemaModel } from "@contractspec/lib.contracts";
+import { ScalarTypeEnum } from "@contractspec/lib.schema";
+var KbSourceIngestedPayload = defineSchemaModel({
+  name: "KbSourceIngestedPayload",
+  description: "Emitted when a source document is ingested.",
+  fields: {
+    sourceDocumentId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    hash: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
+  }
+});
+var KbSourceIngestedEvent = defineEvent({
+  meta: {
+    key: "kb.source.ingested",
+    version: "1.0.0",
+    description: "Source document ingested (immutable).",
+    stability: "experimental",
+    owners: ["@examples"],
+    tags: ["knowledge"]
+  },
+  payload: KbSourceIngestedPayload
+});
+var KbRuleVersionCreatedPayload = defineSchemaModel({
+  name: "KbRuleVersionCreatedPayload",
+  description: "Emitted when a rule version draft is created.",
+  fields: {
+    ruleVersionId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    ruleId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    status: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
+  }
+});
+var KbRuleVersionCreatedEvent = defineEvent({
+  meta: {
+    key: "kb.ruleVersion.created",
+    version: "1.0.0",
+    description: "Rule version created (draft).",
+    stability: "experimental",
+    owners: ["@examples"],
+    tags: ["knowledge"]
+  },
+  payload: KbRuleVersionCreatedPayload
+});
+var KbRuleVersionApprovedPayload = defineSchemaModel({
+  name: "KbRuleVersionApprovedPayload",
+  description: "Emitted when a rule version is approved.",
+  fields: {
+    ruleVersionId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    approver: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
+  }
+});
+var KbRuleVersionApprovedEvent = defineEvent({
+  meta: {
+    key: "kb.ruleVersion.approved",
+    version: "1.0.0",
+    description: "Rule version approved (human verified).",
+    stability: "experimental",
+    owners: ["@examples"],
+    tags: ["knowledge"]
+  },
+  payload: KbRuleVersionApprovedPayload
+});
+var KbSnapshotPublishedPayload = defineSchemaModel({
+  name: "KbSnapshotPublishedPayload",
+  description: "Emitted when a KB snapshot is published.",
+  fields: {
+    snapshotId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    includedRuleVersionsCount: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: false
+    }
+  }
+});
+var KbSnapshotPublishedEvent = defineEvent({
+  meta: {
+    key: "kb.snapshot.published",
+    version: "1.0.0",
+    description: "KB snapshot published.",
+    stability: "experimental",
+    owners: ["@examples"],
+    tags: ["knowledge"]
+  },
+  payload: KbSnapshotPublishedPayload
+});
+export {
+  KbSourceIngestedEvent,
+  KbSnapshotPublishedEvent,
+  KbRuleVersionCreatedEvent,
+  KbRuleVersionApprovedEvent
+};

package/dist/browser/example.js

@@ -0,0 +1,35 @@
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var example = defineExample({
+  meta: {
+    key: "versioned-knowledge-base",
+    version: "1.0.0",
+    title: "Versioned Knowledge Base",
+    description: "Curated KB with immutable sources, reviewable rule versions, and published snapshots.",
+    kind: "knowledge",
+    visibility: "public",
+    stability: "experimental",
+    owners: ["@platform.core"],
+    tags: ["knowledge", "versioning", "snapshots"]
+  },
+  docs: {
+    rootDocId: "docs.examples.versioned-knowledge-base"
+  },
+  entrypoints: {
+    packageName: "@contractspec/example.versioned-knowledge-base",
+    feature: "./feature",
+    contracts: "./contracts",
+    handlers: "./handlers",
+    docs: "./docs"
+  },
+  surfaces: {
+    templates: true,
+    sandbox: { enabled: true, modes: ["markdown", "specs", "builder"] },
+    studio: { enabled: true, installable: true },
+    mcp: { enabled: true }
+  }
+});
+var example_default = example;
+export {
+  example_default as default
+};

package/dist/browser/handlers/index.js

@@ -0,0 +1,115 @@
+// src/handlers/memory.handlers.ts
+function createMemoryKbStore() {
+  return {
+    sources: new Map,
+    rules: new Map,
+    ruleVersions: new Map,
+    snapshots: new Map,
+    nextRuleVersionNumberByRuleId: new Map
+  };
+}
+function stableId(prefix, value) {
+  return `${prefix}_${value.replace(/[^a-zA-Z0-9_-]/g, "_")}`;
+}
+function createMemoryKbHandlers(store) {
+  async function createRule(rule) {
+    store.rules.set(rule.id, rule);
+    return rule;
+  }
+  async function ingestSource(input) {
+    const id = stableId("src", `${input.jurisdiction}_${input.hash}`);
+    const doc = { id, ...input };
+    store.sources.set(id, doc);
+    return doc;
+  }
+  async function upsertRuleVersion(input) {
+    if (!input.sourceRefs.length) {
+      throw new Error("SOURCE_REFS_REQUIRED");
+    }
+    const rule = store.rules.get(input.ruleId);
+    if (!rule) {
+      throw new Error("RULE_NOT_FOUND");
+    }
+    const next = (store.nextRuleVersionNumberByRuleId.get(input.ruleId) ?? 0) + 1;
+    const id = stableId("rv", `${input.ruleId}_${next}`);
+    const ruleVersion = {
+      id,
+      ruleId: input.ruleId,
+      jurisdiction: rule.jurisdiction,
+      topicKey: rule.topicKey,
+      version: next.toString(),
+      content: input.content,
+      sourceRefs: input.sourceRefs,
+      status: "draft",
+      createdAt: new Date,
+      approvedAt: undefined,
+      approvedBy: undefined
+    };
+    store.ruleVersions.set(id, ruleVersion);
+    return ruleVersion;
+  }
+  async function approveRuleVersion(input) {
+    const existing = store.ruleVersions.get(input.ruleVersionId);
+    if (!existing) {
+      throw new Error("RULE_VERSION_NOT_FOUND");
+    }
+    const approved = {
+      ...existing,
+      status: "approved",
+      approvedBy: input.approver,
+      approvedAt: new Date
+    };
+    store.ruleVersions.set(approved.id, approved);
+    return approved;
+  }
+  async function publishSnapshot(input) {
+    const approved = [...store.ruleVersions.values()].filter((rv) => rv.status === "approved" && rv.jurisdiction === input.jurisdiction);
+    if (approved.length === 0) {
+      throw new Error("NO_APPROVED_RULES");
+    }
+    const includedRuleVersionIds = approved.map((rv) => rv.id).sort();
+    const id = stableId("snap", `${input.jurisdiction}_${input.asOfDate.toISOString().slice(0, 10)}_${includedRuleVersionIds.length}`);
+    const snapshot = {
+      id,
+      jurisdiction: input.jurisdiction,
+      asOfDate: input.asOfDate,
+      includedRuleVersionIds,
+      publishedAt: new Date
+    };
+    store.snapshots.set(id, snapshot);
+    return snapshot;
+  }
+  async function search(input) {
+    const snapshot = store.snapshots.get(input.snapshotId);
+    if (!snapshot) {
+      throw new Error("SNAPSHOT_NOT_FOUND");
+    }
+    if (snapshot.jurisdiction !== input.jurisdiction) {
+      throw new Error("JURISDICTION_MISMATCH");
+    }
+    const q = input.query.toLowerCase();
+    const tokens = q.split(/\s+/).map((t) => t.trim()).filter(Boolean);
+    const items = snapshot.includedRuleVersionIds.map((id) => store.ruleVersions.get(id)).filter((rv) => Boolean(rv)).filter((rv) => {
+      if (tokens.length === 0)
+        return true;
+      const hay = rv.content.toLowerCase();
+      return tokens.every((token) => hay.includes(token));
+    }).map((rv) => ({
+      ruleVersionId: rv.id,
+      excerpt: rv.content.slice(0, 120)
+    }));
+    return { items };
+  }
+  return {
+    createRule,
+    ingestSource,
+    upsertRuleVersion,
+    approveRuleVersion,
+    publishSnapshot,
+    search
+  };
+}
+export {
+  createMemoryKbStore,
+  createMemoryKbHandlers
+};