Files
restic-manager/web/templates/pages/job_detail.html
T
steve 4c108bb68a P3-01/02/03: restore wizard backend + templates + restore-shaped job page
End-to-end wizard from /hosts/{id}/restore (or per-snapshot deep link
/hosts/{id}/snapshots/{sid}/restore) → tree-browse → dispatch →
restore-shaped live job page.

Backend (internal/server/http/ui_restore.go):
- GET handlers render the four-step wizard against the wireframe shape
  in docs/superpowers/specs/2026-05-04-p3-restore-design.md.
- HTMX tree partial endpoint hits fetchTreeWithCache (P3-X2) so each
  directory expansion is a sub-second cached lookup after the first
  miss.
- POST validates: snapshot_id non-empty, ≥1 absolute path, in-place
  mode requires confirm_hostname == host name, agent online. On error
  re-renders the wizard with the operator's input intact. Happy path
  mints a job_id, computes the new-directory target as
  /var/restic-restore/<job-id>/ (operator can't escape the prefix —
  server picks it), creates the job row, ships command.run with
  kind=restore + RestorePayload, writes a host.restore audit row,
  returns HX-Redirect (or 303) to the live job page.

Templates:
- host_restore.html: single-page progressively-enabled wizard matching
  _diag/p3-restore-wizard wireframe. Form-state-driven JS computes a
  running tally of selected paths and the step-4 confirm summary
  client-side; the server re-renders on validation failure with form
  fields preserved.
- partials/tree_node.html: recursive HTMX-served tree fragment.
- Top-level Restore button on host_detail right rail + per-snapshot
  Restore action on snapshot rows replace the previous P3-stub.

Restore-shaped job page (job_detail.html):
- Progress widget rendered as a panel rather than a bare strip when
  the job is active.
- Current-file display under the bar, updated from log.stream stdout
  lines that look like absolute paths. Hidden for non-restore kinds.

