gipity 1.0.365 → 1.0.379

package/dist/commands/generate.js

@@ -28,13 +28,13 @@ Gemini-specific options:
 Examples:
   gipity generate image "a cat wearing a top hat"
   gipity generate image "landscape sunset" --provider gemini --aspect-ratio 16:9 --image-size 2K
-  gipity generate image "product photo" --provider openai --model gpt-image-1 --size 1536x1024 --quality high
+  gipity generate image "product photo" --provider openai --model gpt-image-2 --size 1536x1024 --quality high
   gipity generate image "abstract art" --provider bfl --model flux-2-pro -o art.png`)
     .argument('<prompt>', 'Text description of the image to generate')
     .option('--provider <provider>', 'Image provider: openai, bfl, or gemini (default: bfl)')
     .option('--model <model>', 'Model ID (see provider list above)')
     .option('--size <size>', 'Dimensions as WxH, e.g. "1024x1024" (OpenAI/BFL)')
-    .option('--quality <quality>', 'Quality: low|medium|high|auto (gpt-image-1), standard|hd (dall-e-3)')
+    .option('--quality <quality>', 'Quality: low|medium|high|auto (gpt-image-2)')
     .option('--aspect-ratio <ratio>', 'Aspect ratio (Gemini only): 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 4:5, 5:4, 21:9')
     .option('--image-size <size>', 'Output resolution (Gemini only): 512, 1K, 2K, 4K')
     .option('-o, --output <file>', 'Output path (default ./generated.png). For an image your app ships, write it into the source tree so it deploys, e.g. -o src/assets/images/hero.png; the cwd default is fine for one-off generation.')
@@ -96,7 +96,8 @@ Examples:
     .action(async (prompt, opts) => {
     try {
         const { config } = await resolveProjectContext();
-        console.log(info('Generating video (this may take 30-120 seconds)...'));
+        if (!opts.json)
+            console.log(info('Generating video (this may take 30-120 seconds)...')); // keep --json stdout pure JSON
         const result = await post(`/projects/${config.projectGuid}/generate/video`, {
             prompt,
             model: opts.model,
@@ -178,10 +179,61 @@ Examples:
         process.exit(1);
     }
 });
+// ── MUSIC ──────────────────────────────────────────────────────────────
+const musicCommand = new Command('music')
+    .description(`Generate music from a text prompt using AI.
+
+The model is chosen from the platform's music catalog. Omit --model to use the
+default; pass --model <id> only if you want a specific one (see the catalog with
+\`gipity service call music/models --get\`).
+
+Tips:
+  - Describe genre, mood, instruments, and tempo (e.g. "upbeat lo-fi hip hop with mellow piano")
+  - Music is instrumental by default; pass --vocals to allow singing
+  - Longer clips cost more; the max length depends on the model
+
+Examples:
+  gipity generate music "chill lo-fi beat for studying"
+  gipity generate music "epic orchestral battle theme" --duration 60 -o src/assets/audio/theme.mp3
+  gipity generate music "indie pop chorus" --vocals --duration 20`)
+    .argument('<prompt>', 'Text description of the music to generate')
+    .option('--duration <seconds>', 'Clip length in seconds (default 30; max depends on the model)', (v) => parseInt(v, 10))
+    .option('--model <model>', 'Music model id (default: platform default)')
+    .option('--vocals', 'Allow vocals (default: instrumental only)')
+    .option('-o, --output <file>', 'Output path (default ./music.mp3). For audio your app ships, write it into the source tree so it deploys, e.g. -o src/assets/audio/theme.mp3; the cwd default is fine for one-off generation.')
+    .option('--json', 'Output as JSON')
+    .action(async (prompt, opts) => {
+    try {
+        const { config } = await resolveProjectContext();
+        if (!opts.json)
+            console.log(info('Generating music...')); // keep --json stdout pure JSON
+        const result = await post(`/projects/${config.projectGuid}/generate/music`, {
+            prompt,
+            duration_seconds: opts.duration,
+            model: opts.model,
+            instrumental: !opts.vocals,
+        });
+        const filename = opts.output || 'music.mp3';
+        const savedPath = await downloadFile(result.url, filename);
+        if (opts.json) {
+            console.log(JSON.stringify({ ...result, saved: savedPath }));
+        }
+        else {
+            const sizeKb = Math.round(result.size_bytes / 1024);
+            console.log(`${muted(`Generated with ${result.model} (${sizeKb}KB)`)}`);
+            console.log(success(`Saved to ${savedPath}`));
+        }
+    }
+    catch (err) {
+        console.error(clrError(`Music generation failed: ${err.message}`));
+        process.exit(1);
+    }
+});
 // ── PARENT COMMAND ─────────────────────────────────────────────────────
 export const generateCommand = new Command('generate')
