@fermindi/pwn-cli 0.5.0 → 0.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +14 -10
- package/cli/backlog.js +60 -0
- package/cli/batch.js +112 -12
- package/cli/index.js +9 -31
- package/cli/inject.js +8 -32
- package/cli/status.js +1 -1
- package/cli/update.js +78 -27
- package/package.json +6 -3
- package/src/core/inject.js +41 -45
- package/src/core/state.js +0 -1
- package/src/core/validate.js +14 -1
- package/src/core/workspace.js +13 -11
- package/src/index.js +0 -1
- package/src/services/batch-runner.js +769 -0
- package/src/services/batch-service.js +185 -74
- package/src/ui/backlog-viewer.js +394 -0
- package/templates/workspace/.ai/agents/claude.md +47 -146
- package/templates/workspace/.ai/batch/tasks/.gitkeep +0 -0
- package/templates/workspace/.ai/memory/patterns.md +57 -11
- package/templates/workspace/.ai/tasks/active.md +1 -1
- package/templates/workspace/.ai/workflows/batch-task.md +43 -67
- package/templates/workspace/.claude/commands/save.md +0 -42
- package/cli/codespaces.js +0 -303
- package/cli/migrate.js +0 -466
- package/cli/mode.js +0 -206
- package/cli/notify.js +0 -135
- package/src/services/notification-service.js +0 -342
- package/templates/codespaces/devcontainer.json +0 -52
- package/templates/codespaces/setup.sh +0 -70
- package/templates/workspace/.ai/config/notifications.template.json +0 -20
- package/templates/workspace/.ai/tasks/backlog.md +0 -95
- package/templates/workspace/.claude/commands/mode.md +0 -103
- package/templates/workspace/.claude/settings.json +0 -15
|
@@ -1,95 +0,0 @@
|
|
|
1
|
-
# Backlog
|
|
2
|
-
|
|
3
|
-
This file contains prioritized future tasks not yet in active work.
|
|
4
|
-
|
|
5
|
-
## Format
|
|
6
|
-
|
|
7
|
-
Tasks are listed in priority order (highest to lowest):
|
|
8
|
-
|
|
9
|
-
```markdown
|
|
10
|
-
### US-XXX: Task Title
|
|
11
|
-
**Type:** Story | Bug | DevTask
|
|
12
|
-
**Priority:** High | Medium | Low
|
|
13
|
-
**Effort:** (T-shirt size: XS, S, M, L, XL)
|
|
14
|
-
**Description:** What needs to be done
|
|
15
|
-
**Acceptance Criteria:**
|
|
16
|
-
- [ ] Criterion 1
|
|
17
|
-
- [ ] Criterion 2
|
|
18
|
-
**Dependencies:** (Other tasks needed first)
|
|
19
|
-
**Notes:** Context, caveats, research needed
|
|
20
|
-
```
|
|
21
|
-
|
|
22
|
-
---
|
|
23
|
-
|
|
24
|
-
## Moving to Active
|
|
25
|
-
|
|
26
|
-
When starting a backlog task:
|
|
27
|
-
|
|
28
|
-
1. Create issue/ticket in your tracking system
|
|
29
|
-
2. Move to `active.md` with checkbox
|
|
30
|
-
3. Assign team member
|
|
31
|
-
4. Update priority based on sprint plan
|
|
32
|
-
5. Reference in commit messages
|
|
33
|
-
|
|
34
|
-
---
|
|
35
|
-
|
|
36
|
-
## Adding New Tasks
|
|
37
|
-
|
|
38
|
-
When new work is identified:
|
|
39
|
-
|
|
40
|
-
1. Assign next ID (US-XXX, BUG-XXX, etc.)
|
|
41
|
-
2. Add to appropriate section
|
|
42
|
-
3. Fill in all fields
|
|
43
|
-
4. Don't assign yet - wait for planning
|
|
44
|
-
5. Commit with message: `docs: add [ID] to backlog`
|
|
45
|
-
|
|
46
|
-
---
|
|
47
|
-
|
|
48
|
-
## Backlog Sections
|
|
49
|
-
|
|
50
|
-
### High Priority
|
|
51
|
-
Work that should start soon. Review weekly.
|
|
52
|
-
|
|
53
|
-
### Medium Priority
|
|
54
|
-
Important but can wait. Review biweekly.
|
|
55
|
-
|
|
56
|
-
### Low Priority
|
|
57
|
-
Nice-to-have improvements. Review monthly.
|
|
58
|
-
|
|
59
|
-
### Roadmap (Future Phases)
|
|
60
|
-
Longer-term projects for future planning.
|
|
61
|
-
|
|
62
|
-
---
|
|
63
|
-
|
|
64
|
-
## Template for New Backlog Item
|
|
65
|
-
|
|
66
|
-
```markdown
|
|
67
|
-
### US-XXX: [Title]
|
|
68
|
-
**Type:** Story | Bug | DevTask
|
|
69
|
-
**Priority:** High | Medium | Low
|
|
70
|
-
**Effort:** S/M/L
|
|
71
|
-
**Description:** (What and why)
|
|
72
|
-
**Acceptance Criteria:**
|
|
73
|
-
- [ ] (Specific, measurable outcome)
|
|
74
|
-
**Dependencies:** (Other tasks)
|
|
75
|
-
**Notes:** (Research, concerns, constraints)
|
|
76
|
-
```
|
|
77
|
-
|
|
78
|
-
---
|
|
79
|
-
|
|
80
|
-
## Management Guidelines
|
|
81
|
-
|
|
82
|
-
- Groom backlog every sprint (remove duplicates, clarify)
|
|
83
|
-
- Estimate effort using relative sizing (XS, S, M, L, XL)
|
|
84
|
-
- Link related tasks together
|
|
85
|
-
- Archive completed items with date + time spent
|
|
86
|
-
- Keep description brief - link to external tickets for details
|
|
87
|
-
|
|
88
|
-
---
|
|
89
|
-
|
|
90
|
-
## Cleanup
|
|
91
|
-
|
|
92
|
-
- Remove or update duplicates
|
|
93
|
-
- Close blocked items after 30 days of no progress
|
|
94
|
-
- Archive completed items to `completed/` section
|
|
95
|
-
- Re-estimate if context changes significantly
|
|
@@ -1,103 +0,0 @@
|
|
|
1
|
-
# /mode - PWN Session Mode
|
|
2
|
-
|
|
3
|
-
Switch between interactive and batch modes, and configure batch execution settings.
|
|
4
|
-
|
|
5
|
-
## Usage
|
|
6
|
-
|
|
7
|
-
```
|
|
8
|
-
/mode Show current mode and batch config
|
|
9
|
-
/mode interactive Switch to interactive mode
|
|
10
|
-
/mode batch Switch to batch mode
|
|
11
|
-
/mode batch [options] Switch to batch with config changes
|
|
12
|
-
```
|
|
13
|
-
|
|
14
|
-
## Options (batch mode only)
|
|
15
|
-
|
|
16
|
-
| Option | Description |
|
|
17
|
-
|--------|-------------|
|
|
18
|
-
| `--max-tasks=N` | Maximum tasks per batch (default: 5) |
|
|
19
|
-
| `--max-hours=N` | Maximum duration in hours (default: 4) |
|
|
20
|
-
| `--quality-gates=X,Y,Z` | Quality gates to run (default: typecheck,lint,test) |
|
|
21
|
-
| `--auto-commit` | Enable auto commit (default) |
|
|
22
|
-
| `--no-auto-commit` | Disable auto commit |
|
|
23
|
-
| `--auto-push` | Enable auto push to remote |
|
|
24
|
-
| `--no-auto-push` | Disable auto push (default) |
|
|
25
|
-
| `--create-pr` | Enable PR creation |
|
|
26
|
-
| `--no-create-pr` | Disable PR creation (default) |
|
|
27
|
-
| `--reset` | Reset config to defaults |
|
|
28
|
-
|
|
29
|
-
---
|
|
30
|
-
|
|
31
|
-
## Instructions
|
|
32
|
-
|
|
33
|
-
Run the `pwn mode` CLI command with the user's arguments:
|
|
34
|
-
|
|
35
|
-
```bash
|
|
36
|
-
pwn mode $ARGUMENTS
|
|
37
|
-
```
|
|
38
|
-
|
|
39
|
-
If no arguments provided, run:
|
|
40
|
-
|
|
41
|
-
```bash
|
|
42
|
-
pwn mode
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
### Examples
|
|
46
|
-
|
|
47
|
-
Show current mode:
|
|
48
|
-
```bash
|
|
49
|
-
pwn mode
|
|
50
|
-
```
|
|
51
|
-
|
|
52
|
-
Switch to batch:
|
|
53
|
-
```bash
|
|
54
|
-
pwn mode batch
|
|
55
|
-
```
|
|
56
|
-
|
|
57
|
-
Configure batch with options:
|
|
58
|
-
```bash
|
|
59
|
-
pwn mode batch --max-tasks=3 --auto-push
|
|
60
|
-
```
|
|
61
|
-
|
|
62
|
-
Switch to interactive:
|
|
63
|
-
```bash
|
|
64
|
-
pwn mode interactive
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
---
|
|
68
|
-
|
|
69
|
-
## Modes Explained
|
|
70
|
-
|
|
71
|
-
### Interactive Mode (default)
|
|
72
|
-
|
|
73
|
-
- Claude responds to user requests conversationally
|
|
74
|
-
- Asks clarifying questions when needed
|
|
75
|
-
- Commits require explicit user approval
|
|
76
|
-
- Good for exploratory work and collaboration
|
|
77
|
-
|
|
78
|
-
### Batch Mode
|
|
79
|
-
|
|
80
|
-
- Claude executes tasks autonomously from backlog
|
|
81
|
-
- Creates feature branches per task
|
|
82
|
-
- Runs quality gates before committing
|
|
83
|
-
- Continues until backlog empty or limits reached
|
|
84
|
-
- Good for repetitive tasks and overnight execution
|
|
85
|
-
|
|
86
|
-
---
|
|
87
|
-
|
|
88
|
-
## After Running
|
|
89
|
-
|
|
90
|
-
After executing the command, explain to the user:
|
|
91
|
-
|
|
92
|
-
1. **Current mode** - What mode they're now in
|
|
93
|
-
2. **Batch config** - Current batch settings (if relevant)
|
|
94
|
-
3. **Next steps** - What they can do next
|
|
95
|
-
|
|
96
|
-
For batch mode, remind them:
|
|
97
|
-
- Add tasks to `.ai/tasks/backlog.md`
|
|
98
|
-
- Run `pwn batch` to start executing tasks
|
|
99
|
-
- Use `pwn batch status` to check progress
|
|
100
|
-
|
|
101
|
-
For interactive mode, remind them:
|
|
102
|
-
- Work proceeds conversationally
|
|
103
|
-
- Use `/save` to persist session state
|