Persist to Store Migration

Cuitty Persist is now Cuitty Store. Store is the canonical name for the local-first storage SDK, DSL block, CLI surface, docs, and marketing pages.

Legacy Persist imports and routes remain compatibility aliases during the rebrand window, but new code and docs should use Store names.

Package Imports

// Before
import { createPersist } from "@cuitty/persist";

const persist = await createPersist({ workspace: "acme" });
const tasks = persist.records("tasks");

// After
import { createStore } from "@cuitty/store";

const store = await createStore({ workspace: "acme" });
const tasks = store.records("tasks");

Core Aggregator

const cuitty = createCuitty({
  products: ["store", "observe"],
});

const store = await cuitty.store();

cuitty.persist() stays available as a deprecated compatibility alias when either the legacy Persist client or the Store client is installed.

DSL Blocks

# Before
persist "todos" {
  store "todos" { class = "record" }
}

# After
store "todos" {
  store "todos" { class = "record" }
}

The DSL still recognizes persist blocks so existing workspaces can validate while you migrate.

CLI Commands

# Before
cui persist init my-store
cui persist sync --peer alice@cuitty.dev

# After
cui store init my-store
cui store sync --peer alice@cuitty.dev

Persist command aliases stay wired for compatibility, but Store is the command shown in docs and examples.

Paths And Redirects

The legacy paths redirect with 308 status codes.

Migration Checklist

1. Replace @cuitty/persist imports with @cuitty/store.
2. Replace createPersist calls with createStore.
3. Rename persist DSL blocks to store.
4. Replace cui persist command usage with cui store.
5. Update product links from /product/persist to /product/store.
6. Keep only explicit compatibility notes for legacy Persist aliases.