@henrychong-ai/mcp-neo4j-knowledge-graph 2.7.0 → 2.8.0

package/dist/cli/report-oversized.js

@@ -0,0 +1,158 @@
+/**
+ * CLI tool: report knowledge-graph entities that are at risk of exceeding the
+ * MCP `open_nodes` output cap, so they can be restructured before they become
+ * unretrievable.
+ *
+ * Usage:
+ *   npm run kg:oversized                 # table of WARN/CRITICAL entities
+ *   npm run kg:oversized -- --include-ok # include OK entities too
+ *   npm run kg:oversized -- --json       # machine-readable JSON
+ *   npm run kg:oversized -- --limit 100  # scan the 100 largest
+ *
+ * Exit code is 1 when any CRITICAL entity exists (so a cron/CI job can alert),
+ * 0 otherwise. This is the "ongoing basis" mechanism: schedule it on a recurring
+ * cron alongside the embedding backfill.
+ *
+ * Requirements:
+ *   - Neo4j connection configured (NEO4J_URI, NEO4J_USERNAME, NEO4J_PASSWORD)
+ *   - No embedding provider needed — sizing is pure Cypher.
+ */
+import dotenv from 'dotenv';
+import { getEntitySizeConfig } from '../config/entitySize.js';
+import { estimateEntitySize, estimateFromCharCount, RESTRUCTURE_HINT, } from '../maintenance/EntitySizeService.js';
+import { Neo4jStorageProvider } from '../storage/neo4j/Neo4jStorageProvider.js';
+dotenv.config();
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const options = { includeOk: false, json: false };
+    for (let i = 0; i < args.length; i++) {
+        switch (args[i]) {
+            case '--limit': {
+                options.limit = Number.parseInt(args[++i], 10);
+                break;
+            }
+            case '--warn-ratio': {
+                options.warnRatio = Number.parseFloat(args[++i]);
+                break;
+            }
+            case '--include-ok': {
+                options.includeOk = true;
+                break;
+            }
+            case '--json': {
+                options.json = true;
+                break;
+            }
+            case '--help': {
+                printHelp();
+                process.exit(0);
+            }
+        }
+    }
+    return options;
+}
+function printHelp() {
+    console.log(`
+Report Oversized Entities CLI
+
+Usage:
+  npm run kg:oversized [options]
+
+Options:
+  --limit <n>        Scan and rank the N largest entities (default: 50)
+  --warn-ratio <r>   Fraction of the cap (0.0-1.0) for the WARN threshold (default: 0.8)
+  --include-ok       Include entities below the warn threshold
+  --json             Output machine-readable JSON instead of a table
+  --help             Show this help message
+
+Environment Variables:
+  MAX_MCP_OUTPUT_TOKENS     Assumed open_nodes cap in tokens (default: 25000)
+  ENTITY_SIZE_WARN_RATIO    WARN threshold ratio (default: 0.8)
+  ENTITY_SIZE_CRITICAL_RATIO CRITICAL threshold ratio (default: 1.0)
+  ENTITY_SIZE_SCAN_LIMIT    Default scan size (default: 50)
+  NEO4J_URI / NEO4J_USERNAME / NEO4J_PASSWORD / NEO4J_DATABASE
+
+Exit code: 1 if any CRITICAL entity exists, else 0.
+  `);
+}
+function pad(value, width) {
+    return value.length >= width ? value : value + ' '.repeat(width - value.length);
+}
+function printTable(reports, cap) {
+    if (reports.length === 0) {
+        console.log('✅ No entities at or near the open_nodes cap.\n');
+        return;
+    }
+    console.log(`\nAssumed open_nodes cap: ~${cap} tokens\n`);
+    console.log(`${pad('STATE', 9)}${pad('~TOKENS', 10)}${pad('%CAP', 7)}${pad('OBS', 6)}${pad('TYPE', 18)}NAME`);
+    console.log('-'.repeat(90));
+    for (const r of reports) {
+        const icon = r.state === 'CRITICAL' ? '🔴' : r.state === 'WARN' ? '🟡' : '🟢';
+        console.log(`${pad(`${icon} ${r.state}`, 9)}${pad(String(r.estTokens), 10)}${pad(`${Math.round(r.ratio * 100)}%`, 7)}${pad(String(r.obsCount), 6)}${pad((r.entityType || '-').slice(0, 16), 18)}${r.name}`);
+    }
+    console.log('');
+}
+async function run() {
+    const options = parseArgs();
+    const cfg = getEntitySizeConfig({
+        scanLimit: options.limit,
+        warnRatio: options.warnRatio,
+    });
+    const storageProvider = new Neo4jStorageProvider({
+        config: {
+            uri: process.env.NEO4J_URI || 'bolt://localhost:7687',
+            username: process.env.NEO4J_USERNAME || 'neo4j',
+            password: process.env.NEO4J_PASSWORD || '',
+            database: process.env.NEO4J_DATABASE || 'neo4j',
+        },
+    });
+    try {
+        const rows = await storageProvider.scanEntitySizes(cfg.scanLimit);
+        const names = rows.map(r => r.name);
+        const entityByName = new Map();
+        if (names.length > 0) {
+            const graph = await storageProvider.openNodes(names);
+            for (const e of graph.entities) {
+                entityByName.set(e.name, e);
+            }
+        }
+        let reports = rows.map(row => {
+            const entity = entityByName.get(row.name);
+            return entity ? estimateEntitySize(entity, cfg) : estimateFromCharCount(row, cfg);
+        });
+        reports.sort((a, b) => b.estTokens - a.estTokens);
+        if (!options.includeOk) {
+            reports = reports.filter(r => r.state !== 'OK');
+        }
+        const criticalCount = reports.filter(r => r.state === 'CRITICAL').length;
+        if (options.json) {
+            console.log(JSON.stringify({
+                assumedCap: cfg.maxTokens,
+                warnRatio: cfg.warnRatio,
+                criticalRatio: cfg.criticalRatio,
+                scanned: rows.length,
+                flaggedCount: reports.filter(r => r.state !== 'OK').length,
+                criticalCount,
+                entities: reports,
+                restructureHint: RESTRUCTURE_HINT,
+            }, null, 2));
+        }
+        else {
+            printTable(reports, cfg.maxTokens);
+            if (criticalCount > 0) {
+                console.log(`⚠️  ${criticalCount} CRITICAL entity(ies) — ${RESTRUCTURE_HINT}\n`);
+            }
+        }
+        return criticalCount > 0 ? 1 : 0;
+    }
+    finally {
+        await storageProvider.close();
+    }
+}
+run()
+    .then(code => process.exit(code))
+    .catch(error => {
+    console.error('❌ report-oversized failed:', error instanceof Error ? error.message : error);
+    process.exit(2);
+});
+//# sourceMappingURL=report-oversized.js.map

