@cassiomc1/forgeloop 1.6.4 → 1.7.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 (73) hide show
  1. package/AGENT_COMPATIBILITY.md +11 -0
  2. package/DOCS_INDEX.md +1 -0
  3. package/GUIDE_ROUTER.md +26 -1
  4. package/LOOP_ENGINEERING.md +48 -0
  5. package/ORCHESTRATOR_INTEGRATION.md +38 -0
  6. package/PROTOCOL_INTEGRATION.md +62 -0
  7. package/README.md +25 -0
  8. package/benchmarks/execution-profiles/README.md +44 -0
  9. package/benchmarks/execution-profiles/api-feature.json +18 -0
  10. package/benchmarks/execution-profiles/authentication-change.json +18 -0
  11. package/benchmarks/execution-profiles/documentation-correction.json +18 -0
  12. package/benchmarks/execution-profiles/infrastructure-release.json +18 -0
  13. package/benchmarks/execution-profiles/novatask-saas-landing-page.json +36 -0
  14. package/benchmarks/execution-profiles/small-bug-fix.json +18 -0
  15. package/benchmarks/execution-profiles/static-landing-page.json +18 -0
  16. package/completions/_forgeloop +6 -4
  17. package/completions/forgeloop.bash +8 -4
  18. package/completions/forgeloop.fish +24 -1
  19. package/docs/AGENT_PROTOCOL_SUMMARY.md +45 -1
  20. package/docs/ARTIFACT_REFERENCE.md +53 -7
  21. package/docs/CLI_REFERENCE.md +83 -1
  22. package/docs/EXECUTION_PROFILE_BENCHMARKS.md +208 -0
  23. package/docs/GETTING_STARTED.md +28 -0
  24. package/docs/MCP.md +6 -0
  25. package/docs/RELEASE_CHECKLIST.md +4 -0
  26. package/docs/TROUBLESHOOTING.md +6 -0
  27. package/docs/UNIVERSAL_INTEGRATION.md +58 -0
  28. package/package.json +14 -2
  29. package/schemas/config.schema.json +1 -0
  30. package/schemas/execution-profile-benchmark-aggregate.schema.json +43 -0
  31. package/schemas/execution-profile-benchmark-run.schema.json +106 -0
  32. package/schemas/execution-profile-benchmark-scenario.schema.json +66 -0
  33. package/schemas/routing-result.schema.json +12 -0
  34. package/schemas/usage.schema.json +30 -0
  35. package/scripts/check-efficiency-regression.mjs +99 -0
  36. package/scripts/generate-agent-protocol-summary.mjs +35 -0
  37. package/scripts/lib/execution-profile-benchmark-io.mjs +67 -0
  38. package/scripts/run-execution-profile-benchmarks.mjs +265 -0
  39. package/scripts/summarize-execution-profile-benchmarks.mjs +84 -0
  40. package/scripts/validate-execution-profile-benchmarks.mjs +120 -0
  41. package/src/cli.js +16 -4
  42. package/src/commands/efficiency.js +12 -0
  43. package/src/commands/eval.js +8 -2
  44. package/src/commands/metrics.js +2 -2
  45. package/src/commands/next.js +26 -2
  46. package/src/commands/route.js +20 -2
  47. package/src/commands/task-show.js +31 -2
  48. package/src/commands/usage-record.js +61 -0
  49. package/src/core/artifact-registry.js +12 -0
  50. package/src/core/cli-command-definitions.js +27 -0
  51. package/src/core/command-executors.js +29 -5
  52. package/src/core/command-input.js +34 -0
  53. package/src/core/config.js +9 -0
  54. package/src/core/efficiency.js +197 -0
  55. package/src/core/error-codes.js +18 -0
  56. package/src/core/execution-profile-benchmarks.js +674 -0
  57. package/src/core/execution-profile-context.js +177 -0
  58. package/src/core/execution-profile.js +248 -0
  59. package/src/core/integration-invocation-policy.js +43 -0
  60. package/src/core/integration-resources.js +22 -1
  61. package/src/core/protocol-info.js +42 -0
  62. package/src/core/resumability.js +27 -1
  63. package/src/core/router.js +23 -1
  64. package/src/core/runtime-context.js +11 -0
  65. package/src/core/schema-validation.js +4 -0
  66. package/src/core/task-paths.js +2 -0
  67. package/src/core/templates.js +4 -0
  68. package/src/core/trace.js +1 -0
  69. package/src/core/trajectory-evaluation.js +2 -2
  70. package/src/core/trajectory-metrics.js +18 -2
  71. package/src/core/usage.js +137 -0
  72. package/src/integration.d.ts +84 -0
  73. package/src/integration.js +14 -0
