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

package/package.json

@@ -1,28 +1,30 @@
 {
   "name": "@lssm/example.versioned-knowledge-base",
-  "version": "1.41.0",
+  "version": "1.42.1",
   "description": "Example: curated, versioned knowledge base with immutable sources, rule versions, and published snapshots.",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts",
-    "./contracts": "./src/contracts/index.ts",
-    "./contracts/kb": "./src/contracts/kb.ts",
-    "./docs": "./src/docs/index.ts",
-    "./docs/versioned-knowledge-base.docblock": "./src/docs/versioned-knowledge-base.docblock.ts",
-    "./entities": "./src/entities/index.ts",
-    "./entities/models": "./src/entities/models.ts",
-    "./events": "./src/events.ts",
-    "./example": "./src/example.ts",
-    "./handlers": "./src/handlers/index.ts",
-    "./handlers/memory.handlers": "./src/handlers/memory.handlers.ts",
-    "./versioned-knowledge-base.feature": "./src/versioned-knowledge-base.feature.ts",
+    ".": "./dist/index.js",
+    "./docs": "./dist/docs/index.js",
+    "./docs/versioned-knowledge-base.docblock": "./dist/docs/versioned-knowledge-base.docblock.js",
+    "./entities": "./dist/entities/index.js",
+    "./entities/models": "./dist/entities/models.js",
+    "./events": "./dist/events.js",
+    "./example": "./dist/example.js",
+    "./handlers": "./dist/handlers/index.js",
+    "./handlers/memory.handlers": "./dist/handlers/memory.handlers.js",
+    "./operations": "./dist/operations/index.js",
+    "./operations/kb": "./dist/operations/kb.js",
+    "./versioned-knowledge-base.feature": "./dist/versioned-knowledge-base.feature.js",
     "./*": "./*"
   },
   "scripts": {
-    "build": "bun build:bundle && bun build:types",
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "build": "bun build:types && bun build:bundle",
     "build:bundle": "tsdown",
     "build:types": "tsc --noEmit",
     "dev": "bun build:bundle --watch",
@@ -33,14 +35,14 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@lssm/lib.contracts": "workspace:*",
-    "@lssm/lib.schema": "workspace:*",
+    "@lssm/lib.contracts": "1.42.1",
+    "@lssm/lib.schema": "1.42.1",
     "zod": "^4.1.13"
   },
   "devDependencies": {
-    "@lssm/tool.tsdown": "workspace:*",
-    "@lssm/tool.typescript": "workspace:*",
-    "tsdown": "^0.17.4",
+    "@lssm/tool.tsdown": "1.42.1",
+    "@lssm/tool.typescript": "1.42.1",
+    "tsdown": "^0.18.3",
     "typescript": "^5.9.3"
   },
   "publishConfig": {
@@ -59,6 +61,13 @@
       "./handlers/memory.handlers": "./dist/handlers/memory.handlers.js",
       "./versioned-knowledge-base.feature": "./dist/versioned-knowledge-base.feature.js",
       "./*": "./*"
-    }
+    },
+    "registry": "https://registry.npmjs.org/"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/examples/versioned-knowledge-base"
   }
 }

package/src/events.ts

@@ -15,9 +15,14 @@ const KbSourceIngestedPayload = defineSchemaModel({
 });
 
 export const KbSourceIngestedEvent = defineEvent({
-  name: 'kb.source.ingested',
-  version: 1,
-  description: 'Source document ingested (immutable).',
+  meta: {
+    key: 'kb.source.ingested',
+    version: 1,
+    description: 'Source document ingested (immutable).',
+    stability: 'experimental',
+    owners: ['@examples'],
+    tags: ['knowledge'],
+  },
   payload: KbSourceIngestedPayload,
 });
 
@@ -36,9 +41,14 @@ const KbRuleVersionCreatedPayload = defineSchemaModel({
 });
 
 export const KbRuleVersionCreatedEvent = defineEvent({
-  name: 'kb.ruleVersion.created',
-  version: 1,
-  description: 'Rule version created (draft).',
+  meta: {
+    key: 'kb.ruleVersion.created',
+    version: 1,
+    description: 'Rule version created (draft).',
+    stability: 'experimental',
+    owners: ['@examples'],
+    tags: ['knowledge'],
+  },
   payload: KbRuleVersionCreatedPayload,
 });
 