-    .description('Generate images, video, or speech')
+    .description('Generate images, video, speech, or music')
     .addCommand(imageCommand)
     .addCommand(videoCommand)
-    .addCommand(speechCommand);
+    .addCommand(speechCommand)
+    .addCommand(musicCommand);
 //# sourceMappingURL=generate.js.map

package/dist/commands/job.js

@@ -17,7 +17,7 @@ jobCommand
         if (j.on_complete)
             tags.push(muted(`→ ${j.on_complete}`));
         const line = `${bold(j.name)}  ${tags.join('  ')}`;
-        return j.description ? `${line}\n  ${muted(j.description)}` : line;
+        return j.description ? `${line}\n${muted(j.description)}` : line;
     });
 }));
 jobCommand
@@ -57,13 +57,13 @@ jobCommand
     const statusColor = r.status === 'success' ? success : r.status === 'failed' ? clrError : muted;
     console.log(`${statusColor(r.status)}  ${muted(r.guid)}`);
     if (r.progress_pct != null)
-        console.log(`  progress: ${Math.round(r.progress_pct * 100)}%${r.progress_message ? ` (${r.progress_message})` : ''}`);
+        console.log(`progress: ${Math.round(r.progress_pct * 100)}%${r.progress_message ? ` (${r.progress_message})` : ''}`);
     if (r.duration_ms != null)
-        console.log(`  duration: ${r.duration_ms}ms`);
+        console.log(`duration: ${r.duration_ms}ms`);
     if (r.error)
-        console.log(`  ${clrError('error:')} ${r.error}`);
+        console.log(`${clrError('error:')} ${r.error}`);
     if (r.output)
-        console.log(`  output: ${JSON.stringify(r.output)}`);
+        console.log(`output: ${JSON.stringify(r.output)}`);
 }));
 jobCommand
     .command('runs <name>')
@@ -78,7 +78,7 @@ jobCommand
         const dur = r.duration_ms != null ? `${r.duration_ms}ms` : '?';
         const ts = new Date(r.created_at).toLocaleString();
         const line = `${statusColor(r.status)}  ${dur}  ${muted(r.trigger_type)}  ${muted(r.guid)}  ${muted(ts)}`;
-        return r.error ? `${line}\n  ${clrError(`error: ${r.error}`)}` : line;
+        return r.error ? `${line}\n${clrError(`error: ${r.error}`)}` : line;
     });
 }));
 jobCommand

package/dist/commands/location.js

