@zaip-ai/cli 2.0.0 → 2.6.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 (460) hide show
  1. package/README.md +33 -14
  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 +30 -25
  5. package/dist/services/adapters.js.map +1 -1
  6. package/dist/services/agent-adapters.js +45 -15
  7. package/dist/services/agent-adapters.js.map +1 -1
  8. package/dist/services/agent-adapters.test.js +13 -7
  9. package/dist/services/agent-adapters.test.js.map +1 -1
  10. package/dist/services/agent-discovery.d.ts +27 -0
  11. package/dist/services/agent-discovery.d.ts.map +1 -0
  12. package/dist/services/agent-discovery.js +73 -0
  13. package/dist/services/agent-discovery.js.map +1 -0
  14. package/dist/services/codex-conversation-lifecycle-hook.d.ts.map +1 -1
  15. package/dist/services/codex-conversation-lifecycle-hook.js +153 -24
  16. package/dist/services/codex-conversation-lifecycle-hook.js.map +1 -1
  17. package/dist/services/codex-pre-tool-hook-template.d.ts.map +1 -1
  18. package/dist/services/codex-pre-tool-hook-template.js +146 -72
  19. package/dist/services/codex-pre-tool-hook-template.js.map +1 -1
  20. package/dist/services/codex-rules.d.ts +1 -1
  21. package/dist/services/codex-rules.d.ts.map +1 -1
  22. package/dist/services/codex-rules.js +3 -3
  23. package/dist/services/codex-subagent-hook-template.d.ts +1 -1
  24. package/dist/services/codex-subagent-hook-template.d.ts.map +1 -1
  25. package/dist/services/codex-subagent-hook-template.js +117 -66
  26. package/dist/services/codex-subagent-hook-template.js.map +1 -1
  27. package/dist/services/install-agents-template.d.ts.map +1 -1
  28. package/dist/services/install-agents-template.js +56 -6
  29. package/dist/services/install-agents-template.js.map +1 -1
  30. package/dist/services/logger.js +1 -1
  31. package/dist/services/logger.js.map +1 -1
  32. package/dist/services/logger.test.js +24 -3
  33. package/dist/services/logger.test.js.map +1 -1
  34. package/dist/services/runtime-template.test.js +138 -1
  35. package/dist/services/runtime-template.test.js.map +1 -1
  36. package/package.json +1 -1
  37. package/templates/.agents/.env.example +9 -3
  38. package/templates/.agents/README-ENG.md +47 -5
  39. package/templates/.agents/README.md +38 -9
  40. package/templates/.agents/architecture/software-architecture.md +1 -59
  41. package/templates/.agents/branding/brandbook.md +3 -0
  42. package/templates/.agents/config/agents/catalog.yaml +40 -28
  43. package/templates/.agents/config/agents/discovery.json +319 -0
  44. package/templates/.agents/config/clients/codex/agents/zaip-agent-analyst.toml +3 -6
  45. package/templates/.agents/config/clients/codex/agents/zaip-agent-auditor.toml +3 -6
  46. package/templates/.agents/config/clients/codex/agents/zaip-agent-backend.toml +4 -7
  47. package/templates/.agents/config/clients/codex/agents/zaip-agent-brand-strategist.toml +6 -8
  48. package/templates/.agents/config/clients/codex/agents/zaip-agent-builder.toml +4 -7
  49. package/templates/.agents/config/clients/codex/agents/zaip-agent-cloud-engineer.toml +13 -13
  50. package/templates/.agents/config/clients/codex/agents/zaip-agent-data-analyst.toml +5 -7
  51. package/templates/.agents/config/clients/codex/agents/zaip-agent-designer.toml +4 -7
  52. package/templates/.agents/config/clients/codex/agents/zaip-agent-finalizer.toml +3 -6
  53. package/templates/.agents/config/clients/codex/agents/zaip-agent-frontend.toml +4 -7
  54. package/templates/.agents/config/clients/codex/agents/zaip-agent-general-operations.toml +6 -8
  55. package/templates/.agents/config/clients/codex/agents/zaip-agent-governance-compliance.toml +3 -6
  56. package/templates/.agents/config/clients/codex/agents/zaip-agent-growth-strategist.toml +6 -8
  57. package/templates/.agents/config/clients/codex/agents/zaip-agent-integrator.toml +3 -6
  58. package/templates/.agents/config/clients/codex/agents/zaip-agent-marketing-analyst.toml +6 -8
  59. package/templates/.agents/config/clients/codex/agents/zaip-agent-orchestrator.toml +4 -5
  60. package/templates/.agents/config/clients/codex/agents/zaip-agent-refactoring-specialist.toml +3 -6
  61. package/templates/.agents/config/clients/codex/agents/zaip-agent-reviewer.toml +3 -6
  62. package/templates/.agents/config/clients/codex/agents/zaip-agent-sales-specialist.toml +6 -8
  63. package/templates/.agents/config/clients/codex/agents/zaip-agent-security-auditor.toml +3 -6
  64. package/templates/.agents/config/clients/codex/agents/zaip-agent-task-executor.toml +4 -7
  65. package/templates/.agents/config/clients/codex/agents/zaip-agent-website-developer.toml +4 -7
  66. package/templates/.agents/config/clients/codex/agents/zaip-agent-writer.toml +3 -6
  67. package/templates/.agents/config/pricing/models.json +57 -33
  68. package/templates/.agents/config/project.yaml +12 -1
  69. package/templates/.agents/dashboard/.zaip-managed.json +378 -98
  70. package/templates/.agents/dashboard/apps/frontend/dist/assets/CostCalculationGuidePage-CGxeQak4.js +1 -0
  71. package/templates/.agents/dashboard/apps/frontend/dist/assets/{DashboardHelpDialog-CYfpYsTr.js → DashboardHelpDialog-tzS7YxYB.js} +173 -47
  72. package/templates/.agents/dashboard/apps/frontend/dist/assets/PricingSettingsDialog-DEbCi1gP.js +1 -0
  73. package/templates/.agents/dashboard/apps/frontend/dist/assets/ProjectSettingsPage-1L7Qw-Gq.js +3 -0
  74. package/templates/.agents/dashboard/apps/frontend/dist/assets/ProjectSettingsPage-EInWr641.css +1 -0
  75. package/templates/.agents/dashboard/apps/frontend/dist/assets/TraceabilityWorkspace-t1Om0Abw.js +1 -0
  76. package/templates/.agents/dashboard/apps/frontend/dist/assets/cost-monitor-B6aZfo5f.js +68 -0
  77. package/templates/.agents/dashboard/apps/frontend/dist/assets/{icons-vendor-TPUT2IUt.js → icons-vendor-DiGC-dsJ.js} +1 -1
  78. package/templates/.agents/dashboard/apps/frontend/dist/assets/index-DgTmNHN5.js +2 -0
  79. package/templates/.agents/dashboard/apps/frontend/dist/assets/{react-vendor-Ct48XHGL.js → react-vendor-kPO6yNed.js} +1 -1
  80. package/templates/.agents/dashboard/apps/frontend/dist/assets/rolldown-runtime-Bh1tDfsg.js +1 -0
  81. package/templates/.agents/dashboard/apps/frontend/dist/assets/traceability-DQpKX9c1.js +1 -0
  82. package/templates/.agents/dashboard/apps/frontend/dist/index.html +6 -6
  83. package/templates/.agents/dashboard/apps/frontend/package.json +1 -1
  84. package/templates/.agents/dashboard/apps/frontend/src/App.tsx +3 -1264
  85. package/templates/.agents/dashboard/apps/frontend/src/AppDashboardContent.tsx +363 -0
  86. package/templates/.agents/dashboard/apps/frontend/src/ProjectSettingsPage.dom.test.ts +99 -0
  87. package/templates/.agents/dashboard/apps/frontend/src/ProjectSettingsPage.tsx +62 -6
  88. package/templates/.agents/dashboard/apps/frontend/src/ProjectStackEditor.tsx +3 -1
  89. package/templates/.agents/dashboard/apps/frontend/src/__tests__/app-composition-support.ts +7 -0
  90. package/templates/.agents/dashboard/apps/frontend/src/cost-period-refresh.test.ts +9 -7
  91. package/templates/.agents/dashboard/apps/frontend/src/dashboard-api-settings.ts +151 -0
  92. package/templates/.agents/dashboard/apps/frontend/src/dashboard-api.ts +28 -153
  93. package/templates/.agents/dashboard/apps/frontend/src/dashboard-app-shell.tsx +33 -0
  94. package/templates/.agents/dashboard/apps/frontend/src/dashboard-cost-facts.ts +30 -0
  95. package/templates/.agents/dashboard/apps/frontend/src/dashboard-project-overview.ts +7 -1
  96. package/templates/.agents/dashboard/apps/frontend/src/dashboard-retry.ts +17 -0
  97. package/templates/.agents/dashboard/apps/frontend/src/dashboard-setup-route.ts +29 -0
  98. package/templates/.agents/dashboard/apps/frontend/src/dashboard-view-actions.ts +66 -0
  99. package/templates/.agents/dashboard/apps/frontend/src/operations-period-render.test.ts +3 -2
  100. package/templates/.agents/dashboard/apps/frontend/src/overview-status-page.test.ts +2 -2
  101. package/templates/.agents/dashboard/apps/frontend/src/project-installation-status.test.ts +48 -0
  102. package/templates/.agents/dashboard/apps/frontend/src/project-installation-status.ts +29 -0
  103. package/templates/.agents/dashboard/apps/frontend/src/project-settings-page.css +68 -0
  104. package/templates/.agents/dashboard/apps/frontend/src/project-settings.test.ts +2 -2
  105. package/templates/.agents/dashboard/apps/frontend/src/sao-paulo-day-rollover.test.ts +36 -0
  106. package/templates/.agents/dashboard/apps/frontend/src/sao-paulo-day-rollover.ts +30 -0
  107. package/templates/.agents/dashboard/apps/frontend/src/snapshot-banner-semantics.test.ts +2 -5
  108. package/templates/.agents/dashboard/apps/frontend/src/snapshot-coherence.test.ts +30 -19
  109. package/templates/.agents/dashboard/apps/frontend/src/use-app-effects.ts +9 -1
  110. package/templates/.agents/dashboard/apps/frontend/src/use-app-trace-task-pagination.ts +77 -0
  111. package/templates/.agents/dashboard/apps/frontend/src/use-app-work-board.ts +397 -0
  112. package/templates/.agents/dashboard/apps/frontend/src/use-dashboard-app-model.tsx +782 -0
  113. package/templates/.agents/dashboard/apps/frontend/src/use-snapshot-notice.tsx +49 -0
  114. package/templates/.agents/dashboard/modules/cost-monitor/package.json +1 -1
  115. package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostDeveloperPanelSlot.tsx +16 -0
  116. package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostGroupsTable.tsx +459 -0
  117. package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostMonitorPage.test.ts +27 -17
  118. package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostMonitorPage.tsx +62 -186
  119. package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostMonitorRunDialog.tsx +20 -0
  120. package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostTables-hides-calls-that-have-no-collected.test.ts +80 -0
  121. package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostTables-keeps-legacy-codex-identity-fields-blank.test.ts +455 -0
  122. package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostTables.test.ts +18 -525
  123. package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostTables.tsx +32 -508
  124. package/templates/.agents/dashboard/modules/cost-monitor/src/react/cost-monitor-export-sources.ts +74 -0
  125. package/templates/.agents/dashboard/modules/cost-monitor/src/react/cost-monitor-page-actions.ts +19 -0
  126. package/templates/.agents/dashboard/modules/cost-monitor/src/react/cost-monitor-page-selectors.ts +49 -0
  127. package/templates/.agents/dashboard/modules/cost-monitor/src/react/cost-table-formatters.ts +115 -0
  128. package/templates/.agents/dashboard/modules/cost-monitor/src/server/build-cost-monitor-projection.test-fixtures.ts +2 -0
  129. package/templates/.agents/dashboard/modules/operations/package.json +1 -1
  130. package/templates/.agents/dashboard/modules/operations/src/contracts.ts +4 -0
  131. package/templates/.agents/dashboard/modules/operations/src/react/EntityTableBadges.tsx +34 -0
  132. package/templates/.agents/dashboard/modules/operations/src/react/EntityTables.tsx +8 -38
  133. package/templates/.agents/dashboard/modules/operations/src/react/OperationsOverview-keeps-structure-classes-mutually-exclusive.test.ts +243 -0
  134. package/templates/.agents/dashboard/modules/operations/src/react/OperationsOverview.test.ts +27 -275
  135. package/templates/.agents/dashboard/modules/operations/src/react/OperationsOverview.tsx +70 -247
  136. package/templates/.agents/dashboard/modules/operations/src/react/OperationsOverviewCharts.tsx +171 -0
  137. package/templates/.agents/dashboard/modules/operations/src/react/OperationsOverviewPanels.tsx +64 -0
  138. package/templates/.agents/dashboard/modules/operations/src/react/OperationsPage.tsx +4 -3
  139. package/templates/.agents/dashboard/modules/operations/src/react/PrdDocumentDialog.test.tsx +2 -1
  140. package/templates/.agents/dashboard/modules/operations/src/react/manual-work-priority.test.ts +2 -1
  141. package/templates/.agents/dashboard/modules/operations/src/react/operations-coverage-toast.test.ts +6 -2
  142. package/templates/.agents/dashboard/modules/operations/src/react/operations-overview-period-filter.test.ts +6 -14
  143. package/templates/.agents/dashboard/modules/operations/src/react/operations-overview.status-cards.test.ts +3 -1
  144. package/templates/.agents/dashboard/modules/operations/src/react/operations-page-contract.ts +2 -0
  145. package/templates/.agents/dashboard/modules/operations/src/react/overview-metric-format.ts +32 -0
  146. package/templates/.agents/dashboard/modules/traceability/package.json +1 -1
  147. package/templates/.agents/dashboard/packages/branding/package.json +1 -1
  148. package/templates/.agents/dashboard/packages/branding/src/index.ts +1 -1
  149. package/templates/.agents/dashboard/packages/contracts/package.json +1 -1
  150. package/templates/.agents/dashboard/packages/data-export/package.json +1 -1
  151. package/templates/.agents/dashboard/packages/local-runtime/dist/server.cjs +1458 -1458
  152. package/templates/.agents/dashboard/packages/local-runtime/dist/sqlite-read-model.cjs +1425 -1425
  153. package/templates/.agents/dashboard/packages/local-runtime/package.json +2 -1
  154. package/templates/.agents/dashboard/packages/local-runtime/scripts/build-sqlite-runtime.mjs +7 -3
  155. package/templates/.agents/dashboard/packages/local-runtime/server.mjs +1458 -1459
  156. package/templates/.agents/dashboard/packages/local-runtime/src/active-codex-telemetry.ts +25 -0
  157. package/templates/.agents/dashboard/packages/local-runtime/src/agent-catalog-settings.test.ts +1 -1
  158. package/templates/.agents/dashboard/packages/local-runtime/src/project-settings.test.ts +53 -8
  159. package/templates/.agents/dashboard/packages/local-runtime/src/project-settings.ts +79 -24
  160. package/templates/.agents/dashboard/packages/local-runtime/src/projection-refresh-diagnostics.ts +35 -0
  161. package/templates/.agents/dashboard/packages/local-runtime/src/server-costs-routes.ts +168 -0
  162. package/templates/.agents/dashboard/packages/local-runtime/src/server-dual-reads-manifest-summaries-without-losing.test.ts +344 -0
  163. package/templates/.agents/dashboard/packages/local-runtime/src/server-http-contracts.ts +31 -0
  164. package/templates/.agents/dashboard/packages/local-runtime/src/server-operations-routes.ts +345 -0
  165. package/templates/.agents/dashboard/packages/local-runtime/src/server-read-projections.ts +461 -0
  166. package/templates/.agents/dashboard/packages/local-runtime/src/server-reconciliation-refresh.test.ts +78 -0
  167. package/templates/.agents/dashboard/packages/local-runtime/src/server-route-context.ts +13 -0
  168. package/templates/.agents/dashboard/packages/local-runtime/src/server-snapshot-synchronization.test.ts +18 -0
  169. package/templates/.agents/dashboard/packages/local-runtime/src/server-snapshot-synchronization.ts +19 -3
  170. package/templates/.agents/dashboard/packages/local-runtime/src/server-snapshot.test.ts +22 -21
  171. package/templates/.agents/dashboard/packages/local-runtime/src/server-sqlite-task-trace.ts +1 -1
  172. package/templates/.agents/dashboard/packages/local-runtime/src/server-sqlite-view-allowlist.test.ts +25 -0
  173. package/templates/.agents/dashboard/packages/local-runtime/src/server-trace-routes.ts +64 -0
  174. package/templates/.agents/dashboard/packages/local-runtime/src/server-work-reconciliation.test.ts +2 -30
  175. package/templates/.agents/dashboard/packages/local-runtime/src/server-work-reconciliation.ts +6 -23
  176. package/templates/.agents/dashboard/packages/local-runtime/src/server.test-fixtures.ts +1 -1
  177. package/templates/.agents/dashboard/packages/local-runtime/src/server.test.ts +2 -330
  178. package/templates/.agents/dashboard/packages/local-runtime/src/server.ts +73 -1060
  179. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-materialize-first-fold.ts +78 -0
  180. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-materialize-projections.ts +561 -0
  181. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-materialize-runs.ts +600 -0
  182. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-metric-contract.test.ts +1 -1
  183. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-agent-dimension.ts +269 -0
  184. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-context.ts +32 -0
  185. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-entity-group.ts +244 -0
  186. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-filtered-dimension.ts +292 -0
  187. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-financial.ts +547 -0
  188. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-model-dimension.ts +360 -0
  189. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-provider-dimension.ts +169 -0
  190. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-summary.ts +475 -0
  191. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-temporal-dimension.ts +132 -0
  192. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-timing.ts +299 -0
  193. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-view-page.ts +692 -0
  194. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-counts-every-root-execution-day-returns.test.ts +739 -0
  195. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-does-not-convert-delayed-historical-finalizer.test.ts +706 -0
  196. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-filesystem.ts +748 -0
  197. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-first-fold-types.ts +1 -1
  198. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-keeps-orphan-telemetry-out-kanban-without.test.ts +710 -0
  199. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-marks-token-cost-telemetry-unavailable-when.test.ts +618 -0
  200. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-rebuild.ts +755 -0
  201. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-rebuilds-disposable-snapshot-serves-zaip-records.test.ts +276 -0
  202. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-schema.ts +193 -0
  203. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-types.ts +123 -0
  204. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model.test.ts +1 -2805
  205. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model.ts +17 -6930
  206. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-schema-base-views.ts +385 -0
  207. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-schema-dashboard-views.ts +412 -0
  208. package/templates/.agents/dashboard/packages/local-runtime/src/work-priority-contract.test.ts +4 -3
  209. package/templates/.agents/dashboard/packages/local-runtime/start-dashboard-build.mjs +195 -0
  210. package/templates/.agents/dashboard/packages/local-runtime/start-dashboard-lifecycle.test.mjs +2 -7
  211. package/templates/.agents/dashboard/packages/local-runtime/start-dashboard-logging.mjs +35 -0
  212. package/templates/.agents/dashboard/packages/local-runtime/start-dashboard-navigation.mjs +114 -0
  213. package/templates/.agents/dashboard/packages/local-runtime/start-dashboard-paths.mjs +90 -0
  214. package/templates/.agents/dashboard/packages/local-runtime/start-dashboard.mjs +89 -418
  215. package/templates/.agents/dashboard/packages/local-runtime/start-dashboard.test.mjs +22 -12
  216. package/templates/.agents/dashboard/packages/ui/package.json +1 -1
  217. package/templates/.agents/dashboard/tests/e2e/package.json +1 -1
  218. package/templates/.agents/dashboard/tests/e2e/playwright.config.ts +4 -1
  219. package/templates/.agents/design/.zaip-managed.json +5 -5
  220. package/templates/.agents/design/DESIGN.md +2 -186
  221. package/templates/.agents/design/README.md +12 -2
  222. package/templates/.agents/design/apps/catalog/package.json +1 -1
  223. package/templates/.agents/design/packages/local-runtime/package.json +1 -1
  224. package/templates/.agents/growth/strategy.md +3 -0
  225. package/templates/.agents/marketing/strategy.md +3 -0
  226. package/templates/.agents/requirements/autonomous-assurance.md +2 -1
  227. package/templates/.agents/requirements/cloud-hostinger-autonomy.md +1 -1
  228. package/templates/.agents/requirements/comparative-audit.md +1 -1
  229. package/templates/.agents/requirements/context-engine.md +1 -1
  230. package/templates/.agents/requirements/cost-observability.md +1 -1
  231. package/templates/.agents/requirements/dashboard-launch.md +1 -1
  232. package/templates/.agents/requirements/data-export.md +1 -1
  233. package/templates/.agents/requirements/design-system.md +13 -4
  234. package/templates/.agents/requirements/execution-engine.md +1 -1
  235. package/templates/.agents/requirements/kanban-dashboard.md +1 -1
  236. package/templates/.agents/requirements/model-orchestration.md +15 -5
  237. package/templates/.agents/requirements/public-distribution.md +5 -3
  238. package/templates/.agents/requirements/software-architecture.md +1 -1
  239. package/templates/.agents/requirements/strategic-improvements.md +1 -1
  240. package/templates/.agents/requirements/work-lifecycle.md +3 -3
  241. package/templates/.agents/requirements/zaip-strategic-95.md +1 -1
  242. package/templates/.agents/rules/architecture.md +2 -0
  243. package/templates/.agents/rules/astra-diagnostic.md +20 -0
  244. package/templates/.agents/rules/autonomy-decision.md +3 -1
  245. package/templates/.agents/rules/cloud-hostinger-autonomy.md +2 -0
  246. package/templates/.agents/rules/context.md +2 -1
  247. package/templates/.agents/rules/core.md +9 -14
  248. package/templates/.agents/rules/design-system-central-contract.md +17 -0
  249. package/templates/.agents/rules/evolution.md +3 -1
  250. package/templates/.agents/rules/frontend-lite.md +3 -1
  251. package/templates/.agents/rules/local-sqlite-storage.md +2 -2
  252. package/templates/.agents/rules/meta-mcp.md +4 -1
  253. package/templates/.agents/rules/model-orchestration.md +1 -1
  254. package/templates/.agents/rules/run-lifecycle-closure.md +7 -5
  255. package/templates/.agents/rules/security.md +3 -1
  256. package/templates/.agents/rules/specialist-routing.md +6 -2
  257. package/templates/.agents/rules/text-writing-utf8.md +1 -1
  258. package/templates/.agents/rules/workflow.md +7 -5
  259. package/templates/.agents/runtime/VERSION +1 -1
  260. package/templates/.agents/runtime/bin/zaip.mjs +534 -266
  261. package/templates/.agents/runtime/checksums.sha256 +6 -6
  262. package/templates/.agents/runtime/manifest.json +1 -1
  263. package/templates/.agents/runtime/pnpm-lock.sha256 +1 -1
  264. package/templates/.agents/runtime/provenance.json +5 -5
  265. package/templates/.agents/runtime/sbom.cdx.json +1 -1
  266. package/templates/.agents/sales/playbook.md +3 -0
  267. package/templates/.agents/skills/zaip-aios/SKILL.md +5 -3
  268. package/templates/.agents/skills/zaip-skill-adapt-stack/SKILL.md +1 -0
  269. package/templates/.agents/skills/zaip-skill-api-contracts/SKILL.md +14 -0
  270. package/templates/.agents/skills/zaip-skill-api-contracts/agents/openai.yaml +4 -0
  271. package/templates/.agents/skills/zaip-skill-application-observability/SKILL.md +15 -0
  272. package/templates/.agents/skills/zaip-skill-application-observability/agents/openai.yaml +4 -0
  273. package/templates/.agents/skills/zaip-skill-application-observability/references/signal-design.md +3 -0
  274. package/templates/.agents/skills/zaip-skill-application-readiness/SKILL.md +15 -0
  275. package/templates/.agents/skills/zaip-skill-application-readiness/agents/openai.yaml +4 -0
  276. package/templates/.agents/skills/zaip-skill-application-readiness/references/evidence-matrix.md +3 -0
  277. package/templates/.agents/skills/zaip-skill-architecture-design/SKILL.md +14 -0
  278. package/templates/.agents/skills/zaip-skill-architecture-design/agents/openai.yaml +4 -0
  279. package/templates/.agents/skills/zaip-skill-async-jobs/SKILL.md +14 -0
  280. package/templates/.agents/skills/zaip-skill-async-jobs/agents/openai.yaml +4 -0
  281. package/templates/.agents/skills/zaip-skill-auth-tenancy/SKILL.md +15 -0
  282. package/templates/.agents/skills/zaip-skill-auth-tenancy/agents/openai.yaml +4 -0
  283. package/templates/.agents/skills/zaip-skill-auth-tenancy/references/data-access-paths.md +9 -0
  284. package/templates/.agents/skills/zaip-skill-auth-tenancy/references/worker-scenario.md +5 -0
  285. package/templates/.agents/skills/zaip-skill-auth-tenancy/scripts/worker-contract.test.mjs +27 -0
  286. package/templates/.agents/skills/zaip-skill-author-skills/SKILL.md +2 -0
  287. package/templates/.agents/skills/zaip-skill-author-skills/references/engineering-skill-index.md +9 -0
  288. package/templates/.agents/skills/zaip-skill-author-skills/scripts/audit-skill-catalog.mjs +5 -3
  289. package/templates/.agents/skills/zaip-skill-author-skills/scripts/author-skill-scripts.test.mjs +27 -0
  290. package/templates/.agents/skills/zaip-skill-backend/SKILL.md +4 -0
  291. package/templates/.agents/skills/zaip-skill-backend/references/deployment-environments.md +75 -0
  292. package/templates/.agents/skills/zaip-skill-backend/references/supabase-migration-contract.md +23 -0
  293. package/templates/.agents/skills/zaip-skill-brand-governance/SKILL.md +2 -0
  294. package/templates/.agents/skills/zaip-skill-cache-strategy/SKILL.md +14 -0
  295. package/templates/.agents/skills/zaip-skill-cache-strategy/agents/openai.yaml +4 -0
  296. package/templates/.agents/skills/zaip-skill-change/SKILL.md +1 -1
  297. package/templates/.agents/skills/zaip-skill-cloud-engineering/SKILL.md +7 -0
  298. package/templates/.agents/skills/zaip-skill-cloudflare-github-deploy/SKILL.md +37 -0
  299. package/templates/.agents/skills/zaip-skill-cloudflare-github-deploy/agents/openai.yaml +6 -0
  300. package/templates/.agents/skills/zaip-skill-cloudflare-github-deploy/references/workers-static-assets.md +26 -0
  301. package/templates/.agents/skills/zaip-skill-cloudflare-github-deploy/references/workflow-templates.md +71 -0
  302. package/templates/.agents/skills/zaip-skill-cloudflare-github-deploy/scripts/cloudflare-github-deploy-contract.test.mjs +77 -0
  303. package/templates/.agents/skills/zaip-skill-config/SKILL.md +21 -11
  304. package/templates/.agents/skills/zaip-skill-config/agents/openai.yaml +2 -2
  305. package/templates/.agents/skills/zaip-skill-container-runtime/SKILL.md +14 -0
  306. package/templates/.agents/skills/zaip-skill-container-runtime/agents/openai.yaml +4 -0
  307. package/templates/.agents/skills/zaip-skill-context/SKILL.md +6 -1
  308. package/templates/.agents/skills/zaip-skill-context/references/prd-spec-task-handoff.md +10 -0
  309. package/templates/.agents/skills/zaip-skill-context/references/rule-selection.md +20 -0
  310. package/templates/.agents/skills/zaip-skill-cqrs/SKILL.md +1 -0
  311. package/templates/.agents/skills/zaip-skill-cybersecurity/SKILL.md +18 -0
  312. package/templates/.agents/skills/zaip-skill-cybersecurity/agents/openai.yaml +4 -0
  313. package/templates/.agents/skills/zaip-skill-cybersecurity/references/audit-contract.md +94 -0
  314. package/templates/.agents/skills/zaip-skill-cybersecurity/scripts/score-audit.mjs +185 -0
  315. package/templates/.agents/skills/zaip-skill-cybersecurity/scripts/score-audit.test.mjs +101 -0
  316. package/templates/.agents/skills/zaip-skill-data-modeling/SKILL.md +14 -0
  317. package/templates/.agents/skills/zaip-skill-data-modeling/agents/openai.yaml +4 -0
  318. package/templates/.agents/skills/zaip-skill-database-migrations/SKILL.md +20 -0
  319. package/templates/.agents/skills/zaip-skill-database-migrations/agents/openai.yaml +4 -0
  320. package/templates/.agents/skills/zaip-skill-database-migrations/references/manual-mode.md +15 -0
  321. package/templates/.agents/skills/zaip-skill-database-migrations/references/promotion-example.md +5 -0
  322. package/templates/.agents/skills/zaip-skill-database-migrations/scripts/export-manual-sql.mjs +145 -0
  323. package/templates/.agents/skills/zaip-skill-database-migrations/scripts/export-manual-sql.test.mjs +178 -0
  324. package/templates/.agents/skills/zaip-skill-dependency-upgrade/SKILL.md +14 -0
  325. package/templates/.agents/skills/zaip-skill-dependency-upgrade/agents/openai.yaml +4 -0
  326. package/templates/.agents/skills/zaip-skill-deployment-pipeline/SKILL.md +15 -0
  327. package/templates/.agents/skills/zaip-skill-deployment-pipeline/agents/openai.yaml +4 -0
  328. package/templates/.agents/skills/zaip-skill-deployment-pipeline/references/runtime-shapes.md +3 -0
  329. package/templates/.agents/skills/zaip-skill-design-system/SKILL.md +20 -9
  330. package/templates/.agents/skills/zaip-skill-dev-environment/SKILL.md +14 -0
  331. package/templates/.agents/skills/zaip-skill-dev-environment/agents/openai.yaml +4 -0
  332. package/templates/.agents/skills/zaip-skill-dev-environment/references/inventory-contract.md +7 -0
  333. package/templates/.agents/skills/zaip-skill-dev-environment/scripts/inventory.mjs +77 -0
  334. package/templates/.agents/skills/zaip-skill-disaster-recovery/SKILL.md +15 -0
  335. package/templates/.agents/skills/zaip-skill-disaster-recovery/agents/openai.yaml +4 -0
  336. package/templates/.agents/skills/zaip-skill-disaster-recovery/references/recovery-scope.md +3 -0
  337. package/templates/.agents/skills/zaip-skill-execution/SKILL.md +5 -3
  338. package/templates/.agents/skills/zaip-skill-execution/references/correction-cycle.md +7 -0
  339. package/templates/.agents/skills/zaip-skill-execution/references/runtime-governance.md +13 -0
  340. package/templates/.agents/skills/zaip-skill-external-integrations/SKILL.md +14 -0
  341. package/templates/.agents/skills/zaip-skill-external-integrations/agents/openai.yaml +4 -0
  342. package/templates/.agents/skills/zaip-skill-frontend/SKILL.md +4 -0
  343. package/templates/.agents/skills/zaip-skill-frontend-componentization/SKILL.md +44 -0
  344. package/templates/.agents/skills/zaip-skill-frontend-componentization/agents/openai.yaml +4 -0
  345. package/templates/.agents/skills/zaip-skill-frontend-data-flows/SKILL.md +14 -0
  346. package/templates/.agents/skills/zaip-skill-frontend-data-flows/agents/openai.yaml +4 -0
  347. package/templates/.agents/skills/zaip-skill-general-operations/SKILL.md +8 -7
  348. package/templates/.agents/skills/zaip-skill-general-operations/references/extended-workflow.md +7 -0
  349. package/templates/.agents/skills/zaip-skill-github-actions-setup/SKILL.md +36 -0
  350. package/templates/.agents/skills/zaip-skill-github-actions-setup/agents/openai.yaml +4 -0
  351. package/templates/.agents/skills/zaip-skill-github-actions-setup/references/cloudflare-pages.md +33 -0
  352. package/templates/.agents/skills/zaip-skill-github-actions-setup/references/github.md +63 -0
  353. package/templates/.agents/skills/zaip-skill-github-actions-setup/references/hostinger-vps.md +55 -0
  354. package/templates/.agents/skills/zaip-skill-github-actions-setup/references/npm.md +30 -0
  355. package/templates/.agents/skills/zaip-skill-github-actions-setup/scripts/check-skill.mjs +55 -0
  356. package/templates/.agents/skills/zaip-skill-github-actions-setup/scripts/verify-cloudflare.mjs +61 -0
  357. package/templates/.agents/skills/zaip-skill-github-actions-setup/scripts/verify-cloudflare.test.mjs +128 -0
  358. package/templates/.agents/skills/zaip-skill-github-actions-setup/scripts/verify-ssh.integration.test.mjs +106 -0
  359. package/templates/.agents/skills/zaip-skill-github-deploy/SKILL.md +43 -76
  360. package/templates/.agents/skills/zaip-skill-github-deploy/references/deployment-workflow.md +131 -0
  361. package/templates/.agents/skills/zaip-skill-github-deploy/references/github-release-workflow-template.md +31 -0
  362. package/templates/.agents/skills/zaip-skill-github-deploy/references/release-gate-matrix.md +24 -0
  363. package/templates/.agents/skills/zaip-skill-github-deploy/references/release-identity.md +44 -0
  364. package/templates/.agents/skills/zaip-skill-github-deploy/references/release-notes.md +134 -0
  365. package/templates/.agents/skills/zaip-skill-github-deploy/scripts/consumer-release-preparation.mjs +389 -0
  366. package/templates/.agents/skills/zaip-skill-github-deploy/scripts/consumer-release-preparation.test.mjs +134 -0
  367. package/templates/.agents/skills/zaip-skill-github-deploy/scripts/github-deploy-contract.test.mjs +25 -2
  368. package/templates/.agents/skills/zaip-skill-github-deploy/scripts/github-readiness-api.test.mjs +134 -0
  369. package/templates/.agents/skills/zaip-skill-github-deploy/scripts/github-readiness.mjs +98 -0
  370. package/templates/.agents/skills/zaip-skill-github-deploy/scripts/github-readiness.test.mjs +25 -0
  371. package/templates/.agents/skills/zaip-skill-github-deploy/scripts/install-github-readiness-workflow.mjs +159 -0
  372. package/templates/.agents/skills/zaip-skill-github-deploy/scripts/install-github-readiness-workflow.test.mjs +160 -0
  373. package/templates/.agents/skills/zaip-skill-github-deploy/scripts/preflight.mjs +149 -12
  374. package/templates/.agents/skills/zaip-skill-github-deploy/scripts/preflight.test.mjs +64 -5
  375. package/templates/.agents/skills/zaip-skill-github-deploy/scripts/release-notes-coverage.test.mjs +126 -0
  376. package/templates/.agents/skills/zaip-skill-github-deploy/scripts/resolve-release-identity.mjs +78 -0
  377. package/templates/.agents/skills/zaip-skill-github-deploy/scripts/resolve-release-identity.test.mjs +51 -0
  378. package/templates/.agents/skills/zaip-skill-github-deploy/scripts/validate-release-notes.mjs +184 -0
  379. package/templates/.agents/skills/zaip-skill-github-deploy/scripts/validate-release-notes.test.mjs +109 -0
  380. package/templates/.agents/skills/zaip-skill-github-setup/SKILL.md +5 -0
  381. package/templates/.agents/skills/zaip-skill-github-setup-ssh-folder/SKILL.md +54 -0
  382. package/templates/.agents/skills/zaip-skill-github-setup-ssh-folder/agents/openai.yaml +4 -0
  383. package/templates/.agents/skills/zaip-skill-github-setup-ssh-folder/assets/.env.example +9 -0
  384. package/templates/.agents/skills/zaip-skill-github-setup-ssh-folder/references/operational-procedure.md +137 -0
  385. package/templates/.agents/skills/zaip-skill-growth-strategy-revops/SKILL.md +8 -18
  386. package/templates/.agents/skills/zaip-skill-growth-strategy-revops/references/extended-workflow.md +21 -0
  387. package/templates/.agents/skills/zaip-skill-hostinger-cloudflare-terraform/SKILL.md +18 -10
  388. package/templates/.agents/skills/zaip-skill-hostinger-cloudflare-terraform/agents/openai.yaml +3 -4
  389. package/templates/.agents/skills/zaip-skill-hostinger-cloudflare-terraform/references/aws-cli-terraform.md +62 -0
  390. package/templates/.agents/skills/zaip-skill-hostinger-cloudflare-terraform/references/guia-iniciante-hostinger-vps.md +183 -0
  391. package/templates/.agents/skills/zaip-skill-marketing/SKILL.md +8 -13
  392. package/templates/.agents/skills/zaip-skill-marketing/references/extended-workflow.md +16 -0
  393. package/templates/.agents/skills/zaip-skill-meta-ads-setup/SKILL.md +2 -0
  394. package/templates/.agents/skills/zaip-skill-meta-token-onboarding/SKILL.md +17 -0
  395. package/templates/.agents/skills/zaip-skill-meta-token-onboarding/agents/openai.yaml +4 -0
  396. package/templates/.agents/skills/zaip-skill-meta-token-onboarding/references/onboarding-manual.md +96 -0
  397. package/templates/.agents/skills/zaip-skill-module-scaffold/SKILL.md +14 -0
  398. package/templates/.agents/skills/zaip-skill-module-scaffold/agents/openai.yaml +4 -0
  399. package/templates/.agents/skills/zaip-skill-module-scaffold/references/scaffold-contract.md +9 -0
  400. package/templates/.agents/skills/zaip-skill-module-scaffold/scripts/helpers.test.mjs +121 -0
  401. package/templates/.agents/skills/zaip-skill-module-scaffold/scripts/scaffold.mjs +169 -0
  402. package/templates/.agents/skills/zaip-skill-move-prd/SKILL.md +1 -1
  403. package/templates/.agents/skills/zaip-skill-move-spec/SKILL.md +1 -1
  404. package/templates/.agents/skills/zaip-skill-performance-engineering/SKILL.md +14 -0
  405. package/templates/.agents/skills/zaip-skill-performance-engineering/agents/openai.yaml +4 -0
  406. package/templates/.agents/skills/zaip-skill-prd/SKILL.md +1 -1
  407. package/templates/.agents/skills/zaip-skill-reconcile-telemetry/scripts/reconcile-local-telemetry.mjs +1 -0
  408. package/templates/.agents/skills/zaip-skill-reconcile-telemetry/scripts/reconcile-telemetry-lib.mjs +26 -9
  409. package/templates/.agents/skills/zaip-skill-reconcile-telemetry/scripts/reconcile-telemetry-lib.test.mjs +39 -13
  410. package/templates/.agents/skills/zaip-skill-reconcile-telemetry/scripts/reconcile-telemetry-remeasurement.mjs +1 -0
  411. package/templates/.agents/skills/zaip-skill-refactor-landing-page/SKILL.md +66 -0
  412. package/templates/.agents/skills/zaip-skill-refactor-landing-page/agents/openai.yaml +4 -0
  413. package/templates/.agents/skills/zaip-skill-refactor-landing-page/references/behavioral-dry-run.md +23 -0
  414. package/templates/.agents/skills/zaip-skill-release-qualification/SKILL.md +44 -1
  415. package/templates/.agents/skills/zaip-skill-release-qualification/references/local-preparation.md +98 -0
  416. package/templates/.agents/skills/zaip-skill-review/SKILL.md +1 -0
  417. package/templates/.agents/skills/zaip-skill-rules/SKILL.md +3 -3
  418. package/templates/.agents/skills/zaip-skill-sales-methodology/SKILL.md +9 -17
  419. package/templates/.agents/skills/zaip-skill-sales-methodology/references/extended-workflow.md +20 -0
  420. package/templates/.agents/skills/zaip-skill-setup/SKILL.md +22 -21
  421. package/templates/.agents/skills/zaip-skill-setup/agents/openai.yaml +2 -2
  422. package/templates/.agents/skills/zaip-skill-spec/SKILL.md +3 -2
  423. package/templates/.agents/skills/zaip-skill-storage-uploads/SKILL.md +14 -0
  424. package/templates/.agents/skills/zaip-skill-storage-uploads/agents/openai.yaml +4 -0
  425. package/templates/.agents/skills/zaip-skill-systematic-debugging/SKILL.md +14 -0
  426. package/templates/.agents/skills/zaip-skill-systematic-debugging/agents/openai.yaml +4 -0
  427. package/templates/.agents/skills/zaip-skill-task/SKILL.md +16 -7
  428. package/templates/.agents/skills/zaip-skill-task/references/commit-policy.md +25 -0
  429. package/templates/.agents/skills/zaip-skill-test-data/SKILL.md +14 -0
  430. package/templates/.agents/skills/zaip-skill-test-data/agents/openai.yaml +4 -0
  431. package/templates/.agents/skills/zaip-skill-test-data/scripts/generate.mjs +72 -0
  432. package/templates/.agents/skills/zaip-skill-testing-strategy/SKILL.md +15 -0
  433. package/templates/.agents/skills/zaip-skill-testing-strategy/agents/openai.yaml +4 -0
  434. package/templates/.agents/skills/zaip-skill-testing-strategy/references/example-map.md +3 -0
  435. package/templates/.agents/skills/zaip-skill-text-encoding/SKILL.md +1 -1
  436. package/templates/.agents/skills/zaip-skill-website-readiness/SKILL.md +8 -0
  437. package/templates/.agents/zaip-aios/INDEX.md +1 -1
  438. package/templates/.agents/zaip-aios/README.md +6 -0
  439. package/templates/.agents/zaip-aios/VERSION +1 -1
  440. package/templates/.agents/zaip-aios/guides/08-contexto-e-tokens.md +19 -3
  441. package/templates/.agents/zaip-aios/guides/10-seguranca.md +2 -1
  442. package/templates/.agents/zaip-aios/guides/12-instalacao-e-upgrade.md +37 -7
  443. package/templates/.agents/zaip-aios/guides/20-instalacao-detalhada.md +19 -4
  444. package/templates/.agents/zaip-aios/guides/23-orquestracao-de-modelos.md +32 -3
  445. package/templates/.agents/zaip-aios/guides/26-qualidade-e-release.md +21 -0
  446. package/templates/scripts/validate-cloud-hostinger-contract.mjs +34 -0
  447. package/templates/template-manifest.json +1031 -235
  448. package/templates/.agents/branding/.gitkeep +0 -0
  449. package/templates/.agents/dashboard/apps/frontend/dist/assets/CostCalculationGuidePage-snUCQYTC.js +0 -1
  450. package/templates/.agents/dashboard/apps/frontend/dist/assets/PricingSettingsDialog-BPtVUGgs.js +0 -1
  451. package/templates/.agents/dashboard/apps/frontend/dist/assets/ProjectSettingsPage-3Awyaovx.js +0 -3
  452. package/templates/.agents/dashboard/apps/frontend/dist/assets/ProjectSettingsPage-GgzpZ_PY.css +0 -1
  453. package/templates/.agents/dashboard/apps/frontend/dist/assets/TraceabilityWorkspace-DHDrd5rE.js +0 -1
  454. package/templates/.agents/dashboard/apps/frontend/dist/assets/cost-monitor-DbaLbU2q.js +0 -68
  455. package/templates/.agents/dashboard/apps/frontend/dist/assets/index-BYbpmqmM.js +0 -2
  456. package/templates/.agents/dashboard/apps/frontend/dist/assets/rolldown-runtime-D9-fqq9M.js +0 -1
  457. package/templates/.agents/dashboard/apps/frontend/dist/assets/traceability-BDe4_Ubl.js +0 -1
  458. package/templates/.agents/growth/.gitkeep +0 -0
  459. package/templates/.agents/marketing/.gitkeep +0 -0
  460. package/templates/.agents/sales/.gitkeep +0 -0
