gipity 1.0.365 → 1.0.374

package/dist/commands/login.js

@@ -2,7 +2,7 @@ import { Command } from 'commander';
 import { saveAuth, getAuth } from '../auth.js';
 import { publicPost } from '../api.js';
 import { prompt, decodeJwtExp } from '../utils.js';
-import { success, error as clrError } from '../colors.js';
+import { success, error as clrError, muted } from '../colors.js';
 export const loginCommand = new Command('login')
     .description('Log in or sign up')
     .option('--email <email>', 'Email address')
@@ -19,37 +19,27 @@ export const loginCommand = new Command('login')
         // Email only → send code and exit (non-interactive step 1)
         if (email && !code) {
             await publicPost('/auth/login', { email });
-            console.log('');
             console.log('Check your email for a 6-digit code.');
-            console.log(`Then run: gipity login --email ${email} --code <code>`);
-            console.log('');
+            console.log(muted(`Then run: gipity login --email ${email} --code <code>`));
             return;
         }
         // Fully interactive flow
-        console.log('');
         console.log('Enter your email to log in or create an account.');
-        console.log('');
         const existing = getAuth();
         email = await prompt(existing ? `Email [${existing.email}]: ` : 'Email: ');
         if (!email && existing)
             email = existing.email;
         if (!email) {
-            console.log('');
             console.error(clrError('Email required.'));
-            console.log('');
             process.exit(1);
         }
         await publicPost('/auth/login', { email });
-        console.log('');
         console.log('Check your email for a 6-digit code.');
-        console.log('');
         code = await prompt('Code: ');
         await verify(email, code);
     }
     catch (err) {
-        console.log('');
         console.error(clrError(`Login failed: ${err.message}`));
-        console.log('');
         process.exit(1);
     }
 });
@@ -57,9 +47,7 @@ async function verify(email, code) {
     const res = await publicPost('/auth/verify', { email, code });
     const exp = decodeJwtExp(res.accessToken);
     if (!exp) {
-        console.log('');
         console.error(clrError('Invalid token received.'));
-        console.log('');
         process.exit(1);
     }
     const expiresAt = new Date(exp * 1000).toISOString();
@@ -69,8 +57,6 @@ async function verify(email, code) {
         email,
         expiresAt,
     });
-    console.log('');
     console.log(success(`Logged in (${email}).`));
-    console.log('');
 }
 //# sourceMappingURL=login.js.map

package/dist/commands/logout.js

@@ -1,17 +1,16 @@
 import { Command } from 'commander';
 import { getAuth, clearAuth } from '../auth.js';
+import { success } from '../colors.js';
 export const logoutCommand = new Command('logout')
     .description('Log out')
     .action(() => {
     const auth = getAuth();
-    console.log('');
     if (!auth) {
         console.log('Not logged in.');
     }
     else {
         clearAuth();
-        console.log(`Logged out (${auth.email}).`);
+        console.log(success(`Logged out (${auth.email}).`));
     }
-    console.log('');
 });
 //# sourceMappingURL=logout.js.map

package/dist/commands/logs.js

@@ -30,7 +30,7 @@ logsCommand
         const status = statusColor(log.status.padEnd(8));
         const trigger = muted(log.trigger_type.padEnd(8));
         const err = log.error_message ? `  ${clrError(`"${log.error_message}"`)}` : '';
-        console.log(`  ${muted(time)}  ${status} ${dur} ${trigger}${err}`);
+        console.log(`${muted(time)}  ${status} ${dur} ${trigger}${err}`);
     }
 }));
 logsCommand

package/dist/commands/page-eval.js

@@ -1,6 +1,6 @@
 import { Command } from 'commander';
 import { post, get, ApiError } from '../api.js';
