@contractspec/example.versioned-knowledge-base 0.0.0-canary-20260113162409

package/dist/index.js

@@ -0,0 +1,11 @@
+import { KbRuleVersionApprovedEvent, KbRuleVersionCreatedEvent, KbSnapshotPublishedEvent, KbSourceIngestedEvent } from "./events.js";
+import example_default from "./example.js";
+import { KBSnapshotModel, RuleModel, RuleVersionModel, SourceDocumentModel, SourceRefModel } from "./entities/models.js";
+import "./entities/index.js";
+import { KbApproveRuleVersionContract, KbIngestSourceContract, KbPublishSnapshotContract, KbSearchContract, KbUpsertRuleVersionContract } from "./operations/kb.js";
+import "./operations/index.js";
+import { createMemoryKbHandlers, createMemoryKbStore } from "./handlers/memory.handlers.js";
+import { VersionedKnowledgeBaseFeature } from "./versioned-knowledge-base.feature.js";
+import "./docs/index.js";
+
+export { KBSnapshotModel, KbApproveRuleVersionContract, KbIngestSourceContract, KbPublishSnapshotContract, KbRuleVersionApprovedEvent, KbRuleVersionCreatedEvent, KbSearchContract, KbSnapshotPublishedEvent, KbSourceIngestedEvent, KbUpsertRuleVersionContract, RuleModel, RuleVersionModel, SourceDocumentModel, SourceRefModel, VersionedKnowledgeBaseFeature, createMemoryKbHandlers, createMemoryKbStore, example_default as example };

package/dist/operations/index.d.ts

@@ -0,0 +1,2 @@
+import { KbApproveRuleVersionContract, KbIngestSourceContract, KbPublishSnapshotContract, KbSearchContract, KbUpsertRuleVersionContract } from "./kb.js";
+export { KbApproveRuleVersionContract, KbIngestSourceContract, KbPublishSnapshotContract, KbSearchContract, KbUpsertRuleVersionContract };

package/dist/operations/index.js

@@ -0,0 +1,3 @@
+import { KbApproveRuleVersionContract, KbIngestSourceContract, KbPublishSnapshotContract, KbSearchContract, KbUpsertRuleVersionContract } from "./kb.js";
+
+export { KbApproveRuleVersionContract, KbIngestSourceContract, KbPublishSnapshotContract, KbSearchContract, KbUpsertRuleVersionContract };

package/dist/operations/kb.d.ts

