@chief-clancy/core 0.1.0

package/dist/shared/git-token/index.js

@@ -0,0 +1,2 @@
+export { resolveGitToken } from './git-token.js';
+//# sourceMappingURL=index.js.map

package/dist/shared/git-token/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/git-token/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/shared/http/fetch-and-parse/fetch-and-parse.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Generic fetch → parse → validate utility.
+ *
+ * Eliminates the repeated try/fetch/check-ok/parse-json/validate-zod
+ * boilerplate across board modules.
+ */
+import type { ZodMiniType } from 'zod/mini';
+/** Injectable fetch function for dependency injection in tests. */
+export type Fetcher = (url: string, init?: RequestInit) => Promise<Response>;
+/** Options for {@link fetchAndParse}. */
+export type FetchAndParseOptions<T> = {
+    /** Zod schema to validate the response body against. */
+    readonly schema: ZodMiniType<T>;
+    /** Human-readable label for error messages (e.g., `'Jira API'`). */
+    readonly label: string;
+    /** Custom fetch function (e.g., `retryFetch`). Defaults to global `fetch`. */
+    readonly fetcher?: Fetcher;
+};
+/**
+ * Fetch a URL, parse the JSON response, and validate against a Zod schema.
+ *
+ * Returns the parsed data on success, or `undefined` on any failure
+ * (network error, non-OK status, invalid JSON, schema mismatch).
+ * All failures are logged to `console.warn` with the provided label.
+ *
+ * @param url - The URL to fetch.
+ * @param init - Standard `fetch` RequestInit options.
+ * @param opts - Schema, label, and optional custom fetcher.
+ * @returns The parsed and validated data, or `undefined` on failure.
+ */
+export declare function fetchAndParse<T>(url: string, init: RequestInit | undefined, opts: FetchAndParseOptions<T>): Promise<T | undefined>;
+//# sourceMappingURL=fetch-and-parse.d.ts.map

package/dist/shared/http/fetch-and-parse/fetch-and-parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-and-parse.d.ts","sourceRoot":"","sources":["../../../../src/shared/http/fetch-and-parse/fetch-and-parse.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,mEAAmE;AACnE,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE7E,yCAAyC;AACzC,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI;IACpC,wDAAwD;IACxD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IAChC,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAiBF;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAAC,CAAC,EACnC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,GAAG,SAAS,EAC7B,IAAI,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAC5B,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAgCxB"}

package/dist/shared/http/fetch-and-parse/fetch-and-parse.js

