IFS Cloud AI Developer Assistant

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 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:
   ifs-cloud-ai-developer-x.x.x.vsix

⚙️ Environment Setup (.env)

Create this file in the root of your workspace:

<workspace>/.env

Required variables

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>

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         (Activate / deactivate shell)
│  ├─ aiClient.ts          (Anthropic Claude SDK wrapper)
│  ├─ azureDevOps.ts       (Azure DevOps REST helpers)
│  ├─ azurePrReview.ts     (Standalone CLI for PR reviews)
│  ├─ bulkReview.ts        (Bulk review engine)
│  ├─ cacheUtils.ts        (Persistent file cache)
│  ├─ commandHub.ts        (Command Hub quick-pick UI)
│  ├─ constants.ts         (Shared constants and templates)
│  ├─ gitHelpers.ts        (Git diff / checkout operations)
│  ├─ knowledgeBase.ts     (IFS docs knowledge base)
│  ├─ prReview.ts          (PR review orchestration)
│  ├─ reviewCache.ts       (Review cache manager)
│  ├─ reviewCommands.ts    (All review command implementations)
│  ├─ rules.ts             (Rule loading and matching)
│  ├─ types.ts             (Shared type definitions)
├─ ifs_rules.json          (IFS category & rule definitions)
├─ 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:

IFS Cloud AI Developer Assistant Team

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