@orchestree/cli 2.2.0 → 3.5.0

package/CHANGELOG.md

@@ -0,0 +1,101 @@
+# @orchestree/cli
+
+## 3.5.0
+
+Full-screen lobby. Ships with `@orchestree/crowcode-cli` 0.5.0.
+
+- **Grok Build-style takeover.** `crow` now opens on the alternate screen:
+  the viewport clears, the CrowCode welcome card sits centered in the
+  middle of the terminal, and the input box is pinned to the bottom edge
+  with the slash palette opening above it. The first message returns to
+  the normal buffer so long turns keep real scrollback; `/new` and
+  `/clear` bring the lobby back; quitting always restores your shell.
+- **PTY fix.** Terminals that report `rows`/`columns` as `0` no longer
+  break layout math.
+
+## 3.4.0
+
+Command-surface Wave 1 — session management, scripting output, and
+self-maintenance. Ships with `@orchestree/crowcode-cli` 0.4.0.
+
+- **Sessions.** `crow sessions` lists saved conversations (id, age, message
+  count, first prompt, directory), `crow sessions search <q>` greps their
+  content, `crow sessions delete <id>` removes one, and
+  `crow export <id> [file.md]` renders a transcript as Markdown with
+  readable tool-call blocks. Inside the REPL: `/sessions`, `/resume <id>`,
+  and `/usage` (approximate context tokens; `/context` is an alias).
+- **Continue & resume.** `crow -c`/`--continue` picks up the most recent
+  session for the current directory; `crow -r <id>` resumes any session by
+  id from anywhere (a missing id is an error, not a silent new session).
+- **Headless scripting.** `crow -p "prompt" --output-format json` emits one
+  JSON object (result + full event log); `--output-format streaming-json`
+  emits NDJSON events (`round_start`, `text`, `tool_use`, `tool_result`)
+  as the turn progresses, ending with a `result` line. No spinner or chrome
+  on stdout — approvals are denied unless `--yolo`, reported on stderr.
+- **`crow models`** lists the tiers and marks the configured one.
+- **`crow update [--check]`** compares the installed version against the
+  release CDN and re-runs the official installer to upgrade.
+- **`crow doctor`** diagnoses the install: Node version, install origin,
+  PATH shadowing (finds stale `npm link` copies that hijack `crow`),
+  release-CDN reachability + version currency, and API reachability.
+- **`crow completions <zsh|bash>`** prints shell tab-completions.
+- Prompts and agent flags now forward through `crow` directly:
+  `crow "fix the failing test"` one-shots the agent without the `crowcode`
+  subcommand.
+
+## 3.3.0
+
+- **Rendered answers.** CrowCode no longer prints raw markdown: pipe tables
+  are drawn as bordered box tables in Crow orange (aligned columns, bold
+  header row), headings lose their hashes and render as bold orange section
+  titles (h1 gets an ember underline), `**bold**`/`*italic*`/`` `code` ``
+  are styled instead of leaking their markers, lists get orange bullets and
+  numbered markers, task lists get ◉/◯ checkboxes, blockquotes and
+  horizontal rules are drawn. Fenced code keeps its diff tint. Everything
+  still degrades to structured plain text when piped or `NO_COLOR` is set.
+  Ships in `@orchestree/crowcode-cli` 0.3.0.
+- Cleaner agent chrome: approval requests render as a warning-barred block,
+  assistant answers get breathing room, and every turn ends with a dim
+  `Turn completed in 12.4s.` footer.
+
+## 3.2.1
+
+- Bundle rebuild only, no code changes. The `crow-3.2.0.tgz` artifact on the
+  CDN was built before the Crow terminal design merged; published artifacts
+  are immutable, so the TUI ships as 3.2.1 (`media.orchestree.ai/cli/latest`
+  now points here).
+
+## 3.2.0
+
+- **The Crow terminal design.** CrowCode now draws a full Grok-parity terminal
+  UI in Crow orange on the dark terminal background: a welcome card with the
+  crow glyph, a rounded bordered input box with a block cursor and the model
+  label set into the border, a slash-command palette (`/` opens it; type to
+  filter, tab to complete, enter to run), ↑/↓ history with draft restore,
+  emacs-style line editing, and orange spinners with elapsed time on tool runs.
+  Ships in `@orchestree/crowcode-cli` 0.2.0 on the shared theme engine in
+  `@orchestree/cli-core` 0.2.0.
+- `crow --help` is themed with the same palette. All color degrades cleanly:
+  truecolor → 256 → basic → plain text when piped, `NO_COLOR` is set, or the
+  terminal is dumb.
+- Installer fix: the `orchestree.ai/crow` install script no longer shares the
+  edge cache across user-agent variants, and works under busybox `wget`.
+
+## 3.1.0
+
+- **New primary command: `crow`.** The CLI you type is now `crow` (`crow login`,
+  `crow whoami`, `crow gateways`, `crow crowcode`). Pattern: git/GitHub —
+  short where fingers live, full name (CrowCode) where brands live.
+- `orchestree` remains a working alias for one major version. It runs the exact
+  same CLI and prints a one-line tip to stderr:
+  `Tip: `orchestree` is now `crow` — same CLI, shorter name.`
+- Help, version output, and every error hint now use `crow` as the primary form
+  (including messages from `@orchestree/cli-core`).
+- Added `crow` / `crowcode` npm keywords.
+
+## 3.0.0
+
+- `@orchestree/cli` npm name moved to this package (`apps/orchestree-cli`),
+  superseding the legacy `packages/cli` implementation.
+- `orchestree login | logout | whoami` (keychain-backed), `orchestree gateways`
+  with the Vertex ADC setup wizard, and the `crowcode` launcher.

