Skip to content

Complete Durable Streams documentation, templates, and skills - #3965

Merged
vigoo merged 6 commits into
mainfrom
gol-109-durable-streams-guidance
Sep 25, 2026
Merged

Complete Durable Streams documentation, templates, and skills#3965
vigoo merged 6 commits into
mainfrom
gol-109-durable-streams-guidance

Conversation

@vigoo

@vigoo vigoo commented Sep 24, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Summary

  • document Durable Streams end to end, including URL families, operation/status/header behavior, compatibility boundaries, external stream consumption, exact-prefix forks, expiry, configuration, metrics, and retained history
  • extend the Rust, TypeScript, Effect, Scala, and MoonBit streaming templates with authenticated external-stream consumers/writers and runnable session, append, result, and fork walkthroughs
  • add five language-specific Durable Streams skills, an end-to-end skill-harness scenario, and regenerated how-to guides
  • add opaque TypeScript and MoonBit secret-capability bridges so Durable Streams authentication never reveals or logs plaintext credentials; TypeScript keeps raw capability access behind an SDK-private WeakMap rather than a reflectable symbol method
  • add CLI integration coverage that generates, builds, deploys, and executes all five language templates against the existing Durable Streams reference-server harness

Verification

  • five-language template coverage added; focused Effect template generation/build passed
  • Effect SDK: format and type checks passed; 1,016 tests passed
  • TypeScript Durable Streams SDK: 27 focused tests passed, including raw-capability privacy, fresh acquisition, forgery rejection, and disposal on success/failure
  • skill harness: build/format clean; 213 tests passed; Effect Durable Streams scenario dry-run/schema validation passed
  • docs: formatting, lint, type checks, 628-file link check, version checks, production build (631 pages), and generated-skills drift checks passed
  • Oracle reviewed the Effect documentation/template/skill work and explicitly confirmed the final TypeScript secret bridge does not weaken opaque-secret safety; all accepted findings were fixed
  • scoped bug-finder review found no bugs

Resolves GOL-109

@vigoo @ampagent
Complete GOL-109 Durable Streams guidance
150491a 
Add end-to-end documentation, four-language templates, skills and verified walkthroughs, including opaque TypeScript and MoonBit secret capability bridges.

Amp-Thread-ID: https://ampcode.com/threads/T-01a0d38d-46c7-7256-9bf0-c19421312dd5
Co-authored-by: Amp <amp@ampcode.com>
@vigoo
vigoo requested a review from a team September 24, 2026 16:05
@netlify

netlify Bot commented Sep 24, 2026 •
edited
Loading

Copy link
Copy Markdown

✅ Deploy Preview for golemcloud canceled.

Name Link
🔨 Latest commit 8e1f45a
🔍 Latest deploy log https://app.netlify.com/projects/golemcloud/deploys/6ab66077b42ec400085ef4eb

@github-actions

github-actions Bot commented Sep 24, 2026 •
edited
Loading

Copy link
Copy Markdown

📖 Docs preview: https://docs-oulhb0huw-golem-cloud.vercel.app

Built from commit 8e1f45a80a6a02aca657fe93acd5fe0508bfcf9b by docs.yaml.

@vigoo vigoo closed this Sep 25, 2026
@vigoo
Merge remote-tracking branch 'origin/main' into gol-109-durable-strea…
85d214c 
…ms-guidance

Amp-Thread-ID: https://ampcode.com/threads/T-01a0d38d-46c7-7256-9bf0-c19421312dd5
Co-authored-by: Amp <amp@ampcode.com>

# Conflicts:
#	docs/src/content/next/how-to-guides.mdx
#	docs/src/content/next/how-to-guides/moonbit.mdx
#	docs/src/content/next/how-to-guides/moonbit/_meta.js
#	docs/src/content/next/how-to-guides/rust.mdx
#	docs/src/content/next/how-to-guides/rust/_meta.js
#	docs/src/content/next/how-to-guides/scala.mdx
#	docs/src/content/next/how-to-guides/scala/_meta.js
#	docs/src/content/next/how-to-guides/ts.mdx
#	docs/src/content/next/how-to-guides/ts/_meta.js
#	docs/src/content/next/invoke/_meta.js
#	docs/src/content/next/operate/durable_streams.mdx
@vigoo vigoo reopened this Sep 25, 2026
@github-actions github-actions Bot locked and limited conversation to collaborators Sep 25, 2026
@golemcloud golemcloud unlocked this conversation Sep 25, 2026
vigoo and others added 2 commits September 25, 2026 11:04
@vigoo
Merge remote-tracking branch 'origin/main' into gol-109-durable-strea…
2202ba5 
…ms-guidance

Amp-Thread-ID: https://ampcode.com/threads/T-01a0d38d-46c7-7256-9bf0-c19421312dd5
Co-authored-by: Amp <amp@ampcode.com>

# Conflicts:
#	docs/src/content/next/operate/durable_streams.mdx
@vigoo @ampagent
Pass the agent fingerprint to lookup_durable_stream_control_metadata …
8e1f45a 
…in reader-forward tests

Aligns the reader-forward fork test call sites with the signature change
merged from main, which added the AgentFingerprint parameter.

Amp-Thread-ID: https://ampcode.com/threads/T-01a0d81f-f7d8-73cb-b78b-1639f624fff0
Co-authored-by: Amp <amp@ampcode.com>
@vigoo
vigoo merged commit 137f750 into main Sep 25, 2026
71 checks passed
@vigoo
vigoo deleted the gol-109-durable-streams-guidance branch September 25, 2026 13:50
@github-actions github-actions Bot locked and limited conversation to collaborators Sep 25, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@vigoo