LOCALHOST1978/XCPSSKPlugin/README.md

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:

┌────────────────────────────────────────────────────────────────────────┐
│ 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:

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.