partnercore-proxy 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,54 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2024-12-26
+
+### Added
+- Initial release of PartnerCore Proxy
+- AL Language Server integration via Microsoft AL extension
+  - Auto-download from VS Code Marketplace
+  - Symbol navigation (definitions, references)
+  - Code completion
+  - Hover information
+  - Real compiler diagnostics
+- Cloud relay to PartnerCore MCP server
+  - API key authentication
+  - Secure HTTPS communication
+- Local tools:
+  - `al_get_symbols` - Get all symbols in an AL file
+  - `al_find_symbol` - Search symbols by name
+  - `al_find_references` - Find all references to a symbol
+  - `al_get_diagnostics` - Get compiler diagnostics
+  - `al_go_to_definition` - Navigate to symbol definition
+  - `al_hover` - Get type info and documentation
+  - `al_completion` - Get code completions
+  - `read_file` - Read file contents
+  - `write_file` - Write file contents
+  - `list_files` - List files in directory
+  - `search_files` - Search for text in files
+- Cloud tools (routed to PartnerCore):
+  - `partnercore_review` - AI-powered code review
+  - `partnercore_improve` - Get improvement suggestions
+  - `partnercore_analyze` - Pattern-based analysis
+  - `partnercore_validate` - Validate against standards
+  - `partnercore_kb_search` - Search knowledge base
+  - `partnercore_template` - Get code templates
+  - `partnercore_generate` - Generate AL code
+- CLI commands:
+  - `start` - Start the MCP proxy server
+  - `check` - Check configuration and connections
+  - `download-extension` - Download/update AL extension
+- MCP marketplace manifest (`mcp.json`)
+
+### Security
+- [SECURITY] Path traversal prevention in file operations
+- [SECURITY] API keys never logged
+- [SECURITY] HTTPS-only cloud communication
+- [SECURITY] Workspace sandboxing for file access
+

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024 Ciellos
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,234 @@
+# @ciellos/partnercore-proxy
+
+**Local MCP proxy for Microsoft Dynamics 365 Business Central AL development**
+
+[![npm version](https://img.shields.io/npm/v/@ciellos/partnercore-proxy.svg)](https://www.npmjs.com/package/@ciellos/partnercore-proxy)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Overview
+
+PartnerCore Proxy bridges local AL development with cloud-based AI assistance:
+
+- **Real AL Language Server** - Symbol navigation, diagnostics, completions via Microsoft's AL extension
+- **Intelligent Routing** - Local operations stay local; cloud operations require API key
+- **Secure by Design** - API keys never logged, file access sandboxed to workspace
+- **MCP Standard** - Works with Claude, Cursor, and any MCP-compatible AI assistant
+
+## Quick Start
+
+### Global Installation
+
+```bash
+npm install -g @ciellos/partnercore-proxy
+```
+
+### Run with npx (no install)
+
+```bash
+npx @ciellos/partnercore-proxy start --workspace /path/to/al-project
+```
+
+### MCP Configuration
+
+Add to your AI assistant's MCP configuration:
+
+**Cursor (`~/.cursor/mcp.json`):**
+```json
+{
+  "mcpServers": {
+    "partnercore": {
+      "command": "npx",
+      "args": ["@ciellos/partnercore-proxy", "start"],
+      "env": {
+        "AL_WORKSPACE_ROOT": "/path/to/your/al-project",
+        "PARTNERCORE_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+**Claude Desktop (`claude_desktop_config.json`):**
+```json
+{
+  "mcpServers": {
+    "partnercore": {
+      "command": "partnercore-proxy",
+      "args": ["start", "--workspace", "/path/to/al-project"],
+      "env": {
+        "PARTNERCORE_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+## Features
+
+### Local Tools (No API Key Required)
+
+| Tool | Description |
+|------|-------------|
+| `al_get_symbols` | Get all symbols in an AL file (tables, pages, codeunits, procedures) |
+| `al_find_symbol` | Search for symbols by name across the workspace |
+| `al_find_references` | Find all references to a symbol |
+| `al_get_diagnostics` | Get real compiler diagnostics (errors, warnings) |
+| `al_go_to_definition` | Navigate to symbol definition |
+| `al_hover` | Get type information and documentation |
+| `al_completion` | Get intelligent code completion suggestions |
+| `read_file` | Read file contents (sandboxed to workspace) |
+| `write_file` | Write file contents (sandboxed to workspace) |
+| `list_files` | List files in directory |
+| `search_files` | Search for text in files |
+
+### Cloud Tools (API Key Required)
+
+| Tool | Description |
+|------|-------------|
+| `partnercore_review` | AI-powered code review with 252+ AL patterns |
+| `partnercore_improve` | Get specific improvement suggestions |
+| `partnercore_analyze` | Deep pattern-based code analysis |
+| `partnercore_validate` | Validate against BC/AL standards |
+| `partnercore_kb_search` | Search PartnerCore knowledge base |
+| `partnercore_template` | Get production-ready AL code templates |
+| `partnercore_generate` | Generate AL code from descriptions |
+
+## CLI Commands
+
+```bash
+# Start the MCP proxy
+partnercore-proxy start [options]
+
+Options:
+  -w, --workspace <path>  AL workspace root (containing app.json)
+  -v, --verbose           Enable verbose logging
+  --no-cloud              Disable cloud connection (local tools only)
+
+# Check configuration
+partnercore-proxy check
+
+# Download/update AL extension
+partnercore-proxy download-extension
+```
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `AL_WORKSPACE_ROOT` | Yes | Path to AL project (containing `app.json`) |
+| `PARTNERCORE_API_KEY` | No* | API key for cloud features |
+| `PARTNERCORE_ENV` | No | Environment: `production` or `uat` (default: `production`) |
+| `PARTNERCORE_CLOUD_URL` | No | Override cloud URL (takes precedence over ENV) |
+| `LOG_LEVEL` | No | `debug`, `info`, `warn`, `error` (default: `info`) |
+
+*Cloud tools require API key. Local tools work without it.
+
+### Environment Endpoints
+
+| Environment | URL |
+|-------------|-----|
+| **Production** (default) | `https://partnercore-mcp-prod.agreeablebush-0fe29c4e.eastus.azurecontainerapps.io` |
+| **UAT** | `https://partnercore-mcp-uat.happysand-4085830a.eastus.azurecontainerapps.io` |
+
+To use UAT environment:
+```bash
+export PARTNERCORE_ENV=uat
+partnercore-proxy start
+```
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│                    AI Assistant (Claude/Cursor/Copilot)              │
+└─────────────────────────────────────────────────────────────────────┘
+                                    │
+                                    ▼ MCP Protocol (stdio)
+┌─────────────────────────────────────────────────────────────────────┐
+│                    PartnerCore Proxy (Your Machine)                  │
+│  ┌───────────────────────────────────────────────────────────────┐  │
+│  │                       Tool Router                              │  │
+│  │   al_* tools ──────► AL Language Server (local, fast)         │  │
+│  │   file tools ──────► Sandboxed File System                    │  │
+│  │   partnercore_* ───► Cloud API (HTTPS, authenticated)         │  │
+│  └───────────────────────────────────────────────────────────────┘  │
+└─────────────────────────────────────────────────────────────────────┘
+                │                              │
+                ▼                              ▼
+    ┌──────────────────┐           ┌─────────────────────────────────┐
+    │   Your AL Files  │           │    PartnerCore Cloud            │
+    │   (local only)   │           │    - Knowledge Base             │
+    └──────────────────┘           │    - 252+ Patterns              │
+                                   │    - AI Code Review             │
+                                   └─────────────────────────────────┘
+```
+
+## Security
+
+### File System Sandboxing
+- All file operations are restricted to the configured workspace root
+- Path traversal attacks are prevented
+- Maximum file sizes enforced
+
+### API Key Protection
+- API keys are **never logged** at any level
+- Keys transmitted only over HTTPS
+- Automatic masking in error messages
+
+### Network Security
+- Cloud communication uses HTTPS/TLS only
+- Only connects to:
+  - `marketplace.visualstudio.com` (Microsoft VS Code Marketplace)
+  - `partnercore-mcp-prod.*.azurecontainerapps.io` (PartnerCore Production)
+  - `partnercore-mcp-uat.*.azurecontainerapps.io` (PartnerCore UAT)
+
+See [SECURITY.md](./SECURITY.md) for full security documentation.
+
+## Getting an API Key
+
+1. Visit [https://partnercore.ai](https://partnercore.ai)
+2. Sign up for a PartnerCore account
+3. Generate an API key in your dashboard
+4. Add it to your MCP configuration
+
+**Without an API key**, you can still use all local AL Language Server features!
+
+## Troubleshooting
+
+### "AL Language Server not initialized"
+- Ensure `app.json` exists in your workspace root
+- Check that the AL extension downloaded successfully: `partnercore-proxy download-extension`
+
+### "File not found" errors
+- Paths must be relative to the workspace root
+- Absolute paths outside workspace are blocked for security
+
+### Cloud tools return "Cloud client not configured"
+- Set `PARTNERCORE_API_KEY` environment variable
+- Verify with `partnercore-proxy check`
+
+### Verbose logging
+```bash
+partnercore-proxy start --verbose
+```
+
+## Requirements
+
+- **Node.js**: 18.0.0 or higher
+- **Operating System**: Windows, macOS, or Linux
+- **AL Project**: Valid `app.json` in workspace
+
+## Contributing
+
+Contributions are welcome! Please see [CONTRIBUTING.md](./CONTRIBUTING.md).
+
+## License
+
+MIT - see [LICENSE](./LICENSE)
+
+## Links
+
+- [PartnerCore Cloud](https://partnercore.ai)
+- [Ciellos](https://ciellos.com)
+- [GitHub Repository](https://github.com/ciellos-dev/partnercore-proxy)
+- [MCP Specification](https://modelcontextprotocol.io)

package/dist/al/extension-manager.d.ts

@@ -0,0 +1,52 @@
+/**
+ * AL Extension Manager
+ *
+ * Handles downloading and managing the Microsoft AL Language extension
+ * which contains the EditorServices.Host executable for LSP communication.
+ */
+import { ALConfig, ALExtensionInfo } from '../config/types.js';
+/**
+ * AL Extension Manager
+ */
+export declare class ALExtensionManager {
+    private config;
+    private logger;
+    constructor(config: ALConfig);
+    /**
+     * Get or download the AL extension
+     */
+    getExtension(): Promise<ALExtensionInfo>;
+    /**
+     * Load an existing extension from a specified path
+     */
+    private loadExistingExtension;
+    /**
+     * Find cached extension
+     */
+    private findCachedExtension;
+    /**
+     * Download extension from VS Code Marketplace
+     */
+    private downloadExtension;
+    /**
+     * Query VS Code Marketplace for extension info
+     */
+    private queryMarketplace;
+    /**
+     * Download a file
+     */
+    private downloadFile;
+    /**
+     * Find EditorServices.Host executable in extension directory
+     */
+    private findEditorServices;
+    /**
+     * Recursively search for EditorServices executable
+     */
+    private searchForEditorServices;
+    /**
+     * List files recursively for debugging
+     */
+    private listFilesRecursive;
+}
+//# sourceMappingURL=extension-manager.d.ts.map

package/dist/al/extension-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-manager.d.ts","sourceRoot":"","sources":["../../src/al/extension-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAmC/D;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,EAAE,QAAQ;IAI5B;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,eAAe,CAAC;IAiB9C;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA4B7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAiC3B;;OAEG;YACW,iBAAiB;IAwE/B;;OAEG;YACW,gBAAgB;IAiE9B;;OAEG;YACW,YAAY;IAgB1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAkC1B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA0B/B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAqB3B"}