distyll 0.1.0

package/dist/rules/verbose-comments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verbose-comments.js","sourceRoot":"","sources":["../../src/rules/verbose-comments.ts"],"names":[],"mappings":"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"}

package/dist/scanner.d.ts

@@ -0,0 +1,11 @@
+import type { ScanResult, ScanSummary, Rule, StyleProfile } from './types';
+export interface ScanPathsOptions {
+    rules?: Rule[];
+    configDir?: string;
+    style?: boolean;
+    verbose?: boolean;
+}
+export declare function scanPaths(paths: string[], options?: Rule[] | ScanPathsOptions): Promise<ScanSummary>;
+export declare function resolveFiles(paths: string[], extraIgnore?: string[]): Promise<string[]>;
+export declare function scanFile(filePath: string, rules?: Rule[], profile?: StyleProfile | null, verbose?: boolean): ScanResult | null;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAW3E,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,GAAG,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAgE1G;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAgC7F;AAED,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,IAAI,EAAE,EACd,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,EAC7B,OAAO,UAAQ,GACd,UAAU,GAAG,IAAI,CAiDnB"}

package/dist/scanner.js

@@ -0,0 +1,196 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scanPaths = scanPaths;
+exports.resolveFiles = resolveFiles;
+exports.scanFile = scanFile;
+const fs = __importStar(require("fs"));
+const fast_glob_1 = __importDefault(require("fast-glob"));
+const parser_1 = require("./parser");
+const rules_1 = require("./rules");
+const scorer_1 = require("./scorer");
+const config_1 = require("./config");
+const languages_1 = require("./languages");
+const fixes_1 = require("./fixes");
+const profile_1 = require("./fingerprint/profile");
+const comparator_1 = require("./fingerprint/comparator");
+const errors_1 = require("./errors");
+function countLines(source) {
+    if (source.length === 0)
+        return 0;
+    let count = 1;
+    for (let i = 0; i < source.length; i++) {
+        if (source[i] === '\n')
+            count++;
+    }
+    return count;
+}
+async function scanPaths(paths, options) {
+    let activeRules;
+    let configDir;
+    let useStyle = false;
+    let verbose = false;
+    if (Array.isArray(options)) {
+        activeRules = options;
+    }
+    else if (options && !Array.isArray(options)) {
+        activeRules = options.rules;
+        configDir = options.configDir;
+        useStyle = options.style ?? false;
+        verbose = options.verbose ?? false;
+    }
+    const config = (0, config_1.loadConfig)(configDir ?? (paths.length > 0 ? paths[0] : process.cwd()));
+    let rules = activeRules ?? rules_1.allRules;
+    if (config.rules) {
+        rules = rules.filter((rule) => {
+            const setting = config.rules?.[rule.name];
+            return setting !== 'off';
+        });
+        rules = rules.map((rule) => {
+            const setting = config.rules?.[rule.name];
+            if (setting === 'warn' || setting === 'error') {
+                return { ...rule, severity: setting === 'warn' ? 'warning' : 'error' };
+            }
+            return rule;
+        });
+    }
+    let profile = null;
+    if (useStyle) {
+        const profileDir = configDir ?? (paths.length > 0 ? paths[0] : process.cwd());
+        profile = (0, profile_1.loadProfile)(profileDir);
+        if (!profile) {
+            profile = (0, profile_1.loadProfile)(process.cwd());
+        }
+    }
+    const files = await resolveFiles(paths, config.ignore);
+    if (verbose) {
+        console.error(`Scanning ${files.length} file(s) with ${rules.length} rule(s)...`);
+    }
+    const results = [];
+    for (const filePath of files) {
+        const startTime = verbose ? performance.now() : 0;
+        const result = scanFile(filePath, rules, profile, verbose);
+        if (verbose && result) {
+            const elapsed = (performance.now() - startTime).toFixed(1);
+            console.error(`  ${filePath}: ${result.findings.length} finding(s) in ${elapsed}ms`);
+        }
+        if (result) {
+            results.push(result);
+        }
+    }
+    return (0, scorer_1.computeScore)(results);
+}
+async function resolveFiles(paths, extraIgnore) {
+    const files = [];
+    const supportedExts = (0, languages_1.getSupportedExtensions)();
+    const ignorePatterns = [
+        '**/node_modules/**', '**/dist/**', '**/build/**', '**/.git/**', '**/vendor/**',
+        ...(extraIgnore ?? []),
+    ];
+    for (const p of paths) {
+        let stat;
+        try {
+            stat = fs.statSync(p);
+        }
+        catch {
+            continue;
+        }
+        if (stat.isFile()) {
+            const lang = (0, parser_1.detectLanguage)(p);
+            if (lang)
+                files.push(p);
+        }
+        else if (stat.isDirectory()) {
+            const pattern = `**/*.{${supportedExts.join(',')}}`;
+            const found = await (0, fast_glob_1.default)(pattern, {
+                cwd: p,
+                absolute: true,
+                ignore: ignorePatterns,
+            });
+            files.push(...found);
+        }
+    }
+    return files.sort();
+}
+function scanFile(filePath, rules, profile, verbose = false) {
+    const activeRules = rules ?? rules_1.allRules;
+    const language = (0, parser_1.detectLanguage)(filePath);
+    if (!language) {
+        if (verbose)
+            console.error(`  [skip] ${filePath}: unsupported language`);
+        return null;
+    }
+    const fileData = (0, errors_1.safeReadFile)(filePath, verbose);
+    if (!fileData)
+        return null;
+    const { source } = fileData;
+    const loc = countLines(source);
+    let tree;
+    try {
+        tree = (0, parser_1.parse)(source, language);
+    }
+    catch (err) {
+        if (verbose) {
+            console.error(`  [skip] ${filePath}: parse error — ${err.message}`);
+        }
+        return null;
+    }
+    let findings = activeRules.flatMap((rule) => {
+        try {
+            const ruleStart = verbose ? performance.now() : 0;
+            const ruleFindings = rule.check(tree, source, filePath);
+            if (verbose) {
+                const elapsed = (performance.now() - ruleStart).toFixed(1);
+                if (ruleFindings.length > 0) {
+                    console.error(`    [rule] ${rule.name}: ${ruleFindings.length} finding(s) (${elapsed}ms)`);
+                }
+            }
+            return ruleFindings;
+        }
+        catch {
+            return [];
+        }
+    });
+    findings = (0, fixes_1.attachFixes)(findings, tree, source);
+    if (profile) {
+        const styleFindings = (0, comparator_1.compareFileToProfile)(filePath, source, tree, profile);
+        findings.push(...styleFindings);
+    }
+    return { file: filePath, findings, loc };
+}
+//# sourceMappingURL=scanner.js.map

