npm - forge-openclaw-plugin - Versions diffs - 0.2.67 → 0.2.69 - Mend

forge-openclaw-plugin 0.2.67 → 0.2.69

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 (29) 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/060_psyche_devrage_metrics.sql +40 -0
package/dist/server/server/migrations/061_health_workout_raw_evidence.sql +95 -0
package/dist/server/server/src/app.js +94 -12
package/dist/server/server/src/health-workout-analytics.js +572 -0
package/dist/server/server/src/health.js +116 -3
package/dist/server/server/src/openapi.js +238 -0
package/dist/server/server/src/psyche-types.js +90 -0
package/dist/server/server/src/services/devrage.js +412 -0
package/dist/server/server/src/services/psyche.js +3 -0
package/dist/server/src/lib/api.js +13 -0
package/openclaw.plugin.json +1 -1
package/package.json +1 -1
package/server/migrations/060_psyche_devrage_metrics.sql +40 -0
package/server/migrations/061_health_workout_raw_evidence.sql +95 -0
package/skills/forge-openclaw/SKILL.md +25 -1
package/skills/forge-openclaw/entity_conversation_playbooks.md +46 -14
package/dist/assets/index-B9IVt8VN.js +0 -90
package/dist/assets/index-DJlo9Tsp.css +0 -1
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-B9IVt8VN.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-DJlo9Tsp.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/060_psyche_devrage_metrics.sql ADDED Viewed

@@ -0,0 +1,40 @@
+CREATE TABLE IF NOT EXISTS psyche_devrage_conversation_measures (
+  id TEXT PRIMARY KEY,
+  source TEXT NOT NULL,
+  conversation_id TEXT NOT NULL,
+  date_key TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  messages INTEGER NOT NULL DEFAULT 0,
+  messages_with_swears INTEGER NOT NULL DEFAULT 0,
+  swear_count INTEGER NOT NULL DEFAULT 0,
+  scanned_at TEXT NOT NULL,
+  UNIQUE (source, conversation_id, date_key)
+);
+CREATE INDEX IF NOT EXISTS psyche_devrage_conversation_measures_date_idx
+  ON psyche_devrage_conversation_measures (date_key DESC);
+CREATE INDEX IF NOT EXISTS psyche_devrage_conversation_measures_updated_idx
+  ON psyche_devrage_conversation_measures (updated_at DESC);
+CREATE TABLE IF NOT EXISTS psyche_devrage_metric_measures (
+  id TEXT PRIMARY KEY,
+  date_key TEXT NOT NULL,
+  metric_key TEXT NOT NULL,
+  value REAL NOT NULL,
+  unit TEXT NOT NULL DEFAULT '',
+  sample_count INTEGER NOT NULL DEFAULT 0,
+  computed_at TEXT NOT NULL,
+  UNIQUE (date_key, metric_key)
+);
+CREATE INDEX IF NOT EXISTS psyche_devrage_metric_measures_metric_date_idx
+  ON psyche_devrage_metric_measures (metric_key, date_key DESC);
+CREATE TABLE IF NOT EXISTS psyche_devrage_sync_state (
+  id TEXT PRIMARY KEY CHECK (id = 'default'),
+  full_sync_completed_at TEXT,
+  last_daily_sync_at TEXT,
+  last_synced_date_key TEXT,
+  updated_at TEXT NOT NULL
+);

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/src/app.js CHANGED Viewed

