Skip to content

Describe pruned-run history exports from Workflow 2.17.0 - #424

Merged
rmcdaniel merged 2 commits into
mainfrom
docs/856-pruned-history-export
Nov 3, 2026
Merged

rmcdaniel merged 2 commits into
mainfrom
docs/856-pruned-history-export

Conversation

@rmcdaniel

Copy link
Copy Markdown
Member

English update to the pruning guide for durable-workflow/workflow#856. General is adding the seven locales.

Change (docs/configuration/pruning-workflows.md)

  • Warning: it no longer says the published export labels a pruned run complete. It keeps the irreversibility and pre-prune inventory guidance.
  • New section, "Recognizing an export of a pruned run":
    • A table of details_state, details_pruned_at, history_complete, history_events and dedupe_key for retained and pruned runs.
    • The replay-verify rule history.details_pruned (also with --skip-replay) and the import rule workflow.terminal_history_incomplete.
    • Archive guidance: treat a pruned bundle as a failed export and keep the earlier full copy.
    • The cases that can still label a pruned run complete: earlier releases (reject details_pruned_at before exporting), native Server (server#976), Waterline's fallback (waterline#257) and the Python verifier (sdk-python#228).
  • Step 4 (verify the stored copy): require history_complete: true and, where present, details_state: retained.

Basis

Workflow 2.17.0 (tag ca90f755 → 0897a58f). Published installed acceptance on Laravel 10.50.4 and 12 covers export, verify and import of pruned completed and failed runs: workflow#856 comment 6591788534.

Checks

scripts/check-doc-translations.js fails until the seven locales are reviewed for this page, as expected. No other content changed.

🤖 Generated with Claude Code

Workflow 2.17.0 marks a retention-pruned run's export incomplete with
details_state, details_pruned_at and a :details-pruned: dedupe suffix, and
verify/import reject it. The guide now shows how to recognize that bundle and
names where the earlier behavior remains (native Server, Waterline fallback,
Python verifier) (workflow#856).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Mirror the 2.17.0 pruned-run export changes in de, es, fr, ja, pt-BR,
uk and zh-Hans, and record the reviewed source hash for each locale.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@sonarqubecloud

sonarqubecloud Bot commented Nov 3, 2026

Copy link
Copy Markdown

@rmcdaniel
rmcdaniel marked this pull request as ready for review November 3, 2026 00:24
@rmcdaniel
rmcdaniel merged commit 2085be7 into main Nov 3, 2026
11 checks passed
@rmcdaniel
rmcdaniel deleted the docs/856-pruned-history-export branch November 3, 2026 00:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant