forge-openclaw-plugin 0.2.91 → 0.2.93

package/dist/server/server/migrations/064_health_workout_time_series_identity.sql

@@ -0,0 +1,161 @@
+CREATE TEMP TABLE health_workout_time_series_dedupe AS
+SELECT
+  workout_id,
+  metric_key,
+  source_sample_uid,
+  MIN(rowid) AS survivor_rowid,
+  (
+    SELECT latest.rowid
+    FROM health_workout_time_series AS latest
+    WHERE latest.workout_id = grouped.workout_id
+      AND latest.metric_key = grouped.metric_key
+      AND latest.source_sample_uid = grouped.source_sample_uid
+    ORDER BY latest.updated_at DESC, latest.created_at DESC, latest.rowid DESC
+    LIMIT 1
+  ) AS latest_rowid,
+  (
+    SELECT latest.series_index
+    FROM health_workout_time_series AS latest
+    WHERE latest.workout_id = grouped.workout_id
+      AND latest.metric_key = grouped.metric_key
+      AND latest.source_sample_uid = grouped.source_sample_uid
+    ORDER BY latest.updated_at DESC, latest.created_at DESC, latest.rowid DESC
+    LIMIT 1
+  ) AS latest_series_index
+FROM health_workout_time_series AS grouped
+WHERE source_sample_uid IS NOT NULL
+  AND source_sample_uid != ''
+GROUP BY workout_id, metric_key, source_sample_uid
+HAVING COUNT(*) > 1;
+
+UPDATE health_workout_time_series
+SET
+  label = (
+    SELECT latest.label
+    FROM health_workout_time_series AS latest
+    JOIN health_workout_time_series_dedupe AS dedupe
+      ON dedupe.latest_rowid = latest.rowid
+    WHERE dedupe.survivor_rowid = health_workout_time_series.rowid
+  ),
+  category = (
+    SELECT latest.category
+    FROM health_workout_time_series AS latest
+    JOIN health_workout_time_series_dedupe AS dedupe
+      ON dedupe.latest_rowid = latest.rowid
+    WHERE dedupe.survivor_rowid = health_workout_time_series.rowid
+  ),
+  unit = (
+    SELECT latest.unit
+    FROM health_workout_time_series AS latest
+    JOIN health_workout_time_series_dedupe AS dedupe
+      ON dedupe.latest_rowid = latest.rowid
+    WHERE dedupe.survivor_rowid = health_workout_time_series.rowid
+  ),
+  value = (
+    SELECT latest.value
+    FROM health_workout_time_series AS latest
+    JOIN health_workout_time_series_dedupe AS dedupe
+      ON dedupe.latest_rowid = latest.rowid
+    WHERE dedupe.survivor_rowid = health_workout_time_series.rowid
+  ),
+  started_at = (
+    SELECT latest.started_at
+    FROM health_workout_time_series AS latest
+    JOIN health_workout_time_series_dedupe AS dedupe
+      ON dedupe.latest_rowid = latest.rowid
+    WHERE dedupe.survivor_rowid = health_workout_time_series.rowid
+  ),
+  ended_at = (
+    SELECT latest.ended_at
+    FROM health_workout_time_series AS latest
+    JOIN health_workout_time_series_dedupe AS dedupe
+      ON dedupe.latest_rowid = latest.rowid
+    WHERE dedupe.survivor_rowid = health_workout_time_series.rowid
+  ),
+  source_device = (
+    SELECT latest.source_device
+    FROM health_workout_time_series AS latest
+    JOIN health_workout_time_series_dedupe AS dedupe
+      ON dedupe.latest_rowid = latest.rowid
+    WHERE dedupe.survivor_rowid = health_workout_time_series.rowid
+  ),
+  source_bundle_identifier = (
+    SELECT latest.source_bundle_identifier
+    FROM health_workout_time_series AS latest
+    JOIN health_workout_time_series_dedupe AS dedupe
+      ON dedupe.latest_rowid = latest.rowid
+    WHERE dedupe.survivor_rowid = health_workout_time_series.rowid
+  ),
+  source_product_type = (
+    SELECT latest.source_product_type
+    FROM health_workout_time_series AS latest
+    JOIN health_workout_time_series_dedupe AS dedupe
+      ON dedupe.latest_rowid = latest.rowid
+    WHERE dedupe.survivor_rowid = health_workout_time_series.rowid
+  ),
+  capture_method = (
+    SELECT latest.capture_method
+    FROM health_workout_time_series AS latest
+    JOIN health_workout_time_series_dedupe AS dedupe
+      ON dedupe.latest_rowid = latest.rowid
+    WHERE dedupe.survivor_rowid = health_workout_time_series.rowid
+  ),
+  quality_flags_json = (
+    SELECT latest.quality_flags_json
+    FROM health_workout_time_series AS latest
+    JOIN health_workout_time_series_dedupe AS dedupe
+      ON dedupe.latest_rowid = latest.rowid
+    WHERE dedupe.survivor_rowid = health_workout_time_series.rowid
+  ),
+  metadata_json = (
+    SELECT latest.metadata_json
+    FROM health_workout_time_series AS latest
+    JOIN health_workout_time_series_dedupe AS dedupe
+      ON dedupe.latest_rowid = latest.rowid
+    WHERE dedupe.survivor_rowid = health_workout_time_series.rowid
+  ),
+  provenance_json = (
+    SELECT latest.provenance_json
+    FROM health_workout_time_series AS latest
+    JOIN health_workout_time_series_dedupe AS dedupe
+      ON dedupe.latest_rowid = latest.rowid
+    WHERE dedupe.survivor_rowid = health_workout_time_series.rowid
+  ),
+  updated_at = (
+    SELECT latest.updated_at
+    FROM health_workout_time_series AS latest
+    JOIN health_workout_time_series_dedupe AS dedupe
+      ON dedupe.latest_rowid = latest.rowid
+    WHERE dedupe.survivor_rowid = health_workout_time_series.rowid
+  )
+WHERE rowid IN (
+  SELECT survivor_rowid
+  FROM health_workout_time_series_dedupe
+);
+
+DELETE FROM health_workout_time_series
+WHERE rowid IN (
+  SELECT duplicate.rowid
+  FROM health_workout_time_series AS duplicate
+  JOIN health_workout_time_series_dedupe AS dedupe
+    ON dedupe.workout_id = duplicate.workout_id
+   AND dedupe.metric_key = duplicate.metric_key
+   AND dedupe.source_sample_uid = duplicate.source_sample_uid
+  WHERE duplicate.rowid != dedupe.survivor_rowid
+);
+
+UPDATE health_workout_time_series
+SET series_index = (
+  SELECT dedupe.latest_series_index
+  FROM health_workout_time_series_dedupe AS dedupe
+  WHERE dedupe.survivor_rowid = health_workout_time_series.rowid
+)
+WHERE rowid IN (
+  SELECT survivor_rowid
+  FROM health_workout_time_series_dedupe
+);
+
+DROP TABLE health_workout_time_series_dedupe;
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_health_workout_time_series_sample_identity
+  ON health_workout_time_series(workout_id, metric_key, source_sample_uid);

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

