@webpieces/nx-webpieces-rules 0.4.842 → 0.4.844

package/README.md

@@ -4,6 +4,8 @@ Nx inference plugin that auto-creates webpieces validation targets (architecture
 graph checks, code-size/style rules, and a per-project circular-import gate)
 without any manual `project.json` wiring.
 
+Install `@webpieces/webpieces-tooling` for the complete toolchain. This package implements the Nx plugin and executors; it does not aggregate hook or PR workflow packages.
+
 Add it to `nx.json`:
 
 ```jsonc

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@webpieces/nx-webpieces-rules",
-  "version": "0.4.842",
-  "description": "Nx-specific webpieces validation rules and graph tooling. Bundles all @webpieces rule packages with Nx graph validators and an inference plugin.",
+  "version": "0.4.844",
+  "description": "Nx-specific webpieces validation rules, graph tooling, executors, and inference plugin.",
   "type": "commonjs",
   "main": "./src/index.js",
   "executors": "./executors.json",
@@ -10,7 +10,7 @@
     "./package.json": "./package.json",
     "./plugin": "./src/plugin.js",
     "./executors.json": "./executors.json",
-    "./openclaw-plugin": "./src/adapters/openclaw-plugin.js"
+    "./rule-pack": "./src/rule-pack.js"
   },
   "files": [
     "src/**/*",
@@ -19,18 +19,13 @@
     "README.md"
   ],
   "dependencies": {
-    "@webpieces/ai-hook-rules": "0.4.842",
-    "@webpieces/hook-runtime": "0.4.842",
-    "@webpieces/api-doc-model": "0.4.842",
-    "@webpieces/code-rules": "0.4.842",
-    "@webpieces/core-util": "0.4.842",
-    "@webpieces/eslint-rules": "0.4.842",
-    "@webpieces/pr-gate": "0.4.842",
-    "@webpieces/rules-config": "0.4.842",
+    "@webpieces/api-doc-model": "0.4.844",
+    "@webpieces/code-rules": "0.4.844",
+    "@webpieces/core-util": "0.4.844",
+    "@webpieces/eslint-rules": "0.4.844",
+    "@webpieces/rules-config": "0.4.844",
     "madge": "8.0.0",
-    "@webpieces/tooling-common": "0.4.842",
-    "@webpieces/repo-workflow-core": "0.4.842",
-    "@webpieces/agent-workflow-rules": "0.4.842"
+    "@webpieces/rules-sdk": "0.4.844"
   },
   "peerDependencies": {
     "@nx/devkit": ">=18.0.0"
@@ -45,6 +40,9 @@
   "publishConfig": {
     "access": "public"
   },
+  "devDependencies": {
+    "@webpieces/tooling-testkit": "0.4.844"
+  },
   "types": "./src/index.d.ts",
   "bin": {
     "wp-design-visualize": "./src/scripts/wp-design-visualize.js"

package/src/rule-pack.d.ts

@@ -0,0 +1,2 @@
+import { RulePackManifest } from '@webpieces/rules-sdk';
+export declare const rulePackManifest: RulePackManifest;

package/src/rule-pack.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rulePackManifest = void 0;
+const rules_sdk_1 = require("@webpieces/rules-sdk");
+const rules_config_1 = require("@webpieces/rules-config");
+const package_json_1 = require("../package.json");
+/** Compatibility manifest; executable registries remain authoritative until ownership migration. */
+const ownedRuleIds = [
+    "no-file-import-cycles",
+    "runtime-architecture",
+    "nx-wiring",
+    "di-graph",
+    "missing-design-annotation",
+    "validate-architecture-unchanged",
+    "validate-no-architecture-cycles",
+    "validate-packagejson",
+    "validate-versions-locked",
+    "validate-eslint-sync",
+    "no-root-union-api-type",
+    "api-rules-for-openapi",
+    "api-rules-for-mcp",
+    "api-lib-dependencies",
+    "api-lib-path",
+    "framework-folder"
+];
+exports.rulePackManifest = new rules_sdk_1.RulePackManifest('@webpieces/nx-webpieces-rules', package_json_1.version, rules_sdk_1.RULE_PACK_API_VERSION, ownedRuleIds.map(id => new rules_sdk_1.OwnedRuleDefinition(id, rules_config_1.RULE_SCHEMAS[id], rules_sdk_1.RULE_SCHEMA_API_VERSION)), [
+    ...ownedRuleIds.map(id => new rules_sdk_1.RuleContribution(id, '@webpieces/nx-webpieces-rules', 'build')),
+    new rules_sdk_1.RuleContribution('validate-ts-in-src', '@webpieces/ai-hook-rules', 'build'),
+]);
+//# sourceMappingURL=rule-pack.js.map

package/src/rule-pack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-pack.js","sourceRoot":"","sources":["../../../../../packages/tooling/nx-webpieces-rules/src/rule-pack.ts"],"names":[],"mappings":";;;AAAA,oDAA+I;AAC/I,0DAAuD;AACvD,kDAA0C;AAE1C,oGAAoG;AACpG,MAAM,YAAY,GAAG;IACjB,uBAAuB;IACvB,sBAAsB;IACtB,WAAW;IACX,UAAU;IACV,2BAA2B;IAC3B,iCAAiC;IACjC,iCAAiC;IACjC,sBAAsB;IACtB,0BAA0B;IAC1B,sBAAsB;IACtB,wBAAwB;IACxB,uBAAuB;IACvB,mBAAmB;IACnB,sBAAsB;IACtB,cAAc;IACd,kBAAkB;CACZ,CAAC;AAEE,QAAA,gBAAgB,GAAG,IAAI,4BAAgB,CAChD,+BAA+B,EAC/B,sBAAO,EACP,iCAAqB,EACrB,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,+BAAmB,CAAC,EAAE,EAAE,2BAAY,CAAC,EAAE,CAAC,EAAE,mCAAuB,CAAC,CAAC,EAC9F;IACI,GAAG,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,4BAAgB,CAAC,EAAE,EAAE,+BAA+B,EAAE,OAAO,CAAC,CAAC;IAC7F,IAAI,4BAAgB,CAAC,oBAAoB,EAAE,0BAA0B,EAAE,OAAO,CAAC;CAClF,CACJ,CAAC","sourcesContent":["import { OwnedRuleDefinition, RuleContribution, RulePackManifest, RULE_PACK_API_VERSION, RULE_SCHEMA_API_VERSION } from '@webpieces/rules-sdk';\nimport { RULE_SCHEMAS } from '@webpieces/rules-config';\nimport { version } from '../package.json';\n\n/** Compatibility manifest; executable registries remain authoritative until ownership migration. */\nconst ownedRuleIds = [\n    \"no-file-import-cycles\",\n    \"runtime-architecture\",\n    \"nx-wiring\",\n    \"di-graph\",\n    \"missing-design-annotation\",\n    \"validate-architecture-unchanged\",\n    \"validate-no-architecture-cycles\",\n    \"validate-packagejson\",\n    \"validate-versions-locked\",\n    \"validate-eslint-sync\",\n    \"no-root-union-api-type\",\n    \"api-rules-for-openapi\",\n    \"api-rules-for-mcp\",\n    \"api-lib-dependencies\",\n    \"api-lib-path\",\n    \"framework-folder\"\n] as const;\n\nexport const rulePackManifest = new RulePackManifest(\n    '@webpieces/nx-webpieces-rules',\n    version,\n    RULE_PACK_API_VERSION,\n    ownedRuleIds.map(id => new OwnedRuleDefinition(id, RULE_SCHEMAS[id], RULE_SCHEMA_API_VERSION)),\n    [\n        ...ownedRuleIds.map(id => new RuleContribution(id, '@webpieces/nx-webpieces-rules', 'build')),\n        new RuleContribution('validate-ts-in-src', '@webpieces/ai-hook-rules', 'build'),\n    ],\n);\n"]}

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

@@ -1,14 +0,0 @@
-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

@@ -1,99 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"version":3,"file":"openclaw-plugin.js","sourceRoot":"","sources":["../../../../../../packages/tooling/nx-webpieces-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 { 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"]}