brains-mcp 1.61.2

package/dist/webhooks/webhookRules.js

@@ -0,0 +1,129 @@
+/**
+ * webhookRules.ts
+ *
+ * Postgres CRUD for user-configured outbound webhook rules.
+ * Table schema: scripts/webhooks-migration.sql
+ */
+function rowToRule(row) {
+    return {
+        id: row.id,
+        userId: row.user_id,
+        name: row.name,
+        url: row.url,
+        secret: row.secret,
+        events: row.events ?? [],
+        patterns: row.patterns ?? [],
+        enabled: row.enabled,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+    };
+}
+function getHeaders(serviceRoleKey) {
+    return {
+        "content-type": "application/json",
+        "apikey": serviceRoleKey,
+        "authorization": "Bearer " + serviceRoleKey,
+    };
+}
+function getBaseUrl() {
+    const supabaseUrl = (process.env.SUPABASE_URL ?? "").trim().replace(/\/$/, "");
+    return supabaseUrl + "/rest/v1/webhook_rules";
+}
+function isConfigured() {
+    const supabaseUrl = (process.env.SUPABASE_URL ?? "").trim();
+    const serviceRoleKey = (process.env.SUPABASE_SERVICE_ROLE_KEY ?? "").trim();
+    return supabaseUrl.length > 0 && serviceRoleKey.length > 0;
+}
+export async function listWebhookRules(userId) {
+    if (!isConfigured())
+        return [];
+    const serviceRoleKey = (process.env.SUPABASE_SERVICE_ROLE_KEY ?? "").trim();
+    const url = getBaseUrl() + "?user_id=eq." + encodeURIComponent(userId) + "&order=created_at.asc";
+    const res = await fetch(url, {
+        headers: { ...getHeaders(serviceRoleKey), "Accept": "application/json" },
+        signal: AbortSignal.timeout(8000),
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new Error("Failed to list webhook rules: " + res.status + " " + text);
+    }
+    const rows = await res.json();
+    return rows.map(rowToRule);
+}
+export async function getWebhookRule(id, userId) {
+    if (!isConfigured())
+        return null;
+    const serviceRoleKey = (process.env.SUPABASE_SERVICE_ROLE_KEY ?? "").trim();
+    const url = getBaseUrl() + "?id=eq." + encodeURIComponent(id) + "&user_id=eq." + encodeURIComponent(userId);
+    const res = await fetch(url, {
+        headers: { ...getHeaders(serviceRoleKey), "Accept": "application/json" },
+        signal: AbortSignal.timeout(8000),
+    });
+    if (!res.ok)
+        return null;
+    const rows = await res.json();
+    return rows.length > 0 ? rowToRule(rows[0]) : null;
+}
+export async function upsertWebhookRule(userId, rule) {
+    if (!isConfigured())
+        throw new Error("Postgres not configured — cannot store webhook rules");
+    const serviceRoleKey = (process.env.SUPABASE_SERVICE_ROLE_KEY ?? "").trim();
+    const body = {
+        user_id: userId,
+        name: rule.name,
+        url: rule.url,
+        secret: rule.secret ?? "",
+        events: rule.events ?? ["create", "update"],
+        patterns: rule.patterns ?? [],
+        enabled: rule.enabled ?? true,
+    };
+    if (rule.id)
+        body["id"] = rule.id;
+    const res = await fetch(getBaseUrl(), {
+        method: "POST",
+        headers: {
+            ...getHeaders(serviceRoleKey),
+            "Prefer": "return=representation,resolution=merge-duplicates",
+        },
+        body: JSON.stringify(body),
+        signal: AbortSignal.timeout(8000),
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new Error("Failed to upsert webhook rule: " + res.status + " " + text);
+    }
+    const rows = await res.json();
+    if (!rows[0])
+        throw new Error("Upsert returned no rows");
+    return rowToRule(rows[0]);
+}
+export async function deleteWebhookRule(id, userId) {
+    if (!isConfigured())
+        return false;
+    const serviceRoleKey = (process.env.SUPABASE_SERVICE_ROLE_KEY ?? "").trim();
+    const url = getBaseUrl() + "?id=eq." + encodeURIComponent(id) + "&user_id=eq." + encodeURIComponent(userId);
+    const res = await fetch(url, {
+        method: "DELETE",
+        headers: { ...getHeaders(serviceRoleKey), "Prefer": "return=minimal" },
+        signal: AbortSignal.timeout(8000),
+    });
+    return res.ok;
+}
+export async function addPatternToRule(id, userId, pattern) {
+    const rule = await getWebhookRule(id, userId);
+    if (!rule)
+        return null;
+    if (rule.patterns.includes(pattern))
+        return rule; // idempotent
+    const updated = await upsertWebhookRule(userId, {
+        ...rule,
+        patterns: [...rule.patterns, pattern],
+    });
+    return updated;
+}
+/** Returns enabled rules for a user that have at least one pattern configured. */
+export async function getEnabledWebhookRulesForUser(userId) {
+    const all = await listWebhookRules(userId);
+    return all.filter((r) => r.enabled && r.patterns.length > 0);
+}
+//# sourceMappingURL=webhookRules.js.map

package/dist/webhooks/webhookRules.js.map

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

package/dist/wiki/frontmatter.d.ts

@@ -0,0 +1,45 @@
+import { WikiValidationWarning } from "../drive/errors.js";
+export interface WikiFrontmatter {
+    title: string;
+    updated: string;
+    /** ISO 8601 datetime when the page was first created (e.g. 2026-05-11T14:32:00Z). */
+    created?: string;
+    tags?: string[];
+    /**
+     * Alternate names for the project this page is the readme of — the nicknames
+     * a user actually says. Read by resolve_project; ignored elsewhere.
+     *
+     * Deliberately separate from `tags`. Tags express membership as often as
+     * naming (`oio` on a vehicle's readme means "belongs to OIO"), so inferring
+     * aliases from them produced false matches no filter could reliably remove
+     * (GH #446). Absent means no aliases — there is no tag fallback.
+     */
+    aliases?: string[];
+    status?: "active" | "archived" | "draft";
+    summary?: string;
+    /** Access level gate (1–5). Pages are only visible to users at this level or above. */
+    access_level?: number;
+    /** Audience classification: internal | client-safe | public. */
+    audience?: string;
+    [key: string]: unknown;
+}
+export interface ParsedPage {
+    frontmatter: WikiFrontmatter;
+    content: string;
+    warnings: WikiValidationWarning[];
+}
+/**
+ * Parse markdown content and soft-validate frontmatter.
+ * Returns warnings for missing/invalid fields but never throws.
+ */
+export declare function parsePage(raw: string): ParsedPage;
+/**
+ * Serialize frontmatter + body back to a markdown string.
+ * Stamps the current date into the 'updated' field.
+ */
+export declare function serializePage(fm: WikiFrontmatter, body: string): string;
+/**
+ * Build a fresh page string from title + body, inserting required frontmatter.
+ */
+export declare function buildNewPage(title: string, body: string, tags?: string[]): string;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/wiki/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/wiki/frontmatter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uFAAuF;IACvF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,eAAe,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,qBAAqB,EAAE,CAAC;CACnC;AAoBD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAqCjD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMvE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAQjF"}

package/dist/wiki/frontmatter.js

@@ -0,0 +1,68 @@
+import matter from "gray-matter";
+import { WikiValidationWarning } from "../drive/errors.js";
+const REQUIRED_FIELDS = ["title", "updated"];
+/**
+ * gray-matter (via js-yaml) parses unquoted YAML dates like `updated: 2026-07-27`
+ * into JS Date objects rather than strings. Left alone, `String(date)` produces
+ * `"Mon Jul 27 2026 00:00:00 GMT..."`, which fails downstream YYYY-MM-DD checks
+ * even though the source frontmatter was written correctly (GH #464).
+ */
+function normalizeDateFields(fm) {
+    for (const key of Object.keys(fm)) {
+        const value = fm[key];
+        if (value instanceof Date) {
+            const iso = value.toISOString();
+            fm[key] = iso.endsWith("T00:00:00.000Z") ? iso.slice(0, 10) : iso;
+        }
+    }
+}
+/**
+ * Parse markdown content and soft-validate frontmatter.
+ * Returns warnings for missing/invalid fields but never throws.
+ */
+export function parsePage(raw) {
+    const parsed = matter(raw);
+    const fm = (parsed.data ?? {});
+    normalizeDateFields(fm);
+    const warnings = [];
+    for (const field of REQUIRED_FIELDS) {
+        if (!fm[field]) {
+            warnings.push(new WikiValidationWarning(field, `Required field '${field}' is missing`));
+        }
+    }
+    if (fm.updated && !/^\d{4}-\d{2}-\d{2}/.test(String(fm.updated))) {
+        warnings.push(new WikiValidationWarning("updated", `'updated' should be in YYYY-MM-DD format, got: ${fm.updated}`));
+    }
+    if (fm.status && !["active", "archived", "draft"].includes(String(fm.status))) {
+        warnings.push(new WikiValidationWarning("status", `'status' should be active | archived | draft, got: ${fm.status}`));
+    }
+    return {
+        frontmatter: fm,
+        content: parsed.content,
+        warnings,
+    };
+}
+/**
+ * Serialize frontmatter + body back to a markdown string.
+ * Stamps the current date into the 'updated' field.
+ */
+export function serializePage(fm, body) {
+    const frontmatterWithDate = {
+        ...fm,
+        updated: new Date().toISOString().slice(0, 10),
+    };
+    return matter.stringify(body, frontmatterWithDate);
+}
+/**
+ * Build a fresh page string from title + body, inserting required frontmatter.
+ */
+export function buildNewPage(title, body, tags) {
+    const fm = {
+        title,
+        updated: new Date().toISOString().slice(0, 10),
+        status: "active",
+        ...(tags && tags.length > 0 ? { tags } : {}),
+    };
+    return matter.stringify(`\n${body}`, fm);
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/wiki/frontmatter.js.map

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

package/dist/wiki/index.d.ts

@@ -0,0 +1,22 @@
+import type { StorageClient } from "../storage/client.js";
+export interface IndexEntry {
+    name: string;
+    title: string;
+    summary: string;
+    updated: string;
+}
+/**
+ * Append or update an entry in index.md.
+ * Reads current index, upserts the row for `name`, then writes back.
+ * Safe to call fire-and-forget; retries once on write conflict.
+ *
+ * No-op when the Postgres index is configured — see indexFileIsAuthoritative().
+ */
+export declare function upsertIndexEntry(drive: StorageClient, entry: IndexEntry): Promise<void>;
+/**
+ * Remove an entry from index.md by filename.
+ *
+ * No-op when the Postgres index is configured — see indexFileIsAuthoritative().
+ */
+export declare function removeIndexEntry(drive: StorageClient, name: string): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/wiki/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/wiki/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAK1D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AA4BD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,IAAI,CAAC,CAMf;AAyDD;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/dist/wiki/index.js

@@ -0,0 +1,203 @@
+import crypto from "crypto";
+import { DriveConflictError } from "../drive/errors.js";
+import { getPostgresSearchIndex } from "../search/postgresIndex.js";
+const INDEX_FILE = "index.md";
+const TABLE_HEADER = "| ID | Page | Summary | Updated |";
+const TABLE_SEPARATOR = "|---|---|---|---|";
+const LEGACY_TABLE_HEADER = "| Page | Summary | Updated |";
+const LEGACY_TABLE_SEPARATOR = "|---|---|---|";
+const DATA_INDEX_NAME = "data/";
+/**
+ * True when index.md is still the catalog of record.
+ *
+ * Once the Postgres index is configured it is authoritative for every listing
+ * path — list_pages and search_pages query it directly and exclude index.md at
+ * the query level, the tool descriptions tell agents not to read index.md for
+ * routing, and seed/instructions/brains-protocol.md repeats that instruction.
+ * Maintaining the file anyway cost a full read-modify-write of it on every
+ * create/update/patch/move/restore/delete — ~400 KB of Storage transfer per
+ * page write on a large wiki, plus a conflict-retry path that concurrent
+ * writes made more likely (GH #410).
+ *
+ * The file is still bootstrapped and still exists — httpServer's scoped-client
+ * wipe check probes it — it just stops being rewritten.
+ */
+function indexFileIsAuthoritative() {
+    return !getPostgresSearchIndex().isConfigured();
+}
+/**
+ * Append or update an entry in index.md.
+ * Reads current index, upserts the row for `name`, then writes back.
+ * Safe to call fire-and-forget; retries once on write conflict.
+ *
+ * No-op when the Postgres index is configured — see indexFileIsAuthoritative().
+ */
+export async function upsertIndexEntry(drive, entry) {
+    if (!indexFileIsAuthoritative())
+        return;
+    await upsertIndexEntryOnce(drive, entry).catch(async (err) => {
+        if (!(err instanceof DriveConflictError))
+            throw err;
+        await upsertIndexEntryOnce(drive, entry);
+    });
+}
+async function upsertIndexEntryOnce(drive, entry) {
+    const file = await drive.readFile(INDEX_FILE);
+    const lines = file.content.split("\n");
+    // Find the table start
+    let headerIdx = lines.findIndex((l) => l.startsWith(TABLE_HEADER));
+    const legacyHeaderIdx = lines.findIndex((l) => l.startsWith(LEGACY_TABLE_HEADER));
+    if (headerIdx === -1 && legacyHeaderIdx !== -1) {
+        // Migrate legacy 3-column table to 4-column ID table in-place.
+        lines[legacyHeaderIdx] = TABLE_HEADER;
+        if (lines[legacyHeaderIdx + 1]?.startsWith(LEGACY_TABLE_SEPARATOR)) {
+            lines[legacyHeaderIdx + 1] = TABLE_SEPARATOR;
+        }
+        migrateLegacyRows(lines, legacyHeaderIdx + 2);
+        headerIdx = legacyHeaderIdx;
+    }
+    if (headerIdx === -1) {
+        // Append table if it doesn't exist
+        const rows = [buildRow(entry)];
+        if (isDataPageName(entry.name)) {
+            const dataEntry = await buildDataAggregateEntry(drive);
+            rows.splice(0, rows.length, buildRow(dataEntry));
+        }
+        const updated = file.content.trim() +
+            `\n\n${TABLE_HEADER}\n${TABLE_SEPARATOR}\n${rows.join("\n")}\n`;
+        await drive.updateFile(file.fileId, updated, file.revision);
+        return;
+    }
+    const tableStart = headerIdx + 2; // skip separator row
+    pruneDataFileRows(lines, tableStart);
+    if (isDataPageName(entry.name)) {
+        const dataEntry = await buildDataAggregateEntry(drive);
+        upsertRow(lines, tableStart, buildRow(dataEntry), dataEntry.name);
+        await drive.updateFile(file.fileId, lines.join("\n"), file.revision);
+        return;
+    }
+    const row = buildRow(entry);
+    upsertRow(lines, tableStart, row, entry.name);
+    const dataEntry = await buildDataAggregateEntry(drive);
+    upsertRow(lines, tableStart, buildRow(dataEntry), dataEntry.name);
+    await drive.updateFile(file.fileId, lines.join("\n"), file.revision);
+}
+/**
+ * Remove an entry from index.md by filename.
+ *
+ * No-op when the Postgres index is configured — see indexFileIsAuthoritative().
+ */
+export async function removeIndexEntry(drive, name) {
+    if (!indexFileIsAuthoritative())
+        return;
+    await removeIndexEntryOnce(drive, name).catch(async (err) => {
+        if (!(err instanceof DriveConflictError))
+            throw err;
+        await removeIndexEntryOnce(drive, name);
+    });
+}
+async function removeIndexEntryOnce(drive, name) {
+    const file = await drive.readFile(INDEX_FILE);
+    const lines = file.content.split("\n").filter((l) => !l.includes(`[${name}]`));
+    const headerIdx = lines.findIndex((l) => l.startsWith(TABLE_HEADER));
+    if (headerIdx !== -1) {
+        const tableStart = headerIdx + 2;
+        pruneDataFileRows(lines, tableStart);
+        const dataEntry = await buildDataAggregateEntry(drive);
+        upsertRow(lines, tableStart, buildRow(dataEntry), dataEntry.name);
+    }
+    await drive.updateFile(file.fileId, lines.join("\n"), file.revision);
+}
+function upsertRow(lines, tableStart, row, name) {
+    const existingIdx = lines.findIndex((l, i) => i >= tableStart && l.includes(`[${name}]`));
+    if (existingIdx !== -1) {
+        lines[existingIdx] = row;
+    }
+    else {
+        lines.splice(tableStart, 0, row);
+    }
+}
+function buildRow(entry) {
+    const id = indexIdFromName(entry.name);
+    const link = `[${entry.name}](${entry.name})`;
+    const summary = entry.summary.replace(/\|/g, "\\|");
+    return `| ${id} | ${link} | ${summary} | ${entry.updated} |`;
+}
+function dataAggregateEntry(fileCount, latestDate) {
+    return {
+        name: DATA_INDEX_NAME,
+        title: "Data Folder",
+        summary: `Data repository (${fileCount} files). Individual data pages are omitted from index; browse data/ for details.`,
+        updated: latestDate,
+    };
+}
+/**
+ * Build the `data/` rollup row for index.md.
+ *
+ * Only reached when index.md is still the catalog of record, i.e. Postgres is
+ * not configured — which in practice means a local or Drive backend, where
+ * listFiles() is a cheap filesystem walk rather than one HTTP request per
+ * folder. (Supabase storage always implies a configured Postgres index, so the
+ * expensive combination cannot occur.)
+ */
+async function buildDataAggregateEntry(drive) {
+    const today = new Date().toISOString().slice(0, 10);
+    const files = await drive.listFiles();
+    const dataFiles = files.filter((f) => isDataPageName(f.name));
+    const latestDate = dataFiles
+        .map((f) => f.modifiedTime.slice(0, 10))
+        .sort((a, b) => b.localeCompare(a))[0] ?? today;
+    return dataAggregateEntry(dataFiles.length, latestDate);
+}
+function pruneDataFileRows(lines, tableStart) {
+    for (let i = lines.length - 1; i >= tableStart; i -= 1) {
+        const line = lines[i]?.trim() ?? "";
+        if (!line.startsWith("|"))
+            continue;
+        if (line.startsWith("|---"))
+            continue;
+        const name = extractLinkedName(line);
+        if (!name)
+            continue;
+        if (name === DATA_INDEX_NAME || isDataPageName(name)) {
+            lines.splice(i, 1);
+        }
+    }
+}
+function extractLinkedName(row) {
+    const match = row.match(/\[([^\]]+)\]\([^)]+\)/);
+    return match?.[1] ?? null;
+}
+function isDataPageName(name) {
+    return name.startsWith("data/") && name.endsWith(".md");
+}
+function indexIdFromName(name) {
+    return crypto.createHash("sha1").update(name, "utf8").digest("hex").slice(0, 8);
+}
+function migrateLegacyRows(lines, startIdx) {
+    for (let i = startIdx; i < lines.length; i += 1) {
+        const line = lines[i].trim();
+        if (!line.startsWith("|"))
+            break;
+        if (line.startsWith("|---"))
+            continue;
+        const cells = splitRowCells(line);
+        if (cells.length !== 3)
+            continue;
+        const pageCell = cells[0];
+        const nameMatch = pageCell.match(/\[([^\]]+)\]\([^)]+\)/);
+        if (!nameMatch)
+            continue;
+        const name = nameMatch[1];
+        const id = indexIdFromName(name);
+        lines[i] = `| ${id} | ${cells[0]} | ${cells[1]} | ${cells[2]} |`;
+    }
+}
+function splitRowCells(row) {
+    return row
+        .replace(/^\|/, "")
+        .replace(/\|$/, "")
+        .split("|")
+        .map((c) => c.trim());
+}
+//# sourceMappingURL=index.js.map

