@pulsarinteractive/geniusfitness 0.1.0-beta.2 → 0.1.0-beta.4

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 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.
+- Guide assistants to use the user’s language and preserve existing record text.
+- Clarify ambiguous planning dates and consent-language behavior.
+
 ## 0.1.0-beta.2
 
 - Add the remote ChatGPT tool catalogue and OAuth connection guide.

package/docs/CHATGPT.md

@@ -25,6 +25,12 @@ Use **read-only permissions** if you only want summaries. Write access does not
 
 Disconnecting the plugin in ChatGPT removes its use there. Also revoke its dedicated connection from GeniusFitness's agent settings to invalidate its delegated sessions. Reconnecting requires consent again. This connector never needs your OpenAI API key.
 
+## Language and shared limits
+
+Ask in your preferred language. The assistant should explain results and errors in that language while preserving existing record text, IDs and API field values. The consent screen supports French and English; ChatGPT’s supported locale hint selects the screen language, with the browser language as fallback. Confirm dates and timezones when they are ambiguous.
+
+CLI, local MCP and hosted ChatGPT use the verified account’s current subscription and shared request/write counters. New connections, profiles or refreshed tokens do not grant a new budget. Protocol discovery and command preparation also count as requests; a tool operation can involve more than one request. Resource capacity and Coach access remain enforced by the same domain commands. A rate-limit response includes retry guidance: wait rather than switching tools or starting an automatic retry loop.
+
 ## Examples
 
 - “Use GeniusFitness to show my training plan for this week.”
@@ -42,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/WORKFLOWS.md

@@ -0,0 +1,35 @@
+# 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`   | Bounded daily totals, completed sessions and runs; create/update/delete actual results                                          |
+| 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, reconnect and shared quota                                                                            |
+
+Use `fitness_workflow` in MCP or `geniusfitness workflow show --topic TOPIC`.
+Use command help for current field types rather than copying guessed payloads.
+
+## 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.2", "mcp", "--context", "work"]
+args = ["-y", "@pulsarinteractive/geniusfitness@0.1.0-beta.4", "mcp", "--context", "work"]

package/examples/mcp.json

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

package/mcp.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pulsarinteractive/geniusfitness",
-  "version": "0.1.0-beta.2",
+  "version": "0.1.0-beta.4",
   "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.2",
+  "version": "0.1.0-beta.4",
   "description": "Manage training plans, exercise catalogues and activity progress with your own agents.",
   "author": {
     "name": "Pulsar Interactive"