chore(wolf): sync anatomy/memory/hooks/token-ledger bookkeeping

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01AgYRU3zDTqNGV5Jk8aiKLg
2026-08-25 03:13:06 +00:00 · 2026-08-25 03:13:06 +00:00 · 3aaba2d323
commit 3aaba2d323
parent 8f2e684f21
4 changed files with 1438 additions and 19 deletions
--- a/.wolf/anatomy.md
+++ b/.wolf/anatomy.md
@ -1,7 +1,7 @@
 # anatomy.md

-> Auto-maintained by OpenWolf. Last scanned: 2026-08-24T15:06:08.548Z
-> Files: 723 tracked | Anatomy hits: 0 | Misses: 0
+> Auto-maintained by OpenWolf. Last scanned: 2026-08-25T02:41:40.380Z
+> Files: 724 tracked | Anatomy hits: 0 | Misses: 0

 ## ../../../../../../tmp/

@ -956,7 +956,7 @@
 - `ha_convergence.c` — Declares char (~8389 tok)
 - `ha.c` — define _GNU_SOURCE (~125491 tok)
 - `ha.h` — ifndef HA_H (~36503 tok)
- `job.c` — include <assert.h> (~33025 tok)
+- `job.c` — include <assert.h> (~33381 tok)
 - `join.c` — include "config.h" (~2994 tok)
 - `main.c` — build-time-versioning task 3.2 (argp_program_version runtime-composed into static `version_buf[128]`, "My name is..." startup INFO reads that buffer) PLUS dirty-content-fingerprint task 3.2 (2026-08-21): new static `version_display_buf[128]` composed via `xce_compose_version_ex()` (adds `STR(VERSION_DIRTY_FINGERPRINT)`) feeds `argp_program_version` instead; `version_buf`'s composition + the startup INFO log are byte-identical/untouched (Req 3.2). Live-verified: `--version` -> `7ebcba6d-cdb7cc7d`, startup log -> `7ebcba6d-dirty` (~5346 tok)
 - `meson.build` (~3466 tok)
@ -965,7 +965,7 @@
 - `myconf.c` — define _GNU_SOURCE (~1180 tok)
 - `opget.c` — include "config.h" (~1730 tok)
 - `opupd.c` — include "config.h" (~714 tok)
- `persist.c` — define _GNU_SOURCE (~89338 tok)
+- `persist.c` — define _GNU_SOURCE (~91053 tok)
 - `queue.c` — include <errno.h> (~1554 tok)
 - `repl.c` — include <assert.h> (~9240 tok)
 - `reply.c` — include "config.h" (~590 tok)
@ -1016,7 +1016,7 @@
 - `test_convergence_verification.c` — define _GNU_SOURCE (~20242 tok)
 - `test_ctrl_metrics.c` — define _GNU_SOURCE (~949 tok)
 - `test_ctrlstatus.c` — include <stdatomic.h> (~6287 tok)
- `test_dispatch_commit.c` — Declares table (~6641 tok)
+- `test_dispatch_commit.c` — Declares table (~7042 tok)
 - `test_dispatch_fail_retry.c` — task 5.2's fail->succeed->fail test (`test_rpc_failure_bound_resets_after_intervening_success`, toggles worker ep broken/working across `dispatch_a_job_test()` calls) proves Req 4.3 counter-reset end-to-end (GREEN). Its job.state==PEND/job.allocs==NULL assertions on the post-success retryable/terminal failures were REMOVED (task 5.2 remediation, 2026-08-23) after kiro-debug (HIGH confidence) found that sub-scenario unreachable via any real caller today -- see bug-1631 for the deferred analysis; the removed-assertion rationale is documented inline in the test (~13000 tok)
 - `test_dispatch_fail_terminal.c` — Declares table (~3499 tok)
 - `test_ha_rdhup_integration.c` — Declares char (~8362 tok)
@ -1024,11 +1024,12 @@
 - `test_job_dispatch_fail_count.c` — scheduler-dispatch-commit task 1.3: proves job_t.dispatch_fail_count (xce/types.h wrapper struct, new uint32_t next to submit_lsn) is a plain, directly settable/incrementable/resettable in-memory-only field; bare stack-local job_t, no jobmgr/RTTI, mirrors test_persist_types.c's test_slot_key_t_fields precedent. Data-model only -- no dispatch_a_job_() wiring (~1600 tok)
 - `test_job_dispatch.c` — Declares in (~1205 tok)
 - `test_jobdispatch_no_double_notify.c` — Declares table (~5490 tok)
+- `test_repl_apply.c` — include <dirent.h> (~5812 tok)
 - `test_resval_typeresolve.c` — Declares override (~1118 tok)
 - `test_sched_admin_dispatch.c` (~7510 tok)
 - `test_sched_worker_change.c` — Declares bug (~3893 tok)
 - `test_term_safety_adapter.c` — define _GNU_SOURCE (~29920 tok)
