tim-hooks 0.1.0-beta.0

package/dist/rebalance.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rebalanceBatch = rebalanceBatch;
+const tim_store_1 = require("tim-store");
+const marker_js_1 = require("./marker.js");
+const STOP_WORDS = new Set([
+    'about', 'after', 'also', 'been', 'from', 'have', 'into', 'just', 'more', 'some',
+    'than', 'that', 'the', 'their', 'them', 'then', 'there', 'these', 'they', 'this',
+    'those', 'very', 'what', 'when', 'which', 'with', 'your',
+]);
+function exchangeSummaryText(entry) {
+    return `${entry.title} ${entry.content}`.trim();
+}
+function keywords(text) {
+    const out = new Set();
+    for (const raw of text.toLowerCase().split(/[^a-z0-9]+/)) {
+        if (raw.length >= 4 && !STOP_WORDS.has(raw))
+            out.add(raw);
+    }
+    return out;
+}
+function shareKeywords(a, b) {
+    const ka = keywords(exchangeSummaryText(a));
+    const kb = keywords(exchangeSummaryText(b));
+    for (const k of ka) {
+        if (kb.has(k))
+            return true;
+    }
+    return false;
+}
+async function userExchanges(store, batchId) {
+    return (await store.getChildrenBySeq(batchId)).filter(u => u.metadata.role === 'user');
+}
+async function agentReply(store, user) {
+    const replies = await store.getChildren(user.id);
+    return replies.find(r => r.metadata.role === 'agent') ?? null;
+}
+/**
+ * Scan exchange-batch boundaries; move the first exchange of batch N (+ agent reply)
+ * into batch N-1 when it is topically related to the last exchange of N-1.
+ */
+async function rebalanceBatch(store, sessionId, opts = {}) {
+    const skipped = [];
+    let resolvedCwd = opts.cwd;
+    if (!resolvedCwd) {
+        const session = await store.read(sessionId);
+        if (typeof session?.metadata.cwd === 'string')
+            resolvedCwd = session.metadata.cwd;
+    }
+    if (resolvedCwd && (0, marker_js_1.isSessionLocked)(resolvedCwd)) {
+        return { moved: 0, skipped: [{ reason: 'locked' }] };
+    }
+    const session = await store.read(sessionId);
+    if (!session || session.metadata.kind !== 'session') {
+        throw new Error(`Session not found: ${sessionId}`);
+    }
+    const exNode = await (0, tim_store_1.findChildByKind)(store, sessionId, tim_store_1.KIND_EXCHANGES_ROOT);
+    if (!exNode)
+        return { moved: 0, skipped };
+    const batches = await store.getChildByKind(exNode.id, tim_store_1.KIND_EXCHANGE_BATCH);
+    if (batches.length < 2) {
+        return { moved: 0, skipped: [{ reason: 'no-boundary' }] };
+    }
+    let moved = 0;
+    for (let i = 1; i < batches.length; i++) {
+        const prev = batches[i - 1];
+        const curr = batches[i];
+        const batchIndex = typeof curr.metadata.batch_index === 'number' ? curr.metadata.batch_index : i + 1;
+        const prevUsers = await userExchanges(store, prev.id);
+        const currUsers = await userExchanges(store, curr.id);
+        if (currUsers.length < 2) {
+            skipped.push({ reason: 'single-exchange-batch', batchIndex });
+            continue;
+        }
+        const lastPrev = prevUsers[prevUsers.length - 1];
+        const firstCurr = currUsers[0];
+        if (!lastPrev || !firstCurr)
+            continue;
+        if (!shareKeywords(lastPrev, firstCurr)) {
+            skipped.push({ reason: 'unrelated', batchIndex });
+            continue;
+        }
+        const agent = await agentReply(store, firstCurr);
+        store.curate().moveEntry(firstCurr.id, prev.id);
+        if (agent)
+            store.curate().moveEntry(agent.id, prev.id);
+        moved += 1;
+    }
+    return { moved, skipped };
+}
+//# sourceMappingURL=rebalance.js.map

