@devrouter/cli 0.0.24 → 0.0.26

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devrouter/cli",
-  "version": "0.0.24",
+  "version": "0.0.26",
   "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,11 +43,16 @@
     "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",
-    "bench:startup": "zsh -lc 'set -euo pipefail; echo \"=== dev --help (x5) ===\"; for i in {1..5}; do /usr/bin/time -p node dist/dev.js --help >/dev/null; done; echo \"=== dev app add --help (x5) ===\"; for i in {1..5}; do /usr/bin/time -p node dist/dev.js app add --help >/dev/null; done; echo \"=== dev status --json (x3, best effort) ===\"; for i in {1..3}; do /usr/bin/time -p node dist/dev.js status --json >/dev/null || true; done'",
+    "bench:startup": "zsh -lc 'set -euo pipefail; echo \"=== dev --help (x5) ===\"; for i in {1..5}; do /usr/bin/time -p node dist/devrouter.js --help >/dev/null; done; echo \"=== dev app add --help (x5) ===\"; for i in {1..5}; do /usr/bin/time -p node dist/devrouter.js app add --help >/dev/null; done; echo \"=== dev status --json (x3, best effort) ===\"; for i in {1..3}; do /usr/bin/time -p node dist/devrouter.js status --json >/dev/null || true; done'",
     "typecheck": "tsc --noEmit",
     "bootstrap": "pnpm install && pnpm install:local",
     "install:local": "pnpm build && ./scripts/install-local.sh",

package/upgrade-prompts/0.0.24.md

@@ -0,0 +1,10 @@
+You are upgrading a repository that uses devrouter to version 0.0.24.
+
+Changes in this release:
+- Automatically inject `DEVCONTAINER_COMPOSE_OVERLAY` environment variable to workspace execution contexts when active.
+
+Task:
+1) Bump `.devrouter.yml` `devrouter.version` to `0.0.24`.
+
+Validation:
+- `devrouter -V --repo <repo>` shows `0.0.24` as the local repo version.

package/upgrade-prompts/0.0.25.md

@@ -0,0 +1,20 @@
+You are upgrading a repository that uses devrouter to version 0.0.25.
+
+Changes in this release:
+- Removed all Linear workflow integrations, templates, and flags (`--with-linear`).
+- Added real-time outdated CLI detection. When a repository config `.devrouter.yml` requires a version newer than the installed CLI version, devrouter prints a stderr warning on config load.
+- Added a diagnostic check `repo.cli-outdated` in `devrouter doctor` to flag when the installed CLI is older than the required version.
+- Cleaned up leftover `dev` / `dist/dev.js` CLI commands references in validation scripts and workspace examples.
+
+Task:
+1) Bump `.devrouter.yml` `devrouter.version` to `0.0.25`.
+2) Refresh discoverability artifacts with `devrouter repo agents --repo <repo>`.
+
+Validation:
+- `devrouter -V --repo <repo>` shows `0.0.25` as the local repo version.
+- `devrouter doctor --repo <repo>` runs successfully and reports no `repo.cli-outdated` errors if the installed CLI version is compatible.
+
+Report:
+- `.devrouter.yml` `devrouter.version` before and after
+- setup, doctor, and devcontainer verification results
+- unresolved risks or manual follow-ups

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