brainclaw 0.19.6 → 0.19.7

package/dist/core/state.js

@@ -1,10 +1,11 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { ConstraintSchema, DecisionSchema, TrapSchema, HandoffSchema, PlanItemSchema } from './schema.js';
-import { ensureMemoryDir, resolveEntityDir } from './io.js';
+import { ensureMemoryDir, memoryPath, resolveEntityDir, withStoreLock, writeFileAtomic } from './io.js';
 import { commitMemoryChange } from './memory-git.js';
 import { appendEvent } from './event-log.js';
 import { loadVersionedJsonFile, saveVersionedJsonFile } from './migration.js';
+import { generateMarkdown } from './markdown.js';
 export function emptyState() {
     return {
         version: 1,
@@ -69,15 +70,31 @@ function syncDirectory(dirPath, items, documentType) {
     }
 }
 export function saveState(state, cwd) {
+    persistState(state, cwd, { writeProjectMarkdown: false });
+}
+function writeStateDirectories(state, cwd) {
     ensureMemoryDir(cwd);
     const effectiveCwd = cwd ?? process.cwd();
-    // Write to entity-aligned directories
     syncDirectory(resolveEntityDir('constraints', effectiveCwd, 'write'), state.active_constraints, 'constraint');
     syncDirectory(resolveEntityDir('decisions', effectiveCwd, 'write'), state.recent_decisions, 'decision');
     syncDirectory(resolveEntityDir('traps', effectiveCwd, 'write'), state.known_traps, 'trap');
     syncDirectory(resolveEntityDir('handoffs', effectiveCwd, 'write'), state.open_handoffs, 'handoff');
     syncDirectory(resolveEntityDir('plans', effectiveCwd, 'write'), state.plan_items, 'plan');
-    appendEvent({ action: 'update', item_type: 'state', agent: 'system' }, cwd);
-    commitMemoryChange('state update', cwd);
+}
+export function persistState(state, cwd, options = {}) {
+    const effectiveCwd = cwd ?? process.cwd();
+    withStoreLock(effectiveCwd, () => {
+        writeStateDirectories(state, effectiveCwd);
+        if (options.writeProjectMarkdown ?? true) {
+            writeFileAtomic(memoryPath('project.md', effectiveCwd), generateMarkdown(state, effectiveCwd));
+        }
+        appendEvent({
+            action: options.eventAction ?? 'update',
+            item_type: 'state',
+            agent: 'system',
+            summary: options.eventSummary,
+        }, effectiveCwd);
+        commitMemoryChange(options.commitMessage ?? 'state update', effectiveCwd);
+    });
 }
 //# sourceMappingURL=state.js.map

package/package.json

@@ -1,19 +1,18 @@
 {
   "name": "brainclaw",
-  "version": "0.19.6",
+  "version": "0.19.7",
   "description": "Shared project memory for humans and coding agents.",
   "type": "module",
   "bin": {
     "brainclaw": "dist/cli.js",
     "bclaw": "dist/cli.js"
   },
-  "files": [
-    "dist/**/*.js",
-    "docs/**/*.md",
-    "!docs/plan.md",
-    "README.md",
-    "LICENSE"
-  ],
+  "files": [
+    "dist/**/*.js",
+    "docs/**/*.md",
+    "README.md",
+    "LICENSE"
+  ],
   "scripts": {
     "build": "tsc",
     "dev": "tsc && node dist/cli.js",