@contractspec/example.versioned-knowledge-base 3.7.7 → 3.7.12

package/.turbo/turbo-build.log

@@ -2,52 +2,55 @@ $ 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 noBundle=false
-Bundled 12 modules in 36ms
+[contractspec-bun-build] transpile target=bun root=src entries=13 noBundle=false
+Bundled 13 modules in 40ms
 
-  docs/index.js                               1.51 KB   (entry point)
-  ./index.js                                  20.31 KB  (entry point)
-  operations/index.js                         9.56 KB   (entry point)
-  operations/kb.js                            9.56 KB   (entry point)
-  ./versioned-knowledge-base.feature.js       1.41 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)
+  docs/index.js                                   1.51 KB   (entry point)
+  ./index.js                                      21.87 KB  (entry point)
+  ./knowledge-snapshot-publication.migration.js   1.57 KB   (entry point)
+  operations/index.js                             9.56 KB   (entry point)
+  operations/kb.js                                9.56 KB   (entry point)
+  ./versioned-knowledge-base.feature.js           1.41 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 noBundle=false
-Bundled 12 modules in 27ms
+[contractspec-bun-build] transpile target=node root=src entries=13 noBundle=false
+Bundled 13 modules in 33ms
 
-  docs/index.js                               1.50 KB   (entry point)
-  ./index.js                                  20.30 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.40 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)
+  docs/index.js                                   1.50 KB   (entry point)
+  ./index.js                                      21.85 KB  (entry point)
+  ./knowledge-snapshot-publication.migration.js   1.56 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.40 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 noBundle=false
-Bundled 12 modules in 27ms
+[contractspec-bun-build] transpile target=browser root=src entries=13 noBundle=false
+Bundled 13 modules in 29ms
 
-  docs/index.js                               1.50 KB   (entry point)
-  ./index.js                                  20.30 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.40 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)
+  docs/index.js                                   1.50 KB   (entry point)
+  ./index.js                                      21.85 KB  (entry point)
+  ./knowledge-snapshot-publication.migration.js   1.56 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.40 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/CHANGELOG.md

@@ -1,5 +1,45 @@
 # @contractspec/example.versioned-knowledge-base
 
+## 3.7.12
+
+### Patch Changes
+
+- Updated dependencies [81256ea]
+- Updated dependencies [2619dd8]
+- Updated dependencies [6de2f1c]
+- Updated dependencies [81256ea]
+- Updated dependencies [a4489bb]
+- Updated dependencies [9cb304e]
+  - @contractspec/lib.contracts-spec@5.0.0
+  - @contractspec/lib.schema@3.7.10
+
+## 3.7.11
+
+### Patch Changes
+
+- fix: release
+- Updated dependencies
+  - @contractspec/lib.contracts-spec@4.1.3
+  - @contractspec/lib.schema@3.7.9
+
+## 3.7.10
+
+### Patch Changes
+
+- 1a44cb6: feat: improve examples to increase coverage of Contracts type
+- Updated dependencies [1a44cb6]
+  - @contractspec/lib.contracts-spec@4.1.2
+  - @contractspec/lib.schema@3.7.8
+
+## 3.7.9
+
+### Patch Changes
+
+- fix: release
+- Updated dependencies
+  - @contractspec/lib.contracts-spec@4.1.1
+  - @contractspec/lib.schema@3.7.7
+
 ## 3.7.6
 
 ### Patch Changes
@@ -704,14 +744,17 @@
   feat: Contract layers support (features, examples, app-configs)
 
   ### New CLI Commands
+
   - `contractspec list layers` - List all contract layers with filtering
 
   ### Enhanced Commands
+
   - `contractspec ci` - New `layers` check category validates features/examples/config
   - `contractspec doctor` - New `layers` health checks
   - `contractspec integrity` - Now shows layer statistics
 
   ### New APIs
+
   - `discoverLayers()` - Scan workspace for all layer files
   - `scanExampleSource()` - Parse ExampleSpec from source code
   - `isExampleFile()` - Check if file is an example spec

package/README.md

@@ -8,6 +8,7 @@ Website: https://contractspec.io
 
 - Immutable source and versioned rule management.
 - Snapshot publishing pattern.
