@theholocron/cli 2.0.0-alpha.41 → 2.0.0-alpha.43

package/dist/capabilities/index.d.mts

@@ -66,6 +66,11 @@ interface RepoRef {
   name: string;
   defaultBranch: string;
 }
+interface LabelDef {
+  readonly name: string;
+  readonly color: string;
+  readonly description: string;
+}
 interface Source extends ProviderIdentity {
   readonly key: "source";
   /** Auth sanity-check. Throws ProviderApiError on auth failure. */
@@ -116,6 +121,12 @@ interface Source extends ProviderIdentity {
    * (e.g. `.github/dependabot.yml`).
    */
   writeRepoFile(path: string, contents: string): Promise<void>;
+  /**
+   * Idempotently sync repo labels to a canonical set. Creates missing
+   * labels, patches color/description drift, deletes stale labels.
+   * Optional — providers that have no label concept omit this.
+   */
+  syncLabels?(canonical: ReadonlyArray<LabelDef>, stale: ReadonlyArray<string>): Promise<string>;
 }
 type CiRunStatus = "queued" | "in_progress" | "completed" | "cancelled" | "failure" | "success" | "skipped";
 interface CiRun {
@@ -528,4 +539,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, 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 };
+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, 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/cli.mjs

@@ -957,6 +957,7 @@ jobs:
     name: Add Labels to PRs
     permissions:
       contents: read
+      issues: write
       pull-requests: write
     runs-on: ubuntu-latest
     timeout-minutes: 5
@@ -1902,6 +1903,7 @@ on: # yamllint disable-line rule:truthy
 
 permissions:
   contents: read
+  issues: write
   pull-requests: write
 
 jobs:
@@ -3746,6 +3748,100 @@ const ALEX_CONFIG = JSON.stringify({ allow: [
 	"husky",
 	"period"
 ] }, null, 2) + "\n";
+const CANONICAL_LABELS = [
+	{
+		name: "bug",
+		color: "d73a4a",
+		description: "Something isn't working"
+	},
+	{
+		name: "chore",
+		color: "ededed",
+		description: "Maintenance, no user-facing change"
+	},
+	{
+		name: "ci",
+		color: "0075ca",
+		description: "CI/CD pipeline changes"
+	},
+	{
+		name: "dependencies",
+		color: "0366d6",
+		description: "Dependency update"
+	},
+	{
+		name: "documentation",
+		color: "0075ca",
+		description: "Documentation only"
+	},
+	{
+		name: "duplicate",
+		color: "cfd3d7",
+		description: "Already reported"
+	},
+	{
+		name: "enhancement",
+		color: "a2eeef",
+		description: "New feature or request"
+	},
+	{
+		name: "good first issue",
+		color: "7057ff",
+		description: "Good for newcomers"
+	},
+	{
+		name: "help wanted",
+		color: "008672",
+		description: "Extra attention needed"
+	},
+	{
+		name: "invalid",
+		color: "e4e669",
+		description: "Doesn't seem right"
+	},
+	{
+		name: "performance",
+		color: "fbca04",
+		description: "Performance improvement"
+	},
+	{
+		name: "question",
+		color: "d876e3",
+		description: "Further information requested"
+	},
+	{
+		name: "refactor",
+		color: "cfd3d7",
+		description: "Code restructuring"
+	},
+	{
+		name: "released",
+		color: "ededed",
+		description: "Included in a release"
+	},
+	{
+		name: "test",
+		color: "bfd4f2",
+		description: "Test-related changes"
+	},
+	{
+		name: "triage",
+		color: "e4e669",
+		description: "Needs investigation"
+	},
+	{
+		name: "wontfix",
+		color: "ffffff",
+		description: "Won't be addressed"
+	}
+];
+const STALE_LABELS = [
+	"github_actions",
+	"javascript",
+	"autorelease: pending",
+	"autorelease: tagged",
+	"released on @alpha"
+];
 function labelerConfig() {
 	return [
 		`# AUTO-GENERATED — do not edit directly.`,
@@ -3757,6 +3853,12 @@ function labelerConfig() {
 		`bug:`,
 		`  - '^fix'`,
 		``,
+		`chore:`,
+		`  - '^chore(?!\\(deps)'`,
+		``,
+		`ci:`,
+		`  - '^ci'`,
+		``,
 		`dependencies:`,
 		`  - '^chore\\(deps'`,
 		``,
@@ -3766,8 +3868,14 @@ function labelerConfig() {
 		`enhancement:`,
 		`  - '^feat'`,
 		``,
-		`github_actions:`,
-		`  - '^ci'`,
+		`performance:`,
+		`  - '^perf'`,
+		``,
+		`refactor:`,
+		`  - '^refactor'`,
+		``,
+		`test:`,
+		`  - '^test'`,
 		``
 	].join("\n");
 }
@@ -4025,6 +4133,12 @@ async function runSetup(input) {
 			await source.writeRepoFile(".editorconfig-checker.json", EDITORCONFIG_CHECKER_CONFIG);
 		}));
 		print(formatStep(steps[steps.length - 1]));
+		if (source.syncLabels) {
+			steps.push(await runStep("source", "sync labels", dryRun, async () => {
+				return source.syncLabels(CANONICAL_LABELS, STALE_LABELS);
+			}));
+			print(formatStep(steps[steps.length - 1]));
+		}
 	}
 	if (loader.has("environments")) {
 		const envs = loader.get("environments");

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-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, 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 } from "./capabilities/index.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, Issue, IssueSearchFilter, Issues, LabelDef, 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 } from "./capabilities/index.mjs";
 import { AuthError, RequestOptions, ResolveTokenConfig as ResolveTokenConfig$1, ResolveTokenInput, RestClient, RestClientConfig, createRestClient } from "@theholocron/http-client";
 
 //#region src/auth-resolver.d.ts
