@shepai/cli 1.178.1-pr536.42a22c6 → 1.178.1-pr542.7543cde

package/README.md

@@ -1,3 +1,5 @@
+![Shep](docs/screenshots/shep-card.jpg)
+
 <div align="center">
 
 <h1>

package/dist/packages/core/src/application/ports/output/repositories/index.d.ts

@@ -8,5 +8,4 @@ export type { ISettingsRepository } from './settings.repository.interface.js';
 export type { IRepositoryRepository } from './repository-repository.interface.js';
 export type { IInteractiveSessionRepository } from './interactive-session-repository.interface.js';
 export type { IInteractiveMessageRepository } from './interactive-message-repository.interface.js';
-export type { IApplicationRepository } from './application-repository.interface.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/packages/core/src/application/ports/output/repositories/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/repositories/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAChG,YAAY,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,YAAY,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAClF,YAAY,EAAE,6BAA6B,EAAE,MAAM,+CAA+C,CAAC;AACnG,YAAY,EAAE,6BAA6B,EAAE,MAAM,+CAA+C,CAAC;AACnG,YAAY,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/repositories/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAChG,YAAY,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,YAAY,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAClF,YAAY,EAAE,6BAA6B,EAAE,MAAM,+CAA+C,CAAC;AACnG,YAAY,EAAE,6BAA6B,EAAE,MAAM,+CAA+C,CAAC"}

package/dist/packages/core/src/application/ports/output/services/deployment-service.interface.d.ts

@@ -29,6 +29,13 @@ export interface DeploymentStatus {
     /** Detected URL when the dev server is Ready, null while Booting. */
     url: string | null;
 }
+/** Status snapshot including the target identifier, returned by listAll(). */
+export interface DeploymentStatusEntry extends DeploymentStatus {
+    /** Unique identifier for the deployment target (featureId or repositoryPath). */
+    targetId: string;
+    /** Type of target ('feature' or 'repository'). */
+    targetType: string;
+}
 /**
  * Port interface for managing local dev server deployments.
  *
@@ -75,6 +82,16 @@ export interface IDeploymentService {
      * @returns Status snapshot with state and url, or null if no deployment exists
      */
     getStatus(targetId: string): DeploymentStatus | null;
+    /**
+     * List all currently tracked deployments (both in-memory and persisted in DB)
+     * that have a live process. Dead deployments are cleaned up as a side effect.
+     *
+     * Used by ListDeploymentsUseCase for bulk hydration on page load and
+     * shared-state synchronization across client components.
+     *
+     * @returns Array of status entries keyed by targetId (never null; empty when no deployments)
+     */
+    listAll(): DeploymentStatusEntry[];
     /**
      * Force-stop all tracked deployments immediately.
      * Called during daemon shutdown to prevent orphaned dev server processes.

package/dist/packages/core/src/application/ports/output/services/deployment-service.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deployment-service.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/deployment-service.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,uEAAuE;AACvE,MAAM,WAAW,QAAQ;IACvB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,+CAA+C;AAC/C,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,KAAK,EAAE,eAAe,CAAC;IACvB,qEAAqE;IACrE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC;IAEzC;;;OAGG;IACH,UAAU,IAAI,IAAI,CAAC;IAEnB;;;;;;;;OAQG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvE;;;;;;OAMG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtC;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAAC;IAErD;;;OAGG;IACH,OAAO,IAAI,IAAI,CAAC;IAIhB;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,EAAE,GAAG,IAAI,CAAC;IAE7C;;;;;OAKG;IACH,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GAAG,IAAI,CAAC;IAE3D;;;;;OAKG;IACH,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GAAG,IAAI,CAAC;CAC7D"}
+{"version":3,"file":"deployment-service.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/deployment-service.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,uEAAuE;AACvE,MAAM,WAAW,QAAQ;IACvB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,+CAA+C;AAC/C,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,KAAK,EAAE,eAAe,CAAC;IACvB,qEAAqE;IACrE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED,8EAA8E;AAC9E,MAAM,WAAW,qBAAsB,SAAQ,gBAAgB;IAC7D,iFAAiF;IACjF,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC;IAEzC;;;OAGG;IACH,UAAU,IAAI,IAAI,CAAC;IAEnB;;;;;;;;OAQG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvE;;;;;;OAMG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtC;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAAC;IAErD;;;;;;;;OAQG;IACH,OAAO,IAAI,qBAAqB,EAAE,CAAC;IAEnC;;;OAGG;IACH,OAAO,IAAI,IAAI,CAAC;IAIhB;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,EAAE,GAAG,IAAI,CAAC;IAE7C;;;;;OAKG;IACH,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GAAG,IAAI,CAAC;IAE3D;;;;;OAKG;IACH,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GAAG,IAAI,CAAC;CAC7D"}

package/dist/packages/core/src/application/ports/output/services/file-system-service.interface.d.ts

@@ -14,5 +14,12 @@ export interface IFileSystemService {
      * @throws Error if removal fails for reasons other than non-existence
      */
     removeDirectory(dirPath: string): Promise<void>;
