@lovrozagar/grunt 0.5.0 → 0.6.0

package/cli/prompt.mjs

@@ -31,6 +31,14 @@ export async function confirm(opts) {
   return bailIfCancel(await clack.confirm(opts))
 }
 
+export async function text(opts) {
+  return bailIfCancel(await clack.text(opts))
+}
+
+export async function password(opts) {
+  return bailIfCancel(await clack.password(opts))
+}
+
 export function spinner() {
   return clack.spinner()
 }

package/cli/prompt.test.ts

@@ -2,6 +2,8 @@ import { afterEach, describe, expect, it, vi } from "vitest";
 
 const clackSelect = vi.hoisted(() => vi.fn());
 const clackConfirm = vi.hoisted(() => vi.fn());
+const clackText = vi.hoisted(() => vi.fn());
+const clackPassword = vi.hoisted(() => vi.fn());
 const clackSpinner = vi.hoisted(() => vi.fn());
 const clackIsCancel = vi.hoisted(() => vi.fn());
 const clackCancel = vi.hoisted(() => vi.fn());
@@ -9,6 +11,8 @@ const clackCancel = vi.hoisted(() => vi.fn());
 vi.mock("@clack/prompts", () => ({
   select: clackSelect,
   confirm: clackConfirm,
+  text: clackText,
+  password: clackPassword,
   spinner: clackSpinner,
   isCancel: clackIsCancel,
   cancel: clackCancel,
@@ -18,8 +22,10 @@ import {
   bailIfCancel,
   confirm,
   isInteractive,
+  password,
   select,
   spinner,
+  text,
 } from "./prompt.mjs";
 
 function tty(isTTY: boolean) {
@@ -196,4 +202,12 @@ describe("clack wrappers", () => {
     expect(spinner()).toBe(s);
     expect(clackSpinner).toHaveBeenCalledOnce();
   });
+
+  it("text and password bail then return", async () => {
+    clackText.mockResolvedValue("proj");
+    clackPassword.mockResolvedValue("sk_x");
+    clackIsCancel.mockReturnValue(false);
+    await expect(text({ message: "Project ID" })).resolves.toBe("proj");
+    await expect(password({ message: "API key" })).resolves.toBe("sk_x");
+  });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lovrozagar/grunt",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Multi-agent orchestrator SoT — deep-merge rulesync trees, product scripts, and generate pipeline into a consumer repo",
   "keywords": [
     "agents",
@@ -36,12 +36,18 @@
     "scripts/grunt-job.mjs",
     "scripts/parse-need.mjs",
     "scripts/persist-handoff.mjs",
+    "scripts/persist-implementation.mjs",
+    "scripts/persist-tmp.mjs",
     "scripts/persist-plan.mjs",
     "scripts/purge-global-mcps.mjs",
     "scripts/scrub-spawn-prompt.mjs",
     "scripts/scrub-text-lib.mjs",
     "scripts/sync-global-settings.mjs",
     "scripts/browser.mjs",
+    "scripts/speak.mjs",
+    "scripts/listen.mjs",
+    "scripts/google-workspace.mjs",
+    "scripts/setup.mjs",
     "scripts/doctor.mjs",
     "scripts/skill-conflicts.mjs",
     "scripts/scrub-text",
@@ -71,12 +77,18 @@
     "hooks:union": "node scripts/hooks-union.mjs",
     "hooks:check": "node scripts/hooks-union.mjs --check",
     "doctor": "node ./scripts/doctor.mjs",
+    "setup": "node ./scripts/setup.mjs",
     "rulesync:doctor": "rulesync doctor",
     "sync:globals": "node scripts/sync-global-settings.mjs",
     "sync:globals:check": "node scripts/check-globals.mjs",
     "sync:globals:apply": "node scripts/sync-global-settings.mjs --apply",
     "purge:global-mcps": "node scripts/purge-global-mcps.mjs",
     "purge:global-mcps:apply": "node scripts/purge-global-mcps.mjs --apply",
+    "antigravity": "antigravity --dangerously-skip-permissions",
+    "claude": "claude --dangerously-skip-permissions",
+    "codex": "codex --dangerously-bypass-approvals-and-sandbox",
+    "gemini": "gemini --yolo",
+    "grok": "grok --yolo",
     "test": "vitest run --coverage"
   },
   "devDependencies": {

package/scripts/browser.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-/** Session browser rail: nav|snap|click|fill|shot|pdf|stop|doctor|ensure. Lightpanda default. */
+/** Session browser rail: nav|snap|click|fill|scroll|wait|hover|select|shot|pdf|stop|doctor|ensure. Lightpanda default. */
 import { spawn } from "node:child_process";
 import crypto from "node:crypto";
 import fs from "node:fs";
@@ -7,6 +7,7 @@ import http from "node:http";
 import net from "node:net";
 import path from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
+import { writeStash } from "./grunt-job.mjs";
 import {
   CHROMIUM_BINS,
   LIGHTPANDA_REPO as DOCTOR_LP_REPO,
@@ -64,9 +65,21 @@ export function isPaintHost(url) {
   if ((h === "google.com" || h.endsWith(".google.com")) && u.pathname.startsWith("/earth")) {
     return true;
   }
+  if (/(^|\.)amazon\./.test(h)) return true;
   return false;
 }
 
+const BLOCKED_SNAP_RE =
+  /enable javascript|javascript (is )?(required|disabled)|checking your browser|just a moment|captcha|access denied|sorry.*robot|continue shopping|attention required|cf-browser-verification|verify you are a human/i;
+
+export function isBlockedSnap(markdown, lines) {
+  const refs = Array.isArray(lines) ? lines.length : 0;
+  const md = String(markdown || "").trim();
+  if (BLOCKED_SNAP_RE.test(md)) return true;
+  const body = md.replace(/^#\s+\S+\s*$/m, "").trim();
+  return refs === 0 && body.length < 80;
+}
+
 export function lookupBins(pathEnv, platform = process.platform) {
   const lightpanda = whichBin("lightpanda", pathEnv, platform);
   let chromium = "";
@@ -348,8 +361,10 @@ async function handleCdp(state, method, params = {}) {
       state.markdown = `# ${state.url}\n\nhello`;
       return { frameId: "f1" };
     case "LP.getMarkdown":
+      if (state.thinSnap) return { markdown: `# ${state.url || ""}\n` };
       return { markdown: state.markdown || `# ${state.url || ""}\n\nhello` };
     case "Accessibility.getFullAXTree":
+      if (state.thinSnap) return { nodes: [] };
       return { nodes: state.axNodes || defaultAx(state.url) };
     case "DOM.resolveNode": {
       const id = params.backendNodeId;
@@ -378,6 +393,7 @@ export async function serveCdp(state = {}, { port = 0 } = {}) {
     url: "about:blank",
     markdown: "",
     failProbe: false,
+    thinSnap: false,
     engine: "lightpanda",
     ...state,
   };
@@ -606,7 +622,7 @@ export async function runBrowser(argv, opts = {}) {
   const verb = String(argv[0] || "").toLowerCase();
   try {
     if (!verb || verb === "help" || verb === "-h" || verb === "--help") {
-      return ok("nav|snap|click|fill|shot|pdf|stop|doctor|ensure");
+      return ok("nav|snap|click|fill|scroll|wait|hover|select|shot|pdf|stop|doctor|ensure");
     }
     if (verb === "doctor" || verb === "ensure") {
       return runDoctor({ pathEnv: env.PATH, platform, cwd });
@@ -650,16 +666,79 @@ export async function runBrowser(argv, opts = {}) {
       return ok(`engine: ${session.engine}\nurl: ${session.lastURL}`);
     }
     if (verb === "snap") {
-      const session = readSession(cwd);
+      let session = readSession(cwd);
       if (!session || !alive(session.pid)) return fail("no browser session; run nav");
-      const { markdown, lines } = await snapshot(session);
+      let { markdown, lines } = await snapshot(session);
+      if (
+        session.engine === "lightpanda" &&
+        (session.swapCount || 0) < 1 &&
+        bins.chromium &&
+        isBlockedSnap(markdown, lines)
+      ) {
+        session = await swapToChromium(session, ctx);
+        ({ markdown, lines } = await snapshot(session));
+      }
       writeSession(cwd, session);
+      const raw = [markdown.trim(), "", ...lines].join("\n");
+      const headings = String(markdown || "")
+        .split(/\n/)
+        .filter((l) => /^#{1,6}\s/.test(l));
+      const shown = [...headings.slice(0, 6), ...lines.slice(0, 24)];
+      if (raw.length > 32 * 1024 || lines.length > 6) {
+        const stash = writeStash(cwd, "snap", raw);
+        return ok(
+          `engine: ${session.engine}\nurl: ${session.lastURL}\n${shown.length} shown. stash=${stash}\n${shown.join("\n")}`,
+        );
+      }
       const body = [markdown.trim(), "", ...lines].filter((x, i, a) => x !== "" || a[i - 1] !== "").join("\n");
       return ok(`engine: ${session.engine}\nurl: ${session.lastURL}\n\n${body}`);
     }
-    if (verb === "click" || verb === "fill") {
+    if (verb === "wait") {
       const session = readSession(cwd);
       if (!session || !alive(session.pid)) return fail("no browser session; run nav");
+      const raw = String(argv[1] || "1000");
+      const ms = Math.min(15000, Math.max(0, Number(raw) || 0));
+      await sleep(ms);
+      return ok(`wait: ${ms}`);
+    }
+    if (verb === "scroll") {
+      let session = readSession(cwd);
+      if (!session || !alive(session.pid)) return fail("no browser session; run nav");
+      const arg = String(argv[1] || "down");
+      const refs = session.lastRefs || {};
+      const rec = refs[arg];
+      const act = async (sess) =>
+        withCdp(sess, async (cdp) => {
+          if (rec) {
+            const resolved = await cdp.send("DOM.resolveNode", { backendNodeId: rec.backendNodeId });
+            const objectId = resolved.object && resolved.object.objectId;
+            if (!objectId) throw new Error("stale");
+            await cdp.send("Runtime.callFunctionOn", {
+              objectId,
+              functionDeclaration: "function() { this.scrollIntoView({ block: 'center' }); }",
+            });
+            return;
+          }
+          let dy = 600;
+          if (arg === "up") dy = -600;
+          else if (/^-?\d+$/.test(arg)) dy = Number(arg);
+          await cdp.send("Runtime.evaluate", {
+            expression: `window.scrollBy(0, ${dy})`,
+          });
+        });
+      try {
+        await act(session);
+      } catch (err) {
+        const msg = String(err && err.message ? err.message : err);
+        if (/stale|missing/i.test(msg)) return fail(`stale ref: ${arg}`);
+        return fail(msg);
+      }
+      writeSession(cwd, session);
+      return ok(`scroll: ${arg}`);
+    }
+    if (verb === "click" || verb === "fill" || verb === "hover" || verb === "select") {
+      let session = readSession(cwd);
+      if (!session || !alive(session.pid)) return fail("no browser session; run nav");
       const refs = session.lastRefs || {};
       if (!Object.keys(refs).length) return fail("no snap refs; run snap");
       const refId = String(argv[1] || "");
@@ -667,6 +746,7 @@ export async function runBrowser(argv, opts = {}) {
       if (!rec) return fail(`missing ref: ${refId}`);
       const text = argv.slice(2).join(" ");
       if (verb === "fill" && !text) return fail("fill <ref> <text>");
+      if (verb === "select" && !text) return fail("select <ref> <value>");
       const act = async (sess) =>
         withCdp(sess, async (cdp) => {
           const resolved = await cdp.send("DOM.resolveNode", { backendNodeId: rec.backendNodeId });
@@ -677,6 +757,19 @@ export async function runBrowser(argv, opts = {}) {
               objectId,
               functionDeclaration: "function() { this.click(); }",
             });
+          } else if (verb === "hover") {
+            await cdp.send("Runtime.callFunctionOn", {
+              objectId,
+              functionDeclaration:
+                "function() { this.dispatchEvent(new MouseEvent('mouseover', { bubbles: true })); }",
+            });
+          } else if (verb === "select") {
+            await cdp.send("Runtime.callFunctionOn", {
+              objectId,
+              arguments: [{ value: text }],
+              functionDeclaration:
+                "function(v) { this.value = v; this.dispatchEvent(new Event('change', { bubbles: true })); }",
+            });
           } else {
             await cdp.send("Runtime.callFunctionOn", {
               objectId,

package/scripts/doctor.mjs

@@ -2,6 +2,7 @@
 /** Unified prereq doctor. Print-only install hints. Never runs installs. */
 import { execFileSync } from "node:child_process";
 import fs from "node:fs";
+import os from "node:os";
 import path from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import {
@@ -166,11 +167,72 @@ export function installHints(id, platform = process.platform) {
     }
     return ["sudo apt install chromium"];
   }
+  if (id === "ffmpeg") {
+    if (platform === "win32") return ["winget install Gyan.FFmpeg"];
+    if (platform === "darwin") return ["brew install ffmpeg"];
+    return ["sudo apt install ffmpeg"];
+  }
+  if (id === "whisper-cli") {
+    if (platform === "win32") {
+      return ["whisper.cpp release: whisper-cli.exe on PATH", "https://github.com/ggml-org/whisper.cpp"];
+    }
+    if (platform === "darwin") return ["brew install whisper-cpp"];
+    return ["https://github.com/ggml-org/whisper.cpp"];
+  }
   return [];
 }
 
+function isFile(abs) {
+  try {
+    return fs.statSync(abs).isFile();
+  } catch {
+    return false;
+  }
+}
+
+export function speakDoctorStatus({ env = process.env, home = os.homedir() } = {}) {
+  const names = [];
+  if (String(env.ELEVENLABS_API_KEY || "").trim()) names.push("elevenlabs");
+  if (String(env.OPENAI_API_KEY || "").trim()) names.push("openai");
+  const hasFile = isFile(path.join(home, ".grunt", "speak.json"));
+  if (!names.length && !hasFile) return { ok: false, extra: "" };
+  return { ok: true, extra: names.length ? names.join(",") : "config" };
+}
+
+const WORKSPACE_ACCOUNT_RE = /^[a-zA-Z0-9_-]{1,40}$/;
+const WORKSPACE_KIND_ORDER = ["oauth", "tokens", "adc", "clasprc"];
+
+export function workspaceDoctorStatus({ home = os.homedir() } = {}) {
+  const grunt = path.join(home, ".grunt");
+  const kinds = new Set();
+  const scanAccountDir = (dir) => {
+    if (isFile(path.join(dir, "google-oauth.json"))) kinds.add("oauth");
+    if (isFile(path.join(dir, "tokens.json"))) kinds.add("tokens");
+  };
+  if (isFile(path.join(grunt, "google-oauth.json"))) kinds.add("oauth");
+  if (isFile(path.join(grunt, "workspace-tokens.json"))) kinds.add("tokens");
+  scanAccountDir(path.join(grunt, "workspace", "default"));
+  const root = path.join(grunt, "workspace");
+  try {
+    for (const ent of fs.readdirSync(root, { withFileTypes: true })) {
+      if (!ent.isDirectory() || !WORKSPACE_ACCOUNT_RE.test(ent.name)) continue;
+      scanAccountDir(path.join(root, ent.name));
+    }
+  } catch {
+    /* none */
+  }
+  if (
+    isFile(path.join(home, ".config", "gcloud", "application_default_credentials.json"))
+  ) {
+    kinds.add("adc");
+  }
+  if (isFile(path.join(home, ".clasprc.json"))) kinds.add("clasprc");
+  if (!kinds.size) return { ok: false, extra: "" };
+  return { ok: true, extra: WORKSPACE_KIND_ORDER.filter((k) => kinds.has(k)).join(",") };
+}
+
 function row(name, status, extra = "") {
-  const a = String(name).padEnd(14);
+  const a = String(name).padEnd(18);
   const b = String(status).padEnd(18);
   const c = extra ? String(extra).trim() : "";
   return c ? `${a} ${b} ${c}` : `${a} ${b}`;
@@ -205,6 +267,8 @@ export function runDoctor({
   platform = process.platform,
   execPath = process.execPath,
   nodeVersion = process.version,
+  env = process.env,
+  home = os.homedir(),
 } = {}) {
   const nmPath = withNmBin(cwd, pathEnv, platform);
   const pathNode = whichBin("node", pathEnv, platform);
@@ -226,6 +290,10 @@ export function runDoctor({
   const lightpanda = whichBin("lightpanda", pathEnv, platform);
   const chromium = lookupChromium(pathEnv, platform);
   const gh = whichBin("gh", pathEnv, platform);
+  const clasp = whichBin("clasp", pathEnv, platform);
+  const ffmpeg = whichBin("ffmpeg", pathEnv, platform);
+  const whisperCli =
+    whichBin("whisper-cli", pathEnv, platform) || whichBin("whisper-cpp", pathEnv, platform);
 
   const found = {
     node: nodeOk ? nodeBin : "",
@@ -252,6 +320,19 @@ export function runDoctor({
   lines.push(lightpanda ? row("lightpanda", "ok", lightpanda) : row("lightpanda", "missing"));
   lines.push(chromium ? row("chromium", "ok", chromium) : row("chromium", "missing"));
   lines.push(gh ? row("gh", "ok", gh) : row("gh", "missing (optional)"));
+  lines.push(clasp ? row("clasp", "ok", clasp) : row("clasp", "missing (optional)"));
+  const workspace = workspaceDoctorStatus({ home });
+  lines.push(
+    workspace.ok
+      ? row("google-workspace", "ok", workspace.extra)
+      : row("google-workspace", "missing (optional)"),
+  );
+  lines.push(ffmpeg ? row("ffmpeg", "ok", ffmpeg) : row("ffmpeg", "missing (optional)"));
+  lines.push(
+    whisperCli ? row("whisper-cli", "ok", whisperCli) : row("whisper-cli", "missing (optional)"),
+  );
+  const speak = speakDoctorStatus({ env, home });
+  lines.push(speak.ok ? row("speak", "ok", speak.extra) : row("speak", "missing (optional)"));
 
   const missingRequired = REQUIRED.filter((k) => (k === "node" ? !nodeOk : !found[k]));
   if (missingRequired.length) {

package/scripts/emit-gemini.mjs

@@ -5,7 +5,7 @@ import path from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { guardedMarkdownDrift, writeMergedGuardedFile } from "../cli/init.mjs";
 
-export const AGENT_IDS = ["orchestrator", "implementer", "thinker", "grunt"];
+export const AGENT_IDS = ["orchestrator", "grunt"];
 const SSOT_REL = ".rulesync/subagents";
 const GEMINI_MD_REL = "GEMINI.md";
 const AGENTS_REL = ".gemini/agents";

package/scripts/emit-mcp-policy.mjs

@@ -12,7 +12,7 @@ const MCP_JSON_REL = ".mcp.json";
 const CODEX_REL = ".codex/config.toml";
 const AGENTS_MCP_REL = ".agents/mcp_config.json";
 const GEMINI_SETTINGS_REL = ".gemini/settings.json";
-const AGENT_IDS = ["orchestrator", "implementer", "thinker", "grunt"];
+const AGENT_IDS = ["orchestrator", "grunt"];
 const MCP_DENY = "mcp__*";
 const AGENT_ORCHESTRATOR_DENY = "Agent(orchestrator)";
 const GROK_HEADER =