wikimem 0.1.0

package/dist/core/ingest.js

@@ -0,0 +1,366 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync, copyFileSync, readdirSync, statSync } from 'node:fs';
+import { join, basename, extname, resolve } from 'node:path';
+import { readWikiPage, writeWikiPage, listWikiPages, slugify } from './vault.js';
+import { updateIndex } from './index-manager.js';
+import { appendLog } from './log-manager.js';
+import { processUrl } from '../processors/url.js';
+import { isImageFile, processImage } from '../processors/image.js';
+import { isAudioFile, processAudio } from '../processors/audio.js';
+import { isVideoFile, processVideo } from '../processors/video.js';
+import { isPdfFile, processPdf } from '../processors/pdf.js';
+import { processDocx } from '../processors/docx.js';
+import { processXlsx } from '../processors/xlsx.js';
+import { processPptx } from '../processors/pptx.js';
+import { embedPage } from '../search/semantic.js';
+export async function ingestSource(source, config, provider, options) {
+    const isUrl = source.startsWith('http://') || source.startsWith('https://');
+    const now = new Date().toISOString().split('T')[0] ?? '';
+    // Step 1: Get content as markdown
+    let content;
+    let title;
+    let rawPath;
+    if (isUrl) {
+        const urlResult = await processUrl(source);
+        content = urlResult.content;
+        title = urlResult.title;
+        // Save to raw/ with date stamp
+        const dateDir = join(config.rawDir, now);
+        mkdirSync(dateDir, { recursive: true });
+        rawPath = join(dateDir, `${slugify(title)}.md`);
+        writeFileSync(rawPath, content, 'utf-8');
+    }
+    else {
+        if (!existsSync(source)) {
+            throw new Error(`File not found: ${source}`);
+        }
+        const ext = extname(source).toLowerCase();
+        rawPath = source;
+        // Copy to raw/ if not already there
+        if (!source.startsWith(config.rawDir)) {
+            const dateDir = join(config.rawDir, now);
+            mkdirSync(dateDir, { recursive: true });
+            rawPath = join(dateDir, basename(source));
+            copyFileSync(source, rawPath);
+        }
+        // Process based on file type — supports every major format
+        if (isImageFile(source)) {
+            const result = await processImage(source);
+            content = result.markdown;
+            title = result.title;
+        }
+        else if (isAudioFile(source)) {
+            const result = await processAudio(source);
+            content = result.markdown;
+            title = result.title;
+        }
+        else if (isVideoFile(source)) {
+            const result = await processVideo(source);
+            content = result.markdown;
+            title = result.title;
+        }
+        else if (isPdfFile(source)) {
+            const result = await processPdf(source);
+            content = result.markdown;
+            title = result.title;
+        }
+        else {
+            // Text-based formats: .md, .txt, .csv, .json, .yaml, .xml, .html,
+            // Office formats: .docx, .xlsx, .pptx (full extraction)
+            switch (ext) {
+                case '.docx':
+                case '.doc': {
+                    const docResult = await processDocx(source);
+                    content = docResult.markdown;
+                    title = docResult.title;
+                    break;
+                }
+                case '.xlsx':
+                case '.xls': {
+                    const xlsResult = await processXlsx(source);
+                    content = xlsResult.markdown;
+                    title = xlsResult.title;
+                    break;
+                }
+                case '.pptx':
+                case '.ppt': {
+                    const pptResult = await processPptx(source);
+                    content = pptResult.markdown;
+                    title = pptResult.title;
+                    break;
+                }
+                case '.json':
+                    content = `# ${basename(source, ext)}\n\n\`\`\`json\n${readFileSync(source, 'utf-8').substring(0, 20000)}\n\`\`\``;
+                    title = basename(source, ext);
+                    break;
+                case '.html':
+                case '.htm':
+                    const html = readFileSync(source, 'utf-8');
+                    const htmlTitle = html.match(/<title>(.*?)<\/title>/i)?.[1];
+                    content = html.replace(/<[^>]+>/g, ' ').replace(/\s+/g, ' ').trim().substring(0, 20000);
+                    title = htmlTitle ?? basename(source, ext);
+                    break;
+                default:
+                    content = readFileSync(source, 'utf-8');
+                    title = basename(source, ext);
+            }
+        }
+    }
+    // Step 2: Semantic dedup check (unless --force)
+    if (!options.force) {
+        const existingPages = listWikiPages(config.wikiDir);
+        const isDuplicate = await checkDuplicate(content, existingPages, provider);
+        if (isDuplicate.duplicate) {
+            // Mark in raw/ frontmatter but don't add to wiki
+            const rejectionMeta = {
+                title,
+                rejected: true,
+                rejection_reason: isDuplicate.reason,
+                similar_to: isDuplicate.similarPage,
+                similarity_score: isDuplicate.score,
+                source: rawPath,
+                date: now,
+            };
+            // Write rejection metadata alongside the raw file
+            writeFileSync(rawPath + '.meta.json', JSON.stringify(rejectionMeta, null, 2), 'utf-8');
+            return {
+                title,
+                pagesUpdated: 0,
+                linksAdded: 0,
+                rawPath,
+                rejected: true,
+                rejectionReason: isDuplicate.reason,
+            };
+        }
+    }
+    // Step 3: Ask LLM to process and integrate into wiki
+    const schema = existsSync(config.schemaPath)
+        ? readFileSync(config.schemaPath, 'utf-8')
+        : '';
+    const indexContent = existsSync(config.indexPath)
+        ? readFileSync(config.indexPath, 'utf-8')
+        : '';
+    const prompt = buildIngestPrompt(content, title, schema, indexContent);
+    const response = await provider.chat([
+        { role: 'user', content: prompt },
+    ], {
+        systemPrompt: `You are a wiki maintainer. You process source documents and produce structured wiki pages in markdown with YAML frontmatter and [[wikilinks]]. Follow the schema in AGENTS.md exactly. Be concise, factual, and thorough in cross-referencing.`,
+        maxTokens: 8192,
+    });
+    // Step 4: Parse LLM response into wiki pages
+    const pages = parseLLMPages(response.content);
+    let pagesUpdated = 0;
+    let linksAdded = 0;
+    for (const page of pages) {
+        // User-supplied category overrides LLM-detected category
+        const pageCategory = options.category ?? page.category;
+        const pagePath = join(config.wikiDir, pageCategory, `${slugify(page.title)}.md`);
+        const dir = join(pagePath, '..');
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        // Merge user-supplied tags with LLM-detected tags (dedup)
+        const mergedTags = [...new Set([...page.tags, ...(options.tags ?? [])])];
+        const frontmatterData = {
+            title: page.title,
+            type: pageCategory,
+            created: now,
+            updated: now,
+            tags: mergedTags,
+            sources: [rawPath],
+            summary: page.summary,
+        };
+        // Merge any custom metadata from --interactive or future extensions
+        if (options.metadata) {
+            for (const [key, value] of Object.entries(options.metadata)) {
+                frontmatterData[key] = value;
+            }
+        }
+        writeWikiPage(pagePath, page.content, frontmatterData);
+        pagesUpdated++;
+        linksAdded += (page.content.match(/\[\[[^\]]+\]\]/g) ?? []).length;
+    }
+    // Step 5: Generate embeddings for new pages (if provider configured)
+    if (options.embeddingProvider) {
+        for (const page of pages) {
+            const pageCategory = options.category ?? page.category;
+            const pagePath = join(config.wikiDir, pageCategory, `${slugify(page.title)}.md`);
+            try {
+                await embedPage(pagePath, page.content, options.embeddingProvider);
+            }
+            catch {
+                // Embedding failure is non-fatal — page is still ingested
+            }
+        }
+    }
+    // Step 6: Update index.md and log.md
+    await updateIndex(config, pages);
+    appendLog(config.logPath, `ingest | ${title}`, `Processed ${source}. Created/updated ${pagesUpdated} pages.`);
+    return { title, pagesUpdated, linksAdded, rawPath };
+}
+async function checkDuplicate(content, existingPages, provider) {
+    if (existingPages.length === 0) {
+        return { duplicate: false, reason: '' };
+    }
+    // Simple heuristic first: check content length overlap
+    const contentSnippet = content.substring(0, 500);
+    for (const pagePath of existingPages.slice(0, 20)) {
+        try {
+            const page = readWikiPage(pagePath);
+            const pageSnippet = page.content.substring(0, 500);
+            // Simple Jaccard similarity on word sets
+            const wordsA = new Set(contentSnippet.toLowerCase().split(/\s+/));
+            const wordsB = new Set(pageSnippet.toLowerCase().split(/\s+/));
+            const intersection = new Set([...wordsA].filter((w) => wordsB.has(w)));
+            const union = new Set([...wordsA, ...wordsB]);
+            const similarity = union.size > 0 ? intersection.size / union.size : 0;
+            if (similarity > 0.7) {
+                return {
+                    duplicate: true,
+                    reason: `High word overlap (${Math.round(similarity * 100)}%) with existing page "${page.title}"`,
+                    similarPage: pagePath,
+                    score: similarity,
+                };
+            }
+        }
+        catch {
+            // Skip unreadable pages
+        }
+    }
+    return { duplicate: false, reason: '' };
+}
+function buildIngestPrompt(content, title, schema, indexContent) {
+    return `# Task: Ingest Source Document
+
+## Schema (AGENTS.md)
+${schema}
+
+## Current Wiki Index
+${indexContent}
+
+## Source Document: "${title}"
+${content.substring(0, 12000)}
+
+## Instructions
+
+Process this source document and produce wiki pages. For each page, output in this exact format:
+
+\`\`\`page
+TITLE: Page Title
+CATEGORY: sources | entities | concepts | syntheses
+TAGS: tag1, tag2, tag3
+SUMMARY: One-line summary for the index
+---
+Page content in markdown with [[wikilinks]] to other pages.
+\`\`\`
+
+Produce:
+1. A source summary page (in sources/)
+2. Entity pages for any notable people, tools, organizations mentioned (in entities/)
+3. Concept pages for key ideas or frameworks discussed (in concepts/)
+
+Use [[wikilinks]] extensively to connect pages. Every claim should reference its source.`;
+}
+function parseLLMPages(response) {
+    const pages = [];
+    const pageBlocks = response.split('```page').slice(1);
+    for (const block of pageBlocks) {
+        const endIdx = block.indexOf('```');
+        const pageContent = endIdx >= 0 ? block.substring(0, endIdx) : block;
+        const lines = pageContent.trim().split('\n');
+        const titleLine = lines.find((l) => l.startsWith('TITLE:'));
+        const categoryLine = lines.find((l) => l.startsWith('CATEGORY:'));
+        const tagsLine = lines.find((l) => l.startsWith('TAGS:'));
+        const summaryLine = lines.find((l) => l.startsWith('SUMMARY:'));
+        const separatorIdx = lines.findIndex((l) => l.trim() === '---');
+        const content = separatorIdx >= 0 ? lines.slice(separatorIdx + 1).join('\n').trim() : '';
+        if (titleLine && categoryLine) {
+            pages.push({
+                title: titleLine.replace('TITLE:', '').trim(),
+                category: categoryLine.replace('CATEGORY:', '').trim(),
+                tags: (tagsLine?.replace('TAGS:', '').trim() ?? '').split(',').map((t) => t.trim()).filter(Boolean),
+                summary: summaryLine?.replace('SUMMARY:', '').trim() ?? '',
+                content,
+            });
+        }
+    }
+    // If no structured pages found, create a single source page
+    if (pages.length === 0 && response.trim().length > 0) {
+        pages.push({
+            title: 'Untitled Source',
+            category: 'sources',
+            tags: [],
+            summary: 'Auto-generated source page',
+            content: response,
+        });
+    }
+    return pages;
+}
+/** Collect ingestable files from a directory */
+export function collectFiles(dir, recursive) {
+    const files = [];
+    const resolved = resolve(dir);
+    if (!existsSync(resolved) || !statSync(resolved).isDirectory()) {
+        return files;
+    }
+    const entries = readdirSync(resolved);
+    for (const entry of entries) {
+        // Skip hidden files and .meta.json files
+        if (entry.startsWith('.') || entry.endsWith('.meta.json'))
+            continue;
+        const full = join(resolved, entry);
+        const stat = statSync(full);
+        if (stat.isDirectory() && recursive) {
+            files.push(...collectFiles(full, true));
+        }
+        else if (stat.isFile()) {
+            files.push(full);
+        }
+    }
+    return files;
+}
+/** Check if a file was already ingested by reading log.md */
+export function isAlreadyIngested(logPath, filePath) {
+    if (!existsSync(logPath))
+        return false;
+    const log = readFileSync(logPath, 'utf-8');
+    const fileName = basename(filePath);
+    return log.includes(fileName);
+}
+/** Scan raw/ for .meta.json files indicating rejected duplicates */
+export function listDuplicates(rawDir) {
+    const duplicates = [];
+    if (!existsSync(rawDir))
+        return duplicates;
+    function walk(dir) {
+        const entries = readdirSync(dir);
+        for (const entry of entries) {
+            const full = join(dir, entry);
+            const stat = statSync(full);
+            if (stat.isDirectory()) {
+                walk(full);
+            }
+            else if (entry.endsWith('.meta.json')) {
+                try {
+                    const raw = readFileSync(full, 'utf-8');
+                    const meta = JSON.parse(raw);
+                    if (meta['rejected'] === true) {
+                        duplicates.push({
+                            file: full.replace('.meta.json', ''),
+                            title: meta['title'] ?? basename(full, '.meta.json'),
+                            reason: meta['rejection_reason'] ?? 'Unknown',
+                            similarTo: meta['similar_to'] ?? 'Unknown',
+                            score: meta['similarity_score'] ?? 0,
+                            date: meta['date'] ?? '',
+                        });
+                    }
+                }
+                catch {
+                    // Skip malformed meta files
+                }
+            }
+        }
+    }
+    walk(rawDir);
+    return duplicates;
+}
+//# sourceMappingURL=ingest.js.map

