@contractspec/example.versioned-knowledge-base 1.44.0

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

@@ -0,0 +1,47 @@
+$ tsdown
+ℹ tsdown v0.18.3 powered by rolldown v1.0.0-beta.57
+ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/versioned-knowledge-base/tsdown.config.js 
+ℹ entry: src/events.ts, src/example.ts, src/index.ts, src/versioned-knowledge-base.feature.ts, src/docs/index.ts, src/docs/versioned-knowledge-base.docblock.ts, src/entities/index.ts, src/entities/models.ts, src/handlers/index.ts, src/handlers/memory.handlers.ts, src/operations/index.ts, src/operations/kb.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ Cleaning 41 files
+ℹ dist/operations/kb.js                               6.43 kB │ gzip: 1.57 kB
+ℹ dist/handlers/memory.handlers.js                    3.50 kB │ gzip: 1.21 kB
+ℹ dist/entities/models.js                             3.38 kB │ gzip: 0.68 kB
+ℹ dist/events.js                                      3.13 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.19 kB │ gzip: 0.46 kB
+ℹ dist/index.js                                       1.16 kB │ gzip: 0.35 kB
+ℹ dist/example.js                                     0.89 kB │ gzip: 0.46 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.48 kB │ gzip: 2.10 kB
+ℹ dist/handlers/memory.handlers.js.map                8.62 kB │ gzip: 2.48 kB
+ℹ dist/entities/models.js.map                         5.08 kB │ gzip: 1.01 kB
+ℹ dist/events.js.map                                  4.70 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.92 kB │ gzip: 0.72 kB
+ℹ dist/example.js.map                                 1.27 kB │ gzip: 0.63 kB
+ℹ dist/handlers/memory.handlers.d.ts.map              1.17 kB │ gzip: 0.53 kB
+ℹ dist/operations/kb.d.ts.map                         1.11 kB │ gzip: 0.39 kB
+ℹ dist/entities/models.d.ts.map                       0.69 kB │ gzip: 0.32 kB
+ℹ dist/events.d.ts.map                                0.67 kB │ gzip: 0.28 kB
+ℹ dist/versioned-knowledge-base.feature.d.ts.map      0.18 kB │ gzip: 0.14 kB
+ℹ dist/example.d.ts.map                               0.14 kB │ gzip: 0.13 kB
+ℹ dist/operations/kb.d.ts                             7.75 kB │ gzip: 0.64 kB
+ℹ dist/entities/models.d.ts                           3.88 kB │ gzip: 0.52 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/example.d.ts                                   1.14 kB │ gzip: 0.46 kB
+ℹ dist/versioned-knowledge-base.feature.d.ts          0.30 kB │ gzip: 0.18 kB
+ℹ dist/operations/index.d.ts                          0.29 kB │ gzip: 0.13 kB
+ℹ dist/entities/index.d.ts                            0.21 kB │ gzip: 0.11 kB
+ℹ dist/handlers/index.d.ts                            0.20 kB │ gzip: 0.10 kB
+ℹ dist/docs/index.d.ts                                0.01 kB │ gzip: 0.03 kB
+ℹ dist/docs/versioned-knowledge-base.docblock.d.ts    0.01 kB │ gzip: 0.03 kB
+ℹ 37 files, total: 78.00 kB
+✔ Build complete in 20769ms

package/.turbo/turbo-build.log