package/dist/wiki/index.js.map

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

package/dist/wiki/ingestPolicy.d.ts

@@ -0,0 +1,18 @@
+export interface RoutingWarning {
+    field: string;
+    message: string;
+}
+interface IngestPolicyInput {
+    name: string;
+    title?: string;
+    tags?: string[];
+    body: string;
+}
+/**
+ * Heuristic policy to nudge multi-file decomposition for rich ingest pages.
+ * Also warns when project-scoped content appears to be missing a project-slug prefix.
+ * This does not block writes, but returns explicit warnings for the caller.
+ */
+export declare function getIngestRoutingWarnings(input: IngestPolicyInput): RoutingWarning[];
+export {};
+//# sourceMappingURL=ingestPolicy.d.ts.map

package/dist/wiki/ingestPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingestPolicy.d.ts","sourceRoot":"","sources":["../../src/wiki/ingestPolicy.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,iBAAiB,GAAG,cAAc,EAAE,CAqEnF"}

package/dist/wiki/ingestPolicy.js

@@ -0,0 +1,64 @@
+/**
+ * Heuristic policy to nudge multi-file decomposition for rich ingest pages.
+ * Also warns when project-scoped content appears to be missing a project-slug prefix.
+ * This does not block writes, but returns explicit warnings for the caller.
+ */
+export function getIngestRoutingWarnings(input) {
+    const warnings = [];
+    // ── Ingest breakdown check ────────────────────────────────────────────────
+    const isDataPath = input.name.startsWith("data/");
+    const tags = (input.tags ?? []).map((t) => t.toLowerCase());
+    const looksLikeIngest = tags.includes("ingest") ||
+        input.title?.toLowerCase().includes("ingest") === true;
+    if (isDataPath && looksLikeIngest) {
+        const body = input.body;
+        const signals = [
+            /^##\s+open\s+loops?/gim,
+            /^##\s+.*actions?/gim,
+            /^##\s+.*decisions?/gim,
+            /^##\s+.*competition/gim,
+            /^##\s+.*arc/gim,
+            /^##\s+.*technical\s+state/gim,
+        ];
+        const signalCount = signals.reduce((acc, rx) => acc + (rx.test(body) ? 1 : 0), 0);
+        if (signalCount >= 2) {
+            warnings.push({
+                field: "routing",
+                message: "INGEST_BREAKDOWN_RECOMMENDED: This data/ ingest appears to contain canonical facts, active actions, and/or decisions. Decompose into multiple pages: canonical/<topic>-profile.md, projects/<topic>-plan.md, decisions/<date>-<topic>-*.md, and keep data/<topic>.md as raw synthesis.",
+            });
+        }
+    }
+    // ── Project prefix check ──────────────────────────────────────────────────
+    // Warn if a page looks project-specific but is placed at the root of a folder
+    // rather than under a project-slug subfolder (e.g. projects/readme.md instead
+    // of projects/oio-racing/readme.md).
+    // canonical/ is intentionally excluded: it is a user-level folder for durable
+    // cross-project facts, so root-level pages (e.g. canonical/sammy.md) are valid
+    // and must not trigger a project-slug namespacing warning.
+    const projectFolderPrefixes = ["projects/", "data/", "decisions/", "history/"];
+    const nameInProjectFolder = projectFolderPrefixes.some((p) => input.name.startsWith(p));
+    const isActiveFile = /^projects\/active-[^/]+\.md$/.test(input.name);
+    const isBrainLevelFile = input.name.indexOf("/") === -1 ||
+        /^(instructions|wiki)\//.test(input.name);
+    if (nameInProjectFolder && !isActiveFile && !isBrainLevelFile) {
+        // Check if there is at least one slug-level subfolder after the root folder
+        // e.g. "projects/oio-racing/readme.md" → segments after root: ["oio-racing", "readme.md"] ✓
+        //      "projects/readme.md"            → segments after root: ["readme.md"] ✗
+        const parts = input.name.split("/");
+        const hasSlugSubfolder = parts.length >= 3;
+        // readme.md files at any folder root are legitimate scaffolding/index pages;
+        // suppress the warning for e.g. canonical/readme.md, decisions/readme.md, etc.
+        const isFolderReadme = parts.length === 2 && parts[1].toLowerCase() === "readme.md";
+        if (!hasSlugSubfolder && !isFolderReadme) {
+            warnings.push({
+                field: "routing",
+                message: "PROJECT_PREFIX_MISSING: This page appears at the root of a project folder. " +
+                    "If it belongs to a specific project, move it under a project-slug subfolder " +
+                    "(e.g. projects/<slug>/, canonical/<slug>/, decisions/<slug>/). " +
+                    "See instructions/brain-routing.md for the full namespacing convention.",
+            });
+        }
+    }
+    return warnings;
+}
+//# sourceMappingURL=ingestPolicy.js.map

