@webpieces/ai-hook-rules 0.0.1 → 0.2.114

package/src/core/rules/{require-return-type.ts → require-return-type.js}

@@ -1,23 +1,18 @@
-import type { EditRule, EditContext, Violation } from '../types';
-import { Violation as V } from '../types';
-
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const types_1 = require("../types");
 // Matches function/method signatures that don't have `: ReturnType` before the `{` body opener.
 // Pattern: function name(<params>) { — missing `: Type` between `)` and `{`
 const FUNC_DECL_MISSING = /\bfunction\s+\w+\s*(?:<[^>]*>)?\s*\([^)]*\)\s*\{/;
-
 // Matches class method signatures: indented, optional async, name(<params>) {
 const METHOD_MISSING = /^\s{2,}(?:async\s+)?\w+\s*(?:<[^>]*>)?\s*\([^)]*\)\s*\{/;
-
 // Arrow function: const name = (async)? (<params>) => — missing `: Type` before `=>`
 const ARROW_MISSING = /\bconst\s+\w+\s*=\s*(?:async\s+)?(?:<[^>]*>)?\s*\([^)]*\)\s*=>/;
-
 // Lines that have ): ReturnType before { or => — these are COMPLIANT
 const HAS_RETURN_TYPE = /\)\s*:\s*\S/;
