@contractspec/example.kb-update-pipeline 0.0.0-canary-20260113162409

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

@@ -0,0 +1,55 @@
+$ tsdown
+ℹ tsdown v0.19.0 powered by rolldown v1.0.0-beta.59
+ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/kb-update-pipeline/tsdown.config.js 
+ℹ entry: src/events.ts, src/example.ts, src/index.ts, src/kb-update-pipeline.feature.ts, src/presentations.ts, src/docs/index.ts, src/docs/kb-update-pipeline.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/pipeline.ts, src/tests/operations.test-spec.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ Cleaning 50 files
+ℹ dist/operations/pipeline.js                   4.95 kB │ gzip: 1.37 kB
+ℹ dist/events.js                                3.69 kB │ gzip: 0.73 kB
+ℹ dist/handlers/memory.handlers.js              3.37 kB │ gzip: 1.12 kB
+ℹ dist/kb-update-pipeline.feature.js            2.35 kB │ gzip: 0.68 kB
+ℹ dist/tests/operations.test-spec.js            2.13 kB │ gzip: 0.50 kB
+ℹ dist/presentations.js                         1.90 kB │ gzip: 0.63 kB
+ℹ dist/entities/models.js                       1.81 kB │ gzip: 0.53 kB
+ℹ dist/docs/kb-update-pipeline.docblock.js      1.49 kB │ gzip: 0.71 kB
+ℹ dist/index.js                                 1.44 kB │ gzip: 0.42 kB
+ℹ dist/example.js                               1.05 kB │ gzip: 0.55 kB
+ℹ dist/operations/index.js                      0.31 kB │ gzip: 0.14 kB
+ℹ dist/entities/index.js                        0.25 kB │ gzip: 0.13 kB
+ℹ dist/handlers/index.js                        0.16 kB │ gzip: 0.10 kB
+ℹ dist/docs/index.js                            0.04 kB │ gzip: 0.06 kB
+ℹ dist/handlers/memory.handlers.js.map          8.13 kB │ gzip: 2.34 kB
+ℹ dist/operations/pipeline.js.map               7.20 kB │ gzip: 1.81 kB
+ℹ dist/events.js.map                            5.65 kB │ gzip: 1.04 kB
+ℹ dist/tests/operations.test-spec.js.map        3.64 kB │ gzip: 0.76 kB
+ℹ dist/kb-update-pipeline.feature.js.map        3.48 kB │ gzip: 1.02 kB
+ℹ dist/presentations.js.map                     2.87 kB │ gzip: 0.83 kB
+ℹ dist/entities/models.js.map                   2.68 kB │ gzip: 0.81 kB
+ℹ dist/docs/kb-update-pipeline.docblock.js.map  2.00 kB │ gzip: 0.89 kB
+ℹ dist/example.js.map                           1.51 kB │ gzip: 0.75 kB
+ℹ dist/handlers/memory.handlers.d.ts.map        0.92 kB │ gzip: 0.44 kB
+ℹ dist/events.d.ts.map                          0.81 kB │ gzip: 0.33 kB
+ℹ dist/operations/pipeline.d.ts.map             0.76 kB │ gzip: 0.33 kB
+ℹ dist/entities/models.d.ts.map                 0.47 kB │ gzip: 0.28 kB
+ℹ dist/tests/operations.test-spec.d.ts.map      0.23 kB │ gzip: 0.16 kB
+ℹ dist/presentations.d.ts.map                   0.20 kB │ gzip: 0.15 kB
+ℹ dist/kb-update-pipeline.feature.d.ts.map      0.18 kB │ gzip: 0.15 kB
+ℹ dist/example.d.ts.map                         0.14 kB │ gzip: 0.13 kB
+ℹ dist/operations/pipeline.d.ts                 4.38 kB │ gzip: 0.58 kB
+ℹ dist/events.d.ts                              2.52 kB │ gzip: 0.42 kB
+ℹ dist/entities/models.d.ts                     2.00 kB │ gzip: 0.41 kB
+ℹ dist/handlers/memory.handlers.d.ts            1.94 kB │ gzip: 0.64 kB
+ℹ dist/index.d.ts                               1.48 kB │ gzip: 0.41 kB
+ℹ dist/presentations.d.ts                       0.52 kB │ gzip: 0.20 kB
+ℹ dist/tests/operations.test-spec.d.ts          0.47 kB │ gzip: 0.22 kB
+ℹ dist/kb-update-pipeline.feature.d.ts          0.32 kB │ gzip: 0.19 kB
+ℹ dist/operations/index.d.ts                    0.31 kB │ gzip: 0.13 kB
+ℹ dist/handlers/index.d.ts                      0.25 kB │ gzip: 0.10 kB
+ℹ dist/example.d.ts                             0.25 kB │ gzip: 0.17 kB
+ℹ dist/entities/index.d.ts                      0.25 kB │ gzip: 0.13 kB
+ℹ dist/docs/index.d.ts                          0.01 kB │ gzip: 0.03 kB
+ℹ dist/docs/kb-update-pipeline.docblock.d.ts    0.01 kB │ gzip: 0.03 kB
+ℹ 45 files, total: 80.49 kB
+✔ Build complete in 29882ms

