Jolt Extension for VSCode

This Visual Studio Code extension helps developers connect to an agency, view available environments, and prepare for streamlined script development and deployment.

🚀 Features

• 🔧 Side-panel UI built with a secure webview
• 🧩 Connect to an Agency to save a new Token
  • 🌐 View a list of available environments
• 📦 Scaffolding ready for future enhancements (e.g., diffing scripts, deployment)
• ⌨️ Press F5 to run an open .js script file via the agency’s Construct API and see the response in the VSCode output panel

🔄 Recent Updates

• Begin building deploy support with EMSE workspace integration.
• Created Universal template run mode
• Add ability to commit/rollback
• Added ability to sort tokens by agency or environment.
• Integrated SVG icon based on submitted branding image.
• Implemented token request control that

🌟 Next Goals

• Add ability to simulate script events
• Begin building script diffing and deploy support with EMSE workspace integration.
• Add a Requirements input area for capturing EMSE needs.
• Implement workspace scanning to suggest scripts relevant to the current task (pre-ticket system integration).

🛠 Project Structure

jolt-extension/
├── .vscode/                                          # VSCode workspace settings
├── accela_scripts/
│ └── GQ_API.js
├── config/
│ └── agencies.json                                   # Default lookup list on new token page
├── dist/                                             # Compiled output (if applicable)
├── media/                                            # Icons, images, and assets
│ ├── vsce-jolt_extension_icon.svg                    # logo for extension
│ └── vsce-martketplace-jolt_extension_icon-128.png   # vscode extension marketplace logo
├── node_modules/                                     # Dependencies
├── src/
│ ├── css/
│ │ ├── createToken.css
│ │ └── joltHome.css
│ ├── models/
│ │ └── apiAccela.ts
│ ├── utils/                                          # Construct API helpers and result processors
│ │ ├── keybindManager.ts
│ │ ├── runScriptManager.ts
│ │ └── tokenManager.ts
│ ├── webview/
│ │ ├── createTokenForm.html
│ │ └── joltHome.html
│ ├── jolt-extension.ts                               # Extension activation and command registration
│ └── JoltViewProvider.ts                             # Main home view provider
├── .gitignore
├── CHANGELOG.md
├── package.json                                      # Extension manifest and scripts
├── README.md                                         # Project documentation
├── tsconfig.json
└── webpack.config.js

✅ Roadmap Checklist

• [x] Load agencies dynamically from the Public API
• [x] Populate environments based on agency selection
• [x] Support token acquisition with username/password
• [x] Support scope selection via categorized multiselect UI with "Select All" option
• [x] Group scopes with descriptions and tooltips
• [x] Store tokens securely per user
• [x] Show saved tokens and allow token selection
• [x] Use token in subsequent API requests
• [x] Provide script execution via Construct API using F5 shortcut
• [x] Add rollback/commit dropdown
• [x] Provide script deployment interface from local to remote
• [ ] Implement script diff viewer
• [ ] Maintain a deployment history tied to Git commits

🔐 Security Notes

This extension uses vscode.SecretStorage for securely storing access tokens. Tokens are indexed using a composite key (agency:env:username) to allow fast retrieval and support multiple user sessions.

📦 Installation (Development)

1. Clone the repository:

git clone https://github.com/Chris-At-TruePointSolutions/jolt-extension.git
cd jolt-extension

2. Install dependencies:

npm install

3. Build the extension:

npm run build
or
npm run watch

4. Launch in Extension Development Host:

• Press F5 in VSCode (make sure you have the .vscode/launch.json file)

5. Publish new version:

npm run publish --minor