-import { brand, bold, muted } from '../colors.js';
+import { brand, bold, muted, warning } from '../colors.js';
 import { run } from '../helpers/index.js';
 const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
 /** Poll the async eval job until it finishes. Eval runs server-side as a
@@ -60,11 +60,13 @@ export const pageEvalCommand = new Command('eval')
         console.log(JSON.stringify(d));
         return;
     }
-    console.log(`\n${brand('Eval')} ${bold(d.url || url)}`);
-    console.log(`  ${muted('Expression:')} ${expr}`);
+    console.log(`${brand('Eval')} ${bold(d.url || url)}`);
+    if (d.navigationIncomplete) {
+        console.log(`${warning('⚠ Navigation incomplete:')} ${d.note || 'page did not reach full load'}`);
+    }
+    console.log(`${muted('Expression:')} ${expr}`);
     console.log(`\n${d.result || muted('(empty result)')}`);
     if (d.truncated)
         console.log(muted('\n(result truncated to fit context - narrow the expression for the full value)'));
-    console.log('');
 }));
 //# sourceMappingURL=page-eval.js.map

package/dist/commands/page-fetch.js

@@ -0,0 +1,136 @@
+import { Command } from 'commander';
+import { createHash } from 'crypto';
+import { brand, bold, muted, success, warning, error as clrError } from '../colors.js';
+import { formatSize } from '../utils.js';
+import { run } from '../helpers/index.js';
+function expectedType(path) {
+    const p = path.toLowerCase().split('?')[0].split('#')[0];
+    if (p.endsWith('.json'))
+        return 'json';
+    if (p.endsWith('.xml'))
+        return 'xml';
+    if (p.endsWith('.html') || p.endsWith('.htm'))
+        return 'html';
+    if (p.endsWith('.txt') || p.endsWith('.md') || p.endsWith('.markdown'))
+        return 'text';
+    return null;
+}
+function contentTypeMatches(expect, ct) {
+    if (!expect || !ct)
+        return true; // no expectation, or host sent no type → don't flag
+    const c = ct.toLowerCase();
+    switch (expect) {
+        case 'json': return c.includes('application/json');
+        case 'xml': return c.includes('xml');
+        case 'html': return c.includes('text/html');
+        case 'text': return c.includes('text/plain') || c.includes('text/markdown');
+    }
+}
+function looksLikeHtml(body) {
+    const head = body.slice(0, 300).toLowerCase();
+    return /<!doctype html|<html[\s>]/.test(head);
+}
+function sha256(s) {
+    return createHash('sha256').update(s).digest('hex');
+}
+function baseWithSlash(url) {
+    return url.endsWith('/') ? url : url + '/';
+}
+/** Resolve a file path against the app base, keeping the app's subpath. */
+function resolveUrl(base, path) {
+    return new URL(path.replace(/^\/+/, ''), baseWithSlash(base)).toString();
+}
+async function fetchRaw(url) {
+    try {
+        const res = await fetch(url, { redirect: 'follow' });
+        const body = await res.text();
+        return { status: res.status, contentType: res.headers.get('content-type'), body };
+    }
+    catch {
+        return null; // DNS failure, connection refused, etc.
+    }
+}
+/** Hit a guaranteed-absent path to learn whether the host serves a catch-all shell. */
+async function probeShell(base) {
+    const rand = Math.random().toString(36).slice(2) + Date.now().toString(36);
+    const r = await fetchRaw(resolveUrl(base, `__gipity_probe_${rand}.notreal`));
+    if (!r)
+        return { served: false, status: 0, sha256: null, isHtml: false };
+    return {
+        served: r.status >= 200 && r.status < 300,
+        status: r.status,
+        sha256: sha256(r.body),
+        isHtml: looksLikeHtml(r.body),
+    };
+}
+function classify(path, r, shell) {
+    if (!r)
+        return { status: null, contentType: null, bytes: 0, verdict: 'MISSING', detail: 'fetch failed (host unreachable)' };
+    const bytes = Buffer.byteLength(r.body);
+    const base = { status: r.status, contentType: r.contentType, bytes };
+    // Honest 404/5xx - the file simply isn't there.
+    if (r.status >= 400)
+        return { ...base, verdict: 'MISSING', detail: `HTTP ${r.status}` };
+    const expect = expectedType(path);
+    // 1) Served the catch-all shell verbatim → 200, but the file isn't deployed.
+    if (shell.served && shell.sha256 && sha256(r.body) === shell.sha256) {
+        return { ...base, verdict: 'MISSING', detail: `HTTP ${r.status} but served the SPA shell (file not deployed)` };
+    }
+    // 2) Asked for a non-HTML asset but got an HTML body → a per-path shell variant.
+    if (expect && expect !== 'html' && looksLikeHtml(r.body)) {
+        return { ...base, verdict: 'MISSING', detail: `HTTP ${r.status} but got HTML where ${expect} expected (SPA shell)` };
+    }
+    // 3) Present and real, but the content-type header disagrees with the extension.
+    if (expect && !contentTypeMatches(expect, r.contentType)) {
+        return { ...base, verdict: 'WRONG-TYPE', detail: `expected ${expect}, served as ${r.contentType ?? '(none)'}` };
+    }
+    return { ...base, verdict: 'OK', detail: r.contentType ?? '' };
+}
+const TAG = {
+    'OK': success('OK        '),
+    'MISSING': clrError('MISSING   '),
+    'WRONG-TYPE': warning('WRONG-TYPE'),
+};
+export const pageFetchCommand = new Command('fetch')
+    .description('Verify deployed non-rendered files (llms.txt, AGENTS.md, robots.txt, served JSON…) really exist - catches the static-host trap where a missing file returns 200 with the SPA shell instead of a 404')
+    .argument('<url>', 'Deployed app base URL; file paths resolve relative to it')
+    .argument('<paths...>', 'One or more file paths to verify, e.g. llms.txt AGENTS.md robots.txt')
+    .option('--json', 'Output as JSON')
+    .action((url, paths, opts) => run('Page fetch', async () => {
+    const shell = await probeShell(url);
+    const results = [];
+    for (const p of paths) {
+        const target = resolveUrl(url, p);
+        const c = classify(p, await fetchRaw(target), shell);
+        results.push({ path: p, url: target, ...c });
+    }
+    const failed = results.filter((r) => r.verdict !== 'OK');
+    if (opts.json) {
+        console.log(JSON.stringify({
+            base: baseWithSlash(url),
+            shellFallback: shell.served,
+            ok: failed.length === 0,
+            failed: failed.length,
+            files: results,
+        }));
+        if (failed.length)
+            process.exitCode = 1;
+        return;
+    }
+    console.log(`${brand('Page fetch')} ${bold(baseWithSlash(url))}`);
+    if (shell.served) {
+        console.log(`${muted('Host serves a catch-all shell for unknown paths - a bare 200 is not proof; verifying bodies.')}`);
+    }
+    const pad = Math.min(48, Math.max(...results.map((r) => r.path.length)));
+    for (const r of results) {
+        const size = r.verdict === 'OK' ? muted(formatSize(r.bytes).padStart(9)) : ' '.repeat(9);
+        const detail = r.detail && r.verdict !== 'OK' ? muted(`  ${r.detail}`) : '';
+        console.log(`${TAG[r.verdict]} ${r.path.padEnd(pad)} ${size}${detail}`);
+    }
+    console.log(failed.length === 0
+        ? `\n${success(`✓ all ${results.length} file(s) present with the right content-type`)}`
+        : `\n${clrError(`✗ ${failed.length} of ${results.length} file(s) missing or wrong-type`)}`);
+    if (failed.length)
+        process.exitCode = 1;
+}));
+//# sourceMappingURL=page-fetch.js.map