package/dist/rebalance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rebalance.js","sourceRoot":"","sources":["../src/rebalance.ts"],"names":[],"mappings":"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"}

package/dist/session-hooks.d.ts

@@ -0,0 +1,53 @@
+import type { TimStore } from 'tim-store';
+export interface SpawnContext {
+    sessionId: string;
+    cwd: string;
+}
+export type Spawner = (command: string, ctx: SpawnContext) => void;
+export type SessionStopReason = 'spawned' | 'no-marker' | 'below-threshold' | 'locked' | 'spawn-failed';
+export interface SessionStopResult {
+    spawned: boolean;
+    reason: SessionStopReason;
+    pending?: number;
+}
+export { DEFAULT_SUMMARIZER_TIMEOUT_SEC } from './constants.js';
+export declare function summarizerLogPath(cwd: string): string;
+/** Shell snippet: trap lock release, timeout, run tim-summarizer CLI with log append. */
+export declare function buildSummarizerCommand(sessionId: string, lockPath: string, logPath: string, timeoutSec?: number): string;
+/** Detached spawn with log dir creation and spawn-error capture (does not throw). */
+export declare const spawnSummarizer: Spawner;
+/** @deprecated Use spawnSummarizer */
+export declare const detachedSpawner: Spawner;
+export interface MaybeSpawnSummarizerOptions {
+    spawn?: Spawner;
+    /** Skip pending threshold — use when a batch just filled (live trigger). */
+    batchFull?: boolean;
+    timeoutSec?: number;
+}
+/** Shared spawn gate for session-stop hook and live batch-full trigger. */
+export declare function maybeSpawnSummarizer(store: TimStore, cwd: string, opts?: MaybeSpawnSummarizerOptions): Promise<SessionStopResult>;
+export declare function onSessionStop(store: TimStore, cwd: string, opts?: {
+    spawn?: Spawner;
+    timeoutSec?: number;
+}): Promise<SessionStopResult>;
+export declare const DEFAULT_PROJECT_SUMMARY_THRESHOLD = 5;
+/** Shell snippet: run tim-summarizer in --project-summary mode for a label. */
+export declare function buildProjectSummaryCommand(label: string, logPath: string, timeoutSec?: number): string;
+export type ProjectSummaryReason = 'spawned' | 'no-label' | 'no-sessions' | 'below-threshold' | 'spawn-failed';
+export interface ProjectSummaryResult {
+    spawned: boolean;
+    reason: ProjectSummaryReason;
+    count?: number;
+}
+export interface MaybeSpawnProjectSummaryOptions {
+    spawn?: Spawner;
+    threshold?: number;
+    timeoutSec?: number;
+}
+/**
+ * Gate + detached spawn for periodic project-summary generation.
+ * Fires only when sessions-so-far is a positive multiple of the threshold.
+ * Fire-and-forget — never throws.
+ */
+export declare function maybeSpawnProjectSummary(store: TimStore, cwd: string, label: string | null, opts?: MaybeSpawnProjectSummaryOptions): Promise<ProjectSummaryResult>;
+//# sourceMappingURL=session-hooks.d.ts.map

