cogmem 3.7.1 → 3.7.3

package/dist/episode/EpisodeTypes.d.ts

@@ -1,8 +1,8 @@
 export type EpisodeStatus = 'open' | 'soft_sealed' | 'sealed';
 export type EpisodeDreamState = 'pending' | 'processing' | 'processed' | 'failed_retryable' | 'failed_terminal' | 'retry_scheduled' | 'skipped';
-export type EpisodeDreamStatusValue = 'none' | 'queued' | 'processing' | 'processed' | 'failed';
+export type EpisodeDreamStatusValue = 'none' | 'queued' | 'processing' | 'processed' | 'failed' | 'skipped';
 export type EpisodeClosureMode = 'soft' | 'hard' | 'manual' | 'batch';
-export type EpisodeClosureReasonCode = 'explicit_user_closure' | 'topic_switch' | 'batch_boundary' | 'idle_timeout' | 'manual' | 'soft_seal_stabilized' | 'repair';
+export type EpisodeClosureReasonCode = 'explicit_user_closure' | 'topic_switch' | 'event_limit' | 'duration_limit' | 'idle_gap' | 'local_date_boundary' | 'batch_boundary' | 'idle_timeout' | 'manual' | 'soft_seal_stabilized' | 'repair';
 export type EpisodeType = 'discussion' | 'decision' | 'correction' | 'preference' | 'goal' | 'debugging' | 'planning' | 'prospective' | 'general';
 export type EpisodeCandidateType = 'belief' | 'entity' | 'temporal' | 'prospective' | 'correction' | 'preference' | 'goal' | 'decision';
 export type TurnRelation = 'continues_previous' | 'clarifies_previous' | 'corrects_previous' | 'answers_assistant_question' | 'confirms_assistant_fact' | 'accepts_assistant_proposal' | 'rejects_assistant_proposal' | 'assistant_response' | 'assistant_proposal' | 'assistant_summary' | 'assistant_question' | 'assistant_clarification' | 'tool_result_context' | 'hard_topic_switch' | 'subtopic_shift' | 'ambiguous_shift' | 'switches_topic' | 'starts_new_topic' | 'returns_to_old_topic' | 'confirms_future_intent' | 'closes_episode' | 'noise';

package/dist/episode/TurnRelationClassifier.d.ts

@@ -33,8 +33,17 @@ export interface TurnRelationAdvisoryReviewer {
         cpuDecision: TurnRelationDecision;
     }): Promise<unknown>;
 }
+export type TurnRelationReviewStatus = 'not_invoked' | 'accepted' | 'failed' | 'invalid' | 'stale_ignored';
+export interface TurnRelationHybridTrace {
+    cpuDecision: TurnRelationDecision;
+    reviewerInvoked: boolean;
+    reviewerRawResultStatus: TurnRelationReviewStatus;
+    reviewerDecision?: TurnRelationDecision;
+    finalDecision: TurnRelationDecision;
+}
 export declare function classifyTurnRelation(input: string | TurnClassificationContext): TurnRelationDecision;
 export declare function classifyAssistantRelation(text: string, role?: string): TurnRelation;
 /** Background-only semantic review. The reviewer can suggest classification fields but cannot mutate memory. */
 export declare function classifyTurnRelationHybrid(context: TurnClassificationContext, reviewer?: TurnRelationAdvisoryReviewer): Promise<TurnRelationDecision>;
+export declare function classifyTurnRelationHybridTrace(context: TurnClassificationContext, reviewer?: TurnRelationAdvisoryReviewer): Promise<TurnRelationHybridTrace>;
 //# sourceMappingURL=TurnRelationClassifier.d.ts.map

package/dist/episode/TurnRelationClassifier.js

