@feelingmindful/thinking-graph 1.8.1 → 1.9.0

package/dist/tools/learn.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { NODE_TYPES, EDGE_TYPES } from '../engine/types.js';
+import { NODE_TYPES, EDGE_TYPES, GLOBAL_NODE_TYPES } from '../engine/types.js';
 export const learnSchema = z.object({
     content: z.string().describe('What was learned'),
     type: z.enum(NODE_TYPES).describe('Node type'),
@@ -77,6 +77,40 @@ export async function learnHandler(graph, input) {
             relatedCount++;
         }
     }
+    // Suggest writing to the knowledge-graph vault for durable, cross-project knowledge
+    const suggestions = [];
+    if (GLOBAL_NODE_TYPES.includes(input.type)) {
+        suggestions.push({
+            tool: 'kg_create_node',
+            when: 'Persist this to the knowledge vault for semantic search, community detection, and cross-project discovery',
+            example: {
+                title: input.content.slice(0, 60).replace(/[^a-zA-Z0-9 ]/g, ''),
+                directory: input.type === 'insight' ? 'Insights' : input.type === 'pattern' ? 'Patterns' : 'Principles',
+                content: input.content,
+                frontmatter: {
+                    type: input.type,
+                    tags: [input.type],
+                    ...(input.projectId && { project: input.projectId }),
+                },
+            },
+        });
+    }
+    if (input.type === 'code_fact' && input.filePath) {
+        suggestions.push({
+            tool: 'kg_create_node',
+            when: 'Persist this code fact to the knowledge vault for future recall across projects',
+            example: {
+                title: input.content.slice(0, 60).replace(/[^a-zA-Z0-9 ]/g, ''),
+                directory: 'Code Facts',
+                content: input.content,
+                frontmatter: {
+                    type: 'code_fact',
+                    filePath: input.filePath,
+                    tags: ['code-fact'],
+                },
+            },
+        });
+    }
     return {
         content: [{
                 type: 'text',
@@ -85,6 +119,7 @@ export async function learnHandler(graph, input) {
                     type: node.type,
                     relatedCount,
                     duplicateOf: null,
+                    ...(suggestions.length > 0 && { suggestions }),
                 }),
             }],
     };

package/dist/tools/recall.d.ts

@@ -21,12 +21,12 @@ export declare const recallSchema: z.ZodObject<{
     metadata?: Record<string, unknown> | undefined;
     query?: string | undefined;
     crossProject?: boolean | undefined;
+    limit?: number | undefined;
     relatedTo?: string | undefined;
     edgeType?: "depends_on" | "contradicts" | "supports" | "refines" | "supersedes" | "similar_to" | "located_in" | "violates" | "addresses" | "detected_by" | "invoked_by" | ("depends_on" | "contradicts" | "supports" | "refines" | "supersedes" | "similar_to" | "located_in" | "violates" | "addresses" | "detected_by" | "invoked_by")[] | undefined;
     direction?: "outgoing" | "incoming" | "both" | undefined;
     depth?: number | undefined;
     since?: string | undefined;
-    limit?: number | undefined;
     offset?: number | undefined;
 }, {
     type?: "thought" | "decision" | "insight" | "code_fact" | "assumption" | "detection" | "tech_debt" | "principle" | "pattern" | "skill_result" | "research" | ("thought" | "decision" | "insight" | "code_fact" | "assumption" | "detection" | "tech_debt" | "principle" | "pattern" | "skill_result" | "research")[] | undefined;
@@ -35,12 +35,12 @@ export declare const recallSchema: z.ZodObject<{
     metadata?: Record<string, unknown> | undefined;
     query?: string | undefined;
     crossProject?: unknown;
+    limit?: number | undefined;
     relatedTo?: string | undefined;
     edgeType?: "depends_on" | "contradicts" | "supports" | "refines" | "supersedes" | "similar_to" | "located_in" | "violates" | "addresses" | "detected_by" | "invoked_by" | ("depends_on" | "contradicts" | "supports" | "refines" | "supersedes" | "similar_to" | "located_in" | "violates" | "addresses" | "detected_by" | "invoked_by")[] | undefined;
     direction?: "outgoing" | "incoming" | "both" | undefined;
     depth?: number | undefined;
     since?: string | undefined;
-    limit?: number | undefined;
     offset?: number | undefined;
 }>;
 export type RecallInput = z.infer<typeof recallSchema>;

package/dist/tools/think.js

@@ -3,13 +3,18 @@ import { NODE_TYPES, EDGE_TYPES, GLOBAL_NODE_TYPES } from '../engine/types.js';
 const coerceBool = z.preprocess((v) => (v === 'true' ? true : v === 'false' ? false : v), z.boolean());
 function buildSuggestions(type, thoughtNumber, relatedCount, stats, matchedSkills) {
     const suggestions = [];
-    // First thought in session — suggest recall to check prior knowledge
+    // First thought in session — suggest recall + knowledge vault search
     if (thoughtNumber === 1 && stats.totalNodes > 1) {
         suggestions.push({
             tool: 'recall',
-            when: 'Check what the graph already knows before reasoning from scratch',
+            when: 'Check what the thinking graph already knows before reasoning from scratch',
             example: { query: '<topic>', crossProject: true },
         });
+        suggestions.push({
+            tool: 'kg_search',
+            when: 'Search the knowledge vault for semantically related insights, patterns, and facts from past work',
+            example: { query: '<topic>', type: 'semantic', limit: 5 },
+        });
     }
     // Decision nodes with no relationships — suggest relate
     if (type === 'decision' && relatedCount === 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feelingmindful/thinking-graph",
-  "version": "1.8.1",
+  "version": "1.9.0",
   "description": "Persistent graph-based MCP thinking server for the feeling-mindful plugin marketplace",
   "type": "module",
   "main": "dist/index.js",