Skip to content

Session Handoff [auto-1644]: Establish the PATH Order tool_shadow_path Names (#1644) #1864

Description

@ptr727

Next steps, in priority order

Re-read the issue and the tree rather than trusting this summary.

  1. tool_shadow_path Reports a Shadow It Never Tested For, So a Copy Behind BIN_DIR Reads as a PATH Problem #1644: make tool_shadow_path in host-setup/linux/install-tools.sh establish the PATH ordering it names. Today it returns whatever type -P resolves whenever that is absolute and is not $BIN_DIR/<name>, so with no managed copy installed a copy sitting behind $BIN_DIR on PATH is reported as a shadow, and both callers (tool_note and tool_unshadow, plus a third call site reading it as a condition) then state a PATH claim nothing measured. The fix the issue settles is to walk PATH and return a copy only where its directory precedes $BIN_DIR. Done looks like: a copy ahead of $BIN_DIR is still reported and handled as today, a copy behind $BIN_DIR with no managed copy yields no shadow and no note, a constructed test (placeholder tool name, temporary directories, nothing on the host touched) covers both orderings and fails with the fix reverted, and a pull request into develop carrying Closes on promotion: #1644. Check the Windows installer under host-setup/windows/ for the same conflation, as the issue asks, and fix it in the same change only where it has the identical defect, otherwise note in the pull request what was found.

External blockers

None known at pick time.

Internal dependencies

None. One issue, one lane.

State

No branch, worktree, or pull request exists for this lane yet. The worker creates feature/auto-1644 in its own worktree based on develop.

Parked decision queue

Empty for this lane.

What the last round did

Nothing. This link opens the auto-1644 lane, created by the unattended-handoff picker.

What not to repeat

Nothing recorded yet.

New learnings

None yet.

Activity

  1. added
    handoffA link in the session handoff chain, one open issue per track
    on Sep 26, 2026
  2. ptr727 commented on Sep 26, 2026

    @ptr727
    OwnerAuthor

    Done. #1644 fixed and merged to develop.

    • PR: Establish the PATH Order tool_shadow_path Names #1867, squash-merged as 432987a.
    • tool_shadow_path now walks PATH in order and stops reporting once $BIN_DIR is reached, so a
      copy behind it (no managed copy installed yet) yields no shadow while a copy ahead of it still
      does. install-tools.ps1 checked for the same conflation and found not to share it (winget
      scope-based, not PATH-order-based).
    • A local-strict-review round caught a real regression in the first draft (a $BIN_DIR PATH entry
      spelled with a trailing slash compared unequal, so the managed copy read as its own shadow and
      --upgrade would have deleted it). Fixed by stripping a trailing slash before comparing.
    • Copilot's review round raised the same class one level further (a doubled-slash or dot-segment
      spelling of $BIN_DIR), confirmed pre-existing (the old type -P-based code had it too) and
      declined on that evidence rather than fixed in this PR.
    • Filed two pre-existing, out-of-scope defects turned up during review, for the backlog:

    Worktree and feature branch cleaned up, base clone fast-forwarded to develop.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    handoffA link in the session handoff chain, one open issue per track

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions