@savvy-web/silk-effects 1.4.0 → 1.5.0

package/index.d.ts

@@ -2192,7 +2192,6 @@ declare const changelogFunctions: ChangelogFunctions;
  *
  * @see {@link https://effect.website/docs/data-types/data#taggerror | Effect TaggedError documentation}
  *
- * @packageDocumentation
  */
 /**
  * Base class for {@link ChangesetValidationError}.
@@ -2531,10 +2530,11 @@ declare const ChangesetConfigError_base: new <A extends Record<string, any> = {}
  * Raised when the `.changeset/config.json` file cannot be read or decoded.
  *
  * @remarks
- * Returned by {@link ChangesetConfigReader.read} when the file is missing,
+ * Returned by `ChangesetConfigReader.read` when the file is missing,
  * contains invalid JSON, or fails Effect Schema validation.
  *
  * @since 0.1.0
+ * @public
  */
 declare class ChangesetConfigError extends ChangesetConfigError_base<{
   readonly path: string;
@@ -2549,11 +2549,12 @@ declare class ChangesetConfigError extends ChangesetConfigError_base<{
  *
  * @remarks
  * Represents the parsed `.changeset/config.json` file. All fields are optional
- * to allow partial configs. Use {@link SilkChangesetConfigFile} when the Silk changelog
+ * to allow partial configs. Use {@link (SilkChangesetConfigFile:type)} when the Silk changelog
  * adapter is detected.
  *
  * @since 0.1.0
  */
+/** @public */
 declare const ChangesetConfigFile: Schema.Struct<{
   changelog: Schema.optional<Schema.Union<[typeof Schema.String, Schema.Array$<typeof Schema.Unknown>, Schema.Literal<[false]>]>>;
   commit: Schema.optional<Schema.Union<[typeof Schema.Boolean, typeof Schema.String, Schema.Array$<typeof Schema.Unknown>]>>;
@@ -2575,18 +2576,22 @@ declare const ChangesetConfigFile: Schema.Struct<{
     prereleaseTemplate: Schema.optional<typeof Schema.String>;
   }>>;
 }>;
-/** @since 0.1.0 */
+/**
+ * @since 0.1.0
+ * @public
+ */
 type ChangesetConfigFile = typeof ChangesetConfigFile.Type;
 /**
  * Extended changeset config for repos using the `@savvy-web/changesets` changelog adapter.
  *
  * @remarks
- * Extends {@link ChangesetConfigFile} with a `_isSilk` marker flag that is automatically
+ * Extends {@link (ChangesetConfigFile:type)} with a `_isSilk` marker flag that is automatically
  * set to `true`. Detected by {@link ChangesetConfigReader} when the `changelog` field
  * references `@savvy-web/changesets`.
  *
  * @since 0.1.0
  */
+/** @public */
 declare const SilkChangesetConfigFile: Schema.extend<Schema.Struct<{
   changelog: Schema.optional<Schema.Union<[typeof Schema.String, Schema.Array$<typeof Schema.Unknown>, Schema.Literal<[false]>]>>;
   commit: Schema.optional<Schema.Union<[typeof Schema.Boolean, typeof Schema.String, Schema.Array$<typeof Schema.Unknown>]>>;
@@ -2612,7 +2617,10 @@ declare const SilkChangesetConfigFile: Schema.extend<Schema.Struct<{
     default: () => true;
   }>;
 }>>;
-/** @since 0.1.0 */
+/**
+ * @since 0.1.0
+ * @public
+ */
 type SilkChangesetConfigFile = typeof SilkChangesetConfigFile.Type;
 /**
  * Versioning strategy classification for a workspace.
@@ -2623,25 +2631,33 @@ type SilkChangesetConfigFile = typeof SilkChangesetConfigFile.Type;
  * - `"independent"` — multiple publishable packages with independent version bumps.
  *
  * @since 0.1.0
+ * @public
  */
 declare const VersioningStrategyType: Schema.Literal<["single", "fixed-group", "independent"]>;
-/** @since 0.1.0 */
+/**
+ * @since 0.1.0
+ * @public
+ */
 type VersioningStrategyType = typeof VersioningStrategyType.Type;
 /**
  * Output of the versioning strategy detection, combining the strategy type with group metadata.
  *
  * @remarks
- * Produced by {@link VersioningStrategy.detect} and consumed by {@link TagStrategy.determine}
+ * Produced by `VersioningStrategy.detect` and consumed by `TagStrategy.determine`
  * to decide on the appropriate git-tag format.
  *
  * @since 0.1.0
+ * @public
  */
 declare const VersioningStrategyResult: Schema.Struct<{
   type: Schema.Literal<["single", "fixed-group", "independent"]>;
   fixedGroups: Schema.Array$<Schema.Array$<typeof Schema.String>>;
   publishablePackages: Schema.Array$<typeof Schema.String>;
 }>;
-/** @since 0.1.0 */
+/**
+ * @since 0.1.0
+ * @public
+ */
 type VersioningStrategyResult = typeof VersioningStrategyResult.Type;
 //#endregion
 //#region src/services/ChangesetConfigReader.d.ts
@@ -2661,8 +2677,8 @@ declare const ChangesetConfigReader_base: Context.TagClass<ChangesetConfigReader
  *
  * @remarks
  * Automatically detects whether the config uses the Silk changelog adapter
- * (`@savvy-web/changesets`) and decodes as {@link SilkChangesetConfigFile} or the
- * standard {@link ChangesetConfigFile} accordingly.
+ * (`@savvy-web/changesets`) and decodes as {@link (SilkChangesetConfigFile:type)} or the
+ * standard {@link (ChangesetConfigFile:type)} accordingly.
  *
  * @example
  * ```typescript
@@ -2678,6 +2694,7 @@ declare const ChangesetConfigReader_base: Context.TagClass<ChangesetConfigReader
  * ```
  *
  * @since 0.1.0
+ * @public
  */
 declare class ChangesetConfigReader extends ChangesetConfigReader_base {}
 /**
@@ -2688,6 +2705,7 @@ declare class ChangesetConfigReader extends ChangesetConfigReader_base {}
  * `BunContext.layer` to satisfy this dependency.
  *
  * @since 0.1.0
+ * @public
  */
 declare const ChangesetConfigReaderLive: Layer.Layer<ChangesetConfigReader, never, FileSystem.FileSystem>;
 //#endregion
@@ -2821,7 +2839,7 @@ declare class ConfigInspector extends ConfigInspectorBase {}
 /**
  * Live layer for {@link ConfigInspector}.
  *
- * Requires {@link ChangesetConfigReader} and {@link WorkspaceDiscovery}
+ * Requires {@link ChangesetConfigReader} and `WorkspaceDiscovery`
  * in the environment.
  *
  * @public
@@ -4333,7 +4351,7 @@ declare function serializeDependencyTableToMarkdown(rows: DependencyTableRow[]):
  * Compute the set of currently-publishable workspace package names.
  *
  * @remarks
- * Uses the currently-active {@link PublishabilityDetector} — wire the
+ * Uses the currently-active {@link SilkPublishability} — wire the
  * {@link SilkPublishabilityDetectorLive} layer to get silk semantics.
  *
  * @param packages - The workspace packages to evaluate
@@ -5373,7 +5391,7 @@ interface ConfigOptions {
  *
  * @public
  */
-type RuleSeverity$1 = 0 | 1 | 2;
+type RuleSeverity = 0 | 1 | 2;
 /**
  * Rule applicability.
  *
@@ -5385,7 +5403,7 @@ type RuleApplicability = "always" | "never";
  *
  * @public
  */
-type RuleConfigTuple<T = unknown> = readonly [RuleSeverity$1] | readonly [RuleSeverity$1, RuleApplicability] | readonly [RuleSeverity$1, RuleApplicability, T];
+type RuleConfigTuple<T = unknown> = readonly [RuleSeverity] | readonly [RuleSeverity, RuleApplicability] | readonly [RuleSeverity, RuleApplicability, T];
 /**
  * Commitlint rules configuration.
  *
@@ -6067,15 +6085,15 @@ declare function buildSigningDiagnostic(raw: RawSigningInputs): SigningDiagnosti
 declare function readSigningDiagnostic(): Effect.Effect<SigningDiagnostic>;
 //#endregion
 //#region src/commitlint/hook/rules/types.d.ts
-type RuleSeverity = "deny" | "advise";
+type RuleSeverity$1 = "deny" | "advise";
 interface RuleHit {
   ruleId: string;
-  severity: RuleSeverity;
+  severity: RuleSeverity$1;
   message: string;
 }
 interface Rule<Input, Ctx, E = never, R = never> {
   id: string;
-  severity: RuleSeverity;
+  severity: RuleSeverity$1;
   check: (input: Input, ctx: Ctx) => Effect.Effect<RuleHit | null, E, R>;
 }
 declare function partitionHits(hits: ReadonlyArray<RuleHit>): {
@@ -6129,7 +6147,7 @@ declare const VERBOSITY_LINE_THRESHOLD = 25;
 declare const VERBOSITY_WORD_THRESHOLD = 400;
 declare const verbosityRule: Rule<VerbosityInput, never>;
 declare namespace index_d_exports$1 {
-  export { BranchInfo, COMMIT_TYPES, COMMIT_TYPE_DEFINITIONS, ClosesTrailerCtx, ClosesTrailerInput, CommitType, CommitTypeDefinition, CommitlintConfig, CommitlintPlugin, CommitlintUserConfig, ConfigOptions, DCO_SIGNOFF_TEXT, DEFAULT_BODY_MAX_LINE_LENGTH, ERROR_EXPLANATIONS, ERROR_SUGGESTIONS, ForbiddenContentInput, FormatterResult, HookOutput, RuleSeverity as HookRuleSeverity, HookSilencer, ISSUES_CACHE_RELATIVE_PATH, ISSUES_CACHE_TTL_SECONDS, Inquirer, LintOutcome, LockfilePresence, OpenIssue, PackageManager$1 as PackageManager, ParsedCommit, ParsedKind, PlanLeakageInput, PostToolUseEnvelope, PostToolUseEnvelope as PostToolUseEnvelopeType, PreToolUseEnvelope, PreToolUseEnvelope as PreToolUseEnvelopeType, PromptConfig, PromptConfigOptions, PromptQuestion, PromptSettings, PrompterOptions, Question, RawSigningInputs, ReleaseFormat, ResolvedPromptConfig, Rule, RuleApplicability, RuleConfigTuple, RuleHit, RuleResult, RuleSeverity$1 as RuleSeverity, RulesConfig, SessionStartEnvelope, SessionStartEnvelope as SessionStartEnvelopeType, SigningDiagnostic, SigningFlagCtx, SigningFlagInput, SoftWrapInput, TDD_SCOPE_PATTERN, TDD_STATES, TYPE_EMOJIS, TYPE_EMOJIS_UNICODE, TypeEnumEntry, VERBOSITY_LINE_THRESHOLD, VERBOSITY_WORD_THRESHOLD, VerbosityInput, buildSigningDiagnostic, closesTrailerRule, createPromptConfig, createTypeEnum, CommitlintConfig as default, defaultPromptConfig, detectDCO, detectFromLockfiles, detectPackageManager, detectScopes, emojiPromptConfig, fetchAndCacheOpenIssues, forbiddenContentRule, format, getExplanation, getSuggestion, getTypeEmoji, hasClosingTrailer, inferTicketId, parseBashCommand, parseGpgKeyExpiry, parseHuskyConfigPath, parsePackageManagerField, partitionHits, planLeakageRule, postToolUseAdvise, preToolUseAdvise, preToolUseAllow, preToolUseDeny, preToolUseSilent, prompter, readBranchInfo, readCache, readCommitlintConfigPath, readOpenIssuesFromCache, readOrFetchOpenIssues, readSigningDiagnostic, sessionStartContext, signingFlagConflictRule, softWrapRule, staticConfig, verbosityRule, writeCache };
+  export { BranchInfo, COMMIT_TYPES, COMMIT_TYPE_DEFINITIONS, ClosesTrailerCtx, ClosesTrailerInput, CommitType, CommitTypeDefinition, CommitlintConfig, CommitlintPlugin, CommitlintUserConfig, ConfigOptions, DCO_SIGNOFF_TEXT, DEFAULT_BODY_MAX_LINE_LENGTH, ERROR_EXPLANATIONS, ERROR_SUGGESTIONS, ForbiddenContentInput, FormatterResult, HookOutput, RuleSeverity$1 as HookRuleSeverity, HookSilencer, ISSUES_CACHE_RELATIVE_PATH, ISSUES_CACHE_TTL_SECONDS, Inquirer, LintOutcome, LockfilePresence, OpenIssue, PackageManager$1 as PackageManager, ParsedCommit, ParsedKind, PlanLeakageInput, PostToolUseEnvelope, PostToolUseEnvelope as PostToolUseEnvelopeType, PreToolUseEnvelope, PreToolUseEnvelope as PreToolUseEnvelopeType, PromptConfig, PromptConfigOptions, PromptQuestion, PromptSettings, PrompterOptions, Question, RawSigningInputs, ReleaseFormat, ResolvedPromptConfig, Rule, RuleApplicability, RuleConfigTuple, RuleHit, RuleResult, RuleSeverity, RulesConfig, SessionStartEnvelope, SessionStartEnvelope as SessionStartEnvelopeType, SigningDiagnostic, SigningFlagCtx, SigningFlagInput, SoftWrapInput, TDD_SCOPE_PATTERN, TDD_STATES, TYPE_EMOJIS, TYPE_EMOJIS_UNICODE, TypeEnumEntry, VERBOSITY_LINE_THRESHOLD, VERBOSITY_WORD_THRESHOLD, VerbosityInput, buildSigningDiagnostic, closesTrailerRule, createPromptConfig, createTypeEnum, CommitlintConfig as default, defaultPromptConfig, detectDCO, detectFromLockfiles, detectPackageManager, detectScopes, emojiPromptConfig, fetchAndCacheOpenIssues, forbiddenContentRule, format, getExplanation, getSuggestion, getTypeEmoji, hasClosingTrailer, inferTicketId, parseBashCommand, parseGpgKeyExpiry, parseHuskyConfigPath, parsePackageManagerField, partitionHits, planLeakageRule, postToolUseAdvise, preToolUseAdvise, preToolUseAllow, preToolUseDeny, preToolUseSilent, prompter, readBranchInfo, readCache, readCommitlintConfigPath, readOpenIssuesFromCache, readOrFetchOpenIssues, readSigningDiagnostic, sessionStartContext, signingFlagConflictRule, softWrapRule, staticConfig, verbosityRule, writeCache };
 }
 /**
  * Dynamic commitlint configuration factory.
@@ -6169,11 +6187,12 @@ declare const BiomeSyncError_base: new <A extends Record<string, any> = {}>(args
  * 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
+ * Returned by `BiomeSchemaSync.sync` and `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
+ * @public
  */
 declare class BiomeSyncError extends BiomeSyncError_base<{
   readonly path: string;
@@ -6190,11 +6209,12 @@ declare const ConfigNotFoundError_base: new <A extends Record<string, any> = {}>
  * 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}
+ * Returned by consumers that require a config file to exist. `ConfigDiscovery.find`
  * itself returns `null` instead of failing — callers that need a hard failure should
  * map `null` to this error.
  *
  * @since 0.1.0
+ * @public
  */
 declare class ConfigNotFoundError extends ConfigNotFoundError_base<{
   readonly name: string;
@@ -6211,6 +6231,7 @@ declare const SectionParseError_base: new <A extends Record<string, any> = {}>(a
  * Raised when a managed section cannot be parsed from a file.
  *
  * @since 0.2.0
+ * @public
  */
 declare class SectionParseError extends SectionParseError_base<{
   readonly path: string;
@@ -6227,6 +6248,7 @@ declare const SectionValidationError_base: new <A extends Record<string, any> =
  * Raised when a {@link SectionBlock} fails validation at creation time.
  *
  * @since 0.2.0
+ * @public
  */
 declare class SectionValidationError extends SectionValidationError_base<{
   readonly toolName: string;
@@ -6243,6 +6265,7 @@ declare const SectionWriteError_base: new <A extends Record<string, any> = {}>(a
  * Raised when a managed section cannot be written to a file.
  *
  * @since 0.2.0
+ * @public
  */
 declare class SectionWriteError extends SectionWriteError_base<{
   readonly path: string;
@@ -6259,10 +6282,11 @@ declare const TagFormatError_base: new <A extends Record<string, any> = {}>(args
  * 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
+ * Returned by `TagStrategy.formatTag` when the `version` argument is an empty string
  * or another invariant prevents tag construction.
  *
  * @since 0.1.0
+ * @public
  */
 declare class TagFormatError extends TagFormatError_base<{
   readonly name: string;
@@ -6276,6 +6300,7 @@ declare class TagFormatError extends TagFormatError_base<{
 declare const ToolNotFoundError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
   readonly _tag: "ToolNotFoundError";
 } & Readonly<A>;
+/** @public */
 declare class ToolNotFoundError extends ToolNotFoundError_base<{
   readonly name: string;
   readonly reason: string;
@@ -6287,6 +6312,7 @@ declare class ToolNotFoundError extends ToolNotFoundError_base<{
 declare const ToolResolutionError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
   readonly _tag: "ToolResolutionError";
 } & Readonly<A>;
+/** @public */
 declare class ToolResolutionError extends ToolResolutionError_base<{
   readonly name: string;
   readonly reason: string;
@@ -6298,6 +6324,7 @@ declare class ToolResolutionError extends ToolResolutionError_base<{
 declare const ToolVersionMismatchError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
   readonly _tag: "ToolVersionMismatchError";
 } & Readonly<A>;
+/** @public */
 declare class ToolVersionMismatchError extends ToolVersionMismatchError_base<{
   readonly name: string;
   readonly globalVersion: string;
@@ -6314,10 +6341,11 @@ declare const VersioningDetectionError_base: new <A extends Record<string, any>
  * Raised when the versioning strategy cannot be determined from the workspace state.
  *
  * @remarks
- * Returned by {@link VersioningStrategy.detect} when an unexpected condition
+ * Returned by `VersioningStrategy.detect` when an unexpected condition
  * prevents strategy classification.
  *
  * @since 0.1.0
+ * @public
  */
 declare class VersioningDetectionError extends VersioningDetectionError_base<{
   readonly reason: string;
@@ -6333,11 +6361,12 @@ declare const WorkspaceAnalysisError_base: new <A extends Record<string, any> =
  * Raised when workspace analysis fails for a given root directory.
  *
  * @remarks
- * Returned by {@link SilkWorkspaceAnalyzer.analyze} when the analysis pipeline
+ * Returned by `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
+ * @public
  */
 declare class WorkspaceAnalysisError extends WorkspaceAnalysisError_base<{
   readonly root: string;
@@ -7655,6 +7684,7 @@ declare function resetWorkspaceCache(): void;
  * Result of comparing two section contents.
  *
  * @since 0.2.0
+ * @public
  */
 type SectionDiffDefinition = {
   readonly Unchanged: {};
@@ -7663,9 +7693,15 @@ type SectionDiffDefinition = {
     readonly removed: ReadonlyArray<string>;
   };
 };
-/** @since 0.2.0 */
+/**
+ * @since 0.2.0
+ * @public
+ */
 type SectionDiff = Data.TaggedEnum<SectionDiffDefinition>;
-/** @since 0.2.0 */
+/**
+ * @since 0.2.0
+ * @public
+ */
 declare const SectionDiff: {
   readonly Unchanged: Data.Case.Constructor<{
     readonly _tag: "Unchanged";
@@ -7725,6 +7761,7 @@ declare const SectionDiff: {
  * Result of a sync operation.
  *
  * @since 0.2.0
+ * @public
  */
 type SyncResultDefinition = {
   readonly Created: {};
@@ -7733,9 +7770,15 @@ type SyncResultDefinition = {
   };
   readonly Unchanged: {};
 };
-/** @since 0.2.0 */
+/**
+ * @since 0.2.0
+ * @public
+ */
 type SyncResult = Data.TaggedEnum<SyncResultDefinition>;
-/** @since 0.2.0 */
+/**
+ * @since 0.2.0
+ * @public
+ */
 declare const SyncResult: {
   readonly Unchanged: Data.Case.Constructor<{
     readonly _tag: "Unchanged";
@@ -7806,6 +7849,7 @@ declare const SyncResult: {
  * Result of a check operation.
  *
  * @since 0.2.0
+ * @public
  */
 type CheckResultDefinition = {
   readonly Found: {
@@ -7814,9 +7858,15 @@ type CheckResultDefinition = {
   };
   readonly NotFound: {};
 };
-/** @since 0.2.0 */
+/**
+ * @since 0.2.0
+ * @public
+ */
 type CheckResult = Data.TaggedEnum<CheckResultDefinition>;
-/** @since 0.2.0 */
+/**
+ * @since 0.2.0
+ * @public
+ */
 declare const CheckResult: {
   readonly Found: Data.Case.Constructor<{
     readonly _tag: "Found";
@@ -7884,10 +7934,11 @@ declare const SectionBlock_base: Schema.TaggedClass<SectionBlock, "SectionBlock"
 /**
  * The content between managed section markers.
  *
- * {@link Equal} compares normalized content only (trimmed, whitespace-collapsed).
- * Use {@link SectionBlock.diff | diff} to compute line-level differences.
+ * `Equal` compares normalized content only (trimmed, whitespace-collapsed).
+ * Use `diff` to compute line-level differences.
  *
  * @since 0.2.0
+ * @public
  */
 declare class SectionBlock extends SectionBlock_base {
   static diff: {
@@ -7921,9 +7972,13 @@ declare class SectionBlock extends SectionBlock_base {
  * - `"//"` — C-style, suitable for JavaScript/TypeScript files.
  *
  * @since 0.1.0
+ * @public
  */
 declare const CommentStyle: Schema.Literal<["#", "//"]>;
-/** @since 0.1.0 */
+/**
+ * @since 0.1.0
+ * @public
+ */
 type CommentStyle = typeof CommentStyle.Type;
 //#endregion
 //#region src/schemas/SectionDefinition.d.ts
@@ -7938,11 +7993,12 @@ declare const SectionDefinition_base: Schema.TaggedClass<SectionDefinition, "Sec
 /**
  * Identity envelope for a managed section type.
  *
- * {@link Equal} compares on `toolName` + `commentStyle`.
+ * `Equal` compares on `toolName` + `commentStyle`.
  * Use {@link SectionDefinition.block | block()} to create a {@link SectionBlock},
- * or {@link SectionDefinition.generate | generate()} for a typed factory.
+ * or `generate()` for a typed factory.
  *
  * @since 0.2.0
+ * @public
  */
 declare class SectionDefinition extends SectionDefinition_base {
   private _validate?;
@@ -7982,6 +8038,7 @@ declare const ShellSectionDefinition_base: Schema.TaggedClass<ShellSectionDefini
  * `commentStyle` is always `"#"` — only `toolName` is required.
  *
  * @since 0.2.0
+ * @public
  */
 declare class ShellSectionDefinition extends ShellSectionDefinition_base {
   get commentStyle(): CommentStyle;
@@ -8226,13 +8283,17 @@ declare namespace index_d_exports$2 {
  * - `current` — paths of config files already pointing to the expected schema URL.
  *
  * @since 0.1.0
+ * @public
  */
 declare const BiomeSyncResult: Schema.Struct<{
   updated: Schema.Array$<typeof Schema.String>;
   skipped: Schema.Array$<typeof Schema.String>;
   current: Schema.Array$<typeof Schema.String>;
 }>;
-/** @since 0.1.0 */
+/**
+ * @since 0.1.0
+ * @public
+ */
 type BiomeSyncResult = typeof BiomeSyncResult.Type;
 /**
  * Options for {@link BiomeSchemaSync} operations.
@@ -8242,6 +8303,7 @@ type BiomeSyncResult = typeof BiomeSyncResult.Type;
  * `gitignore` is reserved for future use to skip gitignored config files (defaults to `true`).
  *
  * @since 0.1.0
+ * @public
  */
 declare const BiomeSyncOptions: Schema.Struct<{
   cwd: Schema.optional<typeof Schema.String>;
@@ -8249,7 +8311,10 @@ declare const BiomeSyncOptions: Schema.Struct<{
     default: () => true;
   }>;
 }>;
-/** @since 0.1.0 */
+/**
+ * @since 0.1.0
+ * @public
+ */
 type BiomeSyncOptions = typeof BiomeSyncOptions.Type;
 //#endregion
 //#region src/schemas/ConfigDiscoverySchemas.d.ts
@@ -8262,24 +8327,32 @@ type BiomeSyncOptions = typeof BiomeSyncOptions.Type;
  * - `"cosmiconfig"` — reserved for future cosmiconfig-based discovery.
  *
  * @since 0.1.0
+ * @public
  */
 declare const ConfigSource: Schema.Literal<["lib", "root", "cosmiconfig"]>;
-/** @since 0.1.0 */
+/**
+ * @since 0.1.0
+ * @public
+ */
 type ConfigSource = typeof ConfigSource.Type;
 /**
  * The resolved location of a discovered config file.
  *
  * @remarks
- * Produced by {@link ConfigDiscovery.find} and {@link ConfigDiscovery.findAll}.
+ * Produced by `ConfigDiscovery.find` and `ConfigDiscovery.findAll`.
  * `path` is the absolute file path; `source` indicates how it was discovered.
  *
  * @since 0.1.0
+ * @public
  */
 declare const ConfigLocation: Schema.Struct<{
   path: typeof Schema.String;
   source: Schema.Literal<["lib", "root", "cosmiconfig"]>;
 }>;
-/** @since 0.1.0 */
+/**
+ * @since 0.1.0
+ * @public
+ */
 type ConfigLocation = typeof ConfigLocation.Type;
 /**
  * Options passed to config discovery methods.
@@ -8289,21 +8362,26 @@ type ConfigLocation = typeof ConfigLocation.Type;
  * `tool` is reserved for future use as a tool-specific discovery hint.
  *
  * @since 0.1.0
+ * @public
  */
 declare const ConfigDiscoveryOptions: Schema.Struct<{
   cwd: Schema.optional<typeof Schema.String>;
   tool: Schema.optional<typeof Schema.String>;
 }>;
-/** @since 0.1.0 */
+/**
+ * @since 0.1.0
+ * @public
+ */
 type ConfigDiscoveryOptions = typeof ConfigDiscoveryOptions.Type;
 //#endregion
 //#region src/utils/ToolCommand.d.ts
 /**
- * Wraps `@effect/platform` {@link Command.Command} with instance method ergonomics.
+ * Wraps `@effect/platform` `Command.Command` with instance method ergonomics.
  *
  * Use `yield* cmd.string()` instead of `yield* Command.string(cmd)`.
  *
  * @since 0.2.0
+ * @public
  */
 declare class ToolCommand {
   readonly command: Command.Command;
@@ -8332,9 +8410,10 @@ declare const ResolvedTool_base: Schema.TaggedClass<ResolvedTool, "ResolvedTool"
 /**
  * Result of resolving a {@link ToolDefinition}.
  *
- * Provides {@link exec} and {@link dlx} to build commands for the resolved tool.
+ * Provides `exec` and `dlx` to build commands for the resolved tool.
  *
  * @since 0.2.0
+ * @public
  */
 declare class ResolvedTool extends ResolvedTool_base {
   get isGlobal(): boolean;
@@ -8358,6 +8437,7 @@ declare class ResolvedTool extends ResolvedTool_base {
  * ```
  *
  * @since 0.5.0
+ * @public
  */
 declare const SavvyBaseSection: ShellSectionDefinition;
 /**
@@ -8366,6 +8446,7 @@ declare const SavvyBaseSection: ShellSectionDefinition;
  * `toolName` is `"savvy-hooks"`; pair with {@link savvyHooksHygiene}.
  *
  * @since 0.5.0
+ * @public
  */
 declare const SavvyHooksSection: ShellSectionDefinition;
 /**
@@ -8380,6 +8461,7 @@ declare const SavvyHooksSection: ShellSectionDefinition;
  * @returns The preamble shell, with no surrounding markers or trailing newline.
  *
  * @since 0.5.0
+ * @public
  */
 declare function savvyBasePreamble(): string;
 /**
@@ -8392,6 +8474,7 @@ declare function savvyBasePreamble(): string;
  * @returns The hygiene shell, with no surrounding markers or trailing newline.
  *
  * @since 0.5.0
+ * @public
  */
 declare function savvyHooksHygiene(): string;
 /**
@@ -8405,7 +8488,7 @@ declare function savvyHooksHygiene(): string;
  *
  * **Precondition:** a {@link SavvyBaseSection} block must precede this section in the same
  * hook file so `in_ci` and `pm_exec` are defined. Consumers guarantee this by passing both
- * to {@link ManagedSection.syncMany | ManagedSection.syncMany} in order:
+ * to `ManagedSection.syncMany` in order:
  *
  * @example
  * ```ts
@@ -8420,6 +8503,7 @@ declare function savvyHooksHygiene(): string;
  * @returns A shell {@link SectionBlock} (`commentStyle: "#"`) for `toolName`.
  *
  * @since 0.5.0
+ * @public
  */
 declare function savvyToolSection(toolName: string, command: string): SectionBlock;
 //#endregion
@@ -8431,20 +8515,37 @@ declare function savvyToolSection(toolName: string, command: string): SectionBlo
  * - `"single"` — one shared tag for the entire release (e.g. `1.2.3`).
  * - `"scoped"` — a per-package tag that includes the package name (e.g. `@my-org/pkg@1.2.3`).
  *
- * Determined by {@link TagStrategy.determine} based on the {@link VersioningStrategyResult}.
+ * Determined by `TagStrategy.determine` based on the {@link (VersioningStrategyResult:type)}.
  *
  * @since 0.1.0
+ * @public
  */
 declare const TagStrategyType: Schema.Literal<["single", "scoped"]>;
-/** @since 0.1.0 */
+/**
+ * @since 0.1.0
+ * @public
+ */
 type TagStrategyType = typeof TagStrategyType.Type;
 //#endregion
 //#region src/schemas/ToolResults.d.ts
-/** Where a tool was resolved from. @since 0.2.0 */
+/**
+ * Where a tool was resolved from.
+ *
+ * @since 0.2.0
+ * @public
+ */
 declare const ToolSource: Schema.Literal<["global", "local"]>;
-/** @since 0.2.0 */
+/**
+ * @since 0.2.0
+ * @public
+ */
 type ToolSource = typeof ToolSource.Type;
-/** How to extract a version string from a CLI tool. @since 0.2.0 */
+/**
+ * How to extract a version string from a CLI tool.
+ *
+ * @since 0.2.0
+ * @public
+ */
 type VersionExtractorDefinition = {
   readonly Flag: {
     readonly flag: string;
@@ -8456,9 +8557,15 @@ type VersionExtractorDefinition = {
   };
   readonly None: {};
 };
-/** @since 0.2.0 */
+/**
+ * @since 0.2.0
+ * @public
+ */
 type VersionExtractor = Data.TaggedEnum<VersionExtractorDefinition>;
-/** @since 0.2.0 */
+/**
+ * @since 0.2.0
+ * @public
+ */
 declare const VersionExtractor: {
   readonly Flag: Data.Case.Constructor<{
     readonly _tag: "Flag";
@@ -8543,16 +8650,27 @@ declare const VersionExtractor: {
     }, cases: Cases & { [K in Exclude<keyof Cases, "Flag" | "Json" | "None">]: never }): import("effect/Unify").Unify<ReturnType<Cases["Flag" | "Json" | "None"]>>;
   };
 };
-/** What to do when both global and local versions differ. @since 0.2.0 */
+/**
+ * What to do when both global and local versions differ.
+ *
+ * @since 0.2.0
+ * @public
+ */
 type ResolutionPolicyDefinition = {
   readonly Report: {};
   readonly PreferLocal: {};
   readonly PreferGlobal: {};
   readonly RequireMatch: {};
 };
-/** @since 0.2.0 */
+/**
+ * @since 0.2.0
+ * @public
+ */
 type ResolutionPolicy = Data.TaggedEnum<ResolutionPolicyDefinition>;
-/** @since 0.2.0 */
+/**
+ * @since 0.2.0
+ * @public
+ */
 declare const ResolutionPolicy: {
   readonly Report: Data.Case.Constructor<{
     readonly _tag: "Report";
@@ -8630,16 +8748,27 @@ declare const ResolutionPolicy: {
     }, cases: Cases & { [K in Exclude<keyof Cases, "Report" | "PreferLocal" | "PreferGlobal" | "RequireMatch">]: never }): import("effect/Unify").Unify<ReturnType<Cases["Report" | "PreferLocal" | "PreferGlobal" | "RequireMatch"]>>;
   };
 };
-/** Where the tool must be found. @since 0.2.0 */
+/**
+ * Where the tool must be found.
+ *
+ * @since 0.2.0
+ * @public
+ */
 type SourceRequirementDefinition = {
   readonly Any: {};
   readonly OnlyLocal: {};
   readonly OnlyGlobal: {};
   readonly Both: {};
 };
-/** @since 0.2.0 */
+/**
+ * @since 0.2.0
+ * @public
+ */
 type SourceRequirement = Data.TaggedEnum<SourceRequirementDefinition>;
-/** @since 0.2.0 */
+/**
+ * @since 0.2.0
+ * @public
+ */
 declare const SourceRequirement: {
   readonly Any: Data.Case.Constructor<{
     readonly _tag: "Any";
@@ -8722,9 +8851,10 @@ declare const SourceRequirement: {
 /**
  * Declares a CLI tool's identity and resolution constraints.
  *
- * {@link Equal} compares on `name` only (identity).
+ * `Equal` compares on `name` only (identity).
  *
  * @since 0.2.0
+ * @public
  */
 declare class ToolDefinition implements Equal.Equal {
   readonly _tag: "ToolDefinition";
@@ -8805,6 +8935,7 @@ declare const SilkPublishConfig_base: Schema.Class<SilkPublishConfig, {
  * Silk `targets` extension for multi-registry publishing.
  *
  * @since 0.2.0
+ * @public
  */
 declare class SilkPublishConfig extends SilkPublishConfig_base {}
 declare const AnalyzedWorkspace_base: Schema.TaggedClass<AnalyzedWorkspace, "AnalyzedWorkspace", {
@@ -8830,6 +8961,7 @@ declare const AnalyzedWorkspace_base: Schema.TaggedClass<AnalyzedWorkspace, "Ana
  * and release group membership.
  *
  * @since 0.2.0
+ * @public
  */
 declare class AnalyzedWorkspace extends AnalyzedWorkspace_base {
   get isRoot(): boolean;
@@ -8920,6 +9052,7 @@ declare const WorkspaceAnalysis_base: Schema.TaggedClass<WorkspaceAnalysis, "Wor
  * and project-level configuration.
  *
  * @since 0.2.0
+ * @public
  */
 declare class WorkspaceAnalysis extends WorkspaceAnalysis_base {
   findWorkspace(name: string): Option.Option<AnalyzedWorkspace>;
@@ -8945,6 +9078,7 @@ declare class WorkspaceAnalysis extends WorkspaceAnalysis_base {
  * @returns The bare semver string (e.g. `"1.9.3"`).
  *
  * @since 0.1.0
+ * @public
  */
 declare function extractSemver(version: string): string;
 /**
@@ -8954,6 +9088,7 @@ declare function extractSemver(version: string): string;
  * @returns The canonical `biomejs.dev` schema URL for that version.
  *
  * @since 0.1.0
+ * @public
  */
 declare function buildSchemaUrl(version: string): string;
 declare const BiomeSchemaSync_base: Context.TagClass<BiomeSchemaSync, "@savvy-web/silk-effects/BiomeSchemaSync", {
@@ -9007,6 +9142,7 @@ declare const BiomeSchemaSync_base: Context.TagClass<BiomeSchemaSync, "@savvy-we
  * ```
  *
  * @since 0.1.0
+ * @public
  */
 declare class BiomeSchemaSync extends BiomeSchemaSync_base {}
 /**
@@ -9017,11 +9153,15 @@ declare class BiomeSchemaSync extends BiomeSchemaSync_base {}
  * `BunContext.layer` to satisfy this dependency.
  *
  * @since 0.1.0
+ * @public
  */
 declare const BiomeSchemaSyncLive: Layer.Layer<BiomeSchemaSync, never, FileSystem.FileSystem>;
 //#endregion
 //#region src/services/ChangesetConfig.d.ts
-/** Changeset operating mode for a workspace root. */
+/**
+ * Changeset operating mode for a workspace root.
+ * @public
+ */
 type ChangesetMode = "silk" | "vanilla" | "none";
 declare const ChangesetConfig_base: Context.TagClass<ChangesetConfig, "@savvy-web/silk-effects/ChangesetConfig", {
   readonly mode: (root: string) => Effect.Effect<ChangesetMode>;
@@ -9039,6 +9179,7 @@ declare const ChangesetConfig_base: Context.TagClass<ChangesetConfig, "@savvy-we
  * to `mode: "none"` and empty/false defaults.
  *
  * @since 0.4.0
+ * @public
  */
 declare class ChangesetConfig extends ChangesetConfig_base {
   /**
@@ -9057,6 +9198,7 @@ declare class ChangesetConfig extends ChangesetConfig_base {
  * `ChangesetConfigReaderLive` + a platform layer (`NodeContext.layer`).
  *
  * @since 0.4.0
+ * @public
  */
 declare const ChangesetConfigLive: Layer.Layer<ChangesetConfig, never, ChangesetConfigReader>;
 //#endregion
@@ -9113,6 +9255,7 @@ declare const ConfigDiscovery_base: Context.TagClass<ConfigDiscovery, "@savvy-we
  * ```
  *
  * @since 0.1.0
+ * @public
  */
 declare class ConfigDiscovery extends ConfigDiscovery_base {}
 /**
@@ -9123,6 +9266,7 @@ declare class ConfigDiscovery extends ConfigDiscovery_base {}
  * `BunContext.layer` to satisfy this dependency.
  *
  * @since 0.1.0
+ * @public
  */
 declare const ConfigDiscoveryLive: Layer.Layer<ConfigDiscovery, never, FileSystem.FileSystem>;
 //#endregion
@@ -9165,17 +9309,22 @@ declare const ManagedSection_base: Context.TagClass<ManagedSection, "@savvy-web/
  * Content operations (`write`, `sync`, `check`) take a {@link SectionBlock}.
  *
  * @since 0.2.0
+ * @public
  */
 declare class ManagedSection extends ManagedSection_base {}
 /**
  * Live implementation of {@link ManagedSection} backed by `@effect/platform` FileSystem.
  *
  * @since 0.2.0
+ * @public
  */
 declare const ManagedSectionLive: Layer.Layer<ManagedSection, never, FileSystem.FileSystem>;
 //#endregion
 //#region src/services/SilkPublishability.d.ts
-/** A single object-form publish target in the `publishConfig.targets` map (mirrors the bundler's `PublishTargetObject`). */
+/**
+ * A single object-form publish target in the `publishConfig.targets` map (mirrors the bundler's `PublishTargetObject`).
+ * @public
+ */
 interface RawTargetObject {
   /** Registry endpoint. Defaulted for the well-known `npm`/`github` keys. */
   readonly registry?: string;
@@ -9184,7 +9333,10 @@ interface RawTargetObject {
   /** Reuse another target's group bytes. Mutually exclusive with `name`. */
   readonly from?: string;
 }
-/** A `publishConfig.targets` value: `true` (well-known registry, base name), a string (name override), or an object. */
+/**
+ * A `publishConfig.targets` value: `true` (well-known registry, base name), a string (name override), or an object.
+ * @public
+ */
 type RawTargetValue = true | string | RawTargetObject;
 /**
  * The `publishConfig.targets` map, keyed by target id (`npm`, `github`, or a custom key).
@@ -9193,25 +9345,35 @@ type RawTargetValue = true | string | RawTargetObject;
  * This is the bundler's Record-map form. The legacy array form is no longer supported
  * (removed in the 1.0 breaking change) — declare targets as a keyed map and let the
  * bundler emit the {@link TargetsBinding} that silk publishability resolves against.
+ * @public
  */
 type RawPublishTargets = Record<string, RawTargetValue>;
-/** Raw `publishConfig` shape (the unschematized fields silk rules consult). */
+/**
+ * Raw `publishConfig` shape (the unschematized fields silk rules consult).
+ * @public
+ */
 interface RawPublishConfig {
   readonly access?: "public" | "restricted";
   readonly registry?: string;
   readonly directory?: string;
   readonly targets?: RawPublishTargets;
 }
-/** A resolved byte-variant group from the bundler's `dist/prod/targets.json` binding. */
+/**
+ * A resolved byte-variant group from the bundler's `dist/prod/targets.json` binding.
+ * @public
+ */
 interface TargetGroupBinding {
-  /** Group folder id; the group's bytes live at {@link dir}. */
+  /** Group folder id; the group's bytes live at `dir`. */
   readonly id: string;
   /** The `package.json.name` this group's manifest carries. */
   readonly name: string;
   /** The group's pkg output dir, relative to the package root (e.g. `dist/prod/npm/pkg`). */
   readonly dir: string;
 }
-/** A resolved registry target from the bundler's `dist/prod/targets.json` binding (one per `publishConfig.targets` key). */
+/**
+ * A resolved registry target from the bundler's `dist/prod/targets.json` binding (one per `publishConfig.targets` key).
+ * @public
+ */
 interface TargetBinding {
   /** The `publishConfig.targets` key (`npm`, `github`, …). */
   readonly id: string;
@@ -9230,19 +9392,26 @@ interface TargetBinding {
  * byte-variant build set; `targets` binds every declared registry target to one group.
  * `npm: true` + `github: true` collapse into one scoped-name group deployed to two
  * registries (one group, two targets).
+ * @public
  */
 interface TargetsBinding {
   readonly groups: ReadonlyArray<TargetGroupBinding>;
   readonly targets: ReadonlyArray<TargetBinding>;
 }
-/** Raw `package.json` shape consumed by {@link SilkPublishability.detect}. */
+/**
+ * Raw `package.json` shape consumed by `SilkPublishability.detect`.
+ * @public
+ */
 interface RawPackageJson {
   readonly name?: string;
   readonly version?: string;
   readonly private?: boolean;
   readonly publishConfig?: RawPublishConfig;
 }
-/** A publishable workspace package and the count of its resolved publish targets. */
+/**
+ * A publishable workspace package and the count of its resolved publish targets.
+ * @public
+ */
 interface PublishablePackage {
   readonly name: string;
   readonly version: string;
@@ -9250,7 +9419,7 @@ interface PublishablePackage {
   readonly targetCount: number;
 }
 /**
- * Silk publishability rules over `workspaces-effect`'s {@link PublishTarget}.
+ * Silk publishability rules over `workspaces-effect`'s `PublishTarget`.
  *
  * @remarks
  * In silk mode `private: true` is the norm on workspace `package.json`; publishability is
@@ -9258,6 +9427,7 @@ interface PublishablePackage {
  * default. All helpers are static so a consumer sees the full rule surface in one place.
  *
  * @since 0.4.0
+ * @public
  */
 declare class SilkPublishability {
   /**
@@ -9266,7 +9436,7 @@ declare class SilkPublishability {
    *
    * - A non-empty `publishConfig.targets` map (the bundler's Record-map form) makes the
    *   package publishable regardless of `private`. With a `binding` (post-prod-build), one
-   *   {@link PublishTarget} is emitted per resolved registry target, its `directory` set to
+   *   `PublishTarget` is emitted per resolved registry target, its `directory` set to
    *   the bound group's `dist/prod/<group>/pkg` dir. Without a binding (pre-build), one
    *   placeholder target is emitted per declared key so publishability and target counts
    *   are correct; the directory is best-effort and unused until the build writes the
@@ -9282,14 +9452,14 @@ declare class SilkPublishability {
    */
   static detect(pkgName: string, raw: RawPackageJson, binding: TargetsBinding | null): ReadonlyArray<PublishTarget>;
   /**
-   * Resolve a package's publish targets via {@link PublishabilityDetector}, then drop any
+   * Resolve a package's publish targets via {@link SilkPublishability}, then drop any
    * whose built `directory` package.json is `private: true`. Returned targets keep the
    * detector's original (possibly package-relative) `directory`.
    */
   static resolveTargets(pkg: WorkspacePackage, root: string): Effect.Effect<ReadonlyArray<PublishTarget>, never, PublishabilityDetector | FileSystem.FileSystem>;
   /**
    * The publishable, non-ignored packages, resolved through the single
-   * {@link PublishabilityDetector} (which already honors changeset ignore in adaptive mode).
+   * {@link SilkPublishability} (which already honors changeset ignore in adaptive mode).
    */
   static listPublishable(root: string): Effect.Effect<ReadonlyArray<PublishablePackage>, never, WorkspaceDiscovery | PublishabilityDetector>;
 }
@@ -9298,31 +9468,34 @@ declare class SilkPublishability {
  *
  * @remarks
  * Returns `null` when the file is missing/unreadable/malformed — i.e. before the prod build
- * has run. {@link SilkPublishability.detect} falls back to declared-key placeholders in that
- * case. Used by the silk {@link PublishabilityDetector} layers and the workspace analyzer.
+ * has run. `SilkPublishability.detect` falls back to declared-key placeholders in that
+ * case. Used by the silk {@link SilkPublishability} layers and the workspace analyzer.
  *
  * @param fs - The FileSystem service.
  * @param pkgPath - Absolute path to the package directory.
  * @since 1.0.0
+ * @public
  */
 declare const readTargetsBinding: (fs: FileSystem.FileSystem, pkgPath: string) => Effect.Effect<TargetsBinding | null>;
 /**
- * Override of `workspaces-effect`'s {@link PublishabilityDetector} Tag with pure silk rules.
+ * Override of `workspaces-effect`'s {@link SilkPublishability} Tag with pure silk rules.
  *
  * @remarks Requires `FileSystem` (captured at layer build); `detect` reads the raw
- * `package.json` from `pkg.packageJsonPath` and applies {@link SilkPublishability.detect}.
+ * `package.json` from `pkg.packageJsonPath` and applies `SilkPublishability.detect`.
  *
  * @since 0.4.0
+ * @public
  */
 declare const SilkPublishabilityDetectorLive: Layer.Layer<PublishabilityDetector, never, FileSystem.FileSystem>;
 /**
- * Ignore-aware override of {@link PublishabilityDetector}. `detect` short-circuits to `[]`
- * for changeset-ignored packages, then dispatches on {@link ChangesetConfig.mode}:
- * `none` → `[]`; `silk` → {@link SilkPublishability.detect}; `vanilla` → the library default.
+ * Ignore-aware override of {@link SilkPublishability}. `detect` short-circuits to `[]`
+ * for changeset-ignored packages, then dispatches on `ChangesetConfig.mode`:
+ * `none` → `[]`; `silk` → `SilkPublishability.detect`; `vanilla` → the library default.
  *
  * @remarks Requires `FileSystem` + {@link ChangesetConfig} at build.
  *
  * @since 0.4.0
+ * @public
  */
 declare const PublishabilityDetectorAdaptiveLive: Layer.Layer<PublishabilityDetector, never, FileSystem.FileSystem | ChangesetConfig>;
 //#endregion
@@ -9331,7 +9504,7 @@ declare const TagStrategy_base: Context.TagClass<TagStrategy, "@savvy-web/silk-e
   /**
    * Determine the appropriate tag strategy type from a versioning strategy result.
    *
-   * @param versioningResult - The result of {@link VersioningStrategy.detect}.
+   * @param versioningResult - The result of `VersioningStrategy.detect`.
    * @returns An `Effect` that always succeeds with a {@link TagStrategyType}.
    *
    * @since 0.1.0
@@ -9354,7 +9527,7 @@ declare const TagStrategy_base: Context.TagClass<TagStrategy, "@savvy-web/silk-e
  * Service that determines and applies the git-tag naming strategy for a release.
  *
  * @remarks
- * Consumes a {@link VersioningStrategyResult} to pick between `"single"` and `"scoped"`
+ * Consumes a {@link (VersioningStrategyResult:type)} to pick between `"single"` and `"scoped"`
  * tag formats, then formats tag strings accordingly. Independent versioning always
  * produces scoped tags; single and fixed-group versioning produces a single shared tag.
  *
@@ -9371,6 +9544,7 @@ declare const TagStrategy_base: Context.TagClass<TagStrategy, "@savvy-web/silk-e
  * ```
  *
  * @since 0.1.0
+ * @public
  */
 declare class TagStrategy extends TagStrategy_base {}
 /**
@@ -9380,6 +9554,7 @@ declare class TagStrategy extends TagStrategy_base {}
  * All logic is pure: strategy determination and tag formatting involve no I/O.
  *
  * @since 0.1.0
+ * @public
  */
 declare const TagStrategyLive: Layer.Layer<TagStrategy>;
 //#endregion
@@ -9390,7 +9565,7 @@ declare const VersioningStrategy_base: Context.TagClass<VersioningStrategy, "@sa
    *
    * @param publishablePackages - Package names (e.g. `"@my-org/pkg"`) that will be published.
    * @param root - Workspace root directory to read changeset config from.
-   * @returns An `Effect` resolving to a {@link VersioningStrategyResult}, or failing with
+   * @returns An `Effect` resolving to a {@link (VersioningStrategyResult:type)}, or failing with
    *   {@link VersioningDetectionError} on unexpected errors.
    *
    * @since 0.1.0
@@ -9420,6 +9595,7 @@ declare const VersioningStrategy_base: Context.TagClass<VersioningStrategy, "@sa
  * ```
  *
  * @since 0.1.0
+ * @public
  */
 declare class VersioningStrategy extends VersioningStrategy_base {}
 /**
@@ -9430,6 +9606,7 @@ declare class VersioningStrategy extends VersioningStrategy_base {}
  * If the config file is absent, an empty `fixed` groups array is assumed.
  *
  * @since 0.1.0
+ * @public
  */
 declare const VersioningStrategyLive: Layer.Layer<VersioningStrategy, never, ChangesetConfigReader>;
 //#endregion
@@ -9454,7 +9631,7 @@ declare const SilkWorkspaceAnalyzer_base: Context.TagClass<SilkWorkspaceAnalyzer
  * wiring up fixed/linked release groups.
  *
  * @remarks
- * Orchestrates {@link WorkspaceDiscovery}, {@link PackageManagerDetector},
+ * Orchestrates `WorkspaceDiscovery`, `PackageManagerDetector`,
  * {@link ChangesetConfigReader}, {@link VersioningStrategy}, and
  * {@link TagStrategy} to produce a complete {@link WorkspaceAnalysis} for a
  * given workspace root.
@@ -9473,16 +9650,18 @@ declare const SilkWorkspaceAnalyzer_base: Context.TagClass<SilkWorkspaceAnalyzer
  * ```
  *
  * @since 0.2.0
+ * @public
  */
 declare class SilkWorkspaceAnalyzer extends SilkWorkspaceAnalyzer_base {}
 /**
  * Live implementation of {@link SilkWorkspaceAnalyzer}.
  *
  * @remarks
- * Requires {@link WorkspaceDiscovery}, {@link PackageManagerDetector},
+ * Requires `WorkspaceDiscovery`, `PackageManagerDetector`,
  * {@link ChangesetConfigReader}, {@link VersioningStrategy}, and {@link TagStrategy}.
  *
  * @since 0.2.0
+ * @public
  */
 declare const SilkWorkspaceAnalyzerLive: Layer.Layer<SilkWorkspaceAnalyzer, never, FileSystem.FileSystem | WorkspaceDiscovery | TopologicalSorter | PackageManagerDetector | ChangesetConfigReader | VersioningStrategy | TagStrategy>;
 //#endregion
@@ -9540,6 +9719,7 @@ declare const ToolDiscovery_base: Context.TagClass<ToolDiscovery, "@savvy-web/si
  * ```
  *
  * @since 0.2.0
+ * @public
  */
 declare class ToolDiscovery extends ToolDiscovery_base {}
 /**
@@ -9550,6 +9730,7 @@ declare class ToolDiscovery extends ToolDiscovery_base {}
  * and `WorkspaceRoot` from `workspaces-effect`.
  *
  * @since 0.2.0
+ * @public
  */
 declare const ToolDiscoveryLive: Layer.Layer<ToolDiscovery, never, CommandExecutor.CommandExecutor | PackageManagerDetector | WorkspaceRoot>;
 //#endregion
@@ -9899,5 +10080,5 @@ declare namespace index_d_exports$3 {
   export { AffectedResult, AffectedResultType, CacheDiagnosis, CacheDiagnosisType, DryRunParseError, GlobalHashSummary, GraphNode, MissExplanation, NotATurboRepoError, PackageCacheStatus, TaskGraphResult, TaskGraphResultType, TurboCache, TurboDigest, TurboDryRun, TurboDryRunType, TurboDryTask, TurboDryTaskType, TurboEnvVars, TurboError, TurboExecError, TurboGlobalCacheInputs, TurboInspector, TurboInspectorLive, TurboNotInstalledError };
 }
 //#endregion
-export { AnalyzedWorkspace, BiomeSchemaSync, BiomeSchemaSyncLive, BiomeSyncError, type BiomeSyncOptions, type BiomeSyncResult, ChangesetConfig, ChangesetConfigError, type ChangesetConfigFile, ChangesetConfigLive, ChangesetConfigReader, ChangesetConfigReaderLive, type ChangesetMode, index_d_exports as Changesets, CheckResult, type CheckResultDefinition, type CommentStyle, index_d_exports$1 as Commitlint, type CommitlintUserConfig, ConfigDiscovery, ConfigDiscoveryLive, type ConfigDiscoveryOptions, type ConfigLocation, ConfigNotFoundError, type ConfigSource, index_d_exports$2 as Lint, ManagedSection, ManagedSectionLive, PublishabilityDetectorAdaptiveLive, type PublishablePackage, type RawPackageJson, type RawPublishConfig, type RawPublishTargets, type RawTargetObject, type RawTargetValue, ResolutionPolicy, type ResolutionPolicyDefinition, ResolvedTool, SavvyBaseSection, SavvyHooksSection, SectionBlock, SectionDefinition, SectionDiff, type SectionDiffDefinition, SectionParseError, SectionValidationError, SectionWriteError, ShellSectionDefinition, type SilkChangesetConfigFile, SilkPublishConfig, SilkPublishability, SilkPublishabilityDetectorLive, SilkWorkspaceAnalyzer, SilkWorkspaceAnalyzerLive, SourceRequirement, type SourceRequirementDefinition, SyncResult, type SyncResultDefinition, TagFormatError, TagStrategy, TagStrategyLive, type TagStrategyType, type TargetBinding, type TargetGroupBinding, type TargetsBinding, ToolCommand, ToolDefinition, ToolDiscovery, ToolDiscoveryLive, ToolNotFoundError, ToolResolutionError, ToolSource, ToolVersionMismatchError, index_d_exports$3 as Turbo, VersionExtractor, type VersionExtractorDefinition, VersioningDetectionError, VersioningStrategy, VersioningStrategyLive, type VersioningStrategyResult, type VersioningStrategyType, WorkspaceAnalysis, WorkspaceAnalysisError, buildSchemaUrl, extractSemver, readTargetsBinding, savvyBasePreamble, savvyHooksHygiene, savvyToolSection };
+export { AnalyzedWorkspace, BiomeSchemaSync, BiomeSchemaSyncLive, BiomeSyncError, type BiomeSyncOptions, type BiomeSyncResult, ChangesetConfig, ChangesetConfigError, type ChangesetConfigFile, ChangesetConfigLive, ChangesetConfigReader, ChangesetConfigReaderLive, type ChangesetMode, index_d_exports as Changesets, CheckResult, type CheckResultDefinition, type CommentStyle, index_d_exports$1 as Commitlint, type CommitlintPlugin, type CommitlintUserConfig, ConfigDiscovery, ConfigDiscoveryLive, type ConfigDiscoveryOptions, type ConfigLocation, ConfigNotFoundError, type ConfigSource, index_d_exports$2 as Lint, ManagedSection, ManagedSectionLive, type PromptConfig, type PromptSettings, PublishabilityDetectorAdaptiveLive, type PublishablePackage, type RawPackageJson, type RawPublishConfig, type RawPublishTargets, type RawTargetObject, type RawTargetValue, ResolutionPolicy, type ResolutionPolicyDefinition, ResolvedTool, type RuleApplicability, type RuleConfigTuple, type RuleSeverity, type RulesConfig, SavvyBaseSection, SavvyHooksSection, SectionBlock, SectionDefinition, SectionDiff, type SectionDiffDefinition, SectionParseError, SectionValidationError, SectionWriteError, ShellSectionDefinition, type SilkChangesetConfigFile, SilkPublishConfig, SilkPublishability, SilkPublishabilityDetectorLive, SilkWorkspaceAnalyzer, SilkWorkspaceAnalyzerLive, SourceRequirement, type SourceRequirementDefinition, SyncResult, type SyncResultDefinition, TagFormatError, TagStrategy, TagStrategyLive, type TagStrategyType, type TargetBinding, type TargetGroupBinding, type TargetsBinding, ToolCommand, ToolDefinition, ToolDiscovery, ToolDiscoveryLive, ToolNotFoundError, ToolResolutionError, ToolSource, ToolVersionMismatchError, index_d_exports$3 as Turbo, VersionExtractor, type VersionExtractorDefinition, VersioningDetectionError, VersioningStrategy, VersioningStrategyLive, type VersioningStrategyResult, type VersioningStrategyType, WorkspaceAnalysis, WorkspaceAnalysisError, buildSchemaUrl, extractSemver, readTargetsBinding, savvyBasePreamble, savvyHooksHygiene, savvyToolSection };
 //# sourceMappingURL=index.d.ts.map