@shepai/cli 1.14.2 → 1.15.1

package/dist/src/application/ports/output/repositories/feature-repository.interface.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Feature Repository Interface
+ *
+ * Output port for Feature persistence operations.
+ * Implementations handle database-specific logic (SQLite, etc.).
+ *
+ * Following Clean Architecture:
+ * - Domain and Application layers depend on this interface
+ * - Infrastructure layer provides concrete implementations
+ */
+import type { Feature, SdlcLifecycle } from '../../../../domain/generated/output.js';
+/**
+ * Filters for listing features.
+ */
+export interface FeatureListFilters {
+    repositoryPath?: string;
+    lifecycle?: SdlcLifecycle;
+}
+/**
+ * Repository interface for Feature entity persistence.
+ *
+ * Implementations must:
+ * - Handle database connection management
+ * - Provide thread-safe operations
+ * - Support query by slug + repositoryPath for uniqueness
+ */
+export interface IFeatureRepository {
+    /**
+     * Create a new feature record.
+     *
+     * @param feature - The feature to persist
+     */
+    create(feature: Feature): Promise<void>;
+    /**
+     * Find a feature by its unique ID.
+     *
+     * @param id - The feature ID
+     * @returns The feature or null if not found
+     */
+    findById(id: string): Promise<Feature | null>;
+    /**
+     * Find a feature by an ID prefix (e.g. first 8 chars from `feat ls`).
+     *
+     * @param prefix - A prefix of the feature UUID
+     * @returns The feature if exactly one match, null if none, throws if ambiguous
+     */
+    findByIdPrefix(prefix: string): Promise<Feature | null>;
+    /**
+     * Find a feature by its slug within a repository.
+     *
+     * @param slug - The URL-friendly feature identifier
+     * @param repositoryPath - The repository path to scope the search
+     * @returns The feature or null if not found
+     */
+    findBySlug(slug: string, repositoryPath: string): Promise<Feature | null>;
+    /**
+     * List features with optional filters.
+     *
+     * @param filters - Optional filters for repositoryPath and lifecycle
+     * @returns Array of matching features
+     */
+    list(filters?: FeatureListFilters): Promise<Feature[]>;
+    /**
+     * Update an existing feature.
+     *
+     * @param feature - The feature with updated fields
+     */
+    update(feature: Feature): Promise<void>;
+    /**
+     * Delete a feature by ID.
+     *
+     * @param id - The feature ID to delete
+     */
+    delete(id: string): Promise<void>;
+}
+//# sourceMappingURL=feature-repository.interface.d.ts.map

package/dist/src/application/ports/output/repositories/feature-repository.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-repository.interface.d.ts","sourceRoot":"","sources":["../../../../../../src/application/ports/output/repositories/feature-repository.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAErF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAE9C;;;;;OAKG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAExD;;;;;;OAMG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAE1E;;;;;OAKG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAEvD;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;;OAIG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC"}

package/dist/src/application/ports/output/repositories/feature-repository.interface.js

@@ -0,0 +1,11 @@
+/**
+ * Feature Repository Interface
+ *
+ * Output port for Feature persistence operations.
+ * Implementations handle database-specific logic (SQLite, etc.).
+ *
+ * Following Clean Architecture:
+ * - Domain and Application layers depend on this interface
+ * - Infrastructure layer provides concrete implementations
+ */
+export {};

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

@@ -0,0 +1,8 @@
+/**
+ * Repository Output Ports
+ *
+ * Interfaces for data persistence operations.
+ */
+export type { IFeatureRepository, FeatureListFilters } from './feature-repository.interface.js';
+export type { ISettingsRepository } from './settings.repository.interface.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../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"}

package/dist/src/application/ports/output/repositories/index.js

@@ -0,0 +1,6 @@
+/**
+ * Repository Output Ports
+ *
+ * Interfaces for data persistence operations.
+ */
+export {};

package/dist/src/application/ports/output/{settings.repository.interface.d.ts → repositories/settings.repository.interface.d.ts}

@@ -8,7 +8,7 @@
  * - Domain and Application layers depend on this interface
  * - Infrastructure layer provides concrete implementations
  */
