@code-insights/cli 3.6.1 → 4.0.0

package/server-dist/llm/prompt-types.d.ts

@@ -0,0 +1,124 @@
+export interface SQLiteMessageRow {
+    id: string;
+    session_id: string;
+    type: 'user' | 'assistant' | 'system';
+    content: string;
+    thinking: string | null;
+    tool_calls: string;
+    tool_results: string;
+    usage: string | null;
+    timestamp: string;
+    parent_id: string | null;
+}
+/**
+ * Optional session metadata from V6 columns.
+ * Passed to prompt generators to add context signals about context compaction
+ * and slash command usage. Only present when at least one V6 field is non-empty.
+ */
+export interface SessionMetadata {
+    compactCount?: number;
+    autoCompactCount?: number;
+    slashCommands?: string[];
+}
+export interface AnalysisResponse {
+    facets?: {
+        outcome_satisfaction: string;
+        workflow_pattern: string | null;
+        had_course_correction: boolean;
+        course_correction_reason: string | null;
+        iteration_count: number;
+        friction_points: Array<{
+            _reasoning?: string;
+            category: string;
+            attribution?: string;
+            description: string;
+            severity: string;
+            resolution: string;
+        }>;
+        effective_patterns: Array<{
+            _reasoning?: string;
+            category: string;
+            description: string;
+            confidence: number;
+            driver?: 'user-driven' | 'ai-driven' | 'collaborative';
+        }>;
+    };
+    summary: {
+        title: string;
+        content: string;
+        outcome?: 'success' | 'partial' | 'abandoned' | 'blocked';
+        bullets: string[];
+    };
+    decisions: Array<{
+        title: string;
+        situation?: string;
+        choice?: string;
+        reasoning: string;
+        alternatives?: Array<{
+            option: string;
+            rejected_because: string;
+        }>;
+        trade_offs?: string;
+        revisit_when?: string;
+        confidence?: number;
+        evidence?: string[];
+    }>;
+    learnings: Array<{
+        title: string;
+        symptom?: string;
+        root_cause?: string;
+        takeaway?: string;
+        applies_when?: string;
+        confidence?: number;
+        evidence?: string[];
+    }>;
+}
+export interface ParseError {
+    error_type: 'json_parse_error' | 'no_json_found' | 'invalid_structure';
+    error_message: string;
+    response_length: number;
+    response_preview: string;
+}
+export type ParseResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: ParseError;
+};
+export interface PromptQualityFinding {
+    category: string;
+    type: 'deficit' | 'strength';
+    description: string;
+    message_ref: string;
+    impact: 'high' | 'medium' | 'low';
+    confidence: number;
+    suggested_improvement?: string;
+}
+export interface PromptQualityTakeaway {
+    type: 'improve' | 'reinforce';
+    category: string;
+    label: string;
+    message_ref: string;
+    original?: string;
+    better_prompt?: string;
+    why?: string;
+    what_worked?: string;
+    why_effective?: string;
+}
+export interface PromptQualityDimensionScores {
+    context_provision: number;
+    request_specificity: number;
+    scope_management: number;
+    information_timing: number;
+    correction_quality: number;
+}
+export interface PromptQualityResponse {
+    efficiency_score: number;
+    message_overhead: number;
+    assessment: string;
+    takeaways: PromptQualityTakeaway[];
+    findings: PromptQualityFinding[];
+    dimension_scores: PromptQualityDimensionScores;
+}
+//# sourceMappingURL=prompt-types.d.ts.map

package/server-dist/llm/prompt-types.d.ts.map

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

package/server-dist/llm/prompt-types.js

@@ -0,0 +1,4 @@
+// Type definitions for LLM prompt analysis.
+// Extracted from prompts.ts — shared by message-format.ts, response-parsers.ts, and analysis.ts.
+export {};
+//# sourceMappingURL=prompt-types.js.map

package/server-dist/llm/prompt-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-types.js","sourceRoot":"","sources":["../../src/llm/prompt-types.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,iGAAiG"}

