brains-mcp 1.61.2

package/dist/tools/importBrainSource.js

@@ -0,0 +1,314 @@
+import fs from "fs/promises";
+import path from "path";
+import matter from "gray-matter";
+import { z } from "zod";
+import { createPages } from "./createPages.js";
+import { appendLogEntry } from "../wiki/log.js";
+const CAR_SECTION_ORDER = [
+    "Overview",
+    "Modifications",
+    "Setup-Notes",
+    "Maintenance-Log",
+    "Build-History",
+    "Event-History",
+    "2026-Strategic-Plan",
+    "Tuning-Notes",
+];
+const SKIP_BASENAMES = new Set(["published-videos.md", "video-catalog.md"]);
+export const importBrainSourceInputSchema = z.object({
+    sourceRoot: z
+        .string()
+        .min(1)
+        .describe("Absolute or relative path to a source brain folder to import"),
+    execute: z
+        .boolean()
+        .default(false)
+        .describe("If false, returns a preview plan only. If true, executes the import."),
+    maxFiles: z
+        .number()
+        .int()
+        .min(1)
+        .max(5000)
+        .default(2000)
+        .describe("Safety cap on scanned markdown files"),
+    skipRawCatalogs: z
+        .boolean()
+        .default(true)
+        .describe("Skip known large raw catalogs like published-videos.md"),
+    excludeDirs: z
+        .array(z.string())
+        .default(["data/social-posts", "caption-generation-system"])
+        .describe("Relative directory prefixes to exclude from import"),
+    chunkSize: z
+        .number()
+        .int()
+        .min(1)
+        .max(20)
+        .default(20)
+        .describe("Pages per create_pages batch while executing"),
+    runLabel: z
+        .string()
+        .optional()
+        .describe("Optional label for ingest timing logs"),
+    logTiming: z
+        .boolean()
+        .default(true)
+        .describe("If true, writes a timing summary entry to log.md after execute"),
+    previewLimit: z
+        .number()
+        .int()
+        .min(1)
+        .max(200)
+        .default(40)
+        .describe("Max preview rows returned in plan output"),
+});
+export async function importBrainSource(drive, input, userId = "") {
+    const startedAt = new Date().toISOString();
+    const startMs = Date.now();
+    const sourceRoot = path.resolve(input.sourceRoot);
+    const sourceFiles = await collectMarkdownFiles(sourceRoot, input.maxFiles);
+    const excludePrefixes = input.excludeDirs.map((d) => normalizeRelPath(d));
+    const includedFiles = [];
+    const skippedFiles = [];
+    for (const relPath of sourceFiles) {
+        const rel = normalizeRelPath(relPath);
+        if (excludePrefixes.some((prefix) => rel === prefix || rel.startsWith(`${prefix}/`))) {
+            skippedFiles.push({ path: rel, reason: "excluded_dir" });
+            continue;
+        }
+        if (input.skipRawCatalogs && SKIP_BASENAMES.has(path.posix.basename(rel))) {
+            skippedFiles.push({ path: rel, reason: "raw_catalog" });
+            continue;
+        }
+        includedFiles.push(rel);
+    }
+    const carGroups = new Map();
+    const singlePages = [];
+    const droppedEmpty = [];
+    for (const relPath of includedFiles) {
+        const absolute = path.join(sourceRoot, relPath);
+        const raw = await fs.readFile(absolute, "utf8");
+        const parsed = matter(raw);
+        const body = parsed.content.trim();
+        if (!body) {
+            droppedEmpty.push(relPath);
+            continue;
+        }
+        const carsMatch = relPath.match(/^cars\/([^/]+)\/([^/]+)\/([^/]+)\.md$/i);
+        if (carsMatch) {
+            const owner = slugify(carsMatch[1]);
+            const car = slugify(carsMatch[2]);
+            const sectionName = carsMatch[3];
+            const key = `${owner}/${car}`;
+            const title = pickTitle(parsed.data, sectionName);
+            const docs = carGroups.get(key) ?? [];
+            docs.push({ sourcePath: relPath, sectionName, title, body });
+            carGroups.set(key, docs);
+            continue;
+        }
+        const mappedFolder = mapFolder(relPath);
+        const mappedName = mapPageName(mappedFolder, relPath);
+        const title = pickTitle(parsed.data, path.posix.basename(relPath, ".md"));
+        singlePages.push({
+            page: {
+                name: mappedName,
+                title,
+                body,
+                summary: summarize(body),
+            },
+            sourcePaths: [relPath],
+        });
+    }
+    const carPages = Array.from(carGroups.entries()).map(([key, docs]) => {
+        const [owner, car] = key.split("/");
+        const sorted = docs.slice().sort((a, b) => sectionRank(a.sectionName) - sectionRank(b.sectionName));
+        const overview = sorted.find((d) => d.sectionName.toLowerCase() === "overview");
+        const title = overview?.title ?? `${humanize(owner)} ${humanize(car)}`;
+        const sectionBodies = sorted
+            .map((d) => `## ${humanize(d.sectionName)}\n\n${d.body}`)
+            .join("\n\n");
+        return {
+            page: {
+                name: `canonical/cars/${owner}-${car}.md`,
+                title,
+                body: sectionBodies,
+                summary: summarize(overview?.body ?? sorted[0]?.body ?? ""),
+            },
+            sourcePaths: sorted.map((d) => d.sourcePath),
+        };
+    });
+    const planned = dedupeByPageName([...carPages, ...singlePages]);
+    if (!input.execute) {
+        return {
+            success: true,
+            mode: "preview",
+            sourceRoot,
+            startedAt,
+            completedAt: new Date().toISOString(),
+            durationMs: Date.now() - startMs,
+            discoveredFiles: sourceFiles.length,
+            includedFiles: includedFiles.length,
+            skippedCount: skippedFiles.length + droppedEmpty.length,
+            plannedPages: planned.length,
+            skipped: {
+                excludedOrCatalog: skippedFiles.slice(0, input.previewLimit),
+                droppedEmpty: droppedEmpty.slice(0, input.previewLimit),
+            },
+            preview: planned.slice(0, input.previewLimit).map((p) => ({
+                name: p.page.name,
+                title: p.page.title,
+                summary: p.page.summary,
+                sourceCount: p.sourcePaths.length,
+                sourcePaths: p.sourcePaths,
+            })),
+        };
+    }
+    const failures = [];
+    let createdCount = 0;
+    let failedCount = 0;
+    for (let i = 0; i < planned.length; i += input.chunkSize) {
+        const batch = planned.slice(i, i + input.chunkSize);
+        const result = (await createPages(drive, {
+            pages: batch.map((p) => p.page),
+            verbose: false,
+            logTiming: false,
+            runLabel: `${input.runLabel ?? "import-brain-source"}-batch-${Math.floor(i / input.chunkSize) + 1}`,
+        }, userId));
+        createdCount += result.count;
+        failedCount += result.failedCount;
+        if (result.failures.length > 0) {
+            failures.push({
+                batch: Math.floor(i / input.chunkSize) + 1,
+                error: result.failures.map((f) => f.error).join("; "),
+            });
+        }
+    }
+    const durationMs = Date.now() - startMs;
+    const completedAt = new Date().toISOString();
+    if (input.logTiming) {
+        await appendLogEntry(drive, {
+            type: "ingest",
+            title: `Import timing: ${input.runLabel ?? "import-brain-source"}`,
+            detail: `durationMs=${durationMs}, discovered=${sourceFiles.length}, included=${includedFiles.length}, ` +
+                `planned=${planned.length}, succeeded=${createdCount}, failed=${failedCount}`,
+        }, userId).catch(() => {
+            /* non-fatal */
+        });
+    }
+    return {
+        success: failedCount === 0,
+        mode: "execute",
+        sourceRoot,
+        startedAt,
+        completedAt,
+        durationMs,
+        discoveredFiles: sourceFiles.length,
+        includedFiles: includedFiles.length,
+        skippedCount: skippedFiles.length + droppedEmpty.length,
+        plannedPages: planned.length,
+        count: createdCount,
+        failedCount,
+        failures,
+    };
+}
+async function collectMarkdownFiles(sourceRoot, maxFiles) {
+    const output = [];
+    const walk = async (dir) => {
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (output.length >= maxFiles)
+                return;
+            const abs = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                await walk(abs);
+                continue;
+            }
+            if (!entry.isFile() || !entry.name.toLowerCase().endsWith(".md"))
+                continue;
+            output.push(path.relative(sourceRoot, abs).split(path.sep).join("/"));
+        }
+    };
+    await walk(sourceRoot);
+    return output.sort((a, b) => a.localeCompare(b));
+}
+function mapFolder(relPath) {
+    if (relPath.startsWith("active/"))
+        return "projects";
+    if (relPath.startsWith("events/results/") || relPath.startsWith("data/"))
+        return "data";
+    if (relPath.startsWith("events/"))
+        return "canonical";
+    if (relPath.startsWith("core/archive/"))
+        return "history";
+    if (relPath.includes("decision"))
+        return "decisions";
+    return "canonical";
+}
+function mapPageName(folder, relPath) {
+    const withoutExt = relPath.replace(/\.md$/i, "");
+    const slug = withoutExt
+        .split("/")
+        .map((part) => slugify(part))
+        .join("-");
+    return `${folder}/${slug}.md`;
+}
+function pickTitle(frontmatterData, fallback) {
+    const data = (frontmatterData ?? {});
+    const title = data.title;
+    if (typeof title === "string" && title.trim())
+        return title.trim();
+    return humanize(fallback);
+}
+function sectionRank(name) {
+    const idx = CAR_SECTION_ORDER.findIndex((v) => v.toLowerCase() === name.toLowerCase());
+    return idx === -1 ? CAR_SECTION_ORDER.length : idx;
+}
+function dedupeByPageName(planned) {
+    const merged = new Map();
+    for (const item of planned) {
+        const key = item.page.name;
+        const existing = merged.get(key);
+        if (!existing) {
+            merged.set(key, item);
+            continue;
+        }
+        const existingBody = existing.page.body.trim();
+        const nextBody = item.page.body.trim();
+        existing.page.body = `${existingBody}\n\n## Additional Source\n\n${nextBody}`;
+        existing.page.summary = existing.page.summary || item.page.summary;
+        existing.sourcePaths = [...existing.sourcePaths, ...item.sourcePaths];
+    }
+    return Array.from(merged.values());
+}
+function summarize(body) {
+    const oneLine = body
+        .replace(/\r/g, "")
+        .split("\n")
+        .map((line) => line.trim())
+        .find((line) => line.length > 0);
+    if (!oneLine)
+        return "";
+    return oneLine.slice(0, 180);
+}
+function slugify(value) {
+    const slug = value
+        .trim()
+        .toLowerCase()
+        .replace(/\.md$/i, "")
+        .replace(/[^a-z0-9-]+/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-|-$/g, "");
+    return slug || "untitled";
+}
+function humanize(value) {
+    return value
+        .replace(/\.md$/i, "")
+        .replace(/[-_]+/g, " ")
+        .replace(/\s+/g, " ")
+        .trim()
+        .replace(/\b\w/g, (m) => m.toUpperCase());
+}
+function normalizeRelPath(value) {
+    return value.replace(/\\/g, "/").replace(/^\/+|\/+$/g, "");
+}
+//# sourceMappingURL=importBrainSource.js.map

