npm - forge-openclaw-plugin - Versions diffs - 0.2.68 → 0.2.70 - Mend

forge-openclaw-plugin 0.2.68 → 0.2.70

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (28) hide show

package/dist/assets/{board-DFNV9VAZ.js → board-BfqxFNiQ.js} +1 -1
package/dist/assets/index-BfLQnCNZ.js +91 -0
package/dist/assets/index-DIapFz9v.css +1 -0
package/dist/assets/{motion-CXdn34ih.js → motion-C0ALlgho.js} +1 -1
package/dist/assets/{table-CEq3bTDv.js → table-WcMjnJll.js} +1 -1
package/dist/assets/{ui-g7FaEglG.js → ui-B5I-3U91.js} +1 -1
package/dist/assets/vendor-B-Lq_OG3.css +1 -0
package/dist/assets/vendor-C56o26_3.js +2163 -0
package/dist/index.html +8 -8
package/dist/server/server/migrations/061_health_workout_raw_evidence.sql +95 -0
package/dist/server/server/migrations/062_health_mobile_sync_sessions.sql +55 -0
package/dist/server/server/src/app.js +149 -21
package/dist/server/server/src/health-workout-analytics.js +572 -0
package/dist/server/server/src/health.js +612 -4
package/dist/server/server/src/openapi.js +162 -0
package/dist/server/server/src/psyche-types.js +59 -0
package/dist/server/server/src/services/devrage.js +191 -0
package/dist/server/src/lib/api.js +13 -0
package/openclaw.plugin.json +1 -1
package/package.json +2 -1
package/server/migrations/061_health_workout_raw_evidence.sql +95 -0
package/server/migrations/062_health_mobile_sync_sessions.sql +55 -0
package/skills/forge-openclaw/SKILL.md +35 -6
package/skills/forge-openclaw/entity_conversation_playbooks.md +179 -18
package/dist/assets/index-B0PIKEnz.css +0 -1
package/dist/assets/index-BofyMuFh.js +0 -90
package/dist/assets/vendor-BcOHGipZ.js +0 -1341
package/dist/assets/vendor-DT3pnAKJ.css +0 -1

package/dist/index.html CHANGED Viewed

@@ -13,14 +13,14 @@
     />
     <link rel="icon" type="image/png" href="/forge/assets/favicon-BCHm9dUV.ico" />
     <link rel="alternate icon" href="/forge/assets/favicon-BCHm9dUV.ico" />
-    <script type="module" crossorigin src="/forge/assets/index-BofyMuFh.js"></script>
-    <link rel="modulepreload" crossorigin href="/forge/assets/vendor-BcOHGipZ.js">
-    <link rel="modulepreload" crossorigin href="/forge/assets/board-DFNV9VAZ.js">
-    <link rel="modulepreload" crossorigin href="/forge/assets/ui-g7FaEglG.js">
-    <link rel="modulepreload" crossorigin href="/forge/assets/motion-CXdn34ih.js">
-    <link rel="modulepreload" crossorigin href="/forge/assets/table-CEq3bTDv.js">
-    <link rel="stylesheet" crossorigin href="/forge/assets/vendor-DT3pnAKJ.css">
-    <link rel="stylesheet" crossorigin href="/forge/assets/index-B0PIKEnz.css">
+    <script type="module" crossorigin src="/forge/assets/index-BfLQnCNZ.js"></script>
+    <link rel="modulepreload" crossorigin href="/forge/assets/vendor-C56o26_3.js">
+    <link rel="modulepreload" crossorigin href="/forge/assets/board-BfqxFNiQ.js">
+    <link rel="modulepreload" crossorigin href="/forge/assets/ui-B5I-3U91.js">
+    <link rel="modulepreload" crossorigin href="/forge/assets/motion-C0ALlgho.js">
+    <link rel="modulepreload" crossorigin href="/forge/assets/table-WcMjnJll.js">
+    <link rel="stylesheet" crossorigin href="/forge/assets/vendor-B-Lq_OG3.css">
+    <link rel="stylesheet" crossorigin href="/forge/assets/index-DIapFz9v.css">
   </head>
   <body class="bg-canvas text-ink antialiased">
     <div id="root"></div>

package/dist/server/server/migrations/061_health_workout_raw_evidence.sql ADDED Viewed

