predators-protocol 0.3.0-beta.0

package/lib/ascii-art.js

@@ -0,0 +1,224 @@
+// lib/ascii-art.js · canon ASCII art Predators Protocol
+// Lei #13 Pureza: canon próprio · zero clone Matrix-style
+// Sub-etapa A · Borboleta-azul visual + Aranha-tecelã animação
+
+"use strict";
+
+const { colorize, colorByLayer, bold, dim, RESET } = require("./colors");
+
+// ═══════════════════════════════════════════════════════════════════
+// THE EYE · logo principal canon Predators Protocol
+// "The eye that never closes"
+// ═══════════════════════════════════════════════════════════════════
+const THE_EYE = `
+                    ▄▄▄▄▄▄▄▄▄▄▄
+                ▄▄█████████████████▄▄
+            ▄████▀▀░░░░░░░░░░░░▀▀████▄
+          ████▀░░░░░░░░░░░░░░░░░░░░▀████
+        ███▀░░░░░░░░░░░░░░░░░░░░░░░░░░▀███
+       ██▀░░░░░░░░░░▄▄▄▄▄▄▄▄▄░░░░░░░░░░░▀██
+      ██░░░░░░░▄████▀▀▀▀▀▀▀▀████▄░░░░░░░░░██
+     ██░░░░░▄███▀░░░░░░░░░░░░░░▀███▄░░░░░░░██
+     ██░░░░██▀░░░░░░▄▄▄▄▄▄▄░░░░░░░▀██░░░░░░██
+     ██░░░██░░░░░▄████▀▀▀▀████▄░░░░░██░░░░░██
+     ██░░░██░░░░██▀░░░░░░░░░░▀██░░░░██░░░░░██
+     ██░░░██░░░██░░░░ ██████ ░░░██░░░██░░░░░██
+     ██░░░██░░░██░░░░██████████░░██░░░██░░░░██
+     ██░░░██░░░██░░░░██████████░░██░░░██░░░░██
+     ██░░░██░░░██░░░░ ██████ ░░░██░░░██░░░░░██
+     ██░░░██░░░░██▄░░░░░░░░░░▄██░░░░██░░░░░██
+     ██░░░██░░░░░▀████▄▄▄▄████▀░░░░░██░░░░░██
+     ██░░░░██░░░░░░░▀▀▀▀▀▀▀▀░░░░░░░██░░░░░░██
+      ██░░░░▀███▄░░░░░░░░░░░░░░▄███▀░░░░░░██
+      ██░░░░░░░▀████▄▄▄▄▄▄▄▄████▀░░░░░░░░░██
+       ██▄░░░░░░░░░▀▀▀▀▀▀▀▀▀▀░░░░░░░░░░░▄██
+        ███▄░░░░░░░░░░░░░░░░░░░░░░░░░░░███
+          ████▄░░░░░░░░░░░░░░░░░░░░░░████
+            ▀████▄▄░░░░░░░░░░░░░░▄▄████▀
+                ▀▀█████████████████▀▀
+                    ▀▀▀▀▀▀▀▀▀▀▀
+`;
+
+// ═══════════════════════════════════════════════════════════════════
+// Predator signature cards · stylized · per-camada color
+// ═══════════════════════════════════════════════════════════════════
+
+const PREDATOR_CARDS = {
+  "aguia-real": {
+    layer: "apex",
+    glyph: "🦅",
+    sigil: `
+      ╔════════════════════════════════════════╗
+      ║   ÁGUIA-REAL · Apex T5 · soaring       ║
+      ║                                        ║
+      ║          \\\\        //                   ║
+      ║           \\\\______//                    ║
+      ║         === ▼ === ▼ ===                 ║
+      ║                                        ║
+      ║   "De onde eu vôo, tudo é território"  ║
+      ╚════════════════════════════════════════╝`,
+    tagline: "Visão de topo · orquestração estratégica cross-domain",
+  },
+
+  "tubarao-branco": {
+    layer: "hunter",
+    glyph: "🦈",
+    sigil: `
+      ╔════════════════════════════════════════╗
+      ║   TUBARÃO-BRANCO · Hunter T5 · JUIZ    ║
+      ║                                        ║
+      ║              ▄▄▄▄▄                      ║
+      ║          ▄▄█████████▄▄                  ║
+      ║         ██  ▼     ▼  ██▄▄▄▄▄▄           ║
+      ║         ▀████████████████████           ║
+      ║                                        ║
+      ║   "Não passa nem gota de sangue"        ║
+      ╚════════════════════════════════════════╝`,
+    tagline: "Lei do Sangue · JUIZ FINAL N2 BINARY canon Art. 14",
+  },
+
+  "hiena": {
+    layer: "hunter",
+    glyph: "🐺",
+    sigil: `
+      ╔════════════════════════════════════════╗
+      ║   HIENA · Hunter T4 · forense          ║
+      ║                                        ║
+      ║          ╱╲                            ║
+      ║         ╱██╲    ▄▄▄▄▄                  ║
+      ║        ╱████╲  ████████                ║
+      ║       ╱██████╲▀▀▀▀▀▀▀▀                 ║
+      ║                                        ║
+      ║   "Onde houve incidente, há rastro"    ║
+      ╚════════════════════════════════════════╝`,
+    tagline: "Forense pós-incidente · self-healing root-cause",
+  },
+
+  "polvo": {
+    layer: "builder",
+    glyph: "🐙",
+    sigil: `
+      ╔════════════════════════════════════════╗
+      ║   POLVO · Builder T3 · integrações     ║
+      ║                                        ║
+      ║              ◯◯                        ║
+      ║           ╱╲╱██╲╱╲                     ║
+      ║          ╱  ████  ╲                     ║
+      ║         ╱  ╱╲██╱╲  ╲                    ║
+      ║        ◜  ◜  ◜  ◜  ◜                   ║
+      ║                                        ║
+      ║   "Oito tentáculos, oito integrações"  ║
+      ╚════════════════════════════════════════╝`,
+    tagline: "HTTP clients · webhooks · OAuth · MCP servers",
+  },
+
+  "elefante": {
+    layer: "governance",
+    glyph: "🐘",
+    sigil: `
+      ╔════════════════════════════════════════╗
+      ║   ELEFANTE · Governance T4 · memória   ║
+      ║                                        ║
+      ║              ▄▄▄▄▄▄▄                    ║
+      ║          ▄██████████▄                   ║
+      ║         ██  ◉    ◉  ██                  ║
+      ║         ██           ██╗                 ║
+      ║         ██▀▀▀▀▀▀▀▀▀▀▀██▀                ║
+      ║          ██         ██                  ║
+      ║                                        ║
+      ║   "Memória institucional canon"        ║
+      ╚════════════════════════════════════════╝`,
+    tagline: "Append-only · retention 7 anos · audit trail completo",
+  },
+
+  "dragao-ancestral": {
+    layer: "meta",
+    glyph: "🐉",
+    sigil: `
+      ╔════════════════════════════════════════╗
+      ║   DRAGÃO-ANCESTRAL · Meta T5 · veto    ║
+      ║                                        ║
+      ║                  ╱╲                    ║
+      ║              ╱══╱██╲══╲                ║
+      ║          ╱══╱  ████  ╲══╲              ║
+      ║         ◤██◢ ▄ ████ ▄ ◤██◢             ║
+      ║              ╲▄▄▄▄▄▄╱                  ║
+      ║                                        ║
+      ║   "Matéria constitucional inviolável"  ║
+      ╚════════════════════════════════════════╝`,
+    tagline: "Veto constitucional · matéria canon vigente · 14 leis",
+  },
+
+  "fenix": {
+    layer: "meta",
+    glyph: "🔥",
+    sigil: `
+      ╔════════════════════════════════════════╗
+      ║   FÊNIX · Meta T5 · Art. 5 imutável    ║
+      ║                                        ║
+      ║              ╱╲╱╲                      ║
+      ║          ╱╲╱██████╲╱╲                  ║
+      ║         ╱██▲████████▲██╲                ║
+      ║        ◤██████████████████◢            ║
+      ║           ╲▄▄▄▄▄▄▄▄▄▄▄▄╱                ║
+      ║                                        ║
+      ║   "Propõe, ratifica, ressurge"          ║
+      ╚════════════════════════════════════════╝`,
+    tagline: "Predador novo via Fênix Protocol · Art. 5 imutável",
+  },
+
+  "lince-das-neves": {
+    layer: "meta",
+    glyph: "🐆",
+    sigil: `
+      ╔════════════════════════════════════════╗
+      ║   LINCE-DAS-NEVES · Meta T4 · N1 audit ║
+      ║                                        ║
+      ║              ▄▄▄                        ║
+      ║          ▄██████▄                       ║
+      ║         ██ ◉  ◉ ██                      ║
+      ║         ██▀████▀██                      ║
+      ║        ╱██╲████╱██╲                     ║
+      ║                                        ║
+      ║   "Olhar afiado · consistência canon"  ║
+      ╚════════════════════════════════════════╝`,
+    tagline: "N1 auditor · 89+ audits consecutive · Lei #4 byte-canon",
+  },
+};
+
+function renderEye(theme = "default") {
+  const lines = THE_EYE.split("\n").filter(l => l.length > 0);
+  return lines.map(l => colorize(l, "APEX_GOLD", theme)).join("\n");
+}
+
+function renderPredatorCard(predatorId, theme = "default") {
+  const card = PREDATOR_CARDS[predatorId];
+  if (!card) return "";
+  const lines = card.sigil.split("\n").filter(l => l.length > 0);
+  const colored = lines.map(l => colorByLayer(l, card.layer, theme)).join("\n");
+  const tagline = colorize(card.tagline, "APEX_GOLD", theme);
+  return `${colored}\n   ${dim(card.tagline)}\n`;
+}
+
+function listPredatorsWithCards() {
+  return Object.keys(PREDATOR_CARDS);
+}
+
+function renderHeroBanner(theme = "default") {
+  const banner = `
+${colorize("█▀█ █▀█ █▀▀ █▀▄ ▄▀█ ▀█▀ █▀█ █▀█ █▀", "APEX_GOLD", theme)}
+${colorize("█▀▀ █▀▄ ██▄ █▄▀ █▀█  █  █▄█ █▀▄ ▄█", "APEX_GOLD", theme)}
+${colorize("█▀█ █▀█ █▀█ ▀█▀ █▀█ █▀▀ █▀█ █  ", "BUILDER_CYAN", theme)}
+${colorize("█▀▀ █▀▄ █▄█  █  █▄█ █▄▄ █▄█ █▄▄", "BUILDER_CYAN", theme)}
+`;
+  return banner;
+}
+
+module.exports = {
+  THE_EYE,
+  PREDATOR_CARDS,
+  renderEye,
+  renderPredatorCard,
+  renderHeroBanner,
+  listPredatorsWithCards,
+};

