harnery 0.0.1 → 0.2.1

package/dist/commands/backup.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `harn backup`: restic-backed snapshots of `.harnery/`.
+ *
+ * Wraps `restic` with sensible defaults so single-user use doesn't require
+ * remembering env vars. Repo path + password file live under XDG-style
+ * paths and are init'd on first `harn backup init`. Subcommands:
+ *
+ *   init      restic init the repo (one-time)
+ *   snapshot  restic backup .harnery/
+ *   list      restic snapshots
+ *   restore   restic restore <id>
+ *   prune     restic forget --keep-daily 7 --keep-weekly 4 --prune
+ *
+ * Power users override via env vars (HARNERY_RESTIC_REPO, HARNERY_RESTIC_PASSWORD_FILE)
+ * or by passing through any restic args after `--`. The wrapper deliberately
+ * doesn't try to abstract restic; it surfaces it, with opinionated defaults plus
+ * passthrough.
+ */
+import type { Command } from "commander";
+import type { EmitContext } from "../commander.js";
+export declare function registerBackupCommand(program: Command, emit: EmitContext): void;
+//# sourceMappingURL=backup.d.ts.map

package/dist/commands/backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/commands/backup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAOH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAgFnD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAkM/E"}

package/dist/commands/backup.js

@@ -0,0 +1,262 @@
+/**
+ * `harn backup`: restic-backed snapshots of `.harnery/`.
+ *
+ * Wraps `restic` with sensible defaults so single-user use doesn't require
+ * remembering env vars. Repo path + password file live under XDG-style
+ * paths and are init'd on first `harn backup init`. Subcommands:
+ *
+ *   init      restic init the repo (one-time)
+ *   snapshot  restic backup .harnery/
+ *   list      restic snapshots
+ *   restore   restic restore <id>
+ *   prune     restic forget --keep-daily 7 --keep-weekly 4 --prune
+ *
+ * Power users override via env vars (HARNERY_RESTIC_REPO, HARNERY_RESTIC_PASSWORD_FILE)
+ * or by passing through any restic args after `--`. The wrapper deliberately
+ * doesn't try to abstract restic; it surfaces it, with opinionated defaults plus
+ * passthrough.
+ */
+import { spawnSync } from "node:child_process";
+import { randomBytes } from "node:crypto";
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+function defaultRepo() {
+    const home = os.homedir();
+    return process.env.HARNERY_RESTIC_REPO ?? path.join(home, ".cache", "harnery", "restic-repo");
+}
+function defaultPasswordFile() {
+    const home = os.homedir();
+    return (process.env.HARNERY_RESTIC_PASSWORD_FILE ??
+        path.join(home, ".config", "harnery", "restic-password"));
+}
+function findHarneryDir() {
+    let dir = process.cwd();
+    for (let i = 0; i < 8; i++) {
+        if (existsSync(path.join(dir, ".harnery"))) {
+            return path.join(dir, ".harnery");
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return null;
+}
+function ensurePasswordFile(file) {
+    if (existsSync(file))
+        return;
+    mkdirSync(path.dirname(file), { recursive: true });
+    const pw = randomBytes(24).toString("base64");
+    writeFileSync(file, `${pw}\n`, { encoding: "utf-8", mode: 0o600 });
+}
+function runRestic(args, opts = {}) {
+    const repo = opts.repo ?? defaultRepo();
+    const pwFile = opts.passwordFile ?? defaultPasswordFile();
+    const wantInherit = opts.stdio === "inherit";
+    const r = spawnSync("restic", [...args, ...(opts.passThrough ?? [])], {
+        env: {
+            ...process.env,
+            RESTIC_REPOSITORY: repo,
+            RESTIC_PASSWORD_FILE: pwFile,
+        },
+        encoding: "utf-8",
+        stdio: wantInherit ? "inherit" : "pipe",
+    });
+    return {
+        exitCode: r.status ?? 1,
+        stdout: wantInherit ? "" : (r.stdout ?? "") + (r.stderr ?? ""),
+    };
+}
+function checkRestic(emit) {
+    const r = spawnSync("restic", ["version"], { encoding: "utf-8" });
+    if (r.status !== 0) {
+        emit.error({
+            code: "restic_missing",
+            message: "restic is not on PATH",
+            hint: "brew install restic (mac) / apt-get install restic (ubuntu) / https://restic.readthedocs.io/en/stable/020_installation.html",
+        });
+        return false;
+    }
+    return true;
+}
+export function registerBackupCommand(program, emit) {
+    const backup = program
+        .command("backup")
+        .description("restic-backed snapshots of .harnery/ (multi-machine recovery insurance)");
+    // -- init --
+    backup
+        .command("init")
+        .description("Create the restic repository + password file (one-time).")
+        .option("--repo <path>", `Repository path (default: ${defaultRepo()})`)
+        .option("--password-file <path>", `Password file (default: ${defaultPasswordFile()}, autogenerated)`)
+        .action((opts) => {
+        if (!checkRestic(emit)) {
+            emit.setExitCode(1);
+            return;
+        }
+        const repo = opts.repo ?? defaultRepo();
+        const pwFile = opts.passwordFile ?? defaultPasswordFile();
+        ensurePasswordFile(pwFile);
+        mkdirSync(path.dirname(repo), { recursive: true });
+        const r = runRestic(["init"], { repo, passwordFile: pwFile, stdio: "inherit" });
+        if (r.exitCode === 0) {
+            emit.text(`restic repo initialized at ${repo}\npassword file: ${pwFile}`);
+        }
+        else {
+            emit.setExitCode(r.exitCode);
+        }
+    });
+    // -- snapshot --
+    backup
+        .command("snapshot")
+        .description("Take a restic snapshot of .harnery/ (excluding events.ndjson and " +
+        ".lock files by default). Pass --target to back up a different path.")
+        .option("--target <path>", "Path to snapshot (default: .harnery/ from cwd walk-up)")
+        .option("--tag <tag>", "Restic tag (repeatable)", collect, [])
+        .option("--repo <path>", "Repository path")
+        .option("--password-file <path>", "Password file")
+        .option("--include-events", "Don't exclude events.ndjson (default: excluded; large + machine-local)")
+        .action((opts) => {
+        if (!checkRestic(emit)) {
+            emit.setExitCode(1);
+            return;
+        }
+        const target = opts.target ?? findHarneryDir();
+        if (!target) {
+            emit.error({
+                code: "target_missing",
+                message: "No .harnery/ found above cwd; pass --target explicitly or run from a monorepo with .harnery/",
+            });
+            emit.setExitCode(1);
+            return;
+        }
+        const passThrough = [];
+        if (!opts.includeEvents) {
+            passThrough.push("--exclude", "events.ndjson");
+            passThrough.push("--exclude", ".lock");
+            passThrough.push("--exclude", ".log.lock");
+        }
+        for (const t of opts.tag) {
+            passThrough.push("--tag", t);
+        }
+        const r = runRestic(["backup", target], {
+            repo: opts.repo,
+            passwordFile: opts.passwordFile,
+            stdio: "inherit",
+            passThrough,
+        });
+        emit.setExitCode(r.exitCode);
+    });
+    // -- list --
+    backup
+        .command("list")
+        .description("List snapshots in the repo.")
+        .option("--repo <path>", "Repository path")
+        .option("--password-file <path>", "Password file")
+        .option("--json", "JSON output")
+        .action((opts) => {
+        if (!checkRestic(emit)) {
+            emit.setExitCode(1);
+            return;
+        }
+        const args = ["snapshots"];
+        if (opts.json)
+            args.push("--json");
+        const r = runRestic(args, {
+            repo: opts.repo,
+            passwordFile: opts.passwordFile,
+            stdio: opts.json ? "pipe" : "inherit",
+        });
+        if (opts.json && r.exitCode === 0) {
+            try {
+                emit.data(JSON.parse(r.stdout));
+            }
+            catch {
+                emit.text(r.stdout);
+            }
+        }
+        emit.setExitCode(r.exitCode);
+    });
+    // -- restore --
+    backup
+        .command("restore <snapshotId>")
+        .description("Restore a snapshot to a target directory (default: ./restore-<timestamp>).")
+        .option("--target <path>", "Restore destination")
+        .option("--repo <path>", "Repository path")
+        .option("--password-file <path>", "Password file")
+        .action((snapshotId, opts) => {
+        if (!checkRestic(emit)) {
+            emit.setExitCode(1);
+            return;
+        }
+        const target = opts.target ?? path.join(process.cwd(), `restore-${Date.now()}`);
+        mkdirSync(target, { recursive: true });
+        const r = runRestic(["restore", snapshotId, "--target", target], {
+            repo: opts.repo,
+            passwordFile: opts.passwordFile,
+            stdio: "inherit",
+        });
+        if (r.exitCode === 0) {
+            emit.text(`restored to: ${target}`);
+        }
+        emit.setExitCode(r.exitCode);
+    });
+    // -- prune --
+    backup
+        .command("prune")
+        .description("Forget + prune snapshots (default policy: keep 7 daily / 4 weekly / 6 monthly).")
+        .option("--keep-daily <n>", "Daily snapshots to keep", "7")
+        .option("--keep-weekly <n>", "Weekly snapshots to keep", "4")
+        .option("--keep-monthly <n>", "Monthly snapshots to keep", "6")
+        .option("--dry-run", "Show what would be pruned without actually pruning")
+        .option("--repo <path>", "Repository path")
+        .option("--password-file <path>", "Password file")
+        .action((opts) => {
+        if (!checkRestic(emit)) {
+            emit.setExitCode(1);
+            return;
+        }
+        const args = [
+            "forget",
+            "--keep-daily",
+            opts.keepDaily,
+            "--keep-weekly",
+            opts.keepWeekly,
+            "--keep-monthly",
+            opts.keepMonthly,
+        ];
+        if (!opts.dryRun)
+            args.push("--prune");
+        else
+            args.push("--dry-run");
+        const r = runRestic(args, {
+            repo: opts.repo,
+            passwordFile: opts.passwordFile,
+            stdio: "inherit",
+        });
+        emit.setExitCode(r.exitCode);
+    });
+    // -- check --
+    backup
+        .command("check")
+        .description("restic check: verify repo integrity")
+        .option("--repo <path>", "Repository path")
+        .option("--password-file <path>", "Password file")
+        .action((opts) => {
+        if (!checkRestic(emit)) {
+            emit.setExitCode(1);
+            return;
+        }
+        const r = runRestic(["check"], {
+            repo: opts.repo,
+            passwordFile: opts.passwordFile,
+            stdio: "inherit",
+        });
+        emit.setExitCode(r.exitCode);
+    });
+}
+function collect(value, acc) {
+    acc.push(value);
+    return acc;
+}

package/dist/commands/browse-ai.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from "commander";
+import type { EmitContext } from "../commander.js";
+export declare function registerBrowseAiCommand(program: Command, emitParam: EmitContext): void;
+//# sourceMappingURL=browse-ai.d.ts.map

package/dist/commands/browse-ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browse-ai.d.ts","sourceRoot":"","sources":["../../src/commands/browse-ai.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAiDnD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,GAAG,IAAI,CA2CtF"}

package/dist/commands/browse-ai.js

@@ -0,0 +1,156 @@
+import { homedir } from "node:os";
+import { resolve } from "node:path";
+import { AgentBrowser } from "../lib/agent-browser/index.js";
+import { CookieJar } from "../lib/cookies/index.js";
+// Module-scoped emit assigned by registerBrowseAiCommand. Same pattern as
+// cookies/read/browse: helper functions close over `emit` so action
+// callbacks stay concise.
+let emit;
+/**
+ * `harn browse-ai <url>`: wraps Vercel Labs' agent-browser Rust CLI.
+ *
+ * Sister command to `harn browse` (which uses Playwright). Differences:
+ *
+ *   - **Output shape.** `agent-browser` returns an accessibility-tree
+ *     snapshot with element refs (`@e1`, `@e2`), purpose-built for LLM
+ *     consumption. `harn browse` returns DOM/HTML/innerText.
+ *   - **Process model.** `agent-browser` runs as a daemon: successive
+ *     calls reuse the same Chrome instance until something explicitly
+ *     closes it. `harn browse` opens + closes per call.
+ *   - **Auth model.** `harn browse-ai` doesn't have a `--login` flow; use
+ *     `harn browse --login` for one-time auth, then both tools share the
+ *     same cookie jar.
+ *
+ * Mirrors the agent-side `browse` wrapper (sandbox side) so a script written for one
+ * works on the other modulo path differences.
+ */
+const DEFAULT_STORE = resolve(homedir(), ".cache", "harnery", "cookies.json");
+export function registerBrowseAiCommand(program, emitParam) {
+    emit = emitParam;
+    program
+        .command("browse-ai <url>")
+        .description("agent-browser (Vercel Labs) wrapper: accessibility-tree snapshots with element refs (@e1, @e2) for LLM consumption. " +
+        "Daemon-mode: successive calls reuse the same browser instance. Sister to harn browse (Playwright).")
+        .option("--snapshot", "Print accessibility tree (default action when no other output flag)")
+        .option("-i, --interactive", "Snapshot interactive elements only (with --snapshot)")
+        .option("--screenshot <path>", "Save a screenshot to the given path")
+        .option("--no-full-page", "Capture only the viewport (with --screenshot)")
+        .option("--annotate <path>", "Save an annotated screenshot with numbered labels (vision-model friendly)")
+        .option("--click <ref>", "Click an element ref (@e5) or CSS selector after open")
+        .option("--fill <ref=>value>", "Fill input: '@e3=>hello' (separator is `=>` so attribute selectors don't collide)")
+        .option("--press <key>", "Press a key after open/fill (Enter, Tab, etc.)")
+        .option("--wait-for <selector|ms>", "Wait for selector OR a number of ms before output")
+        .option("--evaluate <js>", "Run JS in the page context (escape-hatch for power users)")
+        .option("--batch <commands>", "Run multiple agent-browser steps in one session, semicolon-separated. " +
+        'E.g., --batch "click @e5; wait 1000; snapshot"')
+        .option("--network-har <path>", "Record a HAR file from open() through end of run")
+        .option("--no-cookies", "Skip cookie-jar attach and persist")
+        .option("--store <path>", `Cookie store path (default ${DEFAULT_STORE})`)
+        .option("--json", "Emit a JSON envelope (snapshot, screenshot path, step results)")
+        .option("--timeout <ms>", "Per-step timeout in ms", "60000")
+        .action((url, opts) => {
+        try {
+            runBrowseAi(url, opts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            emit.error({ code: "browse_ai_error", message: msg });
+            process.exit(1);
+        }
+    });
+}
+function runBrowseAi(url, opts) {
+    const jar = opts.cookies === false
+        ? null
+        : new CookieJar({ path: opts.store ?? DEFAULT_STORE, source: "bp-browse-ai" });
+    const ab = new AgentBrowser({
+        jar,
+        timeoutMs: Number.parseInt(opts.timeout, 10),
+    });
+    const stepLog = [];
+    // 1. Open + optional HAR start.
+    if (opts.networkHar)
+        ab.harStart(opts.networkHar);
+    ab.open(url);
+    stepLog.push({ step: `open ${url}`, ok: true, output: "" });
+    // 2. Pre-output actions, in the order they make sense for typical flows.
+    if (opts.fill) {
+        const sep = opts.fill.indexOf("=>");
+        if (sep < 0) {
+            throw new Error(`--fill expects 'ref=>value' (got: ${opts.fill}). Separator is '=>' (not '=').`);
+        }
+        const ref = opts.fill.slice(0, sep);
+        const value = opts.fill.slice(sep + 2);
+        const r = ab.fill(ref, value);
+        stepLog.push({ step: `fill ${ref}`, ok: r.ok, output: r.stdout.trim() });
+    }
+    if (opts.click) {
+        const r = ab.click(opts.click);
+        stepLog.push({ step: `click ${opts.click}`, ok: r.ok, output: r.stdout.trim() });
+    }
+    if (opts.press) {
+        const r = ab.press(opts.press);
+        stepLog.push({ step: `press ${opts.press}`, ok: r.ok, output: r.stdout.trim() });
+    }
+    if (opts.waitFor) {
+        const r = ab.wait(opts.waitFor);
+        stepLog.push({ step: `wait ${opts.waitFor}`, ok: r.ok, output: r.stdout.trim() });
+    }
+    if (opts.batch) {
+        const steps = opts.batch
+            .split(";")
+            .map((s) => s.trim())
+            .filter(Boolean);
+        const results = ab.batch(steps);
+        steps.forEach((step, i) => {
+            const r = results[i];
+            stepLog.push({ step, ok: r?.ok ?? false, output: r?.stdout.trim() ?? "" });
+        });
+    }
+    if (opts.evaluate) {
+        const out = ab.evaluate(opts.evaluate);
+        stepLog.push({ step: "eval", ok: true, output: out });
+    }
+    // 3. Output capture.
+    let snapshot = null;
+    if (opts.snapshot || (!opts.screenshot && !opts.annotate && !opts.evaluate)) {
+        snapshot = ab.snapshot({ interactive: opts.interactive });
+    }
+    if (opts.screenshot) {
+        ab.screenshot(opts.screenshot, { full: opts.fullPage !== false });
+    }
+    if (opts.annotate) {
+        ab.screenshot(opts.annotate, { annotate: true });
+    }
+    if (opts.networkHar)
+        ab.harStop(opts.networkHar);
+    // 4. Cookie sync back to jar.
+    const cookieStats = ab.syncCookiesToJar();
+    // 5. Output.
+    if (opts.json) {
+        const envelope = {
+            url,
+            steps: stepLog,
+            cookiesSaved: cookieStats.saved,
+        };
+        if (snapshot !== null)
+            envelope.snapshot = snapshot;
+        if (opts.screenshot)
+            envelope.screenshot = opts.screenshot;
+        if (opts.annotate)
+            envelope.annotated = opts.annotate;
+        if (opts.networkHar)
+            envelope.har = opts.networkHar;
+        emit.data(envelope);
+        return;
+    }
+    if (snapshot !== null)
+        emit.text(snapshot);
+    if (opts.screenshot)
+        emit.log(`screenshot: ${opts.screenshot}`, "info");
+    if (opts.annotate)
+        emit.log(`annotated: ${opts.annotate}`, "info");
+    if (cookieStats.saved > 0) {
+        emit.log(`saved ${cookieStats.saved} cookie${cookieStats.saved === 1 ? "" : "s"} to ${jar?.path}`, "info");
+    }
+}

package/dist/commands/browse.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from "commander";
+import type { EmitContext, HarneryProgramContext } from "../commander.js";
+export declare function registerBrowseCommand(program: Command, emitParam: EmitContext, context?: HarneryProgramContext): void;
+//# sourceMappingURL=browse.d.ts.map

package/dist/commands/browse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browse.d.ts","sourceRoot":"","sources":["../../src/commands/browse.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AA0G1E,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,WAAW,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI,CAwJN"}