agentic-loop 3.13.0 → 3.14.2

package/.claude/skills/idea/SKILL.md

@@ -64,6 +64,12 @@ Help the user flesh out the idea through conversation:
 - Caching needed? How fresh must data be?
 - Database indexes: What will be queried/sorted frequently?
 
+**Migration/Refactoring (IMPORTANT - ask if moving or restructuring code):**
+- Source paths: Where does the code currently live?
+- Destination paths: Where should it end up? (be explicit, not vague)
+- Phases: What's the logical order? (move files → update imports → verify)
+- Verification: What commands prove each phase worked?
+
 ### Step 3: Summarize Before Writing
 
 When you have enough information, summarize what you've learned:
@@ -132,6 +138,36 @@ Once the user confirms, write the idea file:
    - **Caching**: What can be cached? For how long?
    - **Database**: What indexes are needed?
 
+   ## Migration Mapping (if moving/restructuring code)
+   For refactoring or migration tasks, explicitly map source to destination:
+
+   | Source | Destination |
+   |--------|-------------|
+   | `~/Sites/old-project/src/` | `apps/new-location/src/` |
+   | `~/Sites/old-project/tests/` | `apps/new-location/tests/` |
+
+   ## Phases & Verification
+   Break complex work into phases with explicit verification commands:
+
+   ### Phase 1: [Name]
+   **What:** Description of what this phase accomplishes
+   **Exit Criteria:**
+   ```bash
+   # These commands must pass before phase is complete
+   test -d apps/new-location/src
+   cd apps/new-location && uv run pytest -x
+   cd apps/new-location && npm run build
+   ```
+
+   ### Phase 2: [Name]
+   **What:** Description
+   **Exit Criteria:**
+   ```bash
+   # Verification commands for phase 2
+   docker-compose config | grep -q 'service-name:'
+   curl -s http://localhost:8000/health | jq -e '.status == "ok"'
+   ```
+
    ## UI Mockup (if applicable)
    ```
    ┌─────────────────────────────────┐
@@ -190,6 +226,26 @@ A good idea file has:
 - **Specific solution** - Not vague ("improve UX") but concrete ("add inline validation")
 - **Scope boundaries** - What's explicitly out of scope?
 - **Architecture hints** - Where do files go? What patterns to follow?
+- **Verification commands** - How do we know it worked? (executable commands, not prose)
+
+### Migration/Refactoring Ideas
+
+For ideas that involve moving or restructuring code, MUST include:
+
+1. **Explicit path mapping** - Source → Destination for every directory
+   ```
+   ❌ "Move GOPA to apps folder"
+   ✅ "~/Sites/gopa/src/gopa/ → apps/gopa/src/gopa/"
+   ```
+
+2. **Phase-based verification** - Each phase has exit criteria with commands
+   ```
+   ❌ "Verify everything still works"
+   ✅ "cd apps/gopa && uv run pytest -x && uv run python -c 'from gopa.server import mcp'"
+   ```
+
+3. **Order of operations** - What must happen before what?
+   - Move files → Update imports → Update configs → Verify
 
 ### ASCII Art for UI
 

package/.claude/skills/loopgram/SKILL.md

@@ -0,0 +1,19 @@
+---
+description: Review and manage brainstorm ideas from Telegram
+---
+
+# Loopgram Review
+
+Review ideas captured from Telegram via Loopgram.
+
+## Commands
+
+- `/loopgram list` - Show all saved ideas
+- `/loopgram review <name>` - Review and refine a specific idea
+- `/loopgram prd <name>` - Convert idea to PRD for Ralph execution
+
+## Workflow
+
+1. List recent ideas: `ls docs/ideas/`
+2. Read an idea: Read the file
+3. If ready, run `/prd docs/ideas/{name}.md` to convert to executable PRD

package/.claude/skills/prd/SKILL.md

@@ -156,6 +156,7 @@ Does acceptanceCriteria include:
 - Does `contextFiles` include the idea file (has ASCII mockups)?
 - Does `contextFiles` include styleguide (if exists)?
 - Is `testUrl` set?
+- Is `mcp` set to `["playwright", "devtools"]`?
 
 **Fix any issues you find:**
 
@@ -168,6 +169,7 @@ Does acceptanceCriteria include:
 | List endpoint missing pagination | Add pagination criteria to acceptanceCriteria |
 | Frontend missing contextFiles | Add idea file + styleguide paths |
 | Frontend missing testUrl | Add URL from config |
+| Frontend missing mcp | Add `"mcp": ["playwright", "devtools"]` |
 
 ### Step 7: Reorder if Needed
 

package/README.md

@@ -86,6 +86,7 @@ npx agentic-loop run         # Execute PRDs autonomously
 - [How Ralph Works](docs/RALPH.md) - Architecture, config, full reference
 - [Cheatsheet](docs/CHEATSHEET.md) - All commands at a glance
 - [Hooks Reference](docs/HOOKS.md) - Pre-commit and Claude Code hooks
+- [Loopgram](docs/LOOPGRAM.md) - Telegram bot for mobile idea capture and loop monitoring
 - [Troubleshooting](docs/TROUBLESHOOTING.md) - Common issues and fixes
 - [Contributing](docs/CONTRIBUTING.md) - How to contribute
 

package/bin/ralph.sh

@@ -61,13 +61,22 @@ if [[ ! -f ".ralph/config.json" ]]; then
     _project_type="node"
   fi
 
+  # Check user template override first
+  _user_template="$HOME/.config/ralph/templates/config/${_project_type}.json"
   _config_template="$RALPH_TEMPLATES/config/${_project_type}.json"
-  if [[ -f "$_config_template" ]]; then
+
+  if [[ -f "$_user_template" ]]; then
+    cp "$_user_template" ".ralph/config.json"
+    echo "Using user template: $_user_template" >&2
+  elif [[ -f "$_config_template" ]]; then
     cp "$_config_template" ".ralph/config.json"
   else
     # Fall back to minimal config if template doesn't exist
+    _user_minimal="$HOME/.config/ralph/templates/config/minimal.json"
     _config_template="$RALPH_TEMPLATES/config/minimal.json"
-    if [[ -f "$_config_template" ]]; then
+    if [[ -f "$_user_minimal" ]]; then
+      cp "$_user_minimal" ".ralph/config.json"
+    elif [[ -f "$_config_template" ]]; then
       cp "$_config_template" ".ralph/config.json"
     else
       echo '{"projectType": "unknown"}' > ".ralph/config.json"
@@ -101,6 +110,11 @@ if [[ "${_ralph_needs_autoconfig:-}" == "true" ]]; then
   unset _ralph_needs_autoconfig
 fi
 
+# Merge user config defaults into project config
+if [[ -f "$RALPH_DIR/config.json" && -f "$HOME/.config/ralph/config.json" ]]; then
+  _merge_user_config
+fi
+
 # Main entry point
 main() {
   local cmd="${1:-help}"
@@ -185,15 +199,7 @@ main() {
       fi
       ;;
     config)
-      if [[ ! -f "$RALPH_DIR/config.json" ]]; then
-        print_error "Ralph not initialized. Run 'ralph init' first."
-        exit 1
-      fi
-      echo "Auto-detecting project configuration..."
-      auto_configure_project
-      echo ""
-      echo "Current config:"
-      jq '.' "$RALPH_DIR/config.json"
+      ralph_config "$@"
       ;;
     help|-h|--help)
       ralph_help

package/dist/loopgram/claude.d.ts

@@ -0,0 +1,18 @@
+import type { Message } from './types.js';
+/**
+ * Build system prompt with optional project context
+ */
+export declare function buildSystemPrompt(projectContext?: string): string;
+/**
+ * Send a message to Claude and get a response
+ */
+export declare function chat(history: Message[], model: string, projectContext?: string): Promise<string>;
+/**
+ * Generate a summary of the conversation for saving
+ */
+export declare function summarize(history: Message[], model: string): Promise<string>;
+/**
+ * Extract a title from a summary document
+ */
+export declare function extractTitle(summary: string): string;
+//# sourceMappingURL=claude.d.ts.map

package/dist/loopgram/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/loopgram/claude.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAuB1C;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAWjE;AAWD;;GAEG;AACH,wBAAsB,IAAI,CACxB,OAAO,EAAE,OAAO,EAAE,EAClB,KAAK,EAAE,MAAM,EACb,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,MAAM,CAAC,CAUjB;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,OAAO,EAAE,EAClB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAepD"}

package/dist/loopgram/claude.js

@@ -0,0 +1,89 @@
+import Anthropic from '@anthropic-ai/sdk';
+const anthropic = new Anthropic();
+const BASE_SYSTEM_PROMPT = `You are a thoughtful brainstorming partner helping develop software ideas.
+
+Your role:
+- Ask clarifying questions to deeply understand the idea
+- Explore edge cases and trade-offs
+- Challenge assumptions constructively
+- Help refine vague concepts into concrete plans
+- Keep responses concise but insightful (2-4 sentences usually)
+
+When the user says "save this" or similar:
+- Summarize the key decisions made
+- Format as a structured idea document
+- Confirm what you're saving
+
+Don't:
+- Write code unless asked
+- Be overly agreeable - push back on weak ideas
+- Give long lectures - keep it conversational`;
+/**
+ * Build system prompt with optional project context
+ */
+export function buildSystemPrompt(projectContext) {
+    if (!projectContext) {
+        return BASE_SYSTEM_PROMPT;
+    }
+    return `${BASE_SYSTEM_PROMPT}
+
+## Project Context
+You are brainstorming for a specific project. Here's context about it:
+
+${projectContext}`;
+}
+const SUMMARY_PROMPT = `Summarize this brainstorming conversation into a structured idea document with:
+- Title (short, descriptive)
+- Summary (2-3 sentences)
+- Key Decisions (bullet points)
+- Open Questions (if any)
+- Next Steps
+
+Format as clean markdown.`;
+/**
+ * Send a message to Claude and get a response
+ */
+export async function chat(history, model, projectContext) {
+    const response = await anthropic.messages.create({
+        model,
+        max_tokens: 500,
+        system: buildSystemPrompt(projectContext),
+        messages: history,
+    });
+    const content = response.content[0];
+    return content.type === 'text' ? content.text : '';
+}
+/**
+ * Generate a summary of the conversation for saving
+ */
+export async function summarize(history, model) {
+    const conversationText = history
+        .map((m) => `${m.role.toUpperCase()}: ${m.content}`)
+        .join('\n\n');
+    const response = await anthropic.messages.create({
+        model,
+        max_tokens: 1000,
+        system: SUMMARY_PROMPT,
+        messages: [{ role: 'user', content: conversationText }],
+    });
+    const content = response.content[0];
+    return content.type === 'text' ? content.text : '';
+}
+/**
+ * Extract a title from a summary document
+ */
+export function extractTitle(summary) {
+    // Try to find a markdown heading
+    const headingMatch = summary.match(/^#\s*(.+)/m);
+    if (headingMatch) {
+        return headingMatch[1].replace(/^Title:?\s*/i, '').trim();
+    }
+    // Try to find "Title:" line
+    const titleMatch = summary.match(/^Title:?\s*(.+)/im);
+    if (titleMatch) {
+        return titleMatch[1].trim();
+    }
+    // Fallback to timestamp
+    return `brainstorm-${Date.now()}`;
+}
+//# sourceMappingURL=claude.js.map

package/dist/loopgram/claude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../src/loopgram/claude.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAG1C,MAAM,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC;AAElC,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;8CAiBmB,CAAC;AAE/C;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,cAAuB;IACvD,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,OAAO,GAAG,kBAAkB;;;;;EAK5B,cAAc,EAAE,CAAA;AAClB,CAAC;AAED,MAAM,cAAc,GAAG;;;;;;;0BAOG,CAAC;AAE3B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,OAAkB,EAClB,KAAa,EACb,cAAuB;IAEvB,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC/C,KAAK;QACL,UAAU,EAAE,GAAG;QACf,MAAM,EAAE,iBAAiB,CAAC,cAAc,CAAC;QACzC,QAAQ,EAAE,OAAO;KAClB,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACpC,OAAO,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,OAAkB,EAClB,KAAa;IAEb,MAAM,gBAAgB,GAAG,OAAO;SAC7B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;SACnD,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhB,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC/C,KAAK;QACL,UAAU,EAAE,IAAI;QAChB,MAAM,EAAE,cAAc;QACtB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC;KACxD,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACpC,OAAO,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,iCAAiC;IACjC,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACjD,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5D,CAAC;IAED,4BAA4B;IAC5B,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACtD,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED,wBAAwB;IACxB,OAAO,cAAc,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;AACpC,CAAC"}

package/dist/loopgram/context-search.d.ts

@@ -0,0 +1,26 @@
+interface SearchResult {
+    file: string;
+    matches: string[];
+}
+/**
+ * Search a project for files related to a topic using ripgrep
+ */
+export declare function searchProject(projectPath: string, topic: string): SearchResult[];
+/**
+ * Read key project files for additional context
+ */
+export declare function readProjectFiles(projectPath: string): string;
+/**
+ * Generate a summary of search results using Claude
+ */
+export declare function generateContextSummary(projectName: string, topic: string, searchResults: SearchResult[], projectContext: string, model: string): Promise<string>;
+/**
+ * Search project and generate context for brainstorming
+ */
+export declare function getTopicContext(projectPath: string, projectName: string, topic: string, model: string): Promise<{
+    summary: string;
+    filesFound: string[];
+    searchTerms: string[];
+}>;
+export {};
+//# sourceMappingURL=context-search.d.ts.map

package/dist/loopgram/context-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-search.d.ts","sourceRoot":"","sources":["../../src/loopgram/context-search.ts"],"names":[],"mappings":"AAOA,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AA+BD;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE,CA+ChF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA2B5D;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,YAAY,EAAE,EAC7B,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CAsCjB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAyC3E"}

package/dist/loopgram/context-search.js

@@ -0,0 +1,175 @@
+import { execSync } from 'child_process';
+import { readFileSync, existsSync } from 'fs';
+import { join, relative } from 'path';
+import Anthropic from '@anthropic-ai/sdk';
+const anthropic = new Anthropic();
+/**
+ * Use AI to generate smart search terms for a topic
+ */
+async function generateSearchTerms(topic, model) {
+    const response = await anthropic.messages.create({
+        model,
+        max_tokens: 200,
+        system: `You generate search terms for code search. Given a topic, output 5-8 relevant keywords/patterns to search for in a codebase. Output ONLY the terms, one per line, no explanations. Include variations (e.g., "auth", "authenticate", "authentication").`,
+        messages: [
+            { role: 'user', content: `Topic: ${topic}` },
+        ],
+    });
+    const text = response.content[0];
+    if (text.type !== 'text')
+        return [topic];
+    const terms = text.text
+        .split('\n')
+        .map(t => t.trim().toLowerCase())
+        .filter(t => t.length > 0 && t.length < 30);
+    // Always include the original topic
+    if (!terms.includes(topic.toLowerCase())) {
+        terms.unshift(topic.toLowerCase());
+    }
+    return terms.slice(0, 8);
+}
+/**
+ * Search a project for files related to a topic using ripgrep
+ */
+export function searchProject(projectPath, topic) {
+    const results = [];
+    try {
+        // Use ripgrep to find matching files (case insensitive)
+        // Escape special regex characters in topic
+        const escapedTopic = topic.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        // Use grep instead of rg for compatibility
+        const cmd = `grep -r -i -l "${escapedTopic}" "${projectPath}" --include="*.py" --include="*.ts" --include="*.js" --include="*.md" --include="*.json" --include="*.sh" 2>/dev/null | grep -v node_modules | grep -v __pycache__ | grep -v ".git" | head -20 || true`;
+        console.log(`[search] Running: ${cmd}`);
+        const rgOutput = execSync(cmd, {
+            encoding: 'utf-8',
+            maxBuffer: 1024 * 1024,
+            shell: '/bin/zsh'
+        }).trim();
+        console.log(`[search] Found ${rgOutput ? rgOutput.split('\n').length : 0} files for "${topic}"`);
+        if (!rgOutput) {
+            return results;
+        }
+        const files = rgOutput.split('\n').filter(Boolean);
+        for (const file of files.slice(0, 10)) { // Limit to 10 files
+            try {
+                // Get matching lines with context
+                const matchOutput = execSync(`rg -i -C 2 "${topic}" "${file}" 2>/dev/null | head -30`, { encoding: 'utf-8', maxBuffer: 1024 * 1024 }).trim();
+                results.push({
+                    file: relative(projectPath, file),
+                    matches: matchOutput ? [matchOutput] : [],
+                });
+            }
+            catch {
+                // File might not have readable matches
+                results.push({ file: relative(projectPath, file), matches: [] });
+            }
+        }
+    }
+    catch (error) {
+        // ripgrep not found or no matches
+        console.error('Search error:', error);
+    }
+    return results;
+}
+/**
+ * Read key project files for additional context
+ */
+export function readProjectFiles(projectPath) {
+    const contextFiles = [
+        'CLAUDE.md',
+        'README.md',
+        'package.json',
+        'pyproject.toml',
+    ];
+    let context = '';
+    for (const file of contextFiles) {
+        const filePath = join(projectPath, file);
+        if (existsSync(filePath)) {
+            try {
+                const content = readFileSync(filePath, 'utf-8');
+                // Truncate large files
+                const truncated = content.length > 2000
+                    ? content.substring(0, 2000) + '\n...[truncated]'
+                    : content;
+                context += `\n### ${file}\n${truncated}\n`;
+            }
+            catch {
+                // Skip unreadable files
+            }
+        }
+    }
+    return context;
+}
+/**
+ * Generate a summary of search results using Claude
+ */
+export async function generateContextSummary(projectName, topic, searchResults, projectContext, model) {
+    if (searchResults.length === 0) {
+        return `No code found related to "${topic}" in ${projectName}. This might be a new area to build.`;
+    }
+    // Build the content to summarize
+    let content = `Project: ${projectName}\nTopic: ${topic}\n\n`;
+    content += `## Project Context\n${projectContext}\n\n`;
+    content += `## Search Results\n`;
+    for (const result of searchResults) {
+        content += `\n### ${result.file}\n`;
+        if (result.matches.length > 0) {
+            content += '```\n' + result.matches.join('\n---\n') + '\n```\n';
+        }
+    }
+    const response = await anthropic.messages.create({
+        model,
+        max_tokens: 800,
+        system: `You are summarizing code search results to provide context for brainstorming.
+Be concise but thorough. Focus on:
+- What exists related to this topic
+- Key patterns and approaches used
+- Important files/functions
+- Potential extension points
+
+Keep the summary under 500 words.`,
+        messages: [
+            {
+                role: 'user',
+                content: `Summarize what exists in this codebase related to "${topic}":\n\n${content}`,
+            },
+        ],
+    });
+    const text = response.content[0];
+    return text.type === 'text' ? text.text : 'Unable to generate summary.';
+}
+/**
+ * Search project and generate context for brainstorming
+ */
+export async function getTopicContext(projectPath, projectName, topic, model) {
+    // Use AI to generate smart search terms
+    console.log(`[context] Generating search terms for: ${topic}`);
+    const searchTerms = await generateSearchTerms(topic, model);
+    console.log(`[context] Search terms: ${searchTerms.join(', ')}`);
+    // Search for each term and combine results
+    const allResults = new Map();
+    for (const term of searchTerms) {
+        const results = searchProject(projectPath, term);
+        for (const result of results) {
+            // Dedupe by file path, merge matches
+            if (allResults.has(result.file)) {
+                const existing = allResults.get(result.file);
+                existing.matches.push(...result.matches);
+            }
+            else {
+                allResults.set(result.file, result);
+            }
+        }
+    }
+    const searchResults = Array.from(allResults.values()).slice(0, 15);
+    // Get basic project context
+    const projectContext = readProjectFiles(projectPath);
+    // Generate summary
+    const summary = await generateContextSummary(projectName, topic, searchResults, projectContext, model);
+    return {
+        summary,
+        filesFound: searchResults.map((r) => r.file),
+        searchTerms,
+    };
+}
+//# sourceMappingURL=context-search.js.map

