{
  "summary": {
    "generatedAt": "2026-03-11T17:31:18.119Z",
    "httpRoutes": 118,
    "sseRoutes": 3,
    "modularRoutes": 96,
    "inlineRoutes": 25,
    "routeFilesScanned": 16
  },
  "realtimeContracts": {
    "incomingMessageTypes": [
      "abort-session",
      "check-session-status",
      "claude-command",
      "claude-permission-response",
      "codex-command",
      "cursor-abort",
      "cursor-command",
      "cursor-resume",
      "gemini-command",
      "get-active-sessions",
      "get-pending-permissions",
      "init",
      "input",
      "resize"
    ],
    "outgoingMessageTypes": [
      "active-sessions",
      "auth_url",
      "error",
      "output",
      "pending-permissions-response",
      "session-aborted",
      "session-status"
    ]
  },
  "records": [
    {
      "transport": "http",
      "method": "GET",
      "path": "/health",
      "tag": "System",
      "authMode": "public",
      "sourceFile": "server/index.js",
      "sourceLine": 345,
      "purpose": "Expose server health, timestamp, and install mode for diagnostics.",
      "consumerFiles": [
        "src/hooks/useVersionCheck.ts"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "Handler-specific error behavior.",
      "sideEffects": [
        "Read-only backend query."
      ],
      "priority": "low"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/system/update",
      "tag": "System",
      "authMode": "bearer_token",
      "sourceFile": "server/index.js",
      "sourceLine": 425,
      "purpose": "Run the application update workflow on the host machine.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Mutates backend or external state."
      ],
      "priority": "low"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/projects",
      "tag": "Projects",
      "authMode": "bearer_token",
      "sourceFile": "server/index.js",
      "sourceLine": 491,
      "purpose": "List detected projects and workspaces.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "JSON payload returned directly from service logic.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Touches local workspace files or directories."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/projects/:projectName/sessions",
      "tag": "Sessions",
      "authMode": "bearer_token",
      "sourceFile": "server/index.js",
      "sourceLine": 500,
      "purpose": "List or manage sessions associated with a project or provider.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "projectName"
        ],
        "queryParams": [
          "offset",
          "try {\r\n        const { limit"
        ],
        "bodyHints": []
      },
      "successShape": "JSON payload returned directly from service logic.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Touches local workspace files or directories."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/projects/:projectName/sessions/:sessionId/messages",
      "tag": "Sessions",
      "authMode": "bearer_token",
      "sourceFile": "server/index.js",
      "sourceLine": 512,
      "purpose": "Return paginated messages for a stored session.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "projectName",
          "sessionId"
        ],
        "queryParams": [
          "limit",
          "offset"
        ],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Touches local workspace files or directories."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "PUT",
      "path": "/api/projects/:projectName/rename",
      "tag": "Projects",
      "authMode": "bearer_token",
      "sourceFile": "server/index.js",
      "sourceLine": 537,
      "purpose": "PUT /api/projects/:projectName/rename for backend runtime support.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "projectName"
        ],
        "queryParams": [],
        "bodyHints": [
          "try {\r\n        const { displayName"
        ]
      },
      "successShape": "JSON object with an explicit success flag and payload.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Touches local workspace files or directories."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "DELETE",
      "path": "/api/projects/:projectName/sessions/:sessionId",
      "tag": "Sessions",
      "authMode": "bearer_token",
      "sourceFile": "server/index.js",
      "sourceLine": 548,
      "purpose": "List or manage sessions associated with a project or provider.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "projectName",
          "sessionId"
        ],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "JSON object with an explicit success flag and payload.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Touches local workspace files or directories."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "PUT",
      "path": "/api/sessions/:sessionId/rename",
      "tag": "Sessions",
      "authMode": "bearer_token",
      "sourceFile": "server/index.js",
      "sourceLine": 563,
      "purpose": "List or manage sessions associated with a project or provider.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "sessionId"
        ],
        "queryParams": [],
        "bodyHints": [
          "provider",
          "summary"
        ]
      },
      "successShape": "JSON object with an explicit success flag and payload.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state."
      ],
      "priority": "low"
    },
    {
      "transport": "http",
      "method": "DELETE",
      "path": "/api/projects/:projectName",
      "tag": "Projects",
      "authMode": "bearer_token",
      "sourceFile": "server/index.js",
      "sourceLine": 589,
      "purpose": "DELETE /api/projects/:projectName for backend runtime support.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "projectName"
        ],
        "queryParams": [
          "force"
        ],
        "bodyHints": []
      },
      "successShape": "JSON object with an explicit success flag and payload.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Touches local workspace files or directories."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/projects/create",
      "tag": "Projects",
      "authMode": "bearer_token",
      "sourceFile": "server/index.js",
      "sourceLine": 601,
      "purpose": "Manually add a project path to the workspace list.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": [
          "try {\r\n        const { path"
        ]
      },
      "successShape": "JSON object with an explicit success flag and payload.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Touches local workspace files or directories."
      ],
      "priority": "high"
    },
    {
      "transport": "sse",
      "method": "GET",
      "path": "/api/search/conversations",
      "tag": "Sessions",
      "authMode": "bearer_token",
      "sourceFile": "server/index.js",
      "sourceLine": 618,
      "purpose": "Search conversation history across stored projects and stream results.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [
          "limit",
          "q"
        ],
        "bodyHints": []
      },
      "successShape": "Server-sent events stream with progress/result/error events.",
      "errorShape": "Streamed error event or JSON error fallback.",
      "sideEffects": [
        "Read-only backend query."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/browse-filesystem",
      "tag": "Realtime",
      "authMode": "bearer_token",
      "sourceFile": "server/index.js",
      "sourceLine": 674,
      "purpose": "Browse local directories so the UI can suggest workspace locations.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [
          "try {\r\n        const { path"
        ],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Read-only backend query."
      ],
      "priority": "low"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/create-folder",
      "tag": "Projects",
      "authMode": "bearer_token",
      "sourceFile": "server/index.js",
      "sourceLine": 754,
      "purpose": "Create a new directory on the local filesystem.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": [
          "try {\r\n        const { path"
        ]
      },
      "successShape": "JSON object with an explicit success flag and payload.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state."
      ],
      "priority": "low"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/projects/:projectName/file",
      "tag": "Files",
      "authMode": "bearer_token",
      "sourceFile": "server/index.js",
      "sourceLine": 795,
      "purpose": "Read, write, create, rename, delete, or upload project files.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "projectName"
        ],
        "queryParams": [
          "filePath"
        ],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Touches local workspace files or directories."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/projects/:projectName/files/content",
      "tag": "Files",
      "authMode": "bearer_token",
      "sourceFile": "server/index.js",
      "sourceLine": 835,
      "purpose": "Read, write, create, rename, delete, or upload project files.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "projectName"
        ],
        "queryParams": [
          "path"
        ],
        "bodyHints": []
      },
      "successShape": "Mixed response shape; inspect handler during refactor.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Touches local workspace files or directories."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "PUT",
      "path": "/api/projects/:projectName/file",
      "tag": "Files",
      "authMode": "bearer_token",
      "sourceFile": "server/index.js",
      "sourceLine": 888,
      "purpose": "Read, write, create, rename, delete, or upload project files.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "projectName"
        ],
        "queryParams": [],
        "bodyHints": [
          "content",
          "filePath"
        ]
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Touches local workspace files or directories."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/projects/:projectName/files",
      "tag": "Files",
      "authMode": "bearer_token",
      "sourceFile": "server/index.js",
      "sourceLine": 937,
      "purpose": "Read, write, create, rename, delete, or upload project files.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "projectName"
        ],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "JSON payload returned directly from service logic.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Touches local workspace files or directories."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/projects/:projectName/files/create",
      "tag": "Files",
      "authMode": "bearer_token",
      "sourceFile": "server/index.js",
      "sourceLine": 1016,
      "purpose": "Read, write, create, rename, delete, or upload project files.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "projectName"
        ],
        "queryParams": [],
        "bodyHints": [
          "name",
          "path",
          "type"
        ]
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Touches local workspace files or directories."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "PUT",
      "path": "/api/projects/:projectName/files/rename",
      "tag": "Files",
      "authMode": "bearer_token",
      "sourceFile": "server/index.js",
      "sourceLine": 1093,
      "purpose": "Read, write, create, rename, delete, or upload project files.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "projectName"
        ],
        "queryParams": [],
        "bodyHints": [
          "newName",
          "oldPath"
        ]
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Touches local workspace files or directories."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "DELETE",
      "path": "/api/projects/:projectName/files",
      "tag": "Files",
      "authMode": "bearer_token",
      "sourceFile": "server/index.js",
      "sourceLine": 1170,
      "purpose": "Read, write, create, rename, delete, or upload project files.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "projectName"
        ],
        "queryParams": [],
        "bodyHints": [
          "path",
          "relativePaths",
          "targetPath",
          "type"
        ]
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Touches local workspace files or directories."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/projects/:projectName/files/upload",
      "tag": "Files",
      "authMode": "bearer_token",
      "sourceFile": "server/index.js",
      "sourceLine": 1396,
      "purpose": "Read, write, create, rename, delete, or upload project files.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "projectName"
        ],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Mixed response shape; inspect handler during refactor.",
      "errorShape": "Handler-specific error behavior.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Touches local workspace files or directories."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/transcribe",
      "tag": "Realtime",
      "authMode": "bearer_token",
      "sourceFile": "server/index.js",
      "sourceLine": 1964,
      "purpose": "Transcribe uploaded audio and optionally enhance the result for prompts or tasks.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": [
          "mode"
        ]
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Processes uploaded files and external model responses."
      ],
      "priority": "low"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/projects/:projectName/upload-images",
      "tag": "Files",
      "authMode": "bearer_token",
      "sourceFile": "server/index.js",
      "sourceLine": 2113,
      "purpose": "Upload images for chat use and return browser-safe data URLs.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "projectName"
        ],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Touches local workspace files or directories."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/projects/:projectName/sessions/:sessionId/token-usage",
      "tag": "Sessions",
      "authMode": "bearer_token",
      "sourceFile": "server/index.js",
      "sourceLine": 2198,
      "purpose": "Report token usage for a stored provider session.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "projectName",
          "sessionId"
        ],
        "queryParams": [
          "provider"
        ],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Touches local workspace files or directories."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "*",
      "tag": "System",
      "authMode": "public",
      "sourceFile": "server/index.js",
      "sourceLine": 2386,
      "purpose": "Serve the React application fallback for non-API routes.",
      "consumerFiles": [],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Static file or HTML response.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Read-only backend query."
      ],
      "priority": "low"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/auth/status",
      "tag": "Auth",
      "authMode": "public",
      "sourceFile": "server/routes/auth.js",
      "sourceLine": 9,
      "purpose": "Report whether authentication is configured.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Reads or writes local authentication or credential state."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/auth/register",
      "tag": "Auth",
      "authMode": "public",
      "sourceFile": "server/routes/auth.js",
      "sourceLine": 23,
      "purpose": "Create the first local user account.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": [
          "password",
          "try {\r\n    const { username"
        ]
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Reads or writes local authentication or credential state."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/auth/login",
      "tag": "Auth",
      "authMode": "public",
      "sourceFile": "server/routes/auth.js",
      "sourceLine": 82,
      "purpose": "Authenticate a local user and issue a token.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": [
          "password",
          "try {\r\n    const { username"
        ]
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Reads or writes local authentication or credential state."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/auth/user",
      "tag": "Auth",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/auth.js",
      "sourceLine": 122,
      "purpose": "Return the currently authenticated user.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "Handler-specific error behavior.",
      "sideEffects": [
        "Reads or writes local authentication or credential state."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/auth/logout",
      "tag": "Auth",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/auth.js",
      "sourceLine": 129,
      "purpose": "Invalidate the current authenticated session.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "JSON object with an explicit success flag and payload.",
      "errorShape": "Handler-specific error behavior.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Reads or writes local authentication or credential state."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/projects/create-workspace",
      "tag": "Projects",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/projects.js",
      "sourceLine": 175,
      "purpose": "Create or register a workspace and optionally clone a GitHub repository into it.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": [
          "githubTokenId",
          "githubUrl",
          "newGithubToken",
          "path",
          "try {\r\n    const { workspaceType"
        ]
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON validation error response.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Touches local workspace files or directories."
      ],
      "priority": "high"
    },
    {
      "transport": "sse",
      "method": "GET",
      "path": "/api/projects/clone-progress",
      "tag": "Projects",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/projects.js",
      "sourceLine": 335,
      "purpose": "Stream workspace cloning progress events to the frontend.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [
          "const { path",
          "githubTokenId",
          "githubUrl",
          "newGithubToken"
        ],
        "bodyHints": []
      },
      "successShape": "Server-sent events stream with progress/result/error events.",
      "errorShape": "Streamed error event or JSON error fallback.",
      "sideEffects": [
        "Touches local workspace files or directories."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/git/status",
      "tag": "Git",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/git.js",
      "sourceLine": 291,
      "purpose": "Read git status information for a project.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [
          "const { project"
        ],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON validation error response.",
      "sideEffects": [
        "Touches git repositories or local git config."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/git/diff",
      "tag": "Git",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/git.js",
      "sourceLine": 354,
      "purpose": "Return git diff output for a project or file.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [
          "const { project",
          "file"
        ],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON validation error response.",
      "sideEffects": [
        "Touches git repositories or local git config."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/git/file-with-diff",
      "tag": "Git",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/git.js",
      "sourceLine": 437,
      "purpose": "Read, write, create, rename, delete, or upload project files.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [
          "const { project",
          "file"
        ],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON validation error response.",
      "sideEffects": [
        "Touches git repositories or local git config.",
        "Touches local workspace files or directories."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/git/initial-commit",
      "tag": "Git",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/git.js",
      "sourceLine": 517,
      "purpose": "POST /api/git/initial-commit for backend runtime support.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": [
          "const { project"
        ]
      },
      "successShape": "JSON object with an explicit success flag and payload.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Touches git repositories or local git config."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/git/commit",
      "tag": "Git",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/git.js",
      "sourceLine": 561,
      "purpose": "POST /api/git/commit for backend runtime support.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": [
          "const { project",
          "files",
          "message"
        ]
      },
      "successShape": "JSON object with an explicit success flag and payload.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Touches git repositories or local git config."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/git/revert-local-commit",
      "tag": "Git",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/git.js",
      "sourceLine": 592,
      "purpose": "POST /api/git/revert-local-commit for backend runtime support.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": [
          "const { project"
        ]
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Touches git repositories or local git config."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/git/branches",
      "tag": "Git",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/git.js",
      "sourceLine": 639,
      "purpose": "List git branches for a project.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [
          "const { project"
        ],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON validation error response.",
      "sideEffects": [
        "Touches git repositories or local git config."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/git/checkout",
      "tag": "Git",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/git.js",
      "sourceLine": 681,
      "purpose": "POST /api/git/checkout for backend runtime support.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": [
          "branch",
          "const { project"
        ]
      },
      "successShape": "JSON object with an explicit success flag and payload.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Touches git repositories or local git config."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/git/create-branch",
      "tag": "Git",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/git.js",
      "sourceLine": 703,
      "purpose": "POST /api/git/create-branch for backend runtime support.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": [
          "branch",
          "const { project"
        ]
      },
      "successShape": "JSON object with an explicit success flag and payload.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Touches git repositories or local git config."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/git/commits",
      "tag": "Git",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/git.js",
      "sourceLine": 725,
      "purpose": "List recent commits for a project.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [
          "const { project",
          "limit"
        ],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON validation error response.",
      "sideEffects": [
        "Touches git repositories or local git config."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/git/commit-diff",
      "tag": "Git",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/git.js",
      "sourceLine": 782,
      "purpose": "Return diff details for a specific commit.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [
          "commit",
          "const { project"
        ],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON validation error response.",
      "sideEffects": [
        "Touches git repositories or local git config."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/git/generate-commit-message",
      "tag": "Git",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/git.js",
      "sourceLine": 814,
      "purpose": "Generate an AI-assisted commit message from the current diff.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": [
          "const { project",
          "files",
          "provider"
        ]
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Touches git repositories or local git config."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/git/remote-status",
      "tag": "Git",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/git.js",
      "sourceLine": 1019,
      "purpose": "Report remote sync status for a project repository.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [
          "const { project"
        ],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON validation error response.",
      "sideEffects": [
        "Touches git repositories or local git config."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/git/fetch",
      "tag": "Git",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/git.js",
      "sourceLine": 1097,
      "purpose": "POST /api/git/fetch for backend runtime support.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": [
          "const { project"
        ]
      },
      "successShape": "JSON object with an explicit success flag and payload.",
      "errorShape": "JSON validation error response.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Touches git repositories or local git config."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/git/pull",
      "tag": "Git",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/git.js",
      "sourceLine": 1138,
      "purpose": "POST /api/git/pull for backend runtime support.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": [
          "const { project"
        ]
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON validation error response.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Touches git repositories or local git config."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/git/push",
      "tag": "Git",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/git.js",
      "sourceLine": 1206,
      "purpose": "POST /api/git/push for backend runtime support.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": [
          "const { project"
        ]
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON validation error response.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Touches git repositories or local git config."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/git/publish",
      "tag": "Git",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/git.js",
      "sourceLine": 1277,
      "purpose": "POST /api/git/publish for backend runtime support.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": [
          "branch",
          "const { project"
        ]
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON validation error response.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Touches git repositories or local git config."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/git/discard",
      "tag": "Git",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/git.js",
      "sourceLine": 1356,
      "purpose": "POST /api/git/discard for backend runtime support.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": [
          "const { project",
          "file"
        ]
      },
      "successShape": "JSON object with an explicit success flag and payload.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Touches git repositories or local git config."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/git/delete-untracked",
      "tag": "Git",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/git.js",
      "sourceLine": 1410,
      "purpose": "POST /api/git/delete-untracked for backend runtime support.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": [
          "const { project",
          "file"
        ]
      },
      "successShape": "JSON object with an explicit success flag and payload.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Touches git repositories or local git config."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/mcp/cli/list",
      "tag": "MCP",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/mcp.js",
      "sourceLine": 16,
      "purpose": "Manage Claude MCP CLI and configuration state.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "JSON object with an explicit success flag and payload.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Reads or writes MCP CLI configuration."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/mcp/cli/add",
      "tag": "MCP",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/mcp.js",
      "sourceLine": 59,
      "purpose": "Manage Claude MCP CLI and configuration state.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "JSON object with an explicit success flag and payload.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Reads or writes MCP CLI configuration."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/mcp/cli/add-json",
      "tag": "MCP",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/mcp.js",
      "sourceLine": 142,
      "purpose": "Manage Claude MCP CLI and configuration state.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": [
          "jsonConfig",
          "projectPath",
          "scope",
          "try {\r\n    const { name"
        ]
      },
      "successShape": "JSON object with an explicit success flag and payload.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Reads or writes MCP CLI configuration."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "DELETE",
      "path": "/api/mcp/cli/remove/:name",
      "tag": "MCP",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/mcp.js",
      "sourceLine": 235,
      "purpose": "Manage Claude MCP CLI and configuration state.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "name"
        ],
        "queryParams": [
          "scope"
        ],
        "bodyHints": []
      },
      "successShape": "JSON object with an explicit success flag and payload.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Reads or writes MCP CLI configuration."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/mcp/cli/get/:name",
      "tag": "MCP",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/mcp.js",
      "sourceLine": 305,
      "purpose": "Manage Claude MCP CLI and configuration state.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "name"
        ],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "JSON object with an explicit success flag and payload.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Reads or writes MCP CLI configuration."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/mcp/config/read",
      "tag": "MCP",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/mcp.js",
      "sourceLine": 348,
      "purpose": "Manage Claude MCP CLI and configuration state.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Reads or writes MCP CLI configuration."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/cursor/config",
      "tag": "Providers",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/cursor.js",
      "sourceLine": 15,
      "purpose": "Manage Cursor configuration, MCP settings, and stored sessions.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Read-only backend query."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/cursor/config",
      "tag": "Providers",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/cursor.js",
      "sourceLine": 59,
      "purpose": "Manage Cursor configuration, MCP settings, and stored sessions.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": [
          "model",
          "try {\r\n    const { permissions"
        ]
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Mutates backend or external state."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/cursor/mcp",
      "tag": "Providers",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/cursor.js",
      "sourceLine": 122,
      "purpose": "Manage Cursor configuration, MCP settings, and stored sessions.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Reads or writes MCP CLI configuration."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/cursor/mcp/add",
      "tag": "Providers",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/cursor.js",
      "sourceLine": 183,
      "purpose": "Manage Cursor configuration, MCP settings, and stored sessions.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Reads or writes MCP CLI configuration."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "DELETE",
      "path": "/api/cursor/mcp/:name",
      "tag": "Providers",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/cursor.js",
      "sourceLine": 245,
      "purpose": "Manage Cursor configuration, MCP settings, and stored sessions.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "name"
        ],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Reads or writes MCP CLI configuration."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/cursor/mcp/add-json",
      "tag": "Providers",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/cursor.js",
      "sourceLine": 292,
      "purpose": "Manage Cursor configuration, MCP settings, and stored sessions.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": [
          "jsonConfig",
          "try {\r\n    const { name"
        ]
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Reads or writes MCP CLI configuration."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/cursor/sessions",
      "tag": "Providers",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/cursor.js",
      "sourceLine": 348,
      "purpose": "List or manage sessions associated with a project or provider.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [
          "try {\r\n    const { projectPath"
        ],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Read-only backend query."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/cursor/sessions/:sessionId",
      "tag": "Providers",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/cursor.js",
      "sourceLine": 583,
      "purpose": "List or manage sessions associated with a project or provider.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "sessionId"
        ],
        "queryParams": [
          "projectPath"
        ],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Read-only backend query."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/taskmaster/installation-status",
      "tag": "TaskMaster",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/taskmaster.js",
      "sourceLine": 243,
      "purpose": "Manage TaskMaster detection, PRDs, tasks, templates, and automation for a project.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Reads or writes TaskMaster project assets."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/taskmaster/detect/:projectName",
      "tag": "TaskMaster",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/taskmaster.js",
      "sourceLine": 278,
      "purpose": "Manage TaskMaster detection, PRDs, tasks, templates, and automation for a project.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "projectName"
        ],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "JSON payload returned directly from service logic.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Reads or writes TaskMaster project assets."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/taskmaster/detect-all",
      "tag": "TaskMaster",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/taskmaster.js",
      "sourceLine": 350,
      "purpose": "Manage TaskMaster detection, PRDs, tasks, templates, and automation for a project.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Reads or writes TaskMaster project assets."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/taskmaster/initialize/:projectName",
      "tag": "TaskMaster",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/taskmaster.js",
      "sourceLine": 434,
      "purpose": "Manage TaskMaster detection, PRDs, tasks, templates, and automation for a project.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "projectName"
        ],
        "queryParams": [],
        "bodyHints": [
          "rules"
        ]
      },
      "successShape": "Mixed response shape; inspect handler during refactor.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Reads or writes TaskMaster project assets."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/taskmaster/next/:projectName",
      "tag": "TaskMaster",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/taskmaster.js",
      "sourceLine": 460,
      "purpose": "Manage TaskMaster detection, PRDs, tasks, templates, and automation for a project.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "projectName"
        ],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Reads or writes TaskMaster project assets."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/taskmaster/tasks/:projectName",
      "tag": "TaskMaster",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/taskmaster.js",
      "sourceLine": 570,
      "purpose": "Manage TaskMaster detection, PRDs, tasks, templates, and automation for a project.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "projectName"
        ],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Reads or writes TaskMaster project assets."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/taskmaster/prd/:projectName",
      "tag": "TaskMaster",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/taskmaster.js",
      "sourceLine": 685,
      "purpose": "Manage TaskMaster detection, PRDs, tasks, templates, and automation for a project.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "projectName"
        ],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Reads or writes TaskMaster project assets."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/taskmaster/prd/:projectName",
      "tag": "TaskMaster",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/taskmaster.js",
      "sourceLine": 761,
      "purpose": "Manage TaskMaster detection, PRDs, tasks, templates, and automation for a project.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "projectName"
        ],
        "queryParams": [],
        "bodyHints": [
          "content",
          "fileName"
        ]
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Reads or writes TaskMaster project assets."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/taskmaster/prd/:projectName/:fileName",
      "tag": "TaskMaster",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/taskmaster.js",
      "sourceLine": 846,
      "purpose": "Manage TaskMaster detection, PRDs, tasks, templates, and automation for a project.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "projectName",
          "fileName"
        ],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Reads or writes TaskMaster project assets."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "DELETE",
      "path": "/api/taskmaster/prd/:projectName/:fileName",
      "tag": "TaskMaster",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/taskmaster.js",
      "sourceLine": 911,
      "purpose": "Manage TaskMaster detection, PRDs, tasks, templates, and automation for a project.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "projectName",
          "fileName"
        ],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Reads or writes TaskMaster project assets."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/taskmaster/init/:projectName",
      "tag": "TaskMaster",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/taskmaster.js",
      "sourceLine": 971,
      "purpose": "Manage TaskMaster detection, PRDs, tasks, templates, and automation for a project.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "projectName"
        ],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Reads or writes TaskMaster project assets."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/taskmaster/add-task/:projectName",
      "tag": "TaskMaster",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/taskmaster.js",
      "sourceLine": 1060,
      "purpose": "Manage TaskMaster detection, PRDs, tasks, templates, and automation for a project.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "projectName"
        ],
        "queryParams": [],
        "bodyHints": [
          "dependencies",
          "description",
          "priority",
          "prompt",
          "title"
        ]
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Reads or writes TaskMaster project assets."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "PUT",
      "path": "/api/taskmaster/update-task/:projectName/:taskId",
      "tag": "TaskMaster",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/taskmaster.js",
      "sourceLine": 1164,
      "purpose": "Manage TaskMaster detection, PRDs, tasks, templates, and automation for a project.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "projectName",
          "taskId"
        ],
        "queryParams": [],
        "bodyHints": [
          "description",
          "details",
          "priority",
          "status",
          "title"
        ]
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Reads or writes TaskMaster project assets."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/taskmaster/parse-prd/:projectName",
      "tag": "TaskMaster",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/taskmaster.js",
      "sourceLine": 1291,
      "purpose": "Manage TaskMaster detection, PRDs, tasks, templates, and automation for a project.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "projectName"
        ],
        "queryParams": [],
        "bodyHints": [
          "append",
          "fileName",
          "numTasks"
        ]
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Reads or writes TaskMaster project assets."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/taskmaster/prd-templates",
      "tag": "TaskMaster",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/taskmaster.js",
      "sourceLine": 1392,
      "purpose": "Manage TaskMaster detection, PRDs, tasks, templates, and automation for a project.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Reads or writes TaskMaster project assets."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/taskmaster/apply-template/:projectName",
      "tag": "TaskMaster",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/taskmaster.js",
      "sourceLine": 1838,
      "purpose": "Manage TaskMaster detection, PRDs, tasks, templates, and automation for a project.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "projectName"
        ],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Reads or writes TaskMaster project assets."
      ],
      "priority": "high"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/mcp-utils/taskmaster-server",
      "tag": "MCP",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/mcp-utils.js",
      "sourceLine": 18,
      "purpose": "Return MCP helper information used by setup flows.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "JSON payload returned directly from service logic.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Reads or writes TaskMaster project assets.",
        "Reads or writes MCP CLI configuration."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/mcp-utils/all-servers",
      "tag": "MCP",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/mcp-utils.js",
      "sourceLine": 35,
      "purpose": "Return MCP helper information used by setup flows.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "JSON payload returned directly from service logic.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Reads or writes MCP CLI configuration."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/commands/list",
      "tag": "Commands",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/commands.js",
      "sourceLine": 406,
      "purpose": "List, load, or execute slash commands available to the chat experience.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": [
          "try {\r\n    const { projectPath"
        ]
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Mutates backend or external state."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/commands/load",
      "tag": "Commands",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/commands.js",
      "sourceLine": 456,
      "purpose": "List, load, or execute slash commands available to the chat experience.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": [
          "commandPath",
          "try {\r\n    const { commandPath"
        ]
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Mutates backend or external state."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/commands/execute",
      "tag": "Commands",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/commands.js",
      "sourceLine": 507,
      "purpose": "List, load, or execute slash commands available to the chat experience.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": [
          "commandPath"
        ]
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Mutates backend or external state."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/settings/api-keys",
      "tag": "Settings",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/settings.js",
      "sourceLine": 11,
      "purpose": "Manage local API keys used to access the backend.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Reads or writes local authentication or credential state."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/settings/api-keys",
      "tag": "Settings",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/settings.js",
      "sourceLine": 27,
      "purpose": "Manage local API keys used to access the backend.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": [
          "try {\r\n    const { keyName"
        ]
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Reads or writes local authentication or credential state."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "DELETE",
      "path": "/api/settings/api-keys/:keyId",
      "tag": "Settings",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/settings.js",
      "sourceLine": 47,
      "purpose": "Manage local API keys used to access the backend.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "keyId"
        ],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "JSON object with an explicit success flag and payload.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Reads or writes local authentication or credential state."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "PATCH",
      "path": "/api/settings/api-keys/:keyId/toggle",
      "tag": "Settings",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/settings.js",
      "sourceLine": 64,
      "purpose": "Manage local API keys used to access the backend.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "keyId"
        ],
        "queryParams": [],
        "bodyHints": [
          "isActive"
        ]
      },
      "successShape": "JSON object with an explicit success flag and payload.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Reads or writes local authentication or credential state."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/settings/credentials",
      "tag": "Settings",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/settings.js",
      "sourceLine": 91,
      "purpose": "Manage stored provider and GitHub credentials.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [
          "try {\r\n    const { type"
        ],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Reads or writes local authentication or credential state."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/settings/credentials",
      "tag": "Settings",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/settings.js",
      "sourceLine": 104,
      "purpose": "Manage stored provider and GitHub credentials.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": [
          "credentialType",
          "credentialValue",
          "description",
          "try {\r\n    const { credentialName"
        ]
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Reads or writes local authentication or credential state."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "DELETE",
      "path": "/api/settings/credentials/:credentialId",
      "tag": "Settings",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/settings.js",
      "sourceLine": 139,
      "purpose": "Manage stored provider and GitHub credentials.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "credentialId"
        ],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "JSON object with an explicit success flag and payload.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Reads or writes local authentication or credential state."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "PATCH",
      "path": "/api/settings/credentials/:credentialId/toggle",
      "tag": "Settings",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/settings.js",
      "sourceLine": 156,
      "purpose": "Manage stored provider and GitHub credentials.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "credentialId"
        ],
        "queryParams": [],
        "bodyHints": [
          "isActive"
        ]
      },
      "successShape": "JSON object with an explicit success flag and payload.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Reads or writes local authentication or credential state."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/cli/claude/status",
      "tag": "CLI Auth",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/cli-auth.js",
      "sourceLine": 9,
      "purpose": "Report local authentication status for provider CLIs.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Read-only backend query."
      ],
      "priority": "low"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/cli/cursor/status",
      "tag": "CLI Auth",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/cli-auth.js",
      "sourceLine": 39,
      "purpose": "Report local authentication status for provider CLIs.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Read-only backend query."
      ],
      "priority": "low"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/cli/codex/status",
      "tag": "CLI Auth",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/cli-auth.js",
      "sourceLine": 59,
      "purpose": "Report local authentication status for provider CLIs.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Read-only backend query."
      ],
      "priority": "low"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/cli/gemini/status",
      "tag": "CLI Auth",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/cli-auth.js",
      "sourceLine": 79,
      "purpose": "Report local authentication status for provider CLIs.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Read-only backend query."
      ],
      "priority": "low"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/user/git-config",
      "tag": "User",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/user.js",
      "sourceLine": 28,
      "purpose": "Read or update stored git identity settings.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Touches git repositories or local git config."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/user/git-config",
      "tag": "User",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/user.js",
      "sourceLine": 57,
      "purpose": "Read or update stored git identity settings.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": [
          "gitEmail",
          "try {\r\n    const userId = req.user.id;\r\n    const { gitName"
        ]
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Touches git repositories or local git config."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/user/complete-onboarding",
      "tag": "User",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/user.js",
      "sourceLine": 93,
      "purpose": "Mark onboarding as completed for the current user.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/user/onboarding-status",
      "tag": "User",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/user.js",
      "sourceLine": 108,
      "purpose": "Return onboarding completion status for the current user.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Read-only backend query."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/codex/config",
      "tag": "Providers",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/codex.js",
      "sourceLine": 23,
      "purpose": "Manage Codex configuration, MCP settings, and stored sessions.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Read-only backend query."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/codex/sessions",
      "tag": "Providers",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/codex.js",
      "sourceLine": 54,
      "purpose": "List or manage sessions associated with a project or provider.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [
          "try {\r\n    const { projectPath"
        ],
        "bodyHints": []
      },
      "successShape": "JSON object with an explicit success flag and payload.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Read-only backend query."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/codex/sessions/:sessionId/messages",
      "tag": "Providers",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/codex.js",
      "sourceLine": 71,
      "purpose": "Return paginated messages for a stored session.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "sessionId"
        ],
        "queryParams": [
          "limit",
          "offset"
        ],
        "bodyHints": []
      },
      "successShape": "JSON object with an explicit success flag and payload.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Read-only backend query."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "DELETE",
      "path": "/api/codex/sessions/:sessionId",
      "tag": "Providers",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/codex.js",
      "sourceLine": 89,
      "purpose": "List or manage sessions associated with a project or provider.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "sessionId"
        ],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "JSON object with an explicit success flag and payload.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Mutates backend or external state."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/codex/mcp/cli/list",
      "tag": "Providers",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/codex.js",
      "sourceLine": 103,
      "purpose": "Manage Codex configuration, MCP settings, and stored sessions.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Mixed response shape; inspect handler during refactor.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Reads or writes MCP CLI configuration."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/codex/mcp/cli/add",
      "tag": "Providers",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/codex.js",
      "sourceLine": 135,
      "purpose": "Manage Codex configuration, MCP settings, and stored sessions.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Mixed response shape; inspect handler during refactor.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Reads or writes MCP CLI configuration."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "DELETE",
      "path": "/api/codex/mcp/cli/remove/:name",
      "tag": "Providers",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/codex.js",
      "sourceLine": 186,
      "purpose": "Manage Codex configuration, MCP settings, and stored sessions.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "name"
        ],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Mixed response shape; inspect handler during refactor.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Reads or writes MCP CLI configuration."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/codex/mcp/cli/get/:name",
      "tag": "Providers",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/codex.js",
      "sourceLine": 220,
      "purpose": "Manage Codex configuration, MCP settings, and stored sessions.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "name"
        ],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Mixed response shape; inspect handler during refactor.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Reads or writes MCP CLI configuration."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/codex/mcp/config/read",
      "tag": "Providers",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/codex.js",
      "sourceLine": 254,
      "purpose": "Manage Codex configuration, MCP settings, and stored sessions.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "JSON object with an explicit success flag and payload.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Reads or writes MCP CLI configuration."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/gemini/sessions/:sessionId/messages",
      "tag": "Providers",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/gemini.js",
      "sourceLine": 8,
      "purpose": "Return paginated messages for a stored session.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "sessionId"
        ],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Read-only backend query."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "DELETE",
      "path": "/api/gemini/sessions/:sessionId",
      "tag": "Providers",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/gemini.js",
      "sourceLine": 37,
      "purpose": "List or manage sessions associated with a project or provider.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "sessionId"
        ],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "JSON object with an explicit success flag and payload.",
      "errorShape": "JSON error response with HTTP status code.",
      "sideEffects": [
        "Mutates backend or external state."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/plugins",
      "tag": "Plugins",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/plugins.js",
      "sourceLine": 27,
      "purpose": "List, install, update, serve, enable, or remove plugins.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Structured JSON object response.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Installs, updates, or serves plugin assets/processes."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/plugins/:name/manifest",
      "tag": "Plugins",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/plugins.js",
      "sourceLine": 40,
      "purpose": "List, install, update, serve, enable, or remove plugins.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "name"
        ],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "JSON payload returned directly from service logic.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Installs, updates, or serves plugin assets/processes."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "GET",
      "path": "/api/plugins/:name/assets/*",
      "tag": "Plugins",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/plugins.js",
      "sourceLine": 57,
      "purpose": "List, install, update, serve, enable, or remove plugins.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "name"
        ],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "Mixed response shape; inspect handler during refactor.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Installs, updates, or serves plugin assets/processes."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "PUT",
      "path": "/api/plugins/:name/enable",
      "tag": "Plugins",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/plugins.js",
      "sourceLine": 96,
      "purpose": "List, install, update, serve, enable, or remove plugins.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "name"
        ],
        "queryParams": [],
        "bodyHints": [
          "try {\r\n    const { enabled"
        ]
      },
      "successShape": "JSON object with an explicit success flag and payload.",
      "errorShape": "JSON object with error message and optional details.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Installs, updates, or serves plugin assets/processes."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/plugins/install",
      "tag": "Plugins",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/plugins.js",
      "sourceLine": 136,
      "purpose": "List, install, update, serve, enable, or remove plugins.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": [
          "try {\r\n    const { url"
        ]
      },
      "successShape": "JSON object with an explicit success flag and payload.",
      "errorShape": "JSON validation error response.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Installs, updates, or serves plugin assets/processes."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "POST",
      "path": "/api/plugins/:name/update",
      "tag": "Plugins",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/plugins.js",
      "sourceLine": 169,
      "purpose": "List, install, update, serve, enable, or remove plugins.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "name"
        ],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "JSON object with an explicit success flag and payload.",
      "errorShape": "JSON validation error response.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Installs, updates, or serves plugin assets/processes."
      ],
      "priority": "medium"
    },
    {
      "transport": "http",
      "method": "DELETE",
      "path": "/api/plugins/:name",
      "tag": "Plugins",
      "authMode": "bearer_token",
      "sourceFile": "server/routes/plugins.js",
      "sourceLine": 282,
      "purpose": "List, install, update, serve, enable, or remove plugins.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [
          "name"
        ],
        "queryParams": [],
        "bodyHints": []
      },
      "successShape": "JSON object with an explicit success flag and payload.",
      "errorShape": "JSON validation error response.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Installs, updates, or serves plugin assets/processes."
      ],
      "priority": "medium"
    },
    {
      "transport": "sse",
      "method": "POST",
      "path": "/api/agent",
      "tag": "Agent",
      "authMode": "api_key_or_platform",
      "sourceFile": "server/routes/agent.js",
      "sourceLine": 839,
      "purpose": "Accept external agent jobs that run a provider against a local or cloned project.",
      "consumerFiles": [
        "src/components/chat/hooks/useChatComposerState.ts",
        "src/components/chat/hooks/useChatProviderState.ts",
        "src/components/chat/hooks/useChatSessionState.ts",
        "src/components/chat/hooks/useSlashCommands.ts",
        "src/components/file-tree/view/ImageViewer.tsx",
        "src/components/git-panel/hooks/useGitPanelController.ts",
        "src/components/git-panel/hooks/useRevertLocalCommit.ts",
        "src/components/onboarding/view/Onboarding.tsx",
        "src/components/plugins/view/PluginIcon.tsx",
        "src/components/plugins/view/PluginTabContent.tsx",
        "src/components/prd-editor/hooks/usePrdSave.ts",
        "src/components/project-creation-wizard/data/workspaceApi.ts",
        "src/components/settings/constants/constants.ts",
        "src/components/settings/hooks/useCredentialsSettings.ts",
        "src/components/settings/hooks/useGitSettings.ts",
        "src/components/settings/hooks/useSettingsController.ts",
        "src/components/version-upgrade/view/VersionUpgradeModal.tsx",
        "src/contexts/PluginsContext.tsx",
        "src/utils/api.js"
      ],
      "inputs": {
        "pathParams": [],
        "queryParams": [],
        "bodyHints": [
          "branchName",
          "cleanup",
          "const { githubUrl",
          "createBranch",
          "createPR",
          "githubToken",
          "message",
          "model",
          "projectPath",
          "provider",
          "stream"
        ]
      },
      "successShape": "Server-sent events stream with progress/result/error events.",
      "errorShape": "Streamed error event or JSON error fallback.",
      "sideEffects": [
        "Mutates backend or external state.",
        "Invokes external AI providers and may modify project files."
      ],
      "priority": "high"
    }
  ]
}