@@ -190,4 +190,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, DoctorConfig, EnsureResult, Environment, EnvironmentReviewer, Environments, HolocronConfig, Issue, IssueSearchFilter, Issues, LifecycleResult, LifecycleSlot, LoadedConfig, MultiEntry, NormalizedAuthUser, Notifications, Observability, ParseWebhookInput, ProviderApiError, ProviderIdentity, ProviderOptions, REQUIRED_CAPABILITIES, RawProviderEntry, RawProvidersConfig, RepoPolicyConfig, RepoRef, RepoSettings, type RequestOptions, ResolveTokenConfig, type ResolveTokenInput, ResolvedCapability, ResolvedHolocronConfig, ResolvedProviderEntry, ResolvedProvidersConfig, ResolvedTuple, type RestClient, type RestClientConfig, Ruleset, SecretScope, Secrets, SingleEntry, Source, StatusCategory, Storage, StorageBranch, Tooling, ToolingDoctorReport, TrackerDoctorReport, TrackerUser, Vault, WebhookDashboardInfo, WebhookVerificationError, 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, DoctorConfig, EnsureResult, Environment, EnvironmentReviewer, Environments, HolocronConfig, Issue, IssueSearchFilter, Issues, LabelDef, LifecycleResult, LifecycleSlot, LoadedConfig, MultiEntry, NormalizedAuthUser, Notifications, Observability, ParseWebhookInput, ProviderApiError, ProviderIdentity, ProviderOptions, REQUIRED_CAPABILITIES, RawProviderEntry, RawProvidersConfig, RepoPolicyConfig, RepoRef, RepoSettings, type RequestOptions, ResolveTokenConfig, type ResolveTokenInput, ResolvedCapability, ResolvedHolocronConfig, ResolvedProviderEntry, ResolvedProvidersConfig, ResolvedTuple, type RestClient, type RestClientConfig, Ruleset, SecretScope, Secrets, SingleEntry, Source, StatusCategory, Storage, StorageBranch, Tooling, ToolingDoctorReport, TrackerDoctorReport, TrackerUser, Vault, WebhookDashboardInfo, WebhookVerificationError, createResolveToken, createRestClient, defineConfig, deleteToken, getToken, isMulti, listStoredProviders, loadConfig, resolveConfig, resolveEntry, resolvePluginPackage, setToken };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/cli",
-  "version": "2.0.0-alpha.41",
+  "version": "2.0.0-alpha.43",
   "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",