@webpieces/webpieces-tooling 0.0.1

package/README.md

@@ -0,0 +1,13 @@
+# @webpieces/webpieces-tooling
+
+Install the complete toolchain through this umbrella package. Its workspace dependencies carry every published tooling package and its public bins, including `wp-ai-rules-hook` and `wp-ai-guards-hook`.
+
+For a published release, declare `@webpieces/webpieces-tooling` as the single tooling dependency. Existing consumers should replace their former Nx umbrella declaration with this package when adopting the release. Keep registering `@webpieces/nx-webpieces-rules` in `nx.json`; that package implements the inference plugin and executors.
+
+OpenClaw uses `@webpieces/webpieces-tooling/openclaw-plugin` and the packaged `openclaw.plugin.json`. Its single write/edit handler composes source rules, workflow guards, and source extensions in their original order.
+
+This package owns packaging and composition smoke checks. Feature suites remain in ai-hook-rules, agent-workflow-rules, pr-gate, and the Nx implementation package.
+
+The repository itself is validated with its previously published catalog release. Adding this source package does not upgrade that installed toolchain or its committed dispatcher.
+
+The ordinary test target runs the small aggregation and OpenClaw checks. Run `pnpm nx run webpieces-tooling:release-test` when changing `scripts/publish-packages.sh`; it exercises the release retry loop in a fake registry workspace and is kept separate from source-rule edit workloads.

package/openclaw.plugin.json

