@kevin0181/memoc 1.1.11 → 1.2.1

package/README.md

@@ -144,7 +144,7 @@ Run it from the project root. It preserves existing project memory, including:
 - `.memoc/systems/`
 - `.memoc/wiki/`
 
-It refreshes the managed blocks, project-local wrappers, runtime copy, PATH helpers, and memoc-owned protocol templates. User-owned memory files such as `session-summary.md`, `03-decisions.md`, `04-handoff.md`, `06-project-rules.md`, and wiki topic/source pages are preserved. If `memoc` is not on PATH after upgrading, keep using:
+It refreshes the managed blocks, project-local wrappers, runtime copy, PATH helpers, and memoc-owned protocol templates. User-owned memory files such as `session-summary.md`, `03-decisions.md`, `04-handoff.md`, `06-project-rules.md`, and wiki topic/source pages are preserved. Upgrade also runs the `trim-summary` compaction pass so startup memory stays small. If `memoc` is not on PATH after upgrading, keep using:
 
 ```bash
 # Windows

package/bin/cli.js

@@ -246,6 +246,47 @@ function archiveLegacyLog(dir, mark) {
   mark('move', `${path.relative(dir, logPath)} -> ${path.relative(dir, archivePath)}`);
 }
 
+function summarySectionBulletCounts(src) {
+  const counts = {};
+  let current = '';
+  for (const line of String(src || '').split(/\r?\n/)) {
+    const heading = line.match(/^##\s+(.+?)\s*$/);
+    if (heading) {
+      current = heading[1].trim();
+      counts[current] = counts[current] || 0;
+      continue;
+    }
+    if (current && /^-\s+/.test(line)) counts[current] = (counts[current] || 0) + 1;
+  }
+  return counts;
+}
+
+function trimSummaryFile(dir) {
+  const summaryPath = path.join(dir, '.memoc', 'session-summary.md');
+  const archivePath = path.join(dir, '.memoc', 'session-summary-archive.md');
+  if (!fs.existsSync(summaryPath)) {
+    write(summaryPath, tplSessionSummary());
+    return { action: 'add' };
+  }
+
+  const src = fs.readFileSync(summaryPath, 'utf8');
+  const beforeBytes = Buffer.byteLength(src, 'utf8');
+  const counts = summarySectionBulletCounts(src);
+  const tooManyBullets = Object.values(counts).some(count => count > 3);
+  if (beforeBytes <= 800 && !tooManyBullets) {
+    return { action: 'skip', beforeBytes };
+  }
+
+  const compact = compactSessionSummary(src);
+  const afterBytes = Buffer.byteLength(compact, 'utf8');
+  const archiveHeader = fs.existsSync(archivePath)
+    ? ''
+    : '# Session Summary Archive\n\nOlder oversized startup summaries moved by `memoc trim-summary`.\n';
+  fs.appendFileSync(archivePath, `${archiveHeader}\n## [${nowISO()}] archived summary (${beforeBytes}B)\n\n${src.trimEnd()}\n`, 'utf8');
+  write(summaryPath, compact);
+  return { action: 'trim', beforeBytes, afterBytes };
+}
+
 function migrateLegacyLogReferences(filePath) {
   if (!fs.existsSync(filePath)) return false;
   const before = fs.readFileSync(filePath, 'utf8');
@@ -940,7 +981,9 @@ function collectMemocMarkdownFiles(dir) {
   }
   walk(path.join(dir, '.memoc'));
   walk(path.join(dir, 'skills', 'project-memory-maintainer'));
-  return files.sort();
+  return files
+    .filter(fp => !/session-summary-archive(?:-\d+)?\.md$/.test(path.basename(fp)))
+    .sort();
 }
 
 function ensureMemocFrontmatter(filePath, dir) {
@@ -2392,6 +2435,16 @@ function run(dir, forceUpdate, action = 'update') {
 
     archiveLegacyLog(dir, mark);
 
+    const trim = trimSummaryFile(dir);
+    if (trim.action === 'trim') {
+      mark('update', `.memoc/session-summary.md (trimmed ${trim.beforeBytes}B -> ${trim.afterBytes}B)`);
+      mark('update', '.memoc/session-summary-archive.md');
+    } else if (trim.action === 'add') {
+      mark('add', '.memoc/session-summary.md');
+    } else {
+      mark('skip', `.memoc/session-summary.md (compact ${trim.beforeBytes || 0}B)`);
+    }
+
     // Obsidian graph filters — add/merge memoc tags for existing installs too
     ensureObsidianFrontmatter(dir, mark);
   }
@@ -3392,37 +3445,24 @@ function runCompress(dir) {
 // ═══════════════════════════════════════════════════════════════════
 
 function runTrimSummary(dir) {
-  const summaryPath = path.join(dir, '.memoc', 'session-summary.md');
-  const archivePath = path.join(dir, '.memoc', 'session-summary-archive.md');
-  if (!fs.existsSync(summaryPath)) {
-    write(summaryPath, tplSessionSummary());
+  const result = trimSummaryFile(dir);
+  if (result.action === 'add') {
     console.log('\n  memoc trim-summary\n');
     console.log('    Added .memoc/session-summary.md');
     console.log('\n  Done.\n');
     return;
   }
 
-  const src = fs.readFileSync(summaryPath, 'utf8');
-  const beforeBytes = Buffer.byteLength(src, 'utf8');
-  const compact = compactSessionSummary(src);
-  const afterBytes = Buffer.byteLength(compact, 'utf8');
-
-  if (src === compact && beforeBytes <= 800) {
+  if (result.action === 'skip') {
     console.log('\n  memoc trim-summary\n');
-    console.log(`    session-summary.md is already compact (${beforeBytes}B).`);
+    console.log(`    session-summary.md is already compact (${result.beforeBytes}B).`);
     console.log('\n  Done.\n');
     return;
   }
 
-  const archiveHeader = fs.existsSync(archivePath)
-    ? ''
-    : '# Session Summary Archive\n\nOlder oversized startup summaries moved by `memoc trim-summary`.\n';
-  fs.appendFileSync(archivePath, `${archiveHeader}\n## [${nowISO()}] archived summary (${beforeBytes}B)\n\n${src.trimEnd()}\n`, 'utf8');
-  write(summaryPath, compact);
-
   console.log('\n  memoc trim-summary\n');
   console.log(`    Archived  .memoc/session-summary-archive.md`);
-  console.log(`    Rewrote   .memoc/session-summary.md (${beforeBytes}B → ${afterBytes}B)`);
+  console.log(`    Rewrote   .memoc/session-summary.md (${result.beforeBytes}B → ${result.afterBytes}B)`);
   console.log('    Reminder  Completed history belongs in worklog; resume details belong in 04-handoff.md.');
   console.log('\n  Done.\n');
 }
@@ -3432,8 +3472,8 @@ function compactSessionSummary(src) {
   const lines = [
     '# Session Summary',
     `Last: ${nowISO()}`,
-    'Replace this file instead of appending to it. Keep total size <800B and each section ≤3 bullets.',
-    'Completed history belongs in actor worklogs; incomplete/risky resume detail belongs in `04-handoff.md`.',
+    'Replace, do not append. Keep <800B.',
+    'History: worklog. Resume risks: 04-handoff.md.',
     '',
   ];
 
@@ -3455,6 +3495,7 @@ function sectionText(src, heading) {
 }
 
 function compactSummaryBullets(text) {
+  const maxLine = 72;
   return String(text || '')
     .split(/\r?\n/)
     .map(line => line.trim())
@@ -3462,7 +3503,13 @@ function compactSummaryBullets(text) {
     .map(line => line.replace(/^[-*]\s+/, '').replace(/^\d+[.)]\s+/, '').trim())
     .filter(Boolean)
     .slice(0, 3)
-    .map(line => `- ${line.length > 140 ? `${line.slice(0, 137)}...` : line}`);
+    .map(line => {
+      const compact = line
+        .replace(/`/g, '')
+        .replace(/\s+/g, ' ')
+        .trim();
+      return `- ${compact.length > maxLine ? `${compact.slice(0, maxLine - 3)}...` : compact}`;
+    });
 }
 
 function summaryPlaceholder(heading) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kevin0181/memoc",
-  "version": "1.1.11",
+  "version": "1.2.1",
   "description": "Give AI agents a memory. Scaffolds session-to-session context for Claude Code, Codex, Cursor, and more.",
   "keywords": [
     "ai",