partnercore-proxy 0.1.4 → 0.4.0

package/CHANGELOG.md

@@ -7,6 +7,137 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0] - 2024-12-26
+
+### Added
+
+#### AL Language Server Enhancements
+- `al_restart_server` - Restart the language server (recovery from hangs)
+- `al_find_referencing_symbols` - Enhanced reference navigation with context snippets
+- `al_insert_before_symbol` - Insert content before a symbol (for imports, decorators)
+
+#### File Operations
+- `find_file` - Find files by pattern with wildcards (*, ?)
+- `replace_content` - Powerful search/replace with regex support
+
+#### Memory Management
+- `edit_memory` - Edit memories with search/replace (supports regex)
+
+#### BC Container Tools
+- `bc_get_extensions` - List installed apps in container
+- `bc_uninstall_app` - Uninstall apps from container
+- `bc_compile_warnings` - Quick compilation warning check
+
+### Changed
+- Total tool count increased from 47 to 57 local tools
+
+## [0.3.0] - 2024-12-26
+
+### Added
+- **100% LSP Feature Coverage** - Complete implementation of all standard LSP features
+- **BC Container Management** - Full container lifecycle management
+  - `bc_create_container` - Create new BC containers with full configuration options
+  - `bc_remove_container` - Remove containers with optional force flag
+
+#### Core LSP Tools
+- `al_code_actions` - Get quick fixes and refactorings at a position
+- `al_signature_help` - Get function parameter hints
+- `al_format` - Format entire document or a range
+
+#### Document Analysis
+- `al_document_highlight` - Highlight all occurrences of symbol under cursor
+- `al_folding_ranges` - Get code folding ranges (regions, procedures, comments)
+- `al_selection_range` - Smart expand/shrink selection
+- `al_semantic_tokens` - Get semantic tokens for syntax highlighting
+
+#### Navigation
+- `al_type_definition` - Go to the type of a variable
+- `al_implementation` - Find interface implementations
+
+#### Advanced Editing
+- `al_format_on_type` - Format code after typing specific characters
+- `al_code_lens` - Get inline hints (reference counts, run tests)
+- `al_document_links` - Get clickable links in comments
+
+#### Lifecycle Management
+- `al_close_document` - Close a document (cleanup resources)
+- `al_save_document` - Send save notification (trigger recompile)
+- `al_execute_command` - Execute LSP commands
+
+### Changed
+- AL Language Server now supports all standard LSP features
+- Tool count increased from 35 to 47 local tools
+
+## [0.2.0] - 2024-12-26
+
+### Added
+
+#### Symbol-Based Editing
+- `al_rename_symbol` - Rename symbols across the entire workspace using LSP refactoring
+- `al_insert_after_symbol` - Insert content after a named symbol
+- `al_replace_symbol_body` - Replace the entire body of a symbol
+
+#### Advanced File Operations
+- `delete_lines` - Delete a range of lines from a file
+- `replace_lines` - Replace a range of lines with new content
+- `insert_at_line` - Insert content at a specific line number
+
+#### Project Memory System
+- `write_memory` - Save project-specific knowledge/memory for future sessions
+- `read_memory` - Read a specific memory by name
+- `list_memories` - List all saved project memories
+- `delete_memory` - Delete a specific memory
+
+#### BC Container Tools
+- `bc_list_containers` - List all Business Central Docker containers
+- `bc_compile` - Compile AL project in a BC container with CodeCops
+- `bc_publish` - Publish app to BC container with sync modes
+- `bc_run_tests` - Run automated tests in BC container
+- `bc_container_logs` - Get container logs for debugging
+- `bc_start_container` - Start a stopped container
+- `bc_stop_container` - Stop a running container
+- `bc_restart_container` - Restart a container
+- `bc_download_symbols` - Download symbol files from container
+
+#### Git Operations
+- `git_status` - Get current Git status with branch info
+- `git_diff` - Show diff of changes (staged/unstaged)
+- `git_stage` - Stage files for commit
+- `git_commit` - Commit staged changes
+- `git_log` - Show commit history with filters
+- `git_branches` - List Git branches
+- `git_checkout` - Switch/create branches
+- `git_pull` - Pull changes from remote
+- `git_push` - Push commits to remote
+- `git_stash` - Manage Git stashes
+
+### Changed
+- AL Language Server now supports rename operations (`workspace/rename`)
+- Added `findSymbolByName` and `getSymbolAtPosition` methods to ALLanguageServer
+- Tool router now supports 30+ new local tools
+
+## [0.1.5] - 2024-12-26
+
+### Added
+- **NEW**: `al_get_started` tool - Single entry point for AL development
+  - Shows workspace status (detected or not)
+  - Shows AL Language Server status
+  - Shows cloud connection status
+  - Lists all available prompts/workflows from PartnerCore MCP
+  - Provides step-by-step quick start guide
+  - Lists available local and cloud tools
+  - Includes helpful tips for AL development
+
+### Changed
+- CloudRelayClient now supports fetching prompts from cloud MCP
+- Added `getPrompts()` and `getStatus()` methods to CloudRelayClient
+
+## [0.1.4] - 2024-12-26
+
+### Fixed
+- Fixed absolute path handling in `sanitizePath` - now allows absolute paths within workspace
+- Fixed CLI version display to read from package.json dynamically
+
 ## [0.1.1] - 2024-12-26
 
 ### Changed
