Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

State and storage

Note

Design document: draft. The local authorization core, approval service, and signed evidence paths exist in source; platform support and milestone validation remain incomplete.

Shiin stores its state on the developer’s machine and collects no telemetry (ADR-0007).

Locations

StateLocationMilestone
Policy.shiin/policy.toml in the workspacev0.1
Audit log.shiin/audit.jsonl in the workspacev0.1
Approval requests and grants~/.shiin/runtime/approvals.json, beside the Unix daemon socketv0.3, source implementation
Signing keysOS keyring, following ADR-0032v0.4, partial source implementation
Tasks.shiin/tasks/ in the workspacev0.2
Receipts and encrypted replay.shiin/evidence/<request-id>.receipt.json and <request-id>.replay.jsonv0.4, when daemon evidence is enabled
Signed checkpoint and public keys.shiin/evidence/checkpoint.json and <key-id>.public.jsonv0.4, when daemon evidence is enabled

An absolute SHIIN_SOCKET changes the daemon directory and places approvals.json beside that socket. The directory is private to the current Unix user; operator credentials are held in memory and change on restart.

Durability

A non-read action does not proceed until its audit event is durably recorded (ADR-0030).

Redaction

The audit log never contains secret values (AUD-006).