@shepai/cli 1.14.2 → 1.15.1

package/dist/src/application/use-cases/agents/get-agent-run.use-case.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Get Agent Run Use Case
+ *
+ * Retrieves agent run details by ID for display purposes.
+ */
+import type { AgentRun } from '../../../domain/generated/output.js';
+import type { IAgentRunRepository } from '../../ports/output/agents/agent-run-repository.interface.js';
+/**
+ * Use case for getting a specific agent run by ID.
+ */
+export declare class GetAgentRunUseCase {
+    private readonly agentRunRepository;
+    constructor(agentRunRepository: IAgentRunRepository);
+    /**
+     * Get an agent run by ID.
+     *
+     * @param id - The agent run ID
+     * @returns The agent run or null if not found
+     */
+    execute(id: string): Promise<AgentRun | null>;
+}
+//# sourceMappingURL=get-agent-run.use-case.d.ts.map

package/dist/src/application/use-cases/agents/get-agent-run.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-agent-run.use-case.d.ts","sourceRoot":"","sources":["../../../../../src/application/use-cases/agents/get-agent-run.use-case.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AAEvG;;GAEG;AACH,qBACa,kBAAkB;IAG3B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;gBAAlB,kBAAkB,EAAE,mBAAmB;IAG1D;;;;;OAKG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;CAGpD"}

package/dist/src/application/use-cases/agents/get-agent-run.use-case.js

@@ -0,0 +1,42 @@
+/**
+ * Get Agent Run Use Case
+ *
+ * Retrieves agent run details by ID for display purposes.
+ */
+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';
+/**
+ * Use case for getting a specific agent run by ID.
+ */
+let GetAgentRunUseCase = class GetAgentRunUseCase {
+    agentRunRepository;
+    constructor(agentRunRepository) {
+        this.agentRunRepository = agentRunRepository;
+    }
+    /**
+     * Get an agent run by ID.
+     *
+     * @param id - The agent run ID
+     * @returns The agent run or null if not found
+     */
+    async execute(id) {
+        return this.agentRunRepository.findById(id);
+    }
+};
+GetAgentRunUseCase = __decorate([
+    injectable(),
+    __param(0, inject('IAgentRunRepository')),
+    __metadata("design:paramtypes", [Object])
+], GetAgentRunUseCase);
+export { GetAgentRunUseCase };

package/dist/src/application/use-cases/agents/list-agent-runs.use-case.d.ts

@@ -0,0 +1,21 @@
+/**
+ * List Agent Runs Use Case
+ *
+ * Retrieves all agent runs for listing/display purposes.
+ */
+import type { AgentRun } from '../../../domain/generated/output.js';
+import type { IAgentRunRepository } from '../../ports/output/agents/agent-run-repository.interface.js';
+/**
+ * Use case for listing all agent runs.
+ */
+export declare class ListAgentRunsUseCase {
+    private readonly agentRunRepository;
+    constructor(agentRunRepository: IAgentRunRepository);
+    /**
+     * List all agent runs sorted by creation time (most recent first).
+     *
+     * @returns Array of agent runs sorted by createdAt descending
+     */
+    execute(): Promise<AgentRun[]>;
+}
+//# sourceMappingURL=list-agent-runs.use-case.d.ts.map

package/dist/src/application/use-cases/agents/list-agent-runs.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-agent-runs.use-case.d.ts","sourceRoot":"","sources":["../../../../../src/application/use-cases/agents/list-agent-runs.use-case.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AAEvG;;GAEG;AACH,qBACa,oBAAoB;IAG7B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;gBAAlB,kBAAkB,EAAE,mBAAmB;IAG1D;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;CAoBrC"}

package/dist/src/application/use-cases/agents/list-agent-runs.use-case.js

