forge-openclaw-plugin 0.2.94 → 0.2.97

package/dist/server/server/src/openapi.js

@@ -5178,6 +5178,8 @@ export function buildOpenApiDocument() {
             "recentIntensityDistribution",
             "dailyLoad",
             "weeklyLoad",
+            "zoneTimeSeries",
+            "trainingIntelligence",
             "activityBreakdown",
             "vitalsTrend",
             "sessionSignals",
@@ -5197,6 +5199,17 @@ export function buildOpenApiDocument() {
             }),
             dailyLoad: arrayOf({ type: "object", additionalProperties: true }),
             weeklyLoad: arrayOf({ type: "object", additionalProperties: true }),
+            zoneTimeSeries: {
+                type: "object",
+                additionalProperties: false,
+                required: ["daily", "weekly", "monthly"],
+                properties: {
+                    daily: arrayOf({ type: "object", additionalProperties: true }),
+                    weekly: arrayOf({ type: "object", additionalProperties: true }),
+                    monthly: arrayOf({ type: "object", additionalProperties: true })
+                }
+            },
+            trainingIntelligence: { type: "object", additionalProperties: true },
             activityBreakdown: arrayOf({ type: "object", additionalProperties: true }),
             vitalsTrend: arrayOf({ type: "object", additionalProperties: true }),
             sessionSignals: arrayOf({ type: "object", additionalProperties: true }),

package/dist/server/server/src/web.js

