@zaip-ai/cli 2.6.0 → 3.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 (312) hide show
  1. package/README.md +36 -13
  2. package/dist/services/adapters.d.ts +1 -1
  3. package/dist/services/adapters.d.ts.map +1 -1
  4. package/dist/services/adapters.js +5 -2
  5. package/dist/services/adapters.js.map +1 -1
  6. package/dist/services/agent-adapters.js +12 -9
  7. package/dist/services/agent-adapters.js.map +1 -1
  8. package/dist/services/codex-conversation-lifecycle-hook.d.ts.map +1 -1
  9. package/dist/services/codex-conversation-lifecycle-hook.js +32 -21
  10. package/dist/services/codex-conversation-lifecycle-hook.js.map +1 -1
  11. package/dist/services/install-agents-template.js +9 -1
  12. package/dist/services/install-agents-template.js.map +1 -1
  13. package/dist/services/runtime-template.test.js +25 -2
  14. package/dist/services/runtime-template.test.js.map +1 -1
  15. package/dist/services/transactional-files.d.ts.map +1 -1
  16. package/dist/services/transactional-files.js +59 -14
  17. package/dist/services/transactional-files.js.map +1 -1
  18. package/package.json +1 -1
  19. package/templates/.agents/README-ENG.md +75 -10
  20. package/templates/.agents/README.md +76 -10
  21. package/templates/.agents/config/agents/catalog.yaml +3 -0
  22. package/templates/.agents/config/agents/discovery.json +2 -2
  23. package/templates/.agents/config/clients/codex/agents/zaip-agent-analyst.toml +1 -1
  24. package/templates/.agents/config/clients/codex/agents/zaip-agent-auditor.toml +1 -1
  25. package/templates/.agents/config/clients/codex/agents/zaip-agent-backend.toml +1 -1
  26. package/templates/.agents/config/clients/codex/agents/zaip-agent-brand-strategist.toml +1 -1
  27. package/templates/.agents/config/clients/codex/agents/zaip-agent-builder.toml +1 -1
  28. package/templates/.agents/config/clients/codex/agents/zaip-agent-cloud-engineer.toml +1 -1
  29. package/templates/.agents/config/clients/codex/agents/zaip-agent-data-analyst.toml +1 -1
  30. package/templates/.agents/config/clients/codex/agents/zaip-agent-designer.toml +1 -1
  31. package/templates/.agents/config/clients/codex/agents/zaip-agent-finalizer.toml +2 -2
  32. package/templates/.agents/config/clients/codex/agents/zaip-agent-frontend.toml +1 -1
  33. package/templates/.agents/config/clients/codex/agents/zaip-agent-general-operations.toml +1 -1
  34. package/templates/.agents/config/clients/codex/agents/zaip-agent-governance-compliance.toml +1 -1
  35. package/templates/.agents/config/clients/codex/agents/zaip-agent-growth-strategist.toml +1 -1
  36. package/templates/.agents/config/clients/codex/agents/zaip-agent-integrator.toml +1 -1
  37. package/templates/.agents/config/clients/codex/agents/zaip-agent-marketing-analyst.toml +1 -1
  38. package/templates/.agents/config/clients/codex/agents/zaip-agent-orchestrator.toml +13 -10
  39. package/templates/.agents/config/clients/codex/agents/zaip-agent-refactoring-specialist.toml +1 -1
  40. package/templates/.agents/config/clients/codex/agents/zaip-agent-reviewer.toml +1 -1
  41. package/templates/.agents/config/clients/codex/agents/zaip-agent-sales-specialist.toml +1 -1
  42. package/templates/.agents/config/clients/codex/agents/zaip-agent-security-auditor.toml +1 -1
  43. package/templates/.agents/config/clients/codex/agents/zaip-agent-task-executor.toml +1 -1
  44. package/templates/.agents/config/clients/codex/agents/zaip-agent-website-developer.toml +1 -1
  45. package/templates/.agents/config/clients/codex/agents/zaip-agent-writer.toml +1 -1
  46. package/templates/.agents/config/project.yaml +10 -1
  47. package/templates/.agents/dashboard/.zaip-managed.json +274 -138
  48. package/templates/.agents/dashboard/README.md +16 -0
  49. package/templates/.agents/dashboard/apps/frontend/dist/assets/{CostCalculationGuidePage-CGxeQak4.js → CostCalculationGuidePage-CEDZjl4V.js} +1 -1
  50. package/templates/.agents/dashboard/apps/frontend/dist/assets/{DashboardHelpDialog-tzS7YxYB.js → DashboardHelpDialog-DIWDmvAS.js} +930 -550
  51. package/templates/.agents/dashboard/apps/frontend/dist/assets/{PricingSettingsDialog-DEbCi1gP.js → PricingSettingsDialog-BBRBKaHa.js} +1 -1
  52. package/templates/.agents/dashboard/apps/frontend/dist/assets/ProjectSettingsPage-B9GWkEyN.css +1 -0
  53. package/templates/.agents/dashboard/apps/frontend/dist/assets/ProjectSettingsPage-BAvLPAee.js +3 -0
  54. package/templates/.agents/dashboard/apps/frontend/dist/assets/{TraceabilityWorkspace-t1Om0Abw.js → TraceabilityWorkspace-C9dDhj34.js} +1 -1
  55. package/templates/.agents/dashboard/apps/frontend/dist/assets/cost-monitor-06__WZco.js +68 -0
  56. package/templates/.agents/dashboard/apps/frontend/dist/assets/dashboard-localization-CoAVMZN6.js +828 -0
  57. package/templates/.agents/dashboard/apps/frontend/dist/assets/{icons-vendor-DiGC-dsJ.js → icons-vendor-DEmo6Tn2.js} +1 -1
  58. package/templates/.agents/dashboard/apps/frontend/dist/assets/index-BVzw_Wux.js +2 -0
  59. package/templates/.agents/dashboard/apps/frontend/dist/assets/{react-vendor-kPO6yNed.js → react-vendor-CadYsm83.js} +1 -1
  60. package/templates/.agents/dashboard/apps/frontend/dist/assets/traceability-BzKK8kK3.js +1 -0
  61. package/templates/.agents/dashboard/apps/frontend/dist/index.html +5 -5
  62. package/templates/.agents/dashboard/apps/frontend/package.json +1 -1
  63. package/templates/.agents/dashboard/apps/frontend/src/AppDashboardContent.tsx +10 -5
  64. package/templates/.agents/dashboard/apps/frontend/src/AutonomySettings.tsx +82 -0
  65. package/templates/.agents/dashboard/apps/frontend/src/ProjectSettingsPage.dom.test.ts +38 -7
  66. package/templates/.agents/dashboard/apps/frontend/src/ProjectSettingsPage.tsx +164 -171
  67. package/templates/.agents/dashboard/apps/frontend/src/__tests__/app-composition-support.ts +6 -1
  68. package/templates/.agents/dashboard/apps/frontend/src/cost-monitor-population.test.tsx +149 -0
  69. package/templates/.agents/dashboard/apps/frontend/src/dashboard-api-settings.ts +2 -1
  70. package/templates/.agents/dashboard/apps/frontend/src/dashboard-api.test.ts +19 -0
  71. package/templates/.agents/dashboard/apps/frontend/src/dashboard-api.ts +22 -1
  72. package/templates/.agents/dashboard/apps/frontend/src/dashboard-cost-facts.test.ts +54 -0
  73. package/templates/.agents/dashboard/apps/frontend/src/dashboard-cost-facts.ts +20 -2
  74. package/templates/.agents/dashboard/apps/frontend/src/dashboard-localization.test.ts +37 -43
  75. package/templates/.agents/dashboard/apps/frontend/src/dashboard-localization.ts +9 -251
  76. package/templates/.agents/dashboard/apps/frontend/src/dashboard-project-overview.ts +34 -7
  77. package/templates/.agents/dashboard/apps/frontend/src/dashboard-view-actions.test.ts +51 -0
  78. package/templates/.agents/dashboard/apps/frontend/src/dashboard-view-actions.ts +3 -1
  79. package/templates/.agents/dashboard/apps/frontend/src/operations-period-render.test.ts +35 -0
  80. package/templates/.agents/dashboard/apps/frontend/src/operations-period.test.ts +19 -4
  81. package/templates/.agents/dashboard/apps/frontend/src/operations-period.ts +5 -3
  82. package/templates/.agents/dashboard/apps/frontend/src/project-installation-status.test.ts +112 -23
  83. package/templates/.agents/dashboard/apps/frontend/src/project-installation-status.ts +49 -12
  84. package/templates/.agents/dashboard/apps/frontend/src/project-settings-copy.ts +181 -0
  85. package/templates/.agents/dashboard/apps/frontend/src/project-settings-model.ts +11 -1
  86. package/templates/.agents/dashboard/apps/frontend/src/project-settings-page.css +34 -51
  87. package/templates/.agents/dashboard/apps/frontend/src/project-settings-state.css +55 -0
  88. package/templates/.agents/dashboard/apps/frontend/src/project-settings.test.ts +12 -0
  89. package/templates/.agents/dashboard/apps/frontend/src/snapshot-coherence.test.ts +1 -1
  90. package/templates/.agents/dashboard/apps/frontend/src/traceability-task-pagination.ts +1 -2
  91. package/templates/.agents/dashboard/apps/frontend/src/use-app-cost-loaders.test.ts +6 -0
  92. package/templates/.agents/dashboard/apps/frontend/src/use-app-cost-loaders.ts +2 -0
  93. package/templates/.agents/dashboard/apps/frontend/src/use-app-trace-documents.ts +3 -1
  94. package/templates/.agents/dashboard/apps/frontend/src/use-app-trace-task-pagination.ts +4 -15
  95. package/templates/.agents/dashboard/apps/frontend/src/use-dashboard-app-model.tsx +2 -2
  96. package/templates/.agents/dashboard/modules/cost-monitor/package.json +1 -1
  97. package/templates/.agents/dashboard/modules/cost-monitor/src/complete-cost-average.test.ts +73 -0
  98. package/templates/.agents/dashboard/modules/cost-monitor/src/contracts.ts +9 -0
  99. package/templates/.agents/dashboard/modules/cost-monitor/src/period-averages.ts +60 -0
  100. package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostMonitorContent.tsx +8 -22
  101. package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostMonitorPage.tsx +2 -3
  102. package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostPeriodAverageCards.tsx +32 -8
  103. package/templates/.agents/dashboard/modules/cost-monitor/src/react/cost-monitor-summary.ts +3 -2
  104. package/templates/.agents/dashboard/modules/cost-monitor/src/react/period-cost-groups.ts +1 -42
  105. package/templates/.agents/dashboard/modules/cost-monitor/src/react/use-cost-group-page.ts +2 -1
  106. package/templates/.agents/dashboard/modules/cost-monitor/src/server/build-cost-monitor-projection.ts +3 -2
  107. package/templates/.agents/dashboard/modules/cost-monitor/src/server/build-cost-summary-projection.ts +8 -2
  108. package/templates/.agents/dashboard/modules/cost-monitor/src/server/index.ts +1 -0
  109. package/templates/.agents/dashboard/modules/operations/package.json +1 -1
  110. package/templates/.agents/dashboard/modules/operations/src/react/OperationsOverview-keeps-structure-classes-mutually-exclusive.test.ts +4 -3
  111. package/templates/.agents/dashboard/modules/operations/src/react/OperationsOverview.helpers.tsx +66 -3
  112. package/templates/.agents/dashboard/modules/operations/src/react/OperationsOverview.test.ts +71 -1
  113. package/templates/.agents/dashboard/modules/operations/src/react/OperationsOverview.tsx +36 -30
  114. package/templates/.agents/dashboard/modules/operations/src/react/OperationsPage.tsx +5 -14
  115. package/templates/.agents/dashboard/modules/operations/src/react/OperationsPageOverview.tsx +3 -0
  116. package/templates/.agents/dashboard/modules/operations/src/react/OverviewCostKpi.tsx +46 -0
  117. package/templates/.agents/dashboard/modules/operations/src/react/UnifiedWorkList.test.ts +28 -1
  118. package/templates/.agents/dashboard/modules/operations/src/react/UnifiedWorkList.tsx +11 -4
  119. package/templates/.agents/dashboard/modules/operations/src/react/index.ts +1 -0
  120. package/templates/.agents/dashboard/modules/operations/src/react/operations-coverage-toast.test.ts +2 -2
  121. package/templates/.agents/dashboard/modules/operations/src/react/operations-overview-period-filter.test.ts +28 -8
  122. package/templates/.agents/dashboard/modules/operations/src/react/operations-page-contract.ts +19 -2
  123. package/templates/.agents/dashboard/modules/operations/src/react/overview-cost-card.test.tsx +89 -0
  124. package/templates/.agents/dashboard/modules/operations/src/react/work-board-model.test.ts +3 -3
  125. package/templates/.agents/dashboard/modules/operations/src/work-board-model.ts +2 -1
  126. package/templates/.agents/dashboard/modules/traceability/package.json +1 -1
  127. package/templates/.agents/dashboard/packages/branding/package.json +1 -1
  128. package/templates/.agents/dashboard/packages/contracts/package.json +1 -1
  129. package/templates/.agents/dashboard/packages/data-export/package.json +1 -1
  130. package/templates/.agents/dashboard/packages/local-runtime/dist/server.cjs +279 -245
  131. package/templates/.agents/dashboard/packages/local-runtime/dist/sqlite-read-model.cjs +247 -215
  132. package/templates/.agents/dashboard/packages/local-runtime/package.json +2 -2
  133. package/templates/.agents/dashboard/packages/local-runtime/scripts/build-sqlite-runtime.mjs +15 -25
  134. package/templates/.agents/dashboard/packages/local-runtime/server.mjs +279 -245
  135. package/templates/.agents/dashboard/packages/local-runtime/src/active-codex-telemetry.ts +1 -1
  136. package/templates/.agents/dashboard/packages/local-runtime/src/project-installation-summary.test.ts +142 -0
  137. package/templates/.agents/dashboard/packages/local-runtime/src/project-installation-summary.ts +190 -0
  138. package/templates/.agents/dashboard/packages/local-runtime/src/project-settings.test.ts +65 -0
  139. package/templates/.agents/dashboard/packages/local-runtime/src/project-settings.ts +67 -66
  140. package/templates/.agents/dashboard/packages/local-runtime/src/server-browser-lease.test.ts +91 -0
  141. package/templates/.agents/dashboard/packages/local-runtime/src/server-browser-lease.ts +24 -4
  142. package/templates/.agents/dashboard/packages/local-runtime/src/server-hono-security.test.ts +17 -0
  143. package/templates/.agents/dashboard/packages/local-runtime/src/server-operations-routes.ts +21 -2
  144. package/templates/.agents/dashboard/packages/local-runtime/src/server-snapshot-refresh.test.ts +94 -2
  145. package/templates/.agents/dashboard/packages/local-runtime/src/server-snapshot-refresh.ts +62 -12
  146. package/templates/.agents/dashboard/packages/local-runtime/src/server-snapshot-synchronization.test.ts +26 -0
  147. package/templates/.agents/dashboard/packages/local-runtime/src/server-snapshot-synchronization.ts +4 -1
  148. package/templates/.agents/dashboard/packages/local-runtime/src/server-sqlite-task-trace.test.ts +97 -0
  149. package/templates/.agents/dashboard/packages/local-runtime/src/server-sqlite-task-trace.ts +10 -13
  150. package/templates/.agents/dashboard/packages/local-runtime/src/server-trace-routes.ts +2 -10
  151. package/templates/.agents/dashboard/packages/local-runtime/src/server-traceability-index.test.ts +84 -0
  152. package/templates/.agents/dashboard/packages/local-runtime/src/server.ts +15 -1
  153. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-calendar.ts +17 -0
  154. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-cold-parse.test.ts +78 -0
  155. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-cost-dimension-facts.test.ts +12 -1
  156. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-cost-group-projection.test.ts +94 -0
  157. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-cost-group-projection.ts +5 -5
  158. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-duration-lookup.test.ts +59 -0
  159. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-entity-label-views.test.ts +72 -0
  160. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-file-index.test.ts +69 -0
  161. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-first-fold-cache.ts +3 -1
  162. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-force-canonical.test.ts +3 -1
  163. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-incremental-refresh.test.ts +2 -0
  164. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-materialize-projections.ts +9 -0
  165. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-materialize-runs.ts +4 -5
  166. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-period-averages.ts +46 -0
  167. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-provider-alias-parity.test.ts +50 -0
  168. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-entity-group.test.ts +171 -0
  169. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-entity-group.ts +36 -16
  170. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-filtered-dimension.ts +13 -2
  171. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-summary.ts +25 -7
  172. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-temporal-dimension.ts +2 -0
  173. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-canonical-parsing.ts +7 -0
  174. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-canonical.ts +5 -15
  175. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-counts-every-root-execution-day-returns.test.ts +34 -10
  176. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-filesystem.ts +17 -3
  177. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-keeps-orphan-telemetry-out-kanban-without.test.ts +1 -1
  178. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-rebuild.ts +11 -0
  179. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-schema.ts +5 -4
  180. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-source-fingerprint.test.ts +54 -1
  181. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-source-fingerprint.ts +7 -3
  182. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model.test.ts +4 -1
  183. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-risk-population.test.ts +98 -0
  184. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-schema-base-views.ts +29 -16
  185. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-schema-dashboard-views.ts +2 -1
  186. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-snapshot-seed.test.ts +2 -0
  187. package/templates/.agents/dashboard/packages/local-runtime/src/verify-project-settings.mjs +57 -0
  188. package/templates/.agents/dashboard/packages/ui/package.json +1 -1
  189. package/templates/.agents/dashboard/scripts/qualify-observability.mjs +130 -0
  190. package/templates/.agents/dashboard/scripts/verify-autonomy-settings.mjs +175 -0
  191. package/templates/.agents/dashboard/scripts/verify-observability.mjs +254 -0
  192. package/templates/.agents/dashboard/scripts/verify-project-setup.mjs +64 -0
  193. package/templates/.agents/dashboard/tests/e2e/lease-global-setup.ts +37 -0
  194. package/templates/.agents/dashboard/tests/e2e/package.json +1 -1
  195. package/templates/.agents/dashboard/tests/e2e/playwright.config.ts +5 -3
  196. package/templates/.agents/dashboard/tests/e2e/specs/cost-monitor-period-transition.spec.ts +22 -1
  197. package/templates/.agents/dashboard/tests/e2e/specs/dashboard-performance-matrix.spec.ts +17 -8
  198. package/templates/.agents/dashboard/tests/e2e/specs/dashboard.spec.ts +47 -6
  199. package/templates/.agents/dashboard/tests/e2e/specs/lease-lifetime.spec.ts +14 -0
  200. package/templates/.agents/dashboard/tests/observability-fixture.mjs +200 -0
  201. package/templates/.agents/design/.zaip-managed.json +84 -40
  202. package/templates/.agents/design/apps/catalog/dist/assets/index-BJV597iq.js +72 -0
  203. package/templates/.agents/design/apps/catalog/dist/assets/index-BOjCcUaU.js +72 -0
  204. package/templates/.agents/design/apps/catalog/dist/assets/index-B_WhrCZe.js +72 -0
  205. package/templates/.agents/design/apps/catalog/dist/assets/index-CqtYXZfV.js +72 -0
  206. package/templates/.agents/design/apps/catalog/dist/assets/index-D_lfqoyx.js +72 -0
  207. package/templates/.agents/design/apps/catalog/dist/assets/index-i_PO2k9R.js +9 -0
  208. package/templates/.agents/design/apps/catalog/dist/index.html +1 -1
  209. package/templates/.agents/design/apps/catalog/dist/storybook/assets/CatalogShell-Cstn1UwA.js +1 -0
  210. package/templates/.agents/design/apps/catalog/dist/storybook/assets/{Color-6AOWCN3U-B-kAgAjB.js → Color-6AOWCN3U-Cm-yJJz_.js} +1 -1
  211. package/templates/.agents/design/apps/catalog/dist/storybook/assets/Components.stories-D1WopB2L.js +137 -0
  212. package/templates/.agents/design/apps/catalog/dist/storybook/assets/DesignSystem.stories-DQ9PJ3N3.js +1 -0
  213. package/templates/.agents/design/apps/catalog/dist/storybook/assets/{DocsRenderer-JROSPFPF-BVN7xHtv.js → DocsRenderer-JROSPFPF-Belk4jRr.js} +4 -4
  214. package/templates/.agents/design/apps/catalog/dist/storybook/assets/{WithTooltip-7X4HQR7L-CDHtKYkz.js → WithTooltip-7X4HQR7L-DoPvjkS1.js} +1 -1
  215. package/templates/.agents/design/apps/catalog/dist/storybook/assets/{chunk-DRQKCCAG-D6AsDkMK.js → chunk-DRQKCCAG-B1itKXEN.js} +1 -1
  216. package/templates/.agents/design/apps/catalog/dist/storybook/assets/{chunk-W22LQPXL-B4m5uloN.js → chunk-W22LQPXL-C-Eb5SPY.js} +1 -1
  217. package/templates/.agents/design/apps/catalog/dist/storybook/assets/{components-CN8YyTUg.js → components-DnyKLwhj.js} +5 -5
  218. package/templates/.agents/design/apps/catalog/dist/storybook/assets/formatter-L2YTDE3Q-D0OSgxWz.js +1 -0
  219. package/templates/.agents/design/apps/catalog/dist/storybook/assets/{iframe-9yZfIsdT.js → iframe-DcXBsFPz.js} +3 -3
  220. package/templates/.agents/design/apps/catalog/dist/storybook/assets/{react-18-BoCSnq6H.js → react-18-CRM89QRf.js} +1 -1
  221. package/templates/.agents/design/apps/catalog/dist/storybook/assets/react-C3tkVMIp.js +1 -0
  222. package/templates/.agents/design/apps/catalog/dist/storybook/assets/{syntaxhighlighter-YFXUGROL-Bnn_nMwJ.js → syntaxhighlighter-YFXUGROL-B03jQGTF.js} +1 -1
  223. package/templates/.agents/design/apps/catalog/dist/storybook/assets/{theming-DS_ue2sb.js → theming-4ZyufAga.js} +1 -1
  224. package/templates/.agents/design/apps/catalog/dist/storybook/iframe.html +1 -1
  225. package/templates/.agents/design/apps/catalog/dist/storybook/index.json +1 -1
  226. package/templates/.agents/design/apps/catalog/package.json +2 -2
  227. package/templates/.agents/design/apps/catalog/src/components/AutonomySpecimen.tsx +15 -0
  228. package/templates/.agents/design/apps/catalog/src/components/CostPopulationSpecimen.test.tsx +19 -0
  229. package/templates/.agents/design/apps/catalog/src/components/CostPopulationSpecimen.tsx +45 -0
  230. package/templates/.agents/design/apps/catalog/src/components/EstimatedCostSpecimen.tsx +48 -0
  231. package/templates/.agents/design/apps/catalog/src/components/ProjectStatusSpecimen.tsx +169 -0
  232. package/templates/.agents/design/apps/catalog/src/pages/ComponentsPage.tsx +55 -0
  233. package/templates/.agents/design/apps/catalog/src/stories/Components.stories.tsx +60 -0
  234. package/templates/.agents/design/packages/local-runtime/package.json +1 -1
  235. package/templates/.agents/requirements/autonomous-assurance.md +1 -1
  236. package/templates/.agents/requirements/cloud-hostinger-autonomy.md +1 -1
  237. package/templates/.agents/requirements/comparative-audit.md +1 -1
  238. package/templates/.agents/requirements/context-engine.md +1 -1
  239. package/templates/.agents/requirements/cost-observability.md +1 -1
  240. package/templates/.agents/requirements/dashboard-launch.md +1 -1
  241. package/templates/.agents/requirements/data-export.md +1 -1
  242. package/templates/.agents/requirements/design-system.md +1 -1
  243. package/templates/.agents/requirements/execution-engine.md +1 -1
  244. package/templates/.agents/requirements/kanban-dashboard.md +1 -1
  245. package/templates/.agents/requirements/model-orchestration.md +1 -1
  246. package/templates/.agents/requirements/public-distribution.md +1 -1
  247. package/templates/.agents/requirements/software-architecture.md +1 -1
  248. package/templates/.agents/requirements/strategic-improvements.md +1 -1
  249. package/templates/.agents/requirements/work-lifecycle.md +5 -5
  250. package/templates/.agents/requirements/zaip-strategic-95.md +1 -1
  251. package/templates/.agents/rules/astra-diagnostic.md +3 -1
  252. package/templates/.agents/rules/autonomy-decision.md +10 -2
  253. package/templates/.agents/rules/core.md +12 -1
  254. package/templates/.agents/rules/run-lifecycle-closure.md +8 -6
  255. package/templates/.agents/rules/workflow.md +2 -2
  256. package/templates/.agents/runtime/VERSION +1 -1
  257. package/templates/.agents/runtime/bin/zaip.mjs +383 -350
  258. package/templates/.agents/runtime/checksums.sha256 +6 -6
  259. package/templates/.agents/runtime/manifest.json +1 -1
  260. package/templates/.agents/runtime/pnpm-lock.sha256 +1 -1
  261. package/templates/.agents/runtime/provenance.json +5 -5
  262. package/templates/.agents/runtime/sbom.cdx.json +3 -3
  263. package/templates/.agents/skills/zaip-skill-dev-environment/SKILL.md +2 -0
  264. package/templates/.agents/skills/zaip-skill-execution/SKILL.md +28 -5
  265. package/templates/.agents/skills/zaip-skill-execution/references/runtime-governance.md +17 -3
  266. package/templates/.agents/skills/zaip-skill-github-deploy/SKILL.md +8 -9
  267. package/templates/.agents/skills/zaip-skill-github-deploy/references/deployment-workflow.md +10 -6
  268. package/templates/.agents/skills/zaip-skill-github-deploy/references/release-identity.md +17 -12
  269. package/templates/.agents/skills/zaip-skill-move-prd/SKILL.md +2 -0
  270. package/templates/.agents/skills/zaip-skill-prd/SKILL.md +2 -0
  271. package/templates/.agents/skills/zaip-skill-release-qualification/SKILL.md +21 -23
  272. package/templates/.agents/skills/zaip-skill-release-qualification/references/local-preparation.md +37 -13
  273. package/templates/.agents/skills/zaip-skill-setup/SKILL.md +2 -0
  274. package/templates/.agents/skills/zaip-skill-tool-setup/SKILL.md +2 -0
  275. package/templates/.agents/zaip-aios/INDEX.md +9 -1
  276. package/templates/.agents/zaip-aios/README.md +24 -2
  277. package/templates/.agents/zaip-aios/VERSION +1 -1
  278. package/templates/.agents/zaip-aios/guides/01-primeiros-passos.md +5 -1
  279. package/templates/.agents/zaip-aios/guides/03-tasks.md +15 -2
  280. package/templates/.agents/zaip-aios/guides/04-specs.md +13 -0
  281. package/templates/.agents/zaip-aios/guides/05-prds.md +13 -0
  282. package/templates/.agents/zaip-aios/guides/06-execucao.md +19 -4
  283. package/templates/.agents/zaip-aios/guides/07-revisao-e-validacao.md +14 -0
  284. package/templates/.agents/zaip-aios/guides/08-contexto-e-tokens.md +4 -3
  285. package/templates/.agents/zaip-aios/guides/09-agentes-e-squads.md +17 -9
  286. package/templates/.agents/zaip-aios/guides/10-seguranca.md +9 -0
  287. package/templates/.agents/zaip-aios/guides/11-observabilidade-e-custos.md +69 -0
  288. package/templates/.agents/zaip-aios/guides/12-instalacao-e-upgrade.md +9 -4
  289. package/templates/.agents/zaip-aios/guides/13-boas-praticas.md +7 -1
  290. package/templates/.agents/zaip-aios/guides/14-troubleshooting.md +18 -0
  291. package/templates/.agents/zaip-aios/guides/16-lifecycle-e-reconciliacao.md +54 -3
  292. package/templates/.agents/zaip-aios/guides/18-catalogo-de-agentes.md +10 -2
  293. package/templates/.agents/zaip-aios/guides/19-assurance-e-autonomia.md +186 -5
  294. package/templates/.agents/zaip-aios/guides/20-instalacao-detalhada.md +21 -15
  295. package/templates/.agents/zaip-aios/guides/21-telemetria-monitor-custos.md +18 -2
  296. package/templates/.agents/zaip-aios/guides/22-fluxos-e-roteamento.md +14 -2
  297. package/templates/.agents/zaip-aios/guides/23-orquestracao-de-modelos.md +190 -489
  298. package/templates/.agents/zaip-aios/guides/26-qualidade-e-release.md +72 -13
  299. package/templates/.agents/zaip-aios/guides/27-telemetria-git-native.md +18 -0
  300. package/templates/.agents/zaip-aios/guides/28-lifecycle-completo.md +18 -1
  301. package/templates/template-manifest.json +454 -274
  302. package/templates/.agents/dashboard/apps/frontend/dist/assets/ProjectSettingsPage-1L7Qw-Gq.js +0 -3
  303. package/templates/.agents/dashboard/apps/frontend/dist/assets/ProjectSettingsPage-EInWr641.css +0 -1
  304. package/templates/.agents/dashboard/apps/frontend/dist/assets/cost-monitor-B6aZfo5f.js +0 -68
  305. package/templates/.agents/dashboard/apps/frontend/dist/assets/dashboard-localization-CLJ0lT9v.js +0 -231
  306. package/templates/.agents/dashboard/apps/frontend/dist/assets/index-DgTmNHN5.js +0 -2
  307. package/templates/.agents/dashboard/apps/frontend/dist/assets/traceability-DQpKX9c1.js +0 -1
  308. package/templates/.agents/design/apps/catalog/dist/storybook/assets/CatalogShell-BWY-80s4.js +0 -1
  309. package/templates/.agents/design/apps/catalog/dist/storybook/assets/Components.stories-Be2mDUQj.js +0 -27
  310. package/templates/.agents/design/apps/catalog/dist/storybook/assets/DesignSystem.stories-DRx9blDs.js +0 -1
  311. package/templates/.agents/design/apps/catalog/dist/storybook/assets/formatter-L2YTDE3Q-EwuTh8Zk.js +0 -1
  312. package/templates/.agents/design/apps/catalog/dist/storybook/assets/react-DyL61NPT.js +0 -1
