@shepai/cli 1.127.3 → 1.129.0

package/apis/json-schema/EnvironmentConfig.yaml

@@ -14,6 +14,9 @@ properties:
     $ref: TerminalType.yaml
     default: system
     description: Preferred terminal emulator
+  defaultCloneDirectory:
+    type: string
+    description: Default directory for cloning GitHub repositories (e.g. ~/repos)
 required:
   - defaultEditor
   - shellPreference

package/apis/json-schema/FeatureFlags.yaml

@@ -14,6 +14,10 @@ properties:
     type: boolean
     default: false
     description: Enable debug UI elements and verbose client-side logging
+  githubImport:
+    type: boolean
+    default: false
+    description: Enable GitHub repository import in the web UI
   adoptBranch:
     type: boolean
     default: false
@@ -22,5 +26,6 @@ required:
   - skills
   - envDeploy
   - debug
+  - githubImport
   - adoptBranch
 description: Feature flag toggles for runtime feature control

package/apis/json-schema/Repository.yaml

@@ -8,6 +8,9 @@ properties:
   path:
     type: string
     description: Absolute file system path to the repository root (unique)
+  remoteUrl:
+    type: string
+    description: "Remote GitHub URL this repository was cloned from (normalized: lowercase, no .git suffix)"
 required:
   - name
   - path

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

@@ -10,10 +10,14 @@ export interface IRepositoryRepository {
     findByPath(path: string): Promise<Repository | null>;
     /** Find by path including soft-deleted records (for re-activation). */
     findByPathIncludingDeleted(path: string): Promise<Repository | null>;
+    /** Find a non-deleted repository by its remote URL (normalized: lowercase, no .git suffix). */
+    findByRemoteUrl(url: string): Promise<Repository | null>;
     list(): Promise<Repository[]>;
     remove(id: string): Promise<void>;
     softDelete(id: string): Promise<void>;
     /** Restore a soft-deleted repository by clearing deletedAt. */
     restore(id: string): Promise<void>;
+    /** Update specific fields on an existing repository. */
+    update(id: string, fields: Partial<Pick<Repository, 'name' | 'path' | 'remoteUrl'>>): Promise<Repository>;
 }
 //# sourceMappingURL=repository-repository.interface.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"repository-repository.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/repositories/repository-repository.interface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AAEzE,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACpD,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACjD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACrD,uEAAuE;IACvE,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACrE,IAAI,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC9B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,+DAA+D;IAC/D,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC"}
+{"version":3,"file":"repository-repository.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/repositories/repository-repository.interface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AAEzE,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACpD,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACjD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACrD,uEAAuE;IACvE,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACrE,+FAA+F;IAC/F,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACzD,IAAI,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC9B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,+DAA+D;IAC/D,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,wDAAwD;IACxD,MAAM,CACJ,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC,CAAC,GAC/D,OAAO,CAAC,UAAU,CAAC,CAAC;CACxB"}

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

