abapgit-agent 1.0.0 → 1.1.0

package/bin/abapgit-agent

@@ -3,6 +3,9 @@
  * ABAP Git Agent - CLI Tool
  *
  * Usage:
+ *   abapgit-agent init --folder <folder> --package <package>
+ *   abapgit-agent create
+ *   abapgit-agent import [--message <message>]
  *   abapgit-agent pull [--branch <branch>]
  *   abapgit-agent pull --url <git-url> [--branch <branch>]
  *   abapgit-agent health
@@ -147,7 +150,7 @@ function saveCookies(cookies, host) {
 }
 
 /**
- * Fetch CSRF token using GET /pull with X-CSRF-Token: fetch
+ * Fetch CSRF token using GET /health with X-CSRF-Token: fetch
  */
 async function fetchCsrfToken(config) {
   const https = require('https');
@@ -696,6 +699,150 @@ async function pull(gitUrl, branch = 'main', files = null, transportRequest = nu
   }
 }
 
+/**
+ * Run init command - Initialize local configuration
+ */
+async function runInit(args) {
+  const folderArgIndex = args.indexOf('--folder');
+  const packageArgIndex = args.indexOf('--package');
+
+  // Get parameters
+  const folder = folderArgIndex !== -1 && folderArgIndex + 1 < args.length
+    ? args[folderArgIndex + 1]
+    : '/src/';
+
+  const packageName = packageArgIndex !== -1 && packageArgIndex + 1 < args.length
+    ? args[packageArgIndex + 1]
+    : null;
+
+  // Validate package is required
+  if (!packageName) {
+    console.error('Error: --package is required');
+    console.error('Usage: abapgit-agent init --folder /src --package ZMY_PACKAGE');
+    process.exit(1);
+  }
+
+  console.log(`\n🚀 Initializing abapGit Agent for local repository`);
+  console.log(`   Folder: ${folder}`);
+  console.log(`   Package: ${packageName}`);
+  console.log('');
+
+  // Check if current folder is git repo root
+  const gitDir = pathModule.join(process.cwd(), '.git');
+  if (!fs.existsSync(gitDir)) {
+    console.error('Error: Current folder is not a git repository.');
+    console.error('Run this command from the root folder of your git repository.');
+    process.exit(1);
+  }
+
+  // Detect git remote URL
+  const gitUrl = getGitRemoteUrl();
+  if (!gitUrl) {
+    console.error('Error: No git remote configured.');
+    console.error('Configure a remote with: git remote add origin <url>');
+    process.exit(1);
+  }
+  console.log(`📌 Git remote: ${gitUrl}`);
+
+  // Check if .abapGitAgent already exists
+  const configPath = pathModule.join(process.cwd(), '.abapGitAgent');
+  if (fs.existsSync(configPath)) {
+    console.error('Error: .abapGitAgent already exists.');
+    console.error('To reinitialize, delete the existing file first.');
+    process.exit(1);
+  }
+
+  // Copy .abapGitAgent.example to .abapGitAgent
+  const samplePath = pathModule.join(__dirname, '..', '.abapGitAgent.example');
+  if (!fs.existsSync(samplePath)) {
+    console.error('Error: .abapGitAgent.example not found.');
+    process.exit(1);
+  }
+
+  try {
+    // Read sample and update with package/folder
+    const sampleContent = fs.readFileSync(samplePath, 'utf8');
+    const config = JSON.parse(sampleContent);
+    config.package = packageName;
+    config.folder = folder;
+
+    // Write updated config
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
+    console.log(`✅ Created .abapGitAgent`);
+  } catch (error) {
+    console.error(`Error creating .abapGitAgent: ${error.message}`);
+    process.exit(1);
+  }
+
+  // Update .gitignore
+  const gitignorePath = pathModule.join(process.cwd(), '.gitignore');
+  const ignoreEntries = ['.abapGitAgent', '.abapgit_agent_cookies.txt'];
+  let existingIgnore = '';
+
+  if (fs.existsSync(gitignorePath)) {
+    existingIgnore = fs.readFileSync(gitignorePath, 'utf8');
+  }
+
+  let updated = false;
+  let newIgnoreContent = existingIgnore;
+
+  for (const entry of ignoreEntries) {
+    if (!newIgnoreContent.includes(entry)) {
+      if (newIgnoreContent && !newIgnoreContent.endsWith('\n')) {
+        newIgnoreContent += '\n';
+      }
+      newIgnoreContent += entry + '\n';
+      updated = true;
+    }
+  }
+
+  if (updated) {
+    fs.writeFileSync(gitignorePath, newIgnoreContent);
+    console.log(`✅ Updated .gitignore`);
+  } else {
+    fs.writeFileSync(gitignorePath, newIgnoreContent);
+    console.log(`✅ .gitignore already up to date`);
+  }
+
+  // Copy CLAUDE.md
+  const claudeMdPath = pathModule.join(__dirname, '..', 'abap', 'CLAUDE.md');
+  const localClaudeMdPath = pathModule.join(process.cwd(), 'CLAUDE.md');
+  try {
+    if (fs.existsSync(claudeMdPath)) {
+      fs.copyFileSync(claudeMdPath, localClaudeMdPath);
+      console.log(`✅ Created CLAUDE.md`);
+    } else {
+      console.log(`⚠️  CLAUDE.md not found in abap/ directory`);
+    }
+  } catch (error) {
+    console.error(`Error copying CLAUDE.md: ${error.message}`);
+  }
+
+  // Create folder
+  const folderPath = pathModule.join(process.cwd(), folder);
+  try {
+    if (!fs.existsSync(folderPath)) {
+      fs.mkdirSync(folderPath, { recursive: true });
+      console.log(`✅ Created folder: ${folder}`);
+
+      // Create .gitkeep
+      const gitkeepPath = pathModule.join(folderPath, '.gitkeep');
+      fs.writeFileSync(gitkeepPath, '');
+    } else {
+      console.log(`✅ Folder already exists: ${folder}`);
+    }
+  } catch (error) {
+    console.error(`Error creating folder: ${error.message}`);
+  }
+
+  console.log(`
+📋 Next steps:
+   1. Edit .abapGitAgent with your ABAP credentials (host, user, password)
+   2. Run 'abapgit-agent create --import' to create online repository
+   3. Run 'abapgit-agent pull' to activate objects
+`);
+}
+
 /**
  * Check agent health
  */
