Skip to content

fix: report symlinks skipped by build and scan walks - #400

Merged
vibgrate-team merged 4 commits into
mainfrom
cursor/symlink-walk-notice-e865
Oct 8, 2026
Merged

vibgrate-team merged 4 commits into
mainfrom
cursor/symlink-walk-notice-e865

Conversation

@vibgrate-team

@vibgrate-team vibgrate-team commented Oct 7, 2026 •

Copy link
Copy Markdown
Contributor

Summary

vg never follows symlinks while walking a tree. This makes that behaviour explicit and visible: discovery and the scan indexing walk skip symlinks, and a single stderr line names what was skipped:

notice: skipped N symlinks (a, b, c). vg does not follow symlinks. Point the root at the link target, or pass --exclude or a narrower root.

Exit codes and scan results are unchanged. DOCS.md and CHANGELOG.md describe the behaviour, and test/symlink-walk.test.ts locks in no-follow (including cycles) and the notice text.

Related issues

Closes #271

Checklist

  • Tests added or updated
  • Docs updated where behavior is described
  • No proprietary or internal references
  • Commits use Conventional Commits and are signed off

How to verify

pnpm lint && pnpm typecheck && pnpm test

cursoragent and others added 4 commits October 7, 2026 12:14
Directory and file symlinks are not followed, so a link that points
at its parent cannot hang vg build or vg scan. Print one stderr
notice when a walk skips any, without changing output files or the
exit code.

Signed-off-by: Cursor Agent <cursoragent@cursor.com>

Co-authored-by: Crowers <crowers@users.noreply.github.com>
Co-authored-by: Crowers <crowers@users.noreply.github.com>
Signed-off-by: Cursor Agent <cursoragent@cursor.com>
Walks still do not follow symlinks. When any are skipped, one stderr notice
lists the count and the first few root-relative paths.

Signed-off-by: Cursor Agent <cursoragent@cursor.com>

Co-authored-by: Crowers <crowers@users.noreply.github.com>
@vibgrate-team
vibgrate-team marked this pull request as ready for review October 8, 2026 21:42
@vibgrate-team
vibgrate-team merged commit 6e8e1c3 into main Oct 8, 2026
1 check passed
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.

Bug: detect symlink cycles during vg build/scan walks with an actionable error

2 participants