@zaip-ai/cli 2.2.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 (420) hide show
  1. package/dist/services/adapters.d.ts +1 -1
  2. package/dist/services/adapters.d.ts.map +1 -1
  3. package/dist/services/adapters.js +23 -9
  4. package/dist/services/adapters.js.map +1 -1
  5. package/dist/services/agent-adapters.js +25 -9
  6. package/dist/services/agent-adapters.js.map +1 -1
  7. package/dist/services/agent-discovery.d.ts +27 -0
  8. package/dist/services/agent-discovery.d.ts.map +1 -0
  9. package/dist/services/agent-discovery.js +73 -0
  10. package/dist/services/agent-discovery.js.map +1 -0
  11. package/dist/services/codex-conversation-lifecycle-hook.d.ts.map +1 -1
  12. package/dist/services/codex-conversation-lifecycle-hook.js +153 -24
  13. package/dist/services/codex-conversation-lifecycle-hook.js.map +1 -1
  14. package/dist/services/codex-pre-tool-hook-template.d.ts.map +1 -1
  15. package/dist/services/codex-pre-tool-hook-template.js +146 -72
  16. package/dist/services/codex-pre-tool-hook-template.js.map +1 -1
  17. package/dist/services/codex-rules.d.ts +1 -1
  18. package/dist/services/codex-rules.d.ts.map +1 -1
  19. package/dist/services/codex-rules.js +3 -3
  20. package/dist/services/codex-subagent-hook-template.d.ts +1 -1
  21. package/dist/services/codex-subagent-hook-template.d.ts.map +1 -1
  22. package/dist/services/codex-subagent-hook-template.js +117 -66
  23. package/dist/services/codex-subagent-hook-template.js.map +1 -1
  24. package/dist/services/install-agents-template.d.ts.map +1 -1
  25. package/dist/services/install-agents-template.js +56 -6
  26. package/dist/services/install-agents-template.js.map +1 -1
  27. package/dist/services/logger.js +1 -1
  28. package/dist/services/logger.js.map +1 -1
  29. package/dist/services/logger.test.js +22 -1
  30. package/dist/services/logger.test.js.map +1 -1
  31. package/dist/services/runtime-template.test.js +129 -0
  32. package/dist/services/runtime-template.test.js.map +1 -1
  33. package/package.json +1 -1
  34. package/templates/.agents/.env.example +9 -3
  35. package/templates/.agents/README-ENG.md +30 -5
  36. package/templates/.agents/README.md +30 -7
  37. package/templates/.agents/architecture/software-architecture.md +1 -59
  38. package/templates/.agents/branding/brandbook.md +3 -0
  39. package/templates/.agents/config/agents/catalog.yaml +22 -10
  40. package/templates/.agents/config/agents/discovery.json +319 -0
  41. package/templates/.agents/config/clients/codex/agents/zaip-agent-backend.toml +2 -2
  42. package/templates/.agents/config/clients/codex/agents/zaip-agent-builder.toml +2 -2
  43. package/templates/.agents/config/clients/codex/agents/zaip-agent-cloud-engineer.toml +11 -8
  44. package/templates/.agents/config/clients/codex/agents/zaip-agent-designer.toml +2 -2
  45. package/templates/.agents/config/clients/codex/agents/zaip-agent-frontend.toml +2 -2
  46. package/templates/.agents/config/clients/codex/agents/zaip-agent-task-executor.toml +2 -2
  47. package/templates/.agents/config/clients/codex/agents/zaip-agent-website-developer.toml +2 -2
  48. package/templates/.agents/config/pricing/models.json +9 -5
  49. package/templates/.agents/config/project.yaml +12 -1
  50. package/templates/.agents/dashboard/.zaip-managed.json +375 -95
  51. package/templates/.agents/dashboard/apps/frontend/dist/assets/CostCalculationGuidePage-CGxeQak4.js +1 -0
  52. package/templates/.agents/dashboard/apps/frontend/dist/assets/{DashboardHelpDialog-DaSllaJp.js → DashboardHelpDialog-tzS7YxYB.js} +57 -33
  53. package/templates/.agents/dashboard/apps/frontend/dist/assets/PricingSettingsDialog-DEbCi1gP.js +1 -0
  54. package/templates/.agents/dashboard/apps/frontend/dist/assets/ProjectSettingsPage-1L7Qw-Gq.js +3 -0
  55. package/templates/.agents/dashboard/apps/frontend/dist/assets/ProjectSettingsPage-EInWr641.css +1 -0
  56. package/templates/.agents/dashboard/apps/frontend/dist/assets/TraceabilityWorkspace-t1Om0Abw.js +1 -0
  57. package/templates/.agents/dashboard/apps/frontend/dist/assets/cost-monitor-B6aZfo5f.js +68 -0
  58. package/templates/.agents/dashboard/apps/frontend/dist/assets/{icons-vendor-TPUT2IUt.js → icons-vendor-DiGC-dsJ.js} +1 -1
  59. package/templates/.agents/dashboard/apps/frontend/dist/assets/index-DgTmNHN5.js +2 -0
  60. package/templates/.agents/dashboard/apps/frontend/dist/assets/{react-vendor-Ct48XHGL.js → react-vendor-kPO6yNed.js} +1 -1
  61. package/templates/.agents/dashboard/apps/frontend/dist/assets/rolldown-runtime-Bh1tDfsg.js +1 -0
  62. package/templates/.agents/dashboard/apps/frontend/dist/assets/traceability-DQpKX9c1.js +1 -0
  63. package/templates/.agents/dashboard/apps/frontend/dist/index.html +6 -6
  64. package/templates/.agents/dashboard/apps/frontend/package.json +1 -1
  65. package/templates/.agents/dashboard/apps/frontend/src/App.tsx +3 -1264
  66. package/templates/.agents/dashboard/apps/frontend/src/AppDashboardContent.tsx +363 -0
  67. package/templates/.agents/dashboard/apps/frontend/src/ProjectSettingsPage.dom.test.ts +99 -0
  68. package/templates/.agents/dashboard/apps/frontend/src/ProjectSettingsPage.tsx +62 -6
  69. package/templates/.agents/dashboard/apps/frontend/src/ProjectStackEditor.tsx +3 -1
  70. package/templates/.agents/dashboard/apps/frontend/src/__tests__/app-composition-support.ts +7 -0
  71. package/templates/.agents/dashboard/apps/frontend/src/cost-period-refresh.test.ts +9 -7
  72. package/templates/.agents/dashboard/apps/frontend/src/dashboard-api-settings.ts +151 -0
  73. package/templates/.agents/dashboard/apps/frontend/src/dashboard-api.ts +28 -153
  74. package/templates/.agents/dashboard/apps/frontend/src/dashboard-app-shell.tsx +33 -0
  75. package/templates/.agents/dashboard/apps/frontend/src/dashboard-cost-facts.ts +30 -0
  76. package/templates/.agents/dashboard/apps/frontend/src/dashboard-project-overview.ts +7 -1
  77. package/templates/.agents/dashboard/apps/frontend/src/dashboard-retry.ts +17 -0
  78. package/templates/.agents/dashboard/apps/frontend/src/dashboard-setup-route.ts +29 -0
  79. package/templates/.agents/dashboard/apps/frontend/src/dashboard-view-actions.ts +66 -0
  80. package/templates/.agents/dashboard/apps/frontend/src/operations-period-render.test.ts +3 -2
  81. package/templates/.agents/dashboard/apps/frontend/src/overview-status-page.test.ts +2 -2
  82. package/templates/.agents/dashboard/apps/frontend/src/project-installation-status.test.ts +48 -0
  83. package/templates/.agents/dashboard/apps/frontend/src/project-installation-status.ts +29 -0
  84. package/templates/.agents/dashboard/apps/frontend/src/project-settings-page.css +68 -0
  85. package/templates/.agents/dashboard/apps/frontend/src/project-settings.test.ts +2 -2
  86. package/templates/.agents/dashboard/apps/frontend/src/sao-paulo-day-rollover.test.ts +36 -0
  87. package/templates/.agents/dashboard/apps/frontend/src/sao-paulo-day-rollover.ts +30 -0
  88. package/templates/.agents/dashboard/apps/frontend/src/snapshot-banner-semantics.test.ts +2 -5
  89. package/templates/.agents/dashboard/apps/frontend/src/snapshot-coherence.test.ts +30 -19
  90. package/templates/.agents/dashboard/apps/frontend/src/use-app-effects.ts +9 -1
  91. package/templates/.agents/dashboard/apps/frontend/src/use-app-trace-task-pagination.ts +77 -0
  92. package/templates/.agents/dashboard/apps/frontend/src/use-app-work-board.ts +397 -0
  93. package/templates/.agents/dashboard/apps/frontend/src/use-dashboard-app-model.tsx +782 -0
  94. package/templates/.agents/dashboard/apps/frontend/src/use-snapshot-notice.tsx +49 -0
  95. package/templates/.agents/dashboard/modules/cost-monitor/package.json +1 -1
  96. package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostDeveloperPanelSlot.tsx +16 -0
  97. package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostGroupsTable.tsx +459 -0
  98. package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostMonitorPage.test.ts +27 -17
  99. package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostMonitorPage.tsx +62 -186
  100. package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostMonitorRunDialog.tsx +20 -0
  101. package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostTables-hides-calls-that-have-no-collected.test.ts +80 -0
  102. package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostTables-keeps-legacy-codex-identity-fields-blank.test.ts +455 -0
  103. package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostTables.test.ts +18 -525
  104. package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostTables.tsx +32 -508
  105. package/templates/.agents/dashboard/modules/cost-monitor/src/react/cost-monitor-export-sources.ts +74 -0
  106. package/templates/.agents/dashboard/modules/cost-monitor/src/react/cost-monitor-page-actions.ts +19 -0
  107. package/templates/.agents/dashboard/modules/cost-monitor/src/react/cost-monitor-page-selectors.ts +49 -0
  108. package/templates/.agents/dashboard/modules/cost-monitor/src/react/cost-table-formatters.ts +115 -0
  109. package/templates/.agents/dashboard/modules/cost-monitor/src/server/build-cost-monitor-projection.test-fixtures.ts +2 -0
  110. package/templates/.agents/dashboard/modules/operations/package.json +1 -1
  111. package/templates/.agents/dashboard/modules/operations/src/contracts.ts +4 -0
  112. package/templates/.agents/dashboard/modules/operations/src/react/EntityTableBadges.tsx +34 -0
  113. package/templates/.agents/dashboard/modules/operations/src/react/EntityTables.tsx +8 -38
  114. package/templates/.agents/dashboard/modules/operations/src/react/OperationsOverview-keeps-structure-classes-mutually-exclusive.test.ts +243 -0
  115. package/templates/.agents/dashboard/modules/operations/src/react/OperationsOverview.test.ts +27 -275
  116. package/templates/.agents/dashboard/modules/operations/src/react/OperationsOverview.tsx +70 -247
  117. package/templates/.agents/dashboard/modules/operations/src/react/OperationsOverviewCharts.tsx +171 -0
  118. package/templates/.agents/dashboard/modules/operations/src/react/OperationsOverviewPanels.tsx +64 -0
  119. package/templates/.agents/dashboard/modules/operations/src/react/OperationsPage.tsx +4 -3
  120. package/templates/.agents/dashboard/modules/operations/src/react/PrdDocumentDialog.test.tsx +2 -1
  121. package/templates/.agents/dashboard/modules/operations/src/react/manual-work-priority.test.ts +2 -1
  122. package/templates/.agents/dashboard/modules/operations/src/react/operations-coverage-toast.test.ts +6 -2
  123. package/templates/.agents/dashboard/modules/operations/src/react/operations-overview-period-filter.test.ts +6 -14
  124. package/templates/.agents/dashboard/modules/operations/src/react/operations-overview.status-cards.test.ts +3 -1
  125. package/templates/.agents/dashboard/modules/operations/src/react/operations-page-contract.ts +2 -0
  126. package/templates/.agents/dashboard/modules/operations/src/react/overview-metric-format.ts +32 -0
  127. package/templates/.agents/dashboard/modules/traceability/package.json +1 -1
  128. package/templates/.agents/dashboard/packages/branding/package.json +1 -1
  129. package/templates/.agents/dashboard/packages/branding/src/index.ts +1 -1
  130. package/templates/.agents/dashboard/packages/contracts/package.json +1 -1
  131. package/templates/.agents/dashboard/packages/data-export/package.json +1 -1
  132. package/templates/.agents/dashboard/packages/local-runtime/dist/server.cjs +1458 -1458
  133. package/templates/.agents/dashboard/packages/local-runtime/dist/sqlite-read-model.cjs +1425 -1425
  134. package/templates/.agents/dashboard/packages/local-runtime/package.json +2 -1
  135. package/templates/.agents/dashboard/packages/local-runtime/scripts/build-sqlite-runtime.mjs +7 -3
  136. package/templates/.agents/dashboard/packages/local-runtime/server.mjs +1458 -1459
  137. package/templates/.agents/dashboard/packages/local-runtime/src/active-codex-telemetry.ts +25 -0
  138. package/templates/.agents/dashboard/packages/local-runtime/src/agent-catalog-settings.test.ts +1 -1
  139. package/templates/.agents/dashboard/packages/local-runtime/src/project-settings.test.ts +53 -8
  140. package/templates/.agents/dashboard/packages/local-runtime/src/project-settings.ts +79 -24
  141. package/templates/.agents/dashboard/packages/local-runtime/src/projection-refresh-diagnostics.ts +35 -0
  142. package/templates/.agents/dashboard/packages/local-runtime/src/server-costs-routes.ts +168 -0
  143. package/templates/.agents/dashboard/packages/local-runtime/src/server-dual-reads-manifest-summaries-without-losing.test.ts +344 -0
  144. package/templates/.agents/dashboard/packages/local-runtime/src/server-http-contracts.ts +31 -0
  145. package/templates/.agents/dashboard/packages/local-runtime/src/server-operations-routes.ts +345 -0
  146. package/templates/.agents/dashboard/packages/local-runtime/src/server-read-projections.ts +461 -0
  147. package/templates/.agents/dashboard/packages/local-runtime/src/server-reconciliation-refresh.test.ts +78 -0
  148. package/templates/.agents/dashboard/packages/local-runtime/src/server-route-context.ts +13 -0
  149. package/templates/.agents/dashboard/packages/local-runtime/src/server-snapshot-synchronization.test.ts +18 -0
  150. package/templates/.agents/dashboard/packages/local-runtime/src/server-snapshot-synchronization.ts +19 -3
  151. package/templates/.agents/dashboard/packages/local-runtime/src/server-snapshot.test.ts +22 -21
  152. package/templates/.agents/dashboard/packages/local-runtime/src/server-sqlite-view-allowlist.test.ts +25 -0
  153. package/templates/.agents/dashboard/packages/local-runtime/src/server-trace-routes.ts +64 -0
  154. package/templates/.agents/dashboard/packages/local-runtime/src/server-work-reconciliation.test.ts +2 -30
  155. package/templates/.agents/dashboard/packages/local-runtime/src/server-work-reconciliation.ts +6 -23
  156. package/templates/.agents/dashboard/packages/local-runtime/src/server.test-fixtures.ts +1 -1
  157. package/templates/.agents/dashboard/packages/local-runtime/src/server.test.ts +2 -330
  158. package/templates/.agents/dashboard/packages/local-runtime/src/server.ts +73 -1060
  159. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-materialize-first-fold.ts +78 -0
  160. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-materialize-projections.ts +561 -0
  161. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-materialize-runs.ts +600 -0
  162. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-metric-contract.test.ts +1 -1
  163. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-agent-dimension.ts +269 -0
  164. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-context.ts +32 -0
  165. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-entity-group.ts +244 -0
  166. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-filtered-dimension.ts +292 -0
  167. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-financial.ts +547 -0
  168. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-model-dimension.ts +360 -0
  169. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-provider-dimension.ts +169 -0
  170. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-summary.ts +475 -0
  171. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-temporal-dimension.ts +132 -0
  172. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-timing.ts +299 -0
  173. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-view-page.ts +692 -0
  174. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-counts-every-root-execution-day-returns.test.ts +739 -0
  175. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-does-not-convert-delayed-historical-finalizer.test.ts +706 -0
  176. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-filesystem.ts +748 -0
  177. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-first-fold-types.ts +1 -1
  178. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-keeps-orphan-telemetry-out-kanban-without.test.ts +710 -0
  179. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-marks-token-cost-telemetry-unavailable-when.test.ts +618 -0
  180. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-rebuild.ts +755 -0
  181. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-rebuilds-disposable-snapshot-serves-zaip-records.test.ts +276 -0
  182. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-schema.ts +193 -0
  183. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-types.ts +123 -0
  184. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model.test.ts +1 -2805
  185. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model.ts +17 -6930
  186. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-schema-base-views.ts +385 -0
  187. package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-schema-dashboard-views.ts +412 -0
  188. package/templates/.agents/dashboard/packages/local-runtime/src/work-priority-contract.test.ts +4 -3
  189. package/templates/.agents/dashboard/packages/local-runtime/start-dashboard-build.mjs +195 -0
  190. package/templates/.agents/dashboard/packages/local-runtime/start-dashboard-lifecycle.test.mjs +2 -7
  191. package/templates/.agents/dashboard/packages/local-runtime/start-dashboard-logging.mjs +35 -0
  192. package/templates/.agents/dashboard/packages/local-runtime/start-dashboard-navigation.mjs +114 -0
  193. package/templates/.agents/dashboard/packages/local-runtime/start-dashboard-paths.mjs +90 -0
  194. package/templates/.agents/dashboard/packages/local-runtime/start-dashboard.mjs +89 -418
  195. package/templates/.agents/dashboard/packages/local-runtime/start-dashboard.test.mjs +22 -12
  196. package/templates/.agents/dashboard/packages/ui/package.json +1 -1
  197. package/templates/.agents/dashboard/tests/e2e/package.json +1 -1
  198. package/templates/.agents/dashboard/tests/e2e/playwright.config.ts +4 -1
  199. package/templates/.agents/design/.zaip-managed.json +5 -5
  200. package/templates/.agents/design/DESIGN.md +2 -186
  201. package/templates/.agents/design/README.md +12 -2
  202. package/templates/.agents/design/apps/catalog/package.json +1 -1
  203. package/templates/.agents/design/packages/local-runtime/package.json +1 -1
  204. package/templates/.agents/growth/strategy.md +3 -0
  205. package/templates/.agents/marketing/strategy.md +3 -0
  206. package/templates/.agents/requirements/autonomous-assurance.md +2 -1
  207. package/templates/.agents/requirements/cloud-hostinger-autonomy.md +1 -1
  208. package/templates/.agents/requirements/comparative-audit.md +1 -1
  209. package/templates/.agents/requirements/context-engine.md +1 -1
  210. package/templates/.agents/requirements/cost-observability.md +1 -1
  211. package/templates/.agents/requirements/dashboard-launch.md +1 -1
  212. package/templates/.agents/requirements/data-export.md +1 -1
  213. package/templates/.agents/requirements/design-system.md +13 -4
  214. package/templates/.agents/requirements/execution-engine.md +1 -1
  215. package/templates/.agents/requirements/kanban-dashboard.md +1 -1
  216. package/templates/.agents/requirements/model-orchestration.md +1 -1
  217. package/templates/.agents/requirements/public-distribution.md +4 -2
  218. package/templates/.agents/requirements/software-architecture.md +1 -1
  219. package/templates/.agents/requirements/strategic-improvements.md +1 -1
  220. package/templates/.agents/requirements/work-lifecycle.md +3 -3
  221. package/templates/.agents/requirements/zaip-strategic-95.md +1 -1
  222. package/templates/.agents/rules/architecture.md +2 -0
  223. package/templates/.agents/rules/astra-diagnostic.md +1 -1
  224. package/templates/.agents/rules/autonomy-decision.md +3 -1
  225. package/templates/.agents/rules/cloud-hostinger-autonomy.md +2 -0
  226. package/templates/.agents/rules/context.md +2 -1
  227. package/templates/.agents/rules/core.md +3 -3
  228. package/templates/.agents/rules/design-system-central-contract.md +17 -0
  229. package/templates/.agents/rules/evolution.md +3 -1
  230. package/templates/.agents/rules/frontend-lite.md +3 -1
  231. package/templates/.agents/rules/local-sqlite-storage.md +2 -2
  232. package/templates/.agents/rules/meta-mcp.md +3 -1
  233. package/templates/.agents/rules/model-orchestration.md +1 -1
  234. package/templates/.agents/rules/run-lifecycle-closure.md +6 -4
  235. package/templates/.agents/rules/security.md +3 -1
  236. package/templates/.agents/rules/specialist-routing.md +3 -1
  237. package/templates/.agents/rules/text-writing-utf8.md +1 -1
  238. package/templates/.agents/rules/workflow.md +7 -5
  239. package/templates/.agents/runtime/VERSION +1 -1
  240. package/templates/.agents/runtime/bin/zaip.mjs +519 -247
  241. package/templates/.agents/runtime/checksums.sha256 +6 -6
  242. package/templates/.agents/runtime/manifest.json +1 -1
  243. package/templates/.agents/runtime/pnpm-lock.sha256 +1 -1
  244. package/templates/.agents/runtime/provenance.json +5 -5
  245. package/templates/.agents/runtime/sbom.cdx.json +1 -1
  246. package/templates/.agents/sales/playbook.md +3 -0
  247. package/templates/.agents/skills/zaip-aios/SKILL.md +5 -3
  248. package/templates/.agents/skills/zaip-skill-adapt-stack/SKILL.md +1 -0
  249. package/templates/.agents/skills/zaip-skill-api-contracts/SKILL.md +14 -0
  250. package/templates/.agents/skills/zaip-skill-api-contracts/agents/openai.yaml +4 -0
  251. package/templates/.agents/skills/zaip-skill-application-observability/SKILL.md +15 -0
  252. package/templates/.agents/skills/zaip-skill-application-observability/agents/openai.yaml +4 -0
  253. package/templates/.agents/skills/zaip-skill-application-observability/references/signal-design.md +3 -0
  254. package/templates/.agents/skills/zaip-skill-application-readiness/SKILL.md +15 -0
  255. package/templates/.agents/skills/zaip-skill-application-readiness/agents/openai.yaml +4 -0
  256. package/templates/.agents/skills/zaip-skill-application-readiness/references/evidence-matrix.md +3 -0
  257. package/templates/.agents/skills/zaip-skill-architecture-design/SKILL.md +14 -0
  258. package/templates/.agents/skills/zaip-skill-architecture-design/agents/openai.yaml +4 -0
  259. package/templates/.agents/skills/zaip-skill-async-jobs/SKILL.md +14 -0
  260. package/templates/.agents/skills/zaip-skill-async-jobs/agents/openai.yaml +4 -0
  261. package/templates/.agents/skills/zaip-skill-auth-tenancy/SKILL.md +15 -0
  262. package/templates/.agents/skills/zaip-skill-auth-tenancy/agents/openai.yaml +4 -0
  263. package/templates/.agents/skills/zaip-skill-auth-tenancy/references/data-access-paths.md +9 -0
  264. package/templates/.agents/skills/zaip-skill-auth-tenancy/references/worker-scenario.md +5 -0
  265. package/templates/.agents/skills/zaip-skill-auth-tenancy/scripts/worker-contract.test.mjs +27 -0
  266. package/templates/.agents/skills/zaip-skill-author-skills/SKILL.md +2 -0
  267. package/templates/.agents/skills/zaip-skill-author-skills/references/engineering-skill-index.md +9 -0
  268. package/templates/.agents/skills/zaip-skill-author-skills/scripts/audit-skill-catalog.mjs +5 -3
  269. package/templates/.agents/skills/zaip-skill-author-skills/scripts/author-skill-scripts.test.mjs +27 -0
  270. package/templates/.agents/skills/zaip-skill-backend/SKILL.md +4 -0
  271. package/templates/.agents/skills/zaip-skill-backend/references/deployment-environments.md +75 -0
  272. package/templates/.agents/skills/zaip-skill-backend/references/supabase-migration-contract.md +23 -0
  273. package/templates/.agents/skills/zaip-skill-brand-governance/SKILL.md +2 -0
  274. package/templates/.agents/skills/zaip-skill-cache-strategy/SKILL.md +14 -0
  275. package/templates/.agents/skills/zaip-skill-cache-strategy/agents/openai.yaml +4 -0
  276. package/templates/.agents/skills/zaip-skill-change/SKILL.md +1 -1
  277. package/templates/.agents/skills/zaip-skill-cloud-engineering/SKILL.md +7 -0
  278. package/templates/.agents/skills/zaip-skill-cloudflare-github-deploy/SKILL.md +37 -0
  279. package/templates/.agents/skills/zaip-skill-cloudflare-github-deploy/agents/openai.yaml +6 -0
  280. package/templates/.agents/skills/zaip-skill-cloudflare-github-deploy/references/workers-static-assets.md +26 -0
  281. package/templates/.agents/skills/zaip-skill-cloudflare-github-deploy/references/workflow-templates.md +71 -0
  282. package/templates/.agents/skills/zaip-skill-cloudflare-github-deploy/scripts/cloudflare-github-deploy-contract.test.mjs +77 -0
  283. package/templates/.agents/skills/zaip-skill-config/SKILL.md +21 -11
  284. package/templates/.agents/skills/zaip-skill-config/agents/openai.yaml +2 -2
  285. package/templates/.agents/skills/zaip-skill-container-runtime/SKILL.md +14 -0
  286. package/templates/.agents/skills/zaip-skill-container-runtime/agents/openai.yaml +4 -0
  287. package/templates/.agents/skills/zaip-skill-context/SKILL.md +6 -1
  288. package/templates/.agents/skills/zaip-skill-context/references/prd-spec-task-handoff.md +10 -0
  289. package/templates/.agents/skills/zaip-skill-context/references/rule-selection.md +20 -0
  290. package/templates/.agents/skills/zaip-skill-cqrs/SKILL.md +1 -0
  291. package/templates/.agents/skills/zaip-skill-cybersecurity/SKILL.md +18 -0
  292. package/templates/.agents/skills/zaip-skill-cybersecurity/agents/openai.yaml +4 -0
  293. package/templates/.agents/skills/zaip-skill-cybersecurity/references/audit-contract.md +94 -0
  294. package/templates/.agents/skills/zaip-skill-cybersecurity/scripts/score-audit.mjs +185 -0
  295. package/templates/.agents/skills/zaip-skill-cybersecurity/scripts/score-audit.test.mjs +101 -0
  296. package/templates/.agents/skills/zaip-skill-data-modeling/SKILL.md +14 -0
  297. package/templates/.agents/skills/zaip-skill-data-modeling/agents/openai.yaml +4 -0
  298. package/templates/.agents/skills/zaip-skill-database-migrations/SKILL.md +20 -0
  299. package/templates/.agents/skills/zaip-skill-database-migrations/agents/openai.yaml +4 -0
  300. package/templates/.agents/skills/zaip-skill-database-migrations/references/manual-mode.md +15 -0
  301. package/templates/.agents/skills/zaip-skill-database-migrations/references/promotion-example.md +5 -0
  302. package/templates/.agents/skills/zaip-skill-database-migrations/scripts/export-manual-sql.mjs +145 -0
  303. package/templates/.agents/skills/zaip-skill-database-migrations/scripts/export-manual-sql.test.mjs +178 -0
  304. package/templates/.agents/skills/zaip-skill-dependency-upgrade/SKILL.md +14 -0
  305. package/templates/.agents/skills/zaip-skill-dependency-upgrade/agents/openai.yaml +4 -0
  306. package/templates/.agents/skills/zaip-skill-deployment-pipeline/SKILL.md +15 -0
  307. package/templates/.agents/skills/zaip-skill-deployment-pipeline/agents/openai.yaml +4 -0
  308. package/templates/.agents/skills/zaip-skill-deployment-pipeline/references/runtime-shapes.md +3 -0
  309. package/templates/.agents/skills/zaip-skill-design-system/SKILL.md +20 -9
  310. package/templates/.agents/skills/zaip-skill-dev-environment/SKILL.md +14 -0
  311. package/templates/.agents/skills/zaip-skill-dev-environment/agents/openai.yaml +4 -0
  312. package/templates/.agents/skills/zaip-skill-dev-environment/references/inventory-contract.md +7 -0
  313. package/templates/.agents/skills/zaip-skill-dev-environment/scripts/inventory.mjs +77 -0
  314. package/templates/.agents/skills/zaip-skill-disaster-recovery/SKILL.md +15 -0
  315. package/templates/.agents/skills/zaip-skill-disaster-recovery/agents/openai.yaml +4 -0
  316. package/templates/.agents/skills/zaip-skill-disaster-recovery/references/recovery-scope.md +3 -0
  317. package/templates/.agents/skills/zaip-skill-execution/SKILL.md +3 -3
  318. package/templates/.agents/skills/zaip-skill-execution/references/correction-cycle.md +7 -0
  319. package/templates/.agents/skills/zaip-skill-execution/references/runtime-governance.md +1 -5
  320. package/templates/.agents/skills/zaip-skill-external-integrations/SKILL.md +14 -0
  321. package/templates/.agents/skills/zaip-skill-external-integrations/agents/openai.yaml +4 -0
  322. package/templates/.agents/skills/zaip-skill-frontend/SKILL.md +4 -0
  323. package/templates/.agents/skills/zaip-skill-frontend-componentization/SKILL.md +44 -0
  324. package/templates/.agents/skills/zaip-skill-frontend-componentization/agents/openai.yaml +4 -0
  325. package/templates/.agents/skills/zaip-skill-frontend-data-flows/SKILL.md +14 -0
  326. package/templates/.agents/skills/zaip-skill-frontend-data-flows/agents/openai.yaml +4 -0
  327. package/templates/.agents/skills/zaip-skill-general-operations/SKILL.md +2 -0
  328. package/templates/.agents/skills/zaip-skill-github-actions-setup/SKILL.md +36 -0
  329. package/templates/.agents/skills/zaip-skill-github-actions-setup/agents/openai.yaml +4 -0
  330. package/templates/.agents/skills/zaip-skill-github-actions-setup/references/cloudflare-pages.md +33 -0
  331. package/templates/.agents/skills/zaip-skill-github-actions-setup/references/github.md +63 -0
  332. package/templates/.agents/skills/zaip-skill-github-actions-setup/references/hostinger-vps.md +55 -0
  333. package/templates/.agents/skills/zaip-skill-github-actions-setup/references/npm.md +30 -0
  334. package/templates/.agents/skills/zaip-skill-github-actions-setup/scripts/check-skill.mjs +55 -0
  335. package/templates/.agents/skills/zaip-skill-github-actions-setup/scripts/verify-cloudflare.mjs +61 -0
  336. package/templates/.agents/skills/zaip-skill-github-actions-setup/scripts/verify-cloudflare.test.mjs +128 -0
  337. package/templates/.agents/skills/zaip-skill-github-actions-setup/scripts/verify-ssh.integration.test.mjs +106 -0
  338. package/templates/.agents/skills/zaip-skill-github-deploy/SKILL.md +43 -76
  339. package/templates/.agents/skills/zaip-skill-github-deploy/references/deployment-workflow.md +131 -0
  340. package/templates/.agents/skills/zaip-skill-github-deploy/references/github-release-workflow-template.md +31 -0
  341. package/templates/.agents/skills/zaip-skill-github-deploy/references/release-gate-matrix.md +24 -0
  342. package/templates/.agents/skills/zaip-skill-github-deploy/references/release-identity.md +44 -0
  343. package/templates/.agents/skills/zaip-skill-github-deploy/references/release-notes.md +134 -0
  344. package/templates/.agents/skills/zaip-skill-github-deploy/scripts/consumer-release-preparation.mjs +389 -0
  345. package/templates/.agents/skills/zaip-skill-github-deploy/scripts/consumer-release-preparation.test.mjs +134 -0
  346. package/templates/.agents/skills/zaip-skill-github-deploy/scripts/github-deploy-contract.test.mjs +25 -2
  347. package/templates/.agents/skills/zaip-skill-github-deploy/scripts/github-readiness-api.test.mjs +134 -0
  348. package/templates/.agents/skills/zaip-skill-github-deploy/scripts/github-readiness.mjs +98 -0
  349. package/templates/.agents/skills/zaip-skill-github-deploy/scripts/github-readiness.test.mjs +25 -0
  350. package/templates/.agents/skills/zaip-skill-github-deploy/scripts/install-github-readiness-workflow.mjs +159 -0
  351. package/templates/.agents/skills/zaip-skill-github-deploy/scripts/install-github-readiness-workflow.test.mjs +160 -0
  352. package/templates/.agents/skills/zaip-skill-github-deploy/scripts/preflight.mjs +149 -12
  353. package/templates/.agents/skills/zaip-skill-github-deploy/scripts/preflight.test.mjs +64 -5
  354. package/templates/.agents/skills/zaip-skill-github-deploy/scripts/release-notes-coverage.test.mjs +126 -0
  355. package/templates/.agents/skills/zaip-skill-github-deploy/scripts/resolve-release-identity.mjs +78 -0
  356. package/templates/.agents/skills/zaip-skill-github-deploy/scripts/resolve-release-identity.test.mjs +51 -0
  357. package/templates/.agents/skills/zaip-skill-github-deploy/scripts/validate-release-notes.mjs +184 -0
  358. package/templates/.agents/skills/zaip-skill-github-deploy/scripts/validate-release-notes.test.mjs +109 -0
  359. package/templates/.agents/skills/zaip-skill-growth-strategy-revops/SKILL.md +2 -0
  360. package/templates/.agents/skills/zaip-skill-hostinger-cloudflare-terraform/SKILL.md +18 -10
  361. package/templates/.agents/skills/zaip-skill-hostinger-cloudflare-terraform/agents/openai.yaml +3 -4
  362. package/templates/.agents/skills/zaip-skill-hostinger-cloudflare-terraform/references/aws-cli-terraform.md +62 -0
  363. package/templates/.agents/skills/zaip-skill-hostinger-cloudflare-terraform/references/guia-iniciante-hostinger-vps.md +183 -0
  364. package/templates/.agents/skills/zaip-skill-marketing/SKILL.md +2 -0
  365. package/templates/.agents/skills/zaip-skill-module-scaffold/SKILL.md +14 -0
  366. package/templates/.agents/skills/zaip-skill-module-scaffold/agents/openai.yaml +4 -0
  367. package/templates/.agents/skills/zaip-skill-module-scaffold/references/scaffold-contract.md +9 -0
  368. package/templates/.agents/skills/zaip-skill-module-scaffold/scripts/helpers.test.mjs +121 -0
  369. package/templates/.agents/skills/zaip-skill-module-scaffold/scripts/scaffold.mjs +169 -0
  370. package/templates/.agents/skills/zaip-skill-move-prd/SKILL.md +1 -1
  371. package/templates/.agents/skills/zaip-skill-move-spec/SKILL.md +1 -1
  372. package/templates/.agents/skills/zaip-skill-performance-engineering/SKILL.md +14 -0
  373. package/templates/.agents/skills/zaip-skill-performance-engineering/agents/openai.yaml +4 -0
  374. package/templates/.agents/skills/zaip-skill-prd/SKILL.md +1 -1
  375. package/templates/.agents/skills/zaip-skill-reconcile-telemetry/scripts/reconcile-local-telemetry.mjs +1 -0
  376. package/templates/.agents/skills/zaip-skill-reconcile-telemetry/scripts/reconcile-telemetry-lib.mjs +26 -9
  377. package/templates/.agents/skills/zaip-skill-reconcile-telemetry/scripts/reconcile-telemetry-lib.test.mjs +39 -13
  378. package/templates/.agents/skills/zaip-skill-reconcile-telemetry/scripts/reconcile-telemetry-remeasurement.mjs +1 -0
  379. package/templates/.agents/skills/zaip-skill-refactor-landing-page/SKILL.md +66 -0
  380. package/templates/.agents/skills/zaip-skill-refactor-landing-page/agents/openai.yaml +4 -0
  381. package/templates/.agents/skills/zaip-skill-refactor-landing-page/references/behavioral-dry-run.md +23 -0
  382. package/templates/.agents/skills/zaip-skill-release-qualification/SKILL.md +40 -1
  383. package/templates/.agents/skills/zaip-skill-release-qualification/references/local-preparation.md +98 -0
  384. package/templates/.agents/skills/zaip-skill-review/SKILL.md +1 -0
  385. package/templates/.agents/skills/zaip-skill-rules/SKILL.md +3 -3
  386. package/templates/.agents/skills/zaip-skill-sales-methodology/SKILL.md +2 -0
  387. package/templates/.agents/skills/zaip-skill-setup/SKILL.md +19 -21
  388. package/templates/.agents/skills/zaip-skill-setup/agents/openai.yaml +2 -2
  389. package/templates/.agents/skills/zaip-skill-spec/SKILL.md +3 -2
  390. package/templates/.agents/skills/zaip-skill-storage-uploads/SKILL.md +14 -0
  391. package/templates/.agents/skills/zaip-skill-storage-uploads/agents/openai.yaml +4 -0
  392. package/templates/.agents/skills/zaip-skill-systematic-debugging/SKILL.md +14 -0
  393. package/templates/.agents/skills/zaip-skill-systematic-debugging/agents/openai.yaml +4 -0
  394. package/templates/.agents/skills/zaip-skill-task/SKILL.md +16 -7
  395. package/templates/.agents/skills/zaip-skill-task/references/commit-policy.md +25 -0
  396. package/templates/.agents/skills/zaip-skill-test-data/SKILL.md +14 -0
  397. package/templates/.agents/skills/zaip-skill-test-data/agents/openai.yaml +4 -0
  398. package/templates/.agents/skills/zaip-skill-test-data/scripts/generate.mjs +72 -0
  399. package/templates/.agents/skills/zaip-skill-testing-strategy/SKILL.md +15 -0
  400. package/templates/.agents/skills/zaip-skill-testing-strategy/agents/openai.yaml +4 -0
  401. package/templates/.agents/skills/zaip-skill-testing-strategy/references/example-map.md +3 -0
  402. package/templates/.agents/skills/zaip-skill-website-readiness/SKILL.md +8 -0
  403. package/templates/.agents/zaip-aios/VERSION +1 -1
  404. package/templates/.agents/zaip-aios/guides/10-seguranca.md +2 -1
  405. package/templates/.agents/zaip-aios/guides/20-instalacao-detalhada.md +5 -3
  406. package/templates/scripts/validate-cloud-hostinger-contract.mjs +34 -0
  407. package/templates/template-manifest.json +955 -211
  408. package/templates/.agents/branding/.gitkeep +0 -0
  409. package/templates/.agents/dashboard/apps/frontend/dist/assets/CostCalculationGuidePage-snUCQYTC.js +0 -1
  410. package/templates/.agents/dashboard/apps/frontend/dist/assets/PricingSettingsDialog-BPtVUGgs.js +0 -1
  411. package/templates/.agents/dashboard/apps/frontend/dist/assets/ProjectSettingsPage-3Awyaovx.js +0 -3
  412. package/templates/.agents/dashboard/apps/frontend/dist/assets/ProjectSettingsPage-GgzpZ_PY.css +0 -1
  413. package/templates/.agents/dashboard/apps/frontend/dist/assets/TraceabilityWorkspace-BCvZFMEf.js +0 -1
  414. package/templates/.agents/dashboard/apps/frontend/dist/assets/cost-monitor-DbaLbU2q.js +0 -68
  415. package/templates/.agents/dashboard/apps/frontend/dist/assets/index-_MEktQNM.js +0 -2
  416. package/templates/.agents/dashboard/apps/frontend/dist/assets/rolldown-runtime-D9-fqq9M.js +0 -1
  417. package/templates/.agents/dashboard/apps/frontend/dist/assets/traceability-BDe4_Ubl.js +0 -1
  418. package/templates/.agents/growth/.gitkeep +0 -0
  419. package/templates/.agents/marketing/.gitkeep +0 -0
  420. package/templates/.agents/sales/.gitkeep +0 -0
