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

package/.turbo/turbo-build.log

@@ -3,7 +3,7 @@ $ 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 32ms
+Bundled 12 modules in 36ms
 
   docs/index.js                               1.51 KB   (entry point)
   ./index.js                                  20.31 KB  (entry point)
@@ -19,7 +19,7 @@ Bundled 12 modules in 32ms
   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 23ms
+Bundled 12 modules in 27ms
 
   docs/index.js                               1.50 KB   (entry point)
   ./index.js                                  20.30 KB  (entry point)
@@ -35,7 +35,7 @@ Bundled 12 modules in 23ms
   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 32ms
+Bundled 12 modules in 27ms
 
   docs/index.js                               1.50 KB   (entry point)
   ./index.js                                  20.30 KB  (entry point)

package/AGENTS.md

@@ -1,35 +1,59 @@
-# AI Agent Guide -- `@contractspec/example.versioned-knowledge-base`
+# AI Agent Guide — `@contractspec/example.versioned-knowledge-base`
 
 Scope: `packages/examples/versioned-knowledge-base/*`
 
-Curated, versioned knowledge base with immutable sources, rule versions, and published snapshots.
+Example: curated, versioned knowledge base with immutable sources, rule versions, and published snapshots.
 
 ## Quick Context
 
-- **Layer**: example
-- **Related Packages**: `lib.contracts-spec`, `lib.schema`
-
-## What This Demonstrates
-
-- Immutable source and versioned rule management
-- Snapshot publishing pattern
-- Entity models for KB domain
-- Memory-based handler implementation
-- Feature definition and event-driven architecture
-
-## Public Exports
-
-- `.` -- root barrel
-- `./entities` -- models
-- `./operations` -- KB operations
-- `./handlers` -- memory handlers
-- `./events` -- KB lifecycle events
-- `./versioned-knowledge-base.feature` -- feature definition
-- `./docs`, `./example`
+- Layer: `example`.
+- Package visibility: published package.
+- Primary consumers are example explorers, template authors, and documentation readers.
+- Related packages: `@contractspec/lib.contracts-spec`, `@contractspec/lib.schema`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.
+
+## Architecture
+
+- `src/docs/` contains docblocks and documentation-facing exports.
+- `src/entities/` contains domain entities and value objects.
+- `src/events.ts` is package-level event definitions.
+- `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/operations` is part of the package's public or composition surface.
+
+## Public Surface
+
+- Export `.` resolves through `./src/index.ts`.
+- Export `./docs` resolves through `./src/docs/index.ts`.
+- Export `./docs/versioned-knowledge-base.docblock` resolves through `./src/docs/versioned-knowledge-base.docblock.ts`.
+- Export `./entities` resolves through `./src/entities/index.ts`.
+- Export `./entities/models` resolves through `./src/entities/models.ts`.
+- Export `./events` resolves through `./src/events.ts`.
+- 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 `./operations` resolves through `./src/operations/index.ts`.
+- The package publishes 12 total export subpaths; keep docs aligned with `package.json`.
+
+## Guardrails
+
+- Keep the example package demonstrative, buildable, and aligned with the exported feature surface.
+- Do not add hidden production assumptions that are not actually implemented in the example.
+- Changes here can affect downstream packages such as `@contractspec/lib.contracts-spec`, `@contractspec/lib.schema`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.
+- Changes here can affect downstream packages such as `@contractspec/lib.contracts-spec`, `@contractspec/lib.schema`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.
 
 ## Local Commands
 
