heyiam 0.1.7 → 0.1.9

package/dist/render/liquid.js

@@ -0,0 +1,149 @@
+/**
+ * Liquid template engine for static HTML rendering.
+ *
+ * Replaces React SSR (ReactDOMServer.renderToStaticMarkup) with
+ * liquidjs sync rendering. Templates live in ./templates/*.liquid.
+ */
+import { Liquid } from 'liquidjs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const engine = new Liquid({
+    root: resolve(__dirname, 'templates'),
+    extname: '.liquid',
+    outputEscape: 'escape',
+});
+// ── Custom filters ───────────────────────────────────────────
+engine.registerFilter('formatDuration', (minutes) => {
+    if (minutes < 60)
+        return `${Math.round(minutes)}m`;
+    const hours = minutes / 60;
+    return hours >= 10 ? `${Math.round(hours)}h` : `${hours.toFixed(1)}h`;
+});
+engine.registerFilter('formatLoc', (loc) => {
+    return loc >= 1000 ? `${(loc / 1000).toFixed(1)}k` : String(loc);
+});
+engine.registerFilter('formatDate', (iso) => {
+    if (!iso)
+        return '';
+    try {
+        return new Date(iso).toLocaleDateString('en-US', {
+            month: 'short',
+            day: 'numeric',
+            year: 'numeric',
+        });
+    }
+    catch {
+        return iso;
+    }
+});
+engine.registerFilter('formatDateShort', (iso) => {
+    if (!iso)
+        return '';
+    try {
+        return new Date(iso).toLocaleDateString('en-US', {
+            month: 'short',
+            day: 'numeric',
+        });
+    }
+    catch {
+        return iso;
+    }
+});
+engine.registerFilter('jsonAttr', (value) => {
+    return JSON.stringify(value);
+});
+engine.registerFilter('localeNumber', (value) => {
+    return value.toLocaleString();
+});
+engine.registerFilter('stripProtocol', (url) => {
+    return (url || '').replace(/^https?:\/\/(www\.)?/, '').replace(/\.git$/, '');
+});
+// Duration color cycling for session cards
+const DURATION_COLORS = ['primary', 'green', 'violet'];
+engine.registerFilter('durationColor', (index) => {
+    return DURATION_COLORS[index % DURATION_COLORS.length];
+});
+export function renderProject(data, extras) {
+    // Pre-compute derived data for the template
+    const allSessions = data.allSessions || data.sessions;
+    const sourceCounts = {};
+    for (const s of data.sessions) {
+        const src = s.sourceTool || 'unknown';
+        sourceCounts[src] = (sourceCounts[src] || 0) + 1;
+    }
+    // Use full session data when available (charts need complete Session objects).
+    // Strip rawLog and turnTimeline — huge, unused by charts, and could break HTML attributes.
+    const chartSessions = (extras?.fullSessions ?? allSessions.map((s) => ({
+        id: s.token, title: s.title, date: s.recordedAt,
+        durationMinutes: s.durationMinutes, turns: s.turns,
+        linesOfCode: s.locChanged, status: 'enhanced',
+        projectName: data.project.title, rawLog: [],
+        skills: s.skills, source: s.sourceTool,
+        filesChanged: s.filesChanged,
+    }))).map((s) => {
+        const { rawLog, turnTimeline, ...rest } = s;
+        return { ...rest, rawLog: [] };
+    });
+    // Encode JSON safe for single-quoted HTML attributes
+    const sessionsJson = JSON.stringify(chartSessions).replace(/'/g, '&#39;');
+    const growthJson = sessionsJson; // same data for both charts
+    const durationLabel = data.project.totalAgentDurationMinutes ? 'You / Agents' : 'Time';
+    // Pick featured sessions — same logic as ProjectDetail.tsx
+    const featuredSessionIds = new Set();
+    for (const t of data.project.timeline || []) {
+        for (const s of t.sessions || []) {
+            if (s.featured) {
+                featuredSessionIds.add(s.sessionId);
+            }
+        }
+    }
+    // Use fullSessions (has status field) for selection, map back to SessionCard for display
+    const fullList = extras?.fullSessions ?? [];
+    const fullById = new Map(fullList.map((s) => [s.id, s]));
+    const cardById = new Map(data.sessions.map((s) => [s.token, s]));
+    // Same logic as ProjectDetail.tsx:
+    // 1. Featured flag from timeline
+    const featuredCards = data.sessions.filter((s) => featuredSessionIds.has(s.token));
+    if (featuredCards.length >= 6) {
+        // enough
+    }
+    // 2. Enhanced sessions (status !== 'draft'), sorted by LOC desc
+    const enhancedCards = data.sessions
+        .filter((s) => {
+        if (featuredSessionIds.has(s.token))
+            return false;
+        const full = fullById.get(s.token);
+        return full && (full.status === 'enhanced' || full.status === 'uploaded');
+    })
+        .sort((a, b) => b.locChanged - a.locChanged);
+    // 3. Draft sessions as fallback
+    const draftCards = data.sessions
+        .filter((s) => {
+        if (featuredSessionIds.has(s.token))
+            return false;
+        const full = fullById.get(s.token);
+        return !full || full.status === 'draft';
+    });
+    const combined = [...featuredCards, ...enhancedCards, ...draftCards];
+    const seen = new Set();
+    const featuredSessions = combined.filter((s) => {
+        if (seen.has(s.token))
+            return false;
+        seen.add(s.token);
+        return true;
+    }).slice(0, 6);
+    return engine.renderFileSync('project', {
+        ...data,
+        arc: extras?.arc ?? [],
+        featuredSessions,
+        sourceCounts: Object.entries(sourceCounts).map(([tool, count]) => ({ tool, count })),
+        sessionsJson,
+        growthJson,
+        durationLabel,
+    });
+}
+export function renderSession(data) {
+    return engine.renderFileSync('session', data);
+}
+//# sourceMappingURL=liquid.js.map

package/dist/render/liquid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"liquid.js","sourceRoot":"","sources":["../../src/render/liquid.ts"],"names":[],"mappings":"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"}