package/.turbo/turbo-build.log

@@ -0,0 +1,56 @@
+$ bun build:types && bun build:bundle
+$ tsc --noEmit
+$ tsdown
+ℹ tsdown v0.19.0 powered by rolldown v1.0.0-beta.59
+ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/kb-update-pipeline/tsdown.config.js 
+ℹ entry: src/events.ts, src/example.ts, src/index.ts, src/kb-update-pipeline.feature.ts, src/presentations.ts, src/docs/index.ts, src/docs/kb-update-pipeline.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/pipeline.ts, src/tests/operations.test-spec.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ dist/operations/pipeline.js                   4.95 kB │ gzip: 1.37 kB
+ℹ dist/events.js                                3.69 kB │ gzip: 0.73 kB
+ℹ dist/handlers/memory.handlers.js              3.37 kB │ gzip: 1.12 kB
+ℹ dist/kb-update-pipeline.feature.js            2.35 kB │ gzip: 0.68 kB
+ℹ dist/tests/operations.test-spec.js            2.13 kB │ gzip: 0.50 kB
+ℹ dist/presentations.js                         1.90 kB │ gzip: 0.63 kB
+ℹ dist/entities/models.js                       1.81 kB │ gzip: 0.53 kB
+ℹ dist/docs/kb-update-pipeline.docblock.js      1.49 kB │ gzip: 0.71 kB
+ℹ dist/index.js                                 1.44 kB │ gzip: 0.42 kB
+ℹ dist/example.js                               1.05 kB │ gzip: 0.55 kB
+ℹ dist/operations/index.js                      0.31 kB │ gzip: 0.14 kB
+ℹ dist/entities/index.js                        0.25 kB │ gzip: 0.13 kB
+ℹ dist/handlers/index.js                        0.16 kB │ gzip: 0.10 kB
+ℹ dist/docs/index.js                            0.04 kB │ gzip: 0.06 kB
+ℹ dist/handlers/memory.handlers.js.map          8.13 kB │ gzip: 2.34 kB
+ℹ dist/operations/pipeline.js.map               7.20 kB │ gzip: 1.81 kB
+ℹ dist/events.js.map                            5.65 kB │ gzip: 1.04 kB
+ℹ dist/tests/operations.test-spec.js.map        3.64 kB │ gzip: 0.76 kB
+ℹ dist/kb-update-pipeline.feature.js.map        3.48 kB │ gzip: 1.02 kB
+ℹ dist/presentations.js.map                     2.87 kB │ gzip: 0.83 kB
+ℹ dist/entities/models.js.map                   2.68 kB │ gzip: 0.81 kB
+ℹ dist/docs/kb-update-pipeline.docblock.js.map  2.00 kB │ gzip: 0.89 kB
+ℹ dist/example.js.map                           1.51 kB │ gzip: 0.75 kB
+ℹ dist/handlers/memory.handlers.d.ts.map        0.92 kB │ gzip: 0.44 kB
+ℹ dist/events.d.ts.map                          0.81 kB │ gzip: 0.33 kB
+ℹ dist/operations/pipeline.d.ts.map             0.76 kB │ gzip: 0.33 kB
+ℹ dist/entities/models.d.ts.map                 0.47 kB │ gzip: 0.28 kB
+ℹ dist/tests/operations.test-spec.d.ts.map      0.23 kB │ gzip: 0.16 kB
+ℹ dist/presentations.d.ts.map                   0.20 kB │ gzip: 0.15 kB
+ℹ dist/kb-update-pipeline.feature.d.ts.map      0.18 kB │ gzip: 0.15 kB
+ℹ dist/example.d.ts.map                         0.14 kB │ gzip: 0.13 kB
+ℹ dist/operations/pipeline.d.ts                 4.37 kB │ gzip: 0.58 kB
+ℹ dist/events.d.ts                              2.52 kB │ gzip: 0.42 kB
+ℹ dist/entities/models.d.ts                     2.00 kB │ gzip: 0.41 kB
+ℹ dist/handlers/memory.handlers.d.ts            1.94 kB │ gzip: 0.64 kB
+ℹ dist/index.d.ts                               1.48 kB │ gzip: 0.41 kB
+ℹ dist/presentations.d.ts                       0.52 kB │ gzip: 0.20 kB
+ℹ dist/tests/operations.test-spec.d.ts          0.47 kB │ gzip: 0.22 kB
+ℹ dist/kb-update-pipeline.feature.d.ts          0.32 kB │ gzip: 0.19 kB
+ℹ dist/operations/index.d.ts                    0.31 kB │ gzip: 0.13 kB
+ℹ dist/handlers/index.d.ts                      0.25 kB │ gzip: 0.10 kB
+ℹ dist/example.d.ts                             0.25 kB │ gzip: 0.17 kB
+ℹ dist/entities/index.d.ts                      0.25 kB │ gzip: 0.13 kB
+ℹ dist/docs/index.d.ts                          0.01 kB │ gzip: 0.03 kB
+ℹ dist/docs/kb-update-pipeline.docblock.d.ts    0.01 kB │ gzip: 0.03 kB
+ℹ 45 files, total: 80.49 kB
+✔ Build complete in 29502ms

