@vibe-engineer/artifacts 0.1.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 (16) hide show
  1. package/README.md +8 -0
  2. package/dist/chunk-XQLK7EDB.js +52 -0
  3. package/dist/index.js +389 -0
  4. package/dist/schema-registry.js +16 -0
  5. package/dist/types.d.ts +1396 -0
  6. package/package.json +61 -0
  7. package/schemas/agent-registry-entry.schema.json +845 -0
  8. package/schemas/build-result.schema.json +1100 -0
  9. package/schemas/context-file-header.schema.json +1056 -0
  10. package/schemas/evidence-packet.schema.json +687 -0
  11. package/schemas/implementation-plan.schema.json +1693 -0
  12. package/schemas/schematic-manifest.schema.json +810 -0
  13. package/schemas/ship-packet.schema.json +961 -0
  14. package/schemas/skill-manifest.schema.json +928 -0
  15. package/schemas/verification-delta.schema.json +676 -0
  16. package/schemas/work-brief.schema.json +644 -0
package/schemas/work-brief.schema.json ADDED
@@ -0,0 +1,644 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://schemas.vibe-engineer.dev/artifacts/v1/work-brief.schema.json",
4
+ "title": "WorkBriefV1",
5
+ "description": "Canonical DL-02 WorkBriefV1 artifact schema.",
6
+ "type": "object",
7
+ "additionalProperties": false,
8
+ "properties": {
9
+ "schemaVersion": {
10
+ "type": "string",
11
+ "minLength": 1,
12
+ "const": "1.0.0",
13
+ "pattern": "^\\d+\\.\\d+\\.\\d+$"
14
+ },
15
+ "artifactKind": {
16
+ "type": "string",
17
+ "minLength": 1,
18
+ "const": "work_brief",
19
+ "enum": [
20
+ "work_brief"
21
+ ]
22
+ },
23
+ "artifactId": {
24
+ "type": "string",
25
+ "minLength": 1,
26
+ "pattern": "^[a-z0-9][a-z0-9._:-]*$"
27
+ },
28
+ "title": {
29
+ "type": "string",
30
+ "minLength": 1
31
+ },
32
+ "createdAt": {
33
+ "type": "string",
34
+ "minLength": 1,
35
+ "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$|^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z$"
36
+ },
37
+ "updatedAt": {
38
+ "type": "string",
39
+ "minLength": 1,
40
+ "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$|^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z$"
41
+ },
42
+ "producer": {
43
+ "type": "object",
44
+ "additionalProperties": false,
45
+ "properties": {
46
+ "kind": {
47
+ "type": "string",
48
+ "minLength": 1,
49
+ "enum": [
50
+ "skill",
51
+ "agent",
52
+ "cli",
53
+ "schematic",
54
+ "verification_runner",
55
+ "human_operator",
56
+ "system"
57
+ ]
58
+ },
59
+ "id": {
60
+ "type": "string",
61
+ "minLength": 1,
62
+ "pattern": "^[a-z0-9][a-z0-9._:-]*$"
63
+ },
64
+ "name": {
65
+ "type": "string",
66
+ "minLength": 1
67
+ },
68
+ "version": {
69
+ "type": "string",
70
+ "minLength": 1,
71
+ "pattern": "^\\d+\\.\\d+\\.\\d+$"
72
+ },
73
+ "runId": {
74
+ "type": "string",
75
+ "minLength": 1,
76
+ "pattern": "^[a-z0-9][a-z0-9._:-]*$"
77
+ }
78
+ },
79
+ "required": [
80
+ "kind",
81
+ "id",
82
+ "name"
83
+ ]
84
+ },
85
+ "status": {
86
+ "type": "string",
87
+ "minLength": 1,
88
+ "enum": [
89
+ "draft",
90
+ "ready",
91
+ "blocked",
92
+ "superseded"
93
+ ]
94
+ },
95
+ "ownership": {
96
+ "type": "object",
97
+ "additionalProperties": false,
98
+ "properties": {
99
+ "ownerLane": {
100
+ "type": "string",
101
+ "minLength": 1
102
+ },
103
+ "ownedWritePaths": {
104
+ "type": "array",
105
+ "items": {
106
+ "type": "string",
107
+ "minLength": 1,
108
+ "pattern": "^.+$"
109
+ },
110
+ "minItems": 1
111
+ },
112
+ "readOnlyPaths": {
113
+ "type": "array",
114
+ "items": {
115
+ "type": "string",
116
+ "minLength": 1,
117
+ "pattern": "^.+$"
118
+ }
119
+ },
120
+ "untouchablePaths": {
121
+ "type": "array",
122
+ "items": {
123
+ "type": "string",
124
+ "minLength": 1,
125
+ "pattern": "^.+$"
126
+ }
127
+ },
128
+ "concurrencyNotes": {
129
+ "type": "string",
130
+ "minLength": 1
131
+ },
132
+ "handoffPolicy": {
133
+ "type": "string",
134
+ "minLength": 1
135
+ }
136
+ },
137
+ "required": [
138
+ "ownerLane",
139
+ "ownedWritePaths",
140
+ "readOnlyPaths",
141
+ "untouchablePaths",
142
+ "concurrencyNotes"
143
+ ]
144
+ },
145
+ "links": {
146
+ "type": "array",
147
+ "items": {
148
+ "type": "object",
149
+ "additionalProperties": false,
150
+ "properties": {
151
+ "rel": {
152
+ "type": "string",
153
+ "minLength": 1,
154
+ "enum": [
155
+ "raw_intent",
156
+ "derived_from",
157
+ "supersedes",
158
+ "superseded_by",
159
+ "implements",
160
+ "verifies",
161
+ "evidence_for",
162
+ "consumed_by",
163
+ "produced_by",
164
+ "context_for",
165
+ "registry_entry_for",
166
+ "manifest_for",
167
+ "verification_delta_of",
168
+ "build_result_of",
169
+ "ship_packet_of"
170
+ ]
171
+ },
172
+ "artifactKind": {
173
+ "type": "string",
174
+ "minLength": 1,
175
+ "enum": [
176
+ "work_brief",
177
+ "implementation_plan",
178
+ "verification_delta",
179
+ "build_result",
180
+ "ship_packet",
181
+ "evidence_packet",
182
+ "agent_registry_entry",
183
+ "context_file_header",
184
+ "schematic_manifest",
185
+ "skill_manifest"
186
+ ]
187
+ },
188
+ "artifactId": {
189
+ "type": "string",
190
+ "minLength": 1,
191
+ "pattern": "^[a-z0-9][a-z0-9._:-]*$"
192
+ },
193
+ "path": {
194
+ "type": "string",
195
+ "minLength": 1,
196
+ "pattern": "^.+$"
197
+ },
198
+ "required": {
199
+ "type": "boolean"
200
+ },
201
+ "statusAtLinkTime": {
202
+ "type": "string",
203
+ "minLength": 1
204
+ }
205
+ },
206
+ "required": [
207
+ "rel",
208
+ "artifactKind",
209
+ "artifactId",
210
+ "path",
211
+ "required",
212
+ "statusAtLinkTime"
213
+ ]
214
+ },
215
+ "minItems": 1
216
+ },
217
+ "extensions": {
218
+ "type": "object",
219
+ "propertyNames": {
220
+ "pattern": "^[a-z][a-z0-9]*(\\.[a-z0-9][a-z0-9-]*)+$|^@[a-z0-9][a-z0-9-]*/[a-z0-9][a-z0-9-]*$"
221
+ },
222
+ "additionalProperties": {
223
+ "type": "object",
224
+ "required": [
225
+ "schemaVersion"
226
+ ],
227
+ "properties": {
228
+ "schemaVersion": {
229
+ "type": "string",
230
+ "minLength": 1,
231
+ "pattern": "^\\d+\\.\\d+\\.\\d+$"
232
+ }
233
+ },
234
+ "additionalProperties": true
235
+ }
236
+ },
237
+ "description": {
238
+ "type": "string"
239
+ },
240
+ "tags": {
241
+ "type": "array",
242
+ "items": {
243
+ "type": "string",
244
+ "minLength": 1
245
+ }
246
+ },
247
+ "sourceRefs": {
248
+ "type": "array",
249
+ "items": {
250
+ "type": "object",
251
+ "additionalProperties": false,
252
+ "properties": {
253
+ "kind": {
254
+ "type": "string",
255
+ "minLength": 1,
256
+ "enum": [
257
+ "source_doc",
258
+ "prompt",
259
+ "issue",
260
+ "url",
261
+ "artifact",
262
+ "raw_intent"
263
+ ]
264
+ },
265
+ "ref": {
266
+ "type": "string",
267
+ "minLength": 1
268
+ }
269
+ },
270
+ "required": [
271
+ "kind",
272
+ "ref"
273
+ ]
274
+ }
275
+ },
276
+ "approvedBy": {
277
+ "type": "object",
278
+ "additionalProperties": false,
279
+ "properties": {
280
+ "producer": {
281
+ "type": "object",
282
+ "additionalProperties": false,
283
+ "properties": {
284
+ "kind": {
285
+ "type": "string",
286
+ "minLength": 1,
287
+ "enum": [
288
+ "skill",
289
+ "agent",
290
+ "cli",
291
+ "schematic",
292
+ "verification_runner",
293
+ "human_operator",
294
+ "system"
295
+ ]
296
+ },
297
+ "id": {
298
+ "type": "string",
299
+ "minLength": 1,
300
+ "pattern": "^[a-z0-9][a-z0-9._:-]*$"
301
+ },
302
+ "name": {
303
+ "type": "string",
304
+ "minLength": 1
305
+ },
306
+ "version": {
307
+ "type": "string",
308
+ "minLength": 1,
309
+ "pattern": "^\\d+\\.\\d+\\.\\d+$"
310
+ },
311
+ "runId": {
312
+ "type": "string",
313
+ "minLength": 1,
314
+ "pattern": "^[a-z0-9][a-z0-9._:-]*$"
315
+ }
316
+ },
317
+ "required": [
318
+ "kind",
319
+ "id",
320
+ "name"
321
+ ]
322
+ },
323
+ "approvedAt": {
324
+ "type": "string",
325
+ "minLength": 1,
326
+ "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$|^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z$"
327
+ }
328
+ },
329
+ "required": [
330
+ "producer",
331
+ "approvedAt"
332
+ ]
333
+ },
334
+ "supersessionReason": {
335
+ "type": "string"
336
+ },
337
+ "retention": {
338
+ "type": "object",
339
+ "additionalProperties": false,
340
+ "properties": {
341
+ "policy": {
342
+ "type": "string",
343
+ "minLength": 1
344
+ },
345
+ "reason": {
346
+ "type": "string",
347
+ "minLength": 1
348
+ }
349
+ },
350
+ "required": [
351
+ "policy",
352
+ "reason"
353
+ ]
354
+ },
355
+ "sourceSkill": {
356
+ "type": "string",
357
+ "minLength": 1,
358
+ "enum": [
359
+ "brainstorm",
360
+ "grill-me",
361
+ "task"
362
+ ]
363
+ },
364
+ "workType": {
365
+ "type": "string",
366
+ "minLength": 1,
367
+ "enum": [
368
+ "feature",
369
+ "bug",
370
+ "chore",
371
+ "refactor",
372
+ "research",
373
+ "decision"
374
+ ]
375
+ },
376
+ "background": {
377
+ "type": "string",
378
+ "minLength": 1
379
+ },
380
+ "problemOrOpportunity": {
381
+ "type": "string",
382
+ "minLength": 1
383
+ },
384
+ "desiredOutcome": {
385
+ "type": "string",
386
+ "minLength": 1
387
+ },
388
+ "constraints": {
389
+ "type": "array",
390
+ "items": {
391
+ "type": "string",
392
+ "minLength": 1
393
+ }
394
+ },
395
+ "userVisibleBehavior": {
396
+ "type": "array",
397
+ "items": {
398
+ "type": "string",
399
+ "minLength": 1
400
+ }
401
+ },
402
+ "nonGoals": {
403
+ "type": "array",
404
+ "items": {
405
+ "type": "string",
406
+ "minLength": 1
407
+ }
408
+ },
409
+ "risksAndUnknowns": {
410
+ "type": "array",
411
+ "items": {
412
+ "type": "string",
413
+ "minLength": 1
414
+ }
415
+ },
416
+ "acceptanceNotes": {
417
+ "type": "array",
418
+ "items": {
419
+ "type": "object",
420
+ "additionalProperties": false,
421
+ "properties": {
422
+ "id": {
423
+ "type": "string",
424
+ "minLength": 1,
425
+ "pattern": "^[a-z0-9][a-z0-9._:-]*$"
426
+ },
427
+ "description": {
428
+ "type": "string",
429
+ "minLength": 1
430
+ },
431
+ "candidateScenarioRefs": {
432
+ "type": "array",
433
+ "items": {
434
+ "type": "string",
435
+ "minLength": 1
436
+ }
437
+ }
438
+ },
439
+ "required": [
440
+ "id",
441
+ "description"
442
+ ]
443
+ },
444
+ "minItems": 1
445
+ },
446
+ "sourceMetadata": {
447
+ "type": "object",
448
+ "additionalProperties": false,
449
+ "properties": {
450
+ "rawIntentRefs": {
451
+ "type": "array",
452
+ "items": {
453
+ "type": "string",
454
+ "minLength": 1
455
+ },
456
+ "minItems": 1
457
+ },
458
+ "conversationRefs": {
459
+ "type": "array",
460
+ "items": {
461
+ "type": "string",
462
+ "minLength": 1
463
+ }
464
+ },
465
+ "operatorRefs": {
466
+ "type": "array",
467
+ "items": {
468
+ "type": "string",
469
+ "minLength": 1
470
+ }
471
+ },
472
+ "inputTimestamp": {
473
+ "type": "string",
474
+ "minLength": 1,
475
+ "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$|^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z$"
476
+ }
477
+ },
478
+ "required": [
479
+ "rawIntentRefs",
480
+ "conversationRefs",
481
+ "operatorRefs"
482
+ ]
483
+ },
484
+ "observedBehavior": {
485
+ "type": "string"
486
+ },
487
+ "expectedBehavior": {
488
+ "type": "string"
489
+ },
490
+ "reproductionSteps": {
491
+ "type": "array",
492
+ "items": {
493
+ "type": "string",
494
+ "minLength": 1
495
+ }
496
+ },
497
+ "logsOrErrors": {
498
+ "type": "array",
499
+ "items": {
500
+ "type": "string",
501
+ "minLength": 1
502
+ }
503
+ },
504
+ "affectedSurface": {
505
+ "type": "string"
506
+ },
507
+ "suspectedCause": {
508
+ "type": "string"
509
+ },
510
+ "urgency": {
511
+ "type": "string",
512
+ "minLength": 1,
513
+ "enum": [
514
+ "low",
515
+ "medium",
516
+ "high",
517
+ "urgent"
518
+ ]
519
+ },
520
+ "candidateE2ECases": {
521
+ "type": "array",
522
+ "items": {
523
+ "type": "string",
524
+ "minLength": 1
525
+ }
526
+ },
527
+ "candidateUIStates": {
528
+ "type": "array",
529
+ "items": {
530
+ "type": "string",
531
+ "minLength": 1
532
+ }
533
+ },
534
+ "openQuestions": {
535
+ "type": "array",
536
+ "items": {
537
+ "type": "string",
538
+ "minLength": 1
539
+ }
540
+ },
541
+ "assumptions": {
542
+ "type": "array",
543
+ "items": {
544
+ "type": "string",
545
+ "minLength": 1
546
+ }
547
+ },
548
+ "relatedArtifacts": {
549
+ "type": "array",
550
+ "items": {
551
+ "type": "object",
552
+ "additionalProperties": false,
553
+ "properties": {
554
+ "rel": {
555
+ "type": "string",
556
+ "minLength": 1,
557
+ "enum": [
558
+ "raw_intent",
559
+ "derived_from",
560
+ "supersedes",
561
+ "superseded_by",
562
+ "implements",
563
+ "verifies",
564
+ "evidence_for",
565
+ "consumed_by",
566
+ "produced_by",
567
+ "context_for",
568
+ "registry_entry_for",
569
+ "manifest_for",
570
+ "verification_delta_of",
571
+ "build_result_of",
572
+ "ship_packet_of"
573
+ ]
574
+ },
575
+ "artifactKind": {
576
+ "type": "string",
577
+ "minLength": 1,
578
+ "enum": [
579
+ "work_brief",
580
+ "implementation_plan",
581
+ "verification_delta",
582
+ "build_result",
583
+ "ship_packet",
584
+ "evidence_packet",
585
+ "agent_registry_entry",
586
+ "context_file_header",
587
+ "schematic_manifest",
588
+ "skill_manifest"
589
+ ]
590
+ },
591
+ "artifactId": {
592
+ "type": "string",
593
+ "minLength": 1,
594
+ "pattern": "^[a-z0-9][a-z0-9._:-]*$"
595
+ },
596
+ "path": {
597
+ "type": "string",
598
+ "minLength": 1,
599
+ "pattern": "^.+$"
600
+ },
601
+ "required": {
602
+ "type": "boolean"
603
+ },
604
+ "statusAtLinkTime": {
605
+ "type": "string",
606
+ "minLength": 1
607
+ }
608
+ },
609
+ "required": [
610
+ "rel",
611
+ "artifactKind",
612
+ "artifactId",
613
+ "path",
614
+ "required",
615
+ "statusAtLinkTime"
616
+ ]
617
+ }
618
+ }
619
+ },
620
+ "required": [
621
+ "schemaVersion",
622
+ "artifactKind",
623
+ "artifactId",
624
+ "title",
625
+ "createdAt",
626
+ "updatedAt",
627
+ "producer",
628
+ "status",
629
+ "ownership",
630
+ "links",
631
+ "extensions",
632
+ "sourceSkill",
633
+ "workType",
634
+ "background",
635
+ "problemOrOpportunity",
636
+ "desiredOutcome",
637
+ "constraints",
638
+ "userVisibleBehavior",
639
+ "nonGoals",
640
+ "risksAndUnknowns",
641
+ "acceptanceNotes",
642
+ "sourceMetadata"
643
+ ]
644
+ }