Skip to content

release: 0.36.0 — default port 8722 (TRAC), unmasked session ids by default - #87

Merged
lroolle merged 1 commit into
mainfrom
0.36.0
Aug 6, 2026
Merged

release: 0.36.0 — default port 8722 (TRAC), unmasked session ids by default#87
lroolle merged 1 commit into
mainfrom
0.36.0

Conversation

@lroolle

@lroolle lroolle commented Aug 6, 2026

Copy link
Copy Markdown
Member

Two direct asks from Eric (2026-08-06):

Default port: 9317 -> 8722

  • 8722 spells TRAC on a phone keypad — a default with a story, instead of "avoids Clash". IANA-unassigned, outside every OS ephemeral range, clear of proxy-tool territory (8080/8443/8888/9090).
  • Walk is 8722..8731; the discovery sweep additionally keeps covering the legacy 9317..9326 range, so live instances of older versions still appear in ps, the switcher, and the dashboard during the transition.
  • --port and env PORT (portless routes) behavior unchanged. Docs updated everywhere the old number appeared.

Identity ids: unmasked by default, --redact-ids to opt in

  • session/user/device uuids are workflow identity, not credentials. Masking them at capture broke sid-keyed continuity (view-by-sid needed a fallback in 0.35.0, the registry catalog stores starred ids) and bought nothing until a trace leaves the machine.
  • New: --redact-ids flag / CCTRACE_REDACT_IDS=1 env restores the masking for shareable captures. Credentials (tokens, keys, cookies, OAuth codes) remain ALWAYS redacted — no opt-out exists.
  • Display-layer mask mode is untouched (sid was already excluded there by default per the 0.29 decision).
  • Regression tests: default passthrough, opt-in masking, credentials-always-masked.

Tests: 613 pass. Smoke: built binary binds 8722, /api/self answers.

🤖 Generated with Claude Code

… --redact-ids opt-in

- DEFAULT_PORT 9317 -> 8722 (TRAC on a phone keypad); walk 8722..8731,
  discovery sweep still covers the legacy 9317..9326 range so older live
  instances stay visible through the transition
- capture-time identity masking (session/user/device uuids) is now OPT-IN:
  --redact-ids / CCTRACE_REDACT_IDS=1. A local session uuid is workflow
  identity, not a credential, and masking it broke sid-keyed continuity.
  Credentials always redact, no opt-out. Display-layer mask mode unchanged
  (sid was already excluded there by default)
- docs synced (README en/zh security sections, SKILL.md, CLAUDE.md),
  version-badge highlights refreshed, CHANGELOG 0.36.0

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@lroolle
lroolle merged commit 0d92df9 into main Aug 6, 2026
1 check passed
@lroolle
lroolle deleted the 0.36.0 branch August 6, 2026 07:50
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