@shepai/cli 1.135.3 → 1.136.0-pr437.9f802f1

package/dist/packages/core/src/infrastructure/services/coasts.service.js

@@ -0,0 +1,185 @@
+/**
+ * Coasts Service Implementation
+ *
+ * Infrastructure adapter wrapping the coast CLI binary for containerized
+ * runtime isolation. Uses constructor-injected ExecFunction for subprocess
+ * invocation and IStructuredAgentCaller for AI-powered Coastfile generation.
+ *
+ * Following Clean Architecture:
+ * - Implements the ICoastsService application port
+ * - Lives in the infrastructure layer
+ * - No direct child_process imports (injected via ExecFunction)
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { existsSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { injectable, inject } from 'tsyringe';
+import { IS_WINDOWS } from '../platform.js';
+/** Timeout for coast build (may need to pull Docker images). */
+const BUILD_TIMEOUT_MS = 30_000;
+/** Timeout for all other coast CLI commands. */
+const DEFAULT_TIMEOUT_MS = 10_000;
+/** JSON schema for Coastfile generation via structured agent caller. */
+const COASTFILE_SCHEMA = {
+    type: 'object',
+    properties: {
+        content: {
+            type: 'string',
+            description: 'The complete Coastfile content in TOML format',
+        },
+        warnings: {
+            type: 'array',
+            items: { type: 'string' },
+            description: 'Any warnings or notes about the generated Coastfile',
+        },
+    },
+    required: ['content'],
+    additionalProperties: false,
+};
+let CoastsService = class CoastsService {
+    execFile;
+    structuredCaller;
+    cachedInstallationPrompt = null;
+    isWindows;
+    constructor(execFile, structuredCaller, isWindows) {
+        this.execFile = execFile;
+        this.structuredCaller = structuredCaller;
+        this.isWindows = isWindows ?? IS_WINDOWS;
+    }
+    async checkPrerequisites(workDir) {
+        if (this.isWindows) {
+            return {
+                coastBinary: false,
+                docker: false,
+                coastdRunning: false,
+                allMet: false,
+                missingMessages: [
+                    'Coasts dev server is not supported on Windows. See https://coasts.dev/docs for platform support.',
+                ],
+            };
+        }
+        const [coastResult, dockerResult, coastdResult] = await Promise.allSettled([
+            this.checkCoastBinary(),
+            this.checkDocker(),
+            this.checkCoastdRunning(workDir),
+        ]);
+        const coastBinary = coastResult.status === 'fulfilled';
+        const docker = dockerResult.status === 'fulfilled';
+        const coastdRunning = coastdResult.status === 'fulfilled';
+        const missingMessages = [];
+        if (!coastBinary) {
+            missingMessages.push('coast binary not found on PATH. Install it with: curl -fsSL https://coasts.dev/install | sh. See https://coasts.dev/docs');
+        }
+        if (!docker) {
+            missingMessages.push('Docker daemon is not reachable. Start Docker Desktop or run: sudo systemctl start docker');
+        }
+        if (!coastdRunning) {
+            missingMessages.push('coastd daemon is not running. Start it with: coastd &. See https://coasts.dev/docs/daemon');
+        }
+        return {
+            coastBinary,
+            docker,
+            coastdRunning,
+            allMet: coastBinary && docker && coastdRunning,
+            missingMessages,
+        };
+    }
+    async build(workDir) {
+        await this.execCoast(['build'], workDir, BUILD_TIMEOUT_MS);
+    }
+    async run(workDir) {
+        const { stdout } = await this.execCoast(['run'], workDir);
+        return this.parseCoastInstance(stdout);
+    }
+    async stop(workDir) {
+        try {
+            await this.execCoast(['stop'], workDir);
+        }
+        catch {
+            // No-op if no instance is running
+        }
+    }
+    async lookup(workDir) {
+        try {
+            const { stdout } = await this.execCoast(['lookup'], workDir);
+            return this.parseCoastInstance(stdout);
+        }
+        catch {
+            return null;
+        }
+    }
+    async isRunning(workDir) {
+        const instance = await this.lookup(workDir);
+        return instance !== null;
+    }
+    async checkout(workDir) {
+        await this.execCoast(['checkout'], workDir);
+    }
+    async getInstallationPrompt() {
+        if (this.cachedInstallationPrompt !== null) {
+            return this.cachedInstallationPrompt;
+        }
+        const { stdout } = await this.execFile('coast', ['installation-prompt'], {
+            timeout: DEFAULT_TIMEOUT_MS,
+        });
+        this.cachedInstallationPrompt = stdout;
+        return stdout;
+    }
+    async generateCoastfile(workDir) {
+        const installationPrompt = await this.getInstallationPrompt();
+        const prompt = `${installationPrompt}\n\nAnalyze the project at the working directory and generate a Coastfile.\nReturn the complete Coastfile content as valid TOML in the "content" field.`;
+        const result = await this.structuredCaller.call(prompt, COASTFILE_SCHEMA, {
+            allowedTools: [],
+            silent: true,
+            maxTurns: 10,
+        });
+        const coastfilePath = path.join(workDir, 'Coastfile');
+        writeFileSync(coastfilePath, result.content, 'utf-8');
+        return coastfilePath;
+    }
+    async hasCoastfile(workDir) {
+        return existsSync(path.join(workDir, 'Coastfile'));
+    }
+    // --- Private helpers ---
+    async checkCoastBinary() {
+        await this.execFile('coast', ['--version'], { timeout: 500 });
+    }
+    async checkDocker() {
+        await this.execFile('docker', ['info'], { timeout: 500 });
+    }
+    async checkCoastdRunning(workDir) {
+        await this.execFile('coast', ['ls'], { cwd: workDir, timeout: 500 });
+    }
+    async execCoast(args, workDir, timeout = DEFAULT_TIMEOUT_MS) {
+        return this.execFile('coast', args, { cwd: workDir, timeout });
+    }
+    /**
+     * Parse coast CLI output to extract port and URL from stdout.
+     * Looks for patterns like "port 3000" and "http://localhost:3000".
+     */
+    parseCoastInstance(stdout) {
+        const portMatch = stdout.match(/port\s+(\d+)/i);
+        const urlMatch = stdout.match(/(https?:\/\/[^\s]+)/i);
+        const port = portMatch ? parseInt(portMatch[1], 10) : 3000;
+        const url = urlMatch ? urlMatch[1] : `http://localhost:${port}`;
+        return { port, url };
+    }
+};
+CoastsService = __decorate([
+    injectable(),
+    __param(0, inject('ExecFunction')),
+    __param(1, inject('IStructuredAgentCaller')),
+    __metadata("design:paramtypes", [Function, Object, Boolean])
+], CoastsService);
+export { CoastsService };

