@zaip-ai/cli 3.0.0 → 3.2.0

package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-canonical.ts

@@ -1,6 +1,7 @@
 import {
   consolidatedValue,
   frontMatterRecord,
+  isCanonicalLifecyclePath,
   recordValue,
   stringValue,
   stringValues,
@@ -23,6 +24,9 @@ import {
   type PricingCatalog,
 } from "@zaip-ai/costs";
 import type { RunV2Fold, UsageRecordedV2 } from "../../../../../packages/decisions/src/index.js";
+import { saoPauloDay } from "./sqlite-calendar.js";
+
+export { saoPauloDay } from "./sqlite-calendar.js";
 
 const MAX_RECONCILED_RUN_INTERVAL_MS = 2 * 3_600_000;
 
@@ -112,6 +116,7 @@ export function readCanonicalLifecycleRecords(rows: Array<{ path: string; conten
   const changes: CanonicalChange[] = [];
   const decisions: CanonicalDecision[] = [];
   for (const row of rows) {
+    if (!isCanonicalLifecyclePath(row.path)) continue;
     const metadata = frontMatterRecord(row.content);
     if (metadata === null) continue;
     const id = stringValue(metadata.id);
@@ -689,21 +694,6 @@ export function usagePricingAudit(
   };
 }
 
-export function saoPauloDay(timestamp: string): string {
-  const values = Object.fromEntries(
-    new Intl.DateTimeFormat("en", {
-      timeZone: "America/Sao_Paulo",
-      year: "numeric",
-      month: "2-digit",
-      day: "2-digit",
-    })
-      .formatToParts(new Date(timestamp))
-      .filter((part) => part.type !== "literal")
-      .map((part) => [part.type, part.value]),
-  ) as { year: string; month: string; day: string };
-  return `${values.year}-${values.month}-${values.day}`;
-}
-
 export type TemporalInterval = { activityRowId: string; startMs: number; endMs: number };
 
 /**

package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-keeps-orphan-telemetry-out-kanban-without.test.ts

@@ -210,7 +210,7 @@ describe("SQLite dashboard read model", () => {
         snapshot
           .prepare("SELECT value FROM zaip_vw_read_model_metadata WHERE key='schema_version'")
           .get(),
-      ).toEqual({ value: "78" });
+      ).toEqual({ value: "79" });
     } finally {
       snapshot.close();
     }

package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-rebuild.ts

@@ -17,6 +17,7 @@ import {
   saoPauloDay,
   type TemporalInterval,
 } from "./sqlite-read-model-canonical.js";
+import { isCanonicalLifecyclePath } from "./sqlite-read-model-canonical-parsing.js";
 import { reportSqliteReadModelLaunchProgress } from "./sqlite-read-model-launch-progress.js";
 import {
   hasReusableSnapshotPayloads,
@@ -628,6 +629,7 @@ export async function rebuildSqliteReadModel(
         decisions: [] as CanonicalDecision[],
       };
       for (const row of canonicalRows) {
+        if (!isCanonicalLifecyclePath(row.path)) continue;
         const parsed = parsedSources.read("lifecycle", row.path, sourceHashFor(row.path), () =>
           readCanonicalLifecycleRecords([row]),
         );

package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-schema.ts

@@ -4,9 +4,9 @@ import { DatabaseSync } from "node:sqlite";
 import { hasRequiredFirstFoldPayloads } from "./sqlite-first-fold-persistence.js";
 import type { SqliteReadModelSourceCheckpoint } from "./sqlite-read-model-source-fingerprint.js";
 export const dbRelativePath = ".local/sqlite/zaip-aios-dashboard.sqlite";
-// Schema 78 aligns usage-segment providers with canonical activity providers.
+// Schema 79 installs bounded execution/conversation label views and shared daily groups.
 // Old snapshots must rebuild even when their canonical hashes still match.
-export const readModelSchemaVersion = "78";
+export const readModelSchemaVersion = "79";
 export const requiredPersistedTables = [
   "zaip_aios_activities",
   "zaip_dim_llm_model",
@@ -31,6 +31,7 @@ export const requiredIndexes = [
   "zaip_activities_period_invocation",
   "zaip_activities_status",
   "zaip_activities_payload",
+  "zaip_activities_duration_activity",
   "zaip_activities_file_path",
   "zaip_activities_work_item_identity",
   "cost_dimension_facts_day_model",

package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model.test.ts

@@ -177,7 +177,7 @@ describe("SQLite dashboard read model", () => {
         metadata
           .prepare("SELECT value FROM zaip_vw_read_model_metadata WHERE key='schema_version'")
           .get(),
-      ).toEqual({ value: "78" });
+      ).toEqual({ value: "79" });
     } finally {
       metadata.close();
     }

package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-schema-base-views.ts

@@ -16,6 +16,7 @@ export const baseViewSql = `
           WHERE agent_invocation_id IS NOT NULL;
         CREATE INDEX zaip_activities_status ON zaip_aios_activities(activity_source_kind, status, phase);
         CREATE INDEX IF NOT EXISTS zaip_activities_payload ON zaip_aios_activities(payload_type, activity_key);
+        CREATE INDEX zaip_activities_duration_activity ON zaip_aios_activities(CAST(json_extract(payload_json, '$.activity_row_id') AS TEXT)) WHERE payload_type='duration_allocation';
         -- File lookups must not parse every JSON payload (including its full
         -- content) on each read. The file view uses this path-only index for
         -- binary equality and cheap LIKE scans without changing their semantics.
@@ -33,12 +34,13 @@ export const baseViewSql = `
         CREATE VIEW attributed_token_active_facts AS SELECT json_extract(payload_json, '$.activity_row_id') AS activity_row_id, json_extract(payload_json, '$.occurred_day_sp') AS occurred_day_sp, json_extract(payload_json, '$.attributed_token_active_ms') AS attributed_token_active_ms FROM zaip_aios_activities WHERE payload_type='duration_allocation';
         CREATE VIEW canonical_artifacts AS SELECT artifact_kind, artifact_id, artifact_occurred_at AS occurred_at, artifact_occurred_day_sp AS occurred_day_sp, artifact_task_id AS task_id, artifact_change_id AS change_id, artifact_run_id AS run_id, path AS source_path FROM files WHERE artifact_kind IS NOT NULL AND artifact_occurred_at IS NOT NULL;
         CREATE VIEW activities AS
-          SELECT a.*, f.attributed_token_active_ms
+          SELECT a.*, (
+            SELECT SUM(json_extract(f.payload_json, '$.attributed_token_active_ms'))
+            FROM zaip_aios_activities f INDEXED BY zaip_activities_duration_activity
+            WHERE f.payload_type='duration_allocation'
+              AND CAST(json_extract(f.payload_json, '$.activity_row_id') AS TEXT)=a.activity_row_id
+          ) AS attributed_token_active_ms
           FROM zaip_aios_activities a
-          LEFT JOIN (
-            SELECT activity_row_id, SUM(attributed_token_active_ms) AS attributed_token_active_ms
-            FROM attributed_token_active_facts GROUP BY activity_row_id
-          ) f USING(activity_row_id)
           WHERE a.payload_type IS NULL;
         -- Macro-only allocations are persisted as technical payloads to keep
         -- the global Run population unique.  SPEC summaries opt into this
@@ -68,21 +70,27 @@ export const baseViewSql = `
         CREATE VIEW specs AS SELECT id, title, status, risk, occurred_at, occurred_day_sp FROM work_items WHERE entity_kind = 'spec';
         CREATE VIEW prds AS SELECT id, title, status, risk, occurred_at, occurred_day_sp FROM work_items WHERE entity_kind = 'prd';
         CREATE VIEW executions AS
-          SELECT id, status, created_at AS occurred_at, occurred_day_sp FROM canonical_executions
+          WITH projected_executions AS MATERIALIZED (
+            SELECT id, status, created_at, occurred_day_sp FROM canonical_executions
+          )
+          SELECT id, status, created_at AS occurred_at, occurred_day_sp FROM projected_executions
           UNION ALL
           SELECT execution_id, MAX(status), MIN(occurred_at), MIN(occurred_day_sp)
-          FROM activities
-          WHERE execution_id IS NOT NULL
-            AND NOT EXISTS (SELECT 1 FROM canonical_executions c WHERE c.id=activities.execution_id)
+          FROM zaip_aios_activities
+          WHERE payload_type IS NULL AND execution_id IS NOT NULL
+            AND NOT EXISTS (SELECT 1 FROM projected_executions c WHERE c.id=zaip_aios_activities.execution_id)
           GROUP BY execution_id;
         CREATE VIEW conversations AS
+          WITH projected_executions AS MATERIALIZED (
+            SELECT status, created_at, occurred_day_sp, origin_type, origin_id FROM canonical_executions
+          )
           SELECT origin_id AS id, MAX(status) AS status, MIN(created_at) AS occurred_at, MIN(occurred_day_sp) AS occurred_day_sp
-          FROM canonical_executions WHERE origin_type='interaction' AND origin_id IS NOT NULL GROUP BY origin_id
+          FROM projected_executions WHERE origin_type='interaction' AND origin_id IS NOT NULL GROUP BY origin_id
           UNION ALL
           SELECT conversation_id, MAX(status), MIN(occurred_at), MIN(occurred_day_sp)
-          FROM activities
-          WHERE conversation_id IS NOT NULL
-            AND NOT EXISTS (SELECT 1 FROM canonical_executions c WHERE c.origin_type='interaction' AND c.origin_id=activities.conversation_id)
+          FROM zaip_aios_activities
+          WHERE payload_type IS NULL AND conversation_id IS NOT NULL
+            AND NOT EXISTS (SELECT 1 FROM projected_executions c WHERE c.origin_type='interaction' AND c.origin_id=zaip_aios_activities.conversation_id)
           GROUP BY conversation_id;
         CREATE VIEW decisions AS SELECT id, title, origin, scope_type, scope_id, NULL AS status, NULL AS risk, created_at AS occurred_at, occurred_day_sp, source_path FROM canonical_decisions;
         CREATE VIEW changes AS SELECT id, title, status, risk, source_type, source_id, requirement_ids_json, acceptance_ids_json, task_ids_json, result, created_at AS occurred_at, occurred_day_sp, source_path FROM canonical_changes;
@@ -281,7 +289,7 @@ export const baseViewSql = `
         -- SPEC/PRD rows have the same canonical population as the big
         -- numbers.  A macro without direct invocation remains visible with
         -- factual NULL usage/cost/time, never a fabricated zero.
-        CREATE VIEW cost_monitor_group_daily_cache AS SELECT occurred_day_sp AS day, 'execution' AS group_kind, execution_id AS group_value, COUNT(*) AS invocation_count, SUM(llm_call_count) AS llm_call_count, SUM(duration_ms) AS total_duration, SUM(input_tokens) AS total_input_tokens, SUM(cached_input_tokens) AS total_cached_input_tokens, SUM(output_tokens) AS total_output_tokens, SUM(reasoning_tokens) AS total_reasoning_tokens, SUM(total_tokens) AS total_tokens, SUM(cost_usd) AS total_cost_usd, SUM(cost_brl) AS total_cost_brl FROM invocations WHERE execution_id IS NOT NULL GROUP BY occurred_day_sp, execution_id UNION ALL SELECT occurred_day_sp, 'zaip_agent', zaip_agent, COUNT(*), SUM(llm_call_count), SUM(duration_ms), SUM(input_tokens), SUM(cached_input_tokens), SUM(output_tokens), SUM(reasoning_tokens), SUM(total_tokens), SUM(cost_usd), SUM(cost_brl) FROM invocations WHERE zaip_agent IS NOT NULL GROUP BY occurred_day_sp, zaip_agent UNION ALL SELECT occurred_day_sp, 'provider', provider, COUNT(*), SUM(llm_call_count), SUM(duration_ms), SUM(input_tokens), SUM(cached_input_tokens), SUM(output_tokens), SUM(reasoning_tokens), SUM(total_tokens), SUM(cost_usd), SUM(cost_brl) FROM invocations WHERE provider IS NOT NULL GROUP BY occurred_day_sp, provider UNION ALL SELECT occurred_day_sp, 'model', model, COUNT(*), SUM(llm_call_count), SUM(duration_ms), SUM(input_tokens), SUM(cached_input_tokens), SUM(output_tokens), SUM(reasoning_tokens), SUM(total_tokens), SUM(cost_usd), SUM(cost_brl) FROM invocations WHERE model IS NOT NULL GROUP BY occurred_day_sp, model UNION ALL SELECT occurred_day_sp, 'task', task_id, COUNT(*), SUM(llm_call_count), SUM(duration_ms), SUM(input_tokens), SUM(cached_input_tokens), SUM(output_tokens), SUM(reasoning_tokens), SUM(total_tokens), SUM(cost_usd), SUM(cost_brl) FROM invocations WHERE task_id IS NOT NULL GROUP BY occurred_day_sp, task_id UNION ALL SELECT occurred_day_sp, 'spec', spec_id, COUNT(*), SUM(llm_call_count), SUM(duration_ms), SUM(input_tokens), SUM(cached_input_tokens), SUM(output_tokens), SUM(reasoning_tokens), SUM(total_tokens), SUM(cost_usd), SUM(cost_brl) FROM invocations WHERE spec_id IS NOT NULL GROUP BY occurred_day_sp, spec_id UNION ALL SELECT occurred_day_sp, 'prd', prd_id, COUNT(*), SUM(llm_call_count), SUM(duration_ms), SUM(input_tokens), SUM(cached_input_tokens), SUM(output_tokens), SUM(reasoning_tokens), SUM(total_tokens), SUM(cost_usd), SUM(cost_brl) FROM invocations WHERE prd_id IS NOT NULL GROUP BY occurred_day_sp, prd_id UNION ALL SELECT occurred_day_sp, 'conversation', conversation_id, COUNT(*), SUM(llm_call_count), SUM(duration_ms), SUM(input_tokens), SUM(cached_input_tokens), SUM(output_tokens), SUM(reasoning_tokens), SUM(total_tokens), SUM(cost_usd), SUM(cost_brl) FROM invocations WHERE conversation_id IS NOT NULL GROUP BY occurred_day_sp, conversation_id;
+        CREATE VIEW cost_monitor_group_daily_cache AS WITH group_invocations AS MATERIALIZED (SELECT occurred_day_sp, execution_id, zaip_agent, provider, model, task_id, spec_id, prd_id, conversation_id, llm_call_count, duration_ms, input_tokens, cached_input_tokens, output_tokens, reasoning_tokens, total_tokens, cost_usd, cost_brl FROM invocations) SELECT occurred_day_sp AS day, 'execution' AS group_kind, execution_id AS group_value, COUNT(*) AS invocation_count, SUM(llm_call_count) AS llm_call_count, SUM(duration_ms) AS total_duration, SUM(input_tokens) AS total_input_tokens, SUM(cached_input_tokens) AS total_cached_input_tokens, SUM(output_tokens) AS total_output_tokens, SUM(reasoning_tokens) AS total_reasoning_tokens, SUM(total_tokens) AS total_tokens, SUM(cost_usd) AS total_cost_usd, SUM(cost_brl) AS total_cost_brl FROM group_invocations WHERE execution_id IS NOT NULL GROUP BY occurred_day_sp, execution_id UNION ALL SELECT occurred_day_sp, 'zaip_agent', zaip_agent, COUNT(*), SUM(llm_call_count), SUM(duration_ms), SUM(input_tokens), SUM(cached_input_tokens), SUM(output_tokens), SUM(reasoning_tokens), SUM(total_tokens), SUM(cost_usd), SUM(cost_brl) FROM group_invocations WHERE zaip_agent IS NOT NULL GROUP BY occurred_day_sp, zaip_agent UNION ALL SELECT occurred_day_sp, 'provider', provider, COUNT(*), SUM(llm_call_count), SUM(duration_ms), SUM(input_tokens), SUM(cached_input_tokens), SUM(output_tokens), SUM(reasoning_tokens), SUM(total_tokens), SUM(cost_usd), SUM(cost_brl) FROM group_invocations WHERE provider IS NOT NULL GROUP BY occurred_day_sp, provider UNION ALL SELECT occurred_day_sp, 'model', model, COUNT(*), SUM(llm_call_count), SUM(duration_ms), SUM(input_tokens), SUM(cached_input_tokens), SUM(output_tokens), SUM(reasoning_tokens), SUM(total_tokens), SUM(cost_usd), SUM(cost_brl) FROM group_invocations WHERE model IS NOT NULL GROUP BY occurred_day_sp, model UNION ALL SELECT occurred_day_sp, 'task', task_id, COUNT(*), SUM(llm_call_count), SUM(duration_ms), SUM(input_tokens), SUM(cached_input_tokens), SUM(output_tokens), SUM(reasoning_tokens), SUM(total_tokens), SUM(cost_usd), SUM(cost_brl) FROM group_invocations WHERE task_id IS NOT NULL GROUP BY occurred_day_sp, task_id UNION ALL SELECT occurred_day_sp, 'spec', spec_id, COUNT(*), SUM(llm_call_count), SUM(duration_ms), SUM(input_tokens), SUM(cached_input_tokens), SUM(output_tokens), SUM(reasoning_tokens), SUM(total_tokens), SUM(cost_usd), SUM(cost_brl) FROM group_invocations WHERE spec_id IS NOT NULL GROUP BY occurred_day_sp, spec_id UNION ALL SELECT occurred_day_sp, 'prd', prd_id, COUNT(*), SUM(llm_call_count), SUM(duration_ms), SUM(input_tokens), SUM(cached_input_tokens), SUM(output_tokens), SUM(reasoning_tokens), SUM(total_tokens), SUM(cost_usd), SUM(cost_brl) FROM group_invocations WHERE prd_id IS NOT NULL GROUP BY occurred_day_sp, prd_id UNION ALL SELECT occurred_day_sp, 'conversation', conversation_id, COUNT(*), SUM(llm_call_count), SUM(duration_ms), SUM(input_tokens), SUM(cached_input_tokens), SUM(output_tokens), SUM(reasoning_tokens), SUM(total_tokens), SUM(cost_usd), SUM(cost_brl) FROM group_invocations WHERE conversation_id IS NOT NULL GROUP BY occurred_day_sp, conversation_id;
         CREATE VIEW daily_aggregates AS SELECT * FROM daily_aggregate_cache;
         CREATE VIEW overview AS
           SELECT 'day' AS period_kind, day AS period_key, day AS start_day, day AS end_day, prd_count, spec_count, task_count, validation_count, evidence_count, activity_count, root_run_count, sub_run_count, total_run_count, invocation_count, cost_monitor_invocation_count, llm_call_count, source_event_count, total_root_run_duration, total_sub_run_duration, operations_total_duration, cost_monitor_total_duration, total_duration, total_tokens, total_cost_usd, total_cost_brl FROM daily_aggregates

package/templates/.agents/dashboard/packages/ui/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zaip-ai/dashboard-ui",
-  "version": "3.0.0",
+  "version": "3.2.0",
   "private": true,
   "type": "module",
   "exports": {

package/templates/.agents/dashboard/tests/e2e/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zaip-ai/dashboard-e2e",
-  "version": "3.0.0",
+  "version": "3.2.0",
   "private": true,
   "type": "module",
   "scripts": {

package/templates/.agents/design/.zaip-managed.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "version": "3.0.0",
+  "version": "3.2.0",
   "files": [
     {
       "path": "DESIGN.md",
@@ -252,7 +252,7 @@
     },
     {
       "path": "apps/catalog/package.json",
-      "sha256": "f7691218b679609a07adc311a1ab5861aee4e636a848985a4590f13a0c13008f"
+      "sha256": "c8c66a38b06ffe5aaa0fd27130559ca442ad5757c78f44910f5fa2641d39630a"
     },
     {
       "path": "apps/catalog/public/logo_novo_azul.png",
@@ -352,7 +352,7 @@
     },
     {
       "path": "packages/local-runtime/package.json",
-      "sha256": "39f18ddf46b11fc8894c3200673a65076c573c63305d990c2fbd192cd98db91c"
+      "sha256": "4dd9befa5e8a2bbda75a2db1e705e690b5c5150c6df028ee1d9a1dde74f88f89"
     },
     {
       "path": "packages/local-runtime/runtime.mjs",

package/templates/.agents/design/apps/catalog/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zaip-ai/design-catalog",
-  "version": "3.0.0",
+  "version": "3.2.0",
   "private": true,
   "type": "module",
   "scripts": {

package/templates/.agents/design/packages/local-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zaip-ai/design-local-runtime",
-  "version": "3.0.0",
+  "version": "3.2.0",
   "private": true,
   "type": "module",
   "scripts": {

package/templates/.agents/requirements/autonomous-assurance.md

@@ -6,7 +6,7 @@ title: Garantia adaptativa e execução autônoma
 status: active
 version: 3
 source_change: null
-source_release: "3.0.0"
+source_release: "3.2.0"
 ---
 
 # Garantia adaptativa e execução autônoma

package/templates/.agents/requirements/cloud-hostinger-autonomy.md

@@ -6,7 +6,7 @@ title: Autonomia delimitada para Cloudflare e Hostinger
 status: proposed
 version: 1
 source_change: null
-source_release: "3.0.0"
+source_release: "3.2.0"
 ---
 
 # Cloudflare e Hostinger (proposta de requisito)

package/templates/.agents/requirements/comparative-audit.md

@@ -6,7 +6,7 @@ title: Auditoria comparativa e plano de evolução
 status: active
 version: 1
 source_change: null
-source_release: "3.0.0"
+source_release: "3.2.0"
 ---
 
 # Auditoria comparativa e plano de evolução

package/templates/.agents/requirements/context-engine.md

@@ -6,7 +6,7 @@ title: Contexto mínimo, seguro e navegável
 status: active
 version: 8
 source_change: null
-source_release: "3.0.0"
+source_release: "3.2.0"
 ---
 
 # Context engine

package/templates/.agents/requirements/cost-observability.md

@@ -6,7 +6,7 @@ title: Tokens, custos e cobertura
 status: active
 version: 10
 source_change: null
-source_release: "3.0.0"
+source_release: "3.2.0"
 ---
 
 # Cost observability

package/templates/.agents/requirements/dashboard-launch.md

@@ -6,7 +6,7 @@ title: Inicialização e hidratação confiável do dashboard
 status: active
 version: 1
 source_change: null
-source_release: "3.0.0"
+source_release: "3.2.0"
 ---
 
 # Inicialização e hidratação confiável do dashboard

package/templates/.agents/requirements/data-export.md

@@ -6,7 +6,7 @@ title: Exportação contextual de dados para Excel
 status: proposed
 version: 2
 source_change: null
-source_release: "3.0.0"
+source_release: "3.2.0"
 ---
 
 # Exportação contextual de dados

package/templates/.agents/requirements/design-system.md

@@ -6,7 +6,7 @@ title: Contrato visual e catálogo executável
 status: active
 version: 5
 source_change: null
-source_release: "3.0.0"
+source_release: "3.2.0"
 ---
 
 # Design system

package/templates/.agents/requirements/execution-engine.md

@@ -6,7 +6,7 @@ title: Preparação, materialização e DAG
 status: active
 version: 11
 source_change: null
-source_release: "3.0.0"
+source_release: "3.2.0"
 ---
 
 # Execution engine

package/templates/.agents/requirements/kanban-dashboard.md

@@ -6,7 +6,7 @@ title: Projeções operacionais e analíticas
 status: active
 version: 14
 source_change: null
-source_release: "3.0.0"
+source_release: "3.2.0"
 ---
 
 # Kanban and dashboard

package/templates/.agents/requirements/model-orchestration.md

@@ -6,7 +6,7 @@ title: Seleção automática e observável de modelo e effort
 status: active
 version: 8
 source_change: null
-source_release: "3.0.0"
+source_release: "3.2.0"
 ---
 
 # Orquestração de modelos

package/templates/.agents/requirements/public-distribution.md

@@ -4,9 +4,9 @@ id: REQUIREMENTS-PUBLIC-DISTRIBUTION
 area: public-distribution
 title: Distribuição pública e ativação
 status: active
-version: 5
+version: 6
 source_change: null
-source_release: "3.0.0"
+source_release: "3.2.0"
 ---
 
 # Distribuição pública e ativação
@@ -42,4 +42,11 @@ introduzir paths ou identidades locais fixas.
 
 ## Verificação
 
+### Onboarding de instalação sob REQ-DIST-002
+
+- A instalação não exige Git disponível, identidade Git, repositório, commit inicial ou GitHub previamente configurados. Falhas reais de integridade e etapas obrigatórias continuam sendo informadas.
+- O resumo mostra a versão efetivamente instalada como link Markdown para a página npm dessa versão, contagens observadas e resultados reais de SQLite e doctor. Dry-run ou etapa não executada não equivale a sucesso.
+- O último CTA pergunta se o usuário deseja ajuda para configurar GitHub quando o estado local estiver pendente/inconclusivo; com GitHub configurado localmente, pergunta pela configuração inicial do projeto. Estado local não comprova autenticação.
+- Uma resposta afirmativa encaminha à skill correspondente, que explica opções e pergunta antes de aplicar escolhas. Após GitHub concluído, oferece projeto. Após projeto concluído ou recusa/adiamento, encerra o onboarding sem novas ofertas automáticas.
+
 Validar por testes unitários de matriz e paths, falhas injetadas de transação, cleanroom do template, pack smoke do `.tgz` exato e auditoria independente. A promoção para `active` exige Evidence tipada no commit final e ausência de regressão conhecida nos gates públicos.

package/templates/.agents/requirements/software-architecture.md

@@ -6,7 +6,7 @@ title: Layout modular e limites de código-fonte
 status: active
 version: 5
 source_change: null
-source_release: "3.0.0"
+source_release: "3.2.0"
 ---
 
 # Software architecture

package/templates/.agents/requirements/strategic-improvements.md

@@ -6,7 +6,7 @@ title: Melhorias estratégicas de custo, qualidade e resiliência
 status: active
 version: 1
 source_change: null
-source_release: "3.0.0"
+source_release: "3.2.0"
 ---
 
 # Melhorias estratégicas de custo, qualidade e resiliência

package/templates/.agents/requirements/work-lifecycle.md

@@ -6,7 +6,7 @@ title: Ciclo de vida do trabalho
 status: active
 version: 26
 source_change: null
-source_release: "3.0.0"
+source_release: "3.2.0"
 ---
 
 # Work lifecycle

package/templates/.agents/requirements/zaip-strategic-95.md

@@ -6,7 +6,7 @@ title: Evidências, custo por Task e autonomia por SPEC
 status: active
 version: 1
 source_change: null
-source_release: "3.0.0"
+source_release: "3.2.0"
 ---
 
 # Evidências, custo por Task e autonomia por SPEC

package/templates/.agents/runtime/VERSION

@@ -1 +1 @@
-3.0.0
+3.2.0