@shepai/cli 1.151.2 → 1.152.0-pr476.cafabb8

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}`)];
+    }
+}

package/dist/packages/core/src/infrastructure/services/interactive/interactive-session.service.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Interactive Session Service
+ *
+ * Singleton service that owns the lifecycle of all interactive agent sessions.
+ * Uses the IAgentExecutorFactory to create interactive executors that manage
+ * persistent sessions via the agent SDK. Multi-turn context is maintained
+ * by the SDK session handle internally.
+ *
+ * Dependencies are injected via constructor for testability (no real processes
+ * are spawned in unit tests — the factory is replaced with a test double).
+ */
+import type { IInteractiveSessionService, StreamChunk, UnsubscribeFn, ChatState } from '../../../application/ports/output/services/interactive-session-service.interface.js';
+import type { IInteractiveSessionRepository } from '../../../application/ports/output/repositories/interactive-session-repository.interface.js';
+import type { IInteractiveMessageRepository } from '../../../application/ports/output/repositories/interactive-message-repository.interface.js';
+import type { IAgentExecutorFactory } from '../../../application/ports/output/agents/agent-executor-factory.interface.js';
+import type { IFeatureRepository } from '../../../application/ports/output/repositories/feature-repository.interface.js';
+import type { InteractiveSession, InteractiveMessage } from '../../../domain/generated/output.js';
+import { type FeatureContextBuilder } from './feature-context.builder.js';
+/**
+ * Core service managing interactive agent session lifecycles.
+ * Must be registered as a singleton in the DI container.
+ *
+ * **Polymorphic `featureId` scope key:** The `featureId` parameter accepted
+ * by public methods (`sendUserMessage`, `getChatState`, `subscribeByFeature`,
+ * etc.) is a polymorphic scope key — not necessarily a feature UUID:
+ * - Feature chat: actual feature UUID (e.g. `"feat-abc123"`)
+ * - Repository chat: repo identifier (e.g. `"repo-<repoId>"`)
+ * - Global chat: literal string `"global"`
+ *
+ * Sessions and messages are isolated by this key regardless of chat type.
+ *
+ * @todo Consider renaming to `scopeId` + adding a `scopeType` discriminator.
+ */
+export declare class InteractiveSessionService implements IInteractiveSessionService {
+    private readonly sessionRepo;
+    private readonly messageRepo;
+    private readonly executorFactory;
+    private readonly featureRepo;
+    private readonly contextBuilder;
+    /** Live sessions indexed by sessionId. */
+    private sessions;
+    /** Cached agentSessionIds from stopped sessions, keyed by featureId. */
+    private stoppedAgentSessionIds;
+    constructor(sessionRepo: IInteractiveSessionRepository, messageRepo: IInteractiveMessageRepository, executorFactory: IAgentExecutorFactory, featureRepo: IFeatureRepository, contextBuilder: FeatureContextBuilder);
+    startSession(featureId: string, worktreePath: string, model?: string, agentType?: string): Promise<InteractiveSession>;
+    /**
+     * Asynchronously complete the boot sequence: build feature context,
+     * create an SDK session via the interactive executor, send the boot
+     * prompt, iterate the stream for the greeting, persist the greeting,
+     * and transition the session to "ready".
+     */
+    private completeBootAsync;
+    stopSession(sessionId: string): Promise<void>;
+    sendMessage(sessionId: string, content: string): Promise<InteractiveMessage>;
+    /**
+     * Execute a turn via the SDK session handle and persist the assistant response.
+     */
+    private executeAndPersistTurn;
+    getMessages(featureId: string, limit?: number): Promise<InteractiveMessage[]>;
+    clearMessages(featureId: string): Promise<void>;
+    getSession(sessionId: string): Promise<InteractiveSession | null>;
+    subscribe(sessionId: string, onChunk: (chunk: StreamChunk) => void): UnsubscribeFn;
+    sendUserMessage(featureId: string, content: string, worktreePath: string): Promise<InteractiveMessage>;
+    getChatState(featureId: string): Promise<ChatState>;
+    subscribeByFeature(featureId: string, onChunk: (chunk: StreamChunk) => void): UnsubscribeFn;
+    stopByFeature(featureId: string): Promise<void>;
+    markRead(featureId: string): Promise<void>;
+    getTurnStatuses(featureIds: string[]): Promise<Map<string, string>>;
+    getAllActiveTurnStatuses(): Promise<Map<string, string>>;
+    /** Find the in-memory state for an active session for a feature. */
+    private findActiveStateForFeature;
+    /** Resolve the agent type from an explicit override or settings. */
+    private resolveAgentType;
+    /** Resolve the auth config from settings, with a safe fallback. */
+    private resolveAuthConfig;
+    /**
+     * Persist a tool/system event as its own assistant message in the DB.
+     * Each event gets its own bubble in the chat thread.
+     */
+    private persistToolEvent;
+    /** Start or restart the idle timeout timer for a session. */
+    private resetTimer;
+    /** Cancel the idle timer for a session. */
+    private clearTimer;
+    /** Read the auto-timeout from settings or fall back to default. */
+    private getTimeoutMs;
+    /** Read the concurrent session cap from settings or fall back to default. */
+    private getCap;
+}
+//# sourceMappingURL=interactive-session.service.d.ts.map

package/dist/packages/core/src/infrastructure/services/interactive/interactive-session.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-session.service.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/interactive/interactive-session.service.ts"],"names":[],"mappings":"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"}