@shepai/cli 1.151.2-pr438.6135e39 → 1.151.2-pr460.095bbae

package/dist/packages/core/src/infrastructure/services/agents/common/executors/claude-code-interactive-executor.service.js

@@ -0,0 +1,280 @@
+/**
+ * Claude Code Interactive Executor Service
+ *
+ * Infrastructure implementation of IInteractiveAgentExecutor using the
+ * @anthropic-ai/claude-agent-sdk V2 session API. This is the ONLY file
+ * that imports from the SDK.
+ *
+ * Design decisions:
+ * - The CLAUDECODE env var is stripped to prevent nested-session detection
+ *   errors when shep itself is running inside a Claude Code session.
+ * - SDK message types are mapped to our own InteractiveAgentEvent to
+ *   keep the application layer decoupled from SDK specifics.
+ */
+import { unstable_v2_createSession, unstable_v2_resumeSession, } from '@anthropic-ai/claude-agent-sdk';
+/** Default model used when options.model is not specified. */
+const DEFAULT_MODEL = 'claude-sonnet-4-6';
+export class ClaudeCodeInteractiveExecutor {
+    async createSession(options) {
+        const sdkSession = this.withCwd(options.cwd, () => unstable_v2_createSession(this.buildSdkOptions(options)));
+        return this.wrapSession(sdkSession);
+    }
+    async resumeSession(sessionId, options) {
+        const sdkSession = this.withCwd(options.cwd, () => unstable_v2_resumeSession(sessionId, this.buildSdkOptions(options)));
+        return this.wrapSession(sdkSession);
+    }
+    /**
+     * SDKSessionOptions (V2) does not support a `cwd` parameter.
+     * Temporarily change process.cwd() for session creation, then restore.
+     * This is safe because Node.js is single-threaded and SDK session creation
+     * is synchronous (returns immediately, spawns process in background).
+     */
+    withCwd(cwd, fn) {
+        const originalCwd = process.cwd();
+        try {
+            process.chdir(cwd);
+            return fn();
+        }
+        finally {
+            process.chdir(originalCwd);
+        }
+    }
+    buildSdkOptions(options) {
+        // Strip CLAUDECODE env var to prevent nested-session detection errors.
+        const { CLAUDECODE: _, ...cleanEnv } = process.env;
+        return {
+            model: options.model ?? DEFAULT_MODEL,
+            permissionMode: 'bypassPermissions',
+            env: cleanEnv,
+        };
+    }
+    wrapSession(sdkSession) {
+        return {
+            get sessionId() {
+                // SDK session ID is not available until after the first message exchange.
+                // Return empty string before that — callers should read it after streaming.
+                try {
+                    return sdkSession.sessionId;
+                }
+                catch {
+                    return '';
+                }
+            },
+            send: (message) => sdkSession.send(message),
+            stream: () => this.mapStream(sdkSession),
+            close: async () => sdkSession.close(),
+        };
+    }
+    async *mapStream(sdkSession) {
+        for await (const msg of sdkSession.stream()) {
+            const events = this.mapSdkMessage(msg);
+            for (const event of events) {
+                yield event;
+            }
+        }
+    }
+    /**
+     * Map a single SDK message to zero or more InteractiveAgentEvents.
+     *
+     * SDK message types we handle:
+     * - stream_event (SDKPartialAssistantMessage): streaming content deltas
+     * - assistant (SDKAssistantMessage): complete assistant turn with tool_use blocks
+     * - result (SDKResultMessage): success or error result
+     * - system (SDKStatusMessage / SDKSystemMessage): status updates
+     * - tool_use_summary: tool execution summaries
+     * - tool_progress: tool execution progress
+     *
+     * Other message types are silently ignored (user replays, auth, etc.)
+     */
+    mapSdkMessage(msg) {
+        const events = [];
+        switch (msg.type) {
+            case 'stream_event': {
+                // SDKPartialAssistantMessage — streaming content delta
+                const evt = msg.event;
+                if (evt.type === 'content_block_delta' &&
+                    'delta' in evt &&
+                    evt.delta.type === 'text_delta' &&
+                    'text' in evt.delta) {
+                    events.push({
+                        type: 'delta',
+                        content: evt.delta.text,
+                    });
+                }
+                break;
+            }
+            case 'assistant': {
+                // SDKAssistantMessage — complete assistant turn with text + tool_use blocks.
+                // Text blocks contain the agent's reasoning between tool calls (e.g.,
+                // "Let me read that file..." or "I see, now I'll..."). These MUST be
+                // emitted as deltas — stream_event deltas may not be available in V2.
+                if ('message' in msg && msg.message?.content) {
+                    for (const block of msg.message.content) {
+                        if (block.type === 'text' && block.text) {
+                            events.push({
+                                type: 'delta',
+                                content: block.text,
+                            });
+                        }
+                        else if (block.type === 'tool_use') {
+                            events.push({
+                                type: 'tool_use',
+                                label: block.name,
+                                detail: JSON.stringify(block.input ?? {}),
+                            });
+                        }
+                    }
+                }
+                // If the assistant message contains an error, emit it
+                if ('error' in msg && msg.error) {
+                    events.push({
+                        type: 'error',
+                        content: String(msg.error),
+                    });
+                }
+                break;
+            }
+            case 'result': {
+                // SDKResultMessage — success or error
+                if (msg.subtype === 'success') {
+                    events.push({
+                        type: 'done',
+                        content: msg.result,
+                        usage: {
+                            costUsd: msg.total_cost_usd,
+                            inputTokens: msg.usage?.input_tokens,
+                            outputTokens: msg.usage?.output_tokens,
+                            numTurns: msg.num_turns,
+                            durationMs: msg.duration_ms,
+                        },
+                    });
+                }
+                else {
+                    // SDKResultError
+                    const errorMsg = 'errors' in msg && Array.isArray(msg.errors) ? msg.errors.join('; ') : msg.subtype;
+                    events.push({
+                        type: 'error',
+                        content: errorMsg,
+                    });
+                }
+                break;
+            }
+            case 'system': {
+                if (!('subtype' in msg))
+                    break;
+                switch (msg.subtype) {
+                    case 'init':
+                        // Session initialized — model, tools, version
+                        if ('model' in msg) {
+                            const tools = 'tools' in msg && Array.isArray(msg.tools) ? msg.tools : [];
+                            const version = 'claude_code_version' in msg ? String(msg.claude_code_version) : '';
+                            events.push({
+                                type: 'init',
+                                label: String(msg.model),
+                                detail: `${tools.length} tools`,
+                                content: version ? `v${version}` : undefined,
+                            });
+                        }
+                        break;
+                    case 'status':
+                        if ('status' in msg) {
+                            events.push({
+                                type: 'status',
+                                content: String(msg.status ?? 'ready'),
+                            });
+                        }
+                        break;
+                    case 'api_retry':
+                        // API retry — let user know agent is retrying
+                        if ('attempt' in msg) {
+                            const attempt = msg.attempt;
+                            const maxRetries = 'max_retries' in msg ? msg.max_retries : '?';
+                            const delayMs = 'retry_delay_ms' in msg ? msg.retry_delay_ms : 0;
+                            const delaySec = Math.round(delayMs / 1000);
+                            events.push({
+                                type: 'api_retry',
+                                content: `Retrying API call (attempt ${attempt}/${maxRetries})${delaySec > 0 ? `, waiting ${delaySec}s` : ''}`,
+                            });
+                        }
+                        break;
+                    case 'task_started':
+                        if ('description' in msg && 'task_id' in msg) {
+                            events.push({
+                                type: 'task_started',
+                                label: String(msg.task_id),
+                                content: String(msg.description),
+                            });
+                        }
+                        break;
+                    case 'task_progress':
+                        if ('description' in msg && 'task_id' in msg) {
+                            events.push({
+                                type: 'task_progress',
+                                label: String(msg.task_id),
+                                content: String(msg.description),
+                            });
+                        }
+                        break;
+                    case 'task_notification':
+                        if ('summary' in msg && 'task_id' in msg) {
+                            const status = 'status' in msg ? String(msg.status) : 'done';
+                            events.push({
+                                type: 'task_done',
+                                label: String(msg.task_id),
+                                content: String(msg.summary),
+                                detail: status,
+                            });
+                        }
+                        break;
+                }
+                break;
+            }
+            case 'rate_limit_event': {
+                if ('rate_limit_info' in msg) {
+                    const info = msg.rate_limit_info;
+                    const status = info.status;
+                    if (status === 'rejected') {
+                        const resetsAt = info.resetsAt ? new Date(info.resetsAt).toLocaleTimeString() : 'soon';
+                        events.push({
+                            type: 'rate_limit',
+                            content: `Rate limited — resets at ${resetsAt}`,
+                        });
+                    }
+                    else if (status === 'allowed_warning') {
+                        const pct = info.utilization ? `${Math.round(info.utilization * 100)}%` : '';
+                        events.push({
+                            type: 'rate_limit',
+                            content: `Rate limit warning${pct ? ` (${pct} used)` : ''}`,
+                        });
+                    }
+                }
+                break;
+            }
+            case 'tool_use_summary': {
+                if ('summary' in msg) {
+                    events.push({
+                        type: 'tool_result',
+                        content: msg.summary,
+                    });
+                }
+                break;
+            }
+            case 'tool_progress': {
+                if ('tool_name' in msg) {
+                    events.push({
+                        type: 'status',
+                        label: msg.tool_name,
+                        content: `Running ${msg.tool_name}...`,
+                    });
+                }
+                break;
+            }
+            default:
+                // Ignore: user, user_replay, auth_status, compact_boundary,
+                // local_command_output, hook_*, files_persisted,
+                // elicitation_complete, prompt_suggestion
+                break;
+        }
+        return events;
+    }
+}

