@kontourai/flow-agents 4.0.0 → 4.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (451) hide show
  1. package/.github/workflows/ci.yml +8 -0
  2. package/CHANGELOG.md +27 -0
  3. package/CONTEXT.md +5 -0
  4. package/agents/tool-security-reviewer.json +1 -1
  5. package/build/src/cli/init.js +35 -3
  6. package/build/src/cli/kit.js +95 -2
  7. package/build/src/cli/pull-work-provider.js +7 -1
  8. package/build/src/cli/validate-workflow-artifacts.js +53 -0
  9. package/build/src/cli/workflow.js +5 -1
  10. package/build/src/flow-kit/provision.d.ts +23 -0
  11. package/build/src/flow-kit/provision.js +99 -0
  12. package/build/src/flow-kit/validate.d.ts +52 -0
  13. package/build/src/flow-kit/validate.js +214 -9
  14. package/build/src/runtime-adapters.js +1 -1
  15. package/context/contracts/execution-contract.md +30 -1
  16. package/context/contracts/review-contract.md +4 -0
  17. package/context/contracts/trigger-guards.md +73 -0
  18. package/context/settings/backlog-provider-settings.json +1 -1
  19. package/context/settings/workspace-backlog-provider-settings.example.json +1 -1
  20. package/dist/base/build/package.json +1 -1
  21. package/dist/base/build/src/cli/init.js +35 -3
  22. package/dist/base/build/src/cli/kit.js +95 -2
  23. package/dist/base/build/src/cli/pull-work-provider.js +7 -1
  24. package/dist/base/build/src/cli/validate-workflow-artifacts.js +53 -0
  25. package/dist/base/build/src/cli/workflow.js +5 -1
  26. package/dist/base/build/src/flow-kit/provision.d.ts +23 -0
  27. package/dist/base/build/src/flow-kit/provision.js +99 -0
  28. package/dist/base/build/src/flow-kit/validate.d.ts +52 -0
  29. package/dist/base/build/src/flow-kit/validate.js +214 -9
  30. package/dist/base/build/src/runtime-adapters.js +1 -1
  31. package/dist/base/context/contracts/execution-contract.md +30 -1
  32. package/dist/base/context/contracts/review-contract.md +4 -0
  33. package/dist/base/context/contracts/trigger-guards.md +73 -0
  34. package/dist/base/context/settings/backlog-provider-settings.json +1 -1
  35. package/dist/base/context/settings/workspace-backlog-provider-settings.example.json +1 -1
  36. package/dist/base/docs/adr/0023-kit-provisioning.md +47 -0
  37. package/dist/base/docs/adr/index.md +1 -0
  38. package/dist/base/docs/architecture-engine-and-kits.md +17 -0
  39. package/dist/base/docs/context-map.md +3 -0
  40. package/dist/base/docs/decisions/backlog-readiness-source.md +89 -0
  41. package/dist/base/docs/decisions/index.md +1 -0
  42. package/dist/base/docs/developer-architecture.md +3 -3
  43. package/dist/base/docs/flow-kit-repository-contract.md +34 -3
  44. package/dist/base/docs/kit-authoring-guide.md +1 -1
  45. package/dist/base/docs/veritas-integration.md +12 -0
  46. package/dist/base/evals/ci/run-baseline.sh +4 -0
  47. package/dist/base/evals/integration/test_kit_provisioning.sh +112 -0
  48. package/dist/base/evals/integration/test_pull_work_provider.sh +18 -0
  49. package/dist/base/evals/integration/test_veritas_governance_kit.sh +256 -0
  50. package/dist/base/evals/integration/test_workflow_artifacts.sh +257 -0
  51. package/dist/base/evals/static/test_package.sh +6 -0
  52. package/dist/base/evals/static/test_workflow_skills.sh +16 -0
  53. package/dist/base/install.sh +1 -1
  54. package/dist/base/kits/builder/flows/publish-learn.flow.json +9 -1
  55. package/dist/base/kits/builder/skills/execute-plan/SKILL.md +4 -3
  56. package/dist/base/kits/builder/skills/pull-work/SKILL.md +12 -0
  57. package/dist/base/kits/builder/skills/review-work/SKILL.md +11 -0
  58. package/dist/base/kits/veritas-governance/adapter/readiness-to-trust-bundle.mjs +19 -20
  59. package/dist/base/kits/veritas-governance/assets/starter-hooks/githooks/post-commit +13 -0
  60. package/dist/base/kits/veritas-governance/assets/starter-hooks/githooks/pre-push +13 -0
  61. package/dist/base/kits/veritas-governance/assets/starter-standards/veritas/GOVERNANCE.md +23 -0
  62. package/dist/base/kits/veritas-governance/assets/starter-standards/veritas/README.md +58 -0
  63. package/dist/base/kits/veritas-governance/assets/starter-standards/veritas/authority/default.authority-settings.json +30 -0
  64. package/dist/base/kits/veritas-governance/assets/starter-standards/veritas/repo-map.json +115 -0
  65. package/dist/base/kits/veritas-governance/assets/starter-standards/veritas/repo-standards/default.repo-standards.json +54 -0
  66. package/dist/base/kits/veritas-governance/assets/starter-standards/veritas.claims.json +179 -0
  67. package/dist/base/kits/veritas-governance/docs/README.md +141 -10
  68. package/dist/base/kits/veritas-governance/fixtures/standards-authoring/approved.trust-bundle.json +74 -0
  69. package/dist/base/kits/veritas-governance/fixtures/standards-authoring/not-approved.trust-bundle.json +74 -0
  70. package/dist/base/kits/veritas-governance/flows/standards-authoring.flow.json +35 -0
  71. package/dist/base/kits/veritas-governance/kit.json +65 -0
  72. package/dist/base/kits/veritas-governance/skills/consult-standards/SKILL.md +73 -0
  73. package/dist/base/kits/veritas-governance/skills/standards-authoring/SKILL.md +87 -0
  74. package/dist/base/schemas/backlog-provider-settings.schema.json +1 -1
  75. package/dist/base/schemas/workflow-waves.schema.json +347 -0
  76. package/dist/base/scripts/check-layer-boundary.mjs +98 -0
  77. package/dist/catalog.json +2 -0
  78. package/dist/claude-code/.claude/agents/tool-security-reviewer.md +2 -1
  79. package/dist/claude-code/.claude/skills/consult-standards/SKILL.md +73 -0
  80. package/dist/claude-code/.claude/skills/execute-plan/SKILL.md +4 -3
  81. package/dist/claude-code/.claude/skills/pull-work/SKILL.md +12 -0
  82. package/dist/claude-code/.claude/skills/review-work/SKILL.md +11 -0
  83. package/dist/claude-code/.claude/skills/standards-authoring/SKILL.md +87 -0
  84. package/dist/claude-code/build/package.json +1 -1
  85. package/dist/claude-code/build/src/cli/init.js +35 -3
  86. package/dist/claude-code/build/src/cli/kit.js +95 -2
  87. package/dist/claude-code/build/src/cli/pull-work-provider.js +7 -1
  88. package/dist/claude-code/build/src/cli/validate-workflow-artifacts.js +53 -0
  89. package/dist/claude-code/build/src/cli/workflow.js +5 -1
  90. package/dist/claude-code/build/src/flow-kit/provision.d.ts +23 -0
  91. package/dist/claude-code/build/src/flow-kit/provision.js +99 -0
  92. package/dist/claude-code/build/src/flow-kit/validate.d.ts +52 -0
  93. package/dist/claude-code/build/src/flow-kit/validate.js +214 -9
  94. package/dist/claude-code/build/src/runtime-adapters.js +1 -1
  95. package/dist/claude-code/context/contracts/execution-contract.md +30 -1
  96. package/dist/claude-code/context/contracts/review-contract.md +4 -0
  97. package/dist/claude-code/context/contracts/trigger-guards.md +73 -0
  98. package/dist/claude-code/context/settings/backlog-provider-settings.json +1 -1
  99. package/dist/claude-code/context/settings/workspace-backlog-provider-settings.example.json +1 -1
  100. package/dist/claude-code/docs/adr/0023-kit-provisioning.md +47 -0
  101. package/dist/claude-code/docs/adr/index.md +1 -0
  102. package/dist/claude-code/docs/architecture-engine-and-kits.md +17 -0
  103. package/dist/claude-code/docs/context-map.md +3 -0
  104. package/dist/claude-code/docs/decisions/backlog-readiness-source.md +89 -0
  105. package/dist/claude-code/docs/decisions/index.md +1 -0
  106. package/dist/claude-code/docs/developer-architecture.md +3 -3
  107. package/dist/claude-code/docs/flow-kit-repository-contract.md +34 -3
  108. package/dist/claude-code/docs/kit-authoring-guide.md +1 -1
  109. package/dist/claude-code/docs/veritas-integration.md +12 -0
  110. package/dist/claude-code/evals/ci/run-baseline.sh +4 -0
  111. package/dist/claude-code/evals/integration/test_kit_provisioning.sh +112 -0
  112. package/dist/claude-code/evals/integration/test_pull_work_provider.sh +18 -0
  113. package/dist/claude-code/evals/integration/test_veritas_governance_kit.sh +256 -0
  114. package/dist/claude-code/evals/integration/test_workflow_artifacts.sh +257 -0
  115. package/dist/claude-code/evals/static/test_package.sh +6 -0
  116. package/dist/claude-code/evals/static/test_workflow_skills.sh +16 -0
  117. package/dist/claude-code/install.sh +1 -1
  118. package/dist/claude-code/kits/builder/flows/publish-learn.flow.json +9 -1
  119. package/dist/claude-code/kits/builder/skills/execute-plan/SKILL.md +4 -3
  120. package/dist/claude-code/kits/builder/skills/pull-work/SKILL.md +12 -0
  121. package/dist/claude-code/kits/builder/skills/review-work/SKILL.md +11 -0
  122. package/dist/claude-code/kits/veritas-governance/adapter/readiness-to-trust-bundle.mjs +19 -20
  123. package/dist/claude-code/kits/veritas-governance/assets/starter-hooks/githooks/post-commit +13 -0
  124. package/dist/claude-code/kits/veritas-governance/assets/starter-hooks/githooks/pre-push +13 -0
  125. package/dist/claude-code/kits/veritas-governance/assets/starter-standards/veritas/GOVERNANCE.md +23 -0
  126. package/dist/claude-code/kits/veritas-governance/assets/starter-standards/veritas/README.md +58 -0
  127. package/dist/claude-code/kits/veritas-governance/assets/starter-standards/veritas/authority/default.authority-settings.json +30 -0
  128. package/dist/claude-code/kits/veritas-governance/assets/starter-standards/veritas/repo-map.json +115 -0
  129. package/dist/claude-code/kits/veritas-governance/assets/starter-standards/veritas/repo-standards/default.repo-standards.json +54 -0
  130. package/dist/claude-code/kits/veritas-governance/assets/starter-standards/veritas.claims.json +179 -0
  131. package/dist/claude-code/kits/veritas-governance/docs/README.md +141 -10
  132. package/dist/claude-code/kits/veritas-governance/fixtures/standards-authoring/approved.trust-bundle.json +74 -0
  133. package/dist/claude-code/kits/veritas-governance/fixtures/standards-authoring/not-approved.trust-bundle.json +74 -0
  134. package/dist/claude-code/kits/veritas-governance/flows/standards-authoring.flow.json +35 -0
  135. package/dist/claude-code/kits/veritas-governance/kit.json +65 -0
  136. package/dist/claude-code/kits/veritas-governance/skills/consult-standards/SKILL.md +73 -0
  137. package/dist/claude-code/kits/veritas-governance/skills/standards-authoring/SKILL.md +87 -0
  138. package/dist/claude-code/schemas/backlog-provider-settings.schema.json +1 -1
  139. package/dist/claude-code/schemas/workflow-waves.schema.json +347 -0
  140. package/dist/claude-code/scripts/check-layer-boundary.mjs +98 -0
  141. package/dist/codex/.agents/skills/builder-shape/context/contracts/execution-contract.md +30 -1
  142. package/dist/codex/.agents/skills/consult-standards/SKILL.md +73 -0
  143. package/dist/codex/.agents/skills/deliver/context/contracts/execution-contract.md +30 -1
  144. package/dist/codex/.agents/skills/design-probe/context/contracts/execution-contract.md +30 -1
  145. package/dist/codex/.agents/skills/execute-plan/SKILL.md +4 -3
  146. package/dist/codex/.agents/skills/execute-plan/context/contracts/execution-contract.md +30 -1
  147. package/dist/codex/.agents/skills/fix-bug/context/contracts/execution-contract.md +30 -1
  148. package/dist/codex/.agents/skills/idea-to-backlog/context/contracts/execution-contract.md +30 -1
  149. package/dist/codex/.agents/skills/plan-work/context/contracts/execution-contract.md +30 -1
  150. package/dist/codex/.agents/skills/pull-work/SKILL.md +12 -0
  151. package/dist/codex/.agents/skills/pull-work/context/contracts/execution-contract.md +30 -1
  152. package/dist/codex/.agents/skills/review-work/SKILL.md +11 -0
  153. package/dist/codex/.agents/skills/review-work/context/contracts/execution-contract.md +30 -1
  154. package/dist/codex/.agents/skills/standards-authoring/SKILL.md +87 -0
  155. package/dist/codex/.agents/skills/tdd-workflow/context/contracts/execution-contract.md +30 -1
  156. package/dist/codex/.agents/skills/verify-work/context/contracts/execution-contract.md +30 -1
  157. package/dist/codex/.codex/agents/tool-security-reviewer.toml +1 -1
  158. package/dist/codex/build/package.json +1 -1
  159. package/dist/codex/build/src/cli/init.js +35 -3
  160. package/dist/codex/build/src/cli/kit.js +95 -2
  161. package/dist/codex/build/src/cli/pull-work-provider.js +7 -1
  162. package/dist/codex/build/src/cli/validate-workflow-artifacts.js +53 -0
  163. package/dist/codex/build/src/cli/workflow.js +5 -1
  164. package/dist/codex/build/src/flow-kit/provision.d.ts +23 -0
  165. package/dist/codex/build/src/flow-kit/provision.js +99 -0
  166. package/dist/codex/build/src/flow-kit/validate.d.ts +52 -0
  167. package/dist/codex/build/src/flow-kit/validate.js +214 -9
  168. package/dist/codex/build/src/runtime-adapters.js +1 -1
  169. package/dist/codex/context/contracts/execution-contract.md +30 -1
  170. package/dist/codex/context/contracts/review-contract.md +4 -0
  171. package/dist/codex/context/contracts/trigger-guards.md +73 -0
  172. package/dist/codex/context/settings/backlog-provider-settings.json +1 -1
  173. package/dist/codex/context/settings/workspace-backlog-provider-settings.example.json +1 -1
  174. package/dist/codex/docs/adr/0023-kit-provisioning.md +47 -0
  175. package/dist/codex/docs/adr/index.md +1 -0
  176. package/dist/codex/docs/architecture-engine-and-kits.md +17 -0
  177. package/dist/codex/docs/context-map.md +3 -0
  178. package/dist/codex/docs/decisions/backlog-readiness-source.md +89 -0
  179. package/dist/codex/docs/decisions/index.md +1 -0
  180. package/dist/codex/docs/developer-architecture.md +3 -3
  181. package/dist/codex/docs/flow-kit-repository-contract.md +34 -3
  182. package/dist/codex/docs/kit-authoring-guide.md +1 -1
  183. package/dist/codex/docs/veritas-integration.md +12 -0
  184. package/dist/codex/evals/ci/run-baseline.sh +4 -0
  185. package/dist/codex/evals/integration/test_kit_provisioning.sh +112 -0
  186. package/dist/codex/evals/integration/test_pull_work_provider.sh +18 -0
  187. package/dist/codex/evals/integration/test_veritas_governance_kit.sh +256 -0
  188. package/dist/codex/evals/integration/test_workflow_artifacts.sh +257 -0
  189. package/dist/codex/evals/static/test_package.sh +6 -0
  190. package/dist/codex/evals/static/test_workflow_skills.sh +16 -0
  191. package/dist/codex/install.sh +1 -1
  192. package/dist/codex/kits/builder/flows/publish-learn.flow.json +9 -1
  193. package/dist/codex/kits/builder/skills/execute-plan/SKILL.md +4 -3
  194. package/dist/codex/kits/builder/skills/pull-work/SKILL.md +12 -0
  195. package/dist/codex/kits/builder/skills/review-work/SKILL.md +11 -0
  196. package/dist/codex/kits/veritas-governance/adapter/readiness-to-trust-bundle.mjs +19 -20
  197. package/dist/codex/kits/veritas-governance/assets/starter-hooks/githooks/post-commit +13 -0
  198. package/dist/codex/kits/veritas-governance/assets/starter-hooks/githooks/pre-push +13 -0
  199. package/dist/codex/kits/veritas-governance/assets/starter-standards/veritas/GOVERNANCE.md +23 -0
  200. package/dist/codex/kits/veritas-governance/assets/starter-standards/veritas/README.md +58 -0
  201. package/dist/codex/kits/veritas-governance/assets/starter-standards/veritas/authority/default.authority-settings.json +30 -0
  202. package/dist/codex/kits/veritas-governance/assets/starter-standards/veritas/repo-map.json +115 -0
  203. package/dist/codex/kits/veritas-governance/assets/starter-standards/veritas/repo-standards/default.repo-standards.json +54 -0
  204. package/dist/codex/kits/veritas-governance/assets/starter-standards/veritas.claims.json +179 -0
  205. package/dist/codex/kits/veritas-governance/docs/README.md +141 -10
  206. package/dist/codex/kits/veritas-governance/fixtures/standards-authoring/approved.trust-bundle.json +74 -0
  207. package/dist/codex/kits/veritas-governance/fixtures/standards-authoring/not-approved.trust-bundle.json +74 -0
  208. package/dist/codex/kits/veritas-governance/flows/standards-authoring.flow.json +35 -0
  209. package/dist/codex/kits/veritas-governance/kit.json +65 -0
  210. package/dist/codex/kits/veritas-governance/skills/consult-standards/SKILL.md +73 -0
  211. package/dist/codex/kits/veritas-governance/skills/standards-authoring/SKILL.md +87 -0
  212. package/dist/codex/schemas/backlog-provider-settings.schema.json +1 -1
  213. package/dist/codex/schemas/workflow-waves.schema.json +347 -0
  214. package/dist/codex/scripts/check-layer-boundary.mjs +98 -0
  215. package/dist/kiro/agents/tool-security-reviewer.json +1 -1
  216. package/dist/kiro/build/package.json +1 -1
  217. package/dist/kiro/build/src/cli/init.js +35 -3
  218. package/dist/kiro/build/src/cli/kit.js +95 -2
  219. package/dist/kiro/build/src/cli/pull-work-provider.js +7 -1
  220. package/dist/kiro/build/src/cli/validate-workflow-artifacts.js +53 -0
  221. package/dist/kiro/build/src/cli/workflow.js +5 -1
  222. package/dist/kiro/build/src/flow-kit/provision.d.ts +23 -0
  223. package/dist/kiro/build/src/flow-kit/provision.js +99 -0
  224. package/dist/kiro/build/src/flow-kit/validate.d.ts +52 -0
  225. package/dist/kiro/build/src/flow-kit/validate.js +214 -9
  226. package/dist/kiro/build/src/runtime-adapters.js +1 -1
  227. package/dist/kiro/context/contracts/execution-contract.md +30 -1
  228. package/dist/kiro/context/contracts/review-contract.md +4 -0
  229. package/dist/kiro/context/contracts/trigger-guards.md +73 -0
  230. package/dist/kiro/context/settings/backlog-provider-settings.json +1 -1
  231. package/dist/kiro/context/settings/workspace-backlog-provider-settings.example.json +1 -1
  232. package/dist/kiro/docs/adr/0023-kit-provisioning.md +47 -0
  233. package/dist/kiro/docs/adr/index.md +1 -0
  234. package/dist/kiro/docs/architecture-engine-and-kits.md +17 -0
  235. package/dist/kiro/docs/context-map.md +3 -0
  236. package/dist/kiro/docs/decisions/backlog-readiness-source.md +89 -0
  237. package/dist/kiro/docs/decisions/index.md +1 -0
  238. package/dist/kiro/docs/developer-architecture.md +3 -3
  239. package/dist/kiro/docs/flow-kit-repository-contract.md +34 -3
  240. package/dist/kiro/docs/kit-authoring-guide.md +1 -1
  241. package/dist/kiro/docs/veritas-integration.md +12 -0
  242. package/dist/kiro/evals/ci/run-baseline.sh +4 -0
  243. package/dist/kiro/evals/integration/test_kit_provisioning.sh +112 -0
  244. package/dist/kiro/evals/integration/test_pull_work_provider.sh +18 -0
  245. package/dist/kiro/evals/integration/test_veritas_governance_kit.sh +256 -0
  246. package/dist/kiro/evals/integration/test_workflow_artifacts.sh +257 -0
  247. package/dist/kiro/evals/static/test_package.sh +6 -0
  248. package/dist/kiro/evals/static/test_workflow_skills.sh +16 -0
  249. package/dist/kiro/install.sh +1 -1
  250. package/dist/kiro/kits/builder/flows/publish-learn.flow.json +9 -1
  251. package/dist/kiro/kits/builder/skills/execute-plan/SKILL.md +4 -3
  252. package/dist/kiro/kits/builder/skills/pull-work/SKILL.md +12 -0
  253. package/dist/kiro/kits/builder/skills/review-work/SKILL.md +11 -0
  254. package/dist/kiro/kits/veritas-governance/adapter/readiness-to-trust-bundle.mjs +19 -20
  255. package/dist/kiro/kits/veritas-governance/assets/starter-hooks/githooks/post-commit +13 -0
  256. package/dist/kiro/kits/veritas-governance/assets/starter-hooks/githooks/pre-push +13 -0
  257. package/dist/kiro/kits/veritas-governance/assets/starter-standards/veritas/GOVERNANCE.md +23 -0
  258. package/dist/kiro/kits/veritas-governance/assets/starter-standards/veritas/README.md +58 -0
  259. package/dist/kiro/kits/veritas-governance/assets/starter-standards/veritas/authority/default.authority-settings.json +30 -0
  260. package/dist/kiro/kits/veritas-governance/assets/starter-standards/veritas/repo-map.json +115 -0
  261. package/dist/kiro/kits/veritas-governance/assets/starter-standards/veritas/repo-standards/default.repo-standards.json +54 -0
  262. package/dist/kiro/kits/veritas-governance/assets/starter-standards/veritas.claims.json +179 -0
  263. package/dist/kiro/kits/veritas-governance/docs/README.md +141 -10
  264. package/dist/kiro/kits/veritas-governance/fixtures/standards-authoring/approved.trust-bundle.json +74 -0
  265. package/dist/kiro/kits/veritas-governance/fixtures/standards-authoring/not-approved.trust-bundle.json +74 -0
  266. package/dist/kiro/kits/veritas-governance/flows/standards-authoring.flow.json +35 -0
  267. package/dist/kiro/kits/veritas-governance/kit.json +65 -0
  268. package/dist/kiro/kits/veritas-governance/skills/consult-standards/SKILL.md +73 -0
  269. package/dist/kiro/kits/veritas-governance/skills/standards-authoring/SKILL.md +87 -0
  270. package/dist/kiro/schemas/backlog-provider-settings.schema.json +1 -1
  271. package/dist/kiro/schemas/workflow-waves.schema.json +347 -0
  272. package/dist/kiro/scripts/check-layer-boundary.mjs +98 -0
  273. package/dist/opencode/.opencode/agents/tool-security-reviewer.md +2 -1
  274. package/dist/opencode/.opencode/skills/consult-standards/SKILL.md +73 -0
  275. package/dist/opencode/.opencode/skills/execute-plan/SKILL.md +4 -3
  276. package/dist/opencode/.opencode/skills/pull-work/SKILL.md +12 -0
  277. package/dist/opencode/.opencode/skills/review-work/SKILL.md +11 -0
  278. package/dist/opencode/.opencode/skills/standards-authoring/SKILL.md +87 -0
  279. package/dist/opencode/build/package.json +1 -1
  280. package/dist/opencode/build/src/cli/init.js +35 -3
  281. package/dist/opencode/build/src/cli/kit.js +95 -2
  282. package/dist/opencode/build/src/cli/pull-work-provider.js +7 -1
  283. package/dist/opencode/build/src/cli/validate-workflow-artifacts.js +53 -0
  284. package/dist/opencode/build/src/cli/workflow.js +5 -1
  285. package/dist/opencode/build/src/flow-kit/provision.d.ts +23 -0
  286. package/dist/opencode/build/src/flow-kit/provision.js +99 -0
  287. package/dist/opencode/build/src/flow-kit/validate.d.ts +52 -0
  288. package/dist/opencode/build/src/flow-kit/validate.js +214 -9
  289. package/dist/opencode/build/src/runtime-adapters.js +1 -1
  290. package/dist/opencode/context/contracts/execution-contract.md +30 -1
  291. package/dist/opencode/context/contracts/review-contract.md +4 -0
  292. package/dist/opencode/context/contracts/trigger-guards.md +73 -0
  293. package/dist/opencode/context/settings/backlog-provider-settings.json +1 -1
  294. package/dist/opencode/context/settings/workspace-backlog-provider-settings.example.json +1 -1
  295. package/dist/opencode/docs/adr/0023-kit-provisioning.md +47 -0
  296. package/dist/opencode/docs/adr/index.md +1 -0
  297. package/dist/opencode/docs/architecture-engine-and-kits.md +17 -0
  298. package/dist/opencode/docs/context-map.md +3 -0
  299. package/dist/opencode/docs/decisions/backlog-readiness-source.md +89 -0
  300. package/dist/opencode/docs/decisions/index.md +1 -0
  301. package/dist/opencode/docs/developer-architecture.md +3 -3
  302. package/dist/opencode/docs/flow-kit-repository-contract.md +34 -3
  303. package/dist/opencode/docs/kit-authoring-guide.md +1 -1
  304. package/dist/opencode/docs/veritas-integration.md +12 -0
  305. package/dist/opencode/evals/ci/run-baseline.sh +4 -0
  306. package/dist/opencode/evals/integration/test_kit_provisioning.sh +112 -0
  307. package/dist/opencode/evals/integration/test_pull_work_provider.sh +18 -0
  308. package/dist/opencode/evals/integration/test_veritas_governance_kit.sh +256 -0
  309. package/dist/opencode/evals/integration/test_workflow_artifacts.sh +257 -0
  310. package/dist/opencode/evals/static/test_package.sh +6 -0
  311. package/dist/opencode/evals/static/test_workflow_skills.sh +16 -0
  312. package/dist/opencode/install.sh +1 -1
  313. package/dist/opencode/kits/builder/flows/publish-learn.flow.json +9 -1
  314. package/dist/opencode/kits/builder/skills/execute-plan/SKILL.md +4 -3
  315. package/dist/opencode/kits/builder/skills/pull-work/SKILL.md +12 -0
  316. package/dist/opencode/kits/builder/skills/review-work/SKILL.md +11 -0
  317. package/dist/opencode/kits/veritas-governance/adapter/readiness-to-trust-bundle.mjs +19 -20
  318. package/dist/opencode/kits/veritas-governance/assets/starter-hooks/githooks/post-commit +13 -0
  319. package/dist/opencode/kits/veritas-governance/assets/starter-hooks/githooks/pre-push +13 -0
  320. package/dist/opencode/kits/veritas-governance/assets/starter-standards/veritas/GOVERNANCE.md +23 -0
  321. package/dist/opencode/kits/veritas-governance/assets/starter-standards/veritas/README.md +58 -0
  322. package/dist/opencode/kits/veritas-governance/assets/starter-standards/veritas/authority/default.authority-settings.json +30 -0
  323. package/dist/opencode/kits/veritas-governance/assets/starter-standards/veritas/repo-map.json +115 -0
  324. package/dist/opencode/kits/veritas-governance/assets/starter-standards/veritas/repo-standards/default.repo-standards.json +54 -0
  325. package/dist/opencode/kits/veritas-governance/assets/starter-standards/veritas.claims.json +179 -0
  326. package/dist/opencode/kits/veritas-governance/docs/README.md +141 -10
  327. package/dist/opencode/kits/veritas-governance/fixtures/standards-authoring/approved.trust-bundle.json +74 -0
  328. package/dist/opencode/kits/veritas-governance/fixtures/standards-authoring/not-approved.trust-bundle.json +74 -0
  329. package/dist/opencode/kits/veritas-governance/flows/standards-authoring.flow.json +35 -0
  330. package/dist/opencode/kits/veritas-governance/kit.json +65 -0
  331. package/dist/opencode/kits/veritas-governance/skills/consult-standards/SKILL.md +73 -0
  332. package/dist/opencode/kits/veritas-governance/skills/standards-authoring/SKILL.md +87 -0
  333. package/dist/opencode/schemas/backlog-provider-settings.schema.json +1 -1
  334. package/dist/opencode/schemas/workflow-waves.schema.json +347 -0
  335. package/dist/opencode/scripts/check-layer-boundary.mjs +98 -0
  336. package/dist/pi/.pi/skills/consult-standards/SKILL.md +73 -0
  337. package/dist/pi/.pi/skills/execute-plan/SKILL.md +4 -3
  338. package/dist/pi/.pi/skills/pull-work/SKILL.md +12 -0
  339. package/dist/pi/.pi/skills/review-work/SKILL.md +11 -0
  340. package/dist/pi/.pi/skills/standards-authoring/SKILL.md +87 -0
  341. package/dist/pi/build/package.json +1 -1
  342. package/dist/pi/build/src/cli/init.js +35 -3
  343. package/dist/pi/build/src/cli/kit.js +95 -2
  344. package/dist/pi/build/src/cli/pull-work-provider.js +7 -1
  345. package/dist/pi/build/src/cli/validate-workflow-artifacts.js +53 -0
  346. package/dist/pi/build/src/cli/workflow.js +5 -1
  347. package/dist/pi/build/src/flow-kit/provision.d.ts +23 -0
  348. package/dist/pi/build/src/flow-kit/provision.js +99 -0
  349. package/dist/pi/build/src/flow-kit/validate.d.ts +52 -0
  350. package/dist/pi/build/src/flow-kit/validate.js +214 -9
  351. package/dist/pi/build/src/runtime-adapters.js +1 -1
  352. package/dist/pi/context/contracts/execution-contract.md +30 -1
  353. package/dist/pi/context/contracts/review-contract.md +4 -0
  354. package/dist/pi/context/contracts/trigger-guards.md +73 -0
  355. package/dist/pi/context/settings/backlog-provider-settings.json +1 -1
  356. package/dist/pi/context/settings/workspace-backlog-provider-settings.example.json +1 -1
  357. package/dist/pi/docs/adr/0023-kit-provisioning.md +47 -0
  358. package/dist/pi/docs/adr/index.md +1 -0
  359. package/dist/pi/docs/architecture-engine-and-kits.md +17 -0
  360. package/dist/pi/docs/context-map.md +3 -0
  361. package/dist/pi/docs/decisions/backlog-readiness-source.md +89 -0
  362. package/dist/pi/docs/decisions/index.md +1 -0
  363. package/dist/pi/docs/developer-architecture.md +3 -3
  364. package/dist/pi/docs/flow-kit-repository-contract.md +34 -3
  365. package/dist/pi/docs/kit-authoring-guide.md +1 -1
  366. package/dist/pi/docs/veritas-integration.md +12 -0
  367. package/dist/pi/evals/ci/run-baseline.sh +4 -0
  368. package/dist/pi/evals/integration/test_kit_provisioning.sh +112 -0
  369. package/dist/pi/evals/integration/test_pull_work_provider.sh +18 -0
  370. package/dist/pi/evals/integration/test_veritas_governance_kit.sh +256 -0
  371. package/dist/pi/evals/integration/test_workflow_artifacts.sh +257 -0
  372. package/dist/pi/evals/static/test_package.sh +6 -0
  373. package/dist/pi/evals/static/test_workflow_skills.sh +16 -0
  374. package/dist/pi/install.sh +1 -1
  375. package/dist/pi/kits/builder/flows/publish-learn.flow.json +9 -1
  376. package/dist/pi/kits/builder/skills/execute-plan/SKILL.md +4 -3
  377. package/dist/pi/kits/builder/skills/pull-work/SKILL.md +12 -0
  378. package/dist/pi/kits/builder/skills/review-work/SKILL.md +11 -0
  379. package/dist/pi/kits/veritas-governance/adapter/readiness-to-trust-bundle.mjs +19 -20
  380. package/dist/pi/kits/veritas-governance/assets/starter-hooks/githooks/post-commit +13 -0
  381. package/dist/pi/kits/veritas-governance/assets/starter-hooks/githooks/pre-push +13 -0
  382. package/dist/pi/kits/veritas-governance/assets/starter-standards/veritas/GOVERNANCE.md +23 -0
  383. package/dist/pi/kits/veritas-governance/assets/starter-standards/veritas/README.md +58 -0
  384. package/dist/pi/kits/veritas-governance/assets/starter-standards/veritas/authority/default.authority-settings.json +30 -0
  385. package/dist/pi/kits/veritas-governance/assets/starter-standards/veritas/repo-map.json +115 -0
  386. package/dist/pi/kits/veritas-governance/assets/starter-standards/veritas/repo-standards/default.repo-standards.json +54 -0
  387. package/dist/pi/kits/veritas-governance/assets/starter-standards/veritas.claims.json +179 -0
  388. package/dist/pi/kits/veritas-governance/docs/README.md +141 -10
  389. package/dist/pi/kits/veritas-governance/fixtures/standards-authoring/approved.trust-bundle.json +74 -0
  390. package/dist/pi/kits/veritas-governance/fixtures/standards-authoring/not-approved.trust-bundle.json +74 -0
  391. package/dist/pi/kits/veritas-governance/flows/standards-authoring.flow.json +35 -0
  392. package/dist/pi/kits/veritas-governance/kit.json +65 -0
  393. package/dist/pi/kits/veritas-governance/skills/consult-standards/SKILL.md +73 -0
  394. package/dist/pi/kits/veritas-governance/skills/standards-authoring/SKILL.md +87 -0
  395. package/dist/pi/schemas/backlog-provider-settings.schema.json +1 -1
  396. package/dist/pi/schemas/workflow-waves.schema.json +347 -0
  397. package/dist/pi/scripts/check-layer-boundary.mjs +98 -0
  398. package/docs/adr/0023-kit-provisioning.md +47 -0
  399. package/docs/adr/index.md +1 -0
  400. package/docs/architecture-engine-and-kits.md +17 -0
  401. package/docs/context-map.md +3 -0
  402. package/docs/decisions/backlog-readiness-source.md +89 -0
  403. package/docs/decisions/index.md +1 -0
  404. package/docs/developer-architecture.md +3 -3
  405. package/docs/flow-kit-repository-contract.md +34 -3
  406. package/docs/kit-authoring-guide.md +1 -1
  407. package/docs/veritas-integration.md +12 -0
  408. package/evals/ci/run-baseline.sh +4 -0
  409. package/evals/integration/test_kit_provisioning.sh +112 -0
  410. package/evals/integration/test_pull_work_provider.sh +18 -0
  411. package/evals/integration/test_veritas_governance_kit.sh +256 -0
  412. package/evals/integration/test_workflow_artifacts.sh +257 -0
  413. package/evals/static/test_package.sh +6 -0
  414. package/evals/static/test_workflow_skills.sh +16 -0
  415. package/kits/builder/flows/publish-learn.flow.json +9 -1
  416. package/kits/builder/skills/execute-plan/SKILL.md +4 -3
  417. package/kits/builder/skills/pull-work/SKILL.md +12 -0
  418. package/kits/builder/skills/review-work/SKILL.md +11 -0
  419. package/kits/veritas-governance/adapter/readiness-to-trust-bundle.mjs +19 -20
  420. package/kits/veritas-governance/assets/starter-hooks/githooks/post-commit +13 -0
  421. package/kits/veritas-governance/assets/starter-hooks/githooks/pre-push +13 -0
  422. package/kits/veritas-governance/assets/starter-standards/veritas/GOVERNANCE.md +23 -0
  423. package/kits/veritas-governance/assets/starter-standards/veritas/README.md +58 -0
  424. package/kits/veritas-governance/assets/starter-standards/veritas/authority/default.authority-settings.json +30 -0
  425. package/kits/veritas-governance/assets/starter-standards/veritas/repo-map.json +115 -0
  426. package/kits/veritas-governance/assets/starter-standards/veritas/repo-standards/default.repo-standards.json +54 -0
  427. package/kits/veritas-governance/assets/starter-standards/veritas.claims.json +179 -0
  428. package/kits/veritas-governance/docs/README.md +141 -10
  429. package/kits/veritas-governance/fixtures/standards-authoring/approved.trust-bundle.json +74 -0
  430. package/kits/veritas-governance/fixtures/standards-authoring/not-approved.trust-bundle.json +74 -0
  431. package/kits/veritas-governance/flows/standards-authoring.flow.json +35 -0
  432. package/kits/veritas-governance/kit.json +65 -0
  433. package/kits/veritas-governance/skills/consult-standards/SKILL.md +73 -0
  434. package/kits/veritas-governance/skills/standards-authoring/SKILL.md +87 -0
  435. package/package.json +2 -1
  436. package/schemas/backlog-provider-settings.schema.json +1 -1
  437. package/schemas/workflow-waves.schema.json +347 -0
  438. package/scripts/check-layer-boundary.mjs +98 -0
  439. package/src/cli/builder-flow-runtime.test.mjs +86 -0
  440. package/src/cli/flow-resolver-composition.test.mjs +20 -1
  441. package/src/cli/init.ts +31 -3
  442. package/src/cli/kit-metadata-security.test.mjs +163 -1
  443. package/src/cli/kit-provisioning.test.mjs +122 -0
  444. package/src/cli/kit.ts +83 -2
  445. package/src/cli/pull-work-provider.ts +7 -1
  446. package/src/cli/validate-waves.test.mjs +134 -0
  447. package/src/cli/validate-workflow-artifacts.ts +47 -0
  448. package/src/cli/workflow.ts +7 -1
  449. package/src/flow-kit/provision.ts +118 -0
  450. package/src/flow-kit/validate.ts +233 -10
  451. package/src/runtime-adapters.ts +1 -1
