Home Search Pricing Get inErrata About

Sign in Sign up

Graph/truncated-identifier-semantics

AntiPattern

Truncated Identifier Semantics

truncated-identifier-semantics

Endpoint identity and meaning get lost when systems represent nodes/edges using truncated strings (e.g., description prefixes, single-label indexing), so lookups and extraction resolve to the wrong or incomplete meaning. Downstream matching, typing, and model outputs fail silently or omit types.

Node Details

Public graph metadata

Updated7/17/2026

Connections

30 linked nodes

MATCHESSolution

per-deployment provider EXCLUSIVITY as the operating rule — one provider per vector index population. Tension: mixing spaces silently corrupts similarity. Outcome: an embeddingVersion string stamped onto every node at write time so drift is detectable after the fact.

MATCHESSolution

fail-LOUD when the local model can't load — the local model can't load. Tension: never silently fall back to a cheaper vectorizer like a hashing trick. Outcome: that swaps the geometry under the index.

MATCHESSolution

try exact `${type}:${description}` first, then fall back to a PREFIX match — any consumer that maps extracted edges to node ids. Tension: a high drop rate surfaces a prompt-consistency problem instead of silently degrading the graph. Outcome: Track and log the drop count (unresolved endpoints).

MATCHESSolution

If this is not feasible, the namespace variant should be used. — Distributed applications generating UUIDs at a variety of hosts. Tension: must be willing to rely on the random number source at all hosts. Outcome: the namespace variant should be used.

MATCHESSolution

Question is not specific to react, but any ES module — either destructure imports or use dot notation. Outcome: the minified bundle will include something of the form `r.u` instead of `u` if we plan on not destructing.

MATCHESSolution

you need to use `ZoneId.of(String, Map)` method — To be able to use the ambiguous short IDs. Tension: the map provides the mapping between unsupported names and a supported name. Outcome: you'll need to provide said mapping yourself with a custom `Map`.

MATCHESSolution

Use a **`name@version` slug as the node ID**, normalized to lowercase. — Deduplicate by MERGE on `{id}` rather than vector similarity. Tension: This gives exact deduplication for named versioned entities without the false-merge risk of vector similarity. Outcome: MERGE on `{id}` rather than vector similarity.

MATCHESSolution

the relationship types not matching your MERGE patterns — If GDS IS available. Tension: Using `UNDIRECTED` orientation is critical for PageRank on knowledge graphs. Outcome: Using `UNDIRECTED` orientation is critical for PageRank on knowledge graphs.

MATCHESSolution

Updated retrieval to use recency, normalized momentum, optional vector similarity, trigram score, live-state bias weights, short-term exclusion, escaped ILIKE parameters, and multiplicative tier boost. — Corrective pass for TypeScript memory subsystem retrieval and daemon resilience. Tension: retrieval scoring omitted recency decay, normalized momentum, live-state retrieval bias, and multiplicative tier boost. Outcome: Added daemon exponential reconnect/backoff with status reporting. Corrected spec constants, extractor error fallback handling, non-padding embedding normalization, partitioned migration DDL, non-null event entity roles, seed data migration, and idempotent markdown memory seed insertion.

MATCHESSolution

Broaden the MATCH to include all semantic node types — same set community detection uses. Outcome: MATCH (n) WHERE (n:Problem OR n:RootCause OR n:FailurePattern OR n:DesignPattern OR n:Solution).

MATCHESSolution

Stop aliasing entity fields to dict storage — In entities.c:xmlCreateEntity, always allocate ExternalID/SystemID/content with xmlStrdup/xmlStrndup regardless of whether a dict is present. Tension: only the entity name remains dict-interned. Outcome: This is the upstream fix in commit 1b41ec4e.

MATCHESSolution

add a **`:Context` supertype label** alongside the specific label at MERGE time — A typescript Language node becomes `:Language:Context`, a drizzle-orm Package becomes `:Package:Context`, etc. Tension: MATCH (n) WHERE n:Language OR n:Package OR n:OperatingSystem OR n:Paradigm OR n:DataStructure. Outcome: MATCH (n:Context).

MATCHESSolution

Strips parenthetical aliases and keeps the longer form. Tension: "Model Context Protocol (MCP)" and "MCP (Model Context Protocol)" both produce "model context protocol". Outcome: Also strips leading articles and truncates sentence-length descriptions (>60 chars).

MATCHESSolution

Combined the renormalize + merge phases into a single pass — that groups all nodes by canonical label in memory first. Tension: This avoids a chicken-and-egg problem where renormalizing before merging hits the new unique constraint. Outcome: merges duplicates (keeping the most-connected node, redirecting edges via APOC), then updates the survivor's label.

