@murphai/murph 0.2.12 → 1.0.0

package/config.schema.json

@@ -219,11 +219,11 @@
                           "minLength": 1
                         },
                         "participant": {
-                          "description": "Optional remote participant identifier when the transport addresses a person directly. Use the transport-native participant value, such as an email correspondent; thread-addressed transports may rely on --sourceThread instead.",
+                          "description": "Optional remote participant identifier when the transport addresses a person directly. Use the transport-native participant value, such as an email correspondent; thread-addressed transports may rely on --thread instead.",
                           "type": "string",
                           "minLength": 1
                         },
-                        "sourceThread": {
+                        "thread": {
                           "description": "Optional upstream thread identifier when the transport routes by thread/chat. Use the transport-native thread value, such as a Telegram chat id or `<chatId>:topic:<messageThreadId>` topic route; direct-recipient routes can often leave this unset.",
                           "type": "string",
                           "minLength": 1
@@ -346,11 +346,11 @@
                           "minLength": 1
                         },
                         "participant": {
-                          "description": "Optional remote participant identifier when the transport addresses a person directly. Use the transport-native participant value, such as an email correspondent; thread-addressed transports may rely on --sourceThread instead.",
+                          "description": "Optional remote participant identifier when the transport addresses a person directly. Use the transport-native participant value, such as an email correspondent; thread-addressed transports may rely on --thread instead.",
                           "type": "string",
                           "minLength": 1
                         },
-                        "sourceThread": {
+                        "thread": {
                           "description": "Optional upstream thread identifier when the transport routes by thread/chat. Use the transport-native thread value, such as a Telegram chat id or `<chatId>:topic:<messageThreadId>` topic route; direct-recipient routes can often leave this unset.",
                           "type": "string",
                           "minLength": 1
@@ -464,11 +464,11 @@
                           "minLength": 1
                         },
                         "participant": {
-                          "description": "Optional remote participant identifier when the transport addresses a person directly. Use the transport-native participant value, such as an email correspondent; thread-addressed transports may rely on --sourceThread instead.",
+                          "description": "Optional remote participant identifier when the transport addresses a person directly. Use the transport-native participant value, such as an email correspondent; thread-addressed transports may rely on --thread instead.",
                           "type": "string",
                           "minLength": 1
                         },
-                        "sourceThread": {
+                        "thread": {
                           "description": "Optional upstream thread identifier when the transport routes by thread/chat. Use the transport-native thread value, such as a Telegram chat id or `<chatId>:topic:<messageThreadId>` topic route; direct-recipient routes can often leave this unset.",
                           "type": "string",
                           "minLength": 1
@@ -620,11 +620,11 @@
                                   "minLength": 1
                                 },
                                 "participant": {
-                                  "description": "Optional remote participant identifier when the transport addresses a person directly. Use the transport-native participant value, such as an email correspondent; thread-addressed transports may rely on --sourceThread instead.",
+                                  "description": "Optional remote participant identifier when the transport addresses a person directly. Use the transport-native participant value, such as an email correspondent; thread-addressed transports may rely on --thread instead.",
                                   "type": "string",
                                   "minLength": 1
                                 },
-                                "sourceThread": {
+                                "thread": {
                                   "description": "Optional upstream thread identifier when the transport routes by thread/chat. Use the transport-native thread value, such as a Telegram chat id or `<chatId>:topic:<messageThreadId>` topic route; direct-recipient routes can often leave this unset.",
                                   "type": "string",
                                   "minLength": 1
@@ -848,11 +848,11 @@
                   "minLength": 1
                 },
                 "participant": {
-                  "description": "Optional remote participant identifier when the transport addresses a person directly. Use the transport-native participant value, such as an email correspondent; thread-addressed transports may rely on --sourceThread instead.",
+                  "description": "Optional remote participant identifier when the transport addresses a person directly. Use the transport-native participant value, such as an email correspondent; thread-addressed transports may rely on --thread instead.",
                   "type": "string",
                   "minLength": 1
                 },
-                "sourceThread": {
+                "thread": {
                   "description": "Optional upstream thread identifier when the transport routes by thread/chat. Use the transport-native thread value, such as a Telegram chat id or `<chatId>:topic:<messageThreadId>` topic route; direct-recipient routes can often leave this unset.",
                   "type": "string",
                   "minLength": 1
@@ -1086,6 +1086,57 @@
             }
           }
         },
+        "sync": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "commands": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "push": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "options": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "vault": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Vault root to operate against."
+                        },
+                        "requestId": {
+                          "description": "Optional caller-supplied request id for audit correlation.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 128
+                        },
+                        "session": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "One-time pairing code from hosted Settings."
+                        },
+                        "host": {
+                          "default": "https://app.murph.ai",
+                          "description": "Hosted Murph app base URL.",
+                          "type": "string",
+                          "minLength": 1
+                        },
+                        "dryRun": {
+                          "default": false,
+                          "description": "Build and summarize the import pack without uploading it.",
+                          "type": "boolean"
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
         "automation": {
           "type": "object",
           "additionalProperties": false,
@@ -1217,6 +1268,206 @@
             }
           }
         },
+        "scheduled-log": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "commands": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "scaffold": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "options": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "vault": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Vault root to operate against."
+                        },
+                        "requestId": {
+                          "description": "Optional caller-supplied request id for audit correlation.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 128
+                        }
+                      }
+                    }
+                  }
+                },
+                "show": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "options": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "vault": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Vault root to operate against."
+                        },
+                        "requestId": {
+                          "description": "Optional caller-supplied request id for audit correlation.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 128
+                        }
+                      }
+                    }
+                  }
+                },
+                "list": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "options": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "vault": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Vault root to operate against."
+                        },
+                        "requestId": {
+                          "description": "Optional caller-supplied request id for audit correlation.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 128
+                        },
+                        "status": {
+                          "description": "Optional repeated status filter.",
+                          "type": "array",
+                          "items": {
+                            "type": "string",
+                            "enum": [
+                              "active",
+                              "paused",
+                              "archived"
+                            ]
+                          }
+                        },
+                        "text": {
+                          "description": "Optional lexical filter across title, action, schedule, and body.",
+                          "type": "string",
+                          "minLength": 1
+                        },
+                        "limit": {
+                          "default": 50,
+                          "type": "integer",
+                          "exclusiveMinimum": 0,
+                          "maximum": 200
+                        }
+                      }
+                    }
+                  }
+                },
+                "upsert": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "options": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "vault": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Vault root to operate against."
+                        },
+                        "requestId": {
+                          "description": "Optional caller-supplied request id for audit correlation.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 128
+                        },
+                        "input": {
+                          "type": "string",
+                          "description": "Scheduled-log payload in @file.json form or - for stdin."
+                        }
+                      }
+                    }
+                  }
+                },
+                "pause": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "options": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "vault": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Vault root to operate against."
+                        },
+                        "requestId": {
+                          "description": "Optional caller-supplied request id for audit correlation.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 128
+                        }
+                      }
+                    }
+                  }
+                },
+                "resume": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "options": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "vault": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Vault root to operate against."
+                        },
+                        "requestId": {
+                          "description": "Optional caller-supplied request id for audit correlation.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 128
+                        }
+                      }
+                    }
+                  }
+                },
+                "archive": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "options": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "vault": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Vault root to operate against."
+                        },
+                        "requestId": {
+                          "description": "Optional caller-supplied request id for audit correlation.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 128
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
         "audit": {
           "type": "object",
           "additionalProperties": false,
@@ -1346,6 +1597,230 @@
             }
           }
         },
