@provartesting/provardx-cli 1.4.7 → 1.5.0-dev

package/lib/mcp/tools/pageObjectGenerate.js

@@ -0,0 +1,153 @@
+/*
+ * Copyright (c) 2024 Provar Limited.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.md file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+/* eslint-disable camelcase */
+import fs from 'node:fs';
+import path from 'node:path';
+import { z } from 'zod';
+import { assertPathAllowed, PathPolicyError } from '../security/pathPolicy.js';
+import { makeError, makeRequestId } from '../schemas/common.js';
+import { log } from '../logging/logger.js';
+const VALID_LOCATOR_STRATEGIES = [
+    'xpath', 'id', 'css', 'name', 'className', 'tagName',
+    'linkText', 'partialLinkText', 'visualforce', 'label',
+];
+const VALID_ELEMENT_TYPES = [
+    'TextType', 'ButtonType', 'LinkType', 'ChoiceListType',
+    'RadioType', 'FileType', 'DateType', 'RichTextType', 'BooleanType',
+];
+const FieldSchema = z.object({
+    name: z.string().describe('camelCase WebElement field name'),
+    locator_strategy: z.enum(VALID_LOCATOR_STRATEGIES).default('xpath'),
+    locator_value: z
+        .string()
+        .default('')
+        .describe('Locator value (empty string is valid — AI healing populates at runtime)'),
+    element_type: z.enum(VALID_ELEMENT_TYPES).default('TextType'),
+});
+export function registerPageObjectGenerate(server, config) {
+    server.tool('provar.pageobject.generate', 'Generate a Provar Java Page Object skeleton with @Page/@SalesforcePage annotation, standard imports, and @FindBy WebElement fields. Returns Java source. Writes to disk only when dry_run=false.', {
+        class_name: z.string().describe('PascalCase class name, e.g. AccountDetailPage'),
+        package_name: z
+            .string()
+            .default('pageobjects')
+            .describe('Java package, e.g. pageobjects or pageobjects.accounts'),
+        page_type: z
+            .enum(['standard', 'salesforce'])
+            .default('standard')
+            .describe('@Page (standard) or @SalesforcePage (salesforce)'),
+        title: z
+            .string()
+            .optional()
+            .describe('Page title attribute; defaults to class_name if omitted'),
+        connection_name: z
+            .string()
+            .optional()
+            .describe('Salesforce connection name (required when page_type=salesforce)'),
+        salesforce_page_attribute: z
+            .enum(['page', 'auraComponent', 'object', 'lightningWebComponent'])
+            .optional()
+            .describe('Page type attribute for @SalesforcePage'),
+        fields: z.array(FieldSchema).default([]).describe('WebElement fields to generate'),
+        output_path: z
+            .string()
+            .optional()
+            .describe('Suggested file path for the .java file (returned in response)'),
+        overwrite: z
+            .boolean()
+            .default(false)
+            .describe('Overwrite existing file when dry_run=false'),
+        dry_run: z
+            .boolean()
+            .default(true)
+            .describe('true = return source only (default); false = write to output_path'),
+        idempotency_key: z
+            .string()
+            .optional()
+            .describe('Caller-provided key echoed back for deduplication tracking'),
+    }, (input) => {
+        const requestId = makeRequestId();
+        log('info', 'provar.pageobject.generate', {
+            requestId,
+            class_name: input.class_name,
+            dry_run: input.dry_run,
+        });
+        try {
+            const javaSource = buildPageObjectSource(input);
+            const filePath = input.output_path
+                ? path.resolve(input.output_path)
+                : undefined;
+            let written = false;
+            if (filePath && !input.dry_run) {
+                assertPathAllowed(filePath, config.allowedPaths);
+                if (fs.existsSync(filePath) && !input.overwrite) {
+                    const err = makeError('FILE_EXISTS', `File already exists: ${filePath}. Set overwrite=true to replace.`, requestId);
+                    return { isError: true, content: [{ type: 'text', text: JSON.stringify(err) }] };
+                }
+                fs.mkdirSync(path.dirname(filePath), { recursive: true });
+                fs.writeFileSync(filePath, javaSource, 'utf-8');
+                written = true;
+                log('info', 'provar.pageobject.generate: wrote file', { requestId, filePath });
+            }
+            const result = {
+                requestId,
+                java_source: javaSource,
+                file_path: filePath,
+                written,
+                dry_run: input.dry_run,
+                idempotency_key: input.idempotency_key,
+            };
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result) }],
+                structuredContent: result,
+            };
+        }
+        catch (err) {
+            const error = err;
+            const errResult = makeError(error instanceof PathPolicyError ? error.code : (error.code ?? 'GENERATE_ERROR'), error.message, requestId, false);
+            log('error', 'provar.pageobject.generate failed', { requestId, error: error.message });
+            return { isError: true, content: [{ type: 'text', text: JSON.stringify(errResult) }] };
+        }
+    });
+}
+// ── Source builder ────────────────────────────────────────────────────────────
+function buildPageObjectSource(input) {
+    const { class_name, package_name, page_type, title, connection_name, salesforce_page_attribute, fields } = input;
+    const pageTitle = title ?? class_name;
+    let annotation;
+    if (page_type === 'salesforce') {
+        const conn = connection_name ? `, connection = "${connection_name}"` : '';
+        const sfAttr = salesforce_page_attribute ? `, ${salesforce_page_attribute} = ""` : '';
+        annotation = `@SalesforcePage(title = "${pageTitle}"${conn}${sfAttr})`;
+    }
+    else {
+        annotation = `@Page(title = "${pageTitle}")`;
+    }
+    const fieldBlocks = fields.length > 0
+        ? fields
+            .map((f) => {
+            const locArg = f.locator_strategy === 'xpath'
+                ? `xpath = "${f.locator_value}"`
+                : `${f.locator_strategy} = "${f.locator_value}"`;
+            return `    @FindBy(${locArg})\n    @${f.element_type}()\n    public WebElement ${f.name};`;
+        })
+            .join('\n\n')
+        : '    // TODO: Add @FindBy WebElement fields';
+    return `package ${package_name};
+
+import com.provar.core.testapi.annotations.*;
+import org.openqa.selenium.WebElement;
+import org.openqa.selenium.support.FindBy;
+
+${annotation}
+public class ${class_name} {
+
+${fieldBlocks}
+
+}
+`;
+}
+//# sourceMappingURL=pageObjectGenerate.js.map