package/dist/packages/core/src/infrastructure/services/agents/common/executors/mock-executor-factory.service.d.ts

@@ -6,6 +6,7 @@
  */
 import type { AgentType, AgentConfig } from '../../../../../domain/generated/output.js';
 import type { IAgentExecutor } from '../../../../../application/ports/output/agents/agent-executor.interface.js';
+import type { IInteractiveAgentExecutor } from '../../../../../application/ports/output/agents/interactive-agent-executor.interface.js';
 import type { IAgentExecutorFactory, AgentCliInfo } from '../../../../../application/ports/output/agents/agent-executor-factory.interface.js';
 export declare class MockAgentExecutorFactory implements IAgentExecutorFactory {
     private readonly executor;
@@ -13,5 +14,7 @@ export declare class MockAgentExecutorFactory implements IAgentExecutorFactory {
     getSupportedAgents(): AgentType[];
     getCliInfo(): AgentCliInfo[];
     getSupportedModels(_agentType: AgentType): string[];
+    createInteractiveExecutor(_agentType: AgentType, _authConfig: AgentConfig): IInteractiveAgentExecutor;
+    supportsInteractive(_agentType: AgentType): boolean;
 }
 //# sourceMappingURL=mock-executor-factory.service.d.ts.map

package/dist/packages/core/src/infrastructure/services/agents/common/executors/mock-executor-factory.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mock-executor-factory.service.d.ts","sourceRoot":"","sources":["../../../../../../../../../packages/core/src/infrastructure/services/agents/common/executors/mock-executor-factory.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4EAA4E,CAAC;AACjH,OAAO,KAAK,EACV,qBAAqB,EACrB,YAAY,EACb,MAAM,oFAAoF,CAAC;AAG5F,qBAAa,wBAAyB,YAAW,qBAAqB;IACpE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAE3D,cAAc,CAAC,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,GAAG,cAAc;IAI/E,kBAAkB,IAAI,SAAS,EAAE;IAIjC,UAAU,IAAI,YAAY,EAAE;IAI5B,kBAAkB,CAAC,UAAU,EAAE,SAAS,GAAG,MAAM,EAAE;CAGpD"}
+{"version":3,"file":"mock-executor-factory.service.d.ts","sourceRoot":"","sources":["../../../../../../../../../packages/core/src/infrastructure/services/agents/common/executors/mock-executor-factory.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4EAA4E,CAAC;AACjH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wFAAwF,CAAC;AACxI,OAAO,KAAK,EACV,qBAAqB,EACrB,YAAY,EACb,MAAM,oFAAoF,CAAC;AAG5F,qBAAa,wBAAyB,YAAW,qBAAqB;IACpE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAE3D,cAAc,CAAC,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,GAAG,cAAc;IAI/E,kBAAkB,IAAI,SAAS,EAAE;IAIjC,UAAU,IAAI,YAAY,EAAE;IAI5B,kBAAkB,CAAC,UAAU,EAAE,SAAS,GAAG,MAAM,EAAE;IAInD,yBAAyB,CACvB,UAAU,EAAE,SAAS,EACrB,WAAW,EAAE,WAAW,GACvB,yBAAyB;IAI5B,mBAAmB,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO;CAGpD"}

package/dist/packages/core/src/infrastructure/services/agents/common/executors/mock-executor-factory.service.js

@@ -19,4 +19,10 @@ export class MockAgentExecutorFactory {
     getSupportedModels(_agentType) {
         return [];
     }
+    createInteractiveExecutor(_agentType, _authConfig) {
+        throw new Error('Interactive sessions are not supported in mock executor');
+    }
+    supportsInteractive(_agentType) {
+        return false;
+    }
 }

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/feature-agent-graph.d.ts

@@ -89,7 +89,7 @@ export declare function createFeatureAgentGraph(depsOrExecutor: FeatureAgentGrap
     ciFixAttempts?: number | undefined;
     ciFixHistory?: import("../../../../domain/index.js").CiFixRecord[] | undefined;
     ciFixStatus?: "success" | "timeout" | "idle" | "watching" | "fixing" | "exhausted" | undefined;
-}, "implement" | "__start__" | "analyze" | "requirements" | "research" | "plan" | "validate_spec_analyze" | "validate_spec_requirements" | "validate_research" | "validate_plan_tasks" | "repair_spec_analyze" | "repair_spec_requirements" | "repair_research" | "repair_plan_tasks", {
+}, "plan" | "implement" | "__start__" | "analyze" | "requirements" | "research" | "validate_spec_analyze" | "validate_spec_requirements" | "validate_research" | "validate_plan_tasks" | "repair_spec_analyze" | "repair_spec_requirements" | "repair_research" | "repair_plan_tasks", {
     featureId: {
         (): import("@langchain/langgraph").LastValue<string>;
         (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;

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

@@ -5,7 +5,7 @@
  * checks, repository listing, cloning (with progress streaming), and URL parsing.
  */
 import type { ExecFunction } from '../git/worktree.service.js';
-import type { IGitHubRepositoryService, GitHubRepo, ListUserRepositoriesOptions, CloneOptions, ParsedGitHubUrl, ForkResult } from '../../../application/ports/output/services/github-repository-service.interface.js';
+import type { IGitHubRepositoryService, GitHubRepo, ListUserRepositoriesOptions, CloneOptions, ParsedGitHubUrl } from '../../../application/ports/output/services/github-repository-service.interface.js';
 export declare class GitHubRepositoryService implements IGitHubRepositoryService {
     private readonly execFile;
     constructor(execFile: ExecFunction);
@@ -13,8 +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;
-    checkPushAccess(repoNameWithOwner: string): Promise<boolean>;
-    forkRepository(repoNameWithOwner: string): Promise<ForkResult>;
     getViewerPermission(repoPath: string): Promise<string>;
     private cleanupPartialClone;
 }

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,EACf,UAAU,EACX,MAAM,mFAAmF,CAAC;AA0B3F,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,eAAe,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAe5D,cAAc,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAwB9D,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;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"}

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, GitHubForkError, GitHubPermissionError, GitHubRepoListError, GitHubUrlParseError, } from '../../../application/ports/output/services/github-repository-service.interface.js';
+import { GitHubAuthError, GitHubCloneError, GitHubPermissionError, GitHubRepoListError, GitHubUrlParseError, } from '../../../application/ports/output/services/github-repository-service.interface.js';
 // ---------------------------------------------------------------------------
 // URL regex patterns
 // ---------------------------------------------------------------------------
@@ -154,42 +154,6 @@ let GitHubRepositoryService = class GitHubRepositoryService {
             'Supported formats: https://github.com/owner/repo, ' +
             'git@github.com:owner/repo.git, or owner/repo shorthand.');
     }
-    async checkPushAccess(repoNameWithOwner) {
-        try {
-            const { stdout } = await this.execFile('gh', [
-                'api',
-                `repos/${repoNameWithOwner}`,
-                '--jq',
-                '.permissions.push',
-            ]);
-            return stdout.trim() === 'true';
-        }
-        catch {
-            // Safe fallback: assume no push access on any error (NFR-9)
-            return false;
-        }
-    }
-    async forkRepository(repoNameWithOwner) {
-        try {
-            const { stdout } = await this.execFile('gh', [
-                'repo',
-                'fork',
-                repoNameWithOwner,
-                '--clone=false',
-                '--json',
-                'nameWithOwner,url',
-            ]);
-            const parsed = JSON.parse(stdout);
-            return {
-                nameWithOwner: parsed.nameWithOwner,
-                cloneUrl: parsed.url.endsWith('.git') ? parsed.url : `${parsed.url}.git`,
-            };
-        }
-        catch (error) {
-            const cause = error instanceof Error ? error : undefined;
-            throw new GitHubForkError(`Failed to fork ${repoNameWithOwner}: ${cause?.message ?? String(error)}`, cause);
-        }
-    }
     async getViewerPermission(repoPath) {
         try {
             const { stdout } = await this.execFile('gh', ['repo', 'view', '--json', 'viewerPermission'], {

package/dist/packages/core/src/infrastructure/services/git/git-pr.service.d.ts

@@ -5,7 +5,7 @@
  * Uses constructor dependency injection for the command executor.
  */
 import type { IGitPrService } from '../../../application/ports/output/services/git-pr-service.interface.js';
-import type { CiStatusResult, DiffSummary, FileDiff, MergeStrategy, PrCreateArgs, PrCreateResult, PrStatusInfo } from '../../../application/ports/output/services/git-pr-service.interface.js';
+import type { CiStatusResult, DiffSummary, FileDiff, MergeStrategy, PrCreateResult, PrStatusInfo } from '../../../application/ports/output/services/git-pr-service.interface.js';
 import type { ExecFunction } from './worktree.service.js';
 export declare class GitPrService implements IGitPrService {
     private readonly execFile;
@@ -18,7 +18,6 @@ export declare class GitPrService implements IGitPrService {
     commitAll(cwd: string, message: string): Promise<string>;
     push(cwd: string, branch: string, setUpstream?: boolean): Promise<void>;
     createPr(cwd: string, prYamlPath: string): Promise<PrCreateResult>;
-    createPrFromArgs(cwd: string, args: PrCreateArgs): Promise<PrCreateResult>;
     mergePr(cwd: string, prNumber: number, strategy?: MergeStrategy): Promise<void>;
     private getPrHeadBranch;
     localMergeSquash(cwd: string, featureBranch: string, baseBranch: string, commitMessage: string, hasRemote?: boolean): Promise<void>;

package/dist/packages/core/src/infrastructure/services/git/git-pr.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git-pr.service.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/git/git-pr.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"git-pr.service.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/git/git-pr.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wEAAwE,CAAC;AAC5G,OAAO,KAAK,EACV,cAAc,EAGd,WAAW,EACX,QAAQ,EACR,aAAa,EACb,cAAc,EACd,YAAY,EACb,MAAM,wEAAwE,CAAC;AAUhF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,qBACa,YAAa,YAAW,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,YAAY;IAErE,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKxC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAgBjD,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgF9C,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKnD,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKpD,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAWxD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAYvE,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAuClE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,aAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;YA6BjF,eAAe;IASvB,gBAAgB,CACpB,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,SAAS,UAAQ,GAChB,OAAO,CAAC,IAAI,CAAC;IA4EV,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUnF,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAsBjE,OAAO,CACX,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,cAAc,CAAC;IAiEpB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAWhF,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAevE,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAaxE,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,aAAa;IAmFf,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAoCpD,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAc/E,WAAW,CACf,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,OAAO,CAAC;IA6CnB;;;OAGG;YACW,UAAU;IAmBlB,cAAc,CAClB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,WAAW,SAAS,GACnB,OAAO,CAAC,MAAM,CAAC;IAWlB,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,aAAa;IAsBrB,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,oBAAoB;IAK5B,OAAO,CAAC,aAAa;IAoBf,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0CxD,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyEnF,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAelD,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQvD,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB1C,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQvC,mBAAmB,CACvB,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAe9C"}

package/dist/packages/core/src/infrastructure/services/git/git-pr.service.js

@@ -184,27 +184,6 @@ let GitPrService = class GitPrService {
             throw this.parseGhError(error);
         }
     }
-    async createPrFromArgs(cwd, args) {
-        try {
-            const ghArgs = ['pr', 'create', '--title', args.title, '--body', args.body];
-            if (args.base) {
-                ghArgs.push('--base', args.base);
-            }
-            if (args.labels?.length) {
-                ghArgs.push('--label', args.labels.join(','));
-            }
-            if (args.repo) {
-                ghArgs.push('--repo', args.repo);
-            }
-            const { stdout } = await this.execFile('gh', ghArgs, { cwd });
-            const url = stdout.trim();
-            const number = this.parsePrNumberFromUrl(url);
-            return { url, number };
-        }
-        catch (error) {
-            throw this.parseGhError(error);
-        }
-    }
     async mergePr(cwd, prNumber, strategy = 'squash') {
         try {
             await this.execFile('gh', ['pr', 'merge', String(prNumber), `--${strategy}`], {

package/dist/packages/core/src/infrastructure/services/interactive/feature-context.builder.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Feature Context Builder
+ *
+ * Builds the system prompt context for the interactive agent session.
+ * Includes Shep identity, CLI reference, feature context, and behavioral guidelines.
+ * The output string is suitable for use as systemPrompt content in SDK sessions.
+ */
+import type { Feature } from '../../../domain/generated/output.js';
+/**
+ * Builds concise feature context strings for agent bootstrap prompts.
+ * Stateless — safe to reuse across sessions.
+ */
+export declare class FeatureContextBuilder {
+    /**
+     * Build the full system prompt for the interactive agent.
+     *
+     * @param feature - The feature domain object
+     * @param worktreePath - Absolute CWD of the agent process
+     * @param openPRs - List of open PR URLs to include (may be empty)
+     * @returns A formatted context string suitable for systemPrompt or boot prompt injection
+     */
+    buildContext(feature: Feature, worktreePath: string, openPRs: string[]): string;
+    private buildTasksSection;
+    private buildPRsSection;
+}
+//# sourceMappingURL=feature-context.builder.d.ts.map

package/dist/packages/core/src/infrastructure/services/interactive/feature-context.builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-context.builder.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/interactive/feature-context.builder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AAqDnE;;;GAGG;AACH,qBAAa,qBAAqB;IAChC;;;;;;;OAOG;IACH,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM;IA0D/E,OAAO,CAAC,iBAAiB;IAkBzB,OAAO,CAAC,eAAe;CAIxB"}

package/dist/packages/core/src/infrastructure/services/interactive/feature-context.builder.js

@@ -0,0 +1,140 @@
+/**
+ * Feature Context Builder
+ *
+ * Builds the system prompt context for the interactive agent session.
+ * Includes Shep identity, CLI reference, feature context, and behavioral guidelines.
+ * The output string is suitable for use as systemPrompt content in SDK sessions.
+ */
+import { execFileSync } from 'node:child_process';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+/** Maximum number of plan tasks to include in the context. */
+const MAX_TASKS = 30;
+/** Cached CLI help text — generated once per process lifetime. */
+let cachedCliHelp = null;
+/**
+ * Generates the full recursive CLI help text by running `shep --help` and
+ * subcommand help for all registered commands. Cached after first call.
+ */
+function getCliHelpText() {
+    if (cachedCliHelp)
+        return cachedCliHelp;
+    try {
+        const mainHelp = execFileSync('shep', ['--help'], {
+            timeout: 5000,
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        // Extract subcommand names from help output
+        const cmdLines = mainHelp.split('\n').filter((l) => /^\s{2}\w/.test(l));
+        const subCommands = cmdLines
+            .map((l) => l.trim().split(/\s+/)[0])
+            .filter((cmd) => !!cmd && cmd !== 'help');
+        const parts = [mainHelp];
+        for (const cmd of subCommands) {
+            try {
+                const subHelp = execFileSync('shep', [cmd, '--help'], {
+                    timeout: 3000,
+                    encoding: 'utf8',
+                    stdio: ['pipe', 'pipe', 'pipe'],
+                }).trim();
+                if (subHelp) {
+                    parts.push(`\n--- shep ${cmd} ---\n${subHelp}`);
+                }
+            }
+            catch {
+                // Some commands may not have --help or may fail
+            }
+        }
+        cachedCliHelp = parts.join('\n');
+    }
+    catch {
+        cachedCliHelp = '(CLI help unavailable — shep binary not found in PATH)';
+    }
+    return cachedCliHelp;
+}
+/**
+ * Builds concise feature context strings for agent bootstrap prompts.
+ * Stateless — safe to reuse across sessions.
+ */
+export class FeatureContextBuilder {
+    /**
+     * Build the full system prompt for the interactive agent.
+     *
+     * @param feature - The feature domain object
+     * @param worktreePath - Absolute CWD of the agent process
+     * @param openPRs - List of open PR URLs to include (may be empty)
+     * @returns A formatted context string suitable for systemPrompt or boot prompt injection
+     */
+    buildContext(feature, worktreePath, openPRs) {
+        const shepHome = process.env.SHEP_HOME ?? join(homedir(), '.shep');
+        let version = 'unknown';
+        try {
+            version = execFileSync('shep', ['--version'], {
+                timeout: 3000,
+                encoding: 'utf8',
+                stdio: ['pipe', 'pipe', 'pipe'],
+            }).trim();
+        }
+        catch {
+            // fallback
+        }
+        const sections = [];
+        // ── Identity ──────────────────────────────────────────────────────────
+        sections.push(`# Shep Interactive Agent
+You are **Shep** — the interactive AI assistant for the Shep SDLC platform.
+Shep is an Autonomous AI Native SDLC Platform that automates the development
+cycle from idea to deploy.
+
+Version: ${version}
+SHEP_HOME: ${shepHome}
+Platform: ${process.platform} (${process.arch})`);
+        // ── Behavioral guidelines ─────────────────────────────────────────────
+        sections.push(`## Behavior
+- You are smart, adaptive, and match the user's communication style.
+- Be concise by default. If the user writes short messages, respond short.
+  If they write detailed messages, respond with more detail.
+- Don't jump to action immediately. First understand what the user needs.
+  Ask clarifying questions when the request is ambiguous.
+- When you DO act, be thorough and explain what you did.
+- You have full access to the worktree via your tools (git, gh, filesystem,
+  bash, read, write, edit, grep, glob). Use them proactively.
+- You know the Shep CLI inside out. Help users with any shep command.
+- When working on this feature, stay focused on the feature context below.
+- If the user asks about Shep itself, answer from your knowledge of the CLI.`);
+        // ── CLI Reference ─────────────────────────────────────────────────────
+        sections.push(`## Shep CLI Reference
+\`\`\`
+${getCliHelpText()}
+\`\`\``);
+        // ── Feature context ───────────────────────────────────────────────────
+        sections.push(`## Current Feature
+Name: ${feature.name}
+Description: ${feature.description}
+Phase: ${feature.lifecycle}
+Branch: ${feature.branch}
+Worktree: ${worktreePath}
+${this.buildTasksSection(feature).join('\n')}
+${this.buildPRsSection(openPRs).join('\n')}`);
+        return sections.join('\n\n');
+    }
+    buildTasksSection(feature) {
+        const tasks = feature.plan?.tasks;
+        if (!tasks || tasks.length === 0) {
+            return ['Tasks: none'];
+        }
+        const displayed = tasks.slice(0, MAX_TASKS);
+        const truncated = tasks.length > MAX_TASKS ? ` (showing first ${MAX_TASKS})` : '';
+        const header = `Tasks (${tasks.length}${truncated}):`;
+        const taskLines = displayed.map((t) => {
+            const title = t.title ?? t.id;
+            return `  [${t.state}] ${title}`;
+        });
+        return [header, ...taskLines];
+    }
+    buildPRsSection(openPRs) {
+        if (openPRs.length === 0)
+            return [];
+        return ['Open PRs:', ...openPRs.map((url) => `  - ${url}`)];
+    }
+}