solvdex 1.0.0

package/dist/src/audit.js

@@ -0,0 +1,229 @@
+"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.logAudit = logAudit;
+exports.readAuditLog = readAuditLog;
+exports.getEntryAuditHistory = getEntryAuditHistory;
+exports.generateAuditReport = generateAuditReport;
+// src/audit.ts
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const config_js_1 = require("./config.js");
+const entry_js_1 = require("./entry.js");
+const errors_js_1 = require("./errors.js");
+const AUDIT_LOG_FILE = 'audit.log';
+/**
+ * Returns the path to the audit log file.
+ *
+ * @param projectRoot - The root directory of the project
+ * @returns The path to the audit.log file
+ */
+function getAuditLogPath(projectRoot) {
+    return path.join((0, config_js_1.getWikiPath)(projectRoot), AUDIT_LOG_FILE);
+}
+/**
+ * Formats a date as YYYY-MM-DD HH:MM.
+ *
+ * @param date - The date to format
+ * @returns Formatted date string
+ */
+function formatTimestamp(date = new Date()) {
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, '0');
+    const day = String(date.getDate()).padStart(2, '0');
+    const hours = String(date.getHours()).padStart(2, '0');
+    const minutes = String(date.getMinutes()).padStart(2, '0');
+    return `${year}-${month}-${day} ${hours}:${minutes}`;
+}
+/**
+ * Pads an action to a fixed width for consistent log formatting.
+ *
+ * @param action - The action to pad
+ * @returns Padded action string
+ */
+function padAction(action) {
+    return action.padEnd(10);
+}
+/**
+ * Parses a single audit log line into an AuditLogEntry.
+ *
+ * @param line - The log line to parse
+ * @returns Parsed AuditLogEntry or null if invalid
+ */
+function parseLogLine(line) {
+    const trimmedLine = line.trim();
+    if (!trimmedLine) {
+        return null;
+    }
+    const parts = trimmedLine.split(' | ');
+    if (parts.length < 4) {
+        return null;
+    }
+    const [timestamp, actionRaw, entryPath, byPart] = parts;
+    const action = actionRaw.trim();
+    // Parse the "by" part which may contain details after a colon
+    const colonIndex = byPart.indexOf(':');
+    let by;
+    let details;
+    if (colonIndex !== -1) {
+        by = byPart.substring(0, colonIndex).trim();
+        details = byPart.substring(colonIndex + 1).trim();
+    }
+    else {
+        by = byPart.trim();
+    }
+    return {
+        timestamp: timestamp.trim(),
+        action,
+        entryPath: entryPath.trim(),
+        by,
+        details: details || undefined
+    };
+}
+/**
+ * Logs an audit action to the audit log file.
+ *
+ * @param projectRoot - The root directory of the project
+ * @param action - The audit action (created, updated, validated, flagged, deprecated)
+ * @param entryPath - The path to the entry being audited
+ * @param by - Who performed the action (e.g., "user", "claude", "auto-capture")
+ * @param details - Optional additional details about the action
+ */
+function logAudit(projectRoot, action, entryPath, by, details) {
+    const logPath = getAuditLogPath(projectRoot);
+    const timestamp = formatTimestamp();
+    const paddedAction = padAction(action);
+    // Format: YYYY-MM-DD HH:MM | action | entryPath | by: details
+    let logLine = `${timestamp} | ${paddedAction} | ${entryPath} | ${by}`;
+    if (details) {
+        logLine += `: ${details}`;
+    }
+    logLine += '\n';
+    // Ensure the wiki directory exists
+    const wikiPath = (0, config_js_1.getWikiPath)(projectRoot);
+    if (!fs.existsSync(wikiPath)) {
+        (0, errors_js_1.wrapFileOperation)('create', wikiPath, () => fs.mkdirSync(wikiPath, { recursive: true }));
+    }
+    // Append to the log file
+    (0, errors_js_1.wrapFileOperation)('write', logPath, () => fs.appendFileSync(logPath, logLine, 'utf-8'));
+}
+/**
+ * Reads audit log entries from the audit log file.
+ *
+ * @param projectRoot - The root directory of the project
+ * @param options - Optional filters (limit, entryPath)
+ * @returns Array of AuditLogEntry objects, most recent first
+ */
+function readAuditLog(projectRoot, options = {}) {
+    const logPath = getAuditLogPath(projectRoot);
+    if (!fs.existsSync(logPath)) {
+        return [];
+    }
+    const content = (0, errors_js_1.wrapFileOperation)('read', logPath, () => fs.readFileSync(logPath, 'utf-8'));
+    const lines = content.split('\n');
+    const entries = [];
+    for (const line of lines) {
+        const entry = parseLogLine(line);
+        if (entry) {
+            // Apply entryPath filter if specified
+            if (options.entryPath && entry.entryPath !== options.entryPath) {
+                continue;
+            }
+            entries.push(entry);
+        }
+    }
+    // Sort by timestamp, most recent first
+    entries.sort((a, b) => b.timestamp.localeCompare(a.timestamp));
+    // Apply limit if specified
+    if (options.limit && options.limit > 0) {
+        return entries.slice(0, options.limit);
+    }
+    return entries;
+}
+/**
+ * Gets the audit history for a specific wiki entry.
+ *
+ * @param projectRoot - The root directory of the project
+ * @param entryPath - The path to the entry
+ * @returns Array of AuditLogEntry objects for the entry, most recent first
+ */
+function getEntryAuditHistory(projectRoot, entryPath) {
+    return readAuditLog(projectRoot, { entryPath });
+}
+/**
+ * Generates an audit summary report for the wiki.
+ *
+ * @param projectRoot - The root directory of the project
+ * @returns AuditReport with stats and recent activity
+ */
+async function generateAuditReport(projectRoot) {
+    // Get all entries for counting
+    const allEntries = await (0, entry_js_1.listEntries)(projectRoot);
+    const totalEntries = allEntries.length;
+    const activeCount = allEntries.filter(e => e.frontmatter.status === 'active').length;
+    const flaggedCount = allEntries.filter(e => e.frontmatter.status === 'flagged').length;
+    const deprecatedCount = allEntries.filter(e => e.frontmatter.status === 'deprecated').length;
+    // Get all audit log entries
+    const auditEntries = readAuditLog(projectRoot);
+    // Calculate last 7 days activity
+    const sevenDaysAgo = new Date();
+    sevenDaysAgo.setDate(sevenDaysAgo.getDate() - 7);
+    const sevenDaysAgoStr = formatTimestamp(sevenDaysAgo);
+    const last7DaysActivity = {
+        created: 0,
+        updated: 0,
+        validated: 0,
+        flagged: 0,
+        deprecated: 0,
+        maturity_promoted: 0
+    };
+    for (const entry of auditEntries) {
+        // Compare timestamps (YYYY-MM-DD HH:MM format allows string comparison)
+        if (entry.timestamp >= sevenDaysAgoStr) {
+            last7DaysActivity[entry.action]++;
+        }
+    }
+    // Get recent activity (last 10 entries)
+    const recentActivity = auditEntries.slice(0, 10);
+    return {
+        totalEntries,
+        activeCount,
+        flaggedCount,
+        deprecatedCount,
+        last7DaysActivity,
+        recentActivity
+    };
+}
+//# sourceMappingURL=audit.js.map

