@savvy-web/mcp 1.3.3 → 1.3.5

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

@@ -0,0 +1,31 @@
+---
+id: packages/github-action-effects/api/variable/permissioncheckresult
+title: "PermissionCheckResult — github-action-effects variable"
+summary: "Result of a permission check comparing granted vs required."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# PermissionCheckResult
+
+Result of a permission check comparing granted vs required.
+
+```ts
+PermissionCheckResult: Schema.Struct<{
+  granted: Schema.Record$<typeof Schema.String, Schema.Literal<["read", "write", "admin"]>>;
+  required: Schema.Record$<typeof Schema.String, Schema.Literal<["read", "write", "admin"]>>;
+  missing: Schema.Array$<Schema.Struct<{
+    permission: typeof Schema.String;
+    required: Schema.Literal<["read", "write", "admin"]>;
+    granted: Schema.UndefinedOr<Schema.Literal<["read", "write", "admin"]>>;
+  }>>;
+  extra: Schema.Array$<Schema.Struct<{
+    permission: typeof Schema.String;
+    level: Schema.Literal<["read", "write", "admin"]>;
+  }>>;
+  satisfied: typeof Schema.Boolean;
+}>
+```

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

@@ -0,0 +1,22 @@
+---
+id: packages/github-action-effects/api/variable/permissiongap
+title: "PermissionGap — github-action-effects variable"
+summary: "A missing or insufficient permission."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# PermissionGap
+
+A missing or insufficient permission.
+
+```ts
+PermissionGap: Schema.Struct<{
+  permission: typeof Schema.String;
+  required: Schema.Literal<["read", "write", "admin"]>;
+  granted: Schema.UndefinedOr<Schema.Literal<["read", "write", "admin"]>>;
+}>
+```

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

