@theholocron/cli 3.13.0 → 3.14.0

package/dist/index.d.mts

@@ -101,6 +101,23 @@ interface AppConfig {
 interface DoctorConfig {
   checks?: string[];
 }
+interface EnvConfig {
+  /**
+   * Namespace prefixes used by this project's env vars.
+   * Listed from least- to most-specific (cascade model — last wins).
+   * Tooling reads this to generate `.env.example`, validate required
+   * vars, and produce documentation. Runtime code passes the same
+   * value to `createEnvParser({ namespaces })` from `@theholocron/env-utils`.
+   *
+   * @example
+   * // Project-only prefix
+   * namespaces: ["CLI_TEMPLATE"]
+   *
+   * // Org-wide defaults + project-specific overrides
+   * namespaces: ["HOLOCRON", "MY_CLI"]
+   */
+  namespaces?: string[];
+}
 interface HolocronConfig {
   /** Project name. Derived from package.json when absent. */
   name?: string;
@@ -167,6 +184,16 @@ interface HolocronConfig {
    * { build: "workflow", domain: "docs.theholocron.dev", https: true }
    */
   docs?: DocsConfig;
+  /**
+   * Environment variable namespace configuration.
+   * Declares the prefix(es) this project uses for its env vars so that
+   * tooling can generate `.env.example`, validate required vars, and
+   * produce accurate documentation without hard-coding prefix strings.
+   *
+   * @example
+   * { namespaces: ["HOLOCRON", "MY_CLI"] }
+   */
+  env?: EnvConfig;
 }
 interface ResolvedTuple {
   provider: string;
@@ -199,6 +226,7 @@ interface ResolvedHolocronConfig {
   skills?: string[];
   /** Resolved Pages config. `build` is guaranteed present when this field exists. */
   docs?: PagesConfig;
+  env?: EnvConfig;
 }
 declare class ConfigError extends Error {
   name: string;
@@ -282,4 +310,4 @@ interface LoadedConfig {
  */
 declare function loadConfig(cwd: string): Promise<LoadedConfig>;
 //#endregion
-export { Analytics, AppConfig, Auth, AuthDescription, AuthError, AuthEvent, AuthEventType, AuthIdentity, AuthUser, CARDINALITY, CapabilityConfigPackage, CapabilityImpls, CapabilityKey, Cardinality, CardinalityFor, Ci, CiRun, CiRunFilter, CiRunStatus, ConfigError, ConfigFileError, ConnectionStringOptions, CreateAuthUserInput, Deployment, DeploymentProject, DeploymentProjectSettings, DeploymentRecord, DeploymentTarget, DeploymentTrigger, Dns, DnsRecord, DnsRecordType, DocsConfig, DoctorConfig, EnsureResult, EnvLookup, Environment, EnvironmentReviewer, Environments, FeatureResolverConfig, HolocronConfig, Issue, IssueSearchFilter, Issues, LabelDef, LifecycleResult, LifecycleSlot, LoadedConfig, MultiEntry, NormalizedAuthUser, Notifications, Observability, PagesConfig, ParseWebhookInput, ProviderApiError, ProviderIdentity, ProviderOptions, REQUIRED_CAPABILITIES, RawProviderEntry, RawProvidersConfig, RepoConfig, RepoProperties, RepoProtection, RepoRef, RepoSettings, type RequestOptions, ResolveTokenConfig, type ResolveTokenInput, ResolvedCapability, ResolvedHolocronConfig, ResolvedProviderEntry, ResolvedProvidersConfig, ResolvedTuple, type RestClient, type RestClientConfig, Ruleset, SecretScope, Secrets, SingleEntry, Source, StatusCategory, Storage, StorageBranch, TeamEntry, TeamPermission, Tooling, ToolingDoctorReport, TrackerDoctorReport, TrackerUser, Vault, WebhookDashboardInfo, WebhookVerificationError, createEnvLookup, createFeatureResolver, createResolveToken, createRestClient, defineConfig, deleteToken, getToken, isMulti, listStoredProviders, loadConfig, resolveConfig, resolveEntry, resolvePluginPackage, setToken };
+export { Analytics, AppConfig, Auth, AuthDescription, AuthError, AuthEvent, AuthEventType, AuthIdentity, AuthUser, CARDINALITY, CapabilityConfigPackage, CapabilityImpls, CapabilityKey, Cardinality, CardinalityFor, Ci, CiRun, CiRunFilter, CiRunStatus, ConfigError, ConfigFileError, ConnectionStringOptions, CreateAuthUserInput, Deployment, DeploymentProject, DeploymentProjectSettings, DeploymentRecord, DeploymentTarget, DeploymentTrigger, Dns, DnsRecord, DnsRecordType, DocsConfig, DoctorConfig, EnsureResult, EnvConfig, EnvLookup, Environment, EnvironmentReviewer, Environments, FeatureResolverConfig, HolocronConfig, Issue, IssueSearchFilter, Issues, LabelDef, LifecycleResult, LifecycleSlot, LoadedConfig, MultiEntry, NormalizedAuthUser, Notifications, Observability, PagesConfig, ParseWebhookInput, ProviderApiError, ProviderIdentity, ProviderOptions, REQUIRED_CAPABILITIES, RawProviderEntry, RawProvidersConfig, RepoConfig, RepoProperties, RepoProtection, RepoRef, RepoSettings, type RequestOptions, ResolveTokenConfig, type ResolveTokenInput, ResolvedCapability, ResolvedHolocronConfig, ResolvedProviderEntry, ResolvedProvidersConfig, ResolvedTuple, type RestClient, type RestClientConfig, Ruleset, SecretScope, Secrets, SingleEntry, Source, StatusCategory, Storage, StorageBranch, TeamEntry, TeamPermission, Tooling, ToolingDoctorReport, TrackerDoctorReport, TrackerUser, Vault, WebhookDashboardInfo, WebhookVerificationError, createEnvLookup, createFeatureResolver, createResolveToken, createRestClient, defineConfig, deleteToken, getToken, isMulti, listStoredProviders, loadConfig, resolveConfig, resolveEntry, resolvePluginPackage, setToken };

package/dist/index.mjs

@@ -237,7 +237,8 @@ function resolveConfig(raw) {
 		doctor: raw.doctor ?? {},
 		agent: raw.agent,
 		skills: raw.skills,
-		docs
+		docs,
+		env: raw.env
 	};
 }
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/cli",
-  "version": "3.13.0",
+  "version": "3.14.0",
   "description": "The Holocron CLI — a pluggable, capability-based orchestrator for spinning up and operating software projects.",
   "homepage": "https://github.com/theholocron/holocron/tree/main/packages/cli#readme",
   "bugs": "https://github.com/theholocron/holocron/issues",