-import type { Settings } from '../../../domain/generated/output.js';
+import type { Settings } from '../../../../domain/generated/output.js';
 /**
  * Repository interface for Settings entity persistence.
  *

package/dist/src/application/ports/output/repositories/settings.repository.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.repository.interface.d.ts","sourceRoot":"","sources":["../../../../../../src/application/ports/output/repositories/settings.repository.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wCAAwC,CAAC;AAEvE;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;OAMG;IACH,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAEjC;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C"}

package/dist/src/application/ports/output/services/external-issue-fetcher.interface.d.ts

@@ -0,0 +1,69 @@
+/**
+ * External Issue Fetcher Port Interface
+ *
+ * Output port for fetching issues/tickets from external systems (GitHub, Jira).
+ * Returns a normalized ExternalIssue that can be appended to feature context.
+ *
+ * Following Clean Architecture:
+ * - Application layer depends on this interface
+ * - Infrastructure layer provides concrete implementations
+ */
+/**
+ * Normalized issue representation from any external source.
+ */
+export interface ExternalIssue {
+    title: string;
+    description: string;
+    labels: string[];
+    url: string;
+    source: 'github' | 'jira';
+}
+/**
+ * Service interface for fetching issues from external systems.
+ */
+export interface IExternalIssueFetcher {
+    /**
+     * Fetch a GitHub issue by reference.
+     * Supports formats: owner/repo#123 or #123 (uses current repo).
+     *
+     * @param ref - GitHub issue reference (e.g., "owner/repo#42" or "#42")
+     * @returns Normalized external issue
+     * @throws IssueNotFoundError if issue doesn't exist
+     * @throws IssueServiceUnavailableError if gh CLI is not installed
+     */
+    fetchGitHubIssue(ref: string): Promise<ExternalIssue>;
+    /**
+     * Fetch a Jira ticket by key.
+     *
+     * @param key - Jira ticket key (e.g., "PROJ-123")
+     * @returns Normalized external issue
+     * @throws IssueNotFoundError if ticket doesn't exist
+     * @throws IssueAuthenticationError if credentials are invalid
+     */
+    fetchJiraTicket(key: string): Promise<ExternalIssue>;
+}
+/**
+ * Base error for issue fetcher failures.
+ */
+export declare class IssueFetcherError extends Error {
+    constructor(message: string);
+}
+/**
+ * Thrown when the requested issue/ticket is not found.
+ */
+export declare class IssueNotFoundError extends IssueFetcherError {
+    constructor(message: string);
+}
+/**
+ * Thrown when authentication to the external service fails.
+ */
+export declare class IssueAuthenticationError extends IssueFetcherError {
+    constructor(message: string);
+}
+/**
+ * Thrown when the external service is unavailable (e.g., gh CLI not installed).
+ */
+export declare class IssueServiceUnavailableError extends IssueFetcherError {
+    constructor(message: string);
+}
+//# sourceMappingURL=external-issue-fetcher.interface.d.ts.map

package/dist/src/application/ports/output/services/external-issue-fetcher.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-issue-fetcher.interface.d.ts","sourceRoot":"","sources":["../../../../../../src/application/ports/output/services/external-issue-fetcher.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;;;OAQG;IACH,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAEtD;;;;;;;OAOG;IACH,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACtD;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,iBAAiB;gBAC3C,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,iBAAiB;gBACjD,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,4BAA6B,SAAQ,iBAAiB;gBACrD,OAAO,EAAE,MAAM;CAI5B"}

package/dist/src/application/ports/output/services/external-issue-fetcher.interface.js

@@ -0,0 +1,46 @@
+/**
+ * External Issue Fetcher Port Interface
+ *
+ * Output port for fetching issues/tickets from external systems (GitHub, Jira).
+ * Returns a normalized ExternalIssue that can be appended to feature context.
+ *
+ * Following Clean Architecture:
+ * - Application layer depends on this interface
+ * - Infrastructure layer provides concrete implementations
+ */
+/**
+ * Base error for issue fetcher failures.
+ */
+export class IssueFetcherError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'IssueFetcherError';
+    }
+}
+/**
+ * Thrown when the requested issue/ticket is not found.
+ */
+export class IssueNotFoundError extends IssueFetcherError {
+    constructor(message) {
+        super(message);
+        this.name = 'IssueNotFoundError';
+    }
+}
+/**
+ * Thrown when authentication to the external service fails.
+ */
+export class IssueAuthenticationError extends IssueFetcherError {
+    constructor(message) {
+        super(message);
+        this.name = 'IssueAuthenticationError';
+    }
+}
+/**
+ * Thrown when the external service is unavailable (e.g., gh CLI not installed).
+ */
+export class IssueServiceUnavailableError extends IssueFetcherError {
+    constructor(message) {
+        super(message);
+        this.name = 'IssueServiceUnavailableError';
+    }
+}