+        "capture": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "commands": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "add": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "options": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "vault": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Vault root to operate against."
+                        },
+                        "requestId": {
+                          "description": "Optional caller-supplied request id for audit correlation.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 128
+                        },
+                        "input": {
+                          "description": "Optional structured capture payload in @file.json form or - for stdin.",
+                          "type": "string"
+                        },
+                        "media": {
+                          "description": "Media file paths for one capture. Repeat --media for multiple views of the same observation.",
+                          "type": "array",
+                          "items": {
+                            "type": "string",
+                            "minLength": 1,
+                            "description": "Filesystem path supplied by the operator."
+                          }
+                        },
+                        "label": {
+                          "description": "Optional stable label. Friendly text is normalized to kebab-case and used as a continuity tag.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 160
+                        },
+                        "bodySite": {
+                          "description": "Optional freeform body/site/location context. This is saved in the note and as a site-* tag.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 400
+                        },
+                        "collection": {
+                          "description": "Optional collection slug, such as skin-check-2026-04 or dermatology-baseline.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 160
+                        },
+                        "tag": {
+                          "description": "Optional capture tag. Repeat --tag for multiple entries.",
+                          "type": "array",
+                          "items": {
+                            "type": "string",
+                            "minLength": 1
+                          }
+                        },
+                        "note": {
+                          "description": "Optional capture note.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 4000
+                        },
+                        "title": {
+                          "description": "Optional capture title override.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 160
+                        },
+                        "occurredAt": {
+                          "description": "Optional occurrence timestamp in ISO 8601 form or YYYY-MM-DD form.",
+                          "anyOf": [
+                            {
+                              "type": "string",
+                              "format": "date-time",
+                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+                              "description": "Timestamp in ISO 8601 format with an explicit UTC offset."
+                            },
+                            {
+                              "type": "string",
+                              "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+                              "description": "Calendar date in YYYY-MM-DD form."
+                            }
+                          ]
+                        },
+                        "source": {
+                          "description": "Optional event source (`manual`, `import`, `device`, or `derived`).",
+                          "type": "string",
+                          "enum": [
+                            "manual",
+                            "import",
+                            "device",
+                            "derived"
+                          ]
+                        }
+                      }
+                    }
+                  }
+                },
+                "show": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "options": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "vault": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Vault root to operate against."
+                        },
+                        "requestId": {
+                          "description": "Optional caller-supplied request id for audit correlation.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 128
+                        }
+                      }
+                    }
+                  }
+                },
+                "list": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "options": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "vault": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Vault root to operate against."
+                        },
+                        "requestId": {
+                          "description": "Optional caller-supplied request id for audit correlation.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 128
+                        },
+                        "from": {
+                          "description": "Optional inclusive lower date bound in YYYY-MM-DD form.",
+                          "type": "string",
+                          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+                        },
+                        "to": {
+                          "description": "Optional inclusive upper date bound in YYYY-MM-DD form.",
+                          "type": "string",
+                          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+                        },
+                        "label": {
+                          "description": "Optional stable capture label filter.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 160
+                        },
+                        "bodySite": {
+                          "description": "Optional body/site filter, matched through the normalized site-* tag.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 400
+                        },
+                        "collection": {
+                          "description": "Optional collection filter.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 160
+                        },
+                        "tag": {
+                          "description": "Optional tag filter. Repeat --tag for multiple tags; all requested tags must match.",
+                          "type": "array",
+                          "items": {
+                            "type": "string",
+                            "minLength": 1
+                          }
+                        },
+                        "limit": {
+                          "default": 50,
+                          "description": "Maximum number of results to return.",
+                          "type": "integer",
+                          "exclusiveMinimum": 0,
+                          "maximum": 200
+                        }
+                      }
+                    }
+                  }
+                },
+                "manifest": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "options": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "vault": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Vault root to operate against."
+                        },
+                        "requestId": {
+                          "description": "Optional caller-supplied request id for audit correlation.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 128
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
         "document": {
           "type": "object",
           "additionalProperties": false,
@@ -1600,7 +2075,7 @@
                         "baseUrl": {
                           "description": "Override the reachable device sync control-plane URL. When omitted, Murph manages the local daemon for the selected vault. When set, Murph talks to the explicit control-plane target instead.",
                           "type": "string",
-                          "format": "uri"
+                          "minLength": 1
                         },
                         "returnTo": {
                           "description": "Optional post-connect redirect. Accepts a root-relative path like /settings/devices or an absolute URL; device-syncd still rejects absolute URLs outside its allowed origin list.",
@@ -1645,7 +2120,7 @@
                                 "baseUrl": {
                                   "description": "Override the reachable device sync control-plane URL. When omitted, Murph manages the local daemon for the selected vault. When set, Murph talks to the explicit control-plane target instead.",
                                   "type": "string",
-                                  "format": "uri"
+                                  "minLength": 1
                                 }
                               }
                             }
@@ -1685,7 +2160,7 @@
                                 "baseUrl": {
                                   "description": "Override the reachable device sync control-plane URL. When omitted, Murph manages the local daemon for the selected vault. When set, Murph talks to the explicit control-plane target instead.",
                                   "type": "string",
-                                  "format": "uri"
+                                  "minLength": 1
                                 },
                                 "provider": {
                                   "type": "string",
@@ -1718,7 +2193,7 @@
                                 "baseUrl": {
                                   "description": "Override the reachable device sync control-plane URL. When omitted, Murph manages the local daemon for the selected vault. When set, Murph talks to the explicit control-plane target instead.",
                                   "type": "string",
-                                  "format": "uri"
+                                  "minLength": 1
                                 }
                               }
                             }