+- Canonical `migration` export via `KnowledgeSnapshotPublicationMigration`.
 - Entity models for KB domain.
 - Memory-based handler implementation.
 - Feature definition and event-driven architecture.
@@ -33,6 +34,7 @@ Use `@contractspec/example.versioned-knowledge-base` as a reference implementati
 - `src/example.ts` is the runnable example entrypoint.
 - `src/handlers/` contains handlers or demo adapters wired to contract surfaces.
 - `src/index.ts` is the root public barrel and package entrypoint.
+- `src/knowledge-snapshot-publication.migration.ts` defines the exported migration spec.
 - `src/operations` is part of the package's public or composition surface.
 
 ## Public Entry Points
@@ -46,7 +48,10 @@ Use `@contractspec/example.versioned-knowledge-base` as a reference implementati
 - Export `./example` resolves through `./src/example.ts`.
 - Export `./handlers` resolves through `./src/handlers/index.ts`.
 - Export `./handlers/memory.handlers` resolves through `./src/handlers/memory.handlers.ts`.
+- Export `./knowledge-snapshot-publication.migration` resolves through `./src/knowledge-snapshot-publication.migration.ts`.
 - Export `./operations` resolves through `./src/operations/index.ts`.
+- Export `./operations/kb` resolves through `./src/operations/kb.ts`.
+- Export `./versioned-knowledge-base.feature` resolves through `./src/versioned-knowledge-base.feature.ts`.
 - The package publishes 12 total export subpaths; keep docs aligned with `package.json`.
 
 ## Local Commands

package/dist/browser/index.js

@@ -349,6 +349,54 @@ function createMemoryKbHandlers(store) {
     search
   };
 }
+// src/knowledge-snapshot-publication.migration.ts
+import {
+  OwnersEnum,
+  StabilityEnum,
+  TagsEnum
+} from "@contractspec/lib.contracts-spec/ownership";
+var KnowledgeSnapshotPublicationMigration = {
+  meta: {
+    key: "versioned-knowledge-base.migration.snapshot-publication",
+    version: "1.0.0",
+    title: "Knowledge Snapshot Publication Migration",
+    description: "Adds publication audit fields and validation checks for published knowledge snapshots.",
+    domain: "knowledge",
+    owners: [OwnersEnum.PlatformContent],
+    tags: ["knowledge", "migration", "snapshots", TagsEnum.Hygiene],
+    stability: StabilityEnum.Experimental
+  },
+  dependencies: ["versioned-knowledge-base.migration.bootstrap"],
+  plan: {
+    up: [
+      {
+        kind: "schema",
+        description: "Create the published snapshot audit table.",
+        sql: `
+CREATE TABLE kb_snapshot_publications (
+  snapshot_id TEXT PRIMARY KEY,
+  published_by TEXT NOT NULL,
+  published_at TIMESTAMPTZ NOT NULL,
+  source_count INTEGER NOT NULL,
+  rule_version_count INTEGER NOT NULL
+);`
+      },
+      {
+        kind: "validation",
+        description: "Ensure snapshots have at least one approved rule version.",
+        assertion: "SELECT COUNT(*) = 0 FROM kb_snapshots WHERE array_length(included_rule_version_ids, 1) = 0"
+      }
+    ],
+    down: [
+      {
+        kind: "schema",
+        description: "Remove the snapshot publication audit table.",
+        sql: "DROP TABLE IF EXISTS kb_snapshot_publications;"
+      }
+    ]
+  }
+};
+
 // src/operations/kb.ts
 import { defineCommand, defineQuery } from "@contractspec/lib.contracts-spec";
 import { defineSchemaModel as defineSchemaModel3, ScalarTypeEnum as ScalarTypeEnum3 } from "@contractspec/lib.schema";
