fbincon-claude-code-statusline 1.7.4__tar.gz

fbincon_claude_code_statusline-1.7.4/CHANGELOG.md

@@ -0,0 +1,282 @@
+# Changelog
+
+**English** | [简体中文](CHANGELOG.zh-CN.md)
+
+## Unreleased
+
+## 1.7.4 - 2026-10-08
+
+- Rename the distribution to `fbincon-claude-code-statusline` for PyPI while preserving the `claude_statusline` import, `claude-statusline` CLI, configuration ownership and portable exports. Synchronize Python and both Mod manifests at 1.7.4.
+- Add tokenless GitHub Actions publishing from verified Release attachments: exact-tag/main CI gates, TestPyPI acceptance, formal upload on Release publication, index download/install checks and verified retries of partial uploads. Keep the same original assets across PyPI, GitHub and Gitee.
+- Use version-independent PyPI commands in both READMEs, resolve long-description image/document links, expand the repository tree, and document existing wheel migrations and the bilingual maintainer publishing process. Validate strict package metadata in CI.
+
+## 1.7.3 - 2026-10-07
+
+- Report the actual supported display schema in doctor success and migration messages; derive the apply-draft requirement from the same constant. Add read-only legacy/current/future-version regressions.
+- Refresh both README galleries with 21 original TUI screenshots grouped by entry, platform and page. Archive the former 18-image gallery with original PNG bytes, source records and hashes.
+- Audit bilingual README, user/CLI guides, display definitions and development docs. Correct catalog counts to 60 main/14 subagent items, protocol-v4 examples, independent timing/metrics defaults, CI coverage and task-completion explanations; retain historical acceptance records.
+- Document optional execution time, incomplete coverage, canonical task-timer and its prompt-timer alias, and independent native/session/API durations. Synchronize Python and both Mods to 1.7.3 and stable installation links.
+
+## 1.7.2 - 2026-10-07
+
+- Rename the in-session heading to Configure Status Line and match the cyan section titles. Display uppercase letter keys with lowercase descriptions, retaining numbered page labels and standard modifier-key spelling.
+- Consolidate controls in a state-aware wrapping footer. All pages put Tab first; Main/Subagents order is Tab, Space, select, order, format and search. Keep Filter's search entry, show H/A only in the applicable Settings state, and separate editing/recovery controls from ordinary actions.
+- Share footer geometry with keyboard pagination. Minimum 32×12 panes preserve the selected row and a real sample preview, shortening descriptions and omitting secondary hints when height is limited.
+- Accept both ASCII cases for ordinary shortcuts outside editing; preserve literal mixed-case text, Ctrl/Meta combinations and Shift+Tab. Update official regressions, installed terminal acceptance and bilingual instructions.
+- Synchronize Python and both Mods to 1.7.2. Existing configuration, protocols, installation preferences and timing behavior remain compatible; retain historical screenshots and provenance.
+
+## 1.7.1 - 2026-10-07
+
+- Put in-session Client section titles on the frame edge and fill Settings, Layout and item-detail pages using actual group/field rows. Paging retains field offsets and resizing retains draft input and selection.
+- Keep Layout mode, row boundaries and item fitting in consecutive groups, and group item formats before fitting controls. Align field/value columns by terminal cells.
+- Draw white bold shortcut keys and regular dim action descriptions in both editors; fit complete shortcut groups in narrow viewports. Retain h to show/hide clearly named Claude preferences and their separate Apply action.
+- Move the existing Linux, macOS and Windows Layout examples into the README platform galleries. Preserve PNG bytes and capture provenance; remove the duplicated user-guide examples and gallery redirects.
+- Synchronize Python and both Mods to 1.7.1. Display schema v5, configuration protocol v4, runtime protocol v2, saved preferences and installation defaults remain compatible.
+
+## 1.7.0 - 2026-10-07
+
+- Promote the accepted task timing preview after the maintainer confirmed v1.7.0a1 validation on Linux, macOS and Windows. Exact OS, architecture, terminal and host versions were not supplied with this confirmation.
+- Synchronize Python and both Mods at 1.7.0, update stable installation and upgrade links, and publish a new stable Latest release. Compatible stable installs request both editors and preserve recorded disablement; native timing and advanced metrics retain their independent preferences.
+- Retain the accepted task clocks, submission and agent ownership, wait-coverage diagnostics, compatibility aliases and schema contracts: display v5, configuration protocol v4, runtime preferences v2, runtime protocol v2 and lifecycle v4.
+- Require PR, merge and tag CI, fixed-merge package inspection, independent rebuild/install, installed editor and runtime smoke, captured-session revalidation and draft/public asset verification. Preserve the a1 tag, assets, prerelease status and original shared-budget ledger; stable promotion uses no new paid model calls.
+
+## 1.7.0a1 - 2026-10-07
+
+- Replace the prompt clock with a persistent task lifecycle and independent immutable pause/resume clock. Default `task-timer` includes submission, queueing, child agents, reports and main wrap-up; retain `prompt-timer` as an alias in commands, imports, item options and layouts.
+- Add opt-in `task-active-timer`, shown only with complete identity, event, wait and boot-clock evidence. Preserve native turn duration separately; successful endings, failures and interruptions freeze. Treat raw Stop as a candidate, resume on verified activity, and confirm compatibility endings from matched transcript or verified idle evidence.
+- Default native timing metadata on for Claude Code 2.1.289+ while keeping advanced metrics opt-in. Runtime preferences v2 preserve old explicit opt-outs and add independent timing switches; display v5, configuration protocol v4, runtime protocol v2 and lifecycle v4 retain supported older reads and shared compatibility entry points.
+- Use stable Windows boot identity, strict execution-clock degradation and an incremental bounded submission index. Preserve historical frozen values without inventing execution time, and retain explicit background-report/message links across parallel wrap-up.
+- Add regression, default native/disabled collection, shared-budget real Linux lifecycle and history-size performance checks; document migration, downgrade and preview/platform acceptance boundaries. This release is a prerelease with Latest disabled; stable installation links remain at v1.6.1.
+
+## 1.6.1 - 2026-10-05
+
+- Give all four external TUI pages and item forms distinct page titles, continuous groups, aligned columns, selection and separate Preview. Titled frames start at 64×20; 64×18–19 uses compact separators. Global and page controls have separate rows.
+- Group Settings by purpose and separate Layout mode, row boundaries and item fitting. Dispatch legacy controls by stable field key; group headings are nonselectable and consume viewport/paging budget.
+- Isolate pure UI geometry/windows, add boundary/Unicode/color regressions and installed-package five-size PTYs, and document actual captures in both languages. Python and both Mods are 1.6.1; display v4, configuration protocol v3, runtime protocol v1 and recorded preferences remain compatible.
+
+## 1.6.0 - 2026-10-05
+
+- Promote the accepted Phase 5 preview after the maintainer confirmed v1.6.0a1 acceptance on Linux, Windows and macOS. Unprovided OS/architecture/terminal/host metadata remains unknown; retain the known macOS Client input limitation.
+- Synchronize Python and both Mods at 1.6.0 and update current installation/upgrade links. Stable editor defaults enable compatible entries, preserving explicit false; live collection remains independently opt-in and preserves recorded preferences.
+- Retain the eleven opt-in items, committed branch comparison, frozen ended-agent durations and accepted runtime implementation. Display schema v4, configuration protocol v3 and runtime protocol v1 are unchanged from a1; older display files migrate only on save. Preserve preview tags/assets/release type and capture provenance.
+- Require all 20 PR/merge/tag jobs, fixed-merge wheel/sdist inspection and independent rebuild/install, installed-wheel PTYs, draft/public SHA256 and isolated URL installations before stable delivery. Revalidate captured runtime records without new paid calls or resetting the original ledger.
+
+## 1.6.0a1 - 2026-10-05
+
+- Add an independently owned, opt-in live-metrics Mod for fixed Claude Code 2.1.289 hosts, separate from editor enablement.
+- Add strict runtime protocol v1, bounded session/prompt/agent history, atomic concurrent storage, exact retry identities and freshness/invalidation diagnostics.
+- Package both Mods through shared version/hash inventories; extend official installation smoke and fixed-host CI to Windows/macOS 2.1.289. The complete preview uses display schema v4/configuration protocol v3; runtime protocol v1 remains independent.
+
+- Add five opt-in task-scoped state, permission, active-agent, checklist and last-tool items, with deterministic previews, transparent partial markers and read-only diagnostics.
+
+
+- Add cached committed merge-base branch diffs and shared base-ref configuration; move display to schema v4/configuration protocol v3 with write-only migration. Freeze ended subagent duration from reliable end evidence even when live metrics are off; preserve timer priorities.
+
+- Add host-observed latest-request TTFT/output rate and cache-inclusive complete-task token items, verified spawn/lifecycle attribution, explicit incomplete coverage, passive official cost observations and a shared-budget real-session acceptance harness.
+
+## 1.5.0 - 2026-10-05
+
+- Promote the verified Phase 4 preview after maintainer-confirmed Linux/Windows human acceptance and macOS standalone TUI/CLI acceptance. Preserve the historical macOS Client input limitation; exact terminal/OS/host metadata remains unknown.
+- Synchronize Python/Mod at 1.5.0 and stable installation/upgrade links. Both editor entries default on for supported hosts, preserving recorded false and independent compatibility suspension.
+- Retain display schema v3, JSON protocol v2, existing appearance and the accepted formats, explicit layouts, presets, portable files and separate actual-row Claude preference application. Preserve a1 tags/assets and capture provenance.
+- Require PR/merge/tag CI, final installed-wheel PTYs, independent package rebuild/install, SHA256 and public installation verification before stable Latest publication.
+
+## 1.5.0a1 - 2026-10-05
+
+- Keep actual content ahead of scope decoration in narrow explicit rows and preserve form selection when enabled items are removed.
+
+- Add complete scoped forms and Layout to both editors, preset/import/export draft actions, and actual-row Claude appearance/time/title/behavior preferences with separate per-row Apply. Validate real curses Ctrl+S without terminal flow-control loss and extend fixed-host CI to Linux 2.1.289.
+
+- Add editable minimal/developer/monitoring/multi-agent presets and versioned portable JSON import/export. Imports validate before saving, exports exclude installation/runtime/Claude preferences and protect existing files and live resources.
+
+- Add explicit rows with priority/terminal-cell width fitting and shared production previews. Subagent filtering, completed hiding, row and task-text limits emit empty content without changing host order.
+
+- Add opt-in schema-v3 format settings: short models, numeric formats, labels/icons, risk thresholds, used/remaining allowances and reset styles. Read v1/v2 without writes and migrate with a backup on save.
+- Move the internal JSON contract to protocol v2 and preserve all new fields through complete Client/curses saves; retain owned protocol-v1 resources for upgrade/uninstall.
+
+## 1.4.0 - 2026-10-04
+
+- Add opt-in estimated gateway spend amount/period and cumulative input/output tokens. Sum raw cache-inclusive integers using existing all-session snapshots/deltas and expose unavailable data separately from observed zero. The catalog now has 48 main / 14 subagent items.
+
+- Track cumulative input/output observations independently, hide absent counters and preserve known totals and per-counter deltas across partial cost snapshots. Recover availability once for older cached sessions without recounting message IDs.
+
+- Add eleven opt-in cache/session/Git items: cache warmth/expiry and official main request/miss counts, output style, named/full/short session identity and independent Git fields. Share one Git collection across compound/components and retain unknown versus cold cache state.
+
+- Add nine opt-in independent main metrics and four agent metrics, preserving compounds/defaults and schema v2/protocol v1. Suppress expired allowances and provide deterministic countdown previews; document metric scopes and downgrade recovery.
+
+- Add original Linux, Windows and macOS screenshots of the in-session Client with Claude Code 2.1.289 to both READMEs and the image index.
+- Record the maintainer's normal Linux/Windows interaction and unresolved macOS input problem separately from historical acceptance; document official Terminal.app/iTerm2 mouse reporting checks and alternative configuration entries without claiming a verified fix.
+
+## 1.3.0 - 2026-10-04
+
+- Promote the accepted a2 Client interaction after maintainer-confirmed human acceptance on Linux, Windows and macOS.
+- Default both external `/statusline-configure` and in-session `/statusline-configure-native` on, preserving recorded disablement. External needs 2.1.258+, Client 2.1.287+; older/unknown hosts suspend independently and restore after upgrade/reinstall.
+- Persist external disablement as schema-v1 false; suspend verified owned plugins with locked backups/rollback while preserving user plugin disablement. Refresh disabled plugins' owned resources and backend binding during package upgrades.
+- Integrate Native into bilingual README common configuration and user-guide navigation; complete combinations, preference files, compatibility, recovery, upgrades and release instructions, preserving legacy anchors and a2 capture provenance.
+- Synchronize Python/Mod at 1.3.0 and update stable links/Latest; display schemas and JSON protocol v1 remain compatible.
+
+## 1.3.0a2 - 2026-10-04
+
+- Keep `/statusline-configure` as the external terminal TUI and make `/statusline-configure-native` the experimental in-session Client; independently install, disable and use both.
+- Restore enabled owned external resources removed by old native migration; remove the Mod's external alias/primaryCommand, check collisions independently and prune obsolete empty directories so disable/re-enable works after upgrading.
+- Add Client arrow navigation/order, Tab pages, Space toggles, explicit search, Ctrl+G cancellation and s/f saving; explain initial click and host-owned Esc.
+- Separate content/preview with grouped borders, emphasized headings, setting groups, aligned columns and compact layouts; retain separate Claude preference application and uncertain-save checks.
+- Use copied snapshots and cumulative acknowledged input to prevent frozen drafts, lost keys, duplicate saves and stale responses; both save paths share revision protection.
+- Cover installation combinations, upgrade recovery, cross-editor saves, Client, distributions and real PTYs; update bilingual guides and capture provenance.
+- Record a1 human acceptance on all three platforms; a2 Client human acceptance was separately pending at preview publication. Prerelease publication keeps Latest at v1.2.0.
+
+## 1.3.0a1 - 2026-10-04
+
+- Preview direct checked native item rows, horizontal tabs, paged content, compact settings and a bounded bottom sample preview.
+- Match standalone TUI ordering for enabled/disabled and filtered items; preserve per-scope selection and request focus after page changes.
+- Add f save/close alongside s save/continue; fold host preferences behind h and retain pending preferences, independent application and unknown-save reconciliation.
+- Separate editor/navigation/numeric logic and UI components/pages; package nested runtime modules and validate staging/cache resources.
+- Record the isolated Client focus/key limitation and new automated checks; keep stable v1.2.0 and require new three-platform human acceptance for v1.3.0.
+
+## 1.2.0 - 2026-10-04
+
+- Promote the native configuration editor after confirmed human acceptance on Linux, Windows 11 and macOS 14.5. Unprovided architecture/terminal details remain unknown.
+- Prefer native integration by default on compatible hosts, preserving explicit native/plugin disablement and compatibility fallbacks.
+- Keep explicit compatibility preference repair and force behavior available on older hosts; independently validate stable default activation and compatibility smoke.
+- Synchronize Mod/backend versions, stable installation links, acceptance records and release documentation. UI/runtime modules remain the accepted preview implementation.
+
+## 1.2.0a1 - 2026-10-04
+
+- Add the native Main, Subagents and Settings editor with catalog-driven selection, exclusions, ordering and sample preview. Save complete drafts with revision protection, retain the pane after success, and check uncertain save outcomes before retry.
+- Apply actual theme/verbose host preferences separately and report locked/refused/partial results. Preserve drafts in narrow panes and invalidate stale responses on close/reload.
+- Bundle matching runtime Mod resources in wheels from one maintained source. Install through an owned local marketplace, bind the selected backend, migrate owned configure entries, preserve explicit disablement, and support suspension, downgrade and uninstall recovery.
+- Diagnose resource hashes, versions, protocol, enablement and backend binding separately from unverified current-session loading. Fix Windows npm/console entry resolution and macOS aliases.
+- Share the scoped catalog and JSON describe/read/preview/apply contracts with CLI/curses/wizard; add generated TypeScript, platform native checks and documented real terminal captures.
+- Keep preview native integration opt-in and v1.1.1 as Latest. Linux human acceptance is confirmed; Windows/macOS native human acceptance is pending, so stable v1.2.0 remains gated.
+
+## 1.1.1 - 2026-10-03
+
+- Preserve full multi-agent task duration before and after final Stop, including main-agent wrap-up.
+- Freeze failure/interruption evidence and make duplicate terminal hooks and single-turn calibration idempotent.
+- Keep transcript prompt ownership across incremental reads and queued hooks; reject unowned durations and invalid values.
+- Clarify task, native-turn, session-runtime and API-wait definitions; correct the `cost` description.
+
+- Keep background-agent result notification IDs in the original human task and wait for outstanding reports before final wrap-up.
+- Resolve submission evidence before freezing and prevent later transcript scans from changing terminal duration.
+- Split implementation into configuration, rendering, runtime, integration, UI and platform subsystems; retain legacy Python entry points and isolate shared storage/ownership.
+- Group tests by subsystem, fix moved source/Terminal paths, and centralize bilingual documentation, package checks and opt-in acceptance under `tools/`.
+
+## 1.1.0 - 2026-10-03
+
+- Promote macOS core functionality and the standalone TUI to supported status on macOS 14+, Intel / Apple Silicon, CPython 3.10–3.14, retaining native process identity, sleep-inclusive timing, and POSIX file safety.
+- Add Terminal.app to experimental `/statusline-configure` outside valid tmux sessions, using system `open` and private `.command` files. Window handling follows Terminal preferences without AppleScript automation permission.
+- Bind the Terminal launcher to the current Python, CLI, configuration directory, and working directory, supporting spaces, Chinese characters, and shell metacharacters. Use a separate startup handshake, process identity verification, and schema v1 result bridge for launch failure, window closure, interruption, parent-call exit, and timeout.
+- Check call liveness and deadlines during TUI polling and under the configuration transaction lock, preventing expired calls from saving. Revoked calls reap only the matching editor process and clean up their private files.
+- Update CLI help, package description, and macOS `doctor` diagnostics. Diagnostics check Terminal and graphical-session conditions without opening desktop terminals. Configuration/result schemas, Linux/Windows behavior, and the disabled-by-default experimental entry point remain compatible.
+- Fix false failures from partial PTY reads, add Terminal lifecycle and native helper tests, and extend `.DS_Store` ignore rules and distribution checks.
+- Publish stable v1.1.0 wheel, source distribution, and SHA256SUMS. Unify installation and upgrade entry points for Linux/WSL, Windows, and macOS while preserving historical support boundaries.
+- Complete the release guide with builds from verified commits, draft-asset verification, publication, and isolated installation after download. CI checks source/package versions, documentation, and screenshots, and excludes local acceptance records and system caches.
+- Include eight original macOS / Windows screenshots of the main status line and three TUI pages, standardizing filenames, index, and README display. CI checks packaging of screenshots from all platforms.
+
+## 1.1.0a1 - 2026-10-02
+
+- Add macOS preview support for the main status line, subagent rows, installation/configuration commands, and standalone curses TUI. Experimental `/statusline-configure` uses only preflight-verified tmux popup.
+- Share POSIX file locking, private permission repair, atomic replacement, and parent-directory sync between Linux/macOS. Degrade only when the macOS filesystem cannot sync directories; real I/O errors continue to propagate.
+- Use C locale / UTC `ps -o lstart=` start identity in the macOS session registry, filtering matching sessions before querying processes. Lazy-loaded LibSystem `mach_continuous_time`, `mach_timebase_info`, and `kern.bootsessionuuid` provide sleep-inclusive timing and reboot detection; unavailable interfaces cause the whole group to fall back to wall-clock time.
+- Add macOS preview, architecture, OS version, curses, process, clock, directory-sync, and experimental tmux diagnostics to `doctor`. The standalone TUI gives a clear error when curses is missing.
+- Poll input in the macOS standalone TUI so older curses/CPython 3.10 promptly handles SIGINT and other signals without further keystrokes. PTY tests establish a foreground controlling terminal and keep reading output while waiting for exit.
+- Add macOS 15/26 × Intel/Apple Silicon × Python 3.10/3.14 CI, extend PTY/tmux integration, and produce platform validation reports. Pin the ARM64 Python 3.10 lower bound to 3.10.11.
+- Publish v1.1.0a1 preview wheel, source distribution, and SHA256SUMS for macOS evaluation. Linux/WSL and Windows users can still choose stable v1.0.0; the preview also includes existing functionality for those platforms.
+- Synchronize package version, CLI/CI version assertions, installation/upgrade entry points, and release guide. Display schema v2, feature schema v1, old configuration, and runtime state remain compatible without migration.
+- Published v1.0.0 packages and tag do not include macOS support. Actual Claude visuals, real sleep/resume, and desktop-terminal experience have not been manually accepted; macOS remains a preview.
+
+## 1.0.0 - 2026-09-04
+
+- Adjust Git staged-count spacing by platform: native Linux retains `● N`; Windows and WSL use `●N`. Detect WSL through both environment variables and kernel release.
+- Extend platform support from Linux to Linux/WSL and native Windows 10/11. Windows supports CPython 3.10–3.14 x86/x64; macOS remains unsupported, and native Windows ARM64 Python is not guaranteed.
+- Add a centralized platform adapter: Linux retains `fcntl.flock`, `0600/0700`, and parent-directory `fsync`; Windows uses lazy-loaded `msvcrt` fixed-byte locks, inherited ACLs, atomic replacement with sharing-violation/access-denied retries, and durable unlink.
+- Validate Windows session-registry `procStart` through `OpenProcess(PROCESS_QUERY_LIMITED_INFORMATION)`, `GetProcessTimes`, and local `.NET DateTime.Ticks` conversion. Timing uses sleep-inclusive `GetTickCount64` and a minute-quantized boot identity, falling back to wall-clock time when APIs are unavailable.
+- Install Windows commands as `claude-statusline.exe render`, `render-subagents`, `hook`, and `slash-hook`, executable by Git Bash and PowerShell. Linux retains absolute paths with POSIX quoting. Ownership accepts canonical names, case-insensitive `.exe`, and PATH aliases resolving to the current entry point.
+- Preauthorize narrow Bash/PowerShell config rules in the Windows `/statusline-config` skill. The `/statusline-configure` fallback disables both Bash and PowerShell. Add Windows executable, ACL/mode differences, `windows-curses`, and system new-console diagnostics to `doctor`.
+- Add conditional dependency `windows-curses>=2.4.2; sys_platform == "win32"` to metadata. Linux and Windows share the Main/Subagents/Settings full-screen TUI, registering only available platform signals and supporting PDCurses resize.
+- Add a Windows `CREATE_NEW_CONSOLE` launcher for `/statusline-configure`, running the current environment's `python -m claude_statusline configure` with a retained child handle, real terminal I/O, 570/585-second deadlines, cleanup after closure/failure/timeout, and schema v1 result bridging. Linux tmux/GNOME behavior remains unchanged.
+- Reject symlinks, junctions, other reparse points, out-of-bounds paths, nonregular files, and results over 16 KiB in the Windows bridge; do not mistake NTFS simulated POSIX modes for corruption. Long-path wrapping recognizes `/` and `\`; `full` style preserves payload separators.
+- Retain display schema v2, feature schema v1, caches, lifecycle ledger, defaults, Claude Code 2.1.205/2.1.258 thresholds, and old Linux installation-ownership semantics without migration.
+- Add Ubuntu/Windows × Python 3.10/3.14 CI, PowerShell/Git Bash and Linux smoke tests, and sdist/wheel checks for version, conditional dependencies, skills, and platform modules.
+
+## 0.9.0 - 2026-09-03
+
+- Add subagent item `status-elapsed`, combining status icon and duration (such as `⏱ 1m 18s`, `✓ 0m 42s`) into one unit, replacing `status` and `elapsed` as defaults. Default output changes from `⏱ Explore · sonnet-5/high · Context 58% left · 1m 18s · searching auth flow` to `⏱ 1m 18s · Explore · sonnet-5/high · Context 58% left · searching auth flow`.
+- Make `status-elapsed` mutually exclusive with `status` and `elapsed` in `subagents.items`: validation and CLI set-items/enable/disable/order/apply reject combinations; selecting one in the interactive wizard deselects conflicting items.
+- Show only the icon when `startTime` is missing or invalid; future timestamps count as 0 seconds. Like old `elapsed`, completed tasks keep counting because the payload has no endTime; durations still use floor rounding.
+- Treat `status-elapsed` as a core narrow-screen item like `status`: always retain it, reducing it to an icon at extreme widths rather than adding it to optional-segment drop order.
+- Update renderer, catalog, preview, validation, wizard, CLI, and documentation tests.
+
+## 0.8.0 - 2026-09-03
+
+- Add subagent `context-remaining`, displaying `Context N% left`: round the used percentage from `tokenCount / contextWindowSize`, subtract it from 100, and clamp to 0–100. It replaces `context-used` as the default subagent context item.
+- Keep subagent `context-used` optional, changing `ctx N%` to main-line-compatible `Context N% used`. Configuration structure is unchanged, but existing configurations enabling it see new text.
+- Show remaining context by default for installations without display configuration. Both context items participate in narrow-screen dropping: `current-dir → tokens → context-used → context-remaining → model-with-effort → task`.
+- Enable and reorder the new item through CLI, TUI, or `/statusline-config`; update renderer, catalog, preview, and documentation tests.
+
+## 0.7.0 - 2026-09-03
+
+- Add three disabled-by-default main-agent items: `context-used` from Claude's official payload, `project-name` from the launch project's directory basename, and `hostname` from Python's standard library.
+- Configure `context-used` and `context-remaining` independently or together. Group `current-dir`, `project-name`, and `hostname` as location items, validating new text for missing values, ranges, control characters, and ANSI safety.
+- Retain schema v2, the ten original `DEFAULT_ITEMS`/`LEGACY_DEFAULT_ITEMS`, old configuration, and default output. Enable new items explicitly through CLI, TUI, or `/statusline-config`.
+- Extend the all-items preview to 24 deterministic main items, with fixed hostname `devbox`, without reading the real hostname. Subagent renderer, catalog, and defaults remain unchanged.
+
+## 0.6.0 - 2026-09-03
+
+- Add first-class official Claude Code `subagentStatusLine` support and frequent `render-subagents` NDJSON execution. Show status, name, model/effort, context, duration, and task, with optional tokens/cwd, ANSI/CJK/emoji-safe width limits, and silent degradation on corrupted input.
+- Make `prompt-timer` measure end-to-end time from user submission to the main agent's final `Stop`. Add `SubagentStart`/`SubagentStop` ledger, `waiting_subagents`/`resuming_main` phases, authoritative `background_tasks` synchronization, and suppression of premature registry/transcript completion.
+- Add `off/when-subagents/always` main-line scope labels, defaulting to fixed `Main/Session` only after the current prompt has launched subagents. Session token aggregation remains unchanged.
+- Upgrade display configuration smoothly to strict schema v2. Schema v1 is migrated in memory without render/doctor/install rewrites; the first actual save backs up original bytes and atomically writes canonical v2.
+- Add complete `config subagents ...` commands, `subagent-statusline`/`scope-labels`, and backward-compatible optional `config apply` arguments. Upgrade the TUI to Main/Subagents/Settings tabs; the slash wizard submits all fields together.
+- Add installer threshold Claude Code 2.1.205, ownership states owned/absent/foreign/unsupported, rejection of the full operation on foreign ownership with `--force` takeover, suspension on disabling/downgrade, and restoration on upgrade. Uninstall removes only owned subagent settings and hooks.
+- Expand renderer, Unicode width, lifecycle, migration, installation transaction, TUI/Slash, CLI, and doctor tests; update build, upgrade, downgrade, and manual multi-agent acceptance documentation.
+
+## 0.5.0 - 2026-09-03
+
+- Add disabled-by-default experimental `/statusline-configure`, persistently enabled with `install --experimental-slash-tui` and permanently disabled with `--no-experimental-slash-tui`, alongside `/statusline-config`.
+- Add tmux `90% × 90%` popup and active GNOME Terminal tab launchers, reusing `claude-statusline configure`. When neither is available, block locally and suggest the standalone command without calling the model.
+- Add private atomic result bridging for save, no changes, cancellation, interruption, timeout, and errors to the Claude conversation. Hook/TUI/launcher timeouts are 600/570/585 seconds.
+- Extend installation to a unified transaction for settings, feature file, and two owned skills, with explicit repair of corrupted preferences, downgrade suspension/upgrade restoration, strict ownership, dry-run, backups, and original-byte rollback.
+- Add doctor checks for feature schema/permissions, disabled/enabled/suspended state, experimental skill/owner/matcher/timeout, and launcher availability. Add launcher, PTY bridge, and real tmux popup integration tests.
+- Document that this is not a native Claude Code TUI extension, never accesses `/dev/tty`, uses a new GNOME tab, and has a model-turn fallback exception under `disableAllHooks`.
+
+## 0.4.0 - 2026-09-03
+
+- Add stable standalone `claude-statusline configure [--config-dir PATH]`, providing full-screen Items/Settings tabs in real Linux terminals, with Space selection, navigation, filtering, Left/Right ordering, and numeric editing.
+- Add per-keystroke `Preview (sample data)`, reusing production formatting, grouping, and wrapping with deterministic samples only. It reads no Git, transcripts, network, or current runtime state, and creates no cache.
+- Enter atomically submits display and host configuration; Esc and signals restore the terminal without writing. Below `64x18`, wait for resizing.
+- Add TUI baseline concurrency protection: detect semantic changes to display, host, or installation ownership under the existing lock before backup, preserving unrelated `settings.json` updates.
+- Retain display schema version 1 without migration or disabled-item order persistence. `/statusline-config` skill, slash shortcut hook, and existing renderer/hook behavior remain unchanged.
+
+## 0.3.2 - 2026-09-03
+
+- Capitalize display prefixes `Session`, `Git`, `Repo`, `Worktree`, and `Agent`; change the Git error marker to `Git!`.
+- Prefix cost amounts with `Total`, such as `Total $0.12 · 12m 30s · +156/-23`. `vim NORMAL` is outside this change and remains unchanged.
+
+## 0.3.1 - 2026-09-03
+
+- Refactor grouping/colors: `model-with-effort`, `fast-mode`, and `thinking` together in ivory; `tokens`/`prompt-cache` in pink; `git`/`pr`/`repo` in purple. `version`, `session`, `cost`, `agent`, `vim-mode`, and `worktree` remain independent.
+- Add prefixes to `session`, `git`, and `repo`: `session xxxxx`, `git xxxxx`, `repo xxxxx`.
+- Place group members together in catalog order; new wizard-enabled items append after group anchors.
+
+## 0.3.0 - 2026-09-03
+
+- Add 11 optional items from Claude Code 2.1.258+ public status-line payload: `version`, `session`, `cost`, `prompt-cache`, `fast-mode`, `agent`, `vim-mode`, `thinking`, `pr`, `worktree`, and `repo`.
+- Disable new items by default, keeping default output identical to 0.2.0; enable explicitly with `/statusline-config enable`.
+- Show session cost, API duration, and line changes in `cost` (estimated amounts for third-party APIs); show cache hit rate and written tokens in `prompt-cache`.
+- Update `/statusline-config` wizard groups to enable new items through selection.
+
+## 0.2.0 - 2026-09-03
+
+- Add strict user-global JSON display configuration, optional items, and persistent ordering.
+- Add colors, ANSI palette, directory formats, separators, and Claude Code host settings.
+- Add `/statusline-config` personal skill and local slash-hook shortcut execution for newer Claude Code.
+- Automatically manage skill and shortcut hook, degrade gracefully on older Claude Code, and preserve preferences on uninstall.
+- Retain unconfigured 0.1.0 output and skip unnecessary Git/transcript work according to enabled items.
+
+## 0.1.0 - 2026-09-02
+
+- Package the existing Claude Code status-line renderer and per-turn lifecycle hook as a standalone CLI.
+- Add safe, idempotent installation, uninstallation, and diagnostics.
+- Support `CLAUDE_CONFIG_DIR`, retaining existing runtime-state and cache layout.
+- Preserve model, directory, Git, context, limits, tokens, and timer display behavior.

fbincon_claude_code_statusline-1.7.4/CHANGELOG.zh-CN.md

@@ -0,0 +1,281 @@
+# Changelog
+
+[English](CHANGELOG.md) | **简体中文**
+
+## Unreleased
+
+## 1.7.4 - 2026-10-08
+
+- 将分发名改为 `fbincon-claude-code-statusline` 用于 PyPI，保留 `claude_statusline` 导入、`claude-statusline` CLI、配置归属与可移植导出；Python 与两个 Mod manifest 同步为 1.7.4。
+- 新增基于已验证 Release 附件的 GitHub Actions 可信发布：准确标签／主分支 CI 门槛、TestPyPI 验收、公开 Release 后正式上传、索引下载／安装验证与部分上传重试校验。PyPI、GitHub 和 Gitee 使用相同原始附件。
+- 双语 README 使用不依赖项目版本的 PyPI 命令，修复长描述图片／文档链接并展开仓库结构；补充旧 wheel 迁移及双语维护者发布流程，CI 增加严格包元数据检查。
+
+## 1.7.3 - 2026-10-07
+
+- doctor 成功与迁移提示显示实际支持的显示 schema，apply 草稿要求使用同一版本常量；补充旧版、当前及版本常量变化的只读回归。
+- 用 21 张原始 TUI 截图更新双语 README，按入口、平台和页面组织；原 18 张图库图片归档并保留 PNG 字节、来源和哈希。
+- 核对双语 README、使用／CLI 指南、显示项和开发文档，修正 60 个主栏／14 个子 Agent 项、协议 v4 示例、独立计时／指标默认值、CI 覆盖和任务完成说明，保留历史验收数据。
+- 补充可选执行耗时、覆盖不足、task-timer 及 prompt-timer 别名，以及独立原生／会话／API 耗时说明；Python 和两个 Mod 同步至 1.7.3，更新稳定安装链接。
+
+## 1.7.2 - 2026-10-07
+
+- 会话内大标题改为 Configure Status Line，使用与分区标题一致的青色；字母按键显示大写、作用说明小写，保留数字页签名称和标准组合键写法。
+- 快捷键集中到底部，按状态展示并完整换行。各页 Tab 优先；Main/Subagents 顺序为 Tab、Space、选择、排序、格式、搜索。保留 Filter 搜索入口，Settings 按对应状态展示 H/A，编辑／恢复操作与普通动作分开。
+- 底部行数与键盘分页共用布局预算；32×12 保留选中项和实际样例预览，高度不足时缩短说明并省略次要提示。
+- 普通快捷键在非编辑状态兼容 ASCII 大小写，保留混合大小写输入、Ctrl/Meta 与 Shift+Tab；更新官方回归、已安装终端验收和双语说明。
+- Python 与两个 Mod 同步至 1.7.2；配置、协议、安装偏好和计时行为兼容，历史截图及来源记录保留。
+
+## 1.7.1 - 2026-10-07
+
+- 将会话内 Client 栏目标题移入框线，Settings、Layout 和格式详情按实际分组／字段行数填满后分页；翻页保留页内字段位置，缩放保留草稿输入和选中项。
+- Layout 将模式、行边界、逐项适配连续排列，格式详情先集中格式再显示适配控件；按终端显示单元对齐字段与值。
+- 两编辑器使用白色粗体按键与普通弱化作用说明，窄窗口只显示完整快捷键组；保留 h 展开／收起明确命名的 Claude preferences 与独立 Apply。
+- 将现有 Linux、macOS、Windows Layout 示例移入 README 对应平台图库，保留 PNG 字节和捕获来源；移除用户指南重复示例与图库跳转文字。
+- Python 和两 Mod 同步为 1.7.1；显示 schema v5、配置协议 v4、运行协议 v2、已保存偏好及安装默认行为继续兼容。
+
+## 1.7.0 - 2026-10-07
+
+- 维护者确认 v1.7.0a1 在 Linux、macOS、Windows 三个平台验证完成后，将已验收任务计时预览晋升正式版；本次确认未提供具体 OS、架构、终端或宿主版本。
+- Python 和两 Mod 同步为 1.7.0，更新稳定安装／升级链接，建立新的稳定 Latest Release。兼容宿主正式安装默认请求两个编辑器，保留已保存的关闭选择；原生计时和高级指标继续使用独立偏好。
+- 沿用已验收任务时钟、提交与 Agent 归属、等待覆盖诊断、兼容别名及协议：显示 v5、配置协议 v4、运行偏好 v2、运行协议 v2、生命周期 v4。
+- 完成 PR／合并／标签 CI、固定合并分发包检查、独立重建／安装、已安装编辑器及运行 smoke、捕获会话复核和草稿／公开资产验证后发布。保留 a1 标签、资产、预览状态及原共享预算账本；正式晋升不新增付费模型调用。
+
+## 1.7.0a1 - 2026-10-07
+
+- 将 prompt 计时重构为持久任务生命周期及独立、不可变的暂停／恢复时钟。默认 `task-timer` 包含提交、排队、子 Agent、报告及主 Agent 收尾；CLI、导入、逐项选项和布局保留 `prompt-timer` 别名。
+- 新增默认关闭的 `task-active-timer`，仅在身份、事件、等待和启动时钟证据完整时显示。原生单轮耗时独立保存，完成、失败及中断冻结；原始 Stop 为候选，可信活动继续原任务，匹配 transcript 或已核验 idle 确认兼容终态。
+- Claude Code 2.1.289+ 默认采集必要计时元数据，高级指标仍按需启用。运行偏好 v2 保留旧版显式关闭并增加独立计时开关；显示 v5、配置协议 v4、运行协议 v2、生命周期 v4 支持旧版读取和共享兼容入口。
+- 使用稳定 Windows 启动身份、严格执行时钟退化判断和增量有界提交索引；保留历史冻结值，不推算缺失执行时间。并行收尾保留后台报告及消息的明确关联。
+- 补齐回归、默认原生／关闭采集、共享预算真实 Linux 生命周期及不同历史规模性能验证，说明迁移、降级和预览验收边界。本版为非 Latest 预览版，稳定安装链接继续指向 v1.6.1。
+
+## 1.6.1 - 2026-10-05
+
+- 统一外部 TUI 四页与格式详情的页面标题、连续分组、对齐栏目、选中行和独立 Preview。64×20 起使用标题边框，64×18–19 使用紧凑分隔；全局与页面操作分行显示。
+- Settings 按用途归组，Layout 将模式、行边界与逐项适配集中排列；用稳定字段 key 分派原有设置，分组标题不参与选择，滚动与分页计入标题高度。
+- 在 UI 子系统独立纯布局与窗口预算，补充边界／Unicode／色彩回归、安装包五尺寸 PTY、真实捕获与双语文档。Python 和两 Mod 同步 1.6.1；显示 v4、配置协议 v3、运行协议 v1 及已保存偏好继续兼容。
+
+## 1.6.0 - 2026-10-05
+
+- 维护者确认 v1.6.0a1 在 Linux、Windows、macOS 验收通过后晋升完整 Phase 5 预览；未提供的 OS／架构／终端／宿主信息保持未知，保留已知 macOS Client 输入限制。
+- Python 和两 Mod 同步为 1.6.0，更新当前安装／升级链接。兼容入口采用正式编辑器默认启用行为，保留明确 false；实时采集继续独立默认关闭并保留已有偏好。
+- 沿用十一项可选指标、已提交分支比较、结束代理时长冻结和已验收运行实现。显示 schema v4、配置协议 v3、运行协议 v1 与 a1 一致，旧显示文件仅真实保存迁移；保留预览标签／资产／发布状态及截图来源。
+- 正式交付要求全部 20 项 PR／合并／标签 CI、固定合并 wheel／sdist 检查与独立重建／安装、安装 wheel 的 PTY、草稿／公开 SHA256 和隔离 URL 安装。免费重验捕获运行记录，不新增付费调用或重置原账本。
+
+## 1.6.0a1 - 2026-10-05
+
+- 新增独立所有权、默认关闭的实时指标 Mod，固定验证 Claude Code 2.1.289，与编辑器启用偏好分离。
+- 新增严格运行协议 v1、有界会话／prompt／代理历史、原子并发存储、准确重试身份及心跳／失效诊断。
+- 通过共享版本／哈希清单打包两 Mod，扩展实际官方安装 smoke 和 Windows／macOS 2.1.289 CI。完整预览使用显示 schema v4／配置协议 v3，运行协议 v1 独立。
+
+- 新增五个默认不选中的任务级运行状态、权限、活跃代理、清单和最近工具项，支持确定性预览、明确的部分覆盖标记和只读诊断。
+
+- 新增缓存的已提交 merge-base 分支差异和共享基准配置，显示升级为 schema v4、配置协议 v3，仅真实保存迁移。可靠结束证据冻结代理时长，关闭实时采集仍可用；保持计时器优先级。
+
+- 新增宿主观测的最新请求 TTFT/输出率、缓存完整口径任务 token、可靠启动/生命周期归属、明确部分覆盖、被动官方费用观测和统一预算的真实会话验收工具。
+
+## 1.5.0 - 2026-10-05
+
+- 维护者确认 Linux／Windows 人工验收及 macOS 独立 TUI／CLI 通过后，晋升已验证 Phase 4 预览；保留历史 macOS Client 输入限制，具体终端／OS／宿主元数据仍未知。
+- Python／Mod 同步 1.5.0，更新正式安装／升级链接；兼容宿主默认启用两入口，保留明确 false 及独立兼容暂挂。
+- 沿用显示 schema v3、JSON 协议 v2、默认外观及已验收的格式／显式布局／预设／可移植文件／独立实际行 Claude 偏好应用；保留 a1 标签、资产与截图来源。
+- 正式 Latest 发布前完成 PR／合并／标签 CI、最终 wheel PTY、独立包重建／安装、SHA256 与公开安装验证。
+
+## 1.5.0a1 - 2026-10-05
+
+- 窄显式行优先保留实际内容，避免仅剩范围标签；移除启用项目后保持表单选择有效。
+
+- 两种编辑器完整支持逐项表单、Layout、预设／导入／导出草稿操作；Claude 实际外观／时间／标题／行为行独立逐项 Apply。验证 curses Ctrl+S 不被终端流控吞掉，固定宿主 CI 增加 Linux 2.1.289。
+
+- 新增四种可编辑预设和独立版本的可移植 JSON 导入导出；导入先验证，导出排除安装／运行数据／Claude 偏好，并保护已有文件和实时资源。
+
+- 新增显式行、优先级与终端列宽精简，并与生产预览共用管线；子 Agent 筛选、隐藏完成、行数和任务文本限制输出空内容，保留宿主顺序。
+
+- 新增 schema v3 格式选项：模型简称、数字格式、标签／图标、风险阈值、已用／剩余额度和重置格式；v1/v2 读取不写文件，保存时备份迁移。
+- 内部 JSON 契约升级至协议 v2，Client／curses 完整保存保留新增字段；兼容旧协议资源的升级和卸载所有权检查。
+
+## 1.4.0 - 2026-10-04
+
+- 新增默认关闭的网关估算金额／周期和累计输入／输出 token；复用会话快照／增量，以原始整数相加缓存读取、写入与普通输入，区分未观测和合法零值。目录达到 48 个主栏／14 个子 Agent 项。
+
+- 累计输入／输出独立记录可用性，隐藏缺失计数器，不完整累计快照保留已知总量及各自增量；旧会话缓存仅恢复一次可用性，不重复累计消息 ID。
+
+- 新增十一个默认关闭的缓存／会话／Git 项：缓存状态、TTL、官方主对话请求及 miss 数、输出样式、名称／完整／短会话 ID 和独立 Git 分项；组合与分项共享一次 Git 采集，区分未观测缓存与 cold。
+
+- 新增九个默认关闭的独立主栏指标和四个子 Agent 指标，保留组合项、默认选择及 schema v2／协议 v1；隐藏过期额度，提供固定倒计时预览，说明指标作用域与降级恢复。
+
+- 在中英文 README 与截图索引中加入显示 Claude Code 2.1.289 的 Linux、Windows、macOS 会话内 Client 原始截图。
+- 单独记录维护者反馈的 Linux、Windows 正常交互与 macOS 尚未解决的输入问题，保留历史验收事实；补充 Terminal.app、iTerm2 官方鼠标报告检查建议及其他配置入口，不宣称已验证修复。
+
+## 1.3.0 - 2026-10-04
+
+- 维护者确认 v1.3.0a2 在 Linux、Windows、macOS 真人验收通过，正式版沿用已验收 Client 交互。
+- 正式安装默认启用外部 `/statusline-configure` 与会话内 `/statusline-configure-native`，保留明确关闭偏好；外部需 2.1.258+，Client 需 2.1.287+，低版本/未知宿主分别暂挂，升级后重装恢复。
+- 外部关闭持久保存 schema v1 的 false；版本暂挂在备份和锁保护下关闭已核验所属的插件，保留用户主动禁用，并支持失败回滚。升级时更新已禁用插件的所属资源和后端绑定，保持禁用状态。
+- 将 Native 操作整合到双语 README 常用配置与用户指南，补齐安装组合、偏好文件、兼容性、恢复、升级及发布说明；保留历史锚点和 a2 图片来源。
+- Python/Mod 同步 1.3.0，当前稳定安装入口和 Latest 更新至 v1.3.0；配置 schema 与 JSON 协议 v1 保持兼容。
+
+## 1.3.0a2 - 2026-10-04
+
+- 保留 `/statusline-configure` 的外部终端 TUI，`/statusline-configure-native` 改为当前 session 的实验性 Client；两入口独立安装、关闭和并存。
+- 恢复旧原生迁移移除的已启用 owned 外部资源，取消 Mod 的外部命令别名和 primaryCommand，分别检查命令冲突；清理旧版空目录，支持禁用后再次启用。
+- Client 提供方向键导航/排序、Tab 切页、Space 勾选、显式搜索、Ctrl+G 取消、s 保存及 f 完成；明确点击获焦和宿主 Esc 行为。
+- 分组边框、强调标题、设置分组、栏目对齐和紧凑布局区分内容与预览；保留高级偏好独立应用与结果不明核对。
+- 使用深复制快照及有序累计消息确认，避免冻结、丢键、重复保存及迟到响应；两种保存路径共用 revision 防覆盖。
+- 补充安装组合、升级恢复、跨编辑器保存、Client、分发和真实 PTY 检查，更新双语指南及画面来源。
+- 记录 a1 三平台真人通过；a2 Client 真人验收在预览发布时另记待验收。预览发布不更改 Latest v1.2.0。
+
+## 1.3.0a1 - 2026-10-04
+
+- 预览原生直接勾选行、横向页签、分页正文、紧凑设置及限高底部样例预览。
+- 启用/未启用项目及过滤排序与独立 TUI 一致，保留作用域当前项目并在切页后请求焦点。
+- 增加 f 保存关闭，保留 s 保存继续；h 折叠宿主偏好，保留待应用值、独立应用及未知保存核对。
+- 按编辑/导航/数字逻辑及 UI 控件/页面展开结构，运行包包含嵌套模块，检查暂存和官方缓存。
+- 记录隔离 Client 焦点/按键限制和新自动检查；稳定版保持 v1.2.0，v1.3.0 要求新的三平台真人验收。
+
+## 1.2.0 - 2026-10-04
+
+- Linux、Windows 11、macOS 14.5 真人验收明确通过后，发布稳定原生编辑器；未提供的架构/终端信息记为未知。
+- 兼容宿主默认优先原生，保留明确的原生/插件禁用及兼容回退。
+- 老宿主仍支持明确的兼容偏好修复和 force 行为，独立验证稳定默认启用及兼容 smoke。
+- 同步 Mod/后端版本、稳定安装链接、验收和发布文档，UI 运行模块保留已验收的预览实现。
+
+## 1.2.0a1 - 2026-10-04
+
+- 增加原生 Main、Subagents、Settings 三页，使用共享目录选择、互斥、排序和样例预览；完整草稿以 revision 保护保存，成功后保持面板，未知结果先读取核对再重试。
+- 实际 theme/verbose 宿主偏好独立应用，报告锁定、拒绝和部分成功；窄面板保留草稿，关闭/重载使旧响应失效。
+- wheel 从唯一维护源打包匹配的 Mod 运行资源，通过所属本地 marketplace 接入，绑定实际后端并迁移所属配置入口，保留明确禁用，支持暂停、降级及卸载恢复。
+- doctor 分别核对资源哈希、版本、协议、启用和后端绑定，不把磁盘安装当作会话加载；修复 Windows npm/console 入口及 macOS 路径别名。
+- 与 CLI/curses/向导共享目录及 JSON describe/read/preview/apply，增加生成的 TypeScript、平台原生检查和注明来源的真实终端画面。
+- 预览保持原生显式启用，Latest 仍为 v1.1.1；Linux 真人验收已确认，Windows/macOS 原生真人验收待完成，稳定 v1.2.0 保留门槛。
+
+## 1.1.1 - 2026-10-03
+
+- 在最终 Stop 前后保留完整多 Agent 任务耗时，包含主 Agent 收尾。
+- 冻结失败/中断证据，让重复终态 hook 与普通单轮校准保持幂等。
+- 在增量读取和排队 hook 之间保留 transcript 的 prompt 归属，拒绝无法归属的 duration 与无效数值。
+- 区分任务、原生单轮、会话运行和 API 等待时间，并修正 `cost` 描述。
+
+- 将后台 Agent 结果通知 ID 关联到原始人类任务，等待待交付报告后再完成主 Agent 收尾。
+- 冻结前核对提交证据，阻止后续 transcript 扫描改写终态耗时。
+- 将实现拆分为配置、渲染、运行、集成、UI 与平台子系统，保留旧 Python 入口，隔离共享存储与所有权。
+- 按子系统归类测试，修复移动后的源码/Terminal 路径，并在 `tools/` 统一双语文档、包检查和显式验收入口。
+
+## 1.1.0 - 2026-10-03
+
+- macOS 核心功能与独立 TUI 转为正式支持，范围为 macOS 14+、Intel / Apple Silicon、CPython 3.10–3.14；保留原生进程识别、包含睡眠时间的时钟和 POSIX 文件安全适配。
+- 实验性 `/statusline-configure` 在有效 tmux 会话之外新增 Terminal.app 入口，使用系统 `open` 和私有 `.command` 文件；退出后遵循 Terminal 自身偏好，无需 AppleScript 自动化权限。
+- Terminal 入口绑定当前 Python、CLI、配置目录和工作目录，支持空格、中文及 shell 特殊字符；使用独立启动握手、进程身份核验与 schema v1 结果桥，处理启动失败、关窗、中断、父调用退出和超时。
+- 在 TUI 轮询和配置事务锁内核对调用存活与期限，失效调用不能继续保存；撤销调用后仅回收匹配身份的编辑器进程并清理本次私有文件。
+- 更新 CLI 帮助、包描述与 macOS `doctor` 诊断；诊断只检查 Terminal 及图形会话条件，不启动桌面终端。配置和结果 schema、Linux/Windows 行为及实验入口默认关闭策略保持兼容。
+- 修正 PTY 分段读取误报，新增 Terminal 生命周期与原生辅助进程测试，补充 `.DS_Store` 忽略规则和分发包检查。
+- 发布 v1.1.0 稳定版 wheel、源码包和 SHA256SUMS；统一 Linux/WSL、Windows、macOS 的安装与升级入口，保留历史版本的支持范围说明。
+- 发布指南补全按已验证提交构建、草稿附件核验、正式发布及下载后隔离安装的流程；CI 核对源码/包版本、文档和截图，并拒绝分发本地验收记录及系统缓存。
+- 收录 macOS / Windows 主状态栏及三页 TUI 的八张原始截图，统一文件名、文件索引和首页展示；CI 增加全平台截图的打包检查。
+
+## 1.1.0a1 - 2026-10-02
+
+- 新增 macOS 预览支持：核心状态栏、子 Agent 行、安装配置命令和独立 curses TUI；实验性 `/statusline-configure` 仅使用通过预检查的 tmux popup。
+- Linux/macOS 共享 POSIX 文件锁、私有权限修复、原子替换和父目录同步；仅 macOS 文件系统不支持目录同步时降级，真实 I/O 错误继续传播。
+- macOS session registry 使用 C locale / UTC 的 `ps -o lstart=` 启动标识，先筛选匹配会话再查询进程。计时通过延迟加载的 LibSystem `mach_continuous_time`、`mach_timebase_info` 与 `kern.bootsessionuuid` 保持包含睡眠时间的时钟和重启识别；接口不可用时整体回退墙钟。
+- `doctor` 增加 macOS 预览、架构、系统版本、curses、进程、时钟、目录同步与实验入口 tmux 诊断；缺少 curses 时独立 TUI 返回清晰错误。
+- macOS 独立 TUI 定时轮询输入，使旧 curses/CPython 3.10 在没有后续按键时也能及时处理 SIGINT 等信号；PTY 测试建立前台控制终端并在等待退出时持续读取输出。
+- CI 增加 macOS 15/26 × Intel/Apple Silicon × Python 3.10/3.14，扩展 PTY/tmux 实测并生成平台验证报告；ARM64 的 Python 3.10 下界固定为 3.10.11。
+- 发布 v1.1.0a1 预览 wheel、源码包与 SHA256SUMS，供 macOS 用户试用；Linux/WSL 与 Windows 用户仍可选择稳定版 v1.0.0，预览包也包含这两个平台的既有功能。
+- 同步包版本、CLI/CI 版本断言、安装升级入口与发布指南。显示 schema v2、feature schema v1、旧配置及运行状态保持兼容，无需数据迁移。
+- 已发布的 v1.0.0 安装包与标签不包含 macOS 支持。实际 Claude 视觉效果、真实睡眠恢复与桌面终端体验尚未人工验收；macOS 仍声明为预览。
+
+## 1.0.0 - 2026-09-04
+
+- Git staged 计数按运行平台调整间距：原生 Linux 保留 `● N`，Windows 和 WSL 改为 `●N`；WSL 同时根据环境变量和内核 release 识别。
+- 将平台契约从 Linux 扩展为 Linux/WSL 与 Windows 10/11 原生；Windows 支持 CPython 3.10–3.14 x86/x64，macOS 继续明确不支持，Windows ARM64 原生 Python 暂不承诺。
+- 新增集中式平台适配层：Linux 保留 `fcntl.flock`、`0600/0700` 与父目录 `fsync`；Windows 使用延迟导入的 `msvcrt` 固定字节锁、继承 ACL、带 sharing violation/access denied 重试的原子替换与 durable unlink。
+- Windows session registry 校验通过 `OpenProcess(PROCESS_QUERY_LIMITED_INFORMATION)`、`GetProcessTimes` 和本地 `.NET DateTime.Ticks` 转换验证 `procStart`；计时使用包含休眠时间的 `GetTickCount64` 与按分钟量化的启动标识，API 不可用时回退墙钟。
+- Windows 安装统一写入可由 Git Bash 和 PowerShell 执行的 `claude-statusline.exe render`、`render-subagents`、`hook` 与 `slash-hook`；Linux 绝对路径加 POSIX 引号的既有命令格式不变。所有权识别同时接受 canonical 名称、大小写不敏感 `.exe` 与解析到当前入口的 PATH alias。
+- Windows `/statusline-config` skill 同时预授权窄范围 Bash/PowerShell config 规则；`/statusline-configure` fallback 同时禁用 Bash 与 PowerShell。`doctor` 新增 Windows executable、ACL/mode 差异、`windows-curses` 与系统新控制台诊断。
+- 包元数据增加条件依赖 `windows-curses>=2.4.2; sys_platform == "win32"`。Linux 与 Windows 复用 Main/Subagents/Settings 全屏 TUI；信号注册只引用平台实际存在的信号，并兼容 PDCurses resize。
+- `/statusline-configure` 在 Windows 新增 `CREATE_NEW_CONSOLE` launcher，直接运行当前虚拟环境的 `python -m claude_statusline configure`，保留子进程句柄、真实终端 I/O、570/585 秒 deadline、关窗/异常/超时回收及 schema v1 结果回传。Linux tmux/GNOME 行为保持不变。
+- Windows 结果桥拒绝 symlink、junction、其他 reparse point、路径越界、非普通文件和超过 16 KiB 的结果；不再把 NTFS 伪 POSIX mode 当成损坏。长路径换行同时识别 `/` 与 `\`，`full` 风格保留 payload 原始分隔符。
+- 保持显示 schema v2、feature schema v1、状态缓存、生命周期 ledger、默认显示、Claude Code 2.1.205/2.1.258 功能门槛和旧 Linux 安装所有权语义不变，不执行数据迁移。
+- CI 新增 Ubuntu/Windows × Python 3.10/3.14 矩阵、PowerShell/Git Bash 与 Linux smoke，以及 sdist/wheel 版本、条件依赖、skills 和平台模块打包检查。
+
+## 0.9.0 - 2026-09-03
+
+- 新增子 Agent 条目 `status-elapsed`：把状态图标与用时合并为一个单元（如 `⏱ 1m 18s`、`✓ 0m 42s`），取代 `status` 与 `elapsed` 成为默认子 Agent 行，默认输出从 `⏱ Explore · sonnet-5/high · Context 58% left · 1m 18s · searching auth flow` 变为 `⏱ 1m 18s · Explore · sonnet-5/high · Context 58% left · searching auth flow`。
+- `status-elapsed` 与 `status`、`elapsed` 在 `subagents.items` 中互斥：配置校验拒绝共存，CLI 的 set-items/enable/disable/order/apply 直接报错；交互向导勾选其一自动取消冲突项。
+- 缺失或非法 `startTime` 时 `status-elapsed` 只显示状态图标；未来时间按 0 秒。与旧 `elapsed` 一致，已完成任务因 payload 无 endTime 继续计时；时长仍按 floor 取整。
+- 窄屏适配把 `status-elapsed` 视为与 `status` 同等的核心条目，始终保留，极窄时退化为图标；不加入可选段丢弃顺序。
+- 更新渲染、目录、预览、配置校验、向导、CLI 与文档测试。
+
+## 0.8.0 - 2026-09-03
+
+- 新增子 Agent 条目 `context-remaining`：显示 `Context N% left`（先按 `tokenCount / contextWindowSize` 四舍五入已用百分比，再取 `100 − 已用` 并截断到 0–100），并取代 `context-used` 成为默认子 Agent 行的上下文项。
+- 子 Agent `context-used` 保持可选，显示格式从 `ctx N%` 改为与主栏一致的 `Context N% used`；已有配置目录结构不变，但启用 `context-used` 的现有配置会看到新文本。
+- 无显示配置的安装默认子 Agent 行改为显示剩余上下文；两个上下文条目都参与窄屏丢弃（`current-dir → tokens → context-used → context-remaining → model-with-effort → task`）。
+- 新条目可通过 CLI、TUI 与 `/statusline-config` 启用和排序；更新对应渲染、目录、预览与文档测试。
+
+## 0.7.0 - 2026-09-03
+
+- 新增三个默认关闭的主 Agent 条目：`context-used` 显示 Claude 官方 payload 的上下文已用百分比，`project-name` 显示启动项目目录 basename，`hostname` 通过 Python 标准库显示本地主机名。
+- `context-used` 与 `context-remaining` 可独立配置并相邻共存；`current-dir`、`project-name`、`hostname` 组成位置组，所有新增文本均执行缺失值、范围与控制字符/ANSI 安全校验。
+- 保持 schema v2、原有十项 `DEFAULT_ITEMS`/`LEGACY_DEFAULT_ITEMS`、旧配置与默认输出不变；三个新条目只通过 CLI、TUI 或 `/statusline-config` 显式启用。
+- 全条目预览扩展为 24 个确定性主条目，hostname 固定为 `devbox`，不读取真实机器名；子 Agent renderer、条目目录和默认配置保持不变。
+
+## 0.6.0 - 2026-09-03
+
+- 新增 Claude Code 官方 `subagentStatusLine` 一等支持与高频 `render-subagents` NDJSON 命令；按 task 显示状态、名称、模型/effort、上下文、用时和任务，并支持 token、cwd 可选项、ANSI/CJK/emoji 安全限宽及损坏输入静默降级。
+- `prompt-timer` 改为从用户提交到主 Agent 最终 `Stop` 的端到端时间；新增 `SubagentStart`/`SubagentStop` ledger、`waiting_subagents`/`resuming_main` 阶段、权威 `background_tasks` 同步，并抑制 registry/transcript 提前完成。
+- 主栏新增 `off/when-subagents/always` 范围标签；默认只在当前 prompt 曾启动子 Agent 时显示固定的 `Main/Session`，session token 聚合口径保持不变。
+- 显示配置平滑升级到严格 schema v2：schema v1 只读迁移且不会被 render/doctor/install 重写，首次真实保存会备份原字节并原子写出 canonical v2。
+- 新增完整的 `config subagents ...` 命令、`subagent-statusline`/`scope-labels` 设置及兼容旧调用的可选 `config apply` 参数；TUI 升级为 Main/Subagents/Settings 三页签，slash 向导同步一次性提交全部字段。
+- 安装器新增 Claude Code 2.1.205 版本门槛、owned/absent/foreign/unsupported 所有权状态、foreign 整体拒绝与 `--force` 接管、关闭/降级暂挂及升级恢复；uninstall 只移除本工具拥有的子 Agent 设置和 hooks。
+- 扩展 renderer、Unicode 宽度、生命周期、配置迁移、安装事务、TUI/Slash、CLI 与 doctor 测试，并更新构建、升级、降级和人工多 Agent 验收文档。
+
+## 0.5.0 - 2026-09-03
+
+- 新增默认关闭的实验入口 `/statusline-configure`，通过 `install --experimental-slash-tui` 持久启用，并可用 `--no-experimental-slash-tui` 永久关闭；与现有 `/statusline-config` 并存。
+- 新增 tmux `90% × 90%` popup 与 GNOME Terminal 活动新标签页 launcher，复用已有 `claude-statusline configure` TUI；两者不可用时在本地阻断并提示独立命令，不调用模型。
+- 新增私有原子结果桥接，向 Claude 对话回传保存、无变化、取消、中断、超时和错误；hook/TUI/launcher timeout 分别为 600/570/585 秒。
+- 安装器扩展为 settings、feature 文件与两个 owned skill 的统一事务，支持损坏偏好的显式修复、降级暂挂/升级恢复、严格所有权、dry-run、备份和原字节回滚。
+- `doctor` 新增 feature schema/权限、disabled/enabled/suspended、实验 skill/owner/matcher/timeout 和 launcher 可用性诊断；新增 launcher、PTY bridge 与真实 tmux popup 集成测试。
+- 文档明确该功能不是 Claude Code 原生 TUI 扩展，不访问 `/dev/tty`，GNOME 路径是新标签页，并记录 `disableAllHooks` fallback 的模型回合例外。
+
+## 0.4.0 - 2026-09-03
+
+- 新增稳定的独立命令 `claude-statusline configure [--config-dir PATH]`，在 Linux 真实终端中提供 Items/Settings 双页签全屏 TUI，支持 Space 勾选、键盘导航、筛选、左右排序和数值编辑。
+- 新增按键级 `Preview (sample data)`：复用生产 renderer 的格式化、分组与换行，只使用确定性样例，不读取 Git、transcript、网络或当前会话运行状态，也不创建缓存。
+- Enter 一次性原子提交显示与宿主配置，Esc 和信号路径恢复终端且不写入；小于 `64x18` 时等待 resize。
+- TUI 保存增加 baseline 并发保护：在现有安装锁内、创建备份前检测 display、host 或安装归属的语义变化，同时保留无关 `settings.json` 更新。
+- 保持显示配置 schema version 1，不迁移或持久化禁用条目顺序；`/statusline-config` skill、slash fast hook 与现有 renderer/hook 行为不变。
+
+## 0.3.2 - 2026-09-03
+
+- 显示前缀首字母大写：`Session`、`Git`、`Repo`、`Worktree`、`Agent`；Git 错误标记同步改为 `Git!`。
+- `cost` 金额前加 `Total`，如 `Total $0.12 · 12m 30s · +156/-23`（`vim NORMAL` 不在本次清单内，保持不变）。
+
+## 0.3.1 - 2026-09-03
+
+- 重构显示项分组与配色：`model-with-effort`、`fast-mode`、`thinking` 一组（象牙白）；`tokens`、`prompt-cache` 一组（粉）；`git`、`pr`、`repo` 一组（紫）；`version`、`session`、`cost`、`agent`、`vim-mode`、`worktree` 各自独立。
+- `session`、`git`、`repo` 显示加前缀（`session xxxxx`、`git xxxxx`、`repo xxxxx`）。
+- 目录顺序调整为同组相邻，向导追加的新条目自动落在组锚点之后。
+
+## 0.3.0 - 2026-09-03
+
+- 新增 11 个可选显示项：`version`、`session`、`cost`、`prompt-cache`、`fast-mode`、`agent`、`vim-mode`、`thinking`、`pr`、`worktree`、`repo`，数据来自 Claude Code 2.1.258+ 的公开 statusline payload。
+- 新显示项默认禁用，默认输出与 0.2.0 完全一致；通过 `/statusline-config enable` 主动开启。
+- `cost` 显示会话金额、API 时长与增删行数（第三方 API 下金额为估算值）；`prompt-cache` 显示缓存命中率与写入 token。
+- 更新 `/statusline-config` 向导分组，新条目可通过勾选启用。
+
+## 0.2.0 - 2026-09-03
+
+- 增加用户全局的严格 JSON 显示配置、可选显示项及持久化顺序。
+- 增加颜色、ANSI 调色板、目录格式、分隔符及 Claude Code 宿主设置。
+- 增加 `/statusline-config` personal skill，以及新版 Claude Code 的本地 slash hook 快路径。
+- 安装器自动管理 skill 和快捷 hook，旧版 Claude Code 优雅降级，卸载时保留用户偏好。
+- 保持无配置时的 0.1.0 输出，并按启用项跳过不必要的 Git 和 transcript 工作。
+
+## 0.1.0 - 2026-09-02
+
+- 将现有 Claude Code statusline 渲染器与逐轮生命周期 hook 封装为独立 CLI。
+- 增加安全、幂等的安装、卸载和诊断命令。
+- 支持 `CLAUDE_CONFIG_DIR`，同时保留既有运行状态与缓存布局。
+- 保留模型、目录、Git、上下文、限额、token 与计时显示行为。