@chief-clancy/core 0.1.0

package/dist/board/linear/api/api.js

@@ -0,0 +1,179 @@
+import { linearIssuesResponseSchema, linearViewerResponseSchema, } from '../../../schemas/index.js';
+/** Linear GraphQL API endpoint. */
+const LINEAR_API = 'https://api.linear.app/graphql';
+const SAFE_ID_PATTERN = /^[a-zA-Z0-9_-]+$/;
+/**
+ * Build standard Linear API request headers.
+ *
+ * Personal API keys do NOT use "Bearer" prefix — only OAuth tokens do.
+ *
+ * @param apiKey - The Linear personal API key.
+ * @returns Headers object for Linear GraphQL requests.
+ */
+export function linearHeaders(apiKey) {
+    return {
+        Authorization: apiKey,
+        'Content-Type': 'application/json',
+    };
+}
+/**
+ * Validate that a team ID is safe for use in GraphQL variables.
+ *
+ * @param teamId - The Linear team ID to validate.
+ * @returns `true` if the ID matches the safe pattern.
+ */
+export function isValidTeamId(teamId) {
+    return SAFE_ID_PATTERN.test(teamId);
+}
+/** Build a GraphQL POST request init. */
+function graphqlInit(apiKey, query, variables) {
+    return {
+        method: 'POST',
+        headers: linearHeaders(apiKey),
+        body: JSON.stringify({ query, variables }),
+    };
+}
+/**
+ * Make a GraphQL request to the Linear API.
+ *
+ * @param opts - API key, query, optional variables, and optional fetcher.
+ * @returns The raw JSON response, or `undefined` on failure.
+ */
+export async function linearGraphql(opts) {
+    const { apiKey, query, variables, fetcher } = opts;
+    const doFetch = fetcher ?? fetch;
+    const response = await doFetch(LINEAR_API, graphqlInit(apiKey, query, variables)).catch((err) => {
+        console.warn(`⚠ Linear API request failed: ${err instanceof Error ? err.message : String(err)}`);
+        return undefined;
+    });
+    if (!response)
+        return undefined;
+    if (!response.ok) {
+        console.warn(`⚠ Linear API returned HTTP ${response.status}`);
+        return undefined;
+    }
+    try {
+        return await response.json();
+    }
+    catch {
+        console.warn('⚠ Linear API returned invalid JSON');
+        return undefined;
+    }
+}
+/** Map a Linear ping HTTP status to a failure result. */
+function mapPingStatus(status) {
+    const isAuthError = status === 401 || status === 403;
+    return isAuthError
+        ? { ok: false, error: '✗ Linear auth failed — check LINEAR_API_KEY' }
+        : { ok: false, error: `✗ Linear API returned HTTP ${status}` };
+}
+/**
+ * Ping the Linear API to verify connectivity and credentials.
+ *
+ * @param apiKey - The Linear personal API key.
+ * @param fetcher - Optional custom fetch function for DI in tests.
+ * @returns Ping result with `ok` and optional `error`.
+ */
+export async function pingLinear(apiKey, fetcher) {
+    const response = await (fetcher ?? fetch)(LINEAR_API, graphqlInit(apiKey, '{ viewer { id } }')).catch(() => undefined);
+    if (!response) {
+        return { ok: false, error: '✗ Could not reach Linear — check network' };
+    }
+    if (!response.ok)
+        return mapPingStatus(response.status);
+    try {
+        const json = await response.json();
+        const parsed = linearViewerResponseSchema.safeParse(json);
+        if (parsed.success && parsed.data.data?.viewer?.id)
+            return { ok: true };
+    }
+    catch {
+        // Invalid JSON — treat as auth issue
+    }
+    return { ok: false, error: '✗ Linear auth failed — check LINEAR_API_KEY' };
+}
+/** Map a raw Linear issue node to a {@link LinearTicket}. */
+function toLinearTicket(issue) {
+    return {
+        key: issue.identifier,
+        title: issue.title,
+        description: issue.description ?? '',
+        provider: 'linear',
+        issueId: issue.id,
+        parentIdentifier: issue.parent?.identifier,
+        labels: issue.labels?.nodes
+            ?.map((l) => l.name)
+            .filter((n) => Boolean(n)),
+    };
+}
+/** Build the GraphQL query for fetching assigned issues. */
+function buildIssuesQuery(opts) {
+    const { teamId, label, excludeHitl, limit = 5 } = opts;
+    const hasLabel = Boolean(label?.trim());
+    const varDecls = ['$teamId: ID!', ...(hasLabel ? ['$label: String!'] : [])];
+    const labelFilter = hasLabel ? 'labels: { name: { eq: $label } }' : '';
+    const filterParts = [
+        'state: { type: { eq: "unstarted" } }',
+        'team: { id: { eq: $teamId } }',
+        labelFilter,
+    ].filter(Boolean);
+    const clampedLimit = Math.min(Math.max(limit, 1), 50);
+    const fetchLimit = excludeHitl ? clampedLimit * 3 : clampedLimit;
+    const query = `
+    query(${varDecls.join(', ')}) {
+      viewer {
+        assignedIssues(
+          filter: {
+            ${filterParts.join('\n            ')}
+          }
+          first: ${String(fetchLimit)}
+          orderBy: createdAt
+        ) {
+          nodes {
+            id
+            identifier
+            title
+            description
+            parent { identifier title }
+            labels { nodes { name } }
+          }
+        }
+      }
+    }
+  `;
+    const variables = hasLabel
+        ? { teamId, label }
+        : { teamId };
+    return { query, variables };
+}
+/** Check if an issue has the HITL exclusion label. */
+function isHitlIssue(issue) {
+    return issue.labels?.nodes?.some((l) => l.name === 'clancy:hitl') === true;
+}
+/**
+ * Fetch candidate issues from Linear.
+ *
+ * @param opts - API key, team ID, and optional filters.
+ * @returns Array of fetched tickets (may be empty).
+ */
+export async function fetchIssues(opts) {
+    if (!isValidTeamId(opts.teamId))
+        return [];
+    const { apiKey, excludeHitl, limit = 5 } = opts;
+    const { query, variables } = buildIssuesQuery(opts);
+    const raw = await linearGraphql({
+        apiKey,
+        query,
+        variables,
+        fetcher: opts.fetcher,
+    });
+    const parsed = linearIssuesResponseSchema.safeParse(raw);
+    if (!parsed.success)
+        return [];
+    const allNodes = parsed.data.data?.viewer?.assignedIssues?.nodes ?? [];
+    const filtered = excludeHitl
+        ? allNodes.filter((n) => !isHitlIssue(n))
+        : allNodes;
+    return filtered.slice(0, limit).map(toLinearTicket);
+}
+//# sourceMappingURL=api.js.map

