feat: add web ui activity history

Alexxigang · Alexxigang · commit a6d5046d05f6 · 2026-03-15T17:44:55.000+08:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.26.0 - 2026-03-15
+
+- added in-session workflow history and recent download tracking to the local web UI
+- improved the web UI so repeated local operations are easier to review and continue
+
 ## 0.25.0 - 2026-03-14
 
 - added zip upload and direct bundle downloads in the local web UI
diff --git a/pyproject.toml b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "memory-migrate-plugin"
-version = "0.25.0"
+version = "0.26.0"
 description = "Open-source toolkit for migrating memories across AI agent systems."
 readme = "README.md"
 requires-python = ">=3.11"
diff --git a/src/memory_migrate_plugin/__init__.py b/src/memory_migrate_plugin/__init__.py
@@ -1,3 +1,3 @@
 __all__ = ["__version__"]
 
-__version__ = "0.25.0"
+__version__ = "0.26.0"
diff --git a/src/memory_migrate_plugin/serve.py b/src/memory_migrate_plugin/serve.py
@@ -23,6 +23,9 @@
 
 UI_WORKSPACE_ROOT = Path(tempfile.gettempdir()) / "agent-memory-bridge-ui"
 DOWNLOAD_REGISTRY: dict[str, Path] = {}
+ACTION_HISTORY: list[dict[str, Any]] = []
+MAX_ACTION_HISTORY = 12
+MAX_RECENT_DOWNLOADS = 10
 
 HTML_PAGE = Template("""<!doctype html>
 <html lang="en">
@@ -171,6 +174,31 @@
       background: #fffdf8;
       border: 1px solid var(--line);
     }
+    .panel-title {
+      font-weight: 700;
+      letter-spacing: 0.02em;
+    }
+    .history {
+      display: grid;
+      gap: 10px;
+      padding: 14px;
+      border-radius: 14px;
+      background: #fffdf8;
+      border: 1px solid var(--line);
+    }
+    .history-item {
+      border-top: 1px solid rgba(216, 201, 177, 0.7);
+      padding-top: 10px;
+      display: grid;
+      gap: 4px;
+      color: var(--muted);
+      font-size: 0.92rem;
+    }
+    .history-item:first-of-type {
+      border-top: none;
+      padding-top: 0;
+    }
+    .history-item strong { color: var(--ink); }
     .downloads a {
       color: var(--accent);
       font-weight: 700;
@@ -268,6 +296,7 @@
       <div class="card output">
         <div class="banner $status_class">$message</div>
         $download_links
+        $history_panel
         <pre>$output</pre>
         <div class="tips">
           <div>Suggested first try: <code>detect</code> or <code>inspect</code> before <code>bundle</code>.</div>
@@ -348,6 +377,71 @@ def register_download(path: Path) -> dict[str, str]:
     }
 
 
+def _recent_downloads() -> list[dict[str, str]]:
+    items: list[dict[str, str]] = []
+    for token, path in list(DOWNLOAD_REGISTRY.items())[-MAX_RECENT_DOWNLOADS:][::-1]:
+        if path.exists() and path.is_file():
+            items.append({
+                "token": token,
+                "path": str(path),
+                "filename": path.name,
+                "url": f"/download?token={token}",
+            })
+    return items
+
+
+def record_action_history(
+    action: str,
+    ok: bool,
+    input_path: str,
+    source_format: str | None,
+    target_format: str | None,
+    output_path: str | None,
+    message: str,
+    downloads: list[dict[str, str]] | None = None,
+) -> None:
+    entry = {
+        "id": uuid.uuid4().hex[:8],
+        "action": action,
+        "ok": ok,
+        "input_path": input_path,
+        "source_format": source_format or "auto",
+        "target_format": target_format or "-",
+        "output_path": output_path or "-",
+        "message": message,
+        "downloads": list(downloads or []),
+    }
+    ACTION_HISTORY.append(entry)
+    if len(ACTION_HISTORY) > MAX_ACTION_HISTORY:
+        del ACTION_HISTORY[:-MAX_ACTION_HISTORY]
+
+
+def render_history_panel(history: list[dict[str, Any]] | None = None, recent_downloads: list[dict[str, str]] | None = None) -> str:
+    history = history if history is not None else ACTION_HISTORY
+    recent_downloads = recent_downloads if recent_downloads is not None else _recent_downloads()
+    sections = ['<div class="history"><div class="panel-title">Recent Activity</div>']
+    if not history:
+        sections.append('<div class="history-item"><strong>No runs yet.</strong><div>Run a workflow to populate local session history.</div></div>')
+    else:
+        for item in history[::-1]:
+            state = "ok" if item["ok"] else "error"
+            sections.append(
+                f'<div class="history-item"><strong>{_html_escape(item["action"])} ? {state}</strong>'
+                f'<div>{_html_escape(item["message"])}</div>'
+                f'<div>input: {_html_escape(item["input_path"])}</div>'
+                f'<div>target: {_html_escape(item["target_format"])} ? output: {_html_escape(item["output_path"])}</div></div>'
+            )
+    if recent_downloads:
+        sections.append('<div class="panel-title">Recent Downloads</div>')
+        for item in recent_downloads:
+            sections.append(
+                f'<div class="history-item"><a href="{_html_escape(item["url"])}">{_html_escape(item["filename"])}</a>'
+                f'<div>{_html_escape(item["path"])}</div></div>'
+            )
+    sections.append('</div>')
+    return ''.join(sections)
+
+
 def render_download_links(downloads: list[dict[str, str]] | None) -> str:
     if not downloads:
         return ""
@@ -472,10 +566,12 @@ def _handle_run(self) -> None:
             status_class = "ok"
             downloads = result.get("downloads", [])
             output = json.dumps(result, indent=2, ensure_ascii=False)
+            record_action_history(action, True, input_path, source_format, target_format, output_path, message, downloads)
         except Exception as exc:
             message = f"Action '{action}' failed: {exc}"
             status_class = "error"
             output = json.dumps({"ok": False, "action": action, "error": str(exc)}, indent=2, ensure_ascii=False)
+            record_action_history(action, False, input_path, source_format, target_format, output_path, message, [])
         self._send_html(
             render_page(
                 action=action,
@@ -508,16 +604,20 @@ def _handle_upload(self) -> None:
         try:
             payload = upload.file.read()
             saved = save_uploaded_zip(getattr(upload, "filename", "upload.zip"), payload)
+            message = f"Uploaded and extracted zip into {saved['input_path']}"
+            record_action_history("upload", True, saved["input_path"], None, None, saved["zip_path"], message, [])
             self._send_html(
                 render_page(
                     input_path=saved["input_path"],
-                    message=f"Uploaded and extracted zip into {saved['input_path']}",
+                    message=message,
                     status_class="ok",
                     output=json.dumps(saved, indent=2, ensure_ascii=False),
                 )
             )
         except Exception as exc:
-            self._send_html(render_page(message=f"Upload failed: {exc}", status_class="error"))
+            message = f"Upload failed: {exc}"
+            record_action_history("upload", False, "", None, None, None, message, [])
+            self._send_html(render_page(message=message, status_class="error"))
 
     def _send_download(self, token: str) -> None:
         path = DOWNLOAD_REGISTRY.get(token)
@@ -556,6 +656,7 @@ def render_page(
     status_class: str = "",
     output: str = '{\n  "status": "idle"\n}',
     downloads: list[dict[str, str]] | None = None,
+    history: list[dict[str, Any]] | None = None,
 ) -> str:
     adapters = sorted(build_registry())
     profiles = sorted(list_profiles())
@@ -574,6 +675,7 @@ def render_page(
         status_class=_html_escape(status_class),
         output=_html_escape(output),
         download_links=render_download_links(downloads),
+        history_panel=render_history_panel(history, _recent_downloads()),
     )
 
 
diff --git a/tests/test_roundtrip.py b/tests/test_roundtrip.py
@@ -21,7 +21,7 @@
 from memory_migrate_plugin.schema import build_canonical_package_schema, write_canonical_package_schema
 from memory_migrate_plugin.validate import validate_package, validate_package_file
 from memory_migrate_plugin.init_adapter import init_adapter
-from memory_migrate_plugin.serve import execute_web_action, register_download, render_page, save_uploaded_zip
+from memory_migrate_plugin.serve import ACTION_HISTORY, DOWNLOAD_REGISTRY, execute_web_action, record_action_history, register_download, render_history_panel, render_page, save_uploaded_zip
 
 
 class MemoryMigrateTests(unittest.TestCase):
@@ -365,6 +365,26 @@ def test_save_uploaded_zip_extracts_fixture_archive(self) -> None:
             self.assertTrue(Path(saved["zip_path"]).exists())
             self.assertTrue(Path(saved["input_path"]).exists())
 
+    def test_record_action_history_keeps_recent_entries_only(self) -> None:
+        ACTION_HISTORY.clear()
+        for index in range(15):
+            record_action_history(f"action-{index}", True, "input", None, None, None, "ok", [])
+        self.assertEqual(len(ACTION_HISTORY), 12)
+        self.assertEqual(ACTION_HISTORY[0]["action"], "action-3")
+
+    def test_render_history_panel_shows_activity_and_downloads(self) -> None:
+        ACTION_HISTORY.clear()
+        DOWNLOAD_REGISTRY.clear()
+        with tempfile.TemporaryDirectory() as tmpdir:
+            bundle = Path(tmpdir) / "bundle.zip"
+            bundle.write_bytes(b"demo")
+            download = register_download(bundle)
+            record_action_history("bundle", True, "fixtures/generic-json/sample.json", "generic-json", "codex-memories", str(bundle), "done", [download])
+            html = render_history_panel()
+            self.assertIn("Recent Activity", html)
+            self.assertIn("Recent Downloads", html)
+            self.assertIn("bundle.zip", html)
+
     def test_register_download_returns_local_download_url(self) -> None:
         with tempfile.TemporaryDirectory() as tmpdir:
             target = Path(tmpdir) / "bundle.zip"
@@ -391,6 +411,7 @@ def test_render_page_contains_ui_shell(self) -> None:
         html = render_page()
         self.assertIn("Agent Memory Bridge", html)
         self.assertIn("Run Workflow", html)
+        self.assertIn("Recent Activity", html)
 
     def test_execute_web_action_detect_returns_matches(self) -> None:
         result = execute_web_action("detect", "fixtures/generic-json/sample.json")

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,3 @@`
`1`	`1`	`__all__ = ["__version__"]`
`2`	`2`
`3`		`-__version__ = "0.25.0"`
	`3`	`+__version__ = "0.26.0"`