LOCALHOST1978/XCPSSKPlugin/ARCHITECTURE.md

XCPSSKPlugin Architecture

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

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

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

                     Apple Xcode IDE
                            │
                            ▼
                    XCPSSKPlugin.xcplugin
                            │
                            ▼ (Spawns Process)
                     SSK_StorageHost
                       (acp-agent)