create-pmos 0.131.0 → 0.133.0

package/workspace/public/pm/components.css

@@ -3499,6 +3499,39 @@
 .fr-set__envrows { display: flex; flex-direction: column; gap: 6px; }
 .fr-set__flags { display: flex; flex-direction: column; gap: 8px; align-items: flex-start; min-width: 0; width: 100%; }
 
+/* workspace-data-freshness: the console header's freshness line and Settings › Data freshness (pm/freshness-line.js) */
+.fr-fresh {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 8px;
+  font-size: 12px;
+  color: var(--muted-foreground);
+}
+.fr-fresh__state--fresh { color: var(--foreground); }
+.fr-fresh__state--stale { color: var(--warning); }
+.fr-fresh__state--failed { color: var(--destructive); }
+.fr-fresh__state--never,
+.fr-fresh__state--building,
+.fr-fresh__state--off { color: var(--muted-foreground); }
+.fr-fresh-table__grid {
+  width: 100%;
+  border-collapse: collapse;
+  font-size: 12px;
+}
+.fr-fresh-table__grid th {
+  padding: 4px 8px;
+  text-align: left;
+  font-weight: 600;
+}
+.fr-fresh-table__grid td {
+  padding: 4px 8px;
+  vertical-align: top;
+}
+.fr-fresh-table__watch {
+  margin-top: 8px;
+}
+
 /* -- layouts · .td- Today (Run 3, slice 3B) -- */
 .td-board {
   display: flex;
@@ -7932,5 +7965,285 @@
    containers). The tab strip and the scratchpad are drawn with inline radii (workspace-cockpit-nav); the inline radii
    (8px tab strip, 6px controls) stay. A tab's colour dot is a dot and keeps its circle. */
 
