openboot 0.1.0 → 0.1.1

package/README.md

@@ -1,18 +1,20 @@
-# Boot
+# Openboot
 
-Dev stack lifecycle manager. One command to setup, start, stop, and reboot your projects.
+Every project has the same problem: a README that says "run these 12 commands to get started," a `start.sh` that half works, Docker containers you forgot to start, and env vars you didn't set. New teammates spend hours just trying to run the thing.
+
+Then there's the AI problem: every tool wants its own instruction file — `.cursorrules`, `AGENTS.md`, `CLAUDE.md`. `SKILL.md`, `SOUL.md`, `copilot-instructions.md`, and you're copy-pasting the same conventions between projects and files.
+
+Boot fixes both. One config file, one command, everything starts, and your AI agent context stays in sync across every tool and every project.
 
 ```
-boot init     → creates boot.yaml (auto-detects your stack)
-boot setup    → one-time setup (deps, DB, migrations)
-boot up       → start everything (Docker + apps) in the background
-boot up -a    → start everything + stream logs (Ctrl+C detaches)
-boot dev      → interactive dev mode with live logs (Ctrl+C stops all)
-boot down     → stop everything
-boot reboot   → restart everything
-boot status   → show what's running
-boot logs     → view service logs (boot logs api -f)
-boot clean    → nuke deps, caches, build outputs for a fresh start
+boot init        → creates boot.yaml (auto-detects your stack)
+boot setup       → one-time setup (deps, DB, migrations)
+boot up          → start everything (Docker + apps)
+boot dev         → interactive dev mode with live logs
+boot down        → stop everything
+boot status      → show what's running
+boot logs        → view service logs
+boot agent init  → generate AI agent context for your tools
 ```
 
 ## Install
@@ -21,252 +23,83 @@ boot clean    → nuke deps, caches, build outputs for a fresh start
 npm install -g openboot
 ```
 
-Or use without installing:
+## Quick Start
 
 ```bash
-npx openboot init
+boot init        # auto-detects your stack, creates boot.yaml
+boot setup       # install deps, start DB, run migrations
+boot dev         # start everything with live logs (Ctrl+C stops all)
 ```
 
-## Quick Start
+That's it. Boot detects your Docker services, apps, package manager, env requirements, and generates the config.
+
+## AI Agent Context
+
+Boot generates instruction files for AI coding tools — one source of truth, synced to `.cursorrules`, `AGENTS.md`, `CLAUDE.md`, and `.github/copilot-instructions.md`.
 
 ```bash
-# In any project
-boot init       # creates boot.yaml by auto-detecting your stack
-boot setup      # one-time: install deps, start DB, run migrations
-boot up         # start Docker + all app processes
-boot dev        # or: start + stream live logs (Ctrl+C stops all)
+boot agent init      # generate from your stack + config
+boot agent sync      # regenerate after editing boot.yaml
+boot agent check     # verify targets are in sync (CI-friendly)
+boot agent remember  # save patterns that carry across projects
+boot agent save      # push conventions to your global store
+boot agent status    # see what Boot knows about your project
 ```
 
-That's it. `boot init` detects your Docker setup, apps, package manager, env requirements, and generates the config.
+Your conventions live in `~/.boot/agent/` and follow you to every project. When you run `boot agent init` in a new repo, your personal patterns are included automatically.
+
+Import from another project:
+
+```bash
+boot agent init --from ~/other-project
+```
 
 ## Config
 
-`boot init` creates a `boot.yaml` in your project root:
+`boot init` creates a `boot.yaml`:
 
 ```yaml
 name: my-project
 
-env:
-  file: .env
-  required:
-    - DATABASE_URL
-    - JWT_SECRET
-  reject:
-    JWT_SECRET:
-      - your-super-secret-jwt-key-change-this
-
 setup:
   - pnpm install
-  - pnpm db:generate
   - pnpm db:push
 
 docker:
