@pi-unipi/trajectory 2.10.0 → 2.10.2

package/README.md

@@ -11,6 +11,10 @@ Live, localhost-only UniPi trajectory inspector for the current Pi session.
 /unipi:trajectory toggle      # open when stopped, stop when running
 ```
 
+Typing `/unipi:trajectory` followed by a space auto-completes the available
+actions (`stop`, `off`, `toggle`), so the options are discoverable without
+reading the docs. Running it with no argument opens or reuses the server.
+
 The command starts or reuses an in-process server on `127.0.0.1:8176-8186` and opens it in the default browser. The page follows the active session every 500 ms. The server is owned by the current Pi process and is stopped on any Pi session shutdown/reload/resume/new/fork event.
 
 ## What it shows

package/index.ts

@@ -18,6 +18,28 @@ export default function trajectory(pi: ExtensionAPI): void {
 
   pi.registerCommand("unipi:trajectory", {
     description: "Open or manage UniPi's live trajectory for the current session",
+    getArgumentCompletions: (argumentPrefix: string) => {
+      const prefix = argumentPrefix.trim().toLowerCase();
+      const actions = [
+        { value: "stop", label: "stop", description: "Stop this session's trajectory server" },
+        { value: "off", label: "off", description: "Alias of stop" },
+        { value: "toggle", label: "toggle", description: "Open when stopped, stop when running" },
+      ];
+      const matches = prefix
+        ? actions.filter((a) => a.value.startsWith(prefix) || a.label.startsWith(prefix))
+        : actions;
+      // With no prefix (or a matching one) also surface a hint that running bare
+      // opens/reuses the server, so users learn the default behavior exists.
+      const items = matches.map((a) => ({ value: a.value, label: a.label, description: a.description }));
+      if (!prefix) {
+        items.unshift({
+          value: "",
+          label: "(no argument)",
+          description: "Open or reuse the trajectory server in the browser",
+        });
+      }
+      return items;
+    },
     handler: async (args, ctx) => {
       const action = String(args ?? "").trim().toLowerCase();
       const wantsStop = ["stop", "off", "--stop", "--off"].includes(action);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/trajectory",
-  "version": "2.10.0",
+  "version": "2.10.2",
   "description": "Live UniPi trajectory inspector for Pi sessions",
   "type": "module",
   "main": "index.ts",