+/* -- layouts · .wl- Welcome: the first-run page (onboarding-scan-and-map slice 2) -- */
+.wl-page {
+  background: var(--background);
+}
+.wl-body {
+  margin: 0;
+  background: var(--background);
+  color: var(--foreground);
+  font-family: var(--sans);
+  font-size: 16px;
+  line-height: 1.5;
+}
+.wl-wrap {
+  max-width: 720px;
+  margin: 0 auto;
+  padding: 24px 16px 64px;
+  box-sizing: border-box;
+}
+.wl-wrap * {
+  box-sizing: border-box;
+}
+.wl-steps {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px;
+  margin: 0 0 20px;
+  padding: 0;
+  list-style: none;
+  font-family: var(--mono);
+  font-size: 12px;
+  color: var(--muted-foreground);
+}
+.wl-steps li {
+  padding: 2px 8px;
+  border: 1px solid var(--border);
+  border-radius: 6px;
+}
+.wl-steps li[aria-current="step"] {
+  color: var(--foreground);
+  border-color: var(--foreground);
+}
+.wl-h1 {
+  font-size: 20px;
+  line-height: 1.2;
+  margin: 0 0 8px;
+  font-weight: 600;
+}
+.wl-h2 {
+  font-size: 16px;
+  margin: 0;
+  font-weight: 600;
+}
+.wl-p {
+  margin: 0 0 12px;
+}
+.wl-muted {
+  color: var(--muted-foreground);
+}
+.wl-card {
+  background: var(--card);
+  border: 1px solid var(--border);
+  border-radius: 8px;
+  padding: 14px 16px;
+  margin: 0 0 14px;
+}
+.wl-path {
+  font-family: var(--mono);
+  font-size: 12px;
+  color: var(--muted-foreground);
+  word-break: break-all;
+}
+.wl-promise {
+  font-family: var(--mono);
+  font-size: 12px;
+  margin: 16px 0;
+  padding: 10px 12px;
+  border-left: 3px solid var(--foreground);
+  background: var(--muted);
+}
+.wl-actions {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 12px;
+  margin-top: 18px;
+}
+.wl-btn {
+  font: inherit;
+  cursor: pointer;
+  border-radius: 8px;
+  padding: 10px 16px;
+  min-height: 44px;
+  border: 1px solid var(--border);
+  background: var(--secondary);
+  color: var(--foreground);
+  text-decoration: none;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+}
+.wl-btn.wl-primary {
+  background: var(--primary);
+  color: var(--primary-foreground);
+  border-color: var(--primary);
+  font-weight: 600;
+}
+.wl-btn:disabled {
+  opacity: 0.55;
+  cursor: default;
+}
+.wl-btn.wl-quiet {
+  background: none;
+  border: none;
+  color: var(--muted-foreground);
+  text-decoration: underline;
+  padding: 8px 4px;
+  min-height: 36px;
+}
+.wl-btn.wl-small {
+  min-height: 32px;
+  padding: 4px 10px;
+  font-size: 14px;
+}
+.wl-btn:focus-visible,
+.wl-input:focus-visible,
+.wl-check:focus-visible {
+  outline: 2px solid color-mix(in oklab, var(--ring) 50%, var(--foreground));
+  outline-offset: 2px;
+}
+.wl-spin {
+  display: inline-block;
+  width: 14px;
+  height: 14px;
+  border: 2px solid var(--border);
+  border-top-color: var(--foreground);
+  border-radius: 6px;
+  animation: wlspin 0.8s linear infinite;
+  margin-right: 8px;
+}
+@keyframes wlspin {
+  to {
+    transform: rotate(360deg);
+  }
+}
+.wl-error {
+  border: 1px solid var(--destructive);
+  color: var(--destructive);
+  border-radius: 8px;
+  padding: 10px 12px;
+  margin: 0 0 14px;
+}
+.wl-findings {
+  margin: 0;
+  padding-left: 22px;
+}
+.wl-findings li {
+  margin: 0 0 12px;
+}
+.wl-ref {
+  font-family: var(--mono);
+  font-size: 12px;
+  color: var(--muted-foreground);
+  word-break: break-all;
+}
+.wl-board > header {
+  display: flex;
+  flex-wrap: wrap;
+  justify-content: space-between;
+  gap: 8px;
+  align-items: baseline;
+  margin-bottom: 8px;
+}
+.wl-row {
+  display: grid;
+  grid-template-columns: auto 1fr;
+  gap: 6px 10px;
+  padding: 10px 0;
+  border-top: 1px solid var(--border);
+  align-items: start;
+}
+.wl-check {
+  width: 20px;
+  height: 20px;
+  margin: 10px 0 0;
+}
+.wl-input {
+  font: inherit;
+  color: var(--foreground);
+  background: var(--background);
+  border: 1px solid var(--input);
+  border-radius: 6px;
+  padding: 6px 8px;
+  min-height: 36px;
+  max-width: 100%;
+}
+.wl-row .wl-input[type="text"] {
+  width: 100%;
+}
+.wl-meta {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px 10px;
+  align-items: center;
+  font-family: var(--mono);
+  font-size: 12px;
+  color: var(--muted-foreground);
+}
+.wl-chip {
+  border: 1px solid var(--border);
+  border-radius: 6px;
+  padding: 1px 8px;
+}
+.wl-docs {
+  margin: 4px 0 0;
+  padding-left: 18px;
+  font-family: var(--mono);
+  font-size: 12px;
+  color: var(--muted-foreground);
+  word-break: break-all;
+}
+.wl-q {
+  margin: 0 0 14px;
+}
+.wl-label {
+  display: block;
+  margin: 4px 0;
+}
+.wl-q .wl-free {
+  margin-top: 10px;
+  color: var(--muted-foreground);
+}
+.wl-q .wl-free .wl-input {
+  display: block;
+  margin-top: 4px;
+}
+.wl-added {
+  margin: 8px 0 0;
+  padding-left: 18px;
+  font-size: 14px;
+}
+.wl-sources {
+  list-style: none;
+  margin: 0 0 12px;
+  padding: 0;
+  display: grid;
+  gap: 12px;
+}
+.wl-source {
+  display: flex;
+  flex-wrap: wrap;
+  justify-content: space-between;
+  align-items: center;
+  gap: 12px;
+  padding-bottom: 12px;
+  border-bottom: 1px solid var(--border);
+}
+.wl-source-text {
+  flex: 1 1 260px;
+  min-width: 0;
+}
+.wl-source-actions {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 8px;
+}
+@media (max-width: 520px) {
+  .wl-actions {
+    flex-direction: column;
+    align-items: stretch;
+  }
+  .wl-actions .wl-btn {
+    width: 100%;
+  }
+  .wl-actions .wl-btn.wl-quiet {
+    width: auto;
+    align-self: center;
+  }
+}
+
 /* -- layouts · .cal3- the console3 Calendar page (calendar-time-page): its rules sit in console3.css beside the .vday rules they extend -- */
 /* -- end of the layout sections: add nothing below this line -- */

package/workspace/public/pm/dest-settings.js

