abapgit-agent 1.15.3 → 1.16.1

package/src/commands/help.js

@@ -48,6 +48,24 @@ Commands:
   unit --files <file1>,<file2>,...
     Run AUnit tests for ABAP test class files (.testclasses.abap)
 
+  run --program <NAME> | --class <NAME>
+    Execute an ABAP program or class (IF_OO_ADT_CLASSRUN) and display its output.
+
+  drop --files <file> [--pull] [--transport <TRANSPORT>] [--conflict-mode <mode>]
+    Physically delete a single ABAP object from the ABAP system.
+    Use --pull to immediately re-activate from git after deletion.
+
+  lint [--files <file1,...>] [--base <branch>] [--config <file>]
+    Run abaplint static analysis on changed ABAP files. Requires .abaplint.json.
+
+  debug <subcommand> [options]
+    Manage ABAP debugger breakpoints and attach debug sessions.
+    Subcommands: set, list, delete, attach, step, vars, stack
+
+  transport <subcommand> [options]
+    List and manage SAP transport requests.
+    Subcommands: list, create, release
+
   tree --package <package> [--depth <n>] [--include-types] [--json]
     Display package hierarchy tree from ABAP system
 
@@ -57,6 +75,9 @@ Commands:
   view --objects <obj1>,<obj2>,... [--type <type>] [--json]
     View ABAP object definitions from the ABAP system
 
+  preview --objects <obj1>,... [--type <type>] [--limit <n>] [--where <cond>] [--json]
+    Preview data from ABAP tables or CDS views
+
   where --objects <obj1>,<obj2>,... [--type <type>] [--limit <n>] [--json]
     Find where-used list for ABAP objects (classes, interfaces, programs)
 
@@ -93,6 +114,9 @@ Commands:
     - Use --dry-run to preview changes without applying them
     - Use --yes to skip confirmation prompt
 
+  upgrade [--abap-only] [--cli-only] [--version <v>]
+    Upgrade CLI and/or ABAP backend to latest or specific version.
+
   health
     Check if ABAP REST API is healthy
 
@@ -114,9 +138,14 @@ Examples:
   abapgit-agent syntax --files src/zcl_my_class.clas.abap        # Check without pull
   abapgit-agent syntax --files src/zmy_prog.prog.abap --cloud    # ABAP Cloud check
   abapgit-agent unit --files src/zcl_my_test.clas.testclasses.abap  # Run unit tests
-  abapgit-agent tree --package $MY_PACKAGE                   # Display package tree
+  abapgit-agent run --program ZMY_REPORT                         # Execute report
+  abapgit-agent run --class ZCL_MY_RUNNER                        # Execute class
+  abapgit-agent drop --files src/zcl_foo.clas.abap --pull        # Drop and re-activate
+  abapgit-agent lint                                             # abaplint on changed files
+  abapgit-agent tree --package $MY_PACKAGE                       # Display package tree
   abapgit-agent list --package $MY_PACKAGE --type CLAS,INTF  # List classes & interfaces
   abapgit-agent view --objects ZCL_MY_CLASS                  # View class definition
+  abapgit-agent preview --objects SFLIGHT                    # Preview table data
   abapgit-agent where --objects ZCL_MY_CLASS                 # Find where class is used
   abapgit-agent dump --date TODAY                            # Recent short dumps
   abapgit-agent dump --user DEVELOPER --detail 1             # Full detail of first result
@@ -127,6 +156,8 @@ Examples:
   abapgit-agent health                                       # Health check
   abapgit-agent status                                       # Configuration status
 