@@ -0,0 +1,15 @@
1
+ ---
2
+ name: zaip-skill-testing-strategy
3
+ description: Map acceptance risks to focused unit, integration, contract, and end-to-end tests with meaningful evidence.
4
+ ---
5
+
6
+ # Plan tests
7
+
8
+ Use when a change needs a proportionate verification plan or existing tests do not prove important behavior.
9
+ Read `references/example-map.md` for a Hono and Kysely multi-tenant mutation.
10
+
11
+ 1. Start with acceptance criteria, failure modes, external boundaries, and user-visible states rather than a target coverage number.
12
+ 2. Choose the lowest layer that can prove each behavior; use real integration boundaries when mocks cannot prove configuration or policy.
13
+ 3. Define deterministic fixtures, isolation, cleanup, and the observable assertion for each high-risk case.
14
+ 4. Include unauthorized, invalid, retry, and regression cases where the altered behavior makes them meaningful.
15
+ 5. Keep test execution evidence separate from a test plan and record baseline failures as baseline failures.
@@ -0,0 +1,4 @@
1
+ interface:
2
+ display_name: "Testing Strategy"
3
+ short_description: "Map risks to meaningful test evidence"
4
+ default_prompt: "Use $zaip-skill-testing-strategy to create a focused verification strategy for this change."
@@ -0,0 +1,3 @@
1
+ # Example map
2
+
3
+ A Hono multi-tenant mutation needs a unit test for use-case invariants, a route contract test for validation and response, a Kysely integration test for transaction and tenant context, and a UI assertion for loading, validation error, and success feedback. Add a cross-tenant denial test through the actual database access path.
@@ -19,7 +19,7 @@ description: Detect, prevent, and fix UTF-8, mojibake, and malformed text in ZAI
19
19
  - `.agents/requirements`
