@isaacriehm/cairn 0.1.0

package/dist/cli/install.d.ts

@@ -0,0 +1,52 @@
+/**
+ * `harness install` — register the daemon as a launchd LaunchAgent (macOS).
+ *
+ * Generates `~/Library/LaunchAgents/com.devplusllc.harness.<slug>.plist`
+ * pointing at `harness daemon --project <slug>`, then `launchctl load`s it.
+ * After install, the daemon survives reboot, restarts on crash (RunAtLoad
+ * + KeepAlive), and tees stdout/stderr into
+ * `~/.local/harness/logs/<slug>.supervisor.log`.
+ *
+ * Subcommands:
+ *   install   <slug>            write plist + launchctl load
+ *   uninstall <slug>            launchctl unload + remove plist
+ *   status    <slug>            launchctl list status + plist path
+ *   restart   <slug>            unload + load
+ *
+ * Linux operators: use systemd unit instead (not bundled here yet — the
+ * operator's stated workflow is macOS Claude Code + Discord).
+ *
+ * Friends adopting the harness via private GitHub install:
+ *   npm install github:<you>/harness#<sha>
+ *   cd ~/their-app
+ *   npx harness init . --force
+ *   npx harness install
+ *   # done — survives reboot
+ */
+interface PlistOptions {
+    project: string;
+    /** Working directory the daemon runs in — usually the adopted project root. */
+    workingDirectory: string;
+    /** Adapter list. Default "discord". */
+    frontends: string;
+    /** When true, pass --no-gc to the daemon. */
+    noGc: boolean;
+    /** Override log dir. Default ~/.local/harness/logs. */
+    logDir: string;
+    /** Resolved absolute path to harness CLI script. */
+    harnessBin: string;
+    /** Node binary path. */
+    nodeBin: string;
+    /** Override PATH the daemon inherits. Default: process.env.PATH. */
+    pathEnv: string;
+}
+export interface PlistResult {
+    label: string;
+    plistPath: string;
+    /** XML body that was written. */
+    body: string;
+}
+export declare function buildLaunchdPlist(opts: PlistOptions): PlistResult;
+export declare function launchdPlistPathFor(label: string): string;
+export declare function installCli(argv: string[]): Promise<void>;
+export {};

package/dist/cli/install.js