package/README.md

@@ -1,528 +1,57 @@
-# Orchestree CLI
+# CrowCode CLI (`crow`)
 
-🚀 **Orchestree CLI** - The intelligent command-line interface for the Orchestree Platform
+The Orchestree platform in your terminal: sign in, inspect your identity,
+manage model gateways, and launch the suite's agents.
 
-A production-quality CLI tool for managing your Orchestree workspace, modules, automations, and deployments. Full-featured terminal UI with colorful output, powerful workflows, and zero-dependency design.
-
-## Features
-
-- **Authentication** - Seamless login/logout with session management
-- **Workspace Management** - Create and manage multiple workspaces
-- **Module Management** - Enable, disable, and monitor 23+ Orchestree modules
-- **Workflow Automation** - Create and execute Conductor workflows
-- **Social Publishing** - Post to multiple platforms with analytics
-- **Code Generation** - AI-powered code generation with Codenza
-- **Brand Studio** - Create branded assets with Forge
-- **Development Tools** - Scaffolding, testing, auditing, and deployment
-- **Zero Dependencies** - Pure JavaScript, no heavy npm packages
-- **Colorful Output** - Beautiful ANSI terminal colors and formatting
-- **Fully Typed** - Complete TypeScript declarations included
+The product is **CrowCode**. The command you type is **`crow`** — the same
+pattern as git/GitHub: short where fingers live, full name where brands live.
 
 ## Installation
 
-### Via NPM
-
 ```bash
 npm install -g @orchestree/cli
 ```
 
