@theholocron/cli 5.0.0-alpha.429 → 5.0.0-alpha.430

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.
@@ -77,7 +77,7 @@ function isUnsyncedLayer(layer) {
77
77
  /**
78
78
  * The text of the error for an Environment of an unsynced layer, shared by the command and the config checks.
79
79
  *
80
- * @param what - What names the layer, e.g. "`sync secrets dev`" or "a `repo.secrets.sync` entry".
80
+ * @param what - What names the layer, e.g. "`sync secrets --env dev`" or "a `repo.secrets.sync` entry".
81
81
  * @param layer - The unsynced layer.
82
82
  */
83
83
  function unsyncedLayerMessage(what, layer) {
@@ -141,7 +141,7 @@ interface RepoVariables {
141
141
  * readable in GitHub afterwards, so keep it in an environment of its own, apart from the one that fills secrets.
142
142
  */
143
143
  interface RepoVariablesSync {
144
- /** The vault environment id, as given to `holocron sync secrets <environmentId>`. */
144
+ /** The vault environment id, as given to `holocron sync secrets --env <environment>`. */
145
145
  environment?: string;
146
146
  /**
147
147
  * The layer to name instead of `environment`: the Environment is `<org/repo> - <layer>`, from the repository's
@@ -186,7 +186,7 @@ interface RepoSecrets {
186
186
  * `ConfigError`: there is no "all keys".
187
187
  */
188
188
  interface RepoSecretsDeploy {
189
- /** The vault environment id, as given to `holocron sync secrets <environmentId>`. */
189
+ /** The vault environment id, as given to `holocron sync secrets --env <environment>`. */
190
190
  environment?: string;
191
191
  /**
192
192
  * The layer to name instead of `environment`: the Environment is `<org/repo> - <layer>`, from the repository's
@@ -200,7 +200,7 @@ interface RepoSecretsDeploy {
200
200
  }
201
201
  /** One vault environment that `holocron sync secrets` pushes into GitHub secrets, declared so the doctor can check them. */
202
202
  interface RepoSecretsSync {
203
- /** The vault environment id, as given to `holocron sync secrets <environmentId>`. */
203
+ /** The vault environment id, as given to `holocron sync secrets --env <environment>`. */
204
204
  environment?: string;
205
205
  /**
206
206
  * The layer to name instead of `environment`: the Environment is `<org/repo> - <layer>`, from the repository's
@@ -333,11 +333,16 @@ interface DoctorConfig {
333
333
  mail?: "icloud";
334
334
  /**
335
335
  * Variable names that live in more than one place on purpose (an Environment's entry and the one a second
336
- * Environment holds), which `holocron doctor variable-owners` does not report. Names only. The copy a
336
+ * Environment holds), which `holocron doctor secrets --shared` does not report. Names only. The copy a
337
337
  * `repo.secrets.sync` or `repo.variables.sync` entry makes is never reported, so it needs no entry here.
338
- * `holocron doctor shared-values` leaves out the same names: a secret two layers hold the same value of on purpose.
338
+ * `holocron doctor secrets --shared` leaves out the same names: a secret two layers hold the same value of on purpose.
339
339
  */
340
340
  sharedVariables?: string[];
341
+ /**
342
+ * Secret names that are set by hand on purpose (a repository that runs Lighthouse stores `HOLOCRON_LIGHTHOUSE_TOKEN`
343
+ * at repository scope). `holocron doctor secrets` never reports one as `extra`. Names only, beside `sharedVariables`.
344
+ */
345
+ manualSecrets?: string[];
341
346
  }
342
347
  /** The `credentials` block: which environment the `credentials` providers read this machine's tokens from. */
343
348
  interface CredentialsConfig {
@@ -2231,7 +2236,7 @@ interface Vault extends ProviderIdentity {
2231
2236
  readEnvironment?(environmentId: string): Promise<Record<string, string>>;
2232
2237
  /**
2233
2238
  * Optional — like `readEnvironment`, but each entry says whether the vault holds it concealed (a secret) or
2234
- * visible (a plain value). `holocron doctor shared-values` compares only the concealed ones. The values are for
2239
+ * visible (a plain value). `holocron doctor secrets --shared` compares only the concealed ones. The values are for
2235
2240
  * in-memory comparison and are never printed. A provider that cannot tell omits this.
2236
2241
  */
2237
2242
  readEnvironmentEntries?(environmentId: string): Promise<EnvironmentEntry[]>;
@@ -3716,7 +3721,7 @@ interface Credentials extends ProviderIdentity {
3716
3721
  read(environment: string): Promise<Record<string, string>>;
3717
3722
  /**
3718
3723
  * Which environment `environment` really is and the names of its variables, without reading any value. Used by
3719
- * `holocron doctor credentials`. Optional: a provider that cannot list names without values leaves it out and
3724
+ * `holocron doctor secrets`. Optional: a provider that cannot list names without values leaves it out and
3720
3725
  * the check is skipped for it. Rejects when the environment cannot be found.
3721
3726
  */
3722
3727
  inspect?(environment: string): Promise<CredentialsInspection>;
package/dist/index.d.mts CHANGED
@@ -1,4 +1,4 @@
1
- import { $ as DnsRecord, $n as WikiProxyConfig, $r as RepoVariablesSync, $t as NotificationsDelivery, A as Cardinality, An as Source, Ar as DevConfig, At as Issues, B as DeployFunctionConfig, Bn as SyncResult, Br as MultiEntry, Bt as MonitoringAlertSettings, C as BoardStatusCategory, Cn as ResolvedCapability, Cr as resolveConfig, Ct as Issue, D as BoardView, Dn as SecretVisibility, Dr as CapabilityConfigPackage, Dt as IssueRecord, E as BoardTemplateFile, En as SecretScope, Er as AppConfig, Et as IssuePriority, F as CiRunStatus, Fn as SourceSecurity, Fr as EslintConfig, Ft as LogsDataset, G as DeploymentProject, Gn as TrackerDoctorReport, Gr as RepoConfig, Gt as MonitoringCheckInput, H as DeployScriptConfig, Hn as TeamPermission, Hr as ProviderOptions, Ht as MonitoringAssertionComparison, I as ConnectionStringOptions, In as SourceTeamMember, Ir as GitHubAppConfig, It as Monitoring, J as DeploymentTarget, Jn as Tunnels, Jr as RepoSecrets, Jt as NormalizedAuthUser, K as DeploymentProjectSettings, Kn as TrackerUser, Kr as RepoProperties, Kt as MonitoringHttpMethod, L as CreateAuthUserInput, Ln as StatusCategory, Lr as HolocronConfig, Lt as MonitoringAlertChannelInput, M as Ci, Mn as SourceFile, Mr as DocsConfig, Mt as LifecycleResult, N as CiRun, Nn as SourceRepoInfo, Nr as DoctorConfig, Nt as LifecycleSlot, O as CapabilityImpls, On as Secrets, Or as ChromaticProjectConfig, Ot as IssueSearchFilter, P as CiRunFilter, Pn as SourceRulesetDetail, Pr as EnvConfig, Pt as Logs, Q as Dns, Qn as WikiProvisionOpts, Qr as RepoVariables, Qt as NotificationsChannelLayout, R as Credentials, Rn as Storage, Rr as IdeasConfig, Rt as MonitoringAlertChannelResult, S as BoardStatus, Sn as RepoSettings, Sr as credentialsEnvironment, St as InspectRelayInput, T as BoardTemplate, Tn as SecretAccess, Tr as resolvePluginPackage, Tt as IssueOrder, U as DeployScriptResult, Un as Tooling, Ur as RawProviderEntry, Ut as MonitoringAssertionSource, V as DeployFunctionResult, Vn as TeamEntry, Vr as OrgConfig, Vt as MonitoringAssertion, W as Deployment, Wn as ToolingDoctorReport, Wr as RawProvidersConfig, Wt as MonitoringCheck, X as DiscussionPatch, Xn as WebhookDashboardInfo, Xr as RepoSecretsSync, Xt as NotificationsAccess, Y as DeploymentTrigger, Yn as Vault, Yr as RepoSecretsDeploy, Yt as Notifications, Z as DiscussionPost, Zn as Wiki, Zr as RepoValidationConfig, Zt as NotificationsApplicationLayout, _ as BoardFieldType, _n as Projects, _r as LoadedConfig, _t as ExportInfo, a as REQUIRED_CAPABILITIES, ai as StorybookDeployProject, an as NotificationsMonitoringFeed, ar as deriveProfile, at as EnsureRelayResult, b as BoardRule, bn as RelayState, br as TaskEntry, bt as ImportOptions, c as AddedItem, ci as WorkflowWithConfig, cn as NotificationsPinnedLayout, cr as readWorkspacePackageJsons, ct as EnsureWebhookResult, d as AuthDescription, dn as NotificationsSignIn, dr as PackageJsonLike, dt as EnsuredTunnel, ei as ResolvedHolocronConfig, en as NotificationsEveryoneLayout, er as WorkerScriptState, et as DnsRecordRequest, f as AuthEvent, fn as NotificationsSignedIn, fr as StackName, ft as Environment, g as BoardField, gn as ParseWebhookInput, gr as loadConfig, gt as Errors, h as AuthUser, hn as PagesConfig, hr as defineConfig, ht as Environments, i as ProviderApiError, ii as SingleEntry, in as NotificationsMember, ir as deriveCompliance, it as EnsureRelayInput, j as CardinalityFor, jn as SourceBranch, jr as DevServeConfig, jt as LabelDef, k as CapabilityKey, kn as ServerInspection, kr as CredentialsConfig, kt as IssueSelector, l as Analytics, li as EnvironmentLayer, ln as NotificationsPrsFeed, lr as DeriveProfileInput, lt as EnsuredDiscussion, m as AuthIdentity, mn as OrganizationSecretScope, mr as compose, mt as EnvironmentReviewer, n as ElevationRequiredError, ni as ResolvedProvidersConfig, nn as NotificationsLayout, nr as KNOWN_STACK_DEPS, nt as DuplicateDiscussion, o as WebhookVerificationError, oi as TaskEntryConfig, on as NotificationsOnboardingLayout, or as deriveStack, ot as EnsureReport, p as AuthEventType, pn as NotificationsWelcomeLayout, pr as ConfigFileError, pt as EnvironmentEntry, q as DeploymentRecord, qn as TunnelRoute, qr as RepoProtection, qt as MoveReport, r as MissingTokenError, ri as ResolvedTuple, rn as NotificationsLinksLayout, rr as deriveCapabilities, rt as EnsureDiscussionInput, s as isMulti, si as TelemetryConfig, sn as NotificationsPicture, sr as missingCapabilities, st as EnsureResult, t as CARDINALITY, ti as ResolvedProviderEntry, tn as NotificationsForumTag, tr as Workers, tt as DnsRecordType, u as Auth, un as NotificationsServerLayout, ur as HolocronProfile, ut as EnsuredResource, v as BoardItem, vn as ProviderIdentity, vr as Capability, vt as IdeaRecord, w as BoardSummary, wn as Ruleset, wr as resolveEntry, wt as IssueComment, x as BoardState, xn as RepoRef, xr as ConfigError, xt as ImportResult, y as BoardItemInput, yn as PullRequest, yr as ComposedPreset, yt as Ideas, z as CredentialsInspection, zn as StorageBranch, zr as LogConfig, zt as MonitoringAlertChannelState } from "./index-4MVAtJs5.mjs";
1
+ import { $ as DnsRecord, $n as WikiProxyConfig, $r as RepoVariablesSync, $t as NotificationsDelivery, A as Cardinality, An as Source, Ar as DevConfig, At as Issues, B as DeployFunctionConfig, Bn as SyncResult, Br as MultiEntry, Bt as MonitoringAlertSettings, C as BoardStatusCategory, Cn as ResolvedCapability, Cr as resolveConfig, Ct as Issue, D as BoardView, Dn as SecretVisibility, Dr as CapabilityConfigPackage, Dt as IssueRecord, E as BoardTemplateFile, En as SecretScope, Er as AppConfig, Et as IssuePriority, F as CiRunStatus, Fn as SourceSecurity, Fr as EslintConfig, Ft as LogsDataset, G as DeploymentProject, Gn as TrackerDoctorReport, Gr as RepoConfig, Gt as MonitoringCheckInput, H as DeployScriptConfig, Hn as TeamPermission, Hr as ProviderOptions, Ht as MonitoringAssertionComparison, I as ConnectionStringOptions, In as SourceTeamMember, Ir as GitHubAppConfig, It as Monitoring, J as DeploymentTarget, Jn as Tunnels, Jr as RepoSecrets, Jt as NormalizedAuthUser, K as DeploymentProjectSettings, Kn as TrackerUser, Kr as RepoProperties, Kt as MonitoringHttpMethod, L as CreateAuthUserInput, Ln as StatusCategory, Lr as HolocronConfig, Lt as MonitoringAlertChannelInput, M as Ci, Mn as SourceFile, Mr as DocsConfig, Mt as LifecycleResult, N as CiRun, Nn as SourceRepoInfo, Nr as DoctorConfig, Nt as LifecycleSlot, O as CapabilityImpls, On as Secrets, Or as ChromaticProjectConfig, Ot as IssueSearchFilter, P as CiRunFilter, Pn as SourceRulesetDetail, Pr as EnvConfig, Pt as Logs, Q as Dns, Qn as WikiProvisionOpts, Qr as RepoVariables, Qt as NotificationsChannelLayout, R as Credentials, Rn as Storage, Rr as IdeasConfig, Rt as MonitoringAlertChannelResult, S as BoardStatus, Sn as RepoSettings, Sr as credentialsEnvironment, St as InspectRelayInput, T as BoardTemplate, Tn as SecretAccess, Tr as resolvePluginPackage, Tt as IssueOrder, U as DeployScriptResult, Un as Tooling, Ur as RawProviderEntry, Ut as MonitoringAssertionSource, V as DeployFunctionResult, Vn as TeamEntry, Vr as OrgConfig, Vt as MonitoringAssertion, W as Deployment, Wn as ToolingDoctorReport, Wr as RawProvidersConfig, Wt as MonitoringCheck, X as DiscussionPatch, Xn as WebhookDashboardInfo, Xr as RepoSecretsSync, Xt as NotificationsAccess, Y as DeploymentTrigger, Yn as Vault, Yr as RepoSecretsDeploy, Yt as Notifications, Z as DiscussionPost, Zn as Wiki, Zr as RepoValidationConfig, Zt as NotificationsApplicationLayout, _ as BoardFieldType, _n as Projects, _r as LoadedConfig, _t as ExportInfo, a as REQUIRED_CAPABILITIES, ai as StorybookDeployProject, an as NotificationsMonitoringFeed, ar as deriveProfile, at as EnsureRelayResult, b as BoardRule, bn as RelayState, br as TaskEntry, bt as ImportOptions, c as AddedItem, ci as WorkflowWithConfig, cn as NotificationsPinnedLayout, cr as readWorkspacePackageJsons, ct as EnsureWebhookResult, d as AuthDescription, dn as NotificationsSignIn, dr as PackageJsonLike, dt as EnsuredTunnel, ei as ResolvedHolocronConfig, en as NotificationsEveryoneLayout, er as WorkerScriptState, et as DnsRecordRequest, f as AuthEvent, fn as NotificationsSignedIn, fr as StackName, ft as Environment, g as BoardField, gn as ParseWebhookInput, gr as loadConfig, gt as Errors, h as AuthUser, hn as PagesConfig, hr as defineConfig, ht as Environments, i as ProviderApiError, ii as SingleEntry, in as NotificationsMember, ir as deriveCompliance, it as EnsureRelayInput, j as CardinalityFor, jn as SourceBranch, jr as DevServeConfig, jt as LabelDef, k as CapabilityKey, kn as ServerInspection, kr as CredentialsConfig, kt as IssueSelector, l as Analytics, li as EnvironmentLayer, ln as NotificationsPrsFeed, lr as DeriveProfileInput, lt as EnsuredDiscussion, m as AuthIdentity, mn as OrganizationSecretScope, mr as compose, mt as EnvironmentReviewer, n as ElevationRequiredError, ni as ResolvedProvidersConfig, nn as NotificationsLayout, nr as KNOWN_STACK_DEPS, nt as DuplicateDiscussion, o as WebhookVerificationError, oi as TaskEntryConfig, on as NotificationsOnboardingLayout, or as deriveStack, ot as EnsureReport, p as AuthEventType, pn as NotificationsWelcomeLayout, pr as ConfigFileError, pt as EnvironmentEntry, q as DeploymentRecord, qn as TunnelRoute, qr as RepoProtection, qt as MoveReport, r as MissingTokenError, ri as ResolvedTuple, rn as NotificationsLinksLayout, rr as deriveCapabilities, rt as EnsureDiscussionInput, s as isMulti, si as TelemetryConfig, sn as NotificationsPicture, sr as missingCapabilities, st as EnsureResult, t as CARDINALITY, ti as ResolvedProviderEntry, tn as NotificationsForumTag, tr as Workers, tt as DnsRecordType, u as Auth, un as NotificationsServerLayout, ur as HolocronProfile, ut as EnsuredResource, v as BoardItem, vn as ProviderIdentity, vr as Capability, vt as IdeaRecord, w as BoardSummary, wn as Ruleset, wr as resolveEntry, wt as IssueComment, x as BoardState, xn as RepoRef, xr as ConfigError, xt as ImportResult, y as BoardItemInput, yn as PullRequest, yr as ComposedPreset, yt as Ideas, z as CredentialsInspection, zn as StorageBranch, zr as LogConfig, zt as MonitoringAlertChannelState } from "./index-BFrWaQ3Y.mjs";
2
2
  import { AuthError, ResolveTokenConfig as ResolveTokenConfig$1, ResolveTokenInput, ResolveTokenInput as ResolveTokenInput$1, resolveValue } from "@theholocron/kyber/secrets";
3
3
  import { CheckRow } from "@theholocron/kyber/ui";
4
4
  import "@theholocron/env-utils/lookup";
@@ -53,7 +53,7 @@ interface PluginToken {
53
53
  keyringKey: string;
54
54
  /**
55
55
  * `false` when the plugin's `verifyToken` does not apply to this token (it checks a different credential, such as
56
- * a webhook URL), so `holocron doctor tokens` reports it as set without calling the plugin. Default `true`.
56
+ * a webhook URL), so `holocron doctor secrets --verify` reports it as set without calling the plugin. Default `true`.
57
57
  */
58
58
  verifiable?: boolean;
59
59
  /**
@@ -64,7 +64,7 @@ interface PluginToken {
64
64
  /**
65
65
  * `true` when the plugin only falls back to this token: nothing needs it unless a call names no better source (the
66
66
  * Discord webhook a post uses when it names no channel). The checks that expect every token a plugin lists, such as
67
- * `holocron doctor credentials`, do not expect it, and `holocron export tokens` marks it as optional when it has none.
67
+ * `holocron doctor secrets`, do not expect it, and `holocron export tokens` marks it as optional when it has none.
68
68
  * Default `false`.
69
69
  */
70
70
  optional?: boolean;
@@ -87,12 +87,12 @@ interface FeatureResolverConfig {
87
87
  }
88
88
  /** A resolver from `createFeatureResolver`: call it for the token, or read `token` to see where it looks. */
89
89
  type FeatureResolver = ((input?: ResolveTokenInput$1) => string) & {
90
- /** The environment variable and keyring entry this resolver reads, for `holocron doctor tokens`. */
90
+ /** The environment variable and keyring entry this resolver reads, for `holocron doctor secrets --verify`. */
91
91
  readonly token: PluginToken;
92
92
  };
93
93
  /** A resolver from `createResolveToken`: call it for the token, or read `token` to see where it looks. */
94
94
  type TokenResolver = ((input?: ResolveTokenInput$1) => string) & {
95
- /** The environment variables and keyring entry this resolver reads, for `holocron doctor tokens`. */
95
+ /** The environment variables and keyring entry this resolver reads, for `holocron doctor secrets --verify`. */
96
96
  readonly token: PluginToken;
97
97
  };
98
98
  /**
@@ -103,7 +103,7 @@ type TokenResolver = ((input?: ResolveTokenInput$1) => string) & {
103
103
  export declare const keyring: import("@theholocron/kyber/secrets").Keyring;
104
104
  /**
105
105
  * Kyber's `createResolveToken` with the keyring, the `HOLOCRON_ORG` variable and the `token` description
106
- * `holocron doctor tokens` reads filled in, so a plugin stays at a one-liner call site. The chain is the flag, the
106
+ * `holocron doctor secrets --verify` reads filled in, so a plugin stays at a one-liner call site. The chain is the flag, the
107
107
  * plugin's variable, the vendor's variable, the `credentials` providers' variables, the keyring.
108
108
  */
109
109
  export declare function createResolveToken(config: ResolveTokenConfig): TokenResolver;
@@ -463,12 +463,12 @@ type AuthExportOutKind = "terminal" | "pipe" | "other";
463
463
  */
464
464
  export declare function stdoutKind(isTerminal: boolean, fd?: number, stat?: (fd: number) => Pick<Stats, "isFIFO" | "isSocket">): AuthExportOutKind;
465
465
  /**
466
- * The vault Environment `holocron sync secrets <environmentId>` reads. A layer word (`local`, `dev`, `ci`, `prod`) is the
466
+ * The vault Environment `holocron sync secrets --env <environment>` reads. A layer word (`local`, `dev`, `ci`, `prod`) is the
467
467
  * Environment of that layer of this repository, `<org/repo> - <layer>`; any other text is a literal Environment name.
468
468
  * A literal name wins only when it is not exactly a layer word, so an Environment that is itself called `prod` cannot be
469
469
  * addressed by that name (spec `tech-environment-layers`, #2069).
470
470
  *
471
- * @param id - The positional the user gave.
471
+ * @param id - The `--env` value the user gave.
472
472
  * @param input - Where the repository is (its `origin` remote is read there), and optionally how to read it.
473
473
  * @throws {ConfigError} For a layer word when the remote cannot be read (the message names the `environment` option).
474
474
  */
package/dist/index.mjs CHANGED
@@ -1,5 +1,5 @@
1
1
  import { CARDINALITY, ElevationRequiredError, MissingTokenError, ProviderApiError, REQUIRED_CAPABILITIES, WebhookVerificationError, isMulti } from "./plugin/capabilities.mjs";
2
- import { a as placeAreas, c as ConfigError, d as resolveEntry, f as resolvePluginPackage, g as layerEnvironment, h as isEnvironmentLayer, i as loadConfig, l as credentialsEnvironment, m as ENVIRONMENT_LAYERS, n as compose, o as HOLOCRON_AREAS, p as repoSlug, r as defineConfig, s as SHARED_AREAS, t as ConfigFileError, u as resolveConfig } from "./config-system-b3wXHmZF.mjs";
2
+ import { a as placeAreas, c as ConfigError, d as resolveEntry, f as resolvePluginPackage, g as layerEnvironment, h as isEnvironmentLayer, i as loadConfig, l as credentialsEnvironment, m as ENVIRONMENT_LAYERS, n as compose, o as HOLOCRON_AREAS, p as repoSlug, r as defineConfig, s as SHARED_AREAS, t as ConfigFileError, u as resolveConfig } from "./config-system-CijVTCFk.mjs";
3
3
  import { Entry, findCredentials } from "@napi-rs/keyring";
4
4
  import { AuthError, createFeatureResolver as createFeatureResolver$1, createKeyring, createResolveToken as createResolveToken$1, resolveValue } from "@theholocron/kyber/secrets";
5
5
  import { describeError, style } from "@theholocron/kyber/ui";
@@ -33,7 +33,7 @@ const keyring = createKeyring({
33
33
  });
34
34
  /**
35
35
  * Kyber's `createResolveToken` with the keyring, the `HOLOCRON_ORG` variable and the `token` description
36
- * `holocron doctor tokens` reads filled in, so a plugin stays at a one-liner call site. The chain is the flag, the
36
+ * `holocron doctor secrets --verify` reads filled in, so a plugin stays at a one-liner call site. The chain is the flag, the
37
37
  * plugin's variable, the vendor's variable, the `credentials` providers' variables, the keyring.
38
38
  */
39
39
  function createResolveToken(config) {
@@ -598,12 +598,12 @@ function stdoutKind(isTerminal, fd = 1, stat = fstatSync) {
598
598
  }
599
599
  // src/commands/secrets-sync/resolve-environment-id/resolve-environment-id.ts
600
600
  /**
601
- * The vault Environment `holocron sync secrets <environmentId>` reads. A layer word (`local`, `dev`, `ci`, `prod`) is the
601
+ * The vault Environment `holocron sync secrets --env <environment>` reads. A layer word (`local`, `dev`, `ci`, `prod`) is the
602
602
  * Environment of that layer of this repository, `<org/repo> - <layer>`; any other text is a literal Environment name.
603
603
  * A literal name wins only when it is not exactly a layer word, so an Environment that is itself called `prod` cannot be
604
604
  * addressed by that name (spec `tech-environment-layers`, #2069).
605
605
  *
606
- * @param id - The positional the user gave.
606
+ * @param id - The `--env` value the user gave.
607
607
  * @param input - Where the repository is (its `origin` remote is read there), and optionally how to read it.
608
608
  * @throws {ConfigError} For a layer word when the remote cannot be read (the message names the `environment` option).
609
609
  */
@@ -1,2 +1,2 @@
1
- import { $ as DnsRecord, $n as WikiProxyConfig, $t as NotificationsDelivery, A as Cardinality, An as Source, At as Issues, B as DeployFunctionConfig, Bn as SyncResult, Bt as MonitoringAlertSettings, C as BoardStatusCategory, Cn as ResolvedCapability, Ct as Issue, D as BoardView, Dn as SecretVisibility, Dt as IssueRecord, E as BoardTemplateFile, En as SecretScope, Et as IssuePriority, F as CiRunStatus, Fn as SourceSecurity, Ft as LogsDataset, G as DeploymentProject, Gn as TrackerDoctorReport, Gt as MonitoringCheckInput, H as DeployScriptConfig, Hn as TeamPermission, Ht as MonitoringAssertionComparison, I as ConnectionStringOptions, In as SourceTeamMember, It as Monitoring, J as DeploymentTarget, Jn as Tunnels, Jt as NormalizedAuthUser, K as DeploymentProjectSettings, Kn as TrackerUser, Kt as MonitoringHttpMethod, L as CreateAuthUserInput, Ln as StatusCategory, Lt as MonitoringAlertChannelInput, M as Ci, Mn as SourceFile, Mt as LifecycleResult, N as CiRun, Nn as SourceRepoInfo, Nt as LifecycleSlot, O as CapabilityImpls, On as Secrets, Ot as IssueSearchFilter, P as CiRunFilter, Pn as SourceRulesetDetail, Pt as Logs, Q as Dns, Qn as WikiProvisionOpts, Qt as NotificationsChannelLayout, R as Credentials, Rn as Storage, Rt as MonitoringAlertChannelResult, S as BoardStatus, Sn as RepoSettings, St as InspectRelayInput, T as BoardTemplate, Tn as SecretAccess, Tt as IssueOrder, U as DeployScriptResult, Un as Tooling, Ut as MonitoringAssertionSource, V as DeployFunctionResult, Vn as TeamEntry, Vt as MonitoringAssertion, W as Deployment, Wn as ToolingDoctorReport, Wt as MonitoringCheck, X as DiscussionPatch, Xn as WebhookDashboardInfo, Xt as NotificationsAccess, Y as DeploymentTrigger, Yn as Vault, Yt as Notifications, Z as DiscussionPost, Zn as Wiki, Zt as NotificationsApplicationLayout, _ as BoardFieldType, _n as Projects, _t as ExportInfo, a as REQUIRED_CAPABILITIES, an as NotificationsMonitoringFeed, at as EnsureRelayResult, b as BoardRule, bn as RelayState, bt as ImportOptions, c as AddedItem, cn as NotificationsPinnedLayout, ct as EnsureWebhookResult, d as AuthDescription, dn as NotificationsSignIn, dt as EnsuredTunnel, en as NotificationsEveryoneLayout, er as WorkerScriptState, et as DnsRecordRequest, f as AuthEvent, fn as NotificationsSignedIn, ft as Environment, g as BoardField, gn as ParseWebhookInput, gt as Errors, h as AuthUser, hn as PagesConfig, ht as Environments, i as ProviderApiError, in as NotificationsMember, it as EnsureRelayInput, j as CardinalityFor, jn as SourceBranch, jt as LabelDef, k as CapabilityKey, kn as ServerInspection, kt as IssueSelector, l as Analytics, ln as NotificationsPrsFeed, lt as EnsuredDiscussion, m as AuthIdentity, mn as OrganizationSecretScope, mt as EnvironmentReviewer, n as ElevationRequiredError, nn as NotificationsLayout, nt as DuplicateDiscussion, o as WebhookVerificationError, on as NotificationsOnboardingLayout, ot as EnsureReport, p as AuthEventType, pn as NotificationsWelcomeLayout, pt as EnvironmentEntry, q as DeploymentRecord, qn as TunnelRoute, qt as MoveReport, r as MissingTokenError, rn as NotificationsLinksLayout, rt as EnsureDiscussionInput, s as isMulti, sn as NotificationsPicture, st as EnsureResult, t as CARDINALITY, tn as NotificationsForumTag, tr as Workers, tt as DnsRecordType, u as Auth, un as NotificationsServerLayout, ut as EnsuredResource, v as BoardItem, vn as ProviderIdentity, vt as IdeaRecord, w as BoardSummary, wn as Ruleset, wt as IssueComment, x as BoardState, xn as RepoRef, xt as ImportResult, y as BoardItemInput, yn as PullRequest, yt as Ideas, z as CredentialsInspection, zn as StorageBranch, zt as MonitoringAlertChannelState } from "../index-4MVAtJs5.mjs";
1
+ import { $ as DnsRecord, $n as WikiProxyConfig, $t as NotificationsDelivery, A as Cardinality, An as Source, At as Issues, B as DeployFunctionConfig, Bn as SyncResult, Bt as MonitoringAlertSettings, C as BoardStatusCategory, Cn as ResolvedCapability, Ct as Issue, D as BoardView, Dn as SecretVisibility, Dt as IssueRecord, E as BoardTemplateFile, En as SecretScope, Et as IssuePriority, F as CiRunStatus, Fn as SourceSecurity, Ft as LogsDataset, G as DeploymentProject, Gn as TrackerDoctorReport, Gt as MonitoringCheckInput, H as DeployScriptConfig, Hn as TeamPermission, Ht as MonitoringAssertionComparison, I as ConnectionStringOptions, In as SourceTeamMember, It as Monitoring, J as DeploymentTarget, Jn as Tunnels, Jt as NormalizedAuthUser, K as DeploymentProjectSettings, Kn as TrackerUser, Kt as MonitoringHttpMethod, L as CreateAuthUserInput, Ln as StatusCategory, Lt as MonitoringAlertChannelInput, M as Ci, Mn as SourceFile, Mt as LifecycleResult, N as CiRun, Nn as SourceRepoInfo, Nt as LifecycleSlot, O as CapabilityImpls, On as Secrets, Ot as IssueSearchFilter, P as CiRunFilter, Pn as SourceRulesetDetail, Pt as Logs, Q as Dns, Qn as WikiProvisionOpts, Qt as NotificationsChannelLayout, R as Credentials, Rn as Storage, Rt as MonitoringAlertChannelResult, S as BoardStatus, Sn as RepoSettings, St as InspectRelayInput, T as BoardTemplate, Tn as SecretAccess, Tt as IssueOrder, U as DeployScriptResult, Un as Tooling, Ut as MonitoringAssertionSource, V as DeployFunctionResult, Vn as TeamEntry, Vt as MonitoringAssertion, W as Deployment, Wn as ToolingDoctorReport, Wt as MonitoringCheck, X as DiscussionPatch, Xn as WebhookDashboardInfo, Xt as NotificationsAccess, Y as DeploymentTrigger, Yn as Vault, Yt as Notifications, Z as DiscussionPost, Zn as Wiki, Zt as NotificationsApplicationLayout, _ as BoardFieldType, _n as Projects, _t as ExportInfo, a as REQUIRED_CAPABILITIES, an as NotificationsMonitoringFeed, at as EnsureRelayResult, b as BoardRule, bn as RelayState, bt as ImportOptions, c as AddedItem, cn as NotificationsPinnedLayout, ct as EnsureWebhookResult, d as AuthDescription, dn as NotificationsSignIn, dt as EnsuredTunnel, en as NotificationsEveryoneLayout, er as WorkerScriptState, et as DnsRecordRequest, f as AuthEvent, fn as NotificationsSignedIn, ft as Environment, g as BoardField, gn as ParseWebhookInput, gt as Errors, h as AuthUser, hn as PagesConfig, ht as Environments, i as ProviderApiError, in as NotificationsMember, it as EnsureRelayInput, j as CardinalityFor, jn as SourceBranch, jt as LabelDef, k as CapabilityKey, kn as ServerInspection, kt as IssueSelector, l as Analytics, ln as NotificationsPrsFeed, lt as EnsuredDiscussion, m as AuthIdentity, mn as OrganizationSecretScope, mt as EnvironmentReviewer, n as ElevationRequiredError, nn as NotificationsLayout, nt as DuplicateDiscussion, o as WebhookVerificationError, on as NotificationsOnboardingLayout, ot as EnsureReport, p as AuthEventType, pn as NotificationsWelcomeLayout, pt as EnvironmentEntry, q as DeploymentRecord, qn as TunnelRoute, qt as MoveReport, r as MissingTokenError, rn as NotificationsLinksLayout, rt as EnsureDiscussionInput, s as isMulti, sn as NotificationsPicture, st as EnsureResult, t as CARDINALITY, tn as NotificationsForumTag, tr as Workers, tt as DnsRecordType, u as Auth, un as NotificationsServerLayout, ut as EnsuredResource, v as BoardItem, vn as ProviderIdentity, vt as IdeaRecord, w as BoardSummary, wn as Ruleset, wt as IssueComment, x as BoardState, xn as RepoRef, xt as ImportResult, y as BoardItemInput, yn as PullRequest, yt as Ideas, z as CredentialsInspection, zn as StorageBranch, zt as MonitoringAlertChannelState } from "../index-BFrWaQ3Y.mjs";
2
2
  export { AddedItem, Analytics, Auth, AuthDescription, AuthEvent, AuthEventType, AuthIdentity, AuthUser, BoardField, BoardFieldType, BoardItem, BoardItemInput, BoardRule, BoardState, BoardStatus, BoardStatusCategory, BoardSummary, BoardTemplate, BoardTemplateFile, BoardView, CARDINALITY, CapabilityImpls, CapabilityKey, Cardinality, CardinalityFor, Ci, CiRun, CiRunFilter, CiRunStatus, ConnectionStringOptions, CreateAuthUserInput, Credentials, CredentialsInspection, DeployFunctionConfig, DeployFunctionResult, DeployScriptConfig, DeployScriptResult, Deployment, DeploymentProject, DeploymentProjectSettings, DeploymentRecord, DeploymentTarget, DeploymentTrigger, DiscussionPatch, DiscussionPost, Dns, DnsRecord, DnsRecordRequest, DnsRecordType, DuplicateDiscussion, ElevationRequiredError, EnsureDiscussionInput, EnsureRelayInput, EnsureRelayResult, EnsureReport, EnsureResult, EnsureWebhookResult, EnsuredDiscussion, EnsuredResource, EnsuredTunnel, Environment, EnvironmentEntry, EnvironmentReviewer, Environments, Errors, ExportInfo, IdeaRecord, Ideas, ImportOptions, ImportResult, InspectRelayInput, Issue, IssueComment, IssueOrder, IssuePriority, IssueRecord, IssueSearchFilter, IssueSelector, Issues, LabelDef, LifecycleResult, LifecycleSlot, Logs, LogsDataset, MissingTokenError, Monitoring, MonitoringAlertChannelInput, MonitoringAlertChannelResult, MonitoringAlertChannelState, MonitoringAlertSettings, MonitoringAssertion, MonitoringAssertionComparison, MonitoringAssertionSource, MonitoringCheck, MonitoringCheckInput, MonitoringHttpMethod, MoveReport, NormalizedAuthUser, Notifications, NotificationsAccess, NotificationsApplicationLayout, NotificationsChannelLayout, NotificationsDelivery, NotificationsEveryoneLayout, NotificationsForumTag, NotificationsLayout, NotificationsLinksLayout, NotificationsMember, NotificationsMonitoringFeed, NotificationsOnboardingLayout, NotificationsPicture, NotificationsPinnedLayout, NotificationsPrsFeed, NotificationsServerLayout, NotificationsSignIn, NotificationsSignedIn, NotificationsWelcomeLayout, OrganizationSecretScope, PagesConfig, ParseWebhookInput, Projects, ProviderApiError, ProviderIdentity, PullRequest, REQUIRED_CAPABILITIES, RelayState, RepoRef, RepoSettings, ResolvedCapability, Ruleset, SecretAccess, SecretScope, SecretVisibility, Secrets, ServerInspection, Source, SourceBranch, SourceFile, SourceRepoInfo, SourceRulesetDetail, SourceSecurity, SourceTeamMember, StatusCategory, Storage, StorageBranch, SyncResult, TeamEntry, TeamPermission, Tooling, ToolingDoctorReport, TrackerDoctorReport, TrackerUser, TunnelRoute, Tunnels, Vault, WebhookDashboardInfo, WebhookVerificationError, Wiki, WikiProvisionOpts, WikiProxyConfig, WorkerScriptState, Workers, isMulti };
@@ -1,4 +1,4 @@
1
- import { mr as compose, vr as Capability, yr as ComposedPreset } from "./index-4MVAtJs5.mjs";
1
+ import { mr as compose, vr as Capability, yr as ComposedPreset } from "./index-BFrWaQ3Y.mjs";
2
2
  /** Options for the audit capability. */
3
3
  interface AuditOptions {
4
4
  /** Enable Knip unused-export analysis (default: false). */
package/dist/presets.mjs CHANGED
@@ -1,4 +1,4 @@
1
- import { n as compose } from "./config-system-b3wXHmZF.mjs";
1
+ import { n as compose } from "./config-system-CijVTCFk.mjs";
2
2
  import { DEFAULT_ORG } from "@theholocron/astromech";
3
3
  // src/presets/capabilities/audit.ts
4
4
  /**
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@theholocron/cli",
3
- "version": "5.0.0-alpha.429",
3
+ "version": "5.0.0-alpha.430",
4
4
  "description": "The Holocron CLI - a pluggable, capability-based orchestrator for spinning up and operating software projects.",
5
5
  "keywords": [
6
6
  "cli",
@@ -59,18 +59,18 @@
59
59
  "posthog-node": "^5.64.0",
60
60
  "tsx": "4.23.15",
61
61
  "yargs": "^18.1.0",
62
- "@theholocron/astromech": "5.0.0-alpha.429",
63
- "@theholocron/datapad": "5.0.0-alpha.429",
64
- "@theholocron/env-utils": "^1.17.0-alpha.4",
65
- "@theholocron/dagobah": "5.0.0-alpha.429",
62
+ "@theholocron/astromech": "5.0.0-alpha.430",
63
+ "@theholocron/datapad": "5.0.0-alpha.430",
66
64
  "@theholocron/fs-utils": "^1.17.0-alpha.4",
67
- "@theholocron/git-utils": "^1.17.0-alpha.4",
65
+ "@theholocron/env-utils": "^1.17.0-alpha.4",
68
66
  "@theholocron/github-client": "^1.58.0-alpha.29",
69
67
  "@theholocron/http-client": "^1.58.0-alpha.29",
68
+ "@theholocron/git-utils": "^1.17.0-alpha.4",
69
+ "@theholocron/dagobah": "5.0.0-alpha.430",
70
70
  "@theholocron/json-utils": "^1.17.0-alpha.4",
71
71
  "@theholocron/misc-utils": "^1.17.0-alpha.4",
72
- "@theholocron/kyber": "5.0.0-alpha.429",
73
72
  "@theholocron/observability": "^0.7.0-alpha.4",
73
+ "@theholocron/kyber": "5.0.0-alpha.430",
74
74
  "@theholocron/pkg-utils": "^1.17.0-alpha.4"
75
75
  },
76
76
  "devDependencies": {
@@ -86,8 +86,8 @@
86
86
  "vitest": "^5.1.0",
87
87
  "@theholocron/eslint-config": "^8.9.0-alpha.17",
88
88
  "@theholocron/rollup-plugin-transform-template": "^8.9.0-alpha.17",
89
- "@theholocron/vitest-config": "^8.9.0-alpha.17",
90
- "@theholocron/tsconfig": "^8.9.0-alpha.17"
89
+ "@theholocron/tsconfig": "^8.9.0-alpha.17",
90
+ "@theholocron/vitest-config": "^8.9.0-alpha.17"
91
91
  },
92
92
  "engines": {
93
93
  "node": ">=22.0.0"