@@ -46,6 +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 { 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";
@@ -65,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, ingestMobileHealthSync, mobileHealthSyncSchema, patchHealthZoneProfileForUser, patchCompanionPairingSourceState, patchCompanionPairingSourceStateSchema, companionSourceKeySchema, requireValidPairing, 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";
@@ -1957,14 +1958,15 @@ function classifyOnboardingEntity(entityType) {
         entityType === "questionnaire_run" ||
         entityType === "preference_judgment" ||
         entityType === "preference_signal" ||
-        entityType === "work_adjustment") {
+        entityType === "work_adjustment" ||
+        entityType === "self_observation") {
         return "action_workflow_entity";
     }
     return "read_model_only_surface";
 }
 function buildPreferredMutationPath(entityType) {
     if (entityType in AGENT_ONBOARDING_BATCH_ROUTE_BASES) {
-        return "/api/v1/entities/create | /api/v1/entities/update | /api/v1/entities/delete | /api/v1/entities/search";
+        return "/api/v1/entities/create | /api/v1/entities/update | /api/v1/entities/delete | /api/v1/entities/restore | /api/v1/entities/search";
     }
     switch (entityType) {
         case "wiki_page":
@@ -1986,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":
@@ -1998,6 +2000,12 @@ function buildPreferredMutationPath(entityType) {
     }
 }
 function buildPreferredMutationTool(entityType) {
+    if (entityType === "sleep_session") {
+        return "forge_create_entities | forge_update_entities | forge_delete_entities | forge_search_entities | forge_update_sleep_session for reflective enrichment after review";
+    }
+    if (entityType === "workout_session") {
+        return "forge_create_entities | forge_update_entities | forge_delete_entities | forge_search_entities | forge_update_workout_session for reflective enrichment after review";
+    }
     if (entityType in AGENT_ONBOARDING_BATCH_ROUTE_BASES) {
         return "forge_create_entities | forge_update_entities | forge_delete_entities | forge_search_entities";
     }
@@ -2016,6 +2024,8 @@ function buildPreferredMutationTool(entityType) {
             return "forge_submit_preferences_signal";
         case "work_adjustment":
             return "forge_adjust_work_minutes";
+        case "self_observation":
+            return "forge_get_self_observation_calendar | forge_create_entities | forge_update_entities";
         case "movement":
             return "forge_call_movement_route";
         case "life_force":
@@ -2691,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.",
@@ -2721,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.",
@@ -3165,7 +3175,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.",
@@ -3206,6 +3218,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.",
@@ -3417,10 +3432,11 @@ const AGENT_ONBOARDING_PSYCHE_PLAYBOOKS = [
         coachingGoal: "Help the user describe how the mode shows up, what it is trying to do, what it fears, and what burden it carries, rather than reducing it to a label only.",
         askSequence: [
             "Start with a recent moment when this part-state took over.",
-            "Choose the mode family once the lived description is clearer.",
-            "Name the mode in the user's language.",
             "Describe the felt persona, body posture, imagery, or symbolic form.",
-            "Clarify its fear, burden, and protective job.",
+            "Clarify what it is trying to protect, prevent, control, or force.",
+            "Clarify its fear, burden, and protective job before choosing a family label.",
+            "Offer one candidate name or formulation in the user's language and invite correction.",
+            "Choose the mode family only after the lived description, protective job, fear, or burden is visible enough.",
             "Explore when it first became necessary or familiar.",
             "Notice linked patterns, behaviors, values, and what a healthy-adult response would need to do."
         ],
@@ -4367,8 +4383,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: {
@@ -4427,6 +4444,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."
@@ -4504,8 +4522,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: {
@@ -4551,6 +4571,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."
@@ -4814,6 +4838,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"}',
@@ -4822,10 +4848,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."}}'
             }
         }
     };
@@ -5387,6 +5417,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",
@@ -6221,10 +6257,27 @@ export async function buildServer(options = {}) {
     void maybeRunAutomaticBackup().catch(() => {
         // Ignore startup backup failures; the Data settings surface exposes recovery.
     });
+    const devrageMetricSyncEnabled = options.devrageMetricSync ?? !options.dataRoot;
+    const devrageMetricTimer = devrageMetricSyncEnabled
+        ? setInterval(() => {
+            void syncDevrageMetricHistoryIfNeeded().catch(() => {
+                // Devrage is a local metric import; failures should not break Forge.
+            });
+        }, 60 * 60 * 1000)
+        : null;
+    devrageMetricTimer?.unref?.();
+    if (devrageMetricSyncEnabled) {
+        void syncDevrageMetricHistoryIfNeeded().catch(() => {
+            // The Psyche metric payload exposes an empty state until sync succeeds.
+        });
+    }
     app.addHook("onClose", async () => {
         clearInterval(diagnosticRetentionTimer);
         clearInterval(cronSchedulerTimer);
         clearInterval(dataBackupTimer);
+        if (devrageMetricTimer) {
+            clearInterval(devrageMetricTimer);
+        }
         taskRunWatchdog?.stop();
         await stopCompanionIroh();
         await managers.backgroundJobs.stop();
@@ -6744,12 +6797,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);
@@ -7337,6 +7415,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);