@savvy-web/silk-effects 0.6.0 → 1.0.0

package/commitlint/static.js

@@ -0,0 +1,73 @@
+import { COMMIT_TYPES, COMMIT_TYPE_DEFINITIONS, DCO_SIGNOFF_TEXT, TDD_SCOPE_PATTERN, TDD_STATES } from "./config/rules.js";
+import { silkPlugin } from "./config/plugins.js";
+
+//#region src/commitlint/static.ts
+/**
+* Static commitlint configuration (no auto-detection).
+*
+* @remarks
+* Use this export when you don't need auto-detection features
+* and want a simple, static configuration. This is useful for:
+* - Projects that don't use workspaces
+* - CI environments where detection overhead is unwanted
+* - Cases where you want deterministic, unchanging configuration
+*
+* @example
+* ```typescript
+* // commitlint.config.ts
+* export { default } from "@savvy-web/commitlint/static";
+* ```
+*
+* @example
+* ```typescript
+* // With overrides
+* import config from "@savvy-web/commitlint/static";
+*
+* export default {
+*   ...config,
+*   rules: {
+*     ...config.rules,
+*     "scope-enum": [2, "always", ["api", "cli", "core"]],
+*   },
+* };
+* ```
+*/
+/**
+* Static commitlint configuration.
+*
+* @remarks
+* This configuration includes:
+* - Extended type enum with `ai` and `release` types
+* - Body max line length of 300 characters
+* - DCO signoff requirement
+* - Multiple scope support enabled
+* - Subject case rule disabled (allows AI-capitalized subjects)
+*
+* @public
+*/
+const staticConfig = {
+	extends: ["@commitlint/config-conventional"],
+	plugins: [silkPlugin],
+	rules: {
+		"body-max-line-length": [
+			2,
+			"always",
+			300
+		],
+		"type-enum": [
+			2,
+			"always",
+			[...COMMIT_TYPES]
+		],
+		"silk/signed-off-by": [2, "always"],
+		"silk/tdd-scope": [2, "always"],
+		"subject-case": [0]
+	},
+	prompt: { settings: {
+		enableMultipleScopes: true,
+		scopeEnumSeparator: ","
+	} }
+};
+
+//#endregion
+export { staticConfig as default };

package/errors/BiomeSyncError.js

@@ -0,0 +1,21 @@
+import { Data } from "effect";
+
+//#region src/errors/BiomeSyncError.ts
+/**
+* Raised when a Biome config file cannot be read or its `$schema` URL cannot be updated.
+*
+* @remarks
+* Returned by {@link BiomeSchemaSync.sync} and {@link BiomeSchemaSync.check} when
+* a `biome.json` or `biome.jsonc` file exists but cannot be read, contains invalid JSON,
+* or cannot be written back to disk.
+*
+* @since 0.1.0
+*/
+var BiomeSyncError = class extends Data.TaggedError("BiomeSyncError") {
+	get message() {
+		return `Failed to sync biome schema in ${this.path}: ${this.reason}`;
+	}
+};
+
+//#endregion
+export { BiomeSyncError };

package/errors/ChangesetConfigError.js

@@ -0,0 +1,20 @@
+import { Data } from "effect";
+
+//#region src/errors/ChangesetConfigError.ts
+/**
+* Raised when the `.changeset/config.json` file cannot be read or decoded.
+*
+* @remarks
+* Returned by {@link ChangesetConfigReader.read} when the file is missing,
+* contains invalid JSON, or fails Effect Schema validation.
+*
+* @since 0.1.0
+*/
+var ChangesetConfigError = class extends Data.TaggedError("ChangesetConfigError") {
+	get message() {
+		return `Failed to read changeset config at ${this.path}: ${this.reason}`;
+	}
+};
+
+//#endregion
+export { ChangesetConfigError };

package/errors/ConfigNotFoundError.js

@@ -0,0 +1,21 @@
+import { Data } from "effect";
+
+//#region src/errors/ConfigNotFoundError.ts
+/**
+* Raised when a config file cannot be located in any of the expected locations.
+*
+* @remarks
+* Returned by consumers that require a config file to exist. {@link ConfigDiscovery.find}
+* itself returns `null` instead of failing — callers that need a hard failure should
+* map `null` to this error.
+*
+* @since 0.1.0
+*/
+var ConfigNotFoundError = class extends Data.TaggedError("ConfigNotFoundError") {
+	get message() {
+		return `Config '${this.name}' not found. Searched: ${this.searchedPaths.join(", ")}`;
+	}
+};
+
+//#endregion
+export { ConfigNotFoundError };

package/errors/SectionParseError.js