@@ -55,9 +65,14 @@ const KbRuleVersionApprovedPayload = defineSchemaModel({
 });
 
 export const KbRuleVersionApprovedEvent = defineEvent({
-  name: 'kb.ruleVersion.approved',
-  version: 1,
-  description: 'Rule version approved (human verified).',
+  meta: {
+    key: 'kb.ruleVersion.approved',
+    version: 1,
+    description: 'Rule version approved (human verified).',
+    stability: 'experimental',
+    owners: ['@examples'],
+    tags: ['knowledge'],
+  },
   payload: KbRuleVersionApprovedPayload,
 });
 
@@ -75,8 +90,13 @@ const KbSnapshotPublishedPayload = defineSchemaModel({
 });
 
 export const KbSnapshotPublishedEvent = defineEvent({
-  name: 'kb.snapshot.published',
-  version: 1,
-  description: 'KB snapshot published.',
+  meta: {
+    key: 'kb.snapshot.published',
+    version: 1,
+    description: 'KB snapshot published.',
+    stability: 'experimental',
+    owners: ['@examples'],
+    tags: ['knowledge'],
+  },
   payload: KbSnapshotPublishedPayload,
 });

package/src/index.ts

@@ -4,7 +4,7 @@
  * Curated KB with immutable sources, reviewable rule versions, and published snapshots.
  */
 export * from './entities';
-export * from './contracts';
+export * from './operations';
 export * from './events';
 export * from './handlers';
 export * from './versioned-knowledge-base.feature';

package/src/{contracts → operations}/kb.ts