@@ -0,0 +1,118 @@
+/**
+ * GitHub Repository Service Interface
+ *
+ * Output port for GitHub repository operations via the gh CLI.
+ * Implementations manage authentication checks, repository cloning,
+ * user repository listing, and GitHub URL parsing.
+ */
+/**
+ * Thrown when the GitHub CLI is not authenticated.
+ */
+export declare class GitHubAuthError extends Error {
+    constructor(message: string, cause?: Error);
+}
+/**
+ * Thrown when a `gh repo clone` operation fails.
+ */
+export declare class GitHubCloneError extends Error {
+    constructor(message: string, cause?: Error);
+}
+/**
+ * Thrown when a GitHub URL cannot be parsed into owner/repo.
+ */
+export declare class GitHubUrlParseError extends Error {
+    constructor(message: string, cause?: Error);
+}
+/**
+ * Thrown when listing the user's GitHub repositories fails.
+ */
+export declare class GitHubRepoListError extends Error {
+    constructor(message: string, cause?: Error);
+}
+/**
+ * A GitHub repository as returned by `gh repo list --json`.
+ */
+export interface GitHubRepo {
+    /** Repository name (e.g. "my-project") */
+    name: string;
+    /** Full owner/repo identifier (e.g. "octocat/my-project") */
+    nameWithOwner: string;
+    /** Repository description (may be empty string) */
+    description: string;
+    /** Whether the repository is private */
+    isPrivate: boolean;
+    /** ISO 8601 timestamp of the most recent push */
+    pushedAt: string;
+}
+/**
+ * Options for listing user repositories.
+ */
+export interface ListUserRepositoriesOptions {
+    /** Maximum number of repos to return (default: 30) */
+    limit?: number;
+    /** Filter repos by name substring */
+    search?: string;
+}
+/**
+ * Options for cloning a repository.
+ */
+export interface CloneOptions {
+    /** Callback invoked with stderr chunks during clone for progress display */
+    onProgress?: (data: string) => void;
+}
+/**
+ * Result of parsing a GitHub URL.
+ */
+export interface ParsedGitHubUrl {
+    /** Repository owner (e.g. "octocat") */
+    owner: string;
+    /** Repository name (e.g. "my-project") */
+    repo: string;
+    /** Combined owner/repo (e.g. "octocat/my-project") */
+    nameWithOwner: string;
+}
+/**
+ * Output port for GitHub repository operations.
+ *
+ * Implementations use the `gh` CLI for all GitHub interactions.
+ */
+export interface IGitHubRepositoryService {
+    /**
+     * Verify that the GitHub CLI is authenticated.
+     *
+     * @throws {GitHubAuthError} if `gh auth status` indicates the user is not logged in
+     */
+    checkAuth(): Promise<void>;
+    /**
+     * Clone a GitHub repository to a local destination directory.
+     *
+     * @param nameWithOwner - Full owner/repo identifier (e.g. "octocat/my-project")
+     * @param destination - Absolute path to clone into
+     * @param options - Optional clone configuration (e.g. progress callback)
+     * @throws {GitHubCloneError} if the clone subprocess fails
+     */
+    cloneRepository(nameWithOwner: string, destination: string, options?: CloneOptions): Promise<void>;
+    /**
+     * List the authenticated user's GitHub repositories.
+     *
+     * @param options - Optional filtering and pagination
+     * @returns Array of GitHub repositories sorted by most recently pushed
+     * @throws {GitHubRepoListError} if the list operation fails
+     */
+    listUserRepositories(options?: ListUserRepositoriesOptions): Promise<GitHubRepo[]>;
+    /**
+     * Parse a GitHub URL or shorthand into its owner/repo components.
+     *
+     * Supported formats:
+     * - `https://github.com/owner/repo`
+     * - `https://github.com/owner/repo.git`
+     * - `git@github.com:owner/repo.git`
+     * - `owner/repo` (shorthand)
+     *
+     * @param url - The GitHub URL or shorthand to parse
+     * @returns Parsed owner, repo, and nameWithOwner
+     * @throws {GitHubUrlParseError} if the URL does not match any supported format
+     */
+    parseGitHubUrl(url: string): ParsedGitHubUrl;
+}
+//# sourceMappingURL=github-repository-service.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"github-repository-service.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/github-repository-service.interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAM3C;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAM3C;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAM3C;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAM3C;AAMD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,aAAa,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,SAAS,EAAE,OAAO,CAAC;IACnB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,aAAa,EAAE,MAAM,CAAC;CACvB;AAMD;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3B;;;;;;;OAOG;IACH,eAAe,CACb,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;OAMG;IACH,oBAAoB,CAAC,OAAO,CAAC,EAAE,2BAA2B,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAEnF;;;;;;;;;;;;OAYG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAAC;CAC9C"}

package/dist/packages/core/src/application/ports/output/services/github-repository-service.interface.js

