@promise-inc/ai-guard 0.1.0

package/README.md

@@ -0,0 +1,141 @@
+# @promise-inc/ai-guard
+
+Detect AI-generated code patterns before commit/push. Not a linter — a guard.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/promise-inc/ai-guard/main/assets/demo.svg" alt="ai-guard CLI output demo" width="680" />
+</p>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/promise-inc/ai-guard/main/assets/usage.svg" alt="ai-guard config example" width="680" />
+</p>
+
+## Why?
+
+AI tools generate code that works but often carries patterns that degrade codebases over time:
+
+- Excessive comments that restate the obvious
+- Generic variable names (`data`, `result`, `item`)
+- Functions that are way too large
+- `// Step 1:` style comments
+- Verbose JSDoc blocks with no real information
+
+`ai-guard` catches these patterns **before they reach your codebase**.
+
+## Install
+
+```bash
+npm install @promise-inc/ai-guard --save-dev
+```
+
+## Usage
+
+```bash
+# Analyze the entire project
+npx ai-guard
+
+# Analyze only staged files (for pre-commit hooks)
+npx ai-guard --staged
+```
+
+### As a Git Hook
+
+```json
+{
+  "husky": {
+    "hooks": {
+      "pre-push": "ai-guard"
+    }
+  }
+}
+```
+
+Or with `lint-staged`:
+
+```json
+{
+  "lint-staged": {
+    "*.{ts,tsx,js,jsx}": "ai-guard --staged"
+  }
+}
+```
+
+## Rules
+
+| Rule | What it detects | Severity |
+|------|----------------|----------|
+| `excessive-comments` | Files where comment ratio exceeds threshold | error |
+| `obvious-comments` | Redundant comments like `// Initialize the result` | warning |
+| `generic-names` | Variables/functions named `data`, `result`, `item`, etc. | warning |
+| `large-functions` | Functions exceeding the line limit | error |
+| `ai-patterns` | `// Step 1:`, `// Helper function`, verbose JSDoc, forbidden text patterns | warning/error |
+
+## Configuration
+
+Create `ai-guard.config.ts`, `ai-guard.config.js`, or add an `ai-guard` field to `package.json`:
+
+```ts
+export default {
+  maxCommentsRatio: 0.15,
+  maxFunctionLines: 60,
+  forbidGenericNames: ["data", "result", "item", "value", "temp"],
+  aiPatterns: {
+    forbid: [
+      "this function",
+      "the purpose of",
+      "we will",
+      "this method",
+      "note that",
+    ],
+  },
+  include: ["**/*.ts", "**/*.tsx"],
+  exclude: ["node_modules/**", "dist/**", "**/*.test.*"],
+};
+```
+
+### Config Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `maxCommentsRatio` | `number` | `0.15` | Max ratio of comment lines to total lines |
+| `maxFunctionLines` | `number` | `60` | Max lines per function/method |
+| `forbidGenericNames` | `string[]` | `["data", "result", ...]` | Banned variable/function names |
+| `aiPatterns.forbid` | `string[]` | `["this function", ...]` | Forbidden phrases in comments |
+| `include` | `string[]` | `["**/*.ts", "**/*.tsx", ...]` | File patterns to analyze |
+| `exclude` | `string[]` | `["node_modules/**", ...]` | File patterns to skip |
+
+## Programmatic API
+
+```ts
+import { analyzeProject, loadConfig } from '@promise-inc/ai-guard';
+
+const config = await loadConfig(process.cwd());
+const analysis = await analyzeProject(process.cwd(), config);
+
+console.log(analysis.passed); // true | false
+console.log(analysis.totalViolations); // number
+```
+
+## Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| `0` | All files passed |
+| `1` | Violations found |
+| `2` | Internal error |
+
+## Design Principles
+
+- **Fast** — AST-based analysis, no network calls
+- **Deterministic** — Same input always produces same output
+- **CI-friendly** — Exit codes, no interactive prompts
+- **Zero external dependencies** — Only `ts-morph` for AST parsing
+- **Not a linter** — Focused exclusively on AI-generated code patterns
+
+## License
+
+MIT
+
+---
+
+Developed by [Promise Inc.](https://promise.codes)

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const config_1 = require("./config");
+const engine_1 = require("./engine");
+const files_1 = require("./utils/files");
+const output_1 = require("./utils/output");
+async function main() {
+    const args = process.argv.slice(2);
+    const staged = args.includes('--staged');
+    const cwd = process.cwd();
+    const config = await (0, config_1.loadConfig)(cwd);
+    let stagedFiles;
+    if (staged) {
+        stagedFiles = await (0, files_1.getStagedFiles)();
+        if (stagedFiles.length === 0) {
+            console.log('\nai-guard: No staged files to analyze.\n');
+            process.exit(0);
+        }
+    }
+    const analysis = await (0, engine_1.analyzeProject)(cwd, config, stagedFiles);
+    console.log((0, output_1.formatResult)(analysis));
+    process.exit(analysis.passed ? 0 : 1);
+}
+main().catch((err) => {
+    console.error('ai-guard error:', err);
+    process.exit(2);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;AAEA,qCAAsC;AACtC,qCAA0C;AAC1C,yCAA+C;AAC/C,2CAA8C;AAE9C,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAE1B,MAAM,MAAM,GAAG,MAAM,IAAA,mBAAU,EAAC,GAAG,CAAC,CAAC;IAErC,IAAI,WAAiC,CAAC;IACtC,IAAI,MAAM,EAAE,CAAC;QACX,WAAW,GAAG,MAAM,IAAA,sBAAc,GAAE,CAAC;QACrC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;YACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,IAAA,uBAAc,EAAC,GAAG,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAEhE,OAAO,CAAC,GAAG,CAAC,IAAA,qBAAY,EAAC,QAAQ,CAAC,CAAC,CAAC;IAEpC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACxC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,OAAO,CAAC,KAAK,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;IACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,3 @@
+import { AiGuardConfig } from './types';
+export declare function loadConfig(cwd?: string): Promise<AiGuardConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAkB,MAAM,SAAS,CAAC;AAgDxD,wBAAsB,UAAU,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,aAAa,CAAC,CAYpF"}

package/dist/config.js

@@ -0,0 +1,103 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = loadConfig;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const types_1 = require("./types");
+const CONFIG_FILES = [
+    'ai-guard.config.ts',
+    'ai-guard.config.js',
+];
+async function fileExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function loadFromPackageJson(cwd) {
+    const pkgPath = path.join(cwd, 'package.json');
+    if (!(await fileExists(pkgPath)))
+        return null;
+    const content = await fs.readFile(pkgPath, 'utf-8');
+    const pkg = JSON.parse(content);
+    return pkg['ai-guard'] ?? null;
+}
+async function loadFromConfigFile(cwd) {
+    for (const configFile of CONFIG_FILES) {
+        const configPath = path.join(cwd, configFile);
+        if (await fileExists(configPath)) {
+            const absolutePath = path.resolve(configPath);
+            if (configFile.endsWith('.ts')) {
+                try {
+                    require('ts-node/register/transpile-only');
+                }
+                catch {
+                    // ts-node not available — skip .ts config
+                    continue;
+                }
+            }
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const mod = require(absolutePath);
+            return mod.default ?? mod;
+        }
+    }
+    return null;
+}
+async function loadConfig(cwd = process.cwd()) {
+    const fromFile = await loadFromConfigFile(cwd);
+    if (fromFile) {
+        return mergeConfig(fromFile);
+    }
+    const fromPkg = await loadFromPackageJson(cwd);
+    if (fromPkg) {
+        return mergeConfig(fromPkg);
+    }
+    return { ...types_1.DEFAULT_CONFIG };
+}
+function mergeConfig(partial) {
+    return {
+        ...types_1.DEFAULT_CONFIG,
+        ...partial,
+        aiPatterns: {
+            ...types_1.DEFAULT_CONFIG.aiPatterns,
+            ...partial.aiPatterns,
+        },
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkDA,gCAYC;AA9DD,gDAAkC;AAClC,2CAA6B;AAC7B,mCAAwD;AAExD,MAAM,YAAY,GAAG;IACnB,oBAAoB;IACpB,oBAAoB;CACrB,CAAC;AAEF,KAAK,UAAU,UAAU,CAAC,QAAgB;IACxC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,GAAW;IAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAC/C,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAE9C,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChC,OAAO,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;AACjC,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,GAAW;IAC3C,KAAK,MAAM,UAAU,IAAI,YAAY,EAAE,CAAC;QACtC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAC9C,IAAI,MAAM,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YACjC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAE9C,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC/B,IAAI,CAAC;oBACH,OAAO,CAAC,iCAAiC,CAAC,CAAC;gBAC7C,CAAC;gBAAC,MAAM,CAAC;oBACP,0CAA0C;oBAC1C,SAAS;gBACX,CAAC;YACH,CAAC;YAED,iEAAiE;YACjE,MAAM,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;YAClC,OAAO,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC;QAC5B,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAEM,KAAK,UAAU,UAAU,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IAC1D,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAC/C,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAC/C,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,EAAE,GAAG,sBAAc,EAAE,CAAC;AAC/B,CAAC;AAED,SAAS,WAAW,CAAC,OAA+B;IAClD,OAAO;QACL,GAAG,sBAAc;QACjB,GAAG,OAAO;QACV,UAAU,EAAE;YACV,GAAG,sBAAc,CAAC,UAAU;YAC5B,GAAG,OAAO,CAAC,UAAU;SACtB;KACF,CAAC;AACJ,CAAC"}

package/dist/engine.d.ts

@@ -0,0 +1,3 @@
+import { AiGuardConfig, AnalysisResult } from './types';
+export declare function analyzeProject(cwd: string, config: AiGuardConfig, stagedFiles?: string[]): Promise<AnalysisResult>;
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAgB,MAAM,SAAS,CAAC;AAItE,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,aAAa,EACrB,WAAW,CAAC,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,cAAc,CAAC,CAoCzB"}

package/dist/engine.js

@@ -0,0 +1,74 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzeProject = analyzeProject;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const rules_1 = require("./rules");
+const files_1 = require("./utils/files");
+async function analyzeProject(cwd, config, stagedFiles) {
+    const files = stagedFiles ?? await (0, files_1.resolveFiles)(cwd, config);
+    const results = [];
+    for (const file of files) {
+        const absolutePath = path.isAbsolute(file) ? file : path.join(cwd, file);
+        try {
+            await fs.access(absolutePath);
+        }
+        catch {
+            continue;
+        }
+        const violations = rules_1.ALL_RULES.flatMap((rule) => {
+            try {
+                return rule.analyze(absolutePath, config);
+            }
+            catch {
+                return [];
+            }
+        });
+        if (violations.length > 0) {
+            results.push({
+                filePath: path.relative(cwd, absolutePath),
+                violations,
+            });
+        }
+    }
+    const totalViolations = results.reduce((sum, r) => sum + r.violations.length, 0);
+    return {
+        files: results,
+        totalViolations,
+        passed: totalViolations === 0,
+    };
+}
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMA,wCAwCC;AA9CD,gDAAkC;AAClC,2CAA6B;AAE7B,mCAAoC;AACpC,yCAA6C;AAEtC,KAAK,UAAU,cAAc,CAClC,GAAW,EACX,MAAqB,EACrB,WAAsB;IAEtB,MAAM,KAAK,GAAG,WAAW,IAAI,MAAM,IAAA,oBAAY,EAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAmB,EAAE,CAAC;IAEnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAEzE,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QAED,MAAM,UAAU,GAAG,iBAAS,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;YAC5C,IAAI,CAAC;gBACH,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;YAC5C,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,IAAI,CAAC;gBACX,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC;gBAC1C,UAAU;aACX,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAEjF,OAAO;QACL,KAAK,EAAE,OAAO;QACd,eAAe;QACf,MAAM,EAAE,eAAe,KAAK,CAAC;KAC9B,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { loadConfig } from './config';
+export { analyzeProject } from './engine';
+export { ALL_RULES } from './rules';
+export type { AiGuardConfig, Violation, FileAnalysis, AnalysisResult, Rule, } from './types';
+export { DEFAULT_CONFIG } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,YAAY,EACV,aAAa,EACb,SAAS,EACT,YAAY,EACZ,cAAc,EACd,IAAI,GACL,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CONFIG = exports.ALL_RULES = exports.analyzeProject = exports.loadConfig = void 0;
+var config_1 = require("./config");
+Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return config_1.loadConfig; } });
+var engine_1 = require("./engine");
+Object.defineProperty(exports, "analyzeProject", { enumerable: true, get: function () { return engine_1.analyzeProject; } });
+var rules_1 = require("./rules");
+Object.defineProperty(exports, "ALL_RULES", { enumerable: true, get: function () { return rules_1.ALL_RULES; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "DEFAULT_CONFIG", { enumerable: true, get: function () { return types_1.DEFAULT_CONFIG; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAAsC;AAA7B,oGAAA,UAAU,OAAA;AACnB,mCAA0C;AAAjC,wGAAA,cAAc,OAAA;AACvB,iCAAoC;AAA3B,kGAAA,SAAS,OAAA;AAQlB,iCAAyC;AAAhC,uGAAA,cAAc,OAAA"}

package/dist/rules/ai-patterns.d.ts

@@ -0,0 +1,5 @@
+import { AiGuardConfig, Violation } from '../types';
+export declare const name = "ai-patterns";
+export declare const description = "Detects textual patterns commonly found in AI-generated code";
+export declare function analyze(filePath: string, config: AiGuardConfig): Violation[];
+//# sourceMappingURL=ai-patterns.d.ts.map

package/dist/rules/ai-patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-patterns.d.ts","sourceRoot":"","sources":["../../src/rules/ai-patterns.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEpD,eAAO,MAAM,IAAI,gBAAgB,CAAC;AAClC,eAAO,MAAM,WAAW,iEAAiE,CAAC;AAkD1F,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,SAAS,EAAE,CAQ5E"}

package/dist/rules/ai-patterns.js

@@ -0,0 +1,94 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.description = exports.name = void 0;
+exports.analyze = analyze;
+const fs = __importStar(require("fs"));
+exports.name = 'ai-patterns';
+exports.description = 'Detects textual patterns commonly found in AI-generated code';
+const CODE_AI_PATTERNS = [
+    /\/\/\s*Step\s+\d+/i,
+    /\/\/\s*-{3,}/,
+    /\/\/\s*={3,}/,
+    /\/\/\s*#{3,}/,
+    /\/\*\*[\s\S]*?@description\s+This\s+(function|method|class)/i,
+    /\/\/\s*Helper\s+(function|method)\s+/i,
+    /\/\/\s*Utility\s+(function|method)\s+/i,
+    /\/\/\s*Main\s+(function|logic)\s+/i,
+];
+function findCodePatterns(lines, filePath) {
+    const violations = [];
+    for (let i = 0; i < lines.length; i++) {
+        for (const pattern of CODE_AI_PATTERNS) {
+            if (pattern.test(lines[i])) {
+                violations.push({
+                    rule: exports.name,
+                    file: filePath,
+                    message: `AI-generated pattern detected: "${lines[i].trim()}"`,
+                    line: i + 1,
+                    severity: 'warning',
+                });
+                break;
+            }
+        }
+    }
+    return violations;
+}
+function findVerboseJsDoc(content, filePath) {
+    const blocks = content.match(/\/\*\*[\s\S]*?\*\//g) ?? [];
+    return blocks
+        .filter((block) => {
+        const lineCount = block.split('\n').length;
+        const hasOnlyBasicTags = /\*\s*@(param|returns|description)\s/.test(block) &&
+            !/@(throws|example|deprecated|see|link)/.test(block);
+        return lineCount > 8 && hasOnlyBasicTags;
+    })
+        .map((block) => ({
+        rule: exports.name,
+        file: filePath,
+        message: `Overly verbose JSDoc (${block.split('\n').length} lines)`,
+        line: content.substring(0, content.indexOf(block)).split('\n').length,
+        severity: 'warning',
+    }));
+}
+function analyze(filePath, config) {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const lines = content.split('\n');
+    return [
+        ...findCodePatterns(lines, filePath),
+        ...findVerboseJsDoc(content, filePath),
+    ];
+}
+//# sourceMappingURL=ai-patterns.js.map

package/dist/rules/ai-patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-patterns.js","sourceRoot":"","sources":["../../src/rules/ai-patterns.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsDA,0BAQC;AA9DD,uCAAyB;AAGZ,QAAA,IAAI,GAAG,aAAa,CAAC;AACrB,QAAA,WAAW,GAAG,8DAA8D,CAAC;AAE1F,MAAM,gBAAgB,GAAG;IACvB,oBAAoB;IACpB,cAAc;IACd,cAAc;IACd,cAAc;IACd,8DAA8D;IAC9D,uCAAuC;IACvC,wCAAwC;IACxC,oCAAoC;CACrC,CAAC;AAEF,SAAS,gBAAgB,CAAC,KAAe,EAAE,QAAgB;IACzD,MAAM,UAAU,GAAgB,EAAE,CAAC;IACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,KAAK,MAAM,OAAO,IAAI,gBAAgB,EAAE,CAAC;YACvC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3B,UAAU,CAAC,IAAI,CAAC;oBACd,IAAI,EAAE,YAAI;oBACV,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,mCAAmC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG;oBAC9D,IAAI,EAAE,CAAC,GAAG,CAAC;oBACX,QAAQ,EAAE,SAAS;iBACpB,CAAC,CAAC;gBACH,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAe,EAAE,QAAgB;IACzD,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,qBAAqB,CAAC,IAAI,EAAE,CAAC;IAC1D,OAAO,MAAM;SACV,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;QAChB,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QAC3C,MAAM,gBAAgB,GAAG,qCAAqC,CAAC,IAAI,CAAC,KAAK,CAAC;YACxE,CAAC,uCAAuC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvD,OAAO,SAAS,GAAG,CAAC,IAAI,gBAAgB,CAAC;IAC3C,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACf,IAAI,EAAE,YAAI;QACV,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,yBAAyB,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,SAAS;QACnE,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM;QACrE,QAAQ,EAAE,SAAkB;KAC7B,CAAC,CAAC,CAAC;AACR,CAAC;AAED,SAAgB,OAAO,CAAC,QAAgB,EAAE,MAAqB;IAC7D,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAElC,OAAO;QACL,GAAG,gBAAgB,CAAC,KAAK,EAAE,QAAQ,CAAC;QACpC,GAAG,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC;KACvC,CAAC;AACJ,CAAC"}

package/dist/rules/excessive-comments.d.ts

@@ -0,0 +1,5 @@
+import { AiGuardConfig, Violation } from '../types';
+export declare const name = "excessive-comments";
+export declare const description = "Detects files with too many comments relative to code";
+export declare function analyze(filePath: string, config: AiGuardConfig): Violation[];
+//# sourceMappingURL=excessive-comments.d.ts.map

package/dist/rules/excessive-comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"excessive-comments.d.ts","sourceRoot":"","sources":["../../src/rules/excessive-comments.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEpD,eAAO,MAAM,IAAI,uBAAuB,CAAC;AACzC,eAAO,MAAM,WAAW,0DAA0D,CAAC;AAEnF,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,SAAS,EAAE,CAuC5E"}

package/dist/rules/excessive-comments.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.description = exports.name = void 0;
+exports.analyze = analyze;
+const ts_morph_1 = require("ts-morph");
+exports.name = 'excessive-comments';
+exports.description = 'Detects files with too many comments relative to code';
+function analyze(filePath, config) {
+    const project = new ts_morph_1.Project({ skipAddingFilesFromTsConfig: true });
+    const sourceFile = project.addSourceFileAtPath(filePath);
+    const fullText = sourceFile.getFullText();
+    const lines = fullText.split('\n');
+    const totalLines = lines.filter((l) => l.trim().length > 0).length;
+    if (totalLines === 0)
+        return [];
+    let commentLines = 0;
+    // Count single-line comments
+    const leadingCommentRanges = sourceFile.getDescendantsOfKind(
+    // SyntaxKind values for comments aren't directly available via getDescendantsOfKind
+    // We'll use regex on the full text instead
+    0);
+    void leadingCommentRanges;
+    // Regex-based counting (more reliable for comment ratio)
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith('//') || trimmed.startsWith('*') || trimmed.startsWith('/*') || trimmed.startsWith('*/')) {
+            commentLines++;
+        }
+    }
+    const ratio = commentLines / totalLines;
+    if (ratio > config.maxCommentsRatio) {
+        return [{
+                rule: exports.name,
+                file: filePath,
+                message: `Excessive comments (${Math.round(ratio * 100)}% — max ${Math.round(config.maxCommentsRatio * 100)}%)`,
+                severity: 'error',
+            }];
+    }
+    return [];
+}
+//# sourceMappingURL=excessive-comments.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"excessive-comments.js","sourceRoot":"","sources":["../../src/rules/excessive-comments.ts"],"names":[],"mappings":";;;AAMA,0BAuCC;AA7CD,uCAAmC;AAGtB,QAAA,IAAI,GAAG,oBAAoB,CAAC;AAC5B,QAAA,WAAW,GAAG,uDAAuD,CAAC;AAEnF,SAAgB,OAAO,CAAC,QAAgB,EAAE,MAAqB;IAC7D,MAAM,OAAO,GAAG,IAAI,kBAAO,CAAC,EAAE,2BAA2B,EAAE,IAAI,EAAE,CAAC,CAAC;IACnE,MAAM,UAAU,GAAG,OAAO,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;IAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;IAEnE,IAAI,UAAU,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEhC,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,6BAA6B;IAC7B,MAAM,oBAAoB,GAAG,UAAU,CAAC,oBAAoB;IAC1D,oFAAoF;IACpF,2CAA2C;IAC3C,CAAC,CACF,CAAC;IACF,KAAK,oBAAoB,CAAC;IAE1B,yDAAyD;IACzD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAChH,YAAY,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,YAAY,GAAG,UAAU,CAAC;IAExC,IAAI,KAAK,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC;QACpC,OAAO,CAAC;gBACN,IAAI,EAAE,YAAI;gBACV,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,uBAAuB,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,WAAW,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,gBAAgB,GAAG,GAAG,CAAC,IAAI;gBAC/G,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/rules/generic-names.d.ts

@@ -0,0 +1,5 @@
+import { AiGuardConfig, Violation } from '../types';
+export declare const name = "generic-names";
+export declare const description = "Detects generic variable/function names typical of AI-generated code";
+export declare function analyze(filePath: string, config: AiGuardConfig): Violation[];
+//# sourceMappingURL=generic-names.d.ts.map

package/dist/rules/generic-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-names.d.ts","sourceRoot":"","sources":["../../src/rules/generic-names.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEpD,eAAO,MAAM,IAAI,kBAAkB,CAAC;AACpC,eAAO,MAAM,WAAW,yEAAyE,CAAC;AAElG,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,SAAS,EAAE,CA0D5E"}