feat(taskflow): expose step ID and version on task views; document steps (8/8)

[lokewate]

Summary

Top of the stack: exposes step ID/version on task views, documents the new Step/Seq/guarded-write model end to end, and adds a real-Temporal e2e test. Merging through here is what actually ships the fix.

Type of Change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update
• Refactoring (no functional changes)
• Performance improvement
• Other (please describe):

Changes Made

• TaskView/ZoneView gain read-only StepID and Version (= Seq) fields for callers that want to display or poll on the current step.
• New real-Temporal end-to-end test driving a task through two full steps.
• Rewrite of taskflow/docs/architecture.md, integration-guide.md, frontend-guide.md, taskflow/README.md, root README.md, plugin-author-guide.md, template-reference.md for the Step/Seq/guarded-write model, including a note on why the engine calls this identity ActivationID while TaskManager calls it a Step (see refactor(workflow,taskflow)!: rename TaskDone to CompleteStep, TaskType to PluginType, and SubTask* to Step* (1/8) #237). workflow/README.md is untouched — it never described this mechanism.
• Shortens the ErrStaleStep comment for clarity.

Testing

• I have tested this change locally
• I have added tests that prove my fix is effective or that my feature works
• I have tested edge cases
• All existing tests pass

Full go test -race ./... across the whole chain; e2e test gated behind TEMPORAL_TEST_ADDRESS like PR5's.

Checklist

• My code follows the project's style guidelines
• I have performed a self-review of my code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• I have checked that there are no merge conflicts

Related Issues

N/A

Screenshots/Demo

N/A

Additional Notes

Step 8 of 8 (final) in the taskflow-guarded-writes stack — see #237 for why this stack exists. Base: feat/taskflow-guarded-writes-6-completion.

🤖 Generated with Claude Code

[coderabbitai]

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

• Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[ginaxu1]

Seems fine