hub-launch 1.30.0 → 1.31.0

package/dist/commands/launch.d.ts

@@ -1,6 +1,7 @@
 import type { Command } from 'commander';
 import type { Config } from '../types/index.js';
 import type { LlmProviderType } from '../types/config.schema.js';
+import { type SandboxProfile } from '../utils/sandbox-profile.js';
 /**
  * Launch command - Trigger a launch job on hula-project server
  *
@@ -30,6 +31,12 @@ interface LaunchOptions {
     verbose?: boolean;
     test?: boolean;
     handoff?: string;
+    /** --issue: existing GitHub issue reference (number, #number, or URL). */
+    issue?: string;
+    /** --pr: existing pull request reference (number, #number, or URL). */
+    pr?: string;
+    /** --base: branch to cut the work branch from and open the PR into. */
+    base?: string;
     show?: string;
     logs?: string;
     lines?: number;
@@ -42,6 +49,8 @@ interface LaunchOptions {
     containerCpu?: number;
     containerMemory?: number;
     containerDisk?: number;
+    /** --sandbox-profile: base | android[:17|21]; overrides config.sandboxProfile. */
+    sandboxProfile?: string;
     updateNotificationUrl?: string;
     updateNotificationNameTag?: string;
     /** Parent folder containing sibling repos to fan out over. */
@@ -79,6 +88,19 @@ export declare function validateKillFlags(options: LaunchOptions): string | null
  * `--kill` needs only the tracking name; every other mode needs a plan.
  */
 export declare function requiresPlanPath(options: LaunchOptions): boolean;
+/**
+ * Validate the `--issue` / `--pr` / `--base` flag matrix.
+ *
+ * - A plan file may accompany `--issue` OR `--pr`, but not both — with both and
+ *   a plan file there is no single instruction source. Without a plan file,
+ *   `--issue` and `--pr` combine (plan generated from both).
+ * - `--base` is meaningless with `--pr` (the base comes from the PR itself).
+ * - `--issue` / `--pr` are single-repo launch flows, incompatible with the
+ *   read/group/kill flags in {@link SOURCE_INCOMPATIBLE_FLAGS}.
+ *
+ * Returns an error message when the combination is invalid, or `null` when OK.
+ */
+export declare function validateSourceFlags(options: LaunchOptions, hasPlanPathPositional: boolean): string | null;
 /**
  * Validate the multi-repo `--folder` / `--group-id` / `--plan` flag matrix.
  *
@@ -175,6 +197,8 @@ export interface RalphRunBodyInput {
         memory: number;
         disk: number;
     };
+    /** Non-base sandbox profile; omitted for base (the server default). */
+    sandboxProfile?: SandboxProfile;
     updateNotificationUrl?: string;
     updateNotificationNameTag?: string;
     githubToken?: string;
@@ -185,6 +209,18 @@ export interface RalphRunBodyInput {
      * branch in the sandbox instead of creating one from the base branch.
      */
     branchExists?: boolean;
+    /**
+     * Launch-from-existing linkage (optional; omitted when absent so legacy
+     * bodies stay byte-identical). An older server ignores unknown fields.
+     */
+    /** Existing GitHub issue to link (`Closes #N`). */
+    issueNumber?: number;
+    /** Existing pull request being continued. */
+    prNumber?: number;
+    /** The PR's head branch (the work branch; may contain `/`, unsanitized). */
+    headBranch?: string;
+    /** The PR's / --base target branch the PR opens into. */
+    baseBranch?: string;
 }
 /**
  * Parse a beforeLaunch hook's stdout into an envVars object to merge into the

package/dist/commands/launch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../../src/commands/launch.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../../src/commands/launch.ts"],"names":[],"mappings":"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"}

package/dist/commands/launch.js

@@ -14,6 +14,7 @@ import { GroupLaunchService, validateGroupId, } from '../services/group/GroupLau
 import { TempFileService } from '../services/logs/TempFileService.js';
 import { EditorService } from '../services/editor/EditorService.js';
 import { ensurePlanBranch, PlanNotFoundError, } from '../services/plan/PlanBranchService.js';
+import { parseGitHubRef, findLinkedIssueNumber, resolveIssueSource, resolvePrSource, buildPlanMarkdown, writeGeneratedPlan, } from '../services/plan/GitHubSourcePlanService.js';
 import { loadGitHubToken } from './login.js';
 import { resolveProject } from '../utils/project-resolver.js';
 import { HULA_PROJECT_URL } from '../config/constants.js';
@@ -25,6 +26,7 @@ import { findGitRoot } from '../utils/git-utils.js';
 import { upsertProviderApiKey } from '../utils/config-file-edit.js';
 import { validateNoReservedVars, readAndFilterEnvVars, RESERVED_ENV_VARS, } from '../utils/env-vars.js';
 import { HookExecutor } from '../services/hooks/HookExecutor.js';
+import { describeSandboxProfile, resolveSandboxProfile, sandboxProfileForRequest, } from '../utils/sandbox-profile.js';
 const DEFAULT_CONTAINER_RESOURCES = { cpu: 2, memory: 4, disk: 10 };
 /**
  * Launch command - Trigger a launch job on hula-project server
@@ -69,11 +71,15 @@ export function launchCommand(program, config) {
         //   'Run in test mode (server uses a mock Claude — fast E2E run, still creates a real PR)',
         // )
         .option('--handoff <username>', 'Assign the created issue to this GitHub user')
+        .option('--issue <ref>', 'Work on an existing GitHub issue (number, #number, or URL). Never creates a new issue. A single positional is the tracking name, not a plan path.')
+        .option('--pr <ref>', 'Continue an existing pull request in this repository (number, #number, or URL). Pushes to its branch. A single positional is the tracking name, not a plan path.')
+        .option('--base <branch>', 'Branch to cut the new work branch from and open the PR into (default: the repository default branch)')
         .option('--provider <type>', 'LLM provider: claude | openai | openrouter (default: config or claude)')
         .option('--provider-key <key>', 'Provider credential (ephemeral; never stored server-side beyond the run)')
         .option('--container-cpu <n>', 'vCPU cores for the sandbox (1–32)', parseInt)
         .option('--container-memory <n>', 'GiB RAM for the sandbox (1–128)', parseInt)
         .option('--container-disk <n>', 'GiB disk for the sandbox (5–200)', parseInt)
+        .option('--sandbox-profile <profile>', 'Sandbox image: base | android | android:17 | android:21 (default: config sandboxProfile, else base)')
         .option('--update-notification-url <url>', 'Webhook URL to POST a notification to on every terminal task transition')
         .option('--update-notification-name-tag <tag>', 'Verbatim "initiated by" label for notifications (Slack mention markup pings). Falls back to config then HULA_UPDATE_NOTIFICATION_NAME_TAG.')
         .option('--show <name>', 'Show job status for the specified issue')
@@ -121,6 +127,13 @@ export function launchCommand(program, config) {
                 logger.error(folderFlagError);
                 process.exit(1);
             }
+            // Validate the launch-from-existing `--issue` / `--pr` / `--base`
+            // flag combination before any work.
+            const sourceFlagError = validateSourceFlags(options, Boolean(planPath));
+            if (sourceFlagError) {
+                logger.error(sourceFlagError);
+                process.exit(1);
+            }
             // Validate an explicitly-supplied group id against the server format.
             if (typeof options.groupId === 'string') {
                 const groupIdError = validateGroupId(options.groupId);
@@ -162,6 +175,13 @@ export function launchCommand(program, config) {
                 await executeKill(config, issueName, options);
                 return;
             }
+            // With --issue / --pr the plan (and tracking name) are derived from
+            // GitHub, so neither positional is required. A single positional is
+            // the tracking name; the plan path is generated.
+            if (options.issue || options.pr) {
+                await executeLaunch(config, issueName, planPath, options);
+                return;
+            }
             // Regular launch / --kill-and-relaunch requires issueName and planPath
             if (!issueName || !planPath) {
                 logger.error('Usage: hula launch <issueName> <planPath>');
@@ -217,7 +237,52 @@ export function validateKillFlags(options) {
  * `--kill` needs only the tracking name; every other mode needs a plan.
  */
 export function requiresPlanPath(options) {
-    return !options.kill;
+    return !options.kill && !options.issue && !options.pr;
+}
+/**
+ * Launch-only flags that cannot be combined with `--issue` / `--pr`. These are
+ * either read/group modes or the kill flows, none of which make sense when
+ * starting from an existing issue or PR (single-repo launch only).
+ */
+const SOURCE_INCOMPATIBLE_FLAGS = [
+    { key: 'folder', flag: '--folder' },
+    { key: 'groupId', flag: '--group-id' },
+    { key: 'kill', flag: '--kill' },
+    { key: 'killAndRelaunch', flag: '--kill-and-relaunch' },
+    { key: 'show', flag: '--show' },
+    { key: 'logs', flag: '--logs' },
+    { key: 'showGroup', flag: '--show-group' },
+];
+/**
+ * Validate the `--issue` / `--pr` / `--base` flag matrix.
+ *
+ * - A plan file may accompany `--issue` OR `--pr`, but not both — with both and
+ *   a plan file there is no single instruction source. Without a plan file,
+ *   `--issue` and `--pr` combine (plan generated from both).
+ * - `--base` is meaningless with `--pr` (the base comes from the PR itself).
+ * - `--issue` / `--pr` are single-repo launch flows, incompatible with the
+ *   read/group/kill flags in {@link SOURCE_INCOMPATIBLE_FLAGS}.
+ *
+ * Returns an error message when the combination is invalid, or `null` when OK.
+ */
+export function validateSourceFlags(options, hasPlanPathPositional) {
+    const hasIssue = Boolean(options.issue);
+    const hasPr = Boolean(options.pr);
+    if (hasPlanPathPositional && hasIssue && hasPr) {
+        return 'Pass a plan file with --issue or with --pr, not with both. Without a plan file, --issue and --pr can be combined.';
+    }
+    if (hasPr && options.base) {
+        return '--base cannot be used with --pr: the base branch comes from the pull request';
+    }
+    if (hasIssue || hasPr) {
+        for (const { key, flag } of SOURCE_INCOMPATIBLE_FLAGS) {
+            const value = options[key];
+            if (value !== undefined && value !== false) {
+                return `--issue/--pr cannot be combined with ${flag}`;
+            }
+        }
+    }
+    return null;
 }
 /**
  * Validate the multi-repo `--folder` / `--group-id` / `--plan` flag matrix.
@@ -720,6 +785,11 @@ export function buildRalphRunRequestBody(input) {
     if (input.containerResources) {
         body.containerResources = input.containerResources;
     }
+    // Maps to RalphRunRequest.sandboxProfile. Only non-base profiles are sent so
+    // base launches stay byte-identical (see sandboxProfileForRequest).
+    if (input.sandboxProfile) {
+        body.sandboxProfile = input.sandboxProfile;
+    }
     if (input.updateNotificationUrl) {
         body.updateNotificationUrl = input.updateNotificationUrl;
     }
@@ -737,8 +807,69 @@ export function buildRalphRunRequestBody(input) {
     if (input.branchExists) {
         body.branchExists = true;
     }
+    // Launch-from-existing linkage (appended after branchExists, each only when
+    // defined, so non-source launches stay byte-identical). An older server
+    // ignores these unknown fields.
+    if (input.issueNumber !== undefined) {
+        body.issueNumber = input.issueNumber;
+    }
+    if (input.prNumber !== undefined) {
+        body.prNumber = input.prNumber;
+    }
+    if (input.headBranch !== undefined) {
+        body.headBranch = input.headBranch;
+    }
+    if (input.baseBranch !== undefined) {
+        body.baseBranch = input.baseBranch;
+    }
     return body;
 }
+/**
+ * True when `msg` is one of the deliberate validation errors thrown by
+ * {@link resolveIssueSource} / {@link resolvePrSource} (closed, merged, fork,
+ * wrong kind) — those must pass through verbatim, not be re-wrapped as a fetch
+ * failure.
+ */
+function isGitHubSourceValidationError(msg) {
+    return /is a pull request, not an issue|is closed\. Reopen|is already merged|comes from a fork/.test(msg);
+}
+/**
+ * {@link resolveIssueSource} with the GitHub-fetch error mapping from the plan's
+ * edge cases: 404 → a clear "not found in <owner/repo>", any other fetch error
+ * → "Could not fetch issue #<n>: …". Validation errors pass through unchanged.
+ */
+async function resolveIssueSourceWrapped(n, repo, repoFullName) {
+    try {
+        return await resolveIssueSource(n, repo);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (isGitHubSourceValidationError(msg))
+            throw err;
+        if (/404|not found/i.test(msg)) {
+            throw new Error(`Issue #${n} not found in ${repoFullName}`);
+        }
+        throw new Error(`Could not fetch issue #${n}: ${msg}`);
+    }
+}
+/**
+ * {@link resolvePrSource} with the same GitHub-fetch error mapping as
+ * {@link resolveIssueSourceWrapped}.
+ */
+async function resolvePrSourceWrapped(n, repoFullName) {
+    try {
+        return await resolvePrSource(n);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (isGitHubSourceValidationError(msg))
+            throw err;
+        if (/404|not found/i.test(msg)) {
+            throw new Error(`PR #${n} not found in ${repoFullName}`);
+        }
+        throw new Error(`Could not fetch PR #${n}: ${msg}`);
+    }
+}
 /**
  * Single-repo launch entry point. Runs the plan-sync/upload check, then defers
  * the body-build + POST to {@link launchSingleRepo} in single mode (keeps the
@@ -776,11 +907,121 @@ conflictModeOverride) {
  * @param options - Parsed CLI options.
  * @param ctx - Mode + shared-once context (see {@link SingleRepoLaunchContext}).
  */
-async function launchSingleRepo(repoConfig, repoRoot, issueName, planPath, options, ctx) {
+async function launchSingleRepo(repoConfig, repoRoot, issueNameInput, planPathInput, options, ctx) {
     const isGroup = ctx.mode === 'group';
     // Effective conflict mode: an explicit override (from the 409 resolver) or the
     // --kill-and-relaunch flag. Undefined = default 'reject' (byte-identical body).
     const conflictMode = deriveConflictMode(options, ctx.conflictModeOverride);
+    // ── Launch-from-existing resolution (FR 8) ────────────────────────────────
+    // With --issue / --pr the tracking name and plan are derived from GitHub, and
+    // --base / --pr change the branch the plan is published to and the PR base.
+    // Resolve all of that here, before ensurePlanBranch, so the proven publish
+    // path is reused with overrides and the request body gains the linkage fields.
+    let resolvedIssueName = issueNameInput;
+    let resolvedPlanPath = planPathInput;
+    let planBranchOpts;
+    const sourceBody = {};
+    if (options.issue || options.pr || options.base) {
+        try {
+            const repoFullName = ctx.repositoryId ??
+                (await resolveProject(repoConfig, undefined, repoRoot));
+            const [repoOwner, repoName] = repoFullName.split('/');
+            // Reject a URL that points at a different repository than this one.
+            const assertSameRepo = (ref, kind) => {
+                if (ref.owner &&
+                    ref.repo &&
+                    (ref.owner.toLowerCase() !== (repoOwner ?? '').toLowerCase() ||
+                        ref.repo.toLowerCase() !== (repoName ?? '').toLowerCase())) {
+                    throw new Error(`--${kind} URL points to ${ref.owner}/${ref.repo}, but this repository is ${repoOwner}/${repoName}`);
+                }
+            };
+            let pr;
+            let issue;
+            if (options.pr) {
+                const prRef = parseGitHubRef(options.pr, 'pr');
+                assertSameRepo(prRef, 'pr');
+                pr = await resolvePrSourceWrapped(prRef.number, repoFullName);
+                // Linked issue: an explicit --issue wins; otherwise auto-detect from the
+                // PR body and drop a closed linked issue with a warning.
+                if (options.issue) {
+                    const issueRef = parseGitHubRef(options.issue, 'issue');
+                    assertSameRepo(issueRef, 'issue');
+                    issue = await resolveIssueSourceWrapped(issueRef.number, { owner: issueRef.owner, name: issueRef.repo }, repoFullName);
+                }
+                else {
+                    const linked = findLinkedIssueNumber(pr.body);
+                    if (linked !== null) {
+                        try {
+                            issue = await resolveIssueSourceWrapped(linked, {}, repoFullName);
+                        }
+                        catch (linkedErr) {
+                            const linkedMsg = linkedErr instanceof Error
+                                ? linkedErr.message
+                                : String(linkedErr);
+                            if (linkedMsg.includes('is closed')) {
+                                logger.warning(`Linked issue #${linked} is closed — continuing without linking it`);
+                            }
+                            else {
+                                throw linkedErr;
+                            }
+                        }
+                    }
+                }
+            }
+            else if (options.issue) {
+                const issueRef = parseGitHubRef(options.issue, 'issue');
+                assertSameRepo(issueRef, 'issue');
+                issue = await resolveIssueSourceWrapped(issueRef.number, { owner: issueRef.owner, name: issueRef.repo }, repoFullName);
+            }
+            // Tracking name: the positional if given, else pr-<n> / issue-<n>.
+            if (!resolvedIssueName) {
+                resolvedIssueName = pr
+                    ? `pr-${pr.number}`
+                    : issue
+                        ? `issue-${issue.number}`
+                        : resolvedIssueName;
+            }
+            // Plan path: the positional if given, else a generated plan from the
+            // GitHub text (only reachable with --issue / --pr; --base alone still
+            // requires a positional plan because requiresPlanPath stays true).
+            if (!resolvedPlanPath && (pr || issue)) {
+                const slug = pr ? `pr-${pr.number}` : `issue-${issue.number}`;
+                const markdown = buildPlanMarkdown({ issue, pr, repoFullName });
+                resolvedPlanPath = writeGeneratedPlan(repoConfig.planPath, slug, markdown, repoRoot);
+                logger.info(`Generated plan from ${pr ? `PR #${pr.number}` : `issue #${issue.number}`}: ${resolvedPlanPath}`);
+            }
+            // Branch overrides for ensurePlanBranch.
+            if (pr) {
+                planBranchOpts = { branch: pr.head.ref, requireExistingBranch: true };
+            }
+            else if (options.base) {
+                planBranchOpts = { baseBranch: options.base };
+            }
+            // Request-body linkage fields.
+            if (pr) {
+                sourceBody.prNumber = pr.number;
+                sourceBody.headBranch = pr.head.ref;
+                sourceBody.baseBranch = pr.base.ref;
+            }
+            else if (options.base) {
+                sourceBody.baseBranch = options.base;
+            }
+            if (issue) {
+                sourceBody.issueNumber = issue.number;
+            }
+        }
+        catch (sourceErr) {
+            const msg = sourceErr instanceof Error ? sourceErr.message : String(sourceErr);
+            logger.error(msg);
+            if (isGroup)
+                return { ok: false, message: msg };
+            process.exit(1);
+        }
+    }
+    // After resolution both are guaranteed: the handler requires positionals
+    // except with --issue / --pr, which populate them above.
+    const issueName = resolvedIssueName;
+    const planPath = resolvedPlanPath;
     // Plan-branch flow: guarantee the feature branch exists on origin with the
     // current plan content BEFORE anything else — the beforeLaunch hook below
     // may register branch-scoped external resources (e.g. Vercel Preview env
@@ -791,7 +1032,7 @@ async function launchSingleRepo(repoConfig, repoRoot, issueName, planPath, optio
     // that only exist on origin/main.
     let planBranch;
     try {
-        const ensured = await ensurePlanBranch(repoConfig, planPath, issueName, repoRoot);
+        const ensured = await ensurePlanBranch(repoConfig, planPath, issueName, repoRoot, planBranchOpts);
         planBranch = ensured.branch;
         if (ensured.created) {
             logger.success(`Branch '${ensured.branch}' created on origin with the plan`);
@@ -1009,6 +1250,18 @@ async function launchSingleRepo(repoConfig, repoRoot, issueName, planPath, optio
         containerResources = { cpu, memory, disk };
         logger.log(`  Container Resources: cpu=${cpu} memory=${memory}GiB disk=${disk}GiB`);
     }
+    // Resolve the sandbox profile: --sandbox-profile, then config, then base.
+    const profileResult = resolveSandboxProfile(options.sandboxProfile, repoConfig.sandboxProfile);
+    if (profileResult.error) {
+        logger.error(profileResult.error);
+        if (isGroup)
+            return { ok: false, message: profileResult.error };
+        process.exit(1);
+    }
+    const sandboxProfile = sandboxProfileForRequest(profileResult.profile);
+    if (sandboxProfile) {
+        logger.log(`  Sandbox Profile: ${describeSandboxProfile(sandboxProfile)}`);
+    }
     // Resolve the GitHub token: shared (group mode) or loaded (single mode).
     const githubToken = ctx.skipTokenLoad
         ? ctx.githubToken
@@ -1124,6 +1377,7 @@ async function launchSingleRepo(repoConfig, repoRoot, issueName, planPath, optio
         clientSessionId: clientSessionId ?? undefined,
         provider: { type: providerType, authToken },
         containerResources,
+        sandboxProfile,
         updateNotificationUrl,
         updateNotificationNameTag,
         githubToken,
@@ -1132,6 +1386,11 @@ async function launchSingleRepo(repoConfig, repoRoot, issueName, planPath, optio
         // plan committed) exists on origin, so the server must check out the
         // existing branch instead of creating one from the base branch.
         branchExists: true,
+        // Launch-from-existing linkage (undefined unless --issue / --pr / --base).
+        issueNumber: sourceBody.issueNumber,
+        prNumber: sourceBody.prNumber,
+        headBranch: sourceBody.headBranch,
+        baseBranch: sourceBody.baseBranch,
     });
     try {
         const response = await axios.post(endpoint, requestBody, {
@@ -1149,13 +1408,15 @@ async function launchSingleRepo(repoConfig, repoRoot, issueName, planPath, optio
             }
             logger.success(response.data.message);
             logger.blank();
+            // Link to the dashboard of the server we launched on, so a preview or
+            // self-hosted launch is not sent to hublaunch.site.
+            const dashboardUrl = `${serverUrl.replace(/\/$/, '')}/dashboard`;
             if (response.data.planId) {
-                const planUrl = `https://www.hublaunch.site/dashboard/plans/${response.data.planId}`;
                 logger.info(`Plan ID: ${response.data.planId}`);
-                logger.info(`Track it: ${planUrl}`);
+                logger.info(`Track it: ${dashboardUrl}/plans/${response.data.planId}`);
             }
             else {
-                logger.info('Track it: https://www.hublaunch.site/dashboard');
+                logger.info(`Track it: ${dashboardUrl}`);
             }
             if (!updateNotificationUrl) {
                 logger.info('Set updateNotificationUrl in your local hublaunch.config.js file to be able to get update messages about the status.');