package/dist/src/presentation/cli/commands/coasts/index.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function createCoastsCommand(): Command;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/presentation/cli/commands/coasts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/coasts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,wBAAgB,mBAAmB,IAAI,OAAO,CAI7C"}

package/dist/src/presentation/cli/commands/coasts/index.js

@@ -0,0 +1,7 @@
+import { Command } from 'commander';
+import { createInitCommand } from './init.command.js';
+export function createCoastsCommand() {
+    return new Command('coasts')
+        .description('Manage Coasts containerized runtime')
+        .addCommand(createInitCommand());
+}

package/dist/src/presentation/cli/commands/coasts/init.command.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function createInitCommand(): Command;
+//# sourceMappingURL=init.command.d.ts.map

package/dist/src/presentation/cli/commands/coasts/init.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/coasts/init.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,wBAAgB,iBAAiB,IAAI,OAAO,CA0C3C"}

package/dist/src/presentation/cli/commands/coasts/init.command.js

@@ -0,0 +1,40 @@
+import { Command } from 'commander';
+import { container } from '../../../../../packages/core/src/infrastructure/di/container.js';
+import { messages, spinner } from '../../ui/index.js';
+export function createInitCommand() {
+    return new Command('init')
+        .description('Generate a Coastfile for the current repository')
+        .option('-f, --force', 'Overwrite existing Coastfile without prompting')
+        .action(async (options) => {
+        const workDir = process.cwd();
+        try {
+            const coastsService = container.resolve('ICoastsService');
+            // Check if Coastfile already exists
+            const exists = await coastsService.hasCoastfile(workDir);
+            if (exists && !options.force) {
+                messages.warning('Coastfile already exists. Use --force to regenerate.');
+                return;
+            }
+            // Check prerequisites
+            const prereqs = await coastsService.checkPrerequisites(workDir);
+            if (!prereqs.allMet) {
+                for (const msg of prereqs.missingMessages) {
+                    messages.error(msg);
+                }
+                process.exitCode = 1;
+                return;
+            }
+            // Generate Coastfile
+            const coastfilePath = await spinner('Generating Coastfile via AI agent...', () => coastsService.generateCoastfile(workDir));
+            messages.success(`Coastfile generated at ${coastfilePath}`);
+            // Build container
+            await spinner('Building coast container...', () => coastsService.build(workDir));
+            messages.success('Coast container built successfully.');
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            messages.error('Failed to initialize Coasts', err);
+            process.exitCode = 1;
+        }
+    });
+}

