@kontourai/flow-agents 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (418) hide show
  1. package/.githooks/pre-push +11 -0
  2. package/.github/workflows/ci.yml +210 -0
  3. package/.github/workflows/docs-pages.yml +52 -0
  4. package/.github/workflows/publish-npm.yml +104 -0
  5. package/AGENTS.md +26 -0
  6. package/CHANGELOG.md +66 -0
  7. package/CODE_OF_CONDUCT.md +25 -0
  8. package/CONTEXT.md +300 -0
  9. package/CONTRIBUTING.md +44 -0
  10. package/LICENSE +201 -0
  11. package/README.md +129 -0
  12. package/SECURITY.md +33 -0
  13. package/agent-cards/dev.json +19 -0
  14. package/agents/dev.json +127 -0
  15. package/agents/tool-code-reviewer.json +61 -0
  16. package/agents/tool-dependencies-updater.json +118 -0
  17. package/agents/tool-explore-config.json +92 -0
  18. package/agents/tool-explore-deps.json +92 -0
  19. package/agents/tool-explore-entry.json +92 -0
  20. package/agents/tool-explore-patterns.json +92 -0
  21. package/agents/tool-explore-structure.json +92 -0
  22. package/agents/tool-explore-tests.json +92 -0
  23. package/agents/tool-planner.json +57 -0
  24. package/agents/tool-playwright.json +145 -0
  25. package/agents/tool-security-reviewer.json +56 -0
  26. package/agents/tool-verifier.json +61 -0
  27. package/agents/tool-worker.json +58 -0
  28. package/build/src/cli/console-learning-projection.js +123 -0
  29. package/build/src/cli/docs-preview.js +39 -0
  30. package/build/src/cli/effective-backlog-settings.js +102 -0
  31. package/build/src/cli/export-bookmarks.js +38 -0
  32. package/build/src/cli/fixture-retirement-audit.js +140 -0
  33. package/build/src/cli/flow-kit.js +138 -0
  34. package/build/src/cli/import-bookmarks.js +50 -0
  35. package/build/src/cli/init.js +239 -0
  36. package/build/src/cli/instinct-cli.js +93 -0
  37. package/build/src/cli/promote-workflow-artifact.js +63 -0
  38. package/build/src/cli/publish-change-helper.js +154 -0
  39. package/build/src/cli/pull-work-provider.js +469 -0
  40. package/build/src/cli/runtime-adapter.js +23 -0
  41. package/build/src/cli/telemetry-doctor.js +221 -0
  42. package/build/src/cli/usage-feedback.js +443 -0
  43. package/build/src/cli/validate-hook-influence.js +152 -0
  44. package/build/src/cli/validate-source-tree.js +31 -0
  45. package/build/src/cli/validate-workflow-artifacts.js +486 -0
  46. package/build/src/cli/veritas-governance.js +262 -0
  47. package/build/src/cli/workflow-artifact-cleanup-audit.js +272 -0
  48. package/build/src/cli/workflow-sidecar.js +816 -0
  49. package/build/src/cli.js +89 -0
  50. package/build/src/flow-kit/validate.js +75 -0
  51. package/build/src/lib/args.js +45 -0
  52. package/build/src/lib/fs.js +62 -0
  53. package/build/src/lib/workflow-learning-projection.js +334 -0
  54. package/build/src/runtime-adapters.js +146 -0
  55. package/build/src/tools/build-universal-bundles.js +397 -0
  56. package/build/src/tools/common.js +56 -0
  57. package/build/src/tools/filter-installed-packs.js +132 -0
  58. package/build/src/tools/generate-context-map.js +198 -0
  59. package/build/src/tools/validate-package.js +64 -0
  60. package/build/src/tools/validate-source-tree.js +622 -0
  61. package/console.telemetry.json +176 -0
  62. package/context/base-rules.md +17 -0
  63. package/context/code-review-standards.md +62 -0
  64. package/context/coding-standards.md +42 -0
  65. package/context/common/orchestrators.md +12 -0
  66. package/context/common/subagents.md +28 -0
  67. package/context/contracts/artifact-contract.md +182 -0
  68. package/context/contracts/builder-kit-workflow-state-contract.md +319 -0
  69. package/context/contracts/delivery-contract.md +69 -0
  70. package/context/contracts/execution-contract.md +53 -0
  71. package/context/contracts/governance-adapter-contract.md +67 -0
  72. package/context/contracts/planning-contract.md +85 -0
  73. package/context/contracts/review-contract.md +104 -0
  74. package/context/contracts/sandbox-policy.md +52 -0
  75. package/context/contracts/verification-contract.md +134 -0
  76. package/context/contracts/work-item-contract.md +215 -0
  77. package/context/deferred/demo-mode.md +33 -0
  78. package/context/deferred/languages/go.md +31 -0
  79. package/context/deferred/languages/python.md +31 -0
  80. package/context/deferred/languages/typescript.md +34 -0
  81. package/context/deferred/parallelization.md +35 -0
  82. package/context/deferred/worktree-isolation.md +24 -0
  83. package/context/development-workflow.md +50 -0
  84. package/context/scripts/context-budget/budget-scan.sh +166 -0
  85. package/context/scripts/detect-tools.sh +3 -0
  86. package/context/scripts/discover-agents.sh +28 -0
  87. package/context/scripts/git-status.sh +49 -0
  88. package/context/scripts/hooks/config-protection.js +79 -0
  89. package/context/scripts/hooks/desktop-notify.sh +39 -0
  90. package/context/scripts/hooks/governance-audit.sh +135 -0
  91. package/context/scripts/hooks/lib/audit-transport.sh +40 -0
  92. package/context/scripts/hooks/lib/hook-flags.js +49 -0
  93. package/context/scripts/hooks/lib/patterns.sh +57 -0
  94. package/context/scripts/hooks/lib/resolve-formatter.js +80 -0
  95. package/context/scripts/hooks/post-edit-accumulator.js +66 -0
  96. package/context/scripts/hooks/pre-commit-quality.js +194 -0
  97. package/context/scripts/hooks/quality-gate.js +93 -0
  98. package/context/scripts/hooks/report-only-guard.js +21 -0
  99. package/context/scripts/hooks/run-hook.js +136 -0
  100. package/context/scripts/hooks/stop-format-typecheck.js +141 -0
  101. package/context/scripts/hooks/stop-goal-fit.js +337 -0
  102. package/context/scripts/hooks/workflow-steering.js +250 -0
  103. package/context/scripts/telemetry/console-presets.sh +14 -0
  104. package/context/scripts/telemetry/install-console-config.sh +214 -0
  105. package/context/scripts/telemetry/lib/config.sh +85 -0
  106. package/context/scripts/telemetry/lib/enrich.sh +115 -0
  107. package/context/scripts/telemetry/lib/redact.sh +22 -0
  108. package/context/scripts/telemetry/lib/session.sh +63 -0
  109. package/context/scripts/telemetry/lib/transport.sh +183 -0
  110. package/context/scripts/telemetry/lib/usage.sh +29 -0
  111. package/context/scripts/telemetry/sync-agents.sh +173 -0
  112. package/context/scripts/telemetry/telemetry.conf +23 -0
  113. package/context/scripts/telemetry/telemetry.sh +387 -0
  114. package/context/scripts/validate-package.sh +89 -0
  115. package/context/settings/backlog-provider-settings.json +54 -0
  116. package/context/templates/core/identity.md +26 -0
  117. package/context/templates/core/user.md +15 -0
  118. package/docs/_config.yml +15 -0
  119. package/docs/_layouts/default.html +87 -0
  120. package/docs/adr/0001-flow-agents-consumes-flow.md +77 -0
  121. package/docs/adr/0002-flow-kits-as-extension-unit.md +13 -0
  122. package/docs/adr/0003-flow-agents-coordinates-kits-and-adapters.md +13 -0
  123. package/docs/adr/0004-gates-expect-surface-claims.md +15 -0
  124. package/docs/adr/0005-kubernetes-inspired-resource-contracts.md +48 -0
  125. package/docs/adr/0006-typescript-first-source-policy.md +98 -0
  126. package/docs/agent-system-guidebook.md +391 -0
  127. package/docs/agent-usage-feedback-loop.md +351 -0
  128. package/docs/assets/favicon.svg +13 -0
  129. package/docs/assets/og-image.png +0 -0
  130. package/docs/assets/site.css +774 -0
  131. package/docs/assets/site.js +139 -0
  132. package/docs/configurable-workflow-routing.md +174 -0
  133. package/docs/context-map.md +145 -0
  134. package/docs/developer-architecture.md +145 -0
  135. package/docs/developer-hook-setup.md +61 -0
  136. package/docs/fixture-ownership.md +44 -0
  137. package/docs/flow-kit-repository-contract.md +180 -0
  138. package/docs/index.md +129 -0
  139. package/docs/kontour-resource-contract.md +358 -0
  140. package/docs/migrations.md +64 -0
  141. package/docs/north-star.md +322 -0
  142. package/docs/operating-layers.md +110 -0
  143. package/docs/repository-structure.md +132 -0
  144. package/docs/sandbox-policy.md +56 -0
  145. package/docs/skills-map.md +203 -0
  146. package/docs/standards-register.md +96 -0
  147. package/docs/veritas-integration.md +165 -0
  148. package/docs/work-item-adapters.md +72 -0
  149. package/docs/workflow-artifact-lifecycle.md +141 -0
  150. package/docs/workflow-eval-strategy.md +295 -0
  151. package/docs/workflow-shared-contracts.md +51 -0
  152. package/docs/workflow-usage-guide.md +443 -0
  153. package/evals/ARCHITECTURE.md +143 -0
  154. package/evals/CONVENTIONS.md +58 -0
  155. package/evals/README.md +128 -0
  156. package/evals/acceptance/run.sh +29 -0
  157. package/evals/acceptance/test_claude_harness.sh +242 -0
  158. package/evals/acceptance/test_codex_harness.sh +108 -0
  159. package/evals/acceptance/test_kiro_harness.sh +128 -0
  160. package/evals/cases/dev/404.html +97 -0
  161. package/evals/cases/dev/code-review.yaml +44 -0
  162. package/evals/cases/dev/dashboard.html +300 -0
  163. package/evals/cases/dev/deliver.yaml +66 -0
  164. package/evals/cases/dev/dependency-update.yaml +16 -0
  165. package/evals/cases/dev/explore.yaml +20 -0
  166. package/evals/cases/dev/index.html +370 -0
  167. package/evals/cases/dev/package-lock.json +28 -0
  168. package/evals/cases/dev/package.json +16 -0
  169. package/evals/cases/dev/plan-work.yaml +20 -0
  170. package/evals/cases/dev/promptfooconfig.yaml +666 -0
  171. package/evals/cases/dev/search-first.yaml +20 -0
  172. package/evals/cases/dev/tdd-workflow.yaml +48 -0
  173. package/evals/cases/dev/verify-work.yaml +44 -0
  174. package/evals/cases/dev/workflow.yaml +34 -0
  175. package/evals/ci/run-baseline.sh +283 -0
  176. package/evals/fixtures/backlog-provider-settings/global-default.json +44 -0
  177. package/evals/fixtures/backlog-provider-settings/project-override.json +53 -0
  178. package/evals/fixtures/builder-kit-workflow-state/baseline-freshness-resolution-hint.json +139 -0
  179. package/evals/fixtures/builder-kit-workflow-state/direct-primitive-stop.json +59 -0
  180. package/evals/fixtures/builder-kit-workflow-state/empty-board-route-shape.json +55 -0
  181. package/evals/fixtures/builder-kit-workflow-state/happy-path.json +71 -0
  182. package/evals/fixtures/builder-kit-workflow-state/mid-work-resume.json +80 -0
  183. package/evals/fixtures/builder-kit-workflow-state/missing-prestep-recovery.json +65 -0
  184. package/evals/fixtures/builder-kit-workflow-state/product-build-chaining.json +60 -0
  185. package/evals/fixtures/builder-kit-workflow-state/stale-continuation-requires-new-probe.json +57 -0
  186. package/evals/fixtures/console-learning-projection/artifacts/console-learning-correction/learning.json +50 -0
  187. package/evals/fixtures/console-learning-projection/artifacts/console-learning-open-route/learning.json +41 -0
  188. package/evals/fixtures/flow-kit-repository/invalid-absolute-path/kit.json +8 -0
  189. package/evals/fixtures/flow-kit-repository/invalid-asset-section/flows/review.flow.json +6 -0
  190. package/evals/fixtures/flow-kit-repository/invalid-asset-section/kit.json +11 -0
  191. package/evals/fixtures/flow-kit-repository/invalid-duplicate-flow/flows/review.flow.json +6 -0
  192. package/evals/fixtures/flow-kit-repository/invalid-duplicate-flow/kit.json +9 -0
  193. package/evals/fixtures/flow-kit-repository/invalid-id/flows/review.flow.json +6 -0
  194. package/evals/fixtures/flow-kit-repository/invalid-id/kit.json +8 -0
  195. package/evals/fixtures/flow-kit-repository/invalid-malformed-json/kit.json +8 -0
  196. package/evals/fixtures/flow-kit-repository/invalid-missing-flow/kit.json +8 -0
  197. package/evals/fixtures/flow-kit-repository/invalid-missing-id/flows/review.flow.json +6 -0
  198. package/evals/fixtures/flow-kit-repository/invalid-missing-id/kit.json +7 -0
  199. package/evals/fixtures/flow-kit-repository/invalid-missing-schema-version/flows/review.flow.json +6 -0
  200. package/evals/fixtures/flow-kit-repository/invalid-missing-schema-version/kit.json +7 -0
  201. package/evals/fixtures/flow-kit-repository/invalid-name/flows/review.flow.json +6 -0
  202. package/evals/fixtures/flow-kit-repository/invalid-name/kit.json +8 -0
  203. package/evals/fixtures/flow-kit-repository/invalid-schema-version/flows/review.flow.json +6 -0
  204. package/evals/fixtures/flow-kit-repository/invalid-schema-version/kit.json +8 -0
  205. package/evals/fixtures/flow-kit-repository/invalid-traversal/kit.json +8 -0
  206. package/evals/fixtures/flow-kit-repository/mixed-runtime-kit/adapters/example.json +3 -0
  207. package/evals/fixtures/flow-kit-repository/mixed-runtime-kit/assets/example.txt +1 -0
  208. package/evals/fixtures/flow-kit-repository/mixed-runtime-kit/docs/README.md +3 -0
  209. package/evals/fixtures/flow-kit-repository/mixed-runtime-kit/flows/runtime.flow.json +26 -0
  210. package/evals/fixtures/flow-kit-repository/mixed-runtime-kit/kit-evals/example.json +3 -0
  211. package/evals/fixtures/flow-kit-repository/mixed-runtime-kit/kit-skills/mixed/SKILL.md +3 -0
  212. package/evals/fixtures/flow-kit-repository/mixed-runtime-kit/kit.json +44 -0
  213. package/evals/fixtures/flow-kit-repository/valid-local-kit/docs/README.md +3 -0
  214. package/evals/fixtures/flow-kit-repository/valid-local-kit/flows/review.flow.json +26 -0
  215. package/evals/fixtures/flow-kit-repository/valid-local-kit/kit.json +20 -0
  216. package/evals/fixtures/hook-influence/cases.json +336 -0
  217. package/evals/fixtures/pull-work-provider/github-issues.json +170 -0
  218. package/evals/fixtures/pull-work-wip-shepherding/global-wip-informs.json +43 -0
  219. package/evals/fixtures/pull-work-wip-shepherding/personal-wip-blocks.json +42 -0
  220. package/evals/fixtures/surface-trust/accepted-claim-trust-report.json +31 -0
  221. package/evals/fixtures/surface-trust/artifact-absent.json +19 -0
  222. package/evals/fixtures/surface-trust/integrity-mismatch-trust-report.json +32 -0
  223. package/evals/fixtures/surface-trust/missing-authority-trust-report.json +27 -0
  224. package/evals/fixtures/surface-trust/provider-absent.json +19 -0
  225. package/evals/fixtures/surface-trust/rejected-claim-trust-report.json +30 -0
  226. package/evals/fixtures/surface-trust/stale-claim-trust-snapshot.json +31 -0
  227. package/evals/fixtures/usage-feedback/sample-full.jsonl +11 -0
  228. package/evals/fixtures/usage-feedback/sample-outcomes.jsonl +1 -0
  229. package/evals/fixtures/veritas-governance-adapter/fake-veritas-pass.sh +18 -0
  230. package/evals/fixtures/veritas-governance-adapter/fake-veritas-secret-fail.sh +10 -0
  231. package/evals/fixtures/veritas-governance-adapter/fake-veritas-unconfigured.sh +4 -0
  232. package/evals/integration/test_bundle_install.sh +541 -0
  233. package/evals/integration/test_console_learning_projection.sh +192 -0
  234. package/evals/integration/test_context_map.sh +65 -0
  235. package/evals/integration/test_effective_backlog_settings.sh +58 -0
  236. package/evals/integration/test_fixture_retirement_audit.sh +58 -0
  237. package/evals/integration/test_flow_agents_statusline.sh +93 -0
  238. package/evals/integration/test_flow_kit_repository.sh +90 -0
  239. package/evals/integration/test_goal_fit_hook.sh +482 -0
  240. package/evals/integration/test_hook_category_behaviors.sh +190 -0
  241. package/evals/integration/test_hook_influence_cases.sh +69 -0
  242. package/evals/integration/test_local_flow_kit_install.sh +145 -0
  243. package/evals/integration/test_publish_change_helper.sh +176 -0
  244. package/evals/integration/test_pull_work_provider.sh +140 -0
  245. package/evals/integration/test_runtime_adapter_activation.sh +106 -0
  246. package/evals/integration/test_telemetry.sh +485 -0
  247. package/evals/integration/test_telemetry_doctor.sh +193 -0
  248. package/evals/integration/test_usage_feedback_dashboard.sh +169 -0
  249. package/evals/integration/test_usage_feedback_global.sh +117 -0
  250. package/evals/integration/test_usage_feedback_import.sh +227 -0
  251. package/evals/integration/test_usage_feedback_outcomes.sh +165 -0
  252. package/evals/integration/test_usage_feedback_report.sh +263 -0
  253. package/evals/integration/test_veritas_governance_adapter.sh +235 -0
  254. package/evals/integration/test_workflow_artifact_cleanup_audit.sh +287 -0
  255. package/evals/integration/test_workflow_artifacts.sh +1247 -0
  256. package/evals/integration/test_workflow_sidecar_writer.sh +2112 -0
  257. package/evals/integration/test_workflow_steering_hook.sh +337 -0
  258. package/evals/lib/assertions/delegated-to.js +40 -0
  259. package/evals/lib/assertions/max-tool-calls.js +15 -0
  260. package/evals/lib/assertions/no-write-tools.js +27 -0
  261. package/evals/lib/assertions/pass-at-k.js +39 -0
  262. package/evals/lib/assertions/telemetry-utils.js +105 -0
  263. package/evals/lib/assertions/tool-called.js +39 -0
  264. package/evals/lib/assertions/verify-after-fix.js +61 -0
  265. package/evals/lib/claude-judge.sh +40 -0
  266. package/evals/lib/claude-provider.sh +74 -0
  267. package/evals/lib/codex-judge.sh +39 -0
  268. package/evals/lib/codex-provider.sh +81 -0
  269. package/evals/lib/eval-dev.sh +5 -0
  270. package/evals/lib/eval-judge.sh +22 -0
  271. package/evals/lib/eval-provider.sh +26 -0
  272. package/evals/lib/eval-report.sh +73 -0
  273. package/evals/lib/kiro-dev.sh +4 -0
  274. package/evals/lib/kiro-judge.sh +17 -0
  275. package/evals/lib/kiro-provider.sh +62 -0
  276. package/evals/lib/node.sh +111 -0
  277. package/evals/promptfooconfig.yaml +70 -0
  278. package/evals/run.sh +309 -0
  279. package/evals/static/test_evidence_refs.sh +141 -0
  280. package/evals/static/test_package.sh +407 -0
  281. package/evals/static/test_repo_hooks.sh +68 -0
  282. package/evals/static/test_universal_bundles.sh +274 -0
  283. package/evals/static/test_workflow_skills.sh +1207 -0
  284. package/install.sh +64 -0
  285. package/integrations/veritas/flow-agents.adapter.json +138 -0
  286. package/integrations/veritas/flow-agents.authority-settings.json +26 -0
  287. package/integrations/veritas/flow-agents.repo-standards.json +82 -0
  288. package/kits/builder/flows/build.flow.json +218 -0
  289. package/kits/builder/flows/shape.flow.json +127 -0
  290. package/kits/builder/kit.json +19 -0
  291. package/kits/catalog.json +11 -0
  292. package/package.json +130 -0
  293. package/packaging/README.md +60 -0
  294. package/packaging/manifest.json +173 -0
  295. package/packaging/packs.json +69 -0
  296. package/powers/dependency-checker/POWER.md +20 -0
  297. package/powers/dependency-checker/mcp.json +20 -0
  298. package/powers/playwright/POWER.md +25 -0
  299. package/powers/playwright/mcp.json +12 -0
  300. package/prompts/code-audit.md +123 -0
  301. package/prompts/kcommit.md +88 -0
  302. package/schemas/backlog-provider-settings.schema.json +138 -0
  303. package/schemas/workflow-acceptance.schema.json +216 -0
  304. package/schemas/workflow-critique.schema.json +113 -0
  305. package/schemas/workflow-evidence.schema.json +357 -0
  306. package/schemas/workflow-handoff.schema.json +52 -0
  307. package/schemas/workflow-learning.schema.json +223 -0
  308. package/schemas/workflow-release.schema.json +172 -0
  309. package/schemas/workflow-state.schema.json +80 -0
  310. package/scripts/README.md +111 -0
  311. package/scripts/build-universal-bundles.js +3 -0
  312. package/scripts/check-content-boundary.cjs +99 -0
  313. package/scripts/context-budget/budget-scan.sh +166 -0
  314. package/scripts/detect-tools.sh +3 -0
  315. package/scripts/discover-agents.sh +28 -0
  316. package/scripts/effective-backlog-settings.js +2 -0
  317. package/scripts/filter-installed-packs.js +2 -0
  318. package/scripts/flow-kit.js +2 -0
  319. package/scripts/generate-context-map.js +2 -0
  320. package/scripts/git-status.sh +49 -0
  321. package/scripts/hooks/claude-hook-adapter.js +174 -0
  322. package/scripts/hooks/claude-telemetry-hook.js +115 -0
  323. package/scripts/hooks/codex-hook-adapter.js +176 -0
  324. package/scripts/hooks/codex-telemetry-hook.js +95 -0
  325. package/scripts/hooks/config-protection.js +79 -0
  326. package/scripts/hooks/desktop-notify.sh +39 -0
  327. package/scripts/hooks/governance-audit.sh +135 -0
  328. package/scripts/hooks/lib/audit-transport.sh +40 -0
  329. package/scripts/hooks/lib/hook-flags.js +49 -0
  330. package/scripts/hooks/lib/patterns.sh +57 -0
  331. package/scripts/hooks/lib/resolve-formatter.js +80 -0
  332. package/scripts/hooks/post-edit-accumulator.js +66 -0
  333. package/scripts/hooks/pre-commit-quality.js +194 -0
  334. package/scripts/hooks/quality-gate.js +93 -0
  335. package/scripts/hooks/report-only-guard.js +21 -0
  336. package/scripts/hooks/run-hook.js +136 -0
  337. package/scripts/hooks/stop-format-typecheck.js +141 -0
  338. package/scripts/hooks/stop-goal-fit.js +337 -0
  339. package/scripts/hooks/workflow-steering.js +250 -0
  340. package/scripts/install-codex-home.sh +106 -0
  341. package/scripts/package.json +3 -0
  342. package/scripts/promote-workflow-artifact.js +2 -0
  343. package/scripts/publish-change-helper.js +2 -0
  344. package/scripts/pull-work-provider.js +2 -0
  345. package/scripts/setup-repo-hooks.sh +8 -0
  346. package/scripts/statusline/flow-agents-statusline.js +157 -0
  347. package/scripts/telemetry/console-presets.sh +14 -0
  348. package/scripts/telemetry/install-console-config.sh +214 -0
  349. package/scripts/telemetry/lib/config.sh +85 -0
  350. package/scripts/telemetry/lib/enrich.sh +115 -0
  351. package/scripts/telemetry/lib/redact.sh +22 -0
  352. package/scripts/telemetry/lib/session.sh +63 -0
  353. package/scripts/telemetry/lib/transport.sh +183 -0
  354. package/scripts/telemetry/lib/usage.sh +29 -0
  355. package/scripts/telemetry/sync-agents.sh +173 -0
  356. package/scripts/telemetry/telemetry.conf +23 -0
  357. package/scripts/telemetry/telemetry.sh +387 -0
  358. package/scripts/usage-feedback.js +2 -0
  359. package/scripts/validate-hook-influence-cases.js +2 -0
  360. package/scripts/validate-package.sh +89 -0
  361. package/scripts/validate-source-tree.js +9 -0
  362. package/skills/agentic-engineering/SKILL.md +62 -0
  363. package/skills/browser-test/SKILL.md +51 -0
  364. package/skills/builder-shape/SKILL.md +76 -0
  365. package/skills/context-budget/SKILL.md +40 -0
  366. package/skills/deliver/SKILL.md +241 -0
  367. package/skills/dependency-update/SKILL.md +68 -0
  368. package/skills/design-probe/SKILL.md +107 -0
  369. package/skills/eval-rebuild/SKILL.md +39 -0
  370. package/skills/evidence-gate/SKILL.md +186 -0
  371. package/skills/execute-plan/SKILL.md +110 -0
  372. package/skills/explore/SKILL.md +137 -0
  373. package/skills/feedback-loop/SKILL.md +87 -0
  374. package/skills/fix-bug/SKILL.md +133 -0
  375. package/skills/frontend-design/SKILL.md +80 -0
  376. package/skills/github-cli/SKILL.md +63 -0
  377. package/skills/idea-to-backlog/SKILL.md +267 -0
  378. package/skills/knowledge-capture/SKILL.md +55 -0
  379. package/skills/learning-review/SKILL.md +115 -0
  380. package/skills/pickup-probe/SKILL.md +114 -0
  381. package/skills/plan-work/SKILL.md +176 -0
  382. package/skills/pull-work/SKILL.md +309 -0
  383. package/skills/release-readiness/SKILL.md +121 -0
  384. package/skills/review-work/SKILL.md +161 -0
  385. package/skills/search-first/SKILL.md +66 -0
  386. package/skills/tdd-workflow/SKILL.md +140 -0
  387. package/skills/verify-work/SKILL.md +109 -0
  388. package/src/cli/console-learning-projection.ts +140 -0
  389. package/src/cli/effective-backlog-settings.ts +99 -0
  390. package/src/cli/fixture-retirement-audit.ts +154 -0
  391. package/src/cli/flow-kit.ts +139 -0
  392. package/src/cli/init.ts +248 -0
  393. package/src/cli/promote-workflow-artifact.ts +64 -0
  394. package/src/cli/publish-change-helper.ts +143 -0
  395. package/src/cli/pull-work-provider.ts +481 -0
  396. package/src/cli/runtime-adapter.ts +24 -0
  397. package/src/cli/telemetry-doctor.ts +243 -0
  398. package/src/cli/usage-feedback.ts +418 -0
  399. package/src/cli/validate-hook-influence.ts +119 -0
  400. package/src/cli/validate-source-tree.ts +30 -0
  401. package/src/cli/validate-workflow-artifacts.ts +411 -0
  402. package/src/cli/veritas-governance.ts +322 -0
  403. package/src/cli/workflow-artifact-cleanup-audit.ts +281 -0
  404. package/src/cli/workflow-sidecar.ts +676 -0
  405. package/src/cli.ts +95 -0
  406. package/src/flow-kit/validate.ts +74 -0
  407. package/src/lib/args.ts +43 -0
  408. package/src/lib/fs.ts +62 -0
  409. package/src/lib/workflow-learning-projection.ts +491 -0
  410. package/src/runtime-adapters.ts +154 -0
  411. package/src/tools/build-universal-bundles.ts +366 -0
  412. package/src/tools/common.ts +61 -0
  413. package/src/tools/filter-installed-packs.ts +129 -0
  414. package/src/tools/generate-context-map.ts +199 -0
  415. package/src/tools/validate-package.ts +57 -0
  416. package/src/tools/validate-source-tree.ts +488 -0
  417. package/tsconfig.json +19 -0
  418. package/veritas.claims.json +6 -0