@@ -0,0 +1,16 @@
+import { Data } from "effect";
+
+//#region src/errors/SectionParseError.ts
+/**
+* Raised when a managed section cannot be parsed from a file.
+*
+* @since 0.2.0
+*/
+var SectionParseError = class extends Data.TaggedError("SectionParseError") {
+	get message() {
+		return `Failed to parse section in ${this.path}: ${this.reason}`;
+	}
+};
+
+//#endregion
+export { SectionParseError };

package/errors/SectionValidationError.js

@@ -0,0 +1,16 @@
+import { Data } from "effect";
+
+//#region src/errors/SectionValidationError.ts
+/**
+* Raised when a {@link SectionBlock} fails validation at creation time.
+*
+* @since 0.2.0
+*/
+var SectionValidationError = class extends Data.TaggedError("SectionValidationError") {
+	get message() {
+		return `Section validation failed for ${this.toolName}: ${this.reason}`;
+	}
+};
+
+//#endregion
+export { SectionValidationError };

package/errors/SectionWriteError.js

@@ -0,0 +1,16 @@
+import { Data } from "effect";
+
+//#region src/errors/SectionWriteError.ts
+/**
+* Raised when a managed section cannot be written to a file.
+*
+* @since 0.2.0
+*/
+var SectionWriteError = class extends Data.TaggedError("SectionWriteError") {
+	get message() {
+		return `Failed to write section to ${this.path}: ${this.reason}`;
+	}
+};
+
+//#endregion
+export { SectionWriteError };

package/errors/TagFormatError.js

@@ -0,0 +1,20 @@
+import { Data } from "effect";
+
+//#region src/errors/TagFormatError.ts
+/**
+* Raised when a git tag string cannot be formatted for the given package name and version.
+*
+* @remarks
+* Returned by {@link TagStrategy.formatTag} when the `version` argument is an empty string
+* or another invariant prevents tag construction.
+*
+* @since 0.1.0
+*/
+var TagFormatError = class extends Data.TaggedError("TagFormatError") {
+	get message() {
+		return `Failed to format tag for ${this.name}@${this.version}: ${this.reason}`;
+	}
+};
+
+//#endregion
+export { TagFormatError };

package/errors/ToolNotFoundError.js

@@ -0,0 +1,11 @@
+import { Data } from "effect";
+
+//#region src/errors/ToolNotFoundError.ts
+var ToolNotFoundError = class extends Data.TaggedError("ToolNotFoundError") {
+	get message() {
+		return `Tool not found: ${this.name} — ${this.reason}`;
+	}
+};
+
+//#endregion
+export { ToolNotFoundError };

package/errors/ToolResolutionError.js

@@ -0,0 +1,11 @@
+import { Data } from "effect";
+
+//#region src/errors/ToolResolutionError.ts
+var ToolResolutionError = class extends Data.TaggedError("ToolResolutionError") {
+	get message() {
+		return `Tool resolution failed: ${this.name} — ${this.reason}`;
+	}
+};
+
+//#endregion
+export { ToolResolutionError };

package/errors/ToolVersionMismatchError.js

@@ -0,0 +1,11 @@
+import { Data } from "effect";
+
+//#region src/errors/ToolVersionMismatchError.ts
+var ToolVersionMismatchError = class extends Data.TaggedError("ToolVersionMismatchError") {
+	get message() {
+		return `Tool version mismatch: ${this.name} — global ${this.globalVersion} vs local ${this.localVersion}`;
+	}
+};
+
+//#endregion
+export { ToolVersionMismatchError };

package/errors/VersioningDetectionError.js

@@ -0,0 +1,20 @@
+import { Data } from "effect";
+
+//#region src/errors/VersioningDetectionError.ts
+/**
+* Raised when the versioning strategy cannot be determined from the workspace state.
+*
+* @remarks
+* Returned by {@link VersioningStrategy.detect} when an unexpected condition
+* prevents strategy classification.
+*
+* @since 0.1.0
+*/
+var VersioningDetectionError = class extends Data.TaggedError("VersioningDetectionError") {
+	get message() {
+		return `Failed to detect versioning strategy: ${this.reason}`;
+	}
+};
+
+//#endregion
+export { VersioningDetectionError };

package/errors/WorkspaceAnalysisError.js

@@ -0,0 +1,21 @@
+import { Data } from "effect";
+
+//#region src/errors/WorkspaceAnalysisError.ts
+/**
+* Raised when workspace analysis fails for a given root directory.
+*
+* @remarks
+* Returned by {@link SilkWorkspaceAnalyzer.analyze} when the analysis pipeline
+* encounters an unrecoverable error — e.g. workspace discovery failure,
+* package manager detection failure, or publishability detection errors.
+*
+* @since 0.2.0
+*/
+var WorkspaceAnalysisError = class extends Data.TaggedError("WorkspaceAnalysisError") {
+	get message() {
+		return `Workspace analysis failed at ${this.root}: ${this.reason}`;
+	}
+};
+
+//#endregion
+export { WorkspaceAnalysisError };