lifeos 1.0.0

package/dist/services/capture.js

@@ -0,0 +1,297 @@
+/**
+ * capture.ts — 捕获服务。
+ *
+ * Handles event logging, file change notifications, auto-capture,
+ * and session bridge helpers.
+ */
+import { createHash, randomUUID } from 'node:crypto';
+import { relative } from 'node:path';
+import { ENTRY_TYPE_LABELS, KEY_ENTRY_TYPES, daysAgo } from '../types.js';
+import { buildSearchTokens } from '../utils/segmenter.js';
+import { inferTemporaryPreference, normalizeRuleSummary, parseDetailObject, resolveRuleKey, resolveSessionId, } from '../utils/shared.js';
+import { indexSingleFile } from '../utils/vault-indexer.js';
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+/**
+ * Build a 16-char entry hash from entry type, summary, and normalized detail.
+ */
+function buildEntryHash(entryType, summary, normalizedDetail) {
+    const raw = `${entryType}:${summary}:${normalizedDetail}`;
+    return createHash('sha256').update(raw, 'utf-8').digest('hex').slice(0, 16);
+}
+/**
+ * Normalize detail for rule events (decision/correction/preference).
+ * Adds content, normalized_summary, rule_key, structured_by fields.
+ * For preferences, also adds temporary inference fields.
+ */
+function normalizeRuleEventDetail(entryType, summary, rawDetail) {
+    const detailObj = parseDetailObject(rawDetail);
+    const normalizedSummary = normalizeRuleSummary(summary);
+    const ruleKey = resolveRuleKey(entryType, summary, detailObj);
+    const normalized = {
+        ...detailObj,
+        content: rawDetail ?? summary,
+        normalized_summary: normalizedSummary,
+        rule_key: ruleKey,
+        structured_by: 'service_v05',
+    };
+    // For preference events, infer temporary status
+    if (entryType === 'preference') {
+        const tempResult = inferTemporaryPreference(summary, detailObj);
+        normalized.temporary = tempResult.temporary;
+        if (tempResult.expiresInDays != null) {
+            normalized.expires_in_days = tempResult.expiresInDays;
+        }
+        if (tempResult.expiresAt != null) {
+            normalized.expires_at = tempResult.expiresAt;
+        }
+        if (tempResult.temporarySource != null) {
+            normalized.temporary_source = tempResult.temporarySource;
+        }
+    }
+    return { detailStr: JSON.stringify(normalized), ruleKey };
+}
+/**
+ * Find the latest event_id with the given rule_key (excluding superseded ones).
+ */
+function findLatestByRuleKey(db, ruleKey, excludeEventId) {
+    let sql = `
+    SELECT event_id FROM session_log
+    WHERE rule_key = ?
+  `;
+    const params = [ruleKey];
+    if (excludeEventId) {
+        sql += ' AND event_id != ?';
+        params.push(excludeEventId);
+    }
+    sql += ' ORDER BY timestamp DESC LIMIT 1';
+    const row = db.prepare(sql).get(params);
+    return row ? row.event_id : null;
+}
+// ─── logEvent ─────────────────────────────────────────────────────────────────
+/**
+ * Log a single event into session_log.
+ * Handles detail normalization for rule events and auto-supersedes.
+ */
+export function logEvent(db, opts) {
+    const { entryType, importance, summary, scope, sessionId, skillName, sourceRefs, relatedFiles, relatedEntities, supersedes: explicitSupersedes, } = opts;
+    const resolvedSessionId = resolveSessionId(sessionId);
+    const eventId = randomUUID();
+    const timestamp = new Date().toISOString();
+    // Normalize detail and resolve rule_key for rule events
+    let finalDetail = opts.detail ?? null;
+    let ruleKey = null;
+    if (KEY_ENTRY_TYPES.has(entryType)) {
+        const normalized = normalizeRuleEventDetail(entryType, summary, opts.detail);
+        finalDetail = normalized.detailStr;
+        ruleKey = normalized.ruleKey;
+    }
+    // Build entry hash
+    const entryHash = buildEntryHash(entryType, summary, finalDetail ?? '');
+    // Build search hints
+    const searchHints = buildSearchTokens(summary, finalDetail, relatedEntities ?? null, scope ?? null);
+    // Serialize arrays
+    const sourceRefsJson = sourceRefs ? JSON.stringify(sourceRefs) : null;
+    const relatedFilesJson = relatedFiles ? JSON.stringify(relatedFiles) : null;
+    const relatedEntitiesJson = relatedEntities ? JSON.stringify(relatedEntities) : null;
+    // Auto-supersede: find latest event with same rule_key
+    let supersedesId = explicitSupersedes ?? null;
+    if (!supersedesId && ruleKey) {
+        supersedesId = findLatestByRuleKey(db, ruleKey, eventId);
+    }
+    db.prepare(`
+    INSERT INTO session_log
+    (event_id, session_id, timestamp, entry_type, importance, scope, skill_name,
+     summary, detail, source_refs, related_files, related_entities,
+     supersedes, entry_hash, search_hints, rule_key)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(eventId, resolvedSessionId, timestamp, entryType, importance, scope ?? null, skillName ?? null, summary, finalDetail, sourceRefsJson, relatedFilesJson, relatedEntitiesJson, supersedesId, entryHash, searchHints, ruleKey);
+    return { eventId, timestamp, status: 'ok' };
+}
+// ─── autoCaptureEvents ────────────────────────────────────────────────────────
+/** Default importance per bucket type */
+const BUCKET_IMPORTANCE = {
+    correction: 4,
+    decision: 4,
+    preference: 3,
+};
+/**
+ * Batch capture corrections/decisions/preferences.
+ * Deduplicates by entry_hash across both existing DB records and current batch.
+ */
+export function autoCaptureEvents(db, payload, sessionId) {
+    const buckets = [
+        { entryType: 'correction', items: payload.corrections ?? [] },
+        { entryType: 'decision', items: payload.decisions ?? [] },
+        { entryType: 'preference', items: payload.preferences ?? [] },
+    ];
+    const captured = [];
+    // Track hashes seen in this batch to deduplicate within the same call
+    const batchHashes = new Set();
+    for (const { entryType, items } of buckets) {
+        for (const item of items) {
+            const summary = (item.summary ?? '').trim();
+            if (!summary)
+                continue;
+            const importance = item.importance ?? BUCKET_IMPORTANCE[entryType] ?? 3;
+            // Pre-compute the hash to check for duplicates
+            // For rule events, detail gets normalized — compute approximate hash
+            let previewDetail = item.detail ?? null;
+            if (KEY_ENTRY_TYPES.has(entryType)) {
+                const normalized = normalizeRuleEventDetail(entryType, summary, previewDetail);
+                previewDetail = normalized.detailStr;
+            }
+            const hash = buildEntryHash(entryType, summary, previewDetail ?? '');
+            // Skip if already seen in this batch
+            if (batchHashes.has(hash))
+                continue;
+            batchHashes.add(hash);
+            // Skip if already exists in DB
+            const existing = db
+                .prepare('SELECT event_id FROM session_log WHERE entry_hash = ? LIMIT 1')
+                .get([hash]);
+            if (existing)
+                continue;
+            const result = logEvent(db, {
+                entryType,
+                importance,
+                summary,
+                detail: item.detail,
+                scope: item.scope,
+                relatedFiles: item.relatedFiles,
+                sessionId,
+            });
+            captured.push({ eventId: result.eventId, entryType, summary });
+        }
+    }
+    return { capturedCount: captured.length, events: captured };
+}
+/**
+ * Notify the system that a file has changed.
+ * Re-indexes the file and updates the enhance queue if applicable.
+ */
+export function notifyFileChanged(db, vaultRoot, filePath) {
+    // Normalize to relative path
+    const relPath = filePath.startsWith(vaultRoot)
+        ? relative(vaultRoot, filePath).replace(/\\/g, '/')
+        : filePath.replace(/\\/g, '/');
+    let indexResult;
+    try {
+        const dbPath = db.name; // better-sqlite3 exposes .name as the db file path
+        indexResult = indexSingleFile(vaultRoot, dbPath, relPath);
+    }
+    catch {
+        return { action: 'error', filePath: relPath };
+    }
+    if (indexResult.status === 'removed' || indexResult.status === 'skipped') {
+        // Remove from enhance queue if present
+        db.prepare('DELETE FROM enhance_queue WHERE file_path = ?').run(relPath);
+        return { action: indexResult.status, filePath: relPath };
+    }
+    // File was indexed — check if it should be queued for enhancement
+    if (indexResult.status === 'indexed') {
+        try {
+            // Check if file is already pending in enhance queue
+            const existing = db
+                .prepare("SELECT file_path FROM enhance_queue WHERE file_path = ? AND status = 'pending'")
+                .get([relPath]);
+            if (!existing) {
+                const now = new Date().toISOString();
+                db.prepare(`
+          INSERT OR REPLACE INTO enhance_queue
+          (file_path, priority, queued_at, source, status, attempts)
+          VALUES (?, ?, ?, 'notify', 'pending', 0)
+        `).run(relPath, 5, now);
+            }
+        }
+        catch (e) {
+            console.warn('[lifeos] enhance queue update failed:', e);
+        }
+        return { action: 'indexed', filePath: relPath };
+    }
+    return { action: 'unchanged', filePath: relPath };
+}
+// ─── latestSessionBridge ─────────────────────────────────────────────────────
+/**
+ * Query the most recent session_bridge event.
+ * Optionally filter by session_id.
+ */
+export function latestSessionBridge(db, sessionId) {
+    let sql = `
+    SELECT event_id, session_id, summary, detail, timestamp
+    FROM session_log
+    WHERE entry_type = 'session_bridge'
+  `;
+    const params = [];
+    if (sessionId) {
+        sql += ' AND session_id = ?';
+        params.push(sessionId);
+    }
+    sql += ' ORDER BY timestamp DESC LIMIT 1';
+    const row = db.prepare(sql).get(params);
+    if (!row)
+        return null;
+    return {
+        eventId: row.event_id,
+        sessionId: row.session_id,
+        summary: row.summary,
+        detail: row.detail,
+        timestamp: row.timestamp,
+    };
+}
+// ─── collectSessionBridgeSeedEvents ──────────────────────────────────────────
+/**
+ * Collect the most recent key events for a session to use as bridge seeds.
+ * Returns decisions, corrections, milestones, and skill_completions.
+ */
+export function collectSessionBridgeSeedEvents(db, sessionId, limit = 10) {
+    const sql = `
+    SELECT entry_type, summary, importance
+    FROM session_log
+    WHERE session_id = ?
+      AND entry_type IN ('decision', 'correction', 'preference', 'milestone', 'skill_completion')
+    ORDER BY importance DESC, timestamp DESC
+    LIMIT ?
+  `;
+    const rows = db.prepare(sql).all([sessionId, limit]);
+    return rows.map((r) => ({
+        entryType: r.entry_type,
+        summary: r.summary,
+        importance: r.importance,
+    }));
+}
+// ─── buildAutoSessionBridge ───────────────────────────────────────────────────
+/**
+ * Generate a bridge text summary from a list of seed events.
+ * Used to create session_bridge entries that persist context across sessions.
+ */
+export function buildAutoSessionBridge(events) {
+    if (events.length === 0) {
+        return '上次会话无关键事件记录。';
+    }
+    const lines = ['上次会话关键事件：'];
+    for (const event of events) {
+        const label = ENTRY_TYPE_LABELS[event.entryType] ?? event.entryType;
+        lines.push(`- [${label}] ${event.summary}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Scan for files in the vault that have been modified in the last 24 hours.
+ * Uses the vault_index table modified_at field.
+ */
+export function scanRecentlyModifiedFiles(db, _vaultRoot) {
+    const cutoff = daysAgo(1);
+    const rows = db
+        .prepare(`
+      SELECT file_path, modified_at
+      FROM vault_index
+      WHERE modified_at >= ?
+      ORDER BY modified_at DESC
+    `)
+        .all([cutoff]);
+    return rows.map((r) => ({
+        filePath: r.file_path,
+        modifiedAt: r.modified_at,
+    }));
+}
+//# sourceMappingURL=capture.js.map

package/dist/services/capture.js.map

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

package/dist/services/enhance.d.ts

@@ -0,0 +1,51 @@
+/**
+ * enhance.ts — 增强服务。
+ *
+ * Processes the enhance queue: generates semantic summaries and enhanced
+ * search terms for indexed vault files.
+ */
+import type Database from 'better-sqlite3';
+import type { VaultIndexRow } from '../types.js';
+/**
+ * Generate a natural language description of a vault_index record.
+ * Used to populate the semantic_summary column.
+ */
+export declare function generateSemanticSummary(record: VaultIndexRow): string;
+/**
+ * Add a file to the enhance queue.
+ * If the file is already queued with a higher priority, it is skipped.
+ */
+export declare function queueFileForEnhance(db: Database.Database, filePath: string, priority: number, source: string, now?: Date | string | null): void;
+/**
+ * Return the first matching enhance priority for a file path,
+ * checking each prefix in the enhancePriority map in insertion order.
+ * Returns null if no prefix matches.
+ */
+export declare function matchEnhancePriority(filePath: string, enhancePriority: Record<string, number>): number | null;
+/**
+ * Queue a list of changed file paths for enhancement, using the configured
+ * priority map. Files with no matching prefix are skipped.
+ * Returns the number of files actually queued.
+ */
+export declare function enqueueChangedPathsForEnhance(db: Database.Database, changedPaths: string[], enhancePriority: Record<string, number>, now?: Date | string | null): number;
+/**
+ * Generate enhanced search term tokens for a vault_index record.
+ * Combines title, aliases, domain, type, status, section heads, and summary
+ * into a deduplicated list of tokens via the segmenter.
+ */
+export declare function generateEnhancedSearchTerms(record: VaultIndexRow): string[];
+/**
+ * Merge base search hints (JSON array or raw string) with extra terms,
+ * deduplicating while preserving insertion order.
+ * Returns a JSON array string.
+ */
+export declare function mergeSearchHints(baseHints: string | string[] | null | undefined, extraTerms: string[]): string;
+/**
+ * Process up to `limit` pending items from the enhance queue.
+ * For each item, generates semantic summary and enhanced search hints,
+ * then marks the item as done (or error on failure).
+ */
+export declare function processEnhanceQueue(db: Database.Database, _vaultRoot: string, limit?: number): {
+    processed: number;
+    errors: number;
+};

package/dist/services/enhance.js

@@ -0,0 +1,184 @@
+/**
+ * enhance.ts — 增强服务。
+ *
+ * Processes the enhance queue: generates semantic summaries and enhanced
+ * search terms for indexed vault files.
+ */
+import { queryOne } from '../db/index.js';
+import { ENHANCE_STATUS_LABELS, NOTE_TYPE_LABELS } from '../types.js';
+import { tokenize } from '../utils/segmenter.js';
+import { coerceNow, loadsJsonList, normalizeWikilinkValue } from '../utils/shared.js';
+// ─── generateSemanticSummary ──────────────────────────────────────────────────
+/**
+ * Generate a natural language description of a vault_index record.
+ * Used to populate the semantic_summary column.
+ */
+export function generateSemanticSummary(record) {
+    const title = String(record.title ?? '').trim();
+    const noteType = String(record.type ?? '').trim();
+    const domain = normalizeWikilinkValue(record.domain);
+    const status = String(record.status ?? '').trim();
+    const summary = String(record.summary ?? '')
+        .trim()
+        .replace(/\n/g, ' ');
+    const subject = title || '该条目';
+    let s1 = `${subject}是一份${NOTE_TYPE_LABELS[noteType] ?? '笔记'}`;
+    if (domain)
+        s1 += `，主要关联 ${domain} 领域`;
+    s1 += '。';
+    let s2 = ENHANCE_STATUS_LABELS[status] ? `当前状态为${ENHANCE_STATUS_LABELS[status]}` : '';
+    if (summary && !s2)
+        s2 = summary.slice(0, 48);
+    if (s2 && !s2.endsWith('。'))
+        s2 += '。';
+    return `${s1}${s2}`.trim() || `${subject}是一条待补充增强摘要的记忆条目。`;
+}
+// ─── queueFileForEnhance ──────────────────────────────────────────────────────
+/**
+ * Add a file to the enhance queue.
+ * If the file is already queued with a higher priority, it is skipped.
+ */
+export function queueFileForEnhance(db, filePath, priority, source, now) {
+    const queuedAt = coerceNow(now).toISOString();
+    const existing = db
+        .prepare('SELECT priority FROM enhance_queue WHERE file_path = ?')
+        .get(filePath);
+    if (existing && existing.priority > priority)
+        return;
+    db.prepare(`
+    INSERT OR REPLACE INTO enhance_queue
+    (file_path, priority, queued_at, source, status, attempts, last_attempt_at, error_message)
+    VALUES (?, ?, ?, ?, 'pending', 0, NULL, NULL)
+  `).run(filePath, priority, queuedAt, source);
+}
+// ─── matchEnhancePriority ─────────────────────────────────────────────────────
+/**
+ * Return the first matching enhance priority for a file path,
+ * checking each prefix in the enhancePriority map in insertion order.
+ * Returns null if no prefix matches.
+ */
+export function matchEnhancePriority(filePath, enhancePriority) {
+    for (const [prefix, priority] of Object.entries(enhancePriority)) {
+        if (filePath.startsWith(prefix))
+            return priority;
+    }
+    return null;
+}
+// ─── enqueueChangedPathsForEnhance ────────────────────────────────────────────
+/**
+ * Queue a list of changed file paths for enhancement, using the configured
+ * priority map. Files with no matching prefix are skipped.
+ * Returns the number of files actually queued.
+ */
+export function enqueueChangedPathsForEnhance(db, changedPaths, enhancePriority, now) {
+    let queued = 0;
+    for (const fp of changedPaths) {
+        const priority = matchEnhancePriority(fp, enhancePriority);
+        if (priority === null)
+            continue;
+        queueFileForEnhance(db, fp, priority, 'startup_scan', now);
+        queued++;
+    }
+    return queued;
+}
+// ─── generateEnhancedSearchTerms ─────────────────────────────────────────────
+/**
+ * Generate enhanced search term tokens for a vault_index record.
+ * Combines title, aliases, domain, type, status, section heads, and summary
+ * into a deduplicated list of tokens via the segmenter.
+ */
+export function generateEnhancedSearchTerms(record) {
+    const extras = [];
+    const title = String(record.title ?? '').trim();
+    const noteType = String(record.type ?? '').trim();
+    const status = String(record.status ?? '').trim();
+    const domain = normalizeWikilinkValue(record.domain);
+    const aliases = loadsJsonList(record.aliases);
+    const sectionHeads = loadsJsonList(record.section_heads)
+        .map((h) => h.replace(/^#{1,6}\s*/, '').trim())
+        .filter(Boolean);
+    const summary = String(record.summary ?? '').trim();
+    if (title)
+        extras.push(title);
+    extras.push(...aliases);
+    if (domain)
+        extras.push(domain);
+    if (noteType)
+        extras.push(noteType);
+    if (status)
+        extras.push(status);
+    extras.push(...sectionHeads.slice(0, 5));
+    extras.push(...summary.split('\n').slice(0, 2));
+    if (noteType === 'project')
+        extras.push('项目', '计划', '进展', '任务', '当前状态');
+    else if (noteType === 'note')
+        extras.push('概念', '定义', '知识点', '章节', '复习');
+    else if (noteType === 'research')
+        extras.push('研究', '报告', '结论', '发现');
+    if (status === 'done')
+        extras.push('完成', '复盘');
+    return tokenize(extras.filter(Boolean).join(' '));
+}
+// ─── mergeSearchHints ─────────────────────────────────────────────────────────
+/**
+ * Merge base search hints (JSON array or raw string) with extra terms,
+ * deduplicating while preserving insertion order.
+ * Returns a JSON array string.
+ */
+export function mergeSearchHints(baseHints, extraTerms) {
+    const merged = [];
+    const seen = new Set();
+    for (const term of [...loadsJsonList(baseHints), ...extraTerms.filter(Boolean)]) {
+        const normalized = term.trim();
+        if (!normalized || seen.has(normalized))
+            continue;
+        seen.add(normalized);
+        merged.push(normalized);
+    }
+    return JSON.stringify(merged);
+}
+// ─── processEnhanceQueue ──────────────────────────────────────────────────────
+/**
+ * Process up to `limit` pending items from the enhance queue.
+ * For each item, generates semantic summary and enhanced search hints,
+ * then marks the item as done (or error on failure).
+ */
+export function processEnhanceQueue(db, _vaultRoot, limit = 5) {
+    const rows = db
+        .prepare(`
+      SELECT file_path, priority FROM enhance_queue
+      WHERE status = 'pending'
+      ORDER BY priority DESC, queued_at ASC
+      LIMIT ?
+    `)
+        .all(limit);
+    let processed = 0;
+    let errors = 0;
+    for (const row of rows) {
+        try {
+            const record = queryOne(db, 'SELECT * FROM vault_index WHERE file_path = ?', row.file_path);
+            if (!record) {
+                db.prepare("UPDATE enhance_queue SET status = 'done' WHERE file_path = ?").run(row.file_path);
+                continue;
+            }
+            const semanticSummary = generateSemanticSummary(record);
+            const enhancedTerms = generateEnhancedSearchTerms(record);
+            const mergedHints = mergeSearchHints(record.search_hints, enhancedTerms);
+            db.prepare(`
+        UPDATE vault_index SET semantic_summary = ?, search_hints = ? WHERE file_path = ?
+      `).run(semanticSummary, mergedHints, row.file_path);
+            db.prepare("UPDATE enhance_queue SET status = 'done' WHERE file_path = ?").run(row.file_path);
+            processed++;
+        }
+        catch {
+            db.prepare(`
+        UPDATE enhance_queue
+        SET status = 'error', attempts = attempts + 1, error_message = 'enhance failed'
+        WHERE file_path = ?
+      `).run(row.file_path);
+            errors++;
+        }
+    }
+    return { processed, errors };
+}
+//# sourceMappingURL=enhance.js.map

package/dist/services/enhance.js.map

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

package/dist/services/layer0.d.ts

@@ -0,0 +1,24 @@
+/**
+ * layer0.ts — Layer 0 上下文摘要构建器。
+ *
+ * Builds the Layer 0 summary from UserProfile.md and TaskBoard.md,
+ * trimmed to configured token budgets.
+ */
+import type { ContextPolicy } from '../utils/context-policy.js';
+/**
+ * Extract the content between <!-- BEGIN AUTO:marker --> and <!-- END AUTO:marker -->
+ * comment blocks in a markdown document. Returns empty string if not found.
+ */
+export declare function extractAutoSection(content: string, marker: string): string;
+/**
+ * Trim text to at most `budget` estimated tokens.
+ * Returns empty string when budget is 0 or text is blank.
+ * Appends '...' continuation marker when text is cut.
+ */
+export declare function trimToBudget(text: string, budget: number): string;
+/**
+ * Build the Layer 0 summary string from UserProfile.md and TaskBoard.md.
+ * Reads AUTO sections, trims to configured token budgets, and optionally
+ * appends the last session bridge text.
+ */
+export declare function buildLayer0Summary(vaultRoot: string, policy: ContextPolicy, lastSessionBridge?: string | null): string;