@eduardbar/drift 0.3.0 → 0.4.0

package/README.md

@@ -91,6 +91,20 @@ drift scan .
 | `--fix` | Show fix suggestions for each detected issue |
 | `--min-score <n>` | Exit with code 1 if overall score exceeds threshold |
 
+### `drift diff [ref]`
+
+Compare the current state of your project against any git ref:
+
+```bash
+drift diff           # HEAD vs HEAD~1 (default)
+drift diff HEAD~3    # HEAD vs 3 commits ago
+drift diff main      # HEAD vs branch main
+drift diff abc1234   # HEAD vs specific commit
+drift diff --json    # Output raw JSON diff
+```
+
+Shows score delta, new issues introduced, and issues resolved per file.
+
 ### AI Integration
 
 Use `--ai` to get structured output that LLMs can consume:
@@ -118,12 +132,49 @@ npx @eduardbar/drift scan ./src --fix
 |------|----------|-----------------|
 | `large-file` | error | Files over 300 lines — AI dumps everything into one place |
 | `large-function` | error | Functions over 50 lines — AI avoids splitting logic |
+| `duplicate-function-name` | error | Near-identical function names — AI regenerates instead of reusing |
+| `high-complexity` | error | Cyclomatic complexity > 10 — AI generates correct code, not simple code |
+| `circular-dependency` | error | Circular import chains between modules |
 | `debug-leftover` | warning | `console.log`, `TODO`, `FIXME`, `HACK` comments |
 | `dead-code` | warning | Unused imports — AI imports more than it uses |
-| `duplicate-function-name` | error | Near-identical function names — AI regenerates instead of reusing |
 | `any-abuse` | warning | Explicit `any` type — AI defaults to `any` when it can't infer |
 | `catch-swallow` | warning | Empty catch blocks — AI makes code "not throw" |
+| `comment-contradiction` | warning | Comments that restate what the code already says — AI documents the obvious |
+| `deep-nesting` | warning | Nesting depth > 3 — if inside for inside if inside try = unreadable |
+| `too-many-params` | warning | Functions with more than 4 parameters — AI avoids options objects |
+| `high-coupling` | warning | Files importing from more than 10 modules — AI imports broadly |
+| `promise-style-mix` | warning | `async/await` and `.then()` mixed in the same file |
+| `unused-export` | warning | Named exports never imported anywhere in the project — cross-file dead code |
+| `dead-file` | warning | Files never imported by any other file — invisible dead code |
+| `unused-dependency` | warning | Packages in `package.json` never imported in source code |
 | `no-return-type` | info | Missing explicit return types on functions |
+| `magic-number` | info | Numeric literals used directly in logic — extract to named constants |
+| `layer-violation` | error | Layer imports a layer it's not allowed to (requires `drift.config.ts`) |
+| `cross-boundary-import` | warning | Module imports from another module outside allowed boundaries (requires `drift.config.ts`) |
+
+---
+
+## ⚙️ Configuration (optional)
+
+Architectural rules (`layer-violation`, `cross-boundary-import`) require a `drift.config.ts` at your project root:
+
+```ts
+import type { DriftConfig } from '@eduardbar/drift'
+
+export default {
+  layers: [
+    { name: 'domain',  patterns: ['src/domain/**'],  canImportFrom: [] },
+    { name: 'app',     patterns: ['src/app/**'],     canImportFrom: ['domain'] },
+    { name: 'infra',   patterns: ['src/infra/**'],   canImportFrom: ['domain', 'app'] },
+  ],
+  modules: [
+    { name: 'auth',    root: 'src/modules/auth',    allowedExternalImports: ['src/shared'] },
+    { name: 'billing', root: 'src/modules/billing', allowedExternalImports: ['src/shared'] },
+  ],
+} satisfies DriftConfig
+```
+
+Without a config file, these two rules are silently skipped. All other rules run automatically with no configuration needed.
 
 ---
 
