atomwrite 0.1.35

Atomic file operations CLI for LLM agents — read, write, edit, search, replace with NDJSON output
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "WalStatsOutput",
  "description": "NDJSON output of the `wal-stats` subcommand (G119 L5). Read-only snapshot of the workspace's WAL sidecar state used by local gates and agent health checks.",
  "type": "object",
  "required": [
    "total_journals",
    "by_state",
    "oldest_journal_age_secs",
    "total_size_bytes",
    "by_directory",
    "auto_heal_recommended",
    "estimated_reclaim_bytes"
  ],
  "additionalProperties": false,
  "properties": {
    "total_journals": {
      "description": "Total number of sidecar journals found in the workspace.",
      "type": "integer",
      "format": "uint64",
      "minimum": 0
    },
    "by_state": {
      "description": "Breakdown of journals by terminal state.",
      "type": "object",
      "required": ["started", "committed", "aborted", "malformed"],
      "additionalProperties": false,
      "properties": {
        "started": {
          "description": "Journals whose last entry is `Started` (potential orphans).",
          "type": "integer",
          "format": "uint64",
          "minimum": 0
        },
        "committed": {
          "description": "Journals whose last entry is `Committed` (safe to clean).",
          "type": "integer",
          "format": "uint64",
          "minimum": 0
        },
        "aborted": {
          "description": "Journals whose last entry is `Aborted` (safe to clean).",
          "type": "integer",
          "format": "uint64",
          "minimum": 0
        },
        "malformed": {
          "description": "Journals that could not be parsed (do not auto-clean).",
          "type": "integer",
          "format": "uint64",
          "minimum": 0
        }
      }
    },
    "oldest_journal_age_secs": {
      "description": "Age of the oldest journal in seconds (0 if no journals found).",
      "type": "integer",
      "format": "uint64",
      "minimum": 0
    },
    "total_size_bytes": {
      "description": "Total bytes occupied by all sidecar files in the workspace.",
      "type": "integer",
      "format": "uint64",
      "minimum": 0
    },
    "by_directory": {
      "description": "Top directories by journal count (up to 10 entries).",
      "type": "array",
      "maxItems": 10,
      "items": {
        "type": "object",
        "required": ["path", "count"],
        "additionalProperties": false,
        "properties": {
          "path": {
            "description": "Directory path relative to the workspace root.",
            "type": "string"
          },
          "count": {
            "description": "Number of journals in this directory.",
            "type": "integer",
            "format": "uint64",
            "minimum": 0
          }
        }
      }
    },
    "auto_heal_recommended": {
      "description": "True when the workspace has accumulated enough journals to warrant an auto-heal pass (total > 100 OR oldest > 7 days).",
      "type": "boolean"
    },
    "estimated_reclaim_bytes": {
      "description": "Estimated bytes that would be reclaimed by an auto-heal pass (sum of `Committed` + `Aborted` sidecar sizes).",
      "type": "integer",
      "format": "uint64",
      "minimum": 0
    }
  }
}