20
20
  - `.agents/skills`
21
21
  - `docs`
22
- - `plan-create-zaip-aios`
22
+ - `public-cli`
23
23
 
24
24
  ## Notes
25
25
 
@@ -5,6 +5,9 @@ description: Build capability-aware websites with discoverable agent-readable me
5
5
 
6
6
  # Website and Agent Readiness
7
7
 
8
+ Para componentes de UI novos ou alterados, carregue também
9
+ `$zaip-skill-frontend-componentization`.
10
+
8
11
  Use this skill for `apps/site/**`, landing pages, institutional websites, SEO, GEO,
9
12
  Markdown for Agents, or an Agent Readiness audit. Jonny owns implementation inside the
10
13
  site scope; Manu remains the owner of central design rules and must be called first when
@@ -21,6 +24,11 @@ the work changes `DESIGN.md`, design tokens, or canonical components.
21
24
  [references/capability-checklist.md](references/capability-checklist.md).
22
25
  6. Verify the rendered HTML, structured data, crawler files, Markdown representation,
23
26
  links, and response headers. Record unsupported capabilities explicitly.
27
+ 7. Publish only to the configured validation branch and the site's own validation
28
+ environment. Production promotion follows the [deployment and access
29
+ contract](../zaip-skill-backend/references/deployment-environments.md); a
30
+ Supabase query, when relevant, uses only a configured READ-ONLY-BETA or
31
+ READ-ONLY-PROD context.
24
32
 
