heyiam 0.1.0

package/dist/summarize.js

@@ -0,0 +1,312 @@
+import Anthropic from '@anthropic-ai/sdk';
+// ── Banned words (anti-fluff enforcement) ────────────────────
+const BANNED_WORDS = ['leverage', 'utilize', 'streamline', 'enhance', 'robust', 'seamless'];
+const BANNED_PATTERN = new RegExp(`\\b(${BANNED_WORDS.join('|')})\\b`, 'gi');
+export function containsBannedWords(text) {
+    const matches = text.match(BANNED_PATTERN);
+    return matches ? [...new Set(matches.map((m) => m.toLowerCase()))] : [];
+}
+export function stripBannedWords(text) {
+    return text.replace(BANNED_PATTERN, '').replace(/\s{2,}/g, ' ').trim();
+}
+// ── Signal-weighted sampling ─────────────────────────────────
+const SELF_CORRECTION_PATTERN = /\?|actually|wait|no,|wrong/i;
+const PASS_THROUGH_THRESHOLD = 50;
+// Slot allocation per third: [promptSlots, logSlots]
+const THIRD_SLOTS = [
+    [4, 10], // beginning
+    [8, 16], // middle
+    [8, 14], // end
+];
+export function scoreTurn(turn, allTurns, idx) {
+    let score = 0;
+    if (turn.type === 'prompt')
+        score += 1;
+    if (turn.type === 'error')
+        score += 1;
+    if (SELF_CORRECTION_PATTERN.test(turn.content))
+        score += 1;
+    if (turn.content.length > 200)
+        score += 1;
+    if (idx > 0 && allTurns[idx - 1].type === 'error')
+        score += 1;
+    return score;
+}
+function selectTopN(items, scores, n) {
+    if (items.length <= n)
+        return items;
+    const indexed = items.map((item, i) => ({ item, score: scores[i], idx: i }));
+    indexed.sort((a, b) => b.score - a.score || a.idx - b.idx);
+    const selected = indexed.slice(0, n);
+    selected.sort((a, b) => a.idx - b.idx);
+    return selected.map((s) => s.item);
+}
+export function sampleSession(session) {
+    const timeline = session.turnTimeline;
+    const rawLog = session.rawLog;
+    const total = timeline.length;
+    if (total <= PASS_THROUGH_THRESHOLD) {
+        return {
+            turns: timeline,
+            log: rawLog,
+            sampled: false,
+            totalTurns: total,
+            selectedTurns: total,
+        };
+    }
+    const scores = timeline.map((turn, idx) => scoreTurn(turn, timeline, idx));
+    const thirdSize = Math.floor(total / 3);
+    const thirds = [
+        [0, thirdSize],
+        [thirdSize, 2 * thirdSize],
+        [2 * thirdSize, total],
+    ];
+    const selectedTurns = [];
+    for (let t = 0; t < 3; t++) {
+        const [start, end] = thirds[t];
+        const [promptSlots, _logSlots] = THIRD_SLOTS[t];
+        const thirdTurns = timeline.slice(start, end);
+        const thirdScores = scores.slice(start, end);
+        const chosen = selectTopN(thirdTurns, thirdScores, promptSlots);
+        const chosenWithIdx = chosen.map((turn) => {
+            const origIdx = start + thirdTurns.indexOf(turn);
+            return { ...turn, _originalIdx: origIdx };
+        });
+        selectedTurns.push(...chosenWithIdx);
+    }
+    // Re-sort by original position (chronological)
+    selectedTurns.sort((a, b) => a._originalIdx - b._originalIdx);
+    const annotatedTurns = selectedTurns.map((t) => ({
+        timestamp: t.timestamp,
+        type: t.type,
+        content: `[T${t._originalIdx + 1}/${total}] ${t.content}`,
+    }));
+    // Sample raw log with same three-thirds approach using log slots
+    const logTotal = rawLog.length;
+    const logThirdSize = Math.floor(logTotal / 3);
+    const logThirds = [
+        [0, logThirdSize],
+        [logThirdSize, 2 * logThirdSize],
+        [2 * logThirdSize, logTotal],
+    ];
+    const selectedLogLines = [];
+    for (let t = 0; t < 3; t++) {
+        const [start, end] = logThirds[t];
+        const [_promptSlots, logSlots] = THIRD_SLOTS[t];
+        const chunk = rawLog.slice(start, end);
+        // For raw log, score by line length as a rough signal proxy
+        const chunkScores = chunk.map((line) => line.length);
+        const chosen = selectTopN(chunk, chunkScores, logSlots);
+        chosen.forEach((line) => {
+            const origIdx = start + chunk.indexOf(line);
+            selectedLogLines.push({ line, origIdx });
+        });
+    }
+    selectedLogLines.sort((a, b) => a.origIdx - b.origIdx);
+    const annotatedLog = selectedLogLines.map(({ line, origIdx }) => `[T${origIdx + 1}/${logTotal}] ${line}`);
+    return {
+        turns: annotatedTurns,
+        log: annotatedLog,
+        sampled: true,
+        totalTurns: total,
+        selectedTurns: annotatedTurns.length,
+    };
+}
+// ── Prompt construction ──────────────────────────────────────
+function buildSystemPrompt() {
+    return `You are a technical writing assistant for heyi.am, a platform where developers document AI coding sessions as case studies.
+
+Your job: turn raw session data into a sharp, honest summary that sounds like a dev explaining what happened to another dev in a standup. Not a blog post. Not a tutorial.
+
+HARD RULES:
+- NEVER use these words: ${BANNED_WORDS.join(', ')}. If you catch yourself writing one, rewrite the sentence.
+- Title: max 80 characters. Be specific about what was done. No clickbait.
+- Context: max 200 characters. What was the state before this session? What was broken or missing?
+- Developer take: max 300 characters. What was hard, surprising, or worth remembering? Write in first person.
+- Steps: 5-7 steps. Each title max 20 words. Each body max 40 words. Be concrete — mention file names, tools, and specific decisions.
+- Skills: extract from the actual tools, files, and patterns used. No padding. If they only touched 3 technologies, list 3.
+- Questions: generate exactly 3 targeted questions based on the developer's actual corrections, decisions, and redirections during the session. These should be specific enough that a generic answer would be obviously wrong.
+
+TONE: Slightly rough. Concrete. Compress. A dev thinking out loud, not an AI explaining.
+
+Respond in JSON matching this exact schema:
+{
+  "title": "string (max 80 chars)",
+  "context": "string (max 200 chars)",
+  "developerTake": "string (max 300 chars)",
+  "skills": ["string"],
+  "questions": [{"text": "string", "suggestedAnswer": "string"}],
+  "executionSteps": [{"stepNumber": number, "title": "string (max 20 words)", "body": "string (max 40 words)"}]
+}`;
+}
+function buildUserPrompt(session) {
+    const parts = [];
+    const sampling = sampleSession(session);
+    parts.push(`Session: ${session.title}`);
+    parts.push(`Project: ${session.projectName}`);
+    parts.push(`Duration: ${session.durationMinutes} min, ${session.turns} turns, ${session.linesOfCode} LOC changed`);
+    if (sampling.sampled) {
+        parts.push(`[SAMPLED: ${sampling.selectedTurns} of ${sampling.totalTurns} turns shown, distributed beginning/middle/end, high-signal moments prioritized. T{n}/${sampling.totalTurns} = position in full session.]`);
+    }
+    if (session.skills.length > 0) {
+        parts.push(`Detected skills: ${session.skills.join(', ')}`);
+    }
+    if (session.toolBreakdown.length > 0) {
+        parts.push(`Tool usage: ${session.toolBreakdown.map((t) => `${t.tool}(${t.count})`).join(', ')}`);
+    }
+    if (session.filesChanged.length > 0) {
+        const topFiles = session.filesChanged
+            .sort((a, b) => (b.additions + b.deletions) - (a.additions + a.deletions))
+            .slice(0, 10);
+        parts.push(`Key files: ${topFiles.map((f) => `${f.path} (+${f.additions}/-${f.deletions})`).join(', ')}`);
+    }
+    if (session.executionPath.length > 0) {
+        parts.push('Execution path:');
+        for (const step of session.executionPath) {
+            parts.push(`  ${step.stepNumber}. [${step.type ?? 'implementation'}] ${step.title}: ${step.description}`);
+        }
+    }
+    if (sampling.turns.length > 0) {
+        // Include developer prompts from sampled turns — these are the decisions and corrections
+        const devPrompts = sampling.turns.filter((t) => t.type === 'prompt');
+        if (devPrompts.length > 0) {
+            parts.push('Developer prompts (decisions & corrections):');
+            for (const p of devPrompts) {
+                parts.push(`  [${p.timestamp}] ${p.content}`);
+            }
+        }
+    }
+    if (sampling.log.length > 0) {
+        parts.push(`Raw log excerpt:\n${sampling.log.join('\n')}`);
+    }
+    return parts.join('\n');
+}
+export async function summarizeSession(session, options = {}) {
+    const client = options.client ?? new Anthropic();
+    const model = options.model ?? 'claude-sonnet-4-6';
+    const response = await client.messages.create({
+        model,
+        max_tokens: 2048,
+        system: buildSystemPrompt(),
+        messages: [{ role: 'user', content: buildUserPrompt(session) }],
+    });
+    const text = response.content
+        .filter((block) => block.type === 'text')
+        .map((block) => block.text)
+        .join('');
+    return parseEnhancementResult(text);
+}
+// ── Streaming enhancement ────────────────────────────────────
+export async function* summarizeSessionStream(session, options = {}) {
+    const client = options.client ?? new Anthropic();
+    const model = options.model ?? 'claude-sonnet-4-6';
+    let fullText = '';
+    try {
+        const stream = client.messages.stream({
+            model,
+            max_tokens: 2048,
+            system: buildSystemPrompt(),
+            messages: [{ role: 'user', content: buildUserPrompt(session) }],
+        });
+        for await (const event of stream) {
+            if (event.type === 'content_block_delta' && event.delta.type === 'text_delta') {
+                fullText += event.delta.text;
+            }
+        }
+        const result = parseEnhancementResult(fullText);
+        // Emit structured events for progressive UI rendering
+        yield { type: 'title', data: result.title };
+        yield { type: 'context', data: result.context };
+        yield { type: 'skills', data: result.skills };
+        for (const step of result.executionSteps) {
+            yield { type: 'step', data: step };
+        }
+        yield { type: 'developer_take', data: result.developerTake };
+        for (const question of result.questions) {
+            yield { type: 'question', data: question };
+        }
+        yield { type: 'done', data: result };
+    }
+    catch (err) {
+        yield { type: 'error', data: err.message };
+    }
+}
+// ── SSE helper for Express ───────────────────────────────────
+export function createSSEHandler(session, options = {}) {
+    return async (_req, res) => {
+        res.writeHead(200, {
+            'Content-Type': 'text/event-stream',
+            'Cache-Control': 'no-cache',
+            Connection: 'keep-alive',
+        });
+        let closed = false;
+        _req.on('close', () => { closed = true; });
+        for await (const event of summarizeSessionStream(session, options)) {
+            if (closed)
+                break;
+            res.write(`event: ${event.type}\ndata: ${JSON.stringify(event.data)}\n\n`);
+        }
+        if (!closed) {
+            res.end();
+        }
+    };
+}
+// ── JSON parsing with validation ─────────────────────────────
+export function parseEnhancementResult(raw) {
+    // Extract JSON from potential markdown code fences
+    const jsonMatch = raw.match(/```(?:json)?\s*([\s\S]*?)```/) ?? [null, raw];
+    const jsonStr = jsonMatch[1].trim();
+    let parsed;
+    try {
+        parsed = JSON.parse(jsonStr);
+    }
+    catch {
+        throw new Error(`Failed to parse AI response as JSON: ${jsonStr.slice(0, 200)}`);
+    }
+    const title = enforceMaxLength(String(parsed.title ?? ''), 80);
+    const context = enforceMaxLength(String(parsed.context ?? ''), 200);
+    const developerTake = enforceMaxLength(String(parsed.developerTake ?? ''), 300);
+    // Validate and enforce constraints
+    const skills = Array.isArray(parsed.skills)
+        ? parsed.skills.filter((s) => typeof s === 'string')
+        : [];
+    const questions = Array.isArray(parsed.questions)
+        ? parsed.questions
+            .filter((q) => q.text && q.suggestedAnswer)
+            .slice(0, 3)
+            .map((q) => ({
+            text: stripBannedWords(String(q.text)),
+            suggestedAnswer: stripBannedWords(String(q.suggestedAnswer)),
+        }))
+        : [];
+    const executionSteps = Array.isArray(parsed.executionSteps)
+        ? parsed.executionSteps
+            .slice(0, 7)
+            .map((step, idx) => ({
+            stepNumber: typeof step.stepNumber === 'number' ? step.stepNumber : idx + 1,
+            title: enforceWordLimit(stripBannedWords(String(step.title ?? '')), 20),
+            body: enforceWordLimit(stripBannedWords(String(step.body ?? '')), 40),
+        }))
+        : [];
+    return {
+        title: stripBannedWords(title),
+        context: stripBannedWords(context),
+        developerTake: stripBannedWords(developerTake),
+        skills,
+        questions,
+        executionSteps,
+    };
+}
+function enforceMaxLength(str, max) {
+    return str.length > max ? str.slice(0, max - 1) + '…' : str;
+}
+function enforceWordLimit(str, maxWords) {
+    const words = str.split(/\s+/).filter(Boolean);
+    if (words.length <= maxWords)
+        return str;
+    return words.slice(0, maxWords).join(' ') + '…';
+}
+// ── Exports for testing ──────────────────────────────────────
+export { buildSystemPrompt as _buildSystemPrompt, buildUserPrompt as _buildUserPrompt };
+// scoreTurn and sampleSession are already exported above
+//# sourceMappingURL=summarize.js.map

