@savvy-web/mcp 1.3.2 → 1.3.4

package/public/content/packages/github-action-effects/api/interface/pullrequestlistoptions.md

@@ -0,0 +1,60 @@
+---
+id: packages/github-action-effects/api/interface/pullrequestlistoptions
+title: "PullRequestListOptions — github-action-effects interface"
+summary: "Options for listing pull requests."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# PullRequestListOptions
+
+Options for listing pull requests.
+
+```ts
+interface PullRequestListOptions
+```
+
+## Members
+
+### base
+
+```ts
+readonly base?: string;
+```
+
+Filter by base branch.
+
+### head
+
+```ts
+readonly head?: string;
+```
+
+Filter by head branch (e.g. "owner:branch" or just "branch").
+
+### paginate
+
+```ts
+readonly paginate?: boolean;
+```
+
+When true, fetches all pages. Defaults to false.
+
+### perPage
+
+```ts
+readonly perPage?: number;
+```
+
+Results per page. Defaults to 30.
+
+### state
+
+```ts
+readonly state?: "open" | "closed" | "all";
+```
+
+Filter by state. Defaults to "open".

package/public/content/packages/github-action-effects/api/interface/pullrequestrecord.md

@@ -0,0 +1,74 @@
+---
+id: packages/github-action-effects/api/interface/pullrequestrecord
+title: "PullRequestRecord — github-action-effects interface"
+summary: "Recorded pull request for testing."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# PullRequestRecord
+
+Recorded pull request for testing.
+
+```ts
+interface PullRequestRecord extends PullRequestInfo
+```
+
+## Members
+
+### autoMerge
+
+```ts
+autoMerge: "merge" | "squash" | "rebase" | false | undefined;
+```
+
+### body
+
+```ts
+body: string | null;
+```
+
+### labels
+
+```ts
+readonly labels: Array<string>;
+```
+
+### merged
+
+```ts
+merged: boolean;
+```
+
+Mutable for test updates.
+
+### reviewers
+
+```ts
+readonly reviewers: Array<string>;
+```
+
+### state
+
+```ts
+state: "open" | "closed";
+```
+
+Mutable for test updates.
+
+### teamReviewers
+
+```ts
+readonly teamReviewers: Array<string>;
+```
+
+### title
+
+```ts
+title: string;
+```
+
+Mutable for test updates.

package/public/content/packages/github-action-effects/api/interface/pullrequestteststate.md

