crewly 1.20.356 → 1.20.358

package/dist/backend/backend/src/services/wiki/wiki-log-entries.js

@@ -0,0 +1,222 @@
+/**
+ * The vault activity log (`llm-curated/log.md`) as entries.
+ *
+ * One place that knows the entry format `WikiIngestService` appends:
+ *
+ *   ## [<ISO>] <sourceType> | <caller>
+ *
+ *   ref: <sourceRef>
+ *
+ *   <body>
+ *
+ * Used by search (one document per recent entry), rotation (carry forward
+ * the recent non-noise entries), the digest compiler and the startup
+ * briefing. Also decides what counts as a content-free entry (#1345): a
+ * templated state transition carries nothing a reader could use.
+ *
+ * @module services/wiki/wiki-log-entries
+ */
+import { createHash } from 'crypto';
+import { WIKI_LOG_CONSTANTS } from '../../constants.js';
+/** Header a fresh `log.md` starts with. */
+export const WIKI_LOG_HEADER = '# Activity log\n\nAppend-only log of ingested sources. Each entry: `## [<ISO>] <sourceType> | <caller>`.\n';
+const HEADER_RE = /^## \[([^\]]+)\]\s+(\S+)\s+\|\s+(.+)$/gm;
+/**
+ * Templated records that carry no information for a reader:
+ *  - auto-learning state transitions (`[pattern] [[WorkItem-x]] task:done running→done. timestamp=… Source: …`);
+ *  - the same shape without the category tag;
+ *  - task-completion stubs (`Task completed: …`) that belong on the WorkItem.
+ */
+const NOISE_PATTERNS = [
+    /\[\[(?:WorkItem|Mission)-[^\]]+\]\]\s+(?:task|mission):[a-z_]+\s+\S*\.?\s*(?:team=\S+\s*)?(?:mission=\S+\s*)?(?:resolver=\S+\s*)?timestamp=/i,
+    /^\s*(?:\([a-z_]+\)\s*)?(?:\[[a-z_]+\]\s*)?Task (?:completed|done)(?: by [^:]+)?:\s*\S/i,
+];
+/**
+ * Whether a learning / log body is a content-free templated record.
+ *
+ * @param body - Entry body or learning text
+ * @returns True when the text matches a known templated shape or is blank
+ *
+ * @example
+ * ```typescript
+ * isNoiseLogBody('(learning) [pattern] [[WorkItem-1]] task:done running→done. timestamp=2026-10-17T00:00:00Z. Source: x.'); // true
+ * isNoiseLogBody('(gotcha) complete-task rejects queued→done; accept-task first.'); // false
+ * ```
+ */
+export function isNoiseLogBody(body) {
+    if (!body)
+        return true;
+    const text = body.trim();
+    if (text.length === 0)
+        return true;
+    return NOISE_PATTERNS.some((re) => re.test(text));
+}
+/**
+ * Conversation handover snapshots (`**Conversation handover — <agent> — task <id>** (fact) …`)
+ * that the fresh-conversation path mirrors into the vault. They are state,
+ * not knowledge: a thousand of them a week on one machine. They stay in the
+ * log (the agent is pointed at them) but are not knowledge for search, the
+ * digest, memory or the briefing.
+ *
+ * @param body - Entry body
+ * @returns True for a handover snapshot
+ */
+export function isHandoverLogBody(body) {
+    if (!body)
+        return false;
+    return /^\s*(?:\([a-z_-]+\)\s*)?\*\*Conversation handover\b/i.test(body.trim());
+}
+/**
+ * Normalised form of a body used for duplicate detection: whitespace
+ * collapsed, case folded, trailing punctuation dropped.
+ *
+ * @param body - Entry body
+ * @returns Normalised text
+ */
+export function normalizeLogBody(body) {
+    return body.replace(/\s+/g, ' ').trim().toLowerCase().replace(/[.。]+$/, '');
+}
+/**
+ * Stable key of an entry's content (sha1 of the normalised body). Two
+ * entries with the same body share a key whatever their timestamps.
+ *
+ * @param body - Entry body
+ * @returns 40-char hex digest
+ */
+export function logBodyKey(body) {
+    return createHash('sha1').update(normalizeLogBody(body)).digest('hex');
+}
+/**
+ * Parse a whole `log.md` into entries, in file order. Text before the
+ * first entry header (the preamble, a migrated learnings import) is not an
+ * entry and is dropped.
+ *
+ * @param raw - File content
+ * @returns Entries in file order
+ */
+export function parseLogEntries(raw) {
+    const matches = [];
+    HEADER_RE.lastIndex = 0;
+    let m;
+    while ((m = HEADER_RE.exec(raw))) {
+        matches.push({ idx: m.index, ts: m[1], sourceType: m[2], caller: m[3].trim() });
+    }
+    const entries = [];
+    for (let i = 0; i < matches.length; i++) {
+        const start = matches[i].idx;
+        const end = i + 1 < matches.length ? matches[i + 1].idx : raw.length;
+        const block = raw.slice(start, end);
+        const refMatch = block.match(/^ref:\s*(.+)$/m);
+        let body = '';
+        if (refMatch) {
+            const refLineEnd = block.indexOf(refMatch[0]) + refMatch[0].length;
+            body = block.slice(refLineEnd).replace(/^\n+/, '').trim();
+        }
+        else {
+            // Entries written by hand or migrated: body is everything after the header line.
+            body = block.slice(block.indexOf('\n') + 1).trim();
+        }
+        entries.push({
+            timestamp: matches[i].ts,
+            timestampMs: Date.parse(matches[i].ts),
+            sourceType: matches[i].sourceType,
+            caller: matches[i].caller,
+            ref: refMatch ? refMatch[1].trim() : '',
+            body,
+            raw: block.replace(/\s+$/, ''),
+        });
+    }
+    return entries;
+}
+/**
+ * Serialise an entry back into the append format (leading blank line,
+ * header, ref line, body, trailing blank line).
+ *
+ * @param entry - Entry to serialise
+ * @returns Markdown block
+ */
+export function serializeLogEntry(entry) {
+    return ['', `## [${entry.timestamp}] ${entry.sourceType} | ${entry.caller}`, '', `ref: ${entry.ref}`, '', entry.body, ''].join('\n');
+}
+/**
+ * The entries from the last `days` days that carry content, newest first,
+ * with duplicate bodies collapsed (the newest copy wins). Handover
+ * snapshots are left out unless `includeHandovers` is set (rotation keeps
+ * them; search, digest, memory and briefing do not).
+ *
+ * @param entries - Parsed entries (any order)
+ * @param days - Window length
+ * @param now - Current epoch ms
+ * @param limit - Cap on returned entries
+ * @param options - `includeHandovers` keeps handover snapshots
+ * @returns Recent, non-noise, deduped entries, newest first
+ */
+export function recentContentEntries(entries, days, now = Date.now(), limit = Number.MAX_SAFE_INTEGER, options = {}) {
+    const cutoff = now - days * 24 * 60 * 60 * 1000;
+    const seen = new Set();
+    const out = [];
+    const sorted = [...entries].sort((a, b) => (b.timestampMs || 0) - (a.timestampMs || 0));
+    for (const e of sorted) {
+        if (!Number.isFinite(e.timestampMs) || e.timestampMs < cutoff)
+            continue;
+        if (isNoiseLogBody(e.body))
+            continue;
+        if (!options.includeHandovers && isHandoverLogBody(e.body))
+            continue;
+        const key = logBodyKey(e.body);
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(e);
+        if (out.length >= limit)
+            break;
+    }
+    return out;
+}
+/**
+ * Vault-relative "path" of a log entry as surfaced by search:
+ * `llm-curated/log.md#<ISO timestamp>`.
+ *
+ * @param entry - Entry
+ * @returns Pseudo path
+ */
+export function logEntryPath(entry) {
+    return `${WIKI_LOG_CONSTANTS.LOG_RELATIVE_PATH}${WIKI_LOG_CONSTANTS.ENTRY_PATH_SEPARATOR}${entry.timestamp}`;
+}
+/**
+ * Whether a vault-relative path points at a log entry (as opposed to a page).
+ *
+ * @param relativePath - Path from a search hit
+ * @returns True for `llm-curated/log.md#…`
+ */
+export function isLogEntryPath(relativePath) {
+    return relativePath.startsWith(`${WIKI_LOG_CONSTANTS.LOG_RELATIVE_PATH}${WIKI_LOG_CONSTANTS.ENTRY_PATH_SEPARATOR}`);
+}
+/**
+ * The `(category)` prefix `MemoryService` puts on a mirrored memory
+ * (`(gotcha) …`, `(decision) …`) or the `[tag]` an auto-recorder uses.
+ *
+ * @param body - Entry body
+ * @returns Lower-case category, or 'learning' when none is present
+ */
+export function logEntryCategory(body) {
+    const m = body.match(/^\s*(?:\*\*[^*]+\*\*\s*)?[([]([a-z_-]+)[)\]]/i);
+    return m ? m[1].toLowerCase() : 'learning';
+}
+/**
+ * Topic of an entry for grouping in a digest: the first `[[Entity]]` link,
+ * else a bold `**Title**` lead, else the category.
+ *
+ * @param body - Entry body
+ * @returns Short topic label
+ */
+export function logEntryTopic(body) {
+    const link = body.match(/\[\[([^\]]{1,80})\]\]/);
+    if (link)
+        return link[1].trim();
+    const bold = body.match(/^\s*(?:\([a-z_-]+\)\s*)?\*\*([^*]{1,80})\*\*/i);
+    if (bold)
+        return bold[1].trim();
+    return logEntryCategory(body);
+}
+//# sourceMappingURL=wiki-log-entries.js.map