- `test_wal_job_dispatch_fact.c` — scheduler-dispatch-commit task 1.2: proves WAL_JOB_DISPATCH (new wal_entry_type=12, wal_types.h) is wired into both apply_committed_entry() (live-commit/boot-replay) and apply_wal_entry() (standby catch-up); restart-replay test writes only WAL_JOB_SUBMIT+WAL_JOB_DISPATCH (no WAL_JOB_START) to a real disk WAL and confirms persist_recover() recovers job.state==RUN (~3006 tok)
+- `test_wal_job_dispatch_fact.c` — Declares in (~5222 tok)
 - `test.c` — include <argp.h>. jobid-%lu-to-fmt_jobid task (2026-08-21): all 10 remaining raw `%lu` jobid printfs (cmd_jobkill, cmd_jobckpt, run_task_local, handle_notify x3, handle_runtasks x2, check_run_jobs, check_run_tasks) converted to `fmt_jobid(buf, sizeof(buf) - 1, ...)` + `%s`, matching this file's existing convention (buf/jobidStr/wantStr precedents at ~1559/1980/2405-2422); no new #include needed. Loop-scoped buffers repopulated fresh per iteration where the jobid varies (check_run_jobs, check_run_tasks, handle_notify's per-case union fields); reused a single populate when the jobid is loop-invariant (handle_runtasks: same runmsg->jobid across the task loop) (~40184 tok)

 ## src/frontend/
@ -1090,7 +1091,7 @@

 ## src/include/

- `persist.h` — pragma once (~24461 tok)
+- `persist.h` — pragma once (~24667 tok)
 - `utils.h` — dirty-content-fingerprint task 3.1: new `xce_compose_version_ex()` extern decl (--version-only sibling of xce_compose_version(), adds optional `dirty_fingerprint` param); startup-log call sites keep calling the untouched xce_compose_version() (~2720 tok)
 - `wal_types.h` — pragma once (~2250 tok)

--- a/.wolf/hooks/_session.json
+++ b/.wolf/hooks/_session.json
@ -141,6 +141,16 @@
      "count": 1,
      "tokens": 6392,
      "first_read": "2026-08-24T15:02:51.326Z"
+    },
+    "/home/rshen/projects/xce/worktrees/scheduler-framework/src/controller/testsuite/test_dispatch_commit.c": {
+      "count": 1,
+      "tokens": 6641,
+      "first_read": "2026-08-25T02:28:16.135Z"
+    },
+    "/home/rshen/projects/xce/worktrees/scheduler-framework/src/controller/testsuite/test_wal_job_dispatch_fact.c": {
+      "count": 2,
+      "tokens": 3006,
+      "first_read": "2026-08-25T02:28:34.447Z"
    }
  },
  "files_written": [
@ -437,6 +447,90 @@
      "action": "edit",
      "tokens": 41,
      "at": "2026-08-24T15:06:08.554Z"
+    },
+    {
+      "file": "/home/rshen/projects/xce/worktrees/scheduler-framework/src/controller/persist.c",
+      "action": "edit",
+      "tokens": 180,
+      "at": "2026-08-25T02:33:33.051Z"
+    },
+    {
+      "file": "/home/rshen/projects/xce/worktrees/scheduler-framework/src/controller/persist.c",
+      "action": "edit",
+      "tokens": 588,
+      "at": "2026-08-25T02:33:48.797Z"
+    },
+    {
+      "file": "/home/rshen/projects/xce/worktrees/scheduler-framework/src/include/persist.h",
+      "action": "edit",
+      "tokens": 293,
+      "at": "2026-08-25T02:34:10.842Z"
+    },
+    {
+      "file": "/home/rshen/projects/xce/worktrees/scheduler-framework/src/controller/persist.c",
+      "action": "edit",
+      "tokens": 514,
+      "at": "2026-08-25T02:34:27.927Z"
+    },
+    {
+      "file": "/home/rshen/projects/xce/worktrees/scheduler-framework/src/controller/job.c",
+      "action": "edit",
+      "tokens": 222,
+      "at": "2026-08-25T02:34:38.576Z"
+    },
+    {
+      "file": "/home/rshen/projects/xce/worktrees/scheduler-framework/src/controller/persist.c",
+      "action": "edit",
+      "tokens": 404,
+      "at": "2026-08-25T02:35:03.179Z"
+    },
+    {
+      "file": "/home/rshen/projects/xce/worktrees/scheduler-framework/src/controller/persist.c",
+      "action": "edit",
+      "tokens": 491,
+      "at": "2026-08-25T02:35:32.317Z"
+    },
+    {
+      "file": "/home/rshen/projects/xce/worktrees/scheduler-framework/src/controller/job.c",
+      "action": "edit",
+      "tokens": 347,
+      "at": "2026-08-25T02:35:48.415Z"
+    },
+    {
+      "file": "/home/rshen/projects/xce/worktrees/scheduler-framework/src/controller/testsuite/test_repl_apply.c",
+      "action": "edit",
+      "tokens": 134,
+      "at": "2026-08-25T02:35:58.098Z"
+    },
+    {
+      "file": "/home/rshen/projects/xce/worktrees/scheduler-framework/src/controller/testsuite/test_dispatch_commit.c",
+      "action": "edit",
+      "tokens": 522,
+      "at": "2026-08-25T02:38:39.233Z"
+    },
+    {
+      "file": "/home/rshen/projects/xce/worktrees/scheduler-framework/src/controller/testsuite/test_wal_job_dispatch_fact.c",
+      "action": "edit",
+      "tokens": 27,
+      "at": "2026-08-25T02:40:50.353Z"
+    },
+    {
+      "file": "/home/rshen/projects/xce/worktrees/scheduler-framework/src/controller/testsuite/test_wal_job_dispatch_fact.c",
+      "action": "edit",
+      "tokens": 947,
+      "at": "2026-08-25T02:41:08.191Z"
+    },
+    {
+      "file": "/home/rshen/projects/xce/worktrees/scheduler-framework/src/controller/testsuite/test_wal_job_dispatch_fact.c",
+      "action": "edit",
+      "tokens": 415,
+      "at": "2026-08-25T02:41:20.047Z"
+    },
+    {
+      "file": "/home/rshen/projects/xce/worktrees/scheduler-framework/src/controller/testsuite/test_wal_job_dispatch_fact.c",
+      "action": "edit",
+      "tokens": 1248,
+      "at": "2026-08-25T02:41:40.387Z"
    }
  ],
  "edit_counts": {
@ -461,12 +555,17 @@
    "src/frontend/apiserver/backend/convert_test.go": 1,
    "src/frontend/xcecli/models/jobs.go": 1,
    "src/frontend/xcecli/cmd/jobs/submit.go": 1,
-    "src/controller/job.c": 2,
-    "src/controller/apiserver.c": 2
+    "src/controller/job.c": 4,
+    "src/controller/apiserver.c": 2,
+    "src/controller/persist.c": 5,
+    "src/include/persist.h": 1,
+    "src/controller/testsuite/test_repl_apply.c": 1,
+    "src/controller/testsuite/test_dispatch_commit.c": 1,
+    "src/controller/testsuite/test_wal_job_dispatch_fact.c": 4
  },
