@kontourai/flow-agents 0.1.1

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 (418) hide show
  1. package/.githooks/pre-push +11 -0
  2. package/.github/workflows/ci.yml +210 -0
  3. package/.github/workflows/docs-pages.yml +52 -0
  4. package/.github/workflows/publish-npm.yml +104 -0
  5. package/AGENTS.md +26 -0
  6. package/CHANGELOG.md +66 -0
  7. package/CODE_OF_CONDUCT.md +25 -0
  8. package/CONTEXT.md +300 -0
  9. package/CONTRIBUTING.md +44 -0
  10. package/LICENSE +201 -0
  11. package/README.md +129 -0
  12. package/SECURITY.md +33 -0
  13. package/agent-cards/dev.json +19 -0
  14. package/agents/dev.json +127 -0
  15. package/agents/tool-code-reviewer.json +61 -0
  16. package/agents/tool-dependencies-updater.json +118 -0
  17. package/agents/tool-explore-config.json +92 -0
  18. package/agents/tool-explore-deps.json +92 -0
  19. package/agents/tool-explore-entry.json +92 -0
  20. package/agents/tool-explore-patterns.json +92 -0
  21. package/agents/tool-explore-structure.json +92 -0
  22. package/agents/tool-explore-tests.json +92 -0
  23. package/agents/tool-planner.json +57 -0
  24. package/agents/tool-playwright.json +145 -0
  25. package/agents/tool-security-reviewer.json +56 -0
  26. package/agents/tool-verifier.json +61 -0
  27. package/agents/tool-worker.json +58 -0
  28. package/build/src/cli/console-learning-projection.js +123 -0
  29. package/build/src/cli/docs-preview.js +39 -0
  30. package/build/src/cli/effective-backlog-settings.js +102 -0
  31. package/build/src/cli/export-bookmarks.js +38 -0
  32. package/build/src/cli/fixture-retirement-audit.js +140 -0
  33. package/build/src/cli/flow-kit.js +138 -0
  34. package/build/src/cli/import-bookmarks.js +50 -0
  35. package/build/src/cli/init.js +239 -0
  36. package/build/src/cli/instinct-cli.js +93 -0
  37. package/build/src/cli/promote-workflow-artifact.js +63 -0
  38. package/build/src/cli/publish-change-helper.js +154 -0
  39. package/build/src/cli/pull-work-provider.js +469 -0
  40. package/build/src/cli/runtime-adapter.js +23 -0
  41. package/build/src/cli/telemetry-doctor.js +221 -0
  42. package/build/src/cli/usage-feedback.js +443 -0
  43. package/build/src/cli/validate-hook-influence.js +152 -0
  44. package/build/src/cli/validate-source-tree.js +31 -0
  45. package/build/src/cli/validate-workflow-artifacts.js +486 -0
  46. package/build/src/cli/veritas-governance.js +262 -0
  47. package/build/src/cli/workflow-artifact-cleanup-audit.js +272 -0
  48. package/build/src/cli/workflow-sidecar.js +816 -0
  49. package/build/src/cli.js +89 -0
  50. package/build/src/flow-kit/validate.js +75 -0
  51. package/build/src/lib/args.js +45 -0
  52. package/build/src/lib/fs.js +62 -0
  53. package/build/src/lib/workflow-learning-projection.js +334 -0
  54. package/build/src/runtime-adapters.js +146 -0
  55. package/build/src/tools/build-universal-bundles.js +397 -0
  56. package/build/src/tools/common.js +56 -0
  57. package/build/src/tools/filter-installed-packs.js +132 -0
  58. package/build/src/tools/generate-context-map.js +198 -0
  59. package/build/src/tools/validate-package.js +64 -0
  60. package/build/src/tools/validate-source-tree.js +622 -0
  61. package/console.telemetry.json +176 -0
  62. package/context/base-rules.md +17 -0
  63. package/context/code-review-standards.md +62 -0
  64. package/context/coding-standards.md +42 -0
  65. package/context/common/orchestrators.md +12 -0
  66. package/context/common/subagents.md +28 -0
  67. package/context/contracts/artifact-contract.md +182 -0
  68. package/context/contracts/builder-kit-workflow-state-contract.md +319 -0
  69. package/context/contracts/delivery-contract.md +69 -0
  70. package/context/contracts/execution-contract.md +53 -0
  71. package/context/contracts/governance-adapter-contract.md +67 -0
  72. package/context/contracts/planning-contract.md +85 -0
  73. package/context/contracts/review-contract.md +104 -0
  74. package/context/contracts/sandbox-policy.md +52 -0
  75. package/context/contracts/verification-contract.md +134 -0
  76. package/context/contracts/work-item-contract.md +215 -0
  77. package/context/deferred/demo-mode.md +33 -0
  78. package/context/deferred/languages/go.md +31 -0
  79. package/context/deferred/languages/python.md +31 -0
  80. package/context/deferred/languages/typescript.md +34 -0
  81. package/context/deferred/parallelization.md +35 -0
  82. package/context/deferred/worktree-isolation.md +24 -0
  83. package/context/development-workflow.md +50 -0
  84. package/context/scripts/context-budget/budget-scan.sh +166 -0
  85. package/context/scripts/detect-tools.sh +3 -0
  86. package/context/scripts/discover-agents.sh +28 -0
  87. package/context/scripts/git-status.sh +49 -0
  88. package/context/scripts/hooks/config-protection.js +79 -0
  89. package/context/scripts/hooks/desktop-notify.sh +39 -0
  90. package/context/scripts/hooks/governance-audit.sh +135 -0
  91. package/context/scripts/hooks/lib/audit-transport.sh +40 -0
  92. package/context/scripts/hooks/lib/hook-flags.js +49 -0
  93. package/context/scripts/hooks/lib/patterns.sh +57 -0
  94. package/context/scripts/hooks/lib/resolve-formatter.js +80 -0
  95. package/context/scripts/hooks/post-edit-accumulator.js +66 -0
  96. package/context/scripts/hooks/pre-commit-quality.js +194 -0
  97. package/context/scripts/hooks/quality-gate.js +93 -0
  98. package/context/scripts/hooks/report-only-guard.js +21 -0
  99. package/context/scripts/hooks/run-hook.js +136 -0
  100. package/context/scripts/hooks/stop-format-typecheck.js +141 -0
  101. package/context/scripts/hooks/stop-goal-fit.js +337 -0
  102. package/context/scripts/hooks/workflow-steering.js +250 -0
  103. package/context/scripts/telemetry/console-presets.sh +14 -0
  104. package/context/scripts/telemetry/install-console-config.sh +214 -0
  105. package/context/scripts/telemetry/lib/config.sh +85 -0
  106. package/context/scripts/telemetry/lib/enrich.sh +115 -0
  107. package/context/scripts/telemetry/lib/redact.sh +22 -0
  108. package/context/scripts/telemetry/lib/session.sh +63 -0
  109. package/context/scripts/telemetry/lib/transport.sh +183 -0
  110. package/context/scripts/telemetry/lib/usage.sh +29 -0
  111. package/context/scripts/telemetry/sync-agents.sh +173 -0
  112. package/context/scripts/telemetry/telemetry.conf +23 -0
  113. package/context/scripts/telemetry/telemetry.sh +387 -0
  114. package/context/scripts/validate-package.sh +89 -0
  115. package/context/settings/backlog-provider-settings.json +54 -0
  116. package/context/templates/core/identity.md +26 -0
  117. package/context/templates/core/user.md +15 -0
  118. package/docs/_config.yml +15 -0
  119. package/docs/_layouts/default.html +87 -0
  120. package/docs/adr/0001-flow-agents-consumes-flow.md +77 -0
  121. package/docs/adr/0002-flow-kits-as-extension-unit.md +13 -0
  122. package/docs/adr/0003-flow-agents-coordinates-kits-and-adapters.md +13 -0
  123. package/docs/adr/0004-gates-expect-surface-claims.md +15 -0
  124. package/docs/adr/0005-kubernetes-inspired-resource-contracts.md +48 -0
  125. package/docs/adr/0006-typescript-first-source-policy.md +98 -0
  126. package/docs/agent-system-guidebook.md +391 -0
  127. package/docs/agent-usage-feedback-loop.md +351 -0
  128. package/docs/assets/favicon.svg +13 -0
  129. package/docs/assets/og-image.png +0 -0
  130. package/docs/assets/site.css +774 -0
  131. package/docs/assets/site.js +139 -0
  132. package/docs/configurable-workflow-routing.md +174 -0
  133. package/docs/context-map.md +145 -0
  134. package/docs/developer-architecture.md +145 -0
  135. package/docs/developer-hook-setup.md +61 -0
  136. package/docs/fixture-ownership.md +44 -0
  137. package/docs/flow-kit-repository-contract.md +180 -0
  138. package/docs/index.md +129 -0
  139. package/docs/kontour-resource-contract.md +358 -0
  140. package/docs/migrations.md +64 -0
  141. package/docs/north-star.md +322 -0
  142. package/docs/operating-layers.md +110 -0
  143. package/docs/repository-structure.md +132 -0
  144. package/docs/sandbox-policy.md +56 -0
  145. package/docs/skills-map.md +203 -0
  146. package/docs/standards-register.md +96 -0
  147. package/docs/veritas-integration.md +165 -0
  148. package/docs/work-item-adapters.md +72 -0
  149. package/docs/workflow-artifact-lifecycle.md +141 -0
  150. package/docs/workflow-eval-strategy.md +295 -0
  151. package/docs/workflow-shared-contracts.md +51 -0
  152. package/docs/workflow-usage-guide.md +443 -0
  153. package/evals/ARCHITECTURE.md +143 -0
  154. package/evals/CONVENTIONS.md +58 -0
  155. package/evals/README.md +128 -0
  156. package/evals/acceptance/run.sh +29 -0
  157. package/evals/acceptance/test_claude_harness.sh +242 -0
  158. package/evals/acceptance/test_codex_harness.sh +108 -0
  159. package/evals/acceptance/test_kiro_harness.sh +128 -0
  160. package/evals/cases/dev/404.html +97 -0
  161. package/evals/cases/dev/code-review.yaml +44 -0
  162. package/evals/cases/dev/dashboard.html +300 -0
  163. package/evals/cases/dev/deliver.yaml +66 -0
  164. package/evals/cases/dev/dependency-update.yaml +16 -0
  165. package/evals/cases/dev/explore.yaml +20 -0
  166. package/evals/cases/dev/index.html +370 -0
  167. package/evals/cases/dev/package-lock.json +28 -0
  168. package/evals/cases/dev/package.json +16 -0
  169. package/evals/cases/dev/plan-work.yaml +20 -0
  170. package/evals/cases/dev/promptfooconfig.yaml +666 -0
  171. package/evals/cases/dev/search-first.yaml +20 -0
  172. package/evals/cases/dev/tdd-workflow.yaml +48 -0
  173. package/evals/cases/dev/verify-work.yaml +44 -0
  174. package/evals/cases/dev/workflow.yaml +34 -0
  175. package/evals/ci/run-baseline.sh +283 -0
  176. package/evals/fixtures/backlog-provider-settings/global-default.json +44 -0
  177. package/evals/fixtures/backlog-provider-settings/project-override.json +53 -0
  178. package/evals/fixtures/builder-kit-workflow-state/baseline-freshness-resolution-hint.json +139 -0
  179. package/evals/fixtures/builder-kit-workflow-state/direct-primitive-stop.json +59 -0
  180. package/evals/fixtures/builder-kit-workflow-state/empty-board-route-shape.json +55 -0
  181. package/evals/fixtures/builder-kit-workflow-state/happy-path.json +71 -0
  182. package/evals/fixtures/builder-kit-workflow-state/mid-work-resume.json +80 -0
  183. package/evals/fixtures/builder-kit-workflow-state/missing-prestep-recovery.json +65 -0
  184. package/evals/fixtures/builder-kit-workflow-state/product-build-chaining.json +60 -0
  185. package/evals/fixtures/builder-kit-workflow-state/stale-continuation-requires-new-probe.json +57 -0
  186. package/evals/fixtures/console-learning-projection/artifacts/console-learning-correction/learning.json +50 -0
  187. package/evals/fixtures/console-learning-projection/artifacts/console-learning-open-route/learning.json +41 -0
  188. package/evals/fixtures/flow-kit-repository/invalid-absolute-path/kit.json +8 -0
  189. package/evals/fixtures/flow-kit-repository/invalid-asset-section/flows/review.flow.json +6 -0
  190. package/evals/fixtures/flow-kit-repository/invalid-asset-section/kit.json +11 -0
  191. package/evals/fixtures/flow-kit-repository/invalid-duplicate-flow/flows/review.flow.json +6 -0
  192. package/evals/fixtures/flow-kit-repository/invalid-duplicate-flow/kit.json +9 -0
  193. package/evals/fixtures/flow-kit-repository/invalid-id/flows/review.flow.json +6 -0
  194. package/evals/fixtures/flow-kit-repository/invalid-id/kit.json +8 -0
  195. package/evals/fixtures/flow-kit-repository/invalid-malformed-json/kit.json +8 -0
  196. package/evals/fixtures/flow-kit-repository/invalid-missing-flow/kit.json +8 -0
  197. package/evals/fixtures/flow-kit-repository/invalid-missing-id/flows/review.flow.json +6 -0
  198. package/evals/fixtures/flow-kit-repository/invalid-missing-id/kit.json +7 -0
  199. package/evals/fixtures/flow-kit-repository/invalid-missing-schema-version/flows/review.flow.json +6 -0
  200. package/evals/fixtures/flow-kit-repository/invalid-missing-schema-version/kit.json +7 -0
  201. package/evals/fixtures/flow-kit-repository/invalid-name/flows/review.flow.json +6 -0
  202. package/evals/fixtures/flow-kit-repository/invalid-name/kit.json +8 -0
  203. package/evals/fixtures/flow-kit-repository/invalid-schema-version/flows/review.flow.json +6 -0
  204. package/evals/fixtures/flow-kit-repository/invalid-schema-version/kit.json +8 -0
  205. package/evals/fixtures/flow-kit-repository/invalid-traversal/kit.json +8 -0
  206. package/evals/fixtures/flow-kit-repository/mixed-runtime-kit/adapters/example.json +3 -0
  207. package/evals/fixtures/flow-kit-repository/mixed-runtime-kit/assets/example.txt +1 -0
  208. package/evals/fixtures/flow-kit-repository/mixed-runtime-kit/docs/README.md +3 -0
  209. package/evals/fixtures/flow-kit-repository/mixed-runtime-kit/flows/runtime.flow.json +26 -0
  210. package/evals/fixtures/flow-kit-repository/mixed-runtime-kit/kit-evals/example.json +3 -0
  211. package/evals/fixtures/flow-kit-repository/mixed-runtime-kit/kit-skills/mixed/SKILL.md +3 -0
  212. package/evals/fixtures/flow-kit-repository/mixed-runtime-kit/kit.json +44 -0
  213. package/evals/fixtures/flow-kit-repository/valid-local-kit/docs/README.md +3 -0
  214. package/evals/fixtures/flow-kit-repository/valid-local-kit/flows/review.flow.json +26 -0
  215. package/evals/fixtures/flow-kit-repository/valid-local-kit/kit.json +20 -0
  216. package/evals/fixtures/hook-influence/cases.json +336 -0
  217. package/evals/fixtures/pull-work-provider/github-issues.json +170 -0
  218. package/evals/fixtures/pull-work-wip-shepherding/global-wip-informs.json +43 -0
  219. package/evals/fixtures/pull-work-wip-shepherding/personal-wip-blocks.json +42 -0
  220. package/evals/fixtures/surface-trust/accepted-claim-trust-report.json +31 -0
  221. package/evals/fixtures/surface-trust/artifact-absent.json +19 -0
  222. package/evals/fixtures/surface-trust/integrity-mismatch-trust-report.json +32 -0
  223. package/evals/fixtures/surface-trust/missing-authority-trust-report.json +27 -0
  224. package/evals/fixtures/surface-trust/provider-absent.json +19 -0
  225. package/evals/fixtures/surface-trust/rejected-claim-trust-report.json +30 -0
  226. package/evals/fixtures/surface-trust/stale-claim-trust-snapshot.json +31 -0
  227. package/evals/fixtures/usage-feedback/sample-full.jsonl +11 -0
  228. package/evals/fixtures/usage-feedback/sample-outcomes.jsonl +1 -0
  229. package/evals/fixtures/veritas-governance-adapter/fake-veritas-pass.sh +18 -0
  230. package/evals/fixtures/veritas-governance-adapter/fake-veritas-secret-fail.sh +10 -0
  231. package/evals/fixtures/veritas-governance-adapter/fake-veritas-unconfigured.sh +4 -0
  232. package/evals/integration/test_bundle_install.sh +541 -0
  233. package/evals/integration/test_console_learning_projection.sh +192 -0
  234. package/evals/integration/test_context_map.sh +65 -0
  235. package/evals/integration/test_effective_backlog_settings.sh +58 -0
  236. package/evals/integration/test_fixture_retirement_audit.sh +58 -0
  237. package/evals/integration/test_flow_agents_statusline.sh +93 -0
  238. package/evals/integration/test_flow_kit_repository.sh +90 -0
  239. package/evals/integration/test_goal_fit_hook.sh +482 -0
  240. package/evals/integration/test_hook_category_behaviors.sh +190 -0
  241. package/evals/integration/test_hook_influence_cases.sh +69 -0
  242. package/evals/integration/test_local_flow_kit_install.sh +145 -0
  243. package/evals/integration/test_publish_change_helper.sh +176 -0
  244. package/evals/integration/test_pull_work_provider.sh +140 -0
  245. package/evals/integration/test_runtime_adapter_activation.sh +106 -0
  246. package/evals/integration/test_telemetry.sh +485 -0
  247. package/evals/integration/test_telemetry_doctor.sh +193 -0
  248. package/evals/integration/test_usage_feedback_dashboard.sh +169 -0
  249. package/evals/integration/test_usage_feedback_global.sh +117 -0
  250. package/evals/integration/test_usage_feedback_import.sh +227 -0
  251. package/evals/integration/test_usage_feedback_outcomes.sh +165 -0
  252. package/evals/integration/test_usage_feedback_report.sh +263 -0
  253. package/evals/integration/test_veritas_governance_adapter.sh +235 -0
  254. package/evals/integration/test_workflow_artifact_cleanup_audit.sh +287 -0
  255. package/evals/integration/test_workflow_artifacts.sh +1247 -0
  256. package/evals/integration/test_workflow_sidecar_writer.sh +2112 -0
  257. package/evals/integration/test_workflow_steering_hook.sh +337 -0
  258. package/evals/lib/assertions/delegated-to.js +40 -0
  259. package/evals/lib/assertions/max-tool-calls.js +15 -0
  260. package/evals/lib/assertions/no-write-tools.js +27 -0
  261. package/evals/lib/assertions/pass-at-k.js +39 -0
  262. package/evals/lib/assertions/telemetry-utils.js +105 -0
  263. package/evals/lib/assertions/tool-called.js +39 -0
  264. package/evals/lib/assertions/verify-after-fix.js +61 -0
  265. package/evals/lib/claude-judge.sh +40 -0
  266. package/evals/lib/claude-provider.sh +74 -0
  267. package/evals/lib/codex-judge.sh +39 -0
  268. package/evals/lib/codex-provider.sh +81 -0
  269. package/evals/lib/eval-dev.sh +5 -0
  270. package/evals/lib/eval-judge.sh +22 -0
  271. package/evals/lib/eval-provider.sh +26 -0
  272. package/evals/lib/eval-report.sh +73 -0
  273. package/evals/lib/kiro-dev.sh +4 -0
  274. package/evals/lib/kiro-judge.sh +17 -0
  275. package/evals/lib/kiro-provider.sh +62 -0
  276. package/evals/lib/node.sh +111 -0
  277. package/evals/promptfooconfig.yaml +70 -0
  278. package/evals/run.sh +309 -0
  279. package/evals/static/test_evidence_refs.sh +141 -0
  280. package/evals/static/test_package.sh +407 -0
  281. package/evals/static/test_repo_hooks.sh +68 -0
  282. package/evals/static/test_universal_bundles.sh +274 -0
  283. package/evals/static/test_workflow_skills.sh +1207 -0
  284. package/install.sh +64 -0
  285. package/integrations/veritas/flow-agents.adapter.json +138 -0
  286. package/integrations/veritas/flow-agents.authority-settings.json +26 -0
  287. package/integrations/veritas/flow-agents.repo-standards.json +82 -0
  288. package/kits/builder/flows/build.flow.json +218 -0
  289. package/kits/builder/flows/shape.flow.json +127 -0
  290. package/kits/builder/kit.json +19 -0
  291. package/kits/catalog.json +11 -0
  292. package/package.json +130 -0
  293. package/packaging/README.md +60 -0
  294. package/packaging/manifest.json +173 -0
  295. package/packaging/packs.json +69 -0
  296. package/powers/dependency-checker/POWER.md +20 -0
  297. package/powers/dependency-checker/mcp.json +20 -0
  298. package/powers/playwright/POWER.md +25 -0
  299. package/powers/playwright/mcp.json +12 -0
  300. package/prompts/code-audit.md +123 -0
  301. package/prompts/kcommit.md +88 -0
  302. package/schemas/backlog-provider-settings.schema.json +138 -0
  303. package/schemas/workflow-acceptance.schema.json +216 -0
  304. package/schemas/workflow-critique.schema.json +113 -0
  305. package/schemas/workflow-evidence.schema.json +357 -0
  306. package/schemas/workflow-handoff.schema.json +52 -0
  307. package/schemas/workflow-learning.schema.json +223 -0
  308. package/schemas/workflow-release.schema.json +172 -0
  309. package/schemas/workflow-state.schema.json +80 -0
  310. package/scripts/README.md +111 -0
  311. package/scripts/build-universal-bundles.js +3 -0
  312. package/scripts/check-content-boundary.cjs +99 -0
  313. package/scripts/context-budget/budget-scan.sh +166 -0
  314. package/scripts/detect-tools.sh +3 -0
  315. package/scripts/discover-agents.sh +28 -0
  316. package/scripts/effective-backlog-settings.js +2 -0
  317. package/scripts/filter-installed-packs.js +2 -0
  318. package/scripts/flow-kit.js +2 -0
  319. package/scripts/generate-context-map.js +2 -0
  320. package/scripts/git-status.sh +49 -0
  321. package/scripts/hooks/claude-hook-adapter.js +174 -0
  322. package/scripts/hooks/claude-telemetry-hook.js +115 -0
  323. package/scripts/hooks/codex-hook-adapter.js +176 -0
  324. package/scripts/hooks/codex-telemetry-hook.js +95 -0
  325. package/scripts/hooks/config-protection.js +79 -0
  326. package/scripts/hooks/desktop-notify.sh +39 -0
  327. package/scripts/hooks/governance-audit.sh +135 -0
  328. package/scripts/hooks/lib/audit-transport.sh +40 -0
  329. package/scripts/hooks/lib/hook-flags.js +49 -0
  330. package/scripts/hooks/lib/patterns.sh +57 -0
  331. package/scripts/hooks/lib/resolve-formatter.js +80 -0
  332. package/scripts/hooks/post-edit-accumulator.js +66 -0
  333. package/scripts/hooks/pre-commit-quality.js +194 -0
  334. package/scripts/hooks/quality-gate.js +93 -0
  335. package/scripts/hooks/report-only-guard.js +21 -0
  336. package/scripts/hooks/run-hook.js +136 -0
  337. package/scripts/hooks/stop-format-typecheck.js +141 -0
  338. package/scripts/hooks/stop-goal-fit.js +337 -0
  339. package/scripts/hooks/workflow-steering.js +250 -0
  340. package/scripts/install-codex-home.sh +106 -0
  341. package/scripts/package.json +3 -0
  342. package/scripts/promote-workflow-artifact.js +2 -0
  343. package/scripts/publish-change-helper.js +2 -0
  344. package/scripts/pull-work-provider.js +2 -0
  345. package/scripts/setup-repo-hooks.sh +8 -0
  346. package/scripts/statusline/flow-agents-statusline.js +157 -0
  347. package/scripts/telemetry/console-presets.sh +14 -0
  348. package/scripts/telemetry/install-console-config.sh +214 -0
  349. package/scripts/telemetry/lib/config.sh +85 -0
  350. package/scripts/telemetry/lib/enrich.sh +115 -0
  351. package/scripts/telemetry/lib/redact.sh +22 -0
  352. package/scripts/telemetry/lib/session.sh +63 -0
  353. package/scripts/telemetry/lib/transport.sh +183 -0
  354. package/scripts/telemetry/lib/usage.sh +29 -0
  355. package/scripts/telemetry/sync-agents.sh +173 -0
  356. package/scripts/telemetry/telemetry.conf +23 -0
  357. package/scripts/telemetry/telemetry.sh +387 -0
  358. package/scripts/usage-feedback.js +2 -0
  359. package/scripts/validate-hook-influence-cases.js +2 -0
  360. package/scripts/validate-package.sh +89 -0
  361. package/scripts/validate-source-tree.js +9 -0
  362. package/skills/agentic-engineering/SKILL.md +62 -0
  363. package/skills/browser-test/SKILL.md +51 -0
  364. package/skills/builder-shape/SKILL.md +76 -0
  365. package/skills/context-budget/SKILL.md +40 -0
  366. package/skills/deliver/SKILL.md +241 -0
  367. package/skills/dependency-update/SKILL.md +68 -0
  368. package/skills/design-probe/SKILL.md +107 -0
  369. package/skills/eval-rebuild/SKILL.md +39 -0
  370. package/skills/evidence-gate/SKILL.md +186 -0
  371. package/skills/execute-plan/SKILL.md +110 -0
  372. package/skills/explore/SKILL.md +137 -0
  373. package/skills/feedback-loop/SKILL.md +87 -0
  374. package/skills/fix-bug/SKILL.md +133 -0
  375. package/skills/frontend-design/SKILL.md +80 -0
  376. package/skills/github-cli/SKILL.md +63 -0
  377. package/skills/idea-to-backlog/SKILL.md +267 -0
  378. package/skills/knowledge-capture/SKILL.md +55 -0
  379. package/skills/learning-review/SKILL.md +115 -0
  380. package/skills/pickup-probe/SKILL.md +114 -0
  381. package/skills/plan-work/SKILL.md +176 -0
  382. package/skills/pull-work/SKILL.md +309 -0
  383. package/skills/release-readiness/SKILL.md +121 -0
  384. package/skills/review-work/SKILL.md +161 -0
  385. package/skills/search-first/SKILL.md +66 -0
  386. package/skills/tdd-workflow/SKILL.md +140 -0
  387. package/skills/verify-work/SKILL.md +109 -0
  388. package/src/cli/console-learning-projection.ts +140 -0
  389. package/src/cli/effective-backlog-settings.ts +99 -0
  390. package/src/cli/fixture-retirement-audit.ts +154 -0
  391. package/src/cli/flow-kit.ts +139 -0
  392. package/src/cli/init.ts +248 -0
  393. package/src/cli/promote-workflow-artifact.ts +64 -0
  394. package/src/cli/publish-change-helper.ts +143 -0
  395. package/src/cli/pull-work-provider.ts +481 -0
  396. package/src/cli/runtime-adapter.ts +24 -0
  397. package/src/cli/telemetry-doctor.ts +243 -0
  398. package/src/cli/usage-feedback.ts +418 -0
  399. package/src/cli/validate-hook-influence.ts +119 -0
  400. package/src/cli/validate-source-tree.ts +30 -0
  401. package/src/cli/validate-workflow-artifacts.ts +411 -0
  402. package/src/cli/veritas-governance.ts +322 -0
  403. package/src/cli/workflow-artifact-cleanup-audit.ts +281 -0
  404. package/src/cli/workflow-sidecar.ts +676 -0
  405. package/src/cli.ts +95 -0
  406. package/src/flow-kit/validate.ts +74 -0
  407. package/src/lib/args.ts +43 -0
  408. package/src/lib/fs.ts +62 -0
  409. package/src/lib/workflow-learning-projection.ts +491 -0
  410. package/src/runtime-adapters.ts +154 -0
  411. package/src/tools/build-universal-bundles.ts +366 -0
  412. package/src/tools/common.ts +61 -0
  413. package/src/tools/filter-installed-packs.ts +129 -0
  414. package/src/tools/generate-context-map.ts +199 -0
  415. package/src/tools/validate-package.ts +57 -0
  416. package/src/tools/validate-source-tree.ts +488 -0
  417. package/tsconfig.json +19 -0
  418. package/veritas.claims.json +6 -0