package/dist/backend/backend/src/services/wiki/wiki-log-entries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-log-entries.js","sourceRoot":"","sources":["../../../../../../backend/src/services/wiki/wiki-log-entries.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAoBxD,2CAA2C;AAC3C,MAAM,CAAC,MAAM,eAAe,GAC1B,4GAA4G,CAAC;AAE/G,MAAM,SAAS,GAAG,yCAAyC,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,cAAc,GAAsB;IACxC,8IAA8I;IAC9I,wFAAwF;CACzF,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,IAA+B;IAC5D,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IACzB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACpD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAA+B;IAC/D,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,OAAO,sDAAsD,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;AAClF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,OAAO,GAA2E,EAAE,CAAC;IAC3F,SAAS,CAAC,SAAS,GAAG,CAAC,CAAC;IACxB,IAAI,CAAyB,CAAC;IAC9B,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QACjC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAClF,CAAC;IACD,MAAM,OAAO,GAAyB,EAAE,CAAC;IACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAC7B,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC;QACrE,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAC/C,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YACnE,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5D,CAAC;aAAM,CAAC;YACN,iFAAiF;YACjF,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACrD,CAAC;QACD,OAAO,CAAC,IAAI,CAAC;YACX,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE;YACxB,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU;YACjC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM;YACzB,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE;YACvC,IAAI;YACJ,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;SAC/B,CAAC,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAuF;IACvH,OAAO,CAAC,EAAE,EAAE,OAAO,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,UAAU,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,KAAK,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACvI,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAsC,EACtC,IAAY,EACZ,MAAc,IAAI,CAAC,GAAG,EAAE,EACxB,QAAgB,MAAM,CAAC,gBAAgB,EACvC,UAA0C,EAAE;IAE5C,MAAM,MAAM,GAAG,GAAG,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAChD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAyB,EAAE,CAAC;IACrC,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC,CAAC;IACxF,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,WAAW,GAAG,MAAM;YAAE,SAAS;QACxE,IAAI,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC;YAAE,SAAS;QACrC,IAAI,CAAC,OAAO,CAAC,gBAAgB,IAAI,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC;YAAE,SAAS;QACrE,MAAM,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACZ,IAAI,GAAG,CAAC,MAAM,IAAI,KAAK;YAAE,MAAM;IACjC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,KAA4C;IACvE,OAAO,GAAG,kBAAkB,CAAC,iBAAiB,GAAG,kBAAkB,CAAC,oBAAoB,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;AAC/G,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,YAAoB;IACjD,OAAO,YAAY,CAAC,UAAU,CAAC,GAAG,kBAAkB,CAAC,iBAAiB,GAAG,kBAAkB,CAAC,oBAAoB,EAAE,CAAC,CAAC;AACtH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACtE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;AAC7C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACjD,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAChC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACzE,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAChC,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC"}

