@pqqqqqdev/agent-context-lint 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 agent-context-lint contributors
+
+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

@@ -0,0 +1,174 @@
+# agent-context-lint
+
+A command-line linter that audits AI coding-agent context and instruction files for repositories.
+
+It helps maintainers reduce:
+- Token bloat
+- Duplicated instructions
+- Vague agent instructions ("make it better", "use best practices", etc.)
+- Missing project commands (install, test, lint)
+- Dangerous shell commands suggested to agents (recursive force-removal, privilege escalation, shell-piped downloads, etc.)
+
+**No web UI. No React. Just a fast, focused CLI.**
+
+## Supported Files
+
+- `AGENTS.md`
+- `CLAUDE.md`
+- `.cursorrules`
+- `.windsurfrules`
+- `.github/copilot-instructions.md`
+- `README.md`
+- `docs/**/*.md`
+
+## Installation
+
+```bash
+# Global (recommended for daily use)
+npm install -g @pqqqqqdev/agent-context-lint
+
+# Or use npx (no install)
+npx @pqqqqqdev/agent-context-lint .
+
+# Local dev install
+npm install --save-dev @pqqqqqdev/agent-context-lint
+```
+
+## Usage
+
+```bash
+# Lint current directory
+agent-context-lint .
+
+# Lint a specific repo
+agent-context-lint /path/to/repo
+
+# JSON output (for CI, scripts, or piping)
+agent-context-lint . --json
+
+# Custom token budget (error threshold)
+agent-context-lint . --max-tokens 2000
+
+# Help
+agent-context-lint --help
+```
+
+## CLI Options
+
+| Option            | Description                                      |
+|-------------------|--------------------------------------------------|
+| `[path]`          | Directory to scan (default: `.`)                 |
+| `--json`          | Emit machine-readable JSON instead of text       |
+| `--max-tokens N`  | Override error threshold (default 3000). Warning threshold adapts to min(1500, N/2) |
+| `--help`, `-h`    | Show help                                        |
+| `--version`, `-v` | Show version                                     |
+
+## Exit Codes
+
+- `0` — Success (no errors). Warnings are acceptable.
+- `1` — One or more **errors** were found.
+
+## Example Output (Human Readable)
+
+```
+agent-context-lint: scanned 2 file(s) in /Users/dev/my-repo
+Total estimated tokens: 8724
+Errors: 2  Warnings: 5
+
+📄 AGENTS.md (6840 tokens)
+  ❌ [token-budget] File exceeds maximum token budget: 6840 tokens (limit: 3000)
+  ❌ [dangerous-commands] Dangerous shell command detected: [forceful recursive removal] (line 12)
+    > [example: destructive removal command]
+  ⚠️ [vague-instructions] Vague instruction detected: "make it better" (line 4)
+    > Always make it better when you touch code.
+  ⚠️ [duplicate-lines] Duplicated line appears 3 times (lines 19, 27, 41)
+    > Always run the tests.
+
+📄 README.md (1884 tokens)
+  ⚠️ [token-budget] File is large: 1884 tokens (warning threshold: 1500)
+  ⚠️ [missing-commands] No lint command or linting instructions detected
+
+Scan failed with errors. Fix the issues above.
+```
+
+## Example JSON Output
+
+```json
+{
+  "targetDir": "/Users/dev/my-repo",
+  "totalTokens": 8724,
+  "errorCount": 2,
+  "warningCount": 5,
+  "files": [
+    {
+      "relativePath": "AGENTS.md",
+      "tokenCount": 6840,
+      "findings": [
+        {
+          "type": "error",
+          "rule": "token-budget",
+          "message": "File exceeds maximum token budget: 6840 tokens (limit: 3000)"
+        }
+      ]
+    }
+  ]
+}
+```
+
+## Rules
+
+| Rule                | Severity          | Description |
+|---------------------|-------------------|-------------|
+| `token-budget`      | warning / error   | Warn >1500 tokens, error >3000 (or `--max-tokens`) |
+| `duplicate-lines`   | warning           | Repeated non-blank lines inside the same file |
+| `vague-instructions`| warning           | Phrases like "make it better", "fix everything", "be careful", "use best practices", "clean code", "improve this", "handle edge cases" |
+| `dangerous-commands`| error             | forceful recursive removal, world-writable permissions, shell-piped downloads, privilege escalation |
+| `missing-commands`  | warning           | No recognizable install, test, or lint instructions |
+
+## Examples
+
+See the `examples/` directory:
+
+- `examples/bloated-AGENTS.md` — triggers many rules
+- `examples/clean-AGENTS.md` — minimal good example
+
+Run against the examples (the files use demo names, so copy/rename first or run from a temp dir):
+
+```bash
+# Example of testing the bloated case
+mkdir -p /tmp/bloated-demo && cp examples/bloated-AGENTS.md /tmp/bloated-demo/AGENTS.md
+agent-context-lint /tmp/bloated-demo
+# (manually remove /tmp/bloated-demo afterward)
+```
+
+## Why This Exists
+
+AI coding agents (Cursor, Claude, Copilot, Windsurf, etc.) are powerful, but their instruction files often grow out of control. Large, repetitive, or vague context wastes tokens and leads to poor or unsafe suggestions.
+
+`agent-context-lint` gives maintainers an easy, automated way to keep these files healthy.
+
+## Development
+
+```bash
+git clone https://github.com/yourusername/agent-context-lint.git
+cd agent-context-lint
+npm install
+npm run build
+npm test
+```
+
+To test the CLI against the source without global install:
+
+```bash
+npm run build
+node dist/cli.js .
+```
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## License
+
+MIT
+

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,122 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_1 = require("./index");
+const reporter_1 = require("./reporter");
+function printHelp() {
+    console.log(`agent-context-lint - Lint AI agent context/instruction files
+
+Usage:
+  agent-context-lint [path] [options]
+
+Arguments:
+  path                 Directory to scan (default: current directory ".")
+
+Options:
+  --json               Output results as JSON
+  --max-tokens <N>     Set custom max token threshold for errors (default: 3000)
+  --help, -h           Show this help
+  --version, -v        Show version
+
+Exit codes:
+  0  No errors found (warnings are allowed)
+  1  One or more errors found
+
+Examples:
+  agent-context-lint .
+  agent-context-lint ./my-repo --json
+  agent-context-lint . --max-tokens 2000
+`);
+}
+function printVersion() {
+    // Read from package.json at runtime
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const pkg = require('../package.json');
+        console.log(pkg.version || '0.0.0');
+    }
+    catch {
+        console.log('0.1.0');
+    }
+}
+function parseArgs(argv) {
+    const args = argv.slice(2);
+    let target = '.';
+    const options = {};
+    let help = false;
+    let version = false;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--help' || arg === '-h') {
+            help = true;
+        }
+        else if (arg === '--version' || arg === '-v') {
+            version = true;
+        }
+        else if (arg === '--json') {
+            options.json = true;
+        }
+        else if (arg === '--max-tokens') {
+            const next = args[i + 1];
+            if (next && !next.startsWith('-')) {
+                const n = parseInt(next, 10);
+                if (!isNaN(n) && n > 0) {
+                    options.maxTokens = n;
+                }
+                else {
+                    console.error('Error: --max-tokens expects a positive integer');
+                    process.exit(1);
+                }
+                i++;
+            }
+            else {
+                console.error('Error: --max-tokens requires a value');
+                process.exit(1);
+            }
+        }
+        else if (!arg.startsWith('-')) {
+            // positional target dir, take first
+            if (target === '.') {
+                target = arg;
+            }
+        }
+        else {
+            console.error(`Unknown option: ${arg}`);
+            process.exit(1);
+        }
+    }
+    return { target, options, help, version };
+}
+function main() {
+    const { target, options, help, version } = parseArgs(process.argv);
+    if (help) {
+        printHelp();
+        process.exit(0);
+    }
+    if (version) {
+        printVersion();
+        process.exit(0);
+    }
+    try {
+        const result = (0, index_1.lintDirectory)(target, options);
+        if (options.json) {
+            console.log((0, reporter_1.formatJson)(result));
+        }
+        else {
+            console.log((0, reporter_1.formatHumanReadable)(result));
+        }
+        // Exit code: 1 only on errors (warnings ok)
+        if (result.errorCount > 0) {
+            process.exit(1);
+        }
+        else {
+            process.exit(0);
+        }
+    }
+    catch (err) {
+        console.error('Unexpected error:', err?.message || err);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import { LintOptions, LintResult } from './types';
+export declare function lintDirectory(targetDir: string, options?: LintOptions): LintResult;
+//# 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":"AAEA,OAAO,EAAc,WAAW,EAAE,UAAU,EAAW,MAAM,SAAS,CAAC;AA2BvE,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,UAAU,CAsCtF"}

package/dist/index.js

@@ -0,0 +1,92 @@
+"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.lintDirectory = lintDirectory;
+const path = __importStar(require("path"));
+const scanner_1 = require("./scanner");
+const tokenBudget_1 = require("./rules/tokenBudget");
+const duplicateLines_1 = require("./rules/duplicateLines");
+const vagueInstructions_1 = require("./rules/vagueInstructions");
+const dangerousCommands_1 = require("./rules/dangerousCommands");
+const missingCommands_1 = require("./rules/missingCommands");
+function applyRulesToFile(report, content, options) {
+    const findings = [];
+    // token budget: pass maxTokens as errorThreshold
+    const tokenOpts = {};
+    if (options.maxTokens != null) {
+        tokenOpts.errorThreshold = options.maxTokens;
+        // keep warn at 1500 or use half of max if smaller
+        tokenOpts.warnThreshold = Math.min(1500, Math.floor(options.maxTokens / 2));
+    }
+    findings.push(...(0, tokenBudget_1.checkTokenBudget)(content, tokenOpts));
+    findings.push(...(0, duplicateLines_1.checkDuplicateLines)(content));
+    findings.push(...(0, vagueInstructions_1.checkVagueInstructions)(content));
+    findings.push(...(0, dangerousCommands_1.checkDangerousCommands)(content));
+    findings.push(...(0, missingCommands_1.checkMissingCommands)(content));
+    return findings;
+}
+function lintDirectory(targetDir, options = {}) {
+    const absDir = path.resolve(targetDir);
+    const fileReports = (0, scanner_1.scanDirectory)(absDir);
+    let totalTokens = 0;
+    let errorCount = 0;
+    let warningCount = 0;
+    const processedFiles = [];
+    for (const report of fileReports) {
+        const content = (0, scanner_1.readFileContent)(report.filePath);
+        const findings = applyRulesToFile(report, content, options);
+        // attach
+        const updated = {
+            ...report,
+            findings,
+        };
+        processedFiles.push(updated);
+        totalTokens += updated.tokenCount;
+        for (const f of findings) {
+            if (f.type === 'error')
+                errorCount++;
+            else
+                warningCount++;
+        }
+    }
+    return {
+        files: processedFiles,
+        totalTokens,
+        errorCount,
+        warningCount,
+        targetDir: absDir,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,sCAsCC;AAnED,2CAA6B;AAC7B,uCAA2E;AAE3E,qDAAuD;AACvD,2DAA6D;AAC7D,iEAAmE;AACnE,iEAAmE;AACnE,6DAA+D;AAE/D,SAAS,gBAAgB,CAAC,MAAkB,EAAE,OAAe,EAAE,OAAoB;IACjF,MAAM,QAAQ,GAAc,EAAE,CAAC;IAE/B,iDAAiD;IACjD,MAAM,SAAS,GAAwD,EAAE,CAAC;IAC1E,IAAI,OAAO,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC;QAC9B,SAAS,CAAC,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;QAC7C,kDAAkD;QAClD,SAAS,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9E,CAAC;IACD,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAA,8BAAgB,EAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;IAEvD,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAA,oCAAmB,EAAC,OAAO,CAAC,CAAC,CAAC;IAC/C,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAA,0CAAsB,EAAC,OAAO,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAA,0CAAsB,EAAC,OAAO,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAA,sCAAoB,EAAC,OAAO,CAAC,CAAC,CAAC;IAEhD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAgB,aAAa,CAAC,SAAiB,EAAE,UAAuB,EAAE;IACxE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEvC,MAAM,WAAW,GAAG,IAAA,uBAAa,EAAC,MAAM,CAAC,CAAC;IAE1C,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,MAAM,cAAc,GAAiB,EAAE,CAAC;IAExC,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,IAAA,yBAAe,EAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAE5D,SAAS;QACT,MAAM,OAAO,GAAe;YAC1B,GAAG,MAAM;YACT,QAAQ;SACT,CAAC;QAEF,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAE7B,WAAW,IAAI,OAAO,CAAC,UAAU,CAAC;QAElC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO;gBAAE,UAAU,EAAE,CAAC;;gBAChC,YAAY,EAAE,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,cAAc;QACrB,WAAW;QACX,UAAU;QACV,YAAY;QACZ,SAAS,EAAE,MAAM;KAClB,CAAC;AACJ,CAAC"}

package/dist/reporter.d.ts

@@ -0,0 +1,4 @@
+import { LintResult } from './types';
+export declare function formatHumanReadable(result: LintResult): string;
+export declare function formatJson(result: LintResult): string;
+//# sourceMappingURL=reporter.d.ts.map

package/dist/reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../src/reporter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,UAAU,EAAW,MAAM,SAAS,CAAC;AAc1D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAsC9D;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAmBrD"}

package/dist/reporter.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatHumanReadable = formatHumanReadable;
+exports.formatJson = formatJson;
+function formatFinding(f) {
+    const icon = f.type === 'error' ? '❌' : '⚠️';
+    let out = `  ${icon} [${f.rule}] ${f.message}`;
+    if (f.line != null) {
+        out += ` (line ${f.line})`;
+    }
+    if (f.snippet) {
+        out += `\n    > ${f.snippet}`;
+    }
+    return out;
+}
+function formatHumanReadable(result) {
+    const lines = [];
+    lines.push(`agent-context-lint: scanned ${result.files.length} file(s) in ${result.targetDir}`);
+    lines.push(`Total estimated tokens: ${result.totalTokens}`);
+    lines.push(`Errors: ${result.errorCount}  Warnings: ${result.warningCount}`);
+    lines.push('');
+    if (result.files.length === 0) {
+        lines.push('No supported context/instruction files found.');
+        lines.push('');
+        return lines.join('\n');
+    }
+    for (const file of result.files) {
+        const rel = file.relativePath;
+        const tokenInfo = `${file.tokenCount} tokens`;
+        lines.push(`📄 ${rel} (${tokenInfo})`);
+        if (file.findings.length === 0) {
+            lines.push('  ✅ No issues found');
+        }
+        else {
+            for (const f of file.findings) {
+                lines.push(formatFinding(f));
+            }
+        }
+        lines.push('');
+    }
+    if (result.errorCount > 0) {
+        lines.push('Scan failed with errors. Fix the issues above.');
+    }
+    else if (result.warningCount > 0) {
+        lines.push('Scan completed with warnings.');
+    }
+    else {
+        lines.push('All clear. Good job!');
+    }
+    return lines.join('\n');
+}
+function formatJson(result) {
+    // Clean for JSON: omit absolute filePath in reports to keep portable
+    const cleanFiles = result.files.map(f => ({
+        relativePath: f.relativePath,
+        tokenCount: f.tokenCount,
+        findings: f.findings,
+    }));
+    return JSON.stringify({
+        targetDir: result.targetDir,
+        totalTokens: result.totalTokens,
+        errorCount: result.errorCount,
+        warningCount: result.warningCount,
+        files: cleanFiles,
+    }, null, 2);
+}
+//# sourceMappingURL=reporter.js.map

package/dist/reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.js","sourceRoot":"","sources":["../src/reporter.ts"],"names":[],"mappings":";;AAcA,kDAsCC;AAED,gCAmBC;AAvED,SAAS,aAAa,CAAC,CAAU;IAC/B,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7C,IAAI,GAAG,GAAG,KAAK,IAAI,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;IAC/C,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC;QACnB,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,GAAG,CAAC;IAC7B,CAAC;IACD,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;QACd,GAAG,IAAI,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC;IAChC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAgB,mBAAmB,CAAC,MAAkB;IACpD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,+BAA+B,MAAM,CAAC,KAAK,CAAC,MAAM,eAAe,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;IAChG,KAAK,CAAC,IAAI,CAAC,2BAA2B,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IAC5D,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,UAAU,eAAe,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;IAC7E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;QAC5D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC;QAC9B,MAAM,SAAS,GAAG,GAAG,IAAI,CAAC,UAAU,SAAS,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,SAAS,GAAG,CAAC,CAAC;QAEvC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACpC,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC9B,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;IAC/D,CAAC;SAAM,IAAI,MAAM,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAC9C,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAgB,UAAU,CAAC,MAAkB;IAC3C,qEAAqE;IACrE,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACxC,YAAY,EAAE,CAAC,CAAC,YAAY;QAC5B,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,QAAQ,EAAE,CAAC,CAAC,QAAQ;KACrB,CAAC,CAAC,CAAC;IAEJ,OAAO,IAAI,CAAC,SAAS,CACnB;QACE,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,KAAK,EAAE,UAAU;KAClB,EACD,IAAI,EACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/rules/dangerousCommands.d.ts

@@ -0,0 +1,3 @@
+import { Finding } from '../types';
+export declare function checkDangerousCommands(content: string): Finding[];
+//# sourceMappingURL=dangerousCommands.d.ts.map

package/dist/rules/dangerousCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dangerousCommands.d.ts","sourceRoot":"","sources":["../../src/rules/dangerousCommands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAYnC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,EAAE,CAqBjE"}

package/dist/rules/dangerousCommands.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkDangerousCommands = checkDangerousCommands;
+const DANGEROUS_PATTERNS = [
+    { pattern: /\brm\s+(-[a-zA-Z]*f[a-zA-Z]*|--force)\b/i, label: 'rm -rf (or force recursive remove)' },
+    { pattern: /\bchmod\s+777\b/i, label: 'chmod 777' },
+    { pattern: /\bcurl\b[^\n]*\|\s*sh\b/i, label: 'curl | sh (pipe to shell)' },
+    { pattern: /\bwget\b[^\n]*\|\s*sh\b/i, label: 'wget | sh (pipe to shell)' },
+    { pattern: /\bsudo\b/i, label: 'sudo (privilege escalation)' },
+];
+const NEGATION_WORDS = /\b(never|do not|don't|dont|avoid|warning|dangerous|unsafe|prohibited|forbidden|not recommended)\b/i;
+function checkDangerousCommands(content) {
+    const lines = content.split(/\r?\n/);
+    const findings = [];
+    lines.forEach((line, idx) => {
+        for (const { pattern, label } of DANGEROUS_PATTERNS) {
+            if (pattern.test(line) && !NEGATION_WORDS.test(line)) {
+                const snippet = line.trim().length > 80 ? line.trim().slice(0, 77) + '...' : line.trim();
+                findings.push({
+                    type: 'error',
+                    rule: 'dangerous-commands',
+                    message: `Dangerous shell command detected: ${label}`,
+                    line: idx + 1,
+                    snippet,
+                });
+                break; // avoid duplicate findings for same line
+            }
+        }
+    });
+    return findings;
+}
+//# sourceMappingURL=dangerousCommands.js.map

package/dist/rules/dangerousCommands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dangerousCommands.js","sourceRoot":"","sources":["../../src/rules/dangerousCommands.ts"],"names":[],"mappings":";;AAYA,wDAqBC;AA/BD,MAAM,kBAAkB,GAA8C;IACpE,EAAE,OAAO,EAAE,0CAA0C,EAAE,KAAK,EAAE,oCAAoC,EAAE;IACpG,EAAE,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,WAAW,EAAE;IACnD,EAAE,OAAO,EAAE,0BAA0B,EAAE,KAAK,EAAE,2BAA2B,EAAE;IAC3E,EAAE,OAAO,EAAE,0BAA0B,EAAE,KAAK,EAAE,2BAA2B,EAAE;IAC3E,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,6BAA6B,EAAE;CAC/D,CAAC;AAEF,MAAM,cAAc,GAAG,oGAAoG,CAAC;AAE5H,SAAgB,sBAAsB,CAAC,OAAe;IACpD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAc,EAAE,CAAC;IAE/B,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QAC1B,KAAK,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,kBAAkB,EAAE,CAAC;YACpD,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACzF,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,OAAO;oBACb,IAAI,EAAE,oBAAoB;oBAC1B,OAAO,EAAE,qCAAqC,KAAK,EAAE;oBACrD,IAAI,EAAE,GAAG,GAAG,CAAC;oBACb,OAAO;iBACR,CAAC,CAAC;gBACH,MAAM,CAAC,yCAAyC;YAClD,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/rules/duplicateLines.d.ts

@@ -0,0 +1,3 @@
+import { Finding } from '../types';
+export declare function checkDuplicateLines(content: string): Finding[];
+//# sourceMappingURL=duplicateLines.d.ts.map

package/dist/rules/duplicateLines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicateLines.d.ts","sourceRoot":"","sources":["../../src/rules/duplicateLines.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,EAAE,CA4B9D"}

package/dist/rules/duplicateLines.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkDuplicateLines = checkDuplicateLines;
+function checkDuplicateLines(content) {
+    const lines = content.split(/\r?\n/);
+    const lineCounts = new Map();
+    lines.forEach((line, idx) => {
+        const trimmed = line.trim();
+        if (isIgnoredStructuralOrBlankLine(trimmed))
+            return;
+        if (!lineCounts.has(trimmed)) {
+            lineCounts.set(trimmed, []);
+        }
+        lineCounts.get(trimmed).push(idx + 1);
+    });
+    const findings = [];
+    for (const [lineText, lineNumbers] of lineCounts.entries()) {
+        if (lineNumbers.length > 1) {
+            const snippet = lineText.length > 80 ? lineText.slice(0, 77) + '...' : lineText;
+            findings.push({
+                type: 'warning',
+                rule: 'duplicate-lines',
+                message: `Duplicated line appears ${lineNumbers.length} times (lines ${lineNumbers.join(', ')})`,
+                snippet,
+            });
+        }
+    }
+    return findings;
+}
+function isIgnoredStructuralOrBlankLine(trimmed) {
+    if (trimmed.length === 0)
+        return true; // blank lines
+    if (trimmed.startsWith('```'))
+        return true; // markdown code fences: ```, ```bash, ```json, etc.
+    // exact common structural tokens from code blocks / json / md
+    if (trimmed === '{' || trimmed === '}' || trimmed === '[' || trimmed === ']' ||
+        trimmed === '],' || trimmed === '},' || trimmed === '{' || trimmed === '}') {
+        return true;
+    }
+    // punctuation-only lines (e.g. ---, ===, ..., ,, ;, etc. common in md and samples)
+    if (/^[\{\}\[\]\(\),;:.`'"\-_*#>+\/\\|~!@%^&*=]+$/.test(trimmed))
+        return true;
+    return false;
+}
+//# sourceMappingURL=duplicateLines.js.map

package/dist/rules/duplicateLines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicateLines.js","sourceRoot":"","sources":["../../src/rules/duplicateLines.ts"],"names":[],"mappings":";;AAEA,kDA4BC;AA5BD,SAAgB,mBAAmB,CAAC,OAAe;IACjD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAoB,CAAC;IAE/C,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,8BAA8B,CAAC,OAAO,CAAC;YAAE,OAAO;QACpD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7B,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC9B,CAAC;QACD,UAAU,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAc,EAAE,CAAC;IAE/B,KAAK,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,IAAI,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;QAC3D,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;YAChF,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,iBAAiB;gBACvB,OAAO,EAAE,2BAA2B,WAAW,CAAC,MAAM,iBAAiB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;gBAChG,OAAO;aACR,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,8BAA8B,CAAC,OAAe;IACrD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,cAAc;IACrD,IAAI,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,oDAAoD;IAChG,8DAA8D;IAC9D,IAAI,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,GAAG;QACxE,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,GAAG,EAAG,CAAC;QAChF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,mFAAmF;IACnF,IAAI,8CAA8C,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9E,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/rules/missingCommands.d.ts

@@ -0,0 +1,3 @@
+import { Finding } from '../types';
+export declare function checkMissingCommands(content: string): Finding[];
+//# sourceMappingURL=missingCommands.d.ts.map

package/dist/rules/missingCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"missingCommands.d.ts","sourceRoot":"","sources":["../../src/rules/missingCommands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AA2CnC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,EAAE,CA4B/D"}

package/dist/rules/missingCommands.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkMissingCommands = checkMissingCommands;
+const INSTALL_PATTERNS = [
+    /\bnpm\s+(ci|install|i)\b/i,
+    /\byarn\s+(install|add)\b/i,
+    /\bpnpm\s+(install|i)\b/i,
+    /\bbun\s+(install|i)\b/i,
+    /\bgo\s+(get|install|mod\s+download)\b/i,
+    /\bpip\s+install\b/i,
+    /\bpython\s+-m\s+pip\s+install\b/i,
+    /\bcargo\s+(build|install)\b/i,
+    /install(ation)?\s+(instructions|steps|command)/i,
+];
+const TEST_PATTERNS = [
+    /\bnpm\s+(test|run\s+test)\b/i,
+    /\byarn\s+test\b/i,
+    /\bpnpm\s+test\b/i,
+    /\bbun\s+test\b/i,
+    /\bgo\s+test\b/i,
+    /\bpytest\b/i,
+    /\bjest\b/i,
+    /\bvitest\b/i,
+    /\bcargo\s+test\b/i,
+    /test(ing|s)?\s+(instructions|command|script|how to)/i,
+];
+const LINT_PATTERNS = [
+    /\bnpm\s+run\s+lint\b/i,
+    /\byarn\s+lint\b/i,
+    /\bpnpm\s+lint\b/i,
+    /\beslint\b/i,
+    /\bprettier\b/i,
+    /\bgolangci-lint\b/i,
+    /\bruff\b/i,
+    /\bclippy\b/i,
+    /\blint(ing)?\s+(instructions|command|script|how to)/i,
+];
+function hasAnyPattern(content, patterns) {
+    return patterns.some(p => p.test(content));
+}
+function checkMissingCommands(content) {
+    const findings = [];
+    if (!hasAnyPattern(content, INSTALL_PATTERNS)) {
+        findings.push({
+            type: 'warning',
+            rule: 'missing-commands',
+            message: 'No install command or installation instructions detected',
+        });
+    }
+    if (!hasAnyPattern(content, TEST_PATTERNS)) {
+        findings.push({
+            type: 'warning',
+            rule: 'missing-commands',
+            message: 'No test command or testing instructions detected',
+        });
+    }
+    if (!hasAnyPattern(content, LINT_PATTERNS)) {
+        findings.push({
+            type: 'warning',
+            rule: 'missing-commands',
+            message: 'No lint command or linting instructions detected',
+        });
+    }
+    return findings;
+}
+//# sourceMappingURL=missingCommands.js.map

package/dist/rules/missingCommands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"missingCommands.js","sourceRoot":"","sources":["../../src/rules/missingCommands.ts"],"names":[],"mappings":";;AA2CA,oDA4BC;AArED,MAAM,gBAAgB,GAAG;IACvB,2BAA2B;IAC3B,2BAA2B;IAC3B,yBAAyB;IACzB,wBAAwB;IACxB,wCAAwC;IACxC,oBAAoB;IACpB,kCAAkC;IAClC,8BAA8B;IAC9B,iDAAiD;CAClD,CAAC;AAEF,MAAM,aAAa,GAAG;IACpB,8BAA8B;IAC9B,kBAAkB;IAClB,kBAAkB;IAClB,iBAAiB;IACjB,gBAAgB;IAChB,aAAa;IACb,WAAW;IACX,aAAa;IACb,mBAAmB;IACnB,sDAAsD;CACvD,CAAC;AAEF,MAAM,aAAa,GAAG;IACpB,uBAAuB;IACvB,kBAAkB;IAClB,kBAAkB;IAClB,aAAa;IACb,eAAe;IACf,oBAAoB;IACpB,WAAW;IACX,aAAa;IACb,sDAAsD;CACvD,CAAC;AAEF,SAAS,aAAa,CAAC,OAAe,EAAE,QAAkB;IACxD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,SAAgB,oBAAoB,CAAC,OAAe;IAClD,MAAM,QAAQ,GAAc,EAAE,CAAC;IAE/B,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,gBAAgB,CAAC,EAAE,CAAC;QAC9C,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,kBAAkB;YACxB,OAAO,EAAE,0DAA0D;SACpE,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,aAAa,CAAC,EAAE,CAAC;QAC3C,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,kBAAkB;YACxB,OAAO,EAAE,kDAAkD;SAC5D,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,aAAa,CAAC,EAAE,CAAC;QAC3C,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,kBAAkB;YACxB,OAAO,EAAE,kDAAkD;SAC5D,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/rules/tokenBudget.d.ts

@@ -0,0 +1,7 @@
+import { Finding } from '../types';
+export interface TokenBudgetOptions {
+    warnThreshold?: number;
+    errorThreshold?: number;
+}
+export declare function checkTokenBudget(content: string, options?: TokenBudgetOptions): Finding[];
+//# sourceMappingURL=tokenBudget.d.ts.map

package/dist/rules/tokenBudget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenBudget.d.ts","sourceRoot":"","sources":["../../src/rules/tokenBudget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAMnC,MAAM,WAAW,kBAAkB;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,kBAAuB,GAC/B,OAAO,EAAE,CAsBX"}

package/dist/rules/tokenBudget.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkTokenBudget = checkTokenBudget;
+const scanner_1 = require("../scanner");
+const DEFAULT_WARN_THRESHOLD = 1500;
+const DEFAULT_ERROR_THRESHOLD = 3000;
+function checkTokenBudget(content, options = {}) {
+    const tokens = (0, scanner_1.estimateTokens)(content);
+    const warnThreshold = options.warnThreshold ?? DEFAULT_WARN_THRESHOLD;
+    const errorThreshold = options.errorThreshold ?? DEFAULT_ERROR_THRESHOLD;
+    const findings = [];
+    if (tokens > errorThreshold) {
+        findings.push({
+            type: 'error',
+            rule: 'token-budget',
+            message: `File exceeds maximum token budget: ${tokens} tokens (limit: ${errorThreshold})`,
+        });
+    }
+    else if (tokens > warnThreshold) {
+        findings.push({
+            type: 'warning',
+            rule: 'token-budget',
+            message: `File is large: ${tokens} tokens (warning threshold: ${warnThreshold})`,
+        });
+    }
+    return findings;
+}
+//# sourceMappingURL=tokenBudget.js.map

package/dist/rules/tokenBudget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenBudget.js","sourceRoot":"","sources":["../../src/rules/tokenBudget.ts"],"names":[],"mappings":";;AAWA,4CAyBC;AAnCD,wCAA4C;AAE5C,MAAM,sBAAsB,GAAG,IAAI,CAAC;AACpC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAOrC,SAAgB,gBAAgB,CAC9B,OAAe,EACf,UAA8B,EAAE;IAEhC,MAAM,MAAM,GAAG,IAAA,wBAAc,EAAC,OAAO,CAAC,CAAC;IACvC,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,sBAAsB,CAAC;IACtE,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,uBAAuB,CAAC;IAEzE,MAAM,QAAQ,GAAc,EAAE,CAAC;IAE/B,IAAI,MAAM,GAAG,cAAc,EAAE,CAAC;QAC5B,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE,sCAAsC,MAAM,mBAAmB,cAAc,GAAG;SAC1F,CAAC,CAAC;IACL,CAAC;SAAM,IAAI,MAAM,GAAG,aAAa,EAAE,CAAC;QAClC,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE,kBAAkB,MAAM,+BAA+B,aAAa,GAAG;SACjF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/rules/vagueInstructions.d.ts

@@ -0,0 +1,3 @@
+import { Finding } from '../types';
+export declare function checkVagueInstructions(content: string): Finding[];
+//# sourceMappingURL=vagueInstructions.d.ts.map

package/dist/rules/vagueInstructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vagueInstructions.d.ts","sourceRoot":"","sources":["../../src/rules/vagueInstructions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAcnC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,EAAE,CAuBjE"}

package/dist/rules/vagueInstructions.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkVagueInstructions = checkVagueInstructions;
+const VAGUE_PHRASES = [
+    'make it better',
+    'fix everything',
+    'be careful',
+    'use best practices',
+    'clean code',
+    'improve this',
+    'handle edge cases',
+    'do it right',
+    'make sure it works', // bonus common vague
+];
+function checkVagueInstructions(content) {
+    const lines = content.split(/\r?\n/);
+    const findings = [];
+    const lowerPhrases = VAGUE_PHRASES.map(p => p.toLowerCase());
+    lines.forEach((line, idx) => {
+        const lower = line.toLowerCase();
+        for (const phrase of lowerPhrases) {
+            if (lower.includes(phrase)) {
+                const snippet = line.trim().length > 80 ? line.trim().slice(0, 77) + '...' : line.trim();
+                findings.push({
+                    type: 'warning',
+                    rule: 'vague-instructions',
+                    message: `Vague instruction detected: "${phrase}"`,
+                    line: idx + 1,
+                    snippet,
+                });
+                break; // one finding per line max
+            }
+        }
+    });
+    return findings;
+}
+//# sourceMappingURL=vagueInstructions.js.map

package/dist/rules/vagueInstructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vagueInstructions.js","sourceRoot":"","sources":["../../src/rules/vagueInstructions.ts"],"names":[],"mappings":";;AAcA,wDAuBC;AAnCD,MAAM,aAAa,GAAG;IACpB,gBAAgB;IAChB,gBAAgB;IAChB,YAAY;IACZ,oBAAoB;IACpB,YAAY;IACZ,cAAc;IACd,mBAAmB;IACnB,aAAa;IACb,oBAAoB,EAAE,qBAAqB;CAC5C,CAAC;AAEF,SAAgB,sBAAsB,CAAC,OAAe;IACpD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,MAAM,YAAY,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAE7D,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACjC,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;YAClC,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACzF,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,SAAS;oBACf,IAAI,EAAE,oBAAoB;oBAC1B,OAAO,EAAE,gCAAgC,MAAM,GAAG;oBAClD,IAAI,EAAE,GAAG,GAAG,CAAC;oBACb,OAAO;iBACR,CAAC,CAAC;gBACH,MAAM,CAAC,2BAA2B;YACpC,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/scanner.d.ts

@@ -0,0 +1,5 @@
+import { FileReport } from './types';
+export declare function estimateTokens(content: string): number;
+export declare function scanDirectory(targetDir: string): FileReport[];
+export declare function readFileContent(filePath: string): string;
+//# 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":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AA4DrC,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,EAAE,CA6B7D;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/dist/scanner.js

@@ -0,0 +1,125 @@
+"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.estimateTokens = estimateTokens;
+exports.scanDirectory = scanDirectory;
+exports.readFileContent = readFileContent;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const SUPPORTED_BASENAMES = new Set([
+    'AGENTS.md',
+    'CLAUDE.md',
+    '.cursorrules',
+    '.windsurfrules',
+]);
+const SUPPORTED_RELATIVE = new Set([
+    '.github/copilot-instructions.md',
+]);
+function shouldScanFile(filePath, rootDir) {
+    const base = path.basename(filePath);
+    const rel = path.relative(rootDir, filePath).replace(/\\/g, '/');
+    if (SUPPORTED_BASENAMES.has(base)) {
+        return true;
+    }
+    if (SUPPORTED_RELATIVE.has(rel)) {
+        return true;
+    }
+    // docs/**/*.md
+    if (rel.startsWith('docs/') && base.endsWith('.md')) {
+        return true;
+    }
+    // README.md at root or anywhere? spec says README.md, probably any README.md
+    if (base === 'README.md') {
+        return true;
+    }
+    return false;
+}
+function walkDir(dir, rootDir, files = []) {
+    let entries;
+    try {
+        entries = fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return files;
+    }
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        const rel = path.relative(rootDir, fullPath).replace(/\\/g, '/');
+        if (entry.isDirectory()) {
+            if (entry.name === 'node_modules' || entry.name === '.git' || entry.name === 'dist') {
+                continue;
+            }
+            walkDir(fullPath, rootDir, files);
+        }
+        else if (entry.isFile()) {
+            if (shouldScanFile(fullPath, rootDir)) {
+                files.push(fullPath);
+            }
+        }
+    }
+    return files;
+}
+function estimateTokens(content) {
+    return Math.ceil(content.length / 4);
+}
+function scanDirectory(targetDir) {
+    const absTarget = path.resolve(targetDir);
+    const foundPaths = walkDir(absTarget, absTarget);
+    const reports = [];
+    for (const filePath of foundPaths) {
+        let content;
+        try {
+            content = fs.readFileSync(filePath, 'utf8');
+        }
+        catch {
+            continue;
+        }
+        const relativePath = path.relative(absTarget, filePath).replace(/\\/g, '/');
+        const tokenCount = estimateTokens(content);
+        reports.push({
+            filePath,
+            relativePath: relativePath || path.basename(filePath),
+            tokenCount,
+            findings: [],
+        });
+    }
+    // Sort for deterministic output: prefer top level, then alpha
+    reports.sort((a, b) => a.relativePath.localeCompare(b.relativePath));
+    return reports;
+}
+function readFileContent(filePath) {
+    return fs.readFileSync(filePath, 'utf8');
+}
+//# 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/types.d.ts

@@ -0,0 +1,26 @@
+export type Severity = 'warning' | 'error';
+export interface Finding {
+    type: Severity;
+    rule: string;
+    message: string;
+    line?: number;
+    snippet?: string;
+}
+export interface FileReport {
+    filePath: string;
+    relativePath: string;
+    tokenCount: number;
+    findings: Finding[];
+}
+export interface LintOptions {
+    maxTokens?: number;
+    json?: boolean;
+}
+export interface LintResult {
+    files: FileReport[];
+    totalTokens: number;
+    errorCount: number;
+    warningCount: number;
+    targetDir: string;
+}
+//# 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,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;AAE3C,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB"}

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/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@pqqqqqdev/agent-context-lint",
+  "version": "0.1.0",
+  "description": "A command-line linter that audits AI coding-agent context/instruction files for repositories. Helps reduce token bloat, duplicated instructions, vague agent instructions, missing project commands, and dangerous shell commands.",
+  "license": "MIT",
+  "author": "pqqqqqdev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pqqqqqdev/agent-context-lint.git"
+  },
+  "bin": {
+    "agent-context-lint": "dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "cli",
+    "lint",
+    "linter",
+    "ai",
+    "agent",
+    "context",
+    "instructions",
+    "copilot",
+    "cursor",
+    "claude",
+    "windsurf"
+  ],
+  "devDependencies": {
+    "@types/node": "^20.12.0",
+    "eslint": "^9.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^4.1.8"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "type": "commonjs",
+  "bugs": {
+    "url": "https://github.com/pqqqqqdev/agent-context-lint/issues"
+  },
+  "homepage": "https://github.com/pqqqqqdev/agent-context-lint#readme"
+}