package/lib/audio.js

@@ -0,0 +1,137 @@
+// lib/audio.js · player infra cross-platform · audio signatures predator
+// HONEST UPFRONT (Lei #11): arquivos .mp3 reais pendentes Fênix Protocol futura
+// (predador "audio designer ambient" será criado · 5 sons signature reais)
+// Esta camada entrega: player + toggle + cross-platform detection + graceful degradation
+
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+const { spawn } = require("child_process");
+const { getAudioEnabled } = require("./config");
+
+// Map signature name → file path canon
+// PENDENTE Fênix futura: arquivos .mp3 reais ambient signature
+const SOUNDS_CANON = {
+  "tubarao-signature": {
+    file: "tubarao-signature.mp3",
+    description: "Deep bass · audit Tubarão JUIZ FINAL",
+    duration_ms: 2000,
+  },
+  "aguia-signature": {
+    file: "aguia-signature.mp3",
+    description: "Sharp + clean · análise estratégica Águia",
+    duration_ms: 1500,
+  },
+  "hiena-signature": {
+    file: "hiena-signature.mp3",
+    description: "Forensic ambient · pós-incidente Hiena",
+    duration_ms: 2500,
+  },
+  "sinapse-pulse": {
+    file: "sinapse-pulse.mp3",
+    description: "Ambient cerebral · sinapse fire",
+    duration_ms: 1000,
+  },
+  "fenix-rebirth": {
+    file: "fenix-rebirth.mp3",
+    description: "Resurgir · self-healing Fênix Art. 5",
+    duration_ms: 3000,
+  },
+};
+
+const SOUNDS_DIR = path.join(__dirname, "..", "assets", "sounds");
+
+function isWSL() {
+  if (process.platform !== "linux") return false;
+  try {
+    const release = fs.readFileSync("/proc/version", "utf-8").toLowerCase();
+    return release.includes("microsoft") || release.includes("wsl");
+  } catch {
+    return false;
+  }
+}
+
+function detectPlayer() {
+  if (isWSL()) return null; // WSL audio often broken · graceful skip
+  if (process.platform === "win32") return { cmd: "powershell", args: ["-c"] };
+  if (process.platform === "darwin") return { cmd: "afplay", args: [] };
+  if (process.platform === "linux") {
+    // prefer paplay (PulseAudio) then aplay (ALSA)
+    return { cmd: "paplay", args: [], fallback: { cmd: "aplay", args: ["-q"] } };
+  }
+  return null;
+}
+
+function soundFileExists(signatureName) {
+  const sound = SOUNDS_CANON[signatureName];
+  if (!sound) return false;
+  return fs.existsSync(path.join(SOUNDS_DIR, sound.file));
+}
+
+function play(signatureName, options = {}) {
+  // Honor user preference + graceful degradation
+  if (!options.force && !getAudioEnabled()) {
+    return { played: false, reason: "audio_disabled_user_pref" };
+  }
+  const sound = SOUNDS_CANON[signatureName];
+  if (!sound) {
+    return { played: false, reason: "unknown_signature" };
+  }
+  const filePath = path.join(SOUNDS_DIR, sound.file);
+  if (!fs.existsSync(filePath)) {
+    return { played: false, reason: "sound_file_pending_fenix_audio_designer" };
+  }
+  const player = detectPlayer();
+  if (!player) {
+    return { played: false, reason: "no_player_or_wsl_environment" };
+  }
+  try {
+    let cmd = player.cmd;
+    let args = [...player.args];
+    if (cmd === "powershell") {
+      args.push(`(New-Object Media.SoundPlayer '${filePath}').PlaySync()`);
+    } else {
+      args.push(filePath);
+    }
+    spawn(cmd, args, { detached: true, stdio: "ignore" }).unref();
+    return { played: true, signature: signatureName };
+  } catch (err) {
+    return { played: false, reason: "spawn_failed", error: String(err) };
+  }
+}
+
+function listSignatures() {
+  return Object.keys(SOUNDS_CANON).map(name => ({
+    name,
+    description: SOUNDS_CANON[name].description,
+    duration_ms: SOUNDS_CANON[name].duration_ms,
+    file_present: soundFileExists(name),
+  }));
+}
+
+function getStatusReport() {
+  const player = detectPlayer();
+  const enabled = getAudioEnabled();
+  return {
+    enabled,
+    platform: process.platform,
+    is_wsl: isWSL(),
+    player_available: player !== null,
+    player_cmd: player ? player.cmd : null,
+    sounds: listSignatures(),
+    canon_note: "5 sons signature pendentes Fênix Protocol audio designer (HONEST UPFRONT Lei #11)",
+  };
+}
+
+module.exports = {
+  SOUNDS_CANON,
+  SOUNDS_DIR,
+  detectPlayer,
+  isWSL,
+  soundFileExists,
+  play,
+  listSignatures,
+  getStatusReport,
+};