package/dist/backend/backend/src/services/wiki/wiki-log-rotation.service.d.ts

@@ -0,0 +1,93 @@
+/**
+ * WikiLogRotationService — keeps a vault's `llm-curated/log.md` readable.
+ *
+ * The log is append-only and was never rotated: one project vault reached
+ * 19 MB / 150k lines, most of it templated noise (#1345). When a log is
+ * larger than `ROTATE_MAX_BYTES` or holds more than `ROTATE_MAX_ENTRIES`
+ * entries, this service:
+ *
+ *   1. moves the file, unchanged, to `llm-curated/log-archive/log-<date>.md`
+ *      (a second rotation on the same day gets a `-2`, `-3`… suffix);
+ *   2. writes a fresh `log.md` with the standard header and the non-noise,
+ *      deduped entries of the last `CARRY_FORWARD_DAYS` days (capped), so
+ *      search and the digest still see recent learnings.
+ *
+ * Nothing is deleted. `dryRun` reports what would happen without touching
+ * the disk. Walkers skip the archive folder.
+ *
+ * @module services/wiki/wiki-log-rotation.service
+ */
+import { WikiIngestService } from './wiki-ingest.service.js';
+/** Options for {@link WikiLogRotationService.rotate}. */
+export interface WikiLogRotateOptions {
+    /** Report only; write nothing. */
+    dryRun?: boolean;
+    /** Clock (tests). */
+    now?: number;
+    /** Size cap override (tests). */
+    maxBytes?: number;
+    /** Entry-count cap override (tests). */
+    maxEntries?: number;
+}
+/** Outcome of one vault's rotation check. */
+export interface WikiLogRotateResult {
+    vaultPath: string;
+    /** False when the log is missing or under both caps. */
+    rotated: boolean;
+    /** Why nothing happened (when `rotated` is false). */
+    reason?: 'no_log' | 'under_caps';
+    /** Log size before rotation. */
+    bytes: number;
+    /** Entries before rotation. */
+    entries: number;
+    /** Entries carried into the fresh log. */
+    carried: number;
+    /** Vault-relative archive path (set when rotated, or planned in a dry run). */
+    archivePath?: string;
+    dryRun: boolean;
+}
+/**
+ * Rotates oversized vault logs into an archive folder. Stateless singleton.
+ */
+export declare class WikiLogRotationService {
+    private readonly ingest;
+    private static instance;
+    private readonly logger;
+    constructor(ingest?: WikiIngestService);
+    static getInstance(): WikiLogRotationService;
+    /** Test-only reset. */
+    static _resetForTesting(): void;
+    /**
+     * Check one vault's log and rotate it when it is over a cap.
+     *
+     * @param vaultPath - Vault root (must contain `llm-curated/`)
+     * @param opts - Dry run, clock and cap overrides
+     * @returns What happened (or would happen)
+     *
+     * @example
+     * ```typescript
+     * const plan = await WikiLogRotationService.getInstance().rotate(vault, { dryRun: true });
+     * if (plan.rotated) console.log(`would archive ${plan.bytes} bytes to ${plan.archivePath}`);
+     * ```
+     */
+    rotate(vaultPath: string, opts?: WikiLogRotateOptions): Promise<WikiLogRotateResult>;
+    /**
+     * Rotate every vault in a list; failures are logged per vault and never
+     * stop the pass.
+     *
+     * @param vaults - Vault roots
+     * @param opts - Passed to {@link rotate}
+     * @returns One result per vault that was checked
+     */
+    rotateAll(vaults: readonly string[], opts?: WikiLogRotateOptions): Promise<WikiLogRotateResult[]>;
+    /**
+     * Vault-relative archive path for a rotation at `now`: `log-YYYY-MM-DD.md`,
+     * with a numeric suffix when that name is taken.
+     *
+     * @param vaultPath - Vault root
+     * @param now - Epoch ms
+     * @returns Relative path under the archive folder
+     */
+    private archivePathFor;
+}
+//# sourceMappingURL=wiki-log-rotation.service.d.ts.map

package/dist/backend/backend/src/services/wiki/wiki-log-rotation.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-log-rotation.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/wiki/wiki-log-rotation.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAQH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,yDAAyD;AACzD,MAAM,WAAW,oBAAoB;IACnC,kCAAkC;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qBAAqB;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,OAAO,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,MAAM,CAAC,EAAE,QAAQ,GAAG,YAAY,CAAC;IACjC,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,sBAAsB;IAIrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAuC;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;gBAEZ,MAAM,GAAE,iBAAmD;IAIxF,MAAM,CAAC,WAAW,IAAI,sBAAsB;IAK5C,uBAAuB;IACvB,MAAM,CAAC,gBAAgB,IAAI,IAAI;IAI/B;;;;;;;;;;;;OAYG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,oBAAyB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAgD9F;;;;;;;OAOG;IACG,SAAS,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,GAAE,oBAAyB,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAY3G;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;CAQvB"}

package/dist/backend/backend/src/services/wiki/wiki-log-rotation.service.js

@@ -0,0 +1,142 @@
+/**
+ * WikiLogRotationService — keeps a vault's `llm-curated/log.md` readable.
+ *
+ * The log is append-only and was never rotated: one project vault reached
+ * 19 MB / 150k lines, most of it templated noise (#1345). When a log is
+ * larger than `ROTATE_MAX_BYTES` or holds more than `ROTATE_MAX_ENTRIES`
+ * entries, this service:
+ *
+ *   1. moves the file, unchanged, to `llm-curated/log-archive/log-<date>.md`
+ *      (a second rotation on the same day gets a `-2`, `-3`… suffix);
+ *   2. writes a fresh `log.md` with the standard header and the non-noise,
+ *      deduped entries of the last `CARRY_FORWARD_DAYS` days (capped), so
+ *      search and the digest still see recent learnings.
+ *
+ * Nothing is deleted. `dryRun` reports what would happen without touching
+ * the disk. Walkers skip the archive folder.
+ *
+ * @module services/wiki/wiki-log-rotation.service
+ */
+import * as path from 'path';
+import * as fs from 'fs/promises';
+import { existsSync } from 'fs';
+import { LoggerService } from '../core/logger.service.js';
+import { WIKI_LOG_CONSTANTS } from '../../constants.js';
+import { WIKI_LOG_HEADER, parseLogEntries, recentContentEntries, serializeLogEntry } from './wiki-log-entries.js';
+import { WikiIngestService } from './wiki-ingest.service.js';
+/**
+ * Rotates oversized vault logs into an archive folder. Stateless singleton.
+ */
+export class WikiLogRotationService {
+    ingest;
+    static instance = null;
+    logger;
+    constructor(ingest = WikiIngestService.getInstance()) {
+        this.ingest = ingest;
+        this.logger = LoggerService.getInstance().createComponentLogger('WikiLogRotation');
+    }
+    static getInstance() {
+        if (!this.instance)
+            this.instance = new WikiLogRotationService();
+        return this.instance;
+    }
+    /** Test-only reset. */
+    static _resetForTesting() {
+        this.instance = null;
+    }
+    /**
+     * Check one vault's log and rotate it when it is over a cap.
+     *
+     * @param vaultPath - Vault root (must contain `llm-curated/`)
+     * @param opts - Dry run, clock and cap overrides
+     * @returns What happened (or would happen)
+     *
+     * @example
+     * ```typescript
+     * const plan = await WikiLogRotationService.getInstance().rotate(vault, { dryRun: true });
+     * if (plan.rotated) console.log(`would archive ${plan.bytes} bytes to ${plan.archivePath}`);
+     * ```
+     */
+    async rotate(vaultPath, opts = {}) {
+        const dryRun = opts.dryRun === true;
+        const now = opts.now ?? Date.now();
+        const maxBytes = opts.maxBytes ?? WIKI_LOG_CONSTANTS.ROTATE_MAX_BYTES;
+        const maxEntries = opts.maxEntries ?? WIKI_LOG_CONSTANTS.ROTATE_MAX_ENTRIES;
+        const logAbs = path.join(vaultPath, WIKI_LOG_CONSTANTS.LOG_RELATIVE_PATH);
+        const base = { vaultPath, rotated: false, bytes: 0, entries: 0, carried: 0, dryRun };
+        let size;
+        try {
+            size = (await fs.stat(logAbs)).size;
+        }
+        catch {
+            return { ...base, reason: 'no_log' };
+        }
+        base.bytes = size;
+        const raw = await fs.readFile(logAbs, 'utf8');
+        const entries = parseLogEntries(raw);
+        base.entries = entries.length;
+        if (size <= maxBytes && entries.length <= maxEntries)
+            return { ...base, reason: 'under_caps' };
+        // Handover snapshots are carried: an agent may still be pointed at one.
+        const carried = recentContentEntries(entries, WIKI_LOG_CONSTANTS.CARRY_FORWARD_DAYS, now, WIKI_LOG_CONSTANTS.CARRY_FORWARD_MAX_ENTRIES, { includeHandovers: true })
+            // Oldest first in the fresh file, like any log.
+            .sort((a, b) => a.timestampMs - b.timestampMs);
+        const archiveRel = this.archivePathFor(vaultPath, now);
+        const result = { ...base, rotated: true, carried: carried.length, archivePath: archiveRel };
+        if (dryRun) {
+            this.logger.info('WikiLogRotation dry run — would rotate', { vaultPath, bytes: size, entries: base.entries, carried: carried.length, archivePath: archiveRel });
+            return result;
+        }
+        const archiveAbs = path.join(vaultPath, archiveRel);
+        await fs.mkdir(path.dirname(archiveAbs), { recursive: true });
+        // Move first (atomic on one filesystem), then write the fresh log. A
+        // crash in between leaves no log.md, which the next append recreates;
+        // nothing is lost because the archive already holds everything.
+        await fs.rename(logAbs, archiveAbs);
+        const fresh = WIKI_LOG_HEADER + `\n<!-- rotated ${new Date(now).toISOString()}: ${base.entries} entries archived to ${archiveRel}; ${carried.length} recent entries carried forward -->\n` + carried.map((e) => serializeLogEntry(e)).join('');
+        const tmp = `${logAbs}.tmp`;
+        await fs.writeFile(tmp, fresh, 'utf8');
+        await fs.rename(tmp, logAbs);
+        this.ingest.forgetRecentBodies(logAbs);
+        this.logger.info('WikiLogRotation rotated log', { vaultPath, bytes: size, entries: base.entries, carried: carried.length, archivePath: archiveRel });
+        return result;
+    }
+    /**
+     * Rotate every vault in a list; failures are logged per vault and never
+     * stop the pass.
+     *
+     * @param vaults - Vault roots
+     * @param opts - Passed to {@link rotate}
+     * @returns One result per vault that was checked
+     */
+    async rotateAll(vaults, opts = {}) {
+        const out = [];
+        for (const vaultPath of vaults) {
+            try {
+                out.push(await this.rotate(vaultPath, opts));
+            }
+            catch (err) {
+                this.logger.warn('WikiLogRotation failed for vault (non-fatal)', { vaultPath, error: err instanceof Error ? err.message : String(err) });
+            }
+        }
+        return out;
+    }
+    /**
+     * Vault-relative archive path for a rotation at `now`: `log-YYYY-MM-DD.md`,
+     * with a numeric suffix when that name is taken.
+     *
+     * @param vaultPath - Vault root
+     * @param now - Epoch ms
+     * @returns Relative path under the archive folder
+     */
+    archivePathFor(vaultPath, now) {
+        const day = new Date(now).toISOString().slice(0, 10);
+        for (let n = 1;; n++) {
+            const name = n === 1 ? `log-${day}.md` : `log-${day}-${n}.md`;
+            const rel = `${WIKI_LOG_CONSTANTS.ARCHIVE_DIR}/${name}`;
+            if (!existsSync(path.join(vaultPath, rel)))
+                return rel;
+        }
+    }
+}
+//# sourceMappingURL=wiki-log-rotation.service.js.map

package/dist/backend/backend/src/services/wiki/wiki-log-rotation.service.js.map

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

package/dist/backend/backend/src/services/wiki/wiki-maintenance.service.d.ts

@@ -0,0 +1,104 @@
+/**
+ * WikiMaintenanceService — the scheduler behind log hygiene (#1345).
+ *
+ * One hourly tick:
+ *   - every tick: a queue drain pass ({@link WikiQueueDrainService});
+ *   - once per day (and on the first tick after boot when the last daily
+ *     pass is older than a day): log rotation then digest compile for every
+ *     discovered vault.
+ *
+ * The first tick runs `MAINTENANCE_BOOT_DELAY_MS` after `start()` so boot
+ * I/O settles first. State (last daily pass) lives in
+ * `CREWLY_HOME/wiki-maintenance-state.json`. `CREWLY_WIKI_MAINTENANCE=false`
+ * disables the whole thing. Every step is non-fatal and logged.
+ *
+ * @module services/wiki/wiki-maintenance.service
+ */
+import { WikiLogRotationService, type WikiLogRotateResult } from './wiki-log-rotation.service.js';
+import { WikiLogCompileService, type WikiLogCompileResult } from './wiki-log-compile.service.js';
+import { WikiQueueDrainService, type WikiQueueDrainResult } from './wiki-queue-drain.service.js';
+/** Options for {@link WikiMaintenanceService}. */
+export interface WikiMaintenanceOptions {
+    /** Tick interval (default hourly). */
+    intervalMs?: number;
+    /** Gap between daily passes (default 24 h). */
+    dailyMs?: number;
+    /** Delay before the first tick (default 90 s; 0 = immediate). */
+    bootDelayMs?: number;
+    /** State file (default under CREWLY_HOME). `null` keeps state in memory (tests). */
+    statePath?: string | null;
+    /** Vault discovery override (tests). */
+    discoverRoots?: () => Promise<string[]>;
+    /** Service overrides (tests). */
+    rotation?: WikiLogRotationService;
+    compile?: WikiLogCompileService;
+    drain?: WikiQueueDrainService;
+    /** Clock (tests). */
+    now?: () => number;
+    /** Dry run: every step reports and writes nothing. */
+    dryRun?: boolean;
+}
+/** Outcome of one tick. */
+export interface WikiMaintenanceTickResult {
+    drain: WikiQueueDrainResult | null;
+    /** Set when the daily pass ran this tick. */
+    daily?: {
+        vaults: string[];
+        rotated: WikiLogRotateResult[];
+        compiled: WikiLogCompileResult[];
+    };
+    skippedDaily?: 'not_due';
+}
+/**
+ * Hourly wiki maintenance scheduler. Start at boot, stop at shutdown.
+ */
+export declare class WikiMaintenanceService {
+    private static instance;
+    private readonly logger;
+    private readonly intervalMs;
+    private readonly dailyMs;
+    private readonly bootDelayMs;
+    private readonly statePath;
+    private readonly discoverRoots;
+    private readonly rotation;
+    private readonly compile;
+    private readonly drain;
+    private readonly nowFn;
+    private readonly dryRun;
+    private timer;
+    private bootTimer;
+    private running;
+    private state;
+    private stateLoaded;
+    constructor(opts?: WikiMaintenanceOptions);
+    static getInstance(): WikiMaintenanceService | null;
+    /** Wire / detach the production singleton. */
+    static setInstance(next: WikiMaintenanceService | null): void;
+    /**
+     * Begin ticking. Idempotent. Returns false when the kill switch is set.
+     *
+     * @returns Whether the scheduler started
+     */
+    start(): boolean;
+    /** Stop ticking. Safe to call more than once. */
+    stop(): void;
+    /**
+     * Whether the daily pass is due.
+     *
+     * @returns True when no daily pass is recorded or it is older than `dailyMs`
+     */
+    isDailyDue(): boolean;
+    /**
+     * One tick: drain, then the daily pass when due. Public for tests and
+     * an on-demand run.
+     *
+     * @param opts - `force` runs the daily pass whether or not it is due
+     * @returns What ran
+     */
+    tick(opts?: {
+        force?: boolean;
+    }): Promise<WikiMaintenanceTickResult>;
+    private loadState;
+    private saveState;
+}
+//# sourceMappingURL=wiki-maintenance.service.d.ts.map

