projmux 0.6.0 → 0.6.1

package/docs/agent-workflow.md

@@ -33,7 +33,7 @@
 - `make test` also covers Settings IA regression guards for `send-noti` visibility in Hooks, no nested Project recipe inside Hooks, Project recipe/AI/Labs view-first detail rows, Notifications root/Desktop notifications/Delivery sources relocation, Delivery sources command-row clipboard copy, and Labs Project Hooks overview-first rows.
 - `make test` also covers Settings > Session State as global settings-only UI with default-off auto-save and no window/pane tree, Settings > Project > Session State project-derived identity plus project auto-save override/effective source rows and distinct Save latest snapshot / Save named snapshot labels, closed-project save disabled reasons, named snapshot portable path conversion, project/global auto-save precedence, Projects > Sessions > State read-only latest/named snapshot overview with window/pane cwd/recipe/agent-resume health, user-facing `projmux session-state` status/save/delete/restore dry-run actions including explicit manual save bypass of disabled autosave and agent resume status/confidence preview, and Project open sidebar startup coverage for Labs opt-in `Start project`, default-off empty creation, Latest snapshot, Named snapshot, Empty session, Back, saved-at row metadata, existing-session skip, startup-before-trust ordering, trust approve continuation, and trust deny/cancel no-session behavior.
 - `make test` also covers `projmux shell` usage without startup selector flags, project-context default target lookup from `PROJMUX_CWD` or nearest project marker, explicit `--session` separation from project-derived defaults, and direct empty attach behavior without shell startup picker/replay.
-- `make test` also covers the statusbar Session State popup entrypoint, manual Save snapshot and restore dry-run preview actions, title-first pane preview labels with legacy snapshot fallback, missing-snapshot messaging, and `projmux tmux sessionstate-status` helper wiring.
+- `make test` also covers manual Session State Save snapshot and restore dry-run preview actions, title-first pane preview labels with legacy snapshot fallback, missing-snapshot messaging, and the absence of the removed statusbar State shortcut.
 - `make test` also covers legacy named-snapshot storage compatibility for `.projmux/layouts/*.toml`, supported interpolation validation, malformed-file list warnings, portable conversion helpers, dry-run conversion to the session-state restore preview with source labels, missing current-session failure, destructive live replay helper behavior with fresh/internal source marking and fresh saved-snapshot cleanup, and the session-state live replay helper that stages windows, moves them by tmux ID, and removes extra live windows.
 - `make test` also covers `projmux ai integrate codex` default hooks install/idempotence/dry-run/removal, compatibility legacy Codex notify mode install/idempotence, dry-run preview, unmanaged `notify = ...` conflict refusal, managed-block removal, catalog-driven Codex hook event installation with local override merging, nested inline Codex hook schema, `[features]` merge/preservation, preservation of unrelated Codex/Claude config and unmanaged hook entries, Settings Codex `/hooks` review notice and tested-version rows, and remove-all behavior for projmux-managed Codex blocks.
 - `make test` also covers `projmux ai ingest codex-hook` event parsing, PermissionRequest critical queue rows with tool/action metadata, Stop info queue rows, UserPromptSubmit busy/no-queue behavior, quiet/no-notify diagnostics for non-firing Codex hook events including override-added catalog events, cataloged hook notification body formatting, hook-active pane marking, topic preservation without hook candidate writes, and mutable resume metadata writes for `@projmux_ai_resume_id`, source, and updated-at.

package/docs/cli.md

@@ -680,9 +680,9 @@ flags with the top-level `switch` UX:
   no configured source. When no source is configured, the direct-set prompt
   starts with `$HOME` as an editable fallback, but `$HOME` is not used as the
   effective root unless saved. `Workdirs` remains separate: those entries are
-  additional search roots, not the primary root. Appearance stores
-  `~/.config/projmux/statusbar-decoration` as `off` (default), `symbol`, or
-  `emoji` and updates the live tmux option when available. Labs remains
+  additional search roots, not the primary root. Appearance stores per-surface
+  path/git/notify icon decoration as `off` (default), `symbol`, or `emoji` and
+  updates the matching live tmux option when available. Labs remains
   available for experimental settings. The About section reads the cached
   update status without network access;
   selecting Check Updates runs `projmux update check`, and Update Now runs

package/docs/configuration.md

