@contractspec/example.versioned-knowledge-base 1.44.0 → 1.45.0

package/src/events.ts

@@ -17,7 +17,7 @@ const KbSourceIngestedPayload = defineSchemaModel({
 export const KbSourceIngestedEvent = defineEvent({
   meta: {
     key: 'kb.source.ingested',
-    version: 1,
+    version: '1.0.0',
     description: 'Source document ingested (immutable).',
     stability: 'experimental',
     owners: ['@examples'],
@@ -43,7 +43,7 @@ const KbRuleVersionCreatedPayload = defineSchemaModel({
 export const KbRuleVersionCreatedEvent = defineEvent({
   meta: {
     key: 'kb.ruleVersion.created',
-    version: 1,
+    version: '1.0.0',
     description: 'Rule version created (draft).',
     stability: 'experimental',
     owners: ['@examples'],
@@ -67,7 +67,7 @@ const KbRuleVersionApprovedPayload = defineSchemaModel({
 export const KbRuleVersionApprovedEvent = defineEvent({
   meta: {
     key: 'kb.ruleVersion.approved',
-    version: 1,
+    version: '1.0.0',
     description: 'Rule version approved (human verified).',
     stability: 'experimental',
     owners: ['@examples'],
@@ -92,7 +92,7 @@ const KbSnapshotPublishedPayload = defineSchemaModel({
 export const KbSnapshotPublishedEvent = defineEvent({
   meta: {
     key: 'kb.snapshot.published',
-    version: 1,
+    version: '1.0.0',
     description: 'KB snapshot published.',
     stability: 'experimental',
     owners: ['@examples'],

package/src/example.ts

@@ -1,11 +1,18 @@
-const example = {
-  id: 'versioned-knowledge-base',
-  title: 'Versioned Knowledge Base',
-  summary:
-    'Curated KB with immutable sources, reviewable rule versions, and published snapshots.',
-  tags: ['knowledge', 'versioning', 'snapshots'],
-  kind: 'knowledge',
-  visibility: 'public',
+import type { ExampleSpec } from '@contractspec/lib.contracts';
+
+const example: ExampleSpec = {
+  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',
   },
@@ -22,6 +29,6 @@ const example = {
     studio: { enabled: true, installable: true },
     mcp: { enabled: true },
   },
-} as const;
+};
 
 export default example;

package/src/handlers/memory.handlers.ts

@@ -21,7 +21,7 @@ interface RuleVersion {
   ruleId: string;
   jurisdiction: string;
   topicKey: string;
-  version: number;
+  version: string;
   content: string;
   sourceRefs: SourceRef[];
   status: 'draft' | 'approved' | 'rejected';
@@ -111,14 +111,13 @@ export function createMemoryKbHandlers(store: MemoryKbStore): MemoryKbHandlers {
     }
     const next =
       (store.nextRuleVersionNumberByRuleId.get(input.ruleId) ?? 0) + 1;
-    store.nextRuleVersionNumberByRuleId.set(input.ruleId, next);
     const id = stableId('rv', `${input.ruleId}_${next}`);
     const ruleVersion: RuleVersion = {
       id,
       ruleId: input.ruleId,
       jurisdiction: rule.jurisdiction,
       topicKey: rule.topicKey,
-      version: next,
+      version: next.toString(),
       content: input.content,
       sourceRefs: input.sourceRefs,
       status: 'draft',

package/src/operations/kb.ts

@@ -86,7 +86,7 @@ export const KbIngestSourceContract = defineCommand({
   meta: {
     key: 'kb.ingestSource',
     title: 'Ingest Source',
-    version: 1,
+    version: '1.0.0',
     stability: 'experimental',
     owners: ['@examples'],
     tags: ['knowledge', 'sources', 'ingestion'],
@@ -105,7 +105,7 @@ export const KbUpsertRuleVersionContract = defineCommand({
   meta: {
     key: 'kb.upsertRuleVersion',
     title: 'Upsert Rule Version',
-    version: 1,
+    version: '1.0.0',
     stability: 'experimental',
     owners: ['@examples'],
     tags: ['knowledge', 'rules', 'versioning'],
@@ -138,7 +138,7 @@ export const KbApproveRuleVersionContract = defineCommand({
   meta: {
     key: 'kb.approveRuleVersion',
     title: 'Approve Rule Version',
-    version: 1,
+    version: '1.0.0',
     stability: 'experimental',
     owners: ['@examples'],
     tags: ['knowledge', 'rules', 'approval'],
@@ -157,7 +157,7 @@ export const KbPublishSnapshotContract = defineCommand({
   meta: {
     key: 'kb.publishSnapshot',
     title: 'Publish Snapshot',
-    version: 1,
+    version: '1.0.0',
     stability: 'experimental',
     owners: ['@examples'],
     tags: ['knowledge', 'snapshots', 'publishing'],
@@ -185,7 +185,7 @@ export const KbSearchContract = defineQuery({
   meta: {
     key: 'kb.search',
     title: 'Search KB',
-    version: 1,
+    version: '1.0.0',
     stability: 'experimental',
     owners: ['@examples'],
     tags: ['knowledge', 'search', 'snapshots'],

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

@@ -3,7 +3,7 @@ import type { FeatureModuleSpec } from '@contractspec/lib.contracts';
 export const VersionedKnowledgeBaseFeature: FeatureModuleSpec = {
   meta: {
     key: 'versioned-knowledge-base',
-    version: 1,
+    version: '1.0.0',
     title: 'Versioned Knowledge Base',
     description:
       'Curated KB with immutable sources, rule versions, and published snapshots.',
@@ -13,22 +13,22 @@ export const VersionedKnowledgeBaseFeature: FeatureModuleSpec = {
     stability: 'experimental',
   },
   operations: [
-    { 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 },
+    { 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 },
-    { key: 'kb.ruleVersion.created', version: 1 },
-    { key: 'kb.ruleVersion.approved', version: 1 },
-    { key: 'kb.snapshot.published', version: 1 },
+    { 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 }],
+    requires: [{ key: 'knowledge', version: '1.0.0' }],
   },
 };