@terafina/tffa-sfdx-plugin 2.1.2 → 2.2.3-rc.1

package/README.md

@@ -6,6 +6,13 @@ tffa-sfdx-plugin is a SalesforceDX plugin from Terafina containing tools for sca
 
 ## Setup
 
+Before you get started, install the required software on your computer.
+
+1. Install Java from [OpenJDK Runtime Environment 18.9 (build 11.0.2+9)](https://openjdk.java.net/install/) or via [brew](https://formulae.brew.sh/formula/openjdk@11) .Some features in Salesforce Extensions for VS Code depend upon the Java Platform.
+2. Install [sfdx-cli](https://developer.salesforce.com/tools/sfdxcli) for osx using `npm install -g sfdx-cli`
+
+For information about installing Salesforce CLI, see the Salesforce DX Setup Guide.
+
 ### **Install as a SalesforceDX Plugin**
 
 ```
@@ -34,7 +41,7 @@ $ npm install -g @terafina/tffa-sfdx-plugin
 $ sfdx COMMAND
 running command...
 $ sfdx (--version|-v)
-@terafina/tffa-sfdx-plugin/2.1.2 linux-x64 node-v16.13.1
+@terafina/tffa-sfdx-plugin/2.2.3-rc.1 linux-x64 node-v16.13.1
 $ sfdx --help [COMMAND]
 USAGE
   $ sfdx COMMAND
@@ -47,7 +54,7 @@ USAGE
   <!-- commands -->
 * [`sfdx help [COMMAND]`](#sfdx-help-command)
 * [`sfdx tffa:apexdoc [-d <directory>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-tffaapexdoc--d-directory---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
-* [`sfdx tffa:lint [-s <directory>] [-m <integer>] [-j] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-tffalint--s-directory--m-integer--j---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
+* [`sfdx tffa:lint [-s <directory>] [-m <integer>] [-p] [-r <filepath>] [-j] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-tffalint--s-directory--m-integer--p--r-filepath--j---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
 * [`sfdx tffa:meta [-s <directory>] [-d <directory>] [-c <directory>] [-o json|csv|human] [-f] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-tffameta--s-directory--d-directory--c-directory--o-jsoncsvhuman--f---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
 * [`sfdx tffa:ping [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-tffaping---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
 * [`sfdx version`](#sfdx-version)
@@ -95,21 +102,23 @@ EXAMPLES
   Generate Apex API Documentation :	$sfdx tffa:apexdoc
 ```
 
-_See code: [src/commands/tffa/apexdoc.ts](https://github.com/terafina/tffa-sfdx-plugin/blob/v2.1.2/src/commands/tffa/apexdoc.ts)_
+_See code: [src/commands/tffa/apexdoc.ts](https://github.com/terafina/tffa-sfdx-plugin/blob/v2.2.3-rc.1/src/commands/tffa/apexdoc.ts)_
 
-## `sfdx tffa:lint [-s <directory>] [-m <integer>] [-j] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
+## `sfdx tffa:lint [-s <directory>] [-m <integer>] [-p] [-r <filepath>] [-j] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
 
 scan a sfdx project and provide a violations report based on defined standards
 
 ```
 USAGE
-  $ sfdx tffa:lint [-s <directory>] [-m <integer>] [-j] [--loglevel
+  $ sfdx tffa:lint [-s <directory>] [-m <integer>] [-p] [-r <filepath>] [-j] [--loglevel
     trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
 
 FLAGS
   -j, --json                                                                        generate json output
   -m, --minapi=<value>                                                              [default: 53] minimum api version to
                                                                                     use during quality checks
+  -p, --pmd                                                                         generate pmd output
+  -r, --rulesetpath=<value>                                                         path to pmd ruleset
   -s, --sourcefolder=<value>                                                        [default: .] directory containing
                                                                                     sfdx project
   --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)  [default: warn] logging level for
@@ -122,7 +131,7 @@ EXAMPLES
   Scan a sfdx project and provide list of code violations :	$sfdx tffa:scan
 ```
 
-_See code: [src/commands/tffa/lint.ts](https://github.com/terafina/tffa-sfdx-plugin/blob/v2.1.2/src/commands/tffa/lint.ts)_
+_See code: [src/commands/tffa/lint.ts](https://github.com/terafina/tffa-sfdx-plugin/blob/v2.2.3-rc.1/src/commands/tffa/lint.ts)_
 
 ## `sfdx tffa:meta [-s <directory>] [-d <directory>] [-c <directory>] [-o json|csv|human] [-f] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
 
@@ -151,7 +160,7 @@ EXAMPLES
   scan a sfdx project for metadata :	$sfdx tffa:meta
 ```
 
-_See code: [src/commands/tffa/meta.ts](https://github.com/terafina/tffa-sfdx-plugin/blob/v2.1.2/src/commands/tffa/meta.ts)_
+_See code: [src/commands/tffa/meta.ts](https://github.com/terafina/tffa-sfdx-plugin/blob/v2.2.3-rc.1/src/commands/tffa/meta.ts)_
 
 ## `sfdx tffa:ping [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
 
@@ -173,14 +182,25 @@ EXAMPLES
   $ sfdx tffa:ping
 ```
 
-_See code: [src/commands/tffa/ping.ts](https://github.com/terafina/tffa-sfdx-plugin/blob/v2.1.2/src/commands/tffa/ping.ts)_
+_See code: [src/commands/tffa/ping.ts](https://github.com/terafina/tffa-sfdx-plugin/blob/v2.2.3-rc.1/src/commands/tffa/ping.ts)_
 
 ## `sfdx version`
 
 ```
 USAGE
-  $ sfdx version
+  $ sfdx version [--json] [--verbose]
+
+FLAGS
+  --verbose  Show additional information about the CLI.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+FLAG DESCRIPTIONS
+  --verbose  Show additional information about the CLI.
+
+    Additionally shows the architecture, node version, operating system, and versions of plugins that the CLI is using.
 ```
 
-_See code: [@oclif/plugin-version](https://github.com/oclif/plugin-version/blob/v1.0.4/src/commands/version.ts)_
+_See code: [@oclif/plugin-version](https://github.com/oclif/plugin-version/blob/v1.1.1/src/commands/version.ts)_
 <!-- commandsstop -->

package/assets/index.css

@@ -284,6 +284,8 @@ div.method:not(:last-of-type) {
 
 .code-example {
   margin: 10px 5px 10px 0;
+  word-wrap: break-word;
+  word-break: break-all;
 }
 
 .param-name {
@@ -407,9 +409,9 @@ a.nav-header {
 
 .nav-item {
   cursor: pointer;
-  height: 25px;
+  /* height: 25px;
   margin: 0;
-  padding: 6px 0 2px 40px;
+  padding: 6px 0 2px 40px;*/
   user-select: none;
 }
 
@@ -443,6 +445,9 @@ a.nav-header {
 
 .nav-item a {
   text-decoration: none;
+  display: block;
+  line-height: 2rem;
+  padding-left: 2.5rem;
 }
 
 details summary::-webkit-details-marker {

package/bin/pmd/apex_ruleset.xml

@@ -0,0 +1,321 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<ruleset
+  xmlns="http://pmd.sourceforge.net/ruleset/2.0.0"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  name="Default ruleset used by the CodeClimate Engine for Salesforce.com Apex"
+  xsi:schemaLocation="http://pmd.sourceforge.net/ruleset/2.0.0 http://pmd.sourceforge.net/ruleset_2_0_0.xsd"
+>
+   <description>Default ruleset used by the Code Climate Engine for Salesforce.com Apex</description>
+   <exclude-pattern>.*/.sfdx/.*</exclude-pattern>
+   <exclude-pattern>.*/data/.*</exclude-pattern>
+   <exclude-pattern>.*/design/.*</exclude-pattern>
+   <exclude-pattern>.*/mdapi-source/.*</exclude-pattern>
+   <exclude-pattern>.*/guides/.*</exclude-pattern>
+   <exclude-pattern>.*/dist/.*</exclude-pattern>
+   <exclude-pattern>.*/scripts/.*</exclude-pattern>
+   <exclude-pattern>.*/node_modules/.*</exclude-pattern>
+   <!-- BEST PRACTICES -->
+   <!-- <rule
+    ref="category/apex/bestpractices.xml/ApexAssertionsShouldIncludeMessage"
+    message="Apex test assert statement should make use of the message parameter."
+  >
+    <priority>3</priority>
+    <properties>
+      
+    </properties>
+  </rule> -->
+   <rule ref="category/apex/bestpractices.xml/AvoidLogicInTrigger" message="Avoid logic in triggers">
+      <priority>3</priority>
+      <properties />
+   </rule>
+   <!-- 
+  <rule ref="category/apex/bestpractices.xml/UnusedLocalVariable" message="Variable ''{0}'' defined but not used">
+    <priority>3</priority>
+    <properties></properties>
+  </rule> -->
+   <rule
+    ref="category/apex/bestpractices.xml/ApexUnitTestClassShouldHaveAsserts"
+    message="Apex unit test classes should have at least one System.assert() or assertEquals() or AssertNotEquals() call"
+  >
+      <priority>3</priority>
+      <properties />
+   </rule>
+   <rule
+    ref="category/apex/bestpractices.xml/ApexUnitTestMethodShouldHaveIsTestAnnotation"
+    message="Apex test methods should have @isTest annotation."
+  >
+      <priority>3</priority>
+      <properties />
+   </rule>
+   <rule
+    ref="category/apex/bestpractices.xml/ApexUnitTestShouldNotUseSeeAllDataTrue"
+    message="@isTest(seeAllData=true) should not be used in Apex unit tests because it opens up the existing database data for unexpected modification by tests"
+  >
+      <priority>3</priority>
+      <properties />
+   </rule>
+   <!-- DESIGN -->
+   <rule ref="category/apex/design.xml/ExcessiveClassLength" message="Avoid really long classes (lines of code)">
+      <priority>3</priority>
+      <properties>
+         <property name="minimum" value="4000" />
+      </properties>
+   </rule>
+   <rule ref="category/apex/design.xml/ExcessiveParameterList" message="Avoid long parameter lists">
+      <priority>3</priority>
+      <properties>
+         <property name="minimum" value="10" />
+      </properties>
+   </rule>
+   <!-- <rule ref="category/apex/design.xml/ExcessivePublicCount" message="This class has too many public methods and attributes">
+      <priority>3</priority>
+      <properties>
+         <property name="minimum" value="1000" />
+      </properties>
+   </rule> -->
+   <rule ref="category/apex/design.xml/NcssConstructorCount" message="The constructor has an NCSS line count of {0}">
+      <priority>3</priority>
+      <properties>
+         <property name="minimum" value="40" />
+      </properties>
+   </rule>
+   <rule ref="category/apex/design.xml/NcssMethodCount" message="The method {0}() has an NCSS line count of {1}">
+      <priority>3</priority>
+      <properties>
+         <property name="minimum" value="200" />
+      </properties>
+   </rule>
+   <rule ref="category/apex/design.xml/NcssTypeCount" message="The type has an NCSS line count of {0}">
+      <priority>3</priority>
+      <properties>
+         <property name="minimum" value="1500" />
+      </properties>
+   </rule>
+   <rule ref="category/apex/design.xml/AvoidDeeplyNestedIfStmts" message="Deeply nested if..else statements are hard to read">
+      <priority>3</priority>
+      <properties>
+         <property name="problemDepth" value="10" />
+      </properties>
+   </rule>
+   <rule ref="category/apex/design.xml/CyclomaticComplexity">
+      <priority>3</priority>
+      <properties>
+         <property name="classReportLevel" value="800" />
+         <property name="methodReportLevel" value="100" />
+      </properties>
+   </rule>
+   <rule ref="category/apex/design.xml/CognitiveComplexity">
+      <priority>3</priority>
+      <properties>
+         <property name="classReportLevel" value="800" />
+         <property name="methodReportLevel" value="100" />
+      </properties>
+   </rule>
+   <!-- PERFORMANCE -->
+   <rule ref="category/apex/performance.xml/AvoidDebugStatements" message="Avoid debug statements since they impact on performance">
+      <priority>3</priority>
+      <properties />
+   </rule>
+   <rule ref="category/apex/performance.xml/OperationWithLimitsInLoop" message="Avoid operations in loops that may hit governor limits">
+      <priority>3</priority>
+      <properties />
+   </rule>
+   <!-- <rule
+    ref="category/apex/performance.xml/EagerlyLoadedDescribeSObjectResult"
+    message="DescribeSObjectResult could be being loaded eagerly with all child relationships."
+  >
+    <priority>3</priority>
+    <properties>
+        
+      
+      
+    </properties>
+</rule> -->
+   <!-- CODE STYLE -->
+   <rule ref="category/apex/codestyle.xml/OneDeclarationPerLine">
+      <priority>3</priority>
+      <properties />
+   </rule>
+   <rule ref="category/apex/codestyle.xml/ClassNamingConventions" message="Class names should begin with an uppercase character">
+      <priority>3</priority>
+      <properties />
+   </rule>
+   <!-- <rule
+    ref="category/apex/codestyle.xml/FieldDeclarationsShouldBeAtStart"
+    message="Field declaration for ''{0}'' should be before method declarations in its class"
+  >
+      <priority>3</priority>
+      <properties>
+        
+        
+         
+      </properties>
+   </rule> -->
+   <rule ref="category/apex/codestyle.xml/MethodNamingConventions" message="Method name does not begin with a lower case character.">
+      <priority>3</priority>
+      <properties />
+   </rule>
+   <rule
+    ref="category/apex/errorprone.xml/MethodWithSameNameAsEnclosingClass"
+    message="Classes should not have non-constructor methods with the same name as the class"
+  >
+      <priority>3</priority>
+      <properties />
+   </rule>
+   <rule ref="category/apex/codestyle.xml/FieldNamingConventions">
+      <properties>
+         <property name="enumConstantPattern" value="[A-Z][a-zA-Z0-9_]*" />
+         <property name="constantPattern" value="[a-zA-Z0-9_]*" />
+         <property name="finalPattern" value="[a-zA-Z0-9_]*" />
+         <property name="staticPattern" value="[a-zA-Z0-9_]*" />
+         <property name="instancePattern" value="[a-zA-Z][a-zA-Z0-9_]*" />
+      </properties>
+   </rule>
+   <rule ref="category/apex/codestyle.xml/PropertyNamingConventions">
+      <properties>
+         <property name="staticPattern" value="[a-z][a-z_A-Z0-9]*" />
+         <property name="instancePattern" value="[a-z][a-z_A-Z0-9]*" />
+      </properties>
+   </rule>
+   <rule ref="category/apex/codestyle.xml/FormalParameterNamingConventions">
+      <properties>
+         <property name="finalMethodParameterPattern" value="[a-z][a-zA-Z0-9]*" />
+         <property name="methodParameterPattern" value="[a-z][a-zA-Z0-9_]*" />
+      </properties>
+   </rule>
+   <rule ref="category/apex/codestyle.xml/LocalVariableNamingConventions">
+      <properties>
+         <property name="finalLocalPattern" value="[a-z][a-zA-Z0-9]*" />
+         <property name="localPattern" value="[a-z][a-zA-Z0-9]*" />
+      </properties>
+   </rule>
+   <!-- SECURITY -->
+   <rule ref="category/apex/security.xml/ApexInsecureEndpoint" message="Apex callouts should use encrypted communication channels">
+      <priority>3</priority>
+      <properties />
+   </rule>
+   <rule
+    ref="category/apex/security.xml/ApexSharingViolations"
+    message="Apex classes should declare a sharing model if DML or SOQL/SOSL is used"
+  >
+      <priority>3</priority>
+      <properties />
+   </rule>
+   <rule ref="category/apex/security.xml/ApexOpenRedirect" message="Apex classes should safely redirect to a known location">
+      <priority>3</priority>
+      <properties />
+   </rule>
+   <rule ref="category/apex/security.xml/ApexSOQLInjection" message="Apex classes should escape variables merged in DML query">
+      <priority>3</priority>
+      <properties />
+   </rule>
+   <rule ref="category/apex/security.xml/ApexXSSFromURLParam" message="Apex classes should escape Strings obtained from URL parameters">
+      <priority>3</priority>
+      <properties />
+   </rule>
+   <rule ref="category/apex/security.xml/ApexXSSFromEscapeFalse" message="Apex classes should escape addError strings">
+      <priority>3</priority>
+      <properties />
+   </rule>
+   <rule ref="category/apex/security.xml/ApexBadCrypto" message="Apex Crypto should use random IV/key">
+      <priority>3</priority>
+      <properties />
+   </rule>
+   <rule ref="category/apex/security.xml/ApexCRUDViolation" message="Validate CRUD permission before SOQL/DML operation">
+      <priority>3</priority>
+      <properties />
+   </rule>
+   <rule ref="category/apex/security.xml/ApexDangerousMethods" message="Calling potentially dangerous method">
+      <priority>3</priority>
+      <properties />
+   </rule>
+   <rule ref="category/apex/security.xml/ApexSuggestUsingNamedCred" message="Consider using named credentials for authenticated callouts">
+      <priority>3</priority>
+      <properties />
+   </rule>
+   <!-- ERROR PRONE -->
+   <rule ref="category/apex/codestyle.xml/WhileLoopsMustUseBraces" message="Avoid using 'while' statements without curly braces">
+      <priority>3</priority>
+      <properties />
+   </rule>
+   <rule ref="category/apex/codestyle.xml/ForLoopsMustUseBraces" message="Avoid using 'for' statements without curly braces">
+      <priority>3</priority>
+      <properties />
+   </rule>
+   <rule ref="category/apex/errorprone.xml/ApexCSRF" message="Avoid making DML operations in Apex class constructor/init method">
+      <priority>3</priority>
+      <properties />
+   </rule>
+   <rule ref="category/apex/errorprone.xml/EmptyCatchBlock" message="Avoid empty catch blocks">
+      <priority>3</priority>
+      <properties />
+   </rule>
+   <rule ref="category/apex/errorprone.xml/EmptyIfStmt" message="Avoid empty 'if' statements">
+      <priority>3</priority>
+      <properties />
+   </rule>
+   <rule ref="category/apex/errorprone.xml/AvoidDirectAccessTriggerMap" message="Avoid directly accessing Trigger.old and Trigger.new">
+      <priority>3</priority>
+      <properties />
+   </rule>
+   <rule ref="category/apex/errorprone.xml/AvoidNonExistentAnnotations">
+      <properties />
+   </rule>
+   <rule ref="category/apex/errorprone.xml/AvoidHardcodingId" message="Avoid hardcoding ID's">
+      <priority>3</priority>
+      <properties />
+   </rule>
+   <!-- <rule ref="category/apex/errorprone.xml/EmptyStatementBlock" message="Avoid empty 'if' statements">
+    <priority>3</priority>
+    <properties>
+    
+     
+     
+      
+    </properties>
+  </rule> 
+  -->
+   <rule ref="category/apex/errorprone.xml/EmptyWhileStmt" message="Avoid empty 'while' statements">
+      <priority>3</priority>
+      <properties />
+   </rule>
+   <rule ref="category/apex/errorprone.xml/EmptyTryOrFinallyBlock" message="Avoid empty try or finally blocks">
+      <priority>3</priority>
+      <properties />
+   </rule>
+   <rule
+    ref="category/apex/errorprone.xml/InaccessibleAuraEnabledGetter"
+    message="AuraEnabled getter must be public or global if is referenced in Lightning components"
+  >
+      <priority>3</priority>
+      <properties />
+   </rule>
+   <rule
+    ref="category/apex/errorprone.xml/MethodWithSameNameAsEnclosingClass"
+    message="Non-constructor methods should not have the same name as the enclosing class."
+  >
+      <priority>3</priority>
+      <properties />
+   </rule>
+   <rule ref="category/apex/errorprone.xml/OverrideBothEqualsAndHashcode" message="Ensure you override both equals() and hashCode()">
+      <priority>3</priority>
+      <properties />
+   </rule>
+   <rule ref="category/apex/errorprone.xml/TestMethodsMustBeInTestClasses" message="Test methods must be in test classes">
+      <priority>3</priority>
+      <properties />
+   </rule>
+   <!-- END ERROR PRONE -->
+    <!-- DOCUMENTATION -->
+   <!-- <rule ref="category/apex/documentation.xml/ApexDoc" message="ApexDoc comment is missing or incorrect">
+      <priority>3</priority>
+      <properties>
+        <property name="reportPrivate" value="false" />
+        <property name="reportProtected" value="false" />
+        <property name="reportMissingDescription" value="false" />
+        <property name="reportProperty" value="false" />
+         
+      </properties>
+   </rule> -->
+    <!-- END DOCUMENTATION -->
+</ruleset>

package/bin/pmd/lib/pmd-apex-jorje-6.47.0.pom

@@ -0,0 +1,140 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+  <modelVersion>4.0.0</modelVersion>
+  <artifactId>pmd-apex-jorje</artifactId>
+  <name>PMD Apex Jorje Parser Library</name>
+  <packaging>pom</packaging>
+
+  <parent>
+    <groupId>net.sourceforge.pmd</groupId>
+    <artifactId>pmd</artifactId>
+    <version>6.47.0</version>
+    <relativePath>../pom.xml</relativePath>
+  </parent>
+
+  <properties>
+    <java.version>8</java.version>
+    <apex.jorje.version>2021-10-08-631b8c</apex.jorje.version>
+  </properties>
+
+  <build>
+    <plugins>
+      <plugin>
+        <groupId>org.codehaus.mojo</groupId>
+        <artifactId>build-helper-maven-plugin</artifactId>
+        <version>3.0.0</version>
+        <executions>
+            <execution>
+                <id>attach-apex-jorje</id>
+                <phase>package</phase>
+                <goals>
+                    <goal>attach-artifact</goal>
+                </goals>
+                <configuration>
+                    <artifacts>
+                        <artifact>
+                            <file>${basedir}/repo/apex/apex-jorje-lsp-minimized/${apex.jorje.version}/apex-jorje-lsp-minimized-${apex.jorje.version}.jar</file>
+                            <type>jar</type>
+                            <classifier>lib</classifier>
+                        </artifact>
+                    </artifacts>
+                </configuration>
+            </execution>
+        </executions>
+      </plugin>
+    </plugins>
+  </build>
+  <dependencies>
+    <!-- transitive dependencies of apex-jorje -->
+    <dependency>
+        <groupId>cglib</groupId>
+        <artifactId>cglib</artifactId>
+        <version>3.3.0</version> <!-- apex jorje actually depends on 3.2.0 (https://github.com/forcedotcom/salesforcedx-vscode/commit/631b8cfb85cff5e989bfea13bca681b6cedcb003) -->
+    </dependency>
+    <dependency>
+        <groupId>ch.qos.logback</groupId>
+        <artifactId>logback-classic</artifactId>
+        <version>1.2.9</version> <!-- apex jorje actually depends on 1.1.7 (https://github.com/forcedotcom/salesforcedx-vscode/commit/631b8cfb85cff5e989bfea13bca681b6cedcb003) -->
+    </dependency>
+    <dependency>
+        <groupId>ch.qos.logback</groupId>
+        <artifactId>logback-core</artifactId>
+        <version>1.2.9</version> <!-- apex jorje actually depends on 1.1.7 (https://github.com/forcedotcom/salesforcedx-vscode/commit/631b8cfb85cff5e989bfea13bca681b6cedcb003) -->
+    </dependency>
+    <dependency>
+        <groupId>com.google.code.findbugs</groupId>
+        <artifactId>jsr305</artifactId>
+        <version>3.0.2</version>
+    </dependency>
+    <dependency>
+        <groupId>com.google.code.gson</groupId>
+        <artifactId>gson</artifactId>
+        <!-- apex jorje actually depends on 2.7 (https://github.com/forcedotcom/salesforcedx-vscode/commit/631b8cfb85cff5e989bfea13bca681b6cedcb003) -->
+    </dependency>
+    <dependency>
+        <groupId>com.google.errorprone</groupId>
+        <artifactId>error_prone_annotations</artifactId>
+        <version>2.1.3</version>
+    </dependency>
+    <dependency>
+        <groupId>com.google.guava</groupId>
+        <artifactId>guava</artifactId>
+        <!-- apex jorje actually depends on 26.0-jre (https://github.com/forcedotcom/salesforcedx-vscode/commit/631b8cfb85cff5e989bfea13bca681b6cedcb003) -->
+    </dependency>
+    <dependency>
+        <groupId>com.google.j2objc</groupId>
+        <artifactId>j2objc-annotations</artifactId>
+        <version>1.1</version>
+    </dependency>
+    <dependency>
+        <groupId>org.antlr</groupId>
+        <artifactId>antlr-runtime</artifactId>
+    </dependency>
+    <dependency>
+        <groupId>org.antlr</groupId>
+        <artifactId>stringtemplate</artifactId>
+        <version>3.2.1</version>
+    </dependency>
+    <dependency>
+        <groupId>org.apache.commons</groupId>
+        <artifactId>commons-lang3</artifactId>
+        <version>3.0</version>
+    </dependency>
+    <dependency>
+        <groupId>org.codehaus.mojo</groupId>
+        <artifactId>animal-sniffer-annotations</artifactId>
+        <version>1.14</version>
+    </dependency>
+    <dependency>
+        <groupId>org.openjdk.jol</groupId>
+        <artifactId>jol-core</artifactId>
+        <version>0.4</version>
+    </dependency>
+    <dependency>
+        <groupId>org.slf4j</groupId>
+        <artifactId>slf4j-api</artifactId>
+        <!-- apex jorje actually depends on 1.7.20 (https://github.com/forcedotcom/salesforcedx-vscode/commit/631b8cfb85cff5e989bfea13bca681b6cedcb003) -->
+    </dependency>
+    <dependency>
+        <groupId>org.yaml</groupId>
+        <artifactId>snakeyaml</artifactId>
+        <!-- apex jorje actually depends on 1.17 (https://github.com/forcedotcom/salesforcedx-vscode/commit/631b8cfb85cff5e989bfea13bca681b6cedcb003) -->
+    </dependency>
+    <dependency>
+        <groupId>aopalliance</groupId>
+        <artifactId>aopalliance</artifactId>
+        <version>1.0</version>
+    </dependency>
+    <dependency>
+        <groupId>javax.inject</groupId>
+        <artifactId>javax.inject</artifactId>
+        <version>1</version>
+    </dependency>
+    <dependency>
+        <groupId>org.ow2.asm</groupId>
+        <artifactId>asm</artifactId>
+        <version>5.0.3</version>
+        <scope>runtime</scope>
+    </dependency>
+  </dependencies>
+</project>

package/bin/update.sh

@@ -0,0 +1,49 @@
+DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" >/dev/null 2>&1 && pwd )"
+rm -rf ${DIR}/pmd/lib/*
+VERSION=$(curl -s https://api.github.com/repos/pmd/pmd/releases/latest | jq --raw-output ".tag_name")
+DOWNLOAD_URL=$(curl -s https://api.github.com/repos/pmd/pmd/releases/latest | jq --raw-output ".assets[].browser_download_url" | grep pmd-bin)
+echo "version=${VERSION}"
+echo "url=${DOWNLOAD_URL}"
+curl $DOWNLOAD_URL -L -o ${DIR}/pmd.zip
+mkdir -p ${DIR}/pmd
+bsdtar --strip-components=1 -xvf ${DIR}/pmd.zip -C ${DIR}/pmd
+rm ${DIR}/pmd.zip
+cd ./pmd/lib
+rm -rf fast*
+rm -rf groovy*
+rm -rf lenses*
+rm -rf parsers*
+rm -rf protobuf*
+rm -rf scala*
+rm -rf sourcecode*
+rm -rf trees*
+rm -rf jsoup*
+rm -rf pmd-cpp*
+rm -rf pmd-cs*
+rm -rf pmd-dart*
+rm -rf pmd-fortran*
+rm -rf pmd-go*
+rm -rf pmd-groovy*
+rm -rf pmd-jsp*
+rm -rf pmd-kotlin*
+rm -rf pmd-lua*
+rm -rf pmd-matlab*
+rm -rf pmd-modelica*
+rm -rf pmd-objectivec*
+rm -rf pmd-perl*
+rm -rf pmd-php*
+rm -rf pmd-plsql*
+rm -rf pmd-python*
+rm -rf pmd-ruby*
+rm -rf pmd-scala*
+rm -rf pmd-swift*
+rm -rf pmd-ui*
+rm -rf pmd-html*
+rm -rf pmd-java*
+rm -rf pmd-javascript*
+rm -rf pmd-visualforce*
+rm -rf pmd-xml*
+rm -rf pmd-vm*
+cd ../..
+rm -rf ${DIR}/pmd/bin
+rm -rf ${DIR}/pmd/LICENSE

package/lib/commands/tffa/lint.d.ts

@@ -9,6 +9,8 @@ export default class Lint extends SfdxCommand {
         sourcefolder: flags.Discriminated<flags.String>;
         minapi: flags.Discriminated<flags.Number>;
         json: flags.Discriminated<flags.Boolean<boolean>>;
+        pmd: flags.Discriminated<flags.Boolean<boolean>>;
+        rulesetpath: flags.Discriminated<flags.String>;
     };
     run(): Promise<any>;
     /**

package/lib/commands/tffa/lint.js

@@ -9,6 +9,7 @@ const core_1 = require("@salesforce/core");
 const apex_class_lint_1 = tslib_1.__importDefault(require("../../shared/lint/apex-class-lint"));
 const ignored_files_1 = tslib_1.__importDefault(require("../../shared/lint/ignored-files"));
 const metadata_lint_1 = tslib_1.__importDefault(require("../../shared/lint/metadata-lint"));
+const apex_1 = tslib_1.__importDefault(require("../../shared/pmd/apex"));
 class Lint extends command_1.SfdxCommand {
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     async run() {
@@ -16,8 +17,12 @@ class Lint extends command_1.SfdxCommand {
         let violations = [];
         await ignored_files_1.default.init(this.flags.sourcefolder);
         violations = await new apex_class_lint_1.default().scan(this.flags.sourcefolder);
-        const mViolations = await new metadata_lint_1.default().scan(this.flags.sourcefolder, this.flags.minapi);
+        let mViolations = await new metadata_lint_1.default().scan(this.flags.sourcefolder, this.flags.minapi);
         violations.push(...mViolations);
+        if (this.flags.pmd) {
+            mViolations = await new apex_1.default().scan(this.flags.sourcefolder, this.flags.rulesetpath);
+            violations.push(...mViolations);
+        }
         this.printViolations(this.flags.json, violations);
     }
     /**
@@ -54,6 +59,14 @@ Lint.flagsConfig = {
     json: command_1.flags.boolean({
         char: 'j',
         description: 'generate json output'
+    }),
+    pmd: command_1.flags.boolean({
+        char: 'p',
+        description: 'generate pmd output'
+    }),
+    rulesetpath: command_1.flags.filepath({
+        char: 'r',
+        description: 'path to pmd ruleset'
     })
 };
 //# sourceMappingURL=lint.js.map

package/lib/commands/tffa/lint.js.map

@@ -1 +1 @@
-{"version":3,"file":"lint.js","sourceRoot":"","sources":["../../../src/commands/tffa/lint.ts"],"names":[],"mappings":";AAAA;;IAEI;;;AAEJ,iDAAyD;AACzD,2CAA+C;AAC/C,gGAA8D;AAC9D,4FAA2D;AAC3D,4FAA2D;AAE3D,MAAqB,IAAK,SAAQ,qBAAW;IAqB3C,8DAA8D;IACvD,KAAK,CAAC,GAAG;QACd,MAAM,kBAAW,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACnD,IAAI,UAAU,GAAG,EAAE,CAAC;QACpB,MAAM,uBAAY,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACjD,UAAU,GAAG,MAAM,IAAI,yBAAa,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACrE,MAAM,WAAW,GAAG,MAAM,IAAI,uBAAY,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC9F,UAAU,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;QAChC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,MAAM,EAAE,UAAU;QACxC,IAAI,MAAM,EAAE;YACV,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;SAClD;aAAM;YACL,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE;gBAC1B,OAAO,CAAC,GAAG,CAAC,mFAAmF,CAAC,CAAC;gBACjG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,GAAG,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;gBAC1C,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;gBACzC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;aAC7B;SACF;IACH,CAAC;;AA9CH,uBA+CC;AA9Ce,gBAAW,GAAG,gFAAgF,CAAC;AAC/F,aAAQ,GAAG,CAAC,4EAA4E,CAAC,CAAC;AAEvF,gBAAW,GAAG;IAC7B,YAAY,EAAE,eAAK,CAAC,SAAS,CAAC;QAC5B,IAAI,EAAE,GAAG;QACT,WAAW,EAAE,mCAAmC;QAChD,OAAO,EAAE,GAAG;KACb,CAAC;IACF,MAAM,EAAE,eAAK,CAAC,OAAO,CAAC;QACpB,IAAI,EAAE,GAAG;QACT,WAAW,EAAE,kDAAkD;QAC/D,OAAO,EAAE,EAAE;KACZ,CAAC;IACF,IAAI,EAAE,eAAK,CAAC,OAAO,CAAC;QAClB,IAAI,EAAE,GAAG;QACT,WAAW,EAAE,sBAAsB;KACpC,CAAC;CACH,CAAC"}
+{"version":3,"file":"lint.js","sourceRoot":"","sources":["../../../src/commands/tffa/lint.ts"],"names":[],"mappings":";AAAA;;IAEI;;;AAEJ,iDAAyD;AACzD,2CAA+C;AAC/C,gGAA8D;AAC9D,4FAA2D;AAC3D,4FAA2D;AAC3D,yEAA4C;AAE5C,MAAqB,IAAK,SAAQ,qBAAW;IA6B3C,8DAA8D;IACvD,KAAK,CAAC,GAAG;QACd,MAAM,kBAAW,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACnD,IAAI,UAAU,GAAG,EAAE,CAAC;QACpB,MAAM,uBAAY,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAEjD,UAAU,GAAG,MAAM,IAAI,yBAAa,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACrE,IAAI,WAAW,GAAG,MAAM,IAAI,uBAAY,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC5F,UAAU,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;QAChC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE;YAClB,WAAW,GAAG,MAAM,IAAI,cAAO,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YACxF,UAAU,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;SACjC;QAED,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,MAAM,EAAE,UAAU;QACxC,IAAI,MAAM,EAAE;YACV,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;SAClD;aAAM;YACL,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE;gBAC1B,OAAO,CAAC,GAAG,CAAC,mFAAmF,CAAC,CAAC;gBACjG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,GAAG,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;gBAC1C,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;gBACzC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;aAC7B;SACF;IACH,CAAC;;AA5DH,uBA6DC;AA5De,gBAAW,GAAG,gFAAgF,CAAC;AAC/F,aAAQ,GAAG,CAAC,4EAA4E,CAAC,CAAC;AAEvF,gBAAW,GAAG;IAC7B,YAAY,EAAE,eAAK,CAAC,SAAS,CAAC;QAC5B,IAAI,EAAE,GAAG;QACT,WAAW,EAAE,mCAAmC;QAChD,OAAO,EAAE,GAAG;KACb,CAAC;IACF,MAAM,EAAE,eAAK,CAAC,OAAO,CAAC;QACpB,IAAI,EAAE,GAAG;QACT,WAAW,EAAE,kDAAkD;QAC/D,OAAO,EAAE,EAAE;KACZ,CAAC;IACF,IAAI,EAAE,eAAK,CAAC,OAAO,CAAC;QAClB,IAAI,EAAE,GAAG;QACT,WAAW,EAAE,sBAAsB;KACpC,CAAC;IACF,GAAG,EAAE,eAAK,CAAC,OAAO,CAAC;QACjB,IAAI,EAAE,GAAG;QACT,WAAW,EAAE,qBAAqB;KACnC,CAAC;IACF,WAAW,EAAE,eAAK,CAAC,QAAQ,CAAC;QAC1B,IAAI,EAAE,GAAG;QACT,WAAW,EAAE,qBAAqB;KACnC,CAAC;CACH,CAAC"}

package/lib/shared/pmd/apex.d.ts

@@ -0,0 +1,8 @@
+import { Logger } from '@salesforce/core';
+export default class ApexPMD {
+    ignoreFiles: any[];
+    logger: Logger;
+    scan(sourceFolder: string, rulesetpath: string): Promise<any[]>;
+    private executeCmd;
+    private parseProblems;
+}

package/lib/shared/pmd/apex.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+/**
+ * Copyright (c) NCR Terafina
+ **/
+const ChildProcess = tslib_1.__importStar(require("child_process"));
+const path = tslib_1.__importStar(require("path"));
+const os = tslib_1.__importStar(require("os"));
+const core_1 = require("@salesforce/core");
+const JreSetupManager = tslib_1.__importStar(require("./jreSetupManager"));
+const ignored_files_1 = tslib_1.__importDefault(require("../lint/ignored-files"));
+//setup OS constants
+const CLASSPATH_DELM = os.platform() === 'win32' ? ';' : ':';
+class ApexPMD {
+    constructor() {
+        this.ignoreFiles = [];
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async scan(sourceFolder, rulesetpath) {
+        this.logger = await core_1.Logger.root();
+        this.ignoreFiles.push(...ignored_files_1.default.files);
+        this.logger.debug(this.ignoreFiles);
+        const dir = sourceFolder + '/app/';
+        try {
+            const data = await this.executeCmd(dir, rulesetpath);
+            const violations = this.parseProblems(data, sourceFolder);
+            return violations;
+        }
+        catch (err) {
+            console.error(err);
+        }
+    }
+    async executeCmd(targetPath, rulesetpath) {
+        const cacheKey = '--no-cache';
+        const formatKey = `-f json`;
+        const targetPathKey = `-d "${targetPath}"`;
+        const javaHome = await JreSetupManager.verifyJreSetup();
+        const javaExc = path.join(javaHome, 'bin', 'java');
+        const commandBufferSize = 64;
+        const pmdBinPath = path.join(__dirname, '../../../', 'bin', 'pmd');
+        let rulesetsArg = path.join(pmdBinPath, 'apex_ruleset.xml');
+        if (rulesetpath) {
+            rulesetsArg = rulesetpath;
+        }
+        const rulesetsKey = `-R "${rulesetsArg}"`;
+        const classPath = [path.join(pmdBinPath, 'lib', '*')].join(CLASSPATH_DELM);
+        const pmdKeys = `${formatKey} ${cacheKey} ${targetPathKey} ${rulesetsKey}`;
+        const cmd = `${javaExc} -cp "${classPath}" net.sourceforge.pmd.PMD ${pmdKeys}`;
+        this.logger.info('PMD Command: ' + cmd);
+        const pmdCmd = ChildProcess.exec(cmd, {
+            maxBuffer: Math.max(commandBufferSize, 1) * 1024 * 1024
+        });
+        let stdout = '';
+        let stderr = '';
+        const pmdPromise = new Promise((resolve, reject) => {
+            pmdCmd.addListener('error', e => {
+                this.logger.error('error:' + e);
+                reject(e);
+            });
+            pmdCmd.addListener('exit', e => {
+                if (e !== 0 && e !== 4) {
+                    this.logger.error(`Failed Exit Code: ${e}` + stderr);
+                    reject(stderr);
+                }
+                else {
+                    resolve(stdout);
+                }
+            });
+            pmdCmd.stdout.on('data', (m) => {
+                this.logger.info('stdout:' + m);
+                stdout += m;
+            });
+            pmdCmd.stderr.on('data', (m) => {
+                this.logger.error('stderr:' + m);
+                stderr += m;
+            });
+        });
+        return pmdPromise;
+    }
+    parseProblems(json, sourceFolder) {
+        const violations = [];
+        this.logger.debug(json);
+        if (!json) {
+            return violations;
+        }
+        const p = JSON.parse(json);
+        if (!p.files) {
+            return violations;
+        }
+        for (const f of p.files) {
+            for (const v of f.violations) {
+                // const filename = f.filename.replace(sourceFolder + '/', '');
+                const filename = path.basename(f.filename, '.cls');
+                const o = {
+                    label: v.description + ' at line ' + v.beginline,
+                    message: v.externalInfoUrl,
+                    category: 'PMD.' + v.rule,
+                    level: v.priority === 2 ? 'FATAL' : 'WARN',
+                    exceptions: [filename]
+                };
+                if (this.ignoreFiles.indexOf(filename) < 0) {
+                    violations.push(o);
+                }
+            }
+        }
+        return violations;
+    }
+}
+exports.default = ApexPMD;
+//# sourceMappingURL=apex.js.map

package/lib/shared/pmd/apex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apex.js","sourceRoot":"","sources":["../../../src/shared/pmd/apex.ts"],"names":[],"mappings":";;;AAAA;;IAEI;AACJ,oEAA8C;AAC9C,mDAA6B;AAC7B,+CAAyB;AACzB,2CAA0C;AAC1C,2EAAqD;AACrD,kFAAiD;AAEjD,oBAAoB;AACpB,MAAM,cAAc,GAAG,EAAE,CAAC,QAAQ,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;AAE7D,MAAqB,OAAO;IAA5B;QACE,gBAAW,GAAG,EAAE,CAAC;IAuGnB,CAAC;IApGC,8DAA8D;IACvD,KAAK,CAAC,IAAI,CAAC,YAAoB,EAAE,WAAmB;QACzD,IAAI,CAAC,MAAM,GAAG,MAAM,aAAM,CAAC,IAAI,EAAE,CAAC;QAElC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,uBAAY,CAAC,KAAK,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAEpC,MAAM,GAAG,GAAG,YAAY,GAAG,OAAO,CAAC;QACnC,IAAI;YACF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;YACrD,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;YAC1D,OAAO,UAAU,CAAC;SACnB;QAAC,OAAO,GAAG,EAAE;YACZ,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;SACpB;IACH,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,UAAkB,EAAE,WAAmB;QAC9D,MAAM,QAAQ,GAAG,YAAY,CAAC;QAC9B,MAAM,SAAS,GAAG,SAAS,CAAC;QAC5B,MAAM,aAAa,GAAG,OAAO,UAAU,GAAG,CAAC;QAE3C,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,cAAc,EAAE,CAAC;QACxD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACnD,MAAM,iBAAiB,GAAG,EAAE,CAAC;QAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QACnE,IAAI,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;QAC5D,IAAI,WAAW,EAAE;YACf,WAAW,GAAG,WAAW,CAAC;SAC3B;QACD,MAAM,WAAW,GAAG,OAAO,WAAW,GAAG,CAAC;QAC1C,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC3E,MAAM,OAAO,GAAG,GAAG,SAAS,IAAI,QAAQ,IAAI,aAAa,IAAI,WAAW,EAAE,CAAC;QAE3E,MAAM,GAAG,GAAG,GAAG,OAAO,SAAS,SAAS,6BAA6B,OAAO,EAAE,CAAC;QAC/E,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,GAAG,GAAG,CAAC,CAAC;QAExC,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE;YACpC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI;SACxD,CAAC,CAAC;QAEH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,MAAM,UAAU,GAAG,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACzD,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE;gBAC9B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;gBAChC,MAAM,CAAC,CAAC,CAAC,CAAC;YACZ,CAAC,CAAC,CAAC;YACH,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE;gBAC7B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;oBACtB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC;oBACrD,MAAM,CAAC,MAAM,CAAC,CAAC;iBAChB;qBAAM;oBACL,OAAO,CAAC,MAAM,CAAC,CAAC;iBACjB;YACH,CAAC,CAAC,CAAC;YACH,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE;gBACrC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;gBAChC,MAAM,IAAI,CAAC,CAAC;YACd,CAAC,CAAC,CAAC;YACH,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE;gBACrC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;gBACjC,MAAM,IAAI,CAAC,CAAC;YACd,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QACH,OAAO,UAAU,CAAC;IACpB,CAAC;IAEO,aAAa,CAAC,IAAY,EAAE,YAAoB;QACtD,MAAM,UAAU,GAAG,EAAE,CAAC;QACtB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,EAAE;YACT,OAAO,UAAU,CAAC;SACnB;QAED,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE;YACZ,OAAO,UAAU,CAAC;SACnB;QACD,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE;YACvB,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE;gBAC5B,+DAA+D;gBAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;gBAEnD,MAAM,CAAC,GAAG;oBACR,KAAK,EAAE,CAAC,CAAC,WAAW,GAAG,WAAW,GAAG,CAAC,CAAC,SAAS;oBAChD,OAAO,EAAE,CAAC,CAAC,eAAe;oBAC1B,QAAQ,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI;oBACzB,KAAK,EAAE,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;oBAE1C,UAAU,EAAE,CAAC,QAAQ,CAAC;iBACvB,CAAC;gBACF,IAAI,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;oBAC1C,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;iBACpB;aACF;SACF;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;CACF;AAxGD,0BAwGC"}

package/lib/shared/pmd/jreSetupManager.d.ts

@@ -0,0 +1,17 @@
+import { AsyncCreatable } from '@salesforce/kit';
+export declare class JreSetupManagerDependencies {
+    autoDetectJavaHome(): Promise<string>;
+}
+export declare class JreSetupManager extends AsyncCreatable {
+    private logger;
+    private dependencies;
+    private initialized;
+    protected init(): Promise<void>;
+    verifyJreSetup(): Promise<string>;
+    private findJavaHome;
+    private findJavaHomeFromSysVariables;
+    private autoDetectJavaHome;
+    private verifyJavaVersion;
+    private fetchJavaVersion;
+}
+export declare function verifyJreSetup(): Promise<string>;

package/lib/shared/pmd/jreSetupManager.js

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.verifyJreSetup = exports.JreSetupManager = exports.JreSetupManagerDependencies = void 0;
+/**
+ * Copyright (c) NCR Terafina
+ **/
+const core_1 = require("@salesforce/core");
+const kit_1 = require("@salesforce/kit");
+const fs = require("fs");
+const process = require("process");
+const findJavaHome = require("find-java-home");
+const childProcess = require("child_process");
+const path = require("path");
+// Initialize Messages with the current plugin directory
+core_1.Messages.importMessagesDirectory(__dirname);
+const JAVA_HOME_SYSTEM_VARIABLES = ['JAVA_HOME', 'JRE_HOME', 'JDK_HOME'];
+// Exported only to be used by tests
+class JreSetupManagerDependencies {
+    autoDetectJavaHome() {
+        return new Promise(resolve => {
+            findJavaHome({ allowJre: true }, (err, home) => {
+                resolve(err ? null : home);
+            });
+        });
+    }
+}
+exports.JreSetupManagerDependencies = JreSetupManagerDependencies;
+class JreSetupManager extends kit_1.AsyncCreatable {
+    async init() {
+        if (this.initialized) {
+            return;
+        }
+        this.logger = await core_1.Logger.child('verifyJRE');
+        this.dependencies = new JreSetupManagerDependencies();
+        this.initialized = true;
+    }
+    async verifyJreSetup() {
+        // Find Java Home
+        const javaHome = await this.findJavaHome();
+        // If we have javaHome, verify that it is a valid path
+        fs.statSync(javaHome);
+        // If path exists, verify Java version
+        await this.verifyJavaVersion(javaHome);
+        return javaHome;
+    }
+    async findJavaHome() {
+        let javaHome;
+        // First try getting javaHome from config
+        // If config doesn't have javaHome, try getting from System Variables
+        javaHome = this.findJavaHomeFromSysVariables();
+        // If System Variables don't have javaHome, try to detect automatically from javac
+        if (!javaHome) {
+            javaHome = await this.autoDetectJavaHome();
+        }
+        // If we reach this point and we somehow still haven't found a javaHome, then we're pretty thoroughly hosed.
+        // So we'll just throw an error telling the user to set it themselves.
+        if (!javaHome) {
+            throw core_1.SfdxError.create('@terafina/tffa-sfdx-plugin', 'jreSetupManager', 'NoJavaHomeFound', []);
+        }
+        return javaHome;
+    }
+    findJavaHomeFromSysVariables() {
+        let javaHome = null;
+        const env = process.env;
+        for (const sysVariable of JAVA_HOME_SYSTEM_VARIABLES) {
+            javaHome = env[sysVariable];
+            if (javaHome) {
+                this.logger.trace(`Found javaHome from ${sysVariable} as ${javaHome}`);
+                return javaHome;
+            }
+        }
+        return javaHome;
+    }
+    autoDetectJavaHome() {
+        return this.dependencies.autoDetectJavaHome();
+    }
+    async verifyJavaVersion(javaHome) {
+        const versionOut = await this.fetchJavaVersion(javaHome);
+        // Version output looks like this:
+        // MacOS: "openjdk version "11.0.6" 2020-01-14 LTS\nOpenJDK Runtime Environment Zulu11.37+17-CA (build 11.0.6+10-LTS)\nOpenJDK 64-Bit Server VM Zulu11.37+17-CA (build 11.0.6+10-LTS, mixed mode)\n"
+        // Win10: "openjdk 14 2020-03-17\r\nOpenJDK Runtime Environment (build 14+36-1461)\r\nOpenJDK 64-Bit Server VM (build 14+36-1461, mixed mode, sharing)\r\n"
+        // We want to get the "11.0" or "14" part
+        // The version number could be of the format 11.0 or 1.8 or 14
+        const regex = /(\d+)(\.(\d+))?/;
+        const matchedParts = regex.exec(versionOut);
+        this.logger.trace(`Version output match for pattern ${regex} is ${matchedParts}`);
+        // matchedParts should have four groups: "11.0", "11", ".0", "0" or "14", "14", undefined, undefined
+        if (!matchedParts || matchedParts.length < 4) {
+            throw core_1.SfdxError.create('@salesforce/sfdx-scanner', 'jreSetupManager', 'VersionNotFound', []);
+        }
+        const majorVersion = parseInt(matchedParts[1]);
+        const minorVersion = matchedParts[3] ? parseInt(matchedParts[3]) : '';
+        let version = '';
+        // We want to allow 1.8 and greater.
+        // Upto JDK8, the version scheme is 1.blah
+        // Starting JDK 9, the version scheme is 9.blah for 9, 10.blah for 10, etc.
+        // If either version part clicks, we should be good.
+        if (majorVersion >= 9) {
+            // Accept if Major version is greater than or equal to 9
+            version += majorVersion + (minorVersion ? `.${minorVersion}` : '');
+        }
+        else if (majorVersion === 1 && minorVersion === 8) {
+            // Accommodating 1.8
+            version += majorVersion + '.' + minorVersion;
+        }
+        else {
+            // Not matching what we are looking for
+            throw core_1.SfdxError.create('@salesforce/sfdx-scanner', 'jreSetupManager', 'InvalidVersion', [version]);
+        }
+        this.logger.trace(`Java version found as ${version}`);
+        return;
+    }
+    async fetchJavaVersion(javaHome) {
+        const javaWithFullPath = path.join(javaHome, 'bin', 'java');
+        // Run java -version and examine stderr for version
+        return new Promise((resolve, reject) => {
+            childProcess.execFile(javaWithFullPath, ['-version'], {}, (error, _stdout, stderr) => {
+                if (error) {
+                    return reject(`Could not fetch Java version from path ${javaHome}. Reason: ${error.message}`);
+                }
+                // TODO: Mac always returns this value in stderr. Check if the behavior is the same for other OS types
+                this.logger.trace(`Java version received as ${stderr}`);
+                return resolve(stderr);
+            });
+        });
+    }
+}
+exports.JreSetupManager = JreSetupManager;
+// Method that'll be invoked externally
+async function verifyJreSetup() {
+    const manager = await JreSetupManager.create({});
+    return await manager.verifyJreSetup();
+}
+exports.verifyJreSetup = verifyJreSetup;
+//# sourceMappingURL=jreSetupManager.js.map

package/lib/shared/pmd/jreSetupManager.js.map

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

package/oclif.manifest.json

@@ -1 +1 @@
-{"version":"2.1.2","commands":{"tffa:apexdoc":{"id":"tffa:apexdoc","description":"Generate Apex API Documentation","strict":true,"usage":"<%= command.id %> [-d <directory>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]","pluginName":"@terafina/tffa-sfdx-plugin","pluginAlias":"@terafina/tffa-sfdx-plugin","pluginType":"core","aliases":[],"examples":["Generate Apex API Documentation :\t$sfdx tffa:apexdoc "],"flags":{"json":{"name":"json","type":"boolean","description":"format output as json","allowNo":false},"loglevel":{"name":"loglevel","type":"option","description":"logging level for this command invocation","required":false,"helpValue":"(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)","multiple":false,"options":["trace","debug","info","warn","error","fatal","TRACE","DEBUG","INFO","WARN","ERROR","FATAL"],"default":"warn"},"sourcefolder":{"name":"sourcefolder","type":"option","char":"d","description":"directory containing package metadata","multiple":false,"default":"."}},"args":[],"flagsConfig":{"sourcefolder":{"kind":"directory","char":"d","description":"directory containing package metadata","default":".","input":[],"multiple":false,"type":"option"}}},"tffa:lint":{"id":"tffa:lint","description":"scan a sfdx project and provide a violations report based on defined standards","strict":true,"usage":"<%= command.id %> [-s <directory>] [-m <integer>] [-j] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]","pluginName":"@terafina/tffa-sfdx-plugin","pluginAlias":"@terafina/tffa-sfdx-plugin","pluginType":"core","aliases":[],"examples":["Scan a sfdx project and provide list of code violations :\t$sfdx tffa:scan"],"flags":{"json":{"name":"json","type":"boolean","char":"j","description":"generate json output","allowNo":false},"loglevel":{"name":"loglevel","type":"option","description":"logging level for this command invocation","required":false,"helpValue":"(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)","multiple":false,"options":["trace","debug","info","warn","error","fatal","TRACE","DEBUG","INFO","WARN","ERROR","FATAL"],"default":"warn"},"sourcefolder":{"name":"sourcefolder","type":"option","char":"s","description":"directory containing sfdx project","multiple":false,"default":"."},"minapi":{"name":"minapi","type":"option","char":"m","description":"minimum api version to use during quality checks","multiple":false,"default":53}},"args":[],"flagsConfig":{"sourcefolder":{"kind":"directory","char":"s","description":"directory containing sfdx project","default":".","input":[],"multiple":false,"type":"option"},"minapi":{"kind":"integer","char":"m","description":"minimum api version to use during quality checks","default":53,"input":[],"multiple":false,"type":"option"},"json":{"kind":"boolean","char":"j","description":"generate json output","allowNo":false,"type":"boolean"}}},"tffa:meta":{"id":"tffa:meta","description":"scan a sfdx project for metadata","strict":true,"usage":"<%= command.id %> [-s <directory>] [-d <directory>] [-c <directory>] [-o json|csv|human] [-f] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]","pluginName":"@terafina/tffa-sfdx-plugin","pluginAlias":"@terafina/tffa-sfdx-plugin","pluginType":"core","aliases":[],"examples":["scan a sfdx project for metadata :\t$sfdx tffa:meta"],"flags":{"json":{"name":"json","type":"boolean","description":"format output as json","allowNo":false},"loglevel":{"name":"loglevel","type":"option","description":"logging level for this command invocation","required":false,"helpValue":"(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)","multiple":false,"options":["trace","debug","info","warn","error","fatal","TRACE","DEBUG","INFO","WARN","ERROR","FATAL"],"default":"warn"},"sourcefolder":{"name":"sourcefolder","type":"option","char":"s","description":"directory containing sfdx project","multiple":false,"default":"."},"destpath":{"name":"destpath","type":"option","char":"d","description":"full path output file","multiple":false,"default":"."},"clientname":{"name":"clientname","type":"option","char":"c","description":"name of the client","multiple":false,"default":"."},"output":{"name":"output","type":"option","char":"o","description":"output format json csv human","helpValue":"(json|csv|human)","multiple":false,"options":["json","csv","human"]},"fields":{"name":"fields","type":"boolean","char":"f","description":"generate field output","allowNo":false}},"args":[],"flagsConfig":{"sourcefolder":{"kind":"directory","char":"s","description":"directory containing sfdx project","default":".","input":[],"multiple":false,"type":"option"},"destpath":{"kind":"directory","char":"d","description":"full path output file","default":".","input":[],"multiple":false,"type":"option"},"clientname":{"kind":"directory","char":"c","description":"name of the client","default":".","input":[],"multiple":false,"type":"option"},"output":{"kind":"enum","helpValue":"(json|csv|human)","char":"o","options":["json","csv","human"],"description":"output format json csv human","input":[],"multiple":false,"type":"option"},"fields":{"kind":"boolean","char":"f","description":"generate field output","allowNo":false,"type":"boolean"}}},"tffa:ping":{"id":"tffa:ping","description":"ping","strict":true,"usage":"<%= command.id %> [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]","pluginName":"@terafina/tffa-sfdx-plugin","pluginAlias":"@terafina/tffa-sfdx-plugin","pluginType":"core","aliases":[],"examples":["$ sfdx tffa:ping "],"flags":{"json":{"name":"json","type":"boolean","description":"format output as json","allowNo":false},"loglevel":{"name":"loglevel","type":"option","description":"logging level for this command invocation","required":false,"helpValue":"(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)","multiple":false,"options":["trace","debug","info","warn","error","fatal","TRACE","DEBUG","INFO","WARN","ERROR","FATAL"],"default":"warn"}},"args":[{"name":"file"}],"flagsConfig":{}}}}
+{"version":"2.2.3-rc.1","commands":{"tffa:apexdoc":{"id":"tffa:apexdoc","description":"Generate Apex API Documentation","strict":true,"usage":"<%= command.id %> [-d <directory>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]","pluginName":"@terafina/tffa-sfdx-plugin","pluginAlias":"@terafina/tffa-sfdx-plugin","pluginType":"core","aliases":[],"examples":["Generate Apex API Documentation :\t$sfdx tffa:apexdoc "],"flags":{"json":{"name":"json","type":"boolean","description":"format output as json","allowNo":false},"loglevel":{"name":"loglevel","type":"option","description":"logging level for this command invocation","required":false,"helpValue":"(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)","multiple":false,"options":["trace","debug","info","warn","error","fatal","TRACE","DEBUG","INFO","WARN","ERROR","FATAL"],"default":"warn"},"sourcefolder":{"name":"sourcefolder","type":"option","char":"d","description":"directory containing package metadata","multiple":false,"default":"."}},"args":[],"flagsConfig":{"sourcefolder":{"kind":"directory","char":"d","description":"directory containing package metadata","default":".","input":[],"multiple":false,"type":"option"}}},"tffa:lint":{"id":"tffa:lint","description":"scan a sfdx project and provide a violations report based on defined standards","strict":true,"usage":"<%= command.id %> [-s <directory>] [-m <integer>] [-p] [-r <filepath>] [-j] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]","pluginName":"@terafina/tffa-sfdx-plugin","pluginAlias":"@terafina/tffa-sfdx-plugin","pluginType":"core","aliases":[],"examples":["Scan a sfdx project and provide list of code violations :\t$sfdx tffa:scan"],"flags":{"json":{"name":"json","type":"boolean","char":"j","description":"generate json output","allowNo":false},"loglevel":{"name":"loglevel","type":"option","description":"logging level for this command invocation","required":false,"helpValue":"(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)","multiple":false,"options":["trace","debug","info","warn","error","fatal","TRACE","DEBUG","INFO","WARN","ERROR","FATAL"],"default":"warn"},"sourcefolder":{"name":"sourcefolder","type":"option","char":"s","description":"directory containing sfdx project","multiple":false,"default":"."},"minapi":{"name":"minapi","type":"option","char":"m","description":"minimum api version to use during quality checks","multiple":false,"default":53},"pmd":{"name":"pmd","type":"boolean","char":"p","description":"generate pmd output","allowNo":false},"rulesetpath":{"name":"rulesetpath","type":"option","char":"r","description":"path to pmd ruleset","multiple":false}},"args":[],"flagsConfig":{"sourcefolder":{"kind":"directory","char":"s","description":"directory containing sfdx project","default":".","input":[],"multiple":false,"type":"option"},"minapi":{"kind":"integer","char":"m","description":"minimum api version to use during quality checks","default":53,"input":[],"multiple":false,"type":"option"},"json":{"kind":"boolean","char":"j","description":"generate json output","allowNo":false,"type":"boolean"},"pmd":{"kind":"boolean","char":"p","description":"generate pmd output","allowNo":false,"type":"boolean"},"rulesetpath":{"kind":"filepath","char":"r","description":"path to pmd ruleset","input":[],"multiple":false,"type":"option"}}},"tffa:meta":{"id":"tffa:meta","description":"scan a sfdx project for metadata","strict":true,"usage":"<%= command.id %> [-s <directory>] [-d <directory>] [-c <directory>] [-o json|csv|human] [-f] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]","pluginName":"@terafina/tffa-sfdx-plugin","pluginAlias":"@terafina/tffa-sfdx-plugin","pluginType":"core","aliases":[],"examples":["scan a sfdx project for metadata :\t$sfdx tffa:meta"],"flags":{"json":{"name":"json","type":"boolean","description":"format output as json","allowNo":false},"loglevel":{"name":"loglevel","type":"option","description":"logging level for this command invocation","required":false,"helpValue":"(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)","multiple":false,"options":["trace","debug","info","warn","error","fatal","TRACE","DEBUG","INFO","WARN","ERROR","FATAL"],"default":"warn"},"sourcefolder":{"name":"sourcefolder","type":"option","char":"s","description":"directory containing sfdx project","multiple":false,"default":"."},"destpath":{"name":"destpath","type":"option","char":"d","description":"full path output file","multiple":false,"default":"."},"clientname":{"name":"clientname","type":"option","char":"c","description":"name of the client","multiple":false,"default":"."},"output":{"name":"output","type":"option","char":"o","description":"output format json csv human","helpValue":"(json|csv|human)","multiple":false,"options":["json","csv","human"]},"fields":{"name":"fields","type":"boolean","char":"f","description":"generate field output","allowNo":false}},"args":[],"flagsConfig":{"sourcefolder":{"kind":"directory","char":"s","description":"directory containing sfdx project","default":".","input":[],"multiple":false,"type":"option"},"destpath":{"kind":"directory","char":"d","description":"full path output file","default":".","input":[],"multiple":false,"type":"option"},"clientname":{"kind":"directory","char":"c","description":"name of the client","default":".","input":[],"multiple":false,"type":"option"},"output":{"kind":"enum","helpValue":"(json|csv|human)","char":"o","options":["json","csv","human"],"description":"output format json csv human","input":[],"multiple":false,"type":"option"},"fields":{"kind":"boolean","char":"f","description":"generate field output","allowNo":false,"type":"boolean"}}},"tffa:ping":{"id":"tffa:ping","description":"ping","strict":true,"usage":"<%= command.id %> [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]","pluginName":"@terafina/tffa-sfdx-plugin","pluginAlias":"@terafina/tffa-sfdx-plugin","pluginType":"core","aliases":[],"examples":["$ sfdx tffa:ping "],"flags":{"json":{"name":"json","type":"boolean","description":"format output as json","allowNo":false},"loglevel":{"name":"loglevel","type":"option","description":"logging level for this command invocation","required":false,"helpValue":"(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)","multiple":false,"options":["trace","debug","info","warn","error","fatal","TRACE","DEBUG","INFO","WARN","ERROR","FATAL"],"default":"warn"}},"args":[{"name":"file"}],"flagsConfig":{}}}}

package/package.json

@@ -1,19 +1,20 @@
 {
   "name": "@terafina/tffa-sfdx-plugin",
   "description": "sfdx plugin from Terafina containing tools for scanning and extending digital applications for the financial services industry.",
-  "version": "2.1.2",
+  "version": "2.2.3-rc.1",
   "author": "Terafina Inc",
   "bugs": "https://github.com/terafinainc/tffa-sfdx-plugin/issues",
   "dependencies": {
-    "@oclif/core": "1.9.0",
+    "@oclif/core": "1.9.5",
     "@oclif/plugin-help": "5.1.12",
     "@oclif/plugin-plugins": "2.1.0",
-    "@oclif/plugin-version": "1.0.4",
+    "@oclif/plugin-version": "1.1.1",
     "@oclif/plugin-warn-if-update-available": "^2.0.4",
-    "@salesforce/command": "5.1.3",
+    "@salesforce/command": "5.2.1",
     "@salesforce/core": "2.37.1",
-    "cheerio": "1.0.0-rc.11",
-    "csv-stringify": "6.1.0",
+    "find-java-home": "1.1.0",
+    "cheerio": "1.0.0-rc.12",
+    "csv-stringify": "6.1.3",
     "fs-extra": "10.1.0",
     "lodash.escape": "4.0.1",
     "pretty": "2.0.0",
@@ -22,8 +23,8 @@
     "xml2js": "0.4.23"
   },
   "devDependencies": {
-    "@commitlint/cli": "17.0.1",
-    "@commitlint/config-angular": "17.0.0",
+    "@commitlint/cli": "17.0.3",
+    "@commitlint/config-angular": "17.0.3",
     "@oclif/test": "2.1.0",
     "@salesforce/dev-config": "3.0.1",
     "@salesforce/ts-sinon": "1.3.21",
@@ -32,18 +33,18 @@
     "@types/fs-extra": "9.0.13",
     "@types/js-yaml": "4.0.5",
     "@types/mocha": "9.1.1",
-    "@types/node": "17.0.35",
+    "@types/node": "18.0.0",
     "@types/xml2js": "0.4.11",
-    "@typescript-eslint/eslint-plugin": "5.26.0",
-    "@typescript-eslint/parser": "5.26.0",
+    "@typescript-eslint/eslint-plugin": "5.30.0",
+    "@typescript-eslint/parser": "5.30.0",
     "chai": "4",
-    "eslint": "8.16.0",
+    "eslint": "8.18.0",
     "eslint-config-prettier": "8.5.0",
     "eslint-plugin-deprecation": "1.3.2",
     "eslint-plugin-header": "3.1.1",
     "eslint-plugin-import": "2.26.0",
-    "eslint-plugin-jest": "26.2.2",
-    "eslint-plugin-jsdoc": "39.3.2",
+    "eslint-plugin-jest": "26.5.3",
+    "eslint-plugin-jsdoc": "39.3.3",
     "eslint-plugin-prefer-arrow": "1.2.3",
     "eslint-plugin-sonarjs": "0.13.0",
     "globby": "11.0.1",
@@ -54,14 +55,14 @@
     "mocha": "10.0.0",
     "nyc": "15.1.0",
     "oclif": "^3",
-    "prettier": "2.6.2",
+    "prettier": "2.7.1",
     "prettier-plugin-apex": "1.10.0",
     "properties-parser": "0.3.1",
     "properties-reader": "2.2.0",
-    "replace-in-file": "6.3.3",
+    "replace-in-file": "6.3.5",
     "standard-version": "9.5.0",
     "ts-node": "10",
-    "typescript": "4.7.2",
+    "typescript": "4.7.4",
     "yargs": "17.5.1"
   },
   "engines": {
@@ -70,6 +71,7 @@
   "files": [
     "/lib",
     "/assets",
+    "/bin",
     "/messages",
     "/npm-shrinkwrap.json",
     "/oclif.manifest.json"