package/CHANGELOG.md

@@ -0,0 +1,342 @@
+# @contractspec/example.kb-update-pipeline
+
+## 0.0.0-canary-20260113162409
+
+### Minor Changes
+
+- caf8701: feat: add cli vibe command to run workflow
+- c69b849: feat: add api web services (mcp & website)
+- 42b8d78: feat: add cli `contractspec vibe` workflow to simplify usage
+- fd38e85: feat: auto-fix contractspec issues
+
+### Patch Changes
+
+- e7ded36: feat: improve stability (adding ts-morph)
+- c231a8b: test: improve workspace stability
+- Updated dependencies [e7ded36]
+- Updated dependencies [caf8701]
+- Updated dependencies [c69b849]
+- Updated dependencies [c231a8b]
+- Updated dependencies [42b8d78]
+- Updated dependencies [fd38e85]
+  - @contractspec/lib.contracts@0.0.0-canary-20260113162409
+  - @contractspec/lib.schema@0.0.0-canary-20260113162409
+
+## 1.46.2
+
+### Patch Changes
+
+- 7e21625: feat: library services (landing page & api)
+- Updated dependencies [7e21625]
+  - @contractspec/lib.contracts@1.46.2
+  - @contractspec/lib.schema@1.46.2
+
+## 1.46.1
+
+### Patch Changes
+
+- 2d8a72b: fix: mcp for presentation
+- Updated dependencies [2d8a72b]
+  - @contractspec/lib.contracts@1.46.1
+  - @contractspec/lib.schema@1.46.1
+
+## 1.46.0
+
+### Minor Changes
+
+- 07cb19b: feat: feat: cleaude code & opencode integrations
+
+### Patch Changes
+
+- Updated dependencies [07cb19b]
+  - @contractspec/lib.contracts@1.46.0
+  - @contractspec/lib.schema@1.46.0
+
+## 1.45.6
+
+### Patch Changes
+
+- a913074: feat: improve ai agents rules management"
+- Updated dependencies [a913074]
+  - @contractspec/lib.contracts@1.45.6
+  - @contractspec/lib.schema@1.45.6
+
+## 1.45.5
+
+### Patch Changes
+
+- 9ddd7fa: feat: improve versioning
+- Updated dependencies [9ddd7fa]
+  - @contractspec/lib.contracts@1.45.5
+  - @contractspec/lib.schema@1.45.5
+
+## 1.45.4
+
+### Patch Changes
+
+- fix: github action
+- Updated dependencies
+  - @contractspec/lib.contracts@1.45.4
+  - @contractspec/lib.schema@1.45.4
+
+## 1.45.3
+
+### Patch Changes
+
+- e74ea9e: feat: version management
+- Updated dependencies [e74ea9e]
+  - @contractspec/lib.contracts@1.45.3
+  - @contractspec/lib.schema@1.45.3
+
+## 1.45.2
+
+### Patch Changes
+
+- 39ca241: code cleaning
+- Updated dependencies [39ca241]
+  - @contractspec/lib.contracts@1.45.2
+  - @contractspec/lib.schema@1.45.2
+
+## 1.45.1
+
+### Patch Changes
+
+- feat: improve app config and examples contracts
+- Updated dependencies
+  - @contractspec/module.notifications@1.45.1
+  - @contractspec/lib.identity-rbac@1.45.1
+  - @contractspec/lib.contracts@1.45.1
+  - @contractspec/lib.schema@1.45.1
+
+## 1.45.0
+
+### Minor Changes
+
+- e73ca1d: feat: improve app config and examples contracts
+  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
+
+### Patch Changes
+
+- Updated dependencies [e73ca1d]
+  - @contractspec/module.notifications@1.45.0
+  - @contractspec/lib.identity-rbac@1.45.0
+  - @contractspec/lib.contracts@1.45.0
+  - @contractspec/lib.schema@1.45.0
+
+## 1.44.1
+
+### Patch Changes
+
+- 3c594fb: fix
+- Updated dependencies [3c594fb]
+  - @contractspec/module.notifications@1.44.1
+  - @contractspec/lib.identity-rbac@1.44.1
+  - @contractspec/lib.contracts@1.44.1
+  - @contractspec/lib.schema@1.44.1
+
+## 1.44.0
+
+### Minor Changes
+
+- 5f3a868: chore: isolate branding to contractspec.io
+
+### Patch Changes
+
+- Updated dependencies [5f3a868]
+  - @contractspec/module.notifications@1.44.0
+  - @contractspec/lib.identity-rbac@1.44.0
+  - @contractspec/lib.contracts@1.44.0
+  - @contractspec/lib.schema@1.44.0
+
+## 1.43.4
+
+### Patch Changes
+
+- 9216062: fix: cross-platform compatibility
+- Updated dependencies [9216062]
+  - @contractspec/module.notifications@1.43.4
+  - @contractspec/lib.identity-rbac@1.43.4
+  - @contractspec/lib.contracts@1.43.4
+  - @contractspec/lib.schema@1.43.3
+
+## 1.43.3
+
+### Patch Changes
+
+- 24d9759: improve documentation
+- Updated dependencies [24d9759]
+  - @contractspec/module.notifications@1.43.3
+  - @contractspec/lib.identity-rbac@1.43.3
+  - @contractspec/lib.contracts@1.43.3
+  - @contractspec/lib.schema@1.43.2
+
+## 1.43.2
+
+### Patch Changes
+
+- e147271: fix: improve stability
+- Updated dependencies [e147271]
+  - @contractspec/module.notifications@1.43.2
+  - @contractspec/lib.identity-rbac@1.43.2
+  - @contractspec/lib.contracts@1.43.2
+  - @contractspec/lib.schema@1.43.1
+
+## 1.43.1
+
+### Patch Changes
+
+- Updated dependencies [f28fdad]
+  - @contractspec/lib.contracts@1.43.1
+  - @contractspec/lib.identity-rbac@1.43.1
+  - @contractspec/module.notifications@1.43.1
+
+## 1.43.0
+
+### Minor Changes
+
+- 042d072: feat: schema declaration using json schema, including zod
+
+### Patch Changes
+
+- Updated dependencies [042d072]
+  - @contractspec/module.notifications@1.43.0
+  - @contractspec/lib.identity-rbac@1.43.0
+  - @contractspec/lib.contracts@1.43.0
+  - @contractspec/lib.schema@1.43.0
+
+## 1.42.10
+
+### Patch Changes
+
+- 1e6a0f1: fix: mcp server
+- Updated dependencies [1e6a0f1]
+  - @contractspec/module.notifications@1.42.10
+  - @contractspec/lib.identity-rbac@1.42.10
+  - @contractspec/lib.contracts@1.42.10
+  - @contractspec/lib.schema@1.42.10
+
+## 1.42.9
+
+### Patch Changes
+
+- 9281db7: fix ModelRegistry
+- Updated dependencies [9281db7]
+  - @contractspec/module.notifications@1.42.9
+  - @contractspec/lib.identity-rbac@1.42.9
+  - @contractspec/lib.contracts@1.42.9
+  - @contractspec/lib.schema@1.42.9
+
+## 1.42.8
+
+### Patch Changes
+
+- e07b5ac: fix
+- Updated dependencies [e07b5ac]
+  - @contractspec/module.notifications@1.42.8
+  - @contractspec/lib.identity-rbac@1.42.8
+  - @contractspec/lib.contracts@1.42.8
+  - @contractspec/lib.schema@1.42.8
+
+## 1.42.7
+
+### Patch Changes
+
+- e9b575d: fix release
+- Updated dependencies [e9b575d]
+  - @contractspec/module.notifications@1.42.7
+  - @contractspec/lib.identity-rbac@1.42.7
+  - @contractspec/lib.contracts@1.42.7
+  - @contractspec/lib.schema@1.42.7
+
+## 1.42.6
+
+### Patch Changes
+
+- 1500242: fix tooling
+- Updated dependencies [1500242]
+  - @contractspec/module.notifications@1.42.6
+  - @contractspec/lib.identity-rbac@1.42.6
+  - @contractspec/lib.contracts@1.42.6
+  - @contractspec/lib.schema@1.42.6
+
+## 1.42.5
+
+### Patch Changes
+
+- 1299719: fix vscode
+- Updated dependencies [1299719]
+  - @contractspec/module.notifications@1.42.5
+  - @contractspec/lib.identity-rbac@1.42.5
+  - @contractspec/lib.contracts@1.42.5
+  - @contractspec/lib.schema@1.42.5
+
+## 1.42.4
+
+### Patch Changes
+
+- ac28b99: fix: generate from openapi
+- Updated dependencies [ac28b99]
+  - @contractspec/module.notifications@1.42.4
+  - @contractspec/lib.identity-rbac@1.42.4
+  - @contractspec/lib.contracts@1.42.4
+  - @contractspec/lib.schema@1.42.4
+
+## 1.42.3
+
+### Patch Changes
+
+- 3f5d015: fix(tooling): cicd
+- Updated dependencies [3f5d015]
+  - @contractspec/lib.contracts@1.42.3
+  - @contractspec/lib.identity-rbac@1.42.3
+  - @contractspec/lib.schema@1.42.3
+  - @contractspec/module.notifications@1.42.3
+
+## 1.42.2
+
+### Patch Changes
+
+- 1f9ac4c: fix
+- Updated dependencies [1f9ac4c]
+  - @contractspec/lib.contracts@1.42.2
+  - @contractspec/lib.identity-rbac@1.42.2
+  - @contractspec/lib.schema@1.42.2
+  - @contractspec/module.notifications@1.42.2
+
+## 1.42.1
+
+### Patch Changes
+
+- f043995: Fix release
+- Updated dependencies [f043995]
+  - @contractspec/module.notifications@1.42.1
+  - @contractspec/lib.identity-rbac@1.42.1
+  - @contractspec/lib.contracts@1.42.1
+  - @contractspec/lib.schema@1.42.1
+
+## 1.42.0
+
+### Minor Changes
+
+- 8eefd9c: initial release
+
+### Patch Changes
+
+- Updated dependencies [8eefd9c]
+  - @contractspec/lib.contracts@1.42.0
+  - @contractspec/lib.identity-rbac@1.42.0
+  - @contractspec/lib.schema@1.42.0
+  - @contractspec/module.notifications@1.42.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chaman Ventures, SASU
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,28 @@
+# `@contractspec/example.kb-update-pipeline`
+
+Website: https://contractspec.io/
+
+Spec-first example for a **knowledge base update pipeline** where:
+
+- automation **proposes** changes (watch/diff/summarize/propose patches)\n+- humans **verify** (HITL) with role-based rules\n+- snapshots are published only when rule versions are approved\n+- notifications + audit trails provide traceability\n+
+## Contracts
+
+- `kbPipeline.runWatch()`\n+- `kbPipeline.createReviewTask(changeCandidateId)`\n+- `kbPipeline.submitDecision(reviewTaskId, decision)`\n+- `kbPipeline.publishIfReady(jurisdiction)`\n+
+## Tests
+
+- high-risk change cannot be approved by curator role\n+- publish fails if any included rule versions are unapproved\n+- notifications fire on review requested\n+
+## Running tests
+
+```bash
+bun test
+```
+
+
+
+
+
+
+
+
+
+

