[JacobStephens2]

Summary

0.4.0's headline is Spec runs: thirdshift <Issue URL> on an issue with sub-issues now works through its Tickets, merging each into a Spec branch, and ends with a Spec PR that gets a Spec review, the Repair loop and, when asked, a Self-merge. It also adds a User config (~/.thirdshift/config.toml), written by the new thirdshift setup, and Run notifications by email through Resend.

New commands

• thirdshift setup writes the User config with every setting at its default (Add thirdshift setup: write the defaults User config with no terminal #135). It suggests your GitHub or git email for email.to (Setup: suggest the GitHub email for email.to #137), completes an existing config in place (Setup: edit an existing User config in place #138), and asks the Setup questions from a terminal (Setup: the questions from a terminal #151). The first Run from a terminal with no User config offers Setup (Offer Setup on the first Run from a terminal #162), and the installer's last line points to it (Setup: install output points to thirdshift setup #134).
• thirdshift email-test [<address>] sends one test email through Resend (thirdshift email-test through Resend #119).

New and changed behaviour

• Spec runs: Tickets run in dependency order, as child Merge runs into the Spec branch (Tracer bullet: a linear Spec run to a ready Spec PR #152). Several ready Tickets run at once, set by parallel <n> or spec.parallel, default 3 (Parallel Tickets: spec.parallel and parallel <n> #163). A Spec run takes every Ticket it can reach and ends as a Failed spec run with a per-Ticket summary when any isn't done (Going as far as it can: Failed spec runs #155). The draft Spec PR opens once the first Ticket lands and carries a Tickets checklist (The draft Spec PR and its Tickets checklist #169). A Spec review runs before the Spec PR is marked ready (Spec review before the Spec PR is ready #164), then the Repair loop and, with merge, a Self-merge (The Spec PR's Repair loop and Self-merge #171). An interrupt is passed on to the running Ticket's Run (Interrupting a Spec run #154). A Spec run sends one Run notification with a line per Ticket (One Run notification per Spec run #170).
• User config settings and flags: merge.always and --no-merge (User config, with merge.always and --no-merge #116), logs.dir (Read logs.dir from the User config to set where session logs go #117), launch.pull fast-forwards the Launch directory's Base branch (Fast-forward the Launch directory's Base branch with launch.pull #125).
• Run notifications: --email [<address>] sends one when a Run ends, whatever the outcome (--email sends a Run notification whenever a Run ends #121). email.always and --no-email set and override the default (email.always and --no-email #124).
• Every stderr line starts with the local time (Stamp each stderr line with the local time #185).
• A CI-fix Repair that leaves the head unchanged now ends the Run as a Failed run (Declined CI fix) instead of spending all 5 Repairs (End the Repair loop when a CI-fix Repair leaves the head unchanged #104).
• A conflict Repair is checked against the commit it merged, not a Base branch that moved during it (Check a conflict Repair against the commit it merged, not the moved ref #175). Foreign commits pushed during a Repair are taken in before pushing (Take in Foreign commits that land during a Repair before pushing #182).
• After a Self-merge, thirdshift closes the issue unless it is already closed. It no longer asks gh for closingIssuesReferences, which gh 2.45 lacks (Close the issue after a Self-merge unless it is already closed #186).
• Session prompts say to wait on a backgrounded command by its own task, never by process names (Tell sessions to wait on a backgrounded command by its own task #183).

Also: release tooling (#165, #166, #167, #168, #172, #173) and docs, glossary and prompts work (#101, #110, #123, #133, #140, #179, #184).

Version diff

diff --git a/Cargo.lock b/Cargo.lock
index 574c8ac..3fedaf2 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -1469,3 +1469,3 @@ dependencies = [
 name = "thirdshift"
-version = "0.3.0"
+version = "0.4.0"
 dependencies = [
diff --git a/Cargo.toml b/Cargo.toml
index c80fac0..6beebce 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -2,3 +2,3 @@
 name = "thirdshift"
-version = "0.3.0"
+version = "0.4.0"
 edition = "2024"