projmux 0.15.3 → 0.16.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (38) hide show
  1. package/README-ko.md +3 -4
  2. package/README.md +3 -3
  3. package/docs/agent-message-replies.md +149 -6
  4. package/docs/ai-agent-shortcuts.md +6 -5
  5. package/docs/architecture.md +467 -66
  6. package/docs/claude-coordination-endpoints.md +192 -20
  7. package/docs/cli-guide.md +872 -148
  8. package/docs/cli.md +1459 -485
  9. package/docs/codex-installed-compatibility.md +6 -11
  10. package/docs/codex-native-required-migration.md +1 -59
  11. package/docs/configuration.md +694 -222
  12. package/docs/globalization.md +18 -5
  13. package/docs/hooks.md +529 -62
  14. package/docs/keybindings.md +74 -4
  15. package/docs/legacy-cli-retirement.md +3 -3
  16. package/docs/legacy-diagnostics-inventory.md +4 -4
  17. package/docs/native-picker.md +3 -5
  18. package/docs/notify-queue.md +1 -1
  19. package/docs/npm-distribution.md +4 -0
  20. package/docs/operational-diagnostics.md +319 -34
  21. package/docs/pr-guideline.md +66 -22
  22. package/docs/release.md +101 -0
  23. package/docs/replacement-contract.md +72 -58
  24. package/docs/repo-layout.md +3 -0
  25. package/docs/resource-attribution.md +6 -2
  26. package/docs/session-restore.md +50 -80
  27. package/docs/settings-ia.md +14 -22
  28. package/docs/statusbar.md +38 -37
  29. package/docs/testing.md +83 -18
  30. package/docs/theme-palette.md +6 -6
  31. package/docs/tmux-surface-inventory.md +21 -10
  32. package/docs/troubleshooting.md +2 -4
  33. package/docs/upgrading.md +161 -24
  34. package/docs/usage-tracking.md +40 -49
  35. package/package.json +5 -5
  36. package/docs/agent-workflow.md +0 -2596
  37. package/docs/codex-generation-pool.md +0 -623
  38. package/docs/codex-stored-qualification.md +0 -45
@@ -110,7 +110,6 @@ Files:
110
110
  - `internal/app/*help*`
111
111
  - `docs/cli.md`
112
112
  - `docs/cli-guide.md`
113
- - `docs/agent-workflow.md`
114
113
 
115
114
  Classification:
116
115
 
@@ -122,6 +121,17 @@ Classification:
122
121
  | Command syntax | `projmux shell`, `make test`, `gh pr create` | `literal` | Preserve exactly. |
123
122
  | Version strings and release tags | `vX.Y.Z`, git SHA, installer source | `data` | Preserve source content. |
124
123
 
124
+ ### Install replacement failures
125
+
126
+ `internal/app/install_replacement*.go` adds the failure explanation, remaining
127
+ target heading, impact, and recovery under `install.replacement.*` catalog keys
128
+ with `en-US` and `ko-KR` entries (`translate`). The pre-existing summary and
129
+ successful/pending install output remain unchanged. Role/refusal tokens,
130
+ `pid`, `revision`, and `unknown` are `literal`; observed pids and revisions are
131
+ `data`, preserved only in the terminal diagnostic. `Codex` and `make install`
132
+ remain literal inside the translated guidance. No process identity is added to
133
+ the persisted outcome or residue ledger.
134
+
125
135
  ## Literal Preservation Rules
126
136
 
127
137
  Do not translate these families:
@@ -365,7 +375,7 @@ Width policy:
365
375
  User override surface:
366
376
 
367
377
  - Environment override: `PROJMUX_LOCALE=auto|en-US|ko-KR`.
368
- - Global config override: `~/.config/projmux/config.toml`:
378
+ - Global config override: `${XDG_CONFIG_HOME:-$HOME/.config}/projmux/config.toml`:
369
379
 
370
380
  ```toml
371
381
  [ui]
@@ -390,9 +400,12 @@ Fallback and warning policy:
390
400
 
391
401
  - `en-US` and `ko-KR` are the only supported UI locales in Phase 5.
392
402
  - Unsupported locale tags such as `ja-JP` or `fr-FR` fall back to `en-US`.
393
- - Settings displays the unsupported tag, its source (`PROJMUX_LOCALE`,
394
- `~/.config/projmux/config.toml`, `LC_ALL`, `LC_MESSAGES`, or `LANG`), and
395
- the effective `en-US` fallback.
403
+ - Settings displays the unsupported tag, its source (`PROJMUX_LOCALE`, the
404
+ global config file, `LC_ALL`, `LC_MESSAGES`, or `LANG`), and the effective
405
+ `en-US` fallback. The global config source is the resolved
406
+ `${XDG_CONFIG_HOME:-$HOME/.config}/projmux/config.toml`, shown as `~/...`
407
+ under `$HOME` and as an absolute path otherwise; with the default
408
+ environment it reads `~/.config/projmux/config.toml`.
396
409
  - Project-local locale override is intentionally out of scope. Any parser
397
410
  support for `[ui] locale` exists only because global and project config share
398
411
  the same TOML implementation; runtime locale resolution consumes only the