tibet-wayback 0.2.0

System state time-travel with TIBET provenance. Seal, verify, rollback, restore, replay any moment.

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:

Layer	What	How
Files	SHA256 + size, mtime, permissions per file	rglob("*") with smart skip
Git	Branch, commit, dirty files, tags	git rev-parse, git diff
Services	Running systemd/docker, PIDs, memory	systemctl, docker ps
Environment	Filtered env vars (no secrets)	Safe-list approach
Packages	Installed TIBET packages + versions	pip list --format=json
Ports	Listening network ports	ss -tlnp
Audit	tibet-audit score, grade, check count	Optional: --audit flag
Provenance	TIBET token with manifest hash	Optional: requires tibet-vault
VM State	Airlock microVM snapshot	Optional: requires tibet-airlock

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

---

Enterprise

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

Enterprise	[e-mail]
Support	[e-mail]
Security	[e-mail]

See ENTERPRISE.md for details.