@@ -718,8 +865,10 @@ async function main() {
   const command = args[0];
 
   // Check if ABAP integration is enabled for this repo
-  if (!isAbapIntegrationEnabled()) {
-    console.log(`
+  // (skip for init, help commands)
+  if (command && command !== 'init' && command !== 'help' && command !== '--help' && command !== '-h') {
+    if (!isAbapIntegrationEnabled()) {
+      console.log(`
 ⚠️  ABAP Git Agent not configured for this repository.
 
 To enable integration:
@@ -736,13 +885,195 @@ To enable integration:
 2. Or set environment variables:
    - ABAP_HOST, ABAP_PORT, ABAP_CLIENT, ABAP_USER, ABAP_PASSWORD
 `);
-    if (command !== 'help' && command !== '--help' && command !== '-h') {
       process.exit(1);
     }
   }
 
   try {
     switch (command) {
+      case 'init':
+        await runInit(args);
+        return;  // Don't check ABAP integration for init
+
+      case 'create': {
+        const helpIndex = args.findIndex(a => a === '--help' || a === '-h');
+
+        // Show help if requested
+        if (helpIndex !== -1) {
+          console.log(`
+Usage:
+  abapgit-agent create
+
+Description:
+  Create abapGit online repository in ABAP system.
+  Auto-detects URL from git remote and package from .abapGitAgent.
+
+Prerequisites:
+  - Run "abapgit-agent init" first
+  - Edit .abapGitAgent with credentials (host, user, password)
+
+Examples:
+  abapgit-agent create                    # Create repo in ABAP
+`);
+          return;
+        }
+
+        // Get parameters from config
+        const config = loadConfig();
+        const repoUrl = getGitRemoteUrl();
+
+        if (!repoUrl) {
+          console.error('Error: No git remote configured. Please configure a remote origin.');
+          process.exit(1);
+        }
+
+        if (!config.package) {
+          console.error('Error: Package not configured. Run "abapgit-agent init" first or set package in .abapGitAgent.');
+          process.exit(1);
+        }
+
+        const branch = getGitBranch();
+
+        // Extract repo name from git URL
+        const repoName = repoUrl.split('/').pop().replace('.git', '');
+
+        console.log(`\n🚀 Creating online repository`);
+        console.log(`   URL: ${repoUrl}`);
+        console.log(`   Package: ${config.package}`);
+        console.log(`   Folder: ${config.folder || '/src/'}`);
+        console.log(`   Name: ${repoName}`);
+        console.log(`   Branch: ${branch}`);
+
+        const csrfToken = await fetchCsrfToken(config);
+
+        const data = {
+          url: repoUrl,
+          package: config.package,
+          name: repoName,
+          branch: branch,
+          folder: config.folder || '/src/'
+        };
+
+        if (config.gitUsername) {
+          data.username = config.gitUsername;
+        }
+
+        if (config.gitPassword) {
+          data.password = config.gitPassword;
+        }
+
+        const result = await request('POST', '/sap/bc/z_abapgit_agent/create', data, { csrfToken });
+
+        console.log('\n');
+
+        // Handle uppercase keys from ABAP
+        const success = result.SUCCESS || result.success;
+        const repoKey = result.REPO_KEY || result.repo_key;
+        const createdRepoName = result.REPO_NAME || result.repo_name;
+        const message = result.MESSAGE || result.message;
+        const error = result.ERROR || result.error;
+
+        if (success === 'X' || success === true) {
+          console.log(`✅ Repository created successfully!`);
+          console.log(`   URL: ${repoUrl}`);
+          console.log(`   Package: ${config.package}`);
+          console.log(`   Name: ${createdRepoName || repoName}`);
+        } else {
+          console.log(`❌ Failed to create repository`);
+          console.log(`   Error: ${error || message || 'Unknown error'}`);
+          process.exit(1);
+        }
+        break;
+      }
+
+      case 'import': {
+        const helpIndex = args.findIndex(a => a === '--help' || a === '-h');
+
+        // Show help if requested
+        if (helpIndex !== -1) {
+          console.log(`
+Usage:
+  abapgit-agent import [--message <message>]
+
+Description:
+  Import existing objects from package to git repository.
+  Uses the git remote URL to find the abapGit online repository.
+
+Prerequisites:
+  - Run "abapgit-agent create" first or create repository in abapGit UI
+  - Package must have objects to import
+
+Options:
+  --message    Commit message (default: "feat: initial import from ABAP package <package>")
+
+Examples:
+  abapgit-agent import
+  abapgit-agent import --message "Initial import from SAP"
+`);
+          return;
+        }
+
+        // Get parameters from config
+        const config = loadConfig();
+        const repoUrl = getGitRemoteUrl();
+
+        if (!repoUrl) {
+          console.error('Error: No git remote configured. Please configure a remote origin.');
+          process.exit(1);
+        }
+
+        const messageArgIndex = args.indexOf('--message');
+        let commitMessage = null;
+        if (messageArgIndex !== -1 && messageArgIndex + 1 < args.length) {
+          commitMessage = args[messageArgIndex + 1];
+        }
+
+        console.log(`\n📦 Importing objects to git repository`);
+        console.log(`   URL: ${repoUrl}`);
+        if (commitMessage) {
+          console.log(`   Message: ${commitMessage}`);
+        }
+
+        const csrfToken = await fetchCsrfToken(config);
+
+        const data = {
+          url: repoUrl
+        };
+
+        if (commitMessage) {
+          data.message = commitMessage;
+        }
+
+        if (config.gitUsername) {
+          data.username = config.gitUsername;
+        }
+
+        if (config.gitPassword) {
+          data.password = config.gitPassword;
+        }
+
+        const result = await request('POST', '/sap/bc/z_abapgit_agent/import', data, { csrfToken });
+
+        console.log('\n');
+
+        // Handle uppercase keys from ABAP
+        const success = result.SUCCESS || result.success;
+        const filesStaged = result.FILES_STAGED || result.files_staged;
+        const abapCommitMessage = result.COMMIT_MESSAGE || result.commit_message;
+        const error = result.ERROR || result.error;
+
+        if (success === 'X' || success === true) {
+          console.log(`✅ Objects imported successfully!`);
+          console.log(`   Files staged: ${filesStaged}`);
+          console.log(`   Commit: ${commitMessage || abapCommitMessage}`);
+        } else {
+          console.log(`❌ Import failed`);
+          console.log(`   Error: ${error || resultMessage || 'Unknown error'}`);
+          process.exit(1);
+        }
+        break;
+      }
+
       case 'pull':
         const urlArgIndex = args.indexOf('--url');
         const branchArgIndex = args.indexOf('--branch');
@@ -852,6 +1183,17 @@ Usage:
   abapgit-agent <command> [options]
 
 Commands:
+  init --folder <folder> --package <package>
+    Initialize local configuration for an existing git repository.
+
+  create
+    Create abapGit online repository in ABAP system.
+    Auto-detects URL from git remote and package from .abapGitAgent.
+
+  import [--message <message>]
+    Import existing objects from package to git repository.
+    Uses the git remote URL to find the abapGit online repository.
+
   pull [--url <git-url>] [--branch <branch>] [--files <file1,file2,...>] [--transport <request>]
     Pull and activate repository in ABAP system.
     Auto-detects git remote and branch from current directory.
@@ -864,9 +1206,6 @@ Commands:
   unit --files <file1>,<file2>,...
     Run AUnit tests for ABAP test class files (.testclasses.abap)
 
-  unit --object <type> <name>
-    Run unit tests for a specific object.
-
   health
     Check if ABAP REST API is healthy
 
@@ -874,15 +1213,16 @@ Commands:
     Check if ABAP integration is configured for this repo
 
 Examples:
-  abapgit-agent pull                                       # Auto-detect from git repo
-  abapgit-agent pull --branch develop                      # Use specific branch
-  abapgit-agent pull --files zcl_my_class.clas.abap        # Pull specific file
-  abapgit-agent pull --transport DEVK900001                # Use specific transport request
-  abapgit-agent pull --files zcl_my_class.clas.abap --transport DEVK900001
-  abapgit-agent inspect --files zcl_my_class.clas.abap      # Inspect syntax
-  abapgit-agent inspect --files zcl_my_class.clas.abap,zcl_other.clas.abap
-  abapgit-agent unit --files zcl_my_test.clas.testclasses.abap
-  abapgit-agent unit --files zcl_my_test.clas.testclasses.abap,zcl_other.clas.testclasses.abap
+  abapgit-agent init --folder /src --package ZMY_PACKAGE      # Initialize
+  abapgit-agent create                                       # Create repo
+  abapgit-agent import                                       # Import objects to git
+  abapgit-agent import --message "Initial import"            # Import with message
+  abapgit-agent pull                                         # Auto-detect from git
+  abapgit-agent pull --branch develop                        # Specific branch
+  abapgit-agent pull --files zcl_my_class.clas.abap          # Specific file
+  abapgit-agent pull --transport DEVK900001                  # With transport
+  abapgit-agent inspect --files zcl_my_class.clas.abap       # Syntax check
+  abapgit-agent unit --files zcl_my_test.clas.testclasses.abap  # Run tests
   abapgit-agent health
   abapgit-agent status
 `);

package/docs/commands.md

@@ -0,0 +1,118 @@
+# Commands Overview
+
+All available CLI commands for abapGit Agent.
+
+## Command Reference
+
+| Command | Status | Description |
+|---------|--------|-------------|
+| [init](init-command.md) | ✅ | Initialize local configuration |
+| [create](create-command.md) | ✅ | Create online repository in ABAP |
+| [import](import-command.md) | ✅ | Import objects from ABAP package to git |
+| [pull](pull-command.md) | ✅ | Pull and activate objects in ABAP |
+| [inspect](inspect-command.md) | ✅ | Syntax check ABAP source files |
+| [unit](unit-command.md) | ✅ | Run AUnit tests |
+| [health](health-command.md) | ✅ | Health check |
+| [status](status-command.md) | ✅ | Status check |
+
+---
+
+## Quick Start
+
+### New Project Setup
+
+```bash
+# 1. Initialize local configuration
+abapgit-agent init --folder /src --package ZMY_PACKAGE
+
+# 2. Edit .abapGitAgent with credentials
+vim .abapGitAgent
+
+# 3. Create online repository in ABAP
+abapgit-agent create
+
+# 4. Import objects from ABAP package to git
+abapgit-agent import
+
+# 5. Push to git
+git push origin main
+
+# 6. Activate in ABAP
+abapgit-agent pull
+```
+
+---
+
+## Daily Development
+
+```bash
+# Pull changes from git and activate in ABAP (auto-detects git remote)
+abapgit-agent pull
+
+# Pull specific files only (faster for small changes)
+abapgit-agent pull --files abap/zcl_my_class.clas.abap
+
+# Syntax check before commit
+abapgit-agent inspect --files abap/zcl_my_class.clas.abap
+
+# Run unit tests
+abapgit-agent unit --files abap/zcl_my_test.clas.testclasses.abap
+
+# Check configuration
+abapgit-agent status
+
+# Verify ABAP connection
+abapgit-agent health
+```
+
+---
+
+## Command Workflow
+
+```
+┌─────────────────────────────────────────────────┐
+│  init                                           │
+│  └── Creates .abapGitAgent, CLAUDE.md, /src/   │
+└─────────────────────────────────────────────────┘
+                        │
+                        ▼
+┌─────────────────────────────────────────────────┐
+│  create                                         │
+│  └── Creates online repo in ABAP               │
+└─────────────────────────────────────────────────┘
+                        │
+                        ▼
+┌─────────────────────────────────────────────────┐
+│  import                                         │
+│  └── Stages, commits, pushes objects to git     │
+└─────────────────────────────────────────────────┘
+                        │
+                        ▼
+┌─────────────────────────────────────────────────┐
+│  git push                                       │
+└─────────────────────────────────────────────────┘
+                        │
+                        ▼
+┌─────────────────────────────────────────────────┐
+│  pull                                          │
+│  └── Activates objects in ABAP                  │
+└─────────────────────────────────────────────────┘
+```
+
+---
+
+## Common Options
+
+### Global Parameters
+
+All commands read configuration from:
+- `.abapGitAgent` file in current directory
+- Environment variables (`ABAP_HOST`, `ABAP_USER`, etc.)
+
+### File Patterns
+
+| Pattern | Description |
+|---------|-------------|
+| `zcl_my_class.clas.abap` | ABAP class source |
+| `zif_my_intf.intf.abap` | ABAP interface source |
+| `zcl_my_test.clas.testclasses.abap` | ABAP test class |

package/docs/create-command.md

@@ -0,0 +1,129 @@
+# create Command
+
+Create a new abapGit online repository in the ABAP system.
+
+## Command
+
+```bash
+abapgit-agent create
+```
+
+## Prerequisite
+
+- `init` command has been run successfully
+- `.abapGitAgent` file exists with credentials (host, user, password, gitUsername, gitPassword)
+- Current folder is git repo root
+
+## What It Does
+
+1. **Detect git remote** - Gets URL from `git remote get-url origin`
+2. **Get package** - Reads from `.abapGitAgent`
+3. **Get folder** - Reads from `.abapGitAgent` (default: `/src/`)
+4. **Create repository** - Calls ABAP REST API to create online repository
+5. **Set starting folder** - Configures the folder path in repository settings
+
+## Parameters
+
+None. The command auto-detects all settings from:
+- Git remote URL
+- `.abapGitAgent` configuration
+
+## Output
+
+### Success
+
+```
+🚀 Creating online repository
+   URL: https://github.com/org/repo.git
+   Package: AUD_TAG
+   Folder: /abap/
+   Name: abgagt-import
+   Branch: main
+
+
+✅ Repository created successfully!
+   URL: https://github.com/org/repo.git
+   Package: AUD_TAG
+   Name: abgagt-import
+
+Next steps:
+   abapgit-agent import
+```
+
+### Error - Repository Already Exists
+
+```
+❌ Failed to create repository
+   Error: Repository already exists
+```
+
+### Error - Missing Configuration
+
+```
+❌ Failed to create repository
+   Error: Package not configured
+```
+
+## Post-Create Steps
+
+After creating the repository:
+
+```bash
+# Import objects from ABAP package to git
+abapgit-agent import
+
+# Push to git
+git push origin main
+
+# Activate in ABAP
+abapgit-agent pull
+```
+
+## Full Workflow
+
+```
+1. abapgit-agent init --folder /src/ --package ZMY_PACKAGE
+   └─> Creates .abapGitAgent, CLAUDE.md, /src/, updates .gitignore
+
+2. Edit .abapGitAgent (host, user, password, gitUsername, gitPassword)
+
+3. abapgit-agent create
+   └─> Creates online repository in ABAP
+
+4. abapgit-agent import
+   └─> Stages, commits, and pushes all objects from ZMY_PACKAGE
+
+5. git pull
+   └─> Optionally pull to local folder
+
+6. abapgit-agent pull
+   └─> Activate objects in ABAP
+```
+
+## Example
+
+```bash
+# Initialize
+abapgit-agent init --folder /src/ --package ZMYPROJECT
+
+# Edit config
+vim .abapGitAgent
+
+# Create repo in ABAP
+abapgit-agent create
+
+# Import objects to git
+abapgit-agent import
+
+# Pull to local folder
+git pull origin main
+
+# Activate in ABAP
+abapgit-agent pull
+```
+
+## Related Commands
+
+- [`init`](init-command.md) - Initialize local configuration
+- [`import`](import-command.md) - Import objects from package to git
+- [`pull`](pull-command.md) - Pull and activate objects in ABAP