@franzzemen/brokenstock-shell 0.7.0 → 0.7.1

package/fesm2022/franzzemen-brokenstock-shell.mjs

@@ -2916,7 +2916,10 @@ class CommandService {
             return notLoggedIn();
         }
         if (hasHelp) {
-            return { success: true, message: def.usage, timestamp: new Date(), isHelp: true };
+            // `help <command>` is normalised to `<command> help` above, so this is
+            // the one place a command's usage is shown; the screen it works on goes
+            // here (D31).
+            return { success: true, message: def.usage + this.#whereNote(def.scope), timestamp: new Date(), isHelp: true };
         }
         // Screen gate (trades-tree.prd.md D30). A command bound to state only one
         // screen sets is refused off that screen with the screen named, the way
@@ -2961,8 +2964,11 @@ class CommandService {
         // user decides whether it's worth unlocking. The gate is noted, not enforced.
         const availability = def.isAvailable?.();
         const note = availability && !availability.ok ? `\n\nCurrently unavailable — ${availability.reason}` : '';
-        const where = def.scope === 'global' ? '' : `\n\nWorks on ${def.scope.screen}.`;
-        return { success: true, message: def.usage + where + note, timestamp: new Date(), isHelp: true };
+        return { success: true, message: def.usage + this.#whereNote(def.scope) + note, timestamp: new Date(), isHelp: true };
+    }
+    /** "Works on the Trades screen." — appended to a scoped command's usage. */
+    #whereNote(scope) {
+        return scope === 'global' ? '' : `\n\nWorks on ${scope.screen}.`;
     }
     /** `help`'s annotation for a command scoped to a screen other than the current one. */
     #scopeSuffix(scope) {