@@ -1746,7 +2221,7 @@
                                 "baseUrl": {
                                   "description": "Override the reachable device sync control-plane URL. When omitted, Murph manages the local daemon for the selected vault. When set, Murph talks to the explicit control-plane target instead.",
                                   "type": "string",
-                                  "format": "uri"
+                                  "minLength": 1
                                 }
                               }
                             }
@@ -1774,7 +2249,7 @@
                                 "baseUrl": {
                                   "description": "Override the reachable device sync control-plane URL. When omitted, Murph manages the local daemon for the selected vault. When set, Murph talks to the explicit control-plane target instead.",
                                   "type": "string",
-                                  "format": "uri"
+                                  "minLength": 1
                                 }
                               }
                             }
@@ -1814,7 +2289,7 @@
                                 "baseUrl": {
                                   "description": "Override the loopback control-plane URL that Murph should manage for this vault.",
                                   "type": "string",
-                                  "format": "uri"
+                                  "minLength": 1
                                 }
                               }
                             }
@@ -1842,7 +2317,7 @@
                                 "baseUrl": {
                                   "description": "Override the loopback control-plane URL that Murph should manage for this vault.",
                                   "type": "string",
-                                  "format": "uri"
+                                  "minLength": 1
                                 }
                               }
                             }
@@ -1870,7 +2345,7 @@
                                 "baseUrl": {
                                   "description": "Override the loopback control-plane URL that Murph should manage for this vault.",
                                   "type": "string",
-                                  "format": "uri"
+                                  "minLength": 1
                                 }
                               }
                             }
@@ -2184,6 +2659,10 @@
                           "minLength": 1,
                           "maxLength": 128
                         },
+                        "input": {
+                          "description": "Optional structured meal payload in @file.json form or - for stdin. Structured payload object keys: `photo` or `photoPath` for an optional meal photo path; `audio` or `audioPath` for an optional audio note path; `note`, `occurredAt`, and `source` for the saved event fields; `ingredients` as a string array; `nutrition` as `{ totals?: { calories?, proteinGrams?, carbsGrams?, fatGrams?, fiberGrams? }, provenance?: { source, confidence?, sourceDetail? } }`. Explicit flags override payload fields.",
+                          "type": "string"
+                        },
                         "photo": {
                           "description": "Optional meal photo path.",
                           "type": "string",
@@ -2280,6 +2759,13 @@
                           "description": "Optional inclusive upper date bound in YYYY-MM-DD form.",
                           "type": "string",
                           "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+                        },
+                        "limit": {
+                          "default": 50,
+                          "description": "Maximum number of results to return.",
+                          "type": "integer",
+                          "exclusiveMinimum": 0,
+                          "maximum": 200
                         }
                       }
                     }
@@ -2419,7 +2905,7 @@
             }
           }
         },
-        "workout": {
+        "measurement": {
           "type": "object",
           "additionalProperties": false,
           "properties": {
@@ -2447,26 +2933,44 @@
                           "maxLength": 128
                         },
                         "input": {
-                          "description": "Optional structured workout payload in @file.json form or - for stdin.",
+                          "description": "Optional structured measurement payload in @file.json form or - for stdin.",
                           "type": "string"
                         },
-                        "duration": {
-                          "description": "Optional duration override in minutes when the note or structured payload is missing or ambiguous.",
-                          "type": "integer",
-                          "exclusiveMinimum": 0,
-                          "maximum": 1440
-                        },
-                        "type": {
-                          "description": "Optional workout type override such as \"run\" or \"strength training\".",
+                        "metric": {
+                          "description": "Measurement metric name or slug. Friendly names are normalized to kebab-case.",
                           "type": "string",
                           "minLength": 1,
                           "maxLength": 120
                         },
-                        "distanceKm": {
-                          "description": "Optional workout distance override in kilometers.",
-                          "type": "number",
-                          "exclusiveMinimum": 0,
-                          "maximum": 1000
+                        "value": {
+                          "description": "Single measurement numeric value when --input is not provided.",
+                          "type": "number"
+                        },
+                        "unit": {
+                          "description": "Measurement unit such as lb, kg, percent, ms, bpm, or mmol/L.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 64
+                        },
+                        "qualifier": {
+                          "description": "Optional measurement qualifier in key=value form. Repeat --qualifier for multiple entries.",
+                          "type": "array",
+                          "items": {
+                            "type": "string",
+                            "minLength": 1
+                          }
+                        },
+                        "note": {
+                          "description": "Optional measurement note.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 4000
+                        },
+                        "title": {
+                          "description": "Optional measurement title override.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 160
                         },
                         "occurredAt": {
                           "description": "Optional occurrence timestamp in ISO 8601 form or YYYY-MM-DD form.",
@@ -2495,7 +2999,7 @@
                           ]
                         },
                         "media": {
-                          "description": "Optional workout photo or video file paths to copy into raw/workouts/** and attach to the workout event.",
+                          "description": "Optional measurement photo or video file paths to copy into raw/measurements/** and attach to the measurement event.",
                           "type": "array",
                           "items": {
                             "type": "string",
@@ -2592,8 +3096,20 @@
                       }
                     }
                   }
-                },
-                "edit": {
+                }
+              }
+            }
+          }
+        },
+        "workout": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "commands": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "add": {
                   "type": "object",
                   "additionalProperties": false,
                   "properties": {
@@ -2613,38 +3129,67 @@
                           "maxLength": 128
                         },
                         "input": {
-                          "description": "Optional partial JSON patch in @file.json form or - for stdin.",
+                          "description": "Optional structured workout payload in @file.json form or - for stdin.",
                           "type": "string"
                         },
-                        "set": {
-                          "type": "array",
-                          "items": {
-                            "type": "string",
-                            "minLength": 1,
-                            "description": "Path assignment in dotted.path=value form. Repeat --set for multiple fields."
-                          }
+                        "duration": {
+                          "description": "Optional duration override in minutes when the note or structured payload is missing or ambiguous.",
+                          "type": "integer",
+                          "exclusiveMinimum": 0,
+                          "maximum": 1440
                         },
-                        "clear": {
+                        "type": {
+                          "description": "Optional workout type override such as \"run\" or \"strength training\".",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 120
+                        },
+                        "distanceKm": {
+                          "description": "Optional workout distance override in kilometers.",
+                          "type": "number",
+                          "exclusiveMinimum": 0,
+                          "maximum": 1000
+                        },
+                        "occurredAt": {
+                          "description": "Optional occurrence timestamp in ISO 8601 form or YYYY-MM-DD form.",
+                          "anyOf": [
+                            {
+                              "type": "string",
+                              "format": "date-time",
+                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+                              "description": "Timestamp in ISO 8601 format with an explicit UTC offset."
+                            },
+                            {
+                              "type": "string",
+                              "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+                              "description": "Calendar date in YYYY-MM-DD form."
+                            }
+                          ]
+                        },
+                        "source": {
+                          "description": "Optional event source (`manual`, `import`, `device`, or `derived`).",
+                          "type": "string",
+                          "enum": [
+                            "manual",
+                            "import",
+                            "device",
+                            "derived"
+                          ]
+                        },
+                        "media": {
+                          "description": "Optional workout photo or video file paths to copy into raw/workouts/** and attach to the workout event.",
                           "type": "array",
                           "items": {
                             "type": "string",
                             "minLength": 1,
-                            "description": "Dotted path to clear from the saved record. Repeat --clear for multiple fields."
+                            "description": "Filesystem path supplied by the operator."
                           }
-                        },
-                        "dayKeyPolicy": {
-                          "type": "string",
-                          "enum": [
-                            "keep",
-                            "recompute"
-                          ],
-                          "description": "Required for event-backed edits when occurredAt or timeZone changes and dayKey is not patched directly. `keep` preserves the saved dayKey; `recompute` drops it so core recalculates from the explicit event timeZone."
                         }
                       }
                     }
                   }
                 },
