@devrouter/cli 0.0.25 → 0.0.27

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devrouter/cli",
-  "version": "0.0.25",
+  "version": "0.0.27",
   "description": "Local dev routing CLI with shared Traefik reverse proxy",
   "author": "Roland Schlaefli",
   "homepage": "https://github.com/rschlaefli/devrouter#readme",
@@ -26,8 +26,10 @@
     "yaml": "^2.5.1"
   },
   "devDependencies": {
+    "@biomejs/biome": "2.5.3",
     "@types/dockerode": "^3.3.35",
     "@types/node": "^22.10.1",
+    "knip": "6.26.0",
     "tsup": "^8.3.5",
     "tsx": "^4.19.2",
     "typescript": "^5.7.2",
@@ -41,7 +43,12 @@
     "build": "tsup",
     "dev": "tsx src/cli.ts",
     "test": "vitest run",
+    "check": "biome check .",
+    "check:fix": "biome check --write .",
     "check:docs-policy": "./scripts/check-docs-policy.sh",
+    "format": "biome format --write .",
+    "knip": "knip",
+    "lint": "biome lint .",
     "test:watch": "vitest",
     "routing:smoke": "./scripts/smoke-routing.sh",
     "devcontainer:smoke": "./scripts/smoke-devcontainer.sh",

package/upgrade-prompts/0.0.26.md

@@ -0,0 +1,27 @@
+You are upgrading a repository that uses devrouter to version 0.0.26.
+
+Changes in this release:
+- Added `devrouter workspace ensure [path]` as the canonical command for starting or reconciling an existing linked worktree. It persists one stable identity, starts the exact worktree with DevPod, validates the runtime, and registers routes only after proof succeeds.
+- Workspace startup now requires `.devcontainer/docker-compose.devrouter.yml` and a `devcontainer.json` compose overlay selected by `DEVCONTAINER_COMPOSE_OVERLAY`. The overlay passes `WORKSPACE` and `DEVROUTER_WORKSPACE` into the app and bind-mounts `${DEVROUTER_GIT_COMMON_DIR}` to the same absolute path so linked-worktree Git commands work.
+- Workspace lifecycle now fails closed on ambiguous DevPod ownership, identity conflicts, invalid mounts/aliases, unhealthy containers, and unreachable routes. A stale existing DevPod is recreated once automatically.
+- Managed Node/pnpm/Postgres devcontainer scaffolds include the required default and devrouter overlays.
+
+Task:
+1) Bump `.devrouter.yml` `devrouter.version` to `0.0.26`.
+2) Add `.devcontainer/docker-compose.default.yml` containing `services: {}` and make `.devcontainer/devcontainer.json` select it through `${localEnv:DEVCONTAINER_COMPOSE_OVERLAY:docker-compose.default.yml}` after the base compose file.
+3) Add `.devcontainer/docker-compose.devrouter.yml` with an app-service bind mount whose source and target are both `${DEVROUTER_GIT_COMMON_DIR}`.
+4) Use `devrouter workspace ensure .` from existing linked worktrees. Keep `devrouter workspace up <branch>` for creating a new worktree and `workspace down` for teardown.
+5) Keep `trees/` ignored in each repository; new worktrees now default to `trees/<workspace>` unless `--path` is supplied.
+6) Refresh discoverability artifacts with `devrouter repo agents --repo <repo>`.
+
+Validation:
+- `devrouter -V --repo <repo>` shows `0.0.26` as the local repo version.
+- From a linked worktree, `devrouter workspace ensure .` reports the exact DevPod ready and prints its routes.
+- Inside that DevPod, `git rev-parse --is-inside-work-tree` succeeds.
+- `devrouter workspace ls --repo <repo>` shows one persisted identity and the expected route count for the exact worktree.
+
+Report:
+- `.devrouter.yml` version before and after
+- overlay and Git common-directory mount added
+- ensure/runtime/route proof results
+- unresolved risks or manual follow-ups

package/upgrade-prompts/0.0.27.md

@@ -0,0 +1,21 @@
+You are upgrading a repository that uses devrouter to version 0.0.27.
+
+Changes in this release:
+- Fixed bundled `upgrade-prompts/` discovery when the installed CLI is launched through npm's `.bin` symlink.
+- No CLI flags, configuration schema, or workspace lifecycle behavior changed from 0.0.26.
+
+Task:
+1) Bump `.devrouter.yml` `devrouter.version` to `0.0.27`.
+2) Keep the 0.0.26 worktree lifecycle integration unchanged.
+3) Refresh discoverability artifacts with `devrouter repo agents --repo <repo>`.
+
+Validation:
+- `devrouter -V --repo <repo>` shows installed and local version `0.0.27` without a missing `upgrade-prompts` error.
+- `devrouter upgrade --repo <repo>` reads the bundled prompt catalog without an error.
+- Existing `devrouter workspace ensure .` runtime and route proof still pass from a linked worktree.
+
+Report:
+- `.devrouter.yml` version before and after
+- version and upgrade command results
+- workspace ensure result
+- unresolved risks or manual follow-ups