rflib-plugin 0.18.0 → 0.19.3

package/oclif.manifest.json

@@ -1,11 +1,13 @@
 {
   "commands": {
-    "rflib:logging:aura:instrument": {
+    "rflib:debug:applicationevents:get": {
       "aliases": [],
       "args": {},
-      "description": "Analyzes Aura Component files and adds RFLIB logging statements for:\n- Method entry logging with parameter values in Controller, Helper, and Renderer files\n- Error logging in try-catch blocks\n- Error logging in Promise catch handlers\n- Adds rflibLoggerCmp component if not present\n- Replaces console.log and similar method invocations\n- Formats modified files using Prettier (optional)\n\nThe command processes:\n- Component (.cmp) files to add the logger component\n- Controller (.js) files for method instrumentation\n- Helper (.js) files for method instrumentation\n- Renderer (.js) files for method instrumentation",
+      "description": "Retrieves rflib_Application_Event__c records from the target org via the Salesforce REST API.\nApplication Events are business-level events used to track feature adoption, user actions, and domain-specific milestones.\nResults are ordered by Occurred_On__c descending (most recent first).\n\nRequires the RFLIB base package to be installed in the target org and the running user to be assigned the rflib_Ops_Center_Access permission set (or have equivalent read access to rflib_Application_Event__c).\nFor installation instructions, visit: https://github.com/j-fischer/rflib",
       "examples": [
-        "- Add logging to all aura files:\n$ sf rflib logging aura instrument --sourcepath force-app\n\n- Preview changes:\n$ sf rflib logging aura instrument --sourcepath force-app --dryrun\n\n- Add logging and format code:\n$ sf rflib logging aura instrument --sourcepath force-app --prettier\n\n- Process specific component:\n$ sf rflib logging aura instrument --sourcepath force-app/main/default/aura/myComponent"
+        "Get all application events from the default org:\n$ sf rflib debug applicationevents get --target-org myOrg",
+        "Get events filtered by name and date range:\n$ sf rflib debug applicationevents get --target-org myOrg --event-name \"order-%\" --start-date 2024-01-01T00:00:00Z",
+        "Get events related to a specific record with a custom limit:\n$ sf rflib debug applicationevents get --target-org myOrg --related-record-id 0017000000XXXXXX --record-limit 50"
       ],
       "flags": {
         "json": {
@@ -23,118 +25,526 @@
           "multiple": false,
           "type": "option"
         },
-        "sourcepath": {
-          "char": "s",
-          "description": "Path to the source directory containing Aura components that should be instrumented with RFLIB logging statements. The command will:\n- Scan for 'aura' directories recursively\n- Process all Aura components found\n- Add <c:rflibLoggerCmp> to component files\n- Add logging statements to JavaScript files\n- Initialize logger in methods using component.find()",
-          "name": "sourcepath",
+        "target-org": {
+          "char": "o",
+          "description": "The username or alias of the Salesforce org containing the RFLIB base package.",
+          "name": "target-org",
+          "noCacheDefault": true,
           "required": true,
-          "summary": "Directory containing Aura components to instrument with logging.",
+          "summary": "Username or alias of the target org.",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
+        },
+        "event-name": {
+          "char": "e",
+          "description": "Filter Application Events by their Event_Name__c field. Use the % character as a wildcard for partial matches, for example \"order-%\".",
+          "name": "event-name",
+          "summary": "Filter by event name. Use % as a wildcard.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "dryrun": {
+        "start-date": {
+          "char": "s",
+          "description": "Only return events where Occurred_On__c is on or after this date. Must be in ISO 8601 format, e.g. 2024-01-01T00:00:00Z.",
+          "name": "start-date",
+          "summary": "Filter events on or after this ISO 8601 date.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "end-date": {
           "char": "d",
-          "description": "When enabled, shows which files would be modified without making actual changes. Useful for reviewing the impact before applying changes. Shows:\n- Files that would be modified\n- Number of processed files\n- Number of modified files\n- Number of formatted files",
-          "name": "dryrun",
-          "summary": "Preview changes without modifying files.",
-          "allowNo": false,
-          "type": "boolean"
+          "description": "Only return events where Occurred_On__c is on or before this date. Must be in ISO 8601 format, e.g. 2024-12-31T23:59:59Z.",
+          "name": "end-date",
+          "summary": "Filter events on or before this ISO 8601 date.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "prettier": {
-          "char": "p",
-          "description": "When enabled, formats the modified JavaScript files using Prettier after adding logging statements. Maintains consistent code style with:\n- 120 character line width\n- 4 space indentation\n- Single quotes for strings\n- No tabs\n- No trailing commas",
-          "name": "prettier",
-          "summary": "Format modified files using Prettier.",
+        "related-record-id": {
+          "char": "r",
+          "description": "Only return events associated with this specific record ID.",
+          "name": "related-record-id",
+          "summary": "Filter by Related_Record_ID__c (exact match).",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "record-limit": {
+          "char": "l",
+          "description": "Controls how many Application Event records are returned. Defaults to 200. Maximum allowed value is 2000.",
+          "name": "record-limit",
+          "summary": "Maximum number of records to return (default 200, max 2000).",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hiddenAliases": [],
+      "id": "rflib:debug:applicationevents:get",
+      "pluginAlias": "rflib-plugin",
+      "pluginName": "rflib-plugin",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Query RFLIB Application Events from a Salesforce org.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "rflib",
+        "debug",
+        "applicationevents",
+        "get.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "rflib:debug:applicationevents:get",
+        "debug:rflib:applicationevents:get",
+        "debug:applicationevents:rflib:get",
+        "debug:applicationevents:get:rflib",
+        "rflib:applicationevents:debug:get",
+        "applicationevents:rflib:debug:get",
+        "applicationevents:debug:rflib:get",
+        "applicationevents:debug:get:rflib",
+        "rflib:applicationevents:get:debug",
+        "applicationevents:rflib:get:debug",
+        "applicationevents:get:rflib:debug",
+        "applicationevents:get:debug:rflib",
+        "rflib:debug:get:applicationevents",
+        "debug:rflib:get:applicationevents",
+        "debug:get:rflib:applicationevents",
+        "debug:get:applicationevents:rflib",
+        "rflib:get:debug:applicationevents",
+        "get:rflib:debug:applicationevents",
+        "get:debug:rflib:applicationevents",
+        "get:debug:applicationevents:rflib",
+        "rflib:get:applicationevents:debug",
+        "get:rflib:applicationevents:debug",
+        "get:applicationevents:rflib:debug",
+        "get:applicationevents:debug:rflib"
+      ]
+    },
+    "rflib:debug:logarchives:get": {
+      "aliases": [],
+      "args": {},
+      "description": "Retrieves rflib_Logs_Archive__b records from the target org's big object store via the Salesforce REST API.\nEach log record contains log level, context, request ID, and full log messages in the format: [timestamp]|[LEVEL]|[TRACE_ID]|[CONTEXT]|[MESSAGE].\n\nRequires the RFLIB base package to be installed in the target org and the running user to be assigned the rflib_Ops_Center_Access permission set (or have equivalent read access to rflib_Logs_Archive__b).\nFor installation instructions, visit: https://github.com/j-fischer/rflib",
+      "examples": [
+        "Get log archives from the last 24 hours:\n$ sf rflib debug logarchives get --target-org myOrg",
+        "Get log archives for a specific date range:\n$ sf rflib debug logarchives get --target-org myOrg --start-date 2024-01-01T00:00:00Z --end-date 2024-01-02T00:00:00Z"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
           "allowNo": false,
           "type": "boolean"
         },
-        "no-if": {
-          "description": "When provided, the command will not add log statements inside of `if` and `else` blocks.",
-          "name": "no-if",
-          "summary": "Exclude the instrumentation of if-else statements.",
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "target-org": {
+          "char": "o",
+          "description": "The username or alias of the Salesforce org containing the RFLIB base package.",
+          "name": "target-org",
+          "noCacheDefault": true,
+          "required": true,
+          "summary": "Username or alias of the target org.",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
+        },
+        "start-date": {
+          "char": "s",
+          "description": "Only return log archives created on or after this date. Must be in ISO 8601 format, e.g. 2024-01-01T00:00:00Z. Defaults to 24 hours ago if omitted.",
+          "name": "start-date",
+          "summary": "Start of the date range in ISO 8601 format. Defaults to 24 hours ago.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "end-date": {
+          "char": "d",
+          "description": "Only return log archives created on or before this date. Must be in ISO 8601 format, e.g. 2024-12-31T23:59:59Z. Defaults to the current time if omitted.",
+          "name": "end-date",
+          "summary": "End of the date range in ISO 8601 format. Defaults to now.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hiddenAliases": [],
+      "id": "rflib:debug:logarchives:get",
+      "pluginAlias": "rflib-plugin",
+      "pluginName": "rflib-plugin",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Query RFLIB log archives from a Salesforce org.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "rflib",
+        "debug",
+        "logarchives",
+        "get.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "rflib:debug:logarchives:get",
+        "debug:rflib:logarchives:get",
+        "debug:logarchives:rflib:get",
+        "debug:logarchives:get:rflib",
+        "rflib:logarchives:debug:get",
+        "logarchives:rflib:debug:get",
+        "logarchives:debug:rflib:get",
+        "logarchives:debug:get:rflib",
+        "rflib:logarchives:get:debug",
+        "logarchives:rflib:get:debug",
+        "logarchives:get:rflib:debug",
+        "logarchives:get:debug:rflib",
+        "rflib:debug:get:logarchives",
+        "debug:rflib:get:logarchives",
+        "debug:get:rflib:logarchives",
+        "debug:get:logarchives:rflib",
+        "rflib:get:debug:logarchives",
+        "get:rflib:debug:logarchives",
+        "get:debug:rflib:logarchives",
+        "get:debug:logarchives:rflib",
+        "rflib:get:logarchives:debug",
+        "get:rflib:logarchives:debug",
+        "get:logarchives:rflib:debug",
+        "get:logarchives:debug:rflib"
+      ]
+    },
+    "rflib:debug:loggersettings:get": {
+      "aliases": [],
+      "args": {},
+      "description": "Retrieves all rflib_Logger_Settings__c hierarchy custom setting records from the target org via the Salesforce REST API.\nReturns settings across org-wide defaults, profile overrides, and user overrides, along with embedded best-practice recommendations.\n\nUse \"sf rflib debug loggersettings update\" to apply changes.\n\nRequires the RFLIB base package to be installed in the target org and the running user to be assigned the rflib_Ops_Center_Access permission set (or have equivalent read access to rflib_Logger_Settings__c).\nFor installation instructions, visit: https://github.com/j-fischer/rflib",
+      "examples": [
+        "Read all logger settings from the target org:\n$ sf rflib debug loggersettings get --target-org myOrg"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
           "allowNo": false,
           "type": "boolean"
         },
-        "skip-instrumented": {
-          "description": "When provided, the command will not add log statements to any Aura component that contains the `` component.",
-          "name": "skip-instrumented",
-          "summary": "Skips any files where a logger is already present.",
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "target-org": {
+          "char": "o",
+          "description": "The username or alias of the Salesforce org containing the RFLIB base package.",
+          "name": "target-org",
+          "noCacheDefault": true,
+          "required": true,
+          "summary": "Username or alias of the target org.",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hiddenAliases": [],
+      "id": "rflib:debug:loggersettings:get",
+      "pluginAlias": "rflib-plugin",
+      "pluginName": "rflib-plugin",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Read all RFLIB Logger Settings from a Salesforce org.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "rflib",
+        "debug",
+        "loggersettings",
+        "get.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "rflib:debug:loggersettings:get",
+        "debug:rflib:loggersettings:get",
+        "debug:loggersettings:rflib:get",
+        "debug:loggersettings:get:rflib",
+        "rflib:loggersettings:debug:get",
+        "loggersettings:rflib:debug:get",
+        "loggersettings:debug:rflib:get",
+        "loggersettings:debug:get:rflib",
+        "rflib:loggersettings:get:debug",
+        "loggersettings:rflib:get:debug",
+        "loggersettings:get:rflib:debug",
+        "loggersettings:get:debug:rflib",
+        "rflib:debug:get:loggersettings",
+        "debug:rflib:get:loggersettings",
+        "debug:get:rflib:loggersettings",
+        "debug:get:loggersettings:rflib",
+        "rflib:get:debug:loggersettings",
+        "get:rflib:debug:loggersettings",
+        "get:debug:rflib:loggersettings",
+        "get:debug:loggersettings:rflib",
+        "rflib:get:loggersettings:debug",
+        "get:rflib:loggersettings:debug",
+        "get:loggersettings:rflib:debug",
+        "get:loggersettings:debug:rflib"
+      ]
+    },
+    "rflib:debug:loggersettings:update": {
+      "aliases": [],
+      "args": {},
+      "description": "Creates or updates a single field on an rflib_Logger_Settings__c record in the target org via the Salesforce REST API.\nValidates field values and warns about best-practice violations.\n\nTo update an existing record, provide --record-id. To create a new record, provide --setup-owner-id with an org ID (00D...), profile ID (00E...), or user ID.\n\nRequires the RFLIB base package to be installed in the target org and the running user to be assigned the rflib_Ops_Center_Access permission set (or have equivalent update access to rflib_Logger_Settings__c).\nFor installation instructions, visit: https://github.com/j-fischer/rflib",
+      "examples": [
+        "Update the Log_Event_Reporting_Level__c field on an existing record:\n$ sf rflib debug loggersettings update --target-org myOrg --record-id a0A000000001234 --field-name Log_Event_Reporting_Level__c --field-value WARN",
+        "Create a new org-wide Logger Setting:\n$ sf rflib debug loggersettings update --target-org myOrg --setup-owner-id 00D000000000001 --field-name Log_Event_Reporting_Level__c --field-value WARN"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
           "allowNo": false,
           "type": "boolean"
         },
-        "verbose": {
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "target-org": {
+          "char": "o",
+          "description": "The username or alias of the Salesforce org containing the RFLIB base package.",
+          "name": "target-org",
+          "noCacheDefault": true,
+          "required": true,
+          "summary": "Username or alias of the target org.",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
+        },
+        "field-name": {
+          "char": "f",
+          "description": "The API name of the field to create or update, e.g. Log_Event_Reporting_Level__c. For log level fields, valid values are: TRACE, DEBUG, INFO, WARN, ERROR, FATAL, NONE.",
+          "name": "field-name",
+          "required": true,
+          "summary": "API name of the rflib_Logger_Settings__c field to update.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "field-value": {
           "char": "v",
-          "description": "When provided with --dryrun, prints the paths of the files that would be modified.",
-          "name": "verbose",
-          "summary": "Enable verbose output.",
+          "description": "The new value to set on the specified field. For log level fields, valid values are: TRACE, DEBUG, INFO, WARN, ERROR, FATAL, NONE.",
+          "name": "field-value",
+          "required": true,
+          "summary": "New value for the specified field.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "record-id": {
+          "char": "r",
+          "description": "The Salesforce record ID of an existing rflib_Logger_Settings__c record to update. Omit this flag to create a new record (requires --setup-owner-id).",
+          "name": "record-id",
+          "summary": "ID of an existing rflib_Logger_Settings__c record to update.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "setup-owner-id": {
+          "char": "s",
+          "description": "Required when creating a new Logger Setting record. Accepts an org ID (00D...), profile ID (00E...), or user ID. Read existing record IDs using \"sf rflib debug loggersettings get\".",
+          "name": "setup-owner-id",
+          "summary": "Setup owner ID for creating a new Logger Setting record.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hiddenAliases": [],
+      "id": "rflib:debug:loggersettings:update",
+      "pluginAlias": "rflib-plugin",
+      "pluginName": "rflib-plugin",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Create or update an RFLIB Logger Setting in a Salesforce org.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "rflib",
+        "debug",
+        "loggersettings",
+        "update.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "rflib:debug:loggersettings:update",
+        "debug:rflib:loggersettings:update",
+        "debug:loggersettings:rflib:update",
+        "debug:loggersettings:update:rflib",
+        "rflib:loggersettings:debug:update",
+        "loggersettings:rflib:debug:update",
+        "loggersettings:debug:rflib:update",
+        "loggersettings:debug:update:rflib",
+        "rflib:loggersettings:update:debug",
+        "loggersettings:rflib:update:debug",
+        "loggersettings:update:rflib:debug",
+        "loggersettings:update:debug:rflib",
+        "rflib:debug:update:loggersettings",
+        "debug:rflib:update:loggersettings",
+        "debug:update:rflib:loggersettings",
+        "debug:update:loggersettings:rflib",
+        "rflib:update:debug:loggersettings",
+        "update:rflib:debug:loggersettings",
+        "update:debug:rflib:loggersettings",
+        "update:debug:loggersettings:rflib",
+        "rflib:update:loggersettings:debug",
+        "update:rflib:loggersettings:debug",
+        "update:loggersettings:rflib:debug",
+        "update:loggersettings:debug:rflib"
+      ]
+    },
+    "rflib:debug:userpermissions:get": {
+      "aliases": [],
+      "args": {},
+      "description": "Retrieves FLS (Field-Level Security), OLS (Object-Level Security), and Apex class/page permissions for a specific user\nvia the Salesforce REST API. Permissions are aggregated across the user's profile, permission sets, and permission set groups.\n\nUse --sobject-type to narrow FLS or OLS results to a specific SObject.\n\nRequires the RFLIB base package to be installed in the target org and the running user to be assigned the rflib_Ops_Center_Access permission set (or have equivalent read access to the relevant permission objects).\nFor installation instructions, visit: https://github.com/j-fischer/rflib",
+      "examples": [
+        "Check all permissions for a user:\n$ sf rflib debug userpermissions get --target-org myOrg --user-id 0057000000XXXXXX --permission-type ALL",
+        "Check FLS for a specific object:\n$ sf rflib debug userpermissions get --target-org myOrg --user-id 0057000000XXXXXX --permission-type FLS --sobject-type Account",
+        "Check Apex access:\n$ sf rflib debug userpermissions get --target-org myOrg --user-id 0057000000XXXXXX --permission-type APEX"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
           "allowNo": false,
           "type": "boolean"
         },
-        "exclude": {
-          "char": "e",
-          "description": "Exclude specific files or directories that match the provided glob pattern. For example, use --exclude \"**/Generated_*.cmp\" to skip auto-generated components.",
-          "name": "exclude",
-          "summary": "Exclude files or directories from instrumentation based on a glob pattern.",
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "concurrency": {
-          "char": "c",
-          "description": "Controls the maximum number of files to process at the same time. This is useful in very large codebases to prevent excessive memory usage or file descriptor exhaustion. Defaults to 10.",
-          "name": "concurrency",
-          "summary": "Limits the number of files processed concurrently.",
-          "default": 10,
+        "target-org": {
+          "char": "o",
+          "description": "The username or alias of the Salesforce org containing the RFLIB base package.",
+          "name": "target-org",
+          "noCacheDefault": true,
+          "required": true,
+          "summary": "Username or alias of the target org.",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
+        },
+        "user-id": {
+          "char": "u",
+          "description": "The Salesforce User ID (15 or 18 characters) of the user whose permissions should be retrieved.",
+          "name": "user-id",
+          "required": true,
+          "summary": "Salesforce User ID (15 or 18 character) to check permissions for.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "permission-type": {
+          "char": "t",
+          "description": "Controls which permission types are returned:\n  - FLS: Field-Level Security only\n  - OLS: Object-Level Security only\n  - APEX: Apex class and page access only\n  - ALL: All three permission types",
+          "name": "permission-type",
+          "required": true,
+          "summary": "Type of permissions to retrieve: FLS, OLS, APEX, or ALL.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "FLS",
+            "OLS",
+            "APEX",
+            "ALL"
+          ],
+          "type": "option"
+        },
+        "sobject-type": {
+          "char": "b",
+          "description": "Filters Field-Level Security or Object-Level Security results to a specific SObject type, e.g. Account, Contact, Opportunity.",
+          "name": "sobject-type",
+          "summary": "Optional SObject API name to filter FLS or OLS results.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         }
       },
-      "hasDynamicHelp": false,
+      "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "rflib:logging:aura:instrument",
+      "id": "rflib:debug:userpermissions:get",
       "pluginAlias": "rflib-plugin",
       "pluginName": "rflib-plugin",
       "pluginType": "core",
       "strict": true,
-      "summary": "Instrument Aura Components with RFLIB logging statements automatically.",
+      "summary": "Check Salesforce permissions for a user in the target org.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "rflib",
-        "logging",
-        "aura",
-        "instrument.js"
+        "debug",
+        "userpermissions",
+        "get.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "rflib:logging:aura:instrument",
-        "logging:rflib:aura:instrument",
-        "logging:aura:rflib:instrument",
-        "logging:aura:instrument:rflib",
-        "rflib:aura:logging:instrument",
-        "aura:rflib:logging:instrument",
-        "aura:logging:rflib:instrument",
-        "aura:logging:instrument:rflib",
-        "rflib:aura:instrument:logging",
-        "aura:rflib:instrument:logging",
-        "aura:instrument:rflib:logging",
-        "aura:instrument:logging:rflib",
-        "rflib:logging:instrument:aura",
-        "logging:rflib:instrument:aura",
-        "logging:instrument:rflib:aura",
-        "logging:instrument:aura:rflib",
-        "rflib:instrument:logging:aura",
-        "instrument:rflib:logging:aura",
-        "instrument:logging:rflib:aura",
-        "instrument:logging:aura:rflib",
-        "rflib:instrument:aura:logging",
-        "instrument:rflib:aura:logging",
-        "instrument:aura:rflib:logging",
-        "instrument:aura:logging:rflib"
+        "rflib:debug:userpermissions:get",
+        "debug:rflib:userpermissions:get",
+        "debug:userpermissions:rflib:get",
+        "debug:userpermissions:get:rflib",
+        "rflib:userpermissions:debug:get",
+        "userpermissions:rflib:debug:get",
+        "userpermissions:debug:rflib:get",
+        "userpermissions:debug:get:rflib",
+        "rflib:userpermissions:get:debug",
+        "userpermissions:rflib:get:debug",
+        "userpermissions:get:rflib:debug",
+        "userpermissions:get:debug:rflib",
+        "rflib:debug:get:userpermissions",
+        "debug:rflib:get:userpermissions",
+        "debug:get:rflib:userpermissions",
+        "debug:get:userpermissions:rflib",
+        "rflib:get:debug:userpermissions",
+        "get:rflib:debug:userpermissions",
+        "get:debug:rflib:userpermissions",
+        "get:debug:userpermissions:rflib",
+        "rflib:get:userpermissions:debug",
+        "get:rflib:userpermissions:debug",
+        "get:userpermissions:rflib:debug",
+        "get:userpermissions:debug:rflib"
       ]
     },
     "rflib:logging:apex:instrument": {
@@ -281,6 +691,143 @@
         "instrument:apex:logging:rflib"
       ]
     },
+    "rflib:logging:aura:instrument": {
+      "aliases": [],
+      "args": {},
+      "description": "Analyzes Aura Component files and adds RFLIB logging statements for:\n- Method entry logging with parameter values in Controller, Helper, and Renderer files\n- Error logging in try-catch blocks\n- Error logging in Promise catch handlers\n- Adds rflibLoggerCmp component if not present\n- Replaces console.log and similar method invocations\n- Formats modified files using Prettier (optional)\n\nThe command processes:\n- Component (.cmp) files to add the logger component\n- Controller (.js) files for method instrumentation\n- Helper (.js) files for method instrumentation\n- Renderer (.js) files for method instrumentation",
+      "examples": [
+        "- Add logging to all aura files:\n$ sf rflib logging aura instrument --sourcepath force-app\n\n- Preview changes:\n$ sf rflib logging aura instrument --sourcepath force-app --dryrun\n\n- Add logging and format code:\n$ sf rflib logging aura instrument --sourcepath force-app --prettier\n\n- Process specific component:\n$ sf rflib logging aura instrument --sourcepath force-app/main/default/aura/myComponent"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "sourcepath": {
+          "char": "s",
+          "description": "Path to the source directory containing Aura components that should be instrumented with RFLIB logging statements. The command will:\n- Scan for 'aura' directories recursively\n- Process all Aura components found\n- Add <c:rflibLoggerCmp> to component files\n- Add logging statements to JavaScript files\n- Initialize logger in methods using component.find()",
+          "name": "sourcepath",
+          "required": true,
+          "summary": "Directory containing Aura components to instrument with logging.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dryrun": {
+          "char": "d",
+          "description": "When enabled, shows which files would be modified without making actual changes. Useful for reviewing the impact before applying changes. Shows:\n- Files that would be modified\n- Number of processed files\n- Number of modified files\n- Number of formatted files",
+          "name": "dryrun",
+          "summary": "Preview changes without modifying files.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "prettier": {
+          "char": "p",
+          "description": "When enabled, formats the modified JavaScript files using Prettier after adding logging statements. Maintains consistent code style with:\n- 120 character line width\n- 4 space indentation\n- Single quotes for strings\n- No tabs\n- No trailing commas",
+          "name": "prettier",
+          "summary": "Format modified files using Prettier.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-if": {
+          "description": "When provided, the command will not add log statements inside of `if` and `else` blocks.",
+          "name": "no-if",
+          "summary": "Exclude the instrumentation of if-else statements.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "skip-instrumented": {
+          "description": "When provided, the command will not add log statements to any Aura component that contains the `` component.",
+          "name": "skip-instrumented",
+          "summary": "Skips any files where a logger is already present.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "When provided with --dryrun, prints the paths of the files that would be modified.",
+          "name": "verbose",
+          "summary": "Enable verbose output.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "exclude": {
+          "char": "e",
+          "description": "Exclude specific files or directories that match the provided glob pattern. For example, use --exclude \"**/Generated_*.cmp\" to skip auto-generated components.",
+          "name": "exclude",
+          "summary": "Exclude files or directories from instrumentation based on a glob pattern.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "concurrency": {
+          "char": "c",
+          "description": "Controls the maximum number of files to process at the same time. This is useful in very large codebases to prevent excessive memory usage or file descriptor exhaustion. Defaults to 10.",
+          "name": "concurrency",
+          "summary": "Limits the number of files processed concurrently.",
+          "default": 10,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "rflib:logging:aura:instrument",
+      "pluginAlias": "rflib-plugin",
+      "pluginName": "rflib-plugin",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Instrument Aura Components with RFLIB logging statements automatically.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "rflib",
+        "logging",
+        "aura",
+        "instrument.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "rflib:logging:aura:instrument",
+        "logging:rflib:aura:instrument",
+        "logging:aura:rflib:instrument",
+        "logging:aura:instrument:rflib",
+        "rflib:aura:logging:instrument",
+        "aura:rflib:logging:instrument",
+        "aura:logging:rflib:instrument",
+        "aura:logging:instrument:rflib",
+        "rflib:aura:instrument:logging",
+        "aura:rflib:instrument:logging",
+        "aura:instrument:rflib:logging",
+        "aura:instrument:logging:rflib",
+        "rflib:logging:instrument:aura",
+        "logging:rflib:instrument:aura",
+        "logging:instrument:rflib:aura",
+        "logging:instrument:aura:rflib",
+        "rflib:instrument:logging:aura",
+        "instrument:rflib:logging:aura",
+        "instrument:logging:rflib:aura",
+        "instrument:logging:aura:rflib",
+        "rflib:instrument:aura:logging",
+        "instrument:rflib:aura:logging",
+        "instrument:aura:rflib:logging",
+        "instrument:aura:logging:rflib"
+      ]
+    },
     "rflib:logging:flow:instrument": {
       "aliases": [],
       "args": {},
@@ -543,5 +1090,5 @@
       ]
     }
   },
-  "version": "0.18.0"
+  "version": "0.19.3"
 }