gipity 1.0.365 → 1.0.374

package/dist/banner.js

@@ -191,7 +191,9 @@ function renderBox(opts, outerW, bodyLines) {
     for (const row of bodyLines)
         lines.push(row);
     lines.push(border('╰') + border('─'.repeat(innerW)) + border('╯'));
-    console.log('\n' + lines.join('\n') + '\n');
+    // Leading blank comes from the central output frame; keep the trailing one
+    // (it separates the banner from the picker/output that follows).
+    console.log(lines.join('\n') + '\n');
 }
 // ── Narrow layout (single panel, egg only) ────────────────────────────
 function printNarrow(opts, outerW) {

package/dist/commands/add.js

@@ -154,7 +154,7 @@ export const addCommand = new Command('add')
             console.log(JSON.stringify({ templates: { starters: STARTERS, blank: BLANK }, kits: KITS }));
         }
         else {
-            console.log('\n' + catalogText() + '\n');
+            console.log(catalogText());
         }
         return;
     }
@@ -207,7 +207,7 @@ export const addCommand = new Command('add')
         console.log(success(`Scaffolded "${data.title}" (${data.type}) - ${data.files.length} files:`));
     }
     for (const f of data.files)
-        console.log(`  ${f}`);
+        console.log(`${f}`);
     if (data.notes?.length) {
         console.log('');
         for (const n of data.notes)

package/dist/commands/agent.js

@@ -1,7 +1,7 @@
 import { Command } from 'commander';
 import { get, post, put, del } from '../api.js';
 import { requireConfig, saveConfig } from '../config.js';
-import { error as clrError } from '../colors.js';
+import { error as clrError, success } from '../colors.js';
 import { run, printList, printResult } from '../helpers/index.js';
 import { confirm } from '../utils.js';
 export const agentCommand = new Command('agent')
@@ -51,11 +51,9 @@ agentCommand
         console.log(JSON.stringify(res.data));
     }
     else {
-        console.log('');
-        console.log(`Created "${res.data.name}" (${res.data.short_guid})`);
+        console.log(success(`Created "${res.data.name}" (${res.data.short_guid})`));
         if (opts.switch)
             console.log('Switched.');
-        console.log('');
     }
 }));
 agentCommand
@@ -114,7 +112,7 @@ agentCommand
     const res = await get('/agents');
     const match = res.data.find(a => a.name === name || a.short_guid === name);
     if (!match) {
-        console.error(`Agent "${name}" not found.`);
+        console.error(clrError(`Agent "${name}" not found.`));
         process.exit(1);
     }
     if (!await confirm(`Delete agent "${match.name}"?`)) {

package/dist/commands/approval.js

@@ -1,6 +1,6 @@
 import { Command } from 'commander';
 import { get, post } from '../api.js';
-import { muted } from '../colors.js';
+import { muted, success } from '../colors.js';
 import { run, printList, printResult } from '../helpers/index.js';
 function timeAgo(dateStr) {
     const diffMs = Date.now() - new Date(dateStr).getTime();
@@ -53,7 +53,7 @@ approvalCommand
     if (opts.expiresIn)
         body.expires_in_minutes = Number(opts.expiresIn);
     const res = await post('/approvals', body);
-    printResult(`Created ${res.data.guid}.`, opts, res.data);
+    printResult(success(`Created ${res.data.guid}.`), opts, res.data);
 }));
 approvalCommand
     .command('answer <guid> [selection...]')
@@ -112,6 +112,6 @@ approvalCommand
         throw new Error('Expected approval guid like ap_xxxxxxxx');
     }
     await post(`/approvals/${guid}/cancel`, {});
-    printResult(`Cancelled ${guid}.`, opts, { guid, cancelled: true });
+    printResult(success(`Cancelled ${guid}.`), opts, { guid, cancelled: true });
 }));
 //# sourceMappingURL=approval.js.map

package/dist/commands/audit.js

