@aretw0/pi-stack

Stack curada de extensões pi — um pi install que traz tudo.

Instalação

Via npm:

pi install npm:@aretw0/pi-stack

Via npx (one-click):

npx @aretw0/pi-stack           # global
npx @aretw0/pi-stack --local   # projeto atual
npx @aretw0/pi-stack --remove  # desinstalar

Via git (sempre atualizado):

pi install https://github.com/aretw0/agents-lab

O que inclui

First-Party (@aretw0/*)

Pacote	O que traz
@aretw0/git-skills	commit, git-workflow, github (gh CLI), glab
@aretw0/web-skills	native-web-search, web-browser (CDP)
@aretw0/pi-skills	terminal-setup, create-pi-skill/extension/theme/prompt
@aretw0/lab-skills	evaluate-extension, cultivate-primitive, stack-feedback

Extensions Incluídas

Extension	O que faz
monitor-provider-patch	Patch provider-aware para classifiers de monitor (Copilot/Codex + mapa custom) com comando /monitor-provider
environment-doctor	Health check do ambiente na startup + comando /doctor + tool environment_doctor_status
claude-code-adapter	Scaffold experimental para runtime externo Claude Code (`/claude-code status
guardrails-core	Guardrail unificado first-party: proteção de paths sensíveis + roteamento web determinístico por escopo + bloqueio de conflito de porta reservada pelo session-web
colony-pilot	Primitiva de orquestração/visibilidade: prepara runbooks manuais para pilot (monitors/remote/colony) e mantém snapshot de colonies em background
web-session-gateway	Gateway web first-party para observabilidade local da sessão (URL determinística, /api/health e painel web local)
quota-visibility	Observabilidade de consumo/cota a partir de ~/.pi/agent/sessions (burn rate, janelas de 5h/peak hours por provider, export de evidências)

Defaults do monitor-provider-patch

Default	Valor	Configurável?
Modelo dos classificadores (provider-aware)	github-copilot -> github-copilot/claude-haiku-4.5openai-codex -> openai-codex/gpt-5.4-mini	Sim (classifierModel / classifierModelByProvider)
Thinking	off	Sim (classifierThinking)
conversation_history no hedge monitor	desabilitado	Sim (hedgeConversationHistory)

Exemplo em .pi/settings.json:

{
  "piStack": {
    "monitorProviderPatch": {
      "classifierThinking": "off",
      "classifierModelByProvider": {
        "github-copilot": "github-copilot/claude-haiku-4.5",
        "openai-codex": "openai-codex/gpt-5.4-mini"
      },
      "hedgeConversationHistory": true
    }
  }
}

Diagnóstico/aplicação rápida:

/monitor-provider status
/monitor-provider apply
/monitor-provider template

Detalhes: docs/guides/monitor-overrides.md

Tema

Tema	Descrição
agents-lab	Tema com realce de código melhorado — cyan/purple para identificadores, contraste alto

Ativar: /settings → selecionar agents-lab

Terceiros Curados

Pacote	O que traz
pi-lens	LSP, ast-grep, code analysis
pi-web-access	Fetch, PDF, YouTube
@davidorex/pi-project-workflows	Project blocks, workflows YAML, monitors
@ifi/oh-pi-extensions	safe-guard, git-guard, bg-process, e mais
@ifi/oh-pi-skills	debug-helper, quick-setup, e mais
@ifi/oh-pi-themes	Temas visuais
@ifi/oh-pi-prompts	Prompt templates
@ifi/oh-pi-ant-colony	Multi-agent swarm
@ifi/pi-extension-subagents	Subagentes delegáveis
@ifi/pi-plan	Planejamento com /plan
@ifi/pi-spec	Workflow spec-driven com /spec
@ifi/pi-web-remote	Sessão via web
mitsupi	multi-edit, review, context, files, todos, e mais

Comandos

Comando	O que faz
/doctor	Diagnóstico canônico do ambiente (/doctor e /doctor hatch) — verifica tools/auth/shell/terminal e readiness operacional
/colony-pilot	Guia pilot (hatch/check/models/preflight/baseline/run/status/stop/web/monitors/tui/artifacts), incluindo hatch doctor plugin-aware com quick-recovery e hard-gates para ant_colony
/session-web	Controla gateway web first-party (start/status/open/stop) para inspeção local da sessão sem UI hospedada externa
/monitor-provider	Diagnostica e sincroniza modelos dos classifiers dos monitors por provider (status/apply/template)
/quota-visibility	Mostra consumo estimado da janela, projeção semanal, janelas/peak hours, budgets por provider e route advisory determinístico (`cheap
/scheduler-governance	Governança de scheduler lease/ownership (status/policy/apply) com confirmações fortes para ações destrutivas
/stack-status	Diagnóstico de soberania da stack: owners por capability, risco de overlap e postura de governança em runtime
/claude-code	Bridge experimental para Claude Code CLI (status/login/auth-status)

Convenção: /doctor permanece o diagnóstico global de ambiente/runtime. Comandos verticais como /monitor-provider, /colony-pilot e /scheduler-governance fazem diagnóstico/controle de domínio.

Guia de governança provider/model para colônia e multi-agentes: docs/guides/colony-provider-model-governance.md

Guia de governança forte do scheduler: docs/guides/scheduler-governance.md

Guia operacional de soberania (inclui CI artifact + comentário de PR): docs/guides/stack-sovereignty-user-guide.md

Baseline de projeto (.pi/settings.json)

Para inicializar defaults versionáveis no workspace (sem depender só de prompt):

/colony-pilot baseline show default
/colony-pilot baseline apply default

# profile mais estrito para próxima fase/execução paralela
/colony-pilot baseline show phase2
/colony-pilot baseline apply phase2

Baseline aplicada (default):

{
  "piStack": {
    "colonyPilot": {
      "preflight": {
        "enabled": true,
        "enforceOnAntColonyTool": true,
        "requiredExecutables": ["node", "git", "npm"],
        "requireColonyCapabilities": ["colony", "colonyStop"]
      },
      "budgetPolicy": {
        "enabled": true,
        "enforceOnAntColonyTool": true,
        "requireMaxCost": true,
        "autoInjectMaxCost": true,
        "defaultMaxCostUsd": 2,
        "hardCapUsd": 20,
        "minMaxCostUsd": 0.05,
        "enforceProviderBudgetBlock": false,
        "providerBudgetLookbackDays": 30,
        "allowProviderBudgetOverride": true,
        "providerBudgetOverrideToken": "budget-override:"
      }
    },
    "webSessionGateway": {
      "mode": "local",
      "port": 3100
    },
    "schedulerGovernance": {
      "enabled": true,
      "policy": "observe",
      "requireTextConfirmation": true,
      "allowEnvOverride": true,
      "staleAfterMs": 10000
    },
    "guardrailsCore": {
      "portConflict": {
        "enabled": true,
        "suggestedTestPort": 4173
      }
    }
  }
}

CI de soberania (fail/pass + visibilidade)

No repositório, a soberania é validada por dois níveis:

• Gate de bloqueio (job smoke):
  • npm run audit:sovereignty
  • npm run audit:sovereignty:diff
• Visibilidade operacional (job sovereignty-report):
  • gera docs/architecture/stack-sovereignty-audit-latest.md
  • publica artifact stack-sovereignty-audit
  • faz upsert de comentário no PR (<!-- stack-sovereignty-report -->)

Filosofia

Este meta-pacote é transitório. Conforme o agents-lab curadoria as primitivas, pacotes first-party vão substituir gradualmente as dependências de terceiros. O objetivo é que @aretw0/pi-stack dependa cada vez mais de @aretw0/* e menos de terceiros.

Repositório

github.com/aretw0/agents-lab

Licença

MIT