package/dist/session-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-hooks.d.ts","sourceRoot":"","sources":["../src/session-hooks.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAU1C,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,KAAK,IAAI,CAAC;AAEnE,MAAM,MAAM,iBAAiB,GACzB,SAAS,GACT,WAAW,GACX,iBAAiB,GACjB,QAAQ,GACR,cAAc,CAAC;AAEnB,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,OAAO,EAAE,8BAA8B,EAAE,MAAM,gBAAgB,CAAC;AAEhE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,yFAAyF;AACzF,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,UAAU,GAAE,MAAuC,GAClD,MAAM,CAOR;AAED,qFAAqF;AACrF,eAAO,MAAM,eAAe,EAAE,OAkC7B,CAAC;AAEF,sCAAsC;AACtC,eAAO,MAAM,eAAe,EAAE,OAAyB,CAAC;AAExD,MAAM,WAAW,2BAA2B;IAC1C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,2EAA2E;AAC3E,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,QAAQ,EACf,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,2BAAgC,GACrC,OAAO,CAAC,iBAAiB,CAAC,CA4B5B;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,QAAQ,EACf,GAAG,EAAE,MAAM,EACX,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GAClD,OAAO,CAAC,iBAAiB,CAAC,CAE5B;AAED,eAAO,MAAM,iCAAiC,IAAI,CAAC;AAEnD,+EAA+E;AAC/E,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,UAAU,GAAE,MAAuC,GAClD,MAAM,CAIR;AAED,MAAM,MAAM,oBAAoB,GAC5B,SAAS,GACT,UAAU,GACV,aAAa,GACb,iBAAiB,GACjB,cAAc,CAAC;AAEnB,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,+BAA+B;IAC9C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,QAAQ,EACf,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,IAAI,GAAE,+BAAoC,GACzC,OAAO,CAAC,oBAAoB,CAAC,CAqB/B"}

package/dist/session-hooks.js

