@iloom/cli 0.7.5 → 0.8.0

package/dist/chunk-KBEIQP4G.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/MetadataManager.ts"],"sourcesContent":["import path from 'path'\nimport os from 'os'\nimport fs from 'fs-extra'\nimport { getLogger } from '../utils/logger-context.js'\nimport type { ProjectCapability } from '../types/loom.js'\nimport type { OneShotMode } from '../types/index.js'\n\n/**\n * Schema for metadata JSON file\n * Stored in ~/.config/iloom-ai/looms/\n */\nexport interface MetadataFile {\n  description: string\n  created_at?: string\n  version: number\n  // Additional metadata fields (v2)\n  branchName?: string\n  worktreePath?: string\n  issueType?: 'branch' | 'issue' | 'pr'\n  issue_numbers?: string[]\n  pr_numbers?: string[]\n  issueTracker?: string\n  colorHex?: string // Stored hex color (e.g., \"#dcebff\") - robust against palette changes\n  sessionId?: string // Claude Code session ID for resume support\n  projectPath?: string // Main worktree path (project root) - enables project identification\n  issueUrls?: Record<string, string> // Map of issue ID to URL in the issue tracker\n  prUrls?: Record<string, string> // Map of PR number to URL in the issue tracker\n  draftPrNumber?: number // Draft PR number if github-draft-pr mode was used\n  oneShot?: OneShotMode // One-shot automation mode stored during loom creation\n  capabilities?: ProjectCapability[] // Detected project capabilities\n  parentLoom?: {\n    type: 'issue' | 'pr' | 'branch'\n    identifier: string | number\n    branchName: string\n    worktreePath: string\n    databaseBranch?: string\n  }\n}\n\n/**\n * Input for writing metadata (all fields except version and created_at)\n * Note: issueTracker is required because every loom should have an associated\n * issue tracker provider (defaults to 'github' via IssueTrackerFactory)\n */\nexport interface WriteMetadataInput {\n  description: string\n  branchName: string\n  worktreePath: string\n  issueType: 'branch' | 'issue' | 'pr'\n  issue_numbers: string[]\n  pr_numbers: string[]\n  issueTracker: string\n  colorHex: string // Hex color (e.g., \"#dcebff\") - robust against palette changes\n  sessionId: string // Claude Code session ID for resume support (required for new looms)\n  projectPath: string // Main worktree path (project root) - required for new looms\n  issueUrls: Record<string, string> // Map of issue ID to URL in the issue tracker\n  prUrls: Record<string, string> // Map of PR number to URL in the issue tracker\n  draftPrNumber?: number // Draft PR number for github-draft-pr mode\n  oneShot?: OneShotMode // One-shot automation mode to persist\n  capabilities: ProjectCapability[] // Detected project capabilities (required for new looms)\n  parentLoom?: {\n    type: 'issue' | 'pr' | 'branch'\n    identifier: string | number\n    branchName: string\n    worktreePath: string\n    databaseBranch?: string\n  }\n}\n\n/**\n * Result of reading metadata for a worktree\n */\nexport interface LoomMetadata {\n  status?: 'active' | 'finished'\n  finishedAt?: string | null\n  description: string\n  created_at: string | null\n  branchName: string | null\n  worktreePath: string | null\n  issueType: 'branch' | 'issue' | 'pr' | null\n  issue_numbers: string[]\n  pr_numbers: string[]\n  issueTracker: string | null\n  colorHex: string | null // Hex color (e.g., \"#dcebff\") - robust against palette changes\n  sessionId: string | null // Claude Code session ID (null for legacy looms)\n  projectPath: string | null // Main worktree path (null for legacy looms)\n  issueUrls: Record<string, string> // Map of issue ID to URL ({} for legacy looms)\n  prUrls: Record<string, string> // Map of PR number to URL ({} for legacy looms)\n  draftPrNumber: number | null // Draft PR number (null if not draft mode)\n  oneShot: OneShotMode | null // One-shot mode (null for legacy looms)\n  capabilities: ProjectCapability[] // Detected project capabilities (empty for legacy looms)\n  parentLoom: {\n    type: 'issue' | 'pr' | 'branch'\n    identifier: string | number\n    branchName: string\n    worktreePath: string\n    databaseBranch?: string\n  } | null\n}\n\n/**\n * MetadataManager: Manage loom metadata persistence\n *\n * Stores loom metadata in ~/.config/iloom-ai/looms/ directory.\n * Each worktree gets a JSON file named by slugifying its absolute path.\n *\n * Per spec section 2.2:\n * - Filename derived from worktree absolute path\n * - Path separators replaced with double underscores\n * - Non-alphanumeric chars (except _ and -) replaced with hyphens\n */\nexport class MetadataManager {\n  private readonly loomsDir: string\n  private readonly finishedDir: string\n\n  constructor() {\n    this.loomsDir = path.join(os.homedir(), '.config', 'iloom-ai', 'looms')\n    this.finishedDir = path.join(this.loomsDir, 'finished')\n  }\n\n  /**\n   * Convert MetadataFile to LoomMetadata with default values for optional fields\n   */\n  private toMetadata(data: MetadataFile): LoomMetadata {\n    return {\n      description: data.description,\n      created_at: data.created_at ?? null,\n      branchName: data.branchName ?? null,\n      worktreePath: data.worktreePath ?? null,\n      issueType: data.issueType ?? null,\n      issue_numbers: data.issue_numbers ?? [],\n      pr_numbers: data.pr_numbers ?? [],\n      issueTracker: data.issueTracker ?? null,\n      colorHex: data.colorHex ?? null,\n      sessionId: data.sessionId ?? null,\n      projectPath: data.projectPath ?? null,\n      issueUrls: data.issueUrls ?? {},\n      prUrls: data.prUrls ?? {},\n      draftPrNumber: data.draftPrNumber ?? null,\n      oneShot: data.oneShot ?? null,\n      capabilities: data.capabilities ?? [],\n      parentLoom: data.parentLoom ?? null,\n    }\n  }\n\n  /**\n   * Convert worktree path to filename slug per spec section 2.2\n   *\n   * Algorithm:\n   * 1. Trim trailing slashes\n   * 2. Replace all path separators (/ or \\) with __ (double underscore)\n   * 3. Replace any other non-alphanumeric characters (except _ and -) with -\n   * 4. Append .json\n   *\n   * Example:\n   * - Worktree: /Users/jane/dev/repo\n   * - Filename: _Users__jane__dev__repo.json\n   */\n  slugifyPath(worktreePath: string): string {\n    // 1. Trim trailing slashes\n    let slug = worktreePath.replace(/[/\\\\]+$/, '')\n\n    // 2. Replace path separators with triple underscores\n    slug = slug.replace(/[/\\\\]/g, '___')\n\n    // 3. Replace non-alphanumeric chars (except _ and -) with hyphens\n    slug = slug.replace(/[^a-zA-Z0-9_-]/g, '-')\n\n    // 4. Append .json\n    return `${slug}.json`\n  }\n\n  /**\n   * Get the full path to the metadata file for a worktree\n   */\n  private getFilePath(worktreePath: string): string {\n    const filename = this.slugifyPath(worktreePath)\n    return path.join(this.loomsDir, filename)\n  }\n\n  /**\n   * Get the full path to the metadata file for a worktree (public API)\n   * Used by other services that need to reference the metadata file location\n   * (e.g., MCP servers that need to read loom context)\n   */\n  getMetadataFilePath(worktreePath: string): string {\n    return this.getFilePath(worktreePath)\n  }\n\n  /**\n   * Write metadata for a worktree (spec section 3.1)\n   *\n   * @param worktreePath - Absolute path to the worktree (used for file naming)\n   * @param input - Metadata to write (description plus additional fields)\n   */\n  async writeMetadata(worktreePath: string, input: WriteMetadataInput): Promise<void> {\n    try {\n      // 1. Ensure looms directory exists\n      await fs.ensureDir(this.loomsDir, { mode: 0o755 })\n\n      // 2. Create JSON content\n      const content: MetadataFile = {\n        description: input.description,\n        created_at: new Date().toISOString(),\n        version: 1,\n        branchName: input.branchName,\n        worktreePath: input.worktreePath,\n        issueType: input.issueType,\n        issue_numbers: input.issue_numbers,\n        pr_numbers: input.pr_numbers,\n        issueTracker: input.issueTracker,\n        colorHex: input.colorHex,\n        sessionId: input.sessionId,\n        projectPath: input.projectPath,\n        issueUrls: input.issueUrls,\n        prUrls: input.prUrls,\n        capabilities: input.capabilities,\n        ...(input.draftPrNumber && { draftPrNumber: input.draftPrNumber }),\n        ...(input.oneShot && { oneShot: input.oneShot }),\n        ...(input.parentLoom && { parentLoom: input.parentLoom }),\n      }\n\n      // 3. Write to slugified filename\n      const filePath = this.getFilePath(worktreePath)\n      await fs.writeFile(filePath, JSON.stringify(content, null, 2), { mode: 0o644 })\n\n      getLogger().debug(`Metadata written for worktree: ${worktreePath}`)\n    } catch (error) {\n      // Log warning but don't throw - metadata is supplementary\n      getLogger().warn(\n        `Failed to write metadata for worktree: ${error instanceof Error ? error.message : String(error)}`\n      )\n    }\n  }\n\n  /**\n   * Read metadata for a worktree (spec section 3.2)\n   *\n   * @param worktreePath - Absolute path to the worktree\n   * @returns The metadata object with all fields, or null if not found/invalid\n   */\n  async readMetadata(worktreePath: string): Promise<LoomMetadata | null> {\n    try {\n      const filePath = this.getFilePath(worktreePath)\n\n      // Check if file exists\n      if (!(await fs.pathExists(filePath))) {\n        return null\n      }\n\n      // Read and parse JSON\n      const content = await fs.readFile(filePath, 'utf8')\n      const data: MetadataFile = JSON.parse(content)\n\n      if (!data.description) {\n        return null\n      }\n\n      return this.toMetadata(data)\n    } catch (error) {\n      // Return null on any error (graceful degradation per spec)\n      getLogger().debug(\n        `Could not read metadata for worktree ${worktreePath}: ${error instanceof Error ? error.message : String(error)}`\n      )\n      return null\n    }\n  }\n\n  /**\n   * List all stored loom metadata files\n   *\n   * Returns an array of LoomMetadata objects for all valid metadata files\n   * in the looms directory. Invalid or unreadable files are skipped.\n   *\n   * @returns Array of LoomMetadata objects from all stored files\n   */\n  async listAllMetadata(): Promise<LoomMetadata[]> {\n    const results: LoomMetadata[] = []\n\n    try {\n      // Check if looms directory exists\n      if (!(await fs.pathExists(this.loomsDir))) {\n        return results\n      }\n\n      // Read all files in looms directory\n      const files = await fs.readdir(this.loomsDir)\n\n      // Filter to only .json files and read each\n      for (const file of files) {\n        if (!file.endsWith('.json')) {\n          continue\n        }\n\n        try {\n          const filePath = path.join(this.loomsDir, file)\n          const content = await fs.readFile(filePath, 'utf8')\n          const data: MetadataFile = JSON.parse(content)\n\n          // Skip files without required description field\n          if (!data.description) {\n            continue\n          }\n\n          results.push(this.toMetadata(data))\n        } catch (error) {\n          // Skip individual files that fail to parse (graceful degradation)\n          getLogger().debug(\n            `Skipping metadata file ${file}: ${error instanceof Error ? error.message : String(error)}`\n          )\n        }\n      }\n    } catch (error) {\n      // Log error but return empty array (graceful degradation)\n      getLogger().debug(\n        `Could not list metadata files: ${error instanceof Error ? error.message : String(error)}`\n      )\n    }\n\n    return results\n  }\n\n  /**\n   * Delete metadata for a worktree (spec section 3.3)\n   *\n   * Idempotent: silently succeeds if file doesn't exist\n   * Non-fatal: logs warning on permission errors but doesn't throw\n   *\n   * @param worktreePath - Absolute path to the worktree\n   */\n  async deleteMetadata(worktreePath: string): Promise<void> {\n    try {\n      const filePath = this.getFilePath(worktreePath)\n\n      // Check if file exists - silently return if not\n      if (!(await fs.pathExists(filePath))) {\n        getLogger().debug(`No metadata file to delete for worktree: ${worktreePath}`)\n        return\n      }\n\n      // Delete the file\n      await fs.unlink(filePath)\n      getLogger().debug(`Metadata deleted for worktree: ${worktreePath}`)\n    } catch (error) {\n      // Log warning on permission error but don't throw (per spec section 3.3)\n      getLogger().warn(\n        `Failed to delete metadata for worktree: ${error instanceof Error ? error.message : String(error)}`\n      )\n    }\n  }\n\n  /**\n   * Archive metadata for a finished worktree\n   *\n   * Moves the metadata file to the finished/ subdirectory and adds\n   * status: 'finished' and finishedAt timestamp fields.\n   *\n   * Idempotent: silently succeeds if source file doesn't exist\n   * Non-fatal: logs warning on errors but doesn't throw\n   *\n   * @param worktreePath - Absolute path to the worktree\n   */\n  async archiveMetadata(worktreePath: string): Promise<void> {\n    try {\n      const filename = this.slugifyPath(worktreePath)\n      const sourcePath = path.join(this.loomsDir, filename)\n\n      // Check if source file exists - silently return if not (idempotent)\n      if (!(await fs.pathExists(sourcePath))) {\n        getLogger().debug(`No metadata file to archive for worktree: ${worktreePath}`)\n        return\n      }\n\n      // Read existing metadata\n      const content = await fs.readFile(sourcePath, 'utf8')\n      const data: MetadataFile = JSON.parse(content)\n\n      // Add finished status and timestamp\n      const finishedData = {\n        ...data,\n        status: 'finished' as const,\n        finishedAt: new Date().toISOString(),\n      }\n\n      // Ensure finished directory exists\n      await fs.ensureDir(this.finishedDir, { mode: 0o755 })\n\n      // Write to finished subdirectory\n      const destPath = path.join(this.finishedDir, filename)\n      await fs.writeFile(destPath, JSON.stringify(finishedData, null, 2), { mode: 0o644 })\n\n      // Delete original file\n      await fs.unlink(sourcePath)\n\n      getLogger().debug(`Metadata archived for worktree: ${worktreePath}`)\n    } catch (error) {\n      // Log warning but don't throw - archiving is supplementary\n      getLogger().warn(\n        `Failed to archive metadata for worktree: ${error instanceof Error ? error.message : String(error)}`\n      )\n    }\n  }\n\n  /**\n   * List all finished loom metadata files\n   *\n   * Returns an array of LoomMetadata objects for all finished looms\n   * in the finished/ subdirectory, sorted by finishedAt in descending order\n   * (most recently finished first).\n   *\n   * @returns Array of LoomMetadata objects from finished files, sorted by finishedAt desc\n   */\n  async listFinishedMetadata(): Promise<LoomMetadata[]> {\n    const results: LoomMetadata[] = []\n\n    try {\n      // Check if finished directory exists\n      if (!(await fs.pathExists(this.finishedDir))) {\n        return results\n      }\n\n      // Read all files in finished directory\n      const files = await fs.readdir(this.finishedDir)\n\n      // Filter to only .json files and read each\n      for (const file of files) {\n        if (!file.endsWith('.json')) {\n          continue\n        }\n\n        try {\n          const filePath = path.join(this.finishedDir, file)\n          const content = await fs.readFile(filePath, 'utf8')\n          const data = JSON.parse(content) as MetadataFile & { status?: string; finishedAt?: string }\n\n          // Skip files without required description field\n          if (!data.description) {\n            continue\n          }\n\n          const metadata = this.toMetadata(data)\n          // Add finished-specific fields\n          metadata.status = (data.status as 'active' | 'finished') ?? 'finished'\n          metadata.finishedAt = data.finishedAt ?? null\n\n          results.push(metadata)\n        } catch (error) {\n          // Skip individual files that fail to parse (graceful degradation)\n          getLogger().warn(\n            `Skipping finished metadata file ${file}: ${error instanceof Error ? error.message : String(error)}`\n          )\n        }\n      }\n\n      // Sort by finishedAt descending (most recently finished first)\n      results.sort((a, b) => {\n        const aTime = a.finishedAt ? new Date(a.finishedAt).getTime() : 0\n        const bTime = b.finishedAt ? new Date(b.finishedAt).getTime() : 0\n        return bTime - aTime\n      })\n    } catch (error) {\n      // Log error but return empty array (graceful degradation)\n      getLogger().warn(\n        `Could not list finished metadata files: ${error instanceof Error ? error.message : String(error)}`\n      )\n    }\n\n    return results\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-LZBSLO6S.js → chunk-L4CN7YQT.js}

@@ -3,20 +3,271 @@ import {
   createLinearChildIssue,
   createLinearComment,
   createLinearIssue,
+  createLinearIssueRelation,
+  deleteLinearIssueRelation,
   fetchLinearIssue,
   fetchLinearIssueComments,
+  findLinearIssueRelation,
+  getLinearChildIssues,
   getLinearComment,
+  getLinearIssueDependencies,
   updateLinearComment
-} from "./chunk-HBJITKSZ.js";
+} from "./chunk-LFVRG6UU.js";
 import {
   addSubIssue,
   createIssue,
   createIssueComment,
+  createIssueDependency,
   createPRComment,
   executeGhCommand,
+  getIssueDatabaseId,
+  getIssueDependencies,
   getIssueNodeId,
+  getSubIssues,
+  removeIssueDependency,
   updateIssueComment
-} from "./chunk-GCPAZSGV.js";
+} from "./chunk-THS5L54H.js";
+import {
+  logger
+} from "./chunk-VT4PDUYT.js";
+
+// src/utils/image-processor.ts
+import { tmpdir } from "os";
+import { join, extname } from "path";
+import { existsSync, mkdirSync, createWriteStream, unlinkSync } from "fs";
+import { pipeline } from "stream/promises";
+import { Readable } from "stream";
+import { createHash } from "crypto";
+import { execa } from "execa";
+var SUPPORTED_EXTENSIONS = [".png", ".jpg", ".jpeg", ".gif", ".webp", ".svg"];
+var MAX_IMAGE_SIZE = 10 * 1024 * 1024;
+var REQUEST_TIMEOUT_MS = 3e4;
+var CACHE_DIR = join(tmpdir(), "iloom-images");
+var cachedGitHubToken;
+function extractMarkdownImageUrls(content) {
+  if (!content) {
+    return [];
+  }
+  const matches = [];
+  const markdownRegex = /!\[([^\]]*)\]\(((?:[^()\s]|\((?:[^()\s]|\([^()]*\))*\))+)\)/g;
+  let match;
+  while ((match = markdownRegex.exec(content)) !== null) {
+    const url = match[2];
+    if (url) {
+      matches.push({
+        fullMatch: match[0],
+        url,
+        isMarkdown: true
+      });
+    }
+  }
+  const htmlImgRegex = /<img\s+[^>]*src=["']([^"']+)["'][^>]*\/?>/gi;
+  while ((match = htmlImgRegex.exec(content)) !== null) {
+    const url = match[1];
+    if (url) {
+      matches.push({
+        fullMatch: match[0],
+        url,
+        isMarkdown: false
+      });
+    }
+  }
+  return matches;
+}
+function isAuthenticatedImageUrl(url) {
+  try {
+    const parsedUrl = new URL(url);
+    const hostname = parsedUrl.hostname.toLowerCase();
+    if (hostname === "uploads.linear.app") {
+      return true;
+    }
+    if (hostname === "private-user-images.githubusercontent.com") {
+      return true;
+    }
+    if (hostname === "github.com" && parsedUrl.pathname.startsWith("/user-attachments/assets/")) {
+      return true;
+    }
+    return false;
+  } catch {
+    return false;
+  }
+}
+function getExtensionFromUrl(url) {
+  try {
+    const parsedUrl = new URL(url);
+    const pathname = parsedUrl.pathname;
+    const ext = extname(pathname).toLowerCase();
+    if (SUPPORTED_EXTENSIONS.includes(ext)) {
+      return ext;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+function getCacheKey(url) {
+  const parsedUrl = new URL(url);
+  if (parsedUrl.hostname === "private-user-images.githubusercontent.com") {
+    parsedUrl.searchParams.delete("jwt");
+  }
+  const stableUrl = parsedUrl.toString();
+  const hash = createHash("sha256").update(stableUrl).digest("hex").slice(0, 16);
+  const ext = getExtensionFromUrl(url) ?? ".png";
+  return `${hash}${ext}`;
+}
+function getCachedImagePath(url) {
+  const cacheKey = getCacheKey(url);
+  const cachedPath = join(CACHE_DIR, cacheKey);
+  if (existsSync(cachedPath)) {
+    return cachedPath;
+  }
+  return void 0;
+}
+async function getAuthToken(provider) {
+  if (provider === "github") {
+    if (cachedGitHubToken !== void 0) {
+      return cachedGitHubToken;
+    }
+    try {
+      const result = await execa("gh", ["auth", "token"]);
+      cachedGitHubToken = result.stdout.trim();
+      return cachedGitHubToken;
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      logger.warn(`Failed to get GitHub auth token via gh CLI: ${message}`);
+      return void 0;
+    }
+  }
+  if (provider === "linear") {
+    return process.env.LINEAR_API_TOKEN;
+  }
+  return void 0;
+}
+async function downloadAndSaveImage(url, destPath, authHeader) {
+  const headers = {};
+  if (authHeader) {
+    headers["Authorization"] = authHeader;
+  }
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+  try {
+    const response = await fetch(url, { headers, signal: controller.signal });
+    if (!response.ok) {
+      throw new Error(`Failed to download image: ${response.status} ${response.statusText}`);
+    }
+    const contentLength = response.headers.get("Content-Length");
+    if (contentLength && parseInt(contentLength, 10) > MAX_IMAGE_SIZE) {
+      throw new Error(`Image too large: ${contentLength} bytes exceeds ${MAX_IMAGE_SIZE} byte limit`);
+    }
+    if (!response.body) {
+      throw new Error("Response body is null");
+    }
+    const reader = response.body.getReader();
+    let bytesWritten = 0;
+    const nodeReadable = new Readable({
+      async read() {
+        try {
+          const { done, value } = await reader.read();
+          if (done) {
+            this.push(null);
+            return;
+          }
+          bytesWritten += value.byteLength;
+          if (bytesWritten > MAX_IMAGE_SIZE) {
+            reader.cancel();
+            this.destroy(new Error(`Image too large: ${bytesWritten} bytes exceeds ${MAX_IMAGE_SIZE} byte limit`));
+            return;
+          }
+          this.push(Buffer.from(value));
+        } catch (err) {
+          this.destroy(err instanceof Error ? err : new Error(String(err)));
+        }
+      }
+    });
+    if (!existsSync(CACHE_DIR)) {
+      mkdirSync(CACHE_DIR, { recursive: true });
+    }
+    const writeStream = createWriteStream(destPath);
+    try {
+      await pipeline(nodeReadable, writeStream);
+    } catch (pipelineError) {
+      try {
+        if (existsSync(destPath)) {
+          unlinkSync(destPath);
+        }
+      } catch {
+      }
+      throw pipelineError;
+    }
+  } catch (error) {
+    if (error instanceof Error && error.name === "AbortError") {
+      throw new Error(`Image download timed out after ${REQUEST_TIMEOUT_MS}ms`);
+    }
+    throw error;
+  } finally {
+    clearTimeout(timeoutId);
+  }
+}
+function getCacheDestPath(url) {
+  if (!existsSync(CACHE_DIR)) {
+    mkdirSync(CACHE_DIR, { recursive: true });
+  }
+  const cacheKey = getCacheKey(url);
+  return join(CACHE_DIR, cacheKey);
+}
+function rewriteMarkdownUrls(content, urlMap) {
+  let result = content;
+  for (const [originalUrl, localPath] of urlMap) {
+    const escapedUrl = originalUrl.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const urlRegex = new RegExp(escapedUrl, "g");
+    result = result.replace(urlRegex, localPath);
+  }
+  return result;
+}
+async function processMarkdownImages(content, provider) {
+  if (!content) {
+    return "";
+  }
+  const images = extractMarkdownImageUrls(content);
+  if (images.length === 0) {
+    return content;
+  }
+  const authImages = images.filter((img) => isAuthenticatedImageUrl(img.url));
+  if (authImages.length === 0) {
+    return content;
+  }
+  const authToken = await getAuthToken(provider);
+  const uniqueUrls = [...new Set(authImages.map((img) => img.url))];
+  const urlMap = /* @__PURE__ */ new Map();
+  const downloadPromises = uniqueUrls.map(async (url) => {
+    try {
+      const cachedPath = getCachedImagePath(url);
+      if (cachedPath) {
+        logger.debug(`Using cached image: ${cachedPath}`);
+        return { url, localPath: cachedPath };
+      }
+      logger.debug(`Downloading image: ${url}`);
+      const destPath = getCacheDestPath(url);
+      await downloadAndSaveImage(
+        url,
+        destPath,
+        authToken ? `Bearer ${authToken}` : void 0
+      );
+      return { url, localPath: destPath };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      logger.warn(`Failed to download image ${url}: ${message}`);
+      return null;
+    }
+  });
+  const results = await Promise.all(downloadPromises);
+  for (const result of results) {
+    if (result !== null) {
+      urlMap.set(result.url, result.localPath);
+    }
+  }
+  return rewriteMarkdownUrls(content, urlMap);
+}
 
 // src/mcp/GitHubIssueManagementProvider.ts
 function normalizeAuthor(author) {
@@ -96,6 +347,12 @@ var GitHubIssueManagementProvider = class {
         ...comment.updatedAt && { updatedAt: comment.updatedAt }
       }));
     }
+    result.body = await processMarkdownImages(result.body, "github");
+    if (result.comments) {
+      for (const comment of result.comments) {
+        comment.body = await processMarkdownImages(comment.body, "github");
+      }
+    }
     return result;
   }
   /**
@@ -164,6 +421,12 @@ var GitHubIssueManagementProvider = class {
         ...comment.updatedAt && { updatedAt: comment.updatedAt }
       }));
     }
+    result.body = await processMarkdownImages(result.body, "github");
+    if (result.comments) {
+      for (const comment of result.comments) {
+        comment.body = await processMarkdownImages(comment.body, "github");
+      }
+    }
     return result;
   }
   /**
@@ -183,9 +446,10 @@ var GitHubIssueManagementProvider = class {
       "--jq",
       "{id: .id, body: .body, user: .user, created_at: .created_at, updated_at: .updated_at, html_url: .html_url, reactions: .reactions}"
     ]);
+    const processedBody = await processMarkdownImages(raw.body, "github");
     return {
       id: String(raw.id),
-      body: raw.body,
+      body: processedBody,
       author: normalizeAuthor(raw.user),
       created_at: raw.created_at,
       ...raw.updated_at && { updated_at: raw.updated_at },
@@ -258,11 +522,77 @@ var GitHubIssueManagementProvider = class {
       number: childNumber
     };
   }
+  /**
+   * Create a blocking dependency between two issues (A blocks B)
+   * Uses GitHub's sub-issues API: blocking issue becomes parent, blocked issue becomes sub-issue
+   */
+  async createDependency(input) {
+    const { blockingIssue, blockedIssue, repo } = input;
+    const blockingNumber = parseInt(blockingIssue, 10);
+    if (isNaN(blockingNumber)) {
+      throw new Error(`Invalid GitHub issue number: ${blockingIssue}. GitHub issue IDs must be numeric.`);
+    }
+    const blockedNumber = parseInt(blockedIssue, 10);
+    if (isNaN(blockedNumber)) {
+      throw new Error(`Invalid GitHub issue number: ${blockedIssue}. GitHub issue IDs must be numeric.`);
+    }
+    const blockingDatabaseId = await getIssueDatabaseId(blockingNumber, repo);
+    await createIssueDependency(blockedNumber, blockingDatabaseId, repo);
+  }
+  /**
+   * Get dependencies for an issue
+   */
+  async getDependencies(input) {
+    const { number, direction, repo } = input;
+    const issueNumber = parseInt(number, 10);
+    if (isNaN(issueNumber)) {
+      throw new Error(`Invalid GitHub issue number: ${number}. GitHub issue IDs must be numeric.`);
+    }
+    const result = {
+      blocking: [],
+      blockedBy: []
+    };
+    if (direction === "blocking" || direction === "both") {
+      result.blocking = await getIssueDependencies(issueNumber, "blocking", repo);
+    }
+    if (direction === "blocked_by" || direction === "both") {
+      result.blockedBy = await getIssueDependencies(issueNumber, "blocked_by", repo);
+    }
+    return result;
+  }
+  /**
+   * Remove a blocking dependency between two issues (A blocks B)
+   * Uses GitHub's sub-issues API: blocking issue is parent, blocked issue is sub-issue
+   */
+  async removeDependency(input) {
+    const { blockingIssue, blockedIssue, repo } = input;
+    const blockingNumber = parseInt(blockingIssue, 10);
+    if (isNaN(blockingNumber)) {
+      throw new Error(`Invalid GitHub issue number: ${blockingIssue}. GitHub issue IDs must be numeric.`);
+    }
+    const blockedNumber = parseInt(blockedIssue, 10);
+    if (isNaN(blockedNumber)) {
+      throw new Error(`Invalid GitHub issue number: ${blockedIssue}. GitHub issue IDs must be numeric.`);
+    }
+    const blockingDatabaseId = await getIssueDatabaseId(blockingNumber, repo);
+    await removeIssueDependency(blockedNumber, blockingDatabaseId, repo);
+  }
+  /**
+   * Get child issues (sub-issues) of a parent issue
+   */
+  async getChildIssues(input) {
+    const { number, repo } = input;
+    const issueNumber = parseInt(number, 10);
+    if (isNaN(issueNumber)) {
+      throw new Error(`Invalid GitHub issue number: ${number}. GitHub issue IDs must be numeric.`);
+    }
+    return await getSubIssues(issueNumber, repo);
+  }
 };
 
 // src/utils/linear-markup-converter.ts
 import { appendFileSync } from "fs";
