@hassangameryt/freeflow 0.1.0 → 0.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 (630) hide show
  1. package/.agents/plugins/marketplace.json +1 -1
  2. package/.claude-plugin/marketplace.json +2 -2
  3. package/{plugins/freeflow/.claude-plugin → .claude-plugin}/plugin.json +1 -1
  4. package/{plugins/freeflow/.codex-plugin → .codex-plugin}/plugin.json +1 -1
  5. package/README.md +25 -16
  6. package/assets/freeflow-plugin-icon.png +0 -0
  7. package/{plugins/freeflow/command-surface.json → command-surface.json} +10 -10
  8. package/evals/README.md +32 -0
  9. package/evals/fixtures/copy-conventions.md +31 -0
  10. package/evals/fixtures/output-router/README.md +12 -0
  11. package/evals/fixtures/output-router/failed-command-output.txt +9 -0
  12. package/evals/fixtures/output-router/large-router-manual.md +63 -0
  13. package/evals/fixtures/output-router/native-large-output.txt +40 -0
  14. package/evals/fixtures/output-router/noisy-test-output.txt +30 -0
  15. package/evals/fixtures/output-router/verification-output.txt +8 -0
  16. package/evals/fixtures/tiny-artifact-review-app/README.md +5 -0
  17. package/evals/fixtures/tiny-artifact-review-app/docs/billing-policy.md +10 -0
  18. package/evals/fixtures/tiny-artifact-review-app/docs/specs/billing-webhook-api-draft.md +21 -0
  19. package/evals/fixtures/tiny-artifact-review-app/docs/specs/failed-payment-grace-period.md +24 -0
  20. package/evals/fixtures/tiny-artifact-review-app/docs/specs/immediate-downgrade.md +17 -0
  21. package/evals/fixtures/tiny-artifact-review-app/tests/billing.test.md +8 -0
  22. package/evals/fixtures/tiny-commit-ambiguous-app/.freeflow-eval-setup.sh +15 -0
  23. package/evals/fixtures/tiny-commit-ambiguous-app/README.md +3 -0
  24. package/evals/fixtures/tiny-commit-ambiguous-app/src/billing.ts +5 -0
  25. package/evals/fixtures/tiny-commit-ambiguous-app/src/settings-page.ts +1 -0
  26. package/evals/fixtures/tiny-commit-ambiguous-app/tests/settings.test.md +5 -0
  27. package/evals/fixtures/tiny-commit-app/.freeflow-eval-setup.sh +14 -0
  28. package/evals/fixtures/tiny-commit-app/README.md +3 -0
  29. package/evals/fixtures/tiny-commit-app/docs/specs/settings-title.md +5 -0
  30. package/evals/fixtures/tiny-commit-app/src/billing.ts +5 -0
  31. package/evals/fixtures/tiny-commit-app/src/settings-page.ts +1 -0
  32. package/evals/fixtures/tiny-commit-app/tests/settings.test.md +5 -0
  33. package/evals/fixtures/tiny-commit-everything-app/.freeflow-eval-setup.sh +15 -0
  34. package/evals/fixtures/tiny-commit-everything-app/README.md +3 -0
  35. package/evals/fixtures/tiny-commit-everything-app/docs/specs/settings-title.md +5 -0
  36. package/evals/fixtures/tiny-commit-everything-app/src/billing.ts +5 -0
  37. package/evals/fixtures/tiny-commit-everything-app/src/settings-page.ts +1 -0
  38. package/evals/fixtures/tiny-commit-everything-app/tests/settings.test.md +5 -0
  39. package/evals/fixtures/tiny-commit-staged-app/.freeflow-eval-setup.sh +15 -0
  40. package/evals/fixtures/tiny-commit-staged-app/README.md +3 -0
  41. package/evals/fixtures/tiny-commit-staged-app/docs/specs/settings-title.md +5 -0
  42. package/evals/fixtures/tiny-commit-staged-app/src/billing.ts +5 -0
  43. package/evals/fixtures/tiny-commit-staged-app/src/settings-page.ts +1 -0
  44. package/evals/fixtures/tiny-commit-staged-app/tests/settings.test.md +5 -0
  45. package/evals/fixtures/tiny-commit-staged-mixed-app/.freeflow-eval-setup.sh +15 -0
  46. package/evals/fixtures/tiny-commit-staged-mixed-app/README.md +3 -0
  47. package/evals/fixtures/tiny-commit-staged-mixed-app/docs/billing-policy.md +3 -0
  48. package/evals/fixtures/tiny-commit-staged-mixed-app/docs/release-notes.md +3 -0
  49. package/evals/fixtures/tiny-commit-staged-mixed-app/src/billing.ts +5 -0
  50. package/evals/fixtures/tiny-dashboard-stale-app/README.md +11 -0
  51. package/evals/fixtures/tiny-dashboard-stale-app/src/api-client.ts +13 -0
  52. package/evals/fixtures/tiny-dashboard-stale-app/src/dashboard-data.ts +19 -0
  53. package/evals/fixtures/tiny-dashboard-stale-app/tests/dashboard-data.test.md +9 -0
  54. package/evals/fixtures/tiny-decision-destination-app/README.md +6 -0
  55. package/evals/fixtures/tiny-decision-destination-app/src/risk.ts +8 -0
  56. package/evals/fixtures/tiny-decision-destination-app/tests/risk.test.md +4 -0
  57. package/evals/fixtures/tiny-design-depth-app/README.md +15 -0
  58. package/evals/fixtures/tiny-design-depth-app/src/routes.ts +25 -0
  59. package/evals/fixtures/tiny-design-depth-app/src/sendEmail.ts +3 -0
  60. package/evals/fixtures/tiny-design-depth-app/src/sendSms.ts +3 -0
  61. package/evals/fixtures/tiny-design-depth-app/src/telemetry.ts +3 -0
  62. package/evals/fixtures/tiny-design-depth-app/tests/routes.test.md +12 -0
  63. package/evals/fixtures/tiny-eval-method-app/README.md +8 -0
  64. package/evals/fixtures/tiny-eval-method-app/evals/reports/review-pr-eval-result.md +5 -0
  65. package/evals/fixtures/tiny-eval-method-app/evals/reports/triage-question-failure.md +17 -0
  66. package/evals/fixtures/tiny-eval-method-app/evals/runs/review-pr-with-skill-output.diff +11 -0
  67. package/evals/fixtures/tiny-eval-method-app/evals/runs/review-pr-with-skill-output.md +3 -0
  68. package/evals/fixtures/tiny-eval-method-app/skills/review-pr/SKILL.md +10 -0
  69. package/evals/fixtures/tiny-eval-method-app/skills/triage-question/SKILL.md +10 -0
  70. package/evals/fixtures/tiny-execute-plan-app/README.md +5 -0
  71. package/evals/fixtures/tiny-execute-plan-app/checks/settings-and-billing-check.sh +5 -0
  72. package/evals/fixtures/tiny-execute-plan-app/docs/billing-policy.md +10 -0
  73. package/evals/fixtures/tiny-execute-plan-app/docs/plans/immediate-downgrade-plan.md +11 -0
  74. package/evals/fixtures/tiny-execute-plan-app/docs/plans/settings-title-plan.md +12 -0
  75. package/evals/fixtures/tiny-execute-plan-app/docs/plans/settings-title-with-bad-check.md +15 -0
  76. package/evals/fixtures/tiny-execute-plan-app/docs/plans/unverified-billing-plan.md +9 -0
  77. package/evals/fixtures/tiny-execute-plan-app/docs/specs/failed-payment-grace-period.md +9 -0
  78. package/evals/fixtures/tiny-execute-plan-app/docs/specs/settings-title.md +9 -0
  79. package/evals/fixtures/tiny-execute-plan-app/src/billing.ts +7 -0
  80. package/evals/fixtures/tiny-execute-plan-app/src/settings-page.ts +1 -0
  81. package/evals/fixtures/tiny-execute-plan-app/tests/billing.test.md +7 -0
  82. package/evals/fixtures/tiny-execute-plan-app/tests/settings.test.md +5 -0
  83. package/evals/fixtures/tiny-execute-review-loop-app/README.md +5 -0
  84. package/evals/fixtures/tiny-execute-review-loop-app/docs/billing-policy.md +9 -0
  85. package/evals/fixtures/tiny-execute-review-loop-app/docs/plans/settings-title-plan.md +12 -0
  86. package/evals/fixtures/tiny-execute-review-loop-app/docs/review/previous-agent-summary.md +15 -0
  87. package/evals/fixtures/tiny-execute-review-loop-app/docs/review/review-pass-1-non-pass.md +11 -0
  88. package/evals/fixtures/tiny-execute-review-loop-app/docs/specs/settings-title.md +9 -0
  89. package/evals/fixtures/tiny-execute-review-loop-app/src/billing.ts +7 -0
  90. package/evals/fixtures/tiny-execute-review-loop-app/src/settings-page.ts +1 -0
  91. package/evals/fixtures/tiny-execute-review-loop-app/tests/billing.test.md +7 -0
  92. package/evals/fixtures/tiny-execute-review-loop-app/tests/settings.test.md +5 -0
  93. package/evals/fixtures/tiny-flaky-session-app/README.md +10 -0
  94. package/evals/fixtures/tiny-flaky-session-app/src/session-timeout.ts +13 -0
  95. package/evals/fixtures/tiny-flaky-session-app/tests/session-timeout.test.md +8 -0
  96. package/evals/fixtures/tiny-handoff-app/README.md +5 -0
  97. package/evals/fixtures/tiny-handoff-app/docs/billing-policy.md +10 -0
  98. package/evals/fixtures/tiny-handoff-app/docs/handoffs/old-agent-handoff.md +8 -0
  99. package/evals/fixtures/tiny-handoff-app/docs/plans/billing-retry-plan.md +11 -0
  100. package/evals/fixtures/tiny-handoff-app/src/billing.ts +7 -0
  101. package/evals/fixtures/tiny-handoff-report-app/README.md +3 -0
  102. package/evals/fixtures/tiny-handoff-report-app/evals/runs/handoff-3/hof-003/with-skill-output.diff +1 -0
  103. package/evals/fixtures/tiny-handoff-report-app/evals/runs/handoff-3/hof-003/with-skill-output.md +1 -0
  104. package/evals/fixtures/tiny-handoff-report-app/evals/scores/hof-003-score.txt +4 -0
  105. package/evals/fixtures/tiny-plan-app/README.md +5 -0
  106. package/evals/fixtures/tiny-plan-app/docs/billing-policy.md +10 -0
  107. package/evals/fixtures/tiny-plan-app/docs/specs/failed-payment-grace-period.md +25 -0
  108. package/evals/fixtures/tiny-plan-app/src/billing.ts +17 -0
  109. package/evals/fixtures/tiny-plan-app/src/settings-page.ts +1 -0
  110. package/evals/fixtures/tiny-plan-app/tests/billing.test.md +8 -0
  111. package/evals/fixtures/tiny-plan-app/tests/settings.test.md +5 -0
  112. package/evals/fixtures/tiny-plan-strict-api-app/README.md +3 -0
  113. package/evals/fixtures/tiny-plan-strict-api-app/docs/billing-policy.md +5 -0
  114. package/evals/fixtures/tiny-plan-strict-api-app/docs/specs/billing-webhook-api.md +25 -0
  115. package/evals/fixtures/tiny-plan-strict-api-app/src/billing.ts +5 -0
  116. package/evals/fixtures/tiny-plan-strict-api-app/src/webhooks.ts +3 -0
  117. package/evals/fixtures/tiny-plan-strict-api-app/tests/billing-webhook.test.md +8 -0
  118. package/evals/fixtures/tiny-post-setup-invalid-config-app/.freeflow/config.json +3 -0
  119. package/evals/fixtures/tiny-post-setup-invalid-config-app/AGENTS.md +15 -0
  120. package/evals/fixtures/tiny-post-setup-invalid-config-app/README.md +16 -0
  121. package/evals/fixtures/tiny-post-setup-invalid-config-app/docs/auth-review.md +15 -0
  122. package/evals/fixtures/tiny-post-setup-invalid-config-app/docs/billing-policy.md +10 -0
  123. package/evals/fixtures/tiny-post-setup-invalid-config-app/docs/copy-conventions.md +15 -0
  124. package/evals/fixtures/tiny-post-setup-invalid-config-app/src/auth-middleware.ts +12 -0
  125. package/evals/fixtures/tiny-post-setup-invalid-config-app/src/billing.ts +20 -0
  126. package/evals/fixtures/tiny-post-setup-invalid-config-app/src/login-copy.ts +1 -0
  127. package/evals/fixtures/tiny-post-setup-invalid-config-app/src/settings-page.ts +1 -0
  128. package/evals/fixtures/tiny-post-setup-invalid-config-app/tests/auth-middleware.test.md +8 -0
  129. package/evals/fixtures/tiny-post-setup-invalid-config-app/tests/billing.test.md +8 -0
  130. package/evals/fixtures/tiny-post-setup-invalid-config-app/tests/copy.test.md +7 -0
  131. package/evals/fixtures/tiny-post-setup-missing-config-app/AGENTS.md +15 -0
  132. package/evals/fixtures/tiny-post-setup-missing-config-app/README.md +16 -0
  133. package/evals/fixtures/tiny-post-setup-missing-config-app/docs/auth-review.md +15 -0
  134. package/evals/fixtures/tiny-post-setup-missing-config-app/docs/billing-policy.md +10 -0
  135. package/evals/fixtures/tiny-post-setup-missing-config-app/docs/copy-conventions.md +15 -0
  136. package/evals/fixtures/tiny-post-setup-missing-config-app/src/auth-middleware.ts +12 -0
  137. package/evals/fixtures/tiny-post-setup-missing-config-app/src/billing.ts +20 -0
  138. package/evals/fixtures/tiny-post-setup-missing-config-app/src/login-copy.ts +1 -0
  139. package/evals/fixtures/tiny-post-setup-missing-config-app/src/settings-page.ts +1 -0
  140. package/evals/fixtures/tiny-post-setup-missing-config-app/tests/auth-middleware.test.md +8 -0
  141. package/evals/fixtures/tiny-post-setup-missing-config-app/tests/billing.test.md +8 -0
  142. package/evals/fixtures/tiny-post-setup-missing-config-app/tests/copy.test.md +7 -0
  143. package/evals/fixtures/tiny-post-setup-source-conflict-app/.freeflow/config.json +3 -0
  144. package/evals/fixtures/tiny-post-setup-source-conflict-app/AGENTS.md +15 -0
  145. package/evals/fixtures/tiny-post-setup-source-conflict-app/README.md +16 -0
  146. package/evals/fixtures/tiny-post-setup-source-conflict-app/docs/auth-review.md +15 -0
  147. package/evals/fixtures/tiny-post-setup-source-conflict-app/docs/billing-policy.md +10 -0
  148. package/evals/fixtures/tiny-post-setup-source-conflict-app/docs/copy-conventions.md +15 -0
  149. package/evals/fixtures/tiny-post-setup-source-conflict-app/src/auth-middleware.ts +12 -0
  150. package/evals/fixtures/tiny-post-setup-source-conflict-app/src/billing.ts +20 -0
  151. package/evals/fixtures/tiny-post-setup-source-conflict-app/src/login-copy.ts +1 -0
  152. package/evals/fixtures/tiny-post-setup-source-conflict-app/src/settings-page.ts +1 -0
  153. package/evals/fixtures/tiny-post-setup-source-conflict-app/tests/auth-middleware.test.md +8 -0
  154. package/evals/fixtures/tiny-post-setup-source-conflict-app/tests/billing.test.md +8 -0
  155. package/evals/fixtures/tiny-post-setup-source-conflict-app/tests/copy.test.md +7 -0
  156. package/evals/fixtures/tiny-report-performance-app/README.md +11 -0
  157. package/evals/fixtures/tiny-report-performance-app/docs/performance.md +10 -0
  158. package/evals/fixtures/tiny-report-performance-app/src/report-summary.ts +29 -0
  159. package/evals/fixtures/tiny-report-performance-app/tests/report-performance.test.md +8 -0
  160. package/evals/fixtures/tiny-review-request-app/README.md +3 -0
  161. package/evals/fixtures/tiny-review-request-app/docs/billing-policy.md +5 -0
  162. package/evals/fixtures/tiny-review-request-app/docs/plans/billing-webhook-api.md +19 -0
  163. package/evals/fixtures/tiny-review-request-app/docs/review/previous-agent-summary.md +20 -0
  164. package/evals/fixtures/tiny-review-request-app/docs/specs/billing-webhook-api.md +25 -0
  165. package/evals/fixtures/tiny-review-request-app/src/billing.ts +11 -0
  166. package/evals/fixtures/tiny-review-request-app/src/webhooks.ts +19 -0
  167. package/evals/fixtures/tiny-review-request-app/tests/billing-webhook.test.md +8 -0
  168. package/evals/fixtures/tiny-review-work-app/README.md +5 -0
  169. package/evals/fixtures/tiny-review-work-app/docs/billing-policy.md +9 -0
  170. package/evals/fixtures/tiny-review-work-app/docs/plans/settings-title-plan.md +12 -0
  171. package/evals/fixtures/tiny-review-work-app/docs/review/previous-agent-summary.md +15 -0
  172. package/evals/fixtures/tiny-review-work-app/docs/specs/settings-title.md +9 -0
  173. package/evals/fixtures/tiny-review-work-app/src/billing.ts +7 -0
  174. package/evals/fixtures/tiny-review-work-app/src/settings-page.ts +1 -0
  175. package/evals/fixtures/tiny-review-work-app/tests/billing.test.md +7 -0
  176. package/evals/fixtures/tiny-review-work-app/tests/settings.test.md +5 -0
  177. package/evals/fixtures/tiny-saas-app/README.md +16 -0
  178. package/evals/fixtures/tiny-saas-app/docs/auth-review.md +15 -0
  179. package/evals/fixtures/tiny-saas-app/docs/billing-policy.md +10 -0
  180. package/evals/fixtures/tiny-saas-app/docs/copy-conventions.md +15 -0
  181. package/evals/fixtures/tiny-saas-app/docs/specs/settings-title.md +13 -0
  182. package/evals/fixtures/tiny-saas-app/src/auth-middleware.ts +12 -0
  183. package/evals/fixtures/tiny-saas-app/src/billing.ts +20 -0
  184. package/evals/fixtures/tiny-saas-app/src/login-copy.ts +1 -0
  185. package/evals/fixtures/tiny-saas-app/src/settings-page.ts +1 -0
  186. package/evals/fixtures/tiny-saas-app/tests/auth-middleware.test.md +8 -0
  187. package/evals/fixtures/tiny-saas-app/tests/billing.test.md +8 -0
  188. package/evals/fixtures/tiny-saas-app/tests/copy.test.md +7 -0
  189. package/evals/fixtures/tiny-setup-agents-app/AGENTS.md +6 -0
  190. package/evals/fixtures/tiny-setup-both-app/AGENTS.md +5 -0
  191. package/evals/fixtures/tiny-setup-both-app/CLAUDE.md +5 -0
  192. package/evals/fixtures/tiny-setup-claude-app/CLAUDE.md +6 -0
  193. package/evals/fixtures/tiny-setup-codex-rules-app/.codex/rules/shell.rules +5 -0
  194. package/evals/fixtures/tiny-setup-codex-rules-app/AGENTS.md +6 -0
  195. package/evals/fixtures/tiny-setup-conflict-app/AGENTS.md +6 -0
  196. package/evals/fixtures/tiny-setup-existing-block-app/AGENTS.md +14 -0
  197. package/evals/fixtures/tiny-setup-four-rules-app/CLAUDE.md +6 -0
  198. package/evals/fixtures/tiny-skill-dev-app/README.md +10 -0
  199. package/evals/fixtures/tiny-skill-dev-app/evals/prompts/review-pr-001.txt +8 -0
  200. package/evals/fixtures/tiny-skill-dev-app/evals/reports/review-pr-failure.md +17 -0
  201. package/evals/fixtures/tiny-skill-dev-app/skills/review-pr/SKILL.md +13 -0
  202. package/evals/fixtures/tiny-team-app/README.md +5 -0
  203. package/evals/fixtures/tiny-team-app/docs/product.md +6 -0
  204. package/evals/fixtures/tiny-team-app/src/teams.ts +9 -0
  205. package/evals/fixtures/tiny-team-app/src/users.ts +5 -0
  206. package/evals/fixtures/tiny-team-app/tests/teams.test.md +7 -0
  207. package/evals/fixtures/tiny-verify-app/README.md +5 -0
  208. package/evals/fixtures/tiny-verify-app/src/settings-nav.ts +1 -0
  209. package/evals/fixtures/tiny-verify-app/src/settings-page.ts +1 -0
  210. package/evals/fixtures/tiny-verify-app/tests/settings.test.md +7 -0
  211. package/evals/prompts/aon-001.txt +2 -0
  212. package/evals/prompts/byp-001.txt +2 -0
  213. package/evals/prompts/byp-002.txt +2 -0
  214. package/evals/prompts/cap-001.txt +3 -0
  215. package/evals/prompts/cap-002.txt +3 -0
  216. package/evals/prompts/cmd-001.txt +3 -0
  217. package/evals/prompts/cmd-002.txt +3 -0
  218. package/evals/prompts/cmd-003.txt +6 -0
  219. package/evals/prompts/cmd-004.txt +5 -0
  220. package/evals/prompts/cmd-005.txt +5 -0
  221. package/evals/prompts/cmd-006.txt +5 -0
  222. package/evals/prompts/cmd-007.txt +5 -0
  223. package/evals/prompts/cmd-008.txt +5 -0
  224. package/evals/prompts/cmd-009.txt +8 -0
  225. package/evals/prompts/cmd-010.txt +5 -0
  226. package/evals/prompts/cmd-011.txt +5 -0
  227. package/evals/prompts/cmd-012.txt +5 -0
  228. package/evals/prompts/cmd-013.txt +5 -0
  229. package/evals/prompts/cmd-014.txt +7 -0
  230. package/evals/prompts/cmd-015.txt +7 -0
  231. package/evals/prompts/cmd-016.txt +5 -0
  232. package/evals/prompts/cmt-001.txt +1 -0
  233. package/evals/prompts/cmt-002.txt +1 -0
  234. package/evals/prompts/cmt-003.txt +1 -0
  235. package/evals/prompts/cmt-004.txt +1 -0
  236. package/evals/prompts/cmt-005.txt +1 -0
  237. package/evals/prompts/dfd-001.txt +3 -0
  238. package/evals/prompts/dia-001.txt +3 -0
  239. package/evals/prompts/dia-002.txt +3 -0
  240. package/evals/prompts/dia-003.txt +3 -0
  241. package/evals/prompts/dis-001.txt +5 -0
  242. package/evals/prompts/dis-002.txt +5 -0
  243. package/evals/prompts/esk-001.txt +5 -0
  244. package/evals/prompts/esk-002.txt +5 -0
  245. package/evals/prompts/esk-003.txt +5 -0
  246. package/evals/prompts/grc-001.txt +3 -0
  247. package/evals/prompts/hof-001.txt +3 -0
  248. package/evals/prompts/hof-002.txt +1 -0
  249. package/evals/prompts/hof-003.txt +1 -0
  250. package/evals/prompts/hof-004.txt +1 -0
  251. package/evals/prompts/hof-005.txt +1 -0
  252. package/evals/prompts/ivg-001.txt +1 -0
  253. package/evals/prompts/ivg-002.txt +11 -0
  254. package/evals/prompts/ivg-003.txt +1 -0
  255. package/evals/prompts/ivg-004.txt +1 -0
  256. package/evals/prompts/mode-001.txt +3 -0
  257. package/evals/prompts/mode-002.txt +1 -0
  258. package/evals/prompts/mode-003.txt +3 -0
  259. package/evals/prompts/mode-004.txt +3 -0
  260. package/evals/prompts/mode-005.txt +3 -0
  261. package/evals/prompts/mode-006.txt +3 -0
  262. package/evals/prompts/mode-007.txt +3 -0
  263. package/evals/prompts/otr-001.txt +3 -0
  264. package/evals/prompts/otr-002.txt +3 -0
  265. package/evals/prompts/rar-001.txt +5 -0
  266. package/evals/prompts/rar-002.txt +3 -0
  267. package/evals/prompts/rar-003.txt +6 -0
  268. package/evals/prompts/rar-004.txt +15 -0
  269. package/evals/prompts/rar-005.txt +10 -0
  270. package/evals/prompts/rbr-001.txt +3 -0
  271. package/evals/prompts/rbr-002.txt +3 -0
  272. package/evals/prompts/rbr-003.txt +7 -0
  273. package/evals/prompts/rev-001.txt +3 -0
  274. package/evals/prompts/rev-002.txt +5 -0
  275. package/evals/prompts/rev-003.txt +6 -0
  276. package/evals/prompts/rev-004.txt +1 -0
  277. package/evals/prompts/rev-005.txt +15 -0
  278. package/evals/prompts/rev-006.txt +5 -0
  279. package/evals/prompts/stp-001.txt +1 -0
  280. package/evals/prompts/stp-002.txt +1 -0
  281. package/evals/prompts/stp-003.txt +1 -0
  282. package/evals/prompts/stp-004.txt +1 -0
  283. package/evals/prompts/stp-005.txt +1 -0
  284. package/evals/prompts/stp-006.txt +1 -0
  285. package/evals/prompts/stp-007.txt +1 -0
  286. package/evals/prompts/stp-008.txt +1 -0
  287. package/evals/prompts/stp-009.txt +1 -0
  288. package/evals/prompts/stp-010.txt +1 -0
  289. package/evals/prompts/stp-011.txt +1 -0
  290. package/evals/prompts/vfy-003.txt +1 -0
  291. package/evals/prompts/wpl-001.txt +3 -0
  292. package/evals/prompts/wpl-002.txt +5 -0
  293. package/evals/prompts/wpl-003.txt +3 -0
  294. package/evals/prompts/wpl-004.txt +5 -0
  295. package/evals/prompts/wpl-005.txt +1 -0
  296. package/evals/prompts/wrc-001.txt +10 -0
  297. package/evals/prompts/wrc-002.txt +3 -0
  298. package/evals/prompts/wsk-001.txt +6 -0
  299. package/evals/prompts/wsp-001.txt +5 -0
  300. package/evals/prompts/wsp-002.txt +15 -0
  301. package/evals/prompts/wsp-003.txt +3 -0
  302. package/evals/prompts/wsp-004.txt +15 -0
  303. package/evals/prompts/wsp-005.txt +5 -0
  304. package/evals/prompts/wsp-006.txt +12 -0
  305. package/evals/prompts/wsp-007.txt +9 -0
  306. package/evals/prompts/wsp-008.txt +13 -0
  307. package/evals/prompts/xpl-001.txt +1 -0
  308. package/evals/prompts/xpl-002.txt +3 -0
  309. package/evals/prompts/xpl-003.txt +3 -0
  310. package/evals/prompts/xpl-004.txt +3 -0
  311. package/evals/prompts/xpl-005.txt +5 -0
  312. package/evals/prompts/xpl-006.txt +3 -0
  313. package/evals/registries/adversarial-evals.json +39 -0
  314. package/evals/registries/fixture-evals.json +2513 -0
  315. package/evals/registries/handoff-evals.json +74 -0
  316. package/evals/registries/legacy-evals.json +147 -0
  317. package/evals/registries/skill-evidence.json +193 -0
  318. package/evals/registries/verify-work-evals.json +46 -0
  319. package/evals/reports/acceptance/v0.1-acceptance-report.md +130 -0
  320. package/evals/reports/by-command-surface/command-surface-1-report.md +45 -0
  321. package/evals/reports/by-command-surface/command-surface-10-report.md +76 -0
  322. package/evals/reports/by-command-surface/command-surface-11-report.md +77 -0
  323. package/evals/reports/by-command-surface/command-surface-12-report.md +91 -0
  324. package/evals/reports/by-command-surface/command-surface-13-report.md +64 -0
  325. package/evals/reports/by-command-surface/command-surface-14-report.md +66 -0
  326. package/evals/reports/by-command-surface/command-surface-15-report.md +124 -0
  327. package/evals/reports/by-command-surface/command-surface-16-report.md +39 -0
  328. package/evals/reports/by-command-surface/command-surface-2-report.md +80 -0
  329. package/evals/reports/by-command-surface/command-surface-3-report.md +86 -0
  330. package/evals/reports/by-command-surface/command-surface-4-report.md +76 -0
  331. package/evals/reports/by-command-surface/command-surface-5-report.md +80 -0
  332. package/evals/reports/by-command-surface/command-surface-6-report.md +74 -0
  333. package/evals/reports/by-command-surface/command-surface-7-report.md +84 -0
  334. package/evals/reports/by-command-surface/command-surface-8-report.md +79 -0
  335. package/evals/reports/by-command-surface/command-surface-9-report.md +79 -0
  336. package/evals/reports/by-command-surface/command-surface-matrix.md +91 -0
  337. package/evals/reports/by-skill/bypass-1-report.md +124 -0
  338. package/evals/reports/by-skill/capture-decisions-1-report.md +99 -0
  339. package/evals/reports/by-skill/capture-decisions-2-report.md +102 -0
  340. package/evals/reports/by-skill/commit-work-1-report.md +165 -0
  341. package/evals/reports/by-skill/commit-work-2-report.md +109 -0
  342. package/evals/reports/by-skill/design-for-depth-1-report.md +95 -0
  343. package/evals/reports/by-skill/diagnose-failure-1-report.md +91 -0
  344. package/evals/reports/by-skill/diagnose-failure-2-report.md +94 -0
  345. package/evals/reports/by-skill/discover-1-report.md +118 -0
  346. package/evals/reports/by-skill/evaluate-skill-2-report.md +71 -0
  347. package/evals/reports/by-skill/execute-plan-1-report.md +103 -0
  348. package/evals/reports/by-skill/execute-plan-2-report.md +112 -0
  349. package/evals/reports/by-skill/execute-plan-3-report.md +87 -0
  350. package/evals/reports/by-skill/grill-context-1-report.md +103 -0
  351. package/evals/reports/by-skill/handoff-1-report.md +123 -0
  352. package/evals/reports/by-skill/handoff-2-report.md +105 -0
  353. package/evals/reports/by-skill/handoff-3-report.md +100 -0
  354. package/evals/reports/by-skill/handoff-7-report.md +77 -0
  355. package/evals/reports/by-skill/interview-gate-1-report.md +63 -0
  356. package/evals/reports/by-skill/interview-gate-2-report.md +105 -0
  357. package/evals/reports/by-skill/mode-contract-1-report.md +74 -0
  358. package/evals/reports/by-skill/mode-contract-2-report.md +87 -0
  359. package/evals/reports/by-skill/mode-contract-3-report.md +65 -0
  360. package/evals/reports/by-skill/mode-contract-4-report.md +71 -0
  361. package/evals/reports/by-skill/mode-contract-5-report.md +70 -0
  362. package/evals/reports/by-skill/output-router-1-report.md +76 -0
  363. package/evals/reports/by-skill/output-router-2-report.md +65 -0
  364. package/evals/reports/by-skill/research-1-report.md +144 -0
  365. package/evals/reports/by-skill/research-brief-1-report.md +94 -0
  366. package/evals/reports/by-skill/research-brief-2-report.md +75 -0
  367. package/evals/reports/by-skill/review-artifact-1-report.md +91 -0
  368. package/evals/reports/by-skill/review-artifact-2-report.md +79 -0
  369. package/evals/reports/by-skill/review-artifact-3-report.md +120 -0
  370. package/evals/reports/by-skill/review-artifact-4-report.md +89 -0
  371. package/evals/reports/by-skill/review-artifact-5-report.md +66 -0
  372. package/evals/reports/by-skill/review-work-1-report.md +85 -0
  373. package/evals/reports/by-skill/review-work-2-report.md +87 -0
  374. package/evals/reports/by-skill/review-work-3-report.md +104 -0
  375. package/evals/reports/by-skill/review-work-4-report.md +108 -0
  376. package/evals/reports/by-skill/review-work-5-report.md +73 -0
  377. package/evals/reports/by-skill/review-work-6-report.md +66 -0
  378. package/evals/reports/by-skill/setup-freeflow-1-report.md +199 -0
  379. package/evals/reports/by-skill/setup-freeflow-2-report.md +105 -0
  380. package/evals/reports/by-skill/setup-freeflow-3-report.md +105 -0
  381. package/evals/reports/by-skill/setup-freeflow-4-report.md +88 -0
  382. package/evals/reports/by-skill/setup-freeflow-5-report.md +115 -0
  383. package/evals/reports/by-skill/skill-authoring-1-report.md +81 -0
  384. package/evals/reports/by-skill/verify-work-1-report.md +111 -0
  385. package/evals/reports/by-skill/verify-work-2-report.md +120 -0
  386. package/evals/reports/by-skill/workflow-1-report.md +65 -0
  387. package/evals/reports/by-skill/write-plan-1-report.md +123 -0
  388. package/evals/reports/by-skill/write-plan-2-report.md +98 -0
  389. package/evals/reports/by-skill/write-plan-3-report.md +110 -0
  390. package/evals/reports/by-skill/write-spec-1-report.md +88 -0
  391. package/evals/reports/by-skill/write-spec-2-report.md +89 -0
  392. package/evals/reports/by-skill/write-spec-3-report.md +90 -0
  393. package/evals/reports/by-skill/write-spec-4-report.md +167 -0
  394. package/evals/reports/harness/claude-harness-1-report.md +103 -0
  395. package/evals/reports/harness/eval-harness-1-report.md +91 -0
  396. package/evals/reports/iterations/iteration-1-report.md +71 -0
  397. package/evals/reports/iterations/iteration-2-report.md +78 -0
  398. package/evals/reports/iterations/iteration-3-report.md +118 -0
  399. package/evals/reports/iterations/iteration-4-report.md +131 -0
  400. package/evals/reports/iterations/iteration-5-report.md +149 -0
  401. package/evals/reports/iterations/iteration-6-report.md +136 -0
  402. package/evals/reports/runtime/always-on-runtime-1-report.md +107 -0
  403. package/evals/reports/runtime/context-mode-normalized-benchmark-1-report.md +52 -0
  404. package/evals/reports/runtime/context-mode-real-deep-baseline-1-report.md +410 -0
  405. package/evals/reports/runtime/context-mode-real-deep-final-slice-11-report.md +203 -0
  406. package/evals/reports/runtime/context-mode-real-deep-final-slice-11-review.md +51 -0
  407. package/evals/reports/runtime/context-saving-native-tools-baseline-1-report.md +99 -0
  408. package/evals/reports/runtime/eryx-python-compatibility-reprobe-1-report.md +166 -0
  409. package/evals/reports/runtime/eryx-python-proof-spike-1-report.md +96 -0
  410. package/evals/reports/runtime/eryx-python-proof-spike-2-report.md +151 -0
  411. package/evals/reports/runtime/eryx-python-script-derive-execution-1-report.md +233 -0
  412. package/evals/reports/runtime/jq-script-derive-execution-1-report.md +215 -0
  413. package/evals/reports/runtime/jq-wasm-proof-spike-1-report.md +67 -0
  414. package/evals/reports/runtime/output-router-benchmark-1-report.md +81 -0
  415. package/evals/reports/runtime/output-router-capture-derive-provider-eval-1-report.md +35 -0
  416. package/evals/reports/runtime/output-router-codex-large-index-sqlite-adhoc-report.md +150 -0
  417. package/evals/reports/runtime/output-router-codex-qa-benchmark-1-report.md +46 -0
  418. package/evals/reports/runtime/output-router-command-benchmark-1-report.md +62 -0
  419. package/evals/reports/runtime/output-router-index-benchmark-1-report.md +64 -0
  420. package/evals/reports/runtime/output-router-regression-1-report.md +81 -0
  421. package/evals/reports/runtime/output-router-transform-eval-1-report.md +28 -0
  422. package/evals/reports/runtime/pi-observed-routing-eval-1-report.md +44 -0
  423. package/evals/reports/runtime/quickjs-script-derive-execution-1-report.md +159 -0
  424. package/evals/reports/runtime/quickjs-wasi-proof-spike-1-report.md +55 -0
  425. package/evals/reports/runtime/render-format-row-protocol-1-report.md +58 -0
  426. package/evals/reports/runtime/script-sandbox-adapter-selection-review-1-report.md +84 -0
  427. package/evals/reports/runtime/script-sandbox-probe-resource-hardening-1-report.md +51 -0
  428. package/evals/reports/runtime/storage-policy-benchmark-1-report.md +176 -0
  429. package/evals/reports/runtime/vault-index-storage-spike-1-report.md +39 -0
  430. package/evals/reports/runtime/workflow-context-hook-1-report.md +82 -0
  431. package/evals/runbooks/adversarial-eval-runbook.md +28 -0
  432. package/evals/runbooks/fixture-eval-runbook.md +137 -0
  433. package/evals/runbooks/handoff-eval-runbook.md +22 -0
  434. package/evals/runbooks/verify-work-eval-runbook.md +27 -0
  435. package/evals/scripts/audit-command-surface.sh +160 -0
  436. package/evals/scripts/check-activation-contract.sh +121 -0
  437. package/evals/scripts/check-runtime-context-hook.sh +183 -0
  438. package/evals/scripts/grade-fixture-eval.sh +446 -0
  439. package/evals/scripts/run-claude-fixture-eval.sh +26 -0
  440. package/evals/scripts/run-codex-fixture-eval.sh +26 -0
  441. package/evals/scripts/run-eryx-python-proof-spike.js +559 -0
  442. package/evals/scripts/run-fixture-eval-by-id.sh +23 -0
  443. package/evals/scripts/run-fixture-eval.sh +464 -0
  444. package/evals/scripts/run-jq-wasm-proof-spike.js +299 -0
  445. package/evals/scripts/run-output-router-transform-eval.js +115 -0
  446. package/evals/scripts/run-pi-observed-routing-eval.js +478 -0
  447. package/evals/scripts/run-quickjs-wasi-proof-spike.js +339 -0
  448. package/evals/scripts/skill-evidence.sh +316 -0
  449. package/evals/scripts/validate-release-metadata.sh +486 -0
  450. package/evals/suites/v0.1-acceptance-suite.md +131 -0
  451. package/{plugins/freeflow/hooks → hooks}/freeflow-runtime-context.mjs +65 -14
  452. package/package.json +46 -13
  453. package/pi-extension/dist/host-producer-identification.js +186 -0
  454. package/pi-extension/dist/index.js +85 -0
  455. package/pi-extension/dist/mcp-config.js +30 -0
  456. package/pi-extension/dist/native-safety-net.js +209 -0
  457. package/pi-extension/dist/observed-tool-routing.js +114 -0
  458. package/pi-extension/dist/renderers.js +835 -0
  459. package/pi-extension/dist/router-tools.js +438 -0
  460. package/pi-extension/dist/runtime-context.js +288 -0
  461. package/pi-extension/dist/schemas.js +254 -0
  462. package/pi-extension/dist/status.js +449 -0
  463. package/pi-extension/dist/utils.js +467 -0
  464. package/pi-extension/src/host-producer-identification.ts +226 -0
  465. package/pi-extension/src/index.ts +121 -0
  466. package/pi-extension/src/mcp-config.ts +32 -0
  467. package/pi-extension/src/native-safety-net.ts +252 -0
  468. package/pi-extension/src/observed-tool-routing.ts +126 -0
  469. package/pi-extension/src/renderers.ts +917 -0
  470. package/pi-extension/src/router-tools.ts +478 -0
  471. package/pi-extension/src/runtime-context.ts +347 -0
  472. package/pi-extension/src/schemas.ts +259 -0
  473. package/pi-extension/src/status.ts +505 -0
  474. package/pi-extension/src/utils.ts +492 -0
  475. package/pi-extension/tsconfig.json +16 -0
  476. package/plugin-docs/README.md +40 -0
  477. package/plugin-docs/adr/0002-evals-before-hooks.md +17 -0
  478. package/{plugins/freeflow/docs → plugin-docs}/adr/0003-release-boundary.md +2 -2
  479. package/plugin-docs/adr/0004-discover-replaces-shallow-discovery-skills.md +26 -0
  480. package/plugin-docs/adr/README.md +10 -0
  481. package/plugin-docs/architecture.md +89 -0
  482. package/plugin-docs/output-router.md +396 -0
  483. package/plugin-docs/release-evidence.md +77 -0
  484. package/{plugins/freeflow/docs → plugin-docs}/skills.md +7 -7
  485. package/{plugins/freeflow/docs → plugin-docs}/workflow.md +4 -4
  486. package/router/dist/benchmarks/benchmark-harness.d.ts +32 -0
  487. package/router/dist/benchmarks/benchmark-harness.js +92 -0
  488. package/router/dist/benchmarks/benchmarks.d.ts +102 -0
  489. package/router/dist/benchmarks/benchmarks.js +880 -0
  490. package/router/dist/benchmarks/codex-qa-benchmarks.d.ts +91 -0
  491. package/router/dist/benchmarks/codex-qa-benchmarks.js +461 -0
  492. package/router/dist/benchmarks/command-benchmarks.d.ts +128 -0
  493. package/router/dist/benchmarks/command-benchmarks.js +653 -0
  494. package/router/dist/benchmarks/context-mode-normalized-benchmarks.d.ts +74 -0
  495. package/router/dist/benchmarks/context-mode-normalized-benchmarks.js +707 -0
  496. package/router/dist/benchmarks/context-mode-real-deep-benchmark.d.ts +124 -0
  497. package/router/dist/benchmarks/context-mode-real-deep-benchmark.js +1295 -0
  498. package/router/dist/benchmarks/context-saving-baseline.d.ts +54 -0
  499. package/router/dist/benchmarks/context-saving-baseline.js +439 -0
  500. package/router/dist/benchmarks/index-benchmarks.d.ts +98 -0
  501. package/router/dist/benchmarks/index-benchmarks.js +762 -0
  502. package/router/dist/benchmarks/storage-policy-benchmarks.d.ts +90 -0
  503. package/router/dist/benchmarks/storage-policy-benchmarks.js +538 -0
  504. package/router/dist/benchmarks/vault-index-benchmarks.d.ts +47 -0
  505. package/router/dist/benchmarks/vault-index-benchmarks.js +257 -0
  506. package/router/dist/config/config.d.ts +96 -0
  507. package/router/dist/config/config.js +453 -0
  508. package/router/dist/config/router-contract.d.ts +10 -0
  509. package/router/dist/config/router-contract.js +54 -0
  510. package/router/dist/config/schema.d.ts +18 -0
  511. package/router/dist/config/schema.js +600 -0
  512. package/router/dist/config/types.d.ts +521 -0
  513. package/router/dist/config/types.js +30 -0
  514. package/router/dist/evidence/bounded-evidence.d.ts +40 -0
  515. package/router/dist/evidence/bounded-evidence.js +310 -0
  516. package/router/dist/evidence/evidence-range-selector.d.ts +22 -0
  517. package/router/dist/evidence/evidence-range-selector.js +231 -0
  518. package/router/dist/evidence/evidence-search.d.ts +25 -0
  519. package/router/dist/evidence/evidence-search.js +466 -0
  520. package/router/dist/evidence/evidence.d.ts +38 -0
  521. package/router/dist/evidence/evidence.js +196 -0
  522. package/router/dist/evidence/failure-contracts.d.ts +27 -0
  523. package/router/dist/evidence/failure-contracts.js +160 -0
  524. package/router/dist/evidence/line-ranges.d.ts +22 -0
  525. package/router/dist/evidence/line-ranges.js +22 -0
  526. package/router/dist/experiments/local-index.d.ts +58 -0
  527. package/router/dist/experiments/local-index.js +562 -0
  528. package/router/dist/index.d.ts +30 -0
  529. package/router/dist/index.js +32 -0
  530. package/router/dist/processing/engine.d.ts +108 -0
  531. package/router/dist/processing/engine.js +435 -0
  532. package/router/dist/processing/reducers.d.ts +266 -0
  533. package/router/dist/processing/reducers.js +1495 -0
  534. package/router/dist/processing/renderers.d.ts +25 -0
  535. package/router/dist/processing/renderers.js +186 -0
  536. package/router/dist/processing/scripts.d.ts +78 -0
  537. package/router/dist/processing/scripts.js +333 -0
  538. package/router/dist/repo/repo-traversal.d.ts +18 -0
  539. package/router/dist/repo/repo-traversal.js +242 -0
  540. package/router/dist/routing/observed-reducers.d.ts +35 -0
  541. package/router/dist/routing/observed-reducers.js +647 -0
  542. package/router/dist/routing/observed-routing.d.ts +17 -0
  543. package/router/dist/routing/observed-routing.js +377 -0
  544. package/router/dist/routing/parsers.d.ts +16 -0
  545. package/router/dist/routing/parsers.js +473 -0
  546. package/router/dist/routing/run-filters.d.ts +56 -0
  547. package/router/dist/routing/run-filters.js +230 -0
  548. package/router/dist/routing/run-reducers.d.ts +30 -0
  549. package/router/dist/routing/run-reducers.js +110 -0
  550. package/router/dist/sandbox/adapter-roots.d.ts +38 -0
  551. package/router/dist/sandbox/adapter-roots.js +64 -0
  552. package/router/dist/sandbox/eryx-python-adapter.d.ts +9 -0
  553. package/router/dist/sandbox/eryx-python-adapter.js +797 -0
  554. package/router/dist/sandbox/jq-wasm-adapter.d.ts +9 -0
  555. package/router/dist/sandbox/jq-wasm-adapter.js +421 -0
  556. package/router/dist/sandbox/quickjs-wasi-adapter.d.ts +9 -0
  557. package/router/dist/sandbox/quickjs-wasi-adapter.js +381 -0
  558. package/router/dist/sandbox/script-sandbox.d.ts +113 -0
  559. package/router/dist/sandbox/script-sandbox.js +303 -0
  560. package/router/dist/setup/script-transform-adapters.d.ts +28 -0
  561. package/router/dist/setup/script-transform-adapters.js +259 -0
  562. package/router/dist/tools/batch.d.ts +22 -0
  563. package/router/dist/tools/batch.js +509 -0
  564. package/router/dist/tools/run.d.ts +50 -0
  565. package/router/dist/tools/run.js +1219 -0
  566. package/router/dist/tools/search.d.ts +44 -0
  567. package/router/dist/tools/search.js +1205 -0
  568. package/router/dist/transform/engine.d.ts +143 -0
  569. package/router/dist/transform/engine.js +1955 -0
  570. package/router/dist/vault/vault-index.d.ts +106 -0
  571. package/router/dist/vault/vault-index.js +411 -0
  572. package/router/dist/vault/vault.d.ts +103 -0
  573. package/router/dist/vault/vault.js +635 -0
  574. package/{plugins/freeflow/skills → skills}/commit-work/SKILL.md +17 -16
  575. package/{plugins/freeflow/skills → skills}/commit-work/references/staging-decisions.md +3 -3
  576. package/skills/design-for-depth/SKILL.md +90 -0
  577. package/skills/design-for-depth/references/design-pressure-signals.md +265 -0
  578. package/skills/design-for-depth/references/software-design-philosophy.md +219 -0
  579. package/{plugins/freeflow/skills → skills}/diagnose-failure/SKILL.md +6 -1
  580. package/skills/discover/ARTIFACT-DESTINATIONS.md +58 -0
  581. package/skills/discover/CHECKPOINTS.md +74 -0
  582. package/skills/discover/SKILL.md +173 -0
  583. package/skills/execute-plan/SKILL.md +133 -0
  584. package/skills/execute-plan/references/execution-map.md +122 -0
  585. package/{plugins/freeflow/skills → skills}/mode-contract/SKILL.md +10 -5
  586. package/skills/output-router/SKILL.md +202 -0
  587. package/skills/output-router/references/safety-policy.md +40 -0
  588. package/{plugins/freeflow/skills → skills}/review-artifact/SKILL.md +37 -1
  589. package/{plugins/freeflow/skills → skills}/review-artifact/references/reviewer-prompt.md +14 -2
  590. package/skills/review-work/SKILL.md +101 -0
  591. package/{plugins/freeflow/skills → skills}/review-work/references/reviewer-prompt.md +8 -0
  592. package/skills/setup-freeflow/SKILL.md +106 -0
  593. package/{plugins/freeflow/skills → skills}/setup-freeflow/references/activation-contract.md +14 -8
  594. package/{plugins/freeflow/skills → skills}/setup-freeflow/references/host-setup.md +5 -3
  595. package/skills/setup-freeflow/references/output-router-setup.md +102 -0
  596. package/{plugins/freeflow/skills → skills}/verify-work/SKILL.md +3 -1
  597. package/{plugins/freeflow/skills → skills}/workflow/SKILL.md +23 -13
  598. package/{plugins/freeflow/skills → skills}/workflow/references/workflow-map.md +21 -20
  599. package/{plugins/freeflow/skills → skills}/write-plan/SKILL.md +9 -1
  600. package/{plugins/freeflow/skills → skills}/write-skill/SKILL.md +1 -1
  601. package/{plugins/freeflow/skills → skills}/write-spec/SKILL.md +9 -6
  602. package/plugins/freeflow/docs/README.md +0 -39
  603. package/plugins/freeflow/docs/adr/0002-evals-before-hooks.md +0 -17
  604. package/plugins/freeflow/docs/adr/README.md +0 -7
  605. package/plugins/freeflow/docs/architecture.md +0 -86
  606. package/plugins/freeflow/docs/release-evidence.md +0 -49
  607. package/plugins/freeflow/pi-extension/index.js +0 -250
  608. package/plugins/freeflow/skills/capture-decisions/SKILL.md +0 -95
  609. package/plugins/freeflow/skills/capture-decisions/references/destination-guide.md +0 -65
  610. package/plugins/freeflow/skills/execute-plan/SKILL.md +0 -67
  611. package/plugins/freeflow/skills/grill-context/SKILL.md +0 -79
  612. package/plugins/freeflow/skills/grill-context/references/approach-framing.md +0 -52
  613. package/plugins/freeflow/skills/research-brief/SKILL.md +0 -69
  614. package/plugins/freeflow/skills/review-work/SKILL.md +0 -73
  615. package/plugins/freeflow/skills/setup-freeflow/SKILL.md +0 -84
  616. /package/{plugins/freeflow/assets → assets}/freeflow-plugin-icon-transparent.png +0 -0
  617. /package/{plugins/freeflow/hooks → hooks}/hooks.json +0 -0
  618. /package/{plugins/freeflow/docs → plugin-docs}/adr/0001-three-modes.md +0 -0
  619. /package/{plugins/freeflow/skills → skills}/bypass/SKILL.md +0 -0
  620. /package/{plugins/freeflow/skills → skills}/diagnose-failure/references/feedback-loop-catalog.md +0 -0
  621. /package/{plugins/freeflow/skills → skills}/diagnose-failure/references/flaky-and-performance.md +0 -0
  622. /package/{plugins/freeflow/skills → skills}/evaluate-skill/SKILL.md +0 -0
  623. /package/{plugins/freeflow/skills → skills}/evaluate-skill/references/eval-patterns.md +0 -0
  624. /package/{plugins/freeflow/skills → skills}/evaluate-skill/references/grading-priority.md +0 -0
  625. /package/{plugins/freeflow/skills → skills}/handoff/SKILL.md +0 -0
  626. /package/{plugins/freeflow/skills → skills}/handoff/references/templates.md +0 -0
  627. /package/{plugins/freeflow/skills → skills}/interview-gate/SKILL.md +0 -0
  628. /package/{plugins/freeflow/skills → skills}/write-plan/references/plan-shapes.md +0 -0
  629. /package/{plugins/freeflow/skills → skills}/write-spec/references/artifact-standards.md +0 -0
  630. /package/{plugins/freeflow/skills → skills}/write-spec/references/spec-shapes.md +0 -0
