@cassiomc1/forgeloop 1.12.0 → 1.13.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 (62) hide show
  1. package/.github/copilot-instructions.md +1 -1
  2. package/AGENTS.md +1 -1
  3. package/CLAUDE.md +1 -1
  4. package/CONTRIBUTING.md +90 -0
  5. package/DOCS_INDEX.md +13 -11
  6. package/ENG/c-development-eng.md +112 -0
  7. package/ENG/cpp-development-eng.md +109 -0
  8. package/ENG/dotnet-aspnetcore-development-eng.md +401 -0
  9. package/ENG/go-development-eng.md +103 -0
  10. package/ENG/java-development-eng.md +125 -0
  11. package/ENG/nodejs-backend-development-eng.md +605 -0
  12. package/ENG/php-development-eng.md +104 -0
  13. package/ENG/rust-development-eng.md +422 -0
  14. package/ENG/sql-development-eng.md +108 -0
  15. package/ENG/swift-development-eng.md +111 -0
  16. package/ENG/typescript-development-eng.md +108 -0
  17. package/GUIDE_ROUTER.md +418 -9
  18. package/QUALITY_SCORECARD.md +1 -0
  19. package/README.md +44 -33
  20. package/THIRD_PARTY_NOTICES.md +19 -7
  21. package/completions/_forgeloop +3 -3
  22. package/completions/forgeloop.bash +3 -3
  23. package/completions/forgeloop.fish +7 -0
  24. package/docs/AGENT_PROTOCOL_SUMMARY.md +55 -2
  25. package/docs/CLI_REFERENCE.md +28 -6
  26. package/docs/DOCUMENTATION_GUIDE.md +2 -1
  27. package/docs/GETTING_STARTED.md +59 -0
  28. package/docs/PACKAGE_CONTENTS.md +28 -14
  29. package/docs/RECIPES.md +23 -0
  30. package/docs/RELEASE_CHECKLIST.md +30 -2
  31. package/docs/TROUBLESHOOTING.md +100 -2
  32. package/docs/documentation-manifest.json +652 -0
  33. package/docs/protocol-requirements.json +77 -0
  34. package/package.json +19 -4
  35. package/schemas/routing-input.schema.json +1 -1
  36. package/scripts/CI_VALIDATORS.md +84 -11
  37. package/scripts/generate-agent-protocol-summary.mjs +36 -0
  38. package/src/commands/next.js +19 -7
  39. package/src/commands/task-create.js +84 -25
  40. package/src/commands/task-list.js +22 -2
  41. package/src/config/guides.json +44 -0
  42. package/src/core/build-script.js +151 -0
  43. package/src/core/c-cpp-project.js +143 -0
  44. package/src/core/cli-command-definitions.js +8 -1
  45. package/src/core/command-executors.js +5 -3
  46. package/src/core/command-input.js +140 -102
  47. package/src/core/contract-presets.js +82 -0
  48. package/src/core/error-codes.js +3 -3
  49. package/src/core/filesystem.js +1 -10
  50. package/src/core/go-project.js +206 -0
  51. package/src/core/java-project.js +403 -0
  52. package/src/core/multi-language-project.js +117 -0
  53. package/src/core/next-explanation.js +63 -0
  54. package/src/core/php-project.js +85 -0
  55. package/src/core/project-detection.js +1760 -52
  56. package/src/core/reconcile-closure.js +4 -1
  57. package/src/core/router.js +156 -3
  58. package/src/core/rust-project.js +400 -0
  59. package/src/core/sql-project.js +141 -0
  60. package/src/core/swift-project.js +200 -0
  61. package/src/core/typescript-project.js +349 -0
  62. package/src/core/xml-structure.js +123 -0
