@devrouter/cli 0.0.46 → 0.0.49

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devrouter/cli",
-  "version": "0.0.46",
+  "version": "0.0.49",
   "description": "Local dev routing CLI with shared Traefik reverse proxy",
   "author": "Roland Schlaefli",
   "homepage": "https://github.com/rschlaefli/devrouter#readme",

package/upgrade-prompts/0.0.48.md

@@ -0,0 +1,44 @@
+# Upgrade to devrouter 0.0.48
+
+Devrouter now owns deterministic Devsy agent readiness, exposes profile
+resolution to automation, and proves that Traefik loaded managed routes before
+declaring a runtime ready.
+
+1. Install `@devrouter/cli@0.0.48` on the host and bump `.devrouter.yml` to
+   `devrouter.version: 0.0.48`.
+2. When Devsy is selected, run
+   `devrouter setup --yes --workspace-runtime devsy` once. This acquires and
+   verifies the pinned official agent. An explicit `DEVSY_AGENT_BINARY` remains
+   authoritative and must match a pinned asset.
+3. Run `devrouter doctor --repo <checkout> --json` and require
+   `global.devsy-agent` to report `ready` before starting a Devsy workspace.
+   Doctor remains network-free and does not expose the agent path.
+4. Use `devrouter profile resolve --repo <checkout> --profile <selection> --json`
+   when CI or another tool needs exact apps, dependencies, readiness targets,
+   managed services, and process markers without runtime side effects. Reject
+   invalid selections and unknown report schemas instead of widening the
+   requested profile.
+5. Keep using `devrouter ensure <checkout>`. Managed startup now proves exact
+   HTTP and TCP file-provider routers through Traefik's API. A missed hot reload
+   triggers one serialized Traefik-only restart; persistent absence fails closed
+   with the missing router names.
+
+Verification:
+
+- Run `devrouter -V --repo <checkout>` and confirm the installed CLI and local
+  repository report `0.0.48`.
+- Run `devrouter doctor --repo <checkout> --json` and require zero errors plus
+  `global.devsy-agent: ready` when Devsy is selected.
+- Run `devrouter profile resolve --repo <checkout> --profile <selection> --json`
+  with no workspace running and verify the schema-versioned exact resource set.
+- Start one safe representative profile with `devrouter ensure`, verify its
+  expected routes and zero profile drift, then stop that exact checkout and
+  require zero remaining routes.
+
+Report template:
+
+- CLI/config version: `0.0.48`
+- Devsy agent readiness: `<ready, not selected, or details>`
+- Profile resolution: `<passed or details>`
+- Representative route proof and stop: `<passed, deferred, or details>`
+- Remaining blockers: `<none or details>`

package/upgrade-prompts/0.0.49.md

@@ -0,0 +1,26 @@
+# Upgrade to devrouter 0.0.49
+
+Devrouter now checks a bounded 1,000-router view from both Traefik router APIs
+when proving managed routes. This prevents Traefik's default 100-entry page
+from hiding a valid route in a large shared installation.
+
+1. Install `@devrouter/cli@0.0.49` on the host and bump `.devrouter.yml` to
+   `devrouter.version: 0.0.49`.
+2. Keep using `devrouter ensure <checkout>`. Route naming, publication, and
+   restart-once recovery are unchanged.
+3. If an expected router is absent from a full 1,000-entry API response,
+   Devrouter intentionally fails closed because the API view may be incomplete.
+
+Verification:
+
+- Run `devrouter -V --repo <checkout>` and confirm the installed CLI and local
+  repository report `0.0.49`.
+- Start one safe representative managed profile with `devrouter ensure`, verify
+  its expected routes and zero profile drift, then stop that exact checkout and
+  require zero remaining routes.
+
+Report template:
+
+- CLI/config version: `0.0.49`
+- Representative route proof and stop: `<passed, deferred, or details>`
+- Remaining blockers: `<none or details>`