@pyreon/cli 0.15.0 → 0.18.0

package/README.md

@@ -12,20 +12,49 @@ bun add -d @pyreon/cli
 
 ### `pyreon doctor`
 
-Scans your project for React patterns and auto-fixes them to Pyreon equivalents.
+Project-wide health audit — runs every check Pyreon ships across 5 categories
+(`correctness`, `performance`, `architecture`, `testing`, `documentation`) and
+returns a unified 0-100 score with per-category breakdown.
 
 ```bash
-pyreon doctor              # human-readable output
-pyreon doctor --fix        # auto-fix safe transforms
-pyreon doctor --json       # structured JSON output for AI tools
-pyreon doctor --ci         # exit code 1 on any error (for CI)
-
-# Test-environment audit (mock-vnode patterns — the PR #197 bug class)
-pyreon doctor --audit-tests                     # appends test-audit with minRisk=medium
-pyreon doctor --audit-tests --audit-min-risk high  # only HIGH-risk files
-pyreon doctor --json --audit-tests              # audit emitted as a second JSON blob
+pyreon doctor              # default: 8 fast gates, ~2-5s, scored output
+pyreon doctor --full       # adds 2 slow gates (audit-types, bundle-budgets)
+pyreon doctor --fix        # auto-fix what we can (lint + react-patterns)
+pyreon doctor --json       # full DoctorReport as JSON
+pyreon doctor --gha        # GitHub Actions annotation format
+pyreon doctor --ci         # exit non-zero on error findings only
+pyreon doctor --only lint,distribution         # ONLY these gates
+pyreon doctor --skip pyreon-patterns           # exclude these gates
+pyreon doctor --audit-min-risk high            # tighten test-environment audit
 ```
 