@@ -0,0 +1,95 @@
+CREATE TABLE IF NOT EXISTS health_workout_time_series (
+  id TEXT PRIMARY KEY,
+  workout_id TEXT NOT NULL REFERENCES health_workout_sessions(id) ON DELETE CASCADE,
+  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  source_sample_uid TEXT NOT NULL,
+  series_index INTEGER NOT NULL DEFAULT 0,
+  metric_key TEXT NOT NULL,
+  label TEXT NOT NULL DEFAULT '',
+  category TEXT NOT NULL DEFAULT '',
+  unit TEXT NOT NULL DEFAULT '',
+  value REAL NOT NULL,
+  started_at TEXT NOT NULL,
+  ended_at TEXT NOT NULL,
+  source_device TEXT NOT NULL DEFAULT '',
+  source_bundle_identifier TEXT,
+  source_product_type TEXT,
+  capture_method TEXT NOT NULL DEFAULT 'associated_workout',
+  quality_flags_json TEXT NOT NULL DEFAULT '[]',
+  metadata_json TEXT NOT NULL DEFAULT '{}',
+  provenance_json TEXT NOT NULL DEFAULT '{}',
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  UNIQUE (workout_id, metric_key, source_sample_uid, series_index)
+);
+CREATE INDEX IF NOT EXISTS idx_health_workout_time_series_workout_metric
+  ON health_workout_time_series(workout_id, metric_key, started_at);
+CREATE INDEX IF NOT EXISTS idx_health_workout_time_series_user_metric
+  ON health_workout_time_series(user_id, metric_key, started_at DESC);
+CREATE TABLE IF NOT EXISTS health_workout_routes (
+  id TEXT PRIMARY KEY,
+  workout_id TEXT NOT NULL REFERENCES health_workout_sessions(id) ON DELETE CASCADE,
+  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  source_route_uid TEXT NOT NULL,
+  point_index INTEGER NOT NULL,
+  recorded_at TEXT NOT NULL,
+  latitude REAL NOT NULL,
+  longitude REAL NOT NULL,
+  altitude_meters REAL,
+  horizontal_accuracy_meters REAL,
+  vertical_accuracy_meters REAL,
+  speed_mps REAL,
+  course_degrees REAL,
+  metadata_json TEXT NOT NULL DEFAULT '{}',
+  provenance_json TEXT NOT NULL DEFAULT '{}',
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  UNIQUE (workout_id, source_route_uid, point_index)
+);
+CREATE INDEX IF NOT EXISTS idx_health_workout_routes_workout
+  ON health_workout_routes(workout_id, point_index);
+CREATE TABLE IF NOT EXISTS health_zone_profiles (
+  id TEXT PRIMARY KEY,
+  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  model_version TEXT NOT NULL DEFAULT 'forge-hrr-v1',
+  birth_year INTEGER,
+  sex_at_birth TEXT,
+  known_max_hr REAL,
+  threshold_hr REAL,
+  resting_hr_override REAL,
+  custom_zones_json TEXT NOT NULL DEFAULT '[]',
+  inferred_max_hr REAL,
+  inferred_resting_hr REAL,
+  confidence TEXT NOT NULL DEFAULT 'medium',
+  thresholds_json TEXT NOT NULL DEFAULT '[]',
+  metadata_json TEXT NOT NULL DEFAULT '{}',
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  UNIQUE(user_id, model_version)
+);
+CREATE TABLE IF NOT EXISTS health_workout_analytics (
+  id TEXT PRIMARY KEY,
+  workout_id TEXT NOT NULL REFERENCES health_workout_sessions(id) ON DELETE CASCADE,
+  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  zone_profile_id TEXT REFERENCES health_zone_profiles(id) ON DELETE SET NULL,
+  model_version TEXT NOT NULL DEFAULT 'forge-hrr-v1',
+  confidence TEXT NOT NULL DEFAULT 'unavailable',
+  data_quality_json TEXT NOT NULL DEFAULT '{}',
+  zone_durations_json TEXT NOT NULL DEFAULT '[]',
+  hr_summary_json TEXT NOT NULL DEFAULT '{}',
+  load_json TEXT NOT NULL DEFAULT '{}',
+  route_summary_json TEXT NOT NULL DEFAULT '{}',
+  computed_at TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  UNIQUE(workout_id, model_version)
+);
+CREATE INDEX IF NOT EXISTS idx_health_workout_analytics_user
+  ON health_workout_analytics(user_id, computed_at DESC);

package/dist/server/server/migrations/062_health_mobile_sync_sessions.sql ADDED Viewed