@@ -0,0 +1,53 @@
+/** Read a response body snippet for error messages (max 200 chars). */
+async function readBodySnippet(response) {
+    try {
+        const body = await response.text();
+        return body ? ` — ${body.slice(0, 200)}` : '';
+    }
+    catch {
+        return '';
+    }
+}
+/** Format a caught error value into a message string. */
+function formatError(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+/**
+ * Fetch a URL, parse the JSON response, and validate against a Zod schema.
+ *
+ * Returns the parsed data on success, or `undefined` on any failure
+ * (network error, non-OK status, invalid JSON, schema mismatch).
+ * All failures are logged to `console.warn` with the provided label.
+ *
+ * @param url - The URL to fetch.
+ * @param init - Standard `fetch` RequestInit options.
+ * @param opts - Schema, label, and optional custom fetcher.
+ * @returns The parsed and validated data, or `undefined` on failure.
+ */
+export async function fetchAndParse(url, init, opts) {
+    const { schema, label, fetcher = fetch } = opts;
+    const response = await fetcher(url, init).catch((err) => {
+        console.warn(`⚠ ${label} request failed: ${formatError(err)}`);
+        return undefined;
+    });
+    if (!response)
+        return undefined;
+    if (!response.ok) {
+        const detail = await readBodySnippet(response);
+        console.warn(`⚠ ${label} returned HTTP ${response.status}${detail}`);
+        return undefined;
+    }
+    const json = await response.json().catch(() => {
+        console.warn(`⚠ ${label} returned invalid JSON`);
+        return undefined;
+    });
+    if (json === undefined)
+        return undefined;
+    const parsed = schema.safeParse(json);
+    if (!parsed.success) {
+        console.warn(`⚠ ${label} unexpected response shape: ${parsed.error.message}`);
+        return undefined;
+    }
+    return parsed.data;
+}
+//# sourceMappingURL=fetch-and-parse.js.map

package/dist/shared/http/fetch-and-parse/fetch-and-parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-and-parse.js","sourceRoot":"","sources":["../../../../src/shared/http/fetch-and-parse/fetch-and-parse.ts"],"names":[],"mappings":"AAqBA,uEAAuE;AACvE,KAAK,UAAU,eAAe,CAAC,QAAkB;IAC/C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,yDAAyD;AACzD,SAAS,WAAW,CAAC,GAAY;IAC/B,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAW,EACX,IAA6B,EAC7B,IAA6B;IAE7B,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC;IAEhD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QAC/D,OAAO,CAAC,IAAI,CAAC,KAAK,KAAK,oBAAoB,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/D,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAEhC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,KAAK,KAAK,kBAAkB,QAAQ,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;QACrE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,IAAI,GAAY,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;QACrD,OAAO,CAAC,IAAI,CAAC,KAAK,KAAK,wBAAwB,CAAC,CAAC;QACjD,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAEzC,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CACV,KAAK,KAAK,+BAA+B,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAChE,CAAC;QACF,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC"}

package/dist/shared/http/fetch-and-parse/index.d.ts

@@ -0,0 +1,3 @@
+export { fetchAndParse } from './fetch-and-parse.js';
+export type { FetchAndParseOptions, Fetcher } from './fetch-and-parse.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/http/fetch-and-parse/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared/http/fetch-and-parse/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/shared/http/fetch-and-parse/index.js

@@ -0,0 +1,2 @@
+export { fetchAndParse } from './fetch-and-parse.js';
+//# sourceMappingURL=index.js.map

package/dist/shared/http/fetch-and-parse/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared/http/fetch-and-parse/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/shared/http/index.d.ts

@@ -0,0 +1,7 @@
+export { fetchAndParse } from './fetch-and-parse/index.js';
+export type { FetchAndParseOptions, Fetcher } from './fetch-and-parse/index.js';
+export { pingEndpoint } from './ping-endpoint/index.js';
+export type { PingEndpointOpts } from './ping-endpoint/index.js';
+export { retryFetch } from './retry-fetch/index.js';
+export type { RetryOptions } from './retry-fetch/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/http/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/http/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,YAAY,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/shared/http/index.js

@@ -0,0 +1,4 @@
+export { fetchAndParse } from './fetch-and-parse/index.js';
+export { pingEndpoint } from './ping-endpoint/index.js';
+export { retryFetch } from './retry-fetch/index.js';
+//# sourceMappingURL=index.js.map

package/dist/shared/http/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/http/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/shared/http/ping-endpoint/index.d.ts

@@ -0,0 +1,3 @@
+export { pingEndpoint } from './ping-endpoint.js';
+export type { PingEndpointOpts } from './ping-endpoint.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/http/ping-endpoint/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared/http/ping-endpoint/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/shared/http/ping-endpoint/index.js

@@ -0,0 +1,2 @@
+export { pingEndpoint } from './ping-endpoint.js';
+//# sourceMappingURL=index.js.map

package/dist/shared/http/ping-endpoint/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared/http/ping-endpoint/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/shared/http/ping-endpoint/ping-endpoint.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Generic endpoint ping with HTTP status code mapping.
+ */
+import type { Fetcher } from '../fetch-and-parse/fetch-and-parse.js';
+import type { PingResult } from '../../../types/index.js';
+/** Options for {@link pingEndpoint}. */
+export type PingEndpointOpts = {
+    /** The URL to ping. */
+    readonly url: string;
+    /** HTTP headers to send. */
+    readonly headers: Record<string, string>;
+    /** Map of HTTP status codes to error messages. */
+    readonly statusErrors: Record<number, string>;
+    /** Error message for network failures. */
+    readonly networkError: string;
+    /** Custom fetch function for DI in tests. */
+    readonly fetcher?: Fetcher;
+};
+/**
+ * Ping an API endpoint and map common HTTP error codes to messages.
+ *
+ * Returns `{ ok: true }` on success, or `{ ok: false, error }` with
+ * a human-readable message on failure. Includes a 10s timeout.
+ *
+ * @param opts - URL, headers, status-to-error map, and network error message.
+ * @returns A ping result with `ok` and optional `error`.
+ */
+export declare function pingEndpoint(opts: PingEndpointOpts): Promise<PingResult>;
+//# sourceMappingURL=ping-endpoint.d.ts.map

package/dist/shared/http/ping-endpoint/ping-endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ping-endpoint.d.ts","sourceRoot":"","sources":["../../../../src/shared/http/ping-endpoint/ping-endpoint.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uCAAuC,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,wCAAwC;AACxC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,uBAAuB;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,kDAAkD;IAClD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,0CAA0C;IAC1C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,UAAU,CAAC,CAsBrB"}

package/dist/shared/http/ping-endpoint/ping-endpoint.js

@@ -0,0 +1,31 @@
+/**
+ * Ping an API endpoint and map common HTTP error codes to messages.
+ *
+ * Returns `{ ok: true }` on success, or `{ ok: false, error }` with
+ * a human-readable message on failure. Includes a 10s timeout.
+ *
+ * @param opts - URL, headers, status-to-error map, and network error message.
+ * @returns A ping result with `ok` and optional `error`.
+ */
+export async function pingEndpoint(opts) {
+    const { url, headers, statusErrors, networkError, fetcher } = opts;
+    const doFetch = fetcher ?? fetch;
+    try {
+        const response = await doFetch(url, {
+            headers,
+            signal: AbortSignal.timeout(10_000),
+        });
+        // Drain body to release the connection back to the pool
+        await response.arrayBuffer().catch(() => { });
+        if (response.ok)
+            return { ok: true };
+        const mapped = statusErrors[response.status];
+        return mapped
+            ? { ok: false, error: mapped }
+            : { ok: false, error: `✗ HTTP ${response.status}` };
+    }
+    catch {
+        return { ok: false, error: networkError };
+    }
+}
+//# sourceMappingURL=ping-endpoint.js.map

package/dist/shared/http/ping-endpoint/ping-endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ping-endpoint.js","sourceRoot":"","sources":["../../../../src/shared/http/ping-endpoint/ping-endpoint.ts"],"names":[],"mappings":"AAoBA;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAsB;IAEtB,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACnE,MAAM,OAAO,GAAG,OAAO,IAAI,KAAK,CAAC;IAEjC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE;YAClC,OAAO;YACP,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;SACpC,CAAC,CAAC;QAEH,wDAAwD;QACxD,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAE7C,IAAI,QAAQ,CAAC,EAAE;YAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;QAErC,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC7C,OAAO,MAAM;YACX,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE;YAC9B,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;IAC5C,CAAC;AACH,CAAC"}

package/dist/shared/http/retry-fetch/index.d.ts

@@ -0,0 +1,3 @@
+export { retryFetch } from './retry-fetch.js';
+export type { RetryOptions } from './retry-fetch.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/http/retry-fetch/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared/http/retry-fetch/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/shared/http/retry-fetch/index.js

@@ -0,0 +1,2 @@
+export { retryFetch } from './retry-fetch.js';
+//# sourceMappingURL=index.js.map

package/dist/shared/http/retry-fetch/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared/http/retry-fetch/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/shared/http/retry-fetch/retry-fetch.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Fetch with automatic retry for transient failures.
+ *
+ * Handles 429 (rate limited) with Retry-After header, 5xx with exponential
+ * backoff, and network errors. Non-retryable responses (4xx other than 429)
+ * are returned immediately.
+ */
+/** Options for retry behaviour. */
+export type RetryOptions = {
+    /** Maximum number of retry attempts (excludes the initial attempt). Default: 3. */
+    readonly maxRetries?: number;
+    /** Base delay in milliseconds for exponential backoff. Default: 1000. */
+    readonly baseDelayMs?: number;
+    /** Maximum delay in milliseconds. Default: 10000. */
+    readonly maxDelayMs?: number;
+};
+/**
+ * Fetch with automatic retry for transient failures.
+ *
+ * - On 429 (rate limited): honours `Retry-After` header, then retries.
+ * - On 5xx: retries with exponential backoff.
+ * - On other errors: returns the response immediately (no retry).
+ * - On network error (fetch throws): retries with exponential backoff.
+ * - After `maxRetries` exhausted: returns the last response or throws
+ *   the last network error.
+ *
+ * @param url - The URL to fetch.
+ * @param init - Optional fetch init (method, headers, body, etc.).
+ * @param opts - Retry behaviour options.
+ * @returns The fetch Response.
+ */
+export declare function retryFetch(url: string, init?: RequestInit, opts?: RetryOptions): Promise<Response>;
+//# sourceMappingURL=retry-fetch.d.ts.map

package/dist/shared/http/retry-fetch/retry-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-fetch.d.ts","sourceRoot":"","sources":["../../../../src/shared/http/retry-fetch/retry-fetch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,mCAAmC;AACnC,MAAM,MAAM,YAAY,GAAG;IACzB,mFAAmF;IACnF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,qDAAqD;IACrD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AA+FF;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,WAAW,EAClB,IAAI,CAAC,EAAE,YAAY,GAClB,OAAO,CAAC,QAAQ,CAAC,CAUnB"}

package/dist/shared/http/retry-fetch/retry-fetch.js

@@ -0,0 +1,94 @@
+/**
+ * Fetch with automatic retry for transient failures.
+ *
+ * Handles 429 (rate limited) with Retry-After header, 5xx with exponential
+ * backoff, and network errors. Non-retryable responses (4xx other than 429)
+ * are returned immediately.
+ */
+/**
+ * Parse a Retry-After header value into milliseconds.
+ *
+ * Supports both delta-seconds (e.g. "120") and HTTP-date formats.
+ * Returns `undefined` if the header is missing or unparseable.
+ */
+function parseRetryAfter(header) {
+    if (!header)
+        return undefined;
+    const seconds = parseInt(header, 10);
+    if (!Number.isNaN(seconds) && seconds >= 0)
+        return seconds * 1000;
+    const date = new Date(header);
+    if (!Number.isNaN(date.getTime())) {
+        const delayMs = date.getTime() - Date.now();
+        return delayMs > 0 ? delayMs : 0;
+    }
+    return undefined;
+}
+/** Compute exponential backoff delay, capped at maxDelayMs. */
+function backoffDelay(attempt, baseDelayMs, maxDelayMs) {
+    return Math.min(baseDelayMs * 2 ** attempt, maxDelayMs);
+}
+/** Whether an HTTP status code is retryable. */
+function isRetryableStatus(status) {
+    return status === 429 || (status >= 500 && status <= 599);
+}
+/** Compute the retry delay for a retryable response. */
+function retryDelay(response, config, attempt) {
+    if (response.status === 429) {
+        const after = parseRetryAfter(response.headers.get('Retry-After'));
+        const fallback = backoffDelay(attempt, config.baseDelayMs, config.maxDelayMs);
+        return Math.min(after ?? fallback, config.maxDelayMs);
+    }
+    return backoffDelay(attempt, config.baseDelayMs, config.maxDelayMs);
+}
+/** Wait for a given number of milliseconds. */
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/** Recursive retry implementation. */
+async function attemptFetch(config, attempt) {
+    try {
+        const response = await fetch(config.url, config.init);
+        if (!isRetryableStatus(response.status))
+            return response;
+        if (attempt >= config.maxRetries)
+            return response;
+        const ms = retryDelay(response, config, attempt);
+        await response.arrayBuffer().catch(() => { });
+        await delay(ms);
+        return attemptFetch(config, attempt + 1);
+    }
+    catch (err) {
+        if (attempt >= config.maxRetries)
+            throw err;
+        const ms = backoffDelay(attempt, config.baseDelayMs, config.maxDelayMs);
+        await delay(ms);
+        return attemptFetch(config, attempt + 1);
+    }
+}
+/**
+ * Fetch with automatic retry for transient failures.
+ *
+ * - On 429 (rate limited): honours `Retry-After` header, then retries.
+ * - On 5xx: retries with exponential backoff.
+ * - On other errors: returns the response immediately (no retry).
+ * - On network error (fetch throws): retries with exponential backoff.
+ * - After `maxRetries` exhausted: returns the last response or throws
+ *   the last network error.
+ *
+ * @param url - The URL to fetch.
+ * @param init - Optional fetch init (method, headers, body, etc.).
+ * @param opts - Retry behaviour options.
+ * @returns The fetch Response.
+ */
+export async function retryFetch(url, init, opts) {
+    const config = {
+        url,
+        init,
+        maxRetries: Math.max(0, opts?.maxRetries ?? 3),
+        baseDelayMs: opts?.baseDelayMs ?? 1000,
+        maxDelayMs: opts?.maxDelayMs ?? 10_000,
+    };
+    return attemptFetch(config, 0);
+}
+//# sourceMappingURL=retry-fetch.js.map

package/dist/shared/http/retry-fetch/retry-fetch.js.map

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

package/dist/shared/label-helpers/index.d.ts

@@ -0,0 +1,3 @@
+export { modifyLabelList, safeLabel } from './label-helpers.js';
+export type { ModifyLabelListOpts } from './label-helpers.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/label-helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/label-helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAChE,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/shared/label-helpers/index.js

@@ -0,0 +1,2 @@
+export { modifyLabelList, safeLabel } from './label-helpers.js';
+//# sourceMappingURL=index.js.map

package/dist/shared/label-helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/label-helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/shared/label-helpers/label-helpers.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Shared label CRUD helpers for board wrappers.
+ *
+ * Boards with a read-modify-write pattern for labels (Jira, Shortcut,
+ * Notion, Azure DevOps) use {@link modifyLabelList} to eliminate the
+ * duplicated fetch → check → write boilerplate. All label operations
+ * wrap in {@link safeLabel} for consistent error handling.
+ */
+/**
+ * Wrap a label operation in try-catch with a warning on failure.
+ *
+ * Label operations are best-effort — they should never crash the run.
+ *
+ * @param fn - The async label operation to execute.
+ * @param operation - Human-readable name for error messages (e.g., `'addLabel'`).
+ * @returns Resolves when complete — never rejects.
+ */
+export declare function safeLabel(fn: () => Promise<void>, operation: string): Promise<void>;
+/** Options for {@link modifyLabelList}. */
+export type ModifyLabelListOpts<T extends string | number> = {
+    /** Board-specific function to fetch current labels. */
+    readonly fetchCurrent: () => Promise<readonly T[] | undefined>;
+    /** Board-specific function to write the updated list. */
+    readonly writeUpdated: (updated: readonly T[]) => Promise<void>;
+    /** The label (or ID) to add or remove. */
+    readonly target: T;
+    /** Whether to add or remove the target. */
+    readonly mode: 'add' | 'remove';
+};
+/**
+ * Read-modify-write a label list with idempotence checking.
+ *
+ * Fetches the current labels, checks if the target is already present
+ * (add) or absent (remove), and writes the updated list only when a
+ * change is needed. Works with string labels and numeric IDs.
+ *
+ * @param opts - Fetch/write callbacks, target label, and add/remove mode.
+ * @returns Resolves when the write completes (no-op if unchanged).
+ */
+export declare function modifyLabelList<T extends string | number>(opts: ModifyLabelListOpts<T>): Promise<void>;
+//# sourceMappingURL=label-helpers.d.ts.map

package/dist/shared/label-helpers/label-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"label-helpers.d.ts","sourceRoot":"","sources":["../../../src/shared/label-helpers/label-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAC7B,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EACvB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAQf;AAED,2CAA2C;AAC3C,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI;IAC3D,uDAAuD;IACvD,QAAQ,CAAC,YAAY,EAAE,MAAM,OAAO,CAAC,SAAS,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC;IAC/D,yDAAyD;IACzD,QAAQ,CAAC,YAAY,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACnB,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAC;CACjC,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAC7D,IAAI,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC3B,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/dist/shared/label-helpers/label-helpers.js

@@ -0,0 +1,51 @@
+/**
+ * Shared label CRUD helpers for board wrappers.
+ *
+ * Boards with a read-modify-write pattern for labels (Jira, Shortcut,
+ * Notion, Azure DevOps) use {@link modifyLabelList} to eliminate the
+ * duplicated fetch → check → write boilerplate. All label operations
+ * wrap in {@link safeLabel} for consistent error handling.
+ */
+/**
+ * Wrap a label operation in try-catch with a warning on failure.
+ *
+ * Label operations are best-effort — they should never crash the run.
+ *
+ * @param fn - The async label operation to execute.
+ * @param operation - Human-readable name for error messages (e.g., `'addLabel'`).
+ * @returns Resolves when complete — never rejects.
+ */
+export async function safeLabel(fn, operation) {
+    try {
+        await fn();
+    }
+    catch (err) {
+        console.warn(`⚠ ${operation} failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+/**
+ * Read-modify-write a label list with idempotence checking.
+ *
+ * Fetches the current labels, checks if the target is already present
+ * (add) or absent (remove), and writes the updated list only when a
+ * change is needed. Works with string labels and numeric IDs.
+ *
+ * @param opts - Fetch/write callbacks, target label, and add/remove mode.
+ * @returns Resolves when the write completes (no-op if unchanged).
+ */
+export async function modifyLabelList(opts) {
+    const { fetchCurrent, writeUpdated, target, mode } = opts;
+    const current = await fetchCurrent();
+    if (!current)
+        return;
+    const has = current.includes(target);
+    if (mode === 'add' && has)
+        return;
+    if (mode === 'remove' && !has)
+        return;
+    const updated = mode === 'add'
+        ? [...current, target]
+        : current.filter((item) => item !== target);
+    await writeUpdated(updated);
+}
+//# sourceMappingURL=label-helpers.js.map

package/dist/shared/label-helpers/label-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"label-helpers.js","sourceRoot":"","sources":["../../../src/shared/label-helpers/label-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,EAAuB,EACvB,SAAiB;IAEjB,IAAI,CAAC;QACH,MAAM,EAAE,EAAE,CAAC;IACb,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CACV,KAAK,SAAS,YAAY,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC7E,CAAC;IACJ,CAAC;AACH,CAAC;AAcD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAA4B;IAE5B,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;IAC1D,MAAM,OAAO,GAAG,MAAM,YAAY,EAAE,CAAC;IACrC,IAAI,CAAC,OAAO;QAAE,OAAO;IAErB,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,IAAI,KAAK,KAAK,IAAI,GAAG;QAAE,OAAO;IAClC,IAAI,IAAI,KAAK,QAAQ,IAAI,CAAC,GAAG;QAAE,OAAO;IAEtC,MAAM,OAAO,GACX,IAAI,KAAK,KAAK;QACZ,CAAC,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,CAAC;QACtB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IAChD,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;AAC9B,CAAC"}

package/dist/shared/remote/index.d.ts

@@ -0,0 +1,2 @@
+export { buildApiBaseUrl, parseRemote } from './remote.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/remote/index.d.ts.map

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

package/dist/shared/remote/index.js

@@ -0,0 +1,2 @@
+export { buildApiBaseUrl, parseRemote } from './remote.js';
+//# sourceMappingURL=index.js.map

package/dist/shared/remote/index.js.map

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

package/dist/shared/remote/remote.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Remote git host detection — pure parsing functions.
+ *
+ * Parses git remote URLs to detect the hosting platform (GitHub, GitLab,
+ * Bitbucket, etc.) and extract owner/repo/project info. No I/O — the
+ * actual `git remote get-url` shell-out lives in `git-ops/`.
+ */
+import type { GitPlatform, RemoteInfo } from '../../types/index.js';
+/**
+ * Parse a git remote URL into platform-specific info.
+ *
+ * Supports HTTPS, SSH, and SSH-URL formats for GitHub, GitLab, Bitbucket
+ * (Cloud and Server), Azure DevOps, and self-hosted instances.
+ *
+ * @param rawUrl - The raw git remote URL.
+ * @param platformOverride - Force a specific platform instead of detecting from hostname.
+ * @returns Parsed remote info with platform and path details.
+ */
+export declare function parseRemote(rawUrl: string, platformOverride?: GitPlatform): RemoteInfo;
+/**
+ * Detect the git hosting platform from a hostname.
+ *
+ * Uses known domain patterns. Self-hosted instances with custom domains
+ * (e.g. `git.acme.com`) fall through to `'unknown'` — use
+ * `CLANCY_GIT_PLATFORM` env var to override.
+ *
+ * @param hostname - The hostname from the remote URL.
+ * @returns The detected platform.
+ */
+export declare function detectPlatformFromHostname(hostname: string): GitPlatform;
+/**
+ * Build the API base URL for a given remote.
+ *
+ * @param remote - The parsed remote info.
+ * @param apiUrlOverride - Override from `CLANCY_GIT_API_URL` env var.
+ * @returns The API base URL, or `undefined` if not applicable.
+ */
+export declare function buildApiBaseUrl(remote: RemoteInfo, apiUrlOverride?: string): string | undefined;
+//# sourceMappingURL=remote.d.ts.map

package/dist/shared/remote/remote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../../src/shared/remote/remote.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAqJlE;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,gBAAgB,CAAC,EAAE,WAAW,GAC7B,UAAU,CASZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAcxE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,UAAU,EAClB,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,GAAG,SAAS,CAoBpB"}