@luanpdd/kit-mcp 1.33.0 → 1.34.0

package/kit/hooks/kit-attribution-reminder.cjs

@@ -1,92 +1,92 @@
-#!/usr/bin/env node
-// hook-version: 1.30.5
-// kit-mcp · Kit Attribution Reminder (UserPromptSubmit)
-//
-// Injeta `additionalContext` no envelope do prompt do usuário com uma
-// diretiva ENXUTA: pedir 1 linha de atribuição no fim da resposta.
-//
-// v1.30.3 (#3): diretiva reduzida de ~50 linhas para ~7 — o bloco longo
-// anterior custava ~1,5 KB de ruído por prompt e treinava compliance
-// theater. Mantém a confirmação positiva ("kit foi usado?") com fração
-// do custo de contexto.
-// v1.30.4: a linha agora AGRUPA por tipo (agents/skills/commands/mcp) e
-// nomeia cada recurso — antes "<recursos usados>" era vago e escondia
-// quais agents/subagents rodaram.
-// v1.30.5: distinção explícita — rodar scripts/código do kit via `node`/Bash
-// NÃO é uso de MCP tool. Só conta `mcp` se a tool mcp__kit__* foi invocada
-// de fato. Corrige mis-atribuição ("mcp: kit" sem ter chamado a tool).
-//
-// Objetivo: feedback textual leve de uso real do kit-mcp.
-//
-// Pipeline: UserPromptSubmit hook → reads stdin envelope → writes JSON com
-// `{ continue: true, hookSpecificOutput: { hookEventName: "UserPromptSubmit",
-//    additionalContext: "<diretiva>" } }` → exit 0.
-//
-// SOFT failure: qualquer erro → exit 0 sem bloquear. Skip se
-// KIT_MCP_NO_ATTRIBUTION=1.
-//
-// Module format: CommonJS (.cjs) — compatível com qualquer setup Node.
-//
-// Enable em settings.json (project ou user):
-//   {
-//     "hooks": {
-//       "UserPromptSubmit": [{
-//         "matcher": "*",
-//         "hooks": [{
-//           "type": "command",
-//           "command": "node /abs/path/to/kit-attribution-reminder.cjs"
-//         }]
-//       }]
-//     }
-//   }
-
-'use strict';
-
-// Opt-out via env var
-if (process.env.KIT_MCP_NO_ATTRIBUTION === '1' || process.env.KIT_MCP_NO_ATTRIBUTION === 'true') {
-  process.exit(0);
-}
-
-const DIRECTIVE = [
-  '🔧 kit-mcp — termine a resposta com UMA linha, agrupando por tipo e',
-  'NOMEANDO cada recurso usado neste turno:',
-  '  "🔧 kit-mcp · agents: <nomes> · skills: <nomes> · commands: <nomes> · mcp: <tools>"',
-  'Conta SÓ o que você REALMENTE invocou neste turno:',
-  '• agents   = Task(subagent_type="…") com um agent do kit.',
-  '• skills   = skill do kit auto-triggada/consultada (supabase-*/legacy-*/…).',
-  '• commands = /slash-command do kit executado.',
-  '• mcp      = tool mcp__kit__* chamada de fato (a tool MCP em si).',
-  'NÃO conta — reporte "nenhum recurso usado" se só fez isto:',
-  '• Bash/Edit/Read/Write/Grep/Glob nativos.',
-  '• rodar scripts ou o código do servidor kit via `node`/Bash — mesmo',
-  '  sendo arquivos do kit, isso é Bash, NÃO é invocar a MCP tool.',
-  '• skills genéricas da Anthropic (anthropic-skills:*, engineering:*, …).',
-  'Nenhum recurso → "🔧 kit-mcp: nenhum recurso usado".',
-  'Disable: env KIT_MCP_NO_ATTRIBUTION=1.',
-].join('\n');
-
-let input = '';
-const stdinTimeout = setTimeout(() => process.exit(0), 3000);
-process.stdin.setEncoding('utf8');
-process.stdin.on('data', (chunk) => { input += chunk; });
-process.stdin.on('end', () => {
-  clearTimeout(stdinTimeout);
-  try {
-    // Aceita envelope vazio; só precisamos retornar o JSON com additionalContext.
-    JSON.parse(input || '{}');
-  } catch {
-    // Envelope inválido — não bloquear; sair sem inject.
-    process.exit(0);
-  }
-  const payload = JSON.stringify({
-    continue: true,
-    hookSpecificOutput: {
-      hookEventName: 'UserPromptSubmit',
-      additionalContext: DIRECTIVE,
-    },
-  });
-  // SEC-13-05 (category A): flush antes de exit
-  process.stdout.write(payload, () => process.exit(0));
-});
-
-process.stdin.on('error', () => process.exit(0));
+#!/usr/bin/env node
+// hook-version: 1.30.5
+// kit-mcp · Kit Attribution Reminder (UserPromptSubmit)
+//
+// Injeta `additionalContext` no envelope do prompt do usuário com uma
+// diretiva ENXUTA: pedir 1 linha de atribuição no fim da resposta.
+//
+// v1.30.3 (#3): diretiva reduzida de ~50 linhas para ~7 — o bloco longo
+// anterior custava ~1,5 KB de ruído por prompt e treinava compliance
+// theater. Mantém a confirmação positiva ("kit foi usado?") com fração
+// do custo de contexto.
+// v1.30.4: a linha agora AGRUPA por tipo (agents/skills/commands/mcp) e
+// nomeia cada recurso — antes "<recursos usados>" era vago e escondia
+// quais agents/subagents rodaram.
+// v1.30.5: distinção explícita — rodar scripts/código do kit via `node`/Bash
+// NÃO é uso de MCP tool. Só conta `mcp` se a tool mcp__kit__* foi invocada
+// de fato. Corrige mis-atribuição ("mcp: kit" sem ter chamado a tool).
+//
+// Objetivo: feedback textual leve de uso real do kit-mcp.
+//
+// Pipeline: UserPromptSubmit hook → reads stdin envelope → writes JSON com
+// `{ continue: true, hookSpecificOutput: { hookEventName: "UserPromptSubmit",
+//    additionalContext: "<diretiva>" } }` → exit 0.
+//
+// SOFT failure: qualquer erro → exit 0 sem bloquear. Skip se
+// KIT_MCP_NO_ATTRIBUTION=1.
+//
+// Module format: CommonJS (.cjs) — compatível com qualquer setup Node.
+//
+// Enable em settings.json (project ou user):
+//   {
+//     "hooks": {
+//       "UserPromptSubmit": [{
+//         "matcher": "*",
+//         "hooks": [{
+//           "type": "command",
+//           "command": "node /abs/path/to/kit-attribution-reminder.cjs"
+//         }]
+//       }]
+//     }
+//   }
+
+'use strict';
+
+// Opt-out via env var
+if (process.env.KIT_MCP_NO_ATTRIBUTION === '1' || process.env.KIT_MCP_NO_ATTRIBUTION === 'true') {
+  process.exit(0);
+}
+
+const DIRECTIVE = [
+  '🔧 kit-mcp — termine a resposta com UMA linha, agrupando por tipo e',
+  'NOMEANDO cada recurso usado neste turno:',
+  '  "🔧 kit-mcp · agents: <nomes> · skills: <nomes> · commands: <nomes> · mcp: <tools>"',
+  'Conta SÓ o que você REALMENTE invocou neste turno:',
+  '• agents   = Task(subagent_type="…") com um agent do kit.',
+  '• skills   = skill do kit auto-triggada/consultada (supabase-*/legacy-*/…).',
+  '• commands = /slash-command do kit executado.',
+  '• mcp      = tool mcp__kit__* chamada de fato (a tool MCP em si).',
+  'NÃO conta — reporte "nenhum recurso usado" se só fez isto:',
+  '• Bash/Edit/Read/Write/Grep/Glob nativos.',
+  '• rodar scripts ou o código do servidor kit via `node`/Bash — mesmo',
+  '  sendo arquivos do kit, isso é Bash, NÃO é invocar a MCP tool.',
+  '• skills genéricas da Anthropic (anthropic-skills:*, engineering:*, …).',
+  'Nenhum recurso → "🔧 kit-mcp: nenhum recurso usado".',
+  'Disable: env KIT_MCP_NO_ATTRIBUTION=1.',
+].join('\n');
+
+let input = '';
+const stdinTimeout = setTimeout(() => process.exit(0), 3000);
+process.stdin.setEncoding('utf8');
+process.stdin.on('data', (chunk) => { input += chunk; });
+process.stdin.on('end', () => {
+  clearTimeout(stdinTimeout);
+  try {
+    // Aceita envelope vazio; só precisamos retornar o JSON com additionalContext.
+    JSON.parse(input || '{}');
+  } catch {
+    // Envelope inválido — não bloquear; sair sem inject.
+    process.exit(0);
+  }
+  const payload = JSON.stringify({
+    continue: true,
+    hookSpecificOutput: {
+      hookEventName: 'UserPromptSubmit',
+      additionalContext: DIRECTIVE,
+    },
+  });
+  // SEC-13-05 (category A): flush antes de exit
+  process.stdout.write(payload, () => process.exit(0));
+});
+
+process.stdin.on('error', () => process.exit(0));