@@ -12,16 +12,16 @@ function formatLocation(r) {
     const lines = [];
     const place = [r.city, r.region, r.country].filter(Boolean).join(', ');
     if (place)
-        lines.push(`  ${place}`);
+        lines.push(place);
     if (r.lat != null && r.lon != null)
-        lines.push(`  Coordinates: ${r.lat}, ${r.lon}`);
+        lines.push(`Coordinates: ${r.lat}, ${r.lon}`);
     if (r.ip)
-        lines.push(`  IP:          ${r.ip}`);
+        lines.push(`IP:          ${r.ip}`);
     if (r.timezone)
-        lines.push(`  Timezone:    ${r.timezone}`);
+        lines.push(`Timezone:    ${r.timezone}`);
     if (r.accuracy != null)
-        lines.push(`  Accuracy:    ${Math.round(r.accuracy)}m`);
-    lines.push(`  Source:      ${r.source}`);
+        lines.push(`Accuracy:    ${Math.round(r.accuracy)}m`);
+    lines.push(`Source:      ${r.source}`);
     return lines.join('\n');
 }
 /**
@@ -71,7 +71,7 @@ export const locationCommand = new Command('location')
         return;
     }
     if (!res.data) {
-        console.log('  No location data.');
+        console.log('No location data.');
         return;
     }
     console.log(formatLocation(res.data));

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,15 +1,17 @@
 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
  *  short-lived job (so a long --wait can't trip the gateway idle timeout);
- *  we submit, then poll the result out of the job store. */
-async function pollEvalResult(evalJobId, waitMs) {
+ *  we submit, then poll the result out of the job store. `expectedWorkMs` is
+ *  the time the server-side work is expected to take (settle + any in-page
+ *  awaits); the client budget is that plus 60s of headroom. */
+export async function pollEvalResult(evalJobId, expectedWorkMs) {
     // Generous client budget: the server work is bounded by --wait plus browser
     // open/settle overhead; give it that plus headroom before giving up.
-    const deadline = Date.now() + waitMs + 60_000;
+    const deadline = Date.now() + expectedWorkMs + 60_000;
     let missCount = 0;
     while (Date.now() < deadline) {
         let rec;
@@ -60,11 +62,24 @@ 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('');
 }));
+// Each `page eval` call runs to completion before the next starts, so two evals
+// fired back-to-back never coexist in time - they CANNOT test whether two live
+// clients see each other (presence, shared state). For that, use the genuinely-
+// concurrent `page test --observe` instead, which overlaps N clients and reports
+// whether they actually ran together.
+pageEvalCommand.addHelpText('after', `
+Testing realtime/shared state across clients?
+  Separate 'page eval' calls run sequentially (one finishes before the next
+  starts), so they never overlap and will each see only themselves - a false
+  negative. Use 'gipity page test <url> --observe <expr>' for genuinely
+  concurrent clients with overlap verification.`);
 //# 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

@@ -105,6 +105,10 @@ export const pageScreenshotCommand = new Command('screenshot')
     .option('--fake-media', 'Grant a synthetic microphone + camera and auto-accept the getUserMedia prompt, so voice/camera apps render headlessly (audio is a built-in tone, not real speech)')
     .option('--json', 'Output JSON metadata instead of a friendly summary')
     .addOption(new Option('--wait <ms>', 'Alias for --post-load-delay').hideHelp())
+    // `--full-page` is the Puppeteer/Playwright name for this (their `fullPage`),
+    // so agents reach for it by reflex. Accept it as a hidden alias for `--full`
+    // rather than reject it as an unknown option and send them on a --help detour.
+    .addOption(new Option('--full-page', 'Alias for --full').hideHelp())
     .action((url, opts) => run('Page screenshot', async () => {
     const delayRaw = opts.postLoadDelay ?? opts.wait;
     const postLoadDelayMs = delayRaw !== undefined ? parseInt(String(delayRaw), 10) : undefined;
@@ -126,7 +130,7 @@ export const pageScreenshotCommand = new Command('screenshot')
     const body = {
         url,
         postLoadDelayMs,
-        full: !!opts.full,
+        full: !!(opts.full || opts.fullPage),
         reloadBetween: opts.reloadBetween !== false,
         ...(userSpecifiedViewports ? { viewports: customViewports } : {}),
         ...(opts.fakeMedia ? { fakeMedia: true } : {}),
@@ -183,41 +187,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