@@ -1,6 +1,179 @@
1
- # Assurance adaptativa e autonomia opt-in
1
+ # Assurance adaptativa e perfis de autonomia
2
2
 
3
- O ZAIP-AIOS separa duas decisões que não devem ser confundidas: quanto de prova uma entrega exige e quem executa a DAG. A primeira é governada por `assurance`; a segunda por `execution`. O modo manual continua sendo o padrão seguro e econômico.
3
+ Este guia descreve `autonomy-v1`, implementado nas fontes em preparação para a
4
+ v3. Não significa que `@latest` já distribua essas mudanças ou que a release
5
+ esteja qualificada. Confira a versão instalada e o caminho de execução.
6
+
7
+ ## Quatro configurações independentes
8
+
9
+ | Controle | Valores | O que decide |
10
+ | --- | --- | --- |
11
+ | Instalação | `full`, `dev-lite`, `lite` | Ferramentas instaladas, não orçamento de IA |
12
+ | Assurance | risco `lite`, `standard`, `critical` e sinais persistidos | Provas necessárias para aceitar a entrega |
13
+ | Autonomia | `essential`, `balanced`, `persistent` | Persistência e replanejamento por Task |
14
+ | Runtime | `manual`, `managed` ou `autonomous` | Sem provider, PRD/SPEC gerenciados ou também Task gerenciada explícita |
15
+
16
+ `model_orchestration` é a política de seleção, não o botão de ativação do
17
+ runtime. Salvar um preset não inicia uma Task, não altera o seletor do Codex e
18
+ não concede permissão externa.
19
+
20
+ ## Perfis por Task
21
+
22
+ | Perfil | Execuções máximas | Replanejamentos máximos | Rota dos replanejamentos |
23
+ | --- | --- | --- | --- |
24
+ | Essencial (`essential`) | **4**: 1 inicial + 3 reparações | **1** | Sol/high; nunca Astra automático |
25
+ | Equilibrado (`balanced`, padrão novo) | **10**: 1 inicial + 9 reparações | **3** | Sol/high → Astra/high → Astra/high |
26
+ | Persistente (`persistent`, opt-in) | **Sem teto** | **Sem teto** | Sol/high primeiro; Astra/high nos seguintes |
27
+
28
+ Cada replanejamento válido libera até três reparações. São tetos, não uma
29
+ obrigação de falhar ou gastar todas as tentativas. Se o aceite passar antes,
30
+ siga para revisão e fechamento. No Equilibrado não existe quarto
31
+ replanejamento; no Persistente não existe teto oculto de 10, 24 ou três planos.
32
+
33
+ Exemplo máximo do Equilibrado:
34
+
35
+ 1. Execução inicial: tentativa 1.
36
+ 2. Replanejamento 1 com Sol/high: reparações nas tentativas 2–4.
37
+ 3. Replanejamento 2 com Astra/high: reparações nas tentativas 5–7.
38
+ 4. Replanejamento 3 com Astra/high: reparações nas tentativas 8–10; Astra/high
39
+ também pode executar nesse bloco, se selecionado pela rota válida.
40
+ 5. Sem aceite, registrar entrega parcial e resultado verdadeiro; não abrir
41
+ outra rodada gratuita.
42
+
43
+ Uma SPEC com dez Tasks Equilibradas admite até **100 execuções** (10 iniciais
44
+ + 90 reparações) e **30 replanejamentos**. A quota pertence a cada Task estável,
45
+ não ao PRD, à SPEC, à Execution ou ao subagente. Calls internas, ferramentas,
46
+ testes individuais, revisões e finalização não são dez execuções de produto:
47
+ o teto não significa dez chamadas totais ao modelo.
48
+
49
+ Persistente pode continuar indefinidamente e consumir créditos até
50
+ cancelamento humano; fica desligado por padrão. Não promete ultrapassar
51
+ indisponibilidade do host, falta de autorização, segurança ou ausência de prova.
52
+
53
+ ## Configurar no projeto e no Dashboard
54
+
55
+ Mescle este bloco na raiz de `.agents/config/project.yaml`, sem substituir
56
+ as demais configurações:
57
+
58
+ ```yaml
59
+ autonomy:
60
+ version: 1
61
+ preset: balanced
62
+ ```
63
+
64
+ No Dashboard, abra **Configurações do projeto**, escolha **Perfil de autonomia**
65
+ e salve. A UI explica os limites e o consumo potencial do Persistente; API e
66
+ YAML usam a mesma enumeração. Recarregue e confira o valor persistido.
67
+ `essential` e `persistent` são as outras escolhas válidas. Não invente campos
68
+ para alterar cotas ou modelos da tabela: o schema desse bloco é estrito.
69
+
70
+ A mudança vale para **novas Tasks**. Tasks já iniciadas conservam seu perfil e
71
+ consumo. Projetos antigos sem `autonomy` conservam comportamento legado;
72
+ selecionar/salvar um perfil não migra silenciosamente estados já materializados.
73
+
74
+ ## Contagem determinística e recuperação
75
+
76
+ O coordenador gerenciado reserva a operação **antes** de chamar o provider em
77
+ `.local/autonomous/recovery/<hash-da-task>/ledger.json`. O diário é durável,
78
+ privado e vinculado à Task, com escrita exclusiva e transições idempotentes.
79
+ Não é cache descartável nem deve ser removido para liberar uma nova tentativa.
80
+
81
+ - Reinício, nova Execution, `resume`, `rework` ou alteração do YAML não zeram
82
+ esse consumo. O `attempt_count` do lifecycle não substitui o diário de
83
+ tentativas/replanejamentos do coordenador.
84
+ - Replay compatível reutiliza a reserva; resultado conflitante é rejeitado.
85
+ Resultado desconhecido permanece pendente até recuperação observável.
86
+ - Replanejamento inválido consome sua reserva e não autoriza reparação de
87
+ produto. Pode consumir o orçamento antes de alcançar dez execuções.
88
+ - O relógio, tokens, contagem de testes e `budget.soft_cycles` não calculam
89
+ tentativas. Tempo continua útil para diagnóstico, não para desistir da Task.
90
+ - Timeout de comando, lease, lock ou ausência de resposta do provider é um
91
+ problema operacional a investigar; não prova defeito do produto.
92
+ - Preserve logs sanitizados e a hipótese já tentada; não repita testes caros
93
+ inalterados apenas por demora, nem diminua ACs para obter aprovação.
94
+
95
+ ## Tarefas avulsas e modelos
96
+
97
+ A Task avulsa prioriza execução direta com o modelo/esforço escolhido pelo
98
+ usuário. Exemplo: Astra/ultra manual no principal não é uma escalada automática.
99
+ No Essencial essa é a única exceção Astra: não se estende a filhos, herança ou
100
+ fallback.
101
+
102
+ Delegação só por necessidade concreta, como especialidade, isolamento ou
103
+ revisão/finalização exigida. Antes de delegar, informe que a orquestração ZAIP
104
+ pode selecionar modelo/esforço diferentes para os subagentes. Não prometa que
105
+ filhos usam Astra só porque o usuário selecionou Astra no principal.
106
+ A configuração efetivamente observada permanece separada da planejada.
107
+
108
+ O replanejador recebe contexto delimitado e não implementa produto. Fora do
109
+ Essencial, Astra/high torna-se elegível como **executor a partir do terceiro
110
+ replanejamento**, sem ampliar escopo, autoridade ou orçamento. Ele não
111
+ substitui revisão independente nem Gui. Veja o [guia 23](23-orquestracao-de-modelos.md).
112
+
113
+ ## Quando continuar e quando encerrar
114
+
115
+ | Situação após recuperação aplicável | Resultado |
116
+ | --- | --- |
117
+ | Resultado, ACs, gates e evidências suficientes | `completed`, após fechamento canônico |
118
+ | Falta de verificação, evidência, acesso, decisão ou conclusão segura | `blocked`, com condição objetiva de retomada |
119
+ | Impedimento técnico ou de integridade comprovado | `failed`, com causa e rework necessário |
120
+ | Pedido humano explícito para cancelar | `cancelled` |
121
+
122
+ Não reduza critérios de aceite ao esgotar tentativas. Preserve o que foi feito,
123
+ liste ACs sem prova e informe quantas execuções/replanejamentos ocorreram.
124
+ “Falhou após três replanejamentos” só é correto com causa técnica comprovada;
125
+ sem prova suficiente o resultado é bloqueado. Tempo decorrido não escolhe
126
+ entre esses estados.
127
+
128
+ Na DAG, continue ramos independentes elegíveis; não execute dependentes de
129
+ Task não concluída nem entregue o macro sem seus gates. Uma Task bloqueada
130
+ não deve causar repetição de Tasks já concluídas.
131
+
132
+ ## Limites atuais e adoção
133
+
134
+ A garantia de contagem/modelo vale **no despacho gerenciado**, antes da
135
+ invocação. `spawn_agent` chamado diretamente pelo Codex fora desse caminho
136
+ não é interceptado por prompt, hook best-effort ou captura posterior.
137
+ Sem observar o caminho real, não alegue controle determinístico universal.
138
+
139
+ Novos projetos usam Equilibrado e `execution.runtime: managed`: PRDs/SPECs
140
+ passam pelo executor gerenciado e avulsas permanecem diretas. `manual` e
141
+ configuração legada ausente continuam sem provider. `autonomous` permite
142
+ também Task avulsa gerenciada por comando explícito. Salvar não executa.
143
+
144
+ A captura direta usa `conversation start ... --direct-authorization REFERÊNCIA`
145
+ ou `run start` com a mesma opção, somente para raiz de delivery atribuída a
146
+ Task/Change/Execution e turno/modelo observados. O contrato fica imutável no
147
+ início; não converte raízes antigas nem cria executor fictício. Gui, Evidence,
148
+ revisão aplicável e sua barreira continuam obrigatórios. O [guia 16](16-lifecycle-e-reconciliacao.md) descreve o relay.
149
+
150
+ Migração explícita: `task migrate-autonomy TASK --execution EXEC --expected-revision N
151
+ --legacy-attempts N --legacy-replans N --reason MOTIVO` mostra o preview;
152
+ acrescente `--confirm` somente após revisar a contagem histórica. Exige Task
153
+ inativa, inventário de Runs terminado, contagens não inferiores ao histórico
154
+ observado e motivo. Preserva registros, estados e Evidence; congela o diário
155
+ durável por Task. Não reaproveita planos antigos como autorização atual: exige
156
+ novo plano dentro da quota restante. Se a quota acabou, continua esgotada.
157
+
158
+ Se o número histórico de replanejamentos não foi registrado, use
159
+ `--legacy-replans unknown --future-replans N` com uma concessão humana explícita
160
+ dentro do preset (até 3 no Equilibrado). O total histórico permanece desconhecido;
161
+ `N` limita somente os replanejamentos futuros. `--legacy-attempts N` continua
162
+ preservando as execuções já consumidas: a concessão não reinicia o limite de dez.
163
+ No Persistente, `--future-replans unlimited` exige a escolha explícita desse perfil.
164
+
165
+ Não há economia financeira garantida pelos presets. Compare custo/tokens por
166
+ Task aceita com cobertura real, incluindo reparos, revisão e replanejamento.
167
+ Testes simulados de modelos não comprovam cobrança nem execução paga no host.
168
+
169
+ ## Assurance por domínio
170
+
171
+ O preset não escolhe o rigor. Desenvolvimento exige testes comportamentais,
172
+ regressões, segurança e rollback conforme risco. Conteúdo de Marketing,
173
+ Branding ou Vendas exige fidelidade a fontes/briefing e revisão apropriada;
174
+ Growth e Ops exigem dados, premissas e critérios de decisão explícitos.
175
+ Não imponha teste de código a uma peça textual, nem use “texto” para dispensar
176
+ segurança, autorização externa ou validação factual.
4
177
 