package/dist/cli/report-oversized.js.map

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

package/dist/config/entitySize.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Configuration for entity-size flagging.
+ *
+ * The MCP `open_nodes` response is bounded by the client/harness output cap
+ * (default 25,000 tokens). An entity whose own serialized form approaches that
+ * cap risks becoming unretrievable via `open_nodes(["Name"])`. These settings
+ * drive the early-warning thresholds used by `flag_oversized_entities`, the
+ * on-write warnings, and the `report-oversized` CLI.
+ *
+ * All values are advisory: the estimate is a conservative chars-per-token
+ * heuristic (see EntitySizeService), not a reproduction of the harness tokenizer.
+ */
+/**
+ * Resolved entity-size configuration (frozen).
+ */
+export interface EntitySizeConfig {
+    /** Assumed MCP output cap in tokens (MAX_MCP_OUTPUT_TOKENS). */
+    maxTokens: number;
+    /** Ratio of the cap at/above which an entity is flagged WARN (0-1). */
+    warnRatio: number;
+    /** Ratio of the cap at/above which an entity is flagged CRITICAL (>= warnRatio). */
+    criticalRatio: number;
+    /** When true, write tools append non-fatal size warnings for touched entities. */
+    warnOnWrite: boolean;
+    /** Number of largest entities to scan/rank per pass. */
+    scanLimit: number;
+}
+/** Per-call overrides accepted by tools/CLI (all optional). */
+export interface EntitySizeConfigOverrides {
+    maxTokens?: number;
+    warnRatio?: number;
+    criticalRatio?: number;
+    warnOnWrite?: boolean;
+    scanLimit?: number;
+}
+/**
+ * Resolve the entity-size configuration from environment variables, applying
+ * optional per-call overrides on top. Values are validated and clamped so a bad
+ * input never produces nonsensical thresholds.
+ *
+ * @param overrides Optional per-call overrides (e.g. tool arguments)
+ * @returns A frozen, validated EntitySizeConfig
+ */
+export declare function getEntitySizeConfig(overrides?: EntitySizeConfigOverrides): EntitySizeConfig;

