@daniellins/power-claude 0.17.1 → 0.17.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@daniellins/power-claude",
-  "version": "0.17.1",
+  "version": "0.17.2",
   "description": "Lean, budget-gated agent framework for Claude Code — pods by job-to-be-done",
   "author": "Daniel Lins",
   "license": "MIT",

package/scripts/arena.cjs

@@ -3,8 +3,7 @@
 /**
  * arena.cjs — MOTOR determinístico da skill `pc-arena` (harness de comparação cega
  * reutilizável). ADR-009 Decisão 1/2. Generaliza o protocolo do benchmark 4-braços
- * (second-brain docs/benchmark/PROTOCOLO-4-bracos.md; RELATORIO-FINAL.md) para N≥2
- * braços quaisquer.
+ * (documentado em `docs/adr/ADR-009-...`) para N≥2 braços quaisquer.
  *
  * FRONTEIRA (ADR-002 reaplicada à AVALIAÇÃO): este motor faz o DETERMINÍSTICO e
  * propenso-a-bug — permutação de rótulos com uniquidade validada (bijeção braço↔rótulo),

package/scripts/pod-export-executor.cjs

@@ -491,10 +491,14 @@ function setupRun({ bundleDir, lockOverride, payload = {}, deps = {}, log }) {
   const inputsDir = payload.inputs_dir
     ? (path.isAbsolute(payload.inputs_dir) ? payload.inputs_dir : path.resolve(payload.__dir || process.cwd(), payload.inputs_dir))
     : null;
+  // Fallback de chave por arquivo `.env` — SÓ se o dev declarar o path na env var genérica
+  // `PC_ANTHROPIC_ENV_FILE`/`PC_OPENROUTER_ENV_FILE` (mesmo padrão de `PC_CLONE_DENYLIST` em
+  // validate-no-clone.cjs). Sem a env var, não há fallback de path — só `process.env` direto.
+  // Nenhum path de máquina pessoal fica embutido no código distribuído.
   const anthropicKey = process.env.ANTHROPIC_API_KEY
-    || readEnvVar(path.join(os.homedir(), 'projetos/dev/second-brain/app/.env.local'), 'ANTHROPIC_API_KEY');
+    || (process.env.PC_ANTHROPIC_ENV_FILE ? readEnvVar(process.env.PC_ANTHROPIC_ENV_FILE, 'ANTHROPIC_API_KEY') : null);
   const orKey = process.env.OPENROUTER_API_KEY
-    || readEnvVar(path.join(os.homedir(), 'projetos/bench/.env'), 'OPENROUTER_API_KEY');
+    || (process.env.PC_OPENROUTER_ENV_FILE ? readEnvVar(process.env.PC_OPENROUTER_ENV_FILE, 'OPENROUTER_API_KEY') : null);
   return {
     bundleRoot, bundle, lockPath, coherence, whitelist, inputsDir,
     payload, anthropicKey, orKey, deps,
@@ -601,6 +605,7 @@ async function main() {
   const runIdArg = positionals[2];
   if (!bundleDir || !cmd) {
     console.error('Uso: node scripts/pod-export-executor.cjs <bundle-dir> <run|resume|approve|status> [runId] [--input <payload.json>] [--runs-root <dir>] [--lock <path>] [--kill-during <phase>]');
+    console.error('`run` exige chave de API: ANTHROPIC_API_KEY / OPENROUTER_API_KEY no ambiente, ou arquivo apontado por PC_ANTHROPIC_ENV_FILE / PC_OPENROUTER_ENV_FILE.');
     process.exit(2);
   }
   const runsRoot = flags.runsRoot ? path.resolve(flags.runsRoot) : path.join(REPO_ROOT, '.power-claude', 'pod-export-runs');
@@ -611,7 +616,7 @@ async function main() {
   run.log(`[coerência] framework_version motor=${run.coherence.engineVersion} == lock=${run.coherence.lockVersion} (AC16 OK)`);
 
   if (cmd === 'run') {
-    if (!run.anthropicKey) { console.error('[FALHA] ANTHROPIC_API_KEY não encontrada (env ou second-brain/app/.env.local).'); process.exit(1); }
+    if (!run.anthropicKey) { console.error('[FALHA] ANTHROPIC_API_KEY não encontrada (env ANTHROPIC_API_KEY, ou arquivo apontado por PC_ANTHROPIC_ENV_FILE).'); process.exit(1); }
     const runId = runIdArg || ('pex-' + new Date().toISOString().replace(/[:.]/g, '-'));
     const memoryPodDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pex-mem-')); // DF2-2: memória efêmera, NUNCA o bundle.
     run.log(`\n=== RUN ${runId} — pod ${run.pod} — modelos ${JSON.stringify(run.bundle.modelo_pinado.agents)} ===`);

package/scripts/pod-export-service.cjs

@@ -3,7 +3,7 @@
 /**
  * pod-export-service.cjs — SERVIÇO-IRMÃO de longa duração do épico pod-export (F2, Story SF10.3).
  *
- * Processo systemd PRÓPRIO na VPS (fora da instância Next.js do `second-brain` — isola o blast
+ * Processo systemd PRÓPRIO na VPS (fora da instância Next.js de deploy — isola o blast
  * radius, ADR-018 premissa travada linha 24). NÃO reimplementa nada de SF10.2: hospeda o executor
  * (`pod-export-executor.cjs`) por spawn e reusa o motor (`pc-run-pod.cjs`) por import (frontier
  * command_check). Sem superfície de rede: o trigger é um CONTRATO DE DIRETÓRIO (DF2-5).
@@ -52,7 +52,7 @@
  *      motor degrada MUDO e um .cjs plantado sob scripts/veto-checks/ passaria pelo nome
  *      (NOTE-1 do gate de SF10.3; Story SF10.9/AC1, aferido dentro de assertCommandCheckFrontier).
  *
- * CONFIG por ENV (a instância VPS-específica vive no `second-brain`; aqui é genérico/parametrizável):
+ * CONFIG por ENV (a instância VPS-específica vive fora deste repo; aqui é genérico/parametrizável):
  *   PODEXPORT_BUNDLE_DIR  (obrigatório p/ start) — dir do bundle compilado por F1.
  *   PODEXPORT_QUEUE_DIR   (obrigatório p/ start) — raiz da fila (pending/processing/done/failed).
  *   PODEXPORT_RUNS_DIR    (default <repo>/.power-claude/pod-export-runs) — runs root do executor.
@@ -113,7 +113,7 @@ function safeRunId(id) {
 // ---------------------------------------------------------------------------
 
 /**
- * Padrão `getAnthropicApiKey` da plataforma (achado concreto, second-brain/app): lê SÓ de
+ * Padrão `getAnthropicApiKey` da plataforma (achado concreto na app de deploy): lê SÓ de
  * `process.env` (env da VPS/systemd), lança fail-loud se ausente. NUNCA hardcoded, NUNCA por
  * usuário/client/request. O valor NÃO é logado nem devolvido — só um booleano de presença.
  */

