@snarkipus/opencode-beads 0.9.0 → 0.9.1
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 +18 -5
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -20,7 +20,7 @@ Add the version-pinned plugin to your OpenCode config (`~/.config/opencode/openc
|
|
|
20
20
|
|
|
21
21
|
```json
|
|
22
22
|
{
|
|
23
|
-
"plugin": ["@snarkipus/opencode-beads@0.9.
|
|
23
|
+
"plugin": ["@snarkipus/opencode-beads@0.9.1"]
|
|
24
24
|
}
|
|
25
25
|
```
|
|
26
26
|
|
|
@@ -37,13 +37,26 @@ Skip `git init` when the project is already a Git worktree. `bd init` performs t
|
|
|
37
37
|
|
|
38
38
|
### Upgrading from 0.8.0
|
|
39
39
|
|
|
40
|
-
Version 0.8.0 installed a fork-managed skill under `.opencode/skills/beads`. Remove that old managed skill with the version-pinned 0.8.0 CLI before changing the plugin pin to 0.9.
|
|
40
|
+
Version 0.8.0 installed a fork-managed skill under `.opencode/skills/beads`. Remove that old managed skill with the version-pinned 0.8.0 CLI before changing the plugin pin to 0.9.1:
|
|
41
41
|
|
|
42
42
|
```bash
|
|
43
43
|
bunx @snarkipus/opencode-beads@0.8.0 remove
|
|
44
44
|
```
|
|
45
45
|
|
|
46
|
-
If the old skill was installed globally, append `--global` to that exact command.
|
|
46
|
+
If the old skill was installed globally, append `--global` to that exact command. Do not substitute 0.9.1 in the removal command: the companion CLI no longer exists in 0.9.1.
|
|
47
|
+
|
|
48
|
+
For a repository that has not been initialized with Beads, run `bd init`; it creates the canonical shared skill as part of normal initialization. For an already-initialized repository that is missing the skill, upstream currently has no skill-only setup command. Do not run `bd setup codex` as a substitute because it also installs Codex hooks and generated instructions. Instead, initialize a temporary Git repository with the same `bd` version and copy only its canonical skill directory into the target repository:
|
|
49
|
+
|
|
50
|
+
```bash
|
|
51
|
+
scratch="$(mktemp -d)"
|
|
52
|
+
git -C "$scratch" init
|
|
53
|
+
(cd "$scratch" && bd init)
|
|
54
|
+
mkdir -p .agents/skills
|
|
55
|
+
cp -R "$scratch/.agents/skills/beads" .agents/skills/beads
|
|
56
|
+
rm -rf "$scratch"
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
This bounded migration copies only `.agents/skills/beads`; it does not copy `.codex` artifacts or generated instruction files.
|
|
47
60
|
|
|
48
61
|
## Features
|
|
49
62
|
|
|
@@ -94,8 +107,8 @@ The vendor manifest, task agent, and every recorded command file are required pa
|
|
|
94
107
|
## Troubleshooting
|
|
95
108
|
|
|
96
109
|
- **No Beads context:** Run `bd prime` in the project. Install `bd` if the command is missing, or run `bd init` if the project has no Beads workspace.
|
|
97
|
-
- **Canonical skill is missing:**
|
|
98
|
-
- **Upgrading from 0.8.0:** Run the exact version-pinned removal command in the upgrade section before updating the plugin pin, then use
|
|
110
|
+
- **Canonical skill is missing:** For a repository without a Beads workspace, run `bd init`. For an already-initialized repository, use the bounded manual-copy migration above; upstream currently has no skill-only setup command, and `bd setup codex` installs additional Codex integration artifacts.
|
|
111
|
+
- **Upgrading from 0.8.0:** Run the exact version-pinned removal command in the upgrade section before updating the plugin pin, then use the appropriate fresh-initialization or existing-workspace path above.
|
|
99
112
|
- **Vendor artifact initialization error:** Reinstall the package. If using a source checkout, rerun the vendor sync and validation scripts; the error names the missing or malformed manifest, command, or task-agent file.
|
|
100
113
|
- **Unexpected command or agent definition:** Check the OpenCode configuration for a colliding `beads:*` or `beads-task-agent` entry. Your explicit configuration wins on an exact name collision; OpenCode logs a rate-limited warning naming the collision.
|
|
101
114
|
- **A regular subagent has no Beads context:** This is intentional. Delegate Beads work to `beads-task-agent`, or run the required `bd` command explicitly.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@snarkipus/opencode-beads",
|
|
3
|
-
"version": "0.9.
|
|
3
|
+
"version": "0.9.1",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"description": "A maintained OpenCode integration for the Beads issue tracker, including context injection, vendored workflows, and a task agent.",
|
|
6
6
|
"author": "Matt Jackson",
|