@@ -18,7 +149,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Fixed
 - Removed hardcoded workspace path requirement in MCP configuration
-- Proxy now works seamlessly without manual workspace configuration, similar to other MCP servers
+- Proxy now works seamlessly without manual workspace configuration
 
 ## [0.1.0] - 2024-12-26
 
@@ -60,8 +191,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - 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
-
+- Path traversal prevention in file operations
+- API keys never logged
+- HTTPS-only cloud communication
+- Workspace sandboxing for file access

package/README.md

@@ -1,46 +1,42 @@
-# @ciellos/partnercore-proxy
+# PartnerCore Proxy
 
-**Local MCP proxy for Microsoft Dynamics 365 Business Central AL development**
+**Complete MCP server for Business Central AL development**
 
-[![npm version](https://img.shields.io/npm/v/@ciellos/partnercore-proxy.svg)](https://www.npmjs.com/package/@ciellos/partnercore-proxy)
+[![npm version](https://img.shields.io/npm/v/partnercore-proxy.svg)](https://www.npmjs.com/package/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:
+PartnerCore Proxy is a comprehensive MCP (Model Context Protocol) server that brings professional AL development capabilities to AI assistants. It provides:
 
-- **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
+- **Full AL Language Server** - Complete LSP integration with real compiler diagnostics
+- **BC Container Management** - Create, compile, publish, and test in Docker containers
+- **Git Operations** - Version control directly from AI agents
+- **Project Memory** - Persistent context across sessions
+- **Cloud AI Tools** - Code review, knowledge base, templates (optional)
 
 ## Quick Start
 
-### Global Installation
+### Installation
 
 ```bash
-npm install -g @ciellos/partnercore-proxy
-```
-
-### Run with npx (no install)
-
-```bash
-npx @ciellos/partnercore-proxy start --workspace /path/to/al-project
+npm install -g partnercore-proxy
 ```
 
 ### MCP Configuration
 
 Add to your AI assistant's MCP configuration:
 
-**Cursor (`~/.cursor/mcp.json`):**
+**Cursor** (`~/.cursor/mcp.json` or `%USERPROFILE%\.cursor\mcp.json`):
+
 ```json
 {
   "mcpServers": {
-    "partnercore": {
-      "command": "npx",
-      "args": ["@ciellos/partnercore-proxy", "start"],
+    "partnercore-proxy": {
+      "type": "stdio",
+      "command": "partnercore-proxy",
+      "args": ["start"],
       "env": {
-        "AL_WORKSPACE_ROOT": "/path/to/your/al-project",
         "PARTNERCORE_API_KEY": "your-api-key"
       }
     }
@@ -48,13 +44,14 @@ Add to your AI assistant's MCP configuration:
 }
 ```
 
-**Claude Desktop (`claude_desktop_config.json`):**
+**Claude Desktop** (`claude_desktop_config.json`):
+
 ```json
 {
   "mcpServers": {
-    "partnercore": {
+    "partnercore-proxy": {
       "command": "partnercore-proxy",
-      "args": ["start", "--workspace", "/path/to/al-project"],
+      "args": ["start"],
       "env": {
         "PARTNERCORE_API_KEY": "your-api-key"
       }
@@ -63,78 +60,138 @@ Add to your AI assistant's MCP configuration:
 }
 ```
 
+### First Steps
+
+Once configured, start with:
+
+```
+al_get_started
+```
+
+This shows workspace status, available tools, and suggested workflows.
+
 ## Features
 
-### Local Tools (No API Key Required)
+### AL Language Server (57 Tools)
+
+| Category | Tools |
+|----------|-------|
+| **Core LSP** | `al_get_symbols`, `al_find_symbol`, `al_find_references`, `al_go_to_definition`, `al_hover`, `al_completion`, `al_get_diagnostics` |
+| **Code Actions** | `al_code_actions`, `al_signature_help`, `al_format`, `al_format_on_type` |
+| **Navigation** | `al_type_definition`, `al_implementation`, `al_document_highlight` |
+| **Symbol Editing** | `al_rename_symbol`, `al_insert_after_symbol`, `al_insert_before_symbol`, `al_replace_symbol_body`, `al_find_referencing_symbols` |
+| **Document** | `al_folding_ranges`, `al_selection_range`, `al_code_lens`, `al_document_links`, `al_semantic_tokens` |
+| **Lifecycle** | `al_close_document`, `al_save_document`, `al_restart_server`, `al_execute_command` |
+
+### BC Container Tools
 
 | 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 |
+| `bc_list_containers` | List all BC Docker containers |
+| `bc_create_container` | Create new BC container |
+| `bc_remove_container` | Remove a container |
+| `bc_start_container` | Start a stopped container |
+| `bc_stop_container` | Stop a running container |
+| `bc_restart_container` | Restart a container |
+| `bc_compile` | Compile AL project with CodeCops |
+| `bc_publish` | Publish app to container |
+| `bc_run_tests` | Run automated tests |
+| `bc_container_logs` | Get container logs |
+| `bc_download_symbols` | Download symbol files |
+| `bc_get_extensions` | List installed apps |
+| `bc_uninstall_app` | Uninstall an app |
+
+### Git Operations
+
+| Tool | Description |
+|------|-------------|
+| `git_status` | Current Git status with branch info |
+| `git_diff` | Show changes (staged/unstaged) |
+| `git_stage` | Stage files for commit |
+| `git_unstage` | Unstage files |
+| `git_commit` | Commit staged changes |
+| `git_log` | Show commit history |
+| `git_branches` | List branches |
+| `git_checkout` | Switch/create branches |
+| `git_pull` | Pull from remote |
+| `git_push` | Push to remote |
+| `git_stash` | Manage stashes |
+
+### File Operations
+
+| Tool | Description |
+|------|-------------|
+| `read_file` | Read file contents |
+| `write_file` | Write/create files |
+| `list_files` | List directory contents |
+| `search_files` | Search text in files |
+| `find_file` | Find files by pattern |
+| `replace_content` | Search/replace with regex |
+| `delete_lines` | Delete line range |
+| `replace_lines` | Replace line range |
+| `insert_at_line` | Insert at line number |
+
+### Project Memory
+
+| Tool | Description |
+|------|-------------|
+| `write_memory` | Save project knowledge |
+| `read_memory` | Read a memory |
+| `list_memories` | List all memories |
+| `delete_memory` | Delete a memory |
+| `edit_memory` | Edit with search/replace |
 
 ### 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 |
+| `partnercore_review` | AI code review (252+ patterns) |
+| `partnercore_kb_search` | Knowledge base search |
+| `partnercore_template` | Production-ready templates |
+| `partnercore_generate` | Generate AL code |
+| `partnercore_validate` | AppSource compliance check |
+
+## Recommended Workflow
+
+```
+1. al_get_started         → See available tools and status
+2. partnercore_kb_search  → Search for best practices  
+3. partnercore_template   → Get code template
+4. write_file             → Write the AL code
+5. al_get_diagnostics     → Check compilation errors (ALWAYS!)
+6. partnercore_review     → Code review
+7. bc_compile             → Compile in container
+8. bc_publish             → Deploy to container
+9. git_commit             → Save your work
+```
 
 ## 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)
+# Start the MCP server
+partnercore-proxy start
 
 # Check configuration
 partnercore-proxy check
 
 # Download/update AL extension
 partnercore-proxy download-extension
+
+# Show version
+partnercore-proxy --version
 ```
 
 ## 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.
+| `PARTNERCORE_API_KEY` | For cloud | API key for cloud tools |
+| `AL_WORKSPACE_ROOT` | No | Override workspace (auto-detected) |
+| `LOG_LEVEL` | No | debug, info, warn, error |
 
-### Environment Endpoints
+### Automatic Workspace Detection
 
-| 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
-```
+The proxy automatically finds your AL workspace by looking for `app.json`. No hardcoded paths needed!
 
 ## Architecture
 
@@ -145,90 +202,71 @@ partnercore-proxy start
                                     │
                                     ▼ 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)         │  │
-│  └───────────────────────────────────────────────────────────────┘  │
+│                       PartnerCore Proxy                              │
+│  ┌──────────────────┐  ┌──────────────────┐  ┌──────────────────┐  │
+│  │  AL Language     │  │  BC Container    │  │  Git Operations  │  │
+│  │  Server (LSP)    │  │  (BcContainerHelper) │  │  (Git CLI)   │  │
+│  └──────────────────┘  └──────────────────┘  └──────────────────┘  │
+│  ┌──────────────────┐  ┌──────────────────┐  ┌──────────────────┐  │
+│  │  File System     │  │  Project Memory  │  │  Cloud Relay     │  │
+│  │  (Sandboxed)     │  │  (JSON Files)    │  │  (PartnerCore)   │  │
+│  └──────────────────┘  └──────────────────┘  └──────────────────┘  │
 └─────────────────────────────────────────────────────────────────────┘
-                │                              │
-                ▼                              ▼
-    ┌──────────────────┐           ┌─────────────────────────────────┐
-    │   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.
+- **File Sandboxing** - All file operations restricted to workspace
+- **Path Traversal Prevention** - Blocked at multiple levels
+- **API Key Protection** - Never logged, HTTPS only
+- **Memory Isolation** - Project memories stored in `.partnercore/`
 
-## 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
+## Requirements
 
-**Without an API key**, you can still use all local AL Language Server features!
+- **Node.js** 18.0.0 or higher
+- **Windows/macOS/Linux** for AL Language Server
+- **Docker** for BC Container tools (optional)
+- **Git** for Git operations (optional)
+- **BcContainerHelper** PowerShell module for container tools (optional)
 
 ## 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
+- Ensure `app.json` exists in your project
+- Run `partnercore-proxy download-extension`
 
-### Cloud tools return "Cloud client not configured"
-- Set `PARTNERCORE_API_KEY` environment variable
+### Cloud tools return errors
+- Check `PARTNERCORE_API_KEY` is set
 - Verify with `partnercore-proxy check`
 
+### Container tools fail
+- Install BcContainerHelper: `Install-Module BcContainerHelper -Force`
+- Ensure Docker Desktop is running
+
 ### Verbose logging
 ```bash
-partnercore-proxy start --verbose
+LOG_LEVEL=debug partnercore-proxy start
 ```
 
-## Requirements
-
-- **Node.js**: 18.0.0 or higher
-- **Operating System**: Windows, macOS, or Linux
-- **AL Project**: Valid `app.json` in workspace
+## Workflows
 
-## Contributing
+See [docs/WORKFLOWS.md](../docs/WORKFLOWS.md) for complete workflow diagrams:
 
-Contributions are welcome! Please see [CONTRIBUTING.md](./CONTRIBUTING.md).
-
-## License
-
-MIT - see [LICENSE](./LICENSE)
+| Workflow | Tools |
+|----------|-------|
+| **New AL Object** | KB search → template → write → diagnostics → review |
+| **Code Review** | read → symbols → diagnostics → review → improve |
+| **BC Container** | list → compile → publish → run tests |
+| **Git** | status → diff → stage → commit → push |
+| **Refactoring** | symbols → references → rename → format → diagnostics |
+| **Project Memory** | write → list → read (persist across sessions) |
 
 ## Links
 
 - [PartnerCore Cloud](https://partnercore.ai)
-- [Ciellos](https://ciellos.com)
-- [GitHub Repository](https://github.com/ciellos-dev/partnercore-proxy)
+- [npm Package](https://www.npmjs.com/package/partnercore-proxy)
 - [MCP Specification](https://modelcontextprotocol.io)
+
+## License
+
+MIT