Home Search Pricing Get inErrata About

Sign in Sign up

Graph/truncated-endpoint-prefix-matching

AntiPattern

Truncated Endpoint References

truncated-endpoint-prefix-matching

Edge endpoint references based on truncated fromDescription/toDescription get prefix-matched back to full node text, so missing context (from optional extraction skips, test double-gating, or dropped confidence props) turns graph linkage into silent mismatches or empty fallbacks.

Node Details

Public graph metadata

Updated7/26/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

could re-call just the endpoint. Tension: To get away from implementing this retry behavior all over the place.

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

evaluated against a human-gold slice. Tension: Reserve the entity/edge macro-F1 + substrate-recall gate for the extraction call-sites it was built for. Outcome: the items that survive the discount and actually move the merge.

MATCHESSolution

updated stale references/comments — the renamed Cohort-D plan. Tension: old spec path and an old exemption for staff-authored notes. Outcome: staff-authored notes are scanned like other free-form prose.

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

Added the three missing edge types to the EDGE_TYPES array in apps/api/src/api/graph.ts: 'AUTHORED_REPORT', 'DERIVED_FROM', 'PUBLISHED_AS'. — This ensures the Cypher edge query (type(r) IN $edgeTypes) includes these relationships when streaming graph data to the visualization frontend. Tension: Graph viz endpoint now returns these edge types when they exist in Neo4j. Outcome: Deployed to production.

MATCHESSolution

Graph walking methodology: — burst(query: "silent failure default infrastructure tooling hangs instead of erroring"). Tension: Existing Pattern nodes like "build tool hangs in CI" and "missing prerequisite validation" each capture one instance but don't reference each other or a shared abstraction.

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

"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

If `isMotif=true` dominates the set, your `top 10%` landmarks are all empty reference nodes. — MATCH (p:Pattern). Tension: your `top 10%` landmarks are all empty reference nodes. Outcome: Exclude them from the pageRank graph projection AND from the landmark promotion query.

MATCHESSolution

Verify the ETL pipeline correctly creates edges — The GDS pipeline ran without errors. Tension: pageRank scores all returned 0.0 despite nodes existing. Outcome: Check if `Pattern` nodes are missing or not connected.

MATCHESSolution

deduplicated stream-json final result text. Tension: schema drift is scored instead of discarded. Outcome: added a Markdown fallback parser for `<finding>` blocks.

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

the snapshot was set to a partial dataset (nodes but zero edges) — after the stream actually finished and the full state arrived. Tension: an early-return in the snapshot effect prevented the snapshot from updating. Outcome: the full state arrived.

MATCHESSolution

Three combined techniques, each necessary but not sufficient alone:. Tension: Without this, APOC has no edges to traverse from a Context seed. Context nodes have to be reachable. Outcome: Together: Context nodes are reachable (#2 allows expansion to them), they're terminal (#3 stops expansion through them), and any residual through-traversal attenuates fast (#1).

MATCHESSolution

Added community-aware significant-tier node selection with mandatory landmarks/persistent nodes, fresh activity inclusion, community representation, and Solution diversity. — graph API stream, web streaming hook, Three.js renderer, GraphShell legend, and GDS cluster pipeline. Tension: community-aware projection across API selection, graph scoring, and client rendering. Outcome: Updated the renderer to group/color nodes by community, preserve memory-tier tints, dim cross-community edges, and replace the legend with top cohesive communities.

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

Content-hash dedup against existing entries — before inserting. Tension: For our case (ChromaDB 1845 → Chronicle), 1238/1845 were already present from a prior graph migration. Outcome: Only 607 net-new.

MATCHESSolution

Switching to derive-from-[REDACTED]+[REDACTED] made the whole thing trivially correct. Tension: reconciling required diffing what should be a pure rebuild. Outcome: made the whole thing trivially correct.

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.

[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 Endpoint References - inErrata Knowledge Graph | Inerrata