package/schemas/workflow-evidence.schema.json ADDED
@@ -0,0 +1,357 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://flow-agents.dev/schemas/workflow-evidence.schema.json",
4
+ "title": "Flow Agents Workflow Evidence",
5
+ "type": "object",
6
+ "additionalProperties": false,
7
+ "required": [
8
+ "schema_version",
9
+ "task_slug",
10
+ "verdict",
11
+ "checks"
12
+ ],
13
+ "$defs": {
14
+ "evidence_ref": {
15
+ "type": "object",
16
+ "additionalProperties": false,
17
+ "required": ["kind"],
18
+ "properties": {
19
+ "kind": {
20
+ "type": "string",
21
+ "enum": ["source", "command", "artifact", "provider", "external"]
22
+ },
23
+ "url": {
24
+ "type": "string",
25
+ "minLength": 1
26
+ },
27
+ "file": {
28
+ "type": "string",
29
+ "minLength": 1
30
+ },
31
+ "line_start": {
32
+ "type": "integer",
33
+ "minimum": 1
34
+ },
35
+ "line_end": {
36
+ "type": "integer",
37
+ "minimum": 1
38
+ },
39
+ "excerpt": {
40
+ "type": "string",
41
+ "minLength": 1
42
+ },
43
+ "summary": {
44
+ "type": "string",
45
+ "minLength": 1
46
+ }
47
+ },
48
+ "allOf": [
49
+ {
50
+ "if": {
51
+ "type": "object",
52
+ "properties": {
53
+ "kind": {
54
+ "const": "source"
55
+ }
56
+ },
57
+ "required": ["kind"]
58
+ },
59
+ "then": {
60
+ "required": ["file", "line_start", "line_end", "excerpt"]
61
+ }
62
+ },
63
+ {
64
+ "if": {
65
+ "type": "object",
66
+ "properties": {
67
+ "kind": {
68
+ "const": "artifact"
69
+ }
70
+ },
71
+ "required": ["kind"]
72
+ },
73
+ "then": {
74
+ "allOf": [
75
+ {
76
+ "anyOf": [
77
+ {
78
+ "type": "object",
79
+ "required": ["file"]
80
+ },
81
+ {
82
+ "type": "object",
83
+ "required": ["url"]
84
+ }
85
+ ]
86
+ },
87
+ {
88
+ "anyOf": [
89
+ {
90
+ "type": "object",
91
+ "required": ["summary"]
92
+ },
93
+ {
94
+ "type": "object",
95
+ "required": ["excerpt"]
96
+ }
97
+ ]
98
+ }
99
+ ]
100
+ }
101
+ },
102
+ {
103
+ "if": {
104
+ "type": "object",
105
+ "properties": {
106
+ "kind": {
107
+ "const": "command"
108
+ }
109
+ },
110
+ "required": ["kind"]
111
+ },
112
+ "then": {
113
+ "anyOf": [
114
+ {
115
+ "type": "object",
116
+ "required": ["excerpt"]
117
+ },
118
+ {
119
+ "type": "object",
120
+ "required": ["summary"]
121
+ },
122
+ {
123
+ "type": "object",
124
+ "required": ["url"]
125
+ }
126
+ ]
127
+ }
128
+ },
129
+ {
130
+ "if": {
131
+ "type": "object",
132
+ "properties": {
133
+ "kind": {
134
+ "enum": ["provider", "external"]
135
+ }
136
+ },
137
+ "required": ["kind"]
138
+ },
139
+ "then": {
140
+ "required": ["url"]
141
+ }
142
+ }
143
+ ]
144
+ }
145
+ },
146
+ "properties": {
147
+ "schema_version": {
148
+ "type": "string",
149
+ "const": "1.0"
150
+ },
151
+ "task_slug": {
152
+ "type": "string",
153
+ "minLength": 1
154
+ },
155
+ "repo": {
156
+ "type": "string",
157
+ "minLength": 1
158
+ },
159
+ "verdict": {
160
+ "type": "string",
161
+ "enum": ["pass", "partial", "fail", "not_verified"]
162
+ },
163
+ "checks": {
164
+ "type": "array",
165
+ "minItems": 1,
166
+ "items": {
167
+ "type": "object",
168
+ "additionalProperties": false,
169
+ "required": ["id", "kind", "status", "summary"],
170
+ "properties": {
171
+ "id": {
172
+ "type": "string",
173
+ "minLength": 1
174
+ },
175
+ "kind": {
176
+ "type": "string",
177
+ "enum": ["build", "types", "lint", "test", "security", "diff", "browser", "runtime", "policy", "external"]
178
+ },
179
+ "status": {
180
+ "type": "string",
181
+ "enum": ["pass", "fail", "not_verified", "skip"]
182
+ },
183
+ "command": {
184
+ "type": "string"
185
+ },
186
+ "summary": {
187
+ "type": "string",
188
+ "minLength": 1
189
+ },
190
+ "artifact_refs": {
191
+ "type": "array",
192
+ "items": {
193
+ "$ref": "#/$defs/evidence_ref"
194
+ },
195
+ "uniqueItems": true
196
+ },
197
+ "standard_refs": {
198
+ "type": "array",
199
+ "items": {
200
+ "type": "object",
201
+ "additionalProperties": false,
202
+ "required": ["standard", "ref"],
203
+ "properties": {
204
+ "standard": {
205
+ "type": "string",
206
+ "enum": ["sarif", "opentelemetry-log", "opentelemetry-trace", "junit", "tap", "veritas", "custom"]
207
+ },
208
+ "ref": {
209
+ "type": "string",
210
+ "minLength": 1
211
+ },
212
+ "role": {
213
+ "type": "string",
214
+ "enum": ["native", "export", "source", "mapping"]
215
+ },
216
+ "summary": {
217
+ "type": "string"
218
+ }
219
+ }
220
+ }
221
+ },
222
+ "surface_trust_refs": {
223
+ "type": "array",
224
+ "items": {
225
+ "type": "object",
226
+ "additionalProperties": false,
227
+ "required": [
228
+ "artifact_kind",
229
+ "artifact_ref",
230
+ "gate_id",
231
+ "claim_type",
232
+ "claim_status",
233
+ "subject",
234
+ "freshness",
235
+ "authority",
236
+ "integrity",
237
+ "status"
238
+ ],
239
+ "properties": {
240
+ "artifact_kind": {
241
+ "type": "string",
242
+ "enum": ["TrustReport", "Trust Snapshot"]
243
+ },
244
+ "artifact_ref": {
245
+ "type": "string",
246
+ "minLength": 1
247
+ },
248
+ "gate_id": {
249
+ "type": "string",
250
+ "minLength": 1
251
+ },
252
+ "claim_type": {
253
+ "type": "string",
254
+ "minLength": 1
255
+ },
256
+ "claim_status": {
257
+ "type": "string",
258
+ "minLength": 1
259
+ },
260
+ "subject": {
261
+ "type": "string",
262
+ "minLength": 1
263
+ },
264
+ "freshness": {
265
+ "type": "object",
266
+ "additionalProperties": false,
267
+ "required": ["status", "summary"],
268
+ "properties": {
269
+ "status": {
270
+ "type": "string",
271
+ "enum": ["fresh", "stale", "expired", "unknown"]
272
+ },
273
+ "summary": {
274
+ "type": "string",
275
+ "minLength": 1
276
+ }
277
+ }
278
+ },
279
+ "authority": {
280
+ "type": "object",
281
+ "additionalProperties": false,
282
+ "required": ["producer", "summary"],
283
+ "properties": {
284
+ "producer": {
285
+ "type": "string",
286
+ "minLength": 1
287
+ },
288
+ "summary": {
289
+ "type": "string",
290
+ "minLength": 1
291
+ }
292
+ }
293
+ },
294
+ "integrity": {
295
+ "type": "object",
296
+ "additionalProperties": false,
297
+ "required": ["status", "summary"],
298
+ "properties": {
299
+ "status": {
300
+ "type": "string",
301
+ "enum": ["matched", "mismatch", "unknown"]
302
+ },
303
+ "summary": {
304
+ "type": "string",
305
+ "minLength": 1
306
+ },
307
+ "digest": {
308
+ "type": "string",
309
+ "minLength": 1
310
+ }
311
+ }
312
+ },
313
+ "status": {
314
+ "type": "string",
315
+ "enum": ["pass", "fail", "not_verified"]
316
+ },
317
+ "summary": {
318
+ "type": "string"
319
+ }
320
+ }
321
+ },
322
+ "uniqueItems": true
323
+ }
324
+ }
325
+ }
326
+ },
327
+ "external_evidence": {
328
+ "type": "array",
329
+ "items": {
330
+ "type": "object",
331
+ "additionalProperties": false,
332
+ "required": ["system", "ref"],
333
+ "properties": {
334
+ "system": {
335
+ "type": "string"
336
+ },
337
+ "ref": {
338
+ "$ref": "#/$defs/evidence_ref"
339
+ },
340
+ "summary": {
341
+ "type": "string"
342
+ },
343
+ "standard": {
344
+ "type": "string",
345
+ "enum": ["sarif", "opentelemetry-log", "opentelemetry-trace", "junit", "tap", "veritas", "custom"]
346
+ }
347
+ }
348
+ }
349
+ },
350
+ "not_verified_gaps": {
351
+ "type": "array",
352
+ "items": {
353
+ "type": "string"
354
+ }
355
+ }
356
+ }
357
+ }
package/schemas/workflow-handoff.schema.json ADDED
@@ -0,0 +1,52 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://flow-agents.dev/schemas/workflow-handoff.schema.json",
4
+ "title": "Flow Agents Workflow Handoff",
5
+ "type": "object",
6
+ "additionalProperties": false,
7
+ "required": [
8
+ "schema_version",
9
+ "task_slug",
10
+ "summary",
11
+ "next_steps"
12
+ ],
13
+ "properties": {
14
+ "schema_version": {
15
+ "type": "string",
16
+ "const": "1.0"
17
+ },
18
+ "task_slug": {
19
+ "type": "string",
20
+ "minLength": 1
21
+ },
22
+ "repo": {
23
+ "type": "string",
24
+ "minLength": 1
25
+ },
26
+ "summary": {
27
+ "type": "string",
28
+ "minLength": 1
29
+ },
30
+ "current_state_ref": {
31
+ "type": "string"
32
+ },
33
+ "next_steps": {
34
+ "type": "array",
35
+ "items": {
36
+ "type": "string"
37
+ }
38
+ },
39
+ "blockers": {
40
+ "type": "array",
41
+ "items": {
42
+ "type": "string"
43
+ }
44
+ },
45
+ "warnings": {
46
+ "type": "array",
47
+ "items": {
48
+ "type": "string"
49
+ }
50
+ }
51
+ }
52
+ }
package/schemas/workflow-learning.schema.json ADDED
@@ -0,0 +1,223 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://flow-agents.dev/schemas/workflow-learning.schema.json",
4
+ "title": "Flow Agents Workflow Learning",
5
+ "type": "object",
6
+ "additionalProperties": false,
7
+ "required": [
8
+ "schema_version",
9
+ "task_slug",
10
+ "status",
11
+ "updated_at",
12
+ "records"
13
+ ],
14
+ "properties": {
15
+ "schema_version": {
16
+ "type": "string",
17
+ "const": "1.0"
18
+ },
19
+ "task_slug": {
20
+ "type": "string",
21
+ "minLength": 1
22
+ },
23
+ "repo": {
24
+ "type": "string",
25
+ "minLength": 1
26
+ },
27
+ "status": {
28
+ "type": "string",
29
+ "enum": ["pending", "learned", "followup_required", "blocked"]
30
+ },
31
+ "updated_at": {
32
+ "type": "string",
33
+ "format": "date-time"
34
+ },
35
+ "records": {
36
+ "type": "array",
37
+ "minItems": 1,
38
+ "items": {
39
+ "type": "object",
40
+ "additionalProperties": false,
41
+ "required": ["id", "recorded_at", "source_refs", "outcome", "facts", "interpretation", "routing"],
42
+ "properties": {
43
+ "id": {
44
+ "type": "string",
45
+ "minLength": 1
46
+ },
47
+ "recorded_at": {
48
+ "type": "string",
49
+ "format": "date-time"
50
+ },
51
+ "source_refs": {
52
+ "type": "array",
53
+ "minItems": 1,
54
+ "items": {
55
+ "type": "string",
56
+ "minLength": 1
57
+ },
58
+ "uniqueItems": true
59
+ },
60
+ "outcome": {
61
+ "type": "string",
62
+ "enum": ["success", "failure", "mixed", "unknown"]
63
+ },
64
+ "facts": {
65
+ "type": "array",
66
+ "minItems": 1,
67
+ "items": {
68
+ "type": "string",
69
+ "minLength": 1
70
+ }
71
+ },
72
+ "interpretation": {
73
+ "type": "string",
74
+ "minLength": 1
75
+ },
76
+ "routing": {
77
+ "type": "array",
78
+ "minItems": 1,
79
+ "items": {
80
+ "type": "object",
81
+ "additionalProperties": false,
82
+ "required": ["target", "action", "status"],
83
+ "properties": {
84
+ "target": {
85
+ "type": "string",
86
+ "enum": ["rule", "skill", "power", "agent", "eval", "doc", "backlog", "knowledge", "none"]
87
+ },
88
+ "action": {
89
+ "type": "string",
90
+ "minLength": 1
91
+ },
92
+ "status": {
93
+ "type": "string",
94
+ "enum": ["open", "completed", "accepted", "deferred", "rejected"]
95
+ },
96
+ "ref": {
97
+ "type": "string"
98
+ }
99
+ }
100
+ }
101
+ },
102
+ "correction": {
103
+ "type": "object",
104
+ "additionalProperties": false,
105
+ "required": ["needed"],
106
+ "allOf": [
107
+ {
108
+ "if": {
109
+ "properties": {
110
+ "needed": {
111
+ "const": false
112
+ }
113
+ },
114
+ "required": ["needed"]
115
+ },
116
+ "then": {
117
+ "required": ["evidence"]
118
+ }
119
+ },
120
+ {
121
+ "if": {
122
+ "properties": {
123
+ "needed": {
124
+ "const": true
125
+ }
126
+ },
127
+ "required": ["needed"]
128
+ },
129
+ "then": {
130
+ "required": ["type", "recurrence_key", "intended_behavior", "observed_behavior", "gap"],
131
+ "anyOf": [
132
+ {
133
+ "required": ["prevention"]
134
+ },
135
+ {
136
+ "required": ["no_change_rationale"]
137
+ }
138
+ ]
139
+ }
140
+ }
141
+ ],
142
+ "properties": {
143
+ "needed": {
144
+ "type": "boolean"
145
+ },
146
+ "type": {
147
+ "type": "string",
148
+ "enum": ["workflow", "skill", "agent", "tooling", "test", "doc", "process", "product", "provider", "none"]
149
+ },
150
+ "recurrence_key": {
151
+ "type": "string",
152
+ "minLength": 1
153
+ },
154
+ "intended_behavior": {
155
+ "type": "string",
156
+ "minLength": 1
157
+ },
158
+ "observed_behavior": {
159
+ "type": "string",
160
+ "minLength": 1
161
+ },
162
+ "gap": {
163
+ "type": "string",
164
+ "minLength": 1
165
+ },
166
+ "evidence": {
167
+ "type": "string",
168
+ "minLength": 1
169
+ },
170
+ "no_change_rationale": {
171
+ "type": "string",
172
+ "minLength": 1
173
+ },
174
+ "prevention": {
175
+ "type": "object",
176
+ "additionalProperties": false,
177
+ "required": ["target", "action", "status"],
178
+ "properties": {
179
+ "target": {
180
+ "type": "string",
181
+ "enum": ["rule", "skill", "power", "agent", "eval", "doc", "backlog", "knowledge", "none"]
182
+ },
183
+ "action": {
184
+ "type": "string",
185
+ "minLength": 1
186
+ },
187
+ "status": {
188
+ "type": "string",
189
+ "enum": ["open", "completed", "accepted", "deferred", "rejected"]
190
+ },
191
+ "ref": {
192
+ "type": "string"
193
+ }
194
+ }
195
+ }
196
+ }
197
+ }
198
+ }
199
+ }
200
+ }
201
+ },
202
+ "allOf": [
203
+ {
204
+ "if": {
205
+ "properties": {
206
+ "status": {
207
+ "const": "learned"
208
+ }
209
+ },
210
+ "required": ["status"]
211
+ },
212
+ "then": {
213
+ "properties": {
214
+ "records": {
215
+ "items": {
216
+ "required": ["correction"]
217
+ }
218
+ }
219
+ }
220
+ }
221
+ }
222
+ ]
223
+ }