openclaw-cortex-memory 0.1.0-Alpha.8 → 0.1.0

package/dist/src/wiki/wiki_linter.js

@@ -0,0 +1,339 @@
+"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.lintMemoryWiki = lintMemoryWiki;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+function readJsonl(filePath) {
+    if (!fs.existsSync(filePath))
+        return [];
+    const lines = fs.readFileSync(filePath, "utf-8").split(/\r?\n/).filter(Boolean);
+    const output = [];
+    for (const line of lines) {
+        try {
+            output.push(JSON.parse(line));
+        }
+        catch {
+            // Ignore malformed lines.
+        }
+    }
+    return output;
+}
+function slugify(value) {
+    const normalized = (value || "").trim().toLowerCase();
+    if (!normalized)
+        return "unknown";
+    return normalized.replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "") || "unknown";
+}
+function readJson(filePath) {
+    if (!fs.existsSync(filePath))
+        return null;
+    try {
+        const text = fs.readFileSync(filePath, "utf-8");
+        return JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+}
+function listMarkdownFiles(dirPath) {
+    if (!fs.existsSync(dirPath))
+        return [];
+    try {
+        return fs.readdirSync(dirPath).filter(file => file.toLowerCase().endsWith(".md"));
+    }
+    catch {
+        return [];
+    }
+}
+function hasRequiredTimelineSections(markdown) {
+    return markdown.includes("## Summary")
+        && markdown.includes("## Timeline")
+        && markdown.includes("## Latest Status");
+}
+function missingRequiredSections(markdown, sections) {
+    return sections.filter(section => !markdown.includes(section));
+}
+function extractSection(markdown, title) {
+    const marker = `## ${title}`;
+    const start = markdown.indexOf(marker);
+    if (start < 0)
+        return "";
+    const rest = markdown.slice(start + marker.length);
+    const next = rest.search(/\n##\s+/);
+    return (next >= 0 ? rest.slice(0, next) : rest).trim();
+}
+function sectionHasUsefulContent(markdown, title) {
+    const body = extractSection(markdown, title);
+    if (!body)
+        return false;
+    return !/^\s*- \(none\)\s*$/m.test(body) || body.split(/\r?\n/).filter(line => line.trim()).length > 1;
+}
+function hasLegacyGenericSummary(markdown) {
+    return /has \d+ related facts in graph projection\.\s*$/m.test(markdown)
+        || /has \d+ relations\. Latest status is [a-z_]+\.\s*$/m.test(markdown)
+        || /timeline has \d+ entries\. Latest status is [a-z_]+\.\s*$/m.test(markdown);
+}
+function lintMemoryWiki(args) {
+    const now = new Date().toISOString();
+    const issues = [];
+    const categories = [
+        "pending_conflicts",
+        "projection_lag",
+        "orphan_pages",
+        "stale_claims",
+        "missing_pages",
+        "evidence_gaps",
+        "projection_consistency",
+        "markdown_structure",
+        "knowledge_quality",
+    ];
+    const conflictPath = path.join(args.memoryRoot, "graph", "conflict_queue.jsonl");
+    const pendingConflicts = readJsonl(conflictPath).filter(item => item.status === "pending");
+    if (pendingConflicts.length > 0) {
+        issues.push({
+            id: "lint_pending_conflicts",
+            category: "pending_conflicts",
+            severity: "warn",
+            summary: `${pendingConflicts.length} pending conflicts need confirmation.`,
+            next_action: "Run resolve_graph_conflict to accept/reject pending items.",
+            metadata: { pending_count: pendingConflicts.length },
+        });
+    }
+    const graphPath = path.join(args.memoryRoot, "graph", "memory.jsonl");
+    const projectionIndexPath = path.join(args.memoryRoot, "wiki", ".projection_index.json");
+    const graphMtime = fs.existsSync(graphPath) ? fs.statSync(graphPath).mtimeMs : 0;
+    const projectionMtime = fs.existsSync(projectionIndexPath) ? fs.statSync(projectionIndexPath).mtimeMs : 0;
+    const lagSeconds = graphMtime > projectionMtime ? Math.floor((graphMtime - projectionMtime) / 1000) : 0;
+    if (lagSeconds > 0) {
+        issues.push({
+            id: "lint_projection_lag",
+            category: "projection_lag",
+            severity: lagSeconds > 30 ? "warn" : "info",
+            summary: `Wiki projection is behind graph updates by ${lagSeconds}s.`,
+            next_action: "Trigger wiki projection maintenance to catch up queue events.",
+            metadata: { lag_seconds: lagSeconds },
+        });
+    }
+    const entitiesDir = path.join(args.memoryRoot, "wiki", "entities");
+    const entityFiles = fs.existsSync(entitiesDir)
+        ? fs.readdirSync(entitiesDir).filter(file => file.toLowerCase().endsWith(".md"))
+        : [];
+    const graphEntitySlugs = new Set(args.graphView.nodes.map(node => slugify(node.id)));
+    const orphanPages = entityFiles.filter(file => !graphEntitySlugs.has(slugify(file.replace(/\.md$/i, ""))));
+    if (orphanPages.length > 0) {
+        issues.push({
+            id: "lint_orphan_pages",
+            category: "orphan_pages",
+            severity: "warn",
+            summary: `${orphanPages.length} entity pages have no corresponding graph node.`,
+            next_action: "Rebuild projection or remove stale orphan pages.",
+            metadata: { orphan_pages: orphanPages },
+        });
+    }
+    const missingPages = args.graphView.nodes
+        .map(node => `${slugify(node.id)}.md`)
+        .filter(file => !entityFiles.includes(file));
+    if (missingPages.length > 0) {
+        issues.push({
+            id: "lint_missing_pages",
+            category: "missing_pages",
+            severity: "error",
+            summary: `${missingPages.length} graph entities are missing wiki pages.`,
+            next_action: "Run projection rebuild to generate missing entity pages.",
+            metadata: { missing_pages: missingPages },
+        });
+    }
+    const wikiRoot = path.join(args.memoryRoot, "wiki");
+    const topicsDir = path.join(wikiRoot, "topics");
+    const timelinesDir = path.join(wikiRoot, "timelines");
+    const topicFiles = listMarkdownFiles(topicsDir);
+    const timelineFiles = listMarkdownFiles(timelinesDir);
+    const structuralMissing = [];
+    for (const required of ["index.md", "log.md"]) {
+        if (!fs.existsSync(path.join(wikiRoot, required))) {
+            structuralMissing.push(required);
+        }
+    }
+    if (!fs.existsSync(timelinesDir)) {
+        structuralMissing.push("timelines/");
+    }
+    const sectionMissing = [];
+    for (const file of [...topicFiles.map(name => path.join(topicsDir, name)), ...timelineFiles.map(name => path.join(timelinesDir, name))]) {
+        const markdown = fs.readFileSync(file, "utf-8");
+        if (!hasRequiredTimelineSections(markdown)) {
+            sectionMissing.push(path.relative(wikiRoot, file).replace(/\\/g, "/"));
+        }
+    }
+    if (structuralMissing.length > 0 || sectionMissing.length > 0) {
+        issues.push({
+            id: "lint_wiki_markdown_structure",
+            category: "markdown_structure",
+            severity: structuralMissing.length > 0 ? "error" : "warn",
+            summary: `Wiki markdown structure check failed (missing=${structuralMissing.length}, invalid_sections=${sectionMissing.length}).`,
+            next_action: "Regenerate wiki projection so required files and Summary/Timeline/Latest Status sections are restored.",
+            metadata: {
+                error_code: "wiki_markdown_check_failed",
+                missing: structuralMissing,
+                invalid_sections: sectionMissing,
+            },
+        });
+    }
+    const knowledgeQualityProblems = [];
+    const collectQualityProblems = (dirPath, fileNames, requiredSections, kind) => {
+        for (const file of fileNames) {
+            const filePath = path.join(dirPath, file);
+            const markdown = fs.readFileSync(filePath, "utf-8");
+            const relPath = path.relative(wikiRoot, filePath).replace(/\\/g, "/");
+            const missing = missingRequiredSections(markdown, requiredSections);
+            if (missing.length > 0) {
+                knowledgeQualityProblems.push(`${relPath}:missing_sections=${missing.map(item => item.replace(/^##\s*/, "")).join(",")}`);
+            }
+            if (hasLegacyGenericSummary(markdown)) {
+                knowledgeQualityProblems.push(`${relPath}:legacy_generic_summary`);
+            }
+            if ((kind === "entity" || kind === "topic" || kind === "timeline") && !sectionHasUsefulContent(markdown, "Evidence Excerpts")) {
+                knowledgeQualityProblems.push(`${relPath}:empty_evidence_excerpts`);
+            }
+        }
+    };
+    collectQualityProblems(entitiesDir, entityFiles, [
+        "## Current Conclusion",
+        "## Recent Changes",
+        "## High Confidence Facts",
+        "## Evidence Excerpts",
+    ], "entity");
+    collectQualityProblems(topicsDir, topicFiles, [
+        "## Current Conclusion",
+        "## Status Groups",
+        "## Evidence Excerpts",
+    ], "topic");
+    collectQualityProblems(timelinesDir, timelineFiles, [
+        "## Current Conclusion",
+        "## Event Flow",
+        "## Evidence Excerpts",
+    ], "timeline");
+    if (knowledgeQualityProblems.length > 0) {
+        issues.push({
+            id: "lint_wiki_knowledge_quality",
+            category: "knowledge_quality",
+            severity: "warn",
+            summary: `${knowledgeQualityProblems.length} wiki page quality checks failed.`,
+            next_action: "Regenerate wiki projection so pages include conclusions, recent changes, status groups, event flow, and evidence excerpts.",
+            metadata: {
+                error_code: "wiki_knowledge_quality_check_failed",
+                problems: knowledgeQualityProblems.slice(0, 50),
+            },
+        });
+    }
+    const projectionIndex = readJson(projectionIndexPath);
+    const projectionMissing = [];
+    for (const listKey of ["entities", "topics", "timelines"]) {
+        const rows = Array.isArray(projectionIndex?.[listKey]) ? projectionIndex?.[listKey] : [];
+        for (const row of rows) {
+            const relPath = typeof row.path === "string" ? row.path.trim() : "";
+            if (!relPath)
+                continue;
+            const absPath = path.join(wikiRoot, relPath);
+            if (!fs.existsSync(absPath)) {
+                projectionMissing.push(relPath);
+            }
+        }
+    }
+    if (projectionMissing.length > 0) {
+        issues.push({
+            id: "lint_projection_consistency",
+            category: "projection_consistency",
+            severity: "warn",
+            summary: `${projectionMissing.length} projection index entries point to missing wiki files.`,
+            next_action: "Rebuild wiki projection index after regenerating entities/topics/timelines pages.",
+            metadata: {
+                error_code: "wiki_projection_inconsistent_check_failed",
+                missing_projection_paths: projectionMissing,
+            },
+        });
+    }
+    const staleClaims = [];
+    for (const file of entityFiles) {
+        const filePath = path.join(entitiesDir, file);
+        const text = fs.readFileSync(filePath, "utf-8");
+        const currentSection = text.split("## Current Facts")[1]?.split("##")[0] || "";
+        if (currentSection.includes("/superseded") || currentSection.includes("/rejected")) {
+            staleClaims.push(file);
+        }
+    }
+    if (staleClaims.length > 0) {
+        issues.push({
+            id: "lint_stale_claims",
+            category: "stale_claims",
+            severity: "warn",
+            summary: `${staleClaims.length} entity pages show stale superseded/rejected claims as current.`,
+            next_action: "Rebuild affected entity pages from latest graph view.",
+            metadata: { stale_pages: staleClaims },
+        });
+    }
+    const evidenceGapEdges = args.graphView.edges.filter(edge => !edge.evidence_span || typeof edge.confidence !== "number");
+    if (evidenceGapEdges.length > 0) {
+        issues.push({
+            id: "lint_evidence_gaps",
+            category: "evidence_gaps",
+            severity: "error",
+            summary: `${evidenceGapEdges.length} relations are missing evidence_span/confidence.`,
+            next_action: "Backfill evidence metadata or reject low-quality relations.",
+            metadata: {
+                sample: evidenceGapEdges.slice(0, 10).map(edge => ({
+                    source: edge.source,
+                    type: edge.type,
+                    target: edge.target,
+                    status: edge.status,
+                })),
+            },
+        });
+    }
+    const byCategory = {};
+    for (const category of categories) {
+        byCategory[category] = issues.filter(issue => issue.category === category).length;
+    }
+    return {
+        generated_at: now,
+        summary: {
+            total_issues: issues.length,
+            by_category: byCategory,
+        },
+        categories,
+        issues,
+    };
+}
+//# sourceMappingURL=wiki_linter.js.map

package/dist/src/wiki/wiki_linter.js.map

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

package/dist/src/wiki/wiki_logger.d.ts

@@ -0,0 +1,10 @@
+interface WikiLogEntry {
+    memoryRoot: string;
+    type: "graph_append" | "conflict_pending" | "conflict_accepted" | "conflict_rejected";
+    source_event_id?: string;
+    conflict_id?: string;
+    message: string;
+}
+export declare function appendWikiLog(entry: WikiLogEntry): void;
+export {};
+//# sourceMappingURL=wiki_logger.d.ts.map

package/dist/src/wiki/wiki_logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki_logger.d.ts","sourceRoot":"","sources":["../../../src/wiki/wiki_logger.ts"],"names":[],"mappings":"AAGA,UAAU,YAAY;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,cAAc,GAAG,kBAAkB,GAAG,mBAAmB,GAAG,mBAAmB,CAAC;IACtF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AA0BD,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAiBvD"}

package/dist/src/wiki/wiki_logger.js

@@ -0,0 +1,78 @@
+"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.appendWikiLog = appendWikiLog;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+function logPath(memoryRoot) {
+    return path.join(memoryRoot, "wiki", "log.md");
+}
+function ensureParent(filePath) {
+    const dirPath = path.dirname(filePath);
+    if (!fs.existsSync(dirPath)) {
+        fs.mkdirSync(dirPath, { recursive: true });
+    }
+}
+function ensureLogHeader(filePath) {
+    if (fs.existsSync(filePath) && fs.statSync(filePath).size > 0) {
+        return;
+    }
+    const header = [
+        "# Memory Wiki Log",
+        "",
+        "Auto-generated maintenance log for graph->wiki projection events.",
+        "",
+    ].join("\n");
+    fs.writeFileSync(filePath, `${header}\n`, "utf-8");
+}
+function appendWikiLog(entry) {
+    const filePath = logPath(entry.memoryRoot);
+    ensureParent(filePath);
+    ensureLogHeader(filePath);
+    const now = new Date().toISOString();
+    const parts = [
+        `- [${now}]`,
+        entry.type,
+        entry.message,
+    ];
+    if (entry.source_event_id) {
+        parts.push(`source_event_id=${entry.source_event_id}`);
+    }
+    if (entry.conflict_id) {
+        parts.push(`conflict_id=${entry.conflict_id}`);
+    }
+    fs.appendFileSync(filePath, `${parts.join(" | ")}\n`, "utf-8");
+}
+//# sourceMappingURL=wiki_logger.js.map

package/dist/src/wiki/wiki_logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki_logger.js","sourceRoot":"","sources":["../../../src/wiki/wiki_logger.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,sCAiBC;AApDD,uCAAyB;AACzB,2CAA6B;AAU7B,SAAS,OAAO,CAAC,UAAkB;IACjC,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,YAAY,CAAC,QAAgB;IACpC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,QAAgB;IACvC,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QAC9D,OAAO;IACT,CAAC;IACD,MAAM,MAAM,GAAG;QACb,mBAAmB;QACnB,EAAE;QACF,mEAAmE;QACnE,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,GAAG,MAAM,IAAI,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC;AAED,SAAgB,aAAa,CAAC,KAAmB;IAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC3C,YAAY,CAAC,QAAQ,CAAC,CAAC;IACvB,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC1B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,KAAK,GAAG;QACZ,MAAM,GAAG,GAAG;QACZ,KAAK,CAAC,IAAI;QACV,KAAK,CAAC,OAAO;KACd,CAAC;IACF,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,mBAAmB,KAAK,CAAC,eAAe,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,EAAE,CAAC,cAAc,CAAC,QAAQ,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACjE,CAAC"}

package/dist/src/wiki/wiki_maintainer.d.ts

@@ -0,0 +1,39 @@
+import type { GraphViewData } from "../store/graph_memory_store";
+interface LoggerLike {
+    info: (message: string, ...args: unknown[]) => void;
+    warn: (message: string, ...args: unknown[]) => void;
+}
+interface MaintainWikiProjectionArgs {
+    memoryRoot: string;
+    graphView: GraphViewData;
+    maxBatch?: number;
+    logger?: LoggerLike;
+    force?: boolean;
+}
+interface MaintainWikiProjectionResult {
+    processed: number;
+    remaining: number;
+    snapshot: {
+        view_path: string;
+        timeline_path: string;
+        snapshot_id: string;
+        mermaid_path: string;
+        network_markdown_path: string;
+    } | null;
+    projected: {
+        updated_at: string;
+        entities_count: number;
+        topics_count: number;
+        timelines_count: number;
+        files: {
+            index: string;
+            projection_index: string;
+            entities_dir: string;
+            topics_dir: string;
+            timelines_dir: string;
+        };
+    } | null;
+}
+export declare function maintainWikiProjection(args: MaintainWikiProjectionArgs): MaintainWikiProjectionResult;
+export type { MaintainWikiProjectionResult };
+//# sourceMappingURL=wiki_maintainer.d.ts.map

package/dist/src/wiki/wiki_maintainer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki_maintainer.d.ts","sourceRoot":"","sources":["../../../src/wiki/wiki_maintainer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,UAAU,UAAU;IAClB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACpD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACrD;AAED,UAAU,0BAA0B;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,aAAa,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,UAAU,4BAA4B;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE;QACR,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,qBAAqB,EAAE,MAAM,CAAC;KAC/B,GAAG,IAAI,CAAC;IACT,SAAS,EACL;QACA,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;QACxB,KAAK,EAAE;YACL,KAAK,EAAE,MAAM,CAAC;YACd,gBAAgB,EAAE,MAAM,CAAC;YACzB,YAAY,EAAE,MAAM,CAAC;YACrB,UAAU,EAAE,MAAM,CAAC;YACnB,aAAa,EAAE,MAAM,CAAC;SACvB,CAAC;KACH,GACC,IAAI,CAAC;CACV;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,0BAA0B,GAAG,4BAA4B,CAiCrG;AAED,YAAY,EAAE,4BAA4B,EAAE,CAAC"}

package/dist/src/wiki/wiki_maintainer.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.maintainWikiProjection = maintainWikiProjection;
+const wiki_queue_1 = require("./wiki_queue");
+const wiki_projector_1 = require("./wiki_projector");
+function maintainWikiProjection(args) {
+    const drain = (0, wiki_queue_1.drainWikiRebuildQueue)({
+        memoryRoot: args.memoryRoot,
+        maxBatch: args.maxBatch,
+    });
+    if (drain.drained.length === 0 && args.force !== true) {
+        return {
+            processed: 0,
+            remaining: 0,
+            snapshot: null,
+            projected: null,
+        };
+    }
+    const snapshot = (0, wiki_projector_1.writeGraphViewProjection)({
+        memoryRoot: args.memoryRoot,
+        view: args.graphView,
+    });
+    const projected = (0, wiki_projector_1.projectWikiKnowledge)({
+        memoryRoot: args.memoryRoot,
+        graphView: args.graphView,
+        queueEvents: drain.drained,
+    });
+    if (args.logger) {
+        args.logger.info(`wiki_projection_maintained processed=${drain.drained.length} remaining=${drain.remaining} entities=${projected.entities_count} topics=${projected.topics_count} timelines=${projected.timelines_count}`);
+    }
+    return {
+        processed: drain.drained.length,
+        remaining: drain.remaining,
+        snapshot,
+        projected,
+    };
+}
+//# sourceMappingURL=wiki_maintainer.js.map

package/dist/src/wiki/wiki_maintainer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki_maintainer.js","sourceRoot":"","sources":["../../../src/wiki/wiki_maintainer.ts"],"names":[],"mappings":";;AA4CA,wDAiCC;AA7ED,6CAAqD;AACrD,qDAAkF;AA2ClF,SAAgB,sBAAsB,CAAC,IAAgC;IACrE,MAAM,KAAK,GAAG,IAAA,kCAAqB,EAAC;QAClC,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC,CAAC;IACH,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QACtD,OAAO;YACL,SAAS,EAAE,CAAC;YACZ,SAAS,EAAE,CAAC;YACZ,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,IAAI;SAChB,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,IAAA,yCAAwB,EAAC;QACxC,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,IAAI,EAAE,IAAI,CAAC,SAAS;KACrB,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,IAAA,qCAAoB,EAAC;QACrC,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,WAAW,EAAE,KAAK,CAAC,OAAO;KAC3B,CAAC,CAAC;IACH,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,wCAAwC,KAAK,CAAC,OAAO,CAAC,MAAM,cAAc,KAAK,CAAC,SAAS,aAAa,SAAS,CAAC,cAAc,WAAW,SAAS,CAAC,YAAY,cAAc,SAAS,CAAC,eAAe,EAAE,CACzM,CAAC;IACJ,CAAC;IACD,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM;QAC/B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ;QACR,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/src/wiki/wiki_projector.d.ts

@@ -0,0 +1,35 @@
+import type { GraphViewData } from "../store/graph_memory_store";
+import type { WikiRebuildEvent } from "./wiki_queue";
+interface WriteGraphViewProjectionArgs {
+    memoryRoot: string;
+    view: GraphViewData;
+}
+interface WriteGraphViewProjectionResult {
+    view_path: string;
+    timeline_path: string;
+    snapshot_id: string;
+    mermaid_path: string;
+    network_markdown_path: string;
+}
+interface ProjectWikiKnowledgeArgs {
+    memoryRoot: string;
+    graphView: GraphViewData;
+    queueEvents: WikiRebuildEvent[];
+}
+interface ProjectWikiKnowledgeResult {
+    updated_at: string;
+    entities_count: number;
+    topics_count: number;
+    timelines_count: number;
+    files: {
+        index: string;
+        projection_index: string;
+        entities_dir: string;
+        topics_dir: string;
+        timelines_dir: string;
+    };
+}
+export declare function writeGraphViewProjection(args: WriteGraphViewProjectionArgs): WriteGraphViewProjectionResult;
+export declare function projectWikiKnowledge(args: ProjectWikiKnowledgeArgs): ProjectWikiKnowledgeResult;
+export type { WriteGraphViewProjectionResult, ProjectWikiKnowledgeResult };
+//# sourceMappingURL=wiki_projector.d.ts.map

package/dist/src/wiki/wiki_projector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki_projector.d.ts","sourceRoot":"","sources":["../../../src/wiki/wiki_projector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGrD,UAAU,4BAA4B;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,UAAU,8BAA8B;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,UAAU,wBAAwB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,aAAa,CAAC;IACzB,WAAW,EAAE,gBAAgB,EAAE,CAAC;CACjC;AAED,UAAU,0BAA0B;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,gBAAgB,EAAE,MAAM,CAAC;QACzB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAqVD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,4BAA4B,GAAG,8BAA8B,CAiD3G;AAioBD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,wBAAwB,GAAG,0BAA0B,CAoS/F;AAED,YAAY,EAAE,8BAA8B,EAAE,0BAA0B,EAAE,CAAC"}