@clipboard-health/groundcrew 4.2.0 → 4.2.2

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. */
@@ -39,33 +37,28 @@ export interface Issue {
     /**
      * `undefined` unless the ticket is in Todo with a parseable `agent-*` label
      * and a known-repo reference in its description — i.e. the dispatcher would
-     * actually pick it up. Resolving on non-Todo statuses would just invite
-     * tick-spam warnings on already-finished work.
+     * actually pick it up. Non-Todo tickets do not resolve repositories because
+     * that would invite tick-spam warnings on already-finished work.
      */
     repository: string | undefined;
-    /** `undefined` whenever `repository` is — the two are populated together. */
+    /** Parsed from the `agent-*` label when present, including non-Todo tickets for slot logs. */
     model: string | undefined;
     teamId: string;
     blockers: Blocker[];
     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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"}

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

@@ -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 { AGENT_ANY_MODEL, isShippedDefaultDisabled } from "./config.js";
-import { RepositoryResolutionError } from "./ticketSource.js";
-import { log } from "./util.js";
-export const AGENT_LABEL_PREFIX = "agent-";
+import { RepositoryResolutionError } from "../../ticketSource.js";
+import { log } from "../../util.js";
+import { AGENT_LABEL_PREFIX, resolveModelFor, resolveRepositoryFor, } from "./parsing.js";
 export const ISSUES_PAGE_SIZE = 250;
 // `state.type` values surfaced by `fetch()`. `backlog` / `triage` are dropped
 // at the GraphQL filter; everything else is post-classified by these names.
@@ -24,14 +21,6 @@ const ACTIONABLE_STATE_TYPES = [
     "canceled",
     "duplicate",
 ];
-export function isGroundcrewIssue(issue) {
-    return issue.model !== undefined && issue.repository !== undefined;
-}
-// Canonical RepositoryResolutionError lives in ./ticketSource.ts (imported at
-// the top of this file). Re-exported here so existing consumers of
-// boardSource.ts keep compiling until a follow-up PR completes the consumer
-// refactor and deletes this file.
-export { RepositoryResolutionError };
 export function createBoardSource(deps) {
     const { config, client } = deps;
     return {
@@ -75,18 +64,6 @@ export function isTerminalStatusForBlocker(blocker) {
 async function fetchBoard(client, config) {
     const nodes = [];
     let after = null;
-    // Three server-side filters narrow the response to tickets the orchestrator
-    // can actually act on:
-    //   1. Assignee: the API key's own viewer. groundcrew is a single-user
-    //      orchestrator — every ticket it dispatches is "this user's work."
-    //   2. Label: at least one `agent-*` label — i.e. the user opted the
-    //      ticket in to groundcrew. Without this, every human-owned ticket
-    //      would round-trip back just to be filtered out client-side.
-    //   3. State type: scoped to actionable values (`unstarted`, `started`,
-    //      `completed`, `canceled`, `duplicate`) so backlog/triage tickets never
-    //      make it into the page.
-    // The client-side `isGroundcrewIssue` guard in dispatcher.ts is
-    // belt-and-suspenders against query drift, not the load-bearing filter.
     const stateTypes = [...ACTIONABLE_STATE_TYPES];
     for (;;) {
         // oxlint-disable-next-line no-await-in-loop -- pagination cursor depends on the previous response
@@ -163,19 +140,23 @@ export function modelForResolution(resolution) {
     if (resolution.kind === "disabled-fallback") {
         return resolution.fallbackModel;
     }
-    return AGENT_ANY_MODEL;
+    return "any";
 }
-export function resolveTodoAgentMetadata(arguments_) {
+function resolveAgentMetadata(arguments_) {
     const { ticket, description, modelResolution, config, isTodo } = arguments_;
     let repository;
     let model;
-    if (modelResolution.kind !== "no-label" && isTodo) {
-        const resolution = resolveRepositoryFor({ description, config, ticket });
+    if (modelResolution.kind === "no-label") {
+        return { repository, model };
+    }
+    model = modelForResolution(modelResolution);
+    if (isTodo) {
+        const resolution = resolveRepositoryFor({ description, config });
         if (resolution.kind === "ok") {
             ({ repository } = resolution);
-            model = modelForResolution(modelResolution);
         }
         else {
+            model = undefined;
             log(`WARNING: ${ticket} has an ${AGENT_LABEL_PREFIX}* label but no known repository in its description; skipping dispatch. Add one of workspace.knownRepositories to the description, or remove the ${AGENT_LABEL_PREFIX}* label: ${config.workspace.knownRepositories.join(", ")}`);
         }
     }
@@ -186,6 +167,7 @@ function buildLinearIssue(input) {
         id: input.identifier.toLowerCase(),
         uuid: input.uuid,
         title: input.title,
+        description: input.description,
         status: input.status,
         statusId: input.statusId,
         stateType: input.stateType,
@@ -202,12 +184,7 @@ function buildLinearIssue(input) {
 function issueFromNode(node, config) {
     const modelResolution = resolveModelFor({ labels: node.labels.nodes, config });
     warnIfDisabledFallback(node.identifier, modelResolution, config);
-    // Only the dispatcher reads `Issue.repository` / `Issue.model`, and only on
-    // tickets in the Todo column it's about to pick up. Resolving them for In
-    // Progress (already running) or Done (cleaner only needs the id) would just
-    // invite tick-spam warnings on already-finished tickets — e.g. when a
-    // description was edited or knownRepositories changed after dispatch.
-    const { repository, model } = resolveTodoAgentMetadata({
+    const { repository, model } = resolveAgentMetadata({
         ticket: node.identifier,
         /* v8 ignore next @preserve -- BoardIssues query selects description; the ?? guard normalises a null vs undefined edge */
         description: node.description ?? undefined,
@@ -219,6 +196,8 @@ function issueFromNode(node, config) {
         identifier: node.identifier,
         uuid: node.id,
         title: node.title,
+        /* v8 ignore next @preserve -- BoardIssues query always selects description; this `?? ""` is a defensive null vs undefined edge */
+        description: node.description ?? "",
         /* v8 ignore next @preserve -- BoardIssues query always returns state */
         status: node.state?.name ?? "Unknown",
         /* v8 ignore next @preserve -- BoardIssues query always returns state */
@@ -233,23 +212,6 @@ function issueFromNode(node, config) {
         inverseRelations: node.inverseRelations,
     });
 }
-function escapeRegex(value) {
-    return value.replaceAll(/[$()*+.?[\\\]^{|}]/g, String.raw `\$&`);
-}
-// Sort by descending length so longer names match first — `api-admin`
-// must beat `api` when both are configured. `\b` treats `-` as a word
-// boundary, so without this ordering `api` would win on `api-admin`.
-function buildRepositoryRegex(config) {
-    const candidates = config.workspace.knownRepositories.flatMap((repo) => {
-        const slashIndex = repo.indexOf("/");
-        return slashIndex === -1 ? [repo] : [repo, repo.slice(slashIndex + 1)];
-    });
-    const alternation = candidates
-        .toSorted((a, b) => b.length - a.length)
-        .map(escapeRegex)
-        .join("|");
-    return new RegExp(String.raw `\b(${alternation})\b`);
-}
 const ISSUE_LABEL_PAGE_SIZE = 50;
 const ISSUE_RELATION_PAGE_SIZE = 50;
 export async function fetchBlockersForTicket(arguments_) {
@@ -294,7 +256,7 @@ export async function fetchRawLinearIssue(arguments_) {
         title
         description
         team { id }
-        state { name type }
+        state { id name type }
         children { nodes { id } }
         labels(first: ${ISSUE_LABEL_PAGE_SIZE}) {
           nodes { name }
@@ -328,6 +290,8 @@ export async function fetchRawLinearIssue(arguments_) {
         stateName: issue.state?.name ?? "",
         /* v8 ignore next @preserve -- ResolveIssue query selects state; null only if Linear genuinely returns a stateless ticket */
         stateType: issue.state?.type ?? "",
+        /* v8 ignore next @preserve -- ResolveIssue query selects state; null only if Linear genuinely returns a stateless ticket */
+        stateId: issue.state?.id ?? "",
         blockers: blockersFromRelations(issue.inverseRelations?.nodes ?? []),
         hasMoreBlockers: issue.inverseRelations?.pageInfo.hasNextPage ?? false,
         hasChildren: (issue.children?.nodes.length ?? 0) > 0,
@@ -374,53 +338,6 @@ export async function fetchInProgressIssueCount(arguments_) {
         after = page.pageInfo.endCursor;
     }
 }
-export function resolveRepositoryFor(arguments_) {
-    const { description, config } = arguments_;
-    if (description === undefined || description.length === 0) {
-        return { kind: "missing" };
-    }
-    const match = buildRepositoryRegex(config).exec(description)?.[1];
-    if (match === undefined) {
-        return { kind: "missing" };
-    }
-    // `buildRepositoryRegex` matches both the full `owner/repo` entry and its bare
-    // suffix, so the captured value can be either form. Downstream code composes
-    // the resolved value with `workspace.projectDir` and needs the exact
-    // `knownRepositories` entry, so resolve back to that form here.
-    const candidates = config.workspace.knownRepositories.filter((entry) => entry === match || entry.endsWith(`/${match}`));
-    if (candidates.length !== 1) {
-        return { kind: "missing" };
-    }
-    const [canonical] = candidates;
-    /* v8 ignore next 3 @preserve -- candidates.length === 1 guarantees [0] is defined */
-    if (canonical === undefined) {
-        return { kind: "missing" };
-    }
-    return { kind: "ok", repository: canonical };
-}
-export function resolveModelFor(arguments_) {
-    const { labels, config } = arguments_;
-    const parsed = parseAgentLabels(labels, config);
-    if (parsed === undefined) {
-        return { kind: "no-label" };
-    }
-    if (parsed.model === AGENT_ANY_MODEL) {
-        return { kind: "agent-any" };
-    }
-    if (parsed.disabledFallback !== undefined) {
-        return {
-            kind: "disabled-fallback",
-            requestedModel: parsed.disabledFallback,
-            fallbackModel: parsed.model,
-        };
-    }
-    return { kind: "matched", model: parsed.model };
-}
-/**
- * `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 async function fetchResolvedIssue(arguments_) {
     const { client, config, ticket } = arguments_;
     const upper = ticket.toUpperCase();
@@ -428,7 +345,6 @@ export async function fetchResolvedIssue(arguments_) {
     const repositoryResolution = resolveRepositoryFor({
         description: raw.description,
         config,
-        ticket: upper,
     });
     if (repositoryResolution.kind === "missing") {
         throw new RepositoryResolutionError({
@@ -452,35 +368,11 @@ export async function fetchResolvedIssue(arguments_) {
         repository: repositoryResolution.repository,
         model,
         teamId: raw.teamId,
+        stateType: raw.stateType,
+        status: raw.stateName,
+        statusId: raw.stateId,
     };
 }
-function parseAgentLabels(labels, config) {
-    const agentLabels = labels.filter((label) => label.name.startsWith(AGENT_LABEL_PREFIX));
-    if (agentLabels.length === 0) {
-        return undefined;
-    }
-    let disabledFallback;
-    for (const label of agentLabels) {
-        const name = label.name.slice(AGENT_LABEL_PREFIX.length);
-        if (name === AGENT_ANY_MODEL) {
-            return { model: AGENT_ANY_MODEL };
-        }
-        // Own-property check, not `in`: a label like `agent-toString` or
-        // `agent-__proto__` would otherwise resolve through the prototype chain
-        // instead of falling back to `models.default`.
-        if (Object.hasOwn(config.models.definitions, name)) {
-            return { model: name };
-        }
-        if (disabledFallback === undefined && isShippedDefaultDisabled(config, name)) {
-            disabledFallback = name;
-        }
-    }
-    const fallback = { model: config.models.default };
-    if (disabledFallback !== undefined) {
-        fallback.disabledFallback = disabledFallback;
-    }
-    return fallback;
-}
 export function warnIfDisabledFallback(ticket, modelResolution, config) {
     if (modelResolution.kind !== "disabled-fallback") {
         return;

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

@@ -2,4 +2,5 @@ import type { AdapterDefinition } from "../../adapterDefinition.ts";
 import { linearAdapterConfigSchema } from "./schema.ts";
 declare const definition: AdapterDefinition<typeof linearAdapterConfigSchema>;
 export default definition;
+export type { LinearSourceRef } from "./factory.ts";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/linear/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAGpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAExD,QAAA,MAAM,UAAU,EAAE,iBAAiB,CAAC,OAAO,yBAAyB,CAInE,CAAC;eAEa,UAAU"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/linear/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAGpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAExD,QAAA,MAAM,UAAU,EAAE,iBAAiB,CAAC,OAAO,yBAAyB,CAInE,CAAC;eAEa,UAAU;AAEzB,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

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

@@ -0,0 +1,44 @@
+/**
+ * Linear adapter — parsing helpers for model/repository resolution from
+ * issue labels and descriptions. Extracted from boardSource.ts (Task 10).
+ */
+import { type ResolvedConfig } from "../../config.ts";
+export declare const AGENT_LABEL_PREFIX = "agent-";
+export type RepositoryResolution = {
+    kind: "ok";
+    repository: string;
+} | {
+    kind: "missing";
+};
+export type ModelResolution = {
+    kind: "matched";
+    model: string;
+} | {
+    kind: "no-label";
+} | {
+    kind: "agent-any";
+} | {
+    kind: "disabled-fallback";
+    requestedModel: string;
+    fallbackModel: string;
+};
+export declare function buildRepositoryRegex(config: ResolvedConfig): RegExp;
+export declare function resolveRepositoryFor(arguments_: {
+    description: string | undefined;
+    config: ResolvedConfig;
+}): RepositoryResolution;
+interface ParseRepositoryArguments {
+    description: string | undefined;
+    config: ResolvedConfig;
+    repositoryRegex: RegExp;
+    ticket: string;
+}
+export declare function parseRepository(arguments_: ParseRepositoryArguments): string;
+export declare function resolveModelFor(arguments_: {
+    labels: {
+        name: string;
+    }[];
+    config: ResolvedConfig;
+}): ModelResolution;
+export {};
+//# sourceMappingURL=parsing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parsing.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/linear/parsing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAA6C,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjG,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAE3C,MAAM,MAAM,oBAAoB,GAAG;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAE5F,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC;AASjF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAUnE;AAiDD,wBAAgB,oBAAoB,CAAC,UAAU,EAAE;IAC/C,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,MAAM,EAAE,cAAc,CAAC;CACxB,GAAG,oBAAoB,CAuBvB;AAED,UAAU,wBAAwB;IAChC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,MAAM,EAAE,cAAc,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,wBAAwB,GAAG,MAAM,CA2B5E;AAkDD,wBAAgB,eAAe,CAAC,UAAU,EAAE;IAC1C,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC3B,MAAM,EAAE,cAAc,CAAC;CACxB,GAAG,eAAe,CAiBlB"}

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

@@ -0,0 +1,144 @@
+/**
+ * Linear adapter — parsing helpers for model/repository resolution from
+ * issue labels and descriptions. Extracted from boardSource.ts (Task 10).
+ */
+import { AGENT_ANY_MODEL, isShippedDefaultDisabled } from "../../config.js";
+import { RepositoryResolutionError } from "../../ticketSource.js";
+export const AGENT_LABEL_PREFIX = "agent-";
+function escapeRegex(value) {
+    return value.replaceAll(/[$()*+.?[\\\]^{|}]/g, String.raw `\$&`);
+}
+// Sort by descending length so longer names match first — `api-admin`
+// must beat `api` when both are configured. `\b` treats `-` as a word
+// boundary, so without this ordering `api` would win on `api-admin`.
+export function buildRepositoryRegex(config) {
+    const candidates = config.workspace.knownRepositories.flatMap((repo) => {
+        const slashIndex = repo.indexOf("/");
+        return slashIndex === -1 ? [repo] : [repo, repo.slice(slashIndex + 1)];
+    });
+    const alternation = candidates
+        .toSorted((a, b) => b.length - a.length)
+        .map(escapeRegex)
+        .join("|");
+    return new RegExp(String.raw `\b(${alternation})\b`);
+}
+function canonicalizeRepositoryMatch(description, config, repositoryRegex) {
+    if (description === undefined || description.length === 0) {
+        return { kind: "missing" };
+    }
+    // Guard against an empty knownRepositories config: buildRepositoryRegex
+    // would produce /\b()\b/, which matches the empty string at any word
+    // boundary and returns a bogus "" match. Treat that as "no repo could
+    // be resolved" so neither the dispatch path nor the doctor path emits
+    // a spurious empty-string repository.
+    if (config.workspace.knownRepositories.length === 0) {
+        return { kind: "missing" };
+    }
+    const matched = repositoryRegex.exec(description)?.[1];
+    if (matched === undefined) {
+        return { kind: "missing" };
+    }
+    const candidates = config.workspace.knownRepositories.filter((r) => r === matched || r.endsWith(`/${matched}`));
+    if (candidates.length > 1) {
+        return { kind: "ambiguous" };
+    }
+    if (candidates.length === 1) {
+        /* v8 ignore next @preserve -- length-1 guarantees [0] defined */
+        // oxlint-disable-next-line typescript/no-non-null-assertion -- length-1 guarantees [0] is defined
+        return { kind: "canonical", repository: candidates[0] };
+    }
+    return { kind: "unknown", repository: matched };
+}
+export function resolveRepositoryFor(arguments_) {
+    const { description, config } = arguments_;
+    const match = canonicalizeRepositoryMatch(description, config, buildRepositoryRegex(config));
+    switch (match.kind) {
+        case "missing":
+        case "ambiguous": {
+            // Ambiguous matches surface as "missing" so fetchResolvedIssue throws
+            // RepositoryResolutionError — same conflation parseRepository uses,
+            // and the right call for single-ticket flows: the launcher can't
+            // disambiguate "matched N known repos" any more than the dispatcher can.
+            return { kind: "missing" };
+        }
+        case "canonical":
+        case "unknown": {
+            return { kind: "ok", repository: match.repository };
+        }
+        /* v8 ignore next 5 @preserve -- exhaustive over CanonicalizedRepositoryMatch.kind */
+        default: {
+            throw new Error(`resolveRepositoryFor: unexpected match kind ${match.kind}`);
+        }
+    }
+}
+export function parseRepository(arguments_) {
+    const { description, config, repositoryRegex, ticket } = arguments_;
+    const match = canonicalizeRepositoryMatch(description, config, repositoryRegex);
+    switch (match.kind) {
+        case "missing":
+        case "ambiguous": {
+            throw new RepositoryResolutionError({
+                ticket,
+                repositories: config.workspace.knownRepositories,
+            });
+        }
+        case "canonical": {
+            return match.repository;
+        }
+        case "unknown": {
+            // No match in knownRepositories — return the asserted name as-is. The
+            // dispatcher's dispatchableRepository helper WARN-logs and skips at
+            // the host layer, uniformly across all sources.
+            return match.repository;
+        }
+        /* v8 ignore next 5 @preserve -- exhaustive over CanonicalizedRepositoryMatch.kind */
+        default: {
+            throw new Error(`parseRepository: unexpected match kind ${match.kind}`);
+        }
+    }
+}
+function parseAgentLabels(labels, config) {
+    const agentLabels = labels.filter((label) => label.name.startsWith(AGENT_LABEL_PREFIX));
+    if (agentLabels.length === 0) {
+        return undefined;
+    }
+    let disabledFallback;
+    for (const label of agentLabels) {
+        const name = label.name.slice(AGENT_LABEL_PREFIX.length);
+        if (name === AGENT_ANY_MODEL) {
+            return { model: AGENT_ANY_MODEL };
+        }
+        // Own-property check, not `in`: a label like `agent-toString` or
+        // `agent-__proto__` would otherwise resolve through the prototype chain
+        // instead of falling back to `models.default`.
+        if (Object.hasOwn(config.models.definitions, name)) {
+            return { model: name };
+        }
+        if (disabledFallback === undefined && isShippedDefaultDisabled(config, name)) {
+            disabledFallback = name;
+        }
+    }
+    const fallback = { model: config.models.default };
+    if (disabledFallback !== undefined) {
+        fallback.disabledFallback = disabledFallback;
+    }
+    return fallback;
+}
+export function resolveModelFor(arguments_) {
+    const { labels, config } = arguments_;
+    const parsed = parseAgentLabels(labels, config);
+    if (parsed === undefined) {
+        return { kind: "no-label" };
+    }
+    if (parsed.model === AGENT_ANY_MODEL) {
+        return { kind: "agent-any" };
+    }
+    if (parsed.disabledFallback !== undefined) {
+        return {
+            kind: "disabled-fallback",
+            requestedModel: parsed.disabledFallback,
+            fallbackModel: parsed.model,
+        };
+    }
+    return { kind: "matched", model: parsed.model };
+}

package/dist/lib/{linearIssueStatus.d.ts → adapters/linear/writeback.d.ts}

@@ -6,10 +6,9 @@ interface LinearIssueReference {
 }
 interface LinearIssueStatusUpdater {
     markInProgress(issue: LinearIssueReference): Promise<void>;
-    resetMissingInProgressCache(): void;
 }
 export declare function createLinearIssueStatusUpdater(arguments_: {
     client: LinearClient;
 }): LinearIssueStatusUpdater;
 export {};
-//# sourceMappingURL=linearIssueStatus.d.ts.map
+//# sourceMappingURL=writeback.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"writeback.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/linear/writeback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD,UAAU,oBAAoB;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,wBAAwB;IAChC,cAAc,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAED,wBAAgB,8BAA8B,CAAC,UAAU,EAAE;IACzD,MAAM,EAAE,YAAY,CAAC;CACtB,GAAG,wBAAwB,CAgD3B"}