promptarc 0.0.3 → 0.0.4

package/dist/bin.js

@@ -11,16 +11,19 @@
  *   promptarc login      Run the auth flow without booting the server
  *   promptarc logout     Delete the saved auth token
  *   promptarc whoami     Print the signed-in account
+ *   promptarc pr         Generate a PR description from the current session
+ *   promptarc pull       Download a shared session for resume
  *   promptarc --version  Print the package version
  */
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
 import { homedir } from 'node:os';
-import { dirname, join, resolve } from 'node:path';
+import { basename, dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { spawn } from 'node:child_process';
 import { createServer } from 'node:net';
 import { runLogin, loadAuth, deleteAuth } from './auth.js';
 import { startSyncLoop } from './sync.js';
+import { buildReplayFromJsonl } from './share-direct.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const VERSION = readJson(join(__dirname, '..', 'package.json')).version ?? '0.0.0';
@@ -54,10 +57,25 @@ async function main() {
         console.log(`Signed in as ${auth.email ?? auth.userId}${auth.login ? ` (@${auth.login})` : ''}`);
         return;
     }
+    if (cmd === 'context') {
+        await runContext(args.slice(1));
+        return;
+    }
     if (cmd === 'pr') {
         await runPR(args.slice(1));
         return;
     }
+    if (cmd === 'share') {
+        const sessionArg = args[1];
+        if (!sessionArg) {
+            console.error('Usage: promptarc share <session-id>');
+            console.error('  Share a local session to the cloud as private.');
+            process.exitCode = 1;
+            return;
+        }
+        await runShare(sessionArg, args.slice(2));
+        return;
+    }
     if (cmd === 'pull') {
         const slug = args[1];
         if (!slug) {
@@ -85,8 +103,10 @@ COMMANDS
   login       Sign in to your promptarc account via GitHub
   logout      Delete the saved auth token
   whoami      Print the currently signed-in account
+  context     What do I need to know? Past sessions for this project
   pr          Generate a PR description from the current session
   pr --share  Generate + share session as private (includes link)
+  share <id>  Share a local session to the cloud (private by default)
   pull <slug> Download a shared session into ~/.claude/ for resume
   --version   Print the CLI version
   --help      Show this message
@@ -95,13 +115,515 @@ LEARN MORE
   https://promptarc.dev
 `);
 }
-async function runPR(args) {
+async function runContext(args) {
+    const cwd = process.cwd();
+    const query = args.filter((a) => !a.startsWith('--')).join(' ');
+    const filesFlag = args.includes('--files');
+    const cwdParts = cwd.split('/').filter(Boolean);
+    const projectName = cwdParts[cwdParts.length - 1] ?? '';
+    console.log(`promptarc context`);
+    console.log(`  ▸ project: ${projectName}`);
+    // 1. Detect recently changed files (git + find fallback).
+    let files = [];
+    if (filesFlag) {
+        try {
+            const { execSync } = await import('node:child_process');
+            // Try git first: staged + last 3 commits.
+            const gitFiles = execSync('git diff --name-only HEAD~3 HEAD 2>/dev/null; git diff --name-only --cached 2>/dev/null; git diff --name-only 2>/dev/null', { cwd, encoding: 'utf8' });
+            files = [...new Set(gitFiles.split('\n').filter(Boolean))].slice(0, 15);
+        }
+        catch { /* not a git repo */ }
+        // Fallback: recently modified files.
+        if (files.length === 0) {
+            try {
+                const { execSync } = await import('node:child_process');
+                const found = execSync('find . -maxdepth 3 -name "*.ts" -o -name "*.tsx" -o -name "*.js" -o -name "*.py" -o -name "*.rs" -o -name "*.go" | head -15', { cwd, encoding: 'utf8' });
+                files = found.split('\n').filter(Boolean).map((f) => f.replace(/^\.\//, ''));
+            }
+            catch { /* no find */ }
+        }
+    }
+    if (files.length > 0) {
+        console.log(`  ▸ files: ${files.slice(0, 5).join(', ')}${files.length > 5 ? ` +${files.length - 5} more` : ''}`);
+    }
+    // 2. Local scan: find sessions across all three agents for this project.
+    console.log(`  ▸ scanning local sessions...`);
+    const localSessions = scanLocalSessions(cwd, projectName);
+    if (localSessions.length > 0) {
+        const lastActive = fmtRelativeTime(localSessions[0].mtime);
+        console.log(`\n  ${projectName} · ${localSessions.length} session${localSessions.length === 1 ? '' : 's'} · last active ${lastActive}`);
+    }
+    // 3. Cloud search + AI briefing (requires auth).
     const auth = loadAuth();
+    let cloudSessionsFound = false;
+    if (auth) {
+        console.log(`\n  ▸ searching cloud archive...`);
+        const siteUrl = process.env.PROMPTARC_SITE_URL ?? 'https://promptarc.dev';
+        // Build local context to send to the API for AI briefing.
+        const localContext = localSessions.slice(0, 3).map((s) => {
+            const prompt = s.firstPrompt
+                ? s.firstPrompt.replace(/<[^>]+>/g, ' ').replace(/\s+/g, ' ').trim().slice(0, 300)
+                : '';
+            return `[${s.agent}] ${prompt} (${s.messageCount} messages)`;
+        }).join('\n');
+        try {
+            const res = await fetch(`${siteUrl}/api/ai/context`, {
+                method: 'POST',
+                headers: {
+                    'content-type': 'application/json',
+                    authorization: `Bearer ${auth.token}`,
+                },
+                body: JSON.stringify({
+                    cwd,
+                    files,
+                    query,
+                    localContext,
+                }),
+            });
+            if (res.ok) {
+                const json = (await res.json());
+                if (json.count > 0) {
+                    cloudSessionsFound = true;
+                    console.log(`  ${json.count} cloud session${json.count === 1 ? '' : 's'} found.\n`);
+                }
+                else {
+                    console.log(`  No cloud sessions found.`);
+                    if (localSessions.length > 0) {
+                        console.log(`  Share sessions to unlock AI briefing from any machine.`);
+                    }
+                }
+                // Resume command — pick up the exact session.
+                if (localSessions.length > 0) {
+                    const latest = localSessions[0];
+                    const agentCmd = latest.agent === 'codex'
+                        ? 'codex'
+                        : latest.agent === 'cursor'
+                            ? 'cursor'
+                            : 'claude';
+                    const shortId = latest.sessionId ?? basename(latest.path, '.jsonl');
+                    console.log(`\n  Resume last session:`);
+                    console.log(`    ${agentCmd} --resume ${shortId}`);
+                }
+                // AI briefing — the actionable part.
+                if (json.aiBriefing) {
+                    if (json.aiBriefing.unfinished) {
+                        console.log(`\n  What's unfinished:`);
+                        for (const line of json.aiBriefing.unfinished.split('\n')) {
+                            const trimmed = line.trim();
+                            if (trimmed)
+                                console.log(`    ${trimmed}`);
+                        }
+                    }
+                    if (json.aiBriefing.resumePrompt) {
+                        console.log(`\n  Resume prompt (paste into your agent):`);
+                        console.log(`  ┌─`);
+                        for (const line of json.aiBriefing.resumePrompt.split('\n')) {
+                            console.log(`  │ ${line}`);
+                        }
+                        console.log(`  └─`);
+                    }
+                    if (json.aiBriefing.warnings) {
+                        console.log(`\n  Heads up:`);
+                        for (const line of json.aiBriefing.warnings.split('\n')) {
+                            const trimmed = line.trim();
+                            if (trimmed)
+                                console.log(`    ${trimmed}`);
+                        }
+                    }
+                }
+                else if (localSessions.length > 0 && json.count === 0) {
+                    console.log(`\n  Share sessions to get AI briefings with resume prompts.`);
+                }
+            }
+            else {
+                console.log(`  Cloud search failed (HTTP ${res.status}).`);
+            }
+        }
+        catch {
+            console.log(`  Could not reach promptarc.dev (offline?).`);
+            if (localSessions.length === 0) {
+                console.log(`  No local sessions found either.`);
+            }
+        }
+    }
+    else if (localSessions.length === 0) {
+        console.log(`\n  No local sessions found. Run \`promptarc login\` to search cloud archive.`);
+    }
+    else {
+        console.log(`\n  Run \`promptarc login\` to also search your cloud archive.`);
+    }
+    // Session list at the bottom (least important).
+    if (localSessions.length > 0) {
+        console.log('');
+        for (const s of localSessions.slice(0, 6)) {
+            const when = fmtRelativeTime(s.mtime);
+            const agent = s.agent === 'claude' ? 'Claude' : s.agent === 'codex' ? 'Codex' : 'Cursor';
+            const cleanPrompt = s.firstPrompt
+                ? s.firstPrompt.replace(/<[^>]+>/g, ' ').replace(/\s+/g, ' ').trim()
+                : '';
+            let title = cleanPrompt || `Session ${basename(s.path, '.jsonl').slice(0, 8)}`;
+            if (title.length > 50) {
+                title = title.slice(0, 50).replace(/\s\S*$/, '') + '...';
+            }
+            console.log(`  ${when.padEnd(13)} [${agent}]  ${title} · ${fmtNumber(s.messageCount)} msgs`);
+        }
+        // Gentle share nudge — only when no cloud sessions exist.
+        if (!auth || !cloudSessionsFound) {
+            const latest = localSessions[0];
+            console.log(`\n  ${localSessions.length} local session${localSessions.length === 1 ? '' : 's'} · 0 cloud sessions`);
+            console.log(`  Share to search from any machine: promptarc share ${latest.sessionId.slice(0, 8)}`);
+        }
+    }
+    console.log('');
+}
+/**
+ * Scan ~/.claude/, ~/.codex/, ~/.cursor/ for sessions matching the
+ * current project. Returns session summaries sorted by recency.
+ */
+function scanLocalSessions(cwd, projectName) {
+    const results = [];
+    const cwdEncoded = cwd.replace(/\//g, '-');
+    // Claude Code: ~/.claude/projects/<encoded-cwd>/*.jsonl
+    const claudeRoot = join(homedir(), '.claude', 'projects');
+    try {
+        for (const dir of readdirSync(claudeRoot)) {
+            if (dir === cwdEncoded || dir.endsWith(projectName)) {
+                const projectDir = join(claudeRoot, dir);
+                if (!statSync(projectDir).isDirectory())
+                    continue;
+                for (const file of readdirSync(projectDir)) {
+                    if (!file.endsWith('.jsonl'))
+                        continue;
+                    const fp = join(projectDir, file);
+                    const info = quickParseSession(fp, 'claude');
+                    if (info)
+                        results.push(info);
+                }
+            }
+        }
+    }
+    catch { /* no Claude sessions */ }
+    // Codex: ~/.codex/sessions/**/*.jsonl (match cwd in first line)
+    const codexRoot = join(homedir(), '.codex', 'sessions');
+    try {
+        const codexFiles = findJsonlRecursive(codexRoot);
+        for (const fp of codexFiles) {
+            try {
+                const firstLine = readFileSync(fp, 'utf8').split('\n')[0] ?? '';
+                if (firstLine.includes(cwd) || firstLine.includes(projectName)) {
+                    const info = quickParseSession(fp, 'codex');
+                    if (info)
+                        results.push(info);
+                }
+            }
+            catch { /* skip */ }
+        }
+    }
+    catch { /* no Codex sessions */ }
+    // Cursor: ~/.cursor/projects/<encoded>/agent-transcripts/<uuid>/<uuid>.jsonl
+    const cursorEncoded = cwd.replace(/\//g, '-').replace(/^-/, '');
+    const cursorRoot = join(homedir(), '.cursor', 'projects');
+    try {
+        for (const dir of readdirSync(cursorRoot)) {
+            if (dir === cursorEncoded || dir.endsWith(projectName)) {
+                const transcriptsDir = join(cursorRoot, dir, 'agent-transcripts');
+                try {
+                    for (const sd of readdirSync(transcriptsDir)) {
+                        const fp = join(transcriptsDir, sd, `${sd}.jsonl`);
+                        try {
+                            statSync(fp);
+                            const info = quickParseSession(fp, 'cursor');
+                            if (info)
+                                results.push(info);
+                        }
+                        catch { /* skip */ }
+                    }
+                }
+                catch { /* no transcripts */ }
+            }
+        }
+    }
+    catch { /* no Cursor sessions */ }
+    // Sort by most recent first.
+    results.sort((a, b) => b.mtime - a.mtime);
+    return results;
+}
+/**
+ * Quick parse a JSONL session to extract: mtime, message count,
+ * and the first user prompt. Reads only enough to get the data
+ * without loading the entire file.
+ */
+function quickParseSession(filePath, agent) {
+    try {
+        const stat = statSync(filePath);
+        // For large files, read only the first 100KB to find the first prompt.
+        // Estimate total message count from line count of the full file.
+        const fullRaw = readFileSync(filePath, 'utf8');
+        const totalLines = fullRaw.split('\n').filter(Boolean).length;
+        const scanRaw = fullRaw.length > 100_000 ? fullRaw.slice(0, 100_000) : fullRaw;
+        const lines = scanRaw.split('\n').filter(Boolean);
+        if (totalLines === 0)
+            return null;
+        let messageCount = totalLines; // approximate: 1 line ≈ 1 entry
+        let firstPrompt = '';
+        for (const line of lines) {
+            let parsed;
+            try {
+                parsed = JSON.parse(line);
+            }
+            catch {
+                continue;
+            }
+            // Claude Code: {type: "user", message: "text"}
+            if (agent === 'claude') {
+                if (!firstPrompt && parsed.type === 'user') {
+                    let text = '';
+                    if (typeof parsed.message === 'string')
+                        text = parsed.message;
+                    else if (typeof parsed.message === 'object' && parsed.message) {
+                        const content = parsed.message.content;
+                        // content can be a string or an array of blocks.
+                        if (typeof content === 'string')
+                            text = content;
+                        else if (Array.isArray(content)) {
+                            const textBlock = content.find((b) => b.type === 'text');
+                            if (textBlock)
+                                text = textBlock.text;
+                        }
+                    }
+                    // Skip system messages and interrupted markers.
+                    if (text && !isSystemMessage(text))
+                        firstPrompt = text;
+                }
+            }
+            // Codex: {type: "event_msg", payload: {type: "user_message", message: "..."}}
+            if (agent === 'codex') {
+                if (!firstPrompt && parsed.type === 'event_msg') {
+                    const payload = parsed.payload;
+                    if (payload?.type === 'user_message' && typeof payload.message === 'string') {
+                        firstPrompt = payload.message;
+                    }
+                }
+            }
+            // Cursor: {role: "user", message: {content: [{type: "text", text: "..."}]}}
+            if (agent === 'cursor') {
+                if (!firstPrompt && parsed.role === 'user' && typeof parsed.message === 'object' && parsed.message) {
+                    const content = parsed.message.content;
+                    if (Array.isArray(content)) {
+                        const textBlock = content.find((b) => b.type === 'text');
+                        if (textBlock) {
+                            firstPrompt = textBlock.text
+                                .replace(/<\/?user_query>/g, '')
+                                .trim();
+                        }
+                    }
+                }
+            }
+            // Stop as soon as we find a real user prompt.
+            if (firstPrompt)
+                break;
+        }
+        if (totalLines < 2)
+            return null;
+        // Fallback title: use session ID from filename.
+        if (!firstPrompt) {
+            const name = basename(filePath, '.jsonl');
+            firstPrompt = `Session ${name.slice(0, 8)}... (${messageCount} messages)`;
+        }
+        // Extract session ID from filename or path.
+        const fileName = basename(filePath, '.jsonl');
+        const uuidMatch = fileName.match(/([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})/i);
+        const sessionId = uuidMatch?.[1] ?? fileName;
+        return {
+            path: filePath,
+            sessionId,
+            agent,
+            mtime: stat.mtimeMs,
+            messageCount,
+            firstPrompt,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/** Filter out system-generated messages that aren't real user prompts. */
+function isSystemMessage(text) {
+    const t = text.trim().toLowerCase();
+    return (t.startsWith('[request interrupted') ||
+        t.startsWith('[tool use') ||
+        t.startsWith('<system') ||
+        t.startsWith('<environment') ||
+        t.startsWith('<permissions') ||
+        t.startsWith('<app-context') ||
+        t === '' ||
+        t.length < 5);
+}
+async function runShare(sessionArg, extraArgs) {
+    let auth = loadAuth();
     if (!auth) {
-        console.error('Not signed in. Run `promptarc login` first.');
+        console.log('  ▸ not signed in, starting login...');
+        auth = await runLogin();
+    }
+    // Find the session file.
+    const session = sessionArg.length >= 8
+        ? findSessionById(sessionArg)
+        : null;
+    if (!session) {
+        // Try partial match — the user might pass just the first 8 chars.
+        const partialMatch = findSessionByPrefix(sessionArg);
+        if (!partialMatch) {
+            console.error(`Session not found: ${sessionArg}`);
+            console.error('Run `promptarc context` to see available sessions.');
+            process.exitCode = 1;
+            return;
+        }
+        return doShare(partialMatch, auth);
+    }
+    return doShare(session, auth);
+}
+async function doShare(session, auth) {
+    console.log(`promptarc share`);
+    console.log(`  ▸ session: ${session.sessionId.slice(0, 8)}...`);
+    console.log(`  ▸ building artifact locally...`);
+    // Extract project name from projectId.
+    const projectId = session.projectId ?? '';
+    const parts = projectId.replace(/^(codex:|cursor:)/, '').split('-').filter(Boolean);
+    const projectName = parts[parts.length - 1] ?? 'unknown';
+    // Build the SharedReplay artifact locally (reads JSONL, redacts secrets).
+    let replay;
+    try {
+        replay = buildReplayFromJsonl(session.path, projectName);
+    }
+    catch (err) {
+        console.error(`  ✗ Failed to build artifact: ${String(err)}`);
+        process.exitCode = 1;
+        return;
+    }
+    console.log(`  ▸ ${replay.meta.messageCount} messages, ${replay.redactionStats.secretsRedacted} secrets redacted`);
+    console.log(`  ▸ uploading to promptarc.dev...`);
+    // POST directly to hosted /api/upload with the bearer token.
+    const siteUrl = process.env.PROMPTARC_UPLOAD_ENDPOINT ?? 'https://promptarc.dev/api/upload';
+    const payload = JSON.stringify({
+        replay,
+        sourceSessionId: session.sessionId,
+        projectKey: projectId,
+        agentSource: projectId.startsWith('codex:') ? 'codex' : projectId.startsWith('cursor:') ? 'cursor' : 'claude-code',
+        visibility: 'private',
+        autoSync: false,
+        _h: '',
+    });
+    if (payload.length > 5 * 1024 * 1024) {
+        console.error(`  ✗ Session too large (${(payload.length / 1024 / 1024).toFixed(1)} MB). Max 5 MB.`);
+        process.exitCode = 1;
+        return;
+    }
+    try {
+        const res = await fetch(siteUrl, {
+            method: 'POST',
+            headers: {
+                'content-type': 'application/json',
+                authorization: `Bearer ${auth.token}`,
+            },
+            body: payload,
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            console.error(`  ✗ Upload failed: HTTP ${res.status}`);
+            console.error(`    ${text.slice(0, 200)}`);
+            process.exitCode = 1;
+            return;
+        }
+        const json = (await res.json());
+        if (json.status === 'unchanged') {
+            console.log(`  ✓ Already shared (unchanged).`);
+        }
+        else {
+            console.log(`  ✓ Shared.`);
+        }
+        if (json.url) {
+            console.log(`  ${json.url}`);
+        }
+    }
+    catch (err) {
+        console.error(`  ✗ Upload failed: ${String(err)}`);
         process.exitCode = 1;
         return;
     }
+    console.log('');
+}
+function findSessionByPrefix(prefix) {
+    const claudeRoot = join(homedir(), '.claude', 'projects');
+    try {
+        for (const dir of readdirSync(claudeRoot)) {
+            const projectDir = join(claudeRoot, dir);
+            if (!statSync(projectDir).isDirectory())
+                continue;
+            for (const file of readdirSync(projectDir)) {
+                if (file.startsWith(prefix) && file.endsWith('.jsonl')) {
+                    return {
+                        path: join(projectDir, file),
+                        sessionId: basename(file, '.jsonl'),
+                        projectId: dir,
+                    };
+                }
+            }
+        }
+    }
+    catch { /* no Claude projects */ }
+    // Cursor.
+    const cursorRoot = join(homedir(), '.cursor', 'projects');
+    try {
+        for (const dir of readdirSync(cursorRoot)) {
+            const transcriptsDir = join(cursorRoot, dir, 'agent-transcripts');
+            try {
+                for (const sd of readdirSync(transcriptsDir)) {
+                    if (sd.startsWith(prefix)) {
+                        const fp = join(transcriptsDir, sd, `${sd}.jsonl`);
+                        try {
+                            statSync(fp);
+                            return { path: fp, sessionId: sd, projectId: `cursor:${dir}` };
+                        }
+                        catch { /* skip */ }
+                    }
+                }
+            }
+            catch { /* no transcripts */ }
+        }
+    }
+    catch { /* no Cursor */ }
+    return null;
+}
+function fmtRelativeTime(ms) {
+    const diff = Date.now() - ms;
+    const mins = Math.floor(diff / 60_000);
+    if (mins < 1)
+        return 'just now';
+    if (mins < 60)
+        return `${mins}m ago`;
+    const hours = Math.floor(mins / 60);
+    if (hours < 24)
+        return `${hours}h ago`;
+    const days = Math.floor(hours / 24);
+    if (days === 1)
+        return 'yesterday';
+    if (days < 7)
+        return `${days}d ago`;
+    const weeks = Math.floor(days / 7);
+    if (weeks < 5)
+        return `${weeks}w ago`;
+    const months = Math.floor(days / 30);
+    return `${months}mo ago`;
+}
+function fmtNumber(n) {
+    return n.toLocaleString('en-US');
+}
+async function runPR(args) {
+    let auth = loadAuth();
+    if (!auth) {
+        console.log('  ▸ not signed in, starting login...');
+        auth = await runLogin();
+    }
     const shouldShare = args.includes('--share');
     const sessionIdArg = args.find((a) => !a.startsWith('--'));
     const copyFlag = args.includes('--copy');
@@ -206,27 +728,25 @@ async function runPR(args) {
     console.log('');
 }
 function findLatestSession(cwd) {
-    const fs = require('node:fs');
-    const path = require('node:path');
     const candidates = [];
     const cwdParts = cwd.split('/').filter(Boolean);
     const lastPart = cwdParts[cwdParts.length - 1] ?? '';
     const encoded = cwd.replace(/\//g, '-');
     // 1. Claude Code: ~/.claude/projects/<encoded-cwd>/*.jsonl
-    const claudeRoot = path.join(homedir(), '.claude', 'projects');
+    const claudeRoot = join(homedir(), '.claude', 'projects');
     try {
-        const dirs = fs.readdirSync(claudeRoot);
+        const dirs = readdirSync(claudeRoot);
         for (const dir of dirs) {
             if (dir === encoded || dir.endsWith(lastPart)) {
-                const projectDir = path.join(claudeRoot, dir);
-                if (!fs.statSync(projectDir).isDirectory())
+                const projectDir = join(claudeRoot, dir);
+                if (!statSync(projectDir).isDirectory())
                     continue;
-                const files = fs.readdirSync(projectDir).filter((f) => f.endsWith('.jsonl'));
+                const files = readdirSync(projectDir).filter((f) => f.endsWith('.jsonl'));
                 for (const f of files) {
-                    const fp = path.join(projectDir, f);
+                    const fp = join(projectDir, f);
                     candidates.push({
                         path: fp,
-                        sessionId: path.basename(f, '.jsonl'),
+                        sessionId: basename(f, '.jsonl'),
                         projectId: dir,
                     });
                 }
@@ -235,15 +755,15 @@ function findLatestSession(cwd) {
     }
     catch { /* no Claude sessions */ }
     // 2. Codex: ~/.codex/sessions/**/*.jsonl (scan all, match cwd from session_meta)
-    const codexRoot = path.join(homedir(), '.codex', 'sessions');
+    const codexRoot = join(homedir(), '.codex', 'sessions');
     try {
-        const codexFiles = findJsonlRecursive(codexRoot, fs, path);
+        const codexFiles = findJsonlRecursive(codexRoot);
         for (const fp of codexFiles) {
             // Quick check: read first line for cwd match.
             try {
-                const firstLine = fs.readFileSync(fp, 'utf8').split('\n')[0] ?? '';
+                const firstLine = readFileSync(fp, 'utf8').split('\n')[0] ?? '';
                 if (firstLine.includes(cwd) || firstLine.includes(lastPart)) {
-                    const name = path.basename(fp, '.jsonl');
+                    const name = basename(fp, '.jsonl');
                     const uuidMatch = name.match(/([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})/i);
                     candidates.push({
                         path: fp,
@@ -258,18 +778,18 @@ function findLatestSession(cwd) {
     catch { /* no Codex sessions */ }
     // 3. Cursor: ~/.cursor/projects/<encoded>/agent-transcripts/<uuid>/<uuid>.jsonl
     const cursorEncoded = cwd.replace(/\//g, '-').replace(/^-/, '');
-    const cursorRoot = path.join(homedir(), '.cursor', 'projects');
+    const cursorRoot = join(homedir(), '.cursor', 'projects');
     try {
-        const dirs = fs.readdirSync(cursorRoot);
+        const dirs = readdirSync(cursorRoot);
         for (const dir of dirs) {
             if (dir === cursorEncoded || dir.endsWith(lastPart)) {
-                const transcriptsDir = path.join(cursorRoot, dir, 'agent-transcripts');
+                const transcriptsDir = join(cursorRoot, dir, 'agent-transcripts');
                 try {
-                    const sessionDirs = fs.readdirSync(transcriptsDir);
+                    const sessionDirs = readdirSync(transcriptsDir);
                     for (const sd of sessionDirs) {
-                        const fp = path.join(transcriptsDir, sd, `${sd}.jsonl`);
+                        const fp = join(transcriptsDir, sd, `${sd}.jsonl`);
                         try {
-                            fs.statSync(fp);
+                            statSync(fp);
                             candidates.push({
                                 path: fp,
                                 sessionId: sd,
@@ -289,7 +809,7 @@ function findLatestSession(cwd) {
     // Return the most recently modified file.
     candidates.sort((a, b) => {
         try {
-            return fs.statSync(b.path).mtimeMs - fs.statSync(a.path).mtimeMs;
+            return statSync(b.path).mtimeMs - statSync(a.path).mtimeMs;
         }
         catch {
             return 0;
@@ -297,14 +817,14 @@ function findLatestSession(cwd) {
     });
     return candidates[0];
 }
-function findJsonlRecursive(dir, fs, path) {
+function findJsonlRecursive(dir) {
     const results = [];
     try {
-        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        const entries = readdirSync(dir, { withFileTypes: true });
         for (const entry of entries) {
-            const full = path.join(dir, entry.name);
+            const full = join(dir, entry.name);
             if (entry.isDirectory())
-                results.push(...findJsonlRecursive(full, fs, path));
+                results.push(...findJsonlRecursive(full));
             else if (entry.name.endsWith('.jsonl'))
                 results.push(full);
         }
@@ -313,15 +833,13 @@ function findJsonlRecursive(dir, fs, path) {
     return results;
 }
 function findSessionById(id) {
-    const fs = require('node:fs');
-    const path = require('node:path');
     // Search Claude Code.
-    const claudeRoot = path.join(homedir(), '.claude', 'projects');
+    const claudeRoot = join(homedir(), '.claude', 'projects');
     try {
-        for (const dir of fs.readdirSync(claudeRoot)) {
-            const fp = path.join(claudeRoot, dir, `${id}.jsonl`);
+        for (const dir of readdirSync(claudeRoot)) {
+            const fp = join(claudeRoot, dir, `${id}.jsonl`);
             try {
-                fs.statSync(fp);
+                statSync(fp);
                 return { path: fp, sessionId: id, projectId: dir };
             }
             catch { /* skip */ }
@@ -329,12 +847,12 @@ function findSessionById(id) {
     }
     catch { /* no Claude */ }
     // Search Cursor.
-    const cursorRoot = path.join(homedir(), '.cursor', 'projects');
+    const cursorRoot = join(homedir(), '.cursor', 'projects');
     try {
-        for (const dir of fs.readdirSync(cursorRoot)) {
-            const fp = path.join(cursorRoot, dir, 'agent-transcripts', id, `${id}.jsonl`);
+        for (const dir of readdirSync(cursorRoot)) {
+            const fp = join(cursorRoot, dir, 'agent-transcripts', id, `${id}.jsonl`);
             try {
-                fs.statSync(fp);
+                statSync(fp);
                 return { path: fp, sessionId: id, projectId: `cursor:${dir}` };
             }
             catch { /* skip */ }
@@ -342,8 +860,8 @@ function findSessionById(id) {
     }
     catch { /* no Cursor */ }
     // Search Codex (scan all, match by UUID in filename).
-    const codexRoot = path.join(homedir(), '.codex', 'sessions');
-    const codexFiles = findJsonlRecursive(codexRoot, fs, path);
+    const codexRoot = join(homedir(), '.codex', 'sessions');
+    const codexFiles = findJsonlRecursive(codexRoot);
     for (const fp of codexFiles) {
         if (fp.includes(id)) {
             return { path: fp, sessionId: id, projectId: null };
@@ -357,7 +875,6 @@ function findSessionById(id) {
  * names + file paths, and error outputs. Capped at 4K chars.
  */
 function extractLocalSummaryInput(filePath) {
-    const { readFileSync } = require('node:fs');
     const raw = readFileSync(filePath, 'utf8');
     const lines = raw.split('\n').filter(Boolean);
     const parts = [];
@@ -456,11 +973,10 @@ function extractLocalSummaryInput(filePath) {
     return parts.join('\n').slice(0, 4000);
 }
 async function runPull(slug) {
-    const auth = loadAuth();
+    let auth = loadAuth();
     if (!auth) {
-        console.error('Not signed in. Run `promptarc login` first.');
-        process.exitCode = 1;
-        return;
+        console.log('  ▸ not signed in, starting login...');
+        auth = await runLogin();
     }
     console.log(`promptarc pull ${slug}`);
     console.log('  ▸ downloading session...');