chore: repo-wide refactoring, reducing racing conditions and code smell.

- enforce TTL on in-memory hash fallbacks and improve hash handling
- Added a test to ensure TTL is enforced on in-memory hash fallbacks when the runtime lacks hash support.
- Updated RedisClient to manage hash fallback keys and ensure proper expiration handling.
- Enhanced RedisEventsService to handle dead-lettering of malformed claimed payloads and maintain valid entries.
- Introduced checkpointing for claimed entries in RedisEventsService to track successful claims.
- Added utility functions to normalize Windows-style paths for group IDs in utils.
- Implemented migration of temporary-root session state into canonical parent sessions in SessionManager.
- flush pending memory batches during graceful shutdown so undersized user memories are not dropped on exit.
- converge signal and unload shutdown handling onto one teardown path, while removing legacy falkordb config-key compatibility in favor of redis only.

Author: vicary

.github/scripts/version.test.ts

@@ -13,9 +13,52 @@ import {
   findReleaseAs,
   hasBreakingChangeBody,
   hasNonTestChanges,
+  parseChangedFiles,
   parseSemver,
+  run,
 } from "./version.ts";
 
+const makeCliDeps = (options: {
+  env?: Record<string, string | undefined>;
+  files?: Record<string, string>;
+  commands?: Record<string, string | Error>;
+  now?: Date;
+}) => {
+  const outputs: string[] = [];
+  const logs: string[] = [];
+  const calls: string[] = [];
+
+  return {
+    deps: {
+      cmd: (...command: string[]) => {
+        const key = command.join(" ");
+        calls.push(key);
+        const result = options.commands?.[key];
+        if (result instanceof Error) return Promise.reject(result);
+        return Promise.resolve(result ?? "");
+      },
+      readTextFile: (filePath: string) => {
+        const result = options.files?.[filePath];
+        if (result === undefined) {
+          return Promise.reject(new Error(`ENOENT: ${filePath}`));
+        }
+        return Promise.resolve(result);
+      },
+      envGet: (name: string) => options.env?.[name],
+      appendFile: (_filePath: string, text: string) => {
+        outputs.push(text);
+      },
+      log: (message: string) => {
+        logs.push(message);
+      },
+      now: () => options.now ?? new Date("2026-02-12T09:14:29Z"),
+    },
+    outputs,
+    logs,
+    calls,
+  };
+};
+
 describe("analyzeCommits", () => {
   it("returns 'none' for empty array", () => {
     assertEquals(analyzeCommits([]), "none");
@@ -339,6 +382,15 @@ describe("hasNonTestChanges", () => {
   });
 });
 
+describe("parseChangedFiles", () => {
+  it("returns unique trimmed changed paths", () => {
+    assertEquals(
+      parseChangedFiles("src/mod.ts\n\nsrc/mod.ts\n src/util.ts \n"),
+      ["src/mod.ts", "src/util.ts"],
+    );
+  });
+});
+
 describe("calculateVersion", () => {
   const baseOpts = {
     currentVersion: "1.0.0",
@@ -582,6 +634,30 @@ describe("calculateVersion", () => {
         tag: "canary",
       });
     });
+
+    it("skips push release when no git tags and only test files changed", () => {
+      const result = calculateVersion({
+        ...baseOpts,
+        currentVersion: "0.0.0",
+        subjects: ["chore: initial"],
+        changedFiles: ["src/foo.test.ts", ".github/scripts/version.test.ts"],
+        noGitTags: true,
+        eventName: "push",
+      });
+      assertEquals(result, { skip: true });
+    });
+
+    it("skips canary publish when no git tags and only test files changed", () => {
+      const result = calculateVersion({
+        ...baseOpts,
+        currentVersion: "0.0.0",
+        subjects: ["docs: update"],
+        changedFiles: ["src/foo.test.ts"],
+        noGitTags: true,
+        eventName: "pull_request",
+      });
+      assertEquals(result, { skip: true });
+    });
   });
 
   describe("edge cases", () => {
@@ -688,3 +764,131 @@ describe("calculateVersion", () => {
     });
   });
 });