@@ -0,0 +1,308 @@
+/**
+ * `harness install` — register the daemon as a launchd LaunchAgent (macOS).
+ *
+ * Generates `~/Library/LaunchAgents/com.devplusllc.harness.<slug>.plist`
+ * pointing at `harness daemon --project <slug>`, then `launchctl load`s it.
+ * After install, the daemon survives reboot, restarts on crash (RunAtLoad
+ * + KeepAlive), and tees stdout/stderr into
+ * `~/.local/harness/logs/<slug>.supervisor.log`.
+ *
+ * Subcommands:
+ *   install   <slug>            write plist + launchctl load
+ *   uninstall <slug>            launchctl unload + remove plist
+ *   status    <slug>            launchctl list status + plist path
+ *   restart   <slug>            unload + load
+ *
+ * Linux operators: use systemd unit instead (not bundled here yet — the
+ * operator's stated workflow is macOS Claude Code + Discord).
+ *
+ * Friends adopting the harness via private GitHub install:
+ *   npm install github:<you>/harness#<sha>
+ *   cd ~/their-app
+ *   npx harness init . --force
+ *   npx harness install
+ *   # done — survives reboot
+ */
+import { spawnSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync, } from "node:fs";
+import { homedir, platform } from "node:os";
+import { dirname, resolve } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { normalizeProjectName } from "@devplusllc/harness-core";
+function parseArgs(argv) {
+    const positional = [];
+    const flags = {};
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === undefined)
+            continue;
+        if (arg.startsWith("--")) {
+            const key = arg.slice(2);
+            const next = argv[i + 1];
+            if (next !== undefined && !next.startsWith("--")) {
+                flags[key] = next;
+                i += 1;
+            }
+            else {
+                flags[key] = true;
+            }
+        }
+        else {
+            positional.push(arg);
+        }
+    }
+    return { positional, flags };
+}
+function usage() {
+    console.error("Usage: harness install <subcommand> [options]\n" +
+        "  install    [--project <slug>] [--frontend <list>] [--no-gc] [--dry-run]\n" +
+        "  uninstall  [--project <slug>] [--dry-run]\n" +
+        "  status     [--project <slug>]\n" +
+        "  restart    [--project <slug>]\n" +
+        "\n" +
+        "  --project   project slug (default: read .harness/config.yaml in cwd)\n" +
+        "  --frontend  adapter list passed to daemon (default: discord)\n" +
+        "  --no-gc     disable the daemon's nightly gc tick\n" +
+        "  --dry-run   write the plist to a tmp dir + print path; skip launchctl\n" +
+        "\n" +
+        "macOS only (launchd LaunchAgent). Plist path:\n" +
+        "  ~/Library/LaunchAgents/com.devplusllc.harness.<slug>.plist");
+    process.exit(1);
+}
+function readProjectFromCwd() {
+    const configPath = resolve(process.cwd(), ".harness", "config.yaml");
+    if (!existsSync(configPath))
+        return undefined;
+    try {
+        const text = readFileSync(configPath, "utf8");
+        const parsed = parseYaml(text);
+        const slug = parsed["slug"];
+        return typeof slug === "string" ? slug : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function buildLaunchdPlist(opts) {
+    const label = `com.devplusllc.harness.${opts.project}`;
+    const args = [
+        opts.harnessBin,
+        "daemon",
+        "--project",
+        opts.project,
+        "--frontend",
+        opts.frontends,
+        "--log-dir",
+        opts.logDir,
+    ];
+    if (opts.noGc)
+        args.push("--no-gc");
+    const stdoutPath = resolve(opts.logDir, `${opts.project}.supervisor.out.log`);
+    const stderrPath = resolve(opts.logDir, `${opts.project}.supervisor.err.log`);
+    const lines = [];
+    lines.push(`<?xml version="1.0" encoding="UTF-8"?>`);
+    lines.push(`<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">`);
+    lines.push(`<plist version="1.0">`);
+    lines.push(`  <dict>`);
+    lines.push(`    <key>Label</key>`);
+    lines.push(`    <string>${escapeXml(label)}</string>`);
+    lines.push(`    <key>ProgramArguments</key>`);
+    lines.push(`    <array>`);
+    lines.push(`      <string>${escapeXml(opts.nodeBin)}</string>`);
+    for (const arg of args) {
+        lines.push(`      <string>${escapeXml(arg)}</string>`);
+    }
+    lines.push(`    </array>`);
+    lines.push(`    <key>RunAtLoad</key>`);
+    lines.push(`    <true/>`);
+    lines.push(`    <key>KeepAlive</key>`);
+    lines.push(`    <dict>`);
+    lines.push(`      <key>SuccessfulExit</key>`);
+    lines.push(`      <false/>`);
+    lines.push(`    </dict>`);
+    lines.push(`    <key>WorkingDirectory</key>`);
+    lines.push(`    <string>${escapeXml(opts.workingDirectory)}</string>`);
+    lines.push(`    <key>StandardOutPath</key>`);
+    lines.push(`    <string>${escapeXml(stdoutPath)}</string>`);
+    lines.push(`    <key>StandardErrorPath</key>`);
+    lines.push(`    <string>${escapeXml(stderrPath)}</string>`);
+    lines.push(`    <key>EnvironmentVariables</key>`);
+    lines.push(`    <dict>`);
+    lines.push(`      <key>PATH</key>`);
+    lines.push(`      <string>${escapeXml(opts.pathEnv)}</string>`);
+    lines.push(`      <key>HOME</key>`);
+    lines.push(`      <string>${escapeXml(homedir())}</string>`);
+    lines.push(`    </dict>`);
+    lines.push(`  </dict>`);
+    lines.push(`</plist>`);
+    const body = lines.join("\n") + "\n";
+    const plistPath = launchdPlistPathFor(label);
+    return { label, plistPath, body };
+}
+export function launchdPlistPathFor(label) {
+    return resolve(homedir(), "Library", "LaunchAgents", `${label}.plist`);
+}
+function escapeXml(s) {
+    return s
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&apos;");
+}
+function requireMacOs() {
+    if (platform() !== "darwin") {
+        console.error("harness install is macOS-only (launchd). For Linux, use a systemd user unit instead — not bundled yet.");
+        process.exit(2);
+    }
+}
+function launchctl(args) {
+    const r = spawnSync("launchctl", args, { encoding: "utf8" });
+    return {
+        ok: r.status === 0,
+        stdout: r.stdout ?? "",
+        stderr: r.stderr ?? "",
+    };
+}
+function resolveProjectFromFlags(flags) {
+    const slugRaw = typeof flags["project"] === "string"
+        ? flags["project"]
+        : readProjectFromCwd();
+    if (slugRaw === undefined || slugRaw.length === 0) {
+        console.error("harness install: --project required (no .harness/config.yaml in cwd)");
+        process.exit(2);
+    }
+    return normalizeProjectName(slugRaw);
+}
+function commonOpts(flags, project) {
+    const workingDirectory = process.cwd();
+    const frontends = typeof flags["frontend"] === "string" ? flags["frontend"] : "discord";
+    const noGc = flags["no-gc"] === true;
+    const logDir = typeof flags["log-dir"] === "string"
+        ? resolve(flags["log-dir"])
+        : resolve(homedir(), ".local", "harness", "logs");
+    const harnessBin = resolve(process.argv[1] ?? "");
+    const nodeBin = process.execPath;
+    const pathEnv = typeof process.env["PATH"] === "string"
+        ? process.env["PATH"]
+        : "/usr/local/bin:/usr/bin:/bin";
+    return {
+        project,
+        workingDirectory,
+        frontends,
+        noGc,
+        logDir,
+        harnessBin,
+        nodeBin,
+        pathEnv,
+    };
+}
+function writePlist(plist, dryRunPath) {
+    const target = dryRunPath ?? plist.plistPath;
+    mkdirSync(dirname(target), { recursive: true });
+    writeFileSync(target, plist.body, "utf8");
+    return target;
+}
+async function doInstall(flags) {
+    const project = resolveProjectFromFlags(flags);
+    const dryRun = flags["dry-run"] === true;
+    if (!dryRun)
+        requireMacOs();
+    const opts = commonOpts(flags, project);
+    mkdirSync(opts.logDir, { recursive: true });
+    const plist = buildLaunchdPlist(opts);
+    if (dryRun) {
+        const tmpDir = resolve(process.cwd(), ".harness", "tmp");
+        const tmpPath = resolve(tmpDir, `${plist.label}.plist`);
+        writePlist(plist, tmpPath);
+        process.stdout.write(`dry-run: plist written to ${tmpPath}\n  label: ${plist.label}\n  intended path: ${plist.plistPath}\n  Skipping launchctl load.\n`);
+        return;
+    }
+    writePlist(plist);
+    // unload first in case a stale one is loaded (idempotency).
+    launchctl(["unload", plist.plistPath]);
+    const loadResult = launchctl(["load", "-w", plist.plistPath]);
+    if (!loadResult.ok) {
+        console.error(`launchctl load failed:\n  stderr: ${loadResult.stderr.trim()}\n  plist:  ${plist.plistPath}`);
+        process.exit(2);
+    }
+    process.stdout.write(`installed launchd agent ${plist.label}\n  plist:  ${plist.plistPath}\n  logs:   ${opts.logDir}/${project}.*.log\n  status: harness install status --project ${project}\n`);
+}
+async function doUninstall(flags) {
+    const project = resolveProjectFromFlags(flags);
+    const dryRun = flags["dry-run"] === true;
+    if (!dryRun)
+        requireMacOs();
+    const label = `com.devplusllc.harness.${project}`;
+    const plistPath = launchdPlistPathFor(label);
+    if (dryRun) {
+        process.stdout.write(`dry-run: would launchctl unload + remove ${plistPath}\n`);
+        return;
+    }
+    if (existsSync(plistPath)) {
+        launchctl(["unload", plistPath]);
+        try {
+            unlinkSync(plistPath);
+        }
+        catch (err) {
+            console.error(`failed to remove plist: ${String(err)}`);
+            process.exit(2);
+        }
+        process.stdout.write(`uninstalled ${label}\n  removed: ${plistPath}\n`);
+    }
+    else {
+        process.stdout.write(`no plist at ${plistPath} (already uninstalled?)\n`);
+    }
+}
+function doStatus(flags) {
+    const project = resolveProjectFromFlags(flags);
+    const label = `com.devplusllc.harness.${project}`;
+    const plistPath = launchdPlistPathFor(label);
+    const exists = existsSync(plistPath);
+    const list = launchctl(["list", label]);
+    process.stdout.write(`label:  ${label}\n` +
+        `plist:  ${plistPath} (${exists ? "exists" : "missing"})\n` +
+        `launchctl list:\n${list.stdout || list.stderr || "(no entry)"}\n`);
+}
+async function doRestart(flags) {
+    const project = resolveProjectFromFlags(flags);
+    requireMacOs();
+    const label = `com.devplusllc.harness.${project}`;
+    const plistPath = launchdPlistPathFor(label);
+    if (!existsSync(plistPath)) {
+        console.error(`harness install: no plist at ${plistPath}`);
+        process.exit(2);
+    }
+    launchctl(["unload", plistPath]);
+    const r = launchctl(["load", "-w", plistPath]);
+    if (!r.ok) {
+        console.error(`launchctl reload failed: ${r.stderr.trim()}`);
+        process.exit(2);
+    }
+    process.stdout.write(`restarted ${label}\n`);
+}
+export async function installCli(argv) {
+    const { positional, flags } = parseArgs(argv);
+    if (flags["help"] === true || flags["h"] === true)
+        usage();
+    const sub = positional[0];
+    switch (sub) {
+        case undefined:
+        case "install":
+            await doInstall(flags);
+            return;
+        case "uninstall":
+            await doUninstall(flags);
+            return;
+        case "status":
+            doStatus(flags);
+            return;
+        case "restart":
+            await doRestart(flags);
+            return;
+        default:
+            console.error(`harness install: unknown subcommand "${sub}"`);
+            usage();
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/cli/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/cli/install.ts"],"names":[],"mappings":"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"}

package/dist/cli/join.d.ts

@@ -0,0 +1 @@
+export declare function joinCli(argv: string[]): Promise<void>;

package/dist/cli/join.js

@@ -0,0 +1,84 @@
+import { resolve } from "node:path";
+import { runJoin } from "@isaacriehm/cairn-core";
+function parseArgs(argv) {
+    const positional = [];
+    const flags = {};
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === undefined)
+            continue;
+        if (arg.startsWith("--")) {
+            const key = arg.slice(2);
+            const next = argv[i + 1];
+            if (next !== undefined && !next.startsWith("--")) {
+                flags[key] = next;
+                i += 1;
+            }
+            else {
+                flags[key] = true;
+            }
+        }
+        else {
+            positional.push(arg);
+        }
+    }
+    return { positional, flags };
+}
+function usage() {
+    console.error("Usage: cairn join [target-dir] [options]\n" +
+        "  [target-dir]      directory to bootstrap (default: cwd)\n" +
+        "  --dry-run         report detection only — no fs / git side-effects\n" +
+        "  --strict          exit non-zero on any warning (e.g. version mismatch)\n" +
+        "  --json            print the structured result as JSON\n" +
+        "\n" +
+        "Per PLUGIN_ARCHITECTURE §17 Layer 2. Idempotent — safe to re-run on\n" +
+        "every install. Configures git core.hooksPath, chmods the seeded git\n" +
+        "hooks, and ensures the per-clone session-state directory exists.");
+    process.exit(1);
+}
+const STATUS_GLYPH = {
+    ok: "✓",
+    skipped: "○",
+    warn: "⚠",
+    error: "✗",
+};
+export async function joinCli(argv) {
+    const parsed = parseArgs(argv);
+    if (parsed.flags["help"] === true || parsed.flags["h"] === true)
+        usage();
+    const target = parsed.positional[0];
+    const repoRoot = target ? resolve(target) : undefined;
+    const result = runJoin({
+        cwd: process.cwd(),
+        ...(repoRoot !== undefined ? { repoRoot } : {}),
+        dryRun: parsed.flags["dry-run"] === true,
+        strict: parsed.flags["strict"] === true,
+    });
+    if (parsed.flags["json"] === true) {
+        process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+    }
+    else {
+        if (result.repoRoot !== null) {
+            console.log(`cairn join — ${result.repoRoot}`);
+            console.log(`  cli=${result.cliVersion} project=${result.projectCairnVersion ?? "(unset)"}`);
+        }
+        for (const step of result.steps) {
+            const glyph = STATUS_GLYPH[step.status] ?? "·";
+            console.log(`  ${glyph} ${step.step.padEnd(20)}  ${step.detail}`);
+        }
+        if (result.bootstrapped) {
+            console.log("\ncairn join: bootstrapped");
+        }
+        else {
+            console.log("\ncairn join: incomplete — see errors above");
+        }
+    }
+    const hasError = result.steps.some((s) => s.status === "error");
+    const hasWarn = result.steps.some((s) => s.status === "warn");
+    if (hasError)
+        process.exit(1);
+    if (parsed.flags["strict"] === true && hasWarn)
+        process.exit(2);
+    process.exit(0);
+}
+//# sourceMappingURL=join.js.map

package/dist/cli/join.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"join.js","sourceRoot":"","sources":["../../src/cli/join.ts"],"names":[],"mappings":"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"}

package/dist/cli/mcp.d.ts

@@ -0,0 +1 @@
+export declare function mcpCli(argv: string[]): Promise<void>;

package/dist/cli/mcp.js

@@ -0,0 +1,62 @@
+import { resolve } from "node:path";
+import { logger, createContext, startMcpServer } from "@isaacriehm/cairn-core";
+const log = logger("cli.mcp");
+function parseArgs(argv) {
+    const positional = [];
+    const flags = {};
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === undefined)
+            continue;
+        if (arg.startsWith("--")) {
+            const key = arg.slice(2);
+            const next = argv[i + 1];
+            if (next !== undefined && !next.startsWith("--")) {
+                flags[key] = next;
+                i += 1;
+            }
+            else {
+                flags[key] = true;
+            }
+        }
+        else {
+            positional.push(arg);
+        }
+    }
+    return { positional, flags };
+}
+function usage() {
+    console.error("Usage: cairn mcp serve [options]\n" +
+        "  --repo-root <path>   adopted-project repo root (default: CAIRN_REPO_ROOT or cwd)\n" +
+        "  --run-id <id>        scope telemetry to a run id (default: top-level)\n" +
+        "\n" +
+        "Speaks MCP over stdio. Register in .claude/settings.json mcpServers block.");
+    process.exit(1);
+}
+export async function mcpCli(argv) {
+    const { positional, flags } = parseArgs(argv);
+    if (positional[0] !== "serve")
+        usage();
+    const repoRoot = typeof flags["repo-root"] === "string"
+        ? resolve(flags["repo-root"])
+        : process.env["CAIRN_REPO_ROOT"]
+            ? resolve(process.env["CAIRN_REPO_ROOT"])
+            : process.cwd();
+    const runId = typeof flags["run-id"] === "string" ? flags["run-id"] : undefined;
+    const ctx = createContext({
+        repoRoot,
+        ...(runId !== undefined ? { runId } : {}),
+    });
+    const { close } = await startMcpServer({ ctx });
+    const shutdown = async (signal) => {
+        log.info({ signal }, "shutdown signal received");
+        await close();
+        process.exit(0);
+    };
+    process.on("SIGINT", () => void shutdown("SIGINT"));
+    process.on("SIGTERM", () => void shutdown("SIGTERM"));
+    await new Promise(() => {
+        /* event loop kept alive by the stdio transport */
+    });
+}
+//# sourceMappingURL=mcp.js.map