-                "delete": {
+                "show": {
                   "type": "object",
                   "additionalProperties": false,
                   "properties": {
@@ -2667,204 +3212,138 @@
                     }
                   }
                 },
-                "measurement": {
+                "list": {
                   "type": "object",
                   "additionalProperties": false,
                   "properties": {
-                    "commands": {
+                    "options": {
                       "type": "object",
                       "additionalProperties": false,
                       "properties": {
-                        "add": {
-                          "type": "object",
-                          "additionalProperties": false,
-                          "properties": {
-                            "options": {
-                              "type": "object",
-                              "additionalProperties": false,
-                              "properties": {
-                                "vault": {
-                                  "type": "string",
-                                  "minLength": 1,
-                                  "description": "Vault root to operate against."
-                                },
-                                "requestId": {
-                                  "description": "Optional caller-supplied request id for audit correlation.",
-                                  "type": "string",
-                                  "minLength": 1,
-                                  "maxLength": 128
-                                },
-                                "input": {
-                                  "description": "Optional structured body-measurement payload in @file.json form or - for stdin.",
-                                  "type": "string"
-                                },
-                                "type": {
-                                  "description": "Single measurement type to record when --input is not provided.",
-                                  "type": "string",
-                                  "enum": [
-                                    "weight",
-                                    "body_fat_pct",
-                                    "waist",
-                                    "neck",
-                                    "shoulders",
-                                    "chest",
-                                    "biceps",
-                                    "forearms",
-                                    "abdomen",
-                                    "hips",
-                                    "thighs",
-                                    "calves"
-                                  ]
-                                },
-                                "value": {
-                                  "description": "Single measurement numeric value when --input is not provided.",
-                                  "type": "number",
-                                  "minimum": 0
-                                },
-                                "unit": {
-                                  "description": "Optional measurement unit. When omitted, Murph falls back to saved workout unit preferences where possible.",
-                                  "type": "string",
-                                  "enum": [
-                                    "lb",
-                                    "kg",
-                                    "percent",
-                                    "cm",
-                                    "in"
-                                  ]
-                                },
-                                "note": {
-                                  "description": "Optional measurement note.",
-                                  "type": "string",
-                                  "minLength": 1,
-                                  "maxLength": 4000
-                                },
-                                "title": {
-                                  "description": "Optional measurement title override.",
-                                  "type": "string",
-                                  "minLength": 1,
-                                  "maxLength": 160
-                                },
-                                "occurredAt": {
-                                  "description": "Optional occurrence timestamp in ISO 8601 form or YYYY-MM-DD form.",
-                                  "anyOf": [
-                                    {
-                                      "type": "string",
-                                      "format": "date-time",
-                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-                                      "description": "Timestamp in ISO 8601 format with an explicit UTC offset."
-                                    },
-                                    {
-                                      "type": "string",
-                                      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-                                      "description": "Calendar date in YYYY-MM-DD form."
-                                    }
-                                  ]
-                                },
-                                "source": {
-                                  "description": "Optional event source (`manual`, `import`, `device`, or `derived`).",
-                                  "type": "string",
-                                  "enum": [
-                                    "manual",
-                                    "import",
-                                    "device",
-                                    "derived"
-                                  ]
-                                },
-                                "media": {
-                                  "description": "Optional progress photo or video file paths to copy into raw/measurements/** and attach to the measurement event.",
-                                  "type": "array",
-                                  "items": {
-                                    "type": "string",
-                                    "minLength": 1,
-                                    "description": "Filesystem path supplied by the operator."
-                                  }
-                                }
-                              }
-                            }
-                          }
+                        "vault": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Vault root to operate against."
+                        },
+                        "requestId": {
+                          "description": "Optional caller-supplied request id for audit correlation.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 128
+                        },
+                        "from": {
+                          "description": "Optional inclusive lower date bound in YYYY-MM-DD form.",
+                          "type": "string",
+                          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+                        },
+                        "to": {
+                          "description": "Optional inclusive upper date bound in YYYY-MM-DD form.",
+                          "type": "string",
+                          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+                        },
+                        "limit": {
+                          "default": 50,
+                          "description": "Maximum number of results to return.",
+                          "type": "integer",
+                          "exclusiveMinimum": 0,
+                          "maximum": 200
+                        }
+                      }
+                    }
+                  }
+                },
+                "manifest": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "options": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "vault": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Vault root to operate against."
                         },
-                        "show": {
-                          "type": "object",
-                          "additionalProperties": false,
-                          "properties": {
-                            "options": {
-                              "type": "object",
-                              "additionalProperties": false,
-                              "properties": {
-                                "vault": {
-                                  "type": "string",
-                                  "minLength": 1,
-                                  "description": "Vault root to operate against."
-                                },
-                                "requestId": {
-                                  "description": "Optional caller-supplied request id for audit correlation.",
-                                  "type": "string",
-                                  "minLength": 1,
-                                  "maxLength": 128
-                                }
-                              }
-                            }
-                          }
+                        "requestId": {
+                          "description": "Optional caller-supplied request id for audit correlation.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 128
+                        }
+                      }
+                    }
+                  }
+                },
+                "edit": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "options": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "vault": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Vault root to operate against."
                         },
