fix: symlink node_modules so squad scripts can resolve framework deps

[andersnsouza]

Summary

• Scripts in squads/ (e.g. squad-creator-pro) fail with Cannot find module 'js-yaml' because node_modules only exists inside .aiox-core/
• Node.js module resolution walks up from squads/.../scripts/ to the project root and never finds js-yaml
• This fix creates a symlink <project>/node_modules → .aiox-core/node_modules/ during aiox init, so standard require() calls work from any directory in the project tree

Root Cause

aiox-init.js creates a package.json at the project root but never installs dependencies or links to .aiox-core/node_modules/. Any script outside .aiox-core/ that does require('js-yaml') (or any other framework dependency) fails.

Error Reproduced

Error: Cannot find module 'js-yaml'
Require stack:
- squads/squad-creator-pro/scripts/generate-squad-greeting.js

Fix

After package.json creation in checkPrerequisites(), add a symlink step:

• If <project>/node_modules doesn't exist AND .aiox-core/node_modules exists
• Create a symlink (junction on Windows) pointing to the framework's node_modules
• Non-fatal: if symlink fails, just warn (scripts can still use explicit relative paths)

Test plan

• Run aiox init on a fresh project — verify symlink is created
• Run node squads/squad-creator-pro/scripts/generate-squad-greeting.js — verify no Cannot find module error
• Run aiox init on existing project with node_modules/ — verify symlink is skipped (no overwrite)
• Verify framework scripts in .aiox-core/ still work normally

🤖 Generated with Claude Code

Summary by CodeRabbit

• Chores
  • Installer now ensures project can access framework dependencies automatically by linking to existing bundled modules when needed.
  • Provides a clear success message when linking completes and a non-blocking warning with details if linking fails, allowing installation to continue.

[vercel]

@andersnsouza is attempting to deploy a commit to the SINKRA - AIOX Team on Vercel.

A member of the Team first needs to authorize it.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 00c93bd1-2dea-4708-94a4-c9378844532c

📥 Commits

Reviewing files that changed from the base of the PR and between e32fb85 and 72ae3e7.

📒 Files selected for processing (1)

• bin/aiox-init.js

🚧 Files skipped from review as they are similar to previous changes (1)

• bin/aiox-init.js

---

Walkthrough

Added a post-package.json step in the init script that, when the project root lacks node_modules but .aiox-core/node_modules exists, attempts to create a junction symlink from the project root node_modules to .aiox-core/node_modules. Symlink success is logged; failures are logged as non-fatal warnings.

Changes

Cohort / File(s)	Summary
Installer Setup Enhancement bin/aiox-init.js	Added logic after copying AIOX core to conditionally create a node_modules junction symlink from the project root to .aiox-core/node_modules, with success (green) logging and non-fatal warning logging on error.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Suggested labels

area: installer, area: core, area: cli, squad

Suggested reviewers

• oalanicolas

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title directly and specifically describes the main change: creating a symlink for node_modules to enable squad scripts to resolve framework dependencies.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[github-actions]

Welcome to aiox-core! Thanks for your first pull request.

What happens next?

1. Automated checks will run on your PR
2. A maintainer will review your changes
3. Once approved, we'll merge your contribution!

PR Checklist:

• Tests pass (npm test)
• Linting passes (npm run lint)
• Commit messages follow Conventional Commits

Thanks for contributing!

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@bin/aiox-init.js`:
- Around line 178-197: The symlink creation checks frameworkNodeModules (vars:
projectNodeModules, frameworkNodeModules) before the framework files are copied,
so fresh installs never create the link; move the entire symlink block to run
immediately after the core is copied (i.e., after the fse.copy(sourceCoreDir,
targetCoreDir) operation completes) so .aiox-core/node_modules exists when you
create the junction and keep the same try/catch logging behavior.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 3f96499f-1770-49e6-a510-37c9c5a718ca

📥 Commits

Reviewing files that changed from the base of the PR and between 0df1e25 and e32fb85.

📒 Files selected for processing (1)

• bin/aiox-init.js