@@ -1,7 +1,7 @@
 import { Command } from 'commander';
 import { get } from '../api.js';
 import { requireConfig } from '../config.js';
-import { muted } from '../colors.js';
+import { muted, brand } from '../colors.js';
 import { run, printList } from '../helpers/index.js';
 export const auditCommand = new Command('audit')
     .description('Query audit logs');
@@ -47,6 +47,6 @@ auditCommand
     if (opts.entity)
         params.set('entity_type', opts.entity);
     const res = await get(`/projects/${config.projectGuid}/audit/count?${params}`);
-    console.log(opts.json ? JSON.stringify(res.data) : `${res.data.count} events`);
+    console.log(opts.json ? JSON.stringify(res.data) : `${brand(String(res.data.count))} events`);
 }));
 //# sourceMappingURL=audit.js.map

package/dist/commands/chat.js

@@ -2,7 +2,7 @@ import { Command } from 'commander';
 import { get, post, put, del } from '../api.js';
 import { resolveProjectContext, saveConfig } from '../config.js';
 import { sync } from '../sync.js';
-import { error as clrError, muted } from '../colors.js';
+import { error as clrError, muted, success } from '../colors.js';
 import { run, printList, printResult } from '../helpers/index.js';
 export const chatCommand = new Command('chat')
     .description('Send a message to your agent')
@@ -95,7 +95,7 @@ chatCommand
     .action((guid, titleParts, opts) => run('Rename', async () => {
     const title = titleParts.join(' ');
     await put(`/conversations/${guid}`, { title });
-    printResult(`Renamed ${guid} → "${title}".`, opts, { guid, title });
+    printResult(success(`Renamed ${guid} → "${title}".`), opts, { guid, title });
 }));
 chatCommand
     .command('archive <guid>')
@@ -103,7 +103,7 @@ chatCommand
     .option('--json', 'Output as JSON')
     .action((guid, opts) => run('Archive', async () => {
     await put(`/conversations/${guid}`, { archive: true });
-    printResult(`Archived ${guid}.`, opts, { guid, archived: true });
+    printResult(success(`Archived ${guid}.`), opts, { guid, archived: true });
 }));
 chatCommand
     .command('delete <guid>')
@@ -111,6 +111,6 @@ chatCommand
     .option('--json', 'Output as JSON')
     .action((guid, opts) => run('Delete', async () => {
     await del(`/conversations/${guid}`);
-    printResult(`Deleted ${guid}.`, opts, { guid, deleted: true });
+    printResult(success(`Deleted ${guid}.`), opts, { guid, deleted: true });
 }));
 //# sourceMappingURL=chat.js.map

package/dist/commands/claude.js

@@ -27,6 +27,7 @@ import * as relayState from '../relay/state.js';
 import { maybeOfferRelayOn, ensureDaemonRunning } from '../relay/onboarding.js';
 import { prompt, promptBoxed, pickOne, decodeJwtExp, confirm } from '../utils.js';
 import { brand, bold, info, success, error as clrError, muted } from '../colors.js';
+import { createProgressReporter } from '../progress.js';
 import { printBanner } from '../banner.js';
 import { scanForAdoption, isLikelyEmpty, canAdoptCwd, formatCwdLabel, formatBytes, adoptCurrentDir, ADOPT_THRESHOLDS, } from '../adopt-cwd.js';
 const __clDir = dirname(fileURLToPath(import.meta.url));
@@ -297,12 +298,10 @@ export const claudeCommand = new Command('claude')
         // ── Step 2: Project ───────────────────────────────────────────────
         let initialPrompt = '';
         let headlessNewProject = false;
