@theholocron/cli 1.0.0 → 2.0.0-alpha.0

package/README.md

@@ -1,17 +1,24 @@
-# Holocron
+# `@theholocron/cli`
 
-The command-line client designed to support [The Holocron](http://docs.theholocron.dev).
+The Holocron CLI — a pluggable, capability-based orchestrator for
+spinning up and operating software projects.
 
-## Installation
+## Status
 
-```bash
-npm install --global @theholocron/cli
-```
+**v2 alpha.** The shape is being built up per
+[`.notes/tech-architecture.spec.md`](../../.notes/tech-architecture.spec.md).
+Most commands aren't wired yet.
 
-## Usage
+## What's in here
 
-<!-- fill out the usage with examples -->
+- `src/capabilities/` — the 14 capability interfaces that providers
+  implement
+- `src/config.ts` — `holocron.config.json` parser + plugin resolution
+- `src/cli.ts` — yargs entry, dispatches subcommands (WIP)
 
-## Documentation
+## Install (when published)
 
-Check out [The Holocron Archive](https://docs.theholocron.dev/projects/holocron/) for more information.
+```bash
+pnpm add -D @theholocron/cli
+pnpm holocron --help
+```

package/dist/capabilities/index.d.mts

@@ -0,0 +1,2 @@
+import { $ as Tooling, A as Environments, B as ProviderApiError, C as DeploymentTarget, D as DnsRecordType, E as DnsRecord, F as LifecycleSlot, G as ResolvedCapability, H as REQUIRED_CAPABILITIES, I as NormalizedAuthUser, J as Secrets, K as Ruleset, L as Notifications, M as IssueSearchFilter, N as Issues, O as Environment, P as LifecycleResult, Q as StorageBranch, R as Observability, S as DeploymentRecord, T as Dns, U as RepoRef, V as ProviderIdentity, W as RepoSettings, X as StatusCategory, Y as Source, Z as Storage, _ as ConnectionStringOptions, a as AuthEventType, at as WebhookVerificationError, b as DeploymentProject, c as CARDINALITY, d as Cardinality, et as ToolingDoctorReport, f as CardinalityFor, g as CiRunStatus, h as CiRunFilter, i as AuthEvent, it as WebhookDashboardInfo, j as Issue, k as EnvironmentReviewer, l as CapabilityImpls, m as CiRun, n as Auth, nt as TrackerUser, o as AuthIdentity, ot as isMulti, p as Ci, q as SecretScope, r as AuthDescription, rt as Vault, s as AuthUser, t as Analytics, tt as TrackerDoctorReport, u as CapabilityKey, v as CreateAuthUserInput, w as DeploymentTrigger, x as DeploymentProjectSettings, y as Deployment, z as ParseWebhookInput } from "../index-DDxKXqtR.mjs";
+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, Environment, EnvironmentReviewer, Environments, Issue, IssueSearchFilter, Issues, LifecycleResult, LifecycleSlot, NormalizedAuthUser, Notifications, Observability, ParseWebhookInput, ProviderApiError, ProviderIdentity, REQUIRED_CAPABILITIES, RepoRef, RepoSettings, ResolvedCapability, Ruleset, SecretScope, Secrets, Source, StatusCategory, Storage, StorageBranch, Tooling, ToolingDoctorReport, TrackerDoctorReport, TrackerUser, Vault, WebhookDashboardInfo, WebhookVerificationError, isMulti };

package/dist/capabilities/index.mjs

@@ -0,0 +1,2 @@
+import { a as isMulti, i as WebhookVerificationError, n as ProviderApiError, r as REQUIRED_CAPABILITIES, t as CARDINALITY } from "../capabilities-QjjhVlDd.mjs";
+export { CARDINALITY, ProviderApiError, REQUIRED_CAPABILITIES, WebhookVerificationError, isMulti };

package/dist/capabilities-QjjhVlDd.mjs

@@ -0,0 +1,43 @@
+//#region src/capabilities/index.ts
+const CARDINALITY = {
+	source: "single",
+	ci: "single",
+	secrets: "single",
+	environments: "single",
+	issues: "single",
+	deployment: "single",
+	storage: "single",
+	auth: "single",
+	vault: "single",
+	dns: "single",
+	tooling: "many",
+	notifications: "many",
+	analytics: "many",
+	observability: "many"
+};
+/** Vault is required; everything else is optional in the config. */
+const REQUIRED_CAPABILITIES = ["vault"];
+/**
+* Surfaced from every capability call that hits a vendor API. Wraps
+* the underlying error with `status` (HTTP) and `details` so
+* orchestrators (`holocron setup`, `doctor`) can soft-skip rather
+* than abort.
+*/
+var ProviderApiError = class extends Error {
+	status;
+	details;
+	name = "ProviderApiError";
+	constructor(message, status, details) {
+		super(message);
+		this.status = status;
+		this.details = details;
+	}
+};
+var WebhookVerificationError = class extends Error {
+	name = "WebhookVerificationError";
+};
+function isMulti(key) {
+	return CARDINALITY[key] === "many";
+}
+//#endregion
+export { isMulti as a, WebhookVerificationError as i, ProviderApiError as n, REQUIRED_CAPABILITIES as r, CARDINALITY as t };

package/dist/cli.d.mts

@@ -0,0 +1 @@
+export { };