@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/prompts/kcommit.md ADDED
@@ -0,0 +1,88 @@
1
+ ---
2
+ description: Group outstanding changes into logical commits following project conventions
3
+ ---
4
+ # Smart Commit
5
+
6
+ Analyze all outstanding changes in the working directory and organize them into logical, well-structured commits.
7
+
8
+ ## Workflow
9
+
10
+ ### Phase 1: ASSESS
11
+ 1. Run `git status` to see all modified, added, deleted, and untracked files
12
+ 2. Run `git diff` to understand the actual content changes (staged and unstaged)
13
+ 3. Run `git diff --cached` to see what's already staged
14
+ 4. **Triage untracked files** — for each untracked file/directory:
15
+ - Inspect its contents to understand what it is
16
+ - Check `.gitignore` to see if it *should* be ignored but isn't (→ suggest adding to `.gitignore`)
17
+ - Check if it contains secrets, credentials, build artifacts, or local-only state (→ suggest adding to `.gitignore`, do NOT commit)
18
+ - If it's legitimate project content (source, config, docs, skills) → include it in the commit plan
19
+ - If uncertain → ask the user whether to commit, ignore, or skip
20
+ 5. If there are no changes (tracked or untracked), inform the user and exit
21
+
22
+ ### Phase 2: DETECT COMMIT CONVENTIONS
23
+ 1. Check for project-level commit conventions:
24
+ - Read `AGENTS.md`, `CONTRIBUTING.md`, `README.md`, `.github/COMMIT_CONVENTION.md` or similar
25
+ - Check for commitlint config (`.commitlintrc`, `commitlint.config.js`, etc.)
26
+ - Check for `.czrc` or `cz.json` (commitizen config)
27
+ - Check `package.json` for commit-related config
28
+ 2. If project conventions found, use those
29
+ 3. If none found, default to [Conventional Commits](https://www.conventionalcommits.org/):
30
+ - Format: `<type>(<scope>): <description>`
31
+ - Types: feat, fix, docs, style, refactor, perf, test, build, ci, chore
32
+ - Lowercase, imperative mood, no period, under 72 chars
33
+ - Append `!` after type/scope for breaking changes
34
+
35
+ ### Phase 3: GROUP CHANGES
36
+ Analyze the changes and group them into logical commits based on:
37
+ - **Functional cohesion**: Changes that serve the same purpose belong together
38
+ - **File proximity**: Related files in the same module/feature area
39
+ - **Change type**: Separate features from fixes from refactors from docs
40
+ - **Dependencies**: If change B depends on change A, A commits first
41
+
42
+ Grouping rules:
43
+ - New feature files + their tests = one commit
44
+ - Config changes that support a feature = same commit as the feature OR separate if they're independently meaningful
45
+ - Unrelated bug fixes = separate commits
46
+ - Formatting/style-only changes = separate commit
47
+ - Documentation updates = separate commit unless they document a feature in the same batch
48
+
49
+ ### Phase 4: PROPOSE PLAN
50
+ Present the commit plan as a numbered list:
51
+
52
+ ```
53
+ Proposed commits (in order):
54
+
55
+ 1. feat(auth): add jwt token refresh endpoint
56
+ - src/auth/refresh.ts (new)
57
+ - src/auth/refresh.test.ts (new)
58
+ - src/auth/index.ts (modified - export)
59
+
60
+ 2. fix(api): handle null response in user lookup
61
+ - src/api/users.ts (modified)
62
+ ```
63
+
64
+ If running interactively, ask the user to confirm, modify, or reorder before proceeding.
65
+ If running non-interactively, proceed directly with your best judgment.
66
+
67
+ ### Phase 5: EXECUTE
68
+ For each commit group, in order:
69
+ 1. `git reset HEAD` (unstage everything first, only on first iteration)
70
+ 2. `git add <files>` for only the files in this group
71
+ 3. `git diff --cached --stat` to verify staged files match the group
72
+ 4. `git commit -m "<message>"`
73
+ - If a commit body is warranted (breaking change, complex change), use `-m "<subject>" -m "<body>"`
74
+ 5. Verify commit succeeded before moving to next group
75
+
76
+ ### Phase 6: VERIFY
77
+ 1. Run `git log --oneline -n <count>` to show the new commits
78
+ 2. Run `git status` to confirm working directory is clean (or show remaining untracked files)
79
+ 3. Note: commits are local only, no push was performed
80
+
81
+ ## Rules
82
+ - NEVER push to remote — local commits only
83
+ - NEVER force-add files that are in .gitignore
84
+ - NEVER commit secrets, credentials, or .env files
85
+ - NEVER amend or rebase existing commits unless explicitly asked
86
+ - If a file has mixed changes (part feature, part fix), ask the user whether to split with `git add -p` or keep together (if interactive), otherwise keep it in the commit where the primary change belongs
87
+ - Preserve any already-staged changes as a potential first commit group
88
+ - When in doubt about grouping, prefer fewer larger logical commits over many tiny ones
package/schemas/backlog-provider-settings.schema.json ADDED
@@ -0,0 +1,138 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://flow-agents.dev/schemas/backlog-provider-settings.schema.json",
4
+ "title": "Flow Agents Backlog Provider Settings",
5
+ "type": "object",
6
+ "additionalProperties": false,
7
+ "required": ["schema_version"],
8
+ "properties": {
9
+ "$schema": { "type": "string" },
10
+ "schema_version": { "const": "1.0" },
11
+ "defaults": { "$ref": "#/$defs/backlog_settings" },
12
+ "projects": {
13
+ "type": "array",
14
+ "items": { "$ref": "#/$defs/project_backlog_settings" }
15
+ }
16
+ },
17
+ "anyOf": [{ "required": ["defaults"] }, { "required": ["projects"] }],
18
+ "$defs": {
19
+ "project_backlog_settings": {
20
+ "allOf": [
21
+ { "$ref": "#/$defs/backlog_settings" },
22
+ { "type": "object", "required": ["project"] }
23
+ ]
24
+ },
25
+ "backlog_settings": {
26
+ "type": "object",
27
+ "additionalProperties": false,
28
+ "required": ["work_item_provider", "board_provider", "selection"],
29
+ "properties": {
30
+ "project": { "$ref": "#/$defs/project_match" },
31
+ "work_item_provider": { "$ref": "#/$defs/work_item_provider" },
32
+ "board_provider": { "$ref": "#/$defs/board_provider" },
33
+ "selection": { "$ref": "#/$defs/selection" }
34
+ }
35
+ },
36
+ "project_match": {
37
+ "type": "object",
38
+ "additionalProperties": false,
39
+ "required": ["repo"],
40
+ "properties": {
41
+ "repo": { "$ref": "#/$defs/repo" },
42
+ "paths": { "type": "array", "items": { "type": "string", "minLength": 1 } }
43
+ }
44
+ },
45
+ "work_item_provider": {
46
+ "type": "object",
47
+ "additionalProperties": false,
48
+ "required": ["role", "kind", "repo", "capabilities"],
49
+ "properties": {
50
+ "role": { "const": "WorkItemProvider" },
51
+ "kind": { "enum": ["github"] },
52
+ "repo": { "$ref": "#/$defs/repo" },
53
+ "capabilities": { "$ref": "#/$defs/capabilities" }
54
+ }
55
+ },
56
+ "board_provider": {
57
+ "type": "object",
58
+ "additionalProperties": false,
59
+ "required": ["role", "kind", "repo", "board", "capabilities"],
60
+ "properties": {
61
+ "role": { "const": "BoardProvider" },
62
+ "kind": { "enum": ["github"] },
63
+ "repo": { "$ref": "#/$defs/repo" },
64
+ "board": {
65
+ "type": "object",
66
+ "additionalProperties": false,
67
+ "required": ["type", "number"],
68
+ "properties": {
69
+ "type": { "enum": ["github_project"] },
70
+ "owner": { "type": "string", "minLength": 1 },
71
+ "number": { "type": "integer", "minimum": 1 },
72
+ "url": { "type": "string" }
73
+ }
74
+ },
75
+ "capabilities": { "$ref": "#/$defs/capabilities" }
76
+ }
77
+ },
78
+ "selection": {
79
+ "type": "object",
80
+ "additionalProperties": false,
81
+ "required": ["filters", "wip_policy"],
82
+ "properties": {
83
+ "filters": {
84
+ "type": "object",
85
+ "additionalProperties": false,
86
+ "required": ["issue_state", "include_labels", "ready_statuses", "exclude_statuses"],
87
+ "properties": {
88
+ "issue_state": { "enum": ["open", "closed", "all"] },
89
+ "include_labels": { "type": "array", "items": { "type": "string", "minLength": 1 } },
90
+ "ready_statuses": { "type": "array", "items": { "enum": ["todo", "ready"] } },
91
+ "exclude_statuses": {
92
+ "type": "array",
93
+ "items": { "enum": ["in_progress", "blocked", "review", "verification", "done"] }
94
+ }
95
+ }
96
+ },
97
+ "wip_policy": {
98
+ "type": "object",
99
+ "additionalProperties": false,
100
+ "required": ["prefer_finishing_active_work", "active_statuses"],
101
+ "properties": {
102
+ "prefer_finishing_active_work": { "type": "boolean" },
103
+ "active_statuses": { "type": "array", "items": { "enum": ["in_progress", "review", "verification"] } },
104
+ "block_new_work_when_active_count_exceeds": { "type": "integer", "minimum": 0 }
105
+ }
106
+ }
107
+ }
108
+ },
109
+ "capabilities": {
110
+ "type": "array",
111
+ "items": {
112
+ "enum": [
113
+ "issues",
114
+ "projects_boards",
115
+ "status_fields",
116
+ "custom_fields",
117
+ "dependencies",
118
+ "labels",
119
+ "milestones",
120
+ "assignees",
121
+ "pr_links",
122
+ "comments"
123
+ ]
124
+ },
125
+ "uniqueItems": true
126
+ },
127
+ "repo": {
128
+ "type": "object",
129
+ "additionalProperties": false,
130
+ "required": ["owner", "name"],
131
+ "properties": {
132
+ "owner": { "type": "string", "minLength": 1 },
133
+ "name": { "type": "string", "minLength": 1 },
134
+ "url": { "type": "string" }
135
+ }
136
+ }
137
+ }
138
+ }
package/schemas/workflow-acceptance.schema.json ADDED
@@ -0,0 +1,216 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://flow-agents.dev/schemas/workflow-acceptance.schema.json",
4
+ "title": "Flow Agents Workflow Acceptance",
5
+ "type": "object",
6
+ "additionalProperties": false,
7
+ "required": [
8
+ "schema_version",
9
+ "task_slug",
10
+ "criteria",
11
+ "goal_fit"
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
+ "source_request": {
160
+ "type": "string"
161
+ },
162
+ "criteria": {
163
+ "type": "array",
164
+ "minItems": 1,
165
+ "items": {
166
+ "type": "object",
167
+ "additionalProperties": false,
168
+ "required": ["id", "description", "status"],
169
+ "properties": {
170
+ "id": {
171
+ "type": "string",
172
+ "minLength": 1
173
+ },
174
+ "description": {
175
+ "type": "string",
176
+ "minLength": 1
177
+ },
178
+ "status": {
179
+ "type": "string",
180
+ "enum": ["pending", "pass", "fail", "not_verified", "accepted_gap"]
181
+ },
182
+ "evidence_refs": {
183
+ "type": "array",
184
+ "items": {
185
+ "$ref": "#/$defs/evidence_ref"
186
+ },
187
+ "uniqueItems": true
188
+ },
189
+ "notes": {
190
+ "type": "string"
191
+ }
192
+ }
193
+ }
194
+ },
195
+ "goal_fit": {
196
+ "type": "object",
197
+ "additionalProperties": false,
198
+ "required": ["status", "summary"],
199
+ "properties": {
200
+ "status": {
201
+ "type": "string",
202
+ "enum": ["pending", "pass", "fail", "not_verified", "accepted_gap"]
203
+ },
204
+ "summary": {
205
+ "type": "string"
206
+ },
207
+ "open_gaps": {
208
+ "type": "array",
209
+ "items": {
210
+ "type": "string"
211
+ }
212
+ }
213
+ }
214
+ }
215
+ }
216
+ }
package/schemas/workflow-critique.schema.json ADDED
@@ -0,0 +1,113 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://flow-agents.dev/schemas/workflow-critique.schema.json",
4
+ "title": "Flow Agents Workflow Critique",
5
+ "type": "object",
6
+ "additionalProperties": false,
7
+ "required": [
8
+ "schema_version",
9
+ "task_slug",
10
+ "status",
11
+ "required",
12
+ "updated_at",
13
+ "critiques"
14
+ ],
15
+ "properties": {
16
+ "schema_version": {
17
+ "type": "string",
18
+ "const": "1.0"
19
+ },
20
+ "task_slug": {
21
+ "type": "string",
22
+ "minLength": 1
23
+ },
24
+ "repo": {
25
+ "type": "string",
26
+ "minLength": 1
27
+ },
28
+ "status": {
29
+ "type": "string",
30
+ "enum": ["pending", "pass", "fail", "not_required"]
31
+ },
32
+ "required": {
33
+ "type": "boolean"
34
+ },
35
+ "updated_at": {
36
+ "type": "string",
37
+ "format": "date-time"
38
+ },
39
+ "critiques": {
40
+ "type": "array",
41
+ "items": {
42
+ "type": "object",
43
+ "additionalProperties": false,
44
+ "required": ["id", "reviewer", "reviewed_at", "verdict", "summary", "findings"],
45
+ "properties": {
46
+ "id": {
47
+ "type": "string",
48
+ "minLength": 1
49
+ },
50
+ "reviewer": {
51
+ "type": "string",
52
+ "minLength": 1
53
+ },
54
+ "reviewed_at": {
55
+ "type": "string",
56
+ "format": "date-time"
57
+ },
58
+ "verdict": {
59
+ "type": "string",
60
+ "enum": ["pass", "comment", "fail", "not_verified"]
61
+ },
62
+ "summary": {
63
+ "type": "string",
64
+ "minLength": 1
65
+ },
66
+ "artifact_refs": {
67
+ "type": "array",
68
+ "items": {
69
+ "type": "string"
70
+ },
71
+ "uniqueItems": true
72
+ },
73
+ "findings": {
74
+ "type": "array",
75
+ "items": {
76
+ "type": "object",
77
+ "additionalProperties": false,
78
+ "required": ["id", "severity", "status", "description"],
79
+ "properties": {
80
+ "id": {
81
+ "type": "string",
82
+ "minLength": 1
83
+ },
84
+ "severity": {
85
+ "type": "string",
86
+ "enum": ["critical", "high", "medium", "low", "info"]
87
+ },
88
+ "status": {
89
+ "type": "string",
90
+ "enum": ["open", "accepted", "fixed", "deferred", "false_positive"]
91
+ },
92
+ "description": {
93
+ "type": "string",
94
+ "minLength": 1
95
+ },
96
+ "file_refs": {
97
+ "type": "array",
98
+ "items": {
99
+ "type": "string"
100
+ },
101
+ "uniqueItems": true
102
+ },
103
+ "resolution": {
104
+ "type": "string"
105
+ }
106
+ }
107
+ }
108
+ }
109
+ }
110
+ }
111
+ }
112
+ }
113
+ }