-        // Single status line for the (otherwise silent) sync phases, so a long
-        // sync of a large tree no longer reads as a hang.
-        const syncProgress = (msg) => {
-            if (!nonInteractive)
-                console.log(`  ${muted(msg)}`);
-        };
+        // One reporter for the (otherwise silent) sync phases + upload bar, so a
+        // long sync of a large tree no longer reads as a hang. Stays silent in
+        // headless (-p) runs to keep machine-readable output clean.
+        const syncProgress = nonInteractive ? undefined : createProgressReporter();
         let existing = getConfig();
         let forceAdoptCwd = false;
         // Ambiguity guard: a `.gipity.json` inherited from an ANCESTOR directory
@@ -394,7 +393,7 @@ export const claudeCommand = new Command('claude')
             });
             console.log(`\n  Using ${projectDir}`);
             try {
-                const result = await sync({ interactive: !nonInteractive, onProgress: syncProgress });
+                const result = await sync({ interactive: !nonInteractive, progress: syncProgress });
                 if (result.applied > 0) {
                     console.log(`  Synced ${result.applied} change${result.applied > 1 ? 's' : ''} with Gipity.`);
                 }
@@ -462,7 +461,7 @@ export const claudeCommand = new Command('claude')
             }
             if (doSync) {
                 try {
-                    const result = await sync({ interactive: !nonInteractive, onProgress: syncProgress });
+                    const result = await sync({ interactive: !nonInteractive, progress: syncProgress });
                     if (result.applied > 0) {
                         console.log(`  Synced ${result.applied} change${result.applied > 1 ? 's' : ''} with Gipity.`);
                     }
@@ -588,7 +587,7 @@ export const claudeCommand = new Command('claude')
                 console.log(`\n  Using ${projectDir}`);
                 // Unified sync - push and pull resolved via three-way merge (non-fatal)
                 try {
-                    const result = await sync({ interactive: !nonInteractive, onProgress: syncProgress });
+                    const result = await sync({ interactive: !nonInteractive, progress: syncProgress });
                     if (result.applied > 0) {
                         console.log(`  Synced ${result.applied} change${result.applied > 1 ? 's' : ''} with Gipity.`);
                     }

package/dist/commands/credits.js

@@ -28,7 +28,7 @@ export const creditsCommand = new Command('credits')
         if (res.data.balances.length > 0) {
             for (const b of res.data.balances) {
                 const exp = new Date(b.expiresAt).toLocaleDateString();
-                console.log(`  ${b.source}: ${b.creditsRemaining.toLocaleString()}  ${muted(`expires ${exp}`)}`);
+                console.log(`${b.source}: ${b.creditsRemaining.toLocaleString()}  ${muted(`expires ${exp}`)}`);
             }
         }
     }

package/dist/commands/db.js

@@ -1,7 +1,7 @@
 import { Command } from 'commander';
 import { get, post, sendMessage } from '../api.js';
 import { requireConfig } from '../config.js';
-import { error as clrError } from '../colors.js';
+import { error as clrError, success } from '../colors.js';
 import { run, printList } from '../helpers/index.js';
 import { confirm } from '../utils.js';
 export const dbCommand = new Command('db')
@@ -62,12 +62,10 @@ dbCommand
             console.log(JSON.stringify(res.data));
             return;
         }
-        console.log('');
         console.log(`Databases: ${count}/${limit}`);
         console.log('');
         if (databases.length === 0) {
             console.log('No databases.');
-            console.log('');
             return;
         }
         // Group by project
@@ -78,13 +76,16 @@ dbCommand
                 grouped.set(key, []);
             grouped.get(key).push(db);
         }
+        let first = true;
         for (const [projectGuid, dbs] of grouped) {
+            if (!first)
+                console.log('');
+            first = false;
             const label = dbs[0].projectSlug || dbs[0].projectName || projectGuid;
             console.log(label);
             for (const db of dbs) {
-                console.log(`  ${db.friendlyName}`);
+                console.log(`${db.friendlyName}`);
             }
-            console.log();
         }
     }
     else {
@@ -143,7 +144,7 @@ dbCommand
         console.log(JSON.stringify({ success: true }));
     }
     else {
-        console.log(`Dropped database '${name}'.`);
+        console.log(success(`Dropped database '${name}'.`));
     }
 }));
 //# sourceMappingURL=db.js.map

