Align 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

✅ 1. Tailoring Guide Review (Single File)

Analyzes the active file using IFS rules and categories.
Highlights:

• Issues by category
• Suggested remediations
• Rule references
• Upgrade impact analysis

✅ 2. Review Selected Code

Runs a focused review on only the highlighted portion of the file.

✅ 3. Suggest Improvements

Lightweight suggestions for readability, structure, and best practices.

✅ 4. Plan Customization from Requirement

Paste a functional requirement → get:

• What objects to modify
• What files to create
• Code patterns to use
• Impact areas
• Final step-by-step plan

✅ 5. Azure DevOps Pull Request Review

Provide PR ID → extension:

• Fetches diff
• Analyzes all impacted files
• Summarizes risks by category
• Returns a complete IFS-tailoring-focused PR review report

✅ 6. Bulk Review for Workspace

Scan your entire project:

• Identify high-risk files
• Score files by category
• Export results (CSV)
• View analytics dashboard

✅ 7. Review Analytics Dashboard

Visual summary including:

• Top rule violations
• Most problematic categories
• File risk ranking
• Trend analysis

✅ 8. Cache Management Tools

Options include:

• Clear all review cache
• Clear cache for current file
• Force fresh review
• View cache statistics

✅ 9. Explain Code & Upgrade Impact

Provides an explanation of the file and its potential upgrade risks.

✅ 10. Command Hub (NEW)

A single entry point: IFS Cloud: Open Align Developer Command Hub
Shows a QuickPick menu with all main features.

🛠️ Installation

1. Open VS Code
2. Go to Extensions
3. Click Install from VSIX…
4. Select the file:
   align-developer-assistant-x.x.x.vsix

⚙️ Environment Setup (.env)

Create this file in the root of your workspace:

<workspace>/.env

Required variables

OPENAI_API_KEY=<your-openai-key>
OPENAI_MODEL=gpt-5.1
AZURE_DEVOPS_ORG=<your-org-name>
AZURE_DEVOPS_PROJECT=<your-project-name>
AZURE_DEVOPS_PAT=<your-personal-access-token>
AZURE_DEVOPS_REPO_ID=<repo-id>

How to get each variable

🧭 Commands

You can access all commands via:

• Command Palette (Ctrl+Shift+P)
• Type: IFS Cloud
• Or use the Command Hub

Main Commands

📂 Project Structure

├─ src/
│  ├─ extension.ts                 (Main entry point)
│  ├─ azurePrReview.ts             (PR review logic)
│  ├─ bulkReview.ts                (Bulk review engine)
│  ├─ rules.ts                     (Rule application logic)
│  ├─ knowledgeBase.ts             (KB context builder)
│  ├─ cacheUtils.ts                (Cache logic)
├─ ifs_rules.json                  (IFS category & rule definition)
├─ guidelines-source.json          (Crawled guideline data)
├─ guidelines-source.generated.json
├─ package.json
├─ README.md

🧪 Running the Project (Development Mode)

npm install
npm run compile
npm run watch

To test in VS Code:

F5 → Launch Extension Development Host

📦 Publishing a New Version

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

❓ Troubleshooting

❗ Extension says variables are missing

Ensure .env file exists in:

<workspace>/.env

All variables are mandatory.

❗ PR Review fails

Check Azure DevOps PAT:

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

❗ Categorization issues

Ensure ifs_rules.json includes the category. The extension auto-loads categories dynamically.

💬 Support

For assistance, improvements, or additional features, contact:

ALIGN Developer Studio – AI Assistant Team

Enjoy building on IFS Cloud with AI assistance!
– Align Developer Assistant