feat(bugs): add bug-to-tangled-issue linking

Allow namespace authorities to link bugs to Tangled issues:
- Add "Link Issue" button in bug detail overlay
- Modal flow: select repo → create new issue or link existing
- Auto-generate Tangled issues from bug title/description/steps
- Display linked issues in bug detail with "View on Tangled" links
- Unlink functionality for namespace authorities

Also includes OAuth scope updates for bug.issue and tangled issue
records, and new GraphQL queries/mutations for the feature.

bugs.html

···
         word-break: break-word;
       }
 
+      /* Linked issues */
+      .linked-issues-list {
+        display: flex;
+        flex-direction: column;
+        gap: 0.5rem;
+        margin-top: 0.5rem;
+      }
+
+      .linked-issues-list .card {
+        padding: 0.75rem;
+        margin-bottom: 0;
+      }
+
+      .linked-issues-list .card:hover {
+        transform: none;
+        box-shadow: none;
+      }
+
+      .linked-issues-list a {
+        color: var(--accent);
+        text-decoration: none;
+      }
+
+      .linked-issues-list a:hover {
+        text-decoration: underline;
+      }
+
+      /* Repo and issue lists in modal */
+      .repo-list,
+      .issue-list {
+        display: flex;
+        flex-direction: column;
+        gap: 0.5rem;
+      }
+
+      .repo-list .card,
+      .issue-list .card {
+        margin-bottom: 0;
+      }
+
       /* =============================================================================
          MOBILE RESPONSIVE STYLES
          ============================================================================= */
···
         }
 
         .overlay-header {
-          flex-direction: column;
-          align-items: flex-start;
-          gap: 0.75rem;
           position: relative;
           padding-right: 3.5rem;
         }
 
-        .overlay-title {
-          margin-right: 0;
+        .overlay-header > .overlay-close {
+          position: absolute;
+          top: 1rem;
+          right: 1rem;
         }
 
         .overlay-actions {
-          width: 100%;
-          justify-content: flex-start;
           flex-wrap: wrap;
-        }
-
-        .overlay-header > .overlay-actions > .overlay-close {
-          position: absolute;
-          top: 1rem;
-          right: 1rem;
         }
 
         /* Modal - nearly full screen */
···
         existingAttachments: [], // Track which existing attachments to keep when editing
         confirmedNamespace: false, // Track if user confirmed a domain-like namespace
         handleSuggestions: [], // Handle autocomplete suggestions
-        handleSuggestionIndex: -1 // Currently selected suggestion
+        handleSuggestionIndex: -1, // Currently selected suggestion
+        linkIssueState: {
+          bugUri: null,
+          step: "repos", // "repos" | "issues"
+          repos: [],
+          selectedRepo: null,
+          issues: [],
+          isLoading: false
+        }
       };
 
       // =============================================================================
···
                     }
                   }
                 }