package/lib/mcp/tools/pageObjectGenerate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pageObjectGenerate.js","sourceRoot":"","sources":["../../../src/mcp/tools/pageObjectGenerate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,8BAA8B;AAC9B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAE3C,MAAM,wBAAwB,GAAG;IAC/B,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS;IACpD,UAAU,EAAE,iBAAiB,EAAE,aAAa,EAAE,OAAO;CAC7C,CAAC;AAEX,MAAM,mBAAmB,GAAG;IAC1B,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,gBAAgB;IACtD,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa;CAC1D,CAAC;AAEX,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IAC5D,gBAAgB,EAAE,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACnE,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,yEAAyE,CAAC;IACtF,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;CAC9D,CAAC,CAAC;AAEH,MAAM,UAAU,0BAA0B,CAAC,MAAiB,EAAE,MAAoB;IAChF,MAAM,CAAC,IAAI,CACT,4BAA4B,EAC5B,kMAAkM,EAClM;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;QAChF,YAAY,EAAE,CAAC;aACZ,MAAM,EAAE;aACR,OAAO,CAAC,aAAa,CAAC;aACtB,QAAQ,CAAC,wDAAwD,CAAC;QACrE,SAAS,EAAE,CAAC;aACT,IAAI,CAAC,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;aAChC,OAAO,CAAC,UAAU,CAAC;aACnB,QAAQ,CAAC,kDAAkD,CAAC;QAC/D,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,yDAAyD,CAAC;QACtE,eAAe,EAAE,CAAC;aACf,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,iEAAiE,CAAC;QAC9E,yBAAyB,EAAE,CAAC;aACzB,IAAI,CAAC,CAAC,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,uBAAuB,CAAC,CAAC;aAClE,QAAQ,EAAE;aACV,QAAQ,CAAC,yCAAyC,CAAC;QACtD,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,+BAA+B,CAAC;QAClF,WAAW,EAAE,CAAC;aACX,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,+DAA+D,CAAC;QAC5E,SAAS,EAAE,CAAC;aACT,OAAO,EAAE;aACT,OAAO,CAAC,KAAK,CAAC;aACd,QAAQ,CAAC,4CAA4C,CAAC;QACzD,OAAO,EAAE,CAAC;aACP,OAAO,EAAE;aACT,OAAO,CAAC,IAAI,CAAC;aACb,QAAQ,CAAC,mEAAmE,CAAC;QAChF,eAAe,EAAE,CAAC;aACf,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,4DAA4D,CAAC;KAC1E,EACD,CAAC,KAAK,EAAE,EAAE;QACR,MAAM,SAAS,GAAG,aAAa,EAAE,CAAC;QAClC,GAAG,CAAC,MAAM,EAAE,4BAA4B,EAAE;YACxC,SAAS;YACT,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;YAChD,MAAM,QAAQ,GAAuB,KAAK,CAAC,WAAW;gBACpD,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC;gBACjC,CAAC,CAAC,SAAS,CAAC;YACd,IAAI,OAAO,GAAG,KAAK,CAAC;YAEpB,IAAI,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBAC/B,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;gBAEjD,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;oBAChD,MAAM,GAAG,GAAG,SAAS,CACnB,aAAa,EACb,wBAAwB,QAAQ,kCAAkC,EAClE,SAAS,CACV,CAAC;oBACF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC5F,CAAC;gBAED,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC1D,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;gBAChD,OAAO,GAAG,IAAI,CAAC;gBACf,GAAG,CAAC,MAAM,EAAE,wCAAwC,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;YACjF,CAAC;YAED,MAAM,MAAM,GAAG;gBACb,SAAS;gBACT,WAAW,EAAE,UAAU;gBACvB,SAAS,EAAE,QAAQ;gBACnB,OAAO;gBACP,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,eAAe,EAAE,KAAK,CAAC,eAAe;aACvC,CAAC;YACF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClE,iBAAiB,EAAE,MAAM;aAC1B,CAAC;QACJ,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,KAAK,GAAG,GAAgC,CAAC;YAC/C,MAAM,SAAS,GAAG,SAAS,CACzB,KAAK,YAAY,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,gBAAgB,CAAC,EAChF,KAAK,CAAC,OAAO,EACb,SAAS,EACT,KAAK,CACN,CAAC;YACF,GAAG,CAAC,OAAO,EAAE,mCAAmC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACvF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC;QAClG,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC;AAED,iFAAiF;AAEjF,SAAS,qBAAqB,CAAC,KAQ9B;IACC,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,EAAE,GACtG,KAAK,CAAC;IACR,MAAM,SAAS,GAAG,KAAK,IAAI,UAAU,CAAC;IAEtC,IAAI,UAAkB,CAAC;IACvB,IAAI,SAAS,KAAK,YAAY,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,eAAe,CAAC,CAAC,CAAC,mBAAmB,eAAe,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1E,MAAM,MAAM,GAAG,yBAAyB,CAAC,CAAC,CAAC,KAAK,yBAAyB,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACtF,UAAU,GAAG,4BAA4B,SAAS,IAAI,IAAI,GAAG,MAAM,GAAG,CAAC;IACzE,CAAC;SAAM,CAAC;QACN,UAAU,GAAG,kBAAkB,SAAS,IAAI,CAAC;IAC/C,CAAC;IAED,MAAM,WAAW,GACf,MAAM,CAAC,MAAM,GAAG,CAAC;QACf,CAAC,CAAC,MAAM;aACH,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACT,MAAM,MAAM,GACV,CAAC,CAAC,gBAAgB,KAAK,OAAO;gBAC5B,CAAC,CAAC,YAAY,CAAC,CAAC,aAAa,GAAG;gBAChC,CAAC,CAAC,GAAG,CAAC,CAAC,gBAAgB,OAAO,CAAC,CAAC,aAAa,GAAG,CAAC;YACrD,OAAO,eAAe,MAAM,WAAW,CAAC,CAAC,YAAY,6BAA6B,CAAC,CAAC,IAAI,GAAG,CAAC;QAC9F,CAAC,CAAC;aACD,IAAI,CAAC,MAAM,CAAC;QACjB,CAAC,CAAC,4CAA4C,CAAC;IAEnD,OAAO,WAAW,YAAY;;;;;;EAM9B,UAAU;eACG,UAAU;;EAEvB,WAAW;;;CAGZ,CAAC;AACF,CAAC"}