@@ -0,0 +1,167 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_PROJECT_SUMMARY_THRESHOLD = exports.detachedSpawner = exports.spawnSummarizer = exports.DEFAULT_SUMMARIZER_TIMEOUT_SEC = void 0;
+exports.summarizerLogPath = summarizerLogPath;
+exports.buildSummarizerCommand = buildSummarizerCommand;
+exports.maybeSpawnSummarizer = maybeSpawnSummarizer;
+exports.onSessionStop = onSessionStop;
+exports.buildProjectSummaryCommand = buildProjectSummaryCommand;
+exports.maybeSpawnProjectSummary = maybeSpawnProjectSummary;
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const marker_js_1 = require("./marker.js");
+const constants_js_1 = require("./constants.js");
+var constants_js_2 = require("./constants.js");
+Object.defineProperty(exports, "DEFAULT_SUMMARIZER_TIMEOUT_SEC", { enumerable: true, get: function () { return constants_js_2.DEFAULT_SUMMARIZER_TIMEOUT_SEC; } });
+function summarizerLogPath(cwd) {
+    return path.join(cwd, '.tim', 'summarizer.log');
+}
+/** Shell snippet: trap lock release, timeout, run tim-summarizer CLI with log append. */
+function buildSummarizerCommand(sessionId, lockPath, logPath, timeoutSec = constants_js_1.DEFAULT_SUMMARIZER_TIMEOUT_SEC) {
+    const q = (s) => JSON.stringify(s);
+    const cmd = 'node ' + JSON.stringify(path.resolve(__dirname, '..', '..', 'tim-summarizer', 'dist', 'summarize.js'));
+    return (`{ trap ${q(`rm -f ${lockPath}`)} EXIT; ` +
+        `timeout ${timeoutSec} env TIM_SESSION_ID=${q(sessionId)} ${cmd} >>${q(logPath)} 2>&1; }`);
+}
+/** Detached spawn with log dir creation and spawn-error capture (does not throw). */
+const spawnSummarizer = (command, ctx) => {
+    const timDir = path.join(ctx.cwd, '.tim');
+    try {
+        fs.mkdirSync(timDir, { recursive: true });
+    }
+    catch {
+        /* ignore */
+    }
+    const logPath = summarizerLogPath(ctx.cwd);
+    try {
+        const child = (0, child_process_1.spawn)(command, {
+            shell: true,
+            cwd: ctx.cwd,
+            detached: true,
+            stdio: 'ignore',
+            env: { ...process.env, TIM_SESSION_ID: ctx.sessionId },
+        });
+        child.on('error', err => {
+            try {
+                fs.appendFileSync(logPath, `[${new Date().toISOString()}] spawn error: ${err.message}\n`);
+            }
+            catch {
+                /* ignore */
+            }
+            (0, marker_js_1.releaseLock)(ctx.cwd);
+        });
+        child.unref();
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        try {
+            fs.appendFileSync(logPath, `[${new Date().toISOString()}] spawn failed: ${msg}\n`);
+        }
+        catch {
+            /* ignore */
+        }
+        (0, marker_js_1.releaseLock)(ctx.cwd);
+    }
+};
+exports.spawnSummarizer = spawnSummarizer;
+/** @deprecated Use spawnSummarizer */
+exports.detachedSpawner = exports.spawnSummarizer;
+/** Shared spawn gate for session-stop hook and live batch-full trigger. */
+async function maybeSpawnSummarizer(store, cwd, opts = {}) {
+    const spawn = opts.spawn ?? exports.spawnSummarizer;
+    const marker = (0, marker_js_1.detectProject)(cwd);
+    if (!marker)
+        return { spawned: false, reason: 'no-marker' };
+    const reconciled = await (0, marker_js_1.reconcileMarker)(store, cwd);
+    const pending = reconciled.exchanges - reconciled.batches_summarized * reconciled.batch_size;
+    if (!opts.batchFull && pending < reconciled.batch_size) {
+        return { spawned: false, reason: 'below-threshold', pending };
+    }
+    if (!(0, marker_js_1.acquireLock)(cwd))
+        return { spawned: false, reason: 'locked', pending };
+    const lockPath = path.join(cwd, marker_js_1.MARKER_LOCK);
+    const logPath = summarizerLogPath(cwd);
+    const timeoutSec = opts.timeoutSec ?? constants_js_1.DEFAULT_SUMMARIZER_TIMEOUT_SEC;
+    try {
+        spawn(buildSummarizerCommand(reconciled.session, lockPath, logPath, timeoutSec), {
+            sessionId: reconciled.session,
+            cwd,
+        });
+        return { spawned: true, reason: 'spawned', pending };
+    }
+    catch {
+        (0, marker_js_1.releaseLock)(cwd);
+        return { spawned: false, reason: 'spawn-failed', pending };
+    }
+}
+async function onSessionStop(store, cwd, opts = {}) {
+    return maybeSpawnSummarizer(store, cwd, opts);
+}
+exports.DEFAULT_PROJECT_SUMMARY_THRESHOLD = 5;
+/** Shell snippet: run tim-summarizer in --project-summary mode for a label. */
+function buildProjectSummaryCommand(label, logPath, timeoutSec = constants_js_1.DEFAULT_SUMMARIZER_TIMEOUT_SEC) {
+    const q = (s) => JSON.stringify(s);
+    const cmd = 'node ' + JSON.stringify(path.resolve(__dirname, '..', '..', 'tim-summarizer', 'dist', 'summarize.js'));
+    return `timeout ${timeoutSec} ${cmd} --project-summary ${q(label)} >>${q(logPath)} 2>&1`;
+}
+/**
+ * Gate + detached spawn for periodic project-summary generation.
+ * Fires only when sessions-so-far is a positive multiple of the threshold.
+ * Fire-and-forget — never throws.
+ */
+async function maybeSpawnProjectSummary(store, cwd, label, opts = {}) {
+    if (!label)
+        return { spawned: false, reason: 'no-label' };
+    const count = await store.countSessionSummaries(label);
+    if (count <= 0)
+        return { spawned: false, reason: 'no-sessions', count };
+    const threshold = opts.threshold ?? exports.DEFAULT_PROJECT_SUMMARY_THRESHOLD;
+    if (threshold <= 0 || count % threshold !== 0) {
+        return { spawned: false, reason: 'below-threshold', count };
+    }
+    const spawn = opts.spawn ?? exports.spawnSummarizer;
+    const logPath = summarizerLogPath(cwd);
+    const timeoutSec = opts.timeoutSec ?? constants_js_1.DEFAULT_SUMMARIZER_TIMEOUT_SEC;
+    try {
+        spawn(buildProjectSummaryCommand(label, logPath, timeoutSec), { sessionId: label, cwd });
+        return { spawned: true, reason: 'spawned', count };
+    }
+    catch {
+        return { spawned: false, reason: 'spawn-failed', count };
+    }
+}
+//# sourceMappingURL=session-hooks.js.map

