chore(v1.33): tsc sweep + ops runbook covers multi-host + first-call + restart

[masonwyatt23]

Summary

• Plugin tsc: 16 errors → 0. Test-only type annotation fixes; no production logic touched.
• Server tsc: 0 errors (was already 0 once `bun install` ran).
• `docs/operations.md`: 3 new subsections covering features landed in v1.33 waves 7-10.

Files fixed

File	Cause	Fix
`tests/cli-orchestrate.test.ts`	3 RunResult fixtures missing required `handoffsTruncated` field	Add `handoffsTruncated: 0` to each
`tests/orchestrate-emit-telemetry.test.ts`	`makeResult` partial overrides widened `maxConcurrentWindows` to undefined	Add explicit `maxConcurrentWindows: []` + `handoffsTruncated: 0`
`tests/genome-cloud-sync.test.ts`	`typeof fetch` requires `preconnect` but mock didn't have it	Use structural `(url, init?) => Promise` to match `FetchFn`
`tests/orchestrate-retry-handoff.test.ts`	`fn` typed as `ReturnType` (Subprocess) but `_setSpawnForTests` wants `typeof Bun.spawn` (the function)	Change return-type annotation; mock impl already casts via `as any`
`site/app/source.ts`	Auto-generated by `fumadocs-mdx` (`bun run gen-source`) — already wired into `package.json scripts.check`	No change needed; verified clean after running the gen step

47 affected tests still pass.

docs/operations.md additions (3 new subsections)

• "Running outside Claude Code" (under section 1 — Production topology): `ASHLR_MCP_HOST` matrix (claude-code / cline / claude-desktop / codex-cli / generic) + link to `docs/multi-host-mcp.md` + list of Claude-Code-only features that silently no-op on other hosts.
• "First-call projection" (under section 5 — Logs + telemetry locations): one-shot celebration on first successful tool call, milestones flag at `~/.ashlr/milestones.json` (`first_call_celebrated`), dev test = `rm` the file and run a tool.
• "F. 'I ran the wizard but the plugin doesn't seem to work'" (under section 6 — Common-fire troubleshooting): diagnose via `~/.ashlr/restart-required` (recent writtenAt + same pid = user missed restart); fix = `/quit` Claude Code, fully reopen, run a tool.

Test plan

• `bunx tsc --noEmit` in repo root: 0 errors
• `bunx tsc --noEmit` in `server/`: 0 errors (after `bun install`)
• `bun test` on the 4 touched test files: 47/47 pass

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
ashlr-plugin-site	Building	Preview, Comment	May 26, 2026 4:40am