barry-cache 0.3.0 → 0.3.2

package/README.md

@@ -1,7 +1,7 @@
 # Barry Cache
 
 <p align="center">
-  <img src="https://unpkg.com/barry-cache@latest/assets/barry-cache.png" alt="Barry Cache" width="420">
+  <img src="https://raw.githubusercontent.com/AlexanderIstomin/barry-cache/main/assets/barry-cache.png" alt="Barry Cache" width="420">
 </p>
 
 Barry Cache remembers your repo.
@@ -150,6 +150,8 @@ It appends a JSONL handoff record to `.context-state/handoffs/handoffs.jsonl`.
 
 Use this before ending a meaningful work session so the next agent can recover what happened.
 
+`finalize` writes operational memory only. It does not update canonical project context in `docs/context/`. If a task introduced durable implementation behavior, add or update source-backed facts in `docs/context/features/*/FACTS.jsonl` and run `barry-cache validate`.
+
 Statuses:
 - `success`: the task was completed.
 - `partial`: some useful progress was made.
@@ -345,6 +347,7 @@ Rules:
 3. Put uncertain notes, blockers, and next steps in operational memory, not canonical facts.
 4. Update IDMAP.md or KG.adj only when new source IDs or relationships are needed.
 5. Run barry-cache validate before finishing.
+6. Do not claim Barry canonical memory is updated unless docs/context/ changed.
 ```
 
 The minimum useful save is:

package/dist/cli.js

@@ -786,6 +786,12 @@ Before handing off substantial work, record factual evidence:
 \`\`\`bash
 ${commandPrefix} finalize --status success --summary "<summary>"
 \`\`\`
+
+Memory policy:
+
+- Finalize writes operational memory only.
+- Do not claim Barry canonical memory is updated unless \`docs/context/\` changed.
+- If a task adds durable implementation behavior, add or update source-backed facts in \`docs/context/features/*/FACTS.jsonl\` and run \`${commandPrefix} validate\`.
 `;
 }
 var indexMd = `# Context Index
@@ -1070,6 +1076,18 @@ Validate context changes with:
 \`\`\`bash
 ${commandPrefix} validate
 \`\`\`
+
+Before handing off substantial work, record factual evidence:
+
+\`\`\`bash
+${commandPrefix} finalize --status success --summary "<summary>"
+\`\`\`
+
+Memory policy:
+
+- Finalize writes operational memory only.
+- Do not claim Barry canonical memory is updated unless \`docs/context/\` changed.
+- If a task adds durable implementation behavior, add or update source-backed facts in \`docs/context/features/*/FACTS.jsonl\` and run \`${commandPrefix} validate\`.
 `;
 }
 function llmsTxt() {
@@ -3915,7 +3933,8 @@ async function main(argv = process.argv.slice(2)) {
       case "finalize": {
         const status = optionalChoice(parsed, "status", finalizeStatuses, "success", commandUsage("finalize"));
         const summary = requiredString(parsed, "summary", commandUsage("finalize"), { status: [...finalizeStatuses] });
-        print(await finalizeProject({ repo, status, summary }), json);
+        const result = await finalizeProject({ repo, status, summary });
+        print(result, json, formatFinalizeMessage(result));
         break;
       }
       case "adr": {
@@ -4124,6 +4143,14 @@ function formatAdrList(adrs) {
   return adrs.map((adr) => `${adr.id}  ${adr.status}  ${adr.title} (${adr.path})`).join(`
 `);
 }
+function formatFinalizeMessage(result) {
+  return [
+    `Saved operational handoff to ${result.path}.`,
+    "Finalize writes operational memory only; it does not update canonical context in docs/context/.",
+    "If this task introduced durable implementation behavior, add or update docs/context/features/*/FACTS.jsonl and run barry-cache validate."
+  ].join(`
+`);
+}
 function formatInitMessage(result) {
   if (!result.dryRun) {
     const lines2 = [`Barry Cache init ${result.changed ? "changed files" : "already up to date"}.`];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "barry-cache",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Barry Cache remembers your repo.",
   "type": "module",
   "bin": {
@@ -15,7 +15,6 @@
   },
   "files": [
     "dist",
-    "assets/barry-cache.png",
     "README.md"
   ],
   "engines": {
@@ -26,4 +25,4 @@
     "@types/node": "^25.8.0",
     "typescript": "^6.0.3"
   }
-}
+}