tibet-wayback

System state time-travel with TIBET provenance.

Seal any moment. Restore any moment. Replay any audit. Debug what changed.

Quick Start

pip install tibet-wayback

# Seal current state
wayback seal "before migration"

# List all seals
wayback list

# Restore to a sealed moment
wayback restore wb-3f8a

# Compare two moments
wayback diff wb-3f8a wb-7c2d

# Replay audit at a sealed moment
wayback audit wb-3f8a --framework iso42001

# System SBOM (current or sealed)
wayback sbom
wayback sbom wb-3f8a --json

# Verify a seal's integrity (re-hash all files)
wayback verify wb-3f8a

# Generate rollback plan (what needs to change)
wayback rollback-plan wb-3f8a

# Seal + resume on another device (via Phantom)
wayback seal "end of day" --phantom
wayback resume wb-3f8a

What Gets Sealed

Each seal captures:

SBOM — System Bill of Materials

# Current system manifest
wayback sbom --json > system-sbom.json

# Sealed state manifest
wayback sbom wb-3f8a -o sealed-sbom.json

The SBOM includes services, packages, ports, git state, and audit scores — everything an enterprise needs for compliance and debugging.

Phantom Resume — Cross-Device

Seal your work session, close your laptop, resume on another device:

# On your workstation
wayback seal "end of day" --phantom

# On your laptop (via Phantom Resume)
wayback resume wb-3f8a

Uses Phantom's cross-device session portability with TIBET provenance chain.

A/B System States

Like Android A/B partitions but for your entire stack:

wayback seal "state A — working"   # wb-a1b2
# ... make changes ...
wayback seal "state B — broken"    # wb-c3d4
wayback diff wb-a1b2 wb-c3d4       # see exactly what changed
wayback restore wb-a1b2            # back to working

Perfect for:

• Enterprise: compliance snapshots, audit trails, incident debugging
• Development: safe experimentation, A/B testing system configs
• Education: Storm can build, seal, experiment, restore if things break

Verify & Rollback (v0.2.0)

Absorbed from tibet-snap — verify seal integrity and plan rollbacks:

from tibet_wayback import Wayback

wb = Wayback("/srv/myapp")
seal = wb.seal("baseline")

# Later: check if anything changed
result = wb.verify(seal.seal_id)
# → {"intact": False, "mismatches": 2, "missing": 1, ...}

# Generate rollback plan
plan = wb.rollback_plan(seal.seal_id)
# → {"actions": [{"action": "revert", "path": "config.json", ...}]}

Rich per-file metadata (size, mtime, permissions) enables permission-drift detection — not just content changes.

Note: tibet-snap is deprecated as of v0.1.2. All features are now in tibet-wayback.

Optional Dependencies

pip install tibet-wayback[tibet]    # + tibet-vault, tibet-audit
pip install tibet-wayback[airlock]  # + tibet-airlock (VM snapshots)
pip install tibet-wayback[full]     # everything

Part of TIBET

tibet-wayback is package #91 in the TIBET ecosystem.

tibet-audit  → compliance checks
tibet-vault  → provenance tokens
tibet-airlock → VM snapshots
tibet-wayback → ties them together into time-travel

Authors: Jasper van de Meent & Root AI License: MIT

License

MIT

Credits

Designed by Jasper van de Meent. Built by Jasper and Root AI as part of HumoticaOS.

Stack-positie: Groep evidence · Bootstrap = OSAPI-handshake naar tibet + jis (fail → snaft-rule + tibet-pol-rapport) · ← tibet-ai-sbom · tibet-nis2 → · See STACK.md · See demo/golden-path/ for the spine end-to-end.

Enterprise

For private hub hosting, SLA support, custom integrations, or compliance guidance:

See ENTERPRISE.md for details.