package/dist/wiki/ingestPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingestPolicy.js","sourceRoot":"","sources":["../../src/wiki/ingestPolicy.ts"],"names":[],"mappings":"AAYA;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAwB;IAC/D,MAAM,QAAQ,GAAqB,EAAE,CAAC;IAEtC,6EAA6E;IAC7E,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAC5D,MAAM,eAAe,GACnB,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACvB,KAAK,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;IAEzD,IAAI,UAAU,IAAI,eAAe,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACxB,MAAM,OAAO,GAAG;YACd,wBAAwB;YACxB,qBAAqB;YACrB,uBAAuB;YACvB,wBAAwB;YACxB,gBAAgB;YAChB,8BAA8B;SAC/B,CAAC;QAEF,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAClF,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;YACrB,QAAQ,CAAC,IAAI,CAAC;gBACZ,KAAK,EAAE,SAAS;gBAChB,OAAO,EACL,wRAAwR;aAC3R,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,8EAA8E;IAC9E,8EAA8E;IAC9E,qCAAqC;IACrC,8EAA8E;IAC9E,+EAA+E;IAC/E,2DAA2D;IAC3D,MAAM,qBAAqB,GAAG,CAAC,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;IAC/E,MAAM,mBAAmB,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACxF,MAAM,YAAY,GAAG,8BAA8B,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrE,MAAM,gBAAgB,GACpB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC9B,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE5C,IAAI,mBAAmB,IAAI,CAAC,YAAY,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC9D,4EAA4E;QAC5E,4FAA4F;QAC5F,8EAA8E;QAC9E,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,gBAAgB,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;QAE3C,6EAA6E;QAC7E,+EAA+E;QAC/E,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,WAAW,CAAC;QAEpF,IAAI,CAAC,gBAAgB,IAAI,CAAC,cAAc,EAAE,CAAC;YACzC,QAAQ,CAAC,IAAI,CAAC;gBACZ,KAAK,EAAE,SAAS;gBAChB,OAAO,EACL,6EAA6E;oBAC7E,8EAA8E;oBAC9E,iEAAiE;oBACjE,wEAAwE;aAC3E,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}