@@ -0,0 +1,48 @@
+$ bun build:types && bun build:bundle
+$ tsc --noEmit
+$ tsdown
+ℹ tsdown v0.18.3 powered by rolldown v1.0.0-beta.57
+ℹ 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.43 kB │ gzip: 1.57 kB
+ℹ dist/handlers/memory.handlers.js                    3.50 kB │ gzip: 1.21 kB
+ℹ dist/entities/models.js                             3.38 kB │ gzip: 0.68 kB
+ℹ dist/events.js                                      3.13 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.19 kB │ gzip: 0.46 kB
+ℹ dist/index.js                                       1.16 kB │ gzip: 0.35 kB
+ℹ dist/example.js                                     0.89 kB │ gzip: 0.46 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.48 kB │ gzip: 2.10 kB
+ℹ dist/handlers/memory.handlers.js.map                8.62 kB │ gzip: 2.48 kB
+ℹ dist/entities/models.js.map                         5.08 kB │ gzip: 1.01 kB
+ℹ dist/events.js.map                                  4.70 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.92 kB │ gzip: 0.72 kB
+ℹ dist/example.js.map                                 1.27 kB │ gzip: 0.63 kB
+ℹ dist/handlers/memory.handlers.d.ts.map              1.17 kB │ gzip: 0.53 kB
+ℹ dist/operations/kb.d.ts.map                         1.11 kB │ gzip: 0.39 kB
+ℹ dist/entities/models.d.ts.map                       0.69 kB │ gzip: 0.32 kB
+ℹ dist/events.d.ts.map                                0.67 kB │ gzip: 0.28 kB
+ℹ dist/versioned-knowledge-base.feature.d.ts.map      0.18 kB │ gzip: 0.14 kB
+ℹ dist/example.d.ts.map                               0.14 kB │ gzip: 0.13 kB
+ℹ dist/operations/kb.d.ts                             7.68 kB │ gzip: 0.63 kB
+ℹ dist/entities/models.d.ts                           3.88 kB │ gzip: 0.52 kB
+ℹ dist/events.d.ts                                    2.15 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/example.d.ts                                   1.14 kB │ gzip: 0.46 kB
+ℹ dist/versioned-knowledge-base.feature.d.ts          0.30 kB │ gzip: 0.18 kB
+ℹ dist/operations/index.d.ts                          0.29 kB │ gzip: 0.13 kB
+ℹ dist/entities/index.d.ts                            0.21 kB │ gzip: 0.11 kB
+ℹ dist/handlers/index.d.ts                            0.20 kB │ gzip: 0.10 kB
+ℹ dist/docs/index.d.ts                                0.01 kB │ gzip: 0.03 kB
+ℹ dist/docs/versioned-knowledge-base.docblock.d.ts    0.01 kB │ gzip: 0.03 kB
+ℹ 37 files, total: 77.94 kB
+✔ Build complete in 22347ms

package/CHANGELOG.md

@@ -0,0 +1,161 @@
+# @contractspec/example.versioned-knowledge-base
+
+## 1.44.0
+
+### Minor Changes
+
+- 5f3a868: chore: isolate branding to contractspec.io
+
+### Patch Changes
+
+- Updated dependencies [5f3a868]
+  - @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/lib.contracts@1.43.4
+  - @contractspec/lib.schema@1.43.3
+
+## 1.43.3
+
+### Patch Changes
+
+- 24d9759: improve documentation
+- Updated dependencies [24d9759]
+  - @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/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
+
+## 1.43.0
+
+### Minor Changes
+
+- 042d072: feat: schema declaration using json schema, including zod
+
+### Patch Changes
+
+- Updated dependencies [042d072]
+  - @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/lib.contracts@1.42.10
+  - @contractspec/lib.schema@1.42.10
+
+## 1.42.9
+
+### Patch Changes
+
+- 9281db7: fix ModelRegistry
+- Updated dependencies [9281db7]
+  - @contractspec/lib.contracts@1.42.9
+  - @contractspec/lib.schema@1.42.9
+
+## 1.42.8
+
+### Patch Changes
+
+- e07b5ac: fix
+- Updated dependencies [e07b5ac]
+  - @contractspec/lib.contracts@1.42.8
+  - @contractspec/lib.schema@1.42.8
+
+## 1.42.7
+
+### Patch Changes
+
+- e9b575d: fix release
+- Updated dependencies [e9b575d]
+  - @contractspec/lib.contracts@1.42.7
+  - @contractspec/lib.schema@1.42.7
+
+## 1.42.6
+
+### Patch Changes
+
+- 1500242: fix tooling
+- Updated dependencies [1500242]
+  - @contractspec/lib.contracts@1.42.6
+  - @contractspec/lib.schema@1.42.6
+
+## 1.42.5
+
+### Patch Changes
+
+- 1299719: fix vscode
+- Updated dependencies [1299719]
+  - @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/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.schema@1.42.3
+
+## 1.42.2
+
+### Patch Changes
+
+- 1f9ac4c: fix
+- Updated dependencies [1f9ac4c]
+  - @contractspec/lib.contracts@1.42.2
+  - @contractspec/lib.schema@1.42.2
+
+## 1.42.1
+
+### Patch Changes
+
+- f043995: Fix release
+- Updated dependencies [f043995]
+  - @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.schema@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,35 @@
+# `@contractspec/example.versioned-knowledge-base`
+
+Website: https://contractspec.io/
+
+
+Spec-first example demonstrating a **curated, versioned knowledge base**:
+
+- 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.
+
+## Contracts
+
+- `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)`
+
+## Running tests
+
+```bash
+bun test
+```
+
+
+
+
+
+
+
+
+
+