25
33
  ## Required outcomes
26
34
 
@@ -29,7 +29,7 @@ introduzidos em releases mais novas.
29
29
  | Consultar instalação detalhada | [20 — Instalação detalhada](guides/20-instalacao-detalhada.md) |
30
30
  | Consultar telemetria do Monitor | [21 — Telemetria do Monitor de Custos](guides/21-telemetria-monitor-custos.md) |
31
31
  | Entender fluxos e roteamento | [22 — Fluxos e roteamento](guides/22-fluxos-e-roteamento.md) |
32
- | Consultar a política de modelos | [23 — Orquestração de modelos](guides/23-orquestracao-de-modelos.md) |
32
+ | Escolher modelos e limitar o diagnóstico Astra | [23 — Orquestração de modelos](guides/23-orquestracao-de-modelos.md) |
33
33
  | Entender cálculo e fontes de custo | [24 — Cálculo](guides/24-calculo-de-custos-openai.md) e [25 — Fontes](guides/25-fontes-de-precos-openai.md) |
34
34
  | Consultar qualidade e release | [26 — Qualidade e release](guides/26-qualidade-e-release.md) |
35
35
  | Entender a telemetria Git-native | [27 — Telemetria Git-native](guides/27-telemetria-git-native.md) |
@@ -39,11 +39,17 @@ presença de uma instrução ou screenshot não comprova execução naquele ambi
39
39
  - Use o guia 09 para delegacao entre os 23 agentes e 6 squads registrados.
