create-pmos 0.204.0 → 0.205.0

package/workspace/extension/popup.js

@@ -0,0 +1,195 @@
+/* popup.js — the PMOS button's popup (popup.html): "Add this page to a report design".
+ * PMOS draws the popup: the page is one frame, ${address}/c3.html?capture=1&pop=1&…, which lists the reports and has the Add button. The extension never posts to PMOS
+ * itself, because every PMOS write needs a press on a PMOS page (a nonce and an Origin check). So when the frame asks (postMessage { pmosCapture: 'request' }), this
+ * page takes the open tab and posts it back to the frame ({ pmosCapture: 'data', … }), and the frame uploads it with its own press. Both ways, the message must
+ * come from the other window and from the PMOS origin; the extension posts to the PMOS origin only.
+ *   Google Slides and Google Docs  → the PDF, fetched here with the user's own Google cookies (host permission for https://docs.google.com/*)
+ *   any other page                 → pictures of the whole page, scrolled top to bottom: at most 8, JPEG, 650 ms apart (Chrome's capture rate limit), scroll put back after
+ * When nothing answers at the address, this page says so and offers Try again. Nothing else is fetched. */
+(function () {
+  'use strict';
+  var A = window.PMOS_ADDRESS;
+  var C = window.PMOS_CAPTURE;
+  var CHECK_MS = 4000;     // how long to wait for PMOS to answer
+  var READY_MS = 8000;     // how long to wait for the frame to say it is drawn
+  var SETTLE_MS = 300;     // after a scroll, before the picture
+  var msg = document.getElementById('msg');
+  var frame = null;
+  var frameOrigin = '';
+  var readyTimer = null;
+  var busy = false;
+  var current = null;      // { tab, kind, address }
+
+  function readAddress(done) {
+    var fallback = A.DEFAULT_ADDRESS;
+    try {
+      var o = {}; o[A.KEY] = fallback;
+      chrome.storage.sync.get(o, function (v) { done(A.normalizeAddress(v && v[A.KEY]) || fallback); });
+    } catch (e) { done(fallback); }
+  }
+  function getTab(done) {
+    try { chrome.tabs.query({ active: true, currentWindow: true }, function (t) { done((t && t[0]) || null); }); } catch (e) { done(null); }
+  }
+  /** Resolves when something answers at the address (an opaque no-cors reply is enough), rejects when nothing listens. */
+  function answers(addr) {
+    var ctl = typeof AbortController === 'function' ? new AbortController() : null;
+    var t = ctl ? setTimeout(function () { ctl.abort(); }, CHECK_MS) : null;
+    return fetch(addr + '/c3.html', { mode: 'no-cors', cache: 'no-store', signal: ctl ? ctl.signal : undefined })
+      .then(function (r) { if (t) clearTimeout(t); return r; }, function (e) { if (t) clearTimeout(t); throw e; });
+  }
+  var sleep = function (ms) { return new Promise(function (r) { setTimeout(r, ms); }); };
+
+  /* ── the popup's own states ── */
+  function head(host) {
+    var h = document.createElement('div'); h.className = 'head';
+    var b = document.createElement('b'); b.textContent = 'PMOS'; h.appendChild(b);
+    var s = document.createElement('span'); s.textContent = 'Add this page to a report design'; h.appendChild(s);
+    host.appendChild(h);
+  }
+  function show(text, withRetry, extra) {
+    if (frame) { frame.remove(); frame = null; }
+    clearTimeout(readyTimer);
+    msg.textContent = '';
+    msg.className = 'msg';
+    if (!msg.parentNode) document.body.appendChild(msg);
+    head(msg);
+    var p = document.createElement('p'); p.textContent = text; msg.appendChild(p);
+    if (extra) msg.appendChild(extra);
+    if (withRetry) {
+      var b = document.createElement('button'); b.type = 'button'; b.textContent = 'Try again'; b.setAttribute('data-act', 'retry');
+      b.addEventListener('click', function () { start(); });
+      msg.appendChild(b);
+    }
+  }
+  function showDown(addr) {
+    var a = document.createElement('a'); a.href = '#'; a.textContent = 'Set the address';
+    a.addEventListener('click', function (e) { e.preventDefault(); try { chrome.runtime.openOptionsPage(); } catch (x) { /* no options page */ } });
+    show('PMOS is not answering at ' + addr + '. Start PMOS, then try again.', true, a);
+  }
+
+  /* ── the frame ── */
+  function post(m) {
+    if (!frame || !frame.contentWindow || !C.validOutgoing(m)) return false;
+    frame.contentWindow.postMessage(m, frameOrigin);
+    return true;
+  }
+  function showFrame(tab, kind, addr, screens) {
+    var q = new URLSearchParams({ capture: '1', pop: '1', pkind: kind, ptitle: C.sampleName(tab.title, tab.url), purl: tab.url || '' });
+    if (screens) q.set('pscreens', String(screens));
+    frame = document.createElement('iframe');
+    frame.title = 'PMOS: add this page to a report design';
+    frame.src = addr + '/c3.html?' + q.toString();
+    frameOrigin = new URL(addr).origin;
+    if (msg.parentNode) msg.remove();
+    document.body.appendChild(frame);
+    // an older PMOS answers but has no capture page: it never says ready
+    readyTimer = setTimeout(function () { showDown(addr); }, READY_MS);
+  }
+
+  /* ── what is taken ── */
+  var toBase64 = function (buf) {
+    var bytes = new Uint8Array(buf); var s = '';
+    for (var i = 0; i < bytes.length; i += 0x8000) s += String.fromCharCode.apply(null, bytes.subarray(i, i + 0x8000));
+    return btoa(s);
+  };
+  var run = function (tabId, func, args) {
+    return chrome.scripting.executeScript({ target: { tabId: tabId }, func: func, args: args || [] }).then(function (r) { return r && r[0] ? r[0].result : undefined; });
+  };
+  var measure = function () { var d = document.documentElement; var b = document.body; return { h: Math.max(d ? d.scrollHeight : 0, b ? b.scrollHeight : 0), vh: window.innerHeight, y: window.scrollY }; };
+  var scrollTo = function (y) { window.scrollTo({ top: y, left: 0, behavior: 'instant' }); return window.scrollY; };
+
+  function takePdf(tab, kind) {
+    var url = C.exportUrl(tab.url);
+    post({ pmosCapture: 'progress', text: 'Getting the PDF from Google', step: 1, of: 3 });
+    return fetch(url, { credentials: 'include', cache: 'no-store', redirect: 'follow' }).then(function (r) {
+      if (!r.ok) throw new Error('Google did not give the PDF (' + r.status + '). Open the file in Chrome while signed in to Google, then try again.');
+      return r.arrayBuffer();
+    }, function () { throw new Error('Chrome could not reach Google to get the PDF. Check the connection, then try again.'); }).then(function (buf) {
+      var bytes = new Uint8Array(buf);
+      if (!(bytes[0] === 0x25 && bytes[1] === 0x50 && bytes[2] === 0x44 && bytes[3] === 0x46)) throw new Error('Google did not give a PDF. Sign in to Google in this Chrome, make sure you can open the file, then try again.');
+      if (bytes.length > C.MAX_BYTES) throw new Error('The PDF is over 20 MB. PMOS keeps a sample up to 20 MB. Add a smaller copy.');
+      post({ pmosCapture: 'progress', text: 'Reading the PDF', step: 2, of: 3 });
+      var pages = C.pdfPageCount(bytes);
+      return { pmosCapture: 'data', kind: 'pdf', name: C.sampleName(tab.title, tab.url), url: tab.url, pages: pages || undefined, data: toBase64(buf) };
+    });
+  }
+
+  function takePictures(tab) {
+    var tabId = tab.id; var windowId = tab.windowId;
+    var start = null; var pics = []; var bytes = 0; var last = 0;
+    return run(tabId, measure).then(function (m) {
+      if (!m || !m.vh) throw new Error('Chrome does not let PMOS read this page.');
+      start = m.y || 0;
+      var plan = C.scrollPlan(m.h, m.vh, C.MAX_PICTURES);
+      var n = plan.offsets.length;
+      var chain = Promise.resolve();
+      plan.offsets.forEach(function (y, i) {
+        chain = chain.then(function () {
+          post({ pmosCapture: 'progress', text: 'Picture ' + (i + 1) + ' of ' + n + (i ? ', scrolling down' : ''), step: i + 1, of: n + 1 });
+          return run(tabId, scrollTo, [y]);
+        }).then(function () {
+          var wait = Math.max(SETTLE_MS, C.MIN_GAP_MS - (Date.now() - last));
+          return sleep(wait);
+        }).then(function () {
+          last = Date.now();
+          return chrome.tabs.captureVisibleTab(windowId, { format: 'jpeg', quality: 80 });
+        }).then(function (dataUrl) {
+          var b64 = String(dataUrl || '').replace(/^data:[^,]*,/, '');
+          if (!b64) throw new Error('Chrome did not give a picture of the page.');
+          bytes += C.base64Bytes(b64);
+          if (bytes > C.MAX_BYTES) throw new Error('The pictures are over 20 MB. PMOS keeps a sample up to 20 MB. Open a shorter page, or add it as a PDF.');
+          pics.push(b64);
+        });
+      });
+      return chain;
+    }).then(function () {
+      return { pmosCapture: 'data', kind: 'pictures', name: C.sampleName(tab.title, tab.url), url: tab.url, pictures: pics };
+    }).then(function (out) { return restore(tabId, start).then(function () { return out; }); },
+      function (e) { return restore(tabId, start).then(function () { throw e; }); });
+  }
+  function restore(tabId, y) { return y == null ? Promise.resolve() : run(tabId, scrollTo, [y]).catch(function () { /* the page went away */ }); }
+
+  function capture() {
+    if (busy || !current) return;
+    busy = true;
+    var tab = current.tab;
+    var job = C.exportUrl(tab.url) ? takePdf(tab, current.kind) : takePictures(tab);
+    job.then(function (out) {
+      post({ pmosCapture: 'progress', text: 'Sending it to PMOS', step: out.kind === 'pdf' ? 3 : (out.pictures.length + 1), of: out.kind === 'pdf' ? 3 : (out.pictures.length + 1) });
+      if (!post(out)) throw new Error('The page could not be sent to PMOS.');
+    }).catch(function (e) {
+      post({ pmosCapture: 'error', error: String((e && e.message) || 'The page could not be taken.') });
+    }).then(function () { busy = false; });
+  }
+
+  window.addEventListener('message', function (e) {
+    var m = C.fromFrame(e, frame && frame.contentWindow, frameOrigin);
+    if (!m) return;
+    if (m.pmosCapture === 'ready') { clearTimeout(readyTimer); return; }
+    if (m.pmosCapture === 'resize') { if (frame) frame.style.height = m.height + 'px'; return; }
+    if (m.pmosCapture === 'close') { window.close(); return; }
+    if (m.pmosCapture === 'open') {
+      try { chrome.tabs.create({ url: frameOrigin + '/c3.html?studio=' + encodeURIComponent(m.report) }); } catch (x) { /* no tabs */ }
+      window.close();
+      return;
+    }
+    if (m.pmosCapture === 'request') capture();
+  });
+
+  function start() {
+    busy = false;
+    readAddress(function (addr) {
+      getTab(function (tab) {
+        var kind = tab ? C.classifyUrl(tab.url) : 'blocked';
+        if (!tab || kind === 'blocked') { show('Chrome does not let PMOS read this page. Open a web page, such as a Google Slides deck or any site, then press the PMOS button.', false); return; }
+        current = { tab: tab, kind: kind, address: addr };
+        var go = function (screens) {
+          answers(addr).then(function () { showFrame(tab, C.pageKind(tab.url), addr, screens); }, function () { showDown(addr); });
+        };
+        if (kind !== 'other') { go(0); return; }
+        run(tab.id, measure).then(function (m) { go(m && m.vh ? C.scrollPlan(m.h, m.vh, 1000).total : 0); }, function () { go(0); });
+      });
+    });
+  }
+  start();
+})();

