@contractspec/example.versioned-knowledge-base 3.7.16 → 3.7.18

package/dist/knowledge-snapshot-publication.migration.js

@@ -1,51 +1,9 @@
 // @bun
-// src/knowledge-snapshot-publication.migration.ts
-import {
-  OwnersEnum,
-  StabilityEnum,
-  TagsEnum
-} from "@contractspec/lib.contracts-spec/ownership";
-var KnowledgeSnapshotPublicationMigration = {
-  meta: {
-    key: "versioned-knowledge-base.migration.snapshot-publication",
-    version: "1.0.0",
-    title: "Knowledge Snapshot Publication Migration",
-    description: "Adds publication audit fields and validation checks for published knowledge snapshots.",
-    domain: "knowledge",
-    owners: [OwnersEnum.PlatformContent],
-    tags: ["knowledge", "migration", "snapshots", TagsEnum.Hygiene],
-    stability: StabilityEnum.Experimental
-  },
-  dependencies: ["versioned-knowledge-base.migration.bootstrap"],
-  plan: {
-    up: [
-      {
-        kind: "schema",
-        description: "Create the published snapshot audit table.",
-        sql: `
+import{OwnersEnum as d,StabilityEnum as f,TagsEnum as j}from"@contractspec/lib.contracts-spec/ownership";var q={meta:{key:"versioned-knowledge-base.migration.snapshot-publication",version:"1.0.0",title:"Knowledge Snapshot Publication Migration",description:"Adds publication audit fields and validation checks for published knowledge snapshots.",domain:"knowledge",owners:[d.PlatformContent],tags:["knowledge","migration","snapshots",j.Hygiene],stability:f.Experimental},dependencies:["versioned-knowledge-base.migration.bootstrap"],plan:{up:[{kind:"schema",description:"Create the published snapshot audit table.",sql:`
 CREATE TABLE kb_snapshot_publications (
   snapshot_id TEXT PRIMARY KEY,
   published_by TEXT NOT NULL,
   published_at TIMESTAMPTZ NOT NULL,
   source_count INTEGER NOT NULL,
   rule_version_count INTEGER NOT NULL
-);`
-      },
-      {
-        kind: "validation",
-        description: "Ensure snapshots have at least one approved rule version.",
-        assertion: "SELECT COUNT(*) = 0 FROM kb_snapshots WHERE array_length(included_rule_version_ids, 1) = 0"
-      }
-    ],
-    down: [
-      {
-        kind: "schema",
-        description: "Remove the snapshot publication audit table.",
-        sql: "DROP TABLE IF EXISTS kb_snapshot_publications;"
-      }
-    ]
-  }
-};
-export {
-  KnowledgeSnapshotPublicationMigration
-};
+);`},{kind:"validation",description:"Ensure snapshots have at least one approved rule version.",assertion:"SELECT COUNT(*) = 0 FROM kb_snapshots WHERE array_length(included_rule_version_ids, 1) = 0"}],down:[{kind:"schema",description:"Remove the snapshot publication audit table.",sql:"DROP TABLE IF EXISTS kb_snapshot_publications;"}]}};export{q as KnowledgeSnapshotPublicationMigration};

package/dist/node/docs/index.js

