lightsout ticket-state
Write a ticket's planning status, its tracker workflow status, or both.
lightsout ticket-state
When to reach for it
Run it at a workflow transition — when brainstorming finishes, when a plan is approved, when implementation begins — so the ticket says what preparation it still owes and where implementation stands. The workflow skills call it at each of those moments, so the tracker says the same thing however the work was started.
How to run it
lightsout ticket-state| flag | meaning | left out |
|---|---|---|
| --ref <ticket> | The ticket to write, by its human reference. | required |
| --planning-status <status> | What preparation the ticket still owes: planning-needs-brainstorm, planning-needs-plan, planning-ready-auto-plan, planning-complete or planning-not-needed. | The planning status is left as it is. |
| --tracker-status ready|in-progress | Where implementation stands, named by role so one line works in every repository: ready when shaping is finished and implementation is waiting, in-progress when source changes have begun. Done is not among them — a ticket reaches done only when a merge is positively confirmed, which the ship path writes. | The tracker status is left as it is. |
| --cwd <path> | Repository whose config names the tracker. | The process working directory. |