package/template/.claude/commands/power/forge.md

@@ -66,7 +66,7 @@ node scripts/pc-run-pod.cjs start squad-forge forge \
 ```
 
 Sempre pela **flag** `--task-ref`, nunca posicional. Rode a partir da raiz do repo
-(`second-brain`); o `--pod-root` não é necessário — o motor deriva a raiz do pod pelo path do `wf`.
+(`<seu-repo>`); o `--pod-root` não é necessário — o motor deriva a raiz do pod pelo path do `wf`.
 
 O `start` imprime `[start] run <run-id> → <caminho do state.json>` e já emite o `[dispatch]` da
 etapa `discovery`, com o bloco `--- BRIEF ---` (o `next` NÃO é necessário para ver o brief — ele só

package/template/.claude/commands/power/hormozi.md

@@ -37,7 +37,7 @@ node scripts/pc-run-pod.cjs start hormozi-method wf-grand-slam-offer \
   --task-ref "<descrição livre do negócio/oferta>"
 ```
 
-Sempre pela **flag** `--task-ref`, nunca posicional. Rode a partir da raiz do repo (`second-brain`); o
+Sempre pela **flag** `--task-ref`, nunca posicional. Rode a partir da raiz do repo (`<seu-repo>`); o
 `--pod-root` não é necessário — o motor deriva a raiz do pod pelo path do `wf`.
 
 O `start` imprime `[start] run <run-id> → <caminho do state.json>`. **Guarde esse caminho**: todos os

