cozo-memory 1.0.6 → 1.0.7

package/README.md

@@ -912,6 +912,42 @@ The system maintains a persistent profile of the user (preferences, dislikes, wo
 - **Mechanism**: All observations assigned to this entity receive a significant boost in search and context queries.
 - **Initialization**: The profile is automatically created on first start.
 
+### Manual Profile Editing
+
+You can now directly edit the user profile using the `edit_user_profile` MCP tool:
+
+```typescript
+// View current profile
+{ }
+
+// Update metadata
+{ 
+  metadata: { timezone: "Europe/Berlin", language: "de" } 
+}
+
+// Add preferences
+{ 
+  observations: [
+    { text: "Prefers TypeScript over JavaScript" },
+    { text: "Likes concise documentation" }
+  ]
+}
+
+// Clear and reset preferences
+{ 
+  clear_observations: true,
+  observations: [{ text: "New preference" }]
+}
+
+// Update name and type
+{ 
+  name: "Developer Profile", 
+  type: "UserProfile" 
+}
+```
+
+**Note**: You can still use the implicit method via `mutate_memory` with `action='add_observation'` and `entity_id='global_user_profile'`.
+
 ### Manual Tests
 
 There are various test scripts for different features:
@@ -928,6 +964,9 @@ npx ts-node test-reflection.ts
 
 # Tests user preference profiling and search boost
 npx ts-node test-user-pref.ts
+
+# Tests manual user profile editing
+npx ts-node src/test-user-profile.ts
 ```
 
 ## Troubleshooting

package/dist/cli-commands.js

@@ -200,5 +200,11 @@ class CLICommands {
         // For now, return a placeholder
         return { status: "not_implemented", message: "Use MCP server for file ingestion" };
     }
+    async editUserProfile(args) {
+        return await this.server.editUserProfile(args);
+    }
+    async getUserProfile() {
+        return await this.server.editUserProfile({});
+    }
 }
 exports.CLICommands = CLICommands;

package/dist/cli.js

@@ -407,4 +407,84 @@ ingest
         handleError(error);
     }
 });
+// User Profile commands
+const profile = program.command('profile').description('User profile management');
+profile
+    .command('show')
+    .description('Show current user profile')
+    .option('-f, --format <format>', 'Output format (json|pretty)', 'pretty')
+    .action(async (options) => {
+    try {
+        await cli.init();
+        const result = await cli.getUserProfile();
+        formatOutput(result, options.format);
+        await cli.close();
+    }
+    catch (error) {
+        handleError(error);
+    }
+});
+profile
+    .command('update')
+    .description('Update user profile metadata')
+    .option('-n, --name <name>', 'Profile name')
+    .option('-t, --type <type>', 'Profile type')
+    .option('-m, --metadata <json>', 'Metadata as JSON string')
+    .option('-f, --format <format>', 'Output format (json|pretty)', 'pretty')
+    .action(async (options) => {
+    try {
+        await cli.init();
+        const metadata = options.metadata ? JSON.parse(options.metadata) : undefined;
+        const result = await cli.editUserProfile({
+            name: options.name,
+            type: options.type,
+            metadata
+        });
+        formatOutput(result, options.format);
+        await cli.close();
+    }
+    catch (error) {
+        handleError(error);
+    }
+});
+profile
+    .command('add-preference')
+    .description('Add preference to user profile')
+    .requiredOption('-t, --text <text>', 'Preference text')
+    .option('-m, --metadata <json>', 'Metadata as JSON string')
+    .option('-f, --format <format>', 'Output format (json|pretty)', 'pretty')
+    .action(async (options) => {
+    try {
+        await cli.init();
+        const metadata = options.metadata ? JSON.parse(options.metadata) : undefined;
+        const result = await cli.editUserProfile({
+            observations: [{ text: options.text, metadata }]
+        });
+        formatOutput(result, options.format);
+        await cli.close();
+    }
+    catch (error) {
+        handleError(error);
+    }
+});
+profile
+    .command('reset')
+    .description('Clear all preferences and optionally set new ones')
+    .option('-t, --text <text>', 'New preference text (can be used multiple times)')
+    .option('-f, --format <format>', 'Output format (json|pretty)', 'pretty')
+    .action(async (options) => {
+    try {
+        await cli.init();
+        const observations = options.text ? [{ text: options.text }] : [];
+        const result = await cli.editUserProfile({
+            clear_observations: true,
+            observations
+        });
+        formatOutput(result, options.format);
+        await cli.close();
+    }
+    catch (error) {
+        handleError(error);
+    }
+});
 program.parse();

package/dist/index.js

@@ -2173,6 +2173,64 @@ ids[id] <- $ids
             defaultEntityType: args.defaultEntityType
         });
     }
+    async editUserProfile(args) {
+        try {
+            const current = await this.db.run('?[name, type, metadata] := *entity{id: $id, name, type, metadata, @ "NOW"}', { id: exports.USER_ENTITY_ID });
+            if (current.rows.length === 0) {
+                return { error: "User profile not found. Initialize it first." };
+            }
+            if (args.name || args.type || args.metadata) {
+                const updateResult = await this.updateEntity({
+                    id: exports.USER_ENTITY_ID,
+                    name: args.name,
+                    type: args.type,
+                    metadata: args.metadata
+                });
+                if (updateResult.error) {
+                    return updateResult;
+                }
+            }
+            if (args.clear_observations) {
+                const existingObs = await this.db.run('?[id] := *observation{id, entity_id: $eid, @ "NOW"}', { eid: exports.USER_ENTITY_ID });
+                for (const row of existingObs.rows) {
+                    await this.db.run('?[id, entity_id, text, embedding, metadata, created_at] := *observation{id, entity_id, text, embedding, metadata, created_at, @ "NOW"}, id = $id :delete observation {id, entity_id, text, embedding, metadata, created_at}', { id: row[0] });
+                }
+            }
+            if (args.observations && args.observations.length > 0) {
+                for (const obs of args.observations) {
+                    await this.addObservation({
+                        entity_id: exports.USER_ENTITY_ID,
+                        text: obs.text,
+                        metadata: { ...obs.metadata, kind: "user_preference" },
+                        deduplicate: true
+                    });
+                }
+            }
+            const updated = await this.db.run('?[name, type, metadata] := *entity{id: $id, name, type, metadata, @ "NOW"}', { id: exports.USER_ENTITY_ID });
+            const observations = await this.db.run('?[id, text, metadata] := *observation{id, entity_id: $eid, text, metadata, @ "NOW"}', { eid: exports.USER_ENTITY_ID });
+            return {
+                status: "User profile updated",
+                profile: {
+                    id: exports.USER_ENTITY_ID,
+                    name: updated.rows[0][0],
+                    type: updated.rows[0][1],
+                    metadata: updated.rows[0][2],
+                    observations: observations.rows.map((r) => ({
+                        id: r[0],
+                        text: r[1],
+                        metadata: r[2]
+                    }))
+                }
+            };
+        }
+        catch (error) {
+            console.error("[UserProfile] Error editing user profile:", error);
+            return {
+                error: "Failed to edit user profile",
+                message: error.message || String(error)
+            };
+        }
+    }
     registerTools() {
         const MetadataSchema = zod_1.z.record(zod_1.z.string(), zod_1.z.any());
         const MutateMemorySchema = zod_1.z.discriminatedUnion("action", [
@@ -3378,6 +3436,42 @@ Supported actions:
                 return JSON.stringify({ error: "Unknown action" });
             },
         });
+        // User Profile Management Tool
+        this.mcp.addTool({
+            name: "edit_user_profile",
+            description: `Direct management of the global user profile ('global_user_profile').
+This tool allows manual editing of user preferences, work style, and profile metadata.
+
+The user profile is automatically boosted in all searches (50% score boost) and used for personalization.
+
+Parameters:
+- name?: string - Update the profile name (default: "The User")
+- type?: string - Update the profile type (default: "User")
+- metadata?: object - Update or merge profile metadata
+- observations?: Array<{ text: string, metadata?: object }> - Add new preference observations
+- clear_observations?: boolean - Remove all existing observations before adding new ones
+
+Examples:
+- Add preferences: { observations: [{ text: "Prefers TypeScript over JavaScript" }] }
+- Update metadata: { metadata: { timezone: "Europe/Berlin", language: "de" } }
+- Reset and set new preferences: { clear_observations: true, observations: [{ text: "New preference" }] }
+
+Note: Use 'mutate_memory' with action='add_observation' and entity_id='global_user_profile' for implicit preference updates.`,
+            parameters: zod_1.z.object({
+                name: zod_1.z.string().optional().describe("New name for the user profile"),
+                type: zod_1.z.string().optional().describe("New type for the user profile"),
+                metadata: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional().describe("Metadata to merge with existing metadata"),
+                observations: zod_1.z.array(zod_1.z.object({
+                    text: zod_1.z.string().describe("Preference or work style description"),
+                    metadata: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional().describe("Optional metadata for this observation")
+                })).optional().describe("New observations to add to the profile"),
+                clear_observations: zod_1.z.boolean().optional().default(false).describe("Clear all existing observations before adding new ones")
+            }),
+            execute: async (args) => {
+                await this.initPromise;
+                return JSON.stringify(await this.editUserProfile(args));
+            }
+        });
     }
     async start() {
         await this.mcp.start({ transportType: "stdio" });

package/dist/test-user-profile.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_1 = require("./index");
+async function testUserProfileEditing() {
+    console.log("=== Testing User Profile Editing ===\n");
+    const server = new index_1.MemoryServer();
+    await server.start();
+    try {
+        // 1. View current profile
+        console.log("1. Current user profile:");
+        const currentProfile = await server.editUserProfile({});
+        console.log(JSON.stringify(currentProfile, null, 2));
+        // 2. Update metadata
+        console.log("\n2. Updating profile metadata:");
+        const metadataUpdate = await server.editUserProfile({
+            metadata: {
+                timezone: "Europe/Berlin",
+                language: "de",
+                work_hours: "09:00-17:00"
+            }
+        });
+        console.log(JSON.stringify(metadataUpdate, null, 2));
+        // 3. Add new preferences
+        console.log("\n3. Adding new preferences:");
+        const addPrefs = await server.editUserProfile({
+            observations: [
+                { text: "Prefers TypeScript over JavaScript for type safety" },
+                { text: "Likes clean, minimal code without unnecessary comments" },
+                { text: "Prefers functional programming patterns" }
+            ]
+        });
+        console.log(JSON.stringify(addPrefs, null, 2));
+        // 4. Clear and reset preferences
+        console.log("\n4. Clearing and resetting preferences:");
+        const resetPrefs = await server.editUserProfile({
+            clear_observations: true,
+            observations: [
+                { text: "Works primarily with Node.js and TypeScript", metadata: { category: "tech_stack" } },
+                { text: "Prefers concise documentation", metadata: { category: "style" } }
+            ]
+        });
+        console.log(JSON.stringify(resetPrefs, null, 2));
+        // 5. Update name and type
+        console.log("\n5. Updating profile name and type:");
+        const nameUpdate = await server.editUserProfile({
+            name: "Developer Profile",
+            type: "UserProfile"
+        });
+        console.log(JSON.stringify(nameUpdate, null, 2));
+        console.log("\n=== Test completed successfully ===");
+    }
+    catch (error) {
+        console.error("Test failed:", error);
+    }
+    finally {
+        process.exit(0);
+    }
+}
+testUserProfileEditing();

package/dist/tui.js

@@ -63,13 +63,13 @@ async function main() {
                     else if (key.downArrow) {
                         setState(prev => ({
                             ...prev,
-                            selectedIndex: Math.min(5, prev.selectedIndex + 1)
+                            selectedIndex: Math.min(6, prev.selectedIndex + 1)
                         }));
                     }
                     else if (key.return) {
-                        const screens = ['entity', 'search', 'graph', 'system', 'result', 'menu'];
+                        const screens = ['entity', 'profile', 'search', 'graph', 'system', 'result', 'menu'];
                         const newScreen = screens[state.selectedIndex];
-                        if (state.selectedIndex === 4) {
+                        if (state.selectedIndex === 5) {
                             setState(prev => ({ ...prev, loading: true }));
                             cli.health().then(result => {
                                 setState(prev => ({ ...prev, screen: 'result', result, loading: false }));
@@ -89,7 +89,7 @@ async function main() {
             if (state.error) {
                 return React.createElement(Box, { flexDirection: 'column', padding: 1 }, React.createElement(Text, { color: 'red' }, `❌ Error: ${state.error}`), React.createElement(Text, { dimColor: true }, 'Press ESC to return to menu'));
             }
-            return React.createElement(Box, { flexDirection: 'column', padding: 1 }, React.createElement(Header), state.screen === 'menu' && React.createElement(MainMenu, { selectedIndex: state.selectedIndex }), state.screen === 'entity' && React.createElement(EntityScreen), state.screen === 'search' && React.createElement(SearchScreen), state.screen === 'graph' && React.createElement(GraphScreen), state.screen === 'system' && React.createElement(SystemScreen), state.screen === 'result' && React.createElement(ResultScreen, { result: state.result }), React.createElement(Footer));
+            return React.createElement(Box, { flexDirection: 'column', padding: 1 }, React.createElement(Header), state.screen === 'menu' && React.createElement(MainMenu, { selectedIndex: state.selectedIndex }), state.screen === 'entity' && React.createElement(EntityScreen), state.screen === 'profile' && React.createElement(ProfileScreen), state.screen === 'search' && React.createElement(SearchScreen), state.screen === 'graph' && React.createElement(GraphScreen), state.screen === 'system' && React.createElement(SystemScreen), state.screen === 'result' && React.createElement(ResultScreen, { result: state.result }), React.createElement(Footer));
         };
         const Header = () => React.createElement(Box, {
             flexDirection: 'column',
@@ -107,6 +107,7 @@ async function main() {
         const MainMenu = ({ selectedIndex }) => {
             const menuItems = [
                 { icon: '📦', label: 'Entity Operations', desc: 'Create, read, update, delete entities' },
+                { icon: '👤', label: 'User Profile', desc: 'Manage user preferences and profile' },
                 { icon: '🔍', label: 'Search & Context', desc: 'Hybrid search, context retrieval' },
                 { icon: '🕸️', label: 'Graph Operations', desc: 'Explore, PageRank, communities' },
                 { icon: '⚙️', label: 'System Management', desc: 'Health, metrics, export/import' },
@@ -116,6 +117,7 @@ async function main() {
             return React.createElement(Box, { flexDirection: 'column' }, React.createElement(Box, { marginBottom: 1 }, React.createElement(Text, { bold: true, color: 'yellow' }, 'Main Menu')), ...menuItems.map((item, index) => React.createElement(Box, { key: index, marginLeft: 2 }, React.createElement(Text, { color: selectedIndex === index ? 'green' : 'white' }, `${selectedIndex === index ? '▶ ' : '  '}${item.icon} ${item.label}`), selectedIndex === index && React.createElement(Text, { dimColor: true }, ` - ${item.desc}`))));
         };
         const EntityScreen = () => React.createElement(Box, { flexDirection: 'column' }, React.createElement(Text, { bold: true, color: 'cyan' }, '📦 Entity Operations'), React.createElement(Box, { marginTop: 1, flexDirection: 'column', marginLeft: 2 }, React.createElement(Text, null, '• Create Entity: ', React.createElement(Text, { dimColor: true }, 'cozo-memory entity create -n "Name" -t "Type"')), React.createElement(Text, null, '• Get Entity: ', React.createElement(Text, { dimColor: true }, 'cozo-memory entity get -i <id>')), React.createElement(Text, null, '• Delete Entity: ', React.createElement(Text, { dimColor: true }, 'cozo-memory entity delete -i <id>')), React.createElement(Text, null, '• Add Observation: ', React.createElement(Text, { dimColor: true }, 'cozo-memory obs add -i <id> -t "Text"'))), React.createElement(Box, { marginTop: 1 }, React.createElement(Text, { color: 'yellow' }, '💡 Use the CLI commands shown above for entity operations')));
+        const ProfileScreen = () => React.createElement(Box, { flexDirection: 'column' }, React.createElement(Text, { bold: true, color: 'cyan' }, '👤 User Profile Management'), React.createElement(Box, { marginTop: 1, flexDirection: 'column', marginLeft: 2 }, React.createElement(Text, null, '• Show Profile: ', React.createElement(Text, { dimColor: true }, 'cozo-memory profile show')), React.createElement(Text, null, '• Update Metadata: ', React.createElement(Text, { dimColor: true }, 'cozo-memory profile update -m \'{"key":"value"}\'')), React.createElement(Text, null, '• Add Preference: ', React.createElement(Text, { dimColor: true }, 'cozo-memory profile add-preference -t "I prefer TypeScript"')), React.createElement(Text, null, '• Reset Preferences: ', React.createElement(Text, { dimColor: true }, 'cozo-memory profile reset'))), React.createElement(Box, { marginTop: 1 }, React.createElement(Text, { color: 'yellow' }, '💡 User profile preferences get 50% search boost automatically')));
         const SearchScreen = () => React.createElement(Box, { flexDirection: 'column' }, React.createElement(Text, { bold: true, color: 'cyan' }, '🔍 Search & Context'), React.createElement(Box, { marginTop: 1, flexDirection: 'column', marginLeft: 2 }, React.createElement(Text, null, '• Search: ', React.createElement(Text, { dimColor: true }, 'cozo-memory search query -q "your query"')), React.createElement(Text, null, '• Context: ', React.createElement(Text, { dimColor: true }, 'cozo-memory search context -q "query" -w 5')), React.createElement(Text, null, '• Advanced: ', React.createElement(Text, { dimColor: true }, 'With filters, entity types, time ranges'))), React.createElement(Box, { marginTop: 1 }, React.createElement(Text, { color: 'yellow' }, '💡 Hybrid search combines vector, keyword, and graph signals')));
         const GraphScreen = () => React.createElement(Box, { flexDirection: 'column' }, React.createElement(Text, { bold: true, color: 'cyan' }, '🕸️ Graph Operations'), React.createElement(Box, { marginTop: 1, flexDirection: 'column', marginLeft: 2 }, React.createElement(Text, null, '• Explore: ', React.createElement(Text, { dimColor: true }, 'cozo-memory graph explore -s <id> -h 3')), React.createElement(Text, null, '• PageRank: ', React.createElement(Text, { dimColor: true }, 'cozo-memory graph pagerank')), React.createElement(Text, null, '• Communities: ', React.createElement(Text, { dimColor: true }, 'cozo-memory graph communities')), React.createElement(Text, null, '• Path Finding: ', React.createElement(Text, { dimColor: true }, 'cozo-memory graph explore -s <id1> -e <id2>'))), React.createElement(Box, { marginTop: 1 }, React.createElement(Text, { color: 'yellow' }, '💡 Graph algorithms help discover implicit relationships')));
         const SystemScreen = () => React.createElement(Box, { flexDirection: 'column' }, React.createElement(Text, { bold: true, color: 'cyan' }, '⚙️ System Management'), React.createElement(Box, { marginTop: 1, flexDirection: 'column', marginLeft: 2 }, React.createElement(Text, null, '• Health: ', React.createElement(Text, { dimColor: true }, 'cozo-memory system health')), React.createElement(Text, null, '• Metrics: ', React.createElement(Text, { dimColor: true }, 'cozo-memory system metrics')), React.createElement(Text, null, '• Export JSON: ', React.createElement(Text, { dimColor: true }, 'cozo-memory export json -o backup.json')), React.createElement(Text, null, '• Export Markdown: ', React.createElement(Text, { dimColor: true }, 'cozo-memory export markdown -o notes.md')), React.createElement(Text, null, '• Export Obsidian: ', React.createElement(Text, { dimColor: true }, 'cozo-memory export obsidian -o vault.zip')), React.createElement(Text, null, '• Import: ', React.createElement(Text, { dimColor: true }, 'cozo-memory import file -i data.json -f cozo'))), React.createElement(Box, { marginTop: 1 }, React.createElement(Text, { color: 'yellow' }, '💡 Regular exports recommended for backup')));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cozo-memory",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "mcpName": "io.github.tobs-code/cozo-memory",
   "description": "Local-first persistent memory system for AI agents with hybrid search, graph reasoning, and MCP integration",
   "main": "dist/index.js",