@dsh-cove/dsh-web-all 0.0.0-stage → 0.4.3

package/lib/types/host/services/memoir/routes.js

@@ -0,0 +1,364 @@
+import { queryProjects, FORMAT_VERSION } from "./store.js";
+import { DEFAULT_MEMOIR_SETTINGS, validateMemoirSettingsPatch } from "./settings.js";
+import { accessTrustOf } from "../access-trust/index.js";
+import { isLoopbackRequest } from "../access-trust/trust.js";
+import { registerResources } from "../resources.js";
+export const MEMOIR_API_PREFIX = '/api/dsh-memoir';
+function writeJson(res, status, body) {
+    res.writeHead(status, { 'content-type': 'application/json' });
+    res.end(JSON.stringify(body));
+}
+function ok(res, value) {
+    writeJson(res, 200, { ok: true, value });
+}
+function fail(res, status, message) {
+    writeJson(res, status, { ok: false, error: { code: 'memoir-error', message } });
+}
+async function readJsonBody(req, maxBytes) {
+    const chunks = [];
+    let total = 0;
+    for await (const chunk of req) {
+        const buf = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        total += buf.length;
+        if (total > maxBytes)
+            return null;
+        chunks.push(buf);
+    }
+    try {
+        const parsed = JSON.parse(Buffer.concat(chunks).toString('utf8'));
+        return parsed !== null && typeof parsed === 'object' ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+const SECTION_KEYS = ['work', 'lessons', 'actions', 'note'];
+const STATUSES = ['active', 'superseded', 'archived'];
+function isSectionKey(value) {
+    return typeof value === 'string' && SECTION_KEYS.includes(value);
+}
+function isStatus(value) {
+    return typeof value === 'string' && STATUSES.includes(value);
+}
+/** 项目标题（路径末段）。 */
+function projectTitle(path) {
+    const trimmed = path.replace(/[\\/]+$/, '');
+    const parts = trimmed.split(/[\\/]/);
+    return parts[parts.length - 1] || path;
+}
+/** 条目 wire shape：把存储字段映射为面板契约（time/source/sessionId 别名）。 */
+function wireEntry(entry) {
+    const wire = {
+        id: entry.id,
+        section: entry.section,
+        title: entry.title,
+        content: entry.content,
+        time: entry.createdAt ?? entry.updatedAt,
+        importance: entry.importance,
+        pinned: entry.pinned,
+        status: entry.status,
+    };
+    if (entry.tags !== undefined)
+        wire.tags = entry.tags;
+    if (entry.supersedes !== undefined)
+        wire.supersedes = entry.supersedes;
+    return wire;
+}
+/** 项目 wire shape（面板契约：key/path/title/updatedAt/entries）。 */
+function wireProject(path, project, filter) {
+    return {
+        key: path,
+        path: project.path,
+        title: projectTitle(project.path),
+        updatedAt: project.entries.reduce((n, e) => Math.max(n, e.updatedAt ?? e.createdAt ?? 0), 0),
+        entries: project.entries.filter(filter).map(wireEntry),
+    };
+}
+/** 条目过滤器（section + status + query）。 */
+function entryFilter(section, status, query) {
+    const q = query.toLowerCase();
+    return (entry) => (section === undefined || entry.section === section)
+        && (status === 'all' || (entry.status ?? 'active') === status)
+        && (q === '' || `${entry.title ?? ''} ${entry.content}`.toLowerCase().includes(q));
+}
+/** 构建 /api/dsh-memoir 前缀路由。 */
+export function makeMemoirRoutes(deps) {
+    const { store, logger } = deps;
+    const isTrusted = deps.isTrusted ?? isLoopbackRequest;
+    const handler = async (req, res) => {
+        if (!isTrusted(req)) {
+            fail(res, 403, 'forbidden: loopback-only');
+            return;
+        }
+        const url = new URL(req.url ?? '/', 'http://x');
+        const pathname = url.pathname;
+        try {
+            if (req.method === 'GET' && pathname === MEMOIR_API_PREFIX + '/project') {
+                const path = url.searchParams.get('path');
+                if (path === null || path === '') {
+                    fail(res, 400, 'path query is required');
+                    return;
+                }
+                const section = url.searchParams.get('section') ?? undefined;
+                const status = url.searchParams.get('status') ?? 'active';
+                const filter = entryFilter(section, status, '');
+                const key = path;
+                const project = store.project(path);
+                ok(res, { project: project === undefined
+                        ? { key, path, title: projectTitle(path), updatedAt: 0, entries: [] }
+                        : wireProject(key, project, filter) });
+                return;
+            }
+            if (req.method === 'GET' && pathname === MEMOIR_API_PREFIX + '/global') {
+                const section = url.searchParams.get('section') ?? undefined;
+                const status = url.searchParams.get('status') ?? 'active';
+                const filter = entryFilter(section, status, '');
+                const all = queryProjects(store.load());
+                const projects = all
+                    .map((p) => wireProject(p.path, p, filter))
+                    .filter((p) => p.entries.length > 0);
+                ok(res, { projects });
+                return;
+            }
+            if (req.method === 'GET' && pathname === MEMOIR_API_PREFIX + '/search') {
+                const scope = url.searchParams.get('scope');
+                const path = url.searchParams.get('path');
+                const section = url.searchParams.get('section') ?? undefined;
+                const status = url.searchParams.get('status') ?? 'all';
+                const limitText = url.searchParams.get('limit');
+                const limit = limitText === null ? 100 : Math.min(Number(limitText) || 100, 500);
+                const q = url.searchParams.get('query') ?? url.searchParams.get('q') ?? '';
+                const needle = q.toLowerCase();
+                const projects = scope === 'project' && path !== null && path !== ''
+                    ? [store.project(path)]
+                    : queryProjects(store.load());
+                const results = [];
+                for (const project of projects) {
+                    for (const entry of project.entries) {
+                        if (needle === '')
+                            continue;
+                        if (section !== undefined && entry.section !== section)
+                            continue;
+                        if (status !== 'all' && (entry.status ?? 'active') !== status)
+                            continue;
+                        const title = entry.title.toLowerCase();
+                        const content = entry.content.toLowerCase();
+                        if (!title.includes(needle) && !content.includes(needle))
+                            continue;
+                        const score = (title.includes(needle) ? 2 : 1) + (content.startsWith(needle) ? 0.5 : 0);
+                        results.push({ projectPath: project.path, entry: wireEntry(entry), score });
+                    }
+                }
+                results.sort((a, b) => b.score - a.score);
+                ok(res, { results: results.slice(0, limit) });
+                return;
+            }
+            if (req.method === 'GET' && pathname === MEMOIR_API_PREFIX + '/hot-memory') {
+                const path = url.searchParams.get('path');
+                const project = path !== null && path !== '' ? store.project(path) : undefined;
+                if (project === undefined) {
+                    fail(res, 400, 'path query is required');
+                    return;
+                }
+                const selected = project.entries
+                    .filter(e => e.status === 'active' && e.pinned)
+                    .sort((a, b) => (b.importance ?? 3) - (a.importance ?? 3))
+                    .slice(0, 8);
+                const text = selected.map(e => `### ${e.title}\n${e.content}`).join('\n\n');
+                ok(res, {
+                    hotMemory: selected.length === 0 ? null : {
+                        text,
+                        selected: selected.map(wireEntry),
+                        total: selected.length,
+                        estimatedTokens: Math.ceil(text.length / 4),
+                    },
+                });
+                return;
+            }
+            if (req.method === 'GET' && pathname === MEMOIR_API_PREFIX + '/diagnostics') {
+                const all = queryProjects(store.load());
+                const entries = all.reduce((n, p) => n + p.entries.length, 0);
+                const config = deps.settings();
+                ok(res, {
+                    storeRevision: FORMAT_VERSION,
+                    snapshotEpoch: 0,
+                    cache: { revision: 0, epoch: 0, loads: 0, hits: 0, misses: 0, hitRate: 0, fileReads: 0, statProbes: 0, corruptBackups: 0, renders: 0, renderComputes: 0, renderHitRate: 0 },
+                    snapshotCount: 0,
+                    snapshotMax: config.sessionSnapshotMax,
+                    hotMemory: null,
+                    retrieval: {
+                        index: null,
+                        cache: { hits: 0, misses: 0, evictions: 0, hitRate: 0, size: 0, capacity: config.queryCacheSize },
+                        lastQuery: null,
+                    },
+                    snapshot: null,
+                    config: {
+                        announceToAgent: config.announceToAgent,
+                        autoDistill: config.autoDistill,
+                        autoDistillEvery: config.autoDistillEvery,
+                        autoDistillCooldownMin: config.autoDistillCooldownMin,
+                        autoDistillMinTools: config.autoDistillMinTools,
+                        hotMemoryTokens: config.hotMemoryTokens,
+                        hotMemoryMaxTokens: config.hotMemoryMaxTokens,
+                        readDefaultLimit: config.readDefaultLimit,
+                        readMaxLimit: config.readMaxLimit,
+                        sessionSnapshotMax: config.sessionSnapshotMax,
+                        queryCacheSize: config.queryCacheSize,
+                    },
+                    projects: all.length,
+                    entries,
+                });
+                return;
+            }
+            if ((req.method === 'GET' || req.method === 'POST') && pathname === MEMOIR_API_PREFIX + '/settings') {
+                const settings = deps.settings();
+                if (req.method === 'POST') {
+                    const body = await readJsonBody(req, 64 * 1024);
+                    if (body === null) {
+                        fail(res, 400, 'invalid JSON body');
+                        return;
+                    }
+                    // 宿主是边界：补丁先过校验，非法值不会落到磁盘。
+                    const invalid = validateMemoirSettingsPatch(body, settings);
+                    if (invalid !== undefined) {
+                        fail(res, 400, invalid);
+                        return;
+                    }
+                    const next = { ...settings, ...body };
+                    deps.saveSettings(next);
+                    ok(res, { settings: next, source: 'web' });
+                    return;
+                }
+                ok(res, { settings, source: 'profile' });
+                return;
+            }
+            if (req.method === 'PUT' && pathname === MEMOIR_API_PREFIX + '/settings') {
+                const body = await readJsonBody(req, 64 * 1024);
+                if (body === null) {
+                    fail(res, 400, 'invalid JSON body');
+                    return;
+                }
+                const invalid = validateMemoirSettingsPatch(body, deps.settings());
+                if (invalid !== undefined) {
+                    fail(res, 400, invalid);
+                    return;
+                }
+                const next = { ...deps.settings(), ...body };
+                deps.saveSettings(next);
+                ok(res, { settings: next, source: 'web' });
+                return;
+            }
+            if (req.method === 'DELETE' && pathname === MEMOIR_API_PREFIX + '/settings') {
+                const body = await readJsonBody(req, 64 * 1024);
+                const reset = { ...DEFAULT_MEMOIR_SETTINGS };
+                if (body !== null && typeof body === 'object' && body.merge !== true) {
+                    deps.saveSettings(reset);
+                }
+                ok(res, { settings: deps.settings(), source: 'profile' });
+                return;
+            }
+            if ((req.method === 'POST' || req.method === 'PATCH') && pathname === MEMOIR_API_PREFIX + '/entries') {
+                const body = await readJsonBody(req, 128 * 1024);
+                if (body === null) {
+                    fail(res, 400, 'invalid JSON body');
+                    return;
+                }
+                const path = body.path;
+                if (typeof path !== 'string' || path === '') {
+                    fail(res, 400, 'expected { path }');
+                    return;
+                }
+                const project = store.project(path);
+                if (req.method === 'POST') {
+                    const { title, content, section } = body;
+                    if (typeof title !== 'string' || title.trim() === '' || typeof content !== 'string' || content.trim() === '' || !isSectionKey(section)) {
+                        fail(res, 400, 'expected { path, title, content, section }');
+                        return;
+                    }
+                    const now = Date.now();
+                    const entry = {
+                        id: `m-${now.toString(36)}-${Math.random().toString(36).slice(2, 8)}`,
+                        title: title.trim(),
+                        content: content.trim(),
+                        section,
+                        status: 'active',
+                        createdAt: now,
+                        updatedAt: now,
+                        pinned: typeof body.pinned === 'boolean' ? body.pinned : false,
+                        importance: typeof body.importance === 'number' ? body.importance : 3,
+                        ...(Array.isArray(body.tags) ? { tags: body.tags.filter((t) => typeof t === 'string') } : {}),
+                        ...(Array.isArray(body.supersedes) ? { supersedes: body.supersedes.filter((t) => typeof t === 'string') } : {}),
+                    };
+                    project.entries.push(entry);
+                    store.saveProject(path, project.entries);
+                    ok(res, { action: 'recorded', recorded: true, entry: wireEntry(entry), candidates: [] });
+                    return;
+                }
+                // PATCH /entries — update entry content or lifecycle metadata.
+                const { id } = body;
+                if (typeof id !== 'string' || id === '') {
+                    fail(res, 400, 'expected { path, id }');
+                    return;
+                }
+                const entry = project.entries.find((e) => e.id === id);
+                if (entry === undefined) {
+                    fail(res, 404, `entry not found: ${id}`);
+                    return;
+                }
+                if (typeof body.title === 'string' && body.title.trim() !== '')
+                    entry.title = body.title.trim();
+                if (typeof body.content === 'string' && body.content.trim() !== '')
+                    entry.content = body.content.trim();
+                if (isSectionKey(body.section))
+                    entry.section = body.section;
+                if (isStatus(body.status))
+                    entry.status = body.status;
+                if (typeof body.pinned === 'boolean')
+                    entry.pinned = body.pinned;
+                if (typeof body.importance === 'number')
+                    entry.importance = body.importance;
+                if (Array.isArray(body.tags))
+                    entry.tags = body.tags.filter((t) => typeof t === 'string');
+                if (Array.isArray(body.supersedes))
+                    entry.supersedes = body.supersedes.filter((t) => typeof t === 'string');
+                entry.updatedAt = Date.now();
+                store.saveProject(path, project.entries);
+                ok(res, { entry: wireEntry(entry), updated: true });
+                return;
+            }
+            if (req.method === 'DELETE' && pathname === MEMOIR_API_PREFIX + '/entries') {
+                const body = await readJsonBody(req, 64 * 1024);
+                if (body === null) {
+                    fail(res, 400, 'invalid JSON body');
+                    return;
+                }
+                const { path, id } = body;
+                if (typeof path !== 'string' || typeof id !== 'string' || id === '') {
+                    fail(res, 400, 'expected { path, id }');
+                    return;
+                }
+                const project = store.project(path);
+                const before = project.entries.length;
+                project.entries = project.entries.filter((e) => e.id !== id);
+                store.saveProject(path, project.entries);
+                ok(res, { removed: project.entries.length < before });
+                return;
+            }
+            fail(res, 404, `unknown route: ${req.method} ${pathname}`);
+        }
+        catch (error) {
+            logger.warn(error);
+            fail(res, 500, error instanceof Error ? error.message : String(error));
+        }
+    };
+    return [{ kind: 'prefix', path: MEMOIR_API_PREFIX, handler }];
+}
+/** 服务域注册入口（路由）。 */
+export function registerRoutes(ctx, deps) {
+    const routes = makeMemoirRoutes({ ...deps, isTrusted: accessTrustOf(ctx).isTrusted });
+    return registerResources(own => {
+        for (const route of routes)
+            own(ctx.webServer.register(route));
+    });
+}
+// 供 index.ts 使用（保持路径工具同源）。

package/lib/types/host/services/memoir/settings.d.ts

@@ -0,0 +1,27 @@
+import type { MemoirSettings } from '../../../core/memoir/protocol.ts';
+export declare const SETTINGS_VERSION = 2;
+export type { MemoirSettings } from '../../../core/memoir/protocol.ts';
+export declare const DEFAULT_MEMOIR_SETTINGS: MemoirSettings;
+export declare function defaultSettingsPath(): string;
+/** 合并不完整记录为完整设置（非法字段回落默认）。 */
+export declare function resolveMemoirSettings(value: unknown, defaults?: MemoirSettings): MemoirSettings;
+/**
+ * 校验设置补丁（非法返回错误字符串）。
+ *
+ * 规则与设置界面允许的范围一致：计数类必须是不小于 1 的安全整数，冷却分钟数
+ * 允许 0，合并后的上限不得小于对应下限。宿主是边界，界面里的夹取不算数。
+ * @param payload - 调用方提交的补丁。
+ * @param base - 当前设置（跨字段规则按合并结果判断）。
+ * @returns 错误信息，或 undefined 表示合法。
+ */
+export declare function validateMemoirSettingsPatch(payload: unknown, base?: MemoirSettings): string | undefined;
+/** 设置存储。 */
+export declare class MemoirSettingsStore {
+    private readonly file;
+    private readonly listeners;
+    constructor(file?: string);
+    load(): MemoirSettings;
+    save(settings: MemoirSettings): void;
+    subscribe(listener: (settings: MemoirSettings) => void): () => void;
+}
+//# sourceMappingURL=settings.d.ts.map

package/lib/types/host/services/memoir/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../../../../src/host/services/memoir/settings.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AAEtE,eAAO,MAAM,gBAAgB,IAAI,CAAA;AAEjC,YAAY,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AAEtE,eAAO,MAAM,uBAAuB,EAAE,cAarC,CAAA;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,8BAA8B;AAC9B,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,GAAE,cAAwC,GAAG,cAAc,CAkBxH;AAKD;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,GAAE,cAAwC,GAAG,MAAM,GAAG,SAAS,CAwBhI;AAED,YAAY;AACZ,qBAAa,mBAAmB;IAGlB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgD;gBAE7C,IAAI,GAAE,MAA8B;IAEjE,IAAI,IAAI,cAAc;IAStB,IAAI,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IASpC,SAAS,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,GAAG,MAAM,IAAI;CAIpE"}

package/lib/types/host/services/memoir/settings.js

@@ -0,0 +1,120 @@
+/**
+ * memoir host 服务域 —— 设置（全新实现；行为契约参考旧包）。
+ *
+ * 用户可调项：announceToAgent / autoDistill 开关、token 预算、读取上限、
+ * 查询缓存等；持久化 ~/.dsh/dsh-memoir.settings.json。
+ */
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+export const SETTINGS_VERSION = 2;
+export const DEFAULT_MEMOIR_SETTINGS = {
+    enabled: true,
+    announceToAgent: false,
+    autoDistill: true,
+    autoDistillEvery: 1,
+    autoDistillCooldownMin: 0,
+    autoDistillMinTools: 1,
+    hotMemoryTokens: 900,
+    hotMemoryMaxTokens: 1200,
+    readDefaultLimit: 8,
+    readMaxLimit: 30,
+    sessionSnapshotMax: 128,
+    queryCacheSize: 128,
+};
+export function defaultSettingsPath() {
+    return join(process.env.DSH_HOME ?? join(homedir(), '.dsh'), 'dsh-memoir.settings.json');
+}
+/** 合并不完整记录为完整设置（非法字段回落默认）。 */
+export function resolveMemoirSettings(value, defaults = DEFAULT_MEMOIR_SETTINGS) {
+    const input = typeof value === 'object' && value !== null ? value : {};
+    const num = (key, fallback) => typeof input[key] === 'number' ? input[key] : fallback;
+    const bool = (key, fallback) => typeof input[key] === 'boolean' ? input[key] : fallback;
+    return {
+        enabled: bool('enabled', defaults.enabled),
+        announceToAgent: bool('announceToAgent', defaults.announceToAgent),
+        autoDistill: bool('autoDistill', defaults.autoDistill),
+        autoDistillEvery: num('autoDistillEvery', defaults.autoDistillEvery),
+        autoDistillCooldownMin: num('autoDistillCooldownMin', defaults.autoDistillCooldownMin),
+        autoDistillMinTools: num('autoDistillMinTools', defaults.autoDistillMinTools),
+        hotMemoryTokens: num('hotMemoryTokens', defaults.hotMemoryTokens),
+        hotMemoryMaxTokens: num('hotMemoryMaxTokens', defaults.hotMemoryMaxTokens),
+        readDefaultLimit: num('readDefaultLimit', defaults.readDefaultLimit),
+        readMaxLimit: num('readMaxLimit', defaults.readMaxLimit),
+        sessionSnapshotMax: num('sessionSnapshotMax', defaults.sessionSnapshotMax),
+        queryCacheSize: num('queryCacheSize', defaults.queryCacheSize),
+    };
+}
+/**
+ * 校验设置补丁（非法返回错误字符串）。
+ *
+ * 规则与设置界面允许的范围一致：计数类必须是不小于 1 的安全整数，冷却分钟数
+ * 允许 0，合并后的上限不得小于对应下限。宿主是边界，界面里的夹取不算数。
+ * @param payload - 调用方提交的补丁。
+ * @param base - 当前设置（跨字段规则按合并结果判断）。
+ * @returns 错误信息，或 undefined 表示合法。
+ */
+export function validateMemoirSettingsPatch(payload, base = DEFAULT_MEMOIR_SETTINGS) {
+    if (typeof payload !== 'object' || payload === null || Array.isArray(payload))
+        return 'body must be a JSON object';
+    const input = payload;
+    for (const key of Object.keys(input)) {
+        if (!(key in base))
+            return `unknown setting: ${key}`;
+    }
+    for (const [key, value] of Object.entries(input)) {
+        if (typeof base[key] === 'boolean' && typeof value !== 'boolean')
+            return `${key} must be a boolean`;
+        if (typeof base[key] === 'number' && (typeof value !== 'number' || !Number.isFinite(value)))
+            return `${key} must be a finite number`;
+    }
+    const merged = { ...base, ...input };
+    const numericKeys = Object.keys(base)
+        .filter((key) => typeof base[key] === 'number');
+    for (const key of numericKeys) {
+        const value = merged[key];
+        if (key === 'autoDistillCooldownMin') {
+            if (!Number.isFinite(value) || value < 0)
+                return `${key} must be zero or greater`;
+            continue;
+        }
+        if (!Number.isSafeInteger(value) || value < 1)
+            return `${key} must be a whole number of at least 1`;
+    }
+    if (merged.hotMemoryMaxTokens < merged.hotMemoryTokens)
+        return 'hotMemoryMaxTokens must be at least hotMemoryTokens';
+    if (merged.readMaxLimit < merged.readDefaultLimit)
+        return 'readMaxLimit must be at least readDefaultLimit';
+    return undefined;
+}
+/** 设置存储。 */
+export class MemoirSettingsStore {
+    file;
+    listeners = new Set();
+    constructor(file = defaultSettingsPath()) {
+        this.file = file;
+    }
+    load() {
+        if (!existsSync(this.file))
+            return { ...DEFAULT_MEMOIR_SETTINGS };
+        try {
+            return resolveMemoirSettings(JSON.parse(readFileSync(this.file, 'utf8')));
+        }
+        catch {
+            return { ...DEFAULT_MEMOIR_SETTINGS };
+        }
+    }
+    save(settings) {
+        const dir = dirname(this.file);
+        mkdirSync(dir, { recursive: true });
+        const temp = `${this.file}.tmp`;
+        writeFileSync(temp, JSON.stringify(settings, null, 2), 'utf8');
+        renameSync(temp, this.file);
+        for (const listener of this.listeners)
+            listener(settings);
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => { this.listeners.delete(listener); };
+    }
+}

package/lib/types/host/services/memoir/store.d.ts

@@ -0,0 +1,35 @@
+import { SECTION_KEYS, type MemoirEntry, type MemoirStatus } from '../../../core/memoir/protocol.ts';
+export declare const FORMAT_VERSION = 4;
+export type { MemoirEntry, MemoirStatus, SectionKey } from '../../../core/memoir/protocol.ts';
+export { SECTION_KEYS };
+export declare const MEMOIR_STATUSES: MemoirStatus[];
+/** 单项目记忆文件。 */
+export interface MemoirProject {
+    path: string;
+    entries: MemoirEntry[];
+}
+/** 存储文件（全部项目索引）。 */
+export interface MemoirStoreFile {
+    formatVersion: number;
+    projects: Record<string, MemoirProject>;
+}
+/** 查询一个项目路径下的条目。 */
+export declare function queryProjects(store: MemoirStoreFile, path?: string): MemoirProject[];
+/** 默认存储路径（~/.dsh/dsh-memoir.json）。 */
+export declare function defaultStorePath(): string;
+/** 解析存储文件：损坏/非法行丢弃。 */
+export declare function parseStoreFile(text: string): MemoirStoreFile;
+/** 记忆存储（原子写）。 */
+export declare class MemoirStore {
+    private readonly file;
+    constructor(file?: string);
+    load(): MemoirStoreFile;
+    save(store: MemoirStoreFile): void;
+    /** 取某项目的全部条目（无项目则建空）。 */
+    project(path: string): MemoirProject;
+    /** 写回某项目（保留其他项目）。 */
+    saveProject(path: string, entries: MemoirEntry[]): void;
+}
+/** Compact deterministic hot-memory block for prompt injection. */
+export declare function renderHotMemory(project: MemoirProject, maxTokens?: number): string;
+//# sourceMappingURL=store.d.ts.map

package/lib/types/host/services/memoir/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../../../src/host/services/memoir/store.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAmB,MAAM,kCAAkC,CAAA;AAErH,eAAO,MAAM,cAAc,IAAI,CAAA;AAE/B,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAA;AAC7F,OAAO,EAAE,YAAY,EAAE,CAAA;AAEvB,eAAO,MAAM,eAAe,EAAE,YAAY,EAAyC,CAAA;AAEnF,eAAe;AACf,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,WAAW,EAAE,CAAA;CACvB;AAED,oBAAoB;AACpB,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;CACxC;AAED,oBAAoB;AACpB,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE,CAGpF;AAED,sCAAsC;AACtC,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAgBD,uBAAuB;AACvB,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAkB5D;AAED,iBAAiB;AACjB,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,GAAE,MAA2B;IAE9D,IAAI,IAAI,eAAe;IASvB,IAAI,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAQlC,yBAAyB;IACzB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa;IAOpC,qBAAqB;IACrB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI;CAKxD;AAED,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,OAAO,EAAE,aAAa,EAAE,SAAS,SAAO,GAAG,MAAM,CAgBhF"}