@webpieces/ai-hook-rules 0.0.1 → 0.2.113

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpieces/ai-hook-rules",
-  "version": "0.0.1",
+  "version": "0.2.113",
   "description": "Pluggable write-time validation framework for AI coding agents (@webpieces/ai-hook-rules). Claude Code PreToolUse + openclaw before_tool_call adapters share one rule engine.",
   "type": "commonjs",
   "main": "./src/index.js",
@@ -29,9 +29,10 @@
     "directory": "packages/tooling/ai-hook-rules"
   },
   "dependencies": {
-    "@webpieces/rules-config": "0.0.1"
+    "@webpieces/rules-config": "0.2.113"
   },
   "publishConfig": {
     "access": "public"
-  }
+  },
+  "types": "./src/index.d.ts"
 }

package/src/adapters/claude-code-hook.d.ts

@@ -0,0 +1 @@
+export declare function main(): Promise<void>;

package/src/adapters/claude-code-hook.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.main = main;
+const runner_1 = require("../core/runner");
+const rejection_log_1 = require("../core/rejection-log");
+const types_1 = require("../core/types");
+const to_error_1 = require("../core/to-error");
+const HANDLED_FILE_TOOLS = new Set(['Write', 'Edit', 'MultiEdit']);
+function readStdin() {
+    return new Promise((resolve) => {
+        let data = '';
+        process.stdin.setEncoding('utf8');
+        process.stdin.on('data', (chunk) => { data += chunk; });
+        process.stdin.on('end', () => resolve(data));
+        process.stdin.on('error', () => resolve(''));
+        if (process.stdin.isTTY)
+            resolve('');
+    });
+}
+function safeParse(raw) {
+    if (!raw || raw.trim() === '')
+        return null;
+    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions
+    try {
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        const error = (0, to_error_1.toError)(err);
+        void error;
+        return null;
+    }
+}
+function normalizeToolKind(toolName) {
+    if (HANDLED_FILE_TOOLS.has(toolName))
+        return toolName;
+    return null;
+}
+function normalizeToolInput(toolKind, toolInput) {
+    const filePath = toolInput.file_path;
+    if (!filePath)
+        return null;
+    if (toolKind === 'Write') {
+        return new types_1.NormalizedToolInput(filePath, [
+            new types_1.NormalizedEdit('', toolInput.content || ''),
+        ]);
+    }
+    if (toolKind === 'Edit') {
+        return new types_1.NormalizedToolInput(filePath, [
+            new types_1.NormalizedEdit(toolInput.old_string || '', toolInput.new_string || ''),
+        ]);
+    }
+    if (toolKind === 'MultiEdit') {
+        const raw = Array.isArray(toolInput.edits) ? toolInput.edits : [];
+        const edits = raw.map((e) => new types_1.NormalizedEdit(e.old_string || '', e.new_string || ''));
+        return new types_1.NormalizedToolInput(filePath, edits);
+    }
+    return null;
+}
+async function main() {
+    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions
+    try {
+        const raw = await readStdin();
+        const payload = safeParse(raw);
+        if (!payload) {
+            process.exit(0);
+            return;
+        }
+        const cwd = process.cwd();
+        if (payload.tool_name === 'Bash') {
+            const command = payload.tool_input.command;
+            if (!command || command.trim() === '') {
+                process.exit(0);
+                return;
+            }
+            const result = (0, runner_1.runBash)(command, cwd);
+            if (!result) {
+                process.exit(0);
+                return;
+            }
+            process.stderr.write(result.report);
+            process.exit(2);
+            return;
+        }
+        const toolKind = normalizeToolKind(payload.tool_name);
+        if (!toolKind) {
+            process.exit(0);
+            return;
+        }
+        const input = normalizeToolInput(toolKind, payload.tool_input);
+        if (!input) {
+            process.exit(0);
+            return;
+        }
+        const result = (0, runner_1.run)(toolKind, input, cwd);
+        if (!result) {
+            process.exit(0);
+            return;
+        }
+        (0, rejection_log_1.logRejection)(toolKind, input, result, cwd);
+        process.stderr.write(result.report);
+        process.exit(2);
+    }
+    catch (err) {
+        const error = (0, to_error_1.toError)(err);
+        process.stderr.write(`[ai-hooks] claude-code adapter crashed (failing open): ${error.message}\n`);
+        process.exit(0);
+    }
+}
+if (require.main === module) {
+    main();
+}
+//# sourceMappingURL=claude-code-hook.js.map

