Start live widget development before the first edit

[SunkenInTime]

Summary

• Start weaver dev before the first widget source edit.
• Keep the live development session running as continuous authoring feedback.
• Clarify fallback behavior when the desktop host is unavailable.
• Use the running widget for live inspection and stop it when authoring is complete.

Testing

• Not run (documentation-only change).

---

^{Need help on this PR? Tag @codesmith-bot with what you need. Autofix is disabled.}

[greptile-apps]

Greptile Summary

This update changes the Conjure widget-authoring instructions so authors launch the live desktop loop before editing, wait for presentation health before calling it available, and wait for the final reload before stopping it.

The checked behavior prevents three misleading states: a window with no rendered frame is reported as unavailable, a queued final save is drained before shutdown, and a failed rebuild remains visibly out of date until the widget catches up.

T-Rex validation blocked

Service: the native Weaver desktop host is unavailable on Linux. weaver dev and the native runtime build explicitly reject Linux because desktop widgets support Windows and macOS only, so real desktop presentation and native hot-reload could not be exercised in this environment. Configure VMs

Confidence Score: 4/5

The documented live-authoring workflow is safe to merge based on the verified presentation gate, shutdown drain, and stale-build reporting behavior.

Targeted execution covered the rebuild shutdown race, stale-build completion rules, source checks, CLI tests, and TypeScript validation. A native desktop session could not run because this environment lacks a supported desktop-host platform.

Files Needing Attention: No change requires correction. skills/conjure-widget/SKILL.md should receive an end-to-end desktop check on Windows or macOS when such an environment is available.

T-Rex Logs

What T-Rex did

• Attempted the real development command and confirmed Linux refuses desktop-host support; ran the portable host-status test showing a widget without a renderer backend results in a no-frame presentation error; and executed the CLI test suite successfully.
• Reproduced the queued-save shutdown race and verified that the old bundle remains active until queued work is drained; draining applies the final bundle, and the targeted shutdown/rebuild tests and TypeScript checks pass.
• Ran direct assertions for failed rebuild reporting and the wait-for-catch-up instruction, ran a reference widget check, rebuild-loop tests, and TypeScript validation, and confirmed Linux cannot start the supported native desktop host or runtime needed for a live-session check.
• Reviewed the code paths for shutdown, drain, and rebuild, including how successful rebuilds bundle first and signal a manifest restart or await in-place reload, plus Live loop guidance that keeps the loop open until final save reports a successful hot swap; noted Linux host lifecycle rejection and runtime build panics for non-Windows/macOS targets.
• Collected logs and a stack trace as artifacts to support validation and thorough inspection of the runtime behavior.

_{Ran code and verified through T-Rex}

_{Reviews (4): Last reviewed commit: "Merge remote-tracking branch 'origin/mas..." | Re-trigger Greptile}

[SunkenInTime]

Addressed the final-edit gap in 7022aa3. After the final save, the Live loop now stays open until the exact hot-swap or window-restart message arrives. OUT OF DATE keeps the step open until weaver dev reports that it caught up. PR #70 also merged the shutdown drain. @greptileai

[SunkenInTime]

Addressed the presentation-readiness finding in ed120fa. Authoring still resumes at watcher readiness so the user can watch the widget take shape. The skill now observes the following presentation-health interval and reports the live view as available only when no weaver dev ERROR appears. @greptileai

[SunkenInTime]

Merged current master into 278e9a3 after PRs #70 and #71 landed. This head now includes Chokidar-backed rebuild draining and authoritative dev-session cleanup, plus the final-save and presentation-health completion criteria in the skill. Please review this exact combined head. @greptileai