feat(tools): pull-doc committet nur noch mit --git-commit (D88-Nachtrag)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

docs/CHANGELOG.md

@@ -19,7 +19,7 @@ reverse.
 
 ## 2026-08-27
 
-- A `pull-doc` script fetches a shared document from the backend and commits it into a git worktree — dated commits, none when nothing changed, so a cron gives the plan a git history
+- A `pull-doc` script fetches a shared document from the backend into a file — with `--git-commit` it also commits it, dated, and only when something changed, so a cron gives the plan a git history
 - A benefit rating per node recorded as planned: a 0-9 digit inside the size token (`M/9`), and a third path mode that picks alternatives by benefit over cost — spelled out in SPEC §11 before it is built
 - A people bar below the diagram shows each `@person` with their share of the open work on the cheapest path — plus an entry for what is assigned to nobody
 - Tapping a person filters the diagram to their nodes: everything else folds, their packages stand collapsed as `▸ n`, their pills turn teal — a view-only lens that never writes into the text

docs/DECISIONS.md

@@ -7575,3 +7575,25 @@ geänderter Inhalt ergibt den zweiten Commit; der prozent-kodierte
 enden mit klarer Meldung und ohne Rückstände. Der echte Backend-Abruf ist
 derselbe GET wie im Mock — dieselbe Werkzeuggrenze wie überall: Der native
 Serverbetrieb ist über D76/D77 abgedeckt.
+
+**Nachtrag — committet wird nur mit `--git-commit`.** Nutzer-Einwand direkt
+nach dem Bauen: „pull ist nur die eine Hälfte, somit ist der Name etwas
+fehlleitend" — der wichtigere Teil sei gerade das Commit. Statt umzubenennen
+wird der Name **wahr gemacht**: Ohne Schalter tut `pull-doc`, was es sagt
+(holen und schreiben), das Commit ist ein ausdrücklicher Zusatz
+(`--git-commit`, als erstes Argument). Damit fällt auch die
+Worktree-Pflicht auf den Commit-Fall zurück — wer nur holen will, darf in
+jedes Verzeichnis schreiben.
+
+**Dabei eine Lücke gefunden, die es vorher nicht geben konnte:** Läuft erst
+der flag-lose Abruf (schreibt die Datei) und dann `--git-commit` bei
+unverändertem Server-Stand, war „Datei gleich Server" wahr — und die
+liegende, nie committete Änderung bliebe **für immer** uncommittet. Im
+Commit-Modus heißt „unverändert" deshalb zusätzlich: die Datei ist in git
+sauber (`git status --porcelain` leer); sonst wird trotz gleichen Inhalts
+committet. Nachgemessen in beiden Richtungen: flaglos geschrieben (` M`),
+dann `--git-commit` → Commit, Worktree sauber; sauber und gleich →
+„nichts zu tun", Commit-Zahl unverändert. Die übrigen Messungen aus dem
+Haupttext gelten fort; neu geprüft außerdem: flaglos außerhalb jedes
+Worktrees schreibt anstandslos, `--git-commit` dort lehnt mit klarer
+Meldung ab.

docs/examples/werkbaum.werkbaum

@@ -142,7 +142,7 @@
     - [-] #col.pad: Borrow an Etherpad — it merges, we render (L)  %% built, then removed, see D78
     - [~] #col.git: Git as the shared store (L)
       | [ ] #col.git.pr: A file in a repository, changed by pull request (S)  %% works today, no code
-      | [x] #col.git.pull: A script pulls the server document and commits it (S)  %% tools/pull-doc, dated commits — see D88
+      | [x] #col.git.pull: A script pulls the server document and commits it (S)  %% tools/pull-doc --git-commit, dated commits — see D88
       | [?] #col.git.auto: The backend commits every change (L) :#be.scaffold
         - [?] #col.git.hist: History and restore (M)
           - [?] #col.git.diff: Diff between two versions (S)
@@ -889,8 +889,9 @@
 
 #col.git.pull
   The tools/pull-doc script fetches a server document (a ?live= link works too)
-  and commits it into a git worktree — date, title and version in the message,
-  no commit when nothing changed. Run from cron, a shared plan archives itself.
+  and writes it to a file; with --git-commit it also commits it into the git
+  worktree — date, title and version in the message, no commit when nothing
+  changed. Run from cron, a shared plan archives itself.
 
 #col.git.auto
   The server turns every change into a commit. History, restore and branches