@@ -3,13 +3,14 @@ const CORRECTION = /^\s*(不对|不是|不，|不是这样|纠正|更正|我(?:
 const CONTINUATION = /^\s*(继续|接着|然后呢|上面那个|刚才说的|go on|continue|and then|続けて|そのまま)/iu;
 const EXPLICIT_SWITCH = /^\s*(换个话题|换一个话题|另一个问题|另外一个问题|说点别的|题外话|new topic|switch topics?|on another topic|unrelated question)/iu;
 const SUBTOPIC = /^\s*(另外|同时|还有|以及|顺便|also|additionally|and for|それと|また)/iu;
-const CLOSURE = /(就这样|按这个(?:方案)?做|方案确认|到这里|先这样|结论就是|done|that settles it|proceed with this)/iu;
+const CLOSURE = /(?:^|[\s，。,.!?！？])(?:就这样|按这个(?:方案)?做|方案确认|到这里|先这样|结论就是|done|that settles it|proceed with this)(?:$|[\s，。,.!?！？])/iu;
+const NEGATED_CLOSURE = /(?:不要|别|还不能|不能|not|don't|do not).{0,16}(?:就这样|按这个(?:方案)?做|到这里|结束|done|proceed)/iu;
 const PREFERENCE = /(请以后|以后请|始终|总是|偏好|喜欢|希望|不要|别|必须|一定要|边界|local-first|prefer|always|never|must|do not)/iu;
 const GOAL = /(长期目标|目标是|计划要|希望最终|goal|objective)/iu;
 const DECISION = /(决定|确定采用|选用|按.+方案|decision|decide|chosen|确认采用)/iu;
 const PROSPECTIVE = /(提醒我|记得在|明天|下周|到时候|remind me|tomorrow|next week)/iu;
 const DEBUGGING = /(bug|错误|失败|报错|根因|修复|debug|exception)/iu;
-const SHORT_ACCEPT = /^\s*(对|是|可以|确认|就这个|第二个|第[一二三四五六七八九十\d]+个|yes|yep|correct|sounds good|そう|はい)[。.!！\s]*$/iu;
+const SHORT_ACCEPT = /^\s*(对|是|可以|确认|好的|好|收到|明白了|就这个|第二个|第[一二三四五六七八九十\d]+个|yes|yep|correct|sounds good|ok|okay|そう|はい)[。.!！\s]*$/iu;
 const SHORT_REJECT = /^\s*(不对|不是|不行|不要|否|no|nope|違う|いいえ)[。.!！\s]*$/iu;
 const ASSISTANT_PROPOSAL = /(建议|可以选|选项|should we|recommend|option|propose|どうですか)|^\s*(下一版|应该|推荐|可以考虑)|(?:方案|采用|下一版).{0,80}(?:吗|[?？])/iu;
 const ASSISTANT_QUESTION = /[?？]\s*$|(?:是否|要不要|可以吗|确认吗|which|what|when|do you|should we)/iu;
@@ -20,8 +21,6 @@ function classifyTurnRelationBase(input) {
     const text = String(context.currentUserText || '').trim();
     const previousAssistant = String(context.previousAssistantText || '').trim();
     const signals = [];
-    if (!text || NOISE.test(text))
-        return decision('noise', 0.98, 'general', 0.05, 'deterministic_noise', ['noise'], false, []);
     if (SHORT_ACCEPT.test(text) && previousAssistant) {
         if (ASSISTANT_PROPOSAL.test(previousAssistant)) {
             return decision('accepts_assistant_proposal', 0.91, inferEpisodeType(previousAssistant), 0.88, 'assistant_context_acceptance', ['short_accept', 'assistant_proposal'], false, inferCandidateTypes(previousAssistant));
@@ -37,9 +36,11 @@ function classifyTurnRelationBase(input) {
         }
         return decision('corrects_previous', 0.9, 'correction', 0.9, 'assistant_fact_or_question_correction', ['short_reject', ASSISTANT_QUESTION.test(previousAssistant) ? 'assistant_question' : 'assistant_fact'], false, ['correction']);
     }
-    if (CORRECTION.test(text)) {
+    if (CORRECTION.test(text) || NEGATED_CLOSURE.test(text)) {
         return decision('corrects_previous', 0.94, 'correction', 0.9, 'explicit_correction', ['correction_marker'], false, ['correction']);
     }
+    if (!text || NOISE.test(text))
+        return decision('noise', 0.98, 'general', 0.05, 'deterministic_noise', ['noise'], false, []);
     if (EXPLICIT_SWITCH.test(text)) {
         const active = `${context.activeEpisodeSummary || ''} ${context.activeEpisodeTopicPath || ''}`.trim();
         const shift = active && hasSpecificTopicPayload(text) ? 'hard' : 'ambiguous';
@@ -86,19 +87,48 @@ export function classifyAssistantRelation(text, role = 'assistant') {
 }
 /** Background-only semantic review. The reviewer can suggest classification fields but cannot mutate memory. */
 export async function classifyTurnRelationHybrid(context, reviewer) {
+    return (await classifyTurnRelationHybridTrace(context, reviewer)).finalDecision;
+}
+export async function classifyTurnRelationHybridTrace(context, reviewer) {
     const cpuDecision = classifyTurnRelation(context);
-    if (!cpuDecision.needsLlmReview || !reviewer)
-        return cpuDecision;
+    if (!cpuDecision.needsLlmReview || !reviewer) {
+        return {
+            cpuDecision,
+            reviewerInvoked: false,
+            reviewerRawResultStatus: 'not_invoked',
+            finalDecision: cpuDecision,
+        };
+    }
     let value;
     try {
         value = await reviewer.review({ context, cpuDecision });
     }
     catch {
-        return { ...cpuDecision, signals: [...cpuDecision.signals, 'advisory_review_failed'] };
+        return {
+            cpuDecision,
+            reviewerInvoked: true,
+            reviewerRawResultStatus: 'failed',
+            finalDecision: { ...cpuDecision, signals: [...cpuDecision.signals, 'advisory_review_failed'] },
+        };
+    }
+    if (!value || typeof value !== 'object') {
+        return {
+            cpuDecision,
+            reviewerInvoked: true,
+            reviewerRawResultStatus: 'invalid',
+            finalDecision: cpuDecision,
+        };
     }
-    if (!value || typeof value !== 'object')
-        return cpuDecision;
-    const record = value;
+    const finalDecision = applyReviewerDecision(cpuDecision, value);
+    return {
+        cpuDecision,
+        reviewerInvoked: true,
+        reviewerRawResultStatus: 'accepted',
+        reviewerDecision: finalDecision,
+        finalDecision,
+    };
+}
+function applyReviewerDecision(cpuDecision, record) {
     const relation = isTurnRelation(record.relation) ? record.relation : cpuDecision.relation;
     const confidence = typeof record.confidence === 'number' && Number.isFinite(record.confidence)
         ? Math.max(0, Math.min(record.confidence, 1))
@@ -124,7 +154,7 @@ export async function classifyTurnRelationHybrid(context, reviewer) {
     };
 }
 function hasConfirmedOverlap(context, text) {
-    if (context.topicPathMatch === true || context.projectMatch === true)
+    if (context.topicPathMatch === true)
         return true;
     if ((context.entityOverlap ?? 0) >= 0.5 || (context.semanticSimilarity ?? 0) >= 0.72)
         return true;

package/dist/episode/index.d.ts

@@ -4,6 +4,9 @@ export * from './EpisodeImportIdentity.js';
 export * from './EpisodeSemanticSummarizer.js';
 export * from './EpisodeStore.js';
 export * from './EpisodeAssembler.js';
+export * from './EpisodeBoundaryAuditService.js';
+export * from './EpisodeBoundaryPolicy.js';
+export * from './EpisodeSplitPlanner.js';
 export * from './CogmemBlockStripper.js';
 export * from './CorrectionResolver.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/episode/index.js

@@ -4,5 +4,8 @@ export * from './EpisodeImportIdentity.js';
 export * from './EpisodeSemanticSummarizer.js';
 export * from './EpisodeStore.js';
 export * from './EpisodeAssembler.js';
+export * from './EpisodeBoundaryAuditService.js';
+export * from './EpisodeBoundaryPolicy.js';
+export * from './EpisodeSplitPlanner.js';
 export * from './CogmemBlockStripper.js';
 export * from './CorrectionResolver.js';

package/dist/factory.d.ts

@@ -23,9 +23,12 @@ import { ContextCortex } from './context/index.js';
 import { ProspectiveMemoryService } from './prospective/index.js';
 import { StrategyCortex } from './strategy/index.js';
 import { ContextOutcomeStore, MemoryUseJudge } from './eval/strategy/index.js';
-import { EpisodeAssembler, EpisodeStore, type EpisodeClosureMode, type EpisodeClosureReceipt, type EpisodeDreamStatus, type EpisodeListOptions, type MemoryEpisode, type TurnRelationAdvisoryReviewer } from './episode/index.js';
+import { EpisodeAssembler, EpisodeStore, type EpisodeBoundaryDecisionRecord, type EpisodeClosureMode, type EpisodeClosureReceipt, type EpisodeDreamStatus, type EpisodeListOptions, type MemoryEpisode, type TurnRelationAdvisoryReviewer } from './episode/index.js';
+import { EpisodeBoundaryAuditService, type EpisodeBoundaryAuditResult } from './episode/EpisodeBoundaryAuditService.js';
+import { EpisodeBoundaryPolicy, type EpisodeBoundaryConfig } from './episode/EpisodeBoundaryPolicy.js';
+import { EpisodeSplitPlanner, type EpisodeSplitPlan } from './episode/EpisodeSplitPlanner.js';
 import { type DreamTickOptions, type DreamTickResult } from './dream/index.js';
-import { type EnvLike } from './config/CogmemConfig.js';
+import { type EnvLike, type ConfigDiagnosticLike } from './config/CogmemConfig.js';
 import { ModelRegistry } from './models/ModelRegistry.js';
 import type { Embedder } from './store/Embedder.js';
 import { CognitiveGraphStore } from './store/CognitiveGraphStore.js';
@@ -43,7 +46,7 @@ import { MemoryGovernanceStore } from './store/MemoryGovernanceStore.js';
 import { TemporalAdjacencyStore } from './store/TemporalAdjacencyStore.js';
 import { TopologyStore } from './store/TopologyStore.js';
 import type { IVectorStore, VectorBackend } from './store/IVectorStore.js';
-import type { IngestInput, MemoryEvent, MemoryEventCausalityType, MemoryEventContext, MemoryRawEventType, MemoryEventRole, Neuron } from './types/index.js';
+import type { IngestInput, MemoryEvent, MemoryEventCausalityType, MemoryEventContext, MemoryRawEventType, MemoryEventRole, Neuron, OrderingConfidence } from './types/index.js';
 import { type ImportOptions, type ImportResult, type SnapshotMeta } from './snapshot/index.js';
 export type { DreamCuratorRunOptions, DreamCuratorRunResult } from './engine/DreamCuratorWorker.js';
 export type { DreamTickOptions, DreamTickResult } from './dream/index.js';
@@ -59,6 +62,8 @@ export interface MemoryKernelOptions {
     encryptionProvider?: EncryptionProvider;
     redactionPolicy?: RedactionPolicy | false;
     turnRelationReviewer?: TurnRelationAdvisoryReviewer;
+    episodeBoundary?: Partial<EpisodeBoundaryConfig>;
+    configDiagnostics?: ConfigDiagnosticLike[];
 }
 export interface MemoryKernelFromConfigOptions extends MemoryKernelOptions {
     configPath?: string;
@@ -267,7 +272,9 @@ export interface RawMemoryEventInput {
     lineEnd?: number;
     charStart?: number;
     charEnd?: number;
+    orderingConfidence?: OrderingConfidence;
     localDate?: string;
+    localDateSource?: 'explicit' | 'generated_utc' | 'legacy_unknown';
     metadata?: Record<string, unknown>;
 }
 export interface EpisodeMessageInput {
@@ -279,6 +286,10 @@ export interface EpisodeMessageInput {
     externalMessageId?: string;
     timestamp?: number;
     threadId?: string;
+    turnId?: string;
+    turnSeq?: number;
+    localDate?: string;
+    eventOrdinal?: number;
     metadata?: Record<string, unknown>;
 }
 export interface EpisodeMessageResult {
@@ -290,6 +301,17 @@ export interface EpisodeMessageResult {
     sealed: boolean;
     dreamRecommended: boolean;
     dreamRan: false;
+    boundaryTriggered?: boolean;
+    boundaryDetected?: boolean;
+    boundaryApplied?: boolean;
+    boundaryMode?: string;
+    boundaryDecisionId?: string;
+    boundaryGuardCodes?: string[];
+    boundaryAuditRecorded?: boolean;
+    boundaryAuditStatus?: string;
+    previousEpisodeId?: string;
+    reviewerRawResultStatus?: string;
+    warnings?: string[];
 }
 export type EpisodeRepairInput = {
     operation: 'move-event';
@@ -458,10 +480,14 @@ export declare class MemoryKernel {
     readonly pipelineMetrics: PipelineMetrics;
     readonly episodeStore: EpisodeStore;
     readonly episodeAssembler: EpisodeAssembler;
+    readonly episodeBoundaryPolicy: EpisodeBoundaryPolicy;
+    readonly episodeBoundaryAuditService: EpisodeBoundaryAuditService;
+    readonly episodeSplitPlanner: EpisodeSplitPlanner;
     readonly userTopicPathRegistry: UserTopicPathRegistry;
     readonly topicAliasRegistry: TopicAliasRegistry;
     readonly topicRelationGraph: TopicRelationGraph;
     readonly topicGovernance: TopicGovernance;
+    readonly configDiagnostics: ConfigDiagnosticLike[];
     private readonly dbPath;
     private readonly embedder;
     private readonly embeddingProvider?;
@@ -559,6 +585,7 @@ export declare class MemoryKernel {
         now?: number;
         batchSeal?: boolean;
         forceBatchSeal?: boolean;
+        allowNonUserEpisodeStart?: boolean;
     }): import("./episode/EpisodeAssembler.js").EpisodeAssemblyResult;
     assembleEpisodeTurnAsync(events: MemoryEvent[], input: {
         projectId: string;
@@ -568,6 +595,7 @@ export declare class MemoryKernel {
         now?: number;
         batchSeal?: boolean;
         forceBatchSeal?: boolean;
+        allowNonUserEpisodeStart?: boolean;
     }): Promise<import("./episode/EpisodeAssembler.js").EpisodeAssemblyResult>;
     appendRawEventToEpisode(event: MemoryEvent, input: {
         projectId: string;
@@ -577,6 +605,8 @@ export declare class MemoryKernel {
     }): import("./episode/EpisodeAssembler.js").EpisodeAssemblyResult;
     appendEpisodeMessage(input: EpisodeMessageInput): EpisodeMessageResult;
     appendEpisodeMessageAsync(input: EpisodeMessageInput): Promise<EpisodeMessageResult>;
+    private finishIngestMessage;
+    private finishIngestMessageAsync;
     private resumeEpisodeMessage;
     private resumeEpisodeMessageAsync;
     private assertEpisodeIngestIdentity;
@@ -603,6 +633,31 @@ export declare class MemoryKernel {
         limit?: number;
     }): EpisodeClosureReceipt[];
     listEpisodeEventLinks(episodeId: string): import("./episode/EpisodeTypes.js").EpisodeEventLink[];
+    auditEpisodeBoundaries(options: {
+        projectId: string;
+        episodeId?: string;
+        status?: MemoryEpisode['status'];
+        limit?: number;
+        cursor?: string;
+        maxEvents?: number;
+        maxDurationMs?: number;
+        maxIdleGapMs?: number;
+        timezone?: string;
+    }): EpisodeBoundaryAuditResult;
+    listEpisodeBoundaryDecisions(options: {
+        projectId: string;
+        primaryEventId?: string;
+        limit?: number;
+    }): EpisodeBoundaryDecisionRecord[];
+    planEpisodeSplit(options: {
+        projectId: string;
+        episodeId: string;
+        maxEvents?: number;
+        maxDurationMs?: number;
+        maxIdleGapMs?: number;
+        timezone?: string;
+        includeEventIds?: boolean;
+    }): EpisodeSplitPlan;
     getEpisodeDreamStatus(projectId?: string): EpisodeDreamStatus;
     retryFailedEpisodeDreams(projectId?: string): number;
     repairEpisodes(options?: {
@@ -614,8 +669,12 @@ export declare class MemoryKernel {
         assigned: number;
         unassigned: number;
         unassignedEventIds: string[];
+        nextGlobalSeq: number | undefined;
+        hasMore: boolean;
     };
     repairEpisode(input: EpisodeRepairInput): EpisodeRepairResult;
+    private repairEpisodeInTransaction;
+    private invalidatePromotedCandidate;
     listDreamCandidates(options?: DreamCandidateListOptions): DreamCandidateRecord[];
     countDreamCandidates(options?: Omit<DreamCandidateListOptions, 'limit'>): number;
     reviewDreamCandidate(input: CandidateReviewInput): CandidateReviewResult;