@@ -0,0 +1,54 @@
+---
+id: packages/github-action-effects/api/interface/pullrequestteststate
+title: "PullRequestTestState — github-action-effects interface"
+summary: "Test state for PullRequest."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# PullRequestTestState
+
+Test state for [PullRequest](silk://packages/github-action-effects/api/class/pullrequest).
+
+```ts
+interface PullRequestTestState
+```
+
+## Members
+
+### associatedByCommit
+
+```ts
+readonly associatedByCommit: Map<string, Array<PullRequestInfo>>;
+```
+
+PRs associated with a commit SHA, returned by listAssociatedWithCommit.
+
+### files
+
+```ts
+readonly files: Map<number, Array<PullRequestFile>>;
+```
+
+Files per PR number, returned by listFiles.
+
+### mergedPrs
+
+```ts
+readonly mergedPrs: Array<number>;
+```
+
+### nextNumber
+
+```ts
+nextNumber: number;
+```
+
+### prs
+
+```ts
+readonly prs: Array<PullRequestRecord>;
+```

package/public/content/packages/github-action-effects/api/interface/ratelimiterteststate.md

@@ -0,0 +1,44 @@
+---
+id: packages/github-action-effects/api/interface/ratelimiterteststate
+title: "RateLimiterTestState — github-action-effects interface"
+summary: "Test state for RateLimiter."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# RateLimiterTestState
+
+Test state for [RateLimiter](silk://packages/github-action-effects/api/class/ratelimiter).
+
+```ts
+interface RateLimiterTestState
+```
+
+## Members
+
+### checkGraphQLCalls
+
+```ts
+readonly checkGraphQLCalls: Array<void>;
+```
+
+### checkRestCalls
+
+```ts
+readonly checkRestCalls: Array<void>;
+```
+
+### graphqlStatus
+
+```ts
+graphqlStatus: RateLimitStatus;
+```
+
+### restStatus
+
+```ts
+restStatus: RateLimitStatus;
+```

package/public/content/packages/github-action-effects/api/interface/registrytarget.md

@@ -0,0 +1,52 @@
+---
+id: packages/github-action-effects/api/interface/registrytarget
+title: "RegistryTarget — github-action-effects interface"
+summary: "Target registry for publishing."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# RegistryTarget
+
+Target registry for publishing.
+
+```ts
+interface RegistryTarget
+```
+
+## Members
+
+### access
+
+```ts
+readonly access?: "public" | "restricted";
+```
+
+### packageManager
+
+```ts
+readonly packageManager?: "npm" | "pnpm" | "yarn" | "bun";
+```
+
+Package manager whose bundled `npm` executor runs the publish. Matches the `packageManager` option on `PackagePublish.publish` — non-`npm` dispatchers (`pnpm dlx npm`, `yarn npm`, `bun x npm`) fetch a fresh npm so the OIDC trusted-publisher exchange works on runners pinned to an older bundled npm. Defaults to bare `npm`.
+
+### registry
+
+```ts
+readonly registry: string;
+```
+
+### tag
+
+```ts
+readonly tag?: string;
+```
+
+### token
+
+```ts
+readonly token: Redacted.Redacted<string>;
+```

package/public/content/packages/github-action-effects/api/interface/releaseasset.md

@@ -0,0 +1,44 @@
+---
+id: packages/github-action-effects/api/interface/releaseasset
+title: "ReleaseAsset — github-action-effects interface"
+summary: "Data returned from an uploaded release asset."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# ReleaseAsset
+
+Data returned from an uploaded release asset.
+
+```ts
+interface ReleaseAsset
+```
+
+## Members
+
+### id
+
+```ts
+readonly id: number;
+```
+
+### name
+
+```ts
+readonly name: string;
+```
+
+### size
+
+```ts
+readonly size: number;
+```
+
+### url
+
+```ts
+readonly url: string;
+```

package/public/content/packages/github-action-effects/api/interface/releasedata.md

@@ -0,0 +1,62 @@
+---
+id: packages/github-action-effects/api/interface/releasedata
+title: "ReleaseData — github-action-effects interface"
+summary: "Data returned from a GitHub release."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# ReleaseData
+
+Data returned from a GitHub release.
+
+```ts
+interface ReleaseData
+```
+
+## Members
+
+### body
+
+```ts
+readonly body: string;
+```
+
+### draft
+
+```ts
+readonly draft: boolean;
+```
+
+### id
+
+```ts
+readonly id: number;
+```
+
+### name
+
+```ts
+readonly name: string;
+```
+
+### prerelease
+
+```ts
+readonly prerelease: boolean;
+```
+
+### tag
+
+```ts
+readonly tag: string;
+```
+
+### uploadUrl
+
+```ts
+readonly uploadUrl: string;
+```

package/public/content/packages/github-action-effects/api/interface/report_2.md

@@ -0,0 +1,76 @@
+---
+id: packages/github-action-effects/api/interface/report_2
+title: "Report_2 — github-action-effects interface"
+summary: "An immutable report that accumulates content and renders to markdown."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# Report_2
+
+An immutable report that accumulates content and renders to markdown.
+
+```ts
+interface Report
+```
+
+## Members
+
+### details
+
+```ts
+readonly details: (summary: string, content: string) => Report;
+```
+
+Add a collapsible details block.
+
+### section
+
+```ts
+readonly section: (title: string, content: string) => Report;
+```
+
+Add a titled section with markdown content.
+
+### stat
+
+```ts
+readonly stat: (label: string, value: string | number) => Report;
+```
+
+Add a key-value summary row.
+
+### toCheckRun
+
+```ts
+readonly toCheckRun: (checkRunId: number) => Effect.Effect<void, CheckRunError, CheckRun>;
+```
+
+Set as check run output via [CheckRun](silk://packages/github-action-effects/api/class/checkrun).
+
+### toComment
+
+```ts
+readonly toComment: (prNumber: number, markerKey: string) => Effect.Effect<void, PullRequestCommentError, PullRequestComment>;
+```
+
+Upsert as PR comment via [PullRequestComment](silk://packages/github-action-effects/api/class/pullrequestcomment).
+
+### toMarkdown
+
+```ts
+readonly toMarkdown: () => string;
+```
+
+Render to markdown string.
+
+### toSummary
+
+```ts
+readonly toSummary: () => Effect.Effect<void, ActionOutputError, ActionOutputs>;
+```
+
+Write to step summary via [ActionOutputs](silk://packages/github-action-effects/api/class/actionoutputs).

package/public/content/packages/github-action-effects/api/interface/resilienceoptions.md

@@ -0,0 +1,52 @@
+---
+id: packages/github-action-effects/api/interface/resilienceoptions
+title: "ResilienceOptions — github-action-effects interface"
+summary: "Tuning for the resilient retry/backoff applied to every GitHubClient call. Resilience is on by default; pass `{ enabled: false }` for bare, retry-free behavior…"
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# ResilienceOptions
+
+Tuning for the resilient retry/backoff applied to every [GitHubClient](silk://packages/github-action-effects/api/class/githubclient) call. Resilience is on by default; pass `{ enabled: false }` for bare, retry-free behavior. `maxRetries`, `baseDelay`, and `maxDelay` tune the exponential, jittered, capped backoff schedule used for retryable (429 / 5xx) errors.
+
+```ts
+interface ResilienceOptions
+```
+
+## Members
+
+### baseDelay
+
+```ts
+readonly baseDelay?: Duration.DurationInput;
+```
+
+Base delay for the exponential schedule. Default `Duration.seconds(1)`.
+
+### enabled
+
+```ts
+readonly enabled?: boolean;
+```
+
+Master switch. Default `true`. Set `false` for bare, retry-free behavior.
+
+### maxDelay
+
+```ts
+readonly maxDelay?: Duration.DurationInput;
+```
+
+Cap on any single backoff delay. Default `Duration.seconds(30)`.
+
+### maxRetries
+
+```ts
+readonly maxRetries?: number;
+```
+
+Max retry attempts for `retryable` errors. Default `4`.

package/public/content/packages/github-action-effects/api/interface/resolveddependency.md

@@ -0,0 +1,44 @@
+---
+id: packages/github-action-effects/api/interface/resolveddependency
+title: "ResolvedDependency — github-action-effects interface"
+summary: "A dependency that should appear as a component in the BOM."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# ResolvedDependency
+
+A dependency that should appear as a component in the BOM.
+
+```ts
+interface ResolvedDependency
+```
+
+## Members
+
+### description
+
+```ts
+readonly description?: string;
+```
+
+### license
+
+```ts
+readonly license?: string;
+```
+
+### name
+
+```ts
+readonly name: string;
+```
+
+### version
+
+```ts
+readonly version: string;
+```

package/public/content/packages/github-action-effects/api/interface/restresponse.md

@@ -0,0 +1,26 @@
+---
+id: packages/github-action-effects/api/interface/restresponse
+title: "RestResponse — github-action-effects interface"
+summary: "Recorded REST response for testing."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# RestResponse
+
+Recorded REST response for testing.
+
+```ts
+interface RestResponse
+```
+
+## Members
+
+### data
+
+```ts
+readonly data: unknown;
+```

package/public/content/packages/github-action-effects/api/interface/s3blobstoreconfig.md

@@ -0,0 +1,62 @@
+---
+id: packages/github-action-effects/api/interface/s3blobstoreconfig
+title: "S3BlobStoreConfig — github-action-effects interface"
+summary: "Configuration for an S3-backed BlobStore. Secret material is held as `Redacted` so it cannot be accidentally logged; it is unwrapped only inside the request si…"
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# S3BlobStoreConfig
+
+Configuration for an S3-backed [BlobStore](silk://packages/github-action-effects/api/class/blobstore). Secret material is held as `Redacted` so it cannot be accidentally logged; it is unwrapped only inside the request signer.
+
+```ts
+interface S3BlobStoreConfig
+```
+
+## Members
+
+### accessKeyId
+
+```ts
+readonly accessKeyId: string;
+```
+
+### bucket
+
+```ts
+readonly bucket: string;
+```
+
+### endpoint
+
+```ts
+readonly endpoint?: string;
+```
+
+### prefix
+
+```ts
+readonly prefix?: string;
+```
+
+### region
+
+```ts
+readonly region: string;
+```
+
+### secretAccessKey
+
+```ts
+readonly secretAccessKey: Redacted.Redacted<string>;
+```
+
+### sessionToken
+
+```ts
+readonly sessionToken?: Redacted.Redacted<string>;
+```

package/public/content/packages/github-action-effects/api/interface/sbomattestationinput.md

@@ -0,0 +1,44 @@
+---
+id: packages/github-action-effects/api/interface/sbomattestationinput
+title: "SbomAttestationInput — github-action-effects interface"
+summary: "Input for `Attest.sbom`."
+tier: packages
+source: generated
+tags: [github-action-effects, api]
+priority: 0.3
+related: []
+---
+
+# SbomAttestationInput
+
+Input for `Attest.sbom`.
+
+```ts
+interface SbomAttestationInput extends Omit<SbomInput, "dependencies">
+```
+
+## Members
+
+### bomDocument
+
+```ts
+readonly bomDocument?: Record<string, unknown>;
+```
+
+Pre-built CycloneDX BOM document to attest verbatim. Used when the caller (e.g. a publish orchestrator) has already generated the BOM with full NTIA / supplier metadata via `Sbom.generate` and just wants this service to wrap it in an in-toto envelope, sign it, and POST it. Mutually exclusive with `dependencies`.
+
+### dependencies
+
+```ts
+readonly dependencies?: SbomInput["dependencies"];
+```
+
+Resolved direct dependencies of the root package. When provided, the live implementation builds a CycloneDX BOM from the list and attests it. Mutually exclusive with `bomDocument`.
+
+### subjectSha256
+
+```ts
+readonly subjectSha256: string;
+```
+
+Hex-encoded SHA-256 of the package tarball (or other artifact bytes) the BOM describes. The runtime in-toto [subject](silk://packages/github-action-effects/api/function/subject) becomes `pkg:npm/{rootName}@{rootVersion}` with this digest.