heyiam 0.2.28 → 0.3.0

package/README.md

@@ -0,0 +1,45 @@
+# heyiam
+
+[![npm version](https://img.shields.io/npm/v/heyiam)](https://www.npmjs.com/package/heyiam)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/interactivecats/heyi.am/blob/main/LICENSE)
+
+Local-first CLI that indexes your AI coding sessions. Search locally, enhance with AI, and publish a portfolio of real work.
+
+Discovers sessions from **Claude Code**, **Cursor**, **OpenAI Codex CLI**, and **Google Gemini CLI**.
+
+## Get Started
+
+```bash
+npx heyiam
+```
+
+Opens a local dashboard at `localhost:17845`. Browse projects, search sessions, and publish portfolio case studies to `heyi.am/:username`.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `heyiam` / `heyiam open` | Start local dashboard |
+| `heyiam search [query]` | Full-text search across all sessions |
+| `heyiam time` | Your time vs agent time per project |
+| `heyiam context <id>` | Export session as compressed context for AI tools |
+| `heyiam archive` | Discover and archive sessions from all sources |
+| `heyiam sync` | Index sessions into SQLite |
+| `heyiam status` | Archive health, session counts, daemon status |
+
+## Privacy
+
+Everything stays local by default. Nothing leaves your machine unless you explicitly publish.
+
+- Sessions are read from local tool storage (read-only)
+- SQLite search index lives at `~/.local/share/heyiam/`
+- Config at `~/.config/heyiam/`
+- Common secret patterns are detected and redacted before upload, but this is not a guarantee
+
+AI enhancement runs locally using your own `ANTHROPIC_API_KEY`.
+
+## Links
+
+- [heyi.am](https://heyi.am) — published portfolios
+- [heyiam.com](https://heyiam.com) — dashboard and auth
+- [GitHub](https://github.com/interactivecats/heyi.am) — source code

package/dist/config.js

@@ -1,4 +1,13 @@
 /** Base URL for the heyiam.com app API. Override with HEYIAM_API_URL for local dev. */
-export const API_URL = process.env.HEYIAM_API_URL ?? 'https://heyiam.com';
+const DEFAULT_API_URL = 'https://heyiam.com';
+export const API_URL = process.env.HEYIAM_API_URL ?? DEFAULT_API_URL;
 /** Base URL for the heyi.am public site. Override with HEYIAM_PUBLIC_URL for local dev. */
 export const PUBLIC_URL = process.env.HEYIAM_PUBLIC_URL ?? 'https://heyi.am';
+/** Warn once to stderr if a non-default API URL is in use (env var override). */
+let _apiUrlWarned = false;
+export function warnIfNonDefaultApiUrl() {
+    if (!_apiUrlWarned && API_URL !== DEFAULT_API_URL) {
+        console.warn(`[security] API_URL overridden to ${API_URL} — auth tokens will be sent to this host`);
+        _apiUrlWarned = true;
+    }
+}

package/dist/db.js

@@ -9,10 +9,9 @@ import { homedir } from 'node:os';
 function getDataDir() {
     return process.env.HEYIAM_DATA_DIR || join(homedir(), '.local', 'share', 'heyiam');
 }
-export function getDbPath() {
+function getDbPath() {
     return join(getDataDir(), 'sessions.db');
 }
-export const DB_PATH = join(homedir(), '.local', 'share', 'heyiam', 'sessions.db');
 const CURRENT_SCHEMA_VERSION = 5;
 // ── Singleton ────────────────────────────────────────────────
 let _db = null;

package/dist/export.js

@@ -9,9 +9,10 @@ import { mkdirSync, writeFileSync, readFileSync, statSync, existsSync } from 'no
 import { deflateRawSync } from 'node:zlib';
 import { join, resolve, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { loadEnhancedData } from './settings.js';
+import { loadEnhancedData, getDefaultTemplate } from './settings.js';
 import { renderProjectHtml, renderSessionHtml } from './render/index.js';
-import { escapeHtml, displayNameFromDir } from './format-utils.js';
+import { resolveTemplate, getTemplateCss } from './render/templates.js';
+import { escapeHtml, displayNameFromDir, toSlug } from './format-utils.js';
 import { buildProjectRenderData, buildSessionRenderData, buildSessionCard, } from './render/build-render-data.js';
 import { mergeActiveIntervals, sumIntervalMs } from './bridge.js';
 import { SCREENSHOTS_DIR } from './screenshot.js';
@@ -42,7 +43,7 @@ function resolveScreenshotDataUri(dirName, cache) {
         return `data:image/png;base64,${b64}`;
     }
     // Try local screenshot file
-    const slug = dirName.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
+    const slug = toSlug(dirName);
     const screenshotPath = join(SCREENSHOTS_DIR, `${slug}.png`);
     if (existsSync(screenshotPath)) {
         const buf = readFileSync(screenshotPath);
@@ -220,16 +221,19 @@ export async function exportHtml(dirName, cache, sessions, outputPath, username
             sourceTool: session.source ?? 'unknown',
         });
     });
-    // Compute stats the same way the dashboard does
+    // Prefer DB-computed stats from opts (includes subagent data); fall back to session-based computation
     const totalLoc = sessions.reduce((sum, s) => sum + s.linesOfCode, 0);
     const totalDurationMinutes = computeMergedSessionDuration(sessions);
     const totalFilesChanged = opts?.totalFilesChanged ?? new Set(sessions.flatMap(s => s.filesChanged.map(f => f.path))).size;
-    // Agent duration: sum child durations across all orchestrated sessions
-    const totalAgentMinutes = sessions
-        .filter((s) => s.isOrchestrated && s.children)
-        .reduce((sum, s) => sum + s.children.reduce((cs, c) => cs + c.durationMinutes, 0), 0);
-    const totalAgentDurationMinutes = totalAgentMinutes > 0 ? totalDurationMinutes + totalAgentMinutes : undefined;
-    const totalTokens = sessions.reduce((sum, s) => sum + (s.tokenUsage?.input ?? 0) + (s.tokenUsage?.output ?? 0), 0) || undefined;
+    const totalAgentDurationMinutes = opts?.totalAgentDurationMinutes ?? (() => {
+        const agentMin = sessions
+            .filter((s) => s.isOrchestrated && s.children)
+            .reduce((sum, s) => sum + s.children.reduce((cs, c) => cs + c.durationMinutes, 0), 0);
+        return agentMin > 0 ? totalDurationMinutes + agentMin : undefined;
+    })();
+    const totalTokens = (opts?.totalInputTokens || opts?.totalOutputTokens)
+        ? (opts.totalInputTokens ?? 0) + (opts.totalOutputTokens ?? 0) || undefined
+        : sessions.reduce((sum, s) => sum + (s.tokenUsage?.input ?? 0) + (s.tokenUsage?.output ?? 0), 0) || undefined;
     // Resolve screenshot for embedding
     const screenshotUrl = resolveScreenshotDataUri(dirName, cache);
     // Render project index.html — pass same data shape as dashboard
@@ -256,12 +260,14 @@ export async function exportHtml(dirName, cache, sessions, outputPath, username
         sessionCards,
         sessionBaseUrl: './sessions',
     });
+    const templateName = resolveTemplate(undefined, getDefaultTemplate());
     const projectBody = renderProjectHtml(projectRenderData, {
         arc: result.arc,
         fullSessions: sessions,
-    });
+    }, templateName);
     const projectHtml = buildStandalonePage(title, projectBody, {
         description: result.narrative?.slice(0, 200) || undefined,
+        templateName,
     });
     totalBytes += writeAndTrack(join(outputPath, 'index.html'), projectHtml, files);
     // Render session pages — only featured sessions (linked from project page)
@@ -279,10 +285,11 @@ export async function exportHtml(dirName, cache, sessions, outputPath, username
             projectSlug: slug,
             sessionSlug,
             sourceTool: session.source ?? 'unknown',
+            template: templateName,
         });
-        const sessionBody = renderSessionHtml(renderData);
+        const sessionBody = renderSessionHtml(renderData, templateName);
         const sessionDesc = (enhanced?.developerTake ?? session.developerTake ?? '').slice(0, 200) || undefined;
-        const sessionHtml = buildStandalonePage(session.title, sessionBody, { description: sessionDesc });
+        const sessionHtml = buildStandalonePage(session.title, sessionBody, { description: sessionDesc, templateName });
         totalBytes += writeAndTrack(join(sessionsDir, `${sessionSlug}.html`), sessionHtml, files);
     }
     return { files, totalBytes, outputPath };
