@plumpslabs/kuma 2.3.27 → 2.3.28

package/README.md

@@ -173,12 +173,12 @@ Not all recordings are equal. Kuma categorizes actions by their long-term impact
 
 | Tier | Actions | Impact | Why |
 |------|---------|--------|-----|
-| 🔥 **Exponential** | `arch_flow` + `gotcha` | **Each record saves 5-10 files next session** | Architecture flows multiply: 10 flow hops = agent skips 50-100 files. Gotchas prevent re-discovery of bugs. |
+| 🔥 **Exponential** | `arch_flow` + `gotcha` | **High signal architecture & bug shield** | Complete architecture flows (max 5 core files) save massive file-reading next session. Gotchas prevent bug re-discovery. |
 | 🟡 **Linear** | `decision` + `research_save` | **Useful but not multiplicative** | Decisions preserve rationale context. Research saves create searchable cache. |
 | 🟢 **SKIP** | Function/class/component nodes | **Not worth MCP call — grep is faster** | Use `grep funcName(`, `grep class ClassName`, `glob **/*Component*` instead |
 
 **Rule of thumb:**
-- **ALWAYS record** `arch_flow` + `gotcha` inline — they're the highest-value actions
+- **Record `arch_flow`** after tracing a complete flow (max 5 core files) & **`gotcha`** inline when bugs are found
 - **Record** `decision` + `research_save` when relevant
 - **NEVER record** function/class/component nodes via MCP — native grep is faster
 - Let the auto-scanner handle structural nodes during research step 3

package/dist/index.js

@@ -8431,7 +8431,7 @@ function generateInitMdContent() {
     "  --- EDIT/READ (use native tools) ---",
     "  5. kuma_memory    \u2192 research_save       \u2014 After exploring area (creates search cache)",
     "  6. kuma_memory    \u2192 gotcha              \u2014 \u{1F525} IMMEDIATELY when bug found (exponential)",
-    "  7. kuma_memory    \u2192 arch_flow           \u2014 \u{1F525} IMMEDIATELY after each flow hop (exponential)",
+    "  7. kuma_memory    \u2192 arch_flow           \u2014 After tracing COMPLETE flow (max 5 core files)",
     "  8. kuma_memory    \u2192 decision            \u2014 When choosing (preserves rationale)",
     "  9. kuma_safety    \u2192 verify              \u2014 Run tests / confirm nothing broken",
     " 10. kuma_context   \u2192 changes             \u2014 Review session activity",
@@ -8568,7 +8568,7 @@ function handleOpencodeSecondary(root, results) {
       "  4. *(edit/read using native tools)*",
       '  5. `kuma_kuma_memory({ action: "research_save", ... })`               \u2014 After exploring area (creates search cache)',
       '  6. `kuma_kuma_memory({ action: "gotcha" })`                           \u2014 \u{1F525} IMMEDIATELY when bug found (exponential)',
-      '  7. `kuma_kuma_memory({ action: "arch_flow" })`                        \u2014 \u{1F525} IMMEDIATELY after each flow hop (exponential)',
+      '  7. `kuma_kuma_memory({ action: "arch_flow" })`                        \u2014 After tracing COMPLETE flow, max 5 core files',
       '  8. `kuma_kuma_memory({ action: "decision" })`                         \u2014 When choosing (preserves rationale)',
       '  9. `kuma_kuma_safety({ action: "verify", ... })`                      \u2014 Run tests / confirm nothing broken',
       ' 10. `kuma_kuma_context({ action: "changes" })`                         \u2014 Review session activity',
@@ -8699,7 +8699,7 @@ function getCombinedAgentsMd(selectedTypes) {
     "  4. *(edit/read using native tools)*",
     '  5. `[kuma_]memory({ action: "research_save", ... })`        \u2014 After exploring area (creates search cache)',
     '  6. `[kuma_]memory({ action: "gotcha" })`                    \u2014 \u{1F525} IMMEDIATELY when bug found (exponential)',
-    '  7. `[kuma_]memory({ action: "arch_flow" })`                 \u2014 \u{1F525} IMMEDIATELY after each flow hop (exponential)',
+    '  7. `[kuma_]memory({ action: "arch_flow" })`                 \u2014 After tracing COMPLETE flow (max 5 core files)',
     '  8. `[kuma_]memory({ action: "decision" })`                  \u2014 When choosing (preserves rationale)',
     '  9. `[kuma_]safety({ action: "verify", ... })`               \u2014 Run tests / confirm nothing broken',
     ' 10. `[kuma_]context({ action: "changes" })`                  \u2014 Review session activity',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plumpslabs/kuma",
-  "version": "2.3.27",
+  "version": "2.3.28",
   "description": "Safety-first context & orchestration engine for AI coding agents. MCP server with mandatory research pipeline, knowledge graph, impact analysis, decision memory, and safety guard — works with any MCP client.",
   "type": "module",
   "main": "dist/index.js",