@@ -432,18 +432,24 @@ create sessions or send tmux commands.
 
 ## Decoration Mode
 
-Settings > Appearance controls optional status and picker decoration:
+Settings > Appearance controls optional icon decoration per surface:
 
 - `off` is the default and avoids icon-font assumptions.
-- `symbol` restores the Nerd Font-style folder, GitHub, and bell icons.
-- `emoji` uses emoji decorators, including the notify sidebar header bell.
+- `symbol` restores Nerd Font-style folder, git-provider, and bell icons.
+- `emoji` uses emoji decorators. GitHub remotes use a cat-style mark, GitLab
+  remotes use a fox-style mark, and other remotes use a generic git branch mark.
 
-The saved value lives at:
+The per-surface saved values live at:
 
 ```text
-~/.config/projmux/statusbar-decoration
+~/.config/projmux/statusbar-decoration-cwd
+~/.config/projmux/statusbar-decoration-git
+~/.config/projmux/statusbar-decoration-notify
 ```
 
+The legacy `~/.config/projmux/statusbar-decoration` value is still read as the
+fallback default when a per-surface file is absent.
+
 ## Rare Tunables
 
 These are intended for debugging or local policy, not routine setup:

package/docs/session-restore.md

@@ -27,22 +27,16 @@ restore` prints the read-only dry-run restore plan for the project snapshot, and
 `Delete snapshot` requires a confirmation picker before removing the project
 snapshot. Destructive restore execution remains outside Settings in this slice.
 
-Agent panes in Settings, the statusbar popup, and restore dry-run previews show
-resume metadata health next to the pane recipe. `available` means a resume id is
-present and recent enough for replay, `stale` means the stored id exists but the
-metadata is missing or older than the snapshot policy, and `unavailable`
-means projmux cannot safely resume that agent pane from the snapshot. Confidence
-is derived from the metadata source: direct session ids and hook ingest are high
+Agent panes in Settings and restore dry-run previews show resume metadata
+health next to the pane recipe. `available` means a resume id is present and
+recent enough for replay, `stale` means the stored id exists but the metadata is
+missing or older than the snapshot policy, and `unavailable` means projmux
+cannot safely resume that agent pane from the snapshot. Confidence is derived
+from the metadata source: direct session ids and hook ingest are high
 confidence, transcript/log fallbacks are medium confidence, and missing or
-unknown sources are low or none.
-
-The statusbar Session State popup remains a secondary shortcut backed by the
-same read model and CLI behavior:
-
-- `Save snapshot` captures the current tmux session, bypassing the autosave debounce
-  just like `projmux session-state save`.
-- `Preview restore` prints the dry-run restore plan and does not execute tmux
-  replay commands.
+unknown sources are low or none. The old statusbar Session State shortcut has
+been removed; use `Projects > Sessions > State` or the `projmux session-state`
+CLI for inspection/actions.
 
 Settings > Session State is global settings only: global auto-save, auto-save
 interval, and storage/retention policy. It does not show the current

package/docs/settings-ia.md

@@ -3,6 +3,14 @@
 This branch finishes the current Settings/onboarding roadmap slice with a
 view-first layout:
 
+- Every Settings surface keeps the Global/Project tab strip visible so nested
+  pages still show their scope. Detail pages may render the strip as passive
+  context when changing tabs from that nested page would skip an explicit Back
+  boundary.
+- Settings uses a view-first rule: overview rows open details; details show the
+  current state, source, and expected rendered result before offering mutation
+  rows. If a detail opens a dedicated `Change` page, that page is mutation-only
+  and does not repeat the same read-only view rows.
 - `Settings > Project Picker > Workdirs` is the list/overview entry. Add/remove
   actions live inside that view.
 - `Settings > Project Picker > Project Root` shows effective and saved values
@@ -33,6 +41,10 @@ view-first layout:
   rows such as `Startup command`, `Kube`, and `Environment`; mutation actions
   such as `Set startup command...`, `Clear startup command`, kube edits, and env
   add/remove rows live inside those details.
+- `Settings > Appearance` is view-first. The root opens `Path icon`, `Git icon`,
+  and `Notify icon` details. Each detail shows the current mode and off/symbol/
+  emoji rendered previews first, and its `Change` page contains only the
+  off/symbol/emoji mutation choices.
 
 Hooks remain the reference pattern for this IA:
 

package/docs/statusbar.md

@@ -8,13 +8,17 @@ segment only requires one wiring point.
 ## Layout
 
 ```