package/server-dist/llm/prompts.d.ts

@@ -1,109 +1,66 @@
-import type { SessionCharacter } from '@code-insights/cli/types';
-export interface SQLiteMessageRow {
-    id: string;
-    session_id: string;
-    type: 'user' | 'assistant' | 'system';
-    content: string;
-    thinking: string | null;
-    tool_calls: string;
-    tool_results: string;
-    usage: string | null;
-    timestamp: string;
-    parent_id: string | null;
-}
+import type { SessionMetadata } from './prompt-types.js';
+import type { ContentBlock } from './types.js';
 /**
- * Format SQLite message rows for LLM consumption.
- * Handles snake_case fields and JSON-encoded tool_calls/tool_results.
+ * Shared system prompt for all LLM analysis calls.
+ * Paired with buildCacheableConversationBlock() + an analysis-specific instruction block.
  */
-export declare function formatMessagesForAnalysis(messages: SQLiteMessageRow[]): string;
+export declare const SHARED_ANALYST_SYSTEM_PROMPT = "You are a senior staff engineer analyzing an AI coding session. You will receive the conversation transcript followed by specific extraction instructions. Respond with valid JSON only, wrapped in <json>...</json> tags.";
 /**
- * System prompt for session analysis.
+ * Wrap formatted conversation messages in a cacheable content block.
+ * The cache_control field instructs Anthropic to cache everything up to
+ * and including this block (ephemeral, 5-minute TTL).
+ *
+ * Non-Anthropic providers receive this as a ContentBlock[] and use
+ * flattenContent() to convert it to a plain string.
+ *
+ * @param formattedMessages - Output of formatMessagesForAnalysis()
  */