@@ -0,0 +1,58 @@
+/**
+ * GitHub Repository Service Interface
+ *
+ * Output port for GitHub repository operations via the gh CLI.
+ * Implementations manage authentication checks, repository cloning,
+ * user repository listing, and GitHub URL parsing.
+ */
+// ---------------------------------------------------------------------------
+// Error classes
+// ---------------------------------------------------------------------------
+/**
+ * Thrown when the GitHub CLI is not authenticated.
+ */
+export class GitHubAuthError extends Error {
+    constructor(message, cause) {
+        super(message);
+        this.name = 'GitHubAuthError';
+        Object.setPrototypeOf(this, new.target.prototype);
+        if (cause)
+            this.cause = cause;
+    }
+}
+/**
+ * Thrown when a `gh repo clone` operation fails.
+ */
+export class GitHubCloneError extends Error {
+    constructor(message, cause) {
+        super(message);
+        this.name = 'GitHubCloneError';
+        Object.setPrototypeOf(this, new.target.prototype);
+        if (cause)
+            this.cause = cause;
+    }
+}
+/**
+ * Thrown when a GitHub URL cannot be parsed into owner/repo.
+ */
+export class GitHubUrlParseError extends Error {
+    constructor(message, cause) {
+        super(message);
+        this.name = 'GitHubUrlParseError';
+        Object.setPrototypeOf(this, new.target.prototype);
+        if (cause)
+            this.cause = cause;
+    }
+}
+/**
+ * Thrown when listing the user's GitHub repositories fails.
+ */
+export class GitHubRepoListError extends Error {
+    constructor(message, cause) {
+        super(message);
+        this.name = 'GitHubRepoListError';
+        Object.setPrototypeOf(this, new.target.prototype);
+        if (cause)
+            this.cause = cause;
+    }
+}

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

@@ -17,4 +17,6 @@ export { GitPrError, GitPrErrorCode } from './git-pr-service.interface.js';
 export type { IIdeLauncherService, LaunchIdeInput, LaunchIdeResult, LaunchIdeSuccess, LaunchIdeFailed, } from './ide-launcher-service.interface.js';
 export type { IDaemonService, DaemonState } from './daemon-service.interface.js';
 export type { IDeploymentService, DeploymentStatus } from './deployment-service.interface.js';
+export type { IGitHubRepositoryService, GitHubRepo, ListUserRepositoriesOptions, CloneOptions, ParsedGitHubUrl, } from './github-repository-service.interface.js';
+export { GitHubAuthError, GitHubCloneError, GitHubUrlParseError, GitHubRepoListError, } from './github-repository-service.interface.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/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;AACnF,YAAY,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,YAAY,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,YAAY,EACV,aAAa,EACb,QAAQ,EACR,cAAc,EACd,WAAW,EACX,aAAa,EACb,cAAc,GACf,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC3E,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjF,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/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;AACnF,YAAY,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,YAAY,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,YAAY,EACV,aAAa,EACb,QAAQ,EACR,cAAc,EACd,WAAW,EACX,aAAa,EACb,cAAc,GACf,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC3E,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjF,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC9F,YAAY,EACV,wBAAwB,EACxB,UAAU,EACV,2BAA2B,EAC3B,YAAY,EACZ,eAAe,GAChB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,0CAA0C,CAAC"}

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

@@ -6,3 +6,4 @@
 export { IssueFetcherError, IssueNotFoundError, IssueAuthenticationError, IssueServiceUnavailableError, } from './external-issue-fetcher.interface.js';
 export { WorktreeError, WorktreeErrorCode } from './worktree-service.interface.js';
 export { GitPrError, GitPrErrorCode } from './git-pr-service.interface.js';
+export { GitHubAuthError, GitHubCloneError, GitHubUrlParseError, GitHubRepoListError, } from './github-repository-service.interface.js';

package/dist/packages/core/src/application/use-cases/features/delete-feature.use-case.d.ts

