hub-launch 1.20.0 → 1.22.0

package/dist/services/group/GroupLaunchService.d.ts

@@ -0,0 +1,230 @@
+import { z } from 'zod';
+import type { Config } from '../../types/index.js';
+/** The server's `groupId` validation regex (hula-server PR #505). */
+export declare const GROUP_ID_REGEX: RegExp;
+/**
+ * A repository discovered under a `--folder` parent that qualifies for a group
+ * launch (has both a `.git` entry and a `.hublaunch` config file).
+ */
+export interface DiscoveredRepo {
+    /** The directory name (used as the `<repoName>` key for `--plan` overrides). */
+    name: string;
+    /** Absolute path to the repository root. */
+    path: string;
+}
+/**
+ * A subdirectory that was inspected during discovery but did not qualify, with
+ * the human-readable reason (for display in the skipped list).
+ */
+export interface SkippedRepo {
+    name: string;
+    reason: string;
+}
+/**
+ * Result of scanning a parent folder for group-launchable repositories.
+ */
+export interface DiscoverResult {
+    repos: DiscoveredRepo[];
+    skipped: SkippedRepo[];
+    /**
+     * True when the folder itself is a git repository (a `.git` entry directly
+     * under it) — the user probably pointed at a repo instead of its parent.
+     */
+    folderIsRepo: boolean;
+}
+/** One repository entry inside a persisted group record. */
+export interface GroupRecordRepo {
+    name: string;
+    path: string;
+    project: string;
+}
+/** A single persisted group-launch record in `.hublaunch/group-launches.json`. */
+export interface GroupRecord {
+    groupId: string;
+    issueName: string;
+    createdAt: string;
+    folder: string;
+    repos: GroupRecordRepo[];
+}
+/** Zod schema for the on-disk `.hublaunch/group-launches.json` file. */
+export declare const GroupRecordSchema: z.ZodObject<{
+    groupId: z.ZodString;
+    issueName: z.ZodString;
+    createdAt: z.ZodString;
+    folder: z.ZodString;
+    repos: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        path: z.ZodString;
+        project: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        name: string;
+        project: string;
+    }, {
+        path: string;
+        name: string;
+        project: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    createdAt: string;
+    groupId: string;
+    issueName: string;
+    folder: string;
+    repos: {
+        path: string;
+        name: string;
+        project: string;
+    }[];
+}, {
+    createdAt: string;
+    groupId: string;
+    issueName: string;
+    folder: string;
+    repos: {
+        path: string;
+        name: string;
+        project: string;
+    }[];
+}>;
+export declare const GroupLaunchesFileSchema: z.ZodObject<{
+    groups: z.ZodArray<z.ZodObject<{
+        groupId: z.ZodString;
+        issueName: z.ZodString;
+        createdAt: z.ZodString;
+        folder: z.ZodString;
+        repos: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            path: z.ZodString;
+            project: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            name: string;
+            project: string;
+        }, {
+            path: string;
+            name: string;
+            project: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        createdAt: string;
+        groupId: string;
+        issueName: string;
+        folder: string;
+        repos: {
+            path: string;
+            name: string;
+            project: string;
+        }[];
+    }, {
+        createdAt: string;
+        groupId: string;
+        issueName: string;
+        folder: string;
+        repos: {
+            path: string;
+            name: string;
+            project: string;
+        }[];
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    groups: {
+        createdAt: string;
+        groupId: string;
+        issueName: string;
+        folder: string;
+        repos: {
+            path: string;
+            name: string;
+            project: string;
+        }[];
+    }[];
+}, {
+    groups: {
+        createdAt: string;
+        groupId: string;
+        issueName: string;
+        folder: string;
+        repos: {
+            path: string;
+            name: string;
+            project: string;
+        }[];
+    }[];
+}>;
+export type GroupLaunchesFile = z.infer<typeof GroupLaunchesFileSchema>;
+/** Relative path (from a repo root) of the local group-record file. */
+export declare const GROUP_LAUNCHES_RELATIVE_PATH = ".hublaunch/group-launches.json";
+/**
+ * Lowercase an issue name and replace every character outside `[A-Za-z0-9_-]`
+ * with a hyphen. Used both for group-id generation and plan-filename matching.
+ */
+export declare function slugifyIssueName(issueName: string): string;
+/**
+ * Service for the client-side multi-repo `--folder` fan-out: repository
+ * discovery, group-id generation, per-repo plan resolution, and local group
+ * record persistence. Deliberately free of network calls so it is trivially
+ * unit-testable.
+ */
+export declare class GroupLaunchService {
+    /**
+     * Discover every immediate subdirectory of `folder` that qualifies as a
+     * group-launchable repository — one that contains BOTH a `.git` entry and a
+     * `.hublaunch/hublaunch.config.{ts,mjs,js}` file. Discovery does not recurse
+     * deeper than one level. Non-qualifying subdirectories are returned in the
+     * `skipped` list with a reason ("no .git" / "no .hublaunch config").
+     *
+     * @param folder - Absolute or relative parent-folder path.
+     * @returns The qualifying repos, the skipped entries with reasons, and a
+     *   `folderIsRepo` flag set when `folder` is itself a git repo.
+     */
+    discoverRepos(folder: string): DiscoverResult;
+    /**
+     * Generate a group id of the form `<slug>-<6 hex chars>` where `<slug>` is the
+     * slugified issue name, truncated so the full id is ≤ 64 characters. The hex
+     * suffix comes from `crypto.randomBytes(3)`.
+     *
+     * @param issueName - The feature/issue name.
+     * @returns A group id matching `^[A-Za-z0-9_-]{1,64}$`.
+     */
+    generateGroupId(issueName: string): string;
+    /**
+     * Resolve the plan file to launch for a repository.
+     *
+     * Candidates are `*.md` files under the repo's configured plans directory
+     * (`repoConfig.planPath`), searched recursively. Preference order: the newest
+     * file (by `YYYY-MM-DD-HH:MM` filename prefix, falling back to mtime) whose
+     * filename contains the issue-name slug; if none match, the newest plan file
+     * overall.
+     *
+     * @param repo - The discovered repository.
+     * @param repoConfig - That repo's loaded config (absolute `planPath`).
+     * @param issueName - The feature/issue name whose slug is matched.
+     * @returns The repo-relative plan path (e.g. `.hublaunch/plans/…md`), or null
+     *   when the repo has no plan files at all.
+     */
+    resolvePlan(repo: DiscoveredRepo, repoConfig: Config, issueName: string): string | null;
+    /**
+     * Append a group record to `.hublaunch/group-launches.json` in each member
+     * repo. Best-effort: a corrupt existing file is treated as empty and
+     * rewritten fresh; any write failure warns and is otherwise ignored (it must
+     * never fail the launch).
+     *
+     * @param repos - Repos whose local record file should receive the record.
+     * @param record - The group record to append.
+     */
+    recordGroup(repos: DiscoveredRepo[], record: GroupRecord): void;
+    /**
+     * Read the most recently recorded group id from the current repo's
+     * `.hublaunch/group-launches.json`. Used by a bare `--show-group` (no id).
+     *
+     * @param repoRoot - The repository root to read the record file from.
+     * @returns The latest group's id, or null when the file is absent/empty/corrupt.
+     */
+    latestRecordedGroupId(repoRoot: string): string | null;
+}
+/**
+ * Validate a user-supplied group id against the server's format rule. Returns
+ * the server's exact error wording on failure, or null when valid.
+ */
+export declare function validateGroupId(groupId: string): string | null;
+//# sourceMappingURL=GroupLaunchService.d.ts.map

package/dist/services/group/GroupLaunchService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GroupLaunchService.d.ts","sourceRoot":"","sources":["../../../src/services/group/GroupLaunchService.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAgBnD,qEAAqE;AACrE,eAAO,MAAM,cAAc,QAA0B,CAAC;AAEtD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB;;;OAGG;IACH,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,4DAA4D;AAC5D,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,kFAAkF;AAClF,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AAED,wEAAwE;AACxE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAY5B,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAElC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,uEAAuE;AACvE,eAAO,MAAM,4BAA4B,mCAAmC,CAAC;AAc7E;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE1D;AAmED;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B;;;;;;;;;;OAUG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc;IAmC7C;;;;;;;OAOG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAU1C;;;;;;;;;;;;;;OAcG;IACH,WAAW,CACT,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI;IAiBhB;;;;;;;;OAQG;IACH,WAAW,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI;IAgC/D;;;;;;OAMG;IACH,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAcvD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK9D"}

package/dist/services/group/GroupLaunchService.js

@@ -0,0 +1,282 @@
+import { randomBytes } from 'node:crypto';
+import { existsSync, readdirSync, readFileSync, statSync, writeFileSync, } from 'fs';
+import { join, relative } from 'path';
+import { z } from 'zod';
+import { logger } from '../../utils/logger.js';
+/**
+ * The three config-file names a repository may use, in preference order. Mirrors
+ * the triple-extension check in `src/index.ts` and `ConfigLoader`.
+ */
+const CONFIG_FILE_NAMES = [
+    'hublaunch.config.ts',
+    'hublaunch.config.mjs',
+    'hublaunch.config.js',
+];
+/** Maximum length of a generated/accepted group id (server-enforced). */
+const MAX_GROUP_ID_LENGTH = 64;
+/** The server's `groupId` validation regex (hula-server PR #505). */
+export const GROUP_ID_REGEX = /^[A-Za-z0-9_-]{1,64}$/;
+/** Zod schema for the on-disk `.hublaunch/group-launches.json` file. */
+export const GroupRecordSchema = z.object({
+    groupId: z.string(),
+    issueName: z.string(),
+    createdAt: z.string(),
+    folder: z.string(),
+    repos: z.array(z.object({
+        name: z.string(),
+        path: z.string(),
+        project: z.string(),
+    })),
+});
+export const GroupLaunchesFileSchema = z.object({
+    groups: z.array(GroupRecordSchema),
+});
+/** Relative path (from a repo root) of the local group-record file. */
+export const GROUP_LAUNCHES_RELATIVE_PATH = '.hublaunch/group-launches.json';
+/**
+ * Return the first existing `.hublaunch/hublaunch.config.{ts,mjs,js}` path in a
+ * directory, or null when none exists.
+ */
+function findConfigFile(dir) {
+    for (const name of CONFIG_FILE_NAMES) {
+        const p = join(dir, '.hublaunch', name);
+        if (existsSync(p))
+            return p;
+    }
+    return null;
+}
+/**
+ * Lowercase an issue name and replace every character outside `[A-Za-z0-9_-]`
+ * with a hyphen. Used both for group-id generation and plan-filename matching.
+ */
+export function slugifyIssueName(issueName) {
+    return issueName.toLowerCase().replace(/[^a-z0-9_-]/g, '-');
+}
+/**
+ * Extract the sortable `YYYY-MM-DD-HH:MM` timestamp prefix from a plan filename.
+ * Returns the prefix string (lexicographically sortable) or null when absent.
+ */
+function timestampPrefix(filename) {
+    const m = filename.match(/^(\d{4}-\d{2}-\d{2}-\d{2}:\d{2})/);
+    return m ? m[1] : null;
+}
+/**
+ * Recursively collect every `*.md` file under `dir`.
+ */
+function collectPlanFiles(dir) {
+    const out = [];
+    let entries;
+    try {
+        entries = readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return out;
+    }
+    for (const entry of entries) {
+        const full = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            out.push(...collectPlanFiles(full));
+        }
+        else if (entry.isFile() && entry.name.endsWith('.md')) {
+            let mtimeMs = 0;
+            try {
+                mtimeMs = statSync(full).mtimeMs;
+            }
+            catch {
+                mtimeMs = 0;
+            }
+            out.push({
+                absPath: full,
+                filename: entry.name,
+                prefix: timestampPrefix(entry.name),
+                mtimeMs,
+            });
+        }
+    }
+    return out;
+}
+/**
+ * Order two plan candidates newest-first: prefer the larger `YYYY-MM-DD-HH:MM`
+ * filename prefix; candidates without a prefix sort after those with one; ties
+ * fall back to mtime (newest first).
+ */
+function comparePlansNewestFirst(a, b) {
+    if (a.prefix && b.prefix) {
+        if (a.prefix !== b.prefix)
+            return a.prefix > b.prefix ? -1 : 1;
+        return b.mtimeMs - a.mtimeMs;
+    }
+    if (a.prefix && !b.prefix)
+        return -1;
+    if (!a.prefix && b.prefix)
+        return 1;
+    return b.mtimeMs - a.mtimeMs;
+}
+/**
+ * Service for the client-side multi-repo `--folder` fan-out: repository
+ * discovery, group-id generation, per-repo plan resolution, and local group
+ * record persistence. Deliberately free of network calls so it is trivially
+ * unit-testable.
+ */
+export class GroupLaunchService {
+    /**
+     * Discover every immediate subdirectory of `folder` that qualifies as a
+     * group-launchable repository — one that contains BOTH a `.git` entry and a
+     * `.hublaunch/hublaunch.config.{ts,mjs,js}` file. Discovery does not recurse
+     * deeper than one level. Non-qualifying subdirectories are returned in the
+     * `skipped` list with a reason ("no .git" / "no .hublaunch config").
+     *
+     * @param folder - Absolute or relative parent-folder path.
+     * @returns The qualifying repos, the skipped entries with reasons, and a
+     *   `folderIsRepo` flag set when `folder` is itself a git repo.
+     */
+    discoverRepos(folder) {
+        const repos = [];
+        const skipped = [];
+        const folderIsRepo = existsSync(join(folder, '.git'));
+        let entries;
+        try {
+            entries = readdirSync(folder, { withFileTypes: true });
+        }
+        catch (err) {
+            throw new Error(`Cannot read folder "${folder}": ${err instanceof Error ? err.message : String(err)}`);
+        }
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const dir = join(folder, entry.name);
+            const hasGit = existsSync(join(dir, '.git'));
+            const hasConfig = findConfigFile(dir) !== null;
+            if (hasGit && hasConfig) {
+                repos.push({ name: entry.name, path: dir });
+            }
+            else if (!hasGit) {
+                skipped.push({ name: entry.name, reason: 'no .git' });
+            }
+            else {
+                skipped.push({ name: entry.name, reason: 'no .hublaunch config' });
+            }
+        }
+        // Stable, deterministic discovery order (directory name).
+        repos.sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+        return { repos, skipped, folderIsRepo };
+    }
+    /**
+     * Generate a group id of the form `<slug>-<6 hex chars>` where `<slug>` is the
+     * slugified issue name, truncated so the full id is ≤ 64 characters. The hex
+     * suffix comes from `crypto.randomBytes(3)`.
+     *
+     * @param issueName - The feature/issue name.
+     * @returns A group id matching `^[A-Za-z0-9_-]{1,64}$`.
+     */
+    generateGroupId(issueName) {
+        const hex = randomBytes(3).toString('hex'); // 6 hex chars
+        const suffix = `-${hex}`;
+        const maxSlug = MAX_GROUP_ID_LENGTH - suffix.length;
+        let slug = slugifyIssueName(issueName).slice(0, Math.max(0, maxSlug));
+        // Avoid a leading/trailing bare hyphen pile-up while staying within regex.
+        if (slug === '')
+            slug = 'group';
+        return `${slug}${suffix}`;
+    }
+    /**
+     * Resolve the plan file to launch for a repository.
+     *
+     * Candidates are `*.md` files under the repo's configured plans directory
+     * (`repoConfig.planPath`), searched recursively. Preference order: the newest
+     * file (by `YYYY-MM-DD-HH:MM` filename prefix, falling back to mtime) whose
+     * filename contains the issue-name slug; if none match, the newest plan file
+     * overall.
+     *
+     * @param repo - The discovered repository.
+     * @param repoConfig - That repo's loaded config (absolute `planPath`).
+     * @param issueName - The feature/issue name whose slug is matched.
+     * @returns The repo-relative plan path (e.g. `.hublaunch/plans/…md`), or null
+     *   when the repo has no plan files at all.
+     */
+    resolvePlan(repo, repoConfig, issueName) {
+        const planDir = repoConfig.planPath;
+        const candidates = collectPlanFiles(planDir);
+        if (candidates.length === 0)
+            return null;
+        const slug = slugifyIssueName(issueName);
+        const matching = candidates.filter((c) => c.filename.toLowerCase().includes(slug));
+        const pool = matching.length > 0 ? matching : candidates;
+        pool.sort(comparePlansNewestFirst);
+        const chosen = pool[0];
+        // Return a repo-relative path for display and per-repo launching.
+        return relative(repo.path, chosen.absPath);
+    }
+    /**
+     * Append a group record to `.hublaunch/group-launches.json` in each member
+     * repo. Best-effort: a corrupt existing file is treated as empty and
+     * rewritten fresh; any write failure warns and is otherwise ignored (it must
+     * never fail the launch).
+     *
+     * @param repos - Repos whose local record file should receive the record.
+     * @param record - The group record to append.
+     */
+    recordGroup(repos, record) {
+        for (const repo of repos) {
+            const filePath = join(repo.path, GROUP_LAUNCHES_RELATIVE_PATH);
+            try {
+                let file = { groups: [] };
+                if (existsSync(filePath)) {
+                    try {
+                        const parsed = JSON.parse(readFileSync(filePath, 'utf-8'));
+                        const validated = GroupLaunchesFileSchema.safeParse(parsed);
+                        file = validated.success ? validated.data : { groups: [] };
+                        if (!validated.success) {
+                            logger.warning(`Group record at ${filePath} was unreadable — rewriting fresh.`);
+                        }
+                    }
+                    catch {
+                        logger.warning(`Group record at ${filePath} was corrupt — rewriting fresh.`);
+                        file = { groups: [] };
+                    }
+                }
+                file.groups.push(record);
+                writeFileSync(filePath, JSON.stringify(file, null, 2) + '\n', 'utf-8');
+            }
+            catch (err) {
+                logger.warning(`Could not write group record to ${filePath}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    }
+    /**
+     * Read the most recently recorded group id from the current repo's
+     * `.hublaunch/group-launches.json`. Used by a bare `--show-group` (no id).
+     *
+     * @param repoRoot - The repository root to read the record file from.
+     * @returns The latest group's id, or null when the file is absent/empty/corrupt.
+     */
+    latestRecordedGroupId(repoRoot) {
+        const filePath = join(repoRoot, GROUP_LAUNCHES_RELATIVE_PATH);
+        if (!existsSync(filePath))
+            return null;
+        try {
+            const parsed = JSON.parse(readFileSync(filePath, 'utf-8'));
+            const validated = GroupLaunchesFileSchema.safeParse(parsed);
+            if (!validated.success)
+                return null;
+            const groups = validated.data.groups;
+            if (groups.length === 0)
+                return null;
+            return groups[groups.length - 1].groupId;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+/**
+ * Validate a user-supplied group id against the server's format rule. Returns
+ * the server's exact error wording on failure, or null when valid.
+ */
+export function validateGroupId(groupId) {
+    if (!GROUP_ID_REGEX.test(groupId)) {
+        return 'Invalid groupId format. Expected 1-64 characters of letters, digits, hyphen, underscore.';
+    }
+    return null;
+}
+//# sourceMappingURL=GroupLaunchService.js.map

package/dist/services/group/GroupLaunchService.js.map

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

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

@@ -35,7 +35,7 @@ hula --version 2>/dev/null
 ```
 
 If initialized, `Read .hublaunch/hublaunch.config.js` and note (never print the values themselves, only presence/absence):
-- Is `hulaApiKey` (or `anthropicApiKey`/`daytonaApiKey`) present with a non-empty value? → user has likely completed `hula login`.
+- Is `hulaApiKey` (or `anthropicApiKey`) present with a non-empty value? → user has likely completed `hula login`.
 - If `.hublaunch/trackedPlans.json` exists, `Read` it — does it have any entries? → user has launched at least one plan before.
 
 If any check fails (not a git repo, config unreadable), treat that signal as unknown and continue — don't block on it.

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

@@ -2,7 +2,7 @@
 name: hula-launch
 description: "Launch a validated plan: creates the GitHub issue and starts the cloud run that ends in a verified PR (offered automatically after /hula-plan). Use when the user asks to launch a plan."
 disable-model-invocation: true
-argument-hint: <branch-name> [<plan-path>] [--handoff <username>] [--test] [--skip-regression] [--kill] [--kill-and-relaunch]
+argument-hint: <branch-name> [<plan-path>] [--handoff <username>] [--test] [--skip-regression] [--kill] [--kill-and-relaunch] [--folder <path>] [--group-id <id>] [--plan <repo>=<path>]
 allowed-tools: Bash Read
 ---
 
@@ -18,6 +18,11 @@ From `$ARGUMENTS`:
 - **--skip-regression** (optional): the bare flag `--skip-regression`, anywhere in `$ARGUMENTS`. Force-skips the regression-tests pipeline step for this one launch (overrides any `steps.regression.skip` config default).
 - **--kill** (optional): the bare flag `--kill`, anywhere in `$ARGUMENTS`. Stops the in-flight task for this branch name **without** relaunching. A plan path is **not** required with `--kill` — the branch name alone is enough.
 - **--kill-and-relaunch** (optional): the bare flag `--kill-and-relaunch`, anywhere in `$ARGUMENTS`. Cancels the in-flight task, resets stale state, and launches a fresh task (needs a plan path, like a normal launch).
+- **--folder** (optional): `--folder <path>`. Multi-repo mode — launches the feature in **every initialized repo directly under `<path>`** as one correlated feature group.
+  - ⚠️ **This `--folder` is DIFFERENT from `/hula-plan`'s `--folder`.** Here `<path>` is the **PARENT directory that contains sibling repos** (e.g. `~/code/myapp`, which holds `~/code/myapp/mobile` and `~/code/myapp/api`). In `/hula-plan`, `--folder <subfolder>` names a **plans subdirectory**. Never conflate the two.
+  - In folder mode the plan path is resolved **per repository** — do NOT pass a positional plan path. A single positional is the branch name.
+- **--group-id** (optional): `--group-id <id>`. Use an explicit group id instead of generating one (join/retry an existing group). Valid ids match `^[A-Za-z0-9_-]{1,64}$`.
+- **--plan** (optional, repeatable): `--plan <repo>=<path>`. Override the auto-resolved plan for one repo in `--folder` mode. `<repo>` is the discovered directory name; `<path>` is relative to that repo's root.
 
 `--kill` and `--kill-and-relaunch` are mutually exclusive; if the user passes both, stop with:
 ```
@@ -83,6 +88,22 @@ hula script launch-run -- <branch-name> --kill
 hula script launch-run -- <plan-path> <branch-name> --kill-and-relaunch
 ```
 
+**Launch a multi-repo feature group (`--folder`)** — pass only the branch name (no plan path); plans resolve per repo:
+```bash
+hula script launch-run -- <branch-name> --folder <parent-path>
+```
+
+**Override a repo's plan, or join/retry an existing group:**
+```bash
+hula script launch-run -- <branch-name> --folder <parent-path> --plan api=.hublaunch/plans/2026-08-10-11:00-login-api.md
+hula script launch-run -- <branch-name> --folder <parent-path> --group-id login-a3f9c1
+```
+
+**Stop every member's in-flight task (`--folder --kill`):**
+```bash
+hula script launch-run -- <branch-name> --folder <parent-path> --kill
+```
+
 ## Step 3: Show the result
 
 Parse the JSON output from the script:
@@ -97,6 +118,22 @@ Parse the JSON output from the script:
 
 The `cliOutput` already says whether a task was cancelled (`Cancelled '<branch>'`) or there was nothing to cancel (`No active task to cancel for '<branch>'`). Do **not** emit a `hula-issue` comment for a pure kill.
 
+- If `status` is `"success"` **and this was a `--folder` (feature-group) run** — indicated by a non-empty `folder` and a `groupId` — there is no single issue/PR. Display a group summary instead of the single-launch template:
+
+```
+✅ Launched feature group `<groupId>`
+
+<cliOutput>
+
+<!-- hula-group: <groupId> -->
+
+**Next Steps:**
+- Use `/hula-launch <branch-name> --show-group <groupId>` (or `hula launch --show-group <groupId>`) to see combined per-repo status
+- A failing member does not stop the others — the summary above lists ✓/✗ per repo and an exact retry command
+```
+
+The `cliOutput` already contains the per-repo roster, ✓/✗ summary, and any retry commands. Do **not** emit a `hula-issue` comment for a group launch (issue numbers are per-repo).
+
 - Otherwise (`status` is `"success"` with a non-empty `issueNumber` — a normal launch or `--kill-and-relaunch`), display:
 
 ```

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

@@ -257,9 +257,9 @@ If an identifier is empty, fall back to showing the `cliOutput` field.
 
 ## Important Notes
 
-- Do NOT pre-check credentials. The CLI resolves the Anthropic OAuth token,
-  Daytona key, and GitHub token from flags/config/env and reports a clear error
-  if any are missing; the wrappers surface it.
+- Do NOT pre-check credentials. The CLI resolves the Anthropic OAuth token and
+  GitHub token from flags/config/env and reports a clear error if any are
+  missing; the wrappers surface it.
 - Do NOT echo secrets.
 - Generated action files live under `.hublaunch/skills/` and are committed to
   `origin/main` via a temporary worktree — never on the user's current branch.

package/dist/utils/config-file-edit.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Pure/sync helpers for editing the `.hublaunch/hublaunch.config.js` source
+ * file as text. Kept side-effect free (no filesystem access) so the string
+ * transformations are unit-testable in isolation — same rationale as
+ * `appendGitignoreEntry` in `src/commands/init.ts`. Callers own reading and
+ * writing the file.
+ */
+/**
+ * Insert or replace the `anthropicApiKey` line in a config file's source text.
+ *
+ * Mirrors the comment-out-then-insert approach used by `saveApiKeyToConfig` in
+ * `src/commands/login.ts` for `hulaApiKey`:
+ *   - Any existing `anthropicApiKey:` line — whether active or commented out
+ *     (including the placeholder init writes) — is commented out.
+ *   - The new active line is inserted immediately after the config opening
+ *     (`export const config = {` or `export default {`).
+ *
+ * If no config opening is found the content is returned unchanged (the caller
+ * degrades gracefully rather than corrupting the file). Never echoes the key
+ * anywhere but the returned string.
+ */
+export declare function upsertAnthropicApiKey(content: string, key: string): string;
+//# sourceMappingURL=config-file-edit.d.ts.map

package/dist/utils/config-file-edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-file-edit.d.ts","sourceRoot":"","sources":["../../src/utils/config-file-edit.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAuB1E"}