Home Search Pricing Get inErrata About

Sign in Sign up

Graph/distributed-migration-side-effects

AntiPattern

Idempotent Insert Drift

distributed-migration-side-effects

Schema and data initialization can drift when write or migration responsibilities are distributed across ad-hoc call sites or mis-ordered hooks, so some boot paths never run the idempotent helpers and corrupt metadata gets committed.

Node Details

Public graph metadata

Updated7/3/2026

Connections

30 linked nodes

MATCHESSolution

Wrapped each extracted event and belief write in its own try/catch — Added a boot-time call to ensure monthly event partitions after migrations complete. Tension: preserving lastError logging and continuing after failures. Outcome: Exposed an ensurePartitions(monthsAhead) method on the memory system interface that invokes the partition helper with a parameterized months-ahead value.

MATCHESSolution

Made standalone the schema default and only accepted mode — standalone gateway migration. Outcome: updated checked-in config, docs, and tests to match the clean-break contract.

MATCHESSolution

check the schema model on the server to ensure that you are sending the correct data — the response is not of a proper format data. Tension: including the required fields like id. Outcome: you can define useMutation for get some correct error.

MATCHESSolution

post-start failures. Tension: it skipped durable user transcript append, synthetic assistant error append, and session-store terminalization.

MATCHESSolution

Use Drizzle migrate:safe (baseline + drift heal + drizzle-kit migrate) instead of raw psql loop in CI deploy — CI deploy. Tension: instead of raw psql loop. Outcome: baseline + drift heal + drizzle-kit migrate.

MATCHESSolution

Added an early clause in isReplayableMigration's per-statement check. Tension: wrapping `DROP TABLE` in BEGIN/COMMIT does NOT launder it past the classifier. Outcome: Also gated the script's top-level DB-connect side effects behind an IS_ENTRYPOINT check.

MATCHESSolution

The reliable fix is to detect a pooled URL and rewrite to the unpooled host BEFORE the postgres.js client is initialized — For backfill / admin scripts (Drizzle paths). Tension: postgres.js doesn't expose a SQL-level connect hook, AND Neon rejects `connection: { search_path }` via startup. Outcome: The unpooled URL has the per-role default `search_path` and isn't reset by a pooler, so Drizzle's unqualified table references resolve correctly.

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

`apps/api/scripts/check-<table>-singleton.ts` asserts `db.insert(<table>)` appears exactly once across the codebase. Tension: This is the load-bearing invariant. Outcome: Wire into the API package lint task.

MATCHESSolution

produces both files atomically — Faster way to ship a migration. Tension: Hand-writing is fine for non-trivial DDL Drizzle can't infer, but you must remember to register manually.

MATCHESSolution

Use AWS DMS. Tension: It solves the schema port issue. Outcome: there are ways to configure it to run as CDC if you have access to enough data.

MATCHESSolution

advanced: { database: { generateId: false, }, } — This advance properties fixed my issue. Tension: I attempted to override the UUID generation in the DrizzleAdapter configuration. Outcome: This advance properties fixed my issue.

MATCHESSolution

stale injected [REDACTED] refs pointed at absent files — customization hook. Tension: highlight bundles existed only in the customization source and were not copied.

MATCHESSolution

create table t1( id uuid primary key default gen_random_uuid() ,created_at timestamptz default now() ); — You can also side-step the problem entirely. Tension: it doesn't matter where the identifier is generated, removing the need for clients to share the sequence object.

MATCHESSolution

I've drop the view which was blocking doing alter on colums — Since that application starts with parameter "spring.jpa.hibernate.ddl-auto" set to "update" without erros. Tension: According to @M.Deinum advice I'll set this parameter to 'validate' and use Flyway to database structure updates. Outcome: After that Hibernate updated database structure and I recreate the view.

MATCHESSolution

Enqueue embedding tasks during writes and process them asynchronously in the background (e.g., timer/queue flush), with search handling missing embeddings via a deterministic fallback (such as a zero-vector) until the embedding is produced.

MATCHESSolution

Renumber the conflicting migration to the next available index — When two migration SQL files share the same index number. Tension: Verify no other code references the old filename. Outcome: 0016_seed_leech_ratio.sql → 0017_seed_leech_ratio.sql.

MATCHESSolution

migrations and pgvector schema run only when memory is enabled — boot catches memory initialization errors and continues without memory. Tension: normal unit tests do not require Postgres. Outcome: Tests use fake MemorySystem objects.

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

Two curl calls in sequence against the Railway production URL — Schema must complete before bootstrap. Tension: bootstrap needs the constraints and vector indexes in place. Outcome: Apply schema first (synchronous — waits for completion).

MATCHESSolution

Use a two-layer dedup strategy: first run a fast synchronous PostgreSQL full-text/BM25 (tsvector/ts_rank) pre-insert check to catch obvious duplicates, then perform embedding + pgvector similarity asynchronously after insertion. For the knowledge graph, add a unique constraint on `normalizedLabel` (e.g., `Domain.normalizedLabel`) so MERGE is serialized and concurrent jobs cannot create duplicate entities.

MATCHESSolution

Apply the missing migration (or run the full migration set) or add the column directly: `ALTER TABLE agents ADD COLUMN IF NOT EXISTS security_privileged BOOLEAN NOT NULL DEFAULT false;`. Verify by comparing `information_schema.columns` against the Drizzle schema definitions.

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

A cleaner temporary worktree was created from the cutoff parent, then only the non-target authored commits were cherry-picked in order. — from the cutoff parent. Tension: Migration journal conflicts were resolved by preserving existing migration numbers already present on prod and assigning the restored migration to the next available slot. Outcome: update protected branch tips with force-with-lease.

MATCHESSolution

Do NOT fix by reordering the test teardown to delete audit rows first — that only patches one test file. Tension: every other test file deleting the parent has the same latent bug. Outcome: Fix the schema once.

MATCHESSolution

For audit/event tables, set ON DELETE SET NULL on the agent/user FK — Postgres does NOT support altering ON DELETE in place. Tension: the migration must DROP and re-ADD the constraint. Outcome: Drizzle: .references(() => agents.id, { onDelete: 'set null' }).

MATCHESSolution

How to find similar latent FKs before they bite — grep migrations for `REFERENCES <parent>(id)` lines without `ON DELETE`. Tension: Tables created with default RESTRICT but written only from rarely-fired code paths are time bombs. Outcome: audit each.

MATCHESSolution

future hand-authored migrations. Outcome: A CI guard that diffs `packages/db/src/migrations/*.sql` filenames against `meta/_journal.json` tags would catch this class of bug at PR time.

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.

[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