solvdex 1.0.0

package/dist/src/types.d.ts

@@ -0,0 +1,270 @@
+export type EntryStatus = 'active' | 'flagged' | 'deprecated';
+export type EntryMaturity = 'captured' | 'verified' | 'validated';
+export type Confidence = number;
+export type AuditAction = 'created' | 'updated' | 'validated' | 'flagged' | 'deprecated' | 'maturity_promoted';
+/**
+ * Confidence level constants for the 0-100 scale.
+ * HIGH: Verified solution, used multiple times
+ * MEDIUM: Worked once or partially verified
+ * LOW: Stub or unverified
+ * THRESHOLD: Minimum confidence for auto-lookup
+ */
+export declare const CONFIDENCE: {
+    readonly HIGH: 80;
+    readonly MEDIUM: 50;
+    readonly LOW: 20;
+    readonly THRESHOLD: 40;
+    readonly MAX: 100;
+    readonly MIN: 0;
+};
+/**
+ * Maturity progression rules.
+ * Entries automatically advance through maturity phases based on usage.
+ */
+export declare const MATURITY_RULES: {
+    readonly captured: {
+        readonly min_uses: 0;
+    };
+    readonly verified: {
+        readonly min_uses: 3;
+        readonly min_days: 0;
+    };
+    readonly validated: {
+        readonly min_uses: 10;
+        readonly min_days: 30;
+    };
+};
+/**
+ * Confidence levels automatically set based on maturity phase.
+ */
+export declare const CONFIDENCE_BY_MATURITY: Record<EntryMaturity, number>;
+export interface AuditEntry {
+    date: string;
+    action: AuditAction;
+    by: string;
+    context?: string;
+    reason?: string;
+}
+export interface EntryFrontmatter {
+    title: string;
+    created: string;
+    updated: string;
+    status: EntryStatus;
+    confidence: Confidence;
+    maturity?: EntryMaturity;
+    tags: string[];
+    trigger?: string;
+    project?: string;
+    auto_captured?: boolean;
+    stub?: boolean;
+    source?: string;
+    audit: AuditEntry[];
+    last_used?: string;
+    use_count?: number;
+    related_entries?: string[];
+}
+export interface WikiEntry {
+    path: string;
+    category: string;
+    slug: string;
+    frontmatter: EntryFrontmatter;
+    content: string;
+}
+export interface WikiConfig {
+    version: number;
+    project: string;
+    categories: string[];
+    auto_capture: {
+        enabled: boolean;
+        signals: string[];
+    };
+    auto_lookup: {
+        on_task_start: boolean;
+        on_uncertainty: boolean;
+        on_error: boolean;
+        confidence_threshold: number;
+    };
+    validation: {
+        auto_flag_broken_refs: boolean;
+        auto_flag_failed_solutions: boolean;
+    };
+}
+export interface SearchResult {
+    entry: WikiEntry;
+    score: number;
+    matchedOn: ('title' | 'tags' | 'trigger' | 'content')[];
+}
+export interface ScanCandidate {
+    title: string;
+    category: string;
+    source: string;
+    sourceType: 'git' | 'file' | 'comment';
+    tags: string[];
+    files?: string[];
+    externalDocs?: string[];
+}
+export interface WikiStats {
+    total: number;
+    active: number;
+    flagged: number;
+    deprecated: number;
+    stubs: number;
+    byCategory: Record<string, number>;
+}
+/**
+ * Default wiki categories covering the full development lifecycle.
+ * - issues: Bug fixes, error solutions, troubleshooting
+ * - patterns: Reusable code patterns, templates, approaches
+ * - gotchas: Pitfalls, traps, things to avoid
+ * - testing: Test strategies, mocks, fixtures, test patterns
+ * - docs: Documentation templates, guides, API docs
+ * - security: Auth patterns, vulnerabilities, CSRF/XSS/injection prevention
+ * - performance: Optimizations, profiling, benchmarks
+ */
+export declare const DEFAULT_CATEGORIES: readonly ["issues", "patterns", "gotchas", "testing", "docs", "security", "performance"];
+export type DefaultCategory = typeof DEFAULT_CATEGORIES[number];
+/**
+ * Base hook output structure for Claude Code integration.
+ */
+export interface HookOutput {
+    continue: boolean;
+    hookSpecificOutput?: Record<string, unknown>;
+    additionalContext?: string;
+}
+/**
+ * Output for session-start hook.
+ * Includes both old format (for backward compatibility) and new Claude Code format.
+ */
+export interface SessionStartOutput extends HookOutput {
+    type: 'wiki_context';
+    message: string;
+    categories: string[];
+    entries?: Array<{
+        title: string;
+        category: string;
+        path: string;
+    }>;
+    hookSpecificOutput?: {
+        type: 'wiki_context';
+        message: string;
+        categories: string[];
+        entries?: Array<{
+            title: string;
+            category: string;
+            path: string;
+        }>;
+    };
+}
+/**
+ * Output for error-lookup hook.
+ * Includes both old format (for backward compatibility) and new Claude Code format.
+ */
+export interface ErrorLookupOutput extends HookOutput {
+    type: 'wiki_solution';
+    message: string;
+    entry: WikiEntry;
+    hookSpecificOutput?: {
+        type: 'solution_found';
+        message: string;
+        entries?: Array<{
+            title: string;
+            category: string;
+            path: string;
+            confidence: number;
+        }>;
+    };
+}
+/**
+ * Output for prompt-enrich hook.
+ * Includes both old format (for backward compatibility) and new Claude Code format.
+ */
+export interface PromptEnrichOutput extends HookOutput {
+    type: 'wiki_context';
+    message: string;
+    entries: Array<{
+        title: string;
+        category: string;
+        path: string;
+        confidence: number;
+    }>;
+    hookSpecificOutput?: {
+        type: 'context_added';
+        message: string;
+        entryCount: number;
+    };
+}
+/**
+ * Output for post-task hook.
+ * Includes both old format (for backward compatibility) and new Claude Code format.
+ */
+export interface PostTaskOutput extends HookOutput {
+    type: 'wiki_captured';
+    message: string;
+    entry: WikiEntry;
+    signal: string;
+    hookSpecificOutput?: {
+        type: 'entry_captured';
+        message: string;
+        entryPath?: string;
+    };
+}
+/**
+ * Context for session-start hook.
+ */
+export interface SessionStartContext {
+    projectRoot: string;
+    taskDescription?: string;
+    filePaths?: string[];
+}
+/**
+ * Context for error-lookup hook.
+ */
+export interface ErrorLookupContext {
+    projectRoot: string;
+    errorText?: string;
+    errorContext?: string;
+    toolResult?: {
+        stderr?: string;
+    };
+}
+/**
+ * Context for prompt-enrich hook.
+ */
+export interface PromptEnrichContext {
+    projectRoot: string;
+    prompt: string;
+    context?: string;
+    filePaths?: string[];
+}
+/**
+ * Context for post-task hook.
+ */
+export interface PostTaskContext {
+    projectRoot: string;
+    taskDescription?: string;
+    outcome?: 'success' | 'failure';
+    errorEncountered?: string;
+    errorResolved?: boolean;
+    filesModified?: string[];
+    userConfirmation?: string;
+    codeChanges?: string;
+    actionHistory?: string[];
+    success?: boolean;
+}
+/**
+ * Validates session-start hook input.
+ */
+export declare function validateSessionStartInput(data: unknown): SessionStartContext;
+/**
+ * Validates error-lookup hook input.
+ */
+export declare function validateErrorLookupInput(data: unknown): ErrorLookupContext;
+/**
+ * Validates prompt-enrich hook input.
+ */
+export declare function validatePromptEnrichInput(data: unknown): PromptEnrichContext;
+/**
+ * Validates post-task hook input.
+ */
+export declare function validatePostTaskInput(data: unknown): PostTaskContext;
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

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

