@theholocron/cli 3.53.0 → 3.55.0

package/dist/index.d.mts

@@ -1,5 +1,6 @@
-import { Analytics, Auth, AuthDescription, AuthEvent, AuthEventType, AuthIdentity, AuthUser, CARDINALITY, CapabilityImpls, CapabilityKey, Cardinality, CardinalityFor, Ci, CiRun, CiRunFilter, CiRunStatus, ConnectionStringOptions, CreateAuthUserInput, Deployment, DeploymentProject, DeploymentProjectSettings, DeploymentRecord, DeploymentTarget, DeploymentTrigger, Dns, DnsRecord, DnsRecordType, EnsureResult, Environment, EnvironmentReviewer, Environments, Issue, IssueSearchFilter, Issues, LabelDef, LifecycleResult, LifecycleSlot, NormalizedAuthUser, Notifications, Observability, PagesConfig, ParseWebhookInput, ProviderApiError, ProviderIdentity, PullRequest, REQUIRED_CAPABILITIES, RepoRef, RepoSettings, ResolvedCapability, Ruleset, SecretScope, Secrets, Source, StatusCategory, Storage, StorageBranch, TeamEntry, TeamPermission, Tooling, ToolingDoctorReport, TrackerDoctorReport, TrackerUser, Vault, WebhookDashboardInfo, WebhookVerificationError, Wiki, WikiDnsRecord, WikiProvisionOpts, WikiProxyConfig, Workers, isMulti } from "./plugin/capabilities.mjs";
+import { Analytics, Auth, AuthDescription, AuthEvent, AuthEventType, AuthIdentity, AuthUser, CARDINALITY, CapabilityImpls, CapabilityKey, Cardinality, CardinalityFor, Ci, CiRun, CiRunFilter, CiRunStatus, ConnectionStringOptions, CreateAuthUserInput, Deployment, DeploymentProject, DeploymentProjectSettings, DeploymentRecord, DeploymentTarget, DeploymentTrigger, Dns, DnsRecord, DnsRecordType, EnsureResult, Environment, EnvironmentReviewer, Environments, Errors, Issue, IssueSearchFilter, Issues, LabelDef, LifecycleResult, LifecycleSlot, Logs, NormalizedAuthUser, Notifications, PagesConfig, ParseWebhookInput, ProviderApiError, ProviderIdentity, PullRequest, REQUIRED_CAPABILITIES, RepoRef, RepoSettings, ResolvedCapability, Ruleset, SecretScope, Secrets, Source, StatusCategory, Storage, StorageBranch, TeamEntry, TeamPermission, Tooling, ToolingDoctorReport, TrackerDoctorReport, TrackerUser, Vault, WebhookDashboardInfo, WebhookVerificationError, Wiki, WikiDnsRecord, WikiProvisionOpts, WikiProxyConfig, Workers, isMulti } from "./plugin/capabilities.mjs";
 import { AuthError, RequestOptions, ResolveTokenConfig as ResolveTokenConfig$1, ResolveTokenInput, RestClient, RestClientConfig, createRestClient } from "@theholocron/http-client";
+import { LogLevel } from "@theholocron/logger";
 //#region src/auth/auth-resolver.d.ts
 type ResolveTokenConfig = Omit<ResolveTokenConfig$1, "getKeyringToken">;
 /** Wraps `createResolveToken` from `@theholocron/http` and injects the
@@ -65,6 +66,14 @@ declare function deleteToken(provider: string): boolean;
 declare function listStoredProviders(): string[];
 //#endregion
 //#region src/config/config.d.ts
+/** Structured-logging config — level only; credentials never live in config. */
+interface LogConfig {
+  /**
+   * Default log level. The lowest-priority level source: `--verbose` /
+   * `--quiet` and `HOLOCRON_LOG_LEVEL` both outrank it.
+   */
+  level?: LogLevel;
+}
 type ProviderOptions = Record<string, unknown>;
 /**
  * The shape a capability config package's default export must satisfy.
@@ -374,6 +383,14 @@ interface HolocronConfig {
    * { namespaces: ["HOLOCRON", "MY_CLI"] }
    */
   env?: EnvConfig;
