lifeos 1.0.0

package/dist/utils/shared.d.ts

@@ -0,0 +1,103 @@
+/**
+ * shared.ts — 通用工具函数。
+ *
+ * Provides utility functions used by all other modules.
+ */
+import type Database from 'better-sqlite3';
+export declare const SESSION_ID_ENV_KEYS: readonly ["LIFEOS_SESSION_ID", "CLAUDE_SESSION_ID", "CODEX_SESSION_ID", "OPENCODE_SESSION_ID"];
+export declare const ALLOWED_COUNT_TABLES: Set<string>;
+export { VALID_ENTRY_TYPES, KEY_ENTRY_TYPES, ACTIVE_DOC_TARGETS } from '../types.js';
+export { daysAgo, formatDateShort } from '../types.js';
+export declare const RULE_KEY_DETAIL_FIELDS: readonly ["rule_key", "preference_slot", "constraint_key"];
+export declare const RULE_KEY_PREFIXES: Record<string, string>;
+export declare const TEMPORARY_PREFERENCE_KEYWORDS: readonly ["这次", "暂时", "先这样", "本周", "今天", "当前先", "这一轮", "这两天"];
+export declare const STABLE_PREFERENCE_KEYWORDS: readonly ["长期", "一直", "固定", "习惯", "通常", "默认"];
+export declare const DEFAULT_TEMPORARY_PREFERENCE_DAYS = 14;
+export declare const ALL_TIME_DAYS = 3650;
+export declare const FALLBACK_THRESHOLD = 3;
+export declare const SUMMARY_MAX_LEN = 500;
+export declare const BUCKET_TYPE_MAP: Record<string, Set<string>>;
+/**
+ * Resolve a session ID from the provided value or environment variables.
+ * Returns 'untracked' when no valid session ID can be found.
+ */
+export declare function resolveSessionId(sessionId?: string | null): string;
+/**
+ * Coerce various input types to a Date object.
+ * - No argument → current UTC time
+ * - Date → returned as-is
+ * - string → parsed via Date constructor (ISO format)
+ * - Other types → throw TypeError
+ */
+export declare function coerceNow(now?: Date | string | null): Date;
+/**
+ * Coerce a value to a list of strings.
+ * Handles null/undefined, raw arrays, JSON array strings, and plain strings.
+ */
+export declare function loadsJsonList(value: string | string[] | null | undefined): string[];
+/**
+ * Parse a JSON string into a plain object.
+ * Returns an empty object on failure or if the result is not an object.
+ */
+export declare function parseDetailObject(detail: string | null | undefined): Record<string, unknown>;
+/**
+ * Estimate the token count for a text string.
+ * CJK characters count as 1 token each.
+ * Latin words count as 1.3 tokens each (ceiling).
+ * Other non-whitespace characters count as 0.5 tokens each (floor).
+ */
+export declare function estimateTokens(text: string): number;
+/**
+ * Return true if the text contains at least one CJK character (U+4E00–U+9FFF).
+ */
+export declare function containsCjk(text: string): boolean;
+/**
+ * Strip [[ and ]] from a wikilink value, trimming whitespace.
+ * Returns null for null input.
+ */
+export declare function normalizeWikilinkValue(value: unknown): string | null;
+/**
+ * Compact text to at most `limit` characters, appending '...' if truncated.
+ * Normalizes internal whitespace. Returns '暂无摘要' for empty input.
+ */
+export declare function compactText(text: string | null | undefined, limit?: number): string;
+/**
+ * Normalize whitespace and truncate to `limit` characters (no ellipsis).
+ * Returns empty string for empty/null input.
+ */
+export declare function normalizeRuleSummary(text: string | null | undefined, limit?: number): string;
+/**
+ * Build a default rule key from entry type and summary text.
+ * Returns null if the entry type has no prefix or the summary is empty.
+ */
+export declare function buildDefaultRuleKey(entryType: string, text: string): string | null;
+/**
+ * Extract an explicit rule key value from a detail object.
+ * Checks rule_key, preference_slot, constraint_key in order.
+ */
+export declare function extractRuleKeyValue(detailObj: Record<string, unknown> | null | undefined): string | null;
+/**
+ * Resolve the final rule key for an entry.
+ * Prefers explicit keys in detail_obj, falls back to building from entry type + summary.
+ */
+export declare function resolveRuleKey(entryType: string, summary: string, detailObj?: Record<string, unknown> | null): string | null;
+type TemporaryPreferenceResult = {
+    temporary: boolean;
+    expiresInDays?: number;
+    expiresAt?: string;
+    temporarySource?: string;
+};
+/**
+ * Infer whether a preference entry is temporary based on text keywords
+ * or explicit fields in the detail object.
+ */
+export declare function inferTemporaryPreference(text: string, detailObj?: Record<string, unknown> | null): TemporaryPreferenceResult;
+/**
+ * Count rows in an allowed table, with optional WHERE clause.
+ * Throws if the table name is not in ALLOWED_COUNT_TABLES.
+ */
+export declare function countRows(conn: Database.Database, table: string, whereSql?: string, params?: unknown[]): number;
+/**
+ * Return true if the summary represents an archive summary entry.
+ */
+export declare function isArchiveSummary(summary: unknown, entryType?: string): boolean;

