@lssm/example.versioned-knowledge-base 1.41.0 → 1.42.2

package/dist/events.js

@@ -1 +1,124 @@
-import{defineEvent as e,defineSchemaModel as t}from"@lssm/lib.contracts";import{ScalarTypeEnum as n}from"@lssm/lib.schema";const r=e({name:`kb.source.ingested`,version:1,description:`Source document ingested (immutable).`,payload:t({name:`KbSourceIngestedPayload`,description:`Emitted when a source document is ingested.`,fields:{sourceDocumentId:{type:n.String_unsecure(),isOptional:!1},jurisdiction:{type:n.String_unsecure(),isOptional:!1},hash:{type:n.String_unsecure(),isOptional:!1}}})}),i=e({name:`kb.ruleVersion.created`,version:1,description:`Rule version created (draft).`,payload:t({name:`KbRuleVersionCreatedPayload`,description:`Emitted when a rule version draft is created.`,fields:{ruleVersionId:{type:n.String_unsecure(),isOptional:!1},ruleId:{type:n.String_unsecure(),isOptional:!1},jurisdiction:{type:n.String_unsecure(),isOptional:!1},status:{type:n.String_unsecure(),isOptional:!1}}})}),a=e({name:`kb.ruleVersion.approved`,version:1,description:`Rule version approved (human verified).`,payload:t({name:`KbRuleVersionApprovedPayload`,description:`Emitted when a rule version is approved.`,fields:{ruleVersionId:{type:n.String_unsecure(),isOptional:!1},approver:{type:n.String_unsecure(),isOptional:!1}}})}),o=e({name:`kb.snapshot.published`,version:1,description:`KB snapshot published.`,payload:t({name:`KbSnapshotPublishedPayload`,description:`Emitted when a KB snapshot is published.`,fields:{snapshotId:{type:n.String_unsecure(),isOptional:!1},jurisdiction:{type:n.String_unsecure(),isOptional:!1},includedRuleVersionsCount:{type:n.Int_unsecure(),isOptional:!1}}})});export{a as KbRuleVersionApprovedEvent,i as KbRuleVersionCreatedEvent,o as KbSnapshotPublishedEvent,r as KbSourceIngestedEvent};
+import { defineEvent, defineSchemaModel } from "@lssm/lib.contracts";
+import { ScalarTypeEnum } from "@lssm/lib.schema";
+
+//#region src/events.ts
+const KbSourceIngestedPayload = defineSchemaModel({
+	name: "KbSourceIngestedPayload",
+	description: "Emitted when a source document is ingested.",
+	fields: {
+		sourceDocumentId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		jurisdiction: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		hash: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		}
+	}
+});
+const KbSourceIngestedEvent = defineEvent({
+	meta: {
+		key: "kb.source.ingested",
+		version: 1,
+		description: "Source document ingested (immutable).",
+		stability: "experimental",
+		owners: ["@examples"],
+		tags: ["knowledge"]
+	},
+	payload: KbSourceIngestedPayload
+});
+const KbRuleVersionCreatedPayload = defineSchemaModel({
+	name: "KbRuleVersionCreatedPayload",
+	description: "Emitted when a rule version draft is created.",
+	fields: {
+		ruleVersionId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		ruleId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		jurisdiction: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		status: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		}
+	}
+});
+const KbRuleVersionCreatedEvent = defineEvent({
+	meta: {
+		key: "kb.ruleVersion.created",
+		version: 1,
+		description: "Rule version created (draft).",
+		stability: "experimental",
+		owners: ["@examples"],
+		tags: ["knowledge"]
+	},
+	payload: KbRuleVersionCreatedPayload
+});
+const KbRuleVersionApprovedPayload = defineSchemaModel({
+	name: "KbRuleVersionApprovedPayload",
+	description: "Emitted when a rule version is approved.",
+	fields: {
+		ruleVersionId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		approver: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		}
+	}
+});
+const KbRuleVersionApprovedEvent = defineEvent({
+	meta: {
+		key: "kb.ruleVersion.approved",
+		version: 1,
+		description: "Rule version approved (human verified).",
+		stability: "experimental",
+		owners: ["@examples"],
+		tags: ["knowledge"]
+	},
+	payload: KbRuleVersionApprovedPayload
+});
+const KbSnapshotPublishedPayload = defineSchemaModel({
+	name: "KbSnapshotPublishedPayload",
+	description: "Emitted when a KB snapshot is published.",
+	fields: {
+		snapshotId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		jurisdiction: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		includedRuleVersionsCount: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		}
+	}
+});
+const KbSnapshotPublishedEvent = defineEvent({
+	meta: {
+		key: "kb.snapshot.published",
+		version: 1,
+		description: "KB snapshot published.",
+		stability: "experimental",
+		owners: ["@examples"],
+		tags: ["knowledge"]
+	},
+	payload: KbSnapshotPublishedPayload
+});
+
+//#endregion
+export { KbRuleVersionApprovedEvent, KbRuleVersionCreatedEvent, KbSnapshotPublishedEvent, KbSourceIngestedEvent };
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","names":[],"sources":["../src/events.ts"],"sourcesContent":["import { defineEvent, defineSchemaModel } from '@lssm/lib.contracts';\nimport { ScalarTypeEnum } from '@lssm/lib.schema';\n\nconst KbSourceIngestedPayload = defineSchemaModel({\n  name: 'KbSourceIngestedPayload',\n  description: 'Emitted when a source document is ingested.',\n  fields: {\n    sourceDocumentId: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    hash: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nexport const KbSourceIngestedEvent = defineEvent({\n  meta: {\n    key: 'kb.source.ingested',\n    version: 1,\n    description: 'Source document ingested (immutable).',\n    stability: 'experimental',\n    owners: ['@examples'],\n    tags: ['knowledge'],\n  },\n  payload: KbSourceIngestedPayload,\n});\n\nconst KbRuleVersionCreatedPayload = defineSchemaModel({\n  name: 'KbRuleVersionCreatedPayload',\n  description: 'Emitted when a rule version draft is created.',\n  fields: {\n    ruleVersionId: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    ruleId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    status: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nexport const KbRuleVersionCreatedEvent = defineEvent({\n  meta: {\n    key: 'kb.ruleVersion.created',\n    version: 1,\n    description: 'Rule version created (draft).',\n    stability: 'experimental',\n    owners: ['@examples'],\n    tags: ['knowledge'],\n  },\n  payload: KbRuleVersionCreatedPayload,\n});\n\nconst KbRuleVersionApprovedPayload = defineSchemaModel({\n  name: 'KbRuleVersionApprovedPayload',\n  description: 'Emitted when a rule version is approved.',\n  fields: {\n    ruleVersionId: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    approver: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nexport const KbRuleVersionApprovedEvent = defineEvent({\n  meta: {\n    key: 'kb.ruleVersion.approved',\n    version: 1,\n    description: 'Rule version approved (human verified).',\n    stability: 'experimental',\n    owners: ['@examples'],\n    tags: ['knowledge'],\n  },\n  payload: KbRuleVersionApprovedPayload,\n});\n\nconst KbSnapshotPublishedPayload = defineSchemaModel({\n  name: 'KbSnapshotPublishedPayload',\n  description: 'Emitted when a KB snapshot is published.',\n  fields: {\n    snapshotId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    includedRuleVersionsCount: {\n      type: ScalarTypeEnum.Int_unsecure(),\n      isOptional: false,\n    },\n  },\n});\n\nexport const KbSnapshotPublishedEvent = defineEvent({\n  meta: {\n    key: 'kb.snapshot.published',\n    version: 1,\n    description: 'KB snapshot published.',\n    stability: 'experimental',\n    owners: ['@examples'],\n    tags: ['knowledge'],\n  },\n  payload: KbSnapshotPublishedPayload,\n});\n"],"mappings":";;;;AAGA,MAAM,0BAA0B,kBAAkB;CAChD,MAAM;CACN,aAAa;CACb,QAAQ;EACN,kBAAkB;GAChB,MAAM,eAAe,iBAAiB;GACtC,YAAY;GACb;EACD,cAAc;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EAC3E,MAAM;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACpE;CACF,CAAC;AAEF,MAAa,wBAAwB,YAAY;CAC/C,MAAM;EACJ,KAAK;EACL,SAAS;EACT,aAAa;EACb,WAAW;EACX,QAAQ,CAAC,YAAY;EACrB,MAAM,CAAC,YAAY;EACpB;CACD,SAAS;CACV,CAAC;AAEF,MAAM,8BAA8B,kBAAkB;CACpD,MAAM;CACN,aAAa;CACb,QAAQ;EACN,eAAe;GACb,MAAM,eAAe,iBAAiB;GACtC,YAAY;GACb;EACD,QAAQ;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACrE,cAAc;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EAC3E,QAAQ;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACtE;CACF,CAAC;AAEF,MAAa,4BAA4B,YAAY;CACnD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,aAAa;EACb,WAAW;EACX,QAAQ,CAAC,YAAY;EACrB,MAAM,CAAC,YAAY;EACpB;CACD,SAAS;CACV,CAAC;AAEF,MAAM,+BAA+B,kBAAkB;CACrD,MAAM;CACN,aAAa;CACb,QAAQ;EACN,eAAe;GACb,MAAM,eAAe,iBAAiB;GACtC,YAAY;GACb;EACD,UAAU;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACxE;CACF,CAAC;AAEF,MAAa,6BAA6B,YAAY;CACpD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,aAAa;EACb,WAAW;EACX,QAAQ,CAAC,YAAY;EACrB,MAAM,CAAC,YAAY;EACpB;CACD,SAAS;CACV,CAAC;AAEF,MAAM,6BAA6B,kBAAkB;CACnD,MAAM;CACN,aAAa;CACb,QAAQ;EACN,YAAY;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACzE,cAAc;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EAC3E,2BAA2B;GACzB,MAAM,eAAe,cAAc;GACnC,YAAY;GACb;EACF;CACF,CAAC;AAEF,MAAa,2BAA2B,YAAY;CAClD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,aAAa;EACb,WAAW;EACX,QAAQ,CAAC,YAAY;EACrB,MAAM,CAAC,YAAY;EACpB;CACD,SAAS;CACV,CAAC"}

package/dist/example.d.ts

@@ -0,0 +1,36 @@
+//#region src/example.d.ts
+declare const example: {
+  readonly id: "versioned-knowledge-base";
+  readonly title: "Versioned Knowledge Base";
+  readonly summary: "Curated KB with immutable sources, reviewable rule versions, and published snapshots.";
+  readonly tags: readonly ["knowledge", "versioning", "snapshots"];
+  readonly kind: "knowledge";
+  readonly visibility: "public";
+  readonly docs: {
+    readonly rootDocId: "docs.examples.versioned-knowledge-base";
+  };
+  readonly entrypoints: {
+    readonly packageName: "@lssm/example.versioned-knowledge-base";
+    readonly feature: "./feature";
+    readonly contracts: "./contracts";
+    readonly handlers: "./handlers";
+    readonly docs: "./docs";
+  };
+  readonly surfaces: {
+    readonly templates: true;
+    readonly sandbox: {
+      readonly enabled: true;
+      readonly modes: readonly ["markdown", "specs", "builder"];
+    };
+    readonly studio: {
+      readonly enabled: true;
+      readonly installable: true;
+    };
+    readonly mcp: {
+      readonly enabled: true;
+    };
+  };
+};
+//#endregion
+export { example as default };
+//# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"sourcesContent":[],"mappings":";cAAM;EAAA,SAAA,EAwBI,EAAA,0BAAA"}

package/dist/example.js

@@ -1 +1,42 @@
-var e={id:`versioned-knowledge-base`,title:`Versioned Knowledge Base`,summary:`Curated KB with immutable sources, reviewable rule versions, and published snapshots.`,tags:[`knowledge`,`versioning`,`snapshots`],kind:`knowledge`,visibility:`public`,docs:{rootDocId:`docs.examples.versioned-knowledge-base`},entrypoints:{packageName:`@lssm/example.versioned-knowledge-base`,feature:`./feature`,contracts:`./contracts`,handlers:`./handlers`,docs:`./docs`},surfaces:{templates:!0,sandbox:{enabled:!0,modes:[`markdown`,`specs`,`builder`]},studio:{enabled:!0,installable:!0},mcp:{enabled:!0}}};export{e as default};
+//#region src/example.ts
+const example = {
+	id: "versioned-knowledge-base",
+	title: "Versioned Knowledge Base",
+	summary: "Curated KB with immutable sources, reviewable rule versions, and published snapshots.",
+	tags: [
+		"knowledge",
+		"versioning",
+		"snapshots"
+	],
+	kind: "knowledge",
+	visibility: "public",
+	docs: { rootDocId: "docs.examples.versioned-knowledge-base" },
+	entrypoints: {
+		packageName: "@lssm/example.versioned-knowledge-base",
+		feature: "./feature",
+		contracts: "./contracts",
+		handlers: "./handlers",
+		docs: "./docs"
+	},
+	surfaces: {
+		templates: true,
+		sandbox: {
+			enabled: true,
+			modes: [
+				"markdown",
+				"specs",
+				"builder"
+			]
+		},
+		studio: {
+			enabled: true,
+			installable: true
+		},
+		mcp: { enabled: true }
+	}
+};
+var example_default = example;
+
+//#endregion
+export { example_default as default };
+//# sourceMappingURL=example.js.map

package/dist/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","names":[],"sources":["../src/example.ts"],"sourcesContent":["const example = {\n  id: 'versioned-knowledge-base',\n  title: 'Versioned Knowledge Base',\n  summary:\n    'Curated KB with immutable sources, reviewable rule versions, and published snapshots.',\n  tags: ['knowledge', 'versioning', 'snapshots'],\n  kind: 'knowledge',\n  visibility: 'public',\n  docs: {\n    rootDocId: 'docs.examples.versioned-knowledge-base',\n  },\n  entrypoints: {\n    packageName: '@lssm/example.versioned-knowledge-base',\n    feature: './feature',\n    contracts: './contracts',\n    handlers: './handlers',\n    docs: './docs',\n  },\n  surfaces: {\n    templates: true,\n    sandbox: { enabled: true, modes: ['markdown', 'specs', 'builder'] },\n    studio: { enabled: true, installable: true },\n    mcp: { enabled: true },\n  },\n} as const;\n\nexport default example;\n"],"mappings":";AAAA,MAAM,UAAU;CACd,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;EAAC;EAAa;EAAc;EAAY;CAC9C,MAAM;CACN,YAAY;CACZ,MAAM,EACJ,WAAW,0CACZ;CACD,aAAa;EACX,aAAa;EACb,SAAS;EACT,WAAW;EACX,UAAU;EACV,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GAAE,SAAS;GAAM,OAAO;IAAC;IAAY;IAAS;IAAU;GAAE;EACnE,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF;AAED,sBAAe"}

package/dist/handlers/index.d.ts

@@ -0,0 +1,2 @@
+import { MemoryKbHandlers, MemoryKbStore, createMemoryKbHandlers, createMemoryKbStore } from "./memory.handlers.js";
+export { MemoryKbHandlers, MemoryKbStore, createMemoryKbHandlers, createMemoryKbStore };

package/dist/handlers/index.js

@@ -1 +1,3 @@
-import{createMemoryKbHandlers as e,createMemoryKbStore as t}from"./memory.handlers.js";export{e as createMemoryKbHandlers,t as createMemoryKbStore};
+import { createMemoryKbHandlers, createMemoryKbStore } from "./memory.handlers.js";
+
+export { createMemoryKbHandlers, createMemoryKbStore };

package/dist/handlers/memory.handlers.d.ts

@@ -0,0 +1,78 @@
+//#region src/handlers/memory.handlers.d.ts
+interface SourceRef {
+  sourceDocumentId: string;
+  excerpt?: string;
+}
+interface SourceDocument {
+  id: string;
+  jurisdiction: string;
+  authority: string;
+  title: string;
+  fetchedAt: Date;
+  hash: string;
+  fileId: string;
+}
+interface Rule {
+  id: string;
+  jurisdiction: string;
+  topicKey: string;
+}
+interface RuleVersion {
+  id: string;
+  ruleId: string;
+  jurisdiction: string;
+  topicKey: string;
+  version: number;
+  content: string;
+  sourceRefs: SourceRef[];
+  status: 'draft' | 'approved' | 'rejected';
+  approvedBy?: string;
+  approvedAt?: Date;
+  createdAt: Date;
+}
+interface KBSnapshot {
+  id: string;
+  jurisdiction: string;
+  asOfDate: Date;
+  includedRuleVersionIds: string[];
+  publishedAt: Date;
+}
+interface MemoryKbStore {
+  sources: Map<string, SourceDocument>;
+  rules: Map<string, Rule>;
+  ruleVersions: Map<string, RuleVersion>;
+  snapshots: Map<string, KBSnapshot>;
+  nextRuleVersionNumberByRuleId: Map<string, number>;
+}
+declare function createMemoryKbStore(): MemoryKbStore;
+interface MemoryKbHandlers {
+  createRule(rule: Rule): Promise<Rule>;
+  ingestSource(input: Omit<SourceDocument, 'id'>): Promise<SourceDocument>;
+  upsertRuleVersion(input: {
+    ruleId: string;
+    content: string;
+    sourceRefs: SourceRef[];
+  }): Promise<RuleVersion>;
+  approveRuleVersion(input: {
+    ruleVersionId: string;
+    approver: string;
+  }): Promise<RuleVersion>;
+  publishSnapshot(input: {
+    jurisdiction: string;
+    asOfDate: Date;
+  }): Promise<KBSnapshot>;
+  search(input: {
+    snapshotId: string;
+    jurisdiction: string;
+    query: string;
+  }): Promise<{
+    items: {
+      ruleVersionId: string;
+      excerpt?: string;
+    }[];
+  }>;
+}
+declare function createMemoryKbHandlers(store: MemoryKbStore): MemoryKbHandlers;
+//#endregion
+export { MemoryKbHandlers, MemoryKbStore, createMemoryKbHandlers, createMemoryKbStore };
+//# sourceMappingURL=memory.handlers.d.ts.map

package/dist/handlers/memory.handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.handlers.d.ts","names":[],"sources":["../../src/handlers/memory.handlers.ts"],"sourcesContent":[],"mappings":";UAAU,SAAA;EAAA,gBAAS,EAAA,MAAA;EAIT,OAAA,CAAA,EAAA,MAAA;AAKO;AAIH,UATJ,cAAA,CAcW;EAOP,EAAA,EAAA,MAAA;EAGC,YAAA,EAAA,MAAA;EACF,SAAA,EAAA,MAAA;EAAI,KAAA,EAAA,MAAA;EAEP,SAAA,EAtBG,IAsBO;EAQH,IAAA,EAAA,MAAA;EACM,MAAA,EAAA,MAAA;;UA3Bb,IAAA,CA4BW;EAAZ,EAAA,EAAA,MAAA;EACmB,YAAA,EAAA,MAAA;EAAZ,QAAA,EAAA,MAAA;;UAxBN,WAAA,CAyBG;EACoB,EAAA,EAAA,MAAA;EAAG,MAAA,EAAA,MAAA;EAGpB,YAAA,EAAA,MAAA;EAUC,QAAA,EAAA,MAAA;EACE,OAAA,EAAA,MAAA;EAAe,OAAA,EAAA,MAAA;EAAR,UAAA,EAjCZ,SAiCY,EAAA;EACC,MAAA,EAAA,OAAA,GAAA,UAAA,GAAA,UAAA;EAAL,UAAA,CAAA,EAAA,MAAA;EAAqC,UAAA,CAAA,EA/B5C,IA+B4C;EAAR,SAAA,EA9BtC,IA8BsC;;UA5BzC,UAAA,CAiCI;EAAR,EAAA,EAAA,MAAA;EAIQ,YAAA,EAAA,MAAA;EAAR,QAAA,EAlCM,IAkCN;EAGQ,sBAAA,EAAA,MAAA,EAAA;EACA,WAAA,EApCC,IAoCD;;AAKR,UAtCW,aAAA,CAsCX;EAAO,OAAA,EArCF,GAqCE,CAAA,MAAA,EArCU,cAqCV,CAAA;EAOG,KAAA,EA3CP,GA2CO,CAAA,MAAA,EA3CK,IA2CL,CAAA;gBA1CA,YAAY;aACf,YAAY;iCACQ;;iBAGjB,mBAAA,CAAA,GAAuB;UAUtB,gBAAA;mBACE,OAAO,QAAQ;sBACZ,KAAK,wBAAwB,QAAQ;;;;gBAI3C;MACV,QAAQ;;;;MAIR,QAAQ;;;cAGA;MACR,QAAQ;;;;;MAKR;;;;;;;iBAOU,sBAAA,QAA8B,gBAAgB"}

package/dist/handlers/memory.handlers.js

@@ -1 +1,104 @@
-function e(){return{sources:new Map,rules:new Map,ruleVersions:new Map,snapshots:new Map,nextRuleVersionNumberByRuleId:new Map}}function t(e,t){return`${e}_${t.replace(/[^a-zA-Z0-9_-]/g,`_`)}`}function n(e){async function n(t){return e.rules.set(t.id,t),t}async function r(n){let r=t(`src`,`${n.jurisdiction}_${n.hash}`),i={id:r,...n};return e.sources.set(r,i),i}async function i(n){if(!n.sourceRefs.length)throw Error(`SOURCE_REFS_REQUIRED`);let r=e.rules.get(n.ruleId);if(!r)throw Error(`RULE_NOT_FOUND`);let i=(e.nextRuleVersionNumberByRuleId.get(n.ruleId)??0)+1;e.nextRuleVersionNumberByRuleId.set(n.ruleId,i);let a=t(`rv`,`${n.ruleId}_${i}`),o={id:a,ruleId:n.ruleId,jurisdiction:r.jurisdiction,topicKey:r.topicKey,version:i,content:n.content,sourceRefs:n.sourceRefs,status:`draft`,createdAt:new Date,approvedAt:void 0,approvedBy:void 0};return e.ruleVersions.set(a,o),o}async function a(t){let n=e.ruleVersions.get(t.ruleVersionId);if(!n)throw Error(`RULE_VERSION_NOT_FOUND`);let r={...n,status:`approved`,approvedBy:t.approver,approvedAt:new Date};return e.ruleVersions.set(r.id,r),r}async function o(n){let r=[...e.ruleVersions.values()].filter(e=>e.status===`approved`&&e.jurisdiction===n.jurisdiction);if(r.length===0)throw Error(`NO_APPROVED_RULES`);let i=r.map(e=>e.id).sort(),a=t(`snap`,`${n.jurisdiction}_${n.asOfDate.toISOString().slice(0,10)}_${i.length}`),o={id:a,jurisdiction:n.jurisdiction,asOfDate:n.asOfDate,includedRuleVersionIds:i,publishedAt:new Date};return e.snapshots.set(a,o),o}async function s(t){let n=e.snapshots.get(t.snapshotId);if(!n)throw Error(`SNAPSHOT_NOT_FOUND`);if(n.jurisdiction!==t.jurisdiction)throw Error(`JURISDICTION_MISMATCH`);let r=t.query.toLowerCase().split(/\s+/).map(e=>e.trim()).filter(Boolean);return{items:n.includedRuleVersionIds.map(t=>e.ruleVersions.get(t)).filter(e=>!!e).filter(e=>{if(r.length===0)return!0;let t=e.content.toLowerCase();return r.every(e=>t.includes(e))}).map(e=>({ruleVersionId:e.id,excerpt:e.content.slice(0,120)}))}}return{createRule:n,ingestSource:r,upsertRuleVersion:i,approveRuleVersion:a,publishSnapshot:o,search:s}}export{n as createMemoryKbHandlers,e as createMemoryKbStore};
+//#region src/handlers/memory.handlers.ts
+function createMemoryKbStore() {
+	return {
+		sources: /* @__PURE__ */ new Map(),
+		rules: /* @__PURE__ */ new Map(),
+		ruleVersions: /* @__PURE__ */ new Map(),
+		snapshots: /* @__PURE__ */ new Map(),
+		nextRuleVersionNumberByRuleId: /* @__PURE__ */ new Map()
+	};
+}
+function stableId(prefix, value) {
+	return `${prefix}_${value.replace(/[^a-zA-Z0-9_-]/g, "_")}`;
+}
+function createMemoryKbHandlers(store) {
+	async function createRule(rule) {
+		store.rules.set(rule.id, rule);
+		return rule;
+	}
+	async function ingestSource(input) {
+		const id = stableId("src", `${input.jurisdiction}_${input.hash}`);
+		const doc = {
+			id,
+			...input
+		};
+		store.sources.set(id, doc);
+		return doc;
+	}
+	async function upsertRuleVersion(input) {
+		if (!input.sourceRefs.length) throw new Error("SOURCE_REFS_REQUIRED");
+		const rule = store.rules.get(input.ruleId);
+		if (!rule) throw new Error("RULE_NOT_FOUND");
+		const next = (store.nextRuleVersionNumberByRuleId.get(input.ruleId) ?? 0) + 1;
+		store.nextRuleVersionNumberByRuleId.set(input.ruleId, next);
+		const id = stableId("rv", `${input.ruleId}_${next}`);
+		const ruleVersion = {
+			id,
+			ruleId: input.ruleId,
+			jurisdiction: rule.jurisdiction,
+			topicKey: rule.topicKey,
+			version: next,
+			content: input.content,
+			sourceRefs: input.sourceRefs,
+			status: "draft",
+			createdAt: /* @__PURE__ */ new Date(),
+			approvedAt: void 0,
+			approvedBy: void 0
+		};
+		store.ruleVersions.set(id, ruleVersion);
+		return ruleVersion;
+	}
+	async function approveRuleVersion(input) {
+		const existing = store.ruleVersions.get(input.ruleVersionId);
+		if (!existing) throw new Error("RULE_VERSION_NOT_FOUND");
+		const approved = {
+			...existing,
+			status: "approved",
+			approvedBy: input.approver,
+			approvedAt: /* @__PURE__ */ new Date()
+		};
+		store.ruleVersions.set(approved.id, approved);
+		return approved;
+	}
+	async function publishSnapshot(input) {
+		const approved = [...store.ruleVersions.values()].filter((rv) => rv.status === "approved" && rv.jurisdiction === input.jurisdiction);
+		if (approved.length === 0) throw new Error("NO_APPROVED_RULES");
+		const includedRuleVersionIds = approved.map((rv) => rv.id).sort();
+		const id = stableId("snap", `${input.jurisdiction}_${input.asOfDate.toISOString().slice(0, 10)}_${includedRuleVersionIds.length}`);
+		const snapshot = {
+			id,
+			jurisdiction: input.jurisdiction,
+			asOfDate: input.asOfDate,
+			includedRuleVersionIds,
+			publishedAt: /* @__PURE__ */ new Date()
+		};
+		store.snapshots.set(id, snapshot);
+		return snapshot;
+	}
+	async function search(input) {
+		const snapshot = store.snapshots.get(input.snapshotId);
+		if (!snapshot) throw new Error("SNAPSHOT_NOT_FOUND");
+		if (snapshot.jurisdiction !== input.jurisdiction) throw new Error("JURISDICTION_MISMATCH");
+		const tokens = input.query.toLowerCase().split(/\s+/).map((t) => t.trim()).filter(Boolean);
+		return { items: snapshot.includedRuleVersionIds.map((id) => store.ruleVersions.get(id)).filter((rv) => Boolean(rv)).filter((rv) => {
+			if (tokens.length === 0) return true;
+			const hay = rv.content.toLowerCase();
+			return tokens.every((token) => hay.includes(token));
+		}).map((rv) => ({
+			ruleVersionId: rv.id,
+			excerpt: rv.content.slice(0, 120)
+		})) };
+	}
+	return {
+		createRule,
+		ingestSource,
+		upsertRuleVersion,
+		approveRuleVersion,
+		publishSnapshot,
+		search
+	};
+}
+
+//#endregion
+export { createMemoryKbHandlers, createMemoryKbStore };
+//# sourceMappingURL=memory.handlers.js.map

package/dist/handlers/memory.handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.handlers.js","names":["doc: SourceDocument","ruleVersion: RuleVersion","approved: RuleVersion","snapshot: KBSnapshot"],"sources":["../../src/handlers/memory.handlers.ts"],"sourcesContent":["interface SourceRef {\n  sourceDocumentId: string;\n  excerpt?: string;\n}\ninterface SourceDocument {\n  id: string;\n  jurisdiction: string;\n  authority: string;\n  title: string;\n  fetchedAt: Date;\n  hash: string;\n  fileId: string;\n}\ninterface Rule {\n  id: string;\n  jurisdiction: string;\n  topicKey: string;\n}\ninterface RuleVersion {\n  id: string;\n  ruleId: string;\n  jurisdiction: string;\n  topicKey: string;\n  version: number;\n  content: string;\n  sourceRefs: SourceRef[];\n  status: 'draft' | 'approved' | 'rejected';\n  approvedBy?: string;\n  approvedAt?: Date;\n  createdAt: Date;\n}\ninterface KBSnapshot {\n  id: string;\n  jurisdiction: string;\n  asOfDate: Date;\n  includedRuleVersionIds: string[];\n  publishedAt: Date;\n}\n\nexport interface MemoryKbStore {\n  sources: Map<string, SourceDocument>;\n  rules: Map<string, Rule>;\n  ruleVersions: Map<string, RuleVersion>;\n  snapshots: Map<string, KBSnapshot>;\n  nextRuleVersionNumberByRuleId: Map<string, number>;\n}\n\nexport function createMemoryKbStore(): MemoryKbStore {\n  return {\n    sources: new Map(),\n    rules: new Map(),\n    ruleVersions: new Map(),\n    snapshots: new Map(),\n    nextRuleVersionNumberByRuleId: new Map(),\n  };\n}\n\nexport interface MemoryKbHandlers {\n  createRule(rule: Rule): Promise<Rule>;\n  ingestSource(input: Omit<SourceDocument, 'id'>): Promise<SourceDocument>;\n  upsertRuleVersion(input: {\n    ruleId: string;\n    content: string;\n    sourceRefs: SourceRef[];\n  }): Promise<RuleVersion>;\n  approveRuleVersion(input: {\n    ruleVersionId: string;\n    approver: string;\n  }): Promise<RuleVersion>;\n  publishSnapshot(input: {\n    jurisdiction: string;\n    asOfDate: Date;\n  }): Promise<KBSnapshot>;\n  search(input: {\n    snapshotId: string;\n    jurisdiction: string;\n    query: string;\n  }): Promise<{ items: { ruleVersionId: string; excerpt?: string }[] }>;\n}\n\nfunction stableId(prefix: string, value: string): string {\n  return `${prefix}_${value.replace(/[^a-zA-Z0-9_-]/g, '_')}`;\n}\n\nexport function createMemoryKbHandlers(store: MemoryKbStore): MemoryKbHandlers {\n  async function createRule(rule: Rule): Promise<Rule> {\n    store.rules.set(rule.id, rule);\n    return rule;\n  }\n\n  async function ingestSource(\n    input: Omit<SourceDocument, 'id'>\n  ): Promise<SourceDocument> {\n    const id = stableId('src', `${input.jurisdiction}_${input.hash}`);\n    const doc: SourceDocument = { id, ...input };\n    store.sources.set(id, doc);\n    return doc;\n  }\n\n  async function upsertRuleVersion(input: {\n    ruleId: string;\n    content: string;\n    sourceRefs: SourceRef[];\n  }): Promise<RuleVersion> {\n    if (!input.sourceRefs.length) {\n      throw new Error('SOURCE_REFS_REQUIRED');\n    }\n    const rule = store.rules.get(input.ruleId);\n    if (!rule) {\n      throw new Error('RULE_NOT_FOUND');\n    }\n    const next =\n      (store.nextRuleVersionNumberByRuleId.get(input.ruleId) ?? 0) + 1;\n    store.nextRuleVersionNumberByRuleId.set(input.ruleId, next);\n    const id = stableId('rv', `${input.ruleId}_${next}`);\n    const ruleVersion: RuleVersion = {\n      id,\n      ruleId: input.ruleId,\n      jurisdiction: rule.jurisdiction,\n      topicKey: rule.topicKey,\n      version: next,\n      content: input.content,\n      sourceRefs: input.sourceRefs,\n      status: 'draft',\n      createdAt: new Date(),\n      approvedAt: undefined,\n      approvedBy: undefined,\n    };\n    store.ruleVersions.set(id, ruleVersion);\n    return ruleVersion;\n  }\n\n  async function approveRuleVersion(input: {\n    ruleVersionId: string;\n    approver: string;\n  }): Promise<RuleVersion> {\n    const existing = store.ruleVersions.get(input.ruleVersionId);\n    if (!existing) {\n      throw new Error('RULE_VERSION_NOT_FOUND');\n    }\n    const approved: RuleVersion = {\n      ...existing,\n      status: 'approved',\n      approvedBy: input.approver,\n      approvedAt: new Date(),\n    };\n    store.ruleVersions.set(approved.id, approved);\n    return approved;\n  }\n\n  async function publishSnapshot(input: {\n    jurisdiction: string;\n    asOfDate: Date;\n  }): Promise<KBSnapshot> {\n    const approved = [...store.ruleVersions.values()].filter(\n      (rv) => rv.status === 'approved' && rv.jurisdiction === input.jurisdiction\n    );\n    if (approved.length === 0) {\n      throw new Error('NO_APPROVED_RULES');\n    }\n    const includedRuleVersionIds = approved.map((rv) => rv.id).sort();\n    const id = stableId(\n      'snap',\n      `${input.jurisdiction}_${input.asOfDate.toISOString().slice(0, 10)}_${includedRuleVersionIds.length}`\n    );\n    const snapshot: KBSnapshot = {\n      id,\n      jurisdiction: input.jurisdiction,\n      asOfDate: input.asOfDate,\n      includedRuleVersionIds,\n      publishedAt: new Date(),\n    };\n    store.snapshots.set(id, snapshot);\n    return snapshot;\n  }\n\n  async function search(input: {\n    snapshotId: string;\n    jurisdiction: string;\n    query: string;\n  }): Promise<{ items: { ruleVersionId: string; excerpt?: string }[] }> {\n    const snapshot = store.snapshots.get(input.snapshotId);\n    if (!snapshot) {\n      throw new Error('SNAPSHOT_NOT_FOUND');\n    }\n    if (snapshot.jurisdiction !== input.jurisdiction) {\n      throw new Error('JURISDICTION_MISMATCH');\n    }\n    const q = input.query.toLowerCase();\n    const tokens = q\n      .split(/\\s+/)\n      .map((t) => t.trim())\n      .filter(Boolean);\n    const items = snapshot.includedRuleVersionIds\n      .map((id) => store.ruleVersions.get(id))\n      .filter((rv): rv is RuleVersion => Boolean(rv))\n      .filter((rv) => {\n        if (tokens.length === 0) return true;\n        const hay = rv.content.toLowerCase();\n        return tokens.every((token) => hay.includes(token));\n      })\n      .map((rv) => ({\n        ruleVersionId: rv.id,\n        excerpt: rv.content.slice(0, 120),\n      }));\n    return { items };\n  }\n\n  return {\n    createRule,\n    ingestSource,\n    upsertRuleVersion,\n    approveRuleVersion,\n    publishSnapshot,\n    search,\n  };\n}\n"],"mappings":"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"}

package/dist/index.d.ts

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

package/dist/index.js

@@ -1 +1,11 @@
-import{KbRuleVersionApprovedEvent as e,KbRuleVersionCreatedEvent as t,KbSnapshotPublishedEvent as n,KbSourceIngestedEvent as r}from"./events.js";import i from"./example.js";import{KBSnapshotModel as a,RuleModel as o,RuleVersionModel as s,SourceDocumentModel as c,SourceRefModel as l}from"./entities/models.js";import"./entities/index.js";import{KbApproveRuleVersionContract as u,KbIngestSourceContract as d,KbPublishSnapshotContract as f,KbSearchContract as p,KbUpsertRuleVersionContract as m}from"./contracts/kb.js";import"./contracts/index.js";import{createMemoryKbHandlers as h,createMemoryKbStore as g}from"./handlers/memory.handlers.js";import{VersionedKnowledgeBaseFeature as _}from"./versioned-knowledge-base.feature.js";import"./docs/index.js";export{a as KBSnapshotModel,u as KbApproveRuleVersionContract,d as KbIngestSourceContract,f as KbPublishSnapshotContract,e as KbRuleVersionApprovedEvent,t as KbRuleVersionCreatedEvent,p as KbSearchContract,n as KbSnapshotPublishedEvent,r as KbSourceIngestedEvent,m as KbUpsertRuleVersionContract,o as RuleModel,s as RuleVersionModel,c as SourceDocumentModel,l as SourceRefModel,_ as VersionedKnowledgeBaseFeature,h as createMemoryKbHandlers,g as createMemoryKbStore,i as example};
+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 };