chati-dev 4.0.10 → 4.1.0

package/src/memory/session-digest.js

@@ -56,6 +56,144 @@ export function buildSessionDigest(projectDir, sessionState) {
   return digest;
 }
 
+/**
+ * Maximum characters for the structured digest (~10K tokens).
+ */
+const MAX_STRUCTURED_CHARS = 40_000;
+
+/**
+ * Section token budgets for structured digest (chars = tokens * 4).
+ */
+const SECTION_BUDGETS = {
+  current_agent:     400,   // ~100 tokens
+  pipeline_position: 400,   // ~100 tokens
+  active_task:       2000,  // ~500 tokens
+  files_changed:     4000,  // ~1000 tokens
+  blockers:          4000,  // ~1000 tokens
+  decisions_made:    12000, // ~3000 tokens
+  gotchas_found:     8000,  // ~2000 tokens
+  next_steps:        9200,  // ~2300 tokens
+};
+
+/**
+ * Build a structured 8-section session digest with token budgets.
+ * Richer than buildSessionDigest — captures decisions, blockers, gotchas,
+ * files changed, and next steps for better context recovery after compaction.
+ *
+ * Inspired by Claude Code's structured session memory (10 sections, 12K tokens).
+ *
+ * @param {string} projectDir - Project directory
+ * @param {object} sessionState - Current session.yaml data
+ * @param {object} [enrichment={}] - Additional context from hooks/agents
+ * @param {string[]} [enrichment.filesChanged] - Files modified in session
+ * @param {string[]} [enrichment.blockers] - Active blockers
+ * @param {Array<{what: string, why: string}>} [enrichment.decisions] - Decisions with rationale
+ * @param {object[]} [enrichment.gotchas] - Gotchas discovered
+ * @param {string[]} [enrichment.nextSteps] - Planned next steps
+ * @returns {object} Structured digest with 8 sections
+ */
+export function buildStructuredDigest(projectDir, sessionState, enrichment = {}) {
+  const timestamp = new Date().toISOString();
+
+  const truncate = (text, maxChars) => {
+    if (!text) return '';
+    const str = String(text);
+    return str.length <= maxChars ? str : str.slice(0, maxChars - 3) + '...';
+  };
+
+  const truncateArray = (arr, maxChars) => {
+    if (!arr || arr.length === 0) return [];
+    let total = 0;
+    const result = [];
+    for (const item of arr) {
+      const str = typeof item === 'object' ? JSON.stringify(item) : String(item);
+      if (total + str.length > maxChars) break;
+      total += str.length;
+      result.push(item);
+    }
+    return result;
+  };
+
+  const digest = {
+    version: '2.0',
+    timestamp,
+    date: timestamp.split('T')[0],
+
+    // Section 1: Current agent
+    current_agent: truncate(
+      sessionState.current_agent || sessionState.agents
+        ? Object.entries(sessionState.agents || {}).find(([, v]) => v.status === 'in_progress')?.[0] || null
+        : null,
+      SECTION_BUDGETS.current_agent,
+    ),
+
+    // Section 2: Pipeline position
+    pipeline_position: truncate(
+      sessionState.pipeline?.phase || sessionState.project?.state || 'unknown',
+      SECTION_BUDGETS.pipeline_position,
+    ),
+
+    // Section 3: Active task
+    active_task: truncate(
+      enrichment.activeTask || null,
+      SECTION_BUDGETS.active_task,
+    ),
+
+    // Section 4: Files changed
+    files_changed: truncateArray(
+      enrichment.filesChanged || [],
+      SECTION_BUDGETS.files_changed,
+    ),
+
+    // Section 5: Blockers
+    blockers: truncateArray(
+      enrichment.blockers || [],
+      SECTION_BUDGETS.blockers,
+    ),
+
+    // Section 6: Decisions made
+    decisions_made: truncateArray(
+      enrichment.decisions || [],
+      SECTION_BUDGETS.decisions_made,
+    ),
+
+    // Section 7: Gotchas found
+    gotchas_found: truncateArray(
+      enrichment.gotchas || [],
+      SECTION_BUDGETS.gotchas_found,
+    ),
+
+    // Section 8: Next steps
+    next_steps: truncateArray(
+      enrichment.nextSteps || [],
+      SECTION_BUDGETS.next_steps,
+    ),
+
+    // Preserve base summary for backward compat
+    summary: {
+      total_agents: Object.keys(sessionState.agents || {}).length,
+      completed_agents: Object.values(sessionState.agents || {}).filter(a => a.status === 'completed').length,
+      mode: sessionState.mode || 'discover',
+    },
+  };
+
+  // Final budget enforcement — iterative truncation until within budget
+  const truncOrder = ['next_steps', 'gotchas_found', 'files_changed', 'blockers', 'decisions_made'];
+  let pass = 0;
+  while (JSON.stringify(digest).length > MAX_STRUCTURED_CHARS && pass < truncOrder.length) {
+    const field = truncOrder[pass];
+    if (Array.isArray(digest[field]) && digest[field].length > 1) {
+      digest[field] = digest[field].slice(0, Math.max(1, Math.ceil(digest[field].length / 2)));
+    } else {
+      pass++;
+    }
+    // If we halved and still too big, move to next field
+    if (JSON.stringify(digest).length > MAX_STRUCTURED_CHARS) pass++;
+  }
+
+  return digest;
+}
+
 /**
  * Save session digest to disk.
  * @param {string} projectDir - Project directory
@@ -95,7 +233,7 @@ export function saveSessionDigest(projectDir, digest) {
       saved: true,
       path: digestPath,
     };
-  } catch {
+  } catch { /* expected: operation may fail gracefully */
     return {
       saved: false,
       path: digestPath,
@@ -139,7 +277,7 @@ export function loadLatestDigest(projectDir) {
       loaded: true,
       digest,
     };
-  } catch {
+  } catch { /* expected: file may not exist */
     return {
       loaded: false,
       digest: null,
@@ -181,7 +319,7 @@ export function listDigests(projectDir) {
           completion_rate: digest.summary?.completion_rate || 0,
           total_agents: digest.summary?.total_agents || 0,
         };
-      } catch {
+      } catch { /* expected: operation may fail gracefully */
         return {
           filename,
           timestamp: null,
@@ -193,7 +331,7 @@ export function listDigests(projectDir) {
         };
       }
     });
-  } catch {
+  } catch { /* expected: operation may fail gracefully */
     return [];
   }
 }
@@ -224,7 +362,7 @@ export function pruneDigests(projectDir, keepCount = 10) {
       const filepath = join(dir, filename);
       try {
         unlinkSync(filepath);
-      } catch {
+      } catch { /* expected: file may already be deleted */
         // Ignore delete errors
       }
     });
@@ -233,7 +371,7 @@ export function pruneDigests(projectDir, keepCount = 10) {
       deleted: toDelete.length,
       kept: toKeep.length,
     };
-  } catch {
+  } catch { /* expected: file may already be deleted */
     return { deleted: 0, kept: 0 };
   }
 }

package/src/merger/yaml-merger.js

@@ -120,7 +120,7 @@ export function mergeYamlFiles(existingContent, newContent) {
     const newObj = yaml.load(newContent) || {};
     const merged = deepMergeYaml(existingObj, newObj);
     return yaml.dump(merged, { lineWidth: -1, noRefs: true });
-  } catch {
+  } catch { /* expected: YAML may be invalid */
     // If YAML parsing fails, return existing content unchanged
     return existingContent;
   }