Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions docs/guide/04-planning-and-reporting.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,9 @@ weighs its points against what the last sprints got done (`10p of ~12p`,
marked over when it is more). Move cards across, rank them, start and
complete sprints. Changes show at once and are written behind.

A future sprint leaves its done issues out, as Jira does; the backlog
never lists them. `d` shows them, and laneway remembers it.

=== "Terminal"

`P` on the board puts the backlog on the left and a sprint on the
Expand All @@ -36,6 +39,7 @@ complete sprints. Changes show at once and are written behind.
| `C` twice | complete the active sprint; unfinished work moves to the next one |
| `y` | copy the sprint as a markdown table |
| `/`, `F` | filter both sides, filter builder |
| `d` | hide or show the future sprint's done issues (`done hidden` in the view line) |
| `e` / `B` | quick edit the card / the marked ones |
| `u` | undo the last move across |

Expand All @@ -60,6 +64,7 @@ complete sprints. Changes show at once and are written behind.
| `C` | complete the active sprint; unfinished work moves on |
| `y` | copy the section as a markdown table |
| `f`, `F`, `A` | filter, filter builder, assignee filter |
| `d` | hide or show the planned sprints' done issues (the **Hide done** chip) |
| `e` / `X` | quick edit the card / the selected ones |

> **Tip:** tell laneway how many points each person takes on:
Expand Down
1 change: 1 addition & 0 deletions docs/reference/browser-keys.md
Original file line number Diff line number Diff line change
Expand Up @@ -152,6 +152,7 @@ Fields have no key walk: click one to edit it.
| `C` | complete it | |
| `E` | name, goal and end in one form | `R`, `E` |
| `f` `F` `A` | filter, builder, assignee | `/` `F` |
| `d` | hide or show a planned sprint's done issues (hidden at first) | |
| `O` | sort | |
| `y` | copy the section as a markdown table | |
| `R` | reload | |
Expand Down
3 changes: 2 additions & 1 deletion docs/reference/terminal-keys.md
Original file line number Diff line number Diff line change
Expand Up @@ -133,6 +133,7 @@ On create, `←` `→` change the type, `enter` on the summary creates,
| `C` twice | complete the active sprint |
| `e` `B` | quick edit, edit the marked |
| `/`, `F` | filter both sides, filter builder |
| `d` | hide or show a future sprint's done issues (hidden at first) |
| `u` | undo the last move across |
| `y` | copy the sprint as a markdown table |

Expand Down Expand Up @@ -274,7 +275,7 @@ A key bound to two actions on one screen is reported. The actions:
| Board | `up down left right top bottom page_up page_down open toggle_panel browser refresh quit help search goto create copy_key copy_url copy_branch move_left move_right rank_up rank_down rank_top rank_bottom move_sprint project board next_view prev_view toggle_mode sort fold unfold_all next_band prev_band compact empty_lanes lane_layout arrange_lanes assignee_filter mine clear_filters filter_builder jql mark mark_all undo bulk quick_edit repeat refine pin palette roadmap plan charts releases timer timesheet inbox standup my_work review closed_sprint time_machine agents merge_requests home site settings panel_wider panel_narrower` |
| Panel | `status priority points summary labels assign description comment reply next_comment prev_comment delete_comment log_work start_work linked_issue back image find issue_actions history development notes ask` |
| Agent terminal | `agent_back` |
| Planning | `plan_start plan_goal plan_rename plan_new plan_complete` |
| Planning | `plan_start plan_goal plan_rename plan_new plan_complete plan_done` |
| Charts | `chart_done chart_compare` |
| Roadmap | `roadmap_grip roadmap_fold end_earlier end_later zoom_in zoom_out today roadmap_issues roadmap_edit` |
| Worklogs | `edit_entry delete_entry move_entry propose_work` |
Expand Down
12 changes: 9 additions & 3 deletions e2e/web/tests/planning-fuzz.spec.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,8 @@ const view = page => page.evaluate(async () => {
}
return out;
});
// The planned sprints: they leave their done issues out, as Jira does (the Hide done chip, on at first).
const plannedNames = page => page.evaluate(() => [...document.querySelectorAll('.pl-head')].filter(h => h.querySelector('.pill.cat-new')).map(h => h.querySelector('.pl-name').textContent));
const doneKeys = page => page.evaluate(() => [...document.querySelectorAll('.lrow[data-key]')].filter(r => r.querySelector('.cat-done')).map(r => r.dataset.key));

