@natalietdg/dotto

Deterministic change detection for governed AI systems.

Change detection is computed, not inferred. AI only handles what cannot be computed.

Install

npm install @natalietdg/dotto

Use

import { diff, runGovernance } from "@natalietdg/dotto";

const d = diff(
  { id: "po-1", quantity: 100 },
  { id: "po-1", quantity: 500 }
);
// { changeType: "UPDATE", fields: [{ field: "quantity", before: 100, after: 500, delta: 400 }], breaking: false, ... }

const result = await runGovernance({
  diff: d,
  ai: myAIGovernor, // optional — implements AIGovernor interface
});
// { diff, aiInterpretation, governance: { decision: "allow" | "block" | "escalate", ... } }

Architecture

[ Deterministic Layer ]   diff()           — facts
        ↓
[ AI Layer ]              AIGovernor       — judgment
        ↓
[ Governance Layer ]      PolicyEngine     — allow / block

Bring your own AI. Bring your own policy rules. The deterministic core is exact and reproducible.

License

MIT