@@ -0,0 +1,54 @@
+/**
+ * List Agent Runs Use Case
+ *
+ * Retrieves all agent runs for listing/display purposes.
+ */
+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';
+/**
+ * Use case for listing all agent runs.
+ */
+let ListAgentRunsUseCase = class ListAgentRunsUseCase {
+    agentRunRepository;
+    constructor(agentRunRepository) {
+        this.agentRunRepository = agentRunRepository;
+    }
+    /**
+     * List all agent runs sorted by creation time (most recent first).
+     *
+     * @returns Array of agent runs sorted by createdAt descending
+     */
+    async execute() {
+        const runs = await this.agentRunRepository.list();
+        return runs.sort((a, b) => {
+            const dateA = typeof a.createdAt === 'string'
+                ? new Date(a.createdAt).getTime()
+                : a.createdAt instanceof Date
+                    ? a.createdAt.getTime()
+                    : 0;
+            const dateB = typeof b.createdAt === 'string'
+                ? new Date(b.createdAt).getTime()
+                : b.createdAt instanceof Date
+                    ? b.createdAt.getTime()
+                    : 0;
+            return dateB - dateA; // Descending order (most recent first)
+        });
+    }
+};
+ListAgentRunsUseCase = __decorate([
+    injectable(),
+    __param(0, inject('IAgentRunRepository')),
+    __metadata("design:paramtypes", [Object])
+], ListAgentRunsUseCase);
+export { ListAgentRunsUseCase };

package/dist/src/application/use-cases/agents/reject-agent-run.use-case.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Reject Agent Run Use Case
+ *
+ * Rejects a paused agent run (waiting_approval status) and
+ * marks it as cancelled with the rejection reason.
+ */
+import type { IAgentRunRepository } from '../../ports/output/agents/agent-run-repository.interface.js';
+export declare class RejectAgentRunUseCase {
+    private readonly agentRunRepository;
+    constructor(agentRunRepository: IAgentRunRepository);
+    execute(id: string, reason?: string): Promise<{
+        rejected: boolean;
+        reason: string;
+    }>;
+}
+//# sourceMappingURL=reject-agent-run.use-case.d.ts.map

package/dist/src/application/use-cases/agents/reject-agent-run.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reject-agent-run.use-case.d.ts","sourceRoot":"","sources":["../../../../../src/application/use-cases/agents/reject-agent-run.use-case.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AAGvG,qBACa,qBAAqB;IAG9B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;gBAAlB,kBAAkB,EAAE,mBAAmB;IAGpD,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAuB3F"}

package/dist/src/application/use-cases/agents/reject-agent-run.use-case.js

@@ -0,0 +1,52 @@
+/**
+ * Reject Agent Run Use Case
+ *
+ * Rejects a paused agent run (waiting_approval status) and
+ * marks it as cancelled with the rejection reason.
+ */
+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 { AgentRunStatus } from '../../../domain/generated/output.js';
+let RejectAgentRunUseCase = class RejectAgentRunUseCase {
+    agentRunRepository;
+    constructor(agentRunRepository) {
+        this.agentRunRepository = agentRunRepository;
+    }
+    async execute(id, reason) {
+        const run = await this.agentRunRepository.findById(id);
+        if (!run) {
+            return { rejected: false, reason: 'Agent run not found' };
+        }
+        if (run.status !== AgentRunStatus.waitingApproval) {
+            return {
+                rejected: false,
+                reason: `Agent run is not waiting for approval (status: ${run.status})`,
+            };
+        }
+        const now = new Date();
+        await this.agentRunRepository.updateStatus(id, AgentRunStatus.cancelled, {
+            approvalStatus: 'rejected',
+            error: reason ?? 'Rejected by user',
+            completedAt: now,
+            updatedAt: now,
+        });
+        return { rejected: true, reason: 'Rejected and cancelled' };
+    }
+};
+RejectAgentRunUseCase = __decorate([
+    injectable(),
+    __param(0, inject('IAgentRunRepository')),
+    __metadata("design:paramtypes", [Object])
+], RejectAgentRunUseCase);
+export { RejectAgentRunUseCase };

package/dist/src/application/use-cases/agents/run-agent.use-case.d.ts

@@ -10,8 +10,8 @@
  * - Options are passed through to the runner as-is
  */
 import type { AgentRun, AgentRunEvent } from '../../../domain/generated/output.js';
-import type { IAgentRunner, AgentRunOptions } from '../../ports/output/agent-runner.interface.js';
-import type { IAgentRegistry } from '../../ports/output/agent-registry.interface.js';
+import type { IAgentRunner, AgentRunOptions } from '../../ports/output/agents/agent-runner.interface.js';
+import type { IAgentRegistry } from '../../ports/output/agents/agent-registry.interface.js';
 /**
  * Input for running an agent workflow.
  */

