@shepai/cli 1.149.1-pr467.b05cb61 → 1.149.1-pr469.a02d90d

package/dist/packages/core/src/application/ports/output/services/github-repository-service.interface.d.ts

@@ -29,12 +29,6 @@ export declare class GitHubUrlParseError extends Error {
 export declare class GitHubRepoListError extends Error {
     constructor(message: string, cause?: Error);
 }
-/**
- * Thrown when checking the viewer's permission on a repository fails.
- */
-export declare class GitHubPermissionError extends Error {
-    constructor(message: string, cause?: Error);
-}
 /**
  * A GitHub repository as returned by `gh repo list --json`.
  */
@@ -120,16 +114,5 @@ export interface IGitHubRepositoryService {
      * @throws {GitHubUrlParseError} if the URL does not match any supported format
      */
     parseGitHubUrl(url: string): ParsedGitHubUrl;
-    /**
-     * Get the authenticated user's permission level on a GitHub repository.
-     *
-     * Uses `gh repo view --json viewerPermission` with the given repo path
-     * as the working directory.
-     *
-     * @param repoPath - Absolute path to a local clone of the repository
-     * @returns The viewer's permission level: "ADMIN", "MAINTAIN", "WRITE", "TRIAGE", or "READ"
-     * @throws {GitHubPermissionError} if the permission check fails (e.g. gh not installed, not authenticated)
-     */
-    getViewerPermission(repoPath: string): Promise<string>;
 }
 //# sourceMappingURL=github-repository-service.interface.d.ts.map

package/dist/packages/core/src/application/ports/output/services/github-repository-service.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"github-repository-service.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/github-repository-service.interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAM3C;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAM3C;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAM3C;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAM3C;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAM3C;AAMD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,aAAa,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,SAAS,EAAE,OAAO,CAAC;IACnB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,aAAa,EAAE,MAAM,CAAC;CACvB;AAMD;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3B;;;;;;;OAOG;IACH,eAAe,CACb,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;OAMG;IACH,oBAAoB,CAAC,OAAO,CAAC,EAAE,2BAA2B,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAEnF;;;;;;;;;;;;OAYG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAAC;IAE7C;;;;;;;;;OASG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACxD"}
+{"version":3,"file":"github-repository-service.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/github-repository-service.interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAM3C;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAM3C;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAM3C;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAM3C;AAMD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,aAAa,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,SAAS,EAAE,OAAO,CAAC;IACnB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,aAAa,EAAE,MAAM,CAAC;CACvB;AAMD;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3B;;;;;;;OAOG;IACH,eAAe,CACb,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;OAMG;IACH,oBAAoB,CAAC,OAAO,CAAC,EAAE,2BAA2B,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAEnF;;;;;;;;;;;;OAYG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAAC;CAC9C"}

package/dist/packages/core/src/application/ports/output/services/github-repository-service.interface.js

@@ -56,15 +56,3 @@ export class GitHubRepoListError extends Error {
             this.cause = cause;
     }
 }
-/**
- * Thrown when checking the viewer's permission on a repository fails.
- */
-export class GitHubPermissionError extends Error {
-    constructor(message, cause) {
-        super(message);
-        this.name = 'GitHubPermissionError';
-        Object.setPrototypeOf(this, new.target.prototype);
-        if (cause)
-            this.cause = cause;
-    }
-}

package/dist/packages/core/src/infrastructure/di/container.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/infrastructure/di/container.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAiIrC;;;;;;GAMG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,OAAO,SAAS,CAAC,CA4WrE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/infrastructure/di/container.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAiIrC;;;;;;GAMG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,OAAO,SAAS,CAAC,CA0XrE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/packages/core/src/infrastructure/di/container.js

@@ -436,6 +436,19 @@ export async function initializeContainer() {
     container.register('GetBranchSyncStatusUseCase', {
         useFactory: (c) => c.resolve(GetBranchSyncStatusUseCase),
     });
+    // McpServerFactory is registered as a lazy async factory to avoid importing
+    // @modelcontextprotocol/sdk for non-MCP commands. The factory uses dynamic
+    // import() — the actual SDK import only happens when the factory is called.
+    container.register('McpServerFactory', {
+        useFactory: (c) => {
+            return async () => {
+                const { McpServerService } = await import('../services/mcp/mcp-server.service.js');
+                const versionService = c.resolve('IVersionService');
+                const { version } = versionService.getVersion();
+                return new McpServerService(version, c);
+            };
+        },
+    });
     _initialized = true;
     return container;
 }