+#### Gates
+
+| Gate              | Category       | Speed | What it catches                                            |
+| ----------------- | -------------- | ----- | ---------------------------------------------------------- |
+| `react-patterns`  | correctness    | fast  | useState/useEffect/className/React imports (auto-fixable)  |
+| `pyreon-patterns` | correctness    | fast  | Pyreon-specific anti-patterns (12 detector codes)          |
+| `lint`            | varies         | fast  | All 66 `@pyreon/lint` rules                                |
+| `distribution`    | architecture   | fast  | `sideEffects` field, source-map exclusion in published pkg |
+| `doc-claims`      | documentation  | fast  | Numeric claims in docs match the source of truth           |
+| `audit-tests`     | testing        | fast  | Mock-vnode test patterns (PR #197 bug class)               |
+| `islands-audit`   | architecture   | fast  | Cross-file islands foot-guns (duplicate names, dead, ...)  |
+| `ssg-audit`       | architecture   | fast  | `_404.tsx` placement, missing `getStaticPaths`, ...        |
+| `audit-types`     | architecture   | slow  | Typed-but-unimplemented public-interface fields            |
+| `bundle-budgets`  | performance    | slow  | Gzipped main-entry size > locked budget                    |
+
+#### Score formula
+
+- Per-finding penalty: `error=10, warning=3, info=1` points.
+- Per-category subscore: `max(0, 100 - sum(penalties))` (saturates at 0).
+- Overall score: mean of *included* category subscores (skipped categories drop out).
+- Letter grades: A ≥ 90, B ≥ 80, C ≥ 70, D ≥ 60, F otherwise.
+
+#### Legacy flags (still work)
+
+`--audit-tests`, `--check-islands`, `--check-ssg` are still accepted — they map
+to `--only <gate>` shortcuts so existing CI scripts keep working.
+
 #### What it detects and suggests
 
 ```tsx
@@ -95,37 +124,47 @@ function Counter() {
   run: bunx @pyreon/cli doctor --ci
 ```
 
-#### JSON output format
+#### JSON output format (`--json`)
 
 ```json
 {
-  "passed": false,
-  "files": [
+  "score": 92,
+  "grade": "A",
+  "categories": [
+    { "category": "correctness",   "score": 87, "errors": 1, "warnings": 1, "infos": 0, "grade": "B", "included": true },
+    { "category": "performance",   "score": 100, "errors": 0, "warnings": 0, "infos": 0, "grade": "A", "included": true },
+    { "category": "architecture",  "score": 100, "errors": 0, "warnings": 0, "infos": 0, "grade": "A", "included": true },
+    { "category": "testing",       "score": 100, "errors": 0, "warnings": 0, "infos": 0, "grade": "A", "included": true },
+    { "category": "documentation", "score": 100, "errors": 0, "warnings": 0, "infos": 0, "grade": "A", "included": true }
+  ],
+  "findings": [
     {
-      "file": "src/App.tsx",
-      "diagnostics": [
-        {
-          "code": "react-import",
-          "line": 1,
-          "message": "React import detected",
-          "current": "import React from \"react\"",
-          "suggested": "import { h } from \"@pyreon/core\"",
-          "fixable": false
-        }
-      ],
-      "fixed": false
+      "category": "correctness",
+      "severity": "error",
+      "code": "react-patterns/use-state-import",
+      "gate": "react-patterns",
+      "message": "useState imported from React. Use signal() from @pyreon/reactivity.",
+      "location": { "path": "/abs/src/App.tsx", "relPath": "src/App.tsx", "line": 1, "column": 9 },
+      "fix": "import { signal } from \"@pyreon/reactivity\""
     }
   ],
-  "summary": {
-    "filesScanned": 12,
-    "filesWithIssues": 1,
-    "totalErrors": 1,
-    "totalFixable": 0,
-    "totalFixed": 0
-  }
+  "gates": [ /* one entry per gate, with meta.elapsedMs + meta.skipped */ ],
+  "totals": { "errors": 1, "warnings": 1, "infos": 0 },
+  "elapsedMs": 2300,
+  "timestamp": "2026-05-14T12:00:00.000Z"
 }
 ```
 
+#### GitHub Actions annotations (`--gha`)
+
+```text
+::notice::pyreon doctor score: 92/100 (A) — 1 errors, 1 warnings, 0 info
+::error title=react-patterns/use-state-import,file=src/App.tsx,line=1,col=9::useState imported from React. — import { signal } from "@pyreon/reactivity"
+```
+
+GitHub Actions parses these into inline PR annotations (clickable in the
+"Files changed" tab).
+
 ### `pyreon context`
 
 Generates project context for AI tools.

package/lib/analysis/index.js.html

@@ -5386,7 +5386,7 @@ var drawChart = (function (exports) {
   </script>
   <script>
     /*<!--*/
-    const data = {"version":2,"tree":{"name":"root","children":[{"name":"index.js","children":[{"name":"src","children":[{"uid":"6e84cb74-1","name":"context.ts"},{"uid":"6e84cb74-3","name":"doctor.ts"},{"uid":"6e84cb74-5","name":"index.ts"}]}]}],"isRoot":true},"nodeParts":{"6e84cb74-1":{"renderedLength":1323,"gzipLength":627,"brotliLength":0,"metaUid":"6e84cb74-0"},"6e84cb74-3":{"renderedLength":5474,"gzipLength":1928,"brotliLength":0,"metaUid":"6e84cb74-2"},"6e84cb74-5":{"renderedLength":2212,"gzipLength":875,"brotliLength":0,"metaUid":"6e84cb74-4"}},"nodeMetas":{"6e84cb74-0":{"id":"/src/context.ts","moduleParts":{"index.js":"6e84cb74-1"},"imported":[{"uid":"6e84cb74-6"},{"uid":"6e84cb74-7"},{"uid":"6e84cb74-8"}],"importedBy":[{"uid":"6e84cb74-4"}]},"6e84cb74-2":{"id":"/src/doctor.ts","moduleParts":{"index.js":"6e84cb74-3"},"imported":[{"uid":"6e84cb74-6"},{"uid":"6e84cb74-7"},{"uid":"6e84cb74-8"}],"importedBy":[{"uid":"6e84cb74-4"}]},"6e84cb74-4":{"id":"/src/index.ts","moduleParts":{"index.js":"6e84cb74-5"},"imported":[{"uid":"6e84cb74-0"},{"uid":"6e84cb74-2"}],"importedBy":[],"isEntry":true},"6e84cb74-6":{"id":"node:fs","moduleParts":{},"imported":[],"importedBy":[{"uid":"6e84cb74-0"},{"uid":"6e84cb74-2"}]},"6e84cb74-7":{"id":"node:path","moduleParts":{},"imported":[],"importedBy":[{"uid":"6e84cb74-0"},{"uid":"6e84cb74-2"}]},"6e84cb74-8":{"id":"@pyreon/compiler","moduleParts":{},"imported":[],"importedBy":[{"uid":"6e84cb74-0"},{"uid":"6e84cb74-2"}]}},"env":{"rollup":"4.23.0"},"options":{"gzip":true,"brotli":false,"sourcemap":false}};
+    const data = {"version":2,"tree":{"name":"root","children":[{"name":"index.js","children":[{"name":"src","children":[{"uid":"d41728b9-1","name":"context.ts"},{"name":"doctor","children":[{"name":"gates","children":[{"uid":"d41728b9-3","name":"audit-types.ts"},{"uid":"d41728b9-5","name":"bundle-budgets.ts"},{"uid":"d41728b9-7","name":"distribution.ts"},{"uid":"d41728b9-9","name":"doc-claims.ts"},{"uid":"d41728b9-13","name":"react-patterns.ts"},{"uid":"d41728b9-15","name":"pyreon-patterns.ts"},{"uid":"d41728b9-17","name":"audit-tests.ts"},{"uid":"d41728b9-19","name":"islands-audit.ts"},{"uid":"d41728b9-21","name":"ssg-audit.ts"},{"uid":"d41728b9-23","name":"lint.ts"}]},{"name":"utils/walk.ts","uid":"d41728b9-11"},{"uid":"d41728b9-25","name":"score.ts"},{"uid":"d41728b9-27","name":"report.ts"},{"uid":"d41728b9-29","name":"orchestrator.ts"},{"name":"render","children":[{"uid":"d41728b9-31","name":"ansi.ts"},{"uid":"d41728b9-33","name":"text.ts"},{"uid":"d41728b9-35","name":"json.ts"},{"uid":"d41728b9-37","name":"gha.ts"}]}]},{"uid":"d41728b9-39","name":"doctor.ts"},{"uid":"d41728b9-41","name":"index.ts"}]}]}],"isRoot":true},"nodeParts":{"d41728b9-1":{"renderedLength":1323,"gzipLength":627,"brotliLength":0,"metaUid":"d41728b9-0"},"d41728b9-3":{"renderedLength":3182,"gzipLength":1501,"brotliLength":0,"metaUid":"d41728b9-2"},"d41728b9-5":{"renderedLength":4737,"gzipLength":1972,"brotliLength":0,"metaUid":"d41728b9-4"},"d41728b9-7":{"renderedLength":4730,"gzipLength":1941,"brotliLength":0,"metaUid":"d41728b9-6"},"d41728b9-9":{"renderedLength":5261,"gzipLength":1912,"brotliLength":0,"metaUid":"d41728b9-8"},"d41728b9-11":{"renderedLength":1336,"gzipLength":717,"brotliLength":0,"metaUid":"d41728b9-10"},"d41728b9-13":{"renderedLength":2574,"gzipLength":1018,"brotliLength":0,"metaUid":"d41728b9-12"},"d41728b9-15":{"renderedLength":1404,"gzipLength":732,"brotliLength":0,"metaUid":"d41728b9-14"},"d41728b9-17":{"renderedLength":1824,"gzipLength":908,"brotliLength":0,"metaUid":"d41728b9-16"},"d41728b9-19":{"renderedLength":1436,"gzipLength":691,"brotliLength":0,"metaUid":"d41728b9-18"},"d41728b9-21":{"renderedLength":1218,"gzipLength":669,"brotliLength":0,"metaUid":"d41728b9-20"},"d41728b9-23":{"renderedLength":2573,"gzipLength":1113,"brotliLength":0,"metaUid":"d41728b9-22"},"d41728b9-25":{"renderedLength":1987,"gzipLength":871,"brotliLength":0,"metaUid":"d41728b9-24"},"d41728b9-27":{"renderedLength":1661,"gzipLength":842,"brotliLength":0,"metaUid":"d41728b9-26"},"d41728b9-29":{"renderedLength":3847,"gzipLength":1571,"brotliLength":0,"metaUid":"d41728b9-28"},"d41728b9-31":{"renderedLength":2087,"gzipLength":1071,"brotliLength":0,"metaUid":"d41728b9-30"},"d41728b9-33":{"renderedLength":4212,"gzipLength":1584,"brotliLength":0,"metaUid":"d41728b9-32"},"d41728b9-35":{"renderedLength":113,"gzipLength":115,"brotliLength":0,"metaUid":"d41728b9-34"},"d41728b9-37":{"renderedLength":951,"gzipLength":486,"brotliLength":0,"metaUid":"d41728b9-36"},"d41728b9-39":{"renderedLength":2210,"gzipLength":1048,"brotliLength":0,"metaUid":"d41728b9-38"},"d41728b9-41":{"renderedLength":4281,"gzipLength":1560,"brotliLength":0,"metaUid":"d41728b9-40"}},"nodeMetas":{"d41728b9-0":{"id":"/src/context.ts","moduleParts":{"index.js":"d41728b9-1"},"imported":[{"uid":"d41728b9-42"},{"uid":"d41728b9-43"},{"uid":"d41728b9-44"}],"importedBy":[{"uid":"d41728b9-40"}]},"d41728b9-2":{"id":"/src/doctor/gates/audit-types.ts","moduleParts":{"index.js":"d41728b9-3"},"imported":[{"uid":"d41728b9-47"},{"uid":"d41728b9-43"}],"importedBy":[{"uid":"d41728b9-46"}]},"d41728b9-4":{"id":"/src/doctor/gates/bundle-budgets.ts","moduleParts":{"index.js":"d41728b9-5"},"imported":[{"uid":"d41728b9-47"},{"uid":"d41728b9-43"}],"importedBy":[{"uid":"d41728b9-46"}]},"d41728b9-6":{"id":"/src/doctor/gates/distribution.ts","moduleParts":{"index.js":"d41728b9-7"},"imported":[{"uid":"d41728b9-47"},{"uid":"d41728b9-42"},{"uid":"d41728b9-43"}],"importedBy":[{"uid":"d41728b9-46"}]},"d41728b9-8":{"id":"/src/doctor/gates/doc-claims.ts","moduleParts":{"index.js":"d41728b9-9"},"imported":[{"uid":"d41728b9-42"},{"uid":"d41728b9-43"}],"importedBy":[{"uid":"d41728b9-46"}]},"d41728b9-10":{"id":"/src/doctor/utils/walk.ts","moduleParts":{"index.js":"d41728b9-11"},"imported":[{"uid":"d41728b9-42"},{"uid":"d41728b9-43"}],"importedBy":[{"uid":"d41728b9-12"},{"uid":"d41728b9-14"}]},"d41728b9-12":{"id":"/src/doctor/gates/react-patterns.ts","moduleParts":{"index.js":"d41728b9-13"},"imported":[{"uid":"d41728b9-42"},{"uid":"d41728b9-43"},{"uid":"d41728b9-44"},{"uid":"d41728b9-10"}],"importedBy":[{"uid":"d41728b9-46"}]},"d41728b9-14":{"id":"/src/doctor/gates/pyreon-patterns.ts","moduleParts":{"index.js":"d41728b9-15"},"imported":[{"uid":"d41728b9-42"},{"uid":"d41728b9-43"},{"uid":"d41728b9-44"},{"uid":"d41728b9-10"}],"importedBy":[{"uid":"d41728b9-46"}]},"d41728b9-16":{"id":"/src/doctor/gates/audit-tests.ts","moduleParts":{"index.js":"d41728b9-17"},"imported":[{"uid":"d41728b9-44"}],"importedBy":[{"uid":"d41728b9-46"}]},"d41728b9-18":{"id":"/src/doctor/gates/islands-audit.ts","moduleParts":{"index.js":"d41728b9-19"},"imported":[{"uid":"d41728b9-44"}],"importedBy":[{"uid":"d41728b9-46"}]},"d41728b9-20":{"id":"/src/doctor/gates/ssg-audit.ts","moduleParts":{"index.js":"d41728b9-21"},"imported":[{"uid":"d41728b9-44"}],"importedBy":[{"uid":"d41728b9-46"}]},"d41728b9-22":{"id":"/src/doctor/gates/lint.ts","moduleParts":{"index.js":"d41728b9-23"},"imported":[{"uid":"d41728b9-43"},{"uid":"d41728b9-48"}],"importedBy":[{"uid":"d41728b9-46"}]},"d41728b9-24":{"id":"/src/doctor/score.ts","moduleParts":{"index.js":"d41728b9-25"},"imported":[],"importedBy":[{"uid":"d41728b9-26"}]},"d41728b9-26":{"id":"/src/doctor/report.ts","moduleParts":{"index.js":"d41728b9-27"},"imported":[{"uid":"d41728b9-24"}],"importedBy":[{"uid":"d41728b9-28"}]},"d41728b9-28":{"id":"/src/doctor/orchestrator.ts","moduleParts":{"index.js":"d41728b9-29"},"imported":[{"uid":"d41728b9-46"},{"uid":"d41728b9-26"}],"importedBy":[{"uid":"d41728b9-38"}]},"d41728b9-30":{"id":"/src/doctor/render/ansi.ts","moduleParts":{"index.js":"d41728b9-31"},"imported":[],"importedBy":[{"uid":"d41728b9-45"},{"uid":"d41728b9-32"}]},"d41728b9-32":{"id":"/src/doctor/render/text.ts","moduleParts":{"index.js":"d41728b9-33"},"imported":[{"uid":"d41728b9-30"}],"importedBy":[{"uid":"d41728b9-45"}]},"d41728b9-34":{"id":"/src/doctor/render/json.ts","moduleParts":{"index.js":"d41728b9-35"},"imported":[],"importedBy":[{"uid":"d41728b9-45"}]},"d41728b9-36":{"id":"/src/doctor/render/gha.ts","moduleParts":{"index.js":"d41728b9-37"},"imported":[],"importedBy":[{"uid":"d41728b9-45"}]},"d41728b9-38":{"id":"/src/doctor.ts","moduleParts":{"index.js":"d41728b9-39"},"imported":[{"uid":"d41728b9-28"},{"uid":"d41728b9-45"}],"importedBy":[{"uid":"d41728b9-40"}]},"d41728b9-40":{"id":"/src/index.ts","moduleParts":{"index.js":"d41728b9-41"},"imported":[{"uid":"d41728b9-0"},{"uid":"d41728b9-38"}],"importedBy":[],"isEntry":true},"d41728b9-42":{"id":"node:fs","moduleParts":{},"imported":[],"importedBy":[{"uid":"d41728b9-0"},{"uid":"d41728b9-6"},{"uid":"d41728b9-8"},{"uid":"d41728b9-12"},{"uid":"d41728b9-14"},{"uid":"d41728b9-10"}]},"d41728b9-43":{"id":"node:path","moduleParts":{},"imported":[],"importedBy":[{"uid":"d41728b9-0"},{"uid":"d41728b9-2"},{"uid":"d41728b9-4"},{"uid":"d41728b9-6"},{"uid":"d41728b9-8"},{"uid":"d41728b9-12"},{"uid":"d41728b9-14"},{"uid":"d41728b9-22"},{"uid":"d41728b9-10"}]},"d41728b9-44":{"id":"@pyreon/compiler","moduleParts":{},"imported":[],"importedBy":[{"uid":"d41728b9-0"},{"uid":"d41728b9-12"},{"uid":"d41728b9-14"},{"uid":"d41728b9-16"},{"uid":"d41728b9-18"},{"uid":"d41728b9-20"}]},"d41728b9-45":{"id":"/src/doctor/render/index.ts","moduleParts":{},"imported":[{"uid":"d41728b9-32"},{"uid":"d41728b9-34"},{"uid":"d41728b9-36"},{"uid":"d41728b9-30"}],"importedBy":[{"uid":"d41728b9-38"}]},"d41728b9-46":{"id":"/src/doctor/gates/index.ts","moduleParts":{},"imported":[{"uid":"d41728b9-2"},{"uid":"d41728b9-4"},{"uid":"d41728b9-6"},{"uid":"d41728b9-8"},{"uid":"d41728b9-12"},{"uid":"d41728b9-14"},{"uid":"d41728b9-16"},{"uid":"d41728b9-18"},{"uid":"d41728b9-20"},{"uid":"d41728b9-22"}],"importedBy":[{"uid":"d41728b9-28"}]},"d41728b9-47":{"id":"node:child_process","moduleParts":{},"imported":[],"importedBy":[{"uid":"d41728b9-2"},{"uid":"d41728b9-4"},{"uid":"d41728b9-6"}]},"d41728b9-48":{"id":"@pyreon/lint","moduleParts":{},"imported":[],"importedBy":[{"uid":"d41728b9-22"}]}},"env":{"rollup":"4.23.0"},"options":{"gzip":true,"brotli":false,"sourcemap":false}};
 
     const run = () => {
       const width = window.innerWidth;