-
 // Skip constructors, getters, setters, and control flow keywords
 const SKIP_PATTERN = /\b(?:constructor|get\s+\w+|set\s+\w+|if|else|while|for|switch|catch|return)\s*\(/;
-
-const requireReturnTypeRule: EditRule = {
+const requireReturnTypeRule = {
     name: 'require-return-type',
     description: 'Every function and method must declare its return type.',
     scope: 'edit',
@@ -27,33 +22,31 @@ const requireReturnTypeRule: EditRule = {
         'Add return type: function foo(x: T): ReturnType { ... }',
         '// webpieces-disable require-return-type -- <reason>',
     ],
-
-    check(ctx: EditContext): readonly Violation[] {
-        const violations: V[] = [];
+    check(ctx) {
+        const violations = [];
         for (let i = 0; i < ctx.strippedLines.length; i += 1) {
             const stripped = ctx.strippedLines[i];
-            if (!isMissingReturnType(stripped)) continue;
+            if (!isMissingReturnType(stripped))
+                continue;
             const lineNum = i + 1;
-            if (ctx.isLineDisabled(lineNum, 'require-return-type')) continue;
-            violations.push(new V(
-                lineNum,
-                ctx.lines[i].trim(),
-                'Missing return type annotation.',
-            ));
+            if (ctx.isLineDisabled(lineNum, 'require-return-type'))
+                continue;
+            violations.push(new types_1.Violation(lineNum, ctx.lines[i].trim(), 'Missing return type annotation.'));
         }
         return violations;
     },
 };
-
-function isMissingReturnType(line: string): boolean {
-    if (SKIP_PATTERN.test(line)) return false;
-    const isFuncLike =
-        FUNC_DECL_MISSING.test(line) ||
+function isMissingReturnType(line) {
+    if (SKIP_PATTERN.test(line))
+        return false;
+    const isFuncLike = FUNC_DECL_MISSING.test(line) ||
         METHOD_MISSING.test(line) ||
         ARROW_MISSING.test(line);
-    if (!isFuncLike) return false;
-    if (HAS_RETURN_TYPE.test(line)) return false;
+    if (!isFuncLike)
+        return false;
+    if (HAS_RETURN_TYPE.test(line))
+        return false;
     return true;
 }
-
-export default requireReturnTypeRule;
+exports.default = requireReturnTypeRule;
+//# sourceMappingURL=require-return-type.js.map

package/src/core/rules/require-return-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-return-type.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/ai-hook-rules/src/core/rules/require-return-type.ts"],"names":[],"mappings":";;AACA,oCAA0C;AAE1C,gGAAgG;AAChG,4EAA4E;AAC5E,MAAM,iBAAiB,GAAG,kDAAkD,CAAC;AAE7E,8EAA8E;AAC9E,MAAM,cAAc,GAAG,yDAAyD,CAAC;AAEjF,qFAAqF;AACrF,MAAM,aAAa,GAAG,gEAAgE,CAAC;AAEvF,qEAAqE;AACrE,MAAM,eAAe,GAAG,aAAa,CAAC;AAEtC,iEAAiE;AACjE,MAAM,YAAY,GAAG,kFAAkF,CAAC;AAExG,MAAM,qBAAqB,GAAa;IACpC,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE,yDAAyD;IACtE,KAAK,EAAE,MAAM;IACb,KAAK,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC;IAC9B,cAAc,EAAE,EAAE;IAClB,OAAO,EAAE;QACL,yDAAyD;QACzD,sDAAsD;KACzD;IAED,KAAK,CAAC,GAAgB;QAClB,MAAM,UAAU,GAAQ,EAAE,CAAC;QAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACnD,MAAM,QAAQ,GAAG,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;YACtC,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC;gBAAE,SAAS;YAC7C,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;YACtB,IAAI,GAAG,CAAC,cAAc,CAAC,OAAO,EAAE,qBAAqB,CAAC;gBAAE,SAAS;YACjE,UAAU,CAAC,IAAI,CAAC,IAAI,iBAAC,CACjB,OAAO,EACP,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EACnB,iCAAiC,CACpC,CAAC,CAAC;QACP,CAAC;QACD,OAAO,UAAU,CAAC;IACtB,CAAC;CACJ,CAAC;AAEF,SAAS,mBAAmB,CAAC,IAAY;IACrC,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,MAAM,UAAU,GACZ,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC;QAC5B,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;QACzB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9B,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7C,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,kBAAe,qBAAqB,CAAC","sourcesContent":["import type { EditRule, EditContext, Violation } from '../types';\nimport { Violation as V } from '../types';\n\n// Matches function/method signatures that don't have `: ReturnType` before the `{` body opener.\n// Pattern: function name(<params>) { — missing `: Type` between `)` and `{`\nconst FUNC_DECL_MISSING = /\\bfunction\\s+\\w+\\s*(?:<[^>]*>)?\\s*\\([^)]*\\)\\s*\\{/;\n\n// Matches class method signatures: indented, optional async, name(<params>) {\nconst METHOD_MISSING = /^\\s{2,}(?:async\\s+)?\\w+\\s*(?:<[^>]*>)?\\s*\\([^)]*\\)\\s*\\{/;\n\n// Arrow function: const name = (async)? (<params>) => — missing `: Type` before `=>`\nconst ARROW_MISSING = /\\bconst\\s+\\w+\\s*=\\s*(?:async\\s+)?(?:<[^>]*>)?\\s*\\([^)]*\\)\\s*=>/;\n\n// Lines that have ): ReturnType before { or => — these are COMPLIANT\nconst HAS_RETURN_TYPE = /\\)\\s*:\\s*\\S/;\n\n// Skip constructors, getters, setters, and control flow keywords\nconst SKIP_PATTERN = /\\b(?:constructor|get\\s+\\w+|set\\s+\\w+|if|else|while|for|switch|catch|return)\\s*\\(/;\n\nconst requireReturnTypeRule: EditRule = {\n    name: 'require-return-type',\n    description: 'Every function and method must declare its return type.',\n    scope: 'edit',\n    files: ['**/*.ts', '**/*.tsx'],\n    defaultOptions: {},\n    fixHint: [\n        'Add return type: function foo(x: T): ReturnType { ... }',\n        '// webpieces-disable require-return-type -- <reason>',\n    ],\n\n    check(ctx: EditContext): readonly Violation[] {\n        const violations: V[] = [];\n        for (let i = 0; i < ctx.strippedLines.length; i += 1) {\n            const stripped = ctx.strippedLines[i];\n            if (!isMissingReturnType(stripped)) continue;\n            const lineNum = i + 1;\n            if (ctx.isLineDisabled(lineNum, 'require-return-type')) continue;\n            violations.push(new V(\n                lineNum,\n                ctx.lines[i].trim(),\n                'Missing return type annotation.',\n            ));\n        }\n        return violations;\n    },\n};\n\nfunction isMissingReturnType(line: string): boolean {\n    if (SKIP_PATTERN.test(line)) return false;\n    const isFuncLike =\n        FUNC_DECL_MISSING.test(line) ||\n        METHOD_MISSING.test(line) ||\n        ARROW_MISSING.test(line);\n    if (!isFuncLike) return false;\n    if (HAS_RETURN_TYPE.test(line)) return false;\n    return true;\n}\n\nexport default requireReturnTypeRule;\n"]}

package/src/core/runner.d.ts

@@ -0,0 +1,3 @@
+import { ToolKind, NormalizedToolInput, BlockedResult } from './types';
+export declare function run(toolKind: ToolKind, input: NormalizedToolInput, cwd: string): BlockedResult | null;
+export declare function runBash(command: string, cwd: string): BlockedResult | null;

package/src/core/runner.js

@@ -0,0 +1,181 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run = run;
+exports.runBash = runBash;
+const tslib_1 = require("tslib");
+const path = tslib_1.__importStar(require("path"));
+const build_context_1 = require("./build-context");
+const load_config_1 = require("./load-config");
+const load_rules_1 = require("./load-rules");
+const to_error_1 = require("./to-error");
+const report_1 = require("./report");
+const types_1 = require("./types");
+function run(toolKind, input, cwd) {
+    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions
+    try {
+        return runInternal(toolKind, input, cwd);
+    }
+    catch (err) {
+        const error = (0, to_error_1.toError)(err);
+        console.error(`[ai-hooks] runner crashed (failing open): ${error.message}`);
+        return null;
+    }
+}
+function runInternal(toolKind, input, cwd) {
+    const config = (0, load_config_1.loadConfig)(cwd);
+    if (!config.configPath)
+        return null;
+    const workspaceRoot = path.dirname(config.configPath);
+    const rules = (0, load_rules_1.loadRules)(config, workspaceRoot);
+    if (rules.length === 0)
+        return null;
+    const contexts = (0, build_context_1.buildContexts)(toolKind, input, workspaceRoot);
+    const relativePath = path.relative(workspaceRoot, input.filePath);
+    const editGroups = runEditRules(rules, contexts.editContexts, config);
+    const fileGroups = runFileRules(rules, contexts.fileContext, config);
+    const allGroups = [...editGroups, ...fileGroups];
+    if (allGroups.length === 0)
+        return null;
+    const report = (0, report_1.formatReport)(relativePath, allGroups);
+    return new types_1.BlockedResult(report);
+}
+function runBash(command, cwd) {
+    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions
+    try {
+        return runBashInternal(command, cwd);
+    }
+    catch (err) {
+        const error = (0, to_error_1.toError)(err);
+        console.error(`[ai-hooks] bash runner crashed (failing open): ${error.message}`);
+        return null;
+    }
+}
+function runBashInternal(command, cwd) {
+    const config = (0, load_config_1.loadConfig)(cwd);
+    if (!config.configPath)
+        return null;
+    const workspaceRoot = path.dirname(config.configPath);
+    const rules = (0, load_rules_1.loadRules)(config, workspaceRoot);
+    if (rules.length === 0)
+        return null;
+    const ctx = (0, build_context_1.buildBashContext)(command, workspaceRoot);
+    const groups = runBashRules(rules, ctx, config);
+    if (groups.length === 0)
+        return null;
+    const report = (0, report_1.formatReport)('<bash>', groups);
+    return new types_1.BlockedResult(report);
+}
+function safeCheckBash(rule, ctx) {
+    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions
+    try {
+        return rule.check(ctx);
+    }
+    catch (err) {
+        const error = (0, to_error_1.toError)(err);
+        process.stderr.write(`[ai-hooks] rule ${rule.name} crashed: ${error.message}\n`);
+        return [];
+    }
+}
+function runBashRules(rules, bashContext, config) {
+    const groups = [];
+    for (const rule of rules) {
+        if (rule.scope !== 'bash')
+            continue;
+        const ruleConfig = config.rules.get(rule.name);
+        if (!ruleConfig || ruleConfig.enabled === false)
+            continue;
+        bashContext.options = mergeOptions(rule.defaultOptions, ruleConfig);
+        const vs = safeCheckBash(rule, bashContext);
+        if (vs.length > 0) {
+            groups.push(new types_1.RuleGroup(rule.name, rule.description, [...rule.fixHint], [...vs]));
+        }
+    }
+    return groups;
+}
+function ruleMatchesFile(rule, relativePath) {
+    for (const pattern of rule.files) {
+        if ((0, load_rules_1.globMatches)(pattern, relativePath))
+            return true;
+    }
+    return false;
+}
+function mergeOptions(defaultOptions, ruleConfig) {
+    // webpieces-disable no-any-unknown -- building an options bag from opaque RuleOptions
+    const out = {};
+    for (const key of Object.keys(defaultOptions))
+        out[key] = defaultOptions[key];
+    for (const key of Object.keys(ruleConfig.options)) {
+        if (key === 'enabled')
+            continue;
+        out[key] = ruleConfig.options[key];
+    }
+    return out;
+}
+function safeCheckEdit(rule, ctx) {
+    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions
+    try {
+        return rule.check(ctx);
+    }
+    catch (err) {
+        const error = (0, to_error_1.toError)(err);
+        process.stderr.write(`[ai-hooks] rule ${rule.name} crashed: ${error.message}\n`);
+        return [];
+    }
+}
+function safeCheckFile(rule, ctx) {
+    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions
+    try {
+        return rule.check(ctx);
+    }
+    catch (err) {
+        const error = (0, to_error_1.toError)(err);
+        process.stderr.write(`[ai-hooks] rule ${rule.name} crashed: ${error.message}\n`);
+        return [];
+    }
+}
+function runEditRules(rules, editContexts, config) {
+    const groups = [];
+    for (const rule of rules) {
+        if (rule.scope !== 'edit')
+            continue;
+        const ruleConfig = config.rules.get(rule.name);
+        if (!ruleConfig || ruleConfig.enabled === false)
+            continue;
+        const allViolations = [];
+        for (const ctx of editContexts) {
+            if (!ruleMatchesFile(rule, ctx.relativePath))
+                continue;
+            ctx.options = mergeOptions(rule.defaultOptions, ruleConfig);
+            const vs = safeCheckEdit(rule, ctx);
+            for (const v of vs) {
+                const copy = new types_1.Violation(v.line, v.snippet, v.message);
+                copy.editIndex = ctx.editIndex;
+                copy.editCount = ctx.editCount;
+                allViolations.push(copy);
+            }
+        }
+        if (allViolations.length > 0) {
+            groups.push(new types_1.RuleGroup(rule.name, rule.description, [...rule.fixHint], allViolations));
+        }
+    }
+    return groups;
+}
+function runFileRules(rules, fileContext, config) {
+    const groups = [];
+    for (const rule of rules) {
+        if (rule.scope !== 'file')
+            continue;
+        const ruleConfig = config.rules.get(rule.name);
+        if (!ruleConfig || ruleConfig.enabled === false)
+            continue;
+        if (!ruleMatchesFile(rule, fileContext.relativePath))
+            continue;
+        fileContext.options = mergeOptions(rule.defaultOptions, ruleConfig);
+        const vs = safeCheckFile(rule, fileContext);
+        if (vs.length > 0) {
+            groups.push(new types_1.RuleGroup(rule.name, rule.description, [...rule.fixHint], [...vs]));
+        }
+    }
+    return groups;
+}
+//# sourceMappingURL=runner.js.map

package/src/core/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../../../../../packages/tooling/ai-hook-rules/src/core/runner.ts"],"names":[],"mappings":"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","sourcesContent":["import * as path from 'path';\n\nimport { buildContexts, buildBashContext } from './build-context';\nimport { loadConfig } from './load-config';\nimport { loadRules, globMatches } from './load-rules';\nimport { toError } from './to-error';\nimport { formatReport } from './report';\nimport {\n    ToolKind, NormalizedToolInput, BlockedResult,\n    Rule, EditRule, FileRule, BashRule, Violation, RuleGroup,\n    EditContext, FileContext, BashContext,\n    ResolvedConfig, ResolvedRuleConfig, RuleOptions,\n} from './types';\n\nexport function run(\n    toolKind: ToolKind,\n    input: NormalizedToolInput,\n    cwd: string,\n): BlockedResult | null {\n    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n    try {\n        return runInternal(toolKind, input, cwd);\n    } catch (err: unknown) {\n        const error = toError(err);\n        console.error(`[ai-hooks] runner crashed (failing open): ${error.message}`);\n        return null;\n    }\n}\n\nfunction runInternal(\n    toolKind: ToolKind,\n    input: NormalizedToolInput,\n    cwd: string,\n): BlockedResult | null {\n    const config = loadConfig(cwd);\n    if (!config.configPath) return null;\n\n    const workspaceRoot = path.dirname(config.configPath);\n    const rules = loadRules(config, workspaceRoot);\n    if (rules.length === 0) return null;\n\n    const contexts = buildContexts(toolKind, input, workspaceRoot);\n    const relativePath = path.relative(workspaceRoot, input.filePath);\n\n    const editGroups = runEditRules(rules, contexts.editContexts, config);\n    const fileGroups = runFileRules(rules, contexts.fileContext, config);\n    const allGroups = [...editGroups, ...fileGroups];\n\n    if (allGroups.length === 0) return null;\n\n    const report = formatReport(relativePath, allGroups);\n    return new BlockedResult(report);\n}\n\nexport function runBash(command: string, cwd: string): BlockedResult | null {\n    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n    try {\n        return runBashInternal(command, cwd);\n    } catch (err: unknown) {\n        const error = toError(err);\n        console.error(`[ai-hooks] bash runner crashed (failing open): ${error.message}`);\n        return null;\n    }\n}\n\nfunction runBashInternal(command: string, cwd: string): BlockedResult | null {\n    const config = loadConfig(cwd);\n    if (!config.configPath) return null;\n\n    const workspaceRoot = path.dirname(config.configPath);\n    const rules = loadRules(config, workspaceRoot);\n    if (rules.length === 0) return null;\n\n    const ctx = buildBashContext(command, workspaceRoot);\n    const groups = runBashRules(rules, ctx, config);\n    if (groups.length === 0) return null;\n\n    const report = formatReport('<bash>', groups);\n    return new BlockedResult(report);\n}\n\nfunction safeCheckBash(rule: BashRule, ctx: BashContext): readonly Violation[] {\n    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n    try {\n        return rule.check(ctx);\n    } catch (err: unknown) {\n        const error = toError(err);\n        process.stderr.write(`[ai-hooks] rule ${rule.name} crashed: ${error.message}\\n`);\n        return [];\n    }\n}\n\nfunction runBashRules(\n    rules: readonly Rule[],\n    bashContext: BashContext,\n    config: ResolvedConfig,\n): readonly RuleGroup[] {\n    const groups: RuleGroup[] = [];\n    for (const rule of rules) {\n        if (rule.scope !== 'bash') continue;\n        const ruleConfig = config.rules.get(rule.name);\n        if (!ruleConfig || ruleConfig.enabled === false) continue;\n        bashContext.options = mergeOptions(rule.defaultOptions, ruleConfig);\n        const vs = safeCheckBash(rule as BashRule, bashContext);\n        if (vs.length > 0) {\n            groups.push(new RuleGroup(\n                rule.name, rule.description, [...rule.fixHint], [...vs],\n            ));\n        }\n    }\n    return groups;\n}\n\nfunction ruleMatchesFile(rule: Rule, relativePath: string): boolean {\n    for (const pattern of rule.files) {\n        if (globMatches(pattern, relativePath)) return true;\n    }\n    return false;\n}\n\nfunction mergeOptions(defaultOptions: RuleOptions, ruleConfig: ResolvedRuleConfig): RuleOptions {\n    // webpieces-disable no-any-unknown -- building an options bag from opaque RuleOptions\n    const out: Record<string, unknown> = {};\n    for (const key of Object.keys(defaultOptions)) out[key] = defaultOptions[key];\n    for (const key of Object.keys(ruleConfig.options)) {\n        if (key === 'enabled') continue;\n        out[key] = ruleConfig.options[key];\n    }\n    return out;\n}\n\nfunction safeCheckEdit(rule: EditRule, ctx: EditContext): readonly Violation[] {\n    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n    try {\n        return rule.check(ctx);\n    } catch (err: unknown) {\n        const error = toError(err);\n        process.stderr.write(`[ai-hooks] rule ${rule.name} crashed: ${error.message}\\n`);\n        return [];\n    }\n}\n\nfunction safeCheckFile(rule: FileRule, ctx: FileContext): readonly Violation[] {\n    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n    try {\n        return rule.check(ctx);\n    } catch (err: unknown) {\n        const error = toError(err);\n        process.stderr.write(`[ai-hooks] rule ${rule.name} crashed: ${error.message}\\n`);\n        return [];\n    }\n}\n\nfunction runEditRules(\n    rules: readonly Rule[],\n    editContexts: readonly EditContext[],\n    config: ResolvedConfig,\n): readonly RuleGroup[] {\n    const groups: RuleGroup[] = [];\n    for (const rule of rules) {\n        if (rule.scope !== 'edit') continue;\n        const ruleConfig = config.rules.get(rule.name);\n        if (!ruleConfig || ruleConfig.enabled === false) continue;\n        const allViolations: Violation[] = [];\n        for (const ctx of editContexts) {\n            if (!ruleMatchesFile(rule, ctx.relativePath)) continue;\n            ctx.options = mergeOptions(rule.defaultOptions, ruleConfig);\n            const vs = safeCheckEdit(rule as EditRule, ctx);\n            for (const v of vs) {\n                const copy = new Violation(v.line, v.snippet, v.message);\n                copy.editIndex = ctx.editIndex;\n                copy.editCount = ctx.editCount;\n                allViolations.push(copy);\n            }\n        }\n        if (allViolations.length > 0) {\n            groups.push(new RuleGroup(\n                rule.name, rule.description, [...rule.fixHint], allViolations,\n            ));\n        }\n    }\n    return groups;\n}\n\nfunction runFileRules(\n    rules: readonly Rule[],\n    fileContext: FileContext,\n    config: ResolvedConfig,\n): readonly RuleGroup[] {\n    const groups: RuleGroup[] = [];\n    for (const rule of rules) {\n        if (rule.scope !== 'file') continue;\n        const ruleConfig = config.rules.get(rule.name);\n        if (!ruleConfig || ruleConfig.enabled === false) continue;\n        if (!ruleMatchesFile(rule, fileContext.relativePath)) continue;\n        fileContext.options = mergeOptions(rule.defaultOptions, ruleConfig);\n        const vs = safeCheckFile(rule as FileRule, fileContext);\n        if (vs.length > 0) {\n            groups.push(new RuleGroup(\n                rule.name, rule.description, [...rule.fixHint], [...vs],\n            ));\n        }\n    }\n    return groups;\n}\n"]}

package/src/core/strip-ts-noise.d.ts

@@ -0,0 +1 @@
+export declare function stripTsNoise(source: string): string;

package/src/core/strip-ts-noise.js

@@ -0,0 +1,178 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripTsNoise = stripTsNoise;
+class StripState {
+    constructor(source) {
+        this.source = source;
+        this.len = source.length;
+        this.out = new Array(source.length);
+        this.stack = [];
+        this.state = 'code';
+        this.braceDepth = 0;
+        this.i = 0;
+    }
+    ch() { return this.source[this.i]; }
+    next() { return this.i + 1 < this.len ? this.source[this.i + 1] : ''; }
+    emit(idx, ch) { this.out[idx] = ch; }
+    blank(idx, ch) { this.out[idx] = ch === '\n' ? '\n' : ' '; }
+    pushState(newState) {
+        this.stack.push({ state: this.state, braceDepth: this.braceDepth });
+        this.state = newState;
+    }
+    popState() {
+        const frame = this.stack.pop();
+        this.state = frame.state;
+        this.braceDepth = frame.braceDepth;
+    }
+}
+function handleCodeOrInterp(s) {
+    const ch = s.ch();
+    const next = s.next();
+    if (s.state === 'templateInterp') {
+        if (ch === '{') {
+            s.braceDepth += 1;
+            s.emit(s.i, ch);
+            s.i += 1;
+            return;
+        }
+        if (ch === '}') {
+            if (s.braceDepth === 0) {
+                s.emit(s.i, ch);
+                s.i += 1;
+                s.popState();
+                return;
+            }
+            s.braceDepth -= 1;
+            s.emit(s.i, ch);
+            s.i += 1;
+            return;
+        }
+    }
+    if (ch === '/' && next === '/') {
+        s.emit(s.i, '/');
+        s.emit(s.i + 1, '/');
+        s.i += 2;
+        s.pushState('lineComment');
+        return;
+    }
+    if (ch === '/' && next === '*') {
+        s.emit(s.i, '/');
+        s.emit(s.i + 1, '*');
+        s.i += 2;
+        s.pushState('blockComment');
+        return;
+    }
+    if (ch === '"') {
+        s.emit(s.i, '"');
+        s.i += 1;
+        s.pushState('dquote');
+        return;
+    }
+    if (ch === "'") {
+        s.emit(s.i, "'");
+        s.i += 1;
+        s.pushState('squote');
+        return;
+    }
+    if (ch === '`') {
+        s.emit(s.i, '`');
+        s.i += 1;
+        s.pushState('template');
+        return;
+    }
+    s.emit(s.i, ch);
+    s.i += 1;
+}
+function handleLineComment(s) {
+    if (s.ch() === '\n') {
+        s.emit(s.i, '\n');
+        s.i += 1;
+        s.popState();
+        return;
+    }
+    s.blank(s.i, s.ch());
+    s.i += 1;
+}
+function handleBlockComment(s) {
+    if (s.ch() === '*' && s.next() === '/') {
+        s.emit(s.i, '*');
+        s.emit(s.i + 1, '/');
+        s.i += 2;
+        s.popState();
+        return;
+    }
+    s.blank(s.i, s.ch());
+    s.i += 1;
+}
+function handleStringLiteral(s, quoteChar) {
+    const ch = s.ch();
+    if (ch === '\\' && s.i + 1 < s.len) {
+        s.blank(s.i, ch);
+        s.blank(s.i + 1, s.source[s.i + 1]);
+        s.i += 2;
+        return;
+    }
+    if (ch === quoteChar) {
+        s.emit(s.i, quoteChar);
+        s.i += 1;
+        s.popState();
+        return;
+    }
+    s.blank(s.i, ch);
+    s.i += 1;
+}
+function handleTemplate(s) {
+    const ch = s.ch();
+    if (ch === '\\' && s.i + 1 < s.len) {
+        s.blank(s.i, ch);
+        s.blank(s.i + 1, s.source[s.i + 1]);
+        s.i += 2;
+        return;
+    }
+    if (ch === '`') {
+        s.emit(s.i, '`');
+        s.i += 1;
+        s.popState();
+        return;
+    }
+    if (ch === '$' && s.next() === '{') {
+        s.emit(s.i, '$');
+        s.emit(s.i + 1, '{');
+        s.i += 2;
+        s.stack.push({ state: 'template', braceDepth: 0 });
+        s.state = 'templateInterp';
+        s.braceDepth = 0;
+        return;
+    }
+    s.blank(s.i, ch);
+    s.i += 1;
+}
+function stripTsNoise(source) {
+    const s = new StripState(source);
+    while (s.i < s.len) {
+        if (s.state === 'code' || s.state === 'templateInterp') {
+            handleCodeOrInterp(s);
+        }
+        else if (s.state === 'lineComment') {
+            handleLineComment(s);
+        }
+        else if (s.state === 'blockComment') {
+            handleBlockComment(s);
+        }
+        else if (s.state === 'dquote') {
+            handleStringLiteral(s, '"');
+        }
+        else if (s.state === 'squote') {
+            handleStringLiteral(s, "'");
+        }
+        else if (s.state === 'template') {
+            handleTemplate(s);
+        }
+        else {
+            s.emit(s.i, s.ch());
+            s.i += 1;
+        }
+    }
+    return s.out.join('');
+}
+//# sourceMappingURL=strip-ts-noise.js.map

package/src/core/strip-ts-noise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip-ts-noise.js","sourceRoot":"","sources":["../../../../../../packages/tooling/ai-hook-rules/src/core/strip-ts-noise.ts"],"names":[],"mappings":"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","sourcesContent":["interface StackFrame {\n    readonly state: string;\n    readonly braceDepth: number;\n}\n\nclass StripState {\n    readonly source: string;\n    readonly len: number;\n    readonly out: string[];\n    readonly stack: StackFrame[];\n    state: string;\n    braceDepth: number;\n    i: number;\n\n    constructor(source: string) {\n        this.source = source;\n        this.len = source.length;\n        this.out = new Array<string>(source.length);\n        this.stack = [];\n        this.state = 'code';\n        this.braceDepth = 0;\n        this.i = 0;\n    }\n\n    ch(): string { return this.source[this.i]; }\n    next(): string { return this.i + 1 < this.len ? this.source[this.i + 1] : ''; }\n    emit(idx: number, ch: string): void { this.out[idx] = ch; }\n    blank(idx: number, ch: string): void { this.out[idx] = ch === '\\n' ? '\\n' : ' '; }\n\n    pushState(newState: string): void {\n        this.stack.push({ state: this.state, braceDepth: this.braceDepth });\n        this.state = newState;\n    }\n\n    popState(): void {\n        const frame = this.stack.pop()!;\n        this.state = frame.state;\n        this.braceDepth = frame.braceDepth;\n    }\n}\n\nfunction handleCodeOrInterp(s: StripState): void {\n    const ch = s.ch();\n    const next = s.next();\n\n    if (s.state === 'templateInterp') {\n        if (ch === '{') { s.braceDepth += 1; s.emit(s.i, ch); s.i += 1; return; }\n        if (ch === '}') {\n            if (s.braceDepth === 0) { s.emit(s.i, ch); s.i += 1; s.popState(); return; }\n            s.braceDepth -= 1; s.emit(s.i, ch); s.i += 1; return;\n        }\n    }\n    if (ch === '/' && next === '/') { s.emit(s.i, '/'); s.emit(s.i + 1, '/'); s.i += 2; s.pushState('lineComment'); return; }\n    if (ch === '/' && next === '*') { s.emit(s.i, '/'); s.emit(s.i + 1, '*'); s.i += 2; s.pushState('blockComment'); return; }\n    if (ch === '\"') { s.emit(s.i, '\"'); s.i += 1; s.pushState('dquote'); return; }\n    if (ch === \"'\") { s.emit(s.i, \"'\"); s.i += 1; s.pushState('squote'); return; }\n    if (ch === '`') { s.emit(s.i, '`'); s.i += 1; s.pushState('template'); return; }\n    s.emit(s.i, ch); s.i += 1;\n}\n\nfunction handleLineComment(s: StripState): void {\n    if (s.ch() === '\\n') { s.emit(s.i, '\\n'); s.i += 1; s.popState(); return; }\n    s.blank(s.i, s.ch()); s.i += 1;\n}\n\nfunction handleBlockComment(s: StripState): void {\n    if (s.ch() === '*' && s.next() === '/') { s.emit(s.i, '*'); s.emit(s.i + 1, '/'); s.i += 2; s.popState(); return; }\n    s.blank(s.i, s.ch()); s.i += 1;\n}\n\nfunction handleStringLiteral(s: StripState, quoteChar: string): void {\n    const ch = s.ch();\n    if (ch === '\\\\' && s.i + 1 < s.len) { s.blank(s.i, ch); s.blank(s.i + 1, s.source[s.i + 1]); s.i += 2; return; }\n    if (ch === quoteChar) { s.emit(s.i, quoteChar); s.i += 1; s.popState(); return; }\n    s.blank(s.i, ch); s.i += 1;\n}\n\nfunction handleTemplate(s: StripState): void {\n    const ch = s.ch();\n    if (ch === '\\\\' && s.i + 1 < s.len) { s.blank(s.i, ch); s.blank(s.i + 1, s.source[s.i + 1]); s.i += 2; return; }\n    if (ch === '`') { s.emit(s.i, '`'); s.i += 1; s.popState(); return; }\n    if (ch === '$' && s.next() === '{') {\n        s.emit(s.i, '$'); s.emit(s.i + 1, '{'); s.i += 2;\n        s.stack.push({ state: 'template', braceDepth: 0 });\n        s.state = 'templateInterp'; s.braceDepth = 0;\n        return;\n    }\n    s.blank(s.i, ch); s.i += 1;\n}\n\nexport function stripTsNoise(source: string): string {\n    const s = new StripState(source);\n    while (s.i < s.len) {\n        if (s.state === 'code' || s.state === 'templateInterp') { handleCodeOrInterp(s); }\n        else if (s.state === 'lineComment') { handleLineComment(s); }\n        else if (s.state === 'blockComment') { handleBlockComment(s); }\n        else if (s.state === 'dquote') { handleStringLiteral(s, '\"'); }\n        else if (s.state === 'squote') { handleStringLiteral(s, \"'\"); }\n        else if (s.state === 'template') { handleTemplate(s); }\n        else { s.emit(s.i, s.ch()); s.i += 1; }\n    }\n    return s.out.join('');\n}\n"]}

package/src/core/to-error.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Lightweight duplicate of @webpieces/core-util toError.
+ * ai-hooks is a standalone package and cannot depend on core-util or dev-config.
+ */
+export declare function toError(err: unknown): Error;

package/src/core/{to-error.ts → to-error.js}

@@ -1,14 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toError = toError;
 // ai-hook-disable-file require-return-type -- toError is a utility copied from dev-config; function return type is on line 6
 /**
  * Lightweight duplicate of @webpieces/core-util toError.
  * ai-hooks is a standalone package and cannot depend on core-util or dev-config.
  */
 // webpieces-disable no-any-unknown -- toError intentionally accepts unknown to safely convert any thrown value to Error
-export function toError(err: unknown): Error {
+function toError(err) {
     if (err instanceof Error) {
         return err;
     }
-
     if (err && typeof err === 'object') {
         if ('message' in err) {
             const error = new Error(String(err.message));
@@ -23,13 +25,14 @@ export function toError(err: unknown): Error {
         // eslint-disable-next-line @webpieces/no-unmanaged-exceptions
         try {
             return new Error(`Non-Error object thrown: ${JSON.stringify(err)}`);
-        } catch (err: unknown) {
+        }
+        catch (err) {
             //const error = toError(err);
             void err;
             return new Error('Non-Error object thrown (unable to stringify)');
         }
     }
-
     const message = err == null ? 'Null or undefined thrown' : String(err);
     return new Error(message);
 }
+//# sourceMappingURL=to-error.js.map

package/src/core/to-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-error.js","sourceRoot":"","sources":["../../../../../../packages/tooling/ai-hook-rules/src/core/to-error.ts"],"names":[],"mappings":";;AAMA,0BA4BC;AAlCD,6HAA6H;AAC7H;;;GAGG;AACH,wHAAwH;AACxH,SAAgB,OAAO,CAAC,GAAY;IAChC,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC;IACf,CAAC;IAED,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACjC,IAAI,SAAS,IAAI,GAAG,EAAE,CAAC;YACnB,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;YAC7C,IAAI,OAAO,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAClD,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;YAC5B,CAAC;YACD,IAAI,MAAM,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAChD,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;YAC1B,CAAC;YACD,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,8DAA8D;QAC9D,IAAI,CAAC;YACD,OAAO,IAAI,KAAK,CAAC,4BAA4B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACxE,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACpB,6BAA6B;YAC7B,KAAK,GAAG,CAAC;YACT,OAAO,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACtE,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACvE,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;AAC9B,CAAC","sourcesContent":["// ai-hook-disable-file require-return-type -- toError is a utility copied from dev-config; function return type is on line 6\n/**\n * Lightweight duplicate of @webpieces/core-util toError.\n * ai-hooks is a standalone package and cannot depend on core-util or dev-config.\n */\n// webpieces-disable no-any-unknown -- toError intentionally accepts unknown to safely convert any thrown value to Error\nexport function toError(err: unknown): Error {\n    if (err instanceof Error) {\n        return err;\n    }\n\n    if (err && typeof err === 'object') {\n        if ('message' in err) {\n            const error = new Error(String(err.message));\n            if ('stack' in err && typeof err.stack === 'string') {\n                error.stack = err.stack;\n            }\n            if ('name' in err && typeof err.name === 'string') {\n                error.name = err.name;\n            }\n            return error;\n        }\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n        try {\n            return new Error(`Non-Error object thrown: ${JSON.stringify(err)}`);\n        } catch (err: unknown) {\n            //const error = toError(err);\n            void err;\n            return new Error('Non-Error object thrown (unable to stringify)');\n        }\n    }\n\n    const message = err == null ? 'Null or undefined thrown' : String(err);\n    return new Error(message);\n}\n"]}

package/src/core/types.d.ts

@@ -0,0 +1,93 @@
+import { RuleOptions } from '@webpieces/rules-config';
+export { ResolvedConfig, ResolvedRuleConfig, RuleOptions } from '@webpieces/rules-config';
+export type ToolKind = 'Write' | 'Edit' | 'MultiEdit';
+export type RuleScope = 'edit' | 'file' | 'bash';
+export type IsLineDisabled = (lineNum: number, ruleName: string) => boolean;
+export declare class Violation {
+    readonly line: number;
+    readonly snippet: string;
+    readonly message: string;
+    editIndex: number | undefined;
+    editCount: number | undefined;
+    constructor(line: number, snippet: string, message: string);
+}
+export declare class NormalizedEdit {
+    readonly oldString: string;
+    readonly newString: string;
+    constructor(oldString: string, newString: string);
+}
+export declare class NormalizedToolInput {
+    readonly filePath: string;
+    readonly edits: readonly NormalizedEdit[];
+    constructor(filePath: string, edits: readonly NormalizedEdit[]);
+}
+export declare class NormalizedBashInput {
+    readonly command: string;
+    constructor(command: string);
+}
+export declare class EditContext {
+    readonly tool: ToolKind;
+    readonly editIndex: number;
+    readonly editCount: number;
+    readonly filePath: string;
+    readonly relativePath: string;
+    readonly workspaceRoot: string;
+    readonly addedContent: string;
+    readonly strippedContent: string;
+    readonly lines: readonly string[];
+    readonly strippedLines: readonly string[];
+    readonly removedContent: string;
+    readonly isLineDisabled: IsLineDisabled;
+    options: RuleOptions;
+    constructor(tool: ToolKind, editIndex: number, editCount: number, filePath: string, relativePath: string, workspaceRoot: string, addedContent: string, strippedContent: string, lines: readonly string[], strippedLines: readonly string[], removedContent: string, isLineDisabled: IsLineDisabled);
+}
+export declare class BashContext {
+    readonly tool: 'Bash';
+    readonly command: string;
+    readonly workspaceRoot: string;
+    options: RuleOptions;
+    constructor(command: string, workspaceRoot: string);
+}
+export declare class FileContext {
+    readonly tool: ToolKind;
+    readonly filePath: string;
+    readonly relativePath: string;
+    readonly workspaceRoot: string;
+    readonly currentFileLines: number;
+    readonly linesAdded: number;
+    readonly linesRemoved: number;
+    readonly projectedFileLines: number;
+    options: RuleOptions;
+    constructor(tool: ToolKind, filePath: string, relativePath: string, workspaceRoot: string, currentFileLines: number, linesAdded: number, linesRemoved: number, projectedFileLines: number);
+}
+interface RuleBase {
+    readonly name: string;
+    readonly description: string;
+    readonly files: readonly string[];
+    readonly defaultOptions: RuleOptions;
+    readonly fixHint: readonly string[];
+}
+export interface EditRule extends RuleBase {
+    readonly scope: 'edit';
+    check(ctx: EditContext): readonly Violation[];
+}
+export interface FileRule extends RuleBase {
+    readonly scope: 'file';
+    check(ctx: FileContext): readonly Violation[];
+}
+export interface BashRule extends RuleBase {
+    readonly scope: 'bash';
+    check(ctx: BashContext): readonly Violation[];
+}
+export type Rule = EditRule | FileRule | BashRule;
+export declare class RuleGroup {
+    readonly ruleName: string;
+    readonly ruleDescription: string;
+    readonly fixHint: readonly string[];
+    readonly violations: readonly Violation[];
+    constructor(ruleName: string, ruleDescription: string, fixHint: readonly string[], violations: readonly Violation[]);
+}
+export declare class BlockedResult {
+    readonly report: string;
+    constructor(report: string);
+}