package/dist/src/audit.js.map

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

package/dist/src/cache.d.ts

@@ -0,0 +1,54 @@
+/**
+ * LRU cache for WikiEntry objects with mtime validation
+ *
+ * Provides in-memory caching with:
+ * - LRU eviction when cache reaches max size (500 entries)
+ * - TTL expiration (5 minutes)
+ * - File modification time validation
+ * - Graceful error handling (non-critical, never throws)
+ */
+import type { WikiEntry } from './types.js';
+/**
+ * Cache statistics for monitoring
+ */
+interface CacheStats {
+    size: number;
+    maxSize: number;
+    hits: number;
+    misses: number;
+}
+/**
+ * Gets cached entry if valid (exists, not expired, mtime matches)
+ * Returns null if cache miss, expired, or file modified
+ * Moves entry to end of Map for LRU tracking
+ *
+ * @param fullPath - Absolute file path
+ * @returns Cached WikiEntry or null
+ */
+export declare function getCachedEntry(fullPath: string): WikiEntry | null;
+/**
+ * Adds entry to cache with current timestamp and mtime
+ * Evicts LRU entry if cache is full (500+ entries)
+ *
+ * @param fullPath - Absolute file path
+ * @param entry - WikiEntry to cache
+ */
+export declare function setCachedEntry(fullPath: string, entry: WikiEntry): void;
+/**
+ * Removes specific entry from cache
+ *
+ * @param fullPath - Absolute file path
+ */
+export declare function invalidateCache(fullPath: string): void;
+/**
+ * Removes all entries from cache
+ */
+export declare function clearCache(): void;
+/**
+ * Gets cache statistics for monitoring and debugging
+ *
+ * @returns Cache statistics including size, hits, and misses
+ */
+export declare function getCacheStats(): CacheStats;
+export {};
+//# sourceMappingURL=cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAe5C;;GAEG;AACH,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AASD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAuDjE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAwCvE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAWtD;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAajC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAO1C"}

