@cassiomc1/forgeloop 2.2.0 → 2.3.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 (58) hide show
  1. package/CONTRIBUTING.md +22 -2
  2. package/DOCS_INDEX.md +4 -13
  3. package/ENG/sec-code-eng.md +1 -1
  4. package/ENG/test-code-eng.md +32 -1
  5. package/LOOP_SYSTEM_DESIGN.md +2 -3
  6. package/QUALITY_SCORECARD.md +0 -1
  7. package/README.md +10 -42
  8. package/THIRD_PARTY_NOTICES.md +0 -15
  9. package/completions/_forgeloop +3 -2
  10. package/completions/forgeloop.bash +4 -2
  11. package/completions/forgeloop.fish +12 -1
  12. package/docs/AGENT_PROTOCOL_SUMMARY.md +3 -2
  13. package/docs/ARTIFACT_REFERENCE.md +1 -0
  14. package/docs/CLI_REFERENCE.md +24 -1
  15. package/docs/CODE_ATTESTATION.md +9 -7
  16. package/docs/DOCUMENTATION_GUIDE.md +10 -28
  17. package/docs/PACKAGE_CONTENTS.md +0 -3
  18. package/docs/RELEASE_CHECKLIST.md +52 -19
  19. package/docs/REVISION_PROVIDERS.md +3 -6
  20. package/docs/TROUBLESHOOTING.md +3 -0
  21. package/docs/documentation-manifest.json +0 -13
  22. package/package.json +2 -6
  23. package/schemas/config.schema.json +1 -0
  24. package/scripts/CI_VALIDATORS.md +2 -2
  25. package/src/cli.js +5 -0
  26. package/src/commands/attestation-create.js +21 -1
  27. package/src/commands/complete.js +3 -0
  28. package/src/commands/evidence-publish.js +22 -0
  29. package/src/commands/sync-pull.js +72 -7
  30. package/src/commands/sync-push.js +4 -1
  31. package/src/core/audit.js +7 -0
  32. package/src/core/cli-command-definitions.js +19 -1
  33. package/src/core/command-executors.js +19 -5
  34. package/src/core/config.js +44 -37
  35. package/src/core/error-codes.js +18 -0
  36. package/src/core/evidence/auto-export.js +61 -0
  37. package/src/core/evidence/bundle-format.js +4 -2
  38. package/src/core/evidence/export.js +5 -0
  39. package/src/core/evidence/publish.js +187 -0
  40. package/src/core/integration-invocation-policy.js +1 -0
  41. package/src/core/sync/merge.js +135 -0
  42. package/docs/assets/diagrams/forgeloop-code-attestation-flow.html +0 -13852
  43. package/docs/assets/diagrams/forgeloop-code-attestation-flow.receipt.json +0 -37
  44. package/docs/assets/diagrams/forgeloop-code-attestation-flow.svg +0 -5055
  45. package/docs/assets/diagrams/forgeloop-engineering-flow.html +0 -13837
  46. package/docs/assets/diagrams/forgeloop-engineering-flow.receipt.json +0 -37
  47. package/docs/assets/diagrams/forgeloop-engineering-flow.svg +0 -5011
  48. package/docs/assets/diagrams/forgeloop-verification-trust-flow.html +0 -13795
  49. package/docs/assets/diagrams/forgeloop-verification-trust-flow.receipt.json +0 -37
  50. package/docs/assets/diagrams/forgeloop-verification-trust-flow.svg +0 -4997
  51. package/docs/diagrams/README.md +0 -103
  52. package/docs/diagrams/forgeloop-code-attestation-flow.workflow.json +0 -451
  53. package/docs/diagrams/forgeloop-engineering-flow.workflow.json +0 -459
  54. package/docs/diagrams/forgeloop-verification-trust-flow.workflow.json +0 -398
  55. package/docs/diagrams/manifest.json +0 -84
  56. package/docs/diagrams/reviews/forgeloop-code-attestation-flow.review.json +0 -20
  57. package/docs/diagrams/reviews/forgeloop-engineering-flow.review.json +0 -20
  58. package/docs/diagrams/reviews/forgeloop-verification-trust-flow.review.json +0 -20
