@rubytech/create-realagent 1.0.705 → 1.0.706

package/payload/platform/plugins/memory/mcp/dist/lib/__tests__/schema-validator.test.js

@@ -0,0 +1,222 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import { validateWrite } from "../schema-validator.js";
+// ---------------------------------------------------------------------------
+// Fixture builders. These avoid hitting the real schema-*.md files so the
+// validator's behaviour can be asserted independently of the markdown
+// contents. The shape is byte-identical to what loadSchema() produces.
+// ---------------------------------------------------------------------------
+function makeSchema(opts) {
+    const markdownLabels = new Map();
+    for (const entry of opts.documented ?? []) {
+        markdownLabels.set(entry.label, {
+            label: entry.label,
+            required: entry.required,
+            sourceFile: entry.sourceFile ?? "schema-test.md",
+        });
+    }
+    const wrongToCorrect = new Map();
+    for (const [wrong, correct] of opts.synonyms ?? []) {
+        wrongToCorrect.set(wrong, { correct, sourceFile: "schema-test.md" });
+    }
+    return { markdownLabels, wrongToCorrect, sourceFiles: ["schema-test.md"] };
+}
+function makeLiveSource(opts) {
+    const live = new Set(opts.live);
+    const declared = new Set(opts.declared);
+    return {
+        recognisedLabels: () => new Set([...live, ...declared]),
+        liveLabels: () => new Set(live),
+        declaredLabels: () => new Set(declared),
+        liveReady: () => true,
+    };
+}
+function captureEmits() {
+    const lines = [];
+    return { lines, emit: (line) => lines.push(line) };
+}
+// ---------------------------------------------------------------------------
+// (a) Live label not in markdown → accept, log markdown-skip
+// ---------------------------------------------------------------------------
+test("(a) live-only label, markdown-undocumented → accepted with markdown-undocumented log", () => {
+    // KnowledgeDocument is in db.labels() but has no markdown row.
+    const schema = makeSchema({});
+    const liveSource = makeLiveSource({
+        live: ["KnowledgeDocument", "Person"],
+        declared: [],
+    });
+    const { lines, emit } = captureEmits();
+    validateWrite({
+        labels: ["KnowledgeDocument"],
+        properties: { title: "x" },
+        accountId: "acct-1",
+    }, { schema, liveSource, emit });
+    const accepted = lines.find((l) => l.includes("outcome=accepted"));
+    assert.ok(accepted, `expected accepted log, got: ${lines.join(" | ")}`);
+    assert.match(accepted, /source=live/);
+    const skip = lines.find((l) => l.includes("markdown-undocumented"));
+    assert.ok(skip, `expected markdown-undocumented log, got: ${lines.join(" | ")}`);
+    assert.match(skip, /label=KnowledgeDocument/);
+});
+// ---------------------------------------------------------------------------
+// (b) Declared-but-not-live (fresh-install bootstrap) → accept
+// ---------------------------------------------------------------------------
+test("(b) declared-but-not-live LocalBusiness → accepted (bootstrap regression)", () => {
+    // The exact incident: fresh install, db.labels()=[AdminUser], schema.cypher
+    // declares LocalBusiness, agent writes LocalBusiness — must succeed.
+    const schema = makeSchema({});
+    const liveSource = makeLiveSource({
+        live: ["AdminUser"],
+        declared: ["AdminUser", "LocalBusiness", "Person"],
+    });
+    const { lines, emit } = captureEmits();
+    validateWrite({
+        labels: ["LocalBusiness"],
+        properties: { name: "Acme Plumbing" },
+        accountId: "acct-1",
+    }, { schema, liveSource, emit });
+    const accepted = lines.find((l) => l.includes("outcome=accepted"));
+    assert.ok(accepted);
+    assert.match(accepted, /source=declared/);
+});
+// ---------------------------------------------------------------------------
+// (c) Label absent from both → reject with structured error
+// ---------------------------------------------------------------------------
+test("(c) label absent from live and declared → reject with structured error", () => {
+    const schema = makeSchema({});
+    const liveSource = makeLiveSource({
+        live: ["Person", "LocalBusiness"],
+        declared: ["Person", "LocalBusiness", "AdminUser"],
+    });
+    const { lines, emit } = captureEmits();
+    assert.throws(() => validateWrite({
+        labels: ["Quokka"],
+        properties: {},
+        accountId: "acct-1",
+    }, { schema, liveSource, emit }), (err) => {
+        assert.match(err.message, /unknown Neo4j label/);
+        assert.match(err.message, /\[Quokka\]/);
+        assert.match(err.message, /Live db\.labels\(\): \[/);
+        assert.match(err.message, /Declared in schema\.cypher: \[/);
+        // Both source lists must include something so operators can grep.
+        assert.match(err.message, /Person/);
+        return true;
+    });
+    const rejected = lines.find((l) => l.includes("outcome=rejected"));
+    assert.ok(rejected);
+    assert.match(rejected, /source=neither/);
+});
+test("(c) typo gets Levenshtein 'did you mean?' suggestion", () => {
+    const schema = makeSchema({});
+    const liveSource = makeLiveSource({
+        live: ["Person", "LocalBusiness"],
+        declared: ["Person", "LocalBusiness"],
+    });
+    assert.throws(() => validateWrite(
+    // capital-I-as-l typo per the incident's exact failure mode
+    {
+        labels: ["LocaIBusiness"],
+        properties: {},
+        accountId: "acct-1",
+    }, { schema, liveSource }), (err) => {
+        assert.match(err.message, /Did you mean 'LocalBusiness'\?/);
+        return true;
+    });
+});
+// ---------------------------------------------------------------------------
+// (d) Required-property check fires only when label is documented
+// ---------------------------------------------------------------------------
+test("(d) required-property check runs for markdown-documented labels", () => {
+    const schema = makeSchema({
+        documented: [
+            {
+                label: "Person",
+                required: [{ kind: "simple", name: "givenName" }],
+            },
+        ],
+    });
+    const liveSource = makeLiveSource({
+        live: ["Person"],
+        declared: ["Person"],
+    });
+    assert.throws(() => validateWrite({
+        labels: ["Person"],
+        properties: { familyName: "Smith" }, // missing givenName
+        accountId: "acct-1",
+    }, { schema, liveSource }), /missing required property 'givenName' for label Person/);
+});
+test("(d) required-property check is SKIPPED for markdown-undocumented labels", () => {
+    // LocalBusiness is recognised (declared) but has no markdown row.
+    // Requiring properties that aren't documented would be impossible to
+    // express; the validator must accept the write.
+    const schema = makeSchema({});
+    const liveSource = makeLiveSource({
+        live: [],
+        declared: ["LocalBusiness"],
+    });
+    // No throw expected — properties are agent's responsibility for
+    // markdown-undocumented labels.
+    validateWrite({
+        labels: ["LocalBusiness"],
+        properties: {}, // intentionally empty
+        accountId: "acct-1",
+    }, { schema, liveSource });
+});
+// ---------------------------------------------------------------------------
+// (f) Synonym layer (wrongToCorrect) still rejects when triggered
+// ---------------------------------------------------------------------------
+test("(f) wrongToCorrect synonym still rejects firstName→givenName even on documented label", () => {
+    const schema = makeSchema({
+        documented: [
+            {
+                label: "Person",
+                required: [{ kind: "simple", name: "givenName" }],
+            },
+        ],
+        synonyms: [["firstName", "givenName"]],
+    });
+    const liveSource = makeLiveSource({
+        live: ["Person"],
+        declared: ["Person"],
+    });
+    assert.throws(() => validateWrite({
+        labels: ["Person"],
+        properties: { firstName: "Jane" },
+        accountId: "acct-1",
+    }, { schema, liveSource }), /property name 'firstName' is not Schema.org — use 'givenName'/);
+});
+test("(f) synonym layer also rejects on markdown-undocumented labels", () => {
+    // The synonym map is independent of label — firstName is wrong everywhere.
+    const schema = makeSchema({
+        synonyms: [["firstName", "givenName"]],
+    });
+    const liveSource = makeLiveSource({
+        live: ["LocalBusiness"],
+        declared: ["LocalBusiness"],
+    });
+    assert.throws(() => validateWrite({
+        labels: ["LocalBusiness"],
+        properties: { firstName: "x" },
+        accountId: "acct-1",
+    }, { schema, liveSource }), /property name 'firstName' is not Schema.org — use 'givenName'/);
+});
+// ---------------------------------------------------------------------------
+// accountId boundary
+// ---------------------------------------------------------------------------
+test("rejects missing accountId before consulting live source", () => {
+    const schema = makeSchema({});
+    const liveSource = makeLiveSource({
+        live: ["Person"],
+        declared: ["Person"],
+    });
+    assert.throws(() => validateWrite({ labels: ["Person"], properties: {} }, { schema, liveSource }), /accountId is required/);
+});
+test("rejects empty labels[] before consulting live source", () => {
+    const schema = makeSchema({});
+    const liveSource = makeLiveSource({
+        live: ["Person"],
+        declared: ["Person"],
+    });
+    assert.throws(() => validateWrite({ labels: [], properties: {}, accountId: "acct-1" }, { schema, liveSource }), /labels is required/);
+});
+//# sourceMappingURL=schema-validator.test.js.map

package/payload/platform/plugins/memory/mcp/dist/lib/__tests__/schema-validator.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validator.test.js","sourceRoot":"","sources":["../../../src/lib/__tests__/schema-validator.test.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAQvD,8EAA8E;AAC9E,0EAA0E;AAC1E,sEAAsE;AACtE,uEAAuE;AACvE,8EAA8E;AAE9E,SAAS,UAAU,CAAC,IAOnB;IACC,MAAM,cAAc,GAAG,IAAI,GAAG,EAA2B,CAAC;IAC1D,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC;QAC1C,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE;YAC9B,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,gBAAgB;SACjD,CAAC,CAAC;IACL,CAAC;IACD,MAAM,cAAc,GAAG,IAAI,GAAG,EAG3B,CAAC;IACJ,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QACnD,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC,gBAAgB,CAAC,EAAE,CAAC;AAC7E,CAAC;AAED,SAAS,cAAc,CAAC,IAGvB;IACC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxC,OAAO;QACL,gBAAgB,EAAE,GAAG,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,QAAQ,CAAC,CAAC;QACvD,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC;QAC/B,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC;QACvC,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI;KACtB,CAAC;AACJ,CAAC;AAOD,SAAS,YAAY;IACnB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACrD,CAAC;AAED,8EAA8E;AAC9E,6DAA6D;AAC7D,8EAA8E;AAE9E,IAAI,CAAC,sFAAsF,EAAE,GAAG,EAAE;IAChG,+DAA+D;IAC/D,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;IAC9B,MAAM,UAAU,GAAG,cAAc,CAAC;QAChC,IAAI,EAAE,CAAC,mBAAmB,EAAE,QAAQ,CAAC;QACrC,QAAQ,EAAE,EAAE;KACb,CAAC,CAAC;IACH,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,YAAY,EAAE,CAAC;IAEvC,aAAa,CACX;QACE,MAAM,EAAE,CAAC,mBAAmB,CAAC;QAC7B,UAAU,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE;QAC1B,SAAS,EAAE,QAAQ;KACpB,EACD,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,CAC7B,CAAC;IAEF,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC;IACnE,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,+BAA+B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACxE,MAAM,CAAC,KAAK,CAAC,QAAS,EAAE,aAAa,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC,CAAC;IACpE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,4CAA4C,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACjF,MAAM,CAAC,KAAK,CAAC,IAAK,EAAE,yBAAyB,CAAC,CAAC;AACjD,CAAC,CAAC,CAAC;AAEH,8EAA8E;AAC9E,+DAA+D;AAC/D,8EAA8E;AAE9E,IAAI,CAAC,2EAA2E,EAAE,GAAG,EAAE;IACrF,4EAA4E;IAC5E,qEAAqE;IACrE,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;IAC9B,MAAM,UAAU,GAAG,cAAc,CAAC;QAChC,IAAI,EAAE,CAAC,WAAW,CAAC;QACnB,QAAQ,EAAE,CAAC,WAAW,EAAE,eAAe,EAAE,QAAQ,CAAC;KACnD,CAAC,CAAC;IACH,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,YAAY,EAAE,CAAC;IAEvC,aAAa,CACX;QACE,MAAM,EAAE,CAAC,eAAe,CAAC;QACzB,UAAU,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE;QACrC,SAAS,EAAE,QAAQ;KACpB,EACD,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,CAC7B,CAAC;IAEF,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC;IACnE,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;IACpB,MAAM,CAAC,KAAK,CAAC,QAAS,EAAE,iBAAiB,CAAC,CAAC;AAC7C,CAAC,CAAC,CAAC;AAEH,8EAA8E;AAC9E,4DAA4D;AAC5D,8EAA8E;AAE9E,IAAI,CAAC,wEAAwE,EAAE,GAAG,EAAE;IAClF,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;IAC9B,MAAM,UAAU,GAAG,cAAc,CAAC;QAChC,IAAI,EAAE,CAAC,QAAQ,EAAE,eAAe,CAAC;QACjC,QAAQ,EAAE,CAAC,QAAQ,EAAE,eAAe,EAAE,WAAW,CAAC;KACnD,CAAC,CAAC;IACH,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,YAAY,EAAE,CAAC;IAEvC,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,CACH,aAAa,CACX;QACE,MAAM,EAAE,CAAC,QAAQ,CAAC;QAClB,UAAU,EAAE,EAAE;QACd,SAAS,EAAE,QAAQ;KACpB,EACD,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,CAC7B,EACH,CAAC,GAAU,EAAE,EAAE;QACb,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;QACjD,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QACxC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,yBAAyB,CAAC,CAAC;QACrD,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,gCAAgC,CAAC,CAAC;QAC5D,kEAAkE;QAClE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC,CACF,CAAC;IAEF,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC;IACnE,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;IACpB,MAAM,CAAC,KAAK,CAAC,QAAS,EAAE,gBAAgB,CAAC,CAAC;AAC5C,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,sDAAsD,EAAE,GAAG,EAAE;IAChE,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;IAC9B,MAAM,UAAU,GAAG,cAAc,CAAC;QAChC,IAAI,EAAE,CAAC,QAAQ,EAAE,eAAe,CAAC;QACjC,QAAQ,EAAE,CAAC,QAAQ,EAAE,eAAe,CAAC;KACtC,CAAC,CAAC;IAEH,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,CACH,aAAa;IACX,4DAA4D;IAC5D;QACE,MAAM,EAAE,CAAC,eAAe,CAAC;QACzB,UAAU,EAAE,EAAE;QACd,SAAS,EAAE,QAAQ;KACpB,EACD,EAAE,MAAM,EAAE,UAAU,EAAE,CACvB,EACH,CAAC,GAAU,EAAE,EAAE;QACb,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,gCAAgC,CAAC,CAAC;QAC5D,OAAO,IAAI,CAAC;IACd,CAAC,CACF,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,8EAA8E;AAC9E,kEAAkE;AAClE,8EAA8E;AAE9E,IAAI,CAAC,iEAAiE,EAAE,GAAG,EAAE;IAC3E,MAAM,MAAM,GAAG,UAAU,CAAC;QACxB,UAAU,EAAE;YACV;gBACE,KAAK,EAAE,QAAQ;gBACf,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;aAClD;SACF;KACF,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,cAAc,CAAC;QAChC,IAAI,EAAE,CAAC,QAAQ,CAAC;QAChB,QAAQ,EAAE,CAAC,QAAQ,CAAC;KACrB,CAAC,CAAC;IAEH,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,CACH,aAAa,CACX;QACE,MAAM,EAAE,CAAC,QAAQ,CAAC;QAClB,UAAU,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,oBAAoB;QACzD,SAAS,EAAE,QAAQ;KACpB,EACD,EAAE,MAAM,EAAE,UAAU,EAAE,CACvB,EACH,wDAAwD,CACzD,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,yEAAyE,EAAE,GAAG,EAAE;IACnF,kEAAkE;IAClE,qEAAqE;IACrE,gDAAgD;IAChD,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;IAC9B,MAAM,UAAU,GAAG,cAAc,CAAC;QAChC,IAAI,EAAE,EAAE;QACR,QAAQ,EAAE,CAAC,eAAe,CAAC;KAC5B,CAAC,CAAC;IAEH,gEAAgE;IAChE,gCAAgC;IAChC,aAAa,CACX;QACE,MAAM,EAAE,CAAC,eAAe,CAAC;QACzB,UAAU,EAAE,EAAE,EAAE,sBAAsB;QACtC,SAAS,EAAE,QAAQ;KACpB,EACD,EAAE,MAAM,EAAE,UAAU,EAAE,CACvB,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,8EAA8E;AAC9E,kEAAkE;AAClE,8EAA8E;AAE9E,IAAI,CAAC,uFAAuF,EAAE,GAAG,EAAE;IACjG,MAAM,MAAM,GAAG,UAAU,CAAC;QACxB,UAAU,EAAE;YACV;gBACE,KAAK,EAAE,QAAQ;gBACf,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;aAClD;SACF;QACD,QAAQ,EAAE,CAAC,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;KACvC,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,cAAc,CAAC;QAChC,IAAI,EAAE,CAAC,QAAQ,CAAC;QAChB,QAAQ,EAAE,CAAC,QAAQ,CAAC;KACrB,CAAC,CAAC;IAEH,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,CACH,aAAa,CACX;QACE,MAAM,EAAE,CAAC,QAAQ,CAAC;QAClB,UAAU,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE;QACjC,SAAS,EAAE,QAAQ;KACpB,EACD,EAAE,MAAM,EAAE,UAAU,EAAE,CACvB,EACH,+DAA+D,CAChE,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,gEAAgE,EAAE,GAAG,EAAE;IAC1E,2EAA2E;IAC3E,MAAM,MAAM,GAAG,UAAU,CAAC;QACxB,QAAQ,EAAE,CAAC,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;KACvC,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,cAAc,CAAC;QAChC,IAAI,EAAE,CAAC,eAAe,CAAC;QACvB,QAAQ,EAAE,CAAC,eAAe,CAAC;KAC5B,CAAC,CAAC;IAEH,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,CACH,aAAa,CACX;QACE,MAAM,EAAE,CAAC,eAAe,CAAC;QACzB,UAAU,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE;QAC9B,SAAS,EAAE,QAAQ;KACpB,EACD,EAAE,MAAM,EAAE,UAAU,EAAE,CACvB,EACH,+DAA+D,CAChE,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E,IAAI,CAAC,yDAAyD,EAAE,GAAG,EAAE;IACnE,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;IAC9B,MAAM,UAAU,GAAG,cAAc,CAAC;QAChC,IAAI,EAAE,CAAC,QAAQ,CAAC;QAChB,QAAQ,EAAE,CAAC,QAAQ,CAAC;KACrB,CAAC,CAAC;IAEH,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,CACH,aAAa,CACX,EAAE,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,EACtC,EAAE,MAAM,EAAE,UAAU,EAAE,CACvB,EACH,uBAAuB,CACxB,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,sDAAsD,EAAE,GAAG,EAAE;IAChE,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;IAC9B,MAAM,UAAU,GAAG,cAAc,CAAC;QAChC,IAAI,EAAE,CAAC,QAAQ,CAAC;QAChB,QAAQ,EAAE,CAAC,QAAQ,CAAC;KACrB,CAAC,CAAC;IAEH,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,CACH,aAAa,CACX,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,EACnD,EAAE,MAAM,EAAE,UAAU,EAAE,CACvB,EACH,oBAAoB,CACrB,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/payload/platform/plugins/memory/mcp/dist/lib/graph-write-gate.d.ts

@@ -10,6 +10,22 @@ export interface GateArgs {
     accountId: string;
     labels: string[];
 }
+/**
+ * Gate result.
+ *
+ * The `reason` discriminator is intentionally NOT extended for the personal-
+ * profile branch — `"no-local-business"` now covers two sub-cases:
+ *   1. AdminUser exists, no LocalBusiness, no personal-profile Person.
+ *   2. AdminUser exists, the operator is in personal mode, but the personal-
+ *      profile Person was never written or its `role` is wrong.
+ *
+ * Callers that branch on `reason` cannot distinguish (1) from (2) — both
+ * arrive as `"no-local-business"`. Today's downstream consumers (the user-
+ * facing `message`, business-profile SKILL.md prose) do not need to. If a
+ * future caller needs per-sub-case recovery, add a separate `subReason` field
+ * rather than overloading this one (existing callers depend on the current
+ * value set; broadening it would be a silent contract break).
+ */
 export type GateResult = {
     ok: true;
 } | {

package/payload/platform/plugins/memory/mcp/dist/lib/graph-write-gate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph-write-gate.d.ts","sourceRoot":"","sources":["../../src/lib/graph-write-gate.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,WAAW;IAC1B,GAAG,CACD,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,MAAM,UAAU,GAClB;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,eAAe,GAAG,mBAAmB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAYlF,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAkC7E"}
+{"version":3,"file":"graph-write-gate.d.ts","sourceRoot":"","sources":["../../src/lib/graph-write-gate.ts"],"names":[],"mappings":"AAuCA,MAAM,WAAW,WAAW;IAC1B,GAAG,CACD,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,eAAe,GAAG,mBAAmB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAalF,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAyC7E"}

package/payload/platform/plugins/memory/mcp/dist/lib/graph-write-gate.js

@@ -1,12 +1,22 @@
-// Graph-write precondition gate (Task 685).
+// Graph-write precondition gate (Task 685; extended Task 704).
 //
 // Refuses any `memory-write` / `memory-update` against a non-exempt node
-// label until the account's AdminUser AND LocalBusiness both exist in the
-// graph. The purpose is doctrine enforcement: SOUL is personality, factual
-// business data lives in the graph, and the agent must run `business-profile`
-// before writing user-domain nodes (WebSite, Service, etc.). Prose rules
-// drifted across past sessions; this gate removes the LLM from the decision
-// path entirely (feedback_deterministic_means_remove_llm.md).
+// label until the account's AdminUser exists AND at least one of
+// (LocalBusiness, personal-profile Person) exists. The purpose is doctrine
+// enforcement: SOUL is personality, factual user/business data lives in the
+// graph, and the agent must establish operator identity before writing
+// user-domain nodes (WebSite, Service, etc.). Prose rules drifted across past
+// sessions; this gate removes the LLM from the decision path entirely
+// (feedback_deterministic_means_remove_llm.md).
+//
+// Two satisfaction shapes (Task 704):
+//   1. Business-owner mode — AdminUser + LocalBusiness (original Task 685 path)
+//   2. Personal/employee mode — AdminUser + Person {role: "admin-personal"}
+//
+// The personal-profile bootstrap exists because Maxy's Solo licence target is
+// individual operators with no business at all; forcing them through a
+// business-profile flow created a silent failure where employees registered
+// their employer as a `LocalBusiness`.
 //
 // The exempt set is the base case that breaks the chicken-and-egg: the agent
 // must be able to write Person, LocalBusiness, and AdminUser *before* anything
@@ -14,16 +24,26 @@
 // capture writes `Person`, so exempting it keeps that flow working even when
 // the admin side has not run business-profile.
 //
+// Cypher safety: COUNT subqueries return 0 for missing matches, which is the
+// correct semantic here — no MATCH-SET silent-no-op risk (sprint-learning #5
+// applies to mutations, not COUNTs).
+//
 // Scope: this gate lives only in the MCP memory-write/update path the agent
 // calls. Server-side writers (neo4j-store, workflow-execute, admin/index)
 // are owned by Task 673's provenance doctrine — disjoint enforcement.
+//
+// TODO (perf, post-Phase-0): once Person counts grow into the thousands per
+// account, add a composite index on Person(accountId, role) so the
+// hasPersonalProfile subquery doesn't full-scan. Same scaling concern applies
+// to LocalBusiness(accountId) and AdminUser(accountId). Not in 704 scope.
 const EXEMPT_LABELS = new Set([
     "Person",
     "LocalBusiness",
     "AdminUser",
 ]);
-const NEXT_MOVE = "Run the business-profile skill to establish the admin user and " +
-    "business identity before writing this node.";
+const NEXT_MOVE = "Run the business-profile skill to establish the admin user and business " +
+    "identity, or complete the personal-profile bootstrap (onboarding step 9 " +
+    "personal/employee mode), before writing this node.";
 export async function checkGraphWriteGate(args) {
     const { session, accountId, labels } = args;
     if (labels.some((l) => EXEMPT_LABELS.has(l))) {
@@ -31,15 +51,22 @@ export async function checkGraphWriteGate(args) {
     }
     // COUNT subquery form — one query, no cartesian-product surprises,
     // account-scoped so multi-account installs don't cross-contaminate.
+    // Three subqueries: AdminUser, LocalBusiness, Person-with-admin-role.
     const result = await session.run(`RETURN
        COUNT { MATCH (au:AdminUser {accountId: $accountId}) } > 0 AS hasAdmin,
-       COUNT { MATCH (lb:LocalBusiness {accountId: $accountId}) } > 0 AS hasBusiness`, { accountId });
+       COUNT { MATCH (lb:LocalBusiness {accountId: $accountId}) } > 0 AS hasBusiness,
+       COUNT { MATCH (p:Person {accountId: $accountId, role: "admin-personal"}) } > 0 AS hasPersonalProfile`, { accountId });
     const record = result.records[0];
     const hasAdmin = Boolean(record?.get("hasAdmin"));
     const hasBusiness = Boolean(record?.get("hasBusiness"));
-    if (hasAdmin && hasBusiness) {
+    const hasPersonalProfile = Boolean(record?.get("hasPersonalProfile"));
+    if (hasAdmin && (hasBusiness || hasPersonalProfile)) {
         return { ok: true };
     }
+    // Reason discriminator stays backward-compatible: `no-admin-user` covers the
+    // missing-AdminUser case, `no-local-business` covers "AdminUser exists but
+    // neither business nor personal profile does." Existing callers keying on
+    // these strings (review-detector rules, error UI) keep working.
     const reason = hasAdmin
         ? "no-local-business"
         : "no-admin-user";

package/payload/platform/plugins/memory/mcp/dist/lib/graph-write-gate.js.map

@@ -1 +1 @@
-{"version":3,"file":"graph-write-gate.js","sourceRoot":"","sources":["../../src/lib/graph-write-gate.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,EAAE;AACF,yEAAyE;AACzE,0EAA0E;AAC1E,2EAA2E;AAC3E,8EAA8E;AAC9E,yEAAyE;AACzE,4EAA4E;AAC5E,8DAA8D;AAC9D,EAAE;AACF,6EAA6E;AAC7E,+EAA+E;AAC/E,0EAA0E;AAC1E,6EAA6E;AAC7E,+CAA+C;AAC/C,EAAE;AACF,4EAA4E;AAC5E,0EAA0E;AAC1E,sEAAsE;AAmBtE,MAAM,aAAa,GAAwB,IAAI,GAAG,CAAC;IACjD,QAAQ;IACR,eAAe;IACf,WAAW;CACZ,CAAC,CAAC;AAEH,MAAM,SAAS,GACb,iEAAiE;IACjE,6CAA6C,CAAC;AAEhD,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAc;IACtD,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAE5C,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACtB,CAAC;IAED,mEAAmE;IACnE,oEAAoE;IACpE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B;;qFAEiF,EACjF,EAAE,SAAS,EAAE,CACd,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACjC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;IAExD,IAAI,QAAQ,IAAI,WAAW,EAAE,CAAC;QAC5B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACtB,CAAC;IAED,MAAM,MAAM,GAA0C,QAAQ;QAC5D,CAAC,CAAC,mBAAmB;QACrB,CAAC,CAAC,eAAe,CAAC;IAEpB,OAAO,CAAC,GAAG,CACT,uCAAuC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI;QAC9D,UAAU,MAAM,eAAe,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CACpD,CAAC;IAEF,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AACnD,CAAC"}
+{"version":3,"file":"graph-write-gate.js","sourceRoot":"","sources":["../../src/lib/graph-write-gate.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,EAAE;AACF,yEAAyE;AACzE,iEAAiE;AACjE,2EAA2E;AAC3E,4EAA4E;AAC5E,uEAAuE;AACvE,8EAA8E;AAC9E,sEAAsE;AACtE,gDAAgD;AAChD,EAAE;AACF,sCAAsC;AACtC,gFAAgF;AAChF,4EAA4E;AAC5E,EAAE;AACF,8EAA8E;AAC9E,uEAAuE;AACvE,4EAA4E;AAC5E,uCAAuC;AACvC,EAAE;AACF,6EAA6E;AAC7E,+EAA+E;AAC/E,0EAA0E;AAC1E,6EAA6E;AAC7E,+CAA+C;AAC/C,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,qCAAqC;AACrC,EAAE;AACF,4EAA4E;AAC5E,0EAA0E;AAC1E,sEAAsE;AACtE,EAAE;AACF,4EAA4E;AAC5E,mEAAmE;AACnE,8EAA8E;AAC9E,0EAA0E;AAmC1E,MAAM,aAAa,GAAwB,IAAI,GAAG,CAAC;IACjD,QAAQ;IACR,eAAe;IACf,WAAW;CACZ,CAAC,CAAC;AAEH,MAAM,SAAS,GACb,0EAA0E;IAC1E,0EAA0E;IAC1E,oDAAoD,CAAC;AAEvD,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAc;IACtD,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAE5C,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACtB,CAAC;IAED,mEAAmE;IACnE,oEAAoE;IACpE,sEAAsE;IACtE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B;;;4GAGwG,EACxG,EAAE,SAAS,EAAE,CACd,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACjC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;IACxD,MAAM,kBAAkB,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAEtE,IAAI,QAAQ,IAAI,CAAC,WAAW,IAAI,kBAAkB,CAAC,EAAE,CAAC;QACpD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACtB,CAAC;IAED,6EAA6E;IAC7E,2EAA2E;IAC3E,0EAA0E;IAC1E,gEAAgE;IAChE,MAAM,MAAM,GAA0C,QAAQ;QAC5D,CAAC,CAAC,mBAAmB;QACrB,CAAC,CAAC,eAAe,CAAC;IAEpB,OAAO,CAAC,GAAG,CACT,uCAAuC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI;QAC9D,UAAU,MAAM,eAAe,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CACpD,CAAC;IAEF,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AACnD,CAAC"}

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

@@ -0,0 +1,136 @@
+/**
+ * Live schema source for the memory-write / memory-update validator (Task 736).
+ *
+ * Three sources, one decision rule:
+ *
+ *   liveLabels      — `db.labels()` snapshot from Neo4j (refreshed every 60s
+ *                     by SchemaCache from platform/lib/graph-mcp).
+ *   declaredLabels  — labels declared in `platform/neo4j/schema.cypher`
+ *                     (constraint + index FOR (alias:Label) forms).
+ *   markdownLabels  — labels with documented required-property groups in
+ *                     `platform/plugins/memory/references/schema-*.md`.
+ *
+ *   recognised = liveLabels ∪ declaredLabels         ← gates label existence
+ *   markdown documented? → run required-property check, else skip
+ *
+ * Why a per-process cache rather than a shared one. The graph-mcp proxy and
+ * the memory plugin run as separate stdio MCP servers spawned by Claude Code
+ * (each with its own Neo4j driver). "In-process" in the Task 736 brief means
+ * "no per-decision tool round-trip" — *not* a shared cache instance, which
+ * would require IPC. Two SchemaCache instances polling the same Neo4j every
+ * 60s costs roughly two `db.labels()` calls per minute and avoids the IPC
+ * surface entirely.
+ *
+ * Why drift runs from the cache's emit hook. SchemaCache uses single-flight
+ * refresh — concurrent `refresh()` calls share an in-flight promise. A
+ * parallel timer could race against an in-progress refresh and read a stale
+ * snapshot during the comparison. The cache's own `emit()` callback fires
+ * synchronously after a successful refresh swap, so tapping it guarantees
+ * the snapshot we read is the one the refresh just produced.
+ *
+ * Bootstrap posture. Fresh installs have no nodes yet, so `db.labels()`
+ * returns []. The validator must still accept the very first
+ * `LocalBusiness` write because that label is *declared* in schema.cypher
+ * even when no node carries it. The recognised-set union resolves this
+ * directly; no fail-open branch needed for that case.
+ *
+ *   db.labels()     declared in cypher    recognised?
+ *   ─────────       ──────────────────    ───────────
+ *   []              [LocalBusiness]       LocalBusiness  ✓ (bootstrap)
+ *   [LocalBusiness] [LocalBusiness]       LocalBusiness  ✓ (steady state)
+ *   [Person]        [LocalBusiness]       Person + LocalBusiness  ✓
+ *   []              []                    {}             reject all (Neo4j
+ *                                                         unreachable AND
+ *                                                         schema.cypher
+ *                                                         unreadable — both
+ *                                                         logged loudly)
+ */
+import { SchemaCache, neo4jSchemaFetcher, type SchemaFetcher } from "../../../../../lib/graph-mcp/dist/schema-cache.js";
+export type DriftKind = "live-not-declared" | "declared-not-live" | "markdown-orphan";
+export interface DriftEntry {
+    kind: DriftKind;
+    token: string;
+}
+export interface LiveSchemaSource {
+    /** live ∪ declared — used for label existence */
+    recognisedLabels(): Set<string>;
+    /** Just `db.labels()` — for drift comparison and observability */
+    liveLabels(): Set<string>;
+    /** Just schema.cypher constraint+index declarations */
+    declaredLabels(): Set<string>;
+    /** Whether the live snapshot has resolved at least once */
+    liveReady(): boolean;
+}
+interface BuildLiveSchemaSourceOptions {
+    schemaCypherPath: string;
+    /**
+     * Markdown-documented label set (the renamed `LoadedSchema.markdownLabels`).
+     * Used only for boot/refresh drift comparison — not for the per-write
+     * decision path.
+     */
+    markdownLabels: Iterable<string>;
+    fetcher: SchemaFetcher;
+    /** Override default 60s refresh in tests. */
+    refreshIntervalMs?: number;
+    /** Test-injectable log emitter. Default: process.stderr. */
+    emit?: (line: string) => void;
+}
+export interface LiveSchemaRuntime {
+    source: LiveSchemaSource;
+    cache: SchemaCache;
+    /**
+     * Resolves once the boot refresh has completed (success or failure).
+     * Callers that want drift logged at boot should `await runtime.ready`.
+     * Validators do not block on this — they fail-open against an empty live
+     * snapshot, which (combined with the declared set) still accepts the
+     * bootstrap labels on a fresh install.
+     */
+    ready: Promise<void>;
+}
+/**
+ * Build the live schema source plus its backing cache.
+ *
+ * The caller (memory MCP `index.ts`) owns lifecycle: it must `await
+ * runtime.ready` (or fire-and-forget) and call `runtime.cache.stop()` on
+ * shutdown. Tests pass a stub fetcher and a synthetic interval.
+ */
+export declare function buildLiveSchemaSource(options: BuildLiveSchemaSourceOptions): LiveSchemaRuntime;
+/** Re-export the fetcher factory so index.ts can wire one up cleanly. */
+export { neo4jSchemaFetcher };
+interface DriftCheckInput {
+    live: ReadonlySet<string>;
+    declared: ReadonlySet<string>;
+    markdown: ReadonlySet<string>;
+    emit: (line: string) => void;
+}
+/**
+ * Emit one log line per drifted token. Pure aside from the supplied emitter.
+ * Returns the drift entries for tests.
+ *
+ * Three drift kinds:
+ *   live-not-declared : a label that nodes carry but schema.cypher does not
+ *                       declare a constraint/index for. Migration-drift
+ *                       signal — someone created a node with a fresh label
+ *                       without adding the canonical declaration.
+ *   declared-not-live : declared in schema.cypher but no node carries it
+ *                       yet. Expected on fresh installs (bootstrap labels);
+ *                       suspicious on populated graphs (dead declaration).
+ *   markdown-orphan   : documented in schema-*.md but missing from both
+ *                       live and declared. Stale-doc signal — markdown
+ *                       describing a label that no longer exists in the
+ *                       graph or its constraint declarations.
+ */
+export declare function runDriftCheck(input: DriftCheckInput): DriftEntry[];
+/**
+ * Resolve the absolute path to `platform/neo4j/schema.cypher`.
+ *
+ * Layout (compiled and source paths are siblings, so the offset is the same):
+ *   platform/plugins/memory/mcp/{src,dist}/lib/live-schema-source.{ts,js}
+ *   platform/neo4j/schema.cypher
+ *
+ * From `import.meta.dirname` (mcp/{src,dist}/lib/) the relative path is
+ * `../../../../../neo4j/schema.cypher` — 5 hops to platform/, then down.
+ * `PLATFORM_ROOT` overrides for production where the layout may differ.
+ */
+export declare function defaultSchemaCypherPath(): string;
+//# sourceMappingURL=live-schema-source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"live-schema-source.d.ts","sourceRoot":"","sources":["../../src/lib/live-schema-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAIH,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,KAAK,aAAa,EACnB,MAAM,mDAAmD,CAAC;AAG3D,MAAM,MAAM,SAAS,GACjB,mBAAmB,GACnB,mBAAmB,GACnB,iBAAiB,CAAC;AAEtB,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,gBAAgB,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IAChC,kEAAkE;IAClE,UAAU,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,uDAAuD;IACvD,cAAc,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,2DAA2D;IAC3D,SAAS,IAAI,OAAO,CAAC;CACtB;AAED,UAAU,4BAA4B;IACpC,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjC,OAAO,EAAE,aAAa,CAAC;IACvB,6CAA6C;IAC7C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4DAA4D;IAC5D,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB;;;;;;OAMG;IACH,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,4BAA4B,GACpC,iBAAiB,CAwCnB;AAED,yEAAyE;AACzE,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAM9B,UAAU,eAAe;IACvB,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1B,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9B,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU,EAAE,CAyBlE;AAuBD;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAKhD"}