Files
waggle-os/packages/hive-mind-cli/src/commands/save-session.ts
Oleg Maslov 0c3e2ead3b
Some checks failed
Installer Smoke / installer-smoke (push) Has been cancelled
moving
2026-09-02 10:10:29 +02:00

100 lines
2.8 KiB
TypeScript

/**
* `hive-mind-cli save-session` — persist a session summary as one or
* more I-Frames. Intended to run from a post-session hook (Stop in
* Claude Code, etc.) where the transcript text is piped in on stdin or
* supplied via --file.
*/
import fs from 'node:fs';
import { openPersonalMind, type CliEnv } from '../setup.js';
import type { Importance } from '@waggle/hive-mind-core';
export interface SaveSessionOptions {
/** Raw session summary text. Takes precedence over `file`. */
text?: string;
/** Path to a file containing the session summary. */
file?: string;
importance?: Importance;
sessionLabel?: string;
env?: CliEnv;
}
export interface SaveSessionResult {
saved: boolean;
frameId?: number;
frameCreatedAt?: string;
characters: number;
reason?: string;
}
const SESSION_LABEL_PREFIX = 'cli:save-session';
function readStdinSync(): string {
try {
// Node's readFileSync with fd=0 reads stdin synchronously. Works when
// the CLI is invoked with a pipe. Returns empty string when stdin is a TTY.
return fs.readFileSync(0, 'utf-8');
} catch {
return '';
}
}
export async function runSaveSession(options: SaveSessionOptions): Promise<SaveSessionResult> {
const env = options.env ?? openPersonalMind();
const close = options.env ? () => { /* caller owns */ } : env.close;
try {
let text = options.text ?? '';
if (!text && options.file) {
try {
text = fs.readFileSync(options.file, 'utf-8');
} catch (err) {
return {
saved: false,
characters: 0,
reason: `Failed to read ${options.file}: ${err instanceof Error ? err.message : String(err)}`,
};
}
}
if (!text && !options.env) {
// Only try stdin when running as a real CLI, not in tests.
text = readStdinSync();
}
const trimmed = text.trim();
if (trimmed.length < 20) {
return {
saved: false,
characters: trimmed.length,
reason: 'Session summary is too short (< 20 chars) — nothing saved',
};
}
const today = new Date().toISOString().slice(0, 10);
const label = options.sessionLabel ?? `${SESSION_LABEL_PREFIX}:${today}`;
const session = env.sessions.ensure(label, undefined, `Saved session summary ${today}`);
const frame = env.frames.createIFrame(
session.gop_id,
trimmed,
options.importance ?? 'normal',
'agent_inferred',
);
// Best-effort vector indexing. Keyword search via FTS5 still works if this fails.
try {
const search = await env.getSearch();
await search.indexFrame(frame.id, trimmed);
} catch { /* non-fatal */ }
return {
saved: true,
frameId: frame.id,
frameCreatedAt: frame.created_at,
characters: trimmed.length,
};
} finally {
close();
}
}