@openlife/cli 1.7.4 → 1.7.6

package/docs/audit/CLI-EXECUTION-RESULTS.md

@@ -1,113 +0,0 @@
-# CLI Execution Results — Phase 2
-
-**Generated:** 2026-05-11
-**Phase:** 2 — CLI End-to-End Exercise
-**Requirements covered:** CLI-01, CLI-02, CLI-03, CLI-04, CLI-05
-**Test files added:** `test_cli_help_surface.ts`, `test_cli_diagnostics.ts`, `test_cli_crud_roundtrip.ts`
-**Test suite:** 56 → 59 tests, all green via `npm run test:all`
-
----
-
-## Summary
-
-| Category | Tested | PASS | GRACEFUL | GAP | FAIL→Story |
-|----------|--------|------|----------|-----|------------|
-| Help/Version (45 groups + 2 root) | 47 | 47 | 0 | 0 | 0 |
-| Diagnostics (read-only commands) | 22 | 12 | 6 | 4 | 2 KNOWN BUGS |
-| CRUD Roundtrips (create→list→cleanup) | 6 | 6 | 0 | 0 | 0 |
-| **Total in Phase 2** | **75** | **65** | **6** | **4** | **2** |
-
----
-
-## CLI-01: Help/Version Surface ✓
-
-Test: `src/test_cli_help_surface.ts` — exits 0 in ~15s
-
-- Root `--help`: PASS (4,200+ bytes output)
-- Root `--version`: PASS (returns `1.0.0`)
-- All 45 top-level groups responded to `--help` with exit 0 and non-empty output
-
-**Slow `--help` invocations (>3s)** — bookmark for Phase 5 lazy-load review:
-
-| Group | Latency | Likely cause |
-|-------|---------|--------------|
-| `pilot --help` | 4175ms | Module-scope import of heavy enterprise classes |
-| `learning --help` | 3311ms | Possible eager import of learning loop subsystem |
-| `plugin --help` | 3249ms | Possible eager import of plugin manifest store |
-
-**Why this is a regression risk:** `CLAUDE.md` documents "lazy imports for heavy runtime classes" as a critical invariant. `--help` should be near-instant. These three suggest violation of the pattern.
-
----
-
-## CLI-02 / CLI-03 / CLI-04: Diagnostics ✓ with 2 known bugs
-
-Test: `src/test_cli_diagnostics.ts` — exits 0 in ~34s
-
-### PASS (exit 0 required, all green)
-- `catalog list`
-- `agents list`, `squads list`, `skills list`
-- `models status`
-- `memory status`, `memory provider-list`
-- `governance status`, `governance audit`
-- `media route-status`
-- `orchestration contract`, `orchestration snapshot`
-
-### GRACEFUL (exit 0 or 1 accepted; doctors that degrade gracefully)
-- `catalog doctor` — may warn about test-* artifacts (P3 design issue, not regression)
-- `system doctor` — warns about optional CLIs (codex/gemini)
-- `system status`
-- `media doctor`
-- `enterprise` — aggregate doctor
-- `swarm consensus-test`
-
-### GAP — known broken, deferred (recorded for Phase 5)
-- `phase1-check` — **HANGS** for >35s, killed by SIGKILL. **P1 BUG-01**.
-- `mcp status` (without `--real`) — exits 1 with "Use --real para obter o status determinístico". UX/default behavior bug. **P2 BUG-02**.
-
-### GAP — requires external state (Phase 4)
-- `system doctor-world` — requires LLM call
-- `benchmark report` — requires prior `benchmark run` to have data
-
----
-
-## CLI-05: CRUD Roundtrips ✓
-
-Test: `src/test_cli_crud_roundtrip.ts` — exits 0 in ~19s, **all 6 entity types create+list+cleanup correctly**
-
-| Entity | Create command | List command | Result |
-|--------|----------------|--------------|--------|
-| Agent | `agents create <id> --role specialist` | `agents list` | PASS, cleanup OK |
-| Squad | `squads create <id> --domain general` | `squads list` | PASS, cleanup OK |
-| Skill | `skills create <id>` | `skills list` | PASS, cleanup OK |
-| MCP | `mcp create <id> --transport stdio --entry echo` | `mcp status --real` | PASS, cleanup OK |
-| Team | `teams upsert <id> --domain general --sla balanced` | `teams list` | PASS, cleanup OK |
-| Network | `networks upsert <id> --domain general --capabilities cap1,cap2` | `networks list` | PASS, cleanup OK |
-
-**Cleanup hygiene:** Test uses unique IDs (`test-crud-${pid}-${timestamp}`) and removes each created entity. `.catalog/` is byte-clean after run.
-
----
-
-## Phase 2 Findings (queued for Phase 5)
-
-See `.planning/phase-2/FINDINGS.md` for the full bug list with severity and reproduction steps.
-
----
-
-## What's NOT covered in Phase 2 (intentional, by phase boundary)
-
-- Commands requiring live LLM (`ask`, `route intent`, `swarm run`, `governance risk-check`) → **Phase 4**
-- Commands requiring daemon (`start --daemon`, Telegram webhook flow) → **Phase 4**
-- Subsystem unit tests (Brain/Gateway internals beyond what's in `test_brain_*`, `test_daemon_sigterm`, `test_trigger_basic_auth`) → **Phase 3**
-- 105 DRIFT-HIGH undocumented commands → **Phase 5** (doc rewrites)
-
----
-
-## Suite Health After Phase 2
-
-```
-Before: 56 tests, all green, ~4 min runtime
-After:  59 tests, all green, ~6 min runtime
-Delta:  +3 tests, +~2 min (most of the delta is cold-start cost of 73 subprocess spawns across the new tests)
-```
-
-Pre-existing pollution in `.artifacts/` and `.catalog/test-*` MUST be cleaned before `npm run test:all` runs cleanly. This is **P3 tech debt** (documented in CONCERNS.md), not a regression. A `pretest` hook that cleans these would fix it — recommended for Phase 5.

package/docs/audit/CLI-MATRIX.md

@@ -1,556 +0,0 @@
-# CLI Matrix — openlife-cli
-
-**Source:** `src/index.ts` (1,855 lines)
-**Total `.command()` registrations:** 156 (raw grep count; see Anomalies section regarding the expected 158)
-**Generated:** 2026-05-11
-
-This matrix catalogs every `.command()` registration in `src/index.ts`. Group root commands
-(e.g., the `const xxxCmd = program.command('xxx')` lines that only declare a Commander
-subcommand group) are documented at the top of each group section and are **not** included in
-the per-subcommand row count of that group.
-
----
-
-## Top-Level Commands
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `install` | — | — | `--mode <mode>`, `--resume`, `--host <host>` (default `claude-code`), `--skip-doctor`, `--models <chain>`, `--model-1 <provider/model>`, `--model-2 <provider/model>`, `--model-3 <provider/model>`, `--telegram-token <token>`, `--telegram-chat-id <chatId>`, `--default-agent-name <name>`, `--additional-agent-name <name>`, `--headless`, `--from-file <path>` | Onboarding unificado: instala CLI ou Agente Autônomo | 200 |
-| 2 | `ask <mensagem...>` | — | `<mensagem...>` | `--mode <mode>` | Envia uma intenção direta ao Gatekeeper via Terminal | 399 |
-| 3 | `phase1-check` | — | — | — | Roda os checks mínimos da Fase 1 para validar o runtime principal | 437 |
-| 4 | `status` | — | — | — | Status universal do OpenLife (determinístico) | 1150 |
-| 5 | `doctor` | — | — | — | Doctor universal com severidade | 1163 |
-| 6 | `restart` | — | — | — | Reinício controlado do daemon OpenLife | 1171 |
-| 7 | `update` | — | — | — | Atualiza dependências, recompila o core e valida status do sistema (modo dev) | 1186 |
-| 8 | `up` | — | — | — | Inicialização one-shot: doctor rápido + start do agente em daemon | 1204 |
-| 9 | `agent <verb>` | — | `<verb>` | — | Alias compatível com documentação: agent install\|start\|status → autonomous lifecycle | 1248 |
-| 10 | `start` | — | — | `-d, --daemon` | Inicia o metabolismo do Organismo Vivo | 1270 |
-| 11 | `dream <entry...>` | `/dream` | `<entry...>` | — | Organiza automaticamente diário/notas pessoais | 1345 |
-
----
-
-## `auth` (group — line 242)
-
-Group description: `Gerencia a autenticação nativa sem uso de API Keys`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `auth gemini` | — | — | — | Realiza o login OAuth via Google para o Gemini CLI | 246 |
-| 2 | `auth openai` | `codex` | — | — | Realiza o login OAuth para o OpenAI Codex CLI (GPT-5.4) e valida automaticamente | 259 |
-
----
-
-## `models` (group — line 300)
-
-Group description: `Gestão do ciclo de vida e roteamento de Modelos Inteligentes`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `models status` | — | — | — | Exibe o modelo primário e a cadeia de fallbacks atual | 304 |
-| 2 | `models set <provider/model>` | — | `<provider/model>` | — | Define o modelo cognitivo padrão (ex: gemini-cli/gemini-3.1-pro-preview) | 323 |
-
-### `models fallbacks` (subgroup — line 336)
-
-Subgroup description: `Gerencia a cadeia de tolerância a falhas (Fallbacks)`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `models fallbacks list` | — | — | — | (no description in source) | 339 |
-| 2 | `models fallbacks add <provider/model>` | — | `<provider/model>` | — | (no description in source) | 348 |
-| 3 | `models fallbacks remove <provider/model>` | — | `<provider/model>` | — | (no description in source) | 369 |
-| 4 | `models fallbacks clear` | — | — | — | (no description in source) | 384 |
-
----
-
-## `system` (group — line 455)
-
-Group description: `Instalação, bootstrap e status do OpenLife`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `system install` | — | — | `--profile <profile>` (default `framework`), `--host <host>` (default `claude-code`), `--skip-doctor`, `--models <chain>`, `--model-1 <provider/model>`, `--model-2 <provider/model>`, `--model-3 <provider/model>`, `--model-4 <provider/model>` | Fluxo guiado de instalação (rápido e intuitivo) | 467 |
-| 2 | `system setup` | — | — | `--profile <profile>` (default `framework`), `--host <host>` (default `claude-code`), `--skip-doctor`, `--models <chain>`, `--model-1 <provider/model>`, `--model-2 <provider/model>`, `--model-3 <provider/model>`, `--model-4 <provider/model>` | Alias de system install para onboarding completo | 505 |
-| 3 | `system status` | — | — | — | Mostra status básico da instalação do sistema | 535 |
-| 4 | `system doctor` | — | — | — | Roda checkup básico do sistema e runtime local | 542 |
-| 5 | `system init-project` | — | — | — | Cria o arquivo base de contexto do projeto OpenLife | 552 |
-| 6 | `system doctor-world` | — | — | — | Roda diagnóstico world-class do sistema | 560 |
-| 7 | `system bootstrap-world` | — | — | — | Prepara artefatos de bootstrap world-class | 567 |
-
----
-
-## `memory` (group — line 572)
-
-Group description: `Operações de memória do OpenLife`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `memory status` | — | — | — | (no description in source) | 573 |
-| 2 | `memory provider-list` | — | — | — | (no description in source) | 577 |
-| 3 | `memory provider-use <name>` | — | `<name>` | — | (no description in source) | 581 |
-| 4 | `memory test <name>` | — | `<name>` | — | (no description in source) | 585 |
-| 5 | `memory search <query...>` | — | `<query...>` | — | Pesquisa memória por texto e retorna contexto | 589 |
-
----
-
-## `swarm` (group — line 597)
-
-Group description: `Operações de swarm e consenso`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `swarm run` | — | `[goal...]` (argument, default `[]`) | — | (no description in source) | 600 |
-| 2 | `swarm consensus-test` | — | — | — | (no description in source) | 621 |
-
----
-
-## `governance` (group — line 626)
-
-Group description: `Operações de governança e risco`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `governance status` | — | — | — | (no description in source) | 627 |
-| 2 | `governance audit` | — | — | — | (no description in source) | 631 |
-| 3 | `governance risk-check <goal>` | — | `<goal>` | — | (no description in source) | 635 |
-| 4 | `governance consent <scope> <userId>` | — | `<scope> <userId>` | — | (no description in source) | 639 |
-
-### `governance policy` (subgroup — line 643)
-
-Subgroup description: `Inspeção da política de governança ativa`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `governance policy show` | — | — | — | Exibe o conteúdo de governance-policy.json | 644 |
-
----
-
-## `benchmark` (group — line 668)
-
-Group description: `Operações de benchmark do OpenLife`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `benchmark run` | — | — | — | (no description in source) | 669 |
-| 2 | `benchmark compare` | — | — | — | (no description in source) | 673 |
-| 3 | `benchmark report` | — | — | — | (no description in source) | 677 |
-
----
-
-## `agents` (group — line 682)
-
-Group description: `Operações de agentes`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `agents list` | — | — | — | lista agentes reais carregados do registry | 685 |
-| 2 | `agents create <id>` | — | `<id>` | `--role <role>` (default `specialist`), `--notes <notes>` (default empty) | (no description in source) | 692 |
-| 3 | `agents show <id>` | — | `<id>` | — | Exibe metadata de um agente do .catalog/agents/<id> | 703 |
-
----
-
-## `squads` (group — line 737)
-
-Group description: `Operações de squads`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `squads list` | — | — | — | lista squads reais carregadas do registry | 740 |
-| 2 | `squads create <id>` | — | `<id>` | `--domain <domain>` (default `general`), `--notes <notes>` (default empty) | (no description in source) | 747 |
-
----
-
-## `skills` (group — line 757)
-
-Group description: `Operações de skills`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `skills list` | — | — | — | lista skills reais carregadas do registry | 760 |
-| 2 | `skills create <id>` | — | `<id>` | `--notes <notes>` (default empty) | (no description in source) | 766 |
-
----
-
-## `route` (group — line 862)
-
-Group description: `Roteamento inteligente por intenção para squads, agentes e skills`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `route intent <goal...>` | — | `<goal...>` | `--limit <n>` (default `8`), `--auto-create` (default `false`), `--min-score <n>` (default `1`), `--create-prefix <prefix>` | recomenda squads/agentes/skills para uma missão | 869 |
-
----
-
-## `mcp` (group — line 896)
-
-Group description: `Operações de MCP`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `mcp create <id>` | — | `<id>` | `--transport <transport>` (default `stdio`), `--entry <entry>` (default empty) | (no description in source) | 900 |
-| 2 | `mcp status` | — | — | `--real` | (no description in source) | 1137 |
-
----
-
-## `catalog` (group — line 917)
-
-Group description: `Diagnóstico do catálogo runtime do OpenLife`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `catalog doctor` | — | — | `--strict` (default `false`) | (no description in source) | 933 |
-| 2 | `catalog list` | — | — | — | (no description in source) | 952 |
-
----
-
-## `teams` (group — line 956)
-
-Group description: `Administração de times de agentes por domínio`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `teams list` | — | — | — | (no description in source) | 958 |
-| 2 | `teams upsert <id>` | — | `<id>` | `--domain <domain>` (default `general`), `--description <description>` (default empty), `--sla <sla>` (default `balanced`) | (no description in source) | 969 |
-
----
-
-## `networks` (group — line 984)
-
-Group description: `Administração de redes de skills por domínio`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `networks list` | — | — | — | (no description in source) | 986 |
-| 2 | `networks upsert <id>` | — | `<id>` | `--domain <domain>` (default `general`), `--capabilities <capabilities>` (default empty) | (no description in source) | 996 |
-
----
-
-## `media` (group — line 1012)
-
-Group description: `Roteamento e telemetria de mídia (vision/stt/tts)`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `media route` | — | — | `--prefer-gemini <value>` (default `true`) | Configura preferência de Gemini para mídia | 1013 |
-| 2 | `media route-status` | — | — | `--tail <n>` (default `20`) | Mostra status da preferência e resumo dos logs de roteamento | 1027 |
-| 3 | `media doctor` | — | — | `--require-fallback` (default `false`) | Valida routing Gemini-first e fallback de mídia sem executar chamadas externas | 1061 |
-| 4 | `media read-image <imagePath>` | — | `<imagePath>` | `--prompt <text>` (default `'Extraia texto e descreva a estrutura desta imagem.'`) | Lê imagem via Gemini CLI com fallback de modelos e log detalhado | 1083 |
-
----
-
-## `orchestration` (group — line 1125)
-
-Group description: `Contrato e snapshot de orquestração`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `orchestration contract` | — | — | — | (no description in source) | 1126 |
-| 2 | `orchestration snapshot` | — | — | — | (no description in source) | 1130 |
-
----
-
-## `smoke` (group — line 1323)
-
-Group description: `Smokes formais de produção/local`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `smoke railway` | — | — | — | (no description in source) | 1324 |
-| 2 | `smoke telegram` | — | — | — | (no description in source) | 1331 |
-
----
-
-## `service` (group — line 1354)
-
-Group description: `Operações de serviço (mode service)`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `service list` | — | — | `--limit <limit>` (default `100`) | (no description in source) | 1358 |
-| 2 | `service create <serviceId>` | — | `<serviceId>` | `--objective <objective>` (default `'Serviço operacional OpenLife'`), `--risk <risk>` (default `medium`) | (no description in source) | 1367 |
-| 3 | `service status <serviceId>` | — | `<serviceId>` | — | Mostra status do serviço | 1380 |
-| 4 | `service pause <serviceId>` | — | `<serviceId>` | `--reason <reason>` (default `'Pausado manualmente pelo operador'`) | Pausa serviço | 1393 |
-| 5 | `service resume <serviceId>` | — | `<serviceId>` | `--reason <reason>` (default `'Retomado manualmente pelo operador'`) | Retoma serviço | 1406 |
-| 6 | `service events <serviceId>` | — | `<serviceId>` | `--limit <limit>` (default `50`) | Lista eventos recentes do serviço | 1419 |
-
----
-
-## `task` (group — line 1430)
-
-Group description: `Operações de tarefa (mode task)`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `task list` | — | — | `--limit <limit>` (default `100`) | (no description in source) | 1434 |
-| 2 | `task run <goal...>` | — | `<goal...>` | `--service <serviceId>` (default empty) | (no description in source) | 1444 |
-| 3 | `task status <taskId>` | — | `<taskId>` | — | Mostra status da tarefa | 1457 |
-
----
-
-## `job` (group — line 1467)
-
-Group description: `Lifecycle de jobs autônomos`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `job list` | — | — | `--limit <limit>` (default `50`) | (no description in source) | 1470 |
-| 2 | `job events <jobId>` | — | `<jobId>` | — | (no description in source) | 1477 |
-
----
-
-## `runtime` (group — line 1482)
-
-Group description: `Runtime registry unificado`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `runtime probe` | — | — | — | (no description in source) | 1483 |
-| 2 | `runtime list` | — | — | — | (no description in source) | 1487 |
-
----
-
-## `reversa` (group — line 1492)
-
-Group description: `Reversa-lite reverse-spec pipeline`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `reversa status` | — | — | — | (no description in source) | 1493 |
-| 2 | `reversa next` | — | — | `--note <note>` (default `'checkpoint avançado'`) | (no description in source) | 1499 |
-| 3 | `reversa mode` | — | — | `--set <mode>`, `--profile <profileId>` | (no description in source) | 1506 |
-| 4 | `reversa run-phase <phase>` | — | `<phase>` | `--note <note>` (default `'phase run'`) | (no description in source) | 1516 |
-| 5 | `reversa run-all` | — | — | `--note <note>` (default `'run all'`) | (no description in source) | 1522 |
-| 6 | `reversa export-json` | — | — | — | (no description in source) | 1526 |
-
----
-
-## `sources` (group — line 1531)
-
-Group description: `Catálogo de fontes externas (skills/squads/agents/mcps)`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `sources list` | — | — | — | (no description in source) | 1532 |
-| 2 | `sources guard-check <url>` | — | `<url>` | — | (no description in source) | 1536 |
-| 3 | `sources scaffold <type> <id>` | — | `<type> <id>` | `--notes <notes>` (default empty) | cria scaffold local de referência para skill\|squad\|agent\|mcp | 1543 |
-| 4 | `sources import-ref <type> <id> <url>` | — | `<type> <id> <url>` | — | importa referência remota com guardrail para .catalog | 1559 |
-
----
-
-## `teammate` (group — line 1578)
-
-Group description: `Agents as teammates board`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `teammate list` | — | — | — | (no description in source) | 1579 |
-| 2 | `teammate upsert <id> <owner> <status> <title>` | — | `<id> <owner> <status> <title>` | `--blocker <blocker>` (default empty), `--comment <comment>` (default empty) | (no description in source) | 1586 |
-
----
-
-## `learning` (group — line 1592)
-
-Group description: `Governed skill learning loop`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `learning add <taskId> <summary>` | — | `<taskId> <summary>` | — | (no description in source) | 1593 |
-| 2 | `learning list` | — | — | — | (no description in source) | 1597 |
-
----
-
-## `context` (group — line 1602)
-
-Group description: `Contexto institucional do OpenLife`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `context init` | — | — | `--name <name>` (default `'OpenLife Institutional Context'`) | (no description in source) | 1605 |
-| 2 | `context doctor` | — | — | — | (no description in source) | 1608 |
-| 3 | `context summary` | — | — | — | (no description in source) | 1613 |
-
----
-
-## `plugin` (group — line 1622)
-
-Group description: `Marketplace interno de plugins/skills governados`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `plugin install <id>` | — | `<id>` | `--risk <risk>` (default `low`), `--capability <capability>` (repeatable, default `[]`) | (no description in source) | 1626 |
-| 2 | `plugin list` | — | — | — | (no description in source) | 1629 |
-| 3 | `plugin inspect <id>` | — | `<id>` | — | (no description in source) | 1632 |
-| 4 | `plugin disable <id>` | — | `<id>` | — | (no description in source) | 1635 |
-| 5 | `plugin enable <id>` | — | `<id>` | — | (no description in source) | 1638 |
-
----
-
-## `pilot` (group — line 1642)
-
-Group description: `Pilotos mensuráveis para serviços/capacidades OpenLife`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `pilot create <id>` | — | `<id>` | `--metric <metric>`, `--service <service>` (default `unassigned`) | (no description in source) | 1646 |
-| 2 | `pilot list` | — | — | — | (no description in source) | 1649 |
-| 3 | `pilot report <id>` | — | `<id>` | — | (no description in source) | 1652 |
-| 4 | `pilot complete <id>` | — | `<id>` | `--outcome <outcome>` (default `completed`) | (no description in source) | 1657 |
-
----
-
-## `eval` (group — line 1661)
-
-Group description: `Avaliação/LLM-as-judge interno para missões`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `eval judge` | — | — | `--mission <mission>` (required), `--criteria <criteria>` (default `'quality,governance,actionability'`) | (no description in source) | 1665 |
-| 2 | `eval report <mission>` | — | `<mission>` | — | (no description in source) | 1668 |
-
----
-
-## `learn` (group — line 1672)
-
-Group description: `Feedback loop que transforma revisão humana em evolução`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `learn from-last-run` | — | — | `--mission <mission>` (required), `--feedback <feedback>` (default empty) | (no description in source) | 1676 |
-| 2 | `learn list` | — | — | — | (no description in source) | 1679 |
-
----
-
-## `enterprise` (group — line 1683)
-
-Group description: `Diagnóstico agregado do núcleo enterprise-agentic`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `enterprise doctor` | — | — | — | (no description in source) | 1684 |
-
----
-
-## `designmd` (group — line 1690)
-
-Group description: `DESIGN.md mode manager`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `designmd status` | — | — | — | (no description in source) | 1691 |
-| 2 | `designmd import` | — | — | `--vendor <vendorPath>` (default `vendor/awesome-design-md`), `--source <source>` (default `awesome-design-md`) | (no description in source) | 1698 |
-| 3 | `designmd list` | — | — | — | (no description in source) | 1711 |
-| 4 | `designmd show <profileId>` | — | `<profileId>` | — | (no description in source) | 1715 |
-| 5 | `designmd apply <profileId> <source> <title> <designPath>` | — | `<profileId> <source> <title> <designPath>` | — | (no description in source) | 1720 |
-
----
-
-## `aiobuilder` (group — line 1726)
-
-Group description: `AIOBUILDER operations`
-
-| # | Command | Aliases | Args | Flags | Description | Handler @ line |
-|---|---------|---------|------|-------|-------------|----------------|
-| 1 | `aiobuilder mode` | — | — | `--set <mode>`, `--profile <profileId>` | (no description in source) | 1730 |
-| 2 | `aiobuilder create-agent <id>` | — | `<id>` | `--role <role>` (default `specialist`), `--notes <notes>` (default empty) | (no description in source) | 1741 |
-| 3 | `aiobuilder create-squad <id>` | — | `<id>` | `--domain <domain>` (default `general`), `--notes <notes>` (default empty) | (no description in source) | 1749 |
-| 4 | `aiobuilder validate-catalog` | — | — | — | (no description in source) | 1754 |
-| 5 | `aiobuilder generate-ui <featureName>` | — | `<featureName>` | `--strict-contracts` (default `false`), `--consistency-check` (default `false`) | (no description in source) | 1763 |
-| 6 | `aiobuilder chat <mensagem...>` | — | `<mensagem...>` | — | Executa intents de design por linguagem natural (import, mode, generate, refine) | 1845 |
-
----
-
-## Summary
-
-- **Top-level standalone commands:** 11 (`install`, `ask`, `phase1-check`, `status`, `doctor`, `restart`, `update`, `up`, `agent`, `start`, `dream`)
-- **Top-level command groups (declared via `program.command(...)`):** 30
-  - `auth`, `models`, `system`, `memory`, `swarm`, `governance`, `benchmark`, `agents`, `squads`, `skills`, `route`, `mcp`, `catalog`, `teams`, `networks`, `media`, `orchestration`, `smoke`, `service`, `task`, `job`, `runtime`, `reversa`, `sources`, `teammate`, `learning`, `context`, `plugin`, `pilot`, `eval`, `learn`, `enterprise`, `designmd`, `aiobuilder` (32 unique group identifiers — note: `eval`/`learn`/`enterprise`/`designmd`/`aiobuilder` count above is correct; the 30 figure was preliminary, see Verification)
-- **Sub-groups (one level deeper than top-level group):** 2 (`models fallbacks`, `governance policy`)
-- **Total terminal (leaf) commands** (rows in the tables above, excluding group/subgroup declaration rows): 115
-- **Total `.command()` registrations in source** (raw grep, including all group declarations): **156**
-- **Aliases discovered:** 2 total
-  - `auth openai` ↔ `codex` (line 257)
-  - `dream` ↔ `/dream` (line 1343)
-
-### Group/subgroup breakdown (count of leaf commands per top-level)
-
-| Top-level | Leaf commands |
-|-----------|---------------|
-| `auth` | 2 |
-| `models` | 2 + 4 (fallbacks subgroup) = 6 |
-| `system` | 7 |
-| `memory` | 5 |
-| `swarm` | 2 |
-| `governance` | 4 + 1 (policy subgroup) = 5 |
-| `benchmark` | 3 |
-| `agents` | 3 |
-| `squads` | 2 |
-| `skills` | 2 |
-| `route` | 1 |
-| `mcp` | 2 |
-| `catalog` | 2 |
-| `teams` | 2 |
-| `networks` | 2 |
-| `media` | 4 |
-| `orchestration` | 2 |
-| `smoke` | 2 |
-| `service` | 6 |
-| `task` | 3 |
-| `job` | 2 |
-| `runtime` | 2 |
-| `reversa` | 6 |
-| `sources` | 4 |
-| `teammate` | 2 |
-| `learning` | 2 |
-| `context` | 3 |
-| `plugin` | 5 |
-| `pilot` | 4 |
-| `eval` | 2 |
-| `learn` | 2 |
-| `enterprise` | 1 |
-| `designmd` | 5 |
-| `aiobuilder` | 6 |
-| **Top-level standalone** | 11 |
-
-Total leaf commands: 11 + 2+6+7+5+2+5+3+3+2+2+1+2+2+2+2+4+2+2+6+3+2+2+6+4+2+2+3+5+4+2+2+1+5+6 = **125** leaf commands.
-
-Total `.command()` declarations including 34 top-level group declarations (`auth`, `models`, `system`, `memory`, `swarm`, `governance`, `benchmark`, `agents`, `squads`, `skills`, `route`, `mcp`, `catalog`, `teams`, `networks`, `media`, `orchestration`, `smoke`, `service`, `task`, `job`, `runtime`, `reversa`, `sources`, `teammate`, `learning`, `context`, `plugin`, `pilot`, `eval`, `learn`, `enterprise`, `designmd`, `aiobuilder` = 34 groups) **plus** 2 subgroup declarations (`models fallbacks`, `governance policy`) = **34 + 2 = 36 declarations that are pure groups** + **120 leaf-command declarations** = should be **156**, which matches the grep count exactly. (The 125 figure above double-counts a few; the authoritative grep total is 156.)
-
----
-
-## Verification
-
-Running `grep -c "\.command(" src/index.ts` returns **156**.
-
-A breakdown of each `.command()` line is provided by line in this matrix; every line emitted
-by `grep -n "\.command(" src/index.ts` (156 lines) appears as either a group/subgroup row or
-a leaf-command row.
-
----
-
-## Anomalies
-
-1. **Expected vs actual count discrepancy.** The task brief said `src/index.ts` has 158 `.command()`
-   registrations. The actual `grep -c "\.command("` count is **156**. The two-call gap could be:
-   - older revision had 2 extra command lines that were later removed
-   - or 2 `.command(` substrings exist outside `src/index.ts` in related files
-
-   Within the file scope requested for this task, every `.command()` registration is catalogued.
-
-2. **Empty / default-string flag values.** Some `.option()` calls have empty-string defaults
-   (`--notes <notes>` default `''`); flagged as "default empty" in the matrix above.
-
-3. **Nested subgroups beyond depth 2.** None found — the deepest nesting is `models fallbacks <cmd>`
-   and `governance policy <cmd>` (depth 2 from `program`).
-
-4. **No dynamically registered commands.** All `.command()` calls are static, top-of-file
-   registrations. No iterators or runtime loops that build commands were detected.
-
-5. **No commented-out commands.** No `// .command(` lines were skipped — every grep hit is live.
-
-6. **`tryHandleDesignConversation` is not a Commander command** — it's a helper function (lines
-   42–176) consumed by `ask` (line 403) and `aiobuilder chat` (line 1847). It is not a separately
-   registered CLI command and is therefore not catalogued here.
-
-7. **Group-row description ambiguity.** Some groups have a description string passed via
-   `.description(...)` chained to the group declaration, while many leaf commands omit
-   `.description()` and rely on Commander defaults. The matrix marks those leaves as
-   `(no description in source)` per the task constraints.