@shepai/cli 1.179.1 → 1.180.0

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

@@ -0,0 +1,22 @@
+/**
+ * PTY Terminal Session Service
+ *
+ * `node-pty`-backed implementation of `ITerminalSessionService`. Spawns a
+ * real pseudo-terminal so interactive tools (vim, top, git, pnpm, etc.)
+ * work exactly as they would in a native terminal. Cross-platform via
+ * ConPTY on Windows and forkpty on Unix.
+ */
+import type { CreatedTerminalSession, CreateTerminalSessionInput, ITerminalSessionService, TerminalExitListener, TerminalOutputListener } from '../../../application/ports/output/services/terminal-session-service.interface.js';
+export declare class PtyTerminalSessionService implements ITerminalSessionService {
+    private readonly sessions;
+    private ptyModule;
+    private loadPty;
+    private resolveShell;
+    create(input: CreateTerminalSessionInput): CreatedTerminalSession;
+    write(sessionId: string, data: string): void;
+    resize(sessionId: string, cols: number, rows: number): void;
+    subscribe(sessionId: string, onData: TerminalOutputListener, onExit?: TerminalExitListener): () => void;
+    exists(sessionId: string): boolean;
+    close(sessionId: string): void;
+}
+//# sourceMappingURL=pty-terminal-session.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pty-terminal-session.service.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/terminal/pty-terminal-session.service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EACV,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,kFAAkF,CAAC;AA2B1F,qBACa,yBAA0B,YAAW,uBAAuB;IACvE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAC5D,OAAO,CAAC,SAAS,CAA0B;IAE3C,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,YAAY;IASpB,MAAM,CAAC,KAAK,EAAE,0BAA0B,GAAG,sBAAsB;IAsEjE,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAM5C,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAY3D,SAAS,CACP,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,sBAAsB,EAC9B,MAAM,CAAC,EAAE,oBAAoB,GAC5B,MAAM,IAAI;IAsCb,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIlC,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAU/B"}

package/dist/packages/core/src/infrastructure/services/terminal/pty-terminal-session.service.js