-import { join, dirname, basename, extname } from "path";
+import { join as join2, dirname, basename, extname as extname2 } from "path";
 var LinearMarkupConverter = class {
   /**
    * Convert HTML details/summary blocks to Linear's collapsible format
@@ -398,7 +728,7 @@ ${content}
    */
   static getTimestampedLogPath(logFilePath) {
     const dir = dirname(logFilePath);
-    const ext = extname(logFilePath);
+    const ext = extname2(logFilePath);
     const base = basename(logFilePath, ext);
     const now = /* @__PURE__ */ new Date();
     const timestamp = [
@@ -410,7 +740,7 @@ ${content}
       String(now.getMinutes()).padStart(2, "0"),
       String(now.getSeconds()).padStart(2, "0")
     ].join("");
-    return join(dir, `${base}-${timestamp}${ext}`);
+    return join2(dir, `${base}-${timestamp}${ext}`);
   }
 };
 
@@ -459,6 +789,12 @@ var LinearIssueManagementProvider = class {
       } catch {
       }
     }
+    result.body = await processMarkdownImages(result.body, "linear");
+    if (result.comments) {
+      for (const comment of result.comments) {
+        comment.body = await processMarkdownImages(comment.body, "linear");
+      }
+    }
     return result;
   }
   /**
@@ -492,9 +828,10 @@ var LinearIssueManagementProvider = class {
   async getComment(input) {
     const { commentId } = input;
     const raw = await getLinearComment(commentId);
+    const processedBody = await processMarkdownImages(raw.body, "linear");
     return {
       id: raw.id,
-      body: raw.body,
+      body: processedBody,
       author: null,
       // Linear SDK doesn't return comment author info in basic fetch
       created_at: raw.createdAt
@@ -567,6 +904,42 @@ var LinearIssueManagementProvider = class {
       url: result.url
     };
   }
+  /**
+   * Create a blocking dependency between two issues
+   */
+  async createDependency(input) {
+    const { blockingIssue, blockedIssue } = input;
+    const [blockingIssueData, blockedIssueData] = await Promise.all([
+      fetchLinearIssue(blockingIssue),
+      fetchLinearIssue(blockedIssue)
+    ]);
+    await createLinearIssueRelation(blockingIssueData.id, blockedIssueData.id);
+  }
+  /**
+   * Get dependencies for an issue
+   */
+  async getDependencies(input) {
+    const { number, direction } = input;
+    return await getLinearIssueDependencies(number, direction);
+  }
+  /**
+   * Remove a blocking dependency between two issues
+   */
+  async removeDependency(input) {
+    const { blockingIssue, blockedIssue } = input;
+    const relationId = await findLinearIssueRelation(blockingIssue, blockedIssue);
+    if (!relationId) {
+      throw new Error(`No blocking dependency found from ${blockingIssue} to ${blockedIssue}`);
+    }
+    await deleteLinearIssueRelation(relationId);
+  }
+  /**
+   * Get child issues of a parent issue
+   */
+  async getChildIssues(input) {
+    const { number } = input;
+    return await getLinearChildIssues(number);
+  }
 };
 
 // src/mcp/IssueManagementProviderFactory.ts
@@ -589,4 +962,4 @@ var IssueManagementProviderFactory = class {
 export {
   IssueManagementProviderFactory
 };
-//# sourceMappingURL=chunk-LZBSLO6S.js.map
+//# sourceMappingURL=chunk-L4CN7YQT.js.map