@@ -1,15 +1,4 @@
-// src/docs/versioned-knowledge-base.docblock.ts
-import { registerDocBlocks } from "@contractspec/lib.contracts-spec/docs";
-var docBlocks = [
-  {
-    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
+import{registerDocBlocks as f}from"@contractspec/lib.contracts-spec/docs";var h=[{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.
@@ -17,17 +6,7 @@ var docBlocks = [
 ## 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
+- 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
@@ -38,7 +17,4 @@ var docBlocks = [
 - kb.source.ingested
 - kb.ruleVersion.created
 - kb.ruleVersion.approved
-- kb.snapshot.published`
-  }
-];
-registerDocBlocks(docBlocks);
+- kb.snapshot.published`}];f(h);

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

@@ -1,15 +1,4 @@
-// src/docs/versioned-knowledge-base.docblock.ts
-import { registerDocBlocks } from "@contractspec/lib.contracts-spec/docs";
-var docBlocks = [
-  {
-    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
+import{registerDocBlocks as f}from"@contractspec/lib.contracts-spec/docs";var h=[{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.
@@ -17,17 +6,7 @@ var docBlocks = [
 ## 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
+- 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
@@ -38,7 +17,4 @@ var docBlocks = [
 - kb.source.ingested
 - kb.ruleVersion.created
 - kb.ruleVersion.approved
-- kb.snapshot.published`
-  }
-];
-registerDocBlocks(docBlocks);
+- kb.snapshot.published`}];f(h);

package/dist/node/entities/index.js

@@ -1,74 +1 @@
-// src/entities/models.ts
-import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
-var SourceDocumentModel = defineSchemaModel({
-  name: "SourceDocument",
-  description: "Immutable raw source document metadata referencing a stored file.",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    authority: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    title: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    fetchedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
-    hash: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    fileId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
-  }
-});
-var SourceRefModel = defineSchemaModel({
-  name: "SourceRef",
-  description: "Reference to a source document used to justify a rule version.",
-  fields: {
-    sourceDocumentId: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isOptional: false
-    },
-    excerpt: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
-  }
-});
-var RuleModel = defineSchemaModel({
-  name: "Rule",
-  description: "Curated rule (stable identity) with topic + jurisdiction scope.",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    topicKey: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
-  }
-});
-var RuleVersionModel = defineSchemaModel({
-  name: "RuleVersion",
-  description: "A versioned rule content with source references and approval status.",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    ruleId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    topicKey: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    version: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    content: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    sourceRefs: { type: SourceRefModel, isArray: true, isOptional: false },
-    status: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    approvedBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    approvedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
-    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
-  }
-});
-var KBSnapshotModel = defineSchemaModel({
-  name: "KBSnapshot",
-  description: "Published KB snapshot (as-of) referencing approved rule versions.",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    asOfDate: { type: ScalarTypeEnum.DateTime(), isOptional: false },
-    includedRuleVersionIds: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isArray: true,
-      isOptional: false
-    },
-    publishedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
-  }
-});
-export {
-  SourceRefModel,
-  SourceDocumentModel,
-  RuleVersionModel,
-  RuleModel,
-  KBSnapshotModel
-};
+import{defineSchemaModel as t,ScalarTypeEnum as e}from"@contractspec/lib.schema";var n=t({name:"SourceDocument",description:"Immutable raw source document metadata referencing a stored file.",fields:{id:{type:e.String_unsecure(),isOptional:!1},jurisdiction:{type:e.String_unsecure(),isOptional:!1},authority:{type:e.String_unsecure(),isOptional:!1},title:{type:e.String_unsecure(),isOptional:!1},fetchedAt:{type:e.DateTime(),isOptional:!1},hash:{type:e.String_unsecure(),isOptional:!1},fileId:{type:e.String_unsecure(),isOptional:!1}}}),i=t({name:"SourceRef",description:"Reference to a source document used to justify a rule version.",fields:{sourceDocumentId:{type:e.String_unsecure(),isOptional:!1},excerpt:{type:e.String_unsecure(),isOptional:!0}}}),r=t({name:"Rule",description:"Curated rule (stable identity) with topic + jurisdiction scope.",fields:{id:{type:e.String_unsecure(),isOptional:!1},jurisdiction:{type:e.String_unsecure(),isOptional:!1},topicKey:{type:e.String_unsecure(),isOptional:!1}}}),o=t({name:"RuleVersion",description:"A versioned rule content with source references and approval status.",fields:{id:{type:e.String_unsecure(),isOptional:!1},ruleId:{type:e.String_unsecure(),isOptional:!1},jurisdiction:{type:e.String_unsecure(),isOptional:!1},topicKey:{type:e.String_unsecure(),isOptional:!1},version:{type:e.String_unsecure(),isOptional:!1},content:{type:e.String_unsecure(),isOptional:!1},sourceRefs:{type:i,isArray:!0,isOptional:!1},status:{type:e.String_unsecure(),isOptional:!1},approvedBy:{type:e.String_unsecure(),isOptional:!0},approvedAt:{type:e.DateTime(),isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!1}}}),a=t({name:"KBSnapshot",description:"Published KB snapshot (as-of) referencing approved rule versions.",fields:{id:{type:e.String_unsecure(),isOptional:!1},jurisdiction:{type:e.String_unsecure(),isOptional:!1},asOfDate:{type:e.DateTime(),isOptional:!1},includedRuleVersionIds:{type:e.String_unsecure(),isArray:!0,isOptional:!1},publishedAt:{type:e.DateTime(),isOptional:!1}}});export{i as SourceRefModel,n as SourceDocumentModel,o as RuleVersionModel,r as RuleModel,a as KBSnapshotModel};

package/dist/node/entities/models.js

@@ -1,74 +1 @@
-// src/entities/models.ts
-import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
-var SourceDocumentModel = defineSchemaModel({
-  name: "SourceDocument",
-  description: "Immutable raw source document metadata referencing a stored file.",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    authority: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    title: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    fetchedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
-    hash: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    fileId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
-  }
-});
-var SourceRefModel = defineSchemaModel({
-  name: "SourceRef",
-  description: "Reference to a source document used to justify a rule version.",
-  fields: {
-    sourceDocumentId: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isOptional: false
-    },
-    excerpt: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
-  }
-});
-var RuleModel = defineSchemaModel({
-  name: "Rule",
-  description: "Curated rule (stable identity) with topic + jurisdiction scope.",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    topicKey: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
-  }
-});
-var RuleVersionModel = defineSchemaModel({
-  name: "RuleVersion",
-  description: "A versioned rule content with source references and approval status.",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    ruleId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    topicKey: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    version: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    content: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    sourceRefs: { type: SourceRefModel, isArray: true, isOptional: false },
-    status: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    approvedBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    approvedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
-    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
-  }
-});
-var KBSnapshotModel = defineSchemaModel({
-  name: "KBSnapshot",
-  description: "Published KB snapshot (as-of) referencing approved rule versions.",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    asOfDate: { type: ScalarTypeEnum.DateTime(), isOptional: false },
-    includedRuleVersionIds: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isArray: true,
-      isOptional: false
-    },
-    publishedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
-  }
-});
-export {
-  SourceRefModel,
-  SourceDocumentModel,
-  RuleVersionModel,
-  RuleModel,
-  KBSnapshotModel
-};
+import{defineSchemaModel as t,ScalarTypeEnum as e}from"@contractspec/lib.schema";var n=t({name:"SourceDocument",description:"Immutable raw source document metadata referencing a stored file.",fields:{id:{type:e.String_unsecure(),isOptional:!1},jurisdiction:{type:e.String_unsecure(),isOptional:!1},authority:{type:e.String_unsecure(),isOptional:!1},title:{type:e.String_unsecure(),isOptional:!1},fetchedAt:{type:e.DateTime(),isOptional:!1},hash:{type:e.String_unsecure(),isOptional:!1},fileId:{type:e.String_unsecure(),isOptional:!1}}}),i=t({name:"SourceRef",description:"Reference to a source document used to justify a rule version.",fields:{sourceDocumentId:{type:e.String_unsecure(),isOptional:!1},excerpt:{type:e.String_unsecure(),isOptional:!0}}}),r=t({name:"Rule",description:"Curated rule (stable identity) with topic + jurisdiction scope.",fields:{id:{type:e.String_unsecure(),isOptional:!1},jurisdiction:{type:e.String_unsecure(),isOptional:!1},topicKey:{type:e.String_unsecure(),isOptional:!1}}}),a=t({name:"RuleVersion",description:"A versioned rule content with source references and approval status.",fields:{id:{type:e.String_unsecure(),isOptional:!1},ruleId:{type:e.String_unsecure(),isOptional:!1},jurisdiction:{type:e.String_unsecure(),isOptional:!1},topicKey:{type:e.String_unsecure(),isOptional:!1},version:{type:e.String_unsecure(),isOptional:!1},content:{type:e.String_unsecure(),isOptional:!1},sourceRefs:{type:i,isArray:!0,isOptional:!1},status:{type:e.String_unsecure(),isOptional:!1},approvedBy:{type:e.String_unsecure(),isOptional:!0},approvedAt:{type:e.DateTime(),isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!1}}}),o=t({name:"KBSnapshot",description:"Published KB snapshot (as-of) referencing approved rule versions.",fields:{id:{type:e.String_unsecure(),isOptional:!1},jurisdiction:{type:e.String_unsecure(),isOptional:!1},asOfDate:{type:e.DateTime(),isOptional:!1},includedRuleVersionIds:{type:e.String_unsecure(),isArray:!0,isOptional:!1},publishedAt:{type:e.DateTime(),isOptional:!1}}});export{i as SourceRefModel,n as SourceDocumentModel,a as RuleVersionModel,r as RuleModel,o as KBSnapshotModel};