package/dist/src/application/ports/output/services/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Service Output Ports
+ *
+ * Interfaces for external services and integrations.
+ */
+export type { IExternalIssueFetcher, ExternalIssue } from './external-issue-fetcher.interface.js';
+export { IssueFetcherError, IssueNotFoundError, IssueAuthenticationError, IssueServiceUnavailableError, } from './external-issue-fetcher.interface.js';
+export type { ISpecInitializerService, SpecInitializerResult, } from './spec-initializer.interface.js';
+export type { IVersionService } from './version-service.interface.js';
+export type { IWebServerService } from './web-server-service.interface.js';
+export type { IWorktreeService, WorktreeInfo } from './worktree-service.interface.js';
+export { WorktreeError, WorktreeErrorCode } from './worktree-service.interface.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/application/ports/output/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/application/ports/output/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAClG,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EACV,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/src/application/ports/output/services/index.js

@@ -0,0 +1,7 @@
+/**
+ * Service Output Ports
+ *
+ * Interfaces for external services and integrations.
+ */
+export { IssueFetcherError, IssueNotFoundError, IssueAuthenticationError, IssueServiceUnavailableError, } from './external-issue-fetcher.interface.js';
+export { WorktreeError, WorktreeErrorCode } from './worktree-service.interface.js';

package/dist/src/application/ports/output/services/spec-initializer.interface.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Spec Initializer Service Interface
+ *
+ * Output port for initializing feature specification directories.
+ * Creates the spec YAML files (spec.yaml, research.yaml, plan.yaml,
+ * tasks.yaml, feature.yaml) using the same templates as /shep-kit:new-feature.
+ */
+export interface SpecInitializerResult {
+    /** Absolute path to the created spec directory */
+    specDir: string;
+    /** Zero-padded 3-digit feature number used */
+    featureNumber: string;
+}
+export interface ISpecInitializerService {
+    /**
+     * Initialize a spec directory with template YAML files.
+     *
+     * Creates specs/NNN-SLUG/ inside the given base directory with:
+     * - spec.yaml
+     * - research.yaml
+     * - plan.yaml
+     * - tasks.yaml
+     * - feature.yaml
+     *
+     * @param basePath - Directory to create specs/ in (typically the worktree path)
+     * @param slug - Feature slug (kebab-case, e.g., "user-authentication")
+     * @param featureNumber - Sequential feature number (will be zero-padded to 3 digits)
+     * @param description - Feature description for template substitution
+     * @returns The spec directory path and feature number used
+     */
+    initialize(basePath: string, slug: string, featureNumber: number, description: string): Promise<SpecInitializerResult>;
+}
+//# sourceMappingURL=spec-initializer.interface.d.ts.map

package/dist/src/application/ports/output/services/spec-initializer.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-initializer.interface.d.ts","sourceRoot":"","sources":["../../../../../../src/application/ports/output/services/spec-initializer.interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,qBAAqB;IACpC,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;;;;;;;;OAeG;IACH,UAAU,CACR,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACnC"}

package/dist/src/application/ports/output/services/spec-initializer.interface.js

@@ -0,0 +1,8 @@
+/**
+ * Spec Initializer Service Interface
+ *
+ * Output port for initializing feature specification directories.
+ * Creates the spec YAML files (spec.yaml, research.yaml, plan.yaml,
+ * tasks.yaml, feature.yaml) using the same templates as /shep-kit:new-feature.
+ */
+export {};

package/dist/src/application/ports/output/{version-service.interface.d.ts → services/version-service.interface.d.ts}

@@ -8,7 +8,7 @@
  * - Domain and Application layers depend on this interface
  * - Infrastructure layer provides concrete implementations
  */
