test(ai): add integration tests for AIChatHistory backup and restore

47 tests covering session metadata storage, chat history file
round-trips, deletion, visual state restoration of all message
bubble types (user, assistant, tool, tool_edit, error, question,
edit_summary), and end-to-end save-load-render flows. Test data
is stored as JSON fixtures in ai-history-test-files/.

Author: abose

src/brackets.js

@@ -298,6 +298,7 @@ define(function (require, exports, module) {
             SidebarView: require("project/SidebarView"),
             WorkingSetView: require("project/WorkingSetView"),
             AISnapshotStore: require("core-ai/AISnapshotStore"),
+            AIChatHistory: require("core-ai/AIChatHistory"),
             doneLoading: false
         };
 

test/UnitTestSuite.js

@@ -63,6 +63,7 @@ define(function (require, exports, module) {
     require("spec/LanguageManager-test");
     require("spec/LanguageManager-integ-test");
     require("spec/ai-snapshot-test");
+    require("spec/ai-history-test");
     require("spec/LowLevelFileIO-test");
     require("spec/Metrics-test");
     require("spec/MultiRangeInlineEditor-test");

test/spec/ai-history-test-files/multi-tool-session.json

@@ -0,0 +1,26 @@
+{
+    "id": "multi-tool-sess",
+    "title": "Refactor the utils module",
+    "timestamp": 1700000000000,
+    "messages": [
+        { "type": "user", "text": "Refactor the utils module" },
+        { "type": "assistant", "markdown": "I'll analyze the code first.", "isFirst": true },
+        { "type": "tool", "toolName": "Glob", "summary": "Finding utils files", "icon": "fa-solid fa-magnifying-glass", "color": "#6b9eff", "elapsed": 0.2 },
+        { "type": "tool", "toolName": "Read", "summary": "Reading utils/index.js", "icon": "fa-solid fa-file-lines", "color": "#6bc76b", "elapsed": 0.4 },
+        { "type": "tool", "toolName": "Read", "summary": "Reading utils/helpers.js", "icon": "fa-solid fa-file-lines", "color": "#6bc76b", "elapsed": 0.3 },
+        { "type": "assistant", "markdown": "I see several opportunities for improvement." },
+        { "type": "tool", "toolName": "Edit", "summary": "Editing utils/index.js", "icon": "fa-solid fa-pen", "color": "#e8a838", "elapsed": 1.1 },
+        { "type": "tool_edit", "file": "/src/utils/index.js", "linesAdded": 15, "linesRemoved": 8 },
+        { "type": "tool", "toolName": "Edit", "summary": "Editing utils/helpers.js", "icon": "fa-solid fa-pen", "color": "#e8a838", "elapsed": 0.9 },
+        { "type": "tool_edit", "file": "/src/utils/helpers.js", "linesAdded": 7, "linesRemoved": 12 },
+        { "type": "assistant", "markdown": "Refactoring complete! I've:\n- Extracted shared logic\n- Removed duplicate code\n- Added proper types" },
+        {
+            "type": "edit_summary",
+            "files": [
+                { "file": "/src/utils/index.js", "added": 15, "removed": 8 },
+                { "file": "/src/utils/helpers.js", "added": 7, "removed": 12 }
+            ]
+        },
+        { "type": "complete" }
+    ]
+}

test/spec/ai-history-test-files/session-with-errors.json

@@ -0,0 +1,14 @@
+{
+    "id": "err-sess",
+    "title": "Run the tests",
+    "timestamp": 1700000000000,
+    "messages": [
+        { "type": "user", "text": "Run the tests" },
+        { "type": "assistant", "markdown": "I'll run the test suite.", "isFirst": true },
+        { "type": "tool", "toolName": "Bash", "summary": "Running npm test", "icon": "fa-solid fa-terminal", "color": "#c084fc", "elapsed": 5.2 },
+        { "type": "error", "text": "Process exited with code 1: Tests failed" },
+        { "type": "assistant", "markdown": "The tests failed. Let me investigate." },
+        { "type": "tool", "toolName": "Read", "summary": "Reading test output", "icon": "fa-solid fa-file-lines", "color": "#6bc76b", "elapsed": 0.3 },
+        { "type": "complete" }
+    ]
+}

test/spec/ai-history-test-files/session-with-images.json

@@ -0,0 +1,17 @@
+{
+    "id": "img-sess",
+    "title": "Check this screenshot",
+    "timestamp": 1700000000000,
+    "messages": [
+        {
+            "type": "user",
+            "text": "Check this screenshot",
+            "images": [
+                { "dataUrl": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUg==", "mediaType": "image/png" },
+                { "dataUrl": "data:image/jpeg;base64,/9j/4AAQSkZJRg==", "mediaType": "image/jpeg" }
+            ]
+        },
+        { "type": "assistant", "markdown": "I can see two images in your screenshot.", "isFirst": true },
+        { "type": "complete" }
+    ]
+}

test/spec/ai-history-test-files/session-with-other-answer.json

@@ -0,0 +1,24 @@
+{
+    "id": "other-ans-sess",
+    "title": "Configure the build",
+    "timestamp": 1700000000000,
+    "messages": [
+        { "type": "user", "text": "Configure the build" },
+        {
+            "type": "question",
+            "questions": [
+                {
+                    "question": "Which bundler?",
+                    "options": [
+                        { "label": "Webpack", "description": "Established bundler" },
+                        { "label": "Vite", "description": "Fast dev server" }
+                    ]
+                }
+            ],
+            "answers": {
+                "Which bundler?": "Rollup with custom plugins"
+            }
+        },
+        { "type": "complete" }
+    ]
+}

test/spec/ai-history-test-files/session-with-questions.json

@@ -0,0 +1,37 @@
+{
+    "id": "q-sess",
+    "title": "Set up authentication",
+    "timestamp": 1700000000000,
+    "messages": [
+        { "type": "user", "text": "Set up authentication" },
+        { "type": "assistant", "markdown": "I have a few questions before I start.", "isFirst": true },
+        {
+            "type": "question",
+            "questions": [
+                {
+                    "question": "Which auth method do you prefer?",
+                    "options": [
+                        { "label": "JWT", "description": "Stateless token-based auth" },
+                        { "label": "Session", "description": "Server-side session storage" },
+                        { "label": "OAuth", "description": "Third-party provider auth" }
+                    ]
+                },
+                {
+                    "question": "Which database?",
+                    "options": [
+                        { "label": "PostgreSQL", "description": "Relational database" },
+                        { "label": "MongoDB", "description": "Document database" }
+                    ]
+                }
+            ],
+            "answers": {
+                "Which auth method do you prefer?": "JWT",
+                "Which database?": "PostgreSQL"
+            }
+        },
+        { "type": "assistant", "markdown": "Great, I'll set up JWT auth with PostgreSQL." },
+        { "type": "tool", "toolName": "Write", "summary": "Writing auth/jwt.js", "icon": "fa-solid fa-file-pen", "color": "#e8a838", "elapsed": 0.8 },
+        { "type": "tool_edit", "file": "/src/auth/jwt.js", "linesAdded": 45, "linesRemoved": 0 },
+        { "type": "complete" }
+    ]
+}

test/spec/ai-history-test-files/simple-session.json

@@ -0,0 +1,10 @@
+{
+    "id": "simple-sess",
+    "title": "What is 2+2?",
+    "timestamp": 1700000000000,
+    "messages": [
+        { "type": "user", "text": "What is 2+2?" },
+        { "type": "assistant", "markdown": "The answer is **4**.", "isFirst": true },
+        { "type": "complete" }
+    ]
+}