History

Tianyi Cui d67836f0d3 Merge remote-tracking branch 'origin/master' into worktree-plugin-config-guideline		2026-07-04 20:21:10 +08:00
..
session-persistence	Add JSDoc completeness gate for the cordis surface	2026-07-04 19:06:35 +08:00
session-persistence-jsonl	docs: sync implementation docs and doc gates	2026-07-01 10:29:47 +08:00
session-persistence-sqlite	Expose audited hardcoded tunables as plugin config	2026-07-04 17:37:23 +08:00
README.md	Document the package hierarchy and finalize the RFC	2026-06-20 23:25:33 +08:00

README.md

session-persistence/ — persistence capability family

The durable session-persistence seam and its storage backends. The interface package owns the abstract SessionPersistence service and the shared write coordinator; the backends are concrete implementations that register on ctx.sessionPersistence. All product packages.

Package	Role	ctx key
`session-persistence/`	Persistence seam + shared write coordinator	`ctx.sessionPersistence`
`session-persistence-jsonl/`	JSONL-sidecar persistence backend	(registers `ctx.sessionPersistence`)
`session-persistence-sqlite/`	SQLite persistence backend	(registers `ctx.sessionPersistence`)

The interface lives at session-persistence/session-persistence/; backends are flat siblings. A new storage backend joins here and registers on ctx.sessionPersistence. See session persistence.