-import type { VersionInfo } from '../../../domain/value-objects/version-info.js';
+import type { VersionInfo } from '../../../../domain/value-objects/version-info.js';
 /**
  * Port interface for reading version information.
  *

package/dist/src/application/ports/output/services/version-service.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-service.interface.d.ts","sourceRoot":"","sources":["../../../../../../src/application/ports/output/services/version-service.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kDAAkD,CAAC;AAEpF;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,UAAU,IAAI,WAAW,CAAC;CAC3B"}

package/dist/src/application/ports/output/services/web-server-service.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-server-service.interface.d.ts","sourceRoot":"","sources":["../../../../../../src/application/ports/output/services/web-server-service.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/D;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB"}

package/dist/src/application/ports/output/services/worktree-service.interface.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Worktree Service Interface
+ *
+ * Output port for git worktree operations.
+ * Implementations manage git worktree creation, removal, and listing.
+ */
+/**
+ * Information about a git worktree.
+ */
+export interface WorktreeInfo {
+    /** Absolute path to the worktree directory */
+    path: string;
+    /** HEAD commit hash */
+    head: string;
+    /** Branch name (empty for detached HEAD) */
+    branch: string;
+    /** Whether this is the main worktree */
+    isMain: boolean;
+}
+/**
+ * Error codes for worktree operations.
+ */
+export declare enum WorktreeErrorCode {
+    ALREADY_EXISTS = "ALREADY_EXISTS",
+    BRANCH_IN_USE = "BRANCH_IN_USE",
+    NOT_FOUND = "NOT_FOUND",
+    DIRTY_WORKTREE = "DIRTY_WORKTREE",
+    GIT_ERROR = "GIT_ERROR"
+}
+/**
+ * Typed error for worktree operations.
+ */
+export declare class WorktreeError extends Error {
+    readonly code: WorktreeErrorCode;
+    readonly cause?: Error | undefined;
+    constructor(message: string, code: WorktreeErrorCode, cause?: Error | undefined);
+}
+/**
+ * Service interface for git worktree management.
+ */
+export interface IWorktreeService {
+    /**
+     * Create a new worktree with a new branch.
+     *
+     * @param repoPath - Path to the git repository
+     * @param branch - Branch name to create
+     * @param worktreePath - Path for the new worktree directory
+     * @returns Information about the created worktree
+     * @throws WorktreeError with appropriate code
+     */
+    create(repoPath: string, branch: string, worktreePath: string): Promise<WorktreeInfo>;
+    /**
+     * Remove an existing worktree.
+     *
+     * @param worktreePath - Path to the worktree to remove
+     * @throws WorktreeError if worktree not found or has uncommitted changes
+     */
+    remove(worktreePath: string): Promise<void>;
+    /**
+     * List all worktrees in a repository.
+     *
+     * @param repoPath - Path to the git repository
+     * @returns Array of worktree information
+     */
+    list(repoPath: string): Promise<WorktreeInfo[]>;
+    /**
+     * Check if a worktree for a branch already exists.
+     *
+     * @param repoPath - Path to the git repository
+     * @param branch - Branch name to check
+     * @returns True if a worktree for this branch exists
+     */
+    exists(repoPath: string, branch: string): Promise<boolean>;
+    /**
+     * Get the conventional worktree path for a branch.
+     *
+     * @param repoPath - Path to the git repository
+     * @param branch - Branch name
+     * @returns Computed worktree path (e.g., /repo/.worktrees/branch-name)
+     */
+    getWorktreePath(repoPath: string, branch: string): string;
+}
+//# sourceMappingURL=worktree-service.interface.d.ts.map

package/dist/src/application/ports/output/services/worktree-service.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-service.interface.d.ts","sourceRoot":"","sources":["../../../../../../src/application/ports/output/services/worktree-service.interface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,oBAAY,iBAAiB;IAC3B,cAAc,mBAAmB;IACjC,aAAa,kBAAkB;IAC/B,SAAS,cAAc;IACvB,cAAc,mBAAmB;IACjC,SAAS,cAAc;CACxB;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;aAGpB,IAAI,EAAE,iBAAiB;aACvB,KAAK,CAAC,EAAE,KAAK;gBAF7B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,iBAAiB,EACvB,KAAK,CAAC,EAAE,KAAK,YAAA;CAKhC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;OAQG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEtF;;;;;OAKG;IACH,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5C;;;;;OAKG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAEhD;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3D;;;;;;OAMG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3D"}

package/dist/src/application/ports/output/services/worktree-service.interface.js

