@atlisp/lint 0.1.0

package/README.md

@@ -0,0 +1,150 @@
+# @atlisp/lint
+
+AutoLISP 静态分析工具 — 括号匹配、安全检查、编码检测、命名规范、SBCL 语法校验。
+
+## 安装
+
+```bash
+npm install -g @atlisp/lint
+```
+
+需要 Node.js >= 18。SBCL 语法校验为可选功能，如需启用请安装 [SBCL](https://www.sbcl.org)。
+
+## 快速开始
+
+```bash
+# 在项目目录下初始化配置文件
+npx @atlisp/lint --init
+
+# 运行检查
+npx @atlisp/lint
+
+# 输出 JSON 格式
+npx @atlisp/lint --format json
+```
+
+## CLI 选项
+
+```
+--src <dir>          指定源码目录（可多次使用）
+--test <dir>         指定测试目录（可多次使用）
+--config <path>      指定配置文件路径
+--staged             仅检查 git 暂存区中的 .lsp 文件
+--format <format>    输出格式：default（默认）| json
+--init               在当前目录生成 atlisp-lint.json
+--install-hook       安装 git pre-commit hook
+```
+
+## 检查规则
+
+### 阶段 1：静态检查
+
+| 规则 | 默认 | 说明 |
+|------|------|------|
+| `parens` | error | 括号不匹配 |
+| `encoding` | error | 非 UTF-8 编码 |
+| `cl_syntax` | warn | Common Lisp 特有语法（如 `&key`） |
+| `quit_exit` | error | 调用 `quit` / `exit`（会终止 CAD） |
+| `command_shell` | error | 调用 `command` 执行 shell |
+| `startapp` | warn | 调用 `startapp` 启动外部程序 |
+| `vl_registry_write` | warn | 写注册表 |
+| `vlax_without_loading` | warn | 使用 `vlax-*` 前未调用 `vl-load-com` |
+| `token_in_url` | warn | URL 中包含 `token=`（凭据泄露） |
+| `open_without_close` | warn | open/close 数量不匹配（资源泄露） |
+| `bare_function_names` | warn | defun 缺少命名空间前缀 |
+| `trailing_whitespace` | warn | 行尾多余空格 |
+| `module_registration` | off | 模块文件未注册到 `*modules*` |
+| `namespace_header` | off | 缺少 `(in-package ...)` 头 |
+
+### 阶段 2：SBCL 语法校验
+
+调用 SBCL 对每个 `.lsp` 文件做 Common Lisp reader 级别的深度解析：
+
+- 语法错误 — reader 无法解析的内容
+- 符号未找到 — 未注册到 stub packages 中的符号
+- CL-ism — `#(`、`#\`、`#.` 等 AutoLISP 无效语法
+- defmacro — 默认不允许，除非文件在允许列表中
+
+## 配置文件
+
+`atlisp-lint.json`：
+
+```json
+{
+  "locale": "zh",
+  "source": {
+    "globs": ["**/*.lsp"],
+    "exclude": ["**/node_modules/**", "**/vendor/**", "**/.git/**"]
+  },
+  "checks": {
+    "parens": "error",
+    "encoding": "error",
+    "cl_syntax": "warn",
+    "quit_exit": "error",
+    "command_shell": "error",
+    "startapp": "warn",
+    "vl_registry_write": "warn",
+    "vlax_without_loading": "warn",
+    "token_in_url": "warn",
+    "open_without_close": "warn",
+    "bare_function_names": "warn",
+    "trailing_whitespace": "warn",
+    "module_registration": "off",
+    "namespace_header": "off"
+  },
+  "cl_syntax": {
+    "keywords": ["&key"]
+  },
+  "dangerous_calls": {
+    "quit": "error",
+    "exit": "error",
+    "command_shell": "error",
+    "startapp": "warn",
+    "vl_registry_write": "warn"
+  },
+  "bare_function_names": {
+    "allowlist": ["T", "nil"],
+    "namespace_pattern": "^[a-z]+:"
+  },
+  "sbcl": {
+    "walk_exclude": [".vscode", "vendor", ".git"],
+    "defmacro_allow_files": ["compat-cl"]
+  }
+}
+```
+
+## 多语言
+
+支持中文和英文，通过配置文件的 `locale` 字段切换：
+
+```json
+{ "locale": "zh" }  // 中文（默认）
+{ "locale": "en" }  // English
+```
+
+## Git 集成
+
+```bash
+# 安装 pre-commit hook，每次提交前自动检查暂存文件
+npx @atlisp/lint --install-hook
+
+# 手动检查暂存文件
+npx @atlisp/lint --staged
+```
+
+## 开发
+
+```bash
+# 安装依赖
+npm install
+
+# 编译
+npm run build
+
+# 测试
+npm test
+```
+
+## 许可
+
+MIT

package/atlisp-lint.default.json

@@ -0,0 +1,52 @@
+{
+  "locale": "zh",
+  "source": {
+    "globs": ["**/*.lsp"],
+    "exclude": ["**/node_modules/**", "**/vendor/**", "**/.git/**"]
+  },
+  "checks": {
+    "parens": "error",
+    "encoding": "error",
+    "cl_syntax": "warn",
+    "quit_exit": "error",
+    "command_shell": "error",
+    "startapp": "warn",
+    "vl_registry_write": "warn",
+    "vlax_without_loading": "warn",
+    "token_in_url": "warn",
+    "open_without_close": "warn",
+    "bare_function_names": "warn",
+    "trailing_whitespace": "warn",
+    "module_registration": "off",
+    "namespace_header": "off"
+  },
+  "cl_syntax": {
+    "keywords": ["&key"]
+  },
+  "dangerous_calls": {
+    "quit": "error",
+    "exit": "error",
+    "command_shell": "error",
+    "startapp": "warn",
+    "vl_registry_write": "warn"
+  },
+  "module_registration": {
+    "severity": "off",
+    "patterns": [],
+    "dirs": ["modules"]
+  },
+  "namespace_header": {
+    "severity": "off",
+    "package": "",
+    "deps": [],
+    "search_lines": 15
+  },
+  "bare_function_names": {
+    "allowlist": ["T", "nil"],
+    "namespace_pattern": "^[a-z]+:"
+  },
+  "sbcl": {
+    "walk_exclude": [".vscode", "vendor", ".git"],
+    "defmacro_allow_files": ["compat-cl"]
+  }
+}

package/bin/atlisp-lint

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../dist/index.js').main();

package/dist/atlisp-lint.default.json

@@ -0,0 +1,52 @@
+{
+  "locale": "zh",
+  "source": {
+    "globs": ["**/*.lsp"],
+    "exclude": ["**/node_modules/**", "**/vendor/**", "**/.git/**"]
+  },
+  "checks": {
+    "parens": "error",
+    "encoding": "error",
+    "cl_syntax": "warn",
+    "quit_exit": "error",
+    "command_shell": "error",
+    "startapp": "warn",
+    "vl_registry_write": "warn",
+    "vlax_without_loading": "warn",
+    "token_in_url": "warn",
+    "open_without_close": "warn",
+    "bare_function_names": "warn",
+    "trailing_whitespace": "warn",
+    "module_registration": "off",
+    "namespace_header": "off"
+  },
+  "cl_syntax": {
+    "keywords": ["&key"]
+  },
+  "dangerous_calls": {
+    "quit": "error",
+    "exit": "error",
+    "command_shell": "error",
+    "startapp": "warn",
+    "vl_registry_write": "warn"
+  },
+  "module_registration": {
+    "severity": "off",
+    "patterns": [],
+    "dirs": ["modules"]
+  },
+  "namespace_header": {
+    "severity": "off",
+    "package": "",
+    "deps": [],
+    "search_lines": 15
+  },
+  "bare_function_names": {
+    "allowlist": ["T", "nil"],
+    "namespace_pattern": "^[a-z]+:"
+  },
+  "sbcl": {
+    "walk_exclude": [".vscode", "vendor", ".git"],
+    "defmacro_allow_files": ["compat-cl"]
+  }
+}

package/dist/checks/bare-names.d.ts

@@ -0,0 +1,3 @@
+import { Issue } from '../types';
+export declare function checkBareFunctionNames(content: string, file: string, allowlist: string[], namespacePattern: string): Issue[];
+//# sourceMappingURL=bare-names.d.ts.map

package/dist/checks/bare-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bare-names.d.ts","sourceRoot":"","sources":["../../src/checks/bare-names.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAIjC,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,gBAAgB,EAAE,MAAM,GAC3E,KAAK,EAAE,CAoBT"}

package/dist/checks/bare-names.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkBareFunctionNames = checkBareFunctionNames;
+const utils_1 = require("../utils");
+const locale_1 = require("../locale");
+function checkBareFunctionNames(content, file, allowlist, namespacePattern) {
+    const issues = [];
+    const nsRegex = new RegExp(namespacePattern);
+    for (const { lineno, stripped } of (0, utils_1.codeLines)(content)) {
+        const s = stripped.trim();
+        const m = s.match(/\(defun\s+(\S+)/);
+        if (!m)
+            continue;
+        const name = m[1];
+        if (allowlist.includes(name))
+            continue;
+        if (name.includes('/'))
+            continue; // local: defun foo/bar
+        if (!nsRegex.test(name) && !name.includes(':')) {
+            issues.push({
+                file, line: lineno, severity: 'warn', rule: 'bare_function_names',
+                message: (0, locale_1.t)('bare_function_names', name),
+            });
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=bare-names.js.map

package/dist/checks/bare-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bare-names.js","sourceRoot":"","sources":["../../src/checks/bare-names.ts"],"names":[],"mappings":";;AAIA,wDAsBC;AAzBD,oCAAqC;AACrC,sCAA8B;AAE9B,SAAgB,sBAAsB,CACpC,OAAe,EAAE,IAAY,EAAE,SAAmB,EAAE,gBAAwB;IAE5E,MAAM,MAAM,GAAY,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAE7C,KAAK,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,IAAA,iBAAS,EAAC,OAAO,CAAC,EAAE,CAAC;QACtD,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACrC,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,SAAS;QACvC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,SAAS,CAAC,uBAAuB;QACzD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/C,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB;gBACjE,OAAO,EAAE,IAAA,UAAC,EAAC,qBAAqB,EAAE,IAAI,CAAC;aACxC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/checks/cl-syntax.d.ts

@@ -0,0 +1,3 @@
+import { Issue } from '../types';
+export declare function checkClSyntax(content: string, file: string, keywords: string[]): Issue[];
+//# sourceMappingURL=cl-syntax.d.ts.map

package/dist/checks/cl-syntax.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cl-syntax.d.ts","sourceRoot":"","sources":["../../src/checks/cl-syntax.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAIjC,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,CAgBxF"}

package/dist/checks/cl-syntax.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkClSyntax = checkClSyntax;
+const utils_1 = require("../utils");
+const locale_1 = require("../locale");
+function checkClSyntax(content, file, keywords) {
+    const issues = [];
+    for (const { lineno, stripped } of (0, utils_1.codeLines)(content)) {
+        const s = stripped.trim();
+        if (!s)
+            continue;
+        for (const kw of keywords) {
+            const idx = s.indexOf(kw);
+            if (idx >= 0 && (idx === 0 || !/[a-zA-Z]/.test(s[idx - 1]))) {
+                issues.push({
+                    file, line: lineno, severity: 'warn', rule: 'cl_syntax',
+                    message: (0, locale_1.t)('cl_syntax', kw),
+                });
+            }
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=cl-syntax.js.map

package/dist/checks/cl-syntax.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cl-syntax.js","sourceRoot":"","sources":["../../src/checks/cl-syntax.ts"],"names":[],"mappings":";;AAIA,sCAgBC;AAnBD,oCAAqC;AACrC,sCAA8B;AAE9B,SAAgB,aAAa,CAAC,OAAe,EAAE,IAAY,EAAE,QAAkB;IAC7E,MAAM,MAAM,GAAY,EAAE,CAAC;IAC3B,KAAK,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,IAAA,iBAAS,EAAC,OAAO,CAAC,EAAE,CAAC;QACtD,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC1B,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;YAC1B,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC1B,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5D,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW;oBACvD,OAAO,EAAE,IAAA,UAAC,EAAC,WAAW,EAAE,EAAE,CAAC;iBAC5B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/checks/dangerous-calls.d.ts

@@ -0,0 +1,3 @@
+import { Issue, DangerousCallsConfig } from '../types';
+export declare function checkDangerousCalls(content: string, file: string, config: DangerousCallsConfig): Issue[];
+//# sourceMappingURL=dangerous-calls.d.ts.map

package/dist/checks/dangerous-calls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dangerous-calls.d.ts","sourceRoot":"","sources":["../../src/checks/dangerous-calls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AA0BvD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAC1D,KAAK,EAAE,CAsBT"}

package/dist/checks/dangerous-calls.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkDangerousCalls = checkDangerousCalls;
+const utils_1 = require("../utils");
+const locale_1 = require("../locale");
+const PATTERNS = [
+    { rule: 'quit', check: l => /\bquit\b/.test(l), key: 'quit' },
+    { rule: 'exit', check: l => /\bexit\b/.test(l), key: 'exit' },
+    { rule: 'command_shell', check: l => /\(command\s+"shell"\s/.test(l), key: 'command_shell' },
+    { rule: 'startapp', check: l => /\bstartapp\b/.test(l), key: 'startapp' },
+    { rule: 'vl_registry_write', check: l => /\bvl-registry-write\b/.test(l), key: 'vl_registry_write' },
+];
+const MESSAGE_KEYS = {
+    quit: 'dangerous.quit',
+    exit: 'dangerous.exit',
+    command_shell: 'dangerous.command_shell',
+    startapp: 'dangerous.startapp',
+    vl_registry_write: 'dangerous.vl_registry_write',
+};
+function checkDangerousCalls(content, file, config) {
+    const issues = [];
+    const lines = content.split('\n');
+    for (let lineno = 1; lineno <= lines.length; lineno++) {
+        const line = lines[lineno - 1];
+        // Strip comments only, keep strings intact
+        const stripped = (0, utils_1.stripLineRaw)(line).trim();
+        if (!stripped)
+            continue;
+        for (const p of PATTERNS) {
+            const configuredSeverity = config[p.key];
+            if (configuredSeverity === 'off')
+                continue;
+            if (p.check(stripped)) {
+                issues.push({
+                    file, line: lineno, severity: configuredSeverity, rule: p.rule,
+                    message: (0, locale_1.t)(MESSAGE_KEYS[p.rule]),
+                });
+            }
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=dangerous-calls.js.map

package/dist/checks/dangerous-calls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dangerous-calls.js","sourceRoot":"","sources":["../../src/checks/dangerous-calls.ts"],"names":[],"mappings":";;AA0BA,kDAwBC;AAjDD,oCAAwC;AACxC,sCAA8B;AAQ9B,MAAM,QAAQ,GAAc;IAC1B,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE;IAC7D,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE;IAC7D,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE;IAC5F,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE;IACzE,EAAE,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,mBAAmB,EAAE;CACrG,CAAC;AAEF,MAAM,YAAY,GAA2B;IAC3C,IAAI,EAAE,gBAAgB;IACtB,IAAI,EAAE,gBAAgB;IACtB,aAAa,EAAE,yBAAyB;IACxC,QAAQ,EAAE,oBAAoB;IAC9B,iBAAiB,EAAE,6BAA6B;CACjD,CAAC;AAEF,SAAgB,mBAAmB,CACjC,OAAe,EAAE,IAAY,EAAE,MAA4B;IAE3D,MAAM,MAAM,GAAY,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAElC,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,IAAI,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;QACtD,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC/B,2CAA2C;QAC3C,MAAM,QAAQ,GAAG,IAAA,oBAAY,EAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3C,IAAI,CAAC,QAAQ;YAAE,SAAS;QAExB,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,MAAM,kBAAkB,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACzC,IAAI,kBAAkB,KAAK,KAAK;gBAAE,SAAS;YAC3C,IAAI,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACtB,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI;oBAC9D,OAAO,EAAE,IAAA,UAAC,EAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;iBACjC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/checks/encoding.d.ts

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

package/dist/checks/encoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.d.ts","sourceRoot":"","sources":["../../src/checks/encoding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAGjC,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,EAAE,CA6BpE"}

package/dist/checks/encoding.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkEncoding = checkEncoding;
+const locale_1 = require("../locale");
+function checkEncoding(content, file) {
+    const issues = [];
+    const raw = Buffer.from(content, 'utf-8');
+    // BOM detection
+    if (raw.length >= 3 && raw[0] === 0xEF && raw[1] === 0xBB && raw[2] === 0xBF) {
+        issues.push({
+            file, line: 1, severity: 'warn', rule: 'encoding',
+            message: (0, locale_1.t)('encoding.bom'),
+        });
+    }
+    // Non-UTF-8 check: if content can't be round-tripped, it's not valid UTF-8
+    try {
+        const roundtrip = Buffer.from(content, 'utf-8').toString('utf-8');
+        if (roundtrip !== content) {
+            issues.push({
+                file, line: 1, severity: 'error', rule: 'encoding',
+                message: (0, locale_1.t)('encoding.non_utf8_cad'),
+            });
+        }
+    }
+    catch {
+        issues.push({
+            file, line: 1, severity: 'error', rule: 'encoding',
+            message: (0, locale_1.t)('encoding.non_utf8'),
+        });
+    }
+    return issues;
+}
+//# sourceMappingURL=encoding.js.map

package/dist/checks/encoding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.js","sourceRoot":"","sources":["../../src/checks/encoding.ts"],"names":[],"mappings":";;AAGA,sCA6BC;AA/BD,sCAA8B;AAE9B,SAAgB,aAAa,CAAC,OAAe,EAAE,IAAY;IACzD,MAAM,MAAM,GAAY,EAAE,CAAC;IAC3B,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAE1C,gBAAgB;IAChB,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC7E,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU;YACjD,OAAO,EAAE,IAAA,UAAC,EAAC,cAAc,CAAC;SAC3B,CAAC,CAAC;IACL,CAAC;IAED,2EAA2E;IAC3E,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAClE,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU;gBAClD,OAAO,EAAE,IAAA,UAAC,EAAC,uBAAuB,CAAC;aACpC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU;YAClD,OAAO,EAAE,IAAA,UAAC,EAAC,mBAAmB,CAAC;SAChC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/checks/module-reg.d.ts

@@ -0,0 +1,3 @@
+import { Issue, ModuleRegistrationConfig } from '../types';
+export declare function checkModuleRegistration(content: string, file: string, relPath: string, config: ModuleRegistrationConfig): Issue[];
+//# sourceMappingURL=module-reg.d.ts.map

package/dist/checks/module-reg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-reg.d.ts","sourceRoot":"","sources":["../../src/checks/module-reg.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAG3D,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,wBAAwB,GAC/E,KAAK,EAAE,CAoBT"}

package/dist/checks/module-reg.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkModuleRegistration = checkModuleRegistration;
+const locale_1 = require("../locale");
+function checkModuleRegistration(content, file, relPath, config) {
+    if (config.severity === 'off')
+        return [];
+    const parts = relPath.replace(/\\/g, '/').split('/');
+    if (parts.length < 3 || parts[0] !== 'src')
+        return [];
+    const topDir = parts[1];
+    if (!config.dirs.includes(topDir))
+        return [];
+    const lines = content.split('\n');
+    const relevant = lines.filter(l => l.trim().length > 0);
+    const tail = relevant.slice(-20).join('\n');
+    if (!tail.includes('*modules*')) {
+        return [{
+                file, line: 1, severity: config.severity, rule: 'module_registration',
+                message: (0, locale_1.t)('module_registration'),
+            }];
+    }
+    return [];
+}
+//# sourceMappingURL=module-reg.js.map

package/dist/checks/module-reg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-reg.js","sourceRoot":"","sources":["../../src/checks/module-reg.ts"],"names":[],"mappings":";;AAIA,0DAsBC;AAxBD,sCAA8B;AAE9B,SAAgB,uBAAuB,CACrC,OAAe,EAAE,IAAY,EAAE,OAAe,EAAE,MAAgC;IAEhF,IAAI,MAAM,CAAC,QAAQ,KAAK,KAAK;QAAE,OAAO,EAAE,CAAC;IAEzC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACrD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK;QAAE,OAAO,EAAE,CAAC;IACtD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,CAAC;IAE7C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE5C,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC;gBACN,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAA4B,EAAE,IAAI,EAAE,qBAAqB;gBACzF,OAAO,EAAE,IAAA,UAAC,EAAC,qBAAqB,CAAC;aAClC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/checks/namespace-header.d.ts

@@ -0,0 +1,3 @@
+import { Issue, NamespaceHeaderConfig } from '../types';
+export declare function checkNamespaceHeader(content: string, file: string, config: NamespaceHeaderConfig): Issue[];
+//# sourceMappingURL=namespace-header.d.ts.map

package/dist/checks/namespace-header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace-header.d.ts","sourceRoot":"","sources":["../../src/checks/namespace-header.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAIxD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,GAC3D,KAAK,EAAE,CAoBT"}

package/dist/checks/namespace-header.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkNamespaceHeader = checkNamespaceHeader;
+const utils_1 = require("../utils");
+const locale_1 = require("../locale");
+function checkNamespaceHeader(content, file, config) {
+    if (config.severity === 'off')
+        return [];
+    if (!config.package)
+        return [];
+    const lines = content.split('\n');
+    for (let i = 0; i < Math.min(lines.length, config.search_lines); i++) {
+        const stripped = (0, utils_1.stripLine)(lines[i]).trim();
+        if (stripped.startsWith('(in-package')) {
+            if (stripped.includes(config.package))
+                return [];
+            return [{
+                    file, line: i + 1, severity: config.severity, rule: 'namespace_header',
+                    message: (0, locale_1.t)('namespace_header.wrong', config.package),
+                }];
+        }
+    }
+    return [{
+            file, line: 1, severity: config.severity, rule: 'namespace_header',
+            message: (0, locale_1.t)('namespace_header.missing', config.package),
+        }];
+}
+//# sourceMappingURL=namespace-header.js.map

package/dist/checks/namespace-header.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace-header.js","sourceRoot":"","sources":["../../src/checks/namespace-header.ts"],"names":[],"mappings":";;AAIA,oDAsBC;AAzBD,oCAAqC;AACrC,sCAA8B;AAE9B,SAAgB,oBAAoB,CAClC,OAAe,EAAE,IAAY,EAAE,MAA6B;IAE5D,IAAI,MAAM,CAAC,QAAQ,KAAK,KAAK;QAAE,OAAO,EAAE,CAAC;IACzC,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IAE/B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACrE,MAAM,QAAQ,GAAG,IAAA,iBAAS,EAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YACvC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC;gBAAE,OAAO,EAAE,CAAC;YACjD,OAAO,CAAC;oBACN,IAAI,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAA4B,EAAE,IAAI,EAAE,kBAAkB;oBAC1F,OAAO,EAAE,IAAA,UAAC,EAAC,wBAAwB,EAAE,MAAM,CAAC,OAAO,CAAC;iBACrD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,CAAC;YACN,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAA4B,EAAE,IAAI,EAAE,kBAAkB;YACtF,OAAO,EAAE,IAAA,UAAC,EAAC,0BAA0B,EAAE,MAAM,CAAC,OAAO,CAAC;SACvD,CAAC,CAAC;AACL,CAAC"}

package/dist/checks/open-close.d.ts

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

package/dist/checks/open-close.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-close.d.ts","sourceRoot":"","sources":["../../src/checks/open-close.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAIjC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,EAAE,CAa5E"}

package/dist/checks/open-close.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkOpenWithoutClose = checkOpenWithoutClose;
+const utils_1 = require("../utils");
+const locale_1 = require("../locale");
+function checkOpenWithoutClose(content, file) {
+    let openCount = 0, closeCount = 0;
+    for (const { stripped } of (0, utils_1.codeLines)(content)) {
+        if (/\(open\b/.test(stripped))
+            openCount++;
+        if (/\(close\b/.test(stripped))
+            closeCount++;
+    }
+    if (openCount > closeCount) {
+        return [{
+                file, line: 1, severity: 'warn', rule: 'open_without_close',
+                message: (0, locale_1.t)('open_without_close', openCount, closeCount),
+            }];
+    }
+    return [];
+}
+//# sourceMappingURL=open-close.js.map

package/dist/checks/open-close.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-close.js","sourceRoot":"","sources":["../../src/checks/open-close.ts"],"names":[],"mappings":";;AAIA,sDAaC;AAhBD,oCAAqC;AACrC,sCAA8B;AAE9B,SAAgB,qBAAqB,CAAC,OAAe,EAAE,IAAY;IACjE,IAAI,SAAS,GAAG,CAAC,EAAE,UAAU,GAAG,CAAC,CAAC;IAClC,KAAK,MAAM,EAAE,QAAQ,EAAE,IAAI,IAAA,iBAAS,EAAC,OAAO,CAAC,EAAE,CAAC;QAC9C,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,SAAS,EAAE,CAAC;QAC3C,IAAI,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,UAAU,EAAE,CAAC;IAC/C,CAAC;IACD,IAAI,SAAS,GAAG,UAAU,EAAE,CAAC;QAC3B,OAAO,CAAC;gBACN,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB;gBAC3D,OAAO,EAAE,IAAA,UAAC,EAAC,oBAAoB,EAAE,SAAS,EAAE,UAAU,CAAC;aACxD,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/checks/parens.d.ts

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

package/dist/checks/parens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parens.d.ts","sourceRoot":"","sources":["../../src/checks/parens.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAGjC,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,EAAE,CAmClE"}

package/dist/checks/parens.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkParens = checkParens;
+const locale_1 = require("../locale");
+function checkParens(content, file) {
+    let openP = 0, closeP = 0;
+    let inStr = false;
+    const lines = content.split('\n');
+    for (const line of lines) {
+        let i = 0;
+        while (i < line.length) {
+            const ch = line[i];
+            if (ch === ';' && !inStr)
+                break;
+            if (ch === '"') {
+                inStr = !inStr;
+                i++;
+                continue;
+            }
+            if (ch === '\\' && inStr) {
+                i += 2;
+                continue;
+            }
+            if (!inStr) {
+                if (ch === '(')
+                    openP++;
+                else if (ch === ')')
+                    closeP++;
+            }
+            i++;
+        }
+    }
+    if (openP !== closeP) {
+        const diff = openP - closeP;
+        return [{
+                file, line: 1, severity: 'error', rule: 'parens',
+                message: (0, locale_1.t)('parens.mismatch', openP, closeP, (diff > 0 ? '+' : '') + diff),
+            }];
+    }
+    return [];
+}
+//# sourceMappingURL=parens.js.map

package/dist/checks/parens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parens.js","sourceRoot":"","sources":["../../src/checks/parens.ts"],"names":[],"mappings":";;AAGA,kCAmCC;AArCD,sCAA8B;AAE9B,SAAgB,WAAW,CAAC,OAAe,EAAE,IAAY;IACvD,IAAI,KAAK,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC;IAC1B,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACvB,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACnB,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC,KAAK;gBAAE,MAAM;YAChC,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gBACf,KAAK,GAAG,CAAC,KAAK,CAAC;gBACf,CAAC,EAAE,CAAC;gBACJ,SAAS;YACX,CAAC;YACD,IAAI,EAAE,KAAK,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,CAAC,IAAI,CAAC,CAAC;gBACP,SAAS;YACX,CAAC;YACD,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,IAAI,EAAE,KAAK,GAAG;oBAAE,KAAK,EAAE,CAAC;qBACnB,IAAI,EAAE,KAAK,GAAG;oBAAE,MAAM,EAAE,CAAC;YAChC,CAAC;YACD,CAAC,EAAE,CAAC;QACN,CAAC;IACH,CAAC;IAED,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC;QAC5B,OAAO,CAAC;gBACN,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ;gBAChD,OAAO,EAAE,IAAA,UAAC,EAAC,iBAAiB,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;aAC3E,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/checks/token-in-url.d.ts

@@ -0,0 +1,3 @@
+import { Issue } from '../types';
+export declare function checkTokenInUrl(content: string, file: string): Issue[];
+//# sourceMappingURL=token-in-url.d.ts.map

package/dist/checks/token-in-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-in-url.d.ts","sourceRoot":"","sources":["../../src/checks/token-in-url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAIjC,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,EAAE,CAgBtE"}