package/dist/board/linear/api/api.js.map

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

package/dist/board/linear/api/index.d.ts

@@ -0,0 +1,2 @@
+export { fetchIssues, isValidTeamId, linearGraphql, pingLinear, } from './api.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/board/linear/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/board/linear/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,aAAa,EACb,aAAa,EACb,UAAU,GACX,MAAM,UAAU,CAAC"}

package/dist/board/linear/api/index.js

@@ -0,0 +1,2 @@
+export { fetchIssues, isValidTeamId, linearGraphql, pingLinear, } from './api.js';
+//# sourceMappingURL=index.js.map

package/dist/board/linear/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/board/linear/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,aAAa,EACb,aAAa,EACb,UAAU,GACX,MAAM,UAAU,CAAC"}

package/dist/board/linear/index.d.ts

@@ -0,0 +1,3 @@
+export { createLinearBoard } from './linear-board.js';
+export { fetchBlockerStatus, fetchChildrenStatus } from './relations/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/board/linear/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/board/linear/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/board/linear/index.js

@@ -0,0 +1,3 @@
+export { createLinearBoard } from './linear-board.js';
+export { fetchBlockerStatus, fetchChildrenStatus } from './relations/index.js';
+//# sourceMappingURL=index.js.map

package/dist/board/linear/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/board/linear/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/board/linear/labels/index.d.ts