-                        "list": {
-                          "type": "object",
-                          "additionalProperties": false,
-                          "properties": {
-                            "options": {
-                              "type": "object",
-                              "additionalProperties": false,
-                              "properties": {
-                                "vault": {
-                                  "type": "string",
-                                  "minLength": 1,
-                                  "description": "Vault root to operate against."
-                                },
-                                "requestId": {
-                                  "description": "Optional caller-supplied request id for audit correlation.",
-                                  "type": "string",
-                                  "minLength": 1,
-                                  "maxLength": 128
-                                },
-                                "from": {
-                                  "type": "string",
-                                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
-                                },
-                                "to": {
-                                  "type": "string",
-                                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
-                                },
-                                "limit": {
-                                  "default": 50,
-                                  "type": "integer",
-                                  "exclusiveMinimum": 0,
-                                  "maximum": 200
-                                }
-                              }
-                            }
+                        "requestId": {
+                          "description": "Optional caller-supplied request id for audit correlation.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 128
+                        },
+                        "input": {
+                          "description": "Optional partial JSON patch in @file.json form or - for stdin.",
+                          "type": "string"
+                        },
+                        "set": {
+                          "type": "array",
+                          "items": {
+                            "type": "string",
+                            "minLength": 1,
+                            "description": "Path assignment in dotted.path=value form. Repeat --set for multiple fields."
                           }
                         },
-                        "manifest": {
-                          "type": "object",
-                          "additionalProperties": false,
-                          "properties": {
-                            "options": {
-                              "type": "object",
-                              "additionalProperties": false,
-                              "properties": {
-                                "vault": {
-                                  "type": "string",
-                                  "minLength": 1,
-                                  "description": "Vault root to operate against."
-                                },
-                                "requestId": {
-                                  "description": "Optional caller-supplied request id for audit correlation.",
-                                  "type": "string",
-                                  "minLength": 1,
-                                  "maxLength": 128
-                                }
-                              }
-                            }
+                        "clear": {
+                          "type": "array",
+                          "items": {
+                            "type": "string",
+                            "minLength": 1,
+                            "description": "Dotted path to clear from the saved record. Repeat --clear for multiple fields."
                           }
+                        },
+                        "dayKeyPolicy": {
+                          "type": "string",
+                          "enum": [
+                            "keep",
+                            "recompute"
+                          ],
+                          "description": "Required for event-backed edits when occurredAt or timeZone changes and dayKey is not patched directly. `keep` preserves the saved dayKey; `recompute` drops it so core recalculates from the explicit event timeZone."
+                        }
+                      }
+                    }
+                  }
+                },
+                "delete": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "options": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "vault": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Vault root to operate against."
+                        },
+                        "requestId": {
+                          "description": "Optional caller-supplied request id for audit correlation.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 128
                         }
                       }
                     }
@@ -3868,7 +4347,7 @@
                     }
                   }
                 },
-                "edit": {
+                "rename": {
                   "type": "object",
                   "additionalProperties": false,
                   "properties": {
@@ -3887,31 +4366,22 @@
                           "minLength": 1,
                           "maxLength": 128
                         },
-                        "input": {
-                          "description": "Optional partial JSON patch in @file.json form or - for stdin.",
-                          "type": "string"
-                        },
-                        "set": {
-                          "type": "array",
-                          "items": {
-                            "type": "string",
-                            "minLength": 1,
-                            "description": "Path assignment in dotted.path=value form. Repeat --set for multiple fields."
-                          }
+                        "title": {
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 160,
+                          "description": "New remembered food title."
                         },
-                        "clear": {
-                          "type": "array",
-                          "items": {
-                            "type": "string",
-                            "minLength": 1,
-                            "description": "Dotted path to clear from the saved record. Repeat --clear for multiple fields."
-                          }
+                        "slug": {
+                          "description": "Optional stable slug override for the renamed food record.",
+                          "type": "string",
+                          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
                         }
                       }
                     }
                   }
                 },
-                "delete": {
+                "schedule": {
                   "type": "object",
                   "additionalProperties": false,
                   "properties": {
@@ -3929,12 +4399,28 @@
                           "type": "string",
                           "minLength": 1,
                           "maxLength": 128
+                        },
+                        "time": {
+                          "type": "string",
+                          "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$",
+                          "description": "Daily local time in 24-hour HH:MM form."
+                        },
+                        "note": {
+                          "description": "Optional remembered food note that will be used in the auto-logged meal entry.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 4000
+                        },
+                        "slug": {
+                          "description": "Optional stable slug override for the remembered food record.",
+                          "type": "string",
+                          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
                         }
                       }
                     }
                   }
                 },
-                "rename": {
+                "unschedule": {
                   "type": "object",
                   "additionalProperties": false,
                   "properties": {
@@ -3952,23 +4438,55 @@
                           "type": "string",
                           "minLength": 1,
                           "maxLength": 128
-                        },
-                        "title": {
+                        }
+                      }
+                    }
+                  }
+                },
+                "edit": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "options": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "vault": {
                           "type": "string",
                           "minLength": 1,
-                          "maxLength": 160,
-                          "description": "New remembered food title."
+                          "description": "Vault root to operate against."
                         },
