cogmem 3.6.5 → 3.7.1

package/dist/agent/AgentMemoryBackend.js

@@ -1,6 +1,8 @@
 import { memoryEventCharRange, memoryEventLabel, memoryEventSourceRange, normalizeSourceContextWindow, } from '../recall/SourceContextMetadata.js';
 import { isOperationalNoiseText, isRecallableMemoryEvidence } from '../recall/RecallGovernance.js';
 import { compileAgentRecallQuery, } from './AgentRecallQueryCompiler.js';
+import { extractEntityCues } from '../utils/EntityCueExtractor.js';
+import { inferActionKinds } from '../utils/ActionKindRegistry.js';
 export class KernelAgentMemoryBackend {
     kernel;
     constructor(kernel) {
@@ -248,13 +250,13 @@ export class KernelAgentMemoryBackend {
             intent: query.intent,
             anchorText: query.anchorText,
         });
-        if (query.intent === 'previous_session_summary') {
+        if (queryPlan.intent === 'previous_session_summary') {
             return this.recallPreviousSession(query, queryPlan);
         }
-        if (query.intent === 'forensic_quote') {
+        if (queryPlan.intent === 'forensic_quote') {
             return this.recallForensicQuote(query, queryPlan);
         }
-        if (queryPlan.intent === 'historical_discussion') {
+        if (queryPlan.intent === 'historical_discussion' || queryPlan.intent === 'action_history') {
             return this.recallHistoricalDiscussion(query, queryPlan);
         }
         const limit = query.limit ?? 5;
@@ -431,8 +433,7 @@ export class KernelAgentMemoryBackend {
             ? this.getSessionEvents(previousSessionId, query, Math.max(limit * 3, 24))
             : [];
         const items = events
-            .filter((event) => this.isAgentRawEvent(event, query.agentId))
-            .filter((event) => this.isAllowedRawEventCollection(event, query.collection))
+            .filter((event) => this.isRawEventInRecallScope(event, query, queryPlan.intent))
             .filter((event) => !this.isOperationalNoiseRawEvent(event))
             .filter((event) => this.hasReadableEventText(event))
             .slice(0, limit)
@@ -457,26 +458,29 @@ export class KernelAgentMemoryBackend {
     }
     recallForensicQuote(query, queryPlan) {
         const limit = query.limit ?? 5;
-        const anchorItems = this.recallForensicAnchor(query, limit);
+        const anchorItems = this.recallForensicAnchor(query, queryPlan, limit);
         const rawEvents = anchorItems.length > 0 && (queryPlan.anchorUsed || !!query.anchorEventId)
             ? []
-            : this.searchRawEventsByQueryPlan(queryPlan, query, Math.max(limit * 4, 20));
+            : [
+                ...this.rawEventsForLocalDateCue(query, Math.max(limit * 4, 20)),
+                ...this.searchRawEventsByQueryPlan(queryPlan, query, Math.max(limit * 4, 20)),
+            ];
+        const facetQuoteItems = anchorItems.length === 0 ? this.facetGraphQuoteItemsForQuery(query, queryPlan, limit) : [];
         const items = [
             ...anchorItems,
             ...rawEvents
                 .filter((event) => this.isAgentRawEvent(event, query.agentId))
-                .filter((event) => this.isAllowedSession(event, query))
-                .filter((event) => this.isAllowedRawEventCollection(event, query.collection))
-                .filter((event) => !this.isOperationalNoiseRawEvent(event))
+                .filter((event) => this.isRawEventInRecallScope(event, query, queryPlan.intent))
                 .filter((event) => this.isQuoteSourceEvent(event))
                 .filter((event) => this.hasReadableEventText(event))
-                .sort((a, b) => this.quoteEventPriority(a) - this.quoteEventPriority(b))
+                .sort((a, b) => this.quoteEventPriority(a, queryPlan) - this.quoteEventPriority(b, queryPlan))
                 .slice(0, limit)
                 .map((event) => this.toAgentRawRecallItem(event, {
                 sourceType: 'raw_ledger',
                 whyMatched: 'forensic_quote_raw_event',
                 canAnswerExactQuote: true,
             })),
+            ...facetQuoteItems,
         ].filter((item, index, array) => array.findIndex((candidate) => candidate.id === item.id) === index)
             .slice(0, limit);
         return {
@@ -498,42 +502,117 @@ export class KernelAgentMemoryBackend {
         const allowsGraph = laneAllowed(query.retrievalPolicy, 'graph');
         const allowsCompiled = laneAllowed(query.retrievalPolicy, 'compiled');
         const allowsRawSource = laneAllowed(query.retrievalPolicy, 'raw_source');
+        const facetResult = allowsGraph ? this.facetGraphItemsForQuery(query, limit) : { items: [], cards: [], relatedButNotSelected: [], relaxationTrace: [] };
+        const facetItems = allowsRawSource ? facetResult.items : [];
         const graphItems = allowsGraph ? this.memoryBindingGraphItemsForQuery(query, queryPlan, limit) : [];
         const rawItems = allowsRawSource ? this.rawLedgerFallbackItemsForQuery(queryPlan, query, Math.max(limit * 2, 10)) : [];
-        const retrievalLimit = Math.max(limit * 4, 24);
         const compiledItems = allowsCompiled
-            ? this.filterAgentEvidence(this.kernel.navigateMemory(queryPlan.primarySearchText, {
-                projectId: query.projectId,
-                limit: retrievalLimit,
-                startTime: query.startTime,
-                endTime: query.endTime,
-            }).rawEvidence, query.agentId, query.collection, query.excludeSessionId)
-                .slice(0, limit)
-                .map((neuron) => this.toAgentRecallItem(neuron))
+            ? this.compiledItemsForHistoricalQuery(queryPlan, query, limit)
             : [];
-        const items = this.mergeRecallItems(rawItems, this.mergeRecallItems(graphItems, compiledItems, limit), limit);
-        const selectedLane = rawItems.length > 0
-            ? 'raw_ledger'
-            : graphItems.length > 0
-                ? 'graph'
-                : compiledItems.length > 0
-                    ? 'compiled'
-                    : 'none';
+        const relevantCompiledItems = this.filterCompiledItemsByQueryCues(compiledItems, queryPlan);
+        const items = this.mergeHistoricalRecallItems(facetItems, rawItems, graphItems, relevantCompiledItems, limit);
+        const selectedLane = facetItems.length > 0
+            ? 'facet_graph_raw_ledger'
+            : rawItems.length > 0
+                ? 'raw_ledger'
+                : graphItems.length > 0
+                    ? 'graph'
+                    : relevantCompiledItems.length > 0
+                        ? 'compiled'
+                        : 'none';
         return {
-            recallMode: rawItems.length > 0 ? 'raw_ledger_fallback' : 'brain_recall_fallback',
+            recallMode: facetItems.length > 0
+                ? (rawItems.length > 0 ? 'atlas_raw_grounded_recall' : 'atlas_facet_recall')
+                : rawItems.length > 0 ? 'raw_ledger_fallback' : 'brain_recall_fallback',
             items,
-            fallbackUsed: true,
+            fallbackUsed: facetItems.length === 0,
             queryPlan,
-            decisionTrace: recallDecisionTrace(selectedLane, 'historical_discussion', {
-                graph: graphItems.length,
-                navigation: compiledItems.length,
-                scopedNavigation: compiledItems.length,
+            atlasCards: facetResult.cards,
+            relatedButNotSelected: facetResult.relatedButNotSelected,
+            relaxationTrace: facetResult.relaxationTrace,
+            decisionTrace: recallDecisionTrace(selectedLane, queryPlan.intent === 'action_history' ? 'action_history' : 'historical_discussion', {
+                graph: graphItems.length + facetItems.length,
+                navigation: relevantCompiledItems.length,
+                scopedNavigation: relevantCompiledItems.length,
                 brainFallback: 0,
-                rawLedger: rawItems.length,
+                rawLedger: rawItems.length + facetItems.length,
             }, items.length),
         };
     }
-    recallForensicAnchor(query, limit) {
+    facetGraphQuoteItemsForQuery(query, queryPlan, limit) {
+        try {
+            const atlas = this.kernel.graphExplore(query.query, {
+                projectId: query.projectId,
+                limit: Math.max(limit * 2, 6),
+                includeEvidence: true,
+                evidenceLimit: 2,
+                refresh: true,
+                staleOk: true,
+            });
+            const cards = (atlas.cards ?? []).slice(0, Math.max(limit * 2, 6));
+            const events = cards
+                .map((card) => card.sourceLocator?.eventId ?? card.evidenceEventIds[0])
+                .filter((eventId) => Boolean(eventId))
+                .map((eventId) => this.kernel.getEventContext(eventId, { before: 0, after: 0 })?.event)
+                .filter((event) => Boolean(event))
+                .filter((event) => this.isRawEventInRecallScope(event, query, queryPlan.intent))
+                .filter((event) => this.isQuoteSourceEvent(event))
+                .filter((event) => this.hasReadableEventText(event));
+            return this.dedupeRawEventsByTurnPreferUser(events)
+                .slice(0, limit)
+                .map((event) => this.toAgentRawRecallItem(event, {
+                sourceType: 'raw_ledger',
+                whyMatched: 'forensic_quote_atlas_source_locator',
+                canAnswerExactQuote: true,
+            }));
+        }
+        catch {
+            return [];
+        }
+    }
+    facetGraphItemsForQuery(query, limit) {
+        try {
+            const atlas = this.kernel.graphExplore(query.query, {
+                projectId: query.projectId,
+                limit,
+                includeEvidence: true,
+                evidenceLimit: 2,
+                refresh: true,
+                staleOk: true,
+            });
+            const cards = (atlas.cards ?? []).slice(0, limit);
+            const items = cards.map((card) => this.toAgentRecallItemFromAtlasCard(card, query)).filter((item) => Boolean(item));
+            const relatedButNotSelected = cards.flatMap((card) => card.relatedButNotSelected ?? []).slice(0, 8);
+            return { items, cards, relatedButNotSelected, relaxationTrace: atlas.relaxationTrace ?? [] };
+        }
+        catch {
+            return { items: [], cards: [], relatedButNotSelected: [], relaxationTrace: [] };
+        }
+    }
+    toAgentRecallItemFromAtlasCard(card, query) {
+        const eventId = card.sourceLocator?.eventId ?? card.evidenceEventIds[0];
+        const sourceContext = eventId ? this.toAgentSourceContext(eventId) : undefined;
+        const anchorEvent = sourceContext?.event;
+        return {
+            id: `facet:${card.canonicalId}`,
+            text: [card.displayTitle, card.oneLineSummary].filter(Boolean).join(': '),
+            projectId: query.projectId,
+            topicPath: card.parentTopics[0],
+            canonicalId: card.canonicalId,
+            displayTitle: card.displayTitle,
+            matchedFacets: card.matchedFacets,
+            matchedPaths: card.matchedPaths,
+            tags: ['facet_graph', card.eventKind, card.issueType].filter((tag) => Boolean(tag)),
+            source: 'memory_atlas',
+            sourceType: 'raw_ledger',
+            sourceAnchor: anchorEvent ? this.toAgentSourceAnchorFromContextEvent(anchorEvent) : eventId ? { eventId } : undefined,
+            sourceContext,
+            confidence: Math.min(1, 0.7 + card.matchedFacets.length * 0.08),
+            whyMatched: card.whyMatched,
+            canAnswerExactQuote: Boolean(sourceContext),
+        };
+    }
+    recallForensicAnchor(query, queryPlan, limit) {
         if (!query.anchorEventId)
             return [];
         const context = this.kernel.getEventContext(query.anchorEventId, { before: 4, after: 4 });
@@ -542,8 +621,7 @@ export class KernelAgentMemoryBackend {
         const candidates = [context.event, ...context.before.slice().reverse(), ...context.after];
         return candidates
             .filter((event) => this.isAgentRawEvent(event, query.agentId))
-            .filter((event) => this.isAllowedSession(event, query))
-            .filter((event) => this.isAllowedRawEventCollection(event, query.collection))
+            .filter((event) => this.isRawEventInRecallScope(event, query, queryPlan.intent))
             .filter((event) => !this.isOperationalNoiseRawEvent(event))
             .filter((event) => this.isQuoteSourceEvent(event))
             .filter((event) => this.hasReadableEventText(event))
@@ -551,7 +629,7 @@ export class KernelAgentMemoryBackend {
             const anchorDelta = (a.eventId === query.anchorEventId ? 0 : 1) - (b.eventId === query.anchorEventId ? 0 : 1);
             if (anchorDelta !== 0)
                 return anchorDelta;
-            return this.quoteEventPriority(a) - this.quoteEventPriority(b);
+            return this.quoteEventPriority(a, queryPlan) - this.quoteEventPriority(b, queryPlan);
         })
             .slice(0, limit)
             .map((event) => this.toAgentRawRecallItem(event, {
@@ -584,15 +662,39 @@ export class KernelAgentMemoryBackend {
         }
         return out;
     }
+    rawEventsForLocalDateCue(query, limit) {
+        const localDate = localDateCue(query.query, query);
+        if (!localDate)
+            return [];
+        const [year, month, day] = localDate.split('-').map(Number);
+        const byLocalDate = this.kernel.eventStore.queryEvents(1, 1000, {
+            projectId: query.projectId ? [query.projectId] : undefined,
+            workspaceId: query.workspaceId ? [query.workspaceId] : undefined,
+        }).records.filter((event) => event.localDate === localDate).slice(0, limit);
+        if (byLocalDate.length)
+            return byLocalDate;
+        const startTime = Date.UTC(year, month - 1, day);
+        const endTime = Date.UTC(year, month - 1, day + 1);
+        const byTime = this.kernel.eventStore.queryEvents(1, Math.max(1, Math.min(limit, 200)), {
+            projectId: query.projectId ? [query.projectId] : undefined,
+            workspaceId: query.workspaceId ? [query.workspaceId] : undefined,
+            startTime,
+            endTime,
+        }).records;
+        if (byTime.length)
+            return byTime;
+        return this.kernel.eventStore.queryEvents(1, 1000, {
+            projectId: query.projectId ? [query.projectId] : undefined,
+            workspaceId: query.workspaceId ? [query.workspaceId] : undefined,
+        }).records.filter((event) => event.localDate === localDate).slice(0, limit);
+    }
     rawLedgerFallbackItemsForQuery(queryPlan, query, limit) {
         const searchedEvents = this.searchRawEventsByQueryPlan(queryPlan, query, Math.max(limit * 2, 10));
         const rawEvents = queryPlan.intent === 'forensic_quote'
             ? this.dedupeRawEventsByTurnPreferUser(searchedEvents)
             : this.dedupeRawEventsByTurnPreferCue(searchedEvents, queryPlan);
         return rawEvents
-            .filter((event) => this.isAgentRawEvent(event, query.agentId))
-            .filter((event) => this.isAllowedSession(event, query))
-            .filter((event) => this.isAllowedRawEventCollection(event, query.collection))
+            .filter((event) => this.isRawEventInRecallScope(event, query, queryPlan.intent))
             .filter((event) => !this.isOperationalNoiseRawEvent(event))
             .slice(0, limit)
             .map((event) => this.toAgentRawRecallItem(event, {
@@ -614,11 +716,7 @@ export class KernelAgentMemoryBackend {
             const event = this.kernel.getEventContext(anchor.eventId, { before: 0, after: 0 })?.event;
             if (!event)
                 continue;
-            if (!this.isAgentRawEvent(event, query.agentId))
-                continue;
-            if (!this.isAllowedSession(event, query))
-                continue;
-            if (!this.isAllowedRawEventCollection(event, query.collection))
+            if (!this.isRawEventInRecallScope(event, query, queryPlan.intent))
                 continue;
             if (this.isOperationalNoiseRawEvent(event))
                 continue;
@@ -687,6 +785,28 @@ export class KernelAgentMemoryBackend {
             .filter((term) => term.length >= 2 && !/^(hermes|openclaw|cogmem)$/i.test(term));
         return uniqueNonEmpty(terms);
     }
+    queryHasStructuredCue(queryPlan) {
+        return /hermes|openclaw|cogmem|启动|安装|配置|重启|停止|操作|处理|执行|start|launch|install|configure|restart|stop|run/i.test(queryPlan.originalQuery)
+            || queryPlan.intent === 'action_history';
+    }
+    structuredCueTerms(queryPlan) {
+        const terms = [
+            ...queryPlan.keywords,
+            ...queryPlan.semanticCuePhrases.flatMap((phrase) => phrase.split(/\s+/)),
+        ]
+            .map((term) => term.trim())
+            .filter((term) => term.length >= 2)
+            .filter((term) => !/^(之前|什么|做过|做了|让你|我的|原话|精确|完整|the|what|did|you|to)$/i.test(term));
+        if (/启动|start|launch/i.test(queryPlan.originalQuery))
+            terms.push('启动', 'start', 'launch');
+        if (/安装|install|setup/i.test(queryPlan.originalQuery))
+            terms.push('安装', 'install', 'setup');
+        if (/配置|修改|config/i.test(queryPlan.originalQuery))
+            terms.push('配置', '修改', 'config');
+        if (/操作|处理|执行|run|ran/i.test(queryPlan.originalQuery))
+            terms.push('操作', '执行', 'run');
+        return uniqueNonEmpty(terms);
+    }
     itemSearchableText(item) {
         return [
             item.text,
@@ -698,15 +818,75 @@ export class KernelAgentMemoryBackend {
         const out = [];
         const seen = new Set();
         for (const item of [...primary, ...secondary]) {
-            if (seen.has(item.id))
+            const keys = [item.canonicalId, item.sourceAnchor?.eventId, item.id].filter((value) => Boolean(value));
+            if (keys.some((key) => seen.has(key)))
                 continue;
-            seen.add(item.id);
+            for (const key of keys)
+                seen.add(key);
             out.push(item);
             if (out.length >= limit)
                 break;
         }
         return out;
     }
+    mergeHistoricalRecallItems(facetItems, rawItems, graphItems, compiledItems, limit) {
+        const merged = this.mergeRecallItems(facetItems, this.mergeRecallItems(rawItems, this.mergeRecallItems(graphItems, compiledItems, limit), limit), limit);
+        if (merged.some((item) => item.sourceType === 'imported_summary'))
+            return merged;
+        const importedSupport = compiledItems.find((item) => item.sourceType === 'imported_summary');
+        if (!importedSupport)
+            return merged;
+        const withoutDuplicate = merged.filter((item) => item.id !== importedSupport.id && item.sourceAnchor?.eventId !== importedSupport.sourceAnchor?.eventId);
+        if (withoutDuplicate.length < limit)
+            return [...withoutDuplicate, importedSupport];
+        return [...withoutDuplicate.slice(0, Math.max(0, limit - 1)), importedSupport];
+    }
+    compiledItemsForHistoricalQuery(queryPlan, query, limit) {
+        const retrievalLimit = Math.max(limit * 4, 24);
+        const out = [];
+        const seen = new Set();
+        for (const searchText of uniqueNonEmpty([queryPlan.primarySearchText, ...queryPlan.searchTexts, queryPlan.originalQuery])) {
+            const rawEvidence = this.kernel.navigateMemory(searchText, {
+                projectId: query.projectId,
+                limit: retrievalLimit,
+                startTime: query.startTime,
+                endTime: query.endTime,
+            }).rawEvidence;
+            const items = this.filterAgentEvidence(rawEvidence, query.agentId, query.collection, query.excludeSessionId)
+                .map((neuron) => this.toAgentRecallItem(neuron));
+            for (const item of items) {
+                const key = item.id || item.sourceAnchor?.eventId;
+                if (key && seen.has(key))
+                    continue;
+                if (key)
+                    seen.add(key);
+                out.push(item);
+                if (out.length >= limit)
+                    return out;
+            }
+        }
+        return out;
+    }
+    filterCompiledItemsByQueryCues(items, queryPlan) {
+        if (!this.queryHasStructuredCue(queryPlan))
+            return items;
+        const cues = this.structuredCueTerms(queryPlan);
+        if (!cues.length)
+            return items;
+        return items.filter((item) => {
+            const haystack = this.itemSearchableText(item).toLowerCase();
+            if (queryPlan.intent === 'action_history') {
+                const entityTerms = extractEntityCues(queryPlan.originalQuery).map((entity) => entity.label.toLowerCase());
+                const entityMatched = entityTerms.length === 0 || entityTerms.some((term) => haystack.includes(term));
+                const queryKinds = inferActionKinds(queryPlan.originalQuery);
+                const allowedKinds = queryKinds.length ? queryKinds : ['started', 'installed', 'configured', 'restarted', 'stopped', 'operated', 'implemented'];
+                const itemKinds = inferActionKinds(haystack);
+                const actionMatched = itemKinds.some((kind) => allowedKinds.includes(kind));
+                return entityMatched && actionMatched;
+            }
+            return cues.some((cue) => haystack.includes(cue.toLowerCase()));
+        });
+    }
     dedupeRawEventsByTurnPreferUser(events) {
         const byTurn = new Map();
         for (const event of events) {
@@ -727,6 +907,8 @@ export class KernelAgentMemoryBackend {
     expandRawSearchTexts(queryPlan) {
         const hostNeutralKeywords = queryPlan.keywords.filter((keyword) => !/^(hermes|openclaw|cogmem)$/i.test(keyword));
         return uniqueNonEmpty([
+            queryPlan.originalQuery,
+            queryPlan.keywords.join(' '),
             ...queryPlan.searchTexts,
             hostNeutralKeywords.join(' '),
             ...hostNeutralKeywords.filter((keyword) => keyword.length >= 2),
@@ -873,6 +1055,21 @@ export class KernelAgentMemoryBackend {
             return true;
         return false;
     }
+    isRawEventInRecallScope(event, query, effectiveIntent) {
+        if (query.projectId && event.projectId !== query.projectId)
+            return false;
+        if (query.workspaceId && event.workspaceId !== query.workspaceId)
+            return false;
+        if (query.threadId && event.threadId !== query.threadId)
+            return false;
+        if (!this.isAgentRawEvent(event, query.agentId))
+            return false;
+        if (!this.isAllowedSession(event, query, effectiveIntent))
+            return false;
+        if (!this.isAllowedRawEventCollection(event, query.collection))
+            return false;
+        return true;
+    }
     isOperationalNoiseRawEvent(event) {
         const payload = event.payload;
         const tags = Array.isArray(payload.metadata?.tags) ? payload.metadata.tags : [];
@@ -884,10 +1081,10 @@ export class KernelAgentMemoryBackend {
         }
         return isOperationalNoiseText(typeof payload.text === 'string' ? payload.text : JSON.stringify(event.payload));
     }
-    isAllowedSession(event, query) {
+    isAllowedSession(event, query, effectiveIntent = query.intent) {
         if (query.excludeSessionId && event.sessionId === query.excludeSessionId)
             return false;
-        if (query.sessionId && query.intent && query.intent !== 'memory_recall' && event.sessionId === query.sessionId)
+        if (query.sessionId && effectiveIntent && effectiveIntent !== 'memory_recall' && event.sessionId === query.sessionId)
             return false;
         return true;
     }
@@ -897,12 +1094,13 @@ export class KernelAgentMemoryBackend {
             || typeof payload.output === 'string'
             || typeof payload.title === 'string';
     }
-    quoteEventPriority(event) {
+    quoteEventPriority(event, queryPlan) {
+        const cuePenalty = queryPlan && this.rawEventCueScore(event, queryPlan) > 0 ? 0 : queryPlan ? 10 : 0;
         if (event.role === 'user')
-            return 0;
+            return cuePenalty;
         if (event.role === 'assistant')
-            return 1;
-        return 2;
+            return cuePenalty + 1;
+        return cuePenalty + 2;
     }
     isQuoteSourceEvent(event) {
         return event.role === 'user' || (!event.role && event.rawEventType === 'message');
@@ -1317,6 +1515,38 @@ function uniqueNonEmpty(values) {
 function laneAllowed(policy, lane) {
     return !policy || policy.allowedLanes.includes(lane);
 }
+function localDateCue(query, options = {}) {
+    const currentYear = localYear(options);
+    const iso = query.match(/(20\d{2})[-年\/.](\d{1,2})[-月\/.](\d{1,2})日?/);
+    if (iso)
+        return `${iso[1]}-${padDatePart(Number(iso[2]))}-${padDatePart(Number(iso[3]))}`;
+    const cn = query.match(/(?:(20\d{2})年)?(\d{1,2})月(\d{1,2})(?:号|日)?/);
+    if (cn)
+        return `${cn[1] || currentYear}-${padDatePart(Number(cn[2]))}-${padDatePart(Number(cn[3]))}`;
+    return undefined;
+}
+function localYear(options) {
+    const explicit = options.localDateNow?.match(/^(20\d{2})-\d{2}-\d{2}$/u)?.[1];
+    if (explicit)
+        return Number(explicit);
+    const now = options.now ?? Date.now();
+    try {
+        const parts = new Intl.DateTimeFormat('en-CA', {
+            timeZone: options.timeZone || 'Asia/Tokyo',
+            year: 'numeric',
+            month: '2-digit',
+            day: '2-digit',
+        }).formatToParts(new Date(now));
+        const year = parts.find((part) => part.type === 'year')?.value;
+        if (year)
+            return Number(year);
+    }
+    catch { /* fall back below */ }
+    return new Date(now).getUTCFullYear();
+}
+function padDatePart(value) {
+    return String(value).padStart(2, '0');
+}
 function cliArg(value) {
     return /^[A-Za-z0-9._:/=@+-]+$/u.test(value) ? value : `'${value.replace(/'/g, `'\\''`)}'`;
 }

package/dist/agent/AgentRecallQueryCompiler.d.ts

@@ -1,4 +1,4 @@
-export type AgentRecallIntent = 'memory_recall' | 'previous_session_summary' | 'forensic_quote' | 'historical_discussion';
+export type AgentRecallIntent = 'memory_recall' | 'previous_session_summary' | 'forensic_quote' | 'historical_discussion' | 'action_history';
 export interface AgentRecallQueryCompileInput {
     query: string;
     intent?: AgentRecallIntent;

package/dist/agent/AgentRecallQueryCompiler.js

@@ -1,8 +1,9 @@
+import { extractEntityCues, inferOperationalActionCue } from '../utils/EntityCueExtractor.js';
 const PROTECTED_PHRASES = [
     'CogMem Memory Context',
     'Memory Context',
     'OpenClaw',
-    'Hermes',
+    '启动',
     'cogmem',
     'Obsidian',
     '记忆内核',
@@ -25,6 +26,7 @@ const PROTECTED_PHRASES = [
     '报错',
     '错误',
     '工具',
+    '操作',
 ];
 const QUERY_FILLERS = [
     '我现在不是问你泛泛解释',
@@ -99,6 +101,9 @@ export function inferAgentRecallIntent(query) {
     if (/原话|怎么说的|完整对话|上一句|下一句|exact quote|verbatim/.test(text)) {
         return 'forensic_quote';
     }
+    if (/(让你.{0,20}(对|给|把)?.{0,20}(做过|做了|启动|安装|配置|修改|重启|停止|操作|处理|执行)|对.{0,30}(做过什么|做了什么|哪些操作)|what did (i ask you to do|you do) to|operations? on)/i.test(text)) {
+        return 'action_history';
+    }
     if (/记得.{0,12}(聊过|讨论过|说过)|还记得|之前.{0,12}(聊过|讨论过|说过)|以前.{0,12}(聊过|讨论过|说过)|(过去|几个月前|半年前|上个月|前几天|昨天|上次|上个).{0,20}(聊过|讨论过|说过)|当时.{0,12}(聊|说|问)|那次.{0,12}(聊|说|问)|有没有.{0,12}(记录|聊过|讨论过)|have we discussed|did we talk about|previously discussed/.test(text)) {
         return 'historical_discussion';
     }
@@ -202,6 +207,13 @@ function buildSemanticCuePhrases(keywords, query, anchorText) {
         out.push('产品コード');
         out.push('数量');
     }
+    const action = inferOperationalActionCue(text);
+    for (const entity of extractEntityCues(text, 4)) {
+        out.push(entity.label);
+        out.push(`${entity.label} 操作`);
+        if (action)
+            out.push(`${action.label} ${entity.label}`);
+    }
     return uniqueNonEmpty(out);
 }
 function extractTemporalHints(query) {

package/dist/agent/MemoryUsageReceipt.js

@@ -1,4 +1,5 @@
 import { createHash } from 'node:crypto';
+import { serializeUntrustedMemory } from './UntrustedMemorySerializer.js';
 export function createMemoryUsageReceipt(input) {
     const createdAt = input.createdAt ?? Date.now();
     const turnId = input.turnId || `${input.sessionId}:${createdAt}`;
@@ -29,14 +30,14 @@ export function createMemoryUsageReceipt(input) {
 }
 export function formatMemoryUsageBridge(receipt, maxChars = 1200) {
     const lines = [
-        `<COGMEM_TURN_BRIDGE turn_id="${escapeAttribute(receipt.turnId)}" source="cogmem" compact="true" ttl_turns="${receipt.ttlTurns}" compile_allowed="false">`,
+        `<COGMEM_TURN_BRIDGE turn_id="${serializeUntrustedMemory(receipt.turnId, 180)}" source="cogmem" compact="true" ttl_turns="${receipt.ttlTurns}" compile_allowed="false">`,
         'Previous assistant answer used Cogmem memory.',
         '',
         'Used memory themes:',
         ...listLines(receipt.usedThemes),
         '',
         'Working conclusion produced in that turn:',
-        `- ${receipt.workingConclusion || 'No compact conclusion recorded.'}`,
+        `- ${serializeUntrustedMemory(receipt.workingConclusion || 'No compact conclusion recorded.', 260)}`,
         '',
         'Source anchors:',
         ...listLines(receipt.sourceAnchors.map(formatSourceAnchor)),
@@ -96,19 +97,16 @@ function firstSentence(text, limit) {
     return sentence.length > limit ? `${sentence.slice(0, limit)}...` : sentence;
 }
 function listLines(values) {
-    return values.length > 0 ? values.map((value) => `- ${value}`) : ['- none'];
+    return values.length > 0 ? values.map((value) => `- ${serializeUntrustedMemory(value, 260)}`) : ['- none'];
 }
 function formatSourceAnchor(anchor) {
     return [
-        anchor.memoryId ? `memory:${anchor.memoryId}` : '',
-        anchor.eventId ? `event:${anchor.eventId}` : '',
-        anchor.sessionId ? `session:${anchor.sessionId}` : '',
-        anchor.role ? `role:${anchor.role}` : '',
+        anchor.memoryId ? `memory:${serializeUntrustedMemory(anchor.memoryId, 160)}` : '',
+        anchor.eventId ? `event:${serializeUntrustedMemory(anchor.eventId, 160)}` : '',
+        anchor.sessionId ? `session:${serializeUntrustedMemory(anchor.sessionId, 160)}` : '',
+        anchor.role ? `role:${serializeUntrustedMemory(anchor.role, 80)}` : '',
     ].filter(Boolean).join('; ');
 }
-function escapeAttribute(value) {
-    return String(value).replace(/&/g, '&amp;').replace(/"/g, '&quot;').replace(/</g, '&lt;');
-}
 function clampBlock(text, closingTag, maxChars) {
     if (text.length <= maxChars)
         return text;

package/dist/agent/SessionWorkingState.js

@@ -1,3 +1,4 @@
+import { serializeUntrustedMemory } from './UntrustedMemorySerializer.js';
 export function updateSessionWorkingState(previous, input) {
     const maxChars = Math.max(240, Math.min(4000, Math.floor(input.maxChars ?? previous?.maxChars ?? 1800)));
     const topic = inferTopic(input.userText) || previous?.currentTopic;
@@ -19,7 +20,7 @@ export function formatSessionWorkingState(state) {
     const lines = [
         `<COGMEM_SESSION_STATE scope="current_session" compact="true" persistence="session_only" compile_allowed="false">`,
         'Current working topic:',
-        `- ${state.currentTopic || 'unspecified'}`,
+        `- ${serializeUntrustedMemory(state.currentTopic || 'unspecified', 180)}`,
         '',
         'Current design direction:',
         ...listLines(state.designDirection),
@@ -72,7 +73,7 @@ function compactSentence(text, limit) {
     return sentence.length > limit ? `${sentence.slice(0, limit)}...` : sentence;
 }
 function listLines(values) {
-    return values.length > 0 ? values.map((value) => `- ${value}`) : ['- none'];
+    return values.length > 0 ? values.map((value) => `- ${serializeUntrustedMemory(value, 260)}`) : ['- none'];
 }
 function appendBounded(existing, additions, limit) {
     const out = [];

package/dist/agent/UntrustedMemorySerializer.d.ts

@@ -0,0 +1,2 @@
+export declare function serializeUntrustedMemory(input: unknown, limit?: number): string;
+//# sourceMappingURL=UntrustedMemorySerializer.d.ts.map

package/dist/agent/UntrustedMemorySerializer.js

@@ -0,0 +1,14 @@
+import { stripCogmemRecallBlocks } from './ContextHygiene.js';
+export function serializeUntrustedMemory(input, limit = 500) {
+    const clean = stripCogmemRecallBlocks(String(input ?? '')).text
+        .replace(/<\/?COGMEM_[A-Z0-9_:-]+[^>]*>/gi, '')
+        .replace(/[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f]/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim()
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+    return clean.slice(0, Math.max(0, limit));
+}

package/dist/atlas/ActionFrameExtractor.js

@@ -27,6 +27,8 @@ export class ActionFrameExtractor {
                 if (!event.projectId || (event.role !== 'user' && event.role !== 'tool'))
                     continue;
                 const text = eventTextForMemory(event);
+                if (!text.trim())
+                    continue;
                 const markers = actionMarkers(text);
                 if (!markers.length)
                     continue;