-export declare const SESSION_ANALYSIS_SYSTEM_PROMPT = "You are a senior staff engineer writing entries for a team's engineering knowledge base. You've just observed an AI-assisted coding session and your job is to extract the insights that would save another engineer time if they encountered a similar situation 6 months from now.\n\nYour audience is a developer who has never seen this session but works on the same codebase. They need enough context to understand WHY a decision was made, WHAT specific gotcha was discovered, and WHEN this knowledge applies.\n\nYou will extract:\n1. **Summary**: A narrative of what was accomplished and the outcome\n2. **Decisions**: Technical choices made \u2014 with full situation context, reasoning, rejected alternatives, trade-offs, and conditions for revisiting (max 3)\n3. **Learnings**: Technical discoveries, gotchas, debugging breakthroughs \u2014 with the observable symptom, root cause, and a transferable takeaway (max 5)\n4. **Session Character**: Classify the session into exactly one of these types based on its overall nature:\n   - deep_focus: Long, concentrated work on a specific problem or area (50+ messages, deep into one topic)\n   - bug_hunt: Debugging-driven \u2014 investigating errors, tracing issues, fixing bugs\n   - feature_build: Building new functionality \u2014 creating files, adding endpoints, wiring components\n   - exploration: Research-oriented \u2014 reading code, searching, understanding before acting\n   - refactor: Restructuring existing code \u2014 renaming, moving, reorganizing without new features\n   - learning: Knowledge-seeking \u2014 asking questions, understanding concepts, getting explanations\n   - quick_task: Short and focused \u2014 small fix, config change, or one-off task (<10 messages)\n\nQuality Standards:\n- Only include insights you would write in a team knowledge base for future reference\n- Each insight MUST reference concrete details: specific file names, library names, error messages, API endpoints, or code patterns\n- Do not invent file names, APIs, errors, or details not present in the conversation\n- Rate your confidence in each insight's value (0-100). Only include insights you rate 70+.\n- It is better to return 0 insights in a category than to include generic or trivial ones\n- If a session is straightforward with no notable decisions or learnings, say so in the summary and leave other categories empty\n\nLength Guidance:\n- Fill every field in the schema. An empty \"trade_offs\" or \"revisit_when\" is worse than a longer response.\n- Total response: stay under 2000 tokens. If you must cut, drop lower-confidence insights rather than compressing high-confidence ones.\n- Evidence: 1-3 short quotes per insight, referencing turn labels.\n- Prefer precision over brevity \u2014 a specific 3-sentence insight beats a vague 1-sentence insight.\n\nDO NOT include insights like these (too generic/trivial):\n- \"Used debugging techniques to fix an issue\"\n- \"Made architectural decisions about the codebase\"\n- \"Implemented a new feature\" (the summary already covers this)\n- \"Used React hooks for state management\" (too generic without specifics)\n- \"Fixed a bug in the code\" (what bug? what was the root cause?)\n- Anything that restates the task without adding transferable knowledge\n\nHere are examples of EXCELLENT insights \u2014 this is the quality bar:\n\nEXCELLENT decision:\n{\n  \"title\": \"Use better-sqlite3 instead of sql.js for local database\",\n  \"situation\": \"Needed a SQLite driver for a Node.js CLI that stores session data locally. Single-user, read-heavy from dashboard, occasional writes during sync.\",\n  \"choice\": \"better-sqlite3 \u2014 synchronous C++ binding with native SQLite access, no async overhead.\",\n  \"reasoning\": \"CLI runs locally with no concurrent users. Synchronous API eliminates callback complexity. WAL mode provides concurrent read access for the dashboard while CLI writes.\",\n  \"alternatives\": [\n    {\"option\": \"sql.js (WASM build)\", \"rejected_because\": \"3x slower for bulk inserts, entire DB in memory, no WAL support\"},\n    {\"option\": \"PostgreSQL via Docker\", \"rejected_because\": \"Violates local-first constraint \u2014 requires running a server process\"}\n  ],\n  \"trade_offs\": \"Requires native compilation (node-gyp) which can fail on some systems. No browser compatibility.\",\n  \"revisit_when\": \"If multi-device sync is added or users report node-gyp build failures.\",\n  \"confidence\": 92,\n  \"evidence\": [\"User#3: 'We need something that works without a server'\", \"Assistant#4: 'better-sqlite3 with WAL mode gives concurrent reads...'\"]\n}\n\nEXCELLENT learning:\n{\n  \"title\": \"Tailwind v4 requires @theme inline{} for CSS variable utilities\",\n  \"symptom\": \"After Tailwind v3\u2192v4 upgrade, custom utilities like bg-primary stopped working. Classes present in HTML but no styles applied.\",\n  \"root_cause\": \"Tailwind v4 removed tailwind.config.js theme extension. CSS variables in :root are not automatically available as utilities \u2014 must be registered via @theme inline {} in the CSS file.\",\n  \"takeaway\": \"When migrating Tailwind v3\u2192v4 with shadcn/ui: add @theme inline {} mapping CSS variables, add @custom-variant dark for class-based dark mode, replace tailwindcss-animate with tw-animate-css.\",\n  \"applies_when\": \"Any Tailwind v3\u2192v4 migration using CSS variables for theming, especially with shadcn/ui.\",\n  \"confidence\": 95,\n  \"evidence\": [\"User#12: 'The colors are all gone after the upgrade'\", \"Assistant#13: 'Tailwind v4 requires explicit @theme inline registration...'\"]\n}\n\nRespond with valid JSON only, wrapped in <json>...</json> tags. Do not include any other text.";
+export declare function buildCacheableConversationBlock(formattedMessages: string): ContentBlock;
 /**
- * Generate the user prompt for session analysis.
+ * Build the instruction suffix for session analysis.
+ * Used as the second content block in the user message, after the cached conversation.
  */
