Align AI Developer Assistant for IFS Cloud

A VS Code Extension that provides AI-powered reviews, customization planning, and code improvements for IFS Cloud development — using IFS guidelines, best practices, and your project context.

Features

Offline Tools (No AI Required)

AI-Powered Tools (Developer)

Consultant Tools

Platform Features

Installation

From Marketplace

Search for Align AI Developer in the VS Code Extensions panel, or install from:

Publisher: AlignConsulting

From VSIX

1. Open VS Code
2. Go to Extensions
3. Click Install from VSIX...
4. Select the file: align-ai-developer-ifs-cloud-5.1.2.vsix

Environment Setup

Option 1: Setup Wizard (Recommended)

Run Align: Run Setup Wizard from the Command Palette. It will walk you through:

1. AI provider selection (Anthropic, OpenAI, Azure OpenAI, Gemini, Ollama)
2. API key and model configuration
3. CUST_REPO folder picker
4. Optional CORE_REPO path
5. Optional Azure DevOps configuration

Option 2: Manual .env File

Create a .env file in the root of your workspace:

ANTHROPIC_API_KEY=<your-anthropic-key>
ANTHROPIC_MODEL=claude-sonnet-4-6
CUST_REPO=<path-to-cust-repo>
CORE_REPO=<path-to-core-repo>
AZ_ORG=<your-azure-devops-org>
AZ_PROJECT=<your-azure-devops-project>
AZ_REPO_ID=<your-repo-id>
AZ_PAT=<your-personal-access-token>

Settings

Commands

Access all commands via Command Palette (Ctrl+Shift+P) — type Align — or use the Command Hub.

Project Structure

src/
  extension.ts            Activate / deactivate shell
  aiClient.ts             Multi-provider AI SDK wrapper
  aiProvider.ts           AI provider selection + configuration
  azureDevOps.ts          Azure DevOps REST helpers
  azurePrReview.ts        Standalone CLI for PR reviews
  bulkReview.ts           Bulk review engine
  cacheUtils.ts           Persistent file cache
  codeActionProvider.ts   Quick-fix code actions (lightbulb)
  commandHub.ts           Command Hub quick-pick UI
  constants.ts            Shared constants and templates
  coreCustAnalyzer.ts     CORE vs CUST divergence analysis
  dashboardPanel.ts       Webview analytics dashboard
  dependencyAnalyzer.ts   Cross-file dependency analysis
  diagnosticsManager.ts   Inline diagnostics (squiggly lines)
  fileWatcher.ts          Auto-review on save
  gitAwareReview.ts       Git diff-focused review
  gitHelpers.ts           Git diff / checkout operations
  knowledgeBase.ts        IFS docs knowledge base
  mcpServer.ts            MCP server (standalone)
  offlineReviewEngine.ts  Offline pattern-based review engine
  patternLoader.ts        JSON pattern loader + version filter
  prReview.ts             PR review orchestration
  prWriteBack.ts          Azure DevOps PR comment write-back
  reviewCache.ts          Review cache manager
  reviewCommands.ts       All review command implementations
  reviewHistory.ts        Persistent review history
  reviewTreeView.ts       Sidebar tree view provider
  rules.ts                Rule loading and matching
  setupWizard.ts          Interactive setup wizard
  structureValidator.ts   Entity/Projection/Page validation
  testGenerator.ts        PL/SQL test stub generator
  types.ts                Shared type definitions
  versionUtils.ts         IFS version parsing & comparison
resources/
  patterns.json           79 review pattern definitions
ifs_rules.json            IFS category & rule definitions
package.json
README.md
CHANGELOG.md

MCP Server

The extension includes a Model Context Protocol (MCP) server that can be run standalone:

npm run mcp

This exposes the following tools to external AI agents:

• review_file — Run offline review on a file
• review_content — Review raw code content
• get_pattern_list — List all review patterns
• get_review_history — Query review history
• get_team_metrics — Get team-level metrics

Set ALIGN_EXTENSION_PATH and ALIGN_WORKSPACE_ROOT environment variables to configure paths.

Development

npm install
npm run compile
npm run watch

To test in VS Code:

F5 — Launch Extension Development Host

Publishing

npm run compile
npx @vscode/vsce package
npx @vscode/vsce publish

Troubleshooting

Extension says variables are missing

Run Align: Run Setup Wizard to configure interactively, or ensure .env file exists in your workspace root.

PR Review fails

Check Azure DevOps PAT:

• Must include Code (Read) permission
• Must not be expired

Offline review finds no issues

Check the file extension — the engine scans .plsql, .sql, .client, .projection, .entity, .page, .fragment, .views files.

MCP server won't start

Ensure the extension is compiled (npm run compile) and run npm run mcp from the extension root.

Support

For assistance, improvements, or additional features, contact:

Align Consulting — AI Developer Assistant for IFS Cloud Team

– Align AI Developer Assistant for IFS Cloud