@clipboard-health/groundcrew 4.2.0 → 4.2.1

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,

package/dist/lib/{boardSource.d.ts → adapters/linear/fetch.d.ts}

@@ -1,19 +1,16 @@
 /**
- * Linear adapter — turns the viewer's GraphQL state into a `BoardState`
- * snapshot. Owns the GraphQL queries and shape parsing so callers consume a
- * typed `BoardState` instead of raw nodes.
+ * Linear adapter — GraphQL fetch helpers for board/issue data.
  *
- * There is no project / view / status configuration: the only filter is
- * "assigned to the API key's viewer AND carries an `agent-*` label."
- * State classification is driven by Linear's workflow `state.type`
+ * There is no project / view / status configuration: the only server-side
+ * filter is "assigned to the API key's viewer AND carries an `agent-*`
+ * label." State classification is driven by Linear's workflow `state.type`
  * (`unstarted` | `started` | `completed` | `canceled` | `duplicate`) —
- * never by status name — so workspaces with renamed columns (Todo → To Do,
- * Done → Shipped, etc.) Just Work.
+ * never by status name — so workspaces with renamed columns (Todo -> To Do,
+ * Done -> Shipped, etc.) Just Work without per-team config.
  */
 import type { LinearClient } from "@linear/sdk";
-import { type ResolvedConfig } from "./config.ts";
-import { RepositoryResolutionError } from "./ticketSource.ts";
-export declare const AGENT_LABEL_PREFIX = "agent-";
+import type { ResolvedConfig } from "../../config.ts";
+import { type ModelResolution } from "./parsing.ts";
 export declare const ISSUES_PAGE_SIZE = 250;
 export interface Blocker {
     id: string;
@@ -30,6 +27,7 @@ export interface Issue {
     id: string;
     uuid: string;
     title: string;
+    description: string;
     status: string;
     statusId: string;
     /** Linear workflow `state.type` — the source of truth for canonical classification. */
@@ -50,22 +48,17 @@ export interface Issue {
     hasMoreBlockers: boolean;
 }
 /**
- * `Issue` narrowed to "this ticket is for groundcrew" — produced by filtering
- * through `isGroundcrewIssue`. Use this type wherever downstream code reads
- * `model`/`repository` and the issue has already been through that filter.
+ * `Issue` narrowed to "this ticket is for groundcrew". Consumers operate on
+ * the canonical `GroundcrewIssue` from `ticketSource.ts`; this internal
+ * variant just shapes the adapter's local Linear type.
  */
 export type GroundcrewIssue = Issue & {
     model: string;
     repository: string;
 };
-export declare function isGroundcrewIssue(issue: Issue): issue is GroundcrewIssue;
 /**
  * Linear ticket that was silently dropped from `issues` because it has at
  * least one sub-issue and groundcrew works sub-issues rather than parents.
- * The dispatcher logs each one per tick so operators see WHY a Todo ticket
- * isn't being picked up instead of just "No Todo tickets to pick up." Only
- * Todo+agent-labelled parents qualify — non-actionable parents (e.g. Done
- * epics) would be noise.
  */
 export interface ParentSkip {
     id: string;
@@ -77,14 +70,8 @@ export interface BoardState {
     issues: Issue[];
     parentSkips: ParentSkip[];
 }
-export { RepositoryResolutionError };
 export interface BoardSource {
-    /**
-     * Verify the Linear API key resolves to a viewer. Run once at startup so
-     * misconfiguration surfaces before the first tick.
-     */
     verify(): Promise<void>;
-    /** Fetch the current board snapshot. Paginates internally. */
     fetch(): Promise<BoardState>;
 }
 interface BoardSourceDeps {
@@ -116,16 +103,6 @@ export interface IssueRelationNode {
 export declare function modelForResolution(resolution: Exclude<ModelResolution, {
     kind: "no-label";
 }>): string;
-export declare function resolveTodoAgentMetadata(arguments_: {
-    ticket: string;
-    description: string | undefined;
-    modelResolution: ModelResolution;
-    config: ResolvedConfig;
-    isTodo: boolean;
-}): {
-    repository: string | undefined;
-    model: string | undefined;
-};
 interface ResolvedIssue {
     uuid: string;
     title: string;
@@ -133,6 +110,9 @@ interface ResolvedIssue {
     repository: string;
     model: string;
     teamId: string;
+    stateType: string;
+    status: string;
+    statusId: string;
 }
 export interface RawLinearIssue {
     uuid: string;
@@ -144,7 +124,8 @@ export interface RawLinearIssue {
     }[];
     /** Linear workflow state name, e.g. "Todo", "In Review". May be "" if state was null. */
     stateName: string;
-    stateType?: string;
+    stateType: string;
+    stateId: string;
     blockers: Blocker[];
     hasMoreBlockers: boolean;
     /**
@@ -167,40 +148,6 @@ export declare function fetchRawLinearIssue(arguments_: {
 export declare function fetchInProgressIssueCount(arguments_: {
     client: LinearClient;
 }): Promise<number>;
-export type RepositoryResolution = {
-    kind: "ok";
-    repository: string;
-} | {
-    kind: "missing";
-};
-export declare function resolveRepositoryFor(arguments_: {
-    description: string | undefined;
-    config: ResolvedConfig;
-    ticket: string;
-}): RepositoryResolution;
-export type ModelResolution = {
-    kind: "matched";
-    model: string;
-} | {
-    kind: "no-label";
-} | {
-    kind: "agent-any";
-} | {
-    kind: "disabled-fallback";
-    requestedModel: string;
-    fallbackModel: string;
-};
-export declare function resolveModelFor(arguments_: {
-    labels: {
-        name: string;
-    }[];
-    config: ResolvedConfig;
-}): ModelResolution;
-/**
- * `agent-any` collapses to `models.default` here — manual setup doesn't run
- * the usage-gated `any` resolver, so the caller gets a concrete model name
- * instead of a sentinel that downstream code can't interpret.
- */
 export declare function fetchResolvedIssue(arguments_: {
     client: LinearClient;
     config: ResolvedConfig;
@@ -208,4 +155,5 @@ export declare function fetchResolvedIssue(arguments_: {
 }): Promise<ResolvedIssue>;
 export declare function warnIfDisabledFallback(ticket: string, modelResolution: ModelResolution, config: ResolvedConfig): void;
 export declare function blockersFromRelations(relations: IssueRelationNode[]): Blocker[];
-//# sourceMappingURL=boardSource.d.ts.map
+export {};
+//# sourceMappingURL=fetch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/linear/fetch.ts"],"names":[],"mappings":"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"}