Full-Stack Architect & Self-Healing Build Agent

An autonomous AI-powered VS Code extension that scaffolds, builds, verifies, and self-heals full-stack applications — featuring a ChatGPT-like interactive UI, intelligent code generation, diff previews, and one-click rollback.

Features

Chat-Based Development

Interact with the agent through a rich ChatGPT-like webview or the VS Code Chat panel. Describe what you want in plain language and the agent plans, builds, and verifies everything for you.

Autonomous Agent Loop

PLAN → EXECUTE → VERIFY → FIX → REPEAT — the agent runs an intelligent build loop that detects failures, classifies errors across 18+ categories, and applies targeted fixes automatically for up to 5 cycles.

Code Generation & Modification

Generate full project scaffolds or modify existing codebases. The engine scans your workspace, creates an LLM-powered change plan, shows a diff preview, and applies changes — all with backup and one-click rollback.

Full-Stack From Zero

Generates a production-ready stack in seconds:

Self-Healing Error Recovery

Automatically diagnoses and fixes:

• Compilation errors (Java & TypeScript)
• Dependency resolution failures
• Runtime crashes and annotation issues
• Database connection problems
• Port conflicts
• Docker build and compose failures
• Java version mismatches

Workspace-Aware Intelligence

Analyzes your existing workspace to detect what's already present (Spring Boot, Angular, Docker, Postgres) and adapts its plan — never overwrites existing modules.

Screenshots

Add screenshots to a docs/screenshots/ folder and uncomment the image tags above.

Getting Started

Prerequisites

• VS Code 1.93 or later
• Node.js 18+
• Java 17 or 21
• Docker (for container features)
• Angular CLI (for frontend scaffold)

Installation

From Marketplace

1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X)
3. Search for Full-Stack Architect
4. Click Install

From VSIX

code --install-extension fullstack-architect-agent-1.0.0.vsix

Usage

Open the Chat UI

Run from the Command Palette (Ctrl+Shift+P):

Full-Stack Architect: Open Chat UI

Type a request like:

• "Build me a full-stack app called taskmanager"
• "Fix all errors in this project"
• "Add a user profile page with REST endpoint"
• "Dockerize this project"
• "Verify everything is running"

Chat Participant

In VS Code's built-in Chat panel, mention @fullstack-architect:

@fullstack-architect /build Create a blog platform
@fullstack-architect /fix Diagnose and fix errors
@fullstack-architect /verify Check all services
@fullstack-architect /docker Set up containers
@fullstack-architect /modify Add a dashboard component

Commands

Configuration

All settings are under fullstackArchitect.* in VS Code Settings:

Architecture

src/
├── extension.ts                 # Entry point & command registration
├── types.ts                     # Shared type definitions
├── agent-loop.ts                # PLAN → EXECUTE → VERIFY → FIX engine
├── logger.ts                    # Structured logging + event emission
├── terminal-runner.ts           # Shell command execution
├── file-manager.ts              # Safe file I/O utilities
├── chat/
│   ├── chat-handler.ts          # VS Code Chat Participant handler
│   └── intent-detector.ts       # LLM + keyword intent detection
├── codegen/
│   ├── code-generator.ts        # LLM-powered code generation
│   ├── file-scanner.ts          # Workspace file scanning
│   ├── code-injector.ts         # Safe code injection
│   └── backup-manager.ts        # Backup & rollback support
├── context/
│   └── workspace-analyzer.ts    # Workspace-aware module detection
├── healing/
│   ├── error-analyzer.ts        # 18+ error pattern classifier
│   └── self-healer.ts           # Targeted fix application
├── scaffolders/
│   ├── backend-scaffolder.ts    # Spring Boot project generation
│   ├── frontend-scaffolder.ts   # Angular project generation
│   ├── postgres-scaffolder.ts   # PostgreSQL init scripts
│   └── docker-scaffolder.ts     # Docker Compose setup
├── verification/
│   └── verification-engine.ts   # Build, runtime & Docker validation
└── webview/
    ├── chat-panel.ts            # ChatGPT-like webview panel
    ├── status-panel.ts          # Full status webview
    ├── status-view-provider.ts  # Activity bar sidebar view
    └── ui/
        ├── index.html           # Chat UI template
        ├── styles.css           # Dark-theme CSS
        └── app.js               # Frontend logic

Tech Stack

• Extension: TypeScript, VS Code Extension API
• AI: VS Code Language Model API (GPT-4o)
• Backend Generation: Spring Boot 3.x, Maven, JPA, BCrypt
• Frontend Generation: Angular 17+, standalone components
• Database: PostgreSQL 16
• Containers: Docker Compose
• UI: Custom webview with CSP, nonce-based security

Development

# Install dependencies
npm install

# Compile
npm run compile

# Watch mode
npm run watch

# Lint
npm run lint

Press F5 in VS Code to launch the Extension Development Host for testing.

Publishing

Prerequisites

npm install -g @vscode/vsce

Package

vsce package

This produces a .vsix file you can share or install locally.

Publish

1. Create a publisher at Visual Studio Marketplace
2. Generate a Personal Access Token (PAT) with Marketplace > Manage scope
3. Login and publish:

vsce login your-publisher-name
vsce publish

Pre-Publish Checklist

• [x] Replace your-publisher-name in package.json with your real publisher ID
• [x] Replace repository URL placeholders with actual GitHub URL
• [ ] Add a 128x128 PNG icon at resources/icon.png
• [ ] Add screenshots to docs/screenshots/
• [ ] Test in Extension Development Host (F5)
• [ ] Verify Chat UI opens correctly
• [ ] Verify all commands work in Command Palette
• [ ] Confirm no hardcoded absolute paths
• [ ] Test in a clean workspace (no pre-existing project)
• [ ] Run vsce package and verify no warnings

License

This project is licensed under the MIT License.

Press F5 in VS Code to launch the Extension Development Host.

Prerequisites

• Node.js 18+ (for Angular CLI / npm)
• Java 17 or 21 (for Spring Boot builds)
• Maven 3.9+ (or use the Docker build)
• Docker & Docker Compose (for container verification)