@chief-clancy/core 0.1.0

package/dist/board/notion/relations/relations.js

@@ -0,0 +1,127 @@
+import { fetchPage, findPageByKey, findPropertyByName, getDescriptionText, getPageStatus, isCompleteStatus, isPageIncomplete, queryAllPages, queryDatabase, } from '../api/index.js';
+/** Check whether a page has an active (non-complete) status. */
+function hasActiveStatus(page, statusProp) {
+    const status = getPageStatus(page, statusProp);
+    return status !== undefined && !isCompleteStatus(status);
+}
+/**
+ * Check whether a Notion page is blocked by unresolved blockers.
+ *
+ * Checks "Blocked by" relation property first, then falls back to
+ * description text search for "Blocked by notion-{shortId}" references.
+ *
+ * @param opts - Connection context, page ID, and status property name.
+ * @returns `true` if any blocker is unresolved, `false` otherwise.
+ */
+export async function fetchBlockerStatus(opts) {
+    const { ctx, pageId, statusProp } = opts;
+    try {
+        const page = await fetchPage(ctx.token, pageId, ctx.fetcher);
+        if (!page)
+            return false;
+        const blocked = await checkRelationBlockers(ctx, page, statusProp);
+        if (blocked !== undefined)
+            return blocked;
+        return checkDescriptionBlockers({ ctx, page, pageId, statusProp });
+    }
+    catch {
+        return false;
+    }
+}
+/** Check blockers via "Blocked by" relation property. */
+async function checkRelationBlockers(ctx, page, statusProp) {
+    const blockedByProp = findPropertyByName(page, 'Blocked by');
+    if (blockedByProp?.type !== 'relation')
+        return undefined;
+    // Safe cast: type guard guarantees relation shape
+    const relations = blockedByProp.relation;
+    if (!relations.length)
+        return false;
+    const blockerPages = await Promise.all(relations.map((rel) => fetchPage(ctx.token, rel.id, ctx.fetcher)));
+    return blockerPages.some((blockerPage) => !!blockerPage && hasActiveStatus(blockerPage, statusProp));
+}
+/** Check blockers via description text "Blocked by notion-{id}" references. */
+async function checkDescriptionBlockers(opts) {
+    const { ctx, page, pageId, statusProp } = opts;
+    const description = getDescriptionText(page);
+    if (!description)
+        return false;
+    const blockerMatch = description.match(/Blocked by (notion-[a-f0-9]{8})/gi);
+    if (!blockerMatch)
+        return false;
+    const selfShortId = pageId.replace(/-/g, '').slice(0, 8);
+    const allPages = await queryAllPages({ ctx });
+    if (!allPages.length)
+        return false;
+    const isBlockedByActive = (match) => {
+        const shortId = match.replace(/blocked by notion-/i, '').toLowerCase();
+        if (shortId === selfShortId)
+            return false;
+        const candidate = allPages.find((p) => p.id.replace(/-/g, '').slice(0, 8) === shortId);
+        return candidate != null && hasActiveStatus(candidate, statusProp);
+    };
+    return blockerMatch.some(isBlockedByActive);
+}
+/**
+ * Fetch the children status of a parent page (dual-mode).
+ *
+ * Mode 1: Search descriptions for `Epic: notion-{shortId}` text.
+ * Mode 2: Query by parent relation property as fallback.
+ *
+ * @param opts - Connection context, parent key, and property names.
+ * @returns The children status, or `undefined` on failure.
+ */
+export async function fetchChildrenStatus(opts) {
+    const { ctx, parentKey, parentProp, statusProp } = opts;
+    try {
+        const epicRef = `Epic: ${parentKey}`;
+        const textResult = await fetchChildrenByDescription(ctx, epicRef, statusProp);
+        if (textResult && textResult.total > 0)
+            return textResult;
+        const parentPage = await findPageByKey(ctx, parentKey);
+        if (!parentPage)
+            return undefined;
+        return await fetchChildrenByRelation({
+            ctx,
+            parentPageId: parentPage.id,
+            parentProp,
+            statusProp,
+        });
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Count children by searching descriptions for an Epic: reference. */
+async function fetchChildrenByDescription(ctx, descriptionRef, statusProp) {
+    const allPages = await queryAllPages({ ctx });
+    if (!allPages.length)
+        return undefined;
+    const matching = allPages.filter((page) => {
+        const desc = getDescriptionText(page);
+        return desc?.includes(descriptionRef);
+    });
+    return countStatus(matching, statusProp);
+}
+/** Count children via relation property filter. */
+async function fetchChildrenByRelation(opts) {
+    const { ctx, parentPageId, parentProp, statusProp } = opts;
+    const result = await queryDatabase({
+        ctx,
+        filter: {
+            property: parentProp,
+            relation: { contains: parentPageId },
+        },
+    });
+    if (!result)
+        return undefined;
+    return countStatus([...result.results], statusProp);
+}
+/** Count total and incomplete pages. */
+function countStatus(pages, statusProp) {
+    return {
+        total: pages.length,
+        incomplete: pages.filter((p) => isPageIncomplete(p, statusProp)).length,
+    };
+}
+//# sourceMappingURL=relations.js.map

package/dist/board/notion/relations/relations.js.map

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

package/dist/board/shortcut/api/api.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Shortcut REST API functions.
+ *
+ * Low-level functions for interacting with the Shortcut v3 API.
+ * Auth uses `Shortcut-Token` header (no "Bearer" prefix).
+ */
+import type { ShortcutWorkflowsResponse } from '../../../schemas/index.js';
+import type { Cached } from '../../../shared/cache/index.js';
+import type { Fetcher } from '../../../shared/http/index.js';
+import type { PingResult } from '../../../types/index.js';
+/** Shortcut REST API v3 endpoint. */
+export declare const SHORTCUT_API = "https://api.app.shortcut.com/api/v3";
+/**
+ * Build standard Shortcut API request headers.
+ *
+ * @param token - The Shortcut API token.
+ * @returns Headers object for Shortcut API requests.
+ */
+export declare function shortcutHeaders(token: string): Record<string, string>;
+/**
+ * Ping the Shortcut API to verify connectivity and credentials.
+ *
+ * Tries `/member-info` first, falls back to `/workflows` (some
+ * token types return 404 on member-info).
+ *
+ * @param token - The Shortcut API token.
+ * @returns Ping result with `ok` and optional `error`.
+ */
+export declare function pingShortcut(token: string, fetcher?: Fetcher): Promise<PingResult>;
+/**
+ * Fetch all workflows from Shortcut (cached per process).
+ *
+ * @param token - The Shortcut API token.
+ * @param cache - The workflow cache instance.
+ * @returns The workflows array, or an empty array on failure.
+ */
+export declare function fetchWorkflows(token: string, cache: Cached<ShortcutWorkflowsResponse>, fetcher?: Fetcher): Promise<ShortcutWorkflowsResponse>;
+/** Options for {@link resolveWorkflowStateId}. */
+type ResolveStateOpts = {
+    readonly token: string;
+    readonly cache: Cached<ShortcutWorkflowsResponse>;
+    readonly workflowName?: string;
+    readonly fetcher?: Fetcher;
+};
+/**
+ * Resolve a workflow state name to its numeric ID.
+ *
+ * @param stateName - The state name (case-insensitive).
+ * @param opts - Token, cache, and optional workflow name.
+ * @returns The state ID, or `undefined` if not found.
+ */
+export declare function resolveWorkflowStateId(stateName: string, opts: ResolveStateOpts): Promise<number | undefined>;
+/**
+ * Resolve all workflow state IDs matching a given type.
+ *
+ * @param stateType - The state type (e.g., `"unstarted"`, `"done"`).
+ * @param opts - Token, cache, and optional workflow name.
+ * @returns Array of matching state IDs.
+ */
+export declare function resolveWorkflowStateIdsByType(stateType: string, opts: ResolveStateOpts): Promise<readonly number[]>;
+/**
+ * Build the set of "done" workflow state IDs.
+ *
+ * @param token - The Shortcut API token.
+ * @param cache - The workflow cache instance.
+ * @returns A set of numeric state IDs with type `"done"`.
+ */
+export declare function resolveDoneStateIds(token: string, cache: Cached<ShortcutWorkflowsResponse>): Promise<ReadonlySet<number>>;
+/** Shortcut ticket with optional epic and label info. */
+type ShortcutTicket = {
+    readonly key: string;
+    readonly title: string;
+    readonly description: string;
+    readonly provider: 'shortcut';
+    readonly storyId: number;
+    readonly epicId?: number;
+    readonly labels?: readonly string[];
+};
+/** Options for {@link fetchStories}. */
+type FetchStoriesOpts = {
+    readonly token: string;
+    readonly workflowStateIds: readonly number[];
+    readonly label?: string;
+    readonly excludeHitl?: boolean;
+    readonly limit?: number;
+    readonly fetcher?: Fetcher;
+};
+/**
+ * Fetch candidate stories from Shortcut.
+ *
+ * @param opts - Token, workflow state IDs, and optional filters.
+ * @returns Array of fetched tickets (may be empty).
+ */
+export declare function fetchStories(opts: FetchStoriesOpts): Promise<readonly ShortcutTicket[]>;
+/** Options for {@link transitionStory}. */
+type TransitionStoryOpts = {
+    readonly token: string;
+    readonly storyId: number;
+    readonly workflowStateId: number;
+    readonly fetcher?: Fetcher;
+};
+/**
+ * Transition a Shortcut story to a new workflow state.
+ *
+ * @param opts - Token, story ID, target state ID, and optional fetcher.
+ * @returns `true` if the transition succeeded.
+ */
+export declare function transitionStory(opts: TransitionStoryOpts): Promise<boolean>;
+export {};
+//# sourceMappingURL=api.d.ts.map

package/dist/board/shortcut/api/api.d.ts.map

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

package/dist/board/shortcut/api/api.js

@@ -0,0 +1,227 @@
+import { shortcutMemberInfoResponseSchema, shortcutStorySearchResponseSchema, shortcutWorkflowsResponseSchema, } from '../../../schemas/index.js';
+import { fetchAndParse } from '../../../shared/http/index.js';
+/** Shortcut REST API v3 endpoint. */
+export const SHORTCUT_API = 'https://api.app.shortcut.com/api/v3';
+/**
+ * Build standard Shortcut API request headers.
+ *
+ * @param token - The Shortcut API token.
+ * @returns Headers object for Shortcut API requests.
+ */
+export function shortcutHeaders(token) {
+    return {
+        'Shortcut-Token': token,
+        'Content-Type': 'application/json',
+    };
+}
+/**
+ * Ping the Shortcut API to verify connectivity and credentials.
+ *
+ * Tries `/member-info` first, falls back to `/workflows` (some
+ * token types return 404 on member-info).
+ *
+ * @param token - The Shortcut API token.
+ * @returns Ping result with `ok` and optional `error`.
+ */
+export async function pingShortcut(token, fetcher) {
+    const headers = shortcutHeaders(token);
+    const doFetch = fetcher ?? fetch;
+    const response = await doFetch(`${SHORTCUT_API}/member-info`, { headers })
+        .then(async (res) => res.ok ? res : doFetch(`${SHORTCUT_API}/workflows`, { headers }))
+        .catch(() => undefined);
+    if (!response) {
+        return { ok: false, error: '✗ Could not reach Shortcut — check network' };
+    }
+    if (!response.ok) {
+        return response.status === 401 || response.status === 403
+            ? {
+                ok: false,
+                error: '✗ Shortcut auth failed — check SHORTCUT_API_TOKEN',
+            }
+            : { ok: false, error: `✗ Shortcut API returned HTTP ${response.status}` };
+    }
+    try {
+        const json = await response.json();
+        const parsed = shortcutMemberInfoResponseSchema.safeParse(json);
+        if (parsed.success && parsed.data.id)
+            return { ok: true };
+        if (Array.isArray(json))
+            return { ok: true };
+    }
+    catch {
+        // Invalid JSON — treat as auth issue
+    }
+    return {
+        ok: false,
+        error: '✗ Shortcut auth failed — check SHORTCUT_API_TOKEN',
+    };
+}
+/**
+ * Fetch all workflows from Shortcut (cached per process).
+ *
+ * @param token - The Shortcut API token.
+ * @param cache - The workflow cache instance.
+ * @returns The workflows array, or an empty array on failure.
+ */
+export async function fetchWorkflows(token, cache, fetcher) {
+    const cached = cache.get();
+    if (cached)
+        return cached;
+    const data = await fetchAndParse(`${SHORTCUT_API}/workflows`, { headers: shortcutHeaders(token) }, {
+        schema: shortcutWorkflowsResponseSchema,
+        label: 'Shortcut workflows',
+        fetcher,
+    });
+    if (data)
+        cache.store(data);
+    return data ?? [];
+}
+/**
+ * Resolve a workflow state name to its numeric ID.
+ *
+ * @param stateName - The state name (case-insensitive).
+ * @param opts - Token, cache, and optional workflow name.
+ * @returns The state ID, or `undefined` if not found.
+ */
+export async function resolveWorkflowStateId(stateName, opts) {
+    const { token, cache, workflowName, fetcher } = opts;
+    const workflows = await fetchWorkflows(token, cache, fetcher);
+    const lower = stateName.toLowerCase();
+    const matching = workflows
+        .filter((wf) => !workflowName || wf.name === workflowName)
+        .flatMap((wf) => wf.states)
+        .find((s) => s.name.toLowerCase() === lower);
+    return matching?.id;
+}
+/**
+ * Resolve all workflow state IDs matching a given type.
+ *
+ * @param stateType - The state type (e.g., `"unstarted"`, `"done"`).
+ * @param opts - Token, cache, and optional workflow name.
+ * @returns Array of matching state IDs.
+ */
+export async function resolveWorkflowStateIdsByType(stateType, opts) {
+    const { token, cache, workflowName, fetcher } = opts;
+    const workflows = await fetchWorkflows(token, cache, fetcher);
+    return workflows.flatMap((wf) => {
+        if (workflowName && wf.name !== workflowName)
+            return [];
+        return wf.states.filter((s) => s.type === stateType).map((s) => s.id);
+    });
+}
+/**
+ * Build the set of "done" workflow state IDs.
+ *
+ * @param token - The Shortcut API token.
+ * @param cache - The workflow cache instance.
+ * @returns A set of numeric state IDs with type `"done"`.
+ */
+export async function resolveDoneStateIds(token, cache) {
+    const ids = await resolveWorkflowStateIdsByType('done', { token, cache });
+    return new Set(ids);
+}
+/** Parse the dual-shape Shortcut search response. */
+function parseSearchResponse(json) {
+    const parsed = shortcutStorySearchResponseSchema.safeParse(json);
+    if (parsed.success)
+        return parsed.data.data;
+    // Shortcut may return a bare array instead of { data: [...] }
+    if (Array.isArray(json)) {
+        const wrapped = shortcutStorySearchResponseSchema.safeParse({ data: json });
+        if (wrapped.success)
+            return wrapped.data.data;
+    }
+    return [];
+}
+/** Map a raw story node to a ShortcutTicket. */
+function toShortcutTicket(story) {
+    return {
+        key: `sc-${String(story.id)}`,
+        title: story.name,
+        description: story.description ?? '',
+        provider: 'shortcut',
+        storyId: story.id,
+        epicId: story.epic_id ?? undefined,
+        labels: story.labels
+            ?.map((l) => l.name)
+            .filter((n) => Boolean(n)),
+    };
+}
+/**
+ * Fetch candidate stories from Shortcut.
+ *
+ * @param opts - Token, workflow state IDs, and optional filters.
+ * @returns Array of fetched tickets (may be empty).
+ */
+/** Execute the /stories/search POST and parse the response. */
+async function searchStories(token, body, fetcher) {
+    const doFetch = fetcher ?? fetch;
+    const response = await doFetch(`${SHORTCUT_API}/stories/search`, {
+        method: 'POST',
+        headers: shortcutHeaders(token),
+        body: JSON.stringify(body),
+    }).catch((err) => {
+        console.warn(`⚠ Shortcut API request failed: ${err instanceof Error ? err.message : String(err)}`);
+        return undefined;
+    });
+    if (!response)
+        return [];
+    if (!response.ok) {
+        const text = await response.text().catch(() => '');
+        console.warn(`⚠ Shortcut story search returned HTTP ${response.status} — ${text}`);
+        return [];
+    }
+    const json = await response.json().catch(() => {
+        console.warn('⚠ Shortcut API returned invalid JSON');
+        return undefined;
+    });
+    return json === undefined ? [] : parseSearchResponse(json);
+}
+/**
+ * Fetch candidate stories from Shortcut.
+ *
+ * @param opts - Token, workflow state IDs, and optional filters.
+ * @returns Array of fetched tickets (may be empty).
+ */
+export async function fetchStories(opts) {
+    const { token, workflowStateIds, label, excludeHitl, limit = 5 } = opts;
+    if (!workflowStateIds.length)
+        return [];
+    // Shortcut removed workflow_state_id from /stories/search (2026).
+    // Filter by label server-side, then by workflow state client-side.
+    // archived: false is required — empty body returns no results.
+    const stateSet = new Set(workflowStateIds);
+    const body = {
+        archived: false,
+        ...(label ? { label_name: label } : {}),
+    };
+    const stories = await searchStories(token, body, opts.fetcher);
+    // Client-side workflow state filter (was server-side before API change)
+    const stateFiltered = stories.filter((s) => s.workflow_state_id !== undefined && stateSet.has(s.workflow_state_id));
+    const hitlFiltered = excludeHitl
+        ? stateFiltered.filter((s) => !s.labels?.some((l) => l.name === 'clancy:hitl'))
+        : stateFiltered;
+    return hitlFiltered.slice(0, limit).map(toShortcutTicket);
+}
+/**
+ * Transition a Shortcut story to a new workflow state.
+ *
+ * @param opts - Token, story ID, target state ID, and optional fetcher.
+ * @returns `true` if the transition succeeded.
+ */
+export async function transitionStory(opts) {
+    const { token, storyId, workflowStateId, fetcher } = opts;
+    const doFetch = fetcher ?? fetch;
+    try {
+        const response = await doFetch(`${SHORTCUT_API}/stories/${String(storyId)}`, {
+            method: 'PUT',
+            headers: shortcutHeaders(token),
+            body: JSON.stringify({ workflow_state_id: workflowStateId }),
+        });
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=api.js.map

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

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

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

@@ -0,0 +1,2 @@
+export { fetchStories, pingShortcut, resolveDoneStateIds, resolveWorkflowStateId, resolveWorkflowStateIdsByType, SHORTCUT_API, shortcutHeaders, transitionStory, } from './api.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/board/shortcut/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,sBAAsB,EACtB,6BAA6B,EAC7B,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,UAAU,CAAC"}

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

@@ -0,0 +1,2 @@
+export { fetchStories, pingShortcut, resolveDoneStateIds, resolveWorkflowStateId, resolveWorkflowStateIdsByType, SHORTCUT_API, shortcutHeaders, transitionStory, } from './api.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/board/shortcut/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,sBAAsB,EACtB,6BAA6B,EAC7B,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,UAAU,CAAC"}

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

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

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

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

package/dist/board/shortcut/index.js

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

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,95 @@
+/**
+ * Shortcut label operations.
+ *
+ * Labels are numeric-ID-based. Adding/removing uses read-modify-write
+ * via {@link modifyLabelList}. Label list is cached per process via
+ * {@link Cached}. Cache is invalidated when a new label is created.
+ */
+import type { ShortcutLabelsResponse } from '../../../schemas/index.js';
+import type { Cached } from '../../../shared/cache/index.js';
+import type { Fetcher } from '../../../shared/http/index.js';
+/** Options for {@link fetchLabels}. */
+type FetchLabelsOpts = {
+    readonly token: string;
+    readonly cache: Cached<ShortcutLabelsResponse>;
+    readonly refresh?: boolean;
+    readonly fetcher?: Fetcher;
+};
+/**
+ * Fetch all labels from Shortcut (cached per process).
+ *
+ * @param opts - Token, cache, optional refresh flag, and optional fetcher.
+ * @returns The labels array, or an empty array on failure.
+ */
+export declare function fetchLabels(opts: FetchLabelsOpts): Promise<ShortcutLabelsResponse>;
+/**
+ * Create a new label in Shortcut.
+ *
+ * @param token - The Shortcut API token.
+ * @param name - The label name to create.
+ * @param fetcher - Optional custom fetch function.
+ * @returns The created label's numeric ID, or `undefined` on failure.
+ */
+export declare function createLabel(token: string, name: string, fetcher?: Fetcher): Promise<number | undefined>;
+/**
+ * Fetch current label IDs for a story.
+ *
+ * @param token - The Shortcut API token.
+ * @param storyId - The story numeric ID.
+ * @returns The label IDs array, or `undefined` on failure.
+ */
+export declare function getStoryLabelIds(token: string, storyId: number, fetcher?: Fetcher): Promise<readonly number[] | undefined>;
+/** Options for {@link updateStoryLabelIds}. */
+type UpdateStoryLabelsOpts = {
+    readonly token: string;
+    readonly storyId: number;
+    readonly labelIds: readonly number[];
+    readonly fetcher?: Fetcher;
+};
+/**
+ * Update a story's label IDs.
+ *
+ * @param opts - Token, story ID, and label IDs array.
+ * @returns Resolves when complete (best-effort — never throws).
+ */
+export declare function updateStoryLabelIds(opts: UpdateStoryLabelsOpts): Promise<void>;
+/** Options for {@link ensureLabel}. */
+type EnsureLabelOpts = {
+    readonly token: string;
+    readonly labelCache: Cached<ShortcutLabelsResponse>;
+    readonly label: string;
+    readonly fetcher?: Fetcher;
+};
+/**
+ * Ensure a label exists in Shortcut. Creates it if missing.
+ *
+ * @param opts - Token, cache, and label name.
+ * @returns Resolves when complete (best-effort — never throws).
+ */
+export declare function ensureLabel(opts: EnsureLabelOpts): Promise<void>;
+/** Parse a story ID from a Shortcut key (e.g., `'sc-123'` → `123`). */
+export declare function parseStoryId(key: string): number | undefined;
+/** Options for {@link addLabel} and {@link removeLabel}. */
+type ModifyLabelOpts = {
+    readonly token: string;
+    readonly labelCache: Cached<ShortcutLabelsResponse>;
+    readonly issueKey: string;
+    readonly label: string;
+    readonly fetcher?: Fetcher;
+};
+/**
+ * Add a label to a Shortcut story (best-effort).
+ *
+ * @param opts - Token, cache, issue key, and label name.
+ * @returns Resolves when complete (best-effort — never throws).
+ */
+export declare function addLabel(opts: ModifyLabelOpts): Promise<void>;
+/**
+ * Remove a label from a Shortcut story (best-effort).
+ *
+ * @param opts - Token, cache, issue key, and label name.
+ * @returns Resolves when complete (best-effort — never throws).
+ */
+export declare function removeLabel(opts: ModifyLabelOpts): Promise<void>;
+export {};
+//# sourceMappingURL=labels.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../../../src/board/shortcut/labels/labels.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAYxD,uCAAuC;AACvC,KAAK,eAAe,GAAG;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,sBAAsB,CAAC,CAAC;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,sBAAsB,CAAC,CAajC;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAkB7B;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC,CAYxC;AAED,+CAA+C;AAC/C,KAAK,qBAAqB,GAAG;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED,uCAAuC;AACvC,KAAK,eAAe,GAAG;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,sBAAsB,CAAC,CAAC;IACpD,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,CAUtE;AAWD,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG5D;AAED,4DAA4D;AAC5D,KAAK,eAAe,GAAG;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,sBAAsB,CAAC,CAAC;IACpD,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,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBnE;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBtE"}