package/dist/src/cache.js

@@ -0,0 +1,167 @@
+"use strict";
+/**
+ * LRU cache for WikiEntry objects with mtime validation
+ *
+ * Provides in-memory caching with:
+ * - LRU eviction when cache reaches max size (500 entries)
+ * - TTL expiration (5 minutes)
+ * - File modification time validation
+ * - Graceful error handling (non-critical, never throws)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCachedEntry = getCachedEntry;
+exports.setCachedEntry = setCachedEntry;
+exports.invalidateCache = invalidateCache;
+exports.clearCache = clearCache;
+exports.getCacheStats = getCacheStats;
+const node_fs_1 = require("node:fs");
+const errors_js_1 = require("./errors.js");
+const MAX_CACHE_SIZE = 500;
+const MAX_CACHE_AGE_MS = 300000; // 5 minutes
+// In-memory cache storage (Map maintains insertion order for LRU)
+const cache = new Map();
+// Statistics tracking
+let cacheHits = 0;
+let cacheMisses = 0;
+/**
+ * Gets cached entry if valid (exists, not expired, mtime matches)
+ * Returns null if cache miss, expired, or file modified
+ * Moves entry to end of Map for LRU tracking
+ *
+ * @param fullPath - Absolute file path
+ * @returns Cached WikiEntry or null
+ */
+function getCachedEntry(fullPath) {
+    try {
+        const cached = cache.get(fullPath);
+        if (!cached) {
+            cacheMisses++;
+            return null;
+        }
+        const now = Date.now();
+        // Check TTL expiration
+        if (now - cached.timestamp > MAX_CACHE_AGE_MS) {
+            cache.delete(fullPath);
+            cacheMisses++;
+            return null;
+        }
+        // Check file modification time
+        let currentMtime;
+        try {
+            const stats = (0, node_fs_1.statSync)(fullPath);
+            currentMtime = stats.mtimeMs;
+        }
+        catch (error) {
+            // File may have been deleted or is inaccessible
+            cache.delete(fullPath);
+            cacheMisses++;
+            return null;
+        }
+        if (currentMtime !== cached.mtime) {
+            // File has been modified since caching
+            cache.delete(fullPath);
+            cacheMisses++;
+            return null;
+        }
+        // Valid cache hit - move to end for LRU tracking
+        // Note: delete + re-set is required to move entry to end of Map's insertion order
+        // This is the standard pattern for LRU caching with JavaScript Maps
+        cache.delete(fullPath);
+        cache.set(fullPath, cached);
+        cacheHits++;
+        return cached.entry;
+    }
+    catch (error) {
+        // Non-critical error - log and return null for graceful degradation
+        const err = new errors_js_1.CacheError(`Failed to get cached entry: ${error instanceof Error ? error.message : String(error)}`, 'get');
+        console.warn(`[Cache Warning] ${err.message}`, err.context);
+        cacheMisses++;
+        return null;
+    }
+}
+/**
+ * Adds entry to cache with current timestamp and mtime
+ * Evicts LRU entry if cache is full (500+ entries)
+ *
+ * @param fullPath - Absolute file path
+ * @param entry - WikiEntry to cache
+ */
+function setCachedEntry(fullPath, entry) {
+    try {
+        // Get current file mtime
+        let mtime;
+        try {
+            const stats = (0, node_fs_1.statSync)(fullPath);
+            mtime = stats.mtimeMs;
+        }
+        catch (error) {
+            // Cannot cache if file is inaccessible
+            const err = new errors_js_1.CacheError(`Cannot cache entry - file stat failed: ${error instanceof Error ? error.message : String(error)}`, 'set');
+            console.warn(`[Cache Warning] ${err.message}`, err.context);
+            return;
+        }
+        // Evict LRU entry if cache is full
+        if (cache.size >= MAX_CACHE_SIZE) {
+            // Map.keys() returns in insertion order, first key is LRU
+            const firstKey = cache.keys().next().value;
+            if (firstKey !== undefined) {
+                cache.delete(firstKey);
+            }
+        }
+        // Add new entry to cache (at end of Map)
+        cache.set(fullPath, {
+            entry,
+            mtime,
+            timestamp: Date.now()
+        });
+    }
+    catch (error) {
+        // Non-critical error - log and continue without caching
+        const err = new errors_js_1.CacheError(`Failed to set cached entry: ${error instanceof Error ? error.message : String(error)}`, 'set');
+        console.warn(`[Cache Warning] ${err.message}`, err.context);
+    }
+}
+/**
+ * Removes specific entry from cache
+ *
+ * @param fullPath - Absolute file path
+ */
+function invalidateCache(fullPath) {
+    try {
+        cache.delete(fullPath);
+    }
+    catch (error) {
+        // Non-critical error - log and continue
+        const err = new errors_js_1.CacheError(`Failed to invalidate cache entry: ${error instanceof Error ? error.message : String(error)}`, 'invalidate');
+        console.warn(`[Cache Warning] ${err.message}`, err.context);
+    }
+}
+/**
+ * Removes all entries from cache
+ */
+function clearCache() {
+    try {
+        cache.clear();
+        cacheHits = 0;
+        cacheMisses = 0;
+    }
+    catch (error) {
+        // Non-critical error - log and continue
+        const err = new errors_js_1.CacheError(`Failed to clear cache: ${error instanceof Error ? error.message : String(error)}`, 'clear');
+        console.warn(`[Cache Warning] ${err.message}`, err.context);
+    }
+}
+/**
+ * Gets cache statistics for monitoring and debugging
+ *
+ * @returns Cache statistics including size, hits, and misses
+ */
+function getCacheStats() {
+    return {
+        size: cache.size,
+        maxSize: MAX_CACHE_SIZE,
+        hits: cacheHits,
+        misses: cacheMisses
+    };
+}
+//# sourceMappingURL=cache.js.map

