heximon 0.37.0 → 0.39.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/bin.mjs CHANGED
@@ -1,5 +1,5 @@
1
1
  #!/usr/bin/env node
2
- import { _ as StdoutRedirect, d as RegistryAccessStatus, f as CommandOutput, g as CliEntry, i as createCommand, m as PromptRefusedError, n as ProjectRoot, p as CommandFailure, r as CreateDefaults, t as skillsCommand, u as RegistryAccess, v as CliDiagnosticCode, x as PromptCancelledError, y as CliDiagnostics } from "./skills-command-BiuBtTbZ.mjs";
2
+ import { _ as StdoutRedirect, d as RegistryAccessStatus, f as CommandOutput, g as CliEntry, i as createCommand, m as PromptRefusedError, n as ProjectRoot, p as CommandFailure, r as CreateDefaults, t as skillsCommand, u as RegistryAccess, v as CliDiagnosticCode, x as PromptCancelledError, y as CliDiagnostics } from "./skills-command-DT5kJZ6M.mjs";
3
3
  import { createRequire, register } from "node:module";
4
4
  import { cancel, confirm, intro, isCancel, log, outro, select, spinner } from "@clack/prompts";
5
5
  import process from "node:process";
@@ -17,7 +17,7 @@ import { TransactionCensus, TransactionCensusPolicy } from "@heximon/cqrs/compil
17
17
  import { BoundaryProvenanceAuditor, BoundaryProvenanceStatus, CredentialSelection, DatabaseConfigDetector, DeployDiagnosticSeverity, DeployLedger, DeployManifestStore, DeployRunner, DeployStrategyUnavailableError, DeployTargetResolver, DeployableServiceReader, DotenvCascade, DrizzleKitRunner, EnvFileReader, EnvFileUnreadableError, HostManagedDeployUnsupportedError, ImportScanner, MigrationInspector, MigrationTargetComposer, PackageCopyAuditor, PeerClosureAuditor, PlatformTracingAuditor, PlatformTracingStatus, SecretMask, WorkspaceConsumerLocator } from "@heximon/deploy";
18
18
  import { matchesGlob } from "node:path";
19
19
  import { RouteCensus, RouteScopeGap } from "@heximon/http/compiler";
20
- //#region src/check-json-document.ts
20
+ // src/check-json-document.ts
21
21
  /** The stable codes of the failures `heximon check` raises itself, beside the compiler's own. */
