@naxodev/apnea 0.1.0 → 0.2.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 +8 -10
- package/dist/cli.js +552 -530
- package/docs/adr/0005-harness-profiles.md +1 -1
- package/docs/adr/0010-package-split.md +1 -1
- package/docs/protocol/config.md +7 -22
- package/docs/protocol/manual-gate.md +1 -1
- package/docs/protocol/overview.md +1 -1
- package/extension/domain/herdr.ts +0 -86
- package/extension/domain/paths.ts +1 -2
- package/extension/domain/setup.ts +0 -20
- package/extension/domain/types.ts +0 -9
- package/extension/domain/verify-commands.ts +200 -108
- package/extension/errors.ts +1 -1
- package/extension/schema/config.ts +31 -17
- package/extension/schema/state.ts +16 -3
- package/extension/services/herdr.ts +5 -161
- package/extension/services/vcs.ts +393 -21
- package/extension/workflows/commit.ts +8 -5
- package/extension/workflows/dispatch.ts +60 -177
- package/extension/workflows/setup.ts +2 -109
- package/extension/workflows/start.ts +0 -1
- package/extension/workflows/wait.ts +1 -57
- package/package.json +1 -2
- package/schemas/config.schema.json +6 -6
- package/schemas/state.schema.json +5 -1
- package/herdr-plugin/herdr-plugin.toml +0 -15
- package/herdr-plugin/scripts/run-task.sh +0 -8
package/README.md
CHANGED
|
@@ -20,8 +20,7 @@ only rebinds roles to profile names that already exist.
|
|
|
20
20
|
`dist/cli.js` with a `#!/usr/bin/env bun` shebang, and npm does not enforce the `engines.bun`
|
|
21
21
|
key. If you install `@naxodev/apnea` globally with only `node` on `PATH`, the `apnea` command
|
|
22
22
|
will fail on first invocation — this is the most likely first-run failure for a new user.
|
|
23
|
-
- **herdr**, for pane
|
|
24
|
-
**herdr ≥ 0.7.4** plus the linked plugin (see [`docs/protocol/config.md`](docs/protocol/config.md)).
|
|
23
|
+
- **herdr**, for reusable interactive pane dispatch.
|
|
25
24
|
- **jj or git.** Per [ADR 0007](docs/adr/0007-jj-first-commits.md), if neither is present
|
|
26
25
|
auto-commit is refused.
|
|
27
26
|
- **At least one agent CLI** — `pi`, `claude`, or `codex`.
|
|
@@ -53,8 +52,7 @@ Optionally put it on `PATH`, e.g. `ln -s "$(pwd)/dist/cli.js" ~/.local/bin/apnea
|
|
|
53
52
|
|
|
54
53
|
## Sixty-second quickstart
|
|
55
54
|
|
|
56
|
-
1. `apnea setup` — writes global profiles to `~/.config/apnea/config.json
|
|
57
|
-
`apnea` plugin, if herdr is present).
|
|
55
|
+
1. `apnea setup` — writes global profiles to `~/.config/apnea/config.json`.
|
|
58
56
|
2. `apnea start "<goal>"` — starts a run against your working copy.
|
|
59
57
|
3. `apnea status` — a read-only snapshot of where the run stands and what to call next.
|
|
60
58
|
|
|
@@ -109,14 +107,14 @@ See [`docs/protocol/config.md`](docs/protocol/config.md) for the budget-floor ar
|
|
|
109
107
|
### Setup flags
|
|
110
108
|
|
|
111
109
|
```text
|
|
112
|
-
/apnea setup # ~/.config/apnea/config.json from PATH
|
|
110
|
+
/apnea setup # ~/.config/apnea/config.json from PATH
|
|
113
111
|
/apnea setup --project # also .apnea/config.json role→profile only
|
|
114
112
|
/apnea setup --agents-md # also write/refresh an AGENTS.md loop primer at the repo root
|
|
115
113
|
```
|
|
116
114
|
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
115
|
+
After upgrading from a version with floating panes, old copied
|
|
116
|
+
`~/.config/apnea/herdr-plugin` files are inert. Apnea does not unlink or delete them; remove that
|
|
117
|
+
directory manually if you no longer need it.
|
|
120
118
|
|
|
121
119
|
The `@naxodev/pi-apnea` adapter applies Pi-specific role launch behavior. The core package remains
|
|
122
120
|
host-neutral.
|
|
@@ -129,8 +127,8 @@ UI in v1.**
|
|
|
129
127
|
**What you can rely on:** the loop, the artifact contract, and the CLI are implemented, and the
|
|
130
128
|
extension suite is green — CI runs it on every pull request.
|
|
131
129
|
|
|
132
|
-
**What may still change:** the command surface and config shape may move before `1.0`.
|
|
133
|
-
|
|
130
|
+
**What may still change:** the command surface and config shape may move before `1.0`. Breaking
|
|
131
|
+
changes will land in minor bumps, not patches.
|
|
134
132
|
|
|
135
133
|
**Non-goals for v1:** worktrees, parallel coders, push/PR automation, memory store, native
|
|
136
134
|
CLAUDE.md injection, force-approve, config UI.
|