@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
@@ -0,0 +1,170 @@
1
+ [
2
+ {
3
+ "number": 22,
4
+ "title": "Define and validate Flow Kit repositories",
5
+ "state": "OPEN",
6
+ "body": "## Problem\nExternal kit repositories need a validated contract.\n\n## Scope\n- Add contract docs.\n- Validate local kit folders.\n\n## Acceptance criteria\n- Valid fixture passes.\n- Invalid fixtures fail.\n\n## Dependencies\nRequires kontourai/flow#2.\n\n## Source artifact\n`.flow-agents/flow-agents-kit-platform-backlog/flow-agents-kit-platform-backlog--idea-to-backlog.md`",
7
+ "labels": [],
8
+ "assignees": [],
9
+ "milestone": null,
10
+ "projectItems": [{ "status": { "name": "Todo" }, "title": "Flow Agents Builder Platform" }],
11
+ "closedByPullRequestsReferences": [],
12
+ "url": "https://github.com/kontourai/flow-agents/issues/22",
13
+ "updatedAt": "2026-05-26T04:55:50Z",
14
+ "createdAt": "2026-05-26T04:55:50Z"
15
+ },
16
+ {
17
+ "number": 23,
18
+ "title": "Install Flow Kits",
19
+ "state": "OPEN",
20
+ "body": "## Scope\nInstall kits.\n\n## Acceptance criteria\nInstaller works.\n\n## Dependencies\nBlocked by #22.",
21
+ "labels": [{ "name": "blocked" }],
22
+ "assignees": [],
23
+ "milestone": null,
24
+ "projectItems": [{ "status": { "name": "Blocked" }, "title": "Flow Agents Builder Platform" }],
25
+ "closedByPullRequestsReferences": [],
26
+ "url": "https://github.com/kontourai/flow-agents/issues/23",
27
+ "updatedAt": "2026-05-26T04:56:00Z",
28
+ "createdAt": "2026-05-26T04:56:00Z"
29
+ },
30
+ {
31
+ "number": 27,
32
+ "title": "Research Flow Kit distribution",
33
+ "state": "OPEN",
34
+ "body": "## Scope\nResearch options.\n\n## Acceptance criteria\nResearch note exists.",
35
+ "labels": [{ "name": "research" }],
36
+ "assignees": [],
37
+ "milestone": null,
38
+ "projectItems": [{ "status": { "name": "Todo" }, "title": "Flow Agents Builder Platform" }],
39
+ "closedByPullRequestsReferences": [],
40
+ "url": "https://github.com/kontourai/flow-agents/issues/27",
41
+ "updatedAt": "2026-05-26T04:57:00Z",
42
+ "createdAt": "2026-05-26T04:57:00Z"
43
+ },
44
+ {
45
+ "number": 30,
46
+ "title": "Teach pull-work to use configured backlog providers",
47
+ "state": "OPEN",
48
+ "body": "## Scope\nNormalize providers.\n\n## Acceptance criteria\nPull-work selects #22.",
49
+ "labels": [],
50
+ "assignees": [],
51
+ "milestone": { "number": 1, "title": "Builder Kit Dogfood Alpha" },
52
+ "projectItems": [{ "status": { "name": "In Progress" }, "title": "Flow Agents Builder Platform" }],
53
+ "closedByPullRequestsReferences": [],
54
+ "url": "https://github.com/kontourai/flow-agents/issues/30",
55
+ "updatedAt": "2026-05-26T06:00:23Z",
56
+ "createdAt": "2026-05-26T05:06:54Z"
57
+ },
58
+ {
59
+ "number": 99,
60
+ "title": "Old unshaped idea",
61
+ "state": "OPEN",
62
+ "body": "Maybe improve something later.",
63
+ "labels": [],
64
+ "assignees": [],
65
+ "milestone": null,
66
+ "projectItems": [{ "status": { "name": "Todo" }, "title": "Flow Agents Builder Platform" }],
67
+ "closedByPullRequestsReferences": [],
68
+ "url": "https://github.com/kontourai/flow-agents/issues/99",
69
+ "updatedAt": "2025-01-01T00:00:00Z",
70
+ "createdAt": "2025-01-01T00:00:00Z"
71
+ },
72
+ {
73
+ "number": 97,
74
+ "title": "Emit source revision metadata and structured blockers",
75
+ "state": "OPEN",
76
+ "body": "## Problem\nDownstream pickup needs durable source revision and blocker metadata.\n\n## Scope\n- Emit provider-neutral work-item metadata.\n- Preserve human-readable blocker prose.\n\n## Acceptance criteria\n- Source revision fields normalize.\n- Structured blockers preserve provider refs and text blockers.\n\n## Dependencies / Blockers\nRequires kontourai/flow#2.\nBlocked by product decision on rollout scope.\n\n## Source artifact\n`.flow-agents/idea-to-backlog-source-revision-structured-blockers/idea-to-backlog-source-revision-structured-blockers--plan.md`\n\n<!-- flow-agents:work-item-metadata\n{\n \"schema_version\": \"1.0\",\n \"source_revisions\": [\n {\n \"repo\": \"kontourai/flow-agents\",\n \"planned_base_ref\": \"main\",\n \"planned_base_sha\": \"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n \"planned_at\": \"2026-06-03T03:23:14Z\",\n \"planning_artifact_ref\": \".flow-agents/idea-to-backlog-source-revision-structured-blockers/idea-to-backlog-source-revision-structured-blockers--plan.md\",\n \"planning_scope_refs\": [\n \"skills/idea-to-backlog/SKILL.md\",\n \"context/contracts/work-item-contract.md\"\n ]\n },\n {\n \"repo\": \"kontourai/flow\",\n \"planned_base_ref\": \"main\",\n \"planned_base_sha\": \"bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb\",\n \"planned_at\": \"2026-06-03T03:23:14Z\",\n \"planning_artifact_ref\": \".flow-agents/idea-to-backlog-source-revision-structured-blockers/idea-to-backlog-source-revision-structured-blockers--plan.md\",\n \"planning_scope_refs\": [\"context/contracts/work-item-contract.md\"]\n }\n ],\n \"blockers\": [\n {\n \"type\": \"work_item\",\n \"ref\": \"kontourai/flow#2\",\n \"status\": \"blocked\",\n \"summary\": \"Requires Flow contract issue first.\"\n },\n {\n \"type\": \"text\",\n \"status\": \"blocked\",\n \"summary\": \"Product decision on rollout scope.\"\n }\n ]\n}\n-->",
77
+ "labels": [],
78
+ "assignees": [],
79
+ "milestone": null,
80
+ "projectItems": [{ "status": { "name": "Todo" }, "title": "Flow Agents Builder Platform" }],
81
+ "closedByPullRequestsReferences": [],
82
+ "url": "https://github.com/kontourai/flow-agents/issues/97",
83
+ "updatedAt": "2026-06-03T03:24:00Z",
84
+ "createdAt": "2026-06-03T03:24:00Z"
85
+ },
86
+ {
87
+ "number": 101,
88
+ "title": "Legacy issue with invalid metadata marker",
89
+ "state": "OPEN",
90
+ "body": "## Scope\nKeep prose fallback working when metadata is malformed.\n\n## Acceptance criteria\nFallback blocker extraction still works.\n\n## Dependencies / Blockers\nRequires #22.\n\n<!-- flow-agents:work-item-metadata\n{ invalid json\n-->",
91
+ "labels": [],
92
+ "assignees": [],
93
+ "milestone": null,
94
+ "projectItems": [{ "status": { "name": "Todo" }, "title": "Flow Agents Builder Platform" }],
95
+ "closedByPullRequestsReferences": [],
96
+ "url": "https://github.com/kontourai/flow-agents/issues/101",
97
+ "updatedAt": "2026-06-03T03:25:00Z",
98
+ "createdAt": "2026-06-03T03:25:00Z"
99
+ },
100
+ {
101
+ "number": 110,
102
+ "title": "Fresh planned item",
103
+ "state": "OPEN",
104
+ "body": "## Scope\nUse fresh source revision metadata.\n\n## Acceptance criteria\nFreshness is verified.\n\n<!-- flow-agents:work-item-metadata\n{\n \"schema_version\": \"1.0\",\n \"planned_base_ref\": \"main\",\n \"planned_base_sha\": \"cccccccccccccccccccccccccccccccccccccccc\",\n \"planned_at\": \"2026-06-02T00:00:00Z\",\n \"planning_artifact_ref\": \".flow-agents/fresh/fresh--plan.md\",\n \"planning_scope_refs\": [\"skills/pull-work/SKILL.md\"]\n}\n-->",
105
+ "labels": [],
106
+ "assignees": [],
107
+ "milestone": null,
108
+ "projectItems": [{ "status": { "name": "Todo" }, "title": "Flow Agents Builder Platform" }],
109
+ "closedByPullRequestsReferences": [],
110
+ "url": "https://github.com/kontourai/flow-agents/issues/110",
111
+ "updatedAt": "2026-06-02T00:00:00Z",
112
+ "createdAt": "2026-06-02T00:00:00Z"
113
+ },
114
+ {
115
+ "number": 111,
116
+ "title": "Drifted planned item",
117
+ "state": "OPEN",
118
+ "body": "## Scope\nUse drifted source revision metadata.\n\n## Acceptance criteria\nFreshness reports benign drift.\n\n<!-- flow-agents:work-item-metadata\n{\n \"schema_version\": \"1.0\",\n \"planned_base_ref\": \"main\",\n \"planned_base_sha\": \"dddddddddddddddddddddddddddddddddddddddd\",\n \"planned_at\": \"2026-06-01T00:00:00Z\",\n \"planning_artifact_ref\": \".flow-agents/drifted/drifted--plan.md\",\n \"planning_scope_refs\": [\"skills/pickup-probe/SKILL.md\"]\n}\n-->",
119
+ "labels": [],
120
+ "assignees": [],
121
+ "milestone": null,
122
+ "projectItems": [{ "status": { "name": "Todo" }, "title": "Flow Agents Builder Platform" }],
123
+ "closedByPullRequestsReferences": [],
124
+ "url": "https://github.com/kontourai/flow-agents/issues/111",
125
+ "updatedAt": "2026-06-01T00:00:00Z",
126
+ "createdAt": "2026-06-01T00:00:00Z"
127
+ },
128
+ {
129
+ "number": 112,
130
+ "title": "Stale planned item",
131
+ "state": "OPEN",
132
+ "body": "## Scope\nUse stale source revision metadata.\n\n## Acceptance criteria\nFreshness routes stale work.\n\n<!-- flow-agents:work-item-metadata\n{\n \"schema_version\": \"1.0\",\n \"planned_base_ref\": \"main\",\n \"planned_base_sha\": \"eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee\",\n \"planned_at\": \"2026-04-01T00:00:00Z\",\n \"planning_artifact_ref\": \".flow-agents/stale/stale--plan.md\",\n \"planning_scope_refs\": [\"context/contracts/work-item-contract.md\", \"skills/pull-work/SKILL.md\"]\n}\n-->",
133
+ "labels": [],
134
+ "assignees": [],
135
+ "milestone": null,
136
+ "projectItems": [{ "status": { "name": "Todo" }, "title": "Flow Agents Builder Platform" }],
137
+ "closedByPullRequestsReferences": [],
138
+ "url": "https://github.com/kontourai/flow-agents/issues/112",
139
+ "updatedAt": "2026-04-01T00:00:00Z",
140
+ "createdAt": "2026-04-01T00:00:00Z"
141
+ },
142
+ {
143
+ "number": 113,
144
+ "title": "Legacy item missing planned base",
145
+ "state": "OPEN",
146
+ "body": "## Scope\nPreserve legacy gap for missing planned_base_sha.\n\n## Acceptance criteria\nFreshness is not verified.\n\n<!-- flow-agents:work-item-metadata\n{\n \"schema_version\": \"1.0\",\n \"planned_base_ref\": \"main\",\n \"planned_at\": \"2026-06-01T00:00:00Z\",\n \"planning_artifact_ref\": \".flow-agents/legacy/legacy--plan.md\",\n \"planning_scope_refs\": [\"skills/pull-work/SKILL.md\"]\n}\n-->",
147
+ "labels": [],
148
+ "assignees": [],
149
+ "milestone": null,
150
+ "projectItems": [{ "status": { "name": "Todo" }, "title": "Flow Agents Builder Platform" }],
151
+ "closedByPullRequestsReferences": [],
152
+ "url": "https://github.com/kontourai/flow-agents/issues/113",
153
+ "updatedAt": "2026-06-01T00:00:00Z",
154
+ "createdAt": "2026-06-01T00:00:00Z"
155
+ },
156
+ {
157
+ "number": 114,
158
+ "title": "Structured-only cross-repo blocker",
159
+ "state": "OPEN",
160
+ "body": "## Scope\nUse only structured blocker metadata.\n\n## Acceptance criteria\nStructured blocker readiness is deterministic.\n\n<!-- flow-agents:work-item-metadata\n{\n \"schema_version\": \"1.0\",\n \"blockers\": [\n {\n \"type\": \"work_item\",\n \"ref\": \"kontourai/flow#2\",\n \"status\": \"blocked\",\n \"summary\": \"Requires Flow contract issue first.\"\n }\n ]\n}\n-->",
161
+ "labels": [],
162
+ "assignees": [],
163
+ "milestone": null,
164
+ "projectItems": [{ "status": { "name": "Todo" }, "title": "Flow Agents Builder Platform" }],
165
+ "closedByPullRequestsReferences": [],
166
+ "url": "https://github.com/kontourai/flow-agents/issues/114",
167
+ "updatedAt": "2026-06-03T03:26:00Z",
168
+ "createdAt": "2026-06-03T03:26:00Z"
169
+ }
170
+ ]
@@ -0,0 +1,43 @@
1
+ {
2
+ "schema_version": "1.0",
3
+ "description": "Global WIP informs risk but does not automatically block selected work.",
4
+ "wip_assessment": {
5
+ "my_active_work": [],
6
+ "shepherding_candidates": [],
7
+ "stale_worktrees": [],
8
+ "open_prs_by_me": [],
9
+ "global_conflicts": [
10
+ {
11
+ "kind": "pull_request",
12
+ "owner": "other-user",
13
+ "ref": "kontourai/flow-agents#99",
14
+ "files": [
15
+ "docs/workflow-usage-guide.md"
16
+ ],
17
+ "risk": "documentation overlap only"
18
+ }
19
+ ],
20
+ "dependency_impacts": [
21
+ {
22
+ "ref": "kontourai/flow-agents#99",
23
+ "impact": "coordinate docs wording if both PRs edit the same paragraph"
24
+ }
25
+ ]
26
+ },
27
+ "start_new_work_decision": {
28
+ "decision": "proceed",
29
+ "reason": "No personal WIP is blocking. Global WIP is documented as coordination risk, not a dependency or release blocker.",
30
+ "next_action": "Proceed with isolated worktree and record overlapping doc risk in the handoff."
31
+ },
32
+ "worktree_lifecycle": {
33
+ "path": "~/code/kontourai/flow-agents-example",
34
+ "branch": "example-branch",
35
+ "retain_until": "pr_merged",
36
+ "cleanup_owner": "orchestrator",
37
+ "cleanup_command": "git worktree remove ~/code/kontourai/flow-agents-example",
38
+ "cleanup_blocked_by": [
39
+ "open PR",
40
+ "pending CI"
41
+ ]
42
+ }
43
+ }
@@ -0,0 +1,42 @@
1
+ {
2
+ "schema_version": "1.0",
3
+ "description": "Personal WIP blocks starting new implementation because an owned PR/worktree needs shepherding.",
4
+ "wip_assessment": {
5
+ "my_active_work": [
6
+ {
7
+ "kind": "worktree",
8
+ "path": "~/code/kontourai/flow-agents-workflow-hardening",
9
+ "branch": "workflow-hardening-publish-change",
10
+ "status": "dirty",
11
+ "summary": "Unpublished publish-change contract/helper work is still active."
12
+ }
13
+ ],
14
+ "shepherding_candidates": [
15
+ {
16
+ "kind": "worktree",
17
+ "ref": "workflow-hardening-publish-change",
18
+ "next_action": "Decide whether to publish, continue, or abandon before starting another implementation."
19
+ }
20
+ ],
21
+ "stale_worktrees": [],
22
+ "open_prs_by_me": [],
23
+ "global_conflicts": [],
24
+ "dependency_impacts": []
25
+ },
26
+ "start_new_work_decision": {
27
+ "decision": "shepherd_existing",
28
+ "reason": "Personal WIP is dirty and touches workflow contracts that overlap new workflow work.",
29
+ "next_action": "Shepherd or explicitly park the active worktree before selecting more implementation work."
30
+ },
31
+ "worktree_lifecycle": {
32
+ "path": "~/code/kontourai/flow-agents-workflow-hardening",
33
+ "branch": "workflow-hardening-publish-change",
34
+ "retain_until": "user_override",
35
+ "cleanup_owner": "user",
36
+ "cleanup_command": "git worktree remove ~/code/kontourai/flow-agents-workflow-hardening",
37
+ "cleanup_blocked_by": [
38
+ "dirty files",
39
+ "user decision"
40
+ ]
41
+ }
42
+ }
@@ -0,0 +1,31 @@
1
+ {
2
+ "schema_version": "1.0",
3
+ "artifact_kind": "TrustReport",
4
+ "artifact_ref": "surface-trust://fixtures/accepted-claim-trust-report.json",
5
+ "subject": {
6
+ "type": "flow-step",
7
+ "id": "verify"
8
+ },
9
+ "gate": {
10
+ "id": "tests-evidence",
11
+ "kind": "surface.claim"
12
+ },
13
+ "claim": {
14
+ "type": "builder.verify.tests",
15
+ "subject": "flow-step",
16
+ "status": "accepted"
17
+ },
18
+ "authority": {
19
+ "producer": "fixture-trust-provider",
20
+ "trace_ref": "surface-trust://authority/fixture-provider"
21
+ },
22
+ "integrity": {
23
+ "digest": "sha256:1111111111111111111111111111111111111111111111111111111111111111",
24
+ "subject_digest": "sha256:2222222222222222222222222222222222222222222222222222222222222222",
25
+ "verified": true
26
+ },
27
+ "freshness": {
28
+ "status": "fresh",
29
+ "checked_at": "2026-05-26T00:00:00Z"
30
+ }
31
+ }
@@ -0,0 +1,19 @@
1
+ {
2
+ "schema_version": "1.0",
3
+ "scenario": "artifact_absent",
4
+ "artifact_kind": "TrustReport",
5
+ "artifact_ref": "surface-trust://fixtures/missing-trust-report.json",
6
+ "gate": {
7
+ "id": "implementation-plan",
8
+ "kind": "surface.claim"
9
+ },
10
+ "claim": {
11
+ "type": "builder.plan.implementation",
12
+ "subject": "artifact",
13
+ "status": "not_verified"
14
+ },
15
+ "gap": {
16
+ "status": "not_verified",
17
+ "summary": "Configured trust artifact was not readable."
18
+ }
19
+ }
@@ -0,0 +1,32 @@
1
+ {
2
+ "schema_version": "1.0",
3
+ "artifact_kind": "TrustReport",
4
+ "artifact_ref": "surface-trust://fixtures/integrity-mismatch-trust-report.json",
5
+ "subject": {
6
+ "type": "artifact",
7
+ "id": "surface-trust-evidence--plan.md"
8
+ },
9
+ "gate": {
10
+ "id": "implementation-plan",
11
+ "kind": "surface.claim"
12
+ },
13
+ "claim": {
14
+ "type": "builder.plan.implementation",
15
+ "subject": "artifact",
16
+ "status": "accepted"
17
+ },
18
+ "authority": {
19
+ "producer": "fixture-trust-provider",
20
+ "trace_ref": "surface-trust://authority/fixture-provider"
21
+ },
22
+ "integrity": {
23
+ "digest": "sha256:3333333333333333333333333333333333333333333333333333333333333333",
24
+ "expected_digest": "sha256:4444444444444444444444444444444444444444444444444444444444444444",
25
+ "verified": false,
26
+ "mismatch": "digest"
27
+ },
28
+ "freshness": {
29
+ "status": "fresh",
30
+ "checked_at": "2026-05-26T00:00:00Z"
31
+ }
32
+ }
@@ -0,0 +1,27 @@
1
+ {
2
+ "schema_version": "1.0",
3
+ "artifact_kind": "TrustReport",
4
+ "artifact_ref": "surface-trust://fixtures/missing-authority-trust-report.json",
5
+ "subject": {
6
+ "type": "change",
7
+ "id": "surface-trust-fixtures"
8
+ },
9
+ "gate": {
10
+ "id": "implementation-scope",
11
+ "kind": "surface.claim"
12
+ },
13
+ "claim": {
14
+ "type": "builder.execute.scope",
15
+ "subject": "change",
16
+ "status": "accepted"
17
+ },
18
+ "authority": null,
19
+ "integrity": {
20
+ "digest": "sha256:5555555555555555555555555555555555555555555555555555555555555555",
21
+ "verified": true
22
+ },
23
+ "freshness": {
24
+ "status": "fresh",
25
+ "checked_at": "2026-05-26T00:00:00Z"
26
+ }
27
+ }
@@ -0,0 +1,19 @@
1
+ {
2
+ "schema_version": "1.0",
3
+ "scenario": "provider_absent",
4
+ "artifact_kind": "Trust Snapshot",
5
+ "artifact_ref": null,
6
+ "gate": {
7
+ "id": "selected-work",
8
+ "kind": "surface.claim"
9
+ },
10
+ "claim": {
11
+ "type": "builder.pull-work.selected",
12
+ "subject": "work-item",
13
+ "status": "not_verified"
14
+ },
15
+ "gap": {
16
+ "status": "not_verified",
17
+ "summary": "No trust provider is configured; ordinary Builder Kit evidence remains usable."
18
+ }
19
+ }
@@ -0,0 +1,30 @@
1
+ {
2
+ "schema_version": "1.0",
3
+ "artifact_kind": "TrustReport",
4
+ "artifact_ref": "surface-trust://fixtures/rejected-claim-trust-report.json",
5
+ "subject": {
6
+ "type": "change",
7
+ "id": "surface-trust-fixtures"
8
+ },
9
+ "gate": {
10
+ "id": "implementation-scope",
11
+ "kind": "surface.claim"
12
+ },
13
+ "claim": {
14
+ "type": "builder.execute.scope",
15
+ "subject": "change",
16
+ "status": "rejected"
17
+ },
18
+ "authority": {
19
+ "producer": "fixture-trust-provider",
20
+ "trace_ref": "surface-trust://authority/fixture-provider"
21
+ },
22
+ "integrity": {
23
+ "digest": "sha256:6666666666666666666666666666666666666666666666666666666666666666",
24
+ "verified": true
25
+ },
26
+ "freshness": {
27
+ "status": "fresh",
28
+ "checked_at": "2026-05-26T00:00:00Z"
29
+ }
30
+ }
@@ -0,0 +1,31 @@
1
+ {
2
+ "schema_version": "1.0",
3
+ "artifact_kind": "Trust Snapshot",
4
+ "artifact_ref": "surface-trust://fixtures/stale-claim-trust-snapshot.json",
5
+ "subject": {
6
+ "type": "flow-step",
7
+ "id": "verify"
8
+ },
9
+ "gate": {
10
+ "id": "tests-evidence",
11
+ "kind": "surface.claim"
12
+ },
13
+ "claim": {
14
+ "type": "builder.verify.tests",
15
+ "subject": "flow-step",
16
+ "status": "trusted"
17
+ },
18
+ "authority": {
19
+ "producer": "fixture-trust-provider",
20
+ "trace_ref": "surface-trust://authority/fixture-provider"
21
+ },
22
+ "integrity": {
23
+ "digest": "sha256:7777777777777777777777777777777777777777777777777777777777777777",
24
+ "verified": true
25
+ },
26
+ "freshness": {
27
+ "status": "stale",
28
+ "checked_at": "2026-05-26T00:00:00Z",
29
+ "reason": "Artifact predates current subject digest."
30
+ }
31
+ }
@@ -0,0 +1,11 @@
1
+ {"schema_version":"1","timestamp":"2026-05-04T10:00:00Z","session_id":"codex-session-1","event_id":"evt-1","event_type":"session.start","agent":{"name":"dev","runtime":"codex"},"model":"gpt-5","repo":"flow-agents","repo_root":"/tmp/flow-agents","profile_id":"codex-default","prompt_id":"deliver-v1","prompt_variant":"baseline","skill_ids":["deliver"]}
2
+ {"schema_version":"1","timestamp":"2026-05-04T10:01:00Z","session_id":"codex-session-1","event_id":"evt-2","event_type":"turn.user","agent":{"name":"dev","runtime":"codex"},"turn":{"prompt_length":27}}
3
+ {"schema_version":"1","timestamp":"2026-05-04T10:02:00Z","session_id":"codex-session-1","event_id":"evt-3","event_type":"tool.invoke","agent":{"name":"dev","runtime":"codex"},"tool":{"name":"execute_bash","normalized_name":"execute_bash"}}
4
+ {"schema_version":"1","timestamp":"2026-05-04T10:03:00Z","session_id":"codex-session-1","event_id":"evt-4","event_type":"tool.invoke","agent":{"name":"dev","runtime":"codex"},"tool":{"name":"apply_patch","normalized_name":"apply_patch"}}
5
+ {"schema_version":"1","timestamp":"2026-05-04T10:04:00Z","session_id":"codex-session-1","event_id":"evt-5","event_type":"agent.delegate","agent":{"name":"dev","runtime":"codex"},"delegation":{"targets":["tool-worker"]}}
6
+ {"schema_version":"1","timestamp":"2026-05-04T10:05:00Z","session_id":"codex-session-1","event_id":"evt-6","event_type":"tool.permission_request","agent":{"name":"dev","runtime":"codex"},"permission":{"description":"Run integration command"}}
7
+ {"schema_version":"1","timestamp":"2026-05-04T10:06:00Z","session_id":"codex-session-1","event_id":"evt-7","event_type":"session.usage","agent":{"name":"dev","runtime":"codex"},"usage":{"duration_s":360}}
8
+ {"schema_version":"1","timestamp":"2026-05-04T11:00:00Z","session_id":"codex-session-2","event_id":"evt-8","event_type":"session.start","agent":{"name":"dev","runtime":"codex"},"model":"gpt-5","repo":"flow-agents-docs","repo_root":"/tmp/flow-agents-docs","profile_id":"codex-experimental","prompt_id":"deliver-v2","prompt_variant":"concise","skill_ids":["deliver","verify-work"]}
9
+ {"schema_version":"1","timestamp":"2026-05-04T11:01:00Z","session_id":"codex-session-2","event_id":"evt-9","event_type":"turn.user","agent":{"name":"dev","runtime":"codex"}}
10
+ {"schema_version":"1","timestamp":"2026-05-04T11:02:00Z","session_id":"codex-session-2","event_id":"evt-10","event_type":"tool.invoke","agent":{"name":"dev","runtime":"codex"},"tool":{"name":"execute_bash","normalized_name":"execute_bash"}}
11
+ {"schema_version":"1","timestamp":"2026-05-04T11:04:00Z","session_id":"codex-session-2","event_id":"evt-11","event_type":"session.end","agent":{"name":"dev","runtime":"codex"},"session":{"duration_s":240}}
@@ -0,0 +1 @@
1
+ {"schema_version":"1","outcome_id":"outcome-1","recorded_at":"2026-05-04T10:30:00Z","session_id":"codex-session-1","runtime":"codex","repo":"flow-agents","agent":"dev","profile_id":"codex-default","prompt_id":"deliver-v1","prompt_variant":"baseline","skill_ids":["deliver"],"task_type":"deliver","task_slug":"usage-feedback-tests","result":"success","quality_score":5,"human_minutes_saved":20,"rework_required":false,"notes":"Fixture success outcome","evidence":["evals/integration/test_usage_feedback_report.sh"]}
@@ -0,0 +1,18 @@
1
+ #!/usr/bin/env bash
2
+ set -euo pipefail
3
+
4
+ if [[ "${VERITAS_ARGV_LOG:-}" != "" ]]; then
5
+ printf '%s\n' "$*" > "$VERITAS_ARGV_LOG"
6
+ fi
7
+
8
+ expected='readiness --check evidence --working-tree'
9
+ if [[ "${VERITAS_EXPECT_ROOT:-}" != "" ]]; then
10
+ expected="$expected --root $VERITAS_EXPECT_ROOT"
11
+ fi
12
+
13
+ if [[ "$*" != "$expected" ]]; then
14
+ echo "unexpected argv: $*" >&2
15
+ exit 70
16
+ fi
17
+
18
+ echo "fixture Veritas readiness passed"
@@ -0,0 +1,10 @@
1
+ #!/usr/bin/env bash
2
+ set -euo pipefail
3
+
4
+ echo "Veritas policy failed"
5
+ echo "token=fixture-token-redaction-sentinel"
6
+ echo "api_key=fixture-api-key-redaction-sentinel"
7
+ for i in $(seq 1 40); do
8
+ echo "detail line $i: this line should be bounded in the evidence sidecar"
9
+ done
10
+ exit 17
@@ -0,0 +1,4 @@
1
+ #!/usr/bin/env bash
2
+ set -euo pipefail
3
+ echo "Veritas is not configured: missing .veritas/repo-map.json" >&2
4
+ exit 78