@coopcli/specplan 5.2.0 → 5.3.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.
Files changed (2) hide show
  1. package/README.md +11 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -27,6 +27,17 @@ specplan login [--profile] [--web-url] # CoopCLI account (browser OAuth, ~/.c
27
27
 
28
28
  Chat and generation need Anthropic credentials on the machine — `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, or the Anthropic CLI's login profile (`ant auth login`). Planning works without them.
29
29
 
30
+ ## Troubleshooting
31
+
32
+ | Symptom | Fix |
33
+ |---|---|
34
+ | Startup warning "No Anthropic credentials detected" | Set `ANTHROPIC_API_KEY` or run `ant auth login`, then restart — planning works without, chat/generation need one |
35
+ | Generation fails with the `openspec validate --strict` report | The model's output didn't validate; hit Generate again (the failed output is tool-owned, so a rerun regenerates freely) |
36
+ | Regenerate says "metadata only, .md files untouched" | The change body was edited outside specplan (or predates it) — that's the hand-edit guard working. Delete the body files if you want a fresh full emit |
37
+ | A spec card is missing after `openspec archive` | Archived change dirs (`changes/archive/`) deliberately don't land on the canvas; remove the stale node/edges from `specplan.yaml` if you archived by hand — `specplan validate` names the dangling references |
38
+ | Port already in use | Handled automatically — the server scans forward and prints the bound URL; `--port <n>` sets the start |
39
+ | `@` references don't find your files | The `@` scope is the directory you launched `specplan` from, not the plan root — launch from the repo root |
40
+
30
41
  ## Development (repo)
31
42
 
32
43
  ```bash
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@coopcli/specplan",
3
- "version": "5.2.0",
3
+ "version": "5.3.1",
4
4
  "description": "coopcli specplan — plan your project as a DAG of specs and user stories on a React Flow canvas, generate OpenSpec changes per spec card. Local-only.",
5
5
  "type": "module",
6
6
  "bin": {