package/template/.claude/rules/orchestration.md

@@ -121,7 +121,7 @@ Nasceu de **7 erros da mesma classe numa única sessão** (2026-08-06/07), todos
 
 Um aprendizado de ciclo (o que `.power-claude/cycle/learnings.md` tentava capturar por story, hoje morto e `gitignored`) vira regra ou comportamento duradouro por **curadoria manual do dono**: ele lê o aprendizado, decide que vale a pena reter, e o promove para um arquivo em `.claude/rules/*.md`. Não existe pipeline automático (`learnings.jsonl`, poda, consolidação, orçamento de admissão) — e a prova de que esse caminho já funciona é este próprio arquivo: `orchestration.md` nasceu assim, por curadoria, não por pipeline.
 
-**Por que não existe pipeline:** custo × volume não fecha conta. `.power-claude/cycle/learnings.md` acumulou 18 entradas em 4 meses antes de morrer — volume baixo demais para pagar o aparato que um pipeline exigiria (custo de memória por admissão, poda periódica, consolidação, orçamento de tokens). A arquitetura já está decidida e não é reaberta aqui: memória de papel é da **instância** (`second-brain/.power-claude/`), nunca do `template/` — o framework não acumula aprendizado de uma instalação específica.
+**Por que não existe pipeline:** custo × volume não fecha conta. `.power-claude/cycle/learnings.md` acumulou 18 entradas em 4 meses antes de morrer — volume baixo demais para pagar o aparato que um pipeline exigiria (custo de memória por admissão, poda periódica, consolidação, orçamento de tokens). A arquitetura já está decidida e não é reaberta aqui: memória de papel é da **instância** (`<sua-instância>/.power-claude/`), nunca do `template/` — o framework não acumula aprendizado de uma instalação específica.
 
 ## Referências
 

package/template/.claude/skills/pc-arena/SKILL.md

@@ -5,7 +5,7 @@ description: "Harness de comparação CEGA reutilizável: compara N≥2 braços
 
 # pc-arena — Harness de Comparação Cega (coordenadora)
 
-Skill irmã de `pc-run-pod`. Lá o **pod é dado** e o script é o motor; aqui o **experimento é dado** (N braços, rubrica, insumos) e o motor é **`scripts/arena.cjs`**, na granularidade "rodada de comparação cega". Generaliza o protocolo do benchmark 4-braços (`second-brain/docs/benchmark/PROTOCOLO-4-bracos.md`) para N braços quaisquer — não só 4, não só pod-vs-squad.
+Skill irmã de `pc-run-pod`. Lá o **pod é dado** e o script é o motor; aqui o **experimento é dado** (N braços, rubrica, insumos) e o motor é **`scripts/arena.cjs`**, na granularidade "rodada de comparação cega". Generaliza o protocolo do benchmark 4-braços para N braços quaisquer — não só 4, não só pod-vs-squad.
 
 **A cegueira é a premissa central** — um embaralhamento silenciosamente errado invalida o experimento inteiro. Por isso a lógica propensa-a-bug (permutação com uniquidade, mapa selado, reveal-gate, hash, tally, veredito) vive **em código testável**, não em prosa: `scripts/arena.cjs` (motor determinístico) + `scripts/arena.test.cjs` (regressão dos 2 bugs reais de embaralhamento que a operação MANUAL do benchmark cometeu). Esta skill é o **protocolo**; a máquina é do motor — do not fake green.
 
@@ -93,4 +93,4 @@ Emite: (1) tabela de revelação rótulo→braço por rodada; (2) scores pondera
 
 ## Referência
 
