Commit Graph

369 Commits

Author SHA1 Message Date
suraj-markup fea320e92a docs: add prerequisite matrix and install behavior details
Expand the Interactive Prerequisite Prompts section with:
- Full prerequisite matrix table (tmux, git, agent runtime, gh, docker)
  showing required status, prompts, install methods per platform, and
  failure behavior
- Key behaviors list (consent-first, logging, blocking, non-TTY fallback)
- Example terminal output for fresh machine install flow

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-24 18:09:00 +05:30
suraj-markup fafe76c45a docs: upgrade flow diagrams to visual CSS flowcharts
Replace ASCII art flow diagrams with styled HTML/CSS flowcharts using
color-coded nodes (blue=command, yellow=decision, green=success,
red=failure) and proper branching layout.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-24 17:53:43 +05:30
suraj-markup eee9d773f4 fix: interactive tmux install with user consent, log before auto-install
- Refactor ensureTmux() to use askYesNo() + tryInstallWithAttempts()
  matching the existing ensureGit() pattern — no silent sudo
- Add log line before each auto-install attempt in preflight.checkTmux()
- Update config warning: "will prompt to install at startup"
- Update design doc to reflect interactive consent flow
- Include prior uncommitted changes: interactive install prompts for
  git/gh/agent-runtime, ensureGit(), canPromptForInstall(), askYesNo()

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-24 17:46:56 +05:30
suraj-markup 9d15ce5d16 fix(start): enforce tmux preflight across all start paths 2026-03-24 15:24:26 +05:30
suraj-markup f54630021c fix: block with clear tmux install instructions instead of process fallback
A degraded runtime gives a bad first impression. Instead of silently
falling back to runtime: "process", ao start now:
1. Tries auto-install (brew/apt/dnf)
2. On failure, exits with clear platform-specific install command
3. User runs one command, then re-runs ao start

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-24 03:40:15 +05:30
suraj-markup 761173456d fix: true two-step setup — tmux auto-install, process fallback, restart bookkeeping
- checkTmux() now attempts auto-install (brew/apt/dnf) before erroring
- Config generation uses runtime: "process" when tmux unavailable
- start.ts tries auto-install during config creation, falls back gracefully
- Fix restart bookkeeping in start-all.ts: slot-based tracking prevents
  duplicate children entries that broke cleanup countdown