package/lib/colors.js

@@ -0,0 +1,168 @@
+// lib/colors.js · canon palette Predators Protocol
+// Lei #13 Pureza: zero deps externas · ANSI truecolor escape codes puros
+// Sub-etapa A + C · Mantis a11y + Pavão visual
+
+"use strict";
+
+// ANSI escape codes canônicos
+const ESC = "\x1b[";
+const RESET = `${ESC}0m`;
+const BOLD = `${ESC}1m`;
+const DIM = `${ESC}2m`;
+const ITALIC = `${ESC}3m`;
+const UNDERLINE = `${ESC}4m`;
+
+// Truecolor RGB foreground · suportado em terminais modernos (Windows Terminal, iTerm2, gnome-terminal, etc)
+function rgb(r, g, b) {
+  return `${ESC}38;2;${r};${g};${b}m`;
+}
+
+// Background truecolor
+function bgRgb(r, g, b) {
+  return `${ESC}48;2;${r};${g};${b}m`;
+}
+
+// 8-color basic fallback (universal compat)
+const BASIC = {
+  black: `${ESC}30m`,
+  red: `${ESC}31m`,
+  green: `${ESC}32m`,
+  yellow: `${ESC}33m`,
+  blue: `${ESC}34m`,
+  magenta: `${ESC}35m`,
+  cyan: `${ESC}36m`,
+  white: `${ESC}37m`,
+  gray: `${ESC}90m`,
+  brightRed: `${ESC}91m`,
+  brightGreen: `${ESC}92m`,
+  brightYellow: `${ESC}93m`,
+  brightBlue: `${ESC}94m`,
+  brightMagenta: `${ESC}95m`,
+  brightCyan: `${ESC}96m`,
+  brightWhite: `${ESC}97m`,
+};
+
+// Canon palette por camada · WCAG AA contrast em fundo terminal escuro
+const PALETTE_CANON = {
+  APEX_GOLD: { rgb: [255, 215, 0], hex: "#FFD700", basic: BASIC.yellow },
+  HUNTER_RED: { rgb: [220, 20, 60], hex: "#DC143C", basic: BASIC.red },
+  BUILDER_CYAN: { rgb: [0, 206, 209], hex: "#00CED1", basic: BASIC.cyan },
+  DESIGNER_PURPLE: { rgb: [147, 112, 219], hex: "#9370DB", basic: BASIC.magenta },
+  INTEL_GREEN: { rgb: [50, 205, 50], hex: "#32CD32", basic: BASIC.green },
+  META_BLUE: { rgb: [65, 105, 225], hex: "#4169E1", basic: BASIC.blue },
+  WEB3_ORANGE: { rgb: [255, 140, 0], hex: "#FF8C00", basic: BASIC.brightYellow },
+  COPY_PINK: { rgb: [255, 105, 180], hex: "#FF69B4", basic: BASIC.brightMagenta },
+  GOVERNANCE_TEAL: { rgb: [0, 128, 128], hex: "#008080", basic: BASIC.cyan },
+  GROWTH_LIME: { rgb: [173, 255, 47], hex: "#ADFF2F", basic: BASIC.brightGreen },
+};
+
+// Map predator layer → palette key
+const LAYER_COLOR = {
+  apex: "APEX_GOLD",
+  hunter: "HUNTER_RED",
+  builder: "BUILDER_CYAN",
+  designer: "DESIGNER_PURPLE",
+  intel: "INTEL_GREEN",
+  meta: "META_BLUE",
+  web3: "WEB3_ORANGE",
+  copy: "COPY_PINK",
+  governance: "GOVERNANCE_TEAL",
+  growth: "GROWTH_LIME",
+};
+
+// Themes canon · 4 variants
+const THEMES = {
+  default: {
+    useTrueColor: true,
+    accent: "APEX_GOLD",
+    text: BASIC.white,
+    dim: BASIC.gray,
+  },
+  dark: {
+    useTrueColor: true,
+    accent: "BUILDER_CYAN",
+    text: BASIC.brightWhite,
+    dim: BASIC.gray,
+  },
+  light: {
+    useTrueColor: true,
+    accent: "META_BLUE",
+    text: BASIC.black,
+    dim: BASIC.gray,
+  },
+  monochrome: {
+    useTrueColor: false,
+    accent: BASIC.white,
+    text: BASIC.white,
+    dim: BASIC.gray,
+  },
+};
+
+// Detect color support (best-effort · TTY check + env vars)
+function supportsTrueColor() {
+  if (process.env.NO_COLOR) return false;
+  if (process.env.FORCE_COLOR) return true;
+  if (!process.stdout.isTTY) return false;
+  const colorterm = (process.env.COLORTERM || "").toLowerCase();
+  if (colorterm === "truecolor" || colorterm === "24bit") return true;
+  // Windows Terminal + ConEmu + recent cmd support truecolor
+  if (process.platform === "win32") return true;
+  return false;
+}
+
+function colorize(text, paletteKey, theme = "default") {
+  const themeConfig = THEMES[theme] || THEMES.default;
+  if (theme === "monochrome" || !themeConfig.useTrueColor || !supportsTrueColor()) {
+    const color = PALETTE_CANON[paletteKey];
+    if (!color) return text;
+    return `${color.basic}${text}${RESET}`;
+  }
+  const color = PALETTE_CANON[paletteKey];
+  if (!color) return text;
+  const [r, g, b] = color.rgb;
+  return `${rgb(r, g, b)}${text}${RESET}`;
+}
+
+function colorByLayer(text, layer, theme = "default") {
+  const paletteKey = LAYER_COLOR[layer];
+  if (!paletteKey) return text;
+  return colorize(text, paletteKey, theme);
+}
+
+function bold(text) {
+  return `${BOLD}${text}${RESET}`;
+}
+
+function dim(text) {
+  return `${DIM}${text}${RESET}`;
+}
+
+function italic(text) {
+  return `${ITALIC}${text}${RESET}`;
+}
+
+function underline(text) {
+  return `${UNDERLINE}${text}${RESET}`;
+}
+
+module.exports = {
+  ESC,
+  RESET,
+  BOLD,
+  DIM,
+  ITALIC,
+  UNDERLINE,
+  BASIC,
+  PALETTE_CANON,
+  LAYER_COLOR,
+  THEMES,
+  rgb,
+  bgRgb,
+  colorize,
+  colorByLayer,
+  bold,
+  dim,
+  italic,
+  underline,
+  supportsTrueColor,
+};