package/dist/src/presentation/cli/index.js

@@ -42,6 +42,7 @@ import { createIdeOpenCommand } from './commands/ide-open.command.js';
 import { createInstallCommand } from './commands/install.command.js';
 import { createUpgradeCommand } from './commands/upgrade.command.js';
 import { createToolsCommand } from './commands/tools.command.js';
+import { createCoastsCommand } from './commands/coasts/index.js';
 import { messages } from './ui/index.js';
 // Daemon lifecycle commands
 import { createStartCommand } from './commands/start.command.js';
@@ -110,6 +111,7 @@ async function bootstrap() {
         program.addCommand(createInstallCommand());
         program.addCommand(createToolsCommand());
         program.addCommand(createUpgradeCommand());
+        program.addCommand(createCoastsCommand());
         // Daemon lifecycle commands (task-9)
         program.addCommand(createStartCommand());
         program.addCommand(createStopCommand());

package/dist/src/presentation/web/app/actions/check-agent-auth.d.ts

@@ -8,6 +8,8 @@ export interface AgentAuthStatus {
     label: string;
     /** CLI binary name (e.g. "claude", "gemini") */
     binaryName: string | null;
+    /** Shell command to install the tool (e.g. "npm install -g @anthropic-ai/claude-code") */
+    installCommand: string | null;
     /** Instructions to authenticate if not authenticated */
     authCommand: string | null;
 }

package/dist/src/presentation/web/app/actions/check-agent-auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"check-agent-auth.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/app/actions/check-agent-auth.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,SAAS,EAAE,OAAO,CAAC;IACnB,8CAA8C;IAC9C,aAAa,EAAE,OAAO,CAAC;IACvB,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,wDAAwD;IACxD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AA6FD;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,eAAe,CAAC,CAiF/D"}
+{"version":3,"file":"check-agent-auth.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/app/actions/check-agent-auth.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,SAAS,EAAE,OAAO,CAAC;IACnB,8CAA8C;IAC9C,aAAa,EAAE,OAAO,CAAC;IACvB,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,0FAA0F;IAC1F,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,wDAAwD;IACxD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AA6FD;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,eAAe,CAAC,CAwF/D"}

package/dist/src/presentation/web/app/actions/check-agent-auth.js

@@ -114,6 +114,7 @@ export async function checkAgentAuth() {
             authenticated: false,
             label: 'Unknown',
             binaryName: null,
+            installCommand: null,
             authCommand: null,
         };
     }
@@ -128,16 +129,19 @@ export async function checkAgentAuth() {
             authenticated: true,
             label,
             binaryName: null,
+            installCommand: null,
             authCommand: null,
         };
     }
-    // Check if tool is installed
+    // Check if tool is installed (also grab install command from metadata)
     let installed = false;
+    let installCommand = null;
     try {
         const useCase = resolve('ListToolsUseCase');
         const tools = await useCase.execute();
         const tool = tools.find((t) => t.id === toolId);
         installed = tool?.status.status === 'available';
+        installCommand = tool?.installCommand ?? null;
     }
     catch {
         installed = false;
@@ -149,6 +153,7 @@ export async function checkAgentAuth() {
             authenticated: false,
             label,
             binaryName,
+            installCommand,
             authCommand: binaryName ? `Install ${label} first` : null,
         };
     }