package/dist/docs/index.d.ts

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

package/dist/docs/index.js

@@ -0,0 +1 @@
+import "./kb-update-pipeline.docblock.js";

package/dist/docs/kb-update-pipeline.docblock.d.ts

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

package/dist/docs/kb-update-pipeline.docblock.js

@@ -0,0 +1,31 @@
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+
+//#region src/docs/kb-update-pipeline.docblock.ts
+registerDocBlocks([{
+	id: "docs.examples.kb-update-pipeline.goal",
+	title: "KB Update Pipeline — Goal",
+	summary: "Automation proposes KB patches; humans verify; publishing is blocked until approvals are complete.",
+	kind: "goal",
+	visibility: "public",
+	route: "/docs/examples/kb-update-pipeline/goal",
+	tags: [
+		"knowledge",
+		"pipeline",
+		"hitl",
+		"audit"
+	],
+	body: `## Why it matters
+- Keeps humans as the verifiers (HITL) while automation does the busywork.\n- Produces an auditable chain: source change -> diff -> proposal -> review -> publish.\n\n## Guardrails\n- High-risk changes require expert approval.\n- Publishing fails if any included rule versions are not approved.\n- Review requests emit notifications/events.`
+}, {
+	id: "docs.examples.kb-update-pipeline.reference",
+	title: "KB Update Pipeline — Reference",
+	summary: "Entities, contracts, and events for the KB update pipeline example.",
+	kind: "reference",
+	visibility: "public",
+	route: "/docs/examples/kb-update-pipeline",
+	tags: ["knowledge", "reference"],
+	body: `## Contracts\n- kbPipeline.runWatch\n- kbPipeline.createReviewTask\n- kbPipeline.submitDecision\n- kbPipeline.publishIfReady\n\n## Events\n- kb.change.detected\n- kb.change.summarized\n- kb.patch.proposed\n- kb.review.requested\n- kb.review.decided`
+}]);
+
+//#endregion
+//# sourceMappingURL=kb-update-pipeline.docblock.js.map