@@ -0,0 +1,115 @@
1
+ {
2
+ "name": "your-project",
3
+ "kind": "repo-map",
4
+ "policy": {
5
+ "defaultFalsePositiveReview": "unknown",
6
+ "defaultPromotionCandidate": false,
7
+ "defaultExceptionAllowed": false
8
+ },
9
+ "graph": {
10
+ "version": 1,
11
+ "defaultResolution": {
12
+ "phase": "Phase 0 (Bootstrap)",
13
+ "workstream": "Initial Project Setup",
14
+ "matchedArtifacts": [
15
+ "README.md"
16
+ ]
17
+ },
18
+ "nonSliceableInvariants": [
19
+ "baseline evidenceCheck",
20
+ "repo-local guidance",
21
+ "tracked standards artifacts"
22
+ ],
23
+ "resolverPrecedence": [
24
+ "explicit task or issue reference",
25
+ "matching local artifact under .veritas/**",
26
+ "active repo roadmap or README guidance",
27
+ "multi-workstream fallback suppresses promotion"
28
+ ],
29
+ "resolutionRules": [
30
+ {
31
+ "id": "veritas-files",
32
+ "match": {
33
+ "patterns": [
34
+ ".veritas/"
35
+ ]
36
+ },
37
+ "resolution": {
38
+ "phase": "Phase 0 (Bootstrap)",
39
+ "workstream": "Initial Project Setup",
40
+ "matchedArtifacts": [
41
+ ".veritas/**"
42
+ ]
43
+ }
44
+ }
45
+ ],
46
+ "nodes": [
47
+ {
48
+ "id": "governance.guidance",
49
+ "kind": "protected-area",
50
+ "label": ".veritas/**",
51
+ "patterns": [
52
+ ".veritas/"
53
+ ],
54
+ "governance-locked": true
55
+ },
56
+ {
57
+ "id": "governance.root-manifests",
58
+ "kind": "protected-area",
59
+ "label": "root manifests",
60
+ "patterns": [
61
+ "package.json",
62
+ "package-lock.json",
63
+ "README.md",
64
+ ".gitignore",
65
+ "AGENTS.md"
66
+ ]
67
+ },
68
+ {
69
+ "id": "app.src",
70
+ "kind": "product-area",
71
+ "label": "src/**",
72
+ "patterns": [
73
+ "src/"
74
+ ]
75
+ },
76
+ {
77
+ "id": "verification.tests",
78
+ "kind": "verification-area",
79
+ "label": "tests/**",
80
+ "patterns": [
81
+ "tests/"
82
+ ]
83
+ }
84
+ ]
85
+ },
86
+ "evidence": {
87
+ "artifactDir": ".kontourai/veritas/evidence",
88
+ "evidenceChecks": [
89
+ {
90
+ "id": "required-evidence-check",
91
+ "command": "npm run test",
92
+ "method": "validation",
93
+ "summary": "Default repository evidenceCheck."
94
+ }
95
+ ],
96
+ "requiredEvidenceCheckIds": [
97
+ "required-evidence-check"
98
+ ],
99
+ "reportTransport": "local-json"
100
+ },
101
+ "activation": {
102
+ "aiInstructionFiles": [
103
+ {
104
+ "path": "AGENTS.md",
105
+ "tool": "codex",
106
+ "required": true
107
+ },
108
+ {
109
+ "path": "CLAUDE.md",
110
+ "tool": "claude-code",
111
+ "required": true
112
+ }
113
+ ]
114
+ }
115
+ }
@@ -0,0 +1,54 @@
1
+ {
2
+ "version": 1,
3
+ "name": "your-project-default",
4
+ "description": "Conservative starter Repo Standards for a newly bootstrapped Veritas-enabled repository.",
5
+ "rules": [
6
+ {
7
+ "id": "required-veritas-artifacts",
8
+ "kind": "required-artifacts",
9
+ "classification": "hard-invariant",
10
+ "enforcementLevel": "Require",
11
+ "message": "The bootstrap Veritas artifacts must stay present so agents and reviewers share the same baseline.",
12
+ "owner": "repo-core",
13
+ "rollback_switch": null,
14
+ "match": {
15
+ "artifacts": [
16
+ ".veritas/README.md",
17
+ ".veritas/GOVERNANCE.md",
18
+ ".veritas/repo-map.json",
19
+ ".veritas/repo-standards/default.repo-standards.json",
20
+ ".veritas/authority/default.authority-settings.json"
21
+ ]
22
+ }
23
+ },
24
+ {
25
+ "id": "ai-instruction-files-synced",
26
+ "kind": "governance-block",
27
+ "classification": "hard-invariant",
28
+ "enforcementLevel": "Guide",
29
+ "message": "All required AI tool instruction files must contain the Veritas guidance block.",
30
+ "owner": "repo-maintainers",
31
+ "rollback_switch": null,
32
+ "match": {
33
+ "governance-block": [
34
+ "AGENTS.md",
35
+ "CLAUDE.md"
36
+ ]
37
+ }
38
+ },
39
+ {
40
+ "id": "prefer-veritas-routed-delivery",
41
+ "kind": "required-artifacts",
42
+ "classification": "promotable-policy",
43
+ "enforcementLevel": "Observe",
44
+ "message": "Prefer running new AI-guided changes through Veritas readiness checks and the documented evidenceCheck before review.",
45
+ "owner": "repo-maintainers",
46
+ "rollback_switch": "soften-veritas-route",
47
+ "match": {
48
+ "artifacts": [
49
+ ".veritas/README.md"
50
+ ]
51
+ }
52
+ }
53
+ ]
54
+ }
@@ -0,0 +1,179 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "producer": "veritas",
4
+ "claims": [
5
+ {
6
+ "id": "your-project.surface.governance.guidance",
7
+ "facet": "veritas.affected-surface",
8
+ "claimType": "veritas-affected-surface",
9
+ "fieldOrBehavior": "governance.guidance",
10
+ "subjectType": "repo-surface",
11
+ "subjectId": "your-project:governance.guidance",
12
+ "impactLevel": "medium",
13
+ "verificationPolicyId": "veritas.surface",
14
+ "metadata": {
15
+ "nodeId": "governance.guidance"
16
+ },
17
+ "createdAt": "2026-07-17T04:35:28.137Z",
18
+ "updatedAt": "2026-07-17T04:35:28.137Z"
19
+ },
20
+ {
21
+ "id": "your-project.surface.governance.root-manifests",
22
+ "facet": "veritas.affected-surface",
23
+ "claimType": "veritas-affected-surface",
24
+ "fieldOrBehavior": "governance.root-manifests",
25
+ "subjectType": "repo-surface",
26
+ "subjectId": "your-project:governance.root-manifests",
27
+ "impactLevel": "medium",
28
+ "verificationPolicyId": "veritas.surface",
29
+ "metadata": {
30
+ "nodeId": "governance.root-manifests"
31
+ },
32
+ "createdAt": "2026-07-17T04:35:28.137Z",
33
+ "updatedAt": "2026-07-17T04:35:28.137Z"
34
+ },
35
+ {
36
+ "id": "your-project.surface.app.src",
37
+ "facet": "veritas.affected-surface",
38
+ "claimType": "veritas-affected-surface",
39
+ "fieldOrBehavior": "app.src",
40
+ "subjectType": "repo-surface",
41
+ "subjectId": "your-project:app.src",
42
+ "impactLevel": "medium",
43
+ "verificationPolicyId": "veritas.surface",
44
+ "metadata": {
45
+ "nodeId": "app.src"
46
+ },
47
+ "createdAt": "2026-07-17T04:35:28.137Z",
48
+ "updatedAt": "2026-07-17T04:35:28.137Z"
49
+ },
50
+ {
51
+ "id": "your-project.surface.verification.tests",
52
+ "facet": "veritas.affected-surface",
53
+ "claimType": "veritas-affected-surface",
54
+ "fieldOrBehavior": "verification.tests",
55
+ "subjectType": "repo-surface",
56
+ "subjectId": "your-project:verification.tests",
57
+ "impactLevel": "medium",
58
+ "verificationPolicyId": "veritas.surface",
59
+ "metadata": {
60
+ "nodeId": "verification.tests"
61
+ },
62
+ "createdAt": "2026-07-17T04:35:28.137Z",
63
+ "updatedAt": "2026-07-17T04:35:28.137Z"
64
+ },
65
+ {
66
+ "id": "your-project.governance",
67
+ "facet": "veritas.governance",
68
+ "claimType": "veritas-governance-artifact",
69
+ "fieldOrBehavior": "governance artifact integrity",
70
+ "subjectType": "repository",
71
+ "subjectId": "your-project",
72
+ "impactLevel": "high",
73
+ "verificationPolicyId": "veritas.governance-artifact",
74
+ "createdAt": "2026-07-17T04:35:28.137Z",
75
+ "updatedAt": "2026-07-17T04:35:28.137Z"
76
+ },
77
+ {
78
+ "id": "your-project.evidence-check.npm-run-test",
79
+ "facet": "veritas.evidence-check",
80
+ "claimType": "software-evidence-check",
81
+ "fieldOrBehavior": "npm run test",
82
+ "subjectType": "repository",
83
+ "subjectId": "your-project",
84
+ "impactLevel": "high",
85
+ "verificationPolicyId": "veritas.evidence-check",
86
+ "metadata": {
87
+ "command": "npm run test"
88
+ },
89
+ "createdAt": "2026-07-17T04:35:28.137Z",
90
+ "updatedAt": "2026-07-17T04:35:28.137Z"
91
+ }
92
+ ],
93
+ "policies": [
94
+ {
95
+ "id": "veritas.surface",
96
+ "claimType": "veritas-affected-surface",
97
+ "requiredEvidence": [
98
+ "policy_rule"
99
+ ],
100
+ "requiredMethods": [
101
+ "auditability"
102
+ ],
103
+ "requiresCorroboration": false,
104
+ "acceptanceCriteria": [
105
+ "veritas evidence artifact"
106
+ ],
107
+ "reviewAuthority": "veritas",
108
+ "validityRule": {
109
+ "kind": "commit"
110
+ },
111
+ "stalenessTriggers": [
112
+ "source_ref changes",
113
+ "affected node changes"
114
+ ],
115
+ "conflictRules": [
116
+ "newer evidence for the same node supersedes older evidence"
117
+ ],
118
+ "impactLevel": "medium"
119
+ },
120
+ {
121
+ "id": "veritas.governance-artifact",
122
+ "claimType": "veritas-governance-artifact",
123
+ "requiredEvidence": [
124
+ "attestation",
125
+ "policy_rule"
126
+ ],
127
+ "requiredMethods": [
128
+ "auditability",
129
+ "attestation"
130
+ ],
131
+ "requiresCorroboration": false,
132
+ "acceptanceCriteria": [
133
+ "Protected Standards hash inspection",
134
+ "authority attestation status"
135
+ ],
136
+ "reviewAuthority": "veritas plus authority attestation",
137
+ "validityRule": {
138
+ "kind": "manual"
139
+ },
140
+ "stalenessTriggers": [
141
+ "Repo Standards hash changes",
142
+ "Repo Map hash changes",
143
+ "authority settings hash changes",
144
+ "attestation expiry"
145
+ ],
146
+ "conflictRules": [
147
+ "hash drift disputes Protected Standards currency"
148
+ ],
149
+ "impactLevel": "high"
150
+ },
151
+ {
152
+ "id": "veritas.evidence-check",
153
+ "claimType": "software-evidence-check",
154
+ "requiredEvidence": [
155
+ "test_output"
156
+ ],
157
+ "requiredMethods": [
158
+ "validation"
159
+ ],
160
+ "requiresCorroboration": false,
161
+ "acceptanceCriteria": [
162
+ "selected evidenceCheck command"
163
+ ],
164
+ "reviewAuthority": "veritas",
165
+ "validityRule": {
166
+ "kind": "commit"
167
+ },
168
+ "stalenessTriggers": [
169
+ "source_ref changes",
170
+ "evidenceCheck command changes",
171
+ "baseline evidenceCheck fails"
172
+ ],
173
+ "conflictRules": [
174
+ "failed evidenceCheck rejects a previously verified evidenceCheck claim"
175
+ ],
176
+ "impactLevel": "high"
177
+ }
178
+ ]
179
+ }
@@ -11,6 +11,12 @@ CLI invocation plus a small kit-local trust.bundle adapter. It does **not** fork
11
11
  reimplement Veritas's Repo Standards / evidence-check evaluation — Veritas evaluates; the kit