package/dist/render/types.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Render data types for static HTML generation.
+ *
+ * These interfaces define the data shapes that the CLI render functions
+ * accept. They are intentionally separate from the interactive UI types
+ * in `app/src/types.ts` — the render pipeline owns its own contract.
+ */
+import type { AgentSummary } from '../routes/context.js';
+export interface UserInfo {
+    username: string;
+    accent: string;
+}
+export interface PortfolioUser extends UserInfo {
+    displayName: string;
+    bio: string;
+    location: string;
+    status: string;
+}
+export interface PortfolioProject {
+    slug: string;
+    title: string;
+    narrative: string;
+    totalSessions: number;
+    totalLoc: number;
+    totalDurationMinutes: number;
+    totalFilesChanged: number;
+    skills: string[];
+    publishedCount: number;
+}
+export interface PortfolioRenderData {
+    user: PortfolioUser;
+    projects: PortfolioProject[];
+}
+export interface ProjectTimeline {
+    period: string;
+    label: string;
+    sessions: Array<Record<string, unknown>>;
+}
+export interface ProjectDetail {
+    slug: string;
+    title: string;
+    narrative: string;
+    repoUrl?: string;
+    projectUrl?: string;
+    screenshotUrl?: string;
+    timeline: ProjectTimeline[];
+    skills: string[];
+    totalSessions: number;
+    totalLoc: number;
+    totalDurationMinutes: number;
+    totalAgentDurationMinutes?: number;
+    totalFilesChanged: number;
+}
+export interface SessionCard {
+    token: string;
+    slug: string;
+    title: string;
+    devTake: string;
+    durationMinutes: number;
+    turns: number;
+    locChanged: number;
+    filesChanged: number;
+    skills: string[];
+    recordedAt: string;
+    sourceTool: string;
+    agentSummary?: AgentSummary;
+}
+export interface ProjectRenderData {
+    user: UserInfo;
+    project: ProjectDetail;
+    /** Curated sessions for the card grid */
+    sessions: SessionCard[];
+    /** All sessions for work timeline and growth chart (falls back to sessions if not set) */
+    allSessions?: SessionCard[];
+    /** Base URL for session links. Defaults to /:username/:project */
+    sessionBaseUrl?: string;
+}
+export interface Beat {
+    stepNumber: number;
+    title: string;
+    body: string;
+}
+export interface QaPair {
+    question: string;
+    answer: string;
+}
+export interface ToolBreakdownEntry {
+    tool: string;
+    count: number;
+}
+export interface FileEntry {
+    path: string;
+    additions: number;
+    deletions: number;
+}
+export interface SessionDetail {
+    token: string;
+    title: string;
+    devTake: string;
+    context?: string;
+    durationMinutes: number;
+    turns: number;
+    filesChanged: number;
+    locChanged: number;
+    skills: string[];
+    narrative?: string;
+    beats?: Beat[];
+    qaPairs?: QaPair[];
+    highlights?: string[];
+    toolBreakdown?: ToolBreakdownEntry[];
+    topFiles?: FileEntry[];
+    recordedAt: string;
+    sourceTool: string;
+    template: string;
+    agentSummary?: AgentSummary;
+}
+export interface SessionRenderData {
+    user: UserInfo;
+    projectSlug?: string;
+    session: SessionDetail;
+}

package/dist/render/types.js

