@savvy-web/silk 2.0.0 → 2.1.0

package/packages/silk-effects/dist/dev/pkg/changesets/services/deps-regen.js

@@ -1,371 +0,0 @@
-import { ChangesetConfigReaderLive } from "../../services/ChangesetConfigReader.js";
-import { ChangesetConfig, ChangesetConfigLive } from "../../services/ChangesetConfig.js";
-import { WorkspaceDiscovery } from "../../../../../../../node_modules/.pnpm/workspaces-effect@2.0.1_@effect_platform@0.96.2_effect@3.21.4__effect@3.21.4/node_modules/workspaces-effect/services/WorkspaceDiscovery.js";
-import { PointInTimeWorkspace } from "../../../../../../../node_modules/.pnpm/workspaces-effect@2.0.1_@effect_platform@0.96.2_effect@3.21.4__effect@3.21.4/node_modules/workspaces-effect/services/PointInTimeWorkspace.js";
-import { PointInTimeWorkspaceLive } from "../../../../../../../node_modules/.pnpm/workspaces-effect@2.0.1_@effect_platform@0.96.2_effect@3.21.4__effect@3.21.4/node_modules/workspaces-effect/layers/PointInTimeWorkspaceLive.js";
-import { PublishabilityDetector } from "../../../../../../../node_modules/.pnpm/workspaces-effect@2.0.1_@effect_platform@0.96.2_effect@3.21.4__effect@3.21.4/node_modules/workspaces-effect/services/PublishabilityDetector.js";
-import { WorkspaceDiscoveryLive } from "../../../../../../../node_modules/.pnpm/workspaces-effect@2.0.1_@effect_platform@0.96.2_effect@3.21.4__effect@3.21.4/node_modules/workspaces-effect/layers/WorkspaceDiscoveryLive.js";
-import { WorkspaceRootLive } from "../../../../../../../node_modules/.pnpm/workspaces-effect@2.0.1_@effect_platform@0.96.2_effect@3.21.4__effect@3.21.4/node_modules/workspaces-effect/layers/WorkspaceRootLive.js";
-import { PublishabilityDetectorAdaptiveLive } from "../../services/SilkPublishability.js";
-import { ChangesetIOError } from "../errors.js";
-import { serializeDependencyTableToMarkdown, sortDependencyRows } from "../utils/dependency-table.js";
-import { ConfigInspector, ConfigInspectorLive } from "./config-inspector.js";
-import { computeWorkspaceDependencyDiffs } from "../utils/dep-diff.js";
-import { gitMergeBase } from "../utils/git.js";
-import { listPublishablePackageNames } from "../utils/publishability.js";
-import { Context, Effect, Layer, Option } from "effect";
-import { FileSystem } from "@effect/platform";
-import { join, resolve } from "node:path";
-
-//#region ../silk-effects/dist/dev/pkg/changesets/services/deps-regen.js
-/**
-* `Changesets.DepsRegen` service — lift the `deps regen` / `deps detect`
-* orchestration out of the CLI into a `Context.Tag` service with a
-* `plan()` / `execute()` split.
-*
-* @remarks
-* `plan()` computes the cumulative dependency diff (merge-base → working
-* tree by default, or between two explicit refs) by snapshotting both
-* sides through `PointInTimeWorkspace`, which resolves `catalog:` /
-* `workspace:` specifiers against each ref's own catalogs and package
-* versions before diffing. It drops `devDependency` rows (unless
-* `includeDevDeps`), and returns a complete {@link RegenPlan}
-* (target filenames + stale-changeset deletes) WITHOUT touching the
-* filesystem. `execute()` applies a plan — writing the fresh changesets
-* first, then deleting the stale pure-dependency ones (so an interrupted
-* run loses nothing and is safely re-runnable).
-*
-* This is the single source of truth for regen/detect: the CLI commands
-* and MCP tools are thin adapters over this service.
-*
-* @see {@link DepsRegen} for the service tag
-* @see {@link DepsRegenLive} for the production layer
-*
-*/
-const ADJECTIVES = [
-	"brave",
-	"clever",
-	"swift",
-	"silver",
-	"lucky",
-	"happy",
-	"calm",
-	"bright",
-	"quiet",
-	"wild"
-];
-const NOUNS = [
-	"dogs",
-	"cats",
-	"wolves",
-	"foxes",
-	"cups",
-	"ships",
-	"trees",
-	"owls",
-	"cranes",
-	"hills"
-];
-const VERBS = [
-	"laugh",
-	"dream",
-	"fly",
-	"sing",
-	"dance",
-	"wander",
-	"soar",
-	"rest",
-	"leap",
-	"ponder"
-];
-function pickRandomTriplet() {
-	return `${ADJECTIVES[Math.floor(Math.random() * ADJECTIVES.length)]}-${NOUNS[Math.floor(Math.random() * NOUNS.length)]}-${VERBS[Math.floor(Math.random() * VERBS.length)]}`;
-}
-/**
-* Pick a `<adjective>-<noun>-<verb>` filename slug that does not collide
-* with an existing `.changeset/*.md` OR with a slug already claimed
-* earlier in the same {@link RegenPlan.toWrite} computation. `plan()`
-* never writes to disk, so an on-disk existence check alone cannot see
-* slugs chosen moments earlier in the same call — the `chosen` set closes
-* that gap. The triplet space is 1,000 combinations, so a busy repo can
-* plausibly exhaust it across runs; fall back to a timestamp suffix after
-* 20 unlucky picks.
-*
-* @param fileExists - Effectful on-disk existence check (never fails; a
-*   filesystem error is treated as "does not exist" so filename selection
-*   degrades gracefully rather than blocking the plan).
-* @param changesetDir - Directory checked for on-disk collisions.
-* @param chosen - Basenames (without extension) already picked within this plan;
-*   the picked candidate is added to this set before returning.
-* @internal
-*/
-function randomFilename(fileExists, changesetDir, chosen) {
-	return Effect.gen(function* () {
-		for (let i = 0; i < 20; i++) {
-			const candidate = pickRandomTriplet();
-			if (!chosen.has(candidate) && !(yield* fileExists(join(changesetDir, `${candidate}.md`)))) {
-				chosen.add(candidate);
-				return candidate;
-			}
-		}
-		let attempt = 0;
-		let fallback = `${pickRandomTriplet()}-${Date.now()}`;
-		while (chosen.has(fallback) || (yield* fileExists(join(changesetDir, `${fallback}.md`)))) fallback = `${pickRandomTriplet()}-${Date.now()}-${++attempt}`;
-		chosen.add(fallback);
-		return fallback;
-	});
-}
-/**
-* Strict detection of "pure dependency changesets" per the documented
-* rules: single-package frontmatter, single `## Dependencies` heading,
-* no other body content beyond that section.
-*
-* @param content - Raw `.changeset/*.md` file contents.
-* @returns `{ isPure, package }` — `isPure` is `true` only for a
-*   single-package, Dependencies-only changeset; `package` is the sole
-*   frontmatter package name (or `null` when not pure).
-*
-* @public
-*/
-function isPureDependencyChangeset(content) {
-	const fmMatch = content.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
-	if (!fmMatch) return {
-		isPure: false,
-		package: null
-	};
-	const frontmatter = fmMatch[1];
-	const body = (fmMatch[2] ?? "").trim();
-	const fmLines = frontmatter.split(/\r?\n/).filter((l) => l.trim().length > 0 && !/^\s*#/.test(l));
-	if (fmLines.length !== 1) return {
-		isPure: false,
-		package: null
-	};
-	const pkgMatch = fmLines[0].match(/^\s*["']?([^"':\s]+)["']?\s*:\s*([a-z]+)\s*$/);
-	if (!pkgMatch) return {
-		isPure: false,
-		package: null
-	};
-	const pkg = pkgMatch[1];
-	const bodyTrimmed = body.replace(/^\s+/, "");
-	if (!/^## Dependencies\b/.test(bodyTrimmed)) return {
-		isPure: false,
-		package: null
-	};
-	if ((bodyTrimmed.match(/^## /gm) ?? []).length !== 1) return {
-		isPure: false,
-		package: null
-	};
-	if (/^# /m.test(bodyTrimmed)) return {
-		isPure: false,
-		package: null
-	};
-	return {
-		isPure: true,
-		package: pkg
-	};
-}
-/**
-* List `.changeset/*.md` files (excluding `README.md`) in `changesetDir`.
-* A missing directory is today's behavior for "no changesets yet" and
-* resolves to an empty list; any OTHER failure (e.g. a directory that
-* exists but cannot be read) is a loud {@link ChangesetIOError} — an
-* unreadable `.changeset` dir must not silently masquerade as "no
-* changesets".
-*/
-const listChangesetFiles = (fs, changesetDir) => fs.readDirectory(changesetDir).pipe(Effect.map((names) => names.filter((f) => f.endsWith(".md") && f !== "README.md").map((f) => join(changesetDir, f))), Effect.catchAll((e) => e._tag === "SystemError" && e.reason === "NotFound" ? Effect.succeed([]) : Effect.fail(new ChangesetIOError({
-	path: changesetDir,
-	operation: "list",
-	reason: String(e)
-}))));
-/**
-* Pure-dependency changesets found in `changesetDir`. An individual file
-* that cannot be read (e.g. removed mid-scan, permission race) is skipped —
-* today's semantics — while a failure to list the directory itself
-* propagates as a loud {@link ChangesetIOError}.
-*/
-const findPureDependencyChangesets = (fs, changesetDir) => Effect.gen(function* () {
-	const files = yield* listChangesetFiles(fs, changesetDir);
-	const result = [];
-	for (const file of files) {
-		const content = yield* fs.readFileString(file).pipe(Effect.option);
-		if (Option.isNone(content)) continue;
-		const detection = isPureDependencyChangeset(content.value);
-		if (detection.isPure && detection.package) result.push({
-			file,
-			package: detection.package
-		});
-	}
-	return result;
-});
-/**
-* Mixed dependency changesets (have a `## Dependencies` heading but fail
-* the strict pure-changeset test) found in `changesetDir`. Same
-* skip-unreadable-file / loud-list-failure semantics as
-* {@link findPureDependencyChangesets}.
-*/
-const findMixedDependencyChangesets = (fs, changesetDir) => Effect.gen(function* () {
-	const files = yield* listChangesetFiles(fs, changesetDir);
-	const result = [];
-	for (const file of files) {
-		const content = yield* fs.readFileString(file).pipe(Effect.option);
-		if (Option.isNone(content)) continue;
-		if (/^## Dependencies\b/m.test(content.value) && !isPureDependencyChangeset(content.value).isPure) result.push(file);
-	}
-	return result;
-});
-/**
-* Render a single-package, patch-bump changeset for a diff whose rows are
-* already resolved (per-side, inside {@link computeWorkspaceDependencyDiffs})
-* and devDep-filtered.
-*/
-function renderChangesetContent(diff) {
-	return `${`---\n"${diff.package}": patch\n---`}\n\n## Dependencies\n\n${serializeDependencyTableToMarkdown([...diff.rows])}\n`;
-}
-/**
-* @internal
-*/
-const DepsRegenBase = Context.Tag("Changesets/DepsRegen")();
-/**
-* Effect service tag for {@link DepsRegenShape}.
-*
-* @example
-* ```typescript
-* import { Effect } from "effect";
-* import { Changesets } from "@savvy-web/silk-effects";
-*
-* const program = Effect.gen(function* () {
-*   const svc = yield* Changesets.DepsRegen;
-*   const plan = yield* svc.plan({ cwd: process.cwd() });
-*   return yield* svc.execute(plan);
-* });
-* ```
-*
-* @public
-*/
-var DepsRegen = class extends DepsRegenBase {};
-/**
-* Build a {@link DepsRegenShape} that closes over already-resolved service
-* implementations, keeping the public `plan`/`execute` signatures
-* requirement-free (`R = never`).
-*/
-function makeShape(pit, inspector, discovery, detector, config, fs) {
-	const provideDetector = Layer.succeed(PublishabilityDetector, detector);
-	const fileExists = (p) => fs.exists(p).pipe(Effect.orElseSucceed(() => false));
-	const plan = (options) => Effect.gen(function* () {
-		const resolvedCwd = resolve(options.cwd);
-		const changesetDir = join(resolvedCwd, ".changeset");
-		let fromRef = options.from;
-		if (!fromRef) {
-			let baseBranch = options.base;
-			if (!baseBranch) baseBranch = (yield* inspector.inspect(resolvedCwd).pipe(Effect.catchTag("ConfigurationError", () => Effect.succeed({ baseBranch: "main" })))).baseBranch;
-			fromRef = yield* gitMergeBase(resolvedCwd, baseBranch);
-		}
-		const rawDiffs = computeWorkspaceDependencyDiffs(yield* pit.at(fromRef, { cwd: resolvedCwd }), options.to ? yield* pit.at(options.to, { cwd: resolvedCwd }) : yield* pit.worktree({ cwd: resolvedCwd }));
-		const targetPkg = options.package;
-		const livePackages = yield* discovery.listPackages(resolvedCwd);
-		const publishable = yield* listPublishablePackageNames(livePackages, resolvedCwd).pipe(Effect.provide(provideDetector));
-		const versionPrivate = yield* config.versionPrivate(resolvedCwd);
-		const inScope = /* @__PURE__ */ new Set();
-		for (const pkg of livePackages) {
-			if (yield* config.isIgnored(pkg.name, resolvedCwd)) continue;
-			if (publishable.has(pkg.name) || versionPrivate) inScope.add(pkg.name);
-		}
-		const targetIgnored = targetPkg ? yield* config.isIgnored(targetPkg, resolvedCwd) : false;
-		const keepDevDeps = options.includeDevDeps === true;
-		const scoped = targetPkg ? targetIgnored ? [] : rawDiffs.filter((d) => d.package === targetPkg) : rawDiffs.filter((d) => inScope.has(d.package));
-		const resolved = [];
-		for (const diff of scoped) {
-			const rows = keepDevDeps ? [...diff.rows] : diff.rows.filter((r) => r.type !== "devDependency");
-			if (rows.length > 0) resolved.push({
-				...diff,
-				rows: sortDependencyRows(rows)
-			});
-		}
-		const existingPure = yield* findPureDependencyChangesets(fs, changesetDir);
-		const skippedMixed = yield* findMixedDependencyChangesets(fs, changesetDir);
-		const toDelete = targetPkg ? targetIgnored ? [] : existingPure.filter((p) => p.package === targetPkg) : existingPure.filter((p) => inScope.has(p.package));
-		const chosenFilenames = /* @__PURE__ */ new Set();
-		const toWrite = [];
-		for (const diff of resolved) {
-			const filename = yield* randomFilename(fileExists, changesetDir, chosenFilenames);
-			toWrite.push({
-				file: join(changesetDir, `${filename}.md`),
-				package: diff.package,
-				diff
-			});
-		}
-		return {
-			toDelete,
-			toWrite,
-			skippedMixed
-		};
-	});
-	const execute = (plan) => Effect.gen(function* () {
-		const deleted = [];
-		const written = [];
-		for (const entry of plan.toWrite) {
-			yield* fs.writeFileString(entry.file, renderChangesetContent(entry.diff)).pipe(Effect.mapError((e) => new ChangesetIOError({
-				path: entry.file,
-				operation: "write",
-				reason: String(e)
-			})));
-			written.push(entry.file);
-		}
-		for (const entry of plan.toDelete) if (yield* Effect.isSuccess(fs.remove(entry.file))) deleted.push(entry.file);
-		return {
-			deleted,
-			written,
-			skippedMixed: plan.skippedMixed
-		};
-	});
-	return {
-		plan,
-		execute
-	};
-}
-/**
-* Live layer for {@link DepsRegen}.
-*
-* Requires `PointInTimeWorkspace`, `WorkspaceDiscovery`,
-* `PublishabilityDetector` (all from `workspaces-effect`),
-* {@link ConfigInspector}, {@link ChangesetConfig}, and
-* `FileSystem.FileSystem` (resolved once at construction and closed over by
-* the shape, keeping `plan`/`execute` themselves requirement-free).
-*
-* @public
-*/
-const DepsRegenLive = Layer.effect(DepsRegen, Effect.gen(function* () {
-	return makeShape(yield* PointInTimeWorkspace, yield* ConfigInspector, yield* WorkspaceDiscovery, yield* PublishabilityDetector, yield* ChangesetConfig, yield* FileSystem.FileSystem);
-}));
-const WorkspaceGraph = Layer.mergeAll(WorkspaceRootLive, WorkspaceDiscoveryLive.pipe(Layer.provide(WorkspaceRootLive)));
-const ConfigGraph = ChangesetConfigLive.pipe(Layer.provide(ChangesetConfigReaderLive));
-/**
-* Batteries-included {@link DepsRegen} layer: silk's opinionated default
-* composition of the full dependency graph. Only the platform services
-* remain — note that {@link PointInTimeWorkspace} reads git history, so
-* this layer genuinely requires `CommandExecutor` in addition to
-* `FileSystem`/`Path`: provide a git-capable platform layer
-* (`NodeContext.layer`), not a bare filesystem-only layer.
-*
-* Gating uses silk's adaptive publishability detector
-* ({@link PublishabilityDetectorAdaptiveLive}), so the default semantics
-* are "versionable minus ignored" — identical to the savvy CLI and MCP
-* runtimes. Consumers who need to swap any dependency (test detectors,
-* alternate config sources) should keep composing {@link DepsRegenLive}
-* directly; this layer is purely additive.
-*
-* @example
-* ```typescript
-* import { NodeContext } from "@effect/platform-node";
-* import { Layer } from "effect";
-* import { Changesets } from "@savvy-web/silk-effects";
-*
-* const depsRegen = Changesets.DepsRegenDefault.pipe(Layer.provide(NodeContext.layer));
-* ```
-*
-* @public
-*/
-const DepsRegenDefault = DepsRegenLive.pipe(Layer.provide(PointInTimeWorkspaceLive.pipe(Layer.provide(WorkspaceGraph))), Layer.provide(ConfigInspectorLive.pipe(Layer.provide(Layer.mergeAll(ChangesetConfigReaderLive, WorkspaceGraph)))), Layer.provide(PublishabilityDetectorAdaptiveLive.pipe(Layer.provide(ConfigGraph))), Layer.provide(ConfigGraph), Layer.provide(WorkspaceGraph));
-
-//#endregion
-export { DepsRegen, DepsRegenBase, DepsRegenDefault, DepsRegenLive, isPureDependencyChangeset };

package/packages/silk-effects/dist/dev/pkg/changesets/services/github.cjs

@@ -1,160 +0,0 @@
-const require_errors = require('../errors.cjs');
-const require_github_info = require('../vendor/github-info.cjs');
-let effect = require("effect");
-
-//#region ../silk-effects/dist/dev/pkg/changesets/services/github.js
-/**
-* Base class for GitHubService.
-*
-* @privateRemarks
-* This export is required for api-extractor documentation generation.
-* Effect's Context.Tag creates an anonymous base class that must be
-* explicitly exported to avoid "forgotten export" warnings. Do not delete.
-*
-* @internal
-*/
-const GitHubServiceBase = effect.Context.Tag("GitHubService")();
-/**
-* Effect service tag for GitHub API operations.
-*
-* Provides dependency-injected access to GitHub commit metadata lookups.
-* Use `yield* GitHubService` inside an `Effect.gen` block to obtain the
-* service instance.
-*
-* @remarks
-* This tag follows the standard Effect `Context.Tag` pattern. Two layers
-* are provided out of the box:
-*
-* - {@link GitHubLive} — production layer backed by the GitHub REST API
-* - {@link makeGitHubTest} — factory for deterministic test layers
-*
-* @example
-* ```typescript
-* import { Effect, Layer } from "effect";
-* import { GitHubService, GitHubLive } from "\@savvy-web/changesets";
-*
-* const program = Effect.gen(function* () {
-*   const github = yield* GitHubService;
-*   const info = yield* github.getInfo({
-*     commit: "abc1234567890",
-*     repo: "savvy-web/changesets",
-*   });
-*   console.log(info.user, info.pull, info.links);
-* });
-*
-* // Provide the live layer and run
-* Effect.runPromise(program.pipe(Effect.provide(GitHubLive)));
-* ```
-*
-* @example Creating a test layer with canned responses
-* ```typescript
-* import { Effect } from "effect";
-* import type { GitHubCommitInfo } from "\@savvy-web/changesets";
-* import { GitHubService, makeGitHubTest } from "\@savvy-web/changesets";
-*
-* const testResponses = new Map<string, GitHubCommitInfo>([
-*   ["abc1234", { user: "octocat", pull: 42, links: { pull: "#42", user: "\@octocat" } }],
-* ]);
-*
-* const TestLayer = makeGitHubTest(testResponses);
-*
-* const program = Effect.gen(function* () {
-*   const github = yield* GitHubService;
-*   return yield* github.getInfo({ commit: "abc1234", repo: "owner/repo" });
-* });
-*
-* Effect.runPromise(program.pipe(Effect.provide(TestLayer)));
-* ```
-*
-* @see {@link GitHubServiceShape} for the service interface
-* @see {@link GitHubLive} for the production layer
-* @see {@link makeGitHubTest} for creating test layers
-* @see {@link GitHubServiceBase} for the api-extractor base class
-*
-* @public
-*/
-var GitHubService = class extends GitHubServiceBase {};
-/**
-* Production layer for {@link GitHubService}.
-*
-* Delegates to `\@changesets/get-github-info` to fetch commit metadata
-* from the GitHub REST API. Requires a `GITHUB_TOKEN` environment variable
-* to be set for authenticated requests.
-*
-* @remarks
-* This layer is used by the `\@savvy-web/changesets/changelog` entry point
-* to resolve commit hashes into PR numbers and author attribution. It is
-* composed with {@link MarkdownLive} in the changelog formatter's
-* `MainLayer`.
-*
-* @example
-* ```typescript
-* import { Effect } from "effect";
-* import { GitHubService, GitHubLive } from "\@savvy-web/changesets";
-*
-* const program = Effect.gen(function* () {
-*   const github = yield* GitHubService;
-*   return yield* github.getInfo({ commit: "abc1234", repo: "owner/repo" });
-* });
-*
-* Effect.runPromise(program.pipe(Effect.provide(GitHubLive)));
-* ```
-*
-* @public
-*/
-const GitHubLive = effect.Layer.succeed(GitHubService, { getInfo: require_github_info.getGitHubInfo });
-/**
-* Create a test layer for {@link GitHubService} with pre-configured responses.
-*
-* Returns a `Layer` that resolves commit hashes from the provided `Map`.
-* Lookups for commits not present in the map fail with a
-* {@link GitHubApiError}.
-*
-* @remarks
-* This helper is the recommended way to test code that depends on
-* `GitHubService` without making real API calls. Provide the layer
-* via `Effect.provide` in your test setup.
-*
-* @param responses - A `Map` of full commit hash to {@link GitHubCommitInfo} objects
-* @returns A `Layer` providing the {@link GitHubService} with deterministic responses
-*
-* @example
-* ```typescript
-* import { Effect } from "effect";
-* import type { GitHubCommitInfo } from "\@savvy-web/changesets";
-* import { GitHubService, makeGitHubTest } from "\@savvy-web/changesets";
-*
-* const responses = new Map<string, GitHubCommitInfo>([
-*   ["abc1234", { user: "octocat", pull: 42, links: { pull: "#42", user: "\@octocat" } }],
-* ]);
-*
-* const TestGitHub = makeGitHubTest(responses);
-*
-* const program = Effect.gen(function* () {
-*   const github = yield* GitHubService;
-*   return yield* github.getInfo({ commit: "abc1234", repo: "owner/repo" });
-* });
-*
-* // In a Vitest test:
-* const result = await Effect.runPromise(program.pipe(Effect.provide(TestGitHub)));
-* // result.user === "octocat"
-* ```
-*
-* @public
-*/
-function makeGitHubTest(responses) {
-	return effect.Layer.succeed(GitHubService, { getInfo: (params) => {
-		const info = responses.get(params.commit);
-		if (info) return effect.Effect.succeed(info);
-		return effect.Effect.fail(new require_errors.GitHubApiError({
-			operation: "getInfo",
-			reason: `No mock response for commit ${params.commit}`
-		}));
-	} });
-}
-
-//#endregion
-exports.GitHubLive = GitHubLive;
-exports.GitHubService = GitHubService;
-exports.GitHubServiceBase = GitHubServiceBase;
-exports.makeGitHubTest = makeGitHubTest;

package/packages/silk-effects/dist/dev/pkg/changesets/services/github.js

@@ -1,157 +0,0 @@
-import { GitHubApiError } from "../errors.js";
-import { getGitHubInfo } from "../vendor/github-info.js";
-import { Context, Effect, Layer } from "effect";
-
-//#region ../silk-effects/dist/dev/pkg/changesets/services/github.js
-/**
-* Base class for GitHubService.
-*
-* @privateRemarks
-* This export is required for api-extractor documentation generation.
-* Effect's Context.Tag creates an anonymous base class that must be
-* explicitly exported to avoid "forgotten export" warnings. Do not delete.
-*
-* @internal
-*/
-const GitHubServiceBase = Context.Tag("GitHubService")();
-/**
-* Effect service tag for GitHub API operations.
-*
-* Provides dependency-injected access to GitHub commit metadata lookups.
-* Use `yield* GitHubService` inside an `Effect.gen` block to obtain the
-* service instance.
-*
-* @remarks
-* This tag follows the standard Effect `Context.Tag` pattern. Two layers
-* are provided out of the box:
-*
-* - {@link GitHubLive} — production layer backed by the GitHub REST API
-* - {@link makeGitHubTest} — factory for deterministic test layers
-*
-* @example
-* ```typescript
-* import { Effect, Layer } from "effect";
-* import { GitHubService, GitHubLive } from "\@savvy-web/changesets";
-*
-* const program = Effect.gen(function* () {
-*   const github = yield* GitHubService;
-*   const info = yield* github.getInfo({
-*     commit: "abc1234567890",
-*     repo: "savvy-web/changesets",
-*   });
-*   console.log(info.user, info.pull, info.links);
-* });
-*
-* // Provide the live layer and run
-* Effect.runPromise(program.pipe(Effect.provide(GitHubLive)));
-* ```
-*
-* @example Creating a test layer with canned responses
-* ```typescript
-* import { Effect } from "effect";
-* import type { GitHubCommitInfo } from "\@savvy-web/changesets";
-* import { GitHubService, makeGitHubTest } from "\@savvy-web/changesets";
-*
-* const testResponses = new Map<string, GitHubCommitInfo>([
-*   ["abc1234", { user: "octocat", pull: 42, links: { pull: "#42", user: "\@octocat" } }],
-* ]);
-*
-* const TestLayer = makeGitHubTest(testResponses);
-*
-* const program = Effect.gen(function* () {
-*   const github = yield* GitHubService;
-*   return yield* github.getInfo({ commit: "abc1234", repo: "owner/repo" });
-* });
-*
-* Effect.runPromise(program.pipe(Effect.provide(TestLayer)));
-* ```
-*
-* @see {@link GitHubServiceShape} for the service interface
-* @see {@link GitHubLive} for the production layer
-* @see {@link makeGitHubTest} for creating test layers
-* @see {@link GitHubServiceBase} for the api-extractor base class
-*
-* @public
-*/
-var GitHubService = class extends GitHubServiceBase {};
-/**
-* Production layer for {@link GitHubService}.
-*
-* Delegates to `\@changesets/get-github-info` to fetch commit metadata
-* from the GitHub REST API. Requires a `GITHUB_TOKEN` environment variable
-* to be set for authenticated requests.
-*
-* @remarks
-* This layer is used by the `\@savvy-web/changesets/changelog` entry point
-* to resolve commit hashes into PR numbers and author attribution. It is
-* composed with {@link MarkdownLive} in the changelog formatter's
-* `MainLayer`.
-*
-* @example
-* ```typescript
-* import { Effect } from "effect";
-* import { GitHubService, GitHubLive } from "\@savvy-web/changesets";
-*
-* const program = Effect.gen(function* () {
-*   const github = yield* GitHubService;
-*   return yield* github.getInfo({ commit: "abc1234", repo: "owner/repo" });
-* });
-*
-* Effect.runPromise(program.pipe(Effect.provide(GitHubLive)));
-* ```
-*
-* @public
-*/
-const GitHubLive = Layer.succeed(GitHubService, { getInfo: getGitHubInfo });
-/**
-* Create a test layer for {@link GitHubService} with pre-configured responses.
-*
-* Returns a `Layer` that resolves commit hashes from the provided `Map`.
-* Lookups for commits not present in the map fail with a
-* {@link GitHubApiError}.
-*
-* @remarks
-* This helper is the recommended way to test code that depends on
-* `GitHubService` without making real API calls. Provide the layer
-* via `Effect.provide` in your test setup.
-*
-* @param responses - A `Map` of full commit hash to {@link GitHubCommitInfo} objects
-* @returns A `Layer` providing the {@link GitHubService} with deterministic responses
-*
-* @example
-* ```typescript
-* import { Effect } from "effect";
-* import type { GitHubCommitInfo } from "\@savvy-web/changesets";
-* import { GitHubService, makeGitHubTest } from "\@savvy-web/changesets";
-*
-* const responses = new Map<string, GitHubCommitInfo>([
-*   ["abc1234", { user: "octocat", pull: 42, links: { pull: "#42", user: "\@octocat" } }],
-* ]);
-*
-* const TestGitHub = makeGitHubTest(responses);
-*
-* const program = Effect.gen(function* () {
-*   const github = yield* GitHubService;
-*   return yield* github.getInfo({ commit: "abc1234", repo: "owner/repo" });
-* });
-*
-* // In a Vitest test:
-* const result = await Effect.runPromise(program.pipe(Effect.provide(TestGitHub)));
-* // result.user === "octocat"
-* ```
-*
-* @public
-*/
-function makeGitHubTest(responses) {
-	return Layer.succeed(GitHubService, { getInfo: (params) => {
-		const info = responses.get(params.commit);
-		if (info) return Effect.succeed(info);
-		return Effect.fail(new GitHubApiError({
-			operation: "getInfo",
-			reason: `No mock response for commit ${params.commit}`
-		}));
-	} });
-}
-
-//#endregion
-export { GitHubLive, GitHubService, GitHubServiceBase, makeGitHubTest };