localhost1978's picture
|
download
raw
4.63 kB
# XCPSSKPlugin
`XCPSSKPlugin` is the Xcode developer plug-in bundle target (`XCPSSKPlugin.xcplugin`) that integrates SovereignSurvivalKit with Apple Xcode Coding Intelligence via the Agent Client Protocol (ACP) and Model Context Protocol (MCP).
---
## 1. Xcode Intelligence Preferences Configuration
To configure SovereignSurvivalKit as an ACP Coding Agent in Xcode (**Xcode Settings > Intelligence > Add an ACP Agent**), use the following configuration parameters:
```text
┌────────────────────────────────────────────────────────────────────────┐
│ Add an ACP Agent │
├───────────────────────┬────────────────────────────────────────────────┤
│ Name │ SovereignSurvivalKit │
├───────────────────────┼────────────────────────────────────────────────┤
│ Executable │ /usr/local/bin/SSK_StorageHost │
├───────────────────────┼────────────────────────────────────────────────┤
│ Interpreter │ (Leave Blank) │
├───────────────────────┼────────────────────────────────────────────────┤
│ Arguments │ acp-agent │
├───────────────────────┼────────────────────────────────────────────────┤
│ Environment Variables │ (Leave Blank) │
└───────────────────────┴────────────────────────────────────────────────┘
```
### Field Breakdown
| Field | Configuration Value | Description |
| :--- | :--- | :--- |
| **Name** | `SovereignSurvivalKit` *(or `SSK_StorageHost`)* | Display identifier in Xcode's agent list. |
| **Executable** | `/usr/local/bin/SSK_StorageHost` | Path to the canonical agent binary installed on the host. |
| **Interpreter** | *(blank / optional)* | `SSK_StorageHost` is a compiled native Mach-O binary and does not require a script interpreter. |
| **Arguments** | `acp-agent` | Single CLI argument directing `SSK_StorageHost` to launch the external ACP/MCP facade. |
| **Environment Variables** | *(none)* | Stored configuration and vault paths are managed securely by the `SSKVaultHost` daemon. |
#### Alternative Executable Paths
If you are developing or running outside the default `/usr/local/bin` installation:
* **Installed Application Bundle:** `/Applications/SSKVaultHost.app/Contents/MacOS/SSK_StorageHost`
* **Installed Xcode Plug-in Resource:** `~/Library/Developer/Xcode/Plug-ins/XCPSSKPlugin.xcplugin/Contents/Resources/SSK_StorageHost`
* **Local Build Products:** `dist/Products/usr/local/bin/SSK_StorageHost`
---
## 2. Architecture & Execution Flow
When Xcode Coding Intelligence initiates an ACP agent session, communication flows across strict system boundaries:
```text
Xcode Coding Intelligence
│ (stdio JSON-RPC)
▼
SSK_StorageHost acp-agent (External MCP Facade)
│ (Mach XPC via com.ssk.vaulthost)
▼
SSKVaultHost Daemon (Validates Audit Token & Code Signature)
│ (Private Worker Process)
▼
SSK_DocGen (Isolated Resource Worker)
│ (Descriptor-Relative Read)
▼
Approved Documentation Ledger (SSK_Ledger_Vault)
```
---
## 3. Plug-in Files
* **`XCPSSKPlugin.swift`**: Plug-in entry point that locates `SSK_StorageHost` in the bundle resources and binds `stdin`, `stdout`, and `stderr`.
* **`ssk-intelligence-plugin.json`**: MCP descriptor declaring command `./Resources/SSK_StorageHost` with arguments `["acp-agent"]`.
* **`Info.plist`**: Bundle manifest declaring `CFBundlePackageType = BNDL` and `XcodePluginBaseClass = XCPSSKPlugin`.

Xet Storage Details

Size:
4.63 kB
·
Xet hash:
1775c92a047baa8020722a5bccafd119f9049c3bf3947552db783e597618d2d5

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