- Updated design doc reflecting all fixes and review feedback

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-24 03:31:06 +05:30
suraj-markup 90ee21c3e1 fix: repair npm global install — walk-up dep resolution, spawn-helper chmod, platform-aware messages
- Replace hardcoded single-level checkBuilt() with findPackageUp() walk-up
  resolver that handles npm hoisting (fixes #619)
- Add postinstall script to chmod node-pty spawn-helper for global installs
  (fixes #624)
- Platform-aware tmux install messages (brew/apt/dnf/WSL instead of
  hardcoded brew)
- Auto-restart crashed terminal servers in start-all.ts (up to 3 retries)
- ESLint config for packages/ao/bin scripts
- Expanded preflight tests (3 → 5 checkBuilt cases)

Closes #619, closes #624

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-24 03:06:40 +05:30
suraj_markup 4741ba2461
Merge pull request #528 from ashish921998/ashish/chore/kanban-redesign
feat(web): add light/dark mode theme toggle
2026-03-23 17:44:04 +05:30
Ashish Huddar 254d64de8f fix(web): use flat color for dark mode --card-merge-bg
The variable was a linear-gradient (an <image>), but it's used inside
color-mix() which only accepts <color> values. This made the entire
background declaration invalid, rendering merge-ready cards transparent
in dark mode.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-23 17:15:07 +05:30
Ashish Huddar 8e34695eec fix(web): use resolvedTheme in ThemeToggle for system theme support
Switches from theme to resolvedTheme so the toggle shows the correct
icon and toggles correctly even when theme is set to "system".

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-23 17:03:38 +05:30
Ashish Huddar 0fe6340594 fix(web): show EmptyState when only done sessions exist
hasAnySessions now checks kanban-visible levels instead of all
displaySessions, so the board doesn't render empty columns when
every session is in the "done" state.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-23 16:49:46 +05:30
Ashish Huddar f781be04b1 fix(web): remove unused imports to fix CI lint errors
Remove unused `ActivityDot` import and `humanizeStatus` function from
SessionDetail.tsx that caused lint, typecheck, and onboarding CI failures.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-23 15:54:11 +05:30
Ashish Huddar b6637dec6c final 2026-03-23 10:42:15 +05:30
Ashish Huddar 6b7a8bd20c chore(web): design audit fixes — rename column, refine styles, fix terminal
- Rename "Merge Ready" kanban column to "Ready"
- Refine card design system and globals.css theme tokens
- Fix terminal scrollbar and theme handling in DirectTerminal
- Update SessionDetail layout
- Update tests to match component changes
- Add .gstack/ to .gitignore

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-23 09:58:24 +05:30
Ashish Huddar 9ee1660dfa chore(web): refine card design, terminal scrollbar, and add card showcase
Flatten card shadows, add subtle borders, simplify SessionCard markup,
apply macOS-style auto-hide scrollbar to terminal, and add dev card
showcase page for visual testing.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-21 20:32:43 +05:30
suraj_markup a37a210977
Merge pull request #593 from suraj-markup/fix/resolve-project-cwd-matching
fix: auto-detect project from cwd in multi-project configs
2026-03-21 18:51:24 +05:30
suraj-markup 6d1055f412 fix: simplify cwd matching — remove redundant tilde expansion
loadConfig() already expands ~ in project paths via expandPaths(),
so manual replacement is unnecessary. Use resolve(proj.path) directly.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-21 18:08:15 +05:30
suraj-markup 36098efd0b fix: auto-detect project from cwd in multi-project configs
When multiple projects are configured and no project argument is given,
`ao start` and `ao stop` now match the current working directory against
project paths before erroring. This lets users run `ao start` from within
a project directory without specifying the project name.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-21 18:02:42 +05:30
Ashish Huddar fb86167639 chore(web): remove unused Skeleton exports
Remove SkeletonBlock, ErrorState, DashboardSkeleton, and
SessionDetailSkeleton — none are imported anywhere in the codebase.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-21 15:59:17 +05:30
Ashish Huddar 13dcbc8716 fix(web): move early return before hooks in ProjectSidebar
Fixes React Rules of Hooks violation where useMemo ran after a
conditional early return, causing inconsistent hook call counts.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-21 15:34:57 +05:30
suraj_markup 84ac872259
Merge pull request #585 from ComposioHQ/changeset-release/main
chore: version packages
2026-03-21 15:26:43 +05:30
suraj-markup 0d6e26d104 fix: update package-version test to match 0.2.0 bump 2026-03-21 15:22:27 +05:30
Ashish Huddar 83f0c2ca46 test(web): update tests for kanban redesign
- Add useSearchParams mock to Dashboard test files
- Update SessionCard merge button text (Merge PR #N → Merge PR)
- Update AttentionZone tests for always-visible kanban columns
- Add missing sessions/activeSessionId props to ProjectSidebar tests
- Add missing issueTitle field to Dashboard empty state test mock

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-21 13:17:14 +05:30
Ashish Huddar 038620ffd1 fix(web): pre-landing review fixes
- Remove unnecessary !important on light mode background
- Add useMemo to ProjectSidebar session grouping (O(n*m) → O(n))
- Filter done sessions from sidebar nav (prevents empty board)
- Fix stale session param showing empty columns instead of empty state
- Add dark class to server-rendered HTML to prevent FOUC

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-21 13:17:06 +05:30
Ashish Huddar 28e6b96990 Merge remote-tracking branch 'origin/main' into ashish/chore/kanban-redesign 2026-03-21 13:13:16 +05:30
Ashish Huddar f24abc2145 Add collapsible project sidebar with bottom toggle 2026-03-21 11:49:39 +05:30
Ashish Huddar 4b171cd37b fix(web): wire up ThemeToggle with next-themes provider
- Install next-themes dependency
- Wrap app in ThemeProvider with class-based dark mode
- Remove hardcoded dark class from html element

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-21 11:06:41 +05:30
Ashish Huddar bfe100c543 chore(web): remove showcase page
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-21 11:03:53 +05:30
Ashish Huddar f9feb4bbf8 chore(web): kanban dashboard redesign — Linear-inspired design system
Redesign the kanban dashboard with a Linear-inspired aesthetic:
- New design tokens (neutral charcoal darks, white-alpha borders, muted status colors, indigo accent)
- Tighter spacing, visible column backgrounds, dark mode weight reduction
- Redesigned SessionCard, ProjectSidebar, and AttentionZone components
- Removed list view toggle, reordered columns (respond → merge → done)
- Added ThemeToggle, Skeleton/EmptyState components, and showcase page
- Exported CI_STATUS and getSizeLabel for component consumption

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-21 11:01:31 +05:30
suraj-markup 4be6bc596a trigger CI 2026-03-21 03:53:00 +05:30
github-actions[bot] c7d6634839 chore: version packages 2026-03-20 15:47:55 +00:00
suraj_markup feb691e0b7
Merge pull request #582 from suraj-markup/fix/release-workflow-husky
fix: disable husky in release workflow to unblock npm publish
2026-03-20 21:17:07 +05:30
suraj-markup ebfa33c978 fix: disable husky in release workflow to unblock npm publish
The changesets action commits version bumps internally, but the husky
pre-commit hook requires gitleaks which isn't installed on the CI runner.
Set HUSKY=0 to skip hooks in the release job.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-20 18:44:37 +05:30
suraj_markup 3b42bd9525
Merge pull request #578 from suraj-markup/chore/add-changeset
chore: add changeset to trigger npm publish for onboarding improvements
2026-03-20 17:08:30 +05:30
suraj-markup 3a650b02bf chore: add changeset to trigger npm publish
Adds changeset for the onboarding improvements merged in #463 and #537.
This will trigger the release workflow to publish updated versions of
@composio/ao, @composio/ao-cli, @composio/ao-core, and @composio/ao-web.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-20 16:26:16 +05:30
suraj_markup a99aedf9a8
Merge pull request #537 from suraj-markup/feat/onboarding-improvements
feat: zero-friction onboarding — ao start does everything
2026-03-19 07:52:31 +05:30
suraj-markup 78a4233282 docs: simplify install to a single npm command
One command to install: npm install -g @composio/ao
Permission fix and source install tucked into a <details> block.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 07:27:30 +05:30
suraj-markup bce49a1981 docs: move CLI reference out of README, focus on user experience
The README should sell the experience, not list CLI flags. Humans
interact with `ao start` and the dashboard — the CLI is primarily
used by the orchestrator agent internally.

- Move full CLI reference to docs/CLI.md with clear sections:
  "commands humans use" vs "commands the orchestrator agent uses"
- Rewrite README to focus on install → start → done flow
- Remove CLI and Maintenance sections from README
- Simplify "How It Works" to describe the system, not CLI commands
- Add CLI Reference to Documentation table
- Collapse source install into <details> to reduce noise

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 07:23:32 +05:30
suraj-markup 4fcdc674d4 Rename npm package from @composio/agent-orchestrator to @composio/ao
Users can now install with:
  npm install -g @composio/ao

Instead of the longer:
  npm install -g @composio/agent-orchestrator

- Rename packages/agent-orchestrator → packages/ao
- Update package.json name and directory field
- Update all references in README, SETUP.md, changeset config, and CLI error messages

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 02:17:02 +05:30
suraj-markup 9f89efa061 docs: update README and SETUP.md for new onboarding flow
- README: restructure Quick Start with clear Option A (npm) and Option B
  (source) sections, each showing the full flow from install to first spawn
- README: clarify that `ao` is the CLI command after npm install
- README: add `ao stop`, `ao batch-spawn`, and `--agent` flag to CLI reference
- README: note that `ao start` auto-generates config
- SETUP.md: replace stale `ao init` wizard docs (13-prompt flow no longer
  exists) with `ao start` auto-detection docs
- SETUP.md: update minimal config (remove dataDir/worktreeDir — auto-managed)
- SETUP.md: fix all `ao spawn <project> <issue>` to `ao spawn <issue>`
- SETUP.md: update troubleshooting for auto-port-finding and config creation

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 02:12:11 +05:30
suraj_markup 178af32682
Merge pull request #463 from suraj-markup/feat/onboarding-improvements
feat: reduce onboarding friction — auto-init, add-project, dashboard publishing, error hardening
2026-03-19 01:21:34 +05:30
suraj_markup d3273a7938
Merge pull request #361 from Deepak7704/fix/metadata-hook-cd-prefix
fix(agent-claude-code): detect cd-prefixed gh/git commands and use relative hook path
2026-03-19 00:57:00 +05:30
suraj-markup 716be0cb74 Fix Bugbot review comments: tilde expansion, duplicate names, cross-platform detect
- Fix autoDetectProject path matching: expand ~ before comparing project
  paths to cwd, so `path: ~/my-repo` matches `/Users/user/my-repo`
- Fix addProjectToConfig: detect duplicate directory names and auto-suffix
  instead of silently overwriting existing project entries
- Fix agent detect() in all 4 plugins: replace `which` (Unix-only) with
  direct `--version` invocation for cross-platform compatibility

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-17 18:27:01 +05:30
suraj-markup 596913aa34 Fix review issues: busy-wait loops, lock race, import hygiene, typed errors
- Replace CPU-burning spin loops in running-state.ts with async setTimeout
  and jittered backoff; make all exports async
- Fix TOCTOU race in acquireLock by extracting tryAcquire helper with
  retry loop instead of force-remove-and-retry-once
- Hoist dynamic imports in addProjectToConfig/choice-2 to static imports
- Add try/finally around readline in detectAgentRuntime
- Validate session prefix uniqueness in "Start new orchestrator" menu
- Add ConfigNotFoundError class to @composio/ao-core, replace fragile
  string matching in ao start with instanceof check
- Fix setup.sh to recommend `ao start` instead of deprecated `ao init`
- Fix start-all.ts: resolve next binary with fallback, wait for children
  on SIGTERM instead of immediate process.exit

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-17 17:33:06 +05:30
suraj-markup 511d2b7fb9 Resolve remaining PR review comments
- Remove redundant project-existence check after autoDetectProject
- Wrap SIGTERM in try/catch for restart flow (dead process case)
- Remove unused setCallerContext export from caller-context.ts
- Fix unused vi import lint error in init.test.ts

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-17 15:51:02 +05:30
suraj-markup 47a043ff6f Fix CI test hang: add missing mocks for new imports in start.test.ts
- Add vi.mock() for running-state, caller-context, detect-env,
  detect-agent, and project-detection modules imported by start.ts
- Without these mocks, vitest threads never exit (open handles)
- Remove init.test.ts test that triggered dynamic import of start.js
- Relax waitForPortAndOpen assertion (port resolution depends on
  full dashboard startup which is mocked out)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-17 15:41:55 +05:30
suraj-markup 09f757dd0e Fix PR review comments: spawn hint, dead code, detect import
- Fix spawn hint in start.ts to use new single-arg syntax
- Remove dead addProjectOnly() export (add-project fully deleted)
- Make detect-agent.ts handle both named and default export shapes

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-17 15:14:42 +05:30
suraj-markup 61bb9ea108 Update design doc: spawn no longer accepts project arg
- Section 5: spawn/batch-spawn descriptions updated
- Section 9: mermaid diagram simplified (no two-arg branch)
- Section 10: scenarios #8, #11, #14 updated
- Section 12: ID collision finding updated (no ambiguity possible)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-17 14:34:11 +05:30
suraj-markup 030c669c37 Show friendly warning instead of hard error for old two-arg spawn syntax
When users run `ao spawn <project> <issue>`, show a yellow warning
explaining the new syntax (`ao spawn <issue>`) instead of Commander's
raw "too many arguments" error.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-17 14:32:35 +05:30
suraj-markup 44313f925d Remove two-arg support from ao spawn and batch-spawn
- spawn now takes only `[issue]` — project is always auto-detected
- batch-spawn now takes only `<issues...>` — no project prefix
- Commander rejects extra positional args automatically
- Update orchestrator prompt to remove projectId from spawn example
- Rewrite spawn tests to use auto-detected project (single project in config)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-17 14:29:14 +05:30