@theholocron/cli 5.0.0-alpha.246 → 5.0.0-alpha.248

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
@@ -7640,8 +7513,7 @@ async function runNew(input) {
7640
7513
  filesPatched
7641
7514
  };
7642
7515
  }
7643
- //#endregion
7644
- //#region src/commands/new/new-repo.args.ts
7516
+ // src/commands/new/new-repo.args.ts
7645
7517
  const newRepoArgs = (y) => y.positional("type", {
7646
7518
  type: "string",
7647
7519
  describe: "Template type — maps to theholocron/<type>-template (e.g. cli, react, nextjs, node, monorepo, base)"
@@ -7693,8 +7565,7 @@ const newRepoArgs = (y) => y.positional("type", {
7693
7565
  default: true,
7694
7566
  describe: "Run pnpm install + holocron repo setup after bootstrapping (--no-verify skips)"
7695
7567
  });
7696
- //#endregion
7697
- //#region src/commands/new/new-repo-wizard.ts
7568
+ // src/commands/new/new-repo-wizard.ts
7698
7569
  /** `holocron new repo`'s interactive wizard: asks for every field not already supplied as an argument. */
7699
7570
  async function askNewRepoAnswers(argv, prompts = {
7700
7571
  input,
@@ -7889,8 +7760,7 @@ async function askNewRepoAnswers(argv, prompts = {
7889
7760
  isTemplate
7890
7761
  };
7891
7762
  }
7892
- //#endregion
7893
- //#region src/commands/new/new-repo.command.ts
7763
+ // src/commands/new/new-repo.command.ts
7894
7764
  const newRepoCommand = {
7895
7765
  command: "repo [type] [name]",
7896
7766
  describe: "Scaffold a new repo from a GitHub template (e.g. cli, react, nextjs, node, monorepo, base)",
@@ -7946,16 +7816,14 @@ const newRepoCommand = {
7946
7816
  }
7947
7817
  }
7948
7818
  };
7949
- //#endregion
7950
- //#region src/commands/new/new.command.ts
7819
+ // src/commands/new/new.command.ts
7951
7820
  const newCommand = {
7952
7821
  command: "new",
7953
7822
  describe: "Scaffold a new repo or plugin",
7954
7823
  builder: (y) => y.command(newRepoCommand).command(pluginCreateCommand).command(groupMenu("new")),
7955
7824
  handler: () => {}
7956
7825
  };
7957
- //#endregion
7958
- //#region src/commands/notifications-create-server/find-guild-id.ts
7826
+ // src/commands/notifications-create-server/find-guild-id.ts
7959
7827
  /**
7960
7828
  * Every `guildId: "<digits>"` property in the source, found by reading it as code: comments are skipped and a
7961
7829
  * string is one piece, so a `guildId` inside a comment or inside another string is not a property. The key may be
@@ -8019,8 +7887,7 @@ function findGuildId(source) {
8019
7887
  }
8020
7888
  return found;
8021
7889
  }
8022
- //#endregion
8023
- //#region src/commands/notifications-create-server/lock-config.ts
7890
+ // src/commands/notifications-create-server/lock-config.ts
8024
7891
  /**
8025
7892
  * Takes a lock next to the config so two runs cannot create and hand over different servers and then overwrite
8026
7893
  * each other's `guildId`. Returns a function that releases it, or undefined when another run holds it. The lock
@@ -8041,8 +7908,7 @@ async function lockConfig(filepath) {
8041
7908
  release: () => unlink(path).catch(() => void 0)
8042
7909
  };
8043
7910
  }
8044
- //#endregion
8045
- //#region src/commands/notifications-setup/avatar-problem.ts
7911
+ // src/commands/notifications-setup/avatar-problem.ts
8046
7912
  /** The first reason a feed's `avatar` cannot work, or undefined. `feed` names the key for the message (`monitoring`, `errors`). */
8047
7913
  function avatarProblem(channel, feed, picture) {
8048
7914
  if (typeof picture !== "object") return void 0;
@@ -8128,8 +7994,7 @@ async function deployRelay(input) {
8128
7994
  script
8129
7995
  };
8130
7996
  }
8131
- //#endregion
8132
- //#region src/commands/notifications-setup/with-elevation.ts
7997
+ // src/commands/notifications-setup/with-elevation.ts
8133
7998
  /**
8134
7999
  * Runs an edit that may need a permission the bot should not keep. When the provider says it does
8135
8000
  * ({@link ElevationRequiredError}) and a person is there to answer, walks them through it: the link that gives the
@@ -8183,8 +8048,7 @@ async function withElevation(run, deps) {
8183
8048
  };
8184
8049
  }
8185
8050
  }
8186
- //#endregion
8187
- //#region src/commands/notifications-setup/notifications-setup.ts
8051
+ // src/commands/notifications-setup/notifications-setup.ts
8188
8052
  /**
8189
8053
  * `holocron notifications setup` — apply the server layout a `notifications`
8190
8054
  * provider declares in `holocron.config.ts` (categories, channels, roles, and
@@ -8699,8 +8563,7 @@ async function runNotificationsSetup(input$1) {
8699
8563
  }, "notifications setup");
8700
8564
  return report;
8701
8565
  }
8702
- //#endregion
8703
- //#region src/commands/notifications-create-server/pick-server-creator.ts
8566
+ // src/commands/notifications-create-server/pick-server-creator.ts
8704
8567
  /** The provider that can create a server and hand it over. */
8705
8568
  function pickServerCreator(providers, wanted) {
8706
8569
  return pickProvider(providers, wanted, (p) => typeof p.createServer === "function" && typeof p.inviteLink === "function" && typeof p.hasMember === "function" && typeof p.transferServer === "function", {
@@ -8708,8 +8571,7 @@ function pickServerCreator(providers, wanted) {
8708
8571
  gerund: "creating a server"
8709
8572
  });
8710
8573
  }
8711
- //#endregion
8712
- //#region src/commands/notifications-create-server/write-guild-id.ts
8574
+ // src/commands/notifications-create-server/write-guild-id.ts
8713
8575
  /**
8714
8576
  * Puts a new server id where the config names the old one. It changes a file the person wrote, so it only does
8715
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.
@@ -8745,8 +8607,7 @@ async function writeGuildId(filepath, id) {
8745
8607
  }
8746
8608
  return { written: true };
8747
8609
  }
8748
- //#endregion
8749
- //#region src/commands/notifications-create-server/notifications-create-server.ts
8610
+ // src/commands/notifications-create-server/notifications-create-server.ts
8750
8611
  /**
8751
8612
  * `holocron notifications create-server` — makes the server a layout describes, from nothing.
8752
8613
  *
@@ -8890,8 +8751,7 @@ async function runNotificationsCreateServer(input) {
8890
8751
  logger.info({ serverId: report.serverId }, "notifications create-server");
8891
8752
  return report;
8892
8753
  }
8893
- //#endregion
8894
- //#region src/commands/notifications-create-server/notifications-create-server.args.ts
8754
+ // src/commands/notifications-create-server/notifications-create-server.args.ts
8895
8755
  const notificationsCreateServerArgs = (y) => y.option("name", {
8896
8756
  type: "string",
8897
8757
  describe: "What the new server is called (not needed with --resume)"
@@ -8911,8 +8771,7 @@ const notificationsCreateServerArgs = (y) => y.option("name", {
8911
8771
  default: false,
8912
8772
  describe: "The server exists: skip creating and applying, and finish the hand-over"
8913
8773
  });
8914
- //#endregion
8915
- //#region src/commands/notifications-create-server/notifications-create-server.command.ts
8774
+ // src/commands/notifications-create-server/notifications-create-server.command.ts
8916
8775
  const notificationsCreateServerCommand = {
8917
8776
  command: "create-server",
8918
8777
  describe: "Create the server the layout describes, apply it, invite its owner and hand it over",
@@ -8938,14 +8797,12 @@ const notificationsCreateServerCommand = {
8938
8797
  })).status === "fail") process.exitCode = 1;
8939
8798
  }
8940
8799
  };
8941
- //#endregion
8942
- //#region src/commands/notifications-link/notifications-link.args.ts
8800
+ // src/commands/notifications-link/notifications-link.args.ts
8943
8801
  const notificationsLinkArgs = (y) => y.option("provider", {
8944
8802
  type: "string",
8945
8803
  describe: "Which notifications provider, when several can sign members in"
8946
8804
  });
8947
- //#endregion
8948
- //#region src/commands/notifications-link/notifications-link.command.ts
8805
+ // src/commands/notifications-link/notifications-link.command.ts
8949
8806
  const notificationsLinkCommand = {
8950
8807
  command: "link",
8951
8808
  describe: "Link your server account to your GitHub account by signing in with the provider",
@@ -8967,8 +8824,7 @@ const notificationsLinkCommand = {
8967
8824
  })).status === "fail") process.exitCode = 1;
8968
8825
  }
8969
8826
  };
8970
- //#endregion
8971
- //#region src/commands/notifications-setup/notifications-setup.args.ts
8827
+ // src/commands/notifications-setup/notifications-setup.args.ts
8972
8828
  const notificationsSetupArgs = (y) => y.option("scope", {
8973
8829
  type: "string",
8974
8830
  describe: "Webhook secret scope: \"repo\", \"env=<name>\" or \"org=<name>\" (default: the org)"
@@ -8976,8 +8832,7 @@ const notificationsSetupArgs = (y) => y.option("scope", {
8976
8832
  type: "string",
8977
8833
  describe: "Which notifications provider, when several can provision"
8978
8834
  });
8979
- //#endregion
8980
- //#region src/commands/notifications-setup/notifications-setup.command.ts
8835
+ // src/commands/notifications-setup/notifications-setup.command.ts
8981
8836
  const notificationsSetupCommand = {
8982
8837
  command: "setup",
8983
8838
  describe: "Apply the server layout a notifications provider declares in holocron.config.ts",
@@ -9000,8 +8855,7 @@ const notificationsSetupCommand = {
9000
8855
  })).status === "fail") process.exitCode = 1;
9001
8856
  }
9002
8857
  };
9003
- //#endregion
9004
- //#region src/commands/notifications-sync-roles/notifications-sync-roles.args.ts
8858
+ // src/commands/notifications-sync-roles/notifications-sync-roles.args.ts
9005
8859
  const notificationsSyncRolesArgs = (y) => y.option("provider", {
9006
8860
  type: "string",
9007
8861
  describe: "Which notifications provider, when several can manage roles"
@@ -9010,8 +8864,7 @@ const notificationsSyncRolesArgs = (y) => y.option("provider", {
9010
8864
  default: false,
9011
8865
  describe: "Give the role to new team members but do not take it from people who left"
9012
8866
  });
9013
- //#endregion
9014
- //#region src/commands/notifications-sync-roles/notifications-sync-roles.command.ts
8867
+ // src/commands/notifications-sync-roles/notifications-sync-roles.command.ts
9015
8868
  const notificationsSyncRolesCommand = {
9016
8869
  command: "sync-roles",
9017
8870
  describe: "Make who holds a server role match a team, through the links file",
@@ -9034,8 +8887,7 @@ const notificationsSyncRolesCommand = {
9034
8887
  })).status === "fail") process.exitCode = 1;
9035
8888
  }
9036
8889
  };
9037
- //#endregion
9038
- //#region src/commands/notifications-channel-add/notifications-channel-add.args.ts
8890
+ // src/commands/notifications-channel-add/notifications-channel-add.args.ts
9039
8891
  const notificationsChannelAddArgs = (y) => y.positional("name", {
9040
8892
  type: "string",
9041
8893
  describe: "Channel name (e.g. alerts)"
@@ -9062,8 +8914,7 @@ const notificationsChannelAddArgs = (y) => y.positional("name", {
9062
8914
  type: "string",
9063
8915
  describe: "Which notifications provider, when several can provision"
9064
8916
  });
9065
- //#endregion
9066
- //#region src/commands/notifications-channel-add/notifications-channel-add.command.ts
8917
+ // src/commands/notifications-channel-add/notifications-channel-add.command.ts
9067
8918
  const notificationsChannelAddCommand = {
9068
8919
  command: "add [name]",
9069
8920
  describe: "Create a channel, optionally with a webhook whose URL is stored as a secret",
@@ -9093,24 +8944,21 @@ const notificationsChannelAddCommand = {
9093
8944
  })).status === "fail") process.exitCode = 1;
9094
8945
  }
9095
8946
  };
9096
- //#endregion
9097
- //#region src/commands/notifications/notifications-channel.command.ts
8947
+ // src/commands/notifications/notifications-channel.command.ts
9098
8948
  const notificationsChannelCommand = {
9099
8949
  command: "channel",
9100
8950
  describe: "Manage notification channels",
9101
8951
  builder: (y) => y.command(notificationsChannelAddCommand).command(groupMenu("notifications channel")),
9102
8952
  handler: () => {}
9103
8953
  };
9104
- //#endregion
9105
- //#region src/commands/notifications/notifications.command.ts
8954
+ // src/commands/notifications/notifications.command.ts
9106
8955
  const notificationsCommand = {
9107
8956
  command: "notifications",
9108
8957
  describe: "Provision notification channels, webhooks and roles",
9109
8958
  builder: (y) => y.command(notificationsChannelCommand).command(notificationsSetupCommand).command(notificationsCreateServerCommand).command(notificationsLinkCommand).command(notificationsSyncRolesCommand).command(groupMenu("notifications")),
9110
8959
  handler: () => {}
9111
8960
  };
9112
- //#endregion
9113
- //#region src/commands/npm-bump-versions/npm-bump-versions.ts
8961
+ // src/commands/npm-bump-versions/npm-bump-versions.ts
9114
8962
  async function runNpmBumpVersions(input) {
9115
8963
  const print = input.print ?? ((line) => console.log(line));
9116
8964
  const logger = input.logger ?? getLogger();
@@ -9210,8 +9058,7 @@ async function runNpmBumpVersions(input) {
9210
9058
  skipped
9211
9059
  };
9212
9060
  }
9213
- //#endregion
9214
- //#region src/commands/npm-bump-versions/npm-bump-versions.args.ts
9061
+ // src/commands/npm-bump-versions/npm-bump-versions.args.ts
9215
9062
  const npmBumpVersionsArgs = (y) => y.positional("new-version", {
9216
9063
  type: "string",
9217
9064
  describe: "Version to set (e.g., 4.2.0 or 2.0.0-alpha.1)"
@@ -9223,8 +9070,7 @@ const npmBumpVersionsArgs = (y) => y.positional("new-version", {
9223
9070
  array: true,
9224
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."
9225
9072
  });
9226
- //#endregion
9227
- //#region src/commands/npm-bump-versions/npm-bump-versions.command.ts
9073
+ // src/commands/npm-bump-versions/npm-bump-versions.command.ts
9228
9074
  const npmBumpVersionsCommand = {
9229
9075
  command: "bump-versions [new-version]",
9230
9076
  describe: "Bump all non-private package versions in lockstep (semantic-release prepareCmd)",
@@ -9240,8 +9086,7 @@ const npmBumpVersionsCommand = {
9240
9086
  })).status === "fail") process.exitCode = 1;
9241
9087
  }
9242
9088
  };
9243
- //#endregion
9244
- //#region src/commands/publish/resolve-otp.ts
9089
+ // src/commands/publish/resolve-otp.ts
9245
9090
  /**
9246
9091
  * `argvOtp` if given, else the `HOLOCRON_OTP` env var — the secret-delivery
9247
9092
  * side of the interactive menu's options prompt (holocron#1052): a
@@ -9253,8 +9098,7 @@ const npmBumpVersionsCommand = {
9253
9098
  function resolveOtp(argvOtp, env) {
9254
9099
  return argvOtp ?? env.get("HOLOCRON_OTP");
9255
9100
  }
9256
- //#endregion
9257
- //#region src/commands/publish/default-exec.ts
9101
+ // src/commands/publish/default-exec.ts
9258
9102
  const defaultExec$1 = async (cmd, args, opts) => {
9259
9103
  const { HOLOCRON_OTP: _omittedOtp, ...env } = process.env;
9260
9104
  const result = spawnSync(cmd, args, {
@@ -9273,8 +9117,7 @@ const defaultExec$1 = async (cmd, args, opts) => {
9273
9117
  stderr: result.stderr ?? ""
9274
9118
  };
9275
9119
  };
9276
- //#endregion
9277
- //#region src/commands/publish/default-login.ts
9120
+ // src/commands/publish/default-login.ts
9278
9121
  /**
9279
9122
  * Fully interactive — `npm login --auth-type=web` prints a URL and waits for
9280
9123
  * the browser flow to complete; the operator needs to see that live, so all
@@ -9287,8 +9130,7 @@ const defaultLogin = async (cwd) => {
9287
9130
  stdio: "inherit"
9288
9131
  }).status ?? -1 };
9289
9132
  };
9290
- //#endregion
9291
- //#region src/commands/publish/discover-manifests.ts
9133
+ // src/commands/publish/discover-manifests.ts
9292
9134
  /**
9293
9135
  * Monorepo (the workspace declares public packages): every workspace
9294
9136
  * package. Single package (it declares none -- no `pnpm-workspace.yaml`, or one
@@ -9317,8 +9159,7 @@ function discoverManifests(cwd, scope = {}) {
9317
9159
  dir: `./${relativeDir}`
9318
9160
  }));
9319
9161
  }
9320
- //#endregion
9321
- //#region src/commands/publish/discover-public-package-entries.ts
9162
+ // src/commands/publish/discover-public-package-entries.ts
9322
9163
  /**
9323
9164
  * Every public package (`!private && name`) with its version and a
9324
9165
  * `pnpm --filter`-ready path — {@link runSteadyPublish}'s `skipAlreadyPublished`
@@ -9332,8 +9173,7 @@ function discoverPublicPackageEntries(cwd, scope = {}) {
9332
9173
  dir
9333
9174
  }] : []);
9334
9175
  }
9335
- //#endregion
9336
- //#region src/commands/publish/filter-new-packages.ts
9176
+ // src/commands/publish/filter-new-packages.ts
9337
9177
  /**
9338
9178
  * Keeps only the entries that don't exist on npm yet — the actual
9339
9179
  * chicken-and-egg case `--initial` exists for (ADR: npm requires a package
@@ -9379,8 +9219,7 @@ async function filterNewPackages(entries, cwd, exec, print, nameWidth, dirWidth)
9379
9219
  }
9380
9220
  return results;
9381
9221
  }
9382
- //#endregion
9383
- //#region src/commands/publish/print-next-steps.ts
9222
+ // src/commands/publish/print-next-steps.ts
9384
9223
  function printNextSteps(print, env, packageNames, identity) {
9385
9224
  print("");
9386
9225
  print("→ next: configure Trusted Publisher for each package on npm:");
@@ -9398,8 +9237,7 @@ function printNextSteps(print, env, packageNames, identity) {
9398
9237
  print(" https://www.npmjs.com/settings/~/tokens");
9399
9238
  }
9400
9239
  }
9401
- //#endregion
9402
- //#region src/commands/publish/redact-otp.ts
9240
+ // src/commands/publish/redact-otp.ts
9403
9241
  /**
9404
9242
  * Replaces the literal `otp` value in a "would run: pnpm ..." dry-run
9405
9243
  * preview line with `***` — the real `args` passed to `exec()` still need
@@ -9411,8 +9249,7 @@ function redactOtp(args, otp) {
9411
9249
  if (!otp) return [...args];
9412
9250
  return args.map((arg) => arg === otp ? "***" : arg);
9413
9251
  }
9414
- //#endregion
9415
- //#region src/commands/publish/resolve-repo-identity.ts
9252
+ // src/commands/publish/resolve-repo-identity.ts
9416
9253
  /**
9417
9254
  * One git-remote read for both the org and repo shown in the Trusted
9418
9255
  * Publisher next-steps output — `readGitRemote` already parses out `owner`
@@ -9430,8 +9267,7 @@ async function resolveRepoIdentity(cwd, exec) {
9430
9267
  repo: remote?.repo ?? "unknown"
9431
9268
  };
9432
9269
  }
9433
- //#endregion
9434
- //#region src/commands/publish/scope-of.ts
9270
+ // src/commands/publish/scope-of.ts
9435
9271
  /** The {@link WorkspaceScope} a publish input asks for; unset options stay unset. */
9436
9272
  function scopeOf({ group, excludeGroups }) {
9437
9273
  return {
@@ -9439,8 +9275,7 @@ function scopeOf({ group, excludeGroups }) {
9439
9275
  ...excludeGroups === void 0 ? {} : { excludeGroups }
9440
9276
  };
9441
9277
  }
9442
- //#endregion
9443
- //#region src/commands/publish/workspace-filter-args.ts
9278
+ // src/commands/publish/workspace-filter-args.ts
9444
9279
  /**
9445
9280
  * `-r --filter=./clients/* --filter=./observability` -- one filter per
9446
9281
  * workspace glob that holds a package. Empty (single-package repo, no `-r`)
@@ -9453,8 +9288,7 @@ function workspaceFilterArgs(cwd, scope = {}) {
9453
9288
  const globs = resolveWorkspaceGlobs(cwd).include.filter((glob) => found.some(({ relativeDir }) => glob.endsWith("/*") ? relativeDir.startsWith(glob.slice(0, -1)) : relativeDir === glob));
9454
9289
  return globs.length > 0 ? ["-r", ...globs.map((glob) => `--filter=./${glob}`)] : [];
9455
9290
  }
9456
- //#endregion
9457
- //#region src/commands/publish/run-publish/run-publish.ts
9291
+ // src/commands/publish/run-publish/run-publish.ts
9458
9292
  /**
9459
9293
  * `holocron package publish --initial` — bottles up the chicken-and-egg bootstrap
9460
9294
  * that every new npm-published holocron monorepo hits.
@@ -9659,8 +9493,7 @@ async function runPublish(input = {}) {
9659
9493
  packageNames
9660
9494
  };
9661
9495
  }
9662
- //#endregion
9663
- //#region src/commands/publish/run-steady-publish/run-steady-publish.ts
9496
+ // src/commands/publish/run-steady-publish/run-steady-publish.ts
9664
9497
  /**
9665
9498
  * `holocron package publish` (no `--initial`) — the steady-state publish
9666
9499
  * `exec.publishCmd` in `release.config.ts` should call, replacing each
@@ -9836,19 +9669,16 @@ async function runSteadyPublish(input = {}) {
9836
9669
  packageNames
9837
9670
  };
9838
9671
  }
9839
- //#endregion
9840
- //#region src/commands/publish/discover-public-packages.ts
9672
+ // src/commands/publish/discover-public-packages.ts
9841
9673
  /** The names of `discoverPublicPackageEntries`' packages, without requiring a version. */
9842
9674
  function discoverPublicPackages(cwd, scope = {}) {
9843
9675
  return discoverManifests(cwd, scope).flatMap(({ manifest }) => !manifest.private && manifest.name ? [manifest.name] : []);
9844
9676
  }
9845
- //#endregion
9846
- //#region src/commands/publish/is-eotp.ts
9677
+ // src/commands/publish/is-eotp.ts
9847
9678
  function isEotp(parsed) {
9848
9679
  return typeof parsed === "object" && parsed !== null && "error" in parsed && parsed.error?.code === "EOTP";
9849
9680
  }
9850
- //#endregion
9851
- //#region src/commands/publish/parse-json.ts
9681
+ // src/commands/publish/parse-json.ts
9852
9682
  function parseJson(raw) {
9853
9683
  try {
9854
9684
  return JSON.parse(raw);
@@ -9856,8 +9686,7 @@ function parseJson(raw) {
9856
9686
  return;
9857
9687
  }
9858
9688
  }
9859
- //#endregion
9860
- //#region src/commands/publish/run-sync-trust/run-sync-trust.ts
9689
+ // src/commands/publish/run-sync-trust/run-sync-trust.ts
9861
9690
  /**
9862
9691
  * `holocron package publish --sync-trust <old-file> <new-file>` — bulk-migrates npm
9863
9692
  * Trusted Publisher (OIDC) config to a new workflow filename across every
@@ -9878,6 +9707,11 @@ function parseJson(raw) {
9878
9707
  * it stops immediately, prints the `authUrl`, and returns — the operator
9879
9708
  * approves it and re-runs; already-migrated packages are skipped on the next
9880
9709
  * pass, so it's safe to resume from wherever it stopped.
9710
+ *
9711
+ * A package is skipped only when BOTH its bound file and its bound repository (compared
9712
+ * case-insensitively) already match: a package folded in from another repo keeps its
9713
+ * filename but is still bound to the old repo (#1221). `--dry-run` does the same read-only
9714
+ * `trust list` per package and reports what the real run would do, without revoking or creating.
9881
9715
  */
9882
9716
  async function runSyncTrust(input) {
9883
9717
  const print = input.print ?? ((line) => console.log(line));
@@ -9907,54 +9741,68 @@ async function runSyncTrust(input) {
9907
9741
  packages: []
9908
9742
  };
9909
9743
  }
9910
- if (dryRun) {
9911
- for (const name of packageNames) print(` … would sync ${name}`);
9744
+ const results = [];
9745
+ const needsAuth = (name, authUrl) => {
9746
+ print(` needs fresh 2FA — open and approve: ${authUrl}`);
9747
+ print(" then re-run; already-migrated packages are skipped.");
9748
+ results.push({
9749
+ name,
9750
+ status: "needs-auth",
9751
+ message: authUrl
9752
+ });
9753
+ logger.warn({
9754
+ package: name,
9755
+ authUrl
9756
+ }, "sync-trust: needs auth, stopping");
9912
9757
  return {
9913
- status: "dry-run",
9914
- message: "dry-run — no npm calls made",
9915
- packages: []
9758
+ status: "fail",
9759
+ message: "npm 2FA grant needed — see printed authUrl",
9760
+ packages: results
9916
9761
  };
9917
- }
9918
- const results = [];
9762
+ };
9919
9763
  for (const name of packageNames) {
9920
9764
  print(`=== ${name} ===`);
9921
- const parsed = parseJson((await exec(npm, [
9765
+ const listResult = await exec(npm, [
9922
9766
  ...npmArgs,
9923
9767
  "trust",
9924
9768
  "list",
9925
9769
  name,
9926
9770
  "--json"
9927
- ], { cwd })).stdout);
9928
- if (isEotp(parsed)) {
9929
- const authUrl = parsed.error?.authUrl ?? "";
9930
- print(` needs fresh 2FA — open and approve: ${authUrl}`);
9931
- print(" then re-run; already-migrated packages are skipped.");
9771
+ ], { cwd });
9772
+ const parsed = parseJson(listResult.stdout);
9773
+ if (isEotp(parsed)) return needsAuth(name, parsed.error?.authUrl ?? "");
9774
+ if (listResult.exitCode !== 0) {
9775
+ const message = listResult.stderr.trim() || listResult.stdout.trim() || `exit ${listResult.exitCode}`;
9776
+ print(` ✗ FAILED to read trust config: ${message}`);
9932
9777
  results.push({
9933
9778
  name,
9934
- status: "needs-auth",
9935
- message: authUrl
9936
- });
9937
- logger.warn({
9938
- package: name,
9939
- authUrl
9940
- }, "sync-trust: needs auth, stopping");
9941
- return {
9942
9779
  status: "fail",
9943
- message: "npm 2FA grant needed — see printed authUrl",
9944
- packages: results
9945
- };
9780
+ message
9781
+ });
9782
+ continue;
9946
9783
  }
9947
- const entry = parsed;
9948
- if (entry.file === input.newFile) {
9949
- print(` already on ${input.newFile}, skipping`);
9784
+ const entry = parsed ?? {};
9785
+ const sameFile = entry.file === input.newFile;
9786
+ const sameRepo = entry.repository?.toLowerCase() === repo.toLowerCase();
9787
+ if (sameFile && sameRepo) {
9788
+ print(` already on ${repo} / ${input.newFile}, skipping`);
9950
9789
  results.push({
9951
9790
  name,
9952
- status: "skipped"
9791
+ status: dryRun ? "would-skip" : "skipped"
9792
+ });
9793
+ continue;
9794
+ }
9795
+ const from = `repo=${entry.repository ?? "?"}, file=${entry.file ?? "?"}`;
9796
+ if (dryRun) {
9797
+ print(entry.id ? ` would revoke (${from}, id=${entry.id}) and create ${repo} / ${input.newFile}` : ` would create ${repo} / ${input.newFile} (no existing trust config)`);
9798
+ results.push({
9799
+ name,
9800
+ status: "would-sync"
9953
9801
  });
9954
9802
  continue;
9955
9803
  }
9956
9804
  if (entry.id) {
9957
- print(` revoking existing trust (file=${entry.file ?? "?"}, id=${entry.id})`);
9805
+ print(` revoking existing trust (${from}, id=${entry.id})`);
9958
9806
  const revoke = await exec(npm, [
9959
9807
  ...npmArgs,
9960
9808
  "trust",
@@ -9964,20 +9812,7 @@ async function runSyncTrust(input) {
9964
9812
  entry.id,
9965
9813
  "-y"
9966
9814
  ], { cwd });
9967
- if (revoke.exitCode !== 0 && isEotp(parseJson(revoke.stdout))) {
9968
- const authUrl = parseJson(revoke.stdout).error?.authUrl ?? "";
9969
- print(` needs fresh 2FA — open and approve: ${authUrl}`);
9970
- results.push({
9971
- name,
9972
- status: "needs-auth",
9973
- message: authUrl
9974
- });
9975
- return {
9976
- status: "fail",
9977
- message: "npm 2FA grant needed — see printed authUrl",
9978
- packages: results
9979
- };
9980
- }
9815
+ if (revoke.exitCode !== 0 && isEotp(parseJson(revoke.stdout))) return needsAuth(name, parseJson(revoke.stdout).error?.authUrl ?? "");
9981
9816
  } else print(" no existing trust config found");
9982
9817
  print(` creating trust: ${input.newFile}`);
9983
9818
  const create = await exec(npm, [
@@ -10001,20 +9836,7 @@ async function runSyncTrust(input) {
10001
9836
  });
10002
9837
  } else {
10003
9838
  const createParsed = parseJson(create.stdout);
10004
- if (isEotp(createParsed)) {
10005
- const authUrl = createParsed.error?.authUrl ?? "";
10006
- print(` needs fresh 2FA — open and approve: ${authUrl}`);
10007
- results.push({
10008
- name,
10009
- status: "needs-auth",
10010
- message: authUrl
10011
- });
10012
- return {
10013
- status: "fail",
10014
- message: "npm 2FA grant needed — see printed authUrl",
10015
- packages: results
10016
- };
10017
- }
9839
+ if (isEotp(createParsed)) return needsAuth(name, createParsed.error?.authUrl ?? "");
10018
9840
  const message = create.stderr.trim() || create.stdout.trim() || `exit ${create.exitCode}`;
10019
9841
  print(` ✗ FAILED: ${message}`);
10020
9842
  results.push({
@@ -10030,13 +9852,12 @@ async function runSyncTrust(input) {
10030
9852
  failed: failed.length
10031
9853
  }, "sync-trust: done");
10032
9854
  return {
10033
- status: failed.length > 0 ? "fail" : "ok",
9855
+ status: failed.length > 0 ? "fail" : dryRun ? "dry-run" : "ok",
10034
9856
  ...failed.length > 0 ? { message: `${failed.length} package(s) failed` } : {},
10035
9857
  packages: results
10036
9858
  };
10037
9859
  }
10038
- //#endregion
10039
- //#region src/commands/publish/publish.args.ts
9860
+ // src/commands/publish/publish.args.ts
10040
9861
  const publishArgs = (y) => y.option("initial", {
10041
9862
  type: "boolean",
10042
9863
  default: false,
@@ -10069,8 +9890,7 @@ const publishArgs = (y) => y.option("initial", {
10069
9890
  default: false,
10070
9891
  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."
10071
9892
  });
10072
- //#endregion
10073
- //#region src/commands/publish/publish.command.ts
9893
+ // src/commands/publish/publish.command.ts
10074
9894
  const publishCommand = {
10075
9895
  command: "publish",
10076
9896
  describe: "Publish @theholocron/* packages to npm",
@@ -10120,16 +9940,14 @@ const publishCommand = {
10120
9940
  })).status === "fail") process.exitCode = 1;
10121
9941
  }
10122
9942
  };
10123
- //#endregion
10124
- //#region src/commands/package/package.command.ts
9943
+ // src/commands/package/package.command.ts
10125
9944
  const packageCommand = {
10126
9945
  command: "package",
10127
9946
  describe: "Version and publish workspace packages",
10128
9947
  builder: (y) => y.command(npmBumpVersionsCommand).command(publishCommand).command(groupMenu("package")),
10129
9948
  handler: () => {}
10130
9949
  };
10131
- //#endregion
10132
- //#region src/commands/probe/probe.args.ts
9950
+ // src/commands/probe/probe.args.ts
10133
9951
  const probeArgs = (y) => y.positional("provider", {
10134
9952
  type: "string",
10135
9953
  describe: "Which provider's probes (omit to list them all)"
@@ -10141,8 +9959,7 @@ const probeArgs = (y) => y.positional("provider", {
10141
9959
  default: false,
10142
9960
  describe: "Run a probe that changes things without asking first (required without a terminal)"
10143
9961
  });
10144
- //#endregion
10145
- //#region src/commands/probe/app-vault.ts
9962
+ // src/commands/probe/app-vault.ts
10146
9963
  /**
10147
9964
  * The vault of an app that carries its own `holocron.config` (`apps/comlink`, `apps/sentinel`): those configs govern where
10148
9965
  * the app's secrets live, apart from the root's. `undefined` when the app has no config of its own (the search for one
@@ -10164,8 +9981,7 @@ async function loadAppVault(appDir, context, importer) {
10164
9981
  await loader.load();
10165
9982
  return loader.has("vault") ? loader.get("vault") : void 0;
10166
9983
  }
10167
- //#endregion
10168
- //#region src/commands/probe/comlink-probes.ts
9984
+ // src/commands/probe/comlink-probes.ts
10169
9985
  /** 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. */
10170
9986
  const COMLINK_PROVIDER = "comlink";
10171
9987
  /** Where the relay answers and what it is called, from the notifications layout and the `errors` provider. */
@@ -10306,8 +10122,7 @@ function comlinkProbes(deps) {
10306
10122
  }
10307
10123
  };
10308
10124
  }
10309
- //#endregion
10310
- //#region src/commands/probe/core-probes.ts
10125
+ // src/commands/probe/core-probes.ts
10311
10126
  /** The group of probes that belong to the CLI itself, not to a provider. */
10312
10127
  const CORE_PROVIDER = "core";
10313
10128
  /**
@@ -10367,8 +10182,7 @@ function coreProbes(loader, builtIn = /* @__PURE__ */ new Map()) {
10367
10182
  }
10368
10183
  } };
10369
10184
  }
10370
- //#endregion
10371
- //#region src/commands/probe/list-probes.ts
10185
+ // src/commands/probe/list-probes.ts
10372
10186
  /** The listing `holocron probe` prints: each provider, and under it each probe with its summary; writers are marked. */
10373
10187
  function listProbes(groups) {
10374
10188
  const lines = [];
@@ -10383,8 +10197,7 @@ function listProbes(groups) {
10383
10197
  }
10384
10198
  return lines;
10385
10199
  }
10386
- //#endregion
10387
- //#region src/ui/command-failure/command-failure.ts
10200
+ // src/ui/command-failure/command-failure.ts
10388
10201
  /**
10389
10202
  * Error class names whose `.message` is a complete, actionable sentence. Any other error is printed too, so a command
10390
10203
  * that throws a plain `Error` is never silent; this set only marks the ones written to be read as they are.
@@ -10402,8 +10215,7 @@ const USER_FACING_ERRORS = /* @__PURE__ */ new Set([
10402
10215
  function commandFailureMessage(err) {
10403
10216
  return describeProviderError(err) || (err instanceof Error ? err.name : "the command failed");
10404
10217
  }
10405
- //#endregion
10406
- //#region src/commands/probe/scrub.ts
10218
+ // src/commands/probe/scrub.ts
10407
10219
  const HIDDEN = "«hidden»";
10408
10220
  /** Shapes that are credentials wherever they appear: a Discord webhook URL, a bearer header, a Sentry token. */
10409
10221
  const SHAPES = [
@@ -10426,8 +10238,7 @@ function createScrubber(secrets) {
10426
10238
  return out;
10427
10239
  };
10428
10240
  }
10429
- //#endregion
10430
- //#region src/commands/probe/run-probe.ts
10241
+ // src/commands/probe/run-probe.ts
10431
10242
  const defaultInterrupt = (handler) => {
10432
10243
  const listener = () => void handler().finally(() => process.exit(130));
10433
10244
  process.once("SIGINT", listener);
@@ -10537,8 +10348,7 @@ async function runProbe(input) {
10537
10348
  rows
10538
10349
  };
10539
10350
  }
10540
- //#endregion
10541
- //#region src/commands/probe/probe.ts
10351
+ // src/commands/probe/probe.ts
10542
10352
  /**
10543
10353
  * `holocron probe [<provider> [<probe>]]`. With nothing, lists what can be probed; with a provider, lists its probes;
10544
10354
  * with both, runs one. Probes come from the configured plugins, plus the CLI's own `core` group.
@@ -10589,8 +10399,7 @@ async function runProbeCommand(input) {
10589
10399
  ...input.onInterrupt ? { onInterrupt: input.onInterrupt } : {}
10590
10400
  })).status };
10591
10401
  }
10592
- //#endregion
10593
- //#region src/commands/probe/probe.command.ts
10402
+ // src/commands/probe/probe.command.ts
10594
10403
  const probeCommand = {
10595
10404
  command: "probe [provider] [probe]",
10596
10405
  describe: "Poke a live provider on purpose: inspect it, or run a proof that cleans up after itself",
@@ -10616,8 +10425,7 @@ const probeCommand = {
10616
10425
  })).status === "fail") process.exitCode = 1;
10617
10426
  }
10618
10427
  };
10619
- //#endregion
10620
- //#region src/commands/setup/derived-properties/derived-properties.ts
10428
+ // src/commands/setup/derived-properties/derived-properties.ts
10621
10429
  /**
10622
10430
  * Repo archetype, in priority order:
10623
10431
  * 1. `*-template` repo name → `template` (independent of package shape).
@@ -10714,8 +10522,7 @@ async function readWorkspacePackageJsons(repoRoot, workspacePackages) {
10714
10522
  }
10715
10523
  return results;
10716
10524
  }
10717
- //#endregion
10718
- //#region src/commands/setup/labels.ts
10525
+ // src/commands/setup/labels.ts
10719
10526
  const CANONICAL_LABELS = [
10720
10527
  {
10721
10528
  name: "bug",
@@ -10810,11 +10617,9 @@ const STALE_LABELS = [
10810
10617
  "autorelease: tagged",
10811
10618
  "released on @alpha"
10812
10619
  ];
10813
- //#endregion
10814
- //#region src/templates/dco.yml
10620
+ // src/templates/dco.yml
10815
10621
  var dco_default = "allowRemediationCommits:\n individual: true\n";
10816
- //#endregion
10817
- //#region src/commands/preview-deploy-paths/preview-deploy-paths.ts
10622
+ // src/commands/preview-deploy-paths/preview-deploy-paths.ts
10818
10623
  /** `realpathSync`, falling back to the unresolved input on a path that doesn't exist (e.g. a test fixture). */
10819
10624
  function tryRealpath(path) {
10820
10625
  try {
@@ -10869,8 +10674,7 @@ function withAutoPreviewDeployPaths(tasks, gitRoot) {
10869
10674
  };
10870
10675
  });
10871
10676
  }
10872
- //#endregion
10873
- //#region src/commands/workflow-source-marker/workflow-source-marker.ts
10677
+ // src/commands/workflow-source-marker/workflow-source-marker.ts
10874
10678
  /** `# Source package: <path>` line at the head of a generated thin-caller workflow — see {@link resolvePkgRelPath}. */
10875
10679
  const SOURCE_PACKAGE_MARKER = /^# Source package: (.+)$/m;
10876
10680
  /** Strip control characters (including ANSI escapes) before a value reaches a printed error message. */
@@ -10942,8 +10746,7 @@ async function assertNoPackageCollision(taskName, pkgRelPath, filename, readExis
10942
10746
  const previousPkg = SOURCE_PACKAGE_MARKER.exec(existing)?.[1];
10943
10747
  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.`);
10944
10748
  }
10945
- //#endregion
10946
- //#region src/commands/setup/agent-prompts-data.ts
10749
+ // src/commands/setup/agent-prompts-data.ts
10947
10750
  /**
10948
10751
  * Canonical AI engineering workflow role prompts.
10949
10752
  *
@@ -11336,8 +11139,7 @@ the system must do — not how to implement it.
11336
11139
 
11337
11140
  > **Drafts** live in \`.notes/*.spec.md\` until accepted, then graduate here.
11338
11141
  `;
11339
- //#endregion
11340
- //#region src/commands/setup/agent-prompts.ts
11142
+ // src/commands/setup/agent-prompts.ts
11341
11143
  const AGENTS_PROMPTS_ROOT = ".agents/prompts";
11342
11144
  const PROMPTS_GITIGNORE_START = "# managed by holocron setup — prompts";
11343
11145
  const PROMPTS_GITIGNORE_END = "# end managed by holocron setup — prompts";
@@ -11352,8 +11154,7 @@ async function installAgentPrompts({ repoRoot }) {
11352
11154
  });
11353
11155
  return `wrote ${Object.keys(AGENT_PROMPTS).length} prompt files to ${AGENTS_PROMPTS_ROOT}/`;
11354
11156
  }
11355
- //#endregion
11356
- //#region src/commands/setup/branch-protection.ts
11157
+ // src/commands/setup/branch-protection.ts
11357
11158
  const RULESET_NAME = "holocron-default-branch";
11358
11159
  function buildClassicProtectionPayload(requiredChecks = []) {
11359
11160
  return {
@@ -11468,8 +11269,7 @@ async function upsertBranchProtection(source, dryRun, requiredChecks) {
11468
11269
  };
11469
11270
  }
11470
11271
  }
11471
- //#endregion
11472
- //#region src/commands/setup/engineering.ts
11272
+ // src/commands/setup/engineering.ts
11473
11273
  async function writeIfAbsent(filePath, content) {
11474
11274
  try {
11475
11275
  await access(filePath);
@@ -11490,8 +11290,7 @@ async function installEngineeringStructure({ repoRoot }) {
11490
11290
  for (const [path, content] of writes) if (await writeIfAbsent(path, content)) results.push(path.replace(repoRoot + "/", ""));
11491
11291
  return results.length > 0 ? `created: ${results.join(", ")}` : "all files already exist — nothing to write";
11492
11292
  }
11493
- //#endregion
11494
- //#region src/commands/setup/repo-settings.ts
11293
+ // src/commands/setup/repo-settings.ts
11495
11294
  const BALANCED_REPO_SETTINGS = {
11496
11295
  allow_squash_merge: true,
11497
11296
  allow_merge_commit: false,
@@ -11504,8 +11303,7 @@ const BALANCED_REPO_SETTINGS = {
11504
11303
  has_projects: true,
11505
11304
  has_wiki: false
11506
11305
  };
11507
- //#endregion
11508
- //#region src/commands/setup/run-step/run-step.ts
11306
+ // src/commands/setup/run-step/run-step.ts
11509
11307
  async function runStep(capability, step, dryRun, body, opts = {}) {
11510
11308
  const result = await execStep(capability, step, dryRun, body, opts);
11511
11309
  const { status, message, reason } = result;
@@ -11575,8 +11373,7 @@ function formatStep(step) {
11575
11373
  if (step.status === "dry-run") return ` ${style.dim(`… ${label}`)}`;
11576
11374
  return ` ${style.dim(`· ${label}`)}`;
11577
11375
  }
11578
- //#endregion
11579
- //#region src/commands/setup/skills/skills.ts
11376
+ // src/commands/setup/skills/skills.ts
11580
11377
  async function fetchExternalSkill(entry) {
11581
11378
  if (entry.sourceType !== "github")
11582
11379
  /* c8 ignore next */
@@ -11747,8 +11544,7 @@ async function updateSkillsGitignore(gitignorePath, skills, symlinkFn) {
11747
11544
  lines: [`/${AGENTS_SKILLS_ROOT}/`, ...skills.map((n) => `/${symlinkFn(n)}`)]
11748
11545
  });
11749
11546
  }
11750
- //#endregion
11751
- //#region src/commands/setup/run-setup.ts
11547
+ // src/commands/setup/run-setup.ts
11752
11548
  /**
11753
11549
  * `holocron repo setup` — orchestrates per-capability setup actions across
11754
11550
  * every plugin loaded from `holocron.config.json`.
@@ -12524,8 +12320,7 @@ async function ensurePrepareScript(repoRoot) {
12524
12320
  await writeFile(pkgPath, stringifyJson(pkg, { like: content }), "utf8");
12525
12321
  return true;
12526
12322
  }
12527
- //#endregion
12528
- //#region src/commands/setup/setup.args.ts
12323
+ // src/commands/setup/setup.args.ts
12529
12324
  const setupArgs = (y) => y.option("repo", {
12530
12325
  type: "string",
12531
12326
  describe: "Repo coords (\"owner/name\"). Defaults to plugin-specific resolution."
@@ -12533,8 +12328,7 @@ const setupArgs = (y) => y.option("repo", {
12533
12328
  type: "boolean",
12534
12329
  describe: "Install git hooks (.husky/pre-push → holocron run ci). Default: on for protection:'strict'. --no-hooks to skip."
12535
12330
  });
12536
- //#endregion
12537
- //#region src/commands/setup/setup.command.ts
12331
+ // src/commands/setup/setup.command.ts
12538
12332
  const setupCommand = {
12539
12333
  command: "setup",
12540
12334
  describe: "Apply infra setup actions across every configured capability",
@@ -12557,8 +12351,7 @@ const setupCommand = {
12557
12351
  })).summary.fail > 0) process.exitCode = 1;
12558
12352
  }
12559
12353
  };
12560
- //#endregion
12561
- //#region src/commands/sync-readme/sync-readme.ts
12354
+ // src/commands/sync-readme/sync-readme.ts
12562
12355
  const MARKER_INSTALL_START = "<!-- holocron:installation -->";
12563
12356
  const MARKER_INSTALL_END = "<!-- /holocron:installation -->";
12564
12357
  const REGISTRY_MAP = {
@@ -12713,8 +12506,7 @@ async function runSyncReadme(input) {
12713
12506
  updated
12714
12507
  };
12715
12508
  }
12716
- //#endregion
12717
- //#region src/commands/sync-wiki/sync-wiki.ts
12509
+ // src/commands/sync-wiki/sync-wiki.ts
12718
12510
  function resolveToken(input) {
12719
12511
  return input.token ?? input.context.cliToken ?? firstEnv(env, [
12720
12512
  "HOLOCRON_READ_TOKEN",
@@ -12930,8 +12722,7 @@ async function runSyncWiki(input) {
12930
12722
  };
12931
12723
  }
12932
12724
  }
12933
- //#endregion
12934
- //#region src/commands/sync/sync.ts
12725
+ // src/commands/sync/sync.ts
12935
12726
  const { workflowHeader } = createHeader({
12936
12727
  source: "cli/astromech/src/thin-callers.ts",
12937
12728
  tool: "holocron repo sync"
@@ -13530,15 +13321,13 @@ async function readExistingWorkflowFile(repoRoot, filename) {
13530
13321
  throw err;
13531
13322
  }
13532
13323
  }
13533
- //#endregion
13534
- //#region src/commands/sync-readme/sync-readme.args.ts
13324
+ // src/commands/sync-readme/sync-readme.args.ts
13535
13325
  const syncReadmeArgs = (y) => y.option("dry-run", {
13536
13326
  type: "boolean",
13537
13327
  describe: "Print what would change without writing",
13538
13328
  default: false
13539
13329
  });
13540
- //#endregion
13541
- //#region src/commands/sync-readme/sync-readme.command.ts
13330
+ // src/commands/sync-readme/sync-readme.command.ts
13542
13331
  const syncReadmeCommand = {
13543
13332
  command: "readme",
13544
13333
  describe: "Sync the Installation + Usage block in README.md from package.json",
@@ -13559,8 +13348,7 @@ const syncReadmeCommand = {
13559
13348
  }
13560
13349
  }
13561
13350
  };
13562
- //#endregion
13563
- //#region src/commands/repo/repo-sync.args.ts
13351
+ // src/commands/repo/repo-sync.args.ts
13564
13352
  const repoSyncArgs = (y) => y.positional("steps", {
13565
13353
  type: "string",
13566
13354
  array: true,
@@ -13569,8 +13357,7 @@ const repoSyncArgs = (y) => y.positional("steps", {
13569
13357
  type: "string",
13570
13358
  describe: "Repo coords (\"owner/name\"). Defaults to plugin-specific resolution."
13571
13359
  });
13572
- //#endregion
13573
- //#region src/commands/repo/repo-sync.command.ts
13360
+ // src/commands/repo/repo-sync.command.ts
13574
13361
  const repoSyncCommand = {
13575
13362
  command: "sync [steps..]",
13576
13363
  describe: "Sync state from config to the provider and local files (labels, properties, teams, topics, keywords, description, homepage, readme, workflows, scripts, wiki)",
@@ -13593,8 +13380,7 @@ const repoSyncCommand = {
13593
13380
  })).summary.fail > 0) process.exitCode = 1;
13594
13381
  }
13595
13382
  };
13596
- //#endregion
13597
- //#region src/commands/upgrade-deps/upgrade-deps.ts
13383
+ // src/commands/upgrade-deps/upgrade-deps.ts
13598
13384
  /**
13599
13385
  * `holocron repo upgrade deps` — bring a repo's `@theholocron/*` dependency pins and
13600
13386
  * its `holocron.config.ts` up to the current major.
@@ -13821,15 +13607,13 @@ async function runUpgradeDeps(input = {}) {
13821
13607
  configWarnings
13822
13608
  };
13823
13609
  }
13824
- //#endregion
13825
- //#region src/commands/upgrade-deps/upgrade-deps.args.ts
13610
+ // src/commands/upgrade-deps/upgrade-deps.args.ts
13826
13611
  const upgradeDepsArgs = (yy) => yy.option("pins-only", {
13827
13612
  type: "boolean",
13828
13613
  default: false,
13829
13614
  describe: "Only bump the catalog pins — skip the holocron.config.ts migration"
13830
13615
  });
13831
- //#endregion
13832
- //#region src/commands/upgrade-deps/upgrade-deps.command.ts
13616
+ // src/commands/upgrade-deps/upgrade-deps.command.ts
13833
13617
  const upgradeDepsCommand = {
13834
13618
  command: "deps",
13835
13619
  describe: "Bump every @theholocron/* pin to latest and migrate holocron.config.ts to the current preset API",
@@ -13846,8 +13630,7 @@ const upgradeDepsCommand = {
13846
13630
  }
13847
13631
  }
13848
13632
  };
13849
- //#endregion
13850
- //#region src/commands/upgrade-node/upgrade-node.ts
13633
+ // src/commands/upgrade-node/upgrade-node.ts
13851
13634
  const SKIP_DIRS = [
13852
13635
  "node_modules",
13853
13636
  ".git",
@@ -14031,8 +13814,7 @@ async function runUpgradeNode(input) {
14031
13814
  updated
14032
13815
  };
14033
13816
  }
14034
- //#endregion
14035
- //#region src/commands/upgrade-node/upgrade-node.args.ts
13817
+ // src/commands/upgrade-node/upgrade-node.args.ts
14036
13818
  const upgradeNodeArgs = (yy) => yy.positional("to", {
14037
13819
  type: "number",
14038
13820
  describe: "Target Node.js major version (e.g., 22)"
@@ -14040,8 +13822,7 @@ const upgradeNodeArgs = (yy) => yy.positional("to", {
14040
13822
  type: "number",
14041
13823
  describe: "Current major version to replace. Auto-detected from .nvmrc / engines.node when omitted."
14042
13824
  });
14043
- //#endregion
14044
- //#region src/commands/upgrade-node/upgrade-node.command.ts
13825
+ // src/commands/upgrade-node/upgrade-node.command.ts
14045
13826
  const upgradeNodeCommand = {
14046
13827
  command: "node [to]",
14047
13828
  describe: "Scan the repo and update every Node.js version pin to a new major",
@@ -14067,24 +13848,21 @@ const upgradeNodeCommand = {
14067
13848
  }
14068
13849
  }
14069
13850
  };
14070
- //#endregion
14071
- //#region src/commands/repo/repo-upgrade.command.ts
13851
+ // src/commands/repo/repo-upgrade.command.ts
14072
13852
  const repoUpgradeCommand = {
14073
13853
  command: "upgrade",
14074
13854
  describe: "Upgrade toolchain version pins across the repo",
14075
13855
  builder: (y) => y.command(upgradeNodeCommand).command(upgradeDepsCommand).command(groupMenu("repo upgrade")),
14076
13856
  handler: () => {}
14077
13857
  };
14078
- //#endregion
14079
- //#region src/commands/repo/repo.command.ts
13858
+ // src/commands/repo/repo.command.ts
14080
13859
  const repoCommand = {
14081
13860
  command: "repo",
14082
13861
  describe: "Set up, sync and upgrade the current repo",
14083
13862
  builder: (y) => y.command(setupCommand).command(repoSyncCommand).command(repoUpgradeCommand).command(groupMenu("repo")),
14084
13863
  handler: () => {}
14085
13864
  };
14086
- //#endregion
14087
- //#region src/commands/run/run.args.ts
13865
+ // src/commands/run/run.args.ts
14088
13866
  const runArgs = (y) => y.positional("task", {
14089
13867
  type: "string",
14090
13868
  demandOption: true,
@@ -14108,8 +13886,7 @@ const runArgs = (y) => y.positional("task", {
14108
13886
  type: "string",
14109
13887
  describe: "turbo --filter=<pkg> passthrough (monorepo)."
14110
13888
  });
14111
- //#endregion
14112
- //#region src/commands/run/run.command.ts
13889
+ // src/commands/run/run.command.ts
14113
13890
  const runCommand = {
14114
13891
  command: "run <task> [job] [passthrough..]",
14115
13892
  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.",
@@ -14159,8 +13936,7 @@ const runCommand = {
14159
13936
  if (report.status === "fail" || report.status === "unknown") process.exitCode = 1;
14160
13937
  }
14161
13938
  };
14162
- //#endregion
14163
- //#region src/commands/secret-set/secret-set.ts
13939
+ // src/commands/secret-set/secret-set.ts
14164
13940
  /**
14165
13941
  * `holocron secrets set` — one-shot single-secret push.
14166
13942
  *
@@ -14251,8 +14027,7 @@ function describeScope(scope) {
14251
14027
  if (scope.kind === "environment") return `scope=environment:${scope.name}`;
14252
14028
  return `scope=organization:${scope.name}`;
14253
14029
  }
14254
- //#endregion
14255
- //#region src/commands/secret-set/secret-set.args.ts
14030
+ // src/commands/secret-set/secret-set.args.ts
14256
14031
  const secretSetArgs = (y) => y.positional("name", {
14257
14032
  type: "string",
14258
14033
  describe: "Secret name (e.g., NPM_TOKEN)"
@@ -14271,8 +14046,7 @@ const secretSetArgs = (y) => y.positional("name", {
14271
14046
  default: "repo",
14272
14047
  describe: "Scope: \"repo\" (default), \"env=<name>\", or \"org=<name>\""
14273
14048
  });
14274
- //#endregion
14275
- //#region src/commands/secret-set/secret-set.command.ts
14049
+ // src/commands/secret-set/secret-set.command.ts
14276
14050
  const secretSetCommand = {
14277
14051
  command: "set [name] [value]",
14278
14052
  describe: "Set a single secret via the configured `secrets` capability",
@@ -14301,8 +14075,7 @@ const secretSetCommand = {
14301
14075
  })).status === "fail") process.exitCode = 1;
14302
14076
  }
14303
14077
  };
14304
- //#endregion
14305
- //#region src/commands/secrets-sync/secrets-sync.ts
14078
+ // src/commands/secrets-sync/secrets-sync.ts
14306
14079
  /**
14307
14080
  * `holocron secrets sync` — vault → destinations.
14308
14081
  *
@@ -14514,8 +14287,7 @@ function vaultProviderName(loader) {
14514
14287
  if (!loader.has("vault")) return "<missing>";
14515
14288
  return loader.get("vault").providerName;
14516
14289
  }
14517
- //#endregion
14518
- //#region src/commands/secrets-sync/secrets-sync.args.ts
14290
+ // src/commands/secrets-sync/secrets-sync.args.ts
14519
14291
  const secretsSyncArgs = (y) => y.positional("environmentId", {
14520
14292
  type: "string",
14521
14293
  describe: "Vault environment id to read (1P Environment id, etc.)"
@@ -14537,8 +14309,7 @@ const secretsSyncArgs = (y) => y.positional("environmentId", {
14537
14309
  default: "repo",
14538
14310
  describe: "Scope applied to every --github-secret key: \"repo\" (default), \"env=<name>\", or \"org=<name>\"."
14539
14311
  });
14540
- //#endregion
14541
- //#region src/commands/secrets-sync/secrets-sync.command.ts
14312
+ // src/commands/secrets-sync/secrets-sync.command.ts
14542
14313
  const secretsSyncCommand = {
14543
14314
  command: "sync [environmentId]",
14544
14315
  describe: "Read a vault environment + fan KEY=VALUEs out to secrets + deployment env vars",
@@ -14567,16 +14338,14 @@ const secretsSyncCommand = {
14567
14338
  })).summary.fail > 0) process.exitCode = 1;
14568
14339
  }
14569
14340
  };
14570
- //#endregion
14571
- //#region src/commands/secrets/secrets.command.ts
14341
+ // src/commands/secrets/secrets.command.ts
14572
14342
  const secretsCommand = {
14573
14343
  command: "secrets",
14574
14344
  describe: "Set secrets and sync vault environments",
14575
14345
  builder: (y) => y.command(secretSetCommand).command(secretsSyncCommand).command(groupMenu("secrets")),
14576
14346
  handler: () => {}
14577
14347
  };
14578
- //#endregion
14579
- //#region src/commands/skills/skills.args.ts
14348
+ // src/commands/skills/skills.args.ts
14580
14349
  const skillsRemoveArgs = (y) => y.positional("names", {
14581
14350
  type: "string",
14582
14351
  array: true,
@@ -14586,8 +14355,7 @@ const skillsUpdateArgs = (y) => y.positional("name", {
14586
14355
  type: "string",
14587
14356
  describe: "Skill name to update (omit to update all installed skills)"
14588
14357
  });
14589
- //#endregion
14590
- //#region src/commands/skills/skills.ts
14358
+ // src/commands/skills/skills.ts
14591
14359
  /**
14592
14360
  * `holocron skills` — install, remove, and update agent skills from @theholocron/skills.
14593
14361
  *
@@ -14685,8 +14453,7 @@ function runSkillsUpdate(input) {
14685
14453
  const { exitCode } = exec("npx", args, { cwd: repoRoot });
14686
14454
  return { status: exitCode === 0 ? "ok" : "fail" };
14687
14455
  }
14688
- //#endregion
14689
- //#region src/commands/skills/skills.command.ts
14456
+ // src/commands/skills/skills.command.ts
14690
14457
  const skillsInstall = {
14691
14458
  command: "install",
14692
14459
  describe: "Copy skills from @theholocron/skills into .agents/ with agent symlinks",
@@ -14735,8 +14502,7 @@ const skillsCommand = {
14735
14502
  builder: (y) => y.command(skillsInstall).command(skillsRemove).command(skillsUpdate).command(groupMenu("skills")),
14736
14503
  handler: () => {}
14737
14504
  };
14738
- //#endregion
14739
- //#region src/commands/sync-github/sync-github.ts
14505
+ // src/commands/sync-github/sync-github.ts
14740
14506
  const DEFAULT_REPO = "theholocron/.github";
14741
14507
  /**
14742
14508
  * The file set `sync-github` pushes to `theholocron/.github` — the reusable
@@ -14975,8 +14741,7 @@ async function runSyncGithub(input) {
14975
14741
  prUrl
14976
14742
  });
14977
14743
  }
14978
- //#endregion
14979
- //#region src/commands/sync-github/sync-github.args.ts
14744
+ // src/commands/sync-github/sync-github.args.ts
14980
14745
  const syncGithubArgs = (y) => y.option("repo", {
14981
14746
  type: "string",
14982
14747
  default: "theholocron/.github",
@@ -14995,8 +14760,7 @@ const syncGithubArgs = (y) => y.option("repo", {
14995
14760
  type: "string",
14996
14761
  describe: "Write generated files to this local directory instead of pushing (for validation)"
14997
14762
  });
14998
- //#endregion
14999
- //#region src/commands/sync-github/sync-github.command.ts
14763
+ // src/commands/sync-github/sync-github.command.ts
15000
14764
  const resolveSyncToken = createFeatureResolver({
15001
14765
  envName: "HOLOCRON_SYNC_TOKEN",
15002
14766
  keyringKey: "github.sync"
@@ -15029,16 +14793,14 @@ const syncGithubCommand = {
15029
14793
  })).status === "fail") process.exitCode = 1;
15030
14794
  }
15031
14795
  };
15032
- //#endregion
15033
- //#region src/commands/sync/sync.command.ts
14796
+ // src/commands/sync/sync.command.ts
15034
14797
  const syncCommand = {
15035
14798
  command: "sync",
15036
14799
  describe: "Sync generated files to other repos",
15037
14800
  builder: (y) => y.command(syncGithubCommand).command(groupMenu("sync")),
15038
14801
  handler: () => {}
15039
14802
  };
15040
- //#endregion
15041
- //#region src/update-notifier/update-notifier.ts
14803
+ // src/update-notifier/update-notifier.ts
15042
14804
  const PACKAGE_NAME = "@theholocron/cli";
15043
14805
  const CACHE_TTL_MS = 864e5;
15044
14806
  const FETCH_TIMEOUT_MS = 3e3;
@@ -15149,8 +14911,7 @@ async function checkForUpdates(currentVersion) {
15149
14911
  process.stderr.write(formatNotice(currentVersion, latestVersion) + "\n");
15150
14912
  };
15151
14913
  }
15152
- //#endregion
15153
- //#region src/cli.ts
14914
+ // src/cli.ts
15154
14915
  const { version: CLI_VERSION } = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf-8"));
15155
14916
  /** Whether to print the correlation id at command end (`--debug` / `--verbose`). */
15156
14917
  let printRunId = false;
@@ -15228,7 +14989,6 @@ const rid = getRunId();
15228
14989
  if (printRunId && rid) console.log(`Run ID: ${rid}`);
15229
14990
  (await updateCheckPromise)?.();
15230
14991
  await flush();
15231
- //#endregion
15232
14992
  export {};
15233
14993
 
15234
14994
  //# sourceMappingURL=cli.mjs.map