@cleocode/cleo 2026.9.7 → 2026.9.10

package/studio-dist/server/chunks/session-journal-Bvey70Ur.js

@@ -1,235 +0,0 @@
-import { q as assertProjectInitialized } from './paths-CV7S5-Zm.js';
-import { join } from 'node:path';
-import { mkdir, appendFile, readdir, readFile, writeFile, unlink } from 'node:fs/promises';
-import 'node:fs';
-import 'node:os';
-import 'node:events';
-import 'node:diagnostics_channel';
-import 'fs';
-import 'events';
-import 'util';
-import 'path';
-import 'assert';
-import 'worker_threads';
-import 'module';
-import 'node:url';
-import 'url';
-import 'buffer';
-import 'node:module';
-import 'node:child_process';
-import 'node:crypto';
-import 'node:process';
-import 'node:async_hooks';
-
-//#region ../core/dist/sessions/session-journal.js
-/**
-* Session Journal — append-only JSONL writer for `.cleo/session-journals/`.
-*
-* Provides the core read/write primitives for the session journal substrate
-* (T1263 PSYCHE E6). Journals are the 7th CLEO system — they log the other
-* six (TASKS, LOOM, BRAIN, NEXUS, CANT, CONDUIT) at session boundaries.
-*
-* ## File layout
-*
-* ```
-* .cleo/session-journals/
-*   2026-04-24.jsonl    ← today — all sessions append here
-*   2026-04-23.jsonl    ← yesterday
-*   ...
-* ```
-*
-* Each file is append-only JSONL (one JSON object per line terminated by `\n`).
-* Multiple simultaneous sessions append to the same daily file safely via
-* `appendFile` which uses O_APPEND — atomic for writes under ~4 KB on ext4/APFS.
-* No shared file handle; each call opens/appends/closes independently.
-*
-* ## Retention
-*
-* | Tier    | Age       | Disposition                               |
-* |---------|-----------|-------------------------------------------|
-* | Hot     | 0–7 days  | All entries retained verbatim             |
-* | Warm    | 8–30 days | Retain `session_end` entries only         |
-* | Archive | 31–90 days| Monthly rollup; individual files deleted  |
-* | Purge   | >90 days  | Monthly rollups deleted                   |
-*
-* @module sessions/session-journal
-* @task T1263
-* @epic T1075
-* @see packages/contracts/src/session-journal.ts — schema + types
-* @see .cleo/adrs/ADR-013 §9 — runtime-data-safety (no git tracking)
-*/
-/** Subdirectory under `.cleo/` that stores session journal JSONL files. */
-var SESSION_JOURNALS_DIR = "session-journals";
-/** Number of hot-tier days (files younger than this are fully retained). */
-var HOT_TIER_DAYS = 7;
-/** Number of warm-tier days (files between hot and warm retain session_end only). */
-var WARM_TIER_DAYS = 30;
-/** Number of archive-tier days (files older than this are purged). */
-var ARCHIVE_TIER_DAYS = 90;
-/**
-* Resolve the absolute path to a session journal JSONL file for a given date.
-*
-* Daily rotation: one file per calendar day. Multiple sessions append to the
-* same file; reads scan recent files in reverse-date order.
-*
-* @param projectRoot - Absolute path to the project root.
-* @param date - Target date. Defaults to today (UTC).
-* @returns Absolute path to `<projectRoot>/.cleo/session-journals/YYYY-MM-DD.jsonl`.
-*
-* @example
-* ```typescript
-* const path = getSessionJournalPath('/my/project');
-* // → '/my/project/.cleo/session-journals/2026-04-24.jsonl'
-* ```
-*/
-function getSessionJournalPath(projectRoot, date) {
-	return join(projectRoot, ".cleo", SESSION_JOURNALS_DIR, `${(date ?? /* @__PURE__ */ new Date()).toISOString().slice(0, 10)}.jsonl`);
-}
-/**
-* Resolve the absolute path to the session-journals directory.
-*
-* @param projectRoot - Absolute path to the project root.
-* @returns Absolute path to `<projectRoot>/.cleo/session-journals/`.
-*/
-function getSessionJournalsDir(projectRoot) {
-	return join(projectRoot, ".cleo", SESSION_JOURNALS_DIR);
-}
-/**
-* Append a single session journal entry to the daily JSONL file.
-*
-* - Creates the `.cleo/session-journals/` directory if it does not exist
-*   (idempotent via `mkdir({recursive:true})`).
-* - Appends a single JSON line terminated by `\n` using O_APPEND atomicity.
-* - Safe for concurrent writes from multiple processes (worktree sessions).
-*
-* @param projectRoot - Absolute path to the project root.
-* @param entry - Journal entry to append. Must pass `sessionJournalEntrySchema`.
-* @param date - Target date file. Defaults to today (UTC).
-*
-* @throws If the filesystem write fails (disk full, permissions, etc.).
-*         Callers MUST wrap in try/catch and handle gracefully — journal
-*         writes must never block session lifecycle operations.
-*
-* @example
-* ```typescript
-* await appendSessionJournalEntry('/my/project', {
-*   schemaVersion: '1.0',
-*   timestamp: new Date().toISOString(),
-*   sessionId: 'ses_20260424_abc',
-*   eventType: 'session_start',
-*   agentIdentifier: 'claude-code',
-*   scope: 'global',
-* });
-* ```
-*/
-async function appendSessionJournalEntry(projectRoot, entry, date) {
-	const filePath = getSessionJournalPath(projectRoot, date);
-	assertProjectInitialized(projectRoot);
-	await mkdir(join(projectRoot, ".cleo", SESSION_JOURNALS_DIR), { recursive: true });
-	await appendFile(filePath, `${JSON.stringify(entry)}\n`, { encoding: "utf-8" });
-}
-/**
-* Read the most recent session journal entries across the N most recent daily files.
-*
-* Scans up to `maxFiles` dated `.jsonl` files in reverse-date order, collecting
-* up to `maxEntries` total entries (most recent entries first). Used by
-* `initProject` to surface recent session context for the meta-agent.
-*
-* Unknown schema versions are silently skipped (forward-compatible).
-*
-* @param projectRoot - Absolute path to the project root.
-* @param maxEntries - Maximum total entries to return. Default: 20.
-* @param maxFiles - Maximum number of daily files to scan. Default: 5.
-* @returns Array of journal entries in reverse-chronological order (newest first).
-*          Returns empty array if the journals directory does not exist or is empty.
-*
-* @example
-* ```typescript
-* const entries = await readRecentJournals('/my/project', 10);
-* ```
-*/
-async function readRecentJournals(projectRoot, maxEntries = 20, maxFiles = 5) {
-	const journalsDir = getSessionJournalsDir(projectRoot);
-	let files;
-	try {
-		files = (await readdir(journalsDir)).filter((f) => f.endsWith(".jsonl") && /^\d{4}-\d{2}-\d{2}\.jsonl$/.test(f)).sort().reverse().slice(0, maxFiles);
-	} catch {
-		return [];
-	}
-	const result = [];
-	for (const file of files) {
-		if (result.length >= maxEntries) break;
-		try {
-			const lines = (await readFile(join(journalsDir, file), "utf-8")).split("\n").filter((line) => line.trim().length > 0).reverse();
-			for (const line of lines) {
-				if (result.length >= maxEntries) break;
-				try {
-					const entry = JSON.parse(line);
-					if (entry && typeof entry === "object" && "schemaVersion" in entry) result.push(entry);
-				} catch {}
-			}
-		} catch {}
-	}
-	return result;
-}
-/**
-* Apply the session journal retention policy to `.cleo/session-journals/`.
-*
-* Tiers (relative to current UTC date):
-*
-* | Tier    | Age       | Action                                              |
-* |---------|-----------|-----------------------------------------------------|
-* | Hot     | 0–7 days  | No-op — all entries retained verbatim               |
-* | Warm    | 8–30 days | Rewrite file keeping only `session_end` entries      |
-* | Archive | 31–90 days| Delete the individual file (rollup future work)      |
-* | Purge   | >90 days  | Delete the file (already archived or stale)          |
-*
-* Errors for individual files are caught and the rotation continues.
-* If the journals directory does not exist, returns immediately (no-op).
-*
-* @param projectRoot - Absolute path to the project root.
-* @param opts - Optional tier cutoff overrides (for testing).
-*
-* @example
-* ```typescript
-* await rotateSessionJournals('/my/project');
-* ```
-*/
-async function rotateSessionJournals(projectRoot, opts = {}) {
-	const hotDays = opts.hotDays ?? HOT_TIER_DAYS;
-	const warmDays = opts.warmDays ?? WARM_TIER_DAYS;
-	const archiveDays = opts.archiveDays ?? ARCHIVE_TIER_DAYS;
-	const journalsDir = getSessionJournalsDir(projectRoot);
-	let files;
-	try {
-		files = (await readdir(journalsDir)).filter((f) => f.endsWith(".jsonl") && /^\d{4}-\d{2}-\d{2}\.jsonl$/.test(f));
-	} catch {
-		return;
-	}
-	const now = Date.now();
-	const MS_PER_DAY = 1440 * 60 * 1e3;
-	for (const file of files) {
-		const filePath = join(journalsDir, file);
-		const dateStr = file.replace(".jsonl", "");
-		const fileDate = /* @__PURE__ */ new Date(`${dateStr}T00:00:00.000Z`);
-		if (Number.isNaN(fileDate.getTime())) continue;
-		const ageDays = (now - fileDate.getTime()) / MS_PER_DAY;
-		try {
-			if (ageDays <= hotDays) {} else if (ageDays <= warmDays) {
-				const lines = (await readFile(filePath, "utf-8")).split("\n").filter((l) => l.trim().length > 0);
-				const filtered = lines.filter((line) => {
-					try {
-						return JSON.parse(line)?.eventType === "session_end";
-					} catch {
-						return false;
-					}
-				});
-				if (filtered.length !== lines.length) await writeFile(filePath, filtered.map((l) => `${l}\n`).join(""), { encoding: "utf-8" });
-			} else if (ageDays <= archiveDays) await unlink(filePath);
-			else await unlink(filePath);
-		} catch {}
-	}
-}
-
-export { appendSessionJournalEntry, readRecentJournals, rotateSessionJournals };
-//# sourceMappingURL=session-journal-Bvey70Ur.js.map

