chief-clancy 0.5.3 → 0.5.5

package/dist/scripts/shared/pull-request/gitlab/gitlab.js

@@ -0,0 +1,154 @@
+/**
+ * GitLab merge request creation and review state checking.
+ *
+ * Uses the GitLab REST API v4 to create merge requests, check review state,
+ * and fetch review comments.
+ * Supports both gitlab.com and self-hosted instances.
+ *
+ * Auth: `PRIVATE-TOKEN` header (personal access token with `api` scope).
+ */
+import { gitlabDiscussionsSchema, gitlabMrListSchema, } from '../../../../schemas/gitlab-mr.js';
+import { postPullRequest } from '../post-pr/post-pr.js';
+import { extractReworkContent, isReworkComment, } from '../rework-comment/rework-comment.js';
+/**
+ * Create a merge request on GitLab.
+ *
+ * @param token - The GitLab personal access token.
+ * @param apiBase - The API base URL (e.g. `https://gitlab.com/api/v4`).
+ * @param projectPath - The raw project path (e.g. `group/subgroup/project`). URL-encoded internally.
+ * @param sourceBranch - The source branch name.
+ * @param targetBranch - The target branch name.
+ * @param title - The MR title.
+ * @param description - The MR body (markdown).
+ * @returns A result with the MR URL and IID on success, or an error message.
+ */
+export async function createMergeRequest(token, apiBase, projectPath, sourceBranch, targetBranch, title, description) {
+    const encodedPath = encodeURIComponent(projectPath);
+    return postPullRequest(`${apiBase}/projects/${encodedPath}/merge_requests`, { 'PRIVATE-TOKEN': token }, {
+        source_branch: sourceBranch,
+        target_branch: targetBranch,
+        title,
+        description,
+        remove_source_branch: true,
+    }, (json) => {
+        const data = json;
+        return { url: data.web_url ?? '', number: data.iid ?? 0 };
+    }, (status, text) => status === 409 && text.includes('already exists'));
+}
+/**
+ * Check the review state of an open MR for a given branch.
+ *
+ * Finds the open MR matching the source branch, fetches all discussions.
+ * Inline notes (type `DiffNote`) always trigger rework. General conversation
+ * notes only trigger rework when prefixed with `Rework:`.
+ *
+ * @param token - The GitLab personal access token.
+ * @param apiBase - The API base URL (e.g. `https://gitlab.com/api/v4`).
+ * @param projectPath - The raw project path (e.g. `group/subgroup/project`). URL-encoded internally.
+ * @param branch - The source branch to look up.
+ * @param since - ISO 8601 timestamp; only notes created after this time trigger rework.
+ * @returns The review state if an open MR exists, otherwise `undefined`.
+ */
+export async function checkMrReviewState(token, apiBase, projectPath, branch, since) {
+    try {
+        const encodedPath = encodeURIComponent(projectPath);
+        const mrUrl = `${apiBase}/projects/${encodedPath}/merge_requests?source_branch=${branch}&state=opened`;
+        const mrRes = await fetch(mrUrl, {
+            headers: { 'PRIVATE-TOKEN': token },
+        });
+        if (!mrRes.ok)
+            return undefined;
+        const data = gitlabMrListSchema.parse(await mrRes.json());
+        if (data.length === 0)
+            return undefined;
+        const mr = data[0];
+        const discussionsUrl = `${apiBase}/projects/${encodedPath}/merge_requests/${mr.iid}/discussions?per_page=100`;
+        const discussionsRes = await fetch(discussionsUrl, {
+            headers: { 'PRIVATE-TOKEN': token },
+        });
+        if (!discussionsRes.ok)
+            return undefined;
+        const discussions = gitlabDiscussionsSchema.parse(await discussionsRes.json());
+        let hasRework = false;
+        for (const discussion of discussions) {
+            for (const note of discussion.notes) {
+                if (note.system)
+                    continue;
+                if (since && note.created_at && note.created_at <= since)
+                    continue;
+                if (note.type === 'DiffNote' &&
+                    note.resolvable !== false &&
+                    note.resolved !== true) {
+                    hasRework = true;
+                    break;
+                }
+                if (isReworkComment(note.body)) {
+                    hasRework = true;
+                    break;
+                }
+            }
+            if (hasRework)
+                break;
+        }
+        return {
+            changesRequested: hasRework,
+            prNumber: mr.iid,
+            prUrl: mr.web_url,
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Fetch feedback comments from an MR's discussions.
+ *
+ * Inline notes (type `DiffNote`) are always included — they inherently
+ * represent change requests. General conversation notes are only included
+ * when they start with `Rework:` (case-insensitive), with the prefix
+ * stripped. Inline notes are prefixed with `[new_path]` when available.
+ *
+ * @param token - The GitLab personal access token.
+ * @param apiBase - The API base URL (e.g. `https://gitlab.com/api/v4`).
+ * @param projectPath - The raw project path. URL-encoded internally.
+ * @param mrIid - The MR internal ID (iid).
+ * @param since - ISO 8601 timestamp; only notes created after this time are returned.
+ * @returns An array of feedback descriptions.
+ */
+export async function fetchMrReviewComments(token, apiBase, projectPath, mrIid, since) {
+    try {
+        const encodedPath = encodeURIComponent(projectPath);
+        const url = `${apiBase}/projects/${encodedPath}/merge_requests/${mrIid}/discussions?per_page=100`;
+        const res = await fetch(url, {
+            headers: { 'PRIVATE-TOKEN': token },
+        });
+        if (!res.ok)
+            return [];
+        const discussions = gitlabDiscussionsSchema.parse(await res.json());
+        const comments = [];
+        for (const discussion of discussions) {
+            for (const note of discussion.notes) {
+                if (note.system)
+                    continue;
+                if (since && note.created_at && note.created_at <= since)
+                    continue;
+                if (note.type === 'DiffNote' &&
+                    note.resolvable !== false &&
+                    note.resolved !== true) {
+                    const prefix = note.position?.new_path
+                        ? `[${note.position.new_path}] `
+                        : '';
+                    comments.push(`${prefix}${note.body}`);
+                }
+                else if (isReworkComment(note.body)) {
+                    comments.push(extractReworkContent(note.body));
+                }
+            }
+        }
+        return comments;
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=gitlab.js.map

package/dist/scripts/shared/pull-request/gitlab/gitlab.js.map

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

package/dist/scripts/shared/pull-request/post-pr/post-pr.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Shared pull request creation utility.
+ *
+ * Wraps the common POST + error-handling pattern used by all three
+ * git host PR creation functions (GitHub, GitLab, Bitbucket).
+ */
+import type { PrCreationResult } from '../../../../types/index.js';
+/**
+ * POST a pull request / merge request and return a typed result.
+ *
+ * Handles the common try/catch, response parsing, error formatting,
+ * and "already exists" detection shared by all git host implementations.
+ *
+ * @param url - The API endpoint to POST to.
+ * @param headers - HTTP headers (including auth).
+ * @param body - The request body (JSON-serialised).
+ * @param parseSuccess - Extract `{ url, number }` from the success response JSON.
+ * @param isAlreadyExists - Optional check for duplicate PR detection.
+ * @returns A typed `PrCreationResult`.
+ */
+export declare function postPullRequest(url: string, headers: Record<string, string>, body: Record<string, unknown>, parseSuccess: (json: unknown) => {
+    url: string;
+    number: number;
+}, isAlreadyExists?: (status: number, text: string) => boolean): Promise<PrCreationResult>;
+/**
+ * Build a Basic Auth header value from username and token.
+ *
+ * Used by Bitbucket Cloud which requires HTTP Basic Auth.
+ */
+export declare function basicAuth(username: string, token: string): string;
+//# sourceMappingURL=post-pr.d.ts.map

package/dist/scripts/shared/pull-request/post-pr/post-pr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-pr.d.ts","sourceRoot":"","sources":["../../../../../src/scripts/shared/pull-request/post-pr/post-pr.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;;;;;;;;;;;GAYG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAChE,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,GAC1D,OAAO,CAAC,gBAAgB,CAAC,CA0C3B;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjE"}

package/dist/scripts/shared/pull-request/post-pr/post-pr.js

@@ -0,0 +1,61 @@
+/**
+ * POST a pull request / merge request and return a typed result.
+ *
+ * Handles the common try/catch, response parsing, error formatting,
+ * and "already exists" detection shared by all git host implementations.
+ *
+ * @param url - The API endpoint to POST to.
+ * @param headers - HTTP headers (including auth).
+ * @param body - The request body (JSON-serialised).
+ * @param parseSuccess - Extract `{ url, number }` from the success response JSON.
+ * @param isAlreadyExists - Optional check for duplicate PR detection.
+ * @returns A typed `PrCreationResult`.
+ */
+export async function postPullRequest(url, headers, body, parseSuccess, isAlreadyExists) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 30_000);
+    try {
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: { ...headers, 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+            signal: controller.signal,
+        });
+        if (!response.ok) {
+            const text = await response.text().catch(() => '');
+            const alreadyExists = isAlreadyExists?.(response.status, text) ?? false;
+            return {
+                ok: false,
+                error: `HTTP ${response.status}${text ? `: ${text.slice(0, 200)}` : ''}`,
+                alreadyExists,
+            };
+        }
+        const json = await response.json();
+        const parsed = parseSuccess(json);
+        if (!parsed.url && !parsed.number) {
+            return {
+                ok: false,
+                error: 'PR created but response missing URL and number',
+            };
+        }
+        return { ok: true, url: parsed.url, number: parsed.number };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+/**
+ * Build a Basic Auth header value from username and token.
+ *
+ * Used by Bitbucket Cloud which requires HTTP Basic Auth.
+ */
+export function basicAuth(username, token) {
+    return `Basic ${Buffer.from(`${username}:${token}`).toString('base64')}`;
+}
+//# sourceMappingURL=post-pr.js.map

package/dist/scripts/shared/pull-request/post-pr/post-pr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-pr.js","sourceRoot":"","sources":["../../../../../src/scripts/shared/pull-request/post-pr/post-pr.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAW,EACX,OAA+B,EAC/B,IAA6B,EAC7B,YAAgE,EAChE,eAA2D;IAE3D,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;IAE7D,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC3D,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAC1B,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACnD,MAAM,aAAa,GAAG,eAAe,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC;YAExE,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,QAAQ,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;gBACxE,aAAa;aACd,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAY,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAElC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YAClC,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,gDAAgD;aACxD,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAC9D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACxD,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,QAAgB,EAAE,KAAa;IACvD,OAAO,SAAS,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,IAAI,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;AAC3E,CAAC"}

package/dist/scripts/shared/pull-request/pr-body/pr-body.d.ts

@@ -0,0 +1,19 @@
+/**
+ * PR/MR body builder.
+ *
+ * Constructs the pull request description with a link back to the
+ * board ticket and a Clancy footer.
+ */
+import type { BoardConfig, Ticket } from '../../../../types/index.js';
+/**
+ * Build the PR/MR body for a ticket.
+ *
+ * Includes a link back to the board ticket (auto-close for GitHub Issues)
+ * and a Clancy attribution footer.
+ *
+ * @param config - The board configuration.
+ * @param ticket - The ticket being implemented.
+ * @returns The PR body as a markdown string.
+ */
+export declare function buildPrBody(config: BoardConfig, ticket: Ticket): string;
+//# sourceMappingURL=pr-body.d.ts.map

package/dist/scripts/shared/pull-request/pr-body/pr-body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-body.d.ts","sourceRoot":"","sources":["../../../../../src/scripts/shared/pull-request/pr-body/pr-body.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE5D;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CA2CvE"}

package/dist/scripts/shared/pull-request/pr-body/pr-body.js

@@ -0,0 +1,42 @@
+/**
+ * Build the PR/MR body for a ticket.
+ *
+ * Includes a link back to the board ticket (auto-close for GitHub Issues)
+ * and a Clancy attribution footer.
+ *
+ * @param config - The board configuration.
+ * @param ticket - The ticket being implemented.
+ * @returns The PR body as a markdown string.
+ */
+export function buildPrBody(config, ticket) {
+    const lines = [];
+    switch (config.provider) {
+        case 'github':
+            lines.push(`Closes ${ticket.key}`);
+            break;
+        case 'jira':
+            lines.push(`**Jira:** [${ticket.key}](${config.env.JIRA_BASE_URL}/browse/${ticket.key})`);
+            break;
+        case 'linear':
+            lines.push(`**Linear:** ${ticket.key}`);
+            break;
+    }
+    lines.push('');
+    if (ticket.description) {
+        lines.push('## Description');
+        lines.push('');
+        lines.push(ticket.description);
+        lines.push('');
+    }
+    lines.push('---');
+    lines.push('*Created by [Clancy](https://github.com/Pushedskydiver/clancy)*');
+    lines.push('');
+    lines.push('---');
+    lines.push('**Rework instructions:** To request changes:');
+    lines.push('- **Code comments** — leave inline comments on specific lines. These are always picked up automatically.');
+    lines.push('- **General feedback** — reply with a comment starting with `Rework:` followed by what needs fixing. Comments without the `Rework:` prefix are treated as discussion.');
+    lines.push('');
+    lines.push("Example: `Rework: The form validation doesn't handle empty passwords`");
+    return lines.join('\n');
+}
+//# sourceMappingURL=pr-body.js.map

package/dist/scripts/shared/pull-request/pr-body/pr-body.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-body.js","sourceRoot":"","sources":["../../../../../src/scripts/shared/pull-request/pr-body/pr-body.ts"],"names":[],"mappings":"AAQA;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,MAAmB,EAAE,MAAc;IAC7D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,QAAQ;YACX,KAAK,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;YACnC,MAAM;QACR,KAAK,MAAM;YACT,KAAK,CAAC,IAAI,CACR,cAAc,MAAM,CAAC,GAAG,KAAK,MAAM,CAAC,GAAG,CAAC,aAAa,WAAW,MAAM,CAAC,GAAG,GAAG,CAC9E,CAAC;YACF,MAAM;QACR,KAAK,QAAQ;YACX,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;YACxC,MAAM;IACV,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;IAC9E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;IAC3D,KAAK,CAAC,IAAI,CACR,0GAA0G,CAC3G,CAAC;IACF,KAAK,CAAC,IAAI,CACR,uKAAuK,CACxK,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CACR,uEAAuE,CACxE,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/scripts/shared/pull-request/rework-comment/rework-comment.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Rework comment detection and extraction utilities.
+ *
+ * Comments starting with "Rework:" (case-insensitive) are treated as
+ * rework requests. All other comments are treated as discussion and ignored.
+ */
+/**
+ * Check if a comment is a rework request (starts with "Rework:" case-insensitive).
+ *
+ * @param body - The comment body to check.
+ * @returns `true` if the comment starts with "Rework:".
+ */
+export declare function isReworkComment(body: string): boolean;
+/**
+ * Extract the rework description from a "Rework: ..." comment.
+ *
+ * Strips the "Rework:" prefix and returns the remaining content trimmed.
+ *
+ * @param body - The full comment body starting with "Rework:".
+ * @returns The description after the prefix.
+ */
+export declare function extractReworkContent(body: string): string;
+//# sourceMappingURL=rework-comment.d.ts.map

package/dist/scripts/shared/pull-request/rework-comment/rework-comment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rework-comment.d.ts","sourceRoot":"","sources":["../../../../../src/scripts/shared/pull-request/rework-comment/rework-comment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKzD"}

package/dist/scripts/shared/pull-request/rework-comment/rework-comment.js

@@ -0,0 +1,30 @@
+/**
+ * Rework comment detection and extraction utilities.
+ *
+ * Comments starting with "Rework:" (case-insensitive) are treated as
+ * rework requests. All other comments are treated as discussion and ignored.
+ */
+/**
+ * Check if a comment is a rework request (starts with "Rework:" case-insensitive).
+ *
+ * @param body - The comment body to check.
+ * @returns `true` if the comment starts with "Rework:".
+ */
+export function isReworkComment(body) {
+    return body.trim().toLowerCase().startsWith('rework:');
+}
+/**
+ * Extract the rework description from a "Rework: ..." comment.
+ *
+ * Strips the "Rework:" prefix and returns the remaining content trimmed.
+ *
+ * @param body - The full comment body starting with "Rework:".
+ * @returns The description after the prefix.
+ */
+export function extractReworkContent(body) {
+    return body
+        .trim()
+        .replace(/^rework:\s*/i, '')
+        .trim();
+}
+//# sourceMappingURL=rework-comment.js.map

package/dist/scripts/shared/pull-request/rework-comment/rework-comment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rework-comment.js","sourceRoot":"","sources":["../../../../../src/scripts/shared/pull-request/rework-comment/rework-comment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,IAAI;SACR,IAAI,EAAE;SACN,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;SAC3B,IAAI,EAAE,CAAC;AACZ,CAAC"}

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

@@ -0,0 +1,41 @@
+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.
+ * @returns Parsed remote info with platform and path details.
+ */
+export declare function parseRemote(rawUrl: string): 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;
+/**
+ * Detect the remote origin info from the current git repository.
+ *
+ * Falls back to `{ host: 'none' }` if no remote is configured or
+ * if the command fails.
+ *
+ * @param platformOverride - Override platform detection (from `CLANCY_GIT_PLATFORM` env var).
+ * @returns Parsed remote info.
+ */
+export declare function detectRemote(platformOverride?: string): RemoteInfo;
+/**
+ * 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/scripts/shared/remote/remote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../../../src/scripts/shared/remote/remote.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAgChE;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAgEtD;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAWxE;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,UAAU,CAmBlE;AAgED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,UAAU,EAClB,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,GAAG,SAAS,CAiBpB"}