-- Build: `bun run build`
-- Dev: `bun run dev`
-- Test: `bun test`
-- Typecheck: `bun run typecheck`
+- `bun run dev` — contractspec-bun-build dev
+- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run test` — bun test
+- `bun run lint` — bun lint:fix
+- `bun run lint:check` — biome check .
+- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
+- `bun run typecheck` — tsc --noEmit
+- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
+- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
+- `bun run clean` — rimraf dist .turbo
+- `bun run build:bundle` — contractspec-bun-build transpile
+- `bun run build:types` — contractspec-bun-build types
+- `bun run prebuild` — contractspec-bun-build prebuild

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @contractspec/example.versioned-knowledge-base
 
+## 3.7.6
+
+### Patch Changes
+
+- fix: release manifest
+- Updated dependencies
+  - @contractspec/lib.contracts-spec@3.7.6
+  - @contractspec/lib.schema@3.7.6
+
 ## 3.7.5
 
 ### Patch Changes

package/README.md

@@ -1,35 +1,75 @@
-# `@contractspec/example.versioned-knowledge-base`
+# @contractspec/example.versioned-knowledge-base
 
-Website: https://contractspec.io/
+Website: https://contractspec.io
 
+**Example: curated, versioned knowledge base with immutable sources, rule versions, and published snapshots.**
 
-Spec-first example demonstrating a **curated, versioned knowledge base**:
+## What This Demonstrates
 
-- Raw **source documents** are immutable and referenced by hash.
-- Curated **rules** are versioned, reviewable, and must cite sources.
-- Published **KB snapshots** contain only **approved** rule versions.
-- Assistant answers reference a **snapshot id** for traceability.
+- Immutable source and versioned rule management.
+- Snapshot publishing pattern.
+- Entity models for KB domain.
+- Memory-based handler implementation.
+- Feature definition and event-driven architecture.
+- `src/docs/` contains docblocks and documentation-facing exports.
 
-## Contracts
+## Running Locally
 
-- `kb.ingestSource(docMeta, fileRef) -> SourceDocument`
-- `kb.upsertRuleVersion(ruleId, content, sourceRefs) -> RuleVersion (draft)`
-- `kb.approveRuleVersion(ruleVersionId, approver) -> RuleVersion (approved)`
-- `kb.publishSnapshot(jurisdiction, asOfDate) -> KBSnapshot`
-- `kb.search(snapshotId, query) -> results (ruleVersionIds + citations)`
+From `packages/examples/versioned-knowledge-base`:
+- `bun run dev`
+- `bun run build`
+- `bun run test`
+- `bun run typecheck`
 
-## Running tests
+## Usage
 
-```bash
-bun test
-```
+Use `@contractspec/example.versioned-knowledge-base` as a reference implementation, or import its exported surfaces into a workspace that composes ContractSpec examples and bundles.
 
+## Architecture
 
+- `src/docs/` contains docblocks and documentation-facing exports.
+- `src/entities/` contains domain entities and value objects.
+- `src/events.ts` is package-level event definitions.
+- `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/operations` is part of the package's public or composition surface.
 
+## Public Entry Points
 
+- Export `.` resolves through `./src/index.ts`.
+- Export `./docs` resolves through `./src/docs/index.ts`.
+- Export `./docs/versioned-knowledge-base.docblock` resolves through `./src/docs/versioned-knowledge-base.docblock.ts`.
+- Export `./entities` resolves through `./src/entities/index.ts`.
+- Export `./entities/models` resolves through `./src/entities/models.ts`.
+- Export `./events` resolves through `./src/events.ts`.
+- 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 `./operations` resolves through `./src/operations/index.ts`.
+- The package publishes 12 total export subpaths; keep docs aligned with `package.json`.
 
+## Local Commands
 
+- `bun run dev` — contractspec-bun-build dev
+- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run test` — bun test
+- `bun run lint` — bun lint:fix
+- `bun run lint:check` — biome check .
+- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
+- `bun run typecheck` — tsc --noEmit
+- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
+- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
+- `bun run clean` — rimraf dist .turbo
+- `bun run build:bundle` — contractspec-bun-build transpile
+- `bun run build:types` — contractspec-bun-build types
+- `bun run prebuild` — contractspec-bun-build prebuild
 
+## Recent Updates
 