package/dist/utils/shared.js

@@ -0,0 +1,313 @@
+/**
+ * shared.ts — 通用工具函数。
+ *
+ * Provides utility functions used by all other modules.
+ */
+// ─── Constants ────────────────────────────────────────────────────────────────
+export const SESSION_ID_ENV_KEYS = [
+    'LIFEOS_SESSION_ID',
+    'CLAUDE_SESSION_ID',
+    'CODEX_SESSION_ID',
+    'OPENCODE_SESSION_ID',
+];
+export const ALLOWED_COUNT_TABLES = new Set([
+    'vault_index',
+    'enhance_queue',
+    'session_log',
+]);
+export { VALID_ENTRY_TYPES, KEY_ENTRY_TYPES, ACTIVE_DOC_TARGETS } from '../types.js';
+export { daysAgo, formatDateShort } from '../types.js';
+export const RULE_KEY_DETAIL_FIELDS = ['rule_key', 'preference_slot', 'constraint_key'];
+export const RULE_KEY_PREFIXES = {
+    decision: 'decision',
+    correction: 'correction',
+    preference: 'prefer',
+};
+export const TEMPORARY_PREFERENCE_KEYWORDS = [
+    '这次',
+    '暂时',
+    '先这样',
+    '本周',
+    '今天',
+    '当前先',
+    '这一轮',
+    '这两天',
+];
+export const STABLE_PREFERENCE_KEYWORDS = ['长期', '一直', '固定', '习惯', '通常', '默认'];
+export const DEFAULT_TEMPORARY_PREFERENCE_DAYS = 14;
+export const ALL_TIME_DAYS = 3650;
+export const FALLBACK_THRESHOLD = 3;
+export const SUMMARY_MAX_LEN = 500;
+export const BUCKET_TYPE_MAP = {
+    daily: new Set(['daily', 'diary']),
+    draft: new Set(['draft']),
+    project: new Set(['project']),
+    research: new Set(['research']),
+    knowledge: new Set(['knowledge', 'note', 'revise-record']),
+    resource: new Set(['resource']),
+};
+// ─── Session ──────────────────────────────────────────────────────────────────
+/**
+ * Resolve a session ID from the provided value or environment variables.
+ * Returns 'untracked' when no valid session ID can be found.
+ */
+export function resolveSessionId(sessionId) {
+    if (sessionId != null && String(sessionId).trim()) {
+        return String(sessionId).trim();
+    }
+    for (const envKey of SESSION_ID_ENV_KEYS) {
+        const value = process.env[envKey];
+        if (value?.trim()) {
+            return value.trim();
+        }
+    }
+    return 'untracked';
+}
+// ─── Time ─────────────────────────────────────────────────────────────────────
+/**
+ * Coerce various input types to a Date object.
+ * - No argument → current UTC time
+ * - Date → returned as-is
+ * - string → parsed via Date constructor (ISO format)
+ * - Other types → throw TypeError
+ */
+export function coerceNow(now) {
+    if (now == null) {
+        return new Date();
+    }
+    if (now instanceof Date) {
+        return now;
+    }
+    if (typeof now === 'string') {
+        const parsed = new Date(now);
+        if (Number.isNaN(parsed.getTime())) {
+            throw new TypeError(`Cannot parse date string: ${now}`);
+        }
+        return parsed;
+    }
+    throw new TypeError(`Unsupported time type: ${typeof now}`);
+}
+// ─── JSON / List helpers ──────────────────────────────────────────────────────
+/**
+ * Coerce a value to a list of strings.
+ * Handles null/undefined, raw arrays, JSON array strings, and plain strings.
+ */
+export function loadsJsonList(value) {
+    if (value == null)
+        return [];
+    if (Array.isArray(value)) {
+        return value.filter((item) => item != null).map((item) => String(item));
+    }
+    if (typeof value === 'string') {
+        const stripped = value.trim();
+        if (!stripped)
+            return [];
+        let parsed;
+        try {
+            parsed = JSON.parse(stripped);
+        }
+        catch {
+            return [stripped];
+        }
+        if (parsed === null)
+            return [];
+        if (Array.isArray(parsed)) {
+            return parsed.filter((item) => item != null).map((item) => String(item));
+        }
+        return [String(parsed)];
+    }
+    return [String(value)];
+}
+/**
+ * Parse a JSON string into a plain object.
+ * Returns an empty object on failure or if the result is not an object.
+ */
+export function parseDetailObject(detail) {
+    if (!detail)
+        return {};
+    try {
+        const parsed = JSON.parse(detail);
+        if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
+            return parsed;
+        }
+        return {};
+    }
+    catch {
+        return {};
+    }
+}
+// ─── Text / Token helpers ─────────────────────────────────────────────────────
+/**
+ * Estimate the token count for a text string.
+ * CJK characters count as 1 token each.
+ * Latin words count as 1.3 tokens each (ceiling).
+ * Other non-whitespace characters count as 0.5 tokens each (floor).
+ */
+export function estimateTokens(text) {
+    if (!text.trim())
+        return 0;
+    const cjkCount = [...text].filter((ch) => ch >= '\u4e00' && ch <= '\u9fff').length;
+    const latinWords = (text.match(/[A-Za-z0-9_]+/g) ?? []).length;
+    const otherChars = (text.match(/[^\sA-Za-z0-9_\u4e00-\u9fff]/g) ?? []).length;
+    return cjkCount + Math.ceil(latinWords * 1.3) + Math.max(Math.floor(otherChars / 2), 0);
+}
+/**
+ * Return true if the text contains at least one CJK character (U+4E00–U+9FFF).
+ */
+export function containsCjk(text) {
+    return [...text].some((ch) => ch >= '\u4e00' && ch <= '\u9fff');
+}
+/**
+ * Strip [[ and ]] from a wikilink value, trimming whitespace.
+ * Returns null for null input.
+ */
+export function normalizeWikilinkValue(value) {
+    if (value == null)
+        return null;
+    let normalized = String(value).trim();
+    if (normalized.startsWith('[[') && normalized.endsWith(']]')) {
+        normalized = normalized.slice(2, -2).trim();
+    }
+    return normalized;
+}
+/**
+ * Compact text to at most `limit` characters, appending '...' if truncated.
+ * Normalizes internal whitespace. Returns '暂无摘要' for empty input.
+ */
+export function compactText(text, limit = 160) {
+    const normalized = (text ?? '').replace(/\s+/g, ' ').trim();
+    if (!normalized)
+        return '暂无摘要';
+    if (normalized.length <= limit)
+        return normalized;
+    return `${normalized.slice(0, Math.max(limit - 3, 0)).trimEnd()}...`;
+}
+/**
+ * Normalize whitespace and truncate to `limit` characters (no ellipsis).
+ * Returns empty string for empty/null input.
+ */
+export function normalizeRuleSummary(text, limit = 160) {
+    const normalized = String(text ?? '')
+        .replace(/\s+/g, ' ')
+        .trim();
+    if (!normalized)
+        return '';
+    if (normalized.length <= limit)
+        return normalized;
+    return normalized.slice(0, limit).trimEnd();
+}
+// ─── Rule key helpers ─────────────────────────────────────────────────────────
+/**
+ * Build a default rule key from entry type and summary text.
+ * Returns null if the entry type has no prefix or the summary is empty.
+ */
+export function buildDefaultRuleKey(entryType, text) {
+    const prefix = RULE_KEY_PREFIXES[entryType];
+    const normalized = normalizeRuleSummary(text);
+    if (!prefix || !normalized)
+        return null;
+    return `${prefix}:${normalized}`;
+}
+/**
+ * Extract an explicit rule key value from a detail object.
+ * Checks rule_key, preference_slot, constraint_key in order.
+ */
+export function extractRuleKeyValue(detailObj) {
+    const payload = detailObj ?? {};
+    for (const field of RULE_KEY_DETAIL_FIELDS) {
+        const value = payload[field];
+        if (value)
+            return String(value).trim();
+    }
+    return null;
+}
+/**
+ * Resolve the final rule key for an entry.
+ * Prefers explicit keys in detail_obj, falls back to building from entry type + summary.
+ */
+export function resolveRuleKey(entryType, summary, detailObj) {
+    const explicit = extractRuleKeyValue(detailObj);
+    if (explicit)
+        return explicit;
+    return buildDefaultRuleKey(entryType, summary);
+}
+function coerceBoolValue(value) {
+    if (typeof value === 'boolean')
+        return value;
+    if (typeof value === 'string') {
+        const lower = value.toLowerCase().trim();
+        if (lower === 'false' || lower === '0' || lower === 'no')
+            return false;
+        return Boolean(value);
+    }
+    return Boolean(value);
+}
+/**
+ * Infer whether a preference entry is temporary based on text keywords
+ * or explicit fields in the detail object.
+ */
+export function inferTemporaryPreference(text, detailObj) {
+    const payload = detailObj ?? {};
+    // Check for explicit fields in detail_obj
+    const hasExplicitFields = ['temporary', 'expires_at', 'expires_in_days', 'temporary_source'].some((key) => payload[key] != null);
+    if (hasExplicitFields) {
+        const result = { temporary: true };
+        if (payload.temporary != null) {
+            result.temporary = coerceBoolValue(payload.temporary);
+        }
+        const rawExpiresInDays = payload.expires_in_days;
+        if (rawExpiresInDays != null) {
+            const days = Number.parseInt(String(rawExpiresInDays), 10);
+            if (!Number.isNaN(days))
+                result.expiresInDays = days;
+        }
+        if (payload.expires_at) {
+            result.expiresAt = String(payload.expires_at);
+        }
+        if (payload.temporary_source) {
+            result.temporarySource = String(payload.temporary_source);
+        }
+        else {
+            result.temporarySource = 'explicit';
+        }
+        return result;
+    }
+    // Keyword-based inference
+    const normalized = normalizeRuleSummary(text);
+    if (STABLE_PREFERENCE_KEYWORDS.some((kw) => normalized.includes(kw))) {
+        return { temporary: false };
+    }
+    if (TEMPORARY_PREFERENCE_KEYWORDS.some((kw) => normalized.includes(kw))) {
+        return {
+            temporary: true,
+            expiresInDays: DEFAULT_TEMPORARY_PREFERENCE_DAYS,
+            temporarySource: 'keyword_fallback',
+        };
+    }
+    return { temporary: false };
+}
+// ─── Database helpers ─────────────────────────────────────────────────────────
+/**
+ * Count rows in an allowed table, with optional WHERE clause.
+ * Throws if the table name is not in ALLOWED_COUNT_TABLES.
+ */
+export function countRows(conn, table, whereSql = '', params = []) {
+    if (!ALLOWED_COUNT_TABLES.has(table)) {
+        throw new Error(`Invalid table: ${table}`);
+    }
+    let sql = `SELECT COUNT(*) FROM ${table}`;
+    if (whereSql)
+        sql += ` WHERE ${whereSql}`;
+    const row = conn.prepare(sql).get(params);
+    return row ? Number(row['COUNT(*)']) : 0;
+}
+// ─── Archive helpers ──────────────────────────────────────────────────────────
+/**
+ * Return true if the summary represents an archive summary entry.
+ */
+export function isArchiveSummary(summary, entryType) {
+    if (entryType === 'archive_summary')
+        return true;
+    return String(summary ?? '').startsWith('归档摘要：');
+}
+//# sourceMappingURL=shared.js.map