package/workspace/guide/report-design.md

@@ -22,7 +22,7 @@ Use one of these two buttons:
 
 1. Select **Deck** or **Document** at the top of the studio.
 2. Write what the report is for and who reads it. For example: "This goes to the progress session every other Thursday. The decisions must stand out."
-3. Press **Add a sample** to give PMOS a report that people liked. You can upload a file, paste a link, or pick a report document that PMOS has. Each sample shows what PMOS took from it. PMOS reads a link from Google Slides, Docs or Sheets, or from Confluence, through your own connectors. It saves the words and the structure (slide titles, order, sections and tables), and it changes nothing in the file. It does not get the look. To match the look, also add the file as a PDF or a screenshot. For Google Slides, choose **File**, **Download**, **PDF document (.pdf)** in Slides, then add that file. If your connectors cannot read the link, the sample says so. Any other link is kept by its address, and PMOS cannot open it. PMOS sees the pages of a PDF or an image, so it can follow their look. From a .pptx or a .docx, PMOS gets only the words.
+3. Press **Add a sample** to give PMOS a report that people liked. You can upload a file, paste a link, add a page from Chrome (see below), or pick a report document that PMOS has. Each sample shows what PMOS took from it. PMOS reads a link from Google Slides, Docs or Sheets, or from Confluence, through your own connectors. It saves the words and the structure (slide titles, order, sections and tables), and it changes nothing in the file. It does not get the look. To match the look, also add the file as a PDF or a screenshot. For Google Slides, choose **File**, **Download**, **PDF document (.pdf)** in Slides, then add that file. If your connectors cannot read the link, the sample says so. Any other link is kept by its address, and PMOS cannot open it. PMOS sees the pages of a PDF or an image, so it can follow their look. From a .pptx or a .docx, PMOS gets only the words.
 4. Press **Make the next version**. PMOS makes a version from your words and this cycle's data. This takes a short time. You can leave the studio. The studio shows when the version is ready.
 5. Read the version in the preview. Write what to change and press **Make the next version** again. Each turn makes a new version: D1, D2, D3 and so on.
 
