@lssm/example.versioned-knowledge-base 0.0.0-canary-20251217083314 → 0.0.0-canary-20251220002821

package/dist/contracts/kb.d.ts

@@ -1,118 +1,118 @@
-import * as _lssm_lib_schema0 from "@lssm/lib.schema";
-import * as _lssm_lib_contracts0 from "@lssm/lib.contracts";
+import * as _lssm_lib_schema50 from "@lssm/lib.schema";
+import * as _lssm_lib_contracts3 from "@lssm/lib.contracts";
 
 //#region src/contracts/kb.d.ts
-declare const KbIngestSourceContract: _lssm_lib_contracts0.ContractSpec<_lssm_lib_schema0.SchemaModel<{
+declare const KbIngestSourceContract: _lssm_lib_contracts3.ContractSpec<_lssm_lib_schema50.SchemaModel<{
   jurisdiction: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: false;
   };
   authority: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: false;
   };
   title: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: false;
   };
   fetchedAt: {
-    type: _lssm_lib_schema0.FieldType<Date, string>;
+    type: _lssm_lib_schema50.FieldType<Date, string>;
     isOptional: false;
   };
   hash: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: false;
   };
   fileId: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: false;
   };
-}>, _lssm_lib_schema0.SchemaModel<{
+}>, _lssm_lib_schema50.SchemaModel<{
   id: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: false;
   };
   jurisdiction: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: false;
   };
   authority: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: false;
   };
   title: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: false;
   };
   fetchedAt: {
-    type: _lssm_lib_schema0.FieldType<Date, string>;
+    type: _lssm_lib_schema50.FieldType<Date, string>;
     isOptional: false;
   };
   hash: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: false;
   };
   fileId: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: false;
   };
 }>, undefined>;
-declare const KbUpsertRuleVersionContract: _lssm_lib_contracts0.ContractSpec<_lssm_lib_schema0.SchemaModel<{
+declare const KbUpsertRuleVersionContract: _lssm_lib_contracts3.ContractSpec<_lssm_lib_schema50.SchemaModel<{
   ruleId: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: false;
   };
   content: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: false;
   };
   sourceRefs: {
-    type: _lssm_lib_schema0.SchemaModel<{
+    type: _lssm_lib_schema50.SchemaModel<{
       sourceDocumentId: {
-        type: _lssm_lib_schema0.FieldType<string, string>;
+        type: _lssm_lib_schema50.FieldType<string, string>;
         isOptional: false;
       };
       excerpt: {
-        type: _lssm_lib_schema0.FieldType<string, string>;
+        type: _lssm_lib_schema50.FieldType<string, string>;
         isOptional: true;
       };
     }>;
     isArray: true;
     isOptional: false;
   };
-}>, _lssm_lib_schema0.SchemaModel<{
+}>, _lssm_lib_schema50.SchemaModel<{
   id: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: false;
   };
   ruleId: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: false;
   };
   jurisdiction: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: false;
   };
   topicKey: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: false;
   };
   version: {
-    type: _lssm_lib_schema0.FieldType<number, number>;
+    type: _lssm_lib_schema50.FieldType<number, number>;
     isOptional: false;
   };
   content: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: false;
   };
   sourceRefs: {
-    type: _lssm_lib_schema0.SchemaModel<{
+    type: _lssm_lib_schema50.SchemaModel<{
       sourceDocumentId: {
-        type: _lssm_lib_schema0.FieldType<string, string>;
+        type: _lssm_lib_schema50.FieldType<string, string>;
         isOptional: false;
       };
       excerpt: {
-        type: _lssm_lib_schema0.FieldType<string, string>;
+        type: _lssm_lib_schema50.FieldType<string, string>;
         isOptional: true;
       };
     }>;
@@ -120,64 +120,64 @@ declare const KbUpsertRuleVersionContract: _lssm_lib_contracts0.ContractSpec<_ls
     isOptional: false;
   };
   status: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: false;
   };
   approvedBy: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: true;
   };
   approvedAt: {
-    type: _lssm_lib_schema0.FieldType<Date, string>;
+    type: _lssm_lib_schema50.FieldType<Date, string>;
     isOptional: true;
   };
   createdAt: {
-    type: _lssm_lib_schema0.FieldType<Date, string>;
+    type: _lssm_lib_schema50.FieldType<Date, string>;
     isOptional: false;
   };
 }>, undefined>;