package/dist/packages/core/src/infrastructure/services/external/github-repository.service.d.ts

@@ -13,7 +13,6 @@ export declare class GitHubRepositoryService implements IGitHubRepositoryService
     listUserRepositories(options?: ListUserRepositoriesOptions): Promise<GitHubRepo[]>;
     cloneRepository(nameWithOwner: string, destination: string, options?: CloneOptions): Promise<void>;
     parseGitHubUrl(url: string): ParsedGitHubUrl;
-    getViewerPermission(repoPath: string): Promise<string>;
     private cleanupPartialClone;
 }
 //# sourceMappingURL=github-repository.service.d.ts.map

package/dist/packages/core/src/infrastructure/services/external/github-repository.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"github-repository.service.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/external/github-repository.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EACV,wBAAwB,EACxB,UAAU,EACV,2BAA2B,EAC3B,YAAY,EACZ,eAAe,EAChB,MAAM,mFAAmF,CAAC;AAyB3F,qBACa,uBAAwB,YAAW,wBAAwB;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,YAAY;IAErE,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAyB1B,oBAAoB,CAAC,OAAO,CAAC,EAAE,2BAA2B,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAsClF,eAAe,CACnB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,IAAI,CAAC;IAgDhB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe;IA2CtC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAyB9C,mBAAmB;CAOlC"}
+{"version":3,"file":"github-repository.service.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/external/github-repository.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EACV,wBAAwB,EACxB,UAAU,EACV,2BAA2B,EAC3B,YAAY,EACZ,eAAe,EAChB,MAAM,mFAAmF,CAAC;AAwB3F,qBACa,uBAAwB,YAAW,wBAAwB;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,YAAY;IAErE,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAyB1B,oBAAoB,CAAC,OAAO,CAAC,EAAE,2BAA2B,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAsClF,eAAe,CACnB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,IAAI,CAAC;IAgDhB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe;YA2C9B,mBAAmB;CAOlC"}

package/dist/packages/core/src/infrastructure/services/external/github-repository.service.js

@@ -20,7 +20,7 @@ import { injectable, inject } from 'tsyringe';
 import { resolve, normalize } from 'node:path';
 import { rm } from 'node:fs/promises';
 import { spawn } from 'node:child_process';
-import { GitHubAuthError, GitHubCloneError, GitHubPermissionError, GitHubRepoListError, GitHubUrlParseError, } from '../../../application/ports/output/services/github-repository-service.interface.js';
+import { GitHubAuthError, GitHubCloneError, GitHubRepoListError, GitHubUrlParseError, } from '../../../application/ports/output/services/github-repository-service.interface.js';
 // ---------------------------------------------------------------------------
 // URL regex patterns
 // ---------------------------------------------------------------------------
@@ -154,23 +154,6 @@ let GitHubRepositoryService = class GitHubRepositoryService {
             'Supported formats: https://github.com/owner/repo, ' +
             'git@github.com:owner/repo.git, or owner/repo shorthand.');
     }
