@kontourai/flow-agents 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (418) hide show
  1. package/.githooks/pre-push +11 -0
  2. package/.github/workflows/ci.yml +210 -0
  3. package/.github/workflows/docs-pages.yml +52 -0
  4. package/.github/workflows/publish-npm.yml +104 -0
  5. package/AGENTS.md +26 -0
  6. package/CHANGELOG.md +66 -0
  7. package/CODE_OF_CONDUCT.md +25 -0
  8. package/CONTEXT.md +300 -0
  9. package/CONTRIBUTING.md +44 -0
  10. package/LICENSE +201 -0
  11. package/README.md +129 -0
  12. package/SECURITY.md +33 -0
  13. package/agent-cards/dev.json +19 -0
  14. package/agents/dev.json +127 -0
  15. package/agents/tool-code-reviewer.json +61 -0
  16. package/agents/tool-dependencies-updater.json +118 -0
  17. package/agents/tool-explore-config.json +92 -0
  18. package/agents/tool-explore-deps.json +92 -0
  19. package/agents/tool-explore-entry.json +92 -0
  20. package/agents/tool-explore-patterns.json +92 -0
  21. package/agents/tool-explore-structure.json +92 -0
  22. package/agents/tool-explore-tests.json +92 -0
  23. package/agents/tool-planner.json +57 -0
  24. package/agents/tool-playwright.json +145 -0
  25. package/agents/tool-security-reviewer.json +56 -0
  26. package/agents/tool-verifier.json +61 -0
  27. package/agents/tool-worker.json +58 -0
  28. package/build/src/cli/console-learning-projection.js +123 -0
  29. package/build/src/cli/docs-preview.js +39 -0
  30. package/build/src/cli/effective-backlog-settings.js +102 -0
  31. package/build/src/cli/export-bookmarks.js +38 -0
  32. package/build/src/cli/fixture-retirement-audit.js +140 -0
  33. package/build/src/cli/flow-kit.js +138 -0
  34. package/build/src/cli/import-bookmarks.js +50 -0
  35. package/build/src/cli/init.js +239 -0
  36. package/build/src/cli/instinct-cli.js +93 -0
  37. package/build/src/cli/promote-workflow-artifact.js +63 -0
  38. package/build/src/cli/publish-change-helper.js +154 -0
  39. package/build/src/cli/pull-work-provider.js +469 -0
  40. package/build/src/cli/runtime-adapter.js +23 -0
  41. package/build/src/cli/telemetry-doctor.js +221 -0
  42. package/build/src/cli/usage-feedback.js +443 -0
  43. package/build/src/cli/validate-hook-influence.js +152 -0
  44. package/build/src/cli/validate-source-tree.js +31 -0
  45. package/build/src/cli/validate-workflow-artifacts.js +486 -0
  46. package/build/src/cli/veritas-governance.js +262 -0
  47. package/build/src/cli/workflow-artifact-cleanup-audit.js +272 -0
  48. package/build/src/cli/workflow-sidecar.js +816 -0
  49. package/build/src/cli.js +89 -0
  50. package/build/src/flow-kit/validate.js +75 -0
  51. package/build/src/lib/args.js +45 -0
  52. package/build/src/lib/fs.js +62 -0
  53. package/build/src/lib/workflow-learning-projection.js +334 -0
  54. package/build/src/runtime-adapters.js +146 -0
  55. package/build/src/tools/build-universal-bundles.js +397 -0
  56. package/build/src/tools/common.js +56 -0
  57. package/build/src/tools/filter-installed-packs.js +132 -0
  58. package/build/src/tools/generate-context-map.js +198 -0
  59. package/build/src/tools/validate-package.js +64 -0
  60. package/build/src/tools/validate-source-tree.js +622 -0
  61. package/console.telemetry.json +176 -0
  62. package/context/base-rules.md +17 -0
  63. package/context/code-review-standards.md +62 -0
  64. package/context/coding-standards.md +42 -0
  65. package/context/common/orchestrators.md +12 -0
  66. package/context/common/subagents.md +28 -0
  67. package/context/contracts/artifact-contract.md +182 -0
  68. package/context/contracts/builder-kit-workflow-state-contract.md +319 -0
  69. package/context/contracts/delivery-contract.md +69 -0
  70. package/context/contracts/execution-contract.md +53 -0
  71. package/context/contracts/governance-adapter-contract.md +67 -0
  72. package/context/contracts/planning-contract.md +85 -0
  73. package/context/contracts/review-contract.md +104 -0
  74. package/context/contracts/sandbox-policy.md +52 -0
  75. package/context/contracts/verification-contract.md +134 -0
  76. package/context/contracts/work-item-contract.md +215 -0
  77. package/context/deferred/demo-mode.md +33 -0
  78. package/context/deferred/languages/go.md +31 -0
  79. package/context/deferred/languages/python.md +31 -0
  80. package/context/deferred/languages/typescript.md +34 -0
  81. package/context/deferred/parallelization.md +35 -0
  82. package/context/deferred/worktree-isolation.md +24 -0
  83. package/context/development-workflow.md +50 -0
  84. package/context/scripts/context-budget/budget-scan.sh +166 -0
  85. package/context/scripts/detect-tools.sh +3 -0
  86. package/context/scripts/discover-agents.sh +28 -0
  87. package/context/scripts/git-status.sh +49 -0
  88. package/context/scripts/hooks/config-protection.js +79 -0
  89. package/context/scripts/hooks/desktop-notify.sh +39 -0
  90. package/context/scripts/hooks/governance-audit.sh +135 -0
  91. package/context/scripts/hooks/lib/audit-transport.sh +40 -0
  92. package/context/scripts/hooks/lib/hook-flags.js +49 -0
  93. package/context/scripts/hooks/lib/patterns.sh +57 -0
  94. package/context/scripts/hooks/lib/resolve-formatter.js +80 -0
  95. package/context/scripts/hooks/post-edit-accumulator.js +66 -0
  96. package/context/scripts/hooks/pre-commit-quality.js +194 -0
  97. package/context/scripts/hooks/quality-gate.js +93 -0
  98. package/context/scripts/hooks/report-only-guard.js +21 -0
  99. package/context/scripts/hooks/run-hook.js +136 -0
  100. package/context/scripts/hooks/stop-format-typecheck.js +141 -0
  101. package/context/scripts/hooks/stop-goal-fit.js +337 -0
  102. package/context/scripts/hooks/workflow-steering.js +250 -0
  103. package/context/scripts/telemetry/console-presets.sh +14 -0
  104. package/context/scripts/telemetry/install-console-config.sh +214 -0
  105. package/context/scripts/telemetry/lib/config.sh +85 -0
  106. package/context/scripts/telemetry/lib/enrich.sh +115 -0
  107. package/context/scripts/telemetry/lib/redact.sh +22 -0
  108. package/context/scripts/telemetry/lib/session.sh +63 -0
  109. package/context/scripts/telemetry/lib/transport.sh +183 -0
  110. package/context/scripts/telemetry/lib/usage.sh +29 -0
  111. package/context/scripts/telemetry/sync-agents.sh +173 -0
  112. package/context/scripts/telemetry/telemetry.conf +23 -0
  113. package/context/scripts/telemetry/telemetry.sh +387 -0
  114. package/context/scripts/validate-package.sh +89 -0
  115. package/context/settings/backlog-provider-settings.json +54 -0
  116. package/context/templates/core/identity.md +26 -0
  117. package/context/templates/core/user.md +15 -0
  118. package/docs/_config.yml +15 -0
  119. package/docs/_layouts/default.html +87 -0
  120. package/docs/adr/0001-flow-agents-consumes-flow.md +77 -0
  121. package/docs/adr/0002-flow-kits-as-extension-unit.md +13 -0
  122. package/docs/adr/0003-flow-agents-coordinates-kits-and-adapters.md +13 -0
  123. package/docs/adr/0004-gates-expect-surface-claims.md +15 -0
  124. package/docs/adr/0005-kubernetes-inspired-resource-contracts.md +48 -0
  125. package/docs/adr/0006-typescript-first-source-policy.md +98 -0
  126. package/docs/agent-system-guidebook.md +391 -0
  127. package/docs/agent-usage-feedback-loop.md +351 -0
  128. package/docs/assets/favicon.svg +13 -0
  129. package/docs/assets/og-image.png +0 -0
  130. package/docs/assets/site.css +774 -0
  131. package/docs/assets/site.js +139 -0
  132. package/docs/configurable-workflow-routing.md +174 -0
  133. package/docs/context-map.md +145 -0
  134. package/docs/developer-architecture.md +145 -0
  135. package/docs/developer-hook-setup.md +61 -0
  136. package/docs/fixture-ownership.md +44 -0
  137. package/docs/flow-kit-repository-contract.md +180 -0
  138. package/docs/index.md +129 -0
  139. package/docs/kontour-resource-contract.md +358 -0
  140. package/docs/migrations.md +64 -0
  141. package/docs/north-star.md +322 -0
  142. package/docs/operating-layers.md +110 -0
  143. package/docs/repository-structure.md +132 -0
  144. package/docs/sandbox-policy.md +56 -0
  145. package/docs/skills-map.md +203 -0
  146. package/docs/standards-register.md +96 -0
  147. package/docs/veritas-integration.md +165 -0
  148. package/docs/work-item-adapters.md +72 -0
  149. package/docs/workflow-artifact-lifecycle.md +141 -0
  150. package/docs/workflow-eval-strategy.md +295 -0
  151. package/docs/workflow-shared-contracts.md +51 -0
  152. package/docs/workflow-usage-guide.md +443 -0
  153. package/evals/ARCHITECTURE.md +143 -0
  154. package/evals/CONVENTIONS.md +58 -0
  155. package/evals/README.md +128 -0
  156. package/evals/acceptance/run.sh +29 -0
  157. package/evals/acceptance/test_claude_harness.sh +242 -0
  158. package/evals/acceptance/test_codex_harness.sh +108 -0
  159. package/evals/acceptance/test_kiro_harness.sh +128 -0
  160. package/evals/cases/dev/404.html +97 -0
  161. package/evals/cases/dev/code-review.yaml +44 -0
  162. package/evals/cases/dev/dashboard.html +300 -0
  163. package/evals/cases/dev/deliver.yaml +66 -0
  164. package/evals/cases/dev/dependency-update.yaml +16 -0
  165. package/evals/cases/dev/explore.yaml +20 -0
  166. package/evals/cases/dev/index.html +370 -0
  167. package/evals/cases/dev/package-lock.json +28 -0
  168. package/evals/cases/dev/package.json +16 -0
  169. package/evals/cases/dev/plan-work.yaml +20 -0
  170. package/evals/cases/dev/promptfooconfig.yaml +666 -0
  171. package/evals/cases/dev/search-first.yaml +20 -0
  172. package/evals/cases/dev/tdd-workflow.yaml +48 -0
  173. package/evals/cases/dev/verify-work.yaml +44 -0
  174. package/evals/cases/dev/workflow.yaml +34 -0
  175. package/evals/ci/run-baseline.sh +283 -0
  176. package/evals/fixtures/backlog-provider-settings/global-default.json +44 -0
  177. package/evals/fixtures/backlog-provider-settings/project-override.json +53 -0
  178. package/evals/fixtures/builder-kit-workflow-state/baseline-freshness-resolution-hint.json +139 -0
  179. package/evals/fixtures/builder-kit-workflow-state/direct-primitive-stop.json +59 -0
  180. package/evals/fixtures/builder-kit-workflow-state/empty-board-route-shape.json +55 -0
  181. package/evals/fixtures/builder-kit-workflow-state/happy-path.json +71 -0
  182. package/evals/fixtures/builder-kit-workflow-state/mid-work-resume.json +80 -0
  183. package/evals/fixtures/builder-kit-workflow-state/missing-prestep-recovery.json +65 -0
  184. package/evals/fixtures/builder-kit-workflow-state/product-build-chaining.json +60 -0
  185. package/evals/fixtures/builder-kit-workflow-state/stale-continuation-requires-new-probe.json +57 -0
  186. package/evals/fixtures/console-learning-projection/artifacts/console-learning-correction/learning.json +50 -0
  187. package/evals/fixtures/console-learning-projection/artifacts/console-learning-open-route/learning.json +41 -0
  188. package/evals/fixtures/flow-kit-repository/invalid-absolute-path/kit.json +8 -0
  189. package/evals/fixtures/flow-kit-repository/invalid-asset-section/flows/review.flow.json +6 -0
  190. package/evals/fixtures/flow-kit-repository/invalid-asset-section/kit.json +11 -0
  191. package/evals/fixtures/flow-kit-repository/invalid-duplicate-flow/flows/review.flow.json +6 -0
  192. package/evals/fixtures/flow-kit-repository/invalid-duplicate-flow/kit.json +9 -0
  193. package/evals/fixtures/flow-kit-repository/invalid-id/flows/review.flow.json +6 -0
  194. package/evals/fixtures/flow-kit-repository/invalid-id/kit.json +8 -0
  195. package/evals/fixtures/flow-kit-repository/invalid-malformed-json/kit.json +8 -0
  196. package/evals/fixtures/flow-kit-repository/invalid-missing-flow/kit.json +8 -0
  197. package/evals/fixtures/flow-kit-repository/invalid-missing-id/flows/review.flow.json +6 -0
  198. package/evals/fixtures/flow-kit-repository/invalid-missing-id/kit.json +7 -0
  199. package/evals/fixtures/flow-kit-repository/invalid-missing-schema-version/flows/review.flow.json +6 -0
  200. package/evals/fixtures/flow-kit-repository/invalid-missing-schema-version/kit.json +7 -0
  201. package/evals/fixtures/flow-kit-repository/invalid-name/flows/review.flow.json +6 -0
  202. package/evals/fixtures/flow-kit-repository/invalid-name/kit.json +8 -0
  203. package/evals/fixtures/flow-kit-repository/invalid-schema-version/flows/review.flow.json +6 -0
  204. package/evals/fixtures/flow-kit-repository/invalid-schema-version/kit.json +8 -0
  205. package/evals/fixtures/flow-kit-repository/invalid-traversal/kit.json +8 -0
  206. package/evals/fixtures/flow-kit-repository/mixed-runtime-kit/adapters/example.json +3 -0
  207. package/evals/fixtures/flow-kit-repository/mixed-runtime-kit/assets/example.txt +1 -0
  208. package/evals/fixtures/flow-kit-repository/mixed-runtime-kit/docs/README.md +3 -0
  209. package/evals/fixtures/flow-kit-repository/mixed-runtime-kit/flows/runtime.flow.json +26 -0
  210. package/evals/fixtures/flow-kit-repository/mixed-runtime-kit/kit-evals/example.json +3 -0
  211. package/evals/fixtures/flow-kit-repository/mixed-runtime-kit/kit-skills/mixed/SKILL.md +3 -0
  212. package/evals/fixtures/flow-kit-repository/mixed-runtime-kit/kit.json +44 -0
  213. package/evals/fixtures/flow-kit-repository/valid-local-kit/docs/README.md +3 -0
  214. package/evals/fixtures/flow-kit-repository/valid-local-kit/flows/review.flow.json +26 -0
  215. package/evals/fixtures/flow-kit-repository/valid-local-kit/kit.json +20 -0
  216. package/evals/fixtures/hook-influence/cases.json +336 -0
  217. package/evals/fixtures/pull-work-provider/github-issues.json +170 -0
  218. package/evals/fixtures/pull-work-wip-shepherding/global-wip-informs.json +43 -0
  219. package/evals/fixtures/pull-work-wip-shepherding/personal-wip-blocks.json +42 -0
  220. package/evals/fixtures/surface-trust/accepted-claim-trust-report.json +31 -0
  221. package/evals/fixtures/surface-trust/artifact-absent.json +19 -0
  222. package/evals/fixtures/surface-trust/integrity-mismatch-trust-report.json +32 -0
  223. package/evals/fixtures/surface-trust/missing-authority-trust-report.json +27 -0
  224. package/evals/fixtures/surface-trust/provider-absent.json +19 -0
  225. package/evals/fixtures/surface-trust/rejected-claim-trust-report.json +30 -0
  226. package/evals/fixtures/surface-trust/stale-claim-trust-snapshot.json +31 -0
  227. package/evals/fixtures/usage-feedback/sample-full.jsonl +11 -0
  228. package/evals/fixtures/usage-feedback/sample-outcomes.jsonl +1 -0
  229. package/evals/fixtures/veritas-governance-adapter/fake-veritas-pass.sh +18 -0
  230. package/evals/fixtures/veritas-governance-adapter/fake-veritas-secret-fail.sh +10 -0
  231. package/evals/fixtures/veritas-governance-adapter/fake-veritas-unconfigured.sh +4 -0
  232. package/evals/integration/test_bundle_install.sh +541 -0
  233. package/evals/integration/test_console_learning_projection.sh +192 -0
  234. package/evals/integration/test_context_map.sh +65 -0
  235. package/evals/integration/test_effective_backlog_settings.sh +58 -0
  236. package/evals/integration/test_fixture_retirement_audit.sh +58 -0
  237. package/evals/integration/test_flow_agents_statusline.sh +93 -0
  238. package/evals/integration/test_flow_kit_repository.sh +90 -0
  239. package/evals/integration/test_goal_fit_hook.sh +482 -0
  240. package/evals/integration/test_hook_category_behaviors.sh +190 -0
  241. package/evals/integration/test_hook_influence_cases.sh +69 -0
  242. package/evals/integration/test_local_flow_kit_install.sh +145 -0
  243. package/evals/integration/test_publish_change_helper.sh +176 -0
  244. package/evals/integration/test_pull_work_provider.sh +140 -0
  245. package/evals/integration/test_runtime_adapter_activation.sh +106 -0
  246. package/evals/integration/test_telemetry.sh +485 -0
  247. package/evals/integration/test_telemetry_doctor.sh +193 -0
  248. package/evals/integration/test_usage_feedback_dashboard.sh +169 -0
  249. package/evals/integration/test_usage_feedback_global.sh +117 -0
  250. package/evals/integration/test_usage_feedback_import.sh +227 -0
  251. package/evals/integration/test_usage_feedback_outcomes.sh +165 -0
  252. package/evals/integration/test_usage_feedback_report.sh +263 -0
  253. package/evals/integration/test_veritas_governance_adapter.sh +235 -0
  254. package/evals/integration/test_workflow_artifact_cleanup_audit.sh +287 -0
  255. package/evals/integration/test_workflow_artifacts.sh +1247 -0
  256. package/evals/integration/test_workflow_sidecar_writer.sh +2112 -0
  257. package/evals/integration/test_workflow_steering_hook.sh +337 -0
  258. package/evals/lib/assertions/delegated-to.js +40 -0
  259. package/evals/lib/assertions/max-tool-calls.js +15 -0
  260. package/evals/lib/assertions/no-write-tools.js +27 -0
  261. package/evals/lib/assertions/pass-at-k.js +39 -0
  262. package/evals/lib/assertions/telemetry-utils.js +105 -0
  263. package/evals/lib/assertions/tool-called.js +39 -0
  264. package/evals/lib/assertions/verify-after-fix.js +61 -0
  265. package/evals/lib/claude-judge.sh +40 -0
  266. package/evals/lib/claude-provider.sh +74 -0
  267. package/evals/lib/codex-judge.sh +39 -0
  268. package/evals/lib/codex-provider.sh +81 -0
  269. package/evals/lib/eval-dev.sh +5 -0
  270. package/evals/lib/eval-judge.sh +22 -0
  271. package/evals/lib/eval-provider.sh +26 -0
  272. package/evals/lib/eval-report.sh +73 -0
  273. package/evals/lib/kiro-dev.sh +4 -0
  274. package/evals/lib/kiro-judge.sh +17 -0
  275. package/evals/lib/kiro-provider.sh +62 -0
  276. package/evals/lib/node.sh +111 -0
  277. package/evals/promptfooconfig.yaml +70 -0
  278. package/evals/run.sh +309 -0
  279. package/evals/static/test_evidence_refs.sh +141 -0
  280. package/evals/static/test_package.sh +407 -0
  281. package/evals/static/test_repo_hooks.sh +68 -0
  282. package/evals/static/test_universal_bundles.sh +274 -0
  283. package/evals/static/test_workflow_skills.sh +1207 -0
  284. package/install.sh +64 -0
  285. package/integrations/veritas/flow-agents.adapter.json +138 -0
  286. package/integrations/veritas/flow-agents.authority-settings.json +26 -0
  287. package/integrations/veritas/flow-agents.repo-standards.json +82 -0
  288. package/kits/builder/flows/build.flow.json +218 -0
  289. package/kits/builder/flows/shape.flow.json +127 -0
  290. package/kits/builder/kit.json +19 -0
  291. package/kits/catalog.json +11 -0
  292. package/package.json +130 -0
  293. package/packaging/README.md +60 -0
  294. package/packaging/manifest.json +173 -0
  295. package/packaging/packs.json +69 -0
  296. package/powers/dependency-checker/POWER.md +20 -0
  297. package/powers/dependency-checker/mcp.json +20 -0
  298. package/powers/playwright/POWER.md +25 -0
  299. package/powers/playwright/mcp.json +12 -0
  300. package/prompts/code-audit.md +123 -0
  301. package/prompts/kcommit.md +88 -0
  302. package/schemas/backlog-provider-settings.schema.json +138 -0
  303. package/schemas/workflow-acceptance.schema.json +216 -0
  304. package/schemas/workflow-critique.schema.json +113 -0
  305. package/schemas/workflow-evidence.schema.json +357 -0
  306. package/schemas/workflow-handoff.schema.json +52 -0
  307. package/schemas/workflow-learning.schema.json +223 -0
  308. package/schemas/workflow-release.schema.json +172 -0
  309. package/schemas/workflow-state.schema.json +80 -0
  310. package/scripts/README.md +111 -0
  311. package/scripts/build-universal-bundles.js +3 -0
  312. package/scripts/check-content-boundary.cjs +99 -0
  313. package/scripts/context-budget/budget-scan.sh +166 -0
  314. package/scripts/detect-tools.sh +3 -0
  315. package/scripts/discover-agents.sh +28 -0
  316. package/scripts/effective-backlog-settings.js +2 -0
  317. package/scripts/filter-installed-packs.js +2 -0
  318. package/scripts/flow-kit.js +2 -0
  319. package/scripts/generate-context-map.js +2 -0
  320. package/scripts/git-status.sh +49 -0
  321. package/scripts/hooks/claude-hook-adapter.js +174 -0
  322. package/scripts/hooks/claude-telemetry-hook.js +115 -0
  323. package/scripts/hooks/codex-hook-adapter.js +176 -0
  324. package/scripts/hooks/codex-telemetry-hook.js +95 -0
  325. package/scripts/hooks/config-protection.js +79 -0
  326. package/scripts/hooks/desktop-notify.sh +39 -0
  327. package/scripts/hooks/governance-audit.sh +135 -0
  328. package/scripts/hooks/lib/audit-transport.sh +40 -0
  329. package/scripts/hooks/lib/hook-flags.js +49 -0
  330. package/scripts/hooks/lib/patterns.sh +57 -0
  331. package/scripts/hooks/lib/resolve-formatter.js +80 -0
  332. package/scripts/hooks/post-edit-accumulator.js +66 -0
  333. package/scripts/hooks/pre-commit-quality.js +194 -0
  334. package/scripts/hooks/quality-gate.js +93 -0
  335. package/scripts/hooks/report-only-guard.js +21 -0
  336. package/scripts/hooks/run-hook.js +136 -0
  337. package/scripts/hooks/stop-format-typecheck.js +141 -0
  338. package/scripts/hooks/stop-goal-fit.js +337 -0
  339. package/scripts/hooks/workflow-steering.js +250 -0
  340. package/scripts/install-codex-home.sh +106 -0
  341. package/scripts/package.json +3 -0
  342. package/scripts/promote-workflow-artifact.js +2 -0
  343. package/scripts/publish-change-helper.js +2 -0
  344. package/scripts/pull-work-provider.js +2 -0
  345. package/scripts/setup-repo-hooks.sh +8 -0
  346. package/scripts/statusline/flow-agents-statusline.js +157 -0
  347. package/scripts/telemetry/console-presets.sh +14 -0
  348. package/scripts/telemetry/install-console-config.sh +214 -0
  349. package/scripts/telemetry/lib/config.sh +85 -0
  350. package/scripts/telemetry/lib/enrich.sh +115 -0
  351. package/scripts/telemetry/lib/redact.sh +22 -0
  352. package/scripts/telemetry/lib/session.sh +63 -0
  353. package/scripts/telemetry/lib/transport.sh +183 -0
  354. package/scripts/telemetry/lib/usage.sh +29 -0
  355. package/scripts/telemetry/sync-agents.sh +173 -0
  356. package/scripts/telemetry/telemetry.conf +23 -0
  357. package/scripts/telemetry/telemetry.sh +387 -0
  358. package/scripts/usage-feedback.js +2 -0
  359. package/scripts/validate-hook-influence-cases.js +2 -0
  360. package/scripts/validate-package.sh +89 -0
  361. package/scripts/validate-source-tree.js +9 -0
  362. package/skills/agentic-engineering/SKILL.md +62 -0
  363. package/skills/browser-test/SKILL.md +51 -0
  364. package/skills/builder-shape/SKILL.md +76 -0
  365. package/skills/context-budget/SKILL.md +40 -0
  366. package/skills/deliver/SKILL.md +241 -0
  367. package/skills/dependency-update/SKILL.md +68 -0
  368. package/skills/design-probe/SKILL.md +107 -0
  369. package/skills/eval-rebuild/SKILL.md +39 -0
  370. package/skills/evidence-gate/SKILL.md +186 -0
  371. package/skills/execute-plan/SKILL.md +110 -0
  372. package/skills/explore/SKILL.md +137 -0
  373. package/skills/feedback-loop/SKILL.md +87 -0
  374. package/skills/fix-bug/SKILL.md +133 -0
  375. package/skills/frontend-design/SKILL.md +80 -0
  376. package/skills/github-cli/SKILL.md +63 -0
  377. package/skills/idea-to-backlog/SKILL.md +267 -0
  378. package/skills/knowledge-capture/SKILL.md +55 -0
  379. package/skills/learning-review/SKILL.md +115 -0
  380. package/skills/pickup-probe/SKILL.md +114 -0
  381. package/skills/plan-work/SKILL.md +176 -0
  382. package/skills/pull-work/SKILL.md +309 -0
  383. package/skills/release-readiness/SKILL.md +121 -0
  384. package/skills/review-work/SKILL.md +161 -0
  385. package/skills/search-first/SKILL.md +66 -0
  386. package/skills/tdd-workflow/SKILL.md +140 -0
  387. package/skills/verify-work/SKILL.md +109 -0
  388. package/src/cli/console-learning-projection.ts +140 -0
  389. package/src/cli/effective-backlog-settings.ts +99 -0
  390. package/src/cli/fixture-retirement-audit.ts +154 -0
  391. package/src/cli/flow-kit.ts +139 -0
  392. package/src/cli/init.ts +248 -0
  393. package/src/cli/promote-workflow-artifact.ts +64 -0
  394. package/src/cli/publish-change-helper.ts +143 -0
  395. package/src/cli/pull-work-provider.ts +481 -0
  396. package/src/cli/runtime-adapter.ts +24 -0
  397. package/src/cli/telemetry-doctor.ts +243 -0
  398. package/src/cli/usage-feedback.ts +418 -0
  399. package/src/cli/validate-hook-influence.ts +119 -0
  400. package/src/cli/validate-source-tree.ts +30 -0
  401. package/src/cli/validate-workflow-artifacts.ts +411 -0
  402. package/src/cli/veritas-governance.ts +322 -0
  403. package/src/cli/workflow-artifact-cleanup-audit.ts +281 -0
  404. package/src/cli/workflow-sidecar.ts +676 -0
  405. package/src/cli.ts +95 -0
  406. package/src/flow-kit/validate.ts +74 -0
  407. package/src/lib/args.ts +43 -0
  408. package/src/lib/fs.ts +62 -0
  409. package/src/lib/workflow-learning-projection.ts +491 -0
  410. package/src/runtime-adapters.ts +154 -0
  411. package/src/tools/build-universal-bundles.ts +366 -0
  412. package/src/tools/common.ts +61 -0
  413. package/src/tools/filter-installed-packs.ts +129 -0
  414. package/src/tools/generate-context-map.ts +199 -0
  415. package/src/tools/validate-package.ts +57 -0
  416. package/src/tools/validate-source-tree.ts +488 -0
  417. package/tsconfig.json +19 -0
  418. package/veritas.claims.json +6 -0