@@ -578,6 +626,7 @@ export {
   SourceDocumentModel,
   RuleVersionModel,
   RuleModel,
+  KnowledgeSnapshotPublicationMigration,
   KbUpsertRuleVersionContract,
   KbSourceIngestedEvent,
   KbSnapshotPublishedEvent,

package/dist/browser/knowledge-snapshot-publication.migration.js

@@ -0,0 +1,50 @@
+// src/knowledge-snapshot-publication.migration.ts
+import {
+  OwnersEnum,
+  StabilityEnum,
+  TagsEnum
+} from "@contractspec/lib.contracts-spec/ownership";
+var KnowledgeSnapshotPublicationMigration = {
+  meta: {
+    key: "versioned-knowledge-base.migration.snapshot-publication",
+    version: "1.0.0",
+    title: "Knowledge Snapshot Publication Migration",
+    description: "Adds publication audit fields and validation checks for published knowledge snapshots.",
+    domain: "knowledge",
+    owners: [OwnersEnum.PlatformContent],
+    tags: ["knowledge", "migration", "snapshots", TagsEnum.Hygiene],
+    stability: StabilityEnum.Experimental
+  },
+  dependencies: ["versioned-knowledge-base.migration.bootstrap"],
+  plan: {
+    up: [
+      {
+        kind: "schema",
+        description: "Create the published snapshot audit table.",
+        sql: `
+CREATE TABLE kb_snapshot_publications (
+  snapshot_id TEXT PRIMARY KEY,
+  published_by TEXT NOT NULL,
+  published_at TIMESTAMPTZ NOT NULL,
+  source_count INTEGER NOT NULL,
+  rule_version_count INTEGER NOT NULL
+);`
+      },
+      {
+        kind: "validation",
+        description: "Ensure snapshots have at least one approved rule version.",
+        assertion: "SELECT COUNT(*) = 0 FROM kb_snapshots WHERE array_length(included_rule_version_ids, 1) = 0"
+      }
+    ],
+    down: [
+      {
+        kind: "schema",
+        description: "Remove the snapshot publication audit table.",
+        sql: "DROP TABLE IF EXISTS kb_snapshot_publications;"
+      }
+    ]
+  }
+};
+export {
+  KnowledgeSnapshotPublicationMigration
+};

package/dist/contracts.test.d.ts

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

package/dist/index.d.ts

@@ -7,6 +7,7 @@ export * from './entities';
 export * from './events';
 export { default as example } from './example';
 export * from './handlers';
+export * from './knowledge-snapshot-publication.migration';
 export * from './operations';
 export * from './versioned-knowledge-base.feature';
 import './docs';

package/dist/index.js

@@ -350,6 +350,54 @@ function createMemoryKbHandlers(store) {
     search
   };
 }
+// src/knowledge-snapshot-publication.migration.ts
+import {
+  OwnersEnum,
+  StabilityEnum,
+  TagsEnum
+} from "@contractspec/lib.contracts-spec/ownership";
+var KnowledgeSnapshotPublicationMigration = {
+  meta: {
+    key: "versioned-knowledge-base.migration.snapshot-publication",
+    version: "1.0.0",
+    title: "Knowledge Snapshot Publication Migration",
+    description: "Adds publication audit fields and validation checks for published knowledge snapshots.",
+    domain: "knowledge",
+    owners: [OwnersEnum.PlatformContent],
+    tags: ["knowledge", "migration", "snapshots", TagsEnum.Hygiene],
+    stability: StabilityEnum.Experimental
+  },
+  dependencies: ["versioned-knowledge-base.migration.bootstrap"],
+  plan: {
+    up: [
+      {
+        kind: "schema",
+        description: "Create the published snapshot audit table.",
+        sql: `
+CREATE TABLE kb_snapshot_publications (
+  snapshot_id TEXT PRIMARY KEY,
+  published_by TEXT NOT NULL,
+  published_at TIMESTAMPTZ NOT NULL,
+  source_count INTEGER NOT NULL,
+  rule_version_count INTEGER NOT NULL
+);`
+      },
+      {
+        kind: "validation",
+        description: "Ensure snapshots have at least one approved rule version.",
+        assertion: "SELECT COUNT(*) = 0 FROM kb_snapshots WHERE array_length(included_rule_version_ids, 1) = 0"
+      }
+    ],
+    down: [
+      {
+        kind: "schema",
+        description: "Remove the snapshot publication audit table.",
+        sql: "DROP TABLE IF EXISTS kb_snapshot_publications;"
+      }
+    ]
+  }
+};
+
 // src/operations/kb.ts
 import { defineCommand, defineQuery } from "@contractspec/lib.contracts-spec";
 import { defineSchemaModel as defineSchemaModel3, ScalarTypeEnum as ScalarTypeEnum3 } from "@contractspec/lib.schema";
