@troylar/flightdeck 2.10.0 → 2.11.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -2,6 +2,50 @@
2
2
 
3
3
  <!-- Generated by build.py from src/releases.json. Edit that file, not this one. -->
4
4
 
5
+ ## 2.11.1 · Oct 31, 2026
6
+
7
+ Odd names in a folder, and notes that share an ID.
8
+
9
+ ### Fixed
10
+
11
+ - **A folder with a run named like constructor opens** (Everywhere). A running run whose ID is a word like constructor or toString reads with the rest of the folder, and saves like any other. *Where:* Opening a team folder
12
+ - **Checklists and people named like constructor are themselves** (Everywhere). A checklist named constructor offers On my own or With others as any other does, and a person with an ID like that is shown by it. A run someone edited by hand to give a step, phase, role or detail such a name opens read-only and says why. *Where:* Starting a run, and names on a run
13
+ - **A note's screenshot or file opens that note's** (Runs). When two notes share an ID, each thumbnail and each file button opens its own note's image or file. *Where:* A step's notes and corrections, Finish, the receipt, and a checklist's Corrections
14
+ - **A correction shows its own status and its own Withdraw** (Runs). When two corrections on a step share an ID, each row shows where it stands, and Withdraw takes back that one. *Where:* A run's step and Finish
15
+ - **Other ID… in a linked step is only Other ID…** (Editor). A draft whose process is __other isn't listed beside Other ID…, which has that value. Type its ID under Other ID… to link it. *Where:* A linked step's Which process
16
+ - **Closing a zoomed image goes back to its own thumbnail** (Runs). Closing a screenshot puts you back on the thumbnail of the note you opened it from, even if the notes moved while it was open, and brings that note back onto the list if a newer read pushed it off. If the note is gone, or can no longer be told from a copy, you land on the list's heading. *Where:* A step's notes and corrections, Finish, the receipt, and a checklist's Corrections
17
+ - **A Jira workflow named __proto__ keeps its required fields** (Runs). An issue type called __proto__ in jira/workflows.json is read like any other, so a run started from it asks for that workflow's required fields. *Where:* Jira steps
18
+ - **Rotation and team runs count every name** (Runs). A person with the ID constructor who has never done the role gets the same place in rotation as anyone else who hasn't, and a run with a second person named __proto__ counts as a team run. *Where:* Starting a run, and a run's mode
19
+ - **Other names from a folder are read as they are** (Everywhere). Details, roles, fields, step types and drafts with a name like constructor no longer pick up something the app didn't write. A draft step or custom step type with such a name is refused and told why. *Where:* Drafts, practice, step types, corrections, reports and publishing
20
+ - **A hand-edited step type can't lose what you enter** (Runs). A version whose step type was edited by hand to name evidence, a field or a condition with a word like __proto__ or constructor says it can't be run here, and so does the assistants' folder checker. Practice says the same of a draft's role or run detail with such a name. *Where:* Publishing, runs on such a version, and Practice
21
+ - **Opening another folder closes what was open** (Everywhere). If a screenshot or another dialog is still open when a folder you picked finishes opening, it closes and you land on the new folder's heading. A dialog with something typed in it stays open instead, the folder doesn't open, and you're asked to finish or cancel first. *Where:* Switching team folders
22
+
23
+ ## 2.11.0 · Oct 28, 2026
24
+
25
+ Find things in big folders.
26
+
27
+ ### New
28
+
29
+ - **Find boxes for checklists, skills, follow-ups and people** (Everywhere). Checklists, All skills, Runs › Follow-ups and Settings › People each have a Find box. Every word you type must appear, and the count says how many match. Escape or Clear empties it, and what you typed stays across screens until you switch folders. Join's Who are you? has Find your name, and Start, Plan and Who should do it have Find a role. *Where:* Checklists, Skills, Runs › Follow-ups, Settings › People, Join, and starting or planning a run
30
+ - **Long dropdowns have a Find box** (Everywhere). A dropdown over something that grows with your folder lists 50 choices. Past 50, a Find box narrows over all of them, and Show 50 more… or Show more choices widens the list without changing your choice. Choices with the same name say where they are. *Where:* Moved to, Filter runs, the version pickers, Export evidence, the editor's linked checklist, Move it to and the Phase select
31
+
32
+ ### Improved
33
+
34
+ - **Long lists show a page at a time** (Everywhere). Lists that grow with your folder show 50 at a time, with Show more. Home's lists show 10, and a run step's corrections, answers and reports 20. Counts are of the whole list. Show more moves focus to the first new row and scrolls it into view. Publishing still uses every check, and Copy for Jira still copies the whole receipt. *Where:* Checklists, Skills, Runs, Home, a checklist's page, a run, How runs go, Folder health and Settings
35
+ - **What you're working on stays on screen** (Everywhere). A row with an open form, such as a follow-up's Won't do or a correction being declined, stays drawn through Show more, Find, Open, Yours and All, and a newer read. If someone decided it elsewhere, it says so. If it was removed, what you typed stays, with Copy my text. A plan you just saved shows in Just planned above the filters. *Where:* Runs › Follow-ups and Planned, a checklist's Corrections, a run's reports
36
+ - **Search results and Back open rows past the page** (Everywhere). A note, correction or report you open from search, View correction, View change or a Reports panel link is drawn wherever it sits in its list, focused and in view. On a phone the inspector opens on it. Back from the runs behind a number in How runs go shows that row again, with focus on its count. *Where:* Search, a checklist's Corrections, a run's notes, corrections and reports, and How runs go
37
+ - **A step's notes show the newest 20** (Runs). A step shows its newest 20 notes, with Show 20 earlier above them. The box for a new note keeps what you typed. A note opened from search, or one you just saved, is shown under From earlier even when it sorts outside the newest 20. Notes that share an ID each open as their own. *Where:* A run, a step's notes
38
+ - **Long notices are folded** (Everywhere). Each is one notice, with the list in a fold 50 at a time (incomplete publications 20). A report whose copies differ, drafts that share a checklist, older v0.1 runs and linked steps that can't start each say so in one line, with the names in a fold. *Where:* A run, Checklists, a checklist's page and Runs
39
+ - **Names sort the way you'd expect** (Everywhere). Checklist 2 comes before Checklist 10, ignoring capitals. Every person picker and Settings › People list people by name. people.json keeps its own order. *Where:* Checklists, Skills, team values, person pickers and Settings › People
40
+
41
+ ### Fixed
42
+
43
+ - **Show more in How runs go moves focus to the new rows** (Runs). Show more in the duration table and Steps that go off-script focuses the first row it adds, and choosing another version starts both lists from their first page. *Where:* Runs › How runs go, the duration table and Steps that go off-script
44
+ - **A correction you save is shown** (Runs). The correction you just saved, a Done differently one included, is drawn, focused and scrolled into view. *Where:* A run, Correct this step
45
+ - **Moved to keeps your choice** (Runs). A chosen run that ends or is removed, or a chosen plan that starts, stays the choice, marked, and Save writes the same reference as before. *Where:* Runs › Follow-ups, Moved to another run
46
+ - **A chosen tag stays when no checklist has it anymore** (Checklists). A chosen tag that a newer read removes from every checklist stays, chosen, with Clear. *Where:* Checklists, Filter by tag
47
+ - **Focus stays put when an ID has a # or /** (Everywhere). A redraw keeps focus on a row or box whose ID has a # or /. *Where:* Everywhere
48
+
5
49
  ## 2.10.0 · Oct 27, 2026