5
178
  ## Matriz de validação
6
179
 
@@ -65,11 +238,14 @@ execution:
65
238
 
66
239
  O projeto ZAIP-AIOS limita a concorrência produtiva a `max_parallelism: 3`, mas inicia em 1. A elevação só ocorre quando existem ramos sem dependência e sem sobreposição de write scope; o coordenador reivindica cada lote novamente com os locks do scheduler. O paralelismo efetivo é sempre o menor limite entre projeto, plano independente, provider e squad. `budget.soft_cycles` é aplicado ao agente escolhido em cada Task; tokens permanecem telemetria e custo, não checkpoint. `zaip run aggregate --agent agent-ID` filtra a identidade e retorna duração, ciclos observados, tokens, custo, cobertura e rework. Telemetria não capturada permanece indisponível, nunca zero.
67
240
 
68
- O runtime cria Executions-filhas determinísticas somente para SPECs com dependências internas e write scopes globalmente disjuntos. Cada filha possui coordinator, estado, quota de orçamento e handoff próprios, mas todas compartilham a fila limitada pelo paralelismo efetivo e o ledger de invocações do PRD. A filha termina antes do fan-in e o pai não reexecuta suas Tasks. A Execution do PRD integra os commits das filhas, executa as modalidades parentais sobre o commit combinado e bloqueia o finalizer enquanto houver filha ativa. SPECs inelegíveis continuam na DAG global, preservando locks, orçamento e segurança do coordenador.
241
+ O runtime cria Executions-filhas determinísticas somente para SPECs com dependências internas e write scopes globalmente disjuntos. Cada filha possui coordinator, estado e handoff próprios; em `autonomy-v1`, o orçamento de recuperação continua no diário estável de cada Task, mas todas compartilham a fila limitada pelo paralelismo efetivo e o ledger de invocações do PRD. A filha termina antes do fan-in e o pai não reexecuta suas Tasks. A Execution do PRD integra os commits das filhas, executa as modalidades parentais sobre o commit combinado e bloqueia o finalizer enquanto houver filha ativa. SPECs inelegíveis continuam na DAG global, preservando locks, orçamento e segurança do coordenador.
69
242
 