@@ -21,6 +21,7 @@ import type { IGitPrService } from '../../ports/output/services/git-pr-service.i
 export interface DeleteFeatureOptions {
     cleanup?: boolean;
     cascadeDelete?: boolean;
+    closePr?: boolean;
 }
 export declare class DeleteFeatureUseCase {
     private readonly featureRepo;

package/dist/packages/core/src/application/use-cases/features/delete-feature.use-case.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delete-feature.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/features/delete-feature.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,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,aAAa,EAAE,MAAM,yDAAyD,CAAC;AAE7F,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,qBACa,oBAAoB;IAEC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC9B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAE5D,OAAO,CAAC,QAAQ,CAAC,cAAc;IACA,OAAO,CAAC,QAAQ,CAAC,OAAO;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY;gBALP,WAAW,EAAE,kBAAkB,EACjC,eAAe,EAAE,gBAAgB,EAE7D,cAAc,EAAE,2BAA2B,EACZ,OAAO,EAAE,mBAAmB,EAClC,YAAY,EAAE,aAAa;IAGjE,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IA8BlF,oGAAoG;YACtF,gBAAgB;IAW9B,0DAA0D;YAC5C,iBAAiB;IAQ/B,6DAA6D;YAC/C,yBAAyB;IAWvC,sDAAsD;YACxC,sBAAsB;IAYpC,6EAA6E;YAC/D,oBAAoB;CAsDnC"}
+{"version":3,"file":"delete-feature.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/features/delete-feature.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,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,aAAa,EAAE,MAAM,yDAAyD,CAAC;AAE7F,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBACa,oBAAoB;IAEC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC9B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAE5D,OAAO,CAAC,QAAQ,CAAC,cAAc;IACA,OAAO,CAAC,QAAQ,CAAC,OAAO;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY;gBALP,WAAW,EAAE,kBAAkB,EACjC,eAAe,EAAE,gBAAgB,EAE7D,cAAc,EAAE,2BAA2B,EACZ,OAAO,EAAE,mBAAmB,EAClC,YAAY,EAAE,aAAa;IAGjE,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IA8BlF,oGAAoG;YACtF,gBAAgB;IAW9B,0DAA0D;YAC5C,iBAAiB;IAQ/B,6DAA6D;YAC/C,yBAAyB;IAevC,sDAAsD;YACxC,sBAAsB;IAYpC,6EAA6E;YAC/D,oBAAoB;CA+EnC"}

package/dist/packages/core/src/application/use-cases/features/delete-feature.use-case.js

@@ -25,7 +25,7 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 import { injectable, inject } from 'tsyringe';
-import { AgentRunStatus, SdlcLifecycle } from '../../../domain/generated/output.js';
+import { AgentRunStatus, PrStatus, SdlcLifecycle } from '../../../domain/generated/output.js';
 let DeleteFeatureUseCase = class DeleteFeatureUseCase {
     featureRepo;
     worktreeService;
@@ -93,6 +93,10 @@ let DeleteFeatureUseCase = class DeleteFeatureUseCase {
         });
         // Soft-delete: sets deletedAt, hiding from normal queries
         await this.featureRepo.softDelete(feature.id);
+        // Sync the in-memory feature object so subsequent update() calls
+        // (e.g. PR status update in cleanup) don't overwrite deleted_at back to null.
+        feature.lifecycle = SdlcLifecycle.Deleting;
+        feature.deletedAt = new Date();
     }
     /** Recursively cleanup all children (depth-first). */
     async cascadeCleanupChildren(parentId, options) {
@@ -133,22 +137,49 @@ let DeleteFeatureUseCase = class DeleteFeatureUseCase {
         }
         const cleanup = options?.cleanup !== false;
         if (cleanup) {
-            // Delete local feature branch
-            try {
-                await this.gitPrService.deleteBranch(feature.repositoryPath, feature.branch);
-            }
-            catch {
-                // Branch might not exist
-            }
-            // Delete remote feature branch if it exists
-            try {
-                const remoteExists = await this.worktreeService.remoteBranchExists(feature.repositoryPath, feature.branch);
-                if (remoteExists) {
-                    await this.gitPrService.deleteBranch(feature.repositoryPath, feature.branch, true);
+            const shouldDeleteRemote = options?.closePr !== false;
+            // Delete local branch, and also remote if closePr is enabled.
+            // deleteBranch(cwd, branch, true) deletes local then remote in one call,
+            // so we must NOT delete local separately when also deleting remote.
+            if (shouldDeleteRemote) {
+                let remoteDeleted = false;
+                try {
+                    const remoteExists = await this.worktreeService.remoteBranchExists(feature.repositoryPath, feature.branch);
+                    if (remoteExists) {
+                        // Delete local + remote in one call (deleteBranch does local first, then remote)
+                        await this.gitPrService.deleteBranch(feature.repositoryPath, feature.branch, true);
+                        remoteDeleted = true;
+                    }
+                    else {
+                        // No remote branch — just delete local
+                        await this.gitPrService.deleteBranch(feature.repositoryPath, feature.branch);
+                    }
+                }
+                catch {
+                    // Branch cleanup is best-effort
+                }
+                // Update pr.status to Closed after remote branch deletion (GitHub auto-closes the PR)
+                if (remoteDeleted && feature.pr?.status === PrStatus.Open) {
+                    try {
+                        await this.featureRepo.update({
+                            ...feature,
+                            pr: { ...feature.pr, status: PrStatus.Closed },
+                            updatedAt: new Date(),
+                        });
+                    }
+                    catch {
+                        // PR status update is best-effort
+                    }
                 }
             }
-            catch {
-                // Remote branch cleanup is best-effort
+            else {
+                // closePr is false — only delete local branch, preserve remote (and the PR)
+                try {
+                    await this.gitPrService.deleteBranch(feature.repositoryPath, feature.branch);
+                }
+                catch {
+                    // Branch might not exist
+                }
             }
         }
     }

package/dist/packages/core/src/application/use-cases/repositories/import-github-repository.use-case.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Import GitHub Repository Use Case
+ *
+ * Orchestrates importing a GitHub repository: validates the URL, checks auth,
+ * detects duplicates by remoteUrl, clones via IGitHubRepositoryService,
+ * delegates local registration to AddRepositoryUseCase, and updates the
+ * repository record with the normalized remoteUrl.
+ */
+import type { Repository } from '../../../domain/generated/output.js';
+import type { IGitHubRepositoryService, CloneOptions } from '../../ports/output/services/github-repository-service.interface.js';
+import type { IRepositoryRepository } from '../../ports/output/repositories/repository-repository.interface.js';
+import { AddRepositoryUseCase } from './add-repository.use-case.js';
+export interface ImportGitHubRepositoryInput {
+    /** GitHub URL or shorthand (e.g. "owner/repo") */
+    url: string;
+    /** Override clone destination directory */
+    dest?: string;
+    /** Default base directory for clones (from settings) */
+    defaultCloneDir?: string;
+    /** Options for the clone subprocess (e.g. progress callback) */
+    cloneOptions?: CloneOptions;
+}
+export declare class ImportGitHubRepositoryUseCase {
+    private readonly gitHubService;
+    private readonly repositoryRepo;
+    private readonly addRepositoryUseCase;
+    constructor(gitHubService: IGitHubRepositoryService, repositoryRepo: IRepositoryRepository, addRepositoryUseCase: AddRepositoryUseCase);
+    execute(input: ImportGitHubRepositoryInput): Promise<Repository>;
+    private resolveDestination;
+}
+//# sourceMappingURL=import-github-repository.use-case.d.ts.map

package/dist/packages/core/src/application/use-cases/repositories/import-github-repository.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-github-repository.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/repositories/import-github-repository.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,KAAK,EACV,wBAAwB,EACxB,YAAY,EACb,MAAM,oEAAoE,CAAC;AAC5E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oEAAoE,CAAC;AAChH,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE,MAAM,WAAW,2BAA2B;IAC1C,kDAAkD;IAClD,GAAG,EAAE,MAAM,CAAC;IACZ,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gEAAgE;IAChE,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAUD,qBACa,6BAA6B;IAGtC,OAAO,CAAC,QAAQ,CAAC,aAAa;IAE9B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAE/B,OAAO,CAAC,QAAQ,CAAC,oBAAoB;gBAJpB,aAAa,EAAE,wBAAwB,EAEvC,cAAc,EAAE,qBAAqB,EAErC,oBAAoB,EAAE,oBAAoB;IAGvD,OAAO,CAAC,KAAK,EAAE,2BAA2B,GAAG,OAAO,CAAC,UAAU,CAAC;IAoCtE,OAAO,CAAC,kBAAkB;CAW3B"}

package/dist/packages/core/src/application/use-cases/repositories/import-github-repository.use-case.js

@@ -0,0 +1,86 @@
+/**
+ * Import GitHub Repository Use Case
+ *
+ * Orchestrates importing a GitHub repository: validates the URL, checks auth,
+ * detects duplicates by remoteUrl, clones via IGitHubRepositoryService,
+ * delegates local registration to AddRepositoryUseCase, and updates the
+ * repository record with the normalized remoteUrl.
+ */
+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 { homedir } from 'node:os';
+import { join } from 'node:path';
+import { AddRepositoryUseCase } from './add-repository.use-case.js';
+/**
+ * Normalizes a GitHub remote URL for storage and duplicate detection.
+ * Lowercases and strips trailing .git suffix.
+ */
+function normalizeRemoteUrl(nameWithOwner) {
+    return `https://github.com/${nameWithOwner.toLowerCase()}`;
+}
+let ImportGitHubRepositoryUseCase = class ImportGitHubRepositoryUseCase {
+    gitHubService;
+    repositoryRepo;
+    addRepositoryUseCase;
+    constructor(gitHubService, repositoryRepo, addRepositoryUseCase) {
+        this.gitHubService = gitHubService;
+        this.repositoryRepo = repositoryRepo;
+        this.addRepositoryUseCase = addRepositoryUseCase;
+    }
+    async execute(input) {
+        // 1. Validate URL — throws GitHubUrlParseError for invalid formats
+        const parsed = this.gitHubService.parseGitHubUrl(input.url);
+        // 2. Normalize the remote URL for storage and duplicate detection
+        const normalizedUrl = normalizeRemoteUrl(parsed.nameWithOwner);
+        // 3. Check for duplicate by remoteUrl — skip clone if already tracked
+        const existing = await this.repositoryRepo.findByRemoteUrl(normalizedUrl);
+        if (existing) {
+            return existing;
+        }
+        // 4. Check auth — throws GitHubAuthError if not authenticated
+        await this.gitHubService.checkAuth();
+        // 5. Resolve clone destination
+        const destination = this.resolveDestination(input, parsed.repo);
+        // 6. Clone the repository
+        await this.gitHubService.cloneRepository(parsed.nameWithOwner, destination, input.cloneOptions);
+        // 7. Register the cloned repo via AddRepositoryUseCase
+        const repository = await this.addRepositoryUseCase.execute({
+            path: destination,
+            name: parsed.repo,
+        });
+        // 8. Update with normalized remoteUrl
+        await this.repositoryRepo.update(repository.id, {
+            remoteUrl: normalizedUrl,
+        });
+        return { ...repository, remoteUrl: normalizedUrl };
+    }
+    resolveDestination(input, repoName) {
+        if (input.dest) {
+            return input.dest;
+        }
+        let baseDir = input.defaultCloneDir ?? join(homedir(), 'repos');
+        if (baseDir.startsWith('~/')) {
+            baseDir = join(homedir(), baseDir.slice(2));
+        }
+        return join(baseDir, repoName);
+    }
+};
+ImportGitHubRepositoryUseCase = __decorate([
+    injectable(),
+    __param(0, inject('IGitHubRepositoryService')),
+    __param(1, inject('IRepositoryRepository')),
+    __param(2, inject(AddRepositoryUseCase)),
+    __metadata("design:paramtypes", [Object, Object, AddRepositoryUseCase])
+], ImportGitHubRepositoryUseCase);
+export { ImportGitHubRepositoryUseCase };

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

@@ -0,0 +1,13 @@
+/**
+ * List GitHub Repositories Use Case
+ *
+ * Checks GitHub CLI auth, then fetches the authenticated user's repositories.
+ * Decouples presentation from the IGitHubRepositoryService infrastructure.
+ */
+import type { IGitHubRepositoryService, GitHubRepo, ListUserRepositoriesOptions } from '../../ports/output/services/github-repository-service.interface.js';
+export declare class ListGitHubRepositoriesUseCase {
+    private readonly gitHubService;
+    constructor(gitHubService: IGitHubRepositoryService);
+    execute(options?: ListUserRepositoriesOptions): Promise<GitHubRepo[]>;
+}
+//# sourceMappingURL=list-github-repositories.use-case.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-github-repositories.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/repositories/list-github-repositories.use-case.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,wBAAwB,EACxB,UAAU,EACV,2BAA2B,EAC5B,MAAM,oEAAoE,CAAC;AAE5E,qBACa,6BAA6B;IAGtC,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAAb,aAAa,EAAE,wBAAwB;IAGpD,OAAO,CAAC,OAAO,CAAC,EAAE,2BAA2B,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;CAI5E"}

package/dist/packages/core/src/application/use-cases/repositories/list-github-repositories.use-case.js

@@ -0,0 +1,35 @@
+/**
+ * List GitHub Repositories Use Case
+ *
+ * Checks GitHub CLI auth, then fetches the authenticated user's repositories.
+ * Decouples presentation from the IGitHubRepositoryService infrastructure.
+ */
+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 ListGitHubRepositoriesUseCase = class ListGitHubRepositoriesUseCase {
+    gitHubService;
+    constructor(gitHubService) {
+        this.gitHubService = gitHubService;
+    }
+    async execute(options) {
+        await this.gitHubService.checkAuth();
+        return this.gitHubService.listUserRepositories(options);
+    }
+};
+ListGitHubRepositoriesUseCase = __decorate([
+    injectable(),
+    __param(0, inject('IGitHubRepositoryService')),
+    __metadata("design:paramtypes", [Object])
+], ListGitHubRepositoriesUseCase);
+export { ListGitHubRepositoriesUseCase };

package/dist/packages/core/src/domain/factories/settings-defaults.factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings-defaults.factory.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/domain/factories/settings-defaults.factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,QAAQ,EAUT,MAAM,qBAAqB,CAAC;AA6C7B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,qBAAqB,IAAI,QAAQ,CAgFhD"}
+{"version":3,"file":"settings-defaults.factory.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/domain/factories/settings-defaults.factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,QAAQ,EAUT,MAAM,qBAAqB,CAAC;AA6C7B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,qBAAqB,IAAI,QAAQ,CAkFhD"}

package/dist/packages/core/src/domain/factories/settings-defaults.factory.js

@@ -78,6 +78,7 @@ export function createDefaultSettings() {
         defaultEditor: DEFAULT_EDITOR,
         shellPreference: DEFAULT_SHELL,
         terminalPreference: DEFAULT_TERMINAL,
+        defaultCloneDirectory: '~/repos',
     };
     const system = {
         autoUpdate: true,
@@ -122,6 +123,7 @@ export function createDefaultSettings() {
         skills: false,
         envDeploy: true,
         debug: false,
+        githubImport: false,
         adoptBranch: false,
     };
     return {

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

@@ -284,6 +284,10 @@ export type EnvironmentConfig = {
      * Preferred terminal emulator
      */
     terminalPreference: TerminalType;
+    /**
+     * Default directory for cloning GitHub repositories (e.g. ~/repos)
+     */
+    defaultCloneDirectory?: string;
 };
 /**
  * System configuration
@@ -530,6 +534,10 @@ export type FeatureFlags = {
      * Enable debug UI elements and verbose client-side logging
      */
     debug: boolean;
+    /**
+     * Enable GitHub repository import in the web UI
+     */
+    githubImport: boolean;
     /**
      * Enable adopt branch feature to import existing branches as tracked features
      */
@@ -1470,6 +1478,10 @@ export type Repository = SoftDeletableEntity & {
      * Absolute file system path to the repository root (unique)
      */
     path: string;
+    /**
+     * Remote GitHub URL this repository was cloned from (normalized: lowercase, no .git suffix)
+     */
+    remoteUrl?: string;
 };
 /**
  * Single installation suggestion for a tool