@nanhara/hara 0.105.0 → 0.106.0

package/CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to `@nanhara/hara`.
 > Versioning (pre-1.0, SemVer-style): the **minor** (middle) number bumps for a **new feature**; the
 > **patch** (last) number bumps for **optimizations/fixes of existing features**.
 
+## 0.106.0 — gateway session hygiene
+
+- **Idle chats auto-rotate to a fresh thread.** A WeChat/Feishu chat is one endless surface — days-old
+  context used to pile onto every new ask and the agent answered from stale state. Now a chat idle
+  past **8 hours** (HARA_GATEWAY_IDLE_HOURS to tune; 0 disables) starts the next message on a fresh
+  session, with a one-time notice carrying `/resume <id>` — the old thread persists, nothing is lost.
+  Same-afternoon follow-ups continue as before.
+
 ## 0.105.0 — fan-outs synthesize before acting
 
 - **Synthesis nudge** (the last adopted item from the Claude Code internals study — their KN5

package/dist/gateway/serve.js

@@ -245,6 +245,10 @@ export async function runGateway(opts) {
             }
         }
         const ctx = chatContext(adapter.name, m.chatId, cwd); // this chat's current { cwd, sessionId }
+        if (ctx.rotatedFrom) {
+            // Idle auto-rotation just happened (session hygiene): tell the user ONCE, with the escape hatch.
+            await adapter.send(m.chatId, `🧵 fresh thread (chat was idle) — /resume ${ctx.rotatedFrom.slice(-18)} continues the previous one`);
+        }
         const cmd = parseCommand(m.text);
         if (cmd) {
             if (cmd.cmd === "help")

package/dist/gateway/sessions.js

@@ -8,6 +8,16 @@ import { homedir } from "node:os";
 import { join } from "node:path";
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
 import { createHash } from "node:crypto";
+/** Idle window before a chat auto-rotates to a FRESH session (hours). A WeChat/Feishu chat is one
+ *  endless surface — without this, days-old context piles onto every new ask and the agent answers
+ *  from stale state (the "gateway answers with old context" report). Default 8h: overnight gaps start
+ *  clean, a same-afternoon follow-up continues. HARA_GATEWAY_IDLE_HOURS tunes it; 0 disables. */
+export function idleRotationMs() {
+    const raw = Number(process.env.HARA_GATEWAY_IDLE_HOURS ?? 8);
+    if (!Number.isFinite(raw) || raw <= 0)
+        return 0; // 0/garbage → disabled
+    return raw * 3_600_000;
+}
 const dir = () => join(homedir(), ".hara", "gateway");
 const file = () => join(dir(), "chats.json");
 const mapKey = (platform, chatId) => `${platform}:${chatId}`;
@@ -37,17 +47,27 @@ export function chatContext(platform, chatId, defaultCwd) {
     const m = load();
     const k = mapKey(platform, chatId);
     const e = m[k];
+    const now = Date.now();
     if (!e) {
-        const fresh = { cwd: defaultCwd, sessionId: deriveId(platform, chatId, defaultCwd, 0), fork: 0 };
+        const fresh = { cwd: defaultCwd, sessionId: deriveId(platform, chatId, defaultCwd, 0), fork: 0, lastUsed: now };
         m[k] = fresh;
         save(m);
         return { cwd: fresh.cwd, sessionId: fresh.sessionId, voice: false };
     }
-    if (!e.cwd) {
+    if (!e.cwd)
         e.cwd = defaultCwd; // migrate an old (pre-cwd) entry, preserving its existing sessionId
-        save(m);
+    // Session hygiene: a chat idle past the window rotates to a fresh thread (same mechanics as /new).
+    // The OLD id is returned so the gateway can offer "/resume <id>" — nothing is lost, sessions persist.
+    const idleMs = idleRotationMs();
+    let rotatedFrom;
+    if (idleMs > 0 && typeof e.lastUsed === "number" && now - e.lastUsed > idleMs && e.sessionId) {
+        rotatedFrom = e.sessionId;
+        e.fork = (e.fork ?? 0) + 1;
+        e.sessionId = deriveId(platform, chatId, e.cwd, e.fork);
     }
-    return { cwd: e.cwd, sessionId: e.sessionId, voice: !!e.voice };
+    e.lastUsed = now;
+    save(m);
+    return { cwd: e.cwd, sessionId: e.sessionId, voice: !!e.voice, ...(rotatedFrom ? { rotatedFrom } : {}) };
 }
 /** `/voice` — toggle whether this chat's replies are spoken (TTS audio); returns the new state. */
 export function toggleVoice(platform, chatId) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nanhara/hara",
-  "version": "0.105.0",
+  "version": "0.106.0",
   "description": "hara — a coding agent CLI that runs like an engineering org.",
   "bin": {
     "hara": "dist/index.js"