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