@@ -161,6 +166,7 @@ export async function checkAgentAuth() {
             authenticated: false,
             label,
             binaryName,
+            installCommand,
             authCommand: binaryName,
         };
     }
@@ -175,6 +181,7 @@ export async function checkAgentAuth() {
         authenticated,
         label,
         binaryName,
+        installCommand,
         authCommand: authenticated ? null : binaryName,
     };
 }

package/dist/src/presentation/web/app/actions/check-coastfile.d.ts

@@ -0,0 +1,5 @@
+export interface CheckCoastfileResult {
+    exists: boolean;
+}
+export declare function checkCoastfileAction(repositoryPath: string): Promise<CheckCoastfileResult>;
+//# sourceMappingURL=check-coastfile.d.ts.map

package/dist/src/presentation/web/app/actions/check-coastfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-coastfile.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/app/actions/check-coastfile.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAYhG"}

package/dist/src/presentation/web/app/actions/check-coastfile.js

@@ -0,0 +1,16 @@
+'use server';
+import path from 'node:path';
+import { resolve } from '../../lib/server-container.js';
+export async function checkCoastfileAction(repositoryPath) {
+    if (!repositoryPath || !path.isAbsolute(repositoryPath)) {
+        return { exists: false };
+    }
+    try {
+        const coastsService = resolve('ICoastsService');
+        const exists = await coastsService.hasCoastfile(repositoryPath);
+        return { exists };
+    }
+    catch {
+        return { exists: false };
+    }
+}

package/dist/src/presentation/web/app/actions/check-tool-status.d.ts

@@ -0,0 +1,14 @@
+export interface ToolStatusEntry {
+    installed: boolean;
+    version: string | null;
+    /** Platform-specific install command from tool JSON metadata */
+    installCommand: string | null;
+    /** Documentation/website URL */
+    installUrl: string | null;
+}
+export interface ToolStatusResult {
+    git: ToolStatusEntry;
+    gh: ToolStatusEntry;
+}
+export declare function checkToolStatus(): Promise<ToolStatusResult>;
+//# sourceMappingURL=check-tool-status.d.ts.map

package/dist/src/presentation/web/app/actions/check-tool-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-tool-status.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/app/actions/check-tool-status.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,gEAAgE;IAChE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,gCAAgC;IAChC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,eAAe,CAAC;IACrB,EAAE,EAAE,eAAe,CAAC;CACrB;AAwBD,wBAAsB,eAAe,IAAI,OAAO,CAAC,gBAAgB,CAAC,CA8BjE"}

package/dist/src/presentation/web/app/actions/check-tool-status.js

@@ -0,0 +1,53 @@
+'use server';
+import { execFile } from 'node:child_process';
+import { IS_WINDOWS } from '../../../../../packages/core/src/infrastructure/platform.js';
+import { resolve } from '../../lib/server-container.js';
+function getVersion(command, args) {
+    return new Promise((resolve) => {
+        try {
+            const opts = IS_WINDOWS ? { timeout: 5000, windowsHide: true } : { timeout: 5000 };
+            execFile(command, args, opts, (error, stdout) => {
+                if (error) {
+                    resolve({ installed: false, version: null });
+                    return;
+                }
+                // Extract version number from output like "git version 2.43.0" or "gh version 2.40.1"
+                const match = stdout.match(/(\d+\.\d+(?:\.\d+)?)/);
+                resolve({ installed: true, version: match?.[1] ?? null });
+            });
+        }
+        catch {
+            resolve({ installed: false, version: null });
+        }
+    });
+}
+export async function checkToolStatus() {
+    // Run version checks and tool metadata lookup in parallel
+    const [gitVersion, ghVersion, tools] = await Promise.all([
+        getVersion('git', ['--version']),
+        getVersion('gh', ['--version']),
+        (async () => {
+            try {
+                const useCase = resolve('ListToolsUseCase');
+                return await useCase.execute();
+            }
+            catch {
+                return [];
+            }
+        })(),
+    ]);
+    const gitTool = tools.find((t) => t.id === 'git');
+    const ghTool = tools.find((t) => t.id === 'gh');
+    return {
+        git: {
+            ...gitVersion,
+            installCommand: gitTool?.installCommand ?? null,
+            installUrl: gitTool?.website ?? 'https://git-scm.com',
+        },
+        gh: {
+            ...ghVersion,
+            installCommand: ghTool?.installCommand ?? null,
+            installUrl: ghTool?.website ?? 'https://cli.github.com',
+        },
+    };
+}

