solvdex 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 duc.do
+
+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,274 @@
+# Solvdex
+
+[![Tests](https://img.shields.io/badge/tests-204%20passed-brightgreen)](./tests)
+[![Version](https://img.shields.io/badge/version-0.3.0-blue)](./package.json)
+[![License](https://img.shields.io/badge/license-MIT-green)](./LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue)](https://www.typescriptlang.org/)
+
+> **An index of solved problems.** A Claude Code plugin that auto-captures and retrieves project knowledge.
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  Error: ETIMEDOUT connecting to database                    │
+├─────────────────────────────────────────────────────────────┤
+│  📚 Solvdex found a solution:                               │
+│     "Database Connection Timeout"                           │
+│     Confidence: 85                                          │
+│                                                             │
+│     Solution: Increase pool timeout in config...            │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## Features
+
+| Feature | Description |
+|---------|-------------|
+| 🔄 **Auto-Capture** | Saves solutions when errors are resolved |
+| 🔍 **Auto-Lookup** | Surfaces relevant knowledge on errors |
+| 📊 **7 Categories** | Organized knowledge across development domains |
+| 🎯 **Trigger Patterns** | Regex matching for automatic error detection |
+| 📈 **Confidence Tracking** | Trust scores with decay over time |
+| 🔗 **Cross-References** | Link related entries and source files |
+
+## Categories
+
+```
+.wiki/
+├── issues/        # Bug fixes, error solutions
+├── patterns/      # Reusable code patterns
+├── gotchas/       # Pitfalls to avoid
+├── testing/       # Test strategies, mocks
+├── docs/          # Documentation guides
+├── security/      # Auth, vulnerabilities
+└── performance/   # Optimizations, benchmarks
+```
+
+## Quick Start
+
+```bash
+# Initialize wiki
+/wiki init
+
+# Search for solutions
+/wiki search "database timeout"
+
+# Add current solution
+/wiki add --category=issues
+
+# Browse entries
+/wiki browse
+```
+
+## Commands
+
+### Core Commands
+
+| Command | Description |
+|---------|-------------|
+| `/wiki init` | Create `.wiki/` structure |
+| `/wiki add` | Save current solution |
+| `/wiki search <query>` | Full-text search |
+| `/wiki browse` | List entries with filters |
+
+### Management Commands
+
+| Command | Description |
+|---------|-------------|
+| `/wiki status` | Quick health overview |
+| `/wiki stats` | Detailed analytics |
+| `/wiki validate` | Check for issues |
+| `/wiki scan` | Generate stubs from project |
+| `/wiki flag <entry>` | Mark for review |
+| `/wiki fix <entry>` | Update flagged entry |
+
+### Transfer Commands
+
+| Command | Description |
+|---------|-------------|
+| `/wiki export [file]` | Export to JSON |
+| `/wiki import <file>` | Import from JSON |
+| `/wiki test-trigger` | Test regex patterns |
+
+### Agents
+
+| Command | Description |
+|---------|-------------|
+| `/wiki explore <query>` | Deep multi-strategy search |
+| `/wiki capture` | Extract knowledge from conversation |
+
+## How It Works
+
+### Automatic Knowledge Capture
+
+```
+┌──────────────┐     ┌──────────────┐     ┌──────────────┐
+│  You solve   │────▶│   Solvdex    │────▶│   .wiki/     │
+│  an error    │     │   detects    │     │   saved!     │
+└──────────────┘     └──────────────┘     └──────────────┘
+
+Signals detected:
+• error_resolved  → issues/
+• workaround      → gotchas/
+• user confirms   → auto-detect category
+• explicit save   → "remember this"
+```
+
+### Automatic Knowledge Retrieval
+
+```
+┌──────────────┐     ┌──────────────┐     ┌──────────────┐
+│  Error       │────▶│   Solvdex    │────▶│   Solution   │
+│  occurs      │     │   matches    │     │   displayed  │
+└──────────────┘     └──────────────┘     └──────────────┘
+
+Lookup triggers:
+• Session start   → relevant context
+• Error match     → trigger patterns
+• Prompt keywords → category detection
+```
+
+## Entry Format
+
+```yaml
+---
+title: Database Connection Timeout
+created: 2025-01-20
+status: active
+confidence: 85
+tags: [database, timeout, postgres]
+trigger: "ETIMEDOUT.*postgres"
+---
+
+## Problem
+Connection times out after 30 seconds...
+
+## Solution
+Increase timeout and add connection pool...
+
+## Related
+- [[issues/connection-pool]]
+- `src/db/config.ts:45`
+```
+
+> **Note:** Entries also include maturity tracking fields (`maturity`, `use_count`, `last_used`). See [Entry Maturity System](#entry-maturity-system) below.
+
+### Entry Maturity System
+
+Solvdex automatically tracks and promotes entries through maturity phases based on usage:
+
+| Maturity | Criteria | Confidence | Meaning |
+|----------|----------|------------|---------|
+| **captured** | 0-2 uses | 40 | Newly documented, unverified |
+| **verified** | 3+ uses | 70 | Proven to work multiple times |
+| **validated** | 10+ uses, 30+ days old | 90 | Battle-tested over time |
+
+**Automatic Promotion:**
+- Entries start as `captured` when created
+- Maturity is evaluated automatically each time `recordEntryUsage()` is called
+- After 3 successful uses → promoted to `verified`
+- After 10 uses AND 30+ days → promoted to `validated`
+- Confidence scores update automatically with maturity
+
+**Safety Features:**
+- Flagged entries freeze maturity progression
+- Manual maturity overrides are respected
+- Maturity only goes up (no demotion)
+- All promotions logged in audit trail
+
+**Example Entry:**
+```yaml
+---
+title: Fix Redis Connection Timeout
+maturity: verified
+confidence: 70
+use_count: 5
+last_used: 2025-01-23
+audit:
+  - date: 2025-01-20
+    action: created
+    by: user
+  - date: 2025-01-22
+    action: maturity_promoted
+    by: system
+    context: "Auto-promoted: captured → verified (3 uses)"
+---
+```
+
+## Confidence Scale
+
+| Score | Level | Meaning |
+|-------|-------|---------|
+| 90-100 | 🟢 High | Typically validated entries |
+| 60-89 | 🟡 Medium | Typically verified entries or manually set |
+| 0-59 | 🔴 Low | Typically captured entries or stubs |
+
+Confidence auto-decays for entries unused for 90+ days.
+
+## Hooks
+
+Real-time integration with Claude Code:
+
+| Hook | When | Action |
+|------|------|--------|
+| `SessionStart` | New conversation | Surface relevant entries |
+| `UserPromptSubmit` | Each prompt | Enrich with context |
+| `PostToolUseFailure` | Error occurs | Show matching solutions |
+| `Stop` | Task completes | Offer to capture knowledge |
+
+## Installation
+
+### From Source
+
+```bash
+git clone https://github.com/ducdmdev/solvdex.git
+cd solvdex
+npm install
+npm run build
+```
+
+### Via Claude Code Marketplace
+
+```bash
+# Coming soon
+/plugin install solvdex
+```
+
+## Documentation
+
+| Document | Description |
+|----------|-------------|
+| [Getting Started](./docs/getting-started.md) | Quick setup guide |
+| [Architecture](./docs/architecture.md) | System design |
+| [Workflows](./docs/workflows.md) | Hook and skill flows |
+| [Use Cases](./docs/use-cases.md) | Common scenarios |
+
+## Development
+
+```bash
+npm install      # Install dependencies
+npm run build    # Compile TypeScript
+npm test         # Run 204 tests
+npm run lint     # Check code style
+```
+
+## Project Structure
+
+```
+solvdex/
+├── src/         # Core TypeScript library
+├── skills/      # 16 Claude Code skills
+├── hooks/       # 4 automated hooks
+├── docs/        # Documentation
+└── tests/       # Test suite (204 tests)
+```
+
+## License
+
+MIT © [duc.do](https://github.com/ducdmdev)
+
+---
+
+<p align="center">
+  <b>Stop re-solving the same problems.</b><br>
+  <i>Build your knowledge index with Solvdex.</i>
+</p>

package/dist/hooks/error-lookup.d.ts

@@ -0,0 +1,4 @@
+import { ErrorLookupOutput } from '../src/index.js';
+export declare function onErrorLookup(input: unknown): Promise<ErrorLookupOutput | null>;
+export default onErrorLookup;
+//# sourceMappingURL=error-lookup.d.ts.map

package/dist/hooks/error-lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-lookup.d.ts","sourceRoot":"","sources":["../../hooks/error-lookup.ts"],"names":[],"mappings":"AACA,OAAO,EAML,iBAAiB,EAKlB,MAAM,iBAAiB,CAAC;AAezB,wBAAsB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAwErF;AAUD,eAAe,aAAa,CAAC"}

package/dist/hooks/error-lookup.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.onErrorLookup = onErrorLookup;
+// hooks/error-lookup.ts
+const index_js_1 = require("../src/index.js");
+/**
+ * Extracts the solution section from wiki entry content.
+ */
+function extractSolution(content) {
+    // Look for Solution heading
+    const solutionMatch = content.match(/## Solution\n([\s\S]*?)(?=\n## |$)/);
+    if (solutionMatch) {
+        return solutionMatch[1].trim().slice(0, 200) + '...';
+    }
+    // Fallback: first 200 chars
+    return content.slice(0, 200) + '...';
+}
+async function onErrorLookup(input) {
+    try {
+        // Validate input first
+        const validatedInput = (0, index_js_1.validateErrorLookupInput)(input);
+        const { projectRoot, errorText, toolResult } = validatedInput;
+        // Get error text from either direct input or tool stderr
+        const error = errorText || toolResult?.stderr || '';
+        if (!error || !(0, index_js_1.wikiExists)(projectRoot)) {
+            return null;
+        }
+        // Try to match error against trigger patterns
+        const results = await (0, index_js_1.matchTrigger)(projectRoot, error);
+        const bestMatch = (0, index_js_1.getBestMatch)(results);
+        if (bestMatch && bestMatch.entry.frontmatter.confidence >= index_js_1.CONFIDENCE.THRESHOLD) {
+            // Record usage for analytics
+            try {
+                const { recordEntryUsage } = await import('../src/index.js');
+                recordEntryUsage(projectRoot, bestMatch.entry.path);
+            }
+            catch {
+                // Usage tracking failure is non-critical
+            }
+            // Output for Claude Code hook integration (user-facing console logs)
+            console.log(`📚 Solvdex found a solution:`);
+            console.log(`   "${bestMatch.entry.frontmatter.title}"`);
+            console.log(`   Confidence: ${bestMatch.entry.frontmatter.confidence}`);
+            console.log(`   `);
+            console.log(`   Solution: ${extractSolution(bestMatch.entry.content)}`);
+            // Structured output for Claude Code (includes both old and new format for backward compatibility)
+            const output = {
+                // Old format (for backward compatibility)
+                type: 'wiki_solution',
+                message: `Wiki: Found "${bestMatch.entry.frontmatter.title}" (confidence: ${bestMatch.entry.frontmatter.confidence})`,
+                entry: bestMatch.entry,
+                // New format (Claude Code integration)
+                continue: true,
+                hookSpecificOutput: {
+                    type: 'solution_found',
+                    message: `Found solution: "${bestMatch.entry.frontmatter.title}"`,
+                    entries: [{
+                            title: bestMatch.entry.frontmatter.title,
+                            category: bestMatch.entry.category,
+                            path: bestMatch.entry.path,
+                            confidence: bestMatch.entry.frontmatter.confidence
+                        }]
+                },
+                additionalContext: formatSolutionForContext(bestMatch)
+            };
+            // Output JSON marker + JSON (MUST be last output)
+            console.log('\n__HOOK_OUTPUT__');
+            console.log(JSON.stringify(output));
+            return output;
+        }
+        return null;
+    }
+    catch (error) {
+        // Handle validation errors separately
+        if (error instanceof index_js_1.ValidationError) {
+            console.error(`[Solvdex] Invalid input: ${error.message}`);
+            return null;
+        }
+        // Graceful degradation - log error but don't crash
+        console.error(`[Solvdex] Error in error-lookup hook: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        return null;
+    }
+}
+/**
+ * Formats a solution match into a readable context string for Claude Code.
+ */
+function formatSolutionForContext(match) {
+    const e = match.entry;
+    return `## ${e.frontmatter.title} (${e.category})\nConfidence: ${e.frontmatter.confidence}\n\n${e.content}`;
+}
+exports.default = onErrorLookup;
+//# sourceMappingURL=error-lookup.js.map

package/dist/hooks/error-lookup.js.map

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

package/dist/hooks/post-task.d.ts

@@ -0,0 +1,15 @@
+import { PostTaskOutput } from '../src/index.js';
+interface TaskContext {
+    projectRoot: string;
+    taskDescription: string;
+    outcome: 'success' | 'failure';
+    errorEncountered?: string;
+    errorResolved?: boolean;
+    filesModified?: string[];
+    userConfirmation?: string;
+    codeChanges?: string;
+    actionHistory?: string[];
+}
+export declare function onPostTask(context: TaskContext): Promise<PostTaskOutput | null>;
+export default onPostTask;
+//# sourceMappingURL=post-task.d.ts.map

package/dist/hooks/post-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-task.d.ts","sourceRoot":"","sources":["../../hooks/post-task.ts"],"names":[],"mappings":"AACA,OAAO,EAML,cAAc,EACf,MAAM,iBAAiB,CAAC;AAEzB,UAAU,WAAW;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAWD,wBAAsB,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAmFrF;AAkMD,eAAe,UAAU,CAAC"}

package/dist/hooks/post-task.js

@@ -0,0 +1,246 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.onPostTask = onPostTask;
+// hooks/post-task.ts
+const index_js_1 = require("../src/index.js");
+// Default enabled signals (can be overridden by future config)
+const DEFAULT_SIGNALS = [
+    'error_resolved',
+    'user_confirmation',
+    'explicit_save',
+    'repeated_pattern',
+    'workaround_applied'
+];
+async function onPostTask(context) {
+    try {
+        const { projectRoot } = context;
+        if (!(0, index_js_1.wikiExists)(projectRoot)) {
+            return null;
+        }
+        // Check signals
+        const signal = detectSignal(context, DEFAULT_SIGNALS);
+        if (!signal) {
+            return null;
+        }
+        // Extract entry details
+        const entryDetails = extractEntryDetails(context, signal);
+        // Check for duplicates before creating (but don't block on it)
+        let isDuplicate = false;
+        try {
+            const { checkDuplicate } = await import('../src/index.js');
+            const dupCheck = await checkDuplicate(projectRoot, entryDetails.title, entryDetails.tags, entryDetails.category);
+            isDuplicate = dupCheck.isDuplicate;
+            if (isDuplicate) {
+                console.log(`📚 Solvdex: Skipping duplicate "${entryDetails.title}"`);
+                console.log(`   Similar to: "${dupCheck.matchedEntry?.frontmatter.title}"`);
+                return null;
+            }
+        }
+        catch {
+            // Duplicate check failure is non-critical, proceed with creation
+        }
+        // Create entry
+        const entry = (0, index_js_1.createEntry)(projectRoot, {
+            category: entryDetails.category,
+            title: entryDetails.title,
+            tags: entryDetails.tags,
+            content: entryDetails.content,
+            trigger: entryDetails.trigger,
+            autoCapture: true,
+            stub: true,
+            source: `auto-capture:${signal}`
+        });
+        // Output for Claude Code Stop hook integration (user-facing console logs)
+        console.log(`📚 Solvdex: Captured "${entry.frontmatter.title}"`);
+        console.log(`   Category: ${entry.category}`);
+        console.log(`   Signal: ${signal}`);
+        // Structured output for Claude Code (includes both old and new format for backward compatibility)
+        const output = {
+            // Old format (for backward compatibility)
+            type: 'wiki_captured',
+            message: `Wiki: Saved "${entry.frontmatter.title}" to ${entry.category}/`,
+            entry,
+            signal,
+            // New format (Claude Code integration)
+            continue: true,
+            hookSpecificOutput: {
+                type: 'entry_captured',
+                message: `Captured "${entry.frontmatter.title}" to ${entry.category}/`,
+                entryPath: entry.path
+            },
+            additionalContext: formatEntryForContext(entry, signal)
+        };
+        // Output JSON marker + JSON (MUST be last output)
+        console.log('\n__HOOK_OUTPUT__');
+        console.log(JSON.stringify(output));
+        return output;
+    }
+    catch (error) {
+        // Graceful degradation - log error but don't crash
+        console.error(`[Solvdex] Error in post-task hook: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        return null;
+    }
+}
+/**
+ * Detects if similar actions have been performed 3+ times.
+ * Returns the repeated action if found.
+ */
+function detectRepeatedPattern(actionHistory) {
+    if (!actionHistory || actionHistory.length < 3) {
+        return null;
+    }
+    // Count occurrences of each action
+    const counts = {};
+    for (const action of actionHistory) {
+        const normalized = action.toLowerCase().trim();
+        counts[normalized] = (counts[normalized] || 0) + 1;
+    }
+    // Find action repeated 3+ times
+    for (const [action, count] of Object.entries(counts)) {
+        if (count >= 3) {
+            return action;
+        }
+    }
+    return null;
+}
+function detectSignal(context, enabledSignals) {
+    // Signal 1: Error resolved
+    if (enabledSignals.includes('error_resolved') &&
+        context.errorEncountered &&
+        context.errorResolved &&
+        context.outcome === 'success') {
+        return 'error_resolved';
+    }
+    // Signal 2: User confirmation
+    if (enabledSignals.includes('user_confirmation') &&
+        context.userConfirmation &&
+        isPositiveConfirmation(context.userConfirmation)) {
+        return 'user_confirmation';
+    }
+    // Signal 3: Explicit save request
+    if (enabledSignals.includes('explicit_save') &&
+        context.userConfirmation &&
+        isExplicitSaveRequest(context.userConfirmation)) {
+        return 'explicit_save';
+    }
+    // Signal 4: Repeated pattern
+    if (enabledSignals.includes('repeated_pattern') && context.actionHistory) {
+        const repeatedAction = detectRepeatedPattern(context.actionHistory);
+        if (repeatedAction) {
+            return 'repeated_pattern';
+        }
+    }
+    // Signal 5: Workaround applied (detect HACK/WORKAROUND comments)
+    if (enabledSignals.includes('workaround_applied') &&
+        context.codeChanges &&
+        hasWorkaroundMarkers(context.codeChanges)) {
+        return 'workaround_applied';
+    }
+    return null;
+}
+function isPositiveConfirmation(text) {
+    const positivePatterns = [
+        'that fixed it',
+        'works now',
+        'perfect',
+        'that worked',
+        'thank you',
+        'great',
+        'awesome',
+        'solved'
+    ];
+    const textLower = text.toLowerCase();
+    return positivePatterns.some(p => textLower.includes(p));
+}
+function isExplicitSaveRequest(text) {
+    const savePatterns = [
+        'save this to wiki',
+        'remember this',
+        'add to wiki',
+        'wiki this',
+        'document this'
+    ];
+    const textLower = text.toLowerCase();
+    return savePatterns.some(p => textLower.includes(p));
+}
+function hasWorkaroundMarkers(codeChanges) {
+    const workaroundPatterns = [
+        /\/\/\s*(HACK|WORKAROUND|TODO|FIXME):/i,
+        /\/\*\s*(HACK|WORKAROUND|TODO|FIXME):/i,
+        /#\s*(HACK|WORKAROUND|TODO|FIXME):/i
+    ];
+    return workaroundPatterns.some(pattern => pattern.test(codeChanges));
+}
+function extractEntryDetails(context, signal) {
+    // Determine category based on signal and task keywords (7 categories)
+    let category = 'issues'; // default
+    if (signal === 'error_resolved') {
+        category = 'issues';
+    }
+    else if (signal === 'workaround_applied') {
+        category = 'gotchas';
+    }
+    else if (signal === 'repeated_pattern') {
+        category = 'patterns';
+    }
+    else if (context.taskDescription) {
+        const task = context.taskDescription.toLowerCase();
+        // Testing signals
+        if (task.includes('test') || task.includes('mock') || task.includes('fixture')) {
+            category = 'testing';
+        }
+        // Documentation signals
+        else if (task.includes('document') || task.includes('readme') || task.includes('guide')) {
+            category = 'docs';
+        }
+        // Security signals
+        else if (task.includes('auth') || task.includes('security') || task.includes('permission')) {
+            category = 'security';
+        }
+        // Performance signals
+        else if (task.includes('slow') || task.includes('optimize') || task.includes('performance')) {
+            category = 'performance';
+        }
+        // Pattern signals
+        else if (task.includes('pattern') || task.includes('reusable')) {
+            category = 'patterns';
+        }
+        // Gotcha signals
+        else if (task.includes('careful') || task.includes('avoid') || task.includes('pitfall')) {
+            category = 'gotchas';
+        }
+    }
+    // Generate title from task or error
+    const title = context.errorEncountered
+        ? `Fix: ${context.errorEncountered.substring(0, 50)}`
+        : context.taskDescription?.substring(0, 50) || 'Auto-captured entry';
+    // Extract tags from context
+    const tags = [];
+    if (context.filesModified) {
+        // Add file extension tags
+        const extensions = new Set(context.filesModified
+            .map(f => f.split('.').pop())
+            .filter(Boolean));
+        tags.push(...Array.from(extensions));
+    }
+    if (signal) {
+        tags.push(`auto:${signal}`);
+    }
+    // Generate stub content
+    const stubContent = (0, index_js_1.generateStubContent)(category);
+    return {
+        category,
+        title: title.replace(/[^\w\s-]/g, '').trim(),
+        tags,
+        content: stubContent,
+        trigger: context.errorEncountered
+    };
+}
+/**
+ * Formats a captured entry into a readable context string for Claude Code.
+ */
+function formatEntryForContext(entry, signal) {
+    return `## Captured Entry: ${entry.frontmatter.title}\nCategory: ${entry.category}\nSignal: ${signal}\nPath: ${entry.path}\n\n${entry.content.substring(0, 300)}...`;
+}
+exports.default = onPostTask;
+//# sourceMappingURL=post-task.js.map