package/dist/utils/shared.js.map

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

package/dist/utils/vault-indexer.d.ts

@@ -0,0 +1,53 @@
+/**
+ * vault-indexer.ts — Vault 索引器。
+ *
+ * Scans Vault markdown files, parses frontmatter, and writes to the
+ * SQLite index.
+ */
+import { VaultConfig } from '../config.js';
+export interface ParsedMarkdown {
+    title: string;
+    type: string | null;
+    status: string | null;
+    domain: string | null;
+    category: string | null;
+    tags: string;
+    aliases: string;
+    summary: string;
+    semanticSummary: string | null;
+    searchHints: string;
+    wikilinks: string;
+    backlinks: string;
+    sectionHeads: string;
+    contentHash: string;
+}
+export interface ScanResult {
+    indexed: number;
+    skipped: number;
+}
+export interface IndexResult {
+    status: 'indexed' | 'skipped' | 'removed';
+    filePath?: string;
+    reason?: string;
+}
+/**
+ * Determine whether a vault-relative file path should be indexed.
+ * Returns true only if path ends in .md, matches an included prefix,
+ * and does not match an excluded prefix.
+ */
+export declare function shouldIndex(relativePath: string, config?: VaultConfig): boolean;
+/**
+ * Parse a markdown file's content, extracting frontmatter and body metadata.
+ * Returns null if the file has no valid frontmatter.
+ */
+export declare function parseMarkdown(content: string, fileName: string): ParsedMarkdown | null;
+/**
+ * Scan all .md files in the vault and index them into the SQLite database.
+ * Skips files that don't match scan rules or lack valid frontmatter.
+ */
+export declare function fullScan(vaultRoot: string, dbPath: string, config?: VaultConfig): ScanResult;
+/**
+ * Index or re-index a single file. Handles absolute or relative paths.
+ * If the file has been deleted, removes its entry from the index.
+ */
+export declare function indexSingleFile(vaultRoot: string, dbPath: string, filePath: string, config?: VaultConfig): IndexResult;