+- Replace eslint+prettier by biomejs to optimize speed.
+- Missing contract layers.
 
+## Notes
 
+- Works alongside `@contractspec/lib.contracts-spec`, `@contractspec/lib.schema`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.

package/dist/browser/entities/index.js

@@ -1,5 +1,5 @@
 // src/entities/models.ts
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var SourceDocumentModel = defineSchemaModel({
   name: "SourceDocument",
   description: "Immutable raw source document metadata referencing a stored file.",

package/dist/browser/entities/models.js

@@ -1,5 +1,5 @@
 // src/entities/models.ts
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var SourceDocumentModel = defineSchemaModel({
   name: "SourceDocument",
   description: "Immutable raw source document metadata referencing a stored file.",

package/dist/browser/events.js

@@ -1,6 +1,6 @@
 // src/events.ts
 import { defineEvent } from "@contractspec/lib.contracts-spec";
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var KbSourceIngestedPayload = defineSchemaModel({
   name: "KbSourceIngestedPayload",
   description: "Emitted when a source document is ingested.",

package/dist/browser/index.js

@@ -43,7 +43,7 @@ var docBlocks = [
 ];
 registerDocBlocks(docBlocks);
 // src/entities/models.ts
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var SourceDocumentModel = defineSchemaModel({
   name: "SourceDocument",
   description: "Immutable raw source document metadata referencing a stored file.",
@@ -111,7 +111,7 @@ var KBSnapshotModel = defineSchemaModel({
 });
 // src/events.ts
 import { defineEvent } from "@contractspec/lib.contracts-spec";
-import { ScalarTypeEnum as ScalarTypeEnum2, defineSchemaModel as defineSchemaModel2 } from "@contractspec/lib.schema";
+import { defineSchemaModel as defineSchemaModel2, ScalarTypeEnum as ScalarTypeEnum2 } from "@contractspec/lib.schema";
 var KbSourceIngestedPayload = defineSchemaModel2({
   name: "KbSourceIngestedPayload",
   description: "Emitted when a source document is ingested.",
@@ -351,7 +351,7 @@ function createMemoryKbHandlers(store) {
 }
 // src/operations/kb.ts
 import { defineCommand, defineQuery } from "@contractspec/lib.contracts-spec";
-import { ScalarTypeEnum as ScalarTypeEnum3, defineSchemaModel as defineSchemaModel3 } from "@contractspec/lib.schema";
+import { defineSchemaModel as defineSchemaModel3, ScalarTypeEnum as ScalarTypeEnum3 } from "@contractspec/lib.schema";
 var IngestSourceInput = defineSchemaModel3({
   name: "KbIngestSourceInput",
   description: "Ingest immutable source metadata referencing a stored file.",

package/dist/browser/operations/index.js

@@ -1,5 +1,5 @@
 // src/entities/models.ts
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var SourceDocumentModel = defineSchemaModel({
   name: "SourceDocument",
   description: "Immutable raw source document metadata referencing a stored file.",
@@ -68,7 +68,7 @@ var KBSnapshotModel = defineSchemaModel({
 
 // src/operations/kb.ts
 import { defineCommand, defineQuery } from "@contractspec/lib.contracts-spec";
-import { ScalarTypeEnum as ScalarTypeEnum2, defineSchemaModel as defineSchemaModel2 } from "@contractspec/lib.schema";
+import { defineSchemaModel as defineSchemaModel2, ScalarTypeEnum as ScalarTypeEnum2 } from "@contractspec/lib.schema";
 var IngestSourceInput = defineSchemaModel2({
   name: "KbIngestSourceInput",
   description: "Ingest immutable source metadata referencing a stored file.",

package/dist/browser/operations/kb.js

@@ -1,5 +1,5 @@
 // src/entities/models.ts
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var SourceDocumentModel = defineSchemaModel({
   name: "SourceDocument",
   description: "Immutable raw source document metadata referencing a stored file.",
@@ -68,7 +68,7 @@ var KBSnapshotModel = defineSchemaModel({
 
 // src/operations/kb.ts
 import { defineCommand, defineQuery } from "@contractspec/lib.contracts-spec";
-import { ScalarTypeEnum as ScalarTypeEnum2, defineSchemaModel as defineSchemaModel2 } from "@contractspec/lib.schema";
+import { defineSchemaModel as defineSchemaModel2, ScalarTypeEnum as ScalarTypeEnum2 } from "@contractspec/lib.schema";
 var IngestSourceInput = defineSchemaModel2({
   name: "KbIngestSourceInput",
   description: "Ingest immutable source metadata referencing a stored file.",

package/dist/entities/index.js

@@ -1,6 +1,6 @@
 // @bun
 // src/entities/models.ts
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var SourceDocumentModel = defineSchemaModel({
   name: "SourceDocument",
   description: "Immutable raw source document metadata referencing a stored file.",

package/dist/entities/models.js

@@ -1,6 +1,6 @@
 // @bun
 // src/entities/models.ts
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var SourceDocumentModel = defineSchemaModel({
   name: "SourceDocument",
   description: "Immutable raw source document metadata referencing a stored file.",

package/dist/events.js

@@ -1,7 +1,7 @@
 // @bun
 // src/events.ts
 import { defineEvent } from "@contractspec/lib.contracts-spec";
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var KbSourceIngestedPayload = defineSchemaModel({
   name: "KbSourceIngestedPayload",
   description: "Emitted when a source document is ingested.",

package/dist/index.d.ts

@@ -4,9 +4,9 @@
  * Curated KB with immutable sources, reviewable rule versions, and published snapshots.
  */
 export * from './entities';
-export * from './operations';
 export * from './events';
+export { default as example } from './example';
 export * from './handlers';
+export * from './operations';
 export * from './versioned-knowledge-base.feature';
-export { default as example } from './example';
 import './docs';

package/dist/index.js

@@ -44,7 +44,7 @@ var docBlocks = [
 ];
 registerDocBlocks(docBlocks);
 // src/entities/models.ts
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var SourceDocumentModel = defineSchemaModel({
   name: "SourceDocument",
   description: "Immutable raw source document metadata referencing a stored file.",
@@ -112,7 +112,7 @@ var KBSnapshotModel = defineSchemaModel({
 });
 // src/events.ts
 import { defineEvent } from "@contractspec/lib.contracts-spec";
-import { ScalarTypeEnum as ScalarTypeEnum2, defineSchemaModel as defineSchemaModel2 } from "@contractspec/lib.schema";
+import { defineSchemaModel as defineSchemaModel2, ScalarTypeEnum as ScalarTypeEnum2 } from "@contractspec/lib.schema";
 var KbSourceIngestedPayload = defineSchemaModel2({
   name: "KbSourceIngestedPayload",
   description: "Emitted when a source document is ingested.",
@@ -352,7 +352,7 @@ function createMemoryKbHandlers(store) {
 }
 // src/operations/kb.ts
 import { defineCommand, defineQuery } from "@contractspec/lib.contracts-spec";
-import { ScalarTypeEnum as ScalarTypeEnum3, defineSchemaModel as defineSchemaModel3 } from "@contractspec/lib.schema";
+import { defineSchemaModel as defineSchemaModel3, ScalarTypeEnum as ScalarTypeEnum3 } from "@contractspec/lib.schema";
 var IngestSourceInput = defineSchemaModel3({
   name: "KbIngestSourceInput",
   description: "Ingest immutable source metadata referencing a stored file.",

package/dist/node/entities/index.js

@@ -1,5 +1,5 @@
 // src/entities/models.ts
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var SourceDocumentModel = defineSchemaModel({
   name: "SourceDocument",
   description: "Immutable raw source document metadata referencing a stored file.",

package/dist/node/entities/models.js

@@ -1,5 +1,5 @@
 // src/entities/models.ts
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var SourceDocumentModel = defineSchemaModel({
   name: "SourceDocument",
   description: "Immutable raw source document metadata referencing a stored file.",

package/dist/node/events.js

@@ -1,6 +1,6 @@
 // src/events.ts
 import { defineEvent } from "@contractspec/lib.contracts-spec";
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var KbSourceIngestedPayload = defineSchemaModel({
   name: "KbSourceIngestedPayload",
   description: "Emitted when a source document is ingested.",

package/dist/node/index.js

@@ -43,7 +43,7 @@ var docBlocks = [
 ];
 registerDocBlocks(docBlocks);
 // src/entities/models.ts
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var SourceDocumentModel = defineSchemaModel({
   name: "SourceDocument",
   description: "Immutable raw source document metadata referencing a stored file.",
@@ -111,7 +111,7 @@ var KBSnapshotModel = defineSchemaModel({
 });
 // src/events.ts
 import { defineEvent } from "@contractspec/lib.contracts-spec";
-import { ScalarTypeEnum as ScalarTypeEnum2, defineSchemaModel as defineSchemaModel2 } from "@contractspec/lib.schema";
+import { defineSchemaModel as defineSchemaModel2, ScalarTypeEnum as ScalarTypeEnum2 } from "@contractspec/lib.schema";
 var KbSourceIngestedPayload = defineSchemaModel2({
   name: "KbSourceIngestedPayload",
   description: "Emitted when a source document is ingested.",
@@ -351,7 +351,7 @@ function createMemoryKbHandlers(store) {
 }
 // src/operations/kb.ts
 import { defineCommand, defineQuery } from "@contractspec/lib.contracts-spec";
-import { ScalarTypeEnum as ScalarTypeEnum3, defineSchemaModel as defineSchemaModel3 } from "@contractspec/lib.schema";
+import { defineSchemaModel as defineSchemaModel3, ScalarTypeEnum as ScalarTypeEnum3 } from "@contractspec/lib.schema";
 var IngestSourceInput = defineSchemaModel3({
   name: "KbIngestSourceInput",
   description: "Ingest immutable source metadata referencing a stored file.",

package/dist/node/operations/index.js

@@ -1,5 +1,5 @@
 // src/entities/models.ts
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var SourceDocumentModel = defineSchemaModel({
   name: "SourceDocument",
   description: "Immutable raw source document metadata referencing a stored file.",
@@ -68,7 +68,7 @@ var KBSnapshotModel = defineSchemaModel({
 
 // src/operations/kb.ts
 import { defineCommand, defineQuery } from "@contractspec/lib.contracts-spec";
-import { ScalarTypeEnum as ScalarTypeEnum2, defineSchemaModel as defineSchemaModel2 } from "@contractspec/lib.schema";
+import { defineSchemaModel as defineSchemaModel2, ScalarTypeEnum as ScalarTypeEnum2 } from "@contractspec/lib.schema";
 var IngestSourceInput = defineSchemaModel2({
   name: "KbIngestSourceInput",
   description: "Ingest immutable source metadata referencing a stored file.",

package/dist/node/operations/kb.js

@@ -1,5 +1,5 @@
 // src/entities/models.ts
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var SourceDocumentModel = defineSchemaModel({
   name: "SourceDocument",
   description: "Immutable raw source document metadata referencing a stored file.",
@@ -68,7 +68,7 @@ var KBSnapshotModel = defineSchemaModel({
 
 // src/operations/kb.ts
 import { defineCommand, defineQuery } from "@contractspec/lib.contracts-spec";
-import { ScalarTypeEnum as ScalarTypeEnum2, defineSchemaModel as defineSchemaModel2 } from "@contractspec/lib.schema";
+import { defineSchemaModel as defineSchemaModel2, ScalarTypeEnum as ScalarTypeEnum2 } from "@contractspec/lib.schema";
 var IngestSourceInput = defineSchemaModel2({
   name: "KbIngestSourceInput",
   description: "Ingest immutable source metadata referencing a stored file.",

package/dist/operations/index.js

@@ -1,6 +1,6 @@
 // @bun
 // src/entities/models.ts
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var SourceDocumentModel = defineSchemaModel({
   name: "SourceDocument",
   description: "Immutable raw source document metadata referencing a stored file.",
@@ -69,7 +69,7 @@ var KBSnapshotModel = defineSchemaModel({
 
 // src/operations/kb.ts
 import { defineCommand, defineQuery } from "@contractspec/lib.contracts-spec";
-import { ScalarTypeEnum as ScalarTypeEnum2, defineSchemaModel as defineSchemaModel2 } from "@contractspec/lib.schema";
+import { defineSchemaModel as defineSchemaModel2, ScalarTypeEnum as ScalarTypeEnum2 } from "@contractspec/lib.schema";
 var IngestSourceInput = defineSchemaModel2({
   name: "KbIngestSourceInput",
   description: "Ingest immutable source metadata referencing a stored file.",

package/dist/operations/kb.js

@@ -1,6 +1,6 @@
 // @bun
 // src/entities/models.ts
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var SourceDocumentModel = defineSchemaModel({
   name: "SourceDocument",
   description: "Immutable raw source document metadata referencing a stored file.",
@@ -69,7 +69,7 @@ var KBSnapshotModel = defineSchemaModel({
 
 // src/operations/kb.ts
 import { defineCommand, defineQuery } from "@contractspec/lib.contracts-spec";
-import { ScalarTypeEnum as ScalarTypeEnum2, defineSchemaModel as defineSchemaModel2 } from "@contractspec/lib.schema";
+import { defineSchemaModel as defineSchemaModel2, ScalarTypeEnum as ScalarTypeEnum2 } from "@contractspec/lib.schema";
 var IngestSourceInput = defineSchemaModel2({
   name: "KbIngestSourceInput",
   description: "Ingest immutable source metadata referencing a stored file.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/example.versioned-knowledge-base",
-  "version": "3.7.5",
+  "version": "3.7.7",
   "description": "Example: curated, versioned knowledge base with immutable sources, rule versions, and published snapshots.",
   "type": "module",
   "types": "./dist/index.d.ts",
@@ -99,20 +99,20 @@
     "dev": "contractspec-bun-build dev",
     "clean": "rimraf dist .turbo",
     "lint": "bun lint:fix",
-    "lint:fix": "eslint src --fix",
-    "lint:check": "eslint src",
+    "lint:fix": "biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .",
+    "lint:check": "biome check .",
     "test": "bun test",
     "prebuild": "contractspec-bun-build prebuild",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@contractspec/lib.contracts-spec": "3.7.5",
-    "@contractspec/lib.schema": "3.7.5"
+    "@contractspec/lib.contracts-spec": "4.0.0",
+    "@contractspec/lib.schema": "3.7.6"
   },
   "devDependencies": {
-    "@contractspec/tool.typescript": "3.7.5",
+    "@contractspec/tool.typescript": "3.7.6",
     "typescript": "^5.9.3",
-    "@contractspec/tool.bun": "3.7.5"
+    "@contractspec/tool.bun": "3.7.6"
   },
   "publishConfig": {
     "access": "public",

package/src/docs/versioned-knowledge-base.docblock.ts

@@ -2,28 +2,28 @@ import type { DocBlock } from '@contractspec/lib.contracts-spec/docs';
 import { registerDocBlocks } from '@contractspec/lib.contracts-spec/docs';
 
 const docBlocks: DocBlock[] = [
-  {
-    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
+	{
+		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.\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.`,
-  },
-  {
-    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\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`,
-  },
+	},
+	{
+		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\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`,
+	},
 ];
 
 registerDocBlocks(docBlocks);