Module triage_state 

Persistent state for the triage subsystem.

Decisions made during gitwell triage are written to <scan_path>/.gitwell/triage.json. On a re-run, sessions whose “session key” already appears in state are skipped so the user isn’t asked the same question twice. The gitwell execute subcommand reads the same file to perform the queued actions.

Schema (version 1):

{
  "version": 1,
  "decisions": [
    {
      "session_key": "auth:1710000000",
      "session_label": "auth",
      "decision": "archive",
      "decided_at": "2026-04-09T10:30:00Z",
      "findings": [
        {
          "repo": "myapp",
          "repo_path": "/Users/me/code/myapp",
          "kind": "stale_branch",
          "detail": "feature/auth-v2"
        }
      ],
      "executed": false
    }
  ]
}

Structs

Decision

DecisionFinding

TriageState

Enums

DecisionKind

Constants

ARCHIVE_SUBDIR

SCHEMA_VERSION

STATE_DIR

STATE_FILE

Functions

session_key_for

Stable-ish identifier for a cluster across runs. If the same cluster reappears with the same label and earliest timestamp, we treat it as already decided.