# tigeilen/pa-code architecture

> Architecture diagram of the GitHub repository tigeilen/pa-code, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tigeilen/pa-code
- Repository: https://github.com/tigeilen/pa-code

## Overview

PA-Code is a VS Code IDE extension for IBM Planning Analytics/TM1. The main workflow is configure an environment, connect to a TM1 instance, browse and open processes or rules, edit locally, then save changes to the server or run and debug processes. Separate branches cover language assistance, MDX and cube work, administration, and MCP access. The README documents product behavior; source evidence is sampled or limited to SOURCE INDEX references, so unsampled implementation details and links are omitted where unverified.

Main entry points: [`src/TM1Service.ts`](https://github.com/tigeilen/pa-code/blob/main/src/TM1Service.ts) (TM1 REST Service), [`src/extension.ts`](https://github.com/tigeilen/pa-code/blob/main/src/extension.ts) (VS Code Extension), [`src/ProcessProvider.ts`](https://github.com/tigeilen/pa-code/blob/main/src/ProcessProvider.ts) (Process Browser), [`src/TM1DebugAdapter.ts`](https://github.com/tigeilen/pa-code/blob/main/src/TM1DebugAdapter.ts) (TI Debugger)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Extension &amp; Setup"]
  node_extension["VS Code Extension<br/>[extension.ts]"]
  node_settings["Environment Settings<br/>[SettingsPanel.ts]"]
  node_config[("Configuration Store<br/>[ConfigManager.ts]")]
end

subgraph group_process["Process Development"]
  node_process_tree["Process Browser<br/>[ProcessProvider.ts]"]
  node_process_parser["TI Process Parser<br/>[processParser.ts]"]
  node_process_files["Local Process Files<br/>[extension.ts]"]
  node_execution["Process Execution"]
  node_debugger["TI Debugger<br/>[TM1DebugAdapter.ts]"]
end

subgraph group_language["Language Tools"]
  node_completion["TI Completion"]
  node_function_data["Function Reference Data"]
  node_formatter["TI Formatter<br/>[TM1Formatter.ts]"]
end

subgraph group_data["Cube &amp; MDX"]
  node_mdx_wizard["MDX Wizard<br/>[MDXWizardPanel.ts]"]
  node_mdx_builder["MDX Builder Backend<br/>[MDXBuilder.ts]"]
  node_subset_editor["Subset Editor"]
  node_cube_viewer["Cube Viewer<br/>[CubeViewerPanel.ts]"]
end

subgraph group_admin["Server Management"]
  node_deployment["Deployment Assistant<br/>[DeploymentPanel.ts]"]
  node_bulk_delete["Bulk Delete<br/>[BulkDeletePanel.ts]"]
  node_chore_manager["Chore Manager"]
  node_security["Security Manager<br/>[SecurityPanel.ts]"]
  node_logs_threads_files["Logs, Threads &amp; Files"]
end

subgraph group_integration["API &amp; Integrations"]
  node_tm1_service["TM1 REST Service<br/>[TM1Service.ts]"]
  node_read_api["MCP Read API<br/>[Tm1ReadApi.ts]"]
  node_write_api["MCP Write API<br/>[Tm1WriteApi.ts]"]
  node_mcp["MCP Server<br/>[Tm1McpServer.ts]"]
end

node_developer(("TM1 Developer"))
node_tm1[("TM1 Server")]
node_mcp_client(("MCP Client"))

node_developer -->|"uses"| node_extension
node_extension -->|"opens"| node_settings
node_settings -->|"saves settings"| node_config
node_extension -->|"registers"| node_process_tree
node_process_tree -->|"loads objects"| node_tm1_service
node_process_tree -->|"opens local files"| node_process_files
node_developer -->|"edits"| node_process_files
node_process_files -->|"parses TI sections"| node_process_parser
node_process_files -->|"pushes saved changes"| node_tm1_service
node_developer -->|"runs process"| node_execution
node_execution -.->|"executes on"| node_tm1_service
node_developer -->|"starts debugging"| node_debugger
node_debugger -->|"maps section offsets"| node_process_parser
node_debugger -->|"debugs process"| node_tm1_service
node_extension -->|"registers"| node_completion
node_completion -.->|"uses function data"| node_function_data
node_developer -->|"formats code"| node_formatter
node_developer -->|"builds MDX"| node_mdx_wizard
node_mdx_wizard -->|"delegates builder requests"| node_mdx_builder
node_subset_editor -->|"delegates builder requests"| node_mdx_builder
node_cube_viewer -->|"delegates builder requests"| node_mdx_builder
node_developer -->|"deploys objects"| node_deployment
node_developer -->|"deletes objects"| node_bulk_delete
node_developer -->|"manages chores"| node_chore_manager
node_developer -->|"manages security"| node_security
node_developer -->|"views server data"| node_logs_threads_files
node_deployment -->|"uses"| node_tm1_service
node_bulk_delete -->|"uses"| node_tm1_service
node_chore_manager -->|"uses"| node_tm1_service
node_security -->|"uses"| node_tm1_service
node_tm1_service -->|"sends REST requests"| node_tm1
node_mcp -->|"dispatches reads"| node_read_api
node_mcp -->|"dispatches writes"| node_write_api
node_mcp_client -.->|"sends MCP requests"| node_mcp
node_read_api -->|"uses"| node_tm1_service
node_write_api -->|"uses"| node_tm1_service

click node_extension "https://github.com/tigeilen/pa-code/blob/main/src/extension.ts"
click node_settings "https://github.com/tigeilen/pa-code/blob/main/src/SettingsPanel.ts"
click node_config "https://github.com/tigeilen/pa-code/blob/main/src/ConfigManager.ts"
click node_process_tree "https://github.com/tigeilen/pa-code/blob/main/src/ProcessProvider.ts"
click node_process_parser "https://github.com/tigeilen/pa-code/blob/main/src/processParser.ts"
click node_process_files "https://github.com/tigeilen/pa-code/blob/main/src/extension.ts"
click node_execution "https://github.com/tigeilen/pa-code/blob/main/src/ProcessExecutionPanel.ts"
click node_debugger "https://github.com/tigeilen/pa-code/blob/main/src/TM1DebugAdapter.ts"
click node_completion "https://github.com/tigeilen/pa-code/blob/main/src/TM1CompletionProvider.ts"
click node_function_data "https://github.com/tigeilen/pa-code/blob/main/src/TM1FunctionDatabase.ts"
click node_formatter "https://github.com/tigeilen/pa-code/blob/main/src/TM1Formatter.ts"
click node_mdx_wizard "https://github.com/tigeilen/pa-code/blob/main/src/MDXWizardPanel.ts"
click node_mdx_builder "https://github.com/tigeilen/pa-code/blob/main/src/MDXBuilder.ts"
click node_subset_editor "https://github.com/tigeilen/pa-code/blob/main/src/SubsetEditorPanel.ts"
click node_cube_viewer "https://github.com/tigeilen/pa-code/blob/main/src/CubeViewerPanel.ts"
click node_deployment "https://github.com/tigeilen/pa-code/blob/main/src/DeploymentPanel.ts"
click node_bulk_delete "https://github.com/tigeilen/pa-code/blob/main/src/BulkDeletePanel.ts"
click node_chore_manager "https://github.com/tigeilen/pa-code/blob/main/src/ChoreManagerPanel.ts"
click node_security "https://github.com/tigeilen/pa-code/blob/main/src/SecurityPanel.ts"
click node_logs_threads_files "https://github.com/tigeilen/pa-code/blob/main/src/ThreadViewerPanel.ts"
click node_tm1_service "https://github.com/tigeilen/pa-code/blob/main/src/TM1Service.ts"
click node_read_api "https://github.com/tigeilen/pa-code/blob/main/src/Tm1ReadApi.ts"
click node_write_api "https://github.com/tigeilen/pa-code/blob/main/src/Tm1WriteApi.ts"
click node_mcp "https://github.com/tigeilen/pa-code/blob/main/src/mcp/Tm1McpServer.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_extension,node_settings,node_config,node_mcp_client toneBlue
class node_process_tree,node_process_parser,node_process_files,node_execution,node_debugger,node_tm1 toneAmber
class node_completion,node_function_data,node_formatter toneMint
class node_mdx_wizard,node_mdx_builder,node_subset_editor,node_cube_viewer toneRose
class node_deployment,node_bulk_delete,node_chore_manager,node_security,node_logs_threads_files,node_developer toneIndigo
class node_tm1_service,node_read_api,node_write_api,node_mcp toneTeal
```

## Components

### Extension & Setup

- [VS Code Extension](https://github.com/tigeilen/pa-code/blob/main/src/extension.ts): `src/extension.ts`
- [Environment Settings](https://github.com/tigeilen/pa-code/blob/main/src/SettingsPanel.ts): `src/SettingsPanel.ts`
- [Configuration Store](https://github.com/tigeilen/pa-code/blob/main/src/ConfigManager.ts): `src/ConfigManager.ts`

### Process Development

- [Process Browser](https://github.com/tigeilen/pa-code/blob/main/src/ProcessProvider.ts): `src/ProcessProvider.ts`
- [TI Process Parser](https://github.com/tigeilen/pa-code/blob/main/src/processParser.ts): `src/processParser.ts`
- [Local Process Files](https://github.com/tigeilen/pa-code/blob/main/src/extension.ts): `src/extension.ts`
- [Process Execution](https://github.com/tigeilen/pa-code/blob/main/src/ProcessExecutionPanel.ts): `src/ProcessExecutionPanel.ts`
- [TI Debugger](https://github.com/tigeilen/pa-code/blob/main/src/TM1DebugAdapter.ts): `src/TM1DebugAdapter.ts`

### Language Tools

- [TI Completion](https://github.com/tigeilen/pa-code/blob/main/src/TM1CompletionProvider.ts): `src/TM1CompletionProvider.ts`
- [Function Reference Data](https://github.com/tigeilen/pa-code/blob/main/src/TM1FunctionDatabase.ts): `src/TM1FunctionDatabase.ts`
- [TI Formatter](https://github.com/tigeilen/pa-code/blob/main/src/TM1Formatter.ts): `src/TM1Formatter.ts`

### Cube & MDX

- [MDX Wizard](https://github.com/tigeilen/pa-code/blob/main/src/MDXWizardPanel.ts): `src/MDXWizardPanel.ts`
- [MDX Builder Backend](https://github.com/tigeilen/pa-code/blob/main/src/MDXBuilder.ts): `src/MDXBuilder.ts`
- [Subset Editor](https://github.com/tigeilen/pa-code/blob/main/src/SubsetEditorPanel.ts): `src/SubsetEditorPanel.ts`
- [Cube Viewer](https://github.com/tigeilen/pa-code/blob/main/src/CubeViewerPanel.ts): `src/CubeViewerPanel.ts`

### Server Management

- [Deployment Assistant](https://github.com/tigeilen/pa-code/blob/main/src/DeploymentPanel.ts): `src/DeploymentPanel.ts`
- [Bulk Delete](https://github.com/tigeilen/pa-code/blob/main/src/BulkDeletePanel.ts): `src/BulkDeletePanel.ts`
- [Chore Manager](https://github.com/tigeilen/pa-code/blob/main/src/ChoreManagerPanel.ts): `src/ChoreManagerPanel.ts`
- [Security Manager](https://github.com/tigeilen/pa-code/blob/main/src/SecurityPanel.ts): `src/SecurityPanel.ts`
- [Logs, Threads & Files](https://github.com/tigeilen/pa-code/blob/main/src/ThreadViewerPanel.ts): `src/ThreadViewerPanel.ts`

### API & Integrations

- [TM1 REST Service](https://github.com/tigeilen/pa-code/blob/main/src/TM1Service.ts): `src/TM1Service.ts`
- [MCP Read API](https://github.com/tigeilen/pa-code/blob/main/src/Tm1ReadApi.ts): `src/Tm1ReadApi.ts`
- [MCP Write API](https://github.com/tigeilen/pa-code/blob/main/src/Tm1WriteApi.ts): `src/Tm1WriteApi.ts`
- [MCP Server](https://github.com/tigeilen/pa-code/blob/main/src/mcp/Tm1McpServer.ts): `src/mcp/Tm1McpServer.ts`

### Other components

- **TM1 Developer**
- **TM1 Server**
- **MCP Client**

## Connections

- TM1 Developer → VS Code Extension: uses
- VS Code Extension → Environment Settings: opens (evidence: `src/extension.ts`)
- Environment Settings → Configuration Store: saves settings (evidence: `src/SettingsPanel.ts`)
- VS Code Extension → Process Browser: registers (evidence: `src/extension.ts`)
- Process Browser → TM1 REST Service: loads objects (evidence: `src/ProcessProvider.ts`)
- Process Browser → Local Process Files: opens local files (evidence: `src/extension.ts`)
- TM1 Developer → Local Process Files: edits
- Local Process Files → TI Process Parser: parses TI sections (evidence: `src/extension.ts`)
- Local Process Files → TM1 REST Service: pushes saved changes (evidence: `src/extension.ts`)
- TM1 Developer → Process Execution: runs process
- Process Execution → TM1 REST Service: executes on
- TM1 Developer → TI Debugger: starts debugging
- TI Debugger → TI Process Parser: maps section offsets (evidence: `src/TM1DebugAdapter.ts`)
- TI Debugger → TM1 REST Service: debugs process (evidence: `src/TM1DebugAdapter.ts`)
- VS Code Extension → TI Completion: registers (evidence: `src/extension.ts`)
- TI Completion → Function Reference Data: uses function data
- TM1 Developer → TI Formatter: formats code
- TM1 Developer → MDX Wizard: builds MDX
- MDX Wizard → MDX Builder Backend: delegates builder requests (evidence: `src/MDXWizardPanel.ts`)
- Subset Editor → MDX Builder Backend: delegates builder requests (evidence: `src/SubsetEditorPanel.ts`)
- Cube Viewer → MDX Builder Backend: delegates builder requests (evidence: `src/CubeViewerPanel.ts`)
- TM1 Developer → Deployment Assistant: deploys objects
- TM1 Developer → Bulk Delete: deletes objects
- TM1 Developer → Chore Manager: manages chores
- TM1 Developer → Security Manager: manages security
- TM1 Developer → Logs, Threads & Files: views server data
- Deployment Assistant → TM1 REST Service: uses (evidence: `src/DeploymentPanel.ts`)
- Bulk Delete → TM1 REST Service: uses (evidence: `src/BulkDeletePanel.ts`)
- Chore Manager → TM1 REST Service: uses (evidence: `src/ChoreManagerPanel.ts`)
- Security Manager → TM1 REST Service: uses (evidence: `src/SecurityPanel.ts`)
- TM1 REST Service → TM1 Server: sends REST requests (evidence: `src/TM1Service.ts`)
- MCP Server → MCP Read API: dispatches reads (evidence: `src/mcp/Tm1McpServer.ts`)
- MCP Server → MCP Write API: dispatches writes (evidence: `src/mcp/Tm1McpServer.ts`)
- MCP Client → MCP Server: sends MCP requests
- MCP Read API → TM1 REST Service: uses (evidence: `src/Tm1ReadApi.ts`)
- MCP Write API → TM1 REST Service: uses (evidence: `src/Tm1WriteApi.ts`)
