Enzigma COE: Salesforce Repo Setup

A comprehensive VS Code extension suite designed to streamline project setup, cloning, conventional commits, git merge request delivery, interactive custom prompting, and cross-IDE agent instructions/rules injection.

Key Features

1. COE Repository Setup & Settings (COE: Setup Workspace Repository)

• Command: coe.setupRepo
• Status Bar: $(repo-create) COE Setup
• Functionality: Configures workspace repositories, connects securely to GitLab using Personal Access Tokens (PAT), and manages configuration profiles.

2. COE Repository Clone (COE: Clone Existing Repo)

• Command: coe.cloneRepo
• Status Bar: $(cloud-download) COE Clone
• Functionality: Securely connects to your GitLab organization, checks access, fetches group hierarchies, and clones projects directly into your active workspace.

3. COE GitLab Group Sync (COE: Replicate & Sync GitLab Group)

• Command: coe.syncGitLabGroup
• Status Bar: $(repo-clone) COE Group Sync
• Functionality: Securely connects to your GitLab organization, resolves the base group/subgroup path, recursively retrieves all nested projects/repositories, constructs the local subgroup folder hierarchies, and clones or pulls repositories safely.

4. COE Sync Branch Metadata (COE: Sync Branch with Salesforce Org)

• Command: coe.syncBranch
• Status Bar: $(sync) COE Sync
• Functionality:
  • Targets your active local repository or lets you browse for one.
  • Dynamically queries local Git branches and authorized Salesforce orgs.
  • Connects directly to the visual package.xml builder.
  • Automatically checks out the target branch, retrieves metadata from the Salesforce Org, and offers to commit the changes locally.
  • Displays a real-time animated progress bar and logs, with a direct shortcut to Auto-Create a GitLab Merge Request on completion.

5. Smart Commit & Push Helper (COE: Conventional Commit and Push)

• Command: coe.commitAndPush
• Status Bar: $(git-commit) COE Commit & Push
• Functionality:
  • Assesses active git status (unstaged changes, untracked files).
  • Prompts you to select a Conventional Commit type (feat, fix, docs, style, refactor, test, chore).
  • Interactively requests scope and message parameters.
  • Formats, commits, and pushes changes, providing a direct link in a notification toast to immediately create a GitLab Merge Request.

6. GitLab Merge Request Tool (COE: Create Merge Request)

• Command: coe.createMR
• Status Bar: $(git-merge) COE Merge Request
• Functionality: Launches automated MR creation for the active branch targeted at the standard branch pipeline (e.g. uat).

7. Multi-Step Prompt Launcher (COE: Open Prompt Launcher)

• Command: coe.openLauncher
• Shortcut: Ctrl+Shift+/ (macOS: Cmd+Shift+/)
• Context Menu: Editor Right-Click -> COE: Open Prompt Launcher
• Functionality:
  • Walks you through a two-step selection flow: first selecting the category/step (e.g., Initialize prompt launcher), and then choosing from the sequence-sorted execution prompts.
  • Templates are dynamically populated with your active editor selection ({{selected_code}}), file name ({{file_name}}), and language ID ({{language}}).
  • If code is highlighted, the template is directly injected into the editor.
  • If no selection is made, the generated prompt is copied to the clipboard for use with side-car AI panels.

8. Project Rules Injector (COE: Initialize Project Rules)

• Command: coe.initRules
• Context Menu: Editor Right-Click -> COE: Initialize Project Rules
• Functionality: Installs local instruction instruction/skill md and mdc files for Cursor, Windsurf, and VS Code Copilot based on your selected tech stack (Salesforce, React, Angular, Node.js).

Developer Experience & UX Enhancements

• ANSI Logging Sanitization: Clean, readable output terminal messages with ANSI escape codes and progress spinner noise stripped automatically.
• Visual Progress Tracking: Smooth CSS-gradient progress bar tracking each step of the repository setup, cloning, and metadata retrieval processes.
• Panel Exit Controls: Integrated "Close Panel" buttons to programmatically dispose of the webviews upon successful completion.

Prompt Execution Sequence

The prompt launcher is sequenced for step-by-step developer execution:

1. Get Next Ticket: Assesses assigned Jira issues and proposes next priorities.
2. Implement Ticket: Implements design rules with best practices.
3. Validate Ticket: Guides through browser-based testing and validation criteria.
4. Create Merge Request: Formats conventional commit messages and push targets.
5. Update Jira: Transmits implementation details and moves status to In Review.
6. Complete Ticket: Validates MR approval and closes the ticket as Done.

Development & Packaging Commands

Ensure Node.js and npm are installed. Run the following commands in the extension directory:

1. Install Dependencies:

   npm install
   

2. Compile Project:

   npm run compile
   

3. Package Extension (Build .vsix):

   npm run package
   

To install the built package locally, open VS Code, open the Extensions view, click the ... menu, choose Install from VSIX..., and select coe-repo-setup-1.0.5.vsix.