@nomad-e/bluma-cli 0.1.38 → 0.1.40

package/dist/config/skills/xlsx/SKILL.md

@@ -5,10 +5,12 @@ description: >
   Triggers: open, read, edit, create, fix, or convert .xlsx, .xlsm, .csv,
   or .tsv files — including adding columns, computing formulas, formatting,
   charting, cleaning messy data, restructuring tabular data, or building
-  financial models. Also trigger when the user references a spreadsheet by
-  name or path and wants something done to it. The deliverable must be a
-  spreadsheet file. Do NOT trigger when the primary deliverable is a Word
-  document, HTML report, or standalone script.
+  financial models. Prefer normal Excel formulas in cells (visible in the
+  formula bar, human-auditable), not hidden logic or pasted numeric results.
+  Also trigger when the user references a spreadsheet by name or path and
+  wants something done to it. The deliverable must be a spreadsheet file.
+  Do NOT trigger when the primary deliverable is a Word document, HTML
+  report, or standalone script.
 license: Proprietary. LICENSE.txt has complete terms
 ---
 
@@ -20,6 +22,28 @@ license: Proprietary. LICENSE.txt has complete terms
 > formula so the spreadsheet stays dynamic. Never compute in Python and
 > paste the result into a cell.
 
+### Human-readable formulas — everything visible in Excel
+
+The workbook must behave like one a **human analyst** would open and audit:
+
+- **Visible in the formula bar:** Any cell that depends on other cells MUST
+  store a real Excel formula (string starting with `=`). When the user
+  selects the cell, they see the formula — not a magic number that was
+  computed offline.
+- **No “black box” outputs:** Do not replace formulas with static values
+  except for true inputs (assumptions, imported facts). Intermediate and
+  final calculated columns = formulas referencing cells/sheets.
+- **Readable structure:** Prefer clear, conventional functions (`SUM`,
+  `AVERAGE`, `IF`, `SUMIF`, `XLOOKUP`/`VLOOKUP`, etc.) and broken-out
+  helper columns over one impenetrable mega-formula, when that makes the
+  model easier to follow — same as a careful human would build.
+- **Auditable trail:** Another person should trace “this total → those
+  lines → those inputs” using only Excel (Show Formulas / following
+  references), without reading Python.
+- **openpyxl:** Assign formulas as strings, e.g. `ws['D2'] = '=B2*C2'`, so
+  they remain formulas in the saved file. Never save a workbook opened with
+  `data_only=True` if you need formulas preserved (see Reading section).
+
 ## Output Quality Standards
 
 ### Professional Appearance
@@ -135,6 +159,16 @@ ws['B10'] = '=SUM(B2:B9)'
 This applies to ALL calculations: totals, averages, percentages,
 growth rates, ratios, conditional aggregations.
 
+### Visibility checklist (model must self-verify)
+
+- Opening the file in Excel/LibreOffice: calculated cells show **formulas**
+  in the formula bar, not only final numbers with no `=`.
+- Totals, subtotals, ratios, and lookups reference **cell addresses** or
+  structured ranges — not constants copied from a script.
+- If the user asked for “Excel they can trust,” err on the side of **more
+  rows/columns with simpler formulas** rather than fewer cells with opaque
+  nested functions.
+
 ### Common Formula Patterns
 
 | Operation | Formula |

package/dist/main.js