@@ -2960,6 +2960,7 @@ const AGENT_ONBOARDING_ENTITY_CATALOG = [
         ],
         searchHints: [
             "Clarify whether the user wants a behavioral query, one trip or place, a missing-gap overlay, a manual add or update, or a link before choosing the route.",
+            "For known-place creation or cleanup, ask what label, boundary, and future use should make the place recognizable before calling the dedicated place route.",
             "If the user already named a concrete missing span, confirm only the remaining time or place ambiguity, then use the movement overlay route and read the timeline back.",
             "If the user wants to revise or remove an already-saved correction, identify whether it is a user-defined box, automatic box, recorded stay, recorded trip, or trip point before choosing the repair or delete route."
         ],
@@ -2975,6 +2976,7 @@ const AGENT_ONBOARDING_ENTITY_CATALOG = [
         ],
         searchHints: [
             "Clarify whether the user wants explanation, durable model changes, or a real-time tired or recovered signal before choosing the route.",
+            "For profile or weekday-template edits, ask what future planning behavior should change, such as workload, recovery time, timeboxes, meeting load, or task choice.",
             "Separate durable profile assumptions, weekday-template edits, and right-now fatigue signals before choosing the mutation path.",
             "When the user is trying to understand the practical result of a change, read the overview again after the write instead of stopping at the mutation response."
         ],
@@ -2990,6 +2992,7 @@ const AGENT_ONBOARDING_ENTITY_CATALOG = [
         ],
         searchHints: [
             "Clarify whether the user wants flow discovery, editing, execution, published output, run inspection, or node-level output before choosing the route.",
+            "For one-off execution, ask whether the input contract should stay temporary or become a reusable saved flow before creating anything durable.",
             "Distinguish flow contract, published output, run history, latest-node-output, and chat follow-up questions before reaching for a route.",
             "If the user is still deciding how to run or edit a flow, read flow detail or the box catalog before asking them for structured input details."
         ],