package/dist/scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.js","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"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"}

package/dist/scorer.d.ts

@@ -0,0 +1,3 @@
+import type { ScanResult, ScanSummary } from './types';
+export declare function computeScore(results: ScanResult[]): ScanSummary;
+//# sourceMappingURL=scorer.d.ts.map

package/dist/scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scorer.d.ts","sourceRoot":"","sources":["../src/scorer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAY,MAAM,SAAS,CAAC;AAQjE,wBAAgB,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,WAAW,CAiB/D"}

package/dist/scorer.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeScore = computeScore;
+const SEVERITY_WEIGHTS = {
+    info: 1,
+    warning: 3,
+    error: 5,
+};
+function computeScore(results) {
+    const totalLoc = results.reduce((sum, r) => sum + r.loc, 0);
+    const totalFindings = results.reduce((sum, r) => sum + r.findings.length, 0);
+    if (totalLoc === 0 || totalFindings === 0) {
+        return { results, totalFindings: 0, score: 0 };
+    }
+    const weightedSum = results.reduce((sum, r) => {
+        return sum + r.findings.reduce((fSum, f) => fSum + SEVERITY_WEIGHTS[f.severity], 0);
+    }, 0);
+    // Normalize: weighted findings per 100 lines of code, capped at 100
+    const rawScore = (weightedSum / totalLoc) * 100;
+    const score = Math.min(100, Math.round(rawScore));
+    return { results, totalFindings, score };
+}
+//# sourceMappingURL=scorer.js.map