@@ -1,459 +0,0 @@
1
- {
2
- "schema_version": 1,
3
- "diagram_type": "workflow",
4
- "meta": {
5
- "title": "ForgeLoop Evidence-First Engineering Flow",
6
- "subtitle": "Structured intent \u2192 deterministic project scope \u2192 observed evidence \u2192 valid closure",
7
- "animation": "trace",
8
- "visual_preset": "signal-flow",
9
- "quality_profile": "showcase",
10
- "views": [
11
- {
12
- "id": "contract-to-work",
13
- "label": "Contract to work",
14
- "focus": [
15
- "request",
16
- "profile",
17
- "contract",
18
- "route",
19
- "gates",
20
- "preflight",
21
- "work"
22
- ],
23
- "note": "Structured obligations and explicit risks set the profile; exclusions do not create required actions."
24
- },
25
- {
26
- "id": "evidence-to-close",
27
- "label": "Evidence to close",
28
- "focus": [
29
- "work",
30
- "evidence",
31
- "review",
32
- "valid"
33
- ],
34
- "note": "See the evidence and review boundary that makes completion trustworthy."
35
- },
36
- {
37
- "id": "recovery-loop",
38
- "label": "Recovery loop",
39
- "focus": [
40
- "evidence",
41
- "diagnose",
42
- "correct",
43
- "preflight",
44
- "blocked"
45
- ],
46
- "note": "Before execution, blocked refresh needs a valid ledger and revised route. Later failures use diagnosis and correction."
47
- }
48
- ],
49
- "legend": {
50
- "mode": "auto",
51
- "entries": {
52
- "frontend": {
53
- "label": "Human-facing surface"
54
- },
55
- "backend": {
56
- "label": "ForgeLoop state"
57
- },
58
- "database": {
59
- "label": "Durable evidence"
60
- },
61
- "cloud": {
62
- "label": "External boundary"
63
- },
64
- "security": {
65
- "label": "Policy or gate"
66
- },
67
- "messagebus": {
68
- "label": "Recovery signal"
69
- },
70
- "external": {
71
- "label": "Request or result"
72
- }
73
- }
74
- },
75
- "viewBox": [
76
- 850,
77
- 900
78
- ]
79
- },
80
- "lanes": [
81
- {
82
- "id": "intent",
83
- "label": "Intent + Context"
84
- },
85
- {
86
- "id": "policy",
87
- "label": "Policy Boundary"
88
- },
89
- {
90
- "id": "execution",
91
- "label": "Resumable Execution"
92
- },
93
- {
94
- "id": "evidence",
95
- "label": "Evidence Ledger"
96
- },
97
- {
98
- "id": "recovery",
99
- "label": "Recovery + Stops",
100
- "variant": "exception"
101
- },
102
- {
103
- "id": "closure",
104
- "label": "Review + Closure"
105
- }
106
- ],
107
- "phases": [
108
- {
109
- "id": "discover",
110
- "label": "Discover + scope",
111
- "fromCol": 0,
112
- "toCol": 2
113
- },
114
- {
115
- "id": "authorize",
116
- "label": "Route + authorize",
117
- "fromCol": 3,
118
- "toCol": 4,
119
- "variant": "emphasis"
120
- },
121
- {
122
- "id": "verify",
123
- "label": "Execute + verify",
124
- "fromCol": 5,
125
- "toCol": 5,
126
- "variant": "dashed"
127
- }
128
- ],
129
- "groups": [
130
- {
131
- "id": "contract_boundary",
132
- "label": "Contract boundary",
133
- "lane": "policy",
134
- "fromCol": 3,
135
- "toCol": 5,
136
- "variant": "emphasis"
137
- },
138
- {
139
- "id": "evidence_boundary",
140
- "label": "Evidence boundary",
141
- "lane": "evidence",
142
- "fromCol": 4,
143
- "toCol": 5,
144
- "variant": "dashed"
145
- },
146
- {
147
- "id": "recovery_path",
148
- "label": "Reconcile before retry",
149
- "lane": "recovery",
150
- "fromCol": 0,
151
- "toCol": 2,
152
- "variant": "security"
153
- }
154
- ],
155
- "mainPath": [
156
- "request",
157
- "profile",
158
- "contract",
159
- "route",
160
- "gates",
161
- "preflight",
162
- "work",
163
- "evidence",
164
- "review",
165
- "valid"
166
- ],
167
- "nodes": [
168
- {
169
- "id": "request",
170
- "lane": "intent",
171
- "col": 0,
172
- "type": "external",
173
- "label": "Request",
174
- "sublabel": "intent",
175
- "width": 50
176
- },
177
- {
178
- "id": "profile",
179
- "lane": "intent",
180
- "col": 1,
181
- "type": "backend",
182
- "label": "Profile",
183
- "sublabel": "scope",
184
- "width": 50
185
- },
186
- {
187
- "id": "contract",
188
- "lane": "intent",
189
- "col": 2,
190
- "type": "security",
191
- "label": "Contract",
192
- "sublabel": "scope",
193
- "tag": "saved",
194
- "width": 50
195
- },
196
- {
197
- "id": "route",
198
- "lane": "policy",
199
- "col": 2,
200
- "type": "security",
201
- "label": "Route",
202
- "sublabel": "guides",
203
- "tag": "fail closed",
204
- "width": 50
205
- },
206
- {
207
- "id": "gates",
208
- "lane": "policy",
209
- "col": 3,
210
- "type": "security",
211
- "label": "Gates",
212
- "sublabel": "claims + tasks",
213
- "width": 62
214
- },
215
- {
216
- "id": "preflight",
217
- "lane": "policy",
218
- "col": 4,
219
- "type": "security",
220
- "label": "READY",
221
- "sublabel": "binding",
222
- "tag": "Preflight",
223
- "width": 60
224
- },
225
- {
226
- "id": "work",
227
- "lane": "execution",
228
- "col": 4,
229
- "type": "backend",
230
- "label": "Execute",
231
- "sublabel": "run task",
232
- "width": 62
233
- },
234
- {
235
- "id": "evidence",
236
- "lane": "evidence",
237
- "col": 4,
238
- "type": "database",
239
- "label": "Evidence",
240
- "sublabel": "run-check",
241
- "tag": "observed",
242
- "width": 70
243
- },
244
- {
245
- "id": "review",
246
- "lane": "closure",
247
- "col": 4,
248
- "type": "backend",
249
- "label": "Review",
250
- "sublabel": "check drift",
251
- "width": 62
252
- },
253
- {
254
- "id": "valid",
255
- "lane": "closure",
256
- "col": 5,
257
- "type": "database",
258
- "label": "VALID",
259
- "sublabel": "completion",
260
- "tag": "verified",
261
- "width": 62
262
- },
263
- {
264
- "id": "diagnose",
265
- "lane": "recovery",
266
- "col": 2,
267
- "type": "messagebus",
268
- "label": "Diagnose",
269
- "sublabel": "failure",
270
- "width": 50
271
- },
272
- {
273
- "id": "correct",
274
- "lane": "recovery",
275
- "col": 1,
276
- "type": "backend",
277
- "label": "Correct",
278
- "sublabel": "repair",
279
- "width": 50
280
- },
281
- {
282
- "id": "blocked",
283
- "lane": "recovery",
284
- "col": 0,
285
- "type": "security",
286
- "label": "Blocked",
287
- "sublabel": "stop",
288
- "width": 50
289
- }
290
- ],
291
- "edges": [
292
- {
293
- "id": "request-profile",
294
- "from": "request",
295
- "to": "profile",
296
- "variant": "emphasis"
297
- },
298
- {
299
- "id": "profile-contract",
300
- "from": "profile",
301
- "to": "contract",
302
- "variant": "default"
303
- },
304
- {
305
- "id": "contract-route",
306
- "from": "contract",
307
- "to": "route",
308
- "variant": "emphasis",
309
- "fromSide": "bottom",
310
- "toSide": "top",
311
- "route": "drop"
312
- },
313
- {
314
- "id": "route-gates",
315
- "from": "route",
316
- "to": "gates",
317
- "variant": "emphasis"
318
- },
319
- {
320
- "id": "gates-preflight",
321
- "from": "gates",
322
- "to": "preflight",
323
- "variant": "security",
324
- "fromSide": "bottom",
325
- "toSide": "bottom",
326
- "route": "bottom-channel",
327
- "channelY": 312
328
- },
329
- {
330
- "id": "preflight-work",
331
- "from": "preflight",
332
- "to": "work",
333
- "variant": "emphasis",
334
- "fromSide": "bottom",
335
- "toSide": "top",
336
- "route": "drop"
337
- },
338
- {
339
- "id": "work-evidence",
340
- "from": "work",
341
- "to": "evidence",
342
- "variant": "dashed",
343
- "fromSide": "bottom",
344
- "toSide": "top",
345
- "route": "drop"
346
- },
347
- {
348
- "id": "evidence-review",
349
- "from": "evidence",
350
- "to": "review",
351
- "variant": "emphasis",
352
- "fromSide": "bottom",
353
- "toSide": "top",
354
- "route": "drop"
355
- },
356
- {
357
- "id": "review-valid",
358
- "from": "review",
359
- "to": "valid",
360
- "variant": "emphasis"
361
- },
362
- {
363
- "id": "evidence-diagnose",
364
- "from": "evidence",
365
- "to": "diagnose",
366
- "variant": "security",
367
- "role": "error",
368
- "fromSide": "left",
369
- "toSide": "right",
370
- "route": "return-left",
371
- "channelX": 360
372
- },
373
- {
374
- "id": "diagnose-correct",
375
- "from": "diagnose",
376
- "to": "correct",
377
- "variant": "dashed",
378
- "role": "branch",
379
- "fromSide": "left",
380
- "toSide": "right",
381
- "route": "return-left"
382
- },
383
- {
384
- "id": "correct-evidence",
385
- "from": "correct",
386
- "to": "evidence",
387
- "variant": "security",
388
- "role": "return",
389
- "fromSide": "left",
390
- "toSide": "left",
391
- "route": "return-left",
392
- "channelX": 160
393
- },
394
- {
395
- "id": "correct-blocked",
396
- "from": "correct",
397
- "to": "blocked",
398
- "variant": "dashed",
399
- "role": "branch",
400
- "fromSide": "left",
401
- "toSide": "right",
402
- "route": "return-left"
403
- }
404
- ],
405
- "cards": [
406
- {
407
- "dot": "rose",
408
- "title": "Safety boundary",
409
- "items": [
410
- "Execution starts only after PREFLIGHT_READY",
411
- "Workspace binding is optional but blocks mismatched execution",
412
- "Failures return to diagnosis before another claim",
413
- "Evidence-only completion rejection reopens verification from review",
414
- "Completion is validator-backed, not inferred from a screenshot",
415
- "Blocked pre-execution refresh requires a valid ledger and revised route"
416
- ]
417
- },
418
- {
419
- "dot": "amber",
420
- "title": "Deterministic project routing",
421
- "items": [
422
- "Repository evidence feeds bounded project and surface detection",
423
- "A parsed dependencies.flutter.sdk: flutter entry proves Flutter project scope",
424
- "The router selects the Flutter specialist only for an affected scoped root",
425
- "Detection context is routing input, not verification or completion evidence"
426
- ]
427
- },
428
- {
429
- "dot": "cyan",
430
- "title": "Evidence contract",
431
- "items": [
432
- "Verification scope narrows only through a fresh canonical boundary",
433
- "run-check binds exact commands to an execution reference",
434
- "record-check covers manual observations",
435
- "Drift reopens verification instead of being hidden",
436
- "Matching task IDs never authorize cross-project transaction reuse"
437
- ]
438
- },
439
- {
440
- "dot": "violet",
441
- "title": "Semantic checkpoint",
442
- "items": [
443
- "Jev is mandatory at required semantic checkpoints",
444
- "Typed Jev output is bounded non-authoritative input",
445
- "Jev cannot advance lifecycle, release claims, create evidence, or complete"
446
- ]
447
- },
448
- {
449
- "dot": "emerald",
450
- "title": "Portable output",
451
- "items": [
452
- "JSON IR is the source of truth",
453
- "HTML stays explorable and SVG stays GitHub-safe",
454
- "Attestation remains optional and separate from verification scope",
455
- "The text fallback carries the same lifecycle semantics"
456
- ]
457
- }
458
- ]
459
- }