Migration 0012:
- Add restore + diff to the jobs.kind CHECK. Rebuild required (SQLite
  can't ALTER CHECK in place); follows the safe pattern from 0005.
  Defensive: stash job_logs into a temp table before the rebuild and
  INSERT OR IGNORE back afterwards so even if SQLite cascades on
  DROP TABLE jobs the log history survives.

Tests:
- ui_restore_test covers GET step-1 render, GET pre-selected snapshot
  summary card, POST missing snapshot, POST missing paths, POST
  in-place wrong-hostname rejection (no command.run leaks to the
  agent), POST happy path (HX-Redirect + correct payload + audit
  row), POST against offline host returns 503.

Restage block (CLAUDE.md) deferred to the end of the restore phase.
2026-05-04 15:34:29 +01:00

282 lines
12 KiB
HTML

{{define "title"}}{{.Title}}{{end}}
{{define "content"}}
{{$page := .Page}}
{{$job := $page.Job}}
{{$host := $page.Host}}
<div class="max-w-[1280px] mx-auto px-8 pt-7 pb-14">
<div class="crumbs">
<a href="/">Dashboard</a><span class="sep">/</span>
<a href="/hosts/{{$host.ID}}">{{$host.Name}}</a><span class="sep">/</span>
<span class="text-ink-mid">job {{slice $job.ID 0 8}}…{{slice $job.ID (sub (len $job.ID) 4) (len $job.ID)}}</span>
</div>
{{/* ---------- header ---------- */}}
<div class="flex items-start justify-between mt-3.5">
<div>
<div class="flex items-center gap-3">
{{if $page.IsActive}}
<span class="dot pulse" style="background: var(--accent);"></span>
{{else if eq $job.Status "succeeded"}}
<span class="dot dot-online"></span>
{{else if eq $job.Status "failed"}}
<span class="dot dot-failed"></span>
{{else}}
<span class="dot dot-offline"></span>
{{end}}
<h1 class="text-[22px] font-medium tracking-[-0.01em]">
{{$job.Kind}} <span class="text-ink-fade">·</span>
<span class="mono text-ink font-medium">{{$host.Name}}</span>
</h1>
{{if eq $job.Status "queued"}}
<span class="mono text-[11px] px-2 py-0.5 rounded-[3px]"
style="background: color-mix(in oklch, var(--ink-mid), transparent 88%); color: var(--ink-mid); border: 1px solid var(--line-soft);">queued</span>
{{else if eq $job.Status "running"}}
<span class="mono text-[11px] px-2 py-0.5 rounded-[3px]"
style="background: color-mix(in oklch, var(--accent), transparent 88%); color: var(--accent); border: 1px solid color-mix(in oklch, var(--accent), transparent 70%);">running</span>
{{else if eq $job.Status "succeeded"}}
<span class="mono text-[11px] px-2 py-0.5 rounded-[3px]"
style="background: color-mix(in oklch, var(--ok), transparent 88%); color: var(--ok); border: 1px solid color-mix(in oklch, var(--ok), transparent 70%);">succeeded</span>
{{else if eq $job.Status "failed"}}
<span class="mono text-[11px] px-2 py-0.5 rounded-[3px]"
style="background: color-mix(in oklch, var(--bad), transparent 88%); color: var(--bad); border: 1px solid color-mix(in oklch, var(--bad), transparent 70%);">failed</span>
{{else}}
<span class="mono text-[11px] px-2 py-0.5 rounded-[3px]"
style="background: color-mix(in oklch, var(--warn), transparent 88%); color: var(--warn); border: 1px solid color-mix(in oklch, var(--warn), transparent 70%);">{{$job.Status}}</span>
{{end}}
</div>
<div class="flex items-center gap-3 mt-2.5 text-[12.5px] text-ink-mute">
<span>job <span class="mono text-ink-mid">{{$job.ID}}</span></span>
{{if $job.StartedAt}}
<span class="text-ink-fade">·</span>
<span>started <span class="mono text-ink-mid">{{relTime $job.StartedAt}}</span></span>
{{end}}
{{if $job.FinishedAt}}
<span class="text-ink-fade">·</span>
<span>finished <span class="mono text-ink-mid">{{relTime $job.FinishedAt}}</span></span>
{{end}}
{{if $job.ExitCode}}
<span class="text-ink-fade">·</span>
<span>exit code <span class="mono {{if eq $job.Status "failed"}}text-bad{{else}}text-ink-mid{{end}}">{{derefInt $job.ExitCode}}</span></span>
{{end}}
</div>
</div>
<div class="flex items-center gap-2">
{{if $page.IsActive}}
<button class="btn btn-danger" id="cancel-btn"
hx-post="/api/jobs/{{$job.ID}}/cancel"
hx-swap="none">Cancel job</button>
{{else}}
<a href="/hosts/{{$host.ID}}" class="btn">Back to host</a>
{{end}}
</div>
</div>
{{/* ---------- progress (running only) ---------- */}}
{{if $page.IsActive}}
<div class="mt-7 panel rounded-[8px] p-[18px]" id="progress-block">
<div class="flex items-center justify-between mb-2.5">
<div class="flex items-center gap-3.5 text-sm">
<span class="mono text-ink font-medium" id="progress-pct" style="font-size: 18px;"></span>
<span class="text-ink-mute" id="progress-bytes"></span>
</div>
<div class="text-sm text-ink-mute" id="progress-rate"></div>
</div>
<div class="progress-track">
<div class="progress-fill" id="progress-fill" style="width: 0%;"></div>
</div>
{{if eq (printf "%s" $job.Kind) "restore"}}
<div class="mt-3 text-[12px] text-ink-mute" id="restore-current-block">
<span class="text-ink-fade uppercase tracking-[0.08em] text-[10.5px]">Current</span>
<span class="mono text-ink-mid ml-2.5" id="restore-current-file"></span>
</div>
{{end}}
</div>
{{end}}
{{/* ---------- failure summary (failed only) ---------- */}}
{{if eq $job.Status "failed"}}
<div class="panel mt-6 p-4 rounded-[7px]" style="border-color: color-mix(in oklch, var(--bad), transparent 60%);">
<div class="text-[11px] uppercase tracking-[0.08em] font-semibold text-bad mb-1.5">Failure</div>
{{if $job.Error}}
<p class="mono text-[13px] text-ink leading-[1.6]">{{deref $job.Error}}</p>
{{else}}
<p class="text-ink-mute text-[13px]">No error message captured. Inspect the log below for details.</p>
{{end}}
</div>
{{end}}
{{/* ---------- log viewer ---------- */}}
<div class="mt-6">
<div class="flex items-center justify-between mb-3">
<div class="flex items-center gap-3">
<h2 class="text-[13px] font-semibold tracking-[0.01em]">Stream</h2>
<span class="text-[11.5px] text-ink-fade" id="stream-status">
{{if $page.IsActive}}
following · auto-scroll on
{{else}}
<span class="text-ink-fade">complete · {{len $page.Logs}} lines</span>
{{end}}
</span>
</div>
<div class="flex items-center gap-2">
<button class="btn btn-ghost" id="follow-btn" style="display: none;">⇢ Follow</button>
</div>
</div>
<div class="log" id="log-container">
<div id="log-stream">
{{range $page.Logs}}
<div class="log-line">
<span class="log-ts">{{.TS.Format "15:04:05.000"}}</span>
<span class="log-tag">{{if eq .Stream "stdout"}}OUT{{else if eq .Stream "stderr"}}ERR{{else}}EVENT{{end}}</span>
<span class="log-stream-{{.Stream}}">{{.Payload}}</span>
</div>
{{end}}
{{if and $page.IsActive (eq (len $page.Logs) 0)}}
<div class="log-line">
<span class="log-ts" style="color: var(--accent);">···</span>
<span class="log-tag" style="color: var(--accent);"></span>
<span style="color: var(--accent);">awaiting agent output</span>
</div>
{{end}}
</div>
</div>
</div>
</div>
{{if $page.IsActive}}
<script>
(function() {
const jobID = '{{$job.ID}}';
const wsProto = location.protocol === 'https:' ? 'wss' : 'ws';
const ws = new WebSocket(`${wsProto}://${location.host}/api/jobs/${jobID}/stream`);
const stream = document.getElementById('log-stream');
const container = document.getElementById('log-container');
const fill = document.getElementById('progress-fill');
const pct = document.getElementById('progress-pct');
const bytes = document.getElementById('progress-bytes');
const rate = document.getElementById('progress-rate');
const status = document.getElementById('stream-status');
const followBtn = document.getElementById('follow-btn');
let autoScroll = true;
// If the user scrolls up, stop auto-scrolling and surface a "Follow" button.
container.addEventListener('scroll', () => {
const atBottom = container.scrollHeight - container.clientHeight - container.scrollTop < 8;
if (!atBottom && autoScroll) {
autoScroll = false;
followBtn.style.display = '';
status.textContent = 'paused · scroll to follow';
} else if (atBottom && !autoScroll) {
autoScroll = true;
followBtn.style.display = 'none';
status.textContent = 'following · auto-scroll on';
}
});
followBtn.addEventListener('click', () => {
container.scrollTop = container.scrollHeight;
});
function escapeHtml(s) {
return String(s).replace(/[&<>"']/g, c => ({
'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;'
}[c]));
}
function fmtTs(iso) {
// Show HH:MM:SS.mmm in local time. Falls back to iso if parsing fails.
const d = new Date(iso);
if (isNaN(d)) return iso;
const pad = (n, w) => String(n).padStart(w, '0');
return `${pad(d.getHours(),2)}:${pad(d.getMinutes(),2)}:${pad(d.getSeconds(),2)}.${pad(d.getMilliseconds(),3)}`;
}
function fmtBytes(n) {
if (!n) return '0 B';
const u = ['B','kB','MB','GB','TB'];
let i = 0;
while (n >= 1000 && i < u.length-1) { n /= 1000; i++; }
return (i === 0 ? n.toFixed(0) : n.toFixed(1)) + ' ' + u[i];
}
const currentFileEl = document.getElementById('restore-current-file');
function maybeUpdateCurrent(p) {
// Restore-specific: surface the most recent stdout path in the
// "Current" slot. Restic restore --json prints per-file lines on
// stdout (no JSON wrapper) so any line starting with "/" is a
// good candidate.
if (!currentFileEl || p.stream !== 'stdout') return;
const v = (p.payload || '').trim();
if (v.startsWith('/') && v.length < 400) {
currentFileEl.textContent = v;
}
}
function appendLine(p) {
// Drop the "awaiting" placeholder once real lines arrive.
if (stream.children.length === 1 && stream.firstElementChild.textContent.includes('awaiting agent')) {
stream.firstElementChild.remove();
}
const tag = p.stream === 'stdout' ? 'OUT' : p.stream === 'stderr' ? 'ERR' : 'EVENT';
const line = document.createElement('div');
line.className = 'log-line';
line.innerHTML =
`<span class="log-ts">${fmtTs(p.ts)}</span>` +
`<span class="log-tag">${tag}</span>` +
`<span class="log-stream-${p.stream}">${escapeHtml(p.payload)}</span>`;
stream.appendChild(line);
if (autoScroll) container.scrollTop = container.scrollHeight;
maybeUpdateCurrent(p);
}
ws.onmessage = (ev) => {
let env;
try { env = JSON.parse(ev.data); } catch { return; }
let p;
try { p = env.payload ? JSON.parse(JSON.stringify(env.payload)) : {}; } catch { p = {}; }
// The server sends payload as a JSON object literal, but Go wire
// wraps it as raw JSON in the envelope. After JSON.parse(ev.data)
// payload is already an object — no second parse needed.
p = env.payload || {};
switch (env.type) {
case 'log.stream':
appendLine(p);
break;
case 'job.progress': {
const percent = Math.round((p.percent_done || 0) * 100);
fill.style.width = percent + '%';
pct.textContent = percent + '%';
const totals = [];
if (p.bytes_done && p.total_bytes) totals.push(`${fmtBytes(p.bytes_done)} of ${fmtBytes(p.total_bytes)}`);
if (p.files_done && p.total_files) totals.push(`${p.files_done.toLocaleString()} of ${p.total_files.toLocaleString()} files`);
bytes.textContent = totals.length ? '· ' + totals.join(' · ') : '';
const parts = [];
if (p.throughput_bps) parts.push(`${fmtBytes(p.throughput_bps)}/s`);
if (p.eta_seconds) parts.push(`ETA ${Math.floor(p.eta_seconds/60)}m ${p.eta_seconds%60}s`);
rate.textContent = parts.join(' · ');
break;
}
case 'job.started':
// Already shown in the header on a fresh page load; if we
// arrive before the job moves to "running" the next progress
// tick will paint it.
break;
case 'job.finished':
// Reload to render the final-state header (stats / exit code
// / end-of-stream markers come from the server).
setTimeout(() => location.reload(), 600);
break;
}
};
ws.onerror = () => { status.textContent = 'connection error · reload to retry'; };
ws.onclose = () => {
if (status.textContent.startsWith('following')) {
status.textContent = 'stream closed';
}
};
})();
</script>
{{end}}
{{end}}