@@ -0,0 +1,2 @@
+export { addLabel, ensureLabel, removeLabel } from './labels.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/board/linear/labels/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/board/linear/labels/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/board/linear/labels/index.js

@@ -0,0 +1,2 @@
+export { addLabel, ensureLabel, removeLabel } from './labels.js';
+//# sourceMappingURL=index.js.map

package/dist/board/linear/labels/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/board/linear/labels/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/board/linear/labels/labels.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Linear issue label operations.
+ *
+ * Linear labels are ID-based — adding/removing requires reading the
+ * current label IDs, modifying the list, and writing back via GraphQL.
+ * Label name→UUID resolution uses a {@link CachedMap} for efficiency.
+ *
+ * The 3-step {@link ensureLabel} flow: team labels → workspace labels → create.
+ */
+import type { CachedMap } from '../../../shared/cache/index.js';
+import type { Fetcher } from '../../../shared/http/index.js';
+/** Options for {@link ensureLabel}. */
+type EnsureLabelOpts = {
+    readonly apiKey: string;
+    readonly teamId: string;
+    readonly labelCache: CachedMap<string, string>;
+    readonly label: string;
+    readonly fetcher?: Fetcher;
+};
+/**
+ * Ensure a label exists and cache its ID.
+ *
+ * 1. Check the label cache.
+ * 2. Search team labels.
+ * 3. Search workspace labels.
+ * 4. Create a new team-scoped label.
+ *
+ * @param opts - API key, team ID, cache, and label name.
+ * @returns Resolves when complete (best-effort — never throws).
+ */
+export declare function ensureLabel(opts: EnsureLabelOpts): Promise<void>;
+/** Options for {@link addLabel}. */
+type AddLabelOpts = {
+    readonly apiKey: string;
+    readonly labelCache: CachedMap<string, string>;
+    readonly issueKey: string;
+    readonly label: string;
+    readonly fetcher?: Fetcher;
+};
+/**
+ * Add a label to a Linear issue (best-effort).
+ *
+ * @param opts - API key, label cache, issue key, and label name.
+ * @returns Resolves when complete (best-effort — never throws).
+ */
+export declare function addLabel(opts: AddLabelOpts): Promise<void>;
+/** Options for {@link removeLabel}. */
+type RemoveLabelOpts = {
+    readonly apiKey: string;
+    readonly labelCache: CachedMap<string, string>;
+    readonly issueKey: string;
+    readonly label: string;
+    readonly fetcher?: Fetcher;
+};
+/**
+ * Remove a label from a Linear issue (best-effort).
+ *
+ * @param opts - API key, label cache, issue key, and label name.
+ * @returns Resolves when complete (best-effort — never throws).
+ */
+export declare function removeLabel(opts: RemoveLabelOpts): Promise<void>;
+export {};
+//# sourceMappingURL=labels.d.ts.map

package/dist/board/linear/labels/labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../../../src/board/linear/labels/labels.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAYxD,uCAAuC;AACvC,KAAK,eAAe,GAAG;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAsFF;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBtE;AAED,oCAAoC;AACpC,KAAK,YAAY,GAAG;IAClB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBhE;AAED,uCAAuC;AACvC,KAAK,eAAe,GAAG;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BtE"}

package/dist/board/linear/labels/labels.js

