devworkspace 0.2.0 → 0.2.2

package/docs/troubleshooting.md

@@ -10,7 +10,8 @@ Start with `devworkspace doctor`. Every warning/failure includes a remediation l
 | **"No DevWorkspace found"** | Run `devworkspace init` in the project root. Commands search upward from the current directory; use `--cwd <dir>` if you are elsewhere. |
 | **`setup --integrations` says approval is needed (exit 2)** | Nothing risky ran. Review with `--dry-run`, then re-run with `--yes`. Machine-level (installing the Graphify tool), user-level and registry-package steps always need it. |
 | **`PREREQUISITES_MISSING` for Graphify** | Install uv (`winget install --id astral-sh.uv`) or Python 3.10+ from python.org. On Windows the Microsoft Store `python` shortcut is not Python. Then re-run setup. |
-| **Graphify `DEGRADED`: not on PATH** | Its Claude Code hooks call `graphify` by name. Add the folder shown in the next step to PATH (or run `uv tool update-shell` / `pipx ensurepath`) and open a new terminal. |
+| **Graphify `RESTART_REQUIRED`: "on your user PATH ... started before that was set"** (Windows) | The folder is already on your persistent PATH; this terminal/VS Code started earlier and still has the old one. Close and reopen the terminal, or restart VS Code (and Claude Code). Do not add it again. |
+| **Graphify `DEGRADED`: not on PATH** | Its Claude Code hooks call `graphify` by name and it is on no PATH (on Windows: not in this terminal and not in your persistent user/machine PATH). Add the folder shown in the next step to PATH (or run `uv tool update-shell` / `pipx ensurepath`) and open a new terminal. |
 | **`RESTART_REQUIRED`** | Restart Claude Code (or run `/reload-plugins`), then `devworkspace integrations status --restarted`. |
 | **Plugin install fails with "Host key verification failed" / "Could not read from remote repository"** | Claude Code cloned the plugin over SSH and you have no GitHub SSH key. Run the documented fix yourself (it edits your global Git config): `git config --global url."https://github.com/".insteadOf git@github.com:`, then re-run setup. |
 | **Plugin or marketplace clone times out** | Slow or blocked access to github.com. Retry later; Claude Code's own timeout can be raised with `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS`. Setup resumes from what is already done. |
@@ -29,6 +30,8 @@ Start with `devworkspace doctor`. Every warning/failure includes a remediation l
 | **Windows: `EPERM` on write** | Editors, antivirus or indexers can briefly lock files; writes retry for ~2 s. If it persists, close the program holding the file. |
 | **Windows: PowerShell blocks `devworkspace.ps1`** | `npm` creates `.cmd` and `.ps1` shims. Run via `devworkspace.cmd`, `npx devworkspace`, or relax the execution policy for your user (`Set-ExecutionPolicy -Scope CurrentUser RemoteSigned`). |
 | **`.devworkspace` not appearing in Git** | The root `.gitignore` ignores it. Remove that rule; `.devworkspace/.gitignore` already excludes the machine-local parts. |
+| **`doctor` warns "package manifest(s) the last analysis did not record"** | The analysis predates nested-package detection. Run `devworkspace analyze`; commands you confirmed earlier are kept. |
+| **`doctor` warns "No ecosystem was detected" or "No verification commands"** | The analyzer found no recognised manifest or scripts. Add them, or write the commands in `.devworkspace/context/commands.json` (`"origin": "user"`, optional `"cwd": "backend"`). If the project intentionally has none, set `"acknowledgeNoVerification": true` under `settings` in `.devworkspace/project.json`. |
 | **Analysis seems incomplete** | `status`/`doctor` says "partial" when file or depth limits were hit. Raise `settings.maxFiles` in `project.json` or add `.devworkspaceignore` entries for generated folders. |
 
 Add `--debug` to any command for stack traces and debug logs (secrets are still redacted).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devworkspace",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Project-local AI engineering workspace: deterministic repository discovery, portable project knowledge, tasks, decisions and verification gates for AI coding agents.",
   "type": "module",
   "bin": {