@chief-clancy/core 0.1.0

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

@@ -0,0 +1,154 @@
+import { shortcutLabelCreateResponseSchema, shortcutLabelsResponseSchema, shortcutStoryDetailResponseSchema, } from '../../../schemas/index.js';
+import { fetchAndParse } from '../../../shared/http/index.js';
+import { modifyLabelList, safeLabel } from '../../../shared/label-helpers/index.js';
+import { SHORTCUT_API, shortcutHeaders } from '../api/index.js';
+/**
+ * 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 async function fetchLabels(opts) {
+    const { token, cache, refresh, fetcher } = opts;
+    const cached = cache.get();
+    if (cached && !refresh)
+        return cached;
+    const data = await fetchAndParse(`${SHORTCUT_API}/labels`, { headers: shortcutHeaders(token) }, { schema: shortcutLabelsResponseSchema, label: 'Shortcut labels', fetcher });
+    if (data)
+        cache.store(data);
+    return data ?? [];
+}
+/**
+ * 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 async function createLabel(token, name, fetcher) {
+    const data = await fetchAndParse(`${SHORTCUT_API}/labels`, {
+        method: 'POST',
+        headers: shortcutHeaders(token),
+        body: JSON.stringify({ name, color: '#0075ca' }),
+    }, {
+        schema: shortcutLabelCreateResponseSchema,
+        label: 'Shortcut label create',
+        fetcher,
+    });
+    // Cache is refreshed by the caller (ensureLabel passes refresh: true)
+    return data?.id;
+}
+/**
+ * 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 async function getStoryLabelIds(token, storyId, fetcher) {
+    const data = await fetchAndParse(`${SHORTCUT_API}/stories/${String(storyId)}`, { headers: shortcutHeaders(token) }, {
+        schema: shortcutStoryDetailResponseSchema,
+        label: 'Shortcut story',
+        fetcher,
+    });
+    return data ? (data.label_ids ?? []) : undefined;
+}
+/**
+ * Update a story's label IDs.
+ *
+ * @param opts - Token, story ID, and label IDs array.
+ * @returns Resolves when complete (best-effort — never throws).
+ */
+export async function updateStoryLabelIds(opts) {
+    const { token, storyId, labelIds, fetcher } = opts;
+    const doFetch = fetcher ?? fetch;
+    try {
+        const response = await doFetch(`${SHORTCUT_API}/stories/${String(storyId)}`, {
+            method: 'PUT',
+            headers: shortcutHeaders(token),
+            body: JSON.stringify({ label_ids: labelIds }),
+        });
+        if (!response.ok) {
+            console.warn(`⚠ Shortcut story label update returned HTTP ${response.status}`);
+        }
+    }
+    catch (err) {
+        console.warn(`⚠ Shortcut story label update failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+/**
+ * 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 async function ensureLabel(opts) {
+    const { token, labelCache, label, fetcher } = opts;
+    await safeLabel(async () => {
+        const labels = await fetchLabels({ token, cache: labelCache, fetcher });
+        const existing = labels.find((l) => l.name === label);
+        if (existing)
+            return;
+        await createLabel(token, label, fetcher);
+        await fetchLabels({ token, cache: labelCache, refresh: true, fetcher });
+    }, 'ensureLabel');
+}
+/** Resolve a label name to its numeric ID. */
+async function resolveLabelId(opts) {
+    const { token, labelCache, label, fetcher } = opts;
+    const labels = await fetchLabels({ token, cache: labelCache, fetcher });
+    return labels.find((l) => l.name === label)?.id;
+}
+/** Parse a story ID from a Shortcut key (e.g., `'sc-123'` → `123`). */
+export function parseStoryId(key) {
+    const num = parseInt(key.replace('sc-', ''), 10);
+    return Number.isNaN(num) ? undefined : num;
+}
+/**
+ * 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 async function addLabel(opts) {
+    const { token, labelCache, issueKey, label, fetcher } = opts;
+    await safeLabel(async () => {
+        const storyId = parseStoryId(issueKey);
+        if (storyId === undefined)
+            return;
+        const labelId = await resolveLabelId({ token, labelCache, label, fetcher });
+        if (labelId === undefined)
+            return;
+        await modifyLabelList({
+            fetchCurrent: () => getStoryLabelIds(token, storyId, fetcher),
+            writeUpdated: (ids) => updateStoryLabelIds({ token, storyId, labelIds: ids, fetcher }),
+            target: labelId,
+            mode: 'add',
+        });
+    }, 'addLabel');
+}
+/**
+ * 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 async function removeLabel(opts) {
+    const { token, labelCache, issueKey, label, fetcher } = opts;
+    await safeLabel(async () => {
+        const storyId = parseStoryId(issueKey);
+        if (storyId === undefined)
+            return;
+        const labelId = await resolveLabelId({ token, labelCache, label, fetcher });
+        if (labelId === undefined)
+            return;
+        await modifyLabelList({
+            fetchCurrent: () => getStoryLabelIds(token, storyId, fetcher),
+            writeUpdated: (ids) => updateStoryLabelIds({ token, storyId, labelIds: ids, fetcher }),
+            target: labelId,
+            mode: 'remove',
+        });
+    }, 'removeLabel');
+}
+//# sourceMappingURL=labels.js.map

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,44 @@
+/**
+ * Shortcut story relationship functions.
+ *
+ * Checks blocker status (via story_links + blocked flag), children
+ * status (via Epic: text convention + native epic stories API).
+ */
+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 { ChildrenStatus } from '../../../types/index.js';
+/** Options for {@link fetchBlockerStatus}. */
+type FetchBlockerOpts = {
+    readonly token: string;
+    readonly storyId: number;
+    readonly workflowCache: Cached<ShortcutWorkflowsResponse>;
+    readonly fetcher?: Fetcher;
+};
+/**
+ * Check whether a Shortcut story is blocked by unresolved blockers.
+ *
+ * @param opts - Token, story ID, workflow cache, and optional fetcher.
+ * @returns `true` if any blocker is unresolved, `false` otherwise.
+ */
+export declare function fetchBlockerStatus(opts: FetchBlockerOpts): Promise<boolean>;
+/** Options for {@link fetchChildrenStatus}. */
+type FetchChildrenOpts = {
+    readonly token: string;
+    readonly epicId: number;
+    readonly workflowCache: Cached<ShortcutWorkflowsResponse>;
+    readonly parentKey?: string;
+    readonly fetcher?: Fetcher;
+};
+/**
+ * Fetch children status of a Shortcut epic (dual-mode).
+ *
+ * Tries `Epic: {parentKey}` text convention first. Falls back
+ * to the native `/epics/{id}/stories` endpoint.
+ *
+ * @param opts - Token, epic ID, workflow cache, and optional parent key.
+ * @returns The children status, or `undefined` on failure.
+ */
+export declare function fetchChildrenStatus(opts: FetchChildrenOpts): Promise<ChildrenStatus | undefined>;
+export {};
+//# sourceMappingURL=relations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"relations.d.ts","sourceRoot":"","sources":["../../../../src/board/shortcut/relations/relations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AA4CzD,8CAA8C;AAC9C,KAAK,gBAAgB,GAAG;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,yBAAyB,CAAC,CAAC;IAC1D,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,OAAO,CAAC,CAsClB;AAED,+CAA+C;AAC/C,KAAK,iBAAiB,GAAG;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,yBAAyB,CAAC,CAAC;IAC1D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAmBrC"}

package/dist/board/shortcut/relations/relations.js

@@ -0,0 +1,118 @@
+import { shortcutEpicStoriesResponseSchema, shortcutStoryDetailResponseSchema, shortcutStorySearchResponseSchema, } from '../../../schemas/index.js';
+import { fetchAndParse } from '../../../shared/http/index.js';
+import { resolveDoneStateIds, SHORTCUT_API, shortcutHeaders, } from '../api/index.js';
+/** Check if a single blocking story is unresolved (not in a done state). */
+async function isBlockerUnresolved(opts) {
+    const { token, blockerId, doneStateIds, fetcher } = opts;
+    const blocker = await fetchAndParse(`${SHORTCUT_API}/stories/${String(blockerId)}`, { headers: shortcutHeaders(token) }, {
+        schema: shortcutStoryDetailResponseSchema,
+        label: 'Shortcut blocker',
+        fetcher,
+    });
+    if (!blocker)
+        return false;
+    return (blocker.workflow_state_id !== undefined &&
+        !doneStateIds.has(blocker.workflow_state_id));
+}
+/**
+ * Check whether a Shortcut story is blocked by unresolved blockers.
+ *
+ * @param opts - Token, story ID, workflow cache, and optional fetcher.
+ * @returns `true` if any blocker is unresolved, `false` otherwise.
+ */
+export async function fetchBlockerStatus(opts) {
+    const { token, storyId, workflowCache, fetcher } = opts;
+    try {
+        const story = await fetchAndParse(`${SHORTCUT_API}/stories/${String(storyId)}`, { headers: shortcutHeaders(token) }, {
+            schema: shortcutStoryDetailResponseSchema,
+            label: 'Shortcut story',
+            fetcher,
+        });
+        if (!story?.blocked)
+            return false;
+        const blockerLinks = (story.story_links ?? []).filter((link) => link.verb === 'is blocked by');
+        if (!blockerLinks.length)
+            return false;
+        const doneStateIds = await resolveDoneStateIds(token, workflowCache);
+        const results = await Promise.all(blockerLinks.map((link) => isBlockerUnresolved({
+            token,
+            blockerId: link.object_id,
+            doneStateIds,
+            fetcher,
+        })));
+        return results.some(Boolean);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Fetch children status of a Shortcut epic (dual-mode).
+ *
+ * Tries `Epic: {parentKey}` text convention first. Falls back
+ * to the native `/epics/{id}/stories` endpoint.
+ *
+ * @param opts - Token, epic ID, workflow cache, and optional parent key.
+ * @returns The children status, or `undefined` on failure.
+ */
+export async function fetchChildrenStatus(opts) {
+    const { token, epicId, workflowCache, parentKey, fetcher } = opts;
+    try {
+        const shared = { token, workflowCache, fetcher };
+        if (parentKey) {
+            const epicResult = await fetchChildrenByDescription({
+                ...shared,
+                descriptionRef: `Epic: ${parentKey}`,
+            });
+            if (epicResult && epicResult.total > 0)
+                return epicResult;
+        }
+        return await fetchChildrenByEpicApi({ ...shared, epicId });
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Count children status from stories and done state IDs. */
+function countChildrenStatus(stories, doneStateIds) {
+    const total = stories.length;
+    const incomplete = stories.filter((s) => s.workflow_state_id === undefined ||
+        !doneStateIds.has(s.workflow_state_id)).length;
+    return { total, incomplete };
+}
+/** Fetch children by searching story descriptions for a text reference. */
+async function fetchChildrenByDescription(opts) {
+    const { token, workflowCache, fetcher, descriptionRef } = opts;
+    const data = await fetchAndParse(`${SHORTCUT_API}/stories/search`, {
+        method: 'POST',
+        headers: shortcutHeaders(token),
+        body: JSON.stringify({ query: descriptionRef }),
+    }, {
+        schema: shortcutStorySearchResponseSchema,
+        label: 'Shortcut story search',
+        fetcher,
+    });
+    if (!data)
+        return undefined;
+    const stories = data.data;
+    if (!stories.length)
+        return { total: 0, incomplete: 0 };
+    const doneStateIds = await resolveDoneStateIds(token, workflowCache);
+    return countChildrenStatus(stories, doneStateIds);
+}
+/** Fetch children from the native epic stories endpoint. */
+async function fetchChildrenByEpicApi(opts) {
+    const { token, workflowCache, fetcher, epicId } = opts;
+    const stories = await fetchAndParse(`${SHORTCUT_API}/epics/${String(epicId)}/stories`, { headers: shortcutHeaders(token) }, {
+        schema: shortcutEpicStoriesResponseSchema,
+        label: 'Shortcut epic stories',
+        fetcher,
+    });
+    if (!stories)
+        return undefined;
+    if (!stories.length)
+        return { total: 0, incomplete: 0 };
+    const doneStateIds = await resolveDoneStateIds(token, workflowCache);
+    return countChildrenStatus(stories, doneStateIds);
+}
+//# sourceMappingURL=relations.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"shortcut-board.d.ts","sourceRoot":"","sources":["../../../src/board/shortcut/shortcut-board.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EACV,WAAW,EAGZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,KAAK,EAAkC,MAAM,oBAAoB,CAAC;AAkKhF;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,WAAW,EAChB,OAAO,CAAC,EAAE,OAAO,GAChB,KAAK,CA+CP"}

package/dist/board/shortcut/shortcut-board.js

@@ -0,0 +1,143 @@
+import { Cached } from '../../shared/cache/index.js';
+import { fetchStories, pingShortcut, resolveWorkflowStateId, resolveWorkflowStateIdsByType, transitionStory, } from './api/index.js';
+import { addLabel, ensureLabel, parseStoryId, removeLabel, } from './labels/index.js';
+import { fetchBlockerStatus, fetchChildrenStatus } from './relations/index.js';
+/** Map a story ticket to the normalised FetchedTicket shape. */
+function toFetchedTicket(ticket) {
+    return {
+        key: ticket.key,
+        title: ticket.title,
+        description: ticket.description,
+        parentInfo: ticket.epicId ? `epic-${String(ticket.epicId)}` : 'none',
+        blockers: 'None',
+        issueId: String(ticket.storyId),
+        labels: ticket.labels ?? [],
+        status: 'unstarted',
+    };
+}
+/** Build the resolve-state opts from context. */
+function stateOpts(ctx) {
+    return {
+        token: ctx.token,
+        cache: ctx.workflowCache,
+        workflowName: ctx.workflowName,
+        fetcher: ctx.fetcher,
+    };
+}
+/** Fetch and normalise Shortcut stories into FetchedTickets. */
+async function fetchShortcutTickets(ctx, opts) {
+    const stateIds = await resolveWorkflowStateIdsByType('unstarted', stateOpts(ctx));
+    const tickets = await fetchStories({
+        token: ctx.token,
+        workflowStateIds: stateIds,
+        label: opts.buildLabel ?? ctx.defaultLabel,
+        excludeHitl: opts.excludeHitl,
+        fetcher: ctx.fetcher,
+    });
+    return tickets.map(toFetchedTicket);
+}
+/** Transition a story and log on success. */
+async function doTransition(ctx, ticket, status) {
+    const storyId = parseStoryId(ticket.key);
+    if (storyId === undefined)
+        return false;
+    const stateId = await resolveWorkflowStateId(status, stateOpts(ctx));
+    if (stateId === undefined) {
+        console.warn(`⚠ Shortcut workflow state "${status}" not found — check workflow configuration`);
+        return false;
+    }
+    const ok = await transitionStory({
+        token: ctx.token,
+        storyId,
+        workflowStateId: stateId,
+        fetcher: ctx.fetcher,
+    });
+    if (ok)
+        console.log(`  → Transitioned to ${status}`);
+    return ok;
+}
+/** Check blocker status for a Shortcut story. */
+async function fetchShortcutBlocker(ctx, key) {
+    const storyId = parseStoryId(key);
+    return storyId !== undefined
+        ? fetchBlockerStatus({
+            token: ctx.token,
+            storyId,
+            workflowCache: ctx.workflowCache,
+            fetcher: ctx.fetcher,
+        })
+        : false;
+}
+/** Resolve children status for a Shortcut epic. */
+async function fetchShortcutChildren(ctx, parentKey, parentId) {
+    const raw = parentId ?? parentKey.replace(/^(?:sc-|epic-)/, '');
+    const epicId = parseInt(raw, 10);
+    return Number.isNaN(epicId)
+        ? undefined
+        : fetchChildrenStatus({
+            token: ctx.token,
+            epicId,
+            workflowCache: ctx.workflowCache,
+            parentKey,
+            fetcher: ctx.fetcher,
+        });
+}
+/** Ensure a label exists then add it to a story. */
+async function ensureAndAddLabel(ctx, issueKey, label) {
+    await ensureLabel({
+        token: ctx.token,
+        labelCache: ctx.labelCache,
+        label,
+        fetcher: ctx.fetcher,
+    });
+    await addLabel({
+        token: ctx.token,
+        labelCache: ctx.labelCache,
+        issueKey,
+        label,
+        fetcher: ctx.fetcher,
+    });
+}
+/**
+ * Create a Board implementation for Shortcut.
+ *
+ * @param env - The validated Shortcut environment variables.
+ * @param fetcher - Optional custom fetch function for DI in tests.
+ * @returns A Board object that delegates to Shortcut API functions.
+ */
+export function createShortcutBoard(env, fetcher) {
+    const ctx = {
+        token: env.SHORTCUT_API_TOKEN,
+        workflowName: env.SHORTCUT_WORKFLOW,
+        defaultLabel: env.CLANCY_LABEL,
+        workflowCache: new Cached(),
+        labelCache: new Cached(),
+        fetcher,
+    };
+    const doFetch = (opts) => fetchShortcutTickets(ctx, opts);
+    return {
+        ping: () => pingShortcut(ctx.token, ctx.fetcher),
+        validateInputs: () => undefined,
+        fetchTicket: async (opts) => (await doFetch(opts))[0],
+        fetchTickets: doFetch,
+        fetchBlockerStatus: (ticket) => fetchShortcutBlocker(ctx, ticket.key),
+        fetchChildrenStatus: (parentKey, parentId) => fetchShortcutChildren(ctx, parentKey, parentId),
+        transitionTicket: (ticket, status) => doTransition(ctx, ticket, status),
+        ensureLabel: (label) => ensureLabel({
+            token: ctx.token,
+            labelCache: ctx.labelCache,
+            label,
+            fetcher: ctx.fetcher,
+        }),
+        addLabel: (issueKey, label) => ensureAndAddLabel(ctx, issueKey, label),
+        removeLabel: (issueKey, label) => removeLabel({
+            token: ctx.token,
+            labelCache: ctx.labelCache,
+            issueKey,
+            label,
+            fetcher: ctx.fetcher,
+        }),
+        sharedEnv: () => env,
+    };
+}
+//# sourceMappingURL=shortcut-board.js.map

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

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

package/dist/dev/lifecycle/branch/branch.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Branch name computation for ticket workflows.
+ *
+ * Pure functions that compute feature and target branch names
+ * based on the board provider and ticket metadata.
+ */
+import type { BoardProvider } from '../../../types/index.js';
+/**
+ * Compute the feature branch name for a ticket.
+ *
+ * - GitHub: `feature/issue-{number}` (e.g., `feature/issue-42`)
+ * - All others: `feature/{key-lowercase}` (e.g., `feature/proj-123`)
+ *
+ * @param provider - The board provider.
+ * @param key - The ticket key (e.g., `'PROJ-123'`, `'#42'`, `'ENG-123'`).
+ * @returns The feature branch name.
+ */
+export declare function computeTicketBranch(provider: BoardProvider, key: string): string;
+/**
+ * Compute the target branch for merging.
+ *
+ * If the ticket has a parent (epic/milestone), branches from that parent's
+ * branch. Otherwise falls back to the base branch.
+ *
+ * - GitHub issue ref (`#N`): `epic/{number}`
+ * - GitHub milestone title: `milestone/{slug}`
+ * - All others: `epic/{key-lowercase}`
+ *
+ * @param provider - The board provider.
+ * @param baseBranch - The default base branch (e.g., `'main'`).
+ * @param parent - Optional parent identifier (epic key, milestone title, parent ID).
+ * @returns The target branch name.
+ */
+export declare function computeTargetBranch(provider: BoardProvider, baseBranch: string, parent?: string): string;
+//# sourceMappingURL=branch.d.ts.map

package/dist/dev/lifecycle/branch/branch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch.d.ts","sourceRoot":"","sources":["../../../../src/dev/lifecycle/branch/branch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,aAAa,EACvB,GAAG,EAAE,MAAM,GACV,MAAM,CAOR;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAeR"}

package/dist/dev/lifecycle/branch/branch.js

@@ -0,0 +1,48 @@
+/**
+ * Compute the feature branch name for a ticket.
+ *
+ * - GitHub: `feature/issue-{number}` (e.g., `feature/issue-42`)
+ * - All others: `feature/{key-lowercase}` (e.g., `feature/proj-123`)
+ *
+ * @param provider - The board provider.
+ * @param key - The ticket key (e.g., `'PROJ-123'`, `'#42'`, `'ENG-123'`).
+ * @returns The feature branch name.
+ */
+export function computeTicketBranch(provider, key) {
+    if (provider === 'github') {
+        const number = key.replace('#', '');
+        return `feature/issue-${number}`;
+    }
+    return `feature/${key.toLowerCase()}`;
+}
+/**
+ * Compute the target branch for merging.
+ *
+ * If the ticket has a parent (epic/milestone), branches from that parent's
+ * branch. Otherwise falls back to the base branch.
+ *
+ * - GitHub issue ref (`#N`): `epic/{number}`
+ * - GitHub milestone title: `milestone/{slug}`
+ * - All others: `epic/{key-lowercase}`
+ *
+ * @param provider - The board provider.
+ * @param baseBranch - The default base branch (e.g., `'main'`).
+ * @param parent - Optional parent identifier (epic key, milestone title, parent ID).
+ * @returns The target branch name.
+ */
+export function computeTargetBranch(provider, baseBranch, parent) {
+    if (!parent)
+        return baseBranch;
+    if (provider === 'github') {
+        const issueRefMatch = parent.match(/^#(\d+)$/);
+        if (issueRefMatch)
+            return `epic/${issueRefMatch[1]}`;
+        const slug = parent
+            .toLowerCase()
+            .replace(/\s+/g, '-')
+            .replace(/[^a-z0-9-]/g, '');
+        return `milestone/${slug}`;
+    }
+    return `epic/${parent.toLowerCase()}`;
+}
+//# sourceMappingURL=branch.js.map

package/dist/dev/lifecycle/branch/branch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch.js","sourceRoot":"","sources":["../../../../src/dev/lifecycle/branch/branch.ts"],"names":[],"mappings":"AAQA;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAuB,EACvB,GAAW;IAEX,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACpC,OAAO,iBAAiB,MAAM,EAAE,CAAC;IACnC,CAAC;IAED,OAAO,WAAW,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;AACxC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAuB,EACvB,UAAkB,EAClB,MAAe;IAEf,IAAI,CAAC,MAAM;QAAE,OAAO,UAAU,CAAC;IAE/B,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC/C,IAAI,aAAa;YAAE,OAAO,QAAQ,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;QAErD,MAAM,IAAI,GAAG,MAAM;aAChB,WAAW,EAAE;aACb,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;aACpB,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;QAC9B,OAAO,aAAa,IAAI,EAAE,CAAC;IAC7B,CAAC;IAED,OAAO,QAAQ,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;AACxC,CAAC"}

package/dist/dev/lifecycle/branch/index.d.ts

@@ -0,0 +1,2 @@
+export { computeTargetBranch, computeTicketBranch } from './branch.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/dev/lifecycle/branch/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/dev/lifecycle/branch/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}

package/dist/dev/lifecycle/branch/index.js

@@ -0,0 +1,2 @@
+export { computeTargetBranch, computeTicketBranch } from './branch.js';
+//# sourceMappingURL=index.js.map

package/dist/dev/lifecycle/branch/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/dev/lifecycle/branch/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}