@@ -0,0 +1,30 @@
+/**
+ * Worktree Service Interface
+ *
+ * Output port for git worktree operations.
+ * Implementations manage git worktree creation, removal, and listing.
+ */
+/**
+ * Error codes for worktree operations.
+ */
+export var WorktreeErrorCode;
+(function (WorktreeErrorCode) {
+    WorktreeErrorCode["ALREADY_EXISTS"] = "ALREADY_EXISTS";
+    WorktreeErrorCode["BRANCH_IN_USE"] = "BRANCH_IN_USE";
+    WorktreeErrorCode["NOT_FOUND"] = "NOT_FOUND";
+    WorktreeErrorCode["DIRTY_WORKTREE"] = "DIRTY_WORKTREE";
+    WorktreeErrorCode["GIT_ERROR"] = "GIT_ERROR";
+})(WorktreeErrorCode || (WorktreeErrorCode = {}));
+/**
+ * Typed error for worktree operations.
+ */
+export class WorktreeError extends Error {
+    code;
+    cause;
+    constructor(message, code, cause) {
+        super(message);
+        this.code = code;
+        this.cause = cause;
+        this.name = 'WorktreeError';
+    }
+}

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

@@ -0,0 +1,22 @@
+/**
+ * Approve Agent Run Use Case
+ *
+ * Approves a paused agent run (waiting_approval status) and
+ * spawns a new resume worker to continue graph execution.
+ */
+import type { IAgentRunRepository } from '../../ports/output/agents/agent-run-repository.interface.js';
+import type { IFeatureAgentProcessService } from '../../ports/output/agents/feature-agent-process.interface.js';
+import type { IFeatureRepository } from '../../ports/output/repositories/feature-repository.interface.js';
+import type { IWorktreeService } from '../../ports/output/services/worktree-service.interface.js';
+export declare class ApproveAgentRunUseCase {
+    private readonly agentRunRepository;
+    private readonly processService;
+    private readonly featureRepository;
+    private readonly worktreeService;
+    constructor(agentRunRepository: IAgentRunRepository, processService: IFeatureAgentProcessService, featureRepository: IFeatureRepository, worktreeService: IWorktreeService);
+    execute(id: string): Promise<{
+        approved: boolean;
+        reason: string;
+    }>;
+}
+//# sourceMappingURL=approve-agent-run.use-case.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"approve-agent-run.use-case.d.ts","sourceRoot":"","sources":["../../../../../src/application/use-cases/agents/approve-agent-run.use-case.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AACvG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8DAA8D,CAAC;AAChH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2DAA2D,CAAC;AAGlG,qBACa,sBAAsB;IAG/B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IAEnC,OAAO,CAAC,QAAQ,CAAC,cAAc;IAE/B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAElC,OAAO,CAAC,QAAQ,CAAC,eAAe;gBANf,kBAAkB,EAAE,mBAAmB,EAEvC,cAAc,EAAE,2BAA2B,EAE3C,iBAAiB,EAAE,kBAAkB,EAErC,eAAe,EAAE,gBAAgB;IAG9C,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAsC1E"}

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

@@ -0,0 +1,67 @@
+/**
+ * Approve Agent Run Use Case
+ *
+ * Approves a paused agent run (waiting_approval status) and
+ * spawns a new resume worker to continue graph execution.
+ */
+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 ApproveAgentRunUseCase = class ApproveAgentRunUseCase {
+    agentRunRepository;
+    processService;
+    featureRepository;
+    worktreeService;
+    constructor(agentRunRepository, processService, featureRepository, worktreeService) {
+        this.agentRunRepository = agentRunRepository;
+        this.processService = processService;
+        this.featureRepository = featureRepository;
+        this.worktreeService = worktreeService;
+    }
+    async execute(id) {
+        const run = await this.agentRunRepository.findById(id);
+        if (!run) {
+            return { approved: false, reason: 'Agent run not found' };
+        }
+        if (run.status !== AgentRunStatus.waitingApproval) {
+            return {
+                approved: false,
+                reason: `Agent run is not waiting for approval (status: ${run.status})`,
+            };
+        }
+        // Look up the feature to get the branch for worktree path derivation
+        const feature = run.featureId ? await this.featureRepository.findById(run.featureId) : null;
+        const repoPath = run.repositoryPath ?? '';
+        const worktreePath = feature
+            ? this.worktreeService.getWorktreePath(repoPath, feature.branch)
+            : repoPath;
+        const now = new Date();
+        await this.agentRunRepository.updateStatus(id, AgentRunStatus.running, {
+            approvalStatus: 'approved',
+            updatedAt: now,
+        });
+        this.processService.spawn(run.featureId ?? '', id, repoPath, worktreePath, // specDir = worktree path (same as initial spawn)
+        worktreePath, { resume: true, approvalMode: run.approvalMode });
+        return { approved: true, reason: 'Approved and resumed' };
+    }
+};
+ApproveAgentRunUseCase = __decorate([
+    injectable(),
+    __param(0, inject('IAgentRunRepository')),
+    __param(1, inject('IFeatureAgentProcessService')),
+    __param(2, inject('IFeatureRepository')),
+    __param(3, inject('IWorktreeService')),
+    __metadata("design:paramtypes", [Object, Object, Object, Object])
+], ApproveAgentRunUseCase);
+export { ApproveAgentRunUseCase };

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

