fix(docker): symlink gitnexus binary onto $PATH in runtime image (#1549)

[Avicennasis]

Summary

Fixes one of the two bugs reported in #1549: the documented Docker workflow command

docker compose exec gitnexus-server gitnexus index /workspace/my-repo

currently fails with exec: "gitnexus": executable file not found in $PATH. This PR adds a single symlink in the runtime stage of Dockerfile.cli so the command works as written.

Mechanism

gitnexus/package.json declares "bin": { "gitnexus": "dist/cli/index.js" }. In a normal npm install that exposes node_modules/.bin/gitnexus and (if installed globally) /usr/local/bin/gitnexus. But the builder stage runs npm prune --omit=dev --prefix gitnexus (Dockerfile.cli line 37), which strips node_modules/.bin/ entries, and nothing in the runtime stage re-adds the gitnexus name to $PATH. The container's own CMD works because the Dockerfile invokes Node directly:

CMD ["node", "gitnexus/dist/cli/index.js", "serve", ...]

…but anyone following the README has no way to know that without reading the Dockerfile.

dist/cli/index.js already carries #!/usr/bin/env node and 755 perms, so a single symlink into /usr/local/bin is the minimal fix.

Test plan

docker build -f Dockerfile.cli -t gitnexus:local-pr-test .

# Symlink + version (was: "executable file not found in $PATH")
docker run --rm gitnexus:local-pr-test which gitnexus
# → /usr/local/bin/gitnexus
docker run --rm gitnexus:local-pr-test gitnexus --version
# → 1.6.4
docker run --rm gitnexus:local-pr-test gitnexus --help | head -2
# → Usage: gitnexus [options] [command]

# CMD path unchanged
docker run --rm -d --name t gitnexus:local-pr-test
sleep 4
docker exec t curl -s localhost:4747/api/health
# → {"status":"ok"}

Both verified locally.

Notes

• Strictly additive: no behaviour changes for the CMD ["node", "gitnexus/...", "serve", ...] boot path. Only adds a name on $PATH.
• Sibling PR fix(cli): tolerate read-only workspace in ensureGitNexusIgnored (#1549) #1550 fixes the second bug from Documented Docker workflow (gitnexus index /workspace/<repo> on :ro mount) is broken in two places #1549 (ensureGitNexusIgnored failing on the documented :ro workspace mount). Together they make the README's literal docker compose exec gitnexus-server gitnexus index /workspace/my-repo command work end-to-end.

Refs #1549.

[vercel]

@Avicennasis is attempting to deploy a commit to the NexusCore Team on Vercel.

A member of the Team first needs to authorize it.

[github-actions]

CI Report

✅ All checks passed

Pipeline Status

Stage	Status	Details
✅ Typecheck	success	tsc --noEmit
✅ Tests	success	unit tests, 3 platforms
✅ E2E	success	gitnexus-web changes only

Test Results

Tests	Passed	Failed	Skipped	Duration
8844	8843	0	1	416s

✅ All 8843 tests passed

1 test(s) skipped — expand for details

• buildTypeEnv > known limitations (documented skip tests) > Ruby block parameter: users.each { |user| } — closure param inference, different feature

Code Coverage

Tests

Metric	Coverage	Covered	Base	Delta	Status
Statements	77.66%	27140/34947	N/A%	—	🟢 ███████████████░░░░░
Branches	66.09%	17114/25894	N/A%	—	🟢 █████████████░░░░░░░
Functions	82.37%	2735/3320	N/A%	—	🟢 ████████████████░░░░
Lines	80.82%	24529/30347	N/A%	—	🟢 ████████████████░░░░

---

_{📋 View full run · Generated by CI}