@agentprojectcontext/apx 1.2.0 → 1.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentprojectcontext/apx",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "APX — unified CLI + daemon for the Agent Project Context (APC) standard.",
   "publishConfig": {
     "access": "public"

package/src/cli/commands/setup.js

@@ -6,8 +6,9 @@ import fs from "node:fs";
 import https from "node:https";
 import http from "node:http";
 import readline from "node:readline";
-import { spawnSync, spawn } from "node:child_process";
-import { readConfig, writeConfig, APX_HOME } from "../../core/config.js";
+import { spawnSync } from "node:child_process";
+import { readConfig, writeConfig } from "../../core/config.js";
+import { mascot } from "../../core/mascot.js";
 
 // ── ANSI helpers ──────────────────────────────────────────────────────────────
 const c = {
@@ -93,13 +94,8 @@ const PROVIDERS = [
 export async function cmdSetup() {
   initRl();
 
-  console.log();
-  console.log(b(cy("  ╔═══════════════════════════════════╗")));
-  console.log(b(cy("  ║        APX Setup Wizard           ║")));
-  console.log(b(cy("  ╚═══════════════════════════════════╝")));
-  console.log();
-  console.log(di("  This will configure the APX daemon and super-agent."));
-  console.log(di("  You can re-run `apx setup` at any time to change settings."));
+  mascot("wave", "Setup Wizard — configure daemon, model, and channels");
+  console.log(di("  Re-run `apx setup` anytime to change settings."));
   console.log();
 
   // ── Super-agent? ────────────────────────────────────────────────────────────

package/src/cli/index.js

@@ -74,6 +74,7 @@ import { cmdCommandList, cmdCommandShow } from "./commands/command.js";
 import { cmdUpdate } from "./commands/update.js";
 import { cmdSetup } from "./commands/setup.js";
 import { checkForUpdate } from "../core/update-check.js";
+import { mascot } from "../core/mascot.js";
 import {
   cmdRoutineList,
   cmdRoutineGet,
@@ -246,7 +247,9 @@ function parseArgs(argv) {
 }
 
 function die(msg, code = 1) {
-  process.stderr.write(`apx: ${msg}\n`);
+  // Show panda mascot for user-facing errors
+  const isUnknown = msg.startsWith("unknown command") || msg.startsWith("unknown");
+  mascot(isUnknown ? "confused" : "sad", `apx: ${msg}`);
   process.exit(code);
 }
 

package/src/core/mascot.js

@@ -0,0 +1,124 @@
+// APX mascot — a panda that appears in different moods across the CLI.
+// Usage: import { mascot } from '../core/mascot.js'; mascot('happy');
+
+const R = "\x1b[0m";
+const B = "\x1b[1m";
+const W = "\x1b[97m";       // bright white
+const K = "\x1b[30m";       // black
+const BK = "\x1b[40m";      // bg black
+const BW = "\x1b[47m";      // bg white
+const CY = "\x1b[36m";
+const YE = "\x1b[33m";
+const GR = "\x1b[32m";
+const RE = "\x1b[31m";
+const DI = "\x1b[2m";
+const BL = "\x1b[34m";
+
+// Each mood: [panda lines, caption]
+const MOODS = {
+  // ─── happy: default greeting / daemon started ────────────────────────────
+  happy: {
+    color: GR,
+    lines: [
+      `   ${BK}${W}  ▄███████▄  ${R}`,
+      `  ${BK}${W} █ ${R}${B}██${R}${W}   ${B}██${R}${BK}${W} █ ${R}`,
+      `  ${BK}${W} █  ◕   ◕  █ ${R}`,
+      `  ${BK}${W} █   ╰ω╯   █ ${R}`,
+      `   ${BK}${W}  ▀███████▀  ${R}`,
+      `   ${DI}   ╱  ╲  ╱  ╲   ${R}`,
+    ],
+    caption: `${GR}${B}ready to go!${R}`,
+  },
+
+  // ─── wave: first run / setup ─────────────────────────────────────────────
+  wave: {
+    color: CY,
+    lines: [
+      `   ${BK}${W}  ▄███████▄  ${R}     👋`,
+      `  ${BK}${W} █ ${R}${B}██${R}${W}   ${B}██${R}${BK}${W} █ ${R}`,
+      `  ${BK}${W} █  ◕   ◕  █ ${R}`,
+      `  ${BK}${W} █   ╰▽╯   █ ${R}`,
+      `   ${BK}${W}  ▀███████▀  ${R}`,
+      `   ${DI}   ╱  ╲  ╱  ╲   ${R}`,
+    ],
+    caption: `${CY}${B}APX — Agent Project Context${R}`,
+  },
+
+  // ─── confused: unknown command / not found ────────────────────────────────
+  confused: {
+    color: YE,
+    lines: [
+      `   ${BK}${W}  ▄███████▄  ${R}  ${YE}?${R}`,
+      `  ${BK}${W} █ ${R}${B}██${R}${W}   ${B}██${R}${BK}${W} █ ${R}`,
+      `  ${BK}${W} █  ◔   ◔  █ ${R}`,
+      `  ${BK}${W} █   ╰~╯   █ ${R}`,
+      `   ${BK}${W}  ▀███████▀  ${R}`,
+      `   ${DI}   ╱  ╲  ╱  ╲   ${R}`,
+    ],
+    caption: `${YE}${B}hmm, I don't know that one${R}`,
+  },
+
+  // ─── sad: error ───────────────────────────────────────────────────────────
+  sad: {
+    color: RE,
+    lines: [
+      `   ${BK}${W}  ▄███████▄  ${R}`,
+      `  ${BK}${W} █ ${R}${B}██${R}${W}   ${B}██${R}${BK}${W} █ ${R}`,
+      `  ${BK}${W} █  ╥   ╥  █ ${R}`,
+      `  ${BK}${W} █   ╰︵╯   █ ${R}`,
+      `   ${BK}${W}  ▀███████▀  ${R}`,
+      `   ${DI}   ╱  ╲  ╱  ╲   ${R}`,
+    ],
+    caption: `${RE}${B}something went wrong${R}`,
+  },
+
+  // ─── excited: update available ────────────────────────────────────────────
+  excited: {
+    color: BL,
+    lines: [
+      `   ${BK}${W}  ▄███████▄  ${R}  ${BL}⬆${R}`,
+      `  ${BK}${W} █ ${R}${B}██${R}${W}   ${B}██${R}${BK}${W} █ ${R}`,
+      `  ${BK}${W} █  ★   ★  █ ${R}`,
+      `  ${BK}${W} █   ╰◡╯   █ ${R}`,
+      `   ${BK}${W}  ▀███████▀  ${R}`,
+      `   ${DI}   ╱  ╲  ╱  ╲   ${R}`,
+    ],
+    caption: `${BL}${B}new version available!${R}`,
+  },
+
+  // ─── sleeping: daemon not running ────────────────────────────────────────
+  sleeping: {
+    color: DI,
+    lines: [
+      `   ${BK}${W}  ▄███████▄  ${R}  ${DI}z z z${R}`,
+      `  ${BK}${W} █ ${R}${B}██${R}${W}   ${B}██${R}${BK}${W} █ ${R}`,
+      `  ${BK}${W} █  −   −  █ ${R}`,
+      `  ${BK}${W} █   ╰_╯   █ ${R}`,
+      `   ${BK}${W}  ▀███████▀  ${R}`,
+      `   ${DI}   ╱  ╲  ╱  ╲   ${R}`,
+    ],
+    caption: `${DI}${B}daemon is not running${R}`,
+  },
+};
+
+// Print the mascot to stderr (doesn't interfere with piped output).
+// mood: 'happy' | 'wave' | 'confused' | 'sad' | 'excited' | 'sleeping'
+export function mascot(mood = "happy", message = "") {
+  const def = MOODS[mood] || MOODS.happy;
+  const out = [
+    "",
+    ...def.lines,
+    `      ${def.caption}`,
+    message ? `   ${def.color}${message}${R}` : "",
+    "",
+  ].join("\n");
+  process.stderr.write(out + "\n");
+}
+
+// One-liner for inline use: mascot.confused("apx: unknown command: foo")
+mascot.confused  = (msg) => mascot("confused",  msg);
+mascot.sad       = (msg) => mascot("sad",       msg);
+mascot.happy     = (msg) => mascot("happy",     msg);
+mascot.wave      = (msg) => mascot("wave",      msg);
+mascot.excited   = (msg) => mascot("excited",   msg);
+mascot.sleeping  = (msg) => mascot("sleeping",  msg);