-declare const KbApproveRuleVersionContract: _lssm_lib_contracts0.ContractSpec<_lssm_lib_schema0.SchemaModel<{
+declare const KbApproveRuleVersionContract: _lssm_lib_contracts3.ContractSpec<_lssm_lib_schema50.SchemaModel<{
   ruleVersionId: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: false;
   };
   approver: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: false;
   };
-}>, _lssm_lib_schema0.SchemaModel<{
+}>, _lssm_lib_schema50.SchemaModel<{
   id: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: false;
   };
   ruleId: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: false;
   };
   jurisdiction: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: false;
   };
   topicKey: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: false;
   };
   version: {
-    type: _lssm_lib_schema0.FieldType<number, number>;
+    type: _lssm_lib_schema50.FieldType<number, number>;
     isOptional: false;
   };
   content: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: false;
   };
   sourceRefs: {
-    type: _lssm_lib_schema0.SchemaModel<{
+    type: _lssm_lib_schema50.SchemaModel<{
       sourceDocumentId: {
-        type: _lssm_lib_schema0.FieldType<string, string>;
+        type: _lssm_lib_schema50.FieldType<string, string>;
         isOptional: false;
       };
       excerpt: {
-        type: _lssm_lib_schema0.FieldType<string, string>;
+        type: _lssm_lib_schema50.FieldType<string, string>;
         isOptional: true;
       };
     }>;
@@ -185,76 +185,76 @@ declare const KbApproveRuleVersionContract: _lssm_lib_contracts0.ContractSpec<_l
     isOptional: false;
   };
   status: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: false;
   };
   approvedBy: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: true;
   };
   approvedAt: {
-    type: _lssm_lib_schema0.FieldType<Date, string>;
+    type: _lssm_lib_schema50.FieldType<Date, string>;
     isOptional: true;
   };
   createdAt: {
-    type: _lssm_lib_schema0.FieldType<Date, string>;
+    type: _lssm_lib_schema50.FieldType<Date, string>;
     isOptional: false;
   };
 }>, undefined>;
-declare const KbPublishSnapshotContract: _lssm_lib_contracts0.ContractSpec<_lssm_lib_schema0.SchemaModel<{
+declare const KbPublishSnapshotContract: _lssm_lib_contracts3.ContractSpec<_lssm_lib_schema50.SchemaModel<{
   jurisdiction: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: false;
   };
   asOfDate: {
-    type: _lssm_lib_schema0.FieldType<Date, string>;
+    type: _lssm_lib_schema50.FieldType<Date, string>;
     isOptional: false;
   };
-}>, _lssm_lib_schema0.SchemaModel<{
+}>, _lssm_lib_schema50.SchemaModel<{
   id: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: false;
   };
   jurisdiction: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: false;
   };
   asOfDate: {
-    type: _lssm_lib_schema0.FieldType<Date, string>;
+    type: _lssm_lib_schema50.FieldType<Date, string>;
     isOptional: false;
   };
   includedRuleVersionIds: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isArray: true;
     isOptional: false;
   };
   publishedAt: {
-    type: _lssm_lib_schema0.FieldType<Date, string>;
+    type: _lssm_lib_schema50.FieldType<Date, string>;
     isOptional: false;
   };
 }>, undefined>;
-declare const KbSearchContract: _lssm_lib_contracts0.ContractSpec<_lssm_lib_schema0.SchemaModel<{
+declare const KbSearchContract: _lssm_lib_contracts3.ContractSpec<_lssm_lib_schema50.SchemaModel<{
   snapshotId: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: false;
   };
   jurisdiction: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: false;
   };
   query: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema50.FieldType<string, string>;
     isOptional: false;
   };
