SDLC Orchestrator VS Code Extension

Version: 1.0.0 Status: GA (General Availability) SDLC Stage: 04 (DEPLOY) Sprint: 53 - VS Code Extension + Contract Lock

Gate status monitoring, AI-powered code generation, and compliance assistance directly in VS Code. Part of the SDLC Orchestrator governance platform - the Operating System for Software 3.0.

Key Features

App Builder (New in 1.0.0)

• Blueprint Editor: Visual tree view for building AppBlueprint specifications
• Module Management: Add/remove modules with entity definitions
• Domain Templates: Pre-built templates for Vietnamese SME (Restaurant, Hotel, Retail, HRM, CRM)
• Real-time Validation: Immediate feedback on blueprint structure

Code Generation (New in 1.0.0)

• IR-Based Generation: Deterministic output via Intermediate Representation
• Multi-Provider: Ollama (primary) -> Claude (fallback) -> Rule-based
• 4-Gate Quality Pipeline: Syntax -> Security -> Context -> Tests
• SSE Streaming: Real-time progress with file-by-file updates
• Resume Capability: Checkpoint-based recovery for failed generations

Contract Lock (New in 1.0.0)

• Specification Immutability: Lock blueprints before code generation
• SHA256 Hash Verification: Cryptographic integrity checking
• Audit Trail: Full history of lock/unlock operations
• Auto-Expiry: Orphaned locks expire after 1 hour

Gate Status Sidebar

• View G0-G5 gate progress in real-time
• See evidence count and approval status
• Auto-refresh every 30 seconds
• Click to open gates in browser
• Progress percentage visualization

Inline AI Chat (@gate)

Use Copilot-style commands in VS Code Chat:

@gate /status      - Show current gate status (G0-G5)
@gate /evaluate    - Run compliance evaluation, show violations
@gate /fix <id>    - Get AI recommendation for a violation
@gate /council <id> - Use AI Council 3-stage deliberation

Violations Panel

• View compliance violations grouped by severity (Critical, High, Medium, Low)
• Quick actions to get AI recommendations
• Navigate to file locations
• Filter by status (open, resolved)

Projects Panel

• List all projects you have access to
• Quick project selection
• View compliance scores
• See current gate status

Offline Mode Support

• Automatic cache fallback when network unavailable
• Stale-while-revalidate pattern for smooth UX
• Visual indicator when using cached data
• Graceful degradation with user-friendly messages

Installation

From VS Code Marketplace

1. Open VS Code Extensions (Ctrl+Shift+X)
2. Search for "SDLC Orchestrator"
3. Click Install

From VSIX (Development)

1. Download the latest .vsix file from releases
2. In VS Code, open Command Palette (Cmd+Shift+P / Ctrl+Shift+P)
3. Run "Extensions: Install from VSIX..."
4. Select the downloaded file

Quick Start

1. Install the extension
2. Login using Command Palette > "SDLC: Login"
3. Select Project using Command Palette > "SDLC: Select Project"
4. View Gates in the SDLC sidebar
5. Generate Code:
   • Open App Builder: "SDLC: Open App Builder"
   • Create a blueprint with modules and entities
   • Lock the specification: "SDLC: Lock Contract Spec"
   • Generate code: "SDLC: Generate from Blueprint"

Commands

Configuration

Requirements

• VS Code 1.80.0 or higher
• SDLC Orchestrator backend running (v1.0.0+)
• Valid API token or GitHub OAuth

Architecture

src/
├── extension.ts           # Main entry point, activation
├── services/
│   ├── apiClient.ts       # Backend API client (axios-based)
│   ├── authService.ts     # JWT token management, OAuth flow
│   ├── cacheService.ts    # Offline cache with TTL
│   └── codegenApi.ts      # Code generation API client
├── panels/
│   ├── appBuilderPanel.ts # Blueprint editor webview
│   └── generationPanel.ts # Real-time generation view
├── views/
│   ├── gateStatusView.ts  # Gate sidebar TreeDataProvider
│   ├── violationsView.ts  # Violations TreeDataProvider
│   ├── projectsView.ts    # Projects TreeDataProvider
│   ├── complianceChat.ts  # Chat participant (@gate)
│   └── blueprintView.ts   # Blueprint tree view
├── commands/
│   ├── lockCommand.ts     # Contract lock/unlock commands
│   ├── generateCommand.ts # Code generation commands
│   └── magicCommand.ts    # Natural language mode
├── utils/
│   ├── config.ts          # Configuration manager
│   ├── logger.ts          # Structured logging
│   └── errors.ts          # Error classification & handling
├── types/
│   └── codegen.ts         # Type definitions for codegen
└── test/
    └── suite/
        ├── apiClient.test.ts
        ├── authService.test.ts
        ├── cacheService.test.ts
        ├── codegenApi.test.ts
        ├── streaming.test.ts
        └── errorHandling.test.ts

Development

Prerequisites

• Node.js 18+
• npm 9+
• VS Code 1.80+

Setup

cd vscode-extension
npm install
npm run compile

Watch Mode

npm run watch

Package Extension

npm run package
# Creates sdlc-orchestrator-1.0.0.vsix

Run Tests

npm run test

Debug in VS Code

1. Open vscode-extension folder in VS Code
2. Press F5 to launch Extension Development Host
3. The extension will be loaded in a new VS Code window

Cache Strategy

Troubleshooting

Connection Refused

• Ensure SDLC Orchestrator backend is running
• Check sdlc.apiUrl configuration
• Verify firewall/proxy settings

Token Expired

• Run "SDLC: Logout" then "SDLC: Login"
• Check token expiration in dashboard

Generation Failed

• Check if blueprint is locked: "SDLC: Lock Contract Spec"
• Verify backend AI providers are available
• Try "SDLC: Resume Failed Generation" if checkpoint exists

Lock Expired

• Locks auto-expire after 1 hour of inactivity
• Re-lock the specification before generation

License

Apache-2.0

Support

• GitHub Issues: https://github.com/Minh-Tam-Solution/SDLC-Orchestrator/issues
• Documentation: https://docs.sdlc-orchestrator.dev