@harborppm/cli 0.11.0 → 0.11.2

package/dist/app.mjs

@@ -3285,6 +3285,19 @@ function weeklyLoad(tasks, personId, now, weeks = 6) {
 	};
 }
 
+//#endregion
+//#region src/lib/selectors.ts
+/** Projects (or programs) still running, and the ones set to Done, which lists tuck away until asked for. */
+function splitDone(items) {
+	const open = [];
+	const done = [];
+	for (const item of items) (item.health === "done" ? done : open).push(item);
+	return {
+		open,
+		done
+	};
+}
+
 //#endregion
 //#region src/tui/views/lists.tsx
 const count = (n, noun) => `${n} ${noun}${n === 1 ? "" : "s"}`;
@@ -3335,19 +3348,23 @@ function RowList({ title, right, rows, empty, active, width, height, onOpen, key
 		]
 	});
 }
-/** Every project, under its program and portfolio, with health and progress. */
+/** Every project, under its program and portfolio, with health and progress. Done
+*  projects and programs stay out of the way until D shows them. */
 function ProjectsView({ active, width, height, go }) {
 	const portfolios = useHarbor((s) => s.portfolios);
 	const programs = useHarbor((s) => s.programs);
 	const projects = useHarbor((s) => s.projects);
 	const tasks = useHarbor((s) => s.tasks);
 	const { today } = useDeps();
-	const rows = useMemo(() => {
+	const [showDone, setShowDone] = useState(false);
+	const { rows, shown, hidden } = useMemo(() => {
 		const data = {
 			tasks,
 			projects
 		};
 		const out = [];
+		let shown = 0;
+		let hidden = 0;
 		for (const portfolio of portfolios) {
 			out.push({
 				id: portfolio.id,
@@ -3358,6 +3375,11 @@ function ProjectsView({ active, width, height, go }) {
 				health: portfolio.health
 			});
 			for (const program of programs.filter((g) => g.portfolioId === portfolio.id)) {
+				const { open, done } = splitDone(projects.filter((p) => p.programId === program.id));
+				if (program.health === "done" && open.length === 0) {
+					hidden += 1 + done.length;
+					if (!showDone) continue;
+				} else hidden += done.length;
 				out.push({
 					id: program.id,
 					kind: "program",
@@ -3365,8 +3387,9 @@ function ProjectsView({ active, width, height, go }) {
 					title: program.name,
 					health: program.health
 				});
-				for (const project of projects.filter((p) => p.programId === program.id)) {
-					const { done, total } = projectSummary(data, project);
+				for (const project of showDone ? [...open, ...done] : open) {
+					shown++;
+					const { done: finished, total } = projectSummary(data, project);
 					const late = tasksOf(tasks, project.id).filter((t) => isLate(t, today())).length;
 					out.push({
 						id: project.id,
@@ -3374,22 +3397,27 @@ function ProjectsView({ active, width, height, go }) {
 						depth: 2,
 						title: `${project.name}${project.key ? ` ${project.key}` : ""}`,
 						health: project.health,
-						detail: `${done}/${total} done${late ? ` · ${late} late` : ""} · ends ${shortDay(project.endDate, today())}`
+						detail: `${finished}/${total} done${late ? ` · ${late} late` : ""} · ends ${shortDay(project.endDate, today())}`
 					});
 				}
 			}
 		}
-		return out;
+		return {
+			rows: out,
+			shown,
+			hidden
+		};
 	}, [
 		portfolios,
 		programs,
 		projects,
 		tasks,
-		today
+		today,
+		showDone
 	]);
 	return /* @__PURE__ */ jsx(RowList, {
 		title: "Portfolios, programs and projects",
-		right: `${count(projects.length, "project")} · n new project · e edit`,
+		right: `${count(shown, "project")}${hidden ? ` · ${hidden} done ${showDone ? "shown" : "hidden"} (D)` : ""} · n new project · e edit`,
 		rows,
 		empty: "No projects yet. n adds one.",
 		active,
@@ -3401,7 +3429,8 @@ function ProjectsView({ active, width, height, go }) {
 				const programId = r?.kind === "program" ? r.id : r?.kind === "project" ? projects.find((p) => p.id === r.id)?.programId : void 0;
 				go.create("project", programId ? { programId } : {});
 			},
-			e: (r) => r && r.kind !== "raid" && r.kind !== "person" && go.openPanel(r.kind, r.id)
+			e: (r) => r && r.kind !== "raid" && r.kind !== "person" && go.openPanel(r.kind, r.id),
+			D: () => hidden > 0 && setShowDone((v) => !v)
 		}
 	});
 }
@@ -3411,7 +3440,10 @@ function ProgramsView({ active, width, height, go }) {
 	const portfolios = useHarbor((s) => s.portfolios);
 	const milestones = useHarbor((s) => s.milestones);
 	const { today } = useDeps();
-	const rows = useMemo(() => programs.map((program) => {
+	const [showDone, setShowDone] = useState(false);
+	const split = useMemo(() => splitDone(programs), [programs]);
+	const listed = useMemo(() => showDone ? [...split.open, ...split.done] : split.open, [split, showDone]);
+	const rows = useMemo(() => listed.map((program) => {
 		const portfolio = portfolios.find((p) => p.id === program.portfolioId);
 		const late = milestones.filter((m) => m.programId === program.id && !m.done && m.dueDate < today()).length;
 		return {
@@ -3427,16 +3459,17 @@ function ProgramsView({ active, width, height, go }) {
 			].filter(Boolean).join(" · ")
 		};
 	}), [
-		programs,
+		listed,
 		portfolios,
 		milestones,
 		today
 	]);
+	const done = split.done.length;
 	return /* @__PURE__ */ jsx(RowList, {
 		title: "Programs",
-		right: `${count(programs.length, "program")} · n new · e edit`,
+		right: `${count(listed.length, "program")}${done ? ` · ${done} done ${showDone ? "shown" : "hidden"} (D)` : ""} · n new · e edit`,
 		rows,
-		empty: "No programs yet. n adds one.",
+		empty: done ? "Every program is done. D shows them." : "No programs yet. n adds one.",
 		active,
 		width,
 		height,
@@ -3446,7 +3479,8 @@ function ProgramsView({ active, width, height, go }) {
 				const portfolioId = r ? programs.find((p) => p.id === r.id)?.portfolioId : void 0;
 				go.create("program", portfolioId ? { portfolioId } : {});
 			},
-			e: (r) => r && go.openPanel("program", r.id)
+			e: (r) => r && go.openPanel("program", r.id),
+			D: () => done > 0 && setShowDone((v) => !v)
 		}
 	});
 }
@@ -4689,19 +4723,6 @@ function PersonPanel({ id, width, height, go, onClose }) {
 	});
 }
 
-//#endregion
-//#region src/lib/selectors.ts
-/** Projects (or programs) still running, and the ones set to Done, which lists tuck away until asked for. */
-function splitDone(items) {
-	const open = [];
-	const done = [];
-	for (const item of items) (item.health === "done" ? done : open).push(item);
-	return {
-		open,
-		done
-	};
-}
-
 //#endregion
 //#region src/tui/views/program.tsx
 /**

package/lib/cli.mjs

@@ -40,8 +40,9 @@ export const HELP = `harbor: Harbor from the terminal
   harbor theme [auto|light|dark]              the app's colours
   harbor --version                            which version this is
 
-  harbor programs                             programs and their projects
-  harbor projects [words] [--program P]       projects with health and open work
+  harbor programs [--done]                    programs and their projects
+  harbor projects [words] [--program P] [--done]
+                                              projects with health and open work
   harbor mine                                 what's on you, late first
   harbor tasks [words] [--project P] [--assignee me|none|NAME]
                      [--late] [--status S,S]
@@ -560,12 +561,12 @@ export async function run(argv, io = {}) {
       return 0;
     }
     case "programs": {
-      const { positionals, harbor } = parse(spec());
+      const { positionals, values, harbor } = parse(spec(["done"]));
       none(positionals);
-      return call("harbor_overview", { harbor }, programTree);
+      return call("harbor_overview", { harbor }, (r) => programTree(r, { done: values.done }));
     }
     case "projects": {
-      const { positionals, values, harbor } = parse(spec([], ["program"]));
+      const { positionals, values, harbor } = parse(spec(["done"], ["program"]));
       return call(
         "list_projects",
         {
@@ -574,7 +575,7 @@ export async function run(argv, io = {}) {
           program: values.program,
           limit: 100,
         },
-        projectList,
+        (r) => projectList(r, { done: values.done }),
       );
     }
     case "program": {

package/lib/format.mjs

@@ -72,20 +72,33 @@ export function taskList(r, opts) {
 const HEALTH = { "on-track": "on track", "at-risk": "at risk", "off-track": "off track" };
 const health = (h) => HEALTH[h] ?? h ?? null;
 
-/** Each portfolio's programs and their projects, indented, as harbor_overview gives them. */
-export function programTree(r) {
+/** "2 done not shown (--done shows them).", or nothing. */
+const hiddenNote = (n, what) =>
+  n ? `\n${n} done ${what}${n === 1 ? "" : "s"} not shown (--done shows them).` : "";
+
+/**
+ * Each portfolio's programs and their projects, indented, as harbor_overview
+ * gives them. Programs and projects set to Done stay out unless `done`.
+ */
+export function programTree(r, { done = false } = {}) {
   const portfolios = r.portfolios ?? [];
   if (!portfolios.some((pf) => pf.programs.length)) {
     return 'No programs yet. Open one with harbor program "NAME".';
   }
+  const shown = (x) => done || x.health !== "done";
+  let hidden = 0;
   const out = [];
   for (const pf of portfolios) {
-    if (portfolios.length > 1) out.push(pf.name);
+    const programs = pf.programs.filter(shown);
+    hidden += pf.programs.length - programs.length;
+    if (portfolios.length > 1 && programs.length) out.push(pf.name);
     const pad = portfolios.length > 1 ? "  " : "";
-    for (const pg of pf.programs) {
+    for (const pg of programs) {
       const bits = [health(pg.health), pg.ends ? `ends ${pg.ends}` : null].filter(Boolean);
       out.push(`${pad}${pg.name}  (${bits.join(" · ")})`);
-      for (const pj of pg.projects) {
+      const projects = pg.projects.filter(shown);
+      hidden += pg.projects.length - projects.length;
+      for (const pj of projects) {
         const work = [
           health(pj.health),
           `${pj.openTasks} open`,
@@ -97,15 +110,20 @@ export function programTree(r) {
       if (!pg.projects.length) out.push(`${pad}  no projects yet`);
     }
   }
-  return out.join("\n");
+  if (!out.length) return `Every program is done.${hiddenNote(hidden, "item").replace("\n", " ")}`;
+  return out.join("\n") + hiddenNote(hidden, "item");
 }
 
-/** Projects one per line, name first so it can be passed to --project. */
-export function projectList(r) {
+/** Projects one per line, name first so it can be passed to --project. Done ones only with `done`. */
+export function projectList(r, { done = false } = {}) {
   if (!r.projects?.length) return "No projects match.";
+  const projects = done ? r.projects : r.projects.filter((p) => p.health !== "done");
+  const hidden = r.projects.length - projects.length;
+  if (!projects.length)
+    return `Every project that matches is done.${hiddenNote(hidden, "project").replace("\n", " ")}`;
   const more = r.total > r.projects.length ? `\n…and ${r.total - r.projects.length} more.` : "";
   return (
-    r.projects
+    projects
       .map((p) => {
         const late = p.tasks.late ? `, ${p.tasks.late} late` : "";
         const bits = [
@@ -117,7 +135,9 @@ export function projectList(r) {
         ].filter(Boolean);
         return `${p.name}  (${bits.join(" · ")})`;
       })
-      .join("\n") + more
+      .join("\n") +
+    hiddenNote(hidden, "project") +
+    more
   );
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harborppm/cli",
-  "version": "0.11.0",
+  "version": "0.11.2",
   "description": "Harbor from the terminal: a full-screen app with everything, plus commands for scripts and agents.",
   "keywords": [
     "harbor",