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

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

@@ -1,50 +1,8 @@
-// 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/browser/operations/index.js

@@ -1,257 +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 }
-  }
-});
-
-// src/operations/kb.ts
-import { defineCommand, defineQuery } from "@contractspec/lib.contracts-spec";
-import { defineSchemaModel as defineSchemaModel2, ScalarTypeEnum as ScalarTypeEnum2 } from "@contractspec/lib.schema";
-var IngestSourceInput = defineSchemaModel2({
-  name: "KbIngestSourceInput",
-  description: "Ingest immutable source metadata referencing a stored file.",
-  fields: {
-    jurisdiction: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    authority: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    title: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    fetchedAt: { type: ScalarTypeEnum2.DateTime(), isOptional: false },
-    hash: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    fileId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false }
-  }
-});
-var UpsertRuleVersionInput = defineSchemaModel2({
-  name: "KbUpsertRuleVersionInput",
-  description: "Create a new draft rule version (immutable history).",
-  fields: {
-    ruleId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    content: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    sourceRefs: { type: SourceRefModel, isArray: true, isOptional: false }
-  }
-});
-var ApproveRuleVersionInput = defineSchemaModel2({
-  name: "KbApproveRuleVersionInput",
-  description: "Approve a rule version (human verification).",
-  fields: {
-    ruleVersionId: {
-      type: ScalarTypeEnum2.String_unsecure(),
-      isOptional: false
-    },
-    approver: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false }
-  }
-});
-var PublishSnapshotInput = defineSchemaModel2({
-  name: "KbPublishSnapshotInput",
-  description: "Publish a snapshot for a jurisdiction as-of a date.",
-  fields: {
-    jurisdiction: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    asOfDate: { type: ScalarTypeEnum2.DateTime(), isOptional: false }
-  }
-});
-var SearchKbInput = defineSchemaModel2({
-  name: "KbSearchInput",
-  description: "Search within a published snapshot.",
-  fields: {
-    snapshotId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    jurisdiction: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    query: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false }
-  }
-});
-var SearchKbResultItem = defineSchemaModel2({
-  name: "KbSearchResultItem",
-  description: "Search result referencing a specific rule version.",
-  fields: {
-    ruleVersionId: {
-      type: ScalarTypeEnum2.String_unsecure(),
-      isOptional: false
-    },
-    excerpt: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true }
-  }
-});
-var SearchKbOutput = defineSchemaModel2({
-  name: "KbSearchOutput",
-  description: "Search results constrained to snapshot + jurisdiction.",
-  fields: {
-    items: { type: SearchKbResultItem, isArray: true, isOptional: false }
-  }
-});
-var 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" }
-});
-var 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" }
-});
-var 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" }
-});
-var 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" }
-});
-var 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" }
-});
-export {
-  KbUpsertRuleVersionContract,
-  KbSearchContract,
-  KbPublishSnapshotContract,
-  KbIngestSourceContract,
-  KbApproveRuleVersionContract
-};
+import{defineSchemaModel as s,ScalarTypeEnum as t}from"@contractspec/lib.schema";var p=s({name:"SourceDocument",description:"Immutable raw source document metadata referencing a stored file.",fields:{id:{type:t.String_unsecure(),isOptional:!1},jurisdiction:{type:t.String_unsecure(),isOptional:!1},authority:{type:t.String_unsecure(),isOptional:!1},title:{type:t.String_unsecure(),isOptional:!1},fetchedAt:{type:t.DateTime(),isOptional:!1},hash:{type:t.String_unsecure(),isOptional:!1},fileId:{type:t.String_unsecure(),isOptional:!1}}}),n=s({name:"SourceRef",description:"Reference to a source document used to justify a rule version.",fields:{sourceDocumentId:{type:t.String_unsecure(),isOptional:!1},excerpt:{type:t.String_unsecure(),isOptional:!0}}}),D=s({name:"Rule",description:"Curated rule (stable identity) with topic + jurisdiction scope.",fields:{id:{type:t.String_unsecure(),isOptional:!1},jurisdiction:{type:t.String_unsecure(),isOptional:!1},topicKey:{type:t.String_unsecure(),isOptional:!1}}}),o=s({name:"RuleVersion",description:"A versioned rule content with source references and approval status.",fields:{id:{type:t.String_unsecure(),isOptional:!1},ruleId:{type:t.String_unsecure(),isOptional:!1},jurisdiction:{type:t.String_unsecure(),isOptional:!1},topicKey:{type:t.String_unsecure(),isOptional:!1},version:{type:t.String_unsecure(),isOptional:!1},content:{type:t.String_unsecure(),isOptional:!1},sourceRefs:{type:n,isArray:!0,isOptional:!1},status:{type:t.String_unsecure(),isOptional:!1},approvedBy:{type:t.String_unsecure(),isOptional:!0},approvedAt:{type:t.DateTime(),isOptional:!0},createdAt:{type:t.DateTime(),isOptional:!1}}}),u=s({name:"KBSnapshot",description:"Published KB snapshot (as-of) referencing approved rule versions.",fields:{id:{type:t.String_unsecure(),isOptional:!1},jurisdiction:{type:t.String_unsecure(),isOptional:!1},asOfDate:{type:t.DateTime(),isOptional:!1},includedRuleVersionIds:{type:t.String_unsecure(),isArray:!0,isOptional:!1},publishedAt:{type:t.DateTime(),isOptional:!1}}});import{defineCommand as r,defineQuery as l}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as i,ScalarTypeEnum as e}from"@contractspec/lib.schema";var a=i({name:"KbIngestSourceInput",description:"Ingest immutable source metadata referencing a stored file.",fields:{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}}}),f=i({name:"KbUpsertRuleVersionInput",description:"Create a new draft rule version (immutable history).",fields:{ruleId:{type:e.String_unsecure(),isOptional:!1},content:{type:e.String_unsecure(),isOptional:!1},sourceRefs:{type:n,isArray:!0,isOptional:!1}}}),O=i({name:"KbApproveRuleVersionInput",description:"Approve a rule version (human verification).",fields:{ruleVersionId:{type:e.String_unsecure(),isOptional:!1},approver:{type:e.String_unsecure(),isOptional:!1}}}),c=i({name:"KbPublishSnapshotInput",description:"Publish a snapshot for a jurisdiction as-of a date.",fields:{jurisdiction:{type:e.String_unsecure(),isOptional:!1},asOfDate:{type:e.DateTime(),isOptional:!1}}}),g=i({name:"KbSearchInput",description:"Search within a published snapshot.",fields:{snapshotId:{type:e.String_unsecure(),isOptional:!1},jurisdiction:{type:e.String_unsecure(),isOptional:!1},query:{type:e.String_unsecure(),isOptional:!1}}}),_=i({name:"KbSearchResultItem",description:"Search result referencing a specific rule version.",fields:{ruleVersionId:{type:e.String_unsecure(),isOptional:!1},excerpt:{type:e.String_unsecure(),isOptional:!0}}}),d=i({name:"KbSearchOutput",description:"Search results constrained to snapshot + jurisdiction.",fields:{items:{type:_,isArray:!0,isOptional:!1}}}),w=r({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:a,output:p},policy:{auth:"user"}}),B=r({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:f,output:o,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"}}),R=r({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:O,output:o},policy:{auth:"user"}}),K=r({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:c,output:u,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"}}),k=l({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:g,output:d},policy:{auth:"user"}});export{B as KbUpsertRuleVersionContract,k as KbSearchContract,K as KbPublishSnapshotContract,w as KbIngestSourceContract,R as KbApproveRuleVersionContract};