40
40
  - Use o guia 16 para entender status, reconciliacao e a ordem de finalizacao.
41
41
  - Use os guias 17 e 24 a 25 para interpretar tokens, precificacao e conversao de moeda.
42
+ - Use o [guia 08](guides/08-contexto-e-tokens.md) para consultas com contexto enxuto e
43
+ o [guia 23](guides/23-orquestracao-de-modelos.md) para a divisão Luna/Terra/Sol e o
44
+ diagnóstico Astra em `high`, limitado a três invocações por tarefa.
42
45
  - Use os guias 18 a 28 quando precisar do contrato completo de agentes, lifecycle, telemetria, qualidade, instalacao ou roteamento.
43
46
 
44
47
  O instalador npm projeta esta pasta da `.agents` canonica para o tarball e a
45
48
  recria no projeto consumidor. Arquivos em `public-cli/packages/cli/templates`
46
49
  sao artefatos gerados do empacotamento, nao uma segunda fonte a ser editada.
50
+ Os manuais completos em português e inglês são instalados como
51
+ `.agents/README.md` e `.agents/README-ENG.md`; os READMEs da raiz do consumidor
52
+ permanecem sob sua autoria.
47
53
 
48
54
  Para concluir trabalho, use [revisão e validação](guides/07-revisao-e-validacao.md)
