localhost1978's picture
|
download
raw
2.66 kB
# XCPSSKPlugin Architecture
> [!IMPORTANT]
> **Version Control and State Tracking Rule**:
> This repository exclusively uses **`lore`** for version control, state management, and documentation tracking. **Do NOT use `git`**.
---
## 1. Overview and Purpose
`XCPSSKPlugin` is an Apple Xcode developer plug-in bundle target (`XCPSSKPlugin.xcplugin`) in the **SovereignSurvivalKit** architecture.
It bridges Xcode Coding Intelligence with SovereignSurvivalKit's local documentation and agent intelligence subsystems by launching the canonical agent `SSK_StorageHost acp-agent` over standard input/output (`stdio`).
---
## 2. Directory Layout and Components
```text
src/SovereignSurvivalKit/XCPSSKPlugin/
├── ARCHITECTURE.md # Component architecture documentation
├── XCPSSKPlugin.swift # Plug-in entry point launching SSK_StorageHost acp-agent
├── ssk-intelligence-plugin.json # MCP server configuration descriptor
├── Info.plist # Plug-in bundle manifest
└── SSK_DocGen # Symlinked reference to the doc generation tool
```
---
## 3. Execution Architecture
```text
Xcode Coding Intelligence
│ (Spawns XCPSSKPlugin / MCP Session)
▼
XCPSSKPlugin.swift (run())
│ (Pipes stdio to embedded resource)
▼
./Resources/SSK_StorageHost acp-agent
│ (Mach XPC via com.ssk.vaulthost)
▼
SSKVaultHost Daemon -> SSK_DocGen
```
### 1. `XCPSSKPlugin.swift`
- Locates `SSK_StorageHost` in the bundle resources directory (`pluginBundle.resourceURL`).
- Launches a child `Process` with arguments `["acp-agent"]`.
- Binds `standardInput`, `standardOutput`, and `standardError` to facilitate bi-directional JSON-RPC Model Context Protocol messaging with Xcode.
### 2. `ssk-intelligence-plugin.json`
- Defines the MCP server configuration for IDE integration, declaring `command: "./Resources/SSK_StorageHost"` and `args: ["acp-agent"]`.
---
## 4. Dependencies
### Framework Dependencies
- **`Foundation`**: Bundle resource resolution, process launching, and stream management.
- **`Objective-C Runtime`**: `@objc class XCPSSKPlugin` interface for Xcode plug-in loading.
### Internal Product Dependencies
- **`SSK_StorageHost`**: Embedded executable resource providing the MCP server surface.
---
## 5. Architectural Position
```text
Apple Xcode IDE
│
▼
XCPSSKPlugin.xcplugin
│
▼ (Spawns Process)
SSK_StorageHost
(acp-agent)
```

Xet Storage Details

Size:
2.66 kB
·
Xet hash:
faf7b9b3f75c516a62df7fe188a22bc66ca9668bc3a2871f85ccd5bda22c29d3

Xet efficiently stores files, intelligently splitting them into unique chunks and accelerating uploads and downloads. More info.