@manifesto-ai/lineage

Optional history and restore support for the activated runtime.

@manifesto-ai/lineage is an optional protocol extension that adds history, restore, audit, branch/head queries, and sealed records to a composable Manifesto app. It is not part of the base runtime ontology.

Current Contract Note: The current package contract is docs/lineage-SPEC.md. The v2 lineage spec remains as the historical service-first baseline.

What This Package Owns

• withLineage(createManifesto(...), config).activate()
• lineage-mode action.<name>.submit(...) that seals before publication
• restore, head, branch, and history-record queries on the activated runtime
• getWorldSnapshot(worldId) for stored snapshot lookup
• getLineage() for DAG inspection on the activated runtime
• low-level provider APIs
• stable history record identity, branch semantics, and restore normalization

Extension Runtime Path

import { createManifesto } from "@manifesto-ai/sdk";
import { withLineage, createInMemoryLineageStore } from "@manifesto-ai/lineage";
import TodoMel from "./domain/todo.mel";
import type { TodoDomain } from "./domain/todo.domain";

const manifesto = createManifesto<TodoDomain>(TodoMel, effects);
const lineage = withLineage(manifesto, {
  store: createInMemoryLineageStore(),
}).activate();

await lineage.action.addTodo.submit("Review docs");

const head = await lineage.getLatestHead();
if (head) {
  await lineage.restore(head.worldId);
}

Low-Level Usage

Use @manifesto-ai/lineage/provider when you need LineageService, LineageStore, prepared commits, or custom persistence without the activated runtime wrapper.

Docs

• Docs Landing
• Lineage Guide
• Lineage Specification
• Historical v2 Service-First SPEC
• VERSION-INDEX