@shepai/cli 1.119.0 → 1.120.0-pr384.fdb89bb

package/dist/packages/core/src/infrastructure/services/deployment/dev-environment-agent.service.js

@@ -0,0 +1,210 @@
+/**
+ * Dev Environment Agent Service
+ *
+ * AI-driven service that analyzes any repository to determine how to start
+ * a local dev environment. Language-agnostic — supports Node.js, Python,
+ * Go, Rust, Java, Ruby, and more. Uses structured agent calls to get
+ * typed analysis results.
+ *
+ * Features:
+ * - In-memory per-repo caching for fast repeated calls
+ * - Reads key config files (package.json, Cargo.toml, etc.) for context
+ * - Handles "not deployable" repos gracefully
+ * - Truncates large files to prevent prompt overflow
+ */
+import { readdirSync, readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { createDeploymentLogger } from './deployment-logger.js';
+const log = createDeploymentLogger('[DevEnvironmentAgent]');
+/** Max characters to include from any single config file. */
+const MAX_FILE_CONTENT_LENGTH = 4000;
+/** Config files to read and include in the prompt, in priority order. */
+const CONFIG_FILES = [
+    'package.json',
+    'docker-compose.yml',
+    'docker-compose.yaml',
+    'Dockerfile',
+    'Makefile',
+    'Cargo.toml',
+    'go.mod',
+    'requirements.txt',
+    'Pipfile',
+    'pyproject.toml',
+    'setup.py',
+    'Gemfile',
+    'build.gradle',
+    'pom.xml',
+    'mix.exs',
+    'deno.json',
+    'bun.lockb',
+];
+/** JSON schema for the structured agent response. */
+const ANALYSIS_SCHEMA = {
+    type: 'object',
+    properties: {
+        deployable: {
+            type: 'boolean',
+            description: 'Whether this repository has a startable dev server or UI. False for libraries, scripts, data repos, etc.',
+        },
+        reason: {
+            type: 'string',
+            description: 'Brief explanation of what was detected or why the repo is not deployable.',
+        },
+        command: {
+            type: ['string', 'null'],
+            description: 'The shell command to start the dev server. Null if not deployable.',
+        },
+        cwd: {
+            type: 'string',
+            description: 'Working directory relative to repo root where the command should run. Use "." for repo root.',
+        },
+        expectedPort: {
+            type: ['integer', 'null'],
+            description: 'Expected port the dev server will listen on. Null if unknown.',
+        },
+        language: {
+            type: ['string', 'null'],
+            description: 'Primary language/runtime (e.g., "node", "python", "go", "rust", "ruby", "java").',
+        },
+        framework: {
+            type: ['string', 'null'],
+            description: 'Detected framework if any (e.g., "next.js", "django", "flask", "gin", "rails").',
+        },
+        setupCommands: {
+            type: 'array',
+            items: { type: 'string' },
+            description: 'Setup commands to run before the dev command (e.g., "npm install", "pip install -r requirements.txt").',
+        },
+    },
+    required: [
+        'deployable',
+        'reason',
+        'command',
+        'cwd',
+        'expectedPort',
+        'language',
+        'framework',
+        'setupCommands',
+    ],
+    additionalProperties: false,
+};
+const defaultDeps = {
+    structuredAgentCaller: null,
+    readdir: (path) => readdirSync(path, { encoding: 'utf-8' }),
+    readFile: (path) => readFileSync(path, 'utf-8'),
+    existsSync,
+};
+export class DevEnvironmentAgentService {
+    cache = new Map();
+    deps;
+    constructor(deps) {
+        this.deps = { ...defaultDeps, ...deps };
+    }
+    async analyze(repositoryPath, options) {
+        log.info(`analyze() called — repositoryPath="${repositoryPath}", skipCache=${options?.skipCache ?? false}`);
+        if (!this.deps.existsSync(repositoryPath)) {
+            throw new Error(`Repository path does not exist: ${repositoryPath}`);
+        }
+        // Check cache
+        if (!options?.skipCache) {
+            const cached = this.cache.get(repositoryPath);
+            if (cached) {
+                log.info(`cache hit for "${repositoryPath}"`);
+                return cached;
+            }
+        }
+        // Build prompt with repo context
+        const prompt = this.buildPrompt(repositoryPath);
+        log.info(`calling structured agent for "${repositoryPath}"`);
+        const result = await this.deps.structuredAgentCaller.call(prompt, ANALYSIS_SCHEMA, {
+            silent: true,
+            maxTurns: 3,
+            cwd: repositoryPath,
+        });
+        // Cache successful result
+        this.cache.set(repositoryPath, result);
+        log.info(`analysis complete — deployable=${result.deployable}, command=${result.command}, language=${result.language}`);
+        return result;
+    }
+    clearCache(repositoryPath) {
+        log.info(`clearCache() — repositoryPath="${repositoryPath}"`);
+        this.cache.delete(repositoryPath);
+    }
+    clearAllCaches() {
+        log.info(`clearAllCaches() — clearing ${this.cache.size} entries`);
+        this.cache.clear();
+    }
+    buildPrompt(repositoryPath) {
+        const dirListing = this.getDirListing(repositoryPath);
+        const configContents = this.readConfigFiles(repositoryPath, dirListing);
+        return `You are a dev environment analysis agent. Analyze this repository and determine how to start a local development server.
+
+## Repository Directory Listing (root level)
+
+${dirListing.join('\n')}
+
+## Config File Contents
+
+${configContents}
+
+## Instructions
+
+Analyze the repository structure and config files above to determine:
+
+1. **Is this repo deployable?** Does it have a web server, API server, or UI that can be started locally?
+   - Libraries (npm packages, Python packages, Go modules meant only for import) are NOT deployable
+   - CLI tools that don't serve HTTP are NOT deployable
+   - Data repositories, documentation-only repos are NOT deployable
+   - Scripts that run once and exit are NOT deployable
+
+2. **What command starts the dev server?** Consider:
+   - Node.js: \`npm run dev\`, \`pnpm dev\`, \`yarn dev\`, \`npm start\`
+   - Python: \`python manage.py runserver\`, \`flask run\`, \`uvicorn main:app --reload\`
+   - Go: \`go run .\`, \`air\` (hot reload)
+   - Rust: \`cargo run\`, \`cargo watch -x run\`
+   - Ruby: \`rails server\`, \`bundle exec rails s\`
+   - Java: \`./gradlew bootRun\`, \`mvn spring-boot:run\`
+   - Docker: \`docker-compose up\`
+   - Generic: \`make dev\`, \`make run\`
+
+3. **What port will it listen on?** Check config files for port definitions.
+
+4. **What setup is needed first?** (e.g., install dependencies)
+
+If the repo has NO server or UI to start, set deployable=false and explain why.
+
+Respond with ONLY the JSON object matching the schema.`;
+    }
+    getDirListing(repositoryPath) {
+        try {
+            return this.deps.readdir(repositoryPath);
+        }
+        catch {
+            log.warn(`Failed to read directory listing for "${repositoryPath}"`);
+            return [];
+        }
+    }
+    readConfigFiles(repositoryPath, dirListing) {
+        const sections = [];
+        for (const configFile of CONFIG_FILES) {
+            if (!dirListing.includes(configFile))
+                continue;
+            try {
+                const filePath = join(repositoryPath, configFile);
+                let content = this.deps.readFile(filePath);
+                // Truncate large files
+                if (content.length > MAX_FILE_CONTENT_LENGTH) {
+                    content = `${content.slice(0, MAX_FILE_CONTENT_LENGTH)}\n... (truncated)`;
+                }
+                sections.push(`### ${configFile}\n\`\`\`\n${content}\n\`\`\``);
+            }
+            catch {
+                log.warn(`Failed to read config file "${configFile}" in "${repositoryPath}"`);
+            }
+        }
+        if (sections.length === 0) {
+            return 'No recognized config files found.';
+        }
+        return sections.join('\n\n');
+    }
+}

package/dist/src/presentation/web/app/actions/deploy-feature.d.ts

@@ -1,7 +1,8 @@
-import { DeploymentState } from '../../../../../packages/core/src/domain/generated/output.js';
+import type { DeploymentState } from '../../../../../packages/core/src/domain/generated/output.js';
 export declare function deployFeature(featureId: string): Promise<{
     success: boolean;
     error?: string;
     state?: DeploymentState;
+    reason?: string;
 }>;
 //# sourceMappingURL=deploy-feature.d.ts.map

package/dist/src/presentation/web/app/actions/deploy-feature.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deploy-feature.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/app/actions/deploy-feature.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAIvE,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,eAAe,CAAA;CAAE,CAAC,CAwCxE"}
+{"version":3,"file":"deploy-feature.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/app/actions/deploy-feature.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAI5E,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,eAAe,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA6CzF"}

package/dist/src/presentation/web/app/actions/deploy-feature.js

@@ -3,7 +3,6 @@ import { existsSync } from 'node:fs';
 import { resolve } from '../../lib/server-container.js';
 import { createDeploymentLogger } from '../../../../../packages/core/src/infrastructure/services/deployment/deployment-logger.js';
 import { computeWorktreePath } from '../../../../../packages/core/src/infrastructure/services/ide-launchers/compute-worktree-path.js';
-import { DeploymentState } from '../../../../../packages/core/src/domain/generated/output.js';
 const log = createDeploymentLogger('[deployFeature]');
 export async function deployFeature(featureId) {
     log.info(`called — featureId="${featureId}"`);
@@ -25,11 +24,15 @@ export async function deployFeature(featureId) {
             log.warn(`worktree path does not exist on disk: "${worktreePath}"`);
             return { success: false, error: `Worktree path does not exist: ${worktreePath}` };
         }
-        log.info('worktree path exists, calling deploymentService.start()');
-        const deploymentService = resolve('IDeploymentService');
-        deploymentService.start(featureId, worktreePath);
-        log.info('start() returned successfully — state=Booting');
-        return { success: true, state: DeploymentState.Booting };
+        log.info('worktree path exists, calling agentDeploymentService.deploy()');
+        const agentDeploymentService = resolve('IAgentDeploymentService');
+        const result = await agentDeploymentService.deploy(featureId, worktreePath);
+        if (!result.success) {
+            log.warn(`agent deployment returned not-deployable: ${result.error}`);
+            return { success: false, error: result.error, reason: result.analysis?.reason };
+        }
+        log.info('deploy() returned successfully — state=Booting');
+        return { success: true, state: result.state };
     }
     catch (error) {
         const message = error instanceof Error ? error.message : 'Failed to deploy feature';

package/dist/src/presentation/web/app/actions/deploy-repository.d.ts

@@ -1,7 +1,8 @@
-import { DeploymentState } from '../../../../../packages/core/src/domain/generated/output.js';
+import type { DeploymentState } from '../../../../../packages/core/src/domain/generated/output.js';
 export declare function deployRepository(repositoryPath: string): Promise<{
     success: boolean;
     error?: string;
     state?: DeploymentState;
+    reason?: string;
 }>;
 //# sourceMappingURL=deploy-repository.d.ts.map

package/dist/src/presentation/web/app/actions/deploy-repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deploy-repository.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/app/actions/deploy-repository.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAIvE,wBAAsB,gBAAgB,CACpC,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,eAAe,CAAA;CAAE,CAAC,CAyBxE"}
+{"version":3,"file":"deploy-repository.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/app/actions/deploy-repository.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAI5E,wBAAsB,gBAAgB,CACpC,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,eAAe,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA8BzF"}

package/dist/src/presentation/web/app/actions/deploy-repository.js

@@ -3,7 +3,6 @@ import { existsSync } from 'node:fs';
 import { isAbsolute } from 'node:path';
 import { resolve } from '../../lib/server-container.js';
 import { createDeploymentLogger } from '../../../../../packages/core/src/infrastructure/services/deployment/deployment-logger.js';
-import { DeploymentState } from '../../../../../packages/core/src/domain/generated/output.js';
 const log = createDeploymentLogger('[deployRepository]');
 export async function deployRepository(repositoryPath) {
     log.info(`called — repositoryPath="${repositoryPath}"`);
@@ -16,11 +15,15 @@ export async function deployRepository(repositoryPath) {
             log.warn(`directory does not exist: "${repositoryPath}"`);
             return { success: false, error: `Directory does not exist: ${repositoryPath}` };
         }
-        log.info('directory exists, calling deploymentService.start()');
-        const deploymentService = resolve('IDeploymentService');
-        deploymentService.start(repositoryPath, repositoryPath);
-        log.info('start() returned successfully — state=Booting');
-        return { success: true, state: DeploymentState.Booting };
+        log.info('directory exists, calling agentDeploymentService.deploy()');
+        const agentDeploymentService = resolve('IAgentDeploymentService');
+        const result = await agentDeploymentService.deploy(repositoryPath, repositoryPath);
+        if (!result.success) {
+            log.warn(`agent deployment returned not-deployable: ${result.error}`);
+            return { success: false, error: result.error, reason: result.analysis?.reason };
+        }
+        log.info('deploy() returned successfully — state=Booting');
+        return { success: true, state: result.state };
     }
     catch (error) {
         const message = error instanceof Error ? error.message : 'Failed to deploy repository';

package/dist/src/presentation/web/components/layouts/app-shell/app-shell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-shell.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/layouts/app-shell/app-shell.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAkC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAsBvE,UAAU,aAAa;IACrB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAiFD,wBAAgB,QAAQ,CAAC,EAAE,QAAQ,EAAE,EAAE,aAAa,2CAUnD"}
+{"version":3,"file":"app-shell.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/layouts/app-shell/app-shell.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAkC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAsBvE,UAAU,aAAa;IACrB,QAAQ,EAAE,SAAS,CAAC;CACrB;AA0FD,wBAAgB,QAAQ,CAAC,EAAE,QAAQ,EAAE,EAAE,aAAa,2CAUnD"}

package/dist/src/presentation/web/components/layouts/app-shell/app-shell.js

@@ -1,7 +1,7 @@
 'use client';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useCallback, useMemo, useState } from 'react';
-import { useRouter } from 'next/navigation';
+import { useRouter, usePathname } from 'next/navigation';
 import { Plus, FolderPlus } from 'lucide-react';
 import { SidebarProvider, SidebarInset } from '../../ui/sidebar.js';
 import { AppSidebar } from '../../layouts/app-sidebar/index.js';
@@ -14,9 +14,14 @@ import { DrawerCloseGuardProvider, useDrawerCloseGuard } from '../../../hooks/dr
 import { SidebarFeaturesProvider, useSidebarFeaturesContext, } from '../../../hooks/sidebar-features-context.js';
 import { useNotifications } from '../../../hooks/use-notifications.js';
 import { useFeatureFlags } from '../../../hooks/feature-flags-context.js';
-/** Inner shell that consumes the agent-events context for notifications. */
+/** Control center route prefixes where the FAB should be visible. */
+const CONTROL_CENTER_PREFIXES = ['/', '/create', '/feature', '/repository'];
+function isControlCenterRoute(pathname) {
+    return CONTROL_CENTER_PREFIXES.some((prefix) => pathname === prefix || (prefix !== '/' && pathname.startsWith(`${prefix}/`)));
+}
 function AppShellInner({ children }) {
     const router = useRouter();
+    const pathname = usePathname();
     const { guardedNavigate } = useDrawerCloseGuard();
     const featureFlags = useFeatureFlags();
     // Subscribe to agent lifecycle events and dispatch toast/browser notifications
@@ -58,7 +63,7 @@ function AppShellInner({ children }) {
             loading: addingRepo,
         },
     ], [handleNewFeature, handleAddRepository, addingRepo]);
-    return (_jsxs(SidebarProvider, { defaultOpen: false, children: [_jsx(AppSidebar, { features: features, featureFlags: featureFlags, onFeatureClick: handleFeatureClick }), _jsx(SidebarInset, { children: _jsxs("div", { className: "relative h-full", children: [_jsxs("div", { className: "absolute top-3 right-3 z-50 flex gap-1", "data-test-id": "canvas-actions-toolbar", children: [_jsx(SoundToggle, {}), _jsx(ThemeToggle, {})] }), _jsx("main", { className: "h-full", children: children }), _jsx(FloatingActionButton, { actions: fabActions })] }) })] }));
+    return (_jsxs(SidebarProvider, { defaultOpen: false, children: [_jsx(AppSidebar, { features: features, featureFlags: featureFlags, onFeatureClick: handleFeatureClick }), _jsx(SidebarInset, { children: _jsxs("div", { className: "relative h-full", children: [_jsxs("div", { className: "absolute top-3 right-3 z-50 flex gap-1", "data-test-id": "canvas-actions-toolbar", children: [_jsx(SoundToggle, {}), _jsx(ThemeToggle, {})] }), _jsx("main", { className: "h-full", children: children }), isControlCenterRoute(pathname) && _jsx(FloatingActionButton, { actions: fabActions })] }) })] }));
 }
 export function AppShell({ children }) {
     return (_jsx(AgentEventsProvider, { children: _jsx(DrawerCloseGuardProvider, { children: _jsx(SidebarFeaturesProvider, { children: _jsx(AppShellInner, { children: children }) }) }) }));