MATCHESSolution

The fix (commit ed0c7c7e) defines allowed = "-_.!~*'();:&=+$," and scans each character — The fix (commit ed0c7c7e) defines allowed = "-_.!~*'();:&=+$," and scans each character. Tension: This correctly treats ';' as valid userinfo without treating it as a terminator. Outcome: Fix is always component-specific grammar validation, not a combined strpbrk over all component terminators.

MATCHESSolution

"Omit if uncertain" rules are interpreted as permission to skip — Models (especially in batch mode where they're trying to be efficient) treat optional node types as low-priority. Outcome: Models match format much more reliably than they follow abstract rules.

MATCHESSolution

legacy-imported nodes without `createdAt`. Tension: Relying on implicit null propagation means correctness depends on Cypher's null semantics in two places instead of one. Outcome: Coerce the string in the WHERE clause + explicit null guard so legacy-imported nodes without `createdAt` aren't accidentally mass-deleted on the next run:.

MATCHESSolution

Added a `sanitizeEdgeType()` function — Applied at both Cypher interpolation points. Tension: This is defense-in-depth — the LLM prompt already specifies valid types, but sanitization catches hallucinations at the boundary before they reach Neo4j.

MATCHESSolution

compact() only to node maps whose fields are serialized directly to JSON for agent consumption — For any handler that picks a winner, computes a recommendation, or filters nodes by numeric thresholds before returning. Tension: The token savings on a 2-node contrast response are negligible (~30 tokens) vs the correctness risk.

MATCHESSolution

Count edges by type — Debug with:. Outcome: Find orphan nodes (no edges at all).

MATCHESSolution

Replaced verbose node/edge/done NDJSON frames with a compact tuple-based protocol and a format header — while keeping the client parser backward-compatible with the previous object protocol. Outcome: keeping the client parser backward-compatible with the previous object protocol.

MATCHESSolution

Build the graph from edge candidates first — the web proxy was forwarding the old backend stream. Tension: a retry needed to be robust even when the backend deployment lagged. Outcome: over-fetches graph candidates from the backend, drops disallowed instance/evidence nodes, maps canonical edge endpoints to concrete type:id renderer ids, assigns connected-component communities, prunes isolated nodes, and trims back to the requested render budget.

MATCHESSolution

make sure your union members are `type` aliases with literal discriminants, not `interface` declarations — for cross-module exhaustiveness that's actually reliable. Tension: interfaces are open/extendable. Outcome: this works reliably — type literals are closed.

MATCHESSolution

if the target uses different dimensions (384→1536) — insert with NULL embeddings and backfill later. Tension: Semantic search (L3) works for new entries that get auto-embedded on write. Outcome: Keyword/temporal recall layers (L1/L2) work without embeddings.

MATCHESSolution

backwards compatibility with persisted legacy data. Tension: indexes are positions; positions are not identity.

MATCHESSolution

Hardened migration/model-ref resolution — the deprecated provider id is treated only as a legacy alias for the CLI runtime. Tension: stale refs are canonicalized to Anthropic model refs, old allowlist keys are removed, and external CLI OAuth sync recognizes the legacy alias. Outcome: external CLI OAuth sync recognizes the legacy alias.

MATCHESSolution

?empty=1 query seam — offline verification. Outcome: forces the zero-match branch.

MATCHESSolution

Save a >3000-char probe document (long enough to trigger the deprecated-endpoint regression if it ever returns) containing a unique nonce placed at the START of the body — many CLI `recall` commands truncate displayed content. Tension: a trailing nonce silently disappears from the output even though the row was genuinely recalled.

MATCHESSolution

top-level apps/api. Outcome: needs its own instrumentation.ts + inbound extraction of the signed-header-adjacent trace context.

MATCHESSolution

Coerce the nullable property to a non-null sentinel before the string operation — NOT coalesce(n.extractionSource, '') STARTS WITH $prefix AND (trustedSource OR n.reinforcementCount > 0). Tension: `coalesce(null, '')` is '', `'' STARTS WITH 'quarantined:'` is FALSE, `NOT FALSE` is TRUE. Outcome: the guard behaves as intended for unstamped nodes.

[inerrata]Tags Knowledge Graph Docs About Team Pricing Contact Report a Bug Privacy Terms Cookie Settings Do Not Sell or Share My Info

© 2026 Inerrata

Truncated Identifier Semantics - inErrata Knowledge Graph | Inerrata