@shepai/cli 1.135.1 → 1.135.2-pr437.64c56e0

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/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 generation, 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 — generate 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,CA8BxB;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,68 @@
+/**
+ * Coasts Dev Server Startup & Shutdown
+ *
+ * Extracted from dev-server.ts for testability. Provides the Coasts startup
+ * sequence (prerequisite checks, Coastfile generation, 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 — generate 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 — generate if missing
+    const hasCoastfile = await coastsService.hasCoastfile(workDir);
+    if (!hasCoastfile) {
+        console.log('[dev-server:coasts] No Coastfile found. Generating via AI agent...');
+        const coastfilePath = await coastsService.generateCoastfile(workDir);
+        console.log(`[dev-server:coasts] Coastfile generated at ${coastfilePath}`);
+    }
+    // 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/control-center-drawer/feature-drawer-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-drawer-client.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/common/control-center-drawer/feature-drawer-client.tsx"],"names":[],"mappings":"AAuCA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAI/D,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,UAAU,CAAC;IACjB,8FAA8F;IAC9F,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,wBAAgB,mBAAmB,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,wBAAwB,2CAgmB1F"}
+{"version":3,"file":"feature-drawer-client.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/common/control-center-drawer/feature-drawer-client.tsx"],"names":[],"mappings":"AAuCA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAI/D,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,UAAU,CAAC;IACjB,8FAA8F;IAC9F,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,wBAAgB,mBAAmB,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,wBAAwB,2CAimB1F"}

package/dist/src/presentation/web/components/common/control-center-drawer/feature-drawer-client.js

@@ -169,8 +169,9 @@ export function FeatureDrawerClient({ view: initialView, urlTab }) {
         if (result.productDecisions)
             setTechProductData(result.productDecisions);
     }, () => setTechProductData(undefined), undefined, artifactRefreshKey);
-    const mergeFeatureId = featureNode?.lifecycle === 'review' &&
-        (featureNode?.state === 'action-required' || featureNode?.state === 'error')
+    const mergeFeatureId = (featureNode?.lifecycle === 'review' &&
+        (featureNode?.state === 'action-required' || featureNode?.state === 'error')) ||
+        (featureNode?.lifecycle === 'maintain' && featureNode?.pr)
         ? featureNode.featureId
         : null;
     const isLoadingMerge = useArtifactFetch(mergeFeatureId, getMergeReviewData, (result) => {

package/dist/src/presentation/web/components/features/settings/feature-flags-settings-section.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-flags-settings-section.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/settings/feature-flags-settings-section.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AA8BzE,MAAM,WAAW,gCAAgC;IAC/C,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,wBAAgB,2BAA2B,CAAC,EAAE,YAAY,EAAE,EAAE,gCAAgC,2CAgE7F"}
+{"version":3,"file":"feature-flags-settings-section.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/settings/feature-flags-settings-section.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAkCzE,MAAM,WAAW,gCAAgC;IAC/C,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,wBAAgB,2BAA2B,CAAC,EAAE,YAAY,EAAE,EAAE,gCAAgC,2CAgE7F"}

package/dist/src/presentation/web/components/features/settings/feature-flags-settings-section.js

@@ -14,6 +14,7 @@ const FLAG_DESCRIPTIONS = {
     githubImport: 'Enable GitHub repository import in the web UI',
     adoptBranch: 'Enable the ability to adopt existing branches as tracked features',
     reactFileManager: 'Use the built-in React file manager instead of the native OS folder picker. Also serves as automatic fallback when the native picker is unavailable.',
+    coastsDevServer: 'Enable Coasts containerized runtime isolation for the dev server, providing per-worktree isolation via Docker containers',
 };
 const FLAG_LABELS = {
     skills: 'Skills',
@@ -22,6 +23,7 @@ const FLAG_LABELS = {
     githubImport: 'GitHub Import',
     adoptBranch: 'Adopt Branch',
     reactFileManager: 'React File Manager',
+    coastsDevServer: 'Coasts Dev Server',
 };
 const FLAG_KEYS = [
     'skills',
@@ -30,6 +32,7 @@ const FLAG_KEYS = [
     'githubImport',
     'adoptBranch',
     'reactFileManager',
+    'coastsDevServer',
 ];
 export function FeatureFlagsSettingsSection({ featureFlags }) {
     const [flags, setFlags] = useState({ ...featureFlags });

package/dist/src/presentation/web/components/features/settings/feature-flags-settings-section.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-flags-settings-section.stories.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/settings/feature-flags-settings-section.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAE/E,QAAA,MAAM,IAAI;;;;;;;CAO0C,CAAC;AAErD,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAWrB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,KAWxB,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,KAWzB,CAAC"}
+{"version":3,"file":"feature-flags-settings-section.stories.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/settings/feature-flags-settings-section.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAE/E,QAAA,MAAM,IAAI;;;;;;;CAO0C,CAAC;AAErD,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAYrB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,KAYxB,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,KAYzB,CAAC"}

package/dist/src/presentation/web/components/features/settings/feature-flags-settings-section.stories.js

@@ -17,6 +17,7 @@ export const Default = {
             githubImport: false,
             adoptBranch: false,
             reactFileManager: false,
+            coastsDevServer: false,
         },
     },
 };
@@ -29,6 +30,7 @@ export const AllEnabled = {
             githubImport: true,
             adoptBranch: true,
             reactFileManager: true,
+            coastsDevServer: true,
         },
     },
 };
@@ -41,6 +43,7 @@ export const AllDisabled = {
             githubImport: false,
             adoptBranch: false,
             reactFileManager: false,
+            coastsDevServer: false,
         },
     },
 };

package/dist/src/presentation/web/components/features/settings/settings-page-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings-page-client.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/settings/settings-page-client.tsx"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EACV,QAAQ,EAGT,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AA2B/E,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC1C;AA6QD,wBAAgB,kBAAkB,CAAC,EACjC,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,kBAAkB,GACnB,EAAE,uBAAuB,2CAgpCzB"}
+{"version":3,"file":"settings-page-client.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/settings/settings-page-client.tsx"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EACV,QAAQ,EAGT,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AA2B/E,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC1C;AA6QD,wBAAgB,kBAAkB,CAAC,EACjC,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,kBAAkB,GACnB,EAAE,uBAAuB,2CA6pCzB"}

package/dist/src/presentation/web/components/features/settings/settings-page-client.js

@@ -122,6 +122,7 @@ export function SettingsPageClient({ settings, shepHome, dbFileSize, availableTe
         githubImport: false,
         adoptBranch: false,
         reactFileManager: false,
+        coastsDevServer: false,
     };
     // Agent state
     const [agentType, setAgentType] = useState(settings.agent.type);
@@ -501,6 +502,10 @@ export function SettingsPageClient({ settings, shepHome, dbFileSize, availableTe
                                             const newFlags = { ...flags, reactFileManager: v };
                                             setFlags(newFlags);
                                             save({ featureFlags: newFlags });
+                                        } }), _jsx(SwitchRow, { label: "Coasts Dev Server", description: "Enable Coasts containerized runtime isolation for the dev server", id: "flag-coastsDevServer", testId: "switch-flag-coastsDevServer", checked: flags.coastsDevServer, onChange: (v) => {
+                                            const newFlags = { ...flags, coastsDevServer: v };
+                                            setFlags(newFlags);
+                                            save({ featureFlags: newFlags });
                                         } })] }), _jsx(SectionHint, { children: "Experimental features that are still under development. Enable at your own risk \u2014 they may change or be removed in future versions. Debug mode adds verbose logging useful for troubleshooting." })] }), _jsxs("div", { id: "section-database", className: "grid scroll-mt-18 grid-cols-1 gap-x-5 rounded-lg lg:grid-cols-[1fr_280px]", children: [_jsxs(SettingsSection, { icon: Database, title: "Database", description: "Local storage information", testId: "database-settings-section", children: [_jsx(SettingsRow, { label: "Location", description: "Path to the local SQLite database", children: _jsx("span", { className: "text-muted-foreground max-w-50 truncate font-mono text-xs", "data-testid": "shep-home-path", children: shepHome }) }), _jsx(SettingsRow, { label: "Size", children: _jsx("span", { className: "text-muted-foreground text-xs", "data-testid": "db-file-size", children: dbFileSize }) })] }), _jsx(SectionHint, { links: [
                                     {
                                         label: 'Settings service',

package/dist/src/presentation/web/components/features/settings/settings-page-client.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings-page-client.stories.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/settings/settings-page-client.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAM5D,QAAA,MAAM,IAAI;;;;;;;CAOiC,CAAC;AAE5C,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAMrB,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,KAoBzB,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,KAa7B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,KAsB5B,CAAC"}
+{"version":3,"file":"settings-page-client.stories.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/settings/settings-page-client.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAM5D,QAAA,MAAM,IAAI;;;;;;;CAOiC,CAAC;AAE5C,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAMrB,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,KAqBzB,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,KAa7B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,KAsB5B,CAAC"}

package/dist/src/presentation/web/components/features/settings/settings-page-client.stories.js

@@ -33,6 +33,7 @@ export const AllSections = {
                 githubImport: false,
                 adoptBranch: false,
                 reactFileManager: false,
+                coastsDevServer: false,
             },
         },
         shepHome: '/opt/shep',

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

@@ -1 +1 @@
-{"version":3,"file":"app-sidebar.stories.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/layouts/app-sidebar/app-sidebar.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAe3C,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,UAAU,CAyBjC,CAAC;AAEF,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAmDnC,eAAO,MAAM,OAAO,EAAE,KAIrB,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,KAIlC,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,KAOvB,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,KAInB,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,KAiB3B,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,KAQrB,CAAC"}
+{"version":3,"file":"app-sidebar.stories.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/layouts/app-sidebar/app-sidebar.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAgB3C,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,UAAU,CAyBjC,CAAC;AAEF,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAmDnC,eAAO,MAAM,OAAO,EAAE,KAIrB,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,KAIlC,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,KAOvB,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,KAInB,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,KAiB3B,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,KAQrB,CAAC"}

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

@@ -8,6 +8,7 @@ const defaultFeatureFlags = {
     githubImport: false,
     adoptBranch: false,
     reactFileManager: false,
+    coastsDevServer: false,
 };
 const meta = {
     title: 'Layout/AppSidebar',

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

@@ -20,6 +20,8 @@ import { initializeSettings } from '../../../packages/core/src/infrastructure/se
 import { initializeNotificationWatcher, getNotificationWatcher, } from '../../../packages/core/src/infrastructure/services/notifications/notification-watcher.service.js';
 import { initializePrSyncWatcher, getPrSyncWatcher, } from '../../../packages/core/src/infrastructure/services/pr-sync/pr-sync-watcher.service.js';
 import { getExistingConnection } from '../../../packages/core/src/infrastructure/persistence/sqlite/connection.js';
+import { getFeatureFlags } from './lib/feature-flags.js';
+import { startCoastsDevServer, shutdownCoasts } from './coasts-dev-server.js';
 const DEFAULT_PORT = 3000;
 async function isPortAvailable(port) {
     return new Promise((resolve) => {
@@ -47,6 +49,9 @@ async function findAvailablePort(startPort) {
 async function main() {
     const basePort = process.env.PORT !== undefined ? parseInt(process.env.PORT, 10) : DEFAULT_PORT;
     const port = await findAvailablePort(basePort);
+    // Track Coasts mode state for shutdown handler
+    let coastsService = null;
+    let coastsWorkDir = null;
     // Step 1: Initialize DI container (database + migrations)
     // Same as CLI bootstrap (src/presentation/cli/index.ts:52-58)
     try {
@@ -72,7 +77,63 @@ async function main() {
     catch (error) {
         console.warn('[dev-server] DI initialization failed — features will be empty:', error);
     }
-    // Step 2: Clean up lock file to allow multiple dev instances
+    // Step 2: Check coastsDevServer feature flag — branch to Coasts mode or bare Next.js
+    const flags = getFeatureFlags();
+    if (flags.coastsDevServer) {
+        // --- Coasts mode: containerized runtime isolation ---
+        const workDir = process.cwd();
+        try {
+            const service = container.resolve('ICoastsService');
+            const instance = await startCoastsDevServer(service, workDir);
+            coastsService = service;
+            coastsWorkDir = workDir;
+            console.log(`[dev-server:coasts] Dev server running in Coasts mode at ${instance.url}`);
+        }
+        catch (error) {
+            console.error('[dev-server:coasts] Failed to start Coasts dev server:', error);
+            process.exit(1);
+        }
+        // Graceful shutdown for Coasts mode
+        let isShuttingDown = false;
+        const shutdown = async () => {
+            if (isShuttingDown)
+                return;
+            isShuttingDown = true;
+            console.log('\n[dev-server:coasts] Shutting down...');
+            const forceExit = setTimeout(() => process.exit(0), 2000);
+            try {
+                await shutdownCoasts(coastsService, coastsWorkDir);
+                try {
+                    const deploymentService = container.resolve('IDeploymentService');
+                    deploymentService.stopAll();
+                }
+                catch {
+                    /* not initialized */
+                }
+                try {
+                    getNotificationWatcher().stop();
+                }
+                catch {
+                    /* not initialized */
+                }
+                try {
+                    getPrSyncWatcher().stop();
+                }
+                catch {
+                    /* not initialized */
+                }
+            }
+            finally {
+                clearTimeout(forceExit);
+                process.exit(0);
+            }
+        };
+        process.on('SIGINT', shutdown);
+        process.on('SIGTERM', shutdown);
+        return;
+    }
+    // --- Bare mode: standard Next.js dev server (default, unchanged) ---
+    // Clean up lock file to allow multiple dev instances
     const lockPath = path.join(import.meta.dirname, '.next', 'dev', 'lock');
     try {
         fs.rmSync(lockPath, { force: true });

package/dist/src/presentation/web/hooks/feature-flags-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-flags-context.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/web/hooks/feature-flags-context.tsx"],"names":[],"mappings":"AAEA,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAa7D,UAAU,yBAAyB;IACjC,QAAQ,EAAE,SAAS,CAAC;IACpB,KAAK,EAAE,iBAAiB,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,yBAAyB,2CAElF;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,iBAAiB,CAEnD"}
+{"version":3,"file":"feature-flags-context.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/web/hooks/feature-flags-context.tsx"],"names":[],"mappings":"AAEA,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAc7D,UAAU,yBAAyB;IACjC,QAAQ,EAAE,SAAS,CAAC;IACpB,KAAK,EAAE,iBAAiB,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,yBAAyB,2CAElF;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,iBAAiB,CAEnD"}