-export declare function generateSessionAnalysisPrompt(projectName: string, sessionSummary: string | null, formattedMessages: string): string;
-export interface AnalysisResponse {
-    session_character?: SessionCharacter;
-    summary: {
-        title: string;
-        content: string;
-        outcome?: 'success' | 'partial' | 'abandoned' | 'blocked';
-        bullets: string[];
-    };
-    decisions: Array<{
-        title: string;
-        situation?: string;
-        choice?: string;
-        reasoning: string;
-        alternatives?: Array<{
-            option: string;
-            rejected_because: string;
-        }>;
-        trade_offs?: string;
-        revisit_when?: string;
-        confidence?: number;
-        evidence?: string[];
-    }>;
-    learnings: Array<{
-        title: string;
-        symptom?: string;
-        root_cause?: string;
-        takeaway?: string;
-        applies_when?: string;
-        confidence?: number;
-        evidence?: string[];
-    }>;
-}
-export interface ParseError {
-    error_type: 'json_parse_error' | 'no_json_found' | 'invalid_structure';
-    error_message: string;
-    response_length: number;
-    response_preview: string;
-}
-export type ParseResult<T> = {
-    success: true;
-    data: T;
-} | {
-    success: false;
-    error: ParseError;
-};
+export declare function buildSessionAnalysisInstructions(projectName: string, sessionSummary: string | null, meta?: SessionMetadata): string;
 /**
- * Parse the LLM response into structured insights.
+ * Build the instruction suffix for prompt quality analysis.
+ * Used as the second content block in the user message, after the cached conversation.
  */
