Software factory architecture
Stable runtime, isolated sources, provider-owned adaptations, and deterministic output.
Stable boundary
The shared distilled package is intentionally thin. It pins and re-exports Alchemy’s @distilled.cloud/core, owns cross-provider generator adaptations, and exposes the common Effect runtime surface. Provider-specific behavior stays in each SDK.
PropType
shareddistilled
Runtime façade, common traits, and generator adaptations.
Type
distilledsourcedistilled-spec-* | upstream submodule
An exact, reviewable pin of the authoritative API input.
Type
distilled-spec-* | upstream submoduleproviderdistilled-<provider>
Credentials, patches, errors, retry policy, and generated operations.
Type
distilled-<provider>Repository topology
distilled
shared Effect runtime façade
OpenAPI generator
distilled-spec-jira
official Atlassian OpenAPI
distilled-jira
patches + generated operations
distilled-spec-github
versioned GitHub REST bundle
distilled-github
patches + generated operations
distilled-slack
pinned slackapi/node-slack-sdk
TypeScript AST generator
distilled-spec-avalara
official AvaTax Swagger
distilled-avalara
provider policy + generated operations
distilled-spec-statsig
official Console API OpenAPI
distilled-statsig
provider policy + generated operations
distilled-spec-auth0
official Management API OpenAPI
distilled-auth0
provider policy + generated operations
distilled-spec-opensearch
official merged OpenAPI 3.1 release
distilled-opensearch
cluster policy + 684 generated operations
Source decision rule
| Upstream source | Repository strategy | Generator |
|---|---|---|
| Maintained, compact OpenAPI | Mirror the authoritative document | Shared OpenAPI generator |
| Maintained OpenAPI in a very large repository | Mirror only the exact bundled document | Shared OpenAPI generator |
| No maintained OpenAPI; official typed SDK exists | Pin the official SDK directly | Provider-specific TypeScript AST generator |
Update flow
Generated output is committed. That is a feature: changes to upstream sources, generator behavior, and patches become ordinary reviewable diffs.