solvdex 1.0.0

package/dist/src/validate.js

@@ -0,0 +1,295 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateEntry = validateEntry;
+exports.validateWiki = validateWiki;
+exports.flagEntry = flagEntry;
+exports.deprecateEntry = deprecateEntry;
+exports.adjustConfidence = adjustConfidence;
+exports.markSolutionWorked = markSolutionWorked;
+exports.markSolutionFailed = markSolutionFailed;
+// src/validate.ts
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const types_js_1 = require("./types.js");
+const entry_js_1 = require("./entry.js");
+/**
+ * Extracts file references from content (backtick paths like `src/file.ts`).
+ *
+ * @param content - The markdown content to search
+ * @returns Array of file paths found in backticks
+ */
+function extractFileReferences(content) {
+    // Match backtick-enclosed paths that look like file paths
+    // Pattern: `path/to/file.ext` or `./path/to/file.ext` or `../path/to/file.ext`
+    const regex = /`((?:\.{0,2}\/)?[\w./-]+\.\w+)`/g;
+    const matches = [];
+    let match;
+    while ((match = regex.exec(content)) !== null) {
+        const filePath = match[1];
+        // Filter out obvious non-file-paths (URLs, etc.)
+        if (!filePath.includes('://') && !filePath.startsWith('http')) {
+            matches.push(filePath);
+        }
+    }
+    return matches;
+}
+/**
+ * Extracts C3 references from content ([[c3-component]]).
+ *
+ * @param content - The markdown content to search
+ * @returns Array of C3 references found
+ */
+function extractC3References(content) {
+    // Match [[c3-xxx]] pattern
+    const regex = /\[\[(c3-[\w-]+)\]\]/g;
+    const matches = [];
+    let match;
+    while ((match = regex.exec(content)) !== null) {
+        matches.push(match[1]);
+    }
+    return matches;
+}
+/**
+ * Checks if a file exists relative to the project root.
+ *
+ * @param projectRoot - The root directory of the project
+ * @param filePath - The file path to check
+ * @returns True if the file exists
+ */
+function fileExists(projectRoot, filePath) {
+    const fullPath = path.join(projectRoot, filePath);
+    return fs.existsSync(fullPath);
+}
+/**
+ * Validates a single wiki entry for issues.
+ *
+ * @param projectRoot - The root directory of the project
+ * @param entryPath - Relative path to the entry from the wiki directory
+ * @returns Array of validation issues found
+ */
+function validateEntry(projectRoot, entryPath) {
+    const entry = (0, entry_js_1.readEntry)(projectRoot, entryPath);
+    if (!entry) {
+        return [{
+                type: 'broken_reference',
+                message: `Entry not found: ${entryPath}`,
+                entryPath
+            }];
+    }
+    const issues = [];
+    // Check for broken file references
+    const fileRefs = extractFileReferences(entry.content);
+    for (const fileRef of fileRefs) {
+        if (!fileExists(projectRoot, fileRef)) {
+            issues.push({
+                type: 'broken_reference',
+                message: `Broken file reference: ${fileRef}`,
+                entryPath
+            });
+        }
+    }
+    // Check for missing C3 references (C3 refs that don't resolve)
+    // For now, we just check if the C3 reference format is used but can't be validated
+    // This is a placeholder for when C3 integration is implemented
+    const c3Refs = extractC3References(entry.content);
+    const c3Path = path.join(projectRoot, '.c3');
+    if (c3Refs.length > 0 && !fs.existsSync(c3Path)) {
+        for (const c3Ref of c3Refs) {
+            issues.push({
+                type: 'missing_c3',
+                message: `C3 reference cannot be validated (no .c3 directory): ${c3Ref}`,
+                entryPath
+            });
+        }
+    }
+    // Check if entry is flagged
+    if (entry.frontmatter.status === 'flagged') {
+        issues.push({
+            type: 'flagged',
+            message: `Entry is flagged for review`,
+            entryPath
+        });
+    }
+    // Check if entry is a stub
+    if (entry.frontmatter.stub) {
+        issues.push({
+            type: 'stub',
+            message: `Entry is a stub and needs expansion`,
+            entryPath
+        });
+    }
+    return issues;
+}
+/**
+ * Validates the entire wiki and returns a comprehensive report.
+ *
+ * @param projectRoot - The root directory of the project
+ * @returns Validation report with counts and issues
+ */
+async function validateWiki(projectRoot) {
+    const entries = await (0, entry_js_1.listEntries)(projectRoot);
+    const report = {
+        total: entries.length,
+        active: 0,
+        flagged: 0,
+        deprecated: 0,
+        issues: []
+    };
+    for (const entry of entries) {
+        // Count by status
+        switch (entry.frontmatter.status) {
+            case 'active':
+                report.active++;
+                break;
+            case 'flagged':
+                report.flagged++;
+                break;
+            case 'deprecated':
+                report.deprecated++;
+                break;
+        }
+        // Validate each entry and collect issues
+        const entryIssues = validateEntry(projectRoot, entry.path);
+        report.issues.push(...entryIssues);
+    }
+    return report;
+}
+/**
+ * Marks an entry as flagged with the given reason.
+ *
+ * @param projectRoot - The root directory of the project
+ * @param entryPath - Relative path to the entry from the wiki directory
+ * @param reason - The reason for flagging the entry
+ * @returns The updated WikiEntry
+ */
+function flagEntry(projectRoot, entryPath, reason) {
+    return (0, entry_js_1.updateEntry)(projectRoot, entryPath, { status: 'flagged' }, {
+        by: 'claude',
+        reason,
+        context: 'validation'
+    });
+}
+/**
+ * Marks an entry as deprecated with the given reason.
+ *
+ * @param projectRoot - The root directory of the project
+ * @param entryPath - Relative path to the entry from the wiki directory
+ * @param reason - The reason for deprecating the entry
+ * @returns The updated WikiEntry
+ */
+function deprecateEntry(projectRoot, entryPath, reason) {
+    return (0, entry_js_1.updateEntry)(projectRoot, entryPath, { status: 'deprecated' }, {
+        by: 'claude',
+        reason,
+        context: 'validation'
+    });
+}
+/**
+ * Adjusts the confidence level of an entry up or down.
+ * Up: +20 points (capped at 100)
+ * Down: -30 points (auto-flag if result < 40)
+ *
+ * @param projectRoot - The root directory of the project
+ * @param entryPath - Relative path to the entry from the wiki directory
+ * @param direction - 'up' to increase confidence, 'down' to decrease
+ * @returns The updated WikiEntry
+ * @throws Error if entry not found
+ */
+function adjustConfidence(projectRoot, entryPath, direction) {
+    const entry = (0, entry_js_1.readEntry)(projectRoot, entryPath);
+    if (!entry) {
+        throw new Error(`Entry not found: ${entryPath}`);
+    }
+    const currentConfidence = entry.frontmatter.confidence;
+    let newConfidence;
+    if (direction === 'up') {
+        newConfidence = Math.min(currentConfidence + 20, types_js_1.CONFIDENCE.MAX);
+    }
+    else {
+        newConfidence = Math.max(currentConfidence - 30, types_js_1.CONFIDENCE.MIN);
+    }
+    // Only update if confidence actually changed
+    if (newConfidence === currentConfidence) {
+        return entry;
+    }
+    // Auto-flag if confidence drops below threshold
+    const shouldFlag = direction === 'down' && newConfidence < types_js_1.CONFIDENCE.THRESHOLD;
+    return (0, entry_js_1.updateEntry)(projectRoot, entryPath, {
+        confidence: newConfidence,
+        ...(shouldFlag ? { status: 'flagged' } : {})
+    }, {
+        by: 'claude',
+        context: `confidence adjusted ${direction}`,
+        reason: `Confidence changed from ${currentConfidence} to ${newConfidence}${shouldFlag ? ' (auto-flagged: below threshold)' : ''}`
+    });
+}
+/**
+ * Marks that a solution from an entry worked, increasing its confidence.
+ *
+ * @param projectRoot - The root directory of the project
+ * @param entryPath - Relative path to the entry from the wiki directory
+ * @returns The updated WikiEntry
+ */
+function markSolutionWorked(projectRoot, entryPath) {
+    const entry = (0, entry_js_1.readEntry)(projectRoot, entryPath);
+    if (!entry) {
+        throw new Error(`Entry not found: ${entryPath}`);
+    }
+    // Increase confidence
+    const updatedEntry = adjustConfidence(projectRoot, entryPath, 'up');
+    // Add a validated audit entry if confidence changed
+    if (updatedEntry.frontmatter.confidence !== entry.frontmatter.confidence) {
+        return (0, entry_js_1.updateEntry)(projectRoot, entryPath, {}, {
+            by: 'claude',
+            context: 'solution-validated',
+            reason: 'Solution worked successfully'
+        });
+    }
+    return updatedEntry;
+}
+/**
+ * Marks that a solution from an entry failed, decreasing its confidence.
+ * Auto-flags if confidence drops below threshold (handled by adjustConfidence).
+ *
+ * @param projectRoot - The root directory of the project
+ * @param entryPath - Relative path to the entry from the wiki directory
+ * @returns The updated WikiEntry
+ */
+function markSolutionFailed(projectRoot, entryPath) {
+    // Decrease confidence (auto-flags if below threshold)
+    return adjustConfidence(projectRoot, entryPath, 'down');
+}
+//# sourceMappingURL=validate.js.map