@@ -579,6 +627,7 @@ export {
   SourceDocumentModel,
   RuleVersionModel,
   RuleModel,
+  KnowledgeSnapshotPublicationMigration,
   KbUpsertRuleVersionContract,
   KbSourceIngestedEvent,
   KbSnapshotPublishedEvent,

package/dist/knowledge-snapshot-publication.migration.d.ts

@@ -0,0 +1,2 @@
+import type { MigrationSpec } from '@contractspec/lib.contracts-spec/migrations';
+export declare const KnowledgeSnapshotPublicationMigration: MigrationSpec;

package/dist/knowledge-snapshot-publication.migration.js

@@ -0,0 +1,51 @@
+// @bun
+// src/knowledge-snapshot-publication.migration.ts
+import {
+  OwnersEnum,
+  StabilityEnum,
+  TagsEnum
+} from "@contractspec/lib.contracts-spec/ownership";
+var KnowledgeSnapshotPublicationMigration = {
+  meta: {
+    key: "versioned-knowledge-base.migration.snapshot-publication",
+    version: "1.0.0",
+    title: "Knowledge Snapshot Publication Migration",
+    description: "Adds publication audit fields and validation checks for published knowledge snapshots.",
+    domain: "knowledge",
+    owners: [OwnersEnum.PlatformContent],
+    tags: ["knowledge", "migration", "snapshots", TagsEnum.Hygiene],
+    stability: StabilityEnum.Experimental
+  },
+  dependencies: ["versioned-knowledge-base.migration.bootstrap"],
+  plan: {
+    up: [
+      {
+        kind: "schema",
+        description: "Create the published snapshot audit table.",
+        sql: `
+CREATE TABLE kb_snapshot_publications (
+  snapshot_id TEXT PRIMARY KEY,
+  published_by TEXT NOT NULL,
+  published_at TIMESTAMPTZ NOT NULL,
+  source_count INTEGER NOT NULL,
+  rule_version_count INTEGER NOT NULL
+);`
+      },
+      {
+        kind: "validation",
+        description: "Ensure snapshots have at least one approved rule version.",
+        assertion: "SELECT COUNT(*) = 0 FROM kb_snapshots WHERE array_length(included_rule_version_ids, 1) = 0"
+      }
+    ],
+    down: [
+      {
+        kind: "schema",
+        description: "Remove the snapshot publication audit table.",
+        sql: "DROP TABLE IF EXISTS kb_snapshot_publications;"
+      }
+    ]
+  }
+};
+export {
+  KnowledgeSnapshotPublicationMigration
+};

package/dist/node/index.js

@@ -349,6 +349,54 @@ function createMemoryKbHandlers(store) {
     search
   };
 }
+// src/knowledge-snapshot-publication.migration.ts
+import {
+  OwnersEnum,
+  StabilityEnum,
+  TagsEnum
+} from "@contractspec/lib.contracts-spec/ownership";
+var KnowledgeSnapshotPublicationMigration = {
+  meta: {
+    key: "versioned-knowledge-base.migration.snapshot-publication",
+    version: "1.0.0",
+    title: "Knowledge Snapshot Publication Migration",
+    description: "Adds publication audit fields and validation checks for published knowledge snapshots.",
+    domain: "knowledge",
+    owners: [OwnersEnum.PlatformContent],
+    tags: ["knowledge", "migration", "snapshots", TagsEnum.Hygiene],
+    stability: StabilityEnum.Experimental
+  },
+  dependencies: ["versioned-knowledge-base.migration.bootstrap"],
+  plan: {
+    up: [
+      {
+        kind: "schema",
+        description: "Create the published snapshot audit table.",
+        sql: `
+CREATE TABLE kb_snapshot_publications (
+  snapshot_id TEXT PRIMARY KEY,
+  published_by TEXT NOT NULL,
+  published_at TIMESTAMPTZ NOT NULL,
+  source_count INTEGER NOT NULL,
+  rule_version_count INTEGER NOT NULL
+);`
+      },
+      {
+        kind: "validation",
+        description: "Ensure snapshots have at least one approved rule version.",
+        assertion: "SELECT COUNT(*) = 0 FROM kb_snapshots WHERE array_length(included_rule_version_ids, 1) = 0"
+      }
+    ],
+    down: [
+      {
+        kind: "schema",
+        description: "Remove the snapshot publication audit table.",
+        sql: "DROP TABLE IF EXISTS kb_snapshot_publications;"
+      }
+    ]
+  }
+};
+
 // src/operations/kb.ts
 import { defineCommand, defineQuery } from "@contractspec/lib.contracts-spec";
 import { defineSchemaModel as defineSchemaModel3, ScalarTypeEnum as ScalarTypeEnum3 } from "@contractspec/lib.schema";
