chore: muted style for restored edit-card stats; FS API note

Adds a CSS rule for .ai-tool-edit-stats so the per-edit +x/-y
on restored cards reads with the same muted grey as the Show diff
toggle (the .ai-msg-edit-summary-scoped green/red colors don't apply
inside the tool indicator, leaving the default bright text otherwise).

CLAUDE.md gains a short note on which file API to reach for —
Phoenix.VFS.{read,write,unlink}Async for raw app data (no size
cap, recursive dir delete) versus FileSystem.getFileForPath only
for files that may be opened as editor documents.

Author: abose

CLAUDE.md

@@ -23,6 +23,15 @@
 - **Exception — Markdown viewer iframe** (`src-mdviewer/`): Has its own i18n system. Strings go in `src-mdviewer/src/locales/en.json` (root), not `src/nls/`. Other locale files in that folder are auto-translated by GitHub Actions. Use `t("key")` / `tp("key", { param })` from `src-mdviewer/src/core/i18n.js`.
 - Never compare `$(el).text()` against English strings for logic — use data attributes or CSS classes instead.
 
+## File I/O APIs — which to use
+
+Phoenix has two parallel file APIs. Pick the right one for the situation:
+
+- **`Phoenix.VFS.readFileAsync(path, encoding)` / `Phoenix.VFS.writeFileAsync(path, content, encoding)` / `Phoenix.VFS.unlinkAsync(path)`** — for raw app data (config files, session JSONs, caches, snapshots). No size cap. `unlinkAsync` removes non-empty directories recursively.
+- **`FileSystem.getFileForPath(path).read/.write/.unlink`** (and `getDirectoryForPath`) — *only* for files that may be opened as documents in the editor. Goes through the document layer (mtime tracking, dirty-buffer reconciliation). Has a 16 MB cap on reads/writes.
+
+If a file is purely app-internal data and never edited by the user as a document, use the VFS APIs. Mixing them on the same file leads to mtime confusion and surprise size limits.
+
 ## Phoenix MCP (Desktop App Testing)
 
 Use `exec_js` to run JS in the Phoenix browser runtime. jQuery `$()` is global. `brackets.test.*` exposes internal modules (DocumentManager, CommandManager, ProjectManager, FileSystem, EditorManager). Always `return` a value from `exec_js` to see results. Prefer reusing an already-running Phoenix instance (`get_phoenix_status`) over launching a new one.

src/styles/Extn-AIChatPanel.less

@@ -688,6 +688,17 @@
         }
     }
 
+    // Per-edit line stats shown next to the Show-diff toggle on
+    // restored cards. Match the toggle's muted look so the right edge
+    // reads as a single secondary-action cluster — without this the
+    // +x/-y use the panel's default bright text and clash.
+    .ai-tool-edit-stats {
+        font-size: @ai-text-meta;
+        color: @project-panel-text-2;
+        opacity: 0.65;
+        font-family: 'SourceCodePro-Medium', 'SourceCodePro', monospace;
+    }
+
     .ai-tool-diff-more {
         background: none;
         border: none;