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

forge-openclaw-plugin 0.2.69 → 0.2.71

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 (34) hide show

package/dist/assets/{board-BfqxFNiQ.js → board-B0TuXl4u.js} +1 -1
package/dist/assets/index-DtT3Y-Bj.css +1 -0
package/dist/assets/index-clNilMKr.js +91 -0
package/dist/assets/{motion-C0ALlgho.js → motion-Dmjq6HPm.js} +1 -1
package/dist/assets/{table-WcMjnJll.js → table-CKKimYN1.js} +1 -1
package/dist/assets/{ui-B5I-3U91.js → ui-JBdCP1Qb.js} +1 -1
package/dist/assets/{vendor-C56o26_3.js → vendor-fiXu5f59.js} +233 -228
package/dist/index.html +7 -7
package/dist/server/server/migrations/062_health_mobile_sync_sessions.sql +55 -0
package/dist/server/server/migrations/063_psyche_flashcards.sql +31 -0
package/dist/server/server/src/app.js +314 -20
package/dist/server/server/src/health.js +525 -1
package/dist/server/server/src/openapi.js +1 -0
package/dist/server/server/src/psyche-types.js +54 -0
package/dist/server/server/src/repositories/psyche.js +146 -1
package/dist/server/server/src/services/entity-crud.js +27 -5
package/dist/server/server/src/services/gamification.js +2 -0
package/dist/server/server/src/services/knowledge-graph.js +87 -1
package/dist/server/server/src/services/psyche-observation-calendar.js +1 -0
package/dist/server/server/src/services/psyche.js +4 -1
package/dist/server/server/src/types.js +3 -0
package/dist/server/src/lib/api.js +43 -0
package/dist/server/src/lib/entity-visuals.js +9 -0
package/dist/server/src/lib/knowledge-graph-types.js +19 -0
package/dist/server/src/lib/psyche-schemas.js +177 -0
package/openclaw.plugin.json +1 -1
package/package.json +2 -1
package/server/migrations/062_health_mobile_sync_sessions.sql +55 -0
package/server/migrations/063_psyche_flashcards.sql +31 -0
package/skills/forge-openclaw/SKILL.md +30 -9
package/skills/forge-openclaw/entity_conversation_playbooks.md +139 -7
package/skills/forge-openclaw/psyche_entity_playbooks.md +64 -3
package/dist/assets/index-BfLQnCNZ.js +0 -91
package/dist/assets/index-DIapFz9v.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-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">
+    <script type="module" crossorigin src="/forge/assets/index-clNilMKr.js"></script>
+    <link rel="modulepreload" crossorigin href="/forge/assets/vendor-fiXu5f59.js">
+    <link rel="modulepreload" crossorigin href="/forge/assets/board-B0TuXl4u.js">
+    <link rel="modulepreload" crossorigin href="/forge/assets/ui-JBdCP1Qb.js">
+    <link rel="modulepreload" crossorigin href="/forge/assets/motion-Dmjq6HPm.js">
+    <link rel="modulepreload" crossorigin href="/forge/assets/table-CKKimYN1.js">
     <link rel="stylesheet" crossorigin href="/forge/assets/vendor-B-Lq_OG3.css">
-    <link rel="stylesheet" crossorigin href="/forge/assets/index-DIapFz9v.css">
+    <link rel="stylesheet" crossorigin href="/forge/assets/index-DtT3Y-Bj.css">
   </head>
   <body class="bg-canvas text-ink antialiased">
     <div id="root"></div>

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/migrations/063_psyche_flashcards.sql ADDED Viewed