package/dist/loopgram/context-search.js.map

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

package/dist/loopgram/conversation.d.ts

@@ -0,0 +1,39 @@
+import type { Context } from 'telegraf';
+import type { Message, BrainstormConfig, ProjectConfig } from './types.js';
+/**
+ * Set context for a conversation (from /context command)
+ */
+export declare function setConversationContext(chatId: number, context: string): void;
+/**
+ * Get context for a conversation
+ */
+export declare function getConversationContext(chatId: number): string | undefined;
+/**
+ * Get conversation history for a chat, creating if needed
+ */
+export declare function getHistory(chatId: number): Message[];
+/**
+ * Clear conversation history for a chat
+ */
+export declare function clearConversation(chatId: number): void;
+/**
+ * Handle incoming text messages
+ */
+export declare function handleMessage(ctx: Context, config: BrainstormConfig, project: ProjectConfig | null): Promise<void>;
+/**
+ * Handle /save command - summarize and save the conversation
+ */
+export declare function handleSaveCommand(ctx: Context, projectPath: string | null, config: BrainstormConfig): Promise<void>;
+/**
+ * Handle /clear command - clear conversation history
+ */
+export declare function handleClearCommand(ctx: Context): void;
+/**
+ * Handle /projects command - list configured projects
+ */
+export declare function handleProjectsCommand(ctx: Context, config: BrainstormConfig): void;
+/**
+ * Handle /status command - show current conversation status
+ */
+export declare function handleStatusCommand(ctx: Context, projectPath: string | null, config: BrainstormConfig): void;
+//# sourceMappingURL=conversation.d.ts.map

package/dist/loopgram/conversation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../../src/loopgram/conversation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAa3E;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE5E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEzE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE,CAKpD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAGtD;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,aAAa,GAAG,IAAI,GAC5B,OAAO,CAAC,IAAI,CAAC,CA4Cf;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,OAAO,EACZ,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,IAAI,CAAC,CA6Cf;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAMrD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,gBAAgB,GACvB,IAAI,CAUN;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,OAAO,EACZ,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,MAAM,EAAE,gBAAgB,GACvB,IAAI,CAoBN"}