@cassiomc1/forgeloop 2.1.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 (67) 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 +19 -48
  8. package/THIRD_PARTY_NOTICES.md +0 -15
  9. package/completions/_forgeloop +7 -1
  10. package/completions/forgeloop.bash +13 -1
  11. package/completions/forgeloop.fish +51 -1
  12. package/docs/AGENT_PROTOCOL_SUMMARY.md +7 -1
  13. package/docs/ARTIFACT_REFERENCE.md +1 -0
  14. package/docs/CLI_REFERENCE.md +111 -3
  15. package/docs/CODE_ATTESTATION.md +16 -7
  16. package/docs/DOCUMENTATION_GUIDE.md +10 -28
  17. package/docs/PACKAGE_CONTENTS.md +0 -3
  18. package/docs/RELEASE_CHECKLIST.md +81 -15
  19. package/docs/REVISION_PROVIDERS.md +3 -6
  20. package/docs/TROUBLESHOOTING.md +11 -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 +31 -0
  26. package/src/commands/assess.js +36 -0
  27. package/src/commands/attestation-create.js +21 -1
  28. package/src/commands/complete.js +3 -0
  29. package/src/commands/evidence-export.js +17 -0
  30. package/src/commands/evidence-publish.js +22 -0
  31. package/src/commands/evidence-verify.js +36 -0
  32. package/src/commands/sync-pull.js +111 -0
  33. package/src/commands/sync-push.js +52 -0
  34. package/src/core/assessment/facts.js +146 -0
  35. package/src/core/assessment/plan.js +133 -0
  36. package/src/core/audit.js +7 -0
  37. package/src/core/cli-command-definitions.js +88 -0
  38. package/src/core/command-executors.js +42 -5
  39. package/src/core/config.js +44 -37
  40. package/src/core/error-codes.js +70 -0
  41. package/src/core/evidence/auto-export.js +61 -0
  42. package/src/core/evidence/bundle-format.js +74 -0
  43. package/src/core/evidence/export.js +184 -0
  44. package/src/core/evidence/markdown.js +40 -0
  45. package/src/core/evidence/publish.js +187 -0
  46. package/src/core/evidence/verify.js +179 -0
  47. package/src/core/integration-invocation-policy.js +5 -2
  48. package/src/core/sync/merge.js +135 -0
  49. package/src/core/sync/remote.js +124 -0
  50. package/src/core/sync/snapshot.js +129 -0
  51. package/docs/assets/diagrams/forgeloop-code-attestation-flow.html +0 -13852
  52. package/docs/assets/diagrams/forgeloop-code-attestation-flow.receipt.json +0 -37
  53. package/docs/assets/diagrams/forgeloop-code-attestation-flow.svg +0 -5055
  54. package/docs/assets/diagrams/forgeloop-engineering-flow.html +0 -13837
  55. package/docs/assets/diagrams/forgeloop-engineering-flow.receipt.json +0 -37
  56. package/docs/assets/diagrams/forgeloop-engineering-flow.svg +0 -5011
  57. package/docs/assets/diagrams/forgeloop-verification-trust-flow.html +0 -13795
  58. package/docs/assets/diagrams/forgeloop-verification-trust-flow.receipt.json +0 -37
  59. package/docs/assets/diagrams/forgeloop-verification-trust-flow.svg +0 -4997
  60. package/docs/diagrams/README.md +0 -103
  61. package/docs/diagrams/forgeloop-code-attestation-flow.workflow.json +0 -451
  62. package/docs/diagrams/forgeloop-engineering-flow.workflow.json +0 -459
  63. package/docs/diagrams/forgeloop-verification-trust-flow.workflow.json +0 -398
  64. package/docs/diagrams/manifest.json +0 -84
  65. package/docs/diagrams/reviews/forgeloop-code-attestation-flow.review.json +0 -20
  66. package/docs/diagrams/reviews/forgeloop-engineering-flow.review.json +0 -20
  67. package/docs/diagrams/reviews/forgeloop-verification-trust-flow.review.json +0 -20