-                        "slug": {
-                          "description": "Optional stable slug override for the renamed food record.",
+                        "requestId": {
+                          "description": "Optional caller-supplied request id for audit correlation.",
                           "type": "string",
-                          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
+                          "minLength": 1,
+                          "maxLength": 128
+                        },
+                        "input": {
+                          "description": "Optional partial JSON patch in @file.json form or - for stdin.",
+                          "type": "string"
+                        },
+                        "set": {
+                          "type": "array",
+                          "items": {
+                            "type": "string",
+                            "minLength": 1,
+                            "description": "Path assignment in dotted.path=value form. Repeat --set for multiple fields."
+                          }
+                        },
+                        "clear": {
+                          "type": "array",
+                          "items": {
+                            "type": "string",
+                            "minLength": 1,
+                            "description": "Dotted path to clear from the saved record. Repeat --clear for multiple fields."
+                          }
                         }
                       }
                     }
                   }
                 },
-                "schedule": {
+                "delete": {
                   "type": "object",
                   "additionalProperties": false,
                   "properties": {
@@ -3986,22 +4504,6 @@
                           "type": "string",
                           "minLength": 1,
                           "maxLength": 128
-                        },
-                        "time": {
-                          "type": "string",
-                          "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$",
-                          "description": "Daily local time in 24-hour HH:MM form."
-                        },
-                        "note": {
-                          "description": "Optional remembered food note that will be used in the auto-logged meal entry.",
-                          "type": "string",
-                          "minLength": 1,
-                          "maxLength": 4000
-                        },
-                        "slug": {
-                          "description": "Optional stable slug override for the remembered food record.",
-                          "type": "string",
-                          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
                         }
                       }
                     }
@@ -4044,12 +4546,14 @@
                             "symptom",
                             "note",
                             "observation",
+                            "measurement",
                             "medication_intake",
                             "supplement_intake",
                             "activity_session",
                             "body_measurement",
                             "sleep_session",
-                            "intervention_session"
+                            "intervention_session",
+                            "experiment_context"
                           ],
                           "description": "Canonical event kind to scaffold."
                         }
@@ -4303,22 +4807,22 @@
                           "minLength": 1
                         },
                         "stream": {
-                          "description": "Stream identifier to write under. Required unless the selected preset supplies it.",
+                          "description": "Optional stream identifier. Recognized aliases such as SpO2 are accepted, and the importer can infer the stream from recognizable CSV headers when unambiguous.",
                           "type": "string",
                           "minLength": 1
                         },
                         "tsColumn": {
-                          "description": "CSV column containing timestamps. Required unless the selected preset supplies it.",
+                          "description": "Optional timestamp column override. When omitted, the importer will use recognizable timestamp headers such as time or timestamp.",
                           "type": "string",
                           "minLength": 1
                         },
                         "valueColumn": {
-                          "description": "CSV column containing the numeric value. Required unless the selected preset supplies it.",
+                          "description": "Optional numeric value column override. When omitted, the importer will infer a recognizable metric column, or import all recognizable metrics when the CSV is unambiguous.",
                           "type": "string",
                           "minLength": 1
                         },
                         "unit": {
-                          "description": "Unit label for the imported values. Required unless the selected preset supplies it.",
+                          "description": "Optional unit override. When omitted, the importer will use the preset unit or a stream-specific default.",
                           "type": "string",
                           "minLength": 1
                         },
@@ -4505,6 +5009,52 @@
               "type": "object",
               "additionalProperties": false,
               "properties": {
+                "latest": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "options": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "vault": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Vault root to operate against."
+                        },
+                        "requestId": {
+                          "description": "Optional caller-supplied request id for audit correlation.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 128
+                        },
+                        "date": {
+                          "description": "Optional one-day filter. When present, Murph treats it as both --from and --to.",
+                          "type": "string",
+                          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+                        },
+                        "from": {
+                          "description": "Inclusive lower date bound.",
+                          "type": "string",
+                          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+                        },
+                        "to": {
+                          "description": "Inclusive upper date bound.",
+                          "type": "string",
+                          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+                        },
+                        "provider": {
+                          "description": "Optional provider filter. Repeat --provider for multiple values such as oura, whoop, or garmin.",
+                          "type": "array",
+                          "items": {
+                            "type": "string",
+                            "minLength": 1
+                          }
+                        }
+                      }
+                    }
+                  }
+                },
                 "day": {
                   "type": "object",
                   "additionalProperties": false,
@@ -4541,6 +5091,177 @@
                     }
                   }
                 },
+                "drift": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "options": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "vault": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Vault root to operate against."
+                        },
+                        "requestId": {
+                          "description": "Optional caller-supplied request id for audit correlation.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 128
+                        },
+                        "date": {
+                          "description": "Optional one-day filter. When present, Murph treats it as both --from and --to.",
+                          "type": "string",
+                          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+                        },
+                        "from": {
+                          "description": "Inclusive lower date bound.",
+                          "type": "string",
+                          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+                        },
+                        "to": {
+                          "description": "Inclusive upper date bound.",
+                          "type": "string",
+                          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+                        },
+                        "provider": {
+                          "description": "Optional provider filter. Repeat --provider for multiple values such as oura, whoop, or garmin.",
+                          "type": "array",
+                          "items": {
+                            "type": "string",
+                            "minLength": 1
+                          }
+                        },
+                        "windowDays": {
+                          "default": 7,
+                          "description": "Rolling local-day window size for recent versus prior summary comparisons.",
+                          "type": "integer",
+                          "exclusiveMinimum": 0,
+                          "maximum": 30
+                        }
+                      }
+                    }
+                  }
+                },
+                "metric": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "commands": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "latest": {
+                          "type": "object",
+                          "additionalProperties": false,
+                          "properties": {
+                            "options": {
+                              "type": "object",
+                              "additionalProperties": false,
+                              "properties": {
+                                "vault": {
+                                  "type": "string",
+                                  "minLength": 1,
+                                  "description": "Vault root to operate against."
+                                },
+                                "requestId": {
+                                  "description": "Optional caller-supplied request id for audit correlation.",
+                                  "type": "string",
+                                  "minLength": 1,
+                                  "maxLength": 128
+                                },
+                                "date": {
+                                  "description": "Optional one-day filter. When present, Murph treats it as both --from and --to.",
+                                  "type": "string",
+                                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+                                },
+                                "from": {
+                                  "description": "Inclusive lower date bound.",
+                                  "type": "string",
+                                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+                                },
+                                "to": {
+                                  "description": "Inclusive upper date bound.",
+                                  "type": "string",
+                                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+                                },
+                                "provider": {
+                                  "description": "Optional provider filter. Repeat --provider for multiple values such as oura, whoop, or garmin.",
+                                  "type": "array",
+                                  "items": {
+                                    "type": "string",
+                                    "minLength": 1
+                                  }
+                                },
+                                "windowDays": {
+                                  "default": 7,
+                                  "description": "Rolling local-day window size for recent versus prior summary comparisons.",
+                                  "type": "integer",
+                                  "exclusiveMinimum": 0,
+                                  "maximum": 30
+                                }
+                              }
+                            }
+                          }
+                        },
+                        "trend": {
+                          "type": "object",
+                          "additionalProperties": false,
+                          "properties": {
+                            "options": {
+                              "type": "object",
+                              "additionalProperties": false,
+                              "properties": {
+                                "vault": {
+                                  "type": "string",
+                                  "minLength": 1,
+                                  "description": "Vault root to operate against."
+                                },
+                                "requestId": {
+                                  "description": "Optional caller-supplied request id for audit correlation.",
+                                  "type": "string",
+                                  "minLength": 1,
+                                  "maxLength": 128
+                                },
+                                "date": {
+                                  "description": "Optional one-day filter. When present, Murph treats it as both --from and --to.",
+                                  "type": "string",
+                                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+                                },
+                                "from": {
+                                  "description": "Inclusive lower date bound.",
+                                  "type": "string",
+                                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+                                },
+                                "to": {
+                                  "description": "Inclusive upper date bound.",
+                                  "type": "string",
+                                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+                                },
+                                "provider": {
+                                  "description": "Optional provider filter. Repeat --provider for multiple values such as oura, whoop, or garmin.",
+                                  "type": "array",
+                                  "items": {
+                                    "type": "string",
+                                    "minLength": 1
+                                  }
+                                },
+                                "windowDays": {
+                                  "default": 7,
+                                  "description": "Rolling local-day window size for recent versus prior summary comparisons.",
+                                  "type": "integer",
+                                  "exclusiveMinimum": 0,
+                                  "maximum": 30
+                                }
+                              }
+                            }
+                          }
+                        }
+                      }
+                    }
+                  }
+                },
                 "sleep": {
                   "type": "object",
                   "additionalProperties": false,
@@ -4969,6 +5690,13 @@
                           "minLength": 1,
                           "maxLength": 128
                         },
