@feelingmindful/thinking-graph 1.10.0 → 1.10.1

package/dist/tools/learn.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import type { ThinkingGraph } from '../engine/graph.js';
-import type { VaultBridge } from '../vault/bridge.js';
+import { type VaultBridge } from '../vault/bridge.js';
 export declare const learnSchema: z.ZodObject<{
     content: z.ZodString;
     type: z.ZodEnum<["thought", "decision", "insight", "code_fact", "assumption", "detection", "tech_debt", "principle", "pattern", "skill_result", "research"]>;

package/dist/tools/learn.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { NODE_TYPES, EDGE_TYPES } from '../engine/types.js';
+import { deriveTitle } from '../vault/bridge.js';
 export const learnSchema = z.object({
     content: z.string().describe('What was learned'),
     type: z.enum(NODE_TYPES).describe('Node type'),
@@ -81,7 +82,7 @@ export async function learnHandler(graph, input, vault, projectSlug) {
     let vaultPath = null;
     if (vault && projectSlug) {
         try {
-            const title = input.content.slice(0, 80).replace(/[^a-zA-Z0-9 ]/g, '').trim() || input.type;
+            const title = deriveTitle(input.content, input.type);
             vaultPath = vault.write({
                 title,
                 type: input.type,

package/dist/tools/research.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import type { ThinkingGraph } from '../engine/graph.js';
-import type { VaultBridge } from '../vault/bridge.js';
+import { type VaultBridge } from '../vault/bridge.js';
 export declare const researchSchema: z.ZodObject<{
     query: z.ZodString;
     intent: z.ZodDefault<z.ZodEnum<["fact_check", "explore", "compare", "how_to", "current_state"]>>;

package/dist/tools/research.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { deriveTitle } from '../vault/bridge.js';
 const coerceBool = z.preprocess((v) => (v === 'true' ? true : v === 'false' ? false : v), z.boolean());
 const RESEARCH_INTENTS = [
     'fact_check', // Verify a claim or assumption
@@ -162,8 +163,7 @@ export async function researchHandler(graph, input, vault, projectSlug) {
             // Write finding to Obsidian vault
             if (vault && projectSlug) {
                 try {
-                    const title = finding.content.slice(0, 80).replace(/[^a-zA-Z0-9 ]/g, '').trim()
-                        || `Research ${input.intent}`;
+                    const title = deriveTitle(finding.content, `Research ${input.intent}`);
                     const vaultPath = vault.write({
                         title,
                         type: 'research',

package/dist/vault/bridge.d.ts

@@ -29,6 +29,11 @@ export interface VaultWriteOpts {
     projectSlug: string;
     metadata?: Record<string, unknown>;
 }
+/**
+ * Derive a short, meaningful title from freeform content.
+ * Takes the first sentence (or first N words) and sanitizes it.
+ */
+export declare function deriveTitle(content: string, fallback: string): string;
 export declare class VaultBridge {
     private vaultRoot;
     constructor(vaultPath: string);

package/dist/vault/bridge.js

@@ -33,12 +33,37 @@ function expandHome(p) {
         return join(homedir(), p.slice(2));
     return p;
 }
+// Obsidian titles should stay under 60 chars for clean sidebar display.
+// macOS allows 255 bytes but long titles break Obsidian search and links.
+const MAX_TITLE_LENGTH = 60;
 function sanitizeFilename(name) {
     return name
-        .replace(/[<>:"/\\|?*]/g, '')
+        .replace(/[<>:"/\\|?*#^\[\]]/g, '') // filesystem + Obsidian-reserved chars
         .replace(/\s+/g, ' ')
         .trim()
-        .slice(0, 120);
+        .slice(0, MAX_TITLE_LENGTH);
+}
+/**
+ * Derive a short, meaningful title from freeform content.
+ * Takes the first sentence (or first N words) and sanitizes it.
+ */
+export function deriveTitle(content, fallback) {
+    // Strip leading markdown headings/bullets
+    const cleaned = content.replace(/^[#\-*>\s]+/, '').trim();
+    if (!cleaned)
+        return sanitizeFilename(fallback);
+    // Take first sentence (up to period, newline, or em-dash)
+    const firstSentence = cleaned.split(/[.\n—]/, 1)[0].trim();
+    // If the sentence is short enough, use it
+    if (firstSentence.length > 0 && firstSentence.length <= MAX_TITLE_LENGTH) {
+        const title = firstSentence.replace(/[^a-zA-Z0-9 \-_]/g, '').trim();
+        if (title.length >= 5)
+            return sanitizeFilename(title);
+    }
+    // Otherwise take first ~8 words
+    const words = cleaned.replace(/[^a-zA-Z0-9 \-_]/g, '').split(/\s+/).filter(Boolean);
+    const shortTitle = words.slice(0, 8).join(' ');
+    return sanitizeFilename(shortTitle || fallback);
 }
 /**
  * Walk a directory tree and yield .md files.

package/package.json

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