package/dist/config/entitySize.js

@@ -0,0 +1,77 @@
+/**
+ * Configuration for entity-size flagging.
+ *
+ * The MCP `open_nodes` response is bounded by the client/harness output cap
+ * (default 25,000 tokens). An entity whose own serialized form approaches that
+ * cap risks becoming unretrievable via `open_nodes(["Name"])`. These settings
+ * drive the early-warning thresholds used by `flag_oversized_entities`, the
+ * on-write warnings, and the `report-oversized` CLI.
+ *
+ * All values are advisory: the estimate is a conservative chars-per-token
+ * heuristic (see EntitySizeService), not a reproduction of the harness tokenizer.
+ */
+const DEFAULTS = {
+    maxTokens: 25_000,
+    warnRatio: 0.8,
+    criticalRatio: 1.0,
+    warnOnWrite: true,
+    scanLimit: 50,
+};
+function intEnv(name, fallback) {
+    const raw = process.env[name];
+    if (raw === undefined || raw === '') {
+        return fallback;
+    }
+    const parsed = Number.parseInt(raw, 10);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
+function floatEnv(name, fallback) {
+    const raw = process.env[name];
+    if (raw === undefined || raw === '') {
+        return fallback;
+    }
+    const parsed = Number.parseFloat(raw);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
+function boolEnv(name, fallback) {
+    const raw = process.env[name];
+    if (raw === undefined || raw === '') {
+        return fallback;
+    }
+    return raw.toLowerCase() === 'true' || raw === '1';
+}
+/**
+ * Resolve the entity-size configuration from environment variables, applying
+ * optional per-call overrides on top. Values are validated and clamped so a bad
+ * input never produces nonsensical thresholds.
+ *
+ * @param overrides Optional per-call overrides (e.g. tool arguments)
+ * @returns A frozen, validated EntitySizeConfig
+ */
+export function getEntitySizeConfig(overrides) {
+    const maxTokens = overrides?.maxTokens ?? intEnv('MAX_MCP_OUTPUT_TOKENS', DEFAULTS.maxTokens);
+    let warnRatio = overrides?.warnRatio ?? floatEnv('ENTITY_SIZE_WARN_RATIO', DEFAULTS.warnRatio);
+    let criticalRatio = overrides?.criticalRatio ?? floatEnv('ENTITY_SIZE_CRITICAL_RATIO', DEFAULTS.criticalRatio);
+    const warnOnWrite = overrides?.warnOnWrite ?? boolEnv('ENTITY_SIZE_WARN_ON_WRITE', DEFAULTS.warnOnWrite);
+    const scanLimit = overrides?.scanLimit ?? intEnv('ENTITY_SIZE_SCAN_LIMIT', DEFAULTS.scanLimit);
+    // Clamp ratios into a sane range and keep critical >= warn.
+    warnRatio = Math.min(Math.max(warnRatio, 0.01), 2);
+    criticalRatio = Math.min(Math.max(criticalRatio, 0.01), 4);
+    if (criticalRatio < warnRatio) {
+        criticalRatio = warnRatio;
+    }
+    // Upper-clamp scanLimit: it bounds both how many entities the refine step
+    // hydrates AND how many size rows the tool returns. Too large a value would
+    // let flag_oversized_entities' own response approach the very cap it polices
+    // (especially with include_ok). SCAN_LIMIT_MAX rows stay well under it.
+    const SCAN_LIMIT_MAX = 200;
+    const boundedScanLimit = scanLimit > 0 ? Math.min(scanLimit, SCAN_LIMIT_MAX) : DEFAULTS.scanLimit;
+    return Object.freeze({
+        maxTokens: maxTokens > 0 ? maxTokens : DEFAULTS.maxTokens,
+        warnRatio,
+        criticalRatio,
+        warnOnWrite,
+        scanLimit: boundedScanLimit,
+    });
+}
+//# sourceMappingURL=entitySize.js.map

package/dist/config/entitySize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entitySize.js","sourceRoot":"","sources":["../../src/config/entitySize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA2BH,MAAM,QAAQ,GAAqB;IACjC,SAAS,EAAE,MAAM;IACjB,SAAS,EAAE,GAAG;IACd,aAAa,EAAE,GAAG;IAClB,WAAW,EAAE,IAAI;IACjB,SAAS,EAAE,EAAE;CACd,CAAC;AAEF,SAAS,MAAM,CAAC,IAAY,EAAE,QAAgB;IAC5C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;QACpC,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACxC,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;AACnE,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,QAAgB;IAC9C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;QACpC,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACtC,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;AACnE,CAAC;AAED,SAAS,OAAO,CAAC,IAAY,EAAE,QAAiB;IAC9C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;QACpC,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,GAAG,CAAC,WAAW,EAAE,KAAK,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC;AACrD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAqC;IACvE,MAAM,SAAS,GAAG,SAAS,EAAE,SAAS,IAAI,MAAM,CAAC,uBAAuB,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC9F,IAAI,SAAS,GAAG,SAAS,EAAE,SAAS,IAAI,QAAQ,CAAC,wBAAwB,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC/F,IAAI,aAAa,GACf,SAAS,EAAE,aAAa,IAAI,QAAQ,CAAC,4BAA4B,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;IAC7F,MAAM,WAAW,GACf,SAAS,EAAE,WAAW,IAAI,OAAO,CAAC,2BAA2B,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IACvF,MAAM,SAAS,GAAG,SAAS,EAAE,SAAS,IAAI,MAAM,CAAC,wBAAwB,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAE/F,4DAA4D;IAC5D,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IACnD,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3D,IAAI,aAAa,GAAG,SAAS,EAAE,CAAC;QAC9B,aAAa,GAAG,SAAS,CAAC;IAC5B,CAAC;IAED,0EAA0E;IAC1E,4EAA4E;IAC5E,6EAA6E;IAC7E,wEAAwE;IACxE,MAAM,cAAc,GAAG,GAAG,CAAC;IAC3B,MAAM,gBAAgB,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC;IAElG,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,SAAS,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS;QACzD,SAAS;QACT,aAAa;QACb,WAAW;QACX,SAAS,EAAE,gBAAgB;KAC5B,CAAC,CAAC;AACL,CAAC"}

package/dist/maintenance/EntitySizeService.d.ts

@@ -0,0 +1,103 @@
+/**
+ * EntitySizeService — the single primitive for estimating how much of the MCP
+ * `open_nodes` output cap a knowledge-graph entity consumes.
+ *
+ * The cap (default MAX_MCP_OUTPUT_TOKENS = 25,000) is enforced by the MCP
+ * client/harness on the serialized tool RESPONSE, not by the server. An entity
+ * whose own serialized form approaches the cap risks becoming unretrievable via
+ * `open_nodes(["Name"])`, because that call fails closed above the cap.
+ *
+ * The estimate is deliberately dependency-free and conservative: it counts the
+ * characters of the entity as `open_nodes` serializes it (JSON, 2-space
+ * indented) and approximates tokens at chars / 4. Combined with a sub-1.0 warn
+ * ratio, this gives margin against the harness's real (unseen) tokenizer rather
+ * than false precision.
+ */
+import type { EntitySizeConfig } from '../config/entitySize.js';
+/** Three-state classification for an entity's size relative to the cap. */
+export type EntitySizeState = 'OK' | 'WARN' | 'CRITICAL';
+/** Minimal entity shape needed to estimate size (matches what open_nodes returns). */
+export interface SizeableEntity {
+    name: string;
+    entityType?: string;
+    domain?: string | null;
+    observations?: string[];
+}
+/** Per-entity size report. */
+export interface EntitySizeReport {
+    name: string;
+    entityType: string;
+    /** Characters of the entity as open_nodes serializes it (incl. wrapper overhead). */
+    charCount: number;
+    /** Estimated tokens (charCount / 4, rounded up). */
+    estTokens: number;
+    /** estTokens / cap. */
+    ratio: number;
+    state: EntitySizeState;
+    obsCount: number;
+    /** Size in characters of the single largest observation (the first thing to peel off). */
+    largestObservationChars: number;
+}
+/**
+ * Average characters per token. Dense technical / JSON content — paths, IPs,
+ * hex, code, plus the heavy punctuation and 2-space indentation of an
+ * `open_nodes` response — tokenizes at FEWER chars per token (more tokens per
+ * char) than the ~4 chars/token prose rule. Using too large a divisor
+ * UNDER-estimates tokens, which is the unsafe direction for an early warning.
+ *
+ * Calibration anchor: the documented `sgo-mac-studio` failure was ~73k
+ * serialized chars and EXCEEDED the 25,000-token cap (it failed `open_nodes`
+ * closed) ⇒ real density was < 2.93 chars/token for this KG's content. We pick
+ * 2.8 so that incident lands CRITICAL with margin (≈ WARN at ~56k chars,
+ * CRITICAL at ~70k chars), deliberately erring toward over-estimating tokens:
+ * a false WARN is cheap (you look and decide not to split) while a false OK is
+ * the missed-unretrievability catastrophe the feature exists to prevent.
+ * Exported so tests assert behaviour relative to it rather than a magic number.
+ */
+export declare const CHARS_PER_TOKEN = 2.8;
+/** Convert a character count to an estimated token count. */
+export declare function estimateTokensFromChars(charCount: number): number;
+/** Classify a token estimate against the configured thresholds. */
+export declare function classifySize(estTokens: number, cfg: EntitySizeConfig): EntitySizeState;
+/**
+ * Character length of a single entity as `open_nodes` ACTUALLY serializes it:
+ * the entity nested inside the `{ entities: [ … ], relations: [], total, timeTaken }`
+ * response envelope, 2-space indented. Nesting matters — each observation sits
+ * at 8-space indentation in the real response (array-in-entity-in-array), which
+ * a top-level slice would undercount by ~4 chars per observation.
+ *
+ * open_nodes' nodeToEntity does NOT include the embedding vector, but it DOES
+ * include the temporal/identity fields (id, version, timestamps, changedBy);
+ * representative placeholder values are included so the char count matches a
+ * real response without needing the live values. A single-name open_nodes
+ * attaches only self-loop relations, so relations are omitted (empty), making
+ * this the per-entity retrievability cost. Observations dominate.
+ */
+export declare function serializedEntityChars(entity: SizeableEntity): number;
+/**
+ * Build a precise size report for a single entity.
+ *
+ * @param entity The entity (as open_nodes would return it)
+ * @param cfg Resolved entity-size configuration
+ * @returns The entity's size report
+ */
+export declare function estimateEntitySize(entity: SizeableEntity, cfg: EntitySizeConfig): EntitySizeReport;
+/**
+ * Build an approximate size report from a raw character count (the storage-layer
+ * scan path, where full observation text was deliberately not materialized).
+ *
+ * @param row Compact ranking row from the storage scan
+ * @param cfg Resolved entity-size configuration
+ * @returns An approximate size report (precise fields refined elsewhere)
+ */
+export declare function estimateFromCharCount(row: {
+    name: string;
+    entityType?: string;
+    approxChars: number;
+    obsCount?: number;
+}, cfg: EntitySizeConfig): EntitySizeReport;
+/**
+ * Human-readable guidance for restructuring an oversized entity, included in
+ * tool/CLI output. Restructuring stays a manual/agent judgement call.
+ */
+export declare const RESTRUCTURE_HINT: string;

package/dist/maintenance/EntitySizeService.js

@@ -0,0 +1,143 @@
+/**
+ * EntitySizeService — the single primitive for estimating how much of the MCP
+ * `open_nodes` output cap a knowledge-graph entity consumes.
+ *
+ * The cap (default MAX_MCP_OUTPUT_TOKENS = 25,000) is enforced by the MCP
+ * client/harness on the serialized tool RESPONSE, not by the server. An entity
+ * whose own serialized form approaches the cap risks becoming unretrievable via
+ * `open_nodes(["Name"])`, because that call fails closed above the cap.
+ *
+ * The estimate is deliberately dependency-free and conservative: it counts the
+ * characters of the entity as `open_nodes` serializes it (JSON, 2-space
+ * indented) and approximates tokens at chars / 4. Combined with a sub-1.0 warn
+ * ratio, this gives margin against the harness's real (unseen) tokenizer rather
+ * than false precision.
+ */
+/**
+ * Average characters per token. Dense technical / JSON content — paths, IPs,
+ * hex, code, plus the heavy punctuation and 2-space indentation of an
+ * `open_nodes` response — tokenizes at FEWER chars per token (more tokens per
+ * char) than the ~4 chars/token prose rule. Using too large a divisor
+ * UNDER-estimates tokens, which is the unsafe direction for an early warning.
+ *
+ * Calibration anchor: the documented `sgo-mac-studio` failure was ~73k
+ * serialized chars and EXCEEDED the 25,000-token cap (it failed `open_nodes`
+ * closed) ⇒ real density was < 2.93 chars/token for this KG's content. We pick
+ * 2.8 so that incident lands CRITICAL with margin (≈ WARN at ~56k chars,
+ * CRITICAL at ~70k chars), deliberately erring toward over-estimating tokens:
+ * a false WARN is cheap (you look and decide not to split) while a false OK is
+ * the missed-unretrievability catastrophe the feature exists to prevent.
+ * Exported so tests assert behaviour relative to it rather than a magic number.
+ */
+export const CHARS_PER_TOKEN = 2.8;
+/**
+ * Fixed envelope overhead (chars) added to the storage-scan APPROXIMATE path,
+ * which has only the observation-char total — not the full serialized entity.
+ * Covers the `{ entities: [ { name, type, domain, temporal fields… } ], ... }`
+ * structure around the observations. The precise path serializes the real
+ * shape directly (see serializedEntityChars) and does not use this.
+ */
+const APPROX_ENVELOPE_CHARS = 320;
+/** Convert a character count to an estimated token count. */
+export function estimateTokensFromChars(charCount) {
+    return Math.ceil(Math.max(charCount, 0) / CHARS_PER_TOKEN);
+}
+/** Classify a token estimate against the configured thresholds. */
+export function classifySize(estTokens, cfg) {
+    const ratio = estTokens / cfg.maxTokens;
+    if (ratio >= cfg.criticalRatio) {
+        return 'CRITICAL';
+    }
+    if (ratio >= cfg.warnRatio) {
+        return 'WARN';
+    }
+    return 'OK';
+}
+/**
+ * Character length of a single entity as `open_nodes` ACTUALLY serializes it:
+ * the entity nested inside the `{ entities: [ … ], relations: [], total, timeTaken }`
+ * response envelope, 2-space indented. Nesting matters — each observation sits
+ * at 8-space indentation in the real response (array-in-entity-in-array), which
+ * a top-level slice would undercount by ~4 chars per observation.
+ *
+ * open_nodes' nodeToEntity does NOT include the embedding vector, but it DOES
+ * include the temporal/identity fields (id, version, timestamps, changedBy);
+ * representative placeholder values are included so the char count matches a
+ * real response without needing the live values. A single-name open_nodes
+ * attaches only self-loop relations, so relations are omitted (empty), making
+ * this the per-entity retrievability cost. Observations dominate.
+ */
+export function serializedEntityChars(entity) {
+    const slice = {
+        name: entity.name,
+        entityType: entity.entityType ?? '',
+        domain: entity.domain ?? null,
+        observations: entity.observations ?? [],
+        // Representative placeholders for the temporal/identity fields nodeToEntity
+        // returns — present so indentation + field overhead match a real response.
+        id: '00000000-0000-0000-0000-000000000000',
+        version: 1,
+        createdAt: 1700000000000,
+        updatedAt: 1700000000000,
+        validFrom: 1700000000000,
+        validTo: null,
+        changedBy: null,
+    };
+    const response = { entities: [slice], relations: [], total: 1, timeTaken: 0 };
+    return JSON.stringify(response, null, 2).length;
+}
+/**
+ * Build a precise size report for a single entity.
+ *
+ * @param entity The entity (as open_nodes would return it)
+ * @param cfg Resolved entity-size configuration
+ * @returns The entity's size report
+ */
+export function estimateEntitySize(entity, cfg) {
+    const observations = entity.observations ?? [];
+    const charCount = serializedEntityChars(entity);
+    const estTokens = estimateTokensFromChars(charCount);
+    const largestObservationChars = observations.reduce((max, obs) => Math.max(max, (obs ?? '').length), 0);
+    return {
+        name: entity.name,
+        entityType: entity.entityType ?? '',
+        charCount,
+        estTokens,
+        ratio: estTokens / cfg.maxTokens,
+        state: classifySize(estTokens, cfg),
+        obsCount: observations.length,
+        largestObservationChars,
+    };
+}
+/**
+ * Build an approximate size report from a raw character count (the storage-layer
+ * scan path, where full observation text was deliberately not materialized).
+ *
+ * @param row Compact ranking row from the storage scan
+ * @param cfg Resolved entity-size configuration
+ * @returns An approximate size report (precise fields refined elsewhere)
+ */
+export function estimateFromCharCount(row, cfg) {
+    const charCount = Math.max(row.approxChars, 0) + APPROX_ENVELOPE_CHARS;
+    const estTokens = estimateTokensFromChars(charCount);
+    return {
+        name: row.name,
+        entityType: row.entityType ?? '',
+        charCount,
+        estTokens,
+        ratio: estTokens / cfg.maxTokens,
+        state: classifySize(estTokens, cfg),
+        obsCount: row.obsCount ?? 0,
+        largestObservationChars: 0,
+    };
+}
+/**
+ * Human-readable guidance for restructuring an oversized entity, included in
+ * tool/CLI output. Restructuring stays a manual/agent judgement call.
+ */
+export const RESTRUCTURE_HINT = 'Split oversized entities into themed sibling entities linked by relations: ' +
+    'group related observations under new, more specific entity names, then connect ' +
+    'them with create_relations (e.g. part-of / relates-to). Dedup with open_nodes ' +
+    'before creating. CRITICAL entities already exceed the cap and cannot be fetched ' +
+    'whole via open_nodes — split them first.';
+//# sourceMappingURL=EntitySizeService.js.map

package/dist/maintenance/EntitySizeService.js.map

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

package/dist/schemas/index.d.ts

@@ -97,12 +97,20 @@ export declare const SearchNodesInputSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type SearchNodesInput = z.infer<typeof SearchNodesInputSchema>;
 /**
- * Schema for semantic_search tool input
+ * Schema for semantic_search tool input.
+ *
+ * v2.7.1: aligned with the reranker-aware default semantics — `limit` and
+ * `minSimilarity` carry NO schema defaults so an absent value stays undefined
+ * through the handler and the manager resolves it reranker-aware (limit:
+ * 10 plain / RERANK_TOP_K reranked; minSimilarity: 0). A schema `.default()`
+ * here would silently resurrect pre-2.7.0 behaviour if this schema is ever
+ * wired into the handler path. `limit` accepts 0 (explicit empty result) and
+ * non-negative values; the manager floors/clamps at runtime.
  */
 export declare const SemanticSearchInputSchema: z.ZodObject<{
     query: z.ZodString;
-    limit: z.ZodDefault<z.ZodNumber>;
-    minSimilarity: z.ZodDefault<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    minSimilarity: z.ZodOptional<z.ZodNumber>;
     domain: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type SemanticSearchInput = z.infer<typeof SemanticSearchInputSchema>;

package/dist/schemas/index.js

@@ -91,12 +91,21 @@ export const SearchNodesInputSchema = z.object({
     domain: z.string().optional(),
 });
 /**
- * Schema for semantic_search tool input
+ * Schema for semantic_search tool input.
+ *
+ * v2.7.1: aligned with the reranker-aware default semantics — `limit` and
+ * `minSimilarity` carry NO schema defaults so an absent value stays undefined
+ * through the handler and the manager resolves it reranker-aware (limit:
+ * 10 plain / RERANK_TOP_K reranked; minSimilarity: 0). A schema `.default()`
+ * here would silently resurrect pre-2.7.0 behaviour if this schema is ever
+ * wired into the handler path. `limit` accepts 0 (explicit empty result) and
+ * non-negative values; the manager floors/clamps at runtime.
  */
 export const SemanticSearchInputSchema = z.object({
     query: z.string().min(1, 'Search query is required'),
-    limit: z.number().int().positive().max(100).default(10),
-    minSimilarity: z.number().min(0).max(1).default(0.6),
+    // No max: the live tool contract honours any explicit limit exactly.
+    limit: z.number().min(0).optional(),
+    minSimilarity: z.number().min(0).max(1).optional(),
     domain: z.string().optional(),
 });
 // =============================================================================

package/dist/schemas/index.js.map

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