solvdex 1.0.0

package/dist/src/entry.js

@@ -0,0 +1,469 @@
+"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.slugify = slugify;
+exports.createEntry = createEntry;
+exports.readEntry = readEntry;
+exports.updateEntry = updateEntry;
+exports.listEntries = listEntries;
+exports.deleteEntry = deleteEntry;
+exports.checkDuplicate = checkDuplicate;
+exports.recordEntryUsage = recordEntryUsage;
+exports.getRelatedEntries = getRelatedEntries;
+exports.setRelatedEntries = setRelatedEntries;
+exports.createEntryWithValidation = createEntryWithValidation;
+// src/entry.ts
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const glob_1 = require("glob");
+const frontmatter_js_1 = require("./frontmatter.js");
+const config_js_1 = require("./config.js");
+const quality_js_1 = require("./quality.js");
+const similarity_js_1 = require("./similarity.js");
+const maturity_js_1 = require("./maturity.js");
+const errors_js_1 = require("./errors.js");
+const cache_js_1 = require("./cache.js");
+/**
+ * Converts a title to a URL-friendly slug.
+ *
+ * @param title - The title to convert
+ * @returns A lowercase, hyphenated slug
+ */
+function slugify(title) {
+    return title
+        .toLowerCase()
+        .trim()
+        .replace(/[^\w\s-]/g, '') // Remove non-word chars (except spaces and hyphens)
+        .replace(/\s+/g, '-') // Replace spaces with hyphens
+        .replace(/-+/g, '-') // Replace multiple hyphens with single hyphen
+        .replace(/^-+|-+$/g, ''); // Remove leading/trailing hyphens
+}
+/**
+ * Generates the current date in ISO format (YYYY-MM-DD).
+ *
+ * @returns Current date string
+ */
+function getCurrentDate() {
+    return new Date().toISOString().split('T')[0];
+}
+/**
+ * Converts a content record to markdown body.
+ *
+ * @param content - Record of heading -> content
+ * @returns Formatted markdown string
+ */
+function contentRecordToMarkdown(content) {
+    const sections = [];
+    for (const [heading, body] of Object.entries(content)) {
+        sections.push(`# ${heading}\n\n${body}`);
+    }
+    return sections.join('\n\n');
+}
+/**
+ * Creates a new wiki entry.
+ *
+ * @param projectRoot - The root directory of the project
+ * @param options - Options for creating the entry
+ * @returns The created WikiEntry
+ * @throws Error if wiki is not initialized or category is invalid
+ */
+function createEntry(projectRoot, options) {
+    if (!(0, config_js_1.wikiExists)(projectRoot)) {
+        throw new errors_js_1.WikiNotInitializedError(projectRoot);
+    }
+    const { category, title, tags, content, trigger, autoCapture, stub, source, confidence, context } = options;
+    const slug = slugify(title);
+    const wikiPath = (0, config_js_1.getWikiPath)(projectRoot);
+    const categoryDir = path.join(wikiPath, category);
+    const entryPath = path.join(categoryDir, `${slug}.md`);
+    // Create category directory if it doesn't exist
+    if (!fs.existsSync(categoryDir)) {
+        fs.mkdirSync(categoryDir, { recursive: true });
+    }
+    const now = getCurrentDate();
+    const auditEntry = {
+        date: now,
+        action: 'created',
+        by: autoCapture ? 'claude' : 'user'
+    };
+    // Add audit context - use provided context, or default based on capture method
+    if (context) {
+        auditEntry.context = context;
+    }
+    else if (autoCapture) {
+        auditEntry.context = 'auto-captured';
+    }
+    const frontmatter = {
+        title,
+        created: now,
+        updated: now,
+        status: 'active',
+        confidence: confidence || (0, maturity_js_1.getConfidenceForMaturity)('captured'),
+        maturity: 'captured', // All entries start as captured
+        tags,
+        audit: [auditEntry],
+        use_count: 0 // Initialize use counter
+    };
+    // Add optional fields
+    if (trigger) {
+        frontmatter.trigger = trigger;
+    }
+    if (autoCapture !== undefined) {
+        frontmatter.auto_captured = autoCapture;
+    }
+    if (stub !== undefined) {
+        frontmatter.stub = stub;
+    }
+    if (source) {
+        frontmatter.source = source;
+    }
+    const markdownContent = contentRecordToMarkdown(content);
+    const fileContent = (0, frontmatter_js_1.stringifyFrontmatter)(frontmatter, markdownContent);
+    (0, errors_js_1.wrapFileOperation)('create', entryPath, () => fs.writeFileSync(entryPath, fileContent, 'utf-8'));
+    // Return relative path from wiki directory
+    const relativePath = path.relative(wikiPath, entryPath);
+    return {
+        path: relativePath,
+        category,
+        slug,
+        frontmatter,
+        content: markdownContent
+    };
+}
+/**
+ * Reads an existing wiki entry.
+ *
+ * @param projectRoot - The root directory of the project
+ * @param entryPath - Relative path to the entry from the wiki directory
+ * @returns The WikiEntry if found, null otherwise
+ */
+function readEntry(projectRoot, entryPath) {
+    const wikiPath = (0, config_js_1.getWikiPath)(projectRoot);
+    const fullPath = path.join(wikiPath, entryPath);
+    if (!fs.existsSync(fullPath)) {
+        return null;
+    }
+    // CHECK CACHE FIRST
+    const cached = (0, cache_js_1.getCachedEntry)(fullPath);
+    if (cached) {
+        return cached;
+    }
+    // Cache miss - read from disk with error wrapping
+    const fileContent = (0, errors_js_1.wrapFileOperation)('read', fullPath, () => fs.readFileSync(fullPath, 'utf-8'));
+    const { frontmatter, content } = (0, frontmatter_js_1.parseFrontmatter)(fileContent);
+    // Extract category and slug from path
+    const pathParts = entryPath.split(path.sep);
+    const category = pathParts[0];
+    const slug = path.basename(entryPath, '.md');
+    const entry = {
+        path: entryPath,
+        category,
+        slug,
+        frontmatter,
+        content
+    };
+    // CACHE BEFORE RETURNING
+    (0, cache_js_1.setCachedEntry)(fullPath, entry);
+    return entry;
+}
+/**
+ * Updates an existing wiki entry.
+ *
+ * @param projectRoot - The root directory of the project
+ * @param entryPath - Relative path to the entry from the wiki directory
+ * @param updates - Fields to update
+ * @param auditContext - Context for the audit trail entry
+ * @returns The updated WikiEntry
+ * @throws Error if entry does not exist
+ */
+function updateEntry(projectRoot, entryPath, updates, auditContext) {
+    const existing = readEntry(projectRoot, entryPath);
+    if (!existing) {
+        const wikiPath = (0, config_js_1.getWikiPath)(projectRoot);
+        const fullPath = path.join(wikiPath, entryPath);
+        throw new errors_js_1.EntryNotFoundError(fullPath, projectRoot);
+    }
+    const now = getCurrentDate();
+    // Create updated frontmatter
+    const updatedFrontmatter = {
+        ...existing.frontmatter,
+        updated: now
+    };
+    // Apply updates
+    if (updates.title !== undefined) {
+        updatedFrontmatter.title = updates.title;
+    }
+    if (updates.tags !== undefined) {
+        updatedFrontmatter.tags = updates.tags;
+    }
+    if (updates.status !== undefined) {
+        updatedFrontmatter.status = updates.status;
+    }
+    if (updates.confidence !== undefined) {
+        updatedFrontmatter.confidence = updates.confidence;
+    }
+    if (updates.trigger !== undefined) {
+        updatedFrontmatter.trigger = updates.trigger;
+    }
+    // Determine audit action based on updates
+    let action = 'updated';
+    if (updates.status === 'flagged') {
+        action = 'flagged';
+    }
+    else if (updates.status === 'deprecated') {
+        action = 'deprecated';
+    }
+    // Add audit entry
+    const auditEntry = {
+        date: now,
+        action,
+        by: auditContext.by
+    };
+    if (auditContext.reason) {
+        auditEntry.reason = auditContext.reason;
+    }
+    if (auditContext.context) {
+        auditEntry.context = auditContext.context;
+    }
+    updatedFrontmatter.audit = [...existing.frontmatter.audit, auditEntry];
+    // Determine content
+    const updatedContent = updates.content !== undefined ? updates.content : existing.content;
+    // Write updated entry
+    const wikiPath = (0, config_js_1.getWikiPath)(projectRoot);
+    const fullPath = path.join(wikiPath, entryPath);
+    const fileContent = (0, frontmatter_js_1.stringifyFrontmatter)(updatedFrontmatter, updatedContent);
+    (0, errors_js_1.wrapFileOperation)('write', fullPath, () => fs.writeFileSync(fullPath, fileContent, 'utf-8'));
+    // Invalidate cache after update
+    (0, cache_js_1.invalidateCache)(fullPath);
+    return {
+        path: entryPath,
+        category: existing.category,
+        slug: existing.slug,
+        frontmatter: updatedFrontmatter,
+        content: updatedContent
+    };
+}
+/**
+ * Lists all wiki entries with optional filtering.
+ *
+ * @param projectRoot - The root directory of the project
+ * @param options - Optional filters for category, status, or tags
+ * @returns Array of WikiEntry objects matching the filters
+ */
+async function listEntries(projectRoot, options = {}) {
+    const wikiPath = (0, config_js_1.getWikiPath)(projectRoot);
+    if (!fs.existsSync(wikiPath)) {
+        return [];
+    }
+    // Determine glob pattern based on category filter
+    let pattern;
+    if (options.category) {
+        pattern = path.join(wikiPath, options.category, '*.md');
+    }
+    else {
+        pattern = path.join(wikiPath, '**', '*.md');
+    }
+    const files = await (0, glob_1.glob)(pattern, { nodir: true });
+    const entries = [];
+    for (const filePath of files) {
+        const relativePath = path.relative(wikiPath, filePath);
+        // Skip config files and overview files
+        if (relativePath.startsWith('.') || relativePath.includes('_overview.md')) {
+            continue;
+        }
+        const entry = readEntry(projectRoot, relativePath);
+        if (!entry || !entry.frontmatter.updated) {
+            continue;
+        }
+        // Apply status filter
+        if (options.status && entry.frontmatter.status !== options.status) {
+            continue;
+        }
+        // Apply tags filter (entry must have all specified tags)
+        if (options.tags && options.tags.length > 0) {
+            const hasAllTags = options.tags.every(tag => entry.frontmatter.tags.includes(tag));
+            if (!hasAllTags) {
+                continue;
+            }
+        }
+        entries.push(entry);
+    }
+    // Sort by updated date, most recent first
+    entries.sort((a, b) => b.frontmatter.updated.localeCompare(a.frontmatter.updated));
+    return entries;
+}
+/**
+ * Deletes a wiki entry.
+ *
+ * @param projectRoot - The root directory of the project
+ * @param entryPath - Relative path to the entry from the wiki directory
+ * @returns True if the entry was deleted, false if it didn't exist
+ */
+function deleteEntry(projectRoot, entryPath) {
+    const wikiPath = (0, config_js_1.getWikiPath)(projectRoot);
+    const fullPath = path.join(wikiPath, entryPath);
+    if (!fs.existsSync(fullPath)) {
+        return false;
+    }
+    (0, errors_js_1.wrapFileOperation)('delete', fullPath, () => fs.unlinkSync(fullPath));
+    // Invalidate cache after delete
+    (0, cache_js_1.invalidateCache)(fullPath);
+    return true;
+}
+/**
+ * Checks for duplicate entries before creating.
+ *
+ * @param projectRoot - The root directory of the project
+ * @param title - The title of the new entry
+ * @param tags - The tags of the new entry
+ * @param category - The category of the new entry
+ * @returns DuplicateCheckResult
+ */
+async function checkDuplicate(projectRoot, title, tags, category) {
+    const entries = await listEntries(projectRoot, { category });
+    return (0, similarity_js_1.checkForDuplicate)(title, tags, category, entries);
+}
+/**
+ * Records that an entry was used/accessed.
+ * Updates last_used timestamp, increments use_count, and checks for maturity promotion.
+ *
+ * @param projectRoot - The root directory of the project
+ * @param entryPath - Relative path to the entry
+ * @returns Updated WikiEntry
+ */
+function recordEntryUsage(projectRoot, entryPath) {
+    const entry = readEntry(projectRoot, entryPath);
+    if (!entry)
+        return null;
+    const wikiPath = (0, config_js_1.getWikiPath)(projectRoot);
+    const fullPath = path.join(wikiPath, entryPath);
+    const now = getCurrentDate();
+    // Increment use count
+    const newUseCount = (entry.frontmatter.use_count || 0) + 1;
+    // Calculate what maturity should be (remove maturity field to force fresh calculation)
+    const currentMaturity = entry.frontmatter.maturity || 'captured';
+    const { maturity: _, ...frontmatterWithoutMaturity } = entry.frontmatter;
+    const calculatedMaturity = (0, maturity_js_1.calculateMaturity)({
+        ...frontmatterWithoutMaturity,
+        use_count: newUseCount
+    });
+    // Check if we should promote
+    const shouldPromote = (0, maturity_js_1.shouldPromoteMaturity)(currentMaturity, calculatedMaturity);
+    // Flagged entries don't get promoted (frozen)
+    const canPromote = shouldPromote && entry.frontmatter.status !== 'flagged';
+    // Update frontmatter
+    const updatedFrontmatter = {
+        ...entry.frontmatter,
+        last_used: now,
+        use_count: newUseCount
+    };
+    // Apply maturity promotion if eligible
+    if (canPromote) {
+        updatedFrontmatter.maturity = calculatedMaturity;
+        updatedFrontmatter.confidence = (0, maturity_js_1.getConfidenceForMaturity)(calculatedMaturity);
+        updatedFrontmatter.updated = now;
+        // Add audit entry for promotion
+        const promotionAudit = {
+            date: now,
+            action: 'maturity_promoted',
+            by: 'system',
+            context: `Auto-promoted: ${currentMaturity} → ${calculatedMaturity} (${newUseCount} uses)`
+        };
+        updatedFrontmatter.audit = [...entry.frontmatter.audit, promotionAudit];
+    }
+    // Write updated entry
+    const fileContent = (0, frontmatter_js_1.stringifyFrontmatter)(updatedFrontmatter, entry.content);
+    (0, errors_js_1.wrapFileOperation)('write', fullPath, () => fs.writeFileSync(fullPath, fileContent, 'utf-8'));
+    (0, cache_js_1.invalidateCache)(fullPath);
+    return {
+        ...entry,
+        frontmatter: updatedFrontmatter
+    };
+}
+/**
+ * Finds and returns related entries for a given entry.
+ *
+ * @param projectRoot - The root directory of the project
+ * @param entryPath - Relative path to the entry
+ * @param maxResults - Maximum number of related entries
+ * @returns Array of related entry paths
+ */
+async function getRelatedEntries(projectRoot, entryPath, maxResults = 5) {
+    const entry = readEntry(projectRoot, entryPath);
+    if (!entry)
+        return [];
+    // Return stored relations if available
+    if (entry.frontmatter.related_entries && entry.frontmatter.related_entries.length > 0) {
+        return entry.frontmatter.related_entries;
+    }
+    // Otherwise compute dynamically
+    const allEntries = await listEntries(projectRoot);
+    return (0, similarity_js_1.findRelatedEntries)(entry, allEntries, maxResults);
+}
+/**
+ * Updates the related_entries field for an entry.
+ *
+ * @param projectRoot - The root directory of the project
+ * @param entryPath - Relative path to the entry
+ * @param relatedPaths - Array of related entry paths
+ */
+function setRelatedEntries(projectRoot, entryPath, _relatedPaths) {
+    return updateEntry(projectRoot, entryPath, {}, { by: 'system', context: 'updated related entries' });
+}
+/**
+ * Creates a new wiki entry and validates its quality.
+ * This is a convenience wrapper around createEntry that also runs quality checks.
+ * Optionally checks for duplicates before creating.
+ *
+ * @param projectRoot - The root directory of the project
+ * @param options - Options for creating the entry
+ * @returns The created WikiEntry, quality issues, and duplicate check result
+ * @throws Error if wiki is not initialized
+ */
+async function createEntryWithValidation(projectRoot, options) {
+    // Check for duplicates unless skipped
+    let duplicateCheck;
+    if (!options.skipDuplicateCheck) {
+        duplicateCheck = await checkDuplicate(projectRoot, options.title, options.tags, options.category);
+    }
+    const entry = createEntry(projectRoot, options);
+    const qualityIssues = (0, quality_js_1.validateEntryQuality)(projectRoot, entry.path);
+    return {
+        entry,
+        qualityIssues,
+        duplicateCheck
+    };
+}
+//# sourceMappingURL=entry.js.map