-    async getViewerPermission(repoPath) {
-        try {
-            const { stdout } = await this.execFile('gh', ['repo', 'view', '--json', 'viewerPermission'], {
-                cwd: repoPath,
-            });
-            const parsed = JSON.parse(stdout);
-            return parsed.viewerPermission;
-        }
-        catch (error) {
-            const cause = error instanceof Error ? error : undefined;
-            const errnoCode = error?.code;
-            if (errnoCode === 'ENOENT') {
-                throw new GitHubPermissionError('GitHub CLI (gh) is not installed. Install it from https://cli.github.com/', cause);
-            }
-            throw new GitHubPermissionError(`Failed to check repository permission: ${cause?.message ?? String(error)}`, cause);
-        }
-    }
     async cleanupPartialClone(destination) {
         try {
             await rm(destination, { recursive: true, force: true });

package/dist/packages/core/src/infrastructure/services/mcp/mcp-server.service.d.ts

@@ -0,0 +1,25 @@
+/**
+ * MCP Server Service
+ *
+ * Thin presentation adapter that exposes shep use cases as MCP tools.
+ * Uses the official @modelcontextprotocol/sdk with stdio transport.
+ *
+ * Architecture: This sits in the infrastructure layer as a presentation adapter,
+ * the same pattern used by CLI commands and the web server. It resolves use cases
+ * from the shared DI container and contains zero business logic.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type DependencyContainer from 'tsyringe/dist/typings/types/dependency-container.js';
+export declare class McpServerService {
+    readonly server: McpServer;
+    constructor(version: string, container?: DependencyContainer);
+    /**
+     * Connect the MCP server to a stdio transport and start listening.
+     */
+    start(): Promise<void>;
+    /**
+     * Close the MCP server and transport.
+     */
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=mcp-server.service.d.ts.map

package/dist/packages/core/src/infrastructure/services/mcp/mcp-server.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.service.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/mcp/mcp-server.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,mBAAmB,MAAM,qDAAqD,CAAC;AAG3F,qBAAa,gBAAgB;IAC3B,SAAgB,MAAM,EAAE,SAAS,CAAC;gBAEtB,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,mBAAmB;IAW5D;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B"}

package/dist/packages/core/src/infrastructure/services/mcp/mcp-server.service.js

@@ -0,0 +1,38 @@
+/**
+ * MCP Server Service
+ *
+ * Thin presentation adapter that exposes shep use cases as MCP tools.
+ * Uses the official @modelcontextprotocol/sdk with stdio transport.
+ *
+ * Architecture: This sits in the infrastructure layer as a presentation adapter,
+ * the same pattern used by CLI commands and the web server. It resolves use cases
+ * from the shared DI container and contains zero business logic.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { registerAllTools } from './tools/index.js';
+export class McpServerService {
+    server;
+    constructor(version, container) {
+        this.server = new McpServer({
+            name: 'shep',
+            version,
+        });
+        if (container) {
+            registerAllTools(this.server, container);
+        }
+    }
+    /**
+     * Connect the MCP server to a stdio transport and start listening.
+     */
+    async start() {
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+    }
+    /**
+     * Close the MCP server and transport.
+     */
+    async stop() {
+        await this.server.close();
+    }
+}

package/dist/packages/core/src/infrastructure/services/mcp/tools/agent-tools.d.ts

@@ -0,0 +1,13 @@
+/**
+ * MCP Agent Tools
+ *
+ * Registers agent-related MCP tools on the server.
+ * Each tool is a thin adapter that delegates to a use case.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type DependencyContainer from 'tsyringe/dist/typings/types/dependency-container.js';
+/**
+ * Register agent-related MCP tools on the server.
+ */
+export declare function registerAgentTools(server: McpServer, container: DependencyContainer): void;
+//# sourceMappingURL=agent-tools.d.ts.map

package/dist/packages/core/src/infrastructure/services/mcp/tools/agent-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tools.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/services/mcp/tools/agent-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,mBAAmB,MAAM,qDAAqD,CAAC;AAwB3F;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,mBAAmB,GAAG,IAAI,CAkF1F"}

package/dist/packages/core/src/infrastructure/services/mcp/tools/agent-tools.js

@@ -0,0 +1,92 @@
+/**
+ * MCP Agent Tools
+ *
+ * Registers agent-related MCP tools on the server.
+ * Each tool is a thin adapter that delegates to a use case.
+ */
+import { z } from 'zod';
+import { RunAgentUseCase } from '../../../../application/use-cases/agents/run-agent.use-case.js';
+import { GetAgentRunUseCase } from '../../../../application/use-cases/agents/get-agent-run.use-case.js';
+import { ListAgentRunsUseCase } from '../../../../application/use-cases/agents/list-agent-runs.use-case.js';
+import { StopAgentRunUseCase } from '../../../../application/use-cases/agents/stop-agent-run.use-case.js';
+/**
+ * Wraps an async handler in try/catch, returning MCP error responses on failure.
+ */
+async function withErrorHandling(fn) {
+    try {
+        return await fn();
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: message }],
+            isError: true,
+        };
+    }
+}
+/**
+ * Register agent-related MCP tools on the server.
+ */
+export function registerAgentTools(server, container) {
+    server.registerTool('run_agent', {
+        description: 'Run a named agent with a prompt. Returns the agent run ID immediately without blocking — use show_agent_run to poll for status.',
+        inputSchema: {
+            agentName: z.string().describe('Name of the agent to run'),
+            prompt: z.string().describe('Prompt or instructions for the agent'),
+        },
+    }, async ({ agentName, prompt }) => {
+        return withErrorHandling(async () => {
+            const useCase = container.resolve(RunAgentUseCase);
+            const agentRun = await useCase.execute({ agentName, prompt });
+            return {
+                content: [{ type: 'text', text: JSON.stringify(agentRun, null, 2) }],
+            };
+        });
+    });
+    server.registerTool('show_agent_run', {
+        description: 'Get the status and details of an agent run by its ID.',
+        inputSchema: {
+            runId: z.string().describe('Agent run ID'),
+        },
+    }, async ({ runId }) => {
+        return withErrorHandling(async () => {
+            const useCase = container.resolve(GetAgentRunUseCase);
+            const agentRun = await useCase.execute(runId);
+            if (!agentRun) {
+                return {
+                    content: [{ type: 'text', text: `Agent run not found: "${runId}"` }],
+                    isError: true,
+                };
+            }
+            return {
+                content: [{ type: 'text', text: JSON.stringify(agentRun, null, 2) }],
+            };
+        });
+    });
+    server.registerTool('list_agent_runs', {
+        description: 'List all agent runs, sorted by most recent first.',
+        inputSchema: {},
+    }, async () => {
+        return withErrorHandling(async () => {
+            const useCase = container.resolve(ListAgentRunsUseCase);
+            const runs = await useCase.execute();
+            return {
+                content: [{ type: 'text', text: JSON.stringify(runs, null, 2) }],
+            };
+        });
+    });
+    server.registerTool('stop_agent_run', {
+        description: 'Stop a running agent by its run ID. Returns whether the stop was successful.',
+        inputSchema: {
+            runId: z.string().describe('Agent run ID to stop'),
+        },
+    }, async ({ runId }) => {
+        return withErrorHandling(async () => {
+            const useCase = container.resolve(StopAgentRunUseCase);
+            const result = await useCase.execute(runId);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        });
+    });
+}