package/dist/core/ingest.js.map

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

package/dist/core/lint.d.ts

@@ -0,0 +1,19 @@
+import type { LLMProvider } from '../providers/types.js';
+import type { VaultConfig } from './vault.js';
+export interface LintIssue {
+    category: 'orphan' | 'contradiction' | 'stale' | 'missing-link' | 'empty' | 'no-summary';
+    severity: 'error' | 'warning';
+    message: string;
+    page?: string;
+    fixed?: boolean;
+}
+export interface LintResult {
+    score: number;
+    issues: LintIssue[];
+}
+interface LintOptions {
+    fix: boolean;
+}
+export declare function lintWiki(config: VaultConfig, _provider: LLMProvider, _options: LintOptions): Promise<LintResult>;
+export {};
+//# sourceMappingURL=lint.d.ts.map

package/dist/core/lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/core/lint.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,QAAQ,GAAG,eAAe,GAAG,OAAO,GAAG,cAAc,GAAG,OAAO,GAAG,YAAY,CAAC;IACzF,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,UAAU,WAAW;IACnB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,WAAW,EACtB,QAAQ,EAAE,WAAW,GACpB,OAAO,CAAC,UAAU,CAAC,CA8FrB"}

package/dist/core/lint.js

@@ -0,0 +1,90 @@
+import { listWikiPages, readWikiPage } from './vault.js';
+export async function lintWiki(config, _provider, _options) {
+    const issues = [];
+    const pages = listWikiPages(config.wikiDir);
+    if (pages.length === 0) {
+        return { score: 0, issues: [{ category: 'empty', severity: 'error', message: 'Wiki has no pages. Run `llmwiki ingest` to add content.' }] };
+    }
+    // Collect all page titles and wikilinks
+    const allTitles = new Set();
+    const allLinkedTo = new Set();
+    const pageData = [];
+    for (const pagePath of pages) {
+        try {
+            const page = readWikiPage(pagePath);
+            allTitles.add(page.title);
+            for (const link of page.wikilinks) {
+                allLinkedTo.add(link);
+            }
+            pageData.push({
+                path: pagePath,
+                title: page.title,
+                wikilinks: page.wikilinks,
+                wordCount: page.wordCount,
+                frontmatter: page.frontmatter,
+            });
+        }
+        catch {
+            issues.push({
+                category: 'empty',
+                severity: 'error',
+                message: `Failed to read page: ${pagePath}`,
+                page: pagePath,
+            });
+        }
+    }
+    // Check 1: Orphan pages (no inbound links)
+    for (const page of pageData) {
+        if (page.title === 'index' || page.title === 'log')
+            continue;
+        if (!allLinkedTo.has(page.title)) {
+            issues.push({
+                category: 'orphan',
+                severity: 'warning',
+                message: `Orphan page: "${page.title}" has no inbound links`,
+                page: page.path,
+            });
+        }
+    }
+    // Check 2: Broken wikilinks (link to non-existent page)
+    for (const page of pageData) {
+        for (const link of page.wikilinks) {
+            if (!allTitles.has(link)) {
+                issues.push({
+                    category: 'missing-link',
+                    severity: 'warning',
+                    message: `Broken wikilink: "${page.title}" links to non-existent "[[${link}]]"`,
+                    page: page.path,
+                });
+            }
+        }
+    }
+    // Check 3: Pages without summary in frontmatter
+    for (const page of pageData) {
+        if (!page.frontmatter['summary'] && page.title !== 'index' && page.title !== 'log') {
+            issues.push({
+                category: 'no-summary',
+                severity: 'warning',
+                message: `Page "${page.title}" missing frontmatter summary`,
+                page: page.path,
+            });
+        }
+    }
+    // Check 4: Empty pages (< 10 words)
+    for (const page of pageData) {
+        if (page.wordCount < 10 && page.title !== 'index' && page.title !== 'log') {
+            issues.push({
+                category: 'empty',
+                severity: 'warning',
+                message: `Page "${page.title}" is nearly empty (${page.wordCount} words)`,
+                page: page.path,
+            });
+        }
+    }
+    // Calculate score
+    const maxIssues = pageData.length * 3; // rough estimate
+    const issueWeight = issues.reduce((sum, i) => sum + (i.severity === 'error' ? 10 : 3), 0);
+    const score = Math.max(0, Math.min(100, Math.round(100 - (issueWeight / Math.max(maxIssues, 1)) * 100)));
+    return { score, issues };
+}
+//# sourceMappingURL=lint.js.map