-  # Option A: Docker Compose
   composeFile: docker-compose.yml
   services:
     - name: postgres
-      container: my-project-postgres
       readyCheck: pg_isready -U postgres
-      timeout: 30
-
-  # Option B: Standalone containers (no compose needed)
-  containers:
-    - name: my-db
-      image: postgres:15
-      ports:
-        - "5433:5432"
-      env:
-        POSTGRES_DB: myapp
-        POSTGRES_PASSWORD: secret
-      readyCheck: pg_isready -U postgres
-      timeout: 30
 
 apps:
   - name: api
     path: apps/api
     command: pnpm dev
     port: 3001
-    health: http://localhost:3001/health
   - name: web
     path: apps/web
     command: pnpm dev
     port: 3000
-    health: http://localhost:3000
-```
-
-### Config Reference
-
-| Field | Description |
-|-------|-------------|
-| `name` | Project name (display only) |
-| `packageManager` | `pnpm`, `npm`, or `yarn` (auto-detected if omitted) |
-| **env** | |
-| `env.file` | Path to `.env` file (default: `.env`) |
-| `env.required` | Env vars that must be set — `boot up` fails if missing |
-| `env.reject` | Values to reject per key (blocks example/default secrets) |
-| **setup** | |
-| `setup` | Commands to run on `boot setup` |
-| **docker** | |
-| `docker.composeFile` | Path to compose file (default: `docker-compose.yml`) |
-| `docker.services[].name` | Compose service name |
-| `docker.services[].container` | Container name for `docker exec` |
-| `docker.services[].readyCheck` | Command to check if service is ready |
-| `docker.services[].timeout` | Seconds to wait for readiness (default: 30) |
-| `docker.containers[].name` | Standalone container name |
-| `docker.containers[].image` | Docker image (e.g. `postgres:15`) |
-| `docker.containers[].ports` | Port mappings (e.g. `"5433:5432"`) |
-| `docker.containers[].env` | Environment variables for the container |
-| `docker.containers[].volumes` | Volume mounts |
-| `docker.containers[].readyCheck` | Readiness check command |
-| `docker.containers[].timeout` | Seconds to wait (default: 30) |
-| **apps** | |
-| `apps[].name` | App name (used for logs and PID tracking) |
-| `apps[].path` | Working directory relative to project root |
-| `apps[].command` | Command to start the app |
-| `apps[].port` | Port the app listens on |
-| `apps[].health` | URL to poll for health check |
-| `apps[].env` | Extra environment variables |
-
-## What `boot init` Auto-Detects
-
-- **Package manager** — from lockfiles (`pnpm-lock.yaml`, `yarn.lock`, `package-lock.json`)
-- **Docker Compose** — `docker-compose.yml` / `compose.yml`
-- **Raw Docker containers** — scans `scripts/*.sh` for `docker start` / `docker run` patterns
-- **Database services** — Postgres, MySQL, Redis (with appropriate readiness checks)
-- **Monorepo apps** — scans `apps/*/package.json` for dev scripts
-- **Sub-directory apps** — detects `dashboard/`, `frontend/`, `backend/`, `server/`, etc.
-- **Single-app projects** — detects `dev` or `start` scripts in root `package.json`
-- **Prisma** — detects `prisma/` directory and adds generate/push to setup
-- **Ports** — guesses 3000 for web/frontend, 3001 for api/server
-- **`.env` requirements** — parses `env.example` / `.env.example` for required and sensitive vars
-
-## What Each Command Does
-
-### `boot up`
-
-1. Checks prerequisites (Node.js 18+, Docker if needed)
-2. Auto-creates `.env` from template (`env.example` / `.env.example`) if missing
-3. Validates `.env` file (required vars, rejects default secrets)
-4. Ensures package manager is available (auto-enables pnpm/yarn via corepack)
-5. Auto-installs root deps if `node_modules` is missing
-6. Auto-installs per-app deps in monorepo sub-apps
-7. Smart Prisma check — generates client only if `.prisma` is missing
-8. Starts Docker (compose services and/or standalone containers)
-9. Waits for each service's readiness check
-10. Starts each app in the background
-11. Polls health URLs until ready
-12. Prints summary with URLs
-
-#### `boot up --attach` / `boot up -a`
-
-Same as `boot up` but after starting, streams all app logs to your terminal (color-coded by service). Press Ctrl+C to detach — services keep running in the background.
-
-### `boot dev`
-
-Interactive development mode — the closest replacement for your old `start.sh` scripts:
 
-1. Starts Docker services
-2. Starts all apps
-3. Streams live, color-coded logs for every service
-4. **Ctrl+C gracefully stops everything** (apps + Docker)
-
-This is the "one terminal" experience. No separate tabs needed.
-
-### `boot down`
-
-1. Stops all tracked app processes (SIGTERM → SIGKILL)
-2. Falls back to `pkill -f` if PID file is stale (catches orphan processes)
-3. Force-kills anything still holding app ports
-4. Stops standalone Docker containers
-5. Stops Docker Compose services
-
-### `boot status`
-
-Shows a table of all services with:
-- Status (running / stopped / port in use)
-- Port numbers
-- PIDs (with mismatch warnings if PID file ≠ port owner)
-- Process name (what binary is actually running, e.g. `node`, `nuxt`)
-- Live health checks (curl for apps, `pg_isready` / `redis-cli ping` for DBs)
-- Log file paths
-
-### `boot clean`
-
-Nukes everything for a fresh start:
-1. Removes `node_modules` in root and all sub-apps
-2. Removes lockfiles (`package-lock.json`, `yarn.lock`)
-3. Removes caches (`.nuxt`, `.next`, `.turbo`, `.vite`, `.parcel-cache`)
-4. Removes build outputs (`dist/`, `build/`)
-5. Removes `.boot/` runtime data (PIDs, logs)
-6. Pass `--all` to also remove `pnpm-lock.yaml`
-
-### `boot logs`
-
-View logs for any service:
-```bash
-boot logs                    # show recent logs for all services
-boot logs api                # show logs for a specific service
-boot logs api -f             # follow mode (like tail -f)
-boot logs api -n 100         # last 100 lines
-boot logs postgres           # Docker container logs too
-```
-
-### `boot setup`
-
-One-time setup with smart Prisma handling:
-1. Checks prerequisites (Node.js, Docker)
-2. Auto-creates `.env` from template
-3. Starts Docker services (DB needs to be up for migrations)
-4. Runs configured setup commands
-5. Smart Prisma: generate client + migrations with fallback (`migrate deploy` → `db push`)
-6. Non-fatal seed failures (skips gracefully)
-
-### `boot reboot`
-
-Runs `down` then `up`.
-
-## Development Workflow
-
-```bash
-# Option 1: Background (CI-friendly, scriptable)
-boot up               # starts everything, exits immediately
-boot logs api -f      # follow one service's logs in another terminal
-boot down             # stop when done
-
-# Option 2: Attach (start background + watch logs)
-boot up --attach      # starts everything, streams logs; Ctrl+C detaches (services stay up)
-boot down             # stop when done
+env:
+  required:
+    - DATABASE_URL
+    - JWT_SECRET
 
