@secondcontext/btx-cli 0.0.1

package/dist/runtime-cli.js

@@ -0,0 +1,2088 @@
+// BTX CLI - self-contained script for managing BTX project data from coding agents.
+// Reads BTX_ACCESS_TOKEN, BTX_REFRESH_TOKEN, BTX_SUPABASE_URL, BTX_SUPABASE_ANON_KEY,
+// BTX_PROJECT_ID, BTX_API_URL, BTX_SESSION_ID, BTX_CLI_PATH from environment.
+import { randomUUID } from 'node:crypto';
+// ── Config ──────────────────────────────────────────────────────────────────
+let TOKEN = undefined;
+let REFRESH_TOKEN = '';
+let SUPABASE_URL = '';
+let SUPABASE_ANON_KEY = '';
+let PROJECT_ID = undefined;
+let API_URL = 'https://btx.secondcontext.com';
+let IS_DEV = false;
+let SESSION_ID = '';
+let CLI_COMMAND_HINT = 'btx';
+function configureRuntime(env = process.env) {
+    TOKEN = env.BTX_ACCESS_TOKEN;
+    REFRESH_TOKEN = env.BTX_REFRESH_TOKEN || '';
+    SUPABASE_URL = env.BTX_SUPABASE_URL || '';
+    SUPABASE_ANON_KEY = env.BTX_SUPABASE_ANON_KEY || '';
+    PROJECT_ID = env.BTX_PROJECT_ID;
+    API_URL = env.BTX_API_URL || 'https://btx.secondcontext.com';
+    IS_DEV = API_URL.includes('localhost') || API_URL.includes('127.0.0.1');
+    SESSION_ID = env.BTX_SESSION_ID || '';
+    CLI_COMMAND_HINT = env.BTX_CLI_COMMAND || (env.BTX_CLI_PATH ? 'node "$BTX_CLI_PATH"' : 'btx');
+}
+function die(msg) {
+    process.stderr.write(`Error: ${renderCliText(msg)}\n`);
+    process.exit(1);
+}
+function renderCliText(value) {
+    return value.replaceAll('node "$BTX_CLI_PATH"', CLI_COMMAND_HINT);
+}
+function taskDeepLink(taskId) {
+    const protocol = IS_DEV ? 'btx-dev' : 'btx';
+    return `${protocol}://navigate?panel=tasks&taskId=${taskId}`;
+}
+function contactDeepLink(contactId) {
+    const protocol = IS_DEV ? 'btx-dev' : 'btx';
+    return `${protocol}://navigate?panel=contacts&contactId=${contactId}`;
+}
+function orgDeepLink(orgId) {
+    const protocol = IS_DEV ? 'btx-dev' : 'btx';
+    return `${protocol}://navigate?panel=companies&orgId=${orgId}`;
+}
+function noteDeepLink(noteId) {
+    const protocol = IS_DEV ? 'btx-dev' : 'btx';
+    return `${protocol}://navigate?panel=notes&noteId=${noteId}`;
+}
+function meetingDeepLink(meetingId) {
+    const protocol = IS_DEV ? 'btx-dev' : 'btx';
+    return `${protocol}://navigate?panel=meetings&meetingId=${meetingId}`;
+}
+// Auth is checked inside main() so --help works without a session
+// ── HTTP client ─────────────────────────────────────────────────────────────
+async function refreshAccessToken() {
+    if (!REFRESH_TOKEN || !SUPABASE_URL || !SUPABASE_ANON_KEY)
+        return false;
+    try {
+        const res = await fetch(`${SUPABASE_URL}/auth/v1/token?grant_type=refresh_token`, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json', apikey: SUPABASE_ANON_KEY },
+            body: JSON.stringify({ refresh_token: REFRESH_TOKEN })
+        });
+        if (!res.ok)
+            return false;
+        const data = await res.json();
+        if (data.access_token) {
+            TOKEN = data.access_token;
+            return true;
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
+async function apiRequest(method, path, body) {
+    const url = `${API_URL}/api/projects/${PROJECT_ID}${path}`;
+    const opts = {
+        method,
+        headers: {
+            'content-type': 'application/json',
+            authorization: `Bearer ${TOKEN}`
+        }
+    };
+    if (body !== undefined)
+        opts.body = JSON.stringify(body);
+    return fetch(url, opts);
+}
+async function api(method, path, body) {
+    let res = await apiRequest(method, path, body);
+    // On 401, try refreshing the token once and retry
+    if (res.status === 401) {
+        const refreshed = await refreshAccessToken();
+        if (refreshed) {
+            res = await apiRequest(method, path, body);
+        }
+        if (res.status === 401) {
+            throw new Error('BTX auth token expired. Please start a new chat session.');
+        }
+    }
+    if (res.status === 429)
+        throw new Error('Rate limited. Please wait a moment and try again.');
+    const json = (await res.json());
+    if (!res.ok || !json.ok)
+        throw new Error(JSON.stringify(json.error) || `Request failed (${res.status})`);
+    return json.data;
+}
+// ── Arg parsing ─────────────────────────────────────────────────────────────
+function parseArgs(argv) {
+    const positional = [];
+    const flags = {};
+    let i = 0;
+    while (i < argv.length) {
+        const arg = argv[i];
+        if (arg.startsWith('--')) {
+            const key = arg.slice(2);
+            const next = argv[i + 1];
+            if (next !== undefined && !next.startsWith('--')) {
+                flags[key] = next;
+                i += 2;
+            }
+            else {
+                flags[key] = 'true';
+                i += 1;
+            }
+        }
+        else {
+            positional.push(arg);
+            i += 1;
+        }
+    }
+    return { positional, flags };
+}
+function isJson(flags) {
+    return flags.json === 'true';
+}
+function printJson(value) {
+    process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
+}
+// ── Formatting ──────────────────────────────────────────────────────────────
+function truncate(str, max) {
+    if (!str)
+        return '';
+    return str.length > max ? str.slice(0, max - 1) + '\u2026' : str;
+}
+function padRight(str, len) {
+    return (str || '').padEnd(len);
+}
+function taskPayload(t) {
+    return JSON.stringify({
+        id: t.id,
+        title: t.title,
+        status: t.status,
+        category: t.category,
+        priority: t.priority,
+        description: t.description || null
+    });
+}
+function formatTaskTable(tasks) {
+    if (tasks.length === 0) {
+        console.log('No tasks found.');
+        return;
+    }
+    const idW = 10;
+    const statusW = 12;
+    const prioW = 8;
+    const catW = 10;
+    console.log(`${padRight('ID', idW)}  ${padRight('Status', statusW)}  ${padRight('Priority', prioW)}  ${padRight('Category', catW)}  Title`);
+    console.log(`${'\u2500'.repeat(idW)}  ${'\u2500'.repeat(statusW)}  ${'\u2500'.repeat(prioW)}  ${'\u2500'.repeat(catW)}  ${'\u2500'.repeat(40)}`);
+    for (const t of tasks) {
+        const id = truncate(t.id, idW);
+        const title = truncate(t.title.replace(/\n/g, ' '), 50);
+        console.log(`${padRight(id, idW)}  ${padRight(t.status, statusW)}  ${padRight(t.priority, prioW)}  ${padRight(t.category, catW)}  ${title}`);
+    }
+    console.log(`\n${tasks.length} task${tasks.length !== 1 ? 's' : ''} found`);
+    for (const t of tasks) {
+        console.log(`BTX_TASK_JSON: ${taskPayload(t)}`);
+    }
+}
+function formatTaskDetail(t) {
+    console.log(`Task: ${t.title}`);
+    console.log(`ID:          ${t.id}`);
+    console.log(`Status:      ${t.status}`);
+    console.log(`Priority:    ${t.priority}`);
+    console.log(`Category:    ${t.category}`);
+    console.log(`Created:     ${new Date(t.detectedAt).toISOString().slice(0, 10)}`);
+    if (t.description) {
+        console.log(`\nDescription:\n  ${t.description.replace(/\n/g, '\n  ')}`);
+    }
+    if (t.plan) {
+        console.log(`\nPlan:\n  ${t.plan.replace(/\n/g, '\n  ')}`);
+    }
+    console.log(`\nBTX_TASK_JSON: ${taskPayload(t)}`);
+}
+// ── Contact / Lead formatters ────────────────────────────────────────────────
+function contactPayload(c) {
+    return JSON.stringify({
+        id: c.id,
+        name: c.name,
+        email: c.email || null,
+        company: c.company || null,
+        role: c.role || null,
+        stage: c.stage,
+        leadTypeId: c.leadTypeId || null,
+        notes: c.notes || null,
+        createdAt: c.createdAt ? new Date(c.createdAt).toISOString().slice(0, 10) : null
+    });
+}
+function formatContactTable(contacts, { showNote } = {}) {
+    if (contacts.length === 0) {
+        console.log('No contacts found.');
+        return;
+    }
+    const idW = 10;
+    const stageW = 12;
+    const dateW = 10;
+    const companyW = 16;
+    console.log(`${padRight('ID', idW)}  ${padRight('Added', dateW)}  ${padRight('Stage', stageW)}  ${padRight('Company', companyW)}  Name`);
+    console.log(`${'\u2500'.repeat(idW)}  ${'\u2500'.repeat(dateW)}  ${'\u2500'.repeat(stageW)}  ${'\u2500'.repeat(companyW)}  ${'\u2500'.repeat(30)}`);
+    for (const c of contacts) {
+        const id = truncate(c.id, idW);
+        const name = truncate(c.name, 40);
+        const company = truncate(c.company || '', companyW);
+        const added = c.createdAt ? new Date(c.createdAt).toISOString().slice(0, 10) : '';
+        console.log(`${padRight(id, idW)}  ${padRight(added, dateW)}  ${padRight(c.stage, stageW)}  ${padRight(company, companyW)}  ${name}`);
+    }
+    console.log(`\n${contacts.length} contact${contacts.length !== 1 ? 's' : ''} found (sorted newest first)`);
+    if (showNote)
+        console.log(showNote);
+    for (const c of contacts) {
+        console.log(`BTX_CONTACT_JSON: ${contactPayload(c)}`);
+    }
+}
+function formatContactDetail(c) {
+    console.log(`Contact: ${c.name}`);
+    console.log(`ID:             ${c.id}`);
+    console.log(`Stage:          ${c.stage}`);
+    if (c.email)
+        console.log(`Email:          ${c.email}`);
+    if (c.company)
+        console.log(`Company:        ${c.company}`);
+    if (c.role)
+        console.log(`Role:           ${c.role}`);
+    if (c.linkedinUrl)
+        console.log(`LinkedIn:       ${c.linkedinUrl}`);
+    if (c.leadTypeId)
+        console.log(`Lead Type ID:   ${c.leadTypeId}`);
+    if (c.relevanceScore != null)
+        console.log(`Relevance:      ${c.relevanceScore}`);
+    if (c.rankCategory)
+        console.log(`Rank:           ${c.rankCategory}`);
+    if (c.createdAt)
+        console.log(`Added:          ${new Date(c.createdAt).toISOString().slice(0, 10)}`);
+    if (c.whyMatch)
+        console.log(`\nWhy Match:\n  ${c.whyMatch.replace(/\n/g, '\n  ')}`);
+    if (c.outreachAngle)
+        console.log(`\nOutreach Angle:\n  ${c.outreachAngle.replace(/\n/g, '\n  ')}`);
+    if (c.notes)
+        console.log(`\nNotes:\n  ${c.notes.replace(/\n/g, '\n  ')}`);
+    console.log(`\nDeep link: ${contactDeepLink(c.id)}`);
+    console.log(`BTX_CONTACT_JSON: ${contactPayload(c)}`);
+}
+function formatLeadTypeTable(leads) {
+    if (leads.length === 0) {
+        console.log('No lead types found.');
+        return;
+    }
+    const idW = 10;
+    const catW = 12;
+    console.log(`${padRight('ID', idW)}  ${padRight('Category', catW)}  Title`);
+    console.log(`${'\u2500'.repeat(idW)}  ${'\u2500'.repeat(catW)}  ${'\u2500'.repeat(40)}`);
+    for (const lt of leads) {
+        const id = truncate(lt.id, idW);
+        const title = truncate(lt.title, 50);
+        console.log(`${padRight(id, idW)}  ${padRight(lt.category, catW)}  ${title}`);
+    }
+    console.log(`\n${leads.length} lead type${leads.length !== 1 ? 's' : ''} found`);
+}
+function formatLeadTypeDetail(lt) {
+    console.log(`Lead Type: ${lt.title}`);
+    console.log(`ID:          ${lt.id}`);
+    console.log(`Category:    ${lt.category}`);
+    if (lt.location)
+        console.log(`Location:    ${lt.location}`);
+    if (lt.description)
+        console.log(`\nDescription:\n  ${lt.description.replace(/\n/g, '\n  ')}`);
+    if (lt.searchDescription)
+        console.log(`\nSearch Description:\n  ${lt.searchDescription.replace(/\n/g, '\n  ')}`);
+}
+// ── Meeting formatters ──────────────────────────────────────────────────────
+function formatMeetingTable(meetings) {
+    if (meetings.length === 0) {
+        console.log('No meetings found.');
+        return;
+    }
+    const idW = 10;
+    const dateW = 12;
+    const sourceW = 10;
+    const attendeeW = 6;
+    console.log(`${padRight('ID', idW)}  ${padRight('Date', dateW)}  ${padRight('Source', sourceW)}  ${padRight('Ppl', attendeeW)}  Title`);
+    console.log(`${'\u2500'.repeat(idW)}  ${'\u2500'.repeat(dateW)}  ${'\u2500'.repeat(sourceW)}  ${'\u2500'.repeat(attendeeW)}  ${'\u2500'.repeat(40)}`);
+    for (const m of meetings) {
+        const id = truncate(m.id, idW);
+        const title = truncate(m.title, 50);
+        const date = m.meetingDate ? new Date(m.meetingDate).toISOString().slice(0, 10) : '';
+        const ppl = String((m.attendees || []).length);
+        console.log(`${padRight(id, idW)}  ${padRight(date, dateW)}  ${padRight(m.source || '', sourceW)}  ${padRight(ppl, attendeeW)}  ${title}`);
+    }
+    console.log(`\n${meetings.length} meeting${meetings.length !== 1 ? 's' : ''} found`);
+}
+function formatMeetingDetail(m) {
+    console.log(`Meeting: ${m.title}`);
+    console.log(`ID:          ${m.id}`);
+    if (m.meetingDate)
+        console.log(`Date:        ${new Date(m.meetingDate).toISOString().slice(0, 10)}`);
+    console.log(`Source:      ${m.source}`);
+    if (m.attendees && m.attendees.length) {
+        const names = m.attendees.map((a) => a.name + (a.email ? ` <${a.email}>` : '')).join(', ');
+        console.log(`Attendees:   ${names}`);
+    }
+    if (m.summary)
+        console.log(`\nSummary:\n  ${m.summary.replace(/\n/g, '\n  ')}`);
+    if (m.aiSummary)
+        console.log(`\nAI Summary:\n  ${m.aiSummary.replace(/\n/g, '\n  ')}`);
+    if (m.intel && m.intel.takeaways && m.intel.takeaways.length) {
+        console.log(`\nTakeaways:`);
+        for (const t of m.intel.takeaways)
+            console.log(`  - ${t}`);
+    }
+    if (m.actionItems && m.actionItems.length) {
+        console.log(`\nAction Items:`);
+        for (const a of m.actionItems)
+            console.log(`  - ${a}`);
+    }
+    if (m.keyPoints && m.keyPoints.length) {
+        console.log(`\nKey Points:`);
+        for (const k of m.keyPoints)
+            console.log(`  - ${k}`);
+    }
+    console.log(`\nDeep link: ${meetingDeepLink(m.id)}`);
+}
+function formatMeetingTranscript(m) {
+    if (!m.transcript || m.transcript.length === 0) {
+        console.log('No transcript available for this meeting.');
+        return;
+    }
+    console.log(`Transcript: ${m.title}`);
+    if (m.meetingDate)
+        console.log(`Date: ${new Date(m.meetingDate).toISOString().slice(0, 10)}`);
+    console.log(`Segments: ${m.transcript.length}`);
+    console.log('');
+    for (const seg of m.transcript) {
+        const speaker = seg.speaker && seg.speaker.source === 'speaker' ? 'You' : 'Other';
+        const time = seg.start_time || '';
+        console.log(`[${time}] ${speaker}: ${seg.text}`);
+    }
+}
+// ── Help ─────────────────────────────────────────────────────────────────────
+const HELP = {
+    top: `BTX CLI - manage tasks, contacts, meetings, and leads from a session.
+
+Usage:
+  node "$BTX_CLI_PATH" <resource> <command> [flags]
+  node "$BTX_CLI_PATH" <resource> --help
+
+Resources:
+  tasks        Create and manage project tasks
+  sessions     Add and list notes for a session
+  contacts     View and update contacts, add notes
+  orgs         View organizations, add notes
+  meetings     View meeting recordings and transcripts
+  leads        List lead types
+  user         Manage your profile notes
+  intro-paths  Find warm intro paths in your network
+  search       Search tasks by keyword
+  context      Fetch the current project business context
+  pages        Create and list project note pages
+
+Examples:
+  node "$BTX_CLI_PATH" tasks list --status todo
+  node "$BTX_CLI_PATH" tasks list --json
+  node "$BTX_CLI_PATH" meetings list --days 7
+  node "$BTX_CLI_PATH" meetings get <meeting-id> --transcript
+  node "$BTX_CLI_PATH" contacts --help
+
+All resource commands support --json for machine-readable output.`,
+    tasks: `BTX tasks - create and manage project tasks.
+
+Commands:
+  list       List tasks (filterable)
+  get        Get full details for a task
+  create     Create a new task
+  update     Update task fields
+  complete   Mark a task as done
+  notes list <task-id>                  List notes for a task
+  notes add  <task-id> --content "..."  Add a note to a task
+
+Flags:
+  tasks list    [--status todo|in_progress|done|dismissed] [--category code|marketing|sales|customer|product|ops] [--query "text"]
+  tasks get     <task-id>
+  tasks create  --title "..." --description "..." --category <cat> [--priority high|medium|low]
+  tasks update  <task-id> [--title "..."] [--description "..."] [--status <status>] [--priority <p>] [--category <cat>] [--plan "markdown"]
+  tasks complete <task-id>
+  tasks notes list <task-id>
+  tasks notes add  <task-id> --content "Label: value" [--source "https://..."]
+
+Examples:
+  node "$BTX_CLI_PATH" tasks list
+  node "$BTX_CLI_PATH" tasks list --status todo
+  node "$BTX_CLI_PATH" tasks list --query "auth" --status in_progress
+  node "$BTX_CLI_PATH" tasks get abc123
+  node "$BTX_CLI_PATH" tasks create --title "Fix login bug" --description "Users can't log in with SSO" --category code
+  node "$BTX_CLI_PATH" tasks create --title "Write onboarding email" --description "..." --category marketing --priority high
+  node "$BTX_CLI_PATH" tasks update abc123 --status in_progress
+  node "$BTX_CLI_PATH" tasks update abc123 --plan "1. Read auth.ts\\n2. Fix token refresh"
+  node "$BTX_CLI_PATH" tasks complete abc123
+  node "$BTX_CLI_PATH" tasks notes list abc123
+  node "$BTX_CLI_PATH" tasks notes add abc123 --content "Insight: ICP may be wrong on stage" --source "https://..."`,
+    sessions: `BTX sessions - add and list notes for a session.
+
+Commands:
+  notes list <session-id>                  List notes for a session
+  notes add  <session-id> --content "..."  Add a note to a session
+
+Flags:
+  sessions notes add  <session-id> --content "Label: value" [--source "https://..."]
+
+Examples:
+  node "$BTX_CLI_PATH" sessions notes list abc-session-id
+  node "$BTX_CLI_PATH" sessions notes add abc-session-id --content "Insight: market timing is critical"
+  node "$BTX_CLI_PATH" sessions notes add abc-session-id --content "Decision: pivot to enterprise" --source "https://..."`,
+    contacts: `BTX contacts - create, view and update contacts, add research notes.
+
+Commands:
+  create      Create a new contact
+  list        List contacts (filterable)
+  get         Get full details for a contact
+  update      Update contact fields
+  notes list  List notes for a contact
+  notes add   Add a note to a contact
+
+Flags:
+  contacts create  --name "..." [--email "..."] [--company "..."] [--role "..."] [--linkedin "..."] [--stage lead|contacted|replied|scheduled|interviewed|converted|lost] [--notes "..."] [--outreach-angle "..."]
+  contacts list    [--stage lead|contacted|replied|scheduled|interviewed|converted|lost] [--query "text"] [--limit <n>]
+  contacts get     <contact-id>
+  contacts update  <contact-id> [--stage <stage>] [--email "..."] [--company "..."] [--role "..."] [--notes "..."] [--outreach-angle "..."]
+  contacts notes list  <contact-id>
+  contacts notes add   <contact-id> --content "Label: value" [--source "https://..."]
+
+Examples:
+  node "$BTX_CLI_PATH" contacts create --name "Jane Smith" --company "Acme Corp" --role "CTO" --email "jane@acme.com"
+  node "$BTX_CLI_PATH" contacts list
+  node "$BTX_CLI_PATH" contacts list --stage lead --limit 20
+  node "$BTX_CLI_PATH" contacts list --query "acme"
+  node "$BTX_CLI_PATH" contacts get abc123
+  node "$BTX_CLI_PATH" contacts update abc123 --stage contacted
+  node "$BTX_CLI_PATH" contacts notes list abc123
+  node "$BTX_CLI_PATH" contacts notes add abc123 --content "Role: VP Engineering" --source "https://linkedin.com/..."
+  node "$BTX_CLI_PATH" contacts notes add abc123 --content "Stack: Python, AWS, Postgres" --source "https://their-blog.com"`,
+    orgs: `BTX orgs - create, view organizations and add company-level notes.
+
+Commands:
+  create      Create a new organization
+  list        List organizations
+  get         Get full details for an organization
+  notes list  List notes for an organization
+  notes add   Add a note to an organization
+
+Flags:
+  orgs create  --name "..." [--type company|partner|competitor|investor|other] [--website "..."] [--stage "..."]
+  orgs list    [--type <type>]
+  orgs get     <org-id>
+  orgs notes list  <org-id>
+  orgs notes add   <org-id> --content "Label: value" [--source "https://..."]
+
+Examples:
+  node "$BTX_CLI_PATH" orgs create --name "Acme Corp" --type company --website "https://acme.com"
+  node "$BTX_CLI_PATH" orgs list
+  node "$BTX_CLI_PATH" orgs get abc123
+  node "$BTX_CLI_PATH" orgs notes list abc123
+  node "$BTX_CLI_PATH" orgs notes add abc123 --content "Funding: Series B, $45M (2024)" --source "https://techcrunch.com/..."
+  node "$BTX_CLI_PATH" orgs notes add abc123 --content "Size: ~1,100 employees, 21 offices"`,
+    leads: `BTX leads - list and inspect lead types.
+
+Commands:
+  list  List all lead types
+  get   Get full details for a lead type
+
+Examples:
+  node "$BTX_CLI_PATH" leads list
+  node "$BTX_CLI_PATH" leads get abc123`,
+    user: `BTX user - manage your profile notes (facts about you, not contacts).
+
+Commands:
+  notes list  List your profile notes
+  notes add   Add a profile note
+
+Flags:
+  user notes add  --content "Label: value" [--source "https://..."]
+
+Examples:
+  node "$BTX_CLI_PATH" user notes list
+  node "$BTX_CLI_PATH" user notes add --content "Location: San Francisco, CA"
+  node "$BTX_CLI_PATH" user notes add --content "Network: YC W22 alumni, South Park Commons member"
+  node "$BTX_CLI_PATH" user notes add --content "Expertise: Enterprise SaaS, API design, Go/React"`,
+    'intro-paths': `BTX intro-paths - find warm intro paths to a person via your network.
+
+Commands:
+  find  Search for intro paths to a contact or person
+
+Flags:
+  intro-paths find  --contact-id <id>
+  intro-paths find  --name "Person Name" [--company "Company"] [--role "Role"]
+
+Examples:
+  node "$BTX_CLI_PATH" intro-paths find --contact-id abc123
+  node "$BTX_CLI_PATH" intro-paths find --name "Jane Smith" --company "Acme Corp"
+  node "$BTX_CLI_PATH" intro-paths find --name "Jane Smith" --company "Acme Corp" --role "VP Sales"`,
+    search: `BTX search - search tasks by keyword.
+
+Flags:
+  search --query "text" [--status todo|in_progress|done|dismissed]
+
+Examples:
+  node "$BTX_CLI_PATH" search --query "auth"
+  node "$BTX_CLI_PATH" search --query "onboarding" --status todo`,
+    meetings: `BTX meetings - view meeting recordings and transcripts.
+
+Commands:
+  list         List meetings (filterable by date range)
+  get          Get meeting details (summary, attendees, takeaways)
+  transcript   Get the full transcript for a meeting
+
+Flags:
+  meetings list        [--days <n>] [--query "text"]
+  meetings get         <meeting-id>
+  meetings transcript  <meeting-id>
+
+The --days flag filters to meetings from the last N days (default: all).
+Use "list" to browse recent meetings, "get" for summaries and takeaways,
+and "transcript" for the full conversation text.
+
+Examples:
+  node "$BTX_CLI_PATH" meetings list
+  node "$BTX_CLI_PATH" meetings list --days 7
+  node "$BTX_CLI_PATH" meetings list --query "onboarding"
+  node "$BTX_CLI_PATH" meetings get abc123
+  node "$BTX_CLI_PATH" meetings transcript abc123`,
+    context: `BTX context - fetch the current project business context.
+
+Commands:
+  get  Print the project's business context
+
+Examples:
+  node "$BTX_CLI_PATH" context get`,
+    pages: `BTX pages - create, update, and list project note pages.
+
+Commands:
+  create  Create a new note page
+  update  Update an existing note page
+  list    List all note pages
+  get     Get a specific note page by ID
+
+Flags:
+  pages create  --title "..." [--body "markdown content"]
+  pages update  <note-id> [--title "..."] [--body "markdown content"]
+  pages list
+  pages get     <note-id>
+
+Body format:
+  The --body flag accepts markdown: # headings, ## subheadings, - bullet lists,
+  **bold**, *italic*, and regular paragraphs. Content is converted to rich text.
+
+Examples:
+  node "$BTX_CLI_PATH" pages create --title "Session summary" --body "## What changed\\n- Refactored auth\\n- Added tests"
+  node "$BTX_CLI_PATH" pages update abc123 --body "## Updated notes\\n- Fixed edge case"
+  node "$BTX_CLI_PATH" pages list
+  node "$BTX_CLI_PATH" pages get abc123`
+};
+// ── Commands ────────────────────────────────────────────────────────────────
+async function fetchTasks() {
+    const result = await api('GET', '/tasks');
+    return result?.tasks ?? [];
+}
+async function tasksList(flags) {
+    let tasks = await fetchTasks();
+    if (flags.status) {
+        tasks = tasks.filter((t) => t.status === flags.status);
+    }
+    if (flags.category) {
+        tasks = tasks.filter((t) => t.category === flags.category);
+    }
+    if (flags.query) {
+        const q = flags.query.toLowerCase();
+        tasks = tasks.filter((t) => t.title.toLowerCase().includes(q) ||
+            (t.description && t.description.toLowerCase().includes(q)));
+    }
+    if (isJson(flags)) {
+        printJson(tasks);
+        return;
+    }
+    formatTaskTable(tasks);
+}
+async function tasksGet(id, flags) {
+    if (!id)
+        die('Usage: btx tasks get <task-id>');
+    const tasks = await fetchTasks();
+    const task = tasks.find((t) => t.id === id);
+    if (!task)
+        die(`Task not found: ${id}`);
+    if (isJson(flags)) {
+        printJson(task);
+        return;
+    }
+    formatTaskDetail(task);
+}
+async function tasksCreate(flags) {
+    if (!flags.title)
+        die('--title is required');
+    if (!flags.description)
+        die('--description is required');
+    if (!flags.category)
+        die('--category is required');
+    const validCategories = ['code', 'marketing', 'sales', 'customer', 'product', 'ops'];
+    if (!validCategories.includes(flags.category)) {
+        die(`Invalid category: ${flags.category}. Must be one of: ${validCategories.join(', ')}`);
+    }
+    const validPriorities = ['high', 'medium', 'low'];
+    const priority = flags.priority || 'medium';
+    if (!validPriorities.includes(priority)) {
+        die(`Invalid priority: ${priority}. Must be one of: ${validPriorities.join(', ')}`);
+    }
+    const task = {
+        id: randomUUID(),
+        title: flags.title,
+        description: flags.description,
+        category: flags.category,
+        priority,
+        status: 'todo',
+        actionType: 'info',
+        detectedAt: Date.now()
+    };
+    await api('PATCH', '/tasks', task);
+    // Log task_created activity
+    if (SESSION_ID) {
+        try {
+            await api('POST', '/task-activities', {
+                taskLocalId: task.id,
+                type: 'status_changed',
+                metadata: { from_status: undefined, to_status: 'todo', btx_session_id: SESSION_ID }
+            });
+        }
+        catch {
+            // Non-fatal
+        }
+    }
+    if (isJson(flags)) {
+        printJson({ task, deepLink: taskDeepLink(task.id) });
+        return;
+    }
+    console.log(`Task created successfully.`);
+    console.log(`ID: ${task.id}`);
+    console.log(`Title: ${task.title}`);
+    console.log(`Deep link: ${taskDeepLink(task.id)}`);
+    console.log(`BTX_TASK_JSON: ${taskPayload(task)}`);
+}
+async function tasksUpdate(id, flags) {
+    if (!id)
+        die('Usage: btx tasks update <task-id> [--field value ...]');
+    const tasks = await fetchTasks();
+    const existing = tasks.find((t) => t.id === id);
+    if (!existing)
+        die(`Task not found: ${id}`);
+    const validStatuses = ['todo', 'in_progress', 'done', 'dismissed'];
+    const validPriorities = ['high', 'medium', 'low'];
+    const validCategories = ['code', 'marketing', 'sales', 'customer', 'product', 'ops'];
+    if (flags.status && !validStatuses.includes(flags.status)) {
+        die(`Invalid status: ${flags.status}. Must be one of: ${validStatuses.join(', ')}`);
+    }
+    if (flags.priority && !validPriorities.includes(flags.priority)) {
+        die(`Invalid priority: ${flags.priority}. Must be one of: ${validPriorities.join(', ')}`);
+    }
+    if (flags.category && !validCategories.includes(flags.category)) {
+        die(`Invalid category: ${flags.category}. Must be one of: ${validCategories.join(', ')}`);
+    }
+    const updatable = ['title', 'description', 'status', 'priority', 'category', 'plan'];
+    const changed = [];
+    for (const key of updatable) {
+        if (flags[key] !== undefined) {
+            existing[key] = flags[key];
+            changed.push(key);
+        }
+    }
+    if (changed.length === 0)
+        die('No fields to update. Use --title, --description, --status, --priority, --category, or --plan.');
+    await api('PATCH', '/tasks', existing);
+    // Log status change activity
+    if (flags.status) {
+        try {
+            await api('POST', '/task-activities', {
+                taskLocalId: id,
+                type: 'status_changed',
+                metadata: {
+                    from_status: tasks.find((t) => t.id === id)?.status,
+                    to_status: flags.status,
+                    btx_session_id: SESSION_ID || undefined
+                }
+            });
+        }
+        catch {
+            // Non-fatal
+        }
+    }
+    // Log plan activity
+    if (flags.plan) {
+        try {
+            await api('POST', '/task-activities', {
+                taskLocalId: id,
+                type: 'plan_generated',
+                content: flags.plan,
+                metadata: { btx_session_id: SESSION_ID || undefined }
+            });
+        }
+        catch {
+            // Non-fatal
+        }
+    }
+    if (isJson(flags)) {
+        printJson({ task: existing, updatedFields: changed, deepLink: taskDeepLink(id) });
+        return;
+    }
+    console.log(`Task updated successfully.`);
+    console.log(`Updated fields: ${changed.join(', ')}`);
+    console.log(`Deep link: ${taskDeepLink(id)}`);
+    console.log(`BTX_TASK_JSON: ${taskPayload(existing)}`);
+}
+async function tasksComplete(id, flags) {
+    if (!id)
+        throw new Error('Usage: btx tasks complete <task-id>');
+    const tasks = await fetchTasks();
+    const existing = tasks.find((t) => t.id === id);
+    if (!existing)
+        throw new Error(`Task not found: ${id}`);
+    existing.status = 'done';
+    await api('PATCH', '/tasks', existing);
+    // Log plan_executed activity
+    try {
+        await api('POST', '/task-activities', {
+            taskLocalId: id,
+            type: 'plan_executed',
+            metadata: { btx_session_id: SESSION_ID || undefined }
+        });
+    }
+    catch {
+        // Non-fatal
+    }
+    if (isJson(flags)) {
+        printJson({ task: existing, deepLink: taskDeepLink(id) });
+        return;
+    }
+    console.log(`Task completed.`);
+    console.log(`Deep link: ${taskDeepLink(id)}`);
+    console.log(`BTX_TASK_JSON: ${taskPayload(existing)}`);
+}
+// ── Organizations commands ────────────────────────────────────────────────────
+async function fetchOrganizations(type) {
+    const path = type ? `/organizations?type=${type}` : '/organizations';
+    const result = await api('GET', path);
+    return result?.organizations ?? [];
+}
+async function orgsList(flags) {
+    const type = flags.type || null;
+    const orgs = await fetchOrganizations(type);
+    if (isJson(flags)) {
+        printJson(orgs);
+        return;
+    }
+    if (orgs.length === 0) {
+        console.log('No organizations found.');
+        return;
+    }
+    console.log(`\n${orgs.length} organization${orgs.length !== 1 ? 's' : ''} found:\n`);
+    for (const o of orgs) {
+        const meta = o.metadata || {};
+        console.log(`  ${o.name}`);
+        console.log(`    ID: ${o.id}`);
+        console.log(`    Type: ${o.type} | Stage: ${o.stage}`);
+        if (o.website)
+            console.log(`    Website: ${o.website}`);
+        if (meta.industry)
+            console.log(`    Industry: ${meta.industry}`);
+        if (meta.hq)
+            console.log(`    HQ: ${meta.hq}`);
+        console.log(`    ${orgDeepLink(o.id)}`);
+        console.log();
+    }
+}
+async function orgsGet(id) {
+    if (!id)
+        die('Usage: btx orgs get <org-id>');
+    const orgs = await fetchOrganizations();
+    const org = orgs.find((o) => o.id === id);
+    if (!org)
+        die(`Organization ${id} not found`);
+    console.log(JSON.stringify(org, null, 2));
+}
+async function orgNotesAdd(orgId, flags) {
+    if (!orgId)
+        die('Usage: btx orgs notes add <org-id> --content "..."');
+    const content = flags.content;
+    if (!content)
+        die('--content is required');
+    const metadata = {};
+    if (flags.source)
+        metadata.source_url = flags.source;
+    const result = await api('POST', '/organization-activities', {
+        orgId,
+        type: 'note',
+        content,
+        metadata
+    });
+    if (isJson(flags)) {
+        printJson({ id: result?.id ?? null, orgId, content, metadata, deepLink: orgDeepLink(orgId) });
+        return;
+    }
+    console.log(`Note saved for organization ${orgId}`);
+    if (result?.id)
+        console.log(`  Activity ID: ${result.id}`);
+    console.log(`  ${orgDeepLink(orgId)}`);
+}
+async function orgsCreate(flags) {
+    if (!flags.name)
+        die('--name is required');
+    const validTypes = ['company', 'partner', 'competitor', 'investor', 'other'];
+    const type = flags.type || 'company';
+    if (!validTypes.includes(type)) {
+        die(`Invalid type: ${type}. Must be one of: ${validTypes.join(', ')}`);
+    }
+    const org = {
+        id: randomUUID(),
+        name: flags.name,
+        type,
+        stage: flags.stage || 'active',
+        website: flags.website || null,
+        metadata: {},
+    };
+    await api('POST', '/organizations', org);
+    if (isJson(flags)) {
+        printJson({ organization: org, deepLink: orgDeepLink(org.id) });
+        return;
+    }
+    console.log(`Organization created successfully.`);
+    console.log(`ID: ${org.id}`);
+    console.log(`Name: ${org.name}`);
+    console.log(`Type: ${org.type}`);
+    console.log(`Deep link: ${orgDeepLink(org.id)}`);
+}
+async function orgNotesList(orgId, flags) {
+    if (!orgId)
+        die('Usage: btx orgs notes list <org-id>');
+    const activities = await api('GET', `/organization-activities?orgId=${orgId}&limit=100`);
+    const notes = (activities ?? []).filter((a) => a.type === 'note');
+    if (isJson(flags)) {
+        printJson(notes);
+        return;
+    }
+    if (notes.length === 0) {
+        console.log(`No notes found for organization ${orgId}.`);
+        return;
+    }
+    console.log(`\n${notes.length} note${notes.length !== 1 ? 's' : ''} for organization ${orgId}:\n`);
+    for (const n of notes) {
+        const source = n.metadata?.source_url ? ` [${n.metadata.source_url}]` : '';
+        console.log(`  ${n.content}${source}`);
+    }
+    console.log();
+}
+// ── Contacts commands ─────────────────────────────────────────────────────────
+async function fetchContacts() {
+    const result = await api('GET', '/contacts');
+    return result?.contacts ?? [];
+}
+async function contactsList(flags) {
+    let contacts = await fetchContacts();
+    if (flags.stage) {
+        contacts = contacts.filter((c) => c.stage === flags.stage);
+    }
+    if (flags['lead-type']) {
+        contacts = contacts.filter((c) => c.leadTypeId === flags['lead-type']);
+    }
+    if (flags.query) {
+        const q = flags.query.toLowerCase();
+        contacts = contacts.filter((c) => (c.name || '').toLowerCase().includes(q) ||
+            (c.company || '').toLowerCase().includes(q) ||
+            (c.role || '').toLowerCase().includes(q) ||
+            (c.notes || '').toLowerCase().includes(q));
+    }
+    const total = contacts.length;
+    const limit = flags.limit ? parseInt(flags.limit, 10) : null;
+    if (limit && limit > 0)
+        contacts = contacts.slice(0, limit);
+    if (isJson(flags)) {
+        printJson(contacts);
+        return;
+    }
+    const note = limit && total > limit ? `Showing ${limit} of ${total} (use --limit to adjust)` : null;
+    formatContactTable(contacts, { showNote: note });
+}
+async function contactsGet(id, flags) {
+    if (!id)
+        die('Usage: btx contacts get <contact-id>');
+    const contacts = await fetchContacts();
+    const contact = contacts.find((c) => c.id === id);
+    if (!contact)
+        die(`Contact not found: ${id}`);
+    if (isJson(flags)) {
+        printJson(contact);
+        return;
+    }
+    formatContactDetail(contact);
+}
+async function contactsUpdate(id, flags) {
+    if (!id)
+        die('Usage: btx contacts update <contact-id> [--field value ...]');
+    const contacts = await fetchContacts();
+    const existing = contacts.find((c) => c.id === id);
+    if (!existing)
+        die(`Contact not found: ${id}`);
+    const validStages = [
+        'lead',
+        'contacted',
+        'replied',
+        'scheduled',
+        'interviewed',
+        'converted',
+        'lost'
+    ];
+    if (flags.stage && !validStages.includes(flags.stage)) {
+        die(`Invalid stage: ${flags.stage}. Must be one of: ${validStages.join(', ')}`);
+    }
+    const updatable = ['stage', 'notes', 'outreach-angle', 'email', 'company', 'role'];
+    const changed = [];
+    if (flags.stage !== undefined) {
+        existing.stage = flags.stage;
+        changed.push('stage');
+    }
+    if (flags.notes !== undefined) {
+        existing.notes = flags.notes;
+        changed.push('notes');
+    }
+    if (flags['outreach-angle'] !== undefined) {
+        existing.outreachAngle = flags['outreach-angle'];
+        changed.push('outreachAngle');
+    }
+    if (flags.email !== undefined) {
+        existing.email = flags.email;
+        changed.push('email');
+    }
+    if (flags.company !== undefined) {
+        existing.company = flags.company;
+        changed.push('company');
+    }
+    if (flags.role !== undefined) {
+        existing.role = flags.role;
+        changed.push('role');
+    }
+    if (changed.length === 0)
+        die(`No fields to update. Use: ${updatable.map((f) => '--' + f).join(', ')}`);
+    await api('POST', '/contacts', existing);
+    if (isJson(flags)) {
+        printJson({ contact: existing, updatedFields: changed, deepLink: contactDeepLink(existing.id) });
+        return;
+    }
+    console.log(`Contact updated successfully.`);
+    console.log(`Updated fields: ${changed.join(', ')}`);
+    console.log(`Deep link: ${contactDeepLink(existing.id)}`);
+    console.log(`BTX_CONTACT_JSON: ${contactPayload(existing)}`);
+}
+async function contactsCreate(flags) {
+    if (!flags.name)
+        die('--name is required');
+    const contact = {
+        id: randomUUID(),
+        name: flags.name,
+        stage: flags.stage || 'lead',
+        email: flags.email || null,
+        company: flags.company || null,
+        role: flags.role || null,
+        linkedinUrl: flags.linkedin || null,
+        notes: flags.notes || null,
+        outreachAngle: flags['outreach-angle'] || null,
+    };
+    await api('POST', '/contacts', contact);
+    if (isJson(flags)) {
+        printJson({ contact, deepLink: contactDeepLink(contact.id) });
+        return;
+    }
+    console.log(`Contact created successfully.`);
+    console.log(`ID: ${contact.id}`);
+    console.log(`Name: ${contact.name}`);
+    console.log(`Deep link: ${contactDeepLink(contact.id)}`);
+    console.log(`BTX_CONTACT_JSON: ${contactPayload(contact)}`);
+}
+// ── Contact notes commands ────────────────────────────────────────────────────
+function noteSimilarity(a, b) {
+    // Rough word-overlap ratio. Good enough to catch near-duplicates.
+    const words = (s) => new Set(s
+        .toLowerCase()
+        .replace(/[^a-z0-9\s]/g, '')
+        .split(/\s+/)
+        .filter(Boolean));
+    const wa = words(a);
+    const wb = words(b);
+    if (wa.size === 0 || wb.size === 0)
+        return 0;
+    let overlap = 0;
+    for (const w of wa)
+        if (wb.has(w))
+            overlap++;
+    return overlap / Math.min(wa.size, wb.size);
+}
+function isNoteActivity(activity) {
+    return (activity.type === 'note' && typeof activity.content === 'string' && activity.content.length > 0);
+}
+function activityDate(activity) {
+    return new Date(activity.createdAt ?? Date.now()).toISOString().slice(0, 10);
+}
+async function contactNotesAdd(contactId, flags) {
+    if (!contactId)
+        die('Usage: btx contacts notes add <contact-id> --content "..."');
+    if (!flags.content)
+        die('--content is required');
+    // Dedup check. Fetch existing notes and warn if very similar content already exists.
+    try {
+        const existing = await api('GET', `/contact-activities?contactId=${contactId}&limit=50`);
+        const notes = (Array.isArray(existing) ? existing : []).filter(isNoteActivity);
+        for (const n of notes) {
+            if (noteSimilarity(flags.content, n.content) >= 0.7) {
+                const date = activityDate(n);
+                console.log(`Skipped. Similar note already exists (${date}): ${n.content}`);
+                return;
+            }
+        }
+    }
+    catch {
+        // Non-fatal. Proceed with save.
+    }
+    const metadata = { btx_session_id: SESSION_ID || undefined };
+    if (flags.source)
+        metadata.source_url = flags.source;
+    const data = await api('POST', '/contact-activities', {
+        contactId,
+        type: 'note',
+        content: flags.content,
+        metadata
+    });
+    if (isJson(flags)) {
+        printJson({ id: data.id ?? null, contactId, content: flags.content, metadata });
+        return;
+    }
+    console.log(`Note saved.`);
+    console.log(`Contact: ${contactId}`);
+    console.log(`Deep link: ${contactDeepLink(contactId)}`);
+    console.log(`BTX_CONTACT_NOTE_JSON: ${JSON.stringify({ id: data.id, contactId, content: flags.content })}`);
+}
+async function contactNotesList(contactId, flags) {
+    if (!contactId)
+        die('Usage: btx contacts notes list <contact-id>');
+    const result = await api('GET', `/contact-activities?contactId=${contactId}&limit=50`);
+    const notes = (Array.isArray(result) ? result : []).filter(isNoteActivity);
+    if (isJson(flags)) {
+        printJson(notes);
+        return;
+    }
+    if (notes.length === 0) {
+        console.log('No notes yet for this contact.');
+        return;
+    }
+    console.log(`${notes.length} note${notes.length !== 1 ? 's' : ''} for contact ${contactId}:\n`);
+    for (const n of notes) {
+        const date = activityDate(n);
+        console.log(`[${date}] ${n.content}`);
+        console.log();
+    }
+}
+// ── Task notes commands ──────────────────────────────────────────────────────
+async function taskNotesAdd(taskId, flags) {
+    if (!taskId)
+        die('Usage: btx tasks notes add <task-id> --content "..."');
+    if (!flags.content)
+        die('--content is required');
+    // Dedup check. Fetch existing notes and warn if very similar content already exists.
+    try {
+        const existing = await api('GET', `/task-activities?taskLocalId=${taskId}&limit=50`);
+        const notes = (Array.isArray(existing) ? existing : []).filter(isNoteActivity);
+        for (const n of notes) {
+            if (noteSimilarity(flags.content, n.content) >= 0.7) {
+                const date = activityDate(n);
+                console.log(`Skipped. Similar note already exists (${date}): ${n.content}`);
+                return;
+            }
+        }
+    }
+    catch {
+        // Non-fatal. Proceed with save.
+    }
+    const metadata = { btx_session_id: SESSION_ID || undefined };
+    if (flags.source)
+        metadata.source_url = flags.source;
+    const data = await api('POST', '/task-activities', {
+        taskLocalId: taskId,
+        type: 'note',
+        content: flags.content,
+        metadata
+    });
+    if (isJson(flags)) {
+        printJson({ id: data.id ?? null, taskLocalId: taskId, content: flags.content, metadata });
+        return;
+    }
+    console.log(`Note saved.`);
+    console.log(`Task: ${taskId}`);
+    console.log(`Deep link: btx://navigate?panel=tasks&taskId=${taskId}`);
+    console.log(`BTX_TASK_NOTE_JSON: ${JSON.stringify({ id: data.id, taskLocalId: taskId, content: flags.content })}`);
+}
+async function taskNotesList(taskId, flags) {
+    if (!taskId)
+        die('Usage: btx tasks notes list <task-id>');
+    const result = await api('GET', `/task-activities?taskLocalId=${taskId}&limit=50`);
+    const notes = (Array.isArray(result) ? result : []).filter(isNoteActivity);
+    if (isJson(flags)) {
+        printJson(notes);
+        return;
+    }
+    if (notes.length === 0) {
+        console.log('No notes yet for this task.');
+        return;
+    }
+    console.log(`${notes.length} note${notes.length !== 1 ? 's' : ''} for task ${taskId}:\n`);
+    for (const n of notes) {
+        const date = activityDate(n);
+        console.log(`[${date}] ${n.content}`);
+        console.log();
+    }
+}
+// ── Session notes commands ────────────────────────────────────────────────────
+async function sessionNotesAdd(sessionId, flags) {
+    if (!sessionId)
+        die('Usage: btx sessions notes add <session-id> --content "..."');
+    if (!flags.content)
+        die('--content is required');
+    // Dedup check. Fetch existing notes and warn if very similar content already exists.
+    try {
+        const existing = await api('GET', `/session-activities?sessionId=${sessionId}&limit=50`);
+        const notes = (Array.isArray(existing) ? existing : []).filter(isNoteActivity);
+        for (const n of notes) {
+            if (noteSimilarity(flags.content, n.content) >= 0.7) {
+                const date = activityDate(n);
+                console.log(`Skipped. Similar note already exists (${date}): ${n.content}`);
+                return;
+            }
+        }
+    }
+    catch {
+        // Non-fatal. Proceed with save.
+    }
+    const metadata = { btx_session_id: SESSION_ID || undefined };
+    if (flags.source)
+        metadata.source_url = flags.source;
+    const data = await api('POST', '/session-activities', {
+        sessionId,
+        type: 'note',
+        content: flags.content,
+        metadata
+    });
+    if (isJson(flags)) {
+        printJson({ id: data.id ?? null, sessionId, content: flags.content, metadata });
+        return;
+    }
+    console.log(`Note saved.`);
+    console.log(`Session: ${sessionId}`);
+    console.log(`BTX_SESSION_NOTE_JSON: ${JSON.stringify({ id: data.id, sessionId, content: flags.content })}`);
+}
+async function sessionNotesList(sessionId, flags) {
+    if (!sessionId)
+        die('Usage: btx sessions notes list <session-id>');
+    const result = await api('GET', `/session-activities?sessionId=${sessionId}&limit=50`);
+    const notes = (Array.isArray(result) ? result : []).filter(isNoteActivity);
+    if (isJson(flags)) {
+        printJson(notes);
+        return;
+    }
+    if (notes.length === 0) {
+        console.log('No notes yet for this session.');
+        return;
+    }
+    console.log(`${notes.length} note${notes.length !== 1 ? 's' : ''} for session ${sessionId}:\n`);
+    for (const n of notes) {
+        const date = activityDate(n);
+        console.log(`[${date}] ${n.content}`);
+        console.log();
+    }
+}
+// ── Leads commands ────────────────────────────────────────────────────────────
+async function fetchLeadTypes() {
+    return (await api('GET', '/lead-types')) ?? [];
+}
+async function leadsList(flags) {
+    const leads = await fetchLeadTypes();
+    if (isJson(flags)) {
+        printJson(leads);
+        return;
+    }
+    formatLeadTypeTable(leads);
+}
+async function leadsGet(id, flags) {
+    if (!id)
+        die('Usage: btx leads get <lead-id>');
+    const leads = await fetchLeadTypes();
+    const lead = leads.find((lt) => lt.id === id);
+    if (!lead)
+        die(`Lead type not found: ${id}`);
+    if (isJson(flags)) {
+        printJson(lead);
+        return;
+    }
+    formatLeadTypeDetail(lead);
+}
+// ── Intro paths commands ─────────────────────────────────────────────────────
+function introPathPayload(path) {
+    return JSON.stringify({
+        connectionId: path.connection.id,
+        connectionName: path.connection.name,
+        connectionCompany: path.connection.company || null,
+        connectionRole: path.connection.role || null,
+        pathType: path.pathType,
+        score: path.score,
+        evidence: path.evidence,
+        suggestedApproach: path.suggestedApproach || null,
+        exaFindings: path.exaFindings || []
+    });
+}
+function formatIntroPathResults(result) {
+    const target = result.target;
+    console.log(`\nIntro paths to ${target.name}${target.company ? ` (${target.company})` : ''}${target.role ? ` - ${target.role}` : ''}`);
+    console.log(`Searched ${result.contactsSearched} contacts in your network.\n`);
+    if (result.paths.length === 0) {
+        console.log(result.noPathSuggestion || 'No warm intro paths found.');
+        return;
+    }
+    const scoreW = 6;
+    const typeW = 18;
+    const nameW = 24;
+    const companyW = 20;
+    console.log(`${padRight('Score', scoreW)}  ${padRight('Type', typeW)}  ${padRight('Connection', nameW)}  ${padRight('Company', companyW)}  Evidence`);
+    console.log(`${'\u2500'.repeat(scoreW)}  ${'\u2500'.repeat(typeW)}  ${'\u2500'.repeat(nameW)}  ${'\u2500'.repeat(companyW)}  ${'\u2500'.repeat(40)}`);
+    for (const p of result.paths) {
+        const score = (p.score * 100).toFixed(0) + '%';
+        const name = truncate(p.connection.name, nameW);
+        const company = truncate(p.connection.company || '', companyW);
+        const typeLabel = p.pathType.replace(/_/g, ' ');
+        console.log(`${padRight(score, scoreW)}  ${padRight(typeLabel, typeW)}  ${padRight(name, nameW)}  ${padRight(company, companyW)}  ${truncate(p.evidence, 50)}`);
+    }
+    console.log(`\n${result.paths.length} intro path${result.paths.length !== 1 ? 's' : ''} found.\n`);
+    // Detailed output per path
+    for (let i = 0; i < result.paths.length; i++) {
+        const p = result.paths[i];
+        console.log(`--- Path ${i + 1}: via ${p.connection.name} ---`);
+        console.log(`  Company:    ${p.connection.company || 'N/A'}`);
+        console.log(`  Role:       ${p.connection.role || 'N/A'}`);
+        if (p.connection.linkedinUrl)
+            console.log(`  LinkedIn:   ${p.connection.linkedinUrl}`);
+        console.log(`  Type:       ${p.pathType.replace(/_/g, ' ')}`);
+        console.log(`  Score:      ${(p.score * 100).toFixed(0)}%`);
+        console.log(`  Evidence:   ${p.evidence}`);
+        if (p.suggestedApproach)
+            console.log(`  Approach:   ${p.suggestedApproach}`);
+        if (p.exaFindings?.length) {
+            console.log(`  Web signals:`);
+            for (const f of p.exaFindings)
+                console.log(`    - ${f}`);
+        }
+        console.log();
+        console.log(`BTX_INTRO_PATH_JSON: ${introPathPayload(p)}`);
+    }
+}
+async function introPathsFind(flags) {
+    const contactId = flags['contact-id'] || flags.contact;
+    const name = flags.name;
+    const company = flags.company;
+    const role = flags.role;
+    if (!contactId && !name) {
+        die('Usage: btx intro-paths find --contact-id <id> OR --name "Person Name" [--company "..."] [--role "..."]');
+    }
+    const body = {};
+    if (contactId)
+        body.contactId = contactId;
+    if (name)
+        body.targetName = name;
+    if (company)
+        body.targetCompany = company;
+    if (role)
+        body.targetRole = role;
+    const result = await api('POST', '/intro-paths', body);
+    if (isJson(flags)) {
+        printJson(result);
+        return;
+    }
+    formatIntroPathResults(result);
+}
+// ── Global search ────────────────────────────────────────────────────────────
+async function globalSearch(flags) {
+    const query = flags.query || flags.q;
+    if (!query)
+        die('Usage: btx search --query "search text" [--status todo|in_progress|done]');
+    const q = query.toLowerCase();
+    const tasks = await fetchTasks();
+    const matches = tasks.filter((t) => {
+        if (flags.status && t.status !== flags.status)
+            return false;
+        return ((t.title || '').toLowerCase().includes(q) ||
+            (t.description || '').toLowerCase().includes(q) ||
+            (t.plan || '').toLowerCase().includes(q));
+    });
+    if (isJson(flags)) {
+        printJson(matches);
+        return;
+    }
+    if (matches.length === 0) {
+        console.log(`No tasks found matching "${query}".`);
+        console.log('\nTo search coding sessions, use Cmd+Shift+F in the BTX app.');
+        return;
+    }
+    formatTaskTable(matches);
+    console.log('\nTo search coding sessions, use Cmd+Shift+F in the BTX app.');
+}
+// ── User profile notes commands ───────────────────────────────────────────────
+async function userNotesAdd(flags) {
+    if (!flags.content)
+        die('--content is required');
+    // Dedup check. Fetch existing notes and warn if very similar content already exists.
+    try {
+        const existing = await api('GET', '/user-activities?limit=200');
+        const notes = (Array.isArray(existing) ? existing : []).filter(isNoteActivity);
+        for (const n of notes) {
+            if (noteSimilarity(flags.content, n.content) >= 0.7) {
+                const date = activityDate(n);
+                console.log(`Skipped. Similar user note already exists (${date}): ${n.content}`);
+                return;
+            }
+        }
+    }
+    catch {
+        // Non-fatal. Proceed with save.
+    }
+    const metadata = { btx_session_id: SESSION_ID || undefined };
+    if (flags.source)
+        metadata.source_url = flags.source;
+    const data = await api('POST', '/user-activities', {
+        type: 'note',
+        content: flags.content,
+        metadata
+    });
+    if (isJson(flags)) {
+        printJson({ id: data.id ?? null, content: flags.content, metadata });
+        return;
+    }
+    console.log(`User profile note saved.`);
+    console.log(`BTX_USER_NOTE_JSON: ${JSON.stringify({ id: data.id, content: flags.content })}`);
+}
+async function userNotesList(flags) {
+    const result = await api('GET', '/user-activities?limit=200');
+    const notes = (Array.isArray(result) ? result : []).filter(isNoteActivity);
+    if (isJson(flags)) {
+        printJson(notes);
+        return;
+    }
+    if (notes.length === 0) {
+        console.log('No user profile notes yet.');
+        return;
+    }
+    console.log(`${notes.length} user profile note${notes.length !== 1 ? 's' : ''}:\n`);
+    for (const n of notes) {
+        const date = activityDate(n);
+        console.log(`[${date}] ${n.content}`);
+        console.log();
+    }
+}
+// ── Context commands ─────────────────────────────────────────────────────────
+async function contextGet(flags) {
+    const data = await api('GET', '/context');
+    const name = data.name || 'Project';
+    const ctx = data.context;
+    if (isJson(flags)) {
+        printJson(data);
+        return;
+    }
+    if (!ctx) {
+        console.log('No business context set for this project.');
+        return;
+    }
+    console.log(`# ${name} - Business Context\n`);
+    if (ctx.productSummary)
+        console.log(`## Product\n${ctx.productSummary}\n`);
+    if (ctx.problemStatement)
+        console.log(`## Problem\n${ctx.problemStatement}\n`);
+    if (ctx.targetMarket)
+        console.log(`## Target Market\n${ctx.targetMarket}\n`);
+    if (ctx.differentiator)
+        console.log(`## Differentiator\n${ctx.differentiator}\n`);
+    if (ctx.alternatives)
+        console.log(`## Alternatives\n${ctx.alternatives}\n`);
+    if (ctx.valueProps?.length) {
+        console.log(`## Value Propositions`);
+        for (const vp of ctx.valueProps)
+            console.log(`- ${vp}`);
+        console.log();
+    }
+    if (ctx.tone)
+        console.log(`## Tone\n${ctx.tone}\n`);
+    if (ctx.businessStage)
+        console.log(`## Stage\n${ctx.businessStage}\n`);
+    if (ctx.currentFocus)
+        console.log(`## Current Focus\n${ctx.currentFocus}\n`);
+}
+// ── Pages commands ───────────────────────────────────────────────────────────
+function parseInlineMarks(text) {
+    // Parse **bold** and *italic* into Tiptap text nodes with marks
+    const nodes = [];
+    const re = /(\*\*(.+?)\*\*|\*(.+?)\*)/g;
+    let last = 0;
+    let m;
+    while ((m = re.exec(text)) !== null) {
+        if (m.index > last)
+            nodes.push({ type: 'text', text: text.slice(last, m.index) });
+        if (m[2]) {
+            nodes.push({ type: 'text', text: m[2], marks: [{ type: 'bold' }] });
+        }
+        else if (m[3]) {
+            nodes.push({ type: 'text', text: m[3], marks: [{ type: 'italic' }] });
+        }
+        last = m.index + m[0].length;
+    }
+    if (last < text.length)
+        nodes.push({ type: 'text', text: text.slice(last) });
+    return nodes.length > 0 ? nodes : [{ type: 'text', text }];
+}
+function markdownToTiptap(text) {
+    if (!text)
+        return { type: 'doc', content: [{ type: 'paragraph', content: [] }] };
+    const lines = text.split('\n');
+    const nodes = [];
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        // Headings: # ## ###
+        const headingMatch = line.match(/^(#{1,3})\s+(.+)$/);
+        if (headingMatch) {
+            nodes.push({
+                type: 'heading',
+                attrs: { level: headingMatch[1].length },
+                content: parseInlineMarks(headingMatch[2])
+            });
+            i++;
+            continue;
+        }
+        // Bullet list: collect consecutive lines starting with - or *
+        if (/^\s*[-*]\s/.test(line)) {
+            const items = [];
+            while (i < lines.length && /^\s*[-*]\s/.test(lines[i])) {
+                const itemText = lines[i].replace(/^\s*[-*]\s+/, '');
+                items.push({
+                    type: 'listItem',
+                    content: [{ type: 'paragraph', content: parseInlineMarks(itemText) }]
+                });
+                i++;
+            }
+            nodes.push({ type: 'bulletList', content: items });
+            continue;
+        }
+        // Empty line → empty paragraph
+        if (!line.trim()) {
+            nodes.push({ type: 'paragraph', content: [] });
+            i++;
+            continue;
+        }
+        // Regular paragraph
+        nodes.push({ type: 'paragraph', content: parseInlineMarks(line) });
+        i++;
+    }
+    return { type: 'doc', content: nodes.length > 0 ? nodes : [{ type: 'paragraph', content: [] }] };
+}
+async function pagesCreate(flags) {
+    const title = flags.title;
+    if (!title)
+        die('--title is required');
+    const id = randomUUID();
+    const now = Date.now();
+    const content = markdownToTiptap(flags.body || '');
+    const sessionRefs = SESSION_ID ? [{ id: SESSION_ID, label: title }] : [];
+    await api('POST', '/notes', { id, title, content, sessionRefs, createdAt: now });
+    if (isJson(flags)) {
+        printJson({ page: { id, title, content, updatedAt: now }, deepLink: noteDeepLink(id) });
+        return;
+    }
+    console.log(`Page created: ${title}`);
+    console.log(`ID: ${id}`);
+    console.log(`Deep link: ${noteDeepLink(id)}`);
+}
+async function pagesUpdate(noteId, flags) {
+    if (!noteId)
+        die('Usage: btx pages update <note-id> --title "..." --body "..."');
+    const result = await api('GET', '/notes');
+    const notes = result?.notes ?? [];
+    const existing = notes.find((n) => n.id === noteId);
+    if (!existing)
+        die(`Page ${noteId} not found`);
+    const patch = { id: noteId };
+    const changed = [];
+    if (flags.title !== undefined) {
+        patch.title = flags.title;
+        changed.push('title');
+    }
+    if (flags.body !== undefined) {
+        patch.content = markdownToTiptap(flags.body);
+        changed.push('body');
+    }
+    if (changed.length === 0)
+        die('No fields to update. Use: --title "..." --body "..."');
+    await api('POST', '/notes', patch);
+    if (isJson(flags)) {
+        printJson({ pageId: noteId, updatedFields: changed, deepLink: noteDeepLink(noteId) });
+        return;
+    }
+    console.log(`Page updated: ${existing.title || '(untitled)'}`);
+    console.log(`Updated fields: ${changed.join(', ')}`);
+    console.log(`Deep link: ${noteDeepLink(noteId)}`);
+}
+async function pagesList(flags) {
+    const result = await api('GET', '/notes');
+    const notes = result?.notes ?? [];
+    if (isJson(flags)) {
+        printJson(notes);
+        return;
+    }
+    if (notes.length === 0) {
+        console.log('No note pages found.');
+        return;
+    }
+    console.log(`\n${notes.length} page${notes.length !== 1 ? 's' : ''}:\n`);
+    for (const n of notes) {
+        const date = new Date(n.updatedAt).toISOString().slice(0, 10);
+        console.log(`  [${date}] ${n.title || '(untitled)'}`);
+        console.log(`    ID: ${n.id}`);
+        console.log(`    ${noteDeepLink(n.id)}`);
+        console.log();
+    }
+}
+function tiptapToMarkdown(doc) {
+    if (!doc || !doc.content)
+        return '';
+    const lines = [];
+    for (const node of doc.content) {
+        if (node.type === 'heading') {
+            const prefix = '#'.repeat(node.attrs?.level || 1);
+            lines.push(`${prefix} ${inlineToText(node.content)}`);
+        }
+        else if (node.type === 'bulletList') {
+            for (const item of node.content || []) {
+                const text = item.content?.map((p) => inlineToText(p.content)).join(' ') || '';
+                lines.push(`- ${text}`);
+            }
+        }
+        else if (node.type === 'paragraph') {
+            lines.push(inlineToText(node.content));
+        }
+        else {
+            lines.push(inlineToText(node.content));
+        }
+    }
+    return lines.join('\n');
+}
+function inlineToText(nodes) {
+    if (!nodes)
+        return '';
+    return nodes
+        .map((n) => {
+        const text = n.text || '';
+        if (!n.marks)
+            return text;
+        let wrapped = text;
+        for (const mark of n.marks) {
+            if (mark.type === 'bold')
+                wrapped = `**${wrapped}**`;
+            else if (mark.type === 'italic')
+                wrapped = `*${wrapped}*`;
+        }
+        return wrapped;
+    })
+        .join('');
+}
+async function pagesGet(noteId, flags) {
+    if (!noteId)
+        die('Usage: btx pages get <note-id>');
+    const result = await api('GET', '/notes');
+    const notes = result?.notes ?? [];
+    const note = notes.find((n) => n.id === noteId);
+    if (!note)
+        die(`Page ${noteId} not found`);
+    if (isJson(flags)) {
+        printJson(note);
+        return;
+    }
+    console.log(`Title:   ${note.title || '(untitled)'}`);
+    console.log(`ID:      ${note.id}`);
+    console.log(`Updated: ${new Date(note.updatedAt).toISOString().slice(0, 10)}`);
+    console.log(`Deep link: ${noteDeepLink(note.id)}`);
+    const body = tiptapToMarkdown(note.content);
+    if (body)
+        console.log(`\nBody:\n${body}`);
+}
+// ── Hiring Types ───────────────────────────────────────────────────────────
+async function hiringTypesList(flags) {
+    const result = await api('GET', '/hiring-types');
+    const types = result?.hiringTypes ?? [];
+    if (isJson(flags)) {
+        printJson(types);
+        return;
+    }
+    if (!types.length) {
+        console.log('No hiring types found.');
+        return;
+    }
+    const maxTitle = Math.max(5, ...types.map((t) => (t.title || '').length));
+    const maxCat = Math.max(8, ...types.map((t) => (t.category || '').length));
+    const header = `${'TITLE'.padEnd(maxTitle)}  ${'CATEGORY'.padEnd(maxCat)}  ${'STATUS'.padEnd(10)}  ID`;
+    console.log(header);
+    console.log('-'.repeat(header.length + 20));
+    for (const t of types) {
+        console.log(`${(t.title || '').padEnd(maxTitle)}  ${(t.category || '').padEnd(maxCat)}  ${(t.status || '').padEnd(10)}  ${t.id}`);
+    }
+    console.log(`\n${types.length} hiring type(s)`);
+}
+async function hiringTypesGet(id, flags) {
+    if (!id)
+        die('Usage: btx hiring-types get <hiring-type-id>');
+    const result = await api('GET', '/hiring-types');
+    const types = result?.hiringTypes ?? [];
+    const ht = types.find((t) => t.id === id);
+    if (!ht)
+        die(`Hiring type not found: ${id}`);
+    if (isJson(flags)) {
+        printJson(ht);
+        return;
+    }
+    console.log(`Title:       ${ht.title || '(untitled)'}`);
+    console.log(`ID:          ${ht.id}`);
+    console.log(`Category:    ${ht.category || '-'}`);
+    console.log(`Status:      ${ht.status || '-'}`);
+    console.log(`Location:    ${ht.location || '-'}`);
+    console.log(`Source:      ${ht.source || '-'}`);
+    if (ht.description)
+        console.log(`\nDescription:\n${ht.description}`);
+    if (ht.searchDescription)
+        console.log(`\nSearch Description:\n${ht.searchDescription}`);
+}
+async function hiringTypesCreate(flags) {
+    if (!flags.title)
+        die('Usage: btx hiring-types create --title "..." [--description "..."] [--category Engineer|Designer|...] [--location "..."]');
+    const body = {
+        id: randomUUID(),
+        title: flags.title,
+        description: flags.description || null,
+        searchDescription: flags['search-description'] || null,
+        category: flags.category || 'Engineer',
+        location: flags.location || null,
+        source: 'manual',
+        status: flags.status || 'confirmed'
+    };
+    await api('POST', '/hiring-types', body);
+    if (isJson(flags)) {
+        printJson(body);
+        return;
+    }
+    console.log(`Created hiring type: ${body.title} (${body.id})`);
+}
+async function hiringTypesUpdate(id, flags) {
+    if (!id)
+        die('Usage: btx hiring-types update <hiring-type-id> [--title "..."] [--description "..."] ...');
+    const result = await api('GET', '/hiring-types');
+    const types = result?.hiringTypes ?? [];
+    const existing = types.find((t) => t.id === id);
+    if (!existing)
+        die(`Hiring type not found: ${id}`);
+    const body = {
+        id,
+        title: flags.title || existing.title,
+        description: flags.description !== undefined ? flags.description : existing.description,
+        searchDescription: flags['search-description'] !== undefined
+            ? flags['search-description']
+            : existing.searchDescription,
+        category: flags.category || existing.category,
+        location: flags.location !== undefined ? flags.location : existing.location,
+        source: existing.source,
+        status: flags.status || existing.status
+    };
+    await api('POST', '/hiring-types', body);
+    if (isJson(flags)) {
+        printJson(body);
+        return;
+    }
+    console.log(`Updated hiring type: ${body.title} (${id})`);
+}
+async function hiringTypesDelete(id, flags) {
+    if (!id)
+        die('Usage: btx hiring-types delete <hiring-type-id>');
+    await api('DELETE', `/hiring-types/${id}`);
+    if (isJson(flags)) {
+        printJson({ id, deleted: true });
+        return;
+    }
+    console.log(`Deleted hiring type: ${id}`);
+}
+// ── Hiring Candidates ──────────────────────────────────────────────────────
+async function hiringCandidatesList(flags) {
+    const result = await api('GET', '/hiring-candidates');
+    let candidates = result?.candidates ?? [];
+    if (flags['hiring-type']) {
+        candidates = candidates.filter((c) => c.hiringTypeId === flags['hiring-type']);
+    }
+    if (flags.stage) {
+        candidates = candidates.filter((c) => c.stage === flags.stage);
+    }
+    if (flags.query) {
+        const q = flags.query.toLowerCase();
+        candidates = candidates.filter((c) => (c.name || '').toLowerCase().includes(q) ||
+            (c.company || '').toLowerCase().includes(q) ||
+            (c.role || '').toLowerCase().includes(q));
+    }
+    if (isJson(flags)) {
+        printJson(candidates);
+        return;
+    }
+    if (!candidates.length) {
+        console.log('No hiring candidates found.');
+        return;
+    }
+    const total = candidates.length;
+    const limit = flags.limit ? parseInt(flags.limit, 10) : null;
+    if (limit && limit > 0)
+        candidates = candidates.slice(0, limit);
+    const maxName = Math.max(4, ...candidates.map((c) => (c.name || '').length));
+    const maxCompany = Math.max(7, ...candidates.map((c) => (c.company || '').length));
+    const maxRole = Math.max(4, ...candidates.map((c) => (c.role || '').length));
+    const header = `${'NAME'.padEnd(maxName)}  ${'COMPANY'.padEnd(maxCompany)}  ${'ROLE'.padEnd(maxRole)}  ${'STAGE'.padEnd(14)}  ID`;
+    console.log(header);
+    console.log('-'.repeat(header.length + 20));
+    for (const c of candidates) {
+        console.log(`${(c.name || '').padEnd(maxName)}  ${(c.company || '').padEnd(maxCompany)}  ${(c.role || '').padEnd(maxRole)}  ${(c.stage || '').padEnd(14)}  ${c.id}`);
+    }
+    const note = limit && total > limit ? ` (showing ${limit} of ${total})` : '';
+    console.log(`\n${candidates.length} candidate(s)${note}`);
+}
+async function hiringCandidatesGet(id, flags) {
+    if (!id)
+        die('Usage: btx hiring-candidates get <candidate-id>');
+    const result = await api('GET', '/hiring-candidates');
+    const candidates = result?.candidates ?? [];
+    const c = candidates.find((c) => c.id === id);
+    if (!c)
+        die(`Candidate not found: ${id}`);
+    if (isJson(flags)) {
+        printJson(c);
+        return;
+    }
+    console.log(`Name:          ${c.name || '-'}`);
+    console.log(`ID:            ${c.id}`);
+    console.log(`Company:       ${c.company || '-'}`);
+    console.log(`Role:          ${c.role || '-'}`);
+    console.log(`Email:         ${c.email || '-'}`);
+    console.log(`Location:      ${c.location || '-'}`);
+    console.log(`Stage:         ${c.stage || '-'}`);
+    console.log(`Source:        ${c.source || '-'}`);
+    console.log(`LinkedIn:      ${c.linkedinUrl || '-'}`);
+    console.log(`Favorite:      ${c.isFavorite ? 'Yes' : 'No'}`);
+    console.log(`Hiring Type:   ${c.hiringTypeId || '-'}`);
+    if (c.whyMatch)
+        console.log(`\nWhy Match:\n${c.whyMatch}`);
+    if (c.outreachAngle)
+        console.log(`\nOutreach Angle:\n${c.outreachAngle}`);
+    if (c.feedback)
+        console.log(`\nFeedback: ${c.feedback}${c.feedbackReason ? ' - ' + c.feedbackReason : ''}`);
+}
+// ── Meeting commands ────────────────────────────────────────────────────────
+async function fetchMeetings() {
+    const result = await api('GET', '/meetings');
+    return result?.meetings ?? [];
+}
+async function meetingsList(flags) {
+    let meetings = await fetchMeetings();
+    if (flags.days) {
+        const cutoff = new Date();
+        cutoff.setDate(cutoff.getDate() - Number(flags.days));
+        const cutoffStr = cutoff.toISOString();
+        meetings = meetings.filter((m) => m.meetingDate && m.meetingDate >= cutoffStr);
+    }
+    if (flags.query) {
+        const q = flags.query.toLowerCase();
+        meetings = meetings.filter((m) => m.title.toLowerCase().includes(q) ||
+            (m.summary && m.summary.toLowerCase().includes(q)) ||
+            (m.aiSummary && m.aiSummary.toLowerCase().includes(q)));
+    }
+    if (isJson(flags)) {
+        printJson(meetings);
+        return;
+    }
+    formatMeetingTable(meetings);
+}
+async function meetingsGet(id, flags) {
+    if (!id)
+        die('Usage: btx meetings get <meeting-id>');
+    const meetings = await fetchMeetings();
+    const meeting = meetings.find((m) => m.id === id);
+    if (!meeting)
+        die(`Meeting not found: ${id}`);
+    if (isJson(flags)) {
+        printJson(meeting);
+        return;
+    }
+    formatMeetingDetail(meeting);
+}
+async function meetingsTranscript(id, flags) {
+    if (!id)
+        die('Usage: btx meetings transcript <meeting-id>');
+    const meetings = await fetchMeetings();
+    const meeting = meetings.find((m) => m.id === id);
+    if (!meeting)
+        die(`Meeting not found: ${id}`);
+    if (isJson(flags)) {
+        printJson(meeting.transcript ?? []);
+        return;
+    }
+    formatMeetingTranscript(meeting);
+}
+// ── Main ────────────────────────────────────────────────────────────────────
+export async function runRuntimeCli(args, env = process.env) {
+    configureRuntime(env);
+    const { positional, flags } = parseArgs(args);
+    const resource = positional[0];
+    const command = positional[1];
+    // ── Help (no auth required) ──────────────────────────────────────────────
+    if (!resource) {
+        console.log(renderCliText(HELP.top));
+        return;
+    }
+    if (HELP[resource] && (flags.help || !command || command === '--help')) {
+        // Show resource-level help if: --help flag, or no command given, or command is '--help'
+        // Exception: 'search' and 'intro-paths find' don't have sub-commands
+        const resourcesWithSubCommands = [
+            'tasks',
+            'sessions',
+            'contacts',
+            'orgs',
+            'meetings',
+            'leads',
+            'user',
+            'intro-paths',
+            'context',
+            'pages'
+        ];
+        const noSubCommandResources = ['search'];
+        if (noSubCommandResources.includes(resource) && !flags.help) {
+            // Fall through to normal routing
+        }
+        else if (resourcesWithSubCommands.includes(resource) && (flags.help || !command)) {
+            console.log(renderCliText(HELP[resource]));
+            return;
+        }
+    }
+    // ── Auth (required for all data commands) ───────────────────────────────
+    if (!TOKEN)
+        die('BTX_ACCESS_TOKEN is not set. Are you running inside a BTX session?');
+    if (!PROJECT_ID)
+        die('BTX_PROJECT_ID is not set. Are you running inside a BTX session?');
+    if (resource === 'tasks') {
+        if (command === 'notes') {
+            const subCommand = positional[2];
+            const taskId = positional[3];
+            switch (subCommand) {
+                case 'add':
+                    return taskNotesAdd(taskId, flags);
+                case 'list':
+                    return taskNotesList(taskId, flags);
+                default:
+                    die(`Unknown tasks notes command: "${subCommand || '(none)'}". Run: node "$BTX_CLI_PATH" tasks --help`);
+            }
+        }
+        switch (command) {
+            case 'list':
+                return tasksList(flags);
+            case 'get':
+                return tasksGet(positional[2], flags);
+            case 'create':
+                return tasksCreate(flags);
+            case 'update':
+                return tasksUpdate(positional[2], flags);
+            case 'complete':
+                return tasksComplete(positional[2], flags);
+            default:
+                die(`Unknown tasks command: "${command || '(none)'}". Run: node "$BTX_CLI_PATH" tasks --help`);
+        }
+    }
+    else if (resource === 'sessions') {
+        if (command === 'notes') {
+            const subCommand = positional[2];
+            const sessionId = positional[3];
+            switch (subCommand) {
+                case 'add':
+                    return sessionNotesAdd(sessionId, flags);
+                case 'list':
+                    return sessionNotesList(sessionId, flags);
+                default:
+                    die(`Unknown sessions notes command: "${subCommand || '(none)'}". Run: node "$BTX_CLI_PATH" sessions --help`);
+            }
+        }
+        die(`Unknown sessions command: "${command || '(none)'}". Run: node "$BTX_CLI_PATH" sessions --help`);
+    }
+    else if (resource === 'contacts') {
+        if (command === 'notes') {
+            const subCommand = positional[2];
+            const contactId = positional[3];
+            switch (subCommand) {
+                case 'add':
+                    return contactNotesAdd(contactId, flags);
+                case 'list':
+                    return contactNotesList(contactId, flags);
+                default:
+                    die(`Unknown contacts notes command: "${subCommand || '(none)'}". Run: node "$BTX_CLI_PATH" contacts --help`);
+            }
+        }
+        switch (command) {
+            case 'list':
+                return contactsList(flags);
+            case 'get':
+                return contactsGet(positional[2], flags);
+            case 'create':
+                return contactsCreate(flags);
+            case 'update':
+                return contactsUpdate(positional[2], flags);
+            default:
+                die(`Unknown contacts command: "${command || '(none)'}". Run: node "$BTX_CLI_PATH" contacts --help`);
+        }
+    }
+    else if (resource === 'orgs') {
+        if (command === 'notes') {
+            const subCommand = positional[2];
+            const orgId = positional[3];
+            switch (subCommand) {
+                case 'add':
+                    return orgNotesAdd(orgId, flags);
+                case 'list':
+                    return orgNotesList(orgId, flags);
+                default:
+                    die(`Unknown orgs notes command: "${subCommand || '(none)'}". Run: node "$BTX_CLI_PATH" orgs --help`);
+            }
+        }
+        switch (command) {
+            case 'list':
+                return orgsList(flags);
+            case 'get':
+                return orgsGet(positional[2]);
+            case 'create':
+                return orgsCreate(flags);
+            default:
+                die(`Unknown orgs command: "${command || '(none)'}". Run: node "$BTX_CLI_PATH" orgs --help`);
+        }
+    }
+    else if (resource === 'leads') {
+        switch (command) {
+            case 'list':
+                return leadsList(flags);
+            case 'get':
+                return leadsGet(positional[2], flags);
+            default:
+                die(`Unknown leads command: "${command || '(none)'}". Run: node "$BTX_CLI_PATH" leads --help`);
+        }
+    }
+    else if (resource === 'meetings') {
+        switch (command) {
+            case 'list':
+                return meetingsList(flags);
+            case 'get':
+                return meetingsGet(positional[2], flags);
+            case 'transcript':
+                return meetingsTranscript(positional[2], flags);
+            default:
+                die(`Unknown meetings command: "${command || '(none)'}". Run: node "$BTX_CLI_PATH" meetings --help`);
+        }
+    }
+    else if (resource === 'intro-paths') {
+        switch (command) {
+            case 'find':
+                return introPathsFind(flags);
+            default:
+                die(`Unknown intro-paths command: "${command || '(none)'}". Run: node "$BTX_CLI_PATH" intro-paths --help`);
+        }
+    }
+    else if (resource === 'user') {
+        if (command === 'notes') {
+            const subCommand = positional[2];
+            switch (subCommand) {
+                case 'add':
+                    return userNotesAdd(flags);
+                case 'list':
+                    return userNotesList(flags);
+                default:
+                    die(`Unknown user notes command: "${subCommand || '(none)'}". Run: node "$BTX_CLI_PATH" user --help`);
+            }
+        }
+        die(`Unknown user command: "${command || '(none)'}". Run: node "$BTX_CLI_PATH" user --help`);
+    }
+    else if (resource === 'pages') {
+        switch (command) {
+            case 'create':
+                return pagesCreate(flags);
+            case 'update':
+                return pagesUpdate(positional[2], flags);
+            case 'list':
+                return pagesList(flags);
+            case 'get':
+                return pagesGet(positional[2], flags);
+            default:
+                die(`Unknown pages command: "${command || '(none)'}". Run: node "$BTX_CLI_PATH" pages --help`);
+        }
+    }
+    else if (resource === 'search') {
+        return globalSearch(flags);
+    }
+    else if (resource === 'context') {
+        switch (command) {
+            case 'get':
+                return contextGet(flags);
+            default:
+                die(`Unknown context command: "${command || '(none)'}". Run: node "$BTX_CLI_PATH" context --help`);
+        }
+    }
+    else if (resource === 'hiring-types') {
+        switch (command) {
+            case 'list':
+                return hiringTypesList(flags);
+            case 'get':
+                return hiringTypesGet(positional[2], flags);
+            case 'create':
+                return hiringTypesCreate(flags);
+            case 'update':
+                return hiringTypesUpdate(positional[2], flags);
+            case 'delete':
+                return hiringTypesDelete(positional[2], flags);
+            case '--help':
+                console.log('hiring-types list                    List all hiring types');
+                console.log('hiring-types get <id>                Get a specific hiring type');
+                console.log('hiring-types create --title "..." --description "..." --search-description "..." [--category Engineer] [--location "..."]');
+                console.log('hiring-types update <id> [--title "..."] [--status draft|confirmed] [--description "..."]');
+                console.log('hiring-types delete <id>             Delete a hiring type');
+                return;
+            default:
+                die(`Unknown hiring-types command: "${command || '(none)'}". Run: node "$BTX_CLI_PATH" hiring-types --help`);
+        }
+    }
+    else if (resource === 'hiring-candidates') {
+        switch (command) {
+            case 'list':
+                return hiringCandidatesList(flags);
+            case 'get':
+                return hiringCandidatesGet(positional[2], flags);
+            case '--help':
+                console.log('hiring-candidates list [--hiring-type <id>] [--stage sourced|screened|interviewing|offer|hired|passed]');
+                console.log('hiring-candidates get <id>           Get a specific candidate');
+                return;
+            default:
+                die(`Unknown hiring-candidates command: "${command || '(none)'}". Run: node "$BTX_CLI_PATH" hiring-candidates --help`);
+        }
+    }
+    else {
+        die(`Unknown resource: "${resource}". Run: node "$BTX_CLI_PATH" --help`);
+    }
+}
+//# sourceMappingURL=runtime-cli.js.map