-`docs/adr/ADR-009-pc-arena-selagem-e-permutacao-em-motor.md` · motor `scripts/arena.cjs` + suíte `scripts/arena.test.cjs` · página de uso `docs/mecanismos/pc-arena.md` · protocolo-fonte `second-brain/docs/benchmark/PROTOCOLO-4-bracos.md` (+ `RELATORIO-FINAL.md`).
+`docs/adr/ADR-009-pc-arena-selagem-e-permutacao-em-motor.md` · motor `scripts/arena.cjs` + suíte `scripts/arena.test.cjs` · página de uso `docs/mecanismos/pc-arena.md`.

package/template/pods/hormozi-method/knowledge/growth-decision.md

@@ -1,6 +1,6 @@
 # Growth Decision — Mais, Melhor ou Novo
 
-> **Fonte:** destilado do squad legado `hormozi` (workflow de árvore de decisão estratégica), migração registrada em `docs/stories/epic-sf5-migracao-hormozi-rodada-final.md` (EPIC SF5, story SF5.5, `second-brain`). Metodologia: *$100M* / frameworks operacionais de escala, Alex Hormozi. Aplica o framework documentado; não encarna a pessoa.
+> **Fonte:** destilado do squad legado `hormozi` (workflow de árvore de decisão estratégica), migração registrada em `docs/stories/epic-sf5-migracao-hormozi-rodada-final.md` (EPIC SF5, story SF5.5). Metodologia: *$100M* / frameworks operacionais de escala, Alex Hormozi. Aplica o framework documentado; não encarna a pessoa.
 
 Decisão de **onde investir o próximo recurso de crescimento**. Evita o erro mais comum — fazer "novo" quando deveria fazer "mais" do que já funciona. Princípio: **Volume → Eficiência → Inovação, nesta ordem.**
 

package/template/pods/hormozi-method/knowledge/opportunity-screening.md

@@ -1,6 +1,6 @@
 # Opportunity Screening — gate PASS/FAIL antes de criar oferta
 
-> **Fonte:** destilado do squad legado `hormozi` (workflow de veto de oportunidade + checklists de validação de mercado e antipadrões), migração registrada em `docs/stories/epic-sf5-migracao-hormozi-rodada-final.md` (EPIC SF5, story SF5.5, `second-brain`). Metodologia: *$100M Offers*, Alex Hormozi (Cap. 4 — Starving Crowd; antipadrões estruturais). Aplica o framework documentado; não encarna a pessoa.
+> **Fonte:** destilado do squad legado `hormozi` (workflow de veto de oportunidade + checklists de validação de mercado e antipadrões), migração registrada em `docs/stories/epic-sf5-migracao-hormozi-rodada-final.md` (EPIC SF5, story SF5.5). Metodologia: *$100M Offers*, Alex Hormozi (Cap. 4 — Starving Crowd; antipadrões estruturais). Aplica o framework documentado; não encarna a pessoa.
 
 Gate obrigatório de **due-diligence de oportunidade**: valida um mercado/ideia de negócio ANTES de investir em qualquer oferta. Resultado é uma decisão **PASS/FAIL** justificada. Filosofia: "uma ótima oferta para um mercado ruim sempre falhará".
 

package/template/pods/squad-forge/knowledge/source-audit-rubric.yaml

@@ -7,7 +7,7 @@
 # E ouro ou bronze) e do agente + QA — nunca do validador (ADR-014/ADR-008).
 # Distincao: esta rubrica audita a ENTRADA; fidelity-rubric.yaml audita a SAIDA (SF7.1).
 #
-# Fonte: second-brain@docs/benchmark-4-bracos:docs/benchmark/ANEXO-A-processo-daniel-geracao-squads.md
+# Fonte: docs/benchmark/ANEXO-A-processo-daniel-geracao-squads.md (processo do dono para geracao de squads, destilado do benchmark 4-bracos)
 #   :12 — "Eu valido a materia-prima cognitiva... Meu foco sao os experts clonados: as fontes sao ouro?"
 #   :20 — "*source-audit + *curadoria-score — as fontes por tras de cada clone sao ouro (comentarios,
 #          entrevistas longas, stories, cases) ou bronze (palestra antiga, generico, terceiros)?