@@ -0,0 +1,31 @@
+CREATE TABLE IF NOT EXISTS psyche_flashcards (
+  id TEXT PRIMARY KEY,
+  domain_id TEXT NOT NULL REFERENCES domains(id) ON DELETE CASCADE,
+  title TEXT NOT NULL DEFAULT '',
+  message TEXT NOT NULL,
+  trigger_sentence TEXT NOT NULL DEFAULT '',
+  trigger_situation TEXT NOT NULL DEFAULT '',
+  tags_json TEXT NOT NULL DEFAULT '[]',
+  background_color TEXT NOT NULL DEFAULT '#f8fafc',
+  text_color TEXT NOT NULL DEFAULT '#111827',
+  accent_color TEXT NOT NULL DEFAULT '#6ee7b7',
+  typography TEXT NOT NULL DEFAULT 'serif',
+  image_url TEXT NOT NULL DEFAULT '',
+  image_alt TEXT NOT NULL DEFAULT '',
+  layout TEXT NOT NULL DEFAULT 'centered',
+  visual_style TEXT NOT NULL DEFAULT 'calm',
+  linked_value_ids_json TEXT NOT NULL DEFAULT '[]',
+  linked_behavior_ids_json TEXT NOT NULL DEFAULT '[]',
+  linked_pattern_ids_json TEXT NOT NULL DEFAULT '[]',
+  linked_belief_ids_json TEXT NOT NULL DEFAULT '[]',
+  linked_mode_ids_json TEXT NOT NULL DEFAULT '[]',
+  linked_report_ids_json TEXT NOT NULL DEFAULT '[]',
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_psyche_flashcards_domain_updated
+  ON psyche_flashcards(domain_id, updated_at DESC);
+CREATE INDEX IF NOT EXISTS idx_psyche_flashcards_trigger_sentence
+  ON psyche_flashcards(trigger_sentence);

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

@@ -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, 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 { 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";
@@ -1739,6 +1739,160 @@ const AGENT_ONBOARDING_ENTITY_CATALOG_BASE = [
             }
         ]
     },
