@shepai/cli 1.174.0 → 1.175.0

package/apis/json-schema/Repository.yaml

@@ -11,6 +11,12 @@ properties:
   remoteUrl:
     type: string
     description: "Remote GitHub URL this repository was cloned from (normalized: lowercase, no .git suffix)"
+  isFork:
+    type: boolean
+    description: Whether this repository was auto-forked by shep because the user lacked push access
+  upstreamUrl:
+    type: string
+    description: "Original upstream URL when isFork is true (normalized: lowercase, no .git suffix)"
 required:
   - name
   - path

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

@@ -12,12 +12,14 @@ export interface IRepositoryRepository {
     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>;
+    /** Find a non-deleted repository by its upstream URL (for fork deduplication). */
+    findByUpstreamUrl(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>;
+    update(id: string, fields: Partial<Pick<Repository, 'name' | 'path' | 'remoteUrl' | 'isFork' | 'upstreamUrl'>>): 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,+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"}
+{"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,kFAAkF;IAClF,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAC3D,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,GAAG,QAAQ,GAAG,aAAa,CAAC,CAAC,GAC1F,OAAO,CAAC,UAAU,CAAC,CAAC;CACxB"}

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

@@ -18,6 +18,8 @@ export declare enum GitPrErrorCode {
     MERGE_FAILED = "MERGE_FAILED",
     NETWORK_ERROR = "NETWORK_ERROR",
     PR_NOT_FOUND = "PR_NOT_FOUND",
+    REMOTE_ALREADY_EXISTS = "REMOTE_ALREADY_EXISTS",
+    REPO_CREATE_FAILED = "REPO_CREATE_FAILED",
     REBASE_CONFLICT = "REBASE_CONFLICT",
     SYNC_FAILED = "SYNC_FAILED"
 }
@@ -144,6 +146,32 @@ export interface IGitPrService {
      * @returns The remote URL, or null if no remote is configured
      */
     getRemoteUrl(cwd: string): Promise<string | null>;
+    /**
+     * Create a GitHub repository and link it to the local repo.
+     * Uses `gh repo create` with `--source=.` and `--push` to atomically
+     * create the remote repo, add the origin remote, and push the current branch.
+     *
+     * @param cwd - Working directory path
+     * @param name - Repository name (e.g. "my-repo" or "org/my-repo")
+     * @param options - Creation options
+     * @returns The URL of the created GitHub repository
+     * @throws GitPrError with REPO_CREATE_FAILED code on creation failure
+     * @throws GitPrError with GH_NOT_FOUND code if gh CLI is not installed
+     * @throws GitPrError with AUTH_FAILURE code if gh is not authenticated
+     */
+    createGitHubRepo(cwd: string, name: string, options: {
+        isPrivate: boolean;
+        org?: string;
+    }): Promise<string>;
+    /**
+     * Add a git remote to the local repository.
+     *
+     * @param cwd - Working directory path
+     * @param remoteName - Name for the remote (e.g. "origin")
+     * @param remoteUrl - URL of the remote repository
+     * @throws GitPrError with GIT_ERROR code on failure
+     */
+    addRemote(cwd: string, remoteName: string, remoteUrl: string): Promise<void>;
     /**
      * Detect the repository's default branch with robust fallback chain:
      * 1. Remote HEAD (git symbolic-ref refs/remotes/origin/HEAD)

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

@@ -1 +1 @@
-{"version":3,"file":"git-pr-service.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/git-pr-service.interface.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"git-pr-service.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/git-pr-service.interface.ts"],"names":[],"mappings":"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"}

package/dist/packages/core/src/application/ports/output/services/git-pr-service.interface.js

@@ -18,6 +18,8 @@ export var GitPrErrorCode;
     GitPrErrorCode["MERGE_FAILED"] = "MERGE_FAILED";
     GitPrErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
     GitPrErrorCode["PR_NOT_FOUND"] = "PR_NOT_FOUND";
+    GitPrErrorCode["REMOTE_ALREADY_EXISTS"] = "REMOTE_ALREADY_EXISTS";
+    GitPrErrorCode["REPO_CREATE_FAILED"] = "REPO_CREATE_FAILED";
     GitPrErrorCode["REBASE_CONFLICT"] = "REBASE_CONFLICT";
     GitPrErrorCode["SYNC_FAILED"] = "SYNC_FAILED";
 })(GitPrErrorCode || (GitPrErrorCode = {}));

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

@@ -35,6 +35,12 @@ export declare class GitHubRepoListError extends Error {
 export declare class GitHubPermissionError extends Error {
     constructor(message: string, cause?: Error);
 }
+/**
+ * Thrown when a fork operation fails.
+ */
+export declare class GitHubForkError extends Error {
+    constructor(message: string, cause?: Error);
+}
 /**
  * A GitHub repository as returned by `gh repo list --json`.
  */
@@ -88,6 +94,26 @@ export interface ParsedGitHubUrl {
     /** Combined owner/repo (e.g. "octocat/my-project") */
     nameWithOwner: string;
 }
+/**
+ * Options for forking a repository.
+ */
+export interface ForkOptions {
+    onProgress?: (message: string) => void;
+}
+/**
+ * Result of checking push access on a repository.
+ */
+export interface PushAccessResult {
+    hasPushAccess: boolean;
+    viewerLogin: string;
+}
+/**
+ * Result of forking a repository.
+ */
+export interface ForkResult {
+    nameWithOwner: string;
+    alreadyExisted: boolean;
+}
 /**
  * Output port for GitHub repository operations.
  *
@@ -151,5 +177,26 @@ export interface IGitHubRepositoryService {
      * @throws {GitHubPermissionError} if the permission check fails (e.g. gh not installed, not authenticated)
      */
     getViewerPermission(repoPath: string): Promise<string>;
+    /**
+     * Get the authenticated GitHub user's login.
+     * @returns The login username
+     * @throws {GitHubAuthError} if not authenticated
+     */
+    getAuthenticatedUser(): Promise<string>;
+    /**
+     * Check if the authenticated user has push access to a repository.
+     * @param nameWithOwner - Full owner/repo identifier
+     * @returns Push access result with viewer login
+     * @throws {GitHubPermissionError} on failure
+     */
+    checkPushAccess(nameWithOwner: string): Promise<PushAccessResult>;
+    /**
+     * Fork a repository to the authenticated user's account.
+     * @param nameWithOwner - Full owner/repo identifier to fork
+     * @param options - Optional progress callback
+     * @returns Fork result with the fork's nameWithOwner
+     * @throws {GitHubForkError} on failure
+     */
+    forkRepository(nameWithOwner: string, options?: ForkOptions): Promise<ForkResult>;
 }
 //# sourceMappingURL=github-repository-service.interface.d.ts.map

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

@@ -1 +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;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,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;IAChB,+FAA+F;IAC/F,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;CACrB;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;;;;;;;;OAQG;IACH,oBAAoB,CAAC,OAAO,CAAC,EAAE,2BAA2B,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAEnF;;;;;OAKG;IACH,iBAAiB,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAEnD;;;;;;;;;;;;OAYG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAAC;IAE7C;;;;;;;;;OASG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACxD"}
+{"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":"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"}

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

@@ -68,3 +68,15 @@ export class GitHubPermissionError extends Error {
             this.cause = cause;
     }
 }
+/**
+ * Thrown when a fork operation fails.
+ */
+export class GitHubForkError extends Error {
+    constructor(message, cause) {
+        super(message);
+        this.name = 'GitHubForkError';
+        Object.setPrototypeOf(this, new.target.prototype);
+        if (cause)
+            this.cause = cause;
+    }
+}

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

@@ -0,0 +1,67 @@
+/**
+ * Create Feature From Remote Use Case
+ *
+ * Composite use case that chains ImportGitHubRepositoryUseCase with
+ * CreateFeatureUseCase. Enables creating a feature on a remote GitHub
+ * repo in a single command — clone (or fork), register, then create feature.
+ *
+ * Provides two execution modes:
+ * - execute(): synchronous full flow for CLI
+ * - createRecord() + initializeAndSpawn(): two-phase for Web UI (fast response + background work)
+ */
+import type { Feature } from '../../../../domain/generated/output.js';
+import type { ApprovalGates, Attachment } from '../../../../domain/generated/output.js';
+import type { CloneOptions, ForkOptions } from '../../../ports/output/services/github-repository-service.interface.js';
+import { ImportGitHubRepositoryUseCase } from '../../repositories/import-github-repository.use-case.js';
+import { CreateFeatureUseCase } from './create-feature.use-case.js';
+import type { CreateFeatureResult, CreateRecordResult } from './types.js';
+export interface CreateFeatureFromRemoteInput {
+    /** GitHub URL or owner/repo shorthand */
+    remoteUrl: string;
+    /** Override clone destination directory */
+    cloneDest?: string;
+    /** Default base directory for clones (from settings) */
+    defaultCloneDir?: string;
+    /** Options for the clone subprocess */
+    cloneOptions?: CloneOptions;
+    /** Options for fork operations */
+    forkOptions?: ForkOptions;
+    userInput: string;
+    approvalGates?: ApprovalGates;
+    push?: boolean;
+    openPr?: boolean;
+    parentId?: string;
+    name?: string;
+    description?: string;
+    fast?: boolean;
+    pending?: boolean;
+    agentType?: string;
+    model?: string;
+    attachments?: Attachment[];
+    sessionId?: string;
+    attachmentPaths?: string[];
+}
+export declare class CreateFeatureFromRemoteUseCase {
+    private readonly importUseCase;
+    private readonly createFeatureUseCase;
+    constructor(importUseCase: ImportGitHubRepositoryUseCase, createFeatureUseCase: CreateFeatureUseCase);
+    /**
+     * Full synchronous execution: import repo then create feature.
+     * Used by the CLI which shows a spinner and needs everything done before returning.
+     */
+    execute(input: CreateFeatureFromRemoteInput): Promise<CreateFeatureResult>;
+    /**
+     * Phase 1 (fast): import repo + create DB record. Returns immediately with real feature ID.
+     * Used by the Web UI for optimistic display.
+     */
+    createRecord(input: CreateFeatureFromRemoteInput): Promise<CreateRecordResult>;
+    /**
+     * Phase 2 (background): metadata generation, worktree, spec, agent spawn.
+     * Fire-and-forget from the Web UI.
+     */
+    initializeAndSpawn(feature: Feature, input: CreateFeatureFromRemoteInput, shouldSpawn: boolean): Promise<{
+        warning?: string;
+        updatedFeature: Feature;
+    }>;
+}
+//# sourceMappingURL=create-feature-from-remote.use-case.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-feature-from-remote.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/use-cases/features/create/create-feature-from-remote.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AACxF,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACZ,MAAM,uEAAuE,CAAC;AAC/E,OAAO,EAAE,6BAA6B,EAAE,MAAM,yDAAyD,CAAC;AACxG,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE1E,MAAM,WAAW,4BAA4B;IAC3C,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uCAAuC;IACvC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,kCAAkC;IAClC,WAAW,CAAC,EAAE,WAAW,CAAC;IAG1B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,qBACa,8BAA8B;IAGvC,OAAO,CAAC,QAAQ,CAAC,aAAa;IAE9B,OAAO,CAAC,QAAQ,CAAC,oBAAoB;gBAFpB,aAAa,EAAE,6BAA6B,EAE5C,oBAAoB,EAAE,oBAAoB;IAG7D;;;OAGG;IACG,OAAO,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA4BhF;;;OAGG;IACG,YAAY,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA4BpF;;;OAGG;IACG,kBAAkB,CACtB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,4BAA4B,EACnC,WAAW,EAAE,OAAO,GACnB,OAAO,CAAC;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,OAAO,CAAA;KAAE,CAAC;CA0B1D"}

package/dist/packages/core/src/application/use-cases/features/create/create-feature-from-remote.use-case.js

@@ -0,0 +1,128 @@
+/**
+ * Create Feature From Remote Use Case
+ *
+ * Composite use case that chains ImportGitHubRepositoryUseCase with
+ * CreateFeatureUseCase. Enables creating a feature on a remote GitHub
+ * repo in a single command — clone (or fork), register, then create feature.
+ *
+ * Provides two execution modes:
+ * - execute(): synchronous full flow for CLI
+ * - createRecord() + initializeAndSpawn(): two-phase for Web UI (fast response + background work)
+ */
+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 { ImportGitHubRepositoryUseCase } from '../../repositories/import-github-repository.use-case.js';
+import { CreateFeatureUseCase } from './create-feature.use-case.js';
+let CreateFeatureFromRemoteUseCase = class CreateFeatureFromRemoteUseCase {
+    importUseCase;
+    createFeatureUseCase;
+    constructor(importUseCase, createFeatureUseCase) {
+        this.importUseCase = importUseCase;
+        this.createFeatureUseCase = createFeatureUseCase;
+    }
+    /**
+     * Full synchronous execution: import repo then create feature.
+     * Used by the CLI which shows a spinner and needs everything done before returning.
+     */
+    async execute(input) {
+        const repository = await this.importUseCase.execute({
+            url: input.remoteUrl,
+            dest: input.cloneDest,
+            defaultCloneDir: input.defaultCloneDir,
+            cloneOptions: input.cloneOptions,
+            forkOptions: input.forkOptions,
+        });
+        return this.createFeatureUseCase.execute({
+            userInput: input.userInput,
+            repositoryPath: repository.path,
+            approvalGates: input.approvalGates,
+            push: input.push,
+            openPr: input.openPr,
+            parentId: input.parentId,
+            name: input.name,
+            description: input.description,
+            fast: input.fast,
+            pending: input.pending,
+            agentType: input.agentType,
+            model: input.model,
+            attachments: input.attachments,
+            sessionId: input.sessionId,
+            attachmentPaths: input.attachmentPaths,
+        });
+    }
+    /**
+     * Phase 1 (fast): import repo + create DB record. Returns immediately with real feature ID.
+     * Used by the Web UI for optimistic display.
+     */
+    async createRecord(input) {
+        const repository = await this.importUseCase.execute({
+            url: input.remoteUrl,
+            dest: input.cloneDest,
+            defaultCloneDir: input.defaultCloneDir,
+            cloneOptions: input.cloneOptions,
+            forkOptions: input.forkOptions,
+        });
+        return this.createFeatureUseCase.createRecord({
+            userInput: input.userInput,
+            repositoryPath: repository.path,
+            approvalGates: input.approvalGates,
+            push: input.push,
+            openPr: input.openPr,
+            parentId: input.parentId,
+            name: input.name,
+            description: input.description,
+            fast: input.fast,
+            pending: input.pending,
+            agentType: input.agentType,
+            model: input.model,
+            attachments: input.attachments,
+            sessionId: input.sessionId,
+            attachmentPaths: input.attachmentPaths,
+        });
+    }
+    /**
+     * Phase 2 (background): metadata generation, worktree, spec, agent spawn.
+     * Fire-and-forget from the Web UI.
+     */
+    async initializeAndSpawn(feature, input, shouldSpawn) {
+        return this.createFeatureUseCase.initializeAndSpawn(feature, {
+            userInput: input.userInput,
+            // CreateFeatureUseCase.initializeAndSpawn reads the effective repo path
+            // from feature.repositoryPath, but the interface still requires this
+            // field. Pass the feature's repositoryPath for consistency.
+            repositoryPath: feature.repositoryPath,
+            approvalGates: input.approvalGates,
+            push: input.push,
+            openPr: input.openPr,
+            parentId: input.parentId,
+            name: input.name,
+            description: input.description,
+            fast: input.fast,
+            pending: input.pending,
+            agentType: input.agentType,
+            model: input.model,
+            attachments: input.attachments,
+            sessionId: input.sessionId,
+            attachmentPaths: input.attachmentPaths,
+        }, shouldSpawn);
+    }
+};
+CreateFeatureFromRemoteUseCase = __decorate([
+    injectable(),
+    __param(0, inject(ImportGitHubRepositoryUseCase)),
+    __param(1, inject(CreateFeatureUseCase)),
+    __metadata("design:paramtypes", [ImportGitHubRepositoryUseCase,
+        CreateFeatureUseCase])
+], CreateFeatureFromRemoteUseCase);
+export { CreateFeatureFromRemoteUseCase };

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

@@ -2,12 +2,12 @@
  * 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.
+ * detects duplicates by remoteUrl/upstreamUrl, checks push access, and either
+ * clones directly or auto-forks when the user lacks push access.
  */
 import type { Repository } from '../../../domain/generated/output.js';
-import type { IGitHubRepositoryService, CloneOptions } from '../../ports/output/services/github-repository-service.interface.js';
+import type { IGitHubRepositoryService, CloneOptions, ForkOptions } from '../../ports/output/services/github-repository-service.interface.js';
+import type { IGitPrService } from '../../ports/output/services/git-pr-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 {
@@ -19,13 +19,24 @@ export interface ImportGitHubRepositoryInput {
     defaultCloneDir?: string;
     /** Options for the clone subprocess (e.g. progress callback) */
     cloneOptions?: CloneOptions;
+    /** Options for fork operations (e.g. progress callback) */
+    forkOptions?: ForkOptions;
 }
 export declare class ImportGitHubRepositoryUseCase {
     private readonly gitHubService;
     private readonly repositoryRepo;
     private readonly addRepositoryUseCase;
-    constructor(gitHubService: IGitHubRepositoryService, repositoryRepo: IRepositoryRepository, addRepositoryUseCase: AddRepositoryUseCase);
+    private readonly gitPrService;
+    constructor(gitHubService: IGitHubRepositoryService, repositoryRepo: IRepositoryRepository, addRepositoryUseCase: AddRepositoryUseCase, gitPrService: IGitPrService);
     execute(input: ImportGitHubRepositoryInput): Promise<Repository>;
+    /**
+     * Direct clone path — user has push access to the repository.
+     */
+    private cloneDirect;
+    /**
+     * Fork-and-clone path — user lacks push access, so we auto-fork first.
+     */
+    private forkAndClone;
     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

@@ -1 +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"}
+{"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;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,KAAK,EACV,wBAAwB,EACxB,YAAY,EACZ,WAAW,EACZ,MAAM,oEAAoE,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yDAAyD,CAAC;AAC7F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oEAAoE,CAAC;AAChH,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAKpE,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;IAC5B,2DAA2D;IAC3D,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAUD,qBACa,6BAA6B;IAGtC,OAAO,CAAC,QAAQ,CAAC,aAAa;IAE9B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAE/B,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IAErC,OAAO,CAAC,QAAQ,CAAC,YAAY;gBANZ,aAAa,EAAE,wBAAwB,EAEvC,cAAc,EAAE,qBAAqB,EAErC,oBAAoB,EAAE,oBAAoB,EAE1C,YAAY,EAAE,aAAa;IAGxC,OAAO,CAAC,KAAK,EAAE,2BAA2B,GAAG,OAAO,CAAC,UAAU,CAAC;IAgCtE;;OAEG;YACW,WAAW;IAsBzB;;OAEG;YACW,YAAY;IAqD1B,OAAO,CAAC,kBAAkB;CAW3B"}

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

@@ -2,9 +2,8 @@
  * 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.
+ * detects duplicates by remoteUrl/upstreamUrl, checks push access, and either
+ * clones directly or auto-forks when the user lacks push access.
  */
 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;
@@ -22,6 +21,8 @@ import { injectable, inject } from 'tsyringe';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
 import { AddRepositoryUseCase } from './add-repository.use-case.js';
+/** Name of the git remote used to track the original upstream repo of a fork. */
+const UPSTREAM_REMOTE_NAME = 'upstream';
 /**
  * Normalizes a GitHub remote URL for storage and duplicate detection.
  * Lowercases and strips trailing .git suffix.
@@ -33,10 +34,12 @@ let ImportGitHubRepositoryUseCase = class ImportGitHubRepositoryUseCase {
     gitHubService;
     repositoryRepo;
     addRepositoryUseCase;
-    constructor(gitHubService, repositoryRepo, addRepositoryUseCase) {
+    gitPrService;
+    constructor(gitHubService, repositoryRepo, addRepositoryUseCase, gitPrService) {
         this.gitHubService = gitHubService;
         this.repositoryRepo = repositoryRepo;
         this.addRepositoryUseCase = addRepositoryUseCase;
+        this.gitPrService = gitPrService;
     }
     async execute(input) {
         // 1. Validate URL — throws GitHubUrlParseError for invalid formats
@@ -48,32 +51,81 @@ let ImportGitHubRepositoryUseCase = class ImportGitHubRepositoryUseCase {
         if (existing) {
             return existing;
         }
+        // 3b. Check for duplicate by upstreamUrl (fork of this repo already imported)
+        const existingFork = await this.repositoryRepo.findByUpstreamUrl(normalizedUrl);
+        if (existingFork) {
+            return existingFork;
+        }
         // 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
+        // 5. Check push access to determine if we need to fork
+        const { hasPushAccess } = await this.gitHubService.checkPushAccess(parsed.nameWithOwner);
+        if (hasPushAccess) {
+            return this.cloneDirect(input, parsed.nameWithOwner, parsed.repo, normalizedUrl);
+        }
+        return this.forkAndClone(input, parsed.nameWithOwner, parsed.repo, normalizedUrl);
+    }
+    /**
+     * Direct clone path — user has push access to the repository.
+     */
+    async cloneDirect(input, nameWithOwner, repoName, normalizedUrl) {
+        const destination = this.resolveDestination(input, repoName);
+        await this.gitHubService.cloneRepository(nameWithOwner, destination, input.cloneOptions);
         const repository = await this.addRepositoryUseCase.execute({
             path: destination,
-            name: parsed.repo,
+            name: repoName,
         });
-        // 8. Update with normalized remoteUrl
         await this.repositoryRepo.update(repository.id, {
             remoteUrl: normalizedUrl,
         });
         return { ...repository, remoteUrl: normalizedUrl };
     }
+    /**
+     * Fork-and-clone path — user lacks push access, so we auto-fork first.
+     */
+    async forkAndClone(input, originalNameWithOwner, repoName, normalizedOriginalUrl) {
+        // Fork the repository
+        const forkResult = await this.gitHubService.forkRepository(originalNameWithOwner, input.forkOptions);
+        // Check if fork was already tracked
+        const normalizedForkUrl = normalizeRemoteUrl(forkResult.nameWithOwner);
+        const existingForkByRemote = await this.repositoryRepo.findByRemoteUrl(normalizedForkUrl);
+        if (existingForkByRemote) {
+            return existingForkByRemote;
+        }
+        // Clone the fork
+        const destination = this.resolveDestination(input, repoName);
+        await this.gitHubService.cloneRepository(forkResult.nameWithOwner, destination, input.cloneOptions);
+        // Configure the upstream remote so users can `git fetch upstream` / sync
+        // with the original repo. Without this, the fork has no knowledge of its
+        // upstream — breaking PR workflows that rely on upstream as the merge base.
+        await this.gitPrService.addRemote(destination, UPSTREAM_REMOTE_NAME, normalizedOriginalUrl);
+        // Register the cloned fork
+        const repository = await this.addRepositoryUseCase.execute({
+            path: destination,
+            name: repoName,
+        });
+        // Update with fork metadata
+        await this.repositoryRepo.update(repository.id, {
+            remoteUrl: normalizedForkUrl,
+            isFork: true,
+            upstreamUrl: normalizedOriginalUrl,
+        });
+        return {
+            ...repository,
+            remoteUrl: normalizedForkUrl,
+            isFork: true,
+            upstreamUrl: normalizedOriginalUrl,
+        };
+    }
     resolveDestination(input, repoName) {
         if (input.dest) {
-            return input.dest;
+            return normalizePath(input.dest);
         }
         let baseDir = input.defaultCloneDir ?? join(homedir(), 'repos');
         if (baseDir.startsWith('~/')) {
             baseDir = join(homedir(), baseDir.slice(2));
         }
-        return join(baseDir, repoName);
+        return normalizePath(join(baseDir, repoName));
     }
 };
 ImportGitHubRepositoryUseCase = __decorate([
@@ -81,6 +133,16 @@ ImportGitHubRepositoryUseCase = __decorate([
     __param(0, inject('IGitHubRepositoryService')),
     __param(1, inject('IRepositoryRepository')),
     __param(2, inject(AddRepositoryUseCase)),
-    __metadata("design:paramtypes", [Object, Object, AddRepositoryUseCase])
+    __param(3, inject('IGitPrService')),
+    __metadata("design:paramtypes", [Object, Object, AddRepositoryUseCase, Object])
 ], ImportGitHubRepositoryUseCase);
 export { ImportGitHubRepositoryUseCase };
+/**
+ * Normalizes a filesystem path to use forward slashes.
+ *
+ * Per packages/CLAUDE.md, all paths stored in the database MUST use forward
+ * slashes so that Windows and POSIX callers resolve/compare identically.
+ */
+function normalizePath(p) {
+    return p.replace(/\\/g, '/');
+}

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

@@ -0,0 +1,30 @@
+/**
+ * Init Remote Repository Use Case
+ *
+ * Orchestrates creating a GitHub repository from a local repo that has
+ * no remote yet. Uses `gh repo create` with `--source=.` to create the
+ * remote repo, configure the origin remote, and push the current branch.
+ */
+import { type IGitPrService } from '../../ports/output/services/git-pr-service.interface.js';
+export interface InitRemoteRepositoryInput {
+    /** Working directory of the local repository */
+    cwd: string;
+    /** Repository name (defaults to directory basename) */
+    name?: string;
+    /** Whether to create a private repository (default: true) */
+    isPrivate?: boolean;
+    /** GitHub organization to create the repo under */
+    org?: string;
+}
+export interface InitRemoteRepositoryResult {
+    /** URL of the created GitHub repository */
+    url: string;
+    /** Name used for the repository */
+    name: string;
+}
+export declare class InitRemoteRepositoryUseCase {
+    private readonly gitPrService;
+    constructor(gitPrService: IGitPrService);
+    execute(input: InitRemoteRepositoryInput): Promise<InitRemoteRepositoryResult>;
+}
+//# sourceMappingURL=init-remote-repository.use-case.d.ts.map