@enteros/skill-ledger

SQLite-backed work ledger for the EnterOS skill framework: work items, append-only events, artifacts, runs, claim discipline, write discipline, and gate approvals (ledger schema v1.2). Skill tools use it to record and gate their work; the @enteros/skill-mcp server wires it in automatically.

Install

npm install @enteros/skill-ledger

@enteros/skill-core is a peer dependency:

npm install @enteros/skill-core @enteros/skill-ledger

Usage

Open (or create) a per-tenant ledger. Connections default to WAL, busy_timeout=5000, synchronous=NORMAL, foreign_keys=ON, and migrations are applied forward-only on open.

import { openLedger } from "@enteros/skill-ledger";

const ledger = openLedger({
  dataDir: process.env.ENTEROS_DATA_DIR!, // tenant state root
  tenant: "acme",                          // ^[a-z0-9-]+$
});

// In-memory mode for tests:
const test = openLedger({ dataDir: ".", tenant: "test", memory: true });

The package also ships the enteros-admin CLI for administrative operations against a tenant ledger.

License

MIT © Molecule AI