@hegel-dev/companion 1.0.0

package/README.md

@@ -0,0 +1,84 @@
+# Hegel Companion
+
+**Dialectical companion for AI-assisted development.**
+
+Hegel sits alongside your Cursor IDE sessions and provides real-time critical thinking oversight — catching lazy prompts, flagging overconfident AI responses, tracking session quality degradation, and nudging you to maintain engineering rigor.
+
+Named after Georg Wilhelm Friedrich Hegel's dialectical method: every thesis (your prompt) deserves an antithesis (critical review) before reaching synthesis (better code).
+
+## Two-Layer Analysis
+
+### Layer 1: Fast Rule-Based Checks (command hooks)
+Runs in milliseconds, zero cost. Always active.
+
+- Detects vague/lazy prompts ("fix it", "do the same", single-word confirmations)
+- Catches prompt quality degradation over the session
+- Flags rapid-fire prompting without review pauses
+- Tracks scope creep and untested changes
+- Detects overconfident AI language and sycophancy patterns
+- Session fatigue warnings
+
+### Layer 2: LLM Deep Analysis (prompt hooks)
+Uses your Cursor subscription models. Optional, configurable.
+
+- Nuanced prompt quality evaluation beyond pattern matching
+- Contextual assessment of whether a prompt has enough detail for its intent
+- AI response review for missing edge cases, security blind spots, and scope creep
+- Detects when you're blindly continuing from a previous AI response
+
+## Setup
+
+### Install via npm
+
+Install the package and run the setup CLI from your Cursor project root:
+
+```bash
+npm install --save-dev @hegel-dev/companion
+npx hegel-companion init .
+```
+
+Or, for a one-shot install without adding a dependency:
+
+```bash
+npx @hegel-dev/companion init .
+```
+
+> **Note:** This package was previously published as `hegel-companion`. That name is now deprecated — use `@hegel-dev/companion` for new installs. The CLI command (`hegel-companion`) is unchanged.
+
+This single command will:
+1. Generate `.cursor/hooks.json` to wire up the analysis layers.
+2. Scaffold a default `hegel.config.json` in your project root.
+3. Register the `hegel-mcp` server in `.cursor/mcp.json`.
+4. Install the Hegel Cursor extension for the sidebar dashboard.
+5. Add a `.cursor/rules/hegel-companion.mdc` rule so the AI knows how to use the MCP tools.
+
+### Configure
+
+The easiest way to configure Hegel is through the **Cursor Settings UI**:
+
+1. Open Settings (`Cmd/Ctrl + ,`)
+2. Search for **"Hegel"**
+3. Adjust your model, strictness, and other preferences.
+
+These settings automatically sync to a `hegel.config.json` file in your project root, which you can commit to version control to share team-wide standards.
+
+*(Note: Configuration changes are automatically detected when you start a new chat session).*
+
+## Architecture
+
+Hegel operates as a local, privacy-first system:
+- **Hooks**: Intercepts prompts and responses via Cursor's `.cursor/hooks.json`.
+- **State**: Session state is stored locally in `.hegel-state/` as JSON files.
+- **MCP Server**: Provides `hegel-status` and `hegel-review` tools to the AI.
+- **Cursor Extension**: Reads the local state to power the sidebar dashboard and status bar.
+
+## Philosophy
+
+> "The owl of Minerva spreads its wings only with the falling of the dusk."
+> — Hegel, *Philosophy of Right*
+
+Unlike Minerva's owl, Hegel doesn't wait for dusk. It watches in real time, helping you think critically *during* the creative process, not only in retrospect.
+
+## License
+
+MIT

package/dist/analyzers/prompt-analyzer.d.ts

@@ -0,0 +1,7 @@
+import type { Concern, SessionState, PromptRecord, TranscriptContext } from "../types.js";
+export declare function analyzePrompt(prompt: string, state: SessionState, transcript?: TranscriptContext | null): {
+    concerns: Concern[];
+    shouldBlock: boolean;
+};
+export declare function buildPromptRecord(prompt: string, concerns: Concern[]): PromptRecord;
+//# sourceMappingURL=prompt-analyzer.d.ts.map

package/dist/analyzers/prompt-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-analyzer.d.ts","sourceRoot":"","sources":["../../src/analyzers/prompt-analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAgC1F,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,YAAY,EACnB,UAAU,CAAC,EAAE,iBAAiB,GAAG,IAAI,GACpC;IAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CA4L/C;AAmBD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,EAAE,GAClB,YAAY,CAOd"}

package/dist/analyzers/prompt-analyzer.js

