@starascendin/lifeos-mcp 0.7.69 → 0.7.71

package/README.md

@@ -173,15 +173,12 @@ Add to your `.mcp.json` (project root or `~/.claude/mcp.json`):
 - **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_ppv_workspace** - Get vision, identity, pillars, linked projects, and available existing LifeOS projects
 - **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
@@ -194,7 +191,7 @@ Add to your `.mcp.json` (project root or `~/.claude/mcp.json`):
 - **upsert_unified_graph_link / delete_unified_graph_link** - Create or remove manual links between graph nodes
 
 ### FalkorDB Sidecar Graph
-- **falkor_graph_schema** - Inspect the Falkor graph contract, configured graph, allowed labels, relationship types, and examples
+- **falkor_graph_schema** - Inspect the Falkor graph contract, configured graph, allowed labels, relationship types, fields, query recipes, and agent link flow
 - **falkor_graph_query** - Run guarded read-only Cypher against the Falkor PPV sidecar
 - **falkor_graph_link** - Create/update an agent-owned `AGENT_LINK` relationship without mutating Convex-synced nodes or inferred PPV relationships
 - **falkor_graph_unlink** - Remove a relationship previously created by `falkor_graph_link`
@@ -202,6 +199,8 @@ Add to your `.mcp.json` (project root or `~/.claude/mcp.json`):
 Falkor graph rules:
 - Convex remains canonical for entity data.
 - FalkorDB is a graph query/read sidecar for the PPV experiment.
+- `convexId` is the stable id shared between Convex and Falkor nodes.
+- Agents should call `falkor_graph_schema` first and prefer its query recipes.
 - Agents may query graph data and write only agent-owned `AGENT_LINK` relationships.
 - Every agent-created link must include a reason and confidence.
 - Raw read queries should include `LIMIT`.
