75 lines
2.5 KiB
Markdown
75 lines
2.5 KiB
Markdown
# Dew Configuration
|
|
|
|
Dew is configured via a `dew.yaml` file stored in the `.project/` directory at the root of your project. Running `dew init .` will generate this file with sensible defaults.
|
|
|
|
## File Location
|
|
|
|
```text
|
|
your-project/
|
|
└── .project/
|
|
└── dew.yaml
|
|
```
|
|
|
|
Path-like values in `dew.yaml` are resolved relative to `.project/dew.yaml`
|
|
unless they are absolute (for example, paths under `dew.vault`).
|
|
|
|
Infrastructure services are not configured in `dew.yaml`; they are discovered
|
|
from `.project/infrastructure/services/*/metadata.toml`.
|
|
|
|
## Full Schema
|
|
|
|
```yaml
|
|
dew:
|
|
mcp:
|
|
host: "localhost" # Hostname the MCP server binds to
|
|
port: 8080 # Port the MCP server listens on
|
|
|
|
kanban:
|
|
prefix: "PROJ" # Short prefix used for ticket IDs (e.g. PROJ-42)
|
|
|
|
ticket_types: # The types of tickets your board supports
|
|
- id: "epic"
|
|
name: "Epic"
|
|
- id: "story"
|
|
name: "Story"
|
|
- id: "task"
|
|
name: "Task"
|
|
- id: "bug"
|
|
name: "Bug"
|
|
- id: "spike"
|
|
name: "Spike"
|
|
|
|
columns: # Ordered list of columns on your Kanban board
|
|
- id: "backlog"
|
|
name: "Backlog"
|
|
color: "blue"
|
|
- id: "doing"
|
|
name: "Doing"
|
|
color: "yellow"
|
|
- id: "done"
|
|
name: "Done"
|
|
color: "green"
|
|
```
|
|
|
|
## Reference
|
|
|
|
### `dew.mcp`
|
|
|
|
| Field | Type | Default | Description |
|
|
| ------ | ------- | ------------- | --------------------------------- |
|
|
| `host` | string | `"localhost"` | Hostname the MCP server binds to. |
|
|
| `port` | integer | `8080` | Port the MCP server listens on. |
|
|
|
|
### `dew.kanban`
|
|
|
|
| Field | Type | Description |
|
|
| -------------- | ------ | ------------------------------------------------------------------------------------------------------------ |
|
|
| `prefix` | string | Short uppercase prefix prepended to ticket IDs (e.g. `PROJ-1`). |
|
|
| `ticket_types` | list | The ticket types available on the board. Each entry requires an `id` and a `name`. |
|
|
| `columns` | list | The columns on the board, in order from left to right. Each entry requires an `id`, a `name`, and a `color`. |
|
|
|
|
#### Column colors
|
|
|
|
The following named colors are supported for column display:
|
|
|
|
`red`, `orange`, `yellow`, `green`, `blue`, `purple`, `pink`, `grey`
|