package/src/adapters/claude-code-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code-hook.js","sourceRoot":"","sources":["../../../../../../packages/tooling/ai-hook-rules/src/adapters/claude-code-hook.ts"],"names":[],"mappings":"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","sourcesContent":["import { run, runBash } from '../core/runner';\nimport { logRejection } from '../core/rejection-log';\nimport { NormalizedToolInput, NormalizedEdit, ToolKind } from '../core/types';\nimport { toError } from '../core/to-error';\n\nconst HANDLED_FILE_TOOLS = new Set(['Write', 'Edit', 'MultiEdit']);\n\ninterface ClaudeCodePayload {\n    tool_name: string;\n    tool_input: ClaudeCodeToolInput;\n}\n\ninterface ClaudeCodeToolInput {\n    file_path?: string;\n    content?: string;\n    old_string?: string;\n    new_string?: string;\n    edits?: ClaudeCodeEditEntry[];\n    command?: string;\n}\n\ninterface ClaudeCodeEditEntry {\n    old_string?: string;\n    new_string?: string;\n}\n\nfunction readStdin(): Promise<string> {\n    return new Promise((resolve) => {\n        let data = '';\n        process.stdin.setEncoding('utf8');\n        process.stdin.on('data', (chunk: string) => { data += chunk; });\n        process.stdin.on('end', () => resolve(data));\n        process.stdin.on('error', () => resolve(''));\n        if (process.stdin.isTTY) resolve('');\n    });\n}\n\nfunction safeParse(raw: string): ClaudeCodePayload | null {\n    if (!raw || raw.trim() === '') return null;\n    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n    try {\n        return JSON.parse(raw) as ClaudeCodePayload;\n    } catch (err: unknown) {\n        const error = toError(err);\n        void error;\n        return null;\n    }\n}\n\nfunction normalizeToolKind(toolName: string): ToolKind | null {\n    if (HANDLED_FILE_TOOLS.has(toolName)) return toolName as ToolKind;\n    return null;\n}\n\nfunction normalizeToolInput(toolKind: ToolKind, toolInput: ClaudeCodeToolInput): NormalizedToolInput | null {\n    const filePath = toolInput.file_path;\n    if (!filePath) return null;\n\n    if (toolKind === 'Write') {\n        return new NormalizedToolInput(filePath, [\n            new NormalizedEdit('', toolInput.content || ''),\n        ]);\n    }\n    if (toolKind === 'Edit') {\n        return new NormalizedToolInput(filePath, [\n            new NormalizedEdit(toolInput.old_string || '', toolInput.new_string || ''),\n        ]);\n    }\n    if (toolKind === 'MultiEdit') {\n        const raw = Array.isArray(toolInput.edits) ? toolInput.edits : [];\n        const edits = raw.map((e) => new NormalizedEdit(e.old_string || '', e.new_string || ''));\n        return new NormalizedToolInput(filePath, edits);\n    }\n    return null;\n}\n\nexport async function main(): Promise<void> {\n    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n    try {\n        const raw = await readStdin();\n        const payload = safeParse(raw);\n        if (!payload) { process.exit(0); return; }\n\n        const cwd = process.cwd();\n\n        if (payload.tool_name === 'Bash') {\n            const command = payload.tool_input.command;\n            if (!command || command.trim() === '') { process.exit(0); return; }\n            const result = runBash(command, cwd);\n            if (!result) { process.exit(0); return; }\n            process.stderr.write(result.report);\n            process.exit(2);\n            return;\n        }\n\n        const toolKind = normalizeToolKind(payload.tool_name);\n        if (!toolKind) { process.exit(0); return; }\n\n        const input = normalizeToolInput(toolKind, payload.tool_input);\n        if (!input) { process.exit(0); return; }\n\n        const result = run(toolKind, input, cwd);\n        if (!result) { process.exit(0); return; }\n\n        logRejection(toolKind, input, result, cwd);\n        process.stderr.write(result.report);\n        process.exit(2);\n    } catch (err: unknown) {\n        const error = toError(err);\n        process.stderr.write(`[ai-hooks] claude-code adapter crashed (failing open): ${error.message}\\n`);\n        process.exit(0);\n    }\n}\n\nif (require.main === module) {\n    main();\n}\n"]}

package/src/adapters/openclaw-plugin.d.ts

@@ -0,0 +1,14 @@
+interface ToolCallEvent {
+    toolName: string;
+    arguments: Record<string, unknown>;
+}
+interface HookContext {
+    [key: string]: unknown;
+}
+declare class OpenclawHandlerResult {
+    readonly status: 'approved' | 'rejected';
+    readonly reason: string | undefined;
+    constructor(status: 'approved' | 'rejected', reason?: string);
+}
+export default function handler(event: ToolCallEvent, _context: HookContext): Promise<OpenclawHandlerResult | undefined>;
+export {};