@@ -33,6 +33,7 @@ import { COPY } from './frame-copy.js';
 import { askConfirm } from './dialogs.js';
 import { icon } from './icons.js';
 import { flagPicker, flagsLine, flagsMissingValue } from './flag-picker.js';
+import { freshnessTable } from './freshness-line.js';
 
 const P = COPY.page;
 const roots = new WeakMap();      // host -> { root, sig }
@@ -542,6 +543,13 @@ function checkButton(scope) {
   });
 }
 
+/* ── Data freshness (workspace-data-freshness R9): how old each source is, Refresh, and the change detector switch ── */
+function freshnessSection(scope) {
+  const ws = wsOfRepo(scope === 'all' ? null : activeProduct());
+  if (!ws) return section('freshness', 'Data freshness', [empty({ text: 'Open a repository to see how old its data is.' })], null, 'refresh-cw');
+  return section('freshness', 'Data freshness', [freshnessTable(ws)], null, 'refresh-cw');
+}
+
 /* ── mount ────────────────────────────────────────────────────────────────────────────────────────────────────────── */
 
 function signature(scope) {
@@ -583,7 +591,8 @@ export function mountDestination(host, ctx) {
       peopleSection(scope),
       onlineSection(),
       themeSection(),
-      updatesSection(scope)),
+      updatesSection(scope),
+      freshnessSection(scope)),
   ]);
 }
 

package/workspace/public/pm/freshness-line.js