package/dist/src/cache.js.map

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

package/dist/src/config.d.ts

@@ -0,0 +1,52 @@
+import { WikiConfig } from './types.js';
+/**
+ * Get the default confidence level for a category.
+ * Returns 80 (HIGH) for gotchas, 50 (MEDIUM) for everything else.
+ * @param category - The category name
+ * @returns The default confidence level (0-100) for that category
+ */
+export declare function getDefaultConfidence(category: string): number;
+/**
+ * Returns the default configuration for a new wiki project.
+ * @param projectName - The name of the project
+ * @returns Default WikiConfig with all standard settings
+ */
+export declare function getDefaultConfig(projectName: string): WikiConfig;
+/**
+ * Returns the path to the .wiki directory for a project.
+ * @param projectRoot - The root directory of the project
+ * @returns The path to the .wiki directory
+ */
+export declare function getWikiPath(projectRoot: string): string;
+/**
+ * Returns the path to the wiki config file.
+ * @param projectRoot - The root directory of the project
+ * @returns The path to the .wiki-config.yaml file
+ */
+export declare function getConfigPath(projectRoot: string): string;
+/**
+ * Checks if a wiki has been initialized for the project.
+ * @param projectRoot - The root directory of the project
+ * @returns True if the .wiki directory exists
+ */
+export declare function wikiExists(projectRoot: string): boolean;
+/**
+ * Reads the wiki configuration from the project.
+ * @param projectRoot - The root directory of the project
+ * @returns The WikiConfig if it exists, or null if not
+ */
+export declare function readConfig(projectRoot: string): WikiConfig | null;
+/**
+ * Writes the wiki configuration to the project.
+ * @param projectRoot - The root directory of the project
+ * @param config - The WikiConfig to write
+ */
+export declare function writeConfig(projectRoot: string, config: WikiConfig): void;
+/**
+ * Adds a new category to the wiki configuration.
+ * @param projectRoot - The root directory of the project
+ * @param category - The category name to add
+ * @throws Error if the wiki is not initialized
+ */
+export declare function addCategory(projectRoot: string, category: string): void;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAkC,MAAM,YAAY,CAAC;AAKxE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE7D;AAGD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,CAgChE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAmBjE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAezE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAUvE"}