@clipboard-health/groundcrew 3.1.2 → 3.1.3

package/dist/commands/ticketDoctor.d.ts

@@ -1,5 +1,6 @@
 import { type Blocker, type RawLinearIssue } from "../lib/boardSource.ts";
 import { type ResolvedConfig } from "../lib/config.ts";
+import { type RunState } from "../lib/runState.ts";
 import { type UsageByModel } from "../lib/usage.ts";
 import { type WorkspaceAccessHint, type WorkspaceProbe } from "../lib/workspaces.ts";
 import { type WorktreeDirtiness, type WorktreeEntry } from "../lib/worktrees.ts";
@@ -12,6 +13,14 @@ export type TicketDoctorVerdict = {
     kind: "pr-merged";
     number: number;
     url: string;
+} | {
+    kind: "interrupted";
+    reason: string;
+    nextStep: string;
+} | {
+    kind: "failed-launch";
+    reason: string;
+    nextStep: string;
 } | {
     kind: "in-flight";
     reason: string;
@@ -99,15 +108,18 @@ export interface DecideVerdictInput {
     branch: string;
     worktreeDir: string | undefined;
     workspaceName: string | undefined;
+    runState: RunState | undefined;
 }
 /**
  * Returns a post-dispatch verdict if the probe bundle matches one of the
  * "ticket has moved past dispatch" cases. Returns `undefined` otherwise,
  * signalling that the caller should fall through to the pre-dispatch path.
  *
- * Precedence: PR > in-flight > recoverable. Inside `recoverable`, dirty
- * worktree beats clean-with-un-pushed-local beats remote-only beats stranded
- * local.
+ * Precedence: PR verdicts always win. Failed launches report before ordinary
+ * local recovery. Interrupted runs report concrete recoverable git work first
+ * when it exists, then fall back to `interrupted`. Ordinary post-dispatch cases
+ * report in-flight before recoverable. Inside `recoverable`, dirty worktree
+ * beats clean-with-un-pushed-local beats remote-only beats stranded local.
  */
 export declare function decidePostDispatchVerdict(input: DecideVerdictInput): TicketDoctorVerdict | undefined;
 export interface TicketDoctorDependencies {
@@ -147,6 +159,7 @@ export interface TicketDoctorDependencies {
         repoDir: string;
         branch: string;
     }) => Promise<PullRequestProbe>;
+    readRunState: (ticket: string) => RunState | undefined;
     doFetch: boolean;
 }
 export interface TicketDoctorResult {
@@ -154,6 +167,7 @@ export interface TicketDoctorResult {
     title?: string;
     resolution: TicketCheck[];
     eligibility: TicketCheck[];
+    runState: TicketCheck[];
     worktree: TicketCheck[];
     workspace: TicketCheck[];
     localBranch: TicketCheck[];
@@ -163,6 +177,7 @@ export interface TicketDoctorResult {
         resolution: string;
         eligibility: string;
         worktree: string;
+        runState: string;
         workspace: string;
         localBranch: string;
         remoteBranch: string;

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

@@ -1 +1 @@
-{"version":3,"file":"ticketDoctor.d.ts","sourceRoot":"","sources":["../../src/commands/ticketDoctor.ts"],"names":[],"mappings":"AAiBA,OAAO,EAML,KAAK,OAAO,EAEZ,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAA+B,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEpF,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAErE,OAAO,EAAc,KAAK,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACjG,OAAO,EAAa,KAAK,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAO5F,OAAO,EAAyC,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAW3F,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAC1B;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAErC,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7C,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GACzB;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,2BAA2B,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEvB,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1E;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAExC,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAExC,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAExC,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,QAAQ,EAAE,aAAa,CAAC;IACxB,WAAW,EAAE,gBAAgB,CAAC;IAC9B,YAAY,EAAE,iBAAiB,CAAC;IAChC,WAAW,EAAE,gBAAgB,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAqED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,kBAAkB,GACxB,mBAAmB,GAAG,SAAS,CAQjC;AAID,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,aAAa,EAAE,CAAC,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC,GAAG,SAAS,CAAC;IACpF,gBAAgB,EAAE,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC;IAC3F,UAAU,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;IACxC,eAAe,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,aAAa,GAAG,SAAS,CAAC;IAC5D,eAAe,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;IAC/C,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAAC;IAChF,gBAAgB,EAAE,CAAC,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACjF,gBAAgB,EAAE,CAAC,KAAK,EAAE;QACxB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,EAAE,MAAM,CAAC;KACvB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAChC,iBAAiB,EAAE,CAAC,KAAK,EAAE;QACzB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,OAAO,CAAC;KAClB,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACjC,gBAAgB,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC5F,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,WAAW,EAAE,CAAC;IAC1B,WAAW,EAAE,WAAW,EAAE,CAAC;IAC3B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,WAAW,EAAE,WAAW,EAAE,CAAC;IAC3B,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,WAAW,EAAE,WAAW,EAAE,CAAC;IAC3B,WAAW,EAAE;QACX,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,OAAO,EAAE,mBAAmB,CAAC;CAC9B;AA+mBD;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,YAAY,EAAE,wBAAwB,GACrC,OAAO,CAAC,kBAAkB,CAAC,CA6I7B;AAkCD,UAAU,qBAAqB;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAe9F;AAmCD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAuD7E;AAGD,wBAAsB,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,CAmCrF"}
+{"version":3,"file":"ticketDoctor.d.ts","sourceRoot":"","sources":["../../src/commands/ticketDoctor.ts"],"names":[],"mappings":"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"}

package/dist/commands/ticketDoctor.js

@@ -3,11 +3,14 @@
 // `crew doctor --ticket <TICKET>` — single per-ticket diagnostic that covers
 // both the pre-dispatch question ("will this dispatch on the next tick?") and
 // the post-dispatch question ("what's already happened and what's left to
-// do?"). Verdict precedence runs strictly from post-dispatch states down:
+// do?"). Verdict precedence starts with PR outcomes, then handles run-state
+// exceptions before ordinary local recovery:
 //
-//   pr-open > pr-merged > in-flight > recoverable
-//     > unresolvable > ineligible > would-dispatch
-//       > lost
+//   pr-open > pr-merged
+//     > failed-launch
+//     > interrupted (unless concrete recoverable git work exists)
+//     > in-flight > recoverable
+//     > unresolvable > ineligible > would-dispatch > lost
 //
 // When a post-dispatch verdict fires, the Resolution and Eligibility sections
 // are skipped — they describe pre-dispatch state that no longer matters.
@@ -17,6 +20,7 @@ import { fetchBlockersForTicket, fetchInProgressIssueCount, fetchRawLinearIssue,
 import { runCommandAsync } from "../lib/commandRunner.js";
 import { AGENT_ANY_MODEL, loadConfig } from "../lib/config.js";
 import { which } from "../lib/host.js";
+import { readRunState } from "../lib/runState.js";
 import { getUsageByModel } from "../lib/usage.js";
 import { getLinearClient, lazyLinearClient, writeOutput } from "../lib/util.js";
 import { workspaces } from "../lib/workspaces.js";
@@ -91,9 +95,11 @@ function verdictRecoverable(input) {
  * "ticket has moved past dispatch" cases. Returns `undefined` otherwise,
  * signalling that the caller should fall through to the pre-dispatch path.
  *
- * Precedence: PR > in-flight > recoverable. Inside `recoverable`, dirty
- * worktree beats clean-with-un-pushed-local beats remote-only beats stranded
- * local.
+ * Precedence: PR verdicts always win. Failed launches report before ordinary
+ * local recovery. Interrupted runs report concrete recoverable git work first
+ * when it exists, then fall back to `interrupted`. Ordinary post-dispatch cases
+ * report in-flight before recoverable. Inside `recoverable`, dirty worktree
+ * beats clean-with-un-pushed-local beats remote-only beats stranded local.
  */
 export function decidePostDispatchVerdict(input) {
     if (input.pullRequest.kind === "open") {
@@ -102,13 +108,34 @@ export function decidePostDispatchVerdict(input) {
     if (input.pullRequest.kind === "merged") {
         return { kind: "pr-merged", number: input.pullRequest.number, url: input.pullRequest.url };
     }
-    return verdictInFlight(input) ?? verdictRecoverable(input);
+    const recoverable = verdictRecoverable(input);
+    if (input.runState?.state === "interrupted") {
+        if (recoverable !== undefined) {
+            return recoverable;
+        }
+        const detail = input.runState.reason ?? input.runState.detail ?? "workspace stopped";
+        return {
+            kind: "interrupted",
+            reason: detail,
+            nextStep: `run \`crew resume ${input.runState.ticket}\` or inspect ${input.runState.worktreeDir}`,
+        };
+    }
+    if (input.runState?.state === "failed-to-launch") {
+        const detail = input.runState.detail ?? "workspace launch failed";
+        return {
+            kind: "failed-launch",
+            reason: detail,
+            nextStep: `fix the launch failure, then run \`crew resume ${input.runState.ticket}\` or \`crew cleanup ${input.runState.ticket}\``,
+        };
+    }
+    return verdictInFlight(input) ?? recoverable;
 }
 function emptySkipReasons() {
     return {
         resolution: "",
         eligibility: "",
         worktree: "",
+        runState: "",
         workspace: "",
         localBranch: "",
         remoteBranch: "",
@@ -376,6 +403,29 @@ async function probeLinear(deps, upperTicket) {
         };
     }
 }
+function probeRunStateSection(deps, ticket) {
+    const state = deps.readRunState(ticket);
+    if (state === undefined) {
+        return {
+            checks: [{ name: "Local run state", status: "skipped", detail: "none found" }],
+            state: undefined,
+        };
+    }
+    const checks = [
+        { name: "Local run state", status: "ok", detail: state.state },
+        { name: "Recorded model", status: "ok", detail: state.model },
+        { name: "Recorded worktree", status: "ok", detail: state.worktreeDir },
+        { name: "Recorded branch", status: "ok", detail: state.branchName },
+        { name: "Resume count", status: "ok", detail: String(state.resumeCount) },
+    ];
+    if (state.reason !== undefined) {
+        checks.push({ name: "Last reason", status: "ok", detail: state.reason });
+    }
+    if (state.detail !== undefined) {
+        checks.push({ name: "Last detail", status: "ok", detail: state.detail });
+    }
+    return { checks, state };
+}
 async function probeWorktreeSection(deps, ticket) {
     const entry = deps.findWorktree(ticket);
     if (entry === undefined) {
@@ -615,6 +665,7 @@ export async function ticketDoctor(dependencies) {
     const skipReasons = emptySkipReasons();
     const linearResult = await probeLinear(dependencies, upperTicket);
     const resolution = [...linearResult.resolution];
+    const runStateResult = probeRunStateSection(dependencies, lowerTicket);
     const worktreeResult = await probeWorktreeSection(dependencies, lowerTicket);
     const workspaceResult = await probeWorkspaceSection(dependencies, lowerTicket);
     const localResult = await probeLocalBranchSection(dependencies, worktreeResult.entry);
@@ -638,6 +689,7 @@ export async function ticketDoctor(dependencies) {
         branch: worktreeResult.entry?.branchName ?? lowerTicket,
         worktreeDir: worktreeResult.entry?.dir,
         workspaceName: workspaceResult.workspaceName,
+        runState: runStateResult.state,
     });
     if (postVerdict !== undefined) {
         skipReasons.resolution = "post-dispatch — pre-dispatch checks are irrelevant";
@@ -647,6 +699,7 @@ export async function ticketDoctor(dependencies) {
             title: linearResult.title,
             resolution,
             eligibility: [],
+            runStateResult,
             worktreeResult,
             workspaceResult,
             localResult,
@@ -667,6 +720,7 @@ export async function ticketDoctor(dependencies) {
             title: linearResult.title,
             resolution,
             eligibility: [],
+            runStateResult,
             worktreeResult,
             workspaceResult,
             localResult,
@@ -687,6 +741,7 @@ export async function ticketDoctor(dependencies) {
             title: linearResult.title,
             resolution,
             eligibility: [],
+            runStateResult,
             worktreeResult,
             workspaceResult,
             localResult,
@@ -725,6 +780,7 @@ export async function ticketDoctor(dependencies) {
         title: linearResult.title,
         resolution,
         eligibility: preDispatch.eligibility,
+        runStateResult,
         worktreeResult,
         workspaceResult,
         localResult,
@@ -740,6 +796,7 @@ function buildResult(input) {
         ...(input.title === undefined ? {} : { title: input.title }),
         resolution: input.resolution,
         eligibility: input.eligibility,
+        runState: input.runStateResult.checks,
         worktree: input.worktreeResult.checks,
         workspace: input.workspaceResult.checks,
         localBranch: input.localResult.checks,
@@ -778,6 +835,12 @@ function formatVerdict(verdict) {
         case "pr-merged": {
             return `→ pr-merged: ${verdict.url} (#${verdict.number})`;
         }
+        case "interrupted": {
+            return `→ interrupted: ${verdict.reason}; ${verdict.nextStep}`;
+        }
+        case "failed-launch": {
+            return `→ failed-launch: ${verdict.reason}; ${verdict.nextStep}`;
+        }
         case "in-flight": {
             return `→ in-flight: ${verdict.reason}`;
         }
@@ -818,6 +881,11 @@ export function renderTicketDoctorResult(result) {
                 ? {}
                 : { skipReason: result.skipReasons.eligibility }),
         },
+        {
+            name: "Run state",
+            checks: result.runState,
+            ...(result.skipReasons.runState === "" ? {} : { skipReason: result.skipReasons.runState }),
+        },
         {
             name: "Worktree",
             checks: result.worktree,
@@ -879,6 +947,7 @@ export async function runTicketDoctor(parsed) {
         probeLocalBranch: probeLocalBranchImpl,
         probeRemoteBranch: probeRemoteBranchImpl,
         probePullRequest: probePullRequestImpl,
+        readRunState: (ticket) => readRunState(config, ticket),
         doFetch: parsed.doFetch,
     });
     for (const line of renderTicketDoctorResult(result)) {

package/dist/index.d.ts

@@ -1,10 +1,13 @@
 export { run } from "./cli.ts";
 export { cleanupWorkspace, type CleanupWorkspaceOptions } from "./commands/cleanupWorkspace.ts";
 export { doctor } from "./commands/doctor.ts";
+export { interruptWorkspace, type InterruptWorkspaceOptions, } from "./commands/interruptWorkspace.ts";
 export { orchestrate, type OrchestratorOptions } from "./commands/orchestrator.ts";
+export { resumeWorkspace, type ResumeWorkspaceOptions } from "./commands/resumeWorkspace.ts";
 export { setupWorkspace, type SetupWorkspaceOptions } from "./commands/setupWorkspace.ts";
 export type { Config, ModelDefinition, ResolvedConfig } from "./lib/config.ts";
 export { loadConfig } from "./lib/config.ts";
+export { readRunState, recordRunState, removeRunState, runStateDirectory, runStatePath, updateRunState, type RunLifecycleState, type RunState, } from "./lib/runState.ts";
 export { fetchBlockersForTicket, fetchInProgressIssueCount, fetchRawLinearIssue, fetchResolvedIssue, resolveModelFor, resolveRepositoryFor, type ModelResolution, type RawLinearIssue, type RepositoryResolution, } from "./lib/boardSource.ts";
 export { getUsageByModel, type UsageByModel } from "./lib/usage.ts";
 export type { TicketCheck } from "./commands/ticketCheck.ts";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAChG,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,KAAK,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1F,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACpE,YAAY,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EACL,YAAY,EACZ,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAChG,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,GAC/B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,KAAK,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1F,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EACL,YAAY,EACZ,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,KAAK,iBAAiB,EACtB,KAAK,QAAQ,GACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACpE,YAAY,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EACL,YAAY,EACZ,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -1,9 +1,12 @@
 export { run } from "./cli.js";
 export { cleanupWorkspace } from "./commands/cleanupWorkspace.js";
 export { doctor } from "./commands/doctor.js";
+export { interruptWorkspace, } from "./commands/interruptWorkspace.js";
 export { orchestrate } from "./commands/orchestrator.js";
+export { resumeWorkspace } from "./commands/resumeWorkspace.js";
 export { setupWorkspace } from "./commands/setupWorkspace.js";
 export { loadConfig } from "./lib/config.js";
+export { readRunState, recordRunState, removeRunState, runStateDirectory, runStatePath, updateRunState, } from "./lib/runState.js";
 export { fetchBlockersForTicket, fetchInProgressIssueCount, fetchRawLinearIssue, fetchResolvedIssue, resolveModelFor, resolveRepositoryFor, } from "./lib/boardSource.js";
 export { getUsageByModel } from "./lib/usage.js";
 export { ticketDoctor, } from "./commands/ticketDoctor.js";

package/dist/lib/agentLaunch.d.ts

@@ -0,0 +1,29 @@
+import type { LocalRunner, ModelDefinition, ResolvedConfig } from "./config.ts";
+interface PreparedAgentLaunch {
+    runner: LocalRunner;
+    sandboxName: string | undefined;
+}
+export declare function prepareAgentLaunch(input: {
+    config: ResolvedConfig;
+    model: string;
+    definition: ModelDefinition;
+    purpose: "runs" | "resumes";
+    signal?: AbortSignal;
+}): Promise<PreparedAgentLaunch>;
+export declare function ensureAgentSandbox(input: {
+    config: ResolvedConfig;
+    definition: ModelDefinition;
+    sandboxName: string | undefined;
+    signal?: AbortSignal;
+}): Promise<void>;
+export declare function openAgentWorkspace(input: {
+    config: ResolvedConfig;
+    name: string;
+    cwd: string;
+    command: string;
+    model: string;
+    color: string;
+    signal?: AbortSignal;
+}): Promise<void>;
+export {};
+//# sourceMappingURL=agentLaunch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agentLaunch.d.ts","sourceRoot":"","sources":["../../src/lib/agentLaunch.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAOhF,UAAU,mBAAmB;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,eAAe,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA6B/B;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,EAAE,eAAe,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAWhB;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhB"}

package/dist/lib/agentLaunch.js

@@ -0,0 +1,53 @@
+import { resolve } from "node:path";
+import { ensureClearance } from "@clipboard-health/clearance";
+import { ensureSandbox, sandboxNameFor } from "./dockerSandbox.js";
+import { detectHostCapabilities } from "./host.js";
+import { assertLocalRunnerRequirements, resolveLocalRunner } from "./localRunner.js";
+import { log, sleep } from "./util.js";
+import { workspaces } from "./workspaces.js";
+export async function prepareAgentLaunch(input) {
+    const host = await detectHostCapabilities(input.signal);
+    const runner = resolveLocalRunner(input.config.local.runner, host);
+    assertLocalRunnerRequirements(host, runner);
+    if (runner === "safehouse") {
+        await ensureClearance({
+            logger: log,
+            ...(input.signal === undefined
+                ? {}
+                : {
+                    sleep: async (ms) => {
+                        await sleep(ms, input.signal);
+                        input.signal?.throwIfAborted();
+                    },
+                }),
+        });
+        input.signal?.throwIfAborted();
+    }
+    if (runner === "sdx" && input.definition.sandbox === undefined) {
+        throw new Error(`Local groundcrew ${input.purpose} with the sdx runner require a sandbox config on model '${input.model}'.`);
+    }
+    const sandboxName = runner === "sdx" && input.definition.sandbox !== undefined
+        ? sandboxNameFor({ agent: input.definition.sandbox.agent })
+        : undefined;
+    return { runner, sandboxName };
+}
+export async function ensureAgentSandbox(input) {
+    if (input.sandboxName !== undefined && input.definition.sandbox !== undefined) {
+        await ensureSandbox({
+            sandboxName: input.sandboxName,
+            sandbox: input.definition.sandbox,
+            mountPath: resolve(input.config.workspace.projectDir),
+        }, input.signal);
+    }
+}
+export async function openAgentWorkspace(input) {
+    const spec = {
+        name: input.name,
+        cwd: input.cwd,
+        command: input.command,
+        status: { text: input.model, color: input.color, icon: "sparkle" },
+    };
+    await (input.signal === undefined
+        ? workspaces.open(input.config, spec)
+        : workspaces.open(input.config, spec, input.signal));
+}

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"}