FORGE State & Temporal Intelligence (CAP-040) — @arc-forge/cap-040

Universal, domain-independent state, event, diff, snapshot, and lineage primitive.

Installation

npm install @arc-forge/cap-040

CLI Usage

npx cap040 demo

Programmatic API

import {
  deriveState,
  createSnapshot,
  computeDiff,
  getLineage,
  serializePackage,
  deserializePackage
} from '@arc-forge/cap-040';

// Initialize root state
const root = { status: 'draft', step: 1 };

// Apply events deterministically
const events = [
  { id: 'evt-1', type: 'UPDATE', payload: { status: 'in_review' }, timestamp: 1000 }
];

const current = deriveState(root, events);
console.log(current); // { status: 'in_review', step: 1 }

Features

• 100% Deterministic State Engine: Calculates current or historical state cleanly without side-effects.
• Zero Runtime Dependencies: Pure TypeScript running natively on Node.js.
• Lineage & Snapshots: Tracks snapshot parents, versions, and full operational lineage.
• Portable Serialization: Serializes state graphs and event histories for transmission or storage.
• U0 Domain Neutral: Designed without assumptions about specific models, frameworks, or UI frameworks.