package/dist/commands/page-inspect.js

@@ -58,27 +58,30 @@ export const pageInspectCommand = new Command('inspect')
         }
         const timing = b.timing || { ttfb: 0, domReady: 0, load: 0 };
         // ── Page Info ──
-        console.log(`\n${brand('Inspecting')} ${bold(b.url || url)}`);
-        console.log(`  ${muted('Title:')} ${b.title || '(none)'}`);
-        console.log(`  ${muted('Elements:')} ${b.elementCount || 0}`);
-        console.log(`  ${muted('Page weight:')} ${info(formatSize(b.totalBytes || 0))}`);
+        console.log(`${brand('Inspecting')} ${bold(b.url || url)}`);
+        if (b.navigationIncomplete) {
+            console.log(`${warning('⚠ Navigation incomplete:')} ${b.note || 'page did not reach full load'}`);
+        }
+        console.log(`${muted('Title:')} ${b.title || '(none)'}`);
+        console.log(`${muted('Elements:')} ${b.elementCount || 0}`);
+        console.log(`${muted('Page weight:')} ${info(formatSize(b.totalBytes || 0))}`);
         // ── Timing ──
-        console.log(`\n  ${bold('Timing:')}`);
-        console.log(`    ${muted('TTFB:')} ${timing.ttfb}ms`);
-        console.log(`    ${muted('DOM ready:')} ${timing.domReady}ms`);
-        console.log(`    ${muted('Load:')} ${timing.load}ms`);
+        console.log(`\n${bold('Timing:')}`);
+        console.log(`${muted('TTFB:')} ${timing.ttfb}ms`);
+        console.log(`${muted('DOM ready:')} ${timing.domReady}ms`);
+        console.log(`${muted('Load:')} ${timing.load}ms`);
         if (showAll && b.lcp) {
-            console.log(`    LCP: ${b.lcp.time}ms (${b.lcp.element}${b.lcp.url ? ' ' + shortUrl(b.lcp.url, truncate) : ''})`);
+            console.log(`LCP: ${b.lcp.time}ms (${b.lcp.element}${b.lcp.url ? ' ' + shortUrl(b.lcp.url, truncate) : ''})`);
         }
         // ── Console ──
         if (b.console?.length > 0) {
-            console.log(`\n  ${bold('Console')} ${muted(`(${b.console.length})`)}:`);
+            console.log(`\n${bold('Console')} ${muted(`(${b.console.length})`)}:`);
             for (const line of b.console) {
-                console.log(`    ${warning(line)}`);
+                console.log(`${warning(line)}`);
             }
         }
         else {
-            console.log(`\n  ${bold('Console:')} ${muted('(clean)')}`);
+            console.log(`\n${bold('Console:')} ${muted('(clean)')}`);
         }
         // ── Failed Resources ──
         // Browsers auto-request /favicon.ico at the site root for every page, so a