+    /**
+     * Check whether a file or directory exists at the given absolute path.
+     *
+     * @param path - Absolute filesystem path to check
+     * @returns true if the path exists, false otherwise
+     */
+    pathExists(path: string): boolean;
 }
 //# sourceMappingURL=file-system-service.interface.d.ts.map

package/dist/packages/core/src/application/ports/output/services/file-system-service.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-system-service.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/file-system-service.interface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;OAOG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD"}
+{"version":3,"file":"file-system-service.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/file-system-service.interface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;OAOG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC"}

package/dist/packages/core/src/application/ports/output/services/shep-instance-service.interface.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Shep Instance Service Interface
+ *
+ * Output port for detecting whether a given path is the same directory
+ * (or a worktree of) the currently running Shep instance.
+ *
+ * Starting a dev server for the running Shep instance's own repository
+ * would spawn a nested Shep process that conflicts with the shared
+ * ~/.shep/data SQLite database — so deployment use cases reject it.
+ */
+export interface IShepInstanceService {
+    /**
+     * Return true when `targetPath` resolves to the same canonical directory
+     * as the running Shep instance.
+     *
+     * Implementations must normalize paths to forward slashes and use
+     * `fs.realpathSync` so symlinks, case differences, and trailing
+     * separators do not yield false negatives.
+     */
+    isSameInstance(targetPath: string): boolean;
+}
+//# sourceMappingURL=shep-instance-service.interface.d.ts.map

package/dist/packages/core/src/application/ports/output/services/shep-instance-service.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shep-instance-service.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/shep-instance-service.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,oBAAoB;IACnC;;;;;;;OAOG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;CAC7C"}

package/dist/packages/core/src/application/ports/output/services/shep-instance-service.interface.js

@@ -0,0 +1,11 @@
+/**
+ * Shep Instance Service Interface
+ *
+ * Output port for detecting whether a given path is the same directory
+ * (or a worktree of) the currently running Shep instance.
+ *
+ * Starting a dev server for the running Shep instance's own repository
+ * would spawn a nested Shep process that conflicts with the shared
+ * ~/.shep/data SQLite database — so deployment use cases reject it.
+ */
+export {};

package/dist/packages/core/src/application/use-cases/deployments/get-deployment-status.use-case.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Get Deployment Status Use Case
+ *
+ * Returns the current deployment status snapshot for a single target,
+ * or null when no deployment exists.
+ */
+import type { IDeploymentService, DeploymentStatus } from '../../ports/output/services/deployment-service.interface.js';
+export declare class GetDeploymentStatusUseCase {
+    private readonly deploymentService;
+    constructor(deploymentService: IDeploymentService);
+    execute(targetId: string): Promise<DeploymentStatus | null>;
+}
+//# sourceMappingURL=get-deployment-status.use-case.d.ts.map

package/dist/packages/core/src/application/use-cases/deployments/get-deployment-status.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-deployment-status.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/deployments/get-deployment-status.use-case.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,6DAA6D,CAAC;AAErE,qBACa,0BAA0B;IAEL,OAAO,CAAC,QAAQ,CAAC,iBAAiB;gBAAjB,iBAAiB,EAAE,kBAAkB;IAGhF,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;CAMlE"}

