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

package/dist/operations/index.js

@@ -1,258 +1,2 @@
 // @bun
-// 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/operations/kb.js

@@ -1,258 +1,2 @@
 // @bun
-// 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/versioned-knowledge-base.feature.js

@@ -1,42 +1,2 @@
 // @bun
-// 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};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/example.versioned-knowledge-base",
-  "version": "3.7.16",
+  "version": "3.7.18",
   "description": "Example: curated, versioned knowledge base with immutable sources, rule versions, and published snapshots.",
   "type": "module",
   "types": "./dist/index.d.ts",
@@ -106,20 +106,20 @@
     "dev": "contractspec-bun-build dev",
     "clean": "rimraf dist .turbo",
     "lint": "bun lint:fix",
-    "lint:fix": "biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .",
-    "lint:check": "biome check .",
+    "lint:fix": "node ../../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../../scripts/biome.cjs check --write .",
+    "lint:check": "node ../../../scripts/biome.cjs check .",
     "test": "bun test",
     "prebuild": "contractspec-bun-build prebuild",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@contractspec/lib.contracts-spec": "5.0.4",
-    "@contractspec/lib.schema": "3.7.13"
+    "@contractspec/lib.contracts-spec": "5.2.0",
+    "@contractspec/lib.schema": "3.7.14"
   },
   "devDependencies": {
-    "@contractspec/tool.typescript": "3.7.12",
+    "@contractspec/tool.typescript": "3.7.13",
     "typescript": "^5.9.3",
-    "@contractspec/tool.bun": "3.7.12"
+    "@contractspec/tool.bun": "3.7.14"
   },
   "publishConfig": {
     "access": "public",