@@ -3057,6 +3060,8 @@ const AGENT_ONBOARDING_CONVERSATION_RULES = [
     "For direct update or review requests, the next question should usually narrow the saved object, timeframe, or route family instead of reopening the whole meaning-making arc.",
     "For updates, start with the smallest thing that now feels wrong, newly true, or newly visible rather than restarting the whole story.",
     "For review requests, ask what practical question the user wants the read to answer before you ask for more scope.",
+    "Treat userId, owner, and human/bot assignees as accountability and scope, not as opening form fields. Ask whose record or owner scope matters only when it changes visibility, review results, collaboration, automation behavior, or later filtering.",
+    "For read and overview requests, ask for human or bot user scope only when the answer would meaningfully differ across owners; otherwise keep the next question focused on the user's practical question.",
     "The opening question should help the user understand what they are actually trying to save, decide, review, or change, not make them perform the schema out loud.",
     "If the user already named the exact correction in usable language, confirm only the missing scope, timing, or route-selecting detail that still matters, then act.",
     "Keep API and architecture nouns out of user-facing questions unless the user asks about implementation. Do not ask the user about surfaces, route families, CRUD, payloads, mutation paths, or read paths; ask about the human object such as a wiki page, note, trigger report, behavior pattern, belief, mode, movement timeline, energy model, weekday pattern, flow, run, or node result.",
@@ -4776,6 +4781,7 @@ function buildAgentOnboardingPayload(request) {
                     ],
                     routeSelectionQuestions: [
                         "Is the user asking for a day, month, all-time, timeline, place, trip detail, selected-span, or settings answer?",
+                        "If this is known-place creation or cleanup, what label, boundary, or future-use distinction is still missing?",
                         "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?"
@@ -4837,6 +4843,7 @@ function buildAgentOnboardingPayload(request) {
                         "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.",
+                        "For known-place creation or cleanup, ask for the place label, boundary, and future use, then use POST /api/v1/movement/places or PATCH /api/v1/movement/places/:id instead of tags or generic entity writes.",
                         "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."
@@ -4849,6 +4856,7 @@ function buildAgentOnboardingPayload(request) {
                     routeKeys: ["overview", "profile", "weekdayTemplate", "fatigueSignal"],
                     routeSelectionQuestions: [
                         "Is the user trying to understand the overview, change durable profile assumptions, change a weekday curve, or log a right-now fatigue signal?",
+                        "What planning decision should the overview or correction change: workload, recovery, timeboxes, meetings, or task choice?",
                         "Are they describing a repeatable weekly shape or a one-off current state?",
                         "If the lane is already clear, what one weekday, profile field, or signal detail is still missing?"
                     ],
@@ -4871,6 +4879,8 @@ function buildAgentOnboardingPayload(request) {
                         "Route-selection questions are internal. User-facing questions should ask whether this is a current read, durable assumption, repeated weekday rhythm, or right-now state instead of reciting overview/profile/template/signal route keys.",
                         "Use GET /api/v1/life-force for the current overview payload with stats, drains, recommendations, and current-curve state.",
                         "Patch the profile only for durable personal settings, update weekday templates only for the curve itself, and post fatigue signals for real-time tired or recovered observations.",
+                        "If the user only needs an explanation or planning read, use the overview first and do not turn the conversation into a profile or template mutation.",
+                        "For profile or weekday-template edits, ask what future planning behavior should change, such as workload, recovery time, timeboxes, meeting load, or task choice, so the write is not just a nicer description.",
                         "If the user says something like 'I always dip on Tuesdays after lunch', treat that as a weekday-template change rather than a one-off fatigue signal.",
                         "If the user is asking what changed after a profile, template, or fatigue write, read the overview back so the effect stays visible.",
                         "If the user already knows they want a profile change, weekday-template edit, or right-now fatigue signal, skip the broad lane question and ask only for the missing weekday, profile field, or signal detail."
@@ -4883,6 +4893,7 @@ function buildAgentOnboardingPayload(request) {
                     routeKeys: ["overview", "profile", "weekdayTemplate", "fatigueSignal"],
                     routeSelectionQuestions: [
                         "Is the user trying to understand the overview, change durable profile assumptions, change a weekday curve, or log a right-now fatigue signal?",
+                        "What planning decision should the overview or correction change: workload, recovery, timeboxes, meetings, or task choice?",
                         "Are they describing a repeatable weekly shape or a one-off current state?",
                         "If the lane is already clear, what one weekday, profile field, or signal detail is still missing?"
                     ],
@@ -4906,6 +4917,8 @@ function buildAgentOnboardingPayload(request) {
                         "Route-selection questions are internal. User-facing questions should ask whether this is a current read, durable assumption, repeated weekday rhythm, or right-now state instead of reciting overview/profile/template/signal route keys.",
                         "Use GET /api/v1/life-force for the current overview payload with stats, drains, recommendations, and current-curve state.",
                         "Patch the profile only for durable personal settings, update weekday templates only for the curve itself, and post fatigue signals for real-time tired or recovered observations.",
+                        "If the user only needs an explanation or planning read, use the overview first and do not turn the conversation into a profile or template mutation.",
+                        "For profile or weekday-template edits, ask what future planning behavior should change, such as workload, recovery time, timeboxes, meeting load, or task choice, so the write is not just a nicer description.",
                         "If the user says something like 'I always dip on Tuesdays after lunch', treat that as a weekday-template change rather than a one-off fatigue signal.",
                         "If the user is asking what changed after a profile, template, or fatigue write, read the overview back so the effect stays visible.",
                         "If the user already knows they want a profile change, weekday-template edit, or right-now fatigue signal, skip the broad lane question and ask only for the missing weekday, profile field, or signal detail."
@@ -4935,6 +4948,7 @@ function buildAgentOnboardingPayload(request) {
                     ],
                     routeSelectionQuestions: [
                         "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?",
+                        "If this is execution, is it a known saved flow, a one-off input run, or a flow that should become reusable?",
                         "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?",
@@ -4984,6 +4998,7 @@ function buildAgentOnboardingPayload(request) {
                         "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 reconstruct structured inputs 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 input details.",
+                        "For one-off execution, do not create a saved flow unless the user wants reuse. Ask whether the input contract should stay temporary or become durable, then use POST /api/v1/workbench/run for the temporary case.",
                         "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.",
@@ -5255,8 +5270,12 @@ function buildAgentOnboardingPayload(request) {
                 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"}}',
+                movementPlaceCreate: '{"routeKey":"placeCreate","body":{"label":"Home","centerLat":46.2044,"centerLon":6.1432,"radiusMeters":120,"userId":"user_operator","note":"Primary home boundary for future time-in-place reads."}}',
+                movementPlaceUpdate: '{"routeKey":"placeUpdate","pathParams":{"id":"place_home"},"body":{"label":"Home office","radiusMeters":90,"note":"Tighten the boundary so clinic visits do not count as home."}}',
                 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."}}',
+                movementUserBoxUpdate: '{"routeKey":"userBoxUpdate","pathParams":{"id":"box_manual_123"},"body":{"endedAt":"2026-05-06T15:30:00.000Z","note":"Extended after checking the timeline detail."}}',
+                movementUserBoxDelete: '{"routeKey":"userBoxDelete","pathParams":{"id":"box_manual_123"}}',
                 lifeForceOverview: '{"routeKey":"overview"}',
                 lifeForceProfile: '{"routeKey":"profile","body":{"baselineDailyAp":24,"recoveryNotes":"Clinic-admin days need a lower expected afternoon load."}}',
                 lifeForceWeekdayTemplate: '{"routeKey":"weekdayTemplate","pathParams":{"weekday":"monday"},"body":{"points":[{"hour":13,"freeAp":-4}]}}',
@@ -5267,6 +5286,8 @@ function buildAgentOnboardingPayload(request) {
                 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"}}',
+                workbenchRunNodes: '{"routeKey":"runNodes","pathParams":{"id":"flow_research_digest","runId":"run_123"}}',
+                workbenchNodeResult: '{"routeKey":"nodeResult","pathParams":{"id":"flow_research_digest","runId":"run_123","nodeId":"node_summary"}}',
                 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"}}}',

package/dist/server/server/src/health-workout-analytics.js

@@ -365,9 +365,15 @@ export function upsertWorkoutTimeSeries(input) {
        quality_flags_json, metadata_json, provenance_json, created_at, updated_at
      )
      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-     ON CONFLICT(workout_id, metric_key, source_sample_uid, series_index)
-     DO UPDATE SET value = excluded.value, started_at = excluded.started_at,
+     ON CONFLICT(workout_id, metric_key, source_sample_uid)
+     DO UPDATE SET series_index = excluded.series_index,
+       value = excluded.value, started_at = excluded.started_at,
        ended_at = excluded.ended_at, source_device = excluded.source_device,
+       label = excluded.label,
+       category = excluded.category,
+       unit = excluded.unit,
+       source_bundle_identifier = excluded.source_bundle_identifier,
+       source_product_type = excluded.source_product_type,
        capture_method = excluded.capture_method,
        quality_flags_json = excluded.quality_flags_json,
        metadata_json = excluded.metadata_json,

package/dist/server/server/src/health.js

@@ -2735,6 +2735,97 @@ function mobileSyncSessionProgress(syncSessionId) {
         receivedBytes: chunks.reduce((sum, chunk) => sum + chunk.byte_count, 0)
     };
 }
+function finiteNumberFromUnknown(value) {
+    if (typeof value === "number" && Number.isFinite(value)) {
+        return value;
+    }
+    if (typeof value === "string" && value.trim().length > 0) {
+        const parsed = Number(value);
+        return Number.isFinite(parsed) ? parsed : null;
+    }
+    return null;
+}
+function nestedRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+}
+function expectedWorkoutEvidenceCounts(derived) {
+    const syncCursor = nestedRecord(derived.syncCursor);
+    const captureQuality = nestedRecord(derived.captureQuality);
+    const syncTimeSeriesCount = finiteNumberFromUnknown(syncCursor.timeSeriesSampleCount);
+    const captureHeartRateCount = finiteNumberFromUnknown(captureQuality.heartRateSamples);
+    const syncRoutePointCount = finiteNumberFromUnknown(syncCursor.routePointCount);
+    const captureRoutePointCount = finiteNumberFromUnknown(captureQuality.routePoints);
+    const expectedTimeSeriesSamples = Math.max(0, Math.ceil(Math.max(syncTimeSeriesCount ?? 0, captureHeartRateCount ?? 0)));
+    const expectedRoutePoints = Math.max(0, Math.ceil(Math.max(syncRoutePointCount ?? 0, captureRoutePointCount ?? 0)));
+    return {
+        expectedTimeSeriesSamples,
+        expectedRoutePoints,
+        hasEvidenceMetadata: syncTimeSeriesCount !== null ||
+            captureHeartRateCount !== null ||
+            syncRoutePointCount !== null ||
+            captureRoutePointCount !== null
+    };
+}
+function mobileHealthWorkoutImportState(userId) {
+    const rows = getDatabase()
+        .prepare(`WITH time_series_counts AS (
+         SELECT workout_id, COUNT(*) AS time_series_count
+         FROM health_workout_time_series
+         GROUP BY workout_id
+       ),
+       route_counts AS (
+         SELECT workout_id, COUNT(*) AS route_point_count
+         FROM health_workout_routes
+         GROUP BY workout_id
+       )
+       SELECT
+         w.external_uid,
+         w.derived_json,
+         COALESCE(time_series_counts.time_series_count, 0) AS time_series_count,
+         COALESCE(route_counts.route_point_count, 0) AS route_point_count
+       FROM health_workout_sessions w
+       LEFT JOIN time_series_counts ON time_series_counts.workout_id = w.id
+       LEFT JOIN route_counts ON route_counts.workout_id = w.id
+       WHERE w.user_id = ?
+         AND w.source = 'apple_health'
+         AND w.external_uid IS NOT NULL
+         AND w.external_uid <> ''
+       ORDER BY w.started_at DESC`)
+        .all(userId);
+    const alreadyUploadedWorkoutExternalUids = [];
+    let incompleteWorkoutCount = 0;
+    let timeSeriesSampleCount = 0;
+    let routePointCount = 0;
+    for (const row of rows) {
+        const derived = safeJsonParse(row.derived_json, {});
+        const evidenceCounts = expectedWorkoutEvidenceCounts(derived);
+        const actualTimeSeriesCount = Math.max(0, row.time_series_count ?? 0);
+        const actualRoutePointCount = Math.max(0, row.route_point_count ?? 0);
+        const evidenceComplete = evidenceCounts.hasEvidenceMetadata
+            ? actualTimeSeriesCount >= evidenceCounts.expectedTimeSeriesSamples &&
+                actualRoutePointCount >= evidenceCounts.expectedRoutePoints
+            : actualTimeSeriesCount + actualRoutePointCount > 0;
+        if (evidenceComplete) {
+            alreadyUploadedWorkoutExternalUids.push(row.external_uid.toLowerCase());
+            timeSeriesSampleCount += actualTimeSeriesCount;
+            routePointCount += actualRoutePointCount;
+        }
+        else {
+            incompleteWorkoutCount += 1;
+        }
+    }
+    return {
+        alreadyUploadedWorkoutExternalUids,
+        alreadyUploadedWorkoutCount: alreadyUploadedWorkoutExternalUids.length,
+        existingWorkoutCount: rows.length,
+        incompleteWorkoutCount,
+        timeSeriesSampleCount,
+        routePointCount,
+        capturedAt: nowIso()
+    };
+}
 function mobileSyncSessionUploadPayload(session, receivedChunkIds) {
     return {
         syncSessionId: session.id,
@@ -2747,6 +2838,7 @@ function mobileSyncSessionUploadPayload(session, receivedChunkIds) {
         supportsCompression: true,
         acceptedFamilies: safeJsonParse(session.requested_families_json, []),
         receivedChunkIds,
+        workoutImportState: mobileHealthWorkoutImportState(session.user_id),
         progress: mobileSyncSessionProgress(session.id)
     };
 }

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "forge-openclaw-plugin",
   "name": "Forge",
   "description": "Curated OpenClaw adapter for the Forge collaboration API, UI entrypoint, and localhost auto-start runtime.",
-  "version": "0.2.91",
+  "version": "0.2.93",
   "activation": {
     "onStartup": true,
     "onCapabilities": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forge-openclaw-plugin",
-  "version": "0.2.91",
+  "version": "0.2.93",
   "description": "Curated OpenClaw adapter for the Forge collaboration API, UI entrypoint, and localhost auto-start runtime.",
   "type": "module",
   "license": "Apache-2.0",

package/server/migrations/064_health_workout_time_series_identity.sql

@@ -0,0 +1,161 @@
+CREATE TEMP TABLE health_workout_time_series_dedupe AS
+SELECT
+  workout_id,
+  metric_key,
+  source_sample_uid,
+  MIN(rowid) AS survivor_rowid,
+  (
+    SELECT latest.rowid
+    FROM health_workout_time_series AS latest
+    WHERE latest.workout_id = grouped.workout_id
+      AND latest.metric_key = grouped.metric_key
+      AND latest.source_sample_uid = grouped.source_sample_uid
+    ORDER BY latest.updated_at DESC, latest.created_at DESC, latest.rowid DESC
+    LIMIT 1
+  ) AS latest_rowid,
+  (
+    SELECT latest.series_index
+    FROM health_workout_time_series AS latest
+    WHERE latest.workout_id = grouped.workout_id
+      AND latest.metric_key = grouped.metric_key
+      AND latest.source_sample_uid = grouped.source_sample_uid
+    ORDER BY latest.updated_at DESC, latest.created_at DESC, latest.rowid DESC
+    LIMIT 1
+  ) AS latest_series_index
+FROM health_workout_time_series AS grouped
+WHERE source_sample_uid IS NOT NULL
+  AND source_sample_uid != ''
+GROUP BY workout_id, metric_key, source_sample_uid
+HAVING COUNT(*) > 1;
+
+UPDATE health_workout_time_series
+SET
+  label = (
+    SELECT latest.label
+    FROM health_workout_time_series AS latest
+    JOIN health_workout_time_series_dedupe AS dedupe
+      ON dedupe.latest_rowid = latest.rowid
+    WHERE dedupe.survivor_rowid = health_workout_time_series.rowid
+  ),
+  category = (
+    SELECT latest.category
+    FROM health_workout_time_series AS latest
+    JOIN health_workout_time_series_dedupe AS dedupe
+      ON dedupe.latest_rowid = latest.rowid
+    WHERE dedupe.survivor_rowid = health_workout_time_series.rowid
+  ),
+  unit = (
+    SELECT latest.unit
+    FROM health_workout_time_series AS latest
+    JOIN health_workout_time_series_dedupe AS dedupe
+      ON dedupe.latest_rowid = latest.rowid
+    WHERE dedupe.survivor_rowid = health_workout_time_series.rowid
+  ),
+  value = (
+    SELECT latest.value
+    FROM health_workout_time_series AS latest
+    JOIN health_workout_time_series_dedupe AS dedupe
+      ON dedupe.latest_rowid = latest.rowid
+    WHERE dedupe.survivor_rowid = health_workout_time_series.rowid
+  ),
+  started_at = (
+    SELECT latest.started_at
+    FROM health_workout_time_series AS latest
+    JOIN health_workout_time_series_dedupe AS dedupe
+      ON dedupe.latest_rowid = latest.rowid
+    WHERE dedupe.survivor_rowid = health_workout_time_series.rowid
+  ),
+  ended_at = (
+    SELECT latest.ended_at
+    FROM health_workout_time_series AS latest
+    JOIN health_workout_time_series_dedupe AS dedupe
+      ON dedupe.latest_rowid = latest.rowid
+    WHERE dedupe.survivor_rowid = health_workout_time_series.rowid
+  ),
+  source_device = (
+    SELECT latest.source_device
+    FROM health_workout_time_series AS latest
+    JOIN health_workout_time_series_dedupe AS dedupe
+      ON dedupe.latest_rowid = latest.rowid
+    WHERE dedupe.survivor_rowid = health_workout_time_series.rowid
+  ),
+  source_bundle_identifier = (
+    SELECT latest.source_bundle_identifier
+    FROM health_workout_time_series AS latest
+    JOIN health_workout_time_series_dedupe AS dedupe
+      ON dedupe.latest_rowid = latest.rowid
+    WHERE dedupe.survivor_rowid = health_workout_time_series.rowid
+  ),
+  source_product_type = (
+    SELECT latest.source_product_type
+    FROM health_workout_time_series AS latest
+    JOIN health_workout_time_series_dedupe AS dedupe
+      ON dedupe.latest_rowid = latest.rowid
+    WHERE dedupe.survivor_rowid = health_workout_time_series.rowid
+  ),
+  capture_method = (
+    SELECT latest.capture_method
+    FROM health_workout_time_series AS latest
+    JOIN health_workout_time_series_dedupe AS dedupe
+      ON dedupe.latest_rowid = latest.rowid
+    WHERE dedupe.survivor_rowid = health_workout_time_series.rowid
+  ),
+  quality_flags_json = (
+    SELECT latest.quality_flags_json
+    FROM health_workout_time_series AS latest
+    JOIN health_workout_time_series_dedupe AS dedupe
+      ON dedupe.latest_rowid = latest.rowid
+    WHERE dedupe.survivor_rowid = health_workout_time_series.rowid
+  ),
+  metadata_json = (
+    SELECT latest.metadata_json
+    FROM health_workout_time_series AS latest
+    JOIN health_workout_time_series_dedupe AS dedupe
+      ON dedupe.latest_rowid = latest.rowid
+    WHERE dedupe.survivor_rowid = health_workout_time_series.rowid
+  ),
+  provenance_json = (
+    SELECT latest.provenance_json
+    FROM health_workout_time_series AS latest
+    JOIN health_workout_time_series_dedupe AS dedupe
+      ON dedupe.latest_rowid = latest.rowid
+    WHERE dedupe.survivor_rowid = health_workout_time_series.rowid
+  ),
+  updated_at = (
+    SELECT latest.updated_at
+    FROM health_workout_time_series AS latest
+    JOIN health_workout_time_series_dedupe AS dedupe
+      ON dedupe.latest_rowid = latest.rowid
+    WHERE dedupe.survivor_rowid = health_workout_time_series.rowid
+  )
+WHERE rowid IN (
+  SELECT survivor_rowid
+  FROM health_workout_time_series_dedupe
+);
+
+DELETE FROM health_workout_time_series
+WHERE rowid IN (
+  SELECT duplicate.rowid
+  FROM health_workout_time_series AS duplicate
+  JOIN health_workout_time_series_dedupe AS dedupe
+    ON dedupe.workout_id = duplicate.workout_id
+   AND dedupe.metric_key = duplicate.metric_key
+   AND dedupe.source_sample_uid = duplicate.source_sample_uid
+  WHERE duplicate.rowid != dedupe.survivor_rowid
+);
+
+UPDATE health_workout_time_series
+SET series_index = (
+  SELECT dedupe.latest_series_index
+  FROM health_workout_time_series_dedupe AS dedupe
+  WHERE dedupe.survivor_rowid = health_workout_time_series.rowid
+)
+WHERE rowid IN (
+  SELECT survivor_rowid
+  FROM health_workout_time_series_dedupe
+);
+
+DROP TABLE health_workout_time_series_dedupe;
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_health_workout_time_series_sample_identity
+  ON health_workout_time_series(workout_id, metric_key, source_sample_uid);

package/skills/forge-openclaw/SKILL.md

@@ -116,9 +116,17 @@ Concrete route-key examples for internal use:
   `{"routeKey":"settings","query":{"userIds":["user_operator"]}}`
 - Movement settings update:
   `{"routeKey":"settingsUpdate","body":{"trackingEnabled":true,"publishMode":"draft_review","retentionMode":"aggregates_only"}}`
+- Movement known-place creation:
+  `{"routeKey":"placeCreate","body":{"label":"Home","centerLat":46.2044,"centerLon":6.1432,"radiusMeters":120,"userId":"user_operator","note":"Primary home boundary for future time-in-place reads."}}`
+- Movement known-place update:
+  `{"routeKey":"placeUpdate","pathParams":{"id":"place_home"},"body":{"label":"Home office","radiusMeters":90,"note":"Tighten the boundary so clinic visits do not count as home."}}`
 - Movement missing-stay correction:
   first `{"routeKey":"userBoxPreflight","body":{"kind":"stay","startedAt":"2026-05-06T13:00:00.000Z","endedAt":"2026-05-06T15:00:00.000Z","placeLabel":"Home","userId":"user_operator"}}`,
   then `{"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."}}`
+- Movement saved-overlay update:
+  `{"routeKey":"userBoxUpdate","pathParams":{"id":"box_manual_123"},"body":{"endedAt":"2026-05-06T15:30:00.000Z","note":"Extended after checking the timeline detail."}}`
+- Movement saved-overlay delete:
+  `{"routeKey":"userBoxDelete","pathParams":{"id":"box_manual_123"}}`
 - Life Force overview:
   `{"routeKey":"overview"}`
 - Life Force profile edit:
@@ -139,6 +147,10 @@ Concrete route-key examples for internal use:
   `{"routeKey":"deleteFlow","pathParams":{"id":"flow_research_digest"}}`
 - Workbench run detail:
   `{"routeKey":"runDetail","pathParams":{"id":"flow_research_digest","runId":"run_123"}}`
+- Workbench run nodes:
+  `{"routeKey":"runNodes","pathParams":{"id":"flow_research_digest","runId":"run_123"}}`
+- Workbench node result:
+  `{"routeKey":"nodeResult","pathParams":{"id":"flow_research_digest","runId":"run_123","nodeId":"node_summary"}}`
 - Workbench published output:
   `{"routeKey":"publishedOutput","pathParams":{"id":"flow_research_digest"}}`
 - Workbench latest node output:
@@ -224,6 +236,7 @@ Entity conversation rule:
   before you reopen create or update intake.
 - When updating an entity, start with what is changing, what should stay true, and what prompted the update now.
 - When enough is clear, briefly summarize what you heard in the user's own language before asking for the last missing structural detail.
+- Treat `userId` and human/bot assignees as accountability and scope, not as opening form fields. Ask whose human or bot record it is only when ownership changes visibility, review scope, collaboration, automation behavior, or later filtering; for read requests, ask user scope only when the answer would differ across owners.
 - The quick intake prompts later in this file are fallback checkpoints, not a script to read aloud.
 
 Forge data location rule:
@@ -249,6 +262,7 @@ Psyche interview rule:
 - After the first real answer, choose one follow-up lane at a time: situation, sequence, meaning, protection, cost, longing/value, or tentative name.
 - Do not minimize functional analysis, trigger chains, behavior patterns, modes, beliefs, or schema themes. Once at least one concrete example is clear, offer one careful interpretive hypothesis when it would help the user understand the function, protection, cost, belief, mode, or schema theme.
 - Phrase interpretive hypotheses as collaborative and testable, not as verdicts. A good hypothesis says what the reaction may be protecting, predicting, relieving, or costing, then asks whether that lands or needs correction.
+- If several Psyche containers are plausible, do not ask the user to choose from a taxonomy menu first. Reflect the lived difference, offer one careful hypothesis when a concrete example is visible, then distinguish the options in plain language: one episode as a `trigger_report`, a recurring loop as a `behavior_pattern`, one repeated move as `behavior`, one sentence as `belief_entry`, a part-state as `mode_profile` or `mode_guide_session`, or reusable future-labeling as `event_type` or `emotion_definition`.
 - For Psyche updates, start with what feels newly true, newly visible, or newly inaccurate, then ask what should stay true before changing the formulation.
 - If a fresh episode is what made a Psyche update visible, anchor in that episode before renaming the durable belief, pattern, mode, or value.
 - If the user says they want help understanding a Psyche issue before saving it, ask one orienting question first instead of jumping straight into a full interpretation, diagnosis-like label, save suggestion, replacement belief, or suggested title.

package/skills/forge-openclaw/entity_conversation_playbooks.md

@@ -204,6 +204,25 @@ When placement matters, prefer one hierarchy-aware linking question that can
 select or create the right goal, project, issue, or parent work item from the
 same search-first flow.
 
+## Owner And User-Scope Checkpoint
+
+Most normal stored Forge entities can carry `userId`, and many planning records can
+also carry human or bot assignees. Treat ownership as accountability and useful
+visibility, not as the first field in the form.
+
+- Do not open with "who owns this?" unless the user is explicitly delegating,
+  comparing human and bot work, or creating a record for someone else.
+- Ask whose human or bot record it is only when ownership changes accountability,
+  visibility, review scope, automation behavior, or later filtering.
+- For collaborative planning records, ask about assignees only after the outcome,
+  hierarchy placement, and owner are clear enough.
+- For reviews and overviews, ask which user or owner scope matters only when the
+  answer would change across humans or bots.
+- If the user's wording already names the owner or bot actor, use that as the
+  `userId` direction internally and ask only for any ambiguity that remains.
+- When owner scope is irrelevant, stay with the entity's meaning, timing, route, or
+  links instead of adding an administrative question.
+
 ## Operation lane checkpoint
 
 Use this before you choose an API path or ask for more structure.
@@ -1537,9 +1556,9 @@ Preferred opening question:
 ## Movement
 
 Aim: clarify whether the user wants to understand time in place, review travel
-behavior, add or update a stay or trip, inspect one place, change movement operating
-settings, or link movement context to another Forge record before choosing the
-dedicated route family.
+behavior, add or update a stay or trip, create or clean up a known place, change
+movement operating settings, or link movement context to another Forge record before
+choosing the dedicated route family.
 
 Arc:
 
@@ -1548,17 +1567,19 @@ Arc:
 2. Ask whether the user is trying to query behavior, add something manually, update
    an existing movement item, or link movement to another Forge entity.
 3. Ask whether the focus is a stay, a trip, a place, a timeline window, or a selected span.
-4. Ask for the time window, place, or movement item that makes the question concrete.
-5. Ask what they are trying to notice, preserve, or answer through that movement context.
-6. If the user is changing movement operating behavior, ask whether the change is
+4. If this is place creation or cleanup, ask what label, boundary, and future use
+   should make the place recognizable later.
+5. Ask for the time window, place, or movement item that makes the question concrete.
+6. Ask what they are trying to notice, preserve, or answer through that movement context.
+7. If the user is changing movement operating behavior, ask whether the change is
    about passive tracking, publish mode, retention, or companion readiness.
-7. Choose the dedicated day, month, all-time, timeline, places, trip-detail,
+8. Choose the dedicated day, month, all-time, timeline, places, trip-detail,
    selection, or settings route once the question shape is clear.
-8. If the truth of one uncertain span is still unclear, read the timeline or saved-box
+9. If the truth of one uncertain span is still unclear, read the timeline or saved-box
    detail before you mutate it.
-9. Skip the meta lane question when the user already named the exact correction or
+10. Skip the meta lane question when the user already named the exact correction or
    review target and only one ambiguity remains.
-10. Use the dedicated movement route once you know whether the user needs timeline
+11. Use the dedicated movement route once you know whether the user needs timeline
    review, overlay, place or trip detail, selection summary, settings, or repair.
 
 Direct action rules:
@@ -1591,12 +1612,17 @@ Direct action rules:
   interval or place if that is still ambiguous, then act.
 - When you do act on a concrete missing-gap correction, create the overlay and read
   the relevant timeline back instead of leaving the correction ungrounded.
+- For known-place creation or cleanup, ask what the place should be called, what
+  counts inside its boundary, and how future movement reads should use it. Use the
+  dedicated place routes, not a tag or batch entity write.
 
 Helpful follow-up lanes:
 
 - whether the user wants time-in-place, travel history, one specific stay or trip, a
   place summary, or a link
 - what time window, place, stay, trip, or selection is in scope
+- what label, boundary, or future-use distinction makes a known place worth saving or
+  renaming
 - whether the question is behavioral, such as time at home, travel frequency, or place
   distribution, versus an edit
 - whether the edit is a missing-gap overlay versus a true recorded stay/trip patch
@@ -1649,7 +1675,8 @@ Preferred opening question:
 ## Life Force
 
 Aim: clarify whether the user wants to review current energy state, change durable
-profile assumptions, edit weekday curves, or log a real-time fatigue signal.
+profile assumptions, edit weekday curves, log a real-time fatigue signal, or make a
+planning decision based on the energy model.
 
 Arc:
 
@@ -1657,22 +1684,25 @@ Arc:
    you reduce it to one life-force lane.
 2. Ask whether the job is overview, profile change, weekday-template change, or fatigue signaling.
 3. Ask what part of the current energy picture feels most important or inaccurate.
-4. Ask what should stay true if they are changing profile or template assumptions.
-5. Ask whether the user is describing a stable weekly shape or just how today feels
+4. Ask what planning decision should change if the model is corrected: workload,
+   recovery, timeboxing, meeting load, or task choice.
+5. Ask what should stay true if they are changing profile or template assumptions.
+6. Ask whether the user is describing a stable weekly shape or just how today feels
    when the lane is still blurred.
-6. If the user describes a repeatable day-shape such as "Mondays crash after lunch",
+7. If the user describes a repeatable day-shape such as "Mondays crash after lunch",
    treat that as a weekday-template question before you reach for profile or
    fatigue-signal routes.
-7. If the user already named the life-force lane clearly, skip the meta lane question
+8. If the user already named the life-force lane clearly, skip the meta lane question
    and ask only for the specific weekday, profile field, or signal that still matters.
-8. If the user wants to see what changed after a write, read the overview back instead
+9. If the user wants to see what changed after a write, read the overview back instead
    of leaving the result implicit.
-9. Route to the dedicated life-force path once the lane is clear.
+10. Route to the dedicated life-force path once the lane is clear.
 
 Helpful follow-up lanes:
 
 - whether the user wants explanation, editing, or signaling
 - what part of the energy model feels off or useful
+- what planning decision the overview or correction should change
 - what durable assumption versus real-time state is being changed
 - whether the user is describing a stable weekly shape or just how today feels
 
@@ -1704,6 +1734,11 @@ Direct action rules:
   instead of treating it as a one-off right-now feeling.
 - If the user is describing how one weekday should usually feel, update that weekday
   template instead of editing the profile.
+- If the user only needs an explanation or planning read, use the overview first and
+  do not turn the conversation into a profile or template mutation.
+- For profile or weekday-template edits, ask what future planning behavior should
+  change, such as workload, recovery time, timeboxes, meeting load, or task choice,
+  so the write is not just a more polished description.
 - If the user says something like "I always dip on Tuesdays after lunch", treat that
   as a weekday-template edit, not as a one-off fatigue signal.
 - If the user is describing right-now depletion or recovery, post a fatigue signal and
@@ -1737,18 +1772,20 @@ Arc:
 5. If the user is creating or editing a flow, clarify the flow's job, stable inputs,
    expected public output, and the smallest structural change before asking for node
    details.
-6. If the user wants to delete or archive a flow, ask which saved flow is affected
+6. If the user wants one-off execution, clarify whether this should stay a one-time
+   input run or become a reusable saved flow before creating anything durable.
+7. If the user wants to delete or archive a flow, ask which saved flow is affected
    and what future run, published output, or public contract should no longer exist.
-7. If the user wants to continue a saved flow chat, ask which flow should receive the
+8. If the user wants to continue a saved flow chat, ask which flow should receive the
    follow-up and what the message should accomplish.
-8. If the user already named the flow and action clearly, skip the meta lane
+9. 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.
-9. If the user wants a stable public input contract or published output, prefer those
+10. If the user wants a stable public input contract or published output, prefer those
    dedicated reads instead of detouring through run history first.
-10. If the user is debugging one failed run, ask whether the useful artifact is the run
+11. If the user is debugging one failed run, ask whether the useful artifact is the run
    summary, one node result, the latest node output, or the published output before
    you start asking for edits.
-11. Route to the dedicated workbench route family once the execution lane is clear.
+12. Route to the dedicated workbench route family once the execution lane is clear.
 
 Helpful follow-up lanes:
 
@@ -1756,6 +1793,7 @@ Helpful follow-up lanes:
 - what exact flow or run is in scope
 - whether they need whole-flow output or node-level detail
 - whether they need a public input contract or a published output instead of a debug trace
+- whether a requested execution should remain one-off or become a reusable saved flow
 
 Lane-to-route map:
 
@@ -1796,6 +1834,9 @@ Direct action rules:
 - If the user wants one-off input execution without depending on a saved flow id, use
   `POST /api/v1/workbench/run` through the dedicated one-off execution lane and keep
   the user-facing question about the one-off input contract.
+- For one-off execution, do not create a saved flow unless the user wants reuse. Ask
+  whether the input contract should be temporary or durable, then route to
+  `POST /api/v1/workbench/run` for the temporary case.
 - If the user wants to debug one failed execution, narrow whether they need the run
   detail, one node result, the latest node output, or the published output before you
   ask for flow changes.

package/skills/forge-openclaw/psyche_entity_playbooks.md

@@ -251,6 +251,41 @@ short, tentative, and correctable.
   episode, or durable wiki explanation. Do not flatten schema work into a loose
   self-observation.
 
+## Entity Contrast Check
+
+Use this when the user's material could fit several Psyche records. Do not ask the
+user to choose from a taxonomy menu before you have reflected what the material is
+doing.
+
+- Choose `trigger_report` when the important thing is one charged episode and the
+  useful record is the sequence of situation, feeling, meaning, action, and
+  consequence.
+- Choose `behavior_pattern` when the same cue -> body/emotion -> meaning ->
+  behavior/urge -> payoff -> cost loop repeats across situations and needs a
+  functional analysis.
+- Choose `behavior` when one recurring move is the main object, even if the wider
+  loop is not mapped yet.
+- Choose `belief_entry` when the live center is a sentence, rule, prediction, or
+  self/other/world assumption.
+- Choose `mode_profile` when a recurring part-state has a stable voice, posture,
+  job, fear, or burden.
+- Choose `mode_guide_session` when the user is inside the reaction and needs guided
+  present-moment exploration before a durable mode, belief, or pattern is clear.
+- Choose `event_type` or `emotion_definition` when the reusable category or feeling
+  label will make future trigger reports more precise.
+
+If two containers are genuinely plausible, say the distinction in plain language
+after a reflection. For example: "We could save this as the episode if the meeting
+itself is what matters, or as the recurring loop if this same freeze-and-overwork
+sequence keeps happening. Which would help you more right now?" Ask that only after
+the lived example is clear enough that the choice is meaningful.
+
+After one concrete example is visible, it is often helpful to offer one careful
+hypothesis before the contrast question: what the reaction may be protecting, what it
+predicts, what short-term relief it creates, and what it costs. If the user corrects
+the hypothesis, revise it once and then choose the record shape from the corrected
+meaning.
+
 ## Therapeutic Direction Check
 
 Before each follow-up, quickly decide what therapeutic job the next question should do.