-# Option 3: Interactive (replaces start.sh)
-boot dev              # starts everything + live logs; Ctrl+C stops everything
+agent:
+  conventions:
+    - Use server components by default
+    - All DB access through Prisma
+  targets:
+    - .cursorrules
+    - AGENTS.md
+    - CLAUDE.md
+    - .github/copilot-instructions.md
 ```
 
-## Docker Support
-
-Boot handles two styles of Docker usage:
-
-### Docker Compose
-For projects with a `docker-compose.yml`:
-- `boot up` runs `docker compose up -d`
-- Detects port conflicts and auto-remaps to free ports
-- Reuses existing containers when possible
-
-### Standalone Containers
-For projects that use raw `docker run` (no compose):
-- Starts existing stopped containers with `docker start`
-- Creates new containers with `docker run -d` if needed
-- Port conflict detection + auto-remap
-
-## Process Management
-
-- App processes run in the background (detached)
-- PIDs are stored in `.boot/pids/`
-- Logs are written to `.boot/logs/`
-- `boot down` kills the full process tree (not just the parent)
-- Falls back to `pkill -f` for orphan process cleanup
-- Ports are freed before starting if occupied
+## Docs
 
-Add `.boot/` to your `.gitignore`.
+See [DETAILED.md](DETAILED.md) for the full config reference, auto-detection list, and command details.
 
 ## License
 

package/dist/cli.js

@@ -11,11 +11,12 @@ const status_1 = require("./commands/status");
 const clean_1 = require("./commands/clean");
 const logs_1 = require("./commands/logs");
 const dev_1 = require("./commands/dev");
+const agent_1 = require("./commands/agent");
 const program = new commander_1.Command();
 program
     .name("boot")
     .description("Dev stack lifecycle manager. One command to setup, start, stop, and reboot your projects.")
-    .version("0.1.0");
+    .version("0.1.1");
 program
     .command("init")
     .description("Auto-detect project structure and create boot.yaml")
@@ -128,5 +129,6 @@ program
         process.exit(1);
     }
 });
+(0, agent_1.registerAgentCommands)(program);
 program.parse();
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands/agent.d.ts

@@ -0,0 +1,6 @@
+import { Command } from "commander";
+/**
+ * Register all `boot agent` subcommands on the program.
+ */
+export declare function registerAgentCommands(program: Command): void;
+//# sourceMappingURL=agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/commands/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuBpC;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8R5D"}

package/dist/commands/agent.js

@@ -0,0 +1,293 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAgentCommands = registerAgentCommands;
+const path = __importStar(require("path"));
+const log_1 = require("../lib/log");
+const config_1 = require("../lib/config");
+const agent_1 = require("../lib/agent");
+/**
+ * Register all `boot agent` subcommands on the program.
+ */
+function registerAgentCommands(program) {
+    const agent = program
+        .command("agent")
+        .description("Manage AI agent context for your project");
+    // ─────────────────────────────────────────────
+    // boot agent init
+    // ─────────────────────────────────────────────
+    agent
+        .command("init")
+        .description("Generate AI agent context from your project stack")
+        .option("--from <path>", "Import conventions from another project")
+        .option("--no-global", "Exclude personal/global conventions from output")
+        .action(async (opts) => {
+        try {
+            const cwd = process.cwd();
+            log_1.log.header("boot agent init");
+            // Import from another project if --from specified
+            if (opts.from) {
+                const sourcePath = path.resolve(opts.from);
+                log_1.log.info(`Importing conventions from ${sourcePath}`);
+                const imported = (0, agent_1.importFromProject)(sourcePath);
+                if (imported.length > 0) {
+                    (0, agent_1.saveGlobalConventions)(imported);
+                    log_1.log.success(`Imported ${imported.length} conventions to global store`);
+                }
+                else {
+                    log_1.log.warn("No conventions found in source project");
+                }
+            }
+            // Get or detect config
+            const config = (0, agent_1.getOrDetectConfig)(cwd);
+            // Show detected stack
+            const stack = (0, agent_1.detectStack)(cwd);
+            if (stack.length > 0) {
+                log_1.log.info(`Stack: ${stack.map(agent_1.formatStackName).join(", ")}`);
+            }
+            // Show detected agent files
+            const existingFiles = (0, agent_1.detectAgentFiles)(cwd);
+            if (existingFiles.length > 0) {
+                log_1.log.info(`Existing agent files: ${existingFiles.join(", ")}`);
+            }
+            // Add agent section to boot.yaml if it exists but has no agent config
+            const configPath = (0, config_1.findConfig)(cwd);
+            if (configPath && !config.agent) {
+                const defaultAgent = {
+                    targets: agent_1.DEFAULT_TARGETS,
+                };
+                (0, agent_1.addAgentSection)(configPath, defaultAgent);
+                config.agent = defaultAgent;
+                log_1.log.success("Added agent section to boot.yaml");
+            }
+            // Generate and sync
+            const markdown = (0, agent_1.generateAgentMarkdown)(config, cwd, {
+                includeGlobal: opts.global,
+            });
+            const written = (0, agent_1.syncTargets)(config, markdown, cwd);
+            log_1.log.blank();
+            for (const file of written) {
+                log_1.log.success(`Wrote ${file}`);
+            }
+            log_1.log.blank();
+            log_1.log.step("Agent context synced to all targets.");
+            log_1.log.step("Edit the agent section in boot.yaml to add conventions.");
+            log_1.log.step("Run `boot agent sync` after making changes.");
+            log_1.log.blank();
+        }
+        catch (err) {
+            log_1.log.error(err.message);
+            process.exit(1);
+        }
+    });
+    // ─────────────────────────────────────────────
+    // boot agent sync
+    // ─────────────────────────────────────────────
+    agent
+        .command("sync")
+        .description("Regenerate and sync agent context to all target files")
+        .option("--no-global", "Exclude personal/global conventions from output")
+        .action(async (opts) => {
+        try {
+            const cwd = process.cwd();
+            const config = (0, agent_1.getOrDetectConfig)(cwd);
+            const markdown = (0, agent_1.generateAgentMarkdown)(config, cwd, {
+                includeGlobal: opts.global,
+            });
+            const written = (0, agent_1.syncTargets)(config, markdown, cwd);
+            for (const file of written) {
+                log_1.log.success(`Synced ${file}`);
+            }
+        }
+        catch (err) {
+            log_1.log.error(err.message);
+            process.exit(1);
+        }
+    });
+    // ─────────────────────────────────────────────
+    // boot agent check
+    // ─────────────────────────────────────────────
+    agent
+        .command("check")
+        .description("Check if agent target files are in sync with config")
+        .action(async () => {
+        try {
+            const cwd = process.cwd();
+            const config = (0, agent_1.getOrDetectConfig)(cwd);
+            const result = (0, agent_1.checkSync)(config, cwd);
+            for (const file of result.ok) {
+                log_1.log.success(`${file} — in sync`);
+            }
+            for (const file of result.stale) {
+                log_1.log.warn(`${file} — out of date`);
+            }
+            for (const file of result.missing) {
+                log_1.log.error(`${file} — missing`);
+            }
+            if (result.stale.length > 0 || result.missing.length > 0) {
+                log_1.log.blank();
+                log_1.log.step("Run `boot agent sync` to update all targets.");
+                process.exit(1);
+            }
+        }
+        catch (err) {
+            log_1.log.error(err.message);
+            process.exit(1);
+        }
+    });
+    // ─────────────────────────────────────────────
+    // boot agent save
+    // ─────────────────────────────────────────────
+    agent
+        .command("save")
+        .description("Save project conventions to your global store (~/.boot/agent/)")
+        .action(async () => {
+        try {
+            const cwd = process.cwd();
+            const config = (0, agent_1.getOrDetectConfig)(cwd);
+            if (!config.agent?.conventions ||
+                config.agent.conventions.length === 0) {
+                log_1.log.warn("No conventions defined in boot.yaml agent section.");
+                log_1.log.blank();
+                log_1.log.step("Add conventions to boot.yaml first:");
+                log_1.log.step("");
+                log_1.log.step("  agent:");
+                log_1.log.step("    conventions:");
+                log_1.log.step('      - "Your convention here"');
+                return;
+            }
+            (0, agent_1.saveGlobalConventions)(config.agent.conventions);
+            log_1.log.success(`Saved ${config.agent.conventions.length} conventions to global store`);
+            log_1.log.step(`Location: ${agent_1.AGENT_HOME}/conventions.md`);
+        }
+        catch (err) {
+            log_1.log.error(err.message);
+            process.exit(1);
+        }
+    });
+    // ─────────────────────────────────────────────
+    // boot agent remember
+    // ─────────────────────────────────────────────
+    agent
+        .command("remember <text...>")
+        .description("Remember a convention or pattern across all projects")
+        .action(async (textParts) => {
+        try {
+            const text = textParts.join(" ");
+            (0, agent_1.addMemory)(text);
+            log_1.log.success(`Remembered: ${text}`);
+            log_1.log.step("This will be included in all future agent context generation.");
+        }
+        catch (err) {
+            log_1.log.error(err.message);
+            process.exit(1);
+        }
+    });
+    // ─────────────────────────────────────────────
+    // boot agent status
+    // ─────────────────────────────────────────────
+    agent
+        .command("status")
+        .description("Show agent context status for this project")
+        .action(async () => {
+        try {
+            const cwd = process.cwd();
+            log_1.log.header("boot agent status");
+            // Stack
+            const stack = (0, agent_1.detectStack)(cwd);
+            if (stack.length > 0) {
+                log_1.log.info(`Stack: ${stack.map(agent_1.formatStackName).join(", ")}`);
+            }
+            else {
+                log_1.log.info("Stack: (none detected)");
+            }
+            // Existing agent files
+            const files = (0, agent_1.detectAgentFiles)(cwd);
+            if (files.length > 0) {
+                log_1.log.info(`Agent files: ${files.join(", ")}`);
+            }
+            else {
+                log_1.log.info("Agent files: (none found)");
+            }
+            // Config status
+            const configPath = (0, config_1.findConfig)(cwd);
+            if (configPath) {
+                const config = (0, config_1.loadConfig)(cwd);
+                if (config.agent) {
+                    log_1.log.info("Config: boot.yaml has agent section");
+                    if (config.agent.conventions?.length) {
+                        log_1.log.step(`  ${config.agent.conventions.length} project conventions`);
+                    }
+                    if (config.agent.targets?.length) {
+                        log_1.log.step(`  Targets: ${config.agent.targets.join(", ")}`);
+                    }
+                }
+                else {
+                    log_1.log.info("Config: boot.yaml exists but no agent section");
+                }
+            }
+            else {
+                log_1.log.info("Config: no boot.yaml (run `boot init` first)");
+            }
+            // Global store
+            const globalConv = (0, agent_1.loadGlobalConventions)();
+            const globalMem = (0, agent_1.loadGlobalMemory)();
+            log_1.log.info(`Global: ${globalConv.length} conventions, ${globalMem.length} remembered patterns`);
+            if (globalConv.length > 0 || globalMem.length > 0) {
+                log_1.log.step(`  Location: ${agent_1.AGENT_HOME}`);
+            }
+            // Sync status
+            if (configPath) {
+                const config = (0, config_1.loadConfig)(cwd);
+                const sync = (0, agent_1.checkSync)(config, cwd);
+                log_1.log.blank();
+                if (sync.ok.length > 0) {
+                    log_1.log.success(`${sync.ok.length} target(s) in sync`);
+                }
+                if (sync.stale.length > 0) {
+                    log_1.log.warn(`${sync.stale.length} target(s) out of date — run \`boot agent sync\``);
+                }
+                if (sync.missing.length > 0) {
+                    log_1.log.warn(`${sync.missing.length} target(s) missing — run \`boot agent sync\``);
+                }
+            }
+        }
+        catch (err) {
+            log_1.log.error(err.message);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=agent.js.map