@@ -0,0 +1,204 @@
+import { linearIssueLabelSearchResponseSchema, linearLabelCreateResponseSchema, linearTeamLabelsResponseSchema, linearWorkspaceLabelsResponseSchema, } from '../../../schemas/index.js';
+import { safeLabel } from '../../../shared/label-helpers/index.js';
+import { linearGraphql } from '../api/index.js';
+/** Search team labels for a match by name and return its ID. */
+async function findTeamLabel(opts) {
+    const { apiKey, teamId, label, fetcher } = opts;
+    const query = `
+    query($teamId: String!, $name: String!) {
+      team(id: $teamId) {
+        labels(filter: { name: { eq: $name } }) { nodes { id name } }
+      }
+    }
+  `;
+    const raw = await linearGraphql({
+        apiKey,
+        query,
+        variables: { teamId, name: label },
+        fetcher,
+    });
+    const parsed = linearTeamLabelsResponseSchema.safeParse(raw);
+    return parsed.success
+        ? parsed.data.data?.team?.labels?.nodes?.[0]?.id
+        : undefined;
+}
+/** Search workspace labels for a match and return its ID. */
+async function findWorkspaceLabel(opts) {
+    const { apiKey, label, fetcher } = opts;
+    const query = `
+    query($name: String!) {
+      issueLabels(filter: { name: { eq: $name } }) {
+        nodes { id name }
+      }
+    }
+  `;
+    const raw = await linearGraphql({
+        apiKey,
+        query,
+        variables: { name: label },
+        fetcher,
+    });
+    const parsed = linearWorkspaceLabelsResponseSchema.safeParse(raw);
+    return parsed.success
+        ? parsed.data.data?.issueLabels?.nodes?.[0]?.id
+        : undefined;
+}
+/** Create a new team-scoped label and return its ID. */
+async function createTeamLabel(opts) {
+    const { apiKey, teamId, label, fetcher } = opts;
+    const mutation = `
+    mutation($teamId: String!, $name: String!) {
+      issueLabelCreate(input: { teamId: $teamId, name: $name, color: "#0075ca" }) {
+        issueLabel { id }
+        success
+      }
+    }
+  `;
+    const raw = await linearGraphql({
+        apiKey,
+        query: mutation,
+        variables: { teamId, name: label },
+        fetcher,
+    });
+    const parsed = linearLabelCreateResponseSchema.safeParse(raw);
+    return parsed.success
+        ? parsed.data.data?.issueLabelCreate?.issueLabel?.id
+        : undefined;
+}
+/**
+ * Ensure a label exists and cache its ID.
+ *
+ * 1. Check the label cache.
+ * 2. Search team labels.
+ * 3. Search workspace labels.
+ * 4. Create a new team-scoped label.
+ *
+ * @param opts - API key, team ID, cache, and label name.
+ * @returns Resolves when complete (best-effort — never throws).
+ */
+export async function ensureLabel(opts) {
+    const { apiKey, teamId, labelCache, label, fetcher } = opts;
+    const lookup = { apiKey, teamId, label, fetcher };
+    await safeLabel(async () => {
+        if (labelCache.has(label))
+            return;
+        const teamId_ = await findTeamLabel(lookup);
+        if (teamId_) {
+            labelCache.store(label, teamId_);
+            return;
+        }
+        const wsId = await findWorkspaceLabel(lookup);
+        if (wsId) {
+            labelCache.store(label, wsId);
+            return;
+        }
+        const newId = await createTeamLabel(lookup);
+        if (newId)
+            labelCache.store(label, newId);
+    }, 'ensureLabel');
+}
+/**
+ * Add a label to a Linear issue (best-effort).
+ *
+ * @param opts - API key, label cache, issue key, and label name.
+ * @returns Resolves when complete (best-effort — never throws).
+ */
+export async function addLabel(opts) {
+    const { apiKey, labelCache, issueKey, label, fetcher } = opts;
+    await safeLabel(async () => {
+        const labelId = labelCache.get(label);
+        if (!labelId)
+            return;
+        const issue = await fetchIssueLabelIds(apiKey, issueKey, fetcher);
+        if (!issue)
+            return;
+        const currentIds = issue.labelIds;
+        if (currentIds.includes(labelId))
+            return;
+        await updateIssueLabels({
+            apiKey,
+            issueId: issue.id,
+            labelIds: [...currentIds, labelId],
+            fetcher,
+        });
+    }, 'addLabel');
+}
+/**
+ * Remove a label from a Linear issue (best-effort).
+ *
+ * @param opts - API key, label cache, issue key, and label name.
+ * @returns Resolves when complete (best-effort — never throws).
+ */
+export async function removeLabel(opts) {
+    const { apiKey, labelCache, issueKey, label, fetcher } = opts;
+    await safeLabel(async () => {
+        const issue = await fetchIssueLabelIds(apiKey, issueKey, fetcher);
+        if (!issue)
+            return;
+        const cachedId = labelCache.get(label);
+        const currentLabels = issue.labels;
+        const targetId = cachedId ?? currentLabels.find((l) => l.name === label)?.id;
+        if (!targetId)
+            return;
+        const updatedIds = currentLabels
+            .map((l) => l.id)
+            .filter((id) => id !== targetId);
+        if (updatedIds.length === currentLabels.length)
+            return;
+        await updateIssueLabels({
+            apiKey,
+            issueId: issue.id,
+            labelIds: updatedIds,
+            fetcher,
+        });
+    }, 'removeLabel');
+}
+/** Fetch an issue's UUID and current label IDs by identifier. */
+async function fetchIssueLabelIds(apiKey, issueKey, fetcher) {
+    const query = `
+    query($identifier: String!) {
+      issueSearch: issues(filter: { identifier: { eq: $identifier } }, first: 1) {
+        nodes {
+          id
+          labels { nodes { id name } }
+        }
+      }
+    }
+  `;
+    const raw = await linearGraphql({
+        apiKey,
+        query,
+        variables: { identifier: issueKey },
+        fetcher,
+    });
+    const parsed = linearIssueLabelSearchResponseSchema.safeParse(raw);
+    if (!parsed.success)
+        return undefined;
+    const node = parsed.data.data?.issueSearch?.nodes?.[0];
+    if (!node)
+        return undefined;
+    const labels = node.labels?.nodes ?? [];
+    return {
+        id: node.id,
+        labelIds: labels.map((l) => l.id),
+        labels,
+    };
+}
+/** Update an issue's labels via GraphQL mutation. */
+async function updateIssueLabels(opts) {
+    const { apiKey, issueId, labelIds, fetcher } = opts;
+    const mutation = `
+    mutation($issueId: String!, $labelIds: [String!]!) {
+      issueUpdate(id: $issueId, input: { labelIds: $labelIds }) {
+        success
+      }
+    }
+  `;
+    await linearGraphql({
+        apiKey,
+        query: mutation,
+        variables: { issueId, labelIds },
+        fetcher,
+    });
+}
+//# sourceMappingURL=labels.js.map