package/dist/commands/deploy.js

@@ -31,8 +31,6 @@ export const deployCommand = new Command('deploy')
     }
     const config = requireConfig();
     await syncBeforeAction(opts);
-    if (!opts.json)
-        console.log('');
     // Call server - pipeline runs entirely server-side
     const res = await post(`/projects/${config.projectGuid}/deploy`, {
         target,
@@ -52,26 +50,26 @@ export const deployCommand = new Command('deploy')
     console.log(muted('─'.repeat(40)));
     if (d.phases && d.phases.length > 0) {
         for (const phase of d.phases) {
-            console.log(`  ${statusIcon(phase.status)} ${bold(phase.name)}: ${phase.summary}`);
+            console.log(`${statusIcon(phase.status)} ${bold(phase.name)}: ${phase.summary}`);
         }
     }
     else {
         // Fallback for simple deploys without phases
         const size = formatSize(d.totalBytes);
-        console.log(`  ${success('✓')} ${d.fileCount} files (${size}) → ${success(d.url)}`);
+        console.log(`${success('✓')} ${d.fileCount} files (${size}) → ${success(d.url)}`);
     }
     if (d.customDomains?.length) {
-        console.log(`  ${muted('Also:')} ${d.customDomains.join(', ')}`);
+        console.log(`${muted('Also:')} ${d.customDomains.join(', ')}`);
     }
     if (d.warning) {
-        console.log(`  ${warning(d.warning)}`);
+        console.log(`${warning(d.warning)}`);
     }
     // Show example curl commands for public endpoints
     if (d.examples && d.examples.length > 0) {
         console.log('');
         console.log(bold('Test your endpoints:'));
         for (const ex of d.examples) {
-            console.log(`  ${muted(ex)}`);
+            console.log(`${muted(ex)}`);
         }
     }
     console.log(muted('─'.repeat(40)));
@@ -83,6 +81,5 @@ export const deployCommand = new Command('deploy')
     else {
         console.log(success(`✓ Deployed to ${target}`) + muted(` (${d.elapsedMs}ms)`));
     }
-    console.log('');
 }));
 //# sourceMappingURL=deploy.js.map

package/dist/commands/doctor.js

@@ -46,22 +46,20 @@ export const doctorCommand = new Command('doctor')
     const dis = updatesDisabled();
     const local = localVersion();
     const localOk = existsSync(LOCAL_ENTRY);
-    console.log('');
     console.log(bold('Gipity CLI - doctor'));
     console.log('');
-    console.log(`  ${muted('shim version    ')} ${shimVersion()}`);
-    console.log(`  ${muted('local version   ')} ${local ?? dim('not installed')}  ${localOk ? success('✓') : warning('(running from shim fallback)')}`);
-    console.log(`  ${muted('local install   ')} ${LOCAL_PKG_DIR}`);
-    console.log('');
-    console.log(`  ${muted('auto-updates    ')} ${dis.disabled ? warning(`disabled (${dis.reason})`) : success('enabled')}`);
-    console.log(`  ${muted('settings file   ')} ${existsSync(SETTINGS_FILE) ? SETTINGS_FILE : dim('(default)')}  autoUpdates=${settings.autoUpdates}`);
-    console.log(`  ${muted('last check      ')} ${rel(state.lastCheckAt)}`);
-    console.log(`  ${muted('last error      ')} ${state.lastError ? clrError(state.lastError) : dim('none')}`);
-    console.log(`  ${muted('state file      ')} ${existsSync(STATE_FILE) ? STATE_FILE : dim('(none yet)')}`);
-    console.log(`  ${muted('update log      ')} ${existsSync(UPDATE_LOG) ? `${UPDATE_LOG} (${statSync(UPDATE_LOG).size} bytes)` : dim('(none yet)')}`);
+    console.log(`${muted('shim version    ')} ${shimVersion()}`);
+    console.log(`${muted('local version   ')} ${local ?? dim('not installed')}  ${localOk ? success('✓') : warning('(running from shim fallback)')}`);
+    console.log(`${muted('local install   ')} ${LOCAL_PKG_DIR}`);
     console.log('');
