@rubytech/create-maxy-code 0.1.0

package/payload/platform/plugins/memory/mcp/dist/lib/schema-loader.js

@@ -0,0 +1,455 @@
+/**
+ * Schema loader — parses every `platform/plugins/memory/references/schema-*.md`
+ * file at server startup and returns a structured LoadedSchema that the
+ * validator consults on every write.
+ *
+ * Design decisions (see Task 197):
+ *
+ * - Header-keyed table parsing. The base schema has 5 columns
+ *   (Entity | Neo4j Label | Schema.org Type | Interchange Standard |
+ *   Required Properties) while vertical schemas have 4 columns (no
+ *   Interchange Standard). We resolve "Neo4j Label" and "Required Properties"
+ *   by header name, never by index.
+ *
+ * - Parenthetical annotations in the Required Properties column are type /
+ *   enum / policy hints, not property names:
+ *       customer (id)                 -> "customer"
+ *       listingType (sale/let)        -> "listingType"
+ *       status (scope must be `admin`) -> "status"
+ *   We strip the first `(...)` suffix and its contents from every comma-split
+ *   token before emitting the property name.
+ *
+ * - Disjunctions in the Required Properties column use the literal word `or`:
+ *       `email` or `telephone`        -> ["email", "telephone"] (any-of)
+ *   We split on `\s+or\s+` per token (not per cell) so that a row like
+ *   "accountId, email or telephone" yields two groups: one simple, one any-of.
+ *
+ * - Inheritance sentinel. estate-agent's Applicant and hospitality's
+ *   GuestProfile use the literal phrase "Base Person properties + …" in the
+ *   required-properties column. A second pass resolves these by merging the
+ *   referenced parent label's groups.
+ *
+ * - Property naming rules (schema-base.md only). The `| Correct | Wrong |`
+ *   table yields a `wrongToCorrect` map. Rows whose wrong-column contains
+ *   "(on" are context-dependent (e.g. `status` is wrong on Order but valid
+ *   on Task/Lead) and are skipped to avoid false positives. A future
+ *   per-label synonym system could reintroduce them.
+ *
+ * Failures throw. A memory server running with a half-parsed schema is
+ * worse than one that fails to start.
+ */
+import { readFileSync, readdirSync } from "node:fs";
+import { resolve } from "node:path";
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function stripBackticks(token) {
+    return token.replace(/`/g, "").trim();
+}
+/**
+ * Strip the first parenthetical suffix and its contents from a token.
+ * Handles nested/balanced parens conservatively by just cutting at the first `(`.
+ *
+ *   "customer (id)"            -> "customer"
+ *   "status (scope must be `admin`)" -> "status"
+ *   "name (question text)"     -> "name"
+ *   "email"                    -> "email"
+ */
+function stripParentheticalHint(token) {
+    const parenIdx = token.indexOf("(");
+    if (parenIdx === -1)
+        return token.trim();
+    return token.slice(0, parenIdx).trim();
+}
+/**
+ * Normalise a raw required-property token to a canonical property name.
+ * Strips backticks, parenthetical hints, leading/trailing whitespace.
+ */
+function normalisePropName(raw) {
+    return stripParentheticalHint(stripBackticks(raw));
+}
+/**
+ * Parse one comma-separated token from the Required Properties cell into a
+ * RequiredGroup. The token may be a simple name or a "X or Y" disjunction.
+ */
+function parseRequiredToken(token) {
+    const trimmed = token.trim();
+    if (!trimmed || trimmed === "—" || trimmed === "-")
+        return null;
+    // Detect disjunction: split on the literal word `or` surrounded by whitespace.
+    // We check the RAW token (not post-strip) because backticks and parens may
+    // surround the disjuncts: "`email` or `telephone`".
+    const orParts = trimmed.split(/\s+or\s+/);
+    if (orParts.length > 1) {
+        const names = orParts
+            .map((p) => normalisePropName(p))
+            .filter((n) => n.length > 0);
+        if (names.length === 0)
+            return null;
+        if (names.length === 1)
+            return { kind: "simple", name: names[0] };
+        return { kind: "any-of", names };
+    }
+    const name = normalisePropName(trimmed);
+    if (!name)
+        return null;
+    return { kind: "simple", name };
+}
+/**
+ * Split a Required Properties cell on commas, but only on commas that are
+ * NOT inside a `(...)` parenthetical hint. Walks the string tracking paren
+ * depth. Essential for rows like
+ *
+ *     `accountId`, `type` (gas safe, NICEIC, etc.), `issuedDate`
+ *
+ * where a naive `trimmed.split(",")` would shred the hint's internal commas
+ * into bogus top-level tokens (`NICEIC`, `etc.)`) and produce unsatisfiable
+ * required-property rules.
+ *
+ * Nested parens are supported defensively (depth counter, not a boolean),
+ * though current schemas don't use them.
+ */
+function splitTopLevelCommas(cell) {
+    const tokens = [];
+    let depth = 0;
+    let start = 0;
+    for (let i = 0; i < cell.length; i++) {
+        const ch = cell[i];
+        if (ch === "(") {
+            depth++;
+        }
+        else if (ch === ")") {
+            if (depth > 0)
+                depth--;
+        }
+        else if (ch === "," && depth === 0) {
+            tokens.push(cell.slice(start, i));
+            start = i + 1;
+        }
+    }
+    tokens.push(cell.slice(start));
+    return tokens;
+}
+/**
+ * Parse a full Required Properties cell into an ordered list of groups.
+ * A cell like
+ *
+ *     `accountId`, `givenName`, `familyName`, `email` or `telephone`
+ *
+ * yields four groups: three simple + one any-of.
+ *
+ * Returns `{ groups: [], inheritsFrom: "Person" }` for the sentinel form
+ * "Base Person properties + budget, tenure, …" so the second pass can resolve it.
+ */
+function parseRequiredCell(cell) {
+    const trimmed = cell.trim();
+    if (!trimmed || trimmed === "—" || trimmed === "-") {
+        return { groups: [], extras: [] };
+    }
+    // Inheritance sentinel. Accept "Base X properties + extras…" in any case.
+    // The extras list is split with paren-awareness too, in case a future
+    // inheritance row includes a hint like "Base Person properties + tier (bronze, silver, gold)".
+    const inheritMatch = trimmed.match(/^Base\s+(\w+)\s+properties\s*\+\s*(.*)$/i);
+    if (inheritMatch) {
+        const parentLabel = inheritMatch[1];
+        const extrasText = inheritMatch[2];
+        const extras = [];
+        for (const token of splitTopLevelCommas(extrasText)) {
+            const group = parseRequiredToken(token);
+            if (group)
+                extras.push(group);
+        }
+        return { groups: [], inheritsFrom: parentLabel, extras };
+    }
+    // Regular comma-separated list — paren-aware so hint commas like
+    // `(gas safe, NICEIC, etc.)` don't fragment the token stream.
+    const groups = [];
+    for (const token of splitTopLevelCommas(trimmed)) {
+        const group = parseRequiredToken(token);
+        if (group)
+            groups.push(group);
+    }
+    return { groups, extras: [] };
+}
+/**
+ * Find every markdown pipe-table in a file's content. Returns tables in the
+ * order they appear. A table is recognised by a header row followed by a
+ * separator row of dashes.
+ */
+function findTables(content) {
+    const lines = content.split(/\r?\n/);
+    const tables = [];
+    for (let i = 0; i < lines.length - 1; i++) {
+        const headerLine = lines[i];
+        const sepLine = lines[i + 1];
+        // A pipe table header has `|` on at least one side; the separator line
+        // below consists of `|`, `-`, `:` and whitespace only.
+        if (!headerLine.includes("|"))
+            continue;
+        if (!/^\s*\|?[\s:|-]+\|?\s*$/.test(sepLine))
+            continue;
+        if (!sepLine.includes("-"))
+            continue;
+        const headers = splitPipeRow(headerLine);
+        // Sanity: header row must have at least two cells.
+        if (headers.length < 2)
+            continue;
+        const rows = [];
+        let j = i + 2;
+        while (j < lines.length) {
+            const row = lines[j];
+            if (!row.trim() || !row.includes("|"))
+                break;
+            const cells = splitPipeRow(row);
+            // Skip malformed rows that don't match header width — loudly.
+            if (cells.length !== headers.length) {
+                throw new Error(`schema-loader: table row on line ${j + 1} has ${cells.length} cells but header has ${headers.length}: ${row}`);
+            }
+            rows.push(cells);
+            j++;
+        }
+        tables.push({ headers, rows });
+        i = j - 1;
+    }
+    return tables;
+}
+/**
+ * Split a pipe-delimited markdown row into cells, stripping the optional
+ * leading/trailing pipes. `|` characters inside a backtick code-span (e.g.
+ * `` `Person|Organization` ``) are treated as literal content and do not
+ * split the row — without this, a single union-typed cell would shred into
+ * multiple cells and the `findTables` width check would throw at module load
+ * (Task 743). Backtick toggling is single-tick only; nested or escaped
+ * backticks are out of scope (no schema doc uses them today).
+ */
+export function splitPipeRow(row) {
+    let trimmed = row.trim();
+    if (trimmed.startsWith("|"))
+        trimmed = trimmed.slice(1);
+    if (trimmed.endsWith("|"))
+        trimmed = trimmed.slice(0, -1);
+    const cells = [];
+    let inBacktick = false;
+    let start = 0;
+    for (let i = 0; i < trimmed.length; i++) {
+        const ch = trimmed[i];
+        if (ch === "`") {
+            inBacktick = !inBacktick;
+        }
+        else if (ch === "|" && !inBacktick) {
+            cells.push(trimmed.slice(start, i).trim());
+            start = i + 1;
+        }
+    }
+    cells.push(trimmed.slice(start).trim());
+    return cells;
+}
+function findColumnIndex(headers, name) {
+    return headers.findIndex((h) => h.toLowerCase() === name.toLowerCase());
+}
+function parseEntityTables(tables, sourceFile) {
+    const labels = [];
+    for (const table of tables) {
+        const labelCol = findColumnIndex(table.headers, "Neo4j Label");
+        const requiredCol = findColumnIndex(table.headers, "Required Properties");
+        if (labelCol === -1 || requiredCol === -1)
+            continue; // not an entity table
+        for (const row of table.rows) {
+            const labelCell = row[labelCol];
+            const requiredCell = row[requiredCol];
+            const label = stripBackticks(labelCell);
+            if (!label)
+                continue;
+            const parsed = parseRequiredCell(requiredCell);
+            const definition = {
+                label,
+                required: [...parsed.groups, ...parsed.extras],
+                sourceFile,
+            };
+            if (parsed.inheritsFrom) {
+                definition.inheritsFrom = parsed.inheritsFrom;
+            }
+            labels.push(definition);
+        }
+    }
+    return labels;
+}
+function parseNamingRulesTable(tables, sourceFile) {
+    const entries = [];
+    for (const table of tables) {
+        const correctCol = findColumnIndex(table.headers, "Correct");
+        const wrongCol = findColumnIndex(table.headers, "Wrong");
+        if (correctCol === -1 || wrongCol === -1)
+            continue;
+        for (const row of table.rows) {
+            const correctCell = row[correctCol].trim();
+            const wrongCell = row[wrongCol].trim();
+            // Context-dependent rows ("status (on Order nodes)") are skipped —
+            // `status` is valid elsewhere, so a global mapping would false-reject.
+            if (wrongCell.includes("(on "))
+                continue;
+            // For error messaging, preserve the literal correct cell (including
+            // slashes like "startDate / endDate"). This is human-readable and not
+            // misleading when one wrong token maps to multiple correct options.
+            const correctLabel = stripBackticks(correctCell);
+            for (const token of wrongCell.split(",")) {
+                const wrong = stripBackticks(token);
+                if (!wrong)
+                    continue;
+                entries.push([
+                    wrong,
+                    { correct: correctLabel, sourceFile },
+                ]);
+            }
+        }
+    }
+    return entries;
+}
+function parseForbiddenPropertiesTable(tables, sourceFile) {
+    const entries = [];
+    for (const table of tables) {
+        const labelCol = findColumnIndex(table.headers, "Label");
+        const propertyCol = findColumnIndex(table.headers, "Property");
+        const rationaleCol = findColumnIndex(table.headers, "Rationale");
+        // Three-column shape uniquely identifies the Forbidden Properties table.
+        // The Naming Rules table has Correct/Wrong; the Entity tables have
+        // Neo4j Label / Required Properties — neither overlaps these three names.
+        if (labelCol === -1 || propertyCol === -1 || rationaleCol === -1)
+            continue;
+        for (const row of table.rows) {
+            const label = stripBackticks(row[labelCol]);
+            const property = stripBackticks(row[propertyCol]);
+            const rationale = row[rationaleCol].trim();
+            if (!label || !property)
+                continue;
+            entries.push([label, property, { rationale, sourceFile }]);
+        }
+    }
+    return entries;
+}
+function parseFile(path, fileName) {
+    const content = readFileSync(path, "utf-8");
+    const tables = findTables(content);
+    const labels = parseEntityTables(tables, fileName);
+    // Naming rules live only in schema-base.md today; parsing every file is
+    // cheap and would pick up rules added to other files later without new code.
+    const wrongToCorrect = parseNamingRulesTable(tables, fileName);
+    const forbidden = parseForbiddenPropertiesTable(tables, fileName);
+    return { labels, wrongToCorrect, forbidden };
+}
+// ---------------------------------------------------------------------------
+// Second pass: resolve "Base X properties + extras" inheritance
+// ---------------------------------------------------------------------------
+function resolveInheritance(labelMap) {
+    for (const def of labelMap.values()) {
+        if (!def.inheritsFrom)
+            continue;
+        const parent = labelMap.get(def.inheritsFrom);
+        if (!parent) {
+            throw new Error(`schema-loader: label '${def.label}' (${def.sourceFile}) inherits from '${def.inheritsFrom}' but that label is not defined in any loaded schema file`);
+        }
+        // Merge: parent's required groups first, then this label's extras.
+        // Duplicates are possible but harmless — the validator treats each group
+        // independently. We de-dupe simple names to keep error messages clean.
+        const merged = [];
+        const seenSimple = new Set();
+        const push = (g) => {
+            if (g.kind === "simple") {
+                if (seenSimple.has(g.name))
+                    return;
+                seenSimple.add(g.name);
+            }
+            merged.push(g);
+        };
+        for (const g of parent.required)
+            push(g);
+        for (const g of def.required)
+            push(g);
+        def.required = merged;
+        delete def.inheritsFrom;
+    }
+}
+// ---------------------------------------------------------------------------
+// Entry point
+// ---------------------------------------------------------------------------
+/**
+ * Load every `schema-*.md` file from the memory plugin's references directory.
+ *
+ * The directory is resolved relative to this source file, matching the
+ * pattern used by neo4j.ts for config paths. Both src/ and dist/ locations
+ * end up four hops above the references directory
+ * (src/lib/schema-loader.ts -> src/ -> mcp/ -> memory/ -> references/).
+ */
+export function loadSchema() {
+    const referencesDir = resolve(import.meta.dirname, "../../../references");
+    let fileNames;
+    try {
+        fileNames = readdirSync(referencesDir).filter((f) => f.startsWith("schema-") && f.endsWith(".md"));
+    }
+    catch (err) {
+        throw new Error(`schema-loader: could not read references directory at ${referencesDir}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    if (fileNames.length === 0) {
+        throw new Error(`schema-loader: no schema-*.md files found in ${referencesDir}`);
+    }
+    // Sort for deterministic load order — schema-base.md should load first so
+    // inheritance targets are present, but the resolver does a second pass so
+    // file order doesn't affect correctness.
+    fileNames.sort();
+    const sourceFiles = [];
+    const labelMap = new Map();
+    const wrongToCorrect = new Map();
+    const forbiddenByLabel = new Map();
+    for (const fileName of fileNames) {
+        const fullPath = resolve(referencesDir, fileName);
+        sourceFiles.push(fullPath);
+        const parsed = parseFile(fullPath, fileName);
+        for (const def of parsed.labels) {
+            if (labelMap.has(def.label)) {
+                // Two files defining the same label is allowed only if the later
+                // file is a vertical extending a base type. We keep the first
+                // (base) definition and ignore the later one; the per-vertical
+                // properties on the vertical-specific label should be documented
+                // on that vertical label, not on the shared one.
+                continue;
+            }
+            labelMap.set(def.label, def);
+        }
+        for (const [wrong, info] of parsed.wrongToCorrect) {
+            if (wrongToCorrect.has(wrong))
+                continue; // first file wins
+            wrongToCorrect.set(wrong, info);
+        }
+        for (const [label, property, info] of parsed.forbidden) {
+            let perLabel = forbiddenByLabel.get(label);
+            if (!perLabel) {
+                perLabel = new Map();
+                forbiddenByLabel.set(label, perLabel);
+            }
+            if (perLabel.has(property))
+                continue; // first file wins
+            perLabel.set(property, info);
+        }
+    }
+    resolveInheritance(labelMap);
+    // Stderr log: satisfies the project's "Observability Is Non-Negotiable"
+    // principle — operators can confirm from server.log alone which schemas
+    // are live and how many labels are documented. The wording shifted in
+    // Task 736: this number is now the count of *documented* labels (those
+    // with required-property groups), not the count of *recognised* labels
+    // (which is the live ∪ declared union resolved by LiveSchemaSource).
+    const labelCount = labelMap.size;
+    const synonymCount = wrongToCorrect.size;
+    let forbiddenCount = 0;
+    for (const perLabel of forbiddenByLabel.values()) {
+        forbiddenCount += perLabel.size;
+    }
+    process.stderr.write(`[schema-loader] loaded ${labelCount} documented labels, ${synonymCount} naming-rule synonyms, and ${forbiddenCount} forbidden-property rules from ${fileNames.length} files: ${fileNames.join(", ")}\n`);
+    return {
+        markdownLabels: labelMap,
+        wrongToCorrect,
+        forbiddenByLabel,
+        sourceFiles,
+    };
+}
+//# sourceMappingURL=schema-loader.js.map

package/payload/platform/plugins/memory/mcp/dist/lib/schema-loader.js.map

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

package/payload/platform/plugins/memory/mcp/dist/lib/schema-validator.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Schema validator — validates memory-write inputs against two sources of
+ * truth (Task 736):
+ *
+ *   1. `LiveSchemaSource` — recognised-label set = `db.labels()` snapshot
+ *      ∪ `schema.cypher` constraint/index declarations. This is the gate.
+ *      A label is recognised iff it appears in either set.
+ *   2. `LoadedSchema` (markdown sidecar) — required-property and naming-rule
+ *      metadata for documented labels. Markdown is no longer a label-existence
+ *      gate; required-property checks are skipped (with a log line) when the
+ *      label is recognised by the live source but absent from markdown.
+ *
+ * Checks run in order; first failure throws with a descriptive message.
+ *
+ *   1. accountId            — non-empty trimmed string
+ *   2. label existence      — at least one input label is in live ∪ declared.
+ *                             Rejection cites both sources and the nearest
+ *                             documented match (Levenshtein) when there is one
+ *   3. property synonym     — no property key is a known wrong-name alias.
+ *                             Runs before required-props so a `firstName`
+ *                             typo is reported as "rename firstName →
+ *                             givenName" rather than "missing givenName"
+ *   3b. forbidden property  — Task 849. Per-label deny-list parsed from the
+ *                             "Forbidden Properties" table in schema markdown.
+ *                             Fires AFTER the synonym pass so `firstName`
+ *                             still rewrites to `givenName` rather than
+ *                             rejecting on the wrong rule. First row:
+ *                             `Person | name`, eliminating the divergence
+ *                             trap where `name` truncated to `givenName`
+ *                             ("Dan") while the canonical pair held the full
+ *                             identity ("Dan Brett")
+ *   4. required properties  — for the primary label, fires only when the
+ *                             label is documented in markdown. Skipped (with
+ *                             a structured log line) when the label is
+ *                             recognised but undocumented — that's a
+ *                             stale-doc signal, not a write error
+ *
+ * The `[schema-validator]` log lines are the single observability surface.
+ * Operators reading server.log can distinguish "validation didn't run" from
+ * "validation passed" from "validation rejected" without source access.
+ *
+ * "Present" semantics for required-property values: defined, not null, and
+ * not a whitespace-only string. Numeric `0`, boolean `false`, and empty
+ * arrays count as present — the agent may legitimately persist those.
+ */
+import type { LoadedSchema } from "./schema-loader.js";
+import type { LiveSchemaSource } from "./live-schema-source.js";
+export interface ValidateWriteInput {
+    labels: string[];
+    properties: Record<string, unknown>;
+    accountId?: string;
+}
+export interface ValidatorEnv {
+    /** Markdown sidecar — required-property + synonym metadata. */
+    schema: LoadedSchema;
+    /** Live ∪ declared label source — gates label existence. */
+    liveSource: LiveSchemaSource;
+    /** Test-injectable log emitter. Default: process.stderr. */
+    emit?: (line: string) => void;
+}
+export interface ValidateWriteOptions {
+    /**
+     * `"create"` (default) — full validation: synonym pass, forbidden-property
+     * pass, required-property pass.
+     * `"update"` — partial-update mode (Task 893). Skips the required-property
+     * loop only; synonym + forbidden checks still fire. Use when SETting
+     * additional properties on a node that already passed required-props at
+     * create time (the canonical case is `profile-update.personFields`
+     * adding identity fields to a personal-profile Person whose
+     * givenName/familyName were written at PIN setup). The accept path emits
+     * `[schema-validator] check label=<X> mode=update …` so partial writes
+     * are forensically distinguishable from full writes.
+     */
+    mode?: "create" | "update";
+}
+/**
+ * Validate a write. Throws on the first violation. Caller is responsible
+ * for logging the thrown error in addition to the structured outcome lines
+ * this function emits — this stays a (mostly) pure unit so test fixtures
+ * can capture both the throw path and the emit stream.
+ */
+export declare function validateWrite(input: ValidateWriteInput, env: ValidatorEnv, options?: ValidateWriteOptions): void;
+//# sourceMappingURL=schema-validator.d.ts.map

package/payload/platform/plugins/memory/mcp/dist/lib/schema-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validator.d.ts","sourceRoot":"","sources":["../../src/lib/schema-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,oBAAoB,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,+DAA+D;IAC/D,MAAM,EAAE,YAAY,CAAC;IACrB,4DAA4D;IAC5D,UAAU,EAAE,gBAAgB,CAAC;IAC7B,4DAA4D;IAC5D,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC5B;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,kBAAkB,EACzB,GAAG,EAAE,YAAY,EACjB,OAAO,GAAE,oBAAyB,GACjC,IAAI,CAmJN"}