predators-protocol 0.3.0-beta.0

package/LICENSE

@@ -0,0 +1,22 @@
+PREDATORS PROTOCOL · PROPRIETARY LICENSE
+
+Copyright (c) 2026 Alex Gonzaga (Tubarão-Apex)
+All rights reserved.
+
+This software and associated documentation files (the "Software") are the
+proprietary and confidential property of Alex Gonzaga. Unauthorized copying,
+distribution, modification, public display, public performance, or use of
+this Software, via any medium, is strictly prohibited without the express
+written permission of the copyright holder.
+
+The receipt or possession of this Software does not convey any rights to
+reproduce, disclose, or distribute its contents, or to manufacture, use,
+or sell anything that it may describe, in whole or in part.
+
+PREDATORS PROTOCOL is a trademark of Alex Gonzaga.
+
+For licensing inquiries, contact: alex@predators-protocol.dev
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.

package/README.md

@@ -0,0 +1,104 @@
+# Predators Protocol
+
+> Multi-agent predatory framework · 63 predators in 10 layers · canon Lei #14 PERFEITO OU FIX-GERAL
+
+**Proprietary software** · Copyright (c) 2026 Alex Gonzaga (Tubarão-Apex). See [LICENSE](./LICENSE) for terms.
+
+## Install
+
+```bash
+# One-off CLI invocation (no install)
+npx predators-protocol help
+
+# Global install
+npm i -g predators-protocol
+predators-protocol help
+```
+
+## Quickstart
+
+```bash
+# Status + bundle integrity check
+npx predators-protocol status
+
+# Show 63 predators across 10 layers
+npx predators-protocol list-predators
+
+# List canon workflows
+npx predators-protocol list-workflows
+
+# State machine: 6 workflow states
+npx predators-protocol workflow-states
+
+# State machine: 5 story states
+npx predators-protocol story-states
+
+# 7 context layers L0-L6 (Lei do Sangue → user input)
+npx predators-protocol layers-list
+
+# 4 golden signals canon M1 APM
+npx predators-protocol metrics-list
+
+# Benchmark protocol scipy.stats N=180 p<0.05
+npx predators-protocol benchmark-info
+
+# Help
+npx predators-protocol help
+```
+
+## Commands requiring Python 3.11+
+
+Two commands invoke the bundled Python canon · install Python ≥ 3.11 and dependencies:
+
+```bash
+# Required Python deps for pre-action
+pip install structlog
+```
+
+```bash
+# Validate canon IAC + canon-docs presence in bundle
+npx predators-protocol validate
+
+# Simulate dispatcher middleware pre-action canon
+npx predators-protocol pre-action tubarao-branco
+```
+
+The CLI auto-detects Python in this order: `PREDATORS_PYTHON` env var → repo `.venv/` (dev mode) → `python3` → `python`.
+
+## What's in the bundle
+
+Each install includes:
+
+- `docs/SYNAPSE.md` · canon do tecido nervoso (5 garantias)
+- `docs/CANON/INTEGRA-PROD-*.md` · 5 canon-docs provisioning
+- `core/synapse_overlay/` · 4 Python files dispatcher middleware canon
+- `scripts/canon_provisioning_validation.py` · validation script
+- `infra/` · IAC files (Docker compose · Terraform · SQL migrations · Infisical · Grafana)
+
+## Canon governance
+
+This CLI is published under the canon laws of the Predators Protocol:
+
+- **Lei #1 do Sangue** (immutable) · zero credentials in code · Tubarão-branco veto
+- **Lei #4 Synapse** · 5 garantias (preservação contexto, integridade decisão, agent authority, rastro neural, realimentação)
+- **Lei #14 PERFEITO OU FIX-GERAL** · BINARY veredict canon
+- **Diretrizes Comunicação 4** (2026-05-24) · Lei do Tom · Autonomia Sequencial · PASSO 0 EVERY · Separação canon-doc/comunicação
+
+## Honest UPFRONT (Lei #11)
+
+This is a **fase BETA** scope:
+
+- Read-only query commands for canon state machines, middleware, metrics
+- `pre-action` and `validate` require Python 3.11+ in the host environment
+- Workflow execution + project init are roadmap (require Postgres provisioning)
+- Real credential provisioning is Apex T7 direct (never via CLI)
+
+## Links
+
+- Homepage: https://github.com/SharkLEx/predators-protocol
+- Issues: https://github.com/SharkLEx/predators-protocol/issues
+- License: SEE LICENSE IN LICENSE (Proprietary · Alex Gonzaga)
+
+---
+
+*"Eu rugo no monte, mas só piso quando o terreno está limpo."* · Leão · Apex T5