+    {
+        entityType: "flashcard",
+        purpose: "A small therapeutic reminder card with a central message, optional title, tags, trigger cue, visual styling, and links to Psyche records.",
+        minimumCreateFields: ["message"],
+        relationshipRules: [
+            "Flashcards are normal stored Psyche entities and should use shared batch CRUD routes.",
+            "Use flashcards when the user wants a brief message to be shown back during an urge, trigger, mode, belief activation, or value reminder.",
+            "Tags, triggerSentence, triggerSituation, and optional title make the card findable; the message is the main therapeutic content."
+        ],
+        searchHints: [
+            "Search by tags, trigger wording, title, message, behavior, belief, pattern, mode, or urge language before creating a duplicate card.",
+            "When the user says they feel an urge, search flashcards first if the urge or trigger may have a prepared card."
+        ],
+        examples: [
+            '{"message":"This urge is a wave. You do not have to obey it; stay with your body for two minutes and choose again.","tags":["urge","sobriety"],"triggerSentence":"I feel the urge to drink","triggerSituation":"Late evening craving after shame or loneliness","visualStyle":"urgent","backgroundColor":"#111827","textColor":"#f8fafc","accentColor":"#6ee7b7"}'
+        ],
+        fieldGuide: [
+            {
+                name: "message",
+                type: "string",
+                required: true,
+                description: "The main sentence or brief therapeutic reminder shown on the card."
+            },
+            {
+                name: "title",
+                type: "string",
+                required: false,
+                description: "Compact optional retrieval title; not the main card content.",
+                defaultValue: ""
+            },
+            {
+                name: "triggerSentence",
+                type: "string",
+                required: false,
+                description: "A user phrase that should retrieve this card, such as an urge sentence.",
+                defaultValue: ""
+            },
+            {
+                name: "triggerSituation",
+                type: "string",
+                required: false,
+                description: "Situation or cue where this card should be shown.",
+                defaultValue: ""
+            },
+            {
+                name: "tags",
+                type: "string[]",
+                required: false,
+                description: "Retrieval tags such as urge, sobriety, shame, critic, or grounding.",
+                defaultValue: []
+            },
+            {
+                name: "backgroundColor",
+                type: "string",
+                required: false,
+                description: "Card background color.",
+                defaultValue: "#f8fafc"
+            },
+            {
+                name: "textColor",
+                type: "string",
+                required: false,
+                description: "Card text color.",
+                defaultValue: "#111827"
+            },
+            {
+                name: "accentColor",
+                type: "string",
+                required: false,
+                description: "Card accent color.",
+                defaultValue: "#6ee7b7"
+            },
+            {
+                name: "typography",
+                type: "serif|sans|mono|display",
+                required: false,
+                description: "Typography style.",
+                enumValues: ["serif", "sans", "mono", "display"],
+                defaultValue: "serif"
+            },
+            {
+                name: "imageUrl",
+                type: "string",
+                required: false,
+                description: "Optional image URL.",
+                defaultValue: ""
+            },
+            {
+                name: "imageAlt",
+                type: "string",
+                required: false,
+                description: "Optional image alt text.",
+                defaultValue: ""
+            },
+            {
+                name: "layout",
+                type: "centered|top_left|image_split|poster",
+                required: false,
+                description: "Flashcard layout style.",
+                enumValues: ["centered", "top_left", "image_split", "poster"],
+                defaultValue: "centered"
+            },
+            {
+                name: "visualStyle",
+                type: "calm|urgent|warm|clinical|playful",
+                required: false,
+                description: "Therapeutic visual tone.",
+                enumValues: ["calm", "urgent", "warm", "clinical", "playful"],
+                defaultValue: "calm"
+            },
+            {
+                name: "linkedValueIds",
+                type: "string[]",
+                required: false,
+                description: "Linked value ids.",
+                defaultValue: []
+            },
+            {
+                name: "linkedBehaviorIds",
+                type: "string[]",
+                required: false,
+                description: "Linked behavior ids.",
+                defaultValue: []
+            },
+            {
+                name: "linkedPatternIds",
+                type: "string[]",
+                required: false,
+                description: "Linked behavior pattern ids.",
+                defaultValue: []
+            },
+            {
+                name: "linkedBeliefIds",
+                type: "string[]",
+                required: false,
+                description: "Linked belief ids.",
+                defaultValue: []
+            },
+            {
+                name: "linkedModeIds",
+                type: "string[]",
+                required: false,
+                description: "Linked mode ids.",
+                defaultValue: []
+            },
+            {
+                name: "linkedReportIds",
+                type: "string[]",
+                required: false,
+                description: "Linked trigger report ids.",
+                defaultValue: []
+            }
+        ]
+    },
     {
         entityType: "trigger_report",
         purpose: "A structured reflective incident report that ties situation, emotions, thoughts, behaviors, consequences, and next moves together.",
@@ -1933,6 +2087,7 @@ const AGENT_ONBOARDING_BATCH_ROUTE_BASES = {
     belief_entry: "/api/v1/psyche/beliefs",
     mode_profile: "/api/v1/psyche/modes",
     mode_guide_session: "/api/v1/psyche/mode-guides",
+    flashcard: "/api/v1/entities/search",
     event_type: "/api/v1/psyche/event-types",
     emotion_definition: "/api/v1/psyche/emotions",
     trigger_report: "/api/v1/psyche/reports",
@@ -2809,7 +2964,7 @@ const AGENT_ONBOARDING_CONVERSATION_RULES = [
     "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.",
-    "Self-observation is not the default container for Psyche material. Use it only for a lightweight observed event note; prefer trigger_report for one emotionally meaningful episode, behavior_pattern for a recurring loop and functional analysis, behavior for one repeated move, belief_entry for a core sentence, mode_guide_session or mode_profile for an active part-state, and wiki_page for durable memory.",
+    "Self-observation is not the default container for Psyche material. Use it only for a lightweight observed event note; prefer trigger_report for one emotionally meaningful episode, behavior_pattern for a recurring loop and functional analysis, behavior for one repeated move, belief_entry for a core sentence, mode_guide_session or mode_profile for an active part-state, flashcard for a brief rehearsable reminder to use during a trigger or urge, and wiki_page for durable memory.",
     "Do not bury schema work in self-observation. If the user is describing a schema theme, preserve it through a belief_entry, behavior_pattern, mode_profile, mode_guide_session, trigger_report, or wiki_page depending on whether it appears as a rule, loop, part-state, live exploration, one episode, or durable explanation.",
     "Do not minimize functional analysis, trigger chains, behavior patterns, modes, beliefs, or schema themes. After at least one concrete example is clear, offer one careful interpretive hypothesis when it would help the user understand what the reaction may be protecting, predicting, relieving, or costing.",
     "Phrase Psyche interpretive hypotheses as collaborative and testable, not as verdicts. Ask whether the hypothesis lands or needs correction before turning it into a saved belief, pattern, mode, trigger report, or note.",
@@ -2969,6 +3124,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 +3171,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?",
@@ -3014,9 +3204,23 @@ const AGENT_ONBOARDING_ENTITY_CONVERSATION_PLAYBOOKS = [
             "Ask what emotion, body signal, thought, or meaning showed up.",
             "Ask what behavior showed up: what the user did, wanted to do, avoided, or repeated next.",
             "Ask what the immediate consequence was, including short-term relief or cost if it is visible.",
-            "Decide whether this should stay a lightweight self-observation or become a trigger_report, behavior_pattern, behavior, belief_entry, mode_profile, mode_guide_session, event_type, emotion_definition, or wiki page.",
+            "Decide whether this should stay a lightweight self-observation or become a trigger_report, behavior_pattern, behavior, belief_entry, mode_profile, mode_guide_session, flashcard, event_type, emotion_definition, or wiki page.",
             "Remember that self-observation is note-backed and should be written through an observed note with frontmatter.observedAt only when a lightweight observation is the right container.",
-            "Do not promote self-observation over functional analysis: use behavior_pattern for recurring loops, trigger_report for one emotionally meaningful episode, mode_guide_session or mode_profile for a central part-state, belief_entry for a central sentence, and wiki_page for durable memory."
+            "Do not promote self-observation over functional analysis: use behavior_pattern for recurring loops, trigger_report for one emotionally meaningful episode, mode_guide_session or mode_profile for a central part-state, belief_entry for a central sentence, flashcard for a rehearsable reminder during an urge or trigger, and wiki_page for durable memory."
+        ]
+    },
+    {
+        focus: "flashcard",
+        openingQuestion: "What exact moment or urge should this card help you meet?",
+        coachingGoal: "Craft a concise therapeutic reminder and retrieval cues before visual styling.",
+        askSequence: [
+            "Ask what moment, urge sentence, or trigger situation should bring this flashcard up.",
+            "Reflect what the card is trying to help the user interrupt, remember, tolerate, or choose.",
+            "Ask for the simple message that should be centered on the card, or offer a concise working sentence if the user's meaning is clearer than the wording.",
+            "Ask for tags and trigger wording before asking for a title, because retrieval matters more than the title.",
+            "Ask for color, typography, image, layout, and visual tone only after the message and retrieval cues are clear.",
+            "Use shared batch CRUD for create, update, delete, restore, and search; flashcard is a normal stored Psyche entity, not a dedicated route family.",
+            "When the user reports an urge or trigger, search flashcards by tags, triggerSentence, triggerSituation, message, title, and linked Psyche records, then show the message first with brief psychotherapy-informed support around it."
         ]
     },
     {
@@ -3500,6 +3704,53 @@ const AGENT_ONBOARDING_PSYCHE_PLAYBOOKS = [
             "Use candidate mode interpretations as testable hypotheses tied to the user's answers, not as certain labels."
         ]
     },
+    {
+        focus: "flashcard",
+        useWhen: "Use when the user wants a small therapeutic reminder card for an urge, trigger sentence, mode activation, belief activation, value reminder, or relapse-prevention moment.",
+        coachingGoal: "Help the user craft one brief, memorable, usable message and enough retrieval cues to find it at the exact moment it matters.",
+        askSequence: [
+            "Start from the moment when the card should be shown, especially the user's own urge sentence or trigger cue.",
+            "Reflect what the card is trying to interrupt, steady, or help the user remember.",
+            "Ask what the card should say in one simple sentence or short message.",
+            "If the message is almost clear, offer one concise therapeutic wording and invite correction.",
+            "Ask for tags and trigger wording before title because retrieval matters more than the title.",
+            "Ask about color, typography, image, or layout only after the message and retrieval cues are clear.",
+            "Link values, behaviors, patterns, beliefs, modes, or reports only when those links will help future retrieval or coaching."
+        ],
+        requiredForCreate: ["message"],
+        highValueOptionalFields: [
+            "triggerSentence",
+            "triggerSituation",
+            "tags",
+            "title",
+            "visualStyle",
+            "backgroundColor",
+            "textColor",
+            "accentColor",
+            "typography",
+            "imageUrl",
+            "linkedBehaviorIds",
+            "linkedPatternIds",
+            "linkedBeliefIds",
+            "linkedModeIds",
+            "linkedValueIds"
+        ],
+        exampleQuestions: [
+            "What exact urge sentence or situation should make this card appear?",
+            "When you are in that moment, what do you most need to remember?",
+            "Should this card interrupt the urge, comfort a part, challenge a belief, or point you back to a value?",
+            "If this were only one sentence on the card, what should it say?",
+            "What tags would help us find it later?",
+            "What visual tone should it have: calm, urgent, warm, clinical, or playful?"
+        ],
+        notes: [
+            "The message is the main content; title is optional and compact.",
+            "Use shared batch entity routes for flashcard create, update, delete, restore, and search.",
+            "When the user says they feel an urge or trigger, search flashcards by triggerSentence, triggerSituation, tags, message, and linked Psyche records before creating a new card.",
+            "When showing a card, display or quote the message first, then add brief grounding, urge-surfing, cognitive defusion, schema-mode, or values-based coaching around it.",
+            "Do not make the user fill styling fields before the therapeutic sentence is clear."
+        ]
+    },
     {
         focus: "trigger_report",
         useWhen: "Use for one specific emotionally meaningful incident that should be mapped from situation through emotions, thoughts, behaviors, consequences, and next moves.",
@@ -3619,12 +3870,14 @@ function buildPlaybookRouteInfo(focus) {
     const guide = AGENT_ONBOARDING_ENTITY_CATALOG.find((entry) => entry.entityType === focus);
     const routePosture = guide?.classification ?? classifyOnboardingEntity(focus);
     const apiAccessHint = [
+        `Focus: ${focus}.`,
         `Route posture: ${routePosture}.`,
         guide?.preferredMutationPath
             ? `Mutation: ${guide.preferredMutationPath}.`
             : null,
         guide?.preferredReadPath ? `Read: ${guide.preferredReadPath}.` : null,
-        guide?.preferredMutationTool ? `Tool: ${guide.preferredMutationTool}.` : null
+        guide?.preferredMutationTool ? `Tool: ${guide.preferredMutationTool}.` : null,
+        `Entity type: ${focus}.`
     ]
         .filter(Boolean)
         .join(" ");
@@ -4223,7 +4476,7 @@ function buildAgentOnboardingPayload(request) {
             movement: "Forge Movement is the first-class mobility surface. It is a timeline of stays and trips: stays capture time spent in the same place, and trips capture travel between places. Use it for time-in-place questions, travel-history review, specific stay or trip edits, selected-span aggregates, known places, and links to other Forge records rather than pretending stays and trips are normal batch CRUD entities.",
             lifeForce: "Life Force is Forge's energy-budget and fatigue model. Read it through the dedicated life-force payload and update it through focused profile, weekday-template, and fatigue-signal routes rather than generic entity CRUD.",
             workbench: "Workbench is Forge's graph-flow execution system. Treat flows, runs, published outputs, node results, and latest-node-output reads as a dedicated API family instead of a normal entity-batch surface.",
-            psyche: "Forge Psyche is the reflective domain for values, patterns, behaviors, beliefs, modes, and trigger reports. It is sensitive and should be handled deliberately."
+            psyche: "Forge Psyche is the reflective domain for values, patterns, behaviors, beliefs, modes, flashcards, and trigger reports. It is sensitive and should be handled deliberately."
         },
         psycheSubmoduleModel: {
             value: "A value is the direction the user wants to move toward. Values orient action and can link back to goals, projects, tasks, and Psyche records.",
@@ -4233,6 +4486,7 @@ function buildAgentOnboardingPayload(request) {
             schemaCatalog: "The schema catalog is the reference taxonomy of maladaptive and adaptive schemas. Belief entries can optionally point to one schema by schemaId, but the schema catalog is not itself the user's belief record.",
             modeProfile: "A mode profile is a durable description of a recurring part-state or strategy, including family, fear, burden, protective job, and origin context.",
             modeGuideSession: "A mode guide session is the guided reasoning worksheet that stores answers and candidate mode interpretations before or alongside a durable mode profile.",
+            flashcard: "A flashcard is a small therapeutic reminder card. It has one main message, optional title, tags, trigger cue, visual styling, optional image, and links to Psyche records so agents can retrieve and show it during urges or triggering situations.",
             eventType: "An event type is reusable incident taxonomy for trigger reports, such as criticism, conflict, rupture, or overload.",
             emotionDefinition: "An emotion definition is reusable emotion vocabulary for trigger reports. Reports can either reference one or fall back to raw labels.",
             triggerReport: "A trigger report is the one-episode incident chain: situation, emotions, thoughts, behaviors, consequences, extra mode labels, schema themes, and next moves."
@@ -4253,7 +4507,7 @@ function buildAgentOnboardingPayload(request) {
             "Task runs represent live work sessions on tasks and are separate from task status.",
             "Notes can link to one or many entities and are the canonical place for Markdown progress context or close-out evidence.",
             "Psyche values can link to goals, projects, and tasks.",
-            "Behavior patterns, behaviors, beliefs, modes, and trigger reports cross-link to describe one reflective model rather than isolated records.",
+            "Behavior patterns, behaviors, beliefs, modes, flashcards, and trigger reports cross-link to describe one reflective model rather than isolated records.",
             "Insights can point at one entity, but they exist to capture interpretation or advice rather than raw work items."
         ],
         entityRouteModel: {
@@ -4275,6 +4529,7 @@ function buildAgentOnboardingPayload(request) {
                 "belief_entry",
                 "mode_profile",
                 "mode_guide_session",
+                "flashcard",
                 "event_type",
                 "emotion_definition",
                 "trigger_report",
@@ -4592,7 +4847,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: {
@@ -6355,6 +6611,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;
@@ -6364,20 +6622,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",
@@ -6401,13 +6663,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 : {}),
@@ -7343,7 +7617,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) => {