@@ -97,57 +100,56 @@ export const pageInspectCommand = new Command('inspect')
         const failed = (b.failedResources || []).filter((r) => !isImplicitFavicon(r));
         const rootFaviconMissing = (b.failedResources || []).some(isImplicitFavicon);
         if (failed.length > 0) {
-            console.log(`\n  ${clrError(`Failed resources (${failed.length}):`)}`);
+            console.log(`\n${clrError(`Failed resources (${failed.length}):`)}`);
             for (const r of failed) {
-                console.log(`    ${clrError(r)}`);
+                console.log(`${clrError(r)}`);
             }
         }
         if (rootFaviconMissing) {
-            console.log(`\n  ${muted('No root /favicon.ico (browsers request this automatically; harmless for app pages served under a subpath)')}`);
+            console.log(`\n${muted('No root /favicon.ico (browsers request this automatically; harmless for app pages served under a subpath)')}`);
         }
         // ── Layout (horizontal overflow) ──
         if (b.overflow) {
             if (b.overflow.overflowX) {
-                console.log(`\n  ${clrError(`Horizontal overflow: +${b.overflow.amount}px`)} ${muted(`(content ${b.overflow.scrollWidth}px vs viewport ${b.overflow.clientWidth}px)`)}`);
+                console.log(`\n${clrError(`Horizontal overflow: +${b.overflow.amount}px`)} ${muted(`(content ${b.overflow.scrollWidth}px vs viewport ${b.overflow.clientWidth}px)`)}`);
                 if (showAll && b.overflow.culprits.length > 0) {
-                    console.log(`  ${muted('Overflowing elements:')}`);
+                    console.log(`${muted('Overflowing elements:')}`);
                     for (const c of b.overflow.culprits) {
                         const sel = c.cls ? `${c.tag}.${c.cls.split(/\s+/)[0]}` : c.tag;
-                        console.log(`    ${sel} ${muted(`(right ${c.right}px, width ${c.width}px)`)}`);
+                        console.log(`${sel} ${muted(`(right ${c.right}px, width ${c.width}px)`)}`);
                     }
                 }
                 else if (b.overflow.culprits.length > 0) {
-                    console.log(`    ${muted(`${b.overflow.culprits.length} overflowing element(s) - use --all to list`)}`);
+                    console.log(`${muted(`${b.overflow.culprits.length} overflowing element(s) - use --all to list`)}`);
                 }
             }
             else {
-                console.log(`\n  ${bold('Layout:')} ${muted('no horizontal overflow')}`);
+                console.log(`\n${bold('Layout:')} ${muted('no horizontal overflow')}`);
             }
         }
         if (showAll) {
             // ── Render Blocking ──
             if (b.renderBlocking?.length > 0) {
-                console.log(`\n  ${warning(`Render-blocking (${b.renderBlocking.length}):`)}`);
+                console.log(`\n${warning(`Render-blocking (${b.renderBlocking.length}):`)}`);
                 for (const r of b.renderBlocking) {
-                    console.log(`    ${shortUrl(r, truncate)}`);
+                    console.log(`${shortUrl(r, truncate)}`);
                 }
             }
             // ── Large Resources ──
             if (b.largeResources?.length > 0) {
-                console.log(`\n  ${warning(`Large resources >100KB (${b.largeResources.length}):`)}`);
+                console.log(`\n${warning(`Large resources >100KB (${b.largeResources.length}):`)}`);
                 for (const r of b.largeResources) {
-                    console.log(`    ${info(formatSize(r.size).padEnd(10))} ${muted(r.type.padEnd(8))} ${shortUrl(r.url, truncate)}`);
+                    console.log(`${info(formatSize(r.size).padEnd(10))} ${muted(r.type.padEnd(8))} ${shortUrl(r.url, truncate)}`);
                 }
             }
             // ── Oversized Images ──
             if (b.oversizedImages?.length > 0) {
-                console.log(`\n  ${warning(`Oversized images (${b.oversizedImages.length}):`)}`);
+                console.log(`\n${warning(`Oversized images (${b.oversizedImages.length}):`)}`);
                 for (const img of b.oversizedImages) {
-                    console.log(`    ${img.natural} served, ${img.displayed} displayed - ${shortUrl(img.src, truncate)}`);
+                    console.log(`${img.natural} served, ${img.displayed} displayed - ${shortUrl(img.src, truncate)}`);
                 }
             }
         }
