chief-clancy 0.5.3 → 0.5.5

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":"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"}

package/dist/types/index.d.ts

@@ -1,3 +1,4 @@
 export type { BoardProvider, Ticket } from './board.js';
+export type { GitPlatform, PrCreationResult, PrReviewState, 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,aAAa,EACb,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,53 @@
+/**
+ * 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;
+};
+/** Result of checking PR/MR review state. */
+export type PrReviewState = {
+    /** Whether changes have been requested by a reviewer. */
+    changesRequested: boolean;
+    /** The PR/MR number/ID (needed to fetch comments). */
+    prNumber: number;
+    /** The PR/MR URL (for logging). */
+    prUrl: string;
+};
+/** 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,6CAA6C;AAC7C,MAAM,MAAM,aAAa,GAAG;IAC1B,yDAAyD;IACzD,gBAAgB,EAAE,OAAO,CAAC;IAC1B,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,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.5",
   "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,62 @@ 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.
+
+---
+
+### Q3e (all boards): Max rework cycles
+
+PR-based rework detection is automatic — no configuration needed. This setting controls the safety limit.
+
+Output:
+
+```
+Max rework cycles before flagging for human intervention? [3]
+```
+
+If a number is entered: store as `CLANCY_MAX_REWORK` in `.clancy/.env`.
+If enter is pressed with no value: use default 3 — store `CLANCY_MAX_REWORK=3` in `.clancy/.env`.
+
+---
+
 ### 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,24 @@ 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: Rework loop ──────────────────────────────────────────────────
+# PR-based rework is automatic — when a reviewer leaves inline comments or
+# a conversation comment prefixed with "Rework:", Clancy picks it up on the
+# next run. No configuration needed.
+# CLANCY_MAX_REWORK=3                    # Max rework cycles before human intervention (default: 3)
 
 # ─── Optional: Planner queue ─────────────────────────────────────────────────
 # Status for backlog tickets that /clancy:plan fetches from (default: Backlog)
@@ -419,6 +437,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
@@ -441,6 +463,12 @@ MAX_ITERATIONS=20
 # PLAYWRIGHT_STORYBOOK_PORT=6006
 # PLAYWRIGHT_STARTUP_WAIT=15
 
+# ─── Optional: Rework loop ──────────────────────────────────────────────────
+# PR-based rework is automatic — when a reviewer leaves inline comments or
+# a conversation comment prefixed with "Rework:", Clancy picks it up on the
+# next run. No configuration needed.
+# CLANCY_MAX_REWORK=3                    # Max rework cycles before human intervention (default: 3)
+
 # ─── Optional: Notifications ──────────────────────────────────────────────────
 # Webhook URL for Slack or Teams notifications on ticket completion
 # CLANCY_NOTIFY_WEBHOOK=https://hooks.slack.com/services/your/webhook/url
@@ -495,6 +523,23 @@ 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: Rework loop ──────────────────────────────────────────────────
+# PR-based rework is automatic — when a reviewer leaves inline comments or
+# a conversation comment prefixed with "Rework:", Clancy picks it up on the
+# next run. No configuration needed.
+# CLANCY_MAX_REWORK=3                    # Max rework cycles before human intervention (default: 3)
+
+# ─── 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

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

@@ -51,6 +51,7 @@ General
   [G1] Max iterations    {MAX_ITERATIONS:-5}          tickets per /clancy:run session
   [G2] Claude model      {CLANCY_MODEL:-default}     model used for each ticket session
   [G3] Base branch       {CLANCY_BASE_BRANCH:-main}
+  [G4] Max rework        {CLANCY_MAX_REWORK:-3}
 
 {If Jira:}
 Jira
@@ -59,16 +60,14 @@ Jira
   [B3] Label filter      {CLANCY_LABEL if set, else off}
   [B4] Pickup status     {CLANCY_STATUS_IN_PROGRESS if set, else off}
   [B5] Done status       {CLANCY_STATUS_DONE if set, else off}
-
-{If GitHub:}
-GitHub
-  (No board-specific settings — labels are managed in GitHub directly)
+  [B6] Review status     {CLANCY_STATUS_REVIEW if set, else "uses Done status"}
 
 {If Linear:}
 Linear
   [B1] Label filter      {CLANCY_LABEL if set, else off}
   [B2] Pickup status     {CLANCY_STATUS_IN_PROGRESS if set, else off}
   [B3] Done status       {CLANCY_STATUS_DONE if set, else off}
+  [B4] Review status     {CLANCY_STATUS_REVIEW if set, else "uses Done state"}
 
 Roles
   [R1] Planner           {✅ enabled / ─ disabled}
@@ -82,6 +81,9 @@ Planner
 {If Linear:}
   [P1] Plan state type    {CLANCY_PLAN_STATE_TYPE:-backlog}
 
+Git Host (PR creation)
+  [H1] Git host token    {platform: GitHub/GitLab/Bitbucket or "not set"}
+
 Integrations
   [I1] Figma MCP         {enabled if FIGMA_API_KEY set, else not set}
   [I2] Playwright        {enabled if PLAYWRIGHT_ENABLED=true, else off}
@@ -151,6 +153,24 @@ Write `CLANCY_BASE_BRANCH=<value>` to `.clancy/.env`.
 
 ---
 
+### [G4] Max rework cycles
+
+```
+Max rework cycles — current: {value or 3}
+After this many rework cycles on a single ticket, Clancy flags it for human intervention.
+
+[1] 3 (default)
+[2] Enter a different number
+[3] Cancel
+```
+
+Validate the input is a positive integer between 1 and 20. If invalid, re-prompt.
+
+If [1]: remove `CLANCY_MAX_REWORK` from `.clancy/.env` (uses default).
+If [2]: prompt `How many rework cycles before human intervention?` then write `CLANCY_MAX_REWORK=<value>` to `.clancy/.env`.
+
+---
+
 ### [B1] Jira status filter (Jira only)
 
 ```
@@ -232,6 +252,23 @@ If [2]: remove `CLANCY_STATUS_DONE` from `.clancy/.env`.
 
 ---
 
+### [B6] Jira Review status (Jira only)
+
+```
+Jira Review status — current: {value or "uses Done status"}
+When Clancy creates a pull request (instead of merging locally), it transitions
+the ticket to this status. Falls back to CLANCY_STATUS_DONE if not set.
+
+[1] Set status name
+[2] Off (use Done status for PR flow too)
+[3] Cancel
+```
+
+If [1]: prompt `What status name should Clancy use for In Review? (e.g. In Review, Ready for Review, Code Review)` then write `CLANCY_STATUS_REVIEW=<value>` to `.clancy/.env`.
+If [2]: remove `CLANCY_STATUS_REVIEW` from `.clancy/.env`.
+
+---
+
 ### [B1] Linear label filter (Linear only)
 
 ```
@@ -283,6 +320,23 @@ If [2]: remove `CLANCY_STATUS_DONE` from `.clancy/.env`.
 
 ---
 
+### [B4] Linear Review status (Linear only)
+
+```
+Linear Review status — current: {value or "uses Done state"}
+When Clancy creates a pull request (instead of merging locally), it moves
+the issue to this state. Falls back to CLANCY_STATUS_DONE if not set.
+
+[1] Set state name
+[2] Off (use Done state for PR flow too)
+[3] Cancel
+```
+
+If [1]: prompt `What workflow state name should Clancy use for In Review? (e.g. In Review, Ready for Review, Code Review)` then write `CLANCY_STATUS_REVIEW=<value>` to `.clancy/.env`.
+If [2]: remove `CLANCY_STATUS_REVIEW` from `.clancy/.env`.
+
+---
+
 ### [R1] Planner role
 
 ```
@@ -355,6 +409,28 @@ If [3]: prompt `What state type should /clancy:plan fetch from?` then write `CLA
 
 ---
 
+### [H1] Git host token
+
+Only shown for Jira and Linear boards. GitHub Issues users already have `GITHUB_TOKEN` for PR creation.
+
+```
+Git host — current: {GitHub / GitLab / Bitbucket / not set}
+Clancy pushes feature branches and creates PRs on your git host.
+
+[1] GitHub
+[2] GitLab
+[3] Bitbucket
+[4] Remove (push and create PRs manually)
+[5] Cancel
+```
+
+If [1]: prompt `Paste your GitHub personal access token:` then write `GITHUB_TOKEN=<value>` to `.clancy/.env`. Remove any existing `GITLAB_TOKEN`, `BITBUCKET_USER`, `BITBUCKET_TOKEN`.
+If [2]: prompt `Paste your GitLab personal access token:` then write `GITLAB_TOKEN=<value>` to `.clancy/.env`. Optionally ask for a self-hosted API base URL (e.g. `https://gitlab.example.com/api/v4`) and write `CLANCY_GIT_API_URL` and `CLANCY_GIT_PLATFORM="gitlab"`. If the user enters just a hostname or instance URL without `/api/v4`, append `/api/v4` automatically. Remove any existing `GITHUB_TOKEN` (only if board is not GitHub), `BITBUCKET_USER`, `BITBUCKET_TOKEN`.
+If [3]: prompt for `Bitbucket username` and `Bitbucket app password`, write `BITBUCKET_USER` and `BITBUCKET_TOKEN` to `.clancy/.env`. Remove any existing `GITHUB_TOKEN` (only if board is not GitHub), `GITLAB_TOKEN`.
+If [4]: remove all git host token vars (`GITLAB_TOKEN`, `BITBUCKET_USER`, `BITBUCKET_TOKEN`, `CLANCY_GIT_PLATFORM`, `CLANCY_GIT_API_URL`). Keep `GITHUB_TOKEN` only if board is GitHub Issues.
+
+---
+
 ### [I1] Figma MCP
 
 ```
@@ -479,6 +555,7 @@ If no: print `Cancelled. No changes made.` and loop back to the menu.
    - Jira: `JIRA_BASE_URL`, `JIRA_USER`, `JIRA_API_TOKEN`, `JIRA_PROJECT_KEY`, `CLANCY_JQL_STATUS`, `CLANCY_JQL_SPRINT`
    - GitHub: `GITHUB_TOKEN`, `GITHUB_REPO`
    - Linear: `LINEAR_API_KEY`, `LINEAR_TEAM_ID`
+   - Git host (all boards): `GITLAB_TOKEN`, `BITBUCKET_USER`, `BITBUCKET_TOKEN`, `CLANCY_GIT_PLATFORM`, `CLANCY_GIT_API_URL`, `CLANCY_STATUS_REVIEW`
 2. Write the new board credentials to `.clancy/.env`
 3. If switching to Jira: also ask the status filter question (same as init Q3) and write `CLANCY_JQL_STATUS` to `.clancy/.env`
 4. No script replacement needed — the bundled runtime scripts are board-agnostic (board detection happens at runtime from `.clancy/.env`)