package/studio-dist/server/chunks/session-narrative-BirZINSU.js

@@ -1,304 +0,0 @@
-import { k as getBrainNativeDb } from './sqlite-Bm5LzbPs.js';
-import { isEmbeddingAvailable, embedText } from './brain-embedding-Djw9ekXu.js';
-import './paths-CV7S5-Zm.js';
-import 'node:fs';
-import 'node:path';
-import 'node:os';
-import 'node:events';
-import 'node:diagnostics_channel';
-import 'fs';
-import 'events';
-import 'util';
-import 'path';
-import 'assert';
-import 'worker_threads';
-import 'module';
-import 'node:url';
-import 'url';
-import 'buffer';
-import 'node:module';
-import 'node:child_process';
-import 'node:crypto';
-import 'node:process';
-import 'node:async_hooks';
-import './dual-scope-db-DKnWu1KM.js';
-import './indexes-DZ52grq6.js';
-import './utils-BPSZyajG.js';
-import './query-promise-BkPmGPJy.js';
-import './nexus-sqlite2-BBfY2xnY.js';
-import './nexus-schema2-DP0Qd7CA.js';
-import './chunk-DDP5xfzh.js';
-import './logger-DQIoyZbq.js';
-import 'node:sqlite';
-import './unique-constraint-BZrrwgwc.js';
-import './lock-CA7d6lj7.js';
-import './index-Dtt_h58T.js';
-import 'constants';
-import 'stream';
-
-//#region ../core/dist/memory/session-narrative.js
-/**
-* Rolling Session Narrative — Per-session conversation summary store.
-*
-* Maintains a compact, rolling prose summary of what has happened in a CLEO
-* session.  Each dialectic turn can contribute a `sessionNarrativeDelta` that
-* is appended and compressed into the rolling `narrative` field.
-*
-* ## Storage
-*
-* Data is persisted to the `session_narrative` table in brain.db.  The table
-* is created on first write via `CREATE TABLE IF NOT EXISTS` so the module
-* works safely before the formal ADR-054 Drizzle migration is applied.
-* The Drizzle migration (`20260423000002_t1089-add-session-narrative-table`)
-* generated by `pnpm db:new -- --db brain --task T1089 --name add-session-narrative-table`
-* is the canonical source for the schema; the inline DDL here is a verbatim copy
-* kept for zero-dep startup resilience.
-*
-* ## Schema
-*
-* ```
-* session_narrative (
-*   session_id     TEXT PRIMARY KEY,
-*   narrative      TEXT NOT NULL,       -- Rolling summary, max 2000 chars
-*   turn_count     INTEGER NOT NULL DEFAULT 0,
-*   last_updated_at INTEGER NOT NULL,   -- Unix epoch milliseconds
-*   pivot_count    INTEGER NOT NULL DEFAULT 0
-* )
-* ```
-*
-* ## Pivot Detection
-*
-* `detectPivot(delta, existingNarrative)` uses cosine similarity over text
-* embeddings when the sqlite-vec extension and an embedding provider are both
-* available.  A pivot is signalled when the cosine similarity between the two
-* texts falls below `PIVOT_COSINE_THRESHOLD`.
-*
-* When embeddings are unavailable the function falls back to a keyword-overlap
-* heuristic: a topic shift is detected when the new delta contains fewer than
-* `PIVOT_KEYWORD_OVERLAP_THRESHOLD` of its tokens in the existing narrative.
-*
-* ## PSYCHE Reference
-*
-* Inspired by `upstream psyche-lineage · deriver/deriver.py` (session state
-* derivation) — PSYCHE maintains a rolling representation of what a session
-* "is about" that informs future retrieval and sigil generation.
-*
-* @task T1531
-* @epic T1056
-*/
-/** Maximum character length for the rolling narrative field. */
-var MAX_NARRATIVE_CHARS = 2e3;
-/**
-* Cosine similarity threshold below which a turn is classified as a pivot
-* when embedding-based detection is available (sqlite-vec + embedding provider
-* both loaded).
-*
-* A score of 0.0 means orthogonal vectors (completely unrelated topics);
-* 1.0 means identical direction (same topic).  Empirically, topic shifts
-* tend to produce similarity < 0.3.
-*
-* **Tradeoffs vs keyword fallback**:
-* - Higher accuracy on paraphrase and synonym pivots the keyword heuristic
-*   misses (e.g. "switch to Rust" vs "rewrite in a systems language").
-* - Requires the embedding model to be loaded (~50–80 MB), which adds latency
-*   on first use and is unavailable in cold environments.
-* - The fallback keyword heuristic is zero-cost and always available but
-*   cannot detect pivots expressed through semantically related but
-*   lexically different phrasing.
-*
-* @task T1531
-*/
-var PIVOT_COSINE_THRESHOLD = .3;
-/**
-* Keyword-overlap threshold used by the fallback heuristic when embeddings
-* are unavailable.  When fewer than this fraction of delta keywords appear in
-* the existing narrative, the topic is considered to have shifted.
-*
-* Kept alongside `PIVOT_COSINE_THRESHOLD` so callers and tests can reference
-* both strategies explicitly.
-*/
-var PIVOT_KEYWORD_OVERLAP_THRESHOLD = .5;
-/** Whether the `session_narrative` table has been verified / created. */
-var _tableEnsured = false;
-/**
-* Ensure the `session_narrative` table exists in brain.db.
-*
-* Uses `CREATE TABLE IF NOT EXISTS` so this is idempotent and safe to call
-* multiple times.  After the formal Drizzle migration lands the DDL is
-* redundant but harmless.
-*/
-function ensureTable() {
-	const db = getBrainNativeDb();
-	if (!db) throw new Error("session-narrative: brain.db native handle not available. Call getBrainDb() at startup to initialise the database.");
-	if (!_tableEnsured) {
-		db.exec(`
-      CREATE TABLE IF NOT EXISTS session_narrative (
-        session_id      TEXT PRIMARY KEY,
-        narrative       TEXT NOT NULL DEFAULT '',
-        turn_count      INTEGER NOT NULL DEFAULT 0,
-        last_updated_at INTEGER NOT NULL DEFAULT 0,
-        pivot_count     INTEGER NOT NULL DEFAULT 0
-      );
-    `);
-		_tableEnsured = true;
-	}
-	return db;
-}
-/**
-* Compute the cosine similarity between two Float32 vectors.
-*
-* Returns a value in [-1, 1] where 1 means identical direction and 0 means
-* orthogonal.  Returns 0 when either vector has zero magnitude to avoid
-* division by zero.
-*
-* @param a - First embedding vector.
-* @param b - Second embedding vector (must be same length as `a`).
-* @returns Cosine similarity in [-1, 1].
-*
-* @task T1531
-*/
-function cosineSimilarity(a, b) {
-	let dot = 0;
-	let magA = 0;
-	let magB = 0;
-	for (let i = 0; i < a.length; i++) {
-		dot += (a[i] ?? 0) * (b[i] ?? 0);
-		magA += (a[i] ?? 0) ** 2;
-		magB += (b[i] ?? 0) ** 2;
-	}
-	const denom = Math.sqrt(magA) * Math.sqrt(magB);
-	return denom === 0 ? 0 : dot / denom;
-}
-/**
-* Retrieve the current narrative record for a session.
-*
-* Returns `null` when the session has no narrative entry yet.
-*
-* @param sessionId - The session identifier to look up.
-* @returns The narrative record, or `null` if not found.
-*
-* @example
-* ```ts
-* const record = await getSessionNarrative('ses_20260422131135_5149eb');
-* console.log(record?.narrative ?? '(no narrative yet)');
-* ```
-*
-* @task T1089
-*/
-async function getSessionNarrative(sessionId) {
-	const row = ensureTable().prepare("SELECT session_id, narrative, turn_count, last_updated_at, pivot_count FROM session_narrative WHERE session_id = ?").get(sessionId);
-	if (!row) return null;
-	return {
-		sessionId: row.session_id,
-		narrative: row.narrative,
-		turnCount: row.turn_count,
-		lastUpdatedAt: row.last_updated_at,
-		pivotCount: row.pivot_count
-	};
-}
-/**
-* Append a narrative delta to a session's rolling summary.
-*
-* The delta is prepended with a space separator if the existing narrative is
-* non-empty.  When the combined result exceeds `MAX_NARRATIVE_CHARS` the oldest
-* content is trimmed from the left (keeping the most recent context).
-*
-* Side effect: increments `turn_count` by one and updates `pivot_count` when
-* `detectPivot(delta)` returns `true` against the existing narrative.
-*
-* @param sessionId   - The session to update.
-* @param delta       - New narrative content from the current turn.
-* @param _projectRoot - Project root (reserved for future use; unused now).
-*
-* @example
-* ```ts
-* await appendNarrativeDelta(
-*   'ses_20260422131135_5149eb',
-*   'User requested zero-dep implementation; agent proposed using existing buildRetrievalBundle.',
-*   '/mnt/projects/cleocode',
-* );
-* ```
-*
-* @task T1089
-*/
-async function appendNarrativeDelta(sessionId, delta, _projectRoot) {
-	if (!delta.trim()) return;
-	const db = ensureTable();
-	const now = Date.now();
-	const existing = await getSessionNarrative(sessionId);
-	let newNarrative;
-	let newPivotCount;
-	if (!existing) {
-		newNarrative = delta.slice(0, MAX_NARRATIVE_CHARS);
-		newPivotCount = 0;
-	} else {
-		const isPivot = await detectPivot(delta, existing.narrative);
-		newPivotCount = existing.pivotCount + (isPivot ? 1 : 0);
-		const combined = existing.narrative ? `${existing.narrative} ${delta}` : delta;
-		newNarrative = combined.length <= MAX_NARRATIVE_CHARS ? combined : combined.slice(combined.length - MAX_NARRATIVE_CHARS);
-	}
-	const newTurnCount = (existing?.turnCount ?? 0) + 1;
-	db.prepare(`
-    INSERT INTO session_narrative (session_id, narrative, turn_count, last_updated_at, pivot_count)
-    VALUES (?, ?, ?, ?, ?)
-    ON CONFLICT(session_id) DO UPDATE SET
-      narrative       = excluded.narrative,
-      turn_count      = excluded.turn_count,
-      last_updated_at = excluded.last_updated_at,
-      pivot_count     = excluded.pivot_count
-  `).run(sessionId, newNarrative, newTurnCount, now, newPivotCount);
-}
-/**
-* Detect whether a new narrative delta represents a significant topic pivot.
-*
-* ## Strategy selection
-*
-* **Embedding path** (preferred): when an embedding provider is available
-* (via `isEmbeddingAvailable()`), both `delta` and `existingNarrative` are
-* embedded into float vectors and compared with cosine similarity.  A score
-* below `PIVOT_COSINE_THRESHOLD` (default 0.3) indicates a pivot.  This path
-* catches paraphrase pivots and synonym-based topic changes that the keyword
-* heuristic misses, at the cost of requiring the embedding model to be loaded.
-*
-* **Keyword fallback** (no embedding provider / vec extension): if
-* `embedText()` returns `null` for either input, the function falls back to a
-* keyword-overlap heuristic.  A pivot is declared when fewer than
-* `PIVOT_KEYWORD_OVERLAP_THRESHOLD` (0.5) of the delta's content tokens appear
-* in the existing narrative.
-*
-* Short deltas (< 5 tokens in the keyword path) never trigger a pivot to avoid
-* false positives from acknowledgement messages.  The embedding path has no
-* minimum-length guard because the model handles short inputs gracefully.
-*
-* @param delta            - Incoming narrative text from the new turn.
-* @param existingNarrative - Current rolling narrative content.
-* @returns Promise resolving to `true` when a topic pivot is detected.
-*
-* @example
-* ```ts
-* await detectPivot("switching to Rust implementation", "TypeScript type system discussion"); // true
-* await detectPivot("continuing the TypeScript work", "TypeScript type system discussion");   // false
-* ```
-*
-* @task T1531
-*/
-async function detectPivot(delta, existingNarrative) {
-	if (!existingNarrative.trim()) return false;
-	if (isEmbeddingAvailable()) {
-		const [deltaVec, narrativeVec] = await Promise.all([embedText(delta), embedText(existingNarrative)]);
-		if (deltaVec !== null && narrativeVec !== null) return cosineSimilarity(deltaVec, narrativeVec) < PIVOT_COSINE_THRESHOLD;
-	}
-	const tokenise = (text) => {
-		const tokens = text.toLowerCase().split(/\W+/).filter((t) => t.length >= 4);
-		return new Set(tokens);
-	};
-	const deltaTokens = tokenise(delta);
-	if (deltaTokens.size < 5) return false;
-	const narrativeTokens = tokenise(existingNarrative);
-	let overlap = 0;
-	for (const token of deltaTokens) if (narrativeTokens.has(token)) overlap++;
-	return overlap / deltaTokens.size < PIVOT_KEYWORD_OVERLAP_THRESHOLD;
-}
-
-export { appendNarrativeDelta, getSessionNarrative };
-//# sourceMappingURL=session-narrative-BirZINSU.js.map