@starascendin/lifeos-mcp 0.7.61 → 0.7.62

package/README.md

@@ -1,6 +1,6 @@
 # LifeOS MCP Server
 
-MCP (Model Context Protocol) server for LifeOS Project Management. This allows AI assistants like Claude to interact with your LifeOS projects, tasks, cycles, notes, and contacts.
+MCP (Model Context Protocol) server for LifeOS Project Management and Life Design. This allows AI assistants like Claude to interact with your LifeOS projects, tasks, cycles, notes, contacts, and PPV life design system.
 
 ## Installation
 
@@ -24,6 +24,18 @@ npx @starascendin/lifeos-mcp --url <your-convex-url> --user-id <your-user-id> --
 | User ID | `--user-id`, `-i` | `LIFEOS_USER_ID` | Your LifeOS user ID |
 | API Key | `--api-key`, `-k` | `LIFEOS_API_KEY` | Your API key for authentication |
 
+### Optional SurrealDB Sidecar Parameters
+
+These are required only for the Surreal graph tools.
+
+| Env Variable | Description |
+|--------------|-------------|
+| `SURREAL_ENDPOINT` | SurrealDB HTTP endpoint, e.g. `https://surrealdbprod.apps.rjlabs.dev` |
+| `SURREAL_USER` | SurrealDB username |
+| `SURREAL_PASS` | SurrealDB password |
+| `SURREAL_NS` | Namespace, defaults to `lifeos` |
+| `SURREAL_DB` | Database, defaults to `graph` |
+
 ### Getting Your Credentials
 
 1. **Convex URL**: Find in your Convex dashboard - use the `.convex.site` URL (not `.convex.cloud`)
@@ -102,6 +114,8 @@ Add to your `.mcp.json` (project root or `~/.claude/mcp.json`):
 ### Agenda
 - **get_daily_agenda** - Today's tasks, events, priorities
 - **get_weekly_agenda** - Week's tasks and events
+- **get_planning_context** - Full day/week/current-cycle planning context for agents
+- **apply_planning_patch** - Mutating planning patch for due dates, priorities, current cycle, and notes
 
 ### Habits
 - **get_habits** - List active habits with streaks and completion stats
@@ -155,6 +169,40 @@ Add to your `.mcp.json` (project root or `~/.claude/mcp.json`):
 - **get_business_contacts** - List business-marked Beeper threads with linked contact/client info
 - **get_client_success_workspace** - Load one client's chats, meetings, notes, projects, and open work in one call
 
+### PPV Life Design
+- **get_ppv_workspace** - Get vision, identity, pillars, linked projects, weekly actions, reflections, and adjustments
+- **get_active_vision_graph** - Best default graph read for PPV/alignment questions; connects the active vision to projects, issues, and recent memos
+- **seed_ppv_beijing_workspace** - Seed the Beijing Creative Salon example if no PPV vision exists
+- **upsert_ppv_vision** - Create or update a PPV vision
+- **upsert_ppv_identity** - Create or update identity components for a vision
+- **create_ppv_pillar / update_ppv_pillar / delete_ppv_pillar** - Manage pillars and links to existing LifeOS projects
+- **create_ppv_weekly_action / update_ppv_weekly_action / delete_ppv_weekly_action** - Manage weekly identity-aligned actions
+- **create_ppv_reflection / delete_ppv_reflection** - Capture reflection loops
+- **create_ppv_adjustment / delete_ppv_adjustment** - Record adjustments from lived evidence
+
+### Unified Graph
+- **get_unified_life_graph** - Build the user's full live unified graph across LifeOS domains
+- **get_project_graph** - Read the graph neighborhood around one project
+- **get_initiative_graph** - Read the graph neighborhood around one initiative
+- **get_person_graph** - Read the graph neighborhood around one person/contact
+- **get_voice_memo_graph** - Read the graph neighborhood around one voice memo
+- **get_cached_unified_graph** - Read the materialized cached graph projection
+- **refresh_unified_graph_cache** - Recompute inferred graph links and refresh the cached projection
+- **upsert_unified_graph_link / delete_unified_graph_link** - Create or remove manual links between graph nodes
+
+### SurrealDB Sidecar Graph
+- **surreal_graph_schema** - Inspect the agent graph contract, configured namespace/db, allowed table prefixes, relation tables, and examples
+- **surreal_graph_query** - Run guarded read-only SurrealQL (`SELECT`, `INFO`, `EXPLAIN` only)
+- **surreal_graph_link** - Create/update an agent-owned relationship in `lifeos_agent_links` without mutating Convex-synced entity tables
+- **surreal_graph_unlink** - Remove a relationship previously created by `surreal_graph_link`
+
+Surreal graph rules:
+- Convex remains canonical for entity data.
+- SurrealDB is the relationship/query sidecar.
+- Agents may query graph data and write only agent-owned links through `lifeos_agent_links`.
+- Every agent-created link must include a reason and confidence.
+- Raw read queries should include `LIMIT`.
+
 ## Shared Council Architecture
 
 `run_council` calls the Convex `POST /council-skill` endpoint. That is the same shared council core used by:
@@ -169,8 +217,24 @@ This keeps council orchestration in one place instead of duplicating it per runt
 
 ```bash
 lifeos-mcp --help
+lifeos-mcp agenda day --date 2026-05-13
+lifeos-mcp agenda week --week-start-date 2026-05-11
+lifeos-mcp patch ./planning-patch.json --dry-run
+lifeos-mcp ppv workspace
+lifeos-mcp ppv graph
+lifeos-mcp ppv seed
+lifeos-mcp ppv vision --file ./ppv-vision.json
+lifeos-mcp ppv action --file ./ppv-weekly-action.json
 ```
 
+PPV CLI actions: `workspace`, `graph`, `vision-graph`, `seed`, `vision`, `identity`, `pillar`,
+`update-pillar`, `delete-pillar`, `action`, `update-action`, `delete-action`,
+`reflection`, `delete-reflection`, `adjustment`, `delete-adjustment`.
+
+For the broader graph family (`get_project_graph`, `get_initiative_graph`, `get_person_graph`,
+`get_voice_memo_graph`, `get_unified_life_graph`, cache refresh, and manual link tools), invoke the
+MCP tools directly from an agent runtime or use the `lifeos` CLI wrapper.
+
 ## License
 
 MIT

package/dist/build-info.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.7.61";
-export declare const BUILD_TIME = "2026-04-21T17:37:26.471Z";
+export declare const VERSION = "0.7.62";
+export declare const BUILD_TIME = "2026-05-16T19:10:03.302Z";

package/dist/build-info.js

@@ -1,3 +1,3 @@
 // AUTO-GENERATED — do not edit. Regenerated on every build.
-export const VERSION = "0.7.61";
-export const BUILD_TIME = "2026-04-21T17:37:26.471Z";
+export const VERSION = "0.7.62";
+export const BUILD_TIME = "2026-05-16T19:10:03.302Z";