package/dist/node/events.js

@@ -1,101 +1 @@
-// src/events.ts
-import { defineEvent } from "@contractspec/lib.contracts-spec";
-import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
-var 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 }
-  }
-});
-var KbSourceIngestedEvent = defineEvent({
-  meta: {
-    key: "kb.source.ingested",
-    version: "1.0.0",
-    description: "Source document ingested (immutable).",
-    stability: "experimental",
-    owners: ["@examples"],
-    tags: ["knowledge"]
-  },
-  payload: KbSourceIngestedPayload
-});
-var 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 }
-  }
-});
-var KbRuleVersionCreatedEvent = defineEvent({
-  meta: {
-    key: "kb.ruleVersion.created",
-    version: "1.0.0",
-    description: "Rule version created (draft).",
-    stability: "experimental",
-    owners: ["@examples"],
-    tags: ["knowledge"]
-  },
-  payload: KbRuleVersionCreatedPayload
-});
-var 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 }
-  }
-});
-var KbRuleVersionApprovedEvent = defineEvent({
-  meta: {
-    key: "kb.ruleVersion.approved",
-    version: "1.0.0",
-    description: "Rule version approved (human verified).",
-    stability: "experimental",
-    owners: ["@examples"],
-    tags: ["knowledge"]
-  },
-  payload: KbRuleVersionApprovedPayload
-});
-var 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
-    }
-  }
-});
-var KbSnapshotPublishedEvent = defineEvent({
-  meta: {
-    key: "kb.snapshot.published",
-    version: "1.0.0",
-    description: "KB snapshot published.",
-    stability: "experimental",
-    owners: ["@examples"],
-    tags: ["knowledge"]
-  },
-  payload: KbSnapshotPublishedPayload
-});
-export {
-  KbSourceIngestedEvent,
-  KbSnapshotPublishedEvent,
-  KbRuleVersionCreatedEvent,
-  KbRuleVersionApprovedEvent
-};
+import{defineEvent as k}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as q,ScalarTypeEnum as j}from"@contractspec/lib.schema";var w=q({name:"KbSourceIngestedPayload",description:"Emitted when a source document is ingested.",fields:{sourceDocumentId:{type:j.String_unsecure(),isOptional:!1},jurisdiction:{type:j.String_unsecure(),isOptional:!1},hash:{type:j.String_unsecure(),isOptional:!1}}}),G=k({meta:{key:"kb.source.ingested",version:"1.0.0",description:"Source document ingested (immutable).",stability:"experimental",owners:["@examples"],tags:["knowledge"]},payload:w}),x=q({name:"KbRuleVersionCreatedPayload",description:"Emitted when a rule version draft is created.",fields:{ruleVersionId:{type:j.String_unsecure(),isOptional:!1},ruleId:{type:j.String_unsecure(),isOptional:!1},jurisdiction:{type:j.String_unsecure(),isOptional:!1},status:{type:j.String_unsecure(),isOptional:!1}}}),H=k({meta:{key:"kb.ruleVersion.created",version:"1.0.0",description:"Rule version created (draft).",stability:"experimental",owners:["@examples"],tags:["knowledge"]},payload:x}),z=q({name:"KbRuleVersionApprovedPayload",description:"Emitted when a rule version is approved.",fields:{ruleVersionId:{type:j.String_unsecure(),isOptional:!1},approver:{type:j.String_unsecure(),isOptional:!1}}}),J=k({meta:{key:"kb.ruleVersion.approved",version:"1.0.0",description:"Rule version approved (human verified).",stability:"experimental",owners:["@examples"],tags:["knowledge"]},payload:z}),B=q({name:"KbSnapshotPublishedPayload",description:"Emitted when a KB snapshot is published.",fields:{snapshotId:{type:j.String_unsecure(),isOptional:!1},jurisdiction:{type:j.String_unsecure(),isOptional:!1},includedRuleVersionsCount:{type:j.Int_unsecure(),isOptional:!1}}}),L=k({meta:{key:"kb.snapshot.published",version:"1.0.0",description:"KB snapshot published.",stability:"experimental",owners:["@examples"],tags:["knowledge"]},payload:B});export{G as KbSourceIngestedEvent,L as KbSnapshotPublishedEvent,H as KbRuleVersionCreatedEvent,J as KbRuleVersionApprovedEvent};

