noiton 1.0.0 → 2.0.1

package/src/lib/install.js

@@ -0,0 +1,210 @@
+/**
+ * NOITON Installer - auto-installation of supported agents
+ *
+ * Provides install/uninstall/update flows with spinners.
+ */
+
+import { execSync, spawn } from "node:child_process";
+import { successMessage, errorMessage, installingMessage } from "../messages.js";
+import { spinner, ok, fail, info, dim } from "../ui.js";
+import { c } from "../constants.js";
+
+/**
+ * Run a shell command and stream output. Returns a promise that resolves
+ * with exit code or rejects with the error.
+ * @param {string} cmd
+ * @param {object} opts
+ * @param {(chunk: string) => void} [opts.onData]
+ */
+function execStream(cmd, opts = {}) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(cmd, {
+      shell: true,
+      stdio: ["ignore", "pipe", "pipe"],
+    });
+
+    let combined = "";
+    child.stdout.on("data", (d) => {
+      const s = d.toString();
+      combined += s;
+      if (opts.onData) opts.onData(s);
+    });
+    child.stderr.on("data", (d) => {
+      const s = d.toString();
+      combined += s;
+      if (opts.onData) opts.onData(s);
+    });
+
+    child.on("error", (err) => reject(err));
+    child.on("close", (code) => {
+      if (code === 0) resolve(combined);
+      else reject(new Error(`Comando falhou com código ${code}`));
+    });
+  });
+}
+
+/**
+ * Install an agent by ID.
+ * @param {string} agentId
+ * @returns {Promise<{ok: boolean, output?: string, error?: string}>}
+ */
+export async function installAgent(agentId) {
+  const { AGENT_REGISTRY } = await import("./detect.js");
+  const agent = AGENT_REGISTRY.find((a) => a.id === agentId);
+  if (!agent || !agent.installCmd) {
+    return { ok: false, error: `Agente ${agentId} não pode ser instalado automaticamente` };
+  }
+
+  const s = spinner(`${installingMessage()} Instalando ${agent.name}...`);
+  try {
+    const output = await execStream(agent.installCmd, {
+      onData: () => s.text = `${installingMessage()} Instalando ${agent.name}...`,
+    });
+    s.succeed(`${agent.name} instalado!`);
+    return { ok: true, output };
+  } catch (err) {
+    s.fail(`Erro ao instalar ${agent.name}`);
+    return { ok: false, error: err.message };
+  }
+}
+
+/**
+ * Update an agent to latest version.
+ * @param {string} agentId
+ * @returns {Promise<{ok: boolean, error?: string}>}
+ */
+export async function updateAgent(agentId) {
+  const { AGENT_REGISTRY } = await import("./detect.js");
+  const agent = AGENT_REGISTRY.find((a) => a.id === agentId);
+  if (!agent) return { ok: false, error: `Agente ${agentId} desconhecido` };
+
+  const updateCmds = {
+    opencode: "curl -fsSL https://opencode.ai/install | bash",
+    kilo: "npm update -g @kilocode/cli",
+    aider: "pip install --upgrade aider-chat",
+    hermes: "pip install --upgrade nous-hermes",
+  };
+
+  const cmd = updateCmds[agentId];
+  if (!cmd) return { ok: false, error: `Update não suportado para ${agent.name}` };
+
+  const s = spinner(`Atualizando ${agent.name}...`);
+  try {
+    await execStream(cmd);
+    s.succeed(`${agent.name} atualizado!`);
+    return { ok: true };
+  } catch (err) {
+    s.fail(`Erro ao atualizar ${agent.name}`);
+    return { ok: false, error: err.message };
+  }
+}
+
+/**
+ * Quick check if command exists (used by checkAgentAvailable).
+ * @param {string} cmd
+ */
+function commandExists(cmd) {
+  try {
+    execSync(`command -v ${cmd}`, { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Check if Python is available (needed for pip installs).
+ */
+export function pythonAvailable() {
+  return commandExists("python3") || commandExists("python");
+}
+
+/**
+ * Get current OpenCode version from binary.
+ * @returns {string|null}
+ */
+export function getOpenCodeVersion() {
+  try {
+    const out = execSync("opencode --version 2>/dev/null", {
+      encoding: "utf8",
+      timeout: 5000,
+    });
+    const match = out.match(/(\d+\.\d+(?:\.\d+)?)/);
+    return match ? match[1] : out.trim();
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Confirm dialog using inquirer (re-exported for convenience).
+ */
+import { confirm } from "@inquirer/prompts";
+
+/**
+ * Offer to install OpenCode when none found.
+ * Asks the user a few quick questions to choose between OpenCode and Hermes.
+ */
+export async function offerInstall() {
+  const { select } = await import("@inquirer/prompts");
+  console.log();
+  info(c.bold("🐙 Vamos descobrir o que você precisa!"));
+  console.log();
+  const useCase = await select({
+    message: "Pra que você quer usar IA?",
+    choices: [
+      {
+        name: "💻 Programar (código, debug, refatorar)",
+        value: "programming",
+        description: "Recomenda: OpenCode",
+      },
+      {
+        name: "🤖 Assistente (tarefas, integrações)",
+        value: "assistant",
+        description: "Recomenda: Hermes",
+      },
+      {
+        name: "🤔 Não sei, me explica as diferenças",
+        value: "explain",
+        description: "Mostra comparação detalhada",
+      },
+    ],
+  });
+
+  if (useCase === "explain") {
+    info("🐙 OpenCode: programador IA que escreve código junto com você");
+    info("🐙 Hermes: assistente que faz tarefas e se integra com apps");
+    console.log();
+    return offerInstall();
+  }
+
+  const wantInstall = await confirm({
+    message: `${useCase === "programming" ? "💻 OpenCode" : "🤖 Hermes"} é o que brilha aí. Instalar agora?`,
+    default: true,
+  });
+
+  if (!wantInstall) return null;
+
+  return useCase === "programming" ? "opencode" : "hermes";
+}
+
+/**
+ * Compare current and latest version, return update message if needed.
+ * @param {string} currentVer
+ * @param {string} latestVer
+ * @returns {string|null}
+ */
+export function needsUpdateMessage(currentVer, latestVer) {
+  if (!currentVer || !latestVer) return null;
+  const cur = currentVer.split(".").map(Number);
+  const lat = latestVer.split(".").map(Number);
+  for (let i = 0; i < Math.max(cur.length, lat.length); i++) {
+    const c = cur[i] || 0;
+    const l = lat[i] || 0;
+    if (l > c) {
+      return `🔄 OpenCode v${latestVer} disponível! Você tem v${currentVer}.`;
+    }
+    if (l < c) return null;
+  }
+  return null;
+}

package/src/messages.js

@@ -0,0 +1,169 @@
+/**
+ * NOITON Chatty - funny phrases, easter eggs, and contextual messages
+ *
+ * Each "moment" returns a random phrase from its pool. Some pools are
+ * time-bound (easter eggs for holidays), others are rare (5% chance).
+ */
+
+import { c } from "./constants.js";
+
+const TODAY = () => {
+  const d = new Date();
+  return { month: d.getMonth() + 1, day: d.getDate(), weekday: d.getDay() };
+};
+
+// ============= PHRASE POOLS =============
+
+const successStart = [
+  "Houston, temos um coder! 🚀 Bora decolar!",
+  "✨ Pronto! Agora você fala a língua dos modelos!",
+  "🎉 Tá preparado, astronauta do código! Tudo conectado!",
+  "🧠 Sua IA tá conectada. Que o código esteja com você!",
+  "💜 Bem-vindo ao clube dos que quebram galho!",
+  "🤖 beep boop... chave aceita. Iniciando protocolo de poder.",
+  "⚡ Acabou de ganhar superpoderes. Use com responsabilidade!",
+  "🌟 Pronto pra criar o que ninguém pensou em criar!",
+  "🎯 Agora você é 10x developer. (Métricas não inclusas)",
+  "🍕 Sua pizza tá no forno... quer dizer, seu código!",
+  "🐙 O polvo abraçou você. Que os commits sejam verdes!",
+  "🔮 Os ventos do digital lhe favorecem. Mystic vibes on.",
+  "🎪 Espetáculo vai começar - você é a estrela!",
+  "💎 Brilhante! Como diamante em superfície de código.",
+  "🦄 Você está oficialmente powered by a magic sea creature.",
+];
+
+const noAgentPhrases = [
+  "🌵 Aqui só tem deserto digital...",
+  "👻 Achou que ia rodar sozinho? Pior que precisa de um agent!",
+  "🦗 *grilo* ... bora instalar o OpenCode?",
+  "🐙 O polvo está olhando pra você esperando uma direção...",
+  "🕳️ Tão vazio quanto geladeira de estagiário em sexta-feira.",
+  "🌌 Silêncio cósmico... nenhum agente responde.",
+  "🤷 Sua máquina tá mais vazia que estacionamento de shopping domingo.",
+];
+
+const installingPhrases = [
+  "📥 Instalando mais rápido que wifi de lan house!",
+  "🔧 Apertando parafusos digitais...",
+  "⚙️ Calibrando tentáculos do polvo...",
+  "🚀 Decolando em 3... 2... 1...",
+];
+
+const thinkingPhrases = [
+  "🤔 Pensando mais rápido que polvo em aquário...",
+  "💭 Sondando as profundezas do digital...",
+  "🐙 O polvo está consultando seus 8 cérebros...",
+  "⚡ Calculando a matrix...",
+  "✨ Alinhando os chakras da configuração...",
+];
+
+const errorPhrases = [
+  "💥 Ih, o polvo tropeçou no próprio tentáculo!",
+  "🤕 Até polvo erra às vezes, né?",
+  "🥴 Houston, temos um problema (mas é pequeno, confia).",
+  "🦑 Enroscaram os fios. Tenta de novo?",
+];
+
+const cancelPhrases = [
+  "✋ Operação cancelada. O polvo acenou tchau.",
+  "🐙 Tudo bem, o polvo vai pescar!",
+  "👋 Sem stress. Volta quando quiser!",
+];
+
+const farewell = [
+  "🐙 O polvo manda um abraço de 8 tentáculos!",
+  "✨ Até a próxima conexão!",
+  "🚀 Vai lá brilhar, astronauta!",
+  "💜 Tchau! O polvo cuida de você.",
+];
+
+const rarePhrases = [
+  "🦄 Você encontrou o unicórnio! Bug-free garantido* (*exceto às terças)",
+  "👽 Aliens detectados no código. A IA neutralizou.",
+  "🍕 Pizza virtual entregue! Calorias: 0",
+  "🎰 Você é o visitante nº 1.337! Ganhou superpoderes extras.",
+  "🏆 NOITON Pro Tip #42: Polvos são mais espertos que devs (segredo)",
+];
+
+const easterEggs = [
+  // Seasonal
+  { date: { month: 12, day: 25 }, message: "🎄 HO HO HO! Papai Noel trouxe superpoderes de IA!", emoji: "🎄" },
+  { date: { month: 12, day: 31 }, message: "🎆 Feliz Ano Novo! Que seus bugs sejam poucos!", emoji: "🎆" },
+  { date: { month: 1, day: 1 }, message: "🥂 Feliz 2026! Que venha o código limpo!", emoji: "🥂" },
+  { date: { month: 9, day: 13 }, message: "👨‍💻 Feliz Dia do Programador! Café grátis (simbólico)!", emoji: "👨‍💻" },
+  { date: { month: 10, day: 31 }, message: "🎃 BOO! Fantasmas no código? A IA resolve!", emoji: "🎃" },
+  { date: { month: 2, day: 14 }, message: "💘 Você <3 NOITON. O polvo sabe.", emoji: "💘" },
+  { date: { month: 6, day: 12 }, message: "🇧🇷 Viva o Brasil! O polvo tá sambando!", emoji: "🇧🇷" },
+];
+
+// ============= EASTER EGG FUNCTION =============
+
+/**
+ * Check for holiday/spacial date easter egg.
+ * Returns a message string or null.
+ */
+export function getEasterEgg() {
+  const { month, day } = TODAY();
+  const egg = easterEggs.find((e) => e.date.month === month && e.date.day === day);
+  if (egg) return egg.message;
+  return null;
+}
+
+/**
+ * Get a random phrase from a pool
+ * Optionally include holiday easter egg in the pool
+ */
+function pick(pool, count = 1) {
+  const egg = getEasterEgg();
+  const combined = egg ? [egg, ...pool] : pool;
+  const shuffled = [...combined].sort(() => Math.random() - 0.5);
+  return shuffled.slice(0, count);
+}
+
+// ============= PUBLIC MESSAGE FUNCTIONS =============
+
+export function successMessage() {
+  const pick1 = pick(successStart, 1)[0];
+  const pick2 = pick(rarePhrases, 1)[0];
+  // 5% chance of rare phrase
+  const showRare = Math.random() < 0.05;
+  return showRare ? `${pick1}\n\n${c.dim("💎 Easter egg:")} ${pick2}` : pick1;
+}
+
+export function farewellMessage() {
+  return pick(farewell, 1)[0];
+}
+
+export function noAgentMessage() {
+  return pick(noAgentPhrases, 1)[0];
+}
+
+export function installingMessage() {
+  return pick(installingPhrases, 1)[0];
+}
+
+export function thinkingMessage() {
+  return pick(thinkingPhrases, 1)[0];
+}
+
+export function errorMessage() {
+  return pick(errorPhrases, 1)[0];
+}
+
+export function cancelMessage() {
+  return pick(cancelPhrases, 1)[0];
+}
+
+// All goodbye variants - randomly rotate
+export function randomGoodbye() {
+  const options = [
+    "🐙 O polvo mandou um abraço!",
+    "✨ Que os commits sejam verdes!",
+    "🚀 Vai lá brilhar!",
+    "💜 Tchauzinho do NOITON!",
+    "🎯 Acerta em cheio!",
+    "🐙 *squish* (tradução: até mais)",
+    "👋 Bye bye do polvo!",
+  ];
+  return options[Math.floor(Math.random() * options.length)];
+}

package/src/octopus.js

@@ -0,0 +1,254 @@
+/**
+ * NOITON Octopus Mascot - "O Polvo NOITON"
+ *
+ * Design philosophy:
+ *   - Smooth organic curves using ╭╮╰╯ ◠ ◡ ⌒ ~ characters
+ *   - Round bulbous head with expressive eyes
+ *   - 8 graceful flowing tentacles (not blocky)
+ *   - Brand gradient: purple → magenta → pink → cyan
+ */
+
+import gradient from "gradient-string";
+
+// NOITON brand gradient
+const brandGradient = gradient([
+  "#A78BFA", // light purple
+  "#C084FC", // purple
+  "#E879F9", // magenta
+  "#F472B6", // pink
+  "#22D3EE", // cyan
+]);
+
+const successGradient = gradient(["#34D399", "#22D3EE", "#A78BFA"]);
+const errorGradient = gradient(["#F87171", "#EF4444"]);
+
+/**
+ * Main happy octopus - graceful, friendly, ready to help
+ * Clean organic curves, expressive eyes, flowing tentacles
+ */
+export function octopusHappy() {
+  return brandGradient.multiline(`
+             ╭━━━━━━━━━╮
+            ╱           ╲
+           │  ◉     ◉   │
+           │    ◡       │
+            ╲___________╱
+             │ ╲___╱ │
+            ╭┤       ├╮
+           ╭┘╰┐   ╭━┘╰┐
+          ╭┘  ╰╮ ╭┘   ╰┐
+         ╭┘ ◠  ╰━╯  ◠  ╰┐
+        ╭┘               ╰┐
+       ╭┘  ♥   ✦   ♥     ╰┐
+       │                    │
+       ╰╮                  ╭╯
+         ╰╮   ✦     ♥    ╭╯
+           ╰╮           ╭╯
+             ╰─✦───♥─✦─╯
+`);
+}
+
+/**
+ * Compact octopus for tight spaces
+ */
+export function octopusMini() {
+  return brandGradient.multiline(`
+        ╭━━━━━╮
+       ╱ ◉   ◉ ╲
+       │   ◡    │
+        ╲_______╱
+        ╭╯   ╰╮
+       ╭┘ ◠ ◠ ╰┐
+       ╰╮  ♥  ╭╯
+         ╰───╯
+`);
+}
+
+/**
+ * Curious octopus - looking around with question marks
+ */
+export function octopusCurious() {
+  return brandGradient.multiline(`
+             ╭━━━━━━━━━╮
+            ╱           ╲
+           │  ?     ?   │
+           │    ◡       │
+            ╲___________╱
+             │ ╲___╱ │
+            ╭┤       ├╮
+           ╭┘╰┐   ╭━┘╰┐
+          ╭┘  ╰╮ ╭┘   ╰┐
+         ╭┘    ╰━╯     ╰┐
+        ╭┘                ╰┐
+       ╭┘   ?    ?     ?   ╰┐
+       │                      │
+       ╰╮                    ╭╯
+         ╰╮                ╭╯
+           ╰╮   ?    ?   ╭╯
+             ╰───────────╯
+`);
+}
+
+/**
+ * Working octopus - focused, with swirly eyes
+ */
+export function octopusWorking() {
+  return brandGradient.multiline(`
+             ╭━━━━━━━━━╮
+            ╱           ╲
+           │  @     @   │
+           │    ▬       │
+            ╲___________╱
+             │ ╲___╱ │
+            ╭┤       ├╮
+           ╭┘╰┐   ╭━┘╰┐
+          ╭┘  ╰╮ ╭┘   ╰┐
+         ╭┘ ◠  ╰━╯  ◠  ╰┐
+        ╭┘    ⚙          ╰┐
+       ╭┘   ⚙    ⚙    ⚙   ╰┐
+       │   ⚙            ⚙  │
+       ╰╮      ⚙   ⚙     ╭╯
+         ╰╮              ╭╯
+           ╰╮──⚙───⚙──⚙─╭╯
+             ╰───────────╯
+`);
+}
+
+/**
+ * Dancing/celebrating octopus - happy eyes, hearts and stars
+ */
+export function octopusDancing() {
+  return successGradient.multiline(`
+             ╭━━━━━━━━━╮
+            ╱           ╲
+           │  ◠     ◠   │
+           │    ◡       │
+            ╲___________╱
+             │ ╲___╱ │
+            ╭┤       ├╮
+       ✦   ╭┘╰┐   ╭━┘╰┐   ✦
+      ╭━━━╭┘  ╰╮ ╭┘   ╰┐━━━╮
+     ╭━━━╭┘ ◠  ╰━╯  ◠  ╰┐━━━╮
+    ╭━━━╭┘                ╰┐━━━╮
+   ╭━━━╭┘   ♥   ★    ♥    ╰┐━━━╮
+   │                          │
+   ╰╮   ★    ♥    ★    ♥   ╭╯
+     ╰╮                    ╭╯
+   ★  ╰╮    ♥   ★    ♥  ╭╯  ★
+        ╰─★──♥───★──♥──★╯
+          ♪     ♥     ♪
+`);
+}
+
+/**
+ * Sad octopus - drooping tentacles
+ */
+export function octopusSad() {
+  return errorGradient.multiline(`
+             ╭━━━━━━━━━╮
+            ╱           ╲
+           │  .     .   │
+           │    ╲       │
+            ╲___________╱
+             │ ╲___╱ │
+            ╭┤       ├╮
+           ╭┘╰┐   ╭━┘╰┐
+         ╭━┘  ╰╮ ╭┘   ╰━╗
+        ╭┘     ╰━╯     ╰┐
+       ╭┘                  ╰┐
+       │                    │
+       ╰╮                  ╭╯
+         ╰╮              ╭╯
+           ╰╮          ╭╯
+             ╰╮      ╭╯
+               ╰──────╯
+`);
+}
+
+/**
+ * Sleeping octopus - zzz floating
+ */
+export function octopusSleeping() {
+  return brandGradient.multiline(`
+             ╭━━━━━━━━━╮
+            ╱           ╲
+           │  -     -   │
+           │    ▬       │
+            ╲___________╱    z
+             │ ╲___╱ │     zZ
+            ╭┤       ├╮   zZZ
+           ╭┘╰┐   ╭━┘╰┐
+          ╭┘  ╰╮ ╭┘   ╰┐
+         ╭┘    ╰━╯     ╰┐
+        ╭┘  z            ╰┐
+       ╭┘   zZ            ╰┐
+       │   zZZ             │
+       ╰╮                  ╭╯
+         ╰╮              ╭╯
+           ╰──────────────╯
+`);
+}
+
+/**
+ * Coding octopus - typing on keyboard
+ */
+export function octopusCoding() {
+  return brandGradient.multiline(`
+             ╭━━━━━━━━━╮
+            ╱           ╲
+           │  ◉     ◉   │
+           │    ◡       │
+            ╲___________╱
+             │ ╲___╱ │
+            ╭┤       ├╮
+       ╭───╭┘╰┐   ╭━┘╰┐───╮
+      ╭┘  ╭┘  ╰╮ ╭┘   ╰┐  ╰┐
+     ╭┘  ╭┘ ◠  ╰━╯  ◠  ╰┐  ╰┐
+    ╭┘   ╭┘            ╰┐   ╰┐
+   ╭┘   ╭┘              ╰┐   ╰┐
+   │    │   [ / / / / ]   │    │
+   ╰╮   ╰╮              ╭╯   ╭╯
+     ╰╮  ╰╮  ▓▓▓▓▓▓▓  ╭╯   ╭╯
+       ╰╮ ╰╮          ╭╯   ╭╯
+         ╰╮╰──────────╯   ╭╯
+           ╰╮    ▓▓     ╭╯
+             ╰──────────╯
+`);
+}
+
+/**
+ * NOITON wordmark logo with small octopus on top
+ */
+export function octopusLogo() {
+  return brandGradient.multiline(`
+                  ╭━━━━━╮
+                 ╱ ◉   ◉ ╲
+                 │   ◡    │
+                  ╲_______╱
+                  ╭╯   ╰╮
+                 ╭┘ ◠ ◠ ╰┐
+                 ╰╮  ♥  ╭╯
+                   ╰───╯
+
+     ███╗   ██╗ ██████╗ ██╗████████╗ ██████╗ ███╗   ██╗
+     ████╗  ██║██╔═══██╗██║╚══██╔══╝██╔═══██╗████╗  ██║
+     ██╔██╗ ██║██║   ██║██║   ██║   ██║   ██║██╔██╗ ██║
+     ██║╚██╗██║██║   ██║██║   ██║   ██║   ██║██║╚██╗██║
+     ██║ ╚████║╚██████╔╝██║   ██║   ╚██████╔╝██║ ╚████║
+     ╚═╝  ╚═══╝ ╚═════╝ ╚═╝   ╚═╝    ╚═════╝ ╚═╝  ╚═══╝
+`);
+}
+
+/**
+ * Get a random octopus pose
+ */
+export function randomOctopus() {
+  const poses = [octopusHappy, octopusDancing, octopusCoding];
+  return poses[Math.floor(Math.random() * poses.length)]();
+}
+
+export {
+  brandGradient,
+  successGradient,
+  errorGradient,
+};