Fdc 02 feat/analytics

.env.example

@@ -0,0 +1,2 @@
+FRAMEWORK_DOCTOR_TELEMETRY_URL=https://your-project-ref.supabase.co/functions/v1/telemetry
+FRAMEWORK_DOCTOR_TELEMETRY_KEY=replace-with-shared-secret-if-enabled

README.md

@@ -3,7 +3,7 @@
 [![npm version](https://img.shields.io/npm/v/@framework-doctor/cli.svg)](https://www.npmjs.com/package/@framework-doctor/cli)
 [![npm downloads](https://img.shields.io/npm/dm/@framework-doctor/cli.svg)](https://www.npmjs.com/package/@framework-doctor/cli)
 
-Framework Doctor auto-detects your framework and runs the right health check. Currently supports Svelte; React, Vue, and Angular coming soon.
+Framework Doctor auto-detects your framework and runs the right health check. Supports **Svelte** and **React**; Vue and Angular coming soon.
 
 ## Quick start
 
@@ -16,7 +16,8 @@ npx -y @framework-doctor/cli .
 Or run a specific doctor directly:
 
 ```bash
-npx -y @framework-doctor/svelte .
+npx -y @framework-doctor/react .    # React
+npx -y @framework-doctor/svelte .   # Svelte
 ```
 
 ## Try it
@@ -39,6 +40,13 @@ See [examples/README.md](examples/README.md) for more demo projects and commands
 - `npx -y @framework-doctor/cli .` - auto-detect framework and run the right doctor
 - `npx -y @framework-doctor/cli ./path/to/project` - scan a specific project directory
 
+**React (direct):**
+
+- `npx -y @framework-doctor/react .` - run a full scan
+- `npx -y @framework-doctor/react ./path/to/project` - scan a specific project directory
+- `npx -y @framework-doctor/react . --verbose` - include file and line details
+- `npx -y @framework-doctor/react . --score` - print only the numeric score (CI-friendly)
+
 **Svelte (direct):**
 
 - `npx -y @framework-doctor/svelte .` - run a full scan
@@ -51,6 +59,8 @@ See [examples/README.md](examples/README.md) for more demo projects and commands
 
 ## Options
 
+Svelte doctor:
+
 ```txt
 Usage: svelte-doctor [directory] [options]
 
@@ -62,12 +72,15 @@ Options:
   --verbose           show file details per rule
   --score             output only the score
   -y, --yes           skip prompts
+  --no-analytics      disable anonymous analytics
   --project <name>    select workspace project (comma-separated)
   --diff [base]       scan only changed files vs base branch
   --offline           skip remote scoring (local score only)
   -h, --help          display help for command
 ```
 
+React doctor options: `--no-lint`, `--no-dead-code`, `--verbose`, `--score`, `--no-analytics`, `--project`, `--diff`. See [packages/react-doctor/README.md](packages/react-doctor/README.md).
+
 ## Security checks
 
 Svelte Doctor includes a security scan that flags:
@@ -80,6 +93,10 @@ Plus oxlint's `no-eval` and svelte-check's `a11y_invalid_attribute` (e.g. `javas
 
 To ignore a rule: `"svelte-doctor/no-at-html"`, `"svelte-doctor/no-new-function"`, `"svelte-doctor/no-implied-eval"`.
 
+## Analytics
+
+Both doctors optionally send anonymous usage data when you opt in. Data is stored in your Supabase (see [supabase/README.md](supabase/README.md)). If your function enforces `TELEMETRY_KEY`, set `FRAMEWORK_DOCTOR_TELEMETRY_KEY` in the client environment. To disable: `--no-analytics`, `"analytics": false` in config, or `DO_NOT_TRACK=1`.
+
 ## Configuration
 
 Create `svelte-doctor.config.json`:
@@ -94,7 +111,8 @@ Create `svelte-doctor.config.json`:
   "jsTsLint": true,
   "deadCode": true,
   "verbose": false,
-  "diff": false
+  "diff": false,
+  "analytics": true
 }
 ```
 

examples/README.md

@@ -4,12 +4,7 @@ Demo projects to try Framework Doctor. Each example includes **intentional issue
 
 ## Svelte: demo-app
 
-A minimal SvelteKit app with:
-
-- **Security issues** — `eval()`, `new Function()`, `setTimeout("string")` in `src/lib/SecurityTest.ts`
-- **Dead code** — Unused exports in `src/lib/orphanUtils.ts` (knip will flag them)
-- **Legacy Svelte** — `DoctorTestComponent.svelte` uses export let, createEventDispatcher, onMount
-- **XSS** — `{@html}` and `javascript:` URLs in `+page.svelte`
+A minimal SvelteKit app with intentional issues. See [svelte/demo-app/README.md](svelte/demo-app/README.md) for details.
 
 ### Run from the repo
 
@@ -29,22 +24,17 @@ pnpm exec svelte-doctor examples/svelte/demo-app
 ### Run with npx (no clone)
 
 ```bash
-# After cloning, from repo root
-cd framework-doctor
-pnpm install
-npx -y @framework-doctor/cli examples/svelte/demo-app
+npx -y @framework-doctor/cli /path/to/framework-doctor/examples/svelte/demo-app
 ```
 
-Or from anywhere with an absolute path:
+Or from repo root after `pnpm install`:
 
 ```bash
-npx -y @framework-doctor/cli /path/to/framework-doctor/examples/svelte/demo-app
+npx -y @framework-doctor/cli examples/svelte/demo-app
 ```
 
 ### What to expect
 
-The doctor will report:
-
 - **Errors** — Security findings (eval, new Function, implied eval, {@html}, javascript: URLs)
 - **Warnings** — Dead/unused code, lint issues, legacy Svelte patterns
 - **Score** — A 0–100 health score for the project

examples/svelte/demo-app/CHANGELOG.md

@@ -0,0 +1,13 @@
+# framework-doctor-svelte-demo
+
+## 1.0.2
+
+### Patch Changes
+
+- Version alignment
+
+## 1.0.1
+
+### Patch Changes
+
+- added telemetry and refactored core

examples/svelte/demo-app/README.md

@@ -4,10 +4,12 @@ A minimal SvelteKit app with **intentional issues** for testing [Framework Docto
 
 ## Run the doctor
 
-From the framework-doctor repo root:
+From the framework-doctor repo root (after `pnpm install` and `pnpm build`):
 
 ```bash
 pnpm exec framework-doctor examples/svelte/demo-app
+# or directly:
+pnpm exec svelte-doctor examples/svelte/demo-app
 ```
 
 ## Intentional issues

examples/svelte/demo-app/package.json

@@ -1,6 +1,6 @@
 {
   "name": "framework-doctor-svelte-demo",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "private": true,
   "description": "Demo SvelteKit app for Framework Doctor - includes intentional issues",
   "type": "module",
@@ -11,7 +11,7 @@
     "check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json"
   },
   "devDependencies": {
-    "@sveltejs/adapter-auto": "^4.0.0",
+    "@sveltejs/adapter-node": "^4.0.0",
     "@sveltejs/kit": "^2.0.0",
     "@sveltejs/vite-plugin-svelte": "^5.0.0",
     "svelte": "^5.0.0",

examples/svelte/demo-app/svelte.config.js

@@ -1,4 +1,4 @@
-import adapter from '@sveltejs/adapter-auto';
+import adapter from '@sveltejs/adapter-node';
 import { vitePreprocess } from '@sveltejs/vite-plugin-svelte';
 
 /** @type {import('@sveltejs/kit').Config} */

package.json

@@ -7,21 +7,21 @@
   "license": "MIT",
   "description": "Framework Doctor monorepo - diagnose framework project health",
   "scripts": {
-    "build": "turbo run build",
+    "build": "turbo run build --filter=./packages/*",
     "build:svelte": "turbo run build --filter=@framework-doctor/svelte",
     "build:cli": "turbo run build --filter=@framework-doctor/cli",
     "demo": "pnpm build && pnpm exec framework-doctor examples/svelte/demo-app",
     "dev": "turbo run dev",
     "dev:doctor": "turbo run dev --filter=@framework-doctor/svelte",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
-    "lint": "turbo run lint",
+    "lint": "turbo run lint --filter=./packages/*",
     "lint:doctor": "turbo run lint --filter=@framework-doctor/svelte",
     "lint:fix": "turbo run lint:fix --filter=@framework-doctor/svelte",
-    "typecheck": "turbo run typecheck",
-    "test": "turbo run test",
+    "typecheck": "turbo run typecheck --filter=./packages/*",
+    "test": "turbo run test --filter=./packages/*",
     "test:doctor": "turbo run test --filter=@framework-doctor/svelte --concurrency=1",
-    "quality:check": "pnpm format:check && pnpm lint && pnpm typecheck && pnpm test",
+    "quality:check": "turbo run format:check lint typecheck test --filter=!./examples/*",
     "changeset": "changeset",
     "version": "changeset version",
     "release": "pnpm build && changeset publish",

packages/cli/CHANGELOG.md

@@ -0,0 +1,39 @@
+# @framework-doctor/cli
+
+## 1.0.2
+
+### Patch Changes
+
+- Version alignment
+- added telemetry and refactored core
+- Updated dependencies
+  - @framework-doctor/svelte@1.0.2
+  - @framework-doctor/react@1.0.2
+
+## 1.1.0
+
+### Minor Changes
+
+- b0823b0: Add unified CLI that auto-detects framework from package.json and runs the appropriate doctor. Run `npx @framework-doctor/cli .` instead of `npx @framework-doctor/svelte .`.
+
+### Patch Changes
+
+- Updated docs
+- Updated dependencies [cb322c3]
+- Updated dependencies
+  - @framework-doctor/react@1.0.1
+  - @framework-doctor/svelte@1.0.1
+
+## 1.1.0
+
+### Minor Changes
+
+- Updated docs
+- b0823b0: Add unified CLI that auto-detects framework from package.json and runs the appropriate doctor. Run `npx @framework-doctor/cli .` instead of `npx @framework-doctor/svelte .`.
+
+### Patch Changes
+
+- Updated dependencies
+- Updated dependencies [cb322c3]
+  - @framework-doctor/react@1.1.0
+  - @framework-doctor/svelte@1.1.0

packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@framework-doctor/cli",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Auto-detect framework and run the right doctor",
   "author": {
     "name": "Pitis Radu",

packages/core/CHANGELOG.md

@@ -0,0 +1,13 @@
+# @framework-doctor/core
+
+## 1.0.2
+
+### Patch Changes
+
+- Version alignment
+
+## 1.0.1
+
+### Patch Changes
+
+- added telemetry and refactored core

packages/core/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@framework-doctor/core",
+  "version": "1.0.2",
+  "description": "Shared utilities for Framework Doctor (telemetry, config)",
+  "author": {
+    "name": "Pitis Radu",
+    "url": "https://github.com/pitis"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "rimraf dist && cross-env NODE_ENV=production tsdown",
+    "lint": "oxlint src",
+    "lint:fix": "oxlint --fix src",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@types/node": "catalog:",
+    "cross-env": "catalog:",
+    "oxlint": "catalog:",
+    "rimraf": "catalog:",
+    "tsdown": "catalog:",
+    "typescript": "catalog:"
+  },
+  "packageManager": "pnpm@10.30.0",
+  "dependencies": {
+    "ora": "catalog:",
+    "picocolors": "catalog:"
+  }
+}