// slowJira: writes wait up to 600ms; each list in a /plan answer is the server's from up to LAG
Expand Down Expand Up @@ -86,7 +88,8 @@ async function slowJira(page, LAG) {
still: async () => { await expect.poll(() => loading, { timeout: 20000 }).toBe(0); await sleep(150); },
truth: async () => {
const d = await (await page.request.get(url)).json();
return [...d.Sprints.map(s => ({ name: s.Name, keys: s.Cards.map(c => c.Key) })), { name: 'Backlog', keys: d.Backlog.Cards.map(c => c.Key) }];
const shows = (s, c) => s.State !== 'future' || !c.Done;
return [...d.Sprints.map(s => ({ name: s.Name, keys: s.Cards.filter(c => shows(s, c)).map(c => c.Key) })), { name: 'Backlog', keys: d.Backlog.Cards.map(c => c.Key) }];
},
// settled: no write on the way, and Jira's lists have caught up
// settled: no write on the way for a while (a queued one may not have gone out yet), and Jira's
Expand All @@ -113,6 +116,7 @@ for (const [site, { flavour, lag: LAG, hold: HOLD }] of Object.entries(FLAVOURS)
const where = new Map(); // issue → the section the moves put it in
const adopt = v => { where.clear(); for (const s of v) for (const k of s.keys) where.set(k, s.name); };
adopt(await view(page));
const planned = new Set(await plannedNames(page));
let v = [];
const fail = msg => { throw new Error(`${msg}\nseed ${seed}, steps:\n ${log.join('\n ')}\nview:\n ${v.map(s => s.name + ': ' + s.keys.join(' ')).join('\n ')}\nfailed requests:\n ${jira.errs.join('\n ')}`); };
const check = async () => {
Expand Down Expand Up @@ -156,6 +160,8 @@ for (const [site, { flavour, lag: LAG, hold: HOLD }] of Object.entries(FLAVOURS)
// A done issue moved to the backlog is on no list after, as in Jira: planning asks first and
// takes it out. The bulk dialog doesn't ask, so it leaves those be.
const fits = (ks, to) => to !== 'Backlog' || !ks.some(x => done.has(x));
// A done issue moved into a planned sprint is there, but hidden.
const hides = (x, to) => planned.has(to) && done.has(x);
const moved = async (ks, to) => {
const out = to === 'Backlog' ? ks.filter(x => done.has(x) && where.get(x) !== 'Backlog') : [];
if (out.length) {
Expand All @@ -164,7 +170,7 @@ for (const [site, { flavour, lag: LAG, hold: HOLD }] of Object.entries(FLAVOURS)
await dlg.getByRole('button', { name: 'Move' }).click();
await expect(dlg).toHaveCount(0);
}
for (const x of ks) out.includes(x) ? where.delete(x) : where.set(x, to);
for (const x of ks) out.includes(x) || hides(x, to) ? where.delete(x) : where.set(x, to);
};
const keys = v.flatMap(s => s.keys);
const k = any(keys), from = where.get(k), at = names.indexOf(from);
Expand Down Expand Up @@ -200,7 +206,7 @@ for (const [site, { flavour, lag: LAG, hold: HOLD }] of Object.entries(FLAVOURS)
if (ks.length > 1) await page.getByRole('dialog').getByRole('button', { name: 'Apply' }).click();
await expect(page.getByRole('dialog')).toHaveCount(0);
await page.keyboard.press('Escape'); // the marks
for (const x of ks) where.set(x, to);
for (const x of ks) hides(x, to) ? where.delete(x) : where.set(x, to);
} else {
await page.keyboard.press('m'); await pickSection(to);
await moved(ks, to);
Expand Down
51 changes: 51 additions & 0 deletions e2e/web/tests/planning.spec.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -261,3 +261,54 @@ test.describe('on laneway-server', () => {
await expect(head(page, 'Sprint 13')).toContainText('4 issues');
});
});

// A planned sprint leaves its done issues out, as Jira does; the Hide done
// chip says so, and d (or a click on it) shows them, remembered over a reload.
test('a planned sprint hides its done issues until d', async ({ page }) => {
let done = '', name = '', n = 0;
await page.route(/\/api\/plan\/\d+/, async route => {
const res = await route.fetch();
const d = await res.json();
const sp = (d.Sprints || []).find(s => s.State === 'future' && (s.Cards || []).length > 1);
if (sp) { sp.Cards[0].Done = true; done = sp.Cards[0].Key; name = sp.Name; n = sp.Cards.length - 1; }
await route.fulfill({ response: res, json: d });
});
await page.reload();
await expect.poll(() => done).not.toBe('');
const chip = page.locator('.pl-chips .fchip', { hasText: 'Hide done' });
await expect(chip).toHaveClass(/\bon\b/);
await expect(head(page, name)).toContainText(`${n} of ${n + 1} issues`);
await expect(row(page, done)).toHaveCount(0);

await page.keyboard.press('d');
await expect(chip).not.toHaveClass(/\bon\b/);
await expect(head(page, name)).toContainText(`${n + 1} issues`);
await expect(row(page, done)).toBeVisible();
await page.reload();
await expect(row(page, done)).toBeVisible();

await chip.click();
await expect(row(page, done)).toHaveCount(0);
});

// A done issue moved into a planned sprint is there but hidden: a toast says so.
test('a done issue moved into a planned sprint says it is hidden', async ({ page }) => {
let done = '', name = '';
await page.route(/\/api\/plan\/\d+/, async route => {
const res = await route.fetch();
const d = await res.json();
const c = (d.Backlog.Cards || []).find(x => x.Key === (done || x.Key));
const sp = (d.Sprints || []).find(s => s.State === 'future');
if (c && sp) { c.Done = true; done = c.Key; name = sp.Name; }
await route.fulfill({ response: res, json: d });
});
await page.reload();
await expect.poll(() => done).not.toBe('');
await select(page, done);
await page.keyboard.press('m');
await pick(page, name, new RegExp(name));
await expect(page.locator('.kb-msg, .toast').first()).toContainText(`${done} is done: hidden in ${name} · d shows it`);
await expect(row(page, done)).toHaveCount(0);
await page.keyboard.press('d');
await expect(row(page, done)).toBeVisible();
});
8 changes: 8 additions & 0 deletions internal/i18n/nl/ui-views.json
Original file line number Diff line number Diff line change
Expand Up @@ -63,6 +63,7 @@
"%s days": "%s dagen",
"%s didn't load: %s retries": "%s is niet geladen: %s probeert opnieuw",
"%s done · until something new happens · %s in All brings it back": "%s klaar · tot er iets nieuws gebeurt · %s in Alles haalt het terug",
"%s done: hidden in %s · %s shows it": "%s gereed: verborgen in %s · %s toont het",
"%s goal set": "doel van %s ingesteld",
"%s has no child issues": "%s heeft geen onderliggende issues",
"%s has no dates": "%s heeft geen datums",
Expand Down Expand Up @@ -147,14 +148,19 @@
"day": "dag",
"done": "klaar",
"done = %s →": "klaar = %s →",
"done hidden": "klaar verborgen",
"done shown": "klaar getoond",
"done ✓": "klaar ✓",
"due %s": "deadline %s",
"empty · %s or space on the other side moves cards here": "leeg · %s of spatie aan de andere kant verplaatst kaarten hierheen",
"end: 2026-10-10, +2w, fri": "einde: 2026-10-10, +2w, vr",
"enter again releases %s": "enter nogmaals brengt %s uit",
"everyone on the board takes part": "iedereen op het bord doet mee",
"filter cleared": "filter gewist",
"future sprints hide their done issues": "geplande sprints verbergen hun gerede issues",
"future sprints show their done issues": "geplande sprints tonen hun gerede issues",
"goal: %s": "doel: %s",
"hide or show a future sprint's done issues": "gerede issues van een geplande sprint verbergen of tonen",
"holding the bar's end · %s/%s move it · %s the other end · esc let go": "balk vast bij het einde · %s/%s verplaatst · %s het andere uiteinde · esc loslaten",
"holding the bar's start · %s/%s move it · %s the other end · esc let go": "balk vast bij het begin · %s/%s verplaatst · %s het andere uiteinde · esc loslaten",
"in progress to %s: 50%% within %s days, 85%% within %s": "in uitvoering tot %s: 50%% binnen %s dagen, 85%% binnen %s",
Expand Down Expand Up @@ -195,13 +201,15 @@
"on %s": "bij %s",
"on %s: %s opens it in the browser": "op %s: %s opent het in de browser",
"one line again": "weer één lijn",
"only done issues · %s shows them": "alleen gerede issues · %s toont ze",
"open a board first": "open eerst een bord",
"opening %s…": "%s openen…",
"p · %d unestimated": "p · %d zonder schatting",
"past %s, not %s": "voorbij %s, niet %s",
"paused": "gepauzeerd",
"planning needs a scrum board with sprints": "planning heeft een scrumbord met sprints nodig",
"points done": "punten klaar",
"ranking needs every card: %s shows the done ones": "ranken heeft alle kaarten nodig: %s toont de gerede",
"ranking needs every card: esc clears the filter": "ranken heeft alle kaarten nodig: esc wist het filter",
"refined %d issue, nothing changed": "%d issue verfijnd, niets gewijzigd",
"refined %d issues, nothing changed": "%d issues verfijnd, niets gewijzigd",
Expand Down
6 changes: 6 additions & 0 deletions internal/i18n/nl/web-views.json
Original file line number Diff line number Diff line change
Expand Up @@ -323,6 +323,10 @@
"Drop": "Verwijderen",
"Drop a column here for a lane of its own": "Zet hier een kolom neer voor een eigen baan",
"Drop issues here to plan them": "Zet issues hier neer om ze te plannen",
"Leave done issues out of planned sprints, as Jira does (d)": "Gerede issues weglaten uit geplande sprints, zoals Jira doet (d)",
"Only done issues: d shows them": "Alleen gerede issues: d toont ze",
"Ranking needs every issue: d shows the done ones": "Ranken heeft alle issues nodig: d toont de gerede",
"hide or show a planned sprint's done issues": "gerede issues van een geplande sprint verbergen of tonen",
"Edge": "Rand",
"Edit": "Bewerken",
"Edit %s": "%s bewerken",
Expand Down Expand Up @@ -1395,6 +1399,8 @@
"edited": "bewerkt",
"%s are done. Jira leaves done issues out of the backlog: they show nowhere in planning after.": "%s zijn gereed. Jira laat gerede issues uit de backlog: ze staan daarna nergens in de planning.",
"%s is done. Jira leaves done issues out of the backlog: it shows nowhere in planning after.": "%s is gereed. Jira laat gerede issues uit de backlog: het staat daarna nergens in de planning.",
"%s are done: hidden in %s · d shows them": "%s zijn gereed: verborgen in %s · d toont ze",
"%s is done: hidden in %s · d shows it": "%s is gereed: verborgen in %s · d toont het",
"Move to the backlog?": "Naar de backlog verplaatsen?",
"No starred filters.": "Geen filters met een ster.",
"No versions due in the next %s days.": "Geen versies die de komende %s dagen af moeten zijn.",
Expand Down
7 changes: 7 additions & 0 deletions internal/ui/header.go
Original file line number Diff line number Diff line change
Expand Up @@ -427,6 +427,13 @@ func (m *Model) planSegs() []headSeg {
case p.filter != "":
segs = append(segs, plainSeg(dim(i18n.Tf(" /%s (esc clears)", p.filter))))
}
if !p.sprints[p.target].lanes { // a future sprint: its done issues hidden, d shows them
what := i18n.T("done hidden")
if p.showDone {
what = i18n.T("done shown")
}
segs = append(segs, plainSeg(dim(" · ")), keySeg(dim(what+" "+helpKey(k.PlanDone)), k.PlanDone))
}
if p.loading {
segs = append(segs, plainSeg(dim(i18n.T(" · loading…"))))
}
Expand Down
1 change: 1 addition & 0 deletions internal/ui/help.go
Original file line number Diff line number Diff line change
Expand Up @@ -152,6 +152,7 @@ func (m *Model) helpSections() []struct {
row(k.PlanRename, i18n.T("rename the sprint")),
row(k.PlanNew, i18n.T("new sprint")),
row(k.PlanComplete, i18n.T("complete the active sprint (twice)")),
row(k.PlanDone, i18n.T("hide or show a future sprint's done issues")),
row(k.Search, i18n.T("filter both sides (esc clears)")),
row(k.FilterBuilder, i18n.T("filter builder: field, compare, value side by side → filter")),
row(k.QuickEdit, i18n.T("quick edit: status, priority, assignee, points…")),
Expand Down
4 changes: 2 additions & 2 deletions internal/ui/keys.go
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ func (k *keyMap) keyNames() map[string]*key.Binding {
"project": &k.Project, "board": &k.Board, "next_view": &k.NextView, "prev_view": &k.PrevView,
"toggle_mode": &k.ToggleMode, "sort": &k.Sort, "move_sprint": &k.MoveSprint,
"assignee_filter": &k.Assignee, "mine": &k.Mine, "clear_filters": &k.ClearFilters, "roadmap": &k.Roadmap, "palette": &k.Palette, "mark": &k.Mark, "mark_all": &k.MarkAll, "undo": &k.Undo, "bulk": &k.Bulk, "plan": &k.Plan, "charts": &k.Charts, "log_work": &k.LogWork, "description": &k.JiraDescription, "inbox": &k.Inbox, "issue_actions": &k.IssueActions, "site": &k.Site, "standup": &k.Standup, "history": &k.History, "development": &k.DevInfo, "pin": &k.Pin, "fold": &k.Fold, "unfold_all": &k.UnfoldAll, "next_band": &k.NextBand, "prev_band": &k.PrevBand, "jql": &k.JQL, "timer": &k.Timer, "timesheet": &k.Timesheet, "settings": &k.Settings, "filter_builder": &k.FilterBuilder, "panel_wider": &k.PanelWider, "panel_narrower": &k.PanelNarrower, "quick_edit": &k.QuickEdit, "my_work": &k.MyWork, "compact": &k.Compact, "empty_lanes": &k.EmptyLanes, "lane_layout": &k.LaneLayout, "arrange_lanes": &k.ArrangeLanes, "releases": &k.Releases, "repeat": &k.Repeat, "refine": &k.Refine, "notes": &k.Notes, "ask": &k.Ask, "time_machine": &k.TimeMachine, "closed_sprint": &k.ClosedSprint, "agent_back": &k.AgentBack, "agents": &k.Agents, "merge_requests": &k.MergeRequests, "home": &k.StartScreen,
"plan_start": &k.PlanStart, "plan_goal": &k.PlanGoal, "plan_rename": &k.PlanRename, "plan_new": &k.PlanNew, "plan_complete": &k.PlanComplete,
"plan_start": &k.PlanStart, "plan_goal": &k.PlanGoal, "plan_rename": &k.PlanRename, "plan_new": &k.PlanNew, "plan_complete": &k.PlanComplete, "plan_done": &k.PlanDone,
"rank_up": &k.RankUp, "rank_down": &k.RankDown, "rank_top": &k.RankTop, "rank_bottom": &k.RankBottom, "next_comment": &k.NextComment, "prev_comment": &k.PrevComment, "delete_comment": &k.DeleteComment, "standup_pause": &k.StandupPause, "standup_shuffle": &k.StandupShuffle, "standup_park": &k.StandupPark, "inbox_done": &k.InboxDone, "inbox_done_all": &k.InboxDoneAll, "inbox_unread": &k.InboxUnread, "inbox_snooze": &k.InboxSnooze, "agent_prompt": &k.AgentPrompt, "agent_stop": &k.AgentStop,
"roadmap_grip": &k.RoadmapGrip, "roadmap_fold": &k.RoadmapFold, "zoom_in": &k.ZoomIn, "zoom_out": &k.ZoomOut, "today": &k.Today,
"end_earlier": &k.EndEarlier, "end_later": &k.EndLater, "roadmap_issues": &k.RoadmapIssues, "roadmap_edit": &k.RoadmapEdit,
Expand Down Expand Up @@ -83,7 +83,7 @@ var keyScopes = []struct {
}},
{"planning", []string{
"up", "down", "left", "right", "top", "bottom", "page_up", "page_down", "quit", "plan", "next_view", "prev_view",
"mark", "move_sprint", "plan_start", "plan_goal", "plan_rename", "plan_new", "plan_complete", "rank_up", "rank_down",
"mark", "move_sprint", "plan_start", "plan_goal", "plan_rename", "plan_new", "plan_complete", "plan_done", "rank_up", "rank_down",
"search", "quick_edit", "bulk", "undo",
"refresh", "browser", "open", "toggle_panel", "help", "copy_key",
}},
Expand Down
3 changes: 2 additions & 1 deletion internal/ui/model.go
Original file line number Diff line number Diff line change
Expand Up @@ -77,7 +77,7 @@ type keyMap struct {

// Planning's, the roadmap's and the timesheet's own keys.
PlanStart, PlanGoal, PlanRename key.Binding
PlanNew, PlanComplete key.Binding
PlanNew, PlanComplete, PlanDone key.Binding
RankUp, RankDown key.Binding
RankTop, RankBottom key.Binding
NextComment, PrevComment key.Binding
Expand Down Expand Up @@ -204,6 +204,7 @@ func defaultKeys() keyMap {
PlanRename: bind(i18n.T("rename the sprint"), "R"),
PlanNew: bind(i18n.T("new sprint"), "N"),
PlanComplete: bind(i18n.T("complete the sprint (twice)"), "C"),
PlanDone: bind(i18n.T("hide or show a future sprint's done issues"), "d"),
RankUp: bind(i18n.T("rank up"), "K"),
RankDown: bind(i18n.T("rank down"), "J"),
RankTop: bind(i18n.T("rank to the top"), "alt+k"),
Expand Down
Loading
Loading