Skip to content

Correct the stale mismatch count in the slug resolver - #101

Merged
imanimanyara merged 1 commit into
mainfrom
docs/vcs-url-checker-mismatch-count
Nov 14, 2026
Merged

imanimanyara merged 1 commit into
mainfrom
docs/vcs-url-checker-mismatch-count

Conversation

@imanimanyara

Copy link
Copy Markdown
Member

Summary

repo_slug_of() reads a package's slug from origin rather than from its directory name, and its
docstring explains why with a worked example. The example was `pdf-toolkit` is `laranail/pdf`.

That checkout has been renamed to laranail/packages/pdf, so the example named a directory that no
longer exists, and the count beside it — "seven directories" — was one too high.

Comment only. The resolver is untouched.

What it says now

Six of laranail's 73 checkouts, with env-tools is laranail/env-kit as the example, and the
command and date the figure came from, so the next reader re-derives it instead of trusting it.

The six, measured 2026-11-13 by comparing each packages/*/ basename against
git -C <dir> remote get-url origin:

directory repository
env-tools laranail/env-kit
env-tools-webui laranail/env-kit-webui
installer laranail/installer-headless
installer-webui laranail/installer-web
livewire-flux-uikit laranail/flux-uikit
product-demo-mode laranail/demo-mode

Verification

The function's behaviour is unchanged, including the case the docstring exists to justify:

call returns
repo_slug_of('pdf') pdf the renamed checkout — directory now equals slug
repo_slug_of('env-tools') env-kit a still-mismatched directory resolves to its real slug
repo_slug_of('package-tools') package-tools an always-matching directory
repo_slug_of('pdf-toolkit') pdf-toolkit a directory that no longer exists falls back to the name

All 8 scripts in scripts/ compile. The released CHANGELOG entry that carries the same sentence is
history and was left alone.

The docstring explained why the slug is read from `origin` rather than from
the directory name, and illustrated it with `pdf-toolkit` is `laranail/pdf`.
That checkout has been renamed to `pdf`, so the example named a directory
that no longer exists and the count was one too high.

Now six of laranail's 73 checkouts, with `env-tools` is `laranail/env-kit`
as the example, plus the command and date the figure came from so the next
reader can re-derive it instead of trusting it.

The resolver itself is unchanged, and still returns the real slug for a
mismatched directory: repo_slug_of('env-tools') gives 'env-kit'.
Copilot AI balanced review requested due to automatic review settings November 14, 2026 02:43

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has insufficient remaining quota. Try requesting a review at a lower effort level.

@imanimanyara
imanimanyara merged commit d74bce7 into main Nov 14, 2026
17 checks passed
@imanimanyara
imanimanyara deleted the docs/vcs-url-checker-mismatch-count branch November 14, 2026 02:51
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.

2 participants