49
55
  e o [contrato de prova observável](../skills/zaip-skill-change/references/observable-evidence.md).
@@ -1 +1 @@
1
- 2.0
1
+ 2.6
@@ -2,9 +2,25 @@
2
2
 
3
3
  1. Comece por `project.yaml`, `core.md` e pelos manifests de `.agents/records/lifecycle/`.
4
4
  2. Carregue somente a Rule, Requirement ou skill acionada.
5
- 3. Prefira indices, resumos e busca direcionada a arquivos completos.
5
+ 3. Prefira índices, resumos e busca direcionada a arquivos completos.
6
6
  4. Abra records apenas por lifecycle ID conhecido.
7
- 5. Resuma fatos estaveis; preserve texto literal apenas quando normativo.
8
- 6. Remova do contexto resultados superados e detalhes nao acionaveis.
7
+ 5. Resuma fatos estáveis; preserve texto literal apenas quando normativo.
8
+ 6. Remova do contexto resultados superados e detalhes não acionáveis.
9
9
 
10
10
  Para tools, leia `catalog.yaml`, escolha um ID e abra somente seu manifesto.
11
+
12
+ ## Consulta simples e diagnóstico difícil
13
+
14
+ Uma pergunta simples de Marketing, Sales, Growth ou Ops recebe o contexto do domínio
15
+ necessário à resposta. Não cria Task/Change artificial nem carrega instruções de
16
+ engenharia ou diagnóstico Astra apenas por mencionar um departamento.
17
+
18
+ O [guia 23](23-orquestracao-de-modelos.md) define a escalada excepcional. A
19
+ [Rule Astra](../../rules/astra-diagnostic.md) só é carregada ao avaliar elegibilidade:
20
+ prova da falha, dificuldade estruturada e, no caso preventivo, impacto crítico comprovado.
21
+ A consulta diagnóstica usa contexto novo e delimitado, sem histórico integral ou ferramentas;
22
+ o executor recebe a rota corrigida e preserva os critérios de aceite originais.
23
+
24
+ Menos texto de prompt não comprova menor custo total. Compare tokens, tempo, reparos e
25
+ custo por tarefa aceita; mantenha separado o custo de uma pergunta simples. Consumo
26
+ ausente permanece indisponível. Veja [observabilidade e custos](11-observabilidade-e-custos.md).
@@ -237,7 +237,8 @@ ao novo token. Não edite ACLs manualmente e preserve o backup para rollback.
237
237
  | `.codex/zaip-aios-security.config.toml` | configuração dedicada do perfil restrito |
238
238
  | `.codex/zaip-aios-full-access.config.toml` | configuração dedicada do perfil completo |
239
239
  | `.agents/skills/zaip-skill-security/SKILL.md` | avaliação dos riscos e controles |
240
- | `.agents/skills/zaip-skill-setup/SKILL.md` | instalação, correção e validação dos perfis |
240
+ | `.agents/skills/zaip-skill-setup/SKILL.md` | instalação inicial dos modelos de perfil entregues pelo release |
241
+ | `.agents/skills/zaip-skill-config/SKILL.md` | seleção, personalização, correção e validação dos perfis |
241
242
  | `.codex/hooks/zaip-pre-tool-use.mjs` | guarda adicional de comandos |