@@ -1,398 +0,0 @@
1
- {
2
- "schema_version": 1,
3
- "diagram_type": "workflow",
4
- "meta": {
5
- "title": "ForgeLoop Verification Trust Flow",
6
- "subtitle": "Canonical scope planning before exact command execution",
7
- "animation": "trace",
8
- "visual_preset": "signal-flow",
9
- "quality_profile": "showcase",
10
- "views": [
11
- {
12
- "id": "scope-resolution",
13
- "label": "Resolve verification scope",
14
- "focus": [
15
- "claims",
16
- "changes",
17
- "checker",
18
- "cycle",
19
- "fingerprints",
20
- "scope"
21
- ],
22
- "note": "Follow the trusted inputs that determine whether a checker may narrow its execution."
23
- },
24
- {
25
- "id": "exact-execution",
26
- "label": "Bind exact execution",
27
- "focus": [
28
- "scope",
29
- "argv",
30
- "observed"
31
- ],
32
- "note": "run-check proves execution; manual-review is explicit. Test filters do not establish canonical verification scope."
33
- },
34
- {
35
- "id": "fail-closed",
36
- "label": "Fail closed when trust is missing",
37
- "focus": [
38
- "checker",
39
- "full",
40
- "unresolved",
41
- "reject"
42
- ],
43
- "note": "No trusted checker means AUTO uses FULL; explicit narrowing without one is unresolved."
44
- }
45
- ],
46
- "legend": {
47
- "mode": "auto",
48
- "entries": {
49
- "backend": {
50
- "label": "Task/provider state"
51
- },
52
- "database": {
53
- "label": "Bound evidence"
54
- },
55
- "security": {
56
- "label": "Trust boundary"
57
- },
58
- "messagebus": {
59
- "label": "Fail-closed result"
60
- },
61
- "external": {
62
- "label": "Task input"
63
- }
64
- }
65
- },
66
- "viewBox": [
67
- 850,
68
- 900
69
- ]
70
- },
71
- "lanes": [
72
- {
73
- "id": "inputs",
74
- "label": "Task + Revision Inputs"
75
- },
76
- {
77
- "id": "policy",
78
- "label": "Trust and Scope Policy"
79
- },
80
- {
81
- "id": "execution",
82
- "label": "Exact Execution"
83
- },
84
- {
85
- "id": "evidence",
86
- "label": "Observed Evidence"
87
- },
88
- {
89
- "id": "exceptions",
90
- "label": "Fail-Closed Outcomes",
91
- "variant": "exception"
92
- },
93
- {
94
- "id": "closure",
95
- "label": "Verification Boundary"
96
- }
97
- ],
98
- "phases": [
99
- {
100
- "id": "inputs",
101
- "label": "Collect bound inputs",
102
- "fromCol": 0,
103
- "toCol": 1
104
- },
105
- {
106
- "id": "resolve",
107
- "label": "Resolve safe scope",
108
- "fromCol": 2,
109
- "toCol": 3,
110
- "variant": "emphasis"
111
- },
112
- {
113
- "id": "execute",
114
- "label": "Execute and observe",
115
- "fromCol": 4,
116
- "toCol": 5,
117
- "variant": "dashed"
118
- }
119
- ],
120
- "groups": [
121
- {
122
- "id": "scope_boundary",
123
- "label": "Verification scope boundary",
124
- "lane": "policy",
125
- "fromCol": 2,
126
- "toCol": 5,
127
- "variant": "emphasis"
128
- },
129
- {
130
- "id": "fail_closed_boundary",
131
- "label": "No guessed narrowing",
132
- "lane": "exceptions",
133
- "fromCol": 2,
134
- "toCol": 5,
135
- "variant": "security"
136
- }
137
- ],
138
- "mainPath": [
139
- "claims",
140
- "changes",
141
- "checker",
142
- "cycle",
143
- "fingerprints",
144
- "scope",
145
- "argv",
146
- "observed"
147
- ],
148
- "nodes": [
149
- {
150
- "id": "claims",
151
- "lane": "inputs",
152
- "col": 0,
153
- "type": "external",
154
- "label": "Claims",
155
- "sublabel": "write scope",
156
- "width": 64
157
- },
158
- {
159
- "id": "changes",
160
- "lane": "inputs",
161
- "col": 1,
162
- "type": "backend",
163
- "label": "Changes",
164
- "sublabel": "provider",
165
- "width": 70
166
- },
167
- {
168
- "id": "checker",
169
- "lane": "policy",
170
- "col": 2,
171
- "type": "security",
172
- "label": "Checker",
173
- "sublabel": "trusted scope",
174
- "tag": "capability",
175
- "width": 64
176
- },
177
- {
178
- "id": "cycle",
179
- "lane": "policy",
180
- "col": 3,
181
- "type": "backend",
182
- "label": "Cycle",
183
- "sublabel": "fresh",
184
- "width": 50
185
- },
186
- {
187
- "id": "fingerprints",
188
- "lane": "policy",
189
- "col": 4,
190
- "type": "security",
191
- "label": "Bind",
192
- "sublabel": "contract/repo",
193
- "width": 58
194
- },
195
- {
196
- "id": "scope",
197
- "lane": "evidence",
198
- "col": 4,
199
- "type": "database",
200
- "label": "verify-scope",
201
- "sublabel": "AUTO / explicit",
202
- "tag": "scope",
203
- "width": 82
204
- },
205
- {
206
- "id": "argv",
207
- "lane": "execution",
208
- "col": 5,
209
- "type": "security",
210
- "label": "argv",
211
- "sublabel": "paths",
212
- "tag": "exact",
213
- "width": 50
214
- },
215
- {
216
- "id": "observed",
217
- "lane": "evidence",
218
- "col": 5,
219
- "type": "database",
220
- "label": "Evidence",
221
- "sublabel": "executionRef",
222
- "tag": "observed",
223
- "width": 70
224
- },
225
- {
226
- "id": "full",
227
- "lane": "exceptions",
228
- "col": 2,
229
- "type": "messagebus",
230
- "label": "AUTO \u2192 FULL",
231
- "sublabel": "no checker",
232
- "tag": "safe",
233
- "width": 76
234
- },
235
- {
236
- "id": "unresolved",
237
- "lane": "exceptions",
238
- "col": 3,
239
- "type": "security",
240
- "label": "Open",
241
- "sublabel": "narrow",
242
- "tag": "unresolved",
243
- "width": 50
244
- },
245
- {
246
- "id": "reject",
247
- "lane": "exceptions",
248
- "col": 4,
249
- "type": "security",
250
- "label": "Reject",
251
- "sublabel": "pre-launch",
252
- "tag": "argv drift",
253
- "width": 50
254
- },
255
- {
256
- "id": "boundary",
257
- "lane": "closure",
258
- "col": 5,
259
- "type": "security",
260
- "label": "Boundary",
261
- "sublabel": "scope/coverage",
262
- "width": 64
263
- }
264
- ],
265
- "edges": [
266
- {
267
- "id": "claims-changes",
268
- "from": "claims",
269
- "to": "changes",
270
- "variant": "emphasis"
271
- },
272
- {
273
- "id": "changes-checker",
274
- "from": "changes",
275
- "to": "checker",
276
- "variant": "default",
277
- "route": "drop",
278
- "fromSide": "bottom",
279
- "toSide": "top"
280
- },
281
- {
282
- "id": "checker-cycle",
283
- "from": "checker",
284
- "to": "cycle",
285
- "variant": "emphasis"
286
- },
287
- {
288
- "id": "cycle-fingerprints",
289
- "from": "cycle",
290
- "to": "fingerprints",
291
- "variant": "security",
292
- "fromSide": "bottom",
293
- "toSide": "bottom",
294
- "route": "bottom-channel",
295
- "channelY": 312
296
- },
297
- {
298
- "id": "fingerprints-scope",
299
- "from": "fingerprints",
300
- "to": "scope",
301
- "variant": "emphasis",
302
- "fromSide": "bottom",
303
- "toSide": "top",
304
- "route": "drop"
305
- },
306
- {
307
- "id": "scope-argv",
308
- "from": "scope",
309
- "to": "argv",
310
- "variant": "security",
311
- "fromSide": "right",
312
- "toSide": "left",
313
- "route": "bottom-channel",
314
- "channelY": 408
315
- },
316
- {
317
- "id": "argv-observed",
318
- "from": "argv",
319
- "to": "observed",
320
- "variant": "dashed",
321
- "fromSide": "bottom",
322
- "toSide": "top",
323
- "route": "drop"
324
- },
325
- {
326
- "id": "checker-full",
327
- "from": "checker",
328
- "to": "full",
329
- "variant": "dashed",
330
- "role": "branch",
331
- "fromSide": "left",
332
- "toSide": "right",
333
- "route": "return-left"
334
- },
335
- {
336
- "id": "checker-unresolved",
337
- "from": "checker",
338
- "to": "unresolved",
339
- "variant": "security",
340
- "role": "error",
341
- "fromSide": "bottom",
342
- "toSide": "top",
343
- "route": "drop"
344
- },
345
- {
346
- "id": "scope-reject",
347
- "from": "scope",
348
- "to": "reject",
349
- "variant": "security",
350
- "role": "error",
351
- "fromSide": "bottom",
352
- "toSide": "top",
353
- "route": "drop"
354
- },
355
- {
356
- "id": "observed-boundary",
357
- "from": "observed",
358
- "to": "boundary",
359
- "variant": "dashed",
360
- "role": "branch",
361
- "fromSide": "left",
362
- "toSide": "right",
363
- "route": "return-left"
364
- }
365
- ],
366
- "cards": [
367
- {
368
- "dot": "rose",
369
- "title": "Fail-Closed Narrowing",
370
- "items": [
371
- "AUTO uses CHANGED or CLAIMED only with a trusted scoped checker",
372
- "AUTO falls back to CLAIMED when changed paths cannot be safely narrowed and claims are valid; otherwise it falls back to FULL",
373
- "Without that capability, AUTO resolves safely to FULL",
374
- "Explicit CHANGED or CLAIMED without a checker returns unresolved",
375
- "A test name or file filter is not a canonical scope boundary"
376
- ]
377
- },
378
- {
379
- "dot": "cyan",
380
- "title": "Exact Process Binding",
381
- "items": [
382
- "RevisionProvider changes and task claims are canonical inputs",
383
- "Contract, repository, and cycle fingerprints bind the scope",
384
- "argv prefix and selected paths are checked before launch",
385
- "Manual evidence declares manual-review; command metadata is not execution"
386
- ]
387
- },
388
- {
389
- "dot": "emerald",
390
- "title": "Evidence Boundary",
391
- "items": [
392
- "run-check records exact process provenance as observed evidence",
393
- "Stale scope or argv drift cannot become verification evidence",
394
- "Verification scope is not attestation coverage"
395
- ]
396
- }
397
- ]
398
- }
@@ -1,84 +0,0 @@
1
- {
2
- "version": 2,
3
- "renderer": {
4
- "name": "archify",
5
- "version": "2.15.0",
6
- "commit": "e1ac748f19cf805e44bf74fb93c796662152e273",
7
- "source": "https://github.com/tt-a1i/archify/tree/v2.15.0",
8
- "license": "MIT"
9
- },
10
- "policy": {
11
- "supportedTypes": [
12
- "workflow",
13
- "architecture",
14
- "sequence",
15
- "dataflow",
16
- "lifecycle"
17
- ],
18
- "requireVisualReview": true
19
- },
20
- "diagrams": [
21
- {
22
- "id": "forgeloop-engineering-flow",
23
- "type": "workflow",
24
- "defaultTheme": "dark",
25
- "canonicalFor": [
26
- "high-level-engineering-flow"
27
- ],
28
- "source": "docs/diagrams/forgeloop-engineering-flow.workflow.json",
29
- "html": "docs/assets/diagrams/forgeloop-engineering-flow.html",
30
- "svg": "docs/assets/diagrams/forgeloop-engineering-flow.svg",
31
- "receipt": "docs/assets/diagrams/forgeloop-engineering-flow.receipt.json",
32
- "review": "docs/diagrams/reviews/forgeloop-engineering-flow.review.json",
33
- "fallback": "README.md#architecture-flow",
34
- "referencedBy": [
35
- "README.md",
36
- "DOCS_INDEX.md",
37
- "docs/DOCUMENTATION_GUIDE.md",
38
- "docs/diagrams/README.md"
39
- ]
40
- },
41
- {
42
- "id": "forgeloop-verification-trust-flow",
43
- "type": "workflow",
44
- "defaultTheme": "dark",
45
- "canonicalFor": [
46
- "differential-verification-trust-boundary"
47
- ],
48
- "source": "docs/diagrams/forgeloop-verification-trust-flow.workflow.json",
49
- "html": "docs/assets/diagrams/forgeloop-verification-trust-flow.html",
50
- "svg": "docs/assets/diagrams/forgeloop-verification-trust-flow.svg",
51
- "receipt": "docs/assets/diagrams/forgeloop-verification-trust-flow.receipt.json",
52
- "review": "docs/diagrams/reviews/forgeloop-verification-trust-flow.review.json",
53
- "fallback": "docs/REVISION_PROVIDERS.md#differential-verification-scope",
54
- "referencedBy": [
55
- "README.md",
56
- "DOCS_INDEX.md",
57
- "LOOP_SYSTEM_DESIGN.md",
58
- "docs/REVISION_PROVIDERS.md",
59
- "docs/diagrams/README.md"
60
- ]
61
- },
62
- {
63
- "id": "forgeloop-code-attestation-flow",
64
- "type": "workflow",
65
- "defaultTheme": "dark",
66
- "canonicalFor": [
67
- "code-attestation-chain"
68
- ],
69
- "source": "docs/diagrams/forgeloop-code-attestation-flow.workflow.json",
70
- "html": "docs/assets/diagrams/forgeloop-code-attestation-flow.html",
71
- "svg": "docs/assets/diagrams/forgeloop-code-attestation-flow.svg",
72
- "receipt": "docs/assets/diagrams/forgeloop-code-attestation-flow.receipt.json",
73
- "review": "docs/diagrams/reviews/forgeloop-code-attestation-flow.review.json",
74
- "fallback": "docs/CODE_ATTESTATION.md#completion-flow",
75
- "referencedBy": [
76
- "README.md",
77
- "DOCS_INDEX.md",
78
- "QUALITY_SCORECARD.md",
79
- "docs/CODE_ATTESTATION.md",
80
- "docs/diagrams/README.md"
81
- ]
82
- }
83
- ]
84
- }
@@ -1,20 +0,0 @@
1
- {
2
- "version": 1,
3
- "diagramId": "forgeloop-code-attestation-flow",
4
- "status": "approved",
5
- "binding": {
6
- "sourceSha256": "eb8ca8fdfceb9e50cf7cd07be8622dcac127cfee80c8e2929d604c40138cc594",
7
- "svgSha256": "876c6400a34f9fe9773e61d968ddf773669cc14153933de2b2ceccd4386506a7"
8
- },
9
- "checks": {
10
- "darkThemeLegible": true,
11
- "noOverlap": true,
12
- "labelsReadable": true,
13
- "trustBoundariesClear": true,
14
- "mobilePreviewAcceptable": true,
15
- "textFallbackEquivalent": true,
16
- "accessibleMetadataPresent": true
17
- },
18
- "reviewedBy": "Visual review of desktop and narrow SVG previews",
19
- "reviewedAt": "2026-09-24"
20
- }
@@ -1,20 +0,0 @@
1
- {
2
- "version": 1,
3
- "diagramId": "forgeloop-engineering-flow",
4
- "status": "approved",
5
- "binding": {
6
- "sourceSha256": "3eb4ed7dc7566cf786311b230336b88ff214889ec5a86bb8f2cf0b629a50ae95",
7
- "svgSha256": "42571b1a2ffc1a97f6fd11875078603e72b6f0481648d30972381b74b05971e8"
8
- },
9
- "checks": {
10
- "darkThemeLegible": true,
11
- "noOverlap": true,
12
- "labelsReadable": true,
13
- "trustBoundariesClear": true,
14
- "mobilePreviewAcceptable": true,
15
- "textFallbackEquivalent": true,
16
- "accessibleMetadataPresent": true
17
- },
18
- "reviewedBy": "Visual review of desktop and narrow SVG previews",
19
- "reviewedAt": "2026-09-24"
20
- }
@@ -1,20 +0,0 @@
1
- {
2
- "version": 1,
3
- "diagramId": "forgeloop-verification-trust-flow",
4
- "status": "approved",
5
- "binding": {
6
- "sourceSha256": "86b11945f1ec4325f244c034d81f137646b508ceda5b11fce6729d4242365269",
7
- "svgSha256": "9208211a2a7b66baa2c3671e8b6436aabc98f57e9771c33b39ec98c9bd6d8ca3"
8
- },
9
- "checks": {
10
- "darkThemeLegible": true,
11
- "noOverlap": true,
12
- "labelsReadable": true,
13
- "trustBoundariesClear": true,
14
- "mobilePreviewAcceptable": true,
15
- "textFallbackEquivalent": true,
16
- "accessibleMetadataPresent": true
17
- },
18
- "reviewedBy": "Visual review of desktop and narrow SVG previews",
19
- "reviewedAt": "2026-09-24"
20
- }