Skip to content

docs: HelperLifecycleManager comment — drop ~/log path placeholder#38

Open
JasonYeYuhe wants to merge 1 commit intomainfrom
v1.13.1-helper-comment-cleanup
Open

docs: HelperLifecycleManager comment — drop ~/log path placeholder#38
JasonYeYuhe wants to merge 1 commit intomainfrom
v1.13.1-helper-comment-cleanup

Conversation

@JasonYeYuhe
Copy link
Copy Markdown
Owner

Summary

Codex P3 cleanup from the v1.13.1 review: HelperLifecycleManager docstring still mentioned __HOME__ substitution for log paths ("the user's home directory (so log paths resolve correctly even on multi-user Macs)"). Phase 4E e2e fix already removed ~/Library/Logs/... StandardOutPath / StandardErrorPath from HelperAgent.plist (launchd doesn't expand ~); helper logs via os_log instead. The stale comment was P3 risk that the next maintainer might reintroduce tilde paths.

Replaced the substitution-era comment block with the current no-substitution design + an explicit warning not to reintroduce log path keys.

embed_helper_in_archive.sh and CI's verify-archive-embedding job both already reject tilde paths now, so the documentation aligns with the runtime guards.

Scope

  • One file: CLI Pulse Bar/CLIPulseCore/Sources/CLIPulseCore/HelperLifecycleManager.swift
  • Comment-only change. No behavior delta.
  • Doesn't fix Codex's P1.1 (LoginItem vs LaunchAgent label collision) or P1.2 (Swift daemon reads wrong config storage) — those are tracked in feedback_loginitem_launchagent_collision.md for the future Developer ID distribution work; both are inert under MAS distribution (Swift helper stripped pre-upload).

🤖 Generated with Claude Code

Codex review of v1.13.1 (PR #37): the HelperLifecycleManager
docstring still mentioned `__HOME__` substitution for log paths
("the user's home directory (so log paths resolve correctly even
on multi-user Macs)"). Phase 4E e2e fix already removed `~/Library/
Logs/...` `StandardOutPath` / `StandardErrorPath` from
HelperAgent.plist (launchd doesn't expand `~`); helper logs via
os_log instead. The stale comment was P3 risk that the next
maintainer might reintroduce tilde paths.

Replaced the substitution-era comment block with the current
no-substitution design + an explicit warning not to reintroduce
log path keys. embed_helper_in_archive.sh and CI's
verify-archive-embedding job both reject tilde paths now, so the
documentation aligns with the runtime guards.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant