@clipboard-health/groundcrew 4.2.0 → 4.2.2

package/dist/lib/testing/canonicalFixtures.js

@@ -0,0 +1,62 @@
+import { toCanonicalId } from "../ticketSource.js";
+export function canonicalLinearIssue(overrides) {
+    const { naturalId, sourceRef: refOverride, ...rest } = overrides;
+    // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- test fixture; sourceRef is opaque unknown in the Issue contract; we reinterpret it here only for fixture construction
+    const refPartial = refOverride ?? {};
+    const sourceRef = {
+        uuid: refPartial.uuid ?? `uuid-${naturalId}`,
+        statusId: refPartial.statusId ?? "statusId-default",
+        teamId: refPartial.teamId ?? "team-default",
+        stateType: refPartial.stateType ?? "unstarted",
+        nativeStatus: refPartial.nativeStatus ?? "Todo",
+    };
+    return {
+        id: toCanonicalId("linear", naturalId),
+        source: "linear",
+        title: `Title for ${naturalId}`,
+        description: "",
+        status: "todo",
+        repository: undefined,
+        model: undefined,
+        assignee: "Unassigned",
+        updatedAt: "2026-01-01T00:00:00.000Z",
+        blockers: [],
+        hasMoreBlockers: false,
+        ...rest,
+        sourceRef,
+    };
+}
+export function canonicalBlocker(overrides) {
+    const { naturalId, ...rest } = overrides;
+    return {
+        id: toCanonicalId("linear", naturalId),
+        title: `Title for ${naturalId}`,
+        status: "todo",
+        ...rest,
+    };
+}
+/**
+ * Canonical Issue fixture for a non-Linear source. Default source name is
+ * "shell-test"; override via `sourceName`. Mirrors `canonicalLinearIssue`'s
+ * defaults except `sourceRef` is an empty opaque object (no LinearSourceRef
+ * shape, since this is meant to stand in for any non-Linear adapter — the
+ * shell adapter, future Jira adapter, etc.).
+ */
+export function canonicalShellIssue(overrides) {
+    const { naturalId, sourceName = "shell-test", sourceRef, ...rest } = overrides;
+    return {
+        id: toCanonicalId(sourceName, naturalId),
+        source: sourceName,
+        title: `Title for ${naturalId}`,
+        description: "",
+        status: "todo",
+        repository: undefined,
+        model: undefined,
+        assignee: "Unassigned",
+        updatedAt: "2026-01-01T00:00:00.000Z",
+        blockers: [],
+        hasMoreBlockers: false,
+        sourceRef: sourceRef ?? {},
+        ...rest,
+    };
+}

package/dist/lib/ticketSource.d.ts

@@ -26,18 +26,42 @@ export interface Blocker {
     id: string;
     title: string;
     status: CanonicalStatus;
+    /**
+     * When `status === "other"`, adapters MUST set this to explain why
+     * they couldn't classify. Consumers (specifically `ticketDoctor`) render
+     * this verbatim to give users an actionable next step.
+     *
+     * - `"missing"`: the source returned no status for this blocker
+     *   (e.g., Linear had no state on the blocker; shell script omitted
+     *   the field).
+     * - `"unmapped"`: the source returned a status that isn't in the
+     *   source's known mapping (e.g., a Linear column not in
+     *   `linear.projects[*].statuses`, or an unrecognized shell value).
+     *
+     * MUST be undefined when `status !== "other"`.
+     */
+    statusReason?: "missing" | "unmapped";
+    /**
+     * Human-readable native status from the source, when available.
+     * Used for diagnostic display only — never branched on. Adapters SHOULD
+     * populate this when `statusReason === "unmapped"` so users can see
+     * which status name to add to their config; MAY populate for mapped
+     * statuses too if the source's native vocabulary differs usefully
+     * from `CanonicalStatus`.
+     */
+    nativeStatus?: string;
 }
 export interface Issue {
-    /** Canonical, source-prefixed id, e.g. "linear:eng-220" or "shell-jira:HRD-1". */
+    /** Canonical, source-prefixed id, e.g. "linear:eng-220" or "shell-jira:hrd-1". */
     id: string;
     /** Source name (the adapter's `name`, defaulting to its `kind`). */
     source: string;
     title: string;
     description: string;
     status: CanonicalStatus;
-    /** `undefined` when the ticket isn't groundcrew-eligible (no agent label / no repo match). */
+    /** `undefined` when the ticket is not dispatchable to a repository. */
     repository: string | undefined;
-    /** `undefined` when the ticket isn't groundcrew-eligible. */
+    /** Parsed agent model when the source can resolve one; may be present on non-Todo tickets for logs. */
     model: string | undefined;
     assignee: string;
     updatedAt: string;
@@ -52,9 +76,26 @@ export type GroundcrewIssue = Issue & {
     repository: string;
 };
 export declare function isGroundcrewIssue(issue: Issue): issue is GroundcrewIssue;
+/**
+ * A parent ticket that was dropped from the fetch result because it has
+ * sub-issues. Surfaced separately so the dispatcher can log WHY a
+ * Todo+labelled ticket wasn't picked up (PR #80 behavior).
+ */
+export interface ParentSkip {
+    /**
+     * Canonical, source-prefixed id, e.g. "linear:eng-220". Matches the form
+     * used by `Issue.id` so consumers can treat all ids uniformly and strip
+     * the prefix with `naturalIdFromCanonical` when displaying to operators.
+     */
+    id: string;
+    title: string;
+    childCount: number;
+}
 export interface BoardState {
     timestamp: string;
     issues: Issue[];
+    /** Parent tickets skipped because they have sub-issues. */
+    parentSkips: readonly ParentSkip[];
 }
 export interface TicketSource {
     /** Stable identifier used as the id prefix and in log lines. Equal to the source's config `name`. */
@@ -67,6 +108,13 @@ export interface TicketSource {
     resolveOne(naturalId: string): Promise<Issue | undefined>;
     /** Writeback. The adapter downcasts `issue.sourceRef` internally. */
     markInProgress(issue: Issue): Promise<void>;
+    /**
+     * Optional: return parent tickets that were excluded from `fetch()` because
+     * they have sub-issues. Board surfaces these so the dispatcher can log WHY
+     * a Todo+labelled ticket was skipped (PR #80 behavior). Adapters that
+     * don't distinguish parents simply omit this method; Board returns [].
+     */
+    fetchParentSkips?(): Promise<readonly ParentSkip[]>;
 }
 export declare class RepositoryResolutionError extends Error {
     constructor(arguments_: {
@@ -80,4 +128,26 @@ export declare class AmbiguousTicketError extends Error {
         matches: readonly string[];
     });
 }
+/**
+ * Build a canonical source-prefixed id from a source name and a natural
+ * (possibly mixed-case) id. Lower-cases the natural part so the same
+ * ticket always produces the same canonical id regardless of which code
+ * path or adapter constructed it.
+ *
+ * All adapters MUST use this helper when constructing canonical ids
+ * (rather than concatenating `${sourceName}:${naturalId}` inline) so
+ * that `Board.resolveOne` lookups against lower-cased natural-id input
+ * find the issue regardless of the casing the source emitted.
+ */
+export declare function toCanonicalId(sourceName: string, naturalId: string): string;
+/**
+ * Strip the source prefix from a canonical id, yielding the natural id
+ * the producing adapter exposed. Use at consumer boundaries where you
+ * need to compare a canonical id against natural-id artifacts like
+ * `WorktreeEntry.ticket` or filesystem directory names.
+ *
+ * Canonical ids always carry a `<source>:` prefix; the no-colon branch
+ * is a defensive fallback that's unreachable in normal operation.
+ */
+export declare function naturalIdFromCanonical(id: string): string;
 //# sourceMappingURL=ticketSource.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ticketSource.d.ts","sourceRoot":"","sources":["../../src/lib/ticketSource.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,aAAa,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC;AAEtF,MAAM,WAAW,OAAO;IACtB,6DAA6D;IAC7D,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,eAAe,CAAC;CACzB;AAED,MAAM,WAAW,KAAK;IACpB,kFAAkF;IAClF,EAAE,EAAE,MAAM,CAAC;IACX,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,eAAe,CAAC;IACxB,8FAA8F;IAC9F,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,6DAA6D;IAC7D,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;IACzB,wFAAwF;IACxF,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,mEAAmE;AACnE,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,IAAI,eAAe,CAExE;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,qGAAqG;IACrG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,oFAAoF;IACpF,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAC1B,0EAA0E;IAC1E,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;IAC1D,qEAAqE;IACrE,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,YAAmB,UAAU,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,EAMjF;CACF;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,YAAmB,UAAU,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,EAM/E;CACF"}
+{"version":3,"file":"ticketSource.d.ts","sourceRoot":"","sources":["../../src/lib/ticketSource.ts"],"names":[],"mappings":"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"}

package/dist/lib/ticketSource.js

@@ -24,3 +24,34 @@ export class AmbiguousTicketError extends Error {
         this.name = "AmbiguousTicketError";
     }
 }
+/**
+ * Build a canonical source-prefixed id from a source name and a natural
+ * (possibly mixed-case) id. Lower-cases the natural part so the same
+ * ticket always produces the same canonical id regardless of which code
+ * path or adapter constructed it.
+ *
+ * All adapters MUST use this helper when constructing canonical ids
+ * (rather than concatenating `${sourceName}:${naturalId}` inline) so
+ * that `Board.resolveOne` lookups against lower-cased natural-id input
+ * find the issue regardless of the casing the source emitted.
+ */
+export function toCanonicalId(sourceName, naturalId) {
+    return `${sourceName}:${naturalId.toLowerCase()}`;
+}
+/**
+ * Strip the source prefix from a canonical id, yielding the natural id
+ * the producing adapter exposed. Use at consumer boundaries where you
+ * need to compare a canonical id against natural-id artifacts like
+ * `WorktreeEntry.ticket` or filesystem directory names.
+ *
+ * Canonical ids always carry a `<source>:` prefix; the no-colon branch
+ * is a defensive fallback that's unreachable in normal operation.
+ */
+export function naturalIdFromCanonical(id) {
+    const colonIndex = id.indexOf(":");
+    /* v8 ignore next @preserve -- canonical ids always carry a source prefix; this branch is unreachable */
+    if (colonIndex === -1) {
+        return id;
+    }
+    return id.slice(colonIndex + 1);
+}

package/dist/lib/util.d.ts

@@ -1,4 +1,3 @@
-import { LinearClient } from "@linear/sdk";
 export declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;
 export declare function writeOutput(message?: string): void;
 export declare function writeError(message: string): void;
@@ -8,25 +7,6 @@ export declare function log(message: string): void;
 type LogEventFieldValue = boolean | number | string | readonly string[] | undefined;
 export declare function logEvent(event: string, fields: Record<string, LogEventFieldValue>): void;
 export declare function readEnvironmentVariable(name: string): string | undefined;
-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, 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;
 /**
  * Reads the value that follows `--ticket` at `argv[index + 1]`. Throws a
  * uniform "ticket id is required" error if the value is missing, empty, or

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

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

package/dist/lib/util.js

@@ -1,6 +1,5 @@
 import { appendFileSync, mkdirSync } from "node:fs";
 import { dirname } from "node:path";
-import { LinearClient } from "@linear/sdk";
 export async function sleep(ms, signal) {
     if (signal?.aborted === true) {
         return;
@@ -99,40 +98,6 @@ export function readEnvironmentVariable(name) {
     // oxlint-disable-next-line node/no-process-env -- Centralized environment accessor.
     return process.env[name];
 }
-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, 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;
-    };
-}
 /**
  * Reads the value that follows `--ticket` at `argv[index + 1]`. Throws a
  * uniform "ticket id is required" error if the value is missing, empty, or

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clipboard-health/groundcrew",
-  "version": "4.2.0",
+  "version": "4.2.2",
   "description": "Linear-driven orchestrator that launches AI coding agents in git worktrees, with workspace lifecycle and usage tracking.",
   "keywords": [
     "agent",

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"linearIssueStatus.d.ts","sourceRoot":"","sources":["../../src/lib/linearIssueStatus.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;IAC3D,2BAA2B,IAAI,IAAI,CAAC;CACrC;AAED,wBAAgB,8BAA8B,CAAC,UAAU,EAAE;IACzD,MAAM,EAAE,YAAY,CAAC;CACtB,GAAG,wBAAwB,CAmD3B"}