6
50
 
7
51
  First-time clarity.
package/README.md CHANGED
@@ -66,9 +66,9 @@ Run it after setup, not before: setup wants an empty folder. Teammates then open
66
66
 
67
67
  **Finding your way around.** The top bar has **Home**, **Runs**, **Checklists** and **Settings**. **Skills** and **Step types** open from the Checklists page, from Settings and from search (Ctrl+K, or Cmd+K on a Mac), which finds runs, steps, notes, corrections, follow-ups, step types and skills, and keeps its index in memory on your computer.
68
68
 
69
- **Home** shows only what's yours, each with one button: the run you're recording, a plan to review, a skill to update, and your open follow-ups. **Checklists** lists every checklist in your team's own groups, with **Filter by tag** and each one's version and last run. **New checklist** starts one.
69
+ **Home** shows only what's yours, each with one button: the run you're recording, a plan to review, a skill to update, and your open follow-ups, 10 at a time with **Show 10 more**. **Checklists** lists every checklist in your team's own groups, with **Find a checklist** (by title, ID, group or tag), **Filter by tag** and each one's version and last run. A big folder shows 50 at a time, with **Show 50 more**. **New checklist** starts one.
70
70
 
71
- <p align="center"><a href="https://github.com/troylar/flightdeck/blob/main/docs/images/home-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/home-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/home-light.png" alt="Home for Casey: the things that need Casey, each with one button, then Your follow-ups with Done, Moved to a ticket, Moved to another run and Won't do" width="49%"></picture></a> <a href="https://github.com/troylar/flightdeck/blob/main/docs/images/processes-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/processes-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/processes-light.png" alt="Checklists: the team's checklists grouped by hierarchy, each with its version, when it last ran and its skills, with Filter by tag, and Skills, Step types and New checklist at the top" width="49%"></picture></a></p>
71
+ <p align="center"><a href="https://github.com/troylar/flightdeck/blob/main/docs/images/home-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/home-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/home-light.png" alt="Home for Casey: the things that need Casey, each with one button, then Your follow-ups with Done, Moved to a ticket, Moved to another run and Won't do" width="49%"></picture></a> <a href="https://github.com/troylar/flightdeck/blob/main/docs/images/processes-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/processes-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/processes-light.png" alt="Checklists: Find a checklist and Filter by tag, then the team's checklists grouped by hierarchy, each with its version, when it last ran and its skills, and Skills, Step types and New checklist at the top" width="49%"></picture></a></p>
72
72
 