@@ -0,0 +1,652 @@
1
+ {
2
+ "version": 1,
3
+ "documents": [
4
+ {
5
+ "path": "AGENTS.md",
6
+ "id": "agent-instructions",
7
+ "class": "operational",
8
+ "audience": [
9
+ "harness"
10
+ ],
11
+ "canonicalFor": [],
12
+ "packaged": true
13
+ },
14
+ {
15
+ "path": "CLAUDE.md",
16
+ "id": "claude-adapter",
17
+ "class": "adapter",
18
+ "audience": [
19
+ "harness"
20
+ ],
21
+ "canonicalFor": [],
22
+ "packaged": true
23
+ },
24
+ {
25
+ "path": "GUIDE_ROUTER.md",
26
+ "id": "guide-router",
27
+ "class": "normative",
28
+ "audience": [
29
+ "harness",
30
+ "maintainer"
31
+ ],
32
+ "canonicalFor": [
33
+ "guide-routing"
34
+ ],
35
+ "packaged": true
36
+ },
37
+ {
38
+ "path": "LOOP_ENGINEERING.md",
39
+ "id": "protocol",
40
+ "class": "normative",
41
+ "audience": [
42
+ "harness",
43
+ "maintainer"
44
+ ],
45
+ "canonicalFor": [
46
+ "lifecycle",
47
+ "gates",
48
+ "verification",
49
+ "recovery",
50
+ "continuity"
51
+ ],
52
+ "packaged": true
53
+ },
54
+ {
55
+ "path": "PROTOCOL_INTEGRATION.md",
56
+ "id": "protocol-integration",
57
+ "class": "normative",
58
+ "audience": [
59
+ "integrator"
60
+ ],
61
+ "canonicalFor": [
62
+ "integration"
63
+ ],
64
+ "packaged": true
65
+ },
66
+ {
67
+ "path": "LOOP_SYSTEM_DESIGN.md",
68
+ "id": "system-design",
69
+ "class": "architecture",
70
+ "audience": [
71
+ "maintainer",
72
+ "integrator"
73
+ ],
74
+ "canonicalFor": [
75
+ "architecture"
76
+ ],
77
+ "packaged": true
78
+ },
79
+ {
80
+ "path": "QUALITY_SCORECARD.md",
81
+ "id": "quality-scorecard",
82
+ "class": "reference",
83
+ "audience": [
84
+ "maintainer"
85
+ ],
86
+ "canonicalFor": [
87
+ "quality-scoring"
88
+ ],
89
+ "packaged": true
90
+ },
91
+ {
92
+ "path": "TERMINOLOGY.md",
93
+ "id": "terminology",
94
+ "class": "normative",
95
+ "audience": [
96
+ "harness",
97
+ "maintainer",
98
+ "integrator"
99
+ ],
100
+ "canonicalFor": [
101
+ "terminology"
102
+ ],
103
+ "packaged": true
104
+ },
105
+ {
106
+ "path": "EXECUTION_STATE.md",
107
+ "id": "execution-state",
108
+ "class": "reference",
109
+ "audience": [
110
+ "harness"
111
+ ],
112
+ "canonicalFor": [
113
+ "execution-artifacts"
114
+ ],
115
+ "packaged": true
116
+ },
117
+ {
118
+ "path": "DELEGATION_PROTOCOL.md",
119
+ "id": "delegation",
120
+ "class": "reference",
121
+ "audience": [
122
+ "harness"
123
+ ],
124
+ "canonicalFor": [
125
+ "delegation"
126
+ ],
127
+ "packaged": true
128
+ },
129
+ {
130
+ "path": "ORCHESTRATOR_INTEGRATION.md",
131
+ "id": "orchestrator-integration",
132
+ "class": "architecture",
133
+ "audience": [
134
+ "integrator"
135
+ ],
136
+ "canonicalFor": [
137
+ "orchestration"
138
+ ],
139
+ "packaged": true
140
+ },
141
+ {
142
+ "path": "THREAT_MODEL.md",
143
+ "id": "threat-model",
144
+ "class": "normative",
145
+ "audience": [
146
+ "maintainer",
147
+ "integrator"
148
+ ],
149
+ "canonicalFor": [
150
+ "security-model"
151
+ ],
152
+ "packaged": true
153
+ },
154
+ {
155
+ "path": "CONTRACT_COVERAGE.md",
156
+ "id": "contract-coverage",
157
+ "class": "reference",
158
+ "audience": [
159
+ "maintainer"
160
+ ],
161
+ "canonicalFor": [
162
+ "coverage"
163
+ ],
164
+ "packaged": true
165
+ },
166
+ {
167
+ "path": "AGENT_COMPATIBILITY.md",
168
+ "id": "agent-compatibility",
169
+ "class": "deprecated",
170
+ "audience": [
171
+ "harness"
172
+ ],
173
+ "canonicalFor": [],
174
+ "packaged": false,
175
+ "replacement": "PROTOCOL_INTEGRATION.md",
176
+ "removalPolicy": "Remove in the next compatibility-breaking package release."
177
+ },
178
+ {
179
+ "path": "PROJECT_PROFILE.md",
180
+ "id": "project-profile",
181
+ "class": "template",
182
+ "audience": [
183
+ "harness"
184
+ ],
185
+ "canonicalFor": [
186
+ "project-profile"
187
+ ],
188
+ "packaged": false
189
+ },
190
+ {
191
+ "path": "THIRD_PARTY_NOTICES.md",
192
+ "id": "third-party-notices",
193
+ "class": "legal",
194
+ "audience": [
195
+ "maintainer"
196
+ ],
197
+ "canonicalFor": [
198
+ "third-party-notices"
199
+ ],
200
+ "packaged": false
201
+ },
202
+ {
203
+ "path": "LICENSE-DOCS.md",
204
+ "id": "documentation-license",
205
+ "class": "legal",
206
+ "audience": [
207
+ "maintainer"
208
+ ],
209
+ "canonicalFor": [
210
+ "documentation-license"
211
+ ],
212
+ "packaged": false
213
+ },
214
+ {
215
+ "path": ".github/copilot-instructions.md",
216
+ "id": "copilot-adapter",
217
+ "class": "adapter",
218
+ "audience": [
219
+ "harness"
220
+ ],
221
+ "canonicalFor": [],
222
+ "packaged": false
223
+ },
224
+ {
225
+ "path": "README.md",
226
+ "id": "readme",
227
+ "class": "overview",
228
+ "audience": [
229
+ "user",
230
+ "integrator"
231
+ ],
232
+ "canonicalFor": [
233
+ "getting-started-overview"
234
+ ],
235
+ "packaged": true
236
+ },
237
+ {
238
+ "path": "DOCS_INDEX.md",
239
+ "id": "docs-index",
240
+ "class": "index",
241
+ "audience": [
242
+ "user",
243
+ "integrator"
244
+ ],
245
+ "canonicalFor": [
246
+ "documentation-navigation"
247
+ ],
248
+ "packaged": true
249
+ },
250
+ {
251
+ "path": "docs/GETTING_STARTED.md",
252
+ "id": "getting-started",
253
+ "class": "guide",
254
+ "audience": [
255
+ "user"
256
+ ],
257
+ "canonicalFor": [
258
+ "getting-started"
259
+ ],
260
+ "packaged": true
261
+ },
262
+ {
263
+ "path": "docs/CROSS_HARNESS_CONTINUITY.md",
264
+ "id": "cross-harness-continuity",
265
+ "class": "guide",
266
+ "audience": [
267
+ "integrator"
268
+ ],
269
+ "canonicalFor": [
270
+ "cross-harness-continuity"
271
+ ],
272
+ "packaged": true
273
+ },
274
+ {
275
+ "path": "docs/CLI_REFERENCE.md",
276
+ "id": "cli-reference",
277
+ "class": "generated",
278
+ "audience": [
279
+ "user",
280
+ "integrator"
281
+ ],
282
+ "canonicalFor": [
283
+ "cli-reference"
284
+ ],
285
+ "packaged": true,
286
+ "generator": "scripts/generate_documentation_reference.mjs"
287
+ },
288
+ {
289
+ "path": "docs/ARTIFACT_REFERENCE.md",
290
+ "id": "artifact-reference",
291
+ "class": "generated",
292
+ "audience": [
293
+ "integrator"
294
+ ],
295
+ "canonicalFor": [
296
+ "artifact-reference"
297
+ ],
298
+ "packaged": true,
299
+ "generator": "scripts/generate_documentation_reference.mjs"
300
+ },
301
+ {
302
+ "path": "docs/TROUBLESHOOTING.md",
303
+ "id": "troubleshooting",
304
+ "class": "guide",
305
+ "audience": [
306
+ "user"
307
+ ],
308
+ "canonicalFor": [
309
+ "troubleshooting"
310
+ ],
311
+ "packaged": true
312
+ },
313
+ {
314
+ "path": "docs/RECIPES.md",
315
+ "id": "recipes",
316
+ "class": "guide",
317
+ "audience": [
318
+ "user"
319
+ ],
320
+ "canonicalFor": [
321
+ "recipes"
322
+ ],
323
+ "packaged": true
324
+ },
325
+ {
326
+ "path": "docs/STRUCTURAL_QUALITY.md",
327
+ "id": "structural-quality",
328
+ "class": "guide",
329
+ "audience": [
330
+ "user",
331
+ "integrator",
332
+ "maintainer"
333
+ ],
334
+ "canonicalFor": [
335
+ "structural-quality-feedback"
336
+ ],
337
+ "packaged": true
338
+ },
339
+ {
340
+ "path": "docs/DOCUMENTATION_GUIDE.md",
341
+ "id": "documentation-guide",
342
+ "class": "guide",
343
+ "audience": [
344
+ "maintainer"
345
+ ],
346
+ "canonicalFor": [
347
+ "documentation-maintenance"
348
+ ],
349
+ "packaged": true
350
+ },
351
+ {
352
+ "path": "docs/diagrams/README.md",
353
+ "id": "documentation-diagrams",
354
+ "class": "guide",
355
+ "audience": [
356
+ "maintainer",
357
+ "integrator"
358
+ ],
359
+ "canonicalFor": [
360
+ "documentation-diagrams"
361
+ ],
362
+ "packaged": true
363
+ },
364
+ {
365
+ "path": "docs/RELEASE_CHECKLIST_1_4.md",
366
+ "id": "release-checklist-1-4",
367
+ "class": "reference",
368
+ "audience": [
369
+ "maintainer"
370
+ ],
371
+ "canonicalFor": [
372
+ "release-1-4"
373
+ ],
374
+ "packaged": false
375
+ },
376
+ {
377
+ "path": "scripts/CI_VALIDATORS.md",
378
+ "id": "ci-validators",
379
+ "class": "reference",
380
+ "audience": [
381
+ "maintainer"
382
+ ],
383
+ "canonicalFor": [
384
+ "ci-validators"
385
+ ],
386
+ "packaged": true
387
+ },
388
+ {
389
+ "path": "docs/MCP.md",
390
+ "id": "mcp",
391
+ "class": "guide",
392
+ "audience": [
393
+ "user",
394
+ "integrator"
395
+ ],
396
+ "canonicalFor": [
397
+ "mcp"
398
+ ],
399
+ "packaged": true
400
+ },
401
+ {
402
+ "path": "docs/UNIVERSAL_INTEGRATION.md",
403
+ "id": "universal-integration",
404
+ "class": "guide",
405
+ "audience": [
406
+ "user",
407
+ "integrator"
408
+ ],
409
+ "canonicalFor": [
410
+ "universal-integration"
411
+ ],
412
+ "packaged": true
413
+ },
414
+ {
415
+ "path": "docs/RELEASE_CHECKLIST_1_5_MCP.md",
416
+ "id": "release-checklist-1-5-mcp",
417
+ "class": "reference",
418
+ "audience": [
419
+ "maintainer"
420
+ ],
421
+ "canonicalFor": [
422
+ "release-checklist-1-5-mcp"
423
+ ],
424
+ "packaged": false
425
+ },
426
+ {
427
+ "path": "docs/RELEASE_CHECKLIST_1_6_1.md",
428
+ "id": "release-checklist-1-6-1",
429
+ "class": "reference",
430
+ "audience": [
431
+ "maintainer"
432
+ ],
433
+ "canonicalFor": [
434
+ "release-checklist-1-6-1"
435
+ ],
436
+ "packaged": false
437
+ },
438
+ {
439
+ "path": "docs/DIAGNOSTIC_MODEL.md",
440
+ "id": "diagnostic-model",
441
+ "class": "reference",
442
+ "audience": [
443
+ "harness",
444
+ "maintainer"
445
+ ],
446
+ "canonicalFor": [
447
+ "diagnostics"
448
+ ],
449
+ "packaged": true
450
+ },
451
+ {
452
+ "path": "docs/EXECUTION_TRACE.md",
453
+ "id": "execution-trace",
454
+ "class": "reference",
455
+ "audience": [
456
+ "harness",
457
+ "maintainer",
458
+ "integrator"
459
+ ],
460
+ "canonicalFor": [
461
+ "observability"
462
+ ],
463
+ "packaged": true
464
+ },
465
+ {
466
+ "path": "docs/RELEASE_CHECKLIST.md",
467
+ "id": "release-checklist",
468
+ "class": "reference",
469
+ "audience": [
470
+ "maintainer"
471
+ ],
472
+ "canonicalFor": [
473
+ "release-checklist"
474
+ ],
475
+ "packaged": true
476
+ },
477
+ {
478
+ "path": "docs/PACKAGE_CONTENTS.md",
479
+ "id": "package-contents",
480
+ "class": "reference",
481
+ "audience": [
482
+ "user",
483
+ "maintainer"
484
+ ],
485
+ "canonicalFor": [
486
+ "package-contents"
487
+ ],
488
+ "packaged": true
489
+ },
490
+ {
491
+ "path": "docs/CODE_ATTESTATION.md",
492
+ "id": "code-attestation",
493
+ "class": "normative",
494
+ "audience": [
495
+ "integrator",
496
+ "maintainer"
497
+ ],
498
+ "canonicalFor": [
499
+ "code-attestation"
500
+ ],
501
+ "packaged": true
502
+ },
503
+ {
504
+ "path": "docs/REVISION_PROVIDERS.md",
505
+ "id": "revision-providers",
506
+ "class": "reference",
507
+ "audience": [
508
+ "integrator",
509
+ "maintainer"
510
+ ],
511
+ "canonicalFor": [
512
+ "revision-providers"
513
+ ],
514
+ "packaged": true
515
+ },
516
+ {
517
+ "path": "docs/SIGNING_PROVIDERS.md",
518
+ "id": "signing-providers",
519
+ "class": "reference",
520
+ "audience": [
521
+ "integrator",
522
+ "maintainer"
523
+ ],
524
+ "canonicalFor": [
525
+ "signing-providers"
526
+ ],
527
+ "packaged": true
528
+ },
529
+ {
530
+ "path": "docs/PLATFORM_ADAPTERS.md",
531
+ "id": "platform-adapters",
532
+ "class": "reference",
533
+ "audience": [
534
+ "integrator"
535
+ ],
536
+ "canonicalFor": [
537
+ "platform-adapters"
538
+ ],
539
+ "packaged": true
540
+ },
541
+ {
542
+ "path": "docs/EXECUTION_PROFILE_BENCHMARKS.md",
543
+ "id": "execution-profile-benchmarks",
544
+ "class": "reference",
545
+ "audience": [
546
+ "integrator",
547
+ "maintainer"
548
+ ],
549
+ "canonicalFor": [
550
+ "execution-profile-benchmarks"
551
+ ],
552
+ "packaged": true
553
+ },
554
+ {
555
+ "path": "docs/AGENT_PROTOCOL_SUMMARY.md",
556
+ "id": "agent-protocol-summary",
557
+ "class": "generated",
558
+ "audience": [
559
+ "harness"
560
+ ],
561
+ "canonicalFor": [
562
+ "agent-protocol-summary"
563
+ ],
564
+ "packaged": true,
565
+ "generator": "scripts/generate-agent-protocol-summary.mjs"
566
+ },
567
+ {
568
+ "path": "docs/KNOWLEDGE_INTEGRATION_GAP_ANALYSIS.md",
569
+ "id": "knowledge-integration-gap-analysis",
570
+ "class": "reference",
571
+ "audience": [
572
+ "maintainer",
573
+ "integrator"
574
+ ],
575
+ "canonicalFor": [
576
+ "knowledge-integration-audit"
577
+ ],
578
+ "packaged": false
579
+ },
580
+ {
581
+ "path": "docs/KNOWLEDGE_SOURCES.md",
582
+ "id": "knowledge-sources",
583
+ "class": "reference",
584
+ "audience": [
585
+ "maintainer",
586
+ "integrator"
587
+ ],
588
+ "canonicalFor": [
589
+ "knowledge-provenance"
590
+ ],
591
+ "packaged": true
592
+ },
593
+ {
594
+ "path": "docs/ADVISORY_CONTEXT.md",
595
+ "id": "advisory-context",
596
+ "class": "reference",
597
+ "audience": [
598
+ "harness",
599
+ "integrator",
600
+ "maintainer"
601
+ ],
602
+ "canonicalFor": [
603
+ "advisory-context",
604
+ "external-memory"
605
+ ],
606
+ "packaged": true
607
+ },
608
+ {
609
+ "path": "docs/RIPWIRE_ADAPTER.md",
610
+ "id": "ripwire-adapter",
611
+ "class": "reference",
612
+ "audience": [
613
+ "harness",
614
+ "integrator",
615
+ "maintainer"
616
+ ],
617
+ "canonicalFor": [
618
+ "ripwire-adapter"
619
+ ],
620
+ "packaged": true
621
+ },
622
+ {
623
+ "path": "docs/REPOSITORY_INDEX.md",
624
+ "id": "repository-index",
625
+ "class": "guide",
626
+ "audience": [
627
+ "user",
628
+ "harness",
629
+ "integrator",
630
+ "maintainer"
631
+ ],
632
+ "canonicalFor": [
633
+ "repository-index"
634
+ ],
635
+ "packaged": true
636
+ },
637
+ {
638
+ "path": "docs/PERSISTENT_SEARCH_TRANSPORT.md",
639
+ "id": "persistent-search-transport",
640
+ "class": "architecture",
641
+ "audience": [
642
+ "user",
643
+ "integrator",
644
+ "maintainer"
645
+ ],
646
+ "canonicalFor": [
647
+ "persistent-search-transport"
648
+ ],
649
+ "packaged": true
650
+ }
651
+ ]
652
+ }