storage | Aigon

Synopsis


aigon storage sync
aigon storage status
aigon storage doctor [--fix]
aigon storage report [--json]
aigon storage convert --backend=git-branch [--remote=origin] [--branch=aigon-state] [--keep-refs] [--dry-run]

Description

Manages SpecStore storage for feature and research workflow state. Local storage is the default. Git-branch storage is opt-in and stores canonical lifecycle state as a file tree on a dedicated branch (default: aigon-state).

Spec markdown and code changes still use normal Git. Storage commands do not commit or merge working-tree files.

Subcommands

Subcommand	Description
`sync`	Fetch, merge and dedupe state events, rebuild local projections, and push the configured state branch
`status`	Show backend, remote, branch, offline state, last sync, ahead/behind, and health
`doctor`	Diagnose state-branch reachability, duplicate event IDs, projection drift, and lease health
`doctor --fix`	Apply safe projection repairs and refresh the stable lifecycle view
`report`	Show a cross-repo storage and active-lease report
`report --json`	Print the report as JSON
`convert`	Validate remote access, write git-branch config, import local or legacy git-ref events, and sync
`convert --dry-run`	Show planned config and import candidates without writing config or remote state

Examples


# Convert the current repository to git-branch storage
aigon storage convert --backend=git-branch --remote=origin
 
# Use a differently named state branch
aigon storage convert --backend=git-branch --remote=origin --branch=workflow-state
 
# Check whether this clone is ahead, behind, degraded, or healthy
aigon storage status
 
# Pull and push canonical lifecycle state
aigon storage sync
 
# Diagnose storage and lease issues
aigon storage doctor
 
# Inspect active leases across registered repositories
aigon storage report

git-ref is no longer supported. If a project still has that backend configured, run aigon storage convert --backend=git-branch --remote=origin; add --keep-refs if the legacy refs must remain available temporarily.

See Storage Backends for configuration, multi-clone behavior, leases, offline mode, and stable spec layout.