-}>, _lssm_lib_schema0.SchemaModel<{
+}>, _lssm_lib_schema50.SchemaModel<{
   items: {
-    type: _lssm_lib_schema0.SchemaModel<{
+    type: _lssm_lib_schema50.SchemaModel<{
       ruleVersionId: {
-        type: _lssm_lib_schema0.FieldType<string, string>;
+        type: _lssm_lib_schema50.FieldType<string, string>;
         isOptional: false;
       };
       excerpt: {
-        type: _lssm_lib_schema0.FieldType<string, string>;
+        type: _lssm_lib_schema50.FieldType<string, string>;
         isOptional: true;
       };
     }>;
@@ -263,4 +263,5 @@ declare const KbSearchContract: _lssm_lib_contracts0.ContractSpec<_lssm_lib_sche
   };
 }>, undefined>;
 //#endregion
-export { KbApproveRuleVersionContract, KbIngestSourceContract, KbPublishSnapshotContract, KbSearchContract, KbUpsertRuleVersionContract };
+export { KbApproveRuleVersionContract, KbIngestSourceContract, KbPublishSnapshotContract, KbSearchContract, KbUpsertRuleVersionContract };
+//# sourceMappingURL=kb.d.ts.map

package/dist/contracts/kb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kb.d.ts","names":[],"sources":["../../src/contracts/kb.ts"],"sourcesContent":[],"mappings":";;;;cAoFa,6CAAsB,gCAAA;;UAgBjC,kBAAA,CAAA;;EAhBW,CAAA;EAgBX,SAAA,EAAA;;;;;;;;EAhBiC,SAAA,EAAA;;;;;;;;;sCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EAkBtB,CAAA;CA8BX,CAAA,gCAAA,CAAA;;UAhDiC,kBAAA,CAAA;;;;IAkBK,IAAA,8BAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;;;;;;;;;;sCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EAgC3B,CAAA;EAgBX,MAAA,EAAA;;gBAhBuC,KAAA;EAAA,CAAA;;cAhC5B,kDAA2B,gCAAA;;UA8BtC,kBAAA,CAAA;;;;;;;;;;;;;MAEuC,OAAA,EAAA;QAkB5B,IAAA,8BAyBX,CAAA,MAAA,EAAA,MAAA,CAAA;QAAA,UAAA,EAAA,IAAA;;;iBAzBoC;IAAA,UAAA,EAAA,KAAA;;;;UAlDE,kBAAA,CAAA;;;;sCAkDF,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EA2BzB,CAAA;EAgBX,YAAA,EAAA;;;;EAhB2B,QAAA,EAAA;;;;;IAAA,IAAA,8BAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA7ChB,mDAA4B,gCAAA;;UAgBvC,kBAAA,CAAA;;;;;;;;;UAhBuC,kBAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAkB5B,gDAAyB,gCAAA;;UAyBpC,kBAAA,CAAA;;;;;;;;;UAzBoC,kBAAA,CAAA;;;;;;;;;;;;;;;;;;;;;cA2BzB,uCAAgB,gCAAA;;UAgB3B,kBAAA,CAAA;;;;;;;;;;;;;;;cAhB2B,kBAAA,CAAA"}

package/dist/contracts/kb.js

@@ -1,51 +1,49 @@
 import { defineCommand, defineQuery } from "../libs/contracts/dist/spec.js";
 import "../libs/contracts/dist/index.js";
-import { ScalarTypeEnum } from "../libs/schema/dist/ScalarTypeEnum.js";
-import { defineSchemaModel } from "../libs/schema/dist/SchemaModel.js";
-import "../libs/schema/dist/index.js";
+import { E5, K5 } from "../libs/schema/dist/index.js";
 import { KBSnapshotModel, RuleVersionModel, SourceDocumentModel, SourceRefModel } from "../entities/models.js";
 
 //#region src/contracts/kb.ts
-const IngestSourceInput = defineSchemaModel({
+const IngestSourceInput = K5({
 	name: "KbIngestSourceInput",
 	description: "Ingest immutable source metadata referencing a stored file.",
 	fields: {
 		jurisdiction: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		},
 		authority: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		},
 		title: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		},
 		fetchedAt: {
-			type: ScalarTypeEnum.DateTime(),
+			type: E5.DateTime(),
 			isOptional: false
 		},
 		hash: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		},
 		fileId: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		}
 	}
 });