@@ -0,0 +1,647 @@
1
+ import { createHash } from "node:crypto";
2
+ import { assembleTextEvidence, byteLength, countLines } from "../evidence/evidence.js";
3
+ const IMPORTANT_JSON_KEYS = new Set([
4
+ "id",
5
+ "url",
6
+ "uri",
7
+ "link",
8
+ "status",
9
+ "state",
10
+ "error",
11
+ "message",
12
+ "path",
13
+ "repo",
14
+ "snippet",
15
+ "citation",
16
+ "source",
17
+ "symbol",
18
+ "code",
19
+ "file",
20
+ "line",
21
+ "lines",
22
+ "name",
23
+ "title",
24
+ "number",
25
+ "html_url",
26
+ "web_url",
27
+ ]);
28
+ const MAX_JSON_ARRAY_ROWS = 3;
29
+ const MAX_JSON_OBJECT_FIELDS = 12;
30
+ export function createDefaultObservedReducerRegistry() {
31
+ const reducers = [webSearchReducer(), fetchReducer(), codeSearchReducer(), mcpReducer(), jsonReducer(), genericTextReducer()];
32
+ return {
33
+ names() {
34
+ return reducers.map((reducer) => reducer.name);
35
+ },
36
+ reduce(input) {
37
+ const fallback = genericTextReducer();
38
+ const reducer = reducers.find((candidate) => candidate.supports(input)) ?? fallback;
39
+ try {
40
+ return reducer.reduce(input);
41
+ }
42
+ catch (error) {
43
+ if (reducer.name === fallback.name) {
44
+ throw error;
45
+ }
46
+ const fallbackResult = fallback.reduce(input);
47
+ return {
48
+ ...fallbackResult,
49
+ reason: `${reducer.name} reducer failed (${errorMessage(error)}); ${fallbackResult.reason}`,
50
+ };
51
+ }
52
+ },
53
+ };
54
+ }
55
+ export function reduceObservedOutput(input) {
56
+ return createDefaultObservedReducerRegistry().reduce(input);
57
+ }
58
+ export function webSearchReducer() {
59
+ return {
60
+ name: "web-search",
61
+ supports(input) {
62
+ return input.producer?.kind === "web";
63
+ },
64
+ reduce(input) {
65
+ const rows = extractRows(input.rawValue, ["results", "items", "sources"]);
66
+ if (!rows) {
67
+ return producerTextFallback(input, "web-search", "web_search output did not expose structured results.");
68
+ }
69
+ const shown = rows.slice(0, MAX_JSON_ARRAY_ROWS).map((row) => selectFields(row, ["title", "url", "snippet", "citation", "source"]));
70
+ const omittedItems = Math.max(0, rows.length - shown.length);
71
+ const excerpt = stableJson({
72
+ type: "web_search_results",
73
+ itemCount: rows.length,
74
+ results: shown,
75
+ ...(omittedItems > 0 ? { omittedItems } : {}),
76
+ });
77
+ return producerEvidenceResult({
78
+ input,
79
+ reducer: "web-search",
80
+ excerpt,
81
+ partial: omittedItems > 0 || byteLength(input.text) > byteLength(excerpt),
82
+ summary: `web_search results: ${rows.length} item(s).`,
83
+ reason: `web_search output was compacted to title, URL, snippet, and citation fields.`,
84
+ });
85
+ },
86
+ };
87
+ }
88
+ export function fetchReducer() {
89
+ return {
90
+ name: "fetch",
91
+ supports(input) {
92
+ return input.producer?.kind === "fetch";
93
+ },
94
+ reduce(input) {
95
+ const value = isRecord(input.rawValue) ? input.rawValue : undefined;
96
+ const content = firstString(value?.content, value?.text, value?.markdown, input.text);
97
+ if (!content) {
98
+ return producerTextFallback(input, "fetch", "fetch_content output did not expose textual content.");
99
+ }
100
+ const excerpt = fetchExcerpt({
101
+ title: firstString(value?.title, value?.name),
102
+ url: firstString(value?.url, value?.canonicalUrl, value?.sourceUrl),
103
+ contentType: firstString(value?.contentType, value?.mimeType),
104
+ content,
105
+ });
106
+ return producerEvidenceResult({
107
+ input,
108
+ reducer: "fetch",
109
+ excerpt,
110
+ partial: byteLength(input.text) > byteLength(excerpt),
111
+ summary: `fetch_content fetched content: ${countLines(content)} line(s), ${byteLength(content)} byte(s).`,
112
+ reason: "fetch_content output was reduced to URL/title, headings, and code blocks.",
113
+ });
114
+ },
115
+ };
116
+ }
117
+ export function codeSearchReducer() {
118
+ return {
119
+ name: "code-search",
120
+ supports(input) {
121
+ return input.producer?.kind === "code_search";
122
+ },
123
+ reduce(input) {
124
+ const rows = extractRows(input.rawValue, ["results", "items", "matches"]);
125
+ if (!rows) {
126
+ return producerTextFallback(input, "code-search", "code_search output did not expose structured results.");
127
+ }
128
+ const shown = rows.slice(0, MAX_JSON_ARRAY_ROWS).map((row) => selectFields(row, ["repo", "path", "file", "line", "lines", "symbol", "snippet", "code"]));
129
+ const omittedItems = Math.max(0, rows.length - shown.length);
130
+ const excerpt = stableJson({
131
+ type: "code_search_results",
132
+ itemCount: rows.length,
133
+ results: shown,
134
+ ...(omittedItems > 0 ? { omittedItems } : {}),
135
+ });
136
+ return producerEvidenceResult({
137
+ input,
138
+ reducer: "code-search",
139
+ excerpt,
140
+ partial: omittedItems > 0 || byteLength(input.text) > byteLength(excerpt),
141
+ summary: `code_search results: ${rows.length} item(s).`,
142
+ reason: "code_search output was compacted to repo, path, line, symbol, and exact snippet fields.",
143
+ });
144
+ },
145
+ };
146
+ }
147
+ export function mcpReducer() {
148
+ return {
149
+ name: "mcp",
150
+ supports(input) {
151
+ return input.producer?.kind === "mcp";
152
+ },
153
+ reduce(input) {
154
+ const payload = extractMcpPayload(input);
155
+ if (payload.jsonValues.length > 0 && payload.textBlocks.length === 0) {
156
+ return reduceMcpJson(input, payload.jsonValues.length === 1 ? payload.jsonValues[0] : payload.jsonValues);
157
+ }
158
+ if (payload.jsonValues.length > 0 || payload.textBlocks.length > 0) {
159
+ return reduceMcpMixed(input, payload);
160
+ }
161
+ const result = genericTextReducer().reduce(input);
162
+ return {
163
+ ...result,
164
+ reducer: "mcp",
165
+ summary: `MCP ${mcpLabel(input)} text: ${countLines(input.text)} line(s), ${byteLength(input.text)} byte(s).`,
166
+ reason: `MCP ${mcpLabel(input)} output used generic text reduction. ${result.reason}`,
167
+ };
168
+ },
169
+ };
170
+ }
171
+ export function genericTextReducer() {
172
+ return {
173
+ name: "generic-text",
174
+ supports() {
175
+ return true;
176
+ },
177
+ reduce(input) {
178
+ const caps = textCaps(input.preserve, input.thresholds);
179
+ const bounded = assembleTextEvidence({ stream: "combined", text: input.text, caps });
180
+ const outputBytes = byteLength(input.text);
181
+ const outputLines = countLines(input.text);
182
+ const routingStatus = bounded.compressed || bounded.fidelity === "lossy" ? "partial" : "routed";
183
+ const evidence = bounded.importantLines.map((line, index) => ({
184
+ id: evidenceId(input.outputId, line.lines, index),
185
+ source: input.source,
186
+ path: `${input.outputId}:observed`,
187
+ lines: line.lines,
188
+ excerpt: line.excerpt,
189
+ why: bounded.compressed ? "Bounded observed tool output evidence." : "Observed tool output fits within routing caps.",
190
+ window: bounded.compressed ? "section" : "exact",
191
+ expandable: input.source.kind === "vault" && bounded.compressed,
192
+ }));
193
+ return {
194
+ reducer: "generic-text",
195
+ routingStatus,
196
+ reason: bounded.compressed
197
+ ? `Observed tool output was reduced from ${outputLines} line(s), ${outputBytes} byte(s); exact recovery depends on persistence policy.`
198
+ : `Observed tool output fits within caps (${outputLines} line(s), ${outputBytes} byte(s)).`,
199
+ summary: `Observed tool output: ${outputLines} line(s), ${outputBytes} byte(s).`,
200
+ evidence,
201
+ };
202
+ },
203
+ };
204
+ }
205
+ export function jsonReducer() {
206
+ return {
207
+ name: "json",
208
+ supports(input) {
209
+ return input.normalized.shape === "json" || parsesAsJson(input.text);
210
+ },
211
+ reduce(input) {
212
+ const value = input.rawValue !== undefined ? input.rawValue : parseJson(input.text);
213
+ if (Array.isArray(value)) {
214
+ return reduceJsonArray(input, value);
215
+ }
216
+ if (isRecord(value)) {
217
+ return reduceJsonObject(input, value);
218
+ }
219
+ return genericTextReducer().reduce(input);
220
+ },
221
+ };
222
+ }
223
+ function producerEvidenceResult(options) {
224
+ return {
225
+ reducer: options.reducer,
226
+ routingStatus: options.partial ? "partial" : "routed",
227
+ reason: options.reason,
228
+ summary: options.summary,
229
+ evidence: [
230
+ {
231
+ id: evidenceId(options.input.outputId, options.reducer, 0),
232
+ source: options.input.source,
233
+ path: `${options.input.outputId}:observed-${options.reducer}`,
234
+ excerpt: options.excerpt,
235
+ why: `${options.reducer} reducer preserved exact producer evidence fields.`,
236
+ window: options.partial ? "section" : "exact",
237
+ expandable: options.input.source.kind === "vault" && options.partial,
238
+ },
239
+ ],
240
+ };
241
+ }
242
+ function producerTextFallback(input, reducer, reason) {
243
+ const result = genericTextReducer().reduce(input);
244
+ return {
245
+ ...result,
246
+ reducer,
247
+ reason: `${reason} ${result.reason}`,
248
+ };
249
+ }
250
+ function fetchExcerpt(options) {
251
+ const lines = normalizeNewlines(options.content).split("\n");
252
+ const headings = lines.filter((line) => /^#{1,6}\s+/.test(line)).slice(0, 8);
253
+ const codeBlocks = extractCodeBlocks(options.content).slice(0, 3);
254
+ return [
255
+ options.title ? `Title: ${options.title}` : "",
256
+ options.url ? `URL: ${options.url}` : "",
257
+ options.contentType ? `Content-Type: ${options.contentType}` : "",
258
+ headings.length > 0 ? ["Headings:", ...headings].join("\n") : "",
259
+ codeBlocks.length > 0 ? ["Code blocks:", ...codeBlocks].join("\n\n") : "",
260
+ ].filter(Boolean).join("\n");
261
+ }
262
+ function extractCodeBlocks(text) {
263
+ return Array.from(normalizeNewlines(text).matchAll(/```[\s\S]*?```/g), (match) => match[0]);
264
+ }
265
+ function extractRows(value, keys) {
266
+ if (Array.isArray(value)) {
267
+ return value;
268
+ }
269
+ if (!isRecord(value)) {
270
+ return undefined;
271
+ }
272
+ for (const key of keys) {
273
+ if (Array.isArray(value[key])) {
274
+ return value[key];
275
+ }
276
+ }
277
+ return undefined;
278
+ }
279
+ function selectFields(value, keys) {
280
+ if (!isRecord(value)) {
281
+ return { value: truncateScalar(value) };
282
+ }
283
+ const selected = {};
284
+ for (const key of keys) {
285
+ if (value[key] !== undefined) {
286
+ selected[key] = truncateScalar(value[key]);
287
+ }
288
+ }
289
+ return selected;
290
+ }
291
+ function truncateScalar(value) {
292
+ if (typeof value === "string") {
293
+ const dedupedRuns = value.replace(/(.)\1{15,}/g, (match) => `${match.slice(0, 15)}…`);
294
+ return dedupedRuns.length > 240 ? `${dedupedRuns.slice(0, 239)}…` : dedupedRuns;
295
+ }
296
+ return value;
297
+ }
298
+ function normalizeNewlines(text) {
299
+ return text.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
300
+ }
301
+ function firstString(...values) {
302
+ for (const value of values) {
303
+ if (typeof value === "string" && value.length > 0) {
304
+ return value;
305
+ }
306
+ }
307
+ return undefined;
308
+ }
309
+ function reduceMcpJson(input, value) {
310
+ const unwrapped = unwrapCommonArray(value);
311
+ if (unwrapped) {
312
+ return reduceMcpJsonArray(input, unwrapped.key, unwrapped.rows);
313
+ }
314
+ if (Array.isArray(value)) {
315
+ return reduceMcpJsonArray(input, undefined, value);
316
+ }
317
+ if (isRecord(value)) {
318
+ return reduceMcpJsonObject(input, value);
319
+ }
320
+ return mcpGenericTextFallback(input, "MCP JSON payload was scalar; generic text evidence is safer.");
321
+ }
322
+ function reduceMcpJsonArray(input, key, rows) {
323
+ const shown = rows.slice(0, MAX_JSON_ARRAY_ROWS).map(compactJsonValue);
324
+ const omittedItems = Math.max(0, rows.length - shown.length);
325
+ const excerpt = stableJson({
326
+ type: "mcp_array",
327
+ server: input.producer?.server,
328
+ tool: input.producer?.tool,
329
+ ...(key !== undefined ? { sourceKey: key } : {}),
330
+ itemCount: rows.length,
331
+ items: shown,
332
+ ...(omittedItems > 0 ? { omittedItems } : {}),
333
+ });
334
+ return mcpEvidenceResult({
335
+ input,
336
+ excerpt,
337
+ partial: omittedItems > 0 || byteLength(input.text) > byteLength(excerpt),
338
+ summary: `MCP ${mcpLabel(input)} JSON array: ${rows.length} item(s).`,
339
+ reason: omittedItems > 0
340
+ ? `MCP ${mcpLabel(input)} JSON array was compacted to ${shown.length} row(s); ${omittedItems} item(s) omitted.`
341
+ : `MCP ${mcpLabel(input)} JSON array was compacted to ${shown.length} row(s).`,
342
+ });
343
+ }
344
+ function reduceMcpJsonObject(input, value) {
345
+ const fields = importantJsonFields(value).slice(0, MAX_JSON_OBJECT_FIELDS);
346
+ const compact = fields.length > 0 ? Object.fromEntries(fields) : compactJsonValue(value);
347
+ const excerpt = stableJson({
348
+ type: "mcp_object",
349
+ server: input.producer?.server,
350
+ tool: input.producer?.tool,
351
+ keys: Object.keys(value).sort(),
352
+ fields: compact,
353
+ });
354
+ return mcpEvidenceResult({
355
+ input,
356
+ excerpt,
357
+ partial: byteLength(input.text) > byteLength(excerpt),
358
+ summary: `MCP ${mcpLabel(input)} JSON object: ${Object.keys(value).length} top-level key(s).`,
359
+ reason: `MCP ${mcpLabel(input)} JSON object was compacted to stable important scalar fields.`,
360
+ });
361
+ }
362
+ function reduceMcpMixed(input, payload) {
363
+ const compactedTextBlocks = payload.textBlocks.map(compactMcpTextBlock);
364
+ const text = compactedTextBlocks.map((block) => block.text).join("\n\n");
365
+ const textWasCompacted = compactedTextBlocks.some((block) => block.compacted);
366
+ const jsonValues = payload.jsonValues.map((value) => {
367
+ const unwrapped = unwrapCommonArray(value);
368
+ if (unwrapped) {
369
+ return { [unwrapped.key]: unwrapped.rows.slice(0, MAX_JSON_ARRAY_ROWS).map(compactJsonValue), itemCount: unwrapped.rows.length };
370
+ }
371
+ if (Array.isArray(value)) {
372
+ return { items: value.slice(0, MAX_JSON_ARRAY_ROWS).map(compactJsonValue), itemCount: value.length };
373
+ }
374
+ return compactJsonValue(value);
375
+ });
376
+ const excerpt = [
377
+ text,
378
+ jsonValues.length > 0 ? stableJson({ jsonBlocks: jsonValues }) : "",
379
+ ].filter(Boolean).join("\n\n");
380
+ return mcpEvidenceResult({
381
+ input,
382
+ excerpt,
383
+ partial: textWasCompacted || byteLength(input.text) > byteLength(excerpt),
384
+ summary: `MCP ${mcpLabel(input)} mixed content: ${payload.textBlocks.length} text block(s), ${payload.jsonValues.length} JSON block(s).`,
385
+ reason: textWasCompacted
386
+ ? `MCP ${mcpLabel(input)} mixed content was reduced by bounding text blocks and compact JSON fields.`
387
+ : `MCP ${mcpLabel(input)} mixed content was reduced by preserving text blocks and compact JSON fields.`,
388
+ });
389
+ }
390
+ function compactMcpTextBlock(text) {
391
+ const normalized = normalizeNewlines(text);
392
+ const lines = normalized.split("\n");
393
+ const shown = lines.slice(0, 8).map((line) => String(truncateScalar(line)));
394
+ const omittedLines = Math.max(0, lines.length - shown.length);
395
+ const compacted = omittedLines > 0 || byteLength(shown.join("\n")) < byteLength(normalized);
396
+ return {
397
+ text: [
398
+ ...shown,
399
+ omittedLines > 0 ? `[... ${omittedLines} more line(s) omitted from MCP text block ...]` : "",
400
+ ].filter(Boolean).join("\n"),
401
+ compacted,
402
+ };
403
+ }
404
+ function mcpEvidenceResult(options) {
405
+ return {
406
+ reducer: "mcp",
407
+ routingStatus: options.partial ? "partial" : "routed",
408
+ reason: options.reason,
409
+ summary: options.summary,
410
+ evidence: [
411
+ {
412
+ id: evidenceId(options.input.outputId, "mcp", 0),
413
+ source: options.input.source,
414
+ path: `${options.input.outputId}:observed-mcp`,
415
+ excerpt: options.excerpt,
416
+ why: `Deterministic MCP reducer preserved exact IDs, URLs, statuses, paths, errors, and code snippets for ${mcpLabel(options.input)}.`,
417
+ window: options.partial ? "section" : "exact",
418
+ expandable: options.input.source.kind === "vault" && options.partial,
419
+ },
420
+ ],
421
+ };
422
+ }
423
+ function mcpGenericTextFallback(input, reason) {
424
+ const result = genericTextReducer().reduce(input);
425
+ return {
426
+ ...result,
427
+ reducer: "mcp",
428
+ summary: `MCP ${mcpLabel(input)} text: ${countLines(input.text)} line(s), ${byteLength(input.text)} byte(s).`,
429
+ reason: `${reason} ${result.reason}`,
430
+ };
431
+ }
432
+ function extractMcpPayload(input) {
433
+ const textBlocks = [];
434
+ const jsonValues = [];
435
+ collectMcpPayload(input.rawValue, textBlocks, jsonValues);
436
+ if (textBlocks.length === 0 && jsonValues.length === 0) {
437
+ const parsed = parseJson(input.text);
438
+ if (parsed !== undefined) {
439
+ jsonValues.push(parsed);
440
+ }
441
+ else if (input.text.length > 0) {
442
+ textBlocks.push(input.text);
443
+ }
444
+ }
445
+ return { textBlocks, jsonValues };
446
+ }
447
+ function collectMcpPayload(value, textBlocks, jsonValues) {
448
+ if (!isRecord(value)) {
449
+ if (typeof value === "string" && value.length > 0) {
450
+ textBlocks.push(value);
451
+ }
452
+ return;
453
+ }
454
+ if (Array.isArray(value.content)) {
455
+ for (const block of value.content) {
456
+ collectMcpBlock(block, textBlocks, jsonValues);
457
+ }
458
+ return;
459
+ }
460
+ if (value.json !== undefined) {
461
+ jsonValues.push(value.json);
462
+ return;
463
+ }
464
+ if (typeof value.text === "string") {
465
+ collectMcpText(value.text, textBlocks, jsonValues);
466
+ return;
467
+ }
468
+ jsonValues.push(value);
469
+ }
470
+ function collectMcpBlock(block, textBlocks, jsonValues) {
471
+ if (typeof block === "string") {
472
+ collectMcpText(block, textBlocks, jsonValues);
473
+ return;
474
+ }
475
+ if (!isRecord(block)) {
476
+ return;
477
+ }
478
+ if (block.json !== undefined) {
479
+ jsonValues.push(block.json);
480
+ return;
481
+ }
482
+ if (typeof block.text === "string") {
483
+ collectMcpText(block.text, textBlocks, jsonValues);
484
+ return;
485
+ }
486
+ if (block.content !== undefined) {
487
+ collectMcpPayload(block, textBlocks, jsonValues);
488
+ return;
489
+ }
490
+ jsonValues.push(block);
491
+ }
492
+ function collectMcpText(text, textBlocks, jsonValues) {
493
+ const parsed = parseJson(text);
494
+ if (parsed !== undefined) {
495
+ jsonValues.push(parsed);
496
+ return;
497
+ }
498
+ textBlocks.push(text);
499
+ }
500
+ function unwrapCommonArray(value) {
501
+ if (!isRecord(value)) {
502
+ return undefined;
503
+ }
504
+ for (const key of ["items", "results", "data", "deployments", "issues", "messages"]) {
505
+ const entry = value[key];
506
+ if (Array.isArray(entry)) {
507
+ return { key, rows: entry };
508
+ }
509
+ }
510
+ return undefined;
511
+ }
512
+ function mcpLabel(input) {
513
+ return [input.producer?.server, input.producer?.tool].filter(Boolean).join(" ") || "unknown";
514
+ }
515
+ function reduceJsonArray(input, rows) {
516
+ const shown = rows.slice(0, MAX_JSON_ARRAY_ROWS).map(compactJsonValue);
517
+ const omittedItems = Math.max(0, rows.length - shown.length);
518
+ const excerpt = stableJson({
519
+ type: "array",
520
+ itemCount: rows.length,
521
+ items: shown,
522
+ ...(omittedItems > 0 ? { omittedItems } : {}),
523
+ });
524
+ return jsonEvidenceResult({
525
+ input,
526
+ excerpt,
527
+ partial: omittedItems > 0 || byteLength(input.text) > byteLength(excerpt),
528
+ summary: `JSON array: ${rows.length} item(s).`,
529
+ reason: omittedItems > 0
530
+ ? `JSON array output was compacted to ${shown.length} row(s); ${omittedItems} item(s) omitted.`
531
+ : `JSON array output was compacted to ${shown.length} row(s).`,
532
+ });
533
+ }
534
+ function reduceJsonObject(input, value) {
535
+ const fields = importantJsonFields(value).slice(0, MAX_JSON_OBJECT_FIELDS);
536
+ const compact = fields.length > 0 ? Object.fromEntries(fields) : compactJsonValue(value);
537
+ const excerpt = stableJson({
538
+ type: "object",
539
+ keys: Object.keys(value).sort(),
540
+ fields: compact,
541
+ });
542
+ return jsonEvidenceResult({
543
+ input,
544
+ excerpt,
545
+ partial: byteLength(input.text) > byteLength(excerpt),
546
+ summary: `JSON object: ${Object.keys(value).length} top-level key(s).`,
547
+ reason: "JSON object output was compacted to stable important scalar fields.",
548
+ });
549
+ }
550
+ function jsonEvidenceResult(options) {
551
+ return {
552
+ reducer: "json",
553
+ routingStatus: options.partial ? "partial" : "routed",
554
+ reason: options.reason,
555
+ summary: options.summary,
556
+ evidence: [
557
+ {
558
+ id: evidenceId(options.input.outputId, "json", 0),
559
+ source: options.input.source,
560
+ path: `${options.input.outputId}:observed-json`,
561
+ excerpt: options.excerpt,
562
+ why: "Deterministic JSON reducer preserved compact exact scalar evidence.",
563
+ window: options.partial ? "section" : "exact",
564
+ expandable: options.input.source.kind === "vault" && options.partial,
565
+ },
566
+ ],
567
+ };
568
+ }
569
+ function compactJsonValue(value) {
570
+ if (!isRecord(value)) {
571
+ return value;
572
+ }
573
+ const selected = Object.fromEntries(importantJsonFields(value).slice(0, MAX_JSON_OBJECT_FIELDS));
574
+ if (Object.keys(selected).length > 0) {
575
+ return selected;
576
+ }
577
+ const scalars = Object.entries(value)
578
+ .filter(([, entry]) => isScalar(entry))
579
+ .slice(0, MAX_JSON_OBJECT_FIELDS);
580
+ return Object.fromEntries(scalars);
581
+ }
582
+ function importantJsonFields(value, prefix = "", depth = 0) {
583
+ const fields = [];
584
+ const entries = Object.entries(value).sort(([left], [right]) => left.localeCompare(right));
585
+ for (const [key, entry] of entries) {
586
+ const path = prefix ? `${prefix}.${key}` : key;
587
+ if (isScalar(entry) && IMPORTANT_JSON_KEYS.has(key.toLowerCase())) {
588
+ fields.push([path, entry]);
589
+ continue;
590
+ }
591
+ if (isRecord(entry) && depth < 2) {
592
+ fields.push(...importantJsonFields(entry, path, depth + 1));
593
+ }
594
+ }
595
+ return fields;
596
+ }
597
+ function textCaps(preserve, thresholds) {
598
+ return preserve === "full"
599
+ ? {
600
+ maxLines: Number.MAX_SAFE_INTEGER,
601
+ maxExcerptBytes: thresholds.largeOutputBytes,
602
+ maxLineBytes: thresholds.largeOutputBytes,
603
+ }
604
+ : {
605
+ maxLines: thresholds.largeOutputLines,
606
+ maxExcerptBytes: thresholds.largeOutputBytes,
607
+ maxLineBytes: thresholds.largeOutputBytes,
608
+ };
609
+ }
610
+ function parsesAsJson(text) {
611
+ try {
612
+ JSON.parse(text);
613
+ return true;
614
+ }
615
+ catch {
616
+ return false;
617
+ }
618
+ }
619
+ function parseJson(text) {
620
+ try {
621
+ return JSON.parse(text);
622
+ }
623
+ catch {
624
+ return undefined;
625
+ }
626
+ }
627
+ function stableJson(value) {
628
+ return JSON.stringify(value, sortJsonKeys, 2);
629
+ }
630
+ function sortJsonKeys(_key, value) {
631
+ if (!isRecord(value) || Array.isArray(value)) {
632
+ return value;
633
+ }
634
+ return Object.fromEntries(Object.entries(value).sort(([left], [right]) => left.localeCompare(right)));
635
+ }
636
+ function evidenceId(outputId, lines, index) {
637
+ return `ffe_${createHash("sha256").update(`${outputId}:${lines}:${index}`).digest("hex").slice(0, 16)}`;
638
+ }
639
+ function isScalar(value) {
640
+ return value === null || ["string", "number", "boolean"].includes(typeof value);
641
+ }
642
+ function isRecord(value) {
643
+ return typeof value === "object" && value !== null && !Array.isArray(value);
644
+ }
645
+ function errorMessage(error) {
646
+ return error instanceof Error ? error.message : String(error);
647
+ }
@@ -0,0 +1,17 @@
1
+ import type { ObservedHostDescriptor, ObservedProducerRisk, ObservedRoutedResult, ObservedRoutingPersistenceMode, PreserveMode, ProducerDescriptor, RouterThresholds, VaultRetentionPolicy } from "../config/types.js";
2
+ export interface RouteObservedToolOutputOptions {
3
+ sessionId: string;
4
+ host: ObservedHostDescriptor;
5
+ producer: ProducerDescriptor;
6
+ rawResult: unknown;
7
+ persistence: ObservedRoutingPersistenceMode;
8
+ preserve?: PreserveMode;
9
+ vaultRoot?: string;
10
+ vaultRetention?: VaultRetentionPolicy;
11
+ thresholds?: Partial<RouterThresholds>;
12
+ mediaType?: string;
13
+ toolInputHash?: string;
14
+ risk?: ObservedProducerRisk;
15
+ createdAt?: string;
16
+ }
17
+ export declare function routeObservedToolOutput(options: RouteObservedToolOutputOptions): Promise<ObservedRoutedResult>;