diff --git a/docs/comprehension-history.md b/docs/comprehension-history.md index c43bae3a..4ed80692 100644 --- a/docs/comprehension-history.md +++ b/docs/comprehension-history.md @@ -3979,3 +3979,35 @@ Inherited architect, would restructure first: - Locality: `bin/loop_claude/loop/close.py:18` `closed_cycle`: a second "close" beside `cycle/run.py:234` `close` - Navigation, Shape: `README.md:197` the `bin/` package list: 74 entries at one level with the README's list as the only index - Self-sufficiency: `bin/loop_claude/loop/routing_check.py:1` the module docstring: names `state.CYCLES_PER_CHECK` without saying which module `state` is + +## 2026-11-16T15:57:39Z, PR #562 at 31da587, against 64454f8 + +Ruling: better + +| Seat | Navigation | Locality | Shape | Self-sufficiency | Overall | +|---|---|---|---|---|---| +| Mid A | better | better | better | same | better | +| Inherited architect | better | better | better | better | better | + +Mid A, decided by: + +- Locality, Shape: `bin/plan_store/stores.py:1` `store`: the 234-line module holding the protocol, the markdown backend, the Jira scoring and a deferred import of jira_epic is now a 40-line factory beside `plans.py`, `todo_md.py` and `scoring.py`, with no cycle to keep in mind +- Locality: `bin/record_store/stores.py:34` `RecordStore.write`: the Confluence store's hidden `seen` and `kept` file gave way to `held()` and `write(text, over)`, so a save is followed without knowing the store's history +- Navigation, Shape: `bin/release_plan/next_chunk.py:57` `planned`: the next chunk's pick moved out of chunk-preflight's internals beside the release standing, and its `Plan` became `NextChunk`, no longer clashing with the store's `Plan` +- Locality, Shape: `bin/release_plan/release_standing.py:169` `standing_of`: the plan is weighed against the cut once, where `carried`, `cut_version` and `named_releases` ran in three places +- Navigation, Shape: `bin/atlassian/client.py:1` `client`: Confluence's auth no longer lives in the Jira plan backend +- Navigation: `bin/notifier/notify.py:10` `BACKENDS`: both DM backends sit in the notifier's folder +- Shape: `bin/rank_todo.py:119` `main`: one write path, through `FilePlan.rank()`, in place of `plan_file.py`'s copy + +Inherited architect, decided by: + +- Locality, Shape: `bin/record_store/confluence_page.py:84` `ConfluencePage.write`: the concurrency check shows in the call signature, where it hung on which earlier read ran in which process +- Shape, Locality: `bin/repo_checks/test_package_cycles.py:13` `package_imports`: the deferred imports that hid the plan packages' cycles are gone, a neutral `atlassian` package holds the shared client, and a test enforces the rule +- Navigation, Shape: `bin/release_plan/next_chunk.py:57` `planned`: the pick no longer lives in one CLI's package, and its type is named `NextChunk` +- Shape: `bin/plan_store/stores.py:18` `store`: the store is split by purpose, and `release_plan/` is no longer a grab bag +- Locality: `bin/release_plan/release_standing.py:169` `standing_of`: weighed once, with `plan_is_current` and `pick_from` naming what they do +- Locality: `bin/plan/todo_table.py:294` `item_fields`: one check of an item's cells for every backend +- Locality: `bin/plan_store/plans.py:57` `no_item`: the coupling between chunk-pr and todo-item's message has a name +- Locality: `bin/chunk_pr/main.py:130` `step`: the config is passed in once, where `misfit` shelled out to `project-config` twice +- Shape: `bin/project_config/settings.py:320` `SCALARS`: one row per one-value setting, where `load` handled each at four sites +- Navigation, Self-sufficiency: `bin/chunk_preflight/gathered.py:60` `Gathered.plan`: a stale pointer to `choices.plan_name`, with two more in `next_chunk.py` and the README, small next to the gains