@theholocron/cli 3.21.0 → 3.22.1

package/dist/index.d.mts

@@ -170,14 +170,38 @@ interface ChromaticProjectConfig {
   exitZeroOnChanges?: boolean;
 }
 /**
- * Typed `with:` inputs for the `test` reusable workflow.
+ * A single Storybook app in a deploy workflow config.
+ * `name` becomes the sandbox sub-path (`_site/sandbox/<name>/`);
+ * `path` is the working directory relative to the repo root.
+ */
+interface StorybookDeployProject {
+  name: string;
+  path: string;
+}
+/**
+ * Typed `with:` inputs for reusable workflows.
+ *
  * `run-chromatic` accepts either a plain boolean (single-project) or a
  * `ChromaticProjectConfig[]` object (multi-project monorepo).
+ *
+ * `docs` / `storybook` are high-level deploy shorthand that `holocron setup`
+ * translates to `type` / `storybook-projects` before writing the thin caller.
+ * They also drive automatic `paths:` derivation so you never need to write
+ * `paths:` manually for deploy entries.
  */
 type WorkflowWithConfig = Record<string, unknown> & {
   "run-chromatic"?: boolean | {
     projects: ChromaticProjectConfig[];
   };
+  /**
+   * Docs deployment shorthand. `true` uses the org-standard `docs/` directory;
+   * `{ path: "custom" }` uses a custom directory. Both derive a `paths:` entry automatically.
+   */
+  docs?: true | {
+    path: string;
+  };
+  /** Storybook apps to deploy alongside docs. Each entry's `path` is appended to `paths:`. */
+  storybook?: StorybookDeployProject[];
 };
 interface HolocronConfig {
   /** Project name. Derived from package.json when absent. */
@@ -199,14 +223,35 @@ interface HolocronConfig {
    *
    * Supported values: "lint" | "test" | "typecheck" | "codeql" | "review" |
    *   "release" | "stale" | "greetings" | "dependencies" | "bookkeeping" | "audit" |
-   *   "deploy-docs"
+   *   "deploy"
    *
    * `holocron setup` writes `.github/workflows/<name>.yml` for each entry,
-   * calling the corresponding `ci-<name>.yml@main` reusable workflow.
+   * calling the corresponding reusable workflow in `theholocron/.github`.
    * Files are overwritten on each run — they are generated artifacts.
    *
-   * Use `paths` to append additional `on.push.paths` entries beyond the
-   * template default (e.g. the repo-specific docs content package path).
+   * ### deploy workflow
+   * Use `docs` and/or `storybook` in `with:` — setup derives `paths:` automatically.
+   * `docs: true` uses the org-standard `docs/` directory; `docs: { path: "custom" }` overrides it.
+   *
+   * ```ts
+   * // Docs only (standard layout)
+   * { name: "deploy", with: { docs: true } }
+   *
+   * // Docs + monorepo storybooks
+   * {
+   *   name: "deploy",
+   *   with: {
+   *     docs: true,
+   *     storybook: [
+   *       { name: "web", path: "apps/web" },
+   *       { name: "ui", path: "packages/ui" },
+   *     ],
+   *   },
+   * }
+   *
+   * // Non-standard docs location
+   * { name: "deploy", with: { docs: { path: "packages/site" } } }
+   * ```
    *
    * ### run-chromatic
    * For a single-project repo, use `"run-chromatic": true` with a
@@ -228,7 +273,7 @@ interface HolocronConfig {
    *
    * @example
    * ["lint", { "name": "release", "with": { "run-build": false } }]
-   * { "name": "deploy-docs", "with": { "name": "configs" }, "paths": ["packages/configs-docs/**"] }
+   * { "name": "deploy", "with": { "docs": true } }
    */
   workflows?: Array<string | {
     name: string;
@@ -389,4 +434,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, ChromaticProjectConfig, 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, WorkflowWithConfig, 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, ChromaticProjectConfig, 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, StorybookDeployProject, TeamEntry, TeamPermission, Tooling, ToolingDoctorReport, TrackerDoctorReport, TrackerUser, Vault, WebhookDashboardInfo, WebhookVerificationError, WorkflowWithConfig, createEnvLookup, createFeatureResolver, createResolveToken, createRestClient, defineConfig, deleteToken, getToken, isMulti, listStoredProviders, loadConfig, resolveConfig, resolveEntry, resolvePluginPackage, setToken };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/cli",
-  "version": "3.21.0",
+  "version": "3.22.1",
   "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",
@@ -37,23 +37,23 @@
     "@inquirer/prompts": "^8.5.2",
     "@napi-rs/keyring": "^1.3.0",
     "@sentry/node": "^10.69.0",
-    "@theholocron/github-client": "^1.6.0",
-    "@theholocron/http-client": "^1.6.0",
+    "@theholocron/github-client": "^1.6.2",
+    "@theholocron/http-client": "^1.6.6",
     "chalk": "^6.0.0",
     "ora": "^9.4.1",
     "tsx": "4.22.4",
     "yargs": "^18.1.0"
   },
   "devDependencies": {
-    "@theholocron/eslint-config": "^7.8.1",
-    "@theholocron/tsconfig": "^7.8.1",
-    "@theholocron/vitest-config": "^7.8.1",
+    "@theholocron/eslint-config": "^7.16.0",
+    "@theholocron/tsconfig": "^7.16.0",
+    "@theholocron/vitest-config": "^7.16.0",
     "@types/node": "^26",
     "@types/yargs": "^17.0.35",
     "@vitest/coverage-v8": "^4.1.10",
-    "@vitest/eslint-plugin": "^1.6.25",
-    "eslint": "^10.8.0",
-    "eslint-plugin-n": "^18.2.2",
+    "@vitest/eslint-plugin": "^1.6.27",
+    "eslint": "^10.8.1",
+    "eslint-plugin-n": "^18.3.0",
     "globals": "^17.9.0",
     "tsdown": "^0.22.14",
     "typescript": "^5.9.3",