@@ -0,0 +1,49 @@
1
+ import type { CostLocale } from "@zaip-ai/dashboard-cost-monitor/react";
2
+ import { useEffect, useState } from "react";
3
+ import { shouldShowSnapshotNotice, snapshotNoticeDelayMs } from "./snapshot-notice.js";
4
+ export function useSnapshotNotice(
5
+ snapshotUpdating: boolean,
6
+ initialDataPending: boolean,
7
+ costLocale: CostLocale,
8
+ ) {
9
+ const [snapshotNoticeDismissed, setSnapshotNoticeDismissed] = useState(false);
10
+ const [snapshotNoticeDelayElapsed, setSnapshotNoticeDelayElapsed] = useState(false);
11
+ useEffect(() => {
12
+ if (!snapshotUpdating || !initialDataPending || snapshotNoticeDismissed) {
13
+ setSnapshotNoticeDelayElapsed(false);
14
+ return undefined;
15
+ }
16
+ const timeout = window.setTimeout(
17
+ () => setSnapshotNoticeDelayElapsed(true),
18
+ snapshotNoticeDelayMs,
19
+ );
20
+ return () => window.clearTimeout(timeout);
21
+ }, [initialDataPending, snapshotNoticeDismissed, snapshotUpdating]);
22
+ const snapshotNoticeVisible = shouldShowSnapshotNotice({
23
+ snapshotUpdating,
24
+ initialDataPending,
25
+ dismissed: snapshotNoticeDismissed,
26
+ delayElapsed: snapshotNoticeDelayElapsed,
27
+ });
28
+ const snapshotNotice = snapshotNoticeVisible ? (
29
+ <div aria-live="polite" className="app-notice app-snapshot-status" role="status">
30
+ <span>
31
+ Exibindo o último snapshot local validado. Os dados canônicos estão sendo atualizados em
32
+ segundo plano e estarão atuais na próxima abertura.
33
+ </span>
34
+ <button
35
+ aria-label={
36
+ costLocale === "pt-BR"
37
+ ? "Fechar aviso de atualização do snapshot"
38
+ : "Dismiss snapshot update notice"
39
+ }
40
+ onClick={() => setSnapshotNoticeDismissed(true)}
41
+ type="button"
42
+ >
43
+ ×
44
+ </button>
45
+ </div>
46
+ ) : null;
47
+
48
+ return snapshotNotice;
49
+ }
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@zaip-ai/dashboard-cost-monitor",
3
- "version": "2.2.0",
3
+ "version": "2.6.0",
4
4
  "private": true,