package/dist/core/lint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.js","sourceRoot":"","sources":["../../src/core/lint.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAiB,MAAM,YAAY,CAAC;AAoBxE,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAmB,EACnB,SAAsB,EACtB,QAAqB;IAErB,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAE5C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,yDAAyD,EAAE,CAAC,EAAE,CAAC;IAC9I,CAAC;IAED,wCAAwC;IACxC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,MAAM,QAAQ,GAAyH,EAAE,CAAC;IAE1I,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;YACpC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBAClC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACxB,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,WAAW,EAAE,IAAI,CAAC,WAAW;aAC9B,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,IAAI,CAAC;gBACV,QAAQ,EAAE,OAAO;gBACjB,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,wBAAwB,QAAQ,EAAE;gBAC3C,IAAI,EAAE,QAAQ;aACf,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,2CAA2C;IAC3C,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,KAAK,KAAK,OAAO,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK;YAAE,SAAS;QAC7D,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,CAAC,IAAI,CAAC;gBACV,QAAQ,EAAE,QAAQ;gBAClB,QAAQ,EAAE,SAAS;gBACnB,OAAO,EAAE,iBAAiB,IAAI,CAAC,KAAK,wBAAwB;gBAC5D,IAAI,EAAE,IAAI,CAAC,IAAI;aAChB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,wDAAwD;IACxD,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAClC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,MAAM,CAAC,IAAI,CAAC;oBACV,QAAQ,EAAE,cAAc;oBACxB,QAAQ,EAAE,SAAS;oBACnB,OAAO,EAAE,qBAAqB,IAAI,CAAC,KAAK,8BAA8B,IAAI,KAAK;oBAC/E,IAAI,EAAE,IAAI,CAAC,IAAI;iBAChB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,gDAAgD;IAChD,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,KAAK,KAAK,OAAO,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;YACnF,MAAM,CAAC,IAAI,CAAC;gBACV,QAAQ,EAAE,YAAY;gBACtB,QAAQ,EAAE,SAAS;gBACnB,OAAO,EAAE,SAAS,IAAI,CAAC,KAAK,+BAA+B;gBAC3D,IAAI,EAAE,IAAI,CAAC,IAAI;aAChB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,oCAAoC;IACpC,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,SAAS,GAAG,EAAE,IAAI,IAAI,CAAC,KAAK,KAAK,OAAO,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;YAC1E,MAAM,CAAC,IAAI,CAAC;gBACV,QAAQ,EAAE,OAAO;gBACjB,QAAQ,EAAE,SAAS;gBACnB,OAAO,EAAE,SAAS,IAAI,CAAC,KAAK,sBAAsB,IAAI,CAAC,SAAS,SAAS;gBACzE,IAAI,EAAE,IAAI,CAAC,IAAI;aAChB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,kBAAkB;IAClB,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,iBAAiB;IACxD,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1F,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IAEzG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3B,CAAC"}