@@ -0,0 +1,18 @@
+---
+id: packages/github-action-effects/api/variable/permissionlevel
+title: "PermissionLevel — github-action-effects variable"
+summary: "Permission level for a GitHub token scope."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# PermissionLevel
+
+Permission level for a GitHub token scope.
+
+```ts
+PermissionLevel: Schema.Literal<["read", "write", "admin"]>
+```

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,18 @@
+---
+id: packages/github-action-effects/api/variable/ratelimiterlive
+title: "RateLimiterLive — github-action-effects variable"
+summary: "Rate limiter that reads the `x-ratelimit-*` headers observed on real responses (cached in a shared `RateLimitState` `Ref` written by the GitHubClient), rather…"
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# RateLimiterLive
+
+Rate limiter that reads the `x-ratelimit-*` headers observed on real responses (cached in a shared `RateLimitState` `Ref` written by the [GitHubClient](silk://packages/github-action-effects/api/class/githubclient)), rather than issuing a pre-flight `GET /rate_limit` before every guarded call. Probes only on a cache miss.
+
+```ts
+RateLimiterLive: Layer.Layer<RateLimiter, never, GitHubClient>
+```

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

@@ -0,0 +1,21 @@
+---
+id: packages/github-action-effects/api/variable/ratelimitertest
+title: "RateLimiterTest — github-action-effects variable"
+summary: "Test implementation for RateLimiter."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# RateLimiterTest
+
+Test implementation for [RateLimiter](silk://packages/github-action-effects/api/class/ratelimiter).
+
+```ts
+RateLimiterTest: {
+  readonly layer: (state: RateLimiterTestState) => Layer.Layer<RateLimiter>; /** Create a fresh test state with default (healthy) rate limits. */
+  readonly empty: () => RateLimiterTestState;
+}
+```

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

@@ -0,0 +1,23 @@
+---
+id: packages/github-action-effects/api/variable/ratelimitstatus
+title: "RateLimitStatus — github-action-effects variable"
+summary: "Schema for GitHub API rate limit status."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# RateLimitStatus
+
+Schema for GitHub API rate limit status.
+
+```ts
+RateLimitStatus: Schema.Struct<{
+  limit: typeof Schema.Number;
+  remaining: typeof Schema.Number;
+  reset: typeof Schema.Number;
+  used: typeof Schema.Number;
+}>
+```

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

@@ -0,0 +1,33 @@
+---
+id: packages/github-action-effects/api/variable/reportbuilder
+title: "ReportBuilder — github-action-effects variable"
+summary: "Namespace for composing markdown reports with a fluent builder API."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# ReportBuilder
+
+Namespace for composing markdown reports with a fluent builder API.
+
+```ts
+ReportBuilder: {
+  readonly create: (title: string) => Report;
+}
+```
+
+## Examples
+
+```ts
+import { ReportBuilder } from "@savvy-web/github-action-effects"
+
+const report = ReportBuilder.create("Build Report")
+  .stat("Duration", "1.5s")
+  .stat("Packages", 12)
+  .section("Details", "Everything passed.")
+  .toMarkdown()
+
+```

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

@@ -0,0 +1,25 @@
+---
+id: packages/github-action-effects/api/variable/runnercontext
+title: "RunnerContext — github-action-effects variable"
+summary: "Runner context derived from RUNNER_* environment variables."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# RunnerContext
+
+Runner context derived from RUNNER_* environment variables.
+
+```ts
+RunnerContext: Schema.Struct<{
+  os: typeof Schema.String;
+  arch: typeof Schema.String;
+  name: typeof Schema.String;
+  temp: typeof Schema.String;
+  toolCache: typeof Schema.String;
+  debug: typeof Schema.Boolean;
+}>
+```

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

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

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

@@ -0,0 +1,21 @@
+---
+id: packages/github-action-effects/api/variable/sbomtest
+title: "SbomTest — github-action-effects variable"
+summary: "Test layer factories for Sbom."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# SbomTest
+
+Test layer factories for [Sbom](silk://packages/github-action-effects/api/class/sbom).
+
+```ts
+SbomTest: {
+  layer: (state: SbomTestState) => Layer.Layer<Sbom>;
+  empty: () => Layer.Layer<Sbom>;
+}
+```

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

@@ -0,0 +1,30 @@
+---
+id: packages/github-action-effects/api/variable/semverresolver
+title: "SemverResolver — github-action-effects variable"
+summary: "Namespace for semver resolution operations. Wraps `semver-effect` with unified SemverResolverError error handling."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# SemverResolver
+
+Namespace for semver resolution operations. Wraps `semver-effect` with unified [SemverResolverError](silk://packages/github-action-effects/api/class/semverresolvererror) error handling.
+
+```ts
+SemverResolver: {
+  readonly compare: (a: string, b: string) => Effect.Effect<-1 | 0 | 1, SemverResolverError>;
+  readonly satisfies: (version: string, range: string) => Effect.Effect<boolean, SemverResolverError>;
+  readonly latestInRange: (versions: Array<string>, range: string) => Effect.Effect<string, SemverResolverError>;
+  readonly increment: (version: string, bump: "major" | "minor" | "patch" | "prerelease") => Effect.Effect<string, SemverResolverError>;
+  readonly parse: (version: string) => Effect.Effect<{
+    major: number;
+    minor: number;
+    patch: number;
+    prerelease?: string;
+    build?: string;
+  }, SemverResolverError>;
+}
+```

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

@@ -0,0 +1,18 @@
+---
+id: packages/github-action-effects/api/variable/sigstore_bundle_v0_3_media_type
+title: "SIGSTORE_BUNDLE_V0_3_MEDIA_TYPE — github-action-effects variable"
+summary: "Sigstore Bundle media type, v0.3. GitHub's `POST /repos/.../attestations` endpoint expects bundles in this shape."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# SIGSTORE_BUNDLE_V0_3_MEDIA_TYPE
+
+Sigstore Bundle media type, v0.3. GitHub's `POST /repos/.../attestations` endpoint expects bundles in this shape.
+
+```ts
+SIGSTORE_BUNDLE_V0_3_MEDIA_TYPE: "application/vnd.dev.sigstore.bundle.v0.3+json"
+```

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

@@ -0,0 +1,18 @@
+---
+id: packages/github-action-effects/api/variable/sigstore_oidc_audience
+title: "SIGSTORE_OIDC_AUDIENCE — github-action-effects variable"
+summary: "OIDC audience expected by the Sigstore public-good Fulcio instance."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# SIGSTORE_OIDC_AUDIENCE
+
+OIDC audience expected by the Sigstore public-good Fulcio instance.
+
+```ts
+SIGSTORE_OIDC_AUDIENCE: "sigstore"
+```

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

@@ -0,0 +1,18 @@
+---
+id: packages/github-action-effects/api/variable/sigstoresignerlive
+title: "SigstoreSignerLive — github-action-effects variable"
+summary: "Live SigstoreSigner layer using the public-good Sigstore instance (Fulcio + Rekor). Requires OidcTokenIssuer to be provided downstream."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# SigstoreSignerLive
+
+Live [SigstoreSigner](silk://packages/github-action-effects/api/class/sigstoresigner) layer using the public-good Sigstore instance (Fulcio + Rekor). Requires [OidcTokenIssuer](silk://packages/github-action-effects/api/class/oidctokenissuer) to be provided downstream.
+
+```ts
+SigstoreSignerLive: Layer.Layer<SigstoreSigner, never, never>
+```

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

@@ -0,0 +1,18 @@
+---
+id: packages/github-action-effects/api/variable/sigstoresignertest
+title: "SigstoreSignerTest — github-action-effects variable"
+summary: "Noop SigstoreSigner test layer — returns a synthetic SigstoreBundle without any signing or witnessing."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# SigstoreSignerTest
+
+Noop [SigstoreSigner](silk://packages/github-action-effects/api/class/sigstoresigner) test layer — returns a synthetic [SigstoreBundle](silk://packages/github-action-effects/api/class/sigstorebundle) without any signing or witnessing.
+
+```ts
+SigstoreSignerTest: Layer.Layer<SigstoreSigner>
+```

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

@@ -0,0 +1,18 @@
+---
+id: packages/github-action-effects/api/variable/slsa_provenance_v1
+title: "SLSA_PROVENANCE_V1 — github-action-effects variable"
+summary: "SLSA Provenance v1.0 predicate URI."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# SLSA_PROVENANCE_V1
+
+SLSA Provenance v1.0 predicate URI.
+
+```ts
+SLSA_PROVENANCE_V1: "https://slsa.dev/provenance/v1"
+```

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

@@ -0,0 +1,18 @@
+---
+id: packages/github-action-effects/api/variable/spdx_v2_3
+title: "SPDX_V2_3 — github-action-effects variable"
+summary: "SPDX SBOM predicate URI."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# SPDX_V2_3
+
+SPDX SBOM predicate URI.
+
+```ts
+SPDX_V2_3: "https://spdx.dev/Document/v2.3"
+```

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

@@ -0,0 +1,18 @@
+---
+id: packages/github-action-effects/api/variable/status
+title: "Status — github-action-effects variable"
+summary: "Status values for `statusIcon`."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# Status
+
+[Status](silk://packages/github-action-effects/api/variable/status) values for `statusIcon`.
+
+```ts
+Status: Schema.Literal<["pass", "fail", "skip", "warn"]>
+```

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

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

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

@@ -0,0 +1,18 @@
+---
+id: packages/github-action-effects/api/variable/toolinstallerlive
+title: "ToolInstallerLive — github-action-effects variable"
+summary: "Live implementation of ToolInstaller using `node:https`/`node:http`, `node:child_process`, and `node:fs/promises`. No `@actions/tool-cache` dependency."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# ToolInstallerLive
+
+Live implementation of [ToolInstaller](silk://packages/github-action-effects/api/class/toolinstaller) using `node:https`/`node:http`, `node:child_process`, and `node:fs/promises`. No `@actions/tool-cache` dependency.
+
+```ts
+ToolInstallerLive: Layer.Layer<ToolInstaller>
+```

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

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

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

@@ -0,0 +1,26 @@
+---
+id: packages/github-action-effects/api/variable/treeentry
+title: "TreeEntry — github-action-effects variable"
+summary: "A single entry in a Git tree object. Either a content entry (add/update) or a deletion entry (sha: null)."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# TreeEntry
+
+A single entry in a Git tree object. Either a content entry (add/update) or a deletion entry (sha: null).
+
+```ts
+TreeEntry: Schema.Union<[Schema.Struct<{
+  path: typeof Schema.String;
+  mode: Schema.Literal<["100644", "100755", "040000"]>;
+  content: typeof Schema.String;
+}>, Schema.Struct<{
+  path: typeof Schema.String;
+  mode: Schema.Literal<["100644", "100755", "040000"]>;
+  sha: typeof Schema.Null;
+}>]>
+```

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

@@ -0,0 +1,22 @@
+---
+id: packages/github-action-effects/api/variable/treeentrycontent
+title: "TreeEntryContent — github-action-effects variable"
+summary: "A tree entry that adds or updates a file."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# TreeEntryContent
+
+A tree entry that adds or updates a file.
+
+```ts
+TreeEntryContent: Schema.Struct<{
+  path: typeof Schema.String;
+  mode: Schema.Literal<["100644", "100755", "040000"]>;
+  content: typeof Schema.String;
+}>
+```

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

@@ -0,0 +1,22 @@
+---
+id: packages/github-action-effects/api/variable/treeentrydeletion
+title: "TreeEntryDeletion — github-action-effects variable"
+summary: "A tree entry that deletes a file (sha: null)."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# TreeEntryDeletion
+
+A tree entry that deletes a file (sha: null).
+
+```ts
+TreeEntryDeletion: Schema.Struct<{
+  path: typeof Schema.String;
+  mode: Schema.Literal<["100644", "100755", "040000"]>;
+  sha: typeof Schema.Null;
+}>
+```