package/evals/cases/dev/index.html ADDED
@@ -0,0 +1,370 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Noir Terminal — Analytics</title>
7
+ <link rel="preconnect" href="https://fonts.googleapis.com">
8
+ <link href="https://fonts.googleapis.com/css2?family=DM+Sans:wght@300;400;500&family=Sora:wght@400;600;700&display=swap" rel="stylesheet">
9
+ <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
10
+ <style>
11
+ :root {
12
+ --bg: #0a0a0f;
13
+ --surface: #12121a;
14
+ --surface2: #1a1a26;
15
+ --border: rgba(255,255,255,0.06);
16
+ --cyan: #00d4ff;
17
+ --amber: #ffb347;
18
+ --coral: #ff6b6b;
19
+ --teal: #4ecdc4;
20
+ --text: #e8e8f0;
21
+ --muted: #6b6b8a;
22
+ --radius: 14px;
23
+ }
24
+
25
+ *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
26
+
27
+ body {
28
+ font-family: 'DM Sans', sans-serif;
29
+ background: var(--bg);
30
+ background-image: radial-gradient(ellipse at 20% 0%, rgba(0,212,255,0.04) 0%, transparent 60%),
31
+ radial-gradient(ellipse at 80% 100%, rgba(255,107,107,0.04) 0%, transparent 60%);
32
+ color: var(--text);
33
+ min-height: 100vh;
34
+ padding: 0 0 48px;
35
+ }
36
+
37
+ header {
38
+ padding: 28px 40px 24px;
39
+ border-bottom: 1px solid var(--border);
40
+ background: linear-gradient(180deg, rgba(0,212,255,0.03) 0%, transparent 100%);
41
+ display: flex;
42
+ align-items: center;
43
+ justify-content: space-between;
44
+ }
45
+
46
+ header h1 {
47
+ font-family: 'Sora', sans-serif;
48
+ font-size: 1.25rem;
49
+ font-weight: 700;
50
+ letter-spacing: -0.02em;
51
+ color: var(--text);
52
+ }
53
+
54
+ header h1 span { color: var(--cyan); }
55
+
56
+ .badge {
57
+ font-size: 0.7rem;
58
+ font-weight: 500;
59
+ color: var(--cyan);
60
+ background: rgba(0,212,255,0.1);
61
+ border: 1px solid rgba(0,212,255,0.2);
62
+ padding: 4px 10px;
63
+ border-radius: 20px;
64
+ letter-spacing: 0.08em;
65
+ text-transform: uppercase;
66
+ }
67
+
68
+ main { padding: 36px 40px 0; max-width: 1400px; margin: 0 auto; }
69
+
70
+ /* Stat Cards */
71
+ .stats {
72
+ display: grid;
73
+ grid-template-columns: repeat(4, 1fr);
74
+ gap: 16px;
75
+ margin-bottom: 24px;
76
+ }
77
+
78
+ .stat-card {
79
+ background: var(--surface);
80
+ border: 1px solid var(--border);
81
+ border-radius: var(--radius);
82
+ padding: 22px 24px;
83
+ opacity: 0;
84
+ animation: fadeUp 0.5s ease forwards;
85
+ transition: transform 0.2s ease, box-shadow 0.2s ease;
86
+ cursor: default;
87
+ }
88
+
89
+ .stat-card:hover {
90
+ transform: translateY(-3px);
91
+ box-shadow: 0 8px 32px rgba(0,0,0,0.4), 0 0 0 1px rgba(255,255,255,0.08);
92
+ }
93
+
94
+ .stat-card:nth-child(1) { animation-delay: 0.05s; }
95
+ .stat-card:nth-child(2) { animation-delay: 0.1s; }
96
+ .stat-card:nth-child(3) { animation-delay: 0.15s; }
97
+ .stat-card:nth-child(4) { animation-delay: 0.2s; }
98
+
99
+ .stat-label {
100
+ font-size: 0.72rem;
101
+ font-weight: 500;
102
+ color: var(--muted);
103
+ text-transform: uppercase;
104
+ letter-spacing: 0.1em;
105
+ margin-bottom: 10px;
106
+ }
107
+
108
+ .stat-value {
109
+ font-family: 'Sora', sans-serif;
110
+ font-size: 1.9rem;
111
+ font-weight: 700;
112
+ letter-spacing: -0.03em;
113
+ line-height: 1;
114
+ margin-bottom: 8px;
115
+ }
116
+
117
+ .stat-delta {
118
+ font-size: 0.75rem;
119
+ font-weight: 500;
120
+ color: var(--teal);
121
+ }
122
+
123
+ .stat-delta.down { color: var(--coral); }
124
+
125
+ .accent-cyan { color: var(--cyan); }
126
+ .accent-amber { color: var(--amber); }
127
+ .accent-coral { color: var(--coral); }
128
+ .accent-teal { color: var(--teal); }
129
+
130
+ /* Chart Grid */
131
+ .charts {
132
+ display: grid;
133
+ grid-template-columns: repeat(2, 1fr);
134
+ gap: 16px;
135
+ }
136
+
137
+ .chart-card {
138
+ background: var(--surface);
139
+ border: 1px solid var(--border);
140
+ border-radius: var(--radius);
141
+ padding: 24px;
142
+ opacity: 0;
143
+ animation: fadeUp 0.5s ease forwards;
144
+ transition: transform 0.2s ease, box-shadow 0.2s ease;
145
+ }
146
+
147
+ .chart-card:hover {
148
+ transform: translateY(-2px);
149
+ box-shadow: 0 8px 32px rgba(0,0,0,0.4), 0 0 0 1px rgba(255,255,255,0.08);
150
+ }
151
+
152
+ .chart-card:nth-child(1) { animation-delay: 0.25s; }
153
+ .chart-card:nth-child(2) { animation-delay: 0.3s; }
154
+ .chart-card:nth-child(3) { animation-delay: 0.35s; }
155
+ .chart-card:nth-child(4) { animation-delay: 0.4s; }
156
+
157
+ .chart-header {
158
+ display: flex;
159
+ align-items: baseline;
160
+ justify-content: space-between;
161
+ margin-bottom: 20px;
162
+ }
163
+
164
+ .chart-title {
165
+ font-family: 'Sora', sans-serif;
166
+ font-size: 0.9rem;
167
+ font-weight: 600;
168
+ color: var(--text);
169
+ }
170
+
171
+ .chart-sub {
172
+ font-size: 0.72rem;
173
+ color: var(--muted);
174
+ }
175
+
176
+ .chart-wrap { position: relative; height: 220px; }
177
+
178
+ @keyframes fadeUp {
179
+ from { opacity: 0; transform: translateY(16px); }
180
+ to { opacity: 1; transform: translateY(0); }
181
+ }
182
+
183
+ @media (max-width: 900px) {
184
+ main { padding: 24px 20px 0; }
185
+ header { padding: 20px; }
186
+ .stats { grid-template-columns: repeat(2, 1fr); }
187
+ .charts { grid-template-columns: 1fr; }
188
+ }
189
+ </style>
190
+ </head>
191
+ <body>
192
+
193
+ <header>
194
+ <h1>Noir<span>.</span>Terminal</h1>
195
+ <span class="badge">Live · Apr 2026</span>
196
+ </header>
197
+
198
+ <main>
199
+ <div class="stats">
200
+ <div class="stat-card">
201
+ <div class="stat-label">Total Revenue</div>
202
+ <div class="stat-value accent-cyan">$2.84M</div>
203
+ <div class="stat-delta">↑ 18.4% vs last quarter</div>
204
+ </div>
205
+ <div class="stat-card">
206
+ <div class="stat-label">Active Users</div>
207
+ <div class="stat-value accent-amber">142,390</div>
208
+ <div class="stat-delta">↑ 9.2% month-over-month</div>
209
+ </div>
210
+ <div class="stat-card">
211
+ <div class="stat-label">Conversion Rate</div>
212
+ <div class="stat-value accent-teal">4.67%</div>
213
+ <div class="stat-delta down">↓ 0.3% vs last month</div>
214
+ </div>
215
+ <div class="stat-card">
216
+ <div class="stat-label">Avg Session</div>
217
+ <div class="stat-value accent-coral">6m 42s</div>
218
+ <div class="stat-delta">↑ 1m 08s improvement</div>
219
+ </div>
220
+ </div>
221
+
222
+ <div class="charts">
223
+ <div class="chart-card">
224
+ <div class="chart-header">
225
+ <span class="chart-title">Monthly Revenue</span>
226
+ <span class="chart-sub">Last 12 months</span>
227
+ </div>
228
+ <div class="chart-wrap"><canvas id="revenueChart"></canvas></div>
229
+ </div>
230
+ <div class="chart-card">
231
+ <div class="chart-header">
232
+ <span class="chart-title">Daily Active Users</span>
233
+ <span class="chart-sub">Past 8 weeks</span>
234
+ </div>
235
+ <div class="chart-wrap"><canvas id="usersChart"></canvas></div>
236
+ </div>
237
+ <div class="chart-card">
238
+ <div class="chart-header">
239
+ <span class="chart-title">Traffic Sources</span>
240
+ <span class="chart-sub">Current period</span>
241
+ </div>
242
+ <div class="chart-wrap"><canvas id="trafficChart"></canvas></div>
243
+ </div>
244
+ <div class="chart-card">
245
+ <div class="chart-header">
246
+ <span class="chart-title">Conversion Funnel</span>
247
+ <span class="chart-sub">Visits → Purchase</span>
248
+ </div>
249
+ <div class="chart-wrap"><canvas id="funnelChart"></canvas></div>
250
+ </div>
251
+ </div>
252
+ </main>
253
+
254
+ <script>
255
+ const MONTHS = ['May','Jun','Jul','Aug','Sep','Oct','Nov','Dec','Jan','Feb','Mar','Apr'];
256
+ const WEEKS = ['W1','W2','W3','W4','W5','W6','W7','W8'];
257
+
258
+ Chart.defaults.color = '#6b6b8a';
259
+ Chart.defaults.font.family = "'DM Sans', sans-serif";
260
+ Chart.defaults.font.size = 11;
261
+
262
+ const gridLine = { color: 'rgba(255,255,255,0.04)', drawBorder: false };
263
+ const noTicks = { display: false };
264
+
265
+ // Revenue — Line
266
+ new Chart(document.getElementById('revenueChart'), {
267
+ type: 'line',
268
+ data: {
269
+ labels: MONTHS,
270
+ datasets: [{
271
+ data: [180,210,195,240,228,265,290,310,275,330,360,410],
272
+ borderColor: '#00d4ff',
273
+ backgroundColor: 'rgba(0,212,255,0.08)',
274
+ borderWidth: 2,
275
+ pointRadius: 3,
276
+ pointBackgroundColor: '#00d4ff',
277
+ fill: true,
278
+ tension: 0.4
279
+ }]
280
+ },
281
+ options: {
282
+ responsive: true, maintainAspectRatio: false,
283
+ plugins: { legend: { display: false }, tooltip: { callbacks: { label: c => ` $${c.raw}k` } } },
284
+ scales: {
285
+ x: { grid: gridLine, ticks: { color: '#6b6b8a' } },
286
+ y: { grid: gridLine, ticks: { color: '#6b6b8a', callback: v => `$${v}k` } }
287
+ }
288
+ }
289
+ });
290
+
291
+ // Users — Bar
292
+ new Chart(document.getElementById('usersChart'), {
293
+ type: 'bar',
294
+ data: {
295
+ labels: WEEKS,
296
+ datasets: [{
297
+ data: [9800,11200,10500,13400,12800,14600,15200,16100],
298
+ backgroundColor: 'rgba(255,179,71,0.7)',
299
+ borderColor: '#ffb347',
300
+ borderWidth: 1,
301
+ borderRadius: 5,
302
+ borderSkipped: false
303
+ }]
304
+ },
305
+ options: {
306
+ responsive: true, maintainAspectRatio: false,
307
+ plugins: { legend: { display: false } },
308
+ scales: {
309
+ x: { grid: gridLine, ticks: { color: '#6b6b8a' } },
310
+ y: { grid: gridLine, ticks: { color: '#6b6b8a', callback: v => `${(v/1000).toFixed(0)}k` } }
311
+ }
312
+ }
313
+ });
314
+
315
+ // Traffic — Doughnut
316
+ new Chart(document.getElementById('trafficChart'), {
317
+ type: 'doughnut',
318
+ data: {
319
+ labels: ['Organic','Direct','Referral','Social','Email'],
320
+ datasets: [{
321
+ data: [38, 24, 17, 13, 8],
322
+ backgroundColor: ['#00d4ff','#ffb347','#4ecdc4','#ff6b6b','rgba(255,255,255,0.15)'],
323
+ borderColor: '#12121a',
324
+ borderWidth: 3,
325
+ hoverOffset: 6
326
+ }]
327
+ },
328
+ options: {
329
+ responsive: true, maintainAspectRatio: false,
330
+ cutout: '68%',
331
+ plugins: {
332
+ legend: {
333
+ position: 'right',
334
+ labels: { color: '#9999b8', boxWidth: 10, padding: 14, font: { size: 11 } }
335
+ },
336
+ tooltip: { callbacks: { label: c => ` ${c.label}: ${c.raw}%` } }
337
+ }
338
+ }
339
+ });
340
+
341
+ // Funnel — Horizontal Bar
342
+ new Chart(document.getElementById('funnelChart'), {
343
+ type: 'bar',
344
+ data: {
345
+ labels: ['Visits','Sign-ups','Trials','Paid'],
346
+ datasets: [{
347
+ data: [100, 42, 18, 8],
348
+ backgroundColor: ['rgba(78,205,196,0.8)','rgba(78,205,196,0.6)','rgba(78,205,196,0.4)','rgba(78,205,196,0.25)'],
349
+ borderColor: '#4ecdc4',
350
+ borderWidth: 1,
351
+ borderRadius: 5,
352
+ borderSkipped: false
353
+ }]
354
+ },
355
+ options: {
356
+ indexAxis: 'y',
357
+ responsive: true, maintainAspectRatio: false,
358
+ plugins: {
359
+ legend: { display: false },
360
+ tooltip: { callbacks: { label: c => ` ${c.raw}% of visits` } }
361
+ },
362
+ scales: {
363
+ x: { grid: gridLine, ticks: { color: '#6b6b8a', callback: v => `${v}%` } },
364
+ y: { grid: { display: false }, ticks: { color: '#9999b8' } }
365
+ }
366
+ }
367
+ });
368
+ </script>
369
+ </body>
370
+ </html>
package/evals/cases/dev/package-lock.json ADDED
@@ -0,0 +1,28 @@
1
+ {
2
+ "name": "dev",
3
+ "version": "1.0.0",
4
+ "lockfileVersion": 3,
5
+ "requires": true,
6
+ "packages": {
7
+ "": {
8
+ "name": "dev",
9
+ "version": "1.0.0",
10
+ "license": "ISC",
11
+ "dependencies": {
12
+ "marked": "^18.0.5"
13
+ }
14
+ },
15
+ "node_modules/marked": {
16
+ "version": "18.0.5",
17
+ "resolved": "https://registry.npmjs.org/marked/-/marked-18.0.5.tgz",
18
+ "integrity": "sha512-S6GcvALHg6K4ohtu4E7x0a1AqhAjp6cV8KhLSyN9qVapnzJkusVBxZRcIU9AeYsbe6P1hKDusSbEOzGyyuce6w==",
19
+ "license": "MIT",
20
+ "bin": {
21
+ "marked": "bin/marked.js"
22
+ },
23
+ "engines": {
24
+ "node": ">= 20"
25
+ }
26
+ }
27
+ }
28
+ }
package/evals/cases/dev/package.json ADDED
@@ -0,0 +1,16 @@
1
+ {
2
+ "name": "dev",
3
+ "version": "1.0.0",
4
+ "description": "",
5
+ "main": "index.js",
6
+ "scripts": {
7
+ "test": "echo \"Error: no test specified\" && exit 1"
8
+ },
9
+ "keywords": [],
10
+ "author": "",
11
+ "license": "ISC",
12
+ "type": "commonjs",
13
+ "dependencies": {
14
+ "marked": "^18.0.5"
15
+ }
16
+ }
package/evals/cases/dev/plan-work.yaml ADDED
@@ -0,0 +1,20 @@
1
+ # dev/plan-work.yaml — Eval: dev agent activates plan-work skill for code planning
2
+ - vars:
3
+ prompt: "Plan out the changes needed to add a REST API endpoint for user profiles"
4
+ assert:
5
+ - type: javascript
6
+ value: file://../../lib/assertions/delegated-to.js
7
+ config:
8
+ expected: ['tool-planner']
9
+ - type: javascript
10
+ value: file://../../lib/assertions/tool-called.js
11
+ config:
12
+ tool: delegate to a specialist agent
13
+ - type: javascript
14
+ value: file://../../lib/assertions/no-write-tools.js
15
+ - type: llm-rubric
16
+ value: |
17
+ The agent activated the 'plan-work' skill and delegated to tool-planner.
18
+ It should NOT have started writing code — plan-work only produces a plan artifact.
19
+ The response should contain a structured plan with tasks, files to modify, and acceptance criteria.
20
+ Score 1 if it skipped planning and went to implementation, 3 if partial, 5 if full plan-work workflow.