package/dist/packages/core/src/application/use-cases/{applications/update-application.use-case.js → deployments/get-deployment-status.use-case.js}

@@ -1,7 +1,8 @@
 /**
- * Update Application Use Case
+ * Get Deployment Status Use Case
  *
- * Updates mutable fields on an existing application record.
+ * Returns the current deployment status snapshot for a single target,
+ * or null when no deployment exists.
  */
 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;
@@ -16,18 +17,21 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 import { injectable, inject } from 'tsyringe';
-let UpdateApplicationUseCase = class UpdateApplicationUseCase {
-    appRepo;
-    constructor(appRepo) {
-        this.appRepo = appRepo;
+let GetDeploymentStatusUseCase = class GetDeploymentStatusUseCase {
+    deploymentService;
+    constructor(deploymentService) {
+        this.deploymentService = deploymentService;
     }
-    async execute(id, fields) {
-        return this.appRepo.update(id, fields);
+    async execute(targetId) {
+        if (!targetId?.trim()) {
+            return null;
+        }
+        return this.deploymentService.getStatus(targetId);
     }
 };
-UpdateApplicationUseCase = __decorate([
+GetDeploymentStatusUseCase = __decorate([
     injectable(),
-    __param(0, inject('IApplicationRepository')),
+    __param(0, inject('IDeploymentService')),
     __metadata("design:paramtypes", [Object])
-], UpdateApplicationUseCase);
-export { UpdateApplicationUseCase };
+], GetDeploymentStatusUseCase);
+export { GetDeploymentStatusUseCase };

package/dist/packages/core/src/application/use-cases/deployments/list-deployments.use-case.d.ts

@@ -0,0 +1,14 @@
+/**
+ * List Deployments Use Case
+ *
+ * Returns all currently tracked dev server deployments with live processes.
+ * Used by presentation layers to hydrate shared deployment state on page
+ * load and to synchronize status across components viewing the same target.
+ */
+import type { IDeploymentService, DeploymentStatusEntry } from '../../ports/output/services/deployment-service.interface.js';
+export declare class ListDeploymentsUseCase {
+    private readonly deploymentService;
+    constructor(deploymentService: IDeploymentService);
+    execute(): Promise<DeploymentStatusEntry[]>;
+}
+//# sourceMappingURL=list-deployments.use-case.d.ts.map

package/dist/packages/core/src/application/use-cases/deployments/list-deployments.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-deployments.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/deployments/list-deployments.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EACV,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,6DAA6D,CAAC;AAErE,qBACa,sBAAsB;IAED,OAAO,CAAC,QAAQ,CAAC,iBAAiB;gBAAjB,iBAAiB,EAAE,kBAAkB;IAGhF,OAAO,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;CAGlD"}

package/dist/packages/core/src/application/use-cases/{applications/list-applications.use-case.js → deployments/list-deployments.use-case.js}

@@ -1,7 +1,9 @@
 /**
- * List Applications Use Case
+ * List Deployments Use Case
  *
- * Returns all (non-deleted) application records.
+ * Returns all currently tracked dev server deployments with live processes.
+ * Used by presentation layers to hydrate shared deployment state on page
+ * load and to synchronize status across components viewing the same target.
  */
 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;
@@ -16,18 +18,18 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 import { injectable, inject } from 'tsyringe';
-let ListApplicationsUseCase = class ListApplicationsUseCase {
-    appRepo;
-    constructor(appRepo) {
-        this.appRepo = appRepo;
+let ListDeploymentsUseCase = class ListDeploymentsUseCase {
+    deploymentService;
+    constructor(deploymentService) {
+        this.deploymentService = deploymentService;
     }
     async execute() {
-        return this.appRepo.list();
+        return this.deploymentService.listAll();
     }
 };
-ListApplicationsUseCase = __decorate([
+ListDeploymentsUseCase = __decorate([
     injectable(),
-    __param(0, inject('IApplicationRepository')),
+    __param(0, inject('IDeploymentService')),
     __metadata("design:paramtypes", [Object])
-], ListApplicationsUseCase);
-export { ListApplicationsUseCase };
+], ListDeploymentsUseCase);
+export { ListDeploymentsUseCase };

package/dist/packages/core/src/application/use-cases/deployments/start-feature-deployment.use-case.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Start Feature Deployment Use Case
+ *
+ * Starts a local dev server for a feature's git worktree.
+ *
+ * Business Rules:
+ * - featureId must be non-empty
+ * - Feature must exist in the repository
+ * - The feature's worktree path must exist on disk
+ * - Rejects deployments targeting the currently running Shep instance's
+ *   own repository (would create a conflicting nested Shep process)
+ *
+ * Returns the deployment status after the start call (Booting).
+ */
+import type { IFeatureRepository } from '../../ports/output/repositories/feature-repository.interface.js';
+import type { IDeploymentService, DeploymentStatus } from '../../ports/output/services/deployment-service.interface.js';
+import type { IFileSystemService } from '../../ports/output/services/file-system-service.interface.js';
+import type { IShepInstanceService } from '../../ports/output/services/shep-instance-service.interface.js';
+export declare class StartFeatureDeploymentUseCase {
+    private readonly featureRepo;
+    private readonly deploymentService;
+    private readonly fileSystem;
+    private readonly shepInstance;
+    constructor(featureRepo: IFeatureRepository, deploymentService: IDeploymentService, fileSystem: IFileSystemService, shepInstance: IShepInstanceService);
+    execute(featureId: string): Promise<DeploymentStatus>;
+}
+//# sourceMappingURL=start-feature-deployment.use-case.d.ts.map

package/dist/packages/core/src/application/use-cases/deployments/start-feature-deployment.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-feature-deployment.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/deployments/start-feature-deployment.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,6DAA6D,CAAC;AACrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8DAA8D,CAAC;AACvG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gEAAgE,CAAC;AAI3G,qBACa,6BAA6B;IAER,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU;IACzB,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAHd,WAAW,EAAE,kBAAkB,EAC/B,iBAAiB,EAAE,kBAAkB,EACrC,UAAU,EAAE,kBAAkB,EAC5B,YAAY,EAAE,oBAAoB;IAG/E,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CA2B5D"}

package/dist/packages/core/src/application/use-cases/deployments/start-feature-deployment.use-case.js

@@ -0,0 +1,68 @@
+/**
+ * Start Feature Deployment Use Case
+ *
+ * Starts a local dev server for a feature's git worktree.
+ *
+ * Business Rules:
+ * - featureId must be non-empty
+ * - Feature must exist in the repository
+ * - The feature's worktree path must exist on disk
+ * - Rejects deployments targeting the currently running Shep instance's
+ *   own repository (would create a conflicting nested Shep process)
+ *
+ * Returns the deployment status after the start call (Booting).
+ */
+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 { injectable, inject } from 'tsyringe';
+import { DeploymentState } from '../../../domain/generated/output.js';
+import { computeWorktreePath } from '../../../infrastructure/services/ide-launchers/compute-worktree-path.js';
+let StartFeatureDeploymentUseCase = class StartFeatureDeploymentUseCase {
+    featureRepo;
+    deploymentService;
+    fileSystem;
+    shepInstance;
+    constructor(featureRepo, deploymentService, fileSystem, shepInstance) {
+        this.featureRepo = featureRepo;
+        this.deploymentService = deploymentService;
+        this.fileSystem = fileSystem;
+        this.shepInstance = shepInstance;
+    }
+    async execute(featureId) {
+        if (!featureId?.trim()) {
+            throw new Error('featureId is required');
+        }
+        const feature = await this.featureRepo.findById(featureId);
+        if (!feature) {
+            throw new Error(`Feature not found: ${featureId}`);
+        }
+        if (this.shepInstance.isSameInstance(feature.repositoryPath)) {
+            throw new Error('Cannot start a dev server for features of the repository Shep is running from');
+        }
+        const worktreePath = feature.worktreePath ?? computeWorktreePath(feature.repositoryPath, feature.branch);
+        if (!this.fileSystem.pathExists(worktreePath)) {
+            throw new Error(`Worktree path does not exist: ${worktreePath}`);
+        }
+        this.deploymentService.start(featureId, worktreePath, 'feature');
+        return { state: DeploymentState.Booting, url: null };
+    }
+};
+StartFeatureDeploymentUseCase = __decorate([
+    injectable(),
+    __param(0, inject('IFeatureRepository')),
+    __param(1, inject('IDeploymentService')),
+    __param(2, inject('IFileSystemService')),
+    __param(3, inject('IShepInstanceService')),
+    __metadata("design:paramtypes", [Object, Object, Object, Object])
+], StartFeatureDeploymentUseCase);
+export { StartFeatureDeploymentUseCase };

package/dist/packages/core/src/application/use-cases/deployments/start-repository-deployment.use-case.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Start Repository Deployment Use Case
+ *
+ * Starts a local dev server rooted at a repository's top-level directory.
+ *
+ * Business Rules:
+ * - repositoryPath must be an absolute path
+ * - The directory must exist on disk
+ * - Rejects the currently running Shep instance's own repository
+ *
+ * Returns the deployment status after the start call (Booting).
+ */
+import type { IDeploymentService, DeploymentStatus } from '../../ports/output/services/deployment-service.interface.js';
+import type { IFileSystemService } from '../../ports/output/services/file-system-service.interface.js';
+import type { IShepInstanceService } from '../../ports/output/services/shep-instance-service.interface.js';
+export declare class StartRepositoryDeploymentUseCase {
+    private readonly deploymentService;
+    private readonly fileSystem;
+    private readonly shepInstance;
+    constructor(deploymentService: IDeploymentService, fileSystem: IFileSystemService, shepInstance: IShepInstanceService);
+    execute(repositoryPath: string): Promise<DeploymentStatus>;
+}
+//# sourceMappingURL=start-repository-deployment.use-case.d.ts.map

package/dist/packages/core/src/application/use-cases/deployments/start-repository-deployment.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-repository-deployment.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/deployments/start-repository-deployment.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,6DAA6D,CAAC;AACrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8DAA8D,CAAC;AACvG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gEAAgE,CAAC;AAG3G,qBACa,gCAAgC;IAEX,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU;IACzB,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAFd,iBAAiB,EAAE,kBAAkB,EACrC,UAAU,EAAE,kBAAkB,EAC5B,YAAY,EAAE,oBAAoB;IAG/E,OAAO,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAiBjE"}

package/dist/packages/core/src/application/use-cases/deployments/start-repository-deployment.use-case.js

@@ -0,0 +1,58 @@
+/**
+ * Start Repository Deployment Use Case
+ *
+ * Starts a local dev server rooted at a repository's top-level directory.
+ *
+ * Business Rules:
+ * - repositoryPath must be an absolute path
+ * - The directory must exist on disk
+ * - Rejects the currently running Shep instance's own repository
+ *
+ * Returns the deployment status after the start call (Booting).
+ */
+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 { isAbsolute } from 'node:path';
+import { injectable, inject } from 'tsyringe';
+import { DeploymentState } from '../../../domain/generated/output.js';
+let StartRepositoryDeploymentUseCase = class StartRepositoryDeploymentUseCase {
+    deploymentService;
+    fileSystem;
+    shepInstance;
+    constructor(deploymentService, fileSystem, shepInstance) {
+        this.deploymentService = deploymentService;
+        this.fileSystem = fileSystem;
+        this.shepInstance = shepInstance;
+    }
+    async execute(repositoryPath) {
+        if (!repositoryPath || !isAbsolute(repositoryPath)) {
+            throw new Error('repositoryPath must be an absolute path');
+        }
+        if (!this.fileSystem.pathExists(repositoryPath)) {
+            throw new Error(`Directory does not exist: ${repositoryPath}`);
+        }
+        if (this.shepInstance.isSameInstance(repositoryPath)) {
+            throw new Error('Cannot start a dev server for the repository Shep is running from');
+        }
+        this.deploymentService.start(repositoryPath, repositoryPath, 'repository');
+        return { state: DeploymentState.Booting, url: null };
+    }
+};
+StartRepositoryDeploymentUseCase = __decorate([
+    injectable(),
+    __param(0, inject('IDeploymentService')),
+    __param(1, inject('IFileSystemService')),
+    __param(2, inject('IShepInstanceService')),
+    __metadata("design:paramtypes", [Object, Object, Object])
+], StartRepositoryDeploymentUseCase);
+export { StartRepositoryDeploymentUseCase };

package/dist/packages/core/src/application/use-cases/deployments/stop-deployment.use-case.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Stop Deployment Use Case
+ *
+ * Stops a running dev server deployment for the given targetId.
+ * Delegates graceful shutdown (SIGTERM → SIGKILL) to the deployment service.
+ */
+import type { IDeploymentService } from '../../ports/output/services/deployment-service.interface.js';
+export declare class StopDeploymentUseCase {
+    private readonly deploymentService;
+    constructor(deploymentService: IDeploymentService);
+    execute(targetId: string): Promise<void>;
+}
+//# sourceMappingURL=stop-deployment.use-case.d.ts.map

package/dist/packages/core/src/application/use-cases/deployments/stop-deployment.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-deployment.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/deployments/stop-deployment.use-case.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6DAA6D,CAAC;AAEtG,qBACa,qBAAqB;IAEA,OAAO,CAAC,QAAQ,CAAC,iBAAiB;gBAAjB,iBAAiB,EAAE,kBAAkB;IAGhF,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAM/C"}

package/dist/packages/core/src/application/use-cases/{applications/get-application.use-case.js → deployments/stop-deployment.use-case.js}

@@ -1,7 +1,8 @@
 /**
- * Get Application Use Case
+ * Stop Deployment Use Case
  *
- * Retrieves a single application by its ID.
+ * Stops a running dev server deployment for the given targetId.
+ * Delegates graceful shutdown (SIGTERM → SIGKILL) to the deployment service.
  */
 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;
@@ -16,18 +17,21 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 import { injectable, inject } from 'tsyringe';
-let GetApplicationUseCase = class GetApplicationUseCase {
-    appRepo;
-    constructor(appRepo) {
-        this.appRepo = appRepo;
+let StopDeploymentUseCase = class StopDeploymentUseCase {
+    deploymentService;
+    constructor(deploymentService) {
+        this.deploymentService = deploymentService;
     }
-    async execute(id) {
-        return this.appRepo.findById(id);
+    async execute(targetId) {
+        if (!targetId?.trim()) {
+            throw new Error('targetId is required');
+        }
+        await this.deploymentService.stop(targetId);
     }
 };
-GetApplicationUseCase = __decorate([
+StopDeploymentUseCase = __decorate([
     injectable(),
-    __param(0, inject('IApplicationRepository')),
+    __param(0, inject('IDeploymentService')),
     __metadata("design:paramtypes", [Object])
-], GetApplicationUseCase);
-export { GetApplicationUseCase };
+], StopDeploymentUseCase);
+export { StopDeploymentUseCase };

package/dist/packages/core/src/domain/generated/output.d.ts

@@ -1679,48 +1679,6 @@ export type Repository = SoftDeletableEntity & {
      */
     upstreamUrl?: string;
 };
-export declare enum ApplicationStatus {
-    Idle = "Idle",
-    Active = "Active",
-    Error = "Error"
-}
-/**
- * A persistent AI-powered application workspace
- */
-export type Application = SoftDeletableEntity & {
-    /**
-     * Human-readable application name
-     */
-    name: string;
-    /**
-     * URL-friendly identifier (unique)
-     */
-    slug: string;
-    /**
-     * Original user prompt / purpose description
-     */
-    description: string;
-    /**
-     * Absolute path to the primary repository
-     */
-    repositoryPath: string;
-    /**
-     * Additional linked repository/directory paths (JSON array)
-     */
-    additionalPaths: string[];
-    /**
-     * Chosen agent executor type override
-     */
-    agentType?: string;
-    /**
-     * Chosen model override
-     */
-    modelOverride?: string;
-    /**
-     * Current application status
-     */
-    status: ApplicationStatus;
-};
 /**
  * Single installation suggestion for a tool
  */