Implement the v3 output schemas: structured why + doctor reports

.github/workflows/pages.yml

@@ -7,7 +7,7 @@ jobs:
     runs-on: ubuntu-slim
     environment: { name: github-pages, url: "${{ steps.deployment.outputs.page_url }}" }
     steps: [
-      { uses: actions/checkout@v6, with: { sparse-checkout: schemas/*.schema.json } },
+      { uses: actions/checkout@v6, with: { sparse-checkout: schemas/*.schema.json, sparse-checkout-cone-mode: false } },
       { uses: actions/configure-pages@v5, with: { enablement: true }, id: conf },
       { uses: actions/upload-pages-artifact@v4, with: { path: . } },
       { uses: actions/deploy-pages@v4, id: deployment },

CHANGELOG.md

@@ -15,6 +15,41 @@ The format is based on [Keep a Changelog], and this project adheres to [Semantic
 - [ ] Update the `[Unreleased]` compare link to the new tag.
 - [ ] Create and push a signed `vX.Y.Z` tag from `master`.
 
+### Added
+
+- `runner doctor --json` schema **v3** (now the default for `doctor`):
+  the flat detection dump becomes a structured diagnostic inventory —
+  `invocation`/`environment`/`runner` provenance, per-`ecosystems`
+  decisions with a `confidence` grade derived from the resolution step
+  (override/manifest/lockfile → high, PATH probe → medium, legacy npm
+  fallback → low, failure → none), task `sources` as first-class objects,
+  `fqn`-keyed `tasks` with effective `resolved` commands, PATH-probed
+  `tools`, duplicate-task-name `conflicts` (which task wins, which are
+  shadowed, and why), flattened `diagnostics`, and a self-describing
+  `resolution` policy block. Implements the former `doctor.v3-draft`
+  schema; the real output validates against both the committed
+  `doctor.v3.schema.json` and the original draft. Draft shapes nothing
+  can emit yet (rich dependency edges, workspace identity, probe errors)
+  are deferred, not declared. v1/v2 remain available via
+  `--schema-version`; human output is unchanged.
+- `runner why --json` schema **v3** (now the default for `why`): the
+  report is restructured around `{task, match}` candidate pairs plus a
+  `decision` block. Each task carries a stable identity
+  (`fqn` = `root:<kind>:<name>`, `provider`, `kind` — cargo aliases are
+  now labeled `cargo-alias`), its origin (`source` file,
+  `source_pointer` key path), and resolution data (`definition`,
+  `resolved` command preview, `cwd`, sibling `aliases`,
+  `dependencies`). The `match` half exposes the exact run-time selection
+  key (`source_priority`, `depth`, `display_order`, alias-last), and
+  `decision.strategy` names the branch taken (`single-candidate`,
+  `ranked`, `filtered`, `exec-fallback`). Implements the former
+  `why.v3-draft` example, which the real output now reproduces verbatim;
+  v1/v2 stay available via `--schema-version`. `doctor` and `list`
+  remain at v2 — their v3 drafts are still under review, and they reject
+  `--schema-version 3` rather than mislabel output.
+  `schema --all` emits the committed `schemas/why.v3.schema.json`, and
+  the example validates against it.
+
 ## [0.13.0] - 2026-06-12
 
 ### Added

schemas/doctor.v1.example.json

@@ -1,6 +1,6 @@
 {
   "schema_version": 1,
-  "root": "/home/kjanat/projects/runner",
+  "root": "/path/to/project",
   "ecosystems": [
     "node",
     "rust"
@@ -14,7 +14,7 @@
       "just"
     ],
     "node_version": null,
-    "current_node": "24.14.1",
+    "current_node": "24.0.0",
     "monorepo": true
   },
   "overrides": {
@@ -33,24 +33,21 @@
       "manifest_pm": {
         "pm": "bun",
         "source": "packageManager",
-        "version": "1.3.14",
+        "version": "1.0.0",
         "on_fail": "ignore"
       },
       "path_probe": {
-        "bun": "/home/kjanat/.bun/bin/bun",
-        "npm": "/home/kjanat/.volta/bin/npm",
-        "pnpm": "/home/kjanat/.volta/bin/pnpm",
-        "yarn": "/home/kjanat/.volta/bin/yarn"
+        "bun": "/usr/local/bin/bun",
+        "npm": "/opt/volta/bin/npm",
+        "pnpm": null,
+        "yarn": "/opt/volta/bin/yarn"
       },
       "volta_shims": {
         "npm": {
-          "resolved": "/home/kjanat/.volta/tools/image/npm/11.6.2/bin/npm"
-        },
-        "pnpm": {
-          "resolved": "/home/kjanat/.volta/tools/image/packages/pnpm/bin/pnpm"
+          "resolved": "/opt/volta/tools/image/npm/10.0.0/bin/npm"
         },
         "yarn": {
-          "resolved": "/home/kjanat/.volta/tools/image/yarn/1.22.22/bin/yarn"
+          "resolved": null
         }
       }
     }

schemas/doctor.v2.example.json

@@ -1,6 +1,6 @@
 {
   "schema_version": 2,
-  "root": "/home/kjanat/projects/runner",
+  "root": "/path/to/project",
   "ecosystems": [
     "node",
     "rust"
@@ -14,7 +14,7 @@
       "just"
     ],
     "node_version": null,
-    "current_node": "24.14.1",
+    "current_node": "24.0.0",
     "monorepo": true
   },
   "overrides": {
@@ -33,24 +33,21 @@
       "manifest_pm": {
         "pm": "bun",
         "source": "packageManager",
-        "version": "1.3.14",
+        "version": "1.0.0",
         "on_fail": "ignore"
       },
       "path_probe": {
-        "bun": "/home/kjanat/.bun/bin/bun",
-        "npm": "/home/kjanat/.volta/bin/npm",
-        "pnpm": "/home/kjanat/.volta/bin/pnpm",
-        "yarn": "/home/kjanat/.volta/bin/yarn"
+        "bun": "/usr/local/bin/bun",
+        "npm": "/opt/volta/bin/npm",
+        "pnpm": null,
+        "yarn": "/opt/volta/bin/yarn"
       },
       "volta_shims": {
         "npm": {
-          "resolved": "/home/kjanat/.volta/tools/image/npm/11.6.2/bin/npm"
-        },
-        "pnpm": {
-          "resolved": "/home/kjanat/.volta/tools/image/packages/pnpm/bin/pnpm"
+          "resolved": "/opt/volta/tools/image/npm/10.0.0/bin/npm"
         },
         "yarn": {
-          "resolved": "/home/kjanat/.volta/tools/image/yarn/1.22.22/bin/yarn"
+          "resolved": null
         }
       }
     }

schemas/doctor.v2.schema.json

@@ -402,7 +402,7 @@
     }
   },
   "title": "runner doctor --json --schema-version 2",
-  "description": "JSON schema for the current v2 `runner doctor --json` document. v2 uses tool-name task source labels.",
+  "description": "JSON schema for the v2 `runner doctor --json` document. v2 uses tool-name task source labels.",
   "type": "object",
   "required": [
     "decisions",