tandem-editor 0.2.7 → 0.2.9

package/CHANGELOG.md

@@ -0,0 +1,82 @@
+# Changelog
+
+All notable changes to Tandem will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.2.9] - 2026-04-05
+
+### Fixed
+
+- Changelog tab no longer disappears after upgrade — version check and sample/welcome.md now open before servers start, preventing CRDT merge races with stale browser tabs
+- Tutorial annotation injection errors now get their own log message instead of being misattributed as file-open failures
+
+## [0.2.8] - 2026-04-05
+
+### Added
+
+- CHANGELOG.md opens as the active tab on first startup after an npm update
+- `checkVersionChange` helper tracks version transitions via `last-seen-version` file
+- CHANGELOG.md now ships in the npm package
+
+## [0.2.7] - 2026-04-05
+
+### Fixed
+
+- Force-reload (`tandem_open` with `force: true`) now clears Y.Doc in-place instead of destroying the Hocuspocus room — sidebar, observers, and connections survive
+- TOCTOU fix: session deletion moved after successful reload transaction
+- Observer ownership table corrected in architecture docs
+
+### Added
+
+- 4 new tests for force-reload (annotation clearing, awareness clearing, .txt reload, metadata)
+
+## [0.2.6] - 2026-04-05
+
+### Fixed
+
+- Demo script rewritten to be self-referential for recording
+- Observer ownership documentation added to architecture.md
+
+## [0.2.5] - 2026-04-05
+
+### Fixed
+
+- `tandem setup` Claude Code MCP config path updated
+
+## [0.2.4] - 2026-04-05
+
+### Fixed
+
+- Security audit findings (DNS rebinding, CORS, input validation)
+
+## [0.2.3] - 2026-04-05
+
+### Fixed
+
+- `tandem setup` now writes Claude Code MCP config to `~/.claude.json` instead of `~/.claude/mcp_settings.json`, which Claude Code no longer reads
+
+## [0.2.2] - 2025-04-05
+
+### Fixed
+
+- Silent failure review findings
+
+## [0.2.1] - 2025-04-05
+
+### Fixed
+
+- Full security audit — 25 findings across 7 categories (#172)
+
+## [0.2.0] - 2025-04-04
+
+### Added
+
+- Initial public release on npm as `tandem-editor`
+- 30 MCP tools for collaborative document editing
+- Multi-document tabs with CRDT-anchored annotations
+- Chat sidebar with real-time channel push
+- Support for .md, .docx, .txt, .html files
+- `tandem` CLI with `setup` and `start` commands
+- Claude Code skill auto-installation

package/dist/cli/index.js

@@ -337,7 +337,7 @@ var init_start = __esm({
 
 // src/cli/index.ts
 import updateNotifier from "update-notifier";
-var version = true ? "0.2.7" : "0.0.0-dev";
+var version = true ? "0.2.9" : "0.0.0-dev";
 updateNotifier({ pkg: { name: "tandem-editor", version } }).notify();
 var args = process.argv.slice(2);
 if (args.includes("--help") || args.includes("-h")) {

package/dist/server/index.js

@@ -214,12 +214,13 @@ function freePortUnix(port) {
     }
   }
 }
-var paths, SESSION_DIR;
+var paths, SESSION_DIR, LAST_SEEN_VERSION_FILE;
 var init_platform = __esm({
   "src/server/platform.ts"() {
     "use strict";
     paths = envPaths("tandem", { suffix: "" });
     SESSION_DIR = path.join(paths.data, "sessions");
+    LAST_SEEN_VERSION_FILE = path.join(paths.data, "last-seen-version");
   }
 });
 
@@ -3577,7 +3578,7 @@ var init_launcher = __esm({
 });
 
 // src/server/index.ts
-import path9 from "path";
+import path10 from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 
 // src/server/mcp/server.ts
@@ -5678,6 +5679,26 @@ init_constants();
 init_manager();
 init_platform();
 
+// src/server/version-check.ts
+import fs6 from "fs/promises";
+import path9 from "path";
+async function checkVersionChange(currentVersion, versionFilePath) {
+  let storedVersion = null;
+  try {
+    storedVersion = (await fs6.readFile(versionFilePath, "utf-8")).trim();
+  } catch (err) {
+    if (err.code !== "ENOENT") {
+      console.error("[Tandem] Failed to read last-seen-version:", err);
+    }
+  }
+  const result = storedVersion === null ? "first-install" : storedVersion === currentVersion ? "current" : "upgraded";
+  if (result !== "current") {
+    await fs6.mkdir(path9.dirname(versionFilePath), { recursive: true });
+    await fs6.writeFile(versionFilePath, currentVersion, "utf-8");
+  }
+  return result;
+}
+
 // src/server/error-filter.ts
 function isKnownHocuspocusError(err) {
   if (!(err instanceof Error)) return false;
@@ -5887,6 +5908,34 @@ async function main() {
     } catch (err) {
       console.error(`[Tandem] ${err instanceof Error ? err.message : err} \u2014 proceeding anyway`);
     }
+    const projectRoot = path10.resolve(path10.dirname(fileURLToPath2(import.meta.url)), "../..");
+    try {
+      const versionStatus = await checkVersionChange(APP_VERSION, LAST_SEEN_VERSION_FILE);
+      if (versionStatus === "upgraded") {
+        await openFileByPath(path10.join(projectRoot, "CHANGELOG.md"));
+        console.error(`[Tandem] Opened CHANGELOG.md (upgraded to v${APP_VERSION})`);
+      }
+    } catch (err) {
+      console.error("[Tandem] Version check / changelog open failed (non-fatal):", err);
+    }
+    if (docCount() === 0 && !process.env.TANDEM_NO_SAMPLE) {
+      const samplePath = path10.join(projectRoot, "sample/welcome.md");
+      try {
+        await openFileByPath(samplePath);
+        try {
+          const doc = getOrCreateDocument(docIdFromPath(samplePath));
+          injectTutorialAnnotations(doc);
+        } catch (err) {
+          console.error("[Tandem] Failed to inject tutorial annotations:", err);
+        }
+      } catch (err) {
+        if (err.code === "ENOENT") {
+          console.error("[Tandem] Sample file not found (skipping):", samplePath);
+        } else {
+          console.error("[Tandem] Failed to auto-open sample document:", err);
+        }
+      }
+    }
     const [srv] = await Promise.all([
       startMcpServerHttp(mcpPort),
       startHocuspocus(wsPort).then(() => {
@@ -5894,22 +5943,6 @@ async function main() {
       })
     ]);
     httpServer = srv;
-    if (getOpenDocs().size === 0 && !process.env.TANDEM_NO_SAMPLE) {
-      const samplePath = path9.resolve(
-        path9.dirname(fileURLToPath2(import.meta.url)),
-        "../../sample/welcome.md"
-      );
-      openFileByPath(samplePath).then(() => {
-        const doc = getOrCreateDocument(docIdFromPath(samplePath));
-        injectTutorialAnnotations(doc);
-      }).catch((err) => {
-        if (err.code === "ENOENT") {
-          console.error("[Tandem] Sample file not found (skipping):", samplePath);
-        } else {
-          console.error("[Tandem] Failed to auto-open sample document:", err);
-        }
-      });
-    }
     console.error("");
     console.error(`  Tandem v${APP_VERSION}`);
     console.error("");