package/dist/packages/core/src/infrastructure/services/mcp/tools/feature-tools.d.ts

@@ -0,0 +1,13 @@
+/**
+ * MCP Feature Tools
+ *
+ * Registers feature-related MCP tools on the server.
+ * Each tool is a thin adapter that delegates to a use case.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type DependencyContainer from 'tsyringe/dist/typings/types/dependency-container.js';
+/**
+ * Register feature-related MCP tools on the server.
+ */
+export declare function registerFeatureTools(server: McpServer, container: DependencyContainer): void;
+//# sourceMappingURL=feature-tools.d.ts.map

package/dist/packages/core/src/infrastructure/services/mcp/tools/feature-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-tools.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/services/mcp/tools/feature-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,mBAAmB,MAAM,qDAAqD,CAAC;AA0B3F;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,mBAAmB,GAAG,IAAI,CAkH5F"}

package/dist/packages/core/src/infrastructure/services/mcp/tools/feature-tools.js

@@ -0,0 +1,122 @@
+/**
+ * MCP Feature Tools
+ *
+ * Registers feature-related MCP tools on the server.
+ * Each tool is a thin adapter that delegates to a use case.
+ */
+import { z } from 'zod';
+import { ListFeaturesUseCase } from '../../../../application/use-cases/features/list-features.use-case.js';
+import { ShowFeatureUseCase } from '../../../../application/use-cases/features/show-feature.use-case.js';
+import { CreateFeatureUseCase } from '../../../../application/use-cases/features/create/create-feature.use-case.js';
+import { StartFeatureUseCase } from '../../../../application/use-cases/features/start-feature.use-case.js';
+import { SdlcLifecycle } from '../../../../domain/generated/output.js';
+/**
+ * Wraps an async handler in try/catch, returning MCP error responses on failure.
+ */
+async function withErrorHandling(fn) {
+    try {
+        return await fn();
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: message }],
+            isError: true,
+        };
+    }
+}
+/**
+ * Register feature-related MCP tools on the server.
+ */
+export function registerFeatureTools(server, container) {
+    server.registerTool('list_features', {
+        description: 'List all features tracked by shep. Optionally filter by lifecycle status (e.g. Pending, Implementation, Review).',
+        inputSchema: {
+            status: z
+                .enum([
+                SdlcLifecycle.Started,
+                SdlcLifecycle.Analyze,
+                SdlcLifecycle.Requirements,
+                SdlcLifecycle.Research,
+                SdlcLifecycle.Planning,
+                SdlcLifecycle.Implementation,
+                SdlcLifecycle.Review,
+                SdlcLifecycle.Maintain,
+                SdlcLifecycle.Blocked,
+                SdlcLifecycle.Pending,
+            ])
+                .optional()
+                .describe('Filter by lifecycle status'),
+        },
+    }, async ({ status }) => {
+        return withErrorHandling(async () => {
+            const useCase = container.resolve(ListFeaturesUseCase);
+            const filters = {};
+            if (status) {
+                filters.lifecycle = status;
+            }
+            const features = await useCase.execute(filters);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(features, null, 2) }],
+            };
+        });
+    });
+    server.registerTool('show_feature', {
+        description: 'Get detailed information about a feature by ID. Supports prefix matching — you can provide the first few characters of the feature ID.',
+        inputSchema: {
+            featureId: z.string().describe('Feature ID or ID prefix'),
+        },
+    }, async ({ featureId }) => {
+        return withErrorHandling(async () => {
+            const useCase = container.resolve(ShowFeatureUseCase);
+            const feature = await useCase.execute(featureId);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(feature, null, 2) }],
+            };
+        });
+    });
+    server.registerTool('create_feature', {
+        description: 'Create a new feature in shep. Requires a user input describing the feature and the repository path. Optionally provide a name and description to skip AI metadata extraction.',
+        inputSchema: {
+            userInput: z.string().describe('Natural language description of the feature to create'),
+            repositoryPath: z.string().describe('Absolute path to the repository'),
+            name: z.string().optional().describe('Pre-supplied feature name (skips AI extraction)'),
+            description: z
+                .string()
+                .optional()
+                .describe('Pre-supplied feature description (skips AI extraction)'),
+            pending: z
+                .boolean()
+                .optional()
+                .describe('When true, create in Pending state without spawning an agent'),
+        },
+    }, async ({ userInput, repositoryPath, name, description, pending }) => {
+        return withErrorHandling(async () => {
+            const useCase = container.resolve(CreateFeatureUseCase);
+            const result = await useCase.execute({
+                userInput,
+                repositoryPath,
+                name,
+                description,
+                pending,
+            });
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        });
+    });
+    server.registerTool('start_feature', {
+        description: 'Start a pending feature. Triggers an agent run and returns the run ID immediately without blocking.',
+        inputSchema: {
+            featureId: z.string().describe('ID of the pending feature to start'),
+        },
+    }, async ({ featureId }) => {
+        return withErrorHandling(async () => {
+            const useCase = container.resolve(StartFeatureUseCase);
+            const result = await useCase.execute(featureId);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        });
+    });
+}