package/dist/src/presentation/web/hooks/feature-flags-context.js

@@ -8,6 +8,7 @@ const defaultFlags = {
     githubImport: false,
     adoptBranch: false,
     reactFileManager: false,
+    coastsDevServer: false,
 };
 const FeatureFlagsContext = createContext(defaultFlags);
 /**

package/dist/src/presentation/web/lib/feature-flags.d.ts

@@ -12,6 +12,7 @@ export interface FeatureFlagsState {
     githubImport: boolean;
     adoptBranch: boolean;
     reactFileManager: boolean;
+    coastsDevServer: boolean;
 }
 export declare function getFeatureFlags(): FeatureFlagsState;
 /**
@@ -25,5 +26,6 @@ export declare const featureFlags: {
     readonly githubImport: boolean;
     readonly adoptBranch: boolean;
     readonly reactFileManager: boolean;
+    readonly coastsDevServer: boolean;
 };
 //# sourceMappingURL=feature-flags.d.ts.map

package/dist/src/presentation/web/lib/feature-flags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-flags.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/web/lib/feature-flags.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,eAAe,IAAI,iBAAiB,CA8BnD;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;CAmBf,CAAC"}
+{"version":3,"file":"feature-flags.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/web/lib/feature-flags.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,eAAe,IAAI,iBAAiB,CAgCnD;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;;CAsBf,CAAC"}

package/dist/src/presentation/web/lib/feature-flags.js

@@ -21,6 +21,7 @@ export function getFeatureFlags() {
                     githubImport: flags.githubImport,
                     adoptBranch: flags.adoptBranch,
                     reactFileManager: flags.reactFileManager,
+                    coastsDevServer: flags.coastsDevServer,
                 };
             }
         }
@@ -37,6 +38,7 @@ export function getFeatureFlags() {
         githubImport: false,
         adoptBranch: false,
         reactFileManager: isEnabled(process.env.NEXT_PUBLIC_FLAG_REACT_FILE_MANAGER),
+        coastsDevServer: isEnabled(process.env.NEXT_PUBLIC_FLAG_COASTS_DEV_SERVER),
     };
 }
 /**
@@ -62,4 +64,7 @@ export const featureFlags = {
     get reactFileManager() {
         return getFeatureFlags().reactFileManager;
     },
+    get coastsDevServer() {
+        return getFeatureFlags().coastsDevServer;
+    },
 };