package/dist/docs/index.d.ts

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

package/dist/docs/index.js

@@ -0,0 +1 @@
+import "./versioned-knowledge-base.docblock.js";

package/dist/docs/versioned-knowledge-base.docblock.d.ts

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

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

@@ -0,0 +1,31 @@
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+
+//#region src/docs/versioned-knowledge-base.docblock.ts
+registerDocBlocks([{
+	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`
+}]);
+
+//#endregion
+//# sourceMappingURL=versioned-knowledge-base.docblock.js.map

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

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

package/dist/entities/index.d.ts

@@ -0,0 +1,2 @@
+import { KBSnapshotModel, RuleModel, RuleVersionModel, SourceDocumentModel, SourceRefModel } from "./models.js";
+export { KBSnapshotModel, RuleModel, RuleVersionModel, SourceDocumentModel, SourceRefModel };

package/dist/entities/index.js

@@ -0,0 +1,3 @@
+import { KBSnapshotModel, RuleModel, RuleVersionModel, SourceDocumentModel, SourceRefModel } from "./models.js";
+
+export { KBSnapshotModel, RuleModel, RuleVersionModel, SourceDocumentModel, SourceRefModel };

package/dist/entities/models.d.ts

@@ -0,0 +1,139 @@
+import * as _contractspec_lib_schema15 from "@contractspec/lib.schema";
+
+//#region src/entities/models.d.ts
+declare const SourceDocumentModel: _contractspec_lib_schema15.SchemaModel<{
+  id: {
+    type: _contractspec_lib_schema15.FieldType<string, string>;
+    isOptional: false;
+  };
+  jurisdiction: {
+    type: _contractspec_lib_schema15.FieldType<string, string>;
+    isOptional: false;
+  };
+  authority: {
+    type: _contractspec_lib_schema15.FieldType<string, string>;
+    isOptional: false;
+  };
+  title: {
+    type: _contractspec_lib_schema15.FieldType<string, string>;
+    isOptional: false;
+  };
+  fetchedAt: {
+    type: _contractspec_lib_schema15.FieldType<Date, string>;
+    isOptional: false;
+  };
+  hash: {
+    type: _contractspec_lib_schema15.FieldType<string, string>;
+    isOptional: false;
+  };
+  fileId: {
+    type: _contractspec_lib_schema15.FieldType<string, string>;
+    isOptional: false;
+  };
+}>;
+declare const SourceRefModel: _contractspec_lib_schema15.SchemaModel<{
+  sourceDocumentId: {
+    type: _contractspec_lib_schema15.FieldType<string, string>;
+    isOptional: false;
+  };
+  excerpt: {
+    type: _contractspec_lib_schema15.FieldType<string, string>;
+    isOptional: true;
+  };
+}>;
+declare const RuleModel: _contractspec_lib_schema15.SchemaModel<{
+  id: {
+    type: _contractspec_lib_schema15.FieldType<string, string>;
+    isOptional: false;
+  };
+  jurisdiction: {
+    type: _contractspec_lib_schema15.FieldType<string, string>;
+    isOptional: false;
+  };
+  topicKey: {
+    type: _contractspec_lib_schema15.FieldType<string, string>;
+    isOptional: false;
+  };
+}>;
+declare const RuleVersionModel: _contractspec_lib_schema15.SchemaModel<{
+  id: {
+    type: _contractspec_lib_schema15.FieldType<string, string>;
+    isOptional: false;
+  };
+  ruleId: {
+    type: _contractspec_lib_schema15.FieldType<string, string>;
+    isOptional: false;
+  };
+  jurisdiction: {
+    type: _contractspec_lib_schema15.FieldType<string, string>;
+    isOptional: false;
+  };
+  topicKey: {
+    type: _contractspec_lib_schema15.FieldType<string, string>;
+    isOptional: false;
+  };
+  version: {
+    type: _contractspec_lib_schema15.FieldType<number, number>;
+    isOptional: false;
+  };
+  content: {
+    type: _contractspec_lib_schema15.FieldType<string, string>;
+    isOptional: false;
+  };
+  sourceRefs: {
+    type: _contractspec_lib_schema15.SchemaModel<{
+      sourceDocumentId: {
+        type: _contractspec_lib_schema15.FieldType<string, string>;
+        isOptional: false;
+      };
+      excerpt: {
+        type: _contractspec_lib_schema15.FieldType<string, string>;
+        isOptional: true;
+      };
+    }>;
+    isArray: true;
+    isOptional: false;
+  };
+  status: {
+    type: _contractspec_lib_schema15.FieldType<string, string>;
+    isOptional: false;
+  };
+  approvedBy: {
+    type: _contractspec_lib_schema15.FieldType<string, string>;
+    isOptional: true;
+  };
+  approvedAt: {
+    type: _contractspec_lib_schema15.FieldType<Date, string>;
+    isOptional: true;
+  };
+  createdAt: {
+    type: _contractspec_lib_schema15.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>;
+declare const KBSnapshotModel: _contractspec_lib_schema15.SchemaModel<{
+  id: {
+    type: _contractspec_lib_schema15.FieldType<string, string>;
+    isOptional: false;
+  };
+  jurisdiction: {
+    type: _contractspec_lib_schema15.FieldType<string, string>;
+    isOptional: false;
+  };
+  asOfDate: {
+    type: _contractspec_lib_schema15.FieldType<Date, string>;
+    isOptional: false;
+  };
+  includedRuleVersionIds: {
+    type: _contractspec_lib_schema15.FieldType<string, string>;
+    isArray: true;
+    isOptional: false;
+  };
+  publishedAt: {
+    type: _contractspec_lib_schema15.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>;
+//#endregion
+export { KBSnapshotModel, RuleModel, RuleVersionModel, SourceDocumentModel, SourceRefModel };
+//# 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":";;;cAEa,gDAAmB;;UAa9B,0BAAA,CAAA;IAbW,UAAA,EAAA,KAAA;EAaX,CAAA;;;;;;;;;EAb8B,KAAA,EAAA;IAenB,IAAA,sCAUX,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;;;IAVyB,IAAA,sCAAA,KAAA,EAAA,MAAA,CAAA;IAYd,UASX,EAAA,KAAA;EAAA,CAAA;;;;EAToB,CAAA;EAWT,MAAA,EAAA;IAiBX,IAAA,sCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;cAxCW,2CAAc;;UAUzB,0BAAA,CAAA;;;;;;;;cAEW,sCAAS;;IAWO,IAAA,EAF3B,0BAAA,CAAA,SAE2B,CAAA,MAAA,EAAA,MAAA,CAAA;IAmBhB,UAAA,EAAA,KAeX;EAAA,CAAA;;;;;;;;EAf0B,CAAA;;cAnBf,6CAAgB;;UAiB3B,0BAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAEW,4CAAe;;UAe1B,0BAAA,CAAA"}

package/dist/entities/models.js

@@ -0,0 +1,151 @@
+import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+
+//#region src/entities/models.ts
+const 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
+		}
+	}
+});
+const 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
+		}
+	}
+});
+const 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
+		}
+	}
+});
+const 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.Int_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
+		}
+	}
+});
+const 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
+		}
+	}
+});
+
+//#endregion
+export { KBSnapshotModel, RuleModel, RuleVersionModel, SourceDocumentModel, SourceRefModel };
+//# sourceMappingURL=models.js.map