+                        "limit": {
+                          "default": 50,
+                          "description": "Maximum number of results to return.",
+                          "type": "integer",
+                          "exclusiveMinimum": 0,
+                          "maximum": 200
+                        },
                         "status": {
                           "description": "Optional experiment status filter.",
                           "type": "string",
@@ -4979,13 +5707,6 @@
                             "completed",
                             "abandoned"
                           ]
-                        },
-                        "limit": {
-                          "default": 50,
-                          "description": "Maximum number of results to return.",
-                          "type": "integer",
-                          "exclusiveMinimum": 0,
-                          "maximum": 200
                         }
                       }
                     }
@@ -5018,7 +5739,34 @@
                     }
                   }
                 },
-                "checkpoint": {
+                "checkpoint": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "options": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "vault": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Vault root to operate against."
+                        },
+                        "requestId": {
+                          "description": "Optional caller-supplied request id for audit correlation.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 128
+                        },
+                        "input": {
+                          "type": "string",
+                          "description": "Payload input in @file.json form or - for stdin."
+                        }
+                      }
+                    }
+                  }
+                },
+                "stop": {
                   "type": "object",
                   "additionalProperties": false,
                   "properties": {
@@ -5037,15 +5785,21 @@
                           "minLength": 1,
                           "maxLength": 128
                         },
-                        "input": {
+                        "occurredAt": {
+                          "description": "Optional stop timestamp in ISO 8601 form or YYYY-MM-DD form.",
                           "type": "string",
-                          "description": "Payload input in @file.json form or - for stdin."
+                          "minLength": 1
+                        },
+                        "note": {
+                          "description": "Optional stop note.",
+                          "type": "string",
+                          "minLength": 1
                         }
                       }
                     }
                   }
                 },
-                "stop": {
+                "progress": {
                   "type": "object",
                   "additionalProperties": false,
                   "properties": {
@@ -5064,26 +5818,156 @@
                           "minLength": 1,
                           "maxLength": 128
                         },
-                        "occurredAt": {
-                          "description": "Optional stop timestamp in ISO 8601 form or YYYY-MM-DD form.",
-                          "anyOf": [
-                            {
-                              "type": "string",
-                              "format": "date-time",
-                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-                              "description": "Timestamp in ISO 8601 format with an explicit UTC offset."
-                            },
-                            {
-                              "type": "string",
-                              "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-                              "description": "Calendar date in YYYY-MM-DD form."
+                        "asOf": {
+                          "description": "Optional analysis date in YYYY-MM-DD form.",
+                          "type": "string",
+                          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+                        }
+                      }
+                    }
+                  }
+                },
+                "session": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "commands": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "log": {
+                          "type": "object",
+                          "additionalProperties": false,
+                          "properties": {
+                            "options": {
+                              "type": "object",
+                              "additionalProperties": false,
+                              "properties": {
+                                "vault": {
+                                  "type": "string",
+                                  "minLength": 1,
+                                  "description": "Vault root to operate against."
+                                },
+                                "requestId": {
+                                  "description": "Optional caller-supplied request id for audit correlation.",
+                                  "type": "string",
+                                  "minLength": 1,
+                                  "maxLength": 128
+                                },
+                                "input": {
+                                  "type": "string",
+                                  "description": "Payload input in @file.json form or - for stdin."
+                                }
+                              }
                             }
-                          ]
+                          }
+                        }
+                      }
+                    }
+                  }
+                },
+                "context": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "commands": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "log": {
+                          "type": "object",
+                          "additionalProperties": false,
+                          "properties": {
+                            "options": {
+                              "type": "object",
+                              "additionalProperties": false,
+                              "properties": {
+                                "vault": {
+                                  "type": "string",
+                                  "minLength": 1,
+                                  "description": "Vault root to operate against."
+                                },
+                                "requestId": {
+                                  "description": "Optional caller-supplied request id for audit correlation.",
+                                  "type": "string",
+                                  "minLength": 1,
+                                  "maxLength": 128
+                                },
+                                "input": {
+                                  "type": "string",
+                                  "description": "Payload input in @file.json form or - for stdin."
+                                }
+                              }
+                            }
+                          }
+                        }
+                      }
+                    }
+                  }
+                },
+                "outcome": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "commands": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "analyze": {
+                          "type": "object",
+                          "additionalProperties": false,
+                          "properties": {
+                            "options": {
+                              "type": "object",
+                              "additionalProperties": false,
+                              "properties": {
+                                "vault": {
+                                  "type": "string",
+                                  "minLength": 1,
+                                  "description": "Vault root to operate against."
+                                },
+                                "requestId": {
+                                  "description": "Optional caller-supplied request id for audit correlation.",
+                                  "type": "string",
+                                  "minLength": 1,
+                                  "maxLength": 128
+                                },
+                                "asOf": {
+                                  "description": "Optional analysis date in YYYY-MM-DD form.",
+                                  "type": "string",
+                                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+                                }
+                              }
+                            }
+                          }
                         },