package/kit/hooks/kit-router.cjs

@@ -1,137 +1,137 @@
-#!/usr/bin/env node
-// hook-version: 1.30.4
-// kit-mcp · Kit Router (UserPromptSubmit)
-//
-// Lê o prompt do usuário, detecta domínio(s) canônico(s) por keyword e injeta
-// `additionalContext` com uma DIRETIVA FIRME de delegação: para trabalho
-// multi-passo do domínio, usar Task(subagent_type=...) em vez de improvisar
-// inline.
-//
-// Motivação: o kit tem 67 agents que quase nunca eram invocados — o modelo
-// resolvia tudo inline. Este hook faz o roteamento se materializar NO MOMENTO
-// DA DECISÃO (todo prompt relevante), que é o lever mais forte disponível no
-// sistema de hooks do Claude Code sem bloquear o prompt.
-//
-// Pipeline: UserPromptSubmit → lê stdin envelope → casa keywords no campo
-// `prompt` → escreve JSON { continue:true, hookSpecificOutput:{ ...,
-// additionalContext } } → exit 0. Sem match → exit 0 sem injetar (prompt limpo).
-//
-// SOFT failure: qualquer erro → exit 0 sem bloquear. Skip se KIT_MCP_NO_ROUTER=1.
-// CommonJS (.cjs) — compatível com qualquer setup Node.
-
-'use strict';
-
-if (process.env.KIT_MCP_NO_ROUTER === '1' || process.env.KIT_MCP_NO_ROUTER === 'true') {
-  process.exit(0);
-}
-
-// Tabela domínio → { keywords, entrypoint (suíte/commands), agents canônicos }.
-// keywords são casadas como substring no prompt em lowercase.
-const DOMAINS = [
-  {
-    name: 'Supabase',
-    keywords: ['supabase', 'rls', 'row level security', 'edge function', 'pgvector',
-      'custom claim', 'postgres role', 'realtime', ' migration', 'migração', 'supavisor'],
-    entrypoint: '/supabase',
-    agents: ['supabase-architect', 'supabase-rls-writer', 'supabase-migration-writer',
-      'supabase-edge-fn-writer'],
-  },
-  {
-    name: 'Multi-tenant SaaS',
-    keywords: ['multi-tenant', 'multi tenant', 'multitenant', 'b2b saas', 'tenant',
-      'rbac', 'super-admin', 'super admin', 'org invite', 'convite de membro', 'lgpd'],
-    entrypoint: '/multi-tenant',
-    agents: ['b2b-saas-architect', 'multi-tenant-rls-writer', 'org-onboarding-implementer',
-      'invite-flow-implementer'],
-  },
-  {
-    name: 'Legacy / refactor',
-    keywords: ['refactor', 'refatorar', 'código legado', 'codigo legado', 'legacy',
-      'characterization', 'caracterização', 'seam', 'sem testes', 'sem teste'],
-    entrypoint: '/legacy',
-    agents: ['seam-finder', 'legacy-characterizer', 'refactor-safety-auditor'],
-  },
-  {
-    name: 'Observabilidade',
-    keywords: ['observability', 'observabilidade', 'slo', 'golden signal', 'tracing',
-      'telemetr', 'burn rate', 'opentelemetry', 'otel', 'error budget'],
-    entrypoint: '/observabilidade',
-    agents: ['observability-instrumenter', 'golden-signals-instrumenter', 'slo-engineer'],
-  },
-  {
-    name: 'SRE',
-    keywords: ['postmortem', 'post-mortem', 'post mortem', 'toil', ' prr',
-      'production readiness', 'incident', 'incidente', 'release pipeline', 'runbook'],
-    entrypoint: '/sre',
-    agents: ['postmortem-writer', 'toil-auditor', 'prr-conductor', 'incident-investigator'],
-  },
-  {
-    name: 'Sistemas distribuídos (DDIA)',
-    keywords: ['consistency', 'consistência', 'replication', 'replicação', 'replica',
-      'schema evolution', 'evolução de schema', 'cdc', 'hot tenant', 'tenant quente'],
-    entrypoint: '/dados-distribuidos',
-    agents: ['auditor-consistencia-isolamento', 'detector-tenant-quente',
-      'validador-evolucao-schema'],
-  },
-  {
-    name: 'Workflow de fases / milestone',
-    keywords: ['planejar fase', 'executar fase', 'milestone', 'marco', 'roadmap',
-      'nova fase', 'plano de fase'],
-    entrypoint: '/planejar-fase, /executar-fase',
-    agents: ['planner', 'executor', 'verifier'],
-  },
-];
-
-function buildDirective(matched) {
-  const lines = [
-    '🧭 kit-mcp router — o prompt casa ' +
-      (matched.length === 1 ? 'o domínio canônico' : 'domínios canônicos') + ':',
-  ];
-  for (const d of matched) {
-    lines.push(
-      `• ${d.name} → entrypoint ${d.entrypoint} · agents: ${d.agents.join(', ')}`,
-    );
-  }
-  lines.push(
-    'REGRA: para trabalho multi-passo destes domínios, DELEGUE via',
-    'Task(subagent_type="<agent>") em vez de implementar inline. Não improvise',
-    'o que um agent canônico já cobre — o valor do kit ESTÁ nos agents.',
-    'Exceção: ação trivial de 1 passo (rename, fix de 1 linha, ajuste de texto)',
-    '→ resolva inline. Disable: env KIT_MCP_NO_ROUTER=1.',
-  );
-  return lines.join('\n');
-}
-
-let input = '';
-const stdinTimeout = setTimeout(() => process.exit(0), 3000);
-process.stdin.setEncoding('utf8');
-process.stdin.on('data', (chunk) => { input += chunk; });
-process.stdin.on('end', () => {
-  clearTimeout(stdinTimeout);
-  let envelope;
-  try {
-    envelope = JSON.parse(input || '{}');
-  } catch {
-    process.exit(0); // envelope inválido — não bloquear
-  }
-  // O campo do prompt varia entre versões — aceitar os nomes plausíveis.
-  const prompt = String(
-    envelope.prompt || envelope.user_prompt || envelope.text || '',
-  ).toLowerCase();
-  if (!prompt) process.exit(0);
-
-  const matched = DOMAINS.filter((d) => d.keywords.some((k) => prompt.includes(k)));
-  if (matched.length === 0) process.exit(0); // sem domínio — prompt limpo
-
-  const payload = JSON.stringify({
-    continue: true,
-    hookSpecificOutput: {
-      hookEventName: 'UserPromptSubmit',
-      additionalContext: buildDirective(matched),
-    },
-  });
-  // flush antes de exit
-  process.stdout.write(payload, () => process.exit(0));
-});
-
-process.stdin.on('error', () => process.exit(0));
+#!/usr/bin/env node
+// hook-version: 1.30.4
+// kit-mcp · Kit Router (UserPromptSubmit)
+//
+// Lê o prompt do usuário, detecta domínio(s) canônico(s) por keyword e injeta
+// `additionalContext` com uma DIRETIVA FIRME de delegação: para trabalho
+// multi-passo do domínio, usar Task(subagent_type=...) em vez de improvisar
+// inline.
+//
+// Motivação: o kit tem 67 agents que quase nunca eram invocados — o modelo
+// resolvia tudo inline. Este hook faz o roteamento se materializar NO MOMENTO
+// DA DECISÃO (todo prompt relevante), que é o lever mais forte disponível no
+// sistema de hooks do Claude Code sem bloquear o prompt.
+//
+// Pipeline: UserPromptSubmit → lê stdin envelope → casa keywords no campo
+// `prompt` → escreve JSON { continue:true, hookSpecificOutput:{ ...,
+// additionalContext } } → exit 0. Sem match → exit 0 sem injetar (prompt limpo).
+//
+// SOFT failure: qualquer erro → exit 0 sem bloquear. Skip se KIT_MCP_NO_ROUTER=1.
+// CommonJS (.cjs) — compatível com qualquer setup Node.
+
+'use strict';
+
+if (process.env.KIT_MCP_NO_ROUTER === '1' || process.env.KIT_MCP_NO_ROUTER === 'true') {
+  process.exit(0);
+}
+
+// Tabela domínio → { keywords, entrypoint (suíte/commands), agents canônicos }.
+// keywords são casadas como substring no prompt em lowercase.
+const DOMAINS = [
+  {
+    name: 'Supabase',
+    keywords: ['supabase', 'rls', 'row level security', 'edge function', 'pgvector',
+      'custom claim', 'postgres role', 'realtime', ' migration', 'migração', 'supavisor'],
+    entrypoint: '/supabase',
+    agents: ['supabase-architect', 'supabase-rls-writer', 'supabase-migration-writer',
+      'supabase-edge-fn-writer'],
+  },
+  {
+    name: 'Multi-tenant SaaS',
+    keywords: ['multi-tenant', 'multi tenant', 'multitenant', 'b2b saas', 'tenant',
+      'rbac', 'super-admin', 'super admin', 'org invite', 'convite de membro', 'lgpd'],
+    entrypoint: '/multi-tenant',
+    agents: ['b2b-saas-architect', 'multi-tenant-rls-writer', 'org-onboarding-implementer',
+      'invite-flow-implementer'],
+  },
+  {
+    name: 'Legacy / refactor',
+    keywords: ['refactor', 'refatorar', 'código legado', 'codigo legado', 'legacy',
+      'characterization', 'caracterização', 'seam', 'sem testes', 'sem teste'],
+    entrypoint: '/legacy',
+    agents: ['seam-finder', 'legacy-characterizer', 'refactor-safety-auditor'],
+  },
+  {
+    name: 'Observabilidade',
+    keywords: ['observability', 'observabilidade', 'slo', 'golden signal', 'tracing',
+      'telemetr', 'burn rate', 'opentelemetry', 'otel', 'error budget'],
+    entrypoint: '/observabilidade',
+    agents: ['observability-instrumenter', 'golden-signals-instrumenter', 'slo-engineer'],
+  },
+  {
+    name: 'SRE',
+    keywords: ['postmortem', 'post-mortem', 'post mortem', 'toil', ' prr',
+      'production readiness', 'incident', 'incidente', 'release pipeline', 'runbook'],
+    entrypoint: '/sre',
+    agents: ['postmortem-writer', 'toil-auditor', 'prr-conductor', 'incident-investigator'],
+  },
+  {
+    name: 'Sistemas distribuídos (DDIA)',
+    keywords: ['consistency', 'consistência', 'replication', 'replicação', 'replica',
+      'schema evolution', 'evolução de schema', 'cdc', 'hot tenant', 'tenant quente'],
+    entrypoint: '/dados-distribuidos',
+    agents: ['auditor-consistencia-isolamento', 'detector-tenant-quente',
+      'validador-evolucao-schema'],
+  },
+  {
+    name: 'Workflow de fases / milestone',
+    keywords: ['planejar fase', 'executar fase', 'milestone', 'marco', 'roadmap',
+      'nova fase', 'plano de fase'],
+    entrypoint: '/planejar-fase, /executar-fase',
+    agents: ['planner', 'executor', 'verifier'],
+  },
+];
+
+function buildDirective(matched) {
+  const lines = [
+    '🧭 kit-mcp router — o prompt casa ' +
+      (matched.length === 1 ? 'o domínio canônico' : 'domínios canônicos') + ':',
+  ];
+  for (const d of matched) {
+    lines.push(
+      `• ${d.name} → entrypoint ${d.entrypoint} · agents: ${d.agents.join(', ')}`,
+    );
+  }
+  lines.push(
+    'REGRA: para trabalho multi-passo destes domínios, DELEGUE via',
+    'Task(subagent_type="<agent>") em vez de implementar inline. Não improvise',
+    'o que um agent canônico já cobre — o valor do kit ESTÁ nos agents.',
+    'Exceção: ação trivial de 1 passo (rename, fix de 1 linha, ajuste de texto)',
+    '→ resolva inline. Disable: env KIT_MCP_NO_ROUTER=1.',
+  );
+  return lines.join('\n');
+}
+
+let input = '';
+const stdinTimeout = setTimeout(() => process.exit(0), 3000);
+process.stdin.setEncoding('utf8');
+process.stdin.on('data', (chunk) => { input += chunk; });
+process.stdin.on('end', () => {
+  clearTimeout(stdinTimeout);
+  let envelope;
+  try {
+    envelope = JSON.parse(input || '{}');
+  } catch {
+    process.exit(0); // envelope inválido — não bloquear
+  }
+  // O campo do prompt varia entre versões — aceitar os nomes plausíveis.
+  const prompt = String(
+    envelope.prompt || envelope.user_prompt || envelope.text || '',
+  ).toLowerCase();
+  if (!prompt) process.exit(0);
+
+  const matched = DOMAINS.filter((d) => d.keywords.some((k) => prompt.includes(k)));
+  if (matched.length === 0) process.exit(0); // sem domínio — prompt limpo
+
+  const payload = JSON.stringify({
+    continue: true,
+    hookSpecificOutput: {
+      hookEventName: 'UserPromptSubmit',
+      additionalContext: buildDirective(matched),
+    },
+  });
+  // flush antes de exit
+  process.stdout.write(payload, () => process.exit(0));
+});
+
+process.stdin.on('error', () => process.exit(0));