mindvest-atlas 0.100.1 → 0.100.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindvest-atlas",
-  "version": "0.100.1",
+  "version": "0.100.2",
   "description": "Atlas CLI \u2014 OAuth login, tool calls, and live alert/flow streaming for the Atlas trading API",
   "type": "module",
   "bin": {

package/src/config.js

@@ -2,7 +2,7 @@
 import path from 'node:path';
 import os from 'node:os';
 
-export const VERSION = '0.100.1';
+export const VERSION = '0.100.2';
 export const DEFAULT_BASE_URL = 'https://atlasmcp.finmanagerai.com';
 export const DEFAULT_SCOPE = 'atlas broker';
 export const CLIENT_NAME = 'Atlas CLI';

package/src/helpers/atlas_env.js

@@ -416,26 +416,51 @@ export async function mcpTools({ server = "", search = "" } = {}) {
  * the payload (see phonePress()). `done: true` finishes a card that is up. At
  * most 30 new ones an hour, so say what matters, not every step.
  *
+ * A tap on it opens this project in Local Mode, on this computer. `view` picks
+ * its tab (files, checks, dashboard, chats, computer). `open` sends the tap
+ * anywhere else on the dashboard instead: a name such as notifications,
+ * alerts, workflow:<id>:performance or project:<folder>:checks, or a path
+ * starting /atlas/dashboard?. The answer's `opens` says where it will go.
+ *
  *     await notify("Backtest done", { body: "SPY: 61% win\n214 trades", key: "backtest" });
  *     await notify("Backtest running", { key: "backtest", progress: 0.4 });
  *     await notify("Backtest done", { key: "backtest", button: "Run on QQQ" });
+ *     await notify("Charts ready", { key: "charts", view: "dashboard" });
+ *     await notify("Alert fired", { open: "alerts" });
  *
  * Returns the tool's answer. `sent` is 0 when the owner switched these off
  * (Profile, Manage notifications, Studio); that is their choice, not an error.
  */
-export async function notify(title, { body = "", key = "", progress = null, button = "", done = false } = {}) {
+export async function notify(title, { body = "", key = "", progress = null, button = "", done = false, open = "", view = "" } = {}) {
   const params = { title, body: body || "" };
   if (key) params.key = key;
   if (progress !== null && progress !== undefined) params.progress = progress;
-  if (button) {
-    params.button = button;
-    // The project the button starts: this one.
-    params.project = process.env.ATLAS_JOB || "";
-  }
+  if (button) params.button = button;
   if (done) params.done = true;
+  // This project: the one the button starts, and where a tap opens.
+  const job = process.env.ATLAS_JOB || "";
+  if (job || button) params.project = job;
+  if (job) {
+    const machine = machineHere();
+    if (machine) params.machine = machine;
+    if (view) params.view = view;
+  }
+  if (open) params.open = open;
   return atlas("phone-notify", params);
 }
 
+/** This computer's id, as the atlas command line keeps it ("" if none). */
+function machineHere() {
+  let found = (process.env.ATLAS_MACHINE || "").trim();
+  if (!found) {
+    const dir = process.env.ATLAS_CONFIG_DIR
+      || (process.env.XDG_CONFIG_HOME ? path.join(process.env.XDG_CONFIG_HOME, "atlas") : path.join(os_.homedir(), ".config", "atlas"));
+    try { found = fs.readFileSync(path.join(dir, "machine-id"), "utf8").trim(); } catch { found = ""; }
+  }
+  found = found.slice(0, 64);
+  return /^[\w-]+$/.test(found) ? found : "";
+}
+
 /**
  * The button press this is about, or null.
  *

package/src/helpers/atlas_env.py

@@ -568,7 +568,24 @@ def mcp_tools(server="", search=""):
     return atlas("mcp-tools", server=server or "", search=search or "")
 
 
-def notify(title, body="", key="", progress=None, button="", done=False):
+def _machine_here():
+    """This computer's id, as the atlas command line keeps it ('' if none)."""
+    if os.environ.get("ATLAS_MACHINE"):
+        found = os.environ["ATLAS_MACHINE"].strip()
+    else:
+        base = os.environ.get("ATLAS_CONFIG_DIR") or (
+            os.path.join(os.environ["XDG_CONFIG_HOME"], "atlas") if os.environ.get("XDG_CONFIG_HOME")
+            else os.path.join(os.path.expanduser("~"), ".config", "atlas"))
+        try:
+            with open(os.path.join(base, "machine-id"), encoding="utf-8") as f:
+                found = f.read().strip()
+        except Exception:
+            found = ""
+    found = found[:64]
+    return found if found and all(c.isascii() and (c.isalnum() or c in "_-") for c in found) else ""
+
+
+def notify(title, body="", key="", progress=None, button="", done=False, open="", view=""):
     """Tell the owner's PHONE (the MindVest Atlas app). A fixed layout you fill in.
 
     A title (cut at 40 characters) and up to two short lines; plain words. The
@@ -578,9 +595,17 @@ def notify(title, body="", key="", progress=None, button="", done=False):
     in the payload (see phone_press()). `done=True` finishes a card that is up.
     At most 30 new ones an hour, so say what matters, not every step.
 
+    A tap on it opens this project in Local Mode, on this computer. `view`
+    picks its tab (files, checks, dashboard, chats, computer). `open` sends the
+    tap anywhere else on the dashboard instead: a name such as notifications,
+    alerts, workflow:<id>:performance or project:<folder>:checks, or a path
+    starting /atlas/dashboard?. The answer's `opens` says where it will go.
+
         notify("Backtest done", "SPY: 61% win\n214 trades", key="backtest")
         notify("Backtest running", key="backtest", progress=0.4)
         notify("Backtest done", "Run it on QQQ too?", key="backtest", button="Run on QQQ")
+        notify("Charts ready", key="charts", view="dashboard")
+        notify("Alert fired", open="alerts")
 
     Returns the tool's answer. `sent` is 0 when the owner switched these off
     (Profile, Manage notifications, Studio); that is their choice, not an error.
@@ -592,10 +617,20 @@ def notify(title, body="", key="", progress=None, button="", done=False):
         params["progress"] = progress
     if button:
         params["button"] = button
-        # The project the button starts: this one.
-        params["project"] = os.environ.get("ATLAS_JOB", "")
     if done:
         params["done"] = True
+    # This project: the one the button starts, and where a tap opens.
+    job = os.environ.get("ATLAS_JOB", "")
+    if job or button:
+        params["project"] = job
+    if job:
+        machine = _machine_here()
+        if machine:
+            params["machine"] = machine
+        if view:
+            params["view"] = view
+    if open:
+        params["open"] = open
     return atlas("phone-notify", **params)
 
 
@@ -1517,7 +1552,8 @@ def _checks_notify(conf, told, line, why, project):
     title = template.replace("{project}", project).replace("{count}", str(len(told))).replace("{what}", what)
     when = "%s, %s" % (_WHY_WORDS.get(why, "Ran"), _time.strftime("%H:%M"))
     try:
-        notify(title[:40], "%s\n%s" % (line, when), key="checks-%s" % project)
+        # A tap opens this project's Checks, on this computer.
+        notify(title[:40], "%s\n%s" % (line, when), key="checks-%s" % project, view="checks")
     except Exception:
         pass