package/dist/tools/importBrainSource.js.map

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

package/dist/tools/importWikiZip.d.ts

@@ -0,0 +1,60 @@
+import { z } from "zod";
+import type { StorageClient } from "../storage/client.js";
+export declare const importWikiZipInputSchema: z.ZodObject<{
+    zipData: z.ZodOptional<z.ZodString>;
+    zipPath: z.ZodOptional<z.ZodString>;
+    execute: z.ZodDefault<z.ZodBoolean>;
+    mode: z.ZodDefault<z.ZodEnum<["additive", "replace"]>>;
+    conflictStrategy: z.ZodDefault<z.ZodEnum<["skip", "overwrite", "merge"]>>;
+    includeSystem: z.ZodDefault<z.ZodBoolean>;
+    logTiming: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    mode: "replace" | "additive";
+    logTiming: boolean;
+    execute: boolean;
+    includeSystem: boolean;
+    conflictStrategy: "skip" | "overwrite" | "merge";
+    zipData?: string | undefined;
+    zipPath?: string | undefined;
+}, {
+    mode?: "replace" | "additive" | undefined;
+    logTiming?: boolean | undefined;
+    execute?: boolean | undefined;
+    includeSystem?: boolean | undefined;
+    zipData?: string | undefined;
+    zipPath?: string | undefined;
+    conflictStrategy?: "skip" | "overwrite" | "merge" | undefined;
+}>;
+export type ImportWikiZipInput = z.infer<typeof importWikiZipInputSchema>;
+export declare function isValidWikiFilename(name: string): boolean;
+export declare function runImportFromBuffer(drive: StorageClient, buffer: Buffer, opts?: {
+    conflictStrategy?: "overwrite" | "skip" | "error" | "merge";
+    includeSystem?: boolean;
+    deletedNames?: string[];
+    userId?: string;
+    onProgress?: (processed: number, total: number, phase: string) => void;
+}): Promise<{
+    created: number;
+    updated: number;
+    deleted: number;
+    skipped: number;
+    errors: Array<{
+        path: string;
+        reason: string;
+    }>;
+    warnings: Array<{
+        path: string;
+        reason: string;
+    }>;
+}>;
+export declare function importWikiZip(drive: StorageClient, input: ImportWikiZipInput, userId?: string): Promise<object>;
+/**
+ * Derive unique top-level folder prefixes from applied diff entries.
+ * Returns sorted paths like ["canonical/", "decisions/", "projects/"].
+ */
+export declare function computeDiscoveredFolders(diffs: Array<{
+    name: string;
+    status: string;
+}>): string[];
+export declare function buildInstructionRefreshHint(folders: string[]): string;
+//# sourceMappingURL=importWikiZip.d.ts.map

package/dist/tools/importWikiZip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"importWikiZip.d.ts","sourceRoot":"","sources":["../../src/tools/importWikiZip.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAO1D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;EAkCnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAe1E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CASzD;AAED,wBAAsB,mBAAmB,CACzC,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE;IACN,gBAAgB,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IAC5D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACjE,GACH,OAAO,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD,CAAC,CAsKD;AAED,wBAAsB,aAAa,CACnC,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,kBAAkB,EACzB,MAAM,SAAK,GACR,OAAO,CAAC,MAAM,CAAC,CAsKjB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,MAAM,EAAE,CAUjG;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAUrE"}