-export declare function parseAnalysisResponse(response: string): ParseResult<AnalysisResponse>;
-export declare const PROMPT_QUALITY_SYSTEM_PROMPT = "You are a prompt engineering coach helping developers communicate more effectively with AI coding assistants. You review conversations and identify specific moments where better prompting would have saved time.\n\nYou will identify:\n1. **Wasted turns**: User messages that led to clarifications, corrections, or repeated instructions because the original prompt was unclear, missing context, or too vague.\n2. **Anti-patterns**: Recurring bad habits in the user's prompting style, with specific fixes.\n3. **Session traits**: Higher-level behavioral patterns about how the session was structured and managed.\n4. **Efficiency score**: A 0-100 rating of how optimally the user communicated.\n5. **Actionable tips**: Specific improvements the user can make.\n\nBefore evaluating, mentally walk through the conversation and identify:\n1. Each time the assistant asked for clarification that could have been avoided\n2. Each time the user corrected the assistant's interpretation\n3. Each time the user repeated an instruction they gave earlier\n4. Whether the session covers too many unrelated objectives (context drift / session bloat)\n5. Whether the user provided critical context or requirements late that should have been mentioned upfront\n6. Whether the user discussed the plan/approach before jumping into implementation, or dove straight into code\nThese are your candidate findings. Only include them if they are genuinely actionable.\n\nGuidelines:\n- Focus on USER messages only \u2014 don't critique the assistant's responses\n- A \"wasted turn\" is when the user had to send a follow-up message to clarify, correct, or repeat something that could have been included in the original prompt\n- Only mark a wasted turn if the assistant explicitly asked for clarification or corrected a misunderstanding\n- Be constructive, not judgmental \u2014 the goal is to help users improve\n- Consider the context: some clarification exchanges are normal and expected\n- A score of 100 means every user message was perfectly clear and complete\n- A score of 50 means about half the messages could have been more efficient\n\nLength Guidance:\n- Max 5 wasted turns, max 3 anti-patterns, max 3 session traits, max 5 tips\n- suggestedRewrite must be a complete, usable prompt \u2014 not vague meta-advice\n- overallAssessment: 2-3 sentences\n- Total response: stay under 2000 tokens\n\nRespond with valid JSON only, wrapped in <json>...</json> tags. Do not include any other text.";
-export declare function generatePromptQualityPrompt(projectName: string, formattedMessages: string, messageCount: number): string;
-export interface WastedTurn {
-    messageIndex: number;
-    originalMessage?: string;
-    whatWentWrong?: string;
-    suggestedRewrite: string;
-    turnsWasted?: number;
-}
-export interface AntiPattern {
-    name: string;
-    description?: string;
-    count: number;
-    examples: string[];
-    fix?: string;
-}
-export interface SessionTrait {
-    trait: 'context_drift' | 'objective_bloat' | 'late_context' | 'no_planning' | 'good_structure';
-    severity: 'high' | 'medium' | 'low';
-    description: string;
-    evidence?: string;
-    suggestion?: string;
-}
-export interface PromptQualityResponse {
-    efficiencyScore: number;
-    potentialMessageReduction: number;
-    overallAssessment: string;
-    wastedTurns: WastedTurn[];
-    antiPatterns: AntiPattern[];
-    sessionTraits: SessionTrait[];
-    tips: string[];
-}
-export declare function parsePromptQualityResponse(response: string): ParseResult<PromptQualityResponse>;
+export declare function buildPromptQualityInstructions(projectName: string, sessionMeta: {
+    humanMessageCount: number;
+    assistantMessageCount: number;
+    toolExchangeCount: number;
+}, meta?: SessionMetadata): string;
+/**
+ * Build the instruction suffix for facet-only extraction (backfill path).
+ * Used as the second content block in the user message, after the cached conversation.
+ */
+export declare function buildFacetOnlyInstructions(projectName: string, sessionSummary: string | null, meta?: SessionMetadata): string;
+/**
+ * @deprecated Use SHARED_ANALYST_SYSTEM_PROMPT + buildSessionAnalysisInstructions() instead.
+ */
+export declare const SESSION_ANALYSIS_SYSTEM_PROMPT: string;
+/**
+ * @deprecated Use buildCacheableConversationBlock() + buildSessionAnalysisInstructions() instead.
+ */
+export declare function generateSessionAnalysisPrompt(projectName: string, sessionSummary: string | null, formattedMessages: string, meta?: SessionMetadata): string;
+/**
+ * @deprecated Use SHARED_ANALYST_SYSTEM_PROMPT + buildFacetOnlyInstructions() instead.
+ */
+export declare const FACET_ONLY_SYSTEM_PROMPT: string;
+/**
+ * @deprecated Use buildCacheableConversationBlock() + buildFacetOnlyInstructions() instead.
+ */
+export declare function generateFacetOnlyPrompt(projectName: string, sessionSummary: string | null, conversationMessages: string, meta?: SessionMetadata): string;
+/**
+ * @deprecated Use SHARED_ANALYST_SYSTEM_PROMPT + buildPromptQualityInstructions() instead.
+ */
+export declare const PROMPT_QUALITY_SYSTEM_PROMPT = "You are a prompt engineering coach helping developers communicate more effectively with AI coding assistants. You review conversations and identify specific moments where better prompting would have saved time \u2014 AND moments where the user prompted particularly well.\n\nYou will produce:\n1. **Takeaways**: Concrete before/after examples the user can learn from (max 4)\n2. **Findings**: Categorized findings for cross-session aggregation (max 8)\n3. **Dimension scores**: 5 numeric dimensions for progress tracking\n4. **Efficiency score**: 0-100 overall rating\n5. **Assessment**: 2-3 sentence summary\n\nBefore evaluating, mentally walk through the conversation and identify:\n1. Each time the assistant asked for clarification that could have been avoided\n2. Each time the user corrected the assistant's interpretation\n3. Each time the user repeated an instruction they gave earlier\n4. Whether critical context or requirements were provided late\n5. Whether the user discussed the plan/approach before implementation\n6. Moments where the user's prompt was notably well-crafted\n7. If context compactions occurred, note that the AI may have lost context \u2014 repeated instructions IMMEDIATELY after a compaction are NOT a user prompting deficit\nThese are your candidate findings. Only include them if they are genuinely actionable.\n\n\nPROMPT QUALITY CLASSIFICATION GUIDANCE:\n\nEach finding captures a specific moment where the user's prompting either caused friction (deficit) or enabled productivity (strength).\n\nDEFICIT CATEGORIES \u2014 classify prompting problems:\n- \"vague-request\": Request lacked specificity needed for the AI to act without guessing. Missing file paths, function names, expected behavior, or concrete details.\n  NOT this category if the AI had enough context to succeed but failed anyway \u2014 that is an AI capability issue, not a prompting issue.\n\n- \"missing-context\": Critical background knowledge about architecture, conventions, dependencies, or current state was not provided.\n  NOT this category if the information was available in the codebase and the AI could have found it by reading files \u2014 that is an AI context-gathering failure.\n\n- \"late-constraint\": A requirement or constraint was provided AFTER the AI had already started implementing a different approach, causing rework.\n  NOT this category if the constraint was genuinely discovered during implementation (requirements changed). Only classify if the user KNEW the constraint before the session started.\n\n- \"unclear-correction\": The user told the AI its output was wrong without explaining what was wrong or why. \"That's not right\", \"try again\", \"no\" without context.\n  NOT this category if the user gave a brief but sufficient correction (\"use map instead of forEach\" is clear enough).\n\n- \"scope-drift\": The session objective shifted mid-conversation, or multiple unrelated objectives were addressed in one session.\n  NOT this category if the user is working through logically connected subtasks of one objective.\n\n- \"missing-acceptance-criteria\": The user did not define what successful completion looks like, leading to back-and-forth about whether the output meets expectations.\n  NOT this category for exploratory sessions where the user is discovering what they want.\n\n- \"assumption-not-surfaced\": The user held an unstated assumption that the AI could not reasonably infer from code or conversation.\n  NOT this category if the assumption was reasonable for the AI to make (e.g., standard coding conventions).\n\nSTRENGTH CATEGORIES \u2014 classify prompting successes (only when notably above average):\n- \"precise-request\": Request included enough specificity (file paths, function names, expected behavior, error messages) that the AI could act correctly on the first attempt.\n\n- \"effective-context\": User proactively shared architecture, conventions, prior decisions, or current state that the AI demonstrably used to make better decisions.\n\n- \"productive-correction\": When the AI went off track, the user provided a correction that included WHAT was wrong, WHY, and enough context for the AI to redirect effectively on the next response.\n\nCONTRASTIVE PAIRS:\n- vague-request vs missing-context: Was the problem in HOW THE TASK WAS DESCRIBED (vague-request) or WHAT BACKGROUND KNOWLEDGE WAS ABSENT (missing-context)?\n- late-constraint vs missing-context: Did the user EVENTUALLY provide it in the same session? Yes \u2192 late-constraint. Never \u2192 missing-context.\n- missing-context vs assumption-not-surfaced: Is this a FACT the user could have copy-pasted (missing-context), or a BELIEF/PREFERENCE they held (assumption-not-surfaced)?\n- scope-drift vs missing-acceptance-criteria: Did the user try to do TOO MANY THINGS (scope-drift) or ONE THING WITHOUT DEFINING SUCCESS (missing-acceptance-criteria)?\n- unclear-correction vs vague-request: Was this the user's FIRST MESSAGE about this task (vague-request) or a RESPONSE TO AI OUTPUT (unclear-correction)?\n\nDIMENSION SCORING (0-100):\n- context_provision: How well did the user provide relevant background upfront?\n  90+: Proactively shared architecture, constraints, conventions. 50-69: Notable gaps causing detours. <30: No context, AI working blind.\n- request_specificity: How precise were task requests?\n  90+: File paths, expected behavior, scope boundaries. 50-69: Mix of specific and vague. <30: Nearly all requests lacked detail.\n- scope_management: How focused was the session?\n  90+: Single clear objective, logical progression. 50-69: Some drift but primary goal met. <30: Unfocused, no clear objective.\n- information_timing: Were requirements provided when needed?\n  90+: All constraints front-loaded before implementation. 50-69: Some important requirements late. <30: Requirements drip-fed, constant corrections.\n- correction_quality: How well did the user redirect the AI?\n  90+: Corrections included what, why, and context. 50-69: Mix of clear and unclear. <30: Corrections gave almost no signal.\n  Score 75 if no corrections were needed (absence of corrections in a successful session = good prompting).\n\nEDGE CASES:\n- Short sessions (<5 user messages): Score conservatively. Do not penalize for missing elements unnecessary in quick tasks.\n- Exploration sessions: Do not penalize for missing acceptance criteria or scope drift.\n- Sessions where AI performed well despite vague prompts: Still classify deficits. Impact should be \"low\" since no visible cost.\n- Agentic/delegation sessions: If the user gave a clear high-level directive and the AI autonomously planned and executed successfully, do not penalize for low message count or lack of micro-level specificity. Effective delegation IS good prompting. Focus on the quality of the initial delegation prompt.\n\nGuidelines:\n- Focus on USER messages only \u2014 don't critique the assistant's responses\n- Be constructive, not judgmental \u2014 the goal is to help users improve\n- A score of 100 means every user message was perfectly clear and complete\n- A score of 50 means about half the messages could have been more efficient\n- Include BOTH deficits and strengths \u2014 what went right matters as much as what went wrong\n- If the user prompted well, say so \u2014 don't manufacture issues\n- If the session had context compactions, do NOT penalize the user for repeating instructions immediately after a compaction \u2014 the AI lost context, not the user. Repetition unrelated to compaction events should still be flagged.\n\nLength Guidance:\n- Max 4 takeaways (ordered: improve first, then reinforce), max 8 findings\n- better_prompt must be a complete, usable prompt \u2014 not vague meta-advice\n- assessment: 2-3 sentences\n- Total response: stay under 2500 tokens\n\nRespond with valid JSON only, wrapped in <json>...</json> tags. Do not include any other text.";
+/**
+ * @deprecated Use buildCacheableConversationBlock() + buildPromptQualityInstructions() instead.
+ */
+export declare function generatePromptQualityPrompt(projectName: string, formattedMessages: string, sessionMeta: {
+    humanMessageCount: number;
+    assistantMessageCount: number;
+    toolExchangeCount: number;
+}, meta?: SessionMetadata): string;
 //# sourceMappingURL=prompts.d.ts.map

