fix(hooks): add auto-symlink creation in data-platform startup hook #403

Merged
lmiranda merged 2 commits from fix/startup-hook-venv-cache-path into development 2026-02-03 03:40:00 +00:00
Owner

Summary

  • Adds auto-symlink creation in data-platform startup hook when cache venv exists but local symlink is missing

Important Note

This fix may not actually help because MCP servers fail BEFORE SessionStart hooks run. See lessons learned wiki page for full 5-hour debug trace documenting everything that was checked.

What was found

  • All validations pass
  • Cache venvs exist and work
  • MCP servers start manually
  • run.sh already checks cache first
  • Claude Code hides actual plugin load errors - we cannot see what's failing

Test plan

  • Restart Claude Code session
  • Check if plugins load
  • If still failing, run setup-venvs.sh in installed marketplace path

Lessons Learned

Full documentation: MCP Venv Symlinks Lost on Marketplace Update

## Summary - Adds auto-symlink creation in data-platform startup hook when cache venv exists but local symlink is missing ## Important Note **This fix may not actually help** because MCP servers fail BEFORE SessionStart hooks run. See lessons learned wiki page for full 5-hour debug trace documenting everything that was checked. ## What was found - All validations pass - Cache venvs exist and work - MCP servers start manually - run.sh already checks cache first - **Claude Code hides actual plugin load errors** - we cannot see what's failing ## Test plan - [ ] Restart Claude Code session - [ ] Check if plugins load - [ ] If still failing, run `setup-venvs.sh` in installed marketplace path ## Lessons Learned Full documentation: [MCP Venv Symlinks Lost on Marketplace Update](https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/wiki/lessons%2Fpatterns%2Fmcp-venv-symlinks-lost-on-marketplace-update---5-hour-debug-loop.-)
lmiranda added 2 commits 2026-02-03 03:39:26 +00:00
Plugin load failures were caused by version mismatch between
marketplace.json and individual plugin.json files:
- contract-validator: 1.2.0 vs 1.1.0
- git-flow: 1.2.0 vs 1.0.0
- projman: 3.4.0 vs 3.3.0
- clarity-assist: 1.2.0 vs 1.0.0
- doc-guardian: 1.1.0 vs 1.0.0

Claude Code silently fails to load plugins when versions don't match.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Note: This fix may not help because MCP servers fail BEFORE hooks run.
See lessons learned wiki page for full debug trace.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
lmiranda merged commit 6d093e83b6 into development 2026-02-03 03:40:00 +00:00
lmiranda deleted branch fix/startup-hook-venv-cache-path 2026-02-03 03:40:01 +00:00
Sign in to join this conversation.
No Reviewers
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: personal-projects/leo-claude-mktplace#403