-        console.log('');
     });
 });
 //# sourceMappingURL=page-inspect.js.map

package/dist/commands/page-screenshot.js

@@ -183,41 +183,40 @@ export const pageScreenshotCommand = new Command('screenshot')
     }
     if (meta.screenshots.length === 1) {
         const s = meta.screenshots[0];
-        console.log(`\n${brand('Screenshot')} ${bold(url)}`);
+        console.log(`${brand('Screenshot')} ${bold(url)}`);
         if (meta.title)
-            console.log(`  ${label('Web page title')} ${meta.title}`);
+            console.log(`${label('Web page title')} ${meta.title}`);
         if (meta.finalUrl)
-            console.log(`  ${label('Web page URL')} ${meta.finalUrl}`);
+            console.log(`${label('Web page URL')} ${meta.finalUrl}`);
         if (meta.status != null)
-            console.log(`  ${label('Web page status')} ${meta.status}`);
+            console.log(`${label('Web page status')} ${meta.status}`);
         if (meta.performance)
-            console.log(`  ${label('Web page perf')} ${fmtPerformance(meta.performance)}`);
+            console.log(`${label('Web page perf')} ${fmtPerformance(meta.performance)}`);
         const sizePart = formatSize(s.screenshotSizeBytes) + (meta.full ? ' (full page)' : '');
-        console.log(`  ${label('Screenshot size')} ${sizePart}`);
+        console.log(`${label('Screenshot size')} ${sizePart}`);
         if (s.width && s.height)
-            console.log(`  ${label('Screenshot dims')} ${s.width} × ${s.height}`);
-        console.log(`  ${label('Screenshot file')} ${success(savedFiles[0])}\n`);
+            console.log(`${label('Screenshot dims')} ${s.width} × ${s.height}`);
+        console.log(`${label('Screenshot file')} ${success(savedFiles[0])}`);
         return;
     }
