Merge commit '36c66dd290d3ce6eb1ccd310d0c658d4a32bb8eb' as 'repos/effect'
This commit is contained in:
43
repos/effect/.agents/skills/grill-me/SKILL.md
Normal file
43
repos/effect/.agents/skills/grill-me/SKILL.md
Normal file
@@ -0,0 +1,43 @@
|
||||
---
|
||||
name: grill-me
|
||||
description: Interview the user about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".
|
||||
---
|
||||
|
||||
Interview me about every aspect of this plan until we reach a shared understanding and a defensible design.
|
||||
|
||||
Ask exactly one question at a time, then wait for my answer before asking the next question.
|
||||
|
||||
Use each answer to choose the next highest-leverage unresolved question. Maintain an implicit decision tree of resolved decisions, open questions, assumptions, dependencies, risks, and rejected alternatives.
|
||||
|
||||
For each question, include:
|
||||
|
||||
- clear answer options when appropriate
|
||||
- your recommended answer, marked as recommended
|
||||
- a brief reason for the recommendation
|
||||
|
||||
Use open-ended questions when fixed options would prematurely constrain the design space.
|
||||
|
||||
Challenge vague, inconsistent, risky, or unsupported assumptions. If an answer creates a contradiction or unresolved dependency, ask a follow-up before moving on.
|
||||
|
||||
Cover, as relevant:
|
||||
|
||||
- goals and non-goals
|
||||
- users and stakeholders
|
||||
- constraints
|
||||
- alternatives
|
||||
- APIs and interfaces
|
||||
- data model
|
||||
- error handling
|
||||
- security
|
||||
- observability
|
||||
- testing
|
||||
- migration and rollout
|
||||
- failure modes
|
||||
- operational ownership
|
||||
- success criteria
|
||||
|
||||
If repository facts are needed, inspect the codebase instead of asking the user. Do not ask me to provide information that can be determined locally.
|
||||
|
||||
When an available user-input tool such as `request_user_input` fits the question, use it to ask one short question with a small set of mutually exclusive options. Otherwise, ask in plain text and present clear possible answers as a numbered list when that helps me answer quickly. Include your recommended option and mark it as recommended.
|
||||
|
||||
Stop when the major branches of the design tree have been resolved. Then summarize the agreed design, remaining risks, assumptions, rejected alternatives, and next steps.
|
||||
203
repos/effect/.agents/skills/jsdocs/SKILL.md
Normal file
203
repos/effect/.agents/skills/jsdocs/SKILL.md
Normal file
@@ -0,0 +1,203 @@
|
||||
---
|
||||
name: jsdocs
|
||||
description: Write, insert, or update Effect public API JSDoc so it satisfies the jsdocs oxlint rule. Use when adding or fixing JSDoc comments, resolving jsdocs diagnostics, preparing docs for JSON extraction, or reviewing public API documentation.
|
||||
---
|
||||
|
||||
Use this skill to write well-formed JSDoc for Effect public APIs.
|
||||
|
||||
## Workflow
|
||||
|
||||
When updating public API JSDoc:
|
||||
|
||||
1. Inspect the declaration, implementation, nearby tests, and nearby JSDoc before editing.
|
||||
2. Decide whether the task is a single API fix or a module refinement pass.
|
||||
3. Rewrite comments into the required documentation shape while preserving correct facts and examples.
|
||||
4. For module refinements, complex APIs, or APIs with related alternatives, run the `@see` and `**Gotchas**` audits.
|
||||
5. Run the narrowest relevant validation.
|
||||
|
||||
## Required documentation shape
|
||||
|
||||
Use a normal multiline JSDoc comment in TypeScript source:
|
||||
|
||||
```ts
|
||||
/**
|
||||
* Short description as one paragraph.
|
||||
*
|
||||
* **When to use**
|
||||
*
|
||||
* Optional practical usage guidance.
|
||||
*
|
||||
* **Details**
|
||||
*
|
||||
* Optional details for complex APIs, options, overloads, or behavior.
|
||||
*
|
||||
* **Gotchas**
|
||||
*
|
||||
* Optional edge cases, footguns, or surprising behavior.
|
||||
*
|
||||
* **Example** (Short title)
|
||||
*
|
||||
* Optional prose explaining the example.
|
||||
*
|
||||
* ```ts
|
||||
* const result = example()
|
||||
* ```
|
||||
*
|
||||
* @category constructors
|
||||
* @since 1.0.0
|
||||
*/
|
||||
```
|
||||
|
||||
## Prose Rules
|
||||
|
||||
- Use sober, practical prose.
|
||||
- Write all public JSDoc prose in English.
|
||||
- Do not use jargon when a plain word works.
|
||||
- Do not be clever.
|
||||
- Do not add filler sections.
|
||||
- The short description is required and must be exactly one paragraph.
|
||||
- Make the short description stand on its own. Do not rely on `**When to use**`
|
||||
to make the API understandable.
|
||||
- For functions and methods, prefer present-tense, action-first prose such as
|
||||
`Creates`, `Returns`, `Checks`, `Provides`, `Represents`, `Converts`,
|
||||
`Decodes`, or `Formats`.
|
||||
- For technical value exports, use consistent noun forms such as `Schema for`,
|
||||
`Layer that`, `Service that`, `Context reference that`, or
|
||||
`Constructors and matchers for`.
|
||||
- Avoid leading `A` or `An` for canonical technical nouns when the surrounding
|
||||
module uses a standard noun family, for example prefer `Schema for ...` over
|
||||
`A schema for ...`.
|
||||
- Do not describe implementation mechanics when a public concept is clearer.
|
||||
For example, prefer `Constructors and matchers for ...` over wording that
|
||||
only says an API uses `Data.taggedEnum`.
|
||||
- Avoid generic purity or non-mutation remarks unless they document a real
|
||||
surprise, caveat, or meaningful contrast with a mutating-looking API.
|
||||
- Optional sections must appear in this order:
|
||||
1. `**When to use**`
|
||||
2. `**Details**`
|
||||
3. `**Gotchas**`
|
||||
- Include an optional section only when it has useful, non-empty content.
|
||||
- Prefer prose over bullet lists for single-item `**Details**`, `**When to use**`, or `**Gotchas**` sections. Use bullets only when there are two or more parallel facts, options, cases, or caveats.
|
||||
- `**When to use**` describes the positive use case for the documented API. Do not use it as a routing section for sibling APIs. If neighboring APIs need to be mentioned, put that boundary in `@see` tag text instead.
|
||||
- `**When to use**` is important when the API has close alternatives, trade-offs, or `@see` tags. If `@see` tags are present, inspect the referenced APIs and add `**When to use**` when it clarifies the documented API's own use case.
|
||||
- `**When to use**` must start with one of these practical guidance forms: `Use to`, `Use when`, `Use as`, or `Use with`. Avoid bullet lists and vague openers such as `Use this...` or `Useful for...`.
|
||||
- Prefer reader-centered `**When to use**` wording, especially `Use when you ...`,
|
||||
when the sentence describes a user's goal. Avoid third-person noun-phrase
|
||||
subjects such as `the input is ...`, `a service needs ...`, or
|
||||
`values should ...` when they would become awkward in generated prompts.
|
||||
- A good `**When to use**` sentence should still read naturally if reused as
|
||||
a user intent prompt, for example after `I need ...` or `I have ...`.
|
||||
- Keep `short` and `**When to use**` distinct: the short description says what
|
||||
the API is or does; `**When to use**` says when to choose it.
|
||||
- Add internal `@see` tags only for semantically useful related public APIs.
|
||||
- Write `@see` tag text as normal prose after the link; no special separator is required. Prefer forms like `@see {@link otherApi} for ...` when a short explanation helps.
|
||||
- Use exactly one blank line between the short description, sections, examples, and tags.
|
||||
- Do not use Markdown headings such as `# Heading` or ad hoc bold headings such as `**Notes**`; only the standard headings are allowed.
|
||||
- Examples must use `**Example** (Title)`, optional prose, and exactly one non-empty `ts` code fence.
|
||||
- Example titles must be unique after trimming and lowercasing.
|
||||
- Example titles should be short use-case phrases, not generic labels.
|
||||
- Prefer gerund or action-noun titles that read naturally after `for`, for
|
||||
example `Parsing JSON`, `Creating a scoped runtime`, or `Comparing structs`.
|
||||
- Avoid imperative titles such as `Parse JSON`, vague labels such as `Syntax`
|
||||
or `Basic usage`, and title-cased fragments such as `String Ordering`.
|
||||
- Preserve canonical technical capitalization inside the phrase, such as
|
||||
`Option`, `Effect`, `Schema`, `DateTime`, `HashMap`, `Base64`, and `JSON`.
|
||||
- For multiple examples on the same API, make each title describe the distinct
|
||||
use case shown by that example.
|
||||
- Prefer examples with stable, deterministic output. Avoid assertions or
|
||||
`console.log` comments that depend on stack traces, object inspection,
|
||||
`Error` formatting, concurrency order, timing, randomness, or
|
||||
environment-specific formatting. Examples may assume Node.js console
|
||||
formatting. Direct `Set` / `Map` output is acceptable when insertion order is
|
||||
deterministic and the expected output uses Node's format; otherwise
|
||||
demonstrate a stable property instead.
|
||||
- Do not use `@example`.
|
||||
- Do not put TypeScript code fences outside `**Example** (Title)` sections.
|
||||
- Inline `{@link Symbol}` targets must resolve to TypeScript symbols; do not link to URLs with `{@link}`.
|
||||
- Avoid overlinking in prose. Use `{@link Symbol}` only when navigation to
|
||||
that symbol helps the reader choose or understand the API. For the API being
|
||||
documented, the module's central type, nearby obvious names, or repeated
|
||||
mentions, prefer plain code formatting such as `Cause`, `Effect`, or
|
||||
`Context`.
|
||||
- Do not document module-level comments; module JSDoc is ignored by this rule.
|
||||
- `@internal` means the item is ignored; do not rewrite it as public docs.
|
||||
- Default exports are ignored by this rule and do not need JSDoc.
|
||||
- Do not add unsupported constructs such as enums or empty exports in checked files.
|
||||
- For low-level public values, prefer accurate categories such as `symbols`,
|
||||
`type IDs`, or `prototypes` over compensating with verbose descriptions.
|
||||
|
||||
## Tag rules
|
||||
|
||||
When multiple tags are present, keep them in this order:
|
||||
|
||||
1. `@deprecated`
|
||||
2. `@default`
|
||||
3. `@see`
|
||||
4. `@category`
|
||||
5. `@since`
|
||||
|
||||
Tag requirements by declaration kind:
|
||||
|
||||
- Root declarations require `@category` and stable-semver `@since`, and must
|
||||
not use `@default`.
|
||||
- Namespaces and declarations inside namespaces require stable-semver `@since`,
|
||||
may use `@category`, and must not use `@default`.
|
||||
- Member JSDoc is optional. When present, it follows the same prose and layout
|
||||
rules, may use optional stable-semver `@since`, may use non-empty `@default`,
|
||||
and must not use `@category`.
|
||||
- Any declaration may use `@deprecated` with a non-empty message and repeated
|
||||
non-empty `@see` tags for semantically useful related public APIs.
|
||||
|
||||
## Updating existing JSDoc
|
||||
|
||||
When fixing or updating existing docs:
|
||||
|
||||
1. Preserve correct facts and examples.
|
||||
2. Rewrite the layout into the standard template.
|
||||
3. Move usage guidance into `**When to use**`, behavior details into `**Details**`, and real caveats into `**Gotchas**`.
|
||||
4. Convert `@example` tags and loose `ts` fences into `**Example** (Title)` sections.
|
||||
5. Preserve valid `@see`, `@deprecated`, `@default`, `@category`, and `@since` tags.
|
||||
6. Remove `@see` tags that do not point to semantically useful related public APIs.
|
||||
7. Replace redundant inline `{@link ...}` tags with plain code formatting when
|
||||
the link target is already obvious from the current declaration or module.
|
||||
8. Remove sections that would be empty.
|
||||
|
||||
## Module refinement
|
||||
|
||||
When asked to refine an existing module:
|
||||
|
||||
1. First scan the module for local documentation patterns, repeated API families, and category conventions.
|
||||
2. Keep the change focused on documentation quality unless the user also asked for rule or source changes.
|
||||
3. Prefer improving existing comments over rewriting every comment into a new voice.
|
||||
4. Preserve examples unless they are wrong, stale, nondeterministic, or fail
|
||||
the required documentation shape.
|
||||
5. Apply the `@see` and `**Gotchas**` audits across the module before finishing.
|
||||
|
||||
## See audit
|
||||
|
||||
When refining an existing public API module, always do a dedicated `@see` pass:
|
||||
|
||||
1. Inspect existing `@see` tags and referenced APIs before keeping, changing, or removing them.
|
||||
2. Look for close alternatives in the same module or API family when the documented API is one of several ways to do similar work.
|
||||
3. Keep or add `@see` only when the linked API is semantically useful to understand the documented API.
|
||||
4. Good `@see` targets include sibling APIs, alternatives, inverse operations, lower-level or higher-level variants, complementary operations, and closely returned, consumed, or configured types/values.
|
||||
5. Do not use `@see` for implementation dependencies, broad concepts, external background links, APIs that merely share a word or name, helper APIs used only inside examples, undocumented/private members, or APIs that are only generally compatible.
|
||||
6. When `@see` tags are kept or added, include `**When to use**` guidance if the documented API's own use case is not obvious from the short description. Keep comparisons with sibling APIs in the `@see` tag text.
|
||||
|
||||
## Gotchas audit
|
||||
|
||||
When refining an existing public API module, always do a dedicated `**Gotchas**` pass:
|
||||
|
||||
1. Scan existing prose for caveat language: warnings, exceptions, limitations, preconditions, special cases, or behavior that is easy to misuse.
|
||||
2. Inspect the implementation and nearby tests for behavior that is not obvious from the type signature or short description.
|
||||
3. Move real caveats from `**Details**` into `**Gotchas**` when they describe edge cases, footguns, preconditions, surprising behavior, or important failure modes.
|
||||
4. Add `**Gotchas**` only when the caveat is concrete and useful to a reader choosing or using the API.
|
||||
5. If no gotchas are added during a refinement pass, state that a gotchas audit was performed and why no caveats were worth documenting.
|
||||
|
||||
## Validation
|
||||
|
||||
Run the narrowest validation that matches the change:
|
||||
|
||||
- For JSDoc or example changes in a package with generated docs, run `pnpm docgen` from that package directory.
|
||||
- Run `pnpm lint` because the linter includes the custom rule that checks public API JSDoc.
|
||||
- Do not run broad validation for prose-only skill edits.
|
||||
44
repos/effect/.agents/skills/scratchpad/SKILL.md
Normal file
44
repos/effect/.agents/skills/scratchpad/SKILL.md
Normal file
@@ -0,0 +1,44 @@
|
||||
---
|
||||
name: scratchpad
|
||||
description: Extract the JSDoc example nearest the active source selection or cursor into ./scratchpad as a TypeScript file. Use when the user asks to dump, copy, open, or try a source example in scratchpad.
|
||||
---
|
||||
|
||||
Use this skill to create a scratchpad TypeScript file from the JSDoc `**Example**`
|
||||
nearest the user's active source cursor or selection.
|
||||
|
||||
## Workflow
|
||||
|
||||
1. Determine the source path and line:
|
||||
- Use the IDE active file and selection/cursor line when present.
|
||||
- Use an explicit file and line when the user provides them.
|
||||
- If no line or selection is available, ask for it.
|
||||
2. Run:
|
||||
|
||||
```sh
|
||||
node .agents/skills/scratchpad/scripts/extract-example.mjs <source-path> <line>
|
||||
```
|
||||
|
||||
3. If the script exits with code 2 because there is no obvious runner, ask the
|
||||
user whether to preserve the example exactly, name an Effect value to run, or
|
||||
cancel.
|
||||
- To preserve exactly, rerun with `--mode preserve`.
|
||||
- To run a specific Effect value, rerun with `--runner <identifier>`.
|
||||
4. Report the created path as a clickable file link. This is the deterministic
|
||||
way to open it in the code pane.
|
||||
5. Do not run the scratchpad file unless the user explicitly asks.
|
||||
|
||||
## Behavior
|
||||
|
||||
- The script chooses the example whose `**Example**` section contains the line;
|
||||
otherwise it chooses the first following example; otherwise the nearest
|
||||
previous example.
|
||||
- Filenames are derived from the source file and example title, for example
|
||||
`scratchpad/Schedule-retrying-and-repeating-effects.ts`.
|
||||
- Existing files are not overwritten. The script appends a numeric suffix.
|
||||
- In auto mode, if a top-level `program` binding exists, the script appends:
|
||||
|
||||
```ts
|
||||
Effect.runPromise(program).then(console.log, console.error)
|
||||
```
|
||||
|
||||
- If the example already contains an Effect runner, the script preserves it.
|
||||
@@ -0,0 +1,7 @@
|
||||
interface:
|
||||
display_name: "Scratchpad"
|
||||
short_description: "Extract examples into scratchpad"
|
||||
default_prompt: "Use $scratchpad to extract the active JSDoc example into scratchpad."
|
||||
|
||||
policy:
|
||||
allow_implicit_invocation: true
|
||||
@@ -0,0 +1,260 @@
|
||||
#!/usr/bin/env node
|
||||
|
||||
import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs"
|
||||
import { basename, extname, isAbsolute, join, relative, resolve } from "node:path"
|
||||
|
||||
const usage = `Usage:
|
||||
node .agents/skills/scratchpad/scripts/extract-example.mjs <source-path> <line> [--mode auto|preserve] [--runner <identifier>] [--out-dir <dir>]
|
||||
|
||||
Examples:
|
||||
node .agents/skills/scratchpad/scripts/extract-example.mjs packages/effect/src/Schedule.ts 9
|
||||
node .agents/skills/scratchpad/scripts/extract-example.mjs packages/effect/src/Schedule.ts 9 --mode preserve
|
||||
node .agents/skills/scratchpad/scripts/extract-example.mjs packages/effect/src/Schedule.ts 9 --runner myProgram
|
||||
`
|
||||
|
||||
const args = process.argv.slice(2)
|
||||
const sourcePath = args[0]
|
||||
const lineInput = args[1]
|
||||
let mode = "auto"
|
||||
let runner = undefined
|
||||
let outDir = "scratchpad"
|
||||
|
||||
for (let index = 2; index < args.length; index++) {
|
||||
const arg = args[index]
|
||||
if (arg === "--mode") {
|
||||
mode = args[++index]
|
||||
} else if (arg === "--runner") {
|
||||
runner = args[++index]
|
||||
} else if (arg === "--out-dir") {
|
||||
outDir = args[++index]
|
||||
} else {
|
||||
fail(`Unknown option: ${arg}`)
|
||||
}
|
||||
}
|
||||
|
||||
if (!sourcePath || !lineInput) {
|
||||
fail(usage)
|
||||
}
|
||||
|
||||
if (mode !== "auto" && mode !== "preserve") {
|
||||
fail(`Invalid --mode: ${mode}`)
|
||||
}
|
||||
|
||||
if (runner !== undefined && !/^[A-Za-z_$][\w$]*$/.test(runner)) {
|
||||
fail(`Invalid --runner identifier: ${runner}`)
|
||||
}
|
||||
|
||||
const line = Number.parseInt(lineInput, 10)
|
||||
|
||||
if (!Number.isSafeInteger(line) || line < 1) {
|
||||
fail(`Invalid line number: ${lineInput}`)
|
||||
}
|
||||
|
||||
const resolvedSourcePath = resolve(sourcePath)
|
||||
const source = readFileSync(resolvedSourcePath, "utf8")
|
||||
const sourceLines = source.split(/\r?\n/)
|
||||
const examples = findExamples(sourceLines)
|
||||
|
||||
if (examples.length === 0) {
|
||||
fail(`No JSDoc examples found in ${sourcePath}`)
|
||||
}
|
||||
|
||||
const example = chooseExample(examples, line)
|
||||
const hasRunner = /\bEffect\.run[A-Za-z]*\s*\(/.test(example.code)
|
||||
const programRunner = /^\s*(?:export\s+)?(?:const|let|var)\s+program\s*=/m.test(example.code)
|
||||
|
||||
let code = example.code.trimEnd()
|
||||
let runnerStatus = "none"
|
||||
|
||||
if (runner !== undefined) {
|
||||
code = appendRunner(code, runner)
|
||||
runnerStatus = `appended:${runner}`
|
||||
} else if (mode === "auto") {
|
||||
if (hasRunner) {
|
||||
runnerStatus = "already-present"
|
||||
} else if (programRunner) {
|
||||
code = appendRunner(code, "program")
|
||||
runnerStatus = "appended:program"
|
||||
} else {
|
||||
const payload = {
|
||||
status: "needs-runner",
|
||||
title: example.title,
|
||||
sourcePath: displayPath(resolvedSourcePath),
|
||||
titleLine: example.titleLine,
|
||||
codeStartLine: example.codeStartLine,
|
||||
codeEndLine: example.codeEndLine
|
||||
}
|
||||
process.stderr.write(`${JSON.stringify(payload, null, 2)}\n`)
|
||||
process.exit(2)
|
||||
}
|
||||
}
|
||||
|
||||
mkdirSync(outDir, { recursive: true })
|
||||
|
||||
const outputPath = uniqueOutputPath(outDir, resolvedSourcePath, example.title)
|
||||
writeFileSync(outputPath, `${code}\n`, "utf8")
|
||||
|
||||
process.stdout.write(
|
||||
`${JSON.stringify(
|
||||
{
|
||||
outputPath: displayPath(resolve(outputPath)),
|
||||
title: example.title,
|
||||
sourcePath: displayPath(resolvedSourcePath),
|
||||
titleLine: example.titleLine,
|
||||
codeStartLine: example.codeStartLine,
|
||||
codeEndLine: example.codeEndLine,
|
||||
runner: runnerStatus
|
||||
},
|
||||
null,
|
||||
2
|
||||
)}\n`
|
||||
)
|
||||
|
||||
function findExamples(lines) {
|
||||
const examples = []
|
||||
let blockStart = -1
|
||||
let block = []
|
||||
|
||||
for (let index = 0; index < lines.length; index++) {
|
||||
const line = lines[index]
|
||||
|
||||
if (blockStart === -1 && line.includes("/**")) {
|
||||
blockStart = index
|
||||
block = [line]
|
||||
if (line.includes("*/")) {
|
||||
collectExamples(examples, block, blockStart)
|
||||
blockStart = -1
|
||||
}
|
||||
continue
|
||||
}
|
||||
|
||||
if (blockStart !== -1) {
|
||||
block.push(line)
|
||||
if (line.includes("*/")) {
|
||||
collectExamples(examples, block, blockStart)
|
||||
blockStart = -1
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return examples
|
||||
}
|
||||
|
||||
function collectExamples(examples, block, blockStart) {
|
||||
const cleaned = block.map(cleanJSDocLine)
|
||||
|
||||
for (let index = 0; index < cleaned.length; index++) {
|
||||
const line = cleaned[index]
|
||||
const titleMatch = line.match(/\*\*Example\*\*(?:\s*\(([^)]+)\))?/)
|
||||
|
||||
if (titleMatch === null) {
|
||||
continue
|
||||
}
|
||||
|
||||
const title = titleMatch[1]?.trim() || `example-${blockStart + index + 1}`
|
||||
const fenceStart = findFenceStart(cleaned, index + 1)
|
||||
|
||||
if (fenceStart === -1) {
|
||||
continue
|
||||
}
|
||||
|
||||
const fenceEnd = findFenceEnd(cleaned, fenceStart + 1)
|
||||
|
||||
if (fenceEnd === -1) {
|
||||
continue
|
||||
}
|
||||
|
||||
examples.push({
|
||||
title,
|
||||
titleLine: blockStart + index + 1,
|
||||
codeStartLine: blockStart + fenceStart + 2,
|
||||
codeEndLine: blockStart + fenceEnd,
|
||||
code: cleaned.slice(fenceStart + 1, fenceEnd).join("\n")
|
||||
})
|
||||
|
||||
index = fenceEnd
|
||||
}
|
||||
}
|
||||
|
||||
function findFenceStart(lines, startIndex) {
|
||||
for (let index = startIndex; index < lines.length; index++) {
|
||||
const trimmed = lines[index].trim()
|
||||
|
||||
if (trimmed.startsWith("**Example**")) {
|
||||
return -1
|
||||
}
|
||||
|
||||
if (/^```(?:ts|typescript)?\s*$/.test(trimmed)) {
|
||||
return index
|
||||
}
|
||||
}
|
||||
|
||||
return -1
|
||||
}
|
||||
|
||||
function findFenceEnd(lines, startIndex) {
|
||||
for (let index = startIndex; index < lines.length; index++) {
|
||||
if (lines[index].trim() === "```") {
|
||||
return index
|
||||
}
|
||||
}
|
||||
|
||||
return -1
|
||||
}
|
||||
|
||||
function cleanJSDocLine(line) {
|
||||
return line.replace(/^\s*\/\*\*\s?/, "").replace(/^\s*\*\/\s?$/, "").replace(/^\s*\* ?/, "")
|
||||
}
|
||||
|
||||
function chooseExample(examples, line) {
|
||||
const containing = examples.find((example) => example.titleLine <= line && line <= example.codeEndLine)
|
||||
|
||||
if (containing !== undefined) {
|
||||
return containing
|
||||
}
|
||||
|
||||
const following = examples.find((example) => line < example.titleLine)
|
||||
|
||||
if (following !== undefined) {
|
||||
return following
|
||||
}
|
||||
|
||||
return examples[examples.length - 1]
|
||||
}
|
||||
|
||||
function appendRunner(code, identifier) {
|
||||
return `${code.trimEnd()}\n\nEffect.runPromise(${identifier}).then(console.log, console.error)`
|
||||
}
|
||||
|
||||
function uniqueOutputPath(directory, source, title) {
|
||||
const sourceName = basename(source, extname(source))
|
||||
const titleSlug = slug(title) || "example"
|
||||
const base = `${sourceName}-${titleSlug}`
|
||||
let candidate = join(directory, `${base}.ts`)
|
||||
let suffix = 2
|
||||
|
||||
while (existsSync(candidate)) {
|
||||
candidate = join(directory, `${base}-${suffix}.ts`)
|
||||
suffix++
|
||||
}
|
||||
|
||||
return candidate
|
||||
}
|
||||
|
||||
function slug(value) {
|
||||
return value
|
||||
.normalize("NFKD")
|
||||
.replace(/[\u0300-\u036f]/g, "")
|
||||
.toLowerCase()
|
||||
.replace(/[^a-z0-9]+/g, "-")
|
||||
.replace(/^-+|-+$/g, "")
|
||||
}
|
||||
|
||||
function displayPath(path) {
|
||||
return isAbsolute(path) ? relative(process.cwd(), path) || "." : path
|
||||
}
|
||||
|
||||
function fail(message) {
|
||||
process.stderr.write(`${message}\n`)
|
||||
process.exit(1)
|
||||
}
|
||||
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Add adaptive consume and feedback operations to the unstable persistent RateLimiterStore API, including in-memory and Redis-backed bounded cooldown, learning, learned pacing, and expiry behavior for 429 Retry-After feedback.
|
||||
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Added `BigDecimal.sumAll` and `BigDecimal.multiplyAll` for feature parity with `Number` and `BigInt`, closes #1880.
|
||||
5
repos/effect/.changeset/add-chunk-schema.md
Normal file
5
repos/effect/.changeset/add-chunk-schema.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Schema: add `Chunk` schema, closes #1585.
|
||||
19
repos/effect/.changeset/add-command-hidden.md
Normal file
19
repos/effect/.changeset/add-command-hidden.md
Normal file
@@ -0,0 +1,19 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Add `Command.withHidden` to hide subcommands from `--help` output, shell completions, and "did you mean?" suggestions, while keeping them fully invocable by exact name.
|
||||
|
||||
Useful for experimental or internal subcommands that should be accepted but not advertised on the public CLI surface.
|
||||
|
||||
```ts
|
||||
import { Command } from "effect/unstable/cli"
|
||||
|
||||
const experimental = Command.make("experimental").pipe(
|
||||
Command.withHidden
|
||||
)
|
||||
|
||||
const root = Command.make("mycli").pipe(
|
||||
Command.withSubcommands([experimental])
|
||||
)
|
||||
```
|
||||
5
repos/effect/.changeset/add-config-nested.md
Normal file
5
repos/effect/.changeset/add-config-nested.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Add `Config.nested` combinator to scope a config under a named prefix, closes #1437.
|
||||
15
repos/effect/.changeset/add-flag-hidden.md
Normal file
15
repos/effect/.changeset/add-flag-hidden.md
Normal file
@@ -0,0 +1,15 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Add `Flag.withHidden` (and `Param.withHidden`) to hide flags from `--help` output and shell completions while keeping them fully parseable on the command line.
|
||||
|
||||
Useful for experimental, internal, or deprecated flags that should be accepted but not advertised, e.g. `--experimental-foo`, debug toggles, or escape hatches that are not yet committed to the public CLI surface.
|
||||
|
||||
```ts
|
||||
import { Flag } from "effect/unstable/cli"
|
||||
|
||||
const experimental = Flag.boolean("experimental-foo").pipe(
|
||||
Flag.withHidden
|
||||
)
|
||||
```
|
||||
5
repos/effect/.changeset/add-from-string-schemas.md
Normal file
5
repos/effect/.changeset/add-from-string-schemas.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Add `DateFromString`, `BigIntFromString`, `BigDecimalFromString`, `TimeZoneNamedFromString`, `TimeZoneFromString`, and `DateTimeZonedFromString` schemas, closes #1941.
|
||||
5
repos/effect/.changeset/add-headers-remove-many.md
Normal file
5
repos/effect/.changeset/add-headers-remove-many.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
unstable/http Headers: add `removeMany` combinator for removing multiple headers at once
|
||||
5
repos/effect/.changeset/add-indexeddb-kvs-layer.md
Normal file
5
repos/effect/.changeset/add-indexeddb-kvs-layer.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"@effect/platform-browser": patch
|
||||
---
|
||||
|
||||
Adds an IndexedDB backed implementation of `KeyValueStore` as `BrowserKeyValueStore.layerIndexedDb`. This backend allows for non-blocking `KeyValueStore` operations, unlike the existing `Storage` api backed implementations.
|
||||
5
repos/effect/.changeset/add-make-msgpack.md
Normal file
5
repos/effect/.changeset/add-make-msgpack.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Add `RpcSerialization.makeMsgPack` for creating MessagePack serialization with custom msgpackr options. On Cloudflare Workers with `allow_eval_during_startup` (default for `compatibility_date >= 2025-06-01`), pass `{ useRecords: false }` to prevent msgpackr's JIT code generation via `new Function()`, which is blocked during request handling. Also fixes silent error swallowing in the `msgPack` decode path — non-incomplete errors are now rethrown instead of returning `[]`.
|
||||
5
repos/effect/.changeset/add-make-option.md
Normal file
5
repos/effect/.changeset/add-make-option.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Add `SchemaParser.makeOption` and `Schema.makeOption` for constructing schema values as `Option`.
|
||||
11
repos/effect/.changeset/add-missing-tx-modules.md
Normal file
11
repos/effect/.changeset/add-missing-tx-modules.md
Normal file
@@ -0,0 +1,11 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Add transactional STM modules: TxDeferred, TxPriorityQueue, TxPubSub, TxReentrantLock, TxSubscriptionRef.
|
||||
|
||||
Refactor transaction model: remove `Effect.atomic`/`Effect.atomicWith`. All Tx operations now return `Effect<A, E, Transaction>` requiring explicit `Effect.tx(...)` at boundaries.
|
||||
|
||||
Expose `TxPubSub.acquireSubscriber`/`releaseSubscriber` for composable transaction boundaries. Fix `TxSubscriptionRef.changes` race condition ensuring current value is delivered first.
|
||||
|
||||
Remove `TxRandom` module.
|
||||
5
repos/effect/.changeset/add-newtype-module.md
Normal file
5
repos/effect/.changeset/add-newtype-module.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Add `Newtype` module.
|
||||
5
repos/effect/.changeset/add-scalar-show-operation-id.md
Normal file
5
repos/effect/.changeset/add-scalar-show-operation-id.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Add `showOperationId` to `HttpApiScalar.ScalarConfig`.
|
||||
5
repos/effect/.changeset/add-schedule-tap.md
Normal file
5
repos/effect/.changeset/add-schedule-tap.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Added `Schedule.tap`, which allows observing full schedule metadata without altering schedule inputs or outputs.
|
||||
5
repos/effect/.changeset/add-schema-annotate-encoded.md
Normal file
5
repos/effect/.changeset/add-schema-annotate-encoded.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Schema: add `annotateEncoded` function for annotating the encoded side of a schema.
|
||||
5
repos/effect/.changeset/add-schema-array-ensure.md
Normal file
5
repos/effect/.changeset/add-schema-array-ensure.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Add `Schema.ArrayEnsure`.
|
||||
5
repos/effect/.changeset/add-schema-bigdecimal.md
Normal file
5
repos/effect/.changeset/add-schema-bigdecimal.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Schema: add `BigDecimal` schema with comparison checks (`isGreaterThanBigDecimal`, `isGreaterThanOrEqualToBigDecimal`, `isLessThanBigDecimal`, `isLessThanOrEqualToBigDecimal`, `isBetweenBigDecimal`).
|
||||
5
repos/effect/.changeset/add-schema-datetime.md
Normal file
5
repos/effect/.changeset/add-schema-datetime.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Schema: add `DateTimeZoned`, `TimeZoneOffset`, `TimeZoneNamed`, and `TimeZone` schemas.
|
||||
9
repos/effect/.changeset/add-schema-error-module.md
Normal file
9
repos/effect/.changeset/add-schema-error-module.md
Normal file
@@ -0,0 +1,9 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Expose `SchemaError` as a public module and re-export `Schema.isSchemaError`.
|
||||
|
||||
This gives consumers a stable import path and guard for schema failures without
|
||||
depending on the internal schema implementation, while preserving the existing
|
||||
`Schema.SchemaError` surface.
|
||||
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Schema: add `OptionFromOptionalNullOr` schema, closes #1707.
|
||||
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Schema: add `OptionFromUndefinedOr` and `OptionFromNullishOr` schemas.
|
||||
5
repos/effect/.changeset/add-schema-string-encoding.md
Normal file
5
repos/effect/.changeset/add-schema-string-encoding.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Schema: add `StringFromBase64`, `StringFromBase64Url`, `StringFromHex`, and `StringFromUriComponent` schemas for decoding encoded strings into UTF-8 strings, closes #1995.
|
||||
5
repos/effect/.changeset/add-sql-pglite.md
Normal file
5
repos/effect/.changeset/add-sql-pglite.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"@effect/sql-pglite": minor
|
||||
---
|
||||
|
||||
Add `@effect/sql-pglite` package, wrapping `@electric-sql/pglite` with the Effect SQL client (Postgres dialect, Effect-managed transactions via savepoints, listen/notify, dumpDataDir/refreshArrayTypes, and a Migrator).
|
||||
5
repos/effect/.changeset/add-standard-jsdoc-rule.md
Normal file
5
repos/effect/.changeset/add-standard-jsdoc-rule.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"@effect/oxc": patch
|
||||
---
|
||||
|
||||
Add an `effect/standard-jsdoc` oxlint rule for staged public API JSDoc standardization.
|
||||
5
repos/effect/.changeset/add-stream-broadcastn.md
Normal file
5
repos/effect/.changeset/add-stream-broadcastn.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Add Stream.broadcastN for fixed-size stream broadcasts.
|
||||
5
repos/effect/.changeset/add-unstable-encoding-export.md
Normal file
5
repos/effect/.changeset/add-unstable-encoding-export.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Add `unstable/encoding` subpath export.
|
||||
17
repos/effect/.changeset/add-values-unprepared.md
Normal file
17
repos/effect/.changeset/add-values-unprepared.md
Normal file
@@ -0,0 +1,17 @@
|
||||
---
|
||||
"effect": patch
|
||||
"@effect/sql-clickhouse": patch
|
||||
"@effect/sql-d1": patch
|
||||
"@effect/sql-libsql": patch
|
||||
"@effect/sql-mssql": patch
|
||||
"@effect/sql-mysql2": patch
|
||||
"@effect/sql-pg": patch
|
||||
"@effect/sql-pglite": patch
|
||||
"@effect/sql-sqlite-bun": patch
|
||||
"@effect/sql-sqlite-do": patch
|
||||
"@effect/sql-sqlite-node": patch
|
||||
"@effect/sql-sqlite-react-native": patch
|
||||
"@effect/sql-sqlite-wasm": patch
|
||||
---
|
||||
|
||||
Add `Statement.valuesUnprepared` for returning unprepared SQL statement rows as arrays.
|
||||
5
repos/effect/.changeset/afraid-cobras-like.md
Normal file
5
repos/effect/.changeset/afraid-cobras-like.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"@effect/platform-node-shared": patch
|
||||
---
|
||||
|
||||
default to endOnDone: false in NodeStdio
|
||||
6
repos/effect/.changeset/ai-openai-config-field-leak.md
Normal file
6
repos/effect/.changeset/ai-openai-config-field-leak.md
Normal file
@@ -0,0 +1,6 @@
|
||||
---
|
||||
"@effect/ai-openai": patch
|
||||
"@effect/ai-openai-compat": patch
|
||||
---
|
||||
|
||||
Fix `OpenAiLanguageModel` leaking library-only config fields (`fileIdPrefixes`, `strictJsonSchema`) into request body, causing OpenAI 400 errors.
|
||||
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"@effect/ai-openai": patch
|
||||
---
|
||||
|
||||
Fix `OpenAIFile` schema decode failure on responses where `expires_at` and `status_details` are returned as literal `null`. The OpenAI files endpoint returns `null` (not omitted) for these fields when no expiration / status detail applies (e.g. uploads with `purpose: "user_data"`), but the upstream OpenAPI spec marks them only as optional. Codegen patches widen both fields to allow `null`, which now decodes cleanly via `OpenAiClient.createFile`, `retrieveFile`, `listFiles`, and any other endpoint returning the `OpenAIFile` shape.
|
||||
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"@effect/ai-anthropic": patch
|
||||
---
|
||||
|
||||
Mark the Claude 4-6 generation as supporting native structured output in `getModelCapabilities`. `claude-opus-4-6` and `claude-sonnet-4-6` support Anthropic's constrained-decoding structured output (verified against the live API), but were classified as `supportsStructuredOutput: false`, so `generateObject` fell back to a forced JSON tool instead of requesting `output_config.format` (`json_schema`). `claude-opus-4-7` / `claude-opus-4-8` are classified the same way for when the generated `Model` enum picks them up.
|
||||
6
repos/effect/.changeset/anthropic-open-model-enum.md
Normal file
6
repos/effect/.changeset/anthropic-open-model-enum.md
Normal file
@@ -0,0 +1,6 @@
|
||||
---
|
||||
"@effect/ai-anthropic": patch
|
||||
---
|
||||
|
||||
Widen the Anthropic `Model` schema to accept both known model identifiers as well
|
||||
as any string to allow for newer models
|
||||
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Apply `transformClient` when building an individual HttpApi endpoint client, preserving the supplied client's error and service channels.
|
||||
5
repos/effect/.changeset/asyncresult-exhaustive.md
Normal file
5
repos/effect/.changeset/asyncresult-exhaustive.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Add an exhaustive finalizer to the AsyncResult builder.
|
||||
5
repos/effect/.changeset/atom-stream-error-type.md
Normal file
5
repos/effect/.changeset/atom-stream-error-type.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Expose `NoSuchElementError` in the error type of stream-based `Atom.make` overloads.
|
||||
5
repos/effect/.changeset/beige-paths-sort.md
Normal file
5
repos/effect/.changeset/beige-paths-sort.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
move ChildProcess apis into spawner service
|
||||
5
repos/effect/.changeset/better-apples-nail.md
Normal file
5
repos/effect/.changeset/better-apples-nail.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Effect.repeat now uses effect return value when using options
|
||||
5
repos/effect/.changeset/better-rocks-arrive.md
Normal file
5
repos/effect/.changeset/better-rocks-arrive.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"@effect/ai-openai": patch
|
||||
---
|
||||
|
||||
add back openai reasoning types
|
||||
5
repos/effect/.changeset/better-shrimps-follow.md
Normal file
5
repos/effect/.changeset/better-shrimps-follow.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"@effect/opentelemetry": patch
|
||||
---
|
||||
|
||||
prefix opentelemetry modules to avoid collisions
|
||||
5
repos/effect/.changeset/big-pans-look.md
Normal file
5
repos/effect/.changeset/big-pans-look.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
add Rpc.custom
|
||||
5
repos/effect/.changeset/blue-dingos-greet.md
Normal file
5
repos/effect/.changeset/blue-dingos-greet.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Add `Effect.filter` support for synchronous `Filter.Filter` overloads and correctly handle non-effect `Result` return values at runtime.
|
||||
5
repos/effect/.changeset/blue-ligers-cheat.md
Normal file
5
repos/effect/.changeset/blue-ligers-cheat.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Update unstable schema variant helpers to use array-based arguments for `FieldOnly`, `FieldExcept`, and `Union`, aligning `VariantSchema` and `Model` with other v4 API shapes.
|
||||
5
repos/effect/.changeset/blue-onions-smile.md
Normal file
5
repos/effect/.changeset/blue-onions-smile.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"@effect/ai-openai-compat": patch
|
||||
---
|
||||
|
||||
Preserve streamed OpenAI compat tool call ids and names across fragmented chat completion chunks.
|
||||
5
repos/effect/.changeset/blue-ravens-type.md
Normal file
5
repos/effect/.changeset/blue-ravens-type.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Ensure streamed tool results are emitted before the finish part so chat history includes tool outputs before stream termination.
|
||||
7
repos/effect/.changeset/blue-trams-kiss.md
Normal file
7
repos/effect/.changeset/blue-trams-kiss.md
Normal file
@@ -0,0 +1,7 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Fix consolePretty ignoring explicit colors option in non-TTY environments.
|
||||
|
||||
When colors is explicitly set to true, prettyLoggerTty was still gating it with processStdoutIsTTY check, making it impossible to enable colors in non-TTY environments like Vite dev server.
|
||||
5
repos/effect/.changeset/bold-chairs-yawn.md
Normal file
5
repos/effect/.changeset/bold-chairs-yawn.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
add HttpApiTest module
|
||||
30
repos/effect/.changeset/bold-planets-shout.md
Normal file
30
repos/effect/.changeset/bold-planets-shout.md
Normal file
@@ -0,0 +1,30 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
add support for merging external events into `Prompt.custom` render loops via an optional `events` dequeue and `receive` handler.
|
||||
|
||||
The prompt races user input against events from the dequeue, allowing background events to trigger re-renders without waiting for a keypress:
|
||||
|
||||
```ts
|
||||
const eventQueue = yield * Queue.make<number>()
|
||||
|
||||
const prompt = Prompt.custom(
|
||||
{ count: 0 },
|
||||
Queue.asDequeue(eventQueue), // <-- provide the event queue as a dequeue to the prompt
|
||||
{
|
||||
render: (state) => Effect.succeed(`Count: ${state.count}`),
|
||||
process: (input, state) =>
|
||||
Effect.succeed(
|
||||
Match.value(input).pipe(
|
||||
// handle user input
|
||||
Match.tag("Input", () => Action.Submit({ value: state.count })),
|
||||
// handle external events from the queue
|
||||
Match.tag("Event", (input) => Action.NextFrame({ state: { count: state.count + input.value } })),
|
||||
Match.exhaustive
|
||||
)
|
||||
),
|
||||
clear: () => Effect.succeed("")
|
||||
}
|
||||
)
|
||||
```
|
||||
5
repos/effect/.changeset/breezy-meals-see.md
Normal file
5
repos/effect/.changeset/breezy-meals-see.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
support tag unions in Effect.catchTag/Reason
|
||||
5
repos/effect/.changeset/bright-bugs-bow.md
Normal file
5
repos/effect/.changeset/bright-bugs-bow.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Run request resolver batch fibers with request services by using `Effect.runForkWith`, so resolver delay effects and `runAll` execution see the request service map.
|
||||
5
repos/effect/.changeset/bright-canyons-clean.md
Normal file
5
repos/effect/.changeset/bright-canyons-clean.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
add support for deferred responses in rpc
|
||||
5
repos/effect/.changeset/bright-dogs-fail.md
Normal file
5
repos/effect/.changeset/bright-dogs-fail.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Add `Model.BooleanSqlite`, a model field schema that uses `0 | 1` encoding for database variants and plain `boolean` encoding for JSON variants.
|
||||
5
repos/effect/.changeset/bright-flags-stand.md
Normal file
5
repos/effect/.changeset/bright-flags-stand.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Fix CLI parsing so command-local flags can override globals without breaking global flags before subcommands.
|
||||
5
repos/effect/.changeset/bright-laws-teach.md
Normal file
5
repos/effect/.changeset/bright-laws-teach.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Add `Config.Success` type utility, closes #1783.
|
||||
5
repos/effect/.changeset/bright-lemons-dance.md
Normal file
5
repos/effect/.changeset/bright-lemons-dance.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Allow `Effect.acquireRelease` release finalizers to depend on the surrounding environment.
|
||||
5
repos/effect/.changeset/bright-planes-smash.md
Normal file
5
repos/effect/.changeset/bright-planes-smash.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Add `responseText` to `AiError.StructuredOutputError` and populate it from `LanguageModel.generateObject` so failed structured output decodes include the full LLM text.
|
||||
5
repos/effect/.changeset/bright-rats-attend.md
Normal file
5
repos/effect/.changeset/bright-rats-attend.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
make fiber keepAlive setInterval evaluation lazy
|
||||
5
repos/effect/.changeset/bright-toes-rush.md
Normal file
5
repos/effect/.changeset/bright-toes-rush.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Persist MCP HTTP session and protocol headers after initialize so follow-up JSON-RPC requests include `MCP-Protocol-Version`.
|
||||
5
repos/effect/.changeset/bumpy-boxes-teach.md
Normal file
5
repos/effect/.changeset/bumpy-boxes-teach.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Rename Atom's `Context` type to `AtomContext`
|
||||
5
repos/effect/.changeset/busy-lions-sneeze.md
Normal file
5
repos/effect/.changeset/busy-lions-sneeze.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"@effect/ai-openrouter": patch
|
||||
---
|
||||
|
||||
Fix HTTP Referer header name in the `OpenRouterClient`
|
||||
7
repos/effect/.changeset/busy-maps-attend.md
Normal file
7
repos/effect/.changeset/busy-maps-attend.md
Normal file
@@ -0,0 +1,7 @@
|
||||
---
|
||||
"effect": patch
|
||||
"@effect/platform-bun": patch
|
||||
"@effect/platform-node": patch
|
||||
---
|
||||
|
||||
add rows to Terminal
|
||||
5
repos/effect/.changeset/calm-buckets-own.md
Normal file
5
repos/effect/.changeset/calm-buckets-own.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"@effect/ai-openai": patch
|
||||
---
|
||||
|
||||
improve openai socket errors
|
||||
7
repos/effect/.changeset/calm-carrots-march.md
Normal file
7
repos/effect/.changeset/calm-carrots-march.md
Normal file
@@ -0,0 +1,7 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Allow unstable HttpApi middleware to declare multiple error schemas with arrays.
|
||||
|
||||
Middleware errors now follow endpoint error behavior for response status resolution, client decoding, and generated API schemas.
|
||||
5
repos/effect/.changeset/calm-cars-rest.md
Normal file
5
repos/effect/.changeset/calm-cars-rest.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Add grouped subcommand support to `Command.withSubcommands`, including help output sections for named groups while keeping ungrouped commands under `SUBCOMMANDS`.
|
||||
5
repos/effect/.changeset/calm-masks-count.md
Normal file
5
repos/effect/.changeset/calm-masks-count.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Add `Schema.DateFromMillis` and `SchemaTransformation.dateFromMillis` for decoding millisecond timestamps into `Date` values.
|
||||
5
repos/effect/.changeset/calm-panthers-nail.md
Normal file
5
repos/effect/.changeset/calm-panthers-nail.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Add `disableFatalDefects` to `RpcServer.layerHttp`, `RpcServer.toHttpEffect`, and `RpcServer.toHttpEffectWebsocket` option types to match existing runtime support.
|
||||
5
repos/effect/.changeset/calm-ravens-reflect.md
Normal file
5
repos/effect/.changeset/calm-ravens-reflect.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Preserve `__proto__` group and endpoint identifiers in HTTP APIs, generated clients, and URL builders.
|
||||
5
repos/effect/.changeset/calm-seas-smile.md
Normal file
5
repos/effect/.changeset/calm-seas-smile.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Align workflow tags with RPCs by changing `Workflow.make` to accept the tag as its first argument, exposing workflow tags as `_tag`, and supporting `class MyWorkflow extends Workflow.make(...) {}`.
|
||||
5
repos/effect/.changeset/calm-squids-hug.md
Normal file
5
repos/effect/.changeset/calm-squids-hug.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
add Context.Key type, used a base for Context.Service and Context.Reference
|
||||
5
repos/effect/.changeset/calm-tracers-sample.md
Normal file
5
repos/effect/.changeset/calm-tracers-sample.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"@effect/opentelemetry": patch
|
||||
---
|
||||
|
||||
Preserve sampling decisions when adapting generic Effect external spans to OpenTelemetry.
|
||||
5
repos/effect/.changeset/chatty-poets-type.md
Normal file
5
repos/effect/.changeset/chatty-poets-type.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
remove Effect.Yieldable
|
||||
5
repos/effect/.changeset/chilled-mice-wash.md
Normal file
5
repos/effect/.changeset/chilled-mice-wash.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Add `HttpServerResponse.fromClientResponse` for directly converting client responses into server responses.
|
||||
5
repos/effect/.changeset/chilly-pumas-rule.md
Normal file
5
repos/effect/.changeset/chilly-pumas-rule.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Make `Data.Class`, `Data.TaggedClass`, and `Cause.YieldableError` pipeable.
|
||||
5
repos/effect/.changeset/chubby-buckets-feel.md
Normal file
5
repos/effect/.changeset/chubby-buckets-feel.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
fix issues with metro bundler
|
||||
5
repos/effect/.changeset/chubby-parents-flow.md
Normal file
5
repos/effect/.changeset/chubby-parents-flow.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
allow undefined for VariantSchema.Overridable input
|
||||
5
repos/effect/.changeset/chubby-planets-fall.md
Normal file
5
repos/effect/.changeset/chubby-planets-fall.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"@effect/ai-anthropic": patch
|
||||
---
|
||||
|
||||
Remove duplicate `ToolApprovalResponsePartOptions` from Anthropic package
|
||||
5
repos/effect/.changeset/clean-balloons-tan.md
Normal file
5
repos/effect/.changeset/clean-balloons-tan.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Proxy function arity from `Effect.fn` APIs so wrapped functions preserve the original `length` value.
|
||||
5
repos/effect/.changeset/clean-bulldogs-care.md
Normal file
5
repos/effect/.changeset/clean-bulldogs-care.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"@effect/sql-pg": patch
|
||||
---
|
||||
|
||||
Use `pg_notify` in `PgClient.notify` so channel and payload are sent through parameters instead of a `NOTIFY` statement string.
|
||||
5
repos/effect/.changeset/clean-dryers-sneeze.md
Normal file
5
repos/effect/.changeset/clean-dryers-sneeze.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Add `Random.nextBoolean` for generating random boolean values.
|
||||
5
repos/effect/.changeset/clean-geese-work.md
Normal file
5
repos/effect/.changeset/clean-geese-work.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Remove `Inspectable.stringifyCircular` and fix `Formatter.formatJson` so shared object references are preserved while only circular references are omitted.
|
||||
5
repos/effect/.changeset/clean-goats-wave.md
Normal file
5
repos/effect/.changeset/clean-goats-wave.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Add `Ctrl-U` line clearing support to editable CLI prompts.
|
||||
23
repos/effect/.changeset/clean-needles-shake.md
Normal file
23
repos/effect/.changeset/clean-needles-shake.md
Normal file
@@ -0,0 +1,23 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Fix module-level side effects that defeated bundler tree-shaking.
|
||||
|
||||
Bare top-level statements cannot be `#__PURE__`-annotated by the build, so
|
||||
bundlers must retain them and everything they reference, even in bundles that
|
||||
never use the code:
|
||||
|
||||
- `Option`: the standalone `Object.defineProperty(SomeProto, "valueOrUndefined", ...)`
|
||||
statement anchored the whole `Option` proto chain into every bundle. It is
|
||||
now folded into the `SomeProto` initializer.
|
||||
- `Headers`: same pattern with `Object.defineProperties(Proto, ...)`, folded
|
||||
into the initializer.
|
||||
- `Logger`: module-level `process.stdout.isTTY` property reads (potential
|
||||
getters, never droppable) moved inside `consolePretty`.
|
||||
- `Utils`: when `internalCall` was unused, its dropped binding left behind a
|
||||
retained initializer tail (`standard`/`forced` probe with computed property
|
||||
reads). The selection is now wrapped in a single pure-annotated call.
|
||||
|
||||
A minimal `Effect.succeed(123).pipe(Effect.runFork)` bundle shrinks by ~1.3%
|
||||
gzipped; bundles that don't use `Option` or `Headers` no longer pay for them.
|
||||
5
repos/effect/.changeset/clean-tires-guess.md
Normal file
5
repos/effect/.changeset/clean-tires-guess.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"@effect/sql-pg": patch
|
||||
---
|
||||
|
||||
clean up sql-pg constructors and layers
|
||||
5
repos/effect/.changeset/clear-hairs-pump.md
Normal file
5
repos/effect/.changeset/clear-hairs-pump.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
fix activity retry policy
|
||||
5
repos/effect/.changeset/clear-spies-boil.md
Normal file
5
repos/effect/.changeset/clear-spies-boil.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"@effect/platform-browser": patch
|
||||
---
|
||||
|
||||
improve idb support for compound indexes
|
||||
24
repos/effect/.changeset/cli-config-built-ins.md
Normal file
24
repos/effect/.changeset/cli-config-built-ins.md
Normal file
@@ -0,0 +1,24 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Add a scoped `CliConfig` service for customizing the built-in global flags used by CLI command runners.
|
||||
|
||||
For example, provide an explicit list that omits `GlobalFlag.LogLevel` to remove the built-in `--log-level` flag:
|
||||
|
||||
```ts
|
||||
import { Effect } from "effect"
|
||||
import { CliConfig, Command, GlobalFlag } from "effect/unstable/cli"
|
||||
|
||||
const program = Command.run(command, { version: "1.0.0" }).pipe(
|
||||
Effect.provide(
|
||||
CliConfig.layer({
|
||||
builtIns: [
|
||||
GlobalFlag.Help,
|
||||
GlobalFlag.Version,
|
||||
GlobalFlag.Completions
|
||||
]
|
||||
})
|
||||
)
|
||||
)
|
||||
```
|
||||
5
repos/effect/.changeset/cli-help-choices.md
Normal file
5
repos/effect/.changeset/cli-help-choices.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Append concrete choice values to CLI flag help descriptions so generated help shows valid command-line inputs.
|
||||
5
repos/effect/.changeset/cli-wizard-mode.md
Normal file
5
repos/effect/.changeset/cli-wizard-mode.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Reintroduce interactive CLI wizard mode through the `--wizard` flag and `Command.wizard`.
|
||||
35
repos/effect/.changeset/cold-knives-lie.md
Normal file
35
repos/effect/.changeset/cold-knives-lie.md
Normal file
@@ -0,0 +1,35 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Port `Pipeable.Class` from v3.
|
||||
|
||||
```ts
|
||||
class MyClass extends Pipeable.Class() {
|
||||
constructor(public a: number) {
|
||||
super()
|
||||
}
|
||||
methodA() {
|
||||
return this.a
|
||||
}
|
||||
}
|
||||
console.log(new MyClass(2).pipe((x) => x.methodA())) // 2
|
||||
```
|
||||
|
||||
```ts
|
||||
class A {
|
||||
constructor(public a: number) {}
|
||||
methodA() {
|
||||
return this.a
|
||||
}
|
||||
}
|
||||
class B extends Pipeable.Class(A) {
|
||||
constructor(private b: string) {
|
||||
super(b.length)
|
||||
}
|
||||
methodB() {
|
||||
return [this.b, this.methodA()]
|
||||
}
|
||||
}
|
||||
console.log(new B("pipe").pipe((x) => x.methodB())) // ['pipe', 4]
|
||||
```
|
||||
5
repos/effect/.changeset/cold-rooms-show.md
Normal file
5
repos/effect/.changeset/cold-rooms-show.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"@effect/platform-browser": patch
|
||||
---
|
||||
|
||||
use Cause.NoSuchElementError for idb .first queries
|
||||
5
repos/effect/.changeset/cold-sloths-wave.md
Normal file
5
repos/effect/.changeset/cold-sloths-wave.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"@effect/ai-openai": patch
|
||||
---
|
||||
|
||||
Add support for OpenAI `keepalive` response stream events.
|
||||
5
repos/effect/.changeset/common-mammals-tickle.md
Normal file
5
repos/effect/.changeset/common-mammals-tickle.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
"@effect/openapi-generator": patch
|
||||
---
|
||||
|
||||
Fix generation order for recursive schemas referenced by earlier recursive definitions, closes #6357.
|
||||
25
repos/effect/.changeset/compact-json-schema-enum.md
Normal file
25
repos/effect/.changeset/compact-json-schema-enum.md
Normal file
@@ -0,0 +1,25 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Schema: collapse same-type literal branches in JSON Schema output into a single `enum` array, closes #1868.
|
||||
|
||||
Before:
|
||||
|
||||
```json
|
||||
{
|
||||
"anyOf": [
|
||||
{ "type": "string", "enum": ["A"] },
|
||||
{ "type": "string", "enum": ["B"] }
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
After:
|
||||
|
||||
```json
|
||||
{
|
||||
"type": "string",
|
||||
"enum": ["A", "B"]
|
||||
}
|
||||
```
|
||||
7
repos/effect/.changeset/config-withdefault-eager.md
Normal file
7
repos/effect/.changeset/config-withdefault-eager.md
Normal file
@@ -0,0 +1,7 @@
|
||||
---
|
||||
"effect": patch
|
||||
---
|
||||
|
||||
Revert `Config.withDefault` to v3 behavior, closes #1530.
|
||||
|
||||
Make `Config.withDefault` accept an eager value instead of `LazyArg`, aligning with CLI module conventions.
|
||||
24
repos/effect/.changeset/config.json
Normal file
24
repos/effect/.changeset/config.json
Normal file
@@ -0,0 +1,24 @@
|
||||
{
|
||||
"$schema": "https://unpkg.com/@changesets/config@1.6.4/schema.json",
|
||||
"changelog": ["@changesets/changelog-github", { "repo": "Effect-TS/effect" }],
|
||||
"commit": false,
|
||||
"linked": [],
|
||||
"access": "restricted",
|
||||
"baseBranch": "main",
|
||||
"updateInternalDependencies": "patch",
|
||||
"ignore": [
|
||||
"scratchpad",
|
||||
"scripts"
|
||||
],
|
||||
"privatePackages": false,
|
||||
"fixed": [
|
||||
[
|
||||
"effect",
|
||||
"@effect/*"
|
||||
]
|
||||
],
|
||||
"snapshot": {
|
||||
"useCalculatedVersion": false,
|
||||
"prereleaseTemplate": "{tag}-{commit}"
|
||||
}
|
||||
}
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user