@clipboard-health/groundcrew 4.2.0 → 4.2.2

package/dist/commands/resumeWorkspace.js

@@ -1,10 +1,11 @@
-import { fetchResolvedIssue } from "../lib/boardSource.js";
+import { fetchResolvedIssue } from "../lib/adapters/linear/fetch.js";
+import { getLinearClient } from "../lib/adapters/linear/client.js";
 import { loadConfig } from "../lib/config.js";
 import { openAgentWorkspace, prepareAgentLaunch } from "../lib/agentLaunch.js";
 import { buildLaunchCommand } from "../lib/launchCommand.js";
 import { readRunState, recordRunState } from "../lib/runState.js";
 import { removeStagedPrompt, stageBuildSecrets, stagePromptText, stageWorkspaceLaunchCommand, } from "../lib/stagedLaunch.js";
-import { errorMessage, getLinearClient, log } from "../lib/util.js";
+import { errorMessage, log } from "../lib/util.js";
 import { workspaces } from "../lib/workspaces.js";
 import { worktrees } from "../lib/worktrees.js";
 function parseArguments(argv) {

package/dist/commands/setupWorkspace.d.ts

@@ -1,5 +1,5 @@
 import { type ResolvedConfig } from "../lib/config.ts";
-interface TicketDetails {
+export interface TicketDetails {
     title: string;
     description: string;
 }
@@ -7,8 +7,7 @@ export interface SetupWorkspaceOptions {
     ticket: string;
     repository: string;
     model: string;
-    /** When provided, skip the Linear lookup for prompt-template fields. */
-    details?: TicketDetails;
+    details: TicketDetails;
 }
 export interface SetupWorkspaceRunOptions {
     signal?: AbortSignal;
@@ -17,5 +16,4 @@ export declare function setupWorkspace(config: ResolvedConfig, options: SetupWor
 export declare function setupWorkspaceCli(ticket: string, options?: {
     dryRun?: boolean;
 }): Promise<void>;
-export {};
 //# sourceMappingURL=setupWorkspace.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"setupWorkspace.d.ts","sourceRoot":"","sources":["../../src/commands/setupWorkspace.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAenE,UAAU,aAAa;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAWD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAqBD,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,qBAAqB,EAC9B,UAAU,GAAE,wBAA6B,GACxC,OAAO,CAAC,IAAI,CAAC,CAsGf;AAwHD,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,OAAO,CAAC,IAAI,CAAC,CAoBf"}
+{"version":3,"file":"setupWorkspace.d.ts","sourceRoot":"","sources":["../../src/commands/setupWorkspace.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAiBnE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAqBD,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,qBAAqB,EAC9B,UAAU,GAAE,wBAA6B,GACxC,OAAO,CAAC,IAAI,CAAC,CAgGf;AAwHD,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,OAAO,CAAC,IAAI,CAAC,CAwCf"}

package/dist/commands/setupWorkspace.js

@@ -1,22 +1,15 @@
 import { rmSync } from "node:fs";
-import { fetchResolvedIssue } from "../lib/boardSource.js";
 import { loadConfig } from "../lib/config.js";
 import { openAgentWorkspace, prepareAgentLaunch } from "../lib/agentLaunch.js";
+import { createBoard } from "../lib/board.js";
+import { buildSources, sourcesFromConfig } from "../lib/buildSources.js";
 import { buildLaunchCommand } from "../lib/launchCommand.js";
-import { createLinearIssueStatusUpdater } from "../lib/linearIssueStatus.js";
 import { recordRunState } from "../lib/runState.js";
 import { stageBuildSecrets, stagePromptFromTemplate, stageWorkspaceLaunchCommand, } from "../lib/stagedLaunch.js";
-import { errorMessage, getLinearClient, log } from "../lib/util.js";
+import { naturalIdFromCanonical } from "../lib/ticketSource.js";
+import { errorMessage, log } from "../lib/util.js";
 import { workspaces } from "../lib/workspaces.js";
 import { isWorktreeAlreadyExistsError, worktrees } from "../lib/worktrees.js";
-async function fetchTicket(ticket) {
-    const client = getLinearClient();
-    const issue = await client.issue(ticket.toUpperCase());
-    return {
-        title: issue.title,
-        description: issue.description ?? "",
-    };
-}
 function stagePrompt(input) {
     return stagePromptFromTemplate({
         config: input.config,
@@ -69,14 +62,7 @@ export async function setupWorkspace(config, options, runOptions = {}) {
     // the ticket strands forever.
     let promptDir;
     try {
-        let ticketDetails;
-        if (options.details === undefined) {
-            log(`Fetching ${ticket} from Linear...`);
-            ticketDetails = await fetchTicket(ticket);
-        }
-        else {
-            ticketDetails = options.details;
-        }
+        const ticketDetails = options.details;
         const stagedPrompt = stagePrompt({ config, ticket, ticketDetails, worktreeName });
         promptDir = stagedPrompt.directory;
         const secretsFile = stageBuildSecrets(promptDir);
@@ -218,22 +204,36 @@ async function rollbackWorktree(arguments_) {
 }
 export async function setupWorkspaceCli(ticket, options = {}) {
     const config = await loadConfig();
-    const client = getLinearClient();
-    const resolved = await fetchResolvedIssue({ client, config, ticket });
+    let sources;
+    try {
+        sources = await buildSources(sourcesFromConfig(config), { globalConfig: config });
+    }
+    catch (error) {
+        /* v8 ignore next @preserve -- catch re-throw always receives an Error; String(error) is an unreachable fallback */
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Could not initialize ticket sources for 'crew setup ${ticket}': ${message}`, {
+            cause: error,
+        });
+    }
+    const board = createBoard(sources);
+    const resolved = await board.resolveOne(ticket);
+    if (resolved === undefined) {
+        throw new Error(`Ticket ${ticket} not found across configured sources.`);
+    }
+    if (resolved.repository === undefined || resolved.model === undefined) {
+        throw new Error(`Ticket ${ticket} resolved but isn't groundcrew-eligible (missing agent-* label or repository/model).`);
+    }
     log(`Resolved ${ticket}: repository=${resolved.repository}, model=${resolved.model}`);
     if (options.dryRun === true) {
         log(`[dry-run] Would launch ${ticket} in ${resolved.repository} (${resolved.model})`);
         return;
     }
+    const naturalId = naturalIdFromCanonical(resolved.id);
     await setupWorkspace(config, {
-        ticket: ticket.toLowerCase(),
+        ticket: naturalId,
         repository: resolved.repository,
         model: resolved.model,
         details: { title: resolved.title, description: resolved.description },
     });
-    await createLinearIssueStatusUpdater({ client }).markInProgress({
-        id: ticket.toLowerCase(),
-        uuid: resolved.uuid,
-        teamId: resolved.teamId,
-    });
+    await board.markInProgress(resolved);
 }

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

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAGA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAWnE,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAuLD,wBAAsB,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAU/F;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAI7D"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAIA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAMnE,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAyLD,wBAAsB,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAU/F;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAI7D"}

package/dist/commands/status.js

@@ -1,8 +1,9 @@
 import { readFileSync } from "node:fs";
-import { fetchRawLinearIssue } from "../lib/boardSource.js";
+import { getLinearClient } from "../lib/adapters/linear/client.js";
+import { fetchRawLinearIssue } from "../lib/adapters/linear/fetch.js";
 import { loadConfig } from "../lib/config.js";
 import { readRunState } from "../lib/runState.js";
-import { errorMessage, getLinearClient, withLogOutputSuppressed, writeOutput, } from "../lib/util.js";
+import { errorMessage, withLogOutputSuppressed, writeOutput } from "../lib/util.js";
 import { workspaces } from "../lib/workspaces.js";
 import { worktrees } from "../lib/worktrees.js";
 const RECENT_LOG_LINE_COUNT = 10;
@@ -95,7 +96,9 @@ function recentTicketLogLines(config, ticket) {
 async function linearStatus(ticket) {
     try {
         const issue = await fetchRawLinearIssue({ client: getLinearClient(), ticket });
-        return `${issue.stateName} (state.type=${issue.stateType ?? "unknown"}) — ${issue.title}`;
+        // `stateType` is "" when Linear returned a stateless ticket; surface that
+        // as "unknown" rather than an empty token.
+        return `${issue.stateName} (state.type=${issue.stateType || "unknown"}) — ${issue.title}`;
     }
     catch (error) {
         return `unavailable: ${errorMessage(error)}`;

package/dist/index.d.ts

@@ -9,11 +9,12 @@ export { status, type StatusOptions } from "./commands/status.ts";
 export type { Config, ModelDefinition, ResolvedConfig, SourceConfig } 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, isIssueInProgress, isIssueTodo, isTerminalStateType, isTerminalStatusForBlocker, isTerminalStatusForIssue, resolveModelFor, resolveRepositoryFor, type ModelResolution, type RawLinearIssue, type RepositoryResolution, } from "./lib/boardSource.ts";
+export { fetchBlockersForTicket, fetchInProgressIssueCount, fetchRawLinearIssue, fetchResolvedIssue, isIssueInProgress, isIssueTodo, isTerminalStateType, isTerminalStatusForBlocker, isTerminalStatusForIssue, type RawLinearIssue, } from "./lib/adapters/linear/fetch.ts";
+export { resolveModelFor, resolveRepositoryFor, type ModelResolution, type RepositoryResolution, } from "./lib/adapters/linear/parsing.ts";
 export { getUsageByModel, type UsageByModel } from "./lib/usage.ts";
 export { type Board, createBoard } from "./lib/board.ts";
 export { buildSources, buildSourcesWith } from "./lib/buildSources.ts";
 export type { AdapterContext, AdapterDefinition } from "./lib/adapterDefinition.ts";
 export { adapterRegistry, type AdapterLoader, buildRegistry, buildSourceConfigSchema, listAdapterDirectories, } from "./lib/adapters/registry.ts";
-export { AmbiguousTicketError, type Blocker as CanonicalBlocker, type BoardState as CanonicalBoardState, type CanonicalStatus, type GroundcrewIssue as CanonicalGroundcrewIssue, type Issue as CanonicalIssue, isGroundcrewIssue as isCanonicalGroundcrewIssue, type TicketSource, } from "./lib/ticketSource.ts";
+export { AmbiguousTicketError, type Blocker as CanonicalBlocker, type BoardState as CanonicalBoardState, type CanonicalStatus, type GroundcrewIssue as CanonicalGroundcrewIssue, type Issue as CanonicalIssue, isGroundcrewIssue as isCanonicalGroundcrewIssue, type ParentSkip as CanonicalParentSkip, type TicketSource, } from "./lib/ticketSource.ts";
 //# sourceMappingURL=index.d.ts.map

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,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,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAClE,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC7F,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,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EACnB,0BAA0B,EAC1B,wBAAwB,EACxB,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,OAAO,EAAE,KAAK,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,EACL,eAAe,EACf,KAAK,aAAa,EAClB,aAAa,EACb,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,oBAAoB,EACpB,KAAK,OAAO,IAAI,gBAAgB,EAChC,KAAK,UAAU,IAAI,mBAAmB,EACtC,KAAK,eAAe,EACpB,KAAK,eAAe,IAAI,wBAAwB,EAChD,KAAK,KAAK,IAAI,cAAc,EAC5B,iBAAiB,IAAI,0BAA0B,EAC/C,KAAK,YAAY,GAClB,MAAM,uBAAuB,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,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAClE,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC7F,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,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EACnB,0BAA0B,EAC1B,wBAAwB,EACxB,KAAK,cAAc,GACpB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,oBAAoB,GAC1B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,KAAK,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,EACL,eAAe,EACf,KAAK,aAAa,EAClB,aAAa,EACb,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,oBAAoB,EACpB,KAAK,OAAO,IAAI,gBAAgB,EAChC,KAAK,UAAU,IAAI,mBAAmB,EACtC,KAAK,eAAe,EACpB,KAAK,eAAe,IAAI,wBAAwB,EAChD,KAAK,KAAK,IAAI,cAAc,EAC5B,iBAAiB,IAAI,0BAA0B,EAC/C,KAAK,UAAU,IAAI,mBAAmB,EACtC,KAAK,YAAY,GAClB,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -8,10 +8,10 @@ export { setupWorkspace } from "./commands/setupWorkspace.js";
 export { status } from "./commands/status.js";
 export { loadConfig } from "./lib/config.js";
 export { readRunState, recordRunState, removeRunState, runStateDirectory, runStatePath, updateRunState, } from "./lib/runState.js";
-export { fetchBlockersForTicket, fetchInProgressIssueCount, fetchRawLinearIssue, fetchResolvedIssue, isIssueInProgress, isIssueTodo, isTerminalStateType, isTerminalStatusForBlocker, isTerminalStatusForIssue, resolveModelFor, resolveRepositoryFor, } from "./lib/boardSource.js";
+export { fetchBlockersForTicket, fetchInProgressIssueCount, fetchRawLinearIssue, fetchResolvedIssue, isIssueInProgress, isIssueTodo, isTerminalStateType, isTerminalStatusForBlocker, isTerminalStatusForIssue, } from "./lib/adapters/linear/fetch.js";
+export { resolveModelFor, resolveRepositoryFor, } from "./lib/adapters/linear/parsing.js";
 export { getUsageByModel } from "./lib/usage.js";
 export { createBoard } from "./lib/board.js";
 export { buildSources, buildSourcesWith } from "./lib/buildSources.js";
 export { adapterRegistry, buildRegistry, buildSourceConfigSchema, listAdapterDirectories, } from "./lib/adapters/registry.js";
 export { AmbiguousTicketError, isGroundcrewIssue as isCanonicalGroundcrewIssue, } from "./lib/ticketSource.js";
-// RepositoryResolutionError is exported via boardSource.ts above (single canonical location).

package/dist/lib/adapters/linear/client.d.ts

@@ -0,0 +1,22 @@
+import { LinearClient } from "@linear/sdk";
+declare const LINEAR_API_KEY_SOURCES: readonly ["GROUNDCREW_LINEAR_API_KEY", "LINEAR_API_KEY"];
+export type LinearApiKeySource = (typeof LINEAR_API_KEY_SOURCES)[number];
+export interface ResolvedLinearApiKey {
+    value: string;
+    source: LinearApiKeySource;
+}
+export declare function resolveLinearApiKey(): ResolvedLinearApiKey | undefined;
+export declare function getLinearClient(): LinearClient;
+/**
+ * Returns a zero-arg getter that lazily constructs (and caches) a Linear
+ * client on first call. Used by CLI entry points that may not need the
+ * client at all (e.g. `--no-linear`), so we avoid blowing up on a missing
+ * API key when no Linear call is actually made. The factory is taken as a
+ * parameter (rather than calling `getLinearClient` directly) so callers can
+ * pass their own module-level import of `getLinearClient` — that binding
+ * respects `vi.mock` intercepts, whereas an intra-module reference would
+ * not.
+ */
+export declare function lazyLinearClient(factory: () => LinearClient): () => LinearClient;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/lib/adapters/linear/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/linear/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,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"}

package/dist/lib/adapters/linear/client.js

@@ -0,0 +1,36 @@
+import { LinearClient } from "@linear/sdk";
+import { readEnvironmentVariable } from "../../util.js";
+const LINEAR_API_KEY_SOURCES = ["GROUNDCREW_LINEAR_API_KEY", "LINEAR_API_KEY"];
+export function resolveLinearApiKey() {
+    for (const source of LINEAR_API_KEY_SOURCES) {
+        const value = readEnvironmentVariable(source);
+        if (value !== undefined && value.length > 0) {
+            return { value, source };
+        }
+    }
+    return undefined;
+}
+export function getLinearClient() {
+    const resolved = resolveLinearApiKey();
+    if (resolved === undefined) {
+        throw new Error("Linear API key not set. Set GROUNDCREW_LINEAR_API_KEY or LINEAR_API_KEY in your environment.");
+    }
+    return new LinearClient({ apiKey: resolved.value });
+}
+/**
+ * Returns a zero-arg getter that lazily constructs (and caches) a Linear
+ * client on first call. Used by CLI entry points that may not need the
+ * client at all (e.g. `--no-linear`), so we avoid blowing up on a missing
+ * API key when no Linear call is actually made. The factory is taken as a
+ * parameter (rather than calling `getLinearClient` directly) so callers can
+ * pass their own module-level import of `getLinearClient` — that binding
+ * respects `vi.mock` intercepts, whereas an intra-module reference would
+ * not.
+ */
+export function lazyLinearClient(factory) {
+    let client;
+    return () => {
+        client ??= factory();
+        return client;
+    };
+}

package/dist/lib/adapters/linear/factory.d.ts

@@ -1,23 +1,33 @@
 /**
- * Linear `TicketSource` factory. Wraps the existing boardSource.ts machinery
- * (createBoardSource, fetchResolvedIssue, createLinearIssueStatusUpdater) and
- * converts the Linear-native `Issue`/`Blocker` shapes into the canonical
- * `Issue`/`Blocker` shapes consumers (via `Board`) speak.
+ * Linear `TicketSource` factory. Assembles the adapter from sibling modules
+ * (createBoardSource + fetchResolvedIssue from ./fetch.ts;
+ * createLinearIssueStatusUpdater from ./writeback.ts; getLinearClient from
+ * ./client.ts) and converts Linear-specific shapes into the canonical
+ * Issue/Blocker types consumers (via Board) speak.
  *
- * Status mapping is driven entirely by Linear's workflow `state.type`
- * (`unstarted` → todo, `started` → in-progress,
- * `completed`/`canceled`/`duplicate` → done) so renamed columns are classified
- * correctly without any per-team config.
+ * State classification is driven by Linear's workflow `state.type` — never
+ * by status name — so workspaces with renamed columns Just Work without
+ * per-team config.
  *
- * Description is not populated on `fetch()` Issues (boardSource's snapshot
- * doesn't include it); `resolveOne()` Issues carry the full description
- * because `fetchResolvedIssue` fetches it explicitly.
+ * Description is populated on both `fetch()` Issues and `resolveOne()` Issues.
  */
 import type { AdapterContext } from "../../adapterDefinition.ts";
-import { type Issue as LinearIssue } from "../../boardSource.ts";
-import type { CanonicalStatus, Issue as CanonicalIssue, TicketSource } from "../../ticketSource.ts";
+import { type Issue as CanonicalIssue, type TicketSource } from "../../ticketSource.ts";
 import type { LinearAdapterConfig } from "./schema.ts";
-export declare function canonicalStatusFromStateType(stateType: string | undefined): CanonicalStatus;
+import { type Issue as LinearIssue } from "./fetch.ts";
+/**
+ * Adapter-private payload threaded through `Issue.sourceRef`. Consumers
+ * MUST NOT inspect; only the Linear adapter reads it.
+ */
+export interface LinearSourceRef {
+    uuid: string;
+    statusId: string;
+    teamId: string;
+    /** Linear workflow `state.type` for the issue at fetch time. */
+    stateType: string;
+    /** Human-readable native status name, e.g. "In Progress", "Shipped". Diagnostic display only. */
+    nativeStatus: string;
+}
 export declare function toCanonicalIssue(linearIssue: LinearIssue, sourceName: string): CanonicalIssue;
 export declare function createLinearTicketSource(config: LinearAdapterConfig, context: AdapterContext): TicketSource;
 //# sourceMappingURL=factory.d.ts.map

package/dist/lib/adapters/linear/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/linear/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAIL,KAAK,KAAK,IAAI,WAAW,EAE1B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAEV,eAAe,EACf,KAAK,IAAI,cAAc,EACvB,YAAY,EACb,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AASvD,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,eAAe,CAW3F;AAUD,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc,CAsB7F;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,cAAc,GACtB,YAAY,CA6Dd"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/linear/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAIL,KAAK,KAAK,IAAI,cAAc,EAE5B,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EAKL,KAAK,KAAK,IAAI,WAAW,EAE1B,MAAM,YAAY,CAAC;AAGpB;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,iGAAiG;IACjG,YAAY,EAAE,MAAM,CAAC;CACtB;AAkFD,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc,CAsB7F;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,cAAc,GACtB,YAAY,CA+Ed"}

package/dist/lib/adapters/linear/factory.js

@@ -1,38 +1,90 @@
 /**
- * Linear `TicketSource` factory. Wraps the existing boardSource.ts machinery
- * (createBoardSource, fetchResolvedIssue, createLinearIssueStatusUpdater) and
- * converts the Linear-native `Issue`/`Blocker` shapes into the canonical
- * `Issue`/`Blocker` shapes consumers (via `Board`) speak.
+ * Linear `TicketSource` factory. Assembles the adapter from sibling modules
+ * (createBoardSource + fetchResolvedIssue from ./fetch.ts;
+ * createLinearIssueStatusUpdater from ./writeback.ts; getLinearClient from
+ * ./client.ts) and converts Linear-specific shapes into the canonical
+ * Issue/Blocker types consumers (via Board) speak.
  *
- * Status mapping is driven entirely by Linear's workflow `state.type`
- * (`unstarted` → todo, `started` → in-progress,
- * `completed`/`canceled`/`duplicate` → done) so renamed columns are classified
- * correctly without any per-team config.
+ * State classification is driven by Linear's workflow `state.type` — never
+ * by status name — so workspaces with renamed columns Just Work without
+ * per-team config.
  *
- * Description is not populated on `fetch()` Issues (boardSource's snapshot
- * doesn't include it); `resolveOne()` Issues carry the full description
- * because `fetchResolvedIssue` fetches it explicitly.
+ * Description is populated on both `fetch()` Issues and `resolveOne()` Issues.
  */
-import { createBoardSource, fetchResolvedIssue, isTerminalStateType, } from "../../boardSource.js";
-import { createLinearIssueStatusUpdater } from "../../linearIssueStatus.js";
-import { getLinearClient } from "../../util.js";
-export function canonicalStatusFromStateType(stateType) {
-    if (stateType === "unstarted") {
-        return "todo";
+import { toCanonicalId, } from "../../ticketSource.js";
+import { getLinearClient, lazyLinearClient } from "./client.js";
+import { createBoardSource, fetchResolvedIssue, isTerminalStateType, } from "./fetch.js";
+import { createLinearIssueStatusUpdater } from "./writeback.js";
+function canonicalStatusFromStateType(stateType) {
+    /* v8 ignore next 3 @preserve -- LinearIssue.stateType is non-optional; this guard is defensive for the resolveOne path */
+    if (stateType === undefined) {
+        return "other";
     }
-    if (stateType === "started") {
-        return "in-progress";
+    switch (stateType) {
+        case "unstarted": {
+            return "todo";
+        }
+        case "started": {
+            return "in-progress";
+        }
+        case "completed":
+        case "canceled":
+        case "duplicate": {
+            return "done";
+        }
+        default: {
+            return "other";
+        }
     }
-    if (isTerminalStateType(stateType)) {
-        return "done";
+}
+function canonicalBlockerStatus(blocker) {
+    if (blocker.stateType === undefined) {
+        return {
+            status: "other",
+            statusReason: "missing",
+            ...(blocker.status !== undefined && { nativeStatus: blocker.status }),
+        };
+    }
+    if (isTerminalStateType(blocker.stateType)) {
+        return {
+            status: "done",
+            ...(blocker.status !== undefined && { nativeStatus: blocker.status }),
+        };
+    }
+    if (blocker.stateType === "started") {
+        return {
+            status: "in-progress",
+            ...(blocker.status !== undefined && { nativeStatus: blocker.status }),
+        };
     }
-    return "other";
+    if (blocker.stateType === "unstarted") {
+        return {
+            status: "todo",
+            ...(blocker.status !== undefined && { nativeStatus: blocker.status }),
+        };
+    }
+    // backlog / triage / anything else falls through as "other"
+    return {
+        status: "other",
+        statusReason: "unmapped",
+        ...(blocker.status !== undefined && { nativeStatus: blocker.status }),
+    };
 }
 function toCanonicalBlocker(blocker, sourceName) {
+    const { status, statusReason, nativeStatus } = canonicalBlockerStatus(blocker);
     return {
-        id: `${sourceName}:${blocker.id}`,
+        id: toCanonicalId(sourceName, blocker.id),
         title: blocker.title,
-        status: canonicalStatusFromStateType(blocker.stateType),
+        status,
+        ...(statusReason !== undefined && { statusReason }),
+        ...(nativeStatus !== undefined && { nativeStatus }),
+    };
+}
+function toCanonicalParentSkip(skip, sourceName) {
+    return {
+        id: toCanonicalId(sourceName, skip.id),
+        title: skip.title,
+        childCount: skip.childCount,
     };
 }
 export function toCanonicalIssue(linearIssue, sourceName) {
@@ -40,14 +92,14 @@ export function toCanonicalIssue(linearIssue, sourceName) {
         uuid: linearIssue.uuid,
         statusId: linearIssue.statusId,
         teamId: linearIssue.teamId,
+        stateType: linearIssue.stateType,
         nativeStatus: linearIssue.status,
     };
     return {
-        id: `${sourceName}:${linearIssue.id}`,
+        id: toCanonicalId(sourceName, linearIssue.id),
         source: sourceName,
         title: linearIssue.title,
-        // Board snapshot doesn't carry description; resolveOne() populates it.
-        description: "",
+        description: linearIssue.description,
         status: canonicalStatusFromStateType(linearIssue.stateType),
         repository: linearIssue.repository,
         model: linearIssue.model,
@@ -61,44 +113,59 @@ export function toCanonicalIssue(linearIssue, sourceName) {
 export function createLinearTicketSource(config, context) {
     const sourceName = config.name ?? "linear";
     const { globalConfig } = context;
-    const client = getLinearClient();
-    const boardSource = createBoardSource({ config: globalConfig, client });
-    const issueStatusUpdater = createLinearIssueStatusUpdater({ client });
+    // Lazy: deferring `getLinearClient()` (and the sub-modules that depend on
+    // it) until first method use means `createLinearTicketSource` can be
+    // constructed without a Linear API key in env. Callers that only ever
+    // touch a sibling source — `crew doctor --ticket <shell-id>`,
+    // `crew run` with the multi-source Board's `Promise.allSettled` fan-out
+    // tolerating a Linear-side rejection — no longer crash at config-load
+    // time on a missing key.
+    const getClient = lazyLinearClient(getLinearClient);
+    let cachedBoardSource;
+    function getBoardSource() {
+        cachedBoardSource ??= createBoardSource({ config: globalConfig, client: getClient() });
+        return cachedBoardSource;
+    }
+    let cachedIssueStatusUpdater;
+    function getIssueStatusUpdater() {
+        cachedIssueStatusUpdater ??= createLinearIssueStatusUpdater({
+            client: getClient(),
+        });
+        return cachedIssueStatusUpdater;
+    }
+    let lastParentSkips = [];
     return {
         name: sourceName,
         async verify() {
-            await boardSource.verify();
+            await getBoardSource().verify();
         },
         async fetch() {
-            const state = await boardSource.fetch();
+            const state = await getBoardSource().fetch();
+            lastParentSkips = state.parentSkips.map((skip) => toCanonicalParentSkip(skip, sourceName));
             return state.issues.map((linearIssue) => toCanonicalIssue(linearIssue, sourceName));
         },
+        async fetchParentSkips() {
+            return lastParentSkips;
+        },
         async resolveOne(naturalId) {
-            // fetchResolvedIssue throws on missing repo; we let those propagate.
-            // Returning `undefined` is reserved for "ticket genuinely doesn't
-            // exist," which fetchResolvedIssue surfaces as an Error too — for now
-            // we let any error bubble up rather than swallow.
             const resolved = await fetchResolvedIssue({
-                client,
+                client: getClient(),
                 config: globalConfig,
                 ticket: naturalId,
             });
-            // fetchResolvedIssue doesn't return the native status name (it's
-            // already been resolved through workflow state lookup). We surface
-            // "other" until the consumer needs the canonical status, which is fine
-            // because `crew setup` doesn't branch on it.
             const sourceRef = {
                 uuid: resolved.uuid,
-                statusId: "",
+                statusId: resolved.statusId,
                 teamId: resolved.teamId,
-                nativeStatus: "",
+                stateType: resolved.stateType,
+                nativeStatus: resolved.status,
             };
             return {
-                id: `${sourceName}:${naturalId.toLowerCase()}`,
+                id: toCanonicalId(sourceName, naturalId),
                 source: sourceName,
                 title: resolved.title,
                 description: resolved.description,
-                status: "other",
+                status: canonicalStatusFromStateType(resolved.stateType),
                 repository: resolved.repository,
                 model: resolved.model,
                 assignee: "Unassigned",
@@ -111,7 +178,7 @@ export function createLinearTicketSource(config, context) {
         async markInProgress(issue) {
             // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- by the Linear adapter's contract, every Issue it produces carries a LinearSourceRef in sourceRef
             const ref = issue.sourceRef;
-            await issueStatusUpdater.markInProgress({
+            await getIssueStatusUpdater().markInProgress({
                 id: issue.id,
                 uuid: ref.uuid,
                 teamId: ref.teamId,