@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,11 +1,11 @@
|
|
|
1
1
|
b146bd0c7c60b1ab43c4f71e0b1d2262c6df6da6f7053a0425f834ccb77a6b48 LICENSE
|
|
2
2
|
bc02cba77e8d51e5c580f43668863dc868eda66f1ff663bfaa49fcf3ca16320e THIRD_PARTY_NOTICES.md
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
3
|
+
2985be8b28d3ade858e8d8fb4bc22f565b1bf6020dff982dce141f7721b9999c VERSION
|
|
4
|
+
ea4542bdeaee90694dd1402fa015026af0e8f7d11cce0d36bd6b7384971476a8 bin/zaip.mjs
|
|
5
|
+
c22da8ce06147f89a055bad9bb7800085768c9fc263728db5fb54e069825e052 manifest.json
|
|
6
6
|
7f89219d7c567c82a51679ad136d84364bded7ac659492537e125d33b1d58a7a migrations/001-layout-v1.json
|
|
7
7
|
5f8c48b286d0b44d8fbb57a9a5d009a8a500439aa3148d750b8f193f72995c9f migrations/002-layout-v2.json
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
8
|
+
2d738247131a923ea6e3a32d0d1d6de763866fd96a8a8dc75d127a343809b0aa pnpm-lock.sha256
|
|
9
|
+
d04ab7db3df0f713e1805e4bd0b735015c46e1108e2bb2fc1ef0ee4ac5790b7e provenance.json
|
|
10
|
+
f6dc78ff791e700d82cc2dc76a76898849c1d6f4b9a7f283e5840e80e52479aa sbom.cdx.json
|
|
11
11
|
b3ffedf9e146be802a15b4009f33e031dec3071ca1525e12c67606fd964a3067 schemas/contracts.schema.json
|
|
@@ -1 +1 @@
|
|
|
1
|
-
|
|
1
|
+
f8557f3600849eb880b8f245b63b80fed9a3e9addf2c5f2c6d492547af900219 pnpm-lock.yaml
|
|
@@ -2,10 +2,10 @@
|
|
|
2
2
|
"schema_version": 1,
|
|
3
3
|
"statement_type": "self_reported_build_integrity",
|
|
4
4
|
"authenticity": "unverified",
|
|
5
|
-
"version": "
|
|
5
|
+
"version": "3.0.0",
|
|
6
6
|
"source_origin": "zaip-aios:local-build",
|
|
7
|
-
"lockfile_sha256": "
|
|
8
|
-
"sbom_sha256": "
|
|
9
|
-
"runtime_sha256": "
|
|
10
|
-
"statement_sha256": "
|
|
7
|
+
"lockfile_sha256": "f8557f3600849eb880b8f245b63b80fed9a3e9addf2c5f2c6d492547af900219",
|
|
8
|
+
"sbom_sha256": "f6dc78ff791e700d82cc2dc76a76898849c1d6f4b9a7f283e5840e80e52479aa",
|
|
9
|
+
"runtime_sha256": "f6b7e8a96164b8597d41077e8bd913beb40ae0407a88ec60b221ce08eee73bb5",
|
|
10
|
+
"statement_sha256": "64b394412fc8d6a391a88a1175c5edb8c2042f71054972b4cd37e6b163380bd2"
|
|
11
11
|
}
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
"component": {
|
|
7
7
|
"type": "application",
|
|
8
8
|
"name": "zaip-aios",
|
|
9
|
-
"version": "
|
|
9
|
+
"version": "3.0.0"
|
|
10
10
|
}
|
|
11
11
|
},
|
|
12
12
|
"components": [
|
|
@@ -2539,8 +2539,8 @@
|
|
|
2539
2539
|
{
|
|
2540
2540
|
"type": "library",
|
|
2541
2541
|
"name": "hono",
|
|
2542
|
-
"version": "4.
|
|
2543
|
-
"purl": "pkg:npm/hono@4.
|
|
2542
|
+
"version": "4.13.5",
|
|
2543
|
+
"purl": "pkg:npm/hono@4.13.5"
|
|
2544
2544
|
},
|
|
2545
2545
|
{
|
|
2546
2546
|
"type": "library",
|
|
@@ -5,6 +5,8 @@ description: Inspect and prepare a reproducible local development environment wi
|
|
|
5
5
|
|
|
6
6
|
# Prepare development environment
|
|
7
7
|
|
|
8
|
+
Follow RULE-CORE host protection: never restart or shut down the user's computer. Inspect prerequisite installers and suppress automatic reboot using documented options; stop the step if suppression is uncertain. A pending OS restart is for the user to perform manually. Restarting an identified project process must never restart the OS.
|
|
9
|
+
|
|
8
10
|
Use for a new checkout, onboarding, or a local runtime failure. This concerns the consumer application; framework installation remains `$zaip-skill-setup`.
|
|
9
11
|
|
|
10
12
|
1. Read project configuration and manifests before proposing prerequisites. Never install packages, start services, or execute package scripts during discovery.
|
|
@@ -5,6 +5,8 @@ description: Execute prepared ZAIP work only on explicit intent; materialize its
|
|
|
5
5
|
|
|
6
6
|
# Executar trabalho preparado
|
|
7
7
|
|
|
8
|
+
Aplique a proteção do computador local de `RULE-CORE` antes de executar comandos e inclua-a no contexto de cada subagente. Nunca reinicie/desligue o PC, direta ou indiretamente, inclusive em validação, recuperação ou finalização. Reinício do SO fica exclusivamente a cargo do usuário.
|
|
9
|
+
|
|
8
10
|
Carregue [a governança de execução e delegação](references/runtime-governance.md) antes da entrega ou dispatch. Perguntas read-only sem descendentes usam somente o kernel de RULE-CORE e a skill de domínio pertinente.
|
|
9
11
|
|
|
10
12
|
Use esta skill somente quando o usuário pedir execução. `prepare` não autoriza mutação nem promoção para `ready`; quando a execução foi pedida explicitamente, prepare o PRD/SPEC ainda em `draft`, se necessário, e então execute sem exigir outra confirmação intermediária.
|
|
@@ -23,20 +25,41 @@ Use esta skill somente quando o usuário pedir execução. `prepare` não autori
|
|
|
23
25
|
12. Para delegação Codex, Sub-Run é somente subagente nativo de colaboração (`spawn_agent`). `create_thread` e `fork_thread` criam chats independentes e só podem ocorrer por pedido explícito do usuário; nunca os use como Sub-Run, fallback, retry ou prova de delegação. Se delegação nativa estiver indisponível, relate a limitação em vez de criar chat independente. Nome de catálogo, `task_name`, título ou prompt não provam ancestralidade nativa. Antes de repetir a mesma delegação limitada, aguarde ou reutilize seu filho pendente; capture somente ancestralidade/metadados observados em resultados nativos de spawn/terminal do host ou eventos SubagentStart/SubagentStop.
|
|
24
26
|
13. Interaction read-only sem descendentes termina após a resposta, sem executor/finalizador. Para interaction com descendente delegado e para delivery, depois que todos os Sub-Runs de trabalho terminarem invoque `zaip-agent-finalizer` como último filho com propósito `finalization`. Não inicie novos filhos depois dele; auto-settlement nunca fecha interaction com descendente ativo. Isso também vale para `cancelled`: o orquestrador aplica a decisão Gui pela CLI; comandos diretos Task/SPEC/PRD nunca terminalizam. Ausência, interrupção ou falha do Gui deixa a Execution inconclusiva como `blocked`.
|
|
25
27
|
14. SPEC/PRD permanece `active` entre Runs filhas e só entra em verificação após todas as Tasks; a Run filha não entrega nem bloqueia automaticamente o pai.
|
|
26
|
-
15. Resolva execução no menor grão
|
|
28
|
+
15. Resolva execução no menor grão que cubra o pedido inteiro: somente uma Task executa um nó elegível; toda a SPEC executa sua DAG interna; todo o PRD executa as SPECs selecionadas. Mencionar a primeira Task junto de “e as demais até terminar” não restringe um pedido macro a esse primeiro nó. Não amplie um pedido exclusivamente de Task para SPEC/PRD.
|
|
27
29
|
16. “Conclua a execução” ou “finalize a implementação” em macro ativo continua Tasks e gates até resultado verdadeiro; não força `deliver`. “Desenvolva/melhore/aprimore” interrompe execução implícita, registra diagnóstico e cria plano/rework antes de nova promoção.
|
|
28
30
|
|
|
31
|
+
## Captura correta antes de executar
|
|
32
|
+
|
|
33
|
+
- Antes de capturar uma retomada ambígua, use `conversation resolve --intent continue --prd ID --json` (ou `--spec ID` / `--task ID`). A consulta não cria Run, não promove trabalho nem aprova gates; confira o alvo, a Execution e `start_args`. Sem alvo explícito, o foco vem da última raiz da mesma thread, nunca do último executor/revisor/Gui. Para um PRD conhecido use seu ID explícito, mesmo se a última raiz foi uma correção avulsa.
|
|
34
|
+
- Resolva o alcance completo antes de iniciar a primeira parte. Em “Task X e o restante do PRD”, se X pertence à DAG, capture o PRD e delegue suas Tasks; mantenha Gui por Task e Gui parental ao final. Se X é uma entrega avulsa fora da DAG, não finja que pertence ao PRD: este runtime não possui coordenador multi-Execution. Identifique essa limitação antes de executar, preserve entregas já concluídas e não prometa uma sequência que exija trocar a raiz capturada. Uma correção avulsa já concluída não precisa ser reaberta para retomar o PRD.
|
|
35
|
+
|
|
36
|
+
- Pedido para executar um PRD/SPEC existente é continuação da entrega, não nova autoria. Resolva o ID canônico e use `conversation start --intent continue --prd ID` (ou `--spec ID` / `--task ID` no menor grão pedido); inspecione a Run retornada e reutilize sua identidade. Não use `--definition` para executar um macro já criado.
|
|
37
|
+
- `conversation start --intent new-work` já materializa e inicia Task, Change, Execution e Run. Não abra outra Run raiz para o mesmo turno. Uma repetição compatível deve reutilizar a identidade; intenção, alvo, modelo ou atribuição diferentes não são uma repetição compatível.
|
|
38
|
+
- Antes de iniciar Tasks ou delegar, confira `execution_kind: delivery`, atribuição ao alvo e Execution correta. Uma Run `interaction` de definição não autoriza a implementação. Não reescreva seu header, altere IDs do cliente ou retire a proteção de correlação para convertê-la.
|
|
39
|
+
- Quando a CLI rejeitar uma captura incompatível, preserve o estado e os IDs existentes e explique a divergência. Não avance manualmente as entidades para `executing` nem crie outro PRD/DAG como tentativa de recuperação. A proteção de um proprietário por invocação permanece obrigatória.
|
|
40
|
+
|
|
29
41
|
## Paralelismo
|
|
30
42
|
|
|
43
|
+
### Execução nativa de uma DAG no Codex
|
|
44
|
+
|
|
45
|
+
- `execution native-next EXEC --run RUN --contexts MAP.json --json` lê o PreparedPlan canônico e retorna envelopes; não inicia provider, não comprova autenticação nem constitui evidência de execução. O mapa associa IDs de Tasks a arquivos de contexto existentes construídos para o agente selecionado.
|
|
46
|
+
- Inicie ou retome apenas Changes/Tasks elegíveis pelos comandos lifecycle. O macro despacha um `zaip-agent-orchestrator` por tentativa de Task, capturado com `subagent capture --event start ... --parent-run-id MACRO-RUN --task TASK`. A CLI deriva os ancestrais da DAG; a invocação delegada preserva `run_role: subagent`, propósito `orchestration` e pai nativo real. Não crie raízes fictícias nem atribua a mesma invocação a duas Tasks.
|
|
47
|
+
- O orquestrador da Task despacha seus executores e revisores; eles retornam resultados e não criam filhos. Terminar um executor encerra somente sua Sub-Run. Após commit, integração aplicável, validações e `task verify`, Gui é o último filho direto do orquestrador da Task, irmão dos executores. Persista `run finalization TASK-RUN` com a decisão observada e IDs `EVD-*`. Encerrar o orquestrador sem Gui válido bloqueia somente sua Task; nunca aprova dependências bloqueadas.
|
|
48
|
+
- Depois de cada Task, continue a DAG. Apenas após todas as Tasks e os gates de integração, use `execution verify`; o Gui do macro continua sendo o último filho do macro e decide seu fechamento. Um Gui de Task não entrega automaticamente a SPEC/PRD.
|
|
49
|
+
- Uma invocação já atribuída a outra entrega não pode trocar de raiz no mesmo turno. Preserve sua identidade; não crie um novo trabalho independente ao retomar o PRD existente. O preflight deve detectar essa divergência antes da captura, não apenas após terminar a primeira parte. Não edite o PreparedPlan materializado nem reatribua Tasks históricas para contornar um conflito.
|
|
50
|
+
- A hierarquia PRD/SPEC coordena a DAG, não exige níveis adicionais de agentes: o host despacha diretamente o orquestrador de cada Task, sem inserir um agente macro intermediário. Respeite profundidade, capacidade e orçamento reais; sequencie Tasks quando necessário. Sem delegação nativa no orquestrador, registre a limitação; não transfira a obrigação ao executor nem simule ancestralidade.
|
|
51
|
+
- Perfis somente leitura retornam decisões/eventos; não gravam lifecycle. Aplique o relay do host autorizado descrito em `references/runtime-governance.md`, preservando Gui como último filho do orquestrador responsável. Não exija argumentos ausentes do schema nativo nem converta UUID em path. O host grava a decisão real antes do Stop canônico do Gui; ausência de captura ou persistência mantém resultado bloqueado e recuperável.
|
|
52
|
+
- Aumento de escopo explicitamente autorizado em rework usa `task amend-scopes TASK --run RUN --expected-revision N --add-scopes PATH[,PATH] --reason MOTIVO`. O comando registra delta aditivo recuperável na Change, preservando snapshot, IDs, ACs, risco e contadores. Não use o motivo como substituto de autorização nem altere o PreparedPlan materializado.
|
|
53
|
+
|
|
31
54
|
- A unidade de isolamento é a Task; a Execution mantém a DAG global, inclusive entre SPECs de um PRD.
|
|
32
55
|
- O agente pode escolher execução sequencial mesmo com paralelismo permitido.
|
|
33
56
|
- Toda integração final é uma dependência explícita e precisa repetir os gates relevantes no resultado combinado.
|
|
34
57
|
|
|
35
|
-
## Runtime
|
|
58
|
+
## Runtime gerenciado e compatibilidade
|
|
36
59
|
|
|
37
|
-
1. Leia `execution.runtime`.
|
|
38
|
-
2.
|
|
60
|
+
1. Leia `execution.runtime`. Novo padrão `managed` despacha PRD/SPEC pelo provider, mantendo avulsas diretas. Ausente/manual preserva execução tradicional; `autonomous` também permite Task gerenciada explícita. Legados já tentados exigem `task migrate-autonomy` revisado; nenhum consumo é zerado.
|
|
61
|
+
2. Com `autonomy.version: 1`, aplique `RULE-AUTONOMY-DECISION` e seu ledger estável por Task. A seleção manual fica no principal avulso; subagentes seguem política automática com aviso. Sem esse bloco, preserve `automatic_sources` legado (`spec`,`prd`). Não alegue enforcement de orçamento/modelo em ferramenta nativa que não passou pelo dispatch gerenciado.
|
|
39
62
|
3. Em autonomia, exija raiz Git limpa, worktree registrada por Task, commit final canônico sem alterações pendentes, diff dentro dos write scopes e merge abortável em conflito. A integração cria outro commit canônico por Task no histórico first-parent e referencia o SHA do candidato em `ZAIP-Product-Commit`.
|
|
40
|
-
4. Use o menor
|
|
63
|
+
4. Use o menor paralelismo entre projeto, plano, provider e squad. Em `autonomy-v1`, orçamento por Task vem exclusivamente do preset congelado: Essencial 4/1, Equilibrado 10/3, Persistente ilimitado (execuções/replans); tempo não encerra Task. Risco/domain definem assurance, não esse orçamento. Só no contrato legado use as quotas anteriores por risco.
|
|
41
64
|
5. Checkpoints opacos ficam somente em `.local`; não copie token de retomada para records rastreados. Critical recebe contexto fresco e verificador independente.
|
|
42
65
|
6. A validação tipada acontece dentro da worktree no commit candidato antes da integração. Falha de assurance não pode ser convertida em sucesso pelo coordenador.
|
|
@@ -6,8 +6,22 @@ Carregue antes de executar uma entrega ou delegar. Este contrato detalha o kerne
|
|
|
6
6
|
- Em modo manual carregue `RULE-MODEL-ORCHESTRATION` antes da primeira resposta visível; aviso não bloqueia nem altera seleção. Com Codex/delegação use apenas `codex_name` do catálogo, formato `zaip-agent-NOME`, recursivamente; proíba `default`, `worker`, `explorer` e tipos ad-hoc.
|
|
7
7
|
- Para delegação Codex, Sub-Run ZAIP é somente subagente nativo de colaboração (`spawn_agent`). `create_thread` e `fork_thread` criam chats independentes e exigem pedido explícito do usuário; nunca são Sub-Run, fallback, retry ou prova de delegação. Se delegação nativa estiver indisponível, relate a limitação em vez de criar chat independente. Nome de catálogo, `task_name`, título ou prompt não prova ancestralidade nativa. Antes de repetir a mesma delegação limitada, aguarde ou reutilize seu filho pendente e capture somente ancestralidade/metadados observados em resultados nativos de spawn/terminal do host ou eventos SubagentStart/SubagentStop.
|
|
8
8
|
- Cada `client_turn_id` observável tem uma Execution idempotente/claim atômico; sem ele use identidade local sem prometer idempotência. `interaction` read-only sem descendentes é conversa sem Task artificial e termina após a resposta entregue, sem executor ou finalizador; interaction com trabalho delegado e `delivery` exigem executor/finalizador. `delivery` é trabalho materializado e reuso exige kind/origem compatíveis. A raiz é `zaip-agent-orchestrator`; quando a barreira é exigida escolha executor por capacidade, permita reviewer/auditor/integrator e termine com `zaip-agent-finalizer` em `finalization`, após descendentes, bloqueando novas chamadas.
|
|
9
|
-
- Hooks são best-effort: após cada spawn/terminal o orquestrador
|
|
10
|
-
- Em `
|
|
11
|
-
-
|
|
9
|
+
- Hooks são best-effort: após cada spawn/terminal, o host autorizado a serviço do orquestrador executa `zaip subagent capture` idempotente com metadados reais. Na captura rica, preserve session/turn observados, `agent-id` com a identidade nativa retornada e `parent-agent-id`/`parent-run-id` do pai imediato exato; cada invocação preserva seu turn. Quando um evento terminal observado expõe somente agent_path, status, identidade catalogada e pai exato, `capture-terminal` aceita apenas `zaip-agent-finalizer` ou executor elegível para delivery com capacidade `task-delivery`; exige também `parent-run-id` igual ao `run_id` da raiz ativa exata, pois um client thread pode conter raízes concorrentes. O último segmento do agent_path deve ser seu `codex_task_name` canônico. O propósito deriva da identidade validada e session/turn/model/provider/usage permanecem indisponíveis; o fallback nunca substitui captura rica nem inventa modelo, effort, tokens ou custo.
|
|
10
|
+
- Em `autonomy-v1`, carregue `RULE-AUTONOMY-DECISION`. Task avulsa preserva seleção manual do principal, evita subagentes e só delega por necessidade concreta; quando delegar, informe que modelo/esforço dos filhos seguem a política ZAIP, sem obrigação de herdar o principal. Fixe configuração por chamada e registre seleção efetivamente observada. Sem `autonomy`, preserve o contrato legado de `automatic_sources` (`spec`,`prd`).
|
|
11
|
+
- Escaladas seguem o perfil congelado: Essencial nunca Astra automático; Equilibrado Sol/high, Astra/high, Astra/high, com execução Astra/high elegível no terceiro bloco; Persistente sem quota total. `RULE-ASTRA-DIAGNOSTIC` descreve também compatibilidade legada. Não use título/volume como prova nem alegue mudança de modelo apenas pelo prompt.
|
|
12
12
|
- Todo PreparedPlan PRD/SPEC traz `model_signals` por Task; o framework persiste `model_profile`, `task-risk-v1` e motivos, usando `runtime_defaults`, `runtime`, política/defaults sem `standard` silencioso. Não infira fase/complexidade/transversalidade/ambiguidade/rework/custo/capacidade por contagem de arquivos; use sinais, fase/agente e capacidades. Cabeçalho e `model.selection.recorded` repetem a seleção enviada.
|
|
13
13
|
- Plano visível: `DEFINE:`, `PLAN:`, `EXECUTE:` ou `VERIFY:`, 3–4 passos (máximo 5); omita fase sem ação e combine trivialidades.
|
|
14
|
+
|
|
15
|
+
## Limites do host e relay de persistência
|
|
16
|
+
|
|
17
|
+
- Gui pode ser o último filho para avaliar uma entrega que não conseguiu iniciar executor. Isso não concede sucesso: `executor_missing` mantém `completed` bloqueado mesmo com Evidence aprovada; decisões reais `blocked`/`failed` seguem o relay normal e preservam o motivo. Não crie executor cerimonial para satisfazer o fechamento. A exceção direta continua restrita à raiz Task autorizada desde a captura.
|
|
18
|
+
|
|
19
|
+
- `execution.runtime: managed` despacha PRD/SPEC pelo provider e mantém avulsas diretas. Para a raiz Task direta, registre a referência humana em `--direct-authorization` desde a captura. Identidade e intenção sozinhas não concedem autorização. Esse contrato substitui somente o executor filho; nunca Evidence, revisão aplicável, Gui ou identidade observada. Não autorize retroativamente uma raiz fechada, macro ou filho.
|
|
20
|
+
|
|
21
|
+
- Há exatamente um orquestrador responsável por tentativa de Task. Quando a raiz física já é Task-scoped, ela despacha executor/revisor e Gui diretamente: não inicia um Dave adicional. Somente uma raiz macro delega orquestradores de Tasks distintas; seus trabalhadores e Gui pertencem ao respectivo orquestrador. Coordenação e aceite parental não representam uma segunda tentativa da mesma Task.
|
|
22
|
+
- Os nomes de ferramentas no catálogo são capacidades, não nomes literais de ferramentas do host. O orquestrador pode descobrir ferramentas diferidas no registro nativo e usar spawn/send/wait/close dos descendentes autorizados, inclusive com filesystem read-only. Essa permissão não autoriza persistência pelo perfil, chats independentes ou ampliação de sandbox. Declarar indisponibilidade exige conferir o registro efetivamente exposto.
|
|
23
|
+
|
|
24
|
+
- `agent_type` usa o `codex_name` exato. Envie `task_name` somente se o schema da ferramenta nativa o oferecer; nesse caso use o `codex_task_name` exato. Sem esse parâmetro, use o perfil catalogado e preserve o UUID/nickname retornado, inclusive sufixos atribuídos pelo host. Nunca transforme UUID ou nickname em `agent_path` nem use nome como prova de ancestralidade.
|
|
25
|
+
- Orquestrador e Gui com perfil `read-only` não executam comandos que escrevem records, locks ou recibos. Eles retornam eventos e decisão ao host autorizado. O host é o escritor do lifecycle, não um executor/finalizador substituto: não altera a decisão, identidade, pai ou evidências do agente.
|
|
26
|
+
- A ordem canônica é início real, decisão observada de Gui, Stop e fechamento com a mesma decisão. Não imponha ao Gui espera ativa por recibos: ele pode devolver seu resultado terminal; o host usa `subagent capture --event stop` com a decisão real nos campos `task-outcome`, `summary`, `evidence`, `changed-files`, persistindo-a antes do Stop canônico. O relay rico aceita filho já terminal com responsável aberto, sem trocar metadados por fallback. Responsável fechado sem decisão exige nova tentativa autorizada. Não confunda horário observado com gravação, nem status nativo com decisão.
|
|
27
|
+
- O fallback `capture-terminal` continua restrito ao contrato de path, pai e identidade já descrito. UUID com `agent_path: null` não satisfaz esse fallback. Falta de prova rica, conflito de ancestry ou falha do escritor bloqueia a entrega, sem recriar Tasks, inventar metadados, ampliar sandbox ou pedir a um executor que delegue Gui.
|
|
@@ -42,7 +42,7 @@ Every product commit requires causal Task/Change/Execution records and matching
|
|
|
42
42
|
|
|
43
43
|
1. Compose `$zaip-skill-release-qualification` and follow [local preparation](../zaip-skill-release-qualification/references/local-preparation.md). Synchronize and commit before preparing the clean exact SHA. Failed or stale evidence is not qualification.
|
|
44
44
|
2. Resolve the previous Release, next canonical version and package identity using [release identity](references/release-identity.md). For the framework, `vN.N` maps to package `N.N.0`; only GitHub Actions publishes `@zaip-ai/cli` to npm.
|
|
45
|
-
3. For `zaip-ai/zaip-aios`, use `scripts/local-release-deploy.mjs`. It prepares/verifies, pushes the exact SHA to configured `main`, uploads verified assets to a draft, then publishes the Release.
|
|
45
|
+
3. For `zaip-ai/zaip-aios`, use `scripts/local-release-deploy.mjs`. It prepares/verifies, pushes the exact SHA to configured `main`, uploads verified assets to a draft, then publishes the Release. Enable the thin publisher only after explicit rollout authority, public trust enrollment and signed full local qualification. It validates published assets and runs one read-only installation smoke before npm; no private-draft pilot or write token is needed. GitHub Release publication and npm completion remain separate.
|
|
46
46
|
4. Consumers use `scripts/consumer-release-preparation.mjs guarded-push` with their own policy and explicit branch, SHA and trusted receipt. They have no framework npm/TGZ requirement. See the preparation guide for bootstrap and guarded commands.
|
|
47
47
|
5. Immediately before delivery, reread the configured target; if changed, restart preparation. Helpers bind the exact candidate to `HEAD:refs/heads/<configured branch>` (or its equivalent immutable-SHA refspec); do not bypass them with a manual push.
|
|
48
48
|
6. After qualification, a missing Release is normal. Unless explicitly push-only, automatically create the draft for that SHA or resume a verified draft for the same SHA. Verify an already-published exact Release as a no-op; an API/authentication error never proves absence. Refuse conflicting tags/assets without overwrite.
|
|
@@ -50,14 +50,13 @@ Every product commit requires causal Task/Change/Execution records and matching
|
|
|
50
50
|
|
|
51
51
|
## Proportional validation
|
|
52
52
|
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
GitHub queue, installation and publication timings are reported separately.
|
|
53
|
+
Guarded local framework delivery requires a valid `full-v2` receipt with the mandatory full gate.
|
|
54
|
+
Without explicit thin-path activation, the default GitHub publisher separately requires the legacy workflow's
|
|
55
|
+
exact-candidate qualification receipt after its full gate and TGZ matrix.
|
|
56
|
+
Rapid impact checks have no test-count ceiling and cannot substitute for release evidence.
|
|
57
|
+
Use the budgets and failure rules in [local preparation](../zaip-skill-release-qualification/references/local-preparation.md).
|
|
58
|
+
Consumer projects retain their own reviewed policy commands. Report qualification and
|
|
59
|
+
publication separately; neither preparation nor this policy grants publication authority.
|
|
61
60
|
|
|
62
61
|
## Verify and close
|
|
63
62
|
|
|
@@ -70,12 +70,16 @@ Run preflight once at the start of the authorized deployment. Classify a failure
|
|
|
70
70
|
|
|
71
71
|
## Validation budget
|
|
72
72
|
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
73
|
+
Guarded local framework preparation requires `full-v2` and its mandatory full gate.
|
|
74
|
+
The default legacy GitHub publisher accepts its separate exact-candidate qualification
|
|
75
|
+
receipt only after the remote full gate and TGZ matrix. Explicit administrator activation after signed full local qualification switches the
|
|
76
|
+
publisher to the verified local receipt. One read-only install smoke then gates npm;
|
|
77
|
+
no private-draft pilot is required. Activation is never implicit.
|
|
78
|
+
Follow [local preparation](../../zaip-skill-release-qualification/references/local-preparation.md)
|
|
79
|
+
for exact-candidate evidence, deadlines and rapid-preparation limits. Impact selection has
|
|
80
|
+
no test-count ceiling; rapid results are not release receipts. Preserve consumer policy
|
|
81
|
+
boundaries and reuse only valid matching evidence. On timeout, terminate the command tree,
|
|
82
|
+
retain the failed gate and repair its evidenced cause; never omit gates to obtain success.
|
|
79
83
|
|
|
80
84
|
## Review and validate
|
|
81
85
|
|
|
@@ -35,6 +35,8 @@ Use apenas comandos canônicos ZAIP. Não edite status diretamente no frontmatte
|
|
|
35
35
|
|
|
36
36
|
## Verificar
|
|
37
37
|
|
|
38
|
+
Na continuação de um PRD preparado, reutilize a Execution de `plan_ref`/PreparedPlan. Para `blocked` ou `paused`, inspecione a causa e use a retomada canônica autorizada antes da captura; não repita `prd execute` contra um macro já materializado. `conversation start --intent continue --prd ID --execution EXEC` deve resolver a mesma Execution e fase `execution`, rejeitando divergências antes de escrever. Para colaboração nativa Codex, siga a seção de DAG nativa da skill de execução; `native-next` prepara envelopes e não substitui o spawn/capture observado nem os gates de entrega.
|
|
39
|
+
|
|
38
40
|
1. Leia novamente o PRD e liste SPECs com `spec list --prd <PRD-ID> --json`.
|
|
39
41
|
2. Após `prepare`, confirme que PRD e SPECs continuam `draft`; após `ready`, confirme que apenas as selecionadas ficaram `ready` e que Execution, Changes e Tasks permanecem `planned`.
|
|
40
42
|
3. Confirme no resultado do cancelamento os arrays `cascade.specs`, `cascade.tasks`, `cascade.changes` e `cascade.executions`.
|
|
@@ -50,6 +50,8 @@ Durante essa etapa, a Execution universal `interaction` e sua Run raiz continuam
|
|
|
50
50
|
|
|
51
51
|
## Handoff e analyze
|
|
52
52
|
|
|
53
|
+
Ao receber “execute esse PRD” em outro turno, reutilize o ID canônico e delegue à skill de execução a captura inicial como continuação desse PRD. Não repita o intake `conversation --definition prd,spec` da autoria anterior e não recrie o pacote. Se o documento citado existir apenas como rascunho local, informe essa diferença: a existência de um arquivo de planejamento não comprova PRD canônico nem Run de delivery.
|
|
54
|
+
|
|
53
55
|
1. Pare em Definição após `prepare`. Somente após pedido explícito de promoção, use `$zaip-skill-move-prd`: `prd ready` deixa PRD/SPECs selecionadas em `ready` e materializa a DAG sem executá-la; cada Task materializada `planned` e nunca iniciada aparece em Pronto para Executar, mesmo vinculada a SPEC. Somente após pedido explícito de execução, delegue a persistência da continuação, ativação e orquestração para `$zaip-skill-execution`.
|
|
54
56
|
2. Na análise, mostre visão macro por PRD: SPECs, Tasks, Executions, Runs, outcomes, AC/evidência, retrabalho, tokens e custo por fase/total.
|
|
55
57
|
|
|
@@ -16,8 +16,8 @@ Consumer projects run their own policy commands through the distributed consumer
|
|
|
16
16
|
their configured branch (default `beta`) and no framework npm requirements.
|
|
17
17
|
The deployment skill must call the guarded helper, which prepares and verifies before sending.
|
|
18
18
|
A changed candidate or invalid evidence requires new qualification.
|
|
19
|
-
|
|
20
|
-
|
|
19
|
+
Full source qualification runs locally. Extended GitHub qualification is manual;
|
|
20
|
+
the reduced publisher requires enrolled public trust and signed full local qualification.
|
|
21
21
|
|
|
22
22
|
The only public npm package is `@zaip-ai/cli`; the installation entry point is
|
|
23
23
|
`npx @zaip-ai/cli@latest init`. Verify that release automation, manifests, and
|
|
@@ -25,27 +25,25 @@ registry checks target only this package before qualifying the next publication.
|
|
|
25
25
|
|
|
26
26
|
## Proportional validation
|
|
27
27
|
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
## Guarded local
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
activation additionally requires successful remote qualification of the same candidate and
|
|
48
|
-
administrator enrollment of the trusted public key and policy. Never upload a private key.
|
|
28
|
+
Local framework preparation receipts require `full-v2`, including the mandatory `pnpm qualify:full`
|
|
29
|
+
gate. The default legacy GitHub path retains its own qualification receipt after the full gate
|
|
30
|
+
and exact-TGZ matrix; it does not use the local receipt format. Neither path accepts rapid-only
|
|
31
|
+
evidence. A rapid check is diagnostic preparation, not release certification. Select rapid tests
|
|
32
|
+
by impact without a count ceiling; a deadline must fail visibly, never truncate coverage.
|
|
33
|
+
Follow [local preparation](references/local-preparation.md) for budgets, exact-candidate
|
|
34
|
+
evidence and cache validity. A failed or timed-out gate emits no success receipt.
|
|
35
|
+
Report local qualification, runtime matrix, GitHub and publication outcomes separately.
|
|
36
|
+
|
|
37
|
+
## Guarded local qualification and single remote smoke
|
|
38
|
+
|
|
39
|
+
An administrator explicitly enables `ZAIP_LOCAL_RELEASE_ENABLED=true` after full local
|
|
40
|
+
qualification and public trust enrollment. The guarded helper publishes the exact signed
|
|
41
|
+
GitHub Release assets. The read-only verifier validates receipt, policy, SHA and TGZ,
|
|
42
|
+
then runs one Linux installation/doctor smoke before the isolated npm job receives
|
|
43
|
+
publication credentials. No private-draft pilot or contents-write token is required.
|
|
44
|
+
The publisher reverifies artifacts and registry integrity; additional registry installation
|
|
45
|
+
is opt-in manual `extended_verification=true`. Missing proof never falls back to publishing.
|
|
46
|
+
A published GitHub Release alone does not prove npm delivery. Never upload a private key.
|
|
49
47
|
|
|
50
48
|
1. Identify the exact candidate revision, version, and intended distribution surface.
|
|
51
49
|
Do not substitute current working-tree checks for candidate evidence.
|
package/templates/.agents/skills/zaip-skill-release-qualification/references/local-preparation.md
CHANGED
|
@@ -19,13 +19,22 @@ node scripts/local-release-preparation.mjs prepare --repository <absolute-reposi
|
|
|
19
19
|
The framework policy is an administrator-reviewed file whose bytes must match the protected
|
|
20
20
|
GitHub policy. Gates are fixed in the versioned helper, not supplied by the caller. Preparation
|
|
21
21
|
fails at the first failed gate. It validates source size before dependency installation; then runs
|
|
22
|
-
the `
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
cleanroom/rollback and Dashboard E2E
|
|
27
|
-
|
|
28
|
-
|
|
22
|
+
the `full-v2` profile: static integrity checks, dependency audit, package validation,
|
|
23
|
+
mandatory `pnpm qualify:full` and exact-TGZ consumer identity. Preparation commands share
|
|
24
|
+
a 60-minute deadline, with process-tree termination and cleanup after expiry. A failure
|
|
25
|
+
never produces a successful receipt. Full qualification includes coverage, skill tests,
|
|
26
|
+
cleanroom/rollback and Dashboard E2E; these gates are not optional for a release receipt.
|
|
27
|
+
Former rapid-only receipts are invalid for this policy and require requalification.
|
|
28
|
+
Successful preparation emits receipt, manifest, SBOM and TGZ.
|
|
29
|
+
|
|
30
|
+
The separate rapid preparation helper has an eight-minute deadline and emits no signed
|
|
31
|
+
release receipt; manual extended CI follows it with the mandatory full gate. `test:rapid` selects tests by
|
|
32
|
+
impact, including critical baseline and affected consumers, without a count ceiling. Its
|
|
33
|
+
90-second deadline fails closed instead of silently dropping selected tests. An unmapped
|
|
34
|
+
change expands selection to the inventory. Neither rapid path proves full qualification.
|
|
35
|
+
Retain Windows/Linux Node 22.16.0 and 24.x matrix outcomes against the same exact TGZ,
|
|
36
|
+
recording the actual Node patch version and digest. A configured matrix is not proof that
|
|
37
|
+
its jobs ran; unavailable runtime execution remains unverified, never passed.
|
|
29
38
|
Reuse an existing output directory only with its complete valid signed candidate; an invalid cache
|
|
30
39
|
is refused. Choose a new output path after repair instead of deleting or overwriting evidence.
|
|
31
40
|
|
|
@@ -75,11 +84,23 @@ After successful guarded push, create the consumer GitHub Release according to
|
|
|
75
84
|
[release identity](../../zaip-skill-github-deploy/references/release-identity.md), attached to that
|
|
76
85
|
verified SHA. This flow does not require a TGZ, npm version, npm channel or npm credentials.
|
|
77
86
|
|
|
78
|
-
## Activate the reduced GitHub path
|
|
87
|
+
## Activate the reduced GitHub path
|
|
79
88
|
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
89
|
+
After explicit rollout authority, complete signed full-v2 local preparation and enroll
|
|
90
|
+
only the reviewed public key, exact policy and key ID. Then explicitly enable
|
|
91
|
+
`ZAIP_LOCAL_RELEASE_ENABLED=true` and use guarded delivery. The GitHub Release is published
|
|
92
|
+
with its four signed assets before Actions validates them; the verifier needs only
|
|
93
|
+
contents-read access. One Linux TGZ installation/doctor smoke gates npm publication.
|
|
94
|
+
No private-draft pilot or write-token escalation is required. If the smoke fails, npm
|
|
95
|
+
remains unpublished; retain the failure and distinguish it from GitHub Release creation.
|
|
96
|
+
An extra registry installation is available only with manual `extended_verification=true`.
|
|
97
|
+
The registry digest and channel are always verified by the isolated publisher.
|
|
98
|
+
|
|
99
|
+
The default legacy publisher validates `qualification-receipt.json` from the successful
|
|
100
|
+
GitHub qualification run, bound to candidate SHA, run/attempt, channel and exact TGZ. That
|
|
101
|
+
workflow requires the full gate and runtime matrix before issuing its receipt. This is a
|
|
102
|
+
separate accepted remote policy, not a `full-v2` local receipt or a rapid-only exemption.
|
|
103
|
+
The guarded local helper still requires `full-v2` even while legacy remote checks are enabled.
|
|
83
104
|
|
|
84
105
|
An administrator enrolls the public key, exact policy bytes and key ID in protected repository
|
|
85
106
|
variables `ZAIP_LOCAL_RELEASE_TRUSTED_PUBLIC_KEY_B64`, `ZAIP_LOCAL_RELEASE_POLICY_B64` and
|
|
@@ -89,8 +110,11 @@ Protect edits to workflow, trust configuration and publishing environment. A sig
|
|
|
89
110
|
that a trusted key endorsed the candidate; it does not make a compromised workstation trustworthy.
|
|
90
111
|
|
|
91
112
|
Enabled GitHub publication verifies the signed assets and exact SHA, performs a Linux TGZ smoke,
|
|
92
|
-
reverifies before OIDC publication, checks registry bytes and runs an
|
|
93
|
-
|
|
113
|
+
reverifies before OIDC publication, checks registry bytes and optionally runs an explicit manual registry installation.
|
|
114
|
+
Source/commit checks are manual-only in GitHub; they remain required locally.
|
|
115
|
+
Extended qualification remains available through manual `qualify-cli.yml` dispatch, including
|
|
116
|
+
the full source suite and Windows/Linux runtime matrix; it no longer runs on every push.
|
|
117
|
+
Reverting the flag requires manually qualifying the exact candidate through that legacy path.
|
|
94
118
|
Missing/invalid evidence blocks publication; it never falls back to an unchecked publish.
|
|
95
119
|
|
|
96
120
|
Measure preparation, push and Actions publication separately. Cache reuse can shorten repeat
|
|
@@ -5,6 +5,8 @@ description: Install ZAIP-AIOS and its authorized prerequisites in a new workspa
|
|
|
5
5
|
|
|
6
6
|
# Instalar ZAIP-AIOS
|
|
7
7
|
|
|
8
|
+
Aplique a proteção do computador local de `RULE-CORE`: nunca reinicie/desligue o PC. Antes de executar instaladores, confirme opções documentadas que suprimam reinício automático; não use `--allow-reboot`. Se a supressão não puder ser garantida, pare essa etapa. Informe reinício pendente para ação manual do usuário.
|
|
9
|
+
|
|
8
10
|
Para Supabase, a instalação nunca cria branch, preview ou custo hospedado. O fluxo protegido de migrations exige uma branch beta persistente e GitHub Integration verificada; explique o custo antes de qualquer provisionamento e registre confirmação informada na configuração. Sem beta, prepare localmente e pare: migrations nunca seguem para `main`. Somente uma recusa explícita da beta permite o modo manual: uma pessoa executa SQL exportado no SQL Editor; agente, pipeline e startup nunca o aplicam.
|
|
9
11
|
|
|
10
12
|
Use somente o pacote público `@zaip-ai/cli`: `npx @zaip-ai/cli@latest init`.
|
|
@@ -5,6 +5,8 @@ description: Discover, install, configure, authenticate, enable, disable, and di
|
|
|
5
5
|
|
|
6
6
|
# Configurar tools ZAIP
|
|
7
7
|
|
|
8
|
+
Aplique a proteção do computador local de `RULE-CORE`: nunca reinicie/desligue o PC, inclusive por instaladores ou scripts de configuração. Suprima reinício automático com opções documentadas ou pare a etapa. Reiniciar/reabrir o Codex refere-se somente ao aplicativo; reinício do Windows fica a cargo do usuário.
|
|
9
|
+
|
|
8
10
|
1. Leia `.agents/tools/catalog.yaml` e somente o manifesto da tool solicitada.
|
|
9
11
|
2. Execute `scripts/inspect-tool.mjs <id> [mcp|api]` para produzir um plano sem segredos.
|
|
10
12
|
3. Confirme que a implementacao ou URL MCP e oficial, verificavel ou mantida pelo ZAIP; nunca invente pacote.
|
|
@@ -29,7 +29,7 @@ introduzidos em releases mais novas.
|
|
|
29
29
|
| Consultar instalação detalhada | [20 — Instalação detalhada](guides/20-instalacao-detalhada.md) |
|
|
30
30
|
| Consultar telemetria do Monitor | [21 — Telemetria do Monitor de Custos](guides/21-telemetria-monitor-custos.md) |
|
|
31
31
|
| Entender fluxos e roteamento | [22 — Fluxos e roteamento](guides/22-fluxos-e-roteamento.md) |
|
|
32
|
-
|
|
|
32
|
+
| Entender modelos, delegação e escalada por preset | [23 — Orquestração de modelos](guides/23-orquestracao-de-modelos.md) |
|
|
33
33
|
| Entender cálculo e fontes de custo | [24 — Cálculo](guides/24-calculo-de-custos-openai.md) e [25 — Fontes](guides/25-fontes-de-precos-openai.md) |
|
|
34
34
|
| Consultar qualidade e release | [26 — Qualidade e release](guides/26-qualidade-e-release.md) |
|
|
35
35
|
| Entender a telemetria Git-native | [27 — Telemetria Git-native](guides/27-telemetria-git-native.md) |
|
|
@@ -60,3 +60,11 @@ introduzidos em releases mais novas.
|
|
|
60
60
|
Guias são documentação, não certificado de release nem autorização para
|
|
61
61
|
deploy, reabrir trabalho bloqueado, alterar permissões ou executar exemplos
|
|
62
62
|
destrutivos. Relatórios históricos preservam o candidato e a data observados.
|
|
63
|
+
|
|
64
|
+
## Ler as novidades da v3
|
|
65
|
+
|
|
66
|
+
Comece por [19 — Perfis de autonomia](guides/19-assurance-e-autonomia.md):
|
|
67
|
+
4/1, 10/3 e ilimitado; depois [23 — Modelos](guides/23-orquestracao-de-modelos.md)
|
|
68
|
+
e [16 — Fechamento](guides/16-lifecycle-e-reconciliacao.md).
|
|
69
|
+
Perfil de instalação, assurance e autonomia são configurações distintas.
|
|
70
|
+
As fontes em qualificação não comprovam disponibilidade no npm nem produção.
|
|
@@ -40,8 +40,10 @@ presença de uma instrução ou screenshot não comprova execução naquele ambi
|
|
|
40
40
|
- Use o guia 16 para entender status, reconciliacao e a ordem de finalizacao.
|
|
41
41
|
- Use os guias 17 e 24 a 25 para interpretar tokens, precificacao e conversao de moeda.
|
|
42
42
|
- Use o [guia 08](guides/08-contexto-e-tokens.md) para consultas com contexto enxuto e
|
|
43
|
-
o [guia 23](guides/23-orquestracao-de-modelos.md) para
|
|
44
|
-
|
|
43
|
+
o [guia 23](guides/23-orquestracao-de-modelos.md) para modelos, seleção manual do principal e escaladas governadas pelo preset.
|
|
44
|
+
- Use o [guia 19](guides/19-assurance-e-autonomia.md) para Essencial (4/1),
|
|
45
|
+
Equilibrado (10/3) e Persistente ilimitado: execuções/replanejamentos por Task,
|
|
46
|
+
configuração no YAML/Dashboard e limites atuais do despacho gerenciado.
|
|
45
47
|
- Use os guias 18 a 28 quando precisar do contrato completo de agentes, lifecycle, telemetria, qualidade, instalacao ou roteamento.
|
|
46
48
|
|
|
47
49
|
O instalador npm projeta esta pasta da `.agents` canonica para o tarball e a
|
|
@@ -51,9 +53,28 @@ Os manuais completos em português e inglês são instalados como
|
|
|
51
53
|
`.agents/README.md` e `.agents/README-ENG.md`; os READMEs da raiz do consumidor
|
|
52
54
|
permanecem sob sua autoria.
|
|
53
55
|
|
|
56
|
+
A Ajuda do Dashboard incorpora estes arquivos no build. Em inglês, carrega o
|
|
57
|
+
README inglês canônico; os 28 guias atualmente têm fonte em português e são
|
|
58
|
+
apresentados com aviso de idioma, sem traduções resumidas paralelas obsoletas.
|
|
59
|
+
|
|
54
60
|
Para concluir trabalho, use [revisão e validação](guides/07-revisao-e-validacao.md)
|
|
55
61
|
e o [contrato de prova observável](../skills/zaip-skill-change/references/observable-evidence.md).
|
|
56
62
|
Registros estruturados validam vínculos, não substituem o exame do resultado.
|
|
57
63
|
Consulte [qualidade e release](guides/26-qualidade-e-release.md) para distinguir
|
|
58
64
|
checks locais, CI e aprovação de produção. Documentação não autoriza publicação
|
|
59
65
|
nem reabertura de entregas históricas bloqueadas.
|
|
66
|
+
|
|
67
|
+
## Novidades em preparação para v3
|
|
68
|
+
|
|
69
|
+
A documentação descreve `autonomy-v1` sem declarar release publicada.
|
|
70
|
+
Os manifests deste checkout identificam o candidato `3.0.0`. Novos templates usam
|
|
71
|
+
Equilibrado e `execution.runtime: managed`: PRDs/SPECs gerenciados e tarefas
|
|
72
|
+
avulsas preferencialmente diretas. Configurações legadas sem essa opção mantêm
|
|
73
|
+
o default manual do schema; salvar configuração não inicia execução.
|
|
74
|
+
Não há desistência por duração nem diminuição automática de ACs.
|
|
75
|
+
Gui finaliza a tentativa da Task como último filho direto, não cada trabalhador.
|
|
76
|
+
|
|
77
|
+
O controle determinístico exige despacho gerenciado; chamadas nativas externas
|
|
78
|
+
não recebem essa garantia por instrução. Tasks legadas não são migradas
|
|
79
|
+
silenciosamente. O guia 19 descreve a autorização imutável da raiz Task direta;
|
|
80
|
+
ela dispensa executor fictício, mas preserva revisão, Evidence e Gui.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
|
|
1
|
+
3.0
|
|
@@ -5,8 +5,12 @@
|
|
|
5
5
|
3. Classifique a entrada: Conversation, Task avulsa, SPEC ou PRD. Pergunta/análise read-only é Conversation e não cria Task.
|
|
6
6
|
4. Carregue somente Rules, Requirements e skills aplicaveis.
|
|
7
7
|
5. Defina aceite verificavel antes de editar.
|
|
8
|
-
6. Antes de escrita persistente, inicie Task, Change, Execution e Run raiz do orquestrador;
|
|
8
|
+
6. Antes de escrita persistente, inicie Task, Change, Execution e Run raiz do orquestrador; priorize trabalho direto na avulsa, delegue apenas quando necessário e respeite os gates de fechamento vigentes; teste e registre evidências no ciclo ativo.
|
|
9
9
|
|
|
10
10
|
Evite varrer `.agents/records/`: abra um record apenas quando possuir seu ID.
|
|
11
11
|
|
|
12
12
|
Para PRD/SPEC, diferencie conversa de criação: “me ajude a pensar” não cria artefato; “crie” persiste o pacote `draft` completo e sua telemetria. Faça até cinco perguntas críticas por turno, no máximo três turnos; depois registre decisões delegáveis da IA. Tasks reais só nascem em `ready|execute`.
|
|
13
|
+
|
|
14
|
+
Para os novos controles, leia [perfis de autonomia](19-assurance-e-autonomia.md)
|
|
15
|
+
e [modelos](23-orquestracao-de-modelos.md): perfil não ativa provider nem migra
|
|
16
|
+
Tasks legadas. O principal avulso mantém sua seleção; filhos seguem política divulgada.
|
|
@@ -7,7 +7,7 @@ Use Task para uma entrega pequena, independente e com um resultado claro.
|
|
|
7
7
|
3. Vincule Requirements aplicaveis.
|
|
8
8
|
4. Liste arquivos ou componentes provaveis, sem congelar a solucao.
|
|
9
9
|
5. Defina verificacoes proporcionais ao risco.
|
|
10
|
-
6. Use
|
|
10
|
+
6. Use um orquestrador responsável por tentativa; se delegado pelo macro, sua Run conserva o pai real. Finalize os Sub-Runs de trabalho e execute Gui como último filho direto desse responsável.
|
|
11
11
|
7. Antes de a Run terminar, mova a Task para completed, blocked, failed ou cancelled; nunca deixe executing/verifying.
|
|
12
12
|
8. Retome blocked com `task resume`; trate failed com `task rework` na mesma Task. Completed/cancelled sao imutaveis.
|
|
13
13
|
|
|
@@ -15,4 +15,17 @@ Em PRD/SPEC `draft`, a lista visível vem dos blueprints do PreparedPlan e não
|
|
|
15
15
|
|
|
16
16
|
## Modelo, effort e velocidade
|
|
17
17
|
|
|
18
|
-
Conversation e
|
|
18
|
+
Conversation e o principal de Task avulsa preservam a seleção manual do Codex e
|
|
19
|
+
preferem execução direta. Se subagentes forem necessários, informe que modelo e
|
|
20
|
+
esforço podem diferir conforme catálogo/preset ZAIP. A exceção de Astra manual
|
|
21
|
+
no Essencial só vale para o principal avulso. A seleção automática solicita
|
|
22
|
+
velocidade `standard`; Fast manual não é herdado pelo fluxo gerenciado.
|
|
23
|
+
|
|
24
|
+
## Orçamento e retomada
|
|
25
|
+
|
|
26
|
+
[Autonomia](19-assurance-e-autonomia.md) é por Task estável: Essencial 4/1,
|
|
27
|
+
Equilibrado 10/3, Persistente ilimitado (execuções/replanejamentos).
|
|
28
|
+
Reiniciar, retomar ou mudar o YAML não zera a quota. `attempt_count` do lifecycle
|
|
29
|
+
e reservas de execução do diário não são o mesmo contador.
|
|
30
|
+
Falta de prova termina `blocked`; erro técnico impeditivo comprovado termina
|
|
31
|
+
`failed`. Não diminua ACs nem use duração como critério de desistência.
|
|
@@ -18,3 +18,16 @@ Uma SPEC planeja a entrega; nao autoriza mudancas externas por si so.
|
|
|
18
18
|
Use uma SPEC por padrão. Separe outra somente quando as capacidades puderem ser implementadas e verificadas em paralelo contra contratos estáveis, sem dependência ou write scope conflitante. Dependências e ordem ficam na DAG de Tasks da mesma SPEC.
|
|
19
19
|
|
|
20
20
|
Toda Execution originada por SPEC usa velocidade `standard` em suas Tasks, Runs e Sub-Runs. A seleção manual de Fast no Codex não substitui essa política. Se uma necessidade urgente for realmente pequena e independente da DAG e dos gates parentais, ela pode ser tratada como Task-first com velocidade manual; não fragmente uma SPEC artificialmente apenas para executar mais rápido.
|
|
21
|
+
|
|
22
|
+
## Autonomia e continuidade da DAG
|
|
23
|
+
|
|
24
|
+
O [preset](19-assurance-e-autonomia.md) é aplicado por Task, não como teto
|
|
25
|
+
compartilhado do macro. Dez Tasks Equilibradas permitem até 100 execuções
|
|
26
|
+
(10 iniciais + 90 reparações) e 30 replanejamentos, sem prazo de abandono.
|
|
27
|
+
Use um orquestrador responsável por tentativa de Task e Gui como seu último
|
|
28
|
+
filho direto. Gates parentais continuam separados.
|
|
29
|
+
|
|
30
|
+
Se um nó ficar bloqueado/falhado, continue somente ramos independentes
|
|
31
|
+
elegíveis; não repita nós concluídos nem libere dependentes sem conclusão.
|
|
32
|
+
A política gerenciada não intercepta chamadas nativas externas do Codex.
|
|
33
|
+
Não ative outra forma de execução nem migre estados legados implicitamente.
|