-row 0  [#S] #{pane_current_path}  ⎈ <ctx>/<ns>  <git>               %H:%M
+row 0  #[range=user|notify] <notify HUD pill> #[norange]
+                                      #[range=user|usage] <usage HUD bar> #[norange]
+row 1  [#S]  #{pane_current_path}  ⎈ <ctx>/<ns>  <git>   %H:%M
        └────────── native tmux window list (one entry per window) ──────────┘
-row 1  #[range=user|notify] <notify HUD pill> #[norange] #[range=user|sessionstate]state#[norange]
-                                           #[range=user|usage] <usage HUD bar> #[norange]
 ```
 
-- Row 0 keeps tmux's native `window-status-format` so clicking a tab
+- Row 0 splits the line with `#[align=left]` (the pending AI notify
+  queue, capped at 80 cells) and `#[align=right]` (usage, capped at 120
+  cells). `notify` is the explicit-ack pending queue; live pane attention
+  badges are a separate state surface.
+- Row 1 keeps tmux's native `window-status-format` so clicking a tab
   selects the window. The bind uses `if-shell -F
   "#{==:#{mouse_status_range},window}"` to run `select-window -t =`
   natively when the click lands on the window list, so the
@@ -29,18 +33,15 @@ row 1  #[range=user|notify] <notify HUD pill> #[norange] #[range=user|sessionsta
   in `#[range=user|<id>]` ranges and dispatched through the projmux
   handler. The standalone config also wraps the right-side `projmux`
   badge as the `settings` range; the app config renders a compact
-  `⚙` settings chip after the clock. The git segment shows the current
+  `` settings chip after the clock. The git segment shows the current
   branch or detached commit,
   then compact state indicators when available: `*` for local changes,
   `+N` for staged entries, and `↑N`/`↓N` for ahead/behind counts. Each
   state token gets its own compact foreground color while preserving the
-  existing branch block background.
-- Row 1 splits the line with `#[align=left]` (the pending AI notify
-  queue, capped at 80
-  cells, plus the compact `state` entrypoint) and `#[align=right]` (usage, capped at 120 cells). `notify` is the
-  explicit-ack pending queue; live pane attention badges are a separate
-  state surface. Both
-  segments degrade gracefully when the cell budget is tight; see
+  existing branch block background. Window tab indexes stay left of each tab,
+  and tab titles are centered in a fixed-width trim so long active pane names
+  do not resize the status row.
+- Both HUD segments degrade gracefully when the cell budget is tight; see
   [notify-queue.md](notify-queue.md) and [usage-tracking.md](usage-tracking.md)
   for the per-segment tier ladder.
 
@@ -64,7 +65,6 @@ bind-key -n MouseDown1Status if-shell -F "#{==:#{mouse_status_range},window}" \
 | `kube`    | 0 | `projmux tmux popup-toggle sessionizer`   | `prefix s k`  |
 | `git`     | 0 | `projmux tmux popup-toggle sessionizer`   | `prefix s g`  |
 | `settings` | 0 | `projmux tmux popup-toggle --client <tty> ai-split-settings` | mouse only; `prefix s s` remains `session` |
-| `sessionstate` | 1 | show a secondary Session State snapshot status and restore preview popup; primary inspection lives under Projects > Sessions > State | `prefix s r` |
 | `usage`   | 1 | show a native-framed usage HUD popup from cached usage state | `prefix s u`  |
 | `notify`  | 1 | `projmux focus --target <newest> --source status-bar --kind segment-click [--client <tty>]`, then ack on focus success | `prefix s n`  |
 
@@ -80,11 +80,9 @@ the cached usage state in-process, keeps the existing `projmux usage` CLI
 output shape unchanged for external consumers, aligns model/window rows with
 right-aligned numeric values, dims unavailable values, and colors rows at the
 same alert thresholds as the popup: amber at 80% and red at 95%.
-`sessionstate` opens a secondary Session State popup for the current tmux
-session. Its action label is `Save snapshot`, which captures the current tmux
-session as the latest snapshot and bypasses the autosave debounce. Primary
-state inspection lives under `Projects > Sessions > State`; global Settings >
-Session State is settings-only.
+Session State inspection lives under `Projects > Sessions > State`; global
+Settings > Session State is settings-only and the statusbar no longer exposes a
+duplicate State button.
 
 The path popup uses the native picker frame chrome, a one-line title,
 the full wrapped current path, cheap project/git metadata when available, and
@@ -95,12 +93,10 @@ does not leave terminal key state behind. The usage popup uses the same
 single-payload print and plain Enter-close pattern. It shows the authoritative
 last collect timestamp when present, falls back to the cache file mtime when
 needed, and colors that sync line amber once it is more than 60 seconds old.
-The notification HUD detail surface
-(`Alt-2` / `User2`) opens the
-right-side notification popup with newest-first rows. The popup itself is
-untitled; when decoration mode is `symbol` or `emoji`, the bell appears before
-the fzf header text instead. Selecting a row still focuses and acknowledges
-that notification.
+The notification HUD detail surface (`Alt-2` / `User2`) opens the right-side
+notification popup with newest-first rows and an amber title. When notification
+icon decoration is `symbol` or `emoji`, the bell appears before the title text.
+Selecting a row still focuses and acknowledges that notification.
 
 Empty `#{mouse_status_range}` (a click on whitespace) falls through to
 `select-window -t @<mouse_window>` when `--mouse-window` is non-empty,
@@ -116,7 +112,6 @@ bind-key -T projmux-status n run-shell '#{q:projmux} statusbar click notify'
 bind-key -T projmux-status g run-shell '#{q:projmux} statusbar click git'
 bind-key -T projmux-status k run-shell '#{q:projmux} statusbar click kube'
 bind-key -T projmux-status p run-shell '#{q:projmux} statusbar click pwd'
-bind-key -T projmux-status r run-shell '#{q:projmux} statusbar click sessionstate'
 bind-key -T projmux-status s run-shell '#{q:projmux} statusbar click session'
 ```
 
@@ -141,8 +136,6 @@ them as `display-message` toasts:
 - `settings` popup launch failure: toast `statusbar settings: popup failed`.
 - `pwd` path popup failure: fall back to a short `display-message`
   containing the current path.
-- `sessionstate` popup failure: fall back to a compact snapshot status
-  `display-message`.
 - `usage` popup failure: fall back to a compact usage summary
   `display-message`.
 
@@ -160,12 +153,16 @@ emits a deterministic block per segment), regenerate, and re-apply:
 projmux tmux apply
 ```
 
-Settings > Appearance controls the optional decoration mode used by
-the path, git branch, and notification sidebar header. The persisted enum lives at
-`~/.config/projmux/statusbar-decoration`; valid values are `off` (default,
-font-safe), `symbol` (Nerd Font-style folder/GitHub/bell icons), and `emoji`.
-Settings also updates tmux `@projmux_statusbar_decoration` for the live
-server when run inside tmux.
+Settings > Appearance controls optional icon decoration separately for the
+path/cwd marker, git branch marker, and notification sidebar header. Each row
+can be `off` (default, font-safe), `symbol` (Nerd Font-style folder,
+git-provider, or bell icon), or `emoji`. Git branch decoration follows
+`remote.origin.url`: GitHub remotes use a cat-style mark, GitLab remotes use a
+fox-style mark, and other remotes use a generic git branch mark. Settings also
+updates the matching live tmux option
+(`@projmux_statusbar_decoration_cwd`, `_git`, or `_notify`) when run inside
+tmux. The legacy `~/.config/projmux/statusbar-decoration` and
+`@projmux_statusbar_decoration` remain fallback defaults for older configs.
 
 To add a new clickable segment:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projmux",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "tmux project session manager",
   "license": "MIT",
   "homepage": "https://github.com/crevissepartners/projmux#readme",
@@ -24,10 +24,10 @@
     "LICENSE"
   ],
   "optionalDependencies": {
-    "@projmux/darwin-arm64": "0.6.0",
-    "@projmux/darwin-x64": "0.6.0",
-    "@projmux/linux-arm64": "0.6.0",
-    "@projmux/linux-x64": "0.6.0"
+    "@projmux/darwin-arm64": "0.6.1",
+    "@projmux/darwin-x64": "0.6.1",
+    "@projmux/linux-arm64": "0.6.1",
+    "@projmux/linux-x64": "0.6.1"
   },
   "scripts": {
     "package:npm": "scripts/package-npm.sh",