@rubytech/create-maxy-code 0.1.0

package/payload/platform/lib/graph-mcp/dist/__tests__/schema-cache.test.js

@@ -0,0 +1,163 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = __importDefault(require("node:test"));
+const strict_1 = __importDefault(require("node:assert/strict"));
+const schema_cache_js_1 = require("../schema-cache.js");
+function makeFetcher(labels, rels, opts = {}) {
+    let called = 0;
+    let currentLabels = labels;
+    let currentRels = rels;
+    return {
+        get calls() {
+            return called;
+        },
+        async labels() {
+            called++;
+            if (opts.failOnce && called === 1)
+                throw new Error("transient");
+            return currentLabels;
+        },
+        async relationshipTypes() {
+            return currentRels;
+        },
+    };
+}
+(0, node_test_1.default)("start() populates the snapshot and sets ready()", async () => {
+    const fetcher = makeFetcher(["Conversation", "Message"], ["PART_OF"]);
+    const emitted = [];
+    const cache = new schema_cache_js_1.SchemaCache(fetcher, {
+        refreshIntervalMs: 0,
+        emit: (l) => emitted.push(l),
+    });
+    strict_1.default.equal(cache.ready(), false);
+    await cache.start();
+    strict_1.default.equal(cache.ready(), true);
+    const snap = cache.snapshot();
+    strict_1.default.ok(snap.labels.has("Conversation"));
+    strict_1.default.ok(snap.labels.has("Message"));
+    strict_1.default.ok(snap.relationshipTypes.has("PART_OF"));
+    strict_1.default.ok(emitted.some((l) => l.includes("[schema-cache] refresh")));
+    cache.stop();
+});
+(0, node_test_1.default)("start() with Neo4j unreachable leaves cache empty and not ready, but does not throw", async () => {
+    const fetcher = {
+        async labels() {
+            throw new Error("ECONNREFUSED");
+        },
+        async relationshipTypes() {
+            throw new Error("ECONNREFUSED");
+        },
+    };
+    const emitted = [];
+    const cache = new schema_cache_js_1.SchemaCache(fetcher, {
+        refreshIntervalMs: 0,
+        emit: (l) => emitted.push(l),
+    });
+    await cache.start();
+    strict_1.default.equal(cache.ready(), false);
+    strict_1.default.equal(cache.snapshot().labels.size, 0);
+    strict_1.default.ok(emitted.some((l) => l.includes("[schema-cache]") && l.includes("failure")), "expected a failure log line");
+    cache.stop();
+});
+(0, node_test_1.default)("refresh() picks up a newly-added relationship type", async () => {
+    let rels = ["PART_OF"];
+    const fetcher = {
+        async labels() {
+            return ["Conversation"];
+        },
+        async relationshipTypes() {
+            return rels;
+        },
+    };
+    const cache = new schema_cache_js_1.SchemaCache(fetcher, { refreshIntervalMs: 0 });
+    await cache.start();
+    strict_1.default.equal(cache.snapshot().relationshipTypes.has("MIGRATED_EDGE"), false);
+    rels = ["PART_OF", "MIGRATED_EDGE"];
+    await cache.refresh("interval");
+    strict_1.default.ok(cache.snapshot().relationshipTypes.has("MIGRATED_EDGE"));
+    cache.stop();
+});
+(0, node_test_1.default)("refresh() preserves last good cache on transient failure", async () => {
+    let fail = false;
+    const fetcher = {
+        async labels() {
+            if (fail)
+                throw new Error("transient");
+            return ["Conversation"];
+        },
+        async relationshipTypes() {
+            if (fail)
+                throw new Error("transient");
+            return ["PART_OF"];
+        },
+    };
+    const cache = new schema_cache_js_1.SchemaCache(fetcher, { refreshIntervalMs: 0 });
+    await cache.start();
+    strict_1.default.equal(cache.ready(), true);
+    fail = true;
+    const ok = await cache.refresh("interval");
+    strict_1.default.equal(ok, false);
+    strict_1.default.equal(cache.ready(), true, "should remain ready after a transient failure");
+    strict_1.default.ok(cache.snapshot().labels.has("Conversation"));
+    cache.stop();
+});
+(0, node_test_1.default)("maybeRebuildOnStaleMiss() triggers refresh when an unknown token has a near match", async () => {
+    let rels = ["PART_OF"];
+    const fetcher = {
+        async labels() {
+            return ["Conversation"];
+        },
+        async relationshipTypes() {
+            return rels;
+        },
+    };
+    const cache = new schema_cache_js_1.SchemaCache(fetcher, {
+        refreshIntervalMs: 0,
+        staleMissDebounceMs: 0,
+    });
+    await cache.start();
+    rels = ["PART_OF", "PART_OFF"];
+    const triggered = await cache.maybeRebuildOnStaleMiss([
+        { token: "PART_OFF", kind: "relationship", nearest: ["PART_OF"], hint: "" },
+    ]);
+    strict_1.default.equal(triggered, true);
+    strict_1.default.ok(cache.snapshot().relationshipTypes.has("PART_OFF"));
+    cache.stop();
+});
+(0, node_test_1.default)("maybeRebuildOnStaleMiss() skips when no near match (likely typo, not migration)", async () => {
+    const fetcher = makeFetcher(["Conversation"], ["PART_OF"]);
+    const cache = new schema_cache_js_1.SchemaCache(fetcher, {
+        refreshIntervalMs: 0,
+        staleMissDebounceMs: 0,
+    });
+    await cache.start();
+    const callsBefore = fetcher.calls;
+    const triggered = await cache.maybeRebuildOnStaleMiss([
+        { token: "COMPLETELY_DIFFERENT", kind: "relationship", nearest: ["PART_OF"], hint: "" },
+    ]);
+    strict_1.default.equal(triggered, false);
+    strict_1.default.equal(fetcher.calls, callsBefore, "no extra fetches when edit distance is far");
+    cache.stop();
+});
+(0, node_test_1.default)("maybeRebuildOnStaleMiss() debounces repeated triggers", async () => {
+    const fetcher = makeFetcher(["Conversation"], ["PART_OF"]);
+    const cache = new schema_cache_js_1.SchemaCache(fetcher, {
+        refreshIntervalMs: 0,
+        staleMissDebounceMs: 5000,
+    });
+    await cache.start();
+    const callsBefore = fetcher.calls;
+    const unknown = [
+        { token: "PART_OFF", kind: "relationship", nearest: ["PART_OF"], hint: "" },
+    ];
+    await cache.maybeRebuildOnStaleMiss(unknown);
+    const afterFirst = fetcher.calls;
+    await cache.maybeRebuildOnStaleMiss(unknown);
+    strict_1.default.equal(fetcher.calls, afterFirst, "second call within debounce should not refetch");
+    strict_1.default.ok(afterFirst > callsBefore, "first call did refetch");
+    cache.stop();
+});
+//# sourceMappingURL=schema-cache.test.js.map