@@ -318,11 +325,15 @@ function buildProjectRenderInputs(dirName, cache, sessions, username, opts) {
     const totalLoc = sessions.reduce((sum, s) => sum + s.linesOfCode, 0);
     const totalDurationMinutes = computeMergedSessionDuration(sessions);
     const totalFilesChanged = opts?.totalFilesChanged ?? new Set(sessions.flatMap(s => s.filesChanged.map(f => f.path))).size;
-    const totalAgentMinutes = sessions
-        .filter((s) => s.isOrchestrated && s.children)
-        .reduce((sum, s) => sum + s.children.reduce((cs, c) => cs + c.durationMinutes, 0), 0);
-    const totalAgentDurationMinutes = totalAgentMinutes > 0 ? totalDurationMinutes + totalAgentMinutes : undefined;
-    const totalTokens = sessions.reduce((sum, s) => sum + (s.tokenUsage?.input ?? 0) + (s.tokenUsage?.output ?? 0), 0) || undefined;
+    const totalAgentDurationMinutes = opts?.totalAgentDurationMinutes ?? (() => {
+        const agentMin = sessions
+            .filter((s) => s.isOrchestrated && s.children)
+            .reduce((sum, s) => sum + s.children.reduce((cs, c) => cs + c.durationMinutes, 0), 0);
+        return agentMin > 0 ? totalDurationMinutes + agentMin : undefined;
+    })();
+    const totalTokens = (opts?.totalInputTokens || opts?.totalOutputTokens)
+        ? (opts.totalInputTokens ?? 0) + (opts.totalOutputTokens ?? 0) || undefined
+        : sessions.reduce((sum, s) => sum + (s.tokenUsage?.input ?? 0) + (s.tokenUsage?.output ?? 0), 0) || undefined;
     return { result, slug, title, sessionCards, totalLoc, totalDurationMinutes, totalAgentDurationMinutes, totalFilesChanged, totalTokens };
 }
 /**
@@ -346,15 +357,17 @@ export function generateProjectHtmlFragment(dirName, cache, sessions, username =
         totalLoc, totalDurationMinutes, totalAgentDurationMinutes, totalFilesChanged, totalTokens,
         sessionCards,
     });
+    const templateName = resolveTemplate(undefined, getDefaultTemplate());
     return renderProjectHtml(renderData, {
         arc: result.arc,
         fullSessions: sessions,
-    });
+    }, templateName);
 }
 export function generateHtmlFiles(dirName, cache, sessions, username = 'local', opts) {
     const files = [];
     const { result, slug, title, sessionCards, totalLoc, totalDurationMinutes, totalAgentDurationMinutes, totalFilesChanged, totalTokens } = buildProjectRenderInputs(dirName, cache, sessions, username, opts);
     const screenshotUrl = resolveScreenshotDataUri(dirName, cache);
+    const templateName = resolveTemplate(undefined, getDefaultTemplate());
     const projectRenderData = buildProjectRenderData({
         username, slug, title,
         narrative: result.narrative,
@@ -371,9 +384,10 @@ export function generateHtmlFiles(dirName, cache, sessions, username = 'local',
     const projectBody = renderProjectHtml(projectRenderData, {
         arc: result.arc,
         fullSessions: sessions,
-    });
+    }, templateName);
     files.push({ path: 'index.html', content: buildStandalonePage(title, projectBody, {
             description: result.narrative?.slice(0, 200) || undefined,
+            templateName,
         }) });
     const featuredSessions = pickFeaturedSessions(sessions, cache);
     for (const session of featuredSessions) {
@@ -384,12 +398,13 @@ export function generateHtmlFiles(dirName, cache, sessions, username = 'local',
             session, enhanced, username,
             projectSlug: slug, sessionSlug,
             sourceTool: session.source ?? 'unknown',
+            template: templateName,
         });
-        const sessionBody = renderSessionHtml(renderData);
+        const sessionBody = renderSessionHtml(renderData, templateName);
         const sessionDesc = (enhanced?.developerTake ?? session.developerTake ?? '').slice(0, 200) || undefined;
         files.push({
             path: `sessions/${sessionSlug}.html`,
-            content: buildStandalonePage(session.title, sessionBody, { description: sessionDesc }),
+            content: buildStandalonePage(session.title, sessionBody, { description: sessionDesc, templateName }),
         });
     }
     return files;
@@ -490,9 +505,9 @@ function getInlineMountJs() {
     }
 }
 function buildStandalonePage(title, bodyHtml, opts) {
-    const css = getInlineCss();
+    const css = opts?.templateName ? getTemplateCss(opts.templateName) : getInlineCss();
     const cssTag = css
-        ? `<style>${css}\nbody { overflow: auto !important; min-height: auto !important; background: var(--color-surface, #f8f9fb); }</style>`
+        ? `<style>${css}\nbody { overflow: auto !important; min-height: auto !important; }\n#root { min-height: auto !important; }</style>`
         : '';
     const mountJs = getInlineMountJs();
     const scriptTag = mountJs ? `<script>${mountJs}</script>` : '';
@@ -516,7 +531,7 @@ function buildStandalonePage(title, bodyHtml, opts) {
   ${ogTags}
   <link rel="preconnect" href="https://fonts.googleapis.com" />
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
-  <link href="https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;500;600;700&family=Inter:wght@400;500;600;700&family=Space+Grotesk:wght@400;500;600;700&display=swap" rel="stylesheet" />
+  <link href="https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;500;600;700&family=Inter:wght@400;500;600;700&family=Space+Grotesk:wght@400;500;600;700&family=Cormorant+Garamond:ital,wght@0,400;0,600;1,400&family=Newsreader:ital,wght@0,400;0,600;1,400&display=swap" rel="stylesheet" />
   ${cssTag}
 </head>
 <body>

package/dist/format-utils.js

@@ -16,6 +16,11 @@ export function displayNameFromDir(dirName) {
     const segments = dirName.split('-').filter(Boolean);
     return segments.length > 0 ? segments[segments.length - 1] : dirName;
 }
+/** Generate a URL-safe slug from a string. */
+export function toSlug(s, maxLen) {
+    const slug = s.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
+    return maxLen !== undefined ? slug.slice(0, maxLen) : slug;
+}
 /** Escape LIKE wildcards in user input for safe use in SQL LIKE clauses. */
 export function escapeLikeWildcards(str) {
     return str.replace(/[%_]/g, (c) => `\\${c}`);

package/dist/index.js

@@ -650,6 +650,174 @@ daemon
     }
     console.log('\n  Daemon uninstalled.\n');
 });