@@ -0,0 +1,55 @@
+CREATE TABLE IF NOT EXISTS health_mobile_sync_sessions (
+  id TEXT PRIMARY KEY,
+  pairing_session_id TEXT NOT NULL REFERENCES companion_pairing_sessions(id) ON DELETE CASCADE,
+  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  status TEXT NOT NULL DEFAULT 'running',
+  schema_version TEXT NOT NULL DEFAULT 'healthkit-sync-v2',
+  requested_families_json TEXT NOT NULL DEFAULT '[]',
+  source_metadata_json TEXT NOT NULL DEFAULT '{}',
+  expected_counts_json TEXT NOT NULL DEFAULT '{}',
+  received_counts_json TEXT NOT NULL DEFAULT '{}',
+  byte_totals_json TEXT NOT NULL DEFAULT '{}',
+  affected_workout_ids_json TEXT NOT NULL DEFAULT '[]',
+  error_json TEXT NOT NULL DEFAULT '{}',
+  started_at TEXT NOT NULL,
+  completed_at TEXT,
+  failed_at TEXT,
+  aborted_at TEXT,
+  expired_at TEXT,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_health_mobile_sync_sessions_pairing_status
+  ON health_mobile_sync_sessions(pairing_session_id, status, started_at DESC);
+CREATE TABLE IF NOT EXISTS health_mobile_sync_chunks (
+  id TEXT PRIMARY KEY,
+  sync_session_id TEXT NOT NULL REFERENCES health_mobile_sync_sessions(id) ON DELETE CASCADE,
+  chunk_id TEXT NOT NULL,
+  sequence INTEGER NOT NULL,
+  family TEXT NOT NULL,
+  checksum_sha256 TEXT NOT NULL,
+  record_count INTEGER NOT NULL DEFAULT 0,
+  byte_count INTEGER NOT NULL DEFAULT 0,
+  payload_json TEXT NOT NULL DEFAULT '{}',
+  payload_summary_json TEXT NOT NULL DEFAULT '{}',
+  received_at TEXT NOT NULL,
+  applied_at TEXT,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  UNIQUE(sync_session_id, chunk_id)
+);
+CREATE INDEX IF NOT EXISTS idx_health_mobile_sync_chunks_session_sequence
+  ON health_mobile_sync_chunks(sync_session_id, sequence);
+CREATE TABLE IF NOT EXISTS health_mobile_sync_family_cursors (
+  id TEXT PRIMARY KEY,
+  pairing_session_id TEXT NOT NULL REFERENCES companion_pairing_sessions(id) ON DELETE CASCADE,
+  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  family TEXT NOT NULL,
+  cursor_json TEXT NOT NULL DEFAULT '{}',
+  updated_at TEXT NOT NULL,
+  UNIQUE(pairing_session_id, family)
+);

package/dist/server/server/src/app.js CHANGED Viewed

@@ -46,7 +46,7 @@ import { getInsightsPayload } from "./services/insights.js";
 import { buildLifeForcePayload, createFatigueSignal, listLifeForceTemplates, resolveLifeForceUser, updateLifeForceProfile, updateLifeForceTemplate } from "./services/life-force.js";
 import { createEntities, deleteEntities, deleteEntity, getSettingsBinPayload, restoreEntities, searchEntities, updateEntities } from "./services/entity-crud.js";
 import { getPsycheOverview } from "./services/psyche.js";
-import { syncDevrageMetricHistoryIfNeeded } from "./services/devrage.js";
+import { getPsycheMetricsViewData, syncDevrageMetricHistoryIfNeeded } from "./services/devrage.js";
 import { exportPsycheObservationCalendar, getPsycheObservationCalendar } from "./services/psyche-observation-calendar.js";
 import { getProjectBoard, getProjectSummary, listProjectSummaries } from "./services/projects.js";
 import { createDataBackup, exportData, getDataManagementState, maybeRunAutomaticBackup, restoreDataBackup, scanForDataRecoveryCandidates, switchDataRoot, updateDataManagementSettings } from "./services/data-management.js";
@@ -66,7 +66,7 @@ import { registerWebRoutes } from "./web.js";
 import { createManagerRuntime } from "./managers/runtime.js";
 import { isManagerError } from "./managers/type-guards.js";
 import { buildCompanionPairingTransport, getCompanionIrohStatus, stopCompanionIroh } from "./services/companion-iroh.js";
-import { createCompanionPairingSession, createCompanionPairingSessionSchema, createSleepSession, createSleepSessionSchema, createWorkoutSession, createWorkoutSessionSchema, deleteSleepSession, deleteWorkoutSession, getCompanionPairingSessionById, getCompanionOverview, getFitnessViewData, getSleepSessionById, getSleepSessionDetailById, getSleepTimelineOverlaysForRange, getSleepViewData, getVitalsViewData, getWorkoutSessionById, heartbeatCompanionPairing, heartbeatCompanionPairingSchema, ingestMobileHealthSync, mobileHealthSyncSchema, patchCompanionPairingSourceState, patchCompanionPairingSourceStateSchema, companionSourceKeySchema, requireValidPairing, revokeAllCompanionPairingSessions, revokeAllCompanionPairingSessionsSchema, revokeCompanionPairingSession, updateMobileCompanionSourceState, updateMobileCompanionSourceStateSchema, verifyCompanionPairing, verifyCompanionPairingSchema, updateSleepMetadata, updateSleepMetadataSchema, updateWorkoutMetadata, updateWorkoutMetadataSchema } from "./health.js";
+import { createCompanionPairingSession, createCompanionPairingSessionSchema, createSleepSession, createSleepSessionSchema, createWorkoutSession, createWorkoutSessionSchema, deleteSleepSession, deleteWorkoutSession, getCompanionPairingSessionById, getCompanionOverview, getFitnessViewData, getSleepSessionById, getSleepSessionDetailById, getSleepTimelineOverlaysForRange, getSleepViewData, getVitalsViewData, getHealthZoneProfileForUser, getWorkoutSessionById, getWorkoutSessionDetailById, heartbeatCompanionPairing, heartbeatCompanionPairingSchema, healthZoneProfilePatchSchema, abortMobileHealthSyncSession, completeMobileHealthSyncSession, ingestMobileHealthSync, ingestMobileHealthSyncChunk, mobileHealthSyncChunkSchema, mobileHealthSyncSessionCompleteSchema, mobileHealthSyncSessionStartSchema, mobileHealthSyncSchema, patchHealthZoneProfileForUser, patchCompanionPairingSourceState, patchCompanionPairingSourceStateSchema, companionSourceKeySchema, requireValidPairing, startMobileHealthSyncSession, revokeAllCompanionPairingSessions, revokeAllCompanionPairingSessionsSchema, revokeCompanionPairingSession, updateMobileCompanionSourceState, updateMobileCompanionSourceStateSchema, verifyCompanionPairing, verifyCompanionPairingSchema, updateSleepMetadata, updateSleepMetadataSchema, updateWorkoutMetadata, updateWorkoutMetadataSchema } from "./health.js";
 import { analyzeMovementUserBoxPreflight, createMovementUserBox, createMovementPlace, deleteMovementUserBox, getMovementAllTimeSummary, getMovementBoxDetail, getMovementDayDetail, getMovementMobileBootstrap, getMovementTimeline, getMovementSelectionAggregate, getMovementSettings, getMovementTripDetail, getMovementMonthSummary, invalidateAutomaticMovementBox, listMovementPlaces, movementAutomaticBoxInvalidateSchema, movementMobileBootstrapSchema, movementMobilePlaceMutationSchema, movementMobileStayPatchSchema, movementMobileUserBoxCreateSchema, movementMobileUserBoxPreflightSchema, movementMobileUserBoxPatchSchema, movementMobileAutomaticBoxInvalidateSchema, movementMobileTimelineSchema, movementPlaceMutationSchema, movementPlacePatchSchema, movementSelectionAggregateSchema, movementStayPatchSchema, movementTripPatchSchema, movementUserBoxCreateSchema, movementUserBoxPreflightSchema, movementUserBoxPatchSchema, movementSettingsPatchSchema, movementTimelineQuerySchema, movementTripPointPatchSchema, deleteMovementStay, deleteMovementTrip, deleteMovementTripPoint, updateMovementPlace, updateMovementSettings, updateMovementStay, updateMovementTrip, updateMovementUserBox, updateMovementTripPoint, resolveMovementTimelineSegmentForBox } from "./movement.js";
 import { getScreenTimeAllTimeSummary, getScreenTimeDayDetail, getScreenTimeMonthSummary, getScreenTimeSettings, screenTimeSettingsPatchSchema, updateScreenTimeSettings } from "./screen-time.js";
 import { assertWatchReady, buildWatchBootstrap, ingestWatchCaptureBatch, mobileWatchBootstrapSchema, mobileWatchCaptureBatchSchema, mobileWatchHabitCheckInSchema } from "./watch-mobile.js";
@@ -1988,7 +1988,7 @@ function buildPreferredMutationPath(entityType) {
         case "life_force":
             return "Use the dedicated Life Force route family for overview, profile edits, weekday templates, and fatigue signals.";
         case "workbench":
-            return "Use the dedicated Workbench route family for flow CRUD, execution, run history, published outputs, node results, and latest-node-output reads.";
+            return "Use the dedicated Workbench route family for flow CRUD, execution, saved-flow chat follow-ups, run history, published outputs, node results, and latest-node-output reads.";
         case "self_observation":
             return "Read the calendar surface; mutate it by creating or updating note-backed observations with frontmatter.observedAt.";
         case "sleep_overview":
@@ -2701,7 +2701,7 @@ const AGENT_ONBOARDING_ENTITY_CATALOG = [
     }),
     enrichOnboardingEntityGuide({
         entityType: "movement",
-        purpose: "The specialized Movement surface for day, month, all-time, timeline, trip, place, selection, and manual overlay work.",
+        purpose: "The specialized Movement surface for day, month, all-time, timeline, trip, place, selection, settings, and manual overlay work.",
         minimumCreateFields: [],
         relationshipRules: [
             "Movement is a specialized domain surface, not a normal batch CRUD entity family.",
@@ -2731,7 +2731,7 @@ const AGENT_ONBOARDING_ENTITY_CATALOG = [
     }),
     enrichOnboardingEntityGuide({
         entityType: "workbench",
-        purpose: "The specialized Workbench surface for flow catalog work, flow CRUD, execution, run history, published outputs, node results, and latest-node-output reads.",
+        purpose: "The specialized Workbench surface for flow catalog work, flow CRUD, execution, saved-flow chat follow-ups, run history, published outputs, node results, and latest-node-output reads.",
         minimumCreateFields: [],
         relationshipRules: [
             "Workbench is a specialized execution surface, not a normal batch CRUD entity family.",
@@ -2969,6 +2969,18 @@ const AGENT_ONBOARDING_ENTITY_CONVERSATION_PLAYBOOKS = [
             "Ask about source or override reason only when that context matters."
         ]
     },
+    {
+        focus: "calendar_overview",
+        openingQuestion: "What are you trying to understand or decide from your calendar picture?",
+        coachingGoal: "Review commitments, work blocks, provider state, and existing timeboxes before creating or changing calendar records.",
+        askSequence: [
+            "Ask what practical calendar question the user wants the overview to answer.",
+            "Ask which day, week, date range, or owner scope matters only if it changes the read.",
+            "Use forge_get_calendar_overview before asking the user to reconstruct availability from memory.",
+            "Reflect the scheduling or planning decision the user is trying to make.",
+            "Move to calendar_event, work_block_template, task_timebox, or calendar_connection only when one concrete follow-up action is visible."
+        ]
+    },
     {
         focus: "calendar_connection",
         openingQuestion: "Which calendar provider are you trying to connect, and what do you want Forge to do with it?",
@@ -3004,6 +3016,29 @@ const AGENT_ONBOARDING_ENTITY_CONVERSATION_PLAYBOOKS = [
             "Ask for a short audit note only if the reason would otherwise be unclear later."
         ]
     },
+    {
+        focus: "operator_overview",
+        openingQuestion: "What are you trying to understand about Forge overall right now?",
+        coachingGoal: "Read the broad Forge state before choosing a specific entity action.",
+        askSequence: [
+            "Ask what broad Forge question the user wants the overview to answer.",
+            "Ask which owner or user scope matters only if several humans or bots are in play.",
+            "Use forge_get_operator_overview before reopening a create or update intake.",
+            "Reflect the attention cue, priority, or handoff decision the overview should support.",
+            "Move into a specific entity flow only when the overview points to a concrete goal, project, task, habit, note, Psyche record, or action."
+        ]
+    },
+    {
+        focus: "operator_context",
+        openingQuestion: "What current work, risk, or next move are you trying to check?",
+        coachingGoal: "Inspect current work, active runs, risk, and next moves before changing records.",
+        askSequence: [
+            "Ask whether the user is checking current work, risk, blockers, active sessions, or the next move.",
+            "Use forge_get_operator_context before mutating tasks, projects, runs, or notes when the current state is uncertain.",
+            "Reflect whether the read is meant to decide continue, stop, reprioritize, update, or create.",
+            "Move to task_run, work_adjustment, task, project, or note flow only when one concrete follow-up is visible."
+        ]
+    },
     {
         focus: "self_observation",
         openingQuestion: "What happened in the situation, and what did you feel, think, or do next?",
@@ -3175,7 +3210,9 @@ const AGENT_ONBOARDING_ENTITY_CONVERSATION_PLAYBOOKS = [
             "Ask whether the focus is a stay, a trip, a place, a timeline window, or a selected span.",
             "Ask for the time window, place, or movement item that makes the question concrete.",
             "Ask what they are trying to notice, preserve, or answer through that movement context.",
+            "If the user is changing movement operating behavior, ask whether this is about passive tracking, publish mode, retention, or companion readiness.",
             "Choose the dedicated day, month, all-time, timeline, places, trip-detail, or selection route once the question shape is clear.",
+            "Use the dedicated settings route for passive capture, publish mode, and retention behavior instead of treating those as place, stay, or trip edits.",
             "Use allTime for whole-history aggregates, selection for a bounded selected-span aggregate, and tripDetail only when a concrete trip id is known.",
             "If the truth of one uncertain span is still unclear, read the timeline or saved-box detail before you mutate it.",
             "Skip the meta lane question when the user already named the exact correction or review target and only one ambiguity remains.",
@@ -3216,6 +3253,9 @@ const AGENT_ONBOARDING_ENTITY_CONVERSATION_PLAYBOOKS = [
             "Use listFlows for the saved flow catalog and boxCatalog for available input-box contracts; do not collapse both into a vague catalog read.",
             "Ask which flow, slug, run, or node the request is about.",
             "Ask whether they need the stable flow contract, one run result, one published output, one node result, or the latest node output.",
+            "If the user is creating or editing a flow, clarify what the flow should reliably produce, what input contract it should accept, and what smallest structural change is intended before asking for node details.",
+            "If the user wants to delete or archive a flow, confirm the saved flow and whether published outputs or run history need to be preserved elsewhere before calling the delete route.",
+            "If the user wants to send a follow-up into a saved flow chat, confirm the saved flow and what the message should accomplish instead of treating it as a new run or note.",
             "If the user already named the flow and action clearly, skip the meta lane question and ask only for the missing run, node, or output scope.",
             "If the user wants a stable public input contract or published output, prefer those dedicated reads instead of detouring through run history first.",
             "If the user is still shaping a payload or edit, prefer flow detail or box catalog reads before asking for structured inputs.",
@@ -4378,8 +4418,9 @@ function buildAgentOnboardingPayload(request) {
                     aliases: ["movement", "Movement"],
                     summary: "Dedicated movement workspace API. Use these routes for stays, trips, time-in-place questions, visited places, trip detail, selection aggregates, user-defined overlays, and repair actions on already-recorded movement data.",
                     routeSelectionQuestions: [
-                        "Is the user asking for a day, month, all-time, timeline, place, trip detail, or selected-span answer?",
+                        "Is the user asking for a day, month, all-time, timeline, place, trip detail, selected-span, or settings answer?",
                         "Is this a missing-gap overlay, a saved-overlay repair, or an edit to one already-recorded stay, trip, or trip point?",
+                        "If this is about operating behavior, is the change about passive tracking, publish mode, retention, or companion readiness?",
                         "If the target is already known, what one time, place, or saved-object detail is still missing before acting?"
                     ],
                     methodRoutes: {
@@ -4438,6 +4479,7 @@ function buildAgentOnboardingPayload(request) {
                         "Movement is not a normal batch CRUD entity family. It is a dedicated record of stays and trips: a stay means the user remained in the same place for a span of time, and a trip means they traveled between places.",
                         "Route-selection questions are internal. User-facing questions should ask for the useful time window, place, selected span, stay, or trip instead of reciting day/month/all-time/timeline/selection route keys.",
                         "Use /api/v1/movement/day, /month, /all-time, /timeline, or /selection when the user wants behavioral answers such as how long they stayed at home, when they traveled, which places dominated a period, or what happened across a selected span.",
+                        "Use GET /api/v1/movement/settings and PATCH /api/v1/movement/settings when the user wants to inspect or change passive capture, publish mode, retention mode, or companion readiness. Do not route settings changes through stays, trips, places, or batch CRUD.",
                         "Use the movement write routes when the user wants to add a place or manual overlay, update a specific stay or trip, repair one recorded movement span, or attach movement context to another Forge record. If the user is filling a missing-data gap, the usual write path is a user-defined overlay box rather than a raw stay or trip patch.",
                         "If the user is revising or removing an existing correction, first identify whether the saved object is a user-defined box, automatic box, recorded stay, recorded trip, or trip point so the repair or delete path stays truthful.",
                         "For an explicit statement like 'that missing block was me staying home', do not reopen broad intake. Preflight only if timing overlap is unclear, then create a user-defined `stay` box for that interval and read the updated timeline back."
@@ -4515,8 +4557,10 @@ function buildAgentOnboardingPayload(request) {
                     aliases: ["workbench", "Workbench"],
                     summary: "Dedicated graph-flow API. Use it for flow catalog reads, flow CRUD, execution, run history, published outputs, node results, and latest successful node outputs.",
                     routeSelectionQuestions: [
-                        "Is the job flow discovery, flow editing, execution, run history, published output, run detail, node result, latest node output, or flow chat follow-up?",
+                        "Is the job flow discovery, flow creation, flow editing, flow deletion, execution, run history, published output, run detail, node result, latest node output, or flow chat follow-up?",
                         "Does the user need a stable public contract or one execution artifact?",
+                        "For flow CRUD, what stable input contract, expected output, or lifecycle effect must stay true?",
+                        "For flow chat follow-up, which saved flow should receive the message and what should the message accomplish?",
                         "If the flow is already known, what one run, node, or output scope detail is still missing before acting?"
                     ],
                     methodRoutes: {
@@ -4562,6 +4606,10 @@ function buildAgentOnboardingPayload(request) {
                         "Route-selection questions are internal. User-facing questions should ask whether the user needs the saved flow, its input contract, one run, one node, or the public result instead of reciting Workbench route keys.",
                         "Use the flow routes when the agent needs stable public input contracts, published outputs, node-level results, or reusable execution history.",
                         "If the user is still figuring out inputs or editable structure, read flow detail or box catalog before asking them to author a payload from memory.",
+                        "For flow creation, clarify what the flow should reliably produce, which input contract it should accept, and which first node or box anchors the flow before asking for structured payload details.",
+                        "For flow edits, ask what behavior should change while preserving the public contract unless the user explicitly wants the contract changed.",
+                        "For flow deletion, confirm the saved flow and whether published outputs or run history need preservation elsewhere before using the delete route.",
+                        "For saved flow chat follow-ups, use POST /api/v1/workbench/flows/:id/chat only when the user wants to continue a flow-specific conversation. Do not turn that into a new run, note, or generic entity update unless the user asks.",
                         "Prefer the dedicated output and node-result routes over reverse-engineering raw traces.",
                         "If the user only wants a published output, latest node output, or run detail, do not reopen a flow-edit intake before reading that artifact.",
                         "If the user already named the flow and wants one output or one run, skip the broad lane question and ask only for the missing run, node, or output scope."
@@ -4579,7 +4627,8 @@ function buildAgentOnboardingPayload(request) {
                 calendar_overview: "/api/v1/calendar/overview",
                 operatorOverview: "/api/v1/operator/overview",
                 operator_overview: "/api/v1/operator/overview",
-                operatorContext: "/api/v1/operator/context"
+                operatorContext: "/api/v1/operator/context",
+                operator_context: "/api/v1/operator/context"
             }
         },
         multiUserModel: {
@@ -4825,6 +4874,8 @@ function buildAgentOnboardingPayload(request) {
                 movementTimeline: '{"routeKey":"timeline","query":{"from":"2026-05-01T00:00:00.000Z","to":"2026-05-06T23:59:59.999Z","userIds":["user_operator"]}}',
                 movementSelection: '{"routeKey":"selection","query":{"from":"2026-05-01T00:00:00.000Z","to":"2026-05-14T23:59:59.999Z","placeIds":["place_home"],"userIds":["user_operator"]}}',
                 movementTripDetail: '{"routeKey":"tripDetail","pathParams":{"id":"trip_123"}}',
+                movementSettings: '{"routeKey":"settings","query":{"userIds":["user_operator"]}}',
+                movementSettingsUpdate: '{"routeKey":"settingsUpdate","body":{"trackingEnabled":true,"publishMode":"draft_review","retentionMode":"aggregates_only"}}',
                 movementMissingStayPreflight: '{"routeKey":"userBoxPreflight","body":{"kind":"stay","startedAt":"2026-05-06T13:00:00.000Z","endedAt":"2026-05-06T15:00:00.000Z","placeLabel":"Home","userId":"user_operator"}}',
                 movementMissingStayCreate: '{"routeKey":"userBoxCreate","body":{"kind":"stay","startedAt":"2026-05-06T13:00:00.000Z","endedAt":"2026-05-06T15:00:00.000Z","placeLabel":"Home","userId":"user_operator","note":"Manual correction after reviewing the timeline."}}',
                 lifeForceOverview: '{"routeKey":"overview"}',
@@ -4833,10 +4884,14 @@ function buildAgentOnboardingPayload(request) {
                 lifeForceFatigueSignal: '{"routeKey":"fatigueSignal","body":{"signal":"tired","intensity":7,"note":"Sharp post-lunch dip after clinic admin."}}',
                 workbenchFlowCatalog: '{"routeKey":"listFlows","query":{"includeArchived":false}}',
                 workbenchBoxCatalog: '{"routeKey":"boxCatalog"}',
+                workbenchCreateFlow: '{"routeKey":"createFlow","body":{"title":"Research digest","slug":"research-digest","description":"Turn a topic into a cited digest with a stable published summary.","nodes":[],"edges":[]}}',
+                workbenchUpdateFlow: '{"routeKey":"updateFlow","pathParams":{"id":"flow_research_digest"},"body":{"description":"Keep the same input contract but add a stronger evidence-check node."}}',
+                workbenchDeleteFlow: '{"routeKey":"deleteFlow","pathParams":{"id":"flow_research_digest"}}',
                 workbenchRunDetail: '{"routeKey":"runDetail","pathParams":{"id":"flow_research_digest","runId":"run_123"}}',
                 workbenchPublishedOutput: '{"routeKey":"publishedOutput","pathParams":{"id":"flow_research_digest"}}',
                 workbenchLatestNodeOutput: '{"routeKey":"latestNodeOutput","pathParams":{"id":"flow_research_digest","nodeId":"node_summary"}}',
-                workbenchRunFlow: '{"routeKey":"runFlow","pathParams":{"id":"flow_research_digest"},"body":{"input":{"topic":"question flow quality"}}}'
+                workbenchRunFlow: '{"routeKey":"runFlow","pathParams":{"id":"flow_research_digest"},"body":{"input":{"topic":"question flow quality"}}}',
+                workbenchChatFlow: '{"routeKey":"chatFlow","pathParams":{"id":"flow_research_digest"},"body":{"message":"Refine the summary around API route risks and keep the published output stable."}}'
             }
         }
     };
@@ -5398,6 +5453,12 @@ function buildOperatorOverviewRouteGuide() {
                 summary: "Aggregate Psyche state across values, patterns, behaviors, beliefs, modes, and trigger reports.",
                 requiredScope: "psyche.read"
             },
+            {
+                id: "psyche_metrics",
+                path: "/api/v1/psyche/metrics",
+                summary: "Daily Psyche metric read model with stored devrage history and summary statistics.",
+                requiredScope: "psyche.read"
+            },
             {
                 id: "xp_metrics",
                 path: "/api/v1/metrics/xp",
@@ -6330,6 +6391,8 @@ export async function buildServer(options = {}) {
     app.setErrorHandler((error, request, reply) => {
         const validationIssues = error instanceof ZodError ? formatValidationIssues(error) : undefined;
         const routeUrl = request.routeOptions.url || request.url;
+        const isBodyTooLarge = typeof error.code === "string" &&
+            error.code === "FST_ERR_CTP_BODY_TOO_LARGE";
         const validationHelp = validationIssues
             ? buildValidationHelp(request.method, routeUrl, validationIssues)
             : undefined;
@@ -6339,20 +6402,24 @@ export async function buildServer(options = {}) {
                 ? error.statusCode
                 : error instanceof ZodError
                     ? 400
-                    : 500;
+                    : isBodyTooLarge
+                        ? 413
+                        : 500;
         if (!shouldSkipAutomaticDiagnosticRoute(routeUrl)) {
             try {
                 recordDiagnosticLog({
                     level: statusCode >= 500 ? "error" : "warning",
                     source: normalizeDiagnosticSource(request.headers["x-forge-source"]),
                     scope: "api_error",
-                    eventKey: isHttpError(error)
-                        ? error.code
-                        : isManagerError(error)
+                    eventKey: isBodyTooLarge
+                        ? "payload_too_large"
+                        : isHttpError(error)
                             ? error.code
-                            : statusCode === 400
-                                ? "invalid_request"
-                                : "internal_error",
+                            : isManagerError(error)
+                                ? error.code
+                                : statusCode === 400
+                                    ? "invalid_request"
+                                    : "internal_error",
                     message: getErrorMessage(error),
                     route: routeUrl,
                     functionName: "setErrorHandler",
@@ -6376,13 +6443,25 @@ export async function buildServer(options = {}) {
                 ? error.code
                 : isManagerError(error)
                     ? error.code
-                    : statusCode === 400
-                        ? "invalid_request"
-                        : "internal_error",
+                    : isBodyTooLarge
+                        ? "payload_too_large"
+                        : statusCode === 400
+                            ? "invalid_request"
+                            : "internal_error",
             error: validationIssues
                 ? `Request validation failed for ${request.method.toUpperCase()} ${routeUrl}. ${validationHelp?.validationSummary ?? ""}`.trim()
-                : getErrorMessage(error),
+                : isBodyTooLarge
+                    ? "The request body is too large. Use chunked HealthKit sync."
+                    : getErrorMessage(error),
             statusCode,
+            ...(isBodyTooLarge
+                ? {
+                    recommendedMode: "chunked",
+                    maxBytes: typeof request.routeOptions.bodyLimit === "number"
+                        ? request.routeOptions.bodyLimit
+                        : undefined
+                }
+                : {}),
             ...(validationIssues ? { details: validationIssues } : {}),
             ...(validationHelp ?? {}),
             ...(isHttpError(error) && error.details ? error.details : {}),
@@ -6772,12 +6851,37 @@ export async function buildServer(options = {}) {
     app.get("/api/v1/health/vitals", async (request) => ({
         vitals: getVitalsViewData(resolveScopedUserIds(request.query))
     }));
+    app.get("/api/v1/health/zone-profile", async (request) => {
+        const userIds = resolveScopedUserIds(request.query);
+        return {
+            zoneProfile: getHealthZoneProfileForUser(userIds?.[0] ?? "user_operator")
+        };
+    });
+    app.patch("/api/v1/health/zone-profile", async (request) => {
+        const auth = requireScopedAccess(request.headers, ["write"], { route: "/api/v1/health/zone-profile" });
+        const userIds = resolveScopedUserIds(request.query);
+        void auth;
+        return {
+            zoneProfile: patchHealthZoneProfileForUser(userIds?.[0] ?? "user_operator", healthZoneProfilePatchSchema.parse(request.body ?? {}))
+        };
+    });
     app.post("/api/v1/health/workouts", async (request, reply) => {
         const auth = requireScopedAccess(request.headers, ["write"], { route: "/api/v1/health/workouts" });
         const workout = createWorkoutSession(createWorkoutSessionSchema.parse(request.body ?? {}), toActivityContext(auth));
         reply.code(201);
         return { workout };
     });
+    app.get("/api/v1/health/workouts/:id/detail", async (request, reply) => {
+        const { id } = request.params;
+        const query = request.query;
+        const resolution = query.resolution === "raw" ? "raw" : "adaptive";
+        const detail = getWorkoutSessionDetailById(id, resolution);
+        if (!detail) {
+            reply.code(404);
+            return { error: "Workout session not found" };
+        }
+        return detail;
+    });
     app.get("/api/v1/health/workouts/:id", async (request, reply) => {
         const { id } = request.params;
         const workout = getWorkoutSessionById(id);
@@ -7293,7 +7397,27 @@ export async function buildServer(options = {}) {
             watch: buildWatchBootstrap(pairing)
         };
     });
-    app.post("/api/v1/mobile/healthkit/sync", async (request) => ({
+    app.post("/api/v1/mobile/healthkit/sync-sessions", async (request) => ({
+        upload: startMobileHealthSyncSession(mobileHealthSyncSessionStartSchema.parse(request.body ?? {}))
+    }));
+    app.post("/api/v1/mobile/healthkit/sync-sessions/:id/chunks", { bodyLimit: 1_250_000 }, async (request) => {
+        const { id } = request.params;
+        const rawPayloadJson = JSON.stringify((request.body ?? {}).payload ?? {});
+        return {
+            chunk: ingestMobileHealthSyncChunk(id, mobileHealthSyncChunkSchema.parse(request.body ?? {}), rawPayloadJson)
+        };
+    });
+    app.post("/api/v1/mobile/healthkit/sync-sessions/:id/complete", async (request) => {
+        const { id } = request.params;
+        return {
+            sync: completeMobileHealthSyncSession(id, mobileHealthSyncSessionCompleteSchema.parse(request.body ?? {}))
+        };
+    });
+    app.delete("/api/v1/mobile/healthkit/sync-sessions/:id", async (request) => {
+        const { id } = request.params;
+        return { upload: abortMobileHealthSyncSession(id) };
+    });
+    app.post("/api/v1/mobile/healthkit/sync", { bodyLimit: 8_000_000 }, async (request) => ({
         sync: ingestMobileHealthSync(mobileHealthSyncSchema.parse(request.body ?? {}))
     }));
     app.patch("/api/v1/health/workouts/:id", async (request, reply) => {
@@ -7365,6 +7489,10 @@ export async function buildServer(options = {}) {
         const userIds = resolveScopedUserIds(request.query);
         return { overview: getPsycheOverview(userIds) };
     });
+    app.get("/api/v1/psyche/metrics", async (request) => {
+        requirePsycheScopedAccess(request.headers, ["psyche.read"], { route: "/api/v1/psyche/metrics" });
+        return { metrics: getPsycheMetricsViewData() };
+    });
     app.get("/api/v1/psyche/questionnaires", async (request) => {
         requirePsycheScopedAccess(request.headers, ["psyche.read"], { route: "/api/v1/psyche/questionnaires" });
         const userIds = resolveScopedUserIds(request.query);