@@ -0,0 +1,224 @@
+import { recentPrompts, sessionDurationMinutes } from "../state.js";
+import { isContextualFollowUp, lastResponseInvitesFollowUp, recentUserTurns } from "../transcript.js";
+// ── Pattern Definitions ──
+const LAZY_PATTERNS = [
+    { pattern: /^(fix it|fix this|do it|make it work|same thing|again)\.?$/i, label: "extremely vague directive" },
+    { pattern: /^(yes|no|ok|sure|go ahead|yep|yeah|continue|proceed)\.?$/i, label: "single-word confirmation without context" },
+    { pattern: /^do the same (for|with|to)/i, label: "'do the same' without specifying what" },
+    { pattern: /^(now do|and also|next)\b.{0,20}$/i, label: "short chained request lacking self-contained context" },
+];
+const MISSING_CONTEXT_SIGNALS = [
+    { test: (p) => p.length < 15 && !p.includes("?"), message: "Very short prompt without a question — the AI will guess your intent" },
+    { test: (p) => /\b(it|this|that|these|those)\b/i.test(p) && p.split(/\s+/).length < 8, message: "Pronoun-heavy short prompt — 'it'/'this' may be ambiguous after context compaction" },
+];
+const ACCEPTANCE_CRITERIA_HINTS = [
+    /\b(implement|create|build|add|write|refactor|migrate|redesign)\b/i,
+];
+const HAS_CRITERIA = [
+    /\b(should|must|ensure|verify|test|expect|accept|criteria|requirement)\b/i,
+    /\b(when|if|unless|given|then)\b/i,
+    /\d+/, // numbers often indicate concrete specs
+];
+const OPERATIONAL_FOLLOW_UP = /\b(commit|push|open pr|pull request|run tests?|test suite|coverage|build|review findings|update status|continue with|proceed with|release)\b/i;
+// ── Analyzer ──
+export function analyzePrompt(prompt, state, transcript) {
+    const concerns = [];
+    const words = prompt.trim().split(/\s+/);
+    const wc = words.length;
+    const ctx = transcript ?? null;
+    // When a transcript is available, determine whether this prompt is a
+    // natural follow-up to the preceding assistant response.  This single
+    // flag gates most of the false-positive suppression below.
+    const isFollowUp = ctx ? isContextualFollowUp(prompt, ctx) : false;
+    const responseInvitedThis = ctx ? lastResponseInvitesFollowUp(ctx) : false;
+    const isOperationalFollowUp = OPERATIONAL_FOLLOW_UP.test(prompt);
+    const isFileReference = /^@\S+/.test(prompt.trim()) || prompt.includes("```");
+    // 1. Lazy/vague prompt detection
+    //    Suppress when the assistant just asked a question or presented options
+    //    and the user is responding with a short affirmative/directive.
+    for (const { pattern, label } of LAZY_PATTERNS) {
+        if (pattern.test(prompt.trim())) {
+            if (isFollowUp || responseInvitedThis) {
+                concerns.push({
+                    severity: "info",
+                    category: "prompt-quality",
+                    message: `Short directive ("${prompt.trim().slice(0, 40)}") — appears to be a contextual follow-up`,
+                });
+            }
+            else {
+                concerns.push({
+                    severity: "warning",
+                    category: "prompt-quality",
+                    message: `Lazy prompt detected: ${label}`,
+                    suggestion: "Rewrite with specific intent, context, and expected outcome. What exactly should change, and how will you verify it worked?",
+                });
+            }
+        }
+    }
+    // 2. Missing context signals
+    //    Suppress pronoun-heavy warning when pronouns clearly refer to the
+    //    assistant's last response (transcript available and follow-up detected).
+    for (const { test, message } of MISSING_CONTEXT_SIGNALS) {
+        if (test(prompt)) {
+            if (isFollowUp)
+                continue;
+            concerns.push({
+                severity: "info",
+                category: "prompt-quality",
+                message,
+                suggestion: "Add explicit references to files, functions, or behaviors instead of relying on pronouns.",
+            });
+        }
+    }
+    // 3. Significant task without acceptance criteria
+    const isSignificantTask = ACCEPTANCE_CRITERIA_HINTS.some((r) => r.test(prompt));
+    const hasCriteria = HAS_CRITERIA.some((r) => r.test(prompt));
+    if (isSignificantTask && !hasCriteria && wc > 5) {
+        concerns.push({
+            severity: "info",
+            category: "missing-criteria",
+            message: "Task request without acceptance criteria",
+            suggestion: "Consider adding: what 'done' looks like, edge cases to handle, or how to verify the result.",
+        });
+    }
+    // 4. Prompt quality degradation over the session
+    //    With a transcript, use actual user turn word counts for a more accurate
+    //    comparison than the state-tracked PromptRecords (which only start
+    //    tracking once the hook is installed).
+    const recent = recentPrompts(state, 5);
+    // Cap individual prompt word counts at 100 to prevent massive error logs
+    // from artificially inflating the average and causing false positives.
+    const capWc = (count) => Math.min(count, 100);
+    if (ctx && ctx.userTurnCount >= 4) {
+        const userTurns = recentUserTurns(ctx, 6);
+        if (userTurns.length >= 4) {
+            const avgRecent = userTurns.slice(0, -1).reduce((s, t) => s + capWc(t.wordCount), 0) / (userTurns.length - 1);
+            if (wc < avgRecent * 0.4 && wc < 15 && !isFollowUp && !isOperationalFollowUp && !isFileReference) {
+                concerns.push({
+                    severity: "warning",
+                    category: "prompt-degradation",
+                    message: `Your prompts are getting shorter (transcript avg ${Math.round(avgRecent)} words → ${wc} now). Quality may be degrading.`,
+                    suggestion: "Take a moment to formulate a complete, self-contained request. The AI performs better with clear context.",
+                });
+            }
+        }
+    }
+    else if (recent.length >= 3) {
+        const avgRecentLength = recent.reduce((s, r) => s + capWc(r.wordCount), 0) / recent.length;
+        if (wc < avgRecentLength * 0.4 && wc < 15 && !isFollowUp && !isOperationalFollowUp && !isFileReference) {
+            concerns.push({
+                severity: "warning",
+                category: "prompt-degradation",
+                message: `Your prompts are getting shorter (avg ${Math.round(avgRecentLength)} words → ${wc} now). Quality may be degrading.`,
+                suggestion: "Take a moment to formulate a complete, self-contained request. The AI performs better with clear context.",
+            });
+        }
+    }
+    // 5. Long session fatigue warning
+    const minutes = sessionDurationMinutes(state);
+    if (minutes > 60 && state.turnCount > 0 && state.turnCount % 10 === 0) {
+        concerns.push({
+            severity: "info",
+            category: "session-fatigue",
+            message: `Session running for ${Math.round(minutes)} minutes with ${state.turnCount} turns. Consider stepping back for a high-level review.`,
+            suggestion: "Open a new chat to review the overall changes made so far, or take a break to re-evaluate the approach.",
+        });
+    }
+    // 6. Rapid-fire prompts without review
+    if (recent.length >= 3) {
+        const lastThreeTimestamps = recent.slice(-3).map((r) => r.timestamp);
+        const gaps = [];
+        for (let i = 1; i < lastThreeTimestamps.length; i++) {
+            gaps.push(lastThreeTimestamps[i] - lastThreeTimestamps[i - 1]);
+        }
+        const avgGapSeconds = gaps.reduce((s, g) => s + g, 0) / gaps.length / 1000;
+        if (avgGapSeconds < 15) {
+            concerns.push({
+                severity: "warning",
+                category: "rapid-fire",
+                message: "Rapid-fire prompting detected — average gap between prompts is under 15 seconds",
+                suggestion: "Slow down. Are you reviewing the AI's responses before sending the next prompt? Quick iterations often lead to compounding errors.",
+            });
+        }
+    }
+    // 7. [Transcript-only] Repeated rephrasings — user struggling with the same request
+    if (ctx && ctx.userTurnCount >= 3) {
+        const lastUserTurns = recentUserTurns(ctx, 4);
+        if (lastUserTurns.length >= 3) {
+            const similarities = countSimilarPairs(lastUserTurns.map((t) => t.text.toLowerCase()));
+            if (similarities >= 2) {
+                concerns.push({
+                    severity: "info",
+                    category: "repeated-rephrase",
+                    message: "You appear to be rephrasing the same request multiple times. The AI may not understand what you need.",
+                    suggestion: "Try a different approach: break the task into smaller steps, provide a concrete example of expected output, or reference specific code.",
+                });
+            }
+        }
+    }
+    // 8. [Transcript-only] Context drift — current prompt is unrelated to the
+    //    ongoing conversation thread without explicit topic change
+    if (ctx && ctx.userTurnCount >= 2 && wc > 10) {
+        const lastUser = ctx.lastUserText;
+        const lastAssistant = ctx.lastAssistantText;
+        if (lastUser && lastAssistant) {
+            const combined = (lastUser + " " + lastAssistant).toLowerCase();
+            const currentWords = new Set(words.map((w) => w.toLowerCase()).filter((w) => w.length > 4));
+            const overlapCount = [...currentWords].filter((w) => combined.includes(w)).length;
+            const overlapRatio = currentWords.size > 0 ? overlapCount / currentWords.size : 1;
+            if (overlapRatio < 0.1 && currentWords.size > 8) {
+                // Before flagging, check overlap with the session's first user prompt.
+                // In checklist-style sessions the user works through numbered items —
+                // each item has different vocabulary but relates to the opening plan.
+                const firstUserTurn = recentUserTurns(ctx, ctx.userTurnCount)[0];
+                let relatedToSessionPlan = false;
+                if (firstUserTurn && firstUserTurn !== ctx.turns.find(t => t.text === lastUser)) {
+                    const planWords = firstUserTurn.text.toLowerCase();
+                    const planOverlap = [...currentWords].filter((w) => planWords.includes(w)).length;
+                    const planRatio = planOverlap / currentWords.size;
+                    if (planRatio >= 0.15)
+                        relatedToSessionPlan = true;
+                }
+                if (!relatedToSessionPlan) {
+                    concerns.push({
+                        severity: "info",
+                        category: "context-drift",
+                        message: "This prompt appears unrelated to the current conversation thread",
+                        suggestion: "Consider starting a new chat for unrelated topics. Mixing contexts in a single session can confuse the AI and lead to errors.",
+                    });
+                }
+            }
+        }
+    }
+    // Block on warning+ severity so the user actually sees Hegel's feedback.
+    // Cursor only surfaces beforeSubmitPrompt's user_message when continue=false.
+    const shouldBlock = concerns.some((c) => c.severity === "critical" || c.severity === "warning");
+    return { concerns, shouldBlock };
+}
+/**
+ * Counts how many adjacent pairs of strings share significant word overlap,
+ * indicating the user is rephrasing the same request.
+ */
+function countSimilarPairs(texts) {
+    let count = 0;
+    for (let i = 1; i < texts.length; i++) {
+        const prev = new Set(texts[i - 1].split(/\s+/).filter((w) => w.length > 3));
+        const curr = new Set(texts[i].split(/\s+/).filter((w) => w.length > 3));
+        if (prev.size === 0 || curr.size === 0)
+            continue;
+        const overlap = [...curr].filter((w) => prev.has(w)).length;
+        const ratio = overlap / Math.min(prev.size, curr.size);
+        if (ratio > 0.5)
+            count++;
+    }
+    return count;
+}
+export function buildPromptRecord(prompt, concerns) {
+    return {
+        timestamp: Date.now(),
+        prompt,
+        wordCount: prompt.trim().split(/\s+/).length,
+        concerns,
+    };
+}
+//# sourceMappingURL=prompt-analyzer.js.map