-    console.log(dim('  Force an update with: gipity update'));
-    console.log(dim('  Disable auto-update:  export DISABLE_AUTOUPDATER=1  (or set autoUpdates: false in settings.json)'));
+    console.log(`${muted('auto-updates    ')} ${dis.disabled ? warning(`disabled (${dis.reason})`) : success('enabled')}`);
+    console.log(`${muted('settings file   ')} ${existsSync(SETTINGS_FILE) ? SETTINGS_FILE : dim('(default)')}  autoUpdates=${settings.autoUpdates}`);
+    console.log(`${muted('last check      ')} ${rel(state.lastCheckAt)}`);
+    console.log(`${muted('last error      ')} ${state.lastError ? clrError(state.lastError) : dim('none')}`);
+    console.log(`${muted('state file      ')} ${existsSync(STATE_FILE) ? STATE_FILE : dim('(none yet)')}`);
+    console.log(`${muted('update log      ')} ${existsSync(UPDATE_LOG) ? `${UPDATE_LOG} (${statSync(UPDATE_LOG).size} bytes)` : dim('(none yet)')}`);
     console.log('');
+    console.log(dim('Force an update with: gipity update'));
+    console.log(dim('Disable auto-update:  export DISABLE_AUTOUPDATER=1  (or set autoUpdates: false in settings.json)'));
 });
 //# sourceMappingURL=doctor.js.map

package/dist/commands/domain.js

@@ -1,7 +1,7 @@
 import { Command } from 'commander';
 import { get, post, del } from '../api.js';
 import { getConfig, requireConfig } from '../config.js';
-import { error as clrError, success, muted } from '../colors.js';
+import { error as clrError, success, muted, brand } from '../colors.js';
 import { run, printList } from '../helpers/index.js';
 export const domainCommand = new Command('domain')
     .description('Manage custom domains')
@@ -21,7 +21,7 @@ export const domainCommand = new Command('domain')
                     console.log(JSON.stringify(res.data));
                     return;
                 }
-                console.log(`Domains: ${count}/${limit}\n`);
+                console.log(`${muted('Domains:')} ${brand(`${count}/${limit}`)}\n`);
                 if (domains.length === 0) {
                     console.log('No custom domains.');
                     return;
@@ -34,18 +34,21 @@ export const domainCommand = new Command('domain')
                         grouped.set(key, []);
                     grouped.get(key).push(d);
                 }
+                let first = true;
                 for (const [label, doms] of grouped) {
-                    console.log(label);
+                    if (!first)
+                        console.log('');
+                    first = false;
+                    console.log(brand(label));
                     for (const d of doms) {
-                        console.log(`  ${d.domain}  ${muted(d.status)}  ${muted(`[${d.shortGuid}]`)}`);
+                        console.log(`${d.domain}  ${muted(d.status)}  ${muted(`[${d.shortGuid}]`)}`);
                     }
-                    console.log();
                 }
             }
             else {
                 const config = requireConfig();
                 const res = await get(`/projects/${config.projectGuid}/domains`);
-                printList(res.data, opts, 'No custom domains configured.', d => `  ${d.domain}  ${muted(d.status)}  ${muted(`[${d.short_guid}]`)}`);
+                printList(res.data, opts, 'No custom domains configured.', d => `${d.domain}  ${muted(d.status)}  ${muted(`[${d.short_guid}]`)}`);
             }
             break;
         }
