@provartesting/provardx-cli 1.5.1 → 1.5.2-beta.3

package/lib/mcp/utils/testCasePlanMode.js

@@ -0,0 +1,208 @@
+/*
+ * 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 os from 'node:os';
+import path from 'node:path';
+import { assertPathAllowed } from '../security/pathPolicy.js';
+/**
+ * Resolve whether a given test case file is referenced directly via
+ * `testCase`/`testCases` or via a `.testinstance` inside a plan.
+ *
+ * The resolution flow is intentionally best-effort and silent: any file
+ * read failure, JSON parse error, or path-policy violation collapses to
+ * `mode: 'unknown'` so the caller falls back to default behaviour rather
+ * than surfacing a confusing error from the validator.
+ */
+export function resolveTestCasePlanMode(opts) {
+    const propsPath = readPropertiesFilePath(opts);
+    if (!propsPath)
+        return { mode: 'unknown' };
+    let propsObj;
+    try {
+        propsObj = JSON.parse(fs.readFileSync(propsPath, 'utf-8'));
+    }
+    catch {
+        return { mode: 'unknown', propertiesFilePath: propsPath };
+    }
+    const projectPath = typeof propsObj['projectPath'] === 'string' ? propsObj['projectPath'] : null;
+    if (!projectPath) {
+        // Without a project root we cannot resolve relative `testCase` entries or
+        // walk `plans/`. The mode is unknown.
+        return { mode: 'unknown', propertiesFilePath: propsPath };
+    }
+    let resolvedProjectPath;
+    try {
+        resolvedProjectPath = path.resolve(projectPath);
+        assertPathAllowed(resolvedProjectPath, opts.allowedPaths);
+    }
+    catch {
+        return { mode: 'unknown', propertiesFilePath: propsPath };
+    }
+    const resolvedTestCasePath = path.resolve(opts.testCaseFilePath);
+    // A `.testinstance` reference inside any plan wins — plan mode supports
+    // data-driven iteration.
+    if (isReferencedFromPlanInstance(resolvedProjectPath, resolvedTestCasePath)) {
+        return { mode: 'plan', propertiesFilePath: propsPath, projectPath: resolvedProjectPath };
+    }
+    if (isReferencedDirectly(propsObj, resolvedProjectPath, resolvedTestCasePath)) {
+        return { mode: 'direct', propertiesFilePath: propsPath, projectPath: resolvedProjectPath };
+    }
+    return { mode: 'unknown', propertiesFilePath: propsPath, projectPath: resolvedProjectPath };
+}
+/**
+ * Resolve the active properties file path. Prefers an explicit override
+ * (used by tests), then `~/.sf/config.json`'s `PROVARDX_PROPERTIES_FILE_PATH`.
+ *
+ * Both the override and the value read from `~/.sf/config.json` are funnelled
+ * through `assertPathAllowed` so a caller cannot trick the resolver into
+ * reading a properties file outside the configured `allowedPaths`. Any policy
+ * violation collapses to `null` to preserve the helper's best-effort contract.
+ */
+function readPropertiesFilePath(opts) {
+    if (opts.propertiesFilePathOverride) {
+        return enforceAllowed(opts.propertiesFilePathOverride, opts.allowedPaths);
+    }
+    try {
+        const sfConfigPath = opts.sfConfigPathOverride ?? path.join(os.homedir(), '.sf', 'config.json');
+        if (!fs.existsSync(sfConfigPath))
+            return null;
+        const sfConfig = JSON.parse(fs.readFileSync(sfConfigPath, 'utf-8'));
+        const propsPath = sfConfig['PROVARDX_PROPERTIES_FILE_PATH'];
+        if (!propsPath)
+            return null;
+        return enforceAllowed(propsPath, opts.allowedPaths);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Resolve a candidate properties-file path through `assertPathAllowed`, then
+ * canonicalize via `fs.realpathSync` when the file exists so a symlink
+ * inside an allowed directory cannot redirect the read outside it. Returns
+ * `null` on any policy violation, missing file, or unexpected error — the
+ * caller treats `null` as "mode unknown" and falls back to default behaviour.
+ */
+function enforceAllowed(candidate, allowedPaths) {
+    try {
+        const resolved = path.resolve(candidate);
+        assertPathAllowed(resolved, allowedPaths);
+        if (!fs.existsSync(resolved))
+            return null;
+        try {
+            return fs.realpathSync(resolved);
+        }
+        catch {
+            return resolved;
+        }
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Does the properties file's top-level `testCase` or `testCases` array
+ * reference this test case file? Entries are interpreted relative to
+ * `<projectPath>/tests/` (per the Provar runtime convention).
+ */
+function isReferencedDirectly(props, projectPath, testCaseFilePath) {
+    const entries = [];
+    const tc = props['testCase'];
+    const tcs = props['testCases'];
+    for (const candidate of [tc, tcs]) {
+        if (typeof candidate === 'string') {
+            entries.push(candidate);
+        }
+        else if (Array.isArray(candidate)) {
+            for (const e of candidate) {
+                if (typeof e === 'string')
+                    entries.push(e);
+            }
+        }
+    }
+    if (entries.length === 0)
+        return false;
+    const testsDir = path.join(projectPath, 'tests');
+    const targetNorm = path.resolve(testCaseFilePath).toLowerCase();
+    for (const entry of entries) {
+        // Provar accepts both bare names ("MyTest") and relative paths
+        // ("Module/MyTest.testcase"). Allow either; match with and without the
+        // `.testcase` extension.
+        const variants = [];
+        const trimmed = entry.replace(/^[/\\]+/, '');
+        variants.push(path.resolve(testsDir, trimmed));
+        if (!/\.testcase$/i.test(trimmed)) {
+            variants.push(path.resolve(testsDir, `${trimmed}.testcase`));
+        }
+        for (const v of variants) {
+            if (v.toLowerCase() === targetNorm)
+                return true;
+        }
+    }
+    return false;
+}
+/**
+ * Walk `<projectPath>/plans/` for `.testinstance` files referencing this
+ * test case via `testCasePath="..."`. Best-effort — any read error skips
+ * the offending file.
+ */
+function isReferencedFromPlanInstance(projectPath, testCaseFilePath) {
+    const plansDir = path.join(projectPath, 'plans');
+    if (!fs.existsSync(plansDir))
+        return false;
+    const testsDir = path.join(projectPath, 'tests');
+    const targetNorm = path.resolve(testCaseFilePath).toLowerCase();
+    let found = false;
+    const walk = (dir) => {
+        if (found)
+            return;
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (found)
+                return;
+            if (entry.name.startsWith('.') && !entry.name.endsWith('.testinstance'))
+                continue;
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                walk(full);
+                continue;
+            }
+            if (!entry.name.endsWith('.testinstance'))
+                continue;
+            let content;
+            try {
+                content = fs.readFileSync(full, 'utf-8');
+            }
+            catch {
+                continue;
+            }
+            const matches = content.matchAll(/testCasePath=["']([^"']+)["']/g);
+            for (const m of matches) {
+                const rel = m[1].replace(/\\/g, '/');
+                // testCasePath in Provar testinstances is conventionally relative to
+                // `<projectPath>/tests/`. Also tolerate paths relative to project root.
+                const candidates = [path.resolve(testsDir, rel), path.resolve(projectPath, rel)];
+                for (const c of candidates) {
+                    if (c.toLowerCase() === targetNorm) {
+                        found = true;
+                        return;
+                    }
+                }
+            }
+        }
+    };
+    walk(plansDir);
+    return found;
+}
+//# sourceMappingURL=testCasePlanMode.js.map

package/lib/mcp/utils/testCasePlanMode.js.map

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

package/lib/mcp/utils/warningCodes.d.ts

@@ -0,0 +1,10 @@
+export declare const WARNING_CODES: {
+    readonly PROVARHOME_001: "PROVARHOME-001";
+    readonly DATA_001: "DATA-001";
+    readonly PARALLEL_001: "PARALLEL-001";
+    readonly SCHEMA_001: "SCHEMA-001";
+    readonly RUN_001: "RUN-001";
+    readonly JUNIT_001: "JUNIT-001";
+};
+export type WarningCode = (typeof WARNING_CODES)[keyof typeof WARNING_CODES];
+export declare function formatWarning(code: WarningCode, message: string, suggestion?: string): string;

package/lib/mcp/utils/warningCodes.js

@@ -0,0 +1,19 @@
+/*
+ * 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
+ */
+export const WARNING_CODES = {
+    PROVARHOME_001: 'PROVARHOME-001',
+    DATA_001: 'DATA-001',
+    PARALLEL_001: 'PARALLEL-001',
+    SCHEMA_001: 'SCHEMA-001',
+    RUN_001: 'RUN-001',
+    JUNIT_001: 'JUNIT-001',
+};
+export function formatWarning(code, message, suggestion) {
+    const base = `WARNING [${code}]: ${message}`;
+    return suggestion ? `${base} Did you mean '${suggestion}'?` : base;
+}
+//# sourceMappingURL=warningCodes.js.map

package/lib/mcp/utils/warningCodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"warningCodes.js","sourceRoot":"","sources":["../../../src/mcp/utils/warningCodes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,cAAc,EAAE,gBAAgB;IAChC,QAAQ,EAAE,UAAU;IACpB,YAAY,EAAE,cAAc;IAC5B,UAAU,EAAE,YAAY;IACxB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;CACd,CAAC;AAIX,MAAM,UAAU,aAAa,CAAC,IAAiB,EAAE,OAAe,EAAE,UAAmB;IACnF,MAAM,IAAI,GAAG,YAAY,IAAI,MAAM,OAAO,EAAE,CAAC;IAC7C,OAAO,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,kBAAkB,UAAU,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AACrE,CAAC"}

package/oclif.manifest.json

@@ -2036,5 +2036,5 @@
       ]
     }
   },
-  "version": "1.5.1"
+  "version": "1.5.2-beta.3"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@provartesting/provardx-cli",
   "description": "A plugin for the Salesforce CLI to orchestrate testing activities and report quality metrics to Provar Quality Hub",
-  "version": "1.5.1",
+  "version": "1.5.2-beta.3",
   "mcpName": "io.github.ProvarTesting/provar",
   "license": "BSD-3-Clause",
   "plugins": [
@@ -159,6 +159,7 @@
         "docs/NITROX_COMPONENT_CATALOG.md",
         "docs/NITROX_CATALOG_SOURCE.json",
         "docs/PROVAR_TOOL_GUIDE.md",
+        "docs/PROVAR_TEST_STEP_REFERENCE.md",
         "**/tsconfig.json",
         "messages/**"
       ],