@@ -0,0 +1,267 @@
+import * as _contractspec_lib_contracts0 from "@contractspec/lib.contracts";
+import * as _contractspec_lib_schema0 from "@contractspec/lib.schema";
+
+//#region src/operations/kb.d.ts
+declare const KbIngestSourceContract: _contractspec_lib_contracts0.OperationSpec<_contractspec_lib_schema0.SchemaModel<{
+  jurisdiction: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  authority: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  title: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  fetchedAt: {
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
+    isOptional: false;
+  };
+  hash: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  fileId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+}>, _contractspec_lib_schema0.SchemaModel<{
+  id: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  jurisdiction: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  authority: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  title: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  fetchedAt: {
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
+    isOptional: false;
+  };
+  hash: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  fileId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+}>, undefined>;
+declare const KbUpsertRuleVersionContract: _contractspec_lib_contracts0.OperationSpec<_contractspec_lib_schema0.SchemaModel<{
+  ruleId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  content: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  sourceRefs: {
+    type: _contractspec_lib_schema0.SchemaModel<{
+      sourceDocumentId: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: false;
+      };
+      excerpt: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+    }>;
+    isArray: true;
+    isOptional: false;
+  };
+}>, _contractspec_lib_schema0.SchemaModel<{
+  id: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  ruleId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  jurisdiction: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  topicKey: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  version: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  content: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  sourceRefs: {
+    type: _contractspec_lib_schema0.SchemaModel<{
+      sourceDocumentId: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: false;
+      };
+      excerpt: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+    }>;
+    isArray: true;
+    isOptional: false;
+  };
+  status: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  approvedBy: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  approvedAt: {
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
+    isOptional: true;
+  };
+  createdAt: {
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>, undefined>;
+declare const KbApproveRuleVersionContract: _contractspec_lib_contracts0.OperationSpec<_contractspec_lib_schema0.SchemaModel<{
+  ruleVersionId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  approver: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+}>, _contractspec_lib_schema0.SchemaModel<{
+  id: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  ruleId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  jurisdiction: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  topicKey: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  version: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  content: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  sourceRefs: {
+    type: _contractspec_lib_schema0.SchemaModel<{
+      sourceDocumentId: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: false;
+      };
+      excerpt: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+    }>;
+    isArray: true;
+    isOptional: false;
+  };
+  status: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  approvedBy: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  approvedAt: {
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
+    isOptional: true;
+  };
+  createdAt: {
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>, undefined>;
+declare const KbPublishSnapshotContract: _contractspec_lib_contracts0.OperationSpec<_contractspec_lib_schema0.SchemaModel<{
+  jurisdiction: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  asOfDate: {
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>, _contractspec_lib_schema0.SchemaModel<{
+  id: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  jurisdiction: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  asOfDate: {
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
+    isOptional: false;
+  };
+  includedRuleVersionIds: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isArray: true;
+    isOptional: false;
+  };
+  publishedAt: {
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>, undefined>;
+declare const KbSearchContract: _contractspec_lib_contracts0.OperationSpec<_contractspec_lib_schema0.SchemaModel<{
+  snapshotId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  jurisdiction: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  query: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+}>, _contractspec_lib_schema0.SchemaModel<{
+  items: {
+    type: _contractspec_lib_schema0.SchemaModel<{
+      ruleVersionId: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: false;
+      };
+      excerpt: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+    }>;
+    isArray: true;
+    isOptional: false;
+  };
+}>, undefined>;
+//#endregion
+export { KbApproveRuleVersionContract, KbIngestSourceContract, KbPublishSnapshotContract, KbSearchContract, KbUpsertRuleVersionContract };
+//# sourceMappingURL=kb.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kb.d.ts","names":[],"sources":["../../src/operations/kb.ts"],"sourcesContent":[],"mappings":";;;;cAoFa,qDAAsB,wCAAA;;UAiBjC,yBAAA,CAAA;;EAjBW,CAAA;EAiBX,SAAA,EAAA;;;;;;;;EAjBiC,SAAA,EAAA;;;;;;;;;6CAAA,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EAmBtB,CAAA;CA+BX,CAAA,uCAAA,CAAA;;UAlDiC,yBAAA,CAAA;;;;IAmBK,IAAA,qCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;;;;;;;;;;6CAAA,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EAiC3B,CAAA;EAiBX,MAAA,EAAA;;;EAjBuC,CAAA;;cAjC5B,0DAA2B,wCAAA;;UA+BtC,yBAAA,CAAA;;;;;;;;;;;;;MAEuC,OAAA,EAAA;QAmB5B,IAAA,qCA0BX,CAAA,MAAA,EAAA,MAAA,CAAA;QAAA,UAAA,EAAA,IAAA;;;;IA1BoC,UAAA,EAAA,KAAA;;;;UApDE,yBAAA,CAAA;;;;6CAoDF,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EA4BzB,CAAA;EAiBX,YAAA,EAAA;;;;EAjB2B,QAAA,EAAA;;;;;IAAA,IAAA,qCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA/ChB,2DAA4B,wCAAA;;UAiBvC,yBAAA,CAAA;;;;;;;;;UAjBuC,yBAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAmB5B,wDAAyB,wCAAA;;UA0BpC,yBAAA,CAAA;;;;;;;;;UA1BoC,yBAAA,CAAA;;;;;;;;;;;;;;;;;;;;;cA4BzB,+CAAgB,wCAAA;;UAiB3B,yBAAA,CAAA;;;;;;;;;;;;;;;cAjB2B,yBAAA,CAAA"}

package/dist/operations/kb.js

@@ -0,0 +1,256 @@
+import { KBSnapshotModel, RuleVersionModel, SourceDocumentModel, SourceRefModel } from "../entities/models.js";
+import { defineCommand, defineQuery } from "@contractspec/lib.contracts";
+import { ScalarTypeEnum, defineSchemaModel as defineSchemaModel$1 } from "@contractspec/lib.schema";
+
+//#region src/operations/kb.ts
+const IngestSourceInput = defineSchemaModel$1({
+	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$1({
+	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$1({
+	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$1({
+	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$1({
+	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$1({
+	name: "KbSearchOutput",
+	description: "Search results constrained to snapshot + jurisdiction.",
+	fields: { items: {
+		type: defineSchemaModel$1({
+			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: {
+		key: "kb.ingestSource",
+		title: "Ingest Source",
+		version: "1.0.0",
+		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: {
+		key: "kb.upsertRuleVersion",
+		title: "Upsert Rule Version",
+		version: "1.0.0",
+		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: {
+		key: "kb.approveRuleVersion",
+		title: "Approve Rule Version",
+		version: "1.0.0",
+		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: {
+		key: "kb.publishSnapshot",
+		title: "Publish Snapshot",
+		version: "1.0.0",
+		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: {
+		key: "kb.search",
+		title: "Search KB",
+		version: "1.0.0",
+		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 };
+//# sourceMappingURL=kb.js.map

package/dist/operations/kb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kb.js","names":["defineSchemaModel"],"sources":["../../src/operations/kb.ts"],"sourcesContent":["import { defineCommand, defineQuery } from '@contractspec/lib.contracts';\nimport { ScalarTypeEnum, defineSchemaModel } from '@contractspec/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    key: 'kb.ingestSource',\n    title: 'Ingest Source',\n    version: '1.0.0',\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    key: 'kb.upsertRuleVersion',\n    title: 'Upsert Rule Version',\n    version: '1.0.0',\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    key: 'kb.approveRuleVersion',\n    title: 'Approve Rule Version',\n    version: '1.0.0',\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    key: 'kb.publishSnapshot',\n    title: 'Publish Snapshot',\n    version: '1.0.0',\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    key: 'kb.search',\n    title: 'Search KB',\n    version: '1.0.0',\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/versioned-knowledge-base.feature.d.ts

@@ -0,0 +1,7 @@
+import * as _contractspec_lib_contracts9 from "@contractspec/lib.contracts";
+
+//#region src/versioned-knowledge-base.feature.d.ts
+declare const VersionedKnowledgeBaseFeature: _contractspec_lib_contracts9.FeatureModuleSpec;
+//#endregion
+export { VersionedKnowledgeBaseFeature };
+//# sourceMappingURL=versioned-knowledge-base.feature.d.ts.map

package/dist/versioned-knowledge-base.feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioned-knowledge-base.feature.d.ts","names":[],"sources":["../src/versioned-knowledge-base.feature.ts"],"sourcesContent":[],"mappings":";;;cAEa,+BA+BX,4BAAA,CA/BwC"}

package/dist/versioned-knowledge-base.feature.js

@@ -0,0 +1,70 @@
+import { defineFeature } from "@contractspec/lib.contracts";
+
+//#region src/versioned-knowledge-base.feature.ts
+const VersionedKnowledgeBaseFeature = defineFeature({
+	meta: {
+		key: "versioned-knowledge-base",
+		version: "1.0.0",
+		title: "Versioned Knowledge Base",
+		description: "Curated KB with immutable sources, rule versions, and published snapshots.",
+		domain: "knowledge",
+		owners: ["@examples"],
+		tags: [
+			"knowledge",
+			"versioning",
+			"snapshots"
+		],
+		stability: "experimental"
+	},
+	operations: [
+		{
+			key: "kb.ingestSource",
+			version: "1.0.0"
+		},
+		{
+			key: "kb.upsertRuleVersion",
+			version: "1.0.0"
+		},
+		{
+			key: "kb.approveRuleVersion",
+			version: "1.0.0"
+		},
+		{
+			key: "kb.publishSnapshot",
+			version: "1.0.0"
+		},
+		{
+			key: "kb.search",
+			version: "1.0.0"
+		}
+	],
+	events: [
+		{
+			key: "kb.source.ingested",
+			version: "1.0.0"
+		},
+		{
+			key: "kb.ruleVersion.created",
+			version: "1.0.0"
+		},
+		{
+			key: "kb.ruleVersion.approved",
+			version: "1.0.0"
+		},
+		{
+			key: "kb.snapshot.published",
+			version: "1.0.0"
+		}
+	],
+	presentations: [],
+	opToPresentation: [],
+	presentationsTargets: [],
+	capabilities: { requires: [{
+		key: "knowledge",
+		version: "1.0.0"
+	}] }
+});
+
+//#endregion
+export { VersionedKnowledgeBaseFeature };
+//# sourceMappingURL=versioned-knowledge-base.feature.js.map

package/dist/versioned-knowledge-base.feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioned-knowledge-base.feature.js","names":[],"sources":["../src/versioned-knowledge-base.feature.ts"],"sourcesContent":["import { defineFeature } from '@contractspec/lib.contracts';\n\nexport const VersionedKnowledgeBaseFeature = defineFeature({\n  meta: {\n    key: 'versioned-knowledge-base',\n    version: '1.0.0',\n    title: 'Versioned Knowledge Base',\n    description:\n      'Curated KB with immutable sources, rule versions, and published snapshots.',\n    domain: 'knowledge',\n    owners: ['@examples'],\n    tags: ['knowledge', 'versioning', 'snapshots'],\n    stability: 'experimental',\n  },\n  operations: [\n    { key: 'kb.ingestSource', version: '1.0.0' },\n    { key: 'kb.upsertRuleVersion', version: '1.0.0' },\n    { key: 'kb.approveRuleVersion', version: '1.0.0' },\n    { key: 'kb.publishSnapshot', version: '1.0.0' },\n    { key: 'kb.search', version: '1.0.0' },\n  ],\n  events: [\n    { key: 'kb.source.ingested', version: '1.0.0' },\n    { key: 'kb.ruleVersion.created', version: '1.0.0' },\n    { key: 'kb.ruleVersion.approved', version: '1.0.0' },\n    { key: 'kb.snapshot.published', version: '1.0.0' },\n  ],\n  presentations: [],\n  opToPresentation: [],\n  presentationsTargets: [],\n  capabilities: {\n    requires: [{ key: 'knowledge', version: '1.0.0' }],\n  },\n});\n"],"mappings":";;;AAEA,MAAa,gCAAgC,cAAc;CACzD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,QAAQ;EACR,QAAQ,CAAC,YAAY;EACrB,MAAM;GAAC;GAAa;GAAc;GAAY;EAC9C,WAAW;EACZ;CACD,YAAY;EACV;GAAE,KAAK;GAAmB,SAAS;GAAS;EAC5C;GAAE,KAAK;GAAwB,SAAS;GAAS;EACjD;GAAE,KAAK;GAAyB,SAAS;GAAS;EAClD;GAAE,KAAK;GAAsB,SAAS;GAAS;EAC/C;GAAE,KAAK;GAAa,SAAS;GAAS;EACvC;CACD,QAAQ;EACN;GAAE,KAAK;GAAsB,SAAS;GAAS;EAC/C;GAAE,KAAK;GAA0B,SAAS;GAAS;EACnD;GAAE,KAAK;GAA2B,SAAS;GAAS;EACpD;GAAE,KAAK;GAAyB,SAAS;GAAS;EACnD;CACD,eAAe,EAAE;CACjB,kBAAkB,EAAE;CACpB,sBAAsB,EAAE;CACxB,cAAc,EACZ,UAAU,CAAC;EAAE,KAAK;EAAa,SAAS;EAAS,CAAC,EACnD;CACF,CAAC"}

package/example.ts

@@ -0,0 +1 @@
+export { default } from './src/example';