dohertj2/natsnet
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add batch commands to PortTracker CLI and migrate batch tables into porting.db

Browse Source 
Implements batch list/show/ready/next/start/complete commands with dependency
validation, migrates 42 implementation batches (2377 features, 2087 tests) from
porting_batches.db into the live tracking database, and documents the batch
workflow in AGENTS.md.
This commit is contained in:
Joseph Doherty
2026-02-27 13:02:43 -05:00
parent fe3fd7c74d
commit c5e0416793
7 changed files with 566 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

44
AGENTS.md
View File

@@ -92,6 +92,18 @@ dotnet run --project tools/NatsNet.PortTracker -- <command> --db porting.db
| `test update <id> --status <s>` | Update one test |
| `test batch-update --ids "1-10" --set-status <s> --execute` | Bulk update tests |
| `module update <id> --status <s>` | Update module status |
| `batch start <id>` | Mark batch as in-progress (validates deps) |
| `batch complete <id>` | Mark batch as complete (validates all items done) |
### Batch Querying
| Command | Purpose |
|---------|---------|
| `batch list` | List all implementation batches |
| `batch list --status <s>` | Filter batches by status |
| `batch show <id>` | Show batch details with features and tests |
| `batch ready` | List batches ready to start (deps met) |
| `batch next` | Show next recommended batch |
### Audit Verification
@@ -147,6 +159,38 @@ dotnet run --project tools/NatsNet.PortTracker -- test list --status stub --db p
dotnet run --project tools/NatsNet.PortTracker -- test list --status deferred --db porting.db
```
### Batch Workflow
Work is organized into 42 implementation batches with dependency ordering. Use batches to find and track work:
1. **Find the next batch** — `batch next` returns the lowest-priority ready batch:
```bash
dotnet run --project tools/NatsNet.PortTracker -- batch next --db porting.db
```
2. **Start it** — marks the batch as in-progress (validates dependencies are met):
```bash
dotnet run --project tools/NatsNet.PortTracker -- batch start <id> --db porting.db
```
3. **See all items** — lists every feature and test in the batch:
```bash
dotnet run --project tools/NatsNet.PortTracker -- batch show <id> --db porting.db
```
4. **Implement features first**, then write/port the tests.
5. **Complete it** — validates all features and tests are verified/complete/n_a:
```bash
dotnet run --project tools/NatsNet.PortTracker -- batch complete <id> --db porting.db
```
The system enforces dependency ordering — you cannot start a batch until all batches it depends on are complete. Use `batch ready` to see all currently available batches.
### Implementing a Feature
1. **Claim it** — mark as stub before starting: