@theholocron/cli 4.13.0 → 4.14.1

package/dist/index.d.mts

@@ -87,6 +87,26 @@ interface LogConfig {
     dataset?: string;
   };
 }
+/**
+ * CLI self-telemetry config — the committed, reviewable override layer over the
+ * env-var + shipped-fallback activation (ADR-0007 / ADR-0008). No secret lives
+ * here; the Sentry DSN and PostHog key come from env vars or ship as fallbacks.
+ *
+ * Precedence: `HOLOCRON_TELEMETRY=false` (env) → `telemetry.enabled` (this) →
+ * default on. `enabled` never *re-enables* what the env var turned off.
+ */
+interface TelemetryConfig {
+  /**
+   * Repo-level opt-out — the committed peer of `HOLOCRON_TELEMETRY=false`.
+   * `false` installs the no-op sinks for the whole run. Default on.
+   */
+  enabled?: boolean;
+  /**
+   * Usage-analytics provider. `"none"` disables PostHog usage analytics while
+   * leaving error reporting (Sentry) untouched. Default `"posthog"`.
+   */
+  analytics?: "posthog" | "none";
+}
 type ProviderOptions = Record<string, unknown>;
 /**
  * The shape a capability config package's default export must satisfy.
@@ -444,6 +464,16 @@ interface HolocronConfig {
    * { level: "debug" }
    */
   log?: LogConfig;
+  /**
+   * CLI self-telemetry override layer. Env var (`HOLOCRON_TELEMETRY=false`)
+   * still wins; this is the committed way to opt a repo out or drop usage
+   * analytics while keeping error reporting.
+   *
+   * @example
+   * { enabled: false }
+   * { analytics: "none" }
+   */
+  telemetry?: TelemetryConfig;
 }
 interface ResolvedTuple {
   provider: string;
@@ -482,6 +512,7 @@ interface ResolvedHolocronConfig {
   docs?: PagesConfig;
   env?: EnvConfig;
   log?: LogConfig;
+  telemetry?: TelemetryConfig;
 }
 declare class ConfigError extends Error {
   name: string;
@@ -573,4 +604,4 @@ interface LoadedConfig {
  */
 declare function loadConfig(cwd: string): Promise<LoadedConfig>;
 //#endregion
-export { Analytics, AppConfig, Auth, AuthDescription, AuthError, AuthEvent, AuthEventType, AuthIdentity, AuthUser, CARDINALITY, Capability, CapabilityConfigPackage, CapabilityImpls, CapabilityKey, Cardinality, CardinalityFor, ChromaticProjectConfig, Ci, CiRun, CiRunFilter, CiRunStatus, ComposedPreset, ConfigError, ConfigFileError, ConnectionStringOptions, CreateAuthUserInput, Deployment, DeploymentProject, DeploymentProjectSettings, DeploymentRecord, DeploymentTarget, DeploymentTrigger, Dns, DnsRecord, DnsRecordType, DocsConfig, DoctorConfig, EnsureResult, EnvConfig, Environment, EnvironmentReviewer, Environments, Errors, FeatureResolverConfig, HolocronConfig, Issue, IssueSearchFilter, Issues, LabelDef, LifecycleResult, LifecycleSlot, LoadedConfig, LogConfig, Logs, MultiEntry, NormalizedAuthUser, Notifications, PagesConfig, ParseWebhookInput, ProviderApiError, ProviderIdentity, ProviderOptions, PullRequest, 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, StorybookDeployProject, TaskEntryConfig, TeamEntry, TeamPermission, Tooling, ToolingDoctorReport, TrackerDoctorReport, TrackerUser, Vault, WebhookDashboardInfo, WebhookVerificationError, Wiki, WikiDnsRecord, WikiProvisionOpts, WikiProxyConfig, Workers, WorkflowWithConfig, compose, createFeatureResolver, createResolveToken, createRestClient, defineConfig, deleteToken, getToken, isMulti, listStoredProviders, loadConfig, resolveConfig, resolveEntry, resolvePluginPackage, setToken };
+export { Analytics, AppConfig, Auth, AuthDescription, AuthError, AuthEvent, AuthEventType, AuthIdentity, AuthUser, CARDINALITY, Capability, CapabilityConfigPackage, CapabilityImpls, CapabilityKey, Cardinality, CardinalityFor, ChromaticProjectConfig, Ci, CiRun, CiRunFilter, CiRunStatus, ComposedPreset, ConfigError, ConfigFileError, ConnectionStringOptions, CreateAuthUserInput, Deployment, DeploymentProject, DeploymentProjectSettings, DeploymentRecord, DeploymentTarget, DeploymentTrigger, Dns, DnsRecord, DnsRecordType, DocsConfig, DoctorConfig, EnsureResult, EnvConfig, Environment, EnvironmentReviewer, Environments, Errors, FeatureResolverConfig, HolocronConfig, Issue, IssueSearchFilter, Issues, LabelDef, LifecycleResult, LifecycleSlot, LoadedConfig, LogConfig, Logs, MultiEntry, NormalizedAuthUser, Notifications, PagesConfig, ParseWebhookInput, ProviderApiError, ProviderIdentity, ProviderOptions, PullRequest, 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, StorybookDeployProject, TaskEntryConfig, TeamEntry, TeamPermission, TelemetryConfig, Tooling, ToolingDoctorReport, TrackerDoctorReport, TrackerUser, Vault, WebhookDashboardInfo, WebhookVerificationError, Wiki, WikiDnsRecord, WikiProvisionOpts, WikiProxyConfig, Workers, WorkflowWithConfig, compose, createFeatureResolver, createResolveToken, createRestClient, defineConfig, deleteToken, getToken, isMulti, listStoredProviders, loadConfig, resolveConfig, resolveEntry, resolvePluginPackage, setToken };

package/dist/index.mjs

@@ -216,7 +216,8 @@ function resolveConfig(raw) {
 		skills: raw.skills,
 		docs,
 		env: raw.env,
-		log: raw.log
+		log: raw.log,
+		telemetry: raw.telemetry
 	};
 }
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/cli",
-  "version": "4.13.0",
+  "version": "4.14.1",
   "description": "The Holocron CLI - a pluggable, capability-based orchestrator for spinning up and operating software projects.",
   "keywords": [
     "cli",
@@ -52,9 +52,9 @@
     "ora": "^9.4.1",
     "posthog-node": "^5.51.6",
     "yargs": "^18.1.0",
-    "@theholocron/astromech": "4.13.0",
-    "@theholocron/datapad": "4.13.0",
-    "@theholocron/logger": "4.13.0"
+    "@theholocron/astromech": "4.14.1",
+    "@theholocron/logger": "4.14.1",
+    "@theholocron/datapad": "4.14.1"
   },
   "devDependencies": {
     "@theholocron/eslint-config": "^8.0.0",
@@ -71,7 +71,7 @@
     "tsx": "4.23.12",
     "typescript": "^5.9.3",
     "vitest": "^4.1.11",
-    "@theholocron/rollup-plugin-transform-template": "4.13.0"
+    "@theholocron/rollup-plugin-transform-template": "4.14.1"
   },
   "engines": {
     "node": ">=22.0.0"