package/dist/src/presentation/web/app/actions/generate-coastfile.d.ts

@@ -0,0 +1,7 @@
+export interface GenerateCoastfileResult {
+    success: boolean;
+    coastfilePath?: string;
+    error?: string;
+}
+export declare function generateCoastfileAction(repositoryPath: string): Promise<GenerateCoastfileResult>;
+//# sourceMappingURL=generate-coastfile.d.ts.map

package/dist/src/presentation/web/app/actions/generate-coastfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-coastfile.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/app/actions/generate-coastfile.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,uBAAuB,CAC3C,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,uBAAuB,CAAC,CAkBlC"}

package/dist/src/presentation/web/app/actions/generate-coastfile.js

@@ -0,0 +1,22 @@
+'use server';
+import path from 'node:path';
+import { existsSync } from 'node:fs';
+import { resolve } from '../../lib/server-container.js';
+export async function generateCoastfileAction(repositoryPath) {
+    if (!repositoryPath || !path.isAbsolute(repositoryPath)) {
+        return { success: false, error: 'repositoryPath must be an absolute path' };
+    }
+    if (!existsSync(repositoryPath)) {
+        return { success: false, error: `Directory does not exist: ${repositoryPath}` };
+    }
+    try {
+        const coastsService = resolve('ICoastsService');
+        const coastfilePath = await coastsService.generateCoastfile(repositoryPath);
+        await coastsService.build(repositoryPath);
+        return { success: true, coastfilePath };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Failed to generate Coastfile';
+        return { success: false, error: message };
+    }
+}

package/dist/src/presentation/web/app/build-graph-nodes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-graph-nodes.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/web/app/build-graph-nodes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AAS1F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAU1C,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC,uEAAuE;IACvE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,6EAA6E;IAC7E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,qEAAqE;IACrE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,0FAA0F;IAC1F,WAAW,CAAC,EAAE,GAAG,CACf,MAAM,EACN;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CACzF,CAAC;IACF,0DAA0D;IAC1D,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,YAAY,CAAC,CAAC;CACjE;AAED,wBAAgB,eAAe,CAC7B,YAAY,EAAE,UAAU,EAAE,EAC1B,gBAAgB,EAAE,cAAc,EAAE,EAClC,OAAO,CAAC,EAAE,sBAAsB,GAC/B;IAAE,KAAK,EAAE,cAAc,EAAE,CAAC;IAAC,KAAK,EAAE,IAAI,EAAE,CAAA;CAAE,CAoG5C"}
+{"version":3,"file":"build-graph-nodes.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/web/app/build-graph-nodes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AAS1F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAG1C,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC,uEAAuE;IACvE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,6EAA6E;IAC7E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,qEAAqE;IACrE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,0FAA0F;IAC1F,WAAW,CAAC,EAAE,GAAG,CACf,MAAM,EACN;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CACzF,CAAC;IACF,0DAA0D;IAC1D,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,YAAY,CAAC,CAAC;CACjE;AAED,wBAAgB,eAAe,CAC7B,YAAY,EAAE,UAAU,EAAE,EAC1B,gBAAgB,EAAE,cAAc,EAAE,EAClC,OAAO,CAAC,EAAE,sBAAsB,GAC/B;IAAE,KAAK,EAAE,cAAc,EAAE,CAAC;IAAC,KAAK,EAAE,IAAI,EAAE,CAAA;CAAE,CAoG5C"}

package/dist/src/presentation/web/app/build-graph-nodes.js

