@cassiomc1/forgeloop 1.5.0 → 1.6.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 (126) hide show
  1. package/DOCS_INDEX.md +13 -8
  2. package/EXECUTION_STATE.md +20 -0
  3. package/LOOP_ENGINEERING.md +81 -0
  4. package/LOOP_SYSTEM_DESIGN.md +32 -0
  5. package/PROTOCOL_INTEGRATION.md +46 -0
  6. package/QUALITY_SCORECARD.md +2 -0
  7. package/README.md +31 -9
  8. package/THIRD_PARTY_NOTICES.md +15 -0
  9. package/THREAT_MODEL.md +39 -0
  10. package/docs/ARTIFACT_REFERENCE.md +140 -0
  11. package/docs/CLI_REFERENCE.md +294 -3
  12. package/docs/DIAGNOSTIC_MODEL.md +181 -0
  13. package/docs/DOCUMENTATION_GUIDE.md +22 -13
  14. package/docs/EXECUTION_TRACE.md +76 -0
  15. package/docs/MCP.md +33 -0
  16. package/docs/RECIPES.md +67 -0
  17. package/docs/TROUBLESHOOTING.md +106 -2
  18. package/docs/assets/diagrams/forgeloop-engineering-flow.html +13797 -0
  19. package/docs/assets/diagrams/forgeloop-engineering-flow.receipt.json +37 -0
  20. package/docs/assets/diagrams/forgeloop-engineering-flow.svg +5002 -0
  21. package/docs/diagrams/README.md +55 -0
  22. package/docs/diagrams/forgeloop-engineering-flow.workflow.json +122 -0
  23. package/docs/diagrams/manifest.json +42 -0
  24. package/docs/diagrams/reviews/forgeloop-engineering-flow.review.json +20 -0
  25. package/package.json +8 -6
  26. package/schemas/action.schema.json +100 -0
  27. package/schemas/approval.schema.json +51 -0
  28. package/schemas/capability-policy.schema.json +41 -0
  29. package/schemas/diagnostic-case.schema.json +85 -0
  30. package/schemas/execution-receipt.schema.json +16 -0
  31. package/schemas/hypothesis-disposition.schema.json +16 -0
  32. package/schemas/intervention.schema.json +27 -0
  33. package/schemas/policy-lock.schema.json +1 -0
  34. package/schemas/policy-snapshot.schema.json +2 -0
  35. package/schemas/trajectory-evaluation.schema.json +64 -0
  36. package/schemas/trajectory-scenario.schema.json +42 -0
  37. package/src/cli.js +94 -0
  38. package/src/commands/action-authorize.js +41 -0
  39. package/src/commands/action-propose.js +10 -0
  40. package/src/commands/action-reconcile.js +10 -0
  41. package/src/commands/action-record.js +47 -0
  42. package/src/commands/action-show.js +10 -0
  43. package/src/commands/action-verify.js +10 -0
  44. package/src/commands/advance.js +7 -2
  45. package/src/commands/approval-request.js +64 -0
  46. package/src/commands/approval-resolve.js +10 -0
  47. package/src/commands/baseline.js +3 -3
  48. package/src/commands/eval.js +6 -0
  49. package/src/commands/history.js +18 -0
  50. package/src/commands/init.js +2 -2
  51. package/src/commands/inspect.js +49 -0
  52. package/src/commands/metrics.js +7 -0
  53. package/src/commands/next.js +8 -2
  54. package/src/commands/policy-discover.js +2 -2
  55. package/src/commands/record-diagnosis.js +37 -1
  56. package/src/commands/record-hypothesis-disposition.js +45 -0
  57. package/src/commands/record-intervention.js +35 -0
  58. package/src/commands/reflect.js +38 -0
  59. package/src/commands/report.js +9 -1
  60. package/src/commands/run-action.js +18 -0
  61. package/src/commands/trace.js +34 -0
  62. package/src/commands/validate-protocol.js +21 -13
  63. package/src/core/action-authorization.js +106 -0
  64. package/src/core/action-constants.js +86 -0
  65. package/src/core/action-execution.js +105 -0
  66. package/src/core/action-ledger-projection.js +302 -0
  67. package/src/core/action-model.js +581 -0
  68. package/src/core/action-readiness.js +141 -0
  69. package/src/core/action-reconciliation-policy.js +49 -0
  70. package/src/core/action-reconciliation.js +66 -0
  71. package/src/core/action-verification.js +111 -0
  72. package/src/core/actions.js +462 -0
  73. package/src/core/approvals.js +405 -0
  74. package/src/core/artifact-registry.js +48 -0
  75. package/src/core/audit.js +25 -0
  76. package/src/core/bundles.js +15 -0
  77. package/src/core/capability-policy.js +226 -0
  78. package/src/core/cli-command-definitions.js +210 -1
  79. package/src/core/command-executors.js +171 -15
  80. package/src/core/command-runtime.js +12 -1
  81. package/src/core/completion-artifacts.js +37 -12
  82. package/src/core/completion-recovery-rebind.js +194 -0
  83. package/src/core/completion.js +70 -0
  84. package/src/core/continuity-reconciliation.js +24 -5
  85. package/src/core/diagnostic-model.js +396 -0
  86. package/src/core/diagnostic-projection.js +51 -0
  87. package/src/core/diagnostic-record.js +360 -0
  88. package/src/core/error-codes.js +343 -0
  89. package/src/core/events.js +41 -1
  90. package/src/core/execution-prerequisites.js +4 -1
  91. package/src/core/execution.js +26 -188
  92. package/src/core/failure-signature.js +70 -0
  93. package/src/core/failure-surface.js +57 -0
  94. package/src/core/history.js +110 -0
  95. package/src/core/hypothesis-projection.js +85 -0
  96. package/src/core/information-gain-projection.js +283 -0
  97. package/src/core/information-gain.js +138 -0
  98. package/src/core/inspect.js +105 -7
  99. package/src/core/integration-invocation-policy.js +47 -0
  100. package/src/core/integration-resources.js +51 -0
  101. package/src/core/next-action-model.js +35 -1
  102. package/src/core/next-action.js +459 -3
  103. package/src/core/phase.js +40 -21
  104. package/src/core/policy-engine.js +113 -6
  105. package/src/core/preflight-consistency.js +31 -5
  106. package/src/core/preflight.js +19 -2
  107. package/src/core/prepared-execution.js +227 -0
  108. package/src/core/progress.js +41 -4
  109. package/src/core/protocol-info.js +48 -0
  110. package/src/core/protocol.js +14 -0
  111. package/src/core/receipt.js +1 -0
  112. package/src/core/reconcile-closure.js +15 -12
  113. package/src/core/reflection.js +305 -0
  114. package/src/core/resumability.js +57 -3
  115. package/src/core/schema-validation.js +8 -0
  116. package/src/core/strategy-analysis.js +97 -0
  117. package/src/core/task-paths.js +28 -0
  118. package/src/core/task-snapshot.js +53 -0
  119. package/src/core/templates.js +8 -0
  120. package/src/core/trace.js +548 -0
  121. package/src/core/trajectory-evaluation.js +71 -0
  122. package/src/core/trajectory-metrics.js +80 -0
  123. package/src/core/transaction.js +8 -0
  124. package/src/core/work-state.js +10 -5
  125. package/docs/assets/forgeloop-flow.svg +0 -1
  126. package/docs/forgeloop-flow.mmd +0 -51