package/dist/docs/kb-update-pipeline.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kb-update-pipeline.docblock.js","names":[],"sources":["../../src/docs/kb-update-pipeline.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.kb-update-pipeline.goal',\n    title: 'KB Update Pipeline — Goal',\n    summary:\n      'Automation proposes KB patches; humans verify; publishing is blocked until approvals are complete.',\n    kind: 'goal',\n    visibility: 'public',\n    route: '/docs/examples/kb-update-pipeline/goal',\n    tags: ['knowledge', 'pipeline', 'hitl', 'audit'],\n    body: `## Why it matters\n- Keeps humans as the verifiers (HITL) while automation does the busywork.\\n- Produces an auditable chain: source change -> diff -> proposal -> review -> publish.\\n\\n## Guardrails\\n- High-risk changes require expert approval.\\n- Publishing fails if any included rule versions are not approved.\\n- Review requests emit notifications/events.`,\n  },\n  {\n    id: 'docs.examples.kb-update-pipeline.reference',\n    title: 'KB Update Pipeline — Reference',\n    summary:\n      'Entities, contracts, and events for the KB update pipeline example.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/examples/kb-update-pipeline',\n    tags: ['knowledge', 'reference'],\n    body: `## Contracts\\n- kbPipeline.runWatch\\n- kbPipeline.createReviewTask\\n- kbPipeline.submitDecision\\n- kbPipeline.publishIfReady\\n\\n## Events\\n- kb.change.detected\\n- kb.change.summarized\\n- kb.patch.proposed\\n- kb.review.requested\\n- kb.review.decided`,\n  },\n];\n\nregisterDocBlocks(docBlocks);\n"],"mappings":";;;AA6BA,kBA1B8B,CAC5B;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EAAC;EAAa;EAAY;EAAQ;EAAQ;CAChD,MAAM;;CAEP,EACD;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM,CAAC,aAAa,YAAY;CAChC,MAAM;CACP,CACF,CAE2B"}