package/payload/platform/lib/graph-mcp/dist/__tests__/schema-cache.test.js.map

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

package/payload/platform/lib/graph-mcp/dist/__tests__/schema-cypher-parser.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schema-cypher-parser.test.d.ts.map

package/payload/platform/lib/graph-mcp/dist/__tests__/schema-cypher-parser.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-cypher-parser.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/schema-cypher-parser.test.ts"],"names":[],"mappings":""}

package/payload/platform/lib/graph-mcp/dist/__tests__/schema-cypher-parser.test.js

@@ -0,0 +1,89 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = __importDefault(require("node:test"));
+const strict_1 = __importDefault(require("node:assert/strict"));
+const schema_cypher_parser_js_1 = require("../schema-cypher-parser.js");
+(0, node_test_1.default)("parseLabelsFromSchemaCypher: extracts labels from constraint and index forms", () => {
+    const text = `
+CREATE CONSTRAINT person_email IF NOT EXISTS
+FOR (p:Person) REQUIRE p.email IS UNIQUE;
+
+CREATE CONSTRAINT business_account IF NOT EXISTS
+FOR (b:LocalBusiness) REQUIRE b.accountId IS UNIQUE;
+
+CREATE INDEX admin_user_account IF NOT EXISTS
+FOR (au:AdminUser) ON (au.accountId);
+
+CREATE INDEX knowledge_doc IF NOT EXISTS
+FOR (k:KnowledgeDocument) ON (k.embedding) OPTIONS { ... };
+`;
+    const labels = (0, schema_cypher_parser_js_1.parseLabelsFromSchemaCypher)(text);
+    strict_1.default.deepEqual(labels, [
+        "AdminUser",
+        "KnowledgeDocument",
+        "LocalBusiness",
+        "Person",
+    ]);
+});
+(0, node_test_1.default)("parseLabelsFromSchemaCypher: deduplicates labels declared multiple times", () => {
+    const text = `
+FOR (p:Person) REQUIRE p.email IS UNIQUE;
+FOR (p:Person) REQUIRE p.telephone IS UNIQUE;
+FOR (p:Person) ON (p.status);
+`;
+    strict_1.default.deepEqual((0, schema_cypher_parser_js_1.parseLabelsFromSchemaCypher)(text), ["Person"]);
+});
+(0, node_test_1.default)("parseLabelsFromSchemaCypher: returns sorted output", () => {
+    const text = `FOR (z:Zebra) ON (z.x); FOR (a:Aardvark) ON (a.x); FOR (m:Mongoose) ON (m.x);`;
+    strict_1.default.deepEqual((0, schema_cypher_parser_js_1.parseLabelsFromSchemaCypher)(text), [
+        "Aardvark",
+        "Mongoose",
+        "Zebra",
+    ]);
+});
+(0, node_test_1.default)("parseLabelsFromSchemaCypher: ignores non-constraint cypher", () => {
+    const text = `
+MATCH (n:Person) RETURN n;
+CREATE (b:Business { name: 'X' });
+FOR (p:Person) REQUIRE p.email IS UNIQUE;
+`;
+    // MATCH/CREATE patterns don't include FOR, so they're ignored.
+    strict_1.default.deepEqual((0, schema_cypher_parser_js_1.parseLabelsFromSchemaCypher)(text), ["Person"]);
+});
+(0, node_test_1.default)("parseLabelsFromSchemaCypher: empty input returns empty array", () => {
+    strict_1.default.deepEqual((0, schema_cypher_parser_js_1.parseLabelsFromSchemaCypher)(""), []);
+});
+(0, node_test_1.default)("levenshtein: identical strings", () => {
+    strict_1.default.equal((0, schema_cypher_parser_js_1.levenshtein)("Person", "Person"), 0);
+});
+(0, node_test_1.default)("levenshtein: substitution distance", () => {
+    // LocaIBusiness vs LocalBusiness — capital-I-as-l typo from the incident.
+    strict_1.default.equal((0, schema_cypher_parser_js_1.levenshtein)("LocaIBusiness", "LocalBusiness"), 1);
+});
+(0, node_test_1.default)("levenshtein: insertion + deletion", () => {
+    strict_1.default.equal((0, schema_cypher_parser_js_1.levenshtein)("Person", "Persons"), 1);
+    strict_1.default.equal((0, schema_cypher_parser_js_1.levenshtein)("Persons", "Person"), 1);
+});
+(0, node_test_1.default)("levenshtein: handles empty strings", () => {
+    strict_1.default.equal((0, schema_cypher_parser_js_1.levenshtein)("", "abc"), 3);
+    strict_1.default.equal((0, schema_cypher_parser_js_1.levenshtein)("abc", ""), 3);
+    strict_1.default.equal((0, schema_cypher_parser_js_1.levenshtein)("", ""), 0);
+});
+(0, node_test_1.default)("nearestLabel: finds the closest match", () => {
+    const candidates = ["Person", "LocalBusiness", "AdminUser"];
+    strict_1.default.equal((0, schema_cypher_parser_js_1.nearestLabel)("LocaIBusiness", candidates), "LocalBusiness");
+    strict_1.default.equal((0, schema_cypher_parser_js_1.nearestLabel)("AdminUsr", candidates), "AdminUser");
+});
+(0, node_test_1.default)("nearestLabel: returns null when no match within maxDistance", () => {
+    const candidates = ["Person", "LocalBusiness"];
+    strict_1.default.equal((0, schema_cypher_parser_js_1.nearestLabel)("Quokka", candidates), null);
+    // Default maxDistance is 3; "abcde" is too far from any candidate.
+    strict_1.default.equal((0, schema_cypher_parser_js_1.nearestLabel)("abcde", candidates, 1), null);
+});
+(0, node_test_1.default)("nearestLabel: empty candidates returns null", () => {
+    strict_1.default.equal((0, schema_cypher_parser_js_1.nearestLabel)("Person", []), null);
+});
+//# sourceMappingURL=schema-cypher-parser.test.js.map