package/dist/session-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-hooks.js","sourceRoot":"","sources":["../src/session-hooks.ts"],"names":[],"mappings":"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"}

package/dist/update-check.d.ts

@@ -0,0 +1,5 @@
+export declare function getUpdateCheckLine(options?: {
+    fetchTimeoutMs?: number;
+}): Promise<string | null>;
+export declare function getUpdateCheckLineBriefing(): Promise<string | null>;
+//# sourceMappingURL=update-check.d.ts.map

package/dist/update-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"AA4CA,wBAAsB,kBAAkB,CAAC,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAW1G;AAED,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAEzE"}

package/dist/update-check.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUpdateCheckLine = getUpdateCheckLine;
+exports.getUpdateCheckLineBriefing = getUpdateCheckLineBriefing;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const tim_core_1 = require("tim-core");
+const ONE_DAY_MS = 86_400_000;
+const PACKAGE_NAME = 'tim-mcp';
+const DEFAULT_FETCH_TIMEOUT_MS = 3000;
+const DEFAULT_BRIEFING_TIMEOUT_MS = 500;
+function timMcpPackagePath() {
+    return (0, node_path_1.join)(__dirname, '..', '..', 'tim-mcp', 'package.json');
+}
+function installedVersion() {
+    try {
+        const pkg = JSON.parse((0, node_fs_1.readFileSync)(timMcpPackagePath(), 'utf8'));
+        return pkg.version ?? '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+async function fetchLatestVersion(timeoutMs = DEFAULT_FETCH_TIMEOUT_MS) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const res = await fetch(`https://registry.npmjs.org/${PACKAGE_NAME}/latest`, { signal: controller.signal });
+        if (!res.ok)
+            return null;
+        const data = await res.json();
+        return data.version ?? null;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+function raceWithTimeout(promise, timeoutMs) {
+    return new Promise((resolve) => {
+        const timer = setTimeout(() => resolve(null), timeoutMs);
+        promise.then((v) => { clearTimeout(timer); resolve(v); }, () => { clearTimeout(timer); resolve(null); });
+    });
+}
+async function getUpdateCheckLine(options = {}) {
+    const config = (0, tim_core_1.loadConfig)();
+    if (config.updateCheck === false)
+        return null;
+    const lastAt = config.updateCheckLastAt;
+    if (lastAt && Date.now() - new Date(lastAt).getTime() < ONE_DAY_MS)
+        return null;
+    const latest = await fetchLatestVersion(options.fetchTimeoutMs ?? DEFAULT_FETCH_TIMEOUT_MS);
+    (0, tim_core_1.saveConfig)({ ...(0, tim_core_1.loadConfig)(), updateCheckLastAt: new Date().toISOString() });
+    if (!latest)
+        return null;
+    const installed = installedVersion();
+    if (latest === installed)
+        return null;
+    return `TIM ${latest} available (installed: ${installed}) — npm i -g ${PACKAGE_NAME}`;
+}
+async function getUpdateCheckLineBriefing() {
+    return raceWithTimeout(getUpdateCheckLine(), DEFAULT_BRIEFING_TIMEOUT_MS);
+}
+//# sourceMappingURL=update-check.js.map

package/dist/update-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-check.js","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "tim-hooks",
+  "version": "0.1.0-beta.0",
+  "description": "TIM hook scripts and checkpoint orchestration",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/**/*",
+    "!dist/**/__tests__/**",
+    "scripts/**/*"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "pretest": "npm --prefix ../.. run build",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "tim-core": "0.1.0-beta.0",
+    "tim-store": "0.1.0-beta.0"
+  },
+  "optionalDependencies": {
+    "fastembed": "^1.0.0"
+  }
+}

package/scripts/README-hermes-statusline.md