@@ -227,12 +226,10 @@ 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`.
+`update-pillar`, `delete-pillar`.
 
 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

package/dist/build-info.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.7.69";
-export declare const BUILD_TIME = "2026-05-17T20:11:00.340Z";
+export declare const VERSION = "0.7.71";
+export declare const BUILD_TIME = "2026-05-18T00:11:44.962Z";

package/dist/build-info.js

@@ -1,3 +1,3 @@
 // AUTO-GENERATED — do not edit. Regenerated on every build.
-export const VERSION = "0.7.69";
-export const BUILD_TIME = "2026-05-17T20:11:00.340Z";
+export const VERSION = "0.7.71";
+export const BUILD_TIME = "2026-05-18T00:11:44.962Z";

package/dist/index.js

@@ -6848,24 +6848,164 @@ function falkorLinkId(parts) {
 }
 function falkorGraphSchema() {
     return {
+        schemaVersion: 2,
         configured: Boolean(FALKOR_TOKEN || FALKOR_PASS),
         endpointConfigured: Boolean(FALKOR_BROWSER_ENDPOINT),
         graph: FALKOR_GRAPH,
         nodeLabels: FALKOR_NODE_LABELS,
-        inferredRelationships: FALKOR_INFERRED_RELATIONSHIPS,
+        inferredRelationshipTypes: FALKOR_INFERRED_RELATIONSHIPS,
         agentWritableRelationshipType: FALKOR_AGENT_RELATIONSHIP,
-        rules: [
+        purpose: "FalkorDB is the LifeOS PPV graph sidecar. Convex remains canonical for records; Falkor is optimized for graph traversal and agent-owned relationship memory.",
+        identity: "Every mirrored node uses convexId as the stable canonical id. Use node.convexId for lookups and falkor_graph_link endpoint ids.",
+        commonNodeProperties: [
+            "convexId",
+            "sourceSystem",
+            "sourceTable",
+            "sourceUserId",
+            "syncedAt",
+            "payloadJson",
+            "title",
+            "status",
+            "visionId",
+            "projectId",
+            "pillarId",
+            "updatedAt",
+            "createdAt",
+        ],
+        labels: [
+            {
+                label: "PpvVision",
+                convexTable: "ppv1_visions",
+                meaning: "Desired future / life direction record.",
+                primaryFields: ["convexId", "title", "status", "visionId", "updatedAt"],
+                statusValues: ["ideation", "todo", "planned", "in_progress", "done"],
+                commonFilters: [
+                    "v.status = 'in_progress'",
+                    "v.convexId = 'VISION_ID'",
+                ],
+            },
+            {
+                label: "PpvIdentity",
+                convexTable: "ppv1_identities",
+                meaning: "Identity, beliefs, and behavior components for a PPV vision.",
+                primaryFields: ["convexId", "title", "visionId", "updatedAt"],
+                commonFilters: ["identity.visionId = 'VISION_ID'"],
+            },
+            {
+                label: "PpvPillar",
+                convexTable: "ppv1_pillars",
+                meaning: "Ongoing system or pillar that supports a PPV vision.",
+                primaryFields: ["convexId", "title", "visionId", "updatedAt"],
+                commonFilters: ["pillar.visionId = 'VISION_ID'"],
+            },
+            {
+                label: "PpvProject",
+                convexTable: "lifeos_pmProjects",
+                meaning: "Existing LifeOS project mirrored into Falkor only when linked to PPV pillars.",
+                primaryFields: [
+                    "convexId",
+                    "title",
+                    "status",
+                    "projectId",
+                    "updatedAt",
+                ],
+                commonFilters: [
+                    "project.convexId = 'PROJECT_ID'",
+                    "project.title CONTAINS 'keyword'",
+                ],
+            },
+        ],
+        inferredRelationships: [
+            {
+                type: "HAS_IDENTITY",
+                from: "PpvVision",
+                to: "PpvIdentity",
+                source: "Convex sync",
+                meaning: "Vision owns an identity model.",
+                mutableByAgent: false,
+            },
+            {
+                type: "HAS_PILLAR",
+                from: "PpvVision",
+                to: "PpvPillar",
+                source: "Convex sync",
+                meaning: "Vision owns/supports a pillar.",
+                mutableByAgent: false,
+            },
+            {
+                type: "PILLAR_SUPPORTS_PROJECT",
+                from: "PpvPillar",
+                to: "PpvProject",
+                source: "Convex sync",
+                meaning: "Pillar is connected to an existing LifeOS project.",
+                mutableByAgent: false,
+            },
+        ],
+        agentWritableRelationship: {
+            type: FALKOR_AGENT_RELATIONSHIP,
+            mutableByAgent: true,
+            createWith: "falkor_graph_link",
+            deleteWith: "falkor_graph_unlink",
+            allowedEndpoints: FALKOR_NODE_LABELS,
+            fields: [
+                "convexId",
+                "kind",
+                "reason",
+                "confidence",
+                "createdBy",
+                "createdAt",
+                "updatedAt",
+                "metadataJson",
+            ],
+            guidance: "Use AGENT_LINK for durable interpretations, evidence, cross-cutting themes, or useful associations that are not Convex-canonical facts.",
+        },
+        queryRules: [
             "Use falkor_graph_query for read-only Cypher only.",
             "MATCH/WITH queries must include LIMIT unless they are aggregate count queries.",
+            "Prefer projected fields such as convexId, title, status, visionId, kind, reason, and confidence over returning whole nodes.",
             "Use falkor_graph_link for agent-created relationships; it writes only AGENT_LINK edges.",
             "Do not mutate Convex-synced nodes or inferred PPV relationships from FalkorDB. Convex remains canonical.",
             "Every agent link must include a reason and confidence.",
         ],
-        examples: {
-            ppvOverview: "MATCH (v:PpvVision)-[:HAS_PILLAR]->(p:PpvPillar)-[:PILLAR_SUPPORTS_PROJECT]->(project:PpvProject) RETURN v.convexId, v.title, p.convexId, p.title, project.convexId, project.title LIMIT 25",
-            projectInboundLinks: "MATCH (pillar:PpvPillar)-[:PILLAR_SUPPORTS_PROJECT]->(project:PpvProject {convexId: 'PROJECT_ID'}) RETURN pillar.convexId, pillar.title, project.title LIMIT 10",
-            agentLinks: "MATCH (a)-[r:AGENT_LINK]->(b) RETURN a.convexId, type(r), r.kind, r.reason, r.confidence, b.convexId LIMIT 25",
-        },
+        queryRecipes: [
+            {
+                name: "schemaCounts",
+                when: "Check whether the sidecar has data before deeper traversal.",
+                cypher: "MATCH (n) RETURN labels(n) AS labels, count(n) AS count ORDER BY count DESC",
+            },
+            {
+                name: "currentVisionMap",
+                when: "Show what the in-progress PPV vision is driving.",
+                cypher: "MATCH (v:PpvVision {status: 'in_progress'}) OPTIONAL MATCH (v)-[:HAS_IDENTITY]->(identity:PpvIdentity) OPTIONAL MATCH (v)-[:HAS_PILLAR]->(pillar:PpvPillar) OPTIONAL MATCH (pillar)-[:PILLAR_SUPPORTS_PROJECT]->(project:PpvProject) RETURN v.convexId AS visionId, v.title AS vision, identity.convexId AS identityId, pillar.convexId AS pillarId, pillar.title AS pillar, project.convexId AS projectId, project.title AS project LIMIT 50",
+            },
+            {
+                name: "visionToProjects",
+                when: "Trace a specific vision into pillars and linked projects.",
+                cypher: "MATCH (v:PpvVision {convexId: 'VISION_ID'})-[:HAS_PILLAR]->(pillar:PpvPillar)-[:PILLAR_SUPPORTS_PROJECT]->(project:PpvProject) RETURN v.convexId AS visionId, v.title AS vision, pillar.convexId AS pillarId, pillar.title AS pillar, project.convexId AS projectId, project.title AS project, project.status AS projectStatus LIMIT 50",
+            },
+            {
+                name: "projectWhyItMatters",
+                when: "Explain which PPV pillar or vision a project supports.",
+                cypher: "MATCH (v:PpvVision)-[:HAS_PILLAR]->(pillar:PpvPillar)-[:PILLAR_SUPPORTS_PROJECT]->(project:PpvProject {convexId: 'PROJECT_ID'}) RETURN project.convexId AS projectId, project.title AS project, pillar.convexId AS pillarId, pillar.title AS pillar, v.convexId AS visionId, v.title AS vision LIMIT 10",
+            },
+            {
+                name: "agentLinksAroundRecord",
+                when: "Inspect agent-created memory around a node before adding or deleting links.",
+                cypher: "MATCH (node {convexId: 'CONVEX_ID'})-[r:AGENT_LINK]-(other) RETURN labels(node) AS nodeLabels, node.convexId AS nodeId, type(r) AS relationshipType, r.kind AS kind, r.reason AS reason, r.confidence AS confidence, labels(other) AS otherLabels, other.convexId AS otherId, other.title AS otherTitle LIMIT 25",
+            },
+            {
+                name: "allAgentLinks",
+                when: "Audit agent-owned relationships.",
+                cypher: "MATCH (a)-[r:AGENT_LINK]->(b) RETURN labels(a) AS fromLabels, a.convexId AS fromId, a.title AS fromTitle, r.kind AS kind, r.reason AS reason, r.confidence AS confidence, labels(b) AS toLabels, b.convexId AS toId, b.title AS toTitle LIMIT 50",
+            },
+        ],
+        linkFlow: [
+            "Call falkor_graph_schema.",
+            "Read candidate nodes with falkor_graph_query and capture exact label + convexId values.",
+            "Check existing AGENT_LINK relationships around at least one endpoint.",
+            "Call falkor_graph_link with fromLabel, fromId, toLabel, toId, kind, reason, and confidence.",
+            "Report the created relationship id and why it exists.",
+        ],
     };
 }
 async function falkorGraphQuery(args) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@starascendin/lifeos-mcp",
-  "version": "0.7.69",
+  "version": "0.7.71",
   "description": "MCP server for LifeOS Project Management - manage projects, tasks, notes, and contacts via AI assistants",
   "type": "module",
   "main": "dist/index.js",