package/dist/scorer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scorer.js","sourceRoot":"","sources":["../src/scorer.ts"],"names":[],"mappings":";;AAQA,oCAiBC;AAvBD,MAAM,gBAAgB,GAA6B;IACjD,IAAI,EAAE,CAAC;IACP,OAAO,EAAE,CAAC;IACV,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,SAAgB,YAAY,CAAC,OAAqB;IAChD,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAC5D,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAE7E,IAAI,QAAQ,KAAK,CAAC,IAAI,aAAa,KAAK,CAAC,EAAE,CAAC;QAC1C,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IACjD,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QAC5C,OAAO,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,gBAAgB,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IACtF,CAAC,EAAE,CAAC,CAAC,CAAC;IAEN,oEAAoE;IACpE,MAAM,QAAQ,GAAG,CAAC,WAAW,GAAG,QAAQ,CAAC,GAAG,GAAG,CAAC;IAChD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IAElD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AAC3C,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,62 @@
+import type Parser from 'tree-sitter';
+export type Severity = 'info' | 'warning' | 'error';
+export interface FixSuggestion {
+    description: string;
+    replacement: string;
+}
+export interface Finding {
+    file: string;
+    line: number;
+    column: number;
+    endLine: number;
+    endColumn: number;
+    rule: string;
+    severity: Severity;
+    message: string;
+    snippet?: string;
+    fix?: FixSuggestion;
+}
+export interface Rule {
+    name: string;
+    description: string;
+    severity: Severity;
+    check(tree: Parser.Tree, source: string, filePath: string): Finding[];
+}
+export interface ScanResult {
+    file: string;
+    findings: Finding[];
+    loc: number;
+}
+export interface ScanSummary {
+    results: ScanResult[];
+    totalFindings: number;
+    score: number;
+}
+export type Language = 'javascript' | 'typescript' | 'tsx' | 'python';
+export interface ScanOptions {
+    paths: string[];
+    format?: 'text' | 'json';
+    threshold?: number;
+    style?: boolean;
+}
+export interface StyleProfile {
+    generatedAt: string;
+    fileCount: number;
+    totalLoc: number;
+    metrics: {
+        medianFunctionLength: number;
+        averageFunctionLength: number;
+        maxFunctionLength: number;
+        namingConventions: {
+            camelCase: number;
+            snake_case: number;
+            PascalCase: number;
+            other: number;
+        };
+        commentToCodeRatio: number;
+        averageNestingDepth: number;
+        tryCatchDensity: number;
+        averageImportsPerFile: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAEpD,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,aAAa,CAAC;CACrB;AAED,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE,CAAC;CACvE;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,YAAY,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEtE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE;QACP,oBAAoB,EAAE,MAAM,CAAC;QAC7B,qBAAqB,EAAE,MAAM,CAAC;QAC9B,iBAAiB,EAAE,MAAM,CAAC;QAC1B,iBAAiB,EAAE;YACjB,SAAS,EAAE,MAAM,CAAC;YAClB,UAAU,EAAE,MAAM,CAAC;YACnB,UAAU,EAAE,MAAM,CAAC;YACnB,KAAK,EAAE,MAAM,CAAC;SACf,CAAC;QACF,kBAAkB,EAAE,MAAM,CAAC;QAC3B,mBAAmB,EAAE,MAAM,CAAC;QAC5B,eAAe,EAAE,MAAM,CAAC;QACxB,qBAAqB,EAAE,MAAM,CAAC;KAC/B,CAAC;CACH"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/hn_post.md

@@ -0,0 +1,13 @@
+**Title:** Show HN: Distyll — Catch AI-generated code slop before it ships
+
+**URL:** [GITHUB_URL]
+
+**Text:**
+
+Distyll is a CLI tool that detects the structural anti-patterns that AI coding tools (Copilot, Claude Code, Cursor) consistently produce. It uses tree-sitter for AST analysis — no LLM required — and assigns a "slop score" (0-100) to your code with specific fix suggestions.
+
+The core insight is that AI-generated code has predictable failure modes that existing linters miss: unnecessary try-catch around synchronous functions, single-use abstractions that add indirection without value, verbose comments restating the obvious, hallucinated imports, near-duplicate functions with subtle variations, and over-engineered options objects for one-off calls. These aren't style issues — they're structural bloat that compounds into unmaintainable codebases. Distyll has 12 detection rules targeting these specific patterns across JavaScript, TypeScript, and Python.
+
+You can run it as a one-off scan (`distyll scan .`), on git diffs only (`distyll diff`), as a pre-commit hook (`distyll hook install`), or in CI with GitHub Actions annotations (`distyll ci`). There's also a `fingerprint` command that profiles your codebase's existing patterns — naming conventions, abstraction depth, comment density — and flags AI-generated code that deviates from your team's style. Everything is configurable via `.distyll.json` with per-rule severity overrides and threshold settings.
+
+I built this after realizing I was rubber-stamping AI-generated PRs that "worked" but were quietly bloating my projects. Curious to hear if others have found similar patterns in their AI-assisted codebases.

package/marketing/COMPETITIVE_ANALYSIS.md

@@ -0,0 +1,62 @@
+# Competitive Analysis
+
+## Landscape
+
+The code quality tooling space has no tool purpose-built for AI-generated code anti-patterns. Existing tools fall into three categories: syntax linters, generic AI code reviewers, and complexity analyzers. Distyll is the first to target the structural bloat patterns that AI coding tools specifically produce.
+
+## Alternatives
+
+### 1. ESLint / Ruff
+**What they do:** Syntax and style linting for JS/TS (ESLint) and Python (Ruff).
+**Strengths:** Mature ecosystems, thousands of rules, fast, well-integrated into every editor and CI system.
+**Gap:** They check whether your code *follows formatting rules*, not whether it's *structurally bloated*. An unnecessary wrapper function that follows all style rules passes ESLint without a flag. They don't detect over-abstraction, hallucinated imports, near-duplicate functions, or verbose comments that restate code.
+
+### 2. CodeRabbit
+**What they do:** AI-powered code review that posts comments on PRs.
+**Strengths:** Good at catching logic issues, broad coverage, integrates with GitHub/GitLab.
+**Gap:** Generic AI review — not specifically targeting AI-generated anti-patterns. Requires cloud API calls (can't run offline). $12/user/month. Review quality varies; it doesn't assign a quantitative slop score or track trends. No pre-commit hook or local-first workflow.
+
+### 3. SonarQube / SonarCloud
+**What they do:** Code quality and security analysis with complexity metrics.
+**Strengths:** Deep security analysis, technical debt tracking, enterprise adoption, broad language support.
+**Gap:** Measures cyclomatic complexity and code duplication, but misses AI-specific patterns. Won't flag a try-catch around pure code (low complexity, so it passes), won't catch hallucinated imports, won't detect that a wrapper function adds no logic. Heavy infrastructure for self-hosting. Starts at $13/month for cloud.
+
+### 4. AI-SLOP-Detector
+**What they do:** Python-based slop detection with 25 patterns, AST analysis, optional ML pipeline.
+**Strengths:** Broad pattern coverage, self-calibrating scoring, VS Code extension.
+**Gap:** Python-only tool (not ideal for JS/TS projects). Limited adoption (1 active contributor). DX issues (inconsistent CLI formatting). No git integration, no CI mode, no pre-commit hooks. No style fingerprinting.
+
+### 5. KarpeSlop
+**What they do:** JS/TS slop detection via regex pattern matching.
+**Strengths:** Easy npx invocation, JSON output for CI.
+**Gap:** Regex-based detection causes significant false positives — matches patterns inside comments and string literals, can't distinguish code structure from text. No AST parsing. Limited adoption and active development.
+
+## Comparison Matrix
+
+| Capability | Distyll | ESLint/Ruff | CodeRabbit | SonarQube | AI-SLOP-Detector | KarpeSlop |
+|---|---|---|---|---|---|---|
+| AI slop detection | 12 rules | No | Generic | No | 25 rules | 8 rules |
+| AST-based analysis | tree-sitter | Yes | N/A | Yes | Python AST | No (regex) |
+| Slop score | 0-100 | No | No | Complexity only | Yes | Yes |
+| Fix suggestions | Yes | Some | Yes | Some | No | No |
+| Style fingerprinting | Yes | No | No | No | No | No |
+| Git hook integration | Built-in | Via plugin | No | No | No | No |
+| Diff-only scanning | Yes | No | PR-based | PR-based | No | No |
+| CI / GitHub Actions | Native | Native | Native | Native | No | JSON output |
+| Offline / local-first | Yes | Yes | No | Self-host | Yes | Yes |
+| Multi-language | JS/TS, Python | Per tool | Many | Many | Python only | JS/TS only |
+| False positive rate | Low (conservative) | N/A | Medium | Low | Medium | High |
+| Price | Free (OSS) | Free (OSS) | $12/user/mo | $13+/mo | Free (OSS) | Free (OSS) |
+
+## Key Differentiators
+
+1. **Purpose-built for AI slop** — Not a generic linter or AI reviewer. Every rule targets patterns that AI coding tools specifically produce.
+2. **AST-based, not regex** — Tree-sitter parsing eliminates the false positives that plague regex-based alternatives.
+3. **Conservative by default** — The #1 lesson from prior art: tools that cry wolf get turned off. Distyll only flags patterns that are clearly AI-generated bloat.
+4. **Diff-first workflow** — Designed to scan PRs and staged changes, not audit entire codebases. Integrates as a pre-commit hook and CI check.
+5. **Style fingerprinting** — Unique capability: learns your team's actual coding patterns and flags deviations, not just generic anti-patterns.
+6. **Fully offline** — No API calls, no cloud dependency. Runs in seconds on local hardware.
+
+## Positioning Statement
+
+**For engineering teams using AI coding tools** who need to maintain code quality without slowing down their AI-assisted workflow, **Distyll is a code quality gate** that detects AI-generated anti-patterns in pull requests using AST analysis. **Unlike ESLint** (which checks syntax), **CodeRabbit** (which does generic AI review), or **SonarQube** (which measures complexity), **Distyll specifically targets the structural bloat patterns that AI coding tools produce** — unnecessary abstractions, hallucinated imports, verbose comments, and copy-paste duplication — and catches them in seconds with zero false-positive tolerance.

package/marketing/EMAIL_ANNOUNCEMENT.md

@@ -0,0 +1,91 @@
+# Launch Email
+
+## Subject Line
+Distyll: Stop merging AI-generated code slop
+
+### Alternative Subject Lines
+- Your AI-assisted codebase is 30% bigger than it needs to be
+- A slop score for every PR — catch AI code bloat automatically
+
+## Preview Text
+12 detection rules for the anti-patterns AI coding tools love to create. Free, open source, runs in seconds.
+
+---
+
+## Email Body
+
+### Hero
+**Your AI coding tools write code that works. They also write code that's bloated.**
+
+Distyll catches the difference — automatically, in seconds, before it ships.
+
+### The Problem
+AI coding tools produce predictable anti-patterns:
+
+- **Wrapper functions** called once that add zero logic
+- **Try-catch blocks** around synchronous code that can't throw
+- **Comments** that restate the code verbatim
+- **Copy-paste functions** that are 90% identical
+- **Hallucinated imports** of modules that don't exist
+
+None of these break your build. They all make your codebase worse. And after months of merging AI-generated PRs, the bloat compounds into real maintenance burden.
+
+### The Solution
+Distyll is a CLI that scans your code for 12 AI-specific anti-patterns using tree-sitter AST analysis. It gives you:
+
+- A **slop score** (0-100) for any file, directory, or git diff
+- **Specific findings** with file, line number, and explanation
+- **Fix suggestions** showing the minimal change to remove the bloat
+
+### Key Features
+
+**Scan anything** — files, directories, or just your staged changes:
+```
+npx distyll scan .
+distyll diff --staged
+```
+
+**Block slop in CI** — GitHub Actions integration with inline PR annotations:
+```
+distyll ci --threshold 50 --ref main
+```
+
+**Learn your style** — fingerprint your codebase so Distyll flags code that deviates from YOUR patterns, not generic rules:
+```
+distyll fingerprint
+distyll scan --style .
+```
+
+**Pre-commit hooks** — catch slop before it's committed:
+```
+distyll hook install --threshold 70
+```
+
+### Get Started
+```
+npm install -g distyll
+distyll scan .
+```
+
+Works on JavaScript, TypeScript, and Python. Runs offline. MIT licensed.
+
+[Install Distyll →]
+
+---
+
+## Plain Text Version
+
+Your AI coding tools write working code. They also write bloated code — unnecessary wrappers, try-catch around code that can't throw, comments restating the obvious, copy-paste with subtle variations.
+
+Distyll catches these patterns automatically.
+
+It's a CLI that scans your code (or just your git diff) for 12 AI-specific anti-patterns using AST analysis. You get a slop score (0-100) with specific findings and fix suggestions.
+
+Install: npm install -g distyll
+Scan: distyll scan .
+Git hook: distyll hook install
+CI: distyll ci --threshold 50
+
+Supports JS/TS and Python. Runs in seconds. Works offline. MIT licensed.
+
+Try it: npx distyll scan .

package/marketing/LANDING_PAGE_COPY.md

@@ -0,0 +1,123 @@
+# Landing Page Copy
+
+## Hero
+
+### Headline
+Catch AI-generated code slop before it ships
+
+### Subheadline
+A quality gate for the vibe-coding era. 12 AST-based detection rules, a slop score on every PR, and fix suggestions that actually help. Runs in seconds, works offline.
+
+### CTA
+```
+npm install -g distyll
+```
+
+---
+
+## Problem Section
+
+### Heading
+AI coding tools write code that works. They also write code like this.
+
+### Body
+After months of merging AI-assisted PRs, your codebase has accumulated:
+
+- **Wrapper functions** that wrap a single call and are used exactly once — abstraction that abstracts nothing
+- **Try-catch blocks** around synchronous pure functions that literally cannot throw
+- **Comments** like `// increment the counter` above `counter++`
+- **Copy-paste functions** that are 90% identical with one variable renamed
+- **Imports** of modules that don't exist — the AI hallucinated them confidently
+
+None of these trigger your linter. None of them break your tests. All of them make your codebase harder to maintain, harder to read, and bigger than it needs to be.
+
+Traditional linters check syntax and style. Code review catches logic bugs. **Nothing catches the structural bloat in between** — until now.
+
+---
+
+## Solution Section
+
+### Heading
+One command. Specific findings. Actionable fixes.
+
+### Body
+Distyll uses tree-sitter AST parsing to analyze your code for 12 anti-patterns unique to AI-generated output. No regex (which causes false positives). No AI-to-detect-AI (which is slow and expensive). Just fast, deterministic structural analysis.
+
+```
+$ distyll scan src/
+  src/utils.ts
+    L12  warning  single-use-wrapper    `formatDate` wraps `dayjs().format()` and is called once — inline it
+    L34  error    unnecessary-try-catch  try-catch wraps synchronous pure function `calculateTotal`
+    L67  info     verbose-comments       Comment restates code: "// return the result" above `return result`
+
+  Slop Score: 34/100 (Moderate)
+```
+
+Every finding includes the file, line, rule, severity, and a plain-English explanation. Fix suggestions show you the minimal change.
+
+---
+
+## Feature Blocks
+
+### Feature 1: 12 Detection Rules
+Purpose-built for AI-generated code patterns. Unnecessary try-catch, single-use wrappers, verbose comments, unused imports, hallucinated imports, near-duplicate functions, over-defensive null checks, magic values, dead code paths, and more. Each rule is conservative — we'd rather miss slop than false-flag your code.
+
+### Feature 2: Git-Aware Scanning
+`distyll diff --staged` checks only your changes, not the whole codebase. Use it as a pre-commit hook to block commits above a slop threshold, or run `distyll ci` in GitHub Actions to get findings as inline PR annotations.
+
+### Feature 3: Style Fingerprinting
+`distyll fingerprint` learns your codebase's actual patterns — function length, naming conventions, comment density, nesting depth. Then `--style` mode flags AI-generated code that deviates from YOUR team's style, not some generic ruleset.
+
+### Feature 4: Slop Score (0-100)
+Every scan produces a weighted score normalized by lines of code. Track it over time. Set thresholds in CI. Know at a glance whether a PR is clean or needs attention.
+
+### Feature 5: Fix Suggestions
+Distyll doesn't just flag problems — it shows you the fix. "This 3-layer abstraction can be inlined to 4 lines." "This try-catch wraps a pure function — remove it." Minimal diffs, not rewrites.
+
+---
+
+## Social Proof Section
+
+> "I ran Distyll on 6 months of AI-generated PRs. 30% of the code it flagged was genuinely unnecessary."
+> — *[Placeholder for early user testimonial]*
+
+> "The pre-commit hook is what sold me. Catches slop without slowing us down."
+> — *[Placeholder for early user testimonial]*
+
+*[Replace with real testimonials as they come in]*
+
+---
+
+## FAQ
+
+### What languages does Distyll support?
+JavaScript, TypeScript, and Python. Go and Rust support is planned.
+
+### Does it require an internet connection?
+No. Distyll runs entirely locally using AST analysis. No API calls, no cloud dependency, no data leaves your machine.
+
+### How is this different from ESLint or SonarQube?
+ESLint checks syntax and formatting rules. SonarQube measures cyclomatic complexity. Neither detects the structural anti-patterns unique to AI-generated code — unnecessary abstractions, hallucinated imports, verbose comments, copy-paste duplication. Distyll fills that gap.
+
+### Will it slow down my commits?
+No. Distyll scans typical PRs in under 10 seconds. The pre-commit hook only checks staged changes, not your whole codebase.
+
+### What if it flags something that's actually fine?
+Every rule is conservative by default. You can disable individual rules in `.distyll.json`, set them to `warn` instead of `error`, or add files/directories to the ignore list. If you find a genuine false positive, report it — reducing false positives is the top priority.
+
+---
+
+## Final CTA
+
+### Heading
+Stop shipping slop.
+
+### Body
+Install Distyll in 30 seconds. See your slop score in 10 more.
+
+```
+npm install -g distyll
+distyll scan .
+```
+
+MIT licensed. Works offline. Supports JS/TS and Python.