@savvy-web/mcp 1.3.5 → 1.5.0

package/content/packages/silk-effects/api/variable/versioningstrategytype.md

@@ -1,18 +0,0 @@
----
-id: packages/silk-effects/api/variable/versioningstrategytype
-title: "VersioningStrategyType — silk-effects variable"
-summary: "Versioning strategy classification for a workspace."
-tier: packages
-source: generated
-tags: [silk-effects, api]
-priority: 0.3
-related: []
----
-
-# VersioningStrategyType
-
-Versioning strategy classification for a workspace.
-
-```ts
-VersioningStrategyType: Schema.Literal<["single", "fixed-group", "independent"]>
-```

package/content/packages/silk-effects/api.md

@@ -1,144 +0,0 @@
----
-id: packages/silk-effects/api
-title: "@savvy-web/silk-effects — API reference"
-summary: "@savvy-web/silk-effects API reference: 114 documented symbols."
-tier: packages
-source: generated
-tags: [silk-effects, api]
-priority: 0.4
-related: []
----
-
-# @savvy-web/silk-effects — API reference
-
-## class
-
-- [`AnalyzedWorkspace`](silk://packages/silk-effects/api/class/analyzedworkspace) — A fully analyzed workspace with publish targets, versioning status, and release group membership.
-- [`BiomeSchemaSync`](silk://packages/silk-effects/api/class/biomeschemasync) — Service that keeps the `$schema` URL in Biome config files in sync with a target version.
-- [`BiomeSyncError`](silk://packages/silk-effects/api/class/biomesyncerror) — Raised when a Biome config file cannot be read or its `$schema` URL cannot be updated.
-- [`ChangesetConfig`](silk://packages/silk-effects/api/class/changesetconfig) — Accessor service over a workspace root's `.changeset/config.json`.
-- [`ChangesetConfigError`](silk://packages/silk-effects/api/class/changesetconfigerror) — Raised when the `.changeset/config.json` file cannot be read or decoded.
-- [`ChangesetConfigReader`](silk://packages/silk-effects/api/class/changesetconfigreader) — Service that reads and decodes the `.changeset/config.json` for a given workspace root.
-- [`ConfigDiscovery`](silk://packages/silk-effects/api/class/configdiscovery) — Service that locates named config files within a workspace using priority-ordered search paths.
-- [`ConfigNotFoundError`](silk://packages/silk-effects/api/class/confignotfounderror) — Raised when a config file cannot be located in any of the expected locations.
-- [`ManagedSection`](silk://packages/silk-effects/api/class/managedsection) — Service for managing delimited sections in user-editable files. All methods use dual API (data-first and data-last). Identity-only operations (`read`, `isManaged`) take a SectionDefinition. Content operations (`write`, `sync`, `check`) take a SectionBlock.
-- [`ResolvedTool`](silk://packages/silk-effects/api/class/resolvedtool) — Result of resolving a ToolDefinition. Provides `exec` and `dlx` to build commands for the resolved tool.
-- [`SectionBlock`](silk://packages/silk-effects/api/class/sectionblock) — The content between managed section markers. `Equal` compares normalized content only (trimmed, whitespace-collapsed). Use `diff` to compute line-level differences.
-- [`SectionDefinition`](silk://packages/silk-effects/api/class/sectiondefinition) — Identity envelope for a managed section type. `Equal` compares on `toolName` + `commentStyle`. Use to create a SectionBlock, or `generate()` for a typed factory.
-- [`SectionParseError`](silk://packages/silk-effects/api/class/sectionparseerror) — Raised when a managed section cannot be parsed from a file.
-- [`SectionValidationError`](silk://packages/silk-effects/api/class/sectionvalidationerror) — Raised when a SectionBlock fails validation at creation time.
-- [`SectionWriteError`](silk://packages/silk-effects/api/class/sectionwriteerror) — Raised when a managed section cannot be written to a file.
-- [`ShellSectionDefinition`](silk://packages/silk-effects/api/class/shellsectiondefinition) — Convenience section definition for shell hooks. `commentStyle` is always `"#"` — only `toolName` is required.
-- [`SilkPublishability`](silk://packages/silk-effects/api/class/silkpublishability) — Silk publishability rules over `workspaces-effect`'s `PublishTarget`.
-- [`SilkPublishConfig`](silk://packages/silk-effects/api/class/silkpublishconfig) — Silk-extended publishConfig schema.
-- [`SilkWorkspaceAnalyzer`](silk://packages/silk-effects/api/class/silkworkspaceanalyzer) — Service that performs a full workspace analysis — discovering packages, detecting publishability, computing versioning/tag strategies, and wiring up fixed/linked release groups.
-- [`TagFormatError`](silk://packages/silk-effects/api/class/tagformaterror) — Raised when a git tag string cannot be formatted for the given package name and version.
-- [`TagStrategy`](silk://packages/silk-effects/api/class/tagstrategy) — Service that determines and applies the git-tag naming strategy for a release.
-- [`ToolCommand`](silk://packages/silk-effects/api/class/toolcommand) — Wraps `@effect/platform` `Command.Command` with instance method ergonomics. Use `yield* cmd.string()` instead of `yield* Command.string(cmd)`.
-- [`ToolDefinition`](silk://packages/silk-effects/api/class/tooldefinition) — Declares a CLI tool's identity and resolution constraints. `Equal` compares on `name` only (identity).
-- [`ToolDiscovery`](silk://packages/silk-effects/api/class/tooldiscovery) — Service that resolves CLI tools — locating them globally (PATH) or locally (via package manager), extracting versions, enforcing source and version constraints, and caching results.
-- [`ToolNotFoundError`](silk://packages/silk-effects/api/class/toolnotfounderror)
-- [`ToolResolutionError`](silk://packages/silk-effects/api/class/toolresolutionerror)
-- [`ToolVersionMismatchError`](silk://packages/silk-effects/api/class/toolversionmismatcherror)
-- [`VersioningDetectionError`](silk://packages/silk-effects/api/class/versioningdetectionerror) — Raised when the versioning strategy cannot be determined from the workspace state.
-- [`VersioningStrategy`](silk://packages/silk-effects/api/class/versioningstrategy) — Service that classifies the versioning strategy used by a workspace.
-- [`WorkspaceAnalysis`](silk://packages/silk-effects/api/class/workspaceanalysis) — Full workspace analysis result containing all analyzed workspaces and project-level configuration.
-- [`WorkspaceAnalysisError`](silk://packages/silk-effects/api/class/workspaceanalysiserror) — Raised when workspace analysis fails for a given root directory.
-
-## function
-
-- [`buildSchemaUrl`](silk://packages/silk-effects/api/function/buildschemaurl) — Build the expected Biome JSON schema URL for a given version.
-- [`extractSemver`](silk://packages/silk-effects/api/function/extractsemver) — Strip leading semver range operators from a version string.
-- [`readTargetsBinding`](silk://packages/silk-effects/api/function/readtargetsbinding) — Read the bundler's `<pkgPath>/dist/prod/targets.json` binding via FileSystem.
-- [`savvyBasePreamble`](silk://packages/silk-effects/api/function/savvybasepreamble) — Package-manager detection preamble shared across Silk Suite hook files.
-- [`savvyHooksHygiene`](silk://packages/silk-effects/api/function/savvyhookshygiene) — Repo-hygiene block shared across Silk Suite hook files.
-- [`savvyToolSection`](silk://packages/silk-effects/api/function/savvytoolsection) — Build a consumer's one-line tool section so every consumer calls the shared base helpers identically.
-
-## interface
-
-- [`CommitlintPlugin`](silk://packages/silk-effects/api/interface/commitlintplugin) — Commitlint plugin interface.
-- [`CommitlintUserConfig`](silk://packages/silk-effects/api/interface/commitlintuserconfig) — Commitlint user configuration.
-- [`PromptConfig`](silk://packages/silk-effects/api/interface/promptconfig) — Commitlint prompt configuration.
-- [`PromptSettings`](silk://packages/silk-effects/api/interface/promptsettings) — Commitlint prompt settings.
-- [`PublishablePackage`](silk://packages/silk-effects/api/interface/publishablepackage) — A publishable workspace package and the count of its resolved publish targets.
-- [`RawPackageJson`](silk://packages/silk-effects/api/interface/rawpackagejson) — Raw `package.json` shape consumed by `SilkPublishability.detect`.
-- [`RawPublishConfig`](silk://packages/silk-effects/api/interface/rawpublishconfig) — Raw `publishConfig` shape (the unschematized fields silk rules consult).
-- [`RawTargetObject`](silk://packages/silk-effects/api/interface/rawtargetobject) — A single object-form publish target in the `publishConfig.targets` map (mirrors the bundler's `PublishTargetObject`).
-- [`RulesConfig`](silk://packages/silk-effects/api/interface/rulesconfig) — Commitlint rules configuration.
-- [`TargetBinding`](silk://packages/silk-effects/api/interface/targetbinding) — A resolved registry target from the bundler's `dist/prod/targets.json` binding (one per `publishConfig.targets` key).
-- [`TargetGroupBinding`](silk://packages/silk-effects/api/interface/targetgroupbinding) — A resolved byte-variant group from the bundler's `dist/prod/targets.json` binding.
-- [`TargetsBinding`](silk://packages/silk-effects/api/interface/targetsbinding) — The `dist/prod/targets.json` binding the bundler emits for the release action to consume.
-
-## namespace
-
-- [`Changesets`](silk://packages/silk-effects/api/namespace/changesets)
-- [`Commitlint`](silk://packages/silk-effects/api/namespace/commitlint)
-- [`Lint`](silk://packages/silk-effects/api/namespace/lint)
-- [`Turbo`](silk://packages/silk-effects/api/namespace/turbo)
-
-## type
-
-- [`BiomeSyncOptions`](silk://packages/silk-effects/api/type/biomesyncoptions)
-- [`BiomeSyncResult`](silk://packages/silk-effects/api/type/biomesyncresult)
-- [`ChangesetConfigFile`](silk://packages/silk-effects/api/type/changesetconfigfile)
-- [`ChangesetMode`](silk://packages/silk-effects/api/type/changesetmode) — Changeset operating mode for a workspace root.
-- [`CheckResult`](silk://packages/silk-effects/api/type/checkresult)
-- [`CheckResultDefinition`](silk://packages/silk-effects/api/type/checkresultdefinition) — Result of a check operation.
-- [`CommentStyle`](silk://packages/silk-effects/api/type/commentstyle)
-- [`ConfigDiscoveryOptions`](silk://packages/silk-effects/api/type/configdiscoveryoptions)
-- [`ConfigLocation`](silk://packages/silk-effects/api/type/configlocation)
-- [`ConfigSource`](silk://packages/silk-effects/api/type/configsource)
-- [`RawPublishTargets`](silk://packages/silk-effects/api/type/rawpublishtargets) — The `publishConfig.targets` map, keyed by target id (`npm`, `github`, or a custom key).
-- [`RawTargetValue`](silk://packages/silk-effects/api/type/rawtargetvalue) — A `publishConfig.targets` value: `true` (well-known registry, base name), a string (name override), or an object.
-- [`ResolutionPolicy`](silk://packages/silk-effects/api/type/resolutionpolicy)
-- [`ResolutionPolicyDefinition`](silk://packages/silk-effects/api/type/resolutionpolicydefinition) — What to do when both global and local versions differ.
-- [`RuleApplicability`](silk://packages/silk-effects/api/type/ruleapplicability) — Rule applicability.
-- [`RuleConfigTuple`](silk://packages/silk-effects/api/type/ruleconfigtuple) — Rule configuration tuple.
-- [`RuleSeverity`](silk://packages/silk-effects/api/type/ruleseverity) — Rule severity level. - 0: Disabled - 1: Warning - 2: Error
-- [`SectionDiff`](silk://packages/silk-effects/api/type/sectiondiff)
-- [`SectionDiffDefinition`](silk://packages/silk-effects/api/type/sectiondiffdefinition) — Result of comparing two section contents.
-- [`SilkChangesetConfigFile`](silk://packages/silk-effects/api/type/silkchangesetconfigfile)
-- [`SourceRequirement`](silk://packages/silk-effects/api/type/sourcerequirement)
-- [`SourceRequirementDefinition`](silk://packages/silk-effects/api/type/sourcerequirementdefinition) — Where the tool must be found.
-- [`SyncResult`](silk://packages/silk-effects/api/type/syncresult)
-- [`SyncResultDefinition`](silk://packages/silk-effects/api/type/syncresultdefinition) — Result of a sync operation.
-- [`TagStrategyType`](silk://packages/silk-effects/api/type/tagstrategytype)
-- [`ToolSource`](silk://packages/silk-effects/api/type/toolsource)
-- [`VersionExtractor`](silk://packages/silk-effects/api/type/versionextractor)
-- [`VersionExtractorDefinition`](silk://packages/silk-effects/api/type/versionextractordefinition) — How to extract a version string from a CLI tool.
-- [`VersioningStrategyResult`](silk://packages/silk-effects/api/type/versioningstrategyresult)
-- [`VersioningStrategyType`](silk://packages/silk-effects/api/type/versioningstrategytype)
-
-## variable
-
-- [`BiomeSchemaSyncLive`](silk://packages/silk-effects/api/variable/biomeschemasynclive) — Live implementation of BiomeSchemaSync.
-- [`BiomeSyncOptions`](silk://packages/silk-effects/api/variable/biomesyncoptions) — Options for BiomeSchemaSync operations.
-- [`BiomeSyncResult`](silk://packages/silk-effects/api/variable/biomesyncresult) — Result of a Biome schema URL sync or check operation.
-- [`ChangesetConfigFile`](silk://packages/silk-effects/api/variable/changesetconfigfile)
-- [`ChangesetConfigLive`](silk://packages/silk-effects/api/variable/changesetconfiglive) — Live ChangesetConfig reading via ChangesetConfigReader, cached per root.
-- [`ChangesetConfigReaderLive`](silk://packages/silk-effects/api/variable/changesetconfigreaderlive) — Live implementation of ChangesetConfigReader.
-- [`CheckResult`](silk://packages/silk-effects/api/variable/checkresult)
-- [`CommentStyle`](silk://packages/silk-effects/api/variable/commentstyle) — Comment syntax used to write managed section markers.
-- [`ConfigDiscoveryLive`](silk://packages/silk-effects/api/variable/configdiscoverylive) — Live implementation of ConfigDiscovery.
-- [`ConfigDiscoveryOptions`](silk://packages/silk-effects/api/variable/configdiscoveryoptions) — Options passed to config discovery methods.
-- [`ConfigLocation`](silk://packages/silk-effects/api/variable/configlocation) — The resolved location of a discovered config file.
-- [`ConfigSource`](silk://packages/silk-effects/api/variable/configsource) — The discovery strategy used to locate a config file.
-- [`ManagedSectionLive`](silk://packages/silk-effects/api/variable/managedsectionlive) — Live implementation of ManagedSection backed by `@effect/platform` FileSystem.
-- [`PublishabilityDetectorAdaptiveLive`](silk://packages/silk-effects/api/variable/publishabilitydetectoradaptivelive) — Ignore-aware override of SilkPublishability. `detect` short-circuits to `[]` for changeset-ignored packages, then dispatches on `ChangesetConfig.mode`: `none` → `[]`; `silk` → `SilkPublishability.detect`; `vanilla` → the library default.
-- [`ResolutionPolicy`](silk://packages/silk-effects/api/variable/resolutionpolicy)
-- [`SavvyBaseSection`](silk://packages/silk-effects/api/variable/savvybasesection) — Section identity for the shared package-manager preamble. `toolName` is `"savvy-base"`; pair with savvyBasePreamble to build the block:
-- [`SavvyHooksSection`](silk://packages/silk-effects/api/variable/savvyhookssection) — Section identity for the shared repo-hygiene block. `toolName` is `"savvy-hooks"`; pair with savvyHooksHygiene.
-- [`SectionDiff`](silk://packages/silk-effects/api/variable/sectiondiff)
-- [`SilkChangesetConfigFile`](silk://packages/silk-effects/api/variable/silkchangesetconfigfile)
-- [`SilkPublishabilityDetectorLive`](silk://packages/silk-effects/api/variable/silkpublishabilitydetectorlive) — Override of `workspaces-effect`'s SilkPublishability Tag with pure silk rules.
-- [`SilkWorkspaceAnalyzerLive`](silk://packages/silk-effects/api/variable/silkworkspaceanalyzerlive) — Live implementation of SilkWorkspaceAnalyzer.
-- [`SourceRequirement`](silk://packages/silk-effects/api/variable/sourcerequirement)
-- [`SyncResult`](silk://packages/silk-effects/api/variable/syncresult)
-- [`TagStrategyLive`](silk://packages/silk-effects/api/variable/tagstrategylive) — Live implementation of TagStrategy with no external dependencies.
-- [`TagStrategyType`](silk://packages/silk-effects/api/variable/tagstrategytype) — Git tag naming strategy for a workspace.
-- [`ToolDiscoveryLive`](silk://packages/silk-effects/api/variable/tooldiscoverylive) — Live implementation of ToolDiscovery.
-- [`ToolSource`](silk://packages/silk-effects/api/variable/toolsource) — Where a tool was resolved from.
-- [`VersionExtractor`](silk://packages/silk-effects/api/variable/versionextractor)
-- [`VersioningStrategyLive`](silk://packages/silk-effects/api/variable/versioningstrategylive) — Live implementation of VersioningStrategy.
-- [`VersioningStrategyResult`](silk://packages/silk-effects/api/variable/versioningstrategyresult) — Output of the versioning strategy detection, combining the strategy type with group metadata.
-- [`VersioningStrategyType`](silk://packages/silk-effects/api/variable/versioningstrategytype) — Versioning strategy classification for a workspace.

package/content/packages/silk-effects/index.md

@@ -1,76 +0,0 @@
----
-id: packages/silk-effects/
-title: silk-effects overview
-summary: Load to orient on the shared Effect library and its service map before diving into a service.
-tier: packages
-source: hand
-tags: [silk-effects, effect]
-priority: 0.5
-related: [packages/silk-effects/platform-layers, packages/silk-effects/managed-section, standards/publishability]
----
-
-## What
-
-`@savvy-web/silk-effects` is a platform-agnostic Effect library holding the shared
-conventions of the Silk Suite. It extracts repeated patterns — publishability
-rules, changeset config reading, managed file sections, tool discovery — into one
-package consumed by the `savvy` CLI, `@savvy-web/silk`, GitHub Actions, and build
-scripts. It builds on `@effect/platform` abstractions rather than importing Node or
-Bun APIs directly, so the same service implementations run on any `@effect/platform`
-runtime once the consumer provides a context layer at the edge.
-
-## API
-
-Every service is a `Context.Tag` accessed with `yield*` inside `Effect.gen`. The
-entire public API ships from the single package root — there are no subpath exports.
-
-```typescript
-import {
-  SilkPublishability,
-  ManagedSection, ManagedSectionLive, SectionDefinition, SectionBlock,
-  ToolDiscovery, ToolDiscoveryLive, ToolDefinition,
-} from "@savvy-web/silk-effects";
-```
-
-Service index:
-
-- `SilkPublishability` — static publishability `detect` plus detector layers.
-- `TagStrategy` — git tag formatting (pure, no platform layer).
-- `ChangesetConfig` / `ChangesetConfigReader` — read and query `.changeset/config.json`.
-- `VersioningStrategy` — version resolution.
-- `ManagedSection` — BEGIN/END tool-owned regions in user-editable files.
-- `ConfigDiscovery` — locate config files.
-- `BiomeSchemaSync` — keep the Biome schema in sync.
-- `ToolDiscovery` — resolve and execute project tools (biome, husky, and the rest).
-
-It also hosts the dev-tooling business logic under three namespace exports —
-`Changesets`, `Commitlint`, `Lint` — which the `savvy` CLI and `@savvy-web/silk`
-shims both consume so neither imports the other.
-
-## Layer
-
-Services fall into three platform tiers: pure (no layer), `FileSystem`, and
-`FileSystem` + `CommandExecutor`. See `silk://packages/silk-effects/platform-layers`
-for the full guide. `effect` and `@effect/platform` are peer dependencies;
-`workspaces-effect`, `semver-effect`, `jsonc-effect`, and `yaml-effect` are direct.
-
-## Usage
-
-```typescript
-import { SilkPublishability } from "@savvy-web/silk-effects";
-
-const targets = SilkPublishability.detect("@my-org/pkg", {
-  private: true,
-  publishConfig: { access: "public", targets: ["npm"] },
-});
-// => [PublishTarget { registry: "https://registry.npmjs.org/", access: "public", ... }]
-```
-
-All errors extend `Data.TaggedError` with a `_tag` discriminant, so they are
-pattern-matchable with `Effect.catchTag`.
-
-## Related
-
-Platform layers: `silk://packages/silk-effects/platform-layers`. Managed sections:
-`silk://packages/silk-effects/managed-section`. The publishability rules this
-package encodes: `silk://standards/publishability`.

package/content/packages/silk-effects/managed-section.md

@@ -1,84 +0,0 @@
----
-id: packages/silk-effects/managed-section
-title: ManagedSection
-summary: Load when reading, writing, or syncing tool-owned BEGIN/END regions in user-editable files.
-tier: packages
-source: hand
-tags: [managed-section, effect]
-priority: 0.5
-related: [packages/silk-effects/, packages/silk-effects/platform-layers]
----
-
-## What
-
-`ManagedSection` lets a tool own a delimited region of a file while leaving the
-rest user-editable, using BEGIN/END markers. The motivating case is a husky hook
-that runs a tool's command inside a managed region surrounded by user commands.
-The service ships with value objects — `SectionDefinition` (section identity:
-tool name + comment style) and `SectionBlock` (the content between markers).
-Platform layer: `FileSystem`. Since 0.2.0.
-
-## API
-
-`SectionDefinition` and `SectionBlock` are `Schema.TaggedClass` value objects with
-structural equality — `SectionBlock` compares on normalized (trimmed,
-whitespace-collapsed) content, so whitespace-only differences are equal. Comment
-style is `"#"` (shell/YAML) or `"//"` (C-style); the tool name is uppercased into
-the markers. `SectionDefinition.block(content)` mints a block;
-`.generate(fn)` / `.generateEffect(fn)` build typed factories; `.withValidation`
-attaches a content predicate that throws `SectionValidationError`.
-
-The service Tag exposes (all dual-API, data-first or data-last):
-
-- `read(path, def)` → `SectionBlock | null` (null if no file or no markers).
-- `isManaged(path, def)` → `boolean` (always succeeds).
-- `write(path, block)` → replaces the managed region, appends if markerless,
-  creates the file if absent; preserves content outside the markers.
-- `sync(path, block)` → smart write reporting `SyncResult`: `Created`,
-  `Updated({ diff })`, or `Unchanged`; writes only when different.
-- `syncMany(path, blocks)` → syncs several ordered sections in one file
-  idempotently, inserting missing siblings and normalizing drift; returns one
-  `SyncResult` per block in input order.
-- `check(path, block)` → read-only `CheckResult`: `Found({ isUpToDate, diff })`
-  or `NotFound`.
-- `remove(path, def)` → deletes the span including markers and collapses the
-  leftover blank line; `true` if removed, `false` if absent (missing file → false).
-
-Identity-only operations (`read`, `isManaged`, `remove`) take a `SectionDefinition`;
-content operations take a `SectionBlock`. Errors: `SectionParseError`,
-`SectionWriteError`, `SectionValidationError`.
-
-## Layer
-
-```typescript
-export const ManagedSectionLive: Layer.Layer<ManagedSection, never, FileSystem.FileSystem>;
-```
-
-## Usage
-
-```typescript
-import { Effect } from "effect";
-import { NodeContext } from "@effect/platform-node";
-import { ManagedSection, ManagedSectionLive, SectionDefinition } from "@savvy-web/silk-effects";
-
-const def = SectionDefinition.make({ toolName: "LINT-STAGED" });
-
-await Effect.runPromise(
-  Effect.gen(function* () {
-    const ms = yield* ManagedSection;
-    const result = yield* ms.sync(".husky/pre-commit", def.block("\nnpx lint-staged\n"));
-    // result._tag => "Created" | "Updated" | "Unchanged"
-  }).pipe(Effect.provide(ManagedSectionLive), Effect.provide(NodeContext.layer)),
-);
-```
-
-The `SavvySections` helpers (since 0.5.0) provide ready-made husky-hook shells:
-`SavvyBaseSection` + `savvyBasePreamble()` define a shared package-manager preamble
-(`ROOT`, the `in_ci` predicate, `PM`, `pm_exec`), and `savvyToolSection(toolName,
-command)` builds a consumer's one-line tool section. Pass the base first to
-`syncMany` so `in_ci` and `pm_exec` are defined before a tool section uses them.
-
-## Related
-
-Overview: `silk://packages/silk-effects/`. Layer wiring:
-`silk://packages/silk-effects/platform-layers`.

package/content/packages/silk-effects/platform-layers.md

@@ -1,94 +0,0 @@
----
-id: packages/silk-effects/platform-layers
-title: Providing platform layers
-summary: Load when wiring silk-effects services into a program and deciding which layers to provide.
-tier: packages
-source: hand
-tags: [silk-effects, effect]
-priority: 0.5
-related: [packages/silk-effects/, packages/silk-effects/managed-section]
----
-
-## What
-
-silk-effects is platform-agnostic: services declare their dependencies through
-Effect's `Layer` type system, and the consumer provides concrete implementations at
-the edge of the program. There are three tiers.
-
-## API
-
-**Tier 0 — no platform layer.** Pure services with no I/O. `SilkPublishability.detect`
-is a static needing no layer or runtime. `TagStrategy` is a `Context.Tag`, so provide
-its `TagStrategyLive`.
-
-**Tier 1 — FileSystem.** Read/write services depend on `FileSystem` from
-`@effect/platform`, supplied by the runtime context layer (`NodeContext.layer` or
-`BunContext.layer`). Members: `SilkPublishabilityDetectorLive`,
-`PublishabilityDetectorAdaptiveLive`, `ChangesetConfig`, `ChangesetConfigReader`,
-`VersioningStrategy`, `ManagedSection`, `ConfigDiscovery`, `BiomeSchemaSync`.
-
-**Tier 2 — FileSystem + CommandExecutor.** `ToolDiscovery` also needs
-`CommandExecutor` plus `PackageManagerDetector` and `WorkspaceRoot` from
-`workspaces-effect`. `NodeContext.layer` provides `FileSystem` and `CommandExecutor`.
-
-Dependency graph:
-
-```text
-SilkPublishability.detect          (pure static, no layer)
-TagStrategy                        (no deps)
-SilkPublishabilityDetectorLive     --> FileSystem
-PublishabilityDetectorAdaptiveLive --> FileSystem, ChangesetConfig
-ChangesetConfigReader              --> FileSystem
-ChangesetConfig                    --> ChangesetConfigReader
-VersioningStrategy                 --> ChangesetConfigReader
-ManagedSection, ConfigDiscovery, BiomeSchemaSync --> FileSystem
-ToolDiscovery                      --> CommandExecutor, PackageManagerDetector, WorkspaceRoot
-```
-
-## Layer
-
-Compose with `Effect.provide` / `Layer.mergeAll`; services sharing a dependency
-(like `FileSystem`) need the platform layer provided once.
-
-```typescript
-import { Effect } from "effect";
-import { NodeContext } from "@effect/platform-node";
-import { ManagedSection, ManagedSectionLive } from "@savvy-web/silk-effects";
-
-await Effect.runPromise(
-  Effect.gen(function* () {
-    const ms = yield* ManagedSection;
-    // ...
-  }).pipe(Effect.provide(ManagedSectionLive), Effect.provide(NodeContext.layer)),
-);
-```
-
-## Usage
-
-The adaptive detector overrides `workspaces-effect`'s `PublishabilityDetector` Tag
-and dispatches by changeset mode; it needs `ChangesetConfig`, which needs
-`ChangesetConfigReader`:
-
-```typescript
-import { Layer } from "effect";
-import { NodeContext } from "@effect/platform-node";
-import {
-  ChangesetConfigLive, ChangesetConfigReaderLive,
-  PublishabilityDetectorAdaptiveLive,
-} from "@savvy-web/silk-effects";
-
-const layer = Layer.mergeAll(
-  PublishabilityDetectorAdaptiveLive.pipe(Layer.provide(ChangesetConfigLive)),
-  ChangesetConfigLive,
-  ChangesetConfigReaderLive,
-).pipe(Layer.provide(NodeContext.layer));
-```
-
-For unconditional Silk rules without changeset awareness, use
-`SilkPublishabilityDetectorLive`, which needs only the platform layer. For tests,
-provide a mock `FileSystem` layer in place of `NodeContext.layer`.
-
-## Related
-
-Overview: `silk://packages/silk-effects/`. ManagedSection:
-`silk://packages/silk-effects/managed-section`.

package/content/packages/templates/api/function/createbiome.md

@@ -1,26 +0,0 @@
----
-id: packages/templates/api/function/createbiome
-title: "createBiome — templates function"
-summary: "Generates a `biome.jsonc` configuration file entry."
-tier: packages
-source: generated
-tags: [templates, api]
-priority: 0.3
-related: []
----
-
-# createBiome
-
-Generates a `biome.jsonc` configuration file entry.
-
-```ts
-function createBiome(options: unknown): TemplateEntry[];
-```
-
-## Parameters
-
-- `options` `unknown` — the Biome configuration options
-
-## Returns
-
-an array containing the generated `biome.jsonc` entry

package/content/packages/templates/api/function/createchangeset.md

@@ -1,26 +0,0 @@
----
-id: packages/templates/api/function/createchangeset
-title: "createChangeset — templates function"
-summary: "Generates a `.changeset/config.json` configuration file entry."
-tier: packages
-source: generated
-tags: [templates, api]
-priority: 0.3
-related: []
----
-
-# createChangeset
-
-Generates a `.changeset/config.json` configuration file entry.
-
-```ts
-function createChangeset(options: unknown): TemplateEntry[];
-```
-
-## Parameters
-
-- `options` `unknown` — the Changesets configuration options
-
-## Returns
-
-an array containing the generated changeset config entry

package/content/packages/templates/api/function/creategitignore.md

@@ -1,26 +0,0 @@
----
-id: packages/templates/api/function/creategitignore
-title: "createGitignore — templates function"
-summary: "Generates a `.gitignore` file entry."
-tier: packages
-source: generated
-tags: [templates, api]
-priority: 0.3
-related: []
----
-
-# createGitignore
-
-Generates a `.gitignore` file entry.
-
-```ts
-function createGitignore(options: unknown): TemplateEntry[];
-```
-
-## Parameters
-
-- `options` `unknown` — the gitignore configuration options
-
-## Returns
-
-an array containing the generated `.gitignore` entry

package/content/packages/templates/api/function/createpackagejson.md

@@ -1,26 +0,0 @@
----
-id: packages/templates/api/function/createpackagejson
-title: "createPackageJson — templates function"
-summary: "Generates a sorted `package.json` file entry."
-tier: packages
-source: generated
-tags: [templates, api]
-priority: 0.3
-related: []
----
-
-# createPackageJson
-
-Generates a sorted `package.json` file entry.
-
-```ts
-function createPackageJson(options: unknown): TemplateEntry[];
-```
-
-## Parameters
-
-- `options` `unknown` — the package.json configuration options
-
-## Returns
-
-an array containing the generated `package.json` entry

package/content/packages/templates/api/function/createpnpmworkspace.md

@@ -1,26 +0,0 @@
----
-id: packages/templates/api/function/createpnpmworkspace
-title: "createPnpmWorkspace — templates function"
-summary: "Generates a `pnpm-workspace.yaml` file entry."
-tier: packages
-source: generated
-tags: [templates, api]
-priority: 0.3
-related: []
----
-
-# createPnpmWorkspace
-
-Generates a `pnpm-workspace.yaml` file entry.
-
-```ts
-function createPnpmWorkspace(options: unknown): TemplateEntry[];
-```
-
-## Parameters
-
-- `options` `unknown` — the pnpm workspace configuration options
-
-## Returns
-
-an array containing the generated `pnpm-workspace.yaml` entry

package/content/packages/templates/api/function/createreadme.md

@@ -1,26 +0,0 @@
----
-id: packages/templates/api/function/createreadme
-title: "createReadme — templates function"
-summary: "Generates a `README.md` file entry."
-tier: packages
-source: generated
-tags: [templates, api]
-priority: 0.3
-related: []
----
-
-# createReadme
-
-Generates a `README.md` file entry.
-
-```ts
-function createReadme(options: unknown): TemplateEntry[];
-```
-
-## Parameters
-
-- `options` `unknown` — the README configuration options
-
-## Returns
-
-an array containing the generated `README.md` entry

package/content/packages/templates/api/function/createtsconfig.md

@@ -1,26 +0,0 @@
----
-id: packages/templates/api/function/createtsconfig
-title: "createTsConfig — templates function"
-summary: "Generates a `tsconfig.json` file entry."
-tier: packages
-source: generated
-tags: [templates, api]
-priority: 0.3
-related: []
----
-
-# createTsConfig
-
-Generates a `tsconfig.json` file entry.
-
-```ts
-function createTsConfig(options: unknown): TemplateEntry[];
-```
-
-## Parameters
-
-- `options` `unknown` — the TypeScript configuration options
-
-## Returns
-
-an array containing the generated `tsconfig.json` entry

package/content/packages/templates/api/function/createturboroot.md

@@ -1,26 +0,0 @@
----
-id: packages/templates/api/function/createturboroot
-title: "createTurboRoot — templates function"
-summary: "Generates a root `turbo.json` file entry."
-tier: packages
-source: generated
-tags: [templates, api]
-priority: 0.3
-related: []
----
-
-# createTurboRoot
-
-Generates a root `turbo.json` file entry.
-
-```ts
-function createTurboRoot(options: unknown): TemplateEntry[];
-```
-
-## Parameters
-
-- `options` `unknown` — the root Turborepo configuration options
-
-## Returns
-
-an array containing the generated root `turbo.json` entry