package/dist/packages/core/src/infrastructure/services/mcp/tools/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * MCP Tools Registration
+ *
+ * Barrel module that registers all MCP tools on a server instance.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type DependencyContainer from 'tsyringe/dist/typings/types/dependency-container.js';
+/**
+ * Register all MCP tools on the server.
+ */
+export declare function registerAllTools(server: McpServer, container: DependencyContainer): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/packages/core/src/infrastructure/services/mcp/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/services/mcp/tools/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,mBAAmB,MAAM,qDAAqD,CAAC;AAM3F;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,mBAAmB,GAAG,IAAI,CAKxF"}

package/dist/packages/core/src/infrastructure/services/mcp/tools/index.js

@@ -0,0 +1,18 @@
+/**
+ * MCP Tools Registration
+ *
+ * Barrel module that registers all MCP tools on a server instance.
+ */
+import { registerFeatureTools } from './feature-tools.js';
+import { registerAgentTools } from './agent-tools.js';
+import { registerRepoTools } from './repo-tools.js';
+import { registerSettingsTools } from './settings-tools.js';
+/**
+ * Register all MCP tools on the server.
+ */
+export function registerAllTools(server, container) {
+    registerFeatureTools(server, container);
+    registerAgentTools(server, container);
+    registerRepoTools(server, container);
+    registerSettingsTools(server, container);
+}

package/dist/packages/core/src/infrastructure/services/mcp/tools/repo-tools.d.ts

@@ -0,0 +1,13 @@
+/**
+ * MCP Repository Tools
+ *
+ * Registers repository-related MCP tools on the server.
+ * Each tool is a thin adapter that delegates to a use case.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type DependencyContainer from 'tsyringe/dist/typings/types/dependency-container.js';
+/**
+ * Register repository-related MCP tools on the server.
+ */
+export declare function registerRepoTools(server: McpServer, container: DependencyContainer): void;
+//# sourceMappingURL=repo-tools.d.ts.map

package/dist/packages/core/src/infrastructure/services/mcp/tools/repo-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-tools.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/services/mcp/tools/repo-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,mBAAmB,MAAM,qDAAqD,CAAC;AAoB3F;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,mBAAmB,GAAG,IAAI,CAiBzF"}

package/dist/packages/core/src/infrastructure/services/mcp/tools/repo-tools.js