-const UpsertRuleVersionInput = defineSchemaModel({
+const UpsertRuleVersionInput = K5({
 	name: "KbUpsertRuleVersionInput",
 	description: "Create a new draft rule version (immutable history).",
 	fields: {
 		ruleId: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		},
 		content: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		},
 		sourceRefs: {
@@ -55,66 +53,66 @@ const UpsertRuleVersionInput = defineSchemaModel({
 		}
 	}
 });
-const ApproveRuleVersionInput = defineSchemaModel({
+const ApproveRuleVersionInput = K5({
 	name: "KbApproveRuleVersionInput",
 	description: "Approve a rule version (human verification).",
 	fields: {
 		ruleVersionId: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		},
 		approver: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		}
 	}
 });
-const PublishSnapshotInput = defineSchemaModel({
+const PublishSnapshotInput = K5({
 	name: "KbPublishSnapshotInput",
 	description: "Publish a snapshot for a jurisdiction as-of a date.",
 	fields: {
 		jurisdiction: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		},
 		asOfDate: {
-			type: ScalarTypeEnum.DateTime(),
+			type: E5.DateTime(),
 			isOptional: false
 		}
 	}
 });
-const SearchKbInput = defineSchemaModel({
+const SearchKbInput = K5({
 	name: "KbSearchInput",
 	description: "Search within a published snapshot.",
 	fields: {
 		snapshotId: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		},
 		jurisdiction: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		},
 		query: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		}
 	}
 });
-const SearchKbOutput = defineSchemaModel({
+const SearchKbOutput = K5({
 	name: "KbSearchOutput",
 	description: "Search results constrained to snapshot + jurisdiction.",
 	fields: { items: {
-		type: defineSchemaModel({
+		type: K5({
 			name: "KbSearchResultItem",
 			description: "Search result referencing a specific rule version.",
 			fields: {
 				ruleVersionId: {
-					type: ScalarTypeEnum.String_unsecure(),
+					type: E5.String_unsecure(),
 					isOptional: false
 				},
 				excerpt: {
-					type: ScalarTypeEnum.String_unsecure(),
+					type: E5.String_unsecure(),
 					isOptional: true
 				}
 			}
@@ -250,4 +248,5 @@ const KbSearchContract = defineQuery({
 });
 
 //#endregion
-export { KbApproveRuleVersionContract, KbIngestSourceContract, KbPublishSnapshotContract, KbSearchContract, KbUpsertRuleVersionContract };
+export { KbApproveRuleVersionContract, KbIngestSourceContract, KbPublishSnapshotContract, KbSearchContract, KbUpsertRuleVersionContract };
+//# sourceMappingURL=kb.js.map

package/dist/contracts/kb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kb.js","names":["defineSchemaModel","ScalarTypeEnum"],"sources":["../../src/contracts/kb.ts"],"sourcesContent":["import { defineCommand, defineQuery } from '@lssm/lib.contracts';\nimport { ScalarTypeEnum, defineSchemaModel } from '@lssm/lib.schema';\n\nimport {\n  KBSnapshotModel,\n  RuleVersionModel,\n  SourceDocumentModel,\n  SourceRefModel,\n} from '../entities/models';\n\nconst IngestSourceInput = defineSchemaModel({\n  name: 'KbIngestSourceInput',\n  description: 'Ingest immutable source metadata referencing a stored file.',\n  fields: {\n    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    authority: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    title: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    fetchedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n    hash: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    fileId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nconst UpsertRuleVersionInput = defineSchemaModel({\n  name: 'KbUpsertRuleVersionInput',\n  description: 'Create a new draft rule version (immutable history).',\n  fields: {\n    ruleId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    content: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    sourceRefs: { type: SourceRefModel, isArray: true, isOptional: false },\n  },\n});\n\nconst ApproveRuleVersionInput = defineSchemaModel({\n  name: 'KbApproveRuleVersionInput',\n  description: 'Approve a rule version (human verification).',\n  fields: {\n    ruleVersionId: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    approver: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nconst PublishSnapshotInput = defineSchemaModel({\n  name: 'KbPublishSnapshotInput',\n  description: 'Publish a snapshot for a jurisdiction as-of a date.',\n  fields: {\n    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    asOfDate: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nconst SearchKbInput = defineSchemaModel({\n  name: 'KbSearchInput',\n  description: 'Search within a published snapshot.',\n  fields: {\n    snapshotId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    query: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nconst SearchKbResultItem = defineSchemaModel({\n  name: 'KbSearchResultItem',\n  description: 'Search result referencing a specific rule version.',\n  fields: {\n    ruleVersionId: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    excerpt: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n  },\n});\n\nconst SearchKbOutput = defineSchemaModel({\n  name: 'KbSearchOutput',\n  description: 'Search results constrained to snapshot + jurisdiction.',\n  fields: {\n    items: { type: SearchKbResultItem, isArray: true, isOptional: false },\n  },\n});\n\nexport const KbIngestSourceContract = defineCommand({\n  meta: {\n    name: 'kb.ingestSource',\n    version: 1,\n    stability: 'experimental',\n    owners: ['@examples'],\n    tags: ['knowledge', 'sources', 'ingestion'],\n    description: 'Ingest immutable source document metadata.',\n    goal: 'Store traceable source documents for curated KB.',\n    context: 'Called when an admin uploads/records authoritative sources.',\n  },\n  io: {\n    input: IngestSourceInput,\n    output: SourceDocumentModel,\n  },\n  policy: { auth: 'user' },\n});\n\nexport const KbUpsertRuleVersionContract = defineCommand({\n  meta: {\n    name: 'kb.upsertRuleVersion',\n    version: 1,\n    stability: 'experimental',\n    owners: ['@examples'],\n    tags: ['knowledge', 'rules', 'versioning'],\n    description: 'Create a new draft rule version with source references.',\n    goal: 'Propose curated knowledge updates with traceability.',\n    context: 'Automation or curators propose draft rule versions.',\n  },\n  io: {\n    input: UpsertRuleVersionInput,\n    output: RuleVersionModel,\n    errors: {\n      SOURCE_REFS_REQUIRED: {\n        description: 'Rule version must cite at least one sourceRef',\n        http: 400,\n        gqlCode: 'SOURCE_REFS_REQUIRED',\n        when: 'sourceRefs is empty',\n      },\n      RULE_NOT_FOUND: {\n        description: 'Rule does not exist',\n        http: 404,\n        gqlCode: 'RULE_NOT_FOUND',\n        when: 'ruleId is unknown',\n      },\n    },\n  },\n  policy: { auth: 'user' },\n});\n\nexport const KbApproveRuleVersionContract = defineCommand({\n  meta: {\n    name: 'kb.approveRuleVersion',\n    version: 1,\n    stability: 'experimental',\n    owners: ['@examples'],\n    tags: ['knowledge', 'rules', 'approval'],\n    description: 'Approve a draft rule version.',\n    goal: 'Human verification step before publishing snapshots.',\n    context: 'Curators/experts approve proposed KB changes.',\n  },\n  io: {\n    input: ApproveRuleVersionInput,\n    output: RuleVersionModel,\n  },\n  policy: { auth: 'user' },\n});\n\nexport const KbPublishSnapshotContract = defineCommand({\n  meta: {\n    name: 'kb.publishSnapshot',\n    version: 1,\n    stability: 'experimental',\n    owners: ['@examples'],\n    tags: ['knowledge', 'snapshots', 'publishing'],\n    description: 'Publish a KB snapshot for a jurisdiction.',\n    goal: 'Create a stable snapshot that assistant answers can cite.',\n    context:\n      'Publishing happens after approvals; snapshot is referenced by answers.',\n  },\n  io: {\n    input: PublishSnapshotInput,\n    output: KBSnapshotModel,\n    errors: {\n      NO_APPROVED_RULES: {\n        description: 'No approved rule versions available to publish',\n        http: 409,\n        gqlCode: 'NO_APPROVED_RULES',\n        when: 'jurisdiction has zero approved rule versions',\n      },\n    },\n  },\n  policy: { auth: 'user' },\n});\n\nexport const KbSearchContract = defineQuery({\n  meta: {\n    name: 'kb.search',\n    version: 1,\n    stability: 'experimental',\n    owners: ['@examples'],\n    tags: ['knowledge', 'search', 'snapshots'],\n    description: 'Search within a published KB snapshot.',\n    goal: 'Provide scoped retrieval for assistant answers.',\n    context: 'Assistant queries curated rules from a specific snapshot.',\n  },\n  io: {\n    input: SearchKbInput,\n    output: SearchKbOutput,\n  },\n  policy: { auth: 'user' },\n});\n"],"mappings":"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"}

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

@@ -28,4 +28,5 @@ registerDocBlocks([{
 	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
+//#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 '@lssm/lib.contracts/docs';\nimport { registerDocBlocks } from '@lssm/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"}