package/dist/board/linear/labels/labels.js.map

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

package/dist/board/linear/linear-board.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Linear board factory.
+ *
+ * Returns a plain object conforming to the Board type, delegating
+ * to the Linear API, relations, and label functions.
+ */
+import type { LinearEnv } from '../../schemas/index.js';
+import type { Fetcher } from '../../shared/http/index.js';
+import type { Board } from '../../types/index.js';
+/**
+ * Create a Board implementation for Linear.
+ *
+ * @param env - The validated Linear environment variables.
+ * @param fetcher - Optional custom fetch function for DI in tests.
+ * @returns A Board object that delegates to Linear API functions.
+ */
+export declare function createLinearBoard(env: LinearEnv, fetcher?: Fetcher): Board;
+//# sourceMappingURL=linear-board.d.ts.map

package/dist/board/linear/linear-board.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear-board.d.ts","sourceRoot":"","sources":["../../../src/board/linear/linear-board.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,KAAK,EAAkC,MAAM,oBAAoB,CAAC;AAqGhF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,KAAK,CA4D1E"}

package/dist/board/linear/linear-board.js

@@ -0,0 +1,115 @@
+import { CachedMap } from '../../shared/cache/index.js';
+import { fetchIssues, isValidTeamId, pingLinear } from './api/index.js';
+import { addLabel, ensureLabel, removeLabel } from './labels/index.js';
+import { fetchBlockerStatus, fetchChildrenStatus, transitionIssue, } from './relations/index.js';
+/** Map a Linear ticket to the normalised FetchedTicket shape. */
+function toFetchedTicket(ticket) {
+    return {
+        key: ticket.key,
+        title: ticket.title,
+        description: ticket.description,
+        parentInfo: ticket.parentIdentifier ?? 'none',
+        blockers: 'None',
+        linearIssueId: ticket.issueId,
+        issueId: ticket.issueId,
+        labels: ticket.labels ?? [],
+        status: 'unstarted',
+    };
+}
+/** Fetch and normalise Linear issues into FetchedTickets. */
+async function fetchLinearTickets(ctx, opts) {
+    const tickets = await fetchIssues({
+        apiKey: ctx.apiKey,
+        teamId: ctx.teamId,
+        label: opts.buildLabel ?? ctx.defaultLabel,
+        excludeHitl: opts.excludeHitl,
+        fetcher: ctx.fetcher,
+    });
+    return tickets.map(toFetchedTicket);
+}
+/** Transition a Linear issue and log on success. */
+async function doTransition(ctx, ticket, status) {
+    if (!ticket.linearIssueId)
+        return false;
+    const ok = await transitionIssue({
+        apiKey: ctx.apiKey,
+        teamId: ctx.teamId,
+        issueId: ticket.linearIssueId,
+        stateName: status,
+        fetcher: ctx.fetcher,
+    });
+    if (ok)
+        console.log(`  → Transitioned to ${status}`);
+    return ok;
+}
+/** Ensure a label exists then add it to an issue. */
+async function ensureAndAddLabel(ctx, issueKey, label) {
+    await ensureLabel({
+        apiKey: ctx.apiKey,
+        teamId: ctx.teamId,
+        labelCache: ctx.labelCache,
+        label,
+        fetcher: ctx.fetcher,
+    });
+    await addLabel({
+        apiKey: ctx.apiKey,
+        labelCache: ctx.labelCache,
+        issueKey,
+        label,
+        fetcher: ctx.fetcher,
+    });
+}
+/**
+ * Create a Board implementation for Linear.
+ *
+ * @param env - The validated Linear environment variables.
+ * @param fetcher - Optional custom fetch function for DI in tests.
+ * @returns A Board object that delegates to Linear API functions.
+ */
+export function createLinearBoard(env, fetcher) {
+    const ctx = {
+        apiKey: env.LINEAR_API_KEY,
+        teamId: env.LINEAR_TEAM_ID,
+        defaultLabel: env.CLANCY_LABEL,
+        labelCache: new CachedMap(),
+        fetcher,
+    };
+    const doFetch = (opts) => fetchLinearTickets(ctx, opts);
+    return {
+        ping: () => pingLinear(ctx.apiKey, ctx.fetcher),
+        validateInputs: () => isValidTeamId(ctx.teamId)
+            ? undefined
+            : '✗ LINEAR_TEAM_ID contains invalid characters',
+        fetchTicket: async (opts) => (await doFetch(opts))[0],
+        fetchTickets: doFetch,
+        async fetchBlockerStatus(ticket) {
+            if (!ticket.issueId)
+                return false;
+            return fetchBlockerStatus(ctx.apiKey, ticket.issueId, ctx.fetcher);
+        },
+        fetchChildrenStatus: (parentKey, parentId) => fetchChildrenStatus({
+            apiKey: ctx.apiKey,
+            parentId: parentId ?? parentKey,
+            parentIdentifier: parentKey,
+            fetcher: ctx.fetcher,
+        }),
+        transitionTicket: (ticket, status) => doTransition(ctx, ticket, status),
+        ensureLabel: (label) => ensureLabel({
+            apiKey: ctx.apiKey,
+            teamId: ctx.teamId,
+            labelCache: ctx.labelCache,
+            label,
+            fetcher: ctx.fetcher,
+        }),
+        addLabel: (issueKey, label) => ensureAndAddLabel(ctx, issueKey, label),
+        removeLabel: (issueKey, label) => removeLabel({
+            apiKey: ctx.apiKey,
+            labelCache: ctx.labelCache,
+            issueKey,
+            label,
+            fetcher: ctx.fetcher,
+        }),
+        sharedEnv: () => env,
+    };
+}
+//# sourceMappingURL=linear-board.js.map

package/dist/board/linear/linear-board.js.map

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