@@ -84,7 +84,8 @@ const SearchKbOutput = defineSchemaModel({
 
 export const KbIngestSourceContract = defineCommand({
   meta: {
-    name: 'kb.ingestSource',
+    key: 'kb.ingestSource',
+    title: 'Ingest Source',
     version: 1,
     stability: 'experimental',
     owners: ['@examples'],
@@ -102,7 +103,8 @@ export const KbIngestSourceContract = defineCommand({
 
 export const KbUpsertRuleVersionContract = defineCommand({
   meta: {
-    name: 'kb.upsertRuleVersion',
+    key: 'kb.upsertRuleVersion',
+    title: 'Upsert Rule Version',
     version: 1,
     stability: 'experimental',
     owners: ['@examples'],
@@ -134,7 +136,8 @@ export const KbUpsertRuleVersionContract = defineCommand({
 
 export const KbApproveRuleVersionContract = defineCommand({
   meta: {
-    name: 'kb.approveRuleVersion',
+    key: 'kb.approveRuleVersion',
+    title: 'Approve Rule Version',
     version: 1,
     stability: 'experimental',
     owners: ['@examples'],
@@ -152,7 +155,8 @@ export const KbApproveRuleVersionContract = defineCommand({
 
 export const KbPublishSnapshotContract = defineCommand({
   meta: {
-    name: 'kb.publishSnapshot',
+    key: 'kb.publishSnapshot',
+    title: 'Publish Snapshot',
     version: 1,
     stability: 'experimental',
     owners: ['@examples'],
@@ -179,7 +183,8 @@ export const KbPublishSnapshotContract = defineCommand({
 
 export const KbSearchContract = defineQuery({
   meta: {
-    name: 'kb.search',
+    key: 'kb.search',
+    title: 'Search KB',
     version: 1,
     stability: 'experimental',
     owners: ['@examples'],

package/src/versioned-knowledge-base.feature.ts

@@ -3,6 +3,7 @@ import type { FeatureModuleSpec } from '@lssm/lib.contracts';
 export const VersionedKnowledgeBaseFeature: FeatureModuleSpec = {
   meta: {
     key: 'versioned-knowledge-base',
+    version: 1,
     title: 'Versioned Knowledge Base',
     description:
       'Curated KB with immutable sources, rule versions, and published snapshots.',
@@ -12,17 +13,17 @@ export const VersionedKnowledgeBaseFeature: FeatureModuleSpec = {
     stability: 'experimental',
   },
   operations: [
-    { name: 'kb.ingestSource', version: 1 },
-    { name: 'kb.upsertRuleVersion', version: 1 },
-    { name: 'kb.approveRuleVersion', version: 1 },
-    { name: 'kb.publishSnapshot', version: 1 },
-    { name: 'kb.search', version: 1 },
+    { key: 'kb.ingestSource', version: 1 },
+    { key: 'kb.upsertRuleVersion', version: 1 },
+    { key: 'kb.approveRuleVersion', version: 1 },
+    { key: 'kb.publishSnapshot', version: 1 },
+    { key: 'kb.search', version: 1 },
   ],
   events: [
-    { name: 'kb.source.ingested', version: 1 },
-    { name: 'kb.ruleVersion.created', version: 1 },
-    { name: 'kb.ruleVersion.approved', version: 1 },
-    { name: 'kb.snapshot.published', version: 1 },
+    { key: 'kb.source.ingested', version: 1 },
+    { key: 'kb.ruleVersion.created', version: 1 },
+    { key: 'kb.ruleVersion.approved', version: 1 },
+    { key: 'kb.snapshot.published', version: 1 },
   ],
   presentations: [],
   opToPresentation: [],

package/dist/contracts/index.js

@@ -1 +0,0 @@
-import{KbApproveRuleVersionContract as e,KbIngestSourceContract as t,KbPublishSnapshotContract as n,KbSearchContract as r,KbUpsertRuleVersionContract as i}from"./kb.js";export{e as KbApproveRuleVersionContract,t as KbIngestSourceContract,n as KbPublishSnapshotContract,r as KbSearchContract,i as KbUpsertRuleVersionContract};

package/dist/contracts/kb.js

@@ -1 +0,0 @@
-import{KBSnapshotModel as e,RuleVersionModel as t,SourceDocumentModel as n,SourceRefModel as r}from"../entities/models.js";import{defineCommand as i,defineQuery as a}from"@lssm/lib.contracts";import{ScalarTypeEnum as o,defineSchemaModel as s}from"@lssm/lib.schema";const c=s({name:`KbIngestSourceInput`,description:`Ingest immutable source metadata referencing a stored file.`,fields:{jurisdiction:{type:o.String_unsecure(),isOptional:!1},authority:{type:o.String_unsecure(),isOptional:!1},title:{type:o.String_unsecure(),isOptional:!1},fetchedAt:{type:o.DateTime(),isOptional:!1},hash:{type:o.String_unsecure(),isOptional:!1},fileId:{type:o.String_unsecure(),isOptional:!1}}}),l=s({name:`KbUpsertRuleVersionInput`,description:`Create a new draft rule version (immutable history).`,fields:{ruleId:{type:o.String_unsecure(),isOptional:!1},content:{type:o.String_unsecure(),isOptional:!1},sourceRefs:{type:r,isArray:!0,isOptional:!1}}}),u=s({name:`KbApproveRuleVersionInput`,description:`Approve a rule version (human verification).`,fields:{ruleVersionId:{type:o.String_unsecure(),isOptional:!1},approver:{type:o.String_unsecure(),isOptional:!1}}}),d=s({name:`KbPublishSnapshotInput`,description:`Publish a snapshot for a jurisdiction as-of a date.`,fields:{jurisdiction:{type:o.String_unsecure(),isOptional:!1},asOfDate:{type:o.DateTime(),isOptional:!1}}}),f=s({name:`KbSearchInput`,description:`Search within a published snapshot.`,fields:{snapshotId:{type:o.String_unsecure(),isOptional:!1},jurisdiction:{type:o.String_unsecure(),isOptional:!1},query:{type:o.String_unsecure(),isOptional:!1}}}),p=s({name:`KbSearchOutput`,description:`Search results constrained to snapshot + jurisdiction.`,fields:{items:{type:s({name:`KbSearchResultItem`,description:`Search result referencing a specific rule version.`,fields:{ruleVersionId:{type:o.String_unsecure(),isOptional:!1},excerpt:{type:o.String_unsecure(),isOptional:!0}}}),isArray:!0,isOptional:!1}}}),m=i({meta:{name:`kb.ingestSource`,version:1,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:c,output:n},policy:{auth:`user`}}),h=i({meta:{name:`kb.upsertRuleVersion`,version:1,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:l,output:t,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`}}),g=i({meta:{name:`kb.approveRuleVersion`,version:1,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:u,output:t},policy:{auth:`user`}}),_=i({meta:{name:`kb.publishSnapshot`,version:1,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:d,output:e,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`}}),v=a({meta:{name:`kb.search`,version:1,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:f,output:p},policy:{auth:`user`}});export{g as KbApproveRuleVersionContract,m as KbIngestSourceContract,_ as KbPublishSnapshotContract,v as KbSearchContract,h as KbUpsertRuleVersionContract};