@@ -30,6 +30,20 @@ To set the width of the studio, use **Half**, **3/4** or **Whole** at the top ri
 
 If a turn fails, the studio shows why. Nothing changes. Try the turn again.
 
+
+### Add a page from Chrome
+
+You can add the page you are looking at in Chrome, on any website, as a sample. This needs the PMOS extension in Chrome. Run `pmos extension` in a terminal for the steps to load it.
+
+1. In Chrome, open the page, for example a Google Slides deck, a Google Doc or a Confluence page.
+2. Press the **PMOS** button in the Chrome toolbar. The popup says "Add this page to a report design".
+3. Choose the report in the **Report** list. It starts on the report whose design studio you opened last.
+4. Press **Add as a sample**. Keep the popup open while it saves. When it says "Added to" and the name of the report, press **Open the studio**.
+
+A Google Slides deck or a Google Doc comes to PMOS as a PDF, so PMOS can follow its look. The sample reads "From Chrome, PDF, 12 slides", or "pages" for a document. Chrome asks Google for the PDF with your own Google sign-in. Any other page comes as pictures of the whole page, scrolled top to bottom, at most 8 pictures. The sample reads "From Chrome, 3 page pictures". PMOS reads every picture, and follows its look as it does for a PDF. A sample is at most 20 MB. If the page is bigger, the popup says so: open a shorter page, or add a smaller copy.
+
+The sample shows in a design studio that is already open, in a few seconds. If the popup says "PMOS is not answering", start PMOS and press **Try again**. Nothing leaves your computer: the popup sends the page only to your own PMOS.
+
 ### Point at a part
 
 Keep **Point and say** on. Click a part of the preview and write what to change there. A numbered marker shows the spot. Your next turn sends the markers with your words.