package/dist/src/types.js

@@ -0,0 +1,153 @@
+"use strict";
+// src/types.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CATEGORIES = exports.CONFIDENCE_BY_MATURITY = exports.MATURITY_RULES = exports.CONFIDENCE = void 0;
+exports.validateSessionStartInput = validateSessionStartInput;
+exports.validateErrorLookupInput = validateErrorLookupInput;
+exports.validatePromptEnrichInput = validatePromptEnrichInput;
+exports.validatePostTaskInput = validatePostTaskInput;
+/**
+ * Confidence level constants for the 0-100 scale.
+ * HIGH: Verified solution, used multiple times
+ * MEDIUM: Worked once or partially verified
+ * LOW: Stub or unverified
+ * THRESHOLD: Minimum confidence for auto-lookup
+ */
+exports.CONFIDENCE = {
+    HIGH: 80,
+    MEDIUM: 50,
+    LOW: 20,
+    THRESHOLD: 40,
+    MAX: 100,
+    MIN: 0
+};
+/**
+ * Maturity progression rules.
+ * Entries automatically advance through maturity phases based on usage.
+ */
+exports.MATURITY_RULES = {
+    captured: {
+        min_uses: 0
+    },
+    verified: {
+        min_uses: 3,
+        min_days: 0
+    },
+    validated: {
+        min_uses: 10,
+        min_days: 30
+    }
+};
+/**
+ * Confidence levels automatically set based on maturity phase.
+ */
+exports.CONFIDENCE_BY_MATURITY = {
+    captured: 40,
+    verified: 70,
+    validated: 90
+};
+/**
+ * Default wiki categories covering the full development lifecycle.
+ * - issues: Bug fixes, error solutions, troubleshooting
+ * - patterns: Reusable code patterns, templates, approaches
+ * - gotchas: Pitfalls, traps, things to avoid
+ * - testing: Test strategies, mocks, fixtures, test patterns
+ * - docs: Documentation templates, guides, API docs
+ * - security: Auth patterns, vulnerabilities, CSRF/XSS/injection prevention
+ * - performance: Optimizations, profiling, benchmarks
+ */
+exports.DEFAULT_CATEGORIES = [
+    'issues',
+    'patterns',
+    'gotchas',
+    'testing',
+    'docs',
+    'security',
+    'performance'
+];
+// Validation functions - Import ValidationError from errors.ts
+const errors_js_1 = require("./errors.js");
+/**
+ * Validates session-start hook input.
+ */
+function validateSessionStartInput(data) {
+    if (!data || typeof data !== 'object') {
+        throw new errors_js_1.ValidationError('Invalid hook input: not an object', []);
+    }
+    const input = data;
+    if (!input.projectRoot || typeof input.projectRoot !== 'string') {
+        throw new errors_js_1.ValidationError('Invalid hook input: projectRoot required', []);
+    }
+    return {
+        projectRoot: input.projectRoot,
+        taskDescription: typeof input.taskDescription === 'string' ? input.taskDescription : undefined,
+        filePaths: Array.isArray(input.filePaths) ? input.filePaths : undefined
+    };
+}
+/**
+ * Validates error-lookup hook input.
+ */
+function validateErrorLookupInput(data) {
+    if (!data || typeof data !== 'object') {
+        throw new errors_js_1.ValidationError('Invalid hook input: not an object', []);
+    }
+    const input = data;
+    if (!input.projectRoot || typeof input.projectRoot !== 'string') {
+        throw new errors_js_1.ValidationError('Invalid hook input: projectRoot required', []);
+    }
+    // errorText is optional because it can come from toolResult.stderr
+    return {
+        projectRoot: input.projectRoot,
+        errorText: typeof input.errorText === 'string' ? input.errorText : undefined,
+        errorContext: typeof input.errorContext === 'string' ? input.errorContext : undefined,
+        toolResult: input.toolResult && typeof input.toolResult === 'object'
+            ? input.toolResult
+            : undefined
+    };
+}
+/**
+ * Validates prompt-enrich hook input.
+ */
+function validatePromptEnrichInput(data) {
+    if (!data || typeof data !== 'object') {
+        throw new errors_js_1.ValidationError('Invalid hook input: not an object', []);
+    }
+    const input = data;
+    if (!input.projectRoot || typeof input.projectRoot !== 'string') {
+        throw new errors_js_1.ValidationError('Invalid hook input: projectRoot required', []);
+    }
+    if (!input.prompt || typeof input.prompt !== 'string') {
+        throw new errors_js_1.ValidationError('Invalid hook input: prompt required', []);
+    }
+    return {
+        projectRoot: input.projectRoot,
+        prompt: input.prompt,
+        context: typeof input.context === 'string' ? input.context : undefined,
+        filePaths: Array.isArray(input.filePaths) ? input.filePaths : undefined
+    };
+}
+/**
+ * Validates post-task hook input.
+ */
+function validatePostTaskInput(data) {
+    if (!data || typeof data !== 'object') {
+        throw new errors_js_1.ValidationError('Invalid hook input: not an object', []);
+    }
+    const input = data;
+    if (!input.projectRoot || typeof input.projectRoot !== 'string') {
+        throw new errors_js_1.ValidationError('Invalid hook input: projectRoot required', []);
+    }
+    return {
+        projectRoot: input.projectRoot,
+        taskDescription: typeof input.taskDescription === 'string' ? input.taskDescription : undefined,
+        outcome: input.outcome === 'success' || input.outcome === 'failure' ? input.outcome : undefined,
+        errorEncountered: typeof input.errorEncountered === 'string' ? input.errorEncountered : undefined,
+        errorResolved: typeof input.errorResolved === 'boolean' ? input.errorResolved : undefined,
+        filesModified: Array.isArray(input.filesModified) ? input.filesModified : undefined,
+        userConfirmation: typeof input.userConfirmation === 'string' ? input.userConfirmation : undefined,
+        codeChanges: typeof input.codeChanges === 'string' ? input.codeChanges : undefined,
+        actionHistory: Array.isArray(input.actionHistory) ? input.actionHistory : undefined,
+        success: typeof input.success === 'boolean' ? input.success : undefined
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

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

package/dist/src/validate.d.ts

@@ -0,0 +1,90 @@
+import { WikiEntry } from './types.js';
+/**
+ * Types of validation issues that can be detected.
+ */
+export type ValidationIssueType = 'broken_reference' | 'missing_c3' | 'flagged' | 'stub';
+/**
+ * Represents a single validation issue found in an entry.
+ */
+export interface ValidationIssue {
+    type: ValidationIssueType;
+    message: string;
+    entryPath: string;
+}
+/**
+ * Report containing validation results for the entire wiki.
+ */
+export interface ValidationReport {
+    total: number;
+    active: number;
+    flagged: number;
+    deprecated: number;
+    issues: ValidationIssue[];
+}
+/**
+ * Direction for confidence adjustment.
+ */
+export type ConfidenceDirection = 'up' | 'down';
+/**
+ * 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
+ */
+export declare function validateEntry(projectRoot: string, entryPath: string): ValidationIssue[];
+/**
+ * Validates the entire wiki and returns a comprehensive report.
+ *
+ * @param projectRoot - The root directory of the project
+ * @returns Validation report with counts and issues
+ */
+export declare function validateWiki(projectRoot: string): Promise<ValidationReport>;
+/**
+ * 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
+ */
+export declare function flagEntry(projectRoot: string, entryPath: string, reason: string): WikiEntry;
+/**
+ * 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
+ */
+export declare function deprecateEntry(projectRoot: string, entryPath: string, reason: string): WikiEntry;
+/**
+ * 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
+ */
+export declare function adjustConfidence(projectRoot: string, entryPath: string, direction: ConfidenceDirection): WikiEntry;
+/**
+ * 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
+ */
+export declare function markSolutionWorked(projectRoot: string, entryPath: string): WikiEntry;
+/**
+ * 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
+ */
+export declare function markSolutionFailed(projectRoot: string, entryPath: string): WikiEntry;
+//# sourceMappingURL=validate.d.ts.map

package/dist/src/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/validate.ts"],"names":[],"mappings":"AAGA,OAAO,EAAc,SAAS,EAAE,MAAM,YAAY,CAAC;AAGnD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,GAAG,YAAY,GAAG,SAAS,GAAG,MAAM,CAAC;AAEzF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,IAAI,GAAG,MAAM,CAAC;AA0DhD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,eAAe,EAAE,CA2DnB;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,CAAC,CA+B3B;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,SAAS,CAWX;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,SAAS,CAWX;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,mBAAmB,GAC7B,SAAS,CAqCX;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,SAAS,CAyBX;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,SAAS,CAGX"}