package/payload/platform/lib/graph-mcp/dist/__tests__/schema-cypher-parser.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-cypher-parser.test.js","sourceRoot":"","sources":["../../src/__tests__/schema-cypher-parser.test.ts"],"names":[],"mappings":";;;;;AAAA,0DAA6B;AAC7B,gEAAwC;AACxC,wEAIoC;AAEpC,IAAA,mBAAI,EAAC,8EAA8E,EAAE,GAAG,EAAE;IACxF,MAAM,IAAI,GAAG;;;;;;;;;;;;CAYd,CAAC;IACA,MAAM,MAAM,GAAG,IAAA,qDAA2B,EAAC,IAAI,CAAC,CAAC;IACjD,gBAAM,CAAC,SAAS,CAAC,MAAM,EAAE;QACvB,WAAW;QACX,mBAAmB;QACnB,eAAe;QACf,QAAQ;KACT,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAA,mBAAI,EAAC,0EAA0E,EAAE,GAAG,EAAE;IACpF,MAAM,IAAI,GAAG;;;;CAId,CAAC;IACA,gBAAM,CAAC,SAAS,CAAC,IAAA,qDAA2B,EAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;AAClE,CAAC,CAAC,CAAC;AAEH,IAAA,mBAAI,EAAC,oDAAoD,EAAE,GAAG,EAAE;IAC9D,MAAM,IAAI,GAAG,+EAA+E,CAAC;IAC7F,gBAAM,CAAC,SAAS,CAAC,IAAA,qDAA2B,EAAC,IAAI,CAAC,EAAE;QAClD,UAAU;QACV,UAAU;QACV,OAAO;KACR,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAA,mBAAI,EAAC,4DAA4D,EAAE,GAAG,EAAE;IACtE,MAAM,IAAI,GAAG;;;;CAId,CAAC;IACA,+DAA+D;IAC/D,gBAAM,CAAC,SAAS,CAAC,IAAA,qDAA2B,EAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;AAClE,CAAC,CAAC,CAAC;AAEH,IAAA,mBAAI,EAAC,8DAA8D,EAAE,GAAG,EAAE;IACxE,gBAAM,CAAC,SAAS,CAAC,IAAA,qDAA2B,EAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;AACxD,CAAC,CAAC,CAAC;AAEH,IAAA,mBAAI,EAAC,gCAAgC,EAAE,GAAG,EAAE;IAC1C,gBAAM,CAAC,KAAK,CAAC,IAAA,qCAAW,EAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;AACnD,CAAC,CAAC,CAAC;AAEH,IAAA,mBAAI,EAAC,oCAAoC,EAAE,GAAG,EAAE;IAC9C,0EAA0E;IAC1E,gBAAM,CAAC,KAAK,CAAC,IAAA,qCAAW,EAAC,eAAe,EAAE,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC;AACjE,CAAC,CAAC,CAAC;AAEH,IAAA,mBAAI,EAAC,mCAAmC,EAAE,GAAG,EAAE;IAC7C,gBAAM,CAAC,KAAK,CAAC,IAAA,qCAAW,EAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;IAClD,gBAAM,CAAC,KAAK,CAAC,IAAA,qCAAW,EAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;AACpD,CAAC,CAAC,CAAC;AAEH,IAAA,mBAAI,EAAC,oCAAoC,EAAE,GAAG,EAAE;IAC9C,gBAAM,CAAC,KAAK,CAAC,IAAA,qCAAW,EAAC,EAAE,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IACxC,gBAAM,CAAC,KAAK,CAAC,IAAA,qCAAW,EAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACxC,gBAAM,CAAC,KAAK,CAAC,IAAA,qCAAW,EAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACvC,CAAC,CAAC,CAAC;AAEH,IAAA,mBAAI,EAAC,uCAAuC,EAAE,GAAG,EAAE;IACjD,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,eAAe,EAAE,WAAW,CAAC,CAAC;IAC5D,gBAAM,CAAC,KAAK,CAAC,IAAA,sCAAY,EAAC,eAAe,EAAE,UAAU,CAAC,EAAE,eAAe,CAAC,CAAC;IACzE,gBAAM,CAAC,KAAK,CAAC,IAAA,sCAAY,EAAC,UAAU,EAAE,UAAU,CAAC,EAAE,WAAW,CAAC,CAAC;AAClE,CAAC,CAAC,CAAC;AAEH,IAAA,mBAAI,EAAC,6DAA6D,EAAE,GAAG,EAAE;IACvE,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IAC/C,gBAAM,CAAC,KAAK,CAAC,IAAA,sCAAY,EAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,IAAI,CAAC,CAAC;IACvD,mEAAmE;IACnE,gBAAM,CAAC,KAAK,CAAC,IAAA,sCAAY,EAAC,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AAC3D,CAAC,CAAC,CAAC;AAEH,IAAA,mBAAI,EAAC,6CAA6C,EAAE,GAAG,EAAE;IACvD,gBAAM,CAAC,KAAK,CAAC,IAAA,sCAAY,EAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;AACjD,CAAC,CAAC,CAAC"}

