@eduardbar/drift 0.9.1 → 1.1.0

package/.github/actions/drift-scan/README.md

@@ -0,0 +1,61 @@
+# drift-scan Action
+
+Scan your TypeScript project for AI-generated technical debt in CI.
+
+## Usage
+
+```yaml
+- name: Check drift score
+  uses: eduardbar/drift@v1
+  with:
+    path: ./src
+    min-score: 60
+```
+
+## Inputs
+
+| Input | Description | Default |
+|-------|-------------|---------|
+| `path` | Path to scan | `.` |
+| `min-score` | Fail if score exceeds this | `80` |
+| `fail-on-threshold` | Whether to fail on threshold | `true` |
+| `version` | drift version to use | `latest` |
+
+## Outputs
+
+| Output | Description |
+|--------|-------------|
+| `score` | Project drift score (0-100) |
+| `grade` | Grade: CLEAN / LOW / MODERATE / HIGH / CRITICAL |
+
+## Example: PR gate
+
+```yaml
+name: Drift Check
+on: [pull_request]
+
+jobs:
+  drift:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: eduardbar/drift@v1
+        with:
+          path: ./src
+          min-score: 60
+          fail-on-threshold: true
+```
+
+## Example: capture outputs
+
+```yaml
+- name: Scan drift
+  id: drift
+  uses: eduardbar/drift@v1
+  with:
+    path: ./src
+    fail-on-threshold: false
+
+- name: Print results
+  run: echo "Score ${{ steps.drift.outputs.score }}/100 — ${{ steps.drift.outputs.grade }}"
+```

package/.github/actions/drift-scan/action.yml

@@ -0,0 +1,65 @@
+name: 'Drift — Technical Debt Scanner'
+description: 'Scan TypeScript projects for AI-generated technical debt and enforce score thresholds'
+author: 'eduardbar'
+
+branding:
+  icon: 'activity'
+  color: 'purple'
+
+inputs:
+  path:
+    description: 'Path to scan'
+    required: false
+    default: '.'
+  min-score:
+    description: 'Fail if project score exceeds this threshold (0-100)'
+    required: false
+    default: '80'
+  fail-on-threshold:
+    description: 'Whether to fail the action if threshold is exceeded'
+    required: false
+    default: 'true'
+  version:
+    description: 'Version of @eduardbar/drift to use'
+    required: false
+    default: 'latest'
+
+outputs:
+  score:
+    description: 'The overall drift score (0-100)'
+    value: ${{ steps.scan.outputs.score }}
+  grade:
+    description: 'The drift grade (CLEAN / LOW / MODERATE / HIGH / CRITICAL)'
+    value: ${{ steps.scan.outputs.grade }}
+
+runs:
+  using: 'composite'
+  steps:
+    - name: Install drift
+      shell: bash
+      run: npm install -g @eduardbar/drift@${{ inputs.version }}
+
+    - name: Run drift scan
+      id: scan
+      shell: bash
+      run: |
+        TMPFILE=$(mktemp)
+
+        # Run scan — write JSON to tmp, progress to stderr (already separate)
+        drift scan ${{ inputs.path }} --ai > "$TMPFILE" 2>/dev/null || true
+
+        # Extract score and grade from AIOutput JSON
+        SCORE=$(node -e "const d=JSON.parse(require('fs').readFileSync('$TMPFILE','utf8')); console.log(d.summary.score)")
+        GRADE=$(node -e "const d=JSON.parse(require('fs').readFileSync('$TMPFILE','utf8')); console.log(d.summary.grade)")
+
+        rm "$TMPFILE"
+
+        echo "score=$SCORE" >> "$GITHUB_OUTPUT"
+        echo "grade=$GRADE" >> "$GITHUB_OUTPUT"
+
+        echo "Drift Score: $SCORE/100 ($GRADE)"
+
+        if [ "${{ inputs.fail-on-threshold }}" = "true" ] && [ "$SCORE" -gt "${{ inputs.min-score }}" ]; then
+          echo "::error::Drift score $SCORE/100 exceeds threshold of ${{ inputs.min-score }}"
+          exit 1
+        fi

package/.github/workflows/publish-vscode.yml

