@iloom/cli 0.3.4 → 0.4.0

package/dist/chunk-MLS5FAV7.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'\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  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  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  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  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\n  constructor() {\n    this.loomsDir = path.join(os.homedir(), '.config', 'iloom-ai', 'looms')\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 double 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   * 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        ...(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 {\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        parentLoom: data.parentLoom ?? null,\n      }\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({\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            parentLoom: data.parentLoom ?? null,\n          })\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"],"mappings":"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","names":[]}