package/dist/analyzers/prompt-analyzer.js.map

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

package/dist/analyzers/response-analyzer.d.ts

@@ -0,0 +1,6 @@
+import type { Concern, SessionState, ResponseRecord, TranscriptContext } from "../types.js";
+export declare function analyzeResponse(text: string, state: SessionState, transcript?: TranscriptContext | null): {
+    concerns: Concern[];
+};
+export declare function buildResponseRecord(text: string, concerns: Concern[], unprompted?: boolean): ResponseRecord;
+//# sourceMappingURL=response-analyzer.d.ts.map

package/dist/analyzers/response-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-analyzer.d.ts","sourceRoot":"","sources":["../../src/analyzers/response-analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AA6C5F,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,YAAY,EACnB,UAAU,CAAC,EAAE,iBAAiB,GAAG,IAAI,GACpC;IAAE,QAAQ,EAAE,OAAO,EAAE,CAAA;CAAE,CA6IzB;AAyDD,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,OAAO,EAAE,EACnB,UAAU,UAAQ,GACjB,cAAc,CAOhB"}

package/dist/analyzers/response-analyzer.js

@@ -0,0 +1,218 @@
+import { totalFilesEdited, totalLinesChanged } from "../state.js";
+import { recentAssistantTurns, recentUserTurns } from "../transcript.js";
+// ── Pattern Definitions ──
+const OVERCONFIDENCE_PATTERNS = [
+    {
+        pattern: /\b(this is the (only )?correct|this will definitely|guaranteed to work)\b/i,
+        message: "Overconfident language — AI is claiming certainty without caveats",
+    },
+    {
+        pattern: /\b(I've fixed all|all issues are resolved|everything.+works now|completely fixed)\b/i,
+        message: "Blanket 'everything fixed' claim — did you verify all edge cases?",
+    },
+];
+const SYCOPHANCY_PATTERNS = [
+    {
+        pattern: /\b(you'?re (absolutely |completely )?right|I (completely |fully )?agree with your (approach|assessment|analysis))\b/i,
+        message: "Sycophantic agreement detected — is the AI genuinely agreeing or just being agreeable?",
+    },
+];
+const MISSING_VERIFICATION = [
+    {
+        trigger: /\b(refactor|restructur|rewrit|migrat|redesign|overhaul)\b/i,
+        check: /\b(test|verify|check|ensure|validate|confirm|run)\b/i,
+        message: "Major structural change proposed without explicit verification step",
+        suggestion: "Ask: 'How can we verify this refactoring didn't break anything?' before accepting.",
+    },
+    {
+        trigger: /\b(security|auth|access control|credential|secret|token|password|encrypt)\b/i,
+        check: /\b(review|audit|test|verify|vulnerabilit)\b/i,
+        message: "Security-related change without security review mention",
+        suggestion: "Security changes deserve explicit review. Consider asking for a threat model or security-specific test cases.",
+    },
+];
+const SCOPE_CREEP_THRESHOLD = 8;
+const LINES_CHANGED_THRESHOLD = 200;
+const INTENTIONAL_BROAD_SCOPE_PATTERN = /\b(audit|refactor|fix(es)?|review|update|align|migrate|rename|across|all files|codebase|inconsistenc|cover|coverage|extend|next step|follow-?up|integration-style|also|proceed with|now do)\b/i;
+// ── Analyzer ──
+export function analyzeResponse(text, state, transcript) {
+    const concerns = [];
+    const ctx = transcript ?? null;
+    // 1. Overconfidence detection
+    for (const { pattern, message } of OVERCONFIDENCE_PATTERNS) {
+        if (pattern.test(text)) {
+            concerns.push({
+                severity: "warning",
+                category: "overconfidence",
+                message,
+                suggestion: "Ask the AI: 'What could go wrong with this approach?' or 'What edge cases might this miss?'",
+            });
+            break;
+        }
+    }
+    // 2. Sycophancy detection
+    for (const { pattern, message } of SYCOPHANCY_PATTERNS) {
+        if (pattern.test(text)) {
+            concerns.push({
+                severity: "info",
+                category: "sycophancy",
+                message,
+                suggestion: "If the AI immediately agrees with everything, try playing devil's advocate: 'What arguments exist against this approach?'",
+            });
+            break;
+        }
+    }
+    // 3. Missing verification for risky changes
+    const hasCodeChanges = totalFilesEdited(state) > 0 || totalLinesChanged(state) > 0;
+    if (hasCodeChanges) {
+        for (const { trigger, check, message, suggestion } of MISSING_VERIFICATION) {
+            if (trigger.test(text) && !check.test(text)) {
+                concerns.push({
+                    severity: "warning",
+                    category: "missing-verification",
+                    message,
+                    suggestion,
+                });
+            }
+        }
+    }
+    // 4. Scope creep: too many files touched in the session
+    //    Suppress when the session's opening prompt explicitly describes
+    //    multi-file work (audit, refactor, fix list, etc.)
+    const filesEdited = totalFilesEdited(state);
+    if (filesEdited > SCOPE_CREEP_THRESHOLD && state.turnCount > 3) {
+        const alreadyWarned = state.concerns.some((c) => c.category === "scope-creep");
+        let intentionalBroadScope = false;
+        if (ctx) {
+            const userTurns = recentUserTurns(ctx, ctx.userTurnCount);
+            const firstUser = userTurns[0];
+            const recentUsers = userTurns.slice(-3);
+            intentionalBroadScope = [firstUser, ...recentUsers]
+                .filter((turn) => !!turn)
+                .some((turn) => INTENTIONAL_BROAD_SCOPE_PATTERN.test(turn.text));
+        }
+        else if (state.prompts.length > 0) {
+            intentionalBroadScope = [state.prompts[0], ...state.prompts.slice(-3)]
+                .some((prompt) => INTENTIONAL_BROAD_SCOPE_PATTERN.test(prompt.prompt));
+        }
+        if (!alreadyWarned && !intentionalBroadScope) {
+            concerns.push({
+                severity: "warning",
+                category: "scope-creep",
+                message: `${filesEdited} files modified this session. The scope may be expanding beyond the original intent.`,
+                suggestion: "Pause and ask: 'Is this still aligned with what I originally set out to do?' Consider committing what you have and starting a focused follow-up.",
+            });
+        }
+    }
+    // 5. Large volume of changes without tests
+    const lines = totalLinesChanged(state);
+    if (lines > LINES_CHANGED_THRESHOLD) {
+        const alreadyWarned = state.concerns.some((c) => c.category === "untested-changes");
+        const hasTestActivity = ctx ?
+            recentUserTurns(ctx, 3).some(t => t && /\b(test|spec|jest|vitest|mocha|cypress|playwright)\b/i.test(t.text)) :
+            state.prompts.slice(-3).some(p => /\b(test|spec|jest|vitest|mocha|cypress|playwright)\b/i.test(p.prompt));
+        if (!alreadyWarned && !hasTestActivity) {
+            concerns.push({
+                severity: "warning",
+                category: "untested-changes",
+                message: `${lines} lines changed so far without any test-related activity detected`,
+                suggestion: "Consider asking the AI to generate tests for the changes, or run existing tests before continuing.",
+            });
+        }
+    }
+    // 6. [Transcript-only] Self-contradiction — the AI reverses a position
+    //    it stated in a recent response without acknowledging the change.
+    if (ctx && ctx.assistantTurnCount >= 2) {
+        const recentResponses = recentAssistantTurns(ctx, 3);
+        const contradiction = detectContradiction(text, recentResponses.map((t) => t.text));
+        if (contradiction) {
+            concerns.push({
+                severity: "warning",
+                category: "self-contradiction",
+                message: contradiction,
+                suggestion: "Ask the AI: 'You previously said X but now say Y — what changed?' Contradictions may indicate the AI is guessing rather than reasoning.",
+            });
+        }
+    }
+    // 7. [Transcript-only] Non-responsive — the response doesn't address the
+    //    user's last request (keyword overlap check).
+    //    For multi-topic prompts (bullet points, line breaks), check each
+    //    segment individually — the response may focus on one sub-topic.
+    if (ctx && ctx.lastUserText) {
+        const responseWords = significantWords(text);
+        const segments = ctx.lastUserText.split(/\n[-•*]\s*|\n{2,}/).filter(s => s.trim().length > 10);
+        const segmentSets = segments.length > 1
+            ? segments.map(s => significantWords(s))
+            : [significantWords(ctx.lastUserText)];
+        const bestRatio = Math.max(...segmentSets.map(userWords => {
+            if (userWords.size < 5)
+                return 1;
+            const overlap = [...userWords].filter(w => responseWords.has(w)).length;
+            return overlap / userWords.size;
+        }));
+        if (bestRatio < 0.05 && text.length > 200) {
+            concerns.push({
+                severity: "info",
+                category: "non-responsive",
+                message: "The AI's response has very low overlap with your request — it may be addressing something different",
+                suggestion: "Compare the response to your original question. If it's off-topic, re-state your request clearly.",
+            });
+        }
+    }
+    return { concerns };
+}
+/**
+ * Checks for simple contradictions between the current response and recent ones.
+ * Looks for explicit negation of previously stated positions.
+ */
+function detectContradiction(current, previousResponses) {
+    const CONTRADICTION_PAIRS = [
+        [
+            /\b(you should|I recommend|the (best|right) (approach|way))\b.*\b(not|don't|avoid|instead of)\b.*\b(\w{4,})\b/i,
+            /\b(you should|I recommend|the (best|right) (approach|way))\b.*\b(\w{4,})\b/i,
+            "AI may have reversed its recommendation",
+        ],
+        [
+            /\b(this (is|was) (not |un)?necessary)\b/i,
+            /\b(this (is|was) (not |un)?necessary)\b/i,
+            "AI's assessment of necessity may have flipped",
+        ],
+    ];
+    for (const prev of previousResponses) {
+        for (const [currentPattern, prevPattern, message] of CONTRADICTION_PAIRS) {
+            if (currentPattern.test(current) && prevPattern.test(prev)) {
+                const currentNegated = /\b(not|don't|shouldn't|avoid|never)\b/i.test(current);
+                const prevNegated = /\b(not|don't|shouldn't|avoid|never)\b/i.test(prev);
+                if (currentNegated !== prevNegated) {
+                    return message;
+                }
+            }
+        }
+    }
+    return null;
+}
+function significantWords(text) {
+    const STOP_WORDS = new Set([
+        "the", "a", "an", "is", "are", "was", "were", "be", "been", "being",
+        "have", "has", "had", "do", "does", "did", "will", "would", "could",
+        "should", "may", "might", "shall", "can", "need", "must", "that",
+        "this", "these", "those", "with", "from", "into", "for", "and",
+        "but", "not", "you", "your", "it", "its", "they", "them", "their",
+        "what", "which", "who", "when", "where", "how", "all", "each",
+        "every", "both", "few", "more", "most", "other", "some", "such",
+        "than", "too", "very", "just", "also", "here", "there", "then",
+        "now", "only", "about", "after", "before", "between", "over",
+    ]);
+    return new Set(text.toLowerCase()
+        .split(/\s+/)
+        .filter((w) => w.length > 3 && !STOP_WORDS.has(w)));
+}
+export function buildResponseRecord(text, concerns, unprompted = false) {
+    return {
+        timestamp: Date.now(),
+        textLength: text.length,
+        concerns,
+        ...(unprompted && { unprompted }),
+    };
+}
+//# sourceMappingURL=response-analyzer.js.map

package/dist/analyzers/response-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-analyzer.js","sourceRoot":"","sources":["../../src/analyzers/response-analyzer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEzE,4BAA4B;AAE5B,MAAM,uBAAuB,GAAgD;IAC3E;QACE,OAAO,EAAE,4EAA4E;QACrF,OAAO,EAAE,mEAAmE;KAC7E;IACD;QACE,OAAO,EAAE,sFAAsF;QAC/F,OAAO,EAAE,mEAAmE;KAC7E;CACF,CAAC;AAEF,MAAM,mBAAmB,GAAgD;IACvE;QACE,OAAO,EAAE,sHAAsH;QAC/H,OAAO,EAAE,wFAAwF;KAClG;CACF,CAAC;AAEF,MAAM,oBAAoB,GAAG;IAC3B;QACE,OAAO,EAAE,4DAA4D;QACrE,KAAK,EAAE,sDAAsD;QAC7D,OAAO,EAAE,qEAAqE;QAC9E,UAAU,EAAE,oFAAoF;KACjG;IACD;QACE,OAAO,EAAE,8EAA8E;QACvF,KAAK,EAAE,8CAA8C;QACrD,OAAO,EAAE,yDAAyD;QAClE,UAAU,EAAE,+GAA+G;KAC5H;CACF,CAAC;AAEF,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAChC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AACpC,MAAM,+BAA+B,GAAG,gMAAgM,CAAC;AAEzO,iBAAiB;AAEjB,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,KAAmB,EACnB,UAAqC;IAErC,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,MAAM,GAAG,GAAG,UAAU,IAAI,IAAI,CAAC;IAE/B,8BAA8B;IAC9B,KAAK,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,uBAAuB,EAAE,CAAC;QAC3D,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,QAAQ,CAAC,IAAI,CAAC;gBACZ,QAAQ,EAAE,SAAS;gBACnB,QAAQ,EAAE,gBAAgB;gBAC1B,OAAO;gBACP,UAAU,EAAE,6FAA6F;aAC1G,CAAC,CAAC;YACH,MAAM;QACR,CAAC;IACH,CAAC;IAED,0BAA0B;IAC1B,KAAK,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,mBAAmB,EAAE,CAAC;QACvD,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,QAAQ,CAAC,IAAI,CAAC;gBACZ,QAAQ,EAAE,MAAM;gBAChB,QAAQ,EAAE,YAAY;gBACtB,OAAO;gBACP,UAAU,EAAE,2HAA2H;aACxI,CAAC,CAAC;YACH,MAAM;QACR,CAAC;IACH,CAAC;IAED,4CAA4C;IAC5C,MAAM,cAAc,GAAG,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,iBAAiB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnF,IAAI,cAAc,EAAE,CAAC;QACnB,KAAK,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,oBAAoB,EAAE,CAAC;YAC3E,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5C,QAAQ,CAAC,IAAI,CAAC;oBACZ,QAAQ,EAAE,SAAS;oBACnB,QAAQ,EAAE,sBAAsB;oBAChC,OAAO;oBACP,UAAU;iBACX,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,wDAAwD;IACxD,qEAAqE;IACrE,uDAAuD;IACvD,MAAM,WAAW,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC5C,IAAI,WAAW,GAAG,qBAAqB,IAAI,KAAK,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;QAC/D,MAAM,aAAa,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CACvC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,aAAa,CACpC,CAAC;QACF,IAAI,qBAAqB,GAAG,KAAK,CAAC;QAClC,IAAI,GAAG,EAAE,CAAC;YACR,MAAM,SAAS,GAAG,eAAe,CAAC,GAAG,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC;YAC1D,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,WAAW,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACxC,qBAAqB,GAAG,CAAC,SAAS,EAAE,GAAG,WAAW,CAAC;iBAChD,MAAM,CAAC,CAAC,IAAI,EAAoC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;iBAC1D,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,+BAA+B,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACrE,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpC,qBAAqB,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;iBACnE,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,+BAA+B,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3E,CAAC;QAED,IAAI,CAAC,aAAa,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAC7C,QAAQ,CAAC,IAAI,CAAC;gBACZ,QAAQ,EAAE,SAAS;gBACnB,QAAQ,EAAE,aAAa;gBACvB,OAAO,EAAE,GAAG,WAAW,sFAAsF;gBAC7G,UAAU,EAAE,kJAAkJ;aAC/J,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,2CAA2C;IAC3C,MAAM,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,KAAK,GAAG,uBAAuB,EAAE,CAAC;QACpC,MAAM,aAAa,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CACvC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,kBAAkB,CACzC,CAAC;QACF,MAAM,eAAe,GAAG,GAAG,CAAC,CAAC;YAC3B,eAAe,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,uDAAuD,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC9G,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,uDAAuD,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;QAE5G,IAAI,CAAC,aAAa,IAAI,CAAC,eAAe,EAAE,CAAC;YACvC,QAAQ,CAAC,IAAI,CAAC;gBACZ,QAAQ,EAAE,SAAS;gBACnB,QAAQ,EAAE,kBAAkB;gBAC5B,OAAO,EAAE,GAAG,KAAK,kEAAkE;gBACnF,UAAU,EAAE,oGAAoG;aACjH,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,uEAAuE;IACvE,sEAAsE;IACtE,IAAI,GAAG,IAAI,GAAG,CAAC,kBAAkB,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,eAAe,GAAG,oBAAoB,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrD,MAAM,aAAa,GAAG,mBAAmB,CAAC,IAAI,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACpF,IAAI,aAAa,EAAE,CAAC;YAClB,QAAQ,CAAC,IAAI,CAAC;gBACZ,QAAQ,EAAE,SAAS;gBACnB,QAAQ,EAAE,oBAAoB;gBAC9B,OAAO,EAAE,aAAa;gBACtB,UAAU,EAAE,yIAAyI;aACtJ,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,yEAAyE;IACzE,kDAAkD;IAClD,sEAAsE;IACtE,qEAAqE;IACrE,IAAI,GAAG,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;QAC5B,MAAM,aAAa,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;QAC/F,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC;YACrC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;YACxC,CAAC,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;QAEzC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CACxB,GAAG,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE;YAC7B,IAAI,SAAS,CAAC,IAAI,GAAG,CAAC;gBAAE,OAAO,CAAC,CAAC;YACjC,MAAM,OAAO,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YACxE,OAAO,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC;QAClC,CAAC,CAAC,CACH,CAAC;QAEF,IAAI,SAAS,GAAG,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YAC1C,QAAQ,CAAC,IAAI,CAAC;gBACZ,QAAQ,EAAE,MAAM;gBAChB,QAAQ,EAAE,gBAAgB;gBAC1B,OAAO,EAAE,qGAAqG;gBAC9G,UAAU,EAAE,mGAAmG;aAChH,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,SAAS,mBAAmB,CAC1B,OAAe,EACf,iBAA2B;IAE3B,MAAM,mBAAmB,GAAoC;QAC3D;YACE,+GAA+G;YAC/G,6EAA6E;YAC7E,yCAAyC;SAC1C;QACD;YACE,0CAA0C;YAC1C,0CAA0C;YAC1C,+CAA+C;SAChD;KACF,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,iBAAiB,EAAE,CAAC;QACrC,KAAK,MAAM,CAAC,cAAc,EAAE,WAAW,EAAE,OAAO,CAAC,IAAI,mBAAmB,EAAE,CAAC;YACzE,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3D,MAAM,cAAc,GAAG,wCAAwC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC9E,MAAM,WAAW,GAAG,wCAAwC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACxE,IAAI,cAAc,KAAK,WAAW,EAAE,CAAC;oBACnC,OAAO,OAAO,CAAC;gBACjB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY;IACpC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC;QACzB,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO;QACnE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;QACnE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;QAChE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;QAC9D,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO;QACjE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM;QAC7D,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM;QAC/D,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;QAC9D,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM;KAC7D,CAAC,CAAC;IACH,OAAO,IAAI,GAAG,CACZ,IAAI,CAAC,WAAW,EAAE;SACf,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CACrD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,QAAmB,EACnB,UAAU,GAAG,KAAK;IAElB,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,UAAU,EAAE,IAAI,CAAC,MAAM;QACvB,QAAQ;QACR,GAAG,CAAC,UAAU,IAAI,EAAE,UAAU,EAAE,CAAC;KAClC,CAAC;AACJ,CAAC"}

package/dist/analyzers/session-analyzer.d.ts

@@ -0,0 +1,10 @@
+import type { Concern, SessionState, TranscriptContext } from "../types.js";
+/**
+ * Produces a human-readable session summary with accumulated concerns.
+ * Called at the stop hook — this is Hegel's "end of turn" dialectical review.
+ */
+export declare function analyzeSession(state: SessionState, transcript?: TranscriptContext | null): {
+    summary: string;
+    concerns: Concern[];
+};
+//# sourceMappingURL=session-analyzer.d.ts.map

package/dist/analyzers/session-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-analyzer.d.ts","sourceRoot":"","sources":["../../src/analyzers/session-analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AA4D5E;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,YAAY,EACnB,UAAU,CAAC,EAAE,iBAAiB,GAAG,IAAI,GACpC;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB,CAqLA"}