@contractspec/example.kb-update-pipeline 1.57.0 → 1.58.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (88) hide show
  1. package/.turbo/turbo-build.log +58 -60
  2. package/.turbo/turbo-prebuild.log +1 -0
  3. package/CHANGELOG.md +13 -0
  4. package/dist/browser/docs/index.js +43 -0
  5. package/dist/browser/docs/kb-update-pipeline.docblock.js +43 -0
  6. package/dist/browser/entities/index.js +56 -0
  7. package/dist/browser/entities/models.js +56 -0
  8. package/dist/browser/events.js +132 -0
  9. package/dist/browser/example.js +35 -0
  10. package/dist/browser/handlers/index.js +109 -0
  11. package/dist/browser/handlers/memory.handlers.js +109 -0
  12. package/dist/browser/index.js +646 -0
  13. package/dist/browser/kb-update-pipeline.feature.js +61 -0
  14. package/dist/browser/operations/index.js +199 -0
  15. package/dist/browser/operations/pipeline.js +199 -0
  16. package/dist/browser/presentations.js +120 -0
  17. package/dist/browser/tests/operations.test-spec.js +85 -0
  18. package/dist/docs/index.d.ts +2 -1
  19. package/dist/docs/index.d.ts.map +1 -0
  20. package/dist/docs/index.js +44 -1
  21. package/dist/docs/kb-update-pipeline.docblock.d.ts +2 -1
  22. package/dist/docs/kb-update-pipeline.docblock.d.ts.map +1 -0
  23. package/dist/docs/kb-update-pipeline.docblock.js +41 -28
  24. package/dist/entities/index.d.ts +2 -2
  25. package/dist/entities/index.d.ts.map +1 -0
  26. package/dist/entities/index.js +57 -3
  27. package/dist/entities/models.d.ts +53 -58
  28. package/dist/entities/models.d.ts.map +1 -1
  29. package/dist/entities/models.js +54 -71
  30. package/dist/events.d.ts +62 -68
  31. package/dist/events.d.ts.map +1 -1
  32. package/dist/events.js +122 -139
  33. package/dist/example.d.ts +2 -6
  34. package/dist/example.d.ts.map +1 -1
  35. package/dist/example.js +34 -47
  36. package/dist/handlers/index.d.ts +2 -2
  37. package/dist/handlers/index.d.ts.map +1 -0
  38. package/dist/handlers/index.js +110 -3
  39. package/dist/handlers/memory.handlers.d.ts +58 -60
  40. package/dist/handlers/memory.handlers.d.ts.map +1 -1
  41. package/dist/handlers/memory.handlers.js +104 -87
  42. package/dist/handlers/memory.handlers.test.d.ts +2 -0
  43. package/dist/handlers/memory.handlers.test.d.ts.map +1 -0
  44. package/dist/index.d.ts +14 -10
  45. package/dist/index.d.ts.map +1 -0
  46. package/dist/index.js +647 -12
  47. package/dist/kb-update-pipeline.feature.d.ts +1 -6
  48. package/dist/kb-update-pipeline.feature.d.ts.map +1 -1
  49. package/dist/kb-update-pipeline.feature.js +60 -140
  50. package/dist/node/docs/index.js +43 -0
  51. package/dist/node/docs/kb-update-pipeline.docblock.js +43 -0
  52. package/dist/node/entities/index.js +56 -0
  53. package/dist/node/entities/models.js +56 -0
  54. package/dist/node/events.js +132 -0
  55. package/dist/node/example.js +35 -0
  56. package/dist/node/handlers/index.js +109 -0
  57. package/dist/node/handlers/memory.handlers.js +109 -0
  58. package/dist/node/index.js +646 -0
  59. package/dist/node/kb-update-pipeline.feature.js +61 -0
  60. package/dist/node/operations/index.js +199 -0
  61. package/dist/node/operations/pipeline.js +199 -0
  62. package/dist/node/presentations.js +120 -0
  63. package/dist/node/tests/operations.test-spec.js +85 -0
  64. package/dist/operations/index.d.ts +2 -2
  65. package/dist/operations/index.d.ts.map +1 -0
  66. package/dist/operations/index.js +199 -2
  67. package/dist/operations/pipeline.d.ts +126 -132
  68. package/dist/operations/pipeline.d.ts.map +1 -1
  69. package/dist/operations/pipeline.js +189 -172
  70. package/dist/presentations.d.ts +3 -8
  71. package/dist/presentations.d.ts.map +1 -1
  72. package/dist/presentations.js +117 -67
  73. package/dist/tests/operations.test-spec.d.ts +3 -8
  74. package/dist/tests/operations.test-spec.d.ts.map +1 -1
  75. package/dist/tests/operations.test-spec.js +82 -90
  76. package/package.json +157 -41
  77. package/tsdown.config.js +1 -2
  78. package/.turbo/turbo-build$colon$bundle.log +0 -60
  79. package/dist/docs/kb-update-pipeline.docblock.js.map +0 -1
  80. package/dist/entities/models.js.map +0 -1
  81. package/dist/events.js.map +0 -1
  82. package/dist/example.js.map +0 -1
  83. package/dist/handlers/memory.handlers.js.map +0 -1
  84. package/dist/kb-update-pipeline.feature.js.map +0 -1
  85. package/dist/operations/pipeline.js.map +0 -1
  86. package/dist/presentations.js.map +0 -1
  87. package/dist/tests/operations.test-spec.js.map +0 -1
  88. package/tsconfig.tsbuildinfo +0 -1