+// ── Embed command ──────────────────────────────────────────
+program
+    .command('embed')
+    .description('Generate embeddable widget snippets for your portfolio and projects')
+    .option('--project <name>', 'Generate embed for a specific project')
+    .option('--format <type>', 'Output format: widget, iframe, badge, html, or all', '')
+    .option('--sections <list>', 'Sections to include (comma-separated: stats,tools,skills,heatmap,recent)', 'stats')
+    .option('--theme <theme>', 'Color theme (dark or light)', 'dark')
+    .action(async (opts) => {
+    const { getAuthToken } = await import('./auth.js');
+    const { PUBLIC_URL } = await import('./config.js');
+    const { getUploadedState, getDataDir } = await import('./settings.js');
+    const { displayNameFromDir } = await import('./sync.js');
+    const { readdirSync, existsSync } = await import('node:fs');
+    const { join } = await import('node:path');
+    const auth = getAuthToken();
+    const username = auth?.username;
+    const sections = opts.sections || 'stats';
+    const theme = opts.theme || 'dark';
+    const queryParts = [];
+    if (sections !== 'stats')
+        queryParts.push(`sections=${sections}`);
+    if (theme !== 'dark')
+        queryParts.push(`theme=${theme}`);
+    const query = queryParts.length > 0 ? `?${queryParts.join('&')}` : '';
+    // Find published projects
+    const publishedDir = join(getDataDir(), 'published');
+    const publishedProjects = [];
+    if (existsSync(publishedDir)) {
+        for (const file of readdirSync(publishedDir)) {
+            if (!file.endsWith('.json'))
+                continue;
+            const dirName = file.replace(/\.json$/, '');
+            const state = getUploadedState(dirName);
+            if (state?.slug) {
+                publishedProjects.push({ dirName, slug: state.slug });
+            }
+        }
+    }
+    const isPublished = username && publishedProjects.length > 0;
+    const format = opts.format || (isPublished ? 'all' : 'html');
+    // Build local stats for static HTML
+    const db = openDatabase();
+    await syncSessionIndex(db);
+    const { getAllProjectStats } = await import('./db.js');
+    const allStats = getAllProjectStats(db);
+    if (opts.project) {
+        const match = publishedProjects.find((p) => p.slug === opts.project || p.dirName === opts.project || displayNameFromDir(p.dirName) === opts.project);
+        const localMatch = allStats.find((p) => p.projectName === opts.project || p.projectDir === opts.project || displayNameFromDir(p.projectDir) === opts.project);
+        if (!match && !localMatch) {
+            console.log(`\n  Project "${opts.project}" not found.`);
+            if (allStats.length > 0) {
+                console.log('  Available projects:');
+                for (const p of allStats)
+                    console.log(`    ${p.projectName}`);
+            }
+            console.log('');
+            db.close();
+            return;
+        }
+        const base = match && username ? `${PUBLIC_URL}/${username}/${match.slug}` : null;
+        const stats = localMatch || (match ? allStats.find((p) => displayNameFromDir(p.projectDir) === displayNameFromDir(match.dirName)) : null);
+        const title = stats?.projectName || match?.slug || opts.project;
+        console.log('');
+        console.log(`  ── ${title} ──────────────────────────────`);
+        printFormats(format, base, query, sections, theme, stats ? {
+            name: stats.projectName,
+            sessions: stats.sessionCount,
+            loc: stats.totalLoc,
+            duration: stats.totalDuration,
+            skills: stats.skills,
+        } : null);
+    }
+    else {
+        // Portfolio level
+        const base = username ? `${PUBLIC_URL}/${username}` : null;
+        // Aggregate stats across all projects
+        const totalSessions = allStats.reduce((s, p) => s + p.sessionCount, 0);
+        const totalLoc = allStats.reduce((s, p) => s + p.totalLoc, 0);
+        const totalDuration = allStats.reduce((s, p) => s + p.totalDuration, 0);
+        const allSkills = [...new Set(allStats.flatMap((p) => p.skills))].slice(0, 8);
+        console.log('');
+        console.log('  ── Portfolio ──────────────────────────────────');
+        printFormats(format, base, query, sections, theme, {
+            name: username || 'portfolio',
+            sessions: totalSessions,
+            loc: totalLoc,
+            duration: totalDuration,
+            skills: allSkills,
+            projectCount: allStats.length,
+        });
+        // Also show each published project
+        if (format !== 'html' && publishedProjects.length > 0) {
+            for (const p of publishedProjects) {
+                const projBase = `${PUBLIC_URL}/${username}/${p.slug}`;
+                const stats = allStats.find((s) => displayNameFromDir(s.projectDir) === displayNameFromDir(p.dirName));
+                console.log(`  ── ${p.slug} ──────────────────────────────`);
+                printFormats(format, projBase, query, sections, theme, stats ? {
+                    name: stats.projectName,
+                    sessions: stats.sessionCount,
+                    loc: stats.totalLoc,
+                    duration: stats.totalDuration,
+                    skills: stats.skills,
+                } : null);
+            }
+        }
+    }
+    db.close();
+});
+function printFormats(format, base, query, _sections, _theme, stats) {
+    const showAll = format === 'all';
+    if (base && (showAll || format === 'badge')) {
+        console.log('');
+        console.log('  Badge (GitHub README, markdown):');
+        console.log(`    [![heyi.am](${base}/embed.svg)](${base})`);
+        console.log('');
+    }
+    if (base && (showAll || format === 'widget')) {
+        const dataAttrs = [`data-username="${base.split('/').slice(-2, -1)[0] || ''}"`,];
+        // If it's a project URL (3+ path segments after domain), add data-project
+        const pathParts = new URL(base).pathname.split('/').filter(Boolean);
+        if (pathParts.length >= 2)
+            dataAttrs.push(`data-project="${pathParts[1]}"`);
+        if (_sections !== 'stats')
+            dataAttrs.push(`data-sections="${_sections}"`);
+        if (_theme !== 'dark')
+            dataAttrs.push(`data-theme="${_theme}"`);
+        console.log('  Widget (personal site, blog):');
+        console.log(`    <div class="heyiam-embed" ${dataAttrs.join(' ')}></div>`);
+        console.log(`    <script src="${new URL(base).origin}/embed.js"></script>`);
+        console.log('');
+    }
+    if (base && (showAll || format === 'iframe')) {
+        console.log('  iframe:');
+        console.log(`    <iframe src="${base}/embed${query}" width="480" height="200" frameborder="0"></iframe>`);
+        console.log('');
+    }
+    if (showAll || format === 'html') {
+        if (stats) {
+            const durationStr = stats.duration >= 60 ? `${Math.round(stats.duration / 60)}h` : `${stats.duration}m`;
+            const locStr = stats.loc >= 1000 ? `${(stats.loc / 1000).toFixed(1)}k` : String(stats.loc);
+            const skillChips = stats.skills.slice(0, 6).map((s) => `<span style="font-size:10px;padding:2px 8px;border-radius:3px;background:#1f2937;color:#9ca3af">${s}</span>`).join(' ');
+            const projectLine = stats.projectCount ? `<span style="font-size:10px;color:#6b7280">${stats.projectCount} projects</span>` : '';
+            console.log('  Static HTML (works anywhere, no JS needed):');
+            console.log(`    <div style="font-family:ui-monospace,monospace;background:#0a0a0f;color:#e5e7eb;padding:16px 20px;border-radius:6px">`);
+            console.log(`      <div style="font-size:15px;font-weight:600;color:#f9fafb;margin-bottom:12px">${stats.name} ${projectLine}</div>`);
+            console.log(`      <div style="display:flex;gap:20px;flex-wrap:wrap;margin-bottom:10px">`);
+            console.log(`        <div><div style="font-size:18px;font-weight:700;color:#f9fafb">${stats.sessions}</div><div style="font-size:10px;color:#6b7280;text-transform:uppercase;letter-spacing:0.08em">Sessions</div></div>`);
+            console.log(`        <div><div style="font-size:18px;font-weight:700;color:#f9fafb">${locStr}</div><div style="font-size:10px;color:#6b7280;text-transform:uppercase;letter-spacing:0.08em">Lines Changed</div></div>`);
+            console.log(`        <div><div style="font-size:18px;font-weight:700;color:#f9fafb">${durationStr}</div><div style="font-size:10px;color:#6b7280;text-transform:uppercase;letter-spacing:0.08em">Active Time</div></div>`);
+            console.log(`      </div>`);
+            if (skillChips) {
+                console.log(`      <div style="display:flex;gap:6px;flex-wrap:wrap">${skillChips}</div>`);
+            }
+            console.log(`    </div>`);
+            console.log('');
+        }
+        else {
+            console.log('  Static HTML: No local stats available for this project.');
+            console.log('');
+        }
+    }
+    if (!base && format !== 'html') {
+        console.log('  Not published yet. Only static HTML is available.');
+        console.log('  Publish from the dashboard, then run again for badge/widget/iframe.');
+        console.log('');
+    }
+}
 // ── Logout command ──────────────────────────────────────────
 program
     .command('logout')