5
5
  "type": "module",
6
6
  "exports": {
@@ -0,0 +1,16 @@
1
+ import { CostDeveloperAttributionPanel } from "./CostDeveloperAttributionPanel.js";
2
+ import type { CostLocale } from "./cost-monitor-copy.js";
3
+ import type { CostView } from "./cost-monitor-views.js";
4
+ export function CostDeveloperPanelSlot({
5
+ locale,
6
+ range,
7
+ view,
8
+ }: {
9
+ locale: CostLocale;
10
+ range: { from: string; to: string } | undefined;
11
+ view: CostView;
12
+ }) {
13
+ return view === "developers" ? (
14
+ <CostDeveloperAttributionPanel locale={locale} {...(range === undefined ? {} : range)} />
15
+ ) : null;
16
+ }
@@ -0,0 +1,459 @@
1
+ import { DataTable } from "@zaip-ai/dashboard-ui";
2
+ import type { CostGroupRow, DurationCoverage } from "../contracts.js";
3
+ import { MoreVerticalIcon } from "./CostTableIcons.js";
4
+ import { costPeriodHeading } from "./CostTables.js";
5
+ import type { CostCurrency, CostLocale } from "./cost-monitor-copy.js";
6
+ import { localizedDescription, sumNumbers } from "./cost-table-metrics.js";
7
+ import {
8
+ costGroupsScrollLabel,
9
+ costPeriodTotalAriaLabel,
10
+ formatCostPeriodLabel,
11
+ formatDateTime,
12
+ } from "./cost-table-presentation.js";
13
+ import type { CostGroupTotals } from "./use-cost-group-page.js";
14
+
15
+ export {
16
+ type CostDeveloperAttributionRow,
17
+ CostDeveloperAttributionTable,
18
+ } from "./CostDeveloperAttributionTable.js";
19
+ export { CostModelsAuditTable } from "./CostModelsAuditTable.js";
20
+
21
+ export {
22
+ agentRunModelPresentation,
23
+ contextUpliftUsd,
24
+ hasCollectedUsage,
25
+ isDisplayableModel,
26
+ localizedDescription,
27
+ ratio,
28
+ scenario,
29
+ sumNumbers,
30
+ } from "./cost-table-metrics.js";
31
+ export {
32
+ costGroupsScrollLabel,
33
+ costPeriodTotalAriaLabel,
34
+ costRunsDurationTotal,
35
+ costRunsScrollLabel,
36
+ formatBrlRate,
37
+ formatCostPeriodLabel,
38
+ formatDateTime,
39
+ formatMultiplierPair,
40
+ formatRate,
41
+ formatReasoningEffort,
42
+ formatServiceTier,
43
+ formatUsd,
44
+ isCompactRunColumnVisible,
45
+ } from "./cost-table-presentation.js";
46
+
47
+ import {
48
+ displayCostGroupLabel,
49
+ formatAuditableCompactNumber,
50
+ formatAuditableCurrency,
51
+ formatDurationCoverage,
52
+ formatFactualCount,
53
+ hasKnownDuration,
54
+ sortCostValue,
55
+ } from "./cost-table-formatters.js";
56
+
57
+ export {
58
+ costRunsFooterLabel,
59
+ displayCostGroupLabel,
60
+ formatAuditableCompactNumber,
61
+ formatAuditableCurrency,
62
+ formatAuditableDuration,
63
+ formatAuditableNumber,
64
+ formatDurationCoverage,
65
+ formatTokenBackedDuration,
66
+ hasKnownDuration,
67
+ runOriginBadge,
68
+ sortCostValue,
69
+ } from "./cost-table-formatters.js";
70
+
71
+ export function CostGroupsTable({
72
+ rows,
73
+ currency,
74
+ locale,
75
+ onOpenTrace,
76
+ period,
77
+ showDateTime = true,
78
+ showAgentIdentity = false,
79
+ showInvocationTasks = false,
80
+ showModelLifecycleDetails = false,
81
+ dateHeading,
82
+ labelHeading,
83
+ totals: suppliedTotals,
84
+ loading = false,
85
+ }: {
86
+ rows: readonly CostGroupRow[];
87
+ currency: CostCurrency;
88
+ locale: CostLocale;
89
+ onOpenTrace?: (taskId: string) => void;
90
+ period?: "daily" | "monthly" | "annual";
91
+ showDateTime?: boolean;
92
+ showAgentIdentity?: boolean;
93
+ showInvocationTasks?: boolean;
94
+ showModelLifecycleDetails?: boolean;
95
+ dateHeading?: string;
96
+ labelHeading?: string;
97
+ totals?: CostGroupTotals;
98
+ loading?: boolean;
99
+ }) {
100
+ const displayCount = (value: number | null) =>
101
+ formatFactualCount(
102
+ showAgentIdentity || showModelLifecycleDetails ? (value ?? 0) : value,
103
+ locale,
104
+ );
105
+ const displayDuration = (value: DurationCoverage) =>
106
+ (showAgentIdentity || showModelLifecycleDetails) && value.known_sum <= 0
107
+ ? "0"
108
+ : formatDurationCoverage(value, locale);
109
+ const displayCurrency = (value: number | null) =>
110
+ formatAuditableCurrency(
111
+ showAgentIdentity || showModelLifecycleDetails ? (value ?? 0) : value,
112
+ currency,
113
+ locale,
114
+ );
115
+ const conversationCount = (row: unknown): number | null =>
116
+ (row as { conversation_count?: number | null }).conversation_count ?? null;
117
+ const pageTotals = {
118
+ runs: rows.reduce((sum, row) => sum + row.run_count, 0),
119
+ tasks: sumNumbers(rows.map((row) => row.task_count)),
120
+ prds: sumNumbers(rows.map((row) => row.prd_count)),
121
+ specs: sumNumbers(rows.map((row) => row.spec_count)),
122
+ evidences: sumNumbers(rows.map((row) => row.evidence_count)),
123
+ tests: sumNumbers(rows.map((row) => row.test_count)),
124
+ conversations: sumNumbers(rows.map(conversationCount)),
125
+ durationKnownMs: rows.reduce((sum, row) => sum + row.duration.known_sum, 0),
126
+ durationPartial: rows.some((row) => !row.duration.complete),
127
+ tokens: sumNumbers(rows.map((row) => row.total_tokens)),
128
+ usd: sumNumbers(rows.map((row) => row.estimated_usd)),
129
+ brl: sumNumbers(rows.map((row) => row.estimated_brl)),
130
+ };
131
+ const totals =
132
+ suppliedTotals === undefined
133
+ ? pageTotals
134
+ : {
135
+ runs: suppliedTotals.run_count,
136
+ tasks: suppliedTotals.task_count,
137
+ prds: suppliedTotals.prd_count,
138
+ specs: suppliedTotals.spec_count,
139
+ evidences: suppliedTotals.evidence_count,
140
+ tests: suppliedTotals.test_count,
141
+ conversations: conversationCount(suppliedTotals) ?? pageTotals.conversations,
142
+ durationKnownMs: suppliedTotals.duration.known_sum,
143
+ durationPartial: !suppliedTotals.duration.complete,
144
+ tokens: suppliedTotals.total_tokens,
145
+ usd: suppliedTotals.estimated_usd,
146
+ brl: suppliedTotals.estimated_brl,
147
+ };
148
+ const totalDurationDisplay = displayDuration(
149
+ suppliedTotals?.duration ?? {
150
+ known_sum: totals.durationKnownMs,
151
+ unknown: totals.durationPartial ? 1 : 0,
152
+ complete: !totals.durationPartial,
153
+ // Group-level coverage is intentionally preserved separately from the
154
+ // factual known sum. Individual rows retain their original provenance.
155
+ coverage_ratio: totals.durationPartial ? 0 : 1,
156
+ },
157
+ );
158
+ const totalTokensDisplay = formatAuditableCompactNumber(
159
+ showModelLifecycleDetails ? (totals.tokens ?? 0) : totals.tokens,
160
+ locale,
161
+ );
162
+ const totalCostDisplay = displayCurrency(currency === "BRL" ? totals.brl : totals.usd);
163
+ const totalAriaLabel = costPeriodTotalAriaLabel({
164
+ locale,
165
+ duration: totalDurationDisplay,
166
+ tokens: totalTokensDisplay,
167
+ cost: totalCostDisplay,
168
+ currency,
169
+ });
170
+ const totalLabel = locale === "pt-BR" ? "Total geral" : "Grand total";
171
+ return (
172
+ <DataTable
173
+ columns={[
174
+ {
175
+ key: "latestStartedAt",
176
+ label: dateHeading ?? (locale === "pt-BR" ? "Data e hora" : "Date and time"),
177
+ render: (row) => formatDateTime(row.latest_started_at, locale),
178
+ hidden: !showDateTime,
179
+ footer: showDateTime ? <output aria-label={totalLabel}>Total</output> : undefined,
180
+ },
181
+ ...(showAgentIdentity
182
+ ? [
183
+ {
184
+ key: "persona",
185
+ label: locale === "pt-BR" ? "Persona" : "Persona",
186
+ render: (row: CostGroupRow) => row.persona ?? "",
187
+ },
188
+ {
189
+ key: "job",
190
+ label: locale === "pt-BR" ? "Cargo" : "Job",
191
+ render: (row: CostGroupRow) => row.job ?? "",
192
+ },
193
+ ]
194
+ : []),
195
+ {
196
+ key: "label",
197
+ label:
198
+ period === undefined
199
+ ? (labelHeading ?? (locale === "pt-BR" ? "Grupo" : "Group"))
200
+ : costPeriodHeading(period, locale),
201
+ render: (row) => {
202
+ if (period !== undefined) {
203
+ return <strong>{formatCostPeriodLabel(row.key, period, locale)}</strong>;
204
+ }
205
+ const displayLabel = displayCostGroupLabel(row.label, locale);
206
+ const unavailableLabel = displayLabel !== row.label;
207
+ return (
208
+ <>
209
+ <strong>{displayLabel}</strong>
210
+ {unavailableLabel || row.key === row.label ? null : <small>{row.key}</small>}
211
+ </>
212
+ );
213
+ },
214
+ sortValue: (row) => row.key,
215
+ footer: showDateTime ? undefined : <output aria-label={totalLabel}>Total</output>,
216
+ },
217
+ ...(period === undefined && !showAgentIdentity && !showModelLifecycleDetails
218
+ ? [
219
+ {
220
+ key: "runs",
221
+ label: locale === "pt-BR" ? "Invocações" : "Agent invocations",
222
+ render: (row: CostGroupRow) => row.run_count,
223
+ align: "right" as const,
224
+ footer: totals.runs,
225
+ },
226
+ ...(showAgentIdentity
227
+ ? []
228
+ : [
229
+ {
230
+ key: "tasks",
231
+ label:
232
+ showAgentIdentity || showInvocationTasks
233
+ ? locale === "pt-BR"
234
+ ? "Tarefas com invocação"
235
+ : "Tasks with invocations"
236
+ : locale === "pt-BR"
237
+ ? "Tarefas criadas"
238
+ : "Tasks created",
239
+ render: (row: CostGroupRow) => row.task_count ?? 0,
240
+ align: "right" as const,
241
+ footer: totals.tasks,
242
+ },
243
+ ]),
244
+ ]
245
+ : [
246
+ {
247
+ key: "prds",
248
+ label: "PRDs",
249
+ render: (row: CostGroupRow) => displayCount(row.prd_count),
250
+ sortValue: (row: CostGroupRow) => row.prd_count ?? 0,
251
+ align: "right" as const,
252
+ footer: displayCount(totals.prds),
253
+ description: localizedDescription(
254
+ locale,
255
+ showAgentIdentity
256
+ ? "PRDs com criação atribuída ao agente por Run registrado. Conta apenas vínculos observados, sem duplicar IDs."
257
+ : "PRDs criados por vínculo canônico com um único modelo financeiro observado. Sem essa prova, o indicador exibido é 0.",
258
+ "PRDs created through a canonical link to one observed financial model. Without that evidence, the displayed indicator is 0.",
259
+ ),
260
+ },
261
+ {
262
+ key: "specs",
263
+ label: "SPECs",
264
+ render: (row: CostGroupRow) => displayCount(row.spec_count),
265
+ sortValue: (row: CostGroupRow) => row.spec_count ?? 0,
266
+ align: "right" as const,
267
+ footer: displayCount(totals.specs),
268
+ description: localizedDescription(
269
+ locale,
270
+ showAgentIdentity
271
+ ? "SPECs com criação atribuída ao agente por Run registrado. Conta apenas vínculos observados, sem duplicar IDs."
272
+ : "SPECs criadas por vínculo canônico com um único modelo financeiro observado. Sem essa prova, o indicador exibido é 0.",
273
+ "SPECs created through a canonical link to one observed financial model. Without that evidence, the displayed indicator is 0.",
274
+ ),
275
+ },
276
+ {
277
+ key: "tasks",
278
+ label: showAgentIdentity
279
+ ? locale === "pt-BR"
280
+ ? "Tarefas"
281
+ : "Tasks"
282
+ : showModelLifecycleDetails
283
+ ? "Tasks"
284
+ : locale === "pt-BR"
285
+ ? "Tarefas criadas"
286
+ : "Tasks created",
287
+ render: (row: CostGroupRow) => displayCount(row.task_count),
288
+ sortValue: (row: CostGroupRow) => row.task_count ?? 0,
289
+ align: "right" as const,
290
+ footer: displayCount(totals.tasks),
291
+ description: localizedDescription(
292
+ locale,
293
+ showAgentIdentity
294
+ ? "Tasks distintas em que o agente participou no período. Uma Task pode contar em vários agentes; o total soma essas participações entre agentes. Sem participação, mostra 0."
295
+ : "Tasks contam apenas quando creation_run_id tem um único modelo financeiro observável. Participação posterior não é criação; ausência ou multi-modelo exibe 0.",
296
+ "Tasks count only when creation_run_id has one observed financial model. Later participation is not creation; missing or multi-model linkage displays 0.",
297
+ ),
298
+ },
299
+ ...(showModelLifecycleDetails
300
+ ? [
301
+ {
302
+ key: "conversations",
303
+ label: "Conversations",
304
+ render: (row: CostGroupRow) => displayCount(conversationCount(row)),
305
+ sortValue: (row: CostGroupRow) => conversationCount(row) ?? 0,
306
+ align: "right" as const,
307
+ footer: displayCount(totals.conversations),
308
+ description: localizedDescription(
309
+ locale,
310
+ "Conversas canônicas, incluindo turns unassisted legados. Cada ID conta uma vez por modelo; um modelo múltiplo pode repetir. Run com Task e conversa de origem não cria Task adicional.",
311
+ "Canonical conversations, including legacy unassisted turns. Each ID counts once per model; a multi-model conversation may repeat. A Run with a Task and source conversation does not create an additional Task.",
312
+ ),
313
+ },
314
+ ]
315
+ : []),
316
+ {
317
+ key: "runs",
318
+ label: "Runs",
319
+ render: (row: CostGroupRow) => row.run_count,
320
+ sortValue: (row: CostGroupRow) => row.run_count,
321
+ align: "right" as const,
322
+ footer: totals.runs,
323
+ description: localizedDescription(
324
+ locale,
325
+ showAgentIdentity
326
+ ? "Chamadas observadas atribuídas ao agente no período selecionado."
327
+ : "Runs financeiros observados neste modelo, sem distribuir ou duplicar custo, tokens e tempo entre modelos.",
328
+ "Observed financial Runs for this model, without allocating or duplicating cost, tokens, or time across models.",
329
+ ),
330
+ },
331
+ {
332
+ key: "tests",
333
+ label: locale === "pt-BR" ? "Testes" : "Tests",
334
+ render: (row: CostGroupRow) => displayCount(row.test_count),
335
+ sortValue: (row: CostGroupRow) => row.test_count ?? 0,
336
+ align: "right" as const,
337
+ footer: displayCount(totals.tests),
338
+ description: localizedDescription(
339
+ locale,
340
+ showAgentIdentity
341
+ ? "Registros de testes distintos vinculados ao Run do agente no período. Revisões e outras validações não são contadas como testes."
342
+ : "Validações canônicas cuja artifact_run_id coincide com a Run registradora deste modelo; ausência de prova exibe 0.",
343
+ "Canonical validations whose artifact_run_id matches this model's registering Run; missing evidence displays 0.",
344
+ ),
345
+ },
346
+ {
347
+ key: "evidences",
348
+ label: locale === "pt-BR" ? "Evidências" : "Evidence",
349
+ render: (row: CostGroupRow) => displayCount(row.evidence_count),
350
+ sortValue: (row: CostGroupRow) => row.evidence_count ?? 0,
351
+ align: "right" as const,
352
+ footer: displayCount(totals.evidences),
353
+ description: localizedDescription(
354
+ locale,
355
+ showAgentIdentity
356
+ ? "Evidências distintas vinculadas ao Run do agente no período. Conta apenas vínculos registrados."
357
+ : "Evidências canônicas cuja artifact_run_id coincide com a Run registradora deste modelo; o total não duplica a mesma evidência. Sem prova, exibe 0.",
358
+ "Canonical evidence whose artifact_run_id matches this model's registering Run; the total does not duplicate the same evidence. Missing proof displays 0.",
359
+ ),
360
+ },
361
+ ]),
362
+ {
363
+ key: "duration",
364
+ label: "Tempo",
365
+ render: (row) => displayDuration(row.duration),
366
+ sortValue: (row) =>
367
+ hasKnownDuration(row.duration)
368
+ ? row.duration.known_sum
369
+ : showModelLifecycleDetails
370
+ ? 0
371
+ : null,
372
+ align: "right",
373
+ footer: <output aria-label={totalAriaLabel}>{totalDurationDisplay}</output>,
374
+ },
375
+ {
376
+ key: "tokens",
377
+ label: "Tokens",
378
+ render: (row) =>
379
+ formatAuditableCompactNumber(
380
+ showModelLifecycleDetails ? (row.total_tokens ?? 0) : row.total_tokens,
381
+ locale,
382
+ ),
383
+ sortValue: (row) =>
384
+ showModelLifecycleDetails ? (row.total_tokens ?? 0) : row.total_tokens,
385
+ align: "right",
386
+ footer: <output aria-label={totalAriaLabel}>{totalTokensDisplay}</output>,
387
+ },
388
+ {
389
+ key: "cost",
390
+ label:
391
+ showAgentIdentity || showModelLifecycleDetails || period !== undefined
392
+ ? locale === "pt-BR"
393
+ ? "Custos"
394
+ : "Costs"
395
+ : period === undefined
396
+ ? locale === "pt-BR"
397
+ ? "Custo"
398
+ : "Cost"
399
+ : locale === "pt-BR"
400
+ ? "Custos"
401
+ : "Costs",
402
+ render: (row) =>
403
+ displayCurrency(currency === "BRL" ? row.estimated_brl : row.estimated_usd),
404
+ sortValue: (row) =>
405
+ showModelLifecycleDetails
406
+ ? (sortCostValue(currency, row.estimated_brl, row.estimated_usd) ?? 0)
407
+ : sortCostValue(currency, row.estimated_brl, row.estimated_usd),
408
+ align: "right",
409
+ footer: <output aria-label={totalAriaLabel}>{totalCostDisplay}</output>,
410
+ },
411
+ ...(onOpenTrace
412
+ ? [
413
+ {
414
+ key: "trace",
415
+ label: "",
416
+ render: (row: CostGroupRow) => (
417
+ <button
418
+ aria-label="Abrir detalhes"
419
+ className="cost-row-action"
420
+ onClick={(event) => {
421
+ event.stopPropagation();
422
+ onOpenTrace(row.key);
423
+ }}
424
+ type="button"
425
+ >
426
+ <MoreVerticalIcon />
427
+ </button>
428
+ ),
429
+ },
430
+ ]
431
+ : []),
432
+ ]}
433
+ defaultSort={
434
+ showAgentIdentity
435
+ ? { key: "cost", direction: "desc" }
436
+ : period === undefined
437
+ ? null
438
+ : { key: "label", direction: "desc" }
439
+ }
440
+ locale={locale}
441
+ emptyMessage={
442
+ loading
443
+ ? locale === "pt-BR"
444
+ ? "Carregando…"
445
+ : "Loading…"
446
+ : locale === "pt-BR"
447
+ ? "Nenhum dado disponível."
448
+ : "No data available."
449
+ }
450
+ pageSize={100}
451
+ rowKey={(row) => row.key}
452
+ onRowClick={onOpenTrace === undefined ? undefined : (row) => onOpenTrace(row.key)}
453
+ rows={rows}
454
+ scrollLabel={costGroupsScrollLabel(locale)}
455
+ showColumnInfo
456
+ sortable
457
+ />
458
+ );
459
+ }
@@ -456,30 +456,35 @@ describe("cost monitor navigation", () => {
456
456
 
457
457
  it("places the shared developer table inside the Cost Monitor content section", () => {
458
458
  const page = readFileSync(new URL("./CostMonitorPage.tsx", import.meta.url), "utf8");
459
+ const panel = readFileSync(new URL("./CostDeveloperPanelSlot.tsx", import.meta.url), "utf8");
459
460
  const content = readFileSync(new URL("./CostMonitorContent.tsx", import.meta.url), "utf8");
460
461
 
461
- expect(page).toMatch(
462
- /developerPanel=\{\s*view === "developers" \? \(\s*<CostDeveloperAttributionPanel\b/,
463
- );
462
+ expect(page).toContain('from "./CostDeveloperPanelSlot.js"');
463
+ expect(page).toMatch(/developerPanel=\{\s*<CostDeveloperPanelSlot/);
464
+ expect(panel).toContain('view === "developers"');
465
+ expect(panel).toContain("CostDeveloperAttributionPanel");
464
466
  expect(page).not.toMatch(/<\/CostMonitorContent>\s*\{view === "developers"/);
465
467
  expect(content).toContain('{view === "developers" ? developerPanel : null}');
466
468
  });
467
469
 
468
470
  it("prepares the complete developer API population with the same all-time range as the table", () => {
469
471
  const page = readFileSync(new URL("./CostMonitorPage.tsx", import.meta.url), "utf8");
470
- const exportSection = page.slice(
471
- page.indexOf("const developerExportSource"),
472
- page.indexOf("const costGroupExportSource"),
472
+ const exportSources = readFileSync(
473
+ new URL("./cost-monitor-export-sources.ts", import.meta.url),
474
+ "utf8",
473
475
  );
476
+ const panel = readFileSync(new URL("./CostDeveloperPanelSlot.tsx", import.meta.url), "utf8");
474
477
 
475
- expect(exportSection).toContain('view === "developers"');
476
- expect(exportSection).toContain("loadCostDeveloperAttribution");
477
- expect(exportSection).toContain(
478
+ expect(page).toContain('from "./cost-monitor-export-sources.js"');
479
+ expect(page).toContain("buildCostMonitorExportSources({");
480
+ expect(exportSources).toContain('view === "developers"');
481
+ expect(exportSources).toContain("loadCostDeveloperAttribution");
482
+ expect(exportSources).toContain(
478
483
  "...(developerAttributionRange === undefined ? {} : developerAttributionRange)",
479
484
  );
480
- expect(exportSection).toContain("totalRows: developerRows.length");
485
+ expect(exportSources).toContain("totalRows: developerRows.length");
481
486
  expect(page).toContain("const developerAttributionRange = resolveDeveloperAttributionRange");
482
- expect(page).toContain("...(developerAttributionRange === undefined");
487
+ expect(panel).toContain("range === undefined ? {} : range");
483
488
  expect(page).toMatch(
484
489
  /agentInvocationExportSource \?\?\s*developerExportSource \?\?\s*costGroupExportSource/,
485
490
  );
@@ -505,13 +510,18 @@ describe("cost monitor navigation", () => {
505
510
 
506
511
  it("prepares every paginated period row for daily, monthly, and annual exports", () => {
507
512
  const page = readFileSync(new URL("./CostMonitorPage.tsx", import.meta.url), "utf8");
513
+ const exportSources = readFileSync(
514
+ new URL("./cost-monitor-export-sources.ts", import.meta.url),
515
+ "utf8",
516
+ );
508
517
 
509
- expect(page).toContain('view === "daily" ||');
510
- expect(page).toContain('view === "monthly" ||');
511
- expect(page).toContain('view === "annual" ||');
512
- expect(page).toContain("...(groupPageRange === undefined ? {} : groupPageRange)");
513
- expect(page).toContain("totalRows: firstPage.total_count");
514
- expect(page).toContain("nextOffset >= page.total_count || !page.has_more");
518
+ expect(page).toContain("buildCostMonitorExportSources({");
519
+ expect(exportSources).toContain('view === "daily" ||');
520
+ expect(exportSources).toContain('view === "monthly" ||');
521
+ expect(exportSources).toContain('view === "annual" ||');
522
+ expect(exportSources).toContain("...(groupPageRange === undefined ? {} : groupPageRange)");
523
+ expect(exportSources).toContain("totalRows: firstPage.total_count");
524
+ expect(exportSources).toContain("nextOffset >= page.total_count || !page.has_more");
515
525
  });
516
526
 
517
527
  it("resolves an Agent Run to its own details", () => {