@shepai/cli 1.124.0-pr403.3ad79ff → 1.124.0-pr404.6e2ed37

package/dist/packages/core/src/infrastructure/persistence/sqlite/mappers/repository.mapper.d.ts

@@ -15,6 +15,7 @@ export interface RepositoryRow {
     id: string;
     name: string;
     path: string;
+    remote_url: string | null;
     created_at: number;
     updated_at: number;
     deleted_at: number | null;

package/dist/packages/core/src/infrastructure/persistence/sqlite/mappers/repository.mapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repository.mapper.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/persistence/sqlite/mappers/repository.mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,aAAa,CAa1D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,UAAU,CAS3D"}
+{"version":3,"file":"repository.mapper.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/persistence/sqlite/mappers/repository.mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,aAAa,CAc1D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,UAAU,CAU3D"}

package/dist/packages/core/src/infrastructure/persistence/sqlite/mappers/repository.mapper.js

@@ -15,6 +15,7 @@ export function toDatabase(repo) {
         id: repo.id,
         name: repo.name,
         path: repo.path,
+        remote_url: repo.remoteUrl ?? null,
         created_at: repo.createdAt instanceof Date ? repo.createdAt.getTime() : repo.createdAt,
         updated_at: repo.updatedAt instanceof Date ? repo.updatedAt.getTime() : repo.updatedAt,
         deleted_at: repo.deletedAt
@@ -32,6 +33,7 @@ export function fromDatabase(row) {
         id: row.id,
         name: row.name,
         path: row.path,
+        remoteUrl: row.remote_url ?? undefined,
         createdAt: new Date(row.created_at),
         updatedAt: new Date(row.updated_at),
         deletedAt: row.deleted_at ? new Date(row.deleted_at) : undefined,

package/dist/packages/core/src/infrastructure/persistence/sqlite/migrations/040-add-repository-remote-url.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Migration 040: Add remote_url column to repositories table.
+ *
+ * Adds a nullable TEXT column for storing the GitHub remote URL a repository
+ * was cloned from. Includes an index for efficient duplicate detection
+ * via findByRemoteUrl().
+ */
+import type { MigrationParams } from 'umzug';
+import type Database from 'better-sqlite3';
+export declare function up({ context: db }: MigrationParams<Database.Database>): Promise<void>;
+export declare function down({ context: db }: MigrationParams<Database.Database>): Promise<void>;
+//# sourceMappingURL=040-add-repository-remote-url.d.ts.map

package/dist/packages/core/src/infrastructure/persistence/sqlite/migrations/040-add-repository-remote-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"040-add-repository-remote-url.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/persistence/sqlite/migrations/040-add-repository-remote-url.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,wBAAsB,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAc3F;AAED,wBAAsB,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ7F"}

package/dist/packages/core/src/infrastructure/persistence/sqlite/migrations/040-add-repository-remote-url.js

@@ -0,0 +1,29 @@
+/**
+ * Migration 040: Add remote_url column to repositories table.
+ *
+ * Adds a nullable TEXT column for storing the GitHub remote URL a repository
+ * was cloned from. Includes an index for efficient duplicate detection
+ * via findByRemoteUrl().
+ */
+export async function up({ context: db }) {
+    const columns = db.pragma('table_info(repositories)');
+    const existing = new Set(columns.map((c) => c.name));
+    if (!existing.has('remote_url')) {
+        db.exec('ALTER TABLE repositories ADD COLUMN remote_url TEXT');
+    }
+    // Add index for efficient duplicate detection by remote URL
+    const indexes = db.pragma('index_list(repositories)');
+    const indexNames = new Set(indexes.map((i) => i.name));
+    if (!indexNames.has('idx_repositories_remote_url')) {
+        db.exec('CREATE INDEX idx_repositories_remote_url ON repositories(remote_url)');
+    }
+}
+export async function down({ context: db }) {
+    // SQLite does not support DROP COLUMN before 3.35.0; drop the index only.
+    // The column remains but is unused after rollback.
+    const indexes = db.pragma('index_list(repositories)');
+    const indexNames = new Set(indexes.map((i) => i.name));
+    if (indexNames.has('idx_repositories_remote_url')) {
+        db.exec('DROP INDEX idx_repositories_remote_url');
+    }
+}

package/dist/packages/core/src/infrastructure/repositories/sqlite-repository.repository.d.ts

@@ -15,7 +15,10 @@ export declare class SQLiteRepositoryRepository implements IRepositoryRepository
     list(): Promise<Repository[]>;
     remove(id: string): Promise<void>;
     findByPathIncludingDeleted(path: string): Promise<Repository | null>;
+    findByRemoteUrl(url: string): Promise<Repository | null>;
+    update(id: string, fields: Partial<Pick<Repository, 'name' | 'path' | 'remoteUrl'>>): Promise<Repository>;
     softDelete(id: string): Promise<void>;
     restore(id: string): Promise<void>;
+    static normalizeRemoteUrl(url: string): string;
 }
 //# sourceMappingURL=sqlite-repository.repository.d.ts.map

package/dist/packages/core/src/infrastructure/repositories/sqlite-repository.repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite-repository.repository.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/infrastructure/repositories/sqlite-repository.repository.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gFAAgF,CAAC;AAC5H,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAOnE,qBACa,0BAA2B,YAAW,qBAAqB;IAC1D,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAE5C,MAAM,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAYnD,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAMhD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAQpD,IAAI,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAQ7B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjC,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAMpE,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQrC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAOzC"}
+{"version":3,"file":"sqlite-repository.repository.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/infrastructure/repositories/sqlite-repository.repository.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gFAAgF,CAAC;AAC5H,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAOnE,qBACa,0BAA2B,YAAW,qBAAqB;IAC1D,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAE5C,MAAM,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAYnD,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAMhD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAQpD,IAAI,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAQ7B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjC,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAMpE,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IASxD,MAAM,CACV,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;IA+BhB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQrC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxC,MAAM,CAAC,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAG/C"}

package/dist/packages/core/src/infrastructure/repositories/sqlite-repository.repository.js

@@ -12,9 +12,10 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
+var SQLiteRepositoryRepository_1;
 import { injectable } from 'tsyringe';
 import { toDatabase, fromDatabase, } from '../persistence/sqlite/mappers/repository.mapper.js';
-let SQLiteRepositoryRepository = class SQLiteRepositoryRepository {
+let SQLiteRepositoryRepository = SQLiteRepositoryRepository_1 = class SQLiteRepositoryRepository {
     db;
     constructor(db) {
         this.db = db;
@@ -54,6 +55,38 @@ let SQLiteRepositoryRepository = class SQLiteRepositoryRepository {
         const row = stmt.get(path.replace(/\\/g, '/'));
         return row ? fromDatabase(row) : null;
     }
+    async findByRemoteUrl(url) {
+        const normalized = SQLiteRepositoryRepository_1.normalizeRemoteUrl(url);
+        const stmt = this.db.prepare('SELECT * FROM repositories WHERE remote_url = ? AND deleted_at IS NULL');
+        const row = stmt.get(normalized);
+        return row ? fromDatabase(row) : null;
+    }
+    async update(id, fields) {
+        const now = Date.now();
+        const setClauses = ['updated_at = ?'];
+        const values = [now];
+        if (fields.name !== undefined) {
+            setClauses.push('name = ?');
+            values.push(fields.name);
+        }
+        if (fields.path !== undefined) {
+            setClauses.push('path = ?');
+            values.push(fields.path);
+        }
+        if (fields.remoteUrl !== undefined) {
+            setClauses.push('remote_url = ?');
+            values.push(fields.remoteUrl);
+        }
+        values.push(id);
+        const stmt = this.db.prepare(`UPDATE repositories SET ${setClauses.join(', ')} WHERE id = ?`);
+        const result = stmt.run(...values);
+        if (result.changes === 0) {
+            throw new Error(`Repository not found: ${id}`);
+        }
+        const selectStmt = this.db.prepare('SELECT * FROM repositories WHERE id = ?');
+        const row = selectStmt.get(id);
+        return fromDatabase(row);
+    }
     async softDelete(id) {
         const now = Date.now();
         const stmt = this.db.prepare('UPDATE repositories SET deleted_at = ?, updated_at = ? WHERE id = ?');
@@ -64,8 +97,11 @@ let SQLiteRepositoryRepository = class SQLiteRepositoryRepository {
         const stmt = this.db.prepare('UPDATE repositories SET deleted_at = NULL, updated_at = ? WHERE id = ?');
         stmt.run(now, id);
     }
+    static normalizeRemoteUrl(url) {
+        return url.replace(/\.git$/, '').toLowerCase();
+    }
 };
-SQLiteRepositoryRepository = __decorate([
+SQLiteRepositoryRepository = SQLiteRepositoryRepository_1 = __decorate([
     injectable(),
     __metadata("design:paramtypes", [Object])
 ], SQLiteRepositoryRepository);

package/dist/packages/core/src/infrastructure/services/external/github-repository.service.d.ts

@@ -0,0 +1,18 @@
+/**
+ * GitHub Repository Service Implementation
+ *
+ * Implements IGitHubRepositoryService using the gh CLI for authentication
+ * checks, repository listing, cloning (with progress streaming), and URL parsing.
+ */
+import type { ExecFunction } from '../git/worktree.service.js';
+import type { IGitHubRepositoryService, GitHubRepo, ListUserRepositoriesOptions, CloneOptions, ParsedGitHubUrl } from '../../../application/ports/output/services/github-repository-service.interface.js';
+export declare class GitHubRepositoryService implements IGitHubRepositoryService {
+    private readonly execFile;
+    constructor(execFile: ExecFunction);
+    checkAuth(): Promise<void>;
+    listUserRepositories(options?: ListUserRepositoriesOptions): Promise<GitHubRepo[]>;
+    cloneRepository(nameWithOwner: string, destination: string, options?: CloneOptions): Promise<void>;
+    parseGitHubUrl(url: string): ParsedGitHubUrl;
+    private cleanupPartialClone;
+}
+//# sourceMappingURL=github-repository.service.d.ts.map

package/dist/packages/core/src/infrastructure/services/external/github-repository.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-repository.service.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/external/github-repository.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EACV,wBAAwB,EACxB,UAAU,EACV,2BAA2B,EAC3B,YAAY,EACZ,eAAe,EAChB,MAAM,mFAAmF,CAAC;AAwB3F,qBACa,uBAAwB,YAAW,wBAAwB;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,YAAY;IAErE,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAyB1B,oBAAoB,CAAC,OAAO,CAAC,EAAE,2BAA2B,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAsClF,eAAe,CACnB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,IAAI,CAAC;IAgDhB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe;YA2C9B,mBAAmB;CAOlC"}

package/dist/packages/core/src/infrastructure/services/external/github-repository.service.js

@@ -0,0 +1,171 @@
+/**
+ * GitHub Repository Service Implementation
+ *
+ * Implements IGitHubRepositoryService using the gh CLI for authentication
+ * checks, repository listing, cloning (with progress streaming), and URL parsing.
+ */
+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 { resolve, normalize } from 'node:path';
+import { rm } from 'node:fs/promises';
+import { spawn } from 'node:child_process';
+import { GitHubAuthError, GitHubCloneError, GitHubRepoListError, GitHubUrlParseError, } from '../../../application/ports/output/services/github-repository-service.interface.js';
+// ---------------------------------------------------------------------------
+// URL regex patterns
+// ---------------------------------------------------------------------------
+/** Matches https://github.com/owner/repo or https://github.com/owner/repo.git */
+const HTTPS_PATTERN = /^https:\/\/github\.com\/([^/]+)\/([^/.]+?)(?:\.git)?$/;
+/** Matches git@github.com:owner/repo.git */
+const SSH_PATTERN = /^git@github\.com:([^/]+)\/([^/.]+?)(?:\.git)?$/;
+/** Matches owner/repo shorthand (no slashes except the one separating owner/repo) */
+const SHORTHAND_PATTERN = /^([a-zA-Z0-9_.-]+)\/([a-zA-Z0-9_.-]+)$/;
+/** Default limit for listing repositories */
+const DEFAULT_LIST_LIMIT = 30;
+let GitHubRepositoryService = class GitHubRepositoryService {
+    execFile;
+    constructor(execFile) {
+        this.execFile = execFile;
+    }
+    async checkAuth() {
+        try {
+            // Use `gh auth token` instead of `gh auth status` because `gh auth status`
+            // exits non-zero when *any* configured account has a stale token, even if
+            // the active account is fully authenticated. `gh auth token` only checks the
+            // active account and exits 0 as long as it has a valid token.
+            await this.execFile('gh', ['auth', 'token']);
+        }
+        catch (error) {
+            const cause = error instanceof Error ? error : undefined;
+            const errnoCode = error?.code;
+            if (errnoCode === 'ENOENT') {
+                throw new GitHubAuthError('GitHub CLI (gh) is not installed. Install it from https://cli.github.com/', cause);
+            }
+            throw new GitHubAuthError('GitHub CLI is not authenticated. Run `gh auth login` to sign in.', cause);
+        }
+    }
+    async listUserRepositories(options) {
+        const limit = options?.limit ?? DEFAULT_LIST_LIMIT;
+        const args = [
+            'repo',
+            'list',
+            '--json',
+            'name,nameWithOwner,description,isPrivate,pushedAt',
+            '--limit',
+            String(limit),
+        ];
+        if (options?.search) {
+            // gh repo list does not have a --match flag; use jq to filter by name
+            const escaped = options.search.replace(/"/g, '\\"');
+            args.push('-q', `[.[] | select(.name | test("${escaped}"; "i"))]`);
+        }
+        try {
+            const { stdout } = await this.execFile('gh', args);
+            return JSON.parse(stdout);
+        }
+        catch (error) {
+            const cause = error instanceof Error ? error : undefined;
+            const errnoCode = error?.code;
+            if (errnoCode === 'ENOENT') {
+                throw new GitHubRepoListError('GitHub CLI (gh) is not installed. Install it from https://cli.github.com/', cause);
+            }
+            throw new GitHubRepoListError(`Failed to list GitHub repositories: ${cause?.message ?? String(error)}`, cause);
+        }
+    }
+    async cloneRepository(nameWithOwner, destination, options) {
+        // Validate destination path — reject path traversal
+        const resolved = resolve(destination);
+        const normalized = normalize(resolved);
+        if (normalized !== resolved || destination.includes('..')) {
+            throw new GitHubCloneError(`Invalid clone destination: path traversal detected in "${destination}"`);
+        }
+        return new Promise((resolvePromise, reject) => {
+            const child = spawn('gh', ['repo', 'clone', nameWithOwner, resolved], {
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            let stderrOutput = '';
+            child.stderr?.on('data', (chunk) => {
+                const data = chunk.toString();
+                stderrOutput += data;
+                options?.onProgress?.(data);
+            });
+            child.stdout?.on('data', (chunk) => {
+                const data = chunk.toString();
+                options?.onProgress?.(data);
+            });
+            child.on('error', async (error) => {
+                await this.cleanupPartialClone(resolved);
+                reject(new GitHubCloneError(`Failed to clone ${nameWithOwner}: ${error.message}`, error));
+            });
+            child.on('close', async (code) => {
+                if (code === 0) {
+                    resolvePromise();
+                }
+                else {
+                    await this.cleanupPartialClone(resolved);
+                    reject(new GitHubCloneError(`Clone of ${nameWithOwner} failed with exit code ${code}: ${stderrOutput.trim()}`));
+                }
+            });
+        });
+    }
+    parseGitHubUrl(url) {
+        const trimmed = url.trim();
+        if (!trimmed) {
+            throw new GitHubUrlParseError('URL cannot be empty');
+        }
+        // Try HTTPS format
+        const httpsMatch = trimmed.match(HTTPS_PATTERN);
+        if (httpsMatch) {
+            return {
+                owner: httpsMatch[1],
+                repo: httpsMatch[2],
+                nameWithOwner: `${httpsMatch[1]}/${httpsMatch[2]}`,
+            };
+        }
+        // Try SSH format
+        const sshMatch = trimmed.match(SSH_PATTERN);
+        if (sshMatch) {
+            return {
+                owner: sshMatch[1],
+                repo: sshMatch[2],
+                nameWithOwner: `${sshMatch[1]}/${sshMatch[2]}`,
+            };
+        }
+        // Try shorthand format (must be last — it's the loosest pattern)
+        const shorthandMatch = trimmed.match(SHORTHAND_PATTERN);
+        if (shorthandMatch) {
+            return {
+                owner: shorthandMatch[1],
+                repo: shorthandMatch[2],
+                nameWithOwner: `${shorthandMatch[1]}/${shorthandMatch[2]}`,
+            };
+        }
+        throw new GitHubUrlParseError(`Unrecognized GitHub URL format: "${trimmed}". ` +
+            'Supported formats: https://github.com/owner/repo, ' +
+            'git@github.com:owner/repo.git, or owner/repo shorthand.');
+    }
+    async cleanupPartialClone(destination) {
+        try {
+            await rm(destination, { recursive: true, force: true });
+        }
+        catch {
+            // Cleanup is best-effort
+        }
+    }
+};
+GitHubRepositoryService = __decorate([
+    injectable(),
+    __param(0, inject('ExecFunction')),
+    __metadata("design:paramtypes", [Function])
+], GitHubRepositoryService);
+export { GitHubRepositoryService };

package/dist/src/presentation/cli/commands/repo/add.command.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Repo Add Command
+ *
+ * Import a GitHub repository by URL or interactively browse user's repos.
+ *
+ * Usage:
+ *   shep repo add                       # Interactive wizard
+ *   shep repo add --url owner/repo      # Direct import by URL
+ *   shep repo add --url <url> --dest /path  # Override clone destination
+ */
+import { Command } from 'commander';
+export declare function createAddCommand(): Command;
+//# sourceMappingURL=add.command.d.ts.map

package/dist/src/presentation/cli/commands/repo/add.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/repo/add.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAcpC,wBAAgB,gBAAgB,IAAI,OAAO,CA0E1C"}

package/dist/src/presentation/cli/commands/repo/add.command.js

@@ -0,0 +1,82 @@
+/**
+ * Repo Add Command
+ *
+ * Import a GitHub repository by URL or interactively browse user's repos.
+ *
+ * Usage:
+ *   shep repo add                       # Interactive wizard
+ *   shep repo add --url owner/repo      # Direct import by URL
+ *   shep repo add --url <url> --dest /path  # Override clone destination
+ */
+import { Command } from 'commander';
+import { container } from '../../../../../packages/core/src/infrastructure/di/container.js';
+import { getSettings } from '../../../../../packages/core/src/infrastructure/services/settings.service.js';
+import { ImportGitHubRepositoryUseCase } from '../../../../../packages/core/src/application/use-cases/repositories/import-github-repository.use-case.js';
+import { ListGitHubRepositoriesUseCase } from '../../../../../packages/core/src/application/use-cases/repositories/list-github-repositories.use-case.js';
+import { GitHubAuthError, GitHubCloneError, GitHubUrlParseError, } from '../../../../../packages/core/src/application/ports/output/services/github-repository-service.interface.js';
+import { messages } from '../../ui/index.js';
+import { githubImportWizard } from '../../../tui/wizards/github-import.wizard.js';
+export function createAddCommand() {
+    return new Command('add')
+        .description('Import a GitHub repository (clone and register)')
+        .option('--url <url>', 'GitHub repository URL or owner/repo shorthand')
+        .option('--dest <path>', 'Override clone destination directory')
+        .action(async (options) => {
+        try {
+            const importUseCase = container.resolve(ImportGitHubRepositoryUseCase);
+            let url;
+            let dest = options.dest;
+            if (options.url) {
+                url = options.url;
+            }
+            else {
+                // Interactive wizard
+                const gitHubService = container.resolve('IGitHubRepositoryService');
+                const listUseCase = container.resolve(ListGitHubRepositoriesUseCase);
+                const wizardResult = await githubImportWizard(gitHubService, listUseCase);
+                url = wizardResult.url;
+                if (!dest && wizardResult.dest) {
+                    dest = wizardResult.dest;
+                }
+            }
+            // Read default clone directory from settings
+            const settings = getSettings();
+            const defaultCloneDir = settings.environment?.defaultCloneDirectory;
+            const repository = await importUseCase.execute({
+                url,
+                dest,
+                defaultCloneDir,
+            });
+            messages.success(`Repository imported: ${repository.name}`);
+            messages.info(`Path: ${repository.path}`);
+        }
+        catch (error) {
+            if (error instanceof GitHubAuthError) {
+                messages.error('GitHub CLI is not authenticated. Run `gh auth login` to sign in.');
+                process.exitCode = 1;
+                return;
+            }
+            if (error instanceof GitHubUrlParseError) {
+                messages.error(`Invalid GitHub URL: ${error.message}`);
+                messages.info('Supported formats: https://github.com/owner/repo, git@github.com:owner/repo.git, or owner/repo');
+                process.exitCode = 1;
+                return;
+            }
+            if (error instanceof GitHubCloneError) {
+                messages.error(`Clone failed: ${error.message}`);
+                process.exitCode = 1;
+                return;
+            }
+            // Handle Ctrl+C gracefully
+            if (error &&
+                typeof error === 'object' &&
+                'name' in error &&
+                error.name === 'ExitPromptError') {
+                return;
+            }
+            const err = error instanceof Error ? error : new Error(String(error));
+            messages.error('Failed to import repository', err);
+            process.exitCode = 1;
+        }
+    });
+}

package/dist/src/presentation/cli/commands/repo/index.d.ts

@@ -9,6 +9,7 @@
  * Subcommands:
  *   shep repo ls             List tracked repositories
  *   shep repo show <id>      Display details of a tracked repository
+ *   shep repo add             Import a GitHub repository
  */
 import { Command } from 'commander';
 /**

package/dist/src/presentation/cli/commands/repo/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/repo/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAO3C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/repo/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAQ3C"}

package/dist/src/presentation/cli/commands/repo/index.js

@@ -9,10 +9,12 @@
  * Subcommands:
  *   shep repo ls             List tracked repositories
  *   shep repo show <id>      Display details of a tracked repository
+ *   shep repo add             Import a GitHub repository
  */
 import { Command } from 'commander';
 import { createShowCommand } from './show.command.js';
 import { createLsCommand } from './ls.command.js';
+import { createAddCommand } from './add.command.js';
 /**
  * Create the repo command with all subcommands
  */
@@ -20,6 +22,7 @@ export function createRepoCommand() {
     const repo = new Command('repo')
         .description('Manage tracked repositories')
         .addCommand(createLsCommand())
-        .addCommand(createShowCommand());
+        .addCommand(createShowCommand())
+        .addCommand(createAddCommand());
     return repo;
 }

package/dist/src/presentation/tui/wizards/github-import.wizard.d.ts

@@ -0,0 +1,33 @@
+/**
+ * GitHub Import Wizard
+ *
+ * Interactive TUI wizard that guides users through importing a GitHub repository.
+ * Offers two paths: paste a GitHub URL or browse the user's repositories.
+ * Returns the selected URL/nameWithOwner and optional destination override.
+ */
+import type { IGitHubRepositoryService } from '../../../../packages/core/src/application/ports/output/services/github-repository-service.interface.js';
+import type { ListGitHubRepositoriesUseCase } from '../../../../packages/core/src/application/use-cases/repositories/list-github-repositories.use-case.js';
+/**
+ * Result returned by the GitHub import wizard.
+ */
+export interface GitHubImportWizardResult {
+    /** GitHub URL or owner/repo shorthand */
+    url: string;
+    /** Optional override for clone destination directory */
+    dest?: string;
+}
+/**
+ * Runs the interactive GitHub import wizard.
+ *
+ * Steps:
+ * 1. Choose import method (URL input or browse repos)
+ * 2a. If URL: prompt for URL, validate with parseGitHubUrl
+ * 2b. If browse: fetch repos via listUseCase, display select list
+ * 3. Optionally prompt for destination directory override
+ *
+ * @param gitHubService - Service for URL validation
+ * @param listUseCase - Use case for listing user repos
+ * @returns The selected import target and optional destination
+ */
+export declare function githubImportWizard(gitHubService: IGitHubRepositoryService, listUseCase: ListGitHubRepositoriesUseCase): Promise<GitHubImportWizardResult>;
+//# sourceMappingURL=github-import.wizard.d.ts.map

package/dist/src/presentation/tui/wizards/github-import.wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-import.wizard.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/tui/wizards/github-import.wizard.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EACV,wBAAwB,EAEzB,MAAM,4EAA4E,CAAC;AAEpF,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,2EAA2E,CAAC;AAG/H;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,yCAAyC;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAoBD;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CACtC,aAAa,EAAE,wBAAwB,EACvC,WAAW,EAAE,6BAA6B,GACzC,OAAO,CAAC,wBAAwB,CAAC,CAoCnC"}

package/dist/src/presentation/tui/wizards/github-import.wizard.js

@@ -0,0 +1,121 @@
+/**
+ * GitHub Import Wizard
+ *
+ * Interactive TUI wizard that guides users through importing a GitHub repository.
+ * Offers two paths: paste a GitHub URL or browse the user's repositories.
+ * Returns the selected URL/nameWithOwner and optional destination override.
+ */
+import { select, input } from '@inquirer/prompts';
+import { GitHubUrlParseError } from '../../../../packages/core/src/application/ports/output/services/github-repository-service.interface.js';
+import { shepTheme } from '../themes/shep.theme.js';
+/**
+ * Format a GitHub repo for display in the select list.
+ * Shows name, visibility badge, and truncated description.
+ */
+function formatRepoChoice(repo) {
+    const visibility = repo.isPrivate ? ' (private)' : '';
+    return {
+        name: `${repo.nameWithOwner}${visibility}`,
+        value: repo.nameWithOwner,
+        description: repo.description || undefined,
+    };
+}
+/**
+ * Runs the interactive GitHub import wizard.
+ *
+ * Steps:
+ * 1. Choose import method (URL input or browse repos)
+ * 2a. If URL: prompt for URL, validate with parseGitHubUrl
+ * 2b. If browse: fetch repos via listUseCase, display select list
+ * 3. Optionally prompt for destination directory override
+ *
+ * @param gitHubService - Service for URL validation
+ * @param listUseCase - Use case for listing user repos
+ * @returns The selected import target and optional destination
+ */
+export async function githubImportWizard(gitHubService, listUseCase) {
+    // Step 1: Choose import method
+    const method = await select({
+        message: 'How would you like to add a GitHub repository?',
+        choices: [
+            {
+                name: 'Paste a GitHub URL',
+                value: 'url',
+                description: 'Enter a GitHub repository URL or owner/repo shorthand',
+            },
+            {
+                name: 'Browse my repositories',
+                value: 'browse',
+                description: 'Search and select from your GitHub repositories',
+            },
+        ],
+        theme: shepTheme,
+    });
+    let url;
+    if (method === 'url') {
+        url = await promptForUrl(gitHubService);
+    }
+    else {
+        url = await promptForBrowse(listUseCase);
+    }
+    // Step 3: Optional destination override
+    const dest = await promptForDestination();
+    const result = { url };
+    if (dest) {
+        result.dest = dest;
+    }
+    return result;
+}
+/**
+ * Prompt the user for a GitHub URL and validate it.
+ * Re-prompts on invalid input until a valid URL is provided.
+ */
+async function promptForUrl(gitHubService) {
+    const url = await input({
+        message: 'Enter a GitHub repository URL or owner/repo',
+        validate: (value) => {
+            if (!value.trim()) {
+                return 'URL is required';
+            }
+            try {
+                gitHubService.parseGitHubUrl(value.trim());
+                return true;
+            }
+            catch (error) {
+                if (error instanceof GitHubUrlParseError) {
+                    return error.message;
+                }
+                return 'Invalid GitHub URL format. Use https://github.com/owner/repo or owner/repo';
+            }
+        },
+        theme: shepTheme,
+    });
+    return url.trim();
+}
+/**
+ * Prompt the user to browse and select from their GitHub repositories.
+ * Fetches repos via the list use case and displays them in a select prompt.
+ */
+async function promptForBrowse(listUseCase) {
+    const repos = await listUseCase.execute({ limit: 30 });
+    if (repos.length === 0) {
+        throw new Error('No repositories found. Make sure you have repositories on GitHub.');
+    }
+    const choices = repos.map(formatRepoChoice);
+    const selected = await select({
+        message: 'Select a repository to import',
+        choices,
+        theme: shepTheme,
+    });
+    return selected;
+}
+/**
+ * Optionally prompt for a custom clone destination directory.
+ */
+async function promptForDestination() {
+    const dest = await input({
+        message: 'Clone destination (leave empty for default)',
+        theme: shepTheme,
+    });
+    return dest.trim() || undefined;
+}