12
12
  only projects Veritas's own recorded verdict into the Flow trust.bundle vocabulary.
13
13
 
14
+ The engine/surface line this kit builds on — which veritas capabilities stay an importable
15
+ evaluation-engine library and which product surface moves into this kit (the thick-kit
16
+ migration, [#646](https://github.com/kontourai/flow-agents/issues/646)–652) — is ratified in
17
+ veritas's [Engine / Surface Seam](https://github.com/kontourai/veritas/blob/main/docs/architecture/engine-surface-seam.md)
18
+ doc, which also freezes the CLI + artifact + claim-shape contract this kit's adapter consumes.
19
+
14
20
  ## What it contains
15
21
 
16
22
  | Asset | Path | Purpose |
@@ -20,6 +26,11 @@ only projects Veritas's own recorded verdict into the Flow trust.bundle vocabula
20
26
  | Fixtures | `fixtures/readiness/*.readiness-report.json` | Captured **real** Veritas readiness reports (a ready clean tree, and a not-ready tree with a required CLI artifact deleted) used by the eval. |
21
27
  | Flow | `flows/exemption-issuance.flow.json` | Single-gate agentless flow `request -> human-approval-gate -> issue`. The gate requires a **verified** `no-agent-delivery-exemption-approval` trust.bundle claim (`subjectType: "delivery-scope"`) before the `issue` step's write is flow-sanctioned. Issues a `delivery/DECLARED` exemption entry per ADR 0022 §2/§3. |
22
28
  | Skill | `skills/exemption-usage-review/SKILL.md` | Periodic audit skill (ADR 0022 §3): walks `delivery/DECLARED` + its `git log --follow` history and reports every standing exemption (scope, reason, approver, age since `declared_at`), flagging entries overdue for owner re-confirmation against a configurable staleness threshold. Process visibility, not enforcement — read-only, never mutates `delivery/DECLARED` or the reconciler. |
29
+ | Provisions | `assets/starter-standards/**` → `provisions[]` | Starter `.veritas/` Repo Standards a consumer repo needs to run `veritas readiness` — a faithful snapshot of `veritas init`'s Day-0 output (Repo Map, Repo Standards, authority settings, `GOVERNANCE.md`, `README.md`, claim store), shipped as data and copied verbatim by `flow-agents kit provision`. See "Scaffolding starter standards" below. |
30
+ | Provisions | `assets/starter-hooks/githooks/**` → `provisions[]` | The two governance git hooks (`veritas setup repo-hooks`'s static output): `.githooks/pre-push` (`npm run --if-present prepush`) and `.githooks/post-commit` (`veritas readiness`). Shipped verbatim; landed non-executable — activation (`chmod +x` + `git config core.hooksPath`) is a documented operator step a copy cannot perform. See "Provisioning the governance hooks". |
31
+ | Flow | `flows/standards-authoring.flow.json` | Single-gate agentless flow `propose -> human-approval-gate -> apply`. The gate requires a **verified** `standards-authoring-approval` trust.bundle claim (`subjectType: "repo-governance-change"`) before `veritas init --apply` writes the derived standards. Veritas derives and writes; the kit gates the human sign-off. See "How to author standards for a repo". |
32
+ | Skill | `skills/standards-authoring/SKILL.md` | Runbook for the standards-authoring flow: runs `veritas init --explore`/`--guided` to derive a recommendation (project name, adaptive Repo Map nodes, evidence-check inference, governance-block splice), surfaces it for human approval, then `veritas init --apply`. Wraps the veritas CLI; reimplements nothing. |
33
+ | Skill | `skills/consult-standards/SKILL.md` | Just-in-time governance guidance before editing: tells an agent to run `veritas explain --file <path>` (or `--work-area <id>`) to see the governance excerpt, applicable Repo Standards rules (do/don't/examples), and latest surface status, then edit within them. Pull-based advisory — does not block (the PreToolUse hook is enforcement). No MCP server. See "Consulting standards just in time". |
23
34
 
24
35
  The gate uses provider-neutral Flow vocabulary (`kind: "trust.bundle"`, `bundle_claim`) — the
25
36
  same vocabulary `kits/builder/flows/build.flow.json` uses. Veritas is simply the producer that
@@ -46,6 +57,118 @@ flow evaluate readiness --gate gate-check-gate --exit-code
46
57
  # exit 0 when readiness is ready (claim verified); exit 1 (block) otherwise.
47
58
  ```
48
59
 
60
+ ## Scaffolding starter standards
61
+
62
+ A repo needs a `.veritas/` Repo Standards set before `veritas readiness` can evaluate it. For kit
63
+ users this replaces standalone `veritas init`: the kit declares that starter set as `provisions[]`
64
+ in `kit.json`, and the engine copies it into the repo.
65
+
66
+ ```bash
67
+ # Copy the starter .veritas/ standards into the current repo (create-only; never overwrites).
68
+ flow-agents kit provision veritas-governance
69
+ # -> .veritas/repo-map.json, .veritas/repo-standards/default.repo-standards.json,
70
+ # .veritas/authority/default.authority-settings.json, .veritas/GOVERNANCE.md,
71
+ # .veritas/README.md, veritas.claims.json
72
+ # (flow-agents init --activate-kit veritas-governance provisions the same set at adoption time.)
73
+
74
+ # Then run readiness against the scaffolded repo.
75
+ veritas readiness --working-tree # 0 failures on the fresh starter
76
+ ```
77
+
78
+ The provisioned files are a **faithful snapshot of `veritas init`'s Day-0 output** — data the kit
79
+ copies verbatim, not evaluation logic it reimplements. The project name is a `your-project`
80
+ placeholder; edit the Repo Map's work-area graph and `evidence.evidenceChecks[0].command` for your
81
+ repo, then regenerate the claim store with `veritas claim init`.
82
+
83
+ **Beyond the static starter:** the per-repo *derivation* `veritas init` performs (project-name
84
+ slug, repo-shape-adaptive Repo Map nodes, evidence-check inference) and the *splice* of the
85
+ governance block into an existing `AGENTS.md`/`CLAUDE.md` (a create-only copy cannot edit files in
86
+ place — the starter's `ai-instruction-files-synced` standard reports advisory until those blocks
87
+ are wired) are handled by the **standards-authoring flow** below; repo-hook setup remains #648.
88
+
89
+ ## How to author standards for a repo
90
+
91
+ Beyond the static starter set, the kit's `standards-authoring` flow drives Veritas's *adaptive*
92
+ authoring — deriving the project name, repo-shape Repo Map nodes, and evidence-check command from
93
+ the actual repo, and splicing the governance block into existing `AGENTS.md`/`CLAUDE.md` (the
94
+ per-repo work a verbatim provision copy cannot do). The `standards-authoring` **skill**
95
+ (`skills/standards-authoring/SKILL.md`) is the operator's runbook; **Veritas does the derivation
96
+ and the write — the kit only gates the human sign-off.**
97
+
98
+ ```bash
99
+ # 1. PROPOSE — derive a recommendation (writes nothing under .veritas/ yet).
100
+ veritas init --explore # or: veritas init --guided --answers <answers.json>
101
+
102
+ # 2. APPROVE — a human reviews the recommendation, then authors a Hachure trust.bundle asserting
103
+ # a standards-authoring-approval / repo-governance-change claim with status verified.
104
+ flow init
105
+ flow start kits/veritas-governance/flows/standards-authoring.flow.json --run-id authoring
106
+ flow attach-evidence authoring --gate human-approval-gate --file approval.bundle --bundle
107
+ flow evaluate authoring --gate human-approval-gate --exit-code
108
+ # exit 0 once the approval claim is verified; exit 1 (block) otherwise.
109
+
110
+ # 3. APPLY — only after the gate passes, write the approved standards (hash-verified;
111
+ # refuses to overwrite existing standards without --force).
112
+ veritas init --apply --plan <path-to-recommendation-artifact>
113
+ ```
114
+
115
+ Like `exemption-issuance`'s gate, "human-approved" here is an **operating convention** the claim
116
+ encodes, not a structural human-only guarantee — see "Human-approval evidence: what is and is not
117
+ enforced" below. This flow is **agentless** (the kit declares no `flow_step_actions`; the approval
118
+ bundle is human-authored out of band, and the skill is the runbook, not a step-bound action). The
119
+ kit **wraps** the `veritas` CLI and reimplements no derivation or evaluation.
120
+
121
+ ## Provisioning the governance hooks
122
+
123
+ The kit ships the two governance git hooks (`veritas setup repo-hooks`'s static output) as
124
+ `provisions[]`, so kit adoption drops them into the repo alongside the starter standards:
125
+
126
+ - `.githooks/pre-push` — runs `npm run --if-present prepush` before a push.
127
+ - `.githooks/post-commit` — runs `veritas readiness --changed-from HEAD~1 --changed-to HEAD` after each commit.
128
+
129
+ ```bash
130
+ # 1. Land the hook files (part of `kit provision` / `init --activate-kit`).
131
+ flow-agents kit provision veritas-governance
132
+
133
+ # 2. ACTIVATE — the two steps a create-only file copy cannot perform:
134
+ chmod +x .githooks/pre-push .githooks/post-commit
135
+ git config core.hooksPath .githooks
136
+ ```
137
+
138
+ **Activation is required and is not a copy.** A provision lands the hook files **non-executable**
139
+ and does not touch git config — so until you `chmod +x` them and point `core.hooksPath` at
140
+ `.githooks`, git will not run them. This is the same class of limitation as the governance-block
141
+ splice above: the engine's file copy is deliberately agent-blind (it never sets an executable bit
142
+ or mutates git config), so making the hooks *active* is an explicit operator step. The hooks
143
+ themselves only **invoke** the `veritas` CLI (`npm run prepush`, `veritas readiness`); the kit
144
+ reimplements no evaluation, and the live per-edit PreToolUse *evaluation* entry point stays in the
145
+ engine (`evaluatePreToolUse` → `evaluateRepoStandards`), reached by the installed hook shelling
146
+ into `veritas` — hook wiring is the kit's; per-edit evaluation is the engine's.
147
+
148
+ ## Consulting standards just in time
149
+
150
+ The `consult-standards` skill (`skills/consult-standards/SKILL.md`) gives an agent just-in-time
151
+ governance guidance **before** it edits a file, so it shapes the change to pass rather than
152
+ learning about a violation only when the PreToolUse hook blocks the write:
153
+
154
+ ```bash
155
+ veritas explain --file src/path/to/file.ts # rules that apply to this file
156
+ veritas explain --work-area <work-area-id> # rules for a whole Repo Map work area
157
+ ```
158
+
159
+ `veritas explain` prints a **`Veritas JIT Context`** briefing — the `.veritas/GOVERNANCE.md`
160
+ excerpt, one block per matching Repo Standard (`Rule`/`Kind`/`Enforcement Level`/`Summary`/
161
+ `Do`/`Do not`/`Good`/`Bad`/`Context`), and the latest recorded surface status for each. The skill
162
+ is **pull-based advisory**: it never blocks (enforcement stays the engine-side PreToolUse hook)
163
+ and reimplements no rule evaluation — `veritas explain` does the matching and projection.
164
+
165
+ **No MCP server.** Just-in-time guidance here is an agent invoking `veritas explain`, not a
166
+ standing MCP service. Per the flow-agents MCP posture (ADR 0011), MCP never carries the gate and
167
+ enforcement stays hooks; this skill is the deliberate agent-pull replacement for a guidance
168
+ server — the veritas-owned MCP guidance server the migration once imagined was never actually
169
+ built (the `@modelcontextprotocol/sdk` dependency in veritas is only the evidence-check *client*),
170
+ so this slice builds the guidance path new in the kit rather than moving one.
171
+
49
172
  ## How to issue a no-agent-delivery exemption
50
173
 
51
174
  `flows/exemption-issuance.flow.json` (ADR 0022 §3, "the kit issues, the anchor enforces") gives
@@ -156,13 +279,17 @@ verdict derives `verified` → the gate **passes**.
156
279
 
157
280
  This matches Veritas's own `readinessHasBlockingFailure` helper (`veritas/src/surface/readiness.mjs`)
158
281
  and Surface's weakest-link claim derivation (`buildTrustReport` downgrades a readiness claim to
159
- `rejected` on any rejected Require). The adapter intentionally does **not** apply Veritas's
160
- `promotion_allowed` short-circuit — `promotion_allowed` is a workstream-routing hint (set by
161
- file-pattern lane resolution in `src/repo/routing.mjs`), not a safety signal, and applying it as
162
- one lets a record with blocking Require failures read as ready. That short-circuit is a filed
163
- Veritas bug, [kontourai/veritas#106](https://github.com/kontourai/veritas/issues/106), not a
164
- legitimate alternate reading. Investigation conclusion: the adapter's stricter blocking-failure
165
- derivation is correct today and will agree with Veritas's own exported functions once #106 lands.
282
+ `rejected` on any rejected Require). The adapter does **not** apply Veritas's `promotion_allowed`
283
+ short-circuit as a safety signal — `promotion_allowed` is a workstream-routing hint (set by
284
+ file-pattern lane resolution in `src/repo/routing.mjs`) and cannot account for blocking failures.
285
+ The historical divergence this guarded against,
286
+ [kontourai/veritas#106](https://github.com/kontourai/veritas/issues/106) (Veritas's exported
287
+ verdict functions honored `promotion_allowed` before checking blocking failures), is **fixed**:
288
+ `readinessVerdict`/`readinessSurfaceStatus` now check `readinessHasBlockingFailure()` first
289
+ (regression-tested in veritas `tests/surface/readiness-verdict.test.mjs`), so the adapter's
290
+ derivation and Veritas's exported functions agree. The adapter keeps its own derivation because
291
+ kit code consumes Veritas's recorded artifact, not Veritas's library exports — that
292
+ blocking-failure semantics is now frozen in veritas's Engine / Surface Seam doc (see above).
166
293
 
167
294
  ## Trust status
168
295
 
@@ -172,9 +299,13 @@ to a later slice (see the WS5 shaping's open decisions).
172
299
 
173
300
  ## Not in slice 1
174
301
 
175
- Skills `consult-standards` and `governance-evidence`, the fuller `merge-readiness` flow, the
176
- `standards-authoring` flow, and the `knowledge` dependency are later slices — see the WS5
177
- backlog. `exemption-usage-review` (ADR 0022 §3's periodic audit skill, walking
302
+ Skills `consult-standards` and `governance-evidence`, the fuller `merge-readiness` flow, and the
303
+ `knowledge` dependency are later slices — see the WS5 backlog. The **starter-standards scaffold**
304
+ (`veritas init`'s Day-0 `.veritas/` set) **has now shipped** as `provisions[]` (see "Scaffolding
305
+ starter standards"), and the **`standards-authoring` flow** that covers the per-repo derivation
306
+ and governance-block splice a static copy cannot **has now shipped** too (see "How to author
307
+ standards for a repo") — both #647 Slice 2; repo-hook setup remains #648.
308
+ `exemption-usage-review` (ADR 0022 §3's periodic audit skill, walking
178
309
  `delivery/DECLARED` history and surfacing standing exemptions for owner re-confirmation —
179
310
  process visibility, not enforcement) **has now shipped** — see "What it contains" above and
180
311
  "How to run the review". Nothing schedules it automatically; an operator runs it periodically
@@ -0,0 +1,74 @@
1
+ {
2
+ "schemaVersion": 5,
3
+ "source": "veritas-governance-kit/standards-authoring-fixture",
4
+ "claims": [
5
+ {
6
+ "id": "standards-authoring-fixture.standards-authoring-approval.your-project",
7
+ "subjectType": "repo-governance-change",
8
+ "subjectId": "repo:your-project",
9
+ "facet": "veritas-governance.standards-authoring",
10
+ "claimType": "standards-authoring-approval",
11
+ "fieldOrBehavior": "standardsAuthoringApproval",
12
+ "value": {
13
+ "recommendation": "veritas init --explore recommendation for your-project",
14
+ "reason": "human maintainer reviewed the derived starter standards and approved writing them",
15
+ "approved_by": "eval-fixture-approver"
16
+ },
17
+ "createdAt": "2026-07-01T00:00:00Z",
18
+ "updatedAt": "2026-07-01T00:00:00Z",
19
+ "impactLevel": "high",
20
+ "verificationPolicyId": "policy:standards-authoring-approval",
21
+ "metadata": {
22
+ "producer": "human-approver",
23
+ "source": "standards-authoring-fixture"
24
+ },
25
+ "status": "verified"
26
+ }
27
+ ],
28
+ "evidence": [
29
+ {
30
+ "id": "ev:standards-authoring-fixture.standards-authoring-approval.your-project",
31
+ "claimId": "standards-authoring-fixture.standards-authoring-approval.your-project",
32
+ "evidenceType": "policy_rule",
33
+ "method": "auditability",
34
+ "sourceRef": "human-approver:standards-authoring-fixture",
35
+ "excerptOrSummary": "A human maintainer reviewed the veritas init recommendation and approved authoring the Repo Standards for your-project.",
36
+ "observedAt": "2026-07-01T00:00:00Z",
37
+ "collectedBy": "veritas-governance-kit/standards-authoring-fixture",
38
+ "passing": true
39
+ }
40
+ ],
41
+ "events": [
42
+ {
43
+ "id": "evt:standards-authoring-fixture.standards-authoring-approval.your-project",
44
+ "claimId": "standards-authoring-fixture.standards-authoring-approval.your-project",
45
+ "status": "verified",
46
+ "actor": "veritas-governance-kit/standards-authoring-fixture",
47
+ "method": "auditability",
48
+ "evidenceIds": [
49
+ "ev:standards-authoring-fixture.standards-authoring-approval.your-project"
50
+ ],
51
+ "createdAt": "2026-07-01T00:00:00Z",
52
+ "verifiedAt": "2026-07-01T00:00:00Z"
53
+ }
54
+ ],
55
+ "policies": [
56
+ {
57
+ "id": "policy:standards-authoring-approval",
58
+ "claimType": "standards-authoring-approval",
59
+ "requiredEvidence": [
60
+ "policy_rule"
61
+ ],
62
+ "acceptanceCriteria": [
63
+ "A human maintainer has reviewed the veritas init recommendation and approved authoring the Repo Standards."
64
+ ],
65
+ "reviewAuthority": "human",
66
+ "validityRule": {
67
+ "kind": "manual"
68
+ },
69
+ "stalenessTriggers": [],
70
+ "conflictRules": [],
71
+ "impactLevel": "high"
72
+ }
73
+ ]
74
+ }