package/dist/src/application/use-cases/agents/run-agent.use-case.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-agent.use-case.d.ts","sourceRoot":"","sources":["../../../../../src/application/use-cases/agents/run-agent.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACnF,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAClG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAErF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,qBACa,eAAe;IAGxB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAFb,WAAW,EAAE,YAAY,EAEzB,aAAa,EAAE,cAAc;IAGhD;;;;;;OAMG;IACG,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC;IAYtD;;;;;;OAMG;IACI,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa,CAAC,aAAa,CAAC;CAWzE"}
+{"version":3,"file":"run-agent.use-case.d.ts","sourceRoot":"","sources":["../../../../../src/application/use-cases/agents/run-agent.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACnF,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EAChB,MAAM,qDAAqD,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uDAAuD,CAAC;AAE5F;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,qBACa,eAAe;IAGxB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAFb,WAAW,EAAE,YAAY,EAEzB,aAAa,EAAE,cAAc;IAGhD;;;;;;OAMG;IACG,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC;IAYtD;;;;;;OAMG;IACI,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa,CAAC,aAAa,CAAC;CAWzE"}

package/dist/src/application/use-cases/agents/show-agent-run.use-case.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Show Agent Run Use Case
+ *
+ * Retrieves a single agent run by ID with process liveness check.
+ *
+ * Business Rules:
+ * - Tries exact ID match first, then prefix match via list()
+ * - Throws if the agent run does not exist
+ * - Checks process liveness for runs that have a pid
+ */
+import type { AgentRun } from '../../../domain/generated/output.js';
+import type { IAgentRunRepository } from '../../ports/output/agents/agent-run-repository.interface.js';
+import type { IFeatureAgentProcessService } from '../../ports/output/agents/feature-agent-process.interface.js';
+export interface ShowAgentRunResult {
+    run: AgentRun;
+    isAlive: boolean;
+}
+export declare class ShowAgentRunUseCase {
+    private readonly runRepo;
+    private readonly processService;
+    constructor(runRepo: IAgentRunRepository, processService: IFeatureAgentProcessService);
+    execute(runId: string): Promise<ShowAgentRunResult>;
+}
+//# sourceMappingURL=show-agent-run.use-case.d.ts.map

package/dist/src/application/use-cases/agents/show-agent-run.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"show-agent-run.use-case.d.ts","sourceRoot":"","sources":["../../../../../src/application/use-cases/agents/show-agent-run.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AACvG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8DAA8D,CAAC;AAEhH,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,QAAQ,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,qBACa,mBAAmB;IAG5B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAExB,OAAO,CAAC,QAAQ,CAAC,cAAc;gBAFd,OAAO,EAAE,mBAAmB,EAE5B,cAAc,EAAE,2BAA2B;IAGxD,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAkB1D"}

package/dist/src/application/use-cases/agents/show-agent-run.use-case.js

@@ -0,0 +1,52 @@
+/**
+ * Show Agent Run Use Case
+ *
+ * Retrieves a single agent run by ID with process liveness check.
+ *
+ * Business Rules:
+ * - Tries exact ID match first, then prefix match via list()
+ * - Throws if the agent run does not exist
+ * - Checks process liveness for runs that have a pid
+ */
+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';
+let ShowAgentRunUseCase = class ShowAgentRunUseCase {
+    runRepo;
+    processService;
+    constructor(runRepo, processService) {
+        this.runRepo = runRepo;
+        this.processService = processService;
+    }
+    async execute(runId) {
+        // Try exact match first
+        let run = await this.runRepo.findById(runId);
+        // Fall back to prefix match
+        if (!run) {
+            const allRuns = await this.runRepo.list();
+            run = allRuns.find((r) => r.id.startsWith(runId)) ?? null;
+        }
+        if (!run) {
+            throw new Error(`Agent run not found: "${runId}"`);
+        }
+        const isAlive = run.pid != null ? this.processService.isAlive(run.pid) : false;
+        return { run, isAlive };
+    }
+};
+ShowAgentRunUseCase = __decorate([
+    injectable(),
+    __param(0, inject('IAgentRunRepository')),
+    __param(1, inject('IFeatureAgentProcessService')),
+    __metadata("design:paramtypes", [Object, Object])
+], ShowAgentRunUseCase);
+export { ShowAgentRunUseCase };

package/dist/src/application/use-cases/agents/stop-agent-run.use-case.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Stop Agent Run Use Case
+ *
+ * Sends SIGTERM to a running agent's worker process and marks it as cancelled.
+ */
+import type { IAgentRunRepository } from '../../ports/output/agents/agent-run-repository.interface.js';
+export declare class StopAgentRunUseCase {
+    private readonly agentRunRepository;
+    constructor(agentRunRepository: IAgentRunRepository);
+    execute(id: string): Promise<{
+        stopped: boolean;
+        reason: string;
+    }>;
+}
+//# sourceMappingURL=stop-agent-run.use-case.d.ts.map

package/dist/src/application/use-cases/agents/stop-agent-run.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-agent-run.use-case.d.ts","sourceRoot":"","sources":["../../../../../src/application/use-cases/agents/stop-agent-run.use-case.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AAGvG,qBACa,mBAAmB;IAG5B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;gBAAlB,kBAAkB,EAAE,mBAAmB;IAGpD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CA4DzE"}

package/dist/src/application/use-cases/agents/stop-agent-run.use-case.js

@@ -0,0 +1,86 @@
+/**
+ * Stop Agent Run Use Case
+ *
+ * Sends SIGTERM to a running agent's worker process and marks it as cancelled.
+ */
+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 { AgentRunStatus } from '../../../domain/generated/output.js';
+let StopAgentRunUseCase = class StopAgentRunUseCase {
+    agentRunRepository;
+    constructor(agentRunRepository) {
+        this.agentRunRepository = agentRunRepository;
+    }
+    async execute(id) {
+        const run = await this.agentRunRepository.findById(id);
+        if (!run) {
+            return { stopped: false, reason: 'Agent run not found' };
+        }
+        const terminalStatuses = new Set([
+            AgentRunStatus.completed,
+            AgentRunStatus.failed,
+            AgentRunStatus.interrupted,
+            AgentRunStatus.cancelled,
+        ]);
+        if (terminalStatuses.has(run.status)) {
+            return { stopped: false, reason: `Agent run already in terminal state: ${run.status}` };
+        }
+        if (!run.pid) {
+            // No PID — just mark as cancelled
+            const now = new Date();
+            await this.agentRunRepository.updateStatus(id, AgentRunStatus.cancelled, {
+                error: 'Cancelled by user (no PID)',
+                completedAt: now,
+                updatedAt: now,
+            });
+            return { stopped: true, reason: 'Marked as cancelled (no PID to signal)' };
+        }
+        // Check if process is alive
+        let alive = false;
+        try {
+            process.kill(run.pid, 0);
+            alive = true;
+        }
+        catch {
+            alive = false;
+        }
+        if (alive) {
+            // Send SIGTERM for graceful shutdown
+            try {
+                process.kill(run.pid, 'SIGTERM');
+            }
+            catch {
+                // Process may have died between check and signal
+            }
+        }
+        const now = new Date();
+        await this.agentRunRepository.updateStatus(id, AgentRunStatus.cancelled, {
+            error: 'Cancelled by user',
+            completedAt: now,
+            updatedAt: now,
+        });
+        return {
+            stopped: true,
+            reason: alive
+                ? `Sent SIGTERM to PID ${run.pid}`
+                : `Process already dead, marked as cancelled`,
+        };
+    }
+};
+StopAgentRunUseCase = __decorate([
+    injectable(),
+    __param(0, inject('IAgentRunRepository')),
+    __metadata("design:paramtypes", [Object])
+], StopAgentRunUseCase);
+export { StopAgentRunUseCase };

package/dist/src/application/use-cases/agents/validate-agent-auth.use-case.d.ts

@@ -9,7 +9,7 @@
  * - Returns validation result with version or error details
  */
 import type { AgentType } from '../../../domain/generated/output.js';
-import type { IAgentValidator, AgentValidationResult } from '../../ports/output/agent-validator.interface.js';
+import type { IAgentValidator, AgentValidationResult } from '../../ports/output/agents/agent-validator.interface.js';
 /**
  * Use case for validating agent availability.
  *

package/dist/src/application/use-cases/agents/validate-agent-auth.use-case.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-agent-auth.use-case.d.ts","sourceRoot":"","sources":["../../../../../src/application/use-cases/agents/validate-agent-auth.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EACtB,MAAM,iDAAiD,CAAC;AAEzD;;;;;;GAMG;AACH,qBACa,wBAAwB;IAGjC,OAAO,CAAC,QAAQ,CAAC,cAAc;gBAAd,cAAc,EAAE,eAAe;IAGlD;;;;;OAKG;IACG,OAAO,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAGpE"}
+{"version":3,"file":"validate-agent-auth.use-case.d.ts","sourceRoot":"","sources":["../../../../../src/application/use-cases/agents/validate-agent-auth.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EACtB,MAAM,wDAAwD,CAAC;AAEhE;;;;;;GAMG;AACH,qBACa,wBAAwB;IAGjC,OAAO,CAAC,QAAQ,CAAC,cAAc;gBAAd,cAAc,EAAE,eAAe;IAGlD;;;;;OAKG;IACG,OAAO,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAGpE"}

package/dist/src/application/use-cases/features/create-feature.use-case.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Create Feature Use Case
+ *
+ * Creates a new feature entity with a git worktree for isolated development,
+ * initializes the spec directory with YAML templates, then spawns the
+ * feature agent to begin autonomous SDLC processing.
+ *
+ * Business Rules:
+ * - AI generates slug/name/description from user's free-text input
+ * - Falls back to regex-based slug if AI fails
+ * - Full user input is preserved as-is in spec.yaml
+ * - Slug must be unique within the repository
+ * - A git worktree is created at ~/.shep/repos/HASH/wt/SLUG/
+ * - Spec YAML files are scaffolded at WORKTREE/specs/NNN-SLUG/
+ * - Feature agent is spawned with the spec dir path
+ * - specPath is persisted on the Feature record
+ * - Initial lifecycle is Requirements
+ */
+import type { Feature } from '../../../domain/generated/output.js';
+import type { IFeatureRepository } from '../../ports/output/repositories/feature-repository.interface.js';
+import type { IWorktreeService } from '../../ports/output/services/worktree-service.interface.js';
+import type { IFeatureAgentProcessService } from '../../ports/output/agents/feature-agent-process.interface.js';
+import type { IAgentRunRepository } from '../../ports/output/agents/agent-run-repository.interface.js';
+import type { ISpecInitializerService } from '../../ports/output/services/spec-initializer.interface.js';
+import type { IAgentExecutorFactory } from '../../ports/output/agents/agent-executor-factory.interface.js';
+export interface CreateFeatureInput {
+    userInput: string;
+    repositoryPath: string;
+    approvalMode?: string;
+}
+export declare class CreateFeatureUseCase {
+    private readonly featureRepo;
+    private readonly worktreeService;
+    private readonly agentProcess;
+    private readonly runRepository;
+    private readonly specInitializer;
+    private readonly executorFactory;
+    constructor(featureRepo: IFeatureRepository, worktreeService: IWorktreeService, agentProcess: IFeatureAgentProcessService, runRepository: IAgentRunRepository, specInitializer: ISpecInitializerService, executorFactory: IAgentExecutorFactory);
+    execute(input: CreateFeatureInput): Promise<Feature>;
+    private generateMetadata;
+    private toSlug;
+}
+//# sourceMappingURL=create-feature.use-case.d.ts.map

package/dist/src/application/use-cases/features/create-feature.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-feature.use-case.d.ts","sourceRoot":"","sources":["../../../../../src/application/use-cases/features/create-feature.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AAEnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2DAA2D,CAAC;AAClG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8DAA8D,CAAC;AAChH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AACvG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2DAA2D,CAAC;AACzG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+DAA+D,CAAC;AAO3G,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAQD,qBACa,oBAAoB;IAG7B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAE9B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,eAAe;gBAVf,WAAW,EAAE,kBAAkB,EAE/B,eAAe,EAAE,gBAAgB,EAEjC,YAAY,EAAE,2BAA2B,EAEzC,aAAa,EAAE,mBAAmB,EAElC,eAAe,EAAE,uBAAuB,EAExC,eAAe,EAAE,qBAAqB;IAGnD,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;YA8E5C,gBAAgB;IA6C9B,OAAO,CAAC,MAAM;CAQf"}