package/payload/platform/lib/graph-mcp/dist/__tests__/warnings-envelope.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=warnings-envelope.test.d.ts.map

package/payload/platform/lib/graph-mcp/dist/__tests__/warnings-envelope.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warnings-envelope.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/warnings-envelope.test.ts"],"names":[],"mappings":""}

package/payload/platform/lib/graph-mcp/dist/__tests__/warnings-envelope.test.js

@@ -0,0 +1,140 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Task 970 — Neo4j envelope-warning passthrough.
+//
+// Pure-function tests for the helpers in cypher-shim-read.ts:
+//   - filterEnvelopeNotifications: keeps only ^0[12]N5\d$ GQL status codes
+//   - stitchWarningsIntoResponse:  prepends a warnings content block
+//   - runReadProbe:                runs cypher through a shim-side session
+//                                  and returns notifications from the summary
+//
+// Failure mode this closes: the agent ran `RETURN h.hostname` against a node
+// whose property is `hostnameValue`, Neo4j emitted gql_status=01N52
+// "property does not exist", but the warning was dropped by the upstream
+// envelope and the agent saw `[]`. Without these warnings reaching the tool
+// result, the same recurrence will hit other property names too.
+const node_test_1 = __importDefault(require("node:test"));
+const strict_1 = __importDefault(require("node:assert/strict"));
+const cypher_shim_read_js_1 = require("../cypher-shim-read.js");
+(0, node_test_1.default)("filterEnvelopeNotifications keeps 01N5x and 02N5x, drops everything else", () => {
+    const input = [
+        { gqlStatus: "01N52", title: "...", description: "property does not exist (foo)", position: { offset: 0, line: 1, column: 1 } },
+        { gqlStatus: "02N50", title: "...", description: "label does not exist (Foo)", position: null },
+        { gqlStatus: "01N40", title: "...", description: "wrong family", position: null },
+        { gqlStatus: "03N42", title: "...", description: "unrelated", position: null },
+        { gqlStatus: "00N00", title: "...", description: "neutral status", position: null },
+    ];
+    const filtered = (0, cypher_shim_read_js_1.filterEnvelopeNotifications)(input);
+    strict_1.default.equal(filtered.length, 2);
+    strict_1.default.equal(filtered[0].gql_status, "01N52");
+    strict_1.default.equal(filtered[0].description, "property does not exist (foo)");
+    strict_1.default.deepEqual(filtered[0].position, { offset: 0, line: 1, column: 1 });
+    strict_1.default.equal(filtered[1].gql_status, "02N50");
+    strict_1.default.equal(filtered[1].position, null);
+});
+(0, node_test_1.default)("filterEnvelopeNotifications on an empty or all-irrelevant list returns []", () => {
+    strict_1.default.deepEqual((0, cypher_shim_read_js_1.filterEnvelopeNotifications)([]), []);
+    strict_1.default.deepEqual((0, cypher_shim_read_js_1.filterEnvelopeNotifications)([
+        { gqlStatus: "03N42", title: "", description: "", position: null },
+        { gqlStatus: "01N40", title: "", description: "", position: null },
+    ]), []);
+});
+(0, node_test_1.default)("stitchWarningsIntoResponse prepends a warnings content block when warnings exist", () => {
+    const original = {
+        jsonrpc: "2.0",
+        id: 42,
+        result: { content: [{ type: "text", text: "[]" }] },
+    };
+    const warnings = [
+        { gql_status: "01N52", description: "property hostname does not exist", position: null },
+    ];
+    const out = (0, cypher_shim_read_js_1.stitchWarningsIntoResponse)(original, warnings);
+    strict_1.default.notEqual(out, null);
+    const parsed = JSON.parse(out);
+    strict_1.default.equal(parsed.id, 42);
+    strict_1.default.equal(parsed.result.content.length, 2);
+    strict_1.default.equal(parsed.result.content[0].type, "text");
+    strict_1.default.match(parsed.result.content[0].text, /Neo4j envelope warnings/);
+    strict_1.default.match(parsed.result.content[0].text, /01N52/);
+    strict_1.default.match(parsed.result.content[0].text, /property hostname does not exist/);
+    // Original row block preserved verbatim, after the warnings prefix.
+    strict_1.default.equal(parsed.result.content[1].text, "[]");
+});
+(0, node_test_1.default)("stitchWarningsIntoResponse returns null when no warnings (no envelope rewrite)", () => {
+    const original = { jsonrpc: "2.0", id: 1, result: { content: [{ type: "text", text: "[]" }] } };
+    strict_1.default.equal((0, cypher_shim_read_js_1.stitchWarningsIntoResponse)(original, []), null);
+});
+(0, node_test_1.default)("stitchWarningsIntoResponse handles missing result.content defensively", () => {
+    const original = { jsonrpc: "2.0", id: 1, result: {} };
+    const warnings = [{ gql_status: "01N52", description: "x", position: null }];
+    const out = (0, cypher_shim_read_js_1.stitchWarningsIntoResponse)(original, warnings);
+    strict_1.default.notEqual(out, null);
+    const parsed = JSON.parse(out);
+    strict_1.default.equal(parsed.result.content.length, 1);
+    strict_1.default.match(parsed.result.content[0].text, /01N52/);
+});
+(0, node_test_1.default)("runReadProbe returns notifications captured from the driver summary", async () => {
+    const session = {
+        run: async () => ({
+            summary: {
+                notifications: [
+                    { gqlStatus: "01N52", title: "", description: "missing prop", position: null },
+                ],
+            },
+        }),
+        close: async () => { },
+    };
+    const driver = { session: () => session };
+    const notifs = await (0, cypher_shim_read_js_1.runReadProbe)(driver, "MATCH (n) RETURN n.foo", {});
+    strict_1.default.equal(notifs.length, 1);
+    strict_1.default.equal(notifs[0].gqlStatus, "01N52");
+});
+(0, node_test_1.default)("runReadProbe returns [] when driver summary has no notifications", async () => {
+    const session = {
+        run: async () => ({ summary: {} }),
+        close: async () => { },
+    };
+    const driver = { session: () => session };
+    strict_1.default.deepEqual(await (0, cypher_shim_read_js_1.runReadProbe)(driver, "RETURN 1", {}), []);
+});
+(0, node_test_1.default)("runReadProbe closes the session even when run() throws", async () => {
+    let closed = false;
+    const session = {
+        run: async () => {
+            throw new Error("boom");
+        },
+        close: async () => {
+            closed = true;
+        },
+    };
+    const driver = { session: () => session };
+    await strict_1.default.rejects(() => (0, cypher_shim_read_js_1.runReadProbe)(driver, "RETURN 1", {}));
+    strict_1.default.equal(closed, true, "session must be closed on error");
+});
+(0, node_test_1.default)("end-to-end: filter + stitch on a real-shape upstream response surfaces 01N52", () => {
+    // Models the failure mode in the original log: upstream returned an empty
+    // row list; Neo4j attached an 01N52 notification that the upstream Python
+    // server dropped.
+    const upstreamResponse = {
+        jsonrpc: "2.0",
+        id: 99,
+        result: { content: [{ type: "text", text: "[]" }] },
+    };
+    const driverNotifications = [
+        {
+            gqlStatus: "01N52",
+            title: "Property does not exist",
+            description: "The property 'hostname' does not exist on the node",
+            position: { offset: 38, line: 1, column: 39 },
+        },
+    ];
+    const warnings = (0, cypher_shim_read_js_1.filterEnvelopeNotifications)(driverNotifications);
+    const stitched = (0, cypher_shim_read_js_1.stitchWarningsIntoResponse)(upstreamResponse, warnings);
+    const parsed = JSON.parse(stitched);
+    strict_1.default.match(parsed.result.content[0].text, /01N52/);
+    strict_1.default.match(parsed.result.content[0].text, /hostname/);
+});
+//# sourceMappingURL=warnings-envelope.test.js.map