@@ -157,7 +208,7 @@ Exit code `1` if score exceeds `--min-score`. Exit code `0` otherwise.
 ```
 src/
 ├── types.ts      — DriftIssue, FileReport, DriftReport interfaces
-├── analyzer.ts   — AST analysis with ts-morph, 8 detection rules
+├── analyzer.ts   — AST analysis with ts-morph, 15 detection rules
 ├── reporter.ts   — buildReport() + Markdown formatter
 ├── printer.ts    — Console output with color (kleur)
 ├── index.ts      — Public API re-exports
@@ -188,12 +239,20 @@ npx @eduardbar/drift scan .
 
 ## 🤝 Contributing
 
-PRs are welcome. If you find a new AI code pattern worth detecting, open an issue with an example and we'll add a rule.
+PRs are welcome. See [CONTRIBUTING.md](./CONTRIBUTING.md) for the full guide.
+
+**Adding a new detection rule:**
+
+1. Fork the repo and create a branch: `git checkout -b feat/rule-name`
+2. Add the rule weight to `RULE_WEIGHTS` in `src/analyzer.ts`
+3. Implement the AST detection logic using ts-morph
+4. Add a `fix_suggestion` for the rule in `src/printer.ts`
+5. Update the rules table in `README.md` and `AGENTS.md`
+6. Open a PR — use the [PR template](./.github/PULL_REQUEST_TEMPLATE.md)
+
+Before opening an issue, check [existing issues](https://github.com/eduardbar/drift/issues). Use the [bug report](./.github/ISSUE_TEMPLATE/bug_report.md) or [feature request](./.github/ISSUE_TEMPLATE/feature_request.md) templates.
 
-1. Fork the repo
-2. Create a branch: `git checkout -b feat/rule-name`
-3. Add your rule in `src/analyzer.ts`
-4. Open a PR
+Please read [CODE_OF_CONDUCT.md](./CODE_OF_CONDUCT.md) before participating.
 
 ---
 

package/ROADMAP.md

@@ -0,0 +1,213 @@
+# Roadmap
+
+## What drift is, and what it's trying to become
+
+ESLint tells you if your code is **correct**.  
+SonarQube tells you if your code is **complex**.  
+drift tells you if your code is **going to kill your codebase in 6 months**.
+
+That is a different problem. And no existing tool solves it.
+
+The gap became critical in 2024–2025. AI tools let two engineers generate the technical debt of fifty. The code compiles. The tests pass. ESLint is green. And six months later nobody understands it, refactoring has stopped, and the codebase is effectively write-only.
+
+> *"You're staring at 847 lines of code you didn't write, don't understand, and can't debug without asking the AI to fix it seventeen times until something sticks."*  
+> — Reddit, r/vibecoding
+
+> *"39.9% drop in refactoring activity with AI tools. 8x increase in duplicated code blocks."*  
+> — GitClear, analysis of 211M lines of code
+
+drift's goal is to be the tool that sits between ESLint and SonarQube — lightweight enough to run on every commit, specific enough to catch what neither of them can, and simple enough that a score of 0 actually means something.
+
+**What drift is not:**
+- Not an ESLint replacement for style or correctness rules
+- Not a SonarQube replacement for security scanning
+- Not a cloud product, not a SaaS, not freemium
+
+**What drift is:**
+- A zero-config static analysis CLI that scores your TypeScript project's structural health
+- A CI gate that blocks debt from accumulating silently
+- A shared language for teams to talk about code quality: "our drift score went from 40 to 18 this sprint"
+- Always free. MIT. No tiers.
+
+---
+
+## Principles that don't change
+
+- **Always free for the developer.** MIT. Forever. No paid tier, no cloud lock-in.
+- **Zero config to start.** One command, one number. Config is optional and additive.
+- **Fast.** Results in under 3 seconds on any normal project.
+- **One actionable number, not 400 warnings nobody reads.**
+- **Cross-file analysis.** ESLint sees one file. drift sees the project.
+- **Readable by humans and by LLMs.** `--ai` flag produces structured output for Claude, GPT, Gemini.
+
+---
+
+## What's already done
+
+- AST analysis with ts-morph — 10 detection rules
+- Score 0–100 per file and project
+- `--json`, `--ai` (LLM-optimized output), `--fix` (inline suggestions)
+- `--min-score` for CI (exit 1 if score exceeds threshold)
+- `drift-ignore` per line and per file
+- Windows / Linux / macOS compatible via `npx`
+
+---
+
+## What's next
+
+Ordered by real developer pain — most common complaint first.
+
+---
+
+### 1. Complexity detection
+
+> *"AI generates a nuclear option for a problem that needed a screwdriver."*  
+> — Hacker News
+
+> *"One of my devs implemented a batching process. He presented extremely robust, high-quality code. The problem was that it was MASSIVE overkill."*  
+> — Hacker News, r/ExperiencedDevs
+
+ESLint has a `complexity` rule. It measures cyclomatic complexity — the number of branches. That's not the same as cognitive complexity — how hard it is to *understand*. Biome has `noExcessiveCognitiveComplexity`. Neither gives you a score.
+
+**Planned rules:**
+- `high-complexity` — cyclomatic complexity > 10 per function
+- `deep-nesting` — nesting depth > 3 levels (if inside if inside for inside try = unreadable)
+- `too-many-params` — functions with more than 4 parameters (AI doesn't refactor into objects)
+- `high-coupling` — files importing more than 10 distinct modules
+- `promise-style-mix` — `async/await` and `.then()` mixed in the same file
+
+**Why this matters:** Complexity is the #1 reason codebases become write-only. AI generates correct code. Not simple code.
+
+---
+
+### 2. Cross-file dead code detection
+
+> *"After integrating Knip I removed around 3,500 lines of dead code at once."*  
+> — dev.to
+
+> *"ESLint's architecture works on a file-by-file basis and was never intended to provide linting based on project-wide usage stats."*  
+> — typescript-eslint issue #371, marked **wontfix**
+
+ESLint detects unused variables *inside a file*. It cannot detect unused exports, unused files, or dead modules across the project. This is a fundamental architectural limitation — not a missing rule.
+
+**Planned features:**
+- `unused-export` — exported symbol never imported anywhere in the project
+- `dead-file` — file never imported by anything
+- `unused-dependency` — package in `package.json` with zero imports in the codebase
+
+**Why this matters:** Dead code is cognitive overhead. Every unused export is a trap for the next developer. ESLint will never fix this — the `wontfix` label is permanent.
+
+---
+
+### 3. Architectural boundary detection
+
+> *"AI coding tools keep breaking architecture — so I built a guard layer."*  
+> — Reddit, r/javascript
+
+This is the largest unaddressed gap in the ecosystem. ESLint can validate import paths with `no-restricted-imports`. It cannot tell you if your UI layer is importing directly from your database layer, or if your domain logic has dependencies on your HTTP framework.
+
+**Planned rules:**
+- `circular-dependency` — module A depends on B which depends on A
+- `layer-violation` — import from a prohibited architectural layer
+- `cross-boundary-import` — module outside its domain importing from another domain
+
+Zero config by default — drift infers what it can from the import graph. For teams that want explicit enforcement:
+
+```ts
+// drift.config.ts — optional
+export default {
+  boundaries: {
+    layers: ['ui', 'domain', 'infrastructure'],
+    rules: [{ from: 'ui', allow: ['domain'] }]
+  }
+}
+```
+
+**Why this matters:** Architecture violations are invisible until they're catastrophic. AI generates code that works today and breaks your architecture silently.
+
+---
+
+### 4. Historical drift (`drift diff` / `drift trend`)
+
+> *"Zero visibility on whether we're actually improving."*  
+> — Reddit, r/devsecops
+
+The current score matters. The trend matters more. Is your codebase getting better or worse sprint over sprint? Nobody knows — because no tool measures it in a way that's easy to track.
+
+**Planned commands:**
+- `drift diff HEAD~N` — what got worse between two commits
+- `drift trend --commits 30` — ASCII chart of score evolution over time  
+- `drift blame` — which commits introduced the most debt
+
+No database. No server. Git is the source of truth.
+
+**Why this matters:** A score of 45 means nothing without context. A score that went from 80 to 45 over 4 sprints means your team is actually improving.
+
+---
+
+### 5. AI authorship heuristics
+
+> *"Companies will try to overcome AI-generated technical debt by throwing more AI at the problem."*  
+> — Hacker News
+
+> *"When 95% of code is projected to be AI-generated by 2030 but 45% of it fails basic security tests, we're building a house of cards."*  
+> — Reddit, r/vibecoding
+
+The hardest and most differentiated item on this list. Patterns that are statistically more common in AI-generated code than human-written code.
+
+**Planned rules:**
+- `over-commented` — comments that describe exactly what the code already says (AI documents the obvious)
+- `unnecessary-abstraction` — class or interface used in exactly one place (AI loves creating things it doesn't use)
+- `hardcoded-config` — strings that look like URLs, tokens, or environment-specific paths hardcoded in logic
+- `inconsistent-error-handling` — different error handling patterns in equivalent functions across the same file
+
+**Why this matters:** These patterns don't fail tests. ESLint doesn't catch them. They accumulate until the codebase is unmaintainable.
+
+---
+
+### 6. Static HTML report + README badge
+
+> *"It's all disconnected — different dashboards, zero visibility."*  
+> — Reddit, r/devsecops
+
+No server. No account. No cloud.
+
+**Planned features:**
+- `drift report` — single self-contained `drift-report.html`, open in any browser
+- `drift badge` — `badge.svg` with the current score for your README  
+- `drift ci` — GitHub Actions annotations on the exact lines with issues (inline in the PR diff)
+
+---
+
+### 7. ESLint plugin
+
+Meet developers where they already are.
+
+- `eslint-plugin-drift` — exposes drift's rules as standard ESLint rules
+- Compatible with ESLint 9 flat config
+- The CLI remains canonical — the plugin is an integration path for teams already deep in ESLint
+
+**Why this matters:** Not everyone will install a new CLI. An ESLint plugin removes all friction and puts drift's rules into a toolchain devs already trust.
+
+---
+
+### 8. Pattern inconsistency detection
+
+> *"8x increase in duplicated code blocks with AI tools."*  
+> — GitClear
+
+AI doesn't reuse — it regenerates. The same logic appears in 4 different forms across the same file.
+
+**Planned rules:**
+- `semantic-duplication` — code blocks with equivalent logic detected via AST fingerprinting (not text comparison — that's what grep does)
+- `naming-inconsistency` — mixed naming conventions in the same module (camelCase + snake_case + PascalCase for the same concept)
+
+---
+
+## How to influence this roadmap
+
+Open an issue. If you're seeing a pattern that drift doesn't catch, describe it with a code example. Every rule in drift exists because real developers kept finding the same thing in AI-generated code.
+
+The roadmap grows from community reports — not from assumptions.
+
+If you want to implement one of these, see [CONTRIBUTING.md](./CONTRIBUTING.md).

package/assets/og-v030-linkedin.svg

@@ -0,0 +1,120 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 630" width="1200" height="630">
+  <defs>
+    <linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#0a0a0f"/>
+      <stop offset="100%" style="stop-color:#0f0f1a"/>
+    </linearGradient>
+    <linearGradient id="accent" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" style="stop-color:#6366f1"/>
+      <stop offset="100%" style="stop-color:#8b5cf6"/>
+    </linearGradient>
+    <linearGradient id="green-accent" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" style="stop-color:#22c55e"/>
+      <stop offset="100%" style="stop-color:#16a34a"/>
+    </linearGradient>
+    <linearGradient id="glow" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#6366f1;stop-opacity:0.15"/>
+      <stop offset="100%" style="stop-color:#8b5cf6;stop-opacity:0.05"/>
+    </linearGradient>
+    <linearGradient id="glow2" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#22c55e;stop-opacity:0.10"/>
+      <stop offset="100%" style="stop-color:#16a34a;stop-opacity:0.03"/>
+    </linearGradient>
+    <filter id="blur-glow">
+      <feGaussianBlur stdDeviation="40" result="blur"/>
+      <feComposite in="SourceGraphic" in2="blur" operator="over"/>
+    </filter>
+  </defs>
+
+  <!-- Background -->
+  <rect width="1200" height="630" fill="url(#bg)"/>
+
+  <!-- Ambient glows -->
+  <ellipse cx="200" cy="200" rx="300" ry="250" fill="url(#glow)" filter="url(#blur-glow)" opacity="0.8"/>
+  <ellipse cx="1050" cy="480" rx="280" ry="220" fill="url(#glow2)" filter="url(#blur-glow)" opacity="0.6"/>
+
+  <!-- Grid lines subtle -->
+  <line x1="0" y1="210" x2="1200" y2="210" stroke="#ffffff" stroke-opacity="0.03" stroke-width="1"/>
+  <line x1="0" y1="420" x2="1200" y2="420" stroke="#ffffff" stroke-opacity="0.03" stroke-width="1"/>
+  <line x1="300" y1="0" x2="300" y2="630" stroke="#ffffff" stroke-opacity="0.03" stroke-width="1"/>
+  <line x1="900" y1="0" x2="900" y2="630" stroke="#ffffff" stroke-opacity="0.03" stroke-width="1"/>
+
+  <!-- Left accent bar -->
+  <rect x="72" y="155" width="4" height="310" rx="2" fill="url(#accent)"/>
+
+  <!-- Version badge -->
+  <rect x="102" y="155" width="105" height="32" rx="6" fill="#1e1e3a" stroke="#6366f1" stroke-opacity="0.6" stroke-width="1.5"/>
+  <text x="154" y="176" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="14" font-weight="700" fill="#818cf8" text-anchor="middle">v0.3.0</text>
+
+  <!-- New badge -->
+  <rect x="218" y="155" width="80" height="32" rx="6" fill="#14532d" stroke="#22c55e" stroke-opacity="0.6" stroke-width="1.5"/>
+  <text x="258" y="176" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="14" font-weight="700" fill="#22c55e" text-anchor="middle">NEW</text>
+
+  <!-- Main title "drift" -->
+  <text x="102" y="295" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', monospace" font-size="110" font-weight="700" fill="#ffffff" letter-spacing="-4">drift</text>
+
+  <!-- Subtitle -->
+  <text x="104" y="345" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="22" font-weight="400" fill="#94a3b8" letter-spacing="0.5">Detect AI-generated technical debt. Zero config.</text>
+
+  <!-- Feature pills row -->
+  <rect x="104" y="370" width="145" height="30" rx="8" fill="#1a2a1a" stroke="#22c55e" stroke-opacity="0.5" stroke-width="1"/>
+  <text x="176" y="390" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="13" font-weight="600" fill="#22c55e" text-anchor="middle">--ai  LLM output</text>
+
+  <rect x="260" y="370" width="130" height="30" rx="8" fill="#1a1a2e" stroke="#6366f1" stroke-opacity="0.5" stroke-width="1"/>
+  <text x="325" y="390" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="13" font-weight="600" fill="#818cf8" text-anchor="middle">--fix  suggestions</text>
+
+  <rect x="401" y="370" width="145" height="30" rx="8" fill="#1a1a2e" stroke="#6366f1" stroke-opacity="0.5" stroke-width="1"/>
+  <text x="473" y="390" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="13" font-weight="600" fill="#818cf8" text-anchor="middle">drift-ignore</text>
+
+  <rect x="557" y="370" width="140" height="30" rx="8" fill="#1a1a2e" stroke="#6366f1" stroke-opacity="0.5" stroke-width="1"/>
+  <text x="627" y="390" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="13" font-weight="600" fill="#818cf8" text-anchor="middle">--min-score CI</text>
+
+  <!-- Terminal block right side -->
+  <rect x="660" y="140" width="468" height="335" rx="12" fill="#0d0d18" stroke="#ffffff" stroke-opacity="0.08" stroke-width="1"/>
+
+  <!-- Terminal header bar -->
+  <rect x="660" y="140" width="468" height="40" rx="12" fill="#1a1a2e"/>
+  <rect x="660" y="160" width="468" height="20" fill="#1a1a2e"/>
+
+  <!-- Terminal dots -->
+  <circle cx="690" cy="160" r="6" fill="#ff5f57"/>
+  <circle cx="710" cy="160" r="6" fill="#febc2e"/>
+  <circle cx="730" cy="160" r="6" fill="#28c840"/>
+
+  <text x="894" y="165" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="11" fill="#475569" text-anchor="middle">drift</text>
+
+  <text x="680" y="210" font-family="'Cascadia Code', 'Fira Code', 'Consolas', monospace" font-size="12" fill="#6366f1">$</text>
+  <text x="695" y="210" font-family="'Cascadia Code', 'Fira Code', 'Consolas', monospace" font-size="12" fill="#e2e8f0"> drift scan ./src --ai | pbcopy</text>
+
+  <text x="680" y="238" font-family="'Cascadia Code', 'Fira Code', 'Consolas', monospace" font-size="11" fill="#475569">  {</text>
+  <text x="680" y="256" font-family="'Cascadia Code', 'Fira Code', 'Consolas', monospace" font-size="11" fill="#475569">    "summary": {</text>
+  <text x="680" y="274" font-family="'Cascadia Code', 'Fira Code', 'Consolas', monospace" font-size="11" fill="#94a3b8">      "score": </text>
+  <text x="775" y="274" font-family="'Cascadia Code', 'Fira Code', 'Consolas', monospace" font-size="11" font-weight="700" fill="#ef4444">52</text>
+  <text x="792" y="274" font-family="'Cascadia Code', 'Fira Code', 'Consolas', monospace" font-size="11" fill="#94a3b8">, "grade": </text>
+  <text x="863" y="274" font-family="'Cascadia Code', 'Fira Code', 'Consolas', monospace" font-size="11" fill="#eab308">"HIGH"</text>
+
+  <text x="680" y="292" font-family="'Cascadia Code', 'Fira Code', 'Consolas', monospace" font-size="11" fill="#475569">    },</text>
+  <text x="680" y="310" font-family="'Cascadia Code', 'Fira Code', 'Consolas', monospace" font-size="11" fill="#475569">    "priority_order": [</text>
+  <text x="680" y="328" font-family="'Cascadia Code', 'Fira Code', 'Consolas', monospace" font-size="11" fill="#475569">      { "rank": 1, "rule": </text>
+  <text x="844" y="328" font-family="'Cascadia Code', 'Fira Code', 'Consolas', monospace" font-size="11" fill="#22c55e">"debug-leftover"</text>
+  <text x="956" y="328" font-family="'Cascadia Code', 'Fira Code', 'Consolas', monospace" font-size="11" fill="#475569">,</text>
+
+  <text x="680" y="346" font-family="'Cascadia Code', 'Fira Code', 'Consolas', monospace" font-size="11" fill="#475569">        "effort": </text>
+  <text x="775" y="346" font-family="'Cascadia Code', 'Fira Code', 'Consolas', monospace" font-size="11" fill="#22c55e">"low"</text>
+  <text x="810" y="346" font-family="'Cascadia Code', 'Fira Code', 'Consolas', monospace" font-size="11" fill="#94a3b8">, "fix_suggestion": "..."</text>
+
+  <text x="680" y="364" font-family="'Cascadia Code', 'Fira Code', 'Consolas', monospace" font-size="11" fill="#475569">    ],</text>
+  <text x="680" y="382" font-family="'Cascadia Code', 'Fira Code', 'Consolas', monospace" font-size="11" fill="#475569">    "recommended_action": </text>
+  <text x="680" y="400" font-family="'Cascadia Code', 'Fira Code', 'Consolas', monospace" font-size="11" fill="#818cf8">      "Fix 3 low-effort issues first."</text>
+
+  <text x="680" y="418" font-family="'Cascadia Code', 'Fira Code', 'Consolas', monospace" font-size="11" fill="#475569">  }</text>
+  <text x="680" y="436" font-family="'Cascadia Code', 'Fira Code', 'Consolas', monospace" font-size="11" fill="#64748b">  ↳ paste into Claude/GPT as context</text>
+  <text x="680" y="454" font-family="'Cascadia Code', 'Fira Code', 'Consolas', monospace" font-size="11" fill="#22c55e">  ✓ prioritized by severity + effort</text>
+
+  <!-- Author -->
+  <text x="104" y="500" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="15" fill="#334155">npx @eduardbar/drift scan . --ai</text>
+  <text x="104" y="525" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="14" fill="#475569">github.com/eduardbar/drift  ·  MIT  ·  TypeScript  ·  ts-morph</text>
+
+  <!-- Bottom accent line -->
+  <rect x="0" y="622" width="1200" height="8" fill="url(#accent)" opacity="0.7"/>
+</svg>

package/assets/og-v030-x.svg

@@ -0,0 +1,94 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 675" width="1200" height="675">
+  <defs>
+    <linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#0a0a0f"/>
+      <stop offset="100%" style="stop-color:#0f0f1a"/>
+    </linearGradient>
+    <linearGradient id="accent" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" style="stop-color:#6366f1"/>
+      <stop offset="100%" style="stop-color:#8b5cf6"/>
+    </linearGradient>
+    <linearGradient id="green-bar" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" style="stop-color:#22c55e"/>
+      <stop offset="100%" style="stop-color:#16a34a"/>
+    </linearGradient>
+    <linearGradient id="red-bar" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" style="stop-color:#ef4444"/>
+      <stop offset="100%" style="stop-color:#dc2626"/>
+    </linearGradient>
+    <linearGradient id="glow" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#6366f1;stop-opacity:0.15"/>
+      <stop offset="100%" style="stop-color:#8b5cf6;stop-opacity:0.05"/>
+    </linearGradient>
+    <filter id="blur-glow">
+      <feGaussianBlur stdDeviation="50" result="blur"/>
+      <feComposite in="SourceGraphic" in2="blur" operator="over"/>
+    </filter>
+  </defs>
+
+  <rect width="1200" height="675" fill="url(#bg)"/>
+  <ellipse cx="600" cy="200" rx="500" ry="200" fill="url(#glow)" filter="url(#blur-glow)" opacity="0.6"/>
+
+  <!-- Grid lines -->
+  <line x1="0" y1="225" x2="1200" y2="225" stroke="#ffffff" stroke-opacity="0.025" stroke-width="1"/>
+  <line x1="0" y1="450" x2="1200" y2="450" stroke="#ffffff" stroke-opacity="0.025" stroke-width="1"/>
+  <line x1="400" y1="0" x2="400" y2="675" stroke="#ffffff" stroke-opacity="0.025" stroke-width="1"/>
+  <line x1="800" y1="0" x2="800" y2="675" stroke="#ffffff" stroke-opacity="0.025" stroke-width="1"/>
+
+  <!-- Top accent bar -->
+  <rect x="0" y="0" width="1200" height="5" fill="url(#accent)" opacity="0.8"/>
+
+  <!-- drift title centered -->
+  <text x="600" y="120" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', monospace" font-size="90" font-weight="700" fill="#ffffff" letter-spacing="-3" text-anchor="middle">drift</text>
+
+  <!-- Version tag -->
+  <rect x="540" y="132" width="120" height="28" rx="14" fill="#1e1e3a" stroke="#6366f1" stroke-opacity="0.7" stroke-width="1.5"/>
+  <text x="600" y="151" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="14" font-weight="700" fill="#818cf8" text-anchor="middle">v0.3.0</text>
+
+  <!-- Tagline -->
+  <text x="600" y="195" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="20" fill="#94a3b8" text-anchor="middle">Measure AI-generated debt. One command.</text>
+
+  <!-- 3 score cards -->
+  <!-- Card 1: shadcn/ui CLI — Score 0 -->
+  <rect x="68" y="225" width="330" height="210" rx="12" fill="#0d0d18" stroke="#22c55e" stroke-opacity="0.3" stroke-width="1"/>
+  <text x="233" y="258" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="13" fill="#64748b" text-anchor="middle">shadcn/ui — CLI source</text>
+  <text x="233" y="320" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', monospace" font-size="72" font-weight="700" fill="#22c55e" text-anchor="middle">0</text>
+  <text x="233" y="348" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="12" fill="#22c55e" text-anchor="middle">CLEAN</text>
+  <!-- mini score bar full green -->
+  <rect x="100" y="368" width="266" height="6" rx="3" fill="#1e2a1e"/>
+  <rect x="100" y="368" width="5" height="6" rx="3" fill="url(#green-bar)"/>
+  <text x="233" y="395" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="11" fill="#475569" text-anchor="middle">production-grade code</text>
+  <text x="233" y="413" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="11" fill="#475569" text-anchor="middle">0 issues · 0 warnings</text>
+
+  <!-- Card 2: Vibe-coded module — Score 52 -->
+  <rect x="435" y="225" width="330" height="210" rx="12" fill="#0d0d18" stroke="#eab308" stroke-opacity="0.3" stroke-width="1"/>
+  <text x="600" y="258" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="13" fill="#64748b" text-anchor="middle">vibe-coded module</text>
+  <text x="600" y="320" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', monospace" font-size="72" font-weight="700" fill="#eab308" text-anchor="middle">52</text>
+  <text x="600" y="348" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="12" fill="#eab308" text-anchor="middle">HIGH</text>
+  <!-- mini score bar 52% -->
+  <rect x="467" y="368" width="266" height="6" rx="3" fill="#1e1e1e"/>
+  <rect x="467" y="368" width="138" height="6" rx="3" fill="#eab308"/>
+  <text x="600" y="395" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="11" fill="#475569" text-anchor="middle">review before shipping</text>
+  <text x="600" y="413" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="11" fill="#475569" text-anchor="middle">3 errors · 8 warnings</text>
+
+  <!-- Card 3: Full vibe dump — Score 89 -->
+  <rect x="802" y="225" width="330" height="210" rx="12" fill="#0d0d18" stroke="#ef4444" stroke-opacity="0.3" stroke-width="1"/>
+  <text x="967" y="258" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="13" fill="#64748b" text-anchor="middle">full vibe-coding dump</text>
+  <text x="967" y="320" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', monospace" font-size="72" font-weight="700" fill="#ef4444" text-anchor="middle">89</text>
+  <text x="967" y="348" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="12" fill="#ef4444" text-anchor="middle">CRITICAL</text>
+  <!-- mini score bar 89% -->
+  <rect x="834" y="368" width="266" height="6" rx="3" fill="#1e1e1e"/>
+  <rect x="834" y="368" width="237" height="6" rx="3" fill="url(#red-bar)"/>
+  <text x="967" y="395" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="11" fill="#475569" text-anchor="middle">rewrite before anyone sees it</text>
+  <text x="967" y="413" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="11" fill="#475569" text-anchor="middle">7 errors · 14 warnings</text>
+
+  <!-- Bottom CTA -->
+  <text x="600" y="480" font-family="'Cascadia Code', 'Fira Code', 'Consolas', monospace" font-size="18" fill="#6366f1" text-anchor="middle">npx @eduardbar/drift scan .</text>
+
+  <text x="600" y="520" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="14" fill="#475569" text-anchor="middle">NEW in v0.3.0: --ai · --fix · drift-ignore · CI-ready · Windows compatible</text>
+
+  <text x="600" y="560" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="14" fill="#334155" text-anchor="middle">github.com/eduardbar/drift  ·  MIT Open Source</text>
+
+  <!-- Bottom accent line -->
+  <rect x="0" y="667" width="1200" height="8" fill="url(#accent)" opacity="0.7"/>
+</svg>