package/dist/core/log-manager.d.ts

@@ -0,0 +1,2 @@
+export declare function appendLog(logPath: string, operation: string, details: string): void;
+//# sourceMappingURL=log-manager.d.ts.map

package/dist/core/log-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-manager.d.ts","sourceRoot":"","sources":["../../src/core/log-manager.ts"],"names":[],"mappings":"AAEA,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,IAAI,CAWN"}

package/dist/core/log-manager.js

@@ -0,0 +1,14 @@
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+export function appendLog(logPath, operation, details) {
+    const now = new Date().toISOString().split('T')[0] ?? '';
+    const time = new Date().toISOString().split('T')[1]?.substring(0, 5) ?? '';
+    const entry = `\n## [${now} ${time}] ${operation}\n\n${details}\n`;
+    if (existsSync(logPath)) {
+        const existing = readFileSync(logPath, 'utf-8');
+        writeFileSync(logPath, existing + entry, 'utf-8');
+    }
+    else {
+        writeFileSync(logPath, `---\ntitle: Wiki Log\ntype: log\n---\n\n# Wiki Log\n${entry}`, 'utf-8');
+    }
+}
+//# sourceMappingURL=log-manager.js.map

package/dist/core/log-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-manager.js","sourceRoot":"","sources":["../../src/core/log-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAElE,MAAM,UAAU,SAAS,CACvB,OAAe,EACf,SAAiB,EACjB,OAAe;IAEf,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACzD,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3E,MAAM,KAAK,GAAG,SAAS,GAAG,IAAI,IAAI,KAAK,SAAS,OAAO,OAAO,IAAI,CAAC;IAEnE,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAChD,aAAa,CAAC,OAAO,EAAE,QAAQ,GAAG,KAAK,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;SAAM,CAAC;QACN,aAAa,CAAC,OAAO,EAAE,uDAAuD,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;IAClG,CAAC;AACH,CAAC"}

