Upgrade Wolbarg — 0.5 → 0.6 production hardening, earlier additive upgrades, and AgentOrc → Wolbarg rebrand notes.

What is it?

Guides for moving between Wolbarg releases. Start with 0.5 → 0.6 if you are current; older sections cover earlier upgrades.

0.5 → 0.6 (breaking)

npm install wolbarg@0.6.0
# remove if you only used it for Wolbarg graph
npm uninstall neo4j-driver

Area	Action
Graph APIs	Remove `graph`, `sqliteGraph`, `neo4jGraph`, `linkMemories`, `getRelated`, `includeGraph`
Hybrid / rerank	Ensure `keywordSearch` / `reranker` are configured when flags are set — fail-closed
Rerank errors	Catch `RerankError` instead of assuming soft / identity fallback
Postgres remote	Expect TLS (`sslmode=require`) unless you override with `ssl`
Pool size	Raise `maxPoolSize` if you relied on the old default of 64 (now 20)
Telemetry	Set `captureQueries: true` if you need query strings persisted
Multi-org SQLite	One file per organization for export / checkpoint / import / rollback
AbortSignal	Optional on remember / recall / update / compress / forget

From 0.5.x without graph:

npm install wolbarg@0.6.0

Most remember / recall call sites need no changes. Review hybrid, rerank, and Postgres SSL settings.

Deep dive: What's New · Production · Graph memory (removed).

0.4 → 0.5 (historical)

npm install wolbarg@^0.5.0

0.5 introduced optional graph memory. That layer was removed again in 0.6.0 — do not add new graph call sites. If you are jumping from 0.4 directly to 0.6, skip graph entirely and follow the 0.5 → 0.6 table above for fail-closed hybrid/rerank and Postgres defaults.

Feature (0.5)	Status in 0.6
Graph memory	Removed
`linkMemories` / `getRelated` / `includeGraph`	Removed
Framework adapters (`@wolbarg/*`)	Separate packages — unchanged

0.3 → 0.4 (additive)

npm install wolbarg@^0.4.0

No required code changes. Schema migrates automatically on open.

Feature	Default	Action needed
Embedding cache	On	Disable with `embeddingCache: { enabled: false }` if unwanted
Memory dedupe / upsert	Off	Opt in via `memory.dedupe`
`concurrency` tuning	Sensible defaults	Optional
`subscribe()` / `update()`	—	Opt in when needed
`RememberResult.action`	Always present	Ignore safely if unused

Behavior notes

remember() / rememberBatch() still return a full MemoryRecord; they additionally include action: "created" | "updated".
SQLite writers now use BEGIN IMMEDIATE — safer under multi-process contention; may change latency shape under lock storms (see Concurrency).
New history event "updated" appears when upserts run.

Guides: Concurrency · Real-time events · Embedding cache · Memory upsert.

0.3 — AgentOrc → Wolbarg

npm uninstall agentorc
npm install wolbarg

// before
import { AgentOrc } from "agentorc";
const ctx = new AgentOrc({ /* … */ });

// after
import { Wolbarg, wolbarg } from "wolbarg";
const ctx = wolbarg({ /* … */ });

Class / options / error: AgentOrc* → Wolbarg*
Site: wolbarg.com
GitHub: wolbarg/wolbarg
Internal meta table: agentorc_meta → wolbarg_meta (recreate DBs or migrate)

0.1 → 0.2 breaking changes

llm is no longer required to operate the SDK
Constructor instances without llm do not type compress
stats().llmModel may be null
Package version is 0.2.x+

API mapping (0.1 → 0.2)

// 0.1
const ctx = new Wolbarg();
await ctx.init({ organization, database, embedding, llm });

// 0.2+ (recommended)
import { wolbarg, sqlite, openaiEmbedding, openaiLlm } from "wolbarg";

const ctx = wolbarg({
  organization,
  storage: sqlite("./memory.db"),
  embedding: openaiEmbedding({ /* … */ }),
  llm: openaiLlm({ /* … */ }), // optional
});

// init() still works for compatibility

Schema

Version	Notes
v2	FTS5 hybrid
v3+	`content_hash`, `embedding_cache`, history `"updated"`
v4	drop unused global `created_at` index; strip archived vectors from ANN; add agent-active covering index

SQLite auto-migrates on open. Embedding dimension changes still require a fresh DB.

Method names (remember / recall / …) are unchanged. New optional fields are additive unless called out in the 0.5 → 0.6 section.

Migration