@@ -2230,9 +2718,71 @@ def render_index_html() -> str:
].join("\n");
}
+ function summarizeNextAction() {
+ const settingsErrors = (state.validation?.settings || []).length;
+ const snapshotErrors = (state.validation?.account_snapshot || []).length;
+ const settingsApproval = state.approvalSettings?.status || "MISSING";
+ const snapshotApproval = state.approvalSnapshot?.status || "MISSING";
+ const lockCount = (state.locks || []).length;
+ if (settingsErrors || snapshotErrors) {
+ return {
+ title: "Fix validation issues",
+ detail: `${settingsErrors + snapshotErrors} validation issue(s) remain. Edit the workspace before approving or exporting.`,
+ };
+ }
+ if (settingsApproval !== "APPROVED" || snapshotApproval !== "APPROVED") {
+ return {
+ title: "Approve the current workspace",
+ detail: `Approval status is settings=${settingsApproval}, snapshot=${snapshotApproval}. Review and approve the rows that are ready.`,
+ };
+ }
+ if (lockCount > 0) {
+ return {
+ title: "Resolve active locks",
+ detail: `${lockCount} lock(s) are active. Unlock only after confirming the affected rows are stable.`,
+ };
+ }
+ return {
+ title: "Workspace is ready",
+ detail: "Approvals are clear and no active locks remain. Export or continue with downstream work.",
+ };
+ }
+
+ function summarizeCollectionAction(collection, latestRun, latestReport) {
+ const runStatus = String(latestRun?.status || "").trim();
+ const runId = String(latestRun?.run_id || "").trim();
+ if (!runId) {
+ return {
+ title: "No collection run yet",
+ detail: "Use Collect now to create the first collector run and populate the run history.",
+ };
+ }
+ if (runStatus === "FAIL") {
+ return {
+ title: "Collector failed",
+ detail: `Latest run ${runId} failed. Check the run log and error rows before retrying.`,
+ };
+ }
+ return {
+ title: `Latest collection ${runStatus || "PASS"}`,
+ detail: `Run ${runId} finished at ${latestRun?.finished_at || "N/A"}. Report status is ${latestReport?.status || "N/A"}.`,
+ };
+ }
+
+ function setPanelOpen(panelId, shouldOpen) {
+ const panel = document.getElementById(panelId);
+ if (panel) panel.open = Boolean(shouldOpen);
+ }
+
function renderMeta() {
const settingsApproval = state.approvalSettings || {};
const snapshotApproval = state.approvalSnapshot || {};
+ const settingsErrors = state.validation?.settings || [];
+ const snapshotErrors = state.validation?.account_snapshot || [];
+ const lockCount = (state.locks || []).length;
+ const collection = state.collection || {};
+ const latestRun = collection.latest_run || {};
+ const latestReport = collection.latest_report || {};
const version = state.version || {};
const git = version.git || {};
const source = version.source || {};
@@ -2272,6 +2822,40 @@ def render_index_html() -> str:
`change_log=${historyCounts.changes ?? 0}, approvals=${historyCounts.approvals ?? 0}, locks=${historyCounts.locks ?? 0}` +
(changeLogFilter ? `, filtered=${visibleChanges.length}` : "") +
(recent ? ` | latest=${recent.domain}:${recent.action}:${recent.target_ref} @ ${recent.created_at}` : "");
+ const nextAction = summarizeNextAction();
+ const collectionAction = summarizeCollectionAction(collection, latestRun, latestReport);
+ const heroNow = document.getElementById("heroNow");
+ const heroNowDetail = document.getElementById("heroNowDetail");
+ const heroNextAction = document.getElementById("heroNextAction");
+ const heroNextDetail = document.getElementById("heroNextDetail");
+ const heroPrimaryAction = document.getElementById("heroPrimaryAction");
+ const heroCollection = document.getElementById("heroCollection");
+ const heroCollectionDetail = document.getElementById("heroCollectionDetail");
+ if (heroNow) {
+ heroNow.textContent = `Workspace rows: settings=${state.summary?.settings_rows ?? 0}, snapshot=${state.summary?.account_snapshot_rows ?? 0}`;
+ }
+ if (heroNowDetail) {
+ heroNowDetail.textContent = `Approval: settings=${settingsApproval.status || "MISSING"}, snapshot=${snapshotApproval.status || "MISSING"} | locks=${locks.length}`;
+ }
+ if (heroNextAction) heroNextAction.textContent = nextAction.title;
+ if (heroNextDetail) heroNextDetail.textContent = nextAction.detail;
+ if (heroPrimaryAction) {
+ heroPrimaryAction.textContent = nextAction.title;
+ const workspaceNeedsAttention = settingsErrors.length > 0 || snapshotErrors.length > 0 || settingsApproval.status !== "APPROVED" || snapshotApproval.status !== "APPROVED" || lockCount > 0;
+ heroPrimaryAction.href = workspaceNeedsAttention ? "/" : "/collection";
+ }
+ if (heroCollection) {
+ heroCollection.textContent = collectionAction.title;
+ }
+ if (heroCollectionDetail) {
+ heroCollectionDetail.textContent = collectionAction.detail;
+ }
+ const shouldOpenWorkspace = settingsErrors.length > 0 || snapshotErrors.length > 0;
+ const shouldOpenApproval = !shouldOpenWorkspace && (settingsApproval.status !== "APPROVED" || snapshotApproval.status !== "APPROVED" || lockCount > 0);
+ const shouldOpenCollection = !shouldOpenWorkspace && !shouldOpenApproval && (!latestRun.run_id || latestRun.status === "FAIL");
+ setPanelOpen("approvalPanel", shouldOpenApproval);
+ setPanelOpen("collectionPanel", shouldOpenCollection);
+ setPanelOpen("selectionPanel", Boolean(state.selected?.domain) && !shouldOpenWorkspace && !shouldOpenApproval && !shouldOpenCollection);
document.getElementById("bannerApprovalSummary").textContent =
`settings=${settingsApproval.status || "MISSING"} | snapshot=${snapshotApproval.status || "MISSING"}`;
document.getElementById("bannerLockSummary").textContent =
@@ -2290,17 +2874,27 @@ def render_index_html() -> str:
}).join("\n");
const timelineEl = document.getElementById("changeTimeline");
if (timelineEl) {
+ const changeSummary = visibleChanges.slice(0, 12).map((item) => ({
+ ts: String(item.created_at || "").slice(5, 16),
+ label: `${item.domain}:${item.action}`,
+ }));
timelineEl.innerHTML = visibleChanges.length
- ? visibleChanges.map((item) => {
- const before = Array.isArray(item.before_json) ? item.before_json : [];
- const after = Array.isArray(item.after_json) ? item.after_json : [];
- return `
-
- ${esc(item.domain)} · ${esc(item.action)} · ${esc(item.target_ref)} · ${esc(item.created_at)}
- ${esc(JSON.stringify({ before, after }, null, 2))}
-
- `;
- }).join("")
+ ? `
+
Recent change summary
+
+ ${changeSummary.map((item) => `${esc(item.ts || "N/A")} · ${esc(item.label)}`).join("")}
+
+ ${visibleChanges.map((item) => {
+ const before = Array.isArray(item.before_json) ? item.before_json : [];
+ const after = Array.isArray(item.after_json) ? item.after_json : [];
+ return `
+
+ ${esc(item.domain)} · ${esc(item.action)} · ${esc(item.target_ref)} · ${esc(item.created_at)}
+ ${esc(JSON.stringify({ before, after }, null, 2))}
+
+ `;
+ }).join("")}
+ `
: "
No timeline entries.
";
}
}
@@ -2335,8 +2929,9 @@ def render_index_html() -> str:
const runsEl = document.getElementById("collectionRuns");
const snapshotsEl = document.getElementById("collectionSnapshots");
const errorsEl = document.getElementById("collectionErrors");
+ const timelineEl = document.getElementById("collectionTimeline");
const detailEl = document.getElementById("collectionDetail");
- if (!chip || !summary || !metrics || !runsEl || !snapshotsEl || !errorsEl || !detailEl) return;
+ if (!chip || !summary || !metrics || !runsEl || !snapshotsEl || !errorsEl || !timelineEl || !detailEl) return;
const filterText = String(document.getElementById("collectionFilter")?.value || state.filterCollection || "").trim().toLowerCase();
state.filterCollection = filterText;
chip.textContent = `collector: ${counts.collection_runs ?? 0} runs / ${counts.collection_snapshots ?? 0} snapshots / ${counts.collection_source_errors ?? 0} errors`;
@@ -2346,6 +2941,7 @@ def render_index_html() -> str:
latestRun.run_id ? `latest_run=${latestRun.run_id}` : "",
latestReport.status ? `latest_status=${latestReport.status}` : "",
latestReport.generated_at ? `generated_at=${latestReport.generated_at}` : "",
+ state.version?.source?.latest_updated_at ? `final_updated_at=${state.version.source.latest_updated_at}` : "",
filterText ? `filter=${filterText}` : "",
].filter(Boolean).join(" | ");
const sourceCounts = latestReport.source_counts || {};
@@ -2378,7 +2974,7 @@ def render_index_html() -> str:
const key = currentCollectionSelectionKey(kind, item, index);
const selected = selection.kind === kind && selection.key === key;
return `
-