chief-clancy 0.5.3 → 0.5.4

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,CA8BvE"}

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

@@ -0,0 +1,35 @@
+/**
+ * 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)*');
+    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;IAE9E,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,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"}

package/dist/scripts/shared/remote/remote.js

@@ -0,0 +1,227 @@
+/**
+ * Remote git host detection.
+ *
+ * Parses `git remote get-url origin` to detect the hosting platform
+ * (GitHub, GitLab, Bitbucket, etc.) and extract owner/repo/project info.
+ */
+import { execFileSync } from 'node:child_process';
+/**
+ * Extract hostname and path from a raw git remote URL.
+ *
+ * Strips `.git` suffix, then tries SSH (`git@host:path`) and
+ * HTTPS/SSH-URL (`https://host/path`, `ssh://git@host/path`) formats.
+ *
+ * @param rawUrl - The raw git remote URL.
+ * @returns The extracted hostname and path, or `undefined` if unparseable.
+ */
+function extractHostAndPath(rawUrl) {
+    const url = rawUrl.trim().replace(/\.git$/, '');
+    // SSH format: git@<host>:<path>
+    const sshMatch = url.match(/^git@([^:]+):(.+)$/);
+    // HTTPS or SSH-URL format: https://<host>/<path> or ssh://git@<host>/<path>
+    const httpsMatch = url.match(/^(?:https?|ssh):\/\/(?:[^@]+@)?([^/:]+)(?::\d+)?\/(.+)$/);
+    const hostname = sshMatch?.[1] ?? httpsMatch?.[1];
+    const path = sshMatch?.[2] ?? httpsMatch?.[2];
+    if (!hostname || !path)
+        return undefined;
+    return { hostname, path };
+}
+/**
+ * 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 function parseRemote(rawUrl) {
+    const extracted = extractHostAndPath(rawUrl);
+    if (!extracted) {
+        return { host: 'unknown', url: rawUrl };
+    }
+    const { hostname, path } = extracted;
+    const platform = detectPlatformFromHostname(hostname);
+    switch (platform) {
+        case 'github': {
+            const parts = path.split('/');
+            if (parts.length >= 2) {
+                return {
+                    host: 'github',
+                    owner: parts[0],
+                    repo: parts[1],
+                    hostname,
+                };
+            }
+            return { host: 'unknown', url: rawUrl };
+        }
+        case 'gitlab': {
+            return {
+                host: 'gitlab',
+                projectPath: path,
+                hostname,
+            };
+        }
+        case 'bitbucket': {
+            // Bitbucket Server uses /scm/<projectKey>/<repo> format
+            const scmMatch = path.match(/^scm\/([^/]+)\/(.+)$/);
+            if (scmMatch) {
+                return {
+                    host: 'bitbucket-server',
+                    projectKey: scmMatch[1],
+                    repoSlug: scmMatch[2],
+                    hostname,
+                };
+            }
+            // Bitbucket Cloud: <workspace>/<repo>
+            const parts = path.split('/');
+            if (parts.length >= 2) {
+                return {
+                    host: 'bitbucket',
+                    workspace: parts[0],
+                    repoSlug: parts[1],
+                    hostname,
+                };
+            }
+            return { host: 'unknown', url: rawUrl };
+        }
+        case 'azure':
+            return { host: 'azure', url: rawUrl };
+        default:
+            return { host: 'unknown', url: rawUrl };
+    }
+}
+/**
+ * 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 function detectPlatformFromHostname(hostname) {
+    const lower = hostname.toLowerCase();
+    if (lower === 'github.com' || lower.includes('github'))
+        return 'github';
+    if (lower === 'gitlab.com' || lower.includes('gitlab'))
+        return 'gitlab';
+    if (lower === 'bitbucket.org' || lower.includes('bitbucket'))
+        return 'bitbucket';
+    if (lower.includes('dev.azure') || lower.includes('visualstudio'))
+        return 'azure';
+    return 'unknown';
+}
+/**
+ * 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 function detectRemote(platformOverride) {
+    let rawUrl;
+    try {
+        rawUrl = execFileSync('git', ['remote', 'get-url', 'origin'], {
+            encoding: 'utf8',
+        }).trim();
+    }
+    catch {
+        return { host: 'none' };
+    }
+    if (!rawUrl)
+        return { host: 'none' };
+    // If user explicitly overrides the platform, always use it — they know better
+    if (platformOverride) {
+        return overrideRemotePlatform(rawUrl, platformOverride);
+    }
+    return parseRemote(rawUrl);
+}
+/**
+ * Re-parse a remote URL with a known platform override.
+ *
+ * Used when auto-detection fails (self-hosted with custom domain)
+ * and the user sets `CLANCY_GIT_PLATFORM`.
+ */
+function overrideRemotePlatform(rawUrl, platform) {
+    const extracted = extractHostAndPath(rawUrl);
+    if (!extracted)
+        return { host: 'unknown', url: rawUrl };
+    const { hostname, path } = extracted;
+    switch (platform.toLowerCase()) {
+        case 'github': {
+            const parts = path.split('/');
+            if (parts.length >= 2) {
+                return { host: 'github', owner: parts[0], repo: parts[1], hostname };
+            }
+            return { host: 'unknown', url: rawUrl };
+        }
+        case 'gitlab':
+            return { host: 'gitlab', projectPath: path, hostname };
+        case 'bitbucket': {
+            const parts = path.split('/');
+            if (parts.length >= 2) {
+                return {
+                    host: 'bitbucket',
+                    workspace: parts[0],
+                    repoSlug: parts[1],
+                    hostname,
+                };
+            }
+            return { host: 'unknown', url: rawUrl };
+        }
+        case 'bitbucket-server': {
+            // Strip leading scm/ prefix used in Bitbucket Server URLs
+            const scmMatch = path.match(/^scm\/([^/]+)\/(.+)$/);
+            if (scmMatch) {
+                return {
+                    host: 'bitbucket-server',
+                    projectKey: scmMatch[1],
+                    repoSlug: scmMatch[2],
+                    hostname,
+                };
+            }
+            const parts = path.split('/');
+            if (parts.length >= 2) {
+                return {
+                    host: 'bitbucket-server',
+                    projectKey: parts[0],
+                    repoSlug: parts[1],
+                    hostname,
+                };
+            }
+            return { host: 'unknown', url: rawUrl };
+        }
+        default:
+            return { host: 'unknown', url: rawUrl };
+    }
+}
+/**
+ * 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 function buildApiBaseUrl(remote, apiUrlOverride) {
+    if (apiUrlOverride)
+        return apiUrlOverride.replace(/\/$/, '');
+    switch (remote.host) {
+        case 'github':
+            return remote.hostname === 'github.com'
+                ? 'https://api.github.com'
+                : `https://${remote.hostname}/api/v3`;
+        case 'gitlab':
+            return `https://${remote.hostname}/api/v4`;
+        case 'bitbucket':
+            return 'https://api.bitbucket.org/2.0';
+        case 'bitbucket-server':
+            return `https://${remote.hostname}/rest/api/1.0`;
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=remote.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"remote.js","sourceRoot":"","sources":["../../../../src/scripts/shared/remote/remote.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIlD;;;;;;;;GAQG;AACH,SAAS,kBAAkB,CACzB,MAAc;IAEd,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAEhD,gCAAgC;IAChC,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAEjD,4EAA4E;IAC5E,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAC1B,yDAAyD,CAC1D,CAAC;IAEF,MAAM,QAAQ,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;IAE9C,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAEzC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,MAAM,SAAS,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAE7C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IAC1C,CAAC;IAED,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,SAAS,CAAC;IAErC,MAAM,QAAQ,GAAG,0BAA0B,CAAC,QAAQ,CAAC,CAAC;IAEtD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;gBACtB,OAAO;oBACL,IAAI,EAAE,QAAQ;oBACd,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;oBACf,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;oBACd,QAAQ;iBACT,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;QAC1C,CAAC;QAED,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,IAAI;gBACjB,QAAQ;aACT,CAAC;QACJ,CAAC;QAED,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,wDAAwD;YACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;YACpD,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO;oBACL,IAAI,EAAE,kBAAkB;oBACxB,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;oBACvB,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;oBACrB,QAAQ;iBACT,CAAC;YACJ,CAAC;YAED,sCAAsC;YACtC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;gBACtB,OAAO;oBACL,IAAI,EAAE,WAAW;oBACjB,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;oBACnB,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;oBAClB,QAAQ;iBACT,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;QAC1C,CAAC;QAED,KAAK,OAAO;YACV,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;QAExC;YACE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IAC5C,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,0BAA0B,CAAC,QAAgB;IACzD,MAAM,KAAK,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IAErC,IAAI,KAAK,KAAK,YAAY,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IACxE,IAAI,KAAK,KAAK,YAAY,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IACxE,IAAI,KAAK,KAAK,eAAe,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC;QAC1D,OAAO,WAAW,CAAC;IACrB,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC;QAC/D,OAAO,OAAO,CAAC;IAEjB,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,gBAAyB;IACpD,IAAI,MAAc,CAAC;IAEnB,IAAI,CAAC;QACH,MAAM,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE;YAC5D,QAAQ,EAAE,MAAM;SACjB,CAAC,CAAC,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC;IAED,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAErC,8EAA8E;IAC9E,IAAI,gBAAgB,EAAE,CAAC;QACrB,OAAO,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;GAKG;AACH,SAAS,sBAAsB,CAAC,MAAc,EAAE,QAAgB;IAC9D,MAAM,SAAS,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAE7C,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IAExD,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,SAAS,CAAC;IAErC,QAAQ,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;QAC/B,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;gBACtB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;YACvE,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;QAC1C,CAAC;QACD,KAAK,QAAQ;YACX,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QACzD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;gBACtB,OAAO;oBACL,IAAI,EAAE,WAAW;oBACjB,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;oBACnB,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;oBAClB,QAAQ;iBACT,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;QAC1C,CAAC;QACD,KAAK,kBAAkB,CAAC,CAAC,CAAC;YACxB,0DAA0D;YAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;YACpD,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO;oBACL,IAAI,EAAE,kBAAkB;oBACxB,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;oBACvB,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;oBACrB,QAAQ;iBACT,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;gBACtB,OAAO;oBACL,IAAI,EAAE,kBAAkB;oBACxB,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;oBACpB,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;oBAClB,QAAQ;iBACT,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;QAC1C,CAAC;QACD;YACE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IAC5C,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAkB,EAClB,cAAuB;IAEvB,IAAI,cAAc;QAAE,OAAO,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAE7D,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,QAAQ,KAAK,YAAY;gBACrC,CAAC,CAAC,wBAAwB;gBAC1B,CAAC,CAAC,WAAW,MAAM,CAAC,QAAQ,SAAS,CAAC;QAC1C,KAAK,QAAQ;YACX,OAAO,WAAW,MAAM,CAAC,QAAQ,SAAS,CAAC;QAC7C,KAAK,WAAW;YACd,OAAO,+BAA+B,CAAC;QACzC,KAAK,kBAAkB;YACrB,OAAO,WAAW,MAAM,CAAC,QAAQ,eAAe,CAAC;QACnD;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/types/index.d.ts

@@ -1,3 +1,4 @@
 export type { BoardProvider, Ticket } from './board.js';
+export type { GitPlatform, PrCreationResult, ProgressStatus, RemoteInfo, } from './remote.js';
 export type { BoardConfig, GitHubEnv, JiraEnv, LinearEnv, SharedEnv, } from '../schemas/env.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACxD,YAAY,EACV,WAAW,EACX,SAAS,EACT,OAAO,EACP,SAAS,EACT,SAAS,GACV,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACxD,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,UAAU,GACX,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,WAAW,EACX,SAAS,EACT,OAAO,EACP,SAAS,EACT,SAAS,GACV,MAAM,kBAAkB,CAAC"}

package/dist/types/remote.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Remote git hosting types shared across remote detection and PR creation.
+ */
+/** Supported git hosting platforms. */
+export type GitPlatform = 'github' | 'gitlab' | 'bitbucket' | 'bitbucket-server' | 'azure' | 'unknown';
+/** Parsed remote URL with platform and path info. */
+export type RemoteInfo = {
+    host: 'github';
+    owner: string;
+    repo: string;
+    hostname: string;
+} | {
+    host: 'gitlab';
+    projectPath: string;
+    hostname: string;
+} | {
+    host: 'bitbucket';
+    workspace: string;
+    repoSlug: string;
+    hostname: string;
+} | {
+    host: 'bitbucket-server';
+    projectKey: string;
+    repoSlug: string;
+    hostname: string;
+} | {
+    host: 'azure' | 'unknown';
+    url: string;
+} | {
+    host: 'none';
+};
+/** Result of a PR/MR creation attempt. */
+export type PrCreationResult = {
+    ok: true;
+    url: string;
+    number: number;
+} | {
+    ok: false;
+    error: string;
+    alreadyExists?: boolean;
+};
+/** Progress log status values. */
+export type ProgressStatus = 'DONE' | 'SKIPPED' | 'PR_CREATED' | 'PUSHED' | 'PUSH_FAILED' | 'LOCAL' | 'PLAN' | 'APPROVE' | 'REWORK';
+//# sourceMappingURL=remote.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../src/types/remote.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,uCAAuC;AACvC,MAAM,MAAM,WAAW,GACnB,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,kBAAkB,GAClB,OAAO,GACP,SAAS,CAAC;AAEd,qDAAqD;AACrD,MAAM,MAAM,UAAU,GAClB;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB,GACD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB,GACD;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,GACD;IACE,IAAI,EAAE,kBAAkB,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,GACD;IACE,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC;CACb,GACD;IACE,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEN,0CAA0C;AAC1C,MAAM,MAAM,gBAAgB,GACxB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAE1D,kCAAkC;AAClC,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,SAAS,GACT,YAAY,GACZ,QAAQ,GACR,aAAa,GACb,OAAO,GACP,MAAM,GACN,SAAS,GACT,QAAQ,CAAC"}