70
243
  O driver autônomo:
71
244
 
72
- - usa protocolo nativo JSONL de Codex ou Claude, sem shell;
245
+ - usa protocolo nativo JSONL, sem shell. O contrato legado suporta Codex ou Claude;
246
+ o despacho gerenciado com `autonomy-v1` atualmente exige Codex e rejeita Claude
247
+ antes de invocar o provider. Conversas diretas continuam disponíveis no provider
248
+ escolhido; isso não comprova suporte Claude à orquestração autônoma v1;
73
249
  - cria worktree Git por Task a partir de uma raiz limpa;
74
250
  - limita alterações aos write scopes;
75
251
  - exige commit final e valida os artefatos tipados dentro da worktree;
@@ -77,7 +253,7 @@ O driver autônomo:
77
253
  - persiste estado com compare-and-swap;
78
254
  - serializa somente transições do estado durável e rebaseia cada Task, permitindo que invocações de ramos independentes executem em paralelo com segurança;
79
255
  - mantém checkpoints opacos somente em `.local`;
80
- - limita `lite` a uma tentativa e `standard`/`critical` a no máximo três tentativas de desenvolvimento ou reparo;
256
+ - em `autonomy-v1`, usa exclusivamente os tetos por Task da tabela acima; somente no legado sem esse bloco mantém as quotas antigas por risco;
81
257
  - usa verificador independente para critical, SPEC e PRD.