@@ -1,51 +0,0 @@
1
- %% ForgeLoop canonical architecture flow. Render with npm run docs:flow.
2
- %%{init: {"look": "classic", "handDrawnSeed": 1, "flowchart": {"curve": "linear", "htmlLabels": false}}}%%
3
- flowchart LR
4
- classDef entry fill:#1f2937,stroke:#7dd3fc,color:#f8fafc,stroke-width:2px
5
- classDef contract fill:#172554,stroke:#60a5fa,color:#dbeafe,stroke-width:2px
6
- classDef execution fill:#312e81,stroke:#a78bfa,color:#ede9fe,stroke-width:2px
7
- classDef evidence fill:#134e4a,stroke:#5eead4,color:#ccfbf1,stroke-width:2px
8
- classDef recovery fill:#451a03,stroke:#fb923c,color:#ffedd5,stroke-width:2px
9
- classDef terminal fill:#14532d,stroke:#86efac,color:#dcfce7,stroke-width:2px
10
- classDef boundary fill:#3f1d3f,stroke:#f0abfc,color:#fae8ff,stroke-width:2px
11
-
12
- subgraph DISCOVER["1 · Discover and route"]
13
- REQUEST(["Request"]) --> PROFILE["Project profile"]
14
- PROFILE --> CONTRACT["Current contract"]
15
- CONTRACT --> ROUTE["Deterministic route"]
16
- end
17
-
18
- subgraph AUTHORIZE["2 · Authorize execution"]
19
- ROUTE --> GATES["Required gates"]
20
- GATES --> PREFLIGHT["PREFLIGHT_READY"]
21
- PREFLIGHT --> STATE["Resumable work state"]
22
- end
23
-
24
- subgraph VERIFY["3 · Execute and verify"]
25
- STATE --> EXECUTE["Implementation"]
26
- EXECUTE --> CHECKS["run-check / record-check"]
27
- CHECKS --> EVIDENCE["Structured evidence"]
28
- end
29
-
30
- subgraph CLOSE["4 · Review and close"]
31
- EVIDENCE --> REVIEW["Review"]
32
- REVIEW --> COMPLETE["complete / audit"]
33
- COMPLETE --> VALID(["VALID"])
34
- end
35
-
36
- EVIDENCE -->|"failed or incomplete"| DIAGNOSE["Diagnose"]
37
- DIAGNOSE --> CORRECT["Correct"]
38
- CORRECT --> CHECKS
39
- REVIEW -->|"drift detected"| REVALIDATE["Revalidate contract, route, and artifacts"]
40
- REVALIDATE --> PREFLIGHT
41
- EXECUTE -.-> DELEGATE["Optional delegation bundle"]
42
- DELEGATE -.-> EVIDENCE
43
- COMPLETE -->|"INCOMPLETE · STALE · INCONSISTENT · INVALID"| BLOCKED(["Resolve blocker / next cycle"])
44
-
45
- class REQUEST entry
46
- class PROFILE,CONTRACT,ROUTE,GATES,PREFLIGHT,STATE contract
47
- class EXECUTE,CHECKS execution
48
- class EVIDENCE,REVIEW evidence
49
- class DIAGNOSE,CORRECT,REVALIDATE recovery
50
- class COMPLETE,VALID terminal
51
- class DELEGATE,BLOCKED boundary