package/dist/core/obsidian.d.ts

@@ -0,0 +1,89 @@
+import type { VaultConfig } from './vault.js';
+/**
+ * Obsidian integration — generates .obsidian/ config directory
+ * for optimal graph display when `llmwiki init` runs.
+ */
+export interface ObsidianConfig {
+    app: AppConfig;
+    graph: GraphConfig;
+    appearance: AppearanceConfig;
+}
+export interface AppConfig {
+    livePreview: boolean;
+    readableLineLength: boolean;
+    showFrontmatter: boolean;
+    strictLineBreaks: boolean;
+    useMarkdownLinks: boolean;
+    showLineNumber: boolean;
+    foldHeading: boolean;
+    foldIndent: boolean;
+}
+export interface GraphConfig {
+    collapse_filter: boolean;
+    search: string;
+    showTags: boolean;
+    showAttachments: boolean;
+    hideUnresolved: boolean;
+    showOrphans: boolean;
+    collapse_color: boolean;
+    colorGroups: GraphColorGroup[];
+    collapse_display: boolean;
+    showArrow: boolean;
+    textFadeMultiplier: number;
+    nodeSizeMultiplier: number;
+    lineSizeMultiplier: number;
+    collapse_forces: boolean;
+    centerStrength: number;
+    repelStrength: number;
+    linkStrength: number;
+    linkDistance: number;
+}
+export interface GraphColorGroup {
+    query: string;
+    color: {
+        a: number;
+        r: number;
+        g: number;
+        b: number;
+    };
+}
+export interface AppearanceConfig {
+    accentColor: string;
+    theme: string;
+    cssTheme: string;
+}
+export interface GraphHint {
+    nodes: GraphHintNode[];
+    edges: GraphHintEdge[];
+    stats: {
+        nodeCount: number;
+        edgeCount: number;
+        orphanCount: number;
+    };
+}
+export interface GraphHintNode {
+    id: string;
+    title: string;
+    type: string;
+    linkCount: number;
+}
+export interface GraphHintEdge {
+    source: string;
+    target: string;
+}
+export declare function getDefaultObsidianConfig(): ObsidianConfig;
+/**
+ * Generate the .obsidian/ directory with optimal config files
+ * for displaying an llmwiki vault.
+ */
+export declare function setupObsidian(root: string): void;
+/**
+ * Generate a graph.json hint file for quick graph rendering.
+ * Reads all wiki pages and builds a node/edge adjacency list.
+ */
+export declare function generateGraphHint(config: VaultConfig): GraphHint;
+/**
+ * Write the graph hint to disk for quick graph rendering.
+ */
+export declare function writeGraphHint(root: string, hint: GraphHint): void;
+//# sourceMappingURL=obsidian.d.ts.map

package/dist/core/obsidian.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"obsidian.d.ts","sourceRoot":"","sources":["../../src/core/obsidian.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C;;;GAGG;AAEH,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,SAAS,CAAC;IACf,KAAK,EAAE,WAAW,CAAC;IACnB,UAAU,EAAE,gBAAgB,CAAC;CAC9B;AAED,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;IACzB,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,eAAe,EAAE,CAAC;IAC/B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,OAAO,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACvD;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CACtE;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAmDD,wBAAgB,wBAAwB,IAAI,cAAc,CAMzD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAyBhD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAwChE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAOlE"}