@lssm/example.versioned-knowledge-base 0.0.0-canary-20251217062943 → 0.0.0-canary-20251217072406

package/dist/contracts/kb.d.ts

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

package/dist/contracts/kb.js

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

package/dist/docs/index.js

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

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

@@ -1,20 +1,31 @@
-import{a as e}from"../libs/contracts/dist/docs/registry.js";import"../libs/contracts/dist/docs/index.js";e([{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.
-- Ensures assistant answers cite a published snapshot.
-- Makes change review and safe regeneration possible.
+import { registerDocBlocks } from "../libs/contracts/dist/docs/registry.js";
+import "../libs/contracts/dist/docs/index.js";
 
-## Core invariants
-- Sources are immutable and content-addressed (hash).
-- Rule versions must cite at least one source.
-- 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
-- kb.ingestSource
-- kb.upsertRuleVersion
-- kb.approveRuleVersion
-- kb.publishSnapshot
-- kb.search
+//#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`
+}]);
 
-## Events
-- kb.source.ingested
-- kb.ruleVersion.created
-- kb.ruleVersion.approved
-- kb.snapshot.published`}]);
+//#endregion

package/dist/entities/index.js

@@ -1 +1,3 @@
-import{KBSnapshotModel as e,RuleModel as t,RuleVersionModel as n,SourceDocumentModel as r,SourceRefModel as i}from"./models.js";export{e as KBSnapshotModel,t as RuleModel,n as RuleVersionModel,r as SourceDocumentModel,i as SourceRefModel};
+import { KBSnapshotModel, RuleModel, RuleVersionModel, SourceDocumentModel, SourceRefModel } from "./models.js";
+
+export { KBSnapshotModel, RuleModel, RuleVersionModel, SourceDocumentModel, SourceRefModel };