+                networkSlicesToolsBugIssueViaBug {
+                  edges {
+                    node {
+                      uri
+                      issue
+                      issueResolved {
+                        ... on ShTangledRepoIssue {
+                          uri
+                          title
+                          repo
+                          repoResolved {
+                            ... on ShTangledRepo {
+                              name
+                              actorHandle
+                            }
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
               }
             }
             pageInfo {
···
         }
       `;
 
+      const VIEWER_REPOS_QUERY = `
+        query {
+          viewer {
+            shTangledRepoByDid(sortBy: [{ field: createdAt, direction: DESC }]) {
+              edges {
+                node {
+                  uri
+                  name
+                  description
+                  actorHandle
+                }
+              }
+            }
+          }
+        }
+      `;
+
+      const REPO_ISSUES_QUERY = `
+        query GetRepoIssues($repoUri: String!) {
+          shTangledRepoIssue(
+            where: { repo: { eq: $repoUri } }
+            sortBy: [{ field: createdAt, direction: DESC }]
+          ) {
+            edges {
+              node {
+                uri
+                title
+                createdAt
+              }
+            }
+          }
+        }
+      `;
+
+      const CREATE_TANGLED_ISSUE_MUTATION = `
+        mutation CreateTangledIssue($input: ShTangledRepoIssueInput!) {
+          createShTangledRepoIssue(input: $input) {
+            uri
+          }
+        }
+      `;
+
+      const CREATE_BUG_ISSUE_MUTATION = `
+        mutation CreateBugIssue($input: NetworkSlicesToolsBugIssueInput!) {
+          createNetworkSlicesToolsBugIssue(input: $input) {
+            uri
+          }
+        }
+      `;
+
+      const DELETE_BUG_ISSUE_MUTATION = `
+        mutation DeleteBugIssue($rkey: String!) {
+          deleteNetworkSlicesToolsBugIssue(rkey: $rkey) {
+            uri
+          }
+        }
+      `;
+
       // =============================================================================
       // DATA FETCHING
       // =============================================================================
···
               <span class="status-badge ${displayStatus.cssClass}">${esc(displayStatus.label)}</span>
               <h2 class="overlay-title">${esc(bug.title)}</h2>
             </div>
-            <div class="overlay-actions">
-              <button class="btn btn-secondary" onclick="shareBug()">Share</button>
-              ${canEdit ? `
-                <button class="btn btn-secondary" onclick="openEditModal('${esc(bug.uri)}')">Edit</button>
-                <button class="btn btn-danger" onclick="handleDeleteBug('${esc(bug.uri)}')">Delete</button>
-              ` : ""}
-              <button class="overlay-close" onclick="closeOverlay()">×</button>
-            </div>
+            <button class="overlay-close" onclick="closeOverlay()">×</button>
           </div>
           <div class="overlay-body">
             <div class="overlay-meta">
···
               ${bug.appUsed ? `<span>·</span><span>${esc(bug.appUsed)}</span>` : ""}
             </div>
 
+            <div class="overlay-actions" style="margin-bottom: 1.5rem;">
+              <button class="btn btn-secondary" onclick="shareBug()">Share</button>
+              ${canAddResponse ? `<button class="btn btn-secondary" onclick="openLinkIssueModal('${esc(bug.uri)}')">Link Issue</button>` : ""}
+              ${canEdit ? `
+                <button class="btn btn-secondary" onclick="openEditModal('${esc(bug.uri)}')">Edit</button>
+                <button class="btn btn-danger" onclick="handleDeleteBug('${esc(bug.uri)}')">Delete</button>
+              ` : ""}
+            </div>
+
             <div class="overlay-section">
               <h3>Description</h3>
               <p>${esc(bug.description)}</p>
···
               </div>
             </div>
 
+            ${renderLinkedIssues(bug, canAddResponse)}
+
             ${canAddResponse ? renderResponseForm() : ""}
           </div>
         `;
       }
 
+      async function openLinkIssueModal(bugUri) {
+        state.linkIssueState = {
+          bugUri,
+          step: "repos",
+          repos: [],
+          selectedRepo: null,
+          issues: [],
+          isLoading: true
+        };
+
+        renderLinkIssueModal();
+
+        try {
+          const data = await gqlMutation(VIEWER_REPOS_QUERY, {});
+          state.linkIssueState.repos = data.viewer?.shTangledRepoByDid?.edges?.map(e => e.node) || [];
+        } catch (err) {
+          console.error("Failed to fetch repos:", err);
+          showError(`Failed to load repos: ${err.message}`);
+        } finally {
+          state.linkIssueState.isLoading = false;
+          renderLinkIssueModal();
+        }
+      }
+
+      function renderLinkIssueModal() {
+        const modal = document.getElementById("modal");
+        const { step, repos, selectedRepo, issues, isLoading } = state.linkIssueState;
+
+        let content = "";
+
+        if (step === "repos") {
+          content = `
+            <div class="modal-header">
+              <h2>Link to Tangled Issue</h2>
+              <button class="modal-close" onclick="closeLinkIssueModal()">×</button>
+            </div>
+            <div class="modal-body">
+              ${isLoading ? `
+                <div class="loading-container">
+                  <div class="spinner"></div>
+                  <span>Loading repos...</span>
+                </div>
+              ` : repos.length === 0 ? `
+                <div class="loading-container">
+                  <p>No Tangled repos found.</p>
+                  <p class="text-secondary">Create a repo on <a href="https://tangled.sh" target="_blank">tangled.sh</a> first.</p>
+                </div>
+              ` : `
+                <div class="form-group">
+                  <label for="repo-select">Select a repository:</label>
+                  <select id="repo-select" onchange="if(this.value) selectRepoForLinking(this.value)">
+                    <option value="">Choose a repo...</option>
+                    ${repos.map(repo => `
+                      <option value="${esc(repo.uri)}">${esc(repo.name)}</option>
+                    `).join("")}
+                  </select>
+                </div>
+              `}
+            </div>
+          `;
+        } else if (step === "issues") {
+          const bug = state.bugs.find(b => b.uri === state.linkIssueState.bugUri);
+          content = `
+            <div class="modal-header">
+              <h2>Link to Tangled Issue</h2>
+              <button class="modal-close" onclick="closeLinkIssueModal()">×</button>
+            </div>
+            <div class="modal-body">
+              <button class="btn btn-secondary" onclick="goBackToRepos()" style="margin-bottom: 1rem;">← Back to repos</button>
+              <p style="margin-bottom: 0.5rem;"><strong>${esc(selectedRepo.name)}</strong></p>
+
+              <button class="btn btn-primary" style="width: 100%; margin-bottom: 1rem;" onclick="createAndLinkIssue()" ${isLoading ? 'disabled' : ''}>
+                + Create New Issue from Bug
+              </button>
+
+              ${isLoading ? `
+                <div class="loading-container">
+                  <div class="spinner"></div>
+                  <span>Loading issues...</span>
+                </div>
+              ` : issues.length === 0 ? `
+                <p class="text-secondary">No existing issues in this repo.</p>
+              ` : `
+                <p class="text-secondary" style="margin-bottom: 0.5rem;">Or link to existing issue:</p>
+                <div class="issue-list">
+                  ${issues.map(issue => `
+                    <div class="card" style="cursor: pointer;" onclick="linkToExistingIssue('${esc(issue.uri)}')">
+                      <div style="font-weight: 500;">${esc(issue.title)}</div>
+                      <div class="text-secondary" style="font-size: 0.75rem;">${formatTime(issue.createdAt)}</div>
+                    </div>
+                  `).join("")}
+                </div>
+              `}
+            </div>
+          `;
+        }
+
+        modal.innerHTML = `
+          <div class="modal-backdrop" onclick="closeLinkIssueModal()"></div>
+          <div class="modal-content scrollable">
+            ${content}
+          </div>
+        `;
+        modal.classList.remove("hidden");
+      }
+
+      function closeLinkIssueModal() {
+        state.linkIssueState = {
+          bugUri: null,
+          step: "repos",
+          repos: [],
+          selectedRepo: null,
+          issues: [],
+          isLoading: false
+        };
+        closeModal();
+      }
+
+      async function selectRepoForLinking(repoUri) {
+        const repo = state.linkIssueState.repos.find(r => r.uri === repoUri);
+        state.linkIssueState.selectedRepo = repo;
+        state.linkIssueState.step = "issues";
+        state.linkIssueState.isLoading = true;
+        state.linkIssueState.issues = [];
+
+        renderLinkIssueModal();
+
+        try {
+          const data = await gqlQuery(REPO_ISSUES_QUERY, { repoUri });
+          state.linkIssueState.issues = data.shTangledRepoIssue?.edges?.map(e => e.node) || [];
+        } catch (err) {
+          console.error("Failed to fetch issues:", err);
+          showError(`Failed to load issues: ${err.message}`);
+        } finally {
+          state.linkIssueState.isLoading = false;
+          renderLinkIssueModal();
+        }
+      }
+
+      function goBackToRepos() {
+        state.linkIssueState.step = "repos";
+        state.linkIssueState.selectedRepo = null;
+        state.linkIssueState.issues = [];
+        renderLinkIssueModal();
+      }
+
+      async function createAndLinkIssue() {
+        const { bugUri, selectedRepo } = state.linkIssueState;
+        const bug = state.bugs.find(b => b.uri === bugUri);
+
+        if (!bug || !selectedRepo) return;
+
+        state.linkIssueState.isLoading = true;
+        renderLinkIssueModal();
+
+        try {
+          // Build issue body from bug data
+          const bugUrl = `https://tools.slices.network/bugs?ns=${encodeURIComponent(bug.namespace)}&bug=${encodeURIComponent(bug.uri)}`;
+          const issueBody = `**Description:**
+${bug.description}
+
+**Steps to Reproduce:**
+${bug.stepsToReproduce}
+
+---
+Linked from bug: ${bugUrl}`;
+
+          // Create the Tangled issue
+          const issueInput = {
+            repo: selectedRepo.uri,
+            title: bug.title,
+            body: issueBody,
+            createdAt: new Date().toISOString()
+          };
+
+          const issueResult = await gqlMutation(CREATE_TANGLED_ISSUE_MUTATION, { input: issueInput });
+          const newIssueUri = issueResult.createShTangledRepoIssue.uri;
+
+          // Create the bug.issue link
+          const linkInput = {
+            bug: bugUri,
+            issue: newIssueUri,
+            createdAt: new Date().toISOString()
+          };
+
+          await gqlMutation(CREATE_BUG_ISSUE_MUTATION, { input: linkInput });
+
+          // Close modal and refresh
+          closeLinkIssueModal();
+
+          // Refresh bugs to get updated linked issues
+          await loadBugs();
+
+          // Re-open the overlay to show the new linked issue
+          if (state.bugUri) {
+            renderOverlay();
+          }
+
+          showSuccess("Issue created and linked!");
+        } catch (err) {
+          console.error("Failed to create and link issue:", err);
+          showError(`Failed to create issue: ${err.message}`);
+          state.linkIssueState.isLoading = false;
+          renderLinkIssueModal();
+        }
+      }
+
+      async function linkToExistingIssue(issueUri) {
+        const { bugUri } = state.linkIssueState;
+
+        if (!bugUri) return;
+
+        state.linkIssueState.isLoading = true;
+        renderLinkIssueModal();
+
+        try {
+          const linkInput = {
+            bug: bugUri,
+            issue: issueUri,
+            createdAt: new Date().toISOString()
+          };
+
+          await gqlMutation(CREATE_BUG_ISSUE_MUTATION, { input: linkInput });
+
+          closeLinkIssueModal();
+
+          // Refresh bugs to get updated linked issues
+          await loadBugs();
+
+          // Re-open the overlay to show the linked issue
+          if (state.bugUri) {
+            renderOverlay();
+          }
+
+          showSuccess("Issue linked!");
+        } catch (err) {
+          console.error("Failed to link issue:", err);
+          showError(`Failed to link issue: ${err.message}`);
+          state.linkIssueState.isLoading = false;
+          renderLinkIssueModal();
+        }
+      }
+
+      function getTangledIssueUrl(issue) {
+        if (!issue.issueResolved) return null;
+        const resolved = issue.issueResolved;
+        if (!resolved.repoResolved) return null;
+
+        const handle = resolved.repoResolved.actorHandle;
+        const repoName = resolved.repoResolved.name;
+
+        // Tangled doesn't support linking to specific issues by rkey yet,
+        // so link to the repo's issues page instead
+        return `https://tangled.sh/${handle}/${repoName}/issues`;
+      }
+
+      function renderLinkedIssues(bug, canUnlink) {
+        const linkedIssues = bug.networkSlicesToolsBugIssueViaBug?.edges?.map(e => e.node) || [];
+
+        if (linkedIssues.length === 0) {
+          return "";
+        }
+
+        return `
+          <div class="overlay-section">
+            <h3>Linked Issues (${linkedIssues.length})</h3>
+            <div class="linked-issues-list">
+              ${linkedIssues.map(link => {
+                const issue = link.issueResolved;
+                const url = getTangledIssueUrl(link);
+                const title = issue?.title || "Unknown Issue";
+                const repoName = issue?.repoResolved?.name || "Unknown Repo";
+
+                return `
+                  <div class="card" style="display: flex; justify-content: space-between; align-items: center; cursor: default;">
+                    <div>
+                      <div style="font-weight: 500;">${esc(title)}</div>
+                      <div class="text-secondary" style="font-size: 0.75rem;">
+                        ${esc(repoName)}
+                        ${url ? ` · <a href="${esc(url)}" target="_blank" onclick="event.stopPropagation()">View on Tangled</a>` : ''}
+                      </div>
+                    </div>
+                    ${canUnlink ? `<button class="btn-icon btn-danger-text" onclick="unlinkIssue('${esc(link.uri)}')" title="Unlink">×</button>` : ''}
+                  </div>
+                `;
+              }).join("")}
+            </div>
+          </div>
+        `;
+      }
+
+      async function unlinkIssue(linkUri) {
+        if (!confirm("Unlink this issue?")) {
+          return;
+        }
+
+        try {
+          const rkey = getRkeyFromUri(linkUri);
+          await gqlMutation(DELETE_BUG_ISSUE_MUTATION, { rkey });
+
+          // Refresh bugs to update linked issues
+          await loadBugs();
+
+          // Re-render overlay
+          if (state.bugUri) {
+            renderOverlay();
+          }
+
+          showSuccess("Issue unlinked!");
+        } catch (err) {
+          console.error("Failed to unlink issue:", err);
+          showError(`Failed to unlink: ${err.message}`);
+        }
+      }
+
       function renderAttachments(attachments) {
         if (!attachments || !attachments.images || attachments.images.length === 0) {
           return "";
···
           client = await QuicksliceClient.createQuicksliceClient({
             server: SERVER_URL,
             clientId: CLIENT_ID,
-            scope: "atproto repo:network.slices.tools.bug repo:network.slices.tools.bugResponse blob:image/*"
+            scope: "atproto repo:network.slices.tools.bug repo:network.slices.tools.bug.response repo:network.slices.tools.bug.issue repo:sh.tangled.repo.issue blob:image/*"
           });
         }
         return client;
···
           await initClient();
           await client.loginWithRedirect({
             handle,
-            scope: "atproto repo:network.slices.tools.bug repo:network.slices.tools.bugResponse blob:image/*"
+            scope: "atproto repo:network.slices.tools.bug repo:network.slices.tools.bug.response repo:network.slices.tools.bug.issue repo:sh.tangled.repo.issue blob:image/*"
           });
         } catch (err) {
           console.error("Login failed:", err);

docs/plans/2025-12-17-bug-issue-linking.md

···
+# Bug-to-Tangled-Issue Linking Implementation Plan
+
+> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
+
+**Goal:** Allow namespace authorities to link bugs to Tangled issues (existing or newly created from bug data).
+
+**Architecture:** Add a modal flow in bugs.html: click "Link Issue" → select repo → choose existing issue or create new → creates `bug.issue` record. Display linked issues in bug detail with unlink option.
+
+**Tech Stack:** Vanilla JS, GraphQL mutations via Quickslice client, existing modal/overlay patterns in bugs.html.
+
+---
+
+### Task 1: Update OAuth Scope
+
+**Files:**
+- Modify: `bugs.html:2519` (scope in initClient)
+- Modify: `bugs.html:2686` (scope in handleLogin)
+
+**Step 1: Add bug.issue and tangled issue scopes to initClient**
+
+In the `initClient` function around line 2519, update the scope:
+
+```javascript
+client = await QuicksliceClient.createQuicksliceClient({
+  server: SERVER_URL,
+  clientId: CLIENT_ID,
+  scope: "atproto repo:network.slices.tools.bug repo:network.slices.tools.bug.response repo:network.slices.tools.bug.issue repo:sh.tangled.repo.issue blob:image/*"
+});
+```
+
+**Step 2: Update scope in handleLogin**
+
+In the `handleLogin` function around line 2686, update the scope:
+
+```javascript
+await client.loginWithRedirect({
+  handle,
+  scope: "atproto repo:network.slices.tools.bug repo:network.slices.tools.bug.response repo:network.slices.tools.bug.issue repo:sh.tangled.repo.issue blob:image/*"
+});
+```
+
+**Step 3: Verify by logging in**
+
+1. Open bugs.html in browser
+2. Log out if logged in
+3. Log in again
+4. Check browser console for OAuth errors (should be none)
+
+**Step 4: Commit**
+
+```bash
+git add bugs.html
+git commit -m "feat(bugs): add oauth scopes for bug.issue and tangled issues"
+```
+
+---
+
+### Task 2: Add GraphQL Queries and Mutations
+
+**Files:**
+- Modify: `bugs.html` (add after line ~1289, after DELETE_RESPONSE_MUTATION)
+
+**Step 1: Add query for viewer's repos**
+
+Add this query constant:
+
+```javascript
+const VIEWER_REPOS_QUERY = `
+  query {
+    viewer {
+      shTangledRepoByDid(sortBy: [{ field: createdAt, direction: DESC }]) {
+        edges {
+          node {
+            uri
+            name
+            description
+            actorHandle
+          }
+        }
+      }
+    }
+  }
+`;
+```
+
+**Step 2: Add query for repo issues**
+
+```javascript
+const REPO_ISSUES_QUERY = `
+  query GetRepoIssues($repoUri: String!) {
+    shTangledRepoIssue(
+      where: { repo: { eq: $repoUri } }
+      sortBy: [{ field: createdAt, direction: DESC }]
+    ) {
+      edges {
+        node {
+          uri
+          title
+          createdAt
+        }
+      }
+    }
+  }
+`;
+```
+
+**Step 3: Add mutation to create Tangled issue**
+
+```javascript
+const CREATE_TANGLED_ISSUE_MUTATION = `
+  mutation CreateTangledIssue($input: ShTangledRepoIssueInput!) {
+    createShTangledRepoIssue(input: $input) {
+      uri
+    }
+  }
+`;
+```
+
+**Step 4: Add mutation to create bug.issue link**
+
+```javascript
+const CREATE_BUG_ISSUE_MUTATION = `
+  mutation CreateBugIssue($input: NetworkSlicesToolsBugIssueInput!) {
+    createNetworkSlicesToolsBugIssue(input: $input) {
+      uri
+    }
+  }
+`;
+```
+
+**Step 5: Add mutation to delete bug.issue link**
+
+```javascript
+const DELETE_BUG_ISSUE_MUTATION = `
+  mutation DeleteBugIssue($rkey: String!) {
+    deleteNetworkSlicesToolsBugIssue(rkey: $rkey) {
+      uri
+    }
+  }
+`;
+```
+
+**Step 6: Verify syntax**
+
+Open bugs.html in browser, check console for JS syntax errors (should be none).
+
+**Step 7: Commit**
+
+```bash
+git add bugs.html
+git commit -m "feat(bugs): add graphql queries/mutations for issue linking"
+```
+
+---
+
+### Task 3: Update BUGS_QUERY to Include Linked Issues
+
+**Files:**
+- Modify: `bugs.html:1170-1220` (BUGS_QUERY)
+
+**Step 1: Add linked issues to the bugs query**
+
+Update BUGS_QUERY to include `networkSlicesToolsBugIssueViaBug` with resolved issue data:
+
+```javascript
+const BUGS_QUERY = `
+  query GetBugs($first: Int!, $after: String, $namespace: String) {
+    networkSlicesToolsBug(
+      where: { namespace: { eq: $namespace } }
+      sortBy: [{ field: createdAt, direction: DESC }]
+      first: $first
+      after: $after
+    ) {
+      edges {
+        node {
+          uri
+          did
+          title
+          description
+          stepsToReproduce
+          severity
+          appUsed
+          namespace
+          createdAt
+          actorHandle
+          attachments {
+            ... on NetworkSlicesToolsDefsImages {
+              images {
+                alt
+                image {
+                  ref
+                  mimeType
+                  size
+                  url(preset: "feed_fullsize")
+                }
+              }
+            }
+          }
+          networkSlicesToolsBugResponseViaBug {
+            edges {
+              node {
+                status
+                createdAt
+              }
+            }
+          }
+          networkSlicesToolsBugIssueViaBug {
+            edges {
+              node {
+                uri
+                issue
+                issueResolved {
+                  ... on ShTangledRepoIssue {
+                    uri
+                    title
+                    repo
+                    repoResolved {
+                      ... on ShTangledRepo {
+                        name
+                        actorHandle
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+      pageInfo {
+        hasNextPage
+        endCursor
+      }
+    }
+  }
+`;
+```
+
+**Step 2: Verify query works**
+
+1. Refresh bugs.html
+2. Navigate to a namespace with bugs
+3. Check Network tab for GraphQL response (should include `networkSlicesToolsBugIssueViaBug` field, even if empty)
+
+**Step 3: Commit**
+
+```bash
+git add bugs.html
+git commit -m "feat(bugs): include linked issues in bugs query"
+```
+
+---
+
+### Task 4: Add "Link Issue" Button to Bug Detail Overlay
+
+**Files:**
+- Modify: `bugs.html` (renderOverlay function, around line 1559-1575)
+
+**Step 1: Add the Link Issue button**
+
+In the `renderOverlay` function, find the overlay-actions div and add the Link Issue button (only for namespace authority):
+
+Update this section:
+
+```javascript
+<div class="overlay-actions">
+  <button class="btn btn-secondary" onclick="shareBug()">Share</button>
+  ${canAddResponse ? `<button class="btn btn-secondary" onclick="openLinkIssueModal('${esc(bug.uri)}')">Link Issue</button>` : ""}
+  ${canEdit ? `
+    <button class="btn btn-secondary" onclick="openEditModal('${esc(bug.uri)}')">Edit</button>
+    <button class="btn btn-danger" onclick="handleDeleteBug('${esc(bug.uri)}')">Delete</button>
+  ` : ""}
+  <button class="overlay-close" onclick="closeOverlay()">×</button>
+</div>
+```
+
+**Step 2: Add placeholder function**
+
+Add this function after the `renderOverlay` function:
+
+```javascript
+function openLinkIssueModal(bugUri) {
+  console.log("Opening link issue modal for:", bugUri);
+  // TODO: implement
+}
+```
+
+**Step 3: Verify button appears**
+
+1. Refresh bugs.html
+2. Log in as the namespace authority (e.g., @grain.social for social.grain bugs)
+3. Open a bug detail
+4. Verify "Link Issue" button appears next to Share
+5. Click it, check console shows the log message
+
+**Step 4: Commit**
+
+```bash
+git add bugs.html
+git commit -m "feat(bugs): add link issue button to bug detail overlay"
+```
+
+---
+
+### Task 5: Implement Link Issue Modal - Repo Selection Step
+
+**Files:**
+- Modify: `bugs.html` (add new function and state)
+
+**Step 1: Add state for link issue modal**
+
+In the state object (around line 950), add:
+
+```javascript
+linkIssueState: {
+  bugUri: null,
+  step: "repos", // "repos" | "issues"
+  repos: [],
+  selectedRepo: null,
+  issues: [],
+  isLoading: false
+},
+```
+
+**Step 2: Implement openLinkIssueModal function**
+
+Replace the placeholder with the full implementation:
+
+```javascript
+async function openLinkIssueModal(bugUri) {
+  state.linkIssueState = {
+    bugUri,
+    step: "repos",
+    repos: [],
+    selectedRepo: null,
+    issues: [],
+    isLoading: true
+  };
+
+  renderLinkIssueModal();
+
+  try {
+    const data = await gqlMutation(VIEWER_REPOS_QUERY, {});
+    state.linkIssueState.repos = data.viewer?.shTangledRepoByDid?.edges?.map(e => e.node) || [];
+  } catch (err) {
+    console.error("Failed to fetch repos:", err);
+    showError(`Failed to load repos: ${err.message}`);
+  } finally {
+    state.linkIssueState.isLoading = false;
+    renderLinkIssueModal();
+  }
+}
+```
+
+**Step 3: Implement renderLinkIssueModal function**
+
+```javascript
+function renderLinkIssueModal() {
+  const modal = document.getElementById("modal");
+  const { step, repos, selectedRepo, issues, isLoading } = state.linkIssueState;
+
+  let content = "";
+
+  if (step === "repos") {
+    content = `
+      <div class="modal-header">
+        <h2>Link to Tangled Issue</h2>
+        <button class="modal-close" onclick="closeLinkIssueModal()">×</button>
+      </div>
+      <div class="modal-body">
+        ${isLoading ? `
+          <div class="loading-container">
+            <div class="spinner"></div>
+            <span>Loading repos...</span>
+          </div>
+        ` : repos.length === 0 ? `
+          <div class="loading-container">
+            <p>No Tangled repos found.</p>
+            <p class="text-secondary">Create a repo on <a href="https://tangled.sh" target="_blank">tangled.sh</a> first.</p>
+          </div>
+        ` : `
+          <p class="text-secondary" style="margin-bottom: 1rem;">Select a repository:</p>
+          <div class="repo-list">
+            ${repos.map(repo => `
+              <div class="card" style="cursor: pointer;" onclick="selectRepoForLinking('${esc(repo.uri)}')">
+                <div style="font-weight: 500;">${esc(repo.name)}</div>
+                ${repo.description ? `<div class="text-secondary" style="font-size: 0.875rem;">${esc(repo.description.substring(0, 100))}${repo.description.length > 100 ? '...' : ''}</div>` : ''}
+              </div>
+            `).join("")}
+          </div>
+        `}
+      </div>
+    `;
+  }
+
+  modal.innerHTML = `
+    <div class="modal-backdrop" onclick="closeLinkIssueModal()"></div>
+    <div class="modal-content scrollable">
+      ${content}
+    </div>
+  `;
+  modal.classList.remove("hidden");
+}
+```
+
+**Step 4: Add closeLinkIssueModal function**
+
+```javascript
+function closeLinkIssueModal() {
+  state.linkIssueState = {
+    bugUri: null,
+    step: "repos",
+    repos: [],
+    selectedRepo: null,
+    issues: [],
+    isLoading: false
+  };
+  closeModal();
+}
+```
+
+**Step 5: Add placeholder for selectRepoForLinking**
+
+```javascript
+async function selectRepoForLinking(repoUri) {
+  console.log("Selected repo:", repoUri);
+  // TODO: implement step 2
+}
+```
+
+**Step 6: Verify repo list shows**
+
+1. Refresh bugs.html
+2. Log in as namespace authority
+3. Open a bug, click "Link Issue"
+4. Verify modal shows with your Tangled repos (or empty state if none)
+
+**Step 7: Commit**
+
+```bash
+git add bugs.html
+git commit -m "feat(bugs): implement link issue modal repo selection"
+```
+
+---
+
+### Task 6: Implement Issue Selection Step
+
+**Files:**
+- Modify: `bugs.html` (selectRepoForLinking and renderLinkIssueModal)
+
+**Step 1: Implement selectRepoForLinking**
+
+Replace the placeholder:
+
+```javascript
+async function selectRepoForLinking(repoUri) {
+  const repo = state.linkIssueState.repos.find(r => r.uri === repoUri);
+  state.linkIssueState.selectedRepo = repo;
+  state.linkIssueState.step = "issues";
+  state.linkIssueState.isLoading = true;
+  state.linkIssueState.issues = [];
+
+  renderLinkIssueModal();
+
+  try {
+    const data = await gqlQuery(REPO_ISSUES_QUERY, { repoUri });
+    state.linkIssueState.issues = data.shTangledRepoIssue?.edges?.map(e => e.node) || [];
+  } catch (err) {
+    console.error("Failed to fetch issues:", err);
+    showError(`Failed to load issues: ${err.message}`);
+  } finally {
+    state.linkIssueState.isLoading = false;
+    renderLinkIssueModal();
+  }
+}
+```
+
+**Step 2: Add issues step to renderLinkIssueModal**
+
+In the `renderLinkIssueModal` function, add an else-if for the issues step after the repos step:
+
+```javascript
+} else if (step === "issues") {
+  const bug = state.bugs.find(b => b.uri === state.linkIssueState.bugUri);
+  content = `
+    <div class="modal-header">
+      <h2>Link to Tangled Issue</h2>
+      <button class="modal-close" onclick="closeLinkIssueModal()">×</button>
+    </div>
+    <div class="modal-body">
+      <button class="btn btn-secondary" onclick="goBackToRepos()" style="margin-bottom: 1rem;">← Back to repos</button>
+      <p style="margin-bottom: 0.5rem;"><strong>${esc(selectedRepo.name)}</strong></p>
+
+      <button class="btn btn-primary" style="width: 100%; margin-bottom: 1rem;" onclick="createAndLinkIssue()" ${isLoading ? 'disabled' : ''}>
+        + Create New Issue from Bug
+      </button>
+
+      ${isLoading ? `
+        <div class="loading-container">
+          <div class="spinner"></div>
+          <span>Loading issues...</span>
+        </div>
+      ` : issues.length === 0 ? `
+        <p class="text-secondary">No existing issues in this repo.</p>
+      ` : `
+        <p class="text-secondary" style="margin-bottom: 0.5rem;">Or link to existing issue:</p>
+        <div class="issue-list">
+          ${issues.map(issue => `
+            <div class="card" style="cursor: pointer;" onclick="linkToExistingIssue('${esc(issue.uri)}')">
+              <div style="font-weight: 500;">${esc(issue.title)}</div>
+              <div class="text-secondary" style="font-size: 0.75rem;">${formatTime(issue.createdAt)}</div>
+            </div>
+          `).join("")}
+        </div>
+      `}
+    </div>
+  `;
+}
+```
+
+**Step 3: Add goBackToRepos function**
+
+```javascript
+function goBackToRepos() {
+  state.linkIssueState.step = "repos";
+  state.linkIssueState.selectedRepo = null;
+  state.linkIssueState.issues = [];
+  renderLinkIssueModal();
+}
+```
+
+**Step 4: Add placeholder functions**
+
+```javascript
+async function createAndLinkIssue() {
+  console.log("Creating and linking issue");
+  // TODO: implement
+}
+
+async function linkToExistingIssue(issueUri) {
+  console.log("Linking to existing issue:", issueUri);
+  // TODO: implement
+}
+```
+
+**Step 5: Verify issues step works**
+
+1. Refresh bugs.html
+2. Open link issue modal, select a repo
+3. Verify you see "Create New Issue" button and list of existing issues (or empty state)
+4. Verify back button works
+
+**Step 6: Commit**
+
+```bash
+git add bugs.html
+git commit -m "feat(bugs): implement link issue modal issue selection step"
+```
+
+---
+
+### Task 7: Implement Create and Link Issue
+
+**Files:**
+- Modify: `bugs.html` (createAndLinkIssue function)
+
+**Step 1: Implement createAndLinkIssue**
+
+Replace the placeholder:
+
+```javascript
+async function createAndLinkIssue() {
+  const { bugUri, selectedRepo } = state.linkIssueState;
+  const bug = state.bugs.find(b => b.uri === bugUri);
+
+  if (!bug || !selectedRepo) return;
+
+  state.linkIssueState.isLoading = true;
+  renderLinkIssueModal();
+
+  try {
+    // Build issue body from bug data
+    const bugUrl = `${window.location.origin}${window.location.pathname}?ns=${encodeURIComponent(bug.namespace)}&bug=${encodeURIComponent(bug.uri)}`;
+    const issueBody = `**Description:**
+${bug.description}
+
+**Steps to Reproduce:**
+${bug.stepsToReproduce}
+
+---
+Linked from bug: ${bugUrl}`;
+
+    // Create the Tangled issue
+    const issueInput = {
+      repo: selectedRepo.uri,
+      title: bug.title,
+      body: issueBody,
+      createdAt: new Date().toISOString()
+    };
+
+    const issueResult = await gqlMutation(CREATE_TANGLED_ISSUE_MUTATION, { input: issueInput });
+    const newIssueUri = issueResult.createShTangledRepoIssue.uri;
+
+    // Create the bug.issue link
+    const linkInput = {
+      bug: bugUri,
+      issue: newIssueUri,
+      createdAt: new Date().toISOString()
+    };
+
+    await gqlMutation(CREATE_BUG_ISSUE_MUTATION, { input: linkInput });
+
+    // Close modal and refresh
+    closeLinkIssueModal();
+
+    // Refresh bugs to get updated linked issues
+    await loadBugs();
+
+    // Re-open the overlay to show the new linked issue
+    if (state.bugUri) {
+      renderOverlay();
+    }
+
+    showSuccess("Issue created and linked!");
+  } catch (err) {
+    console.error("Failed to create and link issue:", err);
+    showError(`Failed to create issue: ${err.message}`);
+    state.linkIssueState.isLoading = false;
+    renderLinkIssueModal();
+  }
+}
+```
+
+**Step 2: Verify create and link works**
+
+1. Refresh bugs.html
+2. Open a bug as namespace authority
+3. Click "Link Issue", select a repo
+4. Click "Create New Issue from Bug"
+5. Verify success message appears
+6. Check Tangled to verify issue was created
+
+**Step 3: Commit**
+
+```bash
+git add bugs.html
+git commit -m "feat(bugs): implement create and link tangled issue"
+```
+
+---
+
+### Task 8: Implement Link to Existing Issue
+
+**Files:**
+- Modify: `bugs.html` (linkToExistingIssue function)
+
+**Step 1: Implement linkToExistingIssue**
+
+Replace the placeholder:
+
+```javascript
+async function linkToExistingIssue(issueUri) {
+  const { bugUri } = state.linkIssueState;
+
+  if (!bugUri) return;
+
+  state.linkIssueState.isLoading = true;
+  renderLinkIssueModal();
+
+  try {
+    const linkInput = {
+      bug: bugUri,
+      issue: issueUri,
+      createdAt: new Date().toISOString()
+    };
+
+    await gqlMutation(CREATE_BUG_ISSUE_MUTATION, { input: linkInput });
+
+    closeLinkIssueModal();
+
+    // Refresh bugs to get updated linked issues
+    await loadBugs();
+
+    // Re-open the overlay to show the linked issue
+    if (state.bugUri) {
+      renderOverlay();
+    }
+
+    showSuccess("Issue linked!");
+  } catch (err) {
+    console.error("Failed to link issue:", err);
+    showError(`Failed to link issue: ${err.message}`);
+    state.linkIssueState.isLoading = false;
+    renderLinkIssueModal();
+  }
+}
+```
+
+**Step 2: Verify linking existing issue works**
+
+1. Refresh bugs.html
+2. Open a bug as namespace authority
+3. Click "Link Issue", select a repo with existing issues
+4. Click on an existing issue
+5. Verify success message appears
+
+**Step 3: Commit**
+
+```bash
+git add bugs.html
+git commit -m "feat(bugs): implement link to existing tangled issue"
+```
+
+---
+
+### Task 9: Display Linked Issues in Bug Detail
+
+**Files:**
+- Modify: `bugs.html` (renderOverlay function)
+
+**Step 1: Add helper function to build Tangled issue URL**
+
+Add this function:
+
+```javascript
+function getTangledIssueUrl(issue) {
+  if (!issue.issueResolved) return null;
+  const resolved = issue.issueResolved;
+  if (!resolved.repoResolved) return null;
+
+  const handle = resolved.repoResolved.actorHandle;
+  const repoName = resolved.repoResolved.name;
+  const rkey = resolved.uri.split('/').pop();
+
+  return `https://tangled.sh/${handle}/${repoName}/issues/${rkey}`;
+}
+```
+
+**Step 2: Add renderLinkedIssues function**
+
+```javascript
+function renderLinkedIssues(bug, canUnlink) {
+  const linkedIssues = bug.networkSlicesToolsBugIssueViaBug?.edges?.map(e => e.node) || [];
+
+  if (linkedIssues.length === 0) {
+    return "";
+  }
+
+  return `
+    <div class="overlay-section">
+      <h3>Linked Issues (${linkedIssues.length})</h3>
+      <div class="linked-issues-list">
+        ${linkedIssues.map(link => {
+          const issue = link.issueResolved;
+          const url = getTangledIssueUrl(link);
+          const title = issue?.title || "Unknown Issue";
+          const repoName = issue?.repoResolved?.name || "Unknown Repo";
+
+          return `
+            <div class="card" style="display: flex; justify-content: space-between; align-items: center; cursor: default;">
+              <div>
+                <div style="font-weight: 500;">${esc(title)}</div>
+                <div class="text-secondary" style="font-size: 0.75rem;">
+                  ${esc(repoName)}
+                  ${url ? ` · <a href="${esc(url)}" target="_blank" onclick="event.stopPropagation()">View on Tangled</a>` : ''}
+                </div>
+              </div>
+              ${canUnlink ? `<button class="btn-icon btn-danger-text" onclick="unlinkIssue('${esc(link.uri)}')" title="Unlink">×</button>` : ''}
+            </div>
+          `;
+        }).join("")}
+      </div>
+    </div>
+  `;
+}
+```
+
+**Step 3: Add renderLinkedIssues to overlay**
+
+In the `renderOverlay` function, add the linked issues section after the responses section. Find this line:
+
+```javascript
+${canAddResponse ? renderResponseForm() : ""}
+```
+
+And add before it:
+
+```javascript
+${renderLinkedIssues(bug, canAddResponse)}
+```
+
+**Step 4: Verify linked issues display**
+
+1. Refresh bugs.html
+2. Open a bug that has linked issues
+3. Verify "Linked Issues" section appears with issue cards
+4. Verify "View on Tangled" link works
+
+**Step 5: Commit**
+
+```bash
+git add bugs.html
+git commit -m "feat(bugs): display linked issues in bug detail"
+```
+
+---
+
+### Task 10: Implement Unlink Issue
+
+**Files:**
+- Modify: `bugs.html` (add unlinkIssue function)
+
+**Step 1: Implement unlinkIssue function**
+
+```javascript
+async function unlinkIssue(linkUri) {
+  if (!confirm("Unlink this issue?")) {
+    return;
+  }
+
+  try {
+    const rkey = getRkeyFromUri(linkUri);
+    await gqlMutation(DELETE_BUG_ISSUE_MUTATION, { rkey });
+
+    // Refresh bugs to update linked issues
+    await loadBugs();
+
+    // Re-render overlay
+    if (state.bugUri) {
+      renderOverlay();
+    }
+
+    showSuccess("Issue unlinked!");
+  } catch (err) {
+    console.error("Failed to unlink issue:", err);
+    showError(`Failed to unlink: ${err.message}`);
+  }
+}
+```
+
+**Step 2: Verify unlinking works**
+
+1. Refresh bugs.html
+2. Open a bug with linked issues as namespace authority
+3. Click the × button on a linked issue
+4. Confirm the prompt
+5. Verify success message and issue is removed from list
+
+**Step 3: Commit**
+
+```bash
+git add bugs.html
+git commit -m "feat(bugs): implement unlink issue functionality"
+```
+
+---
+
+### Task 11: Add CSS for Linked Issues
+
+**Files:**
+- Modify: `bugs.html` (add CSS in style section)
+
+**Step 1: Add CSS for linked issues list**
+
+Add these styles in the `<style>` section (around line 800, before the mobile responsive styles):
+
+```css
+/* Linked issues */
+.linked-issues-list {
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+  margin-top: 0.5rem;
+}
+
+.linked-issues-list .card {
+  padding: 0.75rem;
+  margin-bottom: 0;
+}
+
+.linked-issues-list .card:hover {
+  transform: none;
+  box-shadow: none;
+}
+
+.linked-issues-list a {
+  color: var(--accent);
+  text-decoration: none;
+}
+
+.linked-issues-list a:hover {
+  text-decoration: underline;
+}
+
+/* Repo and issue lists in modal */
+.repo-list,
+.issue-list {
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+}
+
+.repo-list .card,
+.issue-list .card {
+  margin-bottom: 0;
+}
+```
+
+**Step 2: Verify styling looks good**
+
+1. Refresh bugs.html
+2. Open link issue modal, verify repo/issue cards look good
+3. Open a bug with linked issues, verify they display nicely
+
+**Step 3: Commit**
+
+```bash
+git add bugs.html
+git commit -m "style(bugs): add css for linked issues and modal lists"
+```
+
+---
+
+### Task 12: Final Testing & Polish
+
+**Step 1: Test complete flow - create and link**
+
+1. Log in as namespace authority
+2. Open a bug
+3. Click "Link Issue"
+4. Select a repo
+5. Click "Create New Issue from Bug"
+6. Verify issue appears in Linked Issues section
+7. Click "View on Tangled" link, verify it opens correct issue
+
+**Step 2: Test complete flow - link existing**
+
+1. Open another bug
+2. Click "Link Issue"
+3. Select a repo with existing issues
+4. Click an existing issue
+5. Verify it appears in Linked Issues section
+
+**Step 3: Test unlink**
+
+1. Click × on a linked issue
+2. Confirm
+3. Verify it's removed
+
+**Step 4: Test permissions**
+
+1. Log out
+2. Open a bug - verify "Link Issue" button is NOT visible
+3. Log in as different user (not namespace authority)
+4. Verify "Link Issue" button is NOT visible
+
+**Step 5: Final commit**
+
+```bash
+git add bugs.html
+git commit -m "feat(bugs): complete bug-to-tangled-issue linking feature"
+```
+
+---
+
+## Summary
+
+This implementation adds:
+- "Link Issue" button in bug detail (namespace authority only)
+- Modal flow: select repo → create new issue or link existing
+- Auto-generated Tangled issues from bug title/description/steps
+- Linked issues display in bug detail with Tangled links
+- Unlink functionality
+
+All changes are in `bugs.html` - no new files needed.