package/dist/node/example.js

@@ -1,35 +1 @@
-// src/example.ts
-import { defineExample } from "@contractspec/lib.contracts-spec";
-var example = defineExample({
-  meta: {
-    key: "versioned-knowledge-base",
-    version: "1.0.0",
-    title: "Versioned Knowledge Base",
-    description: "Curated KB with immutable sources, reviewable rule versions, and published snapshots.",
-    kind: "knowledge",
-    visibility: "public",
-    stability: "experimental",
-    owners: ["@platform.core"],
-    tags: ["knowledge", "versioning", "snapshots"]
-  },
-  docs: {
-    rootDocId: "docs.examples.versioned-knowledge-base"
-  },
-  entrypoints: {
-    packageName: "@contractspec/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;
-export {
-  example_default as default
-};
+import{defineExample as g}from"@contractspec/lib.contracts-spec";var h=g({meta:{key:"versioned-knowledge-base",version:"1.0.0",title:"Versioned Knowledge Base",description:"Curated KB with immutable sources, reviewable rule versions, and published snapshots.",kind:"knowledge",visibility:"public",stability:"experimental",owners:["@platform.core"],tags:["knowledge","versioning","snapshots"]},docs:{rootDocId:"docs.examples.versioned-knowledge-base"},entrypoints:{packageName:"@contractspec/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}}}),q=h;export{q as default};

package/dist/node/handlers/index.js

@@ -1,115 +1 @@
-// src/handlers/memory.handlers.ts
-function createMemoryKbStore() {
-  return {
-    sources: new Map,
-    rules: new Map,
-    ruleVersions: new Map,
-    snapshots: new Map,
-    nextRuleVersionNumberByRuleId: 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;
-    const id = stableId("rv", `${input.ruleId}_${next}`);
-    const ruleVersion = {
-      id,
-      ruleId: input.ruleId,
-      jurisdiction: rule.jurisdiction,
-      topicKey: rule.topicKey,
-      version: next.toString(),
-      content: input.content,
-      sourceRefs: input.sourceRefs,
-      status: "draft",
-      createdAt: new Date,
-      approvedAt: undefined,
-      approvedBy: undefined
-    };
-    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: 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: 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 q = input.query.toLowerCase();
-    const tokens = q.split(/\s+/).map((t) => t.trim()).filter(Boolean);
-    const 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 { items };
-  }
-  return {
-    createRule,
-    ingestSource,
-    upsertRuleVersion,
-    approveRuleVersion,
-    publishSnapshot,
-    search
-  };
-}
-export {
-  createMemoryKbStore,
-  createMemoryKbHandlers
-};
+function m(){return{sources:new Map,rules:new Map,ruleVersions:new Map,snapshots:new Map,nextRuleVersionNumberByRuleId:new Map}}function c(s,u){return`${s}_${u.replace(/[^a-zA-Z0-9_-]/g,"_")}`}function h(s){async function u(e){return s.rules.set(e.id,e),e}async function a(e){let r=c("src",`${e.jurisdiction}_${e.hash}`),n={id:r,...e};return s.sources.set(r,n),n}async function d(e){if(!e.sourceRefs.length)throw Error("SOURCE_REFS_REQUIRED");let r=s.rules.get(e.ruleId);if(!r)throw Error("RULE_NOT_FOUND");let n=(s.nextRuleVersionNumberByRuleId.get(e.ruleId)??0)+1,i=c("rv",`${e.ruleId}_${n}`),o={id:i,ruleId:e.ruleId,jurisdiction:r.jurisdiction,topicKey:r.topicKey,version:n.toString(),content:e.content,sourceRefs:e.sourceRefs,status:"draft",createdAt:new Date,approvedAt:void 0,approvedBy:void 0};return s.ruleVersions.set(i,o),o}async function l(e){let r=s.ruleVersions.get(e.ruleVersionId);if(!r)throw Error("RULE_VERSION_NOT_FOUND");let n={...r,status:"approved",approvedBy:e.approver,approvedAt:new Date};return s.ruleVersions.set(n.id,n),n}async function p(e){let r=[...s.ruleVersions.values()].filter((t)=>t.status==="approved"&&t.jurisdiction===e.jurisdiction);if(r.length===0)throw Error("NO_APPROVED_RULES");let n=r.map((t)=>t.id).sort(),i=c("snap",`${e.jurisdiction}_${e.asOfDate.toISOString().slice(0,10)}_${n.length}`),o={id:i,jurisdiction:e.jurisdiction,asOfDate:e.asOfDate,includedRuleVersionIds:n,publishedAt:new Date};return s.snapshots.set(i,o),o}async function g(e){let r=s.snapshots.get(e.snapshotId);if(!r)throw Error("SNAPSHOT_NOT_FOUND");if(r.jurisdiction!==e.jurisdiction)throw Error("JURISDICTION_MISMATCH");let i=e.query.toLowerCase().split(/\s+/).map((t)=>t.trim()).filter(Boolean);return{items:r.includedRuleVersionIds.map((t)=>s.ruleVersions.get(t)).filter((t)=>Boolean(t)).filter((t)=>{if(i.length===0)return!0;let f=t.content.toLowerCase();return i.every((R)=>f.includes(R))}).map((t)=>({ruleVersionId:t.id,excerpt:t.content.slice(0,120)}))}}return{createRule:u,ingestSource:a,upsertRuleVersion:d,approveRuleVersion:l,publishSnapshot:p,search:g}}export{m as createMemoryKbStore,h as createMemoryKbHandlers};