package/dist/src/validate.js.map

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

package/hooks/error-lookup.ts

@@ -0,0 +1,110 @@
+// hooks/error-lookup.ts
+import {
+  wikiExists,
+  matchTrigger,
+  getBestMatch,
+  WikiEntry,
+  CONFIDENCE,
+  ErrorLookupOutput,
+  SearchResult,
+  validateErrorLookupInput,
+  ValidationError,
+  ErrorLookupContext
+} from '../src/index.js';
+
+/**
+ * Extracts the solution section from wiki entry content.
+ */
+function extractSolution(content: string): string {
+  // 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) + '...';
+}
+
+export async function onErrorLookup(input: unknown): Promise<ErrorLookupOutput | null> {
+  try {
+    // Validate input first
+    const validatedInput = validateErrorLookupInput(input);
+    const { projectRoot, errorText, toolResult } = validatedInput;
+
+    // Get error text from either direct input or tool stderr
+    const error = errorText || toolResult?.stderr || '';
+
+    if (!error || !wikiExists(projectRoot)) {
+      return null;
+    }
+
+    // Try to match error against trigger patterns
+    const results = await matchTrigger(projectRoot, error);
+    const bestMatch = getBestMatch(results);
+
+    if (bestMatch && bestMatch.entry.frontmatter.confidence >= 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: ErrorLookupOutput = {
+        // 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 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: SearchResult): string {
+  const e = match.entry;
+  return `## ${e.frontmatter.title} (${e.category})\nConfidence: ${e.frontmatter.confidence}\n\n${e.content}`;
+}
+
+export default onErrorLookup;

package/hooks/hooks.json

@@ -0,0 +1,49 @@
+{
+  "description": "Solvdex wiki hooks for auto-capture and retrieval",
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/session-start.py",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/prompt-enrich.py",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "PostToolUseFailure": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/error-lookup.py",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/post-task.py",
+            "timeout": 30
+          }
+        ]
+      }
+    ]
+  }
+}