@@ -9261,21 +9261,23 @@ var SlashCommands = ({
 var SlashCommands_default = SlashCommands;
 
 // src/app/agent/utils/update_check.ts
-import updateNotifier from "update-notifier";
+import latestVersion from "latest-version";
+import semverGt from "semver/functions/gt.js";
+import semverValid from "semver/functions/valid.js";
 import { fileURLToPath as fileURLToPath4 } from "url";
 import path21 from "path";
 import fs17 from "fs";
 var BLUMA_PACKAGE_NAME = "@nomad-e/bluma-cli";
 function findBlumaPackageJson(startDir) {
   let dir = startDir;
-  for (let i = 0; i < 10; i++) {
+  for (let i = 0; i < 12; i++) {
     const candidate = path21.join(dir, "package.json");
     if (fs17.existsSync(candidate)) {
       try {
         const raw = fs17.readFileSync(candidate, "utf8");
         const parsed = JSON.parse(raw);
         if (parsed?.name === BLUMA_PACKAGE_NAME && parsed?.version) {
-          return { name: parsed.name, version: parsed.version };
+          return { name: parsed.name, version: String(parsed.version) };
         }
       } catch {
       }
@@ -9286,41 +9288,67 @@ function findBlumaPackageJson(startDir) {
   }
   return null;
 }
+function resolveInstalledBlumaPackage() {
+  const tried = /* @__PURE__ */ new Set();
+  const tryFrom = (dir) => {
+    const abs = path21.resolve(dir);
+    if (tried.has(abs)) return null;
+    tried.add(abs);
+    return findBlumaPackageJson(abs);
+  };
+  try {
+    const fromBundle = tryFrom(path21.dirname(fileURLToPath4(import.meta.url)));
+    if (fromBundle) return fromBundle;
+  } catch {
+  }
+  const argv1 = process.argv[1];
+  if (argv1 && !argv1.startsWith("-")) {
+    try {
+      let resolved = argv1;
+      if (path21.isAbsolute(argv1) && fs17.existsSync(argv1)) {
+        resolved = fs17.realpathSync(argv1);
+      } else {
+        resolved = path21.resolve(process.cwd(), argv1);
+      }
+      const fromArgv = tryFrom(path21.dirname(resolved));
+      if (fromArgv) return fromArgv;
+    } catch {
+    }
+  }
+  return null;
+}
 async function checkForUpdates() {
   try {
     if (process.env.BLUMA_FORCE_UPDATE_MSG) {
       return String(process.env.BLUMA_FORCE_UPDATE_MSG);
     }
-    const binPath = process.argv?.[1];
-    let pkg = null;
-    if (binPath && fs17.existsSync(binPath)) {
-      pkg = findBlumaPackageJson(path21.dirname(binPath));
+    if (process.env.CI) {
+      return null;
     }
+    const pkg = resolveInstalledBlumaPackage();
     if (!pkg) {
-      const __filename = fileURLToPath4(import.meta.url);
-      const __dirname = path21.dirname(__filename);
-      pkg = findBlumaPackageJson(__dirname);
+      return null;
     }
-    if (!pkg) {
+    const cur = pkg.version.trim();
+    if (!semverValid(cur)) {
       return null;
     }
-    const isCI = Boolean(process.env.CI);
-    const updateCheckInterval = 0;
-    const notifier = updateNotifier({
-      pkg: { name: pkg.name, version: pkg.version },
-      updateCheckInterval,
-      shouldNotifyInNpmScript: true
-    });
-    if (notifier.update && !isCI) {
-      const cur = notifier.update.current;
-      const lat = notifier.update.latest;
-      if (cur && lat && cur !== lat) {
-        return `Update available for BluMa CLI! ${cur} \u2192 ${lat}
-Run: npm i -g ${BLUMA_PACKAGE_NAME} to update.`;
-      }
+    let latRaw;
+    try {
+      latRaw = await latestVersion(BLUMA_PACKAGE_NAME);
+    } catch {
+      return null;
     }
-    return null;
-  } catch (e) {
+    const lat = String(latRaw).trim();
+    if (!semverValid(lat)) {
+      return null;
+    }
+    if (!semverGt(lat, cur)) {
+      return null;
+    }
+    return `Update available for BluMa CLI! ${cur} \u2192 ${lat}
+Run: npm i -g ${BLUMA_PACKAGE_NAME} to update.`;
+  } catch {
     return null;
   }
 }
@@ -9513,6 +9541,7 @@ var ExpandedPreviewBlock = memo11(ExpandedPreviewBlockComponent);
 
 // src/app/ui/App.tsx
 import { jsx as jsx20, jsxs as jsxs19 } from "react/jsx-runtime";
+var blumaUpdateRegistryCheckStarted = false;
 var SAFE_AUTO_APPROVE_TOOLS = [
   // Comunicação/UI
   "message",
@@ -9584,7 +9613,6 @@ var AppComponent = ({ eventBus, sessionId, cliVersion }) => {
   const [recentActivityLine, setRecentActivityLine] = useState6(null);
   const alwaysAcceptList = useRef5([]);
   const workdir = process.cwd();
-  const updateCheckRan = useRef5(false);
   const turnStartedAtRef = useRef5(null);
   const appendExpandPreviewToHistory = useCallback3(() => {
     const p = peekLatestExpandable();
@@ -9614,6 +9642,23 @@ var AppComponent = ({ eventBus, sessionId, cliVersion }) => {
       expandPreviewHotkeyBus.off("expand", appendExpandPreviewToHistory);
     };
   }, [appendExpandPreviewToHistory]);
+  useEffect7(() => {
+    if (process.env.CI || blumaUpdateRegistryCheckStarted) return;
+    blumaUpdateRegistryCheckStarted = true;
+    void checkForUpdates().then((msg) => {
+      if (!msg) return;
+      setHistory((prev) => {
+        const nextId3 = prev.length === 0 ? 1 : Math.max(...prev.map((h) => h.id), HEADER_PANEL_HISTORY_ID) + 1;
+        return [
+          ...prev,
+          {
+            id: nextId3,
+            component: /* @__PURE__ */ jsx20(UpdateNotice_default, { message: msg })
+          }
+        ];
+      });
+    });
+  }, []);
   useEffect7(() => {
     setHistory((prev) => {
       const tail = prev.filter((h) => h.id !== HEADER_PANEL_HISTORY_ID);
@@ -9874,20 +9919,6 @@ Please use command_status to check the result and report back to the user.`;
           setToolsCount(parsed.tools);
           setMcpStatus("connected");
           setIsProcessing(false);
-          if (!updateCheckRan.current) {
-            updateCheckRan.current = true;
-            Promise.resolve().then(() => checkForUpdates()).then((msg) => {
-              if (msg) {
-                setHistory((prev) => [
-                  ...prev,
-                  {
-                    id: prev.length,
-                    component: /* @__PURE__ */ jsx20(UpdateNotice_default, { message: msg })
-                  }
-                ]);
-              }
-            }).catch(() => void 0);
-          }
           return;
         }
         if (parsed.type === "error") {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nomad-e/bluma-cli",
-	"version": "0.1.38",
+	"version": "0.1.40",
 	"description": "BluMa independent agent for automation and advanced software engineering.",
 	"author": "Alex Fonseca",
 	"license": "Apache-2.0",
@@ -15,7 +15,6 @@
 		"@types/jest": "^30.0.0",
 		"@types/node": "^20.14.2",
 		"@types/react": "^18.3.3",
-		"@types/update-notifier": "^6.0.8",
 		"@types/uuid": "^9.0.8",
 		"babel-jest": "^30.0.5",
 		"babel-plugin-transform-import-meta": "^2.3.3",
@@ -52,11 +51,12 @@
 		"ink-spinner": "^5.0.0",
 		"ink-text-input": "^6.0.0",
 		"js-tiktoken": "^1.0.21",
+		"latest-version": "^9.0.0",
 		"marked": "^16.1.2",
 		"openai": "^4.47.3",
 		"react-devtools-core": "^4.28.5",
 		"read-package-up": "^11.0.0",
-		"update-notifier": "^7.0.0",
+		"semver": "^7.7.4",
 		"uuid": "^9.0.1"
 	},
 	"files": [