@@ -77,6 +77,12 @@ export const E_ATTESTATION_TARGET_REF_INVALID = "E_ATTESTATION_TARGET_REF_INVALI
77
77
  export const E_ATTESTATION_INVALID = "E_ATTESTATION_INVALID";
78
78
  export const E_ATTESTATION_CONFIGURATION_INVALID = "E_ATTESTATION_CONFIGURATION_INVALID";
79
79
  export const E_CLI_INVOCATION_INVALID = "E_CLI_INVOCATION_INVALID";
80
+ export const E_EXECUTION_PROFILE_INVALID = "E_EXECUTION_PROFILE_INVALID";
81
+ export const E_EXECUTION_PROFILE_INCONSISTENT = "E_EXECUTION_PROFILE_INCONSISTENT";
82
+ export const E_EXECUTION_PROFILE_SAFETY_FLOOR_INVALID = "E_EXECUTION_PROFILE_SAFETY_FLOOR_INVALID";
83
+ export const E_USAGE_INVALID = "E_USAGE_INVALID";
84
+ export const E_USAGE_SOURCE_INVALID = "E_USAGE_SOURCE_INVALID";
85
+ export const E_EFFICIENCY_BASELINE_INVALID = "E_EFFICIENCY_BASELINE_INVALID";
80
86
 
81
87
  const EXTENSION_PUBLIC_ERROR_CODES = Object.freeze(Object.fromEntries([
82
88
  E_WORKSPACE_IDENTITY_UNAVAILABLE,
@@ -124,6 +130,12 @@ const EXTENSION_PUBLIC_ERROR_CODES = Object.freeze(Object.fromEntries([
124
130
  E_ATTESTATION_INVALID,
125
131
  E_ATTESTATION_CONFIGURATION_INVALID,
126
132
  E_CLI_INVOCATION_INVALID,
133
+ E_EXECUTION_PROFILE_INVALID,
134
+ E_EXECUTION_PROFILE_INCONSISTENT,
135
+ E_EXECUTION_PROFILE_SAFETY_FLOOR_INVALID,
136
+ E_USAGE_INVALID,
137
+ E_USAGE_SOURCE_INVALID,
138
+ E_EFFICIENCY_BASELINE_INVALID,
127
139
  ].map((code) => [code, Object.freeze({
128
140
  code,
129
141
  category: code.slice(2).split("_")[0].toLowerCase(),
@@ -1026,6 +1038,12 @@ export const ALL_KNOWN_ERROR_CODES = Object.freeze(new Set([
1026
1038
  E_ATTESTATION_INVALID,
1027
1039
  E_ATTESTATION_CONFIGURATION_INVALID,
1028
1040
  E_CLI_INVOCATION_INVALID,
1041
+ E_EXECUTION_PROFILE_INVALID,
1042
+ E_EXECUTION_PROFILE_INCONSISTENT,
1043
+ E_EXECUTION_PROFILE_SAFETY_FLOOR_INVALID,
1044
+ E_USAGE_INVALID,
1045
+ E_USAGE_SOURCE_INVALID,
1046
+ E_EFFICIENCY_BASELINE_INVALID,
1029
1047
  E_RECONCILE_NOT_STALE,
1030
1048
  E_RECONCILE_PHASE_INVALID,
1031
1049
  E_RECONCILE_UNSUPPORTED_DRIFT,