@@ -0,0 +1,123 @@
+/* pm/freshness-line.js — how old each source of the workspace is (workspace-data-freshness R9).
+ *
+ *   freshnessLine(ws)   → element   the console header's short line: the sources that are old or never read, else
+ *                                   "Up to date"; a Refresh button for the oldest one. Updates itself every 15 s.
+ *   freshnessTable(ws)  → element   Settings › Data freshness: every source, when it was read, its state, its schedule,
+ *                                   Refresh, and the repository's Watch for changes switch.
+ *
+ * Both read GET /api/sources (lib/routes-sources.js). The presses go through pmPost (the page nonce), so an agent cannot
+ * make them. When a workspace's data version moves, the line sends `pmos:data-changed` with { ws } on window, so a view
+ * that wants to read again only on a change can listen for it. One element per ws and kind, kept across redraws, so a
+ * page that rebuilds its DOM does not start a second poll.
+ */
+import { el, setChildren } from './dom.js';
+import { pmGet, pmPost } from './http.js';
+import { button, SEL } from './primitives.js';
+
+const POLL_MS = 15000;
+const live = new Map();   // kind|ws -> { node, timer, version }
+
+const hhmm = (iso) => { const d = new Date(iso); return String(d.getHours()).padStart(2, '0') + ':' + String(d.getMinutes()).padStart(2, '0'); };
+function ago(iso) {
+  if (!iso) return 'never read';
+  const ms = Date.now() - Date.parse(iso);
+  if (ms < 60000) return 'just now';
+  if (ms < 3600000) return Math.round(ms / 60000) + ' min ago';
+  if (ms < 24 * 3600000) return 'today ' + hhmm(iso);
+  return Math.round(ms / (24 * 3600000)) + ' d ago';
+}
+const STATE_WORD = { fresh: 'Up to date', stale: 'Old', never: 'Never read', building: 'Reading…', failed: 'Failed', off: 'Off' };
+// the colour of a state: a class in components.css (.fr-fresh__state--<state>), coloured from the tokens
+const tone = (state) => 'fr-fresh__state fr-fresh__state--' + (STATE_WORD[state] ? state : 'never');
+const label = (b, t) => { const l = b.querySelector(SEL.btnLabel); (l || b).textContent = t; };
+
+async function read(ws) {
+  const r = await pmGet('/api/sources' + (ws ? '?ws=' + encodeURIComponent(ws) : ''));
+  return r && r.ok ? r : null;
+}
+async function refresh(ws, source, btn) {
+  if (btn) { btn.disabled = true; label(btn, 'Starting…'); }
+  const r = await pmPost('/api/sources/refresh', { ws, source });
+  if (btn) label(btn, r && r.ok ? (r.started === 'session' ? 'Agent started' : 'Reading…') : 'Could not start');
+  return r;
+}
+
+function poll(key, ws, draw) {
+  let cur = live.get(key);
+  if (cur) return cur.node;
+  cur = { node: null, timer: null, version: null };
+  live.set(key, cur);
+  const tick = async () => {
+    const d = await read(ws).catch(() => null);
+    if (d) {
+      if (cur.version != null && d.version !== cur.version) {
+        try { window.dispatchEvent(new CustomEvent('pmos:data-changed', { detail: { ws: d.ws } })); } catch { /* no window */ }
+      }
+      cur.version = d.version;
+    }
+    draw(cur.node, d);
+  };
+  cur.tick = tick;
+  cur.node = draw(null, null);
+  tick();
+  cur.timer = setInterval(() => { if (!cur.node.isConnected && cur.node.dataset.mounted === '1') { clearInterval(cur.timer); live.delete(key); return; } if (cur.node.isConnected) cur.node.dataset.mounted = '1'; tick(); }, POLL_MS);
+  return cur.node;
+}
+
+/** The header line: quiet when everything is fresh, amber names when a source is old or never read. */
+export function freshnessLine(ws) {
+  return poll('line|' + ws, ws, (node, d) => {
+    const n = node || el('div', { class: 'fr-fresh', 'data-c3pg': 'freshness' });
+    if (!d) { if (!node) n.textContent = ''; return n; }
+    const watched = d.sources.filter((s) => s.state !== 'off');
+    const behind = watched.filter((s) => s.state === 'stale' || s.state === 'failed' || (s.state === 'never' && s.schedule));
+    const building = watched.find((s) => s.state === 'building');
+    const kids = [];
+    if (!behind.length) kids.push(el('span', { class: tone('fresh') }, building ? 'Reading the repository…' : 'Data up to date'));
+    for (const s of behind.slice(0, 3)) kids.push(el('span', { class: tone(s.state), title: STATE_WORD[s.state] }, s.label + ' ' + ago(s.as_of)));
+    if (behind.length) {
+      const first = behind[0];
+      const btn = button({ label: 'Refresh ' + first.label, size: 'sm', attrs: { 'data-c3pg': 'freshness-refresh' },
+        onClick: () => refresh(d.ws, first.id, btn) });
+      kids.push(btn);
+    }
+    setChildren(n, kids);
+    return n;
+  });
+}
+
+/** The Settings table: every source of the workspace, with Refresh, and the change detector switch. */
+export function freshnessTable(ws) {
+  return poll('table|' + ws, ws, (node, d) => {
+    const n = node || el('div', { class: 'fr-fresh-table', 'data-fr': 'freshness' });
+    if (!d) { if (!node) n.textContent = 'Reading…'; return n; }
+    const th = (t) => el('th', null, t);
+    const td = (...k) => el('td', null, ...k);
+    const rows = d.sources.map((s) => {
+      const btn = button({ label: 'Refresh', size: 'sm', disabled: s.state === 'off' || s.state === 'building',
+        attrs: { 'data-fr': 'freshness-refresh-' + s.id }, onClick: () => refresh(d.ws, s.id, btn) });
+      const sched = s.schedule ? [s.schedule.cadence, s.schedule.day, s.schedule.time].filter(Boolean).join(' ') : (s.skill ? 'no schedule' : 'on every change');
+      return el('tr', { 'data-fr-source': s.id },
+        td(s.label), td(s.id === 'repository' && s.state === 'fresh' ? 'watching' : s.as_of ? ago(s.as_of) : 'never'), td(el('span', { class: tone(s.state) }, STATE_WORD[s.state] || s.state)),
+        td(sched), td(btn));
+    });
+    const repo = d.sources.find((s) => s.id === 'repository');
+    const on = !repo || repo.state !== 'off';
+    // a button, not a checkbox: on a phone every control is 44px high (R27), and a checkbox box is not
+    const sw = button({ label: on ? 'Stop watching this repository' : 'Watch this repository for changes', size: 'sm',
+      attrs: { 'data-fr': 'freshness-watch', 'aria-pressed': on ? 'true' : 'false', class: 'fr-fresh-table__watch' },
+      onClick: async () => {
+        sw.disabled = true;
+        const r = await pmPost('/api/sources/watch', { ws: d.ws, on: !on });
+        if (r && r.ok) { const c = live.get('table|' + ws); if (c) c.tick(); } else { sw.disabled = false; label(sw, 'Could not save'); }
+      } });
+    setChildren(n, [
+      el('table', { class: 'fr-fresh-table__grid' },
+        el('thead', null, el('tr', null, th('Source'), th('Read'), th('State'), th('Schedule'), th(''))),
+        el('tbody', null, ...rows)),
+      sw,
+      el('p', { class: 'fr-set__note' }, 'The workspace holds no password or token. Calendar, Jira and My work are read by an agent session with your own connection.'),
+    ]);
+    return n;
+  });
+}