package/dist/summarize.js.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "heyiam",
+  "version": "0.1.0",
+  "description": "Turn AI coding sessions into portfolio case studies",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/interactivecats/heyi.am"
+  },
+  "keywords": ["ai", "portfolio", "claude", "coding-sessions", "developer-tools"],
+  "bin": {
+    "heyiam": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "app/dist"
+  ],
+  "scripts": {
+    "build": "tsc && cd app && npx vite build",
+    "prepublishOnly": "npm run build && find dist -name '*.test.*' -delete",
+    "dev": "npx concurrently \"npm:dev:api\" \"npm:dev:app\"",
+    "dev:api": "tsx watch src/index.ts open --no-open",
+    "dev:app": "cd app && npm run dev",
+    "test": "vitest run && cd app && npx vitest run",
+    "test:backend": "vitest run",
+    "test:frontend": "cd app && npx vitest run"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.79.0",
+    "commander": "^13.1.0",
+    "cors": "^2.8.6",
+    "express": "^5.2.1",
+    "open": "^10.1.0"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.19",
+    "@types/express": "^5.0.6",
+    "@types/node": "^22.0.0",
+    "@types/supertest": "^7.2.0",
+    "concurrently": "^9.2.1",
+    "supertest": "^7.2.2",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.1.0"
+  }
+}