predators-protocol 0.3.0-beta.0

package/lib/spinners.js

@@ -0,0 +1,146 @@
+// lib/spinners.js · 6 predator-themed spinners frame-based
+// Lei #13 Pureza: zero deps externas · ANSI cursor manipulation puro
+// Sub-etapa B · Aranha-tecelã + Cisne-negro
+
+"use strict";
+
+const { colorByLayer, colorize, RESET } = require("./colors");
+
+const CURSOR_HIDE = "\x1b[?25l";
+const CURSOR_SHOW = "\x1b[?25h";
+const ERASE_LINE = "\x1b[2K";
+const LINE_START = "\r";
+
+const SPINNERS_CANON = {
+  // Águia · vôando · análise estratégica
+  "aguia-soaring": {
+    layer: "apex",
+    frames: ["╱╲", "─╲", "╱─", "── ", " ──", " ╱╲", "╲╱ ", "  ─"],
+    intervalMs: 120,
+    label: "Águia analisa",
+  },
+
+  // Tubarão · caçando · audit
+  "tubarao-hunting": {
+    layer: "hunter",
+    frames: ["▰▱▱▱▱▱", "▰▰▱▱▱▱", "▰▰▰▱▱▱", "▰▰▰▰▱▱", "▰▰▰▰▰▱", "▰▰▰▰▰▰", "▱▰▰▰▰▰", "▱▱▰▰▰▰"],
+    intervalMs: 100,
+    label: "Tubarão audita",
+  },
+
+  // Polvo · 8 tentáculos pulsing · cross-doc
+  "polvo-tentacles": {
+    layer: "builder",
+    frames: ["◯", "◍", "◐", "◑", "◒", "◓", "◔", "◕"],
+    intervalMs: 100,
+    label: "Polvo cruza-doc",
+  },
+
+  // Elefante · stomping · memória institucional
+  "elefante-stomping": {
+    layer: "governance",
+    frames: ["▁", "▂", "▃", "▄", "▅", "▆", "▇", "█", "▇", "▆", "▅", "▄", "▃", "▂"],
+    intervalMs: 80,
+    label: "Elefante consulta memória",
+  },
+
+  // Sinapse · firing · rede neural LLM
+  "sinapse-firing": {
+    layer: "meta",
+    frames: ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"],
+    intervalMs: 80,
+    label: "Sinapse processa",
+  },
+
+  // Default · The Eye pulsing
+  "default-eye": {
+    layer: "apex",
+    frames: ["⊙", "◉", "⊙", "◌", "○", "◌"],
+    intervalMs: 150,
+    label: "The eye that never closes",
+  },
+};
+
+// Map command type → recommended spinner
+const COMMAND_SPINNER_MAP = {
+  invoke: "aguia-soaring",
+  list: "polvo-tentacles",
+  workflow: "sinapse-firing",
+  audit: "tubarao-hunting",
+  validate: "tubarao-hunting",
+  memory: "elefante-stomping",
+  "pre-action": "sinapse-firing",
+  default: "default-eye",
+};
+
+class Spinner {
+  constructor(spinnerName = "default-eye", options = {}) {
+    this.config = SPINNERS_CANON[spinnerName] || SPINNERS_CANON["default-eye"];
+    this.label = options.label || this.config.label;
+    this.theme = options.theme || "default";
+    this.stream = options.stream || process.stderr;
+    this._frame = 0;
+    this._interval = null;
+    this._active = false;
+  }
+
+  _render() {
+    const frameChar = this.config.frames[this._frame % this.config.frames.length];
+    const coloredFrame = colorByLayer(frameChar, this.config.layer, this.theme);
+    const coloredLabel = colorize(this.label, "APEX_GOLD", this.theme);
+    this.stream.write(`${LINE_START}${ERASE_LINE}${coloredFrame}  ${coloredLabel}`);
+    this._frame++;
+  }
+
+  start() {
+    if (this._active) return this;
+    if (!this.stream.isTTY) {
+      // Non-TTY · graceful degradation · just print label once
+      this.stream.write(`${this.label}...\n`);
+      return this;
+    }
+    this._active = true;
+    this.stream.write(CURSOR_HIDE);
+    this._render();
+    this._interval = setInterval(() => this._render(), this.config.intervalMs);
+    return this;
+  }
+
+  stop(finalMessage = "") {
+    if (!this._active && this.stream.isTTY) {
+      // Was non-TTY · nothing to clean
+      if (finalMessage) this.stream.write(`${finalMessage}\n`);
+      return this;
+    }
+    if (this._interval) {
+      clearInterval(this._interval);
+      this._interval = null;
+    }
+    if (this.stream.isTTY) {
+      this.stream.write(`${LINE_START}${ERASE_LINE}${CURSOR_SHOW}`);
+    }
+    if (finalMessage) this.stream.write(`${finalMessage}\n`);
+    this._active = false;
+    return this;
+  }
+
+  succeed(message) {
+    return this.stop(`${colorize("✓", "INTEL_GREEN", this.theme)} ${message}`);
+  }
+
+  fail(message) {
+    return this.stop(`${colorize("✗", "HUNTER_RED", this.theme)} ${message}`);
+  }
+}
+
+function getSpinnerForCommand(commandName, options = {}) {
+  const spinnerName = COMMAND_SPINNER_MAP[commandName] || COMMAND_SPINNER_MAP.default;
+  return new Spinner(spinnerName, options);
+}
+
+module.exports = {
+  Spinner,
+  SPINNERS_CANON,
+  COMMAND_SPINNER_MAP,
+  getSpinnerForCommand,
+};