@@ -270,6 +270,12 @@ async function proxyDevWebSocket(input) {
         }
     });
     proxyRequest.on("upgrade", (response, proxySocket, proxyHead) => {
+        const closeBothSockets = () => {
+            proxySocket.destroy();
+            input.socket.destroy();
+        };
+        proxySocket.on("error", closeBothSockets);
+        input.socket.on("error", closeBothSockets);
         writeProxyUpgradeResponse(input.socket, response);
         if (proxyHead.length > 0) {
             input.socket.write(proxyHead);

package/dist/server/src/components/ui/info-tooltip.js

@@ -3,9 +3,9 @@ import { useEffect, useId, useRef, useState } from "react";
 import { CircleHelp } from "lucide-react";
 import { cn } from "../../lib/utils.js";
 export function FieldHint({ children, className }) {
-    return _jsx("div", { className: cn("text-sm leading-6 text-white/50", className), children: children });
+    return (_jsx("div", { className: cn("text-sm leading-6 text-white/50", className), children: children }));
 }
-export function InfoTooltip({ content, label = "Explain this field", className }) {
+export function InfoTooltip({ content, title, label = "Explain this field", className, panelClassName }) {
     const [open, setOpen] = useState(false);
     const containerRef = useRef(null);
     const tooltipId = useId();
@@ -21,5 +21,9 @@ export function InfoTooltip({ content, label = "Explain this field", className }
         document.addEventListener("pointerdown", handlePointerDown);
         return () => document.removeEventListener("pointerdown", handlePointerDown);
     }, [open]);
-    return (_jsxs("span", { ref: containerRef, className: cn("relative inline-flex items-center", className), onMouseEnter: () => setOpen(true), onMouseLeave: () => setOpen(false), children: [_jsx("button", { type: "button", "aria-label": label, "aria-describedby": open ? tooltipId : undefined, "aria-expanded": open, className: "inline-flex size-5 items-center justify-center rounded-full text-white/42 transition hover:bg-white/[0.06] hover:text-white/78 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[rgba(192,193,255,0.35)]", onFocus: () => setOpen(true), onBlur: () => setOpen(false), onClick: () => setOpen((current) => !current), children: _jsx(CircleHelp, { className: "size-3.5" }) }), _jsx("span", { id: tooltipId, role: "tooltip", className: cn("pointer-events-none absolute right-0 top-[calc(100%+0.55rem)] z-40 w-[min(16rem,calc(100vw-2.5rem))] max-w-[calc(100vw-2.5rem)] rounded-[18px] border border-white/8 bg-[rgba(12,17,30,0.96)] px-3 py-2.5 text-sm leading-6 text-white/74 shadow-[0_18px_48px_rgba(3,8,18,0.42)] transition", open ? "translate-y-0 opacity-100" : "translate-y-1 opacity-0"), children: content })] }));
+    return (_jsxs("span", { ref: containerRef, className: cn("relative inline-flex items-center", className), onMouseEnter: () => setOpen(true), onMouseLeave: () => setOpen(false), children: [_jsx("button", { type: "button", "aria-label": label, "aria-describedby": open ? tooltipId : undefined, "aria-expanded": open, className: "inline-flex size-5 items-center justify-center rounded-full text-white/42 transition hover:bg-white/[0.06] hover:text-white/78 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[rgba(192,193,255,0.35)]", onFocus: () => setOpen(true), onBlur: () => setOpen(false), onClick: () => setOpen((current) => !current), onKeyDown: (event) => {
+                    if (event.key === "Escape") {
+                        setOpen(false);
+                    }
+                }, children: _jsx(CircleHelp, { className: "size-3.5" }) }), _jsxs("span", { id: tooltipId, role: "tooltip", "aria-hidden": !open, "data-state": open ? "open" : "closed", className: cn("pointer-events-none absolute right-0 top-[calc(100%+0.55rem)] z-40 grid w-[min(20rem,calc(100vw-2.5rem))] max-w-[calc(100vw-2.5rem)] gap-1 rounded-[8px] border border-white/10 bg-[rgba(12,17,30,0.97)] px-3 py-2.5 text-left text-sm leading-6 text-white/74 shadow-[0_18px_48px_rgba(3,8,18,0.42)] transition", open ? "translate-y-0 opacity-100" : "translate-y-1 opacity-0", panelClassName), children: [title ? (_jsx("span", { className: "text-[11px] font-semibold uppercase tracking-[0.14em] text-white/58", children: title })) : null, _jsx("span", { children: content })] })] }));
 }

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.94",
+  "version": "0.2.97",
   "activation": {
     "onStartup": true,
     "onCapabilities": [

package/package.json

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

package/skills/forge-openclaw/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: forge-openclaw-plugin
-description: use when the user wants to save, search, update, review, start, stop, reward, explain, compare, or run Forge records, or when the conversation is clearly about a Forge entity or domain surface such as a goal, project, strategy, task, habit, note, wiki_page, calendar_event, calendar_connection, work_block_template, task_timebox, task_run, work_adjustment, insight, preference item, preference context, preference catalog, preference judgment, preference signal, questionnaire instrument, questionnaire run, self observation, movement, life_force, workbench, psyche_value, behavior_pattern, behavior, belief_entry, mode_profile, mode_guide_session, flashcard, trigger_report, event_type, emotion_definition, sleep_session, or workout_session. identify the exact Forge object or specialized surface, keep the main conversation natural, guide psyche intake with active listening before storing it, and for psyche issues that need understanding first usually begin with one exploratory question before any formulation or save suggestion.
+description: use when the user wants to save, search, update, review, start, stop, reward, explain, compare, or run Forge records, or when the conversation is clearly about a Forge entity or domain surface such as a goal, project, strategy, task, habit, note, wiki_page, calendar_event, calendar_connection, work_block_template, task_timebox, task_run, work_adjustment, insight, preference item, preference context, preference catalog, preference judgment, preference signal, questionnaire instrument, questionnaire run, self observation, movement, life_force, workbench, psyche_value, behavior_pattern, behavior, belief_entry, mode_profile, mode_guide_session, flashcard, trigger_report, event_type, emotion_definition, sleep_session, workout_session, or training_load. identify the exact Forge object or specialized surface, keep the main conversation natural, guide psyche intake with active listening before storing it, and for psyche issues that need understanding first usually begin with one exploratory question before any formulation or save suggestion.
 ---
 
 Forge is the user's structured system for planning work, doing work, reflecting on patterns, and keeping a truthful record of what is happening. Use it when the user is clearly working inside that system, or when they are describing something that naturally belongs there and would benefit from being stored, updated, reviewed, or acted on in Forge. Keep the conversation natural first. Do not turn every message into intake. When a real Forge entity is clearly present, name the exact entity type plainly, help with the substance of the conversation, and then offer Forge once, lightly, if storing it would genuinely help.
@@ -59,7 +59,7 @@ PM surface rule:
   human/bot ownership filters.
 - Guided modal flows handle create, edit, move, link, and closeout actions.
 
-Forge has four major stored-entity surfaces and three specialized domain surfaces. The planning side covers goals, projects, strategies, tasks, habits, notes, calendar events, recurring work blocks, task timeboxes, live work sessions, and agent-authored insights. The Health side covers sleep sessions, sports and workout sessions, companion pairing, and habit-generated workout records that should still stay linked to the broader Forge graph. The Preferences side covers contextual taste modeling, pairwise comparisons, direct signals, editable concept libraries, and preference items that can come from Forge entities or seeded concept domains such as food, activities, places, countries, fashion, people, media, and tools. The Psyche side covers values, patterns, behaviors, beliefs, modes, guided mode sessions, flashcards, trigger reports, event types, and reusable emotion definitions. The specialized domain surfaces are Movement, Life Force, and Workbench; agents must use their dedicated route families instead of forcing them through batch CRUD. Forge also has a SQLite-backed Wiki memory layer with explicit spaces, Markdown content in database rows, backlinks, optional embeddings, and structured links back to Forge entities. Forge is also multi-user: every entity can belong to a typed `human` or `bot` user through `userId`, and read routes can scope to one or many users with `userId` or repeated `userIds`. The current access posture is configurable through a directional user graph, but the live default is still permissive: Forge can list users directly, every relationship edge starts open, and a user can read or affect another user's linked records when the route explicitly asks for them. Use `forge_get_user_directory` when owner identity or cross-user access matters. Strategies can also be locked into a contract with `isLocked`; once locked, do not mutate the graph or target structure unless the user explicitly wants the strategy unlocked first. The model should use the real entity names, not vague substitutes. Say `project`, not “initiative”. Say `behavior_pattern`, not “theme”. Say `trigger_report`, not “incident note”.
+Forge has four major stored-entity surfaces and three specialized domain surfaces. The planning side covers goals, projects, strategies, tasks, habits, notes, calendar events, recurring work blocks, task timeboxes, live work sessions, and agent-authored insights. The Health side covers sleep sessions, sports and workout sessions, the read-only training-load surface for cardiovascular load and HR zone review, companion pairing, and habit-generated workout records that should still stay linked to the broader Forge graph. The Preferences side covers contextual taste modeling, pairwise comparisons, direct signals, editable concept libraries, and preference items that can come from Forge entities or seeded concept domains such as food, activities, places, countries, fashion, people, media, and tools. The Psyche side covers values, patterns, behaviors, beliefs, modes, guided mode sessions, flashcards, trigger reports, event types, and reusable emotion definitions. The specialized domain surfaces are Movement, Life Force, and Workbench; agents must use their dedicated route families instead of forcing them through batch CRUD. Forge also has a SQLite-backed Wiki memory layer with explicit spaces, Markdown content in database rows, backlinks, optional embeddings, and structured links back to Forge entities. Forge is also multi-user: every entity can belong to a typed `human` or `bot` user through `userId`, and read routes can scope to one or many users with `userId` or repeated `userIds`. The current access posture is configurable through a directional user graph, but the live default is still permissive: Forge can list users directly, every relationship edge starts open, and a user can read or affect another user's linked records when the route explicitly asks for them. Use `forge_get_user_directory` when owner identity or cross-user access matters. Strategies can also be locked into a contract with `isLocked`; once locked, do not mutate the graph or target structure unless the user explicitly wants the strategy unlocked first. The model should use the real entity names, not vague substitutes. Say `project`, not “initiative”. Say `behavior_pattern`, not “theme”. Say `trigger_report`, not “incident note”.
 Habits are a first-class recurring entity in the planning side.
 NEGATIVE HABIT CHECK-IN RULE: for a `negative` habit, the correct aligned/resisted outcome is `missed`. `missed` means the bad habit was resisted, the user stayed aligned, and the habit should award its XP bonus.
 
@@ -239,6 +239,7 @@ Entity conversation rule:
 - 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.
+- Treat questionnaire runs, self-observations, reflective notes, wiki pages, sleep/workout enrichment, and preference signals as reflection-sensitive records: ask what the record should help the user understand, decide, notice, remember, or change later, then choose the right route. Do not flatten them into forms, but also do not automatically turn them into full Psyche intake unless a belief, mode, trigger report, or behavior pattern clearly emerges.
 - The quick intake prompts later in this file are fallback checkpoints, not a script to read aloud.
 
 Forge data location rule:
@@ -681,10 +682,10 @@ Use the health tools when the request is about sleep or sports review:
 
 - `forge_get_sleep_overview` to inspect recent nights, averages, regularity, stage breakdown, and linked reflective context
 - `forge_get_sports_overview` to inspect training volume, workout types, effort trends, habit-generated sessions, and linked context
-- `forge_get_training_load_overview` to inspect cardiovascular load, HR zone balance, acute/chronic stress, high-intensity pressure, VO2max context, and training target fit
+- `forge_get_training_load_overview` to inspect cardiovascular load, HR zone balance, zone-time buckets, smart training modes, acute/chronic stress, high-intensity pressure, VO2max context, next-workout guidance, and training target fit
 - `forge_update_sleep_session` to add sleep-quality notes, tags, or links back to Forge entities after review
 - `forge_update_workout_session` to add subjective effort, mood, meaning, tags, or links on one workout after review
-- remember that the UI route is `/sports` while the backend overview route is `/api/v1/health/fitness`; the dedicated training-load UI is `/training-load` and its backend route is `/api/v1/health/training-load`
+- remember that the UI route is `/sports` while the backend overview route is `/api/v1/health/fitness`; the dedicated training-load UI is `/training-load` and its backend route is `/api/v1/health/training-load`, including zone-time reporting and Combat/Base/Endurance smart modes
 
 Use these exact health batch payload shapes when the user is creating or editing the stored records themselves:
 

package/skills/forge-openclaw/entity_conversation_playbooks.md

@@ -158,6 +158,42 @@ to the stronger container:
 - Use a linked `note` when nuance should be preserved without pretending it is the
   whole structured model.
 
+## Reflection-sensitive non-Psyche records
+
+Use this when the user is creating or updating a reflective record that is meaningful
+but not necessarily a full Psyche formulation: `questionnaire_instrument`,
+`questionnaire_run`, `self_observation`, reflective `note`, `wiki_page`,
+`sleep_session`, `workout_session`, and some `preference_judgment` or
+`preference_signal` moments.
+
+- Start by asking what the reflection should help the user understand, decide,
+  notice, remember, or change later.
+- Reflect the lived or practical stake once before asking for fields, but do not
+  over-therapize if the user is only trying to store a clear answer, note, or
+  health-context update.
+- For questionnaire instruments, ask what kind of honest moment, review, or decision
+  the instrument should reveal before asking for item wording, scales, scoring, or
+  provenance.
+- For questionnaire runs, ask whether the user is trying to start, continue, review,
+  or complete the run, then focus on the next answer, uncertainty, or insight that
+  changes the run. Do not turn answer collection into generic Psyche intake unless a
+  belief, mode, trigger report, or behavior pattern clearly emerges.
+- For self-observation, keep the chain concrete: situation, cue, emotion/body,
+  thought/meaning, behavior/urge, and consequence. If that chain reveals a recurring
+  loop, belief, mode, schema theme, or one charged trigger episode, route to the
+  stronger Psyche container.
+- For sleep and workout enrichment, ask what the user wants future review to remember:
+  recovery context, subjective effort, mood, meaning, social context, or links.
+  Preserve raw health facts through the health model and store reflection as notes,
+  tags, links, or batch updates.
+- For notes and wiki pages, distinguish temporary operating context from durable
+  memory. A note can preserve nuance around another record; a wiki page should carry
+  reusable knowledge, source synthesis, person/context memory, or a personal manual.
+- Route posture still matters: `questionnaire_instrument`, `note`, `sleep_session`,
+  and `workout_session` use shared batch routes for normal CRUD; `questionnaire_run`
+  uses questionnaire run actions; `self_observation` is note-backed; `wiki_page` uses
+  the wiki routes.
+
 ## Conversation arc
 
 Most good Forge intake flows follow this sequence:
@@ -1393,10 +1429,11 @@ Route note:
 - `sports_overview` is a read-model-only surface. Use `forge_get_sports_overview` or
   `/api/v1/health/fitness` for session review. Do not create, update, or delete
   `sports_overview` through batch CRUD.
-- For cardiovascular load, HR zone distribution, acute/chronic load, VO2max
-  context, or training target questions, use `forge_get_training_load_overview`
-  or `/api/v1/health/training-load`. Treat `training_load` as read-model-only,
-  not a batch CRUD entity.
+- For cardiovascular load, HR zone distribution, zone-time by week/month/day,
+  acute/chronic load, VO2max context, smart training modes, 4x4 suitability,
+  next-workout guidance, or training target questions, use
+  `forge_get_training_load_overview` or `/api/v1/health/training-load`. Treat
+  `training_load` as read-model-only, not a batch CRUD entity.
 - If the review reveals that one workout needs reflective context, switch to the
   stored `workout_session` batch route or reflective update helper for that known
   session.