@theholocron/cli 5.0.0-alpha.245 → 5.0.0-alpha.247

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/dist/cli.mjs CHANGED
@@ -33,7 +33,7 @@ import { generateReadme } from "@theholocron/components-doc/markdown";
33
33
  import { getClients, getConfigs, getDocs, getPlugins, getSkills, getThemes, getUtils } from "@theholocron/registry-doc";
34
34
  import { lintCommitMsgFile } from "@theholocron/astromech/lint";
35
35
  import { createGitHubClient } from "@theholocron/github-client";
36
- //#region src/env/env.ts
36
+ // src/env/env.ts
37
37
  /** Singleton env for simple global lookups throughout the CLI. */
38
38
  const env = createEnvLookup();
39
39
  /**
@@ -50,8 +50,7 @@ const holocronEnv = withEnvPrefix(env, "HOLOCRON");
50
50
  function makeEnv(source) {
51
51
  return createEnvLookup(source);
52
52
  }
53
- //#endregion
54
- //#region src/auth/keyring/keyring.ts
53
+ // src/auth/keyring/keyring.ts
55
54
  /**
56
55
  * Keyring-backed bootstrap credential store.
57
56
  *
@@ -120,8 +119,7 @@ function listStoredProviders() {
120
119
  return [];
121
120
  }
122
121
  }
123
- //#endregion
124
- //#region src/auth/auth-resolver/auth-resolver.ts
122
+ // src/auth/auth-resolver/auth-resolver.ts
125
123
  /**
126
124
  * Build a strict, single-feature token resolver.
127
125
  *
@@ -138,8 +136,7 @@ function createFeatureResolver(config) {
138
136
  return token;
139
137
  };
140
138
  }
141
- //#endregion
142
- //#region src/auth/token-args/token-args.ts
139
+ // src/auth/token-args/token-args.ts
143
140
  var TokenParseError = class extends Error {
144
141
  name = "TokenParseError";
145
142
  };
@@ -176,8 +173,7 @@ function parseTokenArgs(tokens) {
176
173
  if (Object.keys(cliTokens).length > 0) result.cliTokens = cliTokens;
177
174
  return result;
178
175
  }
179
- //#endregion
180
- //#region src/commands/contexts/contexts.ts
176
+ // src/commands/contexts/contexts.ts
181
177
  /**
182
178
  * Command → context. Keys are the full command path as it lands in
183
179
  * yargs' `argv._` (`"auth set"`, `"repo upgrade node"`), the bare verb
@@ -246,8 +242,7 @@ function contextForCommand(name) {
246
242
  function commandsInContext(context) {
247
243
  return Object.entries(COMMAND_CONTEXTS).filter(([, c]) => c === context).map(([name]) => name);
248
244
  }
249
- //#endregion
250
- //#region src/ui/non-interactive-error/non-interactive-error.ts
245
+ // src/ui/non-interactive-error/non-interactive-error.ts
251
246
  /**
252
247
  * Raised when a prompt is needed but stdin isn't a TTY. A non-TTY run (CI, a
253
248
  * script, a pipe) throws this instead of hanging on `@inquirer/prompts`, which
@@ -257,8 +252,7 @@ function commandsInContext(context) {
257
252
  var NonInteractiveError = class extends Error {
258
253
  name = "NonInteractiveError";
259
254
  };
260
- //#endregion
261
- //#region src/ui/json-view/json-view.ts
255
+ // src/ui/json-view/json-view.ts
262
256
  function isContainer(value) {
263
257
  return typeof value === "object" && value !== null;
264
258
  }
@@ -476,8 +470,7 @@ async function viewJson(value, options = {}) {
476
470
  const lines = renderTree(value, { expanded: expandToDepth(value, depth) });
477
471
  console.log(lines.map((l) => l.text).join("\n"));
478
472
  }
479
- //#endregion
480
- //#region src/ui/menu/menu.ts
473
+ // src/ui/menu/menu.ts
481
474
  /**
482
475
  * Searchable autocomplete over one menu level's `items`. `select()` would work too
483
476
  * at these list sizes, but `search()` degrades gracefully as the surface grows and
@@ -509,8 +502,7 @@ function searchChoices(items, term) {
509
502
  short: i.name.replace(/ ›$/, "")
510
503
  }));
511
504
  }
512
- //#endregion
513
- //#region src/ui/open-path/open-path.ts
505
+ // src/ui/open-path/open-path.ts
514
506
  /** Platform-appropriate command to open a path in the OS's file browser. */