242
243
  | `.codex/rules/` | decisões determinísticas de comandos permitidos e proibidos |
243
244
  | este guia | contrato operacional e comparação dos perfis |
@@ -1,10 +1,40 @@
1
- # Instalacao e upgrade
1
+ # Instalação e upgrade
2
2
 
3
- 1. Verifique versao atual e estado limpo ou conscientemente preservado.
4
- 2. Execute doctor/integrity antes da mudanca.
5
- 3. Faça dry-run da instalacao, migracao ou upgrade.
6
- 4. Revise arquivos gerenciados, publicos e preservados.
3
+ 1. Verifique versão atual e estado limpo ou conscientemente preservado.
4
+ 2. Execute doctor/integrity antes da mudança.
5
+ 3. Faça dry-run da instalação, migração ou upgrade.
6
+ 4. Revise arquivos gerenciados, públicos e preservados.
7
7
  5. Aplique, valide adapters e rode gates.
8
- 6. Teste rollback e confirme a versao final.
8
+ 6. Teste rollback e confirme a versão final.
9
9
 
10
- `framework.lock.yaml` e relevante neste fluxo; nao o carregue no trabalho comum.
10
+ `framework.lock.yaml` é relevante neste fluxo; não o carregue no trabalho comum.
11
+
12
+ ## Atualizar pelo pacote público
13
+
14
+ Na raiz do projeto consumidor:
15
+
16
+ ```bash
17
+ npx @zaip-ai/cli@latest init --dry-run
18
+ npx @zaip-ai/cli@latest init
19
+ npx @zaip-ai/cli@latest doctor --json
20
+ node .agents/runtime/bin/zaip.mjs doctor --json
21
+ ```
22
+
23
+ O primeiro doctor verifica a instalação; o segundo verifica o runtime distribuído.
24
+ Leia o plano antes de autorizar uma substituição com `--force --yes`. O upgrade
25
+ preserva o perfil de instalação salvo e as escolhas do projeto.
26
+
27
+ Os manuais instalados ficam em `.agents/README.md` (português) e
28
+ `.agents/README-ENG.md` (inglês), com navegação em [INDEX.md](../INDEX.md).
29
+ Os READMEs da raiz pertencem ao projeto consumidor e são preservados.
30
+ As versões geradas em `public-cli/packages/cli/templates` vêm das fontes canônicas.
31
+
32
+ Novas instalações mantêm seleção de modelo em `manual`. Instalar ou atualizar
33
+ não ativa Astra automaticamente. O opt-in `auto` aplica-se a SPEC/PRD e a allowlist
34
+ Astra habilita somente diagnóstico `high`, limitado e evidenciado, conforme o
35
+ [guia 23](23-orquestracao-de-modelos.md). Conversas e Tasks avulsas preservam a seleção do host.
36
+
37
+ `@latest` entrega o que está publicado no npm. Uma atualização local das fontes ou
38
+ um pacote validado localmente só chegará a esse comando após publicação.
39
+ Consulte [instalação detalhada](20-instalacao-detalhada.md) e
40
+ [qualificação do pacote](26-qualidade-e-release.md).
@@ -4,7 +4,7 @@ Este guia descreve o modelo de lifecycle V2 no layout V3. Durante a transição,
4
4
 
5
5
  ## Pré-requisitos
6
6
 
7
- - Node.js compatível com o pacote (declara 22+); para Dashboard, confirme `node:sqlite` disponível, como no ambiente de referência 22.16.0;
7
+ - Node.js 22.16.0 ou superior, conforme o requisito do pacote, com `node:sqlite` disponível;
8
8
  - Git;
9
9
  - permissões de escrita no repositório consumidor.
10
10
 
@@ -17,17 +17,32 @@ o runtime distribuído. No checkout mantenedor, use o pnpm fixado em
17
17
  Na raiz do projeto-alvo:
18
18
 
19
19
  ```bash
20
- npx @zaip-ai/cli@latest init --dry-run
21
- npx @zaip-ai/cli@latest init
20
+ npx --yes @zaip-ai/cli@latest init --project-only --dry-run
21
+ npx --yes @zaip-ai/cli@latest init --project-only
22
22
  node .agents/runtime/bin/zaip.mjs doctor --json
23
23
  ```
24
24
 
25
- Revise o dry-run antes da instalação. `@latest` seleciona a versão publicada,
25
+ Revise o dry-run antes da instalação. O primeiro sucesso verificável é a saída
26
+ de `doctor --json` com `"valid": true`; ela confirma layout, checksums e adapters
27
+ do projeto que recebeu a instalação. `@latest` seleciona a versão publicada,
26
28
  não alterações ainda locais neste repositório. O binário público `zaip` é o
27
29
  instalador; nos exemplos de lifecycle deste guia, `zaip ...` é uma abreviação
28
30
  de `node .agents/runtime/bin/zaip.mjs ...` no projeto consumidor. Use o caminho
29
31
  explícito para evitar colisão entre os dois CLIs.
30
32
 
33
+ ### Manuais e seleção de modelos
34
+
35
+ Antes de usar os comandos de desenvolvimento abaixo, consulte os manuais instalados
36
+ em `.agents/README.md` e `.agents/README-ENG.md` e o [índice local](../INDEX.md).
37
+ O instalador preserva os READMEs do projeto na raiz. Os perfis `full`, `dev-lite`
38
+ e `lite` selecionam ferramentas de instalação; eles não classificam a dificuldade
39
+ de uma tarefa nem ativam um modelo mais caro.
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).
45
+
31
46
  ## Construir o CLI
32
47
 
33
48
  Somente no repositório-fonte, para manutenção do framework:
@@ -11,7 +11,7 @@ Este guia define como o ZAIP-AIOS recomenda modelo, `reasoning effort` e velocid
11
11
 
12
12
  Na implementação atual, a política suporta `manual`, `off` e `auto`. No projeto ZAIP-AIOS, `auto` está ativado somente para Executions originadas por SPEC ou PRD; Conversation e Task-first preservam o modelo, o reasoning effort e a velocidade selecionados manualmente no Codex. `manual` continua disponível para rollback e permanece o default de novas instalações.
13
13
 
14
- Toda Execution originada por PRD ou SPEC solicita velocidade `standard`, sem exceção ou override para Fast. A única forma suportada de executar trabalho de produto mais rápido é iniciar uma Task-first realmente independente e selecionar Fast manualmente no Codex; o ZAIP não ativa, persiste nem herda essa velocidade.
14
+ Na política automática, Executions originadas por PRD ou SPEC solicitam velocidade `standard`, sem override para Fast. Em Conversation ou Task-first independente, a seleção de Fast pertence ao host/Codex; o ZAIP não a ativa, persiste nem herda. Velocidade do provider, paralelismo e tempo total até a tarefa aceita são medidas distintas.
15
15
 
16
16
  ## Estado atual
17
17
 