package/bin/predators-cli.js

@@ -0,0 +1,490 @@
+#!/usr/bin/env node
+// packages/predators-protocol/bin/predators-cli.js
+// NPX CLI canon Predators Protocol · 11 comandos fase BETA cumulativa
+// Lei #11 honest UPFRONT · Lei #14 PERFEITO OU FIX-GERAL · Lei #13 Pureza canon
+
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+const { spawnSync } = require("child_process");
+
+const CLI_VERSION_CANON = "predators-cli-canon-0.3.0-beta.0-bundle-slim-sync-2026-05-24";
+
+const PACKAGE_ROOT = path.resolve(__dirname, "..");
+const BUNDLE_DIR = path.join(PACKAGE_ROOT, "bundle");
+const LIB_DIR = path.join(PACKAGE_ROOT, "lib");
+
+// UX layer (additive · Lei #4 byte-canon preserve · 11 comandos existentes inalterados)
+let uxLib = null;
+function loadUxLib() {
+  if (uxLib) return uxLib;
+  try {
+    uxLib = {
+      splash: require(path.join(LIB_DIR, "splash.js")),
+      config: require(path.join(LIB_DIR, "config.js")),
+      audio: require(path.join(LIB_DIR, "audio.js")),
+      colors: require(path.join(LIB_DIR, "colors.js")),
+      asciiArt: require(path.join(LIB_DIR, "ascii-art.js")),
+      spinners: require(path.join(LIB_DIR, "spinners.js")),
+    };
+    return uxLib;
+  } catch (err) {
+    return null;
+  }
+}
+
+function bundlePath(relPath) {
+  return path.join(BUNDLE_DIR, relPath);
+}
+
+function detectPythonCanon() {
+  // Priority: PREDATORS_PYTHON env override → repo .venv (if in dev) → python3 → python
+  const candidates = [];
+
+  if (process.env.PREDATORS_PYTHON && fs.existsSync(process.env.PREDATORS_PYTHON)) {
+    candidates.push(process.env.PREDATORS_PYTHON);
+  }
+
+  // Dev mode: if invoked from within Predators repo (next to .venv)
+  const devVenvWin = path.resolve(PACKAGE_ROOT, "..", "..", ".venv", "Scripts", "python.exe");
+  const devVenvUnix = path.resolve(PACKAGE_ROOT, "..", "..", ".venv", "bin", "python");
+  if (fs.existsSync(devVenvWin)) candidates.push(devVenvWin);
+  if (fs.existsSync(devVenvUnix)) candidates.push(devVenvUnix);
+
+  // System python
+  for (const cmd of ["python3", "python"]) {
+    const probe = spawnSync(cmd, ["--version"], { encoding: "utf8" });
+    if (probe.status === 0) {
+      candidates.push(cmd);
+      break;
+    }
+  }
+
+  return candidates.length > 0 ? candidates[0] : null;
+}
+
+function printHelpCanon() {
+  console.error(`
+predators-cli · canon Predators NPX CLI 0.3.0-beta.0 (Lei #14 PERFEITO OU FIX-GERAL)
+
+USO:
+  npx predators-protocol <comando>
+
+COMANDOS canon vigentes (13 comandos):
+
+  -- fase 1 (introspecção · 3 comandos) --
+  version           Exibe versão canon
+  status            Estado atual canon · bundle integrity check
+  list-predators    Lista 63 predadores frota canon vigente
+  list-workflows    Lista 4 workflows canon (caca-sistematica · pacto-cyber-squad · pipeline-fenix · saneamento-brownfield)
+
+  -- fase BETA (state machines · 5 comandos) --
+  workflow-states   Lista 6 WorkflowStateCanon (PENDING/SCHEDULED/RUNNING/COMPLETED/FAILED/PAUSED)
+  story-states      Lista 5 StoryStateCanon (DRAFT/REFINEMENT/READY/IN_PROGRESS/DONE)
+  layers-list       Lista 7 ContextLayerCanon L0-L6 (Lei do Sangue → user input)
+  benchmark-info    Mostra benchmark scipy protocol canon (N=180 p<0.05)
+  metrics-list      Lista 4 golden signals canon M1 APM (latency + traffic + errors + saturation)
+
+  -- fase UX (additive · Lei #4 byte-canon preserve · 4 comandos) --
+  init              Splash cinematográfico primeira-conexão · welcome message
+  config            Preferências user (theme · audio · splash)
+  show              Renderiza ASCII art predator card OR The Eye logo
+  sync              Sincroniza canon files (predators/ + docs/ + .claude/ + CLAUDE.md) do bundle NPX para CWD
+
+  help              Exibe esta mensagem
+
+Lei #11 honest UPFRONT 0.3.0-beta.0 cumulativa:
+  · Bundle slim · 143 files · 63 predadores + canon docs + 7 skills · ZERO infra leak audit (Lei #1 reign)
+  · sync command requer CWD contendo predators/ OU init flag · pattern canon partner-bundle
+  · Comandos removidos vs 0.2.0-beta.0: validate (lia infra) + pre-action (lia synapse_overlay) · ambos infra-leak
+  · Workflow execution + project init scope futuro (requer Postgres provisioning Apex T7)
+`);
+}
+
+function printVersionCanon() {
+  console.log(CLI_VERSION_CANON);
+}
+
+function printStatusCanon() {
+  const synapseMd = bundlePath("docs/SYNAPSE.md");
+  const encarnacaoMd = bundlePath("docs/ENCARNACAO.md");
+  const claudeMd = bundlePath("CLAUDE.md");
+  const predatorsDir = bundlePath("predators");
+  const skillsDir = bundlePath(".claude/commands");
+  let predatorCount = 0;
+  if (fs.existsSync(predatorsDir)) {
+    const walk = (dir) => {
+      for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
+        const p = path.join(dir, e.name);
+        if (e.isDirectory()) walk(p);
+        else if (e.name === "predator.json") predatorCount++;
+      }
+    };
+    walk(predatorsDir);
+  }
+  console.log("canon Predators status:");
+  console.log(`  CLI version: ${CLI_VERSION_CANON}`);
+  console.log(`  bundle root: ${BUNDLE_DIR}`);
+  console.log(`  CLAUDE.md: ${fs.existsSync(claudeMd) ? "PRESENT" : "MISSING"}`);
+  console.log(`  SYNAPSE.md: ${fs.existsSync(synapseMd) ? "PRESENT" : "MISSING"}`);
+  console.log(`  ENCARNACAO.md: ${fs.existsSync(encarnacaoMd) ? "PRESENT" : "MISSING"}`);
+  console.log(`  predators canon: ${predatorCount}/63 byte-presente`);
+  console.log(`  .claude/commands/: ${fs.existsSync(skillsDir) ? "PRESENT" : "MISSING"}`);
+  console.log(`  Lei #14 canon: PERFEITO OU FIX-GERAL ratificada constitucional`);
+  console.log(`  Lei #1 reign: bundle slim · ZERO infra leak audit (0.3.0-beta.0)`);
+  console.log(`  Diretrizes 4 (2026-05-24): Lei do Tom · Autonomia Sequencial · PASSO 0 EVERY · Separação canon-doc/comunicação`);
+}
+
+function listPredatorsCanon() {
+  console.log("63 predadores frota canon vigente pós-F3 Tucano-toco:");
+  console.log("  apex:       4 (Águia + Leão + Orca + Tigre-siberiano)");
+  console.log("  hunter:     5 (Tubarão-branco JUIZ FINAL Art. 14 + Escorpião + Hiena + Crocodilo + Piranha)");
+  console.log("  builder:    9 (Jaguar + Tatu-bola + Coruja + Pirarucu + Lince + Polvo + 3)");
+  console.log("  designer:   7 (Borboleta-azul + Tucano-toco + 5)");
+  console.log("  copy:       6 (Serpente-coral + 5)");
+  console.log("  intel:      8 (Lobo-solitário + Tarântula + Jiboia + 5)");
+  console.log("  governance: 6");
+  console.log("  growth:     6");
+  console.log("  web3:       6 (Medusa + 5)");
+  console.log("  meta:       6 (Dragão-ancestral + Elefante + Fênix + Camaleão + Serpente + 1)");
+}
+
+function listWorkflowsCanon() {
+  console.log("4 workflows canon Predators (Lei #13 Pureza):");
+  console.log("  - caca-sistematica");
+  console.log("  - pacto-cyber-squad");
+  console.log("  - pipeline-fenix");
+  console.log("  - saneamento-brownfield");
+}
+
+function listWorkflowStatesCanon() {
+  console.log("6 WorkflowStateCanon canon Predators (D2 ETAPA 2 state machine):");
+  console.log("  PENDING     · workflow definição cravada · zero execução");
+  console.log("  SCHEDULED   · próxima execução planejada · cron canon");
+  console.log("  RUNNING     · steps em execução runtime");
+  console.log("  COMPLETED   · todos steps OK · success path");
+  console.log("  FAILED      · step falhou · rollback canon");
+  console.log("  PAUSED      · humano interrompeu · retomar manual");
+  console.log("");
+  console.log("7 transições válidas canon (Lei #4 reign state machine):");
+  console.log("  PENDING → SCHEDULED · SCHEDULED → RUNNING · RUNNING → COMPLETED");
+  console.log("  RUNNING → FAILED · RUNNING → PAUSED · PAUSED → RUNNING · FAILED → PENDING");
+}
+
+function listStoryStatesCanon() {
+  console.log("5 StoryStateCanon canon Predators (D3 ETAPA 3 state machine):");
+  console.log("  DRAFT       · criação inicial · briefing parcial");
+  console.log("  REFINEMENT  · briefing completo · Águia preside refinamento");
+  console.log("  READY       · predator owner identificado · scope clear");
+  console.log("  IN_PROGRESS · predator encarnado executando");
+  console.log("  DONE        · 5 garantias entregues · audit Tubarão PASS");
+  console.log("");
+  console.log("7 transições válidas canon:");
+  console.log("  DRAFT → REFINEMENT → READY → IN_PROGRESS → DONE (caminho canônico)");
+  console.log("  REFINEMENT/READY/IN_PROGRESS → DRAFT (rejeição com feedback)");
+}
+
+function listLayersCanon() {
+  console.log("7 ContextLayerCanon L0-L6 canon Predators (D5 ETAPA 1 runtime middleware):");
+  console.log("  L0 LEI_DO_SANGUE_ART_1            · CRITICAL_imutavel    priority 1000");
+  console.log("  L1 LEI_4_SYNAPSE_5_GARANTIAS      · CRITICAL_reign       priority 900");
+  console.log("  L2 5_IMUTAVEIS_BYTE_PRESERVED     · CRITICAL_byte_preserved priority 800");
+  console.log("  L3 14_LEIS_CANON_VIGENTES         · ALTA_vigente         priority 600");
+  console.log("  L4 PREDATOR_ENCARNADO_CONSTITUTION · ALTA_encarnacao     priority 500");
+  console.log("  L5 TASK_ESPECIFICA_CONTEXTO       · MEDIA_task           priority 300");
+  console.log("  L6 USER_PROMPT_INPUT              · INFO_user_input      priority 100");
+  console.log("");
+  console.log("L0+L1+L2 CRITICAL mandatory · Lei #14 BINARY FIX-GERAL trigger se ausentes");
+}
+
+function showBenchmarkInfoCanon() {
+  console.log("Benchmark canon Predators · scipy.stats N=180 p<0.05 protocol:");
+  console.log("");
+  console.log("  dimensions canon (6):");
+  console.log("    D5_context_layers_L0_L6");
+  console.log("    D2_workflows_engine");
+  console.log("    D3_stories_lifecycle");
+  console.log("    D4_multi_project_filesystem");
+  console.log("    D1_mcp_consuming");
+  console.log("    D6_dispatcher_integration");
+  console.log("");
+  console.log("  parâmetros estatísticos canon:");
+  console.log("    sample size per dimension: 30");
+  console.log("    total samples N: 180");
+  console.log("    p-value threshold: < 0.05");
+  console.log("    confidence interval: 95%");
+  console.log("");
+  console.log("  ttest_ind canon próprio Lei #13 Pureza (sem scipy hard-dep)");
+  console.log("");
+  console.log("Lei #11 honest UPFRONT: execução real depende provisioning Apex T7");
+}
+
+function listGoldenSignalsCanon() {
+  console.log("4 Golden Signals canon M1 APM Predators (B2 ONDA PRIORIDADES):");
+  console.log("  latency_milliseconds  · CanonMetricHistogram (p50/p95/p99 via percentile_canon)");
+  console.log("  traffic_total         · CanonMetricCounter");
+  console.log("  errors_total          · CanonMetricCounter");
+  console.log("  saturation_active     · CanonMetricGauge");
+  console.log("");
+  console.log("5 dimensões instrumentadas canon:");
+  console.log("  D1_mcp_consuming · D2_workflows_engine · D3_stories_lifecycle · D4_multi_project_filesystem · D5_context_layers_middleware");
+  console.log("");
+  console.log("Lei #13 Pureza: metrics canon próprio · duck-type prometheus_client (sem hard-dep externa)");
+}
+
+// ──────────────────────────────────────────────────────────────────────
+// UX layer commands (additive · Lei #4 byte-canon preserve)
+// ──────────────────────────────────────────────────────────────────────
+
+async function runInitCommand() {
+  const ux = loadUxLib();
+  if (!ux) {
+    console.error("UX layer não-disponível neste pacote.");
+    process.exit(1);
+  }
+  const args = process.argv.slice(3);
+  const forceFlag = args.includes("--force") || args.includes("-f");
+  const minimalFlag = args.includes("--minimal") || args.includes("-m");
+  await ux.splash.runInitSplash({ force: forceFlag, minimal: minimalFlag });
+}
+
+function runConfigCommand() {
+  const ux = loadUxLib();
+  if (!ux) {
+    console.error("UX layer não-disponível neste pacote.");
+    process.exit(1);
+  }
+  const subcommand = process.argv[3] || "show";
+  const arg = process.argv[4];
+
+  if (subcommand === "show" || subcommand === "status") {
+    const cfg = ux.config.readConfig();
+    console.log("Predators Protocol · user config");
+    console.log(`  path: ${ux.config.getConfigPath()}`);
+    console.log(`  theme: ${cfg.theme}`);
+    console.log(`  splash.enabled: ${cfg.splash.enabled}`);
+    console.log(`  audio.enabled: ${cfg.audio.enabled}`);
+    console.log(`  firstConnectionAt: ${cfg.firstConnectionAt || "(never)"}`);
+    console.log(`  lastConnectionAt: ${cfg.lastConnectionAt || "(never)"}`);
+    return;
+  }
+  if (subcommand === "theme") {
+    if (!arg) {
+      console.log(`Current theme: ${ux.config.getTheme()}`);
+      console.log("Available: default, dark, light, monochrome");
+      return;
+    }
+    const result = ux.config.setTheme(arg);
+    if (result) {
+      console.log(`Theme set: ${arg}`);
+    } else {
+      console.error(`Invalid theme: ${arg} · available: default, dark, light, monochrome`);
+      process.exit(1);
+    }
+    return;
+  }
+  if (subcommand === "audio") {
+    if (arg === "--enable" || arg === "on") {
+      ux.config.setAudioEnabled(true);
+      console.log("Audio: enabled · arquivos .mp3 pendentes Fênix audio designer (Lei #11 honest UPFRONT)");
+      return;
+    }
+    if (arg === "--disable" || arg === "off") {
+      ux.config.setAudioEnabled(false);
+      console.log("Audio: disabled");
+      return;
+    }
+    if (arg === "--status" || !arg) {
+      const status = ux.audio.getStatusReport();
+      console.log("Audio status canon:");
+      console.log(`  enabled: ${status.enabled}`);
+      console.log(`  platform: ${status.platform} (WSL: ${status.is_wsl})`);
+      console.log(`  player_available: ${status.player_available} (${status.player_cmd || "none"})`);
+      console.log(`  ${status.canon_note}`);
+      console.log("  signatures canon (pendentes Fênix Protocol):");
+      for (const s of status.sounds) {
+        console.log(`    · ${s.name} - ${s.description} (file: ${s.file_present ? "PRESENT" : "PENDENTE"})`);
+      }
+      return;
+    }
+  }
+  console.error(`Config subcommand desconhecido: ${subcommand}`);
+  console.error("Available: show · theme [default|dark|light|monochrome] · audio [--enable|--disable|--status]");
+  process.exit(1);
+}
+
+function runShowCommand() {
+  const ux = loadUxLib();
+  if (!ux) {
+    console.error("UX layer não-disponível neste pacote.");
+    process.exit(1);
+  }
+  const target = process.argv[3] || "eye";
+  const theme = ux.config.getTheme();
+
+  if (target === "eye" || target === "logo") {
+    console.log(ux.asciiArt.renderEye(theme));
+    return;
+  }
+  if (target === "banner") {
+    console.log(ux.asciiArt.renderHeroBanner(theme));
+    return;
+  }
+  if (target === "list") {
+    console.log("Predator cards canon vigentes:");
+    for (const id of ux.asciiArt.listPredatorsWithCards()) {
+      console.log(`  · ${id}`);
+    }
+    return;
+  }
+  const card = ux.asciiArt.renderPredatorCard(target, theme);
+  if (!card) {
+    console.error(`Predator card não-disponível: ${target}`);
+    console.error("Disponíveis: " + ux.asciiArt.listPredatorsWithCards().join(", "));
+    console.error("Outros targets: eye | logo | banner | list");
+    process.exit(1);
+  }
+  console.log(card);
+}
+
+// ──────────────────────────────────────────────────────────────────────
+// sync command · canon files refresh CWD from bundle (0.3.0-beta.0)
+// ──────────────────────────────────────────────────────────────────────
+
+function copyDirRecursive(src, dst) {
+  if (!fs.existsSync(src)) return { copied: 0, skipped: 0 };
+  fs.mkdirSync(dst, { recursive: true });
+  let copied = 0;
+  let skipped = 0;
+  for (const e of fs.readdirSync(src, { withFileTypes: true })) {
+    const s = path.join(src, e.name);
+    const d = path.join(dst, e.name);
+    if (e.isDirectory()) {
+      const r = copyDirRecursive(s, d);
+      copied += r.copied;
+      skipped += r.skipped;
+    } else {
+      fs.copyFileSync(s, d);
+      copied++;
+    }
+  }
+  return { copied, skipped };
+}
+
+function backupExistingPath(target) {
+  if (!fs.existsSync(target)) return null;
+  const ts = new Date().toISOString().replace(/[:.]/g, "-");
+  const backup = `${target}.backup-${ts}`;
+  fs.renameSync(target, backup);
+  return backup;
+}
+
+function runSyncCommand() {
+  const args = process.argv.slice(3);
+  const dryRun = args.includes("--dry-run");
+  const force = args.includes("--force") || args.includes("-f");
+  const cwd = process.cwd();
+
+  // Refuse to overwrite a non-Predators directory unless --force passed.
+  const looksLikePredatorsCwd =
+    fs.existsSync(path.join(cwd, "predators")) ||
+    fs.existsSync(path.join(cwd, "CLAUDE.md")) ||
+    fs.existsSync(path.join(cwd, ".claude")) ||
+    fs.existsSync(path.join(cwd, "QUICKSTART-SOCIO.md"));
+
+  if (!looksLikePredatorsCwd && !force) {
+    console.error("sync · CWD não parece ser pasta Predators (sem predators/ · CLAUDE.md · .claude/).");
+    console.error(`  CWD: ${cwd}`);
+    console.error("  · Para sync inicial em pasta vazia · use: npx predators-protocol sync --force");
+    console.error("  · Para sync em pasta Predators existente · CWD precisa conter CLAUDE.md ou predators/");
+    process.exit(1);
+  }
+
+  const SYNC_TARGETS = [
+    { rel: "predators", type: "dir" },
+    { rel: "docs", type: "dir" },
+    { rel: ".claude/commands", type: "dir" },
+    { rel: "CLAUDE.md", type: "file" },
+    { rel: "QUICKSTART-SOCIO.md", type: "file" },
+  ];
+
+  console.log("Predators Protocol · sync canon files do bundle NPX para CWD");
+  console.log(`  bundle:  ${BUNDLE_DIR}`);
+  console.log(`  target:  ${cwd}`);
+  if (dryRun) console.log("  mode:    DRY-RUN (zero writes)");
+  console.log("");
+
+  let totalCopied = 0;
+  for (const { rel, type } of SYNC_TARGETS) {
+    const src = path.join(BUNDLE_DIR, rel);
+    const dst = path.join(cwd, rel);
+
+    if (!fs.existsSync(src)) {
+      console.log(`  skip:    ${rel} (não-presente no bundle)`);
+      continue;
+    }
+
+    if (dryRun) {
+      console.log(`  preview: ${rel} (${type}) · would sync from bundle`);
+      continue;
+    }
+
+    const backup = backupExistingPath(dst);
+    if (backup) {
+      console.log(`  backup:  ${path.basename(backup)}`);
+    }
+
+    if (type === "dir") {
+      const r = copyDirRecursive(src, dst);
+      console.log(`  sync:    ${rel}/ (${r.copied} files)`);
+      totalCopied += r.copied;
+    } else {
+      fs.mkdirSync(path.dirname(dst), { recursive: true });
+      fs.copyFileSync(src, dst);
+      console.log(`  sync:    ${rel}`);
+      totalCopied++;
+    }
+  }
+
+  if (dryRun) {
+    console.log("\nDRY-RUN complete · use sem --dry-run para aplicar.");
+  } else {
+    console.log(`\nsync complete · ${totalCopied} files canon writados · backups com sufixo .backup-<timestamp>`);
+    console.log("Lei #1 reign: bundle slim · ZERO infra leak (0.3.0-beta.0)");
+  }
+}
+
+// ──────────────────────────────────────────────────────────────────────
+
+const command = process.argv[2] || "help";
+const commandsCanon = {
+  version: printVersionCanon,
+  status: printStatusCanon,
+  "list-predators": listPredatorsCanon,
+  "list-workflows": listWorkflowsCanon,
+  "workflow-states": listWorkflowStatesCanon,
+  "story-states": listStoryStatesCanon,
+  "layers-list": listLayersCanon,
+  "benchmark-info": showBenchmarkInfoCanon,
+  "metrics-list": listGoldenSignalsCanon,
+  init: runInitCommand,
+  config: runConfigCommand,
+  show: runShowCommand,
+  sync: runSyncCommand,
+  help: printHelpCanon,
+  "--help": printHelpCanon,
+  "-h": printHelpCanon,
+};
+
+const handler = commandsCanon[command];
+if (!handler) {
+  console.error(`Comando canon NÃO vigente: ${command}`);
+  printHelpCanon();
+  process.exit(1);
+}
+
+Promise.resolve(handler()).catch(err => {
+  console.error(`Falha runtime canon: ${err && err.message ? err.message : err}`);
+  process.exit(1);
+});