-### Via Yarn
-
-```bash
-yarn global add @orchestree/cli
-```
-
-### From Source
-
-```bash
-git clone https://github.com/orchestree/orchestree.git
-cd packages/cli
-npm install -g .
-```
-
-## Quick Start
-
-```bash
-# Login to your Orchestree account
-orchestree auth login
-
-# Check your authentication status
-orchestree auth status
-
-# List available modules
-orchestree modules list
-
-# View your workspaces
-orchestree workspace list
-
-# Create a new workspace
-orchestree workspace create my-workspace
-
-# Start the development server
-orchestree dev serve
-```
-
-## Commands
-
-### Authentication
-
-```bash
-orchestree auth login              # Log in to your Orchestree account
-orchestree auth logout             # Log out from Orchestree
-orchestree auth status             # Check authentication status
-```
-
-### Workspace Management
-
-```bash
-orchestree workspace list          # List all workspaces
-orchestree workspace create <name> # Create a new workspace
-orchestree workspace switch <name> # Switch to a workspace
-```
-
-### Module Management
-
-Manage and monitor the 23 available Orchestree modules:
-
-```bash
-orchestree modules list            # List all available modules
-orchestree modules enable <name>   # Enable a specific module
-orchestree modules status          # Show status of all modules
-orchestree modules health          # Check health of all modules
-```
-
-**Available Modules:**
-- `social` - Social media publishing and management
-- `conductor` - Workflow orchestration and automation
-- `codenza` - AI-powered code generation and review
-- `forge` - Brand studio for visual asset creation
-- `enhance` - Module enhancement and optimization
-- `analytics` - Advanced analytics and reporting
-- `webhook` - Webhook management and integration
-- `ai-assist` - AI assistance and guidance
-- `integrations` - Third-party integrations
-- `api` - API management and monitoring
-- `templates` - Template library and customization
-- `components` - Reusable component library
-- `workflows` - Workflow management
-- `scheduler` - Task scheduling
-- `monitoring` - System monitoring and alerts
-- `security` - Security features and compliance
-- `performance` - Performance optimization
-- `notifications` - Notification system
-- `storage` - Data storage management
-- `billing` - Billing and usage tracking
-- `admin` - Administrative features
-- `export` - Data export capabilities
-- `import` - Data import capabilities
-
-### Conductor Workflows
-
-Manage automation workflows and processes:
-
-```bash
-orchestree conductor workflows      # List all automation workflows
-orchestree conductor run <workflow> # Run a specific workflow
-orchestree conductor logs           # View workflow execution logs
-```
-
-**Examples:**
-```bash
-orchestree conductor run daily-sync
-orchestree conductor run lead-nurture
-orchestree conductor logs
-```
+This installs the `crow` command. `orchestree` is also installed as a working
+alias (kept for one major version) — it runs the exact same CLI and prints a
+one-line tip to stderr.
 
-### Social Media Publishing
+Requires Node.js >= 20.
 
-Publish and manage social media content:
+## Usage
 
 ```bash
-orchestree social post "Your content here"     # Post to social media
-orchestree social schedule                     # Schedule a post
-orchestree social analytics                    # View social analytics
+crow login [--stdin] [--api <base>]   # sign in with an Orchestree API key
+crow logout                           # sign out — clears every credential backend
+crow whoami                           # show org · key name · scope
+crow gateways                         # list model gateways and their status
+crow gateways setup <id>              # configure a gateway (e.g. vertex)
+crow crowcode [args...]               # launch the CrowCode coding agent
+crow --version | --help
 ```
 
-**Examples:**
-```bash
-orchestree social post "Check out our latest update!"
-orchestree social schedule --date 2025-12-25 --time 09:00 --content "Holiday special!"
-orchestree social analytics
-```
+## Authentication notes
 
-### Code Generation (Codenza)
+- Keys are stored in the OS keychain (0600 file fallback with a warning).
+- `ORCHESTREE_API_KEY` overrides stored credentials — CI only; any agent
+  subprocess this CLI spawns can read the environment.
+- The key is never accepted as a command-line argument. Use the hidden
+  prompt (`crow login`) or pipe it: `crow login --stdin < keyfile`.
 
-AI-powered code generation, review, and documentation:
+## Why is the command called `crow`?
 