@@ -578,6 +626,7 @@ export {
   SourceDocumentModel,
   RuleVersionModel,
   RuleModel,
+  KnowledgeSnapshotPublicationMigration,
   KbUpsertRuleVersionContract,
   KbSourceIngestedEvent,
   KbSnapshotPublishedEvent,

package/dist/node/knowledge-snapshot-publication.migration.js

@@ -0,0 +1,50 @@
+// src/knowledge-snapshot-publication.migration.ts
+import {
+  OwnersEnum,
+  StabilityEnum,
+  TagsEnum
+} from "@contractspec/lib.contracts-spec/ownership";
+var KnowledgeSnapshotPublicationMigration = {
+  meta: {
+    key: "versioned-knowledge-base.migration.snapshot-publication",
+    version: "1.0.0",
+    title: "Knowledge Snapshot Publication Migration",
+    description: "Adds publication audit fields and validation checks for published knowledge snapshots.",
+    domain: "knowledge",
+    owners: [OwnersEnum.PlatformContent],
+    tags: ["knowledge", "migration", "snapshots", TagsEnum.Hygiene],
+    stability: StabilityEnum.Experimental
+  },
+  dependencies: ["versioned-knowledge-base.migration.bootstrap"],
+  plan: {
+    up: [
+      {
+        kind: "schema",
+        description: "Create the published snapshot audit table.",
+        sql: `
+CREATE TABLE kb_snapshot_publications (
+  snapshot_id TEXT PRIMARY KEY,
+  published_by TEXT NOT NULL,
+  published_at TIMESTAMPTZ NOT NULL,
+  source_count INTEGER NOT NULL,
+  rule_version_count INTEGER NOT NULL
+);`
+      },
+      {
+        kind: "validation",
+        description: "Ensure snapshots have at least one approved rule version.",
+        assertion: "SELECT COUNT(*) = 0 FROM kb_snapshots WHERE array_length(included_rule_version_ids, 1) = 0"
+      }
+    ],
+    down: [
+      {
+        kind: "schema",
+        description: "Remove the snapshot publication audit table.",
+        sql: "DROP TABLE IF EXISTS kb_snapshot_publications;"
+      }
+    ]
+  }
+};
+export {
+  KnowledgeSnapshotPublicationMigration
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/example.versioned-knowledge-base",
-  "version": "3.7.7",
+  "version": "3.7.12",
   "description": "Example: curated, versioned knowledge base with immutable sources, rule versions, and published snapshots.",
   "type": "module",
   "types": "./dist/index.d.ts",
@@ -68,6 +68,13 @@
       "node": "./dist/node/handlers/memory.handlers.js",
       "default": "./dist/handlers/memory.handlers.js"
     },
+    "./knowledge-snapshot-publication.migration": {
+      "types": "./dist/knowledge-snapshot-publication.migration.d.ts",
+      "browser": "./dist/browser/knowledge-snapshot-publication.migration.js",
+      "bun": "./dist/knowledge-snapshot-publication.migration.js",
+      "node": "./dist/node/knowledge-snapshot-publication.migration.js",
+      "default": "./dist/knowledge-snapshot-publication.migration.js"
+    },
     "./operations": {
       "types": "./dist/operations/index.d.ts",
       "browser": "./dist/browser/operations/index.js",
@@ -106,13 +113,13 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@contractspec/lib.contracts-spec": "4.0.0",
-    "@contractspec/lib.schema": "3.7.6"
+    "@contractspec/lib.contracts-spec": "5.0.0",
+    "@contractspec/lib.schema": "3.7.10"
   },
   "devDependencies": {
-    "@contractspec/tool.typescript": "3.7.6",
+    "@contractspec/tool.typescript": "3.7.9",
     "typescript": "^5.9.3",
-    "@contractspec/tool.bun": "3.7.6"
+    "@contractspec/tool.bun": "3.7.9"
   },
   "publishConfig": {
     "access": "public",
@@ -180,6 +187,13 @@
         "node": "./dist/node/handlers/memory.handlers.js",
         "default": "./dist/handlers/memory.handlers.js"
       },
+      "./knowledge-snapshot-publication.migration": {
+        "types": "./dist/knowledge-snapshot-publication.migration.d.ts",
+        "browser": "./dist/browser/knowledge-snapshot-publication.migration.js",
+        "bun": "./dist/knowledge-snapshot-publication.migration.js",
+        "node": "./dist/node/knowledge-snapshot-publication.migration.js",
+        "default": "./dist/knowledge-snapshot-publication.migration.js"
+      },
       "./operations": {
         "types": "./dist/operations/index.d.ts",
         "browser": "./dist/browser/operations/index.js",

package/src/contracts.test.ts

@@ -0,0 +1,17 @@
+import { describe, expect, test } from 'bun:test';
+import {
+	KnowledgeSnapshotPublicationMigration,
+	VersionedKnowledgeBaseFeature,
+} from './index';
+
+describe('@contractspec/example.versioned-knowledge-base', () => {
+	test('exports the canonical migration spec', () => {
+		expect(KnowledgeSnapshotPublicationMigration.meta.key).toBe(
+			'versioned-knowledge-base.migration.snapshot-publication'
+		);
+		expect(KnowledgeSnapshotPublicationMigration.plan.up).toHaveLength(2);
+		expect(VersionedKnowledgeBaseFeature.meta.key).toBe(
+			'versioned-knowledge-base'
+		);
+	});
+});

package/src/index.ts

@@ -7,6 +7,7 @@ export * from './entities';
 export * from './events';
 export { default as example } from './example';
 export * from './handlers';
+export * from './knowledge-snapshot-publication.migration';
 export * from './operations';
 export * from './versioned-knowledge-base.feature';
 

package/src/knowledge-snapshot-publication.migration.ts

@@ -0,0 +1,51 @@
+import type { MigrationSpec } from '@contractspec/lib.contracts-spec/migrations';
+import {
+	OwnersEnum,
+	StabilityEnum,
+	TagsEnum,
+} from '@contractspec/lib.contracts-spec/ownership';
+
+export const KnowledgeSnapshotPublicationMigration: MigrationSpec = {
+	meta: {
+		key: 'versioned-knowledge-base.migration.snapshot-publication',
+		version: '1.0.0',
+		title: 'Knowledge Snapshot Publication Migration',
+		description:
+			'Adds publication audit fields and validation checks for published knowledge snapshots.',
+		domain: 'knowledge',
+		owners: [OwnersEnum.PlatformContent],
+		tags: ['knowledge', 'migration', 'snapshots', TagsEnum.Hygiene],
+		stability: StabilityEnum.Experimental,
+	},
+	dependencies: ['versioned-knowledge-base.migration.bootstrap'],
+	plan: {
+		up: [
+			{
+				kind: 'schema',
+				description: 'Create the published snapshot audit table.',
+				sql: `
+CREATE TABLE kb_snapshot_publications (
+  snapshot_id TEXT PRIMARY KEY,
+  published_by TEXT NOT NULL,
+  published_at TIMESTAMPTZ NOT NULL,
+  source_count INTEGER NOT NULL,
+  rule_version_count INTEGER NOT NULL
+);`,
+			},
+			{
+				kind: 'validation',
+				description:
+					'Ensure snapshots have at least one approved rule version.',
+				assertion:
+					'SELECT COUNT(*) = 0 FROM kb_snapshots WHERE array_length(included_rule_version_ids, 1) = 0',
+			},
+		],
+		down: [
+			{
+				kind: 'schema',
+				description: 'Remove the snapshot publication audit table.',
+				sql: 'DROP TABLE IF EXISTS kb_snapshot_publications;',
+			},
+		],
+	},
+};