73
73
  ## How it works
74
74
 
@@ -148,7 +148,7 @@ A checklist's page shows its steps (as **Checklist**, **Flight plan** or **Markd
148
148
 
149
149
  ### 4. Run it
150
150
 
151
- **Start a run** and type the run's details. Or **Plan a run** for later, with the details you know, who does what and an optional time; nothing starts until a person starts it, and a plan starts on the version it was planned on until you switch it. **Plan another like this** on any run copies its details and roles, never its answers.
151
+ **Start a run** and type the run's details. Or **Plan a run** for later, with the details you know, who does what and an optional time; nothing starts until a person starts it, and a plan starts on the version it was planned on until you switch it. A plan you just saved shows in **Just planned** at the top of Runs, whatever filter is on. A checklist with many roles lists 20 at a time, with **Find a role**. **Plan another like this** on any run copies its details and roles, never its answers.
152
152
 
153
153
  <p align="center"><a href="https://github.com/troylar/flightdeck/blob/main/docs/images/runs-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/runs-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/runs-light.png" alt="Runs: one release running, two planned releases (one by Casey Nguyen with a time, one requested by an AI assistant), the newest finished runs, and a More menu with Export evidence…" width="49%"></picture></a> <a href="https://github.com/troylar/flightdeck/blob/main/docs/images/plan-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/plan-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/plan-light.png" alt="Plan a run: run name, ticket, commit and environment filled in, a time and a note, and a person for each role with the rotation's suggestion" width="49%"></picture></a></p>
154
154
 
@@ -160,7 +160,7 @@ The run screen fills the window:
160
160
  | **Recording strip** | Who's recording, with **Pause** and **Hand off** (which names the exact revision passed on), the run's details, and what this window saved and when it last checked the folder. Another window sees **Pick up recording** (when it was handed to you), **Record here** (when you're recording elsewhere) or **Take over recording** (for emergencies, when the recorder's computer is gone). |
161
161
  | **Phases** | Each phase and its gate's state by name ("Confirm deploy · Passed"), the day timeline and follow-ups. |
162
162
  | **Checklist** | Every step, with **Next up** pinned at the top. Step text shows the run's details: `Start the production deploy job v2026.10.16`, or `‹tag›` until the tag is set. A phase behind its gate offers **Preview steps**; a finished one folds to a tally with **Show steps**. Steps this run doesn't need fold into one line at the end of their phase ("1 step not needed"), each with its reason. |
163
- | **Selected step** | What to do (only when there's something to say), the values to copy, the evidence to record (**Fill in** only when there's something to fill in), then **Done**, **Done differently**, **Blocked** and **N/A**, and its corrections and notes. |
163
+ | **Selected step** | What to do (only when there's something to say), the values to copy, the evidence to record (**Fill in** only when there's something to fill in), then **Done**, **Done differently**, **Blocked** and **N/A**, and its corrections and notes (the newest 20, with **Show 20 earlier**; a note you open from search is shown wherever it sorts). |
164
164
 
165
165
  Check the step Next up points at and the next one is selected, ready for **Space**. Typed evidence and unsent notes stay with their step while you move around. Notes and corrections take files (drop, paste or **Attach**): images, PDF, text and logs, CSV, JSON, YAML and .zip, up to 10 MB each. On a phone the checklist scrolls and a step opens as a full-screen sheet.
166
166
 
