nietzschian-debugger 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dilawar Gopang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,176 @@
+# Nietzschian Debugger
+
+> "What doesn't kill your code makes it stronger."
+
+The anti-AI. Every other tool gives you answers. Nietzschian Debugger **confronts you with questions**.
+
+You paste your bug. It doesn't fix it. Instead, it:
+
+- Challenges your assumptions about what's happening
+- Forces you to confront the evidence you're avoiding
+- Tears apart your weak reasoning until only truth remains
+- Guides you to the "aha!" moment — YOUR moment, not the AI's
+
+## Why?
+
+AI is making developers weaker. Copy-paste from ChatGPT, ship, repeat. Nobody understands their own code anymore. **Nietzschian Debugger forges stronger developers** — through struggle, not shortcuts.
+
+> "He who has a why to debug can bear almost any how."
+
+## Installation
+
+```bash
+# Install globally
+npm install -g nietzschian-debugger
+
+# Or use directly with npx
+npx nietzschian-debugger
+```
+
+**Requirements:**
+- Node.js >= 20.0.0
+- An Anthropic API key (BYOK — bring your own key)
+
+## Setup
+
+Set your Anthropic API key:
+
+```bash
+# Linux / macOS
+export ANTHROPIC_API_KEY="sk-ant-..."
+
+# Windows (PowerShell)
+$env:ANTHROPIC_API_KEY = "sk-ant-..."
+
+# Windows (CMD)
+set ANTHROPIC_API_KEY=sk-ant-...
+```
+
+## Quick Start
+
+```bash
+# Start a debugging session (default: nietzsche intensity)
+nietzschian debug "My API returns 500 but only on Tuesdays"
+
+# Gentle mode — for when you need guidance, not punishment
+nietzschian debug --intensity socrates "My login endpoint fails randomly"
+
+# Maximum intensity — for seniors who want pain
+nietzschian debug --intensity zarathustra "Memory leak in production"
+
+# Point it at specific code
+nietzschian debug "Auth fails in ./src/middleware/auth.ts"
+```
+
+## Three Intensity Levels
+
+| Level | Style | Best For |
+|-------|-------|----------|
+| `socrates` | Warm, guiding, scaffolded questions | Juniors, learning fundamentals |
+| `nietzsche` | Direct, confrontational, no hand-holding | Daily debugging (default) |
+| `zarathustra` | Brutal, adversarial, hostile to weak reasoning | Seniors who want real pain |
+
+## How a Session Looks
+
+```
+  Nietzschian Debugger v0.1.0 — intensity: nietzsche
+
+You: My login endpoint returns 403 for some users
+
+Nietzschian: You say "some users." That's vague. What separates
+             the ones who fail from the ones who don't?
+
+You: I'm not sure, it seems random
+
+Nietzschian: "Random" is the word we use when we haven't looked
+             hard enough. What do the server logs say for the 403
+             responses? Go look. I'll wait.
+
+You: Let me check... oh, they all have expired JWT tokens
+
+Nietzschian: Now we're getting somewhere. Why would some users
+             have expired tokens while others don't? What changed
+             recently in your auth system?
+
+You: ... oh. We changed the token TTL last week and didn't
+     invalidate existing sessions.
+
+Nietzschian: There it is. You didn't need me to tell you — you
+             needed to be forced to look.
+
+Session Complete — 4 questions to root cause (Solved)
+
+Your Debugging Profile:
+┣ Assumption-checking    ██████████  strong
+┣ Evidence-gathering     ██████░░░░  moderate
+┗ Root cause speed       ████████░░  strong
+
+"Man is something that shall be overcome."
+ — Friedrich Nietzsche
+```
+
+## Session Commands
+
+| Command | Effect |
+|---------|--------|
+| `solved` or `found it` | End session — you found the root cause |
+| `I give up` | Get one lifeline question, then exit |
+| `exit` or `quit` | Abandon session immediately |
+| `Ctrl+C` / `Ctrl+D` | Force quit |
+
+## Features
+
+- **Never Gives Answers** — Every response is a question. The tool will NEVER tell you the fix.
+- **Real Code Reading** — Reference a file path and it reads YOUR actual code, not generic examples.
+- **Contextual Philosophy** — Nietzsche when you're avoiding, Seneca when overwhelmed, Sun Tzu when you need strategy.
+- **Growth Score** — Track your debugging skills across sessions with visual bar charts.
+- **Session History** — All sessions saved locally in `.nietzschian/sessions/` for trend tracking.
+- **Sliding Context** — Long sessions don't crash; older turns are transparently summarized.
+
+## The Philosophy
+
+| Traditional AI | Nietzschian Debugger |
+|---------------|---------------------|
+| "Here's the fix" | "What have you tried?" |
+| Makes you dependent | Makes you dangerous |
+| You learn nothing | You learn everything |
+| Fast but shallow | Painful but permanent |
+| AI gets smarter | YOU get smarter |
+
+## Who Is This For?
+
+- **Junior developers** who want to actually learn, not just copy-paste
+- **Senior developers** who miss the struggle that made them good
+- **Engineering managers** who want their team thinking, not just prompting
+- **Bootcamp students** building real debugging intuition
+- **Anyone** who believes the best developer is a self-reliant one
+
+## Development
+
+```bash
+# Clone and install
+git clone https://github.com/your-username/nietzschian-debugger.git
+cd nietzschian-debugger
+npm install
+
+# Build
+npm run build
+
+# Run tests (121 tests)
+npm test
+
+# Run CLI locally
+node dist/cli.js debug "test problem"
+```
+
+## Tech Stack
+
+- TypeScript (strict mode)
+- Node.js >= 20
+- Claude API (Haiku for conversation, Sonnet for code analysis)
+- Commander.js for CLI
+- Vitest for testing
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import { debugCommand } from './commands/debug.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+let version = '0.1.0';
+try {
+    const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));
+    version = pkg.version;
+}
+catch {
+    // Fallback version
+}
+const program = new Command();
+program
+    .name('nietzschian')
+    .description('The anti-AI debugger. What doesn\'t kill your code makes it stronger.')
+    .version(version);
+program
+    .command('debug')
+    .description('Start an interactive debugging session')
+    .argument('<problem>', 'Description of the bug or problem to debug')
+    .option('-i, --intensity <level>', 'Questioning intensity: socrates, nietzsche, zarathustra', 'nietzsche')
+    .action(async (problem, options) => {
+    const validIntensities = ['socrates', 'nietzsche', 'zarathustra'];
+    if (!validIntensities.includes(options.intensity)) {
+        console.error(`Invalid intensity: "${options.intensity}". Choose from: ${validIntensities.join(', ')}`);
+        process.exit(2);
+    }
+    await debugCommand(problem, options.intensity);
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,IAAI,OAAO,GAAG,OAAO,CAAC;AACtB,IAAI,CAAC;IACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IACrF,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;AACxB,CAAC;AAAC,MAAM,CAAC;IACP,mBAAmB;AACrB,CAAC;AAED,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,aAAa,CAAC;KACnB,WAAW,CAAC,uEAAuE,CAAC;KACpF,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,wCAAwC,CAAC;KACrD,QAAQ,CAAC,WAAW,EAAE,4CAA4C,CAAC;KACnE,MAAM,CACL,yBAAyB,EACzB,yDAAyD,EACzD,WAAW,CACZ;KACA,MAAM,CAAC,KAAK,EAAE,OAAe,EAAE,OAA8B,EAAE,EAAE;IAChE,MAAM,gBAAgB,GAAG,CAAC,UAAU,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;IAClE,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAClD,OAAO,CAAC,KAAK,CACX,uBAAuB,OAAO,CAAC,SAAS,mBAAmB,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACzF,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,SAAsB,CAAC,CAAC;AAC9D,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/commands/debug.d.ts

@@ -0,0 +1,2 @@
+import type { Intensity } from '../types.js';
+export declare function debugCommand(problemDescription: string, intensity: Intensity): Promise<void>;

package/dist/commands/debug.js

@@ -0,0 +1,80 @@
+import Anthropic from '@anthropic-ai/sdk';
+import { getClient, MissingApiKeyError } from '../llm/client.js';
+import { createSession, finalizeSession } from '../core/session.js';
+import { runSessionLoop } from '../core/session-loop.js';
+import { saveSession } from '../storage/session-store.js';
+import { tagSessionBehaviors } from '../scoring/behavior-tagger.js';
+import { computeSkillScores } from '../scoring/skill-scorer.js';
+import { computeGrowthProfile } from '../scoring/growth-profile.js';
+import { selectClosingQuote } from '../quotes/selector.js';
+import { renderGrowthScore } from '../ui/growth-display.js';
+import { displayError, displayApiKeyHelp } from '../ui/renderer.js';
+export async function debugCommand(problemDescription, intensity) {
+    // Validate API key
+    try {
+        getClient();
+    }
+    catch (error) {
+        if (error instanceof MissingApiKeyError) {
+            displayApiKeyHelp();
+            process.exit(1);
+        }
+        throw error;
+    }
+    // Validate problem description
+    if (!problemDescription || !problemDescription.trim()) {
+        displayError('Please provide a problem description.');
+        console.log('\nUsage: nietzschian debug "Your problem description here"');
+        process.exit(2);
+    }
+    // Create session
+    const session = createSession(problemDescription.trim(), intensity);
+    try {
+        // Run interactive session
+        const result = await runSessionLoop(session);
+        // Finalize session
+        let behaviorTags = session.behaviorTags;
+        let skillScores = session.skillScores;
+        try {
+            behaviorTags = await tagSessionBehaviors(session.transcript);
+            skillScores = computeSkillScores(behaviorTags);
+        }
+        catch {
+            // Scoring is best-effort — don't crash if it fails
+        }
+        finalizeSession(session, result.outcome, skillScores, behaviorTags);
+        // Save session
+        try {
+            await saveSession(session);
+        }
+        catch {
+            // Persistence is best-effort
+        }
+        // Display growth score
+        const growthProfile = await computeGrowthProfile();
+        const closingQuote = selectClosingQuote(result.outcome);
+        const display = renderGrowthScore(session, growthProfile, closingQuote);
+        console.log(display);
+        process.exit(0);
+    }
+    catch (error) {
+        if (error instanceof Anthropic.AuthenticationError) {
+            displayError('Invalid API key. Check your ANTHROPIC_API_KEY.');
+            process.exit(1);
+        }
+        if (error instanceof Anthropic.RateLimitError) {
+            displayError('Rate limit reached. Try again in a moment.');
+            process.exit(3);
+        }
+        if (error instanceof Anthropic.APIConnectionError) {
+            displayError('Cannot reach Claude API. Check your connection.');
+            process.exit(3);
+        }
+        if (error instanceof Anthropic.APIError) {
+            displayError(`API error: ${error.message}`);
+            process.exit(3);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=debug.js.map

package/dist/commands/debug.js.map

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

package/dist/core/context-manager.d.ts

@@ -0,0 +1,22 @@
+import type { Turn } from '../types.js';
+export interface MessageArray {
+    messages: Array<{
+        role: 'user' | 'assistant';
+        content: string;
+    }>;
+    rollingSummary?: string;
+}
+export declare function buildMessageArray(turns: Turn[], rollingSummary?: string): MessageArray;
+export declare function estimateTokens(systemPrompt: string, messages: Array<{
+    role: 'user' | 'assistant';
+    content: string;
+}>): number;
+export declare function shouldSummarize(estimatedTokens: number): boolean;
+export declare function summarizeOldTurns(turns: Turn[], existingSummary?: string): Promise<{
+    summary: string;
+    recentTurns: Turn[];
+}>;
+export declare function checkAndSummarize(systemPrompt: string, turns: Turn[], existingSummary?: string): Promise<{
+    turns: Turn[];
+    summary?: string;
+}>;

package/dist/core/context-manager.js

@@ -0,0 +1,73 @@
+import { callLLM, getConversationModel, countTokens } from '../llm/client.js';
+const TOKEN_THRESHOLD_RATIO = 0.8;
+const MAX_CONTEXT_TOKENS = 200_000;
+const TOKEN_THRESHOLD = MAX_CONTEXT_TOKENS * TOKEN_THRESHOLD_RATIO; // 160K
+const CHARS_PER_TOKEN = 4;
+const PRESERVE_RECENT_TURNS = 8;
+const SUMMARY_SYSTEM_PROMPT = `You are a precise conversation summarizer. Compress the following debug session turns into a single paragraph that preserves:
+- The developer's key hypotheses (stated and rejected)
+- Observable behaviors (guessing without evidence, checking assumptions, etc.)
+- The current state of understanding at the end of these turns
+- Any files or code elements mentioned
+
+Do not editorialize. Do not add new information. Output only the summary paragraph.`;
+export function buildMessageArray(turns, rollingSummary) {
+    const messages = [];
+    if (rollingSummary) {
+        // Summary is implicitly available via system prompt, not as a message
+    }
+    for (const turn of turns) {
+        if (turn.question) {
+            messages.push({ role: 'assistant', content: turn.question });
+        }
+        if (turn.response) {
+            messages.push({ role: 'user', content: turn.response });
+        }
+    }
+    return { messages, rollingSummary };
+}
+export function estimateTokens(systemPrompt, messages) {
+    let totalChars = systemPrompt.length;
+    for (const msg of messages) {
+        totalChars += msg.content.length;
+    }
+    return Math.ceil(totalChars / CHARS_PER_TOKEN);
+}
+export function shouldSummarize(estimatedTokens) {
+    return estimatedTokens > TOKEN_THRESHOLD;
+}
+export async function summarizeOldTurns(turns, existingSummary) {
+    if (turns.length <= PRESERVE_RECENT_TURNS) {
+        return { summary: existingSummary ?? '', recentTurns: turns };
+    }
+    const oldTurns = turns.slice(0, -PRESERVE_RECENT_TURNS);
+    const recentTurns = turns.slice(-PRESERVE_RECENT_TURNS);
+    const turnsText = oldTurns
+        .map((t) => `Turn ${t.turnNumber}:\nQuestion: ${t.question}\nDeveloper: ${t.response}`)
+        .join('\n\n');
+    const toSummarize = existingSummary
+        ? `Previous summary: ${existingSummary}\n\nNew turns to incorporate:\n${turnsText}`
+        : turnsText;
+    const summary = await callLLM(SUMMARY_SYSTEM_PROMPT, [{ role: 'user', content: toSummarize }], getConversationModel());
+    return { summary, recentTurns };
+}
+export async function checkAndSummarize(systemPrompt, turns, existingSummary) {
+    const msgArray = buildMessageArray(turns, existingSummary);
+    const estimated = estimateTokens(systemPrompt, msgArray.messages);
+    if (!shouldSummarize(estimated)) {
+        return { turns, summary: existingSummary };
+    }
+    // Verify with exact count
+    try {
+        const exact = await countTokens(systemPrompt, msgArray.messages, getConversationModel());
+        if (exact <= TOKEN_THRESHOLD) {
+            return { turns, summary: existingSummary };
+        }
+    }
+    catch {
+        // If count_tokens fails, proceed with summarization based on estimate
+    }
+    const result = await summarizeOldTurns(turns, existingSummary);
+    return { turns: result.recentTurns, summary: result.summary };
+}
+//# sourceMappingURL=context-manager.js.map

package/dist/core/context-manager.js.map

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

package/dist/core/session-loop.d.ts

@@ -0,0 +1,5 @@
+import type { Session, SessionOutcome } from '../types.js';
+export interface SessionLoopResult {
+    outcome: SessionOutcome;
+}
+export declare function runSessionLoop(session: Session): Promise<SessionLoopResult>;

package/dist/core/session-loop.js

@@ -0,0 +1,159 @@
+import { createInterface } from 'node:readline/promises';
+import { stdin, stdout } from 'node:process';
+import { streamQuestion, getConversationModel, getModelForFile } from '../llm/client.js';
+import { getSystemPrompt } from '../llm/prompts.js';
+import { validateResponse, repromptIfInvalid, getFallbackQuestion } from '../llm/validator.js';
+import { detectFilePaths, readCodeFile, formatCodeContext } from '../storage/file-reader.js';
+import { addTurn, addCodeFile } from './session.js';
+import { checkAndSummarize } from './context-manager.js';
+import { selectQuote } from '../quotes/selector.js';
+import { streamToTerminal, newLine, displaySessionHeader, displayDim, } from '../ui/renderer.js';
+const EXIT_COMMANDS = new Set(['exit', 'quit']);
+const SOLVE_COMMANDS = new Set(['solved', 'found it']);
+export async function runSessionLoop(session) {
+    const rl = createInterface({ input: stdin, output: stdout });
+    const codeFiles = new Map();
+    let rollingSummary;
+    let lifelineOffered = false;
+    displaySessionHeader(session.intensity);
+    // Read initial code files from problem description
+    const initialPaths = detectFilePaths(session.problemDescription);
+    for (const filePath of initialPaths) {
+        const content = await readCodeFile(filePath);
+        if (content) {
+            codeFiles.set(filePath, content);
+            addCodeFile(session, filePath);
+        }
+    }
+    // Generate opening question
+    let model = initialPaths.length > 0 ? getModelForFile(initialPaths[0]) : getConversationModel();
+    const codeContext = formatCodeContext(codeFiles);
+    let systemPrompt = getSystemPrompt(session.intensity, session.problemDescription, codeContext || undefined, rollingSummary, 1);
+    const openingQuestion = await generateValidQuestion(systemPrompt, [{ role: 'user', content: session.problemDescription }], model, session.intensity);
+    newLine();
+    displayDim(`[Turn 1]`);
+    console.log(openingQuestion);
+    newLine();
+    // Add opening turn with empty response (to be filled when user responds)
+    let currentQuestion = openingQuestion;
+    try {
+        while (true) {
+            const input = await rl.question('> ');
+            const trimmed = input.trim();
+            if (!trimmed)
+                continue;
+            const lower = trimmed.toLowerCase();
+            // Check exit commands
+            if (EXIT_COMMANDS.has(lower)) {
+                addTurn(session, currentQuestion, '[exited]', model);
+                rl.close();
+                return { outcome: 'abandoned' };
+            }
+            // Check solve commands
+            if (SOLVE_COMMANDS.has(lower)) {
+                addTurn(session, currentQuestion, '[solved]', model);
+                rl.close();
+                return { outcome: 'solved' };
+            }
+            // Check "I give up"
+            if (lower === 'i give up') {
+                if (!lifelineOffered) {
+                    lifelineOffered = true;
+                    addTurn(session, currentQuestion, trimmed, model);
+                    // Generate one lifeline question
+                    const lifelinePrompt = getSystemPrompt(session.intensity, session.problemDescription, codeContext || undefined, rollingSummary, session.transcript.length + 1);
+                    const messages = buildConversationMessages(session, trimmed);
+                    const lifelineQ = await generateValidQuestion(lifelinePrompt, [...messages, { role: 'user', content: 'I give up. I cannot figure this out.' }], getConversationModel(), session.intensity);
+                    newLine();
+                    displayDim(`[Lifeline — one more question before you go]`);
+                    console.log(lifelineQ);
+                    newLine();
+                    currentQuestion = lifelineQ;
+                    continue;
+                }
+                else {
+                    addTurn(session, currentQuestion, '[gave up]', model);
+                    rl.close();
+                    return { outcome: 'abandoned' };
+                }
+            }
+            // Normal response — process it
+            addTurn(session, currentQuestion, trimmed, model);
+            // Check for new file paths in response
+            const newPaths = detectFilePaths(trimmed);
+            for (const filePath of newPaths) {
+                if (!codeFiles.has(filePath)) {
+                    const content = await readCodeFile(filePath);
+                    if (content) {
+                        codeFiles.set(filePath, content);
+                        addCodeFile(session, filePath);
+                    }
+                }
+            }
+            // Check context window
+            const contextResult = await checkAndSummarize(systemPrompt, session.transcript, rollingSummary);
+            rollingSummary = contextResult.summary;
+            // Select contextual quote
+            const quote = selectQuote(trimmed);
+            const suggestedQuoteText = quote ? quote.text : undefined;
+            // Build next turn
+            const turnNumber = session.transcript.length + 1;
+            const updatedCodeContext = formatCodeContext(codeFiles);
+            systemPrompt = getSystemPrompt(session.intensity, session.problemDescription, updatedCodeContext || undefined, rollingSummary, turnNumber, suggestedQuoteText);
+            // Determine model — Sonnet for first analysis of new files
+            model = newPaths.length > 0 ? getModelForFile(newPaths[0]) : getConversationModel();
+            const messages = buildConversationMessages(session);
+            const nextQuestion = await generateValidQuestion(systemPrompt, messages, model, session.intensity);
+            newLine();
+            displayDim(`[Turn ${turnNumber}]`);
+            console.log(nextQuestion);
+            newLine();
+            currentQuestion = nextQuestion;
+        }
+    }
+    catch (error) {
+        // Handle Ctrl+C / Ctrl+D / readline close
+        if (error.code === 'ERR_USE_AFTER_CLOSE') {
+            return { outcome: 'abandoned' };
+        }
+        rl.close();
+        return { outcome: 'abandoned' };
+    }
+}
+async function generateValidQuestion(systemPrompt, messages, model, intensity) {
+    let fullText = '';
+    await streamQuestion(systemPrompt, messages, model, {
+        onText: (text) => streamToTerminal(text),
+        onComplete: (text) => {
+            fullText = text;
+        },
+        onError: () => { },
+    });
+    // Clear the streamed output line
+    process.stdout.write('\r\x1b[K');
+    const validation = validateResponse(fullText);
+    if (validation.valid)
+        return fullText;
+    // Try reprompt
+    const reprompted = await repromptIfInvalid(systemPrompt, messages, fullText);
+    if (reprompted)
+        return reprompted;
+    // Fallback
+    return getFallbackQuestion(intensity);
+}
+function buildConversationMessages(session, currentResponse) {
+    const messages = [
+        { role: 'user', content: session.problemDescription },
+    ];
+    for (const turn of session.transcript) {
+        messages.push({ role: 'assistant', content: turn.question });
+        if (turn.response && !turn.response.startsWith('[')) {
+            messages.push({ role: 'user', content: turn.response });
+        }
+    }
+    if (currentResponse) {
+        messages.push({ role: 'user', content: currentResponse });
+    }
+    return messages;
+}
+//# sourceMappingURL=session-loop.js.map

package/dist/core/session-loop.js.map

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

package/dist/core/session.d.ts

@@ -0,0 +1,5 @@
+import type { Session, Intensity, SessionOutcome, Turn, SkillScores, BehaviorTag, Quote } from '../types.js';
+export declare function createSession(problemDescription: string, intensity: Intensity): Session;
+export declare function addTurn(session: Session, question: string, response: string, model: string, behaviorTags?: string[], quoteUsed?: Quote | null): Turn;
+export declare function finalizeSession(session: Session, outcome: SessionOutcome, skillScores?: SkillScores, behaviorTags?: BehaviorTag[]): void;
+export declare function addCodeFile(session: Session, filePath: string): void;