package/lib/splash.js

@@ -0,0 +1,114 @@
+// lib/splash.js · cinematic splash screen first-connection
+// Lei #13 Pureza: canon próprio · zero clone Matrix-style externo
+// Sub-etapa E · Polvo integração cumulativa
+
+"use strict";
+
+const { colorize, colorByLayer, bold, dim, italic, RESET } = require("./colors");
+const { renderEye, renderHeroBanner } = require("./ascii-art");
+const { isFirstConnection, markConnected, getTheme, readConfig } = require("./config");
+
+function sleep(ms) {
+  return new Promise(resolve => setTimeout(resolve, ms));
+}
+
+async function fadeInLines(lines, msPerLine = 80, stream = process.stdout) {
+  for (const line of lines) {
+    stream.write(line + "\n");
+    if (msPerLine > 0) await sleep(msPerLine);
+  }
+}
+
+async function renderCinematicSplash(stream = process.stdout) {
+  const theme = getTheme();
+
+  // Clear screen for cinematic feel (only if TTY)
+  if (stream.isTTY) {
+    stream.write("\x1b[2J\x1b[H");
+  }
+
+  stream.write("\n");
+  // The Eye logo · reveal slow
+  const eyeLines = renderEye(theme).split("\n");
+  await fadeInLines(eyeLines, stream.isTTY ? 30 : 0, stream);
+
+  stream.write("\n");
+
+  // Hero banner Predators Protocol text
+  stream.write(renderHeroBanner(theme));
+  stream.write("\n");
+
+  // Tagline
+  const tagline = italic(colorize(
+    '"The eye that never closes. 63 predadores ativos. Canon vigente."',
+    "APEX_GOLD",
+    theme,
+  ));
+  stream.write(`   ${tagline}\n\n`);
+
+  await sleep(stream.isTTY ? 500 : 0);
+
+  // Welcome message + quick start
+  const welcomeBlock = [
+    bold(colorize("  ▶ Bem-vindo ao Predators Protocol", "BUILDER_CYAN")),
+    "",
+    dim("    Framework multi-agente predatório · 63 predadores em 10 camadas"),
+    dim("    Lei do Sangue inviolável · Synapse · Canon dos 3 Vetos"),
+    "",
+    bold("  Quick start:"),
+    `    ${colorize("npx predators-protocol@beta help", "INTEL_GREEN")}            ${dim("· lista comandos canon")}`,
+    `    ${colorize("npx predators-protocol@beta list-predators", "INTEL_GREEN")}   ${dim("· 63 predadores")}`,
+    `    ${colorize("npx predators-protocol@beta layers-list", "INTEL_GREEN")}      ${dim("· 7 context layers L0-L6")}`,
+    `    ${colorize("npx predators-protocol@beta config", "INTEL_GREEN")}           ${dim("· preferences · theme · audio toggle")}`,
+    "",
+    dim("  GitHub: https://github.com/SharkLEx/predators-protocol"),
+    dim("  Licença: Proprietary · Alex Gonzaga (Tubarão-Apex)"),
+    "",
+  ];
+  await fadeInLines(welcomeBlock, stream.isTTY ? 40 : 0, stream);
+}
+
+async function renderMiniSplash(stream = process.stdout) {
+  const theme = getTheme();
+  const config = readConfig();
+  const eyeMini = colorize("◉", "APEX_GOLD", theme);
+  const name = colorize("Predators Protocol", "APEX_GOLD", theme);
+  const ver = dim("· canon vigente · 63 predadores ativos");
+  const lastSeen = config.lastConnectionAt
+    ? dim(`(última conexão: ${new Date(config.lastConnectionAt).toISOString().slice(0, 10)})`)
+    : "";
+  stream.write(`\n  ${eyeMini}  ${name} ${ver}  ${lastSeen}\n\n`);
+}
+
+async function runInitSplash(options = {}) {
+  const stream = options.stream || process.stdout;
+  const force = options.force || false;
+  const minimal = options.minimal || false;
+
+  const config = readConfig();
+  if (!config.splash.enabled && !force) {
+    return { rendered: false, reason: "splash_disabled_user_pref" };
+  }
+
+  const firstTime = isFirstConnection();
+
+  if (firstTime || force) {
+    await renderCinematicSplash(stream);
+    markConnected();
+    return { rendered: true, mode: "cinematic", firstTime };
+  }
+  if (minimal || !options.fullEveryTime) {
+    await renderMiniSplash(stream);
+    markConnected();
+    return { rendered: true, mode: "minimal", firstTime: false };
+  }
+  await renderCinematicSplash(stream);
+  markConnected();
+  return { rendered: true, mode: "cinematic", firstTime: false };
+}
+
+module.exports = {
+  renderCinematicSplash,
+  renderMiniSplash,
+  runInitSplash,
+};

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "predators-protocol",
+  "version": "0.3.0-beta.0",
+  "description": "Predators Protocol · multi-agent predatory framework · 63 predators in 10 layers · canon Lei #14 PERFEITO OU FIX-GERAL · UX layer + sync command · proprietary",
+  "keywords": [
+    "predators-protocol",
+    "multi-agent",
+    "framework",
+    "ai-agents",
+    "claude",
+    "canon",
+    "cli"
+  ],
+  "homepage": "https://github.com/SharkLEx/predators-protocol#readme",
+  "bugs": {
+    "url": "https://github.com/SharkLEx/predators-protocol/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SharkLEx/predators-protocol.git",
+    "directory": "packages/predators-protocol"
+  },
+  "license": "SEE LICENSE IN LICENSE",
+  "author": "Alex Gonzaga (Tubarão-Apex) <alex@predators-protocol.dev>",
+  "type": "commonjs",
+  "bin": {
+    "predators-protocol": "bin/predators-cli.js"
+  },
+  "files": [
+    "bin/predators-cli.js",
+    "lib/**/*.js",
+    "bundle/**/*.md",
+    "bundle/**/*.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "preversion": "node scripts/check-cwd-canon.js",
+    "prepublishOnly": "node scripts/check-cwd-canon.js",
+    "prepack": "node scripts/copy-canon-bundle.js",
+    "test:cli": "node bin/predators-cli.js help",
+    "test:blindagem": "node tests/lib-blindagem-canon.test.js"
+  }
+}