@@ -172,9 +172,9 @@ When the checklist is wrong mid-run, anyone can **Correct this step** (or press
172
172
 
173
173
  <p align="center"><a href="https://github.com/troylar/flightdeck/blob/main/docs/images/correction-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/correction-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/correction-light.png" alt="Correct this step during a run: what the checklist says, the suggested wording, a Before/After redline, why, Attach for files, and Save correction" width="49%"></picture></a> <a href="https://github.com/troylar/flightdeck/blob/main/docs/images/corrections-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/corrections-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/corrections-light.png" alt="Corrections on the checklist's page: a wording change suggested in two runs, with the runs listed, and a missing step, each with Review and apply, Mark as applied and Decline, then Copy correction brief" width="49%"></picture></a></p>
174
174
 
175
- Corrections wait on the checklist's page, grouped by step ("Suggested in 2 runs"). **Review and apply** shows what the run's version said, the draft now and the result side by side, and applies it to the draft as one change you can undo; you can also **Mark as applied**, **Decline** with a reason, or copy a correction brief for your AI assistant. The version that includes it records that, its runs show **Changed in v5** with **Why is this here?**, and Home tells whoever suggested it.
175
+ Corrections wait on the checklist's page, grouped by step ("Suggested in 2 runs"), 50 suggestions at a time with **Show 50 more**; one a search or Home's **View change** opens is shown whatever the page. **Review and apply** shows what the run's version said, the draft now and the result side by side, and applies it to the draft as one change you can undo; you can also **Mark as applied**, **Decline** with a reason, or copy a correction brief for your AI assistant. The version that includes it records that, its runs show **Changed in v5** with **Why is this here?**, and Home tells whoever suggested it.
176
176
 
177
- **How runs go** shows typical time per phase, the steps that go off-script most, and who has held each role. **Flight plan** draws a version's shape: phases as waypoints, gates as checkpoints, tracks side by side, and, from its runs, typical times, autopilot (steps skills cover) and turbulence (steps that go off-script most).
177
+ **How runs go** shows typical time per phase, the steps that go off-script most, and who has held each role. A big checklist shows 50 phases, 50 people and 20 roles at a time (**Show 20 more roles**), and **Compare versions** 20 versions at a time. **Flight plan** draws a version's shape: phases as waypoints, gates as checkpoints, tracks side by side, and, from its runs, typical times, autopilot (steps skills cover) and turbulence (steps that go off-script most).
178
178
 
179
179
  <p align="center"><a href="https://github.com/troylar/flightdeck/blob/main/docs/images/flight-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/flight-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/flight-light.png" alt="The release v1 as a flight plan: Start with autopilot, phases with typical times, turbulence notes and a connecting flight to Check in code, and gates as striped checkpoints" width="1000"></picture></a></p>
180
180
 
@@ -285,7 +285,7 @@ flightdeck skill register ~/OneDrive/Team --from registration.json --json
285
285
 
286
286
  <p align="center"><a href="https://github.com/troylar/flightdeck/blob/main/docs/images/skills-traced-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/skills-traced-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/skills-traced-light.png" alt="A process goes from v1 to v2 and one step changes. Flightdeck checks the registered skills: release-deploy and release-notes need an update, pr-opener is current. The update brief for release-deploy shows the exact before and after for your AI assistant." width="1000"></picture></a></p>
287
287
 
288
- **Skills** lists every skill built from your processes, wherever it lives, and which need an update. **A skill** says what changed under it and gives your AI assistant the exact before and after.
288
+ **Skills** lists every skill built from your processes, wherever it lives, and which need an update, with **Find a skill** (by name, checklist or tag). **A skill** says what changed under it and gives your AI assistant the exact before and after.
289
289
 
290
290
  <p align="center"><a href="https://github.com/troylar/flightdeck/blob/main/docs/images/skills-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/skills-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/skills-light.png" alt="Skills: two skills that need an update, then every skill in the team hierarchy with a tag filter" width="49%"></picture></a> <a href="https://github.com/troylar/flightdeck/blob/main/docs/images/skill-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/skill-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/skill-light.png" alt="The release-deploy skill: needs update because one of its steps changed in v2, with Copy the update brief, where the skill lives and which steps it covers" width="49%"></picture></a></p>
291
291
 
@@ -337,7 +337,7 @@ AGENTS.md the rules any AI assistant follows in this folder (your o
337
337
 
338
338
  ### How big a folder can get
339
339
 
340
- Thousands of runs open and refresh without stalling. **Settings → Folder health** watches these sizes. None of them locks anything; each says what to do, and [The folder is getting big](https://github.com/troylar/flightdeck/blob/main/docs/recovery.md#the-folder-is-getting-big) has the steps.
340
+ Thousands of runs open and refresh without stalling. Long lists show a page at a time with **Show more**, and the ones you look things up in have a **Find** box: Checklists, Skills, Follow-ups and **Settings → People** (in name order). **Settings → Folder health** watches these sizes, 50 problems a section at a time. None of them locks anything; each says what to do, and [The folder is getting big](https://github.com/troylar/flightdeck/blob/main/docs/recovery.md#the-folder-is-getting-big) has the steps.
341
341
 
342
342
  | Size | What happens |
343
343
  |---|---|