Commit Graph

39 Commits

Author SHA1 Message Date
Donald Pinckney 812f32ee58 Add integrations catalog + per-language integrations/ layout (#151)
* Add integrations catalog and per-language integrations/ layout

Adds references/integrations.md as a single catalog table for third-party
plugins and integrations (one row per integration: language, what it does,
link to a reference file). Reference files live under
references/{language}/integrations/.

Pre-seeds the catalog by moving the existing Spring Boot reference into
the new layout (references/java/integrations/spring-boot.md) and updating
its inbound links.

SKILL.md gains a single 3-line "Third-Party Integrations" section pointing
at the catalog so SKILL.md no longer accrues a line per new integration.
Each language entry-point (java.md, python.md) gets a one-line pointer to
the catalog filtered to its language.

This lets open integration PRs (Spring AI, Google ADK, OpenAI Agents
sandbox) be rebased onto a consistent home: move their reference file
into references/{language}/integrations/ and add one row to
references/integrations.md.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Drop HTML contribution comment from integrations.md

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-13 13:46:18 -04:00
Donald Pinckney 6495e5927f Cleanup and correct language of workflow initializers (#101) 2026-04-30 16:44:30 -04:00
Donald Pinckney 0e7a3125f8 Small tweak to worker setup wording (#100) 2026-04-30 16:06:59 -04:00
Donald Pinckney d68413af30 Minor fixes to versioning.md (#64)
* Edits to python versioning fixes

* add missing workflow imports
2026-04-17 15:03:44 -04:00
Donald Pinckney 44eba4e91c Add .NET SDK support to temporal-developer skill (#39)
* Add .NET reference files for temporal-developer skill

Created 11 .NET reference files covering: dotnet.md (overview/quick start),
patterns.md, determinism.md, determinism-protection.md, error-handling.md,
testing.md, versioning.md, observability.md, data-handling.md, gotchas.md,
and advanced-features.md. Follows Python/TypeScript patterns with .NET-specific
content for Task determinism, CancellationToken, dependency injection, etc.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Fix .NET alignment issues from self-review

- dotnet.md: Reduce Determinism Rules section to brief cross-reference
  (was duplicating determinism.md content)
- patterns.md: Add ParentClosePolicy to Child Workflows example
- gotchas.md: Add missing "Heartbeat Timeout Too Short" subsection
- versioning.md: Add missing Key Concepts, Deployment Strategies,
  Query Filters, PINNED/AUTO_UPGRADE guidance, CLI examples
- advanced-features.md: Add worker-level heading for exception types

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Fix .NET correctness issues from verification pass

- patterns.md: Fix cancellation pattern to use official
  TemporalException.IsCanceledException(e) with detached CancellationTokenSource
- advanced-features.md: Fix DI hosting example to use official
  AddHostedTemporalWorker(clientTargetHost:, clientNamespace:, taskQueue:) pattern

Verified against official SDK README, API docs, and temporal-docs.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Update supported language references to include .NET

- SKILL.md: Add "Temporal .NET" and "Temporal C#" trigger phrases,
  update overview to mention .NET, add .NET entry in getting started
- core/determinism.md: Add .NET entry in SDK Protection Mechanisms

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Edits to advanced features

* edits to determinism protection, and move the .editorconfig section

* missed one

* edit determinism.md

* edit error-handling.md

* edit gotchas.md

* edit patterns.md

* edit versioning.md

* edit observability.md

* fix metrics

* self-review round 1

* minor correctness fixed

* Update references/dotnet/patterns.md

Co-authored-by: Justin Anderson <44687433+jmaeagle99@users.noreply.github.com>

* address comments, clarify reference to earlier code snippet

* clarify that operations are forbidden IN WORKFLOWS

* cleanup workflow cancellation handling example

* add task token retrieval comment

* update .net requirements

* Fix propagation of workflow cancellation

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-authored-by: Justin Anderson <44687433+jmaeagle99@users.noreply.github.com>
2026-04-17 14:28:02 -04:00
Donald Pinckney 33747f0438 Auto-formatting: ran mdformat --extensions frontmatter --number . (#81)
* Auto-formatting: ran `mdformat --extensions frontmatter --number .`

* manual tweaks

* manual tweaks
2026-04-17 10:11:47 -04:00
Brian Strauch 57c08ef74b Add @workflow.init decorator to python.md Key Concepts (#57)
* docs: add @workflow.init decorator to python.md Key Concepts

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Apply suggestion from @brianstrauch

* Update references/python/python.md

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-31 14:16:11 -07:00
Trevor J. Yao b040ae10b4 Fix Python reference bugs: incorrect API name, syntax error, broken cross-ref, misleading comment (#55) 2026-03-31 14:58:57 -04:00
Donald Pinckney e16c9b808a Add Go (supersedes other PR) (#38)
* progress on go

* Go translation workflow completed.

* missed a few spots

* Manual edits

* Address feedback

* Add gotcha about anonymous local activities

* Sample code for payload converter

* clarify sdk protection mechanisms
2026-03-18 21:18:45 -04:00
Donald Pinckney c013b87f87 Fix saga compensations to run under cancellation protection (#43)
When a workflow is cancelled mid-saga, compensations must run in a
cancellation-protected scope, otherwise they are immediately cancelled
before they can execute.

- Python: wrap compensation loop in asyncio.shield() so it runs even
  when the workflow receives a CancelledError
- TypeScript: wrap compensation loop in CancellationScope.nonCancellable()
  so it runs even when the root scope is cancelled (per official docs:
  "Cleanup logic must be in a nonCancellable scope")
- TypeScript: also fix compensation registration order — register BEFORE
  calling the activity (was already correct in Python)

Co-authored-by: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
2026-03-17 18:41:25 -04:00
Donald Pinckney 766f8883fe Add TypeScript (#31)
Adds initial support for TypeScript to the skill

---------

Co-authored-by: James Watkins-Harvey <mjameswh@users.noreply.github.com>
Co-authored-by: Chris Olszewski <chrisdolszewski@gmail.com>
2026-03-07 09:41:32 -05:00
Donald Pinckney 87fe92e083 Remove multi-patching from Python, since its obvious, dont waste tokens on it. (#34) 2026-03-03 00:29:19 -05:00
Donald Pinckney 99a2d4a1eb Automated pass over on python cleanup & deduplication 2026-03-03 00:28:59 -05:00
Donald Pinckney 0692311a5a De-couple core from python and TypeScript as much as possible 2026-02-23 15:05:51 -05:00
Donald Pinckney 14da16ad9f clean up ai-patterns.md 2026-02-23 13:46:43 -05:00
Donald Pinckney ec02f3822e Improve patterns.md 2026-02-23 13:46:43 -05:00
Donald Pinckney 663bbe47eb cleanup to top level of skill (like CLI install instructions), and to top-level of python 2026-02-23 13:46:43 -05:00
Donald Pinckney 79ecaf3f97 Lots of improvements to testing 2026-02-23 13:46:43 -05:00
Donald Pinckney cbfd857fbd de-duplicate content 2026-02-23 13:46:43 -05:00
Donald Pinckney f01763a45a cut a lot of duplicate stuff from python gotchas, address comments 2026-02-23 13:46:43 -05:00
Donald Pinckney ad4cc34bfa Cut otel for now 2026-02-19 12:12:06 -05:00
Donald Pinckney d61866b6d4 Cleanup observability.md, remove duplicated search attributes 2026-02-19 12:12:06 -05:00
Donald Pinckney 35c3bc55c1 Clean up references/python/sync-vs-async.md 2026-02-19 12:12:06 -05:00
Donald Pinckney 56dde7576b local activities aren't experimental 2026-02-19 12:12:06 -05:00
Donald Pinckney 0bc69b2e0a Unify sandbox stuff into one file 2026-02-19 12:12:06 -05:00
Donald Pinckney f36faca41f small edits 2026-02-19 12:12:06 -05:00
Donald Pinckney f0387e3743 remove multi-param activities 2026-02-19 12:12:06 -05:00
Donald Pinckney 3d43cd27f1 move idempotency patterns to patterns.md 2026-02-19 12:12:06 -05:00
Donald Pinckney f693cc742c error-handling.md cleanup 2026-02-19 12:12:06 -05:00
Donald Pinckney 8b7dffa088 don't explicitely provide defaults for retry policies 2026-02-19 12:12:06 -05:00
Donald Pinckney 3dcccb82eb Prefer start_to_close_timeout 2026-02-19 12:12:06 -05:00
Donald Pinckney bb46cb4b90 Improve references/python/data-handling.md 2026-02-19 12:12:06 -05:00
Donald Pinckney 322f85abd2 remove duplicated content from determinism.md, clean up 2026-02-19 12:12:06 -05:00
Donald Pinckney e945f1da5e Use explicit namespace in connect 2026-02-19 12:12:06 -05:00
Donald Pinckney 1c185b6455 Improve references/python/advanced-features.md 2026-02-19 12:12:06 -05:00
Donald Pinckney d4d9921adb clarify on heartbeating of async activity completions, and prompt it a bit in relation to signals 2026-02-19 12:12:06 -05:00
Donald Pinckney e10cbb8fa3 remove dynamic workflows 2026-02-19 12:12:06 -05:00
Donald Pinckney 5695854e77 remove interceptors for now 2026-02-19 12:12:06 -05:00
Donald Pinckney 5998c6406d Use claude to merge Steve's, Max's, and Mason's skills. (#2)
* Use claude to merge Steve's, Max's, and Mason's skills. Did a review pass using claude's skill devlopment skills

* Add missing things from Steve

* trigger tweaks

* Add in common gotchas from Johann
2026-02-04 14:35:08 -05:00