@@ -0,0 +1,15 @@
+{
+    "id": "webpieces-ai-hooks",
+    "name": "webpieces AI Hooks",
+    "description": "Pre-write validation rules for AI-driven development. Blocks writes containing any, missing return types, destructuring, unmanaged exceptions, orphan files, or oversized files.",
+    "hooks": {
+        "before_tool_call": {
+            "handler": "./src/adapters/openclaw-plugin.js"
+        }
+    },
+    "configSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {}
+    }
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@webpieces/webpieces-tooling",
+  "version": "0.0.1",
+  "description": "Complete webpieces tooling installation and the combined OpenClaw hook adapter.",
+  "type": "commonjs",
+  "main": "./src/index.js",
+  "exports": {
+    ".": "./src/index.js",
+    "./package.json": "./package.json",
+    "./openclaw-plugin": "./src/adapters/openclaw-plugin.js"
+  },
+  "files": [
+    "src/**/*",
+    "openclaw.plugin.json",
+    "README.md"
+  ],
+  "dependencies": {
+    "@webpieces/agent-workflow-rules": "0.0.1",
+    "@webpieces/ai-hook-rules": "0.4.845",
+    "@webpieces/code-rules": "0.4.845",
+    "@webpieces/eslint-rules": "0.4.845",
+    "@webpieces/hook-runtime": "0.0.1",
+    "@webpieces/nx-webpieces-rules": "0.4.845",
+    "@webpieces/pr-gate": "0.4.845",
+    "@webpieces/repo-workflow-core": "0.0.1",
+    "@webpieces/rules-config": "0.4.845",
+    "@webpieces/tooling-common": "0.0.1",
+    "@webpieces/rules-sdk": "0.0.1"
+  },
+  "author": "Dean Hiller",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/deanhiller/webpieces-ts.git",
+    "directory": "packages/tooling/webpieces-tooling"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@webpieces/tooling-testkit": "0.0.1"
+  },
+  "types": "./src/index.d.ts"
+}

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,99 @@
+"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 rules_config_1 = require("@webpieces/rules-config");
+const ai_hook_rules_1 = require("@webpieces/ai-hook-rules");
+const agent_workflow_rules_1 = require("@webpieces/agent-workflow-rules");
+const hook_runtime_1 = require("@webpieces/hook-runtime");
+const rules_config_2 = require("@webpieces/rules-config");
+const hook_runtime_2 = require("@webpieces/hook-runtime");
+const tooling_common_1 = require("@webpieces/tooling-common");
+const rules_config_3 = require("@webpieces/rules-config");
+const to_error_1 = require("@webpieces/tooling-common/to-error");
+class OpenclawHandlerResult {
+    status;
+    reason;
+    constructor(status, reason) {
+        this.status = status;
+        this.reason = reason;
+    }
+}
+const TOOL_MAP = {
+    'write': 'Write',
+    'edit': 'Edit',
+};
+// webpieces-disable no-function-outside-class -- existing OpenClaw callback and stateless adapter helpers moved intact; the SDK invokes this module function
+function mapToolName(openclawName) {
+    return TOOL_MAP[openclawName] || null;
+}
+// webpieces-disable no-any-unknown -- openclaw SDK passes opaque tool arguments
+// webpieces-disable no-function-outside-class -- existing OpenClaw callback and stateless adapter helpers moved intact; the SDK invokes this module function
+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 hook_runtime_2.NormalizedToolInput(filePath, [new hook_runtime_2.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 hook_runtime_2.NormalizedToolInput(filePath, [new hook_runtime_2.NormalizedEdit(oldStr, newStr)]);
+    }
+    return null;
+}
+// webpieces-disable no-function-outside-class -- existing OpenClaw callback and stateless adapter helpers moved intact; the SDK invokes this module function
+function findWorkspaceRoot(filePath) {
+    let dir = path.dirname(filePath);
+    while (true) {
+        if (fs.existsSync(path.join(dir, rules_config_1.CONFIG_FILENAME)))
+            return dir;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+// webpieces-disable no-function-outside-class -- existing OpenClaw callback and stateless adapter helpers moved intact; the SDK invokes this module function
+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 loaded = (0, rules_config_2.loadAndValidate)(wsRoot);
+        const source = new ai_hook_rules_1.SourceHookRules().load(loaded);
+        const guards = new agent_workflow_rules_1.WorkflowHookRules().load(loaded);
+        const result = new hook_runtime_1.HookFileEvaluation().evaluate(toolKind, input, loaded, new hook_runtime_1.HookRuleSet([...source.builtInRules, ...guards.rules, ...source.extensionRules], [...source.configuredRules, ...guards.configuredRules]));
+        if (!result)
+            return new OpenclawHandlerResult('approved');
+        return new OpenclawHandlerResult('rejected', result.report);
+    }
+    catch (err) {
+        const error = (0, to_error_1.toError)(err);
+        // An escaped RuleFailError or InformAiError carries an AI-readable message; anything else is
+        // an unexpected bug. All reject (fail closed).
+        let msg;
+        if (error instanceof rules_config_3.RuleFailError) {
+            msg = (0, rules_config_1.renderRuleFailForAi)(error);
+        }
+        else if (error instanceof tooling_common_1.InformAiError) {
+            msg = error.message;
+        }
+        else {
+            msg = `[ai-hooks] openclaw adapter crashed — failing closed: ${error.message}`;
+        }
+        return new OpenclawHandlerResult('rejected', msg);
+    }
+}
+//# 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/webpieces-tooling/src/adapters/openclaw-plugin.ts"],"names":[],"mappings":"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","sourcesContent":["import * as path from 'path';\nimport * as fs from 'fs';\n\nimport { CONFIG_FILENAME, renderRuleFailForAi } from '@webpieces/rules-config';\nimport { SourceHookRules } from '@webpieces/ai-hook-rules';\nimport { WorkflowHookRules } from '@webpieces/agent-workflow-rules';\nimport { HookRuleSet, HookFileEvaluation } from '@webpieces/hook-runtime';\nimport { loadAndValidate } from '@webpieces/rules-config';\nimport { NormalizedToolInput, NormalizedEdit, ToolKind } from '@webpieces/hook-runtime';\nimport { InformAiError } from '@webpieces/tooling-common';\nimport { RuleFailError } from '@webpieces/rules-config';\nimport { toError } from '@webpieces/tooling-common/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\n// webpieces-disable no-function-outside-class -- existing OpenClaw callback and stateless adapter helpers moved intact; the SDK invokes this module function\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\n// webpieces-disable no-function-outside-class -- existing OpenClaw callback and stateless adapter helpers moved intact; the SDK invokes this module function\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\n// webpieces-disable no-function-outside-class -- existing OpenClaw callback and stateless adapter helpers moved intact; the SDK invokes this module function\nfunction findWorkspaceRoot(filePath: string): string | null {\n    let dir = path.dirname(filePath);\n    while (true) {\n        if (fs.existsSync(path.join(dir, CONFIG_FILENAME))) return dir;\n        const parent = path.dirname(dir);\n        if (parent === dir) return null;\n        dir = parent;\n    }\n}\n\n// webpieces-disable no-function-outside-class -- existing OpenClaw callback and stateless adapter helpers moved intact; the SDK invokes this module function\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 loaded = loadAndValidate(wsRoot);\n        const source = new SourceHookRules().load(loaded);\n        const guards = new WorkflowHookRules().load(loaded);\n        const result = new HookFileEvaluation().evaluate(toolKind, input, loaded,\n            new HookRuleSet([...source.builtInRules, ...guards.rules, ...source.extensionRules], [...source.configuredRules, ...guards.configuredRules]));\n        if (!result) return new OpenclawHandlerResult('approved');\n        return new OpenclawHandlerResult('rejected', result.report);\n    } catch (err: unknown) {\n        const error = toError(err);\n        // An escaped RuleFailError or InformAiError carries an AI-readable message; anything else is\n        // an unexpected bug. All reject (fail closed).\n        let msg: string;\n        if (error instanceof RuleFailError) {\n            msg = renderRuleFailForAi(error);\n        } else if (error instanceof InformAiError) {\n            msg = error.message;\n        } else {\n            msg = `[ai-hooks] openclaw adapter crashed — failing closed: ${error.message}`;\n        }\n        return new OpenclawHandlerResult('rejected', msg);\n    }\n}\n"]}

package/src/index.d.ts

@@ -0,0 +1 @@
+export {};

package/src/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/tooling/webpieces-tooling/src/index.ts"],"names":[],"mappings":"","sourcesContent":["// Installation is the root entry point; OpenClaw has its own explicit export subpath.\nexport {};\n"]}