@@ -0,0 +1,47 @@
+# Hermes status bar (TIM)
+
+Hermes has **no** Claude-style `statusLine` in `settings.json`. Persistent project/batch info uses the **Hermes CLI TUI status bar**, which calls a hook script on refresh.
+
+## Mechanism
+
+| Piece | Role |
+|-------|------|
+| `tim-hermes-session-cache.sh` | `pre_llm_call` — writes `~/.tim/.session-cache` (`session_id`, `cwd`). Returns `{}`. |
+| `tim-hermes-statusline.sh` | Called by patched Hermes `cli.py` — prints JSON: `{device, project, o_node, counter}` |
+| `hermes-cli-tim-statusline.patch` | Reference only — install uses programmatic `cli.py` patch (line drift safe) |
+| `tim statusline --format hermes` | Core formatter (used by the shell script) |
+
+`pre_llm_call` **`context`** injection is for turn prompts (see `tim-session-start.sh`), not the status bar.
+
+## Install (one command)
+
+```bash
+cd ~/projects/tim && npx tsc -b   # once, if developing from source
+node packages/tim-cli/dist/cli.js setup-hermes-statusline
+# or after npm link -g:  tim setup-hermes-statusline
+```
+
+Idempotent: safe to re-run. Options: `--dry-run`, `--skip-build`, env `HERMES_AGENT_DIR`.
+
+Manual steps (what the command does):
+
+1. Symlink `tim-hermes-*.sh` → `~/.hermes/agent-hooks/`
+2. Insert `tim-hermes-session-cache.sh` into `~/.hermes/config.yaml` `pre_llm_call` (after `o9k-startup.sh`)
+3. Patch `~/.hermes/hermes-agent/cli.py` (`_get_tim_status` + status-bar fragments)
+4. `npx tsc -b` when run from TIM monorepo
+
+## Verify
+
+```bash
+# JSON for status bar
+bash packages/tim-hooks/scripts/tim-hermes-statusline.sh | jq .
+
+# Text line (debug)
+node packages/tim-cli/dist/cli.js statusline --cwd ~/projects/tim
+```
+
+Restart Hermes after patching `cli.py`.
+
+## Claude Code
+
+Do **not** use `statusLine` in `~/.claude/settings.json` for TIM — that is Claude-only. Use this Hermes path instead.

package/scripts/hermes-cli-tim-statusline.patch

