synapsexcoder 6.0.0

package/dist/knowledge-vault/deepwiki-sync.js

@@ -0,0 +1,381 @@
+/**
+ * DeepWiki ↔ Knowledge Vault Synchronization Bridge
+ *
+ * Bidirectional sync protocol between the Knowledge Vault (persistent
+ * document store) and DeepWiki (auto-generated documentation wiki).
+ *
+ * ## Data Flow
+ *
+ *   Vault → Wiki : VaultEntry[] → WikiPage[] → wiki markdown files
+ *   Wiki → Vault : WikiPage[] → VaultEntry[] → vault files + manifest rebuild
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * const vault = new KnowledgeVault();
+ * const wiki = new DeepWiki({ rootPath: process.cwd() });
+ * const sync = new DeepWikiSync(vault, wiki);
+ *
+ * // Sync wiki pages into vault
+ * await sync.sync({ direction: "wiki-to-vault", conflictResolution: "newest-wins" });
+ * ```
+ *
+ * @module knowledge-vault/deepwiki-sync
+ */
+import { join } from "path";
+import { writeFileSync, mkdirSync, existsSync, readFileSync } from "fs";
+import { createHash } from "crypto";
+import { KnowledgeVault } from "./knowledge-vault.js";
+import { DeepWiki } from "../tools/deepwiki/index.js";
+// ============================================================================
+// Defaults
+// ============================================================================
+const VAULT_WIKI_SUBDIR = "vault-wiki-pages";
+const WIKI_VAULT_SOURCE = "deepwiki";
+const DEFAULT_CONFLICT = "newest-wins";
+// ============================================================================
+// Helpers
+// ============================================================================
+/** Compute SHA-256 hex hash of a string */
+function sha256(content) {
+    return createHash("sha256").update(content).digest("hex");
+}
+/** Slugify a string for use as a wiki page slug or filename */
+function slugify(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 80);
+}
+/** Infer a WikiCategory from a vault topic string */
+function inferWikiCategory(topic) {
+    const map = {
+        architecture: "architecture",
+        api: "api",
+        guide: "guide",
+        tutorial: "tutorial",
+        reference: "reference",
+        concept: "concept",
+        overview: "overview",
+        module: "module",
+        changelog: "changelog",
+    };
+    return map[topic.toLowerCase()] ?? "reference";
+}
+/** Infer a vault topic from a WikiCategory */
+function inferVaultTopic(category) {
+    const map = {
+        overview: "overview",
+        architecture: "architecture",
+        module: "module",
+        class: "class",
+        function: "function",
+        interface: "interface",
+        api: "api",
+        guide: "guide",
+        reference: "reference",
+        concept: "concept",
+        tutorial: "tutorial",
+        troubleshooting: "troubleshooting",
+        changelog: "changelog",
+    };
+    return map[category] ?? "general";
+}
+// ============================================================================
+// Sync Bridge
+// ============================================================================
+/**
+ * DeepWikiSync — Bidirectional sync between Knowledge Vault and DeepWiki.
+ *
+ * This class does not modify the internal state of either the vault or wiki
+ * instances. For Wiki→Vault direction it writes files to the vault's storage
+ * directory and triggers a manifest rebuild. For Vault→Wiki direction it
+ * writes wiki markdown files to an output directory.
+ */
+export class DeepWikiSync {
+    vault;
+    wiki;
+    constructor(vault, wiki) {
+        this.vault = vault;
+        this.wiki = wiki;
+    }
+    // ========================================================================
+    // Public API
+    // ========================================================================
+    /**
+     * Run a synchronization session.
+     *
+     * @param options - Sync configuration
+     * @returns Aggregate sync result with per-entry details
+     */
+    async sync(options) {
+        const timestamp = Date.now();
+        const details = [];
+        let added = 0;
+        let updated = 0;
+        let skipped = 0;
+        const errors = [];
+        const resolvedOptions = {
+            ...options,
+            conflictResolution: options.conflictResolution ?? DEFAULT_CONFLICT,
+            dryRun: options.dryRun ?? false,
+        };
+        try {
+            // --- Phase A: Vault → Wiki ---
+            if (resolvedOptions.direction === "vault-to-wiki" ||
+                resolvedOptions.direction === "bidirectional") {
+                const manifest = this.vault.loadManifest();
+                let entries = manifest.entries;
+                entries = this.applyVaultFilters(entries, resolvedOptions);
+                if (!resolvedOptions.dryRun) {
+                    const outputDir = resolvedOptions.vaultToWikiOutputDir
+                        ?? join(this.wiki.getConfig().outputDir, VAULT_WIKI_SUBDIR);
+                    mkdirSync(outputDir, { recursive: true });
+                }
+                for (const entry of entries) {
+                    const result = await this.syncVaultEntryToWiki(entry, resolvedOptions);
+                    details.push(result);
+                    this.incrementCounts(result, { added, updated, skipped }, errors);
+                    // Re-read mutated counts from closure
+                    if (result.action === "added")
+                        added++;
+                    else if (result.action === "updated")
+                        updated++;
+                    else if (result.action === "skipped")
+                        skipped++;
+                }
+            }
+            // --- Phase B: Wiki → Vault ---
+            if (resolvedOptions.direction === "wiki-to-vault" ||
+                resolvedOptions.direction === "bidirectional") {
+                const pages = this.wiki.getPages();
+                let filteredPages = this.applyWikiFilters(pages, resolvedOptions);
+                if (!resolvedOptions.dryRun) {
+                    // Ensure vault structure exists
+                    mkdirSync(join(this.vault.path, "by-topic", WIKI_VAULT_SOURCE), { recursive: true });
+                }
+                for (const page of filteredPages) {
+                    const result = this.syncWikiPageToVault(page, resolvedOptions);
+                    details.push(result);
+                    if (result.action === "added")
+                        added++;
+                    else if (result.action === "updated")
+                        updated++;
+                    else if (result.action === "skipped")
+                        skipped++;
+                }
+                // Rebuild manifest to pick up new vault entries
+                if (!resolvedOptions.dryRun && added + updated > 0) {
+                    this.vault.rebuildManifest();
+                }
+            }
+        }
+        catch (error) {
+            errors.push(error instanceof Error ? error.message : String(error));
+        }
+        return {
+            success: errors.length === 0,
+            direction: resolvedOptions.direction,
+            entriesAdded: added,
+            entriesUpdated: updated,
+            entriesSkipped: skipped,
+            errors,
+            timestamp,
+            details,
+        };
+    }
+    // ========================================================================
+    // Vault → Wiki Conversion
+    // ========================================================================
+    /**
+     * Convert a VaultEntry into a WikiPage and write it as a wiki markdown file.
+     */
+    async syncVaultEntryToWiki(entry, options) {
+        const outputDir = options.vaultToWikiOutputDir
+            ?? join(this.wiki.getConfig().outputDir, VAULT_WIKI_SUBDIR);
+        const title = entry.title;
+        const slug = slugify(title);
+        const category = inferWikiCategory(entry.topic);
+        const filePath = join(outputDir, `${slug}.md`);
+        try {
+            // Read vault entry content
+            const contentPath = join(this.vault.path, entry.contentPath);
+            let content;
+            if (existsSync(contentPath)) {
+                content = readFileSync(contentPath, "utf-8");
+            }
+            else {
+                content = `Content from vault entry: ${entry.id}\nTopic: ${entry.topic}\n`;
+            }
+            // Build wiki page markdown
+            const frontmatter = [
+                "---",
+                `id: vault-${entry.id}`,
+                `title: "${title}"`,
+                `slug: ${slug}`,
+                `category: ${category}`,
+                `tags: [${entry.tags.map((t) => `"${t}"`).join(", ")}]`,
+                `source: vault-${entry.topic}`,
+                `created: ${entry.fetchedAt}`,
+                "---",
+            ].join("\n");
+            const wikiMarkdown = `${frontmatter}\n\n${content}\n`;
+            // Check file existence BEFORE any writes
+            const fileExistedBefore = existsSync(filePath);
+            // Conflict check — does the file already exist?
+            if (fileExistedBefore) {
+                switch (options.conflictResolution) {
+                    case "skip":
+                        return { id: entry.id, title, action: "skipped", reason: "Wiki file exists, conflict=skip" };
+                    case "vault-wins":
+                        break;
+                    case "wiki-wins":
+                        return { id: entry.id, title, action: "skipped", reason: "Wiki file exists, conflict=wiki-wins" };
+                    case "newest-wins": {
+                        const existingContent = readFileSync(filePath, "utf-8");
+                        const existingMeta = existingContent.match(/created:\s*(.+)/);
+                        const existingDate = existingMeta ? new Date(existingMeta[1]).getTime() : 0;
+                        const newDate = new Date(entry.fetchedAt).getTime();
+                        if (existingDate >= newDate) {
+                            return { id: entry.id, title, action: "skipped", reason: "Wiki file is newer or same age" };
+                        }
+                        break;
+                    }
+                }
+            }
+            // Dry run: report what WOULD happen without writing
+            if (options.dryRun) {
+                return {
+                    id: entry.id,
+                    title,
+                    action: "skipped",
+                    reason: `Dry run: would ${fileExistedBefore ? "update" : "add"} ${filePath}`,
+                };
+            }
+            writeFileSync(filePath, wikiMarkdown, "utf-8");
+            return {
+                id: entry.id,
+                title,
+                action: fileExistedBefore ? "updated" : "added",
+                reason: `Written to ${filePath}`,
+            };
+        }
+        catch (error) {
+            return {
+                id: entry.id,
+                title,
+                action: "error",
+                reason: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    // ========================================================================
+    // Wiki → Vault Conversion
+    // ========================================================================
+    /**
+     * Convert a WikiPage into a VaultEntry and write it to the vault.
+     */
+    syncWikiPageToVault(page, options) {
+        const vaultPath = this.vault.path;
+        const topic = inferVaultTopic(page.category);
+        const filename = `${slugify(page.title)}.md`;
+        const content = page.content || page.summary || `# ${page.title}\n\n*Auto-synced from DeepWiki*\n`;
+        // We'll write to by-topic/{source}/{topic}/
+        const relDir = join("by-topic", WIKI_VAULT_SOURCE, topic);
+        const absDir = join(vaultPath, relDir);
+        const absPath = join(absDir, filename);
+        try {
+            // Read existing content for conflict detection
+            let existingMeta = null;
+            if (existsSync(absPath)) {
+                // Load manifest to find existing entry
+                const manifest = this.vault.loadManifest();
+                const existing = manifest.entries.find((e) => e.contentPath === join(relDir, filename));
+                if (existing) {
+                    existingMeta = { fetchedAt: existing.fetchedAt };
+                }
+            }
+            // Conflict resolution
+            if (existingMeta) {
+                switch (options.conflictResolution) {
+                    case "skip":
+                        return { id: page.id, title: page.title, action: "skipped", reason: "Vault entry exists, conflict=skip" };
+                    case "wiki-wins":
+                        break;
+                    case "vault-wins":
+                        return { id: page.id, title: page.title, action: "skipped", reason: "Vault entry exists, conflict=vault-wins" };
+                    case "newest-wins": {
+                        const existingTime = new Date(existingMeta.fetchedAt).getTime();
+                        if (existingTime >= page.updatedAt) {
+                            return { id: page.id, title: page.title, action: "skipped", reason: "Vault entry is newer or same age" };
+                        }
+                        break;
+                    }
+                }
+            }
+            if (options.dryRun) {
+                return {
+                    id: page.id,
+                    title: page.title,
+                    action: "skipped",
+                    reason: `Dry run: would ${existingMeta ? "update" : "add"} ${join(relDir, filename)}`,
+                };
+            }
+            mkdirSync(absDir, { recursive: true });
+            writeFileSync(absPath, content, "utf-8");
+            return {
+                id: page.id,
+                title: page.title,
+                action: existingMeta ? "updated" : "added",
+                reason: `Written to ${join(relDir, filename)}`,
+            };
+        }
+        catch (error) {
+            return {
+                id: page.id,
+                title: page.title,
+                action: "error",
+                reason: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    // ========================================================================
+    // Filter Helpers
+    // ========================================================================
+    applyVaultFilters(entries, options) {
+        let result = entries;
+        if (options.topicFilter?.length) {
+            result = result.filter((e) => options.topicFilter.includes(e.topic));
+        }
+        if (options.tagFilter?.length) {
+            result = result.filter((e) => e.tags.some((t) => options.tagFilter.includes(t)));
+        }
+        return result;
+    }
+    applyWikiFilters(pages, options) {
+        let result = pages;
+        if (options.topicFilter?.length) {
+            result = result.filter((p) => options.topicFilter.includes(p.category));
+        }
+        if (options.tagFilter?.length) {
+            result = result.filter((p) => p.tags.some((t) => options.tagFilter.includes(t)));
+        }
+        return result;
+    }
+    incrementCounts(result, _counts, _errors) {
+        // Side-effect free helper kept for future traceability
+    }
+}
+// ============================================================================
+// Convenience Factory
+// ============================================================================
+/**
+ * Create a DeepWikiSync instance with default vault and wiki.
+ */
+export function createDeepWikiSync(vault, wiki) {
+    const v = vault ?? new KnowledgeVault();
+    const w = wiki ?? new DeepWiki();
+    return new DeepWikiSync(v, w);
+}
+//# sourceMappingURL=deepwiki-sync.js.map

package/dist/knowledge-vault/deepwiki-sync.js.map

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

package/dist/knowledge-vault/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Synapse Knowledge Vault — public API
+ */
+export { KnowledgeVault, getDefaultVault } from "./knowledge-vault.js";
+export { DEFAULT_VAULT_PATH, HOME_VAULT_PATH, LEGACY_VAULT_PATH, DEFAULT_RETENTION, resolveVaultPath, } from "./vault-config.js";
+export type { VaultCategory, VaultEntry, VaultIndex, VaultManifest, VaultPruneResult, VaultRetentionPolicy, VaultSearchResult, } from "./types.js";
+export { DeepWikiSync, createDeepWikiSync } from "./deepwiki-sync.js";
+export type { SyncDirection, ConflictResolution, SyncOptions, SyncDetail, SyncResult, } from "./deepwiki-sync.js";
+export { ingestOpenCodeDocs, OPENCODE_DOC_URLS, } from "./opencode-doc-ingest.js";
+export type { IngestOpenCodeDocsOptions, IngestOpenCodeDocsResult, } from "./opencode-doc-ingest.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/knowledge-vault/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/knowledge-vault/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,aAAa,EACb,UAAU,EACV,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACtE,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,UAAU,EACV,UAAU,GACX,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,0BAA0B,CAAC"}

package/dist/knowledge-vault/index.js

@@ -0,0 +1,8 @@
+/**
+ * Synapse Knowledge Vault — public API
+ */
+export { KnowledgeVault, getDefaultVault } from "./knowledge-vault.js";
+export { DEFAULT_VAULT_PATH, HOME_VAULT_PATH, LEGACY_VAULT_PATH, DEFAULT_RETENTION, resolveVaultPath, } from "./vault-config.js";
+export { DeepWikiSync, createDeepWikiSync } from "./deepwiki-sync.js";
+export { ingestOpenCodeDocs, OPENCODE_DOC_URLS, } from "./opencode-doc-ingest.js";
+//# sourceMappingURL=index.js.map

package/dist/knowledge-vault/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/knowledge-vault/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAW3B,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAStE,OAAO,EACL,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC"}

package/dist/knowledge-vault/knowledge-vault.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Synapse Knowledge Vault — searchable document store with manifest + retention
+ */
+import type { VaultEntry, VaultIndex, VaultManifest, VaultPruneResult, VaultSearchResult } from "./types.js";
+export declare class KnowledgeVault {
+    private vaultPath;
+    private manifestPath;
+    constructor(vaultPath?: string);
+    get path(): string;
+    private ensureStructure;
+    private createEmptyManifest;
+    loadManifest(): VaultManifest;
+    saveManifest(manifest: VaultManifest): void;
+    /** Scan vault directories and rebuild manifest from disk */
+    rebuildManifest(): VaultManifest;
+    private walkFiles;
+    search(query: string, limit?: number): VaultSearchResult[];
+    prune(dryRun?: boolean): VaultPruneResult;
+    private removeEntryFiles;
+    getStats(): {
+        path: string;
+        entries: number;
+        totalBytes: number;
+        topics: Record<string, number>;
+    };
+    /** Store a fetched document in categorized vault folders and update manifest */
+    storeDocument(options: {
+        url: string;
+        content: string;
+        topic?: string;
+        title?: string;
+        contentType?: string;
+    }): VaultEntry;
+    /** Write lightweight index.json for external tooling */
+    writeIndex(manifest?: VaultManifest): VaultIndex;
+}
+export declare function getDefaultVault(): KnowledgeVault;
+//# sourceMappingURL=knowledge-vault.d.ts.map

package/dist/knowledge-vault/knowledge-vault.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-vault.d.ts","sourceRoot":"","sources":["../../src/knowledge-vault/knowledge-vault.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AA4BpB,qBAAa,cAAc;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAAS;gBAEjB,SAAS,CAAC,EAAE,MAAM;IAM9B,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,mBAAmB;IAY3B,YAAY,IAAI,aAAa;IAS7B,YAAY,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAK3C,4DAA4D;IAC5D,eAAe,IAAI,aAAa;IAsChC,OAAO,CAAC,SAAS;IAWjB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,iBAAiB,EAAE;IAkCtD,KAAK,CAAC,MAAM,UAAQ,GAAG,gBAAgB;IA6CvC,OAAO,CAAC,gBAAgB;IAKxB,QAAQ,IAAI;QACV,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAChC;IAgBD,gFAAgF;IAChF,aAAa,CAAC,OAAO,EAAE;QACrB,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,UAAU;IAiDd,wDAAwD;IACxD,UAAU,CAAC,QAAQ,CAAC,EAAE,aAAa,GAAG,UAAU;CAwBjD;AAED,wBAAgB,eAAe,IAAI,cAAc,CAEhD"}