package/dist/backend/backend/src/services/wiki/wiki-maintenance.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-maintenance.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/wiki/wiki-maintenance.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAQH,OAAO,EAAE,sBAAsB,EAAE,KAAK,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAClG,OAAO,EAAE,qBAAqB,EAAE,KAAK,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACjG,OAAO,EAAE,qBAAqB,EAAE,KAAK,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAQjG,kDAAkD;AAClD,MAAM,WAAW,sBAAsB;IACrC,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,wCAAwC;IACxC,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACxC,iCAAiC;IACjC,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAClC,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B,qBAAqB;IACrB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,sDAAsD;IACtD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,2BAA2B;AAC3B,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACnC,6CAA6C;IAC7C,KAAK,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,mBAAmB,EAAE,CAAC;QAAC,QAAQ,EAAE,oBAAoB,EAAE,CAAA;KAAE,CAAC;IAC/F,YAAY,CAAC,EAAE,SAAS,CAAC;CAC1B;AAED;;GAEG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAuC;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA0B;IACxD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwB;IAC9C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAA2C;IACxD,OAAO,CAAC,WAAW,CAAS;gBAEhB,IAAI,GAAE,sBAA2B;IAc7C,MAAM,CAAC,WAAW,IAAI,sBAAsB,GAAG,IAAI;IAInD,8CAA8C;IAC9C,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,sBAAsB,GAAG,IAAI,GAAG,IAAI;IAK7D;;;;OAIG;IACH,KAAK,IAAI,OAAO;IAiBhB,iDAAiD;IACjD,IAAI,IAAI,IAAI;IAYZ;;;;OAIG;IACH,UAAU,IAAI,OAAO;IAMrB;;;;;;OAMG;IACG,IAAI,CAAC,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,yBAAyB,CAAC;YA2ChE,SAAS;YAYT,SAAS;CASxB"}