@@ -1,15 +1,7 @@
-import { createHash } from 'node:crypto';
-import path from 'node:path';
 import { AgentRunStatus } from '../../../../packages/core/src/domain/generated/output.js';
 import { deriveNodeState, deriveProgress, deriveLifecycle, } from '../components/common/feature-node/derive-feature-state.js';
 import { isProcessAlive } from '../../../../packages/core/src/infrastructure/services/process/is-process-alive.js';
-import { getShepHomeDir } from '../../../../packages/core/src/infrastructure/services/filesystem/shep-directory.service.js';
-/** Compute the worktree path for a feature, matching WorktreeService.getWorktreePath() */
-function computeWorktreePath(repoPath, branch) {
-    const repoHash = createHash('sha256').update(repoPath).digest('hex').slice(0, 16);
-    const slug = branch.replace(/\//g, '-');
-    return path.join(getShepHomeDir(), 'repos', repoHash, 'wt', slug).replace(/\\/g, '/');
-}
+import { computeWorktreePath } from '../../../../packages/core/src/infrastructure/services/ide-launchers/compute-worktree-path.js';
 export function buildGraphNodes(repositories, featuresWithRuns, options) {
     // Normalize path separators so Windows backslash paths match forward-slash paths
     const normalizePath = (p) => p.replace(/\\/g, '/');

package/dist/src/presentation/web/coasts-dev-server.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Coasts Dev Server Startup & Shutdown
+ *
+ * Extracted from dev-server.ts for testability. Provides the Coasts startup
+ * sequence (prerequisite checks, Coastfile existence check, build, run) and
+ * graceful shutdown logic.
+ *
+ * All log messages use [dev-server:coasts] prefix per NFR-10.
+ */
+import type { ICoastsService, CoastInstance } from '../../../packages/core/src/application/ports/output/services/coasts-service.interface.js';
+/**
+ * Start the dev server in Coasts mode.
+ *
+ * Sequence:
+ * 1. Check prerequisites (coast binary, Docker, coastd daemon)
+ * 2. Check for Coastfile — fail if missing
+ * 3. Build the coast container image
+ * 4. Run the coast instance
+ *
+ * @param coastsService - Resolved ICoastsService from the DI container
+ * @param workDir - Working directory (repo/worktree root)
+ * @returns The running CoastInstance with port and URL
+ * @throws Error if prerequisites are not met or any step fails
+ */
+export declare function startCoastsDevServer(coastsService: ICoastsService, workDir: string): Promise<CoastInstance>;
+/**
+ * Gracefully shut down the Coasts instance.
+ * Catches and logs errors to prevent shutdown failures.
+ *
+ * @param coastsService - The ICoastsService instance, or null if not in Coasts mode
+ * @param workDir - Working directory for the coast instance
+ */
+export declare function shutdownCoasts(coastsService: ICoastsService | null, workDir: string): Promise<void>;
+//# sourceMappingURL=coasts-dev-server.d.ts.map

package/dist/src/presentation/web/coasts-dev-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coasts-dev-server.d.ts","sourceRoot":"","sources":["../../../../src/presentation/web/coasts-dev-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACd,MAAM,yEAAyE,CAAC;AAEjF;;;;;;;;;;;;;GAaG;AACH,wBAAsB,oBAAoB,CACxC,aAAa,EAAE,cAAc,EAC7B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,aAAa,CAAC,CAiCxB;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,aAAa,EAAE,cAAc,GAAG,IAAI,EACpC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/src/presentation/web/coasts-dev-server.js

@@ -0,0 +1,69 @@
+/**
+ * Coasts Dev Server Startup & Shutdown
+ *
+ * Extracted from dev-server.ts for testability. Provides the Coasts startup
+ * sequence (prerequisite checks, Coastfile existence check, build, run) and
+ * graceful shutdown logic.
+ *
+ * All log messages use [dev-server:coasts] prefix per NFR-10.
+ */
+/**
+ * Start the dev server in Coasts mode.
+ *
+ * Sequence:
+ * 1. Check prerequisites (coast binary, Docker, coastd daemon)
+ * 2. Check for Coastfile — fail if missing
+ * 3. Build the coast container image
+ * 4. Run the coast instance
+ *
+ * @param coastsService - Resolved ICoastsService from the DI container
+ * @param workDir - Working directory (repo/worktree root)
+ * @returns The running CoastInstance with port and URL
+ * @throws Error if prerequisites are not met or any step fails
+ */
+export async function startCoastsDevServer(coastsService, workDir) {
+    // Step 1: Check prerequisites
+    console.log('[dev-server:coasts] Checking prerequisites...');
+    const prereqs = await coastsService.checkPrerequisites(workDir);
+    if (!prereqs.allMet) {
+        const messages = prereqs.missingMessages.map((m) => `  - ${m}`).join('\n');
+        throw new Error(`[dev-server:coasts] Prerequisites not met:\n${messages}`);
+    }
+    console.log('[dev-server:coasts] All prerequisites met.');
+    // Step 2: Check for Coastfile — fail if missing (generate on-demand via CLI or web UI)
+    const hasCoastfile = await coastsService.hasCoastfile(workDir);
+    if (!hasCoastfile) {
+        throw new Error(`[dev-server:coasts] No Coastfile found in ${workDir} (expected: Coastfile).\n` +
+            'Generate one with:\n' +
+            '  - CLI:    shep coasts init\n' +
+            '  - Web UI: Use the "Generate Coastfile" button on the repository node');
+    }
+    // Step 3: Build the coast container image
+    console.log('[dev-server:coasts] Building coast container...');
+    await coastsService.build(workDir);
+    console.log('[dev-server:coasts] Build complete.');
+    // Step 4: Run the coast instance
+    console.log('[dev-server:coasts] Starting coast instance...');
+    const instance = await coastsService.run(workDir);
+    console.log(`[dev-server:coasts] Ready at ${instance.url}`);
+    return instance;
+}
+/**
+ * Gracefully shut down the Coasts instance.
+ * Catches and logs errors to prevent shutdown failures.
+ *
+ * @param coastsService - The ICoastsService instance, or null if not in Coasts mode
+ * @param workDir - Working directory for the coast instance
+ */
+export async function shutdownCoasts(coastsService, workDir) {
+    if (!coastsService)
+        return;
+    try {
+        console.log('[dev-server:coasts] Stopping coast instance...');
+        await coastsService.stop(workDir);
+        console.log('[dev-server:coasts] Coast instance stopped.');
+    }
+    catch (error) {
+        console.warn('[dev-server:coasts] Failed to stop coast instance:', error);
+    }
+}

package/dist/src/presentation/web/components/common/feature-node/feature-node-state-config.d.ts

@@ -6,6 +6,23 @@ export type FeatureNodeState = 'creating' | 'running' | 'action-required' | 'don
 export type FeatureLifecyclePhase = 'pending' | 'requirements' | 'research' | 'implementation' | 'review' | 'deploy' | 'maintain';
 /** Human-readable display labels for lifecycle phases. */
 export declare const lifecycleDisplayLabels: Record<FeatureLifecyclePhase, string>;
+/** Left border color for each lifecycle phase. */
+export declare const lifecycleBorderColors: Record<FeatureLifecyclePhase, string>;
+/** Accent bar background color for each lifecycle phase. */
+export declare const lifecycleAccentColors: Record<FeatureLifecyclePhase, string>;
+/** Phase badge: short letter, color classes, and user-friendly tooltip. */
+export declare const lifecyclePhaseBadge: Record<FeatureLifecyclePhase, {
+    letter: string;
+    bg: string;
+    text: string;
+    dot: string;
+    tooltip: string;
+    description: string;
+}>;
+/** State-based left border overrides (takes precedence over lifecycle). */
+export declare const stateBorderColors: Partial<Record<FeatureNodeState, string>>;
+/** State-based accent bar overrides (takes precedence over lifecycle). */
+export declare const stateAccentColors: Partial<Record<FeatureNodeState, string>>;
 /** Present-participle verbs for the running badge, keyed by lifecycle phase. */
 export declare const lifecycleRunningVerbs: Record<FeatureLifecyclePhase, string>;
 export interface FeatureNodeData {