millionco
diff --git a/‎.changeset/config.json‎
Lines changed: 1 addition & 1 deletion b/‎.changeset/config.json‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎.github/workflows/release.yml‎
Lines changed: 56 additions & 0 deletions b/‎.github/workflows/release.yml‎
Lines changed: 56 additions & 0 deletions
diff --git a/‎package.json‎
Lines changed: 1 addition & 0 deletions b/‎package.json‎
Lines changed: 1 addition & 0 deletions
diff --git a/‎packages/react-doctor/README.md‎
Lines changed: 49 additions & 0 deletions b/‎packages/react-doctor/README.md‎
Lines changed: 49 additions & 0 deletions
diff --git a/‎packages/react-doctor/package.json‎
Lines changed: 8 additions & 1 deletion b/‎packages/react-doctor/package.json‎
Lines changed: 8 additions & 1 deletion
@@ -1,6 +1,6 @@
 {
   "$schema": "https://unpkg.com/@changesets/config@3.1.2/schema.json",
-  "changelog": "@changesets/cli/changelog",
+  "changelog": ["@changesets/changelog-github", { "repo": "millionco/react-doctor" }],
   "commit": false,
   "fixed": [],
   "linked": [],
 
@@ -0,0 +1,56 @@
+name: Release
+
+on:
+  push:
+    branches: [main]
+
+concurrency: ${{ github.workflow }}-${{ github.ref }}
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          cache: pnpm
+          registry-url: https://registry.npmjs.org
+
+      - run: pnpm install --frozen-lockfile
+
+      - name: Create Release PR or Publish
+        id: changesets
+        uses: changesets/action@v1
+        with:
+          publish: pnpm release
+          title: "chore: version packages"
+          commit: "chore: version packages"
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Create GitHub Releases
+        if: steps.changesets.outputs.published == 'true'
+        run: |
+          for pkg in $(echo '${{ steps.changesets.outputs.publishedPackages }}' | jq -r '.[] | @base64'); do
+            NAME=$(echo "$pkg" | base64 -d | jq -r '.name')
+            VERSION=$(echo "$pkg" | base64 -d | jq -r '.version')
+            TAG="${NAME}@${VERSION}"
+            if [ "$NAME" = "react-doctor" ]; then
+              TAG="v${VERSION}"
+            fi
+            gh release create "$TAG" \
+              --title "$TAG" \
+              --generate-notes \
+              --target main || true
+          done
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -26,6 +26,7 @@
     "leaderboard:update": "node --experimental-strip-types --no-warnings scripts/update-leaderboard.ts"
   },
   "devDependencies": {
+    "@changesets/changelog-github": "^0.7.0",
     "@changesets/cli": "^2.31.0",
     "@types/node": "^25.6.0",
     "@voidzero-dev/vite-plus-core": "^0.1.15",
 
@@ -234,15 +234,64 @@ When a suppression isn't working, `--explain <file:line>` (or its alias `--why <
 | `failOn`                   | `"error" \| "warning" \| "none"` | `"none"` |
 | `customRulesOnly`          | `boolean`                        | `false`  |
 | `share`                    | `boolean`                        | `true`   |
+| `offline`                  | `boolean`                        | `false`  |
 | `textComponents`           | `string[]`                       | `[]`     |
 | `rawTextWrapperComponents` | `string[]`                       | `[]`     |
 | `respectInlineDisables`    | `boolean`                        | `true`   |
 | `adoptExistingLintConfig`  | `boolean`                        | `true`   |
+| `ignore.tags`              | `string[]`                       | `[]`     |
+| `entryFiles`               | `string[]`                       | `[]`     |
 
 `textComponents` is the broad escape hatch for `rn-no-raw-text` — list components that themselves behave like React Native's `<Text>` (custom `Typography`, `NativeTabs.Trigger.Label`, etc.) and the rule will treat them as text containers regardless of what their children look like.
 
 `rawTextWrapperComponents` is the narrower option for components that are not text elements but safely route string-only children through an internal `<Text>` (e.g. `heroui-native`'s `Button`, which stringifies its children and renders them through a `ButtonLabel`). Listed wrappers suppress `rn-no-raw-text` only when their children are entirely stringifiable. A wrapper with mixed children — e.g. `<Button>Save<Icon /></Button>` — still reports because the wrapper can't safely route raw text alongside a sibling JSX element.
 
+`ignore.tags` suppresses entire categories of rules by tag. For example, `"tags": ["design"]` disables all opinionated design rules (gradient text, pure black backgrounds, side tab borders, default Tailwind palettes). Available tags: `"design"`.
+
+`entryFiles` tells the dead-code detector about files that are executed directly but not imported (test runner configs, eval scripts, CLI entry points). These are forwarded to [knip](https://knip.dev) as additional entry points. Example: `"entryFiles": ["scripts/*.ts", "evalite.config.ts"]`. If your project already has a `knip.json`, those entry points are respected automatically.
+
+`offline` skips the score API call and calculates the score locally. Automatically enabled in CI environments (GitHub Actions, GitLab CI, CircleCI). Set `true` in config to always score locally.
+
+## Scoring
+
+The health score formula: `100 - (unique_error_rules x 1.5) - (unique_warning_rules x 0.75)`.
+
+Key details:
+
+- The score counts **unique rules triggered**, not total instances. Fixing 49 of 50 `no-barrel-import` violations does not change the score; fixing all 50 removes the 0.75 penalty for that rule.
+- Error-severity rules cost 1.5 points each. Warning-severity rules cost 0.75 points each.
+- Category breakdowns shown in the output are for display only and do not weight the score.
+- Run `--verbose` to see which exact rules contributed to the score and how the penalty was computed.
+
+Score labels: 75+ is **Great**, 50 to 74 is **Needs work**, under 50 is **Critical**.
+
+Scores may decrease across releases as new rules are added. Each new rule that fires in your codebase introduces an additional penalty. This is expected — it means the tool is catching more issues, not that your code got worse. Pin to a specific react-doctor version in CI if you need stable scores across upgrades.
+
+## Diff and staged modes
+
+React Doctor can scan only changed files instead of the full project:
+
+- **`--diff [base]`** scans files changed vs a base branch. Auto-detects `main`/`master`, or pass an explicit branch: `--diff develop`. Also available as a config key: `"diff": true` or `"diff": "develop"`.
+- **`--staged`** scans only files in the git staging area (index). Designed for pre-commit hooks — materializes staged file contents into a temp directory so the scan reflects exactly what will be committed.
+- **`--full`** forces a full scan, overriding any `diff` value in config or CLI.
+
+When on a feature branch without explicit flags, you'll be prompted: "Only scan changed files?" This prompt is suppressed in CI, `--json` mode, and non-interactive environments.
+
+`--staged` and `--diff` cannot be combined. Both modes skip dead-code detection (knip needs the full project to detect unused files).
+
+## Agent and CI integration
+
+React Doctor detects 50+ coding agents (Claude Code, Cursor, Codex, OpenCode, Windsurf, and more) and adapts its behavior automatically:
+
+- **Install for agents**: `npx react-doctor@latest install` writes agent-specific rule files (SKILL.md, AGENTS.md, .cursorrules) into your project so agents learn React best practices.
+- **JSON output**: `--json` produces a structured `JsonReport` on stdout. Errors still produce a valid JSON document with `ok: false`. Use `--json-compact` for minimal whitespace.
+- **Score-only output**: `--score` outputs just the numeric score (0-100), useful for threshold checks in agent loops.
+- **GitHub Actions annotations**: `--annotations` emits `::error` / `::warning` format for inline PR annotations.
+- **Exit codes**: `--fail-on error` (default) exits non-zero when error-severity diagnostics are found. Use `--fail-on warning` or `--fail-on none` to tune CI gating.
+- **Programmatic API**: `import { diagnose } from "react-doctor/api"` for direct integration in scripts and automation.
+
+In CI environments, prompts are automatically skipped and scoring runs locally (offline mode).
+
 ## Node.js API
 
 ```js
 
@@ -55,16 +55,23 @@
     "./eslint-plugin": {
       "types": "./dist/eslint-plugin.d.ts",
       "default": "./dist/eslint-plugin.js"
+    },
+    "./browser-poc": {
+      "types": "./dist/browser-poc.d.ts",
+      "default": "./dist/browser-poc.js"
     }
   },
   "scripts": {
     "dev": "vp pack --watch",
-    "build": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\" && NODE_ENV=production vp pack",
+    "build": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\" && NODE_ENV=production vp pack && esbuild src/browser-poc.ts --bundle --format=iife --global-name=ReactDoctorBrowserPoc --platform=browser --target=es2022 --loader:.wasm=binary --outfile=dist/browser-poc.global.js",
+    "poc:browser": "vite --host 127.0.0.1",
     "typecheck": "tsc --noEmit",
     "test": "vp test run"
   },
   "dependencies": {
+    "@oxc-parser/wasm": "^0.60.0",
     "agent-install": "0.0.5",
+    "bippy": "^0.5.39",
     "commander": "^14.0.3",
     "knip": "^6.10.0",
     "ora": "^9.4.0",
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"$schema": "https://unpkg.com/@changesets/config@3.1.2/schema.json",`
`3`		`- "changelog": "@changesets/cli/changelog",`
	`3`	`+ "changelog": ["@changesets/changelog-github", { "repo": "millionco/react-doctor" }],`
`4`	`4`	`"commit": false,`
`5`	`5`	`"fixed": [],`
`6`	`6`	`"linked": [],`