Expose sidebar visibility in worktree list

[adamgall]

What problem does this solve?

Git registration and Supacode sidebar visibility are different states. supacode worktree list currently prints every worktree known to Supacode, including archived worktrees, while supacode worktree list -f only narrows that list to the focused worktree. Neither command identifies the default workspace, pinned worktrees, and unpinned worktrees as visible or archived worktrees as archived.

Scripts therefore have to read ~/.supacode/sidebar.json and depend on its private schema to reproduce what the app shows. Git cannot provide this state because pinning and archival belong to Supacode.

Proposed solution

Preserve the existing default output of one percent-encoded worktree ID per line, and add the smallest stable machine-readable interface needed to:

• filter the list to sidebar-visible worktrees;
• optionally emit each ID with a visible or archived classification when listing all worktrees;
• report the repository's default workspace as visible;
• preserve the existing percent-encoded IDs.

For example, worktree list --visible could keep the existing one-ID-per-line shape while filtering, and worktree list --with-visibility could emit tab-separated <id>\t<visible|archived> rows. The app's existing sidebar-state owner should provide the classification; the CLI should not parse sidebar.json or duplicate the UI rules.

Related, but not duplicates:

• Add worktree archive --force to the CLI #628 requests programmatic archival.
• Ability to pin new/in-progress worktree #696 requests pinning an in-progress worktree and mentions the visible list.
• Support external worktree manager commands #428 concerns external worktree managers.

Alternatives considered

• Parse ~/.supacode/sidebar.json: couples scripts to private storage and duplicates Supacode's classification rules.
• Infer state from Git locks, tabs, branches, paths, or processes: none represents Supacode sidebar visibility.
• Change the default worktree list rows: risks breaking scripts that consume one percent-encoded ID per line.

Supacode version

0.10.6

Are you planning to build this yourself?

• I intend to open a pull request once this is approved and marked ready.

Before submitting

• I searched existing issues and this is not a duplicate.
• I understand feature pull requests are closed until the issue is marked ready.
• I agree to follow this project's Code of Conduct.

[github-actions]

Thank you for filing this. A maintainer will review it and follow up here.

Please do not start any work or open a pull request until this issue is labeled ready. That label is a maintainer's go-ahead: a pull request opened against an issue that is not yet ready is labeled invalid until then. You will get a comment here the moment it is marked ready.

See CONTRIBUTING.md for the full flow.

[github-actions]

Thanks for your patience. This is approved and marked ready, so it is now open for a pull request. If you'd like to work on it, open a pull request and link it with Closes #701 in the description. If the issue is assigned to someone, it is reserved for them; otherwise anyone is welcome to pick it up.

See CONTRIBUTING.md for the full flow.