82
258
 
83
259
  Na Task autônoma, o adapter respeita o mesmo rigor calculado: `lite` não exige
@@ -92,4 +268,9 @@ Ativar `autonomous` não afirma que o runtime está validado em produção. A ma
92
268
 
93
269
  ## Cobertura e release
94
270
 
271
+ Gui também pode registrar bloqueio/falha quando nenhum executor conseguiu iniciar.
272
+ Isso evita fabricar trabalho apenas para fechar o estado. Não permite sucesso:
273
+ `executor_missing` rejeita conclusão sem executor elegível ou raiz Task direta
274
+ explicitamente autorizada, mesmo que existam Evidences aprovadas.
275
+
95
276
  O ratchet de cobertura nunca reduz o piso: 80% para lines, functions e statements e 75% para branches. Uma medição atual abaixo disso pode ser registrada como baseline observada para diagnóstico, mas o gate continua vermelho. Release crítica também exige unit, E2E, arquitetura, CQRS, módulos, profile, segurança, testes negativos, paridade da distribuição e cleanroom do candidato exato.
@@ -38,10 +38,15 @@ O instalador preserva os READMEs do projeto na raiz. Os perfis `full`, `dev-lite
38
38
  e `lite` selecionam ferramentas de instalação; eles não classificam a dificuldade
39
39
  de uma tarefa nem ativam um modelo mais caro.
40
40
 
41
- O default de seleção de modelos é `manual`. O modo `auto` exige opt-in do projeto,
42
- permanece restrito a SPEC/PRD e mantém Astra como consultor diagnóstico opcional em
43
- `high`, com teto de três invocações por Task e devolução aos executores.
44
- Veja o [contrato de modelos e seus limites](23-orquestracao-de-modelos.md).
41
+ Novos templates mantêm a seleção do principal em `manual` e configuram
42
+ `execution.runtime: managed` para PRD/SPEC, com
43
+ `autonomy: { version: 1, preset: balanced }`. São controles diferentes:
44
+ instalar/salvar o preset não inicia provider. O [guia 19](19-assurance-e-autonomia.md)
45
+ explica Essencial, Equilibrado e Persistente; o [guia 23](23-orquestracao-de-modelos.md)
46
+ detalha Astra/high nos replanejamentos e sua execução elegível no terceiro bloco.
47
+ O Essencial nunca usa Astra automático. Principal avulso preserva a seleção
48
+ manual; filhos necessários seguem política divulgada. Projetos e estados legados
49
+ não recebem migração silenciosa de quotas.
45
50
 
46
51
  ## Construir o CLI
47
52
 
@@ -138,8 +143,8 @@ zaip task execute TASK-ID
138
143
  Task-first não cria PRD nem SPEC sintéticas. `create` persiste somente a Task `draft`; `prepare` persiste o plano na Task; `execute` materializa Change e Execution rastreáveis antes da mutação. O prepare automático acima só aceita Task sem `depends_on`.
139
144
 
140
145
  Task-first registra objetivo, Requirements e Acceptance Criteria sem ocupar artificialmente as
141
- colunas Definição ou Planejamento. Uma Task criada ou preparada, mas não iniciada, aparece em Pronto
142
- para executar. Em pedidos diretos de ação, Change, Execution, Task e Run raiz são materializados
146
+ colunas Definição ou Planejamento. Uma Task materializada como `planned`, nunca iniciada ou tentada, aparece em Pronto
147
+ para executar; `task create` isolado ainda produz `draft`. Em pedidos diretos de ação, Change, Execution, Task e Run raiz são materializados
143
148
  antes da primeira mutação. Verificação e evidências sempre refletem registros reais.
144
149
 
145
150
  Para uma Task manual com dependências, modele a DAG completa em um draft de plano e gere o contrato canônico antes do prepare:
@@ -194,20 +199,21 @@ Para coleções grandes, use listagens compactas: `--status`, `--from`, `--to`,
194
199
 
195
200
  ## Executar e acompanhar a DAG
196
201
 
202
+ Consultas de acompanhamento:
203
+
197
204
  ```bash