+  /**
+   * Structured-logging config. Only the level belongs here — Axiom
+   * credentials come from env vars, never a committed file.
+   *
+   * @example
+   * { level: "debug" }
+   */
+  log?: LogConfig;
 }
 interface ResolvedTuple {
   provider: string;
@@ -409,6 +426,7 @@ interface ResolvedHolocronConfig {
   /** Resolved Pages config. `build` is guaranteed present when this field exists. */
   docs?: PagesConfig;
   env?: EnvConfig;
+  log?: LogConfig;
 }
 declare class ConfigError extends Error {
   name: string;
@@ -498,4 +516,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, FeatureResolverConfig, HolocronConfig, Issue, IssueSearchFilter, Issues, LabelDef, LifecycleResult, LifecycleSlot, LoadedConfig, MultiEntry, NormalizedAuthUser, Notifications, Observability, 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, 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, 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 };

package/dist/index.mjs

@@ -113,31 +113,6 @@ function createFeatureResolver(config) {
 }
 //#endregion
 //#region src/config/config.ts
-/**
-* `holocron.config.json` schema, parser, and provider resolution.
-*
-* ESLint-style entry forms:
-*
-*   "source": "github"                              ← single, short
-*   "deployment": ["vercel", { team: "rando" }]    ← single, with options
-*   "notifications": ["slack", "discord"]          ← multi, short
-*   "notifications": [
-*     ["slack",   { channel: "#ops" }],
-*     ["discord", { webhook: "env:HOOK" }]
-*   ]                                              ← multi, with options
-*
-* Discriminator: an array entry is a `[provider, options]` tuple when
-* the length is 2 AND element[1] is a non-array, non-null object.
-* Otherwise it's a multi-provider list (string[] or tuple[]).
-*
-* Validation rules:
-*   - `vault` is REQUIRED (every project has secrets somewhere)
-*   - Entries for `'many'` capabilities are normalized to an array of
-*     normalized tuples; entries for `'single'` capabilities are
-*     normalized to one tuple
-*   - Tokens / secret values never appear in config — providers read
-*     them from env (or pull from `vault` at runtime)
-*/
 var ConfigError = class extends Error {
 	name = "ConfigError";
 };
@@ -235,7 +210,8 @@ function resolveConfig(raw) {
 		agent: raw.agent,
 		skills: raw.skills,
 		docs,
-		env: raw.env
+		env: raw.env,
+		log: raw.log
 	};
 }
 //#endregion

package/dist/plugin/capabilities.d.mts

@@ -9,10 +9,10 @@ import { ProviderApiError } from "@theholocron/http-client";
  * `CardinalityFor<K>` so config resolution + command code can branch
  * statically.
  *