package/workspace/lib/extension-cli.js

@@ -1,5 +1,5 @@
 'use strict';
-/* extension-cli.js — `pmos extension`: where the Chrome extension for Google Meet is, and how to load it (initiative c3-meet-extension).
+/* extension-cli.js — `pmos extension`: where the PMOS Chrome extension is (the Meet panel and the button that adds a page to a report design), and how to load it (initiatives c3-meet-extension, report-design-studio).
  *
  *   pmos extension    print the absolute path of workspace/extension and the steps to load it in Chrome
  *
@@ -10,20 +10,22 @@ const path = require('path');
 
 const COMMANDS = { extension: [] };
 const FOLDER = path.resolve(__dirname, '..', 'extension');
-const USAGE = ['usage: pmos extension — the Chrome extension that shows the meeting companion over a Google Meet call'];
+const USAGE = ['usage: pmos extension — the Chrome extension: the meeting companion over a Google Meet call, and a button that adds a page to a report design'];
 
 /** The lines `pmos extension` prints for a folder. Pure. */
 function lines(folder, exists = true) {
   const out = [];
   if (!exists) { out.push(`✗ the extension folder is not here: ${folder}`, '  Reinstall the workspace with `pmos upgrade`.'); return out; }
-  out.push('PMOS for Google Meet (Chrome)', '', `  folder  ${folder}`, '',
+  out.push('PMOS for Chrome', '', `  folder  ${folder}`, '',
     'Load it in three steps:',
     '  1. In Chrome, open chrome://extensions',
     '  2. Turn on Developer mode (top right)',
     '  3. Press Load unpacked, then pick the folder above',
     '',
     'PMOS is looked for at http://localhost:7433. If pmos printed another port, open the extension\'s Options and set that address.',
-    'Then open a Google Meet call: the panel shows at the bottom right.');
+    'Then open a Google Meet call: the panel shows at the bottom right.',
+    'To add a page to a report design, open any page and press the PMOS button in the toolbar. Choose the report, then Add as a sample.',
+    'After an update, press the reload arrow on the extension\'s card in chrome://extensions.');
   return out;
 }
 

package/workspace/lib/report-design.js

@@ -47,7 +47,8 @@ const issues = require('./issues.js');
 
 const EVENTS = Object.freeze(['describe', 'sample', 'fetched', 'took', 'turn', 'version', 'accept', 'revert', 'error', 'cycle-decision']);
 const FORMATS = Object.freeze(['deck', 'doc']);
-const SAMPLE_KINDS = Object.freeze(['pdf', 'pptx', 'docx', 'image', 'link', 'pmos-doc']);
+const SAMPLE_KINDS = Object.freeze(['pdf', 'pptx', 'docx', 'image', 'pictures', 'link', 'pmos-doc']);
+const MAX_PICTURES = 12;
 const MAX_SAMPLE_BYTES = 20 * 1024 * 1024;
 const MAX_THUMB_BYTES = 256 * 1024;
 const MAX_TEXT = 4000;