package/src/adapters/openclaw-plugin.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = handler;
+const tslib_1 = require("tslib");
+const path = tslib_1.__importStar(require("path"));
+const fs = tslib_1.__importStar(require("fs"));
+const runner_1 = require("../core/runner");
+const types_1 = require("../core/types");
+const to_error_1 = require("../core/to-error");
+class OpenclawHandlerResult {
+    constructor(status, reason) {
+        this.status = status;
+        this.reason = reason;
+    }
+}
+const TOOL_MAP = {
+    'write': 'Write',
+    'edit': 'Edit',
+};
+function mapToolName(openclawName) {
+    return TOOL_MAP[openclawName] || null;
+}
+// webpieces-disable no-any-unknown -- openclaw SDK passes opaque tool arguments
+function mapToolInput(toolName, args) {
+    const filePath = typeof args['path'] === 'string' ? args['path'] : null;
+    if (!filePath)
+        return null;
+    if (toolName === 'write') {
+        const content = typeof args['content'] === 'string' ? args['content'] : '';
+        return new types_1.NormalizedToolInput(filePath, [new types_1.NormalizedEdit('', content)]);
+    }
+    if (toolName === 'edit') {
+        const oldStr = typeof args['old_string'] === 'string' ? args['old_string'] : '';
+        const newStr = typeof args['new_string'] === 'string' ? args['new_string'] : '';
+        return new types_1.NormalizedToolInput(filePath, [new types_1.NormalizedEdit(oldStr, newStr)]);
+    }
+    return null;
+}
+function findWorkspaceRoot(filePath) {
+    let dir = path.dirname(filePath);
+    while (true) {
+        if (fs.existsSync(path.join(dir, 'webpieces.ai-hooks.json')))
+            return dir;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+async function handler(event, _context) {
+    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions
+    try {
+        const toolKind = mapToolName(event.toolName);
+        if (!toolKind)
+            return undefined;
+        const input = mapToolInput(event.toolName, event.arguments);
+        if (!input)
+            return undefined;
+        const wsRoot = findWorkspaceRoot(input.filePath);
+        if (!wsRoot)
+            return undefined;
+        const result = (0, runner_1.run)(toolKind, input, wsRoot);
+        if (!result)
+            return new OpenclawHandlerResult('approved');
+        return new OpenclawHandlerResult('rejected', result.report);
+    }
+    catch (err) {
+        const error = (0, to_error_1.toError)(err);
+        console.error(`[ai-hooks] openclaw adapter crashed (failing open): ${error.message}`);
+        return undefined;
+    }
+}
+//# sourceMappingURL=openclaw-plugin.js.map

package/src/adapters/openclaw-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-plugin.js","sourceRoot":"","sources":["../../../../../../packages/tooling/ai-hook-rules/src/adapters/openclaw-plugin.ts"],"names":[],"mappings":"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","sourcesContent":["import * as path from 'path';\nimport * as fs from 'fs';\n\nimport { run } from '../core/runner';\nimport { NormalizedToolInput, NormalizedEdit, ToolKind } from '../core/types';\nimport { toError } from '../core/to-error';\n\ninterface ToolCallEvent {\n    toolName: string;\n    // webpieces-disable no-any-unknown -- openclaw SDK passes opaque tool arguments\n    arguments: Record<string, unknown>;\n}\n\ninterface HookContext {\n    // webpieces-disable no-any-unknown -- openclaw SDK context shape is opaque\n    [key: string]: unknown;\n}\n\nclass OpenclawHandlerResult {\n    readonly status: 'approved' | 'rejected';\n    readonly reason: string | undefined;\n\n    constructor(status: 'approved' | 'rejected', reason?: string) {\n        this.status = status;\n        this.reason = reason;\n    }\n}\n\nconst TOOL_MAP: Record<string, ToolKind> = {\n    'write': 'Write',\n    'edit': 'Edit',\n};\n\nfunction mapToolName(openclawName: string): ToolKind | null {\n    return TOOL_MAP[openclawName] || null;\n}\n\n// webpieces-disable no-any-unknown -- openclaw SDK passes opaque tool arguments\nfunction mapToolInput(toolName: string, args: Record<string, unknown>): NormalizedToolInput | null {\n    const filePath = typeof args['path'] === 'string' ? args['path'] as string : null;\n    if (!filePath) return null;\n\n    if (toolName === 'write') {\n        const content = typeof args['content'] === 'string' ? args['content'] as string : '';\n        return new NormalizedToolInput(filePath, [new NormalizedEdit('', content)]);\n    }\n    if (toolName === 'edit') {\n        const oldStr = typeof args['old_string'] === 'string' ? args['old_string'] as string : '';\n        const newStr = typeof args['new_string'] === 'string' ? args['new_string'] as string : '';\n        return new NormalizedToolInput(filePath, [new NormalizedEdit(oldStr, newStr)]);\n    }\n    return null;\n}\n\nfunction findWorkspaceRoot(filePath: string): string | null {\n    let dir = path.dirname(filePath);\n    while (true) {\n        if (fs.existsSync(path.join(dir, 'webpieces.ai-hooks.json'))) return dir;\n        const parent = path.dirname(dir);\n        if (parent === dir) return null;\n        dir = parent;\n    }\n}\n\nexport default async function handler(\n    event: ToolCallEvent,\n    _context: HookContext,\n): Promise<OpenclawHandlerResult | undefined> {\n    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n    try {\n        const toolKind = mapToolName(event.toolName);\n        if (!toolKind) return undefined;\n\n        const input = mapToolInput(event.toolName, event.arguments);\n        if (!input) return undefined;\n\n        const wsRoot = findWorkspaceRoot(input.filePath);\n        if (!wsRoot) return undefined;\n\n        const result = run(toolKind, input, wsRoot);\n        if (!result) return new OpenclawHandlerResult('approved');\n        return new OpenclawHandlerResult('rejected', result.report);\n    } catch (err: unknown) {\n        const error = toError(err);\n        console.error(`[ai-hooks] openclaw adapter crashed (failing open): ${error.message}`);\n        return undefined;\n    }\n}\n"]}

package/src/core/build-context.d.ts

@@ -0,0 +1,8 @@
+import { ToolKind, NormalizedToolInput, EditContext, FileContext, BashContext } from './types';
+export declare class BuiltContexts {
+    readonly fileContext: FileContext;
+    readonly editContexts: readonly EditContext[];
+    constructor(fileContext: FileContext, editContexts: readonly EditContext[]);
+}
+export declare function buildContexts(toolKind: ToolKind, input: NormalizedToolInput, workspaceRoot: string): BuiltContexts;
+export declare function buildBashContext(command: string, workspaceRoot: string): BashContext;

package/src/core/build-context.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BuiltContexts = void 0;
+exports.buildContexts = buildContexts;
+exports.buildBashContext = buildBashContext;
+const tslib_1 = require("tslib");
+const fs = tslib_1.__importStar(require("fs"));
+const path = tslib_1.__importStar(require("path"));
+const strip_ts_noise_1 = require("./strip-ts-noise");
+const disable_directives_1 = require("./disable-directives");
+const types_1 = require("./types");
+class BuiltContexts {
+    constructor(fileContext, editContexts) {
+        this.fileContext = fileContext;
+        this.editContexts = editContexts;
+    }
+}
+exports.BuiltContexts = BuiltContexts;
+function buildContexts(toolKind, input, workspaceRoot) {
+    const filePath = input.filePath;
+    const relativePath = path.relative(workspaceRoot, filePath);
+    const edits = input.edits;
+    const currentFileLines = readCurrentFileLines(filePath);
+    let linesAdded = 0;
+    let linesRemoved = 0;
+    for (const e of edits) {
+        linesAdded += countLines(e.newString);
+        linesRemoved += countLines(e.oldString);
+    }
+    const projectedFileLines = toolKind === 'Write'
+        ? countLines(edits.length > 0 ? edits[0].newString : '')
+        : currentFileLines + linesAdded - linesRemoved;
+    const fileContext = new types_1.FileContext(toolKind, filePath, relativePath, workspaceRoot, currentFileLines, linesAdded, linesRemoved, projectedFileLines);
+    const editContexts = edits.map((e, idx) => {
+        const addedContent = e.newString;
+        const stripped = (0, strip_ts_noise_1.stripTsNoise)(addedContent);
+        const isLineDisabled = (0, disable_directives_1.createIsLineDisabled)(addedContent);
+        return new types_1.EditContext(toolKind, idx, edits.length, filePath, relativePath, workspaceRoot, addedContent, stripped, addedContent.split('\n'), stripped.split('\n'), e.oldString, isLineDisabled);
+    });
+    return new BuiltContexts(fileContext, editContexts);
+}
+function buildBashContext(command, workspaceRoot) {
+    return new types_1.BashContext(command, workspaceRoot);
+}
+function readCurrentFileLines(filePath) {
+    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions
+    try {
+        const content = fs.readFileSync(filePath, 'utf8');
+        return countLines(content);
+    }
+    catch (err) {
+        // eslint-disable-next-line @webpieces/catch-error-pattern -- file-not-found is expected for new Write targets
+        void err;
+        return 0;
+    }
+}
+function countLines(s) {
+    if (!s)
+        return 0;
+    return s.split('\n').length;
+}
+//# sourceMappingURL=build-context.js.map

package/src/core/build-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-context.js","sourceRoot":"","sources":["../../../../../../packages/tooling/ai-hook-rules/src/core/build-context.ts"],"names":[],"mappings":"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","sourcesContent":["import * as fs from 'fs';\nimport * as path from 'path';\n\nimport { stripTsNoise } from './strip-ts-noise';\nimport { createIsLineDisabled } from './disable-directives';\nimport {\n    ToolKind, NormalizedToolInput, NormalizedEdit,\n    EditContext, FileContext, BashContext,\n} from './types';\n\nexport class BuiltContexts {\n    readonly fileContext: FileContext;\n    readonly editContexts: readonly EditContext[];\n\n    constructor(fileContext: FileContext, editContexts: readonly EditContext[]) {\n        this.fileContext = fileContext;\n        this.editContexts = editContexts;\n    }\n}\n\nexport function buildContexts(\n    toolKind: ToolKind,\n    input: NormalizedToolInput,\n    workspaceRoot: string,\n): BuiltContexts {\n    const filePath = input.filePath;\n    const relativePath = path.relative(workspaceRoot, filePath);\n    const edits = input.edits;\n\n    const currentFileLines = readCurrentFileLines(filePath);\n    let linesAdded = 0;\n    let linesRemoved = 0;\n    for (const e of edits) {\n        linesAdded += countLines(e.newString);\n        linesRemoved += countLines(e.oldString);\n    }\n\n    const projectedFileLines =\n        toolKind === 'Write'\n            ? countLines(edits.length > 0 ? edits[0].newString : '')\n            : currentFileLines + linesAdded - linesRemoved;\n\n    const fileContext = new FileContext(\n        toolKind,\n        filePath,\n        relativePath,\n        workspaceRoot,\n        currentFileLines,\n        linesAdded,\n        linesRemoved,\n        projectedFileLines,\n    );\n\n    const editContexts = edits.map((e, idx) => {\n        const addedContent = e.newString;\n        const stripped = stripTsNoise(addedContent);\n        const isLineDisabled = createIsLineDisabled(addedContent);\n        return new EditContext(\n            toolKind,\n            idx,\n            edits.length,\n            filePath,\n            relativePath,\n            workspaceRoot,\n            addedContent,\n            stripped,\n            addedContent.split('\\n'),\n            stripped.split('\\n'),\n            e.oldString,\n            isLineDisabled,\n        );\n    });\n\n    return new BuiltContexts(fileContext, editContexts);\n}\n\nexport function buildBashContext(command: string, workspaceRoot: string): BashContext {\n    return new BashContext(command, workspaceRoot);\n}\n\nfunction readCurrentFileLines(filePath: string): number {\n    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n    try {\n        const content = fs.readFileSync(filePath, 'utf8');\n        return countLines(content);\n    } catch (err: unknown) {\n        // eslint-disable-next-line @webpieces/catch-error-pattern -- file-not-found is expected for new Write targets\n        void err;\n        return 0;\n    }\n}\n\nfunction countLines(s: string): number {\n    if (!s) return 0;\n    return s.split('\\n').length;\n}\n"]}

package/src/core/configs/default.d.ts

@@ -0,0 +1,2 @@
+export declare const defaultRules: Record<string, Record<string, unknown>>;
+export declare const defaultRulesDir: readonly string[];

package/src/core/configs/{default.ts → default.js}

@@ -1,5 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultRulesDir = exports.defaultRules = void 0;
 // webpieces-disable no-any-unknown -- rule options are opaque at framework level
-export const defaultRules: Record<string, Record<string, unknown>> = {
+exports.defaultRules = {
     'no-any-unknown': { enabled: true },
     'max-file-lines': { enabled: true, limit: 900 },
     'file-location': {
@@ -15,5 +18,5 @@ export const defaultRules: Record<string, Record<string, unknown>> = {
     'no-unmanaged-exceptions': { enabled: true },
     'catch-error-pattern': { enabled: true },
 };
-
-export const defaultRulesDir: readonly string[] = [];
+exports.defaultRulesDir = [];
+//# sourceMappingURL=default.js.map

package/src/core/configs/default.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/ai-hook-rules/src/core/configs/default.ts"],"names":[],"mappings":";;;AAAA,iFAAiF;AACpE,QAAA,YAAY,GAA4C;IACjE,gBAAgB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;IACnC,gBAAgB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE;IAC/C,eAAe,EAAE;QACb,OAAO,EAAE,IAAI;QACb,gBAAgB,EAAE,CAAC,eAAe,CAAC;QACnC,YAAY,EAAE;YACV,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;YACrC,cAAc,EAAE,KAAK,EAAE,SAAS;SACnC;KACJ;IACD,gBAAgB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IACxD,qBAAqB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;IACxC,yBAAyB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;IAC5C,qBAAqB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;CAC3C,CAAC;AAEW,QAAA,eAAe,GAAsB,EAAE,CAAC","sourcesContent":["// webpieces-disable no-any-unknown -- rule options are opaque at framework level\nexport const defaultRules: Record<string, Record<string, unknown>> = {\n    'no-any-unknown': { enabled: true },\n    'max-file-lines': { enabled: true, limit: 900 },\n    'file-location': {\n        enabled: true,\n        allowedRootFiles: ['jest.setup.ts'],\n        excludePaths: [\n            'node_modules', 'dist', '.nx', '.git',\n            'architecture', 'tmp', 'scripts',\n        ],\n    },\n    'no-destructure': { enabled: true, allowTopLevel: true },\n    'require-return-type': { enabled: true },\n    'no-unmanaged-exceptions': { enabled: true },\n    'catch-error-pattern': { enabled: true },\n};\n\nexport const defaultRulesDir: readonly string[] = [];\n"]}

package/src/core/disable-directives.d.ts

@@ -0,0 +1,9 @@
+import type { IsLineDisabled } from './types';
+export declare class DirectiveIndex {
+    private readonly lineDisables;
+    private readonly fileDisables;
+    constructor(lineDisables: Map<number, Set<string>>, fileDisables: Set<string>);
+    isLineDisabled(lineNum: number, ruleName: string): boolean;
+}
+export declare function parseDirectives(source: string): DirectiveIndex;
+export declare function createIsLineDisabled(source: string): IsLineDisabled;

package/src/core/disable-directives.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DirectiveIndex = void 0;
+exports.parseDirectives = parseDirectives;
+exports.createIsLineDisabled = createIsLineDisabled;
+const DIRECTIVE_RE = /\/\/\s*(?:ai-hook-disable|webpieces-disable)(?:-(next|file|all))?(?:\s+([\w\-*,\s]+?))?(?:\s*--\s*(.*))?\s*$/;
+class DirectiveIndex {
+    constructor(lineDisables, fileDisables) {
+        this.lineDisables = lineDisables;
+        this.fileDisables = fileDisables;
+    }
+    isLineDisabled(lineNum, ruleName) {
+        if (this.fileDisables.has('*') || this.fileDisables.has(ruleName))
+            return true;
+        const set = this.lineDisables.get(lineNum);
+        if (!set)
+            return false;
+        return set.has('*') || set.has(ruleName);
+    }
+}
+exports.DirectiveIndex = DirectiveIndex;
+function parseRuleList(raw) {
+    if (!raw || raw.trim() === '' || raw.trim() === '*')
+        return ['*'];
+    return raw.split(',').map((s) => s.trim()).filter((s) => s.length > 0);
+}
+function nextTargetLine(lines, lineIdx) {
+    for (let j = lineIdx + 1; j < lines.length; j += 1) {
+        const trimmed = lines[j].trim();
+        if (trimmed === '')
+            continue;
+        if (/^\/\/\s*(?:ai-hook-disable|webpieces-disable)/.test(trimmed))
+            continue;
+        return j + 1;
+    }
+    return null;
+}
+function addDisable(map, lineNum, rules) {
+    if (!map.has(lineNum))
+        map.set(lineNum, new Set());
+    const set = map.get(lineNum);
+    for (const r of rules)
+        set.add(r);
+}
+function resolveTarget(line, lines, i, map, rules) {
+    const beforeComment = line.slice(0, line.indexOf('//')).trim();
+    if (beforeComment !== '') {
+        addDisable(map, i + 1, rules);
+    }
+    else {
+        const target = nextTargetLine(lines, i);
+        if (target !== null)
+            addDisable(map, target, rules);
+    }
+}
+function parseDirectives(source) {
+    const lines = source.split('\n');
+    const lineDisables = new Map();
+    const fileDisables = new Set();
+    for (let i = 0; i < lines.length; i += 1) {
+        const line = lines[i];
+        const match = line.match(DIRECTIVE_RE);
+        if (!match)
+            continue;
+        const variant = match[1] || null;
+        const rules = parseRuleList(match[2] || '');
+        if (variant === 'file') {
+            if (i < 20) {
+                for (const r of rules)
+                    fileDisables.add(r);
+            }
+            continue;
+        }
+        if (variant === 'next') {
+            const target = nextTargetLine(lines, i);
+            if (target !== null)
+                addDisable(lineDisables, target, rules);
+            continue;
+        }
+        if (variant === 'all') {
+            resolveTarget(line, lines, i, lineDisables, ['*']);
+            continue;
+        }
+        resolveTarget(line, lines, i, lineDisables, rules);
+    }
+    return new DirectiveIndex(lineDisables, fileDisables);
+}
+function createIsLineDisabled(source) {
+    const index = parseDirectives(source);
+    return (lineNum, ruleName) => index.isLineDisabled(lineNum, ruleName);
+}
+//# sourceMappingURL=disable-directives.js.map

package/src/core/disable-directives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disable-directives.js","sourceRoot":"","sources":["../../../../../../packages/tooling/ai-hook-rules/src/core/disable-directives.ts"],"names":[],"mappings":"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","sourcesContent":["import type { IsLineDisabled } from './types';\n\nconst DIRECTIVE_RE =\n    /\\/\\/\\s*(?:ai-hook-disable|webpieces-disable)(?:-(next|file|all))?(?:\\s+([\\w\\-*,\\s]+?))?(?:\\s*--\\s*(.*))?\\s*$/;\n\nexport class DirectiveIndex {\n    private readonly lineDisables: Map<number, Set<string>>;\n    private readonly fileDisables: Set<string>;\n\n    constructor(lineDisables: Map<number, Set<string>>, fileDisables: Set<string>) {\n        this.lineDisables = lineDisables;\n        this.fileDisables = fileDisables;\n    }\n\n    isLineDisabled(lineNum: number, ruleName: string): boolean {\n        if (this.fileDisables.has('*') || this.fileDisables.has(ruleName)) return true;\n        const set = this.lineDisables.get(lineNum);\n        if (!set) return false;\n        return set.has('*') || set.has(ruleName);\n    }\n}\n\nfunction parseRuleList(raw: string | undefined): readonly string[] {\n    if (!raw || raw.trim() === '' || raw.trim() === '*') return ['*'];\n    return raw.split(',').map((s) => s.trim()).filter((s) => s.length > 0);\n}\n\nfunction nextTargetLine(lines: readonly string[], lineIdx: number): number | null {\n    for (let j = lineIdx + 1; j < lines.length; j += 1) {\n        const trimmed = lines[j].trim();\n        if (trimmed === '') continue;\n        if (/^\\/\\/\\s*(?:ai-hook-disable|webpieces-disable)/.test(trimmed)) continue;\n        return j + 1;\n    }\n    return null;\n}\n\nfunction addDisable(map: Map<number, Set<string>>, lineNum: number, rules: readonly string[]): void {\n    if (!map.has(lineNum)) map.set(lineNum, new Set<string>());\n    const set = map.get(lineNum)!;\n    for (const r of rules) set.add(r);\n}\n\nfunction resolveTarget(\n    line: string, lines: readonly string[], i: number,\n    map: Map<number, Set<string>>, rules: readonly string[],\n): void {\n    const beforeComment = line.slice(0, line.indexOf('//')).trim();\n    if (beforeComment !== '') {\n        addDisable(map, i + 1, rules);\n    } else {\n        const target = nextTargetLine(lines, i);\n        if (target !== null) addDisable(map, target, rules);\n    }\n}\n\nexport function parseDirectives(source: string): DirectiveIndex {\n    const lines = source.split('\\n');\n    const lineDisables = new Map<number, Set<string>>();\n    const fileDisables = new Set<string>();\n\n    for (let i = 0; i < lines.length; i += 1) {\n        const line = lines[i];\n        const match = line.match(DIRECTIVE_RE);\n        if (!match) continue;\n        const variant = match[1] || null;\n        const rules = parseRuleList(match[2] || '');\n\n        if (variant === 'file') {\n            if (i < 20) { for (const r of rules) fileDisables.add(r); }\n            continue;\n        }\n        if (variant === 'next') {\n            const target = nextTargetLine(lines, i);\n            if (target !== null) addDisable(lineDisables, target, rules);\n            continue;\n        }\n        if (variant === 'all') {\n            resolveTarget(line, lines, i, lineDisables, ['*']);\n            continue;\n        }\n        resolveTarget(line, lines, i, lineDisables, rules);\n    }\n    return new DirectiveIndex(lineDisables, fileDisables);\n}\n\nexport function createIsLineDisabled(source: string): IsLineDisabled {\n    const index = parseDirectives(source);\n    return (lineNum: number, ruleName: string): boolean => index.isLineDisabled(lineNum, ruleName);\n}\n"]}

package/src/core/instruct-ai-writer.d.ts

@@ -0,0 +1 @@
+export declare function writeTemplateIfMissing(workspaceRoot: string, templateName: string): void;

package/src/core/instruct-ai-writer.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeTemplateIfMissing = writeTemplateIfMissing;
+const tslib_1 = require("tslib");
+const fs = tslib_1.__importStar(require("fs"));
+const path = tslib_1.__importStar(require("path"));
+const INSTRUCT_DIR = '.webpieces/instruct-ai';
+function writeTemplateIfMissing(workspaceRoot, templateName) {
+    const dir = path.join(workspaceRoot, INSTRUCT_DIR);
+    const filePath = path.join(dir, templateName);
+    if (fs.existsSync(filePath))
+        return;
+    const templatePath = path.join(__dirname, '..', '..', 'templates', templateName);
+    const content = fs.readFileSync(templatePath, 'utf-8');
+    fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(filePath, content);
+}
+//# sourceMappingURL=instruct-ai-writer.js.map

package/src/core/instruct-ai-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instruct-ai-writer.js","sourceRoot":"","sources":["../../../../../../packages/tooling/ai-hook-rules/src/core/instruct-ai-writer.ts"],"names":[],"mappings":";;AAKA,wDASC;;AAdD,+CAAyB;AACzB,mDAA6B;AAE7B,MAAM,YAAY,GAAG,wBAAwB,CAAC;AAE9C,SAAgB,sBAAsB,CAAC,aAAqB,EAAE,YAAoB;IAC9E,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAC9C,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO;IAEpC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;IACjF,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACvD,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AACxC,CAAC","sourcesContent":["import * as fs from 'fs';\nimport * as path from 'path';\n\nconst INSTRUCT_DIR = '.webpieces/instruct-ai';\n\nexport function writeTemplateIfMissing(workspaceRoot: string, templateName: string): void {\n    const dir = path.join(workspaceRoot, INSTRUCT_DIR);\n    const filePath = path.join(dir, templateName);\n    if (fs.existsSync(filePath)) return;\n\n    const templatePath = path.join(__dirname, '..', '..', 'templates', templateName);\n    const content = fs.readFileSync(templatePath, 'utf-8');\n    fs.mkdirSync(dir, { recursive: true });\n    fs.writeFileSync(filePath, content);\n}\n"]}

package/src/core/load-config.d.ts

@@ -0,0 +1 @@
+export { loadConfig, findConfigFile, CONFIG_FILENAME } from '@webpieces/rules-config';

package/src/core/load-config.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIG_FILENAME = exports.findConfigFile = exports.loadConfig = void 0;
+// Re-export the shared workspace config loader so ai-hooks and the Nx
+// validate-code executor use the same webpieces.config.json.
+var rules_config_1 = require("@webpieces/rules-config");
+Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return rules_config_1.loadConfig; } });
+Object.defineProperty(exports, "findConfigFile", { enumerable: true, get: function () { return rules_config_1.findConfigFile; } });
+Object.defineProperty(exports, "CONFIG_FILENAME", { enumerable: true, get: function () { return rules_config_1.CONFIG_FILENAME; } });
+//# sourceMappingURL=load-config.js.map

package/src/core/load-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-config.js","sourceRoot":"","sources":["../../../../../../packages/tooling/ai-hook-rules/src/core/load-config.ts"],"names":[],"mappings":";;;AAAA,sEAAsE;AACtE,6DAA6D;AAC7D,wDAAsF;AAA7E,0GAAA,UAAU,OAAA;AAAE,8GAAA,cAAc,OAAA;AAAE,+GAAA,eAAe,OAAA","sourcesContent":["// Re-export the shared workspace config loader so ai-hooks and the Nx\n// validate-code executor use the same webpieces.config.json.\nexport { loadConfig, findConfigFile, CONFIG_FILENAME } from '@webpieces/rules-config';\n"]}

package/src/core/load-rules.d.ts

@@ -0,0 +1,3 @@
+import type { Rule, ResolvedConfig } from './types';
+export declare function loadRules(config: ResolvedConfig, workspaceRoot: string): readonly Rule[];
+export declare function globMatches(pattern: string, filePath: string): boolean;