package/dist/cli/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/cli/mcp.ts"],"names":[],"mappings":"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"}

package/dist/cli/mirror.d.ts

@@ -0,0 +1 @@
+export declare function mirrorCli(argv: string[]): Promise<void>;

package/dist/cli/mirror.js

@@ -0,0 +1,97 @@
+import { resolve } from "node:path";
+import { ensureMirror, normalizeProjectName, pushMirror, readMirrorRecord, syncMirror, } from "@devplusllc/harness-core";
+function parseArgs(argv) {
+    const positional = [];
+    const flags = {};
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === undefined)
+            continue;
+        if (arg.startsWith("--")) {
+            const key = arg.slice(2);
+            const next = argv[i + 1];
+            if (next !== undefined && !next.startsWith("--")) {
+                flags[key] = next;
+                i += 1;
+            }
+            else {
+                flags[key] = true;
+            }
+        }
+        else {
+            positional.push(arg);
+        }
+    }
+    return { positional, flags };
+}
+function usage() {
+    console.error("Usage: harness mirror <subcommand> [options]\n" +
+        "  init    --project <name> --origin <url> --user-tree <path> [--branch <name>]\n" +
+        "  sync    --project <name> [--branch <name>]\n" +
+        "  push    --project <name> [--branch <name>] [--force]\n" +
+        "  status  --project <name>");
+    process.exit(1);
+}
+function require_(flags, key) {
+    const value = flags[key];
+    if (typeof value !== "string" || value.length === 0) {
+        console.error(`Missing required --${key}`);
+        usage();
+    }
+    return value;
+}
+export async function mirrorCli(argv) {
+    const { positional, flags } = parseArgs(argv);
+    const sub = positional[0];
+    switch (sub) {
+        case "init": {
+            const project = normalizeProjectName(require_(flags, "project"));
+            const origin = require_(flags, "origin");
+            const userTree = resolve(require_(flags, "user-tree"));
+            const defaultBranch = typeof flags["branch"] === "string" ? flags["branch"] : undefined;
+            const record = await ensureMirror({
+                projectName: project,
+                originUrl: origin,
+                userTreePath: userTree,
+                ...(defaultBranch !== undefined ? { defaultBranch } : {}),
+            });
+            console.log(JSON.stringify(record, null, 2));
+            return;
+        }
+        case "sync": {
+            const project = normalizeProjectName(require_(flags, "project"));
+            const branch = typeof flags["branch"] === "string" ? flags["branch"] : undefined;
+            const result = await syncMirror({
+                projectName: project,
+                ...(branch !== undefined ? { branch } : {}),
+            });
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        case "push": {
+            const project = normalizeProjectName(require_(flags, "project"));
+            const branch = typeof flags["branch"] === "string" ? flags["branch"] : undefined;
+            const force = flags["force"] === true;
+            const result = await pushMirror({
+                projectName: project,
+                ...(branch !== undefined ? { branch } : {}),
+                force,
+            });
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        case "status": {
+            const project = normalizeProjectName(require_(flags, "project"));
+            const record = readMirrorRecord(project);
+            if (!record) {
+                console.log(JSON.stringify({ projectName: project, status: "not_adopted" }, null, 2));
+                process.exit(0);
+            }
+            console.log(JSON.stringify({ status: "adopted", record }, null, 2));
+            return;
+        }
+        default:
+            usage();
+    }
+}
+//# sourceMappingURL=mirror.js.map

package/dist/cli/mirror.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mirror.js","sourceRoot":"","sources":["../../src/cli/mirror.ts"],"names":[],"mappings":"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"}

package/dist/cli/run.d.ts

@@ -0,0 +1 @@
+export declare function runCli(argv: string[]): Promise<void>;