package/dist/entities/index.d.ts

@@ -0,0 +1,2 @@
+import { ChangeCandidateModel, ChangeRiskLevelEnum, ReviewAssignedRoleEnum, ReviewDecisionEnum, ReviewTaskModel } from "./models.js";
+export { ChangeCandidateModel, ChangeRiskLevelEnum, ReviewAssignedRoleEnum, ReviewDecisionEnum, ReviewTaskModel };

package/dist/entities/index.js

@@ -0,0 +1,3 @@
+import { ChangeCandidateModel, ChangeRiskLevelEnum, ReviewAssignedRoleEnum, ReviewDecisionEnum, ReviewTaskModel } from "./models.js";
+
+export { ChangeCandidateModel, ChangeRiskLevelEnum, ReviewAssignedRoleEnum, ReviewDecisionEnum, ReviewTaskModel };

package/dist/entities/models.d.ts

@@ -0,0 +1,61 @@
+import * as _contractspec_lib_schema18 from "@contractspec/lib.schema";
+
+//#region src/entities/models.d.ts
+declare const ChangeRiskLevelEnum: _contractspec_lib_schema18.EnumType<[string, string, string]>;
+declare const ReviewAssignedRoleEnum: _contractspec_lib_schema18.EnumType<[string, string]>;
+declare const ReviewDecisionEnum: _contractspec_lib_schema18.EnumType<[string, string]>;
+declare const ChangeCandidateModel: _contractspec_lib_schema18.SchemaModel<{
+  id: {
+    type: _contractspec_lib_schema18.FieldType<string, string>;
+    isOptional: false;
+  };
+  sourceDocumentId: {
+    type: _contractspec_lib_schema18.FieldType<string, string>;
+    isOptional: false;
+  };
+  detectedAt: {
+    type: _contractspec_lib_schema18.FieldType<Date, string>;
+    isOptional: false;
+  };
+  diffSummary: {
+    type: _contractspec_lib_schema18.FieldType<string, string>;
+    isOptional: false;
+  };
+  riskLevel: {
+    type: _contractspec_lib_schema18.EnumType<[string, string, string]>;
+    isOptional: false;
+  };
+}>;
+declare const ReviewTaskModel: _contractspec_lib_schema18.SchemaModel<{
+  id: {
+    type: _contractspec_lib_schema18.FieldType<string, string>;
+    isOptional: false;
+  };
+  changeCandidateId: {
+    type: _contractspec_lib_schema18.FieldType<string, string>;
+    isOptional: false;
+  };
+  status: {
+    type: _contractspec_lib_schema18.FieldType<string, string>;
+    isOptional: false;
+  };
+  assignedRole: {
+    type: _contractspec_lib_schema18.EnumType<[string, string]>;
+    isOptional: false;
+  };
+  decision: {
+    type: _contractspec_lib_schema18.EnumType<[string, string]>;
+    isOptional: true;
+  };
+  decidedAt: {
+    type: _contractspec_lib_schema18.FieldType<Date, string>;
+    isOptional: true;
+  };
+  decidedBy: {
+    type: _contractspec_lib_schema18.FieldType<string, string>;
+    isOptional: true;
+  };
+}>;
+//#endregion
+export { ChangeCandidateModel, ChangeRiskLevelEnum, ReviewAssignedRoleEnum, ReviewDecisionEnum, ReviewTaskModel };
+//# sourceMappingURL=models.d.ts.map

package/dist/entities/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","names":[],"sources":["../../src/entities/models.ts"],"sourcesContent":[],"mappings":";;;cAMa,qBAIX,0BAAA,CAJ8B;cAMnB,wBAGX,0BAAA,CAHiC;cAKtB,oBAGX,0BAAA,CAH6B;AAXlB,cAgBA,oBAZX,6BAY+B,WAhBD,CAAA;EAMnB,EAAA,EAAA;IAKA,IAAA,EAkBX,0BAAA,CAAA,SAfA,CAAA,MAH6B,EAAA,MAAA,CAAA;IAKlB,UAAA,EAAA,KAAA;EAaX,CAAA;;;;;;8CAb+B,KAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EAepB,CAAA;EAeX,WAAA,EAAA;;;;;;;;;AAf0B,cAAf,eAAe,6BAAA,WAAA,CAAA;;UAe1B,0BAAA,CAAA"}