22
22
  const CheckDiagnosticCode = {
23
23
  /** A consumed workspace library changed since its last `vp pack`, so the compile read an old manifest. */
@@ -73,8 +73,7 @@ const CheckHostlessSizeUnavailable = {
73
73
  /** The size walk of the server entry does not reach the chunk. */
74
74
  NotReached: "not-reached"
75
75
  };
76
- //#endregion
77
- //#region src/compile-diagnostics.ts
76
+ // src/compile-diagnostics.ts
78
77
  /**
79
78
  * Renders compile diagnostics to stderr with the same codeframe layout the dev server shows — a box-drawing
80
79
  * frame on a TTY, a compact one-liner for CI/editor problem-matchers. Shared by the compile-driven commands.
@@ -97,8 +96,7 @@ var CompileDiagnostics = class {
97
96
  process.stderr.write(`${renderer.renderAll(diagnostics)}\n`);
98
97
  }
99
98
  };
100
- //#endregion
101
- //#region src/compile-mode.ts
99
+ // src/compile-mode.ts
102
100
  /**
103
101
  * Resolves whether an inspection command (`check`, `routes`, `graph`) reads a project as an APP or as a
104
102
  * published module package, and refuses the two argument combinations no mode can honour.
@@ -144,8 +142,7 @@ var CompileModeResolver = class {
144
142
  return `${resolved.mode} mode${resolved.forced ? " (forced)" : ""}`;
145
143
  }
146
144
  };
147
- //#endregion
148
- //#region src/config-sidecar.ts
145
+ // src/config-sidecar.ts
149
146
  /**
150
147
  * Loads the `heximon.config.ts` sidecar for a command. A sidecar that throws is the same failure in every
151
148
  * command: one {@link CliDiagnosticCode.ConfigUnreadable} diagnostic whose `file` is the sidecar.
@@ -203,8 +200,7 @@ var ConfigSidecar = class ConfigSidecar {
203
200
  });
204
201
  }
205
202
  };
206
- //#endregion
207
- //#region src/nitro-static-config.ts
203
+ // src/nitro-static-config.ts
208
204
  /**
209
205
  * Reads the Nitro options that choose the graph of a build (`preset`, `serverDir`, `scanDirs`) from the source of
210
206
  * the config files, without running them. A config file is project code: it can read the environment, call a
@@ -733,8 +729,7 @@ var NitroStaticConfig = class NitroStaticConfig {
733
729
  };
734
730
  }
735
731
  };
736
- //#endregion
737
- //#region src/nuxt-target-file.ts
732
+ // src/nuxt-target-file.ts
738
733
  /**
739
734
  * Reads `.heximon/nuxt-target.json`, which `@heximon/nuxt` writes on each production Nuxt run (a build, or
740
735
  * `nuxt prepare`): the Nitro preset and the source directories of that run. The command never runs the Nuxt
@@ -791,8 +786,7 @@ var NuxtTargetFile = class NuxtTargetFile {
791
786
  };
792
787
  }
793
788
  };
794
- //#endregion
795
- //#region src/host-target-strategy.ts
789
+ // src/host-target-strategy.ts
796
790
  /**
797
791
  * Resolves the deploy strategy of a compile. A Nitro or Nuxt host takes it from its Nitro preset, as its build
798
792
  * does: `@heximon/nitro` maps the preset to the strategy of the vendor. The preset of a Nitro host comes from the
@@ -921,8 +915,7 @@ var HostTargetStrategy = class HostTargetStrategy {
921
915
  }
922
916
  }
923
917
  };
924
- //#endregion
925
- //#region src/project-compile-session.ts
918
+ // src/project-compile-session.ts
926
919
  /**
927
920
  * The from-disk compile prologue every inspection command shares (`check`, `graph`, `routes`, `workflows`):
928
921
  * resolve the source directories, load the `heximon.config.ts` sidecar for the requested `$env`, derive the
@@ -1221,8 +1214,7 @@ var ProjectCompileSession = class ProjectCompileSession {
1221
1214
  };
1222
1215
  }
1223
1216
  };
1224
- //#endregion
1225
- //#region src/source-directories.ts
1217
+ // src/source-directories.ts
1226
1218
  /**
1227
1219
  * Resolves which directories the host-agnostic compile commands (`check`, `graph`, `routes`) scan for Heximon
1228
1220
  * source. The compiler's own default is `<rootDir>/src`; a Nitro/Nuxt host instead keeps its modules under
@@ -1271,8 +1263,7 @@ var SourceDirectories = class SourceDirectories {
1271
1263
  }
1272
1264
  }
1273
1265
  };
1274
- //#endregion
1275
- //#region src/startup-baseline.ts
1266
+ // src/startup-baseline.ts
1276
1267
  /**
1277
1268
  * The command side of the committed startup baseline: it reads and writes `heximon.startup.json`, and turns a
1278
1269
  * comparison into the errors and notes of `heximon check --startup`.
@@ -1369,14 +1360,18 @@ var StartupBaseline = class StartupBaseline {
1369
1360
  case StartupChangeKind.NewApp: return `app '${change.app}' has no record in ${file}, so every package of its start is new.`;
1370
1361
  case StartupChangeKind.EntryGrowth: return `app '${change.app}': the first use of '${change.place}' now loads '${change.package}', and ${file} does not list it for this entry.`;
1371
1362
  case StartupChangeKind.HostlessGrowth: return `hostless app '${change.app}': the module '${change.module}' is now in the app, and ${file} does not list it there.`;
1372
- default: return `app '${change.app}': '${change.package}' now loads at the start, and ${file} does not list it there. Reasons: ${(change.reasons ?? []).join("; ")}.`;
1363
+ default: return `app '${change.app}': '${change.package}' now loads at ${StartupBaseline.startName(change)}, and ${file} does not list it there. Reasons: ${(change.reasons ?? []).join("; ")}.`;
1373
1364
  }
1374
1365
  }
1366
+ /** The start of a change as a message names it: the app's start, or the own start of an entry. */
1367
+ static startName(change) {
1368
+ return change.place === void 0 || change.place === StartupBaselineFile.startPlace ? "the start" : `the start of '${change.place}'`;
1369
+ }
1375
1370
  /** The note lines: one per change that does not fail, and one line that says the file can be smaller. */
1376
1371
  static noteLines(notes) {
1377
1372
  const lines = notes.map((change) => {
1378
1373
  switch (change.kind) {
1379
- case StartupChangeKind.StartShrink: return `app '${change.app}': '${change.package}' no longer loads at the start.`;
1374
+ case StartupChangeKind.StartShrink: return `app '${change.app}': '${change.package}' no longer loads at ${StartupBaseline.startName(change)}.`;
1380
1375
  case StartupChangeKind.EntryShrink: return `app '${change.app}': the first use of '${change.place}' no longer loads '${change.package}'.`;
1381
1376
  case StartupChangeKind.NewEntry: return `app '${change.app}': '${change.place}' is a new entry.`;
1382
1377
  case StartupChangeKind.RemovedEntry: return `app '${change.app}': '${change.place}' is no longer an entry.`;
@@ -1385,7 +1380,9 @@ var StartupBaseline = class StartupBaseline {
1385
1380
  case StartupChangeKind.HostlessShrink: return `hostless app '${change.app}': the module '${change.module}' is no longer in the app.`;
1386
1381
  case StartupChangeKind.NewHostless: return `hostless app '${change.app}' is new.`;
1387
1382
  case StartupChangeKind.RemovedHostless: return `hostless app '${change.app}' is no longer built.`;
1388
- default: return `app '${change.app}': '${change.package}' loads at the start for other reasons: ${(change.reasons ?? []).join("; ")}.`;
1383
+ case StartupChangeKind.NewWakeStart: return `app '${change.app}': '${change.place}' has a start of its own that ${StartupBaselineFile.fileName} does not record.`;
1384
+ case StartupChangeKind.RemovedWakeStart: return `app '${change.app}': '${change.place}' no longer has a start of its own.`;
1385
+ default: return `app '${change.app}': '${change.package}' loads at ${StartupBaseline.startName(change)} for other reasons: ${(change.reasons ?? []).join("; ")}.`;
1389
1386
  }
1390
1387
  });
1391
1388
  if (lines.length === 0) return [];
@@ -1413,8 +1410,7 @@ var StartupBaseline = class StartupBaseline {
1413
1410
  };
1414
1411
  }
1415
1412
  };
1416
- //#endregion
1417
- //#region src/startup-built-code.ts
1413
+ // src/startup-built-code.ts
1418
1414
  /** What a walk does with one `import()` of a file. */
1419
1415
  const ImportEdge = {
1420
1416
  /** The walk follows it: the packages of the walk run it. */
@@ -1713,8 +1709,7 @@ var StartupBuiltCode = class StartupBuiltCode {
1713
1709
  return segments.length > length ? segments.slice(0, length).join("/") : void 0;
1714
1710
  }
1715
1711
  };
1716
- //#endregion
1717
- //#region src/startup-entry-reasons.ts
1712
+ // src/startup-entry-reasons.ts
1718
1713
  /**
1719
1714
  * The reasons of the entries report, named by the kind that the compile records. A reason that the compile
1720
1715
  * does not record is "reason not recorded": the report does not guess a kind for it.
@@ -1792,8 +1787,7 @@ var StartupEntryReasons = class StartupEntryReasons {
1792
1787
  return tokens === void 0 || tokens.length === 0 ? `dependency of ${source} (token not recorded)` : `DI dependency of ${source}, ${tokens.length === 1 ? "token" : "tokens"} ${tokens.join(", ")}`;
1793
1788
  }
1794
1789
  };
1795
- //#endregion
1796
- //#region src/startup-size-check.ts
1790
+ // src/startup-size-check.ts
1797
1791
  /**
1798
1792
  * The size half of `heximon check --startup`: it measures the built server code from the entry that the last
1799
1793
  * build recorded ({@link ServerBuildRecord}), and compares the measures with the `size` section of
@@ -2013,8 +2007,7 @@ var StartupSizeCheck = class StartupSizeCheck {
2013
2007
  return existsSync(path) && statSync(path).isFile();
2014
2008
  }
2015
2009
  };
2016
- //#endregion
2017
- //#region src/startup-entries-report.ts
2010
+ // src/startup-entries-report.ts
2018
2011
  /**
2019
2012
  * The entries report of `heximon check --startup --entries`: for each app, the entries grouped by the packages
2020
2013
  * that their first use loads, and the built code that each group adds after the start. It walks the code with
@@ -2280,8 +2273,7 @@ var StartupEntriesReport = class StartupEntriesReport {
2280
2273
  return first < second ? -1 : first > second ? 1 : 0;
2281
2274
  }
2282
2275
  };
2283
- //#endregion
2284
- //#region src/startup-hostless-report.ts
2276
+ // src/startup-hostless-report.ts
2285
2277
  /**
2286
2278
  * The hostless apps of `heximon check --startup`: the modules of each app, from the start reports, and the static
2287
2279
  * closure of the chunk that holds its boot file, from the build output. The size is a note: it fails nothing.
@@ -2357,8 +2349,7 @@ var StartupHostlessReport = class StartupHostlessReport {
2357
2349
  }
2358
2350
  }
2359
2351
  };
2360
- //#endregion
2361
- //#region src/project-modules.ts
2352
+ // src/project-modules.ts
2362
2353
  /**
2363
2354
  * Imports packages the way the generated wiring imports them: through a small module written into the
2364
2355
  * compile output directory, which sits in the project. The specifiers inside it resolve from the project, so
@@ -2384,8 +2375,7 @@ var ProjectModules = class ProjectModules {
2384
2375
  return ProjectModules.import(directory, "project-runtime.js", "export * from \"@heximon/runtime\";\n");
2385
2376
  }
2386
2377
  };
2387
- //#endregion
2388
- //#region src/nitro-host.ts
2378
+ // src/nitro-host.ts
2389
2379
  /**
2390
2380
  * The production inputs of a Nitro host project, for the preset that was read from its config files. The
2391
2381
  * preset picks the deploy platform, and the compile adds the Nitro host plugin, so a compile that reads the
@@ -2466,8 +2456,7 @@ var NitroHost = class NitroHost {
2466
2456
  };
2467
2457
  }
2468
2458
  };
2469
- //#endregion
2470
- //#region src/startup-target.ts
2459
+ // src/startup-target.ts
2471
2460
  /**
2472
2461
  * Opens the compile of `heximon check --startup` for the deploy target of the build, because the start report
2473
2462
  * depends on the target: only an edge target defers packages. A Nitro host takes the target from the Nitro preset
@@ -2607,8 +2596,7 @@ var StartupTarget = class StartupTarget {
2607
2596
  };
2608
2597
  }
2609
2598
  };
2610
- //#endregion
2611
- //#region src/transaction-census-report.ts
2599
+ // src/transaction-census-report.ts
2612
2600
  /**
2613
2601
  * Renders the compile-time transaction census — which commands are wrapped in a transaction, on which
2614
2602
  * database, and the `app.cqrs.autoTransaction` policy that decided it.
@@ -2686,8 +2674,7 @@ var TransactionCensusReport = class TransactionCensusReport {
2686
2674
  return `${row.command}${attribution === void 0 ? "" : ` — ${attribution}`}`;
2687
2675
  }
2688
2676
  };
2689
- //#endregion
2690
- //#region src/upgrade-baseline.ts
2677
+ // src/upgrade-baseline.ts
2691
2678
  /**
2692
2679
  * The upgrade-safety baseline's command-side helpers. Every one of them is CONCEPT-NEUTRAL: the committed file
2693
2680
  * carries one section per durable concept, so a command that special-cased workflows would leave every other
@@ -2872,8 +2859,7 @@ var UpgradeBaseline = class UpgradeBaseline {
2872
2859
  return [...names].filter((name) => !UpgradeBaselineFile.sameSection(document[name], committedSections[name])).sort();
2873
2860
  }
2874
2861
  };
2875
- //#endregion
2876
- //#region src/check-command.ts
2862
+ // src/check-command.ts
2877
2863
  /**
2878
2864
  * `heximon check` — the headless, compile-only gate. In an APP it runs the from-disk Heximon compile with
2879
2865
  * `typeVerdicts: true`, refreshes the editor-verdict mirror (`writeTypeVerdicts` + `healTsconfigInclude` — the
@@ -3218,8 +3204,7 @@ const checkCommand = defineCommand({
3218
3204
  });
3219
3205
  }
3220
3206
  });
3221
- //#endregion
3222
- //#region src/cli-spinner.ts
3207
+ // src/cli-spinner.ts
3223
3208
  /** The animated phase indicator the slow verbs (deploy, provision, migrations) show while they work. */
3224
3209
  var CliSpinner = class {
3225
3210
  /**
@@ -3245,8 +3230,7 @@ var CliSpinner = class {
3245
3230
  return active;
3246
3231
  }
3247
3232
  };
3248
- //#endregion
3249
- //#region src/credential-resolver.ts
3233
+ // src/credential-resolver.ts
3250
3234
  /**
3251
3235
  * The CLI's credential-resolution strategy: **environment variable → interactive prompt → skip**. A value already
3252
3236
  * in the environment is used; otherwise a **required** spec is prompted for in an interactive session (masked for a
@@ -3325,8 +3309,7 @@ var CredentialResolver = class CredentialResolver {
3325
3309
  });
3326
3310
  }
3327
3311
  };
3328
- //#endregion
3329
- //#region src/deploy-command-failure.ts
3312
+ // src/deploy-command-failure.ts
3330
3313
  /**
3331
3314
  * The failure tail `heximon deploy` and `heximon provision` share: four expected errors that are an
3332
3315
  * actionable halt rather than a bug — a cancelled prompt, an unreadable `--env-file`, a platform whose
@@ -3360,8 +3343,7 @@ var DeployCommandFailure = class {
3360
3343
  return code === void 0 || !(error instanceof Error) ? void 0 : CliDiagnostics.error(code, error.message);
3361
3344
  }
3362
3345
  };
3363
- //#endregion
3364
- //#region src/deploy-json-document.ts
3346
+ // src/deploy-json-document.ts
3365
3347
  /**
3366
3348
  * The stable codes of the `heximon deploy --json` diagnostics. A flag conflict uses
3367
3349
  * `cli.invalid-options`, and a missing answer (`--yes`, a credential variable) uses `cli.option-required`.
@@ -3391,8 +3373,7 @@ const DeployDiagnosticCode = {
3391
3373
  /** A Nitro or Nuxt build uses a preset that the deploy cannot ship. */
3392
3374
  HostManagedUnsupported: "deploy.host-managed-unsupported"
3393
3375
  };
3394
- //#endregion
3395
- //#region src/deploy-command.ts
3376
+ // src/deploy-command.ts
3396
3377
  /**
3397
3378
  * The `heximon deploy` flag cross-checks — a flag whose effect depends on another flag being set.
3398
3379
  *
@@ -4050,8 +4031,7 @@ const deployCommand = defineCommand({
4050
4031
  });
4051
4032
  }
4052
4033
  });
4053
- //#endregion
4054
- //#region src/doctor-json-document.ts
4034
+ // src/doctor-json-document.ts
4055
4035
  /** Which audit set one `heximon doctor` run ran. */
4056
4036
  const DoctorMode = {
4057
4037
  /** The default run: the audits of an app and the libraries it consumes. */
@@ -4106,8 +4086,7 @@ const DoctorDiagnosticCode = {
4106
4086
  /** An `expectedOpenPeers` name matches no undeclared peer. Warning. */
4107
4087
  StalePeerAcknowledgement: "doctor.stale-peer-acknowledgement"
4108
4088
  };
4109
- //#endregion
4110
- //#region src/doctor-audit.ts
4089
+ // src/doctor-audit.ts
4111
4090
  /** Runs the `heximon doctor` audits, and owns the verdicts that the exit status and both renderers read. */
4112
4091
  var DoctorAudit = class DoctorAudit {
4113
4092
  /**
@@ -4541,8 +4520,7 @@ var DoctorJsonReport = class DoctorJsonReport {
4541
4520
  return DoctorJsonReport.plainShellWord.test(path) ? path : `'${path.replaceAll("'", "'\\''")}'`;
4542
4521
  }
4543
4522
  };
4544
- //#endregion
4545
- //#region src/doctor-command.ts
4523
+ // src/doctor-command.ts
4546
4524
  /** The text renderer behind {@link doctorCommand}: every audit of a {@link DoctorAuditResult} as clack lines. */
4547
4525
  var DoctorReport = class DoctorReport {
4548
4526
  /**
@@ -4732,8 +4710,7 @@ const doctorCommand = defineCommand({
4732
4710
  });
4733
4711
  }
4734
4712
  });
4735
- //#endregion
4736
- //#region src/freshness-json-document.ts
4713
+ // src/freshness-json-document.ts
4737
4714
  /**
4738
4715
  * The verdict on one workspace package in a {@link FreshnessJsonDocument}. The first four are the staleness
4739
4716
  * values of `DoctorPackageStatus`.
@@ -4759,8 +4736,7 @@ const FreshnessDiagnosticCode = {
4759
4736
  /** The `pnpm-workspace.yaml` or the root `package.json` cannot be read or parsed. Error. */
4760
4737
  WorkspaceUnreadable: "freshness.workspace-unreadable"
4761
4738
  };
4762
- //#endregion
4763
- //#region src/workspace-packages.ts
4739
+ // src/workspace-packages.ts
4764
4740
  /** Where the member list of a {@link Workspace} comes from. */
4765
4741
  const WorkspaceKind = {
4766
4742
  /** The `packages:` list of a `pnpm-workspace.yaml`. */
@@ -4896,8 +4872,7 @@ var WorkspacePackages = class WorkspacePackages {
4896
4872
  }
4897
4873
  }
4898
4874
  };
4899
- //#endregion
4900
- //#region src/workspace-freshness.ts
4875
+ // src/workspace-freshness.ts
4901
4876
  /**
4902
4877
  * Judges every package of a workspace with {@link LibraryFreshness}: each package that has a Heximon manifest or
4903
4878
  * a `dist/heximon.inputs.json`. It compiles nothing and runs no other audit, so it only stats and hashes files.
@@ -5076,8 +5051,7 @@ var WorkspaceFreshness = class WorkspaceFreshness {
5076
5051
  };
5077
5052
  }
5078
5053
  };
5079
- //#endregion
5080
- //#region src/freshness-command.ts
5054
+ // src/freshness-command.ts
5081
5055
  /** The text renderer behind {@link freshnessCommand}: one clack line per package, then the summary. */
5082
5056
  var FreshnessReport = class {
5083
5057
  /**
@@ -5137,8 +5111,7 @@ const freshnessCommand = defineCommand({
5137
5111
  });
5138
5112
  }
5139
5113
  });
5140
- //#endregion
5141
- //#region src/graph-json-document.ts
5114
+ // src/graph-json-document.ts
5142
5115
  /** The stable codes of the failures `heximon graph` raises itself. */
5143
5116
  const GraphDiagnosticCode = {
5144
5117
  /** The compile threw before the command could read a module graph. */
@@ -5146,8 +5119,7 @@ const GraphDiagnosticCode = {
5146
5119
  /** The `--out` file could not be written. */
5147
5120
  OutWriteFailed: "graph.out-write-failed"
5148
5121
  };
5149
- //#endregion
5150
- //#region src/json-output-target.ts
5122
+ // src/json-output-target.ts
5151
5123
  /**
5152
5124
  * The `--out` file of an inspection command (`routes`, `graph`): it gets the same document the command prints
5153
5125
  * on stdout under `--json`. {@link CommandOutput} owns stdout; this class owns only the file.
@@ -5230,8 +5202,7 @@ var JsonOutputTarget = class JsonOutputTarget {
5230
5202
  }
5231
5203
  }
5232
5204
  };
5233
- //#endregion
5234
- //#region src/module-graph-report.ts
5205
+ // src/module-graph-report.ts
5235
5206
  /**
5236
5207
  * Renders a {@link ModuleGraphView} (and, optionally, the cross-package {@link BoundarySummary} nodes) as a
5237
5208
  * module-nested tree for the terminal, and as a serializable object for `--json`. Every module is a top-level
@@ -5304,8 +5275,7 @@ var ModuleGraphReport = class ModuleGraphReport {
5304
5275
  return token.displayName === void 0 ? token.className : `${token.displayName} (shipped as ${token.className})`;
5305
5276
  }
5306
5277
  };
5307
- //#endregion
5308
- //#region src/graph-command.ts
5278
+ // src/graph-command.ts
5309
5279
  /**
5310
5280
  * `heximon graph` — print the resolved module dependency graph (modules → providers → each provider's
5311
5281
  * resolved dependencies). This is a COMPILE-TIME artifact — like `heximon routes`, it needs no boot: it runs
@@ -5443,8 +5413,7 @@ var GraphCommand = class GraphCommand {
5443
5413
  }));
5444
5414
  }
5445
5415
  };
5446
- //#endregion
5447
- //#region src/migrations-json-document.ts
5416
+ // src/migrations-json-document.ts
5448
5417
  /** The stable codes of the failures and warnings `heximon migrations` raises itself. */
5449
5418
  const MigrationsDiagnosticCode = {
5450
5419
  /** No drizzle-kit config was detected, and `--config` was not given. */
@@ -5471,8 +5440,7 @@ const MigrationsStepStatus = {
5471
5440
  /** The command did not run `drizzle-kit` for this database; {@link MigrationsStepEntry.reason} says why. */
5472
5441
  Skipped: "skipped"
5473
5442
  };
5474
- //#endregion
5475
- //#region src/migrations-command.ts
5443
+ // src/migrations-command.ts
5476
5444
  /**
5477
5445
  * The plumbing every `heximon migrations` subcommand shares: the output mode, the `.env` + detection prologue,
5478
5446
  * the config selection, one captured `drizzle-kit` invocation, and the diagnostics of the `--json` document.
@@ -5977,8 +5945,7 @@ const migrationsCommand = defineCommand({
5977
5945
  push: pushCommand
5978
5946
  }
5979
5947
  });
5980
- //#endregion
5981
- //#region src/provision-json-document.ts
5948
+ // src/provision-json-document.ts
5982
5949
  /**
5983
5950
  * The stable codes of the `heximon provision --json` diagnostics. `--profile` uses `cli.invalid-options`,
5984
5951
  * and a missing credential uses `cli.option-required`.
@@ -5993,8 +5960,7 @@ const ProvisionDiagnosticCode = {
5993
5960
  /** A Nitro or Nuxt build uses a preset that the deploy cannot ship. */
5994
5961
  HostManagedUnsupported: "provision.host-managed-unsupported"
5995
5962
  };
5996
- //#endregion
5997
- //#region src/provision-command.ts
5963
+ // src/provision-command.ts
5998
5964
  /**
5999
5965
  * Builds the `heximon provision --json` document. The run fields are set as the run reaches them, so a
6000
5966
  * failure document still says how far the run got.
@@ -6181,8 +6147,7 @@ const provisionCommand = defineCommand({
6181
6147
  });
6182
6148
  }
6183
6149
  });
6184
- //#endregion
6185
- //#region src/routes-json-document.ts
6150
+ // src/routes-json-document.ts
6186
6151
  /** The stable codes of the failures `heximon routes` raises itself. */
6187
6152
  const RoutesDiagnosticCode = {
6188
6153
  /** The compile threw before the command could read a route census. */
@@ -6196,8 +6161,7 @@ const RoutesDiagnosticCode = {
6196
6161
  /** The `--out` file could not be written. */
6197
6162
  OutWriteFailed: "routes.out-write-failed"
6198
6163
  };
6199
- //#endregion
6200
- //#region src/route-table-report.ts
6164
+ // src/route-table-report.ts
6201
6165
  /**
6202
6166
  * Renders a {@link RouteCensusRow} list as an aligned, columnar route table for the terminal —
6203
6167
  * `METHOD PATH SOURCE HANDLER`, one row per path the app answers, streams and sockets included. The
@@ -6263,8 +6227,7 @@ var RouteTableReport = class RouteTableReport {
6263
6227
  return row.scopesUnresolved === void 0 ? "" : RouteTableReport.unresolvedScopesCell;
6264
6228
  }
6265
6229
  };
6266
- //#endregion
6267
- //#region src/transform-boot.ts
6230
+ // src/transform-boot.ts
6268
6231
  /**
6269
6232
  * Runs a command that imports an app's TypeScript source in-process (`routes --boot`, `task run`).
6270
6233
  * The generated wiring imports the source through `.js` specifiers, and Heximon's parameter-property
@@ -6443,8 +6406,7 @@ var TransformBoot = class TransformBoot {
6443
6406
  return `data:text/javascript,${encodeURIComponent(source)}`;
6444
6407
  }
6445
6408
  };
6446
- //#endregion
6447
- //#region src/routes-command.ts
6409
+ // src/routes-command.ts
6448
6410
  /**
6449
6411
  * `heximon routes` — print the app's unified HTTP route table (inline-mode AND contract-mode routes
6450
6412
  * together), each row carrying the authorization scopes the app enforces on it.
@@ -6715,8 +6677,7 @@ var RoutesCommand = class RoutesCommand {
6715
6677
  })].join("\n");
6716
6678
  }
6717
6679
  };
6718
- //#endregion
6719
- //#region src/runtime-export-resolver.ts
6680
+ // src/runtime-export-resolver.ts
6720
6681
  /**
6721
6682
  * Tells whether a name that generated code imports is a given export of a package, through the barrel files
6722
6683
  * of the app. Generated code imports from app source (`../../src/runtime-barrel.js`), and a barrel can
@@ -6792,8 +6753,7 @@ var RuntimeExportResolver = class RuntimeExportResolver {
6792
6753
  return this.index;
6793
6754
  }
6794
6755
  };
6795
- //#endregion
6796
- //#region src/platform-binding-census.ts
6756
+ // src/platform-binding-census.ts
6797
6757
  /**
6798
6758
  * Finds the platform bindings (Workers KV, Hyperdrive, Durable Objects, …) a compiled graph needs, before
6799
6759
  * anything boots. A binding exists only on its platform, so a run outside it must refuse instead of failing
@@ -7002,8 +6962,7 @@ var PlatformBindingCensus = class PlatformBindingCensus {
7002
6962
  });
7003
6963
  }
7004
6964
  };
7005
- //#endregion
7006
- //#region src/task-run-json-document.ts
6965
+ // src/task-run-json-document.ts
7007
6966
  /** The stable codes of the failures `heximon task run --json` reports. */
7008
6967
  const TaskDiagnosticCode = {
7009
6968
  /** The `run()` of the task threw. The run exits 2, and the document names the error. */
@@ -7037,8 +6996,7 @@ const TaskDiagnosticCode = {
7037
6996
  /** The app did not shut down cleanly after the run. */
7038
6997
  ShutdownFailed: "task.shutdown-failed"
7039
6998
  };
7040
- //#endregion
7041
- //#region src/task-target-resolver.ts
6999
+ // src/task-target-resolver.ts
7042
7000
  /** Thrown when the names do not pick exactly one module and one task. The message is ready to print. */
7043
7001
  var TaskTargetError = class extends Error {
7044
7002
  code;
@@ -7131,8 +7089,7 @@ var TaskTargetResolver = class TaskTargetResolver {
7131
7089
  return previous[right.length] ?? 0;
7132
7090
  }
7133
7091
  };
7134
- //#endregion
7135
- //#region src/task-runner.ts
7092
+ // src/task-runner.ts
7136
7093
  /** The in-process client of a run. A run serves no HTTP, so every call fails with the reason. */
7137
7094
  var RefusingInternalClient = class {
7138
7095
  fetch(input) {
@@ -7580,8 +7537,7 @@ var TaskRunner = class TaskRunner {
7580
7537
  process.stderr.write(`${text}\n`);
7581
7538
  }
7582
7539
  };
7583
- //#endregion
7584
- //#region src/task-command.ts
7540
+ // src/task-command.ts
7585
7541
  /** Helpers of {@link taskCommand}: the argument checks, the environment file and the exit. */
7586
7542
  var TaskCommand = class TaskCommand {
7587
7543
  /**
@@ -7758,8 +7714,7 @@ const taskCommand = defineCommand({
7758
7714
  },
7759
7715
  subCommands: { run: taskRunCommand }
7760
7716
  });
7761
- //#endregion
7762
- //#region src/workflow-status-report.ts
7717
+ // src/workflow-status-report.ts
7763
7718
  /** How one workflow's current step graph relates to the committed baseline gate. */
7764
7719
  const WorkflowBaselineState = {
7765
7720
  /** The committed snapshot matches the current graph — the gate is armed and clean. */
@@ -7992,8 +7947,7 @@ var WorkflowStatusReport = class WorkflowStatusReport {
7992
7947
  } : { kind };
7993
7948
  }
7994
7949
  };
7995
- //#endregion
7996
- //#region src/workflows-command.ts
7950
+ // src/workflows-command.ts
7997
7951
  /**
7998
7952
  * How the committed `heximon.upgrade.json` read resolved. Three-valued on purpose: folding "unreadable" into
7999
7953
  * "absent" would report every workflow as `unarmed` and exit 0, steering the operator at
@@ -8300,8 +8254,7 @@ var WorkflowsCommand = class WorkflowsCommand {
8300
8254
  outro(WorkflowStatusReport.renderSummary(entries, enumerationErrors.size > 0));
8301
8255
  }
8302
8256
  };
8303
- //#endregion
8304
- //#region src/bin.ts
8257
+ // src/bin.ts
8305
8258
  const main = defineCommand({
8306
8259
  meta: {
8307
8260
  name: "heximon",
@@ -8325,5 +8278,4 @@ const main = defineCommand({
8325
8278
  });
8326
8279
  await tab(main);
8327
8280
  await CliEntry.run(main);
8328
- //#endregion
8329
8281
  export {};
package/dist/index.d.mts CHANGED
@@ -3,7 +3,6 @@ import { CompileMode, DiagnosticLabel, DiagnosticSeverity, DiagnosticSpan, Modul
3
3
  import { TransactionCensusDocument } from "@heximon/cqrs/compiler";
4
4
  import { DatabaseApplyModeValue, DeployPhaseValue, PlatformTracingStatusValue } from "@heximon/deploy";
5
5
  import { RouteCensusGap, RouteCensusRow, RouteCensusScopeEnforcement } from "@heximon/http/compiler";
6
- //#region src/cli-json-document.d.ts
7
6
  /**
8
7
  * The stable codes of the failures the CLI itself raises in a `--json` document. A compiler diagnostic keeps
9
8
  * its own compiler code; these cover what happens around the compile.
@@ -81,8 +80,6 @@ interface CliFailureDocument extends CliJsonDocument {
81
80
  /** Always `false`. */
82
81
  readonly ok: false;
83
82
  }
84
- //#endregion
85
- //#region src/check-json-document.d.ts
86
83
  /** The stable codes of the failures `heximon check` raises itself, beside the compiler's own. */
87
84
  declare const CheckDiagnosticCode: {
88
85
  /** A consumed workspace library changed since its last `vp pack`, so the compile read an old manifest. */
@@ -500,8 +497,6 @@ interface CheckJsonDocument extends CliJsonDocument {
500
497
  /** The hostless apps of the compile, present only with `--startup` in an app that has one. */
501
498
  readonly startupHostlessApps?: readonly CheckStartupHostlessApp[];
502
499
  }
503
- //#endregion
504
- //#region src/prompter.d.ts
505
500
  /** Thrown when the operator cancels an interactive prompt (Ctrl-C). */
506
501
  export declare class PromptCancelledError extends Error {
507
502
  constructor();
@@ -518,8 +513,6 @@ interface Prompter {
518
513
  /** Prompt for a non-secret value (input is visible). Rejects with {@link PromptCancelledError} on cancel. */
519
514
  text(message: string): Promise<string>;
520
515
  }
521
- //#endregion
522
- //#region src/clack-prompter.d.ts
523
516
  /**
524
517
  * The {@link Prompter} port backed by `@clack/prompts` — the one interactive surface the CLI exposes. A cancelled
525
518
  * prompt (clack's sentinel symbol) is normalized to a thrown {@link PromptCancelledError} so the credential
@@ -531,8 +524,6 @@ export declare class ClackPrompter implements Prompter {
531
524
  /** @throws PromptCancelledError when cancelled. */
532
525
  text(message: string): Promise<string>;
533
526
  }
534
- //#endregion
535
- //#region src/cli-entry.d.ts
536
527
  /**
537
528
  * Starts the `heximon` command tree. Without a JSON flag it is citty's own `runMain`. With one, an argument
538
529
  * error that citty raises before a command runs (a missing positional, an unknown subcommand) is printed as one
@@ -573,8 +564,6 @@ export declare class CliEntry {
573
564
  /** A citty `Resolvable`: the value, or what its function returns. */
574
565
  private static resolve;
575
566
  }
576
- //#endregion
577
- //#region src/cli-environment.d.ts
578
567
  /** Detects how the CLI is being run, so the deploy credential ladder knows whether interactive prompting is safe. */
579
568
  export declare class CliEnvironment {
580
569
  /**
@@ -584,8 +573,6 @@ export declare class CliEnvironment {
584
573
  */
585
574
  static isInteractive(): boolean;
586
575
  }
587
- //#endregion
588
- //#region src/project-scaffolder.d.ts
589
576
  /**
590
577
  * A template fetch that failed — the giget ref could not be downloaded. Distinct from every local failure so a
591
578
  * caller may retry another ref without also retrying (or cleaning up after) a validation or manifest error.
@@ -715,8 +702,6 @@ export declare class ProjectScaffolder {
715
702
  /** A directory's entries, or `undefined` when the directory does not exist. */
716
703
  private static readEntries;
717
704
  }
718
- //#endregion
719
- //#region src/create-command.d.ts
720
705
  /** What {@link CreateDefaults.scaffoldFromStarters} materializes a project from. */
721
706
  interface StartersScaffoldRequest {
722
707
  /** The template + validator axes. */
@@ -798,8 +783,6 @@ export declare class CreateDefaults {
798
783
  /** Spawn a child process and resolve its exit code (non-zero-safe; spawn errors resolve to 1). */
799
784
  private static run;
800
785
  }
801
- //#endregion
802
- //#region src/registry-access.d.ts
803
786
  /** The result of one spawned command, captured rather than inherited. */
804
787
  interface ProcessRunResult {
805
788
  /** The process exit code (`null` becomes `1`). */
@@ -865,8 +848,6 @@ export declare class RegistryAccess {
865
848
  /** The default {@link ProcessRunner}: spawns `npm` for real, capturing stdout/stderr. */
866
849
  private static spawnProcess;
867
850
  }
868
- //#endregion
869
- //#region src/skills-json-document.d.ts
870
851
  /** The codes of the failures `heximon skills` raises in a `--json` document. */
871
852
  declare const SkillsDiagnosticCode: {
872
853
  /** A source could not be installed: its index or one of its files did not download. */
@@ -925,8 +906,6 @@ interface SkillsSyncJsonDocument extends CliJsonDocument {
925
906
  /** The skills of every source that installed, in list order. */
926
907
  readonly skills: readonly SkillJsonEntry[];
927
908
  }
928
- //#endregion
929
- //#region src/create-json-document.d.ts
930
909
  /** The codes of the failures `heximon create` raises in a `--json` document. */
931
910
  declare const CreateDiagnosticCode: {
932
911
  /** The target directory already holds files. `create` never overwrites. */
@@ -976,8 +955,6 @@ interface CreateJsonDocument extends CliJsonDocument {
976
955
  /** The shell commands that start the app, in order. */
977
956
  readonly nextSteps: readonly string[];
978
957
  }
979
- //#endregion
980
- //#region src/deploy-json-document.d.ts
981
958
  /**
982
959
  * The stable codes of the `heximon deploy --json` diagnostics. A flag conflict uses
983
960
  * `cli.invalid-options`, and a missing answer (`--yes`, a credential variable) uses `cli.option-required`.
@@ -1125,8 +1102,6 @@ interface DeployJsonDocument extends CliJsonDocument {
1125
1102
  /** The `--destroy` action, when it ran. */
1126
1103
  readonly destroy?: DeployJsonDestroy;
1127
1104
  }
1128
- //#endregion
1129
- //#region src/doctor-json-document.d.ts
1130
1105
  /** Which audit set one `heximon doctor` run ran. */
1131
1106
  declare const DoctorMode: {
1132
1107
  /** The default run: the audits of an app and the libraries it consumes. */
@@ -1344,8 +1319,6 @@ interface DoctorJsonDocument extends CliJsonDocument {
1344
1319
  /** The closing sentence of the text report. */
1345
1320
  readonly summary: string;
1346
1321
  }
1347
- //#endregion
1348
- //#region src/workspace-packages.d.ts
1349
1322
  /** Where the member list of a {@link Workspace} comes from. */
1350
1323
  declare const WorkspaceKind: {
1351
1324
  /** The `packages:` list of a `pnpm-workspace.yaml`. */
@@ -1359,8 +1332,6 @@ declare const WorkspaceKind: {
1359
1332
  };
1360
1333
  /** One of the {@link WorkspaceKind} values. */
1361
1334
  type WorkspaceKind = (typeof WorkspaceKind)[keyof typeof WorkspaceKind];
1362
- //#endregion
1363
- //#region src/freshness-json-document.d.ts
1364
1335
  /**
1365
1336
  * The verdict on one workspace package in a {@link FreshnessJsonDocument}. The first four are the staleness
1366
1337
  * values of `DoctorPackageStatus`.
@@ -1424,8 +1395,6 @@ interface FreshnessJsonDocument extends CliJsonDocument {
1424
1395
  /** The closing sentence of the text report. */
1425
1396
  readonly summary: string;
1426
1397
  }
1427
- //#endregion
1428
- //#region src/module-graph-report.d.ts
1429
1398
  /** A cross-package boundary node summarized for the graph report — its factory plus its `requires`/`exports` tokens. */
1430
1399
  interface BoundarySummary {
1431
1400
  /** The package's bare specifier (e.g. `@acme/billing`). */
@@ -1437,8 +1406,6 @@ interface BoundarySummary {
1437
1406
  /** The tokens the boundary exposes to the host, by name. */
1438
1407
  readonly exports: readonly string[];
1439
1408
  }
1440
- //#endregion
1441
- //#region src/graph-json-document.d.ts
1442
1409
  /** The stable codes of the failures `heximon graph` raises itself. */
1443
1410
  declare const GraphDiagnosticCode: {
1444
1411
  /** The compile threw before the command could read a module graph. */
@@ -1460,8 +1427,6 @@ interface GraphJsonDocument extends CliJsonDocument {
1460
1427
  /** How many error diagnostics the compile has. More than zero means the graph can be incomplete. */
1461
1428
  readonly errors: number;
1462
1429
  }
1463
- //#endregion
1464
- //#region src/migrations-json-document.d.ts
1465
1430
  /** The stable codes of the failures and warnings `heximon migrations` raises itself. */
1466
1431
  declare const MigrationsDiagnosticCode: {
1467
1432
  /** No drizzle-kit config was detected, and `--config` was not given. */
@@ -1567,8 +1532,6 @@ interface MigrationsStatusJsonDocument extends CliJsonDocument {
1567
1532
  /** One entry for each selected database. */
1568
1533
  readonly databases: readonly MigrationsStatusEntry[];
1569
1534
  }
1570
- //#endregion
1571
- //#region src/provision-json-document.d.ts
1572
1535
  /**
1573
1536
  * The stable codes of the `heximon provision --json` diagnostics. `--profile` uses `cli.invalid-options`,
1574
1537
  * and a missing credential uses `cli.option-required`.
@@ -1625,8 +1588,6 @@ interface ProvisionJsonDocument extends CliJsonDocument {
1625
1588
  readonly names: readonly string[];
1626
1589
  };
1627
1590
  }
1628
- //#endregion
1629
- //#region src/routes-json-document.d.ts
1630
1591
  /** The stable codes of the failures `heximon routes` raises itself. */
1631
1592
  declare const RoutesDiagnosticCode: {
1632
1593
  /** The compile threw before the command could read a route census. */
@@ -1655,8 +1616,6 @@ interface RoutesJsonDocument extends CliJsonDocument {
1655
1616
  /** Which scope enforcer checks each module's routes. Absent when nothing checks any route's scopes. */
1656
1617
  readonly scopeEnforcement?: RouteCensusScopeEnforcement;
1657
1618
  }
1658
- //#endregion
1659
- //#region src/skill-installer.d.ts
1660
1619
  /** One installed skill: its name, where it was written, and how many files were written. */
1661
1620
  interface InstalledSkill {
1662
1621
  /** The skill name from the source's index. */
@@ -1705,8 +1664,6 @@ export declare class SkillInstaller {
1705
1664
  private static fetchJson;
1706
1665
  private static fetchText;
1707
1666
  }
1708
- //#endregion
1709
- //#region src/skill-sources.d.ts
1710
1667
  /**
1711
1668
  * The project's recorded agent-skill sources, persisted as `heximon.skills` in its `package.json`.
1712
1669
  *
@@ -1747,8 +1704,6 @@ export declare abstract class SkillSources {
1747
1704
  /** The project manifest as a mutable record. */
1748
1705
  private static readManifest;
1749
1706
  }
1750
- //#endregion
1751
- //#region src/skills-command.d.ts
1752
1707
  /**
1753
1708
  * The `heximon skills` command — install the published agent skills into a project and keep the list of
1754
1709
  * sources in `package.json` (`heximon.skills`), so a second machine or a fresh clone reproduces the same
@@ -1758,8 +1713,6 @@ export declare abstract class SkillSources {
1758
1713
  * this command is usually `sync` after a clone, or `add` for a second, private skill site.
1759
1714
  */
1760
1715
  export declare const skillsCommand: CommandDef;
1761
- //#endregion
1762
- //#region src/task-run-json-document.d.ts
1763
1716
  /** The stable codes of the failures `heximon task run --json` reports. */
1764
1717
  declare const TaskDiagnosticCode: {
1765
1718
  /** The `run()` of the task threw. The run exits 2, and the document names the error. */
@@ -1816,8 +1769,6 @@ interface TaskRunJsonDocument extends CliJsonDocument {
1816
1769
  /** The error the task threw; present only with {@link TaskDiagnosticCode.TaskFailed}. */
1817
1770
  readonly error?: TaskRunError;
1818
1771
  }
1819
- //#endregion
1820
- //#region src/workflow-status-report.d.ts
1821
1772
  /** How one workflow's current step graph relates to the committed baseline gate. */
1822
1773
  declare const WorkflowBaselineState: {
1823
1774
  /** The committed snapshot matches the current graph — the gate is armed and clean. */
@@ -1886,5 +1837,4 @@ interface WorkflowsJsonDocument extends CliJsonDocument {
1886
1837
  readonly skipped?: string;
1887
1838
  };
1888
1839
  }
1889
- //#endregion
1890
1840
  export type { BoundarySummary, CheckDiagnosticCode, CheckJsonDocument, CheckUpgradeBaselineResult, CliDiagnostic, CliDiagnosticCode, CliFailureDocument, CliJsonDocument, CreateDiagnosticCode, CreateJsonDocument, DeployAction, DeployDiagnosticCode, DeployJsonCredential, DeployJsonDestroy, DeployJsonDocument, DeployJsonMigration, DeployJsonResources, DeployJsonShip, DeployJsonShipResult, DeployJsonTarget, DoctorCopyCensusResult, DoctorCopyCensusStatus, DoctorDiagnosticCode, DoctorFreshnessDetails, DoctorJsonDocument, DoctorMode, DoctorPackageCopy, DoctorPackageResult, DoctorPackageStatus, DoctorPeerClosureResult, DoctorPeerPivot, DoctorPlatformTracingResult, DoctorRegistryResult, DoctorStaleBuildEntry, FreshnessDiagnosticCode, FreshnessJsonDocument, FreshnessPackageResult, FreshnessPackageStatus, GraphDiagnosticCode, GraphJsonDocument, InstalledSkill, MigrationsDatabaseView, MigrationsDiagnosticCode, MigrationsDrizzleKitResult, MigrationsGenerateEntry, MigrationsGenerateJsonDocument, MigrationsMigrateJsonDocument, MigrationsPushJsonDocument, MigrationsStatusEntry, MigrationsStatusJsonDocument, MigrationsStepEntry, MigrationsStepStatus, PreparedTarget, ProcessRunResult, ProcessRunner, Prompter, ProvisionDiagnosticCode, ProvisionJsonDocument, ProvisionJsonResource, ProvisionJsonResult, RegistryAccessReport, RoutesDiagnosticCode, RoutesJsonDocument, ScaffoldRequest, ScaffoldResult, SkillJsonEntry, SkillSourceJsonEntry, SkillSourceRecording, SkillsAddJsonDocument, SkillsDiagnosticCode, SkillsSyncJsonDocument, StartersScaffoldRequest, TaskDiagnosticCode, TaskRunError, TaskRunJsonDocument, TemplateSelection, TemplateSource, WorkflowBaselineState, WorkflowInstanceInventory, WorkflowInstanceView, WorkflowStatusEntry, WorkflowStatusJsonEntry, WorkflowsDiagnosticCode, WorkflowsJsonDocument, WorkspaceKind };
package/dist/index.mjs CHANGED
@@ -1,2 +1 @@
1
- import { a as SkillSources, b as ClackPrompter, c as ProjectScaffolder, d as RegistryAccessStatus, g as CliEntry, h as CliEnvironment, i as createCommand, l as TemplateDownloadError, o as SkillInstaller, r as CreateDefaults, s as ProjectDirectoryOccupiedError, t as skillsCommand, u as RegistryAccess, x as PromptCancelledError } from "./skills-command-BiuBtTbZ.mjs";
2
- export { ClackPrompter, CliEntry, CliEnvironment, CreateDefaults, ProjectDirectoryOccupiedError, ProjectScaffolder, PromptCancelledError, RegistryAccess, RegistryAccessStatus, SkillInstaller, SkillSources, TemplateDownloadError, createCommand, skillsCommand };
1
+ export { b as ClackPrompter, g as CliEntry, h as CliEnvironment, r as CreateDefaults, s as ProjectDirectoryOccupiedError, c as ProjectScaffolder, x as PromptCancelledError, u as RegistryAccess, d as RegistryAccessStatus, o as SkillInstaller, a as SkillSources, l as TemplateDownloadError, i as createCommand, t as skillsCommand } from "./skills-command-DT5kJZ6M.mjs";
@@ -8,7 +8,7 @@ import { DiagnosticSeverity, SourceLocation } from "@heximon/compiler";
8
8
  import { spawn } from "node:child_process";
9
9
  import { dirname, join, relative, resolve } from "pathe";
10
10
  import { cp, lstat, mkdir, readFile, readdir, rm, stat, symlink, writeFile } from "node:fs/promises";
11
- //#region src/prompter.ts
11
+ // src/prompter.ts
12
12
  /** Thrown when the operator cancels an interactive prompt (Ctrl-C). */
13
13
  var PromptCancelledError = class extends Error {
14
14
  constructor() {
@@ -16,8 +16,7 @@ var PromptCancelledError = class extends Error {
16
16
  this.name = "PromptCancelledError";
17
17
  }
18
18
  };
19
- //#endregion
20
- //#region src/clack-prompter.ts
19
+ // src/clack-prompter.ts
21
20
  /**
22
21
  * The {@link Prompter} port backed by `@clack/prompts` — the one interactive surface the CLI exposes. A cancelled
23
22
  * prompt (clack's sentinel symbol) is normalized to a thrown {@link PromptCancelledError} so the credential
@@ -37,8 +36,7 @@ var ClackPrompter = class {
37
36
  return value;
38
37
  }
39
38
  };
40
- //#endregion
41
- //#region src/cli-diagnostics.ts
39
+ // src/cli-diagnostics.ts
42
40
  /** Builds the {@link CliDiagnostic}s of a `--json` document. */
43
41
  var CliDiagnostics = class CliDiagnostics {
44
42
  /**
@@ -108,8 +106,7 @@ var CliDiagnostics = class CliDiagnostics {
108
106
  }
109
107
  }
110
108
  };
111
- //#endregion
112
- //#region src/cli-json-document.ts
109
+ // src/cli-json-document.ts
113
110
  /**
114
111
  * The stable codes of the failures the CLI itself raises in a `--json` document. A compiler diagnostic keeps
115
112
  * its own compiler code; these cover what happens around the compile.
@@ -133,8 +130,7 @@ const CliDiagnosticCode = {
133
130
  */
134
131
  HostStrategyUnavailable: "cli.host-strategy-unavailable"
135
132
  };
136
- //#endregion
137
- //#region src/stdout-redirect.ts
133
+ // src/stdout-redirect.ts
138
134
  /**
139
135
  * Sends everything written to stdout to stderr for a while, so the log lines of an app that runs in this
140
136
  * process cannot mix with the JSON the command prints. {@link write} reaches the true stdout for that JSON,
@@ -188,8 +184,7 @@ var StdoutRedirect = class StdoutRedirect {
188
184
  this.outer = void 0;
189
185
  }
190
186
  };
191
- //#endregion
192
- //#region src/cli-entry.ts
187
+ // src/cli-entry.ts
193
188
  /**
194
189
  * Starts the `heximon` command tree. Without a JSON flag it is citty's own `runMain`. With one, an argument
195
190
  * error that citty raises before a command runs (a missing positional, an unknown subcommand) is printed as one
@@ -287,8 +282,7 @@ var CliEntry = class CliEntry {
287
282
  return typeof value === "function" ? await value() : value;
288
283
  }
289
284
  };
290
- //#endregion
291
- //#region src/cli-environment.ts
285
+ // src/cli-environment.ts
292
286
  /** Detects how the CLI is being run, so the deploy credential ladder knows whether interactive prompting is safe. */
293
287
  var CliEnvironment = class {
294
288
  /**
@@ -300,8 +294,7 @@ var CliEnvironment = class {
300
294
  return process.stdin.isTTY === true && process.env["CI"] === void 0;
301
295
  }
302
296
  };
303
- //#endregion
304
- //#region src/command-failure.ts
297
+ // src/command-failure.ts
305
298
  /**
306
299
  * An expected failure that stops a command. {@link CommandOutput.run} prints it as a `{ ok: false }` document
307
300
  * under `--json`, and as one `heximon <command>: <message>` line on stderr without it. Both exit 1.
@@ -349,8 +342,7 @@ var PromptRefusedError = class extends CommandFailure {
349
342
  this.name = "PromptRefusedError";
350
343
  }
351
344
  };
352
- //#endregion
353
- //#region src/refusing-prompter.ts
345
+ // src/refusing-prompter.ts
354
346
  /**
355
347
  * The {@link Prompter} of a `--json` run: every prompt fails with a {@link PromptRefusedError} that names the
356
348
  * option or environment variable that supplies the answer.
@@ -372,8 +364,7 @@ var RefusingPrompter = class {
372
364
  return Promise.reject(new PromptRefusedError(this.optionFor(message), message));
373
365
  }
374
366
  };
375
- //#endregion
376
- //#region src/command-output.ts
367
+ // src/command-output.ts
377
368
  /**
378
369
  * Owns the output mode of one command run. Under `--json`, stdout holds exactly one JSON document, written
379
370
  * when the command ends: everything else written to stdout during the run goes to stderr, a prompt fails, and a
@@ -522,8 +513,7 @@ var CommandOutput = class CommandOutput {
522
513
  return exitCode === void 0 || exitCode === null || Number(exitCode) === 0;
523
514
  }
524
515
  };
525
- //#endregion
526
- //#region src/create-json-document.ts
516
+ // src/create-json-document.ts
527
517
  /** The codes of the failures `heximon create` raises in a `--json` document. */
528
518
  const CreateDiagnosticCode = {
529
519
  /** The target directory already holds files. `create` never overwrites. */
@@ -539,8 +529,7 @@ const CreateDiagnosticCode = {
539
529
  /** A warning: the agent skill could not be fetched. The project is complete without it. */
540
530
  SkillsUnavailable: "create.skills-unavailable"
541
531
  };
542
- //#endregion
543
- //#region src/registry-access.ts
532
+ // src/registry-access.ts
544
533
  /** The verdict {@link RegistryAccess.probe} classifies an `npm view` attempt into. */
545
534
  const RegistryAccessStatus = {
546
535
  /** The probe package resolved — the registry is reachable and authorized. */
@@ -653,8 +642,7 @@ var RegistryAccess = class RegistryAccess {
653
642
  });
654
643
  }
655
644
  };
656
- //#endregion
657
- //#region src/project-scaffolder.ts
645
+ // src/project-scaffolder.ts
658
646
  /**
659
647
  * A template fetch that failed — the giget ref could not be downloaded. Distinct from every local failure so a
660
648
  * caller may retry another ref without also retrying (or cleaning up after) a validation or manifest error.
@@ -832,8 +820,7 @@ var ProjectScaffolder = class ProjectScaffolder {
832
820
  }
833
821
  }
834
822
  };
835
- //#endregion
836
- //#region src/skill-installer.ts
823
+ // src/skill-installer.ts
837
824
  /**
838
825
  * Installs the published Heximon agent skill into a scaffolded project from the docs site's RFC 8615
839
826
  * well-known endpoint — `/.well-known/skills/index.json` plus `/.well-known/skills/<name>/<file>`, the
@@ -928,8 +915,7 @@ var SkillInstaller = class SkillInstaller {
928
915
  return response.text();
929
916
  }
930
917
  };
931
- //#endregion
932
- //#region src/skill-sources.ts
918
+ // src/skill-sources.ts
933
919
  /**
934
920
  * The project's recorded agent-skill sources, persisted as `heximon.skills` in its `package.json`.
935
921
  *
@@ -1001,8 +987,7 @@ var SkillSources = class SkillSources {
1001
987
  return manifest;
1002
988
  }
1003
989
  };
1004
- //#endregion
1005
- //#region src/create-command.ts
990
+ // src/create-command.ts
1006
991
  /** Where a child process of `create` writes its output. */
1007
992
  const ChildOutput = {
1008
993
  /** Discard every stream (a probe such as `git rev-parse`). */
@@ -1525,8 +1510,7 @@ var CreateReport = class CreateReport {
1525
1510
  });
1526
1511
  }
1527
1512
  };
1528
- //#endregion
1529
- //#region src/project-root.ts
1513
+ // src/project-root.ts
1530
1514
  /**
1531
1515
  * The project root of a command: its `--cwd` option, resolved and checked. A command reads and writes the
1532
1516
  * project only after {@link ProjectRoot.resolve} accepts the root, so no step creates a mistyped directory.
@@ -1586,8 +1570,7 @@ var ProjectRoot = class ProjectRoot {
1586
1570
  return typeof error === "object" && error !== null && "code" in error ? error.code : void 0;
1587
1571
  }
1588
1572
  };
1589
- //#endregion
1590
- //#region src/skills-json-document.ts
1573
+ // src/skills-json-document.ts
1591
1574
  /** The codes of the failures `heximon skills` raises in a `--json` document. */
1592
1575
  const SkillsDiagnosticCode = {
1593
1576
  /** A source could not be installed: its index or one of its files did not download. */
@@ -1604,8 +1587,7 @@ const SkillSourceRecording = {
1604
1587
  /** The install failed, so the run did not record the source. */
1605
1588
  NotRecorded: "not-recorded"
1606
1589
  };
1607
- //#endregion
1608
- //#region src/skills-command.ts
1590
+ // src/skills-command.ts
1609
1591
  /** The shared behavior behind `heximon skills add` and `heximon skills sync`. */
1610
1592
  var SkillsRunner = class SkillsRunner {
1611
1593
  /** The arguments every `skills` subcommand takes. */
@@ -1800,5 +1782,4 @@ const skillsCommand = defineCommand({
1800
1782
  sync: syncCommand
1801
1783
  }
1802
1784
  });
1803
- //#endregion
1804
1785
  export { StdoutRedirect as _, SkillSources as a, ClackPrompter as b, ProjectScaffolder as c, RegistryAccessStatus as d, CommandOutput as f, CliEntry as g, CliEnvironment as h, createCommand as i, TemplateDownloadError as l, PromptRefusedError as m, ProjectRoot as n, SkillInstaller as o, CommandFailure as p, CreateDefaults as r, ProjectDirectoryOccupiedError as s, skillsCommand as t, RegistryAccess as u, CliDiagnosticCode as v, PromptCancelledError as x, CliDiagnostics as y };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "heximon",
3
- "version": "0.37.0",
3
+ "version": "0.39.0",
4
4
  "description": "The Heximon CLI: create, develop, build, migrate, and deploy Heximon apps.",
5
5
  "keywords": [
6
6
  "cli",
@@ -38,37 +38,37 @@
38
38
  "dependencies": {
39
39
  "@bomb.sh/tab": "^0.0.22",
40
40
  "@clack/prompts": "^1.8.1",
41
- "@heximon/compiler": "0.37.0",
42
- "@heximon/cqrs": "0.37.0",
43
- "@heximon/deploy": "0.37.0",
44
- "@heximon/http": "0.37.0",
45
- "@heximon/node": "0.37.0",
46
- "@heximon/runtime": "0.37.0",
47
- "@heximon/testing": "0.37.0",
41
+ "@heximon/compiler": "0.39.0",
42
+ "@heximon/cqrs": "0.39.0",
43
+ "@heximon/deploy": "0.39.0",
44
+ "@heximon/http": "0.39.0",
45
+ "@heximon/node": "0.39.0",
46
+ "@heximon/runtime": "0.39.0",
47
+ "@heximon/testing": "0.39.0",
48
48
  "citty": "^0.2.2",
49
49
  "giget": "^3.3.1",
50
50
  "pathe": "^2.0.3"
51
51
  },
52
52
  "devDependencies": {
53
- "@heximon/build": "0.37.0",
54
- "@heximon/cloudflare": "0.37.0",
55
- "@heximon/durable": "0.37.0",
56
- "@heximon/integration": "0.37.0",
57
- "@heximon/library": "0.37.0",
58
- "@heximon/nitro": "0.37.0",
59
- "@heximon/otel": "0.37.0",
60
- "@heximon/queue": "0.37.0",
61
- "@heximon/schedule": "0.37.0",
62
- "@heximon/schema": "0.37.0",
53
+ "@heximon/build": "0.39.0",
54
+ "@heximon/cloudflare": "0.39.0",
55
+ "@heximon/durable": "0.39.0",
56
+ "@heximon/integration": "0.39.0",
57
+ "@heximon/library": "0.39.0",
58
+ "@heximon/nitro": "0.39.0",
59
+ "@heximon/otel": "0.39.0",
60
+ "@heximon/queue": "0.39.0",
61
+ "@heximon/schedule": "0.39.0",
62
+ "@heximon/schema": "0.39.0",
63
63
  "@heximon/test-support": "0.0.1",
64
64
  "@types/node": "^24.19.0",
65
65
  "@typescript/native-preview": "^7.0.0-dev.20260707.2",
66
- "@vitest/coverage-v8": "5.0.1",
66
+ "@vitest/coverage-v8": "5.1.0",
67
67
  "nitro": "^3.0.260903-beta",
68
68
  "typescript": "^6.0.3",
69
69
  "valibot": "^1.5.0",
70
70
  "vite": "^8.3.1",
71
- "vitest": "5.0.1"
71
+ "vitest": "5.1.0"
72
72
  },
73
73
  "engines": {
74
74
  "node": ">=24"