+
+describe("run", () => {
+  it("writes release outputs for the git-tag CLI path used by GitHub Actions", async () => {
+    const cli = makeCliDeps({
+      env: {
+        GITHUB_EVENT_NAME: "push",
+        GITHUB_OUTPUT: "/tmp/github-output",
+        COMMIT_SHA: "override-sha-1234567",
+      },
+      files: {
+        "deno.json": JSON.stringify({ name: "opencode-graphiti" }),
+      },
+      commands: {
+        "git describe --tags --abbrev=0 --match v*": "v1.2.3",
+        "git log v1.2.3..HEAD --format=%s": "feat: ship cli coverage",
+        "git log v1.2.3..HEAD --format=%b": "",
+        "git diff --name-only v1.2.3..HEAD": ".github/scripts/version.ts\n",
+      },
+    });
+
+    await run([], cli.deps);
+
+    assertEquals(cli.outputs, ["version=1.3.0\n", "tag=latest\n"]);
+    assertEquals(cli.logs, [
+      "version=1.3.0",
+      "tag=latest",
+      "Release version: 1.3.0",
+    ]);
+    assertEquals(
+      cli.calls.includes("git describe --tags --abbrev=0 --match v*"),
+      true,
+    );
+  });
+
+  it("covers the no-tag fallback path, package discovery, args fallback, and canary output", async () => {
+    const cli = makeCliDeps({
+      env: {
+        GITHUB_OUTPUT: "/tmp/github-output",
+      },
+      files: {
+        "package.json": JSON.stringify({ name: "fallback-package" }),
+      },
+      commands: {
+        "git describe --tags --abbrev=0 --match v*": new Error("no tags"),
+        "npm view fallback-package version": "0.1.0",
+        "git log --format=%s": "docs: note fallback behavior",
+        "git log --format=%b": "",
+        "git log --format= --name-only": "src/mod.ts\n",
+      },
+      now: new Date("2026-02-12T09:14:29Z"),
+    });
+
+    await run(["pull_request", "abcdef1234567890"], cli.deps);
+
+    assertEquals(cli.outputs, [
+      "version=0.1.1-canary.abcdef1.20260212091429\n",
+      "tag=canary\n",
+    ]);
+    assertEquals(
+      cli.logs.at(-1),
+      "Canary version: 0.1.1-canary.abcdef1.20260212091429",
+    );
+    assertEquals(cli.calls.includes("npm view fallback-package version"), true);
+  });
+
+  it("reads the package name from commented deno.jsonc content", async () => {
+    const cli = makeCliDeps({
+      env: {
+        GITHUB_OUTPUT: "/tmp/github-output",
+      },
+      files: {
+        "deno.jsonc": `{
+  // Package metadata for release automation.
+  "name": "commented-package",
+  /* Keep the rest of the manifest commented-friendly. */
+  "version": "0.0.0-development"
+}`,
+      },
+      commands: {
+        "git describe --tags --abbrev=0 --match v*": new Error("no tags"),
+        "npm view commented-package version": "0.2.0",
+        "git log --format=%s": "docs: note jsonc support",
+        "git log --format=%b": "",
+        "git log --format= --name-only": ".github/scripts/version.ts\n",
+      },
+      now: new Date("2026-02-12T09:14:29Z"),
+    });
+
+    await run(["pull_request", "abcdef1234567890"], cli.deps);
+
+    assertEquals(cli.outputs, [
+      "version=0.2.1-canary.abcdef1.20260212091429\n",
+      "tag=canary\n",
+    ]);
+    assertEquals(
+      cli.calls.includes("npm view commented-package version"),
+      true,
+    );
+  });
+
+  it("emits skip=true when only test files changed", async () => {
+    const cli = makeCliDeps({
+      env: {
+        GITHUB_EVENT_NAME: "push",
+        GITHUB_OUTPUT: "/tmp/github-output",
+      },
+      files: {
+        "deno.json": JSON.stringify({ name: "opencode-graphiti" }),
+      },
+      commands: {
+        "git rev-parse HEAD": "abc123def4567890",
+        "git describe --tags --abbrev=0 --match v*": "v1.2.3",
+        "git log v1.2.3..HEAD --format=%s": "test: add cli coverage",
+        "git log v1.2.3..HEAD --format=%b": "",
+        "git diff --name-only v1.2.3..HEAD":
+          ".github/scripts/version.test.ts\n",
+      },
+    });
+
+    await run([], cli.deps);
+
+    assertEquals(cli.outputs, ["skip=true\n"]);
+    assertEquals(cli.logs, [
+      "skip=true",
+      "No release-triggering commits since v1.2.3, skipping",
+    ]);
+  });
+});