-                        "note": {
-                          "description": "Optional stop note.",
-                          "type": "string",
-                          "minLength": 1
+                        "write": {
+                          "type": "object",
+                          "additionalProperties": false,
+                          "properties": {
+                            "options": {
+                              "type": "object",
+                              "additionalProperties": false,
+                              "properties": {
+                                "vault": {
+                                  "type": "string",
+                                  "minLength": 1,
+                                  "description": "Vault root to operate against."
+                                },
+                                "requestId": {
+                                  "description": "Optional caller-supplied request id for audit correlation.",
+                                  "type": "string",
+                                  "minLength": 1,
+                                  "maxLength": 128
+                                },
+                                "asOf": {
+                                  "description": "Optional analysis date in YYYY-MM-DD form.",
+                                  "type": "string",
+                                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+                                }
+                              }
+                            }
+                          }
                         }
                       }
                     }
@@ -5426,9 +6310,9 @@
                           "maxLength": 128
                         },
                         "text": {
+                          "description": "Named search text alias. Required when the positional query is omitted; use this for explicit machine-oriented calls.",
                           "type": "string",
-                          "minLength": 1,
-                          "description": "Required search text to run across titles, notes, tags, ids, and record payloads."
+                          "minLength": 1
                         },
                         "recordType": {
                           "description": "Optional query record families. Repeat --record-type for multiple values: allergy, assessment, audit, condition, core, event, experiment, family, food, genetics, goal, journal, protocol, provider, recipe, sample, workout_format.",
@@ -6462,11 +7346,6 @@
                           "type": "string",
                           "minLength": 1
                         },
-                        "pdftotextCommand": {
-                          "description": "Optional explicit pdftotext command or path to persist.",
-                          "type": "string",
-                          "minLength": 1
-                        },
                         "whisperCommand": {
                           "description": "Optional explicit whisper.cpp command or path to persist.",
                           "type": "string",
@@ -6509,11 +7388,6 @@
                           "type": "string",
                           "minLength": 1
                         },
-                        "pdftotextCommand": {
-                          "description": "Optional explicit pdftotext command or path to persist.",
-                          "type": "string",
-                          "minLength": 1
-                        },
                         "whisperCommand": {
                           "description": "Optional explicit whisper.cpp command or path to persist.",
                           "type": "string",
@@ -6643,6 +7517,12 @@
                                   "type": "string",
                                   "minLength": 1,
                                   "maxLength": 128
+                                },
+                                "limit": {
+                                  "description": "Optional maximum number of connectors to return.",
+                                  "type": "integer",
+                                  "exclusiveMinimum": 0,
+                                  "maximum": 200
                                 }
                               }
                             }
@@ -6988,6 +7868,35 @@
                       "additionalProperties": false,
                       "properties": {
                         "list": {
+                          "type": "object",
+                          "additionalProperties": false,
+                          "properties": {
+                            "options": {
+                              "type": "object",
+                              "additionalProperties": false,
+                              "properties": {
+                                "vault": {
+                                  "type": "string",
+                                  "minLength": 1,
+                                  "description": "Vault root to operate against."
+                                },
+                                "requestId": {
+                                  "description": "Optional caller-supplied request id for audit correlation.",
+                                  "type": "string",
+                                  "minLength": 1,
+                                  "maxLength": 128
+                                },
+                                "limit": {
+                                  "description": "Optional maximum number of attachments to return.",
+                                  "type": "integer",
+                                  "exclusiveMinimum": 0,
+                                  "maximum": 200
+                                }
+                              }
+                            }
+                          }
+                        },
+                        "inspect": {
                           "type": "object",
                           "additionalProperties": false,
                           "properties": {
@@ -7033,6 +7942,29 @@
                             }
                           }
                         },
+                        "status": {
+                          "type": "object",
+                          "additionalProperties": false,
+                          "properties": {
+                            "options": {
+                              "type": "object",
+                              "additionalProperties": false,
+                              "properties": {
+                                "vault": {
+                                  "type": "string",
+                                  "minLength": 1,
+                                  "description": "Vault root to operate against."
+                                },
+                                "requestId": {
+                                  "description": "Optional caller-supplied request id for audit correlation.",
+                                  "type": "string",
+                                  "minLength": 1,
+                                  "maxLength": 128
+                                }
+                              }
+                            }
+                          }
+                        },
                         "show-status": {
                           "type": "object",
                           "additionalProperties": false,
@@ -7056,6 +7988,29 @@
                             }
                           }
                         },
+                        "decode": {
+                          "type": "object",
+                          "additionalProperties": false,
+                          "properties": {
+                            "options": {
+                              "type": "object",
+                              "additionalProperties": false,
+                              "properties": {
+                                "vault": {
+                                  "type": "string",
+                                  "minLength": 1,
+                                  "description": "Vault root to operate against."
+                                },
+                                "requestId": {
+                                  "description": "Optional caller-supplied request id for audit correlation.",
+                                  "type": "string",
+                                  "minLength": 1,
+                                  "maxLength": 128
+                                }
+                              }
+                            }
+                          }
+                        },
                         "parse": {
                           "type": "object",
                           "additionalProperties": false,
@@ -7266,9 +8221,9 @@
                                   "description": "Model id to use, such as anthropic/claude-sonnet-4.5 or a local model id."
                                 },
                                 "baseUrl": {
-                                  "description": "Optional OpenAI-compatible base URL for local or custom model endpoints.",
                                   "type": "string",
-                                  "minLength": 1
+                                  "minLength": 1,
+                                  "description": "OpenAI-compatible base URL for local or custom model endpoints."
                                 },
                                 "apiKey": {
                                   "description": "Optional explicit API key for OpenAI-compatible model endpoints.",