stellar-memory 0.8.3 → 1.0.0

package/dist/engine/procedural.js

@@ -14,6 +14,7 @@
 import { randomUUID, createHash } from 'node:crypto';
 import { getMemoriesByProject, insertMemory } from '../storage/queries.js';
 import { getConfig } from '../utils/config.js';
+import { STOP_WORDS } from '../utils/stopwords.js';
 import { recencyScore, frequencyScore, importanceToDistance, } from './orbit.js';
 // ---------------------------------------------------------------------------
 // Pattern detection
@@ -40,17 +41,12 @@ function findRepeatedPatterns(memories) {
  * Uses the most common non-trivial words across all content.
  */
 function extractGroupKeywords(memories) {
-    const stopWords = new Set([
-        'the', 'a', 'an', 'is', 'it', 'in', 'on', 'at', 'to', 'for',
-        'of', 'and', 'or', 'but', 'with', 'from', 'that', 'this', 'was',
-        'are', 'be', 'been', 'been', 'by', 'as', 'not', 'use', 'used',
-    ]);
     const wordCount = new Map();
     for (const mem of memories) {
         const words = (mem.content + ' ' + mem.summary)
             .toLowerCase()
             .split(/[\s,.\-:;()\[\]{}'"!?/\\]+/)
-            .filter(w => w.length > 3 && !stopWords.has(w));
+            .filter(w => w.length > 3 && !STOP_WORDS.has(w));
         for (const w of words) {
             wordCount.set(w, (wordCount.get(w) ?? 0) + 1);
         }
@@ -215,45 +211,4 @@ export function formatProceduralSection(memories) {
 export function getProceduralDecayMultiplier() {
     return 0.3;
 }
-// ---------------------------------------------------------------------------
-// Rule suggestion
-// ---------------------------------------------------------------------------
-/**
- * Analyse the last 50 memories and suggest concrete procedural rules.
- *
- * Returns candidates sorted by confidence (highest first). Confidence is
- * the proportion of the tag-group that supports a consistent pattern.
- *
- * Skips rules that already exist as procedural memories (by rule text match).
- */
-export function suggestRules(recentMemories) {
-    const sample = recentMemories.slice(0, 50);
-    const groups = findRepeatedPatterns(sample);
-    const results = [];
-    for (const [tag, groupMemories] of groups) {
-        const total = groupMemories.length;
-        const type = dominantType(groupMemories);
-        const keywords = extractGroupKeywords(groupMemories);
-        // Confidence: how consistently the group points in one direction
-        const confidence = Math.min(1.0, (total - 2) / 10 + (type ? 0.2 : 0));
-        let rule;
-        if (type === 'error') {
-            rule = keywords.length > 0
-                ? `When facing ${tag} errors: address ${keywords.slice(0, 2).join(' and ')}`
-                : `Document and track ${tag} error resolutions systematically`;
-        }
-        else if (type === 'decision') {
-            rule = keywords.length > 0
-                ? `For ${tag} decisions: apply ${keywords.slice(0, 2).join(' and ')} criteria`
-                : `Maintain consistent decision criteria for ${tag}`;
-        }
-        else {
-            rule = keywords.length > 0
-                ? `${tag} work follows pattern: ${keywords.slice(0, 3).join(', ')}`
-                : `Track ${tag} as a key recurring theme`;
-        }
-        results.push({ rule, confidence, evidence: groupMemories });
-    }
-    return results.sort((a, b) => b.confidence - a.confidence);
-}
 //# sourceMappingURL=procedural.js.map

package/dist/engine/procedural.js.map

@@ -1 +1 @@
-{"version":3,"file":"procedural.js","sourceRoot":"","sources":["../../src/engine/procedural.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"procedural.js","sourceRoot":"","sources":["../../src/engine/procedural.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EACL,YAAY,EACZ,cAAc,EACd,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E;;;GAGG;AACH,SAAS,oBAAoB,CAAC,QAAkB;IAC9C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAoB,CAAC;IAE9C,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YAChD,SAAS,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,oCAAoC;IACpC,OAAO,IAAI,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC;AACxE,CAAC;AAED;;;GAGG;AACH,SAAS,oBAAoB,CAAC,QAAkB;IAC9C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,OAAO,GAAG,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC;aAC5C,WAAW,EAAE;aACb,KAAK,CAAC,4BAA4B,CAAC;aACnC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAEnD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;SAC5B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;SAC3B,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,QAAkB;IACtC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAsB,CAAC;IACjD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5D,CAAC;IACD,MAAM,QAAQ,GAAG,CAAC,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1E,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,2EAA2E;IAC3E,OAAO,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACnE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAAkB,EAClB,OAAe;IAEf,MAAM,MAAM,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAyE,EAAE,CAAC;IAEzF,KAAK,MAAM,CAAC,GAAG,EAAE,aAAa,CAAC,IAAI,MAAM,EAAE,CAAC;QAC1C,MAAM,QAAQ,GAAG,oBAAoB,CAAC,aAAa,CAAC,CAAC;QACrD,MAAM,IAAI,GAAG,YAAY,CAAC,aAAa,CAAC,CAAC;QACzC,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC;QAEvC,IAAI,OAAe,CAAC;QACpB,IAAI,aAAqB,CAAC;QAE1B,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACrB,OAAO,GAAG,kCAAkC,GAAG,MAAM,SAAS,eAAe,CAAC;YAC9E,aAAa,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC;gBACjC,CAAC,CAAC,qBAAqB,GAAG,0BAA0B,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBACrF,CAAC,CAAC,qBAAqB,GAAG,iDAAiD,CAAC;QAChF,CAAC;aAAM,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YAC/B,OAAO,GAAG,sCAAsC,GAAG,MAAM,SAAS,eAAe,CAAC;YAClF,aAAa,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC;gBACjC,CAAC,CAAC,OAAO,GAAG,kCAAkC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBAC/E,CAAC,CAAC,OAAO,GAAG,kDAAkD,CAAC;QACnE,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,4BAA4B,GAAG,YAAY,SAAS,WAAW,CAAC;YAC1E,aAAa,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC;gBACjC,CAAC,CAAC,MAAM,OAAO,KAAK,GAAG,+BAA+B,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBACvF,CAAC,CAAC,MAAM,OAAO,KAAK,GAAG,2BAA2B,CAAC;QACvD,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,0DAA0D;IAC1D,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;AAC3D,CAAC;AAED,8EAA8E;AAC9E,6BAA6B;AAC7B,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAY,EACZ,QAAkB,EAClB,OAAe;IAEf,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,GAAG,CAAC;IAEnB,MAAM,OAAO,GAAG,SAAS,IAAI,eAAe,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAClE,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IAE5E,uDAAuD;IACvD,MAAM,SAAS,GAAG,IAAI;SACnB,WAAW,EAAE;SACb,KAAK,CAAC,eAAe,CAAC;SACtB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,CAAC,YAAY,EAAE,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAE/D,4DAA4D;IAC5D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAC/D,MAAM,IAAI,GAAG,cAAc,CAAC,CAAC,EAAE,MAAM,CAAC,wBAAwB,CAAC,CAAC;IAChE,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,+CAA+C;IAEhE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACpB,GAAG,EACH,MAAM,CAAC,OAAO,CAAC,OAAO,GAAG,GAAG;QAC1B,MAAM,CAAC,OAAO,CAAC,SAAS,GAAG,IAAI;QAC/B,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,MAAM;QAC9B,MAAM,CAAC,OAAO,CAAC,SAAS,GAAG,GAAG,CACjC,CAAC;IAEF,MAAM,QAAQ,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEvE,OAAO,YAAY,CAAC;QAClB,EAAE,EAAE,UAAU,EAAE;QAChB,OAAO;QACP,OAAO;QACP,OAAO;QACP,IAAI,EAAE,YAA0B;QAChC,IAAI;QACJ,QAAQ;QACR,UAAU,EAAE,KAAK;QACjB,QAAQ,EAAE,CAAC;QACX,MAAM;QACN,YAAY,EAAE,CAAC;QACf,gBAAgB,EAAE,IAAI;QACtB,QAAQ,EAAE,EAAE,cAAc,EAAE,QAAQ,CAAC,MAAM,EAAE;QAC7C,YAAY,EAAE,WAAW;QACzB,UAAU,EAAE,GAAG;QACf,UAAU,EAAE,GAAG;QACf,UAAU,EAAE,IAAI;KACjB,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,MAAM,GAAG,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC1C,OAAO,GAAG;SACP,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC;SACpC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;AACjD,CAAC;AAED,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAkB;IACxD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAErC,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEjC,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC7B,6DAA6D;QAC7D,MAAM,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QACjD,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,OAAO,sBAAsB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAClD,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,4BAA4B;IAC1C,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/engine/services/commit-service.d.ts

@@ -0,0 +1,29 @@
+/**
+ * commit-service.ts — Unified business logic for session commit.
+ *
+ * Wraps commitToSun + recalculateOrbits so that both MCP handleCommit
+ * and API POST /api/sun/commit go through the same code path.
+ *
+ * The MCP handler also reads procedural memories, temporal summary, and
+ * conflict counts to format its response text — those are presentation
+ * concerns and stay in the MCP layer. This service returns the raw
+ * orbit changes so callers can decide what to display.
+ */
+import type { OrbitChange } from '../types.js';
+export interface CommitInput {
+    current_work: string;
+    decisions?: string[];
+    next_steps?: string[];
+    errors?: string[];
+    context?: string;
+}
+export interface CommitResult {
+    orbitChanges: OrbitChange[];
+}
+/**
+ * Persist session context to the sun and recalculate orbital distances.
+ *
+ * Mirrors the core logic of handleCommit, minus MCP response formatting.
+ */
+export declare function commitSession(input: CommitInput, project: string): CommitResult;
+//# sourceMappingURL=commit-service.d.ts.map

package/dist/engine/services/commit-service.js

@@ -0,0 +1,35 @@
+/**
+ * commit-service.ts — Unified business logic for session commit.
+ *
+ * Wraps commitToSun + recalculateOrbits so that both MCP handleCommit
+ * and API POST /api/sun/commit go through the same code path.
+ *
+ * The MCP handler also reads procedural memories, temporal summary, and
+ * conflict counts to format its response text — those are presentation
+ * concerns and stay in the MCP layer. This service returns the raw
+ * orbit changes so callers can decide what to display.
+ */
+import { commitToSun } from '../sun.js';
+import { recalculateOrbits } from '../orbit.js';
+import { getConfig } from '../../utils/config.js';
+// ---------------------------------------------------------------------------
+// commitSession
+// ---------------------------------------------------------------------------
+/**
+ * Persist session context to the sun and recalculate orbital distances.
+ *
+ * Mirrors the core logic of handleCommit, minus MCP response formatting.
+ */
+export function commitSession(input, project) {
+    commitToSun(project, {
+        current_work: input.current_work,
+        decisions: input.decisions ?? [],
+        next_steps: input.next_steps ?? [],
+        errors: input.errors ?? [],
+        context: input.context ?? '',
+    });
+    const config = getConfig();
+    const orbitChanges = recalculateOrbits(project, config);
+    return { orbitChanges };
+}
+//# sourceMappingURL=commit-service.js.map

package/dist/engine/services/commit-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-service.js","sourceRoot":"","sources":["../../../src/engine/services/commit-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAkBlD,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAkB,EAClB,OAAe;IAEf,WAAW,CAAC,OAAO,EAAE;QACnB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,SAAS,EAAK,KAAK,CAAC,SAAS,IAAK,EAAE;QACpC,UAAU,EAAI,KAAK,CAAC,UAAU,IAAI,EAAE;QACpC,MAAM,EAAQ,KAAK,CAAC,MAAM,IAAQ,EAAE;QACpC,OAAO,EAAO,KAAK,CAAC,OAAO,IAAO,EAAE;KACrC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,YAAY,GAAG,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAExD,OAAO,EAAE,YAAY,EAAE,CAAC;AAC1B,CAAC"}

package/dist/engine/services/index.d.ts

@@ -0,0 +1,4 @@
+export * from './memory-service.js';
+export * from './recall-service.js';
+export * from './commit-service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/services/index.js

@@ -0,0 +1,4 @@
+export * from './memory-service.js';
+export * from './recall-service.js';
+export * from './commit-service.js';
+//# sourceMappingURL=index.js.map

package/dist/engine/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}

package/dist/engine/services/memory-service.d.ts

@@ -0,0 +1,48 @@
+/**
+ * memory-service.ts — Unified business logic for memory creation.
+ *
+ * Both MCP handlers and API routes call this instead of invoking
+ * planet.ts + individual engine modules independently.
+ *
+ * Replicates the full orchestration sequence from handleRemember:
+ *   1. createMemory  (dedup, embedding scheduling, quality, corona)
+ *   2. extractRelationships (background, fire-and-forget)
+ *   3. setTemporalBounds  (valid_from = now)
+ *   4. calculateQuality   (with peer comparison for accurate uniqueness score)
+ *   5. detectConflicts    (async, persists MemoryConflict rows)
+ *   6. detectSupersession (auto-supersede if pattern detected)
+ */
+import type { Memory, MemoryType, QualityScore, MemoryConflict } from '../types.js';
+export interface CreateMemoryInput {
+    content: string;
+    type?: MemoryType;
+    tags?: string[];
+    impact?: number;
+    summary?: string;
+    source_path?: string;
+}
+export interface CreateMemoryResult {
+    memory: Memory;
+    quality: QualityScore;
+    qualityFeedback: string | null;
+    conflicts: MemoryConflict[];
+    conflictWarnings: string;
+    supersededId: string | null;
+}
+export interface ForgetMemoryInput {
+    id: string;
+    mode?: 'push' | 'delete';
+}
+/**
+ * Create a memory with full business logic applied.
+ *
+ * Mirrors the sequence in handleRemember, minus the MCP response formatting.
+ * Safe to call from both API routes and (eventually) MCP handlers.
+ */
+export declare function createMemoryFull(input: CreateMemoryInput, project: string): Promise<CreateMemoryResult>;
+/**
+ * Forget a memory (push to Oort cloud or soft-delete).
+ * Thin wrapper kept here so API routes import from one place.
+ */
+export declare function forgetMemoryFull(input: ForgetMemoryInput): void;
+//# sourceMappingURL=memory-service.d.ts.map

package/dist/engine/services/memory-service.js

@@ -0,0 +1,85 @@
+/**
+ * memory-service.ts — Unified business logic for memory creation.
+ *
+ * Both MCP handlers and API routes call this instead of invoking
+ * planet.ts + individual engine modules independently.
+ *
+ * Replicates the full orchestration sequence from handleRemember:
+ *   1. createMemory  (dedup, embedding scheduling, quality, corona)
+ *   2. extractRelationships (background, fire-and-forget)
+ *   3. setTemporalBounds  (valid_from = now)
+ *   4. calculateQuality   (with peer comparison for accurate uniqueness score)
+ *   5. detectConflicts    (async, persists MemoryConflict rows)
+ *   6. detectSupersession (auto-supersede if pattern detected)
+ */
+import { createMemory, forgetMemory } from '../planet.js';
+import { calculateQuality, getQualityFeedback } from '../quality.js';
+import { detectConflicts, formatConflictWarnings } from '../conflict.js';
+import { detectSupersession, supersedeMemory, setTemporalBounds } from '../temporal.js';
+import { extractRelationships } from '../constellation.js';
+import { getMemoriesByProject } from '../../storage/queries.js';
+import { createLogger } from '../../utils/logger.js';
+const log = createLogger('memory-service');
+// ---------------------------------------------------------------------------
+// createMemoryFull
+// ---------------------------------------------------------------------------
+/**
+ * Create a memory with full business logic applied.
+ *
+ * Mirrors the sequence in handleRemember, minus the MCP response formatting.
+ * Safe to call from both API routes and (eventually) MCP handlers.
+ */
+export async function createMemoryFull(input, project) {
+    // 1. Create memory — handles content dedup, semantic dedup, embedding
+    //    scheduling, initial quality score, and corona cache placement.
+    const memory = createMemory({
+        project,
+        content: input.content,
+        summary: input.summary,
+        type: input.type ?? 'observation',
+        impact: input.impact,
+        tags: input.tags,
+    });
+    // 2. Background relationship extraction (constellation graph).
+    //    Fire-and-forget — never blocks the caller.
+    extractRelationships(memory, project).catch(() => {
+        log.debug('Background constellation extraction failed', { id: memory.id });
+    });
+    // 3. Set valid_from to now so temporal queries work correctly.
+    setTemporalBounds(memory.id, new Date().toISOString(), undefined);
+    // 4. Quality scoring with full peer comparison for accurate uniqueness.
+    const allMemories = getMemoriesByProject(project);
+    const quality = calculateQuality(memory, allMemories);
+    const qualityFeedback = getQualityFeedback(quality);
+    // 5. Conflict detection — async, persists MemoryConflict rows.
+    const conflicts = await detectConflicts(memory, project);
+    const conflictWarnings = formatConflictWarnings(conflicts);
+    // 6. Temporal supersession — if the new memory signals a switch/replacement,
+    //    auto-supersede the older conflicting memory.
+    let supersededId = null;
+    const supersessionCandidate = detectSupersession(memory, allMemories);
+    if (supersessionCandidate) {
+        supersedeMemory(supersessionCandidate.id, memory.id);
+        supersededId = supersessionCandidate.id;
+        log.debug('Auto-supersession applied', {
+            newId: memory.id,
+            oldId: supersessionCandidate.id,
+        });
+    }
+    return {
+        memory,
+        quality,
+        qualityFeedback,
+        conflicts,
+        conflictWarnings,
+        supersededId,
+    };
+}
+/**
+ * Forget a memory (push to Oort cloud or soft-delete).
+ * Thin wrapper kept here so API routes import from one place.
+ */
+export function forgetMemoryFull(input) {
+    forgetMemory(input.id, input.mode ?? 'push');
+}
+//# sourceMappingURL=memory-service.js.map

package/dist/engine/services/memory-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-service.js","sourceRoot":"","sources":["../../../src/engine/services/memory-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxF,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,MAAM,GAAG,GAAG,YAAY,CAAC,gBAAgB,CAAC,CAAC;AA6B3C,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAwB,EACxB,OAAe;IAEf,sEAAsE;IACtE,oEAAoE;IACpE,MAAM,MAAM,GAAG,YAAY,CAAC;QAC1B,OAAO;QACP,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EAAK,KAAK,CAAC,IAAI,IAAI,aAAa;QACpC,MAAM,EAAG,KAAK,CAAC,MAAM;QACrB,IAAI,EAAK,KAAK,CAAC,IAAI;KACpB,CAAC,CAAC;IAEH,+DAA+D;IAC/D,gDAAgD;IAChD,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;QAC/C,GAAG,CAAC,KAAK,CAAC,4CAA4C,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;IAEH,+DAA+D;IAC/D,iBAAiB,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,SAAS,CAAC,CAAC;IAElE,wEAAwE;IACxE,MAAM,WAAW,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACtD,MAAM,eAAe,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAEpD,+DAA+D;IAC/D,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzD,MAAM,gBAAgB,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAE3D,6EAA6E;IAC7E,kDAAkD;IAClD,IAAI,YAAY,GAAkB,IAAI,CAAC;IACvC,MAAM,qBAAqB,GAAG,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACtE,IAAI,qBAAqB,EAAE,CAAC;QAC1B,eAAe,CAAC,qBAAqB,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QACrD,YAAY,GAAG,qBAAqB,CAAC,EAAE,CAAC;QACxC,GAAG,CAAC,KAAK,CAAC,2BAA2B,EAAE;YACrC,KAAK,EAAG,MAAM,CAAC,EAAE;YACjB,KAAK,EAAG,qBAAqB,CAAC,EAAE;SACjC,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,MAAM;QACN,OAAO;QACP,eAAe;QACf,SAAS;QACT,gBAAgB;QAChB,YAAY;KACb,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAwB;IACvD,YAAY,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,IAAI,MAAM,CAAC,CAAC;AAC/C,CAAC"}

package/dist/engine/services/recall-service.d.ts

@@ -0,0 +1,31 @@
+/**
+ * recall-service.ts — Unified business logic for memory recall.
+ *
+ * Wraps recallMemoriesAsync with the same options shape that
+ * both MCP handleRecall and API GET /memories/search use.
+ *
+ * The key value-add vs calling recallMemoriesAsync directly:
+ *   - Normalises the type filter ('all' → undefined internally)
+ *   - Provides a typed RecallInput / RecallResult contract
+ */
+import type { Memory, MemoryType } from '../types.js';
+export interface RecallInput {
+    query: string;
+    type?: MemoryType | 'all';
+    limit?: number;
+    minDistance?: number;
+    maxDistance?: number;
+    excludeIds?: Set<string>;
+}
+export interface RecallResult {
+    memories: Memory[];
+}
+/**
+ * Recall memories using the full 3-tier hybrid pipeline
+ * (Corona cache → FTS5 active zone → FTS5+vector full hybrid).
+ *
+ * Access boost and orbit update are applied automatically by
+ * recallMemoriesAsync for all returned memories.
+ */
+export declare function recallMemories(input: RecallInput, project: string): Promise<RecallResult>;
+//# sourceMappingURL=recall-service.d.ts.map

package/dist/engine/services/recall-service.js

@@ -0,0 +1,35 @@
+/**
+ * recall-service.ts — Unified business logic for memory recall.
+ *
+ * Wraps recallMemoriesAsync with the same options shape that
+ * both MCP handleRecall and API GET /memories/search use.
+ *
+ * The key value-add vs calling recallMemoriesAsync directly:
+ *   - Normalises the type filter ('all' → undefined internally)
+ *   - Provides a typed RecallInput / RecallResult contract
+ */
+import { recallMemoriesAsync } from '../planet.js';
+// ---------------------------------------------------------------------------
+// recallMemories
+// ---------------------------------------------------------------------------
+/**
+ * Recall memories using the full 3-tier hybrid pipeline
+ * (Corona cache → FTS5 active zone → FTS5+vector full hybrid).
+ *
+ * Access boost and orbit update are applied automatically by
+ * recallMemoriesAsync for all returned memories.
+ */
+export async function recallMemories(input, project) {
+    const memoryType = input.type === 'all' || input.type === undefined
+        ? undefined
+        : input.type;
+    const memories = await recallMemoriesAsync(project, input.query, {
+        type: memoryType,
+        minDistance: input.minDistance,
+        maxDistance: input.maxDistance,
+        limit: input.limit ?? 10,
+        excludeIds: input.excludeIds,
+    });
+    return { memories };
+}
+//# sourceMappingURL=recall-service.js.map

package/dist/engine/services/recall-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall-service.js","sourceRoot":"","sources":["../../../src/engine/services/recall-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAmBnD,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAAkB,EAClB,OAAe;IAEf,MAAM,UAAU,GACd,KAAK,CAAC,IAAI,KAAK,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QAC9C,CAAC,CAAC,SAAS;QACX,CAAC,CAAE,KAAK,CAAC,IAAmB,CAAC;IAEjC,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,EAAE;QAC/D,IAAI,EAAS,UAAU;QACvB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,KAAK,EAAQ,KAAK,CAAC,KAAK,IAAI,EAAE;QAC9B,UAAU,EAAG,KAAK,CAAC,UAAU;KAC9B,CAAC,CAAC;IAEH,OAAO,EAAE,QAAQ,EAAE,CAAC;AACtB,CAAC"}

package/dist/engine/session-policy.d.ts

@@ -0,0 +1,15 @@
+import type { Memory, SunState } from './types.js';
+export interface SessionCommitDraft {
+    current_work?: string;
+    decisions: string[];
+    next_steps: string[];
+    errors: string[];
+    context?: string;
+}
+export declare function noteRecall(project: string, query: string): void;
+export declare function noteRemember(project: string, memory: Pick<Memory, 'type' | 'summary' | 'content'>): void;
+export declare function noteObserve(project: string, summary: string): void;
+export declare function clearSessionActivity(project: string): void;
+export declare function getSessionCommitDraft(project: string, existingSun?: SunState | null): SessionCommitDraft | null;
+export declare function formatSessionDraftNote(project: string, existingSun?: SunState | null): string | null;
+//# sourceMappingURL=session-policy.d.ts.map

package/dist/engine/session-policy.js

@@ -0,0 +1,103 @@
+const MAX_RECALL_QUERIES = 5;
+const MAX_TYPE_SUMMARIES = 8;
+const MAX_OBSERVED_SUMMARIES = 5;
+const activities = new Map();
+function createEmptyRememberedByType() {
+    return {
+        decision: [],
+        observation: [],
+        task: [],
+        context: [],
+        error: [],
+        milestone: [],
+        procedural: [],
+    };
+}
+function normalizeSummary(value) {
+    return (value ?? '')
+        .replace(/\s+/g, ' ')
+        .trim()
+        .slice(0, 160);
+}
+function pushUnique(target, value, max) {
+    const normalized = normalizeSummary(value);
+    if (!normalized || target.includes(normalized))
+        return;
+    target.unshift(normalized);
+    if (target.length > max)
+        target.length = max;
+}
+function getActivity(project) {
+    let activity = activities.get(project);
+    if (!activity) {
+        activity = {
+            recallQueries: [],
+            rememberedByType: createEmptyRememberedByType(),
+            observedSummaries: [],
+            updatedAt: new Date(0).toISOString(),
+        };
+        activities.set(project, activity);
+    }
+    activity.updatedAt = new Date().toISOString();
+    return activity;
+}
+export function noteRecall(project, query) {
+    const activity = getActivity(project);
+    pushUnique(activity.recallQueries, query, MAX_RECALL_QUERIES);
+}
+export function noteRemember(project, memory) {
+    const activity = getActivity(project);
+    const summary = normalizeSummary(memory.summary) || normalizeSummary(memory.content);
+    pushUnique(activity.rememberedByType[memory.type], summary, MAX_TYPE_SUMMARIES);
+}
+export function noteObserve(project, summary) {
+    const activity = getActivity(project);
+    pushUnique(activity.observedSummaries, summary, MAX_OBSERVED_SUMMARIES);
+}
+export function clearSessionActivity(project) {
+    activities.delete(project);
+}
+export function getSessionCommitDraft(project, existingSun) {
+    const activity = activities.get(project);
+    if (!activity)
+        return null;
+    const decisions = [
+        ...activity.rememberedByType.decision,
+        ...activity.rememberedByType.milestone,
+    ].slice(0, MAX_TYPE_SUMMARIES);
+    const next_steps = activity.rememberedByType.task.slice(0, MAX_TYPE_SUMMARIES);
+    const errors = activity.rememberedByType.error.slice(0, MAX_TYPE_SUMMARIES);
+    const current_work = existingSun?.current_work?.trim()
+        || activity.recallQueries[0]
+        || activity.rememberedByType.task[0]
+        || activity.rememberedByType.context[0]
+        || activity.rememberedByType.decision[0]
+        || activity.observedSummaries[0];
+    const contextParts = [
+        ...activity.rememberedByType.context.slice(0, 3),
+        ...activity.observedSummaries.slice(0, 2),
+    ];
+    const context = contextParts.length > 0 ? contextParts.join(' | ') : existingSun?.project_context;
+    if (!current_work && decisions.length === 0 && next_steps.length === 0 && errors.length === 0 && !context) {
+        return null;
+    }
+    return { current_work, decisions, next_steps, errors, context };
+}
+export function formatSessionDraftNote(project, existingSun) {
+    const draft = getSessionCommitDraft(project, existingSun);
+    if (!draft)
+        return null;
+    const parts = [];
+    if (draft.current_work)
+        parts.push(`topic: ${draft.current_work}`);
+    if (draft.decisions.length > 0)
+        parts.push(`decisions: ${draft.decisions.length}`);
+    if (draft.next_steps.length > 0)
+        parts.push(`steps: ${draft.next_steps.length}`);
+    if (draft.errors.length > 0)
+        parts.push(`errors: ${draft.errors.length}`);
+    if (parts.length === 0)
+        return null;
+    return `Session draft active | ${parts.join(' | ')}`;
+}
+//# sourceMappingURL=session-policy.js.map

package/dist/engine/session-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-policy.js","sourceRoot":"","sources":["../../src/engine/session-policy.ts"],"names":[],"mappings":"AAiBA,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAC7B,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAC7B,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAEjC,MAAM,UAAU,GAAG,IAAI,GAAG,EAA2B,CAAC;AAEtD,SAAS,2BAA2B;IAClC,OAAO;QACL,QAAQ,EAAE,EAAE;QACZ,WAAW,EAAE,EAAE;QACf,IAAI,EAAE,EAAE;QACR,OAAO,EAAE,EAAE;QACX,KAAK,EAAE,EAAE;QACT,SAAS,EAAE,EAAE;QACb,UAAU,EAAE,EAAE;KACf,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAgC;IACxD,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;SACjB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE;SACN,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACnB,CAAC;AAED,SAAS,UAAU,CAAC,MAAgB,EAAE,KAAa,EAAE,GAAW;IAC9D,MAAM,UAAU,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO;IACvD,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3B,IAAI,MAAM,CAAC,MAAM,GAAG,GAAG;QAAE,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC;AAC/C,CAAC;AAED,SAAS,WAAW,CAAC,OAAe;IAClC,IAAI,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,QAAQ,GAAG;YACT,aAAa,EAAE,EAAE;YACjB,gBAAgB,EAAE,2BAA2B,EAAE;YAC/C,iBAAiB,EAAE,EAAE;YACrB,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;SACrC,CAAC;QACF,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;IACD,QAAQ,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,KAAa;IACvD,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACtC,UAAU,CAAC,QAAQ,CAAC,aAAa,EAAE,KAAK,EAAE,kBAAkB,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,MAAoD;IAChG,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACrF,UAAU,CAAC,QAAQ,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC;AAClF,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,OAAe;IAC1D,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACtC,UAAU,CAAC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,EAAE,sBAAsB,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAe,EAAE,WAA6B;IAClF,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3B,MAAM,SAAS,GAAG;QAChB,GAAG,QAAQ,CAAC,gBAAgB,CAAC,QAAQ;QACrC,GAAG,QAAQ,CAAC,gBAAgB,CAAC,SAAS;KACvC,CAAC,KAAK,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC;IAC/B,MAAM,UAAU,GAAG,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC;IAC/E,MAAM,MAAM,GAAG,QAAQ,CAAC,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC;IAE5E,MAAM,YAAY,GAAG,WAAW,EAAE,YAAY,EAAE,IAAI,EAAE;WACjD,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;WACzB,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;WACjC,QAAQ,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;WACpC,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC;WACrC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAEnC,MAAM,YAAY,GAAG;QACnB,GAAG,QAAQ,CAAC,gBAAgB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QAChD,GAAG,QAAQ,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;KAC1C,CAAC;IACF,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,eAAe,CAAC;IAElG,IAAI,CAAC,YAAY,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAC1G,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAe,EAAE,WAA6B;IACnF,MAAM,KAAK,GAAG,qBAAqB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC1D,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,KAAK,CAAC,YAAY;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;IACnE,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,cAAc,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IACnF,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;IACjF,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAE1E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,0BAA0B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;AACvD,CAAC"}

package/dist/engine/sun.d.ts

@@ -40,12 +40,16 @@ export declare function commitToSun(project: string, data: {
  * remaining token budget before being appended (progressive truncation).
  * This ensures the most critical context always fits regardless of budget.
  *
- * New priority order (Corona-aware):
+ * Priority order (Corona-aware):
  *   1. Header
- *   2. CORE IDENTITY ??core zone memories (instant recall, ~40% budget)
- *   3. WORKING ON (current_work, ~10%)
- *   4. ACTIVE CONTEXT ??near zone memories (~25%)
- *   5. RECENT DECISIONS / NEXT STEPS / ACTIVE ISSUES (~25%)
+ *   2. ALERTS    -- proactive conflict/stale-task/decision notices (high priority)
+ *   3. CORE      -- core zone memories (instant recall, ~40% budget)
+ *   4. WORKING ON  (current_work, ~10%)
+ *   5. NEAR      -- near zone memories (~25%)
+ *   6. RECENT DECISIONS / NEXT STEPS / ACTIVE ISSUES (~25%)
+ *
+ * IMPORTANT: Callers must NOT append additional content to the result.
+ * All sections (alerts, core, near, working state) are budget-managed here.
  */
 export declare function formatSunContent(sun: SunState, coreMemories: Memory[], nearMemories: Memory[]): string;
 /**