package/lib/config.js

@@ -0,0 +1,114 @@
+// lib/config.js · ~/.predators-config.json read/write canon
+// Lei #1 reign: zero credencial · só preferências user-side
+// Sub-etapa D + E · Tatu-bola cross-platform + Polvo integração
+
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+
+const CONFIG_PATH = path.join(os.homedir(), ".predators-config.json");
+
+const DEFAULT_CONFIG = {
+  version: 1,
+  firstConnectionAt: null,
+  lastConnectionAt: null,
+  theme: "default",
+  audio: {
+    enabled: false,
+    volume: 0.5,
+  },
+  splash: {
+    enabled: true,
+    minimal: false,
+  },
+  telemetry: {
+    enabled: false,
+  },
+};
+
+function readConfig() {
+  try {
+    if (!fs.existsSync(CONFIG_PATH)) {
+      return { ...DEFAULT_CONFIG, firstConnectionAt: null };
+    }
+    const raw = fs.readFileSync(CONFIG_PATH, "utf-8");
+    const parsed = JSON.parse(raw);
+    return { ...DEFAULT_CONFIG, ...parsed };
+  } catch (err) {
+    return { ...DEFAULT_CONFIG };
+  }
+}
+
+function writeConfig(config) {
+  try {
+    const merged = { ...readConfig(), ...config };
+    fs.writeFileSync(CONFIG_PATH, JSON.stringify(merged, null, 2), "utf-8");
+    return merged;
+  } catch (err) {
+    return null;
+  }
+}
+
+function isFirstConnection() {
+  const config = readConfig();
+  return config.firstConnectionAt === null;
+}
+
+function markConnected() {
+  const config = readConfig();
+  const now = new Date().toISOString();
+  const update = { lastConnectionAt: now };
+  if (config.firstConnectionAt === null) {
+    update.firstConnectionAt = now;
+  }
+  return writeConfig(update);
+}
+
+function setAudioEnabled(enabled) {
+  const config = readConfig();
+  config.audio.enabled = Boolean(enabled);
+  return writeConfig(config);
+}
+
+function getAudioEnabled() {
+  return readConfig().audio.enabled;
+}
+
+function setTheme(theme) {
+  const validThemes = ["default", "dark", "light", "monochrome"];
+  if (!validThemes.includes(theme)) {
+    return null;
+  }
+  return writeConfig({ theme });
+}
+
+function getTheme() {
+  return readConfig().theme;
+}
+
+function setSplashEnabled(enabled) {
+  const config = readConfig();
+  config.splash.enabled = Boolean(enabled);
+  return writeConfig(config);
+}
+
+function getConfigPath() {
+  return CONFIG_PATH;
+}
+
+module.exports = {
+  CONFIG_PATH,
+  DEFAULT_CONFIG,
+  readConfig,
+  writeConfig,
+  isFirstConnection,
+  markConnected,
+  setAudioEnabled,
+  getAudioEnabled,
+  setTheme,
+  getTheme,
+  setSplashEnabled,
+  getConfigPath,
+};