foldrun 20.5.3 → 20.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/bin/foldrun.mjs CHANGED
@@ -258,6 +258,7 @@ const HELP = `foldrun — agents are just folders
258
258
  foldrun pull [workspace] bring the platform's account down here (refuses to clobber; --force overrides)
259
259
  foldrun export [workspace] a deployed workspace as a .zip — agents, flows, tools, skills, scripts, evals, knowledge; never memory, state or secret values (--flow <name> or --agent <name> for one, with what it needs; --file <path>|-, --force)
260
260
  foldrun import <file.zip> take a package in: shows what it adds, would replace and still needs, then asks (--to <workspace>; a new name makes a workspace; --dry-run, --overwrite, --yes, --json)
261
+ foldrun snapshot push [dir] send a git folder for an agent on foldrun to work on: what git would commit, checked for secrets here and on the platform, answers the snapshot id (--to <workspace>; --dry-run, --out <file.tar.gz> (--force over one that is there), --json)
261
262
  foldrun status [workspace] per workspace: what is added, changed or gone since the last deploy
262
263
  foldrun status --platform is the platform up: each component, and any incident or maintenance posted (--json)
263
264
  foldrun status --platform --history uptime per component per day and the incidents in the window, as the status page's bars (--days 1-90, default 90; --json)
package/docs/api.md CHANGED
@@ -199,7 +199,7 @@ history with each message.
199
199
  |---|---|---|
200
200
  | `/api/workspaces/<ws>/agents` | GET, POST | list — each agent's frontmatter as read, `owner` and `ownerFrom` (its own `owner:`, else the workspace's, else the account's), `lastRunAt` (when its latest step that ran started, from the runs kept; null for none) and `stale` (past `alerts: stale_days`); create (`name`) |
201
201
  | `/api/workspaces/<ws>/agents/<agent>` | PATCH | edit one line of an agent's frontmatter in place, as the flow canvas does: `{ list: { key, name, action } }` — `key` one of `subagents`, `agents`, `tools`; `action` `add` or `remove` — or `{ set: { key: "description" | "sandbox", value } }` (`sandbox` takes `own` or `parent`, else 400), or `{ network }` — the sites its sandbox may reach: `"open"`, `"trusted"`, `"none"`, a list of sites, or `{ level, allow, defaults }`; `null` removes the line so it inherits ([Network](network)). A `network` nobody could read is a 400 that says why. Only that key's lines change — comments, key order and prose stay. Answers `{ ok, changed }`; 404 for an unknown agent. `workspace:write` |
202
- | `/api/workspaces/<ws>/agents/<agent>/run` | POST | run one agent alone (`task`; `test: true` for a test run) |
202
+ | `/api/workspaces/<ws>/agents/<agent>/run` | POST | run one agent alone (`task`; `test: true` for a test run; `snapshot`: a folder to work on, the id `POST …/snapshots` answered — the step finds it in `snapshot/`, only its `outputs/` come back to the workspace, and the run's outputs hold `snapshot.patch`, the change as a git patch, with `snapshot.json` saying what it touched or why there is none. Needs the k8s sandbox: `409` on an install without it, `404` for a snapshot not in this workspace) |
203
203
  | `/api/workspaces/<ws>/agents/import` | GET, POST | copy an agent in from another workspace of the account. GET lists what could be imported (every other workspace you can read, with its agents). POST `{ from, agent, as? }` copies `agents/<agent>/` — its agent.md and own skills/, scripts/, knowledge/; never memory/, outputs/, state/ — and answers `{ name, files, warnings }`; `warnings` names tools, skills, scripts and secrets the copy uses that this workspace lacks. 409 on a name clash (pass `as`), 404 for an unknown workspace or agent, 403 when `from` is outside your key's scope. Idempotent |
204
204
  | `/api/workspaces/<ws>/proposals` | GET | the workspace's proposed fixes, newest first (`404` when the workspace does not exist): `{ proposals: [{ id, workspace, eval, by (auto, or who asked), createdAt, updatedAt, status, failures: [{ runId?, case?, check, detail, at }], jobId, reply (the assistant's reasoning), files: [{ path, content, before, sha256 }], issues: [{ where, message, level }], error?, notes?, decidedBy?, decidedAt?, applied? }] }`. `status` is `drafting`, `ready`, `failed`, `applying`, `applied`, `partial` (a write failed part-way; `applied` names what was written) or `dismissed`. `?status=`, `?eval=`. A drafting one is settled as it is read |
205
205
  | `/api/workspaces/<ws>/proposals/<id>` | GET, POST | one proposal. `POST { action: "apply" }` writes its files, each a revision by the caller, only when every one still reads what it was drawn against (`409` naming the file that changed) and can be written (`422`; a check error the deploy would refuse is `422` too); `POST { action: "dismiss" }` sets it aside — its failures stay looked at. Only agents, flows and skills are ever in one. Needs `workspace:write` |
package/docs/cli.md CHANGED
@@ -132,6 +132,7 @@ claude.ai or Claude Code there, nor any MCP configuration on disk.
132
132
  | `foldrun pull [workspace]` | bring the platform's account down into this folder — refuses to overwrite a locally edited file, and names every one it would have taken (`--force` takes them) |
133
133
  | `foldrun export [workspace]` | a deployed workspace as a `.zip` — agents, flows, tools, skills, scripts, evals, knowledge; never memory, state, storage or a secret's value. `--flow <name>` exports that flow with every flow and agent it runs and the tools, skills and scripts they grant; `--agent <name>` that agent and what it grants. Written under the name the platform gives it (`<ws>.zip`, `<ws>-flow-<name>.zip`); `--file <path>` (`-` for stdout), `--force` to replace (`GET …/export`) |
134
134
  | `foldrun import <file.zip>` | take a package in: first shows what it adds, what is identical, what it would replace and what it still needs (secrets, tools, skills, scripts, agents, flows), then asks. Never deletes; replacing a file needs `--overwrite`. `--to <workspace>` (a name that does not exist makes it, from a workspace package), `--dry-run` previews only (`--json` for the plan), `--yes` with no terminal (`POST …/import`) |
135
+ | `foldrun snapshot push [dir]` | send a folder for an agent on foldrun to work on (a snapshot). What goes is what git would commit — tracked files and untracked ones `.gitignore` does not exclude, as they are on disk; links and submodules are left out and named. A secret in any file stops it before anything leaves the machine (remove it, or leave the file out with `.gitignore`); the platform checks again. Answers the snapshot id, kept 7 days from the last send and while a run uses it. `--to <workspace>`, `--dry-run` packs and checks only, `--out <file.tar.gz>` keeps the archive (`--force` over a file that is there), `--json` (`POST …/snapshots`) |
135
136
  | `foldrun status [workspace]` | per workspace: what is added, changed and only-on-the-platform, plus which files moved there since your last deploy from here. Reads only |
136
137
  | `foldrun status --platform` | is the platform up: overall, each component (dashboard and API, run workers, scheduler, model providers, email, storage) and any incident or maintenance the operator posted, with its latest update. Reads the open `/api/status` — no key needed; the signed-in platform, `--url` / `FOLDRUN_URL`, or the default, dash.foldrun.io. `--json` prints the answer as is. Exits 1, saying *status unavailable — the platform may be down*, when it does not answer. Plain `foldrun status` opens with the same one-line verdict |
137
138
  | `foldrun status --platform --history` | what the status page draws as bars: each component's uptime over the window and a mark per day — up, degraded or maintenance, an outage, or no samples — then the incidents and maintenance in it, from the open `GET /api/status/history?days=<n>`. `--days 1-90` (default 90), `--json` |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "foldrun",
3
- "version": "20.5.3",
3
+ "version": "20.6.0",
4
4
  "description": "Agents are just folders. Write them, check them, run them — on your machine.",
5
5
  "license": "FSL-1.1-ALv2",
6
6
  "type": "module",
@@ -22,7 +22,7 @@
22
22
  ],
23
23
  "scripts": {
24
24
  "e2e": "FOLDRUN_E2E=1 FOLDRUN_DATA=$(mktemp -d /tmp/foldrun-e2e-XXXXXX) node --test --test-timeout=300000 tests/e2e.test.ts",
25
- "test": "FOLDRUN_DATA=$(mktemp -d /tmp/foldrun-test-XXXXXX) node --test tests/cli-account.test.ts tests/model-credential.test.ts tests/cli-approvals.test.ts tests/cli-issues.test.ts tests/cli-capture.test.ts tests/cli-stop.test.ts tests/cli-account-settings.test.ts tests/cli-team-me.test.ts tests/cli-schedule.test.ts tests/cli-billing.test.ts tests/cli-storage.test.ts tests/cli-scaffold.test.ts tests/cli-secrets.test.ts tests/cli-site-login.test.ts tests/cli-check-library.test.ts tests/cli-check-timezone.test.ts tests/cli-check-frontmatter.test.ts tests/cli-agent-import.test.ts tests/cli-check-subagents.test.ts tests/cli-connect.test.ts tests/cli-accounts.test.ts tests/cli-remote.test.ts tests/cli-stream.test.ts tests/cli-doctor.test.ts tests/cli-tool-test.test.ts tests/cli-agent-run.test.ts tests/cli-check-remote.test.ts tests/cli-shares.test.ts tests/cli-triggers.test.ts tests/cli-providers.test.ts tests/cli-rerun-put.test.ts tests/cli-guide.test.ts tests/cli-runtimes.test.ts tests/cli-deploy-safety.test.ts tests/cli-operator.test.ts tests/cli-flow-patterns.test.ts tests/cli-flow-rm-step.test.ts tests/cli-flow-dup-step.test.ts tests/cli-flow-write-stale.test.ts tests/cli-agent-link-stale.test.ts tests/cli-agent-link-isolated.test.ts tests/cli-parity.test.ts tests/cli-invoke-inputs.test.ts tests/cli-audit-keys.test.ts tests/cli-version.test.ts tests/cli-check-web-warnings.test.ts tests/cli-report-image.test.ts tests/cli-report-cache.test.ts tests/cli-check-workspace-paths.test.ts tests/cli-parity-dashboard.test.ts tests/cli-api-standards.test.ts tests/cli-backups-onboarding.test.ts tests/cli-check-limits.test.ts tests/cli-gallery.test.ts tests/cli-status-platform.test.ts tests/cli-webhooks-notifications.test.ts tests/cli-flags.test.ts tests/cli-api-coverage.test.ts tests/cli-hooks.test.ts tests/cli-release.test.ts tests/cli-terminal.test.ts tests/cli-network.test.ts tests/cli-assistant.test.ts tests/cli-check-scan.test.ts tests/cli-published.test.ts tests/cli-init-target.test.ts tests/cli-flow-filter.test.ts tests/cli-eval-grades.test.ts tests/cli-eval-compare.test.ts tests/cli-proposals.test.ts tests/cli-inbox.test.ts tests/cli-usage-compute.test.ts tests/cli-fol105.test.ts tests/cli-key-renew.test.ts tests/cli-wait-failed.test.ts tests/cli-mcp.test.ts tests/cli-a2a.test.ts tests/cli-gateway.test.ts tests/cli-switches.test.ts tests/cli-parity-runs.test.ts tests/cli-parity-b.test.ts tests/cli-parity-clears.test.ts tests/cli-parity-c.test.ts tests/cli-runs-paging.test.ts tests/cli-budget-invoices.test.ts tests/cli-observe-analysis.test.ts tests/cli-failure-retention.test.ts",
25
+ "test": "FOLDRUN_DATA=$(mktemp -d /tmp/foldrun-test-XXXXXX) node --test tests/cli-account.test.ts tests/model-credential.test.ts tests/cli-approvals.test.ts tests/cli-issues.test.ts tests/cli-capture.test.ts tests/cli-stop.test.ts tests/cli-account-settings.test.ts tests/cli-team-me.test.ts tests/cli-schedule.test.ts tests/cli-billing.test.ts tests/cli-storage.test.ts tests/cli-scaffold.test.ts tests/cli-secrets.test.ts tests/cli-site-login.test.ts tests/cli-check-library.test.ts tests/cli-check-timezone.test.ts tests/cli-check-frontmatter.test.ts tests/cli-agent-import.test.ts tests/cli-check-subagents.test.ts tests/cli-connect.test.ts tests/cli-accounts.test.ts tests/cli-remote.test.ts tests/cli-stream.test.ts tests/cli-doctor.test.ts tests/cli-tool-test.test.ts tests/cli-agent-run.test.ts tests/cli-check-remote.test.ts tests/cli-shares.test.ts tests/cli-triggers.test.ts tests/cli-providers.test.ts tests/cli-rerun-put.test.ts tests/cli-guide.test.ts tests/cli-runtimes.test.ts tests/cli-deploy-safety.test.ts tests/cli-operator.test.ts tests/cli-flow-patterns.test.ts tests/cli-flow-rm-step.test.ts tests/cli-flow-dup-step.test.ts tests/cli-flow-write-stale.test.ts tests/cli-agent-link-stale.test.ts tests/cli-agent-link-isolated.test.ts tests/cli-parity.test.ts tests/cli-invoke-inputs.test.ts tests/cli-audit-keys.test.ts tests/cli-version.test.ts tests/cli-check-web-warnings.test.ts tests/cli-report-image.test.ts tests/cli-report-cache.test.ts tests/cli-check-workspace-paths.test.ts tests/cli-parity-dashboard.test.ts tests/cli-api-standards.test.ts tests/cli-backups-onboarding.test.ts tests/cli-check-limits.test.ts tests/cli-gallery.test.ts tests/cli-status-platform.test.ts tests/cli-webhooks-notifications.test.ts tests/cli-flags.test.ts tests/cli-api-coverage.test.ts tests/cli-hooks.test.ts tests/cli-release.test.ts tests/cli-terminal.test.ts tests/cli-network.test.ts tests/cli-assistant.test.ts tests/cli-check-scan.test.ts tests/cli-published.test.ts tests/cli-init-target.test.ts tests/cli-flow-filter.test.ts tests/cli-eval-grades.test.ts tests/cli-eval-compare.test.ts tests/cli-proposals.test.ts tests/cli-inbox.test.ts tests/cli-usage-compute.test.ts tests/cli-fol105.test.ts tests/cli-key-renew.test.ts tests/cli-wait-failed.test.ts tests/cli-mcp.test.ts tests/cli-a2a.test.ts tests/cli-gateway.test.ts tests/cli-switches.test.ts tests/cli-parity-runs.test.ts tests/cli-parity-b.test.ts tests/cli-parity-clears.test.ts tests/cli-parity-c.test.ts tests/cli-runs-paging.test.ts tests/cli-budget-invoices.test.ts tests/cli-observe-analysis.test.ts tests/cli-failure-retention.test.ts tests/cli-snapshot.test.ts",
26
26
  "release": "node scripts/release.mjs",
27
27
  "typecheck": "tsc -p tsconfig.json",
28
28
  "docs:sync": "node scripts/sync-docs.mjs",
package/src/commands.mjs CHANGED
@@ -11,7 +11,7 @@ import path from "node:path";
11
11
  import { fileURLToPath } from "node:url";
12
12
  import { writeAgentFiles, hasCurrentAgentRules, agentRulesBlock, codingAgent, docsDir, docPages, docPage } from "./guide.mjs";
13
13
  import { createRequire } from "node:module";
14
- import { execFileSync } from "node:child_process";
14
+ import { execFileSync, spawnSync } from "node:child_process";
15
15
  import { defaultPlatform, saveCredential, removeCredential, normaliseUrl, profileByName, currentProfile, useProfile, listProfiles, credentialsDir } from "./credentials.mjs";
16
16
 
17
17
  // NO_COLOR (no-color.org) turns the escapes off — for a log file, a CI
@@ -11365,6 +11365,130 @@ async function importCmd(positional, flags, layout) {
11365
11365
  return 0;
11366
11366
  }
11367
11367
 
11368
+ /**
11369
+ * `foldrun snapshot push [dir] --to <workspace>` — send a folder for an agent
11370
+ * on foldrun to work on (Part B3). What goes is what git would commit: the
11371
+ * tracked files and the untracked ones .gitignore does not exclude
11372
+ * (`git ls-files --cached --others --exclude-standard`), as they are on disk
11373
+ * now. Links and anything that is not a plain file are left out and named.
11374
+ * Checked HERE before anything leaves the machine — a secret in any file
11375
+ * stops it, with no way to silence it but removing the secret or the file —
11376
+ * and checked again by the platform. Answers the snapshot id a run takes.
11377
+ */
11378
+ async function snapshotCmd(positional, flags, layout) {
11379
+ const verb = positional[0];
11380
+ if (verb !== "push") throw new Error("`foldrun snapshot push [dir] --to <workspace>` — send a git folder for an agent on foldrun to work on (--dry-run, --out <file.tar.gz> [--force], --json)");
11381
+ const dir = path.resolve(positional[1] ?? ".");
11382
+ if (!fs.existsSync(dir) || !fs.statSync(dir).isDirectory()) throw new Error(`${dir} is not a folder`);
11383
+ const git = spawnSync("git", ["-C", dir, "ls-files", "-z", "--cached", "--others", "--exclude-standard"], { encoding: "buffer", maxBuffer: 256 * 1024 * 1024 });
11384
+ if (git.error || git.status !== 0) {
11385
+ throw new Error(`${dir} is not in a git repository — a snapshot sends what git would commit, so \`git init\` it first (${String(git.stderr ?? git.error?.message ?? "").trim().split("\n")[0]})`);
11386
+ }
11387
+ const { packSnapshot, SnapshotRefused, SNAPSHOT_LIMITS } = await import("@foldrun/core/snapshot-archive");
11388
+ const { uploadSecretFindings } = await import("@foldrun/core/scan");
11389
+ const names = [...new Set(git.stdout.toString("utf8").split("\0").filter(Boolean))].sort();
11390
+ const entries = [];
11391
+ const left = [];
11392
+ let total = 0;
11393
+ const realDir = fs.realpathSync(dir);
11394
+ for (const rel of names) {
11395
+ const abs = path.join(dir, rel);
11396
+ let st;
11397
+ try {
11398
+ st = fs.lstatSync(abs);
11399
+ } catch {
11400
+ continue; // tracked, but deleted on disk: it is not in the folder now
11401
+ }
11402
+ // lstat looks through a link in a PARENT: a tracked folder replaced by a
11403
+ // link to elsewhere still lists its old children (Codex). A file goes only
11404
+ // when its real path is exactly <folder>/<path> — no link on the way.
11405
+ if (st.isFile()) {
11406
+ let real = "";
11407
+ try {
11408
+ real = fs.realpathSync(abs);
11409
+ } catch {
11410
+ /* gone meanwhile */
11411
+ }
11412
+ if (real !== path.join(realDir, rel)) {
11413
+ left.push(`${rel} (under a link)`);
11414
+ continue;
11415
+ }
11416
+ }
11417
+ if (!st.isFile()) {
11418
+ left.push(`${rel} (${st.isSymbolicLink() ? "a link" : st.isDirectory() ? "a submodule" : "not a plain file"})`);
11419
+ continue;
11420
+ }
11421
+ if (st.size > SNAPSHOT_LIMITS.maxFileBytes) throw new Error(`${rel} is ${st.size} bytes — the most for one file is ${SNAPSHOT_LIMITS.maxFileBytes}; add it to .gitignore or remove it`);
11422
+ total += st.size;
11423
+ if (total > SNAPSHOT_LIMITS.maxTotalBytes) throw new Error(`the folder is past ${SNAPSHOT_LIMITS.maxTotalBytes} bytes — leave out build output and dependencies (.gitignore)`);
11424
+ entries.push({ path: rel, mode: st.mode & 0o111 ? 0o755 : 0o644, content: fs.readFileSync(abs) });
11425
+ }
11426
+ if (!entries.length) throw new Error(`nothing to send — git sees no files in ${dir}`);
11427
+
11428
+ const scan = uploadSecretFindings(entries.map((e) => ({ path: e.path, content: e.content.toString("utf8") })));
11429
+ if (scan.findings.length) {
11430
+ for (const f of scan.findings.slice(0, 20)) console.error(` ${c.red("✗")} ${f.file}${f.line ? `:${f.line}` : ""} ${c.dim(f.rule)}`);
11431
+ throw new Error(`not sent: ${scan.findings.length} place${scan.findings.length === 1 ? "" : "s"} look${scan.findings.length === 1 ? "s" : ""} like a secret — remove ${scan.findings.length === 1 ? "it" : "them"} (or leave the file out with .gitignore) and push again; a snapshot cannot carry one`);
11432
+ }
11433
+
11434
+ // Files the scanner cannot read as text (a NUL early on): sent, but named,
11435
+ // so nobody takes "checked for secrets" to cover them.
11436
+ const unscanned = scan.unscanned;
11437
+ let packed;
11438
+ try {
11439
+ packed = packSnapshot(entries);
11440
+ } catch (err) {
11441
+ if (err instanceof SnapshotRefused) throw new Error(`not sent: ${err.message}`);
11442
+ throw err;
11443
+ }
11444
+ if (typeof flags.out === "string") {
11445
+ // Never over a file that is there unless asked (--force), as export does:
11446
+ // a preview must not be able to destroy a file named by mistake (Codex).
11447
+ if (fs.existsSync(flags.out) && flags.force !== true) throw new Error(`${flags.out} already exists — --force replaces it`);
11448
+ fs.writeFileSync(flags.out, packed.archive);
11449
+ }
11450
+ const summary = `${packed.files} file${packed.files === 1 ? "" : "s"}, ${packed.bytes} bytes (${packed.archive.length} compressed)`;
11451
+ if (flags["dry-run"] === true) {
11452
+ if (flags.json === true) console.log(JSON.stringify({ dryRun: true, snapshotId: packed.sha256, files: packed.files, bytes: packed.bytes, compressedBytes: packed.archive.length, leftOut: left, unscanned }, null, 2));
11453
+ else {
11454
+ console.log(`\n ${c.bold(summary)} ${c.dim(`· ${packed.sha256.slice(0, 12)}`)}`);
11455
+ for (const l of left.slice(0, 20)) console.log(` ${c.dim(`left out: ${l}`)}`);
11456
+ if (unscanned.length) console.log(` ${c.amber("!")} not checked for secrets (binary): ${unscanned.slice(0, 10).join(", ")}${unscanned.length > 10 ? " …" : ""}`);
11457
+ console.log(`\n ${c.dim("(--dry-run: nothing sent)")}\n`);
11458
+ }
11459
+ return 0;
11460
+ }
11461
+
11462
+ const url = platformFor(flags, "snapshot push");
11463
+ const ws = platformWorkspace(flags, layout, "snapshot push");
11464
+ const token = await renewedToken(url, flags);
11465
+ const res = await remoteFetch(
11466
+ url,
11467
+ `/api/workspaces/${enc(ws)}/snapshots`,
11468
+ { method: "POST", body: packed.archive, headers: { "content-type": "application/gzip" } },
11469
+ { token, seconds: timeoutSeconds(flags) },
11470
+ );
11471
+ const text = await res.text();
11472
+ let body = {};
11473
+ try {
11474
+ body = text.trim() ? JSON.parse(text) : {};
11475
+ } catch {
11476
+ /* not JSON — the status says enough */
11477
+ }
11478
+ if (!res.ok) throw new HttpError(`${body.error ?? `snapshot push → HTTP ${res.status}`}${res.status === 401 || res.status === 403 ? refusedHint(url, flags) : ""}`, res.status, body);
11479
+ if (flags.json === true) {
11480
+ console.log(JSON.stringify({ ...body, leftOut: left, unscanned }, null, 2));
11481
+ return 0;
11482
+ }
11483
+ console.log(`\n ${c.green("✓")} ${summary} → ${c.bold(ws)}${body.reused ? c.dim(" (already there)") : ""}`);
11484
+ console.log(` snapshot ${c.bold(String(body.snapshotId))}`);
11485
+ console.log(` ${c.dim(`kept until ${body.expiresAt}, and while a run uses it`)}`);
11486
+ for (const l of left.slice(0, 20)) console.log(` ${c.dim(`left out: ${l}`)}`);
11487
+ if (unscanned.length) console.log(` ${c.amber("!")} not checked for secrets (binary): ${unscanned.slice(0, 10).join(", ")}${unscanned.length > 10 ? " …" : ""}`);
11488
+ console.log();
11489
+ return 0;
11490
+ }
11491
+
11368
11492
  /**
11369
11493
  * `foldrun report <run-id> get <agent>/<path>` — one file a run archived:
11370
11494
  * whatever an agent left in outputs/, copied under the run when it ended.
@@ -14870,6 +14994,8 @@ export async function run(command, positional, flags, workspace, layout) {
14870
14994
  return exportCmd(positional, flags, layout);
14871
14995
  case "import":
14872
14996
  return importCmd(positional, flags, layout);
14997
+ case "snapshot":
14998
+ return snapshotCmd(positional, flags, layout);
14873
14999
  case "status":
14874
15000
  return statusCmd(layout, flags, positional[0]);
14875
15001
  case "workspaces":