@@ -0,0 +1,78 @@
+name: Publish VS Code Extension
+
+on:
+  release:
+    types: [published]
+    tags:
+      - 'vscode-v*'
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to publish (e.g. 0.1.1)'
+        required: true
+        type: string
+
+permissions:
+  contents: read
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: packages/vscode-drift
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event_name == 'release' && github.ref || github.event.repository.default_branch }}
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+          cache-dependency-path: packages/vscode-drift/package-lock.json
+
+      - name: Verify version matches tag
+        if: github.event_name == 'release'
+        run: |
+          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
+            TAG_VERSION="${{ inputs.version }}"
+          else
+            TAG_VERSION="${GITHUB_REF#refs/tags/vscode-v}"
+          fi
+          PKG_VERSION=$(node -p "require('./package.json').version")
+          if [ "$TAG_VERSION" != "$PKG_VERSION" ]; then
+            echo "Error: Tag version ($TAG_VERSION) does not match package.json version ($PKG_VERSION)"
+            exit 1
+          fi
+          echo "Version check passed: $PKG_VERSION"
+
+      - name: Check if version already published
+        run: |
+          PKG_VERSION=$(node -p "require('./package.json').version")
+          PUBLISHED=$(npx @vscode/vsce show eduardbar.vscode-drift 2>&1 | grep "Version:" | awk '{print $2}' || echo "none")
+          if [ "$PUBLISHED" = "$PKG_VERSION" ]; then
+            echo "Version $PKG_VERSION already published on Marketplace. Skipping."
+            echo "skip_publish=true" >> $GITHUB_ENV
+          fi
+
+      - name: Install dependencies
+        if: env.skip_publish != 'true'
+        run: npm ci
+
+      - name: Build extension
+        if: env.skip_publish != 'true'
+        run: npm run build
+
+      - name: Package extension
+        if: env.skip_publish != 'true'
+        run: npx @vscode/vsce package --no-dependencies
+
+      - name: Publish to VS Code Marketplace
+        if: env.skip_publish != 'true'
+        run: npx @vscode/vsce publish --no-dependencies
+        env:
+          VSCE_PAT: ${{ secrets.VSCE_PAT }}

package/AGENTS.md

@@ -20,6 +20,7 @@ Publicado en npm como `@eduardbar/drift`. MIT.
 | `kleur ^4` | Colores en consola (sin dependencias) |
 | `typescript ^5.9` | Dev — compilación |
 | `@types/node ^25` | Dev — tipos Node.js |
+| `vitest ^4` | Testing |
 
 **Runtime:** Node.js 18+, ES Modules (`"type": "module"`).
 
@@ -32,18 +33,47 @@ drift/
 ├── bin/
 │   └── drift.js          ← wrapper cross-platform (Windows npx fix)
 ├── src/
-│   ├── types.ts          ← interfaces: DriftIssue, FileReport, DriftReport, AIOutput
-│   ├── analyzer.ts       ← motor AST + 10 reglas de detección + drift-ignore
-│   ├── reporter.ts       ← buildReport(), formatMarkdown(), formatAIOutput()
-│   ├── printer.ts        ← salida consola con colores y score bar ASCII
-│   ├── utils.ts          ← scoreToGrade, severityIcon, scoreBar
-│   ├── index.ts          ← re-exports públicos (librería)
-│   └── cli.ts            ← entry point Commander.js
-├── assets/
-│   ├── og.svg / og.png           ← imagen OG original
-│   ├── og-v030-linkedin.svg/png  ← imagen post LinkedIn v0.3.0
-│   └── og-v030-x.svg/png         ← imagen hilo X v0.3.0
+│   ├── analyzer.ts       ← motor AST + 26 reglas + drift-ignore
+│   ├── types.ts         ← interfaces: DriftIssue, FileReport, DriftReport, AIOutput
+│   ├── reporter.ts      ← buildReport(), formatMarkdown(), formatAIOutput()
+│   ├── printer.ts       ← salida consola con colores y score bar ASCII
+│   ├── utils.ts         ← scoreToGrade, severityIcon, scoreBar
+│   ├── index.ts         ← re-exports públicos (librería)
+│   ├── cli.ts           ← entry point Commander.js
+│   ├── config.ts        ← drift.config.ts support
+│   ├── fix.ts           ← drift fix command
+│   ├── ci.ts            ← drift ci command
+│   ├── diff.ts          ← drift diff command
+│   ├── report.ts        ← drift report command
+│   ├── badge.ts         ← drift badge command
+│   ├── snapshot.ts      ← drift snapshot command
+│   ├── git.ts           ← re-exports git analyzers
+│   ├── git/
+│   │   ├── trend.ts     ← drift trend (historial de scores)
+│   │   ├── blame.ts     ← drift blame (atribución de deuda)
+│   │   └── helpers.ts
+│   └── rules/           ← reglas modularizadas por fase
+│       ├── phase0-basic.ts
+│       ├── phase1-complexity.ts
+│       ├── phase2-crossfile.ts    ← dead-file, unused-export, unused-dependency
+│       ├── phase3-arch.ts          ← circular-dependency, layer-violation
+│       ├── phase5-ai.ts
+│       ├── phase8-semantic.ts     ← semantic-duplication
+│       ├── complexity.ts
+│       ├── coupling.ts
+│       ├── nesting.ts
+│       ├── promise.ts
+│       ├── magic.ts
+│       ├── comments.ts
+│       └── shared.ts
+├── packages/
+│   ├── eslint-plugin-drift/       ← ESLint plugin oficial
+│   └── vscode-drift/              ← VS Code extension
 ├── dist/                 ← output tsc (no editar a mano)
