83 lines
3.3 KiB
Markdown
83 lines
3.3 KiB
Markdown
[← Back to AIPass](../../../README.md)
|
|
|
|
# DevPulse
|
|
|
|
> Orchestration hub for AIPass. Plans, coordinates, dispatches. Never the builder.
|
|
|
|
DevPulse is the central coordination branch. It does not ship features of its own — it works with the user on design, dispatches real work to branch specialists, tracks plans and memory, and keeps the system moving. If a task belongs to another branch, DevPulse emails that branch and waits for the reply.
|
|
|
|
## Start here
|
|
|
|
| You want to | Read |
|
|
|---|---|
|
|
| Install, update, uninstall, or troubleshoot | [SETUP.md](SETUP.md) |
|
|
| What's happening right now | [STATUS.local.md](STATUS.local.md) |
|
|
| Identity, memory, session history | [`.trinity/`](.trinity/) |
|
|
| Diagnostic scanners | [`tools/`](tools/) |
|
|
| Branch health audits | [`branch_audits _only/`](branch_audits%20_only/) |
|
|
| Active plans | `drone @flow list open` |
|
|
|
|
## Invoke
|
|
|
|
```bash
|
|
cd src/aipass/devpulse
|
|
claude
|
|
```
|
|
|
|
Say "hi" and DevPulse picks up where the last session left off.
|
|
|
|
## Role in one line
|
|
|
|
Designer, orchestrator, and light builder — the user's primary AI collaborator. Builds its own things directly (modules, plans, memories, design docs). Ventures into other branches to investigate, debug, run tests, and fix small bugs — CWD stays devpulse. Delegates heavy multi-file builds and full branch rebuilds to sub-agents via dispatch.
|
|
|
|
## Architecture
|
|
|
|
```
|
|
src/aipass/devpulse/
|
|
├── .trinity/ # Identity & memory
|
|
├── .aipass/ # Branch prompt
|
|
├── .ai_mail.local/ # Mailbox
|
|
├── apps/
|
|
│ ├── devpulse.py # Entry point — auto-discovers modules
|
|
│ ├── modules/
|
|
│ │ ├── feedback.py # Personal feedback mailbox routing
|
|
│ │ └── watchdog.py # Directed wake system routing
|
|
│ └── handlers/
|
|
│ ├── feedback/ # Feedback inbox, compose, storage
|
|
│ └── watchdog/ # Agent, timer, schedule, registry handlers
|
|
├── tests/ # 130+ tests (watchdog + feedback)
|
|
├── docs/ # Transition notes, research
|
|
├── docs.local/ # Local-only docs (gitignored)
|
|
└── STATUS.local.md # Current work beacon
|
|
```
|
|
|
|
## Commands
|
|
|
|
Devpulse commands are accessed via `drone @devpulse <command>`:
|
|
|
|
- `watchdog agent @target` — monitor a dispatched agent until it finishes
|
|
- `watchdog timer <seconds>` — simple countdown timer
|
|
- `watchdog schedule <HH:MM>` — wait until a specific time
|
|
- `watchdog status` — show active watchdogs
|
|
- `watchdog cancel <id>` — cancel a running watchdog
|
|
- `watchdog list` — list all watchdog entries
|
|
- `feedback` — inbox summary
|
|
- `feedback inbox` — list all feedback messages
|
|
- `feedback view <id>` — read a message
|
|
- `feedback reply <id> "msg"` — reply to sender
|
|
- `feedback send "subject" "body"` — receive feedback from another agent
|
|
|
|
## Integration Points
|
|
|
|
### Depends On
|
|
drone (routing), prax (logging), cli (display), ai_mail (dispatch), seedgo (audits), flow (plans)
|
|
|
|
### Provides To
|
|
All branches via dispatch orchestration. Watchdog monitoring for any dispatched agent. Feedback channel for cross-project communication.
|
|
|
|
*Last updated: 2026-04-22*
|
|
|
|
---
|
|
|
|
[← Back to AIPass](../../../README.md)
|