@@ -0,0 +1,39 @@
+/**
+ * MCP Repository Tools
+ *
+ * Registers repository-related MCP tools on the server.
+ * Each tool is a thin adapter that delegates to a use case.
+ */
+import { ListRepositoriesUseCase } from '../../../../application/use-cases/repositories/list-repositories.use-case.js';
+/**
+ * Wraps an async handler in try/catch, returning MCP error responses on failure.
+ */
+async function withErrorHandling(fn) {
+    try {
+        return await fn();
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: message }],
+            isError: true,
+        };
+    }
+}
+/**
+ * Register repository-related MCP tools on the server.
+ */
+export function registerRepoTools(server, container) {
+    server.registerTool('list_repositories', {
+        description: 'List all repositories tracked by shep.',
+        inputSchema: {},
+    }, async () => {
+        return withErrorHandling(async () => {
+            const useCase = container.resolve(ListRepositoriesUseCase);
+            const repositories = await useCase.execute();
+            return {
+                content: [{ type: 'text', text: JSON.stringify(repositories, null, 2) }],
+            };
+        });
+    });
+}

package/dist/packages/core/src/infrastructure/services/mcp/tools/settings-tools.d.ts

@@ -0,0 +1,13 @@
+/**
+ * MCP Settings Tools
+ *
+ * Registers settings-related MCP tools on the server.
+ * Each tool is a thin adapter that delegates to a use case.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type DependencyContainer from 'tsyringe/dist/typings/types/dependency-container.js';
+/**
+ * Register settings-related MCP tools on the server.
+ */
+export declare function registerSettingsTools(server: McpServer, container: DependencyContainer): void;
+//# sourceMappingURL=settings-tools.d.ts.map

package/dist/packages/core/src/infrastructure/services/mcp/tools/settings-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-tools.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/services/mcp/tools/settings-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,mBAAmB,MAAM,qDAAqD,CAAC;AAsB3F;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,mBAAmB,GAAG,IAAI,CAwC7F"}

package/dist/packages/core/src/infrastructure/services/mcp/tools/settings-tools.js

@@ -0,0 +1,57 @@
+/**
+ * MCP Settings Tools
+ *
+ * Registers settings-related MCP tools on the server.
+ * Each tool is a thin adapter that delegates to a use case.
+ */
+import { z } from 'zod';
+import { LoadSettingsUseCase } from '../../../../application/use-cases/settings/load-settings.use-case.js';
+import { UpdateSettingsUseCase } from '../../../../application/use-cases/settings/update-settings.use-case.js';
+/**
+ * Wraps an async handler in try/catch, returning MCP error responses on failure.
+ */
+async function withErrorHandling(fn) {
+    try {
+        return await fn();
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: message }],
+            isError: true,
+        };
+    }
+}
+/**
+ * Register settings-related MCP tools on the server.
+ */
+export function registerSettingsTools(server, container) {
+    server.registerTool('get_settings', {
+        description: 'Get the current shep settings including models, agent, environment, and workflow configuration.',
+        inputSchema: {},
+    }, async () => {
+        return withErrorHandling(async () => {
+            const useCase = container.resolve(LoadSettingsUseCase);
+            const settings = await useCase.execute();
+            return {
+                content: [{ type: 'text', text: JSON.stringify(settings, null, 2) }],
+            };
+        });
+    });
+    server.registerTool('update_settings', {
+        description: 'Update shep settings. Pass the full settings object with desired changes. Returns the updated settings.',
+        inputSchema: {
+            settings: z
+                .record(z.string(), z.unknown())
+                .describe('Settings object with fields to update'),
+        },
+    }, async ({ settings }) => {
+        return withErrorHandling(async () => {
+            const useCase = container.resolve(UpdateSettingsUseCase);
+            const updated = await useCase.execute(settings);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(updated, null, 2) }],
+            };
+        });
+    });
+}

package/dist/src/presentation/cli/commands/mcp.command.d.ts

@@ -0,0 +1,20 @@
+/**
+ * MCP Command
+ *
+ * Starts the shep MCP (Model Context Protocol) server in foreground mode.
+ * The server listens on stdio for JSON-RPC messages, exposing shep capabilities
+ * as MCP tools that AI clients (Claude Desktop, Cursor, VS Code, etc.) can discover
+ * and invoke.
+ *
+ * Usage: shep mcp [--log-level <level>]
+ *
+ * @example
+ * $ shep mcp
+ * # Server starts on stdio — configure your MCP client to spawn this process
+ */
+import { Command } from 'commander';
+/**
+ * Create the mcp command
+ */
+export declare function createMcpCommand(): Command;
+//# sourceMappingURL=mcp.command.d.ts.map