@@ -0,0 +1,9 @@
+/**
+ * Render data types for static HTML generation.
+ *
+ * These interfaces define the data shapes that the CLI render functions
+ * accept. They are intentionally separate from the interactive UI types
+ * in `app/src/types.ts` — the render pipeline owns its own contract.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/render/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/render/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/routes/archive.d.ts

@@ -0,0 +1,3 @@
+import { Router } from 'express';
+import type { RouteContext } from './context.js';
+export declare function createArchiveRouter(ctx: RouteContext): Router;

package/dist/routes/archive.js

@@ -0,0 +1,56 @@
+import { Router } from 'express';
+import { archiveSessionFiles } from '../archive.js';
+import { getSourceAudit, getArchiveStats } from '../source-audit.js';
+export function createArchiveRouter(ctx) {
+    const router = Router();
+    router.get('/api/source-audit', async (_req, res) => {
+        try {
+            const result = await getSourceAudit();
+            res.json(result);
+        }
+        catch (err) {
+            console.error('[source-audit]', err.message);
+            res.status(500).json({ error: 'Source audit failed' });
+        }
+    });
+    router.get('/api/archive/stats', async (_req, res) => {
+        try {
+            const stats = await getArchiveStats();
+            res.json(stats);
+        }
+        catch (err) {
+            console.error('[archive-stats]', err.message);
+            res.status(500).json({ error: 'Archive stats failed' });
+        }
+    });
+    router.get('/api/archive/health', async (_req, res) => {
+        try {
+            const audit = await getSourceAudit();
+            const health = audit.sources.map((s) => ({
+                name: s.name,
+                health: s.health,
+                retentionRisk: s.retentionRisk ?? null,
+            }));
+            res.json({ sources: health });
+        }
+        catch (err) {
+            console.error('[archive-health]', err.message);
+            res.status(500).json({ error: 'Archive health failed' });
+        }
+    });
+    router.post('/api/archive/sync', async (_req, res) => {
+        try {
+            // Get session list from SQLite (fast), then archive their files
+            const projects = await ctx.getProjects();
+            const allSessions = projects.flatMap((p) => p.sessions);
+            const result = await archiveSessionFiles(allSessions);
+            res.json({ archived: result.archived, alreadyArchived: result.alreadyArchived });
+        }
+        catch (err) {
+            console.error('[archive-sync]', err.message);
+            res.status(500).json({ error: 'Archive sync failed' });
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=archive.js.map

package/dist/routes/archive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.js","sourceRoot":"","sources":["../../src/routes/archive.ts"],"names":[],"mappings":"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"}

package/dist/routes/auth.d.ts

@@ -0,0 +1,3 @@
+import { Router } from 'express';
+import type { RouteContext } from './context.js';
+export declare function createAuthRouter(_ctx: RouteContext): Router;

package/dist/routes/auth.js

@@ -0,0 +1,116 @@
+import { Router } from 'express';
+import { checkAuthStatus, saveAuthToken } from '../auth.js';
+import { API_URL } from '../config.js';
+export function createAuthRouter(_ctx) {
+    const router = Router();
+    router.get('/api/auth/status', async (_req, res) => {
+        try {
+            const status = await checkAuthStatus(API_URL);
+            res.json(status);
+        }
+        catch {
+            res.json({ authenticated: false });
+        }
+    });
+    // Start device auth flow -- proxy to Phoenix
+    router.post('/api/auth/login', async (_req, res) => {
+        try {
+            const response = await fetch(`${API_URL}/api/device/code`, { method: 'POST' });
+            if (!response.ok) {
+                res.status(response.status).json({ error: 'Failed to start device auth' });
+                return;
+            }
+            const data = await response.json();
+            res.json(data);
+        }
+        catch (err) {
+            console.error('[auth/login] EXCEPTION:', err);
+            res.status(500).json({ error: 'Device auth request failed' });
+        }
+    });
+    // Check username availability — proxy to Phoenix
+    router.get('/api/auth/check-username', async (req, res) => {
+        try {
+            const username = req.query.username;
+            if (!username || username.length < 2) {
+                res.json({ available: false, reason: 'Username must be at least 2 characters' });
+                return;
+            }
+            if (!/^[a-z0-9](?:[a-z0-9_-]*[a-z0-9])?$/i.test(username)) {
+                res.json({ available: false, reason: 'Letters, numbers, hyphens, and underscores only' });
+                return;
+            }
+            const response = await fetch(`${API_URL}/api/username/check?username=${encodeURIComponent(username)}`);
+            if (response.ok) {
+                const data = await response.json();
+                res.json(data);
+            }
+            else {
+                // If Phoenix doesn't have this endpoint yet, assume available
+                res.json({ available: true });
+            }
+        }
+        catch {
+            // Phoenix not reachable — assume available for now, signup will validate
+            res.json({ available: true });
+        }
+    });
+    // Start device auth with a preferred username
+    router.post('/api/auth/signup', async (req, res) => {
+        try {
+            const username = req.body?.username;
+            const response = await fetch(`${API_URL}/api/device/code`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(username ? { preferred_username: username } : {}),
+            });
+            if (!response.ok) {
+                res.status(response.status).json({ error: 'Failed to start device auth' });
+                return;
+            }
+            const data = await response.json();
+            // Build signup URL: registration page with device code + username pre-filled
+            // After registration, Phoenix should redirect to /device?code=xxx to authorize
+            const baseUrl = new URL(data.verification_uri).origin;
+            const params = new URLSearchParams();
+            if (data.user_code)
+                params.set('device_code', data.user_code);
+            if (username)
+                params.set('username', username);
+            const signupUri = `${baseUrl}/users/register?${params.toString()}`;
+            res.json({ ...data, verification_uri: signupUri });
+        }
+        catch (err) {
+            console.error('[auth/signup] EXCEPTION:', err);
+            res.status(500).json({ error: 'Signup request failed' });
+        }
+    });
+    // Poll for device authorization completion
+    router.post('/api/auth/poll', async (req, res) => {
+        try {
+            const deviceCode = req.body?.device_code;
+            if (!deviceCode) {
+                res.status(400).json({ error: 'Missing device_code' });
+                return;
+            }
+            const response = await fetch(`${API_URL}/api/device/token`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ device_code: deviceCode }),
+            });
+            const data = await response.json();
+            if (response.ok && data.access_token) {
+                saveAuthToken(data.access_token, data.username);
+                res.json({ authenticated: true, username: data.username });
+            }
+            else {
+                res.status(response.status).json(data);
+            }
+        }
+        catch {
+            res.status(500).json({ error: 'Poll failed' });
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=auth.js.map

package/dist/routes/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/routes/auth.ts"],"names":[],"mappings":"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"}

package/dist/routes/context.d.ts

@@ -0,0 +1,76 @@
+import type Database from 'better-sqlite3';
+import { type SessionMeta } from '../parsers/index.js';
+import { type Session } from '../analyzer.js';
+import { displayNameFromDir } from '../sync.js';
+export { displayNameFromDir };
+export interface ProjectInfo {
+    name: string;
+    dirName: string;
+    sessionCount: number;
+    sessions: SessionMeta[];
+}
+export interface SessionStats {
+    loc: number;
+    duration: number;
+    files: number;
+    turns: number;
+    skills: string[];
+    date: string;
+    /** End time as ISO string (for interval merging of concurrent sessions) */
+    endTime?: string;
+}
+import { escapeHtml } from '../format-utils.js';
+export { escapeHtml };
+export interface AgentSummary {
+    is_orchestrated: true;
+    agents: Array<{
+        role: string;
+        duration_minutes: number;
+        loc_changed: number;
+    }>;
+}
+/**
+ * Build an agent summary from child session metas. Returns null when
+ * there are no children (or none produce valid stats).
+ *
+ * @param childMetas  - Array of child SessionMeta objects
+ * @param resolveStats - Async function that returns { duration, loc } for a child meta
+ * @param options.deduplicate - When true, only the first occurrence of each role is kept
+ */
+export declare function buildAgentSummary(childMetas: SessionMeta[], resolveStats: (child: SessionMeta) => Promise<{
+    duration: number;
+    loc: number;
+}>, options?: {
+    deduplicate?: boolean;
+}): Promise<AgentSummary | null>;
+/**
+ * RouteContext bundles the database handle and helper closures that
+ * every router needs. Created once in createApp() and passed to each
+ * router factory.
+ */
+export interface RouteContext {
+    db: Database.Database;
+    sessionsBasePath: string | undefined;
+    getProjects: () => Promise<ProjectInfo[]>;
+    loadSession: (sessionPath: string, projectName: string, sessionId: string) => Promise<Session>;
+    getSessionStats: (meta: SessionMeta, projectName: string) => Promise<SessionStats>;
+    mergeSessionIntervals: (stats: SessionStats[]) => number;
+    getProjectWithStats: (proj: ProjectInfo) => Promise<Record<string, unknown>>;
+    buildPreviewPage: (title: string, bodyHtml: string, banner?: string) => string;
+}
+/**
+ * Build the canonical session list for a project from DB rows + enhanced data.
+ * Used by both the dashboard detail endpoint and the export routes so the two
+ * never diverge.
+ */
+export declare function buildSessionList(db: Database.Database, dirName: string, projectName: string): Session[];
+/**
+ * Build the full project detail response — identical data for both the
+ * dashboard API endpoint and the HTML export. Single source of truth.
+ */
+export declare function buildProjectDetail(db: Database.Database, proj: ProjectInfo): {
+    project: Record<string, unknown>;
+    sessions: Session[];
+    enhanceCache: unknown;
+};
+export declare function createRouteContext(sessionsBasePath?: string, dbPath?: string): RouteContext;