-```bash
-orchestree codenza generate                    # Generate code
-orchestree codenza review <file>               # Review code with AI
-orchestree codenza docs                        # Generate documentation
-```
-
-**Examples:**
-```bash
-orchestree codenza generate --type component --name MyButton
-orchestree codenza review src/main.js
-orchestree codenza docs --input ./src
-```
-
-### Brand Studio (Forge)
-
-Create branded assets and manage your brand kit:
-
-```bash
-orchestree forge create                        # Create branded assets
-orchestree forge brand-kit                     # Manage brand kit
-```
-
-**Examples:**
-```bash
-orchestree forge create --type social-post --topic "Product Launch"
-orchestree forge create --type banner --size 1200x630
-orchestree forge brand-kit
-```
-
-### Module Enhancement
-
-Enhance any Orchestree module with optimization and security hardening:
-
-```bash
-orchestree enhance <module>
-```
-
-**Examples:**
-```bash
-orchestree enhance social
-orchestree enhance conductor
-orchestree enhance codenza
-orchestree enhance forge
-```
-
-All 23 modules can be enhanced:
-```bash
-orchestree enhance social
-orchestree enhance conductor
-orchestree enhance codenza
-orchestree enhance forge
-orchestree enhance analytics
-orchestree enhance webhook
-orchestree enhance ai-assist
-orchestree enhance audit
-orchestree enhance integrations
-orchestree enhance api
-orchestree enhance templates
-orchestree enhance components
-orchestree enhance workflows
-orchestree enhance scheduler
-orchestree enhance monitoring
-orchestree enhance security
-orchestree enhance performance
-orchestree enhance notifications
-orchestree enhance storage
-orchestree enhance billing
-orchestree enhance admin
-orchestree enhance export
-orchestree enhance import
-```
-
-### Code Scaffolding
-
-Generate boilerplate code for new features:
-
-```bash
-orchestree scaffold api-endpoint <name>       # Scaffold API endpoint
-orchestree scaffold new-module <name>         # Scaffold new module
-```
-
-**Examples:**
-```bash
-orchestree scaffold api-endpoint users-api
-orchestree scaffold new-module reporting
-```
-
-### System Audit
-
-Audit system health, code quality, and security:
-
-```bash
-orchestree audit                               # Full system audit
-orchestree audit --type ui                     # UI quality audit
-orchestree audit --type code                   # Code quality audit
-orchestree audit --type security               # Security audit
-orchestree audit --module social               # Audit specific module
-```
-
-**Examples:**
-```bash
-orchestree audit
-orchestree audit --type code --module conductor
-orchestree audit --type security
-```
-
-### Testing
-
-Run the test suite:
-
-```bash
-orchestree test                                # Run all tests
-```
-
-### Development Commands
-
-Manage local development and deployment:
-
-```bash
-orchestree dev serve                          # Start development server
-orchestree dev deploy                         # Deploy to staging
-orchestree dev logs                           # View server logs
-```
-
-**Examples:**
-```bash
-orchestree dev serve
-# Server runs on http://localhost:3000
-
-orchestree dev deploy
-# Deploys to staging: https://staging.orchestree.ai/dashboard
-
-orchestree dev logs
-# Shows server logs and events
-```
-
-## Global Options
-
-Use these flags with any command:
-
-```bash
--h, --help          Display help menu
--v, --version       Show version number
---verbose           Enable verbose logging
---json              Output as JSON
-```
-
-**Examples:**
-```bash
-orchestree auth login --verbose
-orchestree modules list --json
-orchestree --help
-orchestree --version
-```
-
-## Configuration
-
-The CLI stores configuration in your home directory:
-
-**macOS/Linux:** `~/.orchestree`
-**Windows:** `%USERPROFILE%\.orchestree`
-
-Configuration is stored as JSON:
-
-```json
-{
-  "authenticated": true,
-  "workspace": "default",
-  "userId": "user_abc123xyz",
-  "debug": false
-}
-```
-
-## Examples
-
-### Complete Workflow
-
-```bash
-# 1. Login
-orchestree auth login
-
-# 2. Create a new workspace
-orchestree workspace create my-project
-
-# 3. Switch to the workspace
-orchestree workspace switch my-project
-
-# 4. Enable modules
-orchestree modules enable social
-orchestree modules enable conductor
-
-# 5. Check module health
-orchestree modules health
-
-# 6. Create an API endpoint scaffold
-orchestree scaffold api-endpoint users
-
-# 7. Start development server
-orchestree dev serve
-
-# 8. Create a workflow
-orchestree conductor workflows
-
-# 9. Deploy to staging
-orchestree dev deploy
-```
-
-### Social Media Campaign
-
-```bash
-# Generate content with AI
-orchestree codenza generate --type "social-post" --topic "Product Launch"
-
-# Create branded assets
-orchestree forge create --type "social-post"
-
-# Schedule posts
-orchestree social schedule --date 2025-12-25 --time 09:00 --content "Merry Christmas!"
-
-# Monitor analytics
-orchestree social analytics
-```
-
-### Code Development
-
-```bash
-# Scaffold new feature
-orchestree scaffold api-endpoint orders
-
-# Generate code with AI
-orchestree codenza generate --type component
-
-# Review code
-orchestree codenza review src/components/Button.js
-
-# Run tests
-orchestree test
-
-# Start dev server
-orchestree dev serve
-
-# Deploy when ready
-orchestree dev deploy
-```
-
-## Troubleshooting
-
-### "Command not found"
-
-Make sure the CLI is installed globally:
-
-```bash
-npm install -g @orchestree/cli
-```
-
-Check the installation:
-
-```bash
-orchestree --version
-```
-
-### "Not authenticated"
-
-Log in first:
-
-```bash
-orchestree auth login
-```
-
-Check status:
-
-```bash
-orchestree auth status
-```
-
-### "Module not found"
-
-List available modules:
-
-```bash
-orchestree modules list
-```
-
-Enable the module:
-
-```bash
-orchestree modules enable module-name
-```
-
-### Enable Debug Mode
-
-For detailed error messages:
-
-```bash
-orchestree command --verbose
-```
+CrowCode is the product name; `crow` is what you type. Long commands don't
+survive contact with a terminal — `git` isn't `github`, `kubectl` users
+alias it to `k`. `orchestree` keeps working as an alias for one major
+version so existing scripts never break.
 
 ## Development
 