package/dist/types/remote.js

@@ -0,0 +1,5 @@
+/**
+ * Remote git hosting types shared across remote detection and PR creation.
+ */
+export {};
+//# sourceMappingURL=remote.js.map

package/dist/types/remote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.js","sourceRoot":"","sources":["../../src/types/remote.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chief-clancy",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "description": "Autonomous, board-driven development for Claude Code — scaffolds docs, integrates Kanban boards, runs tickets in a loop.",
   "keywords": [
     "claude",

package/src/roles/setup/workflows/init.md

@@ -207,6 +207,56 @@ Never silently continue with unverified credentials — the user must explicitly
 
 ---
 
+### Q2c (Jira and Linear only): Git host token
+
+When the board is **Jira** or **Linear**, Clancy needs a git host token to create pull requests after implementation. Skip this step entirely for **GitHub Issues** — the `GITHUB_TOKEN` collected in Q2 already covers PR creation.
+
+Output:
+
+```
+Clancy can push your feature branch and create a pull request automatically.
+Which git host does this project use?
+
+[1] GitHub
+[2] GitLab
+[3] Bitbucket
+[4] Skip — I'll push and create PRs manually
+```
+
+**If [1] GitHub:**
+
+`Paste your GitHub personal access token: (needs repo scope — create at github.com/settings/tokens)`
+
+Store as `GITHUB_TOKEN` in `.clancy/.env`.
+
+Verify by calling `GET https://api.github.com/user` with `Authorization: Bearer {token}` and `X-GitHub-Api-Version: 2022-11-28`.
+
+On success: `✅ GitHub connected — {login}`
+On failure: offer re-enter or skip (same pattern as Q2b).
+
+**If [2] GitLab:**
+
+`Paste your GitLab personal access token: (needs api scope — create at gitlab.com/-/user_settings/personal_access_tokens)`
+
+Store as `GITLAB_TOKEN` in `.clancy/.env`.
+
+If the user is using a self-hosted GitLab instance, also ask:
+`What's your GitLab API base URL? (e.g. https://gitlab.example.com/api/v4 — press Enter for gitlab.com)`
+
+If a URL is entered, store as `CLANCY_GIT_API_URL` in `.clancy/.env` and `CLANCY_GIT_PLATFORM="gitlab"`.
+If the user enters just a hostname or instance URL without `/api/v4`, append `/api/v4` automatically.
+
+**If [3] Bitbucket:**
+
+1. `What's your Bitbucket username? (your Atlassian account username)`
+2. `Paste your Bitbucket app password: (needs repository:write scope — create at bitbucket.org/account/settings/app-passwords)`
+
+Store as `BITBUCKET_USER` and `BITBUCKET_TOKEN` in `.clancy/.env`.
+
+**If [4] Skip:** no git host token is written. Clancy will still implement tickets but leave the feature branch for the user to push and create PRs manually.
+
+---
+
 ### Q3 (Jira only): Status name
 
 Output:
@@ -315,6 +365,47 @@ You can always configure these later via `/clancy:settings`.
 
 ---
 
+### Q3d-2 (Jira and Linear only): Review status
+
+Only ask this if a git host token was configured in Q2c (i.e. the user didn't skip PR creation).
+
+**GitHub:** Skip entirely — not applicable (GitHub Issues don't have workflow states).
+
+**Jira:** Output:
+
+```
+When Clancy creates a pull request, it can transition the ticket to a review status.
+
+What transition should Clancy use after creating a PR?
+
+[1] In Review
+[2] Ready for Review
+[3] Enter a different value
+[4] Skip — use the same status as completion (CLANCY_STATUS_DONE)
+```
+
+If [1]: store `CLANCY_STATUS_REVIEW="In Review"` in `.clancy/.env`.
+If [2]: store `CLANCY_STATUS_REVIEW="Ready for Review"` in `.clancy/.env`.
+If [3]: prompt for the value, store as `CLANCY_STATUS_REVIEW` in `.clancy/.env`. Wrap in double quotes.
+If [4] or the user says "skip"/"none": skip — no `CLANCY_STATUS_REVIEW` line written (falls back to `CLANCY_STATUS_DONE`).
+
+**Linear:** Output:
+
+```
+When Clancy creates a pull request, it can move the issue to a review state.
+
+What state should Clancy move an issue to after creating a PR?
+
+[1] In Review
+[2] Ready for Review
+[3] Enter a different value
+[4] Skip — use the same state as completion (CLANCY_STATUS_DONE)
+```
+
+Same storage logic as Jira above.
+
+---
+
 ### Q4: Base branch (auto-detect)
 
 Silently detect the base branch — do not ask unless detection fails:

package/src/roles/setup/workflows/scaffold.md

@@ -383,6 +383,18 @@ MAX_ITERATIONS=5
 # "Done" can be any transition to a post-implementation status.
 # CLANCY_STATUS_IN_PROGRESS="In Progress"
 # CLANCY_STATUS_DONE="Done"
+# CLANCY_STATUS_REVIEW="In Review"        # used when creating a PR instead of merging locally
+
+# ─── Optional: Git host (PR creation) ───────────────────────────────────────
+# When a ticket has no parent epic, Clancy pushes the feature branch and creates
+# a pull request instead of squash-merging locally. Requires a git host token.
+# GitHub Issues users already have GITHUB_TOKEN above — no extra config needed.
+# GITHUB_TOKEN=ghp_your-token              # if your git host is GitHub
+# GITLAB_TOKEN=glpat-your-token            # if your git host is GitLab
+# BITBUCKET_USER=your-username             # if your git host is Bitbucket
+# BITBUCKET_TOKEN=your-app-password        # if your git host is Bitbucket
+# CLANCY_GIT_PLATFORM=gitlab               # override auto-detection (github/gitlab/bitbucket)
+# CLANCY_GIT_API_URL=https://gitlab.example.com/api/v4  # self-hosted git API base URL
 
 # ─── Optional: Planner queue ─────────────────────────────────────────────────
 # Status for backlog tickets that /clancy:plan fetches from (default: Backlog)
@@ -419,6 +431,10 @@ GITHUB_REPO=owner/repo-name
 # When an issue has a milestone, Clancy auto-creates milestone/{slug} from this branch.
 CLANCY_BASE_BRANCH=main
 
+# ─── PR creation ─────────────────────────────────────────────────────────────
+# When an issue has no milestone, Clancy pushes the feature branch and creates a
+# PR using your GITHUB_TOKEN above. No extra config needed for GitHub Issues users.
+
 # ─── Loop ─────────────────────────────────────────────────────────────────────
 # Max tickets to process per /clancy:run session (default: 20)
 MAX_ITERATIONS=20
@@ -495,6 +511,17 @@ MAX_ITERATIONS=20
 # "Done" can be any post-implementation state (e.g. "Ready for Review", "In Review").
 # CLANCY_STATUS_IN_PROGRESS="In Progress"
 # CLANCY_STATUS_DONE="Done"
+# CLANCY_STATUS_REVIEW="In Review"        # used when creating a PR instead of merging locally
+
+# ─── Optional: Git host (PR creation) ───────────────────────────────────────
+# When an issue has no parent, Clancy pushes the feature branch and creates a
+# pull request instead of squash-merging locally. Requires a git host token.
+# GITHUB_TOKEN=ghp_your-token              # if your git host is GitHub
+# GITLAB_TOKEN=glpat-your-token            # if your git host is GitLab
+# BITBUCKET_USER=your-username             # if your git host is Bitbucket
+# BITBUCKET_TOKEN=your-app-password        # if your git host is Bitbucket
+# CLANCY_GIT_PLATFORM=gitlab               # override auto-detection (github/gitlab/bitbucket)
+# CLANCY_GIT_API_URL=https://gitlab.example.com/api/v4  # self-hosted git API base URL
 
 # ─── Optional: Notifications ──────────────────────────────────────────────────
 # Webhook URL for Slack or Teams notifications on ticket completion