@zaip-ai/cli 2.6.0 → 3.0.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 (301) 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 +71 -10
  20. package/templates/.agents/README.md +72 -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 +246 -134
  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-TnrL1ZyZ.js} +915 -550
  51. package/templates/.agents/dashboard/apps/frontend/dist/assets/{PricingSettingsDialog-DEbCi1gP.js → PricingSettingsDialog-DjQpBqGU.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-BQZXUnQu.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-Basaw1NR.js +824 -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-BQe3zTvL.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 +238 -226
  131. package/templates/.agents/dashboard/packages/local-runtime/dist/sqlite-read-model.cjs +205 -195
  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 +238 -226
  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-cost-dimension-facts.test.ts +12 -1
  154. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-file-index.test.ts +69 -0
  155. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-first-fold-cache.ts +3 -1
  156. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-force-canonical.test.ts +3 -1
  157. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-incremental-refresh.test.ts +2 -0
  158. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-materialize-projections.ts +9 -0
  159. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-materialize-runs.ts +1 -1
  160. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-period-averages.ts +46 -0
  161. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-provider-alias-parity.test.ts +50 -0
  162. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-filtered-dimension.ts +13 -2
  163. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-summary.ts +25 -7
  164. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-temporal-dimension.ts +2 -0
  165. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-counts-every-root-execution-day-returns.test.ts +34 -10
  166. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-filesystem.ts +17 -3
  167. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-keeps-orphan-telemetry-out-kanban-without.test.ts +1 -1
  168. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-rebuild.ts +9 -0
  169. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-schema.ts +4 -4
  170. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-source-fingerprint.test.ts +54 -1
  171. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-source-fingerprint.ts +7 -3
  172. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model.test.ts +4 -1
  173. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-risk-population.test.ts +98 -0
  174. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-schema-base-views.ts +7 -2
  175. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-schema-dashboard-views.ts +2 -1
  176. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-snapshot-seed.test.ts +2 -0
  177. package/templates/.agents/dashboard/packages/local-runtime/src/verify-project-settings.mjs +57 -0
  178. package/templates/.agents/dashboard/packages/ui/package.json +1 -1
  179. package/templates/.agents/dashboard/scripts/qualify-observability.mjs +130 -0
  180. package/templates/.agents/dashboard/scripts/verify-autonomy-settings.mjs +175 -0
  181. package/templates/.agents/dashboard/scripts/verify-observability.mjs +254 -0
  182. package/templates/.agents/dashboard/scripts/verify-project-setup.mjs +64 -0
  183. package/templates/.agents/dashboard/tests/e2e/lease-global-setup.ts +37 -0
  184. package/templates/.agents/dashboard/tests/e2e/package.json +1 -1
  185. package/templates/.agents/dashboard/tests/e2e/playwright.config.ts +5 -3
  186. package/templates/.agents/dashboard/tests/e2e/specs/cost-monitor-period-transition.spec.ts +22 -1
  187. package/templates/.agents/dashboard/tests/e2e/specs/dashboard-performance-matrix.spec.ts +17 -8
  188. package/templates/.agents/dashboard/tests/e2e/specs/dashboard.spec.ts +47 -6
  189. package/templates/.agents/dashboard/tests/e2e/specs/lease-lifetime.spec.ts +14 -0
  190. package/templates/.agents/dashboard/tests/observability-fixture.mjs +200 -0
  191. package/templates/.agents/design/.zaip-managed.json +84 -40
  192. package/templates/.agents/design/apps/catalog/dist/assets/index-BJV597iq.js +72 -0
  193. package/templates/.agents/design/apps/catalog/dist/assets/index-BOjCcUaU.js +72 -0
  194. package/templates/.agents/design/apps/catalog/dist/assets/index-B_WhrCZe.js +72 -0
  195. package/templates/.agents/design/apps/catalog/dist/assets/index-CqtYXZfV.js +72 -0
  196. package/templates/.agents/design/apps/catalog/dist/assets/index-D_lfqoyx.js +72 -0
  197. package/templates/.agents/design/apps/catalog/dist/assets/index-i_PO2k9R.js +9 -0
  198. package/templates/.agents/design/apps/catalog/dist/index.html +1 -1
  199. package/templates/.agents/design/apps/catalog/dist/storybook/assets/CatalogShell-Cstn1UwA.js +1 -0
  200. package/templates/.agents/design/apps/catalog/dist/storybook/assets/{Color-6AOWCN3U-B-kAgAjB.js → Color-6AOWCN3U-Cm-yJJz_.js} +1 -1
  201. package/templates/.agents/design/apps/catalog/dist/storybook/assets/Components.stories-D1WopB2L.js +137 -0
  202. package/templates/.agents/design/apps/catalog/dist/storybook/assets/DesignSystem.stories-DQ9PJ3N3.js +1 -0
  203. package/templates/.agents/design/apps/catalog/dist/storybook/assets/{DocsRenderer-JROSPFPF-BVN7xHtv.js → DocsRenderer-JROSPFPF-Belk4jRr.js} +4 -4
  204. package/templates/.agents/design/apps/catalog/dist/storybook/assets/{WithTooltip-7X4HQR7L-CDHtKYkz.js → WithTooltip-7X4HQR7L-DoPvjkS1.js} +1 -1
  205. package/templates/.agents/design/apps/catalog/dist/storybook/assets/{chunk-DRQKCCAG-D6AsDkMK.js → chunk-DRQKCCAG-B1itKXEN.js} +1 -1
  206. package/templates/.agents/design/apps/catalog/dist/storybook/assets/{chunk-W22LQPXL-B4m5uloN.js → chunk-W22LQPXL-C-Eb5SPY.js} +1 -1
  207. package/templates/.agents/design/apps/catalog/dist/storybook/assets/{components-CN8YyTUg.js → components-DnyKLwhj.js} +5 -5
  208. package/templates/.agents/design/apps/catalog/dist/storybook/assets/formatter-L2YTDE3Q-D0OSgxWz.js +1 -0
  209. package/templates/.agents/design/apps/catalog/dist/storybook/assets/{iframe-9yZfIsdT.js → iframe-DcXBsFPz.js} +3 -3
  210. package/templates/.agents/design/apps/catalog/dist/storybook/assets/{react-18-BoCSnq6H.js → react-18-CRM89QRf.js} +1 -1
  211. package/templates/.agents/design/apps/catalog/dist/storybook/assets/react-C3tkVMIp.js +1 -0
  212. package/templates/.agents/design/apps/catalog/dist/storybook/assets/{syntaxhighlighter-YFXUGROL-Bnn_nMwJ.js → syntaxhighlighter-YFXUGROL-B03jQGTF.js} +1 -1
  213. package/templates/.agents/design/apps/catalog/dist/storybook/assets/{theming-DS_ue2sb.js → theming-4ZyufAga.js} +1 -1
  214. package/templates/.agents/design/apps/catalog/dist/storybook/iframe.html +1 -1
  215. package/templates/.agents/design/apps/catalog/dist/storybook/index.json +1 -1
  216. package/templates/.agents/design/apps/catalog/package.json +2 -2
  217. package/templates/.agents/design/apps/catalog/src/components/AutonomySpecimen.tsx +15 -0
  218. package/templates/.agents/design/apps/catalog/src/components/CostPopulationSpecimen.test.tsx +19 -0
  219. package/templates/.agents/design/apps/catalog/src/components/CostPopulationSpecimen.tsx +45 -0
  220. package/templates/.agents/design/apps/catalog/src/components/EstimatedCostSpecimen.tsx +48 -0
  221. package/templates/.agents/design/apps/catalog/src/components/ProjectStatusSpecimen.tsx +169 -0
  222. package/templates/.agents/design/apps/catalog/src/pages/ComponentsPage.tsx +55 -0
  223. package/templates/.agents/design/apps/catalog/src/stories/Components.stories.tsx +60 -0
  224. package/templates/.agents/design/packages/local-runtime/package.json +1 -1
  225. package/templates/.agents/requirements/autonomous-assurance.md +1 -1
  226. package/templates/.agents/requirements/cloud-hostinger-autonomy.md +1 -1
  227. package/templates/.agents/requirements/comparative-audit.md +1 -1
  228. package/templates/.agents/requirements/context-engine.md +1 -1
  229. package/templates/.agents/requirements/cost-observability.md +1 -1
  230. package/templates/.agents/requirements/dashboard-launch.md +1 -1
  231. package/templates/.agents/requirements/data-export.md +1 -1
  232. package/templates/.agents/requirements/design-system.md +1 -1
  233. package/templates/.agents/requirements/execution-engine.md +1 -1
  234. package/templates/.agents/requirements/kanban-dashboard.md +1 -1
  235. package/templates/.agents/requirements/model-orchestration.md +1 -1
  236. package/templates/.agents/requirements/public-distribution.md +1 -1
  237. package/templates/.agents/requirements/software-architecture.md +1 -1
  238. package/templates/.agents/requirements/strategic-improvements.md +1 -1
  239. package/templates/.agents/requirements/work-lifecycle.md +5 -5
  240. package/templates/.agents/requirements/zaip-strategic-95.md +1 -1
  241. package/templates/.agents/rules/astra-diagnostic.md +3 -1
  242. package/templates/.agents/rules/autonomy-decision.md +10 -2
  243. package/templates/.agents/rules/core.md +12 -1
  244. package/templates/.agents/rules/run-lifecycle-closure.md +8 -6
  245. package/templates/.agents/rules/workflow.md +2 -2
  246. package/templates/.agents/runtime/VERSION +1 -1
  247. package/templates/.agents/runtime/bin/zaip.mjs +383 -350
  248. package/templates/.agents/runtime/checksums.sha256 +6 -6
  249. package/templates/.agents/runtime/manifest.json +1 -1
  250. package/templates/.agents/runtime/pnpm-lock.sha256 +1 -1
  251. package/templates/.agents/runtime/provenance.json +5 -5
  252. package/templates/.agents/runtime/sbom.cdx.json +3 -3
  253. package/templates/.agents/skills/zaip-skill-dev-environment/SKILL.md +2 -0
  254. package/templates/.agents/skills/zaip-skill-execution/SKILL.md +28 -5
  255. package/templates/.agents/skills/zaip-skill-execution/references/runtime-governance.md +17 -3
  256. package/templates/.agents/skills/zaip-skill-github-deploy/SKILL.md +8 -9
  257. package/templates/.agents/skills/zaip-skill-github-deploy/references/deployment-workflow.md +10 -6
  258. package/templates/.agents/skills/zaip-skill-move-prd/SKILL.md +2 -0
  259. package/templates/.agents/skills/zaip-skill-prd/SKILL.md +2 -0
  260. package/templates/.agents/skills/zaip-skill-release-qualification/SKILL.md +21 -23
  261. package/templates/.agents/skills/zaip-skill-release-qualification/references/local-preparation.md +37 -13
  262. package/templates/.agents/skills/zaip-skill-setup/SKILL.md +2 -0
  263. package/templates/.agents/skills/zaip-skill-tool-setup/SKILL.md +2 -0
  264. package/templates/.agents/zaip-aios/INDEX.md +9 -1
  265. package/templates/.agents/zaip-aios/README.md +23 -2
  266. package/templates/.agents/zaip-aios/VERSION +1 -1
  267. package/templates/.agents/zaip-aios/guides/01-primeiros-passos.md +5 -1
  268. package/templates/.agents/zaip-aios/guides/03-tasks.md +15 -2
  269. package/templates/.agents/zaip-aios/guides/04-specs.md +13 -0
  270. package/templates/.agents/zaip-aios/guides/05-prds.md +13 -0
  271. package/templates/.agents/zaip-aios/guides/06-execucao.md +19 -4
  272. package/templates/.agents/zaip-aios/guides/07-revisao-e-validacao.md +14 -0
  273. package/templates/.agents/zaip-aios/guides/08-contexto-e-tokens.md +4 -3
  274. package/templates/.agents/zaip-aios/guides/09-agentes-e-squads.md +17 -9
  275. package/templates/.agents/zaip-aios/guides/10-seguranca.md +9 -0
  276. package/templates/.agents/zaip-aios/guides/11-observabilidade-e-custos.md +69 -0
  277. package/templates/.agents/zaip-aios/guides/12-instalacao-e-upgrade.md +9 -4
  278. package/templates/.agents/zaip-aios/guides/13-boas-praticas.md +7 -1
  279. package/templates/.agents/zaip-aios/guides/14-troubleshooting.md +18 -0
  280. package/templates/.agents/zaip-aios/guides/16-lifecycle-e-reconciliacao.md +54 -3
  281. package/templates/.agents/zaip-aios/guides/18-catalogo-de-agentes.md +10 -2
  282. package/templates/.agents/zaip-aios/guides/19-assurance-e-autonomia.md +186 -5
  283. package/templates/.agents/zaip-aios/guides/20-instalacao-detalhada.md +21 -15
  284. package/templates/.agents/zaip-aios/guides/21-telemetria-monitor-custos.md +18 -2
  285. package/templates/.agents/zaip-aios/guides/22-fluxos-e-roteamento.md +14 -2
  286. package/templates/.agents/zaip-aios/guides/23-orquestracao-de-modelos.md +190 -489
  287. package/templates/.agents/zaip-aios/guides/26-qualidade-e-release.md +61 -13
  288. package/templates/.agents/zaip-aios/guides/27-telemetria-git-native.md +18 -0
  289. package/templates/.agents/zaip-aios/guides/28-lifecycle-completo.md +18 -1
  290. package/templates/template-manifest.json +425 -269
  291. package/templates/.agents/dashboard/apps/frontend/dist/assets/ProjectSettingsPage-1L7Qw-Gq.js +0 -3
  292. package/templates/.agents/dashboard/apps/frontend/dist/assets/ProjectSettingsPage-EInWr641.css +0 -1
  293. package/templates/.agents/dashboard/apps/frontend/dist/assets/cost-monitor-B6aZfo5f.js +0 -68
  294. package/templates/.agents/dashboard/apps/frontend/dist/assets/dashboard-localization-CLJ0lT9v.js +0 -231
  295. package/templates/.agents/dashboard/apps/frontend/dist/assets/index-DgTmNHN5.js +0 -2
  296. package/templates/.agents/dashboard/apps/frontend/dist/assets/traceability-DQpKX9c1.js +0 -1
  297. package/templates/.agents/design/apps/catalog/dist/storybook/assets/CatalogShell-BWY-80s4.js +0 -1
  298. package/templates/.agents/design/apps/catalog/dist/storybook/assets/Components.stories-Be2mDUQj.js +0 -27
  299. package/templates/.agents/design/apps/catalog/dist/storybook/assets/DesignSystem.stories-DRx9blDs.js +0 -1
  300. package/templates/.agents/design/apps/catalog/dist/storybook/assets/formatter-L2YTDE3Q-EwuTh8Zk.js +0 -1
  301. package/templates/.agents/design/apps/catalog/dist/storybook/assets/react-DyL61NPT.js +0 -1
@@ -8,7 +8,7 @@
8
8
 
9
9
  O ZAIP-AIOS é um sistema operacional para execução autônoma de trabalho com agentes de IA, que coordena 23 agentes especializados, organizados em 6 squads, dentro do Codex.
10
10
 
11
- Os agentes planejam, executam, revisam, testam e validam o trabalho sob coordenação do orquestrador. A execução autorizada avança até atender aos critérios definidos ou registrar um bloqueio, falha ou limite de orçamento. Dependências externas e decisões fora da autoridade recebida continuam exigindo intervenção humana; autonomia não significa execução indefinida nem garantia de acerto.
11
+ Os agentes planejam, executam, revisam, testam e validam o trabalho sob coordenação do orquestrador. A execução autorizada avança até atender aos critérios ou registrar bloqueio/falha conforme evidências e orçamento. O perfil Persistente permite execução indefinida por escolha explícita; os demais têm cotas por Task. Nenhum perfil garante acerto nem amplia autoridade para ações externas.
12
12
 
13
13
  Essa abordagem busca reduzir intervenções, contexto desnecessário e retrabalho. Os percentuais de 34% e 62% apresentados adiante se referem a custo médio por tarefa e por hora nas séries históricas ilustradas, respectivamente; não medem diretamente redução de tokens nem garantem economia em uma nova entrega.
14
14
 
@@ -53,10 +53,16 @@ No ZAIP-AIOS, uma Task não é considerada concluída apenas porque um agente te
53
53
 
54
54
  ### Como interpretar esta documentação
55
55
 
56
+ Os dois READMEs são mantidos em português e inglês. Na Ajuda do Dashboard,
57
+ o README inglês vem de `README-ENG.md`; guias sem tradução mostram a fonte
58
+ portuguesa atual com aviso de idioma, sem resumos paralelos desatualizados.
59
+
56
60
  Este README e o [handbook](zaip-aios/INDEX.md) descrevem o código-fonte deste repositório. Configuração efetiva, suporte do host, pacote instalado e candidato qualificado são dimensões distintas. `@latest` aponta para a versão publicada, que pode não conter alterações locais. As imagens do Dashboard são ilustrações de estados anteriores, não prova visual do candidato atual.
57
61
 
58
62
  A atualização documental não aprova uma release. Consulte o [registro de limites de qualificação](https://github.com/zaip-ai/zaip-aios/blob/main/docs/PRODUCTION-COMMERCIAL-READINESS.md#limites-conhecidos-da-qualificação) antes de promover o código; testes locais, paridade, CI e validação em produção devem ser comprovados separadamente.
59
63
 
64
+ Na entrega v3, a bateria completa fica na preparação local assinada (`full-v2`). O GitHub verifica o pacote exato, sua instalação e a publicação, sem repetir a bateria de fonte a cada push. A ativação exige qualificação local completa e confiança cadastrada. Há um único smoke automático de instalação antes do npm; checks de fonte e matriz remota ficam manuais, sem teste sobre rascunho privado. Veja o [guia de qualidade e release](zaip-aios/guides/26-qualidade-e-release.md). Lacunas históricas de telemetria permanecem explícitas, sem inventar números ou dispensar testes de dados novos.
65
+
60
66
  ## Instalação em um comando
61
67
 
62
68
  Com Node.js 22.16.0 ou superior e npm, execute a instalação na raiz do projeto que receberá o ZAIP-AIOS. Em uma instalação nova, o `init` usa o perfil completo (`full`): instala as dependências ausentes da stack e prepara o Terraform. Todos os perfis verificam os runtimes distribuídos e preparam e validam o SQLite local, sem driver separado. Versões de pacotes existentes no projeto são preservadas, com aviso das versões atual e configurada no ZAIP-AIOS:
@@ -244,6 +250,42 @@ A configuração da plataforma apresenta o estado de ativação do ZAIP-AIOS e u
244
250
 
245
251
  <img src="https://raw.githubusercontent.com/zaip-ai/zaip-aios/main/.agents/config/src/dashboard_pt_configuracao_plataforma.png" alt="Dashboard ZAIP-AIOS, configuração da plataforma" width="100%">
246
252
 
253
+ ### Perfis de autonomia da v3
254
+
255
+ As fontes em preparação para a v3 acrescentam um preset por Task, separado de
256
+ instalação e assurance:
257
+
258
+ | Perfil | Execuções de produto por Task | Replanejamentos | Modelos dos replanejamentos |
259
+ | --- | --- | --- | --- |
260
+ | Essencial (`essential`) | 4: 1 inicial + 3 reparações | 1 | Sol/high; nunca Astra automático |
261
+ | Equilibrado (`balanced`, padrão novo) | 10: 1 inicial + 9 reparações | 3 | Sol/high → Astra/high → Astra/high |
262
+ | Persistente (`persistent`, opt-in) | Sem teto | Sem teto | Sol/high primeiro; Astra/high nos seguintes |
263
+
264
+ Mescle no arquivo `.agents/config/project.yaml` ou selecione **Perfil de
265
+ autonomia** em **Configurações do projeto** no Dashboard e salve:
266
+
267
+ ```yaml
268
+ autonomy:
269
+ version: 1
270
+ preset: balanced
271
+ ```
272
+
273
+ O diário durável reserva antes do despacho gerenciado; reiniciar ou retomar
274
+ não zera a quota. A alteração vale para novas Tasks. Não há abandono por tempo
275
+ nem redução automática de critérios de aceite. Persistente pode consumir
276
+ créditos indefinidamente até cancelamento humano; não amplia permissões.
277
+
278
+ Uma SPEC de dez Tasks Equilibradas admite até 100 execuções (10 iniciais +
279
+ 90 reparações) e 30 replanejamentos; testes e Calls internas não são tentativas.
280
+ A falta de verificação/conclusão segura termina `blocked`; impedimento técnico
281
+ comprovado termina `failed`. Ramos independentes continuam elegíveis.
282
+
283
+ **Limite atual:** os contadores são impostos no runtime gerenciado, não em
284
+ `spawn_agent` externo feito diretamente pelo Codex. Novos projetos usam
285
+ `execution.runtime: managed`: PRD/SPEC gerenciados e avulsas diretas. Salvar
286
+ o preset não inicia provider. Legados exigem migração explícita, sem zerar
287
+ consumo. Veja [autonomia e suas garantias](zaip-aios/guides/19-assurance-e-autonomia.md).
288
+
247
289
  ### Stack de desenvolvimento
248
290
 
249
291
  A stack de desenvolvimento descreve cada responsabilidade separadamente, com tecnologia, versão exata e referência do pacote, imagem ou serviço. No projeto, esse contrato inclui TypeScript, Node.js, Hono, Kysely, PostgreSQL via Supabase, Supabase Auth + Storage, Redis e BullMQ, permitindo que as escolhas de desenvolvimento permaneçam registradas junto da configuração do projeto.
@@ -283,7 +325,7 @@ Por padrão, cada PRD utiliza apenas uma SPEC, buscando economia.
283
325
 
284
326
  Uma nova SPEC só deve ser criada quando existir uma capacidade que possa ser implementada e validada de forma independente e paralela. Quando existe dependência entre partes do trabalho, elas permanecem na mesma SPEC e são organizadas pela DAG de Tasks.
285
327
 
286
- No runtime atual, um PRD materializa uma Execution-filho determinística para cada SPEC elegível: suas dependências permanecem dentro da SPEC e seus write scopes não conflitam com nenhum outro ramo. Cada filha executa com coordinator, estado, quota de orçamento e handoff próprios, sob uma fila limitada pelo paralelismo efetivo e por um ledger parental único de invocações; a Execution do PRD aguarda os estados terminais, integra os candidatos no handoff parental e só então aplica validação cross-SPEC e finalização. SPECs com dependência externa ou conflito de escopo permanecem na DAG global coordenadora.
328
+ No runtime atual, um PRD materializa uma Execution-filho determinística para cada SPEC elegível: suas dependências permanecem dentro da SPEC e seus write scopes não conflitam com nenhum outro ramo. Cada filha executa com coordinator, estado e handoff próprios; em `autonomy-v1`, a quota de recuperação continua por Task estável, sob uma fila limitada pelo paralelismo efetivo e por um ledger parental único de invocações; a Execution do PRD aguarda os estados terminais, integra os candidatos no handoff parental e só então aplica validação cross-SPEC e finalização. SPECs com dependência externa ou conflito de escopo permanecem na DAG global coordenadora.
287
329
 
288
330
  Antes de o PRD chegar ao estado `ready`, as Tasks são apenas definições de trabalho, ainda sem execução.
289
331
 
@@ -320,6 +362,17 @@ Toda criação de PRD ou SPEC é vinculada à Run responsável por meio do campo
320
362
 
321
363
  Tempo, tokens e custo são agregados sempre que essas informações estiverem disponíveis ou forem reconciliadas. Quando não houver dados suficientes, os valores permanecem como `unknown` ou `null`.
322
364
 
365
+ Na Visão geral, uma cobertura incompleta não esconde a soma disponível: o Dashboard
366
+ mantém o cartão compacto **Custo Estimado**, sem ícone. A descrição acessível e o
367
+ tooltip informam a cobertura. O subtítulo divide o subtotal conhecido pelo número
368
+ de tarefas e pelas horas registradas no mesmo recorte: são taxas estimadas de
369
+ alocação, não médias de custos completos por tarefa. Com cobertura parcial, não
370
+ estima os valores ausentes. Cada taxa fica `—` apenas se sua base estiver indisponível
371
+ ou for zero; uma taxa válida não é escondida porque a outra está indisponível.
372
+ O subtotal não é o custo integral nem a fatura da conta. Zero observado continua sendo zero;
373
+ ausência de medição continua indisponível. Rascunhos de Task ficam na lista de
374
+ trabalho, fora do Kanban executável e dos indicadores operacionais sem rascunhos.
375
+
323
376
 
324
377
  ## Qualidade e evidências
325
378
 
@@ -468,24 +521,33 @@ Essa progressão permite começar de forma simples e acrescentar planejamento ap
468
521
 
469
522
  **Políticas técnicas de execução e assurance**
470
523
 
471
- Conversation e Task-first preservam a seleção manual do host; o default do projeto não é aplicado automaticamente a uma Task avulsa. A política automática aceita origens SPEC/PRD configuradas em `automatic_sources`, com velocidade `standard`. Modelo e effort ficam fixos em cada Run/Sub-Run; capacidade ou velocidade indisponível no host não pode ser presumida pelo ZAIP. Consulte a [política de modelos](zaip-aios/guides/23-orquestracao-de-modelos.md).
524
+ Conversation e o principal de Task avulsa preservam a seleção manual do host, priorizando trabalho direto. Quando delegar for necessário, informe que os filhos podem usar modelos/esforços diferentes pela política ZAIP; não há obrigação de herdar o principal. Modelo e effort ficam fixos por Run, com observação efetiva separada da seleção planejada. A seleção automática solicita `standard`; capacidade não observada do host não pode ser presumida. Consulte a [política de modelos](zaip-aios/guides/23-orquestracao-de-modelos.md).
472
525
 
473
526
  ### Política Astra
474
527
 
475
- Luna, Terra e Sol permanecem as rotas de uso simples e de execução. Astra não executa produto, não faz revisão geral nem finaliza uma Task: é uma rota read-only de diagnóstico ou replanejamento, com effort `high` como teto. Ela só pode ser usada após sinais estruturados — tentativa executora com falha de raciocínio/hipótese e ambiguidade ou complexidade difícil, ou impacto crítico material acompanhado de diagnóstico difícil. Palavras como “crítico” ou “complexo”, departamento, tamanho ou risco isolado não a habilitam.
528
+ No Essencial, Astra nunca é selecionado automaticamente, inclusive em filhos ou fallback. A única exceção é o principal avulso com Astra escolhido manualmente pelo usuário. No Equilibrado, os três replanejamentos usam Sol/high, Astra/high e Astra/high; no terceiro bloco Astra/high também pode executar a reparação, sem ampliar a quota. Persistente mantém essa progressão sem teto total.
529
+
530
+ O replanejador é isolado e não edita produto; executor, revisor e Gui são papéis distintos. Astra automático usa somente `high`, não substitui revisão/finalização e depende do despacho gerenciado. A regra antiga de até três diagnósticos Astra somente leitura permanece apenas no contrato legado sem `autonomy`; não limita Persistente. Contexto e assurance seguem o domínio: conteúdo exige fontes/briefing, engenharia exige comportamento verificável. Economia real precisa ser medida, não inferida do preset.
476
531
 
477
- Há no máximo três ciclos Astra cumulativos por Task. Cada diagnóstico produz provas, findings, causa ou hipótese, rota recomendada, escopo, plano curto de teste/correção e handback para executor Luna, Terra ou Sol. Prova repetida ou falta de progresso bloqueia novo ciclo. Hosts manuais podem não permitir que o framework imponha a seleção; Conversations e Task-first preservam essa escolha. Contexto comercial é condicional ao pedido e não recebe requisitos técnicos por padrão. Métricas históricas de custo não prometem economia real em uma nova Task.
532
+ O intake correlaciona o turno observável à Execution. `prepare` valida o plano, sem autorizar implementação; `ready` materializa trabalho preparado e `execute` inicia a entrega autorizada. Toda delivery e interaction delegada exige executor elegível (ou raiz Task direta autorizada) e `zaip-agent-finalizer` por último. Interaction read-only sem descendentes termina após a resposta, sem esse circuito. Publicação puramente Git é uma exceção: não materializa lifecycle. SPEC/PRD permanecem ativos entre Runs filhas e só são entregues por gates parentais.
478
533
 
479
- O intake correlaciona o turno observável à Execution. `prepare` valida o plano, sem autorizar implementação; `ready` materializa trabalho preparado e `execute` inicia a entrega autorizada. Toda delivery e interaction com descendentes exigem executor elegível e `zaip-agent-finalizer` por último. Interaction read-only sem descendentes termina após a resposta, sem esse circuito. Publicação puramente Git é uma exceção: não materializa lifecycle. SPEC/PRD permanecem ativos entre Runs filhas e só são entregues por gates parentais.
534
+ Cada tentativa de Task tem exatamente um orquestrador responsável. Gui é seu
535
+ último filho direto, irmão dos executores, não finalizador de cada trabalhador.
536
+ O host persiste a decisão real antes do Stop canônico; pode retransmitir Gui
537
+ já terminal enquanto o responsável estiver aberto, sem obrigá-lo a esperar
538
+ recibos. Ausência de decisão não é aprovação. A preferência por execução
539
+ avulsa direta usa uma raiz observada com `--direct-authorization REFERÊNCIA`
540
+ explícita; não cria executor fictício nem dispensa Evidence e Gui. Veja
541
+ [fechamento e recuperação](zaip-aios/guides/16-lifecycle-e-reconciliacao.md).
480
542
 
481
- A profundidade de prova é adaptativa: Task standalone `lite` exige no mínimo uma validação tipada e uma Evidence, normalmente uma de cada, mas aceita provas adicionais legítimas. `standard` exige duas ou três validações conforme `verification_scope` e pelo menos uma Evidence consolidada; `critical` exige três ou mais, revisão independente e os sinais de risco persistidos que determinam controles adicionais. Entregas de SPEC e PRD acrescentam matriz parental, pelo menos três validações e três Evidences, integração real e revisão independente. O runtime manual continua padrão; a autonomia por Codex ou Claude é opt-in, isolada em worktrees e limitada por write scopes, commits, budgets e gates tipados. Consulte [Assurance adaptativa e autonomia opt-in](zaip-aios/guides/19-assurance-e-autonomia.md).
543
+ A profundidade de prova é adaptativa: Task standalone `lite` exige no mínimo uma validação tipada e uma Evidence, normalmente uma de cada, mas aceita provas adicionais legítimas. `standard` exige duas ou três validações conforme `verification_scope` e pelo menos uma Evidence consolidada; `critical` exige três ou mais, revisão independente e os sinais de risco persistidos que determinam controles adicionais. Entregas de SPEC e PRD acrescentam matriz parental, pelo menos três validações e três Evidences, integração real e revisão independente. Novos projetos usam runtime gerenciado para PRD/SPEC e direto para avulsas; a execução por Codex ou Claude é autorizada por pedido, isolada em worktrees e limitada por write scopes, commits, budgets e gates tipados. Consulte [Assurance adaptativa e autonomia opt-in](zaip-aios/guides/19-assurance-e-autonomia.md).
482
544
 
483
545
 
484
546
  ## Princípios de engenharia autônoma
485
547
 
486
548
  O ZAIP-AIOS combina velocidade com limites explícitos. Seus princípios mantêm o código sustentável, distribuem apenas o contexto necessário e exigem comprovação proporcional ao risco.
487
549
 
488
- O padrão do schema é `execution.runtime: manual` quando a opção está ausente; este checkout optou por `autonomous` em `project.yaml`. A configuração não dispensa pedido de execução nem autoriza publicar. Consulte sempre o arquivo efetivo do projeto, não apenas o default descrito no guia.
550
+ O padrão do schema é `execution.runtime: manual` quando a opção está ausente; este checkout usa `managed` em `project.yaml`. A configuração não dispensa pedido de execução nem autoriza publicar. Consulte sempre o arquivo efetivo do projeto, não apenas o default descrito no guia.
489
551
 
490
552
  - **Clean Architecture:** domínio, aplicação, adapters e infraestrutura permanecem separados; regras de negócio não dependem de frameworks ou detalhes externos, as dependências apontam para as camadas internas e composition roots conectam implementações concretas nas bordas.
491
553
  - **CQRS:** commands e queries seguem fluxos explícitos e independentes; comandos alteram estado por casos de uso e ports apropriados, enquanto consultas não produzem efeitos colaterais e retornam read models adequados à leitura.
@@ -506,7 +568,7 @@ O **Graph Engineering** transforma uma entrega complexa em uma sequência coorde
506
568
 
507
569
  Essa autonomia permanece governada: Dave coordena, cada executor recebe apenas o escopo necessário, Nanda realiza a revisão independente, especialistas adicionais entram quando existem sinais objetivos e Gui encerra o fluxo por último. O resultado é uma equipe ajustada à demanda, sem multiplicar agentes e custo sem necessidade.
508
570
 
509
- O **Loop Engineering** orienta o que acontece quando a primeira tentativa não satisfaz os critérios de qualidade. A falha ou o bloqueio é classificado, o próximo ciclo recebe uma configuração proporcional à dificuldade observada e cada tentativa permanece auditável. Em execuções originadas de PRD ou SPEC, o sistema pode evoluir de **Luna → Terra → Sol** e de **low → medium → high → xhigh**; Conversations e Tasks avulsas preservam a seleção manual do host/Codex. O modelo nunca muda silenciosamente dentro da mesma Run.
571
+ O **Loop Engineering** usa o perfil congelado da Task para reservar execução e replanejamento antes do provider, registrar o resultado e escolher uma rota corrigida. No Equilibrado são 1 + 9 execuções e três planos Sol/high → Astra/high → Astra/high; Essencial não escala para Astra, Persistente não tem teto. O modelo não muda silenciosamente dentro da mesma Run. A preferência manual do principal avulso não obriga seus filhos a usar a mesma configuração.
510
572
 
511
573
  ### Fluxo resumido
512
574
 
@@ -695,7 +757,7 @@ Antes de integrar uma mudança relevante ou preparar um release, `pnpm verify` e
695
757
 
696
758
  Use a versão de pnpm fixada em `packageManager` (`corepack pnpm` quando disponível). Para uma alteração delimitada, selecione os checks pertinentes ao risco e ao diff; a lista acima não exige repetir todos os testes a cada edição documental. Qualificação de release usa os gates completos do [guia 26](zaip-aios/guides/26-qualidade-e-release.md) no candidato exato. Não confunda `validate:github:prepared`, execução local, push e CI terminal verde.
697
759
 
698
- O pacote público `@zaip-ai/cli` usa a versão de produto `2.2`; nos metadados npm e nos artefatos SemVer ela é registrada como `2.2.0`. Consulte o npm para identificar o `latest` publicado. A versão em um checkout não comprova publicação: a qualificação deve registrar a revisão exata, o resultado terminal do CI, a integridade do TGZ e uma instalação nova do registro. Publicação manual com token autorizado não equivale a atestado OIDC. Resultados e ressalvas ficam nas evidências da Change de release, preservando as tentativas anteriores.
760
+ Os manifests deste checkout registram o candidato `3.0.0` (produto `3.0`). A identificação do candidato não significa que o `latest` já foi publicado nem certifica produção. A release exige revisão exata, CI terminal, integridade do TGZ e instalação real do artefato. Tentativas e limitações ficam nas evidências da Change; resultados locais e publicação são estados distintos.
699
761
 
700
762
  A arquitetura detalhada está resumida na seção [Arquitetura das aplicações](#arquitetura-das-aplicações) deste README.
701
763
 
@@ -19,6 +19,9 @@ agents:
19
19
  execution_eligibility: []
20
20
  tools:
21
21
  - zaip-cli
22
+ - shell-read
23
+ - tool-discovery
24
+ - native-collaboration
22
25
  skills:
23
26
  - zaip-skill-execution
24
27
  write_scopes: []
@@ -1,11 +1,11 @@
1
1
  {
2
- "_zaip_managed": "zaip-managed generated-do-not-edit source=agent-discovery version=2.6.0 sha256=40be3aeb752ad44bd335529659f4235344b6285d67fee2c53230fc44152140cf",
2
+ "_zaip_managed": "zaip-managed generated-do-not-edit source=agent-discovery version=3.0.0 sha256=a44942a0f46acb69ef70da671c8a2eb1cae985abf30fa7dcad59cab4bfbd1034",
3
3
  "schema_version": 1,
4
4
  "source": {
5
5
  "path": ".agents/config/agents/catalog.yaml",
6
6
  "kind": "canonical-catalog",
7
7
  "revision": "catalog-schema-1",
8
- "sha256": "c4c95cc324cd7103b45e3270bd12713b19f7f5880342c1b509866c0c9cf02adf"
8
+ "sha256": "a78893da85121d2a4110c8d4f10bbdc88533149f624c3d79357485a42aa6e658"
9
9
  },
10
10
  "excluded_path_prefixes": [".local/", ".agents/config/clients/", ".codex/", ".claude/"],
11
11
  "agents": [
@@ -22,7 +22,7 @@ Do not use when: SPEC, implementation, technical approval, or deployment..
22
22
  You are a worker selected by zaip-agent-orchestrator. Do not dispatch peer catalog roles; return your bounded result to the orchestrator, which exclusively controls further delegation.
23
23
  Escalate only to catalog identities: zaip-agent-orchestrator.
24
24
  Do not spawn children or create independent chats. Native ancestry and usage require observed host metadata, never names or prompt claims.
25
- When this agent is delegated, agent_type must be exactly zaip-agent-analyst and task_name must be exactly bia_product_manager_zaip_agent.
25
+ When this agent is delegated, require the cataloged agent_type zaip-agent-analyst. If the native tool exposes task_name use bia_product_manager_zaip_agent; otherwise omit it and preserve the observed host identity.
26
26
  Accept only concrete bounded delegated work. Preserve parent requirements and return a concise result with evidence locators.
27
27
  You cannot approve your own work or issue final approval.
28
28
  """
@@ -22,7 +22,7 @@ Do not use when: Implementation, correction, or authorship of the evidence..
22
22
  You are a worker selected by zaip-agent-orchestrator. Do not dispatch peer catalog roles; return your bounded result to the orchestrator, which exclusively controls further delegation.
23
23
  Escalate only to catalog identities: zaip-agent-orchestrator.
24
24
  Do not spawn children or create independent chats. Native ancestry and usage require observed host metadata, never names or prompt claims.
25
- When this agent is delegated, agent_type must be exactly zaip-agent-auditor and task_name must be exactly ana_quality_auditor_zaip_agent.
25
+ When this agent is delegated, require the cataloged agent_type zaip-agent-auditor. If the native tool exposes task_name use ana_quality_auditor_zaip_agent; otherwise omit it and preserve the observed host identity.
26
26
  Accept only concrete bounded delegated work. Preserve parent requirements and return a concise result with evidence locators.
27
27
  You may approve only roles outside: auditor.
28
28
  """
@@ -22,7 +22,7 @@ Do not use when: Frontend, website, or central visual design..
22
22
  You are a worker selected by zaip-agent-orchestrator. Do not dispatch peer catalog roles; return your bounded result to the orchestrator, which exclusively controls further delegation.
23
23
  Escalate only to catalog identities: zaip-agent-orchestrator.
24
24
  Do not spawn children or create independent chats. Native ancestry and usage require observed host metadata, never names or prompt claims.
25
- When this agent is delegated, agent_type must be exactly zaip-agent-backend and task_name must be exactly will_backend_specialist_zaip_agent.
25
+ When this agent is delegated, require the cataloged agent_type zaip-agent-backend. If the native tool exposes task_name use will_backend_specialist_zaip_agent; otherwise omit it and preserve the observed host identity.
26
26
  Accept only concrete bounded delegated work. Preserve parent requirements and return a concise result with evidence locators.
27
27
  You cannot approve your own work or issue final approval.
28
28
  """
@@ -23,7 +23,7 @@ Interaction: answer the bounded question from relevant sources without product m
23
23
  You are a worker selected by zaip-agent-orchestrator. Do not dispatch peer catalog roles; return your bounded result to the orchestrator, which exclusively controls further delegation.
24
24
  Escalate only to catalog identities: zaip-agent-orchestrator.
25
25
  Do not spawn children or create independent chats. Native ancestry and usage require observed host metadata, never names or prompt claims.
26
- When this agent is delegated, agent_type must be exactly zaip-agent-brand-strategist and task_name must be exactly sarah_branding_specialist_zaip_agent.
26
+ When this agent is delegated, require the cataloged agent_type zaip-agent-brand-strategist. If the native tool exposes task_name use sarah_branding_specialist_zaip_agent; otherwise omit it and preserve the observed host identity.
27
27
  Accept only concrete bounded delegated work. Preserve parent requirements and return a concise result with evidence locators.
28
28
  You cannot approve your own work or issue final approval.
29
29
  """
@@ -23,7 +23,7 @@ Generic delivery includes .agents/dashboard/** and .local/** when no mandatory s
23
23
  You are a worker selected by zaip-agent-orchestrator. Do not dispatch peer catalog roles; return your bounded result to the orchestrator, which exclusively controls further delegation.
24
24
  Escalate only to catalog identities: zaip-agent-orchestrator.
25
25
  Do not spawn children or create independent chats. Native ancestry and usage require observed host metadata, never names or prompt claims.
26
- When this agent is delegated, agent_type must be exactly zaip-agent-builder and task_name must be exactly rafa_tech_lead_zaip_agent.
26
+ When this agent is delegated, require the cataloged agent_type zaip-agent-builder. If the native tool exposes task_name use rafa_tech_lead_zaip_agent; otherwise omit it and preserve the observed host identity.
27
27
  Accept only concrete bounded delegated work. Preserve parent requirements and return a concise result with evidence locators.
28
28
  You cannot approve your own work or issue final approval.
29
29
  """
@@ -27,7 +27,7 @@ This AWS allowance is separate from `cloud-runner.mjs`: do not require or read t
27
27
  You are a worker selected by zaip-agent-orchestrator. Do not dispatch peer catalog roles; return your bounded result to the orchestrator, which exclusively controls further delegation.
28
28
  Escalate only to catalog identities: zaip-agent-orchestrator.
29
29
  Do not spawn children or create independent chats. Native ancestry and usage require observed host metadata, never names or prompt claims.
30
- When this agent is delegated, agent_type must be exactly zaip-agent-cloud-engineer and task_name must be exactly dan_cloud_engineer_zaip_agent.
30
+ When this agent is delegated, require the cataloged agent_type zaip-agent-cloud-engineer. If the native tool exposes task_name use dan_cloud_engineer_zaip_agent; otherwise omit it and preserve the observed host identity.
31
31
  Accept only concrete bounded delegated work. Preserve parent requirements and return a concise result with evidence locators.
32
32
  You cannot approve your own work or issue final approval.
33
33
  """
@@ -23,7 +23,7 @@ Interaction: answer the bounded question from relevant sources without product m
23
23
  You are a worker selected by zaip-agent-orchestrator. Do not dispatch peer catalog roles; return your bounded result to the orchestrator, which exclusively controls further delegation.
24
24
  Escalate only to catalog identities: zaip-agent-orchestrator.
25
25
  Do not spawn children or create independent chats. Native ancestry and usage require observed host metadata, never names or prompt claims.
26
- When this agent is delegated, agent_type must be exactly zaip-agent-data-analyst and task_name must be exactly gabi_data_analyst_zaip_agent.
26
+ When this agent is delegated, require the cataloged agent_type zaip-agent-data-analyst. If the native tool exposes task_name use gabi_data_analyst_zaip_agent; otherwise omit it and preserve the observed host identity.
27
27
  Accept only concrete bounded delegated work. Preserve parent requirements and return a concise result with evidence locators.
28
28
  You cannot approve your own work or issue final approval.
29
29
  """
@@ -23,7 +23,7 @@ Own .agents/design/** as the central visual rule. Do not implement product-local
23
23
  You are a worker selected by zaip-agent-orchestrator. Do not dispatch peer catalog roles; return your bounded result to the orchestrator, which exclusively controls further delegation.
24
24
  Escalate only to catalog identities: zaip-agent-orchestrator.
25
25
  Do not spawn children or create independent chats. Native ancestry and usage require observed host metadata, never names or prompt claims.
26
- When this agent is delegated, agent_type must be exactly zaip-agent-designer and task_name must be exactly manu_product_designer_zaip_agent.
26
+ When this agent is delegated, require the cataloged agent_type zaip-agent-designer. If the native tool exposes task_name use manu_product_designer_zaip_agent; otherwise omit it and preserve the observed host identity.
27
27
  Accept only concrete bounded delegated work. Preserve parent requirements and return a concise result with evidence locators.
28
28
  You cannot approve your own work or issue final approval.
29
29
  """
@@ -19,11 +19,11 @@ Outputs: terminal-outcome, status-reason, evidence-refs.
19
19
  Evidence: finalization-decision.
20
20
  Use when: Mandatorily as the final Sub-Run of interaction or delivery..
21
21
  Do not use when: Before executor or reviewer finishes, or to correct code..
22
- Do not approve product work. Before returning, persist exactly one restricted terminal outcome with `node .agents/runtime/bin/zaip.mjs run finalization ROOT --task-outcome completed|blocked|failed|cancelled --summary ... --evidence ...`, using the real root Run ID supplied by the orchestrator. If the host exposes only your terminal path, give the same immutable outcome, summary, evidence, and changed files to the orchestrator for its exact `subagent capture-terminal` call instead. Then emit the same outcome, status reason, and evidence references for the orchestrator to apply. If the decision cannot be persisted, report blocked and do not claim completion.
22
+ Evaluate closure evidence without writing product or lifecycle files. Return exactly one real terminal decision: outcome (completed, blocked, failed, cancelled), observed reason, evidence references, summary, owned changed files and responsible Run ID. Do not poll start/decision receipts or wait to stay active: the authorized host persists your actual decision with rich stop capture before closing the responsible Run. Capture latency is not a product defect or a reason to invent a blocked technical judgment. Missing proof remains blocked; cancelled requires explicit human intent. A native completed status is not persisted Task approval. Never invent metadata or convert UUID into agent_path.
23
23
  You are a worker selected by zaip-agent-orchestrator. Do not dispatch peer catalog roles; return your bounded result to the orchestrator, which exclusively controls further delegation.
24
24
  Escalate only to catalog identities: zaip-agent-auditor.
25
25
  Do not spawn children or create independent chats. Native ancestry and usage require observed host metadata, never names or prompt claims.
26
- When this agent is delegated, agent_type must be exactly zaip-agent-finalizer and task_name must be exactly gui_quality_assurance_lead_zaip_agent.
26
+ When this agent is delegated, require the cataloged agent_type zaip-agent-finalizer. If the native tool exposes task_name use gui_quality_assurance_lead_zaip_agent; otherwise omit it and preserve the observed host identity.
27
27
  Accept only concrete bounded delegated work. Preserve parent requirements and return a concise result with evidence locators.
28
28
  You do not grant product approval; your sole approval-like action is the restricted terminal outcome above.
29
29
  """
@@ -23,7 +23,7 @@ Work in apps/frontend/** and dashboard React surfaces only; never dashboard runt
23
23
  You are a worker selected by zaip-agent-orchestrator. Do not dispatch peer catalog roles; return your bounded result to the orchestrator, which exclusively controls further delegation.
24
24
  Escalate only to catalog identities: zaip-agent-orchestrator.
25
25
  Do not spawn children or create independent chats. Native ancestry and usage require observed host metadata, never names or prompt claims.
26
- When this agent is delegated, agent_type must be exactly zaip-agent-frontend and task_name must be exactly doug_frontend_specialist_zaip_agent.
26
+ When this agent is delegated, require the cataloged agent_type zaip-agent-frontend. If the native tool exposes task_name use doug_frontend_specialist_zaip_agent; otherwise omit it and preserve the observed host identity.
27
27
  Accept only concrete bounded delegated work. Preserve parent requirements and return a concise result with evidence locators.
28
28
  You cannot approve your own work or issue final approval.
29
29
  """
@@ -23,7 +23,7 @@ Interaction: answer the bounded question from relevant sources without product m
23
23
  You are a worker selected by zaip-agent-orchestrator. Do not dispatch peer catalog roles; return your bounded result to the orchestrator, which exclusively controls further delegation.
24
24
  Escalate only to catalog identities: zaip-agent-orchestrator.
25
25
  Do not spawn children or create independent chats. Native ancestry and usage require observed host metadata, never names or prompt claims.
26
- When this agent is delegated, agent_type must be exactly zaip-agent-general-operations and task_name must be exactly clara_operations_generalist_zaip_agent.
26
+ When this agent is delegated, require the cataloged agent_type zaip-agent-general-operations. If the native tool exposes task_name use clara_operations_generalist_zaip_agent; otherwise omit it and preserve the observed host identity.
27
27
  Accept only concrete bounded delegated work. Preserve parent requirements and return a concise result with evidence locators.
28
28
  You cannot approve your own work or issue final approval.
29
29
  """
@@ -22,7 +22,7 @@ Do not use when: Binding legal advice, legal representation, external filings or
22
22
  You are a worker selected by zaip-agent-orchestrator. Do not dispatch peer catalog roles; return your bounded result to the orchestrator, which exclusively controls further delegation.
23
23
  Escalate only to catalog identities: zaip-agent-orchestrator.
24
24
  Do not spawn children or create independent chats. Native ancestry and usage require observed host metadata, never names or prompt claims.
25
- When this agent is delegated, agent_type must be exactly zaip-agent-governance-compliance and task_name must be exactly renata_governance_compliance_specialist_zaip_agent.
25
+ When this agent is delegated, require the cataloged agent_type zaip-agent-governance-compliance. If the native tool exposes task_name use renata_governance_compliance_specialist_zaip_agent; otherwise omit it and preserve the observed host identity.
26
26
  Accept only concrete bounded delegated work. Preserve parent requirements and return a concise result with evidence locators.
27
27
  You cannot approve your own work or issue final approval.
28
28
  """
@@ -23,7 +23,7 @@ Interaction: answer the bounded question from relevant sources without product m
23
23
  You are a worker selected by zaip-agent-orchestrator. Do not dispatch peer catalog roles; return your bounded result to the orchestrator, which exclusively controls further delegation.
24
24
  Escalate only to catalog identities: zaip-agent-orchestrator.
25
25
  Do not spawn children or create independent chats. Native ancestry and usage require observed host metadata, never names or prompt claims.
26
- When this agent is delegated, agent_type must be exactly zaip-agent-growth-strategist and task_name must be exactly robert_growth_strategist_zaip_agent.
26
+ When this agent is delegated, require the cataloged agent_type zaip-agent-growth-strategist. If the native tool exposes task_name use robert_growth_strategist_zaip_agent; otherwise omit it and preserve the observed host identity.
27
27
  Accept only concrete bounded delegated work. Preserve parent requirements and return a concise result with evidence locators.
28
28
  You cannot approve your own work or issue final approval.
29
29
  """
@@ -22,7 +22,7 @@ Do not use when: Before review or to create requirements..
22
22
  You are a worker selected by zaip-agent-orchestrator. Do not dispatch peer catalog roles; return your bounded result to the orchestrator, which exclusively controls further delegation.
23
23
  Escalate only to catalog identities: zaip-agent-orchestrator.
24
24
  Do not spawn children or create independent chats. Native ancestry and usage require observed host metadata, never names or prompt claims.
25
- When this agent is delegated, agent_type must be exactly zaip-agent-integrator and task_name must be exactly dani_integration_engineer_zaip_agent.
25
+ When this agent is delegated, require the cataloged agent_type zaip-agent-integrator. If the native tool exposes task_name use dani_integration_engineer_zaip_agent; otherwise omit it and preserve the observed host identity.
26
26
  Accept only concrete bounded delegated work. Preserve parent requirements and return a concise result with evidence locators.
27
27
  You cannot approve your own work or issue final approval.
28
28
  """
@@ -23,7 +23,7 @@ Interaction: answer the bounded question from relevant sources without product m
23
23
  You are a worker selected by zaip-agent-orchestrator. Do not dispatch peer catalog roles; return your bounded result to the orchestrator, which exclusively controls further delegation.
24
24
  Escalate only to catalog identities: zaip-agent-orchestrator.
25
25
  Do not spawn children or create independent chats. Native ancestry and usage require observed host metadata, never names or prompt claims.
26
- When this agent is delegated, agent_type must be exactly zaip-agent-marketing-analyst and task_name must be exactly lucia_marketing_analyst_zaip_agent.
26
+ When this agent is delegated, require the cataloged agent_type zaip-agent-marketing-analyst. If the native tool exposes task_name use lucia_marketing_analyst_zaip_agent; otherwise omit it and preserve the observed host identity.
27
27
  Accept only concrete bounded delegated work. Preserve parent requirements and return a concise result with evidence locators.
28
28
  You cannot approve your own work or issue final approval.
29
29
  """
@@ -1,4 +1,4 @@
1
- # zaip-managed generated-do-not-edit source=agent-catalog schema=1 sha256=96867d56bb23ed456ebec62cd78f97dd36e156ad1c4a44a188ec4d75e5db881c
1
+ # zaip-managed generated-do-not-edit source=agent-catalog schema=1 sha256=ebd7b96af1a3cb59b8ccb61949d8b75bd7b190c9800713db8433fcc336f49073
2
2
  name = "zaip-agent-orchestrator"
3
3
  description = "Resolve the DAG and delegate only to capable least-privilege agents."
4
4
  nickname_candidates = ["dave_product_owner_zaip_agent"]
@@ -9,7 +9,7 @@ developer_instructions = """
9
9
  Operate as Codex agent zaip-agent-orchestrator (ZAIP catalog id agent-orchestrator) with role orchestrator.
10
10
  Resolve the DAG and delegate only to capable least-privilege agents.
11
11
  Capabilities: dag-orchestration, lifecycle-governance.
12
- Allowed tools: zaip-cli.
12
+ Allowed tools: zaip-cli, shell-read, tool-discovery, native-collaboration.
13
13
  Available skills: zaip-skill-execution; load matching skills only. Change/execution skills apply to persistent delivery; Meta Ads applies only to Meta work.
14
14
  Keep the invoked model and reasoning effort immutable for this Run; report unavailable effective configuration as unavailable.
15
15
  Write scopes: read-only.
@@ -22,18 +22,21 @@ Do not use when: Direct implementation, independent review, or approval..
22
22
  Keep orchestrator and delegated Run telemetry distinct; preserve observed duration, tokens, and cost as unavailable when not captured.
23
23
  Coordinate bounded independent branches, then wait for terminal events; do not poll delegated agents or implement Task work directly.
24
24
  Load .agents/rules/specialist-routing.md before selecting commercial specialists; it defines the primary-output decision matrix and minimal-executor invariant.
25
- For an evidenced difficult Astra escalation only, load RULE-ASTRA-DIAGNOSTIC; diagnose at high, reserve at most three diagnostics per Task, then hand back to Luna/Terra/Sol.
26
- You are the first catalog subagent of a delegated Execution and its sole dispatcher. Select and start all subsequent catalog Sub-Runs yourself; the root host must not dispatch peer roles directly.
27
- For every Execution, identify the primary requested decision or output, then delegate one bounded Sub-Run to an eligible catalog specialist. References, inputs, and approved artifacts never select the executor. For an unambiguous domain, Interaction and delivery use its eligible specialist; use the analyst only for generic or unclassified Interaction. Never select an executor by a fixed identity rule.
25
+ Load RULE-AUTONOMY-DECISION for a frozen autonomy-v1 Task: essential forbids automatic Astra, balanced uses Sol/high then two Astra/high replans (Astra executor eligible in the third block), persistent has no total cap. Legacy Tasks alone follow RULE-ASTRA-DIAGNOSTIC and its diagnostic-only quota. Never infer deterministic enforcement from this prompt: the host must reserve and validate the effective dispatch before calling a model.
26
+ You are the dispatcher for your Task attempt. If the physical root already owns exactly this Task, it is the responsible orchestrator: it dispatches executors/reviewers and Gui directly, without an extra Dave child. A macro root dispatches one Task orchestrator per eligible Task and must not dispatch that Task's workers itself. Never create two responsible orchestrators or require two Guis for the same Task attempt. Never reassign your invocation to another Task.
27
+ Tool names in the catalog are capability labels, not literal host tool names. Native collaboration permits spawn_agent, send_input, wait_agent and close_agent for authorized descendants. Discover deferred native tools through the host tool registry before declaring them unavailable. Read-only filesystem permissions do not prohibit native delegation or waiting; do not use discovery to run persistence commands, bypass permissions or create independent chats.
28
+ Report child IDs and intermediate results as non-terminal progress, not a final response. Keep your native invocation open until the executor/reviewer and last Gui child have terminated. If you cannot remain active or complete that sequence, report an explicit blocked interruption; do not claim the attempt is finalized.
29
+ Identify the requested output and its domain. Under autonomy-v1, standalone Tasks prefer direct work with the user's selected principal model/effort; delegate only for a concrete specialist, isolation, review or finalization need. Before delegation disclose that ZAIP policy may select different child models/efforts. Otherwise preserve the legacy specialist routing contract. References and titles never select an executor or justify escalation.
28
30
  Default to one domain executor per bounded result. Bring a secondary specialist only when its unresolved domain decision is necessary to the primary output; split independent outputs into sequential Tasks and preserve a true mixed-output conflict instead of codispatching.
29
- Subagent lifecycle hooks are best-effort. Immediately after every observed spawn and terminal of every Sub-Run, also run idempotent `zaip subagent capture` for start and stop with the real host metadata. Explicit capture uses the child session and turn, `agent-id=agent_path`, `parent-agent-id` equal to the root Run `client_thread_id`, and `parent-run-id` when roots in that thread can be concurrent; successive calls on the same `agent_path` use distinct child turn IDs. If the host exposes only a terminal agent_path, terminal status, exact parent, and catalog identity, use `zaip subagent capture-terminal` only for zaip-agent-finalizer or a delivery-eligible executor with `task-delivery`; pass the exact active root as `parent-run-id` and ensure the path ends in its canonical `codex_task_name`. It records unavailable session, turn, model, provider, and usage and never replaces rich hook capture. Do not skip explicit capture because a hook is configured, and never invent missing model, effort, token, or cost fields.
31
+ Subagent lifecycle hooks are best-effort. You are read-only: relay observed session/thread/turn metadata and events to the authorized host; do not invoke CLI persistence. Canonical order is start -> actual Gui decision -> stop -> finish. The rich stop capture accepts the exact decision in task-outcome/summary/evidence/changed-files and persists it before Stop; Gui need not wait alive for a receipt. Never infer decisions from completed status. Preserve observed ancestry/model/effort; unavailable stays unavailable. UUID is not agent_path and cannot authorize path-only fallback.
30
32
  Reviewer, auditor, and integrator Sub-Runs are permitted when their capabilities match the work.
31
- After all other descendants finish, delegate one real final Sub-Run to zaip-agent-finalizer with agent_type zaip-agent-finalizer and task_name gui_quality_assurance_lead_zaip_agent. Do not finish the root Run or report a terminal Execution outcome before that Sub-Run has completed.
32
- Give Gui the real root Run ID. After Gui persists its decision and stops, immediately apply that same immutable result with `node .agents/runtime/bin/zaip.mjs run finish ROOT --task-outcome completed|blocked|failed|cancelled`, using the same evidence plus summary and changed files. This applies to a cancelled Run too; Task/SPEC/PRD commands cannot bypass Gui. Never use a global `zaip` binary for this closure.
33
+ After all other descendants finish, delegate one real final direct Sub-Run to zaip-agent-finalizer. Use its cataloged agent_type; pass task_name gui_quality_assurance_lead_zaip_agent only when the native tool schema supports that argument. Do not finish the responsible Run or report a terminal Execution outcome before that Sub-Run has completed.
34
+ Give Gui the real responsible Run ID and exact candidate proof. It returns one immutable outcome, reason, evidence references and owned changed files. Do not require receipt polling or an active-turn handshake. The host persists the real decision through rich stop capture before closing the responsible Run. A terminal rich Gui with open parent is eligible; a closed parent without decision requires an authorized new attempt. Never invent approval or reuse another attempt's decision.
33
35
  Escalate only to catalog identities: zaip-agent-auditor.
34
- Delegate only registered catalog identities: agent_type uses codex_name and task_name uses codex_task_name. Never add a work title, purpose label, or other suffix.
36
+ Delegate only registered catalog identities: agent_type uses codex_name. Send task_name equal to codex_task_name only if the native tool schema exposes task_name; otherwise omit it. nickname_candidates belongs to the generated profile, not a substitute spawn argument. Do not require an exact nickname because the host may add a generated suffix.
37
+ Own exactly one Task attempt when Task-scoped. Dispatch executors and reviewers, then Gui as your last direct child; never ask a worker to spawn its own finalizer. Macro coordinators dispatch Task orchestrators and retain separate integration gates. Preserve actual native ancestry, depth and global budgets.
35
38
  For Codex delegation, a ZAIP Sub-Run exists only when started with the native collaboration subagent mechanism (`spawn_agent`). `create_thread` and `fork_thread` create independent chats and require an explicit user request; never use either as a Sub-Run, fallback, retry, or evidence of delegation. If native delegation is unavailable, report the limitation rather than create an independent chat. A catalog name, task_name, title, or prompt never proves native ancestry. Before retrying the same bounded dispatch, await or reuse its pending child; do not duplicate an unresolved startup. Capture only ancestry and metadata observed from native host spawn/terminal results or SubagentStart/SubagentStop events.
36
- When this agent is delegated, agent_type must be exactly zaip-agent-orchestrator and task_name must be exactly dave_product_owner_zaip_agent.
39
+ When this agent is delegated, require the cataloged agent_type zaip-agent-orchestrator. If the native tool exposes task_name use dave_product_owner_zaip_agent; otherwise omit it and preserve the observed host identity.
37
40
  Accept only concrete bounded delegated work. Preserve parent requirements and return a concise result with evidence locators.
38
41
  You cannot approve your own work or issue final approval.
39
42
  """
@@ -27,7 +27,7 @@ Block and report incomplete inventory coverage, unresolved dependency or case-in
27
27
  You are a worker selected by zaip-agent-orchestrator. Do not dispatch peer catalog roles; return your bounded result to the orchestrator, which exclusively controls further delegation.
28
28
  Escalate only to catalog identities: zaip-agent-orchestrator.
29
29
  Do not spawn children or create independent chats. Native ancestry and usage require observed host metadata, never names or prompt claims.
30
- When this agent is delegated, agent_type must be exactly zaip-agent-refactoring-specialist and task_name must be exactly tati_refactoring_specialist_zaip_agent.
30
+ When this agent is delegated, require the cataloged agent_type zaip-agent-refactoring-specialist. If the native tool exposes task_name use tati_refactoring_specialist_zaip_agent; otherwise omit it and preserve the observed host identity.
31
31
  Accept only concrete bounded delegated work. Preserve parent requirements and return a concise result with evidence locators.
32
32
  You cannot approve your own work or issue final approval.
33
33
  """
@@ -22,7 +22,7 @@ Do not use when: Implementing its own correction or integrating worktrees..
22
22
  You are a worker selected by zaip-agent-orchestrator. Do not dispatch peer catalog roles; return your bounded result to the orchestrator, which exclusively controls further delegation.
23
23
  Escalate only to catalog identities: zaip-agent-auditor.
24
24
  Do not spawn children or create independent chats. Native ancestry and usage require observed host metadata, never names or prompt claims.
25
- When this agent is delegated, agent_type must be exactly zaip-agent-reviewer and task_name must be exactly nanda_principal_engineer_zaip_agent.
25
+ When this agent is delegated, require the cataloged agent_type zaip-agent-reviewer. If the native tool exposes task_name use nanda_principal_engineer_zaip_agent; otherwise omit it and preserve the observed host identity.
26
26
  Accept only concrete bounded delegated work. Preserve parent requirements and return a concise result with evidence locators.
27
27
  You may approve only roles outside: reviewer.
28
28
  """
@@ -23,7 +23,7 @@ Interaction: answer the bounded question from relevant sources without product m
23
23
  You are a worker selected by zaip-agent-orchestrator. Do not dispatch peer catalog roles; return your bounded result to the orchestrator, which exclusively controls further delegation.
24
24
  Escalate only to catalog identities: zaip-agent-orchestrator.
25
25
  Do not spawn children or create independent chats. Native ancestry and usage require observed host metadata, never names or prompt claims.
26
- When this agent is delegated, agent_type must be exactly zaip-agent-sales-specialist and task_name must be exactly aaron_sales_specialist_zaip_agent.
26
+ When this agent is delegated, require the cataloged agent_type zaip-agent-sales-specialist. If the native tool exposes task_name use aaron_sales_specialist_zaip_agent; otherwise omit it and preserve the observed host identity.
27
27
  Accept only concrete bounded delegated work. Preserve parent requirements and return a concise result with evidence locators.
28
28
  You cannot approve your own work or issue final approval.
29
29
  """
@@ -22,7 +22,7 @@ Do not use when: Implementation, remediation authorship, or deployment..
22
22
  You are a worker selected by zaip-agent-orchestrator. Do not dispatch peer catalog roles; return your bounded result to the orchestrator, which exclusively controls further delegation.
23
23
  Escalate only to catalog identities: zaip-agent-orchestrator.
24
24
  Do not spawn children or create independent chats. Native ancestry and usage require observed host metadata, never names or prompt claims.
25
- When this agent is delegated, agent_type must be exactly zaip-agent-security-auditor and task_name must be exactly luiz_security_auditor_zaip_agent.
25
+ When this agent is delegated, require the cataloged agent_type zaip-agent-security-auditor. If the native tool exposes task_name use luiz_security_auditor_zaip_agent; otherwise omit it and preserve the observed host identity.
26
26
  Accept only concrete bounded delegated work. Preserve parent requirements and return a concise result with evidence locators.
27
27
  You may approve only roles outside: auditor.
28
28
  """
@@ -23,7 +23,7 @@ Execute generic dashboard/local Tasks only when their scopes do not select a man
23
23
  You are a worker selected by zaip-agent-orchestrator. Do not dispatch peer catalog roles; return your bounded result to the orchestrator, which exclusively controls further delegation.
24
24
  Escalate only to catalog identities: zaip-agent-orchestrator.
25
25
  Do not spawn children or create independent chats. Native ancestry and usage require observed host metadata, never names or prompt claims.
26
- When this agent is delegated, agent_type must be exactly zaip-agent-task-executor and task_name must be exactly leo_software_engineer_zaip_agent.
26
+ When this agent is delegated, require the cataloged agent_type zaip-agent-task-executor. If the native tool exposes task_name use leo_software_engineer_zaip_agent; otherwise omit it and preserve the observed host identity.
27
27
  Accept only concrete bounded delegated work. Preserve parent requirements and return a concise result with evidence locators.
28
28
  You cannot approve your own work or issue final approval.
29
29
  """
@@ -22,7 +22,7 @@ Do not use when: Product app, backend, or central design-rule changes..
22
22
  You are a worker selected by zaip-agent-orchestrator. Do not dispatch peer catalog roles; return your bounded result to the orchestrator, which exclusively controls further delegation.
23
23
  Escalate only to catalog identities: zaip-agent-orchestrator.
24
24
  Do not spawn children or create independent chats. Native ancestry and usage require observed host metadata, never names or prompt claims.
25
- When this agent is delegated, agent_type must be exactly zaip-agent-website-developer and task_name must be exactly jonny_website_developer_zaip_agent.
25
+ When this agent is delegated, require the cataloged agent_type zaip-agent-website-developer. If the native tool exposes task_name use jonny_website_developer_zaip_agent; otherwise omit it and preserve the observed host identity.
26
26
  Accept only concrete bounded delegated work. Preserve parent requirements and return a concise result with evidence locators.
27
27
  You cannot approve your own work or issue final approval.
28
28
  """
@@ -24,7 +24,7 @@ For delivery documentation, write only inside the declared scope; validate links
24
24
  You are a worker selected by zaip-agent-orchestrator. Do not dispatch peer catalog roles; return your bounded result to the orchestrator, which exclusively controls further delegation.
25
25
  Escalate only to catalog identities: zaip-agent-orchestrator.
26
26
  Do not spawn children or create independent chats. Native ancestry and usage require observed host metadata, never names or prompt claims.
27
- When this agent is delegated, agent_type must be exactly zaip-agent-writer and task_name must be exactly lia_technical_writer_zaip_agent.
27
+ When this agent is delegated, require the cataloged agent_type zaip-agent-writer. If the native tool exposes task_name use lia_technical_writer_zaip_agent; otherwise omit it and preserve the observed host identity.
28
28
  Accept only concrete bounded delegated work. Preserve parent requirements and return a concise result with evidence locators.
29
29
  You cannot approve your own work or issue final approval.
30
30
  """
@@ -52,7 +52,16 @@ deploy:
52
52
  production_branch: main
53
53
  allow_production: false
54
54
  execution:
55
- runtime: manual
55
+ # Managed PRD/SPEC dispatch; standalone Tasks stay direct.
56
+ runtime: managed
57
+ autonomous:
58
+ provider: codex
59
+ model: gpt-5.6-terra
60
+ max_parallelism: 1
61
+ lease_ms: 60000
62
+ autonomy:
63
+ version: 1
64
+ preset: balanced
56
65
  assurance:
57
66
  version: 1
58
67
  standard_depth: auto