package/server-dist/llm/prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/llm/prompts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/llm/prompts.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAmB/C;;;GAGG;AACH,eAAO,MAAM,4BAA4B,+NAA+N,CAAC;AASzQ;;;;;;;;;GASG;AACH,wBAAgB,+BAA+B,CAAC,iBAAiB,EAAE,MAAM,GAAG,YAAY,CAQvF;AAUD;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GAAG,IAAI,EAC7B,IAAI,CAAC,EAAE,eAAe,GACrB,MAAM,CAiKR;AAOD;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE;IACX,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;CAC3B,EACD,IAAI,CAAC,EAAE,eAAe,GACrB,MAAM,CA2GR;AAOD;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GAAG,IAAI,EAC7B,IAAI,CAAC,EAAE,eAAe,GACrB,MAAM,CAgDR;AASD;;GAEG;AACH,eAAO,MAAM,8BAA8B,QAoFoD,CAAC;AAEhG;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GAAG,IAAI,EAC7B,iBAAiB,EAAE,MAAM,EACzB,IAAI,CAAC,EAAE,eAAe,GACrB,MAAM,CAmFR;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,QAgB2B,CAAC;AAEjE;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GAAG,IAAI,EAC7B,oBAAoB,EAAE,MAAM,EAC5B,IAAI,CAAC,EAAE,eAAe,GACrB,MAAM,CAsCR;AAID;;GAEG;AACH,eAAO,MAAM,4BAA4B,8uPAoCsD,CAAC;AAEhG;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,EACnB,iBAAiB,EAAE,MAAM,EACzB,WAAW,EAAE;IACX,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;CAC3B,EACD,IAAI,CAAC,EAAE,eAAe,GACrB,MAAM,CA8ER"}