+├── assets/
+│   ├── og.svg / og.png
+│   ├── og-v030-linkedin.svg/png
+│   └── og-v030-x.svg/png
 ├── .github/workflows/publish.yml
 ├── package.json
 ├── tsconfig.json
@@ -58,6 +88,8 @@ drift/
 npm run build       # tsc — compila src/ → dist/
 npm run dev         # tsc --watch
 npm start           # node dist/cli.js (desarrollo local)
+npm test            # vitest run
+npm run test:watch # vitest (watch mode)
 ```
 
 **Pre-publicación:** `prepublishOnly` corre `build` automáticamente.
@@ -88,18 +120,35 @@ npx @eduardbar/drift scan ./src -o report.md    # exportar Markdown
 
 ## Reglas del analyzer
 
-| Regla | Severidad | Peso | Qué detecta |
-|-------|-----------|------|-------------|
-| `large-file` | error | 20 | Archivos > 300 líneas |
-| `large-function` | error | 15 | Funciones > 50 líneas |
-| `duplicate-function-name` | error | 18 | Nombres de función duplicados (case-insensitive) |
-| `debug-leftover` | warning | 10 | `console.log/warn/error` + `TODO/FIXME/HACK/XXX/TEMP` |
-| `catch-swallow` | warning | 10 | Bloques `catch {}` vacíos |
-| `dead-code` | warning | 8 | Imports nombrados sin usar |
-| `any-abuse` | warning | 8 | Uso explícito de `any` como tipo |
-| `comment-contradiction` | warning | 12 | (reservado — definido en RULE_WEIGHTS) |
-| `no-return-type` | info | 5 | Funciones sin tipo de retorno explícito |
-| `magic-number` | info | 3 | (reservado — definido en RULE_WEIGHTS) |
+| Regla | Severidad | Peso |
+|-------|-----------|------|
+| `large-file` | error | 20 |
+| `large-function` | error | 15 |
+| `duplicate-function-name` | error | 18 |
+| `high-complexity` | error | 15 |
+| `circular-dependency` | error | 14 |
+| `layer-violation` | error | 16 |
+| `comment-contradiction` | warning | 12 |
+| `deep-nesting` | warning | 12 |
+| `semantic-duplication` | warning | 12 |
+| `debug-leftover` | warning | 10 |
+| `catch-swallow` | warning | 10 |
+| `high-coupling` | warning | 10 |
+| `dead-file` | warning | 10 |
+| `hardcoded-config` | warning | 10 |
+| `cross-boundary-import` | warning | 10 |
+| `dead-code` | warning | 8 |
+| `any-abuse` | warning | 8 |
+| `too-many-params` | warning | 8 |
+| `unused-export` | warning | 8 |
+| `inconsistent-error-handling` | warning | 8 |
+| `promise-style-mix` | warning | 7 |
+| `unnecessary-abstraction` | warning | 7 |
+| `naming-inconsistency` | warning | 6 |
+| `unused-dependency` | warning | 6 |
+| `no-return-type` | info | 5 |
+| `over-commented` | info | 4 |
+| `magic-number` | info | 3 |
 
 **Score = suma de pesos capped a 100. Score del proyecto = promedio de archivos.**
 
@@ -199,6 +248,7 @@ Sin esto, Windows no ejecuta el shebang correctamente con ES modules.
 
 | Versión | Cambios principales |
 |---------|---------------------|
+| **1.0.0** | 26 reglas, 131 tests, modular rules, JS/JSX, drift fix/report/diff/ci/badge/trend/blame, VS Code extension |
 | **0.3.0** | `--ai` (LLM-optimized JSON output) + `--fix` (inline suggestions) |
 | **0.2.3** | Fix: bin wrapper para compatibilidad Windows npx |
 | **0.2.2** | Refactor: `formatMarkdown` dividido en helpers + fix CI doble publish |
@@ -208,6 +258,16 @@ Sin esto, Windows no ejecuta el shebang correctamente con ES modules.
 
 ---
 
+## Estado actual (feb 2026)
+
+- **Versión publicada:** `1.0.0`
+- **Branch:** `master`, sincronizado con `origin`
+- **Self-scan score:** 5/100 (LOW)
+- **Top issues:** 51× magic-number, 2× deep-nesting, 2× catch-swallow
+- **26 reglas activas** organizadas en fases
+
+---
+
 ## Convenciones de código
 
 - Todo en TypeScript — sin `any` explícito (drift se corre sobre sí mismo)

package/README.md

@@ -10,7 +10,7 @@ Detect technical debt in AI-generated TypeScript code. One command. Zero config.
 ![ts-morph](https://img.shields.io/badge/powered%20by-ts--morph-6366f1.svg)
 ![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)
 
-[Why](#why) · [Installation](#installation) · [Commands](#commands) · [Rules](#rules) · [Score](#score) · [Configuration](#configuration) · [CI Integration](#ci-integration) · [drift-ignore](#drift-ignore) · [Contributing](#contributing)
+[Why](#why) · [Installation](#installation) · [Product Docs](#product-docs) · [Commands](#commands) · [Rules](#rules) · [Score](#score) · [Configuration](#configuration) · [CI Integration](#ci-integration) · [drift-ignore](#drift-ignore) · [Contributing](#contributing)
 
 ---
 
@@ -47,6 +47,13 @@ npm install --save-dev @eduardbar/drift
 
 ---
 
+## Product Docs
+
+- Product requirements and roadmap: [`docs/PRD.md`](./docs/PRD.md)
+- Contributor/agent workflow guide: [`docs/AGENTS.md`](./docs/AGENTS.md)
+
+---
+
 ## Commands
 
 ### `drift scan [path]`
@@ -121,6 +128,42 @@ Shows score delta, issues introduced, and issues resolved since the given ref.
 
 ---
 
+### `drift review`
+
+Review drift against a git base ref and output a PR-ready markdown comment.
+
+```bash
+drift review --base origin/main
+drift review --base main --comment
+drift review --base HEAD~3 --json
+drift review --base origin/main --fail-on 5
+```
+
+| Flag | Description |
+|------|-------------|
+| `--base <ref>` | Git base ref to compare against (default: `origin/main`) |
+| `--json` | Output structured review JSON |
+| `--comment` | Print only the markdown body for PR comments |
+| `--fail-on <n>` | Exit code 1 when score delta is greater than or equal to `n` |
+
+---
+
+### `drift map [path]`
+
+Generate an `architecture.svg` map with inferred layer dependencies.
+
+```bash
+drift map
+drift map ./src
+drift map ./src --output docs/architecture.svg
+```
+
+| Flag | Description |
+|------|-------------|
+| `--output <file>` | Output path for the SVG file (default: `architecture.svg`) |
+
+---
+
 ### `drift report [path]`
 
 Generate a self-contained HTML report. No server required — open in any browser.
@@ -220,6 +263,24 @@ drift blame file --top 10
 
 ---
 
+### `drift fix [path]`
+
+Auto-fix safe issues with explicit preview/write modes.
+
+```bash
+drift fix ./src --preview
+drift fix ./src --write
+drift fix ./src --dry-run   # alias of --preview
+```
+
+| Flag | Description |
+|------|-------------|
+| `--preview` | Preview before/after without writing files |
+| `--write` | Apply fixes to disk |
+| `--dry-run` | Backward-compatible alias for preview mode |
+
+---
+
 ## Rules
 
 26 rules across three severity levels. All run automatically unless marked as requiring configuration.
@@ -277,6 +338,12 @@ drift runs with zero configuration. Architectural rules (`layer-violation`, `cro
 import type { DriftConfig } from '@eduardbar/drift'
 
 export default {
+  plugins: ['drift-plugin-example'],
+  architectureRules: {
+    controllerNoDb: true,
+    serviceNoHttp: true,
+    maxFunctionLines: 80,
+  },
   layers: [
     { name: 'domain',  patterns: ['src/domain/**'],  canImportFrom: [] },
     { name: 'app',     patterns: ['src/app/**'],     canImportFrom: ['domain'] },
@@ -418,7 +485,7 @@ See [CODE_OF_CONDUCT.md](./CODE_OF_CONDUCT.md) before participating.
 | [`commander`](https://github.com/tj/commander.js) | CLI commands and flags |
 | [`kleur`](https://github.com/lukeed/kleur) | Terminal colors (zero dependencies) |
 
-**Runtime:** Node.js 18+ · TypeScript 5.x · ES Modules
+**Runtime:** Node.js 18+ · TypeScript 5.x · ES Modules · Supports TypeScript (`.ts`, `.tsx`) and JavaScript (`.js`, `.jsx`) files
 
 ---