515
507
  function openCommand(path) {
516
508
  if (process.platform === "darwin") return {
@@ -546,8 +538,7 @@ function openPath(path) {
546
538
  child.on("error", () => {});
547
539
  child.unref();
548
540
  }
549
- //#endregion
550
- //#region src/ui/progress/progress.ts
541
+ // src/ui/progress/progress.ts
551
542
  /**
552
543
  * Runs `fn`, showing an ora spinner for its duration in TTY environments.
553
544
  * In non-TTY environments (CI, pipes, tests) the spinner is skipped entirely.
@@ -615,8 +606,7 @@ function createProgress(print, enabled = progressEnabled) {
615
606
  function withProgress(label, fn) {
616
607
  return createProgress(() => {}).run(label, fn);
617
608
  }
618
- //#endregion
619
- //#region src/ui/prompt-options/prompt-options.ts
609
+ // src/ui/prompt-options/prompt-options.ts
620
610
  /**
621
611
  * A required option must not resolve to an empty answer — `optionArgv`/
622
612
  * `secretEnv` (child-argv.ts) both drop an empty-string value entirely,
@@ -809,8 +799,7 @@ async function promptForDeferredOptions(deferred) {
809
799
  for (const option of deferred) answers[option.key] = await promptOne(option);
810
800
  return answers;
811
801
  }
812
- //#endregion
813
- //#region src/ui/prompt-positionals/prompt-positionals.ts
802
+ // src/ui/prompt-positionals/prompt-positionals.ts
814
803
  /**
815
804
  * For each of `entry.positionals` not already present in `argv`, prompts for
816
805
  * it (`input()` or `select()`, per the positional's `type`) and returns the
@@ -844,8 +833,7 @@ async function promptForPositionals(entry, argv) {
844
833
  }
845
834
  return out;
846
835
  }
847
- //#endregion
848
- //#region src/ui/style/style.ts
836
+ // src/ui/style/style.ts
849
837
  const style = {
850
838
  success: (msg) => `${chalk.green("✓")} ${msg}`,
851
839
  warn: (msg) => `${chalk.yellow("⚠")} ${msg}`,
@@ -857,8 +845,7 @@ const style = {
857
845
  dim: (msg) => chalk.dim(msg),
858
846
  header: (msg) => chalk.bold(msg)
859
847
  };
860
- //#endregion
861
- //#region src/ui/status-row/status-row.ts
848
+ // src/ui/status-row/status-row.ts
862
849
  /** Right-pads `s` to `width` with spaces — never truncates. */
863
850
  function pad(s, width) {
864
851
  return s.length >= width ? s : s + " ".repeat(width - s.length);
@@ -878,8 +865,7 @@ function statusRow(status, columns) {
878
865
  const joined = columns.filter((c) => c.length > 0).join(" ");
879
866
  return ` ${status === "ok" ? style.success(joined) : status === "fail" ? style.fail(joined) : style.skip(joined)}`;
880
867
  }
881
- //#endregion
882
- //#region src/observability/logger/logger.ts
868
+ // src/observability/logger/logger.ts
883
869
  /**
884
870
  * Dataset for `global`-context commands (`clone`, `auth set`, `upgrade
885
871
  * node`, …) — ADR-0012. These commands aren't "about" any repo, so their
@@ -1025,8 +1011,7 @@ function reportError(message, log = getLogger()) {
1025
1011
  function getRunId() {
1026
1012
  return root?.runId;
1027
1013
  }
1028
- //#endregion
1029
- //#region src/observability/resolve-telemetry/resolve-telemetry.ts
1014
+ // src/observability/resolve-telemetry/resolve-telemetry.ts
1030
1015
  /**
1031
1016
  * Holocron-specific credential resolution for the telemetry sinks — the env
1032
1017
  * chain plus Holocron's own shipped fallbacks. This is **CLI policy**, not part
@@ -1060,8 +1045,7 @@ function resolvePostHogKey() {
1060
1045
  function resolvePostHogHost() {
1061
1046
  return holocronEnv.get("POSTHOG_HOST") ?? DEFAULT_POSTHOG_HOST;
1062
1047
  }
1063
- //#endregion
1064
- //#region src/observability/telemetry/telemetry.ts
1048
+ // src/observability/telemetry/telemetry.ts
1065
1049
  /**
1066
1050
  * CLI self-telemetry orchestration — errors (Sentry), usage analytics (PostHog).
1067
1051
  *
@@ -1204,8 +1188,7 @@ async function flush() {
1204
1188
  errors = new NoopErrorSink();
1205
1189
  analytics = new NoopAnalyticsSink();
1206
1190
  }
1207
- //#endregion
1208
- //#region src/cli-support/resolve-org/resolve-org.ts
1191
+ // src/cli-support/resolve-org/resolve-org.ts
1209
1192
  /**
1210
1193
  * Resolves the active org in priority order:
1211
1194
  * 1. `--org` CLI flag
@@ -1215,8 +1198,7 @@ async function flush() {
1215
1198
  function resolveOrg(argv, config) {
1216
1199
  return argv.org ?? env.get("HOLOCRON_ORG") ?? config.org;
1217
1200
  }
1218
- //#endregion
1219
- //#region src/cli-support/apply-resolved-config/apply-resolved-config.ts
1201
+ // src/cli-support/apply-resolved-config/apply-resolved-config.ts
1220
1202
  /**
1221
1203
  * `buildCliLogger` options derived from a loaded `holocron.config` — the
1222
1204
  * level, the Axiom dataset, and the resolved org for a keyring-backed
@@ -1240,8 +1222,7 @@ function applyResolvedConfig(argv, resolved) {
1240
1222
  buildCliLogger(argv, cliLoggerOpts(argv, resolved));
1241
1223
  applyConfig(resolved.telemetry);
1242
1224
  }
1243
- //#endregion
1244
- //#region src/interactive-menu/child-argv/child-argv.ts
1225
+ // src/interactive-menu/child-argv/child-argv.ts
1245
1226
  /**
1246
1227
  * Whether `option`'s answer must be delivered via env, never argv — true for
1247
1228
  * an explicit `secret: true`, and also for any `type: "password"` option
@@ -1328,8 +1309,7 @@ function secretEnv(resolved) {
1328
1309
  }
1329
1310
  return out;
1330
1311
  }
1331
- //#endregion
1332
- //#region src/commands/auth/auth-check.entry.ts
1312
+ // src/commands/auth/auth-check.entry.ts
1333
1313
  const authCheckEntry = {
1334
1314
  name: "auth check",
1335
1315
  description: "Re-verify a stored bootstrap token",
@@ -1340,15 +1320,13 @@ const authCheckEntry = {
1340
1320
  choices: listStoredProviders
1341
1321
  }]
1342
1322
  };
1343
- //#endregion
1344
- //#region src/commands/auth/auth-list.entry.ts
1323
+ // src/commands/auth/auth-list.entry.ts
1345
1324
  const authListEntry = {
1346
1325
  name: "auth list",
1347
1326
  description: "List every provider with a stored bootstrap token",
1348
1327
  positionals: []
1349
1328
  };
1350
- //#endregion
1351
- //#region src/commands/auth/auth-set.entry.ts
1329
+ // src/commands/auth/auth-set.entry.ts
1352
1330
  const authSetEntry = {
1353
1331
  name: "auth set",
1354
1332
  description: "Verify + store a bootstrap token for a provider",
@@ -1358,8 +1336,7 @@ const authSetEntry = {
1358
1336
  type: "input"
1359
1337
  }]
1360
1338
  };
1361
- //#endregion
1362
- //#region src/commands/auth/auth-unset.entry.ts
1339
+ // src/commands/auth/auth-unset.entry.ts
1363
1340
  const authUnsetEntry = {
1364
1341
  name: "auth unset",
1365
1342
  description: "Remove a stored bootstrap token",
@@ -1370,11 +1347,9 @@ const authUnsetEntry = {
1370
1347
  choices: listStoredProviders
1371
1348
  }]
1372
1349
  };
1373
- //#endregion
1374
- //#region src/interactive-menu/command-registry/validators.ts
1350
+ // src/interactive-menu/command-registry/validators.ts
1375
1351
  const numeric = (value) => /^\d+$/.test(value) ? true : "enter a number";
1376
- //#endregion
1377
- //#region src/commands/cleanup-preview/cleanup-preview.entry.ts
1352
+ // src/commands/cleanup-preview/cleanup-preview.entry.ts
1378
1353
  const cleanupPreviewEntry = {
1379
1354
  name: "deploy cleanup-preview",
1380
1355
  description: "List and delete Cloudflare Pages preview deployments for a GitHub PR",
@@ -1386,8 +1361,7 @@ const cleanupPreviewEntry = {
1386
1361
  }],
1387
1362
  supportsDryRun: true
1388
1363
  };
1389
- //#endregion
1390
- //#region src/commands/clone/clone.entry.ts
1364
+ // src/commands/clone/clone.entry.ts
1391
1365
  const cloneEntry = {
1392
1366
  name: "clone",
1393
1367
  description: "Clone a single repo (org/repo) or every repo in an org (org)",
@@ -1399,15 +1373,13 @@ const cloneEntry = {
1399
1373
  }],
1400
1374
  supportsDryRun: true
1401
1375
  };
1402
- //#endregion
1403
- //#region src/commands/config-show/config-show.entry.ts
1376
+ // src/commands/config-show/config-show.entry.ts
1404
1377
  const configShowEntry = {
1405
1378
  name: "config show",
1406
1379
  description: "Print the resolved holocron config",
1407
1380
  positionals: []
1408
1381
  };
1409
- //#endregion
1410
- //#region src/commands/deploy/deploy.entry.ts
1382
+ // src/commands/deploy/deploy.entry.ts
1411
1383
  const deployEntry = {
1412
1384
  name: "deploy",
1413
1385
  description: "Trigger a deployment via the configured `deployment` capability",
@@ -1418,24 +1390,21 @@ const deployEntry = {
1418
1390
  }],
1419
1391
  supportsDryRun: true
1420
1392
  };
1421
- //#endregion
1422
- //#region src/commands/deploy/deploy-on-release.entry.ts
1393
+ // src/commands/deploy/deploy-on-release.entry.ts
1423
1394
  const deployOnReleaseEntry = {
1424
1395
  name: "deploy on-release",
1425
1396
  description: "Deploy every workspace package whose delivery.deploy task is `on: release`",
1426
1397
  positionals: [],
1427
1398
  supportsDryRun: true
1428
1399
  };
1429
- //#endregion
1430
- //#region src/commands/doctor/doctor.entry.ts
1400
+ // src/commands/doctor/doctor.entry.ts
1431
1401
  const doctorEntry = {
1432
1402
  name: "doctor",
1433
1403
  description: "Load the config and run a smoke check against every provider",
1434
1404
  positionals: [],
1435
1405
  supportsDryRun: true
1436
1406
  };
1437
- //#endregion
1438
- //#region src/commands/doctor-notifications/doctor-notifications.entry.ts
1407
+ // src/commands/doctor-notifications/doctor-notifications.entry.ts
1439
1408
  const doctorNotificationsEntry = {
1440
1409
  name: "doctor notifications",
1441
1410
  description: "Check the layout against the server and the secrets store, step by step (a full run leaves one test post in the test channel; --built-only posts nothing unless --deliver)",
@@ -1449,8 +1418,7 @@ const doctorNotificationsEntry = {
1449
1418
  }],
1450
1419
  supportsDryRun: false
1451
1420
  };
1452
- //#endregion
1453
- //#region src/commands/monitoring-check/monitoring-check.entry.ts
1421
+ // src/commands/monitoring-check/monitoring-check.entry.ts
1454
1422
  const monitoringCheckEntry = {
1455
1423
  name: "monitoring check",
1456
1424
  description: "Run every configured `monitoring` check against a given URL instead of its own configured url",
@@ -1461,16 +1429,14 @@ const monitoringCheckEntry = {
1461
1429
  }],
1462
1430
  supportsDryRun: false
1463
1431
  };
1464
- //#endregion
1465
- //#region src/commands/new/new-repo.entry.ts
1432
+ // src/commands/new/new-repo.entry.ts
1466
1433
  const newRepoEntry = {
1467
1434
  name: "new repo",
1468
1435
  description: "Scaffold a new repo from a GitHub template (e.g. cli, react, nextjs, node, monorepo, base)",
1469
1436
  positionals: [],
1470
1437
  supportsDryRun: true
1471
1438
  };
1472
- //#endregion
1473
- //#region src/commands/notifications-channel-add/notifications-channel-add.entry.ts
1439
+ // src/commands/notifications-channel-add/notifications-channel-add.entry.ts
1474
1440
  const notificationsChannelAddEntry = {
1475
1441
  name: "notifications channel add",
1476
1442
  description: "Create a notification channel, optionally with a webhook whose URL is stored as a secret",
@@ -1481,8 +1447,7 @@ const notificationsChannelAddEntry = {
1481
1447
  }],
1482
1448
  supportsDryRun: true
1483
1449
  };
1484
- //#endregion
1485
- //#region src/commands/notifications-create-server/notifications-create-server.entry.ts
1450
+ // src/commands/notifications-create-server/notifications-create-server.entry.ts
1486
1451
  const notificationsCreateServerEntry = {
1487
1452
  name: "notifications create-server",
1488
1453
  description: "Create the server the layout describes, apply it, invite its owner and hand it over",
@@ -1518,8 +1483,7 @@ const notificationsCreateServerEntry = {
1518
1483
  ],
1519
1484
  supportsDryRun: true
1520
1485
  };
1521
- //#endregion
1522
- //#region src/commands/notifications-link/notifications-link.entry.ts
1486
+ // src/commands/notifications-link/notifications-link.entry.ts
1523
1487
  const notificationsLinkEntry = {
1524
1488
  name: "notifications link",
1525
1489
  description: "Link your server account to your GitHub account by signing in with the provider",
@@ -1532,16 +1496,14 @@ const notificationsLinkEntry = {
1532
1496
  }],
1533
1497
  supportsDryRun: true
1534
1498
  };
1535
- //#endregion
1536
- //#region src/commands/notifications-setup/notifications-setup.entry.ts
1499
+ // src/commands/notifications-setup/notifications-setup.entry.ts
1537
1500
  const notificationsSetupEntry = {
1538
1501
  name: "notifications setup",
1539
1502
  description: "Apply the server layout a notifications provider declares in holocron.config.ts",
1540
1503
  positionals: [],
1541
1504
  supportsDryRun: true
1542
1505
  };
1543
- //#endregion
1544
- //#region src/commands/notifications-sync-roles/notifications-sync-roles.entry.ts
1506
+ // src/commands/notifications-sync-roles/notifications-sync-roles.entry.ts
1545
1507
  const notificationsSyncRolesEntry = {
1546
1508
  name: "notifications sync-roles",
1547
1509
  description: "Make who holds a server role match a team, through the links file",
@@ -1560,8 +1522,7 @@ const notificationsSyncRolesEntry = {
1560
1522
  }],
1561
1523
  supportsDryRun: true
1562
1524
  };
1563
- //#endregion
1564
- //#region src/commands/npm-bump-versions/npm-bump-versions.entry.ts
1525
+ // src/commands/npm-bump-versions/npm-bump-versions.entry.ts
1565
1526
  const npmBumpVersionsEntry = {
1566
1527
  name: "package bump-versions",
1567
1528
  description: "Bump all non-private package versions in lockstep (semantic-release prepareCmd)",
@@ -1573,8 +1534,7 @@ const npmBumpVersionsEntry = {
1573
1534
  }],
1574
1535
  supportsDryRun: true
1575
1536
  };
1576
- //#endregion
1577
- //#region src/commands/plugin-create/plugin-create.entry.ts
1537
+ // src/commands/plugin-create/plugin-create.entry.ts
1578
1538
  const pluginCreateEntry = {
1579
1539
  name: "new plugin",
1580
1540
  description: "Scaffold a new @theholocron/holocron-plugin-<slug> package",
@@ -1589,16 +1549,14 @@ const pluginCreateEntry = {
1589
1549
  }],
1590
1550
  supportsDryRun: true
1591
1551
  };
1592
- //#endregion
1593
- //#region src/commands/probe/probe.entry.ts
1552
+ // src/commands/probe/probe.entry.ts
1594
1553
  const probeEntry = {
1595
1554
  name: "probe",
1596
1555
  description: "Poke a live provider on purpose: inspect it, or run a proof that cleans up after itself",
1597
1556
  positionals: [],
1598
1557
  opensMenu: true
1599
1558
  };
1600
- //#endregion
1601
- //#region src/commands/publish/publish.entry.ts
1559
+ // src/commands/publish/publish.entry.ts
1602
1560
  const PUBLISH_TAG_OPTION = {
1603
1561
  key: "tag",
1604
1562
  flag: "--tag",
@@ -1614,8 +1572,7 @@ const PUBLISH_OTP_OPTION = {
1614
1572
  required: Boolean(env.get("HOLOCRON_NPM_ENFORCE_2FA")),
1615
1573
  message: "One-time password (2FA), if npm requires it for this publish:"
1616
1574
  };
1617
- //#endregion
1618
- //#region src/interactive-menu/command-registry/command-registry.ts
1575
+ // src/interactive-menu/command-registry/command-registry.ts
1619
1576
  /**
1620
1577
  * The full command surface for the interactive menu. Each entry lives next to the command it describes
1621
1578
  * (`commands/<name>/<name>.entry.ts`) and is listed here in menu order; this module does not introspect yargs at runtime.
@@ -1795,8 +1752,7 @@ function getEntry(name) {
1795
1752
  if (!entry) throw new Error(`interactive-menu: no COMMAND_REGISTRY entry named "${name}"`);
1796
1753
  return entry;
1797
1754
  }
1798
- //#endregion
1799
- //#region src/interactive-menu/menu-items/menu-items.ts
1755
+ // src/interactive-menu/menu-items/menu-items.ts
1800
1756
  /** Prefix of a menu item's `value` that opens a submenu rather than running a command. */
1801
1757
  const GROUP = "group:";
1802
1758
  /** The "← back" item's value; only offered below the first level. */
@@ -1851,8 +1807,7 @@ function menuItems(entries, path = []) {
1851
1807
  }
1852
1808
  return items;
1853
1809
  }
1854
- //#endregion
1855
- //#region src/interactive-menu/launch-menu/launch-menu.ts
1810
+ // src/interactive-menu/launch-menu/launch-menu.ts
1856
1811
  /**
1857
1812
  * Set on a dry-run preview child's env ({@link spawnChild}'s `extraEnv`) so
1858
1813
  * its handler knows this specific `--dry-run` came from `launchMenu`'s own
@@ -1990,8 +1945,7 @@ async function launchMenu(entries, parentArgv, pickMessage, nonInteractiveMessag
1990
1945
  const forReal = await resolveForRealSpawn(resolvedOptions);
1991
1946
  process.exitCode = await spawnChild(buildChildArgv(picked, positionals, forReal, parentArgv), secretEnv(forReal));
1992
1947
  }
1993
- //#endregion
1994
- //#region src/interactive-menu/probe-menu-entries/probe-menu-entries.ts
1948
+ // src/interactive-menu/probe-menu-entries/probe-menu-entries.ts
1995
1949
  /**
1996
1950
  * One menu entry per probe, grouped under its provider (`probe sentry integrations`), for the menu `holocron probe`
1997
1951
  * opens on a terminal. Built from the loaded plugins, so the menu always shows exactly the probes that exist. A probe
@@ -2012,8 +1966,7 @@ function buildProbeMenuEntries(groups) {
2012
1966
  });
2013
1967
  return entries;
2014
1968
  }
2015
- //#endregion
2016
- //#region src/interactive-menu/run-menu-entries/run-menu-entries.ts
1969
+ // src/interactive-menu/run-menu-entries/run-menu-entries.ts
2017
1970
  /**
2018
1971
  * This repo's own resolved task manifest, filtered to what's actually
2019
1972
  * runnable locally — `Astromech.runnableTasks()`, reused rather than
@@ -2115,8 +2068,7 @@ function buildRunMenuEntries(taskNames) {
2115
2068
  }
2116
2069
  return entries;
2117
2070
  }
2118
- //#endregion
2119
- //#region src/cli-support/group-menu/group-menu.ts
2071
+ // src/cli-support/group-menu/group-menu.ts
2120
2072
  /** Layer 2: a bare group command (`holocron repo`, `holocron repo upgrade`, …) opens the menu at that level. */
2121
2073
  async function launchGroupMenu(parent, argv) {
2122
2074
  await launchMenu(COMMAND_REGISTRY, argv, `${parent} — choose a subcommand:`, `Run \`holocron ${parent} --help\` to see available ${parent} subcommands.`, parent.split(" "));
@@ -2130,8 +2082,7 @@ const groupMenu = (parent) => ({
2130
2082
  await launchGroupMenu(parent, argv);
2131
2083
  }
2132
2084
  });
2133
- //#endregion
2134
- //#region src/cli-support/parse-scope/parse-scope.ts
2085
+ // src/cli-support/parse-scope/parse-scope.ts
2135
2086
  /** `--scope` / `--github-secret-scope`: `repo`, `env=<name>` or `org=<name>`. */
2136
2087
  function parseScope(s) {
2137
2088
  if (s === "repo") return { kind: "repo" };
@@ -2145,8 +2096,7 @@ function parseScope(s) {
2145
2096
  };
2146
2097
  throw new Error(`invalid --scope "${s}" — expected "repo", "env=<name>", or "org=<name>"`);
2147
2098
  }
2148
- //#endregion
2149
- //#region src/cli-support/token-context/token-context.ts
2099
+ // src/cli-support/token-context/token-context.ts
2150
2100
  /** Parses --token values and returns the context spread, or null on parse error (exits with code 1). */
2151
2101
  function tokenContext(rawTokens) {
2152
2102
  if (!rawTokens?.length) return {};
@@ -2161,11 +2111,9 @@ function tokenContext(rawTokens) {
2161
2111
  throw err;
2162
2112
  }
2163
2113
  }
2164
- //#endregion
2165
- //#region src/commands/auth/auth-check.args.ts
2114
+ // src/commands/auth/auth-check.args.ts
2166
2115
  const authCheckArgs = (yy) => yy.positional("provider", { type: "string" });
2167
- //#endregion
2168
- //#region src/plugin/capabilities/capabilities.ts
2116
+ // src/plugin/capabilities/capabilities.ts
2169
2117
  const CARDINALITY = {
2170
2118
  source: "single",
2171
2119
  ci: "single",
@@ -2204,8 +2152,7 @@ var ElevationRequiredError = class extends Error {
2204
2152
  this.elevation = elevation;
2205
2153
  }
2206
2154
  };
2207
- //#endregion
2208
- //#region src/config/config/config.ts
2155
+ // src/config/config/config.ts
2209
2156
  var ConfigError = class extends Error {
2210
2157
  name = "ConfigError";
2211
2158
  };
@@ -2313,8 +2260,7 @@ function resolveConfig(raw) {
2313
2260
  eslint: raw.eslint
2314
2261
  };
2315
2262
  }
2316
- //#endregion
2317
- //#region src/config/load-config/load-config.ts
2263
+ // src/config/load-config/load-config.ts
2318
2264
  /**
2319
2265
  * `holocron.config.{ts,js,mjs,cjs,json}` loader.
2320
2266
  *
@@ -2370,8 +2316,7 @@ async function readPackageJsonName(dir) {
2370
2316
  const name = (await readPackageJson(dir))?.name;
2371
2317
  return name === void 0 ? void 0 : name.replace(/^@[^/]+\//, "");
2372
2318
  }
2373
- //#endregion
2374
- //#region src/plugin/loader/loader.ts
2319
+ // src/plugin/loader/loader.ts
2375
2320
  /**
2376
2321
  * `PluginLoader` — loads provider plugins per the resolved config and
2377
2322
  * builds a typed capability registry the runtime can query.
@@ -2543,8 +2488,7 @@ function isPluginModule(mod) {
2543
2488
  function isCapabilityConfigModule(mod) {
2544
2489
  return typeof mod.default?.provider === "string";
2545
2490
  }
2546
- //#endregion
2547
- //#region src/plugin/run-check/run-check.ts
2491
+ // src/plugin/run-check/run-check.ts
2548
2492
  async function runCheckAgainstUrl(input, opts = {}) {
2549
2493
  const doFetch = opts.fetch ?? fetch;
2550
2494
  const url = resolveUrl(input.url, opts.url);
@@ -2648,8 +2592,7 @@ function evaluate(comparison, actual, target) {
2648
2592
  case "less_than": return Number(actual) < Number(t);
2649
2593
  }
2650
2594
  }
2651
- //#endregion
2652
- //#region src/plugin/verify-vercel-project/verify-vercel-project.ts
2595
+ // src/plugin/verify-vercel-project/verify-vercel-project.ts
2653
2596
  /**
2654
2597
  * `true` only when Vercel's API confirms `url` resolves to a deployment
2655
2598
  * whose `projectId` matches `expectedProjectId` exactly. `false` for any
@@ -2684,8 +2627,7 @@ async function verifyVercelDeploymentProject(url, expectedProjectId, token, opts
2684
2627
  }
2685
2628
  return (typeof body === "object" && body !== null && "projectId" in body ? body.projectId : void 0) === expectedProjectId;
2686
2629
  }
2687
- //#endregion
2688
- //#region src/plugin/workspace/workspace.ts
2630
+ // src/plugin/workspace/workspace.ts
2689
2631
  /**
2690
2632
  * The `workspace`-context guard.
2691
2633
  *
@@ -2754,8 +2696,7 @@ function assertPluginsResolvable(loader, command) {
2754
2696
  if (!failures.every((f) => isImportFailure(f.error))) return;
2755
2697
  throw new WorkspaceContextError(command, [...new Set(failures.map((f) => f.packageName))]);
2756
2698
  }
2757
- //#endregion
2758
- //#region src/commands/auth/auth.ts
2699
+ // src/commands/auth/auth.ts
2759
2700
  /**
2760
2701
  * `holocron auth <subcommand>` — manage bootstrap credentials in the
2761
2702
  * OS keyring.
@@ -3035,8 +2976,7 @@ async function tryLoadHint(importer, packageName) {
3035
2976
  return null;
3036
2977
  }
3037
2978
  }
3038
- //#endregion
3039
- //#region src/commands/auth/auth-check.command.ts
2979
+ // src/commands/auth/auth-check.command.ts
3040
2980
  const authCheckCommand = {
3041
2981
  command: "check [provider]",
3042
2982
  describe: "Re-verify a stored bootstrap token",
@@ -3049,8 +2989,7 @@ const authCheckCommand = {
3049
2989
  })).status === "fail") process.exitCode = 1;
3050
2990
  }
3051
2991
  };
3052
- //#endregion
3053
- //#region src/commands/auth/auth-list.command.ts
2992
+ // src/commands/auth/auth-list.command.ts
3054
2993
  const authListCommand = {
3055
2994
  command: "list",
3056
2995
  describe: "List every provider with a stored bootstrap token",
@@ -3058,11 +2997,9 @@ const authListCommand = {
3058
2997
  await runAuthList();
3059
2998
  }
3060
2999
  };
3061
- //#endregion
3062
- //#region src/commands/auth/auth-set.args.ts
3000
+ // src/commands/auth/auth-set.args.ts
3063
3001
  const authSetArgs = (yy) => yy.positional("provider", { type: "string" }).positional("value", { type: "string" });
3064
- //#endregion
3065
- //#region src/commands/auth/auth-set.command.ts
3002
+ // src/commands/auth/auth-set.command.ts
3066
3003
  const authSetCommand = {
3067
3004
  command: "set [provider] [value]",
3068
3005
  describe: "Verify + store a bootstrap token for a provider",
@@ -3076,11 +3013,9 @@ const authSetCommand = {
3076
3013
  })).status === "fail") process.exitCode = 1;
3077
3014
  }
3078
3015
  };
3079
- //#endregion
3080
- //#region src/commands/auth/auth-unset.args.ts
3016
+ // src/commands/auth/auth-unset.args.ts
3081
3017
  const authUnsetArgs = (yy) => yy.positional("provider", { type: "string" });
3082
- //#endregion
3083
- //#region src/commands/auth/auth-unset.command.ts
3018
+ // src/commands/auth/auth-unset.command.ts
3084
3019
  const authUnsetCommand = {
3085
3020
  command: "unset [provider]",
3086
3021
  describe: "Remove a stored bootstrap token",
@@ -3090,16 +3025,14 @@ const authUnsetCommand = {
3090
3025
  runAuthUnset({ provider });
3091
3026
  }
3092
3027
  };
3093
- //#endregion
3094
- //#region src/commands/auth/auth.command.ts
3028
+ // src/commands/auth/auth.command.ts
3095
3029
  const authCommand = {
3096
3030
  command: "auth <subcommand>",
3097
3031
  describe: "Manage bootstrap credentials in the OS keyring",
3098
3032
  builder: (y) => y.command(authSetCommand).command(authUnsetCommand).command(authCheckCommand).command(authListCommand).command(groupMenu("auth")),
3099
3033
  handler: () => {}
3100
3034
  };
3101
- //#endregion
3102
- //#region src/commands/clone/clone.args.ts
3035
+ // src/commands/clone/clone.args.ts
3103
3036
  const cloneArgs = (y) => y.positional("target", {
3104
3037
  type: "string",
3105
3038
  describe: "org/repo to clone, or a bare org to clone every repo in it (confirms first)."
@@ -3107,8 +3040,7 @@ const cloneArgs = (y) => y.positional("target", {
3107
3040
  type: "string",
3108
3041
  describe: "Parent directory to clone into (default: ~/Code/<org>)"
3109
3042
  });
3110
- //#endregion
3111
- //#region src/commands/clone/clone.ts
3043
+ // src/commands/clone/clone.ts
3112
3044
  /**
3113
3045
  * Accepts a bare org (`"theholocron"`) — clones every repo in it — or an
3114
3046
  * `org/repo` coordinate (`"theholocron/new-repo"`) — clones just that one
@@ -3304,8 +3236,7 @@ async function runClone(input) {
3304
3236
  failed
3305
3237
  };
3306
3238
  }
3307
- //#endregion
3308
- //#region src/commands/clone/clone.command.ts
3239
+ // src/commands/clone/clone.command.ts
3309
3240
  const resolveCloneToken = createFeatureResolver({
3310
3241
  envName: "HOLOCRON_READ_TOKEN",
3311
3242
  keyringKey: "github.read"
@@ -3356,8 +3287,7 @@ const cloneCommand = {
3356
3287
  } else if (report.status === "dry-run" && report.cloned === 0 && env.get("HOLOCRON_DRY_RUN_PREVIEW") === "1") process.exitCode = 2;
3357
3288
  }
3358
3289
  };
3359
- //#endregion
3360
- //#region src/commands/config-show/config-show.args.ts
3290
+ // src/commands/config-show/config-show.args.ts
3361
3291
  const configShowArgs = (y) => y.option("depth", {
3362
3292
  type: "number",
3363
3293
  describe: "Collapse objects/arrays nested deeper than N levels (TTY output only)"
@@ -3365,8 +3295,7 @@ const configShowArgs = (y) => y.option("depth", {
3365
3295
  type: "boolean",
3366
3296
  describe: "Browse the config in a foldable tree (default on a TTY; --no-interactive for static output)"
3367
3297
  });
3368
- //#endregion
3369
- //#region src/commands/config-show/config-show.command.ts
3298
+ // src/commands/config-show/config-show.command.ts
3370
3299
  const configShowCommand = {
3371
3300
  command: "config show",
3372
3301
  describe: "Print the resolved holocron config",
@@ -3378,8 +3307,7 @@ const configShowCommand = {
3378
3307
  });
3379
3308
  }
3380
3309
  };
3381
- //#endregion
3382
- //#region src/commands/cleanup-preview/cleanup-preview.args.ts
3310
+ // src/commands/cleanup-preview/cleanup-preview.args.ts
3383
3311
  const cleanupPreviewArgs = (y) => y.positional("pr", {
3384
3312
  type: "number",
3385
3313
  describe: "PR number to clean up"
@@ -3391,8 +3319,7 @@ const cleanupPreviewArgs = (y) => y.positional("pr", {
3391
3319
  type: "string",
3392
3320
  describe: "GitHub repo as owner/name — defaults to the repo in holocron.config"
3393
3321
  });
3394
- //#endregion
3395
- //#region src/commands/cleanup-preview/cleanup-preview.ts
3322
+ // src/commands/cleanup-preview/cleanup-preview.ts
3396
3323
  function prStateLabel(pr) {
3397
3324
  if (pr.merged) return style.success("merged");
3398
3325
  if (pr.state === "closed") return style.dim("closed (not merged)");
@@ -3531,8 +3458,7 @@ async function runCleanupPreview(input) {
3531
3458
  };
3532
3459
  }
3533
3460
  }
3534
- //#endregion
3535
- //#region src/commands/cleanup-preview/cleanup-preview.command.ts
3461
+ // src/commands/cleanup-preview/cleanup-preview.command.ts
3536
3462
  const cleanupPreviewCommand = {
3537
3463
  command: "cleanup-preview [pr]",
3538
3464
  describe: "List and delete Cloudflare Pages preview deployments for a GitHub PR",
@@ -3557,8 +3483,7 @@ const cleanupPreviewCommand = {
3557
3483
  })).status === "fail") process.exitCode = 1;
3558
3484
  }
3559
3485
  };
3560
- //#endregion
3561
- //#region src/commands/deploy/deploy.args.ts
3486
+ // src/commands/deploy/deploy.args.ts
3562
3487
  const deployArgs = (y) => y.positional("branch", {
3563
3488
  type: "string",
3564
3489
  describe: "Git branch to deploy (omit when using --files)"
@@ -3573,8 +3498,7 @@ const deployArgs = (y) => y.positional("branch", {
3573
3498
  type: "string",
3574
3499
  describe: "Deploy from a local directory of source files instead of a Git branch — calls deployFunction(), no linked repo required. Conflicts with `branch`."
3575
3500
  }).conflicts("files", "branch");
3576
- //#endregion
3577
- //#region src/commands/deploy/deploy-on-release.args.ts
3501
+ // src/commands/deploy/deploy-on-release.args.ts
3578
3502
  const deployOnReleaseArgs = (y) => y.option("channel", {
3579
3503
  type: "string",
3580
3504
  default: "",
@@ -3586,8 +3510,7 @@ const deployOnReleaseArgs = (y) => y.option("channel", {
3586
3510
  type: "string",
3587
3511
  describe: "The release commit. Default HEAD."
3588
3512
  });
3589
- //#endregion
3590
- //#region src/commands/deploy/deploy-on-release.command.ts
3513
+ // src/commands/deploy/deploy-on-release.command.ts
3591
3514
  const deployOnReleaseCommand = {
3592
3515
  command: "on-release",
3593
3516
  describe: "Deploy every workspace package whose delivery.deploy task is `on: release` — run by the delivery.publish workflow's deploy job",
@@ -3603,8 +3526,7 @@ const deployOnReleaseCommand = {
3603
3526
  })).status === "fail") process.exitCode = 1;
3604
3527
  }
3605
3528
  };
3606
- //#endregion
3607
- //#region src/commands/deploy/deploy.ts
3529
+ // src/commands/deploy/deploy.ts
3608
3530
  /**
3609
3531
  * `holocron deploy` — trigger a deployment via the configured
3610
3532
  * `deployment` capability.
@@ -3843,8 +3765,7 @@ async function runDeployFromFiles(input) {
3843
3765
  };
3844
3766
  }
3845
3767
  }
3846
- //#endregion
3847
- //#region src/commands/deploy/deploy.command.ts
3768
+ // src/commands/deploy/deploy.command.ts
3848
3769
  const deployCommand = {
3849
3770
  command: "deploy [branch]",
3850
3771
  describe: "Trigger a deployment via the configured `deployment` capability",
@@ -3885,8 +3806,7 @@ const deployCommand = {
3885
3806
  })).status === "fail") process.exitCode = 1;
3886
3807
  }
3887
3808
  };
3888
- //#endregion
3889
- //#region src/commands/doctor-notifications/doctor-notifications.args.ts
3809
+ // src/commands/doctor-notifications/doctor-notifications.args.ts
3890
3810
  const doctorNotificationsArgs = (y) => y.option("scope", {
3891
3811
  type: "string",
3892
3812
  describe: "Where the layout's secrets live: \"repo\", \"env=<name>\" or \"org=<name>\" (default: the org)"
@@ -3902,8 +3822,7 @@ const doctorNotificationsArgs = (y) => y.option("scope", {
3902
3822
  default: false,
3903
3823
  describe: "Post a test message through every channel's webhook, read it back and remove it (works with --built-only)"
3904
3824
  });
3905
- //#endregion
3906
- //#region src/ui/provider-error/provider-error.ts
3825
+ // src/ui/provider-error/provider-error.ts
3907
3826
  /** Vendor response bodies land in the terminal — cap their length so one
3908
3827
  * oversized error can't flood the report, and strip control characters
3909
3828
  * (newlines and the C1 range, whose 0x9b is an 8-bit CSI) so a crafted body
@@ -3944,8 +3863,7 @@ function logReason(err) {
3944
3863
  const root = err instanceof Error && err.cause !== void 0 ? err.cause : err;
3945
3864
  return errorMessage(root);
3946
3865
  }
3947
- //#endregion
3948
- //#region src/commands/notifications-channel-add/avatar.ts
3866
+ // src/commands/notifications-channel-add/avatar.ts
3949
3867
  /**
3950
3868
  * Read a webhook avatar named in a layout: a file path (from the directory the CLI runs in) or an
3951
3869
  * `https://` URL. Returns it as a `data:` URI, which is how providers take an image.
@@ -4030,8 +3948,7 @@ async function loadAvatar(source, baseDir = process.cwd(), fetchImpl = fetch) {
4030
3948
  if (!type) throw new Error("it is not a PNG, JPEG or GIF image, which are the formats providers accept");
4031
3949
  return `data:${type};base64,${bytes.toString("base64")}`;
4032
3950
  }
4033
- //#endregion
4034
- //#region src/commands/notifications-channel-add/notifications-channel-add.ts
3951
+ // src/commands/notifications-channel-add/notifications-channel-add.ts
4035
3952
  /**
4036
3953
  * `holocron notifications channel add` — create one channel (and, with
4037
3954
  * `--with-webhook`, an inbound webhook whose URL goes straight into a secret).
@@ -4420,8 +4337,7 @@ async function resolveCallback(input) {
4420
4337
  function redirectInstruction(redirectUri) {
4421
4338
  return `add ${redirectUri} under OAuth2 → Redirects in the Discord developer portal (the API does not allow setting it)`;
4422
4339
  }
4423
- //#endregion
4424
- //#region src/commands/notifications-link/listener.ts
4340
+ // src/commands/notifications-link/listener.ts
4425
4341
  const PAGE = (title, body) => `<!doctype html><meta charset="utf-8"><title>${title}</title><body style="font:16px system-ui;margin:3rem auto;max-width:32rem"><h1>${title}</h1><p>${body}</p>`;
4426
4342
  /**
4427
4343
  * Listens once on this machine for the browser coming back from the provider, and resolves with the `code` it
@@ -4474,8 +4390,7 @@ function waitForCode(input) {
4474
4390
  });
4475
4391
  });
4476
4392
  }
4477
- //#endregion
4478
- //#region src/commands/notifications-sync-roles/links.ts
4393
+ // src/commands/notifications-sync-roles/links.ts
4479
4394
  const EMPTY_LINKS = {
4480
4395
  version: 1,
4481
4396
  links: []
@@ -4547,8 +4462,7 @@ function linksLocation(layout, org, provider) {
4547
4462
  path: layout.links?.path ?? `notifications/${provider.toLowerCase()}-links.json`
4548
4463
  };
4549
4464
  }
4550
- //#endregion
4551
- //#region src/commands/notifications-sync-roles/plan.ts
4465
+ // src/commands/notifications-sync-roles/plan.ts
4552
4466
  /**
4553
4467
  * What it takes to make a role's holders equal a team, given who is linked to whom. Pure: it decides, the
4554
4468
  * caller acts. A holder is removed only when a link says they are a person who left the team; a holder
@@ -4603,8 +4517,7 @@ function roleTeamProblem(layout) {
4603
4517
  seen.set(key, role.team);
4604
4518
  }
4605
4519
  }
4606
- //#endregion
4607
- //#region src/commands/notifications-sync-roles/notifications-sync-roles.ts
4520
+ // src/commands/notifications-sync-roles/notifications-sync-roles.ts
4608
4521
  /**
4609
4522
  * `holocron notifications sync-roles` — make who holds a server role match a team.
4610
4523
  *
@@ -4775,8 +4688,7 @@ async function runNotificationsSyncRoles(input) {
4775
4688
  }, "notifications sync-roles");
4776
4689
  return report;
4777
4690
  }
4778
- //#endregion
4779
- //#region src/commands/notifications-link/notifications-link.ts
4691
+ // src/commands/notifications-link/notifications-link.ts
4780
4692
  /**
4781
4693
  * `holocron notifications link` — record which server member is which GitHub account, by having the member
4782
4694
  * sign in with the provider. The provider reports the GitHub account it has verified they own, so a link
@@ -4948,8 +4860,7 @@ async function runNotificationsLink(input) {
4948
4860
  return refuse(describeProviderError(err), logReason(err));
4949
4861
  }
4950
4862
  }
4951
- //#endregion
4952
- //#region src/commands/doctor-notifications/doctor-notifications.ts
4863
+ // src/commands/doctor-notifications/doctor-notifications.ts
4953
4864
  /**
4954
4865
  * `holocron doctor notifications` -- compare the layout a provider
4955
4866
  * declares in `holocron.config.ts` with what is actually on the server and in the
@@ -5482,8 +5393,7 @@ async function runDoctorNotifications(input) {
5482
5393
  print(style.header(`${summary.pass} ok, ${summary.fail} fail, ${summary.skip} skipped`));
5483
5394
  return finish();
5484
5395
  }
5485
- //#endregion
5486
- //#region src/commands/doctor-notifications/doctor-notifications.command.ts
5396
+ // src/commands/doctor-notifications/doctor-notifications.command.ts
5487
5397
  const doctorNotificationsCommand = {
5488
5398
  command: "notifications",
5489
5399
  describe: "Check the layout against the server and the secrets store, step by step (a full run leaves one test post in the test channel; --built-only posts nothing unless --deliver)",
@@ -5507,14 +5417,12 @@ const doctorNotificationsCommand = {
5507
5417
  })).status === "fail") process.exitCode = 1;
5508
5418
  }
5509
5419
  };
5510
- //#endregion
5511
- //#region src/commands/doctor/doctor.args.ts
5420
+ // src/commands/doctor/doctor.args.ts
5512
5421
  const doctorArgs = (y) => y.option("repo", {
5513
5422
  type: "string",
5514
5423
  describe: "Repo coords (\"owner/name\"). Defaults to plugin-specific resolution."
5515
5424
  }).command(doctorNotificationsCommand);
5516
- //#endregion
5517
- //#region src/commands/doctor/doctor.ts
5425
+ // src/commands/doctor/doctor.ts
5518
5426
  /**
5519
5427
  * `holocron doctor` — load the config, instantiate every capability,
5520
5428
  * print a per-capability readiness report.
@@ -5709,8 +5617,7 @@ function mk(capability, provider, status, message, logMessage) {
5709
5617
  ...logMessage !== void 0 ? { logMessage } : {}
5710
5618
  };
5711
5619
  }
5712
- //#endregion
5713
- //#region src/commands/doctor/doctor.command.ts
5620
+ // src/commands/doctor/doctor.command.ts
5714
5621
  const doctorCommand = {
5715
5622
  command: "doctor",
5716
5623
  describe: "Load the config and run a smoke check against every provider",
@@ -5732,8 +5639,7 @@ const doctorCommand = {
5732
5639
  })).summary.fail > 0) process.exitCode = 1;
5733
5640
  }
5734
5641
  };
5735
- //#endregion
5736
- //#region src/commands/menu/menu.command.ts
5642
+ // src/commands/menu/menu.command.ts
5737
5643
  /**
5738
5644
  * Print the dim version line once per terminal session — keyed by the
5739
5645
  * parent shell's PID, since that's stable across repeated bare `holocron`
@@ -5758,8 +5664,7 @@ const menuCommand = (version) => ({
5758
5664
  await launchMenu([...COMMAND_REGISTRY, ...runEntries], argv);
5759
5665
  }
5760
5666
  });
5761
- //#endregion
5762
- //#region src/commands/monitoring-check/monitoring-check.ts
5667
+ // src/commands/monitoring-check/monitoring-check.ts
5763
5668
  /**
5764
5669
  * `holocron monitoring check <url>` — runs every configured `monitoring`
5765
5670
  * check against an arbitrary URL instead of each check's own configured
@@ -5883,8 +5788,7 @@ async function runMonitoringCheck(input) {
5883
5788
  ...input.runCheck ? { runCheck: input.runCheck } : {}
5884
5789
  });
5885
5790
  }
5886
- //#endregion
5887
- //#region src/commands/monitoring-run-resolved/monitoring-run-resolved.ts
5791
+ // src/commands/monitoring-run-resolved/monitoring-run-resolved.ts
5888
5792
  /**
5889
5793
  * `holocron monitoring run-resolved <url>` — runs an already-resolved
5890
5794
  * check list (no `holocron.config.ts` loading at all) against `url`
@@ -5943,8 +5847,7 @@ async function runMonitoringRunResolved(input) {
5943
5847
  ...input.runCheck ? { runCheck: input.runCheck } : {}
5944
5848
  });
5945
5849
  }
5946
- //#endregion
5947
- //#region src/commands/monitoring-check/monitoring-check.args.ts
5850
+ // src/commands/monitoring-check/monitoring-check.args.ts
5948
5851
  const monitoringCheckArgs = (y) => y.positional("url", {
5949
5852
  type: "string",
5950
5853
  describe: "URL to test every configured check against (e.g. a PR's preview deployment)"
@@ -5952,8 +5855,7 @@ const monitoringCheckArgs = (y) => y.positional("url", {
5952
5855
  type: "string",
5953
5856
  describe: "Expected Vercel project id/name `url` must resolve to before the Deployment Protection bypass header (VERCEL_PROTECTION_BYPASS_SECRET) is attached. Omitted → the header is never attached, regardless of that env var."
5954
5857
  });
5955
- //#endregion
5956
- //#region src/commands/monitoring-check/monitoring-check.command.ts
5858
+ // src/commands/monitoring-check/monitoring-check.command.ts
5957
5859
  const monitoringCheckCommand = {
5958
5860
  command: "check <url>",
5959
5861
  describe: "Run every configured `monitoring` check against a given URL instead of its own configured url",
@@ -5984,8 +5886,7 @@ const monitoringCheckCommand = {
5984
5886
  })).status === "fail") process.exitCode = 1;
5985
5887
  }
5986
5888
  };
5987
- //#endregion
5988
- //#region src/commands/monitoring-resolve-checks/monitoring-resolve-checks.ts
5889
+ // src/commands/monitoring-resolve-checks/monitoring-resolve-checks.ts
5989
5890
  /**
5990
5891
  * `holocron monitoring resolve-checks` — loads config/plugins and writes
5991
5892
  * the configured `monitoring` checks to a file as JSON (holocron#1030/
@@ -6008,15 +5909,13 @@ async function runMonitoringResolveChecks(input) {
6008
5909
  await writeFile(input.outFile, JSON.stringify(checks), "utf8");
6009
5910
  print(`Resolved ${checks.length} monitoring check(s) → ${input.outFile}`);
6010
5911
  }
6011
- //#endregion
6012
- //#region src/commands/monitoring-resolve-checks/monitoring-resolve-checks.args.ts
5912
+ // src/commands/monitoring-resolve-checks/monitoring-resolve-checks.args.ts
6013
5913
  const monitoringResolveChecksArgs = (y) => y.option("out", {
6014
5914
  type: "string",
6015
5915
  demandOption: true,
6016
5916
  describe: "File path to write the resolved checks to"
6017
5917
  });
6018
- //#endregion
6019
- //#region src/commands/monitoring-resolve-checks/monitoring-resolve-checks.command.ts
5918
+ // src/commands/monitoring-resolve-checks/monitoring-resolve-checks.command.ts
6020
5919
  const monitoringResolveChecksCommand = {
6021
5920
  command: "resolve-checks",
6022
5921
  describe: "Load config/plugins and write the configured `monitoring` checks to a file as JSON — the untrusted half of the delivery.previewCheck split (holocron#1030/#1032)",
@@ -6038,8 +5937,7 @@ const monitoringResolveChecksCommand = {
6038
5937
  });
6039
5938
  }
6040
5939
  };
6041
- //#endregion
6042
- //#region src/commands/monitoring-run-resolved/monitoring-run-resolved.args.ts
5940
+ // src/commands/monitoring-run-resolved/monitoring-run-resolved.args.ts
6043
5941
  const monitoringRunResolvedArgs = (y) => y.positional("url", {
6044
5942
  type: "string",
6045
5943
  describe: "URL to run every resolved check against"
@@ -6051,8 +5949,7 @@ const monitoringRunResolvedArgs = (y) => y.positional("url", {
6051
5949
  type: "string",
6052
5950
  describe: "Expected Vercel project id/name `url` must resolve to before the Deployment Protection bypass header (VERCEL_PROTECTION_BYPASS_SECRET) is attached. Omitted → the header is never attached."
6053
5951
  });
6054
- //#endregion
6055
- //#region src/commands/monitoring-run-resolved/monitoring-run-resolved.command.ts
5952
+ // src/commands/monitoring-run-resolved/monitoring-run-resolved.command.ts
6056
5953
  const monitoringRunResolvedCommand = {
6057
5954
  command: "run-resolved <url>",
6058
5955
  describe: "Run an already-resolved check list (from `monitoring resolve-checks`) against a URL — no config/plugin loading at all, the trusted half of the delivery.previewCheck split (holocron#1030/#1032)",
@@ -6068,16 +5965,14 @@ const monitoringRunResolvedCommand = {
6068
5965
  })).status === "fail") process.exitCode = 1;
6069
5966
  }
6070
5967
  };
6071
- //#endregion
6072
- //#region src/commands/monitoring/monitoring.command.ts
5968
+ // src/commands/monitoring/monitoring.command.ts
6073
5969
  const monitoringCommand = {
6074
5970
  command: "monitoring",
6075
5971
  describe: "Run monitoring checks ad hoc, outside the configured provider",
6076
5972
  builder: (y) => y.command(monitoringCheckCommand).command(monitoringResolveChecksCommand).command(monitoringRunResolvedCommand).command(groupMenu("monitoring")),
6077
5973
  handler: () => {}
6078
5974
  };
6079
- //#endregion
6080
- //#region src/commands/plugin-create/template-inputs/template-inputs.ts
5975
+ // src/commands/plugin-create/template-inputs/template-inputs.ts
6081
5976
  /** Derive the standard defaults from a slug + vendor name. */
6082
5977
  function deriveDefaults(input) {
6083
5978
  const vendorUpper = input.slug.toUpperCase().replace(/-/g, "_");
@@ -6089,8 +5984,7 @@ function deriveDefaults(input) {
6089
5984
  transport: "rest"
6090
5985
  };
6091
5986
  }
6092
- //#endregion
6093
- //#region src/commands/plugin-create/templates/auth.ts
5987
+ // src/commands/plugin-create/templates/auth.ts
6094
5988
  function render$17(inputs) {
6095
5989
  return `import { AuthError, createResolveToken, type ResolveTokenInput } from "@theholocron/cli";
6096
5990
 
@@ -6107,8 +6001,7 @@ export const resolveToken = createResolveToken({
6107
6001
  });
6108
6002
  `;
6109
6003
  }
6110
- //#endregion
6111
- //#region src/commands/plugin-create/templates/auth-test.ts
6004
+ // src/commands/plugin-create/templates/auth-test.ts
6112
6005
  function render$16(inputs) {
6113
6006
  return `import { describe, expect, it } from "vitest";
6114
6007
 
@@ -6159,8 +6052,7 @@ describe("resolveToken", () => {
6159
6052
  });
6160
6053
  `;
6161
6054
  }
6162
- //#endregion
6163
- //#region src/commands/plugin-create/templates/capability.ts
6055
+ // src/commands/plugin-create/templates/capability.ts
6164
6056
  function render$15(inputs) {
6165
6057
  const clientClass = `${inputs.vendorName}RestClient`;
6166
6058
  const capabilityInterface = inputs.capability.charAt(0).toUpperCase() + inputs.capability.slice(1);
@@ -6195,8 +6087,7 @@ export class ${inputs.capabilityClass} {
6195
6087
  }
6196
6088
  `;
6197
6089
  }
6198
- //#endregion
6199
- //#region src/commands/plugin-create/templates/capability-test.ts
6090
+ // src/commands/plugin-create/templates/capability-test.ts
6200
6091
  function render$14(inputs) {
6201
6092
  const factoryName = `create${inputs.vendorName}RestClient`;
6202
6093
  return `import { describe, expect, it } from "vitest";
@@ -6228,8 +6119,7 @@ describe("${inputs.capabilityClass}", () => {
6228
6119
  });
6229
6120
  `;
6230
6121
  }
6231
- //#endregion
6232
- //#region src/commands/plugin-create/templates/eslint-config.ts
6122
+ // src/commands/plugin-create/templates/eslint-config.ts
6233
6123
  function render$13(_inputs) {
6234
6124
  return `import type { Linter } from "eslint";
6235
6125
 
@@ -6238,8 +6128,7 @@ import root from "../../eslint.config.js";
6238
6128
  export default [...root, { ignores: ["dist/**", "coverage/**"] }] satisfies Linter.Config[];
6239
6129
  `;
6240
6130
  }
6241
- //#endregion
6242
- //#region src/commands/plugin-create/templates/helpers.ts
6131
+ // src/commands/plugin-create/templates/helpers.ts
6243
6132
  function render$12(_inputs) {
6244
6133
  return `import { vi, type Mock } from "vitest";
6245
6134
 
@@ -6288,8 +6177,7 @@ function safeJsonParse(s: string): unknown {
6288
6177
  }
6289
6178
  `;
6290
6179
  }
6291
- //#endregion
6292
- //#region src/commands/plugin-create/templates/index-test.ts
6180
+ // src/commands/plugin-create/templates/index-test.ts
6293
6181
  function render$11(inputs) {
6294
6182
  return `import { describe, expect, it } from "vitest";
6295
6183
 
@@ -6315,8 +6203,7 @@ describe("AUTH_HINT", () => {
6315
6203
  });
6316
6204
  `;
6317
6205
  }
6318
- //#endregion
6319
- //#region src/commands/plugin-create/templates/package-json.ts
6206
+ // src/commands/plugin-create/templates/package-json.ts
6320
6207
  function render$10(inputs) {
6321
6208
  const keywords = [
6322
6209
  inputs.capability,
@@ -6375,8 +6262,7 @@ function render$10(inputs) {
6375
6262
  files: ["dist"]
6376
6263
  }, null, 2) + "\n";
6377
6264
  }
6378
- //#endregion
6379
- //#region src/commands/plugin-create/templates/plugin-index.ts
6265
+ // src/commands/plugin-create/templates/plugin-index.ts
6380
6266
  function render$9(inputs) {
6381
6267
  const clientClass = `${inputs.vendorName}RestClient`;
6382
6268
  const factoryName = `create${inputs.vendorName}RestClient`;
@@ -6462,8 +6348,7 @@ export { verifyToken } from "./verify-token.js";
6462
6348
  export type { VerifyTokenFailure, VerifyTokenResult, VerifyTokenSuccess } from "@theholocron/cli";
6463
6349
  `;
6464
6350
  }
6465
- //#endregion
6466
- //#region src/commands/plugin-create/templates/readme.ts
6351
+ // src/commands/plugin-create/templates/readme.ts
6467
6352
  function render$8(inputs) {
6468
6353
  return `<!-- editorconfig-checker-disable-file -->
6469
6354
 
@@ -6530,8 +6415,7 @@ TODO: fill in as capability methods land.
6530
6415
  Not yet published; capability methods are stubs.
6531
6416
  `;
6532
6417
  }
6533
- //#endregion
6534
- //#region src/commands/plugin-create/templates/rest.ts
6418
+ // src/commands/plugin-create/templates/rest.ts
6535
6419
  function render$7(inputs) {
6536
6420
  const factoryName = `create${inputs.vendorName}RestClient`;
6537
6421
  const clientType = `${inputs.vendorName}RestClient`;
@@ -6562,8 +6446,7 @@ export function ${factoryName}(opts: {
6562
6446
  }
6563
6447
  `;
6564
6448
  }
6565
- //#endregion
6566
- //#region src/commands/plugin-create/templates/rest-test.ts
6449
+ // src/commands/plugin-create/templates/rest-test.ts
6567
6450
  function render$6(inputs) {
6568
6451
  const factoryName = `create${inputs.vendorName}RestClient`;
6569
6452
  return `import { ProviderApiError } from "@theholocron/cli";
@@ -6620,8 +6503,7 @@ describe("${factoryName}", () => {
6620
6503
  });
6621
6504
  `;
6622
6505
  }
6623
- //#endregion
6624
- //#region src/commands/plugin-create/templates/tsconfig-json.ts
6506
+ // src/commands/plugin-create/templates/tsconfig-json.ts
6625
6507
  function render$5(inputs) {
6626
6508
  return JSON.stringify({
6627
6509
  display: `Holocron Plugin: ${inputs.vendorName}`,
@@ -6635,8 +6517,7 @@ function render$5(inputs) {
6635
6517
  exclude: ["node_modules", "dist"]
6636
6518
  }, null, 2) + "\n";
6637
6519
  }
6638
- //#endregion
6639
- //#region src/commands/plugin-create/templates/tsdown-config.ts
6520
+ // src/commands/plugin-create/templates/tsdown-config.ts
6640
6521
  function render$4(_inputs) {
6641
6522
  return `import { defineConfig } from "tsdown";
6642
6523
 
@@ -6649,8 +6530,7 @@ export default defineConfig({
6649
6530
  });
6650
6531
  `;
6651
6532
  }
6652
- //#endregion
6653
- //#region src/commands/plugin-create/templates/validate-script.ts
6533
+ // src/commands/plugin-create/templates/validate-script.ts
6654
6534
  /**
6655
6535
  * Scaffolds `scripts/validate.mjs` — a smoke-test the operator runs
6656
6536
  * against a live vendor account to verify the plugin's REST endpoints,
@@ -6787,8 +6667,7 @@ function hintFor(message) {
6787
6667
  }
6788
6668
  `;
6789
6669
  }
6790
- //#endregion
6791
- //#region src/commands/plugin-create/templates/verify-token.ts
6670
+ // src/commands/plugin-create/templates/verify-token.ts
6792
6671
  function render$2(inputs) {
6793
6672
  const factoryName = `create${inputs.vendorName}RestClient`;
6794
6673
  return `/**
@@ -6840,8 +6719,7 @@ export async function verifyToken(token: string, opts: VerifyTokenOptions = {}):
6840
6719
  }
6841
6720
  `;
6842
6721
  }
6843
- //#endregion
6844
- //#region src/commands/plugin-create/templates/verify-token-test.ts
6722
+ // src/commands/plugin-create/templates/verify-token-test.ts
6845
6723
  function render$1(_inputs) {
6846
6724
  return `import { describe, expect, it } from "vitest";
6847
6725
 
@@ -6874,8 +6752,7 @@ describe("verifyToken", () => {
6874
6752
  });
6875
6753
  `;
6876
6754
  }
6877
- //#endregion
6878
- //#region src/commands/plugin-create/templates/vitest-config.ts
6755
+ // src/commands/plugin-create/templates/vitest-config.ts
6879
6756
  function render(_inputs) {
6880
6757
  return `import { defineConfig } from "vitest/config";
6881
6758
 
@@ -6894,8 +6771,7 @@ export default defineConfig({
6894
6771
  });
6895
6772
  `;
6896
6773
  }
6897
- //#endregion
6898
- //#region src/commands/plugin-create/index.ts
6774
+ // src/commands/plugin-create/index.ts
6899
6775
  /**
6900
6776
  * `holocron new plugin <slug> <vendor>` — scaffold a new plugin
6901
6777
  * package matching the proven template.
@@ -7174,8 +7050,7 @@ function printNextSteps$1(print, inputs) {
7174
7050
  print(` 6. Replace it.todo(...) with real tests in src/__tests__/${inputs.capability}.test.ts`);
7175
7051
  print(" 7. Commit + push when capability is functionally complete.");
7176
7052
  }
7177
- //#endregion
7178
- //#region src/commands/plugin-create/plugin-create.args.ts
7053
+ // src/commands/plugin-create/plugin-create.args.ts
7179
7054
  const pluginCreateArgs = (y) => y.positional("slug", {
7180
7055
  type: "string",
7181
7056
  describe: "Package slug (kebab-case)"
@@ -7199,8 +7074,7 @@ const pluginCreateArgs = (y) => y.positional("slug", {
7199
7074
  default: true,
7200
7075
  describe: "Run post-scaffold pnpm install + typecheck + lint + test (default true; --no-verify skips)"
7201
7076
  });
7202
- //#endregion
7203
- //#region src/commands/plugin-create/plugin-create.command.ts
7077
+ // src/commands/plugin-create/plugin-create.command.ts
7204
7078
  const pluginCreateCommand = {
7205
7079
  command: "plugin [slug] [vendor]",
7206
7080
  describe: "Scaffold a new @theholocron/holocron-plugin-<slug> package",
@@ -7244,8 +7118,7 @@ const pluginCreateCommand = {
7244
7118
  }
7245
7119
  }
7246
7120
  };
7247
- //#endregion
7248
- //#region src/commands/new/new.ts
7121
+ // src/commands/new/new.ts
7249
7122
  /**
7250
7123
  * `holocron new repo <type> <name>` — create a GitHub repo from a template and
7251
7124
  * bootstrap it by replacing all template-slug casing variants with the new
@@ -7307,15 +7180,17 @@ function parseTopics(raw) {
7307
7180
  }
7308
7181
  /**
7309
7182
  * Generate the content of `holocron.config.ts` for a newly-scaffolded repo.
7310
- * Uses the `node()` preset from `@theholocron/holocron-config` as the baseline
7183
+ * Composes the `withNode()` and `withTypecheck()` capabilities from `@theholocron/cli/presets` as the baseline
7311
7184
  * and layers in the provider/agent choices made during the wizard.
7312
7185
  */
7313
7186
  function generateHolocronConfig(opts) {
7314
7187
  const lines = [
7315
7188
  `import { defineConfig } from "@theholocron/cli";`,
7316
- `import { compose, node, typecheck } from "@theholocron/holocron-config";`,
7189
+ `import { compose, withCapabilities } from "@theholocron/cli/presets";`,
7317
7190
  ``,
7318
- `const preset = compose(node(), typecheck());`,
7191
+ `const { withNode, withTypecheck } = withCapabilities;`,
7192
+ ``,
7193
+ `const preset = compose(withNode(), withTypecheck());`,
7319
7194
  `export default defineConfig({`,
7320
7195
  `\t...preset,`
7321
7196
  ];
@@ -7638,8 +7513,7 @@ async function runNew(input) {
7638
7513
  filesPatched
7639
7514
  };
7640
7515
  }
7641
- //#endregion
7642
- //#region src/commands/new/new-repo.args.ts
7516
+ // src/commands/new/new-repo.args.ts
7643
7517
  const newRepoArgs = (y) => y.positional("type", {
7644
7518
  type: "string",
7645
7519
  describe: "Template type — maps to theholocron/<type>-template (e.g. cli, react, nextjs, node, monorepo, base)"
@@ -7691,8 +7565,7 @@ const newRepoArgs = (y) => y.positional("type", {
7691
7565
  default: true,
7692
7566
  describe: "Run pnpm install + holocron repo setup after bootstrapping (--no-verify skips)"
7693
7567
  });
7694
- //#endregion
7695
- //#region src/commands/new/new-repo-wizard.ts
7568
+ // src/commands/new/new-repo-wizard.ts
7696
7569
  /** `holocron new repo`'s interactive wizard: asks for every field not already supplied as an argument. */
7697
7570
  async function askNewRepoAnswers(argv, prompts = {
7698
7571
  input,
@@ -7887,8 +7760,7 @@ async function askNewRepoAnswers(argv, prompts = {
7887
7760
  isTemplate
7888
7761
  };
7889
7762
  }
7890
- //#endregion
7891
- //#region src/commands/new/new-repo.command.ts
7763
+ // src/commands/new/new-repo.command.ts
7892
7764
  const newRepoCommand = {
7893
7765
  command: "repo [type] [name]",
7894
7766
  describe: "Scaffold a new repo from a GitHub template (e.g. cli, react, nextjs, node, monorepo, base)",
@@ -7944,16 +7816,14 @@ const newRepoCommand = {
7944
7816
  }
7945
7817
  }
7946
7818
  };
7947
- //#endregion
7948
- //#region src/commands/new/new.command.ts
7819
+ // src/commands/new/new.command.ts
7949
7820
  const newCommand = {
7950
7821
  command: "new",
7951
7822
  describe: "Scaffold a new repo or plugin",
7952
7823
  builder: (y) => y.command(newRepoCommand).command(pluginCreateCommand).command(groupMenu("new")),
7953
7824
  handler: () => {}
7954
7825
  };
7955
- //#endregion
7956
- //#region src/commands/notifications-create-server/find-guild-id.ts
7826
+ // src/commands/notifications-create-server/find-guild-id.ts
7957
7827
  /**
7958
7828
  * Every `guildId: "<digits>"` property in the source, found by reading it as code: comments are skipped and a
7959
7829
  * string is one piece, so a `guildId` inside a comment or inside another string is not a property. The key may be
@@ -8017,8 +7887,7 @@ function findGuildId(source) {
8017
7887
  }
8018
7888
  return found;
8019
7889
  }
8020
- //#endregion
8021
- //#region src/commands/notifications-create-server/lock-config.ts
7890
+ // src/commands/notifications-create-server/lock-config.ts
8022
7891
  /**
8023
7892
  * Takes a lock next to the config so two runs cannot create and hand over different servers and then overwrite
8024
7893
  * each other's `guildId`. Returns a function that releases it, or undefined when another run holds it. The lock
@@ -8039,8 +7908,7 @@ async function lockConfig(filepath) {
8039
7908
  release: () => unlink(path).catch(() => void 0)
8040
7909
  };
8041
7910
  }
8042
- //#endregion
8043
- //#region src/commands/notifications-setup/avatar-problem.ts
7911
+ // src/commands/notifications-setup/avatar-problem.ts
8044
7912
  /** The first reason a feed's `avatar` cannot work, or undefined. `feed` names the key for the message (`monitoring`, `errors`). */
8045
7913
  function avatarProblem(channel, feed, picture) {
8046
7914
  if (typeof picture !== "object") return void 0;
@@ -8126,8 +7994,7 @@ async function deployRelay(input) {
8126
7994
  script
8127
7995
  };
8128
7996
  }
8129
- //#endregion
8130
- //#region src/commands/notifications-setup/with-elevation.ts
7997
+ // src/commands/notifications-setup/with-elevation.ts
8131
7998
  /**
8132
7999
  * Runs an edit that may need a permission the bot should not keep. When the provider says it does
8133
8000
  * ({@link ElevationRequiredError}) and a person is there to answer, walks them through it: the link that gives the
@@ -8181,8 +8048,7 @@ async function withElevation(run, deps) {
8181
8048
  };
8182
8049
  }
8183
8050
  }
8184
- //#endregion
8185
- //#region src/commands/notifications-setup/notifications-setup.ts
8051
+ // src/commands/notifications-setup/notifications-setup.ts
8186
8052
  /**
8187
8053
  * `holocron notifications setup` — apply the server layout a `notifications`
8188
8054
  * provider declares in `holocron.config.ts` (categories, channels, roles, and
@@ -8697,8 +8563,7 @@ async function runNotificationsSetup(input$1) {
8697
8563
  }, "notifications setup");
8698
8564
  return report;
8699
8565
  }
8700
- //#endregion
8701
- //#region src/commands/notifications-create-server/pick-server-creator.ts
8566
+ // src/commands/notifications-create-server/pick-server-creator.ts
8702
8567
  /** The provider that can create a server and hand it over. */
8703
8568
  function pickServerCreator(providers, wanted) {
8704
8569
  return pickProvider(providers, wanted, (p) => typeof p.createServer === "function" && typeof p.inviteLink === "function" && typeof p.hasMember === "function" && typeof p.transferServer === "function", {
@@ -8706,8 +8571,7 @@ function pickServerCreator(providers, wanted) {
8706
8571
  gerund: "creating a server"
8707
8572
  });
8708
8573
  }
8709
- //#endregion
8710
- //#region src/commands/notifications-create-server/write-guild-id.ts
8574
+ // src/commands/notifications-create-server/write-guild-id.ts
8711
8575
  /**
8712
8576
  * Puts a new server id where the config names the old one. It changes a file the person wrote, so it only does
8713
8577
  * so when there is exactly one `guildId: "<digits>"` property to replace (a comment or string that mentions one is not); otherwise it says why and leaves the file alone.
@@ -8743,8 +8607,7 @@ async function writeGuildId(filepath, id) {
8743
8607
  }
8744
8608
  return { written: true };
8745
8609
  }
8746
- //#endregion
8747
- //#region src/commands/notifications-create-server/notifications-create-server.ts
8610
+ // src/commands/notifications-create-server/notifications-create-server.ts
8748
8611
  /**
8749
8612
  * `holocron notifications create-server` — makes the server a layout describes, from nothing.
8750
8613
  *
@@ -8888,8 +8751,7 @@ async function runNotificationsCreateServer(input) {
8888
8751
  logger.info({ serverId: report.serverId }, "notifications create-server");
8889
8752
  return report;
8890
8753
  }
8891
- //#endregion
8892
- //#region src/commands/notifications-create-server/notifications-create-server.args.ts
8754
+ // src/commands/notifications-create-server/notifications-create-server.args.ts
8893
8755
  const notificationsCreateServerArgs = (y) => y.option("name", {
8894
8756
  type: "string",
8895
8757
  describe: "What the new server is called (not needed with --resume)"
@@ -8909,8 +8771,7 @@ const notificationsCreateServerArgs = (y) => y.option("name", {
8909
8771
  default: false,
8910
8772
  describe: "The server exists: skip creating and applying, and finish the hand-over"
8911
8773
  });
8912
- //#endregion
8913
- //#region src/commands/notifications-create-server/notifications-create-server.command.ts
8774
+ // src/commands/notifications-create-server/notifications-create-server.command.ts
8914
8775
  const notificationsCreateServerCommand = {
8915
8776
  command: "create-server",
8916
8777
  describe: "Create the server the layout describes, apply it, invite its owner and hand it over",
@@ -8936,14 +8797,12 @@ const notificationsCreateServerCommand = {
8936
8797
  })).status === "fail") process.exitCode = 1;
8937
8798
  }
8938
8799
  };
8939
- //#endregion
8940
- //#region src/commands/notifications-link/notifications-link.args.ts
8800
+ // src/commands/notifications-link/notifications-link.args.ts
8941
8801
  const notificationsLinkArgs = (y) => y.option("provider", {
8942
8802
  type: "string",
8943
8803
  describe: "Which notifications provider, when several can sign members in"
8944
8804
  });
8945
- //#endregion
8946
- //#region src/commands/notifications-link/notifications-link.command.ts
8805
+ // src/commands/notifications-link/notifications-link.command.ts
8947
8806
  const notificationsLinkCommand = {
8948
8807
  command: "link",
8949
8808
  describe: "Link your server account to your GitHub account by signing in with the provider",
@@ -8965,8 +8824,7 @@ const notificationsLinkCommand = {
8965
8824
  })).status === "fail") process.exitCode = 1;
8966
8825
  }
8967
8826
  };
8968
- //#endregion
8969
- //#region src/commands/notifications-setup/notifications-setup.args.ts
8827
+ // src/commands/notifications-setup/notifications-setup.args.ts
8970
8828
  const notificationsSetupArgs = (y) => y.option("scope", {
8971
8829
  type: "string",
8972
8830
  describe: "Webhook secret scope: \"repo\", \"env=<name>\" or \"org=<name>\" (default: the org)"
@@ -8974,8 +8832,7 @@ const notificationsSetupArgs = (y) => y.option("scope", {
8974
8832
  type: "string",
8975
8833
  describe: "Which notifications provider, when several can provision"
8976
8834
  });
8977
- //#endregion
8978
- //#region src/commands/notifications-setup/notifications-setup.command.ts
8835
+ // src/commands/notifications-setup/notifications-setup.command.ts
8979
8836
  const notificationsSetupCommand = {
8980
8837
  command: "setup",
8981
8838
  describe: "Apply the server layout a notifications provider declares in holocron.config.ts",
@@ -8998,8 +8855,7 @@ const notificationsSetupCommand = {
8998
8855
  })).status === "fail") process.exitCode = 1;
8999
8856
  }
9000
8857
  };
9001
- //#endregion
9002
- //#region src/commands/notifications-sync-roles/notifications-sync-roles.args.ts
8858
+ // src/commands/notifications-sync-roles/notifications-sync-roles.args.ts
9003
8859
  const notificationsSyncRolesArgs = (y) => y.option("provider", {
9004
8860
  type: "string",
9005
8861
  describe: "Which notifications provider, when several can manage roles"
@@ -9008,8 +8864,7 @@ const notificationsSyncRolesArgs = (y) => y.option("provider", {
9008
8864
  default: false,
9009
8865
  describe: "Give the role to new team members but do not take it from people who left"
9010
8866
  });
9011
- //#endregion
9012
- //#region src/commands/notifications-sync-roles/notifications-sync-roles.command.ts
8867
+ // src/commands/notifications-sync-roles/notifications-sync-roles.command.ts
9013
8868
  const notificationsSyncRolesCommand = {
9014
8869
  command: "sync-roles",
9015
8870
  describe: "Make who holds a server role match a team, through the links file",
@@ -9032,8 +8887,7 @@ const notificationsSyncRolesCommand = {
9032
8887
  })).status === "fail") process.exitCode = 1;
9033
8888
  }
9034
8889
  };
9035
- //#endregion
9036
- //#region src/commands/notifications-channel-add/notifications-channel-add.args.ts
8890
+ // src/commands/notifications-channel-add/notifications-channel-add.args.ts
9037
8891
  const notificationsChannelAddArgs = (y) => y.positional("name", {
9038
8892
  type: "string",
9039
8893
  describe: "Channel name (e.g. alerts)"
@@ -9060,8 +8914,7 @@ const notificationsChannelAddArgs = (y) => y.positional("name", {
9060
8914
  type: "string",
9061
8915
  describe: "Which notifications provider, when several can provision"
9062
8916
  });
9063
- //#endregion
9064
- //#region src/commands/notifications-channel-add/notifications-channel-add.command.ts
8917
+ // src/commands/notifications-channel-add/notifications-channel-add.command.ts
9065
8918
  const notificationsChannelAddCommand = {
9066
8919
  command: "add [name]",
9067
8920
  describe: "Create a channel, optionally with a webhook whose URL is stored as a secret",
@@ -9091,24 +8944,21 @@ const notificationsChannelAddCommand = {
9091
8944
  })).status === "fail") process.exitCode = 1;
9092
8945
  }
9093
8946
  };
9094
- //#endregion
9095
- //#region src/commands/notifications/notifications-channel.command.ts
8947
+ // src/commands/notifications/notifications-channel.command.ts
9096
8948
  const notificationsChannelCommand = {
9097
8949
  command: "channel",
9098
8950
  describe: "Manage notification channels",
9099
8951
  builder: (y) => y.command(notificationsChannelAddCommand).command(groupMenu("notifications channel")),
9100
8952
  handler: () => {}
9101
8953
  };
9102
- //#endregion
9103
- //#region src/commands/notifications/notifications.command.ts
8954
+ // src/commands/notifications/notifications.command.ts
9104
8955
  const notificationsCommand = {
9105
8956
  command: "notifications",
9106
8957
  describe: "Provision notification channels, webhooks and roles",
9107
8958
  builder: (y) => y.command(notificationsChannelCommand).command(notificationsSetupCommand).command(notificationsCreateServerCommand).command(notificationsLinkCommand).command(notificationsSyncRolesCommand).command(groupMenu("notifications")),
9108
8959
  handler: () => {}
9109
8960
  };
9110
- //#endregion
9111
- //#region src/commands/npm-bump-versions/npm-bump-versions.ts
8961
+ // src/commands/npm-bump-versions/npm-bump-versions.ts
9112
8962
  async function runNpmBumpVersions(input) {
9113
8963
  const print = input.print ?? ((line) => console.log(line));
9114
8964
  const logger = input.logger ?? getLogger();
@@ -9208,8 +9058,7 @@ async function runNpmBumpVersions(input) {
9208
9058
  skipped
9209
9059
  };
9210
9060
  }
9211
- //#endregion
9212
- //#region src/commands/npm-bump-versions/npm-bump-versions.args.ts
9061
+ // src/commands/npm-bump-versions/npm-bump-versions.args.ts
9213
9062
  const npmBumpVersionsArgs = (y) => y.positional("new-version", {
9214
9063
  type: "string",
9215
9064
  describe: "Version to set (e.g., 4.2.0 or 2.0.0-alpha.1)"
@@ -9221,8 +9070,7 @@ const npmBumpVersionsArgs = (y) => y.positional("new-version", {
9221
9070
  array: true,
9222
9071
  describe: "Leave this version group's packages alone (repeatable). The repo-wide bump uses it so it does not move a group that is released on its own."
9223
9072
  });
9224
- //#endregion
9225
- //#region src/commands/npm-bump-versions/npm-bump-versions.command.ts
9073
+ // src/commands/npm-bump-versions/npm-bump-versions.command.ts
9226
9074
  const npmBumpVersionsCommand = {
9227
9075
  command: "bump-versions [new-version]",
9228
9076
  describe: "Bump all non-private package versions in lockstep (semantic-release prepareCmd)",
@@ -9238,8 +9086,7 @@ const npmBumpVersionsCommand = {
9238
9086
  })).status === "fail") process.exitCode = 1;
9239
9087
  }
9240
9088
  };
9241
- //#endregion
9242
- //#region src/commands/publish/resolve-otp.ts
9089
+ // src/commands/publish/resolve-otp.ts
9243
9090
  /**
9244
9091
  * `argvOtp` if given, else the `HOLOCRON_OTP` env var — the secret-delivery
9245
9092
  * side of the interactive menu's options prompt (holocron#1052): a
@@ -9251,8 +9098,7 @@ const npmBumpVersionsCommand = {
9251
9098
  function resolveOtp(argvOtp, env) {
9252
9099
  return argvOtp ?? env.get("HOLOCRON_OTP");
9253
9100
  }
9254
- //#endregion
9255
- //#region src/commands/publish/default-exec.ts
9101
+ // src/commands/publish/default-exec.ts
9256
9102
  const defaultExec$1 = async (cmd, args, opts) => {
9257
9103
  const { HOLOCRON_OTP: _omittedOtp, ...env } = process.env;
9258
9104
  const result = spawnSync(cmd, args, {
@@ -9271,8 +9117,7 @@ const defaultExec$1 = async (cmd, args, opts) => {
9271
9117
  stderr: result.stderr ?? ""
9272
9118
  };
9273
9119
  };
9274
- //#endregion
9275
- //#region src/commands/publish/default-login.ts
9120
+ // src/commands/publish/default-login.ts
9276
9121
  /**
9277
9122
  * Fully interactive — `npm login --auth-type=web` prints a URL and waits for
9278
9123
  * the browser flow to complete; the operator needs to see that live, so all
@@ -9285,8 +9130,7 @@ const defaultLogin = async (cwd) => {
9285
9130
  stdio: "inherit"
9286
9131
  }).status ?? -1 };
9287
9132
  };
9288
- //#endregion
9289
- //#region src/commands/publish/discover-manifests.ts
9133
+ // src/commands/publish/discover-manifests.ts
9290
9134
  /**
9291
9135
  * Monorepo (the workspace declares public packages): every workspace
9292
9136
  * package. Single package (it declares none -- no `pnpm-workspace.yaml`, or one
@@ -9315,8 +9159,7 @@ function discoverManifests(cwd, scope = {}) {
9315
9159
  dir: `./${relativeDir}`
9316
9160
  }));
9317
9161
  }
9318
- //#endregion
9319
- //#region src/commands/publish/discover-public-package-entries.ts
9162
+ // src/commands/publish/discover-public-package-entries.ts
9320
9163
  /**
9321
9164
  * Every public package (`!private && name`) with its version and a
9322
9165
  * `pnpm --filter`-ready path — {@link runSteadyPublish}'s `skipAlreadyPublished`
@@ -9330,8 +9173,7 @@ function discoverPublicPackageEntries(cwd, scope = {}) {
9330
9173
  dir
9331
9174
  }] : []);
9332
9175
  }
9333
- //#endregion
9334
- //#region src/commands/publish/filter-new-packages.ts
9176
+ // src/commands/publish/filter-new-packages.ts
9335
9177
  /**
9336
9178
  * Keeps only the entries that don't exist on npm yet — the actual
9337
9179
  * chicken-and-egg case `--initial` exists for (ADR: npm requires a package
@@ -9377,8 +9219,7 @@ async function filterNewPackages(entries, cwd, exec, print, nameWidth, dirWidth)
9377
9219
  }
9378
9220
  return results;
9379
9221
  }
9380
- //#endregion
9381
- //#region src/commands/publish/print-next-steps.ts
9222
+ // src/commands/publish/print-next-steps.ts
9382
9223
  function printNextSteps(print, env, packageNames, identity) {
9383
9224
  print("");
9384
9225
  print("→ next: configure Trusted Publisher for each package on npm:");
@@ -9396,8 +9237,7 @@ function printNextSteps(print, env, packageNames, identity) {
9396
9237
  print(" https://www.npmjs.com/settings/~/tokens");
9397
9238
  }
9398
9239
  }
9399
- //#endregion
9400
- //#region src/commands/publish/redact-otp.ts
9240
+ // src/commands/publish/redact-otp.ts
9401
9241
  /**
9402
9242
  * Replaces the literal `otp` value in a "would run: pnpm ..." dry-run
9403
9243
  * preview line with `***` — the real `args` passed to `exec()` still need
@@ -9409,8 +9249,7 @@ function redactOtp(args, otp) {
9409
9249
  if (!otp) return [...args];
9410
9250
  return args.map((arg) => arg === otp ? "***" : arg);
9411
9251
  }
9412
- //#endregion
9413
- //#region src/commands/publish/resolve-repo-identity.ts
9252
+ // src/commands/publish/resolve-repo-identity.ts
9414
9253
  /**
9415
9254
  * One git-remote read for both the org and repo shown in the Trusted
9416
9255
  * Publisher next-steps output — `readGitRemote` already parses out `owner`
@@ -9428,8 +9267,7 @@ async function resolveRepoIdentity(cwd, exec) {
9428
9267
  repo: remote?.repo ?? "unknown"
9429
9268
  };
9430
9269
  }
9431
- //#endregion
9432
- //#region src/commands/publish/scope-of.ts
9270
+ // src/commands/publish/scope-of.ts
9433
9271
  /** The {@link WorkspaceScope} a publish input asks for; unset options stay unset. */
9434
9272
  function scopeOf({ group, excludeGroups }) {
9435
9273
  return {
@@ -9437,8 +9275,7 @@ function scopeOf({ group, excludeGroups }) {
9437
9275
  ...excludeGroups === void 0 ? {} : { excludeGroups }
9438
9276
  };
9439
9277
  }
9440
- //#endregion
9441
- //#region src/commands/publish/workspace-filter-args.ts
9278
+ // src/commands/publish/workspace-filter-args.ts
9442
9279
  /**
9443
9280
  * `-r --filter=./clients/* --filter=./observability` -- one filter per
9444
9281
  * workspace glob that holds a package. Empty (single-package repo, no `-r`)
@@ -9451,8 +9288,7 @@ function workspaceFilterArgs(cwd, scope = {}) {
9451
9288
  const globs = resolveWorkspaceGlobs(cwd).include.filter((glob) => found.some(({ relativeDir }) => glob.endsWith("/*") ? relativeDir.startsWith(glob.slice(0, -1)) : relativeDir === glob));
9452
9289
  return globs.length > 0 ? ["-r", ...globs.map((glob) => `--filter=./${glob}`)] : [];
9453
9290
  }
9454
- //#endregion
9455
- //#region src/commands/publish/run-publish/run-publish.ts
9291
+ // src/commands/publish/run-publish/run-publish.ts
9456
9292
  /**
9457
9293
  * `holocron package publish --initial` — bottles up the chicken-and-egg bootstrap
9458
9294
  * that every new npm-published holocron monorepo hits.
@@ -9657,8 +9493,7 @@ async function runPublish(input = {}) {
9657
9493
  packageNames
9658
9494
  };
9659
9495
  }
9660
- //#endregion
9661
- //#region src/commands/publish/run-steady-publish/run-steady-publish.ts
9496
+ // src/commands/publish/run-steady-publish/run-steady-publish.ts
9662
9497
  /**
9663
9498
  * `holocron package publish` (no `--initial`) — the steady-state publish
9664
9499
  * `exec.publishCmd` in `release.config.ts` should call, replacing each
@@ -9834,19 +9669,16 @@ async function runSteadyPublish(input = {}) {
9834
9669
  packageNames
9835
9670
  };
9836
9671
  }
9837
- //#endregion
9838
- //#region src/commands/publish/discover-public-packages.ts
9672
+ // src/commands/publish/discover-public-packages.ts
9839
9673
  /** The names of `discoverPublicPackageEntries`' packages, without requiring a version. */
9840
9674
  function discoverPublicPackages(cwd, scope = {}) {
9841
9675
  return discoverManifests(cwd, scope).flatMap(({ manifest }) => !manifest.private && manifest.name ? [manifest.name] : []);
9842
9676
  }
9843
- //#endregion
9844
- //#region src/commands/publish/is-eotp.ts
9677
+ // src/commands/publish/is-eotp.ts
9845
9678
  function isEotp(parsed) {
9846
9679
  return typeof parsed === "object" && parsed !== null && "error" in parsed && parsed.error?.code === "EOTP";
9847
9680
  }
9848
- //#endregion
9849
- //#region src/commands/publish/parse-json.ts
9681
+ // src/commands/publish/parse-json.ts
9850
9682
  function parseJson(raw) {
9851
9683
  try {
9852
9684
  return JSON.parse(raw);
@@ -9854,8 +9686,7 @@ function parseJson(raw) {
9854
9686
  return;
9855
9687
  }
9856
9688
  }
9857
- //#endregion
9858
- //#region src/commands/publish/run-sync-trust/run-sync-trust.ts
9689
+ // src/commands/publish/run-sync-trust/run-sync-trust.ts
9859
9690
  /**
9860
9691
  * `holocron package publish --sync-trust <old-file> <new-file>` — bulk-migrates npm
9861
9692
  * Trusted Publisher (OIDC) config to a new workflow filename across every
@@ -10033,8 +9864,7 @@ async function runSyncTrust(input) {
10033
9864
  packages: results
10034
9865
  };
10035
9866
  }
10036
- //#endregion
10037
- //#region src/commands/publish/publish.args.ts
9867
+ // src/commands/publish/publish.args.ts
10038
9868
  const publishArgs = (y) => y.option("initial", {
10039
9869
  type: "boolean",
10040
9870
  default: false,
@@ -10067,8 +9897,7 @@ const publishArgs = (y) => y.option("initial", {
10067
9897
  default: false,
10068
9898
  describe: "Steady-state only: check `npm view <pkg>@<version>` before publishing each package and skip it if that exact version already exists, instead of one bulk publish. For repos that ship many independently-versioned packages where a release doesn't bump every one."
10069
9899
  });
10070
- //#endregion
10071
- //#region src/commands/publish/publish.command.ts
9900
+ // src/commands/publish/publish.command.ts
10072
9901
  const publishCommand = {
10073
9902
  command: "publish",
10074
9903
  describe: "Publish @theholocron/* packages to npm",
@@ -10118,16 +9947,14 @@ const publishCommand = {
10118
9947
  })).status === "fail") process.exitCode = 1;
10119
9948
  }
10120
9949
  };
10121
- //#endregion
10122
- //#region src/commands/package/package.command.ts
9950
+ // src/commands/package/package.command.ts
10123
9951
  const packageCommand = {
10124
9952
  command: "package",
10125
9953
  describe: "Version and publish workspace packages",
10126
9954
  builder: (y) => y.command(npmBumpVersionsCommand).command(publishCommand).command(groupMenu("package")),
10127
9955
  handler: () => {}
10128
9956
  };
10129
- //#endregion
10130
- //#region src/commands/probe/probe.args.ts
9957
+ // src/commands/probe/probe.args.ts
10131
9958
  const probeArgs = (y) => y.positional("provider", {
10132
9959
  type: "string",
10133
9960
  describe: "Which provider's probes (omit to list them all)"
@@ -10139,8 +9966,7 @@ const probeArgs = (y) => y.positional("provider", {
10139
9966
  default: false,
10140
9967
  describe: "Run a probe that changes things without asking first (required without a terminal)"
10141
9968
  });
10142
- //#endregion
10143
- //#region src/commands/probe/app-vault.ts
9969
+ // src/commands/probe/app-vault.ts
10144
9970
  /**
10145
9971
  * The vault of an app that carries its own `holocron.config` (`apps/comlink`, `apps/sentinel`): those configs govern where
10146
9972
  * the app's secrets live, apart from the root's. `undefined` when the app has no config of its own (the search for one
@@ -10162,8 +9988,7 @@ async function loadAppVault(appDir, context, importer) {
10162
9988
  await loader.load();
10163
9989
  return loader.has("vault") ? loader.get("vault") : void 0;
10164
9990
  }
10165
- //#endregion
10166
- //#region src/commands/probe/comlink-probes.ts
9991
+ // src/commands/probe/comlink-probes.ts
10167
9992
  /** The group of probes for the Comlink relay Worker (`apps/comlink`). It is an app, not a provider, so they are the CLI's own. */
10168
9993
  const COMLINK_PROVIDER = "comlink";
10169
9994
  /** Where the relay answers and what it is called, from the notifications layout and the `errors` provider. */
@@ -10304,8 +10129,7 @@ function comlinkProbes(deps) {
10304
10129
  }
10305
10130
  };
10306
10131
  }
10307
- //#endregion
10308
- //#region src/commands/probe/core-probes.ts
10132
+ // src/commands/probe/core-probes.ts
10309
10133
  /** The group of probes that belong to the CLI itself, not to a provider. */
10310
10134
  const CORE_PROVIDER = "core";
10311
10135
  /**
@@ -10365,8 +10189,7 @@ function coreProbes(loader, builtIn = /* @__PURE__ */ new Map()) {
10365
10189
  }
10366
10190
  } };
10367
10191
  }
10368
- //#endregion
10369
- //#region src/commands/probe/list-probes.ts
10192
+ // src/commands/probe/list-probes.ts
10370
10193
  /** The listing `holocron probe` prints: each provider, and under it each probe with its summary; writers are marked. */
10371
10194
  function listProbes(groups) {
10372
10195
  const lines = [];
@@ -10381,8 +10204,7 @@ function listProbes(groups) {
10381
10204
  }
10382
10205
  return lines;
10383
10206
  }
10384
- //#endregion
10385
- //#region src/ui/command-failure/command-failure.ts
10207
+ // src/ui/command-failure/command-failure.ts
10386
10208
  /**
10387
10209
  * Error class names whose `.message` is a complete, actionable sentence. Any other error is printed too, so a command
10388
10210
  * that throws a plain `Error` is never silent; this set only marks the ones written to be read as they are.
@@ -10400,8 +10222,7 @@ const USER_FACING_ERRORS = /* @__PURE__ */ new Set([
10400
10222
  function commandFailureMessage(err) {
10401
10223
  return describeProviderError(err) || (err instanceof Error ? err.name : "the command failed");
10402
10224
  }
10403
- //#endregion
10404
- //#region src/commands/probe/scrub.ts
10225
+ // src/commands/probe/scrub.ts
10405
10226
  const HIDDEN = "«hidden»";
10406
10227
  /** Shapes that are credentials wherever they appear: a Discord webhook URL, a bearer header, a Sentry token. */
10407
10228
  const SHAPES = [
@@ -10424,8 +10245,7 @@ function createScrubber(secrets) {
10424
10245
  return out;
10425
10246
  };
10426
10247
  }
10427
- //#endregion
10428
- //#region src/commands/probe/run-probe.ts
10248
+ // src/commands/probe/run-probe.ts
10429
10249
  const defaultInterrupt = (handler) => {
10430
10250
  const listener = () => void handler().finally(() => process.exit(130));
10431
10251
  process.once("SIGINT", listener);
@@ -10535,8 +10355,7 @@ async function runProbe(input) {
10535
10355
  rows
10536
10356
  };
10537
10357
  }
10538
- //#endregion
10539
- //#region src/commands/probe/probe.ts
10358
+ // src/commands/probe/probe.ts
10540
10359
  /**
10541
10360
  * `holocron probe [<provider> [<probe>]]`. With nothing, lists what can be probed; with a provider, lists its probes;
10542
10361
  * with both, runs one. Probes come from the configured plugins, plus the CLI's own `core` group.
@@ -10587,8 +10406,7 @@ async function runProbeCommand(input) {
10587
10406
  ...input.onInterrupt ? { onInterrupt: input.onInterrupt } : {}
10588
10407
  })).status };
10589
10408
  }
10590
- //#endregion
10591
- //#region src/commands/probe/probe.command.ts
10409
+ // src/commands/probe/probe.command.ts
10592
10410
  const probeCommand = {
10593
10411
  command: "probe [provider] [probe]",
10594
10412
  describe: "Poke a live provider on purpose: inspect it, or run a proof that cleans up after itself",
@@ -10614,8 +10432,7 @@ const probeCommand = {
10614
10432
  })).status === "fail") process.exitCode = 1;
10615
10433
  }
10616
10434
  };
10617
- //#endregion
10618
- //#region src/commands/setup/derived-properties/derived-properties.ts
10435
+ // src/commands/setup/derived-properties/derived-properties.ts
10619
10436
  /**
10620
10437
  * Repo archetype, in priority order:
10621
10438
  * 1. `*-template` repo name → `template` (independent of package shape).
@@ -10712,8 +10529,7 @@ async function readWorkspacePackageJsons(repoRoot, workspacePackages) {
10712
10529
  }
10713
10530
  return results;
10714
10531
  }
10715
- //#endregion
10716
- //#region src/commands/setup/labels.ts
10532
+ // src/commands/setup/labels.ts
10717
10533
  const CANONICAL_LABELS = [
10718
10534
  {
10719
10535
  name: "bug",
@@ -10808,11 +10624,9 @@ const STALE_LABELS = [
10808
10624
  "autorelease: tagged",
10809
10625
  "released on @alpha"
10810
10626
  ];
10811
- //#endregion
10812
- //#region src/templates/dco.yml
10627
+ // src/templates/dco.yml
10813
10628
  var dco_default = "allowRemediationCommits:\n individual: true\n";
10814
- //#endregion
10815
- //#region src/commands/preview-deploy-paths/preview-deploy-paths.ts
10629
+ // src/commands/preview-deploy-paths/preview-deploy-paths.ts
10816
10630
  /** `realpathSync`, falling back to the unresolved input on a path that doesn't exist (e.g. a test fixture). */
10817
10631
  function tryRealpath(path) {
10818
10632
  try {
@@ -10867,8 +10681,7 @@ function withAutoPreviewDeployPaths(tasks, gitRoot) {
10867
10681
  };
10868
10682
  });
10869
10683
  }
10870
- //#endregion
10871
- //#region src/commands/workflow-source-marker/workflow-source-marker.ts
10684
+ // src/commands/workflow-source-marker/workflow-source-marker.ts
10872
10685
  /** `# Source package: <path>` line at the head of a generated thin-caller workflow — see {@link resolvePkgRelPath}. */
10873
10686
  const SOURCE_PACKAGE_MARKER = /^# Source package: (.+)$/m;
10874
10687
  /** Strip control characters (including ANSI escapes) before a value reaches a printed error message. */
@@ -10940,8 +10753,7 @@ async function assertNoPackageCollision(taskName, pkgRelPath, filename, readExis
10940
10753
  const previousPkg = SOURCE_PACKAGE_MARKER.exec(existing)?.[1];
10941
10754
  if (previousPkg !== void 0 && previousPkg !== pkgRelPath) throw new Error(`task "${taskName}" would overwrite .github/workflows/${filename}, already generated for package "${sanitizeForDisplay(previousPkg)}" — the same task name can't be used by two different packages (holocron#1026). If "${sanitizeForDisplay(previousPkg)}" moved or was renamed to this path, delete .github/workflows/${filename} first and re-run this command; otherwise rename one or give it a different thin-caller filename.`);
10942
10755
  }
10943
- //#endregion
10944
- //#region src/commands/setup/agent-prompts-data.ts
10756
+ // src/commands/setup/agent-prompts-data.ts
10945
10757
  /**
10946
10758
  * Canonical AI engineering workflow role prompts.
10947
10759
  *
@@ -11334,8 +11146,7 @@ the system must do — not how to implement it.
11334
11146
 
11335
11147
  > **Drafts** live in \`.notes/*.spec.md\` until accepted, then graduate here.
11336
11148
  `;
11337
- //#endregion
11338
- //#region src/commands/setup/agent-prompts.ts
11149
+ // src/commands/setup/agent-prompts.ts
11339
11150
  const AGENTS_PROMPTS_ROOT = ".agents/prompts";
11340
11151
  const PROMPTS_GITIGNORE_START = "# managed by holocron setup — prompts";
11341
11152
  const PROMPTS_GITIGNORE_END = "# end managed by holocron setup — prompts";
@@ -11350,8 +11161,7 @@ async function installAgentPrompts({ repoRoot }) {
11350
11161
  });
11351
11162
  return `wrote ${Object.keys(AGENT_PROMPTS).length} prompt files to ${AGENTS_PROMPTS_ROOT}/`;
11352
11163
  }
11353
- //#endregion
11354
- //#region src/commands/setup/branch-protection.ts
11164
+ // src/commands/setup/branch-protection.ts
11355
11165
  const RULESET_NAME = "holocron-default-branch";
11356
11166
  function buildClassicProtectionPayload(requiredChecks = []) {
11357
11167
  return {
@@ -11466,8 +11276,7 @@ async function upsertBranchProtection(source, dryRun, requiredChecks) {
11466
11276
  };
11467
11277
  }
11468
11278
  }
11469
- //#endregion
11470
- //#region src/commands/setup/engineering.ts
11279
+ // src/commands/setup/engineering.ts
11471
11280
  async function writeIfAbsent(filePath, content) {
11472
11281
  try {
11473
11282
  await access(filePath);
@@ -11488,8 +11297,7 @@ async function installEngineeringStructure({ repoRoot }) {
11488
11297
  for (const [path, content] of writes) if (await writeIfAbsent(path, content)) results.push(path.replace(repoRoot + "/", ""));
11489
11298
  return results.length > 0 ? `created: ${results.join(", ")}` : "all files already exist — nothing to write";
11490
11299
  }
11491
- //#endregion
11492
- //#region src/commands/setup/repo-settings.ts
11300
+ // src/commands/setup/repo-settings.ts
11493
11301
  const BALANCED_REPO_SETTINGS = {
11494
11302
  allow_squash_merge: true,
11495
11303
  allow_merge_commit: false,
@@ -11502,8 +11310,7 @@ const BALANCED_REPO_SETTINGS = {
11502
11310
  has_projects: true,
11503
11311
  has_wiki: false
11504
11312
  };
11505
- //#endregion
11506
- //#region src/commands/setup/run-step/run-step.ts
11313
+ // src/commands/setup/run-step/run-step.ts
11507
11314
  async function runStep(capability, step, dryRun, body, opts = {}) {
11508
11315
  const result = await execStep(capability, step, dryRun, body, opts);
11509
11316
  const { status, message, reason } = result;
@@ -11573,8 +11380,7 @@ function formatStep(step) {
11573
11380
  if (step.status === "dry-run") return ` ${style.dim(`… ${label}`)}`;
11574
11381
  return ` ${style.dim(`· ${label}`)}`;
11575
11382
  }
11576
- //#endregion
11577
- //#region src/commands/setup/skills/skills.ts
11383
+ // src/commands/setup/skills/skills.ts
11578
11384
  async function fetchExternalSkill(entry) {
11579
11385
  if (entry.sourceType !== "github")
11580
11386
  /* c8 ignore next */
@@ -11745,8 +11551,7 @@ async function updateSkillsGitignore(gitignorePath, skills, symlinkFn) {
11745
11551
  lines: [`/${AGENTS_SKILLS_ROOT}/`, ...skills.map((n) => `/${symlinkFn(n)}`)]
11746
11552
  });
11747
11553
  }
11748
- //#endregion
11749
- //#region src/commands/setup/run-setup.ts
11554
+ // src/commands/setup/run-setup.ts
11750
11555
  /**
11751
11556
  * `holocron repo setup` — orchestrates per-capability setup actions across
11752
11557
  * every plugin loaded from `holocron.config.json`.
@@ -12522,8 +12327,7 @@ async function ensurePrepareScript(repoRoot) {
12522
12327
  await writeFile(pkgPath, stringifyJson(pkg, { like: content }), "utf8");
12523
12328
  return true;
12524
12329
  }
12525
- //#endregion
12526
- //#region src/commands/setup/setup.args.ts
12330
+ // src/commands/setup/setup.args.ts
12527
12331
  const setupArgs = (y) => y.option("repo", {
12528
12332
  type: "string",
12529
12333
  describe: "Repo coords (\"owner/name\"). Defaults to plugin-specific resolution."
@@ -12531,8 +12335,7 @@ const setupArgs = (y) => y.option("repo", {
12531
12335
  type: "boolean",
12532
12336
  describe: "Install git hooks (.husky/pre-push → holocron run ci). Default: on for protection:'strict'. --no-hooks to skip."
12533
12337
  });
12534
- //#endregion
12535
- //#region src/commands/setup/setup.command.ts
12338
+ // src/commands/setup/setup.command.ts
12536
12339
  const setupCommand = {
12537
12340
  command: "setup",
12538
12341
  describe: "Apply infra setup actions across every configured capability",
@@ -12555,8 +12358,7 @@ const setupCommand = {
12555
12358
  })).summary.fail > 0) process.exitCode = 1;
12556
12359
  }
12557
12360
  };
12558
- //#endregion
12559
- //#region src/commands/sync-readme/sync-readme.ts
12361
+ // src/commands/sync-readme/sync-readme.ts
12560
12362
  const MARKER_INSTALL_START = "<!-- holocron:installation -->";
12561
12363
  const MARKER_INSTALL_END = "<!-- /holocron:installation -->";
12562
12364
  const REGISTRY_MAP = {
@@ -12711,8 +12513,7 @@ async function runSyncReadme(input) {
12711
12513
  updated
12712
12514
  };
12713
12515
  }
12714
- //#endregion
12715
- //#region src/commands/sync-wiki/sync-wiki.ts
12516
+ // src/commands/sync-wiki/sync-wiki.ts
12716
12517
  function resolveToken(input) {
12717
12518
  return input.token ?? input.context.cliToken ?? firstEnv(env, [
12718
12519
  "HOLOCRON_READ_TOKEN",
@@ -12928,8 +12729,7 @@ async function runSyncWiki(input) {
12928
12729
  };
12929
12730
  }
12930
12731
  }
12931
- //#endregion
12932
- //#region src/commands/sync/sync.ts
12732
+ // src/commands/sync/sync.ts
12933
12733
  const { workflowHeader } = createHeader({
12934
12734
  source: "cli/astromech/src/thin-callers.ts",
12935
12735
  tool: "holocron repo sync"
@@ -13528,15 +13328,13 @@ async function readExistingWorkflowFile(repoRoot, filename) {
13528
13328
  throw err;
13529
13329
  }
13530
13330
  }
13531
- //#endregion
13532
- //#region src/commands/sync-readme/sync-readme.args.ts
13331
+ // src/commands/sync-readme/sync-readme.args.ts
13533
13332
  const syncReadmeArgs = (y) => y.option("dry-run", {
13534
13333
  type: "boolean",
13535
13334
  describe: "Print what would change without writing",
13536
13335
  default: false
13537
13336
  });
13538
- //#endregion
13539
- //#region src/commands/sync-readme/sync-readme.command.ts
13337
+ // src/commands/sync-readme/sync-readme.command.ts
13540
13338
  const syncReadmeCommand = {
13541
13339
  command: "readme",
13542
13340
  describe: "Sync the Installation + Usage block in README.md from package.json",
@@ -13557,8 +13355,7 @@ const syncReadmeCommand = {
13557
13355
  }
13558
13356
  }
13559
13357
  };
13560
- //#endregion
13561
- //#region src/commands/repo/repo-sync.args.ts
13358
+ // src/commands/repo/repo-sync.args.ts
13562
13359
  const repoSyncArgs = (y) => y.positional("steps", {
13563
13360
  type: "string",
13564
13361
  array: true,
@@ -13567,8 +13364,7 @@ const repoSyncArgs = (y) => y.positional("steps", {
13567
13364
  type: "string",
13568
13365
  describe: "Repo coords (\"owner/name\"). Defaults to plugin-specific resolution."
13569
13366
  });
13570
- //#endregion
13571
- //#region src/commands/repo/repo-sync.command.ts
13367
+ // src/commands/repo/repo-sync.command.ts
13572
13368
  const repoSyncCommand = {
13573
13369
  command: "sync [steps..]",
13574
13370
  describe: "Sync state from config to the provider and local files (labels, properties, teams, topics, keywords, description, homepage, readme, workflows, scripts, wiki)",
@@ -13591,8 +13387,7 @@ const repoSyncCommand = {
13591
13387
  })).summary.fail > 0) process.exitCode = 1;
13592
13388
  }
13593
13389
  };
13594
- //#endregion
13595
- //#region src/commands/upgrade-deps/upgrade-deps.ts
13390
+ // src/commands/upgrade-deps/upgrade-deps.ts
13596
13391
  /**
13597
13392
  * `holocron repo upgrade deps` — bring a repo's `@theholocron/*` dependency pins and
13598
13393
  * its `holocron.config.ts` up to the current major.
@@ -13819,15 +13614,13 @@ async function runUpgradeDeps(input = {}) {
13819
13614
  configWarnings
13820
13615
  };
13821
13616
  }
13822
- //#endregion
13823
- //#region src/commands/upgrade-deps/upgrade-deps.args.ts
13617
+ // src/commands/upgrade-deps/upgrade-deps.args.ts
13824
13618
  const upgradeDepsArgs = (yy) => yy.option("pins-only", {
13825
13619
  type: "boolean",
13826
13620
  default: false,
13827
13621
  describe: "Only bump the catalog pins — skip the holocron.config.ts migration"
13828
13622
  });
13829
- //#endregion
13830
- //#region src/commands/upgrade-deps/upgrade-deps.command.ts
13623
+ // src/commands/upgrade-deps/upgrade-deps.command.ts
13831
13624
  const upgradeDepsCommand = {
13832
13625
  command: "deps",
13833
13626
  describe: "Bump every @theholocron/* pin to latest and migrate holocron.config.ts to the current preset API",
@@ -13844,8 +13637,7 @@ const upgradeDepsCommand = {
13844
13637
  }
13845
13638
  }
13846
13639
  };
13847
- //#endregion
13848
- //#region src/commands/upgrade-node/upgrade-node.ts
13640
+ // src/commands/upgrade-node/upgrade-node.ts
13849
13641
  const SKIP_DIRS = [
13850
13642
  "node_modules",
13851
13643
  ".git",
@@ -14029,8 +13821,7 @@ async function runUpgradeNode(input) {
14029
13821
  updated
14030
13822
  };
14031
13823
  }
14032
- //#endregion
14033
- //#region src/commands/upgrade-node/upgrade-node.args.ts
13824
+ // src/commands/upgrade-node/upgrade-node.args.ts
14034
13825
  const upgradeNodeArgs = (yy) => yy.positional("to", {
14035
13826
  type: "number",
14036
13827
  describe: "Target Node.js major version (e.g., 22)"
@@ -14038,8 +13829,7 @@ const upgradeNodeArgs = (yy) => yy.positional("to", {
14038
13829
  type: "number",
14039
13830
  describe: "Current major version to replace. Auto-detected from .nvmrc / engines.node when omitted."
14040
13831
  });
14041
- //#endregion
14042
- //#region src/commands/upgrade-node/upgrade-node.command.ts
13832
+ // src/commands/upgrade-node/upgrade-node.command.ts
14043
13833
  const upgradeNodeCommand = {
14044
13834
  command: "node [to]",
14045
13835
  describe: "Scan the repo and update every Node.js version pin to a new major",
@@ -14065,24 +13855,21 @@ const upgradeNodeCommand = {
14065
13855
  }
14066
13856
  }
14067
13857
  };
14068
- //#endregion
14069
- //#region src/commands/repo/repo-upgrade.command.ts
13858
+ // src/commands/repo/repo-upgrade.command.ts
14070
13859
  const repoUpgradeCommand = {
14071
13860
  command: "upgrade",
14072
13861
  describe: "Upgrade toolchain version pins across the repo",
14073
13862
  builder: (y) => y.command(upgradeNodeCommand).command(upgradeDepsCommand).command(groupMenu("repo upgrade")),
14074
13863
  handler: () => {}
14075
13864
  };
14076
- //#endregion
14077
- //#region src/commands/repo/repo.command.ts
13865
+ // src/commands/repo/repo.command.ts
14078
13866
  const repoCommand = {
14079
13867
  command: "repo",
14080
13868
  describe: "Set up, sync and upgrade the current repo",
14081
13869
  builder: (y) => y.command(setupCommand).command(repoSyncCommand).command(repoUpgradeCommand).command(groupMenu("repo")),
14082
13870
  handler: () => {}
14083
13871
  };
14084
- //#endregion
14085
- //#region src/commands/run/run.args.ts
13872
+ // src/commands/run/run.args.ts
14086
13873
  const runArgs = (y) => y.positional("task", {
14087
13874
  type: "string",
14088
13875
  demandOption: true,
@@ -14106,8 +13893,7 @@ const runArgs = (y) => y.positional("task", {
14106
13893
  type: "string",
14107
13894
  describe: "turbo --filter=<pkg> passthrough (monorepo)."
14108
13895
  });
14109
- //#endregion
14110
- //#region src/commands/run/run.command.ts
13896
+ // src/commands/run/run.command.ts
14111
13897
  const runCommand = {
14112
13898
  command: "run <task> [job] [passthrough..]",
14113
13899
  describe: "Run a task locally (test, typecheck, lint, build, audit) — figures out turbo / the tool / the package manager. `run ci` runs every merge-gating check; `run lint commit-msg <file>` lints a commit message.",
@@ -14157,8 +13943,7 @@ const runCommand = {
14157
13943
  if (report.status === "fail" || report.status === "unknown") process.exitCode = 1;
14158
13944
  }
14159
13945
  };
14160
- //#endregion
14161
- //#region src/commands/secret-set/secret-set.ts
13946
+ // src/commands/secret-set/secret-set.ts
14162
13947
  /**
14163
13948
  * `holocron secrets set` — one-shot single-secret push.
14164
13949
  *
@@ -14249,8 +14034,7 @@ function describeScope(scope) {
14249
14034
  if (scope.kind === "environment") return `scope=environment:${scope.name}`;
14250
14035
  return `scope=organization:${scope.name}`;
14251
14036
  }
14252
- //#endregion
14253
- //#region src/commands/secret-set/secret-set.args.ts
14037
+ // src/commands/secret-set/secret-set.args.ts
14254
14038
  const secretSetArgs = (y) => y.positional("name", {
14255
14039
  type: "string",
14256
14040
  describe: "Secret name (e.g., NPM_TOKEN)"
@@ -14269,8 +14053,7 @@ const secretSetArgs = (y) => y.positional("name", {
14269
14053
  default: "repo",
14270
14054
  describe: "Scope: \"repo\" (default), \"env=<name>\", or \"org=<name>\""
14271
14055
  });
14272
- //#endregion
14273
- //#region src/commands/secret-set/secret-set.command.ts
14056
+ // src/commands/secret-set/secret-set.command.ts
14274
14057
  const secretSetCommand = {
14275
14058
  command: "set [name] [value]",
14276
14059
  describe: "Set a single secret via the configured `secrets` capability",
@@ -14299,8 +14082,7 @@ const secretSetCommand = {
14299
14082
  })).status === "fail") process.exitCode = 1;
14300
14083
  }
14301
14084
  };
14302
- //#endregion
14303
- //#region src/commands/secrets-sync/secrets-sync.ts
14085
+ // src/commands/secrets-sync/secrets-sync.ts
14304
14086
  /**
14305
14087
  * `holocron secrets sync` — vault → destinations.
14306
14088
  *
@@ -14512,8 +14294,7 @@ function vaultProviderName(loader) {
14512
14294
  if (!loader.has("vault")) return "<missing>";
14513
14295
  return loader.get("vault").providerName;
14514
14296
  }
14515
- //#endregion
14516
- //#region src/commands/secrets-sync/secrets-sync.args.ts
14297
+ // src/commands/secrets-sync/secrets-sync.args.ts
14517
14298
  const secretsSyncArgs = (y) => y.positional("environmentId", {
14518
14299
  type: "string",
14519
14300
  describe: "Vault environment id to read (1P Environment id, etc.)"
@@ -14535,8 +14316,7 @@ const secretsSyncArgs = (y) => y.positional("environmentId", {
14535
14316
  default: "repo",
14536
14317
  describe: "Scope applied to every --github-secret key: \"repo\" (default), \"env=<name>\", or \"org=<name>\"."
14537
14318
  });
14538
- //#endregion
14539
- //#region src/commands/secrets-sync/secrets-sync.command.ts
14319
+ // src/commands/secrets-sync/secrets-sync.command.ts
14540
14320
  const secretsSyncCommand = {
14541
14321
  command: "sync [environmentId]",
14542
14322
  describe: "Read a vault environment + fan KEY=VALUEs out to secrets + deployment env vars",
@@ -14565,16 +14345,14 @@ const secretsSyncCommand = {
14565
14345
  })).summary.fail > 0) process.exitCode = 1;
14566
14346
  }
14567
14347
  };
14568
- //#endregion
14569
- //#region src/commands/secrets/secrets.command.ts
14348
+ // src/commands/secrets/secrets.command.ts
14570
14349
  const secretsCommand = {
14571
14350
  command: "secrets",
14572
14351
  describe: "Set secrets and sync vault environments",
14573
14352
  builder: (y) => y.command(secretSetCommand).command(secretsSyncCommand).command(groupMenu("secrets")),
14574
14353
  handler: () => {}
14575
14354
  };
14576
- //#endregion
14577
- //#region src/commands/skills/skills.args.ts
14355
+ // src/commands/skills/skills.args.ts
14578
14356
  const skillsRemoveArgs = (y) => y.positional("names", {
14579
14357
  type: "string",
14580
14358
  array: true,
@@ -14584,8 +14362,7 @@ const skillsUpdateArgs = (y) => y.positional("name", {
14584
14362
  type: "string",
14585
14363
  describe: "Skill name to update (omit to update all installed skills)"
14586
14364
  });
14587
- //#endregion
14588
- //#region src/commands/skills/skills.ts
14365
+ // src/commands/skills/skills.ts
14589
14366
  /**
14590
14367
  * `holocron skills` — install, remove, and update agent skills from @theholocron/skills.
14591
14368
  *
@@ -14683,8 +14460,7 @@ function runSkillsUpdate(input) {
14683
14460
  const { exitCode } = exec("npx", args, { cwd: repoRoot });
14684
14461
  return { status: exitCode === 0 ? "ok" : "fail" };
14685
14462
  }
14686
- //#endregion
14687
- //#region src/commands/skills/skills.command.ts
14463
+ // src/commands/skills/skills.command.ts
14688
14464
  const skillsInstall = {
14689
14465
  command: "install",
14690
14466
  describe: "Copy skills from @theholocron/skills into .agents/ with agent symlinks",
@@ -14733,8 +14509,7 @@ const skillsCommand = {
14733
14509
  builder: (y) => y.command(skillsInstall).command(skillsRemove).command(skillsUpdate).command(groupMenu("skills")),
14734
14510
  handler: () => {}
14735
14511
  };
14736
- //#endregion
14737
- //#region src/commands/sync-github/sync-github.ts
14512
+ // src/commands/sync-github/sync-github.ts
14738
14513
  const DEFAULT_REPO = "theholocron/.github";
14739
14514
  /**
14740
14515
  * The file set `sync-github` pushes to `theholocron/.github` — the reusable
@@ -14973,8 +14748,7 @@ async function runSyncGithub(input) {
14973
14748
  prUrl
14974
14749
  });
14975
14750
  }
14976
- //#endregion
14977
- //#region src/commands/sync-github/sync-github.args.ts
14751
+ // src/commands/sync-github/sync-github.args.ts
14978
14752
  const syncGithubArgs = (y) => y.option("repo", {
14979
14753
  type: "string",
14980
14754
  default: "theholocron/.github",
@@ -14993,8 +14767,7 @@ const syncGithubArgs = (y) => y.option("repo", {
14993
14767
  type: "string",
14994
14768
  describe: "Write generated files to this local directory instead of pushing (for validation)"
14995
14769
  });
14996
- //#endregion
14997
- //#region src/commands/sync-github/sync-github.command.ts
14770
+ // src/commands/sync-github/sync-github.command.ts
14998
14771
  const resolveSyncToken = createFeatureResolver({
14999
14772
  envName: "HOLOCRON_SYNC_TOKEN",
15000
14773
  keyringKey: "github.sync"
@@ -15027,16 +14800,14 @@ const syncGithubCommand = {
15027
14800
  })).status === "fail") process.exitCode = 1;
15028
14801
  }
15029
14802
  };
15030
- //#endregion
15031
- //#region src/commands/sync/sync.command.ts
14803
+ // src/commands/sync/sync.command.ts
15032
14804
  const syncCommand = {
15033
14805
  command: "sync",
15034
14806
  describe: "Sync generated files to other repos",
15035
14807
  builder: (y) => y.command(syncGithubCommand).command(groupMenu("sync")),
15036
14808
  handler: () => {}
15037
14809
  };
15038
- //#endregion
15039
- //#region src/update-notifier/update-notifier.ts
14810
+ // src/update-notifier/update-notifier.ts
15040
14811
  const PACKAGE_NAME = "@theholocron/cli";
15041
14812
  const CACHE_TTL_MS = 864e5;
15042
14813
  const FETCH_TIMEOUT_MS = 3e3;
@@ -15147,8 +14918,7 @@ async function checkForUpdates(currentVersion) {
15147
14918
  process.stderr.write(formatNotice(currentVersion, latestVersion) + "\n");
15148
14919
  };
15149
14920
  }
15150
- //#endregion
15151
- //#region src/cli.ts
14921
+ // src/cli.ts
15152
14922
  const { version: CLI_VERSION } = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf-8"));
15153
14923
  /** Whether to print the correlation id at command end (`--debug` / `--verbose`). */
15154
14924
  let printRunId = false;
@@ -15226,7 +14996,6 @@ const rid = getRunId();
15226
14996
  if (printRunId && rid) console.log(`Run ID: ${rid}`);
15227
14997
  (await updateCheckPromise)?.();
15228
14998
  await flush();
15229
- //#endregion
15230
14999
  export {};
15231
15000
 
15232
15001
  //# sourceMappingURL=cli.mjs.map