-    console.log(`\n${brand('Loading')} ${bold(url)} ${muted(`once → ${meta.screenshots.length} viewports`)}`);
+    console.log(`${brand('Loading')} ${bold(url)} ${muted(`once → ${meta.screenshots.length} viewports`)}`);
     if (meta.title)
-        console.log(`  ${label('Web page title')} ${meta.title}`);
+        console.log(`${label('Web page title')} ${meta.title}`);
     if (meta.finalUrl)
-        console.log(`  ${label('Web page URL')} ${meta.finalUrl}`);
+        console.log(`${label('Web page URL')} ${meta.finalUrl}`);
     if (meta.status != null)
-        console.log(`  ${label('Web page status')} ${meta.status}`);
+        console.log(`${label('Web page status')} ${meta.status}`);
     if (meta.performance)
-        console.log(`  ${label('Web page perf')} ${fmtPerformance(meta.performance)}`);
+        console.log(`${label('Web page perf')} ${fmtPerformance(meta.performance)}`);
     for (let i = 0; i < meta.screenshots.length; i++) {
         const s = meta.screenshots[i];
         const dims = `${s.viewport.width}×${s.viewport.height}${s.viewport.deviceScaleFactor > 1 ? ` @${s.viewport.deviceScaleFactor}x` : ''}`;
-        console.log(`\n  ${brand('@ ' + dims)}`);
+        console.log(`\n${brand('@ ' + dims)}`);
         const sizePart = formatSize(s.screenshotSizeBytes) + (meta.full ? ' (full page)' : '');
-        console.log(`    ${label('Screenshot size')} ${sizePart}`);
+        console.log(`${label('Screenshot size')} ${sizePart}`);
         if (s.width && s.height)
-            console.log(`    ${label('Screenshot dims')} ${s.width} × ${s.height}`);
-        console.log(`    ${label('Screenshot file')} ${success(savedFiles[i])}`);
+            console.log(`${label('Screenshot dims')} ${s.width} × ${s.height}`);
+        console.log(`${label('Screenshot file')} ${success(savedFiles[i])}`);
     }
-    console.log('');
 }));
 //# sourceMappingURL=page-screenshot.js.map

package/dist/commands/page-test.js

@@ -36,15 +36,15 @@ export const pageTestCommand = new Command('test')
     const stagger = Math.max(0, parseInt(opts.stagger, 10) || 0);
     const wait = Math.min(30000, Math.max(2000, parseInt(opts.wait, 10) || 24000));
     if (!opts.json) {
-        console.log(`\n${brand('Page test')} ${bold(url)}`);
-        console.log(`  ${muted(`${clients} client(s), stagger ${stagger}s, ${wait}ms open each`)}\n`);
+        console.log(`${brand('Page test')} ${bold(url)}`);
+        console.log(`${muted(`${clients} client(s), stagger ${stagger}s, ${wait}ms open each`)}`);
     }
     const runs = [];
     for (let i = 0; i < clients; i++) {
         runs.push((async () => {
             await sleep(i * stagger * 1000);
             if (!opts.json)
-                console.log(`  ${muted(`client ${i}${i === 0 ? ' (first)' : ''} starting`)}`);
+                console.log(`${muted(`client ${i}${i === 0 ? ' (first)' : ''} starting`)}`);
             return inspectClient(url, wait, i);
         })());
     }