@@ -64,15 +67,15 @@ export const domainCommand = new Command('domain')
                 console.log(success(`Domain "${data.domain.domain}" added.`));
                 console.log('');
                 console.log('Add this DNS record:');
-                console.log(`  Type:   ${data.instructions.type}`);
-                console.log(`  Name:   ${data.instructions.name}`);
-                console.log(`  Target: ${data.instructions.target}`);
+                console.log(`${muted('Type:'.padEnd(8))}${data.instructions.type}`);
+                console.log(`${muted('Name:'.padEnd(8))}${data.instructions.name}`);
+                console.log(`${muted('Target:'.padEnd(8))}${data.instructions.target}`);
                 if (data.instructions.note) {
                     console.log('');
                     console.log(data.instructions.note);
                 }
                 console.log('');
-                console.log(`Then run: gipity domain verify ${data.domain.short_guid}`);
+                console.log(muted(`Then run: gipity domain verify ${data.domain.short_guid}`));
             }
             break;
         }
@@ -121,11 +124,11 @@ export const domainCommand = new Command('domain')
         default:
             console.log('Usage: gipity domain [list|add|verify|remove]');
             console.log('');
-            console.log('  gipity domain list              List project domains');
-            console.log('  gipity domain list --all        List all domains across projects');
-            console.log('  gipity domain add <domain.com>  Add a custom domain (requires project)');
-            console.log('  gipity domain verify <guid>     Verify DNS and activate (requires project)');
-            console.log('  gipity domain remove <guid>     Remove a custom domain');
+            console.log(`${brand('gipity domain list')}              ${muted('List project domains')}`);
+            console.log(`${brand('gipity domain list --all')}        ${muted('List all domains across projects')}`);
+            console.log(`${brand('gipity domain add <domain.com>')}  ${muted('Add a custom domain (requires project)')}`);
+            console.log(`${brand('gipity domain verify <guid>')}     ${muted('Verify DNS and activate (requires project)')}`);
+            console.log(`${brand('gipity domain remove <guid>')}     ${muted('Remove a custom domain')}`);
     }
 }));
 //# sourceMappingURL=domain.js.map

package/dist/commands/email.js

@@ -41,15 +41,11 @@ export const emailCommand = new Command('email')
             const recap = res.data.to.join(', ')
                 + (res.data.cc.length ? `, cc: ${res.data.cc.join(', ')}` : '')
                 + (res.data.bcc.length ? `, bcc: ${res.data.bcc.length}` : '');
-            console.log('');
             console.log(success(`Email sent to ${recap}: ${res.data.subject}`));
-            console.log('');
         }
     }
     catch (err) {
-        console.log('');
         console.error(clrError(`Email failed: ${err.message}`));
-        console.log('');
         process.exit(1);
     }
 });

package/dist/commands/fn.js

@@ -14,7 +14,7 @@ fnCommand
     const res = await get(`/projects/${config.projectGuid}/functions`);
     printList(res.data, opts, 'No functions defined.', f => {
         const line = `${bold(f.name)}  ${muted(`v${f.version}`)}  ${muted(f.auth_level)}  ${muted(`timeout=${f.timeout_ms}ms`)}`;
-        return f.description ? `${line}\n  ${muted(f.description)}` : line;
+        return f.description ? `${line}\n${muted(f.description)}` : line;
     });
 }));
 fnCommand
@@ -30,7 +30,7 @@ fnCommand
         const ts = new Date(log.created_at).toLocaleString();
         const statusColor = log.status === 'success' ? success : log.status === 'error' ? clrError : muted;
         const line = `${statusColor(log.status)}  ${dur}  ${muted(log.trigger_type || 'http')}  ${muted(ts)}`;
-        return log.error_message ? `${line}\n  ${clrError(`error: ${log.error_message}`)}` : line;
+        return log.error_message ? `${line}\n${clrError(`error: ${log.error_message}`)}` : line;
     });
 }));
 fnCommand

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));