@savvy-web/mcp 1.3.3 → 1.3.4

package/public/content/packages/github-action-effects/api/variable/githubissuetest.md

@@ -0,0 +1,24 @@
+---
+id: packages/github-action-effects/api/variable/githubissuetest
+title: "GitHubIssueTest — github-action-effects variable"
+summary: "Test implementation for GitHubIssue."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# GitHubIssueTest
+
+Test implementation for [GitHubIssue](silk://packages/github-action-effects/api/class/githubissue).
+
+```ts
+GitHubIssueTest: {
+  readonly layer: (state: GitHubIssueTestState) => Layer.Layer<GitHubIssue>;
+  readonly empty: () => {
+    state: GitHubIssueTestState;
+    layer: Layer.Layer<GitHubIssue>;
+  };
+}
+```

package/public/content/packages/github-action-effects/api/variable/githubmarkdown.md

@@ -0,0 +1,45 @@
+---
+id: packages/github-action-effects/api/variable/githubmarkdown
+title: "GithubMarkdown — github-action-effects variable"
+summary: "Namespace for GitHub-Flavored Markdown builder functions."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# GithubMarkdown
+
+Namespace for GitHub-Flavored Markdown builder functions.
+
+```ts
+GithubMarkdown: {
+  readonly table: (headers: ReadonlyArray<string>, rows: ReadonlyArray<ReadonlyArray<string>>) => string;
+  readonly heading: (text: string, level?: 1 | 2 | 3 | 4 | 5 | 6) => string;
+  readonly details: (summary: string, content: string) => string;
+  readonly rule: () => string;
+  readonly statusIcon: (status: Status) => string;
+  readonly link: (text: string, url: string) => string;
+  readonly list: (items: ReadonlyArray<string>) => string;
+  readonly checklist: (items: ReadonlyArray<ChecklistItem>) => string;
+  readonly bold: (text: string) => string;
+  readonly code: (text: string) => string;
+  readonly codeBlock: (content: string, language?: string) => string;
+  readonly image: (src: string, alt: string, options?: {
+    readonly width?: string;
+    readonly height?: string;
+  }) => string;
+  readonly quote: (text: string, cite?: string) => string;
+}
+```
+
+## Examples
+
+```ts
+import { GithubMarkdown } from "@savvy-web/github-action-effects"
+
+GithubMarkdown.table(["Name", "Status"], [["build", "pass"]])
+GithubMarkdown.bold("hello")
+
+```

package/public/content/packages/github-action-effects/api/variable/githubreleaselive.md

@@ -0,0 +1,16 @@
+---
+id: packages/github-action-effects/api/variable/githubreleaselive
+title: "GitHubReleaseLive — github-action-effects variable"
+summary: "variable GitHubReleaseLive from @savvy-web/github-action-effects."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# GitHubReleaseLive
+
+```ts
+GitHubReleaseLive: Layer.Layer<GitHubRelease, never, GitHubClient>
+```

package/public/content/packages/github-action-effects/api/variable/githubreleasetest.md

@@ -0,0 +1,24 @@
+---
+id: packages/github-action-effects/api/variable/githubreleasetest
+title: "GitHubReleaseTest — github-action-effects variable"
+summary: "Test implementation for GitHubRelease."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# GitHubReleaseTest
+
+Test implementation for [GitHubRelease](silk://packages/github-action-effects/api/class/githubrelease).
+
+```ts
+GitHubReleaseTest: {
+  readonly layer: (state: GitHubReleaseTestState) => Layer.Layer<GitHubRelease>; /** Create test layer with empty state. Returns both state and layer for assertions. */
+  readonly empty: () => {
+    state: GitHubReleaseTestState;
+    layer: Layer.Layer<GitHubRelease>;
+  };
+}
+```

package/public/content/packages/github-action-effects/api/variable/githubtoken.md

@@ -0,0 +1,27 @@
+---
+id: packages/github-action-effects/api/variable/githubtoken
+title: "GitHubToken — github-action-effects variable"
+summary: "Phase-oriented helpers for the GitHub App installation-token lifecycle: `provision` in `pre`, `client` in `main`, `dispose` in `post`. `read` and `botIdentity`…"
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# GitHubToken
+
+Phase-oriented helpers for the GitHub App installation-token lifecycle: `provision` in `pre`, `client` in `main`, `dispose` in `post`. `read` and `botIdentity` surface the persisted token (and a verified commit identity) to any phase after `provision`. `provision` and `dispose` require a `GitHubApp` layer in context — provide `GitHubAppLive` (composed with `OctokitAuthAppLive`) in production, or `GitHubAppTest` in tests. `client`, `read`, and `botIdentity` require `ActionState`.
+
+```ts
+GitHubToken: {
+  readonly provision: (options?: ProvisionOptions) => Effect.Effect<InstallationToken, GitHubAppError |
+  TokenPermissionError | ActionStateError | ConfigError.ConfigError, ActionState |
+  GitHubApp | ActionOutputs>;
+  readonly client: () => Layer.Layer<GitHubClient, ActionStateError, ActionState>;
+  readonly read: () => Effect.Effect<InstallationToken, ActionStateError, ActionState>;
+  readonly botIdentity: () => Effect.Effect<BotIdentity, ActionStateError, ActionState>;
+  readonly dispose: () => Effect.Effect<void, GitHubAppError |
+  ActionStateError, ActionState | GitHubApp>;
+}
+```

package/public/content/packages/github-action-effects/api/variable/gittaglive.md

@@ -0,0 +1,16 @@
+---
+id: packages/github-action-effects/api/variable/gittaglive
+title: "GitTagLive — github-action-effects variable"
+summary: "variable GitTagLive from @savvy-web/github-action-effects."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# GitTagLive
+
+```ts
+GitTagLive: Layer.Layer<GitTag, never, GitHubClient>
+```

package/public/content/packages/github-action-effects/api/variable/gittagtest.md

@@ -0,0 +1,24 @@
+---
+id: packages/github-action-effects/api/variable/gittagtest
+title: "GitTagTest — github-action-effects variable"
+summary: "Test implementation for GitTag."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# GitTagTest
+
+Test implementation for [GitTag](silk://packages/github-action-effects/api/class/gittag).
+
+```ts
+GitTagTest: {
+  readonly layer: (state: GitTagTestState) => Layer.Layer<GitTag>; /** Create a fresh test state and layer. */
+  readonly empty: () => {
+    state: GitTagTestState;
+    layer: Layer.Layer<GitTag>;
+  };
+}
+```

package/public/content/packages/github-action-effects/api/variable/globlive.md

@@ -0,0 +1,18 @@
+---
+id: packages/github-action-effects/api/variable/globlive
+title: "GlobLive — github-action-effects variable"
+summary: "Live implementation of Glob using `node:fs.globSync`, `node:crypto` and `node:fs.createReadStream`. No dependency on `@actions/glob`."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# GlobLive
+
+Live implementation of [Glob](silk://packages/github-action-effects/api/class/glob) using `node:fs.globSync`, `node:crypto` and `node:fs.createReadStream`. No dependency on `@actions/glob`.
+
+```ts
+GlobLive: Layer.Layer<Glob>
+```

package/public/content/packages/github-action-effects/api/variable/globtest.md

@@ -0,0 +1,30 @@
+---
+id: packages/github-action-effects/api/variable/globtest
+title: "GlobTest — github-action-effects variable"
+summary: "Test implementation for Glob."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# GlobTest
+
+Test implementation for [Glob](silk://packages/github-action-effects/api/class/glob).
+
+```ts
+GlobTest: {
+  readonly empty: () => GlobTestState;
+  readonly layer: (state: GlobTestState) => Layer.Layer<Glob>;
+}
+```
+
+## Examples
+
+```ts
+const state = GlobTest.empty();
+state.matches.set("*.ts", ["/repo/a.ts", "/repo/b.ts"]);
+const layer = GlobTest.layer(state);
+
+```

package/public/content/packages/github-action-effects/api/variable/in_toto_payload_type.md

@@ -0,0 +1,18 @@
+---
+id: packages/github-action-effects/api/variable/in_toto_payload_type
+title: "IN_TOTO_PAYLOAD_TYPE — github-action-effects variable"
+summary: "DSSE payload type for in-toto statements per the GitHub attestations spec."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# IN_TOTO_PAYLOAD_TYPE
+
+DSSE payload type for in-toto statements per the GitHub attestations spec.
+
+```ts
+IN_TOTO_PAYLOAD_TYPE: "application/vnd.in-toto+json"
+```

package/public/content/packages/github-action-effects/api/variable/in_toto_statement_v1.md

@@ -0,0 +1,18 @@
+---
+id: packages/github-action-effects/api/variable/in_toto_statement_v1
+title: "IN_TOTO_STATEMENT_V1 — github-action-effects variable"
+summary: "Type URI for in-toto Statement v1. Stored verbatim as the `_type` field of every statement we emit."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# IN_TOTO_STATEMENT_V1
+
+Type URI for in-toto Statement v1. Stored verbatim as the `_type` field of every statement we emit.
+
+```ts
+IN_TOTO_STATEMENT_V1: "https://in-toto.io/Statement/v1"
+```

package/public/content/packages/github-action-effects/api/variable/installationtoken.md

@@ -0,0 +1,28 @@
+---
+id: packages/github-action-effects/api/variable/installationtoken
+title: "InstallationToken — github-action-effects variable"
+summary: "An installation token generated from a GitHub App."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# InstallationToken
+
+An installation token generated from a GitHub App.
+
+```ts
+InstallationToken: Schema.Struct<{
+  token: Schema.Redacted<typeof Schema.String>;
+  expiresAt: typeof Schema.String;
+  installationId: typeof Schema.Number;
+  appSlug: Schema.optional<typeof Schema.String>;
+  appUserId: Schema.optional<typeof Schema.Number>;
+  appName: Schema.optional<typeof Schema.String>;
+  permissions: Schema.optionalWith<Schema.Record$<typeof Schema.String, typeof Schema.String>, {
+    default: () => {};
+  }>;
+}>
+```

package/public/content/packages/github-action-effects/api/variable/ioutil.md

@@ -0,0 +1,22 @@
+---
+id: packages/github-action-effects/api/variable/ioutil
+title: "IoUtil — github-action-effects variable"
+summary: "Filesystem I/O lookup helpers — `@actions/io` `which` / `findInPath` parity."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# IoUtil
+
+Filesystem I/O lookup helpers — `@actions/io` `which` / `findInPath` parity.
+
+```ts
+IoUtil: {
+  readonly which: (tool: string) => Effect.Effect<Option.Option<string>, never, FileSystem.FileSystem>;
+  readonly whichOrFail: (tool: string) => Effect.Effect<string, IoError, FileSystem.FileSystem>;
+  readonly findInPath: (tool: string) => Effect.Effect<ReadonlyArray<string>, never, FileSystem.FileSystem>;
+}
+```

package/public/content/packages/github-action-effects/api/variable/loglevelinput.md

@@ -0,0 +1,18 @@
+---
+id: packages/github-action-effects/api/variable/loglevelinput
+title: "LogLevelInput — github-action-effects variable"
+summary: "Log level input values accepted by the standardized `log-level` action input. Includes `auto` which resolves based on the GitHub Actions environment."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# LogLevelInput
+
+Log level input values accepted by the standardized `log-level` action input. Includes `auto` which resolves based on the GitHub Actions environment.
+
+```ts
+LogLevelInput: Schema.Literal<["info", "verbose", "debug", "auto"]>
+```

package/public/content/packages/github-action-effects/api/variable/npmpackageinfo.md

@@ -0,0 +1,24 @@
+---
+id: packages/github-action-effects/api/variable/npmpackageinfo
+title: "NpmPackageInfo — github-action-effects variable"
+summary: "Schema for npm package metadata."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# NpmPackageInfo
+
+Schema for npm package metadata.
+
+```ts
+NpmPackageInfo: Schema.Struct<{
+  name: typeof Schema.String;
+  version: typeof Schema.String;
+  distTags: Schema.Record$<typeof Schema.String, typeof Schema.String>;
+  integrity: Schema.UndefinedOr<typeof Schema.String>;
+  tarball: Schema.UndefinedOr<typeof Schema.String>;
+}>
+```

package/public/content/packages/github-action-effects/api/variable/npmregistrylive.md

@@ -0,0 +1,18 @@
+---
+id: packages/github-action-effects/api/variable/npmregistrylive
+title: "NpmRegistryLive — github-action-effects variable"
+summary: "Live NpmRegistry layer using CommandRunner."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# NpmRegistryLive
+
+Live [NpmRegistry](silk://packages/github-action-effects/api/class/npmregistry) layer using [CommandRunner](silk://packages/github-action-effects/api/class/commandrunner).
+
+```ts
+NpmRegistryLive: Layer.Layer<NpmRegistry, never, CommandRunner>
+```

package/public/content/packages/github-action-effects/api/variable/npmregistrytest.md

@@ -0,0 +1,21 @@
+---
+id: packages/github-action-effects/api/variable/npmregistrytest
+title: "NpmRegistryTest — github-action-effects variable"
+summary: "Test implementation for NpmRegistry."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# NpmRegistryTest
+
+Test implementation for [NpmRegistry](silk://packages/github-action-effects/api/class/npmregistry).
+
+```ts
+NpmRegistryTest: {
+  readonly layer: (state: NpmRegistryTestState) => Layer.Layer<NpmRegistry>;
+  readonly empty: () => Layer.Layer<NpmRegistry>;
+}
+```

package/public/content/packages/github-action-effects/api/variable/octokitauthapplive.md

@@ -0,0 +1,18 @@
+---
+id: packages/github-action-effects/api/variable/octokitauthapplive
+title: "OctokitAuthAppLive — github-action-effects variable"
+summary: "Live implementation of OctokitAuthApp using `@octokit/auth-app`."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# OctokitAuthAppLive
+
+Live implementation of [OctokitAuthApp](silk://packages/github-action-effects/api/class/octokitauthapp) using `@octokit/auth-app`.
+
+```ts
+OctokitAuthAppLive: Layer.Layer<OctokitAuthApp>
+```

package/public/content/packages/github-action-effects/api/variable/oidctokenissuerlive.md

@@ -0,0 +1,18 @@
+---
+id: packages/github-action-effects/api/variable/oidctokenissuerlive
+title: "OidcTokenIssuerLive — github-action-effects variable"
+summary: "Live OidcTokenIssuer layer. Requires `HttpClient.HttpClient`."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# OidcTokenIssuerLive
+
+Live [OidcTokenIssuer](silk://packages/github-action-effects/api/class/oidctokenissuer) layer. Requires `HttpClient.HttpClient`.
+
+```ts
+OidcTokenIssuerLive: Layer.Layer<OidcTokenIssuer, never, HttpClient.HttpClient>
+```

package/public/content/packages/github-action-effects/api/variable/oidctokenissuertest.md

@@ -0,0 +1,18 @@
+---
+id: packages/github-action-effects/api/variable/oidctokenissuertest
+title: "OidcTokenIssuerTest — github-action-effects variable"
+summary: "Noop OidcTokenIssuer test layer — returns a fixed dummy JWT."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# OidcTokenIssuerTest
+
+Noop [OidcTokenIssuer](silk://packages/github-action-effects/api/class/oidctokenissuer) test layer — returns a fixed dummy JWT.
+
+```ts
+OidcTokenIssuerTest: Layer.Layer<OidcTokenIssuer>
+```

package/public/content/packages/github-action-effects/api/variable/packagemanageradapterlive.md

@@ -0,0 +1,19 @@
+---
+id: packages/github-action-effects/api/variable/packagemanageradapterlive
+title: "PackageManagerAdapterLive — github-action-effects variable"
+summary: "Live implementation of PackageManagerAdapter. Depends on CommandRunner for executing commands and FileSystem for reading package.json and checking lockfiles."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# PackageManagerAdapterLive
+
+Live implementation of [PackageManagerAdapter](silk://packages/github-action-effects/api/class/packagemanageradapter). Depends on [CommandRunner](silk://packages/github-action-effects/api/class/commandrunner) for executing commands and FileSystem for reading package.json and checking lockfiles.
+
+```ts
+PackageManagerAdapterLive: Layer.Layer<PackageManagerAdapter, never, CommandRunner |
+  FileSystem.FileSystem>
+```

package/public/content/packages/github-action-effects/api/variable/packagemanageradaptertest.md

@@ -0,0 +1,21 @@
+---
+id: packages/github-action-effects/api/variable/packagemanageradaptertest
+title: "PackageManagerAdapterTest — github-action-effects variable"
+summary: "Test implementation for PackageManagerAdapter."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# PackageManagerAdapterTest
+
+Test implementation for [PackageManagerAdapter](silk://packages/github-action-effects/api/class/packagemanageradapter).
+
+```ts
+PackageManagerAdapterTest: {
+  readonly layer: (state: PackageManagerAdapterTestState) => Layer.Layer<PackageManagerAdapter>; /** Create a fresh test state with pnpm defaults. */
+  readonly empty: () => PackageManagerAdapterTestState;
+}
+```

package/public/content/packages/github-action-effects/api/variable/packagemanagerinfo.md

@@ -0,0 +1,22 @@
+---
+id: packages/github-action-effects/api/variable/packagemanagerinfo
+title: "PackageManagerInfo — github-action-effects variable"
+summary: "Information about a detected package manager."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# PackageManagerInfo
+
+Information about a detected package manager.
+
+```ts
+PackageManagerInfo: Schema.Struct<{
+  name: Schema.Literal<["npm", "pnpm", "yarn", "bun", "deno"]>;
+  version: typeof Schema.String;
+  lockfile: Schema.UndefinedOr<typeof Schema.String>;
+}>
+```

package/public/content/packages/github-action-effects/api/variable/packagemanagername.md

@@ -0,0 +1,18 @@
+---
+id: packages/github-action-effects/api/variable/packagemanagername
+title: "PackageManagerName — github-action-effects variable"
+summary: "Supported package manager names."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# PackageManagerName
+
+Supported package manager names.
+
+```ts
+PackageManagerName: Schema.Literal<["npm", "pnpm", "yarn", "bun", "deno"]>
+```

package/public/content/packages/github-action-effects/api/variable/packagepublishlive.md

@@ -0,0 +1,19 @@
+---
+id: packages/github-action-effects/api/variable/packagepublishlive
+title: "PackagePublishLive — github-action-effects variable"
+summary: "Live PackagePublish layer using CommandRunner and NpmRegistry."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# PackagePublishLive
+
+Live [PackagePublish](silk://packages/github-action-effects/api/class/packagepublish) layer using [CommandRunner](silk://packages/github-action-effects/api/class/commandrunner) and [NpmRegistry](silk://packages/github-action-effects/api/class/npmregistry).
+
+```ts
+PackagePublishLive: Layer.Layer<PackagePublish, never, CommandRunner | NpmRegistry |
+  ActionOutputs>
+```

package/public/content/packages/github-action-effects/api/variable/packagepublishtest.md

@@ -0,0 +1,27 @@
+---
+id: packages/github-action-effects/api/variable/packagepublishtest
+title: "PackagePublishTest — github-action-effects variable"
+summary: "Test implementation for PackagePublish."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# PackagePublishTest
+
+Test implementation for [PackagePublish](silk://packages/github-action-effects/api/class/packagepublish).
+
+```ts
+PackagePublishTest: {
+  readonly empty: () => {
+    state: PackagePublishTestState;
+    layer: Layer.Layer<PackagePublish>;
+  }; /** Create a test layer with custom state overrides. */
+  readonly layer: (overrides?: Partial<Pick<PackagePublishTestState, "packResult" | "integrityMatch" | "publishedVersions" | "dryRunOk" | "publishTarballProvenanceUrl">>) => {
+    state: PackagePublishTestState;
+    layer: Layer.Layer<PackagePublish>;
+  };
+}
+```

package/public/content/packages/github-action-effects/api/variable/pathutils.md

@@ -0,0 +1,31 @@
+---
+id: packages/github-action-effects/api/variable/pathutils
+title: "PathUtils — github-action-effects variable"
+summary: "Pure path-normalization helpers, matching `@actions/core` path utilities."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# PathUtils
+
+Pure path-normalization helpers, matching `@actions/core` path utilities.
+
+```ts
+PathUtils: {
+  readonly toPosixPath: (pth: string) => string; /** Normalize forward slashes to backslashes. Matches `@actions/core.toWin32Path`. */
+  readonly toWin32Path: (pth: string) => string; /** Normalize both separators to the platform separator. Matches `@actions/core.toPlatformPath`. */
+  readonly toPlatformPath: (pth: string) => string;
+}
+```
+
+## Examples
+
+```ts
+import { PathUtils } from "@savvy-web/github-action-effects"
+
+PathUtils.toPosixPath("a\\b") // "a/b"
+
+```