---
name: dss-services
description: Manage all DSS development services (API, admin-ui, Storybook)
arguments:
  - name: action
    description: Action to perform (start, stop, status, restart, logs)
    required: true
  - name: service
    description: Specific service (api, admin-ui, storybook) - optional
    required: false
---

# DSS Services Command

Manage all DSS development services from a single command.

## Usage

```
/dss-services <action> [service]
```

## Actions

| Action | Description |
|--------|-------------|
| start | Start all services (or specific service) |
| stop | Stop all services (or specific service) |
| status | Show status of all services |
| restart | Restart all services (or specific service) |
| logs | Show service logs |

## Services

| Service | Port | Description |
|---------|------|-------------|
| api | 6220 | FastAPI REST server |
| admin-ui | 6221 | Vite dev server |
| storybook | 6226 | Storybook design docs |

## Examples

```bash
# Start all services
/dss-services start

# Check status
/dss-services status

# Start only the API server
/dss-services start api

# Stop Storybook
/dss-services stop storybook

# View admin-ui logs
/dss-services logs admin-ui

# Restart everything
/dss-services restart
```

## Instructions for Claude

When the user runs this command:

1. Execute: `scripts/dss-services.sh <action> [service]`

2. Present the output in a clean format

3. For `status` action, show a table with service states

4. After `start`, provide clickable URLs:
   - API: http://localhost:6220
   - admin-ui: http://localhost:6221
   - Storybook: http://localhost:6226

## Service Details

### API Server (port 6220)
- FastAPI REST API
- Endpoints: projects, figma, health, config
- Command: `uvicorn apps.api.server:app --host 0.0.0.0 --port 6220 --reload`
- Log: `/tmp/dss-api.log`

### Admin UI (port 6221)
- Preact/Vite development server
- Design system management interface
- Command: `npm run dev`
- Log: `/tmp/dss-admin-ui.log`

### Storybook (port 6226)
- Component documentation
- Token visualization
- Command: `npm run storybook`
- Log: `/tmp/dss-storybook.log`

## Troubleshooting

If a service fails to start:
1. Check the log file: `/dss-services logs <service>`
2. Verify port is not in use: `lsof -i :<port>`
3. Check dependencies are installed

## Related Commands

- `/dss-init` - Full environment setup + initialization
- `/dss-reset` - Reset to clean state