hub-launch 1.27.0 → 1.29.0

package/dist/services/git/FilePublishService.js

@@ -115,8 +115,11 @@ export class FilePublishService {
      * commit (with `commitMessage`) if it produced changes, push to the branch,
      * and always remove the worktree afterward.
      */
-    async withWorktree(type, branch, commitMessage, operation) {
+    async withWorktree(type, branch, commitMessage, operation, createFromRef) {
         this.validateBranch(branch);
+        if (createFromRef !== undefined) {
+            this.validateBranch(createFromRef);
+        }
         const worktreeBasePath = await this.resolveWorktreeBasePath();
         const repoInfo = await getRepoInfo(this.cwd);
         const worktreeService = new WorktreeService({
@@ -129,7 +132,7 @@ export class FilePublishService {
         const worktreePath = worktreeService.getWorktreeDir(type, identifier);
         let worktreeCreated = false;
         try {
-            await worktreeService.createWorktreeAt(worktreePath, `origin/${branch}`, true);
+            await worktreeService.createWorktreeAt(worktreePath, createFromRef ?? `origin/${branch}`, true);
             worktreeCreated = true;
             operation(worktreePath);
             const hasChanges = await worktreeService.hasChangesAt(worktreePath);
@@ -149,7 +152,10 @@ export class FilePublishService {
             let lastError;
             for (let attempt = 1; attempt <= MAX_PUSH_ATTEMPTS; attempt++) {
                 try {
-                    await worktreeService.pushAt(worktreePath, `HEAD:${branch}`);
+                    // Fully-qualified destination so the push also CREATES the branch on
+                    // origin when it does not exist yet (an unqualified `HEAD:<branch>`
+                    // is rejected for a nonexistent destination ref).
+                    await worktreeService.pushAt(worktreePath, `HEAD:refs/heads/${branch}`);
                     lastError = undefined;
                     break; // pushed successfully
                 }
@@ -206,7 +212,7 @@ export class FilePublishService {
             const filePath = join(worktreePath, relativePath);
             mkdirSync(dirname(filePath), { recursive: true });
             writeFileSync(filePath, content, 'utf-8');
-        });
+        }, opts?.createFromRef);
     }
     /**
      * Delete a file from the target branch.

package/dist/services/git/FilePublishService.js.map

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

package/dist/services/plan/PlanBranchService.d.ts

@@ -0,0 +1,38 @@
+import type { Config } from '../../types/index.js';
+/**
+ * Outcome of {@link ensurePlanBranch}.
+ */
+export interface EnsurePlanBranchResult {
+    /** The git branch name the plan lives on (sanitized issue name). */
+    branch: string;
+    /** True when the branch was created on origin by this call. */
+    created: boolean;
+    /** True when the plan file on the branch was written/refreshed by this call. */
+    updated: boolean;
+}
+/**
+ * Thrown when the plan file cannot be found anywhere — not on disk, not on
+ * the feature branch, not on the base branch. Callers translate this into the
+ * historical "Plan not found locally or on origin/main" error handling.
+ */
+export declare class PlanNotFoundError extends Error {
+    constructor(planPath: string);
+}
+/**
+ * Ensure the feature branch for `issueName` exists on origin and carries the
+ * current plan file — the core of the plan-branch flow.
+ *
+ * - Branch missing on origin → create it from `origin/<uploadBranch ?? main>`
+ *   with the plan committed (one worktree publish, one push).
+ * - Branch exists but the plan file on it is missing or stale → publish the
+ *   fresh content to the branch.
+ * - Branch exists with identical content → no-op.
+ *
+ * This runs BEFORE the beforeLaunch hook in `hula launch`, so hooks (e.g.
+ * Vercel branch-scoped env vars) can rely on the git branch existing on the
+ * remote. It is also invoked at plan time via `hula upload --branch`.
+ *
+ * @throws PlanNotFoundError when the plan content cannot be resolved anywhere.
+ */
+export declare function ensurePlanBranch(config: Config, planPath: string, issueName: string, repoRoot?: string): Promise<EnsurePlanBranchResult>;
+//# sourceMappingURL=PlanBranchService.d.ts.map

package/dist/services/plan/PlanBranchService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlanBranchService.d.ts","sourceRoot":"","sources":["../../../src/services/plan/PlanBranchService.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAMnD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,OAAO,EAAE,OAAO,CAAC;IACjB,gFAAgF;IAChF,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,QAAQ,EAAE,MAAM;CAI7B;AAmCD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,sBAAsB,CAAC,CAsDjC"}

package/dist/services/plan/PlanBranchService.js

@@ -0,0 +1,95 @@
+import { existsSync, readFileSync } from 'fs';
+import { isAbsolute, join } from 'path';
+import { sanitizePlanName } from '../../utils/validators.js';
+import { GitService } from '../git/GitService.js';
+import { FilePublishService } from '../git/FilePublishService.js';
+import { PlanService } from './PlanService.js';
+/**
+ * Thrown when the plan file cannot be found anywhere — not on disk, not on
+ * the feature branch, not on the base branch. Callers translate this into the
+ * historical "Plan not found locally or on origin/main" error handling.
+ */
+export class PlanNotFoundError extends Error {
+    constructor(planPath) {
+        super(`Plan not found locally or on any git ref: ${planPath}`);
+        this.name = 'PlanNotFoundError';
+    }
+}
+/**
+ * Resolve the plan's content, preferring the freshest source:
+ *   1. the working tree (where /hula-plan writes and validation edits it)
+ *   2. the feature branch on origin (plan-branch flow, plan already pushed)
+ *   3. the base branch on origin, then local base (legacy plans, relaunches)
+ *
+ * Returns `null` when the plan exists nowhere.
+ */
+async function resolvePlanContent(gitService, relativePath, planFsPath, branch, branchOnOrigin, baseBranch) {
+    if (existsSync(planFsPath)) {
+        return readFileSync(planFsPath, 'utf-8');
+    }
+    if (branchOnOrigin &&
+        (await gitService.fileExistsOnRef(`origin/${branch}`, relativePath))) {
+        return gitService.showFile(`origin/${branch}`, relativePath);
+    }
+    for (const ref of [`origin/${baseBranch}`, baseBranch]) {
+        if (await gitService.fileExistsOnRef(ref, relativePath)) {
+            return gitService.showFile(ref, relativePath);
+        }
+    }
+    return null;
+}
+/**
+ * Ensure the feature branch for `issueName` exists on origin and carries the
+ * current plan file — the core of the plan-branch flow.
+ *
+ * - Branch missing on origin → create it from `origin/<uploadBranch ?? main>`
+ *   with the plan committed (one worktree publish, one push).
+ * - Branch exists but the plan file on it is missing or stale → publish the
+ *   fresh content to the branch.
+ * - Branch exists with identical content → no-op.
+ *
+ * This runs BEFORE the beforeLaunch hook in `hula launch`, so hooks (e.g.
+ * Vercel branch-scoped env vars) can rely on the git branch existing on the
+ * remote. It is also invoked at plan time via `hula upload --branch`.
+ *
+ * @throws PlanNotFoundError when the plan content cannot be resolved anywhere.
+ */
+export async function ensurePlanBranch(config, planPath, issueName, repoRoot) {
+    const branch = sanitizePlanName(issueName);
+    const baseBranch = config.uploadBranch ?? 'main';
+    const gitService = new GitService(repoRoot);
+    const planService = new PlanService(config.planPath);
+    const relativePath = planService.getRelativePath(planPath);
+    const planFsPath = isAbsolute(planPath) || !repoRoot ? planPath : join(repoRoot, planPath);
+    // One fetch up front so every origin/<ref> read below is current.
+    await gitService.fetch('origin');
+    const branchOnOrigin = await gitService.remoteBranchExists(branch);
+    const content = await resolvePlanContent(gitService, relativePath, planFsPath, branch, branchOnOrigin, baseBranch);
+    if (content === null) {
+        throw new PlanNotFoundError(planPath);
+    }
+    if (branchOnOrigin) {
+        // Skip the publish when the branch already holds this exact content.
+        // `git show` output matches committed bytes, so string equality is exact.
+        if (await gitService.fileExistsOnRef(`origin/${branch}`, relativePath)) {
+            const onBranch = await gitService.showFile(`origin/${branch}`, relativePath);
+            if (onBranch === content) {
+                return { branch, created: false, updated: false };
+            }
+        }
+        const publisher = new FilePublishService(config, repoRoot);
+        await publisher.publishFile(relativePath, content, {
+            commitMessage: 'chore: update plan via hula',
+            branch,
+        });
+        return { branch, created: false, updated: true };
+    }
+    const publisher = new FilePublishService(config, repoRoot);
+    await publisher.publishFile(relativePath, content, {
+        commitMessage: 'chore: create plan branch via hula',
+        branch,
+        createFromRef: `origin/${baseBranch}`,
+    });
+    return { branch, created: true, updated: true };
+}
+//# sourceMappingURL=PlanBranchService.js.map

package/dist/services/plan/PlanBranchService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlanBranchService.js","sourceRoot":"","sources":["../../../src/services/plan/PlanBranchService.ts"],"names":[],"mappings":"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"}

package/dist/templates/proceed-instructions.md

@@ -378,8 +378,9 @@ After the Completion Format block is printed, offer to launch the plan for the u
 
 Determine `<issueName>` before asking the question:
 
-1. **Look for a name the user specified** anywhere in this conversation — e.g. "use the branch name `foo`", "call the issue `bar`", or a name passed in the original `/hula-plan` arguments. If more than one was mentioned, **the most recent wins**. Use that name verbatim (kebab-case it if needed).
-2. **Otherwise derive the default from the plan file's basename** (the subfolder is never part of the name):
+1. **Look for a plan-branch created earlier in this session** — a `<!-- hula-branch: <name> -->` comment in the chat history (emitted by `/hula-plan` when it created the feature branch at plan time). If present, that name is the default: the branch already exists on origin with the plan on it.
+2. **Look for a name the user specified** anywhere in this conversation — e.g. "use the branch name `foo`", "call the issue `bar`", or a name passed in the original `/hula-plan` arguments. If more than one was mentioned, **the most recent wins**, and a user-specified name overrides the plan-branch default. Use that name verbatim (kebab-case it if needed). (Launching under a different name than the plan branch is fine — `hula launch` creates the new branch automatically; the unused plan branch can be deleted later.)
+3. **Otherwise derive the default from the plan file's basename** (the subfolder is never part of the name):
    - Strip the leading timestamp prefix matching `YYYY-MM-DD-HH:MM-` and the trailing `.md`.
    - The remaining text is the title slug (e.g. `auto-launch-offer-after-plan`).
    - If the slug is **longer than 3 words**, shorten it to the 2–3 most distinctive words (e.g. `auto-launch-offer-after-plan` → `auto-launch`). Otherwise keep it as-is.

package/dist/templates/skills/hula-help/SKILL.md

@@ -86,7 +86,7 @@ Read `README.md`'s "Quick Start" and "Requirements" sections (and the "Core Work
 Read the "Core Workflow" section of `README.md` live. Explain each step in plain language — one at a time if the user wants depth, or as a compact list if they want the overview:
 
 - `/hula-plan <description>` — writes a plan file to `.hublaunch/plans/`, validates it automatically.
-- `/hula-upload` — syncs the plan to `origin/main` (usually automatic as part of `/hula-launch`, rarely needed standalone).
+- `/hula-upload` — publishes the plan to its feature branch (`hula upload --branch <name>`) or to `origin/main` (usually automatic as part of `/hula-plan` and `/hula-launch`, rarely needed standalone).
 - `/hula-launch <name>` — creates the GitHub issue, runs the AI coding session in an isolated cloud container, opens a PR.
 - `/hula-verify` — checks the PR against the plan's acceptance criteria.
 - `/hula-fix <instructions>` — addresses gaps found by verify, or anything else you want changed on the PR branch.

package/dist/templates/skills/hula-launch/SKILL.md

@@ -153,6 +153,6 @@ The `cliOutput` already contains the per-repo roster, ✓/✗ summary, and any r
 
 ## Important Notes
 
-- Do NOT call the `Read` tool to check if the plan file exists. The `hula launch` CLI validates file existence (locally and on `origin/main`) and reports errors clearly.
-- Do NOT run `hula upload` separately. `hula launch` handles upload automatically.
+- Do NOT call the `Read` tool to check if the plan file exists. The `hula launch` CLI validates file existence (locally, on the plan's feature branch, and on `origin/main`) and reports errors clearly.
+- Do NOT run `hula upload` separately. `hula launch` publishes the plan to its feature branch automatically (creating the branch from the base branch if `/hula-plan` didn't already, and refreshing it after validation edits or a rename).
 - This command is typically run after `/hula-plan` and `/hula-confirm`.

package/dist/templates/skills/hula-plan/SKILL.md

@@ -122,17 +122,33 @@ The plan should be immediately actionable by a developer familiar with the codeb
 
 **⚠️ NEVER create plan files in the project root directory.** The plan file MUST always be inside the `.hublaunch/plans/` directory (or a subfolder of it). If you cannot read the config file, use the default path `.hublaunch/plans/`.
 
-### Step 2: Output the Plan Path and Next Steps
+### Step 2: Create the Plan Branch
+
+Right after saving the plan file, create the feature branch on origin with the plan committed to it. This is the **plan-branch flow**: the git branch exists from plan time onward, so branch-scoped infrastructure (Vercel Preview env vars, per-branch databases, beforeLaunch hooks) can rely on it well before the launch.
+
+1. **Resolve `<issueName>`** using the same rules as the Launch Offer's "Resolve the issue name" step in `hula instructions proceed`: a name the user specified anywhere in this conversation wins (most recent first); otherwise derive the default from the plan file's basename (strip the `YYYY-MM-DD-HH:MM-` prefix and `.md`, shorten a >3-word slug to its 2–3 most distinctive words, always kebab-case).
+2. **Create the branch** by running:
+
+   `hula upload <planPath> --branch <issueName>`
+
+   This creates branch `<issueName>` (sanitized) on origin from the base branch with the plan file committed, or refreshes the plan on the branch if it already exists.
+3. If the command fails (e.g. no network, no push permission), print a warning and continue — `hula launch` re-runs the same step as a safety net at launch time, so a plan-time failure is not fatal.
+
+### Step 3: Output the Plan Path and Next Steps
 
 **Output Format:**
 
 ```
 ✅ Plan created: `.hublaunch/plans/2025-12-29-14:30-feature-name.md`
+🌿 Branch created: `feature-name` (plan pushed to origin)
 <!-- hula-plan: .hublaunch/plans/2025-12-29-14:30-feature-name.md -->
+<!-- hula-branch: feature-name -->
 
 📋 **Proceeding to validation now…**
 ```
 
+(Substitute the actual resolved `<issueName>` in the branch line and the `hula-branch` comment. If branch creation failed in Step 2, replace the 🌿 line with `⚠️ Branch creation deferred to launch time` and omit the `hula-branch` comment.)
+
 Now proceed directly to plan validation **without waiting for the user**. The plan file was just created in this session — the path is already known.
 
 Read `hula instructions proceed` and execute the full validation workflow against the plan at `<path>` (substitute `<path>` with the actual plan file path you just created, e.g. `.hublaunch/plans/2025-12-29-14:30-feature-name.md`).
@@ -156,4 +172,4 @@ Read `hula instructions proceed` and execute the full validation workflow agains
   5. If `--test` and/or `--handoff <username>` were also present in `$ARGUMENTS`, pass them through to the launch — same as the Launch Offer's reply table does for a manual reply containing those flags.
 - **Without `--autoLaunch`**, behavior is completely unchanged: ask and wait as today.
 
-**Note:** The plan is saved locally. When you run `/hula-launch`, the plan is automatically synced to `origin/main` before the GitHub issue is created and the implementation begins — no separate upload step needed. Because validation ends with the Launch Offer, an affirmative reply runs the `/hula-launch` workflow for the user automatically; they can also decline and run `/hula-launch` themselves later. `/hula-confirm` remains available as a standalone command for re-validation at any time. If `--autoLaunch` was passed to `/hula-plan`, the launch runs automatically once validation completes — no reply needed.
+**Note:** The plan is saved locally AND pushed to its feature branch on origin (Step 2). When you run `/hula-launch`, the plan branch is re-synced automatically (covering validation edits and renames) before the GitHub issue is created and the implementation begins — no separate upload step needed. Because validation ends with the Launch Offer, an affirmative reply runs the `/hula-launch` workflow for the user automatically; they can also decline and run `/hula-launch` themselves later. `/hula-confirm` remains available as a standalone command for re-validation at any time. If `--autoLaunch` was passed to `/hula-plan`, the launch runs automatically once validation completes — no reply needed.

package/dist/templates/skills/hula-research/SKILL.md

@@ -0,0 +1,162 @@
+---
+name: hula-research
+description: Research a codebase and present a clear, digestible R&D report. Use when the user wants to understand how the code works, get an architecture overview, or investigate a specific area, feature, or subsystem.
+disable-model-invocation: true
+argument-hint: "[topic or area to focus on — omit for a whole-codebase overview]"
+allowed-tools: Bash Read
+---
+
+You are an expert software researcher for the HubLaunch workflow. Your job is to go through the code, do the R&D, and present the user a report that is **easy to absorb yet complete on the things that matter**.
+
+## Golden rules
+
+1. **Read-only.** This is research, not implementation. **Never edit, create, move, or delete any file**, and never run commands that change state (no `git commit`, `git checkout`, `npm install`, writes, etc.). Only read and search.
+2. **Digestible first, deep second.** Lead with a short summary the user can read in 30 seconds. Put detail below it, structured so the reader can stop early. Do not dump everything you found.
+3. **Ground every claim in the code.** Reference real files and line numbers (e.g. `src/services/git/GitService.ts:58`). If you are inferring rather than confirming, say so.
+4. **One simple diagram, when it helps.** Use a plain ASCII/box-and-arrow diagram — **never Mermaid** or any other rendered diagram syntax. Keep it small enough to read at a glance.
+
+## Input
+
+Research request: $ARGUMENTS
+
+### Scope detection
+
+- **If an argument is provided** (a topic, area, feature, file, or question — e.g. `/hula-research the launch pipeline` or `/hula-research how auth tokens flow`): scope the research to that topic. Go **deeper** on it; ignore unrelated parts of the codebase except where they connect.
+- **If no argument is provided**: produce a **whole-codebase architecture overview** — breadth over depth. Cover what the project is, its major pieces, and how they fit together.
+
+If the argument is genuinely ambiguous (could mean two very different things), ask **one** short clarifying question, then proceed.
+
+## Research workflow
+
+Do this analysis **before** writing the report. Work efficiently — you do not need to read every file, but you must not guess at the important ones.
+
+1. **Orient.** Read the entry points and the map of the project: `package.json` (scripts, bin, deps), `README.md`, `tsconfig.json`, top-level `src/` layout, and any CLAUDE.md / docs. Establish what the project *is* and how it runs.
+2. **Map the structure.** Identify the major directories and what each is responsible for (commands, services, types, config, templates, utils, etc.). Note the naming conventions and patterns in use.
+3. **Trace the important paths.** For the chosen scope, follow the real flow: entry point → command → service(s) → external calls → output. Read the type definitions that describe the data shapes. Follow imports to understand how pieces connect.
+4. **Find the load-bearing pieces.** Identify the files, services, or abstractions that the rest of the code depends on most. These deserve the most attention in the report.
+5. **Note the rough edges.** Spot anything worth flagging: complexity hot spots, duplication, TODO/FIXME markers, tight coupling, missing tests, or surprising design choices. Be honest but fair.
+
+Use whatever read-only search and file tools the harness provides (codebase/semantic search, file reads, `grep`, `git log`/`git blame` for history). Prefer reading source over assuming.
+
+## Report format
+
+Present the report **in chat** (do not write it to a file). Use this layered structure so the reader can stop reading whenever they have enough:
+
+```markdown
+# 🔬 Research: <topic, or "Codebase Overview">
+
+## TL;DR
+<2–4 sentences. What this is, and the single most important thing to understand. A busy reader should be able to stop here.>
+
+## Key Findings
+- <3–7 punchy bullets — the things that actually matter. Each ties to a concrete place in the code.>
+
+## How it fits together
+<One ASCII diagram (see guidelines below) + 2–4 sentences walking through it.>
+```
+
+Then, **below the summary**, include the deeper material. Put each deep section inside a collapsible block so the report stays scannable (fall back to plain `###` headings if the harness doesn't render `<details>`):
+
+```markdown
+<details>
+<summary><b>Components & responsibilities</b></summary>
+
+- **<Component>** (`path`) — what it does, who calls it, what it depends on.
+- ...
+</details>
+
+<details>
+<summary><b>Data & control flow</b></summary>
+
+<Step-by-step of the key path, with file:line references.>
+</details>
+
+<details>
+<summary><b>Patterns & conventions</b></summary>
+
+<Naming, structure, error handling, config, testing patterns worth knowing before touching the code.>
+</details>
+
+<details>
+<summary><b>Key files to know</b></summary>
+
+| File | Why it matters |
+| --- | --- |
+| `src/...` | ... |
+</details>
+
+<details>
+<summary><b>Risks, gaps & open questions</b></summary>
+
+- ⚠️ <complexity / coupling / missing tests / tech debt>
+- ❓ <anything you could not determine from the code>
+</details>
+```
+
+End with a short pointer block (not collapsed):
+
+```markdown
+## Where to dig next
+- To change X, start at `src/...`
+- Related area worth a follow-up `/hula-research <topic>`: ...
+```
+
+Scale the report to the scope: a **topic-focused** request should go deep on that topic; a **whole-codebase overview** should stay broad and keep each section short. Never let the deep sections bury the TL;DR and Key Findings.
+
+## ASCII diagram guidelines
+
+Include **one** diagram when it clarifies structure or flow (most reports benefit from one; skip it only if it would add nothing). Rules:
+
+- **ASCII only — no Mermaid, no PlantUML, no image syntax.** It must render as plain text in any chat.
+- Keep it small: a handful of boxes and arrows, not a wall of ASCII art.
+- Use boxes for components and arrows (`──▶`, `│`, `▼`) for flow or dependency direction.
+- Label arrows when the relationship isn't obvious.
+
+Example (a flow diagram):
+
+```text
+  User
+   │  /hula-launch <branch>
+   ▼
+┌─────────────┐    reads     ┌──────────────────┐
+│  launch.ts  │ ───────────▶ │  hublaunch.config│
+└──────┬──────┘              └──────────────────┘
+       │ POST job
+       ▼
+┌──────────────────┐  runs   ┌───────────────────┐
+│  HulaApiClient   │ ──────▶ │ hula-project server│
+└──────────────────┘         │  (Claude Code in   │
+                             │   cloud container) │
+                             └─────────┬─────────┘
+                                       │ opens
+                                       ▼
+                                  GitHub PR
+```
+
+Example (a layered/module diagram):
+
+```text
+┌──────────────────────────────────────────────┐
+│  commands/   (CLI surface: create, launch …)  │
+└───────────────┬──────────────────────────────┘
+                │ calls
+                ▼
+┌──────────────────────────────────────────────┐
+│  services/   (github, git, api, logs, …)      │
+└───────────────┬──────────────────────────────┘
+                │ uses
+                ▼
+┌──────────────────────────────────────────────┐
+│  utils/ • types/ • config/   (shared core)    │
+└──────────────────────────────────────────────┘
+```
+
+## Quality bar
+
+- ✅ Scope correctly detected (topic-focused vs. whole-codebase overview)
+- ✅ TL;DR + Key Findings let a reader grasp the gist in under a minute
+- ✅ All important aspects covered, deeper detail available but not overwhelming
+- ✅ One clear ASCII diagram (never Mermaid) when it helps
+- ✅ Claims grounded in real `file:line` references; inferences labeled as such
+- ✅ Honest about risks, gaps, and what couldn't be determined
+- ✅ **Nothing was modified** — read-only throughout

package/dist/templates/skills/hula-upload/SKILL.md

@@ -29,7 +29,7 @@ Your job is to:
      ```
      ℹ️ Upload is no longer a separate step.
 
-     `hula launch` automatically uploads the plan to `origin/main` before starting the job.
+     `hula launch` automatically publishes the plan to its feature branch before starting the job (creating the branch from the base branch if `/hula-plan` didn't already).
 
      **Next Step:** Run `/hula-launch <branch-name>` to upload and launch in one step.
 
@@ -84,7 +84,7 @@ Display this message to the user:
 ```
 ℹ️ Upload is no longer a separate step.
 
-`hula launch` automatically uploads the plan to `origin/main` before starting the job.
+`hula launch` automatically publishes the plan to its feature branch before starting the job (creating the branch from the base branch if `/hula-plan` didn't already).
 
 **Next Step:** Run `/hula-launch <branch-name>` to upload and launch in one step.
 

package/dist/utils/validators.d.ts

@@ -25,6 +25,14 @@ export declare function parseIssueNumber(value: string | number): number | null;
  * Validate email address
  */
 export declare function isValidEmail(email: string): boolean;
+/**
+ * Sanitize an issue/tracking name into the git branch name used for its run.
+ * MUST stay byte-identical to `sanitizePlanName` in hula-server's
+ * `packages/shared/src/utils.ts` — the server derives the sandbox branch from
+ * the same issueName, so both sides have to resolve the SAME branch name for
+ * the plan-branch flow to hand off correctly.
+ */
+export declare function sanitizePlanName(name: string): string;
 /**
  * Sanitize filename
  */

package/dist/utils/validators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../src/utils/validators.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAElE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAG/D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO/C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAUtE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGnD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMzD"}
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../src/utils/validators.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAElE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAG/D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO/C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAUtE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGnD;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMzD"}

package/dist/utils/validators.js

@@ -51,6 +51,16 @@ export function isValidEmail(email) {
     const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
     return emailRegex.test(email);
 }
+/**
+ * Sanitize an issue/tracking name into the git branch name used for its run.
+ * MUST stay byte-identical to `sanitizePlanName` in hula-server's
+ * `packages/shared/src/utils.ts` — the server derives the sandbox branch from
+ * the same issueName, so both sides have to resolve the SAME branch name for
+ * the plan-branch flow to hand off correctly.
+ */
+export function sanitizePlanName(name) {
+    return name.replace(/[^a-zA-Z0-9_-]/g, "_");
+}
 /**
  * Sanitize filename
  */

package/dist/utils/validators.js.map

@@ -1 +1 @@
-{"version":3,"file":"validators.js","sourceRoot":"","sources":["../../src/utils/validators.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;AAC3E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,8DAA8D;IAC9D,OAAO,+CAA+C,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACxE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAsB;IACrD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAClD,CAAC;IAED,6BAA6B;IAC7B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAElC,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,MAAM,UAAU,GAAG,4BAA4B,CAAC;IAChD,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,OAAO,QAAQ;SACZ,OAAO,CAAC,wBAAwB,EAAE,GAAG,CAAC,CAAC,wBAAwB;SAC/D,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,8BAA8B;SACnD,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,4BAA4B;SAChD,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,kCAAkC;AAC9D,CAAC"}
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../../src/utils/validators.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;AAC3E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,8DAA8D;IAC9D,OAAO,+CAA+C,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACxE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAsB;IACrD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAClD,CAAC;IAED,6BAA6B;IAC7B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAElC,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,MAAM,UAAU,GAAG,4BAA4B,CAAC;IAChD,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,OAAO,QAAQ;SACZ,OAAO,CAAC,wBAAwB,EAAE,GAAG,CAAC,CAAC,wBAAwB;SAC/D,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,8BAA8B;SACnD,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,4BAA4B;SAChD,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,kCAAkC;AAC9D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hub-launch",
-  "version": "1.27.0",
+  "version": "1.29.0",
   "description": "GitHub Issue and PR automation CLI tool with plugin/hook system for project-specific customizations",
   "type": "module",
   "main": "./dist/index.js",

package/scripts/postinstall.mjs

@@ -44,6 +44,7 @@ const SKILL_NAMES = [
   'hula-upload',
   'hula-info',
   'hula-help',
+  'hula-research',
 ];
 
 function main() {