fledge 0.11.1

Dev-lifecycle CLI — scaffolding, tasks, lanes, plugins, and more.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79

---
module: ask
version: 2
status: active
files:
  - src/ask.rs

db_tables: []
depends_on: []
---

# Ask

## Purpose

Ask questions about your codebase using AI. Sends the question to Claude CLI which has access to the project context, and streams the answer back.

## Public API

### Exported Functions

| Export | Description |
|--------|-------------|
| `run` | Entry point for the ask command |
| `AskOptions` | Options struct with the question text and json flag |

### Structs & Enums

| Type | Description |
|------|-------------|
| `AskOptions` | `{ question: String, json: bool }` |

### Functions

| Function | Signature | Description |
|----------|-----------|-------------|
| `run` | `(AskOptions) -> Result<()>` | Sends question to Claude CLI and displays answer |

## Invariants

1. Requires Claude CLI (`claude`) to be installed and authenticated
2. Question is joined from multiple args (no quotes required)
3. Claude CLI runs in the current project directory for context
4. `--json` outputs structured JSON response

## Behavioral Examples

### ask — simple question
```
$ fledge ask how does template rendering work
● Thinking...

[AI response streamed here]
```

### ask — no question
```
$ fledge ask
error: Please provide a question. Usage: fledge ask <question>
```

## Error Cases

| Error | When | Behavior |
|-------|------|----------|
| Claude CLI not installed | `claude --version` fails | Bail with install instructions |
| No question provided | Empty args | Bail with usage hint |
| Claude CLI error | Non-zero exit | Bail with error |

## Dependencies

- Claude CLI — AI inference (external dependency)

## Change Log

| Version | Date | Changes |
|---------|------|---------|
| 2 | 2026-04-21 | Add json field to AskOptions |
| 1 | 2026-04-19 | Initial spec |