package/dist/src/entry.js.map

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

package/dist/src/errors.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Custom error classes for Solvdex
+ * Provides typed errors with context for better debugging
+ */
+/**
+ * Base error class for all Solvdex errors
+ */
+export declare class SolvdexError extends Error {
+    context: Record<string, unknown>;
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/**
+ * Thrown when wiki operations are attempted on a non-initialized wiki
+ */
+export declare class WikiNotInitializedError extends SolvdexError {
+    constructor(projectRoot: string);
+}
+/**
+ * Thrown when a wiki entry cannot be found
+ */
+export declare class EntryNotFoundError extends SolvdexError {
+    constructor(entryPath: string, projectRoot: string);
+}
+/**
+ * Thrown when validation fails
+ */
+export declare class ValidationError extends SolvdexError {
+    constructor(message: string, validationErrors: Array<string>);
+}
+/**
+ * Thrown when file system operations fail
+ */
+export declare class FileSystemError extends SolvdexError {
+    constructor(operation: 'read' | 'write' | 'delete' | 'create', filePath: string, originalError: unknown);
+}
+/**
+ * Thrown when wiki configuration is invalid or cannot be loaded
+ */
+export declare class ConfigError extends SolvdexError {
+    constructor(message: string, configPath: string);
+}
+/**
+ * Thrown when frontmatter parsing or validation fails
+ */
+export declare class FrontmatterError extends SolvdexError {
+    constructor(message: string, filePath: string);
+}
+/**
+ * Thrown when regex pattern compilation or matching fails
+ */
+export declare class RegexError extends SolvdexError {
+    constructor(pattern: string, reason: string);
+}
+/**
+ * Thrown when cache operations fail
+ */
+export declare class CacheError extends SolvdexError {
+    constructor(message: string, operation: string);
+}
+/**
+ * Helper function to wrap file operations with proper error handling
+ * Catches errors and throws FileSystemError with context
+ */
+export declare function wrapFileOperation<T>(operation: 'read' | 'write' | 'delete' | 'create', filePath: string, fn: () => T): T;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAErB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAU/D;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,YAAY;gBAC3C,WAAW,EAAE,MAAM;CAIhC;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;gBACtC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;CAInD;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,YAAY;gBACnC,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,KAAK,CAAC,MAAM,CAAC;CAI7D;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,YAAY;gBAE7C,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,EACjD,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,OAAO;CASzB;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,YAAY;gBAC/B,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAIhD;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;gBACpC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAI9C;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,YAAY;gBAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAI5C;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,YAAY;gBAC9B,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAI/C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,EACjD,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,CAAC,GACV,CAAC,CAMH"}

package/dist/src/errors.js

@@ -0,0 +1,121 @@
+"use strict";
+/**
+ * Custom error classes for Solvdex
+ * Provides typed errors with context for better debugging
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheError = exports.RegexError = exports.FrontmatterError = exports.ConfigError = exports.FileSystemError = exports.ValidationError = exports.EntryNotFoundError = exports.WikiNotInitializedError = exports.SolvdexError = void 0;
+exports.wrapFileOperation = wrapFileOperation;
+/**
+ * Base error class for all Solvdex errors
+ */
+class SolvdexError extends Error {
+    context;
+    constructor(message, context) {
+        super(message);
+        this.name = 'SolvdexError';
+        this.context = context || {};
+        // Maintains proper stack trace for where our error was thrown (only available on V8)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+}
+exports.SolvdexError = SolvdexError;
+/**
+ * Thrown when wiki operations are attempted on a non-initialized wiki
+ */
+class WikiNotInitializedError extends SolvdexError {
+    constructor(projectRoot) {
+        super(`Wiki not initialized at ${projectRoot}`, { projectRoot });
+        this.name = 'WikiNotInitializedError';
+    }
+}
+exports.WikiNotInitializedError = WikiNotInitializedError;
+/**
+ * Thrown when a wiki entry cannot be found
+ */
+class EntryNotFoundError extends SolvdexError {
+    constructor(entryPath, projectRoot) {
+        super(`Entry not found: ${entryPath}`, { entryPath, projectRoot });
+        this.name = 'EntryNotFoundError';
+    }
+}
+exports.EntryNotFoundError = EntryNotFoundError;
+/**
+ * Thrown when validation fails
+ */
+class ValidationError extends SolvdexError {
+    constructor(message, validationErrors) {
+        super(message, { validationErrors });
+        this.name = 'ValidationError';
+    }
+}
+exports.ValidationError = ValidationError;
+/**
+ * Thrown when file system operations fail
+ */
+class FileSystemError extends SolvdexError {
+    constructor(operation, filePath, originalError) {
+        super(`File system ${operation} failed: ${filePath}`, {
+            operation,
+            filePath,
+            originalError,
+        });
+        this.name = 'FileSystemError';
+    }
+}
+exports.FileSystemError = FileSystemError;
+/**
+ * Thrown when wiki configuration is invalid or cannot be loaded
+ */
+class ConfigError extends SolvdexError {
+    constructor(message, configPath) {
+        super(message, { configPath });
+        this.name = 'ConfigError';
+    }
+}
+exports.ConfigError = ConfigError;
+/**
+ * Thrown when frontmatter parsing or validation fails
+ */
+class FrontmatterError extends SolvdexError {
+    constructor(message, filePath) {
+        super(message, { filePath });
+        this.name = 'FrontmatterError';
+    }
+}
+exports.FrontmatterError = FrontmatterError;
+/**
+ * Thrown when regex pattern compilation or matching fails
+ */
+class RegexError extends SolvdexError {
+    constructor(pattern, reason) {
+        super(`Regex error: ${reason}`, { pattern, reason });
+        this.name = 'RegexError';
+    }
+}
+exports.RegexError = RegexError;
+/**
+ * Thrown when cache operations fail
+ */
+class CacheError extends SolvdexError {
+    constructor(message, operation) {
+        super(message, { operation });
+        this.name = 'CacheError';
+    }
+}
+exports.CacheError = CacheError;
+/**
+ * Helper function to wrap file operations with proper error handling
+ * Catches errors and throws FileSystemError with context
+ */
+function wrapFileOperation(operation, filePath, fn) {
+    try {
+        return fn();
+    }
+    catch (error) {
+        throw new FileSystemError(operation, filePath, error);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/errors.js.map

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