chill-agent 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 sann
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,91 @@
-# Temporary Holding Version
+# ChillAgent (`chill-agent`)
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> **The Zero-Bloat Anti-Slop 2.0 Engine & Deterministic Time-Travel Debugger for AI Coding Agents.**
+> Engineered for **Antigravity**, **Claude Code**, **Cursor**, **Codex**, **Windsurf**, and **GitHub Copilot**.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Node.js: >=18.0.0](https://img.shields.io/badge/node-%3E%3D18.0.0-emerald.svg)](https://nodejs.org)
+[![Zero Runtime Dependencies](https://img.shields.io/badge/dependencies-0-success.svg)](package.json)
+
+---
+
+## ⚡ Instant Quickstart (No Install Required)
+
+Run directly via `npx`:
+
+```bash
+# Launch interactive agent setup wizard
+npx chill-agent
+
+# Scan your codebase for AI slop cliches, purple gradients & hype copy
+npx chill-agent audit
+
+# Generate a master high-craft DESIGN.md specification
+npx chill-agent init-design
+
+# Inspect agent environment health & active hooks
+npx chill-agent doctor
+
+# Launch deterministic time-travel debugger & Linear-grade Web Inspector
+npx chill-agent rewind ui
+```
+
+---
+
+## 🥊 Why ChillAgent is Significantly Better than `miqdadbadjuber/anti-slop`
+
+| Feature | `miqdadbadjuber/anti-slop` | **`chill-agent` (Anti-Slop 2.0)** |
+| :--- | :--- | :--- |
+| **Dependencies** | Requires `@clack/prompts` & `picocolors` | **Pure Zero-Dependency** (Native Node.js terminal formatting) |
+| **Enforcement Layer** | Static markdown rules only | **Dual Layer: Static Negative Filter + Runtime Proxy Interceptor** |
+| **Slop Linter / Scanner** | ❌ None (Manual human audit only) | **Built-in Automated AST/Regex Auditor (`npx chill-agent audit`)** |
+| **Cure for "Sterile Default"**| ❌ Warns that output will be monotonous | **5 Curated High-Craft Aesthetic Presets (`npx chill-agent init-design`)** |
+| **Deterministic Time-Travel** | ❌ None | **RewindCore SQLite DAG ($0.00 / 0ms replay cache)** |
+| **Context Slop Sieve** | ❌ None | **Automated middle-out truncation for stale tool dumps (>1.5KB)** |
+| **Stuck Loop Protection** | ❌ None | **3x consecutive tool-call circuit breaker** |
+| **Agent Environment Reach** | 7 agents | **Auto-detects Antigravity, Claude, Cursor, Windsurf, Codex, Copilot** |
+
+---
+
+## 🧩 Modular Skills Architecture
+
+When installed, `chill-agent` provides 6 focused craftsmanship skills in `./skills/`:
+
+1. **`chill-slop` (Master Filter):** Hard gates against purple mesh gradients, pill-shaped bubble cards, skeleton screenshot previews, and hallucinated metrics.
+2. **`chill-slop-ui` (Visual Engineering):** Precision carbon palette (`#09090B`), 1px hairline borders, tabular monospace metrics, and intentional surface elevations.
+3. **`chill-slop-copywriting` (Domain Voice):** Purges robotic buzzwords (*"unleash the power"*, *"supercharge"*, *"seamless"*) in favor of concrete engineering specifications.
+4. **`chill-slop-code` (Code Hygiene):** Eliminates redundant *"this function calculates x"* comments and strips emoji decorations from docstrings.
+5. **`chill-slop-human` (Ergonomics & A11y):** Enforces 4.5:1 contrast, visible focus rings, 44px touch targets, and accessible ARIA affordances.
+6. **`chill-slop-mobile` (Responsive Systems):** Fluid CSS `clamp()` typography, zero horizontal blowout, and comfortable thumb-reach zone actions.
+
+---
+
+## 🎨 5 High-Craft Design System Presets
+
+Prevent your coding agent from falling into the "sterile blank white" trap with `npx chill-agent init-design`:
+
+- **Linear Carbon Geist:** Deep obsidian canvas, 1px `#26262B` borders, JetBrains Mono, emerald state indicators.
+- **Swiss Neo-Brutal:** High contrast black/white ink, strict 0px border radius, heavy grotesque typography.
+- **Industrial Technical Dossier:** Blueprint data-first layout, slate/steel surfaces, dense telemetry views.
+- **Warm Analog Editorial:** Warm ivory `#FBFBF9` paper, charcoal ink, literary serif headings.
+- **Cyberpunk Micro-Density:** HUD telemetry panels, emerald phosphor text, compact technical toggles.
+
+---
+
+## 📦 How to Publish to NPM
+
+To make `npx chill-agent` available globally to all developers:
+
+```bash
+# 1. Login to your NPM registry account
+npm login
+
+# 2. Publish package
+npm publish --access public
+```
+
+---
+
+## 📄 License
+
+MIT © [sann](https://github.com/sann)

package/bin/chill-agent.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { runCli } from '../src/cli.js';
+
+runCli().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/package.json

@@ -1,6 +1,40 @@
 {
   "name": "chill-agent",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "Zero-bloat Anti-Slop 2.0 Engine & Deterministic Time-Travel Debugger for AI Coding Agents.",
+  "type": "module",
+  "bin": {
+    "chill-agent": "bin/chill-agent.js"
+  },
+  "main": "./src/index.js",
+  "scripts": {
+    "start": "node ./bin/chill-agent.js",
+    "test": "node --test test/*.test.js",
+    "audit": "node ./bin/chill-agent.js audit",
+    "lint": "node ./bin/chill-agent.js audit"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "anti-slop",
+    "ai-agents",
+    "design-rules",
+    "claude-code",
+    "cursor",
+    "antigravity",
+    "time-travel-debugger",
+    "mcp",
+    "code-cleanup",
+    "accessibility"
+  ],
+  "author": "sann",
+  "license": "MIT",
+  "files": [
+    "bin/",
+    "src/",
+    "skills/",
+    "README.md",
+    "LICENSE"
+  ]
+}

package/skills/chill-slop/SKILL.md

@@ -0,0 +1,85 @@
+---
+name: chill-slop
+description: "Master Anti-Slop 2.0 Core Filter. Stops AI coding agents from generating generic, purple-glowing, templated AI slop. Enforces purpose gates, liveliness bars, and craftsmanship standards."
+---
+
+# ChillSlop 2.0: Master Negative Filter & Craftsmanship Standard
+
+> **Core Mandate:** Follow these rules whenever generating, planning, or auditing any UI, copy, architecture, or codebase.
+> The goal: Every deliverable must feel **crafted by a senior designer and principal engineer**, never generated by an average AI model.
+
+---
+
+## 1. The Core Purpose Test
+
+Before using **any** visual technique, color accent, layout structure, animation, or marketing copy, you must pass the **Purpose Test**:
+
+> **"What specific functional or communicative goal does this serve?"**
+> - If the only answer is *"it looks modern"*, *"it fills space"*, or *"it is standard for landing pages"* → **REJECT IT IMMEDIATELY**.
+> - If the answer names a verified user hierarchy, readability requirement, brand personality, or tactile feedback → **RETAIN AND DOCUMENT**.
+
+### The Litmus Test
+> *If the logo, product name, and color swatch were stripped away, does this interface still feel distinct, purposeful, and tailored to its specific domain?*
+> If **NO** → The output is AI Slop. Rebuild with intent.
+
+---
+
+## 2. Tier 0: Hard Gates (Instant Disqualification)
+
+Any presence of these items in code, CSS, or markdown is a build failure:
+
+- **HG-01 (Generic Gradient Orbs):** No saturated purple-to-blue, purple-to-cyan, or rainbow mesh radial gradient backgrounds.
+- **HG-02 (Pill Button Epidemic):** Do not make every button, input, card, and badge `rounded-full` / `rounded-3xl` with fuzzy multi-layered drop shadows.
+- **HG-03 (Glassmorphism Overdose):** Do not stack `backdrop-blur` on the navbar, every card, the modal, the sidebar, and dropdown menus simultaneously.
+- **HG-04 (Skeleton Hero Screenshots):** Never place fake grey skeleton wireframe placeholder boxes inside hero mockups as "product previews". Render real tabular data or actual functional UI.
+- **HG-05 (Emoji-Infested Code & Copy):** Never use emoji bullets in code comments (`// 🚀 Launch rocket`), and never use sparkle emojis (`✨ Magically transforms...`) in marketing copy.
+- **HG-06 (Hallucinated Social Proof):** Never generate fake quotes with stock avatar headshots, fake Forbes/TechCrunch badges, or bogus metrics (*"99.9% customer happiness"*).
+- **HG-07 (Unanchored Dark Mode):** Never force dark mode solely because *"it looks hacker/tech"* without evaluating domain context (e.g. medical, legal, or editorial platforms often demand crisp high-contrast light backgrounds).
+- **HG-08 (Cookie-Cutter Landing Template):** Hero → 3-column identical feature cards with icons in colored circles → Bento Grid → Testimonials → Pricing table → Accordion FAQ → Mega Footer. Break the template based on real product need.
+
+---
+
+## 3. Tier 1: The Liveliness Toolkit (Anti-Sterile Bar)
+
+Filtering slop does not mean defaulting to an empty, sterile white box. You must inject deliberate **domain character**:
+
+### L-1 — Typography as Structure
+- Pair a high-character display font with a workhorse sans or precision monospace.
+- Set strict tabular numerals (`font-variant-numeric: tabular-nums` or `JetBrains Mono` / `ui-monospace`) for all metrics, latencies, prices, and counters.
+- Use font weight and letter spacing (`letter-spacing: -0.02em` for dense display headers, `+0.04em` for uppercase micro-labels) instead of arbitrary font sizes.
+
+### L-2 — Surfaces & Micro-Borders
+- Replace floating blurry shadows with hairline borders (`1px solid var(--border)` / `rgba(255, 255, 255, 0.08)`).
+- Layer surfaces intentionally: Base Canvas (`#09090B`) → Panel Surface (`#111114`) → Elevated Interactive (`#18181C`).
+- Reserve hover transitions for tangible feedback: subtle border brightening or surface elevation, not 10px y-axis floating jumps.
+
+### L-3 — Semantic Accent Discipline
+- Limit bright accents to **one single semantic role** per screen (e.g. Emerald for active connection/replay, Coral for destructive actions, Indigo for branched states).
+- Never paint borders, badges, cards, links, headings, and buttons with the same loud primary color.
+
+---
+
+## 4. Usage Modes
+
+ChillSlop operates in two primary modes:
+
+### Mode 1: During Construction (Default for New Code)
+- Enforce Hard Gates and Liveliness while typing code.
+- Prevent cliches before they reach disk.
+- Run the Delivery Gate before declaring completion.
+
+### Mode 2: After Construction (Audit & Remediation)
+- Scan target repository files.
+- Produce a structured audit report citing rule infractions (HG-xx, R-xx).
+- Present numbered actionable remediation items for user confirmation before editing.
+
+---
+
+## 5. The Delivery Gate Checklist
+
+Before delivering any file or view:
+1. [ ] Are all interactive buttons and inputs functionally wired or clearly bound?
+2. [ ] Does the page function gracefully on viewport resize without overflow?
+3. [ ] Are contrast ratios at least 4.5:1 for normal text and 3:1 for large headers?
+4. [ ] Are all code comments strictly technical, devoid of AI conversational filler and emojis?
+5. [ ] Is the visual hierarchy determined by content necessity rather than a landing page checklist?

package/skills/chill-slop-code/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: chill-slop-code
+description: "Code hygiene and anti-slop commentary. Purges redundant AI comments, conversational chatter, and emoji-decorated docstrings while preserving critical architectural invariants."
+---
+
+# ChillSlop Code: Clean Engineering Standards
+
+Apply this skill when writing, reviewing, or refactoring source code in any language.
+
+## 1. Comment Hygiene
+- **Never state the obvious:**
+  - *Slop:*
+    ```typescript
+    // Define the add function that takes a and b
+    function add(a: number, b: number): number {
+      // Return the sum of a and b
+      return a + b;
+    }
+    ```
+  - *Clean:*
+    ```typescript
+    function add(a: number, b: number): number {
+      return a + b;
+    }
+    ```
+- **Document the "WHY", not the "WHAT":**
+  - Comments must explain non-obvious constraints, external quirks, memory layout assumptions, or algorithmic edge cases.
+  - *Example:*
+    ```typescript
+    // WAL mode enables concurrent reads without holding exclusive DB locks during proxy writes
+    db.exec(`PRAGMA journal_mode = WAL;`);
+    ```
+- **Zero Emojis in Code:** Never add `🚀`, `✨`, `🔥`, `💡`, or `🎉` to comments, docstrings, console logs, or commit messages.
+
+## 2. Structural Purity
+- **No Unused Imports or Dead Polyfills:** Never import libraries or create wrapper classes that are never referenced.
+- **Fail Fast & Explicitly:** Avoid silent try/catch blocks that swallow errors with generic log lines. Surface the exact stack trace or handle known failure branches deterministically.

package/skills/chill-slop-copywriting/SKILL.md

@@ -0,0 +1,33 @@
+---
+name: chill-slop-copywriting
+description: "Anti-slop copywriting standards. Strips robotic AI marketing filler, vague hype, empty buzzwords, and hallucinated metrics in favor of sharp, concrete domain prose."
+---
+
+# ChillSlop Copywriting: Authentic Domain Voice
+
+Apply this skill when drafting landing page headlines, CTAs, product microcopy, documentation, emails, or error messages.
+
+## 1. Banned AI Buzzwords & Cliches
+Strip these words immediately upon identification:
+- *"Unleash the power of..."* → Name the exact feature and what it does.
+- *"Seamless integration / Effortless workflow"* → Explain the exact protocol (e.g. *"Installs in 1 command via stdio JSON-RPC"*).
+- *"Supercharge your team / Game-changer / Next-generation"* → Provide actual performance figures or technical capability.
+- *"Dive in / Delve into / Look no further"* → Start directly with the instruction or documentation.
+- *"Robust, scalable, and cutting-edge"* → Specify uptime, architecture, or benchmark.
+- *"Empower developers to..."* → State the developer's exact action.
+
+## 2. The Specificity Mandate
+- Replace vague assertions with concrete specifications:
+  - *Bad:* "Fast, lightweight debugger that saves lots of tokens."
+  - *Good:* "0ms deterministic SQLite WAL proxy that prunes stale tool outputs over 1.5KB."
+  - *Bad:* "Join thousands of satisfied creators."
+  - *Good:* "Used by 1,400 active developers across 12 countries." (Only if verified, otherwise omit social proof entirely).
+
+## 3. Microcopy & Interface Verbs
+- **Action-Oriented Buttons:** Use imperative verb + direct object:
+  - Prefer: `Fork Session`, `Export JSON`, `Connect Database`, `Copy API Key`.
+  - Avoid: `Submit`, `Click Here`, `Get Started Now`, `Explore Magic`.
+- **Honest Error Messages:**
+  - State what broke, why it broke, and the exact resolution command.
+  - *Bad:* "Oops! Something went wrong! Please try again later."
+  - *Good:* "Upstream API timeout (504 Gateway Timeout) on `api.anthropic.com`. Verify your network or re-run with `chill-agent run --port 8788`."

package/skills/chill-slop-human/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: chill-slop-human
+description: "Accessibility, human factors, tactile feedback, and focus management. Guarantees WCAG AA compliance, proper keyboard affordances, and zero barrier interfaces."
+---
+
+# ChillSlop Human: Ergonomics & Accessibility
+
+Apply this skill to ensure all software interfaces are effortless to use with eyes, hands, screen readers, and keyboards.
+
+## 1. Contrast & Legibility
+- **WCAG AA Minimum Contrast:** Text and interactive elements must maintain at least `4.5:1` contrast ratio against their immediate background (`3:1` for text >= 18pt bold).
+- **No Low-Contrast Gray-on-Gray Slop:** Never use `#71717A` text on `#18181B` backgrounds for critical body copy. Reserve muted gray exclusively for secondary metadata labels.
+
+## 2. Keyboard & Focus Management
+- **Visible Focus Rings:** Every button, input, anchor, and clickable div must render a clear, un-clipped focus indicator (e.g. `outline: 2px solid var(--focus-ring); outline-offset: 2px;`). Never set `outline: none` without a high-visibility replacement.
+- **Escape Key Interception:** All modals, drawers, and overlay dialogs must close immediately on `Escape` keypress and restore focus to the triggering element.
+- **Logical Tab Order:** Ensure the DOM tab order matches visual layout. Never jump focus unexpectedly across the viewport.
+
+## 3. Touch Targets & Affordances
+- Interactive touch targets on mobile and touch-enabled devices must measure at least `44x44px` (or `48x48px` for primary controls).
+- Every icon button lacking visible text must include an unambiguous `aria-label` attribute (e.g. `<button aria-label="Close dialog">`).

package/skills/chill-slop-mobile/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: chill-slop-mobile
+description: "Mobile and responsive layout engineering. Prevents horizontal viewport blowout, cramped tap targets, unreadable desktop-first scales, and broken drawer gestures."
+---
+
+# ChillSlop Mobile: Responsive Engineering
+
+Apply this skill whenever building layouts intended to run across mobile phones, tablets, foldables, and ultra-wide displays.
+
+## 1. Zero Horizontal Overflow
+- The viewport must never produce accidental horizontal scrollbars (`overflow-x: hidden` is a band-aid, not a fix; eliminate the protruding element width).
+- Wrap tabular data inside cleanly scrollable container wrappers (`overflow-x: auto; -webkit-overflow-scrolling: touch;`) with visual scroll indicators.
+
+## 2. Fluid Typography & Modular Scale
+- Avoid massive static header sizes on mobile (`font-size: 72px` overflowing small screens).
+- Use CSS `clamp()` for fluid scaling:
+  ```css
+  h1 {
+    font-size: clamp(2rem, 5vw + 1rem, 3.75rem);
+    line-height: 1.1;
+  }
+  ```
+
+## 3. Thumb-Zone Optimization
+- Primary navigation and destructive or frequent actions on mobile should sit within the comfortable bottom thumb-reach zone.
+- Sticky bottom action bars on mobile must respect `env(safe-area-inset-bottom)` to prevent clipping against home indicators.

package/skills/chill-slop-ui/SKILL.md

@@ -0,0 +1,35 @@
+---
+name: chill-slop-ui
+description: "UI and visual engineering anti-slop rules. Replaces generic AI templates, bubbly gradients, and cookie-cutter grids with high-craft, Linear/Vercel/Raycast grade interfaces."
+---
+
+# ChillSlop UI: Visual Craftsmanship Standard
+
+Apply this skill when generating HTML, JSX, Vue, Svelte, Tailwind, CSS, or Figma designs.
+
+## 1. Color & Lighting Architecture
+- **Reject the Purple/Cyan Default:** Unless brand guidelines demand it, avoid `from-violet-600 to-indigo-600` or `from-cyan-400 to-blue-500` gradients.
+- **Surface Elevation Hierarchy:** Construct depth using discrete surface shades rather than fuzzy ambient box-shadows:
+  - Canvas: `#09090B` (Deep Carbon)
+  - Secondary/Sidebar: `#101014` (Subtle tint)
+  - Card/Panel: `#141418` (Structured baseline)
+  - Hover/Active: `#1C1C22` (Interactive target)
+  - Hairline Border: `1px solid #26262B` (Crisp separation)
+- **Monochrome Foundation:** Build 90% of the UI in monochromatic tones (white, zinc, carbon, slate). Use color strictly for semantic state indicators (Status Green, Warning Amber, Destructive Rose).
+
+## 2. Geometry & Spacing
+- **Border Radius Discipline:**
+  - Micro controls (tags, badges, inner buttons): `4px` to `6px`.
+  - Panels, dialogs, cards: `8px` to `10px`.
+  - Maximum outer containers: `12px`.
+  - **Ban:** Universal `rounded-2xl` and `rounded-3xl` cards unless designing a playful consumer toy app.
+- **Rhythm Over Random Spacing:** Use a strict 4px/8px modular scale (`4px`, `8px`, `12px`, `16px`, `24px`, `32px`, `48px`, `64px`). Never use arbitrary values like `margin: 17px`.
+
+## 3. Component Architecture
+- **Cards with Personality:** Do not render 3 identical cards with centered icon, bold title, and 2 lines of generic text. Asymmetric density, data tables, inline code snippets, and split-screen previews create visual interest.
+- **Tabular Monospace Metrics:** Every number, timestamp, latency, token count, and financial figure must use `ui-monospace`, `JetBrains Mono`, or `font-variant-numeric: tabular-nums` to prevent layout jitter.
+- **Affordance Clarity:** Interactive elements must look interactive without gimmicks. Clear hover states, visible active pressed states, and distinct disabled opacity (`0.45` with `cursor: not-allowed`).
+
+## 4. Animation & Motion
+- Fast, purposeful, non-distracting motion: `duration: 120ms` to `180ms`, easing `cubic-bezier(0.16, 1, 0.3, 1)`.
+- Never animate elements simply because CSS animations exist. Motion is strictly for spatial context (drawers entering from trigger side, dropdown expansions, toast dismissals).

package/src/auditor.js

@@ -0,0 +1,212 @@
+// src/auditor.js - Automated Anti-Slop Code & Copy Scanner
+import fs from 'node:fs';
+import path from 'node:path';
+import { c } from './prompts.js';
+
+const SLOP_PATTERNS = [
+  // 1. Visual Slop
+  {
+    id: 'VISUAL-01',
+    category: 'Visual Slop',
+    severity: 'HIGH',
+    regex: /from-purple-[0-9]{3}\s+to-indigo-[0-9]{3}|from-violet-[0-9]{3}\s+to-cyan-[0-9]{3}|from-indigo-[0-9]{3}\s+to-pink-[0-9]{3}/i,
+    name: 'Generic AI Purple/Cyan Gradient',
+    fix: 'Replace with precision monochromatic carbon `#09090B` or a branded domain color palette.'
+  },
+  {
+    id: 'VISUAL-02',
+    category: 'Visual Slop',
+    severity: 'MEDIUM',
+    regex: /rounded-3xl|rounded-full\s+.*shadow-2xl/i,
+    name: 'Pill-Shaped Floating Bubble',
+    fix: 'Use crisp geometric radius (4px to 8px) with hairline 1px borders instead of rounded-3xl with heavy shadow.'
+  },
+  {
+    id: 'VISUAL-03',
+    category: 'Visual Slop',
+    severity: 'LOW',
+    regex: /backdrop-blur-(md|lg|xl|2xl)/i,
+    name: 'Excessive Glassmorphic Blur',
+    fix: 'Ensure backdrop-blur is not stacked across cards, modals, and navbars simultaneously.'
+  },
+
+  // 2. Copywriting Slop
+  {
+    id: 'COPY-01',
+    category: 'Copywriting Slop',
+    severity: 'HIGH',
+    regex: /\b(unleash\s+the\s+power\s+of|supercharge\s+your|seamlessly\s+integrate|next-generation|game-changer|delve\s+into|dive\s+deep\s+into)\b/i,
+    name: 'Generic AI Hype Filler',
+    fix: 'Replace vague hype words with concrete specifications or direct functional instructions.'
+  },
+  {
+    id: 'COPY-02',
+    category: 'Copywriting Slop',
+    severity: 'MEDIUM',
+    regex: /✨|🚀|🎉|💡|🔥/u,
+    name: 'AI Sparkle / Rocket Emoji Cliché',
+    fix: 'Strip emojis from marketing headlines, documentation, and interface button labels.'
+  },
+  {
+    id: 'COPY-03',
+    category: 'Copywriting Slop',
+    severity: 'HIGH',
+    regex: /\b(trusted\s+by\s+[0-9,]+\s+happy\s+customers|99\.9%\s+customer\s+satisfaction)\b/i,
+    name: 'Hallucinated Social Proof',
+    fix: 'Cite verified customer metrics or remove synthetic testimonials entirely.'
+  },
+
+  // 3. Code Hygiene Slop
+  {
+    id: 'CODE-01',
+    category: 'Code Hygiene',
+    severity: 'MEDIUM',
+    regex: /\/\/\s*(this\s+function\s+calculates|this\s+is\s+the\s+render\s+method|define\s+variables?|initialize\s+state)/i,
+    name: 'Redundant Obvious AI Code Comment',
+    fix: 'Remove comments that merely restate what the code visibly does. Document the "WHY", not the "WHAT".'
+  },
+  {
+    id: 'CODE-02',
+    category: 'Code Hygiene',
+    severity: 'LOW',
+    regex: /\/\/\s*TODO:\s*(implement\s+this|add\s+logic\s+later|finish\s+this)/i,
+    name: 'Unimplemented Lazy AI Stub',
+    fix: 'Provide full working implementation or throw explicit NotImplementedError with actionable message.'
+  },
+
+  // 4. Human Factors & Accessibility
+  {
+    id: 'A11Y-01',
+    category: 'Human Factors',
+    severity: 'HIGH',
+    regex: /<button[^>]*>[^<]*<svg[^>]*>[\s\S]*?<\/svg>[^<]*<\/button>/i,
+    name: 'Icon Button Missing Accessible Label',
+    fix: 'Add aria-label="..." to the button element so screen readers can identify the control action.'
+  }
+];
+
+const SCAN_EXTENSIONS = new Set([
+  '.js', '.jsx', '.ts', '.tsx', '.vue', '.svelte', '.html', '.css', '.md', '.mdx'
+]);
+
+const IGNORE_DIRS = new Set([
+  'node_modules', '.git', '.chillrewind', 'dist', 'build', '.next', '.cache', 'coverage'
+]);
+
+export function scanFile(filePath) {
+  const findings = [];
+  try {
+    const content = fs.readFileSync(filePath, 'utf8');
+    const lines = content.split('\n');
+
+    lines.forEach((line, lineIdx) => {
+      for (const pattern of SLOP_PATTERNS) {
+        if (pattern.regex.test(line)) {
+          findings.push({
+            file: filePath,
+            line: lineIdx + 1,
+            snippet: line.trim().slice(0, 80),
+            ...pattern
+          });
+        }
+      }
+    });
+  } catch {}
+  return findings;
+}
+
+export function autoFixFile(filePath) {
+  let modified = false;
+  try {
+    let content = fs.readFileSync(filePath, 'utf8');
+
+    // 1. Strip marketing emojis (✨, 🚀, 🎉, etc.)
+    const strippedEmoji = content.replace(/[✨🚀🎉💡🔥]/gu, '');
+    if (strippedEmoji !== content) {
+      content = strippedEmoji;
+      modified = true;
+    }
+
+    // 2. Fix redundant obvious comments
+    const strippedComments = content.replace(/\/\/\s*(this\s+function\s+calculates|this\s+is\s+the\s+render\s+method|define\s+variables?|initialize\s+state).*\n/gi, '');
+    if (strippedComments !== content) {
+      content = strippedComments;
+      modified = true;
+    }
+
+    // 3. Fix rounded-3xl cards
+    const fixedRadius = content.replace(/\brounded-3xl\b/g, 'rounded-lg');
+    if (fixedRadius !== content) {
+      content = fixedRadius;
+      modified = true;
+    }
+
+    if (modified) {
+      fs.writeFileSync(filePath, content, 'utf8');
+    }
+  } catch {}
+  return modified;
+}
+
+export function scanDirectory(dirPath) {
+
+  const allFindings = [];
+
+  function walk(current) {
+    let entries = [];
+    try {
+      entries = fs.readdirSync(current, { withFileTypes: true });
+    } catch {
+      return;
+    }
+
+    for (const entry of entries) {
+      if (entry.isDirectory()) {
+        if (!IGNORE_DIRS.has(entry.name)) {
+          walk(path.join(current, entry.name));
+        }
+      } else if (entry.isFile()) {
+        const ext = path.extname(entry.name);
+        if (SCAN_EXTENSIONS.has(ext)) {
+          const res = scanFile(path.join(current, entry.name));
+          allFindings.push(...res);
+        }
+      }
+    }
+  }
+
+  walk(dirPath);
+  return allFindings;
+}
+
+export function printAuditReport(findings, targetDir = process.cwd()) {
+  console.log(`\n${c.bold}ChillAgent Anti-Slop Auditor Report${c.reset}`);
+  console.log(`${c.dim}Scanned directory: ${targetDir}${c.reset}\n`);
+
+  if (findings.length === 0) {
+    console.log(`${c.green}${c.bold}✔ Clean Codebase!${c.reset} No AI slop patterns or generic cliches detected.`);
+    return;
+  }
+
+  const highCount = findings.filter((f) => f.severity === 'HIGH').length;
+  const medCount = findings.filter((f) => f.severity === 'MEDIUM').length;
+  const lowCount = findings.filter((f) => f.severity === 'LOW').length;
+
+  console.log(
+    `Found ${c.bold}${findings.length} slop infractions${c.reset} ` +
+      `(${c.coral}${highCount} High${c.reset}, ${c.amber}${medCount} Medium${c.reset}, ${c.gray}${lowCount} Low${c.reset}):\n`
+  );
+
+  findings.forEach((f, idx) => {
+    const sevColor = f.severity === 'HIGH' ? c.coral : f.severity === 'MEDIUM' ? c.amber : c.gray;
+    const relFile = path.relative(targetDir, f.file);
+
+    console.log(
+      `${c.bold}#${idx + 1}${c.reset} [${sevColor}${f.severity}${c.reset}] ` +
+        `${c.cyan}${f.category}${c.reset} — ${c.bold}${f.name}${c.reset}`
+    );
+    console.log(`  ${c.dim}Location:${c.reset} ${relFile}:${c.line}`);
+    console.log(`  ${c.dim}Snippet:${c.reset}  ${c.italic}"${f.snippet}"${c.reset}`);
+    console.log(`  ${c.emerald}Fix:${c.reset}      ${f.fix}\n`);
+  });
+}