agent-orchestrator/scripts
Prateek b9727c8418 fix: orchestrator session naming when sessionPrefix is undefined
## Problem
When users ran `ao init`, no `sessionPrefix` was set in the config.
Then `ao start` would create sessions named `undefined-orchestrator`
instead of `{projectId}-orchestrator`, causing the dashboard to not
find the orchestrator session (button missing).

## Root Cause
In `start.ts` lines 177 & 369, the orchestrator session ID was
constructed without a fallback:
```typescript
const sessionId = `${project.sessionPrefix}-orchestrator`;
```

## Fix
Added fallback to projectId (consistent with other commands):
```typescript
const sessionId = `${project.sessionPrefix || projectId}-orchestrator`;
```

## Additional Improvements
- Dashboard: Show helpful tooltip when orchestrator missing
- Documentation: Added QUICKTEST.md with manual test procedures
- Testing: Added automated test script (./scripts/test-orchestrator-setup.sh)
- Testing: Added .github/TESTING_GUIDE.md for contributors

## Testing
-  Automated test passes (creates session with correct name)
-  Tested on fresh integrator checkout with no sessionPrefix
-  Session created as `integrator-orchestrator` (not `undefined-orchestrator`)
-  Metadata file created correctly
-  Dashboard can find orchestrator session

Run test: ./scripts/test-orchestrator-setup.sh

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-16 23:32:18 +05:30
..
claude-ao-session feat: add agent-orchestrator (ao) as a self-hosting project 2026-02-13 15:44:17 +05:30
claude-batch-spawn feat: add agent-orchestrator (ao) as a self-hosting project 2026-02-13 15:44:17 +05:30
claude-bugbot-fix feat: add agent-orchestrator (ao) as a self-hosting project 2026-02-13 15:44:17 +05:30
claude-dashboard feat: initial commit with orchestrator scripts and dev instructions 2026-02-13 15:25:31 +05:30
claude-integrator-session feat: initial commit with orchestrator scripts and dev instructions 2026-02-13 15:25:31 +05:30
claude-open-all feat: add agent-orchestrator (ao) as a self-hosting project 2026-02-13 15:44:17 +05:30
claude-review-check feat: add agent-orchestrator (ao) as a self-hosting project 2026-02-13 15:44:17 +05:30
claude-session-status feat: initial commit with orchestrator scripts and dev instructions 2026-02-13 15:25:31 +05:30
claude-spawn feat: add agent-orchestrator (ao) as a self-hosting project 2026-02-13 15:44:17 +05:30
claude-spawn-on-branch feat: initial commit with orchestrator scripts and dev instructions 2026-02-13 15:25:31 +05:30
claude-spawn-with-context feat: initial commit with orchestrator scripts and dev instructions 2026-02-13 15:25:31 +05:30
claude-spawn-with-prompt feat: initial commit with orchestrator scripts and dev instructions 2026-02-13 15:25:31 +05:30
claude-splitly-session feat: initial commit with orchestrator scripts and dev instructions 2026-02-13 15:25:31 +05:30
claude-status feat: add agent-orchestrator (ao) as a self-hosting project 2026-02-13 15:44:17 +05:30
get-claude-session-info feat: initial commit with orchestrator scripts and dev instructions 2026-02-13 15:25:31 +05:30
notify-session feat: initial commit with orchestrator scripts and dev instructions 2026-02-13 15:25:31 +05:30
open-iterm-tab feat: initial commit with orchestrator scripts and dev instructions 2026-02-13 15:25:31 +05:30
open-tmux-session feat: initial commit with orchestrator scripts and dev instructions 2026-02-13 15:25:31 +05:30
rebuild-node-pty.js feat: seamless onboarding with enhanced documentation (#66) 2026-02-16 22:22:13 +05:30
send-to-session feat: initial commit with orchestrator scripts and dev instructions 2026-02-13 15:25:31 +05:30
setup.sh feat: seamless onboarding with enhanced documentation (#66) 2026-02-16 22:22:13 +05:30
test-orchestrator-setup.sh fix: orchestrator session naming when sessionPrefix is undefined 2026-02-16 23:32:18 +05:30