writethevision 7.0.3 → 7.0.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "writethevision",
-  "version": "7.0.3",
+  "version": "7.0.5",
   "description": "Write The Vision (WTV): vision-driven development with the Habakkuk workflow. 10 agents + 21 skills for Claude Code, Codex CLI, and OpenCode.",
   "author": "Christopher Hogg",
   "license": "MIT",

package/src/cli.js

@@ -14,7 +14,7 @@ import {
     writeFileSync,
 } from 'fs';
 import { homedir, platform } from 'os';
-import { spawn } from 'child_process';
+import { spawn, spawnSync } from 'child_process';
 
 async function openInEditor(filePath) {
     const editor = process.env.EDITOR || 'vi';
@@ -402,13 +402,71 @@ function getAgentLocations() {
     return locations;
 }
 
-function brickifyAsciiArt(asciiArt) {
-    if (!asciiArt) return asciiArt;
+const BLOCK_FONT_3X5 = {
+    A: ['███', '█ █', '███', '█ █', '█ █'],
+    B: ['██ ', '█ █', '██ ', '█ █', '██ '],
+    C: ['███', '█  ', '█  ', '█  ', '███'],
+    D: ['██ ', '█ █', '█ █', '█ █', '██ '],
+    E: ['███', '█  ', '██ ', '█  ', '███'],
+    F: ['███', '█  ', '██ ', '█  ', '█  '],
+    G: ['███', '█  ', '█ █', '█ █', '███'],
+    H: ['█ █', '█ █', '███', '█ █', '█ █'],
+    I: ['███', ' █ ', ' █ ', ' █ ', '███'],
+    J: [' ██', '  █', '  █', '█ █', '██ '],
+    K: ['█ █', '█ █', '██ ', '█ █', '█ █'],
+    L: ['█  ', '█  ', '█  ', '█  ', '███'],
+    M: ['█ █', '███', '███', '█ █', '█ █'],
+    N: ['█ █', '███', '███', '███', '█ █'],
+    O: ['███', '█ █', '█ █', '█ █', '███'],
+    P: ['███', '█ █', '███', '█  ', '█  '],
+    Q: ['███', '█ █', '█ █', '███', '  █'],
+    R: ['███', '█ █', '███', '█ █', '█ █'],
+    S: ['███', '█  ', '███', '  █', '███'],
+    T: ['███', ' █ ', ' █ ', ' █ ', ' █ '],
+    U: ['█ █', '█ █', '█ █', '█ █', '███'],
+    V: ['█ █', '█ █', '█ █', '█ █', ' █ '],
+    W: ['█ █', '█ █', '███', '███', '█ █'],
+    X: ['█ █', '█ █', ' █ ', '█ █', '█ █'],
+    Y: ['█ █', '█ █', ' █ ', ' █ ', ' █ '],
+    Z: ['███', '  █', ' █ ', '█  ', '███'],
+    ' ': ['   ', '   ', '   ', '   ', '   '],
+    '-': ['   ', '   ', '███', '   ', '   '],
+    '?': ['███', '  █', ' ██', '   ', ' █ '],
+};
+
+function renderBlockText(text, { maxWidth = null, color = null, bold = false } = {}) {
+    const normalized = String(text || '').toUpperCase();
+    const glyphWidth = 3;
+    const letterGap = 1;
+    const maxCharsPerLine = maxWidth
+        ? Math.max(1, Math.floor((maxWidth + letterGap) / (glyphWidth + letterGap)))
+        : normalized.length;
+
+    const chunks = [];
+    for (let i = 0; i < normalized.length; i += maxCharsPerLine) {
+        chunks.push(normalized.slice(i, i + maxCharsPerLine));
+    }
+
+    const renderedLines = [];
+    for (let chunkIndex = 0; chunkIndex < chunks.length; chunkIndex++) {
+        const chunk = chunks[chunkIndex];
+        for (let row = 0; row < 5; row++) {
+            const rowText = chunk
+                .split('')
+                .map(ch => (BLOCK_FONT_3X5[ch] ? BLOCK_FONT_3X5[ch][row] : BLOCK_FONT_3X5['?']?.[row] || '???'))
+                .join(' '.repeat(letterGap));
+
+            const prefix = color ? (bold ? color + c.bold : color) : '';
+            const suffix = color ? c.reset : '';
+            renderedLines.push(prefix + rowText + suffix);
+        }
+
+        if (chunkIndex !== chunks.length - 1) {
+            renderedLines.push('');
+        }
+    }
 
-    return asciiArt
-        .split('\n')
-        .map(line => line.replace(/[^\s]/g, '█'))
-        .join('\n');
+    return renderedLines.join('\n');
 }
 
 function parseAgentFile(filePath) {
@@ -453,7 +511,7 @@ function parseAgentFile(filePath) {
         let asciiArt = '';
         const asciiMatch = content.match(/```text\n([\s\S]+?)\n```/);
         if (asciiMatch) {
-            asciiArt = brickifyAsciiArt(asciiMatch[1]);
+            asciiArt = asciiMatch[1];
         }
 
         return {
@@ -1191,15 +1249,16 @@ function habakkukStones() {
     console.log('');
 }
 
-function checkForUpdates() {
+async function checkForUpdates() {
     const shouldCheck = process.env.WTV_NO_UPDATE_CHECK !== '1' && process.env.CODEHOGG_NO_UPDATE_CHECK !== '1';
     if (!shouldCheck) return;
     if (!process.stdout.isTTY) return;
 
     try {
+        const packageName = getPackageName();
         const notifier = updateNotifier({
             pkg: {
-                name: getPackageName(),
+                name: packageName,
                 version: getVersion(),
             },
             updateCheckInterval: 1000 * 60 * 60 * 24 * 7,
@@ -1209,31 +1268,66 @@ function checkForUpdates() {
         const update = notifier.update;
         if (!update) return;
 
+        const npmGlobalCmd = `npm install -g ${packageName}@latest`;
+        const npxCmd = `npx -y ${packageName}@latest`;
+
         notifier.notify({
             message: `Update available ${c.dim}${update.current}${c.reset} → ${c.green}${update.latest}${c.reset}
-Run ${c.cyan}npx writethevision update${c.reset} to get the latest version`,
-            defer: false,
-            boxenOpts: {
-                padding: 1,
-                margin: 1,
-                align: 'center',
-                borderColor: 'yellow',
-                borderStyle: 'round',
-            },
-        });
 
-        notifier.notify({
-            message: `Update available ${c.dim}${notifier.update.current}${c.reset} → ${c.green}${notifier.update.latest}${c.reset}\nRun ${c.cyan}npx writethevision update${c.reset} to get the latest version`,
+Update global install:
+  ${c.cyan}${npmGlobalCmd}${c.reset}
+
+Or run latest once:
+  ${c.cyan}${npxCmd}${c.reset}
+`,
             defer: false,
             boxenOpts: {
                 padding: 1,
                 margin: 1,
-                align: 'center',
+                align: 'left',
                 borderColor: 'yellow',
                 borderStyle: 'round',
             },
         });
-    } catch (err) {
+
+        const shouldPrompt = process.stdin.isTTY && process.env.WTV_NO_AUTO_UPDATE !== '1' && !process.env.CI;
+        if (!shouldPrompt) return;
+
+        const isDevCheckout = existsSync(join(PACKAGE_ROOT, '.git'));
+        if (isDevCheckout) return;
+
+        const wantsUpdate = await confirm(`Update ${packageName} to v${update.latest} now?`, false);
+        if (!wantsUpdate) return;
+
+        const argv1 = process.argv[1] || '';
+        const userAgent = process.env.npm_config_user_agent || '';
+        const runningViaNpx = argv1.includes('_npx') || userAgent.includes('npx/');
+
+        if (runningViaNpx) {
+            console.log(`
+  ${c.yellow}${sym.warn}${c.reset} You're running via npx cache.`);
+            console.log(`  Next run: ${c.cyan}${npxCmd}${c.reset}
+`);
+            return;
+        }
+
+        const npmBin = process.platform === 'win32' ? 'npm.cmd' : 'npm';
+        const result = spawnSync(npmBin, ['install', '-g', `${packageName}@latest`], { stdio: 'inherit' });
+
+        if (result.status !== 0) {
+            console.log(`
+  ${c.red}${sym.cross}${c.reset} Update failed.`);
+            console.log(`  Try manually: ${c.cyan}${npmGlobalCmd}${c.reset}
+`);
+            return;
+        }
+
+        console.log(`
+  ${c.green}${sym.check}${c.reset} Updated ${packageName} to ${update.latest}.`);
+        console.log(`  Re-run ${c.cyan}wtv${c.reset} to use the new version.
+`);
+        process.exit(0);
+    } catch {
     }
 }
 
@@ -1685,11 +1779,7 @@ async function meetTheTeam() {
     console.log(`  ${c.bold}${c.yellow}PAUL — THE MASTERBUILDER${c.reset}`);
     console.log(`  ${c.dim}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${c.reset}`);
     const paulAgent = parseAgentFile(join(TEMPLATES_DIR, 'agents', 'paul.md'));
-    if (paulAgent && paulAgent.asciiArt) {
-        console.log(paulAgent.asciiArt);
-    } else {
-        console.log(AVATARS.paul);
-    }
+    console.log(AVATARS.paul || (paulAgent && paulAgent.asciiArt ? paulAgent.asciiArt : ''));
     await sleep(shortPause);
     console.log(`
   ${c.cyan}"According to the grace of God which is given unto me,${c.reset}
@@ -1719,11 +1809,7 @@ async function meetTheTeam() {
         console.log(`  ${artisan.color}${c.bold}${artisan.name}${c.reset}`);
         const templatePath = join(TEMPLATES_DIR, 'agents', artisan.file);
         const agent = parseAgentFile(templatePath);
-        if (agent && agent.asciiArt) {
-            console.log(agent.asciiArt);
-        } else {
-            console.log(AVATARS[artisan.id]);
-        }
+        console.log(AVATARS[artisan.id] || (agent && agent.asciiArt ? agent.asciiArt : ''));
         console.log(`  ${c.dim}${artisan.domain}${c.reset}`);
         if (artisan.verse) {
             console.log(`  ${c.dim}${artisan.verse.ref}${c.reset} ${c.dim}"${artisan.verse.text}"${c.reset}`);
@@ -3522,13 +3608,15 @@ async function agentsInteractive() {
         if (agent.wantsGlobal) statusText += c.blue + 'Global ' + c.reset;
         if (!agent.wantsLocal && !agent.wantsGlobal) statusText = c.dim + 'None' + c.reset;
 
+        const terminalWidth = process.stdout.columns || 80;
+        const detailWidth = Math.max(20, terminalWidth - detailStartX - 1);
+        const nameBanner = renderBlockText(agent.name, { maxWidth: detailWidth, color: c.magenta, bold: true });
+
         const details = [
-            `${c.magenta}${c.bold}${agent.name.toUpperCase()}${c.reset}`,
+            nameBanner,
             `Status: ${statusText}`,
             '',
             `${c.dim}${agent.description}${c.reset}`,
-            '',
-            agent.asciiArt ? agent.asciiArt : `${c.dim}[ No Portrait ]${c.reset}`
         ];
 
         // Draw details
@@ -4220,7 +4308,7 @@ export async function run(args) {
     const scope = opts.global ? 'global' : 'project';
 
     if (opts.command !== 'version') {
-        checkForUpdates();
+        await checkForUpdates();
     }
 
     switch (opts.command) {