diff --git a/AGENTS.md b/AGENTS.md index 6667975b..317b6cbd 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -22,6 +22,13 @@ Default local run target: - Do not start the browser/web dev mode for normal development or smoke checks. The browser path is limited and lacks the full desktop runtime, IPC, terminal, provider auth, and team lifecycle behavior. - When documenting or recommending startup commands, point contributors to the desktop app unless a task explicitly asks for browser-mode internals. +Live team smoke runtime: + +- Use the orchestrator source launcher by default for live/dev smoke loops: `/Users/belief/dev/projects/claude/agent_teams_orchestrator/cli-source` +- The source launcher runs `src/entrypoints/cli.tsx` through Bun, so it reflects local orchestrator source edits immediately and cannot accidentally test stale `dist` output. +- Use the built wrapper only for release or production-like smoke checks. Build first in `/Users/belief/dev/projects/claude/agent_teams_orchestrator` with `bun run build`, then set `CLAUDE_AGENT_TEAMS_ORCHESTRATOR_CLI_PATH=/Users/belief/dev/projects/claude/agent_teams_orchestrator/cli`. +- Do not use `cli-dev` or `bun run build:dev` as proof for the production wrapper. `cli` reads `dist/local-cli/cli.js`; `cli-dev` reads `dist/local-cli-dev/cli.js`. + Fast local lint: - Use `pnpm lint:fast:files -- ` for quick preflight on files you touched. diff --git a/README.md b/README.md index 6346827c..f42ab4b1 100644 --- a/README.md +++ b/README.md @@ -92,11 +92,11 @@ If you want the FRESHEST version, clone the repo and run it from the `dev` branc - [Installation](#installation) - [Table of contents](#table-of-contents) - [What is this](#what-is-this) -- [Developer architecture docs](#developer-architecture-docs) - [Comparison](#comparison) - [Quick start](#quick-start) - [FAQ](#faq) - [Development](#development) + - [Developer architecture docs](#developer-architecture-docs) - [Tech stack](#tech-stack) - [Build for distribution](#build-for-distribution) - [Scripts](#scripts) @@ -159,15 +159,6 @@ An orchestration layer for AI agent teams across Claude, Codex, and OpenCode. -## Developer architecture docs - -For feature architecture and implementation guidance: - -- Canonical standard - [docs/FEATURE_ARCHITECTURE_STANDARD.md](docs/FEATURE_ARCHITECTURE_STANDARD.md) -- Repo working instructions - [CLAUDE.md](CLAUDE.md) -- Feature root guidance - [src/features/README.md](src/features/README.md) -- Reference implementation - `src/features/recent-projects` - ## Comparison | Feature | Agent Teams | Gastown | Paperclip | Cursor | Claude Code CLI | @@ -263,6 +254,15 @@ Yes. Run multiple teams in one project or across different projects, even simult ## Development +### Developer architecture docs + +For feature architecture and implementation guidance: + +- Canonical standard - [docs/FEATURE_ARCHITECTURE_STANDARD.md](docs/FEATURE_ARCHITECTURE_STANDARD.md) +- Repo working instructions - [CLAUDE.md](CLAUDE.md) +- Feature root guidance - [src/features/README.md](src/features/README.md) +- Reference implementation - `src/features/recent-projects` + ## Tech stack Electron 40, React 19, TypeScript 5, Tailwind CSS 3, Zustand 4. Data from `~/.claude/` (session logs, todos, tasks). The desktop app works with local runtime/session state, while some runtime modes may also use provider or startup capability services when required. diff --git a/docs/team-management/debugging-agent-teams.md b/docs/team-management/debugging-agent-teams.md index 8decd6c6..11dcde51 100644 --- a/docs/team-management/debugging-agent-teams.md +++ b/docs/team-management/debugging-agent-teams.md @@ -81,6 +81,32 @@ Use this mode to inspect interactive CLI behavior, terminal prompts, and pane ou as equivalent to the process backend for recovery semantics; persisted pane IDs can help discovery, but app restart does not make old panes a fully app-owned runtime again. +## Live Smoke Runtime Launcher + +Live/dev smoke checks should run the orchestrator from source unless the test explicitly says it is +validating packaged output. This keeps app smoke tests aligned with the source tree and avoids a stale +`dist` bundle hiding runtime changes. + +Default live/dev smoke launcher: + +```bash +export CLAUDE_AGENT_TEAMS_ORCHESTRATOR_CLI_PATH=/Users/belief/dev/projects/claude/agent_teams_orchestrator/cli-source +``` + +The source launcher executes `src/entrypoints/cli.tsx` through Bun. It is the right default for local +debug loops, live model/provider checks, and cross-repo runtime fixes. + +Release or production-like smoke checks must validate the built wrapper: + +```bash +cd /Users/belief/dev/projects/claude/agent_teams_orchestrator +bun run build +export CLAUDE_AGENT_TEAMS_ORCHESTRATOR_CLI_PATH=/Users/belief/dev/projects/claude/agent_teams_orchestrator/cli +``` + +`cli` reads `dist/local-cli/cli.js`. `cli-dev` reads `dist/local-cli-dev/cli.js`, so a passing +`cli-dev` smoke is not proof that the production wrapper is fresh. + ## Member State Meanings Common `launch-state.json` cases: diff --git a/graph-log-preview-smoke.png b/graph-log-preview-smoke.png deleted file mode 100644 index b8aec00b..00000000 Binary files a/graph-log-preview-smoke.png and /dev/null differ diff --git a/landing/assets/styles/cyberpunk-hero.scss b/landing/assets/styles/cyberpunk-hero.scss index d4feb739..5929e57f 100644 --- a/landing/assets/styles/cyberpunk-hero.scss +++ b/landing/assets/styles/cyberpunk-hero.scss @@ -256,6 +256,10 @@ background: var(--cyber-hero-bg); } +#hero.cyber-hero { + padding-top: 120px; +} + .cyber-hero__background, .cyber-hero__monterey, .cyber-hero__wash, diff --git a/landing/components/layout/AppFooter.vue b/landing/components/layout/AppFooter.vue index 8e918abb..da28e209 100644 --- a/landing/components/layout/AppFooter.vue +++ b/landing/components/layout/AppFooter.vue @@ -61,7 +61,7 @@ const docsHref = computed(() => { .app-footer__robot-stage { position: absolute; right: clamp(24px, 7vw, 112px); - bottom: calc(100% - 18px); + bottom: calc(100% - 11px); z-index: 2; width: clamp(178px, 16vw, 236px); pointer-events: none; diff --git a/landing/layouts/default.vue b/landing/layouts/default.vue index 2b25e1e9..4ddbe3a2 100644 --- a/landing/layouts/default.vue +++ b/landing/layouts/default.vue @@ -11,7 +11,6 @@