198
- zaip execution list
199
205
  zaip execution show EXEC-ID
200
- zaip execution start EXEC-ID
201
- zaip task next
202
- zaip task start TASK-ID
203
- zaip run start --short-name orquestrar-task --phase execution --run-purpose orchestration --entrypoint task --work-type new --client codex --agent zaip-agent-orchestrator --model MODEL --reasoning-effort EFFORT --conversation CONV-ID --execution EXEC-ID --task TASK-ID --change CHG-ID
204
- # execute e verifique o trabalho
205
- zaip run start --short-name finalizar-execution --phase execution --run-purpose finalization --entrypoint task --work-type new --client codex-subagent --agent zaip-agent-finalizer --model MODEL --reasoning-effort EFFORT --conversation CONV-ID --parent RUN-RAIZ-ID --execution EXEC-ID --task TASK-ID --change CHG-ID
206
- zaip run finish RUN-FINALIZADOR-ID --status completed
207
- zaip run finish RUN-ID --status completed --task-outcome completed --summary "Resultado" --evidence EVD-ID --changed-files src/arquivo.ts
206
+ zaip task show TASK-ID
207
+ zaip run show RUN-ID
208
208
  zaip run closure RUN-ID
209
209
  ```
210
210
 
211
+ A execução deve reutilizar a identidade real capturada do turno e seu alvo.
212
+ Não crie um `run start --agent zaip-agent-finalizer` para simular a existência
213
+ de Gui, nem interprete `run finish --status completed` como aprovação.
214
+ O host captura spawn/terminal reais e persiste a decisão observada antes do
215
+ Stop canônico, conforme o [guia 16](16-lifecycle-e-reconciliacao.md).
216
+
211
217
  Tasks `planned` cujas dependências estejam concluídas podem rodar em paralelo. Declare conflitos de arquivos, módulos, migrations, recursos ou ambientes como bloqueios da DAG; paralelismo não deve depender apenas de pertencerem a SPECs diferentes.
212
218
 
213
219
  Cada Run raiz representa a orquestração de uma Execution. Seus filhos são Sub-Runs: ao menos um executor elegível vem do catálogo, e o último deve ser `zaip-agent-finalizer`; ele só inicia depois dos demais descendentes e impede novos filhos. A CLI aplica sua decisão como `completed`, `blocked`, `failed` ou `cancelled`; finalizador ausente ou falho produz `blocked`. `executing` e `verifying` nunca são estados válidos depois do término da Run raiz. Uma Task bloqueada continua pela mesma identidade com `task resume`. Uma Task falhada exige `task rework`, preserva a identidade e incrementa a tentativa. Tasks concluídas ou canceladas são imutáveis.
@@ -8,7 +8,12 @@ O Monitor de Custos é uma visão financeira da população de Runs de Operaçã
8
8
 
9
9
  ## Fonte e proveniência
10
10
 
11
- A projeção é **manifest-first**: usa os manifests e registros Git como fonte canônica e a telemetria local apenas para uma reconciliação com correspondência exata. O Dashboard não usa SQLite como fonte de dados do Monitor de Custos.
11
+ Os registros e manifests Git-native são canônicos. No runtime atual, o Monitor
12
+ também consulta o SQLite reconstruível: o resumo recebe agregados compactos,
13
+ enquanto páginas de Runs combinam fatos com manifests canônicos atuais.
14
+ Caminhos de compatibilidade preservam a leitura manifest-first.
15
+ SQLite não é outra fonte de verdade; consulta não autoriza reconciliação
16
+ global nem alteração do histórico.
12
17
 
13
18
  Tokens, custo e duração devem exibir sua proveniência. Tokens e configuração efetiva de modelo/effort só são observados quando a fonte os informa; defaults planejados não preenchem esses campos. A projeção pode exibir duração `observed`, `reconciled`, `legacy_inferred` ou `estimated`. Apenas `observed` é medição da fonte; as demais são derivadas e não satisfazem um critério que exija duração capturada.
14
19
 
@@ -20,9 +25,20 @@ Os agregados de Conversas, Providers, Agentes, Modelos, Diário, Mensal e Anual
20
25
 
21
26
  Não use contagens, totais ou percentuais de auditorias passadas como diagnóstico atual. Consulte o período e os filtros da execução auditada; uma lacuna de coleta continua sendo lacuna, mesmo quando há estimativa ou reconciliação exibida.
22
27
 
28
+ Na Visão geral de Tasks, cobertura incompleta produz **Subtotal estimado
29
+ conhecido**, com valor e contagem conhecida/total. Médias de custo por item/hora
30
+ ficam indisponíveis nessa condição para não misturar populações.
31
+ Cobertura completa permite o rótulo **Custo estimado**. Sem soma
32
+ conhecida, o valor continua indisponível; um zero conhecido não é ocultado.
33
+ Esses três estados não equivalem a saldo, fatura ou custo integral do provider.
34
+
23
35
  ## Filtros e totais
24
36
 
25
- Filtros preenchidos somente com data são inclusivos: a data inicial começa em `00:00:00.000Z` e a final termina em `23:59:59.999Z`. O card de custo da Visão geral recebe o mesmo conjunto ativo do Monitor de Custos; por isso card, tabela e total devem coincidir para o mesmo período e moeda.
37
+ Filtros preenchidos somente com data são inclusivos pelo calendário IANA
38
+ `America/Sao_Paulo`: início à meia-noite local e fim imediatamente antes do
39
+ próximo dia local, convertidos para UTC. Considere DST histórico; não fixe
40
+ `-03:00` nem use o dia UTC como substituto. Timestamps explícitos conservam
41
+ seu instante. O card de custo da Visão geral recebe o mesmo conjunto ativo do Monitor de Custos; por isso card, tabela e total devem coincidir para o mesmo período e moeda.
26
42
 
27
43
  ## Verificação operacional
28
44
 
@@ -25,7 +25,14 @@ atalho de aprovação: o registro não executa o procedimento, não transforma
25
25
  resultado pendente em verde e não dispensa review/finalizador. Consulte o
26
26
  [contrato canônico](../../skills/zaip-skill-change/references/observable-evidence.md).
27
27
 
28
- Em PRD/SPEC com `model_orchestration.mode:auto`, trabalho simples e delimitado pode usar Luna/low, execução padrão Terra/medium e ambiguidade, transversalidade ou rework estrutural Sol/high ou xhigh. Conversation e Task-first preservam a seleção manual do host/Codex. Criticidade amplia assurance; não eleva modelo mecanicamente.
28
+ Com `autonomy-v1`, a recuperação segue o preset congelado por Task:
29
+ Essencial 4/1 sem Astra automático, Equilibrado 10/3 e Persistente ilimitado.
30
+ Replanejamentos usam Sol/high primeiro e Astra/high nos seguintes permitidos;
31
+ Astra/high pode executar a partir do terceiro bloco fora do Essencial.
32
+ Principal avulso preserva a seleção manual e prefere trabalho direto;
33
+ delegação necessária informa que filhos podem usar outra configuração.
34
+ Criticidade amplia assurance; não define a quota.
35
+ Veja [autonomia](19-assurance-e-autonomia.md) e [modelos](23-orquestracao-de-modelos.md).
29
36
 
30
37
  ## Entradas e planejamento
31
38
 
@@ -63,7 +70,12 @@ Task em execução → Orchestrator → Executor → Evidence e Decisions
63
70
  → Auditor (quando necessário) → Finalizer → resultado
64
71
  ```
65
72
 
66
- O resultado pode ser concluído, bloqueado, falhado, cancelado ou exigir rework. Bloqueio e rework iniciam um novo ciclo controlado; cancelamento é uma decisão humana explícita. O finalizador fecha a Run somente depois da revisão e de qualquer auditoria exigida.
73
+ O resultado pode ser concluído, bloqueado, falhado ou cancelado; rework é uma
74
+ continuação autorizada, não outro estado terminal nem reset do orçamento.
75
+ Sem evidência suficiente, bloqueie; com impedimento técnico comprovado, falhe.
76
+ O host persiste a decisão de Gui e fecha pela CLI. Gui é último filho direto
77
+ do responsável da Task, não de cada trabalhador; não aguarda recibos em loop.
78
+ O controle de quotas depende do despacho gerenciado, não do desenho do fluxo.
67
79
 
68
80
  ## Lifecycle e operação
69
81