2026-10-18 15:39:24 -07:00
|
|
|
// Plan2Code Web Console - User Preferences, Cleanup tab.
|
|
|
|
|
|
|
|
|
|
import { formatBytes } from "../answers.js";
|
|
|
|
|
import { el } from "../render.js";
|
|
|
|
|
import { postJson } from "../net.js";
|
|
|
|
|
|
|
|
|
|
const $ = (id) => document.getElementById(id);
|
|
|
|
|
|
|
|
|
|
// Cleanup: the server works out what in ~/.plan2code is not needed and
|
|
|
|
|
// shows it first; Delete these sends back only the ids it was shown, and the
|
|
|
|
|
// server re-checks every one before removing it.
|
|
|
|
|
let cleanupFound = null;
|
|
|
|
|
|
|
|
|
|
// Bumped by every scan, delete and reset: a response from an older one is
|
|
|
|
|
// dropped, so a scan still in flight when Preferences closes cannot refill it.
|
|
|
|
|
let cleanupGen = 0;
|
|
|
|
|
|
|
|
|
|
const CLEANUP_SHOWN = 8;
|
|
|
|
|
|
|
|
|
|
function setCleanupStatus(text, isError) {
|
|
|
|
|
const status = $("cleanup-status");
|
|
|
|
|
status.textContent = text;
|
|
|
|
|
status.classList.toggle("error", Boolean(isError));
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
const CLEANUP_WHERE = { root: "~/.plan2code/", console: "~/.plan2code/console/", completed: "specs--completed/" };
|
|
|
|
|
|
|
|
|
|
function cleanupLabel(item) {
|
|
|
|
|
if (item.where === "session") return "Session " + item.name;
|
2026-10-19 15:56:52 -07:00
|
|
|
// One notepad is one item, named by the folder it belongs to; its key only
|
|
|
|
|
// when its meta.json is gone.
|
|
|
|
|
if (item.where === "notepad") return "Notepad for " + (item.folder || item.name);
|
2026-10-18 15:39:24 -07:00
|
|
|
return CLEANUP_WHERE[item.where] + item.name + (item.kind === "folder" ? "/" : "");
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
function cleanupSummary(items, bytes) {
|
|
|
|
|
const sessions = items.filter((i) => i.where === "session").length;
|
|
|
|
|
const completed = items.filter((i) => i.where === "completed").length;
|
2026-10-19 15:56:52 -07:00
|
|
|
const notepads = items.filter((i) => i.where === "notepad").length;
|
|
|
|
|
const strays = items.length - sessions - completed - notepads;
|
2026-10-18 15:39:24 -07:00
|
|
|
const parts = [];
|
|
|
|
|
if (sessions) parts.push(sessions + (sessions === 1 ? " old session" : " old sessions"));
|
|
|
|
|
if (completed) parts.push(completed + (completed === 1 ? " old completed spec" : " old completed specs"));
|
2026-10-19 15:56:52 -07:00
|
|
|
if (notepads) parts.push(notepads + (notepads === 1 ? " old notepad" : " old notepads"));
|
2026-10-18 15:39:24 -07:00
|
|
|
if (strays) parts.push(strays + (strays === 1 ? " stray file or folder" : " stray files and folders"));
|
|
|
|
|
return parts.join(", ") + " · " + formatBytes(bytes);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
function resetCleanup() {
|
|
|
|
|
cleanupGen++;
|
|
|
|
|
cleanupFound = null;
|
|
|
|
|
$("cleanup-list").replaceChildren();
|
|
|
|
|
$("cleanup-delete").hidden = true;
|
|
|
|
|
$("cleanup-delete").disabled = false;
|
|
|
|
|
$("cleanup-scan").disabled = false;
|
|
|
|
|
setCleanupStatus("", false);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
function renderCleanup() {
|
|
|
|
|
const list = $("cleanup-list");
|
|
|
|
|
list.replaceChildren();
|
|
|
|
|
const items = (cleanupFound && cleanupFound.items) || [];
|
|
|
|
|
$("cleanup-delete").hidden = !items.length;
|
|
|
|
|
if (!items.length) return;
|
|
|
|
|
const rows = (some) => some.map((item) => {
|
|
|
|
|
const row = el("div", "cleanup-row");
|
|
|
|
|
row.append(el("span", null, cleanupLabel(item)), el("span", "cleanup-size", formatBytes(item.bytes)));
|
|
|
|
|
return row;
|
|
|
|
|
});
|
|
|
|
|
list.append(el("p", "cleanup-summary", cleanupSummary(items, cleanupFound.bytes)), ...rows(items.slice(0, CLEANUP_SHOWN)));
|
|
|
|
|
if (items.length > CLEANUP_SHOWN) {
|
|
|
|
|
const more = el("details", "cleanup-more");
|
|
|
|
|
more.append(el("summary", null, (items.length - CLEANUP_SHOWN) + " more"), ...rows(items.slice(CLEANUP_SHOWN)));
|
|
|
|
|
list.appendChild(more);
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
async function scanCleanup() {
|
|
|
|
|
const gen = ++cleanupGen;
|
|
|
|
|
$("cleanup-scan").disabled = true;
|
|
|
|
|
$("cleanup-delete").disabled = true;
|
|
|
|
|
setCleanupStatus("Looking…", false);
|
|
|
|
|
const { status, body } = await postJson("/cleanup", { scan: true });
|
|
|
|
|
if (gen !== cleanupGen) return;
|
|
|
|
|
$("cleanup-scan").disabled = false;
|
|
|
|
|
$("cleanup-delete").disabled = false;
|
|
|
|
|
if (status !== 200 || !body.ok) {
|
|
|
|
|
cleanupFound = null;
|
|
|
|
|
renderCleanup();
|
|
|
|
|
return setCleanupStatus(status ? body.error || "Could not look." : "Plan2Code isn't reachable.", true);
|
|
|
|
|
}
|
|
|
|
|
cleanupFound = { items: body.items || [], bytes: body.bytes || 0 };
|
|
|
|
|
renderCleanup();
|
|
|
|
|
// Left in the status line, not cleared: it is the live region, so this is
|
|
|
|
|
// what a screen reader hears when the scan finishes.
|
|
|
|
|
const found = cleanupFound.items.length;
|
|
|
|
|
setCleanupStatus(found ? "Found " + found + (found === 1 ? " item." : " items.") : "Nothing to clean up.", false);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
async function deleteCleanup() {
|
|
|
|
|
if (!cleanupFound || !cleanupFound.items.length) return;
|
|
|
|
|
const gen = ++cleanupGen;
|
|
|
|
|
$("cleanup-delete").disabled = true;
|
|
|
|
|
$("cleanup-scan").disabled = true;
|
|
|
|
|
setCleanupStatus("Deleting…", false);
|
|
|
|
|
const { status, body } = await postJson("/cleanup", { delete: cleanupFound.items.map((i) => i.id) });
|
|
|
|
|
if (gen !== cleanupGen) return;
|
|
|
|
|
$("cleanup-delete").disabled = false;
|
|
|
|
|
$("cleanup-scan").disabled = false;
|
|
|
|
|
if (status !== 200 || !body.ok) {
|
|
|
|
|
return setCleanupStatus(status ? body.error || "Could not delete." : "Plan2Code isn't reachable.", true);
|
|
|
|
|
}
|
|
|
|
|
const removed = (body.removed || []).length;
|
|
|
|
|
const failed = (body.failed || []).length;
|
|
|
|
|
// The server re-checks every id and keeps anything that changed since the
|
|
|
|
|
// scan; say so, rather than let a count that came up short pass unremarked.
|
|
|
|
|
const asked = cleanupFound.items.length;
|
|
|
|
|
const kept = Math.max(0, asked - removed - failed);
|
|
|
|
|
cleanupFound = null;
|
|
|
|
|
renderCleanup();
|
|
|
|
|
const done = removed ? "Deleted " + removed + (removed === 1 ? " item" : " items") + " · " + formatBytes(body.bytes) + " freed." : "Nothing was deleted.";
|
|
|
|
|
const keptLine = kept ? ` ${kept} ${kept === 1 ? "was" : "were"} kept because ${kept === 1 ? "it" : "they"} changed since the scan.` : "";
|
|
|
|
|
setCleanupStatus((failed ? done + " " + failed + " could not be removed." : done) + keptLine, Boolean(failed));
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// The Cleanup tab's buttons, and starting over whenever Preferences closes.
|
|
|
|
|
export function wireCleanup() {
|
|
|
|
|
$("cleanup-scan").addEventListener("click", scanCleanup);
|
|
|
|
|
$("cleanup-delete").addEventListener("click", deleteCleanup);
|
|
|
|
|
$("looks-modal").addEventListener("close", resetCleanup);
|
|
|
|
|
}
|