-### Building from Source
-
-```bash
-git clone https://github.com/orchestree/orchestree.git
-cd packages/cli
-npm install
-npm link
-```
-
-### Running in Development
+From the monorepo root:
 
 ```bash
-node bin/orchestree.js --help
+pnpm --filter @orchestree/cli... build   # build this package and its deps
+pnpm --filter @orchestree/cli test:run   # run tests
 ```
 
-### Testing
-
-```bash
-npm test
-```
-
-## API Usage
-
-Use the CLI programmatically in your Node.js code:
-
-```javascript
-const OrchestreeCLI = require('@orchestree/cli');
-
-const cli = new OrchestreeCLI();
-
-// Access configuration
-console.log(cli.config);
-
-// Log messages
-cli.success('Operation completed');
-cli.error('Something went wrong');
-
-// Run commands
-await cli.run(['auth', 'login']);
-```
-
-## TypeScript Support
-
-Full TypeScript definitions are included:
-
-```typescript
-import OrchestreeCLI, { CommandContext } from '@orchestree/cli';
-
-const cli = new OrchestreeCLI();
-
-// Types are fully supported
-const parsed = cli.parseArgs(['auth', 'login']);
-console.log(parsed.command); // 'auth'
-```
-
-## License
-
-MIT - See LICENSE file for details
-
-## Support
-
-- 📚 [Documentation](https://orchestree.ai/docs)
-- 🐛 [Report Issues](https://github.com/orchestree/orchestree/issues)
-- 💬 [Community Chat](https://discord.gg/orchestree)
-- 📧 [Email Support](mailto:support@orchestree.ai)
-
-## Contributing
-
-Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
-
----
-
-Made with ❤️ by the Orchestree Team
+See `CHANGELOG.md` for release history.

package/bin/crow.js

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+// crow — the CrowCode CLI entry. Compiled dist when built, tsx-loaded source in dev.
+
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import { existsSync } from 'node:fs';
+
+const here = dirname(fileURLToPath(import.meta.url));
+const distEntry = join(here, '..', 'dist', 'index.js');
+const srcEntry = join(here, '..', 'src', 'index.ts');
+
+if (existsSync(distEntry)) {
+  await import(distEntry);
+} else if (existsSync(srcEntry)) {
+  try {
+    const { register } = await import('node:module');
+    register('tsx/esm', new URL('.', import.meta.url));
+  } catch {
+    // tsx missing — the import below will throw an honest error.
+  }
+  await import(srcEntry);
+} else {
+  process.stderr.write(
+    'crow: neither dist/index.js nor src/index.ts found.\n' +
+      'Run `pnpm --filter @orchestree/cli build` first.\n',
+  );
+  process.exit(1);
+}

package/bin/orchestree.js

@@ -1,11 +1,8 @@
 #!/usr/bin/env node
+// Back-compat alias: `orchestree` is now `crow`. This wrapper stays for one
+// major version so existing scripts never break — it tips once, then runs
+// the exact same CLI.
 
-/**
- * Orchestree CLI Executable
- * This is the entry point when running `orchestree` command globally
- */
+process.stderr.write('Tip: `orchestree` is now `crow` — same CLI, shorter name.\n');
 
-import('../dist/index.js').catch((err) => {
-  console.error('\x1b[31m✖ Fatal Error:\x1b[0m', err.message);
-  process.exit(1);
-});
+await import('./crow.js');