@savvy-web/silk-effects 1.4.0 → 1.5.1

package/lint/handlers/PnpmWorkspace.js

@@ -58,7 +58,7 @@ var PnpmWorkspace = class PnpmWorkspace {
 	/**
 	* Keys whose array values should be sorted alphabetically.
 	*/
-	static SORTABLE_ARRAY_KEYS = new Set([
+	static SORTABLE_ARRAY_KEYS = /* @__PURE__ */ new Set([
 		"packages",
 		"onlyBuiltDependencies",
 		"publicHoistPattern"

package/lint/index.js

@@ -50,4 +50,4 @@ var lint_exports = /* @__PURE__ */ __exportAll({
 });
 
 //#endregion
-export { lint_exports };
+export { Biome, Command, DEFAULT_CONFIG_PATH, Filter, HUSKY_HOOK_PATH, Handler, LegacySavvyLintHygieneDef, MARKDOWNLINT_CONFIG, MARKDOWNLINT_CONFIG_PATH, MARKDOWNLINT_SCHEMA, MARKDOWNLINT_TEMPLATE, Markdown, POST_CHECKOUT_HOOK_PATH, POST_COMMIT_HOOK_PATH, POST_MERGE_HOOK_PATH, PackageJson, PnpmWorkspace, Preset, SavvyLintSectionDef, ShellScripts, TypeScript, Yaml, createConfig, generateManagedContent, getWorkspacePackagePaths, getWorkspacePackages, getWorkspaceRoot, isWorkspacePackagePath, lint_exports, resetWorkspaceCache, savvyLintBlock };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@savvy-web/silk-effects",
-	"version": "1.4.0",
+	"version": "1.5.1",
 	"private": false,
 	"description": "Shared Effect library for Silk Suite conventions",
 	"homepage": "https://github.com/savvy-web/systems/tree/main/packages/silk-effects",
@@ -41,7 +41,7 @@
 		"remark-parse": "^11.0.0",
 		"remark-stringify": "^11.0.0",
 		"semver-effect": "^0.2.1",
-		"shell-quote": "^1.8.4",
+		"shell-quote": "^1.9.0",
 		"sort-package-json": "^4.0.0",
 		"tinyglobby": "^0.2.17",
 		"unified": "^11.0.5",

package/schemas/CommentStyle.js

@@ -9,6 +9,7 @@ import { Schema } from "effect";
 * - `"//"` — C-style, suitable for JavaScript/TypeScript files.
 *
 * @since 0.1.0
+* @public
 */
 const CommentStyle = Schema.Literal("#", "//");
 

package/schemas/ResolvedTool.js

@@ -8,9 +8,10 @@ const PackageManager = Schema.Literal("npm", "pnpm", "yarn", "bun");
 /**
 * 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
 */
 var ResolvedTool = class ResolvedTool extends Schema.TaggedClass()("ResolvedTool", {
 	name: Schema.String,

package/schemas/SavvySections.js

@@ -12,6 +12,7 @@ import { ShellSectionDefinition } from "./SectionDefinition.js";
 * ```
 *
 * @since 0.5.0
+* @public
 */
 const SavvyBaseSection = ShellSectionDefinition.make({ toolName: "savvy-base" });
 /**
@@ -20,6 +21,7 @@ const SavvyBaseSection = ShellSectionDefinition.make({ toolName: "savvy-base" })
 * `toolName` is `"savvy-hooks"`; pair with {@link savvyHooksHygiene}.
 *
 * @since 0.5.0
+* @public
 */
 const SavvyHooksSection = ShellSectionDefinition.make({ toolName: "savvy-hooks" });
 /**
@@ -34,6 +36,7 @@ const SavvyHooksSection = ShellSectionDefinition.make({ toolName: "savvy-hooks"
 * @returns The preamble shell, with no surrounding markers or trailing newline.
 *
 * @since 0.5.0
+* @public
 */
 function savvyBasePreamble() {
 	return `ROOT=$(git rev-parse --show-toplevel)
@@ -71,6 +74,7 @@ pm_exec() {
 * @returns The hygiene shell, with no surrounding markers or trailing newline.
 *
 * @since 0.5.0
+* @public
 */
 function savvyHooksHygiene() {
 	return `if ! { [ -n "$CI" ] || [ -n "$GITHUB_ACTIONS" ]; }; then
@@ -89,7 +93,7 @@ fi`;
 *
 * **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
@@ -104,6 +108,7 @@ fi`;
 * @returns A shell {@link SectionBlock} (`commentStyle: "#"`) for `toolName`.
 *
 * @since 0.5.0
+* @public
 */
 function savvyToolSection(toolName, command) {
 	return ShellSectionDefinition.make({ toolName }).block(`in_ci || pm_exec ${command}`);

package/schemas/SectionBlock.js

@@ -6,10 +6,11 @@ import { Equal, Function, Hash, Schema } from "effect";
 /**
 * 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
 */
 var SectionBlock = class SectionBlock extends Schema.TaggedClass()("SectionBlock", {
 	toolName: Schema.String,

package/schemas/SectionDefinition.js

@@ -8,11 +8,12 @@ import { Effect, Equal, Function, Hash, Schema } from "effect";
 /**
 * 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
 */
 var SectionDefinition = class SectionDefinition extends Schema.TaggedClass()("SectionDefinition", {
 	toolName: Schema.String,
@@ -91,6 +92,7 @@ var SectionDefinition = class SectionDefinition extends Schema.TaggedClass()("Se
 * `commentStyle` is always `"#"` — only `toolName` is required.
 *
 * @since 0.2.0
+* @public
 */
 var ShellSectionDefinition = class extends Schema.TaggedClass()("ShellSectionDefinition", { toolName: Schema.String }) {
 	get commentStyle() {

package/schemas/SectionResults.js

@@ -1,11 +1,20 @@
 import { Data } from "effect";
 
 //#region src/schemas/SectionResults.ts
-/** @since 0.2.0 */
+/**
+* @since 0.2.0
+* @public
+*/
 const SectionDiff = Data.taggedEnum();
-/** @since 0.2.0 */
+/**
+* @since 0.2.0
+* @public
+*/
 const SyncResult = Data.taggedEnum();
-/** @since 0.2.0 */
+/**
+* @since 0.2.0
+* @public
+*/
 const CheckResult = Data.taggedEnum();
 
 //#endregion

package/schemas/TagStrategySchemas.js

@@ -8,9 +8,10 @@ import { Schema } from "effect";
 * - `"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
 */
 const TagStrategyType = Schema.Literal("single", "scoped");
 

package/schemas/ToolDefinition.js

@@ -6,9 +6,10 @@ const NameSchema = Schema.Struct({ name: Schema.String });
 /**
 * 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
 */
 var ToolDefinition = class ToolDefinition {
 	_tag = "ToolDefinition";

package/schemas/ToolResults.js

@@ -1,13 +1,27 @@
 import { Data, Schema } from "effect";
 
 //#region src/schemas/ToolResults.ts
-/** Where a tool was resolved from. @since 0.2.0 */
+/**
+* Where a tool was resolved from.
+*
+* @since 0.2.0
+* @public
+*/
 const ToolSource = Schema.Literal("global", "local");
-/** @since 0.2.0 */
+/**
+* @since 0.2.0
+* @public
+*/
 const VersionExtractor = Data.taggedEnum();
-/** @since 0.2.0 */
+/**
+* @since 0.2.0
+* @public
+*/
 const ResolutionPolicy = Data.taggedEnum();
-/** @since 0.2.0 */
+/**
+* @since 0.2.0
+* @public
+*/
 const SourceRequirement = Data.taggedEnum();
 
 //#endregion

package/schemas/VersioningSchemas.js

@@ -34,11 +34,12 @@ const SnapshotConfig = Schema.Struct({
 *
 * @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 */
 const ChangesetConfigFile = Schema.Struct({
 	changelog: Schema.optional(Schema.Union(Schema.String, Schema.Array(Schema.Unknown), Schema.Literal(false))),
 	commit: Schema.optional(Schema.Union(Schema.Boolean, Schema.String, Schema.Array(Schema.Unknown))),
@@ -58,12 +59,13 @@ const ChangesetConfigFile = Schema.Struct({
 * 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 */
 const SilkChangesetConfigFile = Schema.extend(ChangesetConfigFile, Schema.Struct({ _isSilk: Schema.optionalWith(Schema.Boolean, { default: () => true }) }));
 /**
 * Versioning strategy classification for a workspace.
@@ -74,16 +76,18 @@ const SilkChangesetConfigFile = Schema.extend(ChangesetConfigFile, Schema.Struct
 * - `"independent"` — multiple publishable packages with independent version bumps.
 *
 * @since 0.1.0
+* @public
 */
 const VersioningStrategyType = Schema.Literal("single", "fixed-group", "independent");
 /**
 * 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
 */
 const VersioningStrategyResult = Schema.Struct({
 	type: VersioningStrategyType,
@@ -92,4 +96,4 @@ const VersioningStrategyResult = Schema.Struct({
 });
 
 //#endregion
-export { ChangesetConfigFile, SilkChangesetConfigFile, VersioningStrategyResult };
+export { ChangesetConfigFile, SilkChangesetConfigFile, VersioningStrategyResult, VersioningStrategyType };

package/schemas/WorkspaceAnalysisSchemas.js

@@ -23,6 +23,7 @@ const PublishTargetObject = Schema.Struct({
 * Silk `targets` extension for multi-registry publishing.
 *
 * @since 0.2.0
+* @public
 */
 var SilkPublishConfig = class extends PublishConfig.extend("SilkPublishConfig")({ targets: Schema.optional(Schema.Array(Schema.Union(PublishTargetShorthand, PublishTargetObject))) }) {};
 const KNOWN_REGISTRIES = {
@@ -45,6 +46,7 @@ const WorkspaceVersion = Schema.Struct({ current: Schema.String });
 * and release group membership.
 *
 * @since 0.2.0
+* @public
 */
 var AnalyzedWorkspace = class AnalyzedWorkspace extends Schema.TaggedClass()("AnalyzedWorkspace", {
 	name: Schema.String,
@@ -134,6 +136,7 @@ const PackageManagerInfo = Schema.Struct({
 * and project-level configuration.
 *
 * @since 0.2.0
+* @public
 */
 var WorkspaceAnalysis = class WorkspaceAnalysis extends Schema.TaggedClass()("WorkspaceAnalysis", {
 	root: Schema.String,

package/services/BiomeSchemaSync.js

@@ -11,6 +11,7 @@ import { parse } from "jsonc-effect";
 * @returns The bare semver string (e.g. `"1.9.3"`).
 *
 * @since 0.1.0
+* @public
 */
 function extractSemver(version) {
 	return version.replace(/^[\^~>=<v]+/, "");
@@ -22,6 +23,7 @@ function extractSemver(version) {
 * @returns The canonical `biomejs.dev` schema URL for that version.
 *
 * @since 0.1.0
+* @public
 */
 function buildSchemaUrl(version) {
 	return `https://biomejs.dev/schemas/${version}/schema.json`;
@@ -58,6 +60,7 @@ function findBiomeConfigs(cwd, fs) {
 * ```
 *
 * @since 0.1.0
+* @public
 */
 var BiomeSchemaSync = class extends Context.Tag("@savvy-web/silk-effects/BiomeSchemaSync")() {};
 /**
@@ -68,6 +71,7 @@ var BiomeSchemaSync = class extends Context.Tag("@savvy-web/silk-effects/BiomeSc
 * `BunContext.layer` to satisfy this dependency.
 *
 * @since 0.1.0
+* @public
 */
 const BiomeSchemaSyncLive = Layer.effect(BiomeSchemaSync, Effect.gen(function* () {
 	const fs = yield* FileSystem.FileSystem;

package/services/ChangesetConfig.js

@@ -11,6 +11,7 @@ import { Context, Effect, Layer, Option } from "effect";
 * to `mode: "none"` and empty/false defaults.
 *
 * @since 0.4.0
+* @public
 */
 var ChangesetConfig = class extends Context.Tag("@savvy-web/silk-effects/ChangesetConfig")() {
 	/**
@@ -36,6 +37,7 @@ const isSilk = (cfg) => "_isSilk" in cfg && cfg._isSilk === true;
 * `ChangesetConfigReaderLive` + a platform layer (`NodeContext.layer`).
 *
 * @since 0.4.0
+* @public
 */
 const ChangesetConfigLive = Layer.effect(ChangesetConfig, Effect.gen(function* () {
 	const reader = yield* ChangesetConfigReader;

package/services/ChangesetConfigReader.js

@@ -26,8 +26,8 @@ function isSilkChangelog(changelog) {
 *
 * @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
@@ -43,6 +43,7 @@ function isSilkChangelog(changelog) {
 * ```
 *
 * @since 0.1.0
+* @public
 */
 var ChangesetConfigReader = class extends Context.Tag("@savvy-web/silk-effects/ChangesetConfigReader")() {};
 /**
@@ -53,6 +54,7 @@ var ChangesetConfigReader = class extends Context.Tag("@savvy-web/silk-effects/C
 * `BunContext.layer` to satisfy this dependency.
 *
 * @since 0.1.0
+* @public
 */
 const ChangesetConfigReaderLive = Layer.effect(ChangesetConfigReader, Effect.gen(function* () {
 	const fs = yield* FileSystem.FileSystem;

package/services/ConfigDiscovery.js

@@ -26,6 +26,7 @@ import { FileSystem } from "@effect/platform";
 * ```
 *
 * @since 0.1.0
+* @public
 */
 var ConfigDiscovery = class extends Context.Tag("@savvy-web/silk-effects/ConfigDiscovery")() {};
 /**
@@ -42,6 +43,7 @@ function safeExists(fs, path) {
 * `BunContext.layer` to satisfy this dependency.
 *
 * @since 0.1.0
+* @public
 */
 const ConfigDiscoveryLive = Layer.effect(ConfigDiscovery, Effect.gen(function* () {
 	const fs = yield* FileSystem.FileSystem;

package/services/ManagedSection.js

@@ -70,12 +70,14 @@ function findAllSections(content) {
 * Content operations (`write`, `sync`, `check`) take a {@link SectionBlock}.
 *
 * @since 0.2.0
+* @public
 */
 var ManagedSection = class extends Context.Tag("@savvy-web/silk-effects/ManagedSection")() {};
 /**
 * Live implementation of {@link ManagedSection} backed by `@effect/platform` FileSystem.
 *
 * @since 0.2.0
+* @public
 */
 const ManagedSectionLive = Layer.effect(ManagedSection, Effect.gen(function* () {
 	const fs = yield* FileSystem.FileSystem;

package/services/SilkPublishability.js

@@ -20,7 +20,7 @@ const DEFAULT_REGISTRIES = {
 *
 * @remarks
 * The npm public registry and GitHub Packages both accept provenance attestations through the
-* Sigstore/OIDC trusted-publishing flow, so a {@link PublishTarget} bound to either is marked
+* Sigstore/OIDC trusted-publishing flow, so a `PublishTarget` bound to either is marked
 * `provenance: true` by default — this is what gates the release action's attestation step. JSR
 * and custom registries do not participate and resolve to `false`. Matching is endpoint-based
 * (not target-key based) so a custom key pointed at one of these registries still opts in.
@@ -36,7 +36,7 @@ const provenanceForRegistry = (registry) => {
 	return hostname === "registry.npmjs.org" || hostname === "npm.pkg.github.com";
 };
 /**
-* 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
@@ -44,6 +44,7 @@ const provenanceForRegistry = (registry) => {
 * default. All helpers are static so a consumer sees the full rule surface in one place.
 *
 * @since 0.4.0
+* @public
 */
 var SilkPublishability = class {
 	/**
@@ -52,7 +53,7 @@ var SilkPublishability = class {
 	*
 	* - 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
@@ -115,7 +116,7 @@ var SilkPublishability = class {
 		return [];
 	}
 	/**
-	* 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`.
 	*/
@@ -131,7 +132,7 @@ var SilkPublishability = class {
 	}
 	/**
 	* 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) {
 		return Effect.gen(function* () {
@@ -167,24 +168,26 @@ const readRaw = (fs, packageJsonPath) => fs.readFileString(packageJsonPath).pipe
 *
 * @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
 */
 const readTargetsBinding = (fs, pkgPath) => fs.readFileString(join(pkgPath, "dist", "prod", "targets.json")).pipe(Effect.flatMap((content) => Effect.try({
 	try: () => JSON.parse(content),
 	catch: () => /* @__PURE__ */ new Error("invalid targets.json")
 })), Effect.orElseSucceed(() => 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
 */
 const SilkPublishabilityDetectorLive = Layer.effect(PublishabilityDetector, Effect.gen(function* () {
 	const fs = yield* FileSystem.FileSystem;
@@ -196,13 +199,14 @@ const SilkPublishabilityDetectorLive = Layer.effect(PublishabilityDetector, Effe
 	}) };
 }));
 /**
-* 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
 */
 const PublishabilityDetectorAdaptiveLive = Layer.effect(PublishabilityDetector, Effect.gen(function* () {
 	const fs = yield* FileSystem.FileSystem;

package/services/SilkWorkspaceAnalyzer.js

@@ -16,7 +16,7 @@ import { PackageManagerDetector, TopologicalSorter, WorkspaceDiscovery } from "w
 * 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.
@@ -35,6 +35,7 @@ import { PackageManagerDetector, TopologicalSorter, WorkspaceDiscovery } from "w
 * ```
 *
 * @since 0.2.0
+* @public
 */
 var SilkWorkspaceAnalyzer = class extends Context.Tag("@savvy-web/silk-effects/SilkWorkspaceAnalyzer")() {};
 /**
@@ -105,10 +106,11 @@ function computeReleaseStatus(pkgName, isPrivate, isPublishable, config) {
 * 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
 */
 const SilkWorkspaceAnalyzerLive = Layer.effect(SilkWorkspaceAnalyzer, Effect.gen(function* () {
 	const fs = yield* FileSystem.FileSystem;

package/services/TagStrategy.js

@@ -6,7 +6,7 @@ import { Context, Effect, Layer } from "effect";
 * 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.
 *
@@ -23,6 +23,7 @@ import { Context, Effect, Layer } from "effect";
 * ```
 *
 * @since 0.1.0
+* @public
 */
 var TagStrategy = class extends Context.Tag("@savvy-web/silk-effects/TagStrategy")() {};
 /**
@@ -32,6 +33,7 @@ var TagStrategy = class extends Context.Tag("@savvy-web/silk-effects/TagStrategy
 * All logic is pure: strategy determination and tag formatting involve no I/O.
 *
 * @since 0.1.0
+* @public
 */
 const TagStrategyLive = Layer.succeed(TagStrategy, TagStrategy.of({
 	determine: (versioningResult) => {

package/services/ToolDiscovery.js

@@ -27,6 +27,7 @@ import { PackageManagerDetector, WorkspaceRoot } from "workspaces-effect";
 * ```
 *
 * @since 0.2.0
+* @public
 */
 var ToolDiscovery = class extends Context.Tag("@savvy-web/silk-effects/ToolDiscovery")() {};
 /**
@@ -101,6 +102,7 @@ function extractVersion(output, extractor) {
 * and `WorkspaceRoot` from `workspaces-effect`.
 *
 * @since 0.2.0
+* @public
 */
 const ToolDiscoveryLive = Layer.effect(ToolDiscovery, Effect.gen(function* () {
 	const executor = yield* CommandExecutor.CommandExecutor;

package/services/VersioningStrategy.js

@@ -25,6 +25,7 @@ import { Context, Effect, Layer } from "effect";
 * ```
 *
 * @since 0.1.0
+* @public
 */
 var VersioningStrategy = class extends Context.Tag("@savvy-web/silk-effects/VersioningStrategy")() {};
 /**
@@ -35,6 +36,7 @@ var VersioningStrategy = class extends Context.Tag("@savvy-web/silk-effects/Vers
 * If the config file is absent, an empty `fixed` groups array is assumed.
 *
 * @since 0.1.0
+* @public
 */
 const VersioningStrategyLive = Layer.effect(VersioningStrategy, Effect.gen(function* () {
 	const configReader = yield* ChangesetConfigReader;

package/turbo/index.js

@@ -29,4 +29,4 @@ var turbo_exports = /* @__PURE__ */ __exportAll({
 });
 
 //#endregion
-export { turbo_exports };
+export { AffectedResult, CacheDiagnosis, DryRunParseError, GlobalHashSummary, GraphNode, MissExplanation, NotATurboRepoError, PackageCacheStatus, TaskGraphResult, TurboCache, TurboDigest, TurboDryRun, TurboDryTask, TurboEnvVars, TurboExecError, TurboGlobalCacheInputs, TurboInspector, TurboInspectorLive, TurboNotInstalledError, turbo_exports };

package/utils/ToolCommand.js

@@ -2,11 +2,12 @@ import { Command } from "@effect/platform";
 
 //#region src/utils/ToolCommand.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
 */
 var ToolCommand = class ToolCommand {
 	command;