feat: add Codex tidy support — remove stale environment_context titles

After fixing Codex title extraction (v0.6.8), old exported files still
have "environment_context-cwd..." in their filenames. Tidy now cleans
these up automatically.

Changes:
- exporter.ts: add tidyCodexHistory() — removes stale environment_context
  titled files when a correctly-titled file for the same shortId exists
- extension.ts: tidyHistory command now also calls tidyCodexHistory()
- extension.ts: Codex menu gets its own "Tidy .codex-history/" option

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: Myoontyee

package.json

@@ -2,7 +2,7 @@
   "name": "claude-code-exporter",
   "displayName": "Claude Code Exporter — Claude Code, Codex & Cursor Conversation History",
   "description": "Export AI coding agent conversations to Markdown. Supports Claude Code (→ .claude-code-history/), OpenAI Codex (→ .codex-history/), and Cursor Composer (→ .cursor-history/). Features: auto-watch, session inject/import for claude --resume, and repair of thinking-block signature errors when switching API providers.",
-  "version": "0.6.8",
+  "version": "0.6.9",
   "publisher": "myoontyee",
   "engines": {
     "vscode": "^1.85.0"

src/exporter.ts

@@ -476,6 +476,73 @@ export class MarkdownExporter {
 
     return { renamed, merged, errors, migrated };
   }
+
+  // ─── Tidy Codex History ───────────────────────────────────────────────────
+
+  /**
+   * Tidy up .codex-history/ folder:
+   * 1. Merge duplicates with same shortId (keep largest)
+   * 2. Remove stale files with bad title "environment_context-cwd..." if a
+   *    correctly-titled file for the same shortId already exists
+   *
+   * Returns { merged, errors } counts.
+   */
+  tidyCodexHistory(
+    codexHistoryDir: string
+  ): { merged: number; errors: number } {
+    if (!fs.existsSync(codexHistoryDir)) return { merged: 0, errors: 0 };
+
+    let merged = 0;
+    let errors = 0;
+
+    const files = fs.readdirSync(codexHistoryDir).filter((f) => f.endsWith('.md'));
+    const shortIdPattern = /_([a-f0-9]{8,})(?:_compact)?\.md$/;
+
+    // Group by shortId
+    const byShortId = new Map<string, string[]>();
+    for (const f of files) {
+      const m = f.match(shortIdPattern);
+      if (!m) continue;
+      const sid = m[1];
+      if (!byShortId.has(sid)) byShortId.set(sid, []);
+      byShortId.get(sid)!.push(f);
+    }
+
+    for (const [, group] of byShortId) {
+      if (group.length <= 1) continue;
+
+      // Prefer file WITHOUT environment_context in the name (correct title)
+      // Keep it; delete stale environment_context-titled ones
+      const correct = group.filter((f) => !f.includes('environment_context'));
+      const stale   = group.filter((f) =>  f.includes('environment_context'));
+
+      if (correct.length > 0 && stale.length > 0) {
+        // Have a correctly-titled file — delete all stale ones
+        for (const f of stale) {
+          try {
+            fs.unlinkSync(path.join(codexHistoryDir, f));
+            merged++;
+          } catch { errors++; }
+        }
+      } else {
+        // All are stale or all are correct — keep largest, delete rest
+        group.sort((a, b) => {
+          try {
+            return fs.statSync(path.join(codexHistoryDir, b)).size -
+                   fs.statSync(path.join(codexHistoryDir, a)).size;
+          } catch { return 0; }
+        });
+        for (let i = 1; i < group.length; i++) {
+          try {
+            fs.unlinkSync(path.join(codexHistoryDir, group[i]));
+            merged++;
+          } catch { errors++; }
+        }
+      }
+    }
+
+    return { merged, errors };
+  }
 }
 
 // ─── Helpers ──────────────────────────────────────────────────────────────────

src/extension.ts

@@ -200,12 +200,21 @@ export function activate(context: vscode.ExtensionContext): void {
         return;
       }
       const ccHistory = path.join(workspaceRoot, '.claude-code-history');
-      const result = exporter.tidyHistory(ccHistory, claudeProjectDir || undefined);
+      const codexHistory = path.join(workspaceRoot, '.codex-history');
+
+      const ccResult = exporter.tidyHistory(ccHistory, claudeProjectDir || undefined);
+      const codexResult = exporter.tidyCodexHistory(codexHistory);
+
+      const total = ccResult.merged + codexResult.merged;
+      const totalErrors = ccResult.errors + codexResult.errors;
+
       treeProvider.refresh();
       vscode.window.showInformationMessage(
-        `Tidy done: ${result.merged} duplicates merged, ${result.renamed} files renamed` +
-        (result.migrated > 0 ? `, ${result.migrated} file(s) migrated from .cc-history/` : '') +
-        (result.errors > 0 ? `, ${result.errors} errors` : '')
+        `Tidy done: ${total} duplicates merged` +
+        (ccResult.renamed > 0 ? `, ${ccResult.renamed} files renamed` : '') +
+        (ccResult.migrated > 0 ? `, ${ccResult.migrated} file(s) migrated from .cc-history/` : '') +
+        (codexResult.merged > 0 ? ` (incl. ${codexResult.merged} stale Codex titles removed)` : '') +
+        (totalErrors > 0 ? `, ${totalErrors} errors` : '')
       );
     }),
 
@@ -581,6 +590,11 @@ async function handleCodexMenu(
       label: '$(folder-opened)  Open .codex-history/ Folder',
       value: 'open',
     },
+    {
+      label: '$(tools)  Tidy .codex-history/',
+      description: 'Remove stale environment_context titles & merge duplicates',
+      value: 'tidy',
+    },
   ], { placeHolder: 'Codex CLI Sessions' });
 
   if (!choice) return;
@@ -590,6 +604,16 @@ async function handleCodexMenu(
     return;
   }
 
+  if (choice.value === 'tidy') {
+    const codexHistory = path.join(workspaceRoot, '.codex-history');
+    const result = exporter.tidyCodexHistory(codexHistory);
+    vscode.window.showInformationMessage(
+      `Codex Tidy done: ${result.merged} stale file(s) removed` +
+      (result.errors > 0 ? `, ${result.errors} errors` : '')
+    );
+    return;
+  }
+
   if (choice.value === 'format') {
     const fmt = await pickFormat();
     if (!fmt) return;