package/lib/mcp/tools/pageObjectValidate.d.ts

@@ -0,0 +1,18 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ServerConfig } from '../server.js';
+import { type ValidationIssue } from '../schemas/common.js';
+export declare function registerPageObjectValidate(server: McpServer, config: ServerConfig): void;
+export interface PageObjectValidationResult {
+    is_valid: boolean;
+    quality_score: number;
+    class_name: string | null;
+    package_name: string | null;
+    field_count: number;
+    frame_count: number;
+    error_count: number;
+    warning_count: number;
+    info_count: number;
+    issues: ValidationIssue[];
+}
+/** Pure function — exported for unit testing */
+export declare function validatePageObject(source: string, expectedClassName?: string): PageObjectValidationResult;

package/lib/mcp/tools/pageObjectValidate.js

@@ -0,0 +1,420 @@
+/*
+ * Copyright (c) 2024 Provar Limited.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.md file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+/* eslint-disable camelcase */
+import fs from 'node:fs';
+import path, { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { z } from 'zod';
+import { assertPathAllowed, PathPolicyError } from '../security/pathPolicy.js';
+import { makeError, makeRequestId } from '../schemas/common.js';
+import { log } from '../logging/logger.js';
+export function registerPageObjectValidate(server, config) {
+    server.tool('provar.pageobject.validate', 'Validate a Provar Java Page Object against naming conventions, locator best practices, and structural requirements. Returns quality score (0–100) and list of issues.', {
+        content: z.string().optional().describe('Java source code to validate directly'),
+        file_path: z.string().optional().describe('Path to .java Page Object file'),
+        expected_class_name: z
+            .string()
+            .optional()
+            .describe('Expected class name for PO_006 check; inferred from file_path when omitted'),
+    }, ({ content, file_path, expected_class_name }) => {
+        const requestId = makeRequestId();
+        log('info', 'provar.pageobject.validate', { requestId, has_content: !!content, file_path });
+        try {
+            let source = content;
+            let inferredClassName = expected_class_name;
+            if (!source && file_path) {
+                assertPathAllowed(file_path, config.allowedPaths);
+                const resolved = path.resolve(file_path);
+                if (!fs.existsSync(resolved)) {
+                    const err = makeError('FILE_NOT_FOUND', `File not found: ${resolved}`, requestId);
+                    return { isError: true, content: [{ type: 'text', text: JSON.stringify(err) }] };
+                }
+                source = fs.readFileSync(resolved, 'utf-8');
+                if (!inferredClassName) {
+                    inferredClassName = path.basename(resolved, '.java');
+                }
+            }
+            if (!source) {
+                const err = makeError('MISSING_INPUT', 'Provide either content or file_path.', requestId);
+                return { isError: true, content: [{ type: 'text', text: JSON.stringify(err) }] };
+            }
+            const validation = validatePageObject(source, inferredClassName);
+            const result = { requestId, ...validation };
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result) }],
+                structuredContent: result,
+            };
+        }
+        catch (err) {
+            const error = err;
+            const errResult = makeError(error instanceof PathPolicyError ? error.code : 'VALIDATE_ERROR', error.message, requestId, false);
+            log('error', 'provar.pageobject.validate failed', { requestId, error: error.message });
+            return { isError: true, content: [{ type: 'text', text: JSON.stringify(errResult) }] };
+        }
+    });
+}
+// ── Validator (ported from quality-hub-agents/lambda/src/validator/page_object_validator.py) ──
+const VALID_LOCATOR_STRATEGIES = new Set([
+    'xpath', 'id', 'css', 'name', 'className', 'tagName',
+    'linkText', 'partialLinkText', 'visualforce', 'label',
+]);
+const VALID_ELEMENT_TYPES = new Set([
+    'TextType', 'ButtonType', 'LinkType', 'ChoiceListType',
+    'RadioType', 'FileType', 'DateType', 'RichTextType', 'BooleanType',
+]);
+const PASCAL_CASE_RE = /^[A-Z][A-Za-z0-9]*$/;
+const VALID_JAVA_IDENT_RE = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+const JAVA_RESERVED = new Set([
+    'abstract', 'assert', 'boolean', 'break', 'byte', 'case', 'catch', 'char', 'class',
+    'const', 'continue', 'default', 'do', 'double', 'else', 'enum', 'extends', 'final',
+    'finally', 'float', 'for', 'goto', 'if', 'implements', 'import', 'instanceof', 'int',
+    'interface', 'long', 'native', 'new', 'package', 'private', 'protected', 'public',
+    'return', 'short', 'static', 'strictfp', 'super', 'switch', 'synchronized', 'this',
+    'throw', 'throws', 'transient', 'try', 'void', 'volatile', 'while',
+]);
+const SF_DYNAMIC_ATTRS_RE = /data-aura-rendered-by|data-aura-class|aura-id|data-component-id/i;
+const INDEXED_XPATH_RE = /\[\d+\]/;
+const POSITION_FN_RE = /\b(last|first|position)\s*\(\s*\)/;
+const poRulesDirPath = dirname(fileURLToPath(import.meta.url));
+let poRulePenaltiesCache = null;
+function getRulePenalties() {
+    if (!poRulePenaltiesCache) {
+        try {
+            const raw = fs.readFileSync(join(poRulesDirPath, '..', 'rules', 'page_object_validation_rules.json'), 'utf-8');
+            const rules = JSON.parse(raw);
+            poRulePenaltiesCache = Object.fromEntries(rules.map((r) => [r.id, r.penalty]));
+        }
+        catch {
+            poRulePenaltiesCache = {}; // unknown rules fall back to the default 5-point penalty
+        }
+    }
+    return poRulePenaltiesCache;
+}
+/** Pure function — exported for unit testing */
+export function validatePageObject(source, expectedClassName) {
+    const issues = [];
+    const stripped = stripComments(source);
+    // ── Package ──────────────────────────────────────────────────────────────────
+    const packageMatch = /^\s*package\s+([\w.]+)\s*;/m.exec(stripped);
+    const packageName = packageMatch ? packageMatch[1] : null;
+    if (!packageMatch) {
+        issues.push({
+            rule_id: 'PO_001', severity: 'ERROR',
+            message: 'Missing package declaration.',
+            applies_to: 'class',
+            suggestion: "Add 'package pageobjects;' at the top of the file.",
+        });
+    }
+    else if (!/^[a-z][a-z0-9_]*(\.[a-z][a-z0-9_]*)*$/.test(packageName)) {
+        issues.push({
+            rule_id: 'PO_002', severity: 'ERROR',
+            message: `Invalid package name: "${packageName}".`,
+            applies_to: 'class',
+            suggestion: 'Package names should be valid lower-case Java identifiers separated by dots.',
+        });
+    }
+    // ── Class declaration ────────────────────────────────────────────────────────
+    const className = checkClassDeclaration(stripped, expectedClassName, issues);
+    // ── Brace balance ────────────────────────────────────────────────────────────
+    const openBraces = (stripped.match(/\{/g) ?? []).length;
+    const closeBraces = (stripped.match(/\}/g) ?? []).length;
+    if (openBraces !== closeBraces) {
+        issues.push({
+            rule_id: 'PO_060', severity: 'ERROR',
+            message: `Mismatched braces: ${openBraces} opening vs ${closeBraces} closing.`,
+            applies_to: 'class',
+            suggestion: 'Check for missing or extra curly braces.',
+        });
+    }
+    // ── Imports ──────────────────────────────────────────────────────────────────
+    if (!stripped.includes('import com.provar.core.testapi.annotations')) {
+        issues.push({
+            rule_id: 'PO_012', severity: 'WARNING',
+            message: 'Missing import for Provar annotations.',
+            applies_to: 'class',
+            suggestion: "Add 'import com.provar.core.testapi.annotations.*;'",
+        });
+    }
+    // ── Page annotation ──────────────────────────────────────────────────────────
+    const hasSalesforceAnnotation = checkAnnotations(stripped, issues);
+    // ── Fields ───────────────────────────────────────────────────────────────────
+    // Use original source (not stripped) so XPath "//" inside string literals
+    // is not mistakenly treated as a line comment by stripComments.
+    const fields = extractFields(source);
+    if (fields.length === 0 && !issues.some((i) => i.rule_id === 'PO_003')) {
+        issues.push({
+            rule_id: 'PO_030', severity: 'WARNING',
+            message: 'No WebElement or WebComponent fields found.',
+            applies_to: 'class',
+            suggestion: 'Add at least one WebElement field with @FindBy locator and type annotation.',
+        });
+    }
+    validateFields(fields, hasSalesforceAnnotation, issues);
+    // ── Frames ───────────────────────────────────────────────────────────────────
+    const frameCount = (stripped.match(/@PageFrame\b/g) ?? []).length;
+    // ── Commented code ───────────────────────────────────────────────────────────
+    if (/\/\/\s*(public|private|protected|@FindBy|WebElement|@\w+Type)/.test(source)) {
+        issues.push({
+            rule_id: 'PO_080', severity: 'INFO',
+            message: 'Commented-out code detected.',
+            applies_to: 'class',
+            suggestion: 'Remove commented code. Use version control to track history.',
+        });
+    }
+    // ── Quality score (sum penalties, capped at 100) ──────────────────────────
+    const rulePenalties = getRulePenalties();
+    let penalty = 0;
+    for (const issue of issues) {
+        penalty += rulePenalties[issue.rule_id] ?? 5;
+    }
+    return {
+        is_valid: issues.filter((i) => i.severity === 'ERROR').length === 0,
+        quality_score: Math.max(0, Math.min(100, 100 - penalty)),
+        class_name: className,
+        package_name: packageName,
+        field_count: fields.length,
+        frame_count: frameCount,
+        error_count: issues.filter((i) => i.severity === 'ERROR').length,
+        warning_count: issues.filter((i) => i.severity === 'WARNING').length,
+        info_count: issues.filter((i) => i.severity === 'INFO').length,
+        issues,
+    };
+}
+function checkClassDeclaration(stripped, expectedClassName, issues) {
+    const classMatch = /public\s+class\s+(\w+)/.exec(stripped);
+    const className = classMatch ? classMatch[1] : null;
+    if (!classMatch) {
+        issues.push({
+            rule_id: 'PO_003', severity: 'ERROR',
+            message: 'Missing public class declaration.',
+            applies_to: 'class',
+            suggestion: "Ensure the file has a 'public class ClassName' declaration.",
+        });
+    }
+    else {
+        if (!PASCAL_CASE_RE.test(className)) {
+            issues.push({
+                rule_id: 'PO_004', severity: 'WARNING',
+                message: `Class name "${className}" is not PascalCase.`,
+                applies_to: 'class',
+                suggestion: "Rename to PascalCase (e.g., 'MyPageObject').",
+            });
+        }
+        if (!VALID_JAVA_IDENT_RE.test(className)) {
+            issues.push({
+                rule_id: 'PO_005', severity: 'ERROR',
+                message: `Class name "${className}" is not a valid Java identifier.`,
+                applies_to: 'class',
+                suggestion: 'Class names must start with a letter, $, or _ and contain only letters, digits, $, or _.',
+            });
+        }
+        if (expectedClassName && className !== expectedClassName) {
+            issues.push({
+                rule_id: 'PO_006', severity: 'ERROR',
+                message: `Class name "${className}" does not match expected "${expectedClassName}".`,
+                applies_to: 'class',
+                suggestion: 'Class name must match the filename.',
+            });
+        }
+    }
+    return className;
+}
+function checkAnnotations(stripped, issues) {
+    const hasPageAnnotation = /@Page\s*\(/.test(stripped);
+    const hasSalesforceAnnotation = /@SalesforcePage\s*\(/.test(stripped);
+    if (!hasPageAnnotation && !hasSalesforceAnnotation) {
+        issues.push({
+            rule_id: 'PO_020', severity: 'WARNING',
+            message: 'Missing @Page or @SalesforcePage annotation.',
+            applies_to: 'annotation',
+            suggestion: 'Add @Page annotation before the class declaration.',
+        });
+    }
+    else if (hasPageAnnotation) {
+        const m = /@Page\s*\(([^)]*)\)/.exec(stripped);
+        if (m && !m[1].includes('title')) {
+            issues.push({
+                rule_id: 'PO_021', severity: 'WARNING',
+                message: '@Page annotation missing title attribute.',
+                applies_to: 'annotation',
+                suggestion: 'Add title attribute to @Page annotation.',
+            });
+        }
+    }
+    else if (hasSalesforceAnnotation) {
+        const m = /@SalesforcePage\s*\(([^)]*)\)/.exec(stripped);
+        if (m) {
+            if (!m[1].includes('title') || !m[1].includes('connection')) {
+                issues.push({
+                    rule_id: 'PO_022', severity: 'ERROR',
+                    message: '@SalesforcePage missing required title or connection attribute.',
+                    applies_to: 'annotation',
+                    suggestion: 'Add required attributes to @SalesforcePage annotation.',
+                });
+            }
+            const pageTypes = ['page', 'auraComponent', 'object', 'lightningWebComponent'];
+            if (!pageTypes.some((t) => m[1].includes(t))) {
+                issues.push({
+                    rule_id: 'PO_023', severity: 'WARNING',
+                    message: '@SalesforcePage should specify page type attribute.',
+                    applies_to: 'annotation',
+                    suggestion: 'Add one of: page, auraComponent, object, or lightningWebComponent.',
+                });
+            }
+        }
+    }
+    return hasSalesforceAnnotation;
+}
+function validateFields(fields, hasSalesforceAnnotation, issues) {
+    const fieldNames = new Set();
+    for (const field of fields) {
+        if (fieldNames.has(field.name)) {
+            issues.push({
+                rule_id: 'PO_031', severity: 'ERROR',
+                message: `Duplicate field name: "${field.name}".`,
+                applies_to: 'field',
+                suggestion: 'Rename one of the duplicate fields.',
+            });
+        }
+        else {
+            fieldNames.add(field.name);
+        }
+        if (!VALID_JAVA_IDENT_RE.test(field.name)) {
+            issues.push({
+                rule_id: 'PO_032', severity: 'ERROR',
+                message: `Invalid field name: "${field.name}".`,
+                applies_to: 'field',
+                suggestion: 'Field names must be valid Java identifiers.',
+            });
+        }
+        if (JAVA_RESERVED.has(field.name)) {
+            issues.push({
+                rule_id: 'PO_033', severity: 'ERROR',
+                message: `Field name "${field.name}" is a Java reserved word.`,
+                applies_to: 'field',
+                suggestion: 'Rename field to avoid Java reserved words.',
+            });
+        }
+        if (field.locatorStrategy && !VALID_LOCATOR_STRATEGIES.has(field.locatorStrategy)) {
+            issues.push({
+                rule_id: 'PO_034', severity: 'ERROR',
+                message: `Invalid locator strategy: "${field.locatorStrategy}".`,
+                applies_to: 'field',
+                suggestion: 'Use one of: xpath, id, css, name, className, tagName, linkText, partialLinkText, visualforce, label.',
+            });
+        }
+        if (field.elementType && !VALID_ELEMENT_TYPES.has(field.elementType)) {
+            issues.push({
+                rule_id: 'PO_036', severity: 'WARNING',
+                message: `Invalid element type: "@${field.elementType}". (CheckboxType is not valid — use BooleanType.)`,
+                applies_to: 'field',
+                suggestion: 'Use a valid Provar element type: TextType, ButtonType, LinkType, ChoiceListType, RadioType, FileType, DateType, RichTextType, BooleanType.',
+            });
+        }
+        checkLocatorQuality(field, hasSalesforceAnnotation, issues);
+    }
+}
+function checkLocatorQuality(field, hasSalesforceAnnotation, issues) {
+    const lv = field.locatorValue ?? '';
+    const strat = field.locatorStrategy ?? '';
+    if (!lv)
+        return;
+    if ((strat === 'xpath' || strat === '') && /^\/html|^\/body/i.test(lv)) {
+        issues.push({
+            rule_id: 'PO_071', severity: 'ERROR',
+            message: `Absolute XPath for field "${field.name}".`,
+            applies_to: 'field',
+            suggestion: 'Use relative XPath starting with // or .//',
+        });
+    }
+    if (SF_DYNAMIC_ATTRS_RE.test(lv)) {
+        issues.push({
+            rule_id: 'PO_073', severity: 'ERROR',
+            message: `Salesforce dynamic attribute in locator for "${field.name}".`,
+            applies_to: 'field',
+            suggestion: 'Use stable identifiers like labels, data-testid, or semantic selectors.',
+        });
+    }
+    if (strat === 'id' && hasSalesforceAnnotation) {
+        issues.push({
+            rule_id: 'PO_070', severity: 'WARNING',
+            message: `ID-based locator on Salesforce page for "${field.name}". IDs may be dynamic.`,
+            applies_to: 'field',
+            suggestion: 'Prefer xpath/css with stable attributes like data-testid, aria-label, name.',
+        });
+    }
+    if (INDEXED_XPATH_RE.test(lv)) {
+        issues.push({
+            rule_id: 'PO_072', severity: 'WARNING',
+            message: `Indexed XPath [n] for field "${field.name}".`,
+            applies_to: 'field',
+            suggestion: 'Prefer attribute-based selection over positional indexes.',
+        });
+    }
+    if (strat === 'xpath') {
+        const segments = (lv.match(/\/{2}/g) ?? []).length;
+        if (segments > 4) {
+            issues.push({
+                rule_id: 'PO_076', severity: 'WARNING',
+                message: `Complex XPath (${segments} descent operators) for "${field.name}".`,
+                applies_to: 'field',
+                suggestion: 'Simplify with a more direct path or data-testid attributes.',
+            });
+        }
+    }
+    if (POSITION_FN_RE.test(lv)) {
+        issues.push({
+            rule_id: 'PO_079', severity: 'WARNING',
+            message: `Position function (last/first/position) in XPath for "${field.name}".`,
+            applies_to: 'field',
+            suggestion: 'Use unique identifiers instead of position-based selection.',
+        });
+    }
+    if (strat === 'css' && /[a-z0-9]+-[a-z0-9]+-[a-z0-9]+/.test(lv)) {
+        issues.push({
+            rule_id: 'PO_075', severity: 'INFO',
+            message: `Possibly autogenerated CSS class pattern for "${field.name}".`,
+            applies_to: 'field',
+            suggestion: 'Prefer stable attributes over autogenerated CSS classes.',
+        });
+    }
+    if (lv.length > 200) {
+        issues.push({
+            rule_id: 'PO_078', severity: 'INFO',
+            message: `Very long locator (${lv.length} chars) for "${field.name}".`,
+            applies_to: 'field',
+            suggestion: 'Consider a shorter, more maintainable locator.',
+        });
+    }
+}
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function stripComments(source) {
+    return source
+        .replace(/\/\*[\s\S]*?\*\//g, '') // block comments
+        .replace(/\/\/[^\n]*/g, ''); // line comments
+}
+/**
+ * Extract @FindBy WebElement field declarations from stripped source.
+ * Regex captures: FindBy attrs | optional type annotation | field name.
+ */
+function extractFields(source) {
+    const fields = [];
+    const re = /@FindBy\s*\(([^)]*)\)[^;]*?(?:@(\w+)\s*\(\s*\)\s*)?(?:public|private|protected)?\s+(?:WebElement|WebComponent)\s+(\w+)\s*;/g;
+    let m;
+    while ((m = re.exec(source)) !== null) {
+        const attrs = m[1] ?? '';
+        const stratMatch = /(\w+)\s*=\s*"([^"]*)"/.exec(attrs);
+        fields.push({
+            name: m[3],
+            locatorStrategy: stratMatch ? stratMatch[1] : undefined,
+            locatorValue: stratMatch ? stratMatch[2] : undefined,
+            elementType: m[2],
+        });
+    }
+    return fields;
+}
+//# sourceMappingURL=pageObjectValidate.js.map

package/lib/mcp/tools/pageObjectValidate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pageObjectValidate.js","sourceRoot":"","sources":["../../../src/mcp/tools/pageObjectValidate.ts"],"names":[],"mappings":"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"}

package/lib/mcp/tools/projectInspect.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ServerConfig } from '../server.js';
+export declare function registerProjectInspect(server: McpServer, config: ServerConfig): void;