+Run "abapgit-agent <command> --help" for detailed usage of any command.
+
 For more info: https://github.com/SylvosCai/abapgit-agent
 `);
   }

package/src/commands/index.js

@@ -30,5 +30,6 @@ module.exports = {
   pull:      require('./pull'),
   upgrade:   require('./upgrade'),
   transport: require('./transport'),
-  lint:      require('./lint')
+  lint:      require('./lint'),
+  drop:      require('./drop')
 };

package/src/commands/inspect.js

@@ -250,6 +250,29 @@ module.exports = {
   async execute(args, context) {
     const { loadConfig, AbapHttp } = context;
 
+    if (args.includes('--help') || args.includes('-h')) {
+      console.log(`
+Usage:
+  abapgit-agent inspect --files <file1>,<file2>,... [--variant <check-variant>] [--junit-output <file>] [--json]
+
+Description:
+  Run SAP Code Inspector checks on activated ABAP objects. Requires the objects
+  to be already active in the ABAP system (run pull first).
+
+Parameters:
+  --files <file1,...>       Comma-separated ABAP source files (required).
+  --variant <variant>       Code Inspector variant (default: system default).
+  --junit-output <file>     Write results as JUnit XML to this file.
+  --json                    Output as JSON.
+
+Examples:
+  abapgit-agent inspect --files src/zcl_my_class.clas.abap
+  abapgit-agent inspect --files src/zcl_my_class.clas.abap --variant ALL_CHECKS
+  abapgit-agent inspect --files src/zcl_my_class.clas.abap --junit-output reports/inspect.xml
+`);
+      return;
+    }
+
     const jsonOutput = args.includes('--json');
     const verbose = args.includes('--verbose');
     const filesArgIndex = args.indexOf('--files');

package/src/commands/lint.js

@@ -24,6 +24,32 @@ module.exports = {
   requiresAbapConfig: false,
 
   execute(args) {
+    if (args.includes('--help') || args.includes('-h')) {
+      console.log(`
+Usage:
+  abapgit-agent lint [--files <file1,...>] [--base <branch>] [--config <file>]
+                     [--outformat <format>] [--outfile <file>]
+
+Description:
+  Run abaplint static analysis on changed ABAP files. Requires .abaplint.json in repo root.
+  By default detects files changed vs HEAD~1 (or vs --base branch).
+
+Parameters:
+  --files <file1,...>   Check specific files instead of auto-detecting changed files.
+  --base <branch>       Diff against this branch instead of HEAD~1 (e.g. main).
+  --config <file>       abaplint config file (default: .abaplint.json).
+  --outformat <format>  Output format: checkstyle (default: text).
+  --outfile <file>      Write output to file instead of stdout.
+
+Examples:
+  abapgit-agent lint
+  abapgit-agent lint --base main
+  abapgit-agent lint --files src/zcl_foo.clas.abap
+  abapgit-agent lint --outformat checkstyle --outfile reports/abaplint.xml
+`);
+      return;
+    }
+
     const configPath  = argValue(args, '--config')    || '.abaplint.json';
     const baseBranch  = argValue(args, '--base');
     const filesArg    = argValue(args, '--files');

package/src/commands/list.js

@@ -11,6 +11,31 @@ module.exports = {
   async execute(args, context) {
     const { loadConfig, AbapHttp } = context;
 
+    if (args.includes('--help') || args.includes('-h')) {
+      console.log(`
+Usage:
+  abapgit-agent list --package <package> [--type <types>] [--name <pattern>] [--limit <n>] [--offset <n>] [--json]
+
+Description:
+  List ABAP objects in a package with optional filtering and pagination.
+
+Parameters:
+  --package <package>   Package to list (required). Enclose $-packages in quotes.
+  --type <types>        Comma-separated object types to filter (e.g. CLAS,INTF).
+  --name <pattern>      Filter by object name pattern (e.g. ZCL_MY*).
+  --limit <n>           Maximum number of results (default: 100).
+  --offset <n>          Skip first N results (for pagination).
+  --json                Output as JSON.
+
+Examples:
+  abapgit-agent list --package ZMY_PACKAGE
+  abapgit-agent list --package ZMY_PACKAGE --type CLAS,INTF
+  abapgit-agent list --package ZMY_PACKAGE --name ZCL_MY*
+  abapgit-agent list --package ZMY_PACKAGE --limit 20 --offset 40
+`);
+      return;
+    }
+
     const packageArgIndex = args.indexOf('--package');
     if (packageArgIndex === -1) {
       console.error('Error: --package parameter required');

package/src/commands/preview.js

@@ -11,6 +11,36 @@ module.exports = {
   async execute(args, context) {
     const { loadConfig, AbapHttp, validators } = context;
 
+    if (args.includes('--help') || args.includes('-h')) {
+      console.log(`
+Usage:
+  abapgit-agent preview --objects <obj1>,... [--type <type>] [--limit <n>] [--offset <n>]
+                        [--where <condition>] [--columns <cols>] [--vertical] [--compact] [--json]
+
+Description:
+  Preview data from ABAP tables or CDS views.
+
+Parameters:
+  --objects <obj1,...>   Comma-separated table/view names (required).
+  --type <type>          Object type: TABL, DDLS (auto-detected if omitted).
+  --limit <n>            Maximum number of rows (default: 20).
+  --offset <n>           Skip first N rows (for pagination).
+  --where <condition>    WHERE clause filter (e.g. "CARRID = 'AA'").
+  --columns <cols>       Comma-separated column names to display.
+  --vertical             Display each row vertically (field: value).
+  --compact              Compact output (no borders).
+  --json                 Output as JSON.
+
+Examples:
+  abapgit-agent preview --objects SFLIGHT
+  abapgit-agent preview --objects SFLIGHT --limit 5
+  abapgit-agent preview --objects SFLIGHT --where "CARRID = 'AA'"
+  abapgit-agent preview --objects ZC_MY_VIEW --type DDLS
+  abapgit-agent preview --objects SFLIGHT --offset 10 --limit 20
+`);
+      return;
+    }
+
     const objectsArgIndex = args.indexOf('--objects');
     if (objectsArgIndex === -1 || objectsArgIndex + 1 >= args.length) {
       console.error('Error: --objects parameter required');

package/src/commands/pull.js

@@ -42,6 +42,38 @@ module.exports = {
 
   async execute(args, context) {
     const { loadConfig, AbapHttp, gitUtils, getTransport, getSafeguards, getConflictSettings, getTransportSettings } = context;
+
+    if (args.includes('--help') || args.includes('-h')) {
+      console.log(`
+Usage:
+  abapgit-agent pull [--url <git-url>] [--branch <branch>] [--files <file1,file2,...>]
+                     [--transport <TRANSPORT>] [--conflict-mode <mode>] [--sync-xml]
+
+Description:
+  Pull and activate ABAP objects from a git repository into the ABAP system.
+  Auto-detects git remote URL and branch from the current directory.
+
+Parameters:
+  --url <git-url>         Git repository URL. Auto-detected from git remote if omitted.
+  --branch <branch>       Branch to pull from. Auto-detected from current branch if omitted.
+  --files <file1,...>     Comma-separated list of files to pull (selective activation).
+  --transport <TRANSPORT> Transport request (e.g. DEVK900001).
+  --conflict-mode <mode>  Conflict handling: abort (default) or ignore.
+  --sync-xml              Rewrite XML metadata files to match ABAP serializer output.
+  --verbose               Show detailed activation output.
+
+Examples:
+  abapgit-agent pull
+  abapgit-agent pull --branch develop
+  abapgit-agent pull --files src/zcl_my_class.clas.abap
+  abapgit-agent pull --files src/zcl_foo.clas.abap,src/zif_foo.intf.abap
+  abapgit-agent pull --transport DEVK900001
+  abapgit-agent pull --conflict-mode ignore
+  abapgit-agent pull --files src/zcl_foo.clas.abap --sync-xml
+`);
+      return;
+    }
+
     const verbose = args.includes('--verbose');
     const syncXml = args.includes('--sync-xml');
 

package/src/commands/run.js

@@ -33,6 +33,27 @@ module.exports = {
   async execute(args, context) {
     const { loadConfig, getSafeguards } = context;
 
+    if (args.includes('--help') || args.includes('-h')) {
+      console.log(`
+Usage:
+  abapgit-agent run --program <NAME>
+  abapgit-agent run --class <NAME>
+
+Description:
+  Execute an ABAP program or a class implementing IF_OO_ADT_CLASSRUN and display its output.
+
+Parameters:
+  --program <NAME>  Execute an ABAP report/program.
+  --class <NAME>    Execute a class implementing IF_OO_ADT_CLASSRUN (run method).
+  --json            Output as JSON.
+
+Examples:
+  abapgit-agent run --program ZMY_REPORT
+  abapgit-agent run --class ZCL_MY_RUNNER
+`);
+      return;
+    }
+
     // Check project-level safeguards
     const safeguards = getSafeguards();
     if (safeguards.disableRun) {

package/src/commands/status.js

@@ -13,6 +13,19 @@ module.exports = {
   async execute(args, context) {
     const { gitUtils, isAbapIntegrationEnabled, AbapHttp, loadConfig } = context;
 
+    if (args.includes('--help') || args.includes('-h')) {
+      console.log(`
+Usage:
+  abapgit-agent status
+
+Description:
+  Check whether ABAP integration is configured for the current repository.
+  Shows the config location, SAP host, and whether the abapGit online repository
+  is registered in the ABAP system.
+`);
+      return;
+    }
+
     if (isAbapIntegrationEnabled()) {
       console.log('✅ ABAP Git Agent is ENABLED');
       console.log('   Config location:', pathModule.join(process.cwd(), '.abapGitAgent'));

package/src/commands/syntax.js

@@ -14,6 +14,28 @@ module.exports = {
   async execute(args, context) {
     const { loadConfig, AbapHttp } = context;
 
+    if (args.includes('--help') || args.includes('-h')) {
+      console.log(`
+Usage:
+  abapgit-agent syntax --files <file1>,<file2>,... [--cloud] [--json]
+
+Description:
+  Check syntax of local ABAP source files WITHOUT pulling or activating them.
+  Reads source from local files and checks directly in the ABAP system.
+
+Parameters:
+  --files <file1,...>  Comma-separated ABAP source files (required). Accepts CLAS, INTF, PROG.
+  --cloud              Use ABAP Cloud (BTP) stricter syntax check.
+  --json               Output as JSON.
+
+Examples:
+  abapgit-agent syntax --files src/zcl_my_class.clas.abap
+  abapgit-agent syntax --files src/zcl_foo.clas.abap,src/zif_foo.intf.abap
+  abapgit-agent syntax --files src/zmy_prog.prog.abap --cloud
+`);
+      return;
+    }
+
     const filesArgIndex = args.indexOf('--files');
     if (filesArgIndex === -1 || filesArgIndex + 1 >= args.length) {
       console.error('Error: --files parameter required');
@@ -48,6 +70,7 @@ module.exports = {
     // Build objects array from files
     // Group class files together (main + locals)
     const classFilesMap = new Map(); // className -> { main, locals_def, locals_imp }
+    const fugrGroupMap = new Map();  // groupName -> { dir, fmFiles: Map<fmName, source> }
     const objects = [];
 
     for (const file of syntaxFiles) {
@@ -83,6 +106,35 @@ module.exports = {
         objType = 'DDLS';
         objName = baseName.split('.')[0].toUpperCase();
         fileKind = 'main';
+      } else if (baseName.includes('.fugr.')) {
+        objType = 'FUGR';
+        const parts = baseName.split('.');   // e.g. ['zmy_fugr', 'fugr', 'zmy_my_function', 'abap']
+        objName = parts[0].toUpperCase();    // group name e.g. 'ZMY_FUGR'
+        const includeFile = parts[2] || ''; // e.g. 'zmy_my_function', 'lzmy_fugrtop', 'saplzmy_fugr'
+        const groupLower = parts[0].toLowerCase();
+        const isTopInclude = new RegExp(`^l${groupLower}top$`, 'i').test(includeFile);
+        const isUInclude   = new RegExp(`^l${groupLower}u\\d+$`, 'i').test(includeFile);
+        const isSapl       = includeFile.toLowerCase().startsWith('sapl');
+        const isFm = !isTopInclude && !isUInclude && !isSapl && includeFile !== '';
+
+        // Read source and store in fugrGroupMap
+        const filePath = pathModule.resolve(file);
+        if (!fs.existsSync(filePath)) {
+          console.error(`  Error: File not found: ${file}`);
+          continue;
+        }
+        const source = fs.readFileSync(filePath, 'utf8');
+        const dir = pathModule.dirname(filePath);
+
+        if (!fugrGroupMap.has(objName)) {
+          fugrGroupMap.set(objName, { dir, fmFiles: new Map() });
+        }
+        if (isFm) {
+          const fmName = includeFile.toUpperCase();
+          fugrGroupMap.get(objName).fmFiles.set(fmName, source);
+        }
+        // Skip adding to objects here — handled after auto-detection below
+        continue;
       }
 
       // Read source from file
@@ -236,12 +288,74 @@ module.exports = {
       }
     }
 
+    // Helper: read FIXPT from SAPL XML for a function group
+    function readFugrFixpt(dir, groupName) {
+      const xmlFile = pathModule.join(dir, `${groupName.toLowerCase()}.fugr.sapl${groupName.toLowerCase()}.xml`);
+      if (fs.existsSync(xmlFile)) {
+        const xmlContent = fs.readFileSync(xmlFile, 'utf8');
+        const fixptMatch = xmlContent.match(/<FIXPT>([^<]+)<\/FIXPT>/);
+        if (fixptMatch && fixptMatch[1] === 'X') return 'X';
+      }
+      return '';
+    }
+
+    // Helper: classify a FUGR include filename — returns fm name (uppercase) or null if not an FM file
+    function getFugrFmName(includeFile, groupLower) {
+      if (!includeFile) return null;
+      const isTopInclude = new RegExp(`^l${groupLower}top$`, 'i').test(includeFile);
+      const isUInclude   = new RegExp(`^l${groupLower}u\\d+$`, 'i').test(includeFile);
+      const isSapl       = includeFile.toLowerCase().startsWith('sapl');
+      if (isTopInclude || isUInclude || isSapl) return null;
+      return includeFile.toUpperCase();
+    }
+
+    // Auto-detect all FM files for each function group and build objects
+    for (const [groupName, groupData] of fugrGroupMap) {
+      const { dir } = groupData;
+      const groupLower = groupName.toLowerCase();
+      const prefix = `${groupLower}.fugr.`;
+
+      // Scan directory for all FUGR files belonging to this group
+      let allFiles;
+      try {
+        allFiles = fs.readdirSync(dir);
+      } catch (e) {
+        allFiles = [];
+      }
+      for (const f of allFiles) {
+        if (!f.toLowerCase().startsWith(prefix) || !f.toLowerCase().endsWith('.abap')) continue;
+        const parts = f.split('.');
+        const includeFile = parts[2] || '';
+        const fmName = getFugrFmName(includeFile, groupLower);
+        if (fmName && !groupData.fmFiles.has(fmName)) {
+          groupData.fmFiles.set(fmName, fs.readFileSync(pathModule.join(dir, f), 'utf8'));
+          if (!jsonOutput) console.log(`  Auto-detected: ${f}`);
+        }
+      }
+
+      if (groupData.fmFiles.size === 0) {
+        if (!jsonOutput) console.error(`  Warning: No FM source files found for FUGR ${groupName}`);
+        continue;
+      }
+
+      const fixpt = readFugrFixpt(dir, groupName);
+
+      // Add one object per FM
+      for (const [fmName, source] of groupData.fmFiles) {
+        objects.push({
+          type: 'FUGR',
+          name: groupName,
+          source: source,
+          fugr_include_name: fmName,
+          fixpt: fixpt
+        });
+      }
+    }
+
     if (objects.length === 0) {
       console.error('  No valid files to check');
       process.exit(1);
     }
-
-    // Send request
     const data = {
       objects: objects,
       uccheck: cloudMode ? '5' : 'X'
@@ -258,7 +372,8 @@ module.exports = {
       console.log(JSON.stringify(result, null, 2));
     } else {
       // Display results for each object
-      for (const res of results) {
+      for (let i = 0; i < results.length; i++) {
+        const res = results[i];
         const objSuccess = res.SUCCESS !== undefined ? res.SUCCESS : res.success;
         const objType = res.OBJECT_TYPE || res.object_type || 'UNKNOWN';
         const objName = res.OBJECT_NAME || res.object_name || 'UNKNOWN';
@@ -267,13 +382,18 @@ module.exports = {
         const warnings = res.WARNINGS || res.warnings || [];
         const objMessage = res.MESSAGE || res.message || '';
 
+        // For FUGR: show which FM was checked alongside the group name
+        const sentObj = objects[i] || {};
+        const fugrFmLabel = (objType === 'FUGR' && sentObj.fugr_include_name)
+          ? ` (${sentObj.fugr_include_name})` : '';
+
         if (objSuccess) {
-          console.log(`✅ ${objType} ${objName} - Syntax check passed`);
+          console.log(`✅ ${objType} ${objName}${fugrFmLabel} - Syntax check passed`);
           if (warnings.length > 0) {
             console.log(`   (${warnings.length} warning(s))`);
           }
         } else {
-          console.log(`❌ ${objType} ${objName} - Syntax check failed (${errorCount} error(s))`);
+          console.log(`❌ ${objType} ${objName}${fugrFmLabel} - Syntax check failed (${errorCount} error(s))`);
           console.log('');
           console.log('Errors:');
           console.log('─'.repeat(60));
@@ -287,19 +407,25 @@ module.exports = {
 
             // Display which file/include the error is in
             if (include) {
-              const includeMap = {
-                'main': { display: 'Main class', suffix: '.clas.abap' },
-                'locals_def': { display: 'Local definitions', suffix: '.clas.locals_def.abap' },
-                'locals_imp': { display: 'Local implementations', suffix: '.clas.locals_imp.abap' },
-                'testclasses': { display: 'Test classes', suffix: '.clas.testclasses.abap' }
-              };
-              const includeInfo = includeMap[include] || { display: include, suffix: '' };
-
-              // Show both display name and filename
-              if (includeInfo.suffix) {
-                console.log(`  In: ${includeInfo.display} (${objName.toLowerCase()}${includeInfo.suffix})`);
+              // For FUGR: include = lowercase FM name → display as '<group>.fugr.<fm_name>.abap'
+              if (objType === 'FUGR') {
+                const fugrFile = `${objName.toLowerCase()}.fugr.${include}.abap`;
+                console.log(`  In: Function module ${include.toUpperCase()} (${fugrFile})`);
               } else {
-                console.log(`  In: ${includeInfo.display}`);
+                const includeMap = {
+                  'main': { display: 'Main class', suffix: '.clas.abap' },
+                  'locals_def': { display: 'Local definitions', suffix: '.clas.locals_def.abap' },
+                  'locals_imp': { display: 'Local implementations', suffix: '.clas.locals_imp.abap' },
+                  'testclasses': { display: 'Test classes', suffix: '.clas.testclasses.abap' }
+                };
+                const includeInfo = includeMap[include] || { display: include, suffix: '' };
+
+                // Show both display name and filename
+                if (includeInfo.suffix) {
+                  console.log(`  In: ${includeInfo.display} (${objName.toLowerCase()}${includeInfo.suffix})`);
+                } else {
+                  console.log(`  In: ${includeInfo.display}`);
+                }
               }
             }
             if (methodName) {

package/src/commands/tree.js

@@ -148,6 +148,28 @@ module.exports = {
   async execute(args, context) {
     const { loadConfig, AbapHttp } = context;
 
+    if (args.includes('--help') || args.includes('-h')) {
+      console.log(`
+Usage:
+  abapgit-agent tree --package <package> [--depth <n>] [--include-types] [--json]
+
+Description:
+  Display the package hierarchy tree from the ABAP system.
+
+Parameters:
+  --package <package>  Root package to display (required). Enclose $-packages in quotes.
+  --depth <n>          Maximum depth to traverse (default: unlimited).
+  --include-types      Show object type counts per package.
+  --json               Output as JSON.
+
+Examples:
+  abapgit-agent tree --package ZMY_PACKAGE
+  abapgit-agent tree --package '$MY_LOCAL_PKG'
+  abapgit-agent tree --package ZMY_PACKAGE --depth 2 --include-types
+`);
+      return;
+    }
+
     const packageArgIndex = args.indexOf('--package');
     if (packageArgIndex === -1) {
       console.error('Error: --package parameter required');

package/src/commands/unit.js

@@ -232,6 +232,29 @@ module.exports = {
   async execute(args, context) {
     const { loadConfig, AbapHttp } = context;
 
+    if (args.includes('--help') || args.includes('-h')) {
+      console.log(`
+Usage:
+  abapgit-agent unit --files <file1>,<file2>,... [--coverage] [--junit-output <file>] [--json]
+
+Description:
+  Run AUnit tests for ABAP test class files (.testclasses.abap).
+  Objects must be already active in the ABAP system (run pull first).
+
+Parameters:
+  --files <file1,...>     Comma-separated .testclasses.abap files (required).
+  --coverage              Include code coverage data in output.
+  --junit-output <file>   Write results as JUnit XML to this file.
+  --json                  Output as JSON.
+
+Examples:
+  abapgit-agent unit --files src/zcl_my_test.clas.testclasses.abap
+  abapgit-agent unit --files src/zcl_my_test.clas.testclasses.abap --coverage
+  abapgit-agent unit --files src/zcl_my_test.clas.testclasses.abap --junit-output reports/unit.xml
+`);
+      return;
+    }
+
     const jsonOutput = args.includes('--json');
     const verbose = args.includes('--verbose');
     const filesArgIndex = args.indexOf('--files');

package/src/commands/upgrade.js

@@ -14,6 +14,34 @@ module.exports = {
   async execute(args, context) {
     const { versionCheck, loadConfig, isAbapIntegrationEnabled } = context;
 
+    if (args.includes('--help') || args.includes('-h')) {
+      console.log(`
+Usage:
+  abapgit-agent upgrade [--abap-only] [--cli-only] [--version <v>] [--check] [--yes]
+
+Description:
+  Upgrade the abapgit-agent CLI (npm package) and/or the ABAP backend to the latest
+  or a specific version.
+
+Parameters:
+  --abap-only        Upgrade only the ABAP backend (skip CLI npm upgrade).
+  --cli-only         Upgrade only the CLI npm package (skip ABAP backend).
+  --version <v>      Upgrade to a specific version (e.g. 1.15.0).
+  --check            Check for available upgrades without installing.
+  --transport <T>    Transport request for ABAP backend upgrade.
+  --yes, -y          Skip confirmation prompt.
+  --dry-run          Show what would be done without making changes.
+
+Examples:
+  abapgit-agent upgrade
+  abapgit-agent upgrade --check
+  abapgit-agent upgrade --cli-only
+  abapgit-agent upgrade --abap-only --transport DEVK900001
+  abapgit-agent upgrade --version 1.15.0
+`);
+      return;
+    }
+
     // Parse flags
     const flags = this.parseFlags(args);
 

package/src/commands/view.js

@@ -193,6 +193,35 @@ module.exports = {
   async execute(args, context) {
     const { loadConfig, AbapHttp } = context;
 
+    if (args.includes('--help') || args.includes('-h')) {
+      console.log(`
+Usage:
+  abapgit-agent view --objects <obj1>,<obj2>,... [--type <type>] [--full] [--lines] [--json]
+  abapgit-agent view --objects <FUGR> --type FUGR [--full] [--fm <name>] [--lines]
+
+Description:
+  View ABAP object definitions from the ABAP system.
+
+Parameters:
+  --objects <obj1,...>  Comma-separated object names (required).
+  --type <type>         Object type: CLAS, INTF, PROG, TABL, STRU, DTEL, TTYP, DOMA,
+                        DDLS, DCLS, MSAG, FUGR (auto-detected from TADIR if omitted).
+  --full                Show full source including all method implementations.
+  --lines               Show dual line numbers (G = global for debug set, [N] = include-local).
+  --fm <name>           With --full: show only the specified function module (FUGR only).
+  --json                Output as JSON.
+
+Examples:
+  abapgit-agent view --objects ZCL_MY_CLASS
+  abapgit-agent view --objects ZCL_MY_CLASS --full
+  abapgit-agent view --objects ZCL_MY_CLASS --full --lines
+  abapgit-agent view --objects ZMY_TABLE --type TABL
+  abapgit-agent view --objects SUSR --type FUGR --full --fm AUTHORITY_CHECK --lines
+  abapgit-agent view --objects ZCL_FOO,ZIF_BAR
+`);
+      return;
+    }
+
     const objectsArgIndex = args.indexOf('--objects');
     if (objectsArgIndex === -1 || objectsArgIndex + 1 >= args.length) {
       console.error('Error: --objects parameter required');