package/payload/platform/lib/graph-mcp/dist/__tests__/warnings-envelope.test.js.map

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

package/payload/platform/lib/graph-mcp/dist/cypher-rewrite-stamp.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Cypher rewrite pass that injects provenance stamps into operator-supplied
+ * write_neo4j_cypher (Task 797). Sibling to cypher-validate.ts: validate first,
+ * rewrite second, run third.
+ *
+ * Doctrine context: Task 673 wrapped writers stamp every CREATE node
+ * structurally via writeNodeWithEdges; raw cypher (Task 796) relied on
+ * prompt-internalised discipline. This module closes the asymmetry — the
+ * rewriter appends `SET <alias>.createdAt = $__autoStartTimestamp,
+ * <alias>.createdByAgent = $__autoAgent, <alias>.createdByTool =
+ * 'graph-cypher-write', <alias>.createdBySession = $__autoSession` to every
+ * CREATE/MERGE clause that introduces a new labeled node. Caller supplies
+ * the three `$__auto*` params at tx.run time.
+ *
+ * MERGE handling preserves the create-vs-match distinction. CREATE always
+ * stamps (every CREATE introduces a new node by definition). MERGE injects
+ * `ON CREATE SET` so an existing-node match path keeps the original writer's
+ * provenance intact — overwriting it would destroy forensic attribution.
+ *
+ * Node-only stamping. Edge aliases (`[r:R]`) are not auto-stamped — matches
+ * the wrapped writer's writeNodeWithEdges, which stamps the node only.
+ *
+ * Idempotent: re-applying the rewriter to its own output is a no-op. The
+ * marker that proves "already stamped" is `<alias>.createdBySession =
+ * $__autoSession` — the unique combination of property name + auto param.
+ *
+ * String literals and comments are redacted (chars replaced with spaces,
+ * offsets preserved) so a `CREATE (fake:Foo)` inside a comment or quoted
+ * string cannot mistakenly trip the rewriter.
+ */
+export interface RewriteResult {
+    cypher: string;
+    /** Number of node aliases that received a fresh stamp injection. */
+    stampsAppended: number;
+}
+export declare function rewriteWithProvenanceStamps(cypher: string): RewriteResult;
+//# sourceMappingURL=cypher-rewrite-stamp.d.ts.map

package/payload/platform/lib/graph-mcp/dist/cypher-rewrite-stamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cypher-rewrite-stamp.d.ts","sourceRoot":"","sources":["../src/cypher-rewrite-stamp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,cAAc,EAAE,MAAM,CAAC;CACxB;AAsPD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAmEzE"}