@blockrun/franklin 3.3.0 → 3.3.1

package/dist/agent/commands.js

@@ -196,7 +196,7 @@ const DIRECT_COMMANDS = {
                 `  **Coding:** /commit /review /test /fix /debug /explain /search /find /refactor /scaffold\n` +
                 `  **Git:** /push /pr /undo /status /diff /log /branch /stash /unstash\n` +
                 `  **Analysis:** /security /lint /optimize /todo /deps /clean /migrate /doc\n` +
-                `  **Session:** /plan /ultraplan /execute /compact /retry /sessions /resume /context /tasks\n` +
+                `  **Session:** /plan /ultraplan /execute /compact /retry /sessions /resume /session-search /context /tasks\n` +
                 `  **Power:** /ultrathink [query] /ultraplan /dump\n` +
                 `  **Info:** /model /wallet /cost /tokens /learnings /mcp /doctor /version /bug /help\n` +
                 `  **UI:** /clear /exit\n` +
@@ -350,11 +350,12 @@ const DIRECT_COMMANDS = {
             for (const s of sessions.slice(0, 10)) {
                 const date = new Date(s.updatedAt).toLocaleString();
                 const dir = s.workDir ? ` — ${s.workDir.split('/').pop()}` : '';
-                text += `  ${s.id}  ${s.model}  ${s.turnCount} turns  ${date}${dir}\n`;
+                const current = s.id === ctx.sessionId ? '  (current)' : '';
+                text += `  ${s.id}  ${s.model}  ${s.turnCount} turns  ${date}${dir}${current}\n`;
             }
             if (sessions.length > 10)
                 text += `  ... and ${sessions.length - 10} more\n`;
-            text += '\nUse /resume <session-id> to continue a session.\n';
+            text += '\nUse /resume to restore the latest session, or /resume <session-id> for a specific one.\n';
             ctx.onEvent({ kind: 'text_delta', text });
         }
         emitDone(ctx);
@@ -486,13 +487,17 @@ export async function handleSlashCommand(input, ctx) {
         await DIRECT_COMMANDS[input](ctx);
         return { handled: true };
     }
-    // /search <query> — full-text search past sessions
-    if (input === '/search' || input.startsWith('/search ')) {
-        const query = input === '/search' ? '' : input.slice('/search '.length).trim();
+    // /session-search <query> — full-text search past sessions
+    if (input === '/session-search' ||
+        input.startsWith('/session-search ') ||
+        input === '/ssearch' ||
+        input.startsWith('/ssearch ')) {
+        const prefix = input.startsWith('/ssearch') ? '/ssearch' : '/session-search';
+        const query = input === prefix ? '' : input.slice(prefix.length + 1).trim();
         if (!query) {
-            ctx.onEvent({ kind: 'text_delta', text: 'Usage: /search <query>\n' +
+            ctx.onEvent({ kind: 'text_delta', text: 'Usage: /session-search <query>\n' +
                     'Finds past sessions whose messages match the query.\n' +
-                    'Use quotes for phrase search: /search "payment loop"\n'
+                    'Use quotes for phrase search: /session-search "payment loop"\n'
             });
             emitDone(ctx);
             return { handled: true };
@@ -633,9 +638,16 @@ export async function handleSlashCommand(input, ctx) {
         emitDone(ctx);
         return { handled: true };
     }
-    // /resume <id>
-    if (input.startsWith('/resume ')) {
-        const targetId = input.slice(8).trim();
+    // /resume or /resume <id>
+    if (input === '/resume' || input.startsWith('/resume ')) {
+        const targetId = input === '/resume'
+            ? listSessions().find((session) => session.id !== ctx.sessionId)?.id ?? ''
+            : input.slice(8).trim();
+        if (!targetId) {
+            ctx.onEvent({ kind: 'text_delta', text: 'No previous session available to resume.\n' });
+            emitDone(ctx);
+            return { handled: true };
+        }
         const restored = loadSessionHistory(targetId);
         if (restored.length === 0) {
             ctx.onEvent({ kind: 'text_delta', text: `Session "${targetId}" not found or empty.\n` });
@@ -665,7 +677,7 @@ export async function handleSlashCommand(input, ctx) {
         ...Object.keys(DIRECT_COMMANDS),
         ...Object.keys(REWRITE_COMMANDS),
         ...ARG_COMMANDS.map(c => c.prefix.trim()),
-        '/branch', '/resume', '/model', '/wallet', '/cost', '/help', '/clear', '/retry', '/exit',
+        '/branch', '/resume', '/model', '/wallet', '/cost', '/help', '/clear', '/retry', '/exit', '/session-search', '/ssearch',
     ];
     const cmd = input.split(/\s/)[0];
     const close = allCommands.filter(c => {

package/dist/agent/context.js

@@ -33,7 +33,24 @@ You have access to tools for reading, writing, editing files, running shell comm
 - **Batch bash**: combine sequential shell commands into one Bash call with && or a script. Only split when you need to inspect intermediate output.
 - **AskUser**: Only use AskUser when you are about to perform a destructive action (deleting files, dropping databases) and need explicit confirmation. NEVER use AskUser to ask what the user wants — just answer their message directly. If their request is vague, make a reasonable assumption and proceed.
 - Never write to /etc, /usr, ~/.ssh, ~/.aws. Don't commit secrets.
-- Type /help to see all slash commands.`;
+- Type /help to see all slash commands.
+
+# Missing Access
+Always deliver results first using whatever tools work (WebSearch, WebFetch, etc.). Never let missing access block you.
+After delivering results, if a better data source exists, add one line at the end:
+"Tip: run franklin social setup && franklin social login x for live X data."
+Do NOT check access before acting. Do NOT explain what you tried. Just deliver, then tip.
+
+# X / Social Marketing
+When the user asks about X posts, trending topics, or social growth:
+1. Search and find relevant posts immediately (WebSearch or SearchX).
+2. Present results as a numbered list of SUGGESTIONS, not actions. Each item must include:
+   - The post author and a short snippet
+   - A clickable link (https://x.com/...)
+   - A suggested reply draft (2-3 sentences, natural tone, not salesy)
+3. End with: "Reply to any of these? Give me the number."
+4. Do NOT auto-post. Do NOT explain how the social system works. Do NOT dump config JSON.
+5. If the user asks to set up X access, ask them simple questions one at a time (handle? product? keywords?) and write the config yourself. Never show raw JSON to the user.`;
 // Cache assembled instructions per workingDir — avoids re-running git commands
 // when sub-agents are spawned (common in parallel tool use patterns).
 const _instructionCache = new Map();

package/dist/agent/loop.js

@@ -42,7 +42,21 @@ export async function interactiveSession(config, getUserInput, onEvent, onAbortR
     const sessionId = createSessionId();
     let turnCount = 0;
     let tokenBudgetWarned = false; // Emit token budget warning at most once per session
+    let lastSessionActivity = Date.now();
+    const persistSessionMeta = () => {
+        updateSessionMeta(sessionId, {
+            model: config.model,
+            workDir,
+            turnCount,
+            messageCount: history.length,
+        });
+    };
+    const persistSessionMessage = (message) => {
+        appendToSession(sessionId, message);
+        persistSessionMeta();
+    };
     pruneOldSessions(sessionId); // Cleanup old sessions on start, protect current
+    persistSessionMeta();
     while (true) {
         let input = await getUserInput();
         if (input === null)
@@ -72,23 +86,28 @@ export async function interactiveSession(config, getUserInput, onEvent, onAbortR
         }
         lastUserInput = input;
         history.push({ role: 'user', content: input });
-        appendToSession(sessionId, { role: 'user', content: input });
         turnCount++;
+        persistSessionMessage({ role: 'user', content: input });
         const abort = new AbortController();
         onAbortReady?.(() => abort.abort());
         let loopCount = 0;
         let recoveryAttempts = 0;
         let compactFailures = 0;
         let maxTokensOverride;
-        let lastActivity = Date.now();
+        const turnIdleReference = lastSessionActivity;
+        lastSessionActivity = Date.now();
         // Agent loop for this user message
         while (loopCount < maxTurns) {
             loopCount++;
+            // Signal UI that a new LLM round is starting (shows spinner between tool results and next response)
+            if (loopCount > 1) {
+                onEvent({ kind: 'thinking_delta', text: '' });
+            }
             // ── Token optimization pipeline ──
             // 1. Strip thinking, budget tool results, time-based cleanup (always — cheap)
             const optimized = optimizeHistory(history, {
                 debug: config.debug,
-                lastActivityTimestamp: lastActivity,
+                lastActivityTimestamp: loopCount === 1 ? turnIdleReference : lastSessionActivity,
             });
             if (optimized !== history) {
                 history.length = 0;
@@ -185,9 +204,12 @@ export async function interactiveSession(config, getUserInput, onEvent, onAbortR
                 if (err.name === 'AbortError' || abort.signal.aborted) {
                     // Save any partial response that was streamed before abort
                     if (responseParts && responseParts.length > 0) {
-                        history.push({ role: 'assistant', content: responseParts });
-                        appendToSession(sessionId, { role: 'assistant', content: responseParts });
+                        const partialAssistant = { role: 'assistant', content: responseParts };
+                        history.push(partialAssistant);
+                        persistSessionMessage(partialAssistant);
                     }
+                    lastSessionActivity = Date.now();
+                    persistSessionMeta();
                     onEvent({ kind: 'turn_done', reason: 'aborted' });
                     break;
                 }
@@ -249,6 +271,8 @@ export async function interactiveSession(config, getUserInput, onEvent, onAbortR
                     reason: 'error',
                     error: `[${classified.label}] ${errMsg}${suggestion}`,
                 });
+                lastSessionActivity = Date.now();
+                persistSessionMeta();
                 break;
             }
             // When API doesn't return input tokens (some models return 0), estimate from history
@@ -278,11 +302,16 @@ export async function interactiveSession(config, getUserInput, onEvent, onAbortR
                     }
                 }
                 // Append what we got + a continuation prompt (text already streamed)
-                history.push({ role: 'assistant', content: responseParts });
-                history.push({
+                const partialAssistant = { role: 'assistant', content: responseParts };
+                const continuationPrompt = {
                     role: 'user',
                     content: 'Continue where you left off. Do not repeat what you already said.',
-                });
+                };
+                history.push(partialAssistant);
+                persistSessionMessage(partialAssistant);
+                history.push(continuationPrompt);
+                persistSessionMessage(continuationPrompt);
+                lastSessionActivity = Date.now();
                 continue; // Retry with higher limit
             }
             // Reset recovery counter on successful completion
@@ -294,17 +323,13 @@ export async function interactiveSession(config, getUserInput, onEvent, onAbortR
                     invocations.push(part);
                 }
             }
-            history.push({ role: 'assistant', content: responseParts });
+            const assistantMessage = { role: 'assistant', content: responseParts };
+            history.push(assistantMessage);
+            persistSessionMessage(assistantMessage);
             // No more capabilities → done with this user message
             if (invocations.length === 0) {
-                // Save session on completed turn
-                appendToSession(sessionId, { role: 'assistant', content: responseParts });
-                updateSessionMeta(sessionId, {
-                    model: config.model,
-                    workDir: config.workingDir || process.cwd(),
-                    turnCount,
-                    messageCount: history.length,
-                });
+                lastSessionActivity = Date.now();
+                persistSessionMeta();
                 // Token budget warning — emit once per session when crossing 70%
                 if (!tokenBudgetWarned) {
                     const { estimated } = getAnchoredTokenCount(history);
@@ -327,7 +352,7 @@ export async function interactiveSession(config, getUserInput, onEvent, onAbortR
                 onEvent({ kind: 'capability_done', id: inv.id, result });
             }
             // Refresh activity timestamp after tool execution
-            lastActivity = Date.now();
+            lastSessionActivity = Date.now();
             // Append outcomes
             const outcomeContent = results.map(([inv, result]) => ({
                 type: 'tool_result',
@@ -335,9 +360,13 @@ export async function interactiveSession(config, getUserInput, onEvent, onAbortR
                 content: result.output,
                 is_error: result.isError,
             }));
-            history.push({ role: 'user', content: outcomeContent });
+            const toolResultMessage = { role: 'user', content: outcomeContent };
+            history.push(toolResultMessage);
+            persistSessionMessage(toolResultMessage);
         }
         if (loopCount >= maxTurns) {
+            lastSessionActivity = Date.now();
+            persistSessionMeta();
             onEvent({ kind: 'turn_done', reason: 'max_turns' });
         }
     }

package/dist/banner.js

@@ -7,26 +7,32 @@ import chalk from 'chalk';
 //   https://commons.wikimedia.org/wiki/File:BenFranklinDuplessis.jpg
 //
 // Pipeline:
-//   1. Crop the 800×989 thumb to a 500×500 square centred on the face
-//      (sips --cropToHeightWidth 500 500 --cropOffset 140 150)
+//   1. Crop the 2403×2971 original to a 1400×1400 square centred on the face
+//      (sips --cropToHeightWidth 1400 1400 --cropOffset 400 500)
 //   2. Convert via chafa:
-//      chafa --size=16x8 --symbols=block --colors=full ben-face.jpg
+//      chafa --size=30x14 --symbols=block --colors=256 ben-face.jpg
 //   3. Strip cursor visibility control codes (\x1b[?25l / \x1b[?25h)
 //   4. Paste here as hex-escaped string array (readable + diff-friendly)
 //
-// Visible dimensions: ~16 characters wide × 8 rows tall.
+// Visible dimensions: ~28 characters wide × 14 rows tall.
 //
 // Rendered best in a 256-color or truecolor terminal. Degrades gracefully
 // on ancient terminals — but those are long gone and we don't support them.
 const BEN_PORTRAIT_ROWS = [
-    '\x1b[0m\x1b[38;2;7;0;0;48;2;8;0;0m▔ \x1b[38;2;9;1;0m▂\x1b[38;2;56;36;15;48;2;11;2;0m▗\x1b[38;2;100;73;36;48;2;31;16;6m▅\x1b[38;2;189;141;75;48;2;117;87;43m▅\x1b[38;2;217;162;85;48;2;152;111;51m▆\x1b[38;2;164;122;64;48;2;215;158;85m▔\x1b[38;2;124;90;46;48;2;217;160;93m▔\x1b[38;2;185;136;75;48;2;77;48;20m▅\x1b[38;2;100;61;24;48;2;39;18;4m▖\x1b[38;2;48;26;9;48;2;32;13;3m▃\x1b[38;2;39;18;4;48;2;30;11;2m▄\x1b[38;2;38;17;4;48;2;32;13;3m▄\x1b[38;2;40;20;5;48;2;35;15;2m▃\x1b[38;2;41;21;5;48;2;36;16;3m▂\x1b[0m',
-    '\x1b[7m\x1b[38;2;8;0;0m \x1b[0m\x1b[38;2;0;0;0;48;2;8;0;0m \x1b[38;2;13;2;1;48;2;45;26;10m▊\x1b[38;2;61;40;17;48;2;87;63;31m▎\x1b[38;2;88;61;29;48;2;134;94;42m▋\x1b[38;2;182;132;66;48;2;223;172;93m▏\x1b[38;2;140;91;38;48;2;233;193;106m▂\x1b[38;2;135;82;35;48;2;229;178;106m▂\x1b[38;2;201;145;78;48;2;223;166;95m▂\x1b[38;2;133;88;46;48;2;198;148;86m▁\x1b[38;2;144;96;47;48;2;96;57;21m▍\x1b[38;2;66;42;15;48;2;58;33;11m▗\x1b[38;2;59;36;13;48;2;47;25;9m▆\x1b[38;2;57;35;11;48;2;46;24;7m▅\x1b[38;2;58;36;11;48;2;50;29;8m▖\x1b[38;2;53;32;8;48;2;48;26;7m▃\x1b[0m',
-    '\x1b[38;2;12;3;3;48;2;9;0;0m▁\x1b[38;2;102;76;40;48;2;19;8;4m▗\x1b[38;2;110;83;45;48;2;56;35;15m▄\x1b[38;2;91;67;37;48;2;105;79;45m▌\x1b[38;2;96;64;31;48;2;186;135;70m▊\x1b[38;2;226;169;101;48;2;217;162;91m▗\x1b[38;2;216;159;89;48;2;144;93;44m▅\x1b[38;2;195;145;83;48;2;112;62;24m▅\x1b[38;2;233;178;110;48;2;206;151;81m▆\x1b[38;2;207;155;92;48;2;105;61;30m▎\x1b[38;2;145;94;46;48;2;94;50;19m▖\x1b[38;2;90;48;17;48;2;52;26;8m▎\x1b[38;2;59;33;9;48;2;64;40;14m▖\x1b[38;2;63;39;13;48;2;65;41;13m▊\x1b[38;2;58;36;11;48;2;64;40;14m▝\x1b[38;2;60;38;13;48;2;57;35;10m▍\x1b[0m',
-    '\x1b[38;2;37;22;12;48;2;11;2;2m▕\x1b[38;2;52;32;16;48;2;94;67;32m▘\x1b[38;2;77;53;21;48;2;125;96;52m▗\x1b[38;2;44;15;6;48;2;83;48;21m▞\x1b[38;2;122;73;33;48;2;195;138;72m▍\x1b[38;2;209;149;77;48;2;223;160;89m▋\x1b[38;2;228;157;84;48;2;234;173;98m▆\x1b[38;2;207;140;80;48;2;225;167;96m▝\x1b[38;2;213;151;88;48;2;193;135;79m▏\x1b[38;2;164;111;60;48;2;104;54;21m▍\x1b[38;2;175;110;52;48;2;136;78;32m▘\x1b[38;2;93;47;15;48;2;26;5;2m▎\x1b[38;2;39;13;4;48;2;54;28;8m▍\x1b[38;2;63;40;13;48;2;67;44;16m▔\x1b[38;2;68;44;15;48;2;65;41;16m▊\x1b[38;2;60;36;11;48;2;63;39;14m▝\x1b[0m',
-    '\x1b[38;2;12;1;0;48;2;55;33;13m▌\x1b[38;2;92;63;32;48;2;68;43;17m▝\x1b[38;2;75;51;24;48;2;93;65;34m▗\x1b[38;2;88;61;30;48;2;42;18;8m▘\x1b[38;2;62;35;18;48;2;191;150;83m▍\x1b[38;2;186;140;75;48;2;194;138;63m▁\x1b[38;2;189;130;61;48;2;219;157;79m▄\x1b[38;2;191;132;70;48;2;217;159;87m▂\x1b[38;2;179;105;60;48;2;207;146;83m▔\x1b[38;2;171;106;51;48;2;135;79;32m▋\x1b[38;2;64;30;8;48;2;120;69;27m▗\x1b[38;2;56;26;8;48;2;39;13;5m▂\x1b[38;2;44;18;7;48;2;72;44;16m▘\x1b[38;2;72;47;18;48;2;69;44;14m▖\x1b[38;2;70;46;14;48;2;68;44;14m▁\x1b[38;2;65;41;12;48;2;65;41;14m▘\x1b[0m',
-    '\x1b[38;2;77;56;35;48;2;22;8;3m▂\x1b[38;2;126;100;69;48;2;59;36;15m▃\x1b[38;2;131;105;70;48;2;80;54;27m▄\x1b[38;2;128;103;68;48;2;57;33;14m▄\x1b[38;2;191;174;117;48;2;125;103;69m▝\x1b[38;2;191;164;108;48;2;236;227;160m▞\x1b[38;2;220;202;137;48;2;173;123;63m▃\x1b[38;2;130;85;43;48;2;164;111;58m▄\x1b[38;2;117;68;26;48;2;185;116;58m▆\x1b[38;2;135;80;33;48;2;94;52;15m▘\x1b[38;2;51;28;9;48;2;80;50;16m▂\x1b[38;2;62;33;9;48;2;76;46;14m▘\x1b[38;2;75;50;16;48;2;74;47;15m▗\x1b[38;2;71;46;14;48;2;72;47;15m▝\x1b[38;2;73;48;16;48;2;69;44;14m▏\x1b[38;2;65;41;11;48;2;66;41;15m▆\x1b[0m',
-    '\x1b[38;2;125;101;70;48;2;159;129;87m▔\x1b[38;2;145;114;71;48;2;124;100;70m▆\x1b[38;2;152;123;81;48;2;121;100;69m▃\x1b[38;2;117;95;60;48;2;129;106;70m▖\x1b[38;2;115;91;61;48;2;131;105;69m▗\x1b[38;2;166;145;103;48;2;140;113;71m▔\x1b[38;2;162;135;87;48;2;231;217;147m▅\x1b[38;2;133;107;71;48;2;199;171;110m▂\x1b[38;2;131;100;59;48;2;107;75;37m▍\x1b[38;2;166;139;88;48;2;67;40;14m▃\x1b[38;2;204;179;121;48;2;39;19;8m▄\x1b[38;2;137;112;73;48;2;52;28;10m▖\x1b[38;2;54;32;10;48;2;76;49;16m▅\x1b[38;2;56;33;9;48;2;74;48;15m▃\x1b[38;2;60;37;10;48;2;70;47;14m▁\x1b[38;2;66;43;12;48;2;64;40;11m▅\x1b[0m',
-    '\x1b[38;2;157;128;85;48;2;167;138;98m▝\x1b[38;2;141;111;71;48;2;166;136;98m▝\x1b[38;2;149;119;83;48;2;126;96;60m▞\x1b[38;2;157;129;93;48;2;139;113;81m▅\x1b[38;2;144;117;79;48;2;117;92;58m▋\x1b[38;2;130;102;62;48;2;169;138;87m▋\x1b[38;2;171;141;87;48;2;143;117;77m▖\x1b[38;2;144;117;79;48;2;122;96;63m▊\x1b[38;2;132;105;68;48;2;144;117;82m▖\x1b[38;2;153;127;92;48;2;140;115;83m▞\x1b[38;2;134;108;71;48;2;217;193;135m▅\x1b[38;2;176;150;98;48;2;129;105;66m▋\x1b[38;2;118;94;61;48;2;54;32;14m▂\x1b[38;2;44;23;8;48;2;59;37;13m▃\x1b[38;2;62;41;16;48;2;48;26;9m▖\x1b[38;2;46;24;6;48;2;66;42;15m▖\x1b[0m',
+    '\x1b[0m\x1b[38;5;16;48;5;16m      \x1b[38;5;232m▁\x1b[38;5;235;48;5;232m▂\x1b[38;5;58;48;5;233m▄\x1b[38;5;95;48;5;234m▆\x1b[38;5;137;48;5;58m▄\x1b[38;5;173m▅\x1b[48;5;94m▅\x1b[48;5;58m▆▅\x1b[48;5;237m▄\x1b[38;5;137;48;5;234m▃\x1b[38;5;235;48;5;233m▂   \x1b[38;5;233;48;5;232m▂▅\x1b[48;5;233m     \x1b[0m',
+    '\x1b[38;5;16;48;5;16m     \x1b[38;5;235;48;5;232m▗\x1b[38;5;233;48;5;236m▘\x1b[38;5;8;48;5;239m▌\x1b[38;5;95;48;5;137m▋\x1b[38;5;137;48;5;179m▘  \x1b[38;5;179;48;5;173m▃\x1b[48;5;179m   \x1b[48;5;173m▊\x1b[38;5;58;48;5;137m▝\x1b[38;5;94;48;5;235m▖\x1b[38;5;234;48;5;233m▅▄▂  ▂▗▄▃\x1b[0m',
+    '\x1b[38;5;16;48;5;16m    \x1b[38;5;235;48;5;232m▗\x1b[38;5;236;48;5;237m▍ \x1b[38;5;58;48;5;94m▋\x1b[38;5;95;48;5;173m▌\x1b[48;5;179m \x1b[38;5;179;48;5;215m▍\x1b[48;5;221m▔\x1b[38;5;222;48;5;180m▍\x1b[48;5;179m  \x1b[38;5;173m▕\x1b[38;5;179;48;5;173m▅\x1b[38;5;137m▕\x1b[38;5;95;48;5;58m▍\x1b[38;5;58;48;5;235m▖\x1b[38;5;235;48;5;234m▖▃▄     \x1b[0m',
+    '\x1b[38;5;16;48;5;16m   \x1b[38;5;233m▗\x1b[48;5;235m▏\x1b[38;5;237;48;5;238m▊\x1b[38;5;238;48;5;236m▌\x1b[38;5;236;48;5;58m▖\x1b[38;5;95;48;5;179m▌ \x1b[38;5;137m▗\x1b[38;5;94m▄\x1b[38;5;58m▄\x1b[38;5;94m▄\x1b[38;5;137m▖\x1b[38;5;173m▗\x1b[38;5;131m▗\x1b[38;5;58;48;5;137m▃\x1b[38;5;131;48;5;58m▘\x1b[38;5;234m▕\x1b[48;5;236m▖\x1b[38;5;236;48;5;235m▃    \x1b[38;5;234m▝\x1b[38;5;235;48;5;234m▃\x1b[0m',
+    '\x1b[38;5;16;48;5;16m  \x1b[38;5;235;48;5;232m▂\x1b[38;5;236;48;5;234m▄\x1b[38;5;237;48;5;236m▗\x1b[38;5;8;48;5;239m▖\x1b[38;5;240;48;5;8m▎\x1b[38;5;94;48;5;236m▕\x1b[38;5;137;48;5;179m▍ \x1b[38;5;94;48;5;137m▝\x1b[38;5;173;48;5;94m▂\x1b[38;5;137;48;5;58m▂\x1b[48;5;94m▃\x1b[48;5;179m▘\x1b[38;5;173m▝\x1b[38;5;137;48;5;235m▍\x1b[38;5;94;48;5;236m▝\x1b[38;5;235;48;5;94m▖\x1b[38;5;52;48;5;58m▖\x1b[38;5;235;48;5;233m▝\x1b[48;5;236m▁\x1b[48;5;235m      \x1b[0m',
+    '\x1b[38;5;232;48;5;16m▗\x1b[38;5;233;48;5;236m▌\x1b[38;5;95;48;5;239m▅\x1b[48;5;240m▃\x1b[38;5;94;48;5;238m▖\x1b[38;5;240;48;5;8m▝\x1b[38;5;95;48;5;236m▘\x1b[38;5;236;48;5;95m▘\x1b[38;5;173;48;5;179m▏ \x1b[38;5;215m▄ \x1b[38;5;179;48;5;137m▅\x1b[38;5;137;48;5;179m▘\x1b[38;5;216m▘\x1b[38;5;179;48;5;216m▃\x1b[48;5;94m▌\x1b[38;5;94;48;5;131m▘\x1b[38;5;95;48;5;94m▋\x1b[38;5;94;48;5;52m▃\x1b[38;5;52;48;5;233m▎\x1b[38;5;233;48;5;235m▅\x1b[38;5;234m▂     \x1b[0m',
+    '\x1b[38;5;233;48;5;232m▕\x1b[38;5;234;48;5;236m▘\x1b[38;5;8;48;5;95m▌ \x1b[38;5;236m▃\x1b[38;5;58;48;5;234m▘\x1b[38;5;94m▝\x1b[48;5;137m▎\x1b[38;5;179;48;5;173m▍\x1b[38;5;173;48;5;179m▌▆▖▃▞\x1b[38;5;94;48;5;173m▗\x1b[48;5;179m▄\x1b[38;5;179;48;5;58m▘\x1b[38;5;94;48;5;52m▝\x1b[38;5;130;48;5;131m▃\x1b[38;5;94;48;5;58m▍\x1b[38;5;52;48;5;232m▎\x1b[38;5;232;48;5;233m▌\x1b[38;5;233;48;5;234m▏\x1b[38;5;234;48;5;235m▎\x1b[38;5;236m▌▅▄ \x1b[0m',
+    '\x1b[38;5;232;48;5;235m▋\x1b[38;5;58;48;5;236m▝\x1b[48;5;58m \x1b[38;5;239;48;5;94m▅\x1b[38;5;237;48;5;235m▂\x1b[38;5;235;48;5;233m▂\x1b[38;5;234;48;5;94m▄\x1b[38;5;94;48;5;137m▖\x1b[48;5;173m \x1b[38;5;173;48;5;179m▃  \x1b[38;5;137m▂▃▂\x1b[38;5;131;48;5;137m▃\x1b[38;5;58;48;5;131m▝\x1b[38;5;94;48;5;52m▅\x1b[48;5;94m \x1b[48;5;58m▍\x1b[38;5;235;48;5;232m▎\x1b[38;5;232;48;5;233m▋\x1b[38;5;233;48;5;234m▍\x1b[38;5;235;48;5;236m▏  \x1b[38;5;236;48;5;235m▎ \x1b[0m',
+    '\x1b[38;5;234;48;5;235m▏\x1b[38;5;236;48;5;237m▋\x1b[38;5;237;48;5;8m▃\x1b[38;5;235;48;5;238m▗\x1b[38;5;237m▖\x1b[38;5;58;48;5;234m▌\x1b[38;5;234;48;5;233m▎\x1b[38;5;236;48;5;137m▎\x1b[38;5;137;48;5;173m▄ \x1b[38;5;173;48;5;179m▄▃ \x1b[38;5;179;48;5;215m▅\x1b[38;5;173;48;5;179m▄\x1b[38;5;179;48;5;137m▘\x1b[38;5;137;48;5;131m▌\x1b[48;5;94m \x1b[38;5;58m▗\x1b[38;5;233;48;5;58m▗\x1b[48;5;233m  \x1b[38;5;234;48;5;236m▘ \x1b[38;5;236;48;5;235m▃▞\x1b[38;5;235;48;5;236m▄\x1b[48;5;235m \x1b[0m',
+    '\x1b[38;5;234;48;5;235m▏▆\x1b[38;5;235;48;5;237m▌\x1b[38;5;236m▝\x1b[38;5;237;48;5;234m▍\x1b[38;5;234;48;5;233m▖\x1b[38;5;240;48;5;234m▗\x1b[38;5;101;48;5;186m▌\x1b[38;5;137m▝\x1b[48;5;137m   \x1b[48;5;173m▆▄▃\x1b[38;5;131m▂\x1b[38;5;130;48;5;137m▂\x1b[38;5;58;48;5;94m▃\x1b[48;5;58m \x1b[38;5;234;48;5;233m▏\x1b[38;5;235;48;5;234m▅\x1b[48;5;236m▌   ▝ \x1b[48;5;235m \x1b[0m',
+    '\x1b[38;5;234;48;5;233m▕\x1b[38;5;239;48;5;235m▂\x1b[38;5;95m▃\x1b[48;5;237m▄\x1b[48;5;236m▄\x1b[48;5;235m▄\x1b[38;5;236;48;5;240m▘\x1b[38;5;101;48;5;95m▕\x1b[48;5;186m▖\x1b[38;5;179;48;5;229m▝\x1b[38;5;223;48;5;137m▃\x1b[38;5;137;48;5;131m▁\x1b[38;5;95m▅\x1b[38;5;94m▂\x1b[48;5;94m \x1b[38;5;58m▗\x1b[38;5;94;48;5;58m▔\x1b[38;5;236m▁ \x1b[48;5;235m▆\x1b[38;5;235;48;5;236m▍\x1b[38;5;236;48;5;235m▆\x1b[48;5;236m    \x1b[38;5;235m▅\x1b[48;5;235m \x1b[0m',
+    '\x1b[38;5;237;48;5;95m▔       \x1b[38;5;137;48;5;101m▝\x1b[48;5;187m▅\x1b[38;5;180;48;5;229m▂\x1b[38;5;143;48;5;222m▔\x1b[38;5;186;48;5;58m▅\x1b[38;5;179m▂\x1b[38;5;95m▁\x1b[38;5;235m▂\x1b[38;5;236m▄\x1b[48;5;233m▌\x1b[38;5;235m▔\x1b[38;5;233;48;5;236m▅\x1b[38;5;234m▃\x1b[38;5;235m▁    ▔\x1b[48;5;235m \x1b[0m',
+    '\x1b[38;5;101;48;5;137m▔\x1b[38;5;95;48;5;101m▄▔\x1b[38;5;101;48;5;95m▄  ▗ \x1b[38;5;240m▖\x1b[38;5;95;48;5;101m▘\x1b[38;5;137m▔\x1b[48;5;222m▅\x1b[48;5;186m▃\x1b[48;5;179m▂\x1b[38;5;101;48;5;95m▌\x1b[48;5;58m \x1b[38;5;238;48;5;236m▁\x1b[38;5;180;48;5;234m▃\x1b[48;5;235m▄\x1b[38;5;179;48;5;234m▃\x1b[38;5;95m▁\x1b[38;5;234;48;5;235m▊\x1b[48;5;236m▆\x1b[38;5;235m▃\x1b[38;5;234m▂\x1b[38;5;235m▁ \x1b[38;5;236;48;5;235m▎\x1b[0m',
+    '\x1b[38;5;137;48;5;137m \x1b[48;5;95m▄ \x1b[38;5;95;48;5;101m▖\x1b[48;5;137m▝\x1b[48;5;95m \x1b[38;5;101m▅\x1b[48;5;239m▋\x1b[48;5;95m \x1b[38;5;95;48;5;137m▋\x1b[38;5;101;48;5;95m▍\x1b[38;5;95;48;5;101m▖\x1b[38;5;101;48;5;95m▆\x1b[38;5;239m▗\x1b[38;5;101m▄ \x1b[38;5;95;48;5;137m▅\x1b[38;5;137;48;5;180m▅\x1b[38;5;180;48;5;186m▃\x1b[48;5;143m▆\x1b[38;5;95m▔\x1b[38;5;143;48;5;235m▖\x1b[48;5;234m \x1b[38;5;235m▆\x1b[38;5;234;48;5;235m▝\x1b[38;5;235;48;5;234m▞\x1b[38;5;234;48;5;235m▄ \x1b[0m',
 ];
 // ─── FRANKLIN text banner (gold → emerald gradient) ────────────────────────
 //
@@ -63,9 +69,9 @@ function interpolateHex(start, end, t) {
 }
 // ─── Banner layout ─────────────────────────────────────────────────────────
 // Minimum terminal width to show the side-by-side portrait + text layout.
-// The portrait is ~16 chars, the FRANKLIN text is ~65 chars, plus a 3-char
-// gap = 84 chars. We round up to 85 cols as the threshold.
-const MIN_WIDTH_FOR_PORTRAIT = 85;
+// The portrait is ~28 chars, the FRANKLIN text is ~65 chars, plus a 3-char
+// gap = 96 chars. We add a small margin so 100 cols is the threshold.
+const MIN_WIDTH_FOR_PORTRAIT = 100;
 /**
  * Pad a line to an exact visual width, ignoring ANSI escape codes when
  * measuring. Used to align the portrait's right edge before the text block.
@@ -93,21 +99,28 @@ export function printBanner(version) {
 }
 /**
  * Full layout: Ben Franklin portrait on the left, FRANKLIN text block on the
- * right. Portrait is 8 rows × ~16 chars, text is 6 rows — text is vertically
- * centred inside the portrait with 1 row of padding above.
+ * right. Portrait is 14 rows × ~28 chars, text is 6 rows — text is vertically
+ * centred inside the portrait with 4 rows of padding above and 4 below,
+ * tagline sitting right under the FRANKLIN block.
  *
- *   [portrait row 1]                (empty)
- *   [portrait row 2]   ███████╗██████╗  █████╗ ...
- *   [portrait row 3]   ██╔════╝██╔══██╗██╔══██╗...
- *   [portrait row 4]   █████╗  ██████╔╝███████║...
- *   [portrait row 5]   ██╔══╝  ██╔══██╗██╔══██║...
- *   [portrait row 6]   ██║     ██║  ██║██║  ██║...
- *   [portrait row 7]   ╚═╝     ╚═╝  ╚═╝╚═╝  ╚═╝...
- *   [portrait row 8]   blockrun.ai · The AI agent with a wallet · vX
+ *   [portrait row  1]                (empty)
+ *   [portrait row  2]                (empty)
+ *   [portrait row  3]                (empty)
+ *   [portrait row  4]                (empty)
+ *   [portrait row  5]   ███████╗██████╗  █████╗ ...
+ *   [portrait row  6]   ██╔════╝██╔══██╗██╔══██╗...
+ *   [portrait row  7]   █████╗  ██████╔╝███████║...
+ *   [portrait row  8]   ██╔══╝  ██╔══██╗██╔══██║...
+ *   [portrait row  9]   ██║     ██║  ██║██║  ██║...
+ *   [portrait row 10]   ╚═╝     ╚═╝  ╚═╝╚═╝  ╚═╝...
+ *   [portrait row 11]   blockrun.ai · The AI agent with a wallet · vX
+ *   [portrait row 12]                (empty)
+ *   [portrait row 13]                (empty)
+ *   [portrait row 14]                (empty)
  */
 function printSideBySide(version) {
-    const TEXT_TOP_OFFSET = 1; // rows of portrait above the text
-    const PORTRAIT_WIDTH = 17; // columns (char width) of the portrait + 1 pad
+    const TEXT_TOP_OFFSET = 4; // rows of portrait above the text
+    const PORTRAIT_WIDTH = 29; // columns (char width) of the portrait + 1 pad
     const GAP = '  '; // gap between portrait and text
     const portraitRows = BEN_PORTRAIT_ROWS;
     const textRows = FRANKLIN_ART.length;

package/dist/commands/migrate.d.ts

@@ -0,0 +1,13 @@
+/**
+ * franklin migrate — one-click import from other AI coding agents.
+ *
+ * Detects installed tools (Claude Code, Cline, Cursor, etc.),
+ * shows what can be migrated, and imports with user confirmation.
+ */
+export declare function migrateCommand(): Promise<void>;
+/**
+ * Check if other AI tools are installed and suggest migration.
+ * Only runs once — writes a marker file after first check.
+ * Returns true if the user chose to migrate (caller should re-run start after).
+ */
+export declare function checkAndSuggestMigration(): Promise<boolean>;