@pi-harness/plugin-git-time-capsule

Git Time Capsule — Capture the current unstaged tracked Git diff as a byte-exact, validated undo capsule without external diff or textconv helpers, then reverse-apply it only after explicit confirmation.

Install

npm install --save-exact @pi-harness/plugin-git-time-capsule

Enable

Add the entry to the Cordis profile the harness starts from:

- id: git-time-capsule
  name: "@pi-harness/plugin-git-time-capsule"
  config: {}

The Pi Harness plugin marketplace installs and enables this package for you; the steps above are the manual equivalent.

Native workspace

Capture and restore use the current native session workspace, captured before parameters are inspected or operations enter the queue. A changed session, manager, native session ID or workspace clears the activity panel and rejects old queued operations. Restore rechecks scope after patch validation immediately before launching the Git write. An already launched Git write cannot be rolled back by a later session switch; its obsolete result is not published to the new session.

The capsule inventory remains shared in the configured agent directory. Selecting a capsule with explicit confirmation reverse-applies it to the current workspace if Git validates it; capsules do not assert repository provenance. Before the native runtime is available, the launch workspace is used.

Git output remains byte-exact and bounded to 8 MiB per stream. Timeout is a failure even if Git handles termination by exiting zero. Timeout/cancellation terminates the owned POSIX process group, with hard escalation after one second; deliberately escaped groups are not contained. Native Windows tree termination remains unverified. Cancelling or timing out an already-started restore does not roll back writes: inspect the workspace before retrying.

Once the write phase starts, failures and cancellations explicitly warn about uncertain workspace state in the tool error and activity panel. Validation/confirmation failures before that phase do not imply writes occurred. Failed/cancelled activity does not display fabricated zero-file/zero-byte completion totals.