-  "anatomy_hits": 11,
+  "anatomy_hits": 13,
  "anatomy_misses": 17,
-  "repeated_reads_warned": 11,
+  "repeated_reads_warned": 12,
  "cerebrum_warnings": 0,
-  "stop_count": 14
+  "stop_count": 17
 }
--- a/.wolf/memory.md
+++ b/.wolf/memory.md
@ -3818,3 +3818,20 @@
 | 08:02 | Edited src/controller/apiserver.c | added 1 condition(s) | ~159 |
 | 08:06 | Edited src/controller/job.c | 6→3 lines | ~21 |
 | 08:06 | Edited src/controller/apiserver.c | modified if() | ~38 |
+| 08:15 | Session end: 49 writes across 20 files (.gitignore, spec.json, request_test.go, request.go, gitea-sync.py) | 28 reads | ~214942 tok |
+| 19:25 | Session end: 49 writes across 20 files (.gitignore, spec.json, request_test.go, request.go, gitea-sync.py) | 28 reads | ~214942 tok |
+| 19:33 | Session end: 49 writes across 20 files (.gitignore, spec.json, request_test.go, request.go, gitea-sync.py) | 30 reads | ~224589 tok |
+| 19:33 | Edited src/controller/persist.c | added error handling | ~168 |
+| 19:33 | Edited src/controller/persist.c | added 3 condition(s) | ~548 |
+| 19:34 | Edited src/include/persist.h | expanded (+13 lines) | ~274 |
+| 19:34 | Edited src/controller/persist.c | added 2 condition(s) | ~479 |
+| 19:34 | Edited src/controller/job.c | modified itself() | ~207 |
+| 19:35 | Edited src/controller/persist.c | added 3 condition(s) | ~377 |
+| 19:35 | Edited src/controller/persist.c | added error handling | ~458 |
+| 19:35 | Edited src/controller/job.c | added error handling | ~324 |
+| 19:35 | Edited src/controller/testsuite/test_repl_apply.c | modified restore_job_state() | ~126 |
+| 19:38 | Edited src/controller/testsuite/test_dispatch_commit.c | expanded (+25 lines) | ~487 |
+| 19:40 | Edited src/controller/testsuite/test_wal_job_dispatch_fact.c | 3→4 lines | ~26 |
+| 19:41 | Edited src/controller/testsuite/test_wal_job_dispatch_fact.c | added 2 condition(s) | ~884 |
+| 19:41 | Edited src/controller/testsuite/test_wal_job_dispatch_fact.c | added error handling | ~387 |
+| 19:41 | Edited src/controller/testsuite/test_wal_job_dispatch_fact.c | added 1 condition(s) | ~1165 |
--- a/.wolf/token-ledger.json
+++ b/.wolf/token-ledger.json