@@ -118,7 +119,8 @@ function fold(events) {
       if (FORMATS.includes(l.format)) st.format = l.format;
       st.log.push({ at: l.at, who: 'you', kind: 'describe', text: str(l.text) });
     } else if (l.ev === 'sample') {
-      st.samples.set(l.id, { id: l.id, name: str(l.name), kind: l.kind, source: str(l.source), ext: str(l.ext), took: null, readable: l.readable !== false, at: l.at });
+      st.samples.set(l.id, { id: l.id, name: str(l.name), kind: l.kind, source: str(l.source), ext: str(l.ext), took: null, readable: l.readable !== false, at: l.at,
+        ...(l.via === 'chrome' ? { via: 'chrome' } : {}), ...(Number.isInteger(l.count) ? { count: l.count } : {}), ...(Number.isInteger(l.pages) ? { pages: l.pages } : {}) });
       st.log.push({ at: l.at, who: 'you', kind: 'sample', text: str(l.name), sample: l.id });
     } else if (l.ev === 'fetched') {
       const s = st.samples.get(l.id);
@@ -220,6 +222,32 @@ function addSample(root, cadence, input, { actor, now } = {}) {
     writeAtomic(path.join(p.samples, `${id}.md`), text);
     const fm = /^---\r?\n[\s\S]*?\btitle:\s*["']?([^\n"']+)/.exec(text);
     rec = { id, name: oneLine(input.name || (fm ? fm[1] : rel.split('/').slice(-2).join(' ')), 120), kind: 'pmos-doc', source: rel, ext: 'md', readable: true, thumb: null, text_file: null };
+  } else if (str(input.kind) === 'pictures' || Array.isArray(input.pictures)) {
+    // pictures of a whole page, scrolled top to bottom, from the Chrome extension (the page frames PMOS; see extension/popup.js)
+    const list = Array.isArray(input.pictures) ? input.pictures : null;
+    if (str(input.kind) !== 'pictures' || !list || !list.length) return refuse(400, 'pictures needs kind "pictures" and a list of pictures (base64 JPEG or PNG)');
+    if (list.length > MAX_PICTURES) return refuse(400, `at most ${MAX_PICTURES} pictures in one sample`);
+    const bufs = [];
+    let total = 0;
+    for (const [i, raw] of list.entries()) {
+      if (typeof raw !== 'string' || !raw) return refuse(400, `picture ${i + 1} is empty`);
+      const b64 = raw.replace(/^data:[^,]*,/, '');
+      total += Math.floor(b64.length * 3 / 4);
+      if (total > MAX_SAMPLE_BYTES + 4 * list.length) return refuse(413, 'a sample is at most 20 MB');
+      const buf = Buffer.from(b64, 'base64');
+      const s = buf.length ? sniff(buf) : null;
+      if (!s || s.kind !== 'image') return refuse(415, `picture ${i + 1} must be a PNG or a JPG`);
+      bufs.push({ buf, ext: s.ext });
+    }
+    if (bufs.reduce((n, b) => n + b.buf.length, 0) > MAX_SAMPLE_BYTES) return refuse(413, 'a sample is at most 20 MB');
+    fs.mkdirSync(p.samples, { recursive: true });
+    const files = bufs.map((b, i) => { const f = `${id}-${i + 1}.${b.ext}`; writeAtomic(path.join(p.samples, f), b.buf); return f; });
+    const first = bufs[0];
+    const thumb = first.buf.length <= MAX_THUMB_BYTES ? `data:image/${first.ext === 'jpg' ? 'jpeg' : 'png'};base64,${first.buf.toString('base64')}` : null;
+    const src = typeof input.source_url === 'string' ? input.source_url.trim() : '';
+    const u = parseUrl(src);
+    const source = u && /^https?:$/.test(u.protocol) && src.length <= 2000 ? src : 'upload';
+    rec = { id, name: oneLine(input.name || 'Page pictures', 120), kind: 'pictures', source, ext: first.ext, count: files.length, files, via: 'chrome', bytes: bufs.reduce((n, b) => n + b.buf.length, 0), readable: true, thumb, text_file: null };
   } else {
     const kind = str(input.kind);
     if (!['pdf', 'pptx', 'docx', 'image'].includes(kind)) return refuse(400, 'kind must be pdf, pptx, docx or image (or send a link, or a report doc)');
@@ -244,19 +272,42 @@ function addSample(root, cadence, input, { actor, now } = {}) {
       try { thumb = ooxmlThumb(buf); } catch { thumb = null; }
     }
     rec = { id, name: oneLine(input.name || `${kind} sample`, 120), kind, source: 'upload', ext, bytes: buf.length, readable, thumb, text_file: textFile };
+    if (kind === 'pdf' && input.from === 'chrome') {
+      // a PDF the Chrome extension fetched: where it came from and how many pages it has
+      const src = typeof input.source_url === 'string' ? input.source_url.trim() : '';
+      const u = parseUrl(src);
+      if (u && /^https?:$/.test(u.protocol) && src.length <= 2000) rec.source = src;
+      rec.via = 'chrome';
+      const n = Number(input.pages);
+      if (Number.isInteger(n) && n > 0 && n < 5000) rec.pages = n;
+    }
   }
   writeAtomic(path.join(p.samples, `${id}.json`), JSON.stringify({ ...rec, took: null, added_at: iso(now) }, null, 2) + '\n');
-  append(root, cadence, { ev: 'sample', id, name: rec.name, kind: rec.kind, source: rec.source, ext: rec.ext, readable: rec.readable }, { actor, now });
+  append(root, cadence, { ev: 'sample', id, name: rec.name, kind: rec.kind, source: rec.source, ext: rec.ext, readable: rec.readable,
+    ...(rec.via ? { via: rec.via } : {}), ...(rec.count ? { count: rec.count } : {}), ...(rec.pages ? { pages: rec.pages } : {}) }, { actor, now });
   return { ok: true, sample: sampleOut(rec) };
 }
 function sampleOut(s, { fetching } = {}) {
   const out = { id: s.id, name: s.name, kind: s.kind, source: s.source, took: s.took || null, thumb: typeof s.thumb === 'string' && s.thumb.startsWith('data:image/') ? s.thumb : null, readable: s.readable !== false };
+  if (s.via === 'chrome') {
+    out.via = 'chrome';
+    out.line = chromeLine(s);
+    if (s.count) out.count = s.count;
+    if (s.pages) out.pages = s.pages;
+  }
   if (s.kind === 'link') {
     if (fetching) { out.fetching = true; out.hint = 'PMOS is reading this link with your connectors.'; }
     else out.hint = linkHint(s.source, { fetched: !!(s.text_file && s.fetched), reason: s.fetch_reason });
   }
   return out;
 }
+/** The kind line of a sample the Chrome extension added: 'From Chrome, PDF, 12 slides' | 'From Chrome, PDF, 3 pages' | 'From Chrome, 3 page pictures'. */
+function chromeLine(s) {
+  if (s.kind === 'pictures') { const n = s.count || 0; return n ? `From Chrome, ${n} page ${n === 1 ? 'picture' : 'pictures'}` : 'From Chrome, page pictures'; }
+  const g = googleOf(parseUrl(s.source));
+  const n = s.pages || 0;
+  return n ? `From Chrome, PDF, ${n} ${g && g[2] === 'Slides' ? (n === 1 ? 'slide' : 'slides') : (n === 1 ? 'page' : 'pages')}` : 'From Chrome, PDF';
+}
 /* Google files: name them for what they are, and say which download PMOS can read */
 // a PDF, because the job sees its pages; from a .pptx or .docx it gets the words only, not the look
 const GOOGLE = [[/^\/presentation\//, 'Google Slides deck', 'Slides'], [/^\/document\//, 'Google Docs document', 'Docs'], [/^\/spreadsheets\//, 'Google Sheets sheet', 'Sheets']];
@@ -309,6 +360,13 @@ function recordTook(root, cadence, id, took, readable, { now } = {}) {
 /** The file the job reads for a sample: the pdf or image itself, the extracted words of a .pptx/.docx, the copy of a report doc, the text copy of a fetched link; null for any other link. */
 function sampleReadPath(root, cadence, s) {
   const p = paths(root, cadence);
+  if (s.kind === 'pictures') {
+    // every picture of the page, in order (samples/<id>-1.jpg, <id>-2.jpg, …); null when none is there
+    let names = [];
+    try { names = fs.readdirSync(p.samples).filter((f) => f.startsWith(`${s.id}-`) && /^\d+\.(jpg|png)$/.test(f.slice(s.id.length + 1))); } catch { names = []; }
+    names.sort((a, b) => parseInt(a.slice(s.id.length + 1), 10) - parseInt(b.slice(s.id.length + 1), 10));
+    return names.length ? names.map((f) => path.join(p.samples, f)) : null;
+  }
   if (s.kind === 'link') { const f = path.join(p.samples, `${s.id}.txt`); return s.fetched && fs.existsSync(f) ? f : null; }
   if (s.kind === 'pptx' || s.kind === 'docx') { const f = path.join(p.samples, `${s.id}.txt`); return fs.existsSync(f) ? f : null; }
   const f = path.join(p.samples, `${s.id}.${s.ext}`);
@@ -352,7 +410,7 @@ function writeBrief(root, cadence, setup, { now } = {}) {
     '## Description', '', st.description ? st.description : 'No description was given.', '', '## Samples', ''];
   const samples = [...st.samples.values()];
   if (!samples.length) lines.push('No samples.');
-  for (const s of samples) lines.push(`- ${s.name} (${s.kind}${s.kind === 'link' || s.kind === 'pmos-doc' ? ', ' + s.source : ''}): ${s.took ? 'PMOS took ' + s.took : (s.readable ? 'nothing taken yet' : 'could not be read')}`);
+  for (const s of samples) lines.push(`- ${s.name} (${s.kind}${s.kind === 'link' || s.kind === 'pmos-doc' ? ', ' + s.source : ''}${s.via === 'chrome' ? ', from Chrome' : ''}): ${s.took ? 'PMOS took ' + s.took : (s.readable ? 'nothing taken yet' : 'could not be read')}`);
   lines.push('', '## Reference outline', '');
   for (const o of (Array.isArray(meta.outline) ? meta.outline : [])) lines.push(`- ${o.id} (${o.kind || 'slide'}): ${o.title || ''}`);
   const sec = (h, list) => { lines.push('', `## ${h}`, ''); if (!list || !list.length) lines.push('None written yet.'); else for (const x of list) lines.push(`- ${x}`); };

package/workspace/lib/routes-report-design.js

@@ -5,6 +5,8 @@
  *   GET  /api/report-design/version?ws&id&n       → text/html, the sanitized render of D<n>
  *   POST /api/report-design/describe { ws, id, text, format? }
  *   POST /api/report-design/sample   { ws, id, name, kind, data } | { ws, id, link, name? } | { ws, id, doc, name? }   → { ok, sample }
+ *                                                   from Chrome: { kind: 'pdf', data, from: 'chrome', source_url?, pages? } | { kind: 'pictures', pictures: [base64 JPEG or PNG, …], source_url?, name, from: 'chrome' }   (the field is `from`: pm-guard reserves `via` for the writer; the record keeps via: 'chrome')
+ *   GET  /api/report-design/last?ws               → { ok, id, name, at }   the report whose design studio was opened last (the Chrome popup's default report); id null when none
  *   POST /api/report-design/turn     { ws, id, text, points: [{ n, slide, x, y, text }] }   → { ok, running }   ONE job per report; 409 while one runs
  *   POST /api/report-design/accept   { ws, id, n }   → { ok, design, brief, redraw }   "This is it": writes brief.md and redraws the current
  *                                                   cycle in the saved design (redraw: { path, slot, started, reason? }; a sent cycle keeps its look)
@@ -101,6 +103,11 @@ function promptFor(skill, { mode, root, cadence, setup, st, turnText, points, cy
     lines.push(samples.length ? '- Samples:' : '- Samples: none');
     for (const s of samples) {
       const f = D.sampleReadPath(root, cadence, s);
+      if (s.kind === 'pictures') {
+        const fs_ = Array.isArray(f) ? f : [];
+        lines.push(`  - ${s.id}${s.took ? '' : ' (NEW)'} "${s.name}", pictures of a whole web page from Chrome, top to bottom, ${fs_.length ? `${fs_.length} in all: read every one, in this order, and follow the look closely: ${fs_.join(', ')}` : 'its files could not be read'}`);
+        continue;
+      }
       const where = s.kind === 'link' ? (f ? `a link: ${s.source}. PMOS read its words and structure through the PM's connectors: read ${f}. It has the words and the order, not the look` : `a link: ${s.source} (you have no web tool)`) : f ? `read ${f}` : 'its file could not be read';
       lines.push(`  - ${s.id}${s.took ? '' : ' (NEW)'} "${s.name}", ${s.kind}: ${where}`);
     }
@@ -352,6 +359,26 @@ function sweep(ctx) {
 }
 
 // ── the Edit log line ───────────────────────────────────────────────────────────────────────────────────────
+/* The report whose design studio was opened last, for each workspace: <runtime>/report-design-last.json { [ws]: { id, at } }. A read of a design is an open of its studio. */
+function lastFile(ctx) { return ctx.runtimeDir ? path.join(ctx.runtimeDir, 'report-design-last.json') : null; }
+function lastEntry(ctx, w) {
+  const f = lastFile(ctx);
+  if (!f) return null;
+  try { const o = JSON.parse(fs.readFileSync(f, 'utf8')); const e = o && o[w.id]; return e && D.CADENCE_RE.test(String(e.id)) ? { id: e.id, at: typeof e.at === 'string' ? e.at : null } : null; } catch { return null; }
+}
+const lastStudio = (ctx, w) => { const e = lastEntry(ctx, w); return e ? e.id : null; };
+function rememberStudio(ctx, w, id) {
+  const f = lastFile(ctx);
+  if (!f || lastStudio(ctx, w) === id) return false;
+  try {
+    let o = {};
+    try { o = JSON.parse(fs.readFileSync(f, 'utf8')) || {}; } catch { o = {}; }
+    o[w.id] = { id, at: new Date().toISOString() };
+    fs.mkdirSync(path.dirname(f), { recursive: true });
+    fs.writeFileSync(f, JSON.stringify(o) + '\n');
+    return true;
+  } catch { return false; }
+}
 function editLog(ctx, row) {
   if (!ctx.runtimeDir) return false;
   try {
@@ -430,8 +457,14 @@ async function handle(req, res, url, ctx) {
         return sendHtml(res, D.sanitize(html));
       }
       try { settleStale(w.root, id); } catch { /* a read never fails on this */ }
+      rememberStudio(ctx, w, id);
       return send({ status: 200, body: { ok: true, setup, design: D.designAnswer(w.root, id, designOpts(w.root, id)) } });
     }
+    if (sub === 'last') {
+      const e = lastEntry(ctx, w);
+      const setup = e ? setupOf(w.root, e.id) : null;
+      return send({ status: 200, body: { ok: true, id: setup ? e.id : null, name: setup ? setup.name : null, at: setup ? e.at : null } });
+    }
     if (sub === 'cycle' || sub === 'cycle-html') {
       const d = reportDoc(w, text(url.searchParams.get('path'))); if (d.error) return send(d.error);
       if (sub === 'cycle') return send({ status: 200, body: cycleAnswer(w, d.c) });

package/workspace/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "pmos-workspace",
-  "version": "0.204.0",
+  "version": "0.205.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "pmos-workspace",
-      "version": "0.204.0",
+      "version": "0.205.0",
       "license": "MIT",
       "dependencies": {
         "@xterm/addon-fit": "^0.11.0",

package/workspace/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmos-workspace",
-  "version": "0.204.0",
+  "version": "0.205.0",
   "private": true,
   "description": "PMOS Terminal Workspace — local companion hosting real PTYs beside the library and gates (D62)",
   "license": "MIT",

package/workspace/public/pm/c3-boot.js

@@ -6,5 +6,6 @@
 const narrow = typeof matchMedia === 'function' && matchMedia('(max-width:640px)').matches;
 let desk = false;
 try { desk = localStorage.getItem('pmos.c3.testDesk') === 'desk'; } catch { /* no storage */ }
-if (narrow && !desk) import('./c3-phone-boot.js');
+if (new URLSearchParams(location.search).get('capture') === '1') import('./c3-capture.js');   // the PMOS Chrome extension's popup page: a small page on its own, at any width
+else if (narrow && !desk) import('./c3-phone-boot.js');
 else import('./c3-shell.js');

package/workspace/public/pm/c3-capture.css

@@ -0,0 +1,23 @@
+/* pm/c3-capture.css — the page the PMOS Chrome extension frames in its popup (c3-capture.js). Mockup 42-reportdeck.css .mk-cx-pop and friends. */
+.c3.c3-cap { min-height: 0; padding: 8px; background: var(--background); }
+.c3 .cap-pop { display: grid; gap: 10px; padding: 12px; box-sizing: border-box; }
+.c3 .cap-head { display: flex; gap: 8px; align-items: center; font-size: var(--fs-3); font-weight: 600; }
+.c3 .cap-head b { font-size: var(--fs-1); color: var(--acc); }
+.c3 .cap-head span { flex: 1; min-width: 0; }
+.c3 .cap-what { display: grid; grid-template-columns: 56px minmax(0, 1fr); gap: 10px; align-items: start; padding: 8px; border: 1px solid var(--border); border-radius: 8px; background: var(--background); }
+.c3 .cap-what b { display: flex; gap: 6px; align-items: center; font-size: var(--fs-2); overflow-wrap: anywhere; }
+.c3 .cap-what .mono { font-size: var(--fs-1); overflow-wrap: anywhere; }
+.c3 .cap-thumb { display: grid; gap: 3px; align-content: start; width: 56px; aspect-ratio: 16 / 9; padding: 4px; box-sizing: border-box; border: 1px solid var(--slide-border); border-radius: 6px; background: var(--slide-bg); }
+.c3 .cap-thumb i { display: block; height: 3px; background: var(--slide-track); }
+.c3 .cap-thumb.deck i:first-child { height: 6px; background: var(--slide-brand); }
+.c3 .cap-thumb.page { aspect-ratio: 3 / 4; width: 40px; justify-self: center; }
+.c3 .cap-f { display: grid; gap: 4px; }
+.c3 .cap-f select { width: 100%; box-sizing: border-box; padding: 6px 8px; border: 1px solid var(--border); border-radius: 6px; background: var(--background); color: var(--foreground); font: inherit; font-size: var(--fs-3); }
+.c3 .cap-lbl { font-size: var(--fs-1); }
+.c3 .cap-line { font-size: var(--fs-2); line-height: 1.5; }
+.c3 .cap-step { font-size: var(--fs-1); }
+.c3 .cap-acts { display: flex; gap: 8px; flex-wrap: wrap; }
+.c3 .cap-msg { display: flex; gap: 8px; align-items: flex-start; margin: 0; font-size: var(--fs-3); line-height: 1.5; }
+.c3 .cap-msg .ic { flex: 0 0 auto; margin-top: 4px; }
+.c3 .cap-prog { height: 6px; border-radius: 6px; background: var(--muted); overflow: hidden; }
+.c3 .cap-prog i { display: block; width: var(--rp-w, 6%); height: 100%; background: var(--acc); }