@pulsarinteractive/geniusfitness 0.1.0-beta.3 → 0.1.0-beta.5

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.1.0-beta.5 — 2026-10-24
+
+- Add session analysis with measured time per set and exercise, real rest and missing-data coverage.
+- Page large session details with revision-checked continuation.
+- Improve progress-review guidance and distinguish timer intervals from physical effort.
+- Keep operational quota tables out of routine MCP introductions while preserving server controls.
+
+## 0.1.0-beta.4 — 2026-10-23
+
+- Add on-demand workflow guides to hosted and local MCP and `workflow show` to the CLI.
+- Correct hosted archive filters to the API values `active`, `archived` and `all`.
+- Explain remote immutable-command recovery separately from the local operation journal.
+- Expand connection, permissions, product workflows and live application update documentation.
+
 ## 0.1.0-beta.3
 
 - Explain shared account quotas across CLI, local MCP and ChatGPT.

package/docs/CHATGPT.md

@@ -48,3 +48,41 @@ Editing another athlete’s program requires the Coach subscription, explicit co
 - The public tool catalogue is in [`remote/tool-catalog.json`](../remote/tool-catalog.json). Tools are described separately from private backend implementation.
 
 A custom connection is separate from an OpenAI directory listing. See [official publication](OPENAI_PUBLICATION.md). The CLI and local MCP remain supported independently.
+
+## If the connection only allows reading
+
+1. Open this app’s settings in ChatGPT and choose **Refresh tools** when available.
+2. Choose **Reconnect** for the connected account. Check that the correct account
+   appears on the product consent screen.
+3. The requested permissions are selected by default. Keep the ones you want,
+   including editing, then authorize. Explicitly restricted connections stay
+   restricted; old grants are never silently expanded.
+4. Ask the assistant to read its **identity** and **capabilities** again. Confirm
+   that the required permissions and write commands appear before requesting an edit.
+
+A new conversation may be needed after the tool catalogue changes. A CLI login
+is a separate connection and does not update ChatGPT’s permissions.
+
+## Guides available to the assistant
+
+The connector includes a `fitness_workflow` tool. Ask it for the relevant guide
+before an unfamiliar operation. These are reviewed instructions served directly
+by the connector; custom ChatGPT connections do not automatically install the
+skill files from this repository.
+
+See [supported workflows](WORKFLOWS.md) for examples and boundaries, and
+[CLI setup](CLI.md) for a terminal or local MCP connection. The local CLI can also
+show a guide without downloading account data:
+
+```sh
+geniusfitness workflow show --topic mutations --json
+```
+
+## See changes in the application
+
+An accepted connector command changes the same data used by the application.
+The open application’s normal realtime subscription receives a version hint and
+loads the canonical change. When reconnecting after a network interruption, the
+application catches up through its existing sync system. A server receipt and a
+screen update are different observations: the assistant should verify the changed
+record, and should not claim to have seen your screen unless it actually did.

package/docs/OPENAI.md

@@ -5,3 +5,17 @@ Use [the hosted ChatGPT connection guide](CHATGPT.md) for a remote OAuth MCP con
 For terminal-based agents, the existing local MCP configuration and skills remain available; see [integrations](INTEGRATIONS.md). Local filesystem features remain local.
 
 Public directory publication is a separate review: [submission checklist](OPENAI_PUBLICATION.md). A custom plugin is not a directory approval or an OpenAI endorsement.
+
+### Reconnecting with edit permissions
+
+The remote catalogue exposes permission-specific read and edit tools. This lets
+ChatGPT request the permissions needed for tasks, planning and other supported
+actions when linking or reconnecting an account. Consent remains editable;
+selecting fewer permissions keeps the connection restricted. Coach tools also
+require the Coach subscription and explicit access to the athlete's program.
+
+Older linked accounts may have only read permissions. Refresh the plugin tools
+and reconnect if editing permissions are missing; verify the connected account
+and capabilities before working. Reconnection never bypasses account quotas.
+The generic read/execute entry points remain for existing clients; new workflows
+should prefer the permission-specific tools after preparing an immutable command.

package/docs/PROGRESS.md