@@ -74,13 +74,14 @@ Para permitir escolha manual em Conversation e Task-first, não fixe `model`, `m
74
74
 
75
75
  ## Família de modelos
76
76
 
77
- A política automática deve permanecer inicialmente na família GPT-5.6:
77
+ A política preserva GPT-5.6 para execução e acrescenta Astra somente para diagnóstico difícil evidenciado:
78
78
 
79
79
  | Modelo | Uso preferencial |
80
80
  | --- | --- |
81
81
  | `gpt-5.6-luna` | trabalho claro, repetitivo, determinístico e de alto volume |
82
82
  | `gpt-5.6-terra` | implementação, teste, diagnóstico e integração cotidiana |
83
83
  | `gpt-5.6-sol` | trabalho ambíguo, transversal, arquitetural, crítico ou de alto valor |
84
+ | `gpt-6-astra` | diagnóstico excepcional, somente `high`, seguido de devolução ao executor |
84
85
 
85
86
  Os defaults iniciais ficam definidos assim:
86
87
 
@@ -91,6 +92,7 @@ Os defaults iniciais ficam definidos assim:
91
92
  | velocidade fallback/baseline | `standard` |
92
93
  | modelo eficiente elegível | `gpt-5.6-luna` |
93
94
  | modelo frontier elegível | `gpt-5.6-sol` |
95
+ | consultor diagnóstico excepcional | `gpt-6-astra high`; até três diagnósticos por Task |
94
96
  | teto automático de effort | `xhigh` |
95
97
  | `xhigh` automático | habilitado somente pelos critérios de elegibilidade |
96
98
  | `max` e `Ultra` automáticos | fora de escopo |
@@ -98,7 +100,34 @@ Os defaults iniciais ficam definidos assim:
98
100
 
99
101
  Terra `medium` é o fallback quando os sinais forem insuficientes ou conflitantes. Sol não deve ser usado em tudo; Luna não deve ser usado quando a Task depende de julgamento arquitetural ou ambiguidade relevante.
100
102
 
101
- `ultra` e `max` não fazem parte da política: o ZAIP-AIOS nunca os seleciona. A seleção usa somente Luna, Terra ou Sol com effort `low`, `medium`, `high` ou `xhigh`.
103
+ `ultra` e `max` não fazem parte da política: o ZAIP-AIOS nunca os seleciona. Luna, Terra e Sol usam effort `low`, `medium`, `high` ou `xhigh` conforme elegibilidade. Astra usa somente `high`; nem um override libera `xhigh`, `max` ou `ultra` para ele.
104
+
105
+ ### Astra: diagnóstico, correção de rota e devolução
106
+
107
+ Sol permanece como escolha normal da faixa difícil. Astra recebe uma questão diagnóstica delimitada quando o ganho potencial de evitar novo reparo justifica seu uso. A regra canônica é [RULE-ASTRA-DIAGNOSTIC](../../rules/astra-diagnostic.md), carregada apenas nessa avaliação; o kernel e os prompts de Marketing, Sales, Growth e Ops não incorporam essa expansão.
108
+
109
+ | Situação observada | Rota |
110
+ | --- | --- |
111
+ | Pergunta direta, copy, análise comercial simples, alteração mecânica | Luna/Terra conforme perfil existente |
112
+ | Arquitetura ou problema difícil com caminho conhecido | Sol; execução delimitada em Luna/Terra |
113
+ | Tentativa executora falhou por hipótese/raciocínio; complexidade ou ambiguidade alta e evidência disponível | Um diagnóstico Astra high antes do reparo seguinte |
114
+ | Impacto material crítico e diagnóstico difícil, ambos evidenciados | Astra high preventivamente, antes da primeira implementação |
115
+ | Falha de ambiente, credencial, ferramenta, sintaxe ou ausência de prova | Corrigir a condição ou obter prova com o executor; não acionar Astra |
116
+ | Mesmo diagnóstico/plano sem progresso, ou três diagnósticos já reservados | Parar a escalada; executar rota útil ou registrar bloqueio concreto |
117
+
118
+ A expressão “tarefa crítica”, o risco isolado, o departamento, a quantidade de arquivos e o tamanho do pedido nunca bastam. A política usa metadados estruturados e prova referenciada. Um reparo localizado não se torna diagnóstico difícil só porque a primeira tentativa falhou.
119
+
120
+ Cada ciclo significa **uma invocação diagnóstica Astra governada**, com reserva atômica antes do dispatch. O teto é três por ID estável de Task, somando retomadas, Runs e Executions; normalmente basta uma consulta. Uma reserva consumida não permite repetir o dispatch nem é devolvida após timeout. Call interna, evento de uso e checkpoint não são contadores de diagnóstico.
121
+
122
+ O pacote de entrada contém falha observada, tentativa anterior, evidência, restrições e critérios de aceite. É uma sessão nova, sem herdar histórico integral, sem ferramentas de execução nem filhos. O envelope limita a entrada serializada a 48000 bytes, declara até 8000 tokens de saída e termina após até 180 segundos. Bytes não equivalem a tokens; o runtime verifica o consumo informado pelo provider, sem transformar orçamento declarado em economia medida.
123
+
124
+ Astra retorna JSON com `findings`, `evidence`, `cause_or_hypothesis`, `route`, `scope`, `test_plan`, `executor` e `recommended_model` restrito a Luna/Terra/Sol. O coordenador valida o retorno e entrega a correção ao executor. Astra não implementa, não substitui a revisão normal e não finaliza a entrega.
125
+
126
+ O objetivo da segunda tentativa é aplicar uma hipótese corrigida e testável. Outra consulta precisa de evidência nova e mudança de hipótese/rota; não se permite repetir o mesmo plano alternando Astra e Sol. Se faltar prova para avançar, o retorno identifica a prova faltante, sem prometer resolução automática.
127
+
128
+ A política `model-orchestration-v2` mantém legível a configuração anterior com três modelos. Incluir Astra na allowlist habilita apenas essa rota condicionada; removê-lo desativa novos diagnósticos preservando histórico e quota. Novas instalações continuam em `manual`. O modo automático permanece restrito a SPEC/PRD. O framework controla processos que ele próprio despacha; não consegue alterar ou limitar uma sessão manual já selecionada no aplicativo Codex.
129
+
130
+ O isolamento é aplicado pelo adapter Codex antes da inferência: configuração transitória, sandbox de leitura, ferramentas de shell/apps/browser/multi-agent desabilitadas e cada servidor MCP efetivo desabilitado individualmente. Se a configuração não puder ser verificada, o diagnóstico não inicia. Um evento inesperado de ferramenta provoca cancelamento adicional; essa verificação posterior não substitui a restrição anterior.
102
131
 
103
132
  ## Reasoning effort
104
133
 
@@ -50,6 +50,27 @@ sincronize/audite novamente o template público. Execute gates geradores em
50
50
  checkout/worktree isolado para preservar trabalho concorrente. Gates locais,
51
51
  artefato exato, CI terminal e produção continuam sendo provas distintas.
52
52
 
53
+ ### Paridade de documentação no pacote npm
54
+
55
+ Atualize primeiro `README.md` e `README-ENG.md` do repositório-fonte, mantendo
56
+ português como principal e equivalência de seções, tabelas, exemplos e links.
57
+ Atualize também os guias afetados, seu índice e os READMEs do CLI público.
58
+ Sincronize o manifesto de integridade e o template por seus geradores oficiais.
59
+
60
+ O `pack:check` de `public-cli` instala o TGZ real em um consumidor temporário:
61
+ confere os hashes dos dois manuais, dos índices e de todos os arquivos do handbook
62
+ contra o manifest do próprio pacote, incluindo a Rule Astra, e verifica que
63
+ os READMEs da raiz do consumidor sobrevivem à instalação e à reinstalação.
64
+ O relatório registra a quantidade de arquivos documentais conferidos.
65
+
66
+ Novas instalações continuam em `manual`; a documentação não deve confundir
67
+ perfil de instalação com modelo/effort nem apresentar estimativas de tokens
68
+ como economia financeira medida. O escopo automático e os limites Astra
69
+ devem coincidir com o [guia 23](23-orquestracao-de-modelos.md).
70
+
71
+ Esses checks comprovam paridade local do candidato. Publicação npm, a tag
72
+ `latest`, CI remoto e economia em tarefas reais precisam de suas próprias evidências.
73
+
53
74
  ### Falhas de desempenho no dashboard
54
75
 
55
76
  Reproduza a rota, período, filtro, offset e tamanho da página que falharam.
@@ -10,6 +10,7 @@ const files = {
10
10
  terraform: "infra/terraform/main.tf",
11
11
  variables: "infra/terraform/variables.tf",
12
12
  skill: ".agents/skills/zaip-skill-hostinger-cloudflare-terraform/SKILL.md",
13
+ aws: ".agents/skills/zaip-skill-hostinger-cloudflare-terraform/references/aws-cli-terraform.md",
13
14
  readiness: "infra/terraform/deployment-inputs.example.yaml",
14
15
  };
15
16
  const source = Object.fromEntries(
@@ -75,6 +76,39 @@ const checks = [
75
76
  source.skill.includes("read-after-write") && source.skill.includes("prova estática/local"),
76
77
  "skill must require truthful live validation",
77
78
  ],
79
+ [
80
+ source.aws.includes("aws configure sso") &&
81
+ source.aws.includes("OIDC") &&
82
+ source.aws.includes("aws sts get-caller-identity"),
83
+ "AWS contract must support bounded authentication and identity verification",
84
+ ],
85
+ [
86
+ source.aws.includes("source_profile") &&
87
+ source.aws.includes("backend") &&
88
+ source.aws.includes("provider"),
89
+ "AWS contract must separate backend and provider authentication",
90
+ ],
91
+ [
92
+ source.aws.includes("use_lockfile = true") &&
93
+ source.aws.includes("Terraform >= 1.10") &&
94
+ source.aws.includes("lockfile=readonly") &&
95
+ source.aws.includes("apply"),
96
+ "AWS contract must require modern S3 locking and authorized saved-plan apply",
97
+ ],
98
+ [
99
+ source.aws.includes("Bootstrap AWS de ambiente zero") &&
100
+ source.aws.includes("não cria o bucket S3") &&
101
+ source.aws.includes("versionamento") &&
102
+ source.aws.includes("recuperação") &&
103
+ source.aws.includes("criptografia"),
104
+ "AWS contract must define separate zero-environment S3 bootstrap and recovery",
105
+ ],
106
+ [
107
+ source.skill.includes("**AWS:**") &&
108
+ source.skill.includes("Não leia, exija ou derive") &&
109
+ source.skill.includes("**Cloudflare/Hostinger:**"),
110
+ "skill must keep AWS inputs separate from the Cloudflare/Hostinger runner flow",
111
+ ],
78
112
  [
79
113
  source.readiness.includes("deployment_readiness: failed") &&
80
114
  source.readiness.includes("image_digests: {}"),