package/dist/browser/operations/kb.js

@@ -1,257 +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 }
-  }
-});
-
-// src/operations/kb.ts
-import { defineCommand, defineQuery } from "@contractspec/lib.contracts-spec";
-import { defineSchemaModel as defineSchemaModel2, ScalarTypeEnum as ScalarTypeEnum2 } from "@contractspec/lib.schema";
-var IngestSourceInput = defineSchemaModel2({
-  name: "KbIngestSourceInput",
-  description: "Ingest immutable source metadata referencing a stored file.",
-  fields: {
-    jurisdiction: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    authority: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    title: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    fetchedAt: { type: ScalarTypeEnum2.DateTime(), isOptional: false },
-    hash: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    fileId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false }
-  }
-});
-var UpsertRuleVersionInput = defineSchemaModel2({
-  name: "KbUpsertRuleVersionInput",
-  description: "Create a new draft rule version (immutable history).",
-  fields: {
-    ruleId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    content: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    sourceRefs: { type: SourceRefModel, isArray: true, isOptional: false }
-  }
-});
-var ApproveRuleVersionInput = defineSchemaModel2({
-  name: "KbApproveRuleVersionInput",
-  description: "Approve a rule version (human verification).",
-  fields: {
-    ruleVersionId: {
-      type: ScalarTypeEnum2.String_unsecure(),
-      isOptional: false
-    },
-    approver: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false }
-  }
-});
-var PublishSnapshotInput = defineSchemaModel2({
-  name: "KbPublishSnapshotInput",
-  description: "Publish a snapshot for a jurisdiction as-of a date.",
-  fields: {
-    jurisdiction: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    asOfDate: { type: ScalarTypeEnum2.DateTime(), isOptional: false }
-  }
-});
-var SearchKbInput = defineSchemaModel2({
-  name: "KbSearchInput",
-  description: "Search within a published snapshot.",
-  fields: {
-    snapshotId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    jurisdiction: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    query: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false }
-  }
-});
-var SearchKbResultItem = defineSchemaModel2({
-  name: "KbSearchResultItem",
-  description: "Search result referencing a specific rule version.",
-  fields: {
-    ruleVersionId: {
-      type: ScalarTypeEnum2.String_unsecure(),
-      isOptional: false
-    },
-    excerpt: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true }
-  }
-});
-var SearchKbOutput = defineSchemaModel2({
-  name: "KbSearchOutput",
-  description: "Search results constrained to snapshot + jurisdiction.",
-  fields: {
-    items: { type: SearchKbResultItem, isArray: true, isOptional: false }
-  }
-});
-var 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" }
-});
-var 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" }
-});
-var 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" }
-});
-var 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" }
-});
-var 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" }
-});
-export {
-  KbUpsertRuleVersionContract,
-  KbSearchContract,
-  KbPublishSnapshotContract,
-  KbIngestSourceContract,
-  KbApproveRuleVersionContract
-};
+import{defineSchemaModel as s,ScalarTypeEnum as t}from"@contractspec/lib.schema";var p=s({name:"SourceDocument",description:"Immutable raw source document metadata referencing a stored file.",fields:{id:{type:t.String_unsecure(),isOptional:!1},jurisdiction:{type:t.String_unsecure(),isOptional:!1},authority:{type:t.String_unsecure(),isOptional:!1},title:{type:t.String_unsecure(),isOptional:!1},fetchedAt:{type:t.DateTime(),isOptional:!1},hash:{type:t.String_unsecure(),isOptional:!1},fileId:{type:t.String_unsecure(),isOptional:!1}}}),n=s({name:"SourceRef",description:"Reference to a source document used to justify a rule version.",fields:{sourceDocumentId:{type:t.String_unsecure(),isOptional:!1},excerpt:{type:t.String_unsecure(),isOptional:!0}}}),D=s({name:"Rule",description:"Curated rule (stable identity) with topic + jurisdiction scope.",fields:{id:{type:t.String_unsecure(),isOptional:!1},jurisdiction:{type:t.String_unsecure(),isOptional:!1},topicKey:{type:t.String_unsecure(),isOptional:!1}}}),o=s({name:"RuleVersion",description:"A versioned rule content with source references and approval status.",fields:{id:{type:t.String_unsecure(),isOptional:!1},ruleId:{type:t.String_unsecure(),isOptional:!1},jurisdiction:{type:t.String_unsecure(),isOptional:!1},topicKey:{type:t.String_unsecure(),isOptional:!1},version:{type:t.String_unsecure(),isOptional:!1},content:{type:t.String_unsecure(),isOptional:!1},sourceRefs:{type:n,isArray:!0,isOptional:!1},status:{type:t.String_unsecure(),isOptional:!1},approvedBy:{type:t.String_unsecure(),isOptional:!0},approvedAt:{type:t.DateTime(),isOptional:!0},createdAt:{type:t.DateTime(),isOptional:!1}}}),u=s({name:"KBSnapshot",description:"Published KB snapshot (as-of) referencing approved rule versions.",fields:{id:{type:t.String_unsecure(),isOptional:!1},jurisdiction:{type:t.String_unsecure(),isOptional:!1},asOfDate:{type:t.DateTime(),isOptional:!1},includedRuleVersionIds:{type:t.String_unsecure(),isArray:!0,isOptional:!1},publishedAt:{type:t.DateTime(),isOptional:!1}}});import{defineCommand as r,defineQuery as l}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as i,ScalarTypeEnum as e}from"@contractspec/lib.schema";var a=i({name:"KbIngestSourceInput",description:"Ingest immutable source metadata referencing a stored file.",fields:{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}}}),f=i({name:"KbUpsertRuleVersionInput",description:"Create a new draft rule version (immutable history).",fields:{ruleId:{type:e.String_unsecure(),isOptional:!1},content:{type:e.String_unsecure(),isOptional:!1},sourceRefs:{type:n,isArray:!0,isOptional:!1}}}),O=i({name:"KbApproveRuleVersionInput",description:"Approve a rule version (human verification).",fields:{ruleVersionId:{type:e.String_unsecure(),isOptional:!1},approver:{type:e.String_unsecure(),isOptional:!1}}}),c=i({name:"KbPublishSnapshotInput",description:"Publish a snapshot for a jurisdiction as-of a date.",fields:{jurisdiction:{type:e.String_unsecure(),isOptional:!1},asOfDate:{type:e.DateTime(),isOptional:!1}}}),g=i({name:"KbSearchInput",description:"Search within a published snapshot.",fields:{snapshotId:{type:e.String_unsecure(),isOptional:!1},jurisdiction:{type:e.String_unsecure(),isOptional:!1},query:{type:e.String_unsecure(),isOptional:!1}}}),_=i({name:"KbSearchResultItem",description:"Search result referencing a specific rule version.",fields:{ruleVersionId:{type:e.String_unsecure(),isOptional:!1},excerpt:{type:e.String_unsecure(),isOptional:!0}}}),d=i({name:"KbSearchOutput",description:"Search results constrained to snapshot + jurisdiction.",fields:{items:{type:_,isArray:!0,isOptional:!1}}}),w=r({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:a,output:p},policy:{auth:"user"}}),B=r({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:f,output:o,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"}}),R=r({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:O,output:o},policy:{auth:"user"}}),K=r({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:c,output:u,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"}}),k=l({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:g,output:d},policy:{auth:"user"}});export{B as KbUpsertRuleVersionContract,k as KbSearchContract,K as KbPublishSnapshotContract,w as KbIngestSourceContract,R as KbApproveRuleVersionContract};

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

@@ -1,41 +1 @@
-// src/versioned-knowledge-base.feature.ts
-import { defineFeature } from "@contractspec/lib.contracts-spec";
-var 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" }]
-  },
-  knowledge: [{ key: "kb.knowledge.rules", version: "1.0.0" }],
-  docs: [
-    "docs.examples.versioned-knowledge-base.goal",
-    "docs.examples.versioned-knowledge-base.reference"
-  ]
-});
-export {
-  VersionedKnowledgeBaseFeature
-};
+import{defineFeature as g}from"@contractspec/lib.contracts-spec";var j=g({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"}]},knowledge:[{key:"kb.knowledge.rules",version:"1.0.0"}],docs:["docs.examples.versioned-knowledge-base.goal","docs.examples.versioned-knowledge-base.reference"]});export{j as VersionedKnowledgeBaseFeature};