@@ -0,0 +1,46 @@
+# Understand a training session
+
+Ask ChatGPT: “Compare my recent squat sessions. Check the time spent on each set
+and my rests before interpreting the total duration.”
+
+The connector can read a specific recorded session through
+`fitness_session_analysis`. The CLI equivalent is:
+
+```sh
+geniusfitness sessions analyze --scope project:PROGRAM_ID --id SESSION_ID --json
+```
+
+Find real session IDs in the program's `sessions` collection. Exercise IDs refer
+to your exercise library; reuse the catalogue identity when comparing movements.
+
+| Information               | Meaning                                                                                       |
+| ------------------------- | --------------------------------------------------------------------------------------------- |
+| Recorded session duration | Duration saved by the application; separate from the wall-clock span                          |
+| Set elapsed time          | Time recorded by the set timer; it may include interruptions                                  |
+| Actual rest               | Measured rest following that set, when recorded                                               |
+| Target rest               | The planned rest, which is not a measurement                                                  |
+| Completion time           | When the set was marked complete                                                              |
+| Timing coverage           | Number of completed sets with a measurement versus eligible completed sets                    |
+| Long timer observation    | A set or rest timer reached ten minutes; a reason to ask for context, not proof of an absence |
+
+Missing time is reported as `null`; a measured zero stays zero. Disabled timing,
+skipped sets and corrections remain distinct. Old sessions are not filled with
+invented measurements. An exercise's duration value is not substituted for a
+missing elapsed timer.
+
+Set details page at 50 entries. Continue with `nextSetOffset` as `offset` and the
+same `revision`. If the session changes, restart the read. Exercise totals and
+coverage describe the recorded session; one page is not the whole set inventory.
+
+```sh
+geniusfitness sessions analyze --scope project:PROGRAM_ID --id SESSION_ID \
+  --offset 50 --revision REVISION --json
+```
+
+This requires `metrics:read` and current access to the program. Coach access is
+limited to shared programs and does not include an athlete's private health.
+Historical Watch BPM is not part of this session analysis. A live watch display
+does not mean that a heart-rate time series was saved or shared with the agent.
+
+Operational limits are enforced by the service. Ordinary training reviews focus
+on your question; a service refusal remains explicit when it prevents an action.

package/docs/WORKFLOWS.md

@@ -0,0 +1,36 @@
+# GeniusFitness workflows
+
+| What you want                          | Guide topic  | Operations                                                                                                                      |
+| -------------------------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------- |
+| Find a movement or create a custom one | `catalogue`  | Search catalogue; reuse/import an exercise; create, update or delete a custom exercise; maintain workout slots and instructions |
+| Plan training                          | `planning`   | Create/update/delete programs, workout templates, individual planning entries, recurring schedules and goals                    |
+| Review recent performances             | `progress`   | Daily totals and targeted session analysis with per-set timing, rest and measurement coverage                                   |
+| Read or record measurements            | `progress`   | Your stored personal health records, with separate consent                                                                      |
+| Work with a student                    | `coaching`   | Shared program workouts, planning and results, with Coach, coaching permission and current membership                           |
+| Recover an interrupted edit            | `mutations`  | Preserve the exact request; read back; reconcile a revision conflict                                                            |
+| Connect or fix missing permissions     | `connection` | Correct account, consent and reconnect                                                                                          |
+
+Use `fitness_workflow` in MCP or `geniusfitness workflow show --topic TOPIC`.
+Use command help for current field types rather than copying guessed payloads.
+For timing and measurement coverage, see [Understand a training session](PROGRESS.md).
+
+## Example requests
+
+- “Find a catalogue squat variation using dumbbells and add it to my Tuesday workout.”
+- “Create a custom exercise for this movement, with three sets of eight and 90 seconds rest.”
+- “Move my recurring training from Thursday to Saturday, keeping my timezone.”
+- “Compare my recorded sessions over the last four weeks.”
+- “Show my recent stored weight measurements.”
+- “As coach, update the workout in the program my student shared with me.”
+
+## Boundaries that remain important
+
+The athlete must share the program through the application. Coach access never
+exposes another account’s private health or personal exercise library. The
+connector reads stored health measurements; it does not connect directly to
+Apple Health on a phone. A completed session is a fact, not a planning template.
+Deleting the final finished result can reopen its linked plan under ordinary task
+permissions. Read back affected planning after that operation.
+
+Writes do not manage subscriptions, billing or permission grants. The account’s
+[limits](LIMITS.md) apply across ChatGPT, CLI and local MCP together.

package/examples/codex.toml

@@ -1,3 +1,3 @@
 [mcp_servers.geniusfitness]
 command = "npx"
-args = ["-y", "@pulsarinteractive/geniusfitness@0.1.0-beta.3", "mcp", "--context", "work"]
+args = ["-y", "@pulsarinteractive/geniusfitness@0.1.0-beta.5", "mcp", "--context", "work"]

package/examples/mcp.json

@@ -2,7 +2,7 @@
   "mcpServers": {
     "geniusfitness": {
       "command": "npx",
-      "args": ["-y", "@pulsarinteractive/geniusfitness@0.1.0-beta.3", "mcp", "--context", "work"]
+      "args": ["-y", "@pulsarinteractive/geniusfitness@0.1.0-beta.5", "mcp", "--context", "work"]
     }
   }
 }

package/mcp.json

@@ -4,7 +4,7 @@
     "geniusfitness": {
       "type": "stdio",
       "command": "npx",
-      "args": ["-y", "@pulsarinteractive/geniusfitness@0.1.0-beta.3", "mcp", "--context", "work"]
+      "args": ["-y", "@pulsarinteractive/geniusfitness@0.1.0-beta.5", "mcp", "--context", "work"]
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pulsarinteractive/geniusfitness",
-  "version": "0.1.0-beta.3",
+  "version": "0.1.0-beta.5",
   "private": false,
   "description": "GeniusFitness CLI and MCP for training plans, exercise catalogues and progress",
   "type": "module",

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "geniusfitness",
-  "version": "0.1.0-beta.3",
+  "version": "0.1.0-beta.5",
   "description": "Manage training plans, exercise catalogues and activity progress with your own agents.",
   "author": {
     "name": "Pulsar Interactive"