gent-cli 11.0.0 → 12.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gent-cli",
-  "version": "11.0.0",
+  "version": "12.0.0",
   "description": "A modern, Git-like version control CLI with cloud sync, AI-powered superpowers (ask/review/docs/changelog), and zero-friction setup (gent setup/doctor/config).",
   "main": "src/index.js",
   "bin": {

package/src/commands/pet.js

@@ -0,0 +1,448 @@
+/**
+ * Pet Command — "Genti", the gent mascot.
+ *
+ * A chunky pixel-block creature that lives in your terminal and *acts out*
+ * gent workflows:
+ *
+ *   gent pet            → idle: Genti breathes, blinks, waves, drops a tip
+ *   gent pet push       → walks a file crate to the cloud, over and over
+ *   gent pet pull       → carries a crate back from the cloud
+ *   gent pet merge      → stands between two branches and "thinks" them together
+ *   gent pet auth       → little sign-in scene
+ *
+ *   --once      play a few cycles, then exit (good for scripts / shell startup)
+ *   --no-color  plain output (also honors NO_COLOR)
+ *
+ * Rendering: everything is drawn onto a colored character Canvas (one cell =
+ * one terminal column with its own color), then flushed as ANSI each frame.
+ * This keeps every sprite pixel-aligned regardless of color runs.
+ */
+
+const chalk = require('chalk');
+const authStorage = require('../utils/auth-storage');
+
+const FRAME_MS = 90;
+
+// ── Palette ──────────────────────────────────────────────────────────────
+const C = {
+    body:   chalk.hex('#c97b5a'),   // Genti's orange skin
+    shade:  chalk.hex('#9c5a3f'),   // bottom shading
+    eye:    chalk.hex('#15110f'),   // dark eye holes
+    mouth:  chalk.hex('#5a2f22'),
+    crate:  chalk.hex('#e0b64d'),   // file crate edges
+    crateIn:chalk.hex('#b98a1f'),   // crate fill
+    cloud:  chalk.hex('#d6def0'),   // remote / cloud
+    cloudSh:chalk.hex('#8a93ad'),
+    spark:  chalk.hex('#ffe08a'),
+    branchA:chalk.hex('#5ac8c9'),
+    branchB:chalk.hex('#c98ad6'),
+    node:   chalk.hex('#8ae06a'),
+    ok:     chalk.hex('#8ae06a'),
+    dim:    chalk.gray,
+    say:    chalk.hex('#e6e6e6'),
+};
+
+// legend char → { color fn, glyph }
+const INK = {
+    '#': [C.body,    '█'],
+    '@': [C.shade,   '█'],
+    'O': [C.eye,     '█'],
+    '_': [C.mouth,   '▄'],
+    'o': [C.mouth,   '▄'],
+    '=': [C.crate,   '█'],
+    ':': [C.crateIn, '▒'],
+    '%': [C.cloud,   '█'],
+    '&': [C.cloudSh, '█'],
+    '*': [C.spark,   '✦'],
+    '|': [C.branchA, '│'],
+    '/': [C.branchA, '╱'],
+    'A': [C.branchA, '●'],
+    '\\':[C.branchB, '╲'],
+    'B': [C.branchB, '●'],
+    'M': [C.node,    '●'],
+};
+
+// ── Canvas ───────────────────────────────────────────────────────────────
+class Canvas {
+    constructor(w, h) {
+        this.w = w; this.h = h;
+        this.clear();
+    }
+    clear() {
+        this.cells = Array.from({ length: this.h }, () =>
+            Array.from({ length: this.w }, () => ({ ch: ' ', fn: null })));
+    }
+    put(x, y, ch, fn) {
+        if (y < 0 || y >= this.h || x < 0 || x >= this.w) return;
+        this.cells[y][x] = { ch, fn };
+    }
+    // Draw a sprite (array of strings). ' ' and '.' are transparent.
+    sprite(rows, x, y) {
+        rows.forEach((row, dy) => {
+            for (let dx = 0; dx < row.length; dx++) {
+                const c = row[dx];
+                if (c === ' ' || c === '.') continue;
+                const ink = INK[c];
+                if (ink) this.put(x + dx, y + dy, ink[1], ink[0]);
+                else this.put(x + dx, y + dy, c, C.say);
+            }
+        });
+    }
+    text(x, y, str, fn) {
+        for (let i = 0; i < str.length; i++) this.put(x + i, y, str[i], fn);
+    }
+    render() {
+        const out = [];
+        for (let y = 0; y < this.h; y++) {
+            let line = '';
+            let run = '';
+            let runFn = null;
+            const flush = () => {
+                if (!run) return;
+                line += runFn ? runFn(run) : run;
+                run = '';
+            };
+            for (let x = 0; x < this.w; x++) {
+                const cell = this.cells[y][x];
+                if (cell.fn !== runFn) { flush(); runFn = cell.fn; }
+                run += cell.ch;
+            }
+            flush();
+            out.push(line);
+        }
+        return out.join('\n');
+    }
+}
+
+// ── Mascot sprite ────────────────────────────────────────────────────────
+// Body is a 12-wide block with a 1-col margin (transparent) each side.
+function mascot({ blink = false, mouth = '_', armUp = false } = {}) {
+    const W = 12;
+    const rows = [];
+    rows[0] = ' ' + '#'.repeat(W) + ' ';
+    rows[1] = ' ' + '#'.repeat(W) + ' ';
+    rows[2] = ' ' + '#'.repeat(W) + ' ';   // eyes row
+    rows[3] = ' ' + '#'.repeat(W) + ' ';
+    rows[4] = ' ' + '#'.repeat(W) + ' ';   // mouth row
+    rows[5] = ' ' + '@'.repeat(W) + ' ';   // shaded chin
+
+    const grid = rows.map(r => r.split(''));
+    const eye = blink ? '#' : 'O';
+    // eyes at body cols 3-4 and 8-9 → +1 for margin
+    [3, 4].forEach(c => grid[2][c + 1] = eye);
+    [8, 9].forEach(c => grid[2][c + 1] = eye);
+    // mouth at cols 5-8 (row4)
+    for (let c = 5; c <= 8; c++) grid[4][c + 1] = mouth;
+    // ears (stick out at row2)
+    grid[2][0] = '#';
+    grid[2][W + 1] = '#';
+
+    let body = grid.map(r => r.join(''));
+
+    // arm (raised wave) sits to the right of the head on row1
+    if (armUp) {
+        const r1 = body[1].split('');
+        r1[W + 1] = '#';
+        body[1] = r1.join('');
+        body.unshift('             #'); // tiny raised hand
+    } else {
+        body.unshift('              ');
+    }
+    return body; // 7 rows (incl. leading arm/space row), 14 wide
+}
+
+// Legs are separate so they can shuffle while the body glides.
+function legs(step) {
+    // step: 'stand' | 'a' | 'b'
+    const map = {
+        stand: '   ##      ##  ',
+        a:     '   ##       #  ',
+        b:     '   #       ##  ',
+    };
+    return [map[step] || map.stand];
+}
+
+// ── Props ────────────────────────────────────────────────────────────────
+const CRATE = [
+    '======',
+    '=::::=',
+    '=::::=',
+    '======',
+];
+
+const CLOUD = [
+    '  %%%%%%  ',
+    '%%%%%%%%%%',
+    '&&%%%%%%&&',
+];
+
+// ── Speech bubble (drawn straight to canvas as text) ─────────────────────
+function drawBubble(cv, line1, line2, color) {
+    const w = Math.max(line1.length, (line2 || '').length);
+    cv.text(2, 0, '╭' + '─'.repeat(w + 2) + '╮', C.dim);
+    cv.text(2, 1, '│ ', C.dim);
+    cv.text(4, 1, line1.padEnd(w), color || C.say);
+    cv.text(4 + w, 1, ' │', C.dim);
+    if (line2) {
+        cv.text(2, 2, '│ ', C.dim);
+        cv.text(4, 2, line2.padEnd(w), chalk.bold.white);
+        cv.text(4 + w, 2, ' │', C.dim);
+        cv.text(2, 3, '╰┬' + '─'.repeat(w) + '─╯', C.dim);
+        cv.text(4, 4, '╲', C.dim);
+    } else {
+        cv.text(2, 2, '╰┬' + '─'.repeat(w) + '─╯', C.dim);
+        cv.text(4, 3, '╲', C.dim);
+    }
+}
+
+// ── Scenes ───────────────────────────────────────────────────────────────
+// Every scene fills a fresh canvas for tick `t`. Stage lives below the bubble.
+const STAGE_TOP = 5;      // first row used by the world floor
+const CV_W = 52;
+const CV_H = 15;
+
+function walkStep(t) { return (Math.floor(t / 3) % 2) ? 'a' : 'b'; }
+
+function sceneIdle(cv, t, tip) {
+    drawBubble(cv, tip.say, tip.cmd ? '$ ' + tip.cmd : null, tip.color);
+    const bob = (Math.floor(t / 8) % 2);          // gentle breathing
+    const blink = (t % 40) < 2;
+    const wave = (t % 60) < 12;                    // occasional wave
+    const y = STAGE_TOP + bob;
+    cv.sprite(mascot({ blink, armUp: wave }), 6, y);
+    cv.sprite(legs('stand'), 6, y + 7);
+}
+
+function sceneAuth(cv, t) {
+    const stages = [
+        ['Knock knock — let me in!', 'gent login'],
+        ['New around here?',          'gent register'],
+        ['Who am I again?',           'gent whoami'],
+    ];
+    const idx = Math.floor(t / 34) % stages.length;
+    const [say, cmd] = stages[idx];
+    drawBubble(cv, say, '$ ' + cmd, C.branchA);
+    const blink = (t % 30) < 2;
+    const y = STAGE_TOP + (Math.floor(t / 8) % 2);
+    // a little door/key on the right
+    cv.sprite(['%%%%', '%::%', '%::%', '%%%%'], 34, STAGE_TOP + 1);
+    cv.text(34, STAGE_TOP, ' remote', C.cloudSh);
+    cv.sprite(mascot({ blink, armUp: (t % 40) < 14 }), 6, y);
+    cv.sprite(legs('stand'), 6, y + 7);
+}
+
+// PUSH: walk crate right → toss into cloud → walk back. Repeat.
+function scenePush(cv, t, state) {
+    drawBubble(cv, 'Pushing your commits to the cloud…', '$ gent push', C.ok);
+    const cloudX = 40, cloudY = STAGE_TOP;
+    cv.sprite(CLOUD, cloudX, cloudY);
+    cv.text(cloudX + 2, cloudY + 3, 'remote', C.cloudSh);
+
+    const CYCLE = 66;
+    const p = t % CYCLE;
+    const my = STAGE_TOP + 1;
+
+    const startX = 4, turnX = 30;
+    if (p < 26) {
+        // walk out carrying crate
+        const mx = startX + Math.round((turnX - startX) * (p / 26));
+        cv.sprite(mascot({ blink: (t % 22) < 2 }), mx, my);
+        cv.sprite(legs(walkStep(t)), mx, my + 7);
+        cv.sprite(CRATE, mx + 14, my + 2);
+    } else if (p < 34) {
+        // toss: crate flies up-right into the cloud, sparkle
+        const k = (p - 26) / 8;
+        const bx = Math.round(turnX + 14 + (cloudX - (turnX + 14)) * k);
+        const by = Math.round((my + 2) - 3 * k);
+        cv.sprite(mascot({ mouth: 'o', armUp: true }), turnX, my);
+        cv.sprite(legs('stand'), turnX, my + 7);
+        cv.sprite(CRATE, bx, by);
+        if (k > 0.6) cv.text(cloudX + 4, cloudY + 1, '*', C.spark);
+    } else if (p < 58) {
+        // walk back empty-handed
+        const mx = turnX - Math.round((turnX - startX) * ((p - 34) / 24));
+        cv.sprite(mascot({ blink: (t % 22) < 2 }), mx, my);
+        cv.sprite(legs(walkStep(t)), mx, my + 7);
+    } else {
+        // brief cheer + count up
+        if (p === 58) state.count++;
+        cv.sprite(mascot({ mouth: 'o', armUp: (p % 4 < 2) }), startX, my);
+        cv.sprite(legs('stand'), startX, my + 7);
+        cv.text(cloudX + 1, cloudY + 1, '*  *', C.spark);
+    }
+    cv.text(2, CV_H - 1, `pushed ${state.count} crate${state.count === 1 ? '' : 's'} ✓`, C.ok);
+}
+
+// PULL: crate drops from cloud → Genti catches → carries it home.
+function scenePull(cv, t, state) {
+    drawBubble(cv, 'Pulling the latest from remote…', '$ gent pull', C.branchA);
+    const cloudX = 40, cloudY = STAGE_TOP;
+    cv.sprite(CLOUD, cloudX, cloudY);
+    cv.text(cloudX + 2, cloudY + 3, 'remote', C.cloudSh);
+
+    const CYCLE = 64;
+    const p = t % CYCLE;
+    const my = STAGE_TOP + 1;
+    const homeX = 4, catchX = 30;
+
+    if (p < 10) {
+        // Genti walks out to meet the delivery
+        const mx = homeX + Math.round((catchX - homeX) * (p / 10));
+        cv.sprite(mascot({ blink: (t % 20) < 2 }), mx, my);
+        cv.sprite(legs(walkStep(t)), mx, my + 7);
+    } else if (p < 20) {
+        // crate falls from cloud toward Genti's hands
+        const k = (p - 10) / 10;
+        const bx = Math.round(cloudX - (cloudX - (catchX + 14)) * k);
+        const by = Math.round((cloudY + 2) + ((my + 2) - (cloudY + 2)) * k);
+        cv.sprite(mascot({ mouth: 'o', armUp: true }), catchX, my);
+        cv.sprite(legs('stand'), catchX, my + 7);
+        cv.sprite(CRATE, bx, by);
+    } else if (p < 46) {
+        // carry it home
+        const mx = catchX - Math.round((catchX - homeX) * ((p - 20) / 26));
+        cv.sprite(mascot({ blink: (t % 22) < 2 }), mx, my);
+        cv.sprite(legs(walkStep(t)), mx, my + 7);
+        cv.sprite(CRATE, mx + 14, my + 2);
+    } else {
+        if (p === 46) state.count++;
+        cv.sprite(mascot({ mouth: 'o' }), homeX, my);
+        cv.sprite(legs('stand'), homeX, my + 7);
+        cv.sprite(CRATE, homeX + 14, my + 2);
+        cv.text(homeX + 6, my - 1, '*', C.spark);
+    }
+    cv.text(2, CV_H - 1, `pulled ${state.count} crate${state.count === 1 ? '' : 's'} ✓`, C.branchA);
+}
+
+// MERGE: two branches converge; Genti thinks, then a merge node lights up.
+function sceneMerge(cv, t, state) {
+    const CYCLE = 70;
+    const p = t % CYCLE;
+    const thinking = p < 40;
+    const dots = '.'.repeat(1 + (Math.floor(t / 5) % 3));
+    drawBubble(cv,
+        thinking ? `Reconciling two histories${dots}` : 'Merged cleanly — no conflicts!',
+        '$ gent merge feature',
+        thinking ? C.branchB : C.ok);
+
+    const my = STAGE_TOP + 1;
+    const baseY = my + 3;
+    // branch A (top) flows down-right, branch B (bottom) flows up-right, meet at node
+    const nodeX = 40, nodeY = baseY;
+    for (let x = 24; x < nodeX; x++) {
+        const ay = baseY - 3 + Math.round((x - 24) / (nodeX - 24) * 3);
+        const by = baseY + 3 - Math.round((x - 24) / (nodeX - 24) * 3);
+        cv.put(x, ay, '╲'.length ? '╲' : '\\', C.branchA);
+        cv.put(x, by, '╱', C.branchB);
+    }
+    cv.put(23, baseY - 3, '●', C.branchA);
+    cv.put(23, baseY + 3, '●', C.branchB);
+
+    if (thinking) {
+        // thought bubble ". o O" above head
+        cv.text(18, my - 1, '. o O', C.dim);
+        cv.sprite(mascot({ mouth: 'o', blink: (t % 16) < 2 }), 6, my);
+    } else {
+        if (p === 40) state.count++;
+        cv.put(nodeX, nodeY, '●', C.node);
+        cv.text(nodeX - 1, nodeY - 1, '*', C.spark);
+        cv.text(nodeX - 1, nodeY + 1, '*', C.spark);
+        cv.sprite(mascot({ mouth: 'o', armUp: (p % 4 < 2) }), 6, my);
+    }
+    cv.sprite(legs('stand'), 6, my + 7);
+    cv.text(2, CV_H - 1, `merges resolved ${state.count} ✓`, C.node);
+}
+
+// ── Idle tips (used only by the idle scene) ─────────────────────────────
+const TIPS = [
+    { say: 'Ready when you are.',                 cmd: 'gent status',   color: C.body },
+    { say: 'Publish your work to the cloud.',     cmd: 'gent push',     color: C.ok },
+    { say: 'Grab everyone else\'s changes.',      cmd: 'gent pull',     color: C.branchA },
+    { say: 'New idea? Branch it.',                cmd: 'gent checkout -b idea', color: C.spark },
+    { say: 'Ask me about this repo.',             cmd: 'gent ask "what is this?"', color: C.branchB },
+    { say: 'Want a review of your diff?',         cmd: 'gent review',   color: C.node },
+    { say: 'Commit small, commit often.',         cmd: 'gent commit -m "wip"', color: C.body },
+];
+
+// ── Scene registry ───────────────────────────────────────────────────────
+const SCENES = {
+    idle:  { fn: (cv, t, st) => sceneIdle(cv, t, st.tip) },
+    push:  { fn: scenePush },
+    pull:  { fn: scenePull },
+    merge: { fn: sceneMerge },
+    auth:  { fn: (cv, t) => sceneAuth(cv, t) },
+    login: { fn: (cv, t) => sceneAuth(cv, t) },
+};
+
+// ── ANSI helpers ─────────────────────────────────────────────────────────
+const HOME = '[H';
+const CLEAR = '[2J[H';
+const HIDE = '[?25l';
+const SHOW = '[?25h';
+
+function play(sceneName, { once }) {
+    const scene = SCENES[sceneName] || SCENES.idle;
+    const cv = new Canvas(CV_W, CV_H);
+    const state = { count: 0, tip: TIPS[Math.floor(Math.random() * TIPS.length)] };
+    let t = 0;
+
+    process.stdout.write(HIDE + CLEAR);
+
+    const footer = () =>
+        chalk.gray('  scene: ') + C.body(sceneName) +
+        chalk.gray('   ·   try: ') + C.say('gent pet push|pull|merge') +
+        chalk.gray('   ·   Ctrl+C to leave');
+
+    const bye = () => {
+        process.stdout.write(SHOW + '\n');
+        console.log(C.body('  Genti waves. ') + chalk.gray('Come back with ') + C.say('gent pet') + chalk.gray('.'));
+    };
+
+    const timer = setInterval(() => {
+        cv.clear();
+        scene.fn(cv, t, state);
+        // rotate idle tip every ~6s
+        if (sceneName === 'idle' && t > 0 && t % 66 === 0) {
+            state.tip = TIPS[Math.floor(Math.random() * TIPS.length)];
+        }
+        process.stdout.write(HOME + cv.render() + '\n' + footer() + '\n');
+        t++;
+        if (once && t > 130) { clearInterval(timer); bye(); process.exit(0); }
+    }, FRAME_MS);
+
+    process.on('SIGINT', () => { clearInterval(timer); bye(); process.exit(0); });
+}
+
+// Static single frame for non-TTY (piped) output.
+function still(sceneName) {
+    const cv = new Canvas(CV_W, CV_H);
+    const state = { count: 1, tip: TIPS[Math.floor(Math.random() * TIPS.length)] };
+    (SCENES[sceneName] || SCENES.idle).fn(cv, 12, state);
+    console.log(cv.render());
+    console.log(chalk.gray('  (animated in a real terminal — run ') + C.say(`gent pet ${sceneName === 'idle' ? '' : sceneName}`.trim()) + chalk.gray(')'));
+}
+
+// ── Entry ────────────────────────────────────────────────────────────────
+async function petCommand(scene, options = {}) {
+    if (process.env.NO_COLOR || (options && options.color === false)) chalk.level = 0;
+
+    let name = (scene || 'idle').toLowerCase();
+    if (!SCENES[name]) {
+        console.log(chalk.yellow(`Genti doesn't know the scene "${name}".`));
+        console.log(chalk.gray('Try: ') + C.say('gent pet') + chalk.gray(' · ') +
+            C.say('push') + chalk.gray(' · ') + C.say('pull') + chalk.gray(' · ') +
+            C.say('merge') + chalk.gray(' · ') + C.say('auth'));
+        return;
+    }
+
+    // Signed-out nudge: default idle → auth scene the first time.
+    if (name === 'idle' && !options.stay) {
+        const authed = await authStorage.isAuthenticated().catch(() => false);
+        if (!authed) name = 'auth';
+    }
+
+    if (!process.stdout.isTTY) return still(name);
+    play(name, { once: !!options.once });
+}
+
+module.exports = petCommand;

package/src/index.js

@@ -78,6 +78,7 @@ const webCommand = require('./commands/web');
 const shareCommand = require('./commands/share');
 const searchCommand = require('./commands/search');
 const templateCommand = require('./commands/template');
+const petCommand = require('./commands/pet');
 
 // Configure CLI
 program
@@ -432,6 +433,14 @@ program
     .option('-e, --email <email>', 'Account email (for reset)')
     .action(passwordCommand);
 
+// ─── Fun ────────────────────────────────────────────────
+program
+    .command('pet [scene]')
+    .description('Meet Genti — an animated pixel mascot that acts out gent (push|pull|merge|auth)')
+    .option('--once', 'Play a few cycles, then exit (good for scripts / shell startup)')
+    .option('--stay', 'Stay on the idle scene even when signed out')
+    .action(petCommand);
+
 // Help command
 program
     .command('help [command]')
@@ -456,6 +465,7 @@ const HELP_GROUPS = [
     ['Account', ['register', 'login', 'logout', 'whoami', 'password']],
     ['AI', ['ask', 'review', 'docs', 'changelog', 'ai']],
     ['Config & tools', ['config', 'doctor', 'template', 'help']],
+    ['Fun', ['pet']],
 ];
 
 function configureGroupedHelp(program) {
@@ -526,6 +536,7 @@ function showQuickstart() {
     console.log(`  ${chalk.cyan('gent changelog')}          ${chalk.gray('grouped release notes')}`);
     console.log();
     console.log(chalk.gray('Full command list: ') + chalk.cyan('gent --help'));
+    console.log(chalk.gray('Say hi to your mascot: ') + chalk.cyan('gent pet'));
     console.log();
 }