@@ -65,21 +65,21 @@ export const pageTestCommand = new Command('test')
     for (const r of results) {
         console.log(`\n${bold(`=== client ${r.i}${r.i === 0 ? ' (first)' : ''} ===`)}`);
         if (r.error) {
-            console.log(`  ${clrError(`page inspect failed: ${r.error}`)}`);
+            console.log(`${clrError(`page inspect failed: ${r.error}`)}`);
             continue;
         }
         if (r.lines.length === 0) {
-            console.log(`  ${muted('(no console output)')}`);
+            console.log(`${muted('(no console output)')}`);
             continue;
         }
         for (const line of r.lines) {
             const bad = BAD.test(line);
-            console.log(`  ${bad ? warning('⚠ ' + line) : ' ' + line}`);
+            console.log(`${bad ? warning('⚠ ' + line) : ' ' + line}`);
         }
     }
     console.log(problems === 0
-        ? `\n${success('✓ no error/crash lines across all clients')}\n`
-        : `\n${clrError(`⚠ ${problems} error/crash line(s) flagged above`)}\n`);
+        ? `\n${success('✓ no error/crash lines across all clients')}`
+        : `\n${clrError(`⚠ ${problems} error/crash line(s) flagged above`)}`);
     if (problems > 0)
         process.exitCode = 1;
 }));

package/dist/commands/page.js

@@ -3,16 +3,19 @@ import { pageInspectCommand } from './page-inspect.js';
 import { pageScreenshotCommand } from './page-screenshot.js';
 import { pageEvalCommand } from './page-eval.js';
 import { pageTestCommand } from './page-test.js';
+import { pageFetchCommand } from './page-fetch.js';
 // Parent namespace grouping the page/browser diagnostics under one command:
-//   gipity page inspect | eval | screenshot | test
+//   gipity page inspect | eval | screenshot | test | fetch
 // Each subcommand is canonical for its capability; the namespace keeps the
 // top-level surface lean and makes the siblings discoverable via `page --help`.
+// `inspect` is the rendered DOM (browser); `fetch` is the raw asset (plain HTTP).
 export const pageCommand = new Command('page')
-    .description('Inspect, evaluate, screenshot, and multi-client test web pages (page inspect | eval | screenshot | test)')
+    .description('Inspect, evaluate, screenshot, multi-client test, and verify raw files of web pages (page inspect | eval | screenshot | test | fetch)')
     .addCommand(pageInspectCommand)
     .addCommand(pageEvalCommand)
     .addCommand(pageScreenshotCommand)