- * See `.notes/tech-architecture.spec.md` for the design narrative
- * (status: proposed, issue: #74).
+ * See `.notes/archive/tech-architecture.spec.md` for the design narrative
+ * (issue: #74).
  */
-type CapabilityKey = "source" | "ci" | "secrets" | "environments" | "issues" | "deployment" | "storage" | "auth" | "vault" | "dns" | "tooling" | "notifications" | "analytics" | "observability" | "wiki" | "workers";
+type CapabilityKey = "source" | "ci" | "secrets" | "environments" | "issues" | "deployment" | "storage" | "auth" | "vault" | "dns" | "tooling" | "notifications" | "analytics" | "errors" | "logs" | "wiki" | "workers";
 type Cardinality = "single" | "many";
 declare const CARDINALITY: {
   readonly source: "single";
@@ -28,7 +28,8 @@ declare const CARDINALITY: {
   readonly tooling: "many";
   readonly notifications: "many";
   readonly analytics: "many";
-  readonly observability: "many";
+  readonly errors: "single";
+  readonly logs: "single";
   readonly wiki: "single";
   readonly workers: "single";
 };
@@ -577,6 +578,41 @@ interface Dns extends ProviderIdentity {
   upsertRecord(domain: string, record: DnsRecord): Promise<DnsRecord>;
   deleteRecord(domain: string, id: string): Promise<void>;
 }
+interface Errors extends ProviderIdentity {
+  readonly key: "errors";
+  /** Returns the env var names the app reads at runtime for this provider. */
+  describe(): Promise<{
+    provider: string;
+    envKeys: string[];
+  }>;
+  whoami?(): Promise<{
+    org: string;
+  }>;
+  ensureProject?(input: {
+    name: string;
+    platform?: string;
+  }): Promise<{
+    dsn: string;
+    alreadyExists: boolean;
+  }>;
+}
+interface Logs extends ProviderIdentity {
+  readonly key: "logs";
+  /** Returns the env var names the app reads at runtime for this provider. */
+  describe(): Promise<{
+    provider: string;
+    envKeys: string[];
+  }>;
+  /** Verify the token by fetching the target dataset's info. */
+  whoami?(): Promise<{
+    ok: boolean;
+    dataset: string;
+  }>;
+  /** Create the aggregation dataset if it does not already exist. Idempotent. */
+  ensureDataset?(name: string): Promise<{
+    alreadyExists: boolean;
+  }>;
+}
 interface ToolingDoctorReport {
   ok: boolean;
   message: string;
@@ -610,24 +646,6 @@ interface Analytics extends ProviderIdentity {
     alreadyExists: boolean;
   }>;
 }
-interface Observability extends ProviderIdentity {
-  readonly key: "observability";
-  /** Returns the env var names the app reads at runtime for this provider. */
-  describe(): Promise<{
-    provider: string;
-    envKeys: string[];
-  }>;
-  whoami?(): Promise<{
-    org: string;
-  }>;
-  ensureProject?(input: {
-    name: string;
-    platform?: string;
-  }): Promise<{
-    dsn: string;
-    alreadyExists: boolean;
-  }>;
-}
 interface WikiProvisionOpts {
   /** Project display name used in the wiki title (e.g. "Holocron"). */
   name?: string;
@@ -710,7 +728,8 @@ interface CapabilityImpls {
   tooling: Tooling;
   notifications: Notifications;
   analytics: Analytics;
-  observability: Observability;
+  errors: Errors;
+  logs: Logs;
   wiki: Wiki;
   workers: Workers;
 }
@@ -719,4 +738,4 @@ type CardinalityFor<K extends CapabilityKey> = (typeof CARDINALITY)[K];
 type ResolvedCapability<K extends CapabilityKey> = CardinalityFor<K> extends "many" ? CapabilityImpls[K][] : CapabilityImpls[K];
 declare function isMulti<K extends CapabilityKey>(key: K): CardinalityFor<K> extends "many" ? true : false;
 //#endregion
-export { Analytics, Auth, AuthDescription, AuthEvent, AuthEventType, AuthIdentity, AuthUser, CARDINALITY, CapabilityImpls, CapabilityKey, Cardinality, CardinalityFor, Ci, CiRun, CiRunFilter, CiRunStatus, ConnectionStringOptions, CreateAuthUserInput, Deployment, DeploymentProject, DeploymentProjectSettings, DeploymentRecord, DeploymentTarget, DeploymentTrigger, Dns, DnsRecord, DnsRecordType, EnsureResult, Environment, EnvironmentReviewer, Environments, Issue, IssueSearchFilter, Issues, LabelDef, LifecycleResult, LifecycleSlot, NormalizedAuthUser, Notifications, Observability, PagesConfig, ParseWebhookInput, ProviderApiError, ProviderIdentity, PullRequest, REQUIRED_CAPABILITIES, RepoRef, RepoSettings, ResolvedCapability, Ruleset, SecretScope, Secrets, Source, StatusCategory, Storage, StorageBranch, TeamEntry, TeamPermission, Tooling, ToolingDoctorReport, TrackerDoctorReport, TrackerUser, Vault, WebhookDashboardInfo, WebhookVerificationError, Wiki, WikiDnsRecord, WikiProvisionOpts, WikiProxyConfig, Workers, isMulti };
+export { Analytics, Auth, AuthDescription, AuthEvent, AuthEventType, AuthIdentity, AuthUser, CARDINALITY, CapabilityImpls, CapabilityKey, Cardinality, CardinalityFor, Ci, CiRun, CiRunFilter, CiRunStatus, ConnectionStringOptions, CreateAuthUserInput, Deployment, DeploymentProject, DeploymentProjectSettings, DeploymentRecord, DeploymentTarget, DeploymentTrigger, Dns, DnsRecord, DnsRecordType, EnsureResult, Environment, EnvironmentReviewer, Environments, Errors, Issue, IssueSearchFilter, Issues, LabelDef, LifecycleResult, LifecycleSlot, Logs, NormalizedAuthUser, Notifications, PagesConfig, ParseWebhookInput, ProviderApiError, ProviderIdentity, PullRequest, REQUIRED_CAPABILITIES, RepoRef, RepoSettings, ResolvedCapability, Ruleset, SecretScope, Secrets, Source, StatusCategory, Storage, StorageBranch, TeamEntry, TeamPermission, Tooling, ToolingDoctorReport, TrackerDoctorReport, TrackerUser, Vault, WebhookDashboardInfo, WebhookVerificationError, Wiki, WikiDnsRecord, WikiProvisionOpts, WikiProxyConfig, Workers, isMulti };

package/dist/plugin/capabilities.mjs

@@ -14,7 +14,8 @@ const CARDINALITY = {
 	tooling: "many",
 	notifications: "many",
 	analytics: "many",
-	observability: "many",
+	errors: "single",
+	logs: "single",
 	wiki: "single",
 	workers: "single"
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/cli",
-  "version": "3.53.0",
+  "version": "3.55.0",
   "description": "The Holocron CLI — a pluggable, capability-based orchestrator for spinning up and operating software projects.",
   "keywords": [
     "cli",
@@ -47,11 +47,12 @@
     "@theholocron/env-utils": "^1.6.0",
     "@theholocron/github-client": "^1.14.2",
     "@theholocron/http-client": "^1.14.2",
-    "@theholocron/registry-doc": "^1.8.0",
+    "@theholocron/registry-doc": "^1.10.0",
     "chalk": "^6.0.0",
     "ora": "^9.4.1",
     "tsx": "4.23.12",
-    "yargs": "^18.1.0"
+    "yargs": "^18.1.0",
+    "@theholocron/logger": "3.55.0"
   },
   "devDependencies": {
     "@theholocron/eslint-config": "^7.32.1",
@@ -67,7 +68,7 @@
     "tsdown": "^0.22.14",
     "typescript": "^5.9.3",
     "vitest": "^4.1.11",
-    "@theholocron/rollup-plugin-transform-template": "3.53.0"
+    "@theholocron/rollup-plugin-transform-template": "3.55.0"
   },
   "engines": {
     "node": ">=22.0.0"