@@ -0,0 +1,75 @@
+diff --git a/cli.py b/cli.py
+--- a/cli.py
++++ b/cli.py
+@@ -2821,6 +2821,22 @@ class HermesCLI:
+ 
+         return snapshot
+ 
++    def _get_tim_status(self) -> Dict[str, str]:
++        """Call tim-hermes-statusline.sh for TIM project / batch counter."""
++        try:
++            import subprocess, json
++            script = os.path.expanduser("~/.hermes/agent-hooks/tim-hermes-statusline.sh")
++            if not os.path.isfile(script):
++                return {}
++            result = subprocess.run(
++                ["bash", script], capture_output=True, text=True, timeout=3
++            )
++            if result.returncode == 0 and result.stdout.strip():
++                return json.loads(result.stdout)
++        except Exception:
++            pass
++        return {}
++
+     @staticmethod
+     def _status_bar_display_width(text: str) -> int:
+         """Return terminal cell width for status-bar text.
+@@ -3030,14 +3046,27 @@ class HermesCLI:
+             return []
+         try:
+             snapshot = self._get_status_bar_snapshot()
+             width = self._get_tui_terminal_width()
+             duration_label = snapshot["duration"]
+ 
++            tim = self._get_tim_status()
++            tim_prefix = ""
++            if tim:
++                parts = []
++                if tim.get("device"):
++                    parts.append(tim["device"])
++                proj = tim.get("project", "")
++                o_node = tim.get("o_node", "")
++                if o_node:
++                    proj = f"{proj} → {o_node}"
++                if proj:
++                    parts.append(proj)
++                if tim.get("counter"):
++                    parts.append(tim["counter"])
++                if parts:
++                    tim_prefix = " │ ".join(parts)
++
+             if width < 52:
+                 frags = [
+                     ("class:status-bar", " ⚕ "),
+@@ -3075,7 +3104,11 @@ class HermesCLI:
+ 
+                     bar_style = self._status_bar_context_style(percent)
+                     compressions = snapshot.get("compressions", 0)
+-                    frags = [
++                    frags = []
++                    if tim_prefix:
++                        frags.append(("class:status-bar-strong", f" {tim_prefix}"))
++                        frags.append(("class:status-bar-dim", " │ "))
++                    frags.extend([
+                         ("class:status-bar", " ⚕ "),
+                         ("class:status-bar-strong", snapshot["model_short"]),
+                         ("class:status-bar-dim", " │ "),
+@@ -3084,7 +3117,7 @@ class HermesCLI:
+                         (bar_style, self._build_context_bar(percent)),
+                         ("class:status-bar-dim", " "),
+                         (bar_style, percent_label),
+-                    ]
++                    ])
+                     if compressions:
+                         frags.append(("class:status-bar-dim", " │ "))
+                         frags.append((self._compression_count_style(compressions), f"🗜️ {compressions}"))

package/scripts/lib/resolve-tim-cli.sh

@@ -0,0 +1,30 @@
+#!/usr/bin/env bash
+# Shared TIM CLI discovery for hook entrypoints.
+
+TIM_HOOKS_SCRIPTS_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+
+resolve_tim_cli() {
+  if [[ -n "${TIM_CLI:-}" ]]; then
+    printf '%s\n' "$TIM_CLI"
+    return 0
+  fi
+
+  if command -v tim >/dev/null 2>&1; then
+    command -v tim
+    return 0
+  fi
+
+  local candidate="${TIM_HOOKS_SCRIPTS_DIR}/../../tim-cli/dist/cli.js"
+  [[ -f "$candidate" ]] || return 1
+  printf '%s\n' "$candidate"
+}
+
+run_tim_cli() {
+  local tim_cli
+  tim_cli="$(resolve_tim_cli)" || return 1
+  if [[ "$tim_cli" == *.js ]]; then
+    node "$tim_cli" "$@"
+  else
+    "$tim_cli" "$@"
+  fi
+}

package/scripts/post-commit.sh

@@ -0,0 +1,30 @@
+#!/usr/bin/env bash
+# post-commit.sh — Global git post-commit: record commit to TIM Commits section.
+#
+# Walk-up .tim-project via `tim record-commit`. Silent skip when no marker.
+# Must not fail the commit (errors swallowed).
+#
+# Install:
+#   mkdir -p ~/.hermes/git-hooks
+#   ln -sf ~/projects/tim/packages/tim-hooks/scripts/post-commit.sh ~/.hermes/git-hooks/post-commit
+#   git config --global core.hooksPath ~/.hermes/git-hooks
+#
+# Requires: git, node. Override CLI with TIM_CLI.
+set -euo pipefail
+
+SCRIPT_PATH="${BASH_SOURCE[0]}"
+while [[ -L "$SCRIPT_PATH" ]]; do
+  SCRIPT_LINK_DIR="$(cd -P "$(dirname "$SCRIPT_PATH")" && pwd)"
+  SCRIPT_PATH="$(readlink "$SCRIPT_PATH")"
+  [[ "$SCRIPT_PATH" == /* ]] || SCRIPT_PATH="$SCRIPT_LINK_DIR/$SCRIPT_PATH"
+done
+SCRIPT_DIR="$(cd -P "$(dirname "$SCRIPT_PATH")" && pwd)"
+unset SCRIPT_PATH SCRIPT_LINK_DIR
+# shellcheck source=lib/resolve-tim-cli.sh
+source "$SCRIPT_DIR/lib/resolve-tim-cli.sh"
+
+repo_root="$(git rev-parse --show-toplevel 2>/dev/null || true)"
+[[ -z "$repo_root" ]] && exit 0
+
+run_tim_cli record-commit --cwd "$repo_root" >/dev/null 2>&1 || true
+exit 0