@@ -11,8 +11,8 @@
  * - Returns updated settings after persistence
  */
 import type { Settings, AgentType, AgentAuthMethod } from '../../../domain/generated/output.js';
-import type { ISettingsRepository } from '../../ports/output/settings.repository.interface.js';
-import type { IAgentValidator } from '../../ports/output/agent-validator.interface.js';
+import type { ISettingsRepository } from '../../ports/output/repositories/settings.repository.interface.js';
+import type { IAgentValidator } from '../../ports/output/agents/agent-validator.interface.js';
 /**
  * Input for configuring an AI coding agent.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"configure-agent.use-case.d.ts","sourceRoot":"","sources":["../../../../../src/application/use-cases/agents/configure-agent.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAChG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAC;AAC/F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AAEvF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,EAAE,eAAe,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,qBACa,qBAAqB;IAG9B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IAEnC,OAAO,CAAC,QAAQ,CAAC,cAAc;gBAFd,kBAAkB,EAAE,mBAAmB,EAEvC,cAAc,EAAE,eAAe;IAGlD;;;;;;OAMG;IACG,OAAO,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC;CA+B7D"}
+{"version":3,"file":"configure-agent.use-case.d.ts","sourceRoot":"","sources":["../../../../../src/application/use-cases/agents/configure-agent.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAChG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kEAAkE,CAAC;AAC5G,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wDAAwD,CAAC;AAE9F;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,EAAE,eAAe,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,qBACa,qBAAqB;IAG9B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IAEnC,OAAO,CAAC,QAAQ,CAAC,cAAc;gBAFd,kBAAkB,EAAE,mBAAmB,EAEvC,cAAc,EAAE,eAAe;IAGlD;;;;;;OAMG;IACG,OAAO,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC;CA+B7D"}

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

@@ -0,0 +1,16 @@
+/**
+ * Delete Agent Run Use Case
+ *
+ * Removes an agent run record from the database.
+ * Refuses to delete running agents — stop them first.
+ */
+import type { IAgentRunRepository } from '../../ports/output/agents/agent-run-repository.interface.js';
+export declare class DeleteAgentRunUseCase {
+    private readonly agentRunRepository;
+    constructor(agentRunRepository: IAgentRunRepository);
+    execute(id: string): Promise<{
+        deleted: boolean;
+        reason: string;
+    }>;
+}
+//# sourceMappingURL=delete-agent-run.use-case.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delete-agent-run.use-case.d.ts","sourceRoot":"","sources":["../../../../../src/application/use-cases/agents/delete-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,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAgBzE"}

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

@@ -0,0 +1,46 @@
+/**
+ * Delete Agent Run Use Case
+ *
+ * Removes an agent run record from the database.
+ * Refuses to delete running agents — stop them first.
+ */
+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 DeleteAgentRunUseCase = class DeleteAgentRunUseCase {
+    agentRunRepository;
+    constructor(agentRunRepository) {
+        this.agentRunRepository = agentRunRepository;
+    }
+    async execute(id) {
+        const run = await this.agentRunRepository.findById(id);
+        if (!run) {
+            return { deleted: false, reason: 'Agent run not found' };
+        }
+        if (run.status === AgentRunStatus.running) {
+            return {
+                deleted: false,
+                reason: `Cannot delete a running agent. Stop it first with: shep agent stop ${id.substring(0, 8)}`,
+            };
+        }
+        await this.agentRunRepository.delete(id);
+        return { deleted: true, reason: 'Agent run deleted' };
+    }
+};
+DeleteAgentRunUseCase = __decorate([
+    injectable(),
+    __param(0, inject('IAgentRunRepository')),
+    __metadata("design:paramtypes", [Object])
+], DeleteAgentRunUseCase);
+export { DeleteAgentRunUseCase };