-    .addCommand(pageTestCommand);
+    .addCommand(pageTestCommand)
+    .addCommand(pageFetchCommand);
 // No subcommand → show help instead of commander's terse error.
 pageCommand.action(() => {
     pageCommand.help();

package/dist/commands/plan.js

@@ -22,7 +22,7 @@ function formatLimit(key, value) {
     }
     return value.toLocaleString();
 }
-function renderLimits(limits, indent = '  ') {
+function renderLimits(limits, indent = '') {
     for (const key of Object.keys(LIMIT_LABELS)) {
         const value = limits[key];
         if (value !== undefined) {
@@ -48,14 +48,14 @@ export const planCommand = new Command('plan')
         const price = plan.monthlyPriceUsd > 0 ? `  $${plan.monthlyPriceUsd}/mo` : '';
         console.log(`Plan: ${brand(plan.displayName)} (${plan.tier})${price}`);
         if (plan.monthlyCredits > 0) {
-            console.log(`  ${plan.monthlyCredits.toLocaleString()} credits/mo, ${plan.creditExpiryDays}-day expiry`);
+            console.log(`${plan.monthlyCredits.toLocaleString()} credits/mo, ${plan.creditExpiryDays}-day expiry`);
         }
     }
     else {
         console.log(`Plan: ${tier} (no matching plan row)`);
     }
     if (planAppliedAt) {
-        console.log(`  ${dim('Applied: ' + new Date(planAppliedAt).toLocaleDateString())}`);
+        console.log(`${dim('Applied: ' + new Date(planAppliedAt).toLocaleDateString())}`);
     }
     console.log('\nLimits:');
     renderLimits(limits);
@@ -85,7 +85,7 @@ planCommand
             ? ` - ${plan.monthlyCredits.toLocaleString()} credits/mo (${plan.creditExpiryDays}-day expiry)`
             : '';
         console.log(`${marker}${plan.displayName} (${plan.tier})${price}${credits}`);
-        renderLimits(plan.limits, '      ');
+        renderLimits(plan.limits);
         console.log('');
     }
     console.log(dim('(* = your current plan)'));

package/dist/commands/push.js

@@ -1,7 +1,7 @@
 import { Command } from 'commander';
 import { resolve } from 'path';
 import { pushFile } from '../sync.js';
-import { error as clrError } from '../colors.js';
+import { error as clrError, success } from '../colors.js';
 export const pushCommand = new Command('push')
     .description('Push a file')
     .argument('<file>', 'File path to push')
@@ -22,16 +22,12 @@ export const pushCommand = new Command('push')
         }
         await pushFile(fullPath);
         if (!opts.quiet) {
-            console.log('');
-            console.log(`Pushed ${file}`);
-            console.log('');
+            console.log(success(`Pushed ${file}`));
         }
     }
     catch (err) {
         if (!opts.quiet) {
-            console.log('');
             console.error(clrError(`Push failed: ${err.message}`));
-            console.log('');
         }
         process.exit(1);
     }

package/dist/commands/realtime.js

@@ -32,7 +32,7 @@ const roomCommand = new Command('room')
     switch (sub) {
         case 'list': {
             const res = await get(base);
-            printList(res.data, opts, 'No realtime rooms. Create one: gipity realtime room create <name>', r => `  ${bold(r.name)}  ${muted(`${r.room_type} · ${r.auth_level} · max ${r.max_clients}`)}`);
+            printList(res.data, opts, 'No realtime rooms. Create one: gipity realtime room create <name>', r => `${bold(r.name)}  ${muted(`${r.room_type} · ${r.auth_level} · max ${r.max_clients}`)}`);
             break;
         }
         case 'create': {
@@ -74,7 +74,7 @@ const roomCommand = new Command('room')
                 console.log(JSON.stringify({ success: true }));
             }
             else {
-                console.log(`Deleted room '${name}'. Active instances drain as clients disconnect.`);
+                console.log(success(`Deleted room '${name}'.`) + ' Active instances drain as clients disconnect.');
             }
             break;
         }
@@ -89,13 +89,11 @@ const roomCommand = new Command('room')
             }
             else {
                 const { room, live } = res.data;
-                console.log('');
-                console.log(`  ${bold(room.name)}`);
-                console.log(`  Type:        ${room.room_type}`);
-                console.log(`  Auth:        ${room.auth_level}`);
-                console.log(`  Max clients: ${room.max_clients}`);
-                console.log(`  Live:        ${live ? `${live.instances} instance(s), ${live.clients} client(s)` : muted('Colyseus server unreachable')}`);
-                console.log('');
+                console.log(`${bold(room.name)}`);
+                console.log(`Type:        ${room.room_type}`);
+                console.log(`Auth:        ${room.auth_level}`);
+                console.log(`Max clients: ${room.max_clients}`);
+                console.log(`Live:        ${live ? `${live.instances} instance(s), ${live.clients} client(s)` : muted('Colyseus server unreachable')}`);
             }
             break;
         }