@@ -0,0 +1,646 @@
1
+ // src/docs/kb-update-pipeline.docblock.ts
2
+ import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
3
+ var docBlocks = [
4
+ {
5
+ id: "docs.examples.kb-update-pipeline.goal",
6
+ title: "KB Update Pipeline — Goal",
7
+ summary: "Automation proposes KB patches; humans verify; publishing is blocked until approvals are complete.",
8
+ kind: "goal",
9
+ visibility: "public",
10
+ route: "/docs/examples/kb-update-pipeline/goal",
11
+ tags: ["knowledge", "pipeline", "hitl", "audit"],
12
+ body: `## Why it matters
13
+ - Keeps humans as the verifiers (HITL) while automation does the busywork.
14
+ - Produces an auditable chain: source change -> diff -> proposal -> review -> publish.
15
+
16
+ ## Guardrails
17
+ - High-risk changes require expert approval.
18
+ - Publishing fails if any included rule versions are not approved.
19
+ - Review requests emit notifications/events.`
20
+ },
21
+ {
22
+ id: "docs.examples.kb-update-pipeline.reference",
23
+ title: "KB Update Pipeline — Reference",
24
+ summary: "Entities, contracts, and events for the KB update pipeline example.",
25
+ kind: "reference",
26
+ visibility: "public",
27
+ route: "/docs/examples/kb-update-pipeline",
28
+ tags: ["knowledge", "reference"],
29
+ body: `## Contracts
30
+ - kbPipeline.runWatch
31
+ - kbPipeline.createReviewTask
32
+ - kbPipeline.submitDecision
33
+ - kbPipeline.publishIfReady
34
+
35
+ ## Events
36
+ - kb.change.detected
37
+ - kb.change.summarized
38
+ - kb.patch.proposed
39
+ - kb.review.requested
40
+ - kb.review.decided`
41
+ }
42
+ ];
43
+ registerDocBlocks(docBlocks);
44
+ // src/entities/models.ts
45
+ import {
46
+ ScalarTypeEnum,
47
+ defineEnum,
48
+ defineSchemaModel
49
+ } from "@contractspec/lib.schema";
50
+ var ChangeRiskLevelEnum = defineEnum("ChangeRiskLevel", [
51
+ "low",
52
+ "medium",
53
+ "high"
54
+ ]);
55
+ var ReviewAssignedRoleEnum = defineEnum("ReviewAssignedRole", [
56
+ "curator",
57
+ "expert"
58
+ ]);
59
+ var ReviewDecisionEnum = defineEnum("ReviewDecision", [
60
+ "approve",
61
+ "reject"
62
+ ]);
63
+ var ChangeCandidateModel = defineSchemaModel({
64
+ name: "ChangeCandidate",
65
+ description: "Candidate change detected in a source document.",
66
+ fields: {
67
+ id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
68
+ sourceDocumentId: {
69
+ type: ScalarTypeEnum.String_unsecure(),
70
+ isOptional: false
71
+ },
72
+ detectedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
73
+ diffSummary: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
74
+ riskLevel: { type: ChangeRiskLevelEnum, isOptional: false }
75
+ }
76
+ });
77
+ var ReviewTaskModel = defineSchemaModel({
78
+ name: "ReviewTask",
79
+ description: "Human verification task for a change candidate.",
80
+ fields: {
81
+ id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
82
+ changeCandidateId: {
83
+ type: ScalarTypeEnum.String_unsecure(),
84
+ isOptional: false
85
+ },
86
+ status: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
87
+ assignedRole: { type: ReviewAssignedRoleEnum, isOptional: false },
88
+ decision: { type: ReviewDecisionEnum, isOptional: true },
89
+ decidedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
90
+ decidedBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
91
+ }
92
+ });
93
+ // src/events.ts
94
+ import {
95
+ defineEvent,
96
+ defineSchemaModel as defineSchemaModel2,
97
+ StabilityEnum
98
+ } from "@contractspec/lib.contracts";
99
+ import { ScalarTypeEnum as ScalarTypeEnum2 } from "@contractspec/lib.schema";
100
+ var KbChangeDetectedPayload = defineSchemaModel2({
101
+ name: "KbChangeDetectedPayload",
102
+ description: "Emitted when a source change is detected.",
103
+ fields: {
104
+ changeCandidateId: {
105
+ type: ScalarTypeEnum2.String_unsecure(),
106
+ isOptional: false
107
+ },
108
+ sourceDocumentId: {
109
+ type: ScalarTypeEnum2.String_unsecure(),
110
+ isOptional: false
111
+ },
112
+ riskLevel: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false }
113
+ }
114
+ });
115
+ var KbChangeDetectedEvent = defineEvent({
116
+ meta: {
117
+ key: "kb.change.detected",
118
+ version: "1.0.0",
119
+ description: "KB source change detected.",
120
+ stability: StabilityEnum.Experimental,
121
+ owners: [],
122
+ tags: []
123
+ },
124
+ payload: KbChangeDetectedPayload
125
+ });
126
+ var KbChangeSummarizedPayload = defineSchemaModel2({
127
+ name: "KbChangeSummarizedPayload",
128
+ description: "Emitted when a change summary is produced.",
129
+ fields: {
130
+ changeCandidateId: {
131
+ type: ScalarTypeEnum2.String_unsecure(),
132
+ isOptional: false
133
+ },
134
+ summary: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
135
+ riskLevel: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false }
136
+ }
137
+ });
138
+ var KbChangeSummarizedEvent = defineEvent({
139
+ meta: {
140
+ key: "kb.change.summarized",
141
+ version: "1.0.0",
142
+ description: "KB change summarized.",
143
+ stability: StabilityEnum.Experimental,
144
+ owners: [],
145
+ tags: []
146
+ },
147
+ payload: KbChangeSummarizedPayload
148
+ });
149
+ var KbPatchProposedPayload = defineSchemaModel2({
150
+ name: "KbPatchProposedPayload",
151
+ description: "Emitted when draft rule patches are proposed.",
152
+ fields: {
153
+ changeCandidateId: {
154
+ type: ScalarTypeEnum2.String_unsecure(),
155
+ isOptional: false
156
+ },
157
+ proposedRuleVersionIds: {
158
+ type: ScalarTypeEnum2.String_unsecure(),
159
+ isArray: true,
160
+ isOptional: false
161
+ }
162
+ }
163
+ });
164
+ var KbPatchProposedEvent = defineEvent({
165
+ meta: {
166
+ key: "kb.patch.proposed",
167
+ version: "1.0.0",
168
+ description: "KB rule patch proposed (draft versions created).",
169
+ stability: StabilityEnum.Experimental,
170
+ owners: [],
171
+ tags: []
172
+ },
173
+ payload: KbPatchProposedPayload
174
+ });
175
+ var KbReviewRequestedPayload = defineSchemaModel2({
176
+ name: "KbReviewRequestedPayload",
177
+ description: "Emitted when a review is requested.",
178
+ fields: {
179
+ reviewTaskId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
180
+ changeCandidateId: {
181
+ type: ScalarTypeEnum2.String_unsecure(),
182
+ isOptional: false
183
+ },
184
+ assignedRole: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false }
185
+ }
186
+ });
187
+ var KbReviewRequestedEvent = defineEvent({
188
+ meta: {
189
+ key: "kb.review.requested",
190
+ version: "1.0.0",
191
+ description: "KB review requested.",
192
+ stability: StabilityEnum.Experimental,
193
+ owners: [],
194
+ tags: []
195
+ },
196
+ payload: KbReviewRequestedPayload
197
+ });
198
+ var KbReviewDecidedPayload = defineSchemaModel2({
199
+ name: "KbReviewDecidedPayload",
200
+ description: "Emitted when a review task is decided.",
201
+ fields: {
202
+ reviewTaskId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
203
+ decision: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
204
+ decidedBy: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false }
205
+ }
206
+ });
207
+ var KbReviewDecidedEvent = defineEvent({
208
+ meta: {
209
+ key: "kb.review.decided",
210
+ version: "1.0.0",
211
+ description: "KB review decided.",
212
+ stability: StabilityEnum.Experimental,
213
+ owners: [],
214
+ tags: []
215
+ },
216
+ payload: KbReviewDecidedPayload
217
+ });
218
+
219
+ // src/example.ts
220
+ import { defineExample } from "@contractspec/lib.contracts";
221
+ var example = defineExample({
222
+ meta: {
223
+ key: "kb-update-pipeline",
224
+ version: "1.0.0",
225
+ title: "KB Update Pipeline",
226
+ description: "Automation proposes KB updates; humans verify; everything audited and notified.",
227
+ kind: "knowledge",
228
+ visibility: "public",
229
+ stability: "experimental",
230
+ owners: ["@platform.core"],
231
+ tags: ["knowledge", "pipeline", "hitl", "audit"]
232
+ },
233
+ docs: {
234
+ rootDocId: "docs.examples.kb-update-pipeline"
235
+ },
236
+ entrypoints: {
237
+ packageName: "@contractspec/example.kb-update-pipeline",
238
+ feature: "./feature",
239
+ contracts: "./contracts",
240
+ handlers: "./handlers",
241
+ docs: "./docs"
242
+ },
243
+ surfaces: {
244
+ templates: true,
245
+ sandbox: { enabled: true, modes: ["markdown", "specs", "builder"] },
246
+ studio: { enabled: true, installable: true },
247
+ mcp: { enabled: true }
248
+ }
249
+ });
250
+ var example_default = example;
251
+
252
+ // src/handlers/memory.handlers.ts
253
+ function createPipelineMemoryStore() {
254
+ return {
255
+ candidates: new Map,
256
+ reviewTasks: new Map,
257
+ proposedRuleVersionIdsByCandidate: new Map,
258
+ approvedRuleVersionIds: new Set,
259
+ notifications: []
260
+ };
261
+ }
262
+ function stableId(prefix, value) {
263
+ return `${prefix}_${value.replace(/[^a-zA-Z0-9_-]/g, "_")}`;
264
+ }
265
+ function createPipelineMemoryHandlers(store) {
266
+ async function runWatch(input) {
267
+ const candidates = [...store.candidates.values()].filter((c) => c.sourceDocumentId.startsWith(`${input.jurisdiction}_`) || true);
268
+ return { candidates };
269
+ }
270
+ async function createReviewTask(input) {
271
+ const candidate = store.candidates.get(input.changeCandidateId);
272
+ if (!candidate)
273
+ throw new Error("CHANGE_CANDIDATE_NOT_FOUND");
274
+ const assignedRole = candidate.riskLevel === "high" ? "expert" : "curator";
275
+ const id = stableId("review", input.changeCandidateId);
276
+ const task = {
277
+ id,
278
+ changeCandidateId: input.changeCandidateId,
279
+ status: "open",
280
+ assignedRole,
281
+ decision: undefined,
282
+ decidedAt: undefined,
283
+ decidedBy: undefined
284
+ };
285
+ store.reviewTasks.set(id, task);
286
+ store.notifications.push({
287
+ kind: "kb.review.requested",
288
+ reviewTaskId: id,
289
+ changeCandidateId: input.changeCandidateId,
290
+ assignedRole,
291
+ createdAt: new Date
292
+ });
293
+ return task;
294
+ }
295
+ async function proposeRulePatch(input) {
296
+ if (!store.candidates.has(input.changeCandidateId)) {
297
+ throw new Error("CHANGE_CANDIDATE_NOT_FOUND");
298
+ }
299
+ store.proposedRuleVersionIdsByCandidate.set(input.changeCandidateId, [
300
+ ...input.proposedRuleVersionIds
301
+ ]);
302
+ return { proposedRuleVersionIds: [...input.proposedRuleVersionIds] };
303
+ }
304
+ async function markRuleVersionApproved(input) {
305
+ store.approvedRuleVersionIds.add(input.ruleVersionId);
306
+ return { ruleVersionId: input.ruleVersionId };
307
+ }
308
+ async function submitDecision(input) {
309
+ const task = store.reviewTasks.get(input.reviewTaskId);
310
+ if (!task)
311
+ throw new Error("REVIEW_TASK_NOT_FOUND");
312
+ const candidate = store.candidates.get(task.changeCandidateId);
313
+ if (!candidate)
314
+ throw new Error("CHANGE_CANDIDATE_NOT_FOUND");
315
+ if (candidate.riskLevel === "high" && input.decision === "approve") {
316
+ if (input.decidedByRole !== "expert")
317
+ throw new Error("FORBIDDEN_ROLE");
318
+ }
319
+ const decided = {
320
+ ...task,
321
+ status: "decided",
322
+ decision: input.decision,
323
+ decidedAt: new Date,
324
+ decidedBy: input.decidedBy
325
+ };
326
+ store.reviewTasks.set(decided.id, decided);
327
+ return decided;
328
+ }
329
+ async function publishIfReady(_input) {
330
+ const openTasks = [...store.reviewTasks.values()].filter((t) => t.status !== "decided");
331
+ if (openTasks.length) {
332
+ throw new Error("NOT_READY");
333
+ }
334
+ const rejected = [...store.reviewTasks.values()].some((t) => t.decision === "reject");
335
+ if (rejected)
336
+ return { published: false, reason: "REJECTED" };
337
+ for (const task of store.reviewTasks.values()) {
338
+ if (task.decision !== "approve")
339
+ continue;
340
+ const proposed = store.proposedRuleVersionIdsByCandidate.get(task.changeCandidateId) ?? [];
341
+ const unapproved = proposed.filter((id) => !store.approvedRuleVersionIds.has(id));
342
+ if (unapproved.length) {
343
+ throw new Error("NOT_READY");
344
+ }
345
+ }
346
+ return { published: true };
347
+ }
348
+ return {
349
+ runWatch,
350
+ createReviewTask,
351
+ proposeRulePatch,
352
+ markRuleVersionApproved,
353
+ submitDecision,
354
+ publishIfReady
355
+ };
356
+ }
357
+ // src/operations/pipeline.ts
358
+ import { defineCommand } from "@contractspec/lib.contracts";
359
+ import { ScalarTypeEnum as ScalarTypeEnum3, defineSchemaModel as defineSchemaModel3 } from "@contractspec/lib.schema";
360
+ var RunWatchInput = defineSchemaModel3({
361
+ name: "KbPipelineRunWatchInput",
362
+ description: "Trigger a watch cycle for KB sources (demo).",
363
+ fields: {
364
+ jurisdiction: { type: ScalarTypeEnum3.String_unsecure(), isOptional: false }
365
+ }
366
+ });
367
+ var RunWatchOutput = defineSchemaModel3({
368
+ name: "KbPipelineRunWatchOutput",
369
+ description: "Output containing detected changes.",
370
+ fields: {
371
+ candidates: {
372
+ type: ChangeCandidateModel,
373
+ isArray: true,
374
+ isOptional: false
375
+ }
376
+ }
377
+ });
378
+ var CreateReviewTaskInput = defineSchemaModel3({
379
+ name: "KbPipelineCreateReviewTaskInput",
380
+ description: "Create a review task for a change candidate.",
381
+ fields: {
382
+ changeCandidateId: {
383
+ type: ScalarTypeEnum3.String_unsecure(),
384
+ isOptional: false
385
+ }
386
+ }
387
+ });
388
+ var SubmitDecisionInput = defineSchemaModel3({
389
+ name: "KbPipelineSubmitDecisionInput",
390
+ description: "Submit a decision for a review task.",
391
+ fields: {
392
+ reviewTaskId: { type: ScalarTypeEnum3.String_unsecure(), isOptional: false },
393
+ decision: { type: ReviewDecisionEnum, isOptional: false },
394
+ decidedBy: { type: ScalarTypeEnum3.String_unsecure(), isOptional: false },
395
+ decidedByRole: {
396
+ type: ScalarTypeEnum3.String_unsecure(),
397
+ isOptional: false
398
+ }
399
+ }
400
+ });
401
+ var PublishIfReadyInput = defineSchemaModel3({
402
+ name: "KbPipelinePublishIfReadyInput",
403
+ description: "Publish snapshot if approvals are satisfied for a jurisdiction.",
404
+ fields: {
405
+ jurisdiction: { type: ScalarTypeEnum3.String_unsecure(), isOptional: false }
406
+ }
407
+ });
408
+ var PublishIfReadyOutput = defineSchemaModel3({
409
+ name: "KbPipelinePublishIfReadyOutput",
410
+ description: "Output for publish-if-ready operation.",
411
+ fields: {
412
+ published: { type: ScalarTypeEnum3.Boolean(), isOptional: false },
413
+ reason: { type: ScalarTypeEnum3.String_unsecure(), isOptional: true }
414
+ }
415
+ });
416
+ var KbPipelineRunWatchContract = defineCommand({
417
+ meta: {
418
+ key: "kbPipeline.runWatch",
419
+ version: "1.0.0",
420
+ stability: "experimental",
421
+ owners: ["@examples"],
422
+ tags: ["knowledge", "pipeline", "jobs"],
423
+ description: "Detect source changes and create change candidates.",
424
+ goal: "Automate discovery of updates needing review.",
425
+ context: "Scheduled job or manual trigger in demos."
426
+ },
427
+ io: { input: RunWatchInput, output: RunWatchOutput },
428
+ policy: { auth: "user" }
429
+ });
430
+ var KbPipelineCreateReviewTaskContract = defineCommand({
431
+ meta: {
432
+ key: "kbPipeline.createReviewTask",
433
+ version: "1.0.0",
434
+ stability: "experimental",
435
+ owners: ["@examples"],
436
+ tags: ["knowledge", "pipeline", "hitl"],
437
+ description: "Create a review task for a detected change.",
438
+ goal: "Route work to human verifiers.",
439
+ context: "Called after change detection or manual selection."
440
+ },
441
+ io: { input: CreateReviewTaskInput, output: ReviewTaskModel },
442
+ policy: { auth: "user" }
443
+ });
444
+ var KbPipelineSubmitDecisionContract = defineCommand({
445
+ meta: {
446
+ key: "kbPipeline.submitDecision",
447
+ version: "1.0.0",
448
+ stability: "experimental",
449
+ owners: ["@examples"],
450
+ tags: ["knowledge", "pipeline", "hitl", "rbac"],
451
+ description: "Submit approve/reject decision for a review task.",
452
+ goal: "Ensure humans verify before publishing.",
453
+ context: "Curator/expert reviews and decides."
454
+ },
455
+ io: {
456
+ input: SubmitDecisionInput,
457
+ output: ReviewTaskModel,
458
+ errors: {
459
+ FORBIDDEN_ROLE: {
460
+ description: "Role not allowed to approve the given risk level",
461
+ http: 403,
462
+ gqlCode: "FORBIDDEN_ROLE",
463
+ when: "curator attempts to approve a high-risk change"
464
+ },
465
+ REVIEW_TASK_NOT_FOUND: {
466
+ description: "Review task not found",
467
+ http: 404,
468
+ gqlCode: "REVIEW_TASK_NOT_FOUND",
469
+ when: "reviewTaskId is invalid"
470
+ }
471
+ }
472
+ },
473
+ policy: { auth: "user" }
474
+ });
475
+ var KbPipelinePublishIfReadyContract = defineCommand({
476
+ meta: {
477
+ key: "kbPipeline.publishIfReady",
478
+ version: "1.0.0",
479
+ stability: "experimental",
480
+ owners: ["@examples"],
481
+ tags: ["knowledge", "pipeline", "publishing"],
482
+ description: "Publish snapshot if ready (all approvals satisfied).",
483
+ goal: "Prevent publishing until all required approvals exist.",
484
+ context: "Called by job or UI to attempt publish."
485
+ },
486
+ io: {
487
+ input: PublishIfReadyInput,
488
+ output: PublishIfReadyOutput,
489
+ errors: {
490
+ NOT_READY: {
491
+ description: "Publishing is blocked because approvals are incomplete",
492
+ http: 409,
493
+ gqlCode: "NOT_READY",
494
+ when: "there are open review tasks or unapproved rule versions"
495
+ }
496
+ }
497
+ },
498
+ policy: { auth: "user" }
499
+ });
500
+ // src/kb-update-pipeline.feature.ts
501
+ import { defineFeature } from "@contractspec/lib.contracts";
502
+ var KbUpdatePipelineFeature = defineFeature({
503
+ meta: {
504
+ key: "kb-update-pipeline",
505
+ version: "1.0.0",
506
+ title: "KB Update Pipeline (HITL)",
507
+ description: "Automation proposes KB patches; humans verify; publishing is blocked until approvals are complete.",
508
+ domain: "knowledge",
509
+ owners: ["@examples"],
510
+ tags: ["knowledge", "pipeline", "hitl", "audit", "notifications"],
511
+ stability: "experimental"
512
+ },
513
+ operations: [
514
+ { key: "kbPipeline.runWatch", version: "1.0.0" },
515
+ { key: "kbPipeline.createReviewTask", version: "1.0.0" },
516
+ { key: "kbPipeline.submitDecision", version: "1.0.0" },
517
+ { key: "kbPipeline.publishIfReady", version: "1.0.0" }
518
+ ],
519
+ events: [
520
+ { key: "kb.change.detected", version: "1.0.0" },
521
+ { key: "kb.change.summarized", version: "1.0.0" },
522
+ { key: "kb.patch.proposed", version: "1.0.0" },
523
+ { key: "kb.review.requested", version: "1.0.0" },
524
+ { key: "kb.review.decided", version: "1.0.0" }
525
+ ],
526
+ presentations: [
527
+ { key: "kb.dashboard", version: "1.0.0" },
528
+ { key: "kb.review.list", version: "1.0.0" },
529
+ { key: "kb.review.form", version: "1.0.0" }
530
+ ],
531
+ opToPresentation: [
532
+ {
533
+ op: { key: "kbPipeline.runWatch", version: "1.0.0" },
534
+ pres: { key: "kb.dashboard", version: "1.0.0" }
535
+ },
536
+ {
537
+ op: { key: "kbPipeline.createReviewTask", version: "1.0.0" },
538
+ pres: { key: "kb.review.list", version: "1.0.0" }
539
+ },
540
+ {
541
+ op: { key: "kbPipeline.submitDecision", version: "1.0.0" },
542
+ pres: { key: "kb.review.form", version: "1.0.0" }
543
+ }
544
+ ],
545
+ presentationsTargets: [
546
+ { key: "kb.dashboard", version: "1.0.0", targets: ["react", "markdown"] },
547
+ { key: "kb.review.list", version: "1.0.0", targets: ["react", "markdown"] },
548
+ { key: "kb.review.form", version: "1.0.0", targets: ["react"] }
549
+ ],
550
+ capabilities: {
551
+ requires: [
552
+ { key: "identity", version: "1.0.0" },
553
+ { key: "notifications", version: "1.0.0" },
554
+ { key: "audit-trail", version: "1.0.0" }
555
+ ]
556
+ }
557
+ });
558
+
559
+ // src/presentations.ts
560
+ import { definePresentation, StabilityEnum as StabilityEnum2 } from "@contractspec/lib.contracts";
561
+ var KbDashboardPresentation = definePresentation({
562
+ meta: {
563
+ key: "kb.dashboard",
564
+ version: "1.0.0",
565
+ title: "KB Update Dashboard",
566
+ description: "Overview of KB change candidates and review tasks.",
567
+ domain: "knowledge",
568
+ owners: ["@examples"],
569
+ tags: ["dashboard", "knowledge"],
570
+ stability: StabilityEnum2.Experimental,
571
+ goal: "Visualize status",
572
+ context: "Dashboard"
573
+ },
574
+ source: {
575
+ type: "component",
576
+ framework: "react",
577
+ componentKey: "KbDashboard",
578
+ props: ChangeCandidateModel
579
+ },
580
+ targets: ["react", "markdown"]
581
+ });
582
+ var KbReviewListPresentation = definePresentation({
583
+ meta: {
584
+ key: "kb.review.list",
585
+ version: "1.0.0",
586
+ title: "Review Tasks",
587
+ description: "List of pending review tasks for the current user.",
588
+ domain: "knowledge",
589
+ owners: ["@examples"],
590
+ tags: ["list", "review"],
591
+ stability: StabilityEnum2.Experimental,
592
+ goal: "List tasks",
593
+ context: "Inbox"
594
+ },
595
+ source: {
596
+ type: "component",
597
+ framework: "react",
598
+ componentKey: "ReviewTaskList",
599
+ props: ReviewTaskModel
600
+ },
601
+ targets: ["react", "markdown"]
602
+ });
603
+ var KbReviewFormPresentation = definePresentation({
604
+ meta: {
605
+ key: "kb.review.form",
606
+ version: "1.0.0",
607
+ title: "Review Change",
608
+ description: "Form to approve or reject a KB change candidate.",
609
+ domain: "knowledge",
610
+ owners: ["@examples"],
611
+ tags: ["form", "review"],
612
+ stability: StabilityEnum2.Experimental,
613
+ goal: "Review",
614
+ context: "Detail"
615
+ },
616
+ source: {
617
+ type: "component",
618
+ framework: "react",
619
+ componentKey: "ReviewDecisionForm",
620
+ props: ReviewTaskModel
621
+ },
622
+ targets: ["react"]
623
+ });
624
+ export {
625
+ example_default as example,
626
+ createPipelineMemoryStore,
627
+ createPipelineMemoryHandlers,
628
+ ReviewTaskModel,
629
+ ReviewDecisionEnum,
630
+ ReviewAssignedRoleEnum,
631
+ KbUpdatePipelineFeature,
632
+ KbReviewRequestedEvent,
633
+ KbReviewListPresentation,
634
+ KbReviewFormPresentation,
635
+ KbReviewDecidedEvent,
636
+ KbPipelineSubmitDecisionContract,
637
+ KbPipelineRunWatchContract,
638
+ KbPipelinePublishIfReadyContract,
639
+ KbPipelineCreateReviewTaskContract,
640
+ KbPatchProposedEvent,
641
+ KbDashboardPresentation,
642
+ KbChangeSummarizedEvent,
643
+ KbChangeDetectedEvent,
644
+ ChangeRiskLevelEnum,
645
+ ChangeCandidateModel
646
+ };
@@ -0,0 +1,61 @@
1
+ // src/kb-update-pipeline.feature.ts
2
+ import { defineFeature } from "@contractspec/lib.contracts";
3
+ var KbUpdatePipelineFeature = defineFeature({
4
+ meta: {
5
+ key: "kb-update-pipeline",
6
+ version: "1.0.0",
7
+ title: "KB Update Pipeline (HITL)",
8
+ description: "Automation proposes KB patches; humans verify; publishing is blocked until approvals are complete.",
9
+ domain: "knowledge",
10
+ owners: ["@examples"],
11
+ tags: ["knowledge", "pipeline", "hitl", "audit", "notifications"],
12
+ stability: "experimental"
13
+ },
14
+ operations: [
15
+ { key: "kbPipeline.runWatch", version: "1.0.0" },
16
+ { key: "kbPipeline.createReviewTask", version: "1.0.0" },
17
+ { key: "kbPipeline.submitDecision", version: "1.0.0" },
18
+ { key: "kbPipeline.publishIfReady", version: "1.0.0" }
19
+ ],
20
+ events: [
21
+ { key: "kb.change.detected", version: "1.0.0" },
22
+ { key: "kb.change.summarized", version: "1.0.0" },
23
+ { key: "kb.patch.proposed", version: "1.0.0" },
24
+ { key: "kb.review.requested", version: "1.0.0" },
25
+ { key: "kb.review.decided", version: "1.0.0" }
26
+ ],
27
+ presentations: [
28
+ { key: "kb.dashboard", version: "1.0.0" },
29
+ { key: "kb.review.list", version: "1.0.0" },
30
+ { key: "kb.review.form", version: "1.0.0" }
31
+ ],
32
+ opToPresentation: [
33
+ {
34
+ op: { key: "kbPipeline.runWatch", version: "1.0.0" },
35
+ pres: { key: "kb.dashboard", version: "1.0.0" }
36
+ },
37
+ {
38
+ op: { key: "kbPipeline.createReviewTask", version: "1.0.0" },
39
+ pres: { key: "kb.review.list", version: "1.0.0" }
40
+ },
41
+ {
42
+ op: { key: "kbPipeline.submitDecision", version: "1.0.0" },
43
+ pres: { key: "kb.review.form", version: "1.0.0" }
44
+ }
45
+ ],
46
+ presentationsTargets: [
47
+ { key: "kb.dashboard", version: "1.0.0", targets: ["react", "markdown"] },
48
+ { key: "kb.review.list", version: "1.0.0", targets: ["react", "markdown"] },
49
+ { key: "kb.review.form", version: "1.0.0", targets: ["react"] }
50
+ ],
51
+ capabilities: {
52
+ requires: [
53
+ { key: "identity", version: "1.0.0" },
54
+ { key: "notifications", version: "1.0.0" },
55
+ { key: "audit-trail", version: "1.0.0" }
56
+ ]
57
+ }
58
+ });
59
+ export {
60
+ KbUpdatePipelineFeature
61
+ };