docs: observe --json reconciliation + session launch model#35
Merged
Conversation
status --json reports raw task + git facts only. Reconciled alarms require joining task, session, and git facts. Record observe --json so every client renders alarms instead of re-implementing the Session Model v1 and Task State Machine v1 reconcile tables and drifting apart. Marked proposed, not yet shipped. Bash ships it as a one-shot; push/SSE delivery is deferred to the Rust core (ADR-006). Co-Authored-By: Claude Opus 4.8 <[email protected]>
- session-runtime-protocol: task init is a Planner-lite headless step, deferred to v2 (v1 launches the interactive TUI directly); launch mode (interactive | headless/full-auto) is a user-facing start-time toggle mapping to the sidecar field - session-state: the GUI launcher surface (e.g. a VS Code-style bottom pane) is a launcher+monitor, not an embedded terminal — the TUI opens externally; clarify that `wtcraft new` copies only .worktree-task.md and the launcher is the sole writer of .worktree-session.json (never a copied template) Co-Authored-By: Claude Sonnet 4.6 <[email protected]>
Record why observe's one-shot/streaming split sits at the Bash/Rust boundary: one-shot is level-triggered (pull); streaming adds edge-triggered push, which needs a service runtime Bash deliberately lacks. The observe --json output schema is the permanent contract; only delivery is added later, behind capabilities --json, without touching clients. Co-Authored-By: Claude Opus 4.8 <[email protected]>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Records the session-launch protocol decisions reached during the wtflow MVP review. Docs-only, no code.
status --jsonreports raw task+git facts; reconciled alarms (joining task + session + git) are a core-ownedobserve --json, so clients render alarms instead of re-implementing the reconcile tables and drifting. Marked proposed, not yet shipped..worktree-session.json.capabilities --json.🤖 Generated with Claude Code