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