zam-core 0.4.0 → 0.4.2

package/.agents/skills/zam/SKILL.md

@@ -326,7 +326,7 @@ The `capture-ui` command supports:
 
 On Windows, uses PowerShell/.NET for screen capture. On macOS, uses `screencapture`.
 
-**Observer permissions (Layer 2, ADR-0001).** `capture-ui` enforces a
+**Observer permissions (Layer 2).** `capture-ui` enforces a
 user-configurable policy resolved from `zam settings`: `observer.scope`
 (`off` | `window` | `fullscreen`), `observer.allowlist`, `observer.denylist`,
 `observer.consent`, `observer.retention`. Set them with e.g.

package/README.de.md

@@ -63,6 +63,25 @@ Einstieg: `zam whoami --set <deine-id>`
 
 ---
 
+## 🔄 ZAM aktuell halten
+
+Prüfe, ob eine neuere Version vorliegt, und aktualisiere — ZAM wählt den passenden Mechanismus je nachdem, wie diese Kopie installiert wurde:
+
+```bash
+zam update          # neueste Version anwenden (fragt nach; -y überspringt)
+zam update check    # nur prüfen, ob ein Update verfügbar ist
+```
+
+Was `zam update` je nach Installationskanal tut:
+
+- **Developer** (Quell-Checkout, Standard für Mitwirkende) — holt den neuesten Quellcode, installiert Abhängigkeiten neu, baut die CLI und frischt die Skill-Dateien auf (`zam setup --force`). Danach den Agent-Client (z. B. Claude Code) neu starten, damit der aktualisierte `/zam`-Skill geladen wird.
+- **winget / Homebrew** — delegiert an `winget upgrade` / `brew upgrade`, damit eine paketverwaltete Installation nie selbst ersetzt wird.
+- **Direkt-Download / Desktop** — installiert ein signiertes In-place-Update über ZAM Desktop.
+
+`zam update` verweigert einen Developer-Checkout mit uncommitteten Änderungen; committe oder stashe sie zuerst, oder nutze `--force`. Design-Details: [ADR „Approachable Setup and Self-Update“](docs/adr/2026-06-13b-approachable-setup-and-self-update.md).
+
+---
+
 ## 🏛 Vision: Eine paradiesische Zukunft
 
 ZAM ist das Werkzeug für den Übergang in eine Welt, in der Fürsorge und gemeinsames Wachstum die Währung sind.

package/README.md

@@ -83,6 +83,25 @@ Token deletion is global. Card deletion is per-user.
 
 ---
 
+## 🔄 Keeping ZAM up to date
+
+Check whether a newer release is out, then update — ZAM picks the right mechanism for how this copy was installed:
+
+```bash
+zam update          # apply the latest release (asks first; -y to skip)
+zam update check    # only report whether an update is available
+```
+
+What `zam update` does per install channel:
+
+- **Developer** (source checkout, the default for contributors) — pulls the latest source, reinstalls dependencies, rebuilds the CLI, and refreshes the skill files (`zam setup --force`) in the current instance. Restart your agent client (e.g. Claude Code) afterwards to load the refreshed `/zam` skill.
+- **winget / Homebrew** — defers to `winget upgrade` / `brew upgrade`, so a package-managed install is never self-replaced.
+- **Direct download / desktop** — applies a signed in-place update through ZAM Desktop.
+
+`zam update` refuses to touch a developer checkout with uncommitted changes; commit or stash them first, or pass `--force`. See the [“Approachable Setup and Self-Update” ADR](docs/adr/2026-06-13b-approachable-setup-and-self-update.md) for the design.
+
+---
+
 ## 🏛 Vision: A Flourishing Future
 
 ZAM is a tool for the transition to a world where care and shared growth are the common currency.