# foundary-test-1770784989

Foundary Studio: Conversational product development

## Quickstart

```bash
# Clone the repo
git clone https://git.threesix.ai/jordan/foundary-test-1770784989.git
cd foundary-test-1770784989

# Install dependencies
./scripts/install.sh

# Start local development
./scripts/dev.sh
```

## Project Structure

```
foundary-test-1770784989/
├── services/     # Go API services
├── workers/      # Background workers
├── apps/         # Frontend applications
├── cli/          # CLI tools
├── packages/     # Shared TypeScript packages
├── pkg/          # Shared Go packages
└── scripts/      # Development scripts
```

## Scripts

| Script | Description |
|--------|-------------|
| `./scripts/dev.sh` | Start local development environment |
| `./scripts/install.sh` | Install all dependencies |
| `./scripts/quality.sh` | Run quality checks on all components |
| `./scripts/discover.sh` | List all components in the monorepo |

## API Documentation

API documentation is automatically generated from OpenAPI specs and deployed to:

- **Docs**: https://docs.9d4u7q6t.threesix.ai
- **OpenAPI Spec**: Each service exposes `/openapi.json`

To regenerate docs locally:

```bash
# Start services locally
./scripts/dev.sh

# Generate Slate markdown from OpenAPI specs
./docs/scripts/generate-docs.sh http://localhost

# Preview docs (optional - requires Ruby)
cd docs && bundle install && bundle exec middleman serve
```

Documentation is automatically rebuilt on every push to `main`.

## Adding Components

Components are added via the rdev API:

```bash
# Add a Go service
curl -X POST $RDEV_API_URL/projects/foundary-test-1770784989/components \
  -H "X-API-Key: $RDEV_API_KEY" \
  -d '{"type": "service", "name": "auth-api"}'

# Add a React app
curl -X POST $RDEV_API_URL/projects/foundary-test-1770784989/components \
  -H "X-API-Key: $RDEV_API_KEY" \
  -d '{"type": "app", "name": "dashboard", "template": "app-react"}'
```