@@ -0,0 +1,774 @@
1
+ /* Kontour design tokens — mirrors @kontourai/console-kit with the
2
+ theme-flow brand accent shared by the Kontour Flow docs site. */
3
+ :root {
4
+ color-scheme: light;
5
+ --bg: #f5f4ef;
6
+ --bg-elevated: #ffffff;
7
+ --surface: rgba(255, 255, 255, 0.88);
8
+ --surface-solid: #ffffff;
9
+ --surface-muted: #ecebe4;
10
+ --text: #202124;
11
+ --text-strong: #101114;
12
+ --muted: #5b626b;
13
+ --line: rgba(36, 40, 46, 0.14);
14
+ --line-strong: rgba(36, 40, 46, 0.26);
15
+ --accent: #1f6f88;
16
+ --accent-strong: #15546a;
17
+ --accent-soft: #ddebef;
18
+ --warn: #8a5a00;
19
+ --code-bg: #16202d;
20
+ --code-text: #eef3f8;
21
+ --shadow: 0 18px 50px -30px rgba(0, 0, 0, 0.25);
22
+ --rail-width: 284px;
23
+ --content-width: 1120px;
24
+ --display-font: "Fraunces", Georgia, serif;
25
+ --body-font: "Hanken Grotesk", ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif;
26
+ --mono-font: "IBM Plex Mono", "SFMono-Regular", Consolas, monospace;
27
+ }
28
+
29
+ :root[data-theme="dark"] {
30
+ color-scheme: dark;
31
+ --bg: #0a0e13;
32
+ --bg-elevated: #111824;
33
+ --surface: rgba(17, 24, 36, 0.88);
34
+ --surface-solid: #111824;
35
+ --surface-muted: #16202d;
36
+ --text: #eef3f8;
37
+ --text-strong: #ffffff;
38
+ --muted: #aebccb;
39
+ --line: rgba(150, 180, 210, 0.14);
40
+ --line-strong: rgba(150, 180, 210, 0.26);
41
+ --accent: #5cc4e0;
42
+ --accent-strong: #8ed8ec;
43
+ --accent-soft: #11303c;
44
+ --warn: #f3b14b;
45
+ --code-bg: #060a0f;
46
+ --code-text: #eef3f8;
47
+ --shadow: 0 26px 60px -42px rgba(0, 0, 0, 0.95);
48
+ }
49
+
50
+ * {
51
+ box-sizing: border-box;
52
+ }
53
+
54
+ html {
55
+ background: var(--bg);
56
+ }
57
+
58
+ body {
59
+ min-width: 320px;
60
+ margin: 0;
61
+ color: var(--text);
62
+ background:
63
+ linear-gradient(90deg, color-mix(in srgb, var(--line) 22%, transparent) 1px, transparent 1px) 0 0 / 44px 44px,
64
+ linear-gradient(color-mix(in srgb, var(--line) 18%, transparent) 1px, transparent 1px) 0 0 / 44px 44px,
65
+ linear-gradient(135deg, color-mix(in srgb, var(--accent-soft) 32%, transparent) 0%, transparent 34%, transparent 100%),
66
+ var(--bg);
67
+ font-family: var(--body-font);
68
+ font-size: 18px;
69
+ line-height: 1.66;
70
+ text-rendering: optimizeLegibility;
71
+ }
72
+
73
+ a {
74
+ color: var(--accent-strong);
75
+ text-decoration-color: color-mix(in srgb, var(--accent) 45%, transparent);
76
+ text-decoration-thickness: 0.08em;
77
+ text-underline-offset: 0.18em;
78
+ }
79
+
80
+ a:hover {
81
+ color: var(--accent);
82
+ }
83
+
84
+ .site-shell {
85
+ display: grid;
86
+ grid-template-columns: var(--rail-width) minmax(0, 1fr);
87
+ min-height: 100vh;
88
+ }
89
+
90
+ .site-rail {
91
+ position: sticky;
92
+ top: 0;
93
+ height: 100vh;
94
+ padding: 30px 24px;
95
+ border-right: 1px solid var(--line);
96
+ background: color-mix(in srgb, var(--surface-solid) 90%, transparent);
97
+ backdrop-filter: blur(18px);
98
+ display: flex;
99
+ flex-direction: column;
100
+ gap: 28px;
101
+ }
102
+
103
+ .brand,
104
+ .mobile-brand {
105
+ color: var(--text-strong);
106
+ text-decoration: none;
107
+ }
108
+
109
+ .brand {
110
+ display: grid;
111
+ grid-template-columns: 18px minmax(0, 1fr);
112
+ gap: 12px;
113
+ align-items: center;
114
+ }
115
+
116
+ .brand-mark {
117
+ display: block;
118
+ width: 18px;
119
+ height: 18px;
120
+ border-radius: 5px;
121
+ background: linear-gradient(135deg, var(--accent-strong), var(--accent));
122
+ box-shadow: 0 0 16px color-mix(in srgb, var(--accent) 55%, transparent);
123
+ }
124
+
125
+ .brand-name strong,
126
+ .mobile-brand strong {
127
+ color: var(--accent);
128
+ font-weight: 600;
129
+ }
130
+
131
+ .brand-name,
132
+ .brand-kicker {
133
+ display: block;
134
+ }
135
+
136
+ .brand-name {
137
+ font-family: var(--body-font);
138
+ font-size: 18px;
139
+ font-weight: 600;
140
+ line-height: 1.2;
141
+ }
142
+
143
+ .brand-kicker {
144
+ margin-top: 3px;
145
+ color: var(--muted);
146
+ font-family: var(--mono-font);
147
+ font-size: 11px;
148
+ font-weight: 500;
149
+ letter-spacing: 0;
150
+ text-transform: uppercase;
151
+ }
152
+
153
+ .doc-nav {
154
+ display: grid;
155
+ gap: 5px;
156
+ }
157
+
158
+ .doc-nav a {
159
+ display: block;
160
+ min-height: 40px;
161
+ padding: 8px 10px;
162
+ border-left: 2px solid transparent;
163
+ color: var(--muted);
164
+ font-family: var(--mono-font);
165
+ font-size: 13px;
166
+ line-height: 1.45;
167
+ text-decoration: none;
168
+ transition: background 160ms ease, border-color 160ms ease, color 160ms ease, transform 160ms ease;
169
+ }
170
+
171
+ .doc-nav a:hover {
172
+ border-left-color: var(--accent);
173
+ background: var(--accent-soft);
174
+ color: var(--text-strong);
175
+ transform: translateX(2px);
176
+ }
177
+
178
+ .theme-toggle {
179
+ margin-top: auto;
180
+ width: 100%;
181
+ display: inline-flex;
182
+ align-items: center;
183
+ justify-content: space-between;
184
+ gap: 12px;
185
+ border: 1px solid var(--line);
186
+ background: var(--surface);
187
+ color: var(--text);
188
+ padding: 10px 12px;
189
+ font-family: var(--mono-font);
190
+ font-size: 12px;
191
+ cursor: pointer;
192
+ transition: border-color 160ms ease, transform 160ms ease, background 160ms ease;
193
+ }
194
+
195
+ .theme-toggle:hover {
196
+ border-color: var(--accent);
197
+ transform: translateY(-1px);
198
+ }
199
+
200
+ .theme-toggle__track {
201
+ position: relative;
202
+ flex: 0 0 auto;
203
+ width: 42px;
204
+ height: 22px;
205
+ border: 1px solid var(--line-strong);
206
+ background: var(--surface-muted);
207
+ }
208
+
209
+ .theme-toggle__thumb {
210
+ position: absolute;
211
+ top: 3px;
212
+ left: 3px;
213
+ width: 14px;
214
+ height: 14px;
215
+ background: var(--accent);
216
+ transition: transform 180ms ease;
217
+ }
218
+
219
+ :root[data-theme="dark"] .theme-toggle__thumb {
220
+ transform: translateX(20px);
221
+ }
222
+
223
+ .doc-main {
224
+ min-width: 0;
225
+ padding: 32px clamp(18px, 5vw, 64px) 80px;
226
+ }
227
+
228
+ .doc-topbar {
229
+ display: none;
230
+ }
231
+
232
+ .doc-content {
233
+ max-width: var(--content-width);
234
+ margin: 0 auto;
235
+ padding: clamp(28px, 5vw, 58px);
236
+ border: 1px solid var(--line);
237
+ background: var(--surface);
238
+ box-shadow: var(--shadow);
239
+ }
240
+
241
+ .doc-content > :first-child {
242
+ margin-top: 0;
243
+ }
244
+
245
+ .doc-content h1,
246
+ .doc-content h2,
247
+ .doc-content h3 {
248
+ color: var(--text-strong);
249
+ font-family: var(--display-font);
250
+ font-weight: 650;
251
+ line-height: 1.06;
252
+ }
253
+
254
+ .doc-content h1 {
255
+ max-width: 760px;
256
+ margin: 0 0 22px;
257
+ padding-bottom: 18px;
258
+ border-bottom: 1px solid var(--line);
259
+ font-size: clamp(42px, 7vw, 76px);
260
+ }
261
+
262
+ .doc-content h2 {
263
+ margin: 48px 0 14px;
264
+ font-size: clamp(28px, 4vw, 42px);
265
+ }
266
+
267
+ .doc-content h3 {
268
+ margin: 34px 0 10px;
269
+ font-size: 25px;
270
+ }
271
+
272
+ .doc-content p,
273
+ .doc-content li {
274
+ max-width: 76ch;
275
+ }
276
+
277
+ .doc-content p {
278
+ margin: 0 0 18px;
279
+ }
280
+
281
+ .doc-content ul,
282
+ .doc-content ol {
283
+ margin: 0 0 24px;
284
+ padding-left: 1.15em;
285
+ }
286
+
287
+ .doc-content li + li {
288
+ margin-top: 6px;
289
+ }
290
+
291
+ .doc-content hr {
292
+ margin: 42px 0;
293
+ border: 0;
294
+ border-top: 1px solid var(--line);
295
+ }
296
+
297
+ .doc-content blockquote {
298
+ margin: 28px 0;
299
+ padding: 16px 20px;
300
+ border-left: 4px solid var(--accent);
301
+ background: var(--accent-soft);
302
+ }
303
+
304
+ .doc-content code {
305
+ padding: 0.11em 0.32em;
306
+ border: 1px solid color-mix(in srgb, var(--line) 70%, transparent);
307
+ background: var(--surface-muted);
308
+ color: var(--text-strong);
309
+ font-family: var(--mono-font);
310
+ font-size: 0.82em;
311
+ }
312
+
313
+ .doc-content pre {
314
+ margin: 24px 0;
315
+ padding: 18px;
316
+ overflow-x: auto;
317
+ border: 1px solid color-mix(in srgb, var(--line-strong) 55%, transparent);
318
+ background: var(--code-bg);
319
+ color: var(--code-text);
320
+ box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.05);
321
+ }
322
+
323
+ .doc-content pre code {
324
+ padding: 0;
325
+ border: 0;
326
+ background: transparent;
327
+ color: inherit;
328
+ font-size: 13px;
329
+ line-height: 1.6;
330
+ }
331
+
332
+ .doc-content table {
333
+ display: block;
334
+ width: 100%;
335
+ margin: 28px 0;
336
+ overflow-x: auto;
337
+ border-collapse: collapse;
338
+ font-size: 15px;
339
+ }
340
+
341
+ .doc-content th,
342
+ .doc-content td {
343
+ min-width: 160px;
344
+ padding: 10px 12px;
345
+ border: 1px solid var(--line);
346
+ vertical-align: top;
347
+ }
348
+
349
+ .doc-content th {
350
+ background: var(--surface-muted);
351
+ color: var(--text-strong);
352
+ font-family: var(--mono-font);
353
+ font-size: 12px;
354
+ font-weight: 600;
355
+ text-align: left;
356
+ text-transform: uppercase;
357
+ }
358
+
359
+ .doc-content tr:nth-child(even) td {
360
+ background: color-mix(in srgb, var(--surface-muted) 38%, transparent);
361
+ }
362
+
363
+ .mermaid {
364
+ position: relative;
365
+ width: 100%;
366
+ margin: 28px 0;
367
+ padding: 18px;
368
+ overflow-x: auto;
369
+ border: 1px solid var(--line);
370
+ background: color-mix(in srgb, var(--surface-solid) 82%, var(--accent-soft));
371
+ }
372
+
373
+ .mermaid::before {
374
+ content: "Diagram";
375
+ display: inline-block;
376
+ margin: 0 0 10px;
377
+ color: var(--muted);
378
+ font-family: var(--mono-font);
379
+ font-size: 11px;
380
+ font-weight: 600;
381
+ text-transform: uppercase;
382
+ }
383
+
384
+ .mermaid svg {
385
+ display: block;
386
+ max-width: none;
387
+ min-width: min(760px, 92vw);
388
+ height: auto;
389
+ }
390
+
391
+ .mermaid--error {
392
+ color: var(--code-text);
393
+ background: var(--code-bg);
394
+ font-family: var(--mono-font);
395
+ font-size: 13px;
396
+ line-height: 1.6;
397
+ white-space: pre;
398
+ }
399
+
400
+ .phase-map {
401
+ display: grid;
402
+ gap: 12px;
403
+ margin: 30px 0 36px;
404
+ }
405
+
406
+ .phase-row {
407
+ display: grid;
408
+ grid-template-columns: minmax(150px, 0.24fr) minmax(0, 1fr);
409
+ border: 1px solid var(--line);
410
+ background:
411
+ linear-gradient(90deg, color-mix(in srgb, var(--accent-soft) 52%, transparent), transparent 42%),
412
+ color-mix(in srgb, var(--surface-solid) 84%, transparent);
413
+ }
414
+
415
+ .phase-step {
416
+ position: relative;
417
+ display: grid;
418
+ align-content: start;
419
+ gap: 10px;
420
+ min-height: 100%;
421
+ padding: 18px 16px;
422
+ border-right: 1px solid var(--line);
423
+ background: color-mix(in srgb, var(--surface-muted) 48%, transparent);
424
+ }
425
+
426
+ .phase-step::after {
427
+ content: "";
428
+ position: absolute;
429
+ right: -6px;
430
+ top: 24px;
431
+ width: 10px;
432
+ height: 10px;
433
+ border: 1px solid var(--line-strong);
434
+ background: var(--accent);
435
+ transform: rotate(45deg);
436
+ }
437
+
438
+ .phase-step span {
439
+ display: inline-grid;
440
+ width: 38px;
441
+ height: 38px;
442
+ place-items: center;
443
+ border: 1px solid var(--line-strong);
444
+ background: var(--text-strong);
445
+ color: var(--bg-elevated);
446
+ font-family: var(--mono-font);
447
+ font-size: 13px;
448
+ font-weight: 600;
449
+ }
450
+
451
+ .phase-step strong {
452
+ color: var(--text-strong);
453
+ font-family: var(--display-font);
454
+ font-size: 25px;
455
+ font-weight: 650;
456
+ line-height: 1.05;
457
+ }
458
+
459
+ .phase-lanes {
460
+ display: grid;
461
+ grid-template-columns: minmax(150px, 0.86fr) minmax(190px, 1.08fr) minmax(240px, 1.35fr) minmax(220px, 1.22fr);
462
+ gap: 1px;
463
+ background: var(--line);
464
+ }
465
+
466
+ .phase-lane {
467
+ min-width: 0;
468
+ padding: 14px 16px 16px;
469
+ background: color-mix(in srgb, var(--surface-solid) 88%, transparent);
470
+ }
471
+
472
+ .phase-lane--primary {
473
+ background: color-mix(in srgb, var(--accent-soft) 58%, var(--surface-solid));
474
+ }
475
+
476
+ .phase-lane--gate {
477
+ background: color-mix(in srgb, var(--surface-muted) 70%, var(--surface-solid));
478
+ }
479
+
480
+ .phase-lane h3 {
481
+ margin: 0 0 8px;
482
+ color: var(--muted);
483
+ font-family: var(--mono-font);
484
+ font-size: 11px;
485
+ font-weight: 600;
486
+ line-height: 1.2;
487
+ text-transform: uppercase;
488
+ }
489
+
490
+ .phase-lane p {
491
+ max-width: none;
492
+ margin: 0;
493
+ font-size: 15px;
494
+ line-height: 1.46;
495
+ }
496
+
497
+ .phase-lane code {
498
+ display: inline-block;
499
+ margin: 2px 3px 2px 0;
500
+ white-space: nowrap;
501
+ }
502
+
503
+ .home-lede {
504
+ max-width: 780px;
505
+ margin: -4px 0 30px;
506
+ color: var(--muted);
507
+ font-size: 22px;
508
+ line-height: 1.45;
509
+ }
510
+
511
+ .doc-grid {
512
+ display: grid;
513
+ grid-template-columns: repeat(2, minmax(0, 1fr));
514
+ gap: 14px;
515
+ margin: 28px 0 36px;
516
+ }
517
+
518
+ .doc-card {
519
+ min-height: 156px;
520
+ padding: 18px;
521
+ border: 1px solid var(--line);
522
+ background: color-mix(in srgb, var(--surface-solid) 78%, transparent);
523
+ text-decoration: none;
524
+ transition: border-color 160ms ease, transform 160ms ease, box-shadow 160ms ease;
525
+ }
526
+
527
+ .doc-card:hover {
528
+ border-color: var(--accent);
529
+ box-shadow: 8px 8px 0 var(--accent-soft);
530
+ transform: translate(-2px, -2px);
531
+ }
532
+
533
+ .doc-card strong {
534
+ display: block;
535
+ margin-bottom: 8px;
536
+ color: var(--text-strong);
537
+ font-family: var(--mono-font);
538
+ font-size: 13px;
539
+ text-transform: uppercase;
540
+ }
541
+
542
+ .doc-card span {
543
+ display: block;
544
+ color: var(--muted);
545
+ font-size: 16px;
546
+ line-height: 1.45;
547
+ }
548
+
549
+ .value-grid,
550
+ .concept-strip {
551
+ display: grid;
552
+ gap: 12px;
553
+ margin: 28px 0 34px;
554
+ }
555
+
556
+ .value-grid {
557
+ grid-template-columns: repeat(3, minmax(0, 1fr));
558
+ }
559
+
560
+ .concept-strip {
561
+ grid-template-columns: repeat(3, minmax(0, 1fr));
562
+ }
563
+
564
+ .value-grid section,
565
+ .concept-strip section {
566
+ min-width: 0;
567
+ padding: 16px;
568
+ border: 1px solid var(--line);
569
+ background: color-mix(in srgb, var(--surface-solid) 76%, transparent);
570
+ }
571
+
572
+ .concept-strip section {
573
+ background: color-mix(in srgb, var(--accent-soft) 46%, var(--surface-solid));
574
+ }
575
+
576
+ .value-grid strong,
577
+ .concept-strip strong {
578
+ display: block;
579
+ margin-bottom: 7px;
580
+ color: var(--text-strong);
581
+ font-family: var(--mono-font);
582
+ font-size: 12px;
583
+ font-weight: 600;
584
+ line-height: 1.25;
585
+ text-transform: uppercase;
586
+ }
587
+
588
+ .value-grid span,
589
+ .concept-strip span {
590
+ display: block;
591
+ color: var(--muted);
592
+ font-size: 15px;
593
+ line-height: 1.42;
594
+ }
595
+
596
+ .doc-nav-external {
597
+ color: var(--accent);
598
+ }
599
+
600
+ .nav-toggle {
601
+ display: none;
602
+ flex-direction: column;
603
+ justify-content: center;
604
+ gap: 5px;
605
+ width: 44px;
606
+ height: 44px;
607
+ padding: 10px;
608
+ background: none;
609
+ border: 0;
610
+ cursor: pointer;
611
+ }
612
+
613
+ .nav-toggle span {
614
+ display: block;
615
+ height: 2px;
616
+ border-radius: 2px;
617
+ background: var(--text);
618
+ transition: transform 0.16s ease, opacity 0.16s ease;
619
+ }
620
+
621
+ .nav-toggle[aria-expanded="true"] span:nth-child(1) { transform: translateY(7px) rotate(45deg); }
622
+ .nav-toggle[aria-expanded="true"] span:nth-child(2) { opacity: 0; }
623
+ .nav-toggle[aria-expanded="true"] span:nth-child(3) { transform: translateY(-7px) rotate(-45deg); }
624
+
625
+ .nav-backdrop {
626
+ display: none;
627
+ }
628
+
629
+ .site-footer {
630
+ max-width: var(--content-width);
631
+ margin: 48px auto 0;
632
+ padding: 20px 18px 36px;
633
+ border-top: 1px solid var(--line);
634
+ color: var(--muted);
635
+ font-size: 14px;
636
+ }
637
+
638
+ @media (max-width: 860px) {
639
+ body {
640
+ font-size: 17px;
641
+ }
642
+
643
+ body.nav-open {
644
+ overflow: hidden;
645
+ }
646
+
647
+ .site-shell {
648
+ display: block;
649
+ }
650
+
651
+ .nav-toggle {
652
+ display: inline-flex;
653
+ }
654
+
655
+ .site-rail {
656
+ position: fixed;
657
+ top: 0;
658
+ bottom: 0;
659
+ left: 0;
660
+ z-index: 30;
661
+ width: min(82vw, 320px);
662
+ padding: 18px 16px max(24px, env(safe-area-inset-bottom));
663
+ background: var(--surface-solid);
664
+ border-right: 1px solid var(--line);
665
+ overflow-y: auto;
666
+ overscroll-behavior: contain;
667
+ -webkit-overflow-scrolling: touch;
668
+ transform: translateX(-105%);
669
+ transition: transform 0.2s cubic-bezier(0.22, 1, 0.36, 1);
670
+ }
671
+
672
+ .site-rail.open {
673
+ transform: translateX(0);
674
+ }
675
+
676
+ .nav-backdrop {
677
+ display: block;
678
+ position: fixed;
679
+ inset: 0;
680
+ z-index: 25;
681
+ background: rgba(0, 0, 0, 0.5);
682
+ }
683
+
684
+ .nav-backdrop[hidden] {
685
+ display: none;
686
+ }
687
+
688
+ .doc-main {
689
+ padding: 0 14px 44px;
690
+ }
691
+
692
+ .doc-topbar {
693
+ position: sticky;
694
+ top: 0;
695
+ z-index: 10;
696
+ display: flex;
697
+ align-items: center;
698
+ justify-content: space-between;
699
+ gap: 12px;
700
+ min-height: 62px;
701
+ margin: 0 -14px 14px;
702
+ padding: 10px 14px;
703
+ border-bottom: 1px solid var(--line);
704
+ background: color-mix(in srgb, var(--surface-solid) 90%, transparent);
705
+ backdrop-filter: blur(16px);
706
+ }
707
+
708
+ .mobile-brand {
709
+ font-family: var(--body-font);
710
+ font-size: 18px;
711
+ font-weight: 600;
712
+ }
713
+
714
+ .theme-toggle--compact {
715
+ width: auto;
716
+ margin: 0;
717
+ }
718
+
719
+ .doc-content {
720
+ padding: 24px 18px 36px;
721
+ }
722
+
723
+ .doc-content h1 {
724
+ font-size: clamp(38px, 14vw, 54px);
725
+ }
726
+
727
+ .doc-grid {
728
+ grid-template-columns: 1fr;
729
+ }
730
+
731
+ .value-grid,
732
+ .concept-strip {
733
+ grid-template-columns: 1fr;
734
+ }
735
+
736
+ .mermaid {
737
+ padding: 12px;
738
+ }
739
+
740
+ .mermaid::before {
741
+ content: "Diagram - scroll sideways";
742
+ }
743
+
744
+ .phase-row {
745
+ grid-template-columns: 1fr;
746
+ }
747
+
748
+ .phase-step {
749
+ border-right: 0;
750
+ border-bottom: 1px solid var(--line);
751
+ }
752
+
753
+ .phase-step::after {
754
+ right: auto;
755
+ top: auto;
756
+ bottom: -6px;
757
+ left: 24px;
758
+ }
759
+
760
+ .phase-lanes {
761
+ grid-template-columns: 1fr;
762
+ }
763
+ }
764
+
765
+ @media (prefers-reduced-motion: reduce) {
766
+ *,
767
+ *::before,
768
+ *::after {
769
+ scroll-behavior: auto !important;
770
+ transition-duration: 0.01ms !important;
771
+ animation-duration: 0.01ms !important;
772
+ animation-iteration-count: 1 !important;
773
+ }
774
+ }