specweave 1.0.447 → 1.0.450

package/dist/src/sync/integration-health-check.js

@@ -0,0 +1,186 @@
+/**
+ * Integration Health Check
+ *
+ * Validates external integration chain beyond simple auth.
+ * Runs during sync-setup to catch misconfigurations early.
+ *
+ * @module sync/integration-health-check
+ */
+/**
+ * Run health checks for JIRA integration
+ */
+export async function checkJiraIntegration(config) {
+    const checks = [];
+    const authHeader = 'Basic ' + Buffer.from(`${config.email}:${config.apiToken}`).toString('base64');
+    const baseUrl = config.domain.startsWith('http') ? config.domain : `https://${config.domain}`;
+    // Check 1: Verify API auth (basic)
+    try {
+        const res = await fetch(`${baseUrl}/rest/api/3/myself`, {
+            headers: { 'Authorization': authHeader }
+        });
+        if (res.ok) {
+            checks.push({ name: 'API Authentication', status: 'pass', message: 'Authenticated successfully' });
+        }
+        else {
+            checks.push({ name: 'API Authentication', status: 'fail', message: `Auth failed: ${res.status}`, fix: 'Check JIRA_EMAIL and JIRA_API_TOKEN in .env' });
+        }
+    }
+    catch (err) {
+        checks.push({ name: 'API Authentication', status: 'fail', message: err.message, fix: 'Check JIRA_DOMAIN in .env' });
+    }
+    // Check 2: Verify project exists and has valid issue types
+    try {
+        const res = await fetch(`${baseUrl}/rest/api/3/project/${config.projectKey}`, {
+            headers: { 'Authorization': authHeader }
+        });
+        if (res.ok) {
+            checks.push({ name: 'Project Access', status: 'pass', message: `Project ${config.projectKey} accessible` });
+        }
+        else {
+            checks.push({ name: 'Project Access', status: 'fail', message: `Project ${config.projectKey} not found or no access`, fix: `Verify JIRA project key: ${config.projectKey}` });
+        }
+    }
+    catch (err) {
+        checks.push({ name: 'Project Access', status: 'fail', message: err.message });
+    }
+    // Check 3: Verify issue types exist in project (catches "The issue type selected is invalid")
+    try {
+        const res = await fetch(`${baseUrl}/rest/api/3/issue/createmeta?projectKeys=${config.projectKey}&expand=projects.issuetypes`, {
+            headers: { 'Authorization': authHeader }
+        });
+        if (res.ok) {
+            const data = await res.json();
+            const project = data.projects?.[0];
+            if (project) {
+                const typeNames = (project.issuetypes || []).map((t) => t.name);
+                const hasEpic = typeNames.some((n) => n.toLowerCase().includes('epic'));
+                const hasStory = typeNames.some((n) => n.toLowerCase().includes('story'));
+                if (hasEpic && hasStory) {
+                    checks.push({ name: 'Issue Types', status: 'pass', message: `Epic and Story types available (${typeNames.join(', ')})` });
+                }
+                else {
+                    const missing = [];
+                    if (!hasEpic)
+                        missing.push('Epic');
+                    if (!hasStory)
+                        missing.push('Story');
+                    checks.push({
+                        name: 'Issue Types',
+                        status: 'warn',
+                        message: `Missing issue types: ${missing.join(', ')}. Available: ${typeNames.join(', ')}`,
+                        fix: 'Add missing issue types in JIRA project settings, or SpecWeave sync will fail at increment closure'
+                    });
+                }
+            }
+        }
+    }
+    catch {
+        // Non-critical — createmeta API may have changed in newer JIRA versions
+        checks.push({ name: 'Issue Types', status: 'warn', message: 'Could not verify issue types (createmeta API unavailable)' });
+    }
+    // Check 4: Verify remote link permission
+    try {
+        const res = await fetch(`${baseUrl}/rest/api/3/mypermissions?permissions=EDIT_ISSUES&projectKey=${config.projectKey}`, {
+            headers: { 'Authorization': authHeader }
+        });
+        if (res.ok) {
+            const data = await res.json();
+            const canEdit = data.permissions?.EDIT_ISSUES?.havePermission;
+            if (canEdit) {
+                checks.push({ name: 'Edit Permission', status: 'pass', message: 'Can edit issues (required for remote links)' });
+            }
+            else {
+                checks.push({
+                    name: 'Edit Permission',
+                    status: 'warn',
+                    message: 'Cannot edit issues — PR remote links will fail',
+                    fix: 'Grant "Edit Issues" permission to the API user in JIRA project settings'
+                });
+            }
+        }
+    }
+    catch {
+        checks.push({ name: 'Edit Permission', status: 'warn', message: 'Could not verify permissions' });
+    }
+    return {
+        provider: 'jira',
+        checks,
+        healthy: checks.every(c => c.status !== 'fail')
+    };
+}
+/**
+ * Run health checks for ADO integration
+ */
+export async function checkAdoIntegration(config) {
+    const checks = [];
+    const authHeader = 'Basic ' + Buffer.from(`:${config.pat}`).toString('base64');
+    const baseUrl = `https://dev.azure.com/${config.organization}/${config.project}`;
+    // Check 1: Auth + project access
+    try {
+        const res = await fetch(`${baseUrl}/_apis/wit/workitemtypes?api-version=7.1`, {
+            headers: { 'Authorization': authHeader }
+        });
+        if (res.ok) {
+            const data = await res.json();
+            const typeNames = (data.value || []).map((t) => t.name);
+            checks.push({ name: 'API Authentication', status: 'pass', message: 'Authenticated successfully' });
+            checks.push({ name: 'Work Item Types', status: 'pass', message: `Available: ${typeNames.slice(0, 5).join(', ')}` });
+        }
+        else {
+            checks.push({ name: 'API Authentication', status: 'fail', message: `Auth failed: ${res.status}`, fix: 'Check ADO_PAT and ADO_ORGANIZATION in .env' });
+        }
+    }
+    catch (err) {
+        checks.push({ name: 'API Authentication', status: 'fail', message: err.message });
+    }
+    return {
+        provider: 'ado',
+        checks,
+        healthy: checks.every(c => c.status !== 'fail')
+    };
+}
+/**
+ * Run health checks for GitHub integration
+ */
+export async function checkGitHubIntegration() {
+    const checks = [];
+    // Check 1: gh CLI authenticated
+    try {
+        const { execSync } = await import('child_process');
+        const output = execSync('gh auth status 2>&1', { encoding: 'utf-8', timeout: 10000 });
+        if (output.includes('Logged in')) {
+            checks.push({ name: 'GitHub CLI', status: 'pass', message: 'gh CLI authenticated' });
+        }
+        else {
+            checks.push({ name: 'GitHub CLI', status: 'warn', message: 'gh CLI not authenticated', fix: 'Run: gh auth login' });
+        }
+    }
+    catch {
+        checks.push({ name: 'GitHub CLI', status: 'warn', message: 'gh CLI not available or not authenticated', fix: 'Install gh CLI and run: gh auth login' });
+    }
+    return {
+        provider: 'github',
+        checks,
+        healthy: checks.every(c => c.status !== 'fail')
+    };
+}
+/**
+ * Format health check results for display
+ */
+export function formatHealthCheckResults(results) {
+    const lines = ['', '━━━ Integration Health Check ━━━', ''];
+    for (const result of results) {
+        const icon = result.healthy ? '✅' : '⚠️';
+        lines.push(`${icon} ${result.provider.toUpperCase()}`);
+        for (const check of result.checks) {
+            const statusIcon = check.status === 'pass' ? '  ✓' : check.status === 'warn' ? '  ⚠' : '  ✗';
+            lines.push(`${statusIcon} ${check.name}: ${check.message}`);
+            if (check.fix) {
+                lines.push(`    Fix: ${check.fix}`);
+            }
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=integration-health-check.js.map

package/dist/src/sync/integration-health-check.js.map

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

package/dist/src/sync/pr-linker.d.ts

@@ -0,0 +1,38 @@
+/**
+ * PR Linker — Links pull requests to external tickets (JIRA, ADO)
+ *
+ * Called after PR creation to create remote links / hyperlinks
+ * so external tools show the PR in the issue's UI.
+ *
+ * @module sync/pr-linker
+ */
+import { Logger } from '../utils/logger.js';
+export interface PrLinkRequest {
+    projectRoot: string;
+    incrementId: string;
+    prUrl: string;
+    prNumber: number;
+    branch: string;
+}
+export interface PrLinkResult {
+    linked: {
+        provider: string;
+        key: string;
+    }[];
+    errors: {
+        provider: string;
+        key: string;
+        error: string;
+    }[];
+}
+/**
+ * Link a PR to all external tickets associated with this increment.
+ * Non-blocking: errors are collected, never thrown.
+ */
+export declare function linkPrToExternalTickets(request: PrLinkRequest, logger?: Logger): Promise<PrLinkResult>;
+/**
+ * Resolve the external ticket key for branch naming.
+ * Returns the JIRA key or ADO ID prefix if available.
+ */
+export declare function resolveExternalBranchPrefix(metadata: any): string | null;
+//# sourceMappingURL=pr-linker.d.ts.map

package/dist/src/sync/pr-linker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-linker.d.ts","sourceRoot":"","sources":["../../../src/sync/pr-linker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAiB,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5C,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC5D;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAqC5G;AAwHD;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI,CAUxE"}

package/dist/src/sync/pr-linker.js

@@ -0,0 +1,157 @@
+/**
+ * PR Linker — Links pull requests to external tickets (JIRA, ADO)
+ *
+ * Called after PR creation to create remote links / hyperlinks
+ * so external tools show the PR in the issue's UI.
+ *
+ * @module sync/pr-linker
+ */
+import { readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+import { consoleLogger } from '../utils/logger.js';
+/**
+ * Link a PR to all external tickets associated with this increment.
+ * Non-blocking: errors are collected, never thrown.
+ */
+export async function linkPrToExternalTickets(request, logger) {
+    const log = logger || consoleLogger;
+    const result = { linked: [], errors: [] };
+    const configPath = join(request.projectRoot, '.specweave', 'config.json');
+    if (!existsSync(configPath)) {
+        log.warn('No .specweave/config.json found — skipping PR linking');
+        return result;
+    }
+    const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+    const metadataPath = join(request.projectRoot, '.specweave', 'increments', request.incrementId, 'metadata.json');
+    if (!existsSync(metadataPath)) {
+        log.warn(`No metadata.json for increment ${request.incrementId}`);
+        return result;
+    }
+    const metadata = JSON.parse(readFileSync(metadataPath, 'utf-8'));
+    // Collect JIRA issue keys from metadata
+    const jiraKeys = collectJiraKeys(metadata, request.projectRoot, request.incrementId);
+    // Collect ADO work item IDs from metadata
+    const adoIds = collectAdoIds(metadata, request.projectRoot, request.incrementId);
+    // Link to JIRA
+    if (jiraKeys.length > 0 && config.sync?.jira?.enabled !== false) {
+        await linkToJira(jiraKeys, request, config, result, log);
+    }
+    // Link to ADO
+    if (adoIds.length > 0 && config.sync?.ado?.enabled !== false) {
+        await linkToAdo(adoIds, request, config, result, log);
+    }
+    return result;
+}
+function collectJiraKeys(metadata, projectRoot, incrementId) {
+    const keys = [];
+    // From metadata.json direct jira reference
+    if (metadata.jira?.issue)
+        keys.push(metadata.jira.issue);
+    if (metadata.jira?.issueKey)
+        keys.push(metadata.jira.issueKey);
+    // From externalLinks
+    if (metadata.externalLinks?.jira?.epicKey)
+        keys.push(metadata.externalLinks.jira.epicKey);
+    if (metadata.externalLinks?.jira?.issueKey)
+        keys.push(metadata.externalLinks.jira.issueKey);
+    // From per-user-story links
+    const usLinks = metadata.externalLinks?.jira?.userStories;
+    if (usLinks && typeof usLinks === 'object') {
+        for (const us of Object.values(usLinks)) {
+            if (us?.issueKey)
+                keys.push(us.issueKey);
+        }
+    }
+    // Deduplicate
+    return [...new Set(keys)];
+}
+function collectAdoIds(metadata, projectRoot, incrementId) {
+    const ids = [];
+    if (metadata.externalLinks?.ado?.featureId)
+        ids.push(Number(metadata.externalLinks.ado.featureId));
+    if (metadata.externalLinks?.ado?.workItemId)
+        ids.push(Number(metadata.externalLinks.ado.workItemId));
+    const usLinks = metadata.externalLinks?.ado?.userStories;
+    if (usLinks && typeof usLinks === 'object') {
+        for (const us of Object.values(usLinks)) {
+            if (us?.workItemId)
+                ids.push(Number(us.workItemId));
+        }
+    }
+    return [...new Set(ids.filter(id => !isNaN(id)))];
+}
+async function linkToJira(keys, request, config, result, log) {
+    try {
+        const { JiraClient } = await import('../integrations/jira/jira-client.js');
+        const jiraClient = new JiraClient();
+        for (const issueKey of keys) {
+            try {
+                await jiraClient.addRemoteLink(issueKey, {
+                    url: request.prUrl,
+                    title: `PR #${request.prNumber}: ${request.branch}`,
+                    globalId: `specweave-pr-${request.prNumber}`,
+                });
+                result.linked.push({ provider: 'jira', key: issueKey });
+                log.info(`Linked PR #${request.prNumber} to JIRA ${issueKey}`);
+            }
+            catch (err) {
+                result.errors.push({ provider: 'jira', key: issueKey, error: err.message });
+                log.warn(`Failed to link PR to JIRA ${issueKey}: ${err.message}`);
+            }
+        }
+    }
+    catch (err) {
+        log.warn(`JIRA client initialization failed: ${err.message}`);
+        for (const key of keys) {
+            result.errors.push({ provider: 'jira', key, error: err.message });
+        }
+    }
+}
+async function linkToAdo(ids, request, config, result, log) {
+    try {
+        const { AdoClient } = await import('../../plugins/specweave-ado/lib/ado-client.js');
+        const adoConfig = {
+            organization: config.sync?.ado?.organization || '',
+            project: config.sync?.ado?.project || '',
+            personalAccessToken: process.env.ADO_PAT || process.env.AZURE_DEVOPS_PAT || '',
+        };
+        if (!adoConfig.organization || !adoConfig.personalAccessToken) {
+            log.warn('ADO not configured — skipping PR linking');
+            return;
+        }
+        const adoClient = new AdoClient(adoConfig);
+        for (const workItemId of ids) {
+            try {
+                await adoClient.addHyperlink(workItemId, request.prUrl, `PR #${request.prNumber}: ${request.branch}`);
+                result.linked.push({ provider: 'ado', key: String(workItemId) });
+                log.info(`Linked PR #${request.prNumber} to ADO #${workItemId}`);
+            }
+            catch (err) {
+                result.errors.push({ provider: 'ado', key: String(workItemId), error: err.message });
+                log.warn(`Failed to link PR to ADO #${workItemId}: ${err.message}`);
+            }
+        }
+    }
+    catch (err) {
+        log.warn(`ADO client initialization failed: ${err.message}`);
+        for (const id of ids) {
+            result.errors.push({ provider: 'ado', key: String(id), error: err.message });
+        }
+    }
+}
+/**
+ * Resolve the external ticket key for branch naming.
+ * Returns the JIRA key or ADO ID prefix if available.
+ */
+export function resolveExternalBranchPrefix(metadata) {
+    // JIRA key takes priority
+    const jiraKeys = collectJiraKeys(metadata, '', '');
+    if (jiraKeys.length > 0)
+        return jiraKeys[0];
+    // ADO work item ID
+    const adoIds = collectAdoIds(metadata, '', '');
+    if (adoIds.length > 0)
+        return `AB#${adoIds[0]}`;
+    return null;
+}
+//# sourceMappingURL=pr-linker.js.map

package/dist/src/sync/pr-linker.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "1.0.447",
+  "version": "1.0.450",
   "description": "100+ domain-expert AI skills — PM, Architect, Frontend, QA, Security and more. Skills learn your team's patterns permanently. Spec-first planning, autonomous execution, multi-agent teams, synced to GitHub/JIRA. Claude Code, Cursor, Copilot & more.",
   "type": "module",
   "main": "dist/index.js",

package/plugins/specweave/commands/sync-setup.md

@@ -119,7 +119,30 @@ Write the following:
 }
 ```
 
-### Step 7: Dry Run
+### Step 7: Integration Health Check
+
+After credentials are validated, run a deeper health check to catch misconfigurations early (e.g., wrong issue types, missing permissions, unavailable integrations):
+
+```typescript
+// Import and run health checks for each enabled provider
+import { checkJiraIntegration, checkAdoIntegration, checkGitHubIntegration, formatHealthCheckResults } from '../../src/sync/integration-health-check.js';
+
+const results = [];
+if (jiraEnabled) results.push(await checkJiraIntegration({ domain, projectKey, email, apiToken }));
+if (adoEnabled)  results.push(await checkAdoIntegration({ organization, project, pat }));
+if (githubEnabled) results.push(await checkGitHubIntegration());
+
+console.log(formatHealthCheckResults(results));
+```
+
+This checks:
+- **JIRA**: API auth, project access, issue type availability (catches "The issue type selected is invalid"), edit permissions for remote links
+- **ADO**: API auth, work item type availability
+- **GitHub**: gh CLI authentication
+
+Warnings are advisory — they don't block setup but alert the user to fix issues before they hit them at increment closure.
+
+### Step 8: Dry Run
 
 Run a test sync (read-only) to verify configuration:
 

package/plugins/specweave/skills/get/SKILL.md

@@ -1,12 +1,13 @@
 ---
-version: 1.0.0
+version: 1.1.0
 description: >
-  Clone and register an existing repository into the SpecWeave workspace.
+  Clone and register an existing repository (or bulk-clone an entire org) into the SpecWeave workspace.
   Activate when the user wants to: add a repo, get a repo, clone a repo,
   register a repo, bring in a repo, pull in a repo, add a github repo to umbrella,
   clone and register, "get owner/repo", "add this github repo", "clone this repo
-  into my workspace", "register this local repo". Also activate for "restore repos"
-  or "clone all child repos" on a new machine.
+  into my workspace", "register this local repo". Also activate for "restore repos",
+  "clone all child repos" on a new machine, "clone all service-* repos", "bulk clone",
+  "clone entire org", "clone all repos matching pattern", "get all repos from org".
   Do NOT activate for: add a feature, add a task, add a story, add an increment,
   add a user story (those route to sw:increment).
 triggers:
@@ -20,6 +21,10 @@ triggers:
   - "pull in repo"
   - "restore repos"
   - "clone all child repos"
+  - "bulk clone"
+  - "clone entire org"
+  - "clone all repos"
+  - "clone all matching"
 negative_triggers:
   - "add a feature"
   - "add a task"
@@ -30,16 +35,21 @@ negative_triggers:
 
 # sw:get — Clone & Register Repository
 
-Use this skill when the user wants to add an existing repository to their SpecWeave workspace.
+Use this skill when the user wants to add an existing repository (or many repositories) to their SpecWeave workspace.
 
 ## What it does
 
 Runs `specweave get <source>` which:
-1. Parses the source (GitHub shorthand, full URL, SSH URL, or local path)
+1. Parses the source (GitHub shorthand, full URL, SSH URL, local path, or org glob pattern)
 2. Clones the repo into `repositories/{org}/{repo}/` (in umbrella context)
 3. Registers it in `.specweave/config.json` under `umbrella.childRepos`
 4. Runs `specweave init` inside the cloned repo
 
+For **bulk mode** (glob pattern or `--all`):
+- Fetches matching repos from the GitHub org via API
+- Launches a background clone job (survives terminal close)
+- Reports job ID; user monitors with `specweave jobs`
+
 ## Instructions
 
 1. Extract the repository source from the user's message:
@@ -47,16 +57,26 @@ Runs `specweave get <source>` which:
    - Full URL: `https://github.com/org/repo`
    - SSH: `git@github.com:org/repo`
    - Local path: `./path/to/repo`
+   - Glob pattern: `org/service-*` or `org/*`
+   - All repos in org: `--all org`
 
 2. Check if the user mentioned optional flags:
    - `--prefix` — US prefix (e.g., "use prefix FE")
    - `--role` — repo role (e.g., "it's a backend service")
    - `--branch` — specific branch (e.g., "clone the develop branch")
    - `--no-init` — skip specweave init
+   - `--all` — clone all repos in org
+   - `--pattern` — glob filter when used with `--all`
+   - `--no-archived` — skip archived repos
+   - `--no-forks` — skip forks
+   - `--limit` — max repos to fetch (default 1000)
 
 3. Run the command:
    ```bash
    specweave get <source> [--prefix X] [--role Y] [--branch Z] [--no-init]
+   # or bulk:
+   specweave get "org/service-*"
+   specweave get --all org [--pattern "svc-*"] [--no-archived] [--no-forks]
    ```
 
 4. Report the result to the user.
@@ -70,8 +90,20 @@ Runs `specweave get <source>` which:
 | "get this repo: git@github.com:org/repo" | `specweave get git@github.com:org/repo` |
 | "add ./my-local-service to the umbrella" | `specweave get ./my-local-service` |
 | "clone my-service with prefix MSV" | `specweave get owner/my-service --prefix MSV` |
+| "clone all service-* repos from acme-corp" | `specweave get "acme-corp/service-*"` |
+| "clone all repos in acme-corp org" | `specweave get --all acme-corp` |
+| "clone all acme-corp repos, skip archived and forks" | `specweave get --all acme-corp --no-archived --no-forks` |
+| "clone all api-* repos from myorg, max 200" | `specweave get "myorg/api-*" --limit 200` |
 | "restore all repos on this machine" | See note below |
 
+## Bulk Clone Notes
+
+- Requires GitHub auth: `GH_TOKEN` env var or `gh auth login`
+- Cloning runs in the **background** — terminal can be closed safely
+- Monitor progress: `specweave jobs`
+- Already-cloned repos are skipped automatically (idempotent)
+- Failed repos are tracked and can be resumed by re-running the same command
+
 ## New Machine Restore
 
 If the user says "restore repos", "clone all child repos", or "set up on new machine":

package/plugins/specweave/skills/pr/SKILL.md

@@ -39,9 +39,26 @@ If `prRefs` already has an entry with `state: "open"`, skip PR creation and repo
 
 ## Step 2: Determine Branch Name
 
+**External ticket key prefix** — If the increment was imported from JIRA/ADO, prefix the branch with the external ticket key for native integration linking:
+
 ```bash
-BRANCH_NAME="${BRANCH_PREFIX}${INCREMENT_ID}"
-# e.g., sw/0520-pr-based-increment-closure
+# Check metadata for external ticket key (JIRA or ADO)
+JIRA_KEY=$(jq -r '.jira.issue // .jira.issueKey // .externalLinks.jira.epicKey // .externalLinks.jira.issueKey // empty' \
+  .specweave/increments/${INCREMENT_ID}/metadata.json 2>/dev/null)
+ADO_ID=$(jq -r '.externalLinks.ado.featureId // .externalLinks.ado.workItemId // empty' \
+  .specweave/increments/${INCREMENT_ID}/metadata.json 2>/dev/null)
+EXTERNAL_KEY_BRANCHING=$(jq -r '.cicd.git.externalKeyBranching // true' .specweave/config.json 2>/dev/null)
+
+if [ "$EXTERNAL_KEY_BRANCHING" = "true" ] && [ -n "$JIRA_KEY" ]; then
+  BRANCH_NAME="${JIRA_KEY}/${INCREMENT_ID}"
+  # e.g., ID-300/0520-auth-gateway-otel
+elif [ "$EXTERNAL_KEY_BRANCHING" = "true" ] && [ -n "$ADO_ID" ]; then
+  BRANCH_NAME="AB#${ADO_ID}/${INCREMENT_ID}"
+  # e.g., AB#4567/0520-auth-gateway-otel
+else
+  BRANCH_NAME="${BRANCH_PREFIX}${INCREMENT_ID}"
+  # e.g., sw/0520-pr-based-increment-closure
+fi
 ```
 
 Check current branch:
@@ -147,6 +164,26 @@ Update increment metadata with PR reference. Edit `metadata.json` to add/update
 
 Use `jq` or direct JSON edit to update metadata.json.
 
+## Step 7b: Link PR to External Tickets
+
+After PR creation, link the PR to any associated JIRA/ADO tickets. This creates remote links (JIRA) or hyperlinks (ADO) so the PR appears in the external tool's UI.
+
+```bash
+specweave link-pr \
+  --increment "${INCREMENT_ID}" \
+  --pr-url "${PR_URL}" \
+  --pr-number "${PR_NUMBER}" \
+  --branch "${BRANCH_NAME}"
+```
+
+This is **non-blocking** — if linking fails, the PR is still created successfully. Errors are logged as warnings.
+
+The link-pr command:
+- Reads metadata.json for JIRA issue keys and ADO work item IDs
+- Creates JIRA remote links via `/rest/api/3/issue/{key}/remotelink` (idempotent via `globalId`)
+- Creates ADO work item hyperlinks via JSON Patch on work item relations
+- Reports linked tickets and any errors
+
 ## Step 8: Multi-Repo / Umbrella Mode
 
 Check if umbrella mode is enabled:

package/plugins/specweave-ado/lib/ado-client.js

@@ -127,6 +127,28 @@ class AdoClient {
     const response = await this.request("POST", url, { text });
     return response;
   }
+  /**
+   * Add hyperlink relation to work item (for PR linking)
+   *
+   * @see https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/work-items/update
+   */
+  async addHyperlink(workItemId, url, comment) {
+    const apiUrl = `${this.baseUrl}/_apis/wit/workitems/${workItemId}?api-version=7.1`;
+    const operations = [{
+      op: "add",
+      path: "/relations/-",
+      value: {
+        rel: "Hyperlink",
+        url,
+        attributes: {
+          comment
+        }
+      }
+    }];
+    await this.request("PATCH", apiUrl, operations, {
+      "Content-Type": "application/json-patch+json"
+    });
+  }
   /**
    * Get comments for work item
    *