@clipboard-health/groundcrew 3.1.2 → 3.1.4

package/dist/lib/config.js

@@ -173,11 +173,11 @@ function uniqueStrings(values) {
 function normalizeStatusName(value, fallback, path) {
     return normalizeOptionalString(value, path) ?? fallback;
 }
-function normalizeStatuses(user) {
-    const todo = normalizeStatusName(user?.todo, DEFAULT_STATUSES.todo, "linear.statuses.todo");
-    const inProgress = normalizeStatusName(user?.inProgress, DEFAULT_STATUSES.inProgress, "linear.statuses.inProgress");
-    const done = normalizeStatusName(user?.done, DEFAULT_STATUSES.done, "linear.statuses.done");
-    const terminal = normalizeOptionalStringArray(user?.terminal, "linear.statuses.terminal") ?? [];
+function normalizeStatuses(user, path) {
+    const todo = normalizeStatusName(user?.todo, DEFAULT_STATUSES.todo, `${path}.todo`);
+    const inProgress = normalizeStatusName(user?.inProgress, DEFAULT_STATUSES.inProgress, `${path}.inProgress`);
+    const done = normalizeStatusName(user?.done, DEFAULT_STATUSES.done, `${path}.done`);
+    const terminal = normalizeOptionalStringArray(user?.terminal, `${path}.terminal`) ?? [];
     return {
         todo,
         inProgress,
@@ -337,12 +337,83 @@ function requireObject(value, path) {
         fail(`${path} must be an object (got ${JSON.stringify(value)})`);
     }
 }
+function normalizeProject(value, index) {
+    const path = `linear.projects[${index}]`;
+    if (!isPlainObject(value)) {
+        fail(`${path} must be an object (got ${JSON.stringify(value)})`);
+    }
+    const { projectSlug, statuses } = value;
+    requireString(projectSlug, `${path}.projectSlug`);
+    const slugId = extractSlugId(projectSlug);
+    if (slugId === undefined) {
+        fail(`${path}.projectSlug must end with a 12-character hex slugId (got ${JSON.stringify(projectSlug)}). Copy the trailing segment from your Linear project URL, e.g. "ai-strategy-5152195762f3" from "https://linear.app/<workspace>/project/ai-strategy-5152195762f3".`);
+    }
+    if (statuses !== undefined && !isPlainObject(statuses)) {
+        fail(`${path}.statuses must be an object`);
+    }
+    return {
+        projectSlug,
+        slugId,
+        statuses: normalizeStatuses(statuses, `${path}.statuses`),
+    };
+}
+function failOnLegacyLinearShape(user) {
+    const { linear } = user;
+    if (!isPlainObject(linear)) {
+        return;
+    }
+    if (!Object.hasOwn(linear, "projectSlug") && !Object.hasOwn(linear, "statuses")) {
+        return;
+    }
+    const legacySlug = linear["projectSlug"];
+    const { projects } = linear;
+    const firstProject = Array.isArray(projects) ? projects[0] : undefined;
+    const migratedSlug = isPlainObject(firstProject) && typeof firstProject["projectSlug"] === "string"
+        ? firstProject["projectSlug"]
+        : undefined;
+    let slugLiteral = `"your-project-name-0123456789ab"`;
+    if (typeof legacySlug === "string") {
+        slugLiteral = JSON.stringify(legacySlug);
+    }
+    else if (migratedSlug !== undefined) {
+        slugLiteral = JSON.stringify(migratedSlug);
+    }
+    const statusesBlock = isPlainObject(linear["statuses"])
+        ? `, statuses: ${JSON.stringify(linear["statuses"])}`
+        : "";
+    fail([
+        "linear.projectSlug / linear.statuses are no longer supported — wrap them in linear.projects[].",
+        "Migrate by replacing your `linear` block with:",
+        `  linear: { projects: [{ projectSlug: ${slugLiteral}${statusesBlock} }] }`,
+        "See crew.config.example.ts for the multi-project shape.",
+    ].join("\n"));
+}
+function normalizeProjects(linear) {
+    const { projects } = linear;
+    if (!Array.isArray(projects)) {
+        fail("linear.projects must be a non-empty array");
+    }
+    if (projects.length === 0) {
+        fail("linear.projects must be a non-empty array");
+    }
+    const resolved = projects.map((entry, index) => normalizeProject(entry, index));
+    const seen = new Map();
+    resolved.forEach((project, index) => {
+        const previous = seen.get(project.slugId);
+        if (previous !== undefined) {
+            fail(`linear.projects[${index}].projectSlug duplicates the slugId "${project.slugId}" already used by linear.projects[${previous}]`);
+        }
+        seen.set(project.slugId, index);
+    });
+    return resolved;
+}
 function applyDefaults(user) {
     // Guard the top-level shape before reading nested fields, so a
     // malformed runtime config produces a `groundcrew config: ...` error
     // instead of a raw `TypeError: Cannot read properties of undefined`.
+    // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- `user` is loosely typed input from the loader; we narrow with requireObject below
+    failOnLegacyLinearShape(user);
     requireObject(user.linear, "linear");
-    requireString(user.linear.projectSlug, "linear.projectSlug");
     requireObject(user.workspace, "workspace");
     if (isPlainObject(user.models) && Object.hasOwn(user.models, "isolation")) {
         fail("models.isolation is no longer supported: set `local.runner` ('safehouse' | 'sdx' | 'none' | 'auto') instead");
@@ -354,16 +425,10 @@ function applyDefaults(user) {
     if (userLocal !== undefined && !isPlainObject(userLocal)) {
         fail("local must be an object");
     }
-    const slugId = extractSlugId(user.linear.projectSlug);
-    if (slugId === undefined) {
-        fail(`linear.projectSlug must end with a 12-character hex slugId (got ${JSON.stringify(user.linear.projectSlug)}). Copy the trailing segment from your Linear project URL, e.g. "ai-strategy-5152195762f3" from "https://linear.app/<workspace>/project/ai-strategy-5152195762f3".`);
-    }
+    // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- runtime fields validated by normalizeProjects below
+    const projects = normalizeProjects(user.linear);
     return {
-        linear: {
-            projectSlug: user.linear.projectSlug,
-            slugId,
-            statuses: normalizeStatuses(user.linear.statuses),
-        },
+        linear: { projects },
         git: { ...DEFAULT_GIT, ...user.git },
         workspace: {
             projectDir: expandHome(user.workspace.projectDir),
@@ -394,13 +459,20 @@ function validatePromptPlaceholders(template) {
     }
 }
 function validate(config) {
-    requireString(config.linear.projectSlug, "linear.projectSlug");
-    requireString(config.linear.slugId, "linear.slugId");
-    requireString(config.linear.statuses.todo, "linear.statuses.todo");
-    requireString(config.linear.statuses.inProgress, "linear.statuses.inProgress");
-    requireString(config.linear.statuses.done, "linear.statuses.done");
-    config.linear.statuses.terminal.forEach((status, index) => {
-        requireString(status, `linear.statuses.terminal[${index}]`);
+    /* v8 ignore next 3 @preserve -- normalizeProjects already enforces non-empty; belt-and-suspenders */
+    if (config.linear.projects.length === 0) {
+        fail("linear.projects must be a non-empty array");
+    }
+    config.linear.projects.forEach((project, index) => {
+        const path = `linear.projects[${index}]`;
+        requireString(project.projectSlug, `${path}.projectSlug`);
+        requireString(project.slugId, `${path}.slugId`);
+        requireString(project.statuses.todo, `${path}.statuses.todo`);
+        requireString(project.statuses.inProgress, `${path}.statuses.inProgress`);
+        requireString(project.statuses.done, `${path}.statuses.done`);
+        project.statuses.terminal.forEach((status, terminalIndex) => {
+            requireString(status, `${path}.statuses.terminal[${terminalIndex}]`);
+        });
     });
     requireString(config.git.remote, "git.remote");
     requireString(config.git.defaultBranch, "git.defaultBranch");
@@ -539,6 +611,42 @@ async function discoverUserConfig() {
     // terminating statement; it doesn't track `fail()`'s `never` return.
     throw new Error(`groundcrew config: no crew config found. Create crew.config.ts in your project root, or ${xdgConfigPath("groundcrew", "crew.config.ts")}, or set GROUNDCREW_CONFIG.`);
 }
+/**
+ * Returns the resolved project the issue belongs to, or `undefined` when
+ * its slugId isn't in `linear.projects[]`. Callers in the dispatcher
+ * path expect a project to always exist (the board fetch only surfaces
+ * issues from configured projects); callers in the manual-ticket path
+ * (`setupWorkspace`, `ticketDoctor`) use this to detect off-config
+ * tickets and surface a clear error.
+ */
+export function findProjectBySlugId(config, slugId) {
+    return config.linear.projects.find((project) => project.slugId === slugId);
+}
+// Memoize per-config so blocker checks (called per blocker per tick) don't
+// rebuild the same Set on every call. The resolved config is frozen and
+// long-lived, so the WeakMap key is stable.
+const terminalUnionCache = new WeakMap();
+/**
+ * Union of every terminal status name configured across all watched
+ * projects. Used for blocker terminal checks when the blocker belongs
+ * to a project we don't watch — matches today's single-project "is the
+ * status terminal under any configured project?" behavior so off-config
+ * blockers don't regress.
+ */
+export function unionTerminalStatuses(config) {
+    const cached_ = terminalUnionCache.get(config);
+    if (cached_ !== undefined) {
+        return cached_;
+    }
+    const set = new Set();
+    for (const project of config.linear.projects) {
+        for (const status of project.statuses.terminal) {
+            set.add(status);
+        }
+    }
+    terminalUnionCache.set(config, set);
+    return set;
+}
 let cached;
 export async function loadConfig() {
     if (cached) {

package/dist/lib/linearIssueStatus.d.ts

@@ -1,9 +1,11 @@
 import type { LinearClient } from "@linear/sdk";
-import type { ResolvedConfig } from "./config.ts";
+import { type ResolvedConfig } from "./config.ts";
 interface LinearIssueReference {
     id: string;
     uuid: string;
     teamId: string;
+    /** SlugId of the issue's Linear project — selects which `inProgress` name to look up on the team's workflow. */
+    projectSlugId: string;
 }
 interface LinearIssueStatusUpdater {
     markInProgress(issue: LinearIssueReference): Promise<void>;

package/dist/lib/linearIssueStatus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"linearIssueStatus.d.ts","sourceRoot":"","sources":["../../src/lib/linearIssueStatus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,UAAU,oBAAoB;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,wBAAwB;IAChC,cAAc,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,2BAA2B,IAAI,IAAI,CAAC;CACrC;AAED,wBAAgB,8BAA8B,CAAC,UAAU,EAAE;IACzD,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;CACtB,GAAG,wBAAwB,CAgD3B"}
+{"version":3,"file":"linearIssueStatus.d.ts","sourceRoot":"","sources":["../../src/lib/linearIssueStatus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAGvE,UAAU,oBAAoB;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,gHAAgH;IAChH,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,wBAAwB;IAChC,cAAc,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,2BAA2B,IAAI,IAAI,CAAC;CACrC;AAQD,wBAAgB,8BAA8B,CAAC,UAAU,EAAE;IACzD,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;CACtB,GAAG,wBAAwB,CA+D3B"}

package/dist/lib/runState.d.ts

@@ -0,0 +1,46 @@
+import type { ResolvedConfig } from "./config.ts";
+export type RunLifecycleState = "running" | "interrupted" | "resumed" | "failed-to-launch";
+export interface RunState {
+    ticket: string;
+    repository: string;
+    model: string;
+    worktreeDir: string;
+    branchName: string;
+    workspaceName: string;
+    state: RunLifecycleState;
+    createdAt: string;
+    updatedAt: string;
+    resumeCount: number;
+    reason?: string;
+    detail?: string;
+}
+export interface RunStateDraft {
+    ticket: string;
+    repository: string;
+    model: string;
+    worktreeDir: string;
+    branchName: string;
+    workspaceName: string;
+    state: RunLifecycleState;
+    reason?: string;
+    detail?: string;
+    resumeCount?: number;
+}
+export interface RecordRunStateInput {
+    config: ResolvedConfig;
+    state: RunStateDraft;
+}
+export interface UpdateRunStateInput {
+    config: ResolvedConfig;
+    ticket: string;
+    patch: Partial<Omit<RunState, "createdAt" | "ticket">> & {
+        state: RunLifecycleState;
+    };
+}
+export declare function runStateDirectory(config: Pick<ResolvedConfig, "logging">): string;
+export declare function runStatePath(config: Pick<ResolvedConfig, "logging">, ticket: string): string;
+export declare function readRunState(config: ResolvedConfig, ticket: string): RunState | undefined;
+export declare function recordRunState(input: RecordRunStateInput): RunState;
+export declare function updateRunState(input: UpdateRunStateInput): RunState | undefined;
+export declare function removeRunState(config: ResolvedConfig, ticket: string): void;
+//# sourceMappingURL=runState.d.ts.map

package/dist/lib/runState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runState.d.ts","sourceRoot":"","sources":["../../src/lib/runState.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,GAAG,kBAAkB,CAAC;AAE3F,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,iBAAiB,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,GAAG,QAAQ,CAAC,CAAC,GAAG;QACvD,KAAK,EAAE,iBAAiB,CAAC;KAC1B,CAAC;CACH;AAaD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,GAAG,MAAM,CAEjF;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE5F;AA+ED,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAYzF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,QAAQ,CAmBnE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,QAAQ,GAAG,SAAS,CAc/E;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAE3E"}

package/dist/lib/runState.js

@@ -0,0 +1,137 @@
+import { mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+const TICKET_RE = /^[a-z][\da-z]*-\d+$/;
+const RUN_STATE_DIRECTORY_NAME = "runs";
+function ticketKey(ticket) {
+    const normalized = ticket.toLowerCase();
+    if (!TICKET_RE.test(normalized)) {
+        throw new Error(`Invalid ticket "${ticket}": must be a plain ticket id`);
+    }
+    return normalized;
+}
+export function runStateDirectory(config) {
+    return resolve(dirname(config.logging.file), RUN_STATE_DIRECTORY_NAME);
+}
+export function runStatePath(config, ticket) {
+    return resolve(runStateDirectory(config), `${ticketKey(ticket)}.json`);
+}
+function nowIso() {
+    return new Date().toISOString();
+}
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function stringField(value, key) {
+    const field = value[key];
+    return typeof field === "string" && field.length > 0 ? field : undefined;
+}
+function isRunLifecycleState(value) {
+    return (value === "running" ||
+        value === "interrupted" ||
+        value === "resumed" ||
+        value === "failed-to-launch");
+}
+function parseRunState(value) {
+    if (!isPlainObject(value)) {
+        return undefined;
+    }
+    const ticket = stringField(value, "ticket");
+    const repository = stringField(value, "repository");
+    const model = stringField(value, "model");
+    const worktreeDir = stringField(value, "worktreeDir");
+    const branchName = stringField(value, "branchName");
+    const workspaceName = stringField(value, "workspaceName");
+    const { state, resumeCount } = value;
+    const createdAt = stringField(value, "createdAt");
+    const updatedAt = stringField(value, "updatedAt");
+    const reason = stringField(value, "reason");
+    const detail = stringField(value, "detail");
+    if (ticket === undefined ||
+        repository === undefined ||
+        model === undefined ||
+        worktreeDir === undefined ||
+        branchName === undefined ||
+        workspaceName === undefined ||
+        !isRunLifecycleState(state) ||
+        createdAt === undefined ||
+        updatedAt === undefined ||
+        typeof resumeCount !== "number" ||
+        !Number.isInteger(resumeCount) ||
+        resumeCount < 0) {
+        return undefined;
+    }
+    return {
+        ticket,
+        repository,
+        model,
+        worktreeDir,
+        branchName,
+        workspaceName,
+        state,
+        createdAt,
+        updatedAt,
+        resumeCount,
+        ...(reason === undefined ? {} : { reason }),
+        ...(detail === undefined ? {} : { detail }),
+    };
+}
+function writeState(config, state) {
+    const path = runStatePath(config, state.ticket);
+    mkdirSync(dirname(path), { recursive: true });
+    const tmpPath = `${path}.${process.pid}.tmp`;
+    writeFileSync(tmpPath, `${JSON.stringify(state, undefined, 2)}\n`, { mode: 0o600 });
+    renameSync(tmpPath, path);
+}
+export function readRunState(config, ticket) {
+    let raw;
+    try {
+        raw = readFileSync(runStatePath(config, ticket), "utf8");
+    }
+    catch {
+        return undefined;
+    }
+    try {
+        return parseRunState(JSON.parse(raw));
+    }
+    catch {
+        return undefined;
+    }
+}
+export function recordRunState(input) {
+    const existing = readRunState(input.config, input.state.ticket);
+    const timestamp = nowIso();
+    const state = {
+        ticket: ticketKey(input.state.ticket),
+        repository: input.state.repository,
+        model: input.state.model,
+        worktreeDir: input.state.worktreeDir,
+        branchName: input.state.branchName,
+        workspaceName: input.state.workspaceName,
+        state: input.state.state,
+        createdAt: existing?.createdAt ?? timestamp,
+        updatedAt: timestamp,
+        resumeCount: input.state.resumeCount ?? existing?.resumeCount ?? 0,
+        ...(input.state.reason === undefined ? {} : { reason: input.state.reason }),
+        ...(input.state.detail === undefined ? {} : { detail: input.state.detail }),
+    };
+    writeState(input.config, state);
+    return state;
+}
+export function updateRunState(input) {
+    const existing = readRunState(input.config, input.ticket);
+    if (existing === undefined) {
+        return undefined;
+    }
+    const state = {
+        ...existing,
+        ...input.patch,
+        ticket: existing.ticket,
+        createdAt: existing.createdAt,
+        updatedAt: nowIso(),
+    };
+    writeState(input.config, state);
+    return state;
+}
+export function removeRunState(config, ticket) {
+    rmSync(runStatePath(config, ticket), { force: true });
+}

package/dist/lib/runStateCleanup.d.ts

@@ -0,0 +1,4 @@
+import type { ResolvedConfig } from "./config.ts";
+import type { WorktreeEntry } from "./worktrees.ts";
+export declare function recordCleanedUpRuns(config: ResolvedConfig, entries: readonly WorktreeEntry[]): void;
+//# sourceMappingURL=runStateCleanup.d.ts.map

package/dist/lib/runStateCleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runStateCleanup.d.ts","sourceRoot":"","sources":["../../src/lib/runStateCleanup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,SAAS,aAAa,EAAE,GAChC,IAAI,CAQN"}

package/dist/lib/runStateCleanup.js

@@ -0,0 +1,12 @@
+import { removeRunState } from "./runState.js";
+import { errorMessage, log } from "./util.js";
+export function recordCleanedUpRuns(config, entries) {
+    for (const entry of entries) {
+        try {
+            removeRunState(config, entry.ticket);
+        }
+        catch (error) {
+            log(`Run state cleanup failed for ${entry.ticket}: ${errorMessage(error)}`);
+        }
+    }
+}

package/dist/lib/stagedLaunch.d.ts

@@ -0,0 +1,32 @@
+import { type ResolvedConfig } from "./config.ts";
+export interface StagedPrompt {
+    directory: string;
+    file: string;
+}
+interface PromptTemplateVariables {
+    ticket: string;
+    worktree: string;
+    title: string;
+    description: string;
+}
+export declare function stagePromptText(input: {
+    prefix: string;
+    ticket: string;
+    text: string;
+}): StagedPrompt;
+export declare function stagePromptFromTemplate(input: {
+    config: ResolvedConfig;
+    prefix: string;
+    ticket: string;
+    variables: PromptTemplateVariables;
+}): StagedPrompt;
+/**
+ * Stage a `KEY='value'` env file for any populated build-time secret so
+ * the launch command can source it. Returns `undefined` when groundcrew
+ * has nothing to forward, leaving the launch command unchanged.
+ */
+export declare function stageBuildSecrets(promptDir: string): string | undefined;
+export declare function stageWorkspaceLaunchCommand(promptDir: string, command: string): string;
+export declare function removeStagedPrompt(directory: string): void;
+export {};
+//# sourceMappingURL=stagedLaunch.d.ts.map

package/dist/lib/stagedLaunch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stagedLaunch.d.ts","sourceRoot":"","sources":["../../src/lib/stagedLaunch.ts"],"names":[],"mappings":"AAIA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAItE,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,uBAAuB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAUD,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,YAAY,CAKf;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,uBAAuB,CAAC;CACpC,GAAG,YAAY,CAMf;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAevE;AAQD,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtF;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAE1D"}

package/dist/lib/stagedLaunch.js

@@ -0,0 +1,58 @@
+import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { BUILD_SECRET_NAMES } from "./config.js";
+import { shellSingleQuote } from "./launchCommand.js";
+import { readEnvironmentVariable } from "./util.js";
+function renderPromptTemplate(template, variables) {
+    return template
+        .replaceAll("{{ticket}}", variables.ticket)
+        .replaceAll("{{worktree}}", variables.worktree)
+        .replaceAll("{{title}}", variables.title)
+        .replaceAll("{{description}}", variables.description);
+}
+export function stagePromptText(input) {
+    const promptDir = mkdtempSync(join(tmpdir(), `${input.prefix}-${input.ticket}-`));
+    const promptFile = join(promptDir, "prompt.txt");
+    writeFileSync(promptFile, input.text);
+    return { directory: promptDir, file: promptFile };
+}
+export function stagePromptFromTemplate(input) {
+    return stagePromptText({
+        prefix: input.prefix,
+        ticket: input.ticket,
+        text: renderPromptTemplate(input.config.prompts.initial, input.variables),
+    });
+}
+/**
+ * Stage a `KEY='value'` env file for any populated build-time secret so
+ * the launch command can source it. Returns `undefined` when groundcrew
+ * has nothing to forward, leaving the launch command unchanged.
+ */
+export function stageBuildSecrets(promptDir) {
+    const lines = [];
+    for (const name of BUILD_SECRET_NAMES) {
+        const value = readEnvironmentVariable(name);
+        if (value === undefined || value.length === 0) {
+            continue;
+        }
+        lines.push(`${name}=${shellSingleQuote(value)}`);
+    }
+    if (lines.length === 0) {
+        return undefined;
+    }
+    const secretsFile = join(promptDir, "secrets.env");
+    writeFileSync(secretsFile, `${lines.join("\n")}\n`, { mode: 0o600 });
+    return secretsFile;
+}
+function stageLaunchScript(promptDir, command) {
+    const launcherFile = join(promptDir, "launch.sh");
+    writeFileSync(launcherFile, `#!/usr/bin/env bash\n${command}\n`, { mode: 0o700 });
+    return launcherFile;
+}
+export function stageWorkspaceLaunchCommand(promptDir, command) {
+    return `bash ${shellSingleQuote(stageLaunchScript(promptDir, command))}`;
+}
+export function removeStagedPrompt(directory) {
+    rmSync(directory, { recursive: true, force: true });
+}

package/dist/lib/util.d.ts

@@ -2,7 +2,6 @@ import { LinearClient } from "@linear/sdk";
 export declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;
 export declare function writeOutput(message?: string): void;
 export declare function writeError(message: string): void;
-export declare function clearOutput(): void;
 export declare function setLogFile(path: string | undefined): void;
 export declare function log(message: string): void;
 type LogEventFieldValue = boolean | number | string | readonly string[] | undefined;

package/dist/lib/util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/lib/util.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,wBAAsB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB3E;AAED,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAIlD;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAGhD;AAED,wBAAgB,WAAW,IAAI,IAAI,CAGlC;AAOD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAEzD;AAkBD,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAKzC;AAED,KAAK,kBAAkB,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;AAUpF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,IAAI,CAWxF;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGxE;AAED,QAAA,MAAM,sBAAsB,YAAI,2BAA2B,EAAE,gBAAgB,CAAU,CAAC;AAExF,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzE,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,kBAAkB,CAAC;CAC5B;AAED,wBAAgB,mBAAmB,IAAI,oBAAoB,GAAG,SAAS,CAQtE;AAED,wBAAgB,eAAe,IAAI,YAAY,CAQ9C;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,YAAY,GAAG,MAAM,YAAY,CAMhF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAMzF;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAcnD"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/lib/util.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,wBAAsB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB3E;AAED,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAIlD;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAGhD;AAOD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAEzD;AAkBD,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAKzC;AAED,KAAK,kBAAkB,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;AAUpF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,IAAI,CAWxF;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGxE;AAED,QAAA,MAAM,sBAAsB,YAAI,2BAA2B,EAAE,gBAAgB,CAAU,CAAC;AAExF,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzE,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,kBAAkB,CAAC;CAC5B;AAED,wBAAgB,mBAAmB,IAAI,oBAAoB,GAAG,SAAS,CAQtE;AAED,wBAAgB,eAAe,IAAI,YAAY,CAQ9C;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,YAAY,GAAG,MAAM,YAAY,CAMhF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAMzF;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAcnD"}

package/dist/lib/util.js

@@ -31,10 +31,6 @@ export function writeError(message) {
     // oxlint-disable-next-line no-console -- Centralized CLI stderr writer.
     console.error(message);
 }
-export function clearOutput() {
-    // oxlint-disable-next-line no-console -- Centralized CLI screen clear.
-    console.clear();
-}
 // Module-scoped sink for tee-ing log()/logEvent() to disk. Unset by default
 // so tests don't write to the host filesystem; the CLI arms it after
 // loadConfig() resolves `logging.file`.

package/dist/lib/workspaces.d.ts

@@ -41,6 +41,22 @@ export type WorkspaceProbe = {
     kind: "unavailable";
     error?: unknown;
 };
+export type WorkspaceInterruptResult = {
+    kind: "interrupted";
+} | {
+    kind: "missing";
+} | {
+    kind: "unavailable";
+    error?: unknown;
+};
+export type WorkspaceCloseResult = {
+    kind: "closed";
+} | {
+    kind: "missing";
+} | {
+    kind: "unavailable";
+    error?: unknown;
+};
 export interface WorkspaceResolution {
     requested: WorkspaceKindSetting;
     resolved: WorkspaceKind;
@@ -53,10 +69,12 @@ interface ResolveArguments {
 }
 export declare function resolveWorkspaceKind(arguments_: ResolveArguments): WorkspaceResolution;
 declare function probeWorkspaces(config: ResolvedConfig, signal?: AbortSignal): Promise<WorkspaceProbe>;
+declare function interruptWorkspace(config: ResolvedConfig, name: string, signal?: AbortSignal): Promise<WorkspaceInterruptResult>;
 export declare const workspaces: {
     open(config: ResolvedConfig, spec: OpenSpec, signal?: AbortSignal): Promise<void>;
     probe: typeof probeWorkspaces;
-    close(config: ResolvedConfig, name: string, signal?: AbortSignal): Promise<void>;
+    close(config: ResolvedConfig, name: string, signal?: AbortSignal): Promise<WorkspaceCloseResult>;
+    interrupt: typeof interruptWorkspace;
     accessHint(config: ResolvedConfig, name: string, signal?: AbortSignal): Promise<WorkspaceAccessHint | undefined>;
 };
 export {};

package/dist/lib/workspaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspaces.d.ts","sourceRoot":"","sources":["../../src/lib/workspaces.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAI1E,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,CAAC;AAE5C,MAAM,WAAW,SAAS;IACxB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAsU7C,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,oBAAoB,CAAC;IAChC,QAAQ,EAAE,aAAa,CAAC;IACxB,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,gBAAgB;IACxB,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,gBAAgB,GAAG,mBAAmB,CAUtF;AA+ND,iBAAe,eAAe,CAC5B,MAAM,EAAE,cAAc,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,CAAC,CAezB;AAED,eAAO,MAAM,UAAU;IACf,IAAI,SAAS,cAAc,QAAQ,QAAQ,WAAW,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvF,KAAK;IACC,KAAK,SAAS,cAAc,QAAQ,MAAM,WAAW,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhF,UAAU,SACN,cAAc,QAChB,MAAM,WACH,WAAW,GACnB,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC;CAI5C,CAAC"}
+{"version":3,"file":"workspaces.d.ts","sourceRoot":"","sources":["../../src/lib/workspaces.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAI1E,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,CAAC;AAE5C,MAAM,WAAW,SAAS;IACxB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAE7C,MAAM,MAAM,wBAAwB,GAChC;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAE7C,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAwU7C,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,oBAAoB,CAAC;IAChC,QAAQ,EAAE,aAAa,CAAC;IACxB,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,gBAAgB;IACxB,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,gBAAgB,GAAG,mBAAmB,CAUtF;AAgOD,iBAAe,eAAe,CAC5B,MAAM,EAAE,cAAc,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,CAAC,CAezB;AAED,iBAAe,kBAAkB,CAC/B,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,wBAAwB,CAAC,CAenC;AAED,eAAO,MAAM,UAAU;IACf,IAAI,SAAS,cAAc,QAAQ,QAAQ,WAAW,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvF,KAAK;IACC,KAAK,SACD,cAAc,QAChB,MAAM,WACH,WAAW,GACnB,OAAO,CAAC,oBAAoB,CAAC;IAIhC,SAAS;IACH,UAAU,SACN,cAAc,QAChB,MAAM,WACH,WAAW,GACnB,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC;CAI5C,CAAC"}