@@ -0,0 +1,182 @@
+/**
+ * PTY Terminal Session Service
+ *
+ * `node-pty`-backed implementation of `ITerminalSessionService`. Spawns a
+ * real pseudo-terminal so interactive tools (vim, top, git, pnpm, etc.)
+ * work exactly as they would in a native terminal. Cross-platform via
+ * ConPTY on Windows and forkpty on Unix.
+ */
+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;
+};
+import { injectable } from 'tsyringe';
+import { randomUUID } from 'node:crypto';
+import { createRequire } from 'node:module';
+import { IS_WINDOWS } from '../../platform.js';
+const MAX_SCROLLBACK_BYTES = 256 * 1024; // 256 KB per session
+const requireCjs = createRequire(import.meta.url);
+let PtyTerminalSessionService = class PtyTerminalSessionService {
+    sessions = new Map();
+    ptyModule = null;
+    loadPty() {
+        if (this.ptyModule)
+            return this.ptyModule;
+        // Dynamic CJS require so the native module is only loaded on demand.
+        const mod = requireCjs('node-pty');
+        this.ptyModule = mod;
+        return mod;
+    }
+    resolveShell() {
+        if (IS_WINDOWS) {
+            const shell = process.env.COMSPEC ?? 'powershell.exe';
+            return { shell, args: [] };
+        }
+        const shell = process.env.SHELL ?? '/bin/bash';
+        return { shell, args: [] };
+    }
+    create(input) {
+        const pty = this.loadPty();
+        const { shell, args } = this.resolveShell();
+        const cols = input.cols && input.cols > 0 ? input.cols : 80;
+        const rows = input.rows && input.rows > 0 ? input.rows : 24;
+        const proc = pty.spawn(shell, args, {
+            name: 'xterm-256color',
+            cols,
+            rows,
+            cwd: input.cwd,
+            env: {
+                ...process.env,
+                TERM: 'xterm-256color',
+                COLORTERM: 'truecolor',
+                FORCE_COLOR: '1',
+            },
+        });
+        const id = randomUUID();
+        const entry = {
+            id,
+            pty: proc,
+            shell,
+            cwd: input.cwd,
+            scrollback: [],
+            scrollbackBytes: 0,
+            dataListeners: new Set(),
+            exitListeners: new Set(),
+            exited: false,
+            exitCode: null,
+        };
+        this.sessions.set(id, entry);
+        proc.onData((chunk) => {
+            // Maintain bounded scrollback so reconnecting clients see recent state.
+            entry.scrollback.push(chunk);
+            entry.scrollbackBytes += chunk.length;
+            while (entry.scrollbackBytes > MAX_SCROLLBACK_BYTES && entry.scrollback.length > 0) {
+                const dropped = entry.scrollback.shift();
+                if (dropped)
+                    entry.scrollbackBytes -= dropped.length;
+            }
+            for (const listener of entry.dataListeners) {
+                try {
+                    listener(chunk);
+                }
+                catch {
+                    // Ignore listener errors so one bad subscriber can't poison others.
+                }
+            }
+        });
+        proc.onExit(({ exitCode }) => {
+            entry.exited = true;
+            entry.exitCode = exitCode;
+            for (const listener of entry.exitListeners) {
+                try {
+                    listener(exitCode);
+                }
+                catch {
+                    // ignore
+                }
+            }
+            // Keep entry briefly so late SSE unsubscribes still work, then drop.
+            setTimeout(() => {
+                this.sessions.delete(id);
+            }, 5_000);
+        });
+        return { id, shell, cwd: input.cwd };
+    }
+    write(sessionId, data) {
+        const entry = this.sessions.get(sessionId);
+        if (!entry || entry.exited)
+            return;
+        entry.pty.write(data);
+    }
+    resize(sessionId, cols, rows) {
+        const entry = this.sessions.get(sessionId);
+        if (!entry || entry.exited)
+            return;
+        if (cols > 0 && rows > 0) {
+            try {
+                entry.pty.resize(cols, rows);
+            }
+            catch {
+                // resize can throw if the child already exited — swallow
+            }
+        }
+    }
+    subscribe(sessionId, onData, onExit) {
+        const entry = this.sessions.get(sessionId);
+        if (!entry) {
+            return () => {
+                /* no-op for missing session */
+            };
+        }
+        // Prime new subscriber with scrollback so reconnects see history.
+        if (entry.scrollback.length > 0) {
+            try {
+                onData(entry.scrollback.join(''));
+            }
+            catch {
+                // ignore
+            }
+        }
+        entry.dataListeners.add(onData);
+        if (onExit)
+            entry.exitListeners.add(onExit);
+        // If the session already exited, fire exit listener on next tick.
+        if (entry.exited && onExit) {
+            const code = entry.exitCode;
+            setImmediate(() => {
+                try {
+                    onExit(code);
+                }
+                catch {
+                    // ignore
+                }
+            });
+        }
+        return () => {
+            entry.dataListeners.delete(onData);
+            if (onExit)
+                entry.exitListeners.delete(onExit);
+        };
+    }
+    exists(sessionId) {
+        return this.sessions.has(sessionId);
+    }
+    close(sessionId) {
+        const entry = this.sessions.get(sessionId);
+        if (!entry)
+            return;
+        try {
+            entry.pty.kill();
+        }
+        catch {
+            // ignore
+        }
+        this.sessions.delete(sessionId);
+    }
+};
+PtyTerminalSessionService = __decorate([
+    injectable()
+], PtyTerminalSessionService);
+export { PtyTerminalSessionService };

package/dist/src/presentation/web/app/(dashboard)/get-graph-data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-graph-data.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/app/(dashboard)/get-graph-data.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6EAA6E,CAAC;AAOzH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAI1C,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAiFD,MAAM,MAAM,aAAa,GACrB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,WAAW,CAAA;CAAE,GACtC;IAAE,MAAM,EAAE,YAAY,CAAA;CAAE,CAAC;AA6B7B,wBAAsB,YAAY,IAAI,OAAO,CAAC;IAC5C,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,WAAW,EAAE,qBAAqB,EAAE,CAAC;CACtC,CAAC,CAqED"}
+{"version":3,"file":"get-graph-data.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/app/(dashboard)/get-graph-data.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6EAA6E,CAAC;AAOzH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAI1C,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAiFD,MAAM,MAAM,aAAa,GACrB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,WAAW,CAAA;CAAE,GACtC;IAAE,MAAM,EAAE,YAAY,CAAA;CAAE,CAAC;AA6B7B,wBAAsB,YAAY,IAAI,OAAO,CAAC;IAC5C,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,WAAW,EAAE,qBAAqB,EAAE,CAAC;CACtC,CAAC,CA+ED"}

package/dist/src/presentation/web/app/(dashboard)/get-graph-data.js

@@ -102,11 +102,20 @@ export async function getGraphData() {
     const listFeatures = resolve('ListFeaturesUseCase');
     const listRepos = resolve('ListRepositoriesUseCase');
     const agentRunRepo = resolve('IAgentRunRepository');
+    // Resolve ListApplicationsUseCase — may not be registered in older environments
+    let listApplications = null;
+    try {
+        listApplications = resolve('ListApplicationsUseCase');
+    }
+    catch {
+        // Use case not registered — skip application nodes
+    }
     // Always include archived features so the client has full data for instant
     // show/hide toggle without a server round-trip (NFR-3).
-    const [features, repositories] = await Promise.all([
+    const [features, repositories, applications] = await Promise.all([
         listFeatures.execute({ includeArchived: true }),
         listRepos.execute(),
+        listApplications ? listApplications.execute() : Promise.resolve([]),
     ]);
     // Read git info from cache (zero git calls). Stale entries trigger
     // a fire-and-forget background refresh for the next poll cycle.
@@ -142,6 +151,7 @@ export async function getGraphData() {
         ciWatchEnabled: workflow.ciWatchEnabled,
         repoGitInfo: repoGitInfoMap,
         repoGitStatus: repoGitStatusMap,
+        applications,
     });
     // Load all live deployments via the use case. The client-side
     // DeploymentStatusProvider hydrates from this list so node/drawer state

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

@@ -0,0 +1,7 @@
+export type AgentInstallMap = Record<string, boolean>;
+/**
+ * Returns a map of agentType → installed (boolean) for all known agents.
+ * Agents without a tool mapping (e.g. "dev") are considered installed.
+ */
+export declare function checkAllAgentsStatus(): Promise<AgentInstallMap>;
+//# sourceMappingURL=check-all-agents-status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"check-all-agents-status.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/app/actions/check-all-agents-status.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEtD;;;GAGG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,eAAe,CAAC,CAiBrE"}

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

@@ -0,0 +1,30 @@
+'use server';
+import { resolve } from '../../lib/server-container.js';
+const AGENT_TOOL_MAP = {
+    'claude-code': 'claude-code',
+    cursor: 'cursor-cli',
+    'gemini-cli': 'gemini-cli',
+    'copilot-cli': 'copilot-cli',
+    'codex-cli': 'codex-cli',
+};
+/**
+ * Returns a map of agentType → installed (boolean) for all known agents.
+ * Agents without a tool mapping (e.g. "dev") are considered installed.
+ */
+export async function checkAllAgentsStatus() {
+    try {
+        const useCase = resolve('ListToolsUseCase');
+        const tools = await useCase.execute();
+        const result = {};
+        for (const [agentType, toolId] of Object.entries(AGENT_TOOL_MAP)) {
+            const tool = tools.find((t) => t.id === toolId);
+            result[agentType] = tool?.status.status === 'available';
+        }
+        // Dev/demo agents are always "installed"
+        result['dev'] = true;
+        return result;
+    }
+    catch {
+        return {};
+    }
+}

package/dist/src/presentation/web/app/actions/create-application.d.ts

@@ -0,0 +1,33 @@
+import type { Application } from '../../../../../packages/core/src/domain/generated/output.js';
+interface CreateApplicationInput {
+    description: string;
+    agentType?: string;
+    modelOverride?: string;
+    /**
+     * When provided, the use case ALSO sends this as the first message of
+     * the application's interactive chat session — wrapped server-side
+     * with the full application-creation prompt (Shep persona, mission,
+     * opinionated stack, workflow, quality bar, definition of done) by
+     * the IApplicationCreationPromptBuilder adapter.
+     *
+     * Awaiting this BEFORE the client navigates guarantees that the chat
+     * page's SSR load of chat state already includes the message — it
+     * renders on first paint, no extra round trip.
+     */
+    initialPrompt?: string;
+}
+/**
+ * Thin server-action wrapper around CreateApplicationUseCase.
+ *
+ * All orchestration (slug allocation, project scaffold, app persistence,
+ * prompt building, first-message dispatch) lives inside the use case so
+ * every presentation layer (Web / CLI / TUI) gets identical behavior
+ * from a single call.
+ */
+export declare function createApplication(input: CreateApplicationInput): Promise<{
+    application?: Application;
+    repositoryPath?: string;
+    error?: string;
+}>;
+export {};
+//# sourceMappingURL=create-application.d.ts.map

package/dist/src/presentation/web/app/actions/create-application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-application.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/app/actions/create-application.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAExE,UAAU,sBAAsB;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;;;;OAUG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC;IAAE,WAAW,CAAC,EAAE,WAAW,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAkBjF"}

package/dist/src/presentation/web/app/actions/create-application.js

@@ -0,0 +1,29 @@
+'use server';
+import { resolve } from '../../lib/server-container.js';
+/**
+ * Thin server-action wrapper around CreateApplicationUseCase.
+ *
+ * All orchestration (slug allocation, project scaffold, app persistence,
+ * prompt building, first-message dispatch) lives inside the use case so
+ * every presentation layer (Web / CLI / TUI) gets identical behavior
+ * from a single call.
+ */
+export async function createApplication(input) {
+    if (!input.description?.trim()) {
+        return { error: 'Description is required' };
+    }
+    try {
+        const useCase = resolve('CreateApplicationUseCase');
+        const result = await useCase.execute({
+            description: input.description.trim(),
+            agentType: input.agentType,
+            modelOverride: input.modelOverride,
+            initialPrompt: input.initialPrompt,
+        });
+        return { application: result.application, repositoryPath: result.repositoryPath };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Failed to create application';
+        return { error: message };
+    }
+}

package/dist/src/presentation/web/app/actions/create-project-and-feature.d.ts

@@ -0,0 +1,20 @@
+import type { Feature, Repository } from '../../../../../packages/core/src/domain/generated/output.js';
+interface QuickFeatureInput {
+    description: string;
+    attachments?: {
+        path: string;
+        name: string;
+        notes?: string;
+    }[];
+    agentType?: string;
+    model?: string;
+    fast?: boolean;
+}
+export declare function createProjectAndFeature(input: QuickFeatureInput): Promise<{
+    feature?: Feature;
+    repository?: Repository;
+    repositoryPath?: string;
+    error?: string;
+}>;
+export {};
+//# sourceMappingURL=create-project-and-feature.d.ts.map

package/dist/src/presentation/web/app/actions/create-project-and-feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-project-and-feature.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/app/actions/create-project-and-feature.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AAGhF,UAAU,iBAAiB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AA6CD,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC;IAC/E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CA6CD"}

package/dist/src/presentation/web/app/actions/create-project-and-feature.js

@@ -0,0 +1,84 @@
+'use server';
+import { resolve } from '../../lib/server-container.js';
+import { createFeature } from './create-feature.js';
+/**
+ * Default project instructions prepended to the user's description.
+ * These ensure that even a vague one-liner from a non-technical user
+ * results in a well-structured, runnable React application.
+ */
+const PROJECT_PREAMBLE = `\
+## Project Requirements
+
+Build this as a **React application** using Vite as the build tool.
+
+### Structure
+- Initialize with \`npm create vite@latest . -- --template react-ts\` scaffolding
+- Organize code into clear folders: \`src/components/\`, \`src/pages/\`, \`src/assets/\`
+- Use TypeScript throughout
+- Include a working \`package.json\` with all dependencies
+
+### Design & UI
+- Create a polished, production-quality interface — not a prototype
+- Use modern CSS (CSS modules or Tailwind CSS) with thoughtful spacing, typography, and color
+- Make it fully responsive (mobile-first)
+- Add subtle micro-interactions: hover states, transitions, focus rings
+- Use professional placeholder content (realistic text, not lorem ipsum)
+- Pick a cohesive color palette and apply it consistently
+
+### Quality
+- Every component should be self-contained and reusable
+- Include proper HTML semantics and accessibility (ARIA labels, alt text, keyboard nav)
+- The app must start successfully with \`npm install && npm run dev\`
+
+---
+
+## What to Build
+`;
+/**
+ * Derive a concise project name from a free-form description.
+ * Takes the first handful of meaningful words — `CreateProjectUseCase`
+ * will then slugify + cap length for the actual directory name.
+ */
+function deriveProjectName(description) {
+    return description.trim().split(/\s+/).slice(0, 6).join(' ');
+}
+export async function createProjectAndFeature(input) {
+    const { description, attachments, agentType, model } = input;
+    if (!description?.trim()) {
+        return { error: 'Description is required' };
+    }
+    try {
+        const createProject = resolve('CreateProjectUseCase');
+        const projectResult = await createProject.execute({
+            name: deriveProjectName(description),
+        });
+        if (!projectResult.ok) {
+            return { error: projectResult.error };
+        }
+        const projectPath = projectResult.path;
+        const addRepo = resolve('AddRepositoryUseCase');
+        const repository = await addRepo.execute({ path: projectPath });
+        // Enrich the user's prompt with project-quality instructions
+        const enrichedDescription = PROJECT_PREAMBLE + description.trim();
+        const featureResult = await createFeature({
+            description: enrichedDescription,
+            repositoryPath: projectPath,
+            attachments,
+            agentType,
+            model,
+            fast: input.fast,
+        });
+        if (featureResult.error) {
+            return { error: featureResult.error };
+        }
+        return {
+            feature: featureResult.feature,
+            repository,
+            repositoryPath: projectPath,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Failed to create project';
+        return { error: message };
+    }
+}

package/dist/src/presentation/web/app/actions/delete-application.d.ts

@@ -0,0 +1,4 @@
+export declare function deleteApplication(id: string): Promise<{
+    error?: string;
+}>;
+//# sourceMappingURL=delete-application.d.ts.map

package/dist/src/presentation/web/app/actions/delete-application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-application.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/app/actions/delete-application.ts"],"names":[],"mappings":"AAKA,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAa/E"}

package/dist/src/presentation/web/app/actions/delete-application.js

@@ -0,0 +1,16 @@
+'use server';
+import { resolve } from '../../lib/server-container.js';
+export async function deleteApplication(id) {
+    if (!id?.trim()) {
+        return { error: 'Application ID is required' };
+    }
+    try {
+        const useCase = resolve('DeleteApplicationUseCase');
+        await useCase.execute(id);
+        return {};
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Failed to delete application';
+        return { error: message };
+    }
+}

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

@@ -0,0 +1,20 @@
+import { DeploymentState } from '../../../../../packages/core/src/domain/generated/output.js';
+/**
+ * Start a local dev server for an application.
+ *
+ * Mirrors `deployFeature` / `deployRepository`, but keyed by the
+ * application's stable ID (UUID) so multiple applications at similar
+ * paths can't collide in the `dev_servers` table.
+ *
+ * The `DeploymentService` writes to the `dev_servers` SQLite table on
+ * spawn, updates it on Ready (with the detected URL), and removes the
+ * row on stop — so deployment state is fully persisted across page
+ * reloads AND service restarts (recoverAll() reconciles live PIDs on
+ * startup).
+ */
+export declare function deployApplication(applicationId: string): Promise<{
+    success: boolean;
+    error?: string;
+    state?: DeploymentState;
+}>;
+//# sourceMappingURL=deploy-application.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deploy-application.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/app/actions/deploy-application.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAIvE;;;;;;;;;;;;GAYG;AACH,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,eAAe,CAAA;CAAE,CAAC,CAiDxE"}

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

@@ -0,0 +1,62 @@
+'use server';
+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 { DeploymentState } from '../../../../../packages/core/src/domain/generated/output.js';
+const log = createDeploymentLogger('[deployApplication]');
+/**
+ * Start a local dev server for an application.
+ *
+ * Mirrors `deployFeature` / `deployRepository`, but keyed by the
+ * application's stable ID (UUID) so multiple applications at similar
+ * paths can't collide in the `dev_servers` table.
+ *
+ * The `DeploymentService` writes to the `dev_servers` SQLite table on
+ * spawn, updates it on Ready (with the detected URL), and removes the
+ * row on stop — so deployment state is fully persisted across page
+ * reloads AND service restarts (recoverAll() reconciles live PIDs on
+ * startup).
+ */
+export async function deployApplication(applicationId) {
+    log.info(`called — applicationId="${applicationId}"`);
+    if (!applicationId?.trim()) {
+        log.warn('rejected — applicationId is empty');
+        return { success: false, error: 'applicationId is required' };
+    }
+    try {
+        const appRepo = resolve('IApplicationRepository');
+        const application = await appRepo.findById(applicationId);
+        if (!application) {
+            log.warn(`application not found: "${applicationId}"`);
+            return { success: false, error: `Application not found: ${applicationId}` };
+        }
+        const repositoryPath = application.repositoryPath;
+        log.info(`application found — repositoryPath="${repositoryPath}"`);
+        if (!existsSync(repositoryPath)) {
+            log.warn(`repository path does not exist on disk: "${repositoryPath}"`);
+            return { success: false, error: `Repository path does not exist: ${repositoryPath}` };
+        }
+        const shepInstance = resolve('IShepInstanceService');
+        if (shepInstance.isSameInstance(repositoryPath)) {
+            log.warn('rejected — target is the running shep instance');
+            return {
+                success: false,
+                error: 'Cannot start a dev server for the repository Shep is running from',
+            };
+        }
+        log.info('repository exists, calling deploymentService.start()');
+        const deploymentService = resolve('IDeploymentService');
+        // Key by application.id (not repositoryPath) so each application is
+        // its own first-class row in `dev_servers` — keeps recovery and the
+        // dev-server lifecycle isolated per application even if two apps
+        // happened to share a filesystem root.
+        deploymentService.start(applicationId, repositoryPath, 'application');
+        log.info('start() returned successfully — state=Booting');
+        return { success: true, state: DeploymentState.Booting };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Failed to deploy application';
+        log.error(`error: ${message}`, error);
+        return { success: false, error: message };
+    }
+}

package/dist/src/presentation/web/app/actions/get-application-debug-prompt.d.ts

@@ -0,0 +1,25 @@
+export interface ApplicationDebugPromptResult {
+    /** Shep brief — brand, role, mission, tech stack, workflow, quality
+     *  bar, definition of done, workspace section. What the agent SDK
+     *  gets as systemPrompt on every turn. */
+    systemPrompt?: string;
+    /** User-facing chat message — just the verbatim description. */
+    userMessage?: string;
+    /**
+     * Convenience: `systemPrompt` + `---` + `userMessage`, suitable for
+     * pasting into a clipboard / scratchpad / bug report.
+     */
+    combined?: string;
+    error?: string;
+}
+/**
+ * Rebuild the full application-creation prompt for an existing
+ * application. Debug-only — lets the operator see exactly what Shep
+ * handed to the agent on turn 1 of the session.
+ *
+ * The prompt is reconstructed from the stored description + repo path,
+ * so it matches what `createApplication` would have generated at the
+ * moment of creation (the builder is deterministic per input).
+ */
+export declare function getApplicationDebugPrompt(applicationId: string): Promise<ApplicationDebugPromptResult>;
+//# sourceMappingURL=get-application-debug-prompt.d.ts.map

package/dist/src/presentation/web/app/actions/get-application-debug-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-application-debug-prompt.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/app/actions/get-application-debug-prompt.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,4BAA4B;IAC3C;;8CAE0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAsB,yBAAyB,CAC7C,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,4BAA4B,CAAC,CA6BvC"}

package/dist/src/presentation/web/app/actions/get-application-debug-prompt.js

@@ -0,0 +1,37 @@
+'use server';
+import { resolve } from '../../lib/server-container.js';
+/**
+ * Rebuild the full application-creation prompt for an existing
+ * application. Debug-only — lets the operator see exactly what Shep
+ * handed to the agent on turn 1 of the session.
+ *
+ * The prompt is reconstructed from the stored description + repo path,
+ * so it matches what `createApplication` would have generated at the
+ * moment of creation (the builder is deterministic per input).
+ */
+export async function getApplicationDebugPrompt(applicationId) {
+    try {
+        if (!applicationId?.trim()) {
+            return { error: 'applicationId is required' };
+        }
+        const getApp = resolve('GetApplicationUseCase');
+        const application = await getApp.execute(applicationId);
+        if (!application) {
+            return { error: 'Application not found' };
+        }
+        const builder = resolve('IApplicationCreationPromptBuilder');
+        const { systemPrompt, userMessage } = builder.build({
+            description: application.description ?? '',
+            workspace: {
+                workingDirectory: application.repositoryPath,
+                platform: process.platform === 'win32' ? 'windows' : 'posix',
+            },
+        });
+        const combined = `# SYSTEM PROMPT\n\n${systemPrompt}\n\n---\n\n# USER MESSAGE\n\n${userMessage}\n`;
+        return { systemPrompt, userMessage, combined };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Failed to build debug prompt';
+        return { error: message };
+    }
+}