create-pmos 0.167.0 → 0.169.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pmos",
-  "version": "0.167.0",
+  "version": "0.169.0",
   "description": "Scaffold the PMOS portable kit — run the PMOS product-management workflow (initiative → lane-fit spec → contract → build → three gates, with work-type lanes for features, research, maintenance, incidents, and content) entirely inside your own repo, with all state as git-versioned files. Includes `workflow-sweep`, which audits the state every board derives from and separates real defects from work you simply have not done. `create-pmos workspace` also installs + launches the local Terminal Workspace GUI. No database, no network, no telemetry.",
   "license": "MIT",
   "bin": {

package/payload/KIT-VERSION

@@ -1,3 +1,3 @@
-kernel-source: pmos@23fe058
+kernel-source: pmos@d87e438
 assembled: 2026-10-12
 mode: vendor

package/payload/planning/evals/eval-calibration.md

@@ -2,7 +2,7 @@
 type: Reference
 title: "Eval calibration log"
 description: "Append-only record of every PM override of an evaluator verdict."
-generated: {by: process:create-pmos, at: "2026-10-12T14:00:51Z"}
+generated: {by: process:create-pmos, at: "2026-10-12T14:51:11Z"}
 status: stable
 ---
 

package/payload/planning/okrs/health-budgets.md

@@ -2,7 +2,7 @@
 type: Reference
 title: "Health budgets"
 description: "Closed registry of health-budget anchors (D59), edited only by the PM."
-generated: {by: process:create-pmos, at: "2026-10-12T14:00:51Z"}
+generated: {by: process:create-pmos, at: "2026-10-12T14:51:11Z"}
 status: stable
 ---
 

package/payload/state/discoveries.md

@@ -2,7 +2,7 @@
 type: Reference
 title: "Discoveries and friction log"
 description: "Append-only record of what runs discovered and where the process rubbed."
-generated: {by: process:create-pmos, at: "2026-10-12T14:00:51Z"}
+generated: {by: process:create-pmos, at: "2026-10-12T14:51:11Z"}
 status: stable
 ---
 

package/workspace/c3-driver-fixture.js

@@ -0,0 +1,61 @@
+'use strict';
+/* c3-driver-fixture.js — a real server, a scratch repository and a seeded driver ledger for the console3 Initiative Driver suite
+ * (c3-driver-test.js). Not a suite: it asserts nothing. The server runs with PMOS_DRIVER=off, so no headless run starts: every
+ * proposal, run and blocker the page shows is a line this file wrote with lib/driver.js, the single writer.
+ *
+ *   const F = await start({ name })  -> { BASE, ws, board, team, ledger, ids, item, itemDue, post, get, stop }
+ *   ids: { problem, evidence, sizing, move, follow, step } proposal ids; item: the Work task with a follow-up; itemDue: the one with a due date
+ */
+const fs = require('fs');
+const path = require('path');
+const { spawn } = require('child_process');
+const T = require('./test-run').configure({ name: 'c3-driver' });
+const { makeRepos, codeRepo, write, git } = require('./plan-test-repos');
+const D = require('./lib/driver.js');
+
+const HOUR = 3600000;
+async function call(base, method, p, body, headers) {
+  const r = await fetch(base + p, { method, headers: headers || {}, body: body === undefined ? undefined : JSON.stringify(body) });
+  const raw = await r.text(); let j = null; try { j = JSON.parse(raw); } catch { /* not JSON */ }
+  return { status: r.status, body: j, raw };
+}
+
+async function start({ name = 'c3-driver' } = {}) {
+  const R = makeRepos(name);
+  const team = codeRepo(path.join(R.base, 'team'));
+  fs.mkdirSync(path.join(team, 'pmos', 'state'), { recursive: true });
+  write(team, 'pmos/state/.keep', '');
+  git(team, ['add', '-A']); git(team, ['commit', '-q', '-m', 'state']);
+  const ledger = path.join(team, 'pmos', 'state', 'driver.jsonl');
+  const BASE = T.BASE;
+  const srv = spawn(process.execPath, [path.join(__dirname, 'server.js')], { cwd: __dirname, stdio: 'ignore',
+    env: T.env({ PMOS_WS_PORT: String(T.PORT), PMOS_SELF_ROOT: team, PMOS_NO_OPEN: '1', PMOS_DRIVER: 'off' }) });
+  await T.waitForServer(BASE);
+  const press = await T.pressHeaders(BASE);
+  const post = (p, body) => call(BASE, 'POST', p, body, press);
+  const get = (p) => call(BASE, 'GET', p);
+  const reg = await post('/api/workspaces', { root: team, focus: true });
+  const ws = reg.body.workspace.id;
+  const made = await post('/api/initiatives', { ws, title: 'Partner API onboarding', lane: 'feature', anchor: 'health:tech', id: 'drv-ui' });
+  if (made.status !== 200) throw new Error('could not create the initiative: ' + made.raw);
+  const a = (await post('/api/pm-items/add', { line: 'Get the sandbox access date from Dana waiting on Dana Hartono' })).body.item;
+  const b = (await post('/api/pm-items/add', { line: 'Send the partner onboarding list to Lina' })).body.item;
+  const tI = { kind: 'initiative', ws, id: 'drv-ui' };
+  const now = Date.now();
+  const w = (line, at) => D.append(ledger, line, { now: at });
+  const prop = (id, target, what, data, why, sources, at, run) => { w({ ev: 'proposal', id, target, what, data, why, sources: sources || [], run, by: 'agent:sess-4.0a1b2c3d' }, at); return id; };
+  const ids = { problem: 'p-aaaaaaaa01', evidence: 'p-aaaaaaaa02', sizing: 'p-aaaaaaaa03', move: 'p-aaaaaaaa04', follow: 'p-aaaaaaaa05', step: 'p-aaaaaaaa06' };
+  w({ ev: 'epoch' }, now - 3 * 24 * HOUR);
+  w({ ev: 'run-start', run: 'run-aaaaaaaa01', target: tI, board: ws, wakes: [], session: 'sess-4.0a1b2c3d' }, now - 5 * HOUR);
+  prop(ids.problem, tI, 'problem', { text: 'New partners wait 9 days on average from signed contract to first live API call. Support handles 23 onboarding tickets a month.' }, 'first draft from the Jira and Slack threads', [{ label: 'Jira', ref: 'IDPF-1204' }, { label: 'Slack', ref: '#partner-support, 6 Oct' }], now - 4 * HOUR, 'run-aaaaaaaa01');
+  prop(ids.evidence, tI, 'evidence', { text: 'Six sources back the problem statement. Four name sandbox access as the main delay.', items: [{ text: 'Partner X waited 9 days for sandbox access', ref: 'IDPF-1204' }, { text: 'Two partners paused go-live this quarter', ref: 'https://example.invalid/partner-council/1-oct' }] }, 'evidence for the problem', [{ label: 'Meeting note', ref: 'IDPF DSU, 8 Oct' }], now - 4 * HOUR + 600000, 'run-aaaaaaaa01');
+  prop(ids.sizing, tI, 'sizing', { text: '14 partners are in the pipeline this half. Cutting the wait from 9 days to 3 moves about 5 go-lives into Q4.' }, 'low confidence: two data points', [{ label: 'Slack', ref: '#sales-asks, 7 Oct' }], now - 3 * HOUR, 'run-aaaaaaaa01');
+  prop(ids.move, tI, 'move', { to: 'Plan' }, 'the problem, evidence and sizing are in', [], now - 50 * HOUR, 'run-aaaaaaaa01');
+  w({ ev: 'run-end', run: 'run-aaaaaaaa01', ok: true, agent_run: null }, now - 3 * HOUR + 60000);
+  w({ ev: 'blocker', key: `initiative:${ws}:drv-ui:pm-open`, day: D.localDay(now), target: tI, board: ws, code: 'pm-open', owner: 'pm', text: "The agent's drafts have waited on you since " + new Date(now - 50 * HOUR).toISOString().slice(0, 10) }, now - HOUR);
+  prop(ids.follow, { kind: 'work', ws, id: a.id }, 'follow-up', { text: 'Hi Dana,\n\nQuick follow-up on the sandbox access for Nusa Pay. Can you tell me which day your engineers can use the sandbox?\n\nThanks,\nWawan', to: 'Dana' }, 'waiting 4 days, no reply', [{ label: 'Slack', ref: '#partner-support' }], now - 2 * HOUR, null);
+  prop(ids.step, { kind: 'work', ws, id: b.id }, 'next-step', { text: 'Send the list to Lina', due: '2026-10-15' }, 'overdue with no next step', [], now - HOUR, null);
+  const stop = () => { try { srv.kill('SIGKILL'); } catch { /* gone */ } T.killTmux(); R.cleanup(); };
+  return { BASE, ws, board: ws, team, ledger, ids, item: a, itemDue: b, post, get, stop, T, D, tI };
+}
+module.exports = { start };

package/workspace/c3-driver-test.js

@@ -0,0 +1,164 @@
+#!/usr/bin/env node
+'use strict';
+/* c3-driver-test.js — the Initiative Driver on console3 (initiative initiative-driver; PRD section 5 and done-criterion 9).
+ * LIVE mode: a real server and a scratch repository whose driver.jsonl this suite seeds (c3-driver-fixture.js; PMOS_DRIVER=off, so no
+ * run starts and every line the page shows is one the fixture wrote). A real Chromium drives /c3.html.
+ *
+ *   strip      Initiative · Overview shows the Agent strip: the count, Pause, "1 of 3 runs used today", the status, the last action, the
+ *              blocker line, one row per open proposal; a row opens to its text and sources (a URL source is a link)
+ *   runs       the runs chip opens a sheet that lists today's run
+ *   decide     Keep on a problem proposal posts /api/driver/keep and the row turns "Kept by you"; Send back asks for a note and posts it;
+ *              Drop posts and the row leaves
+ *   pause      Pause posts /api/driver/pause and the strip says Paused; Resume brings it back
+ *   work       a Work task with a follow-up shows the agent line; Review opens the sheet with the draft and "the agent sent nothing";
+ *              Keep records the keep; a task with a next-step shows Keep and Drop in the line
+ *   setting    Board settings has the Agent setting; pressing Shadow posts /api/driver/mode and the ledger holds it
+ *   briefing   Needs you shows the agent's two kinds of row and a press opens the initiative
+ *   phone      at 400 wide the strip has no horizontal scroll
+ * Every wait polls the page. The page must raise no script error.
+ */
+const path = require('path');
+const { findBrowser } = require('./lib/find-browser');
+const F = require('./c3-driver-fixture');
+
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+const until = async (fn, ms = 20000, step = 120) => { const t0 = Date.now(); for (;;) { const v = await fn(); if (v) return v; if (Date.now() - t0 > ms) return v; await sleep(step); } };
+const results = [];
+const ok = (n, cond, extra = '') => { results.push({ n, cond: !!cond }); console.log(`${cond ? '✓' : '✗'} ${n}${!cond && extra !== '' ? ' — ' + String(extra).slice(0, 400) : ''}`); };
+let fx = null; let browser = null;
+const finish = async (code) => {
+  if (browser) await browser.close().catch(() => {});
+  if (fx) fx.stop();
+  const bad = results.filter((x) => !x.cond).length;
+  console.log(`\n${results.length - bad}/${results.length} c3-driver assertions passed`);
+  process.exit(code !== undefined ? code : (bad ? 1 : 0));
+};
+process.on('unhandledRejection', (e) => { console.error(e); finish(1); });
+
+(async () => {
+  const exe = findBrowser();
+  if (!exe) { console.log('· no Chrome/Chromium on this machine — c3-driver suite skipped'); process.exit(0); }
+  let chromium;
+  try { ({ chromium } = require('playwright-core')); } catch { console.log('· playwright-core not installed — c3-driver suite skipped'); process.exit(0); }
+  fx = await F.start({ name: 'c3-driver' });
+  const { BASE, ws, ids, D, ledger } = fx;
+  const state = () => D.fold(D.readLines(ledger));
+  browser = await chromium.launch({ executablePath: exe });
+  const ctx = await browser.newContext({ viewport: { width: 1280, height: 900 } });
+  const page = await ctx.newPage();
+  const errors = []; page.on('pageerror', (e) => errors.push(String((e && e.message) || e)));
+  const posts = []; page.on('request', (r) => { if (r.method() === 'POST' && r.url().includes('/api/driver/')) posts.push({ path: new URL(r.url()).pathname, body: JSON.parse(r.postData() || '{}') }); });
+  const st = (f, a) => page.evaluate(f, a);
+  const sel = (s) => until(() => page.$(s));
+  const INI = `/c3.html?tab=init&init=ini:${ws}:drv-ui:overview`;
+
+  /* ── strip ── */
+  await page.goto(BASE + INI, { waitUntil: 'load' });
+  await sel('[data-drv-row]');
+  const rows = await st(() => [...document.querySelectorAll('[data-drv-row]')].map((r) => r.dataset.drvRow));
+  ok('S1 the Agent strip draws one row per open proposal, in the order the agent filed them', rows.join() === [ids.problem, ids.evidence, ids.sizing, ids.move].join(), rows.join());
+  const head = await st(() => document.querySelector('[data-drv="strip"] .sh2').textContent);
+  ok('S2 the header says AGENT 4, has Pause and "1 of 3 runs used today"', /Agent\s*4/i.test(head) && /Pause/.test(head) && /1 of 3 runs used today/.test(head), head);
+  const body = await st(() => document.querySelector('[data-drv="strip"]').textContent);
+  ok('S3 the status line says the agent is idle and waiting on you, with the last action', /Agent is idle · waiting on you/.test(body) && /The oldest proposal is 2 days old/.test(body) && /Last: filed 4 proposals/.test(body), body.slice(0, 300));
+  ok('S4 the blocker line names who stopped the agent', /Stopped by: you\./.test(await st(() => document.querySelector('[data-drv="blocker"]').textContent)));
+  ok('S5 the old proposal says how long it waited', /waiting 2 days/.test(await st(() => document.querySelector(`[data-drv-row="${'p-aaaaaaaa04'}"]`).textContent)));
+  await page.click(`[data-drv-title="${ids.evidence}"]`);
+  await until(() => st((id) => document.querySelector(`[data-drv-row="${id}"] .xp.open`), ids.evidence));
+  const ev = await st((id) => { const r = document.querySelector(`[data-drv-row="${id}"]`); return { text: r.textContent, link: (r.querySelector('a[href^="https://example.invalid"]') || {}).href || '', n: r.querySelectorAll('[data-drv-src]').length }; }, ids.evidence);
+  ok('S6 a row opens to its text and its sources (label and ref); a URL ref is a link', /Six sources back the problem statement/.test(ev.text) && /IDPF DSU, 8 Oct/.test(ev.text) && ev.n === 3 && /partner-council/.test(ev.link), JSON.stringify(ev));
+  await page.click('[data-drv="runs"]');
+  await sel('[data-drv="runs-sheet"]');
+  const runs = await st(() => document.querySelector('[data-shell="sheet"]').textContent);
+  ok('S7 the runs chip opens a sheet with today\'s run', /Agent runs today/.test(runs) && /1 of 3 runs used today/.test(runs) && /Filed 4 proposals/.test(runs), runs.slice(0, 300));
+  await page.keyboard.press('Escape');
+
+  /* ── decide ── */
+  await page.click(`[data-drv-row="${ids.problem}"] [data-drv-act=keep]`);
+  await until(() => posts.some((p) => p.path === '/api/driver/keep'));
+  ok('D1 Keep posts /api/driver/keep with the proposal id and no writer field', posts.some((p) => p.path === '/api/driver/keep' && p.body.proposal === ids.problem && !('by' in p.body)), JSON.stringify(posts));
+  await until(() => st((id) => { const r = document.querySelector(`[data-drv-row="${id}"]`); return r && r.dataset.drvState === 'kept'; }, ids.problem));
+  ok('D2 the row turns "Kept by you" and loses its buttons; the ledger holds the keep by the PM', await st((id) => { const r = document.querySelector(`[data-drv-row="${id}"]`); return /Kept by you/.test(r.textContent) && !r.querySelector('[data-drv-act]'); }, ids.problem)
+    && state().proposals.get(ids.problem).state === 'kept' && state().proposals.get(ids.problem).decided_by === 'pm:wawan');
+  await until(() => st(() => /Kept: Problem statement|Kept/.test(document.querySelector('[data-c3-toast]') ? document.querySelector('[data-c3-toast]').textContent : '')));
+  await page.click(`[data-drv-row="${ids.sizing}"] [data-drv-act=back]`);
+  await sel('[data-drv="send-back"]');
+  await page.click('[data-drv="send-back"]');
+  ok('D3 Send back with an empty note is refused in plain words and posts nothing', !!(await until(() => page.$('[data-drv="note-error"]:not([hidden])'))) && !posts.some((p) => p.path === '/api/driver/return'));
+  await page.fill('[data-drv="note"]', 'Use active partners, not signed ones');
+  await page.click('[data-drv="send-back"]');
+  await until(() => posts.some((p) => p.path === '/api/driver/return'));
+  ok('D4 Send back posts the note; the row says it was sent back; the ledger holds it', posts.some((p) => p.path === '/api/driver/return' && p.body.note === 'Use active partners, not signed ones')
+    && !!(await until(() => st((id) => { const r = document.querySelector(`[data-drv-row="${id}"]`); return r && r.dataset.drvState === 'back'; }, ids.sizing))) && state().proposals.get(ids.sizing).state === 'returned');
+  await page.click(`[data-drv-row="${ids.evidence}"] [data-drv-act=drop]`);
+  await until(() => st((id) => !document.querySelector(`[data-drv-row="${id}"]`), ids.evidence));
+  ok('D5 Drop posts /api/driver/drop and the row leaves', posts.some((p) => p.path === '/api/driver/drop' && p.body.proposal === ids.evidence) && state().proposals.get(ids.evidence).state === 'dropped');
+
+  /* ── pause ── */
+  await page.click('[data-drv-act=pause]');
+  await until(() => st(() => /Agent is paused/.test(document.querySelector('[data-drv="status"]').textContent)));
+  ok('P1 Pause posts /api/driver/pause for the initiative and the strip says Paused with a Resume button', posts.some((p) => p.path === '/api/driver/pause' && p.body.target_kind === 'initiative' && p.body.id === 'drv-ui')
+    && !!(await page.$('[data-drv-act=resume]')) && D.isPaused(state(), fx.tI));
+  await page.click('[data-drv-act=resume]');
+  await until(() => st(() => !!document.querySelector('[data-drv-act=pause]')));
+  ok('P2 Resume lifts it', !D.isPaused(state(), fx.tI));
+
+  /* ── setting ── */
+  await page.goto(BASE + `/c3.html?tab=init&init=board:${ws}:summary`, { waitUntil: 'load' });
+  await (await sel('[data-ini=board-settings]')).click();
+  await sel('[data-drv="setting"] [data-drv-mode]');
+  ok('T1 Board settings shows the Agent setting at Approve, with the one-line explanations', await st(() => { const s = document.querySelector('[data-drv="setting"]'); return s.querySelector('[data-drv-mode=approve]').getAttribute('aria-pressed') === 'true' && /The agent drafts and asks you/.test(s.textContent) && /The agent does nothing on this board/.test(s.textContent); }));
+  await page.click('[data-drv-mode=shadow]');
+  await until(() => posts.some((p) => p.path === '/api/driver/mode'));
+  await until(() => st(() => document.querySelector('[data-drv-mode=shadow]').getAttribute('aria-pressed') === 'true'));
+  ok('T2 pressing Shadow posts /api/driver/mode for the board and the ledger holds it', posts.some((p) => p.path === '/api/driver/mode' && p.body.mode === 'shadow' && p.body.board === ws) && D.modeOf(state(), ws) === 'shadow');
+  await page.goto(BASE + INI, { waitUntil: 'load' });
+  await sel('[data-drv="shadow"]');
+  ok('T3 in Shadow the strip says so and offers no Keep', !(await page.$('[data-drv-act=keep]')) && /Shadow mode/.test(await st(() => document.querySelector('[data-drv="shadow"]').textContent)));
+  await page.goto(BASE + `/c3.html?tab=init&init=board:${ws}:summary`, { waitUntil: 'load' });
+  await (await sel('[data-ini=board-settings]')).click();
+  await sel('[data-drv-mode=approve]');
+  await page.click('[data-drv-mode=approve]');
+  await until(() => D.modeOf(state(), ws) === 'approve');
+  ok('T4 pressing Approve puts it back', D.modeOf(state(), ws) === 'approve');
+
+  /* ── work ── */
+  await page.goto(BASE + '/c3.html?tab=work', { waitUntil: 'load' });
+  await sel('[data-pm-lenses]');
+  await page.click('[data-pm-lenses] [data-lens=waiting]');
+  const line = await sel(`[data-drv-line="${fx.item.id}"]`);
+  ok('W1 a Waiting task with a follow-up shows "Agent drafted a follow-up to Dana. Nothing is sent." and Review', /Agent drafted a follow-up to Dana\. Nothing is sent\./.test(await line.textContent()) && !!(await page.$('[data-drv-wnote-act=review]')));
+  await page.click('[data-drv-wnote-act=review]');
+  await sel('[data-drv="work-sheet"]');
+  const sheet = await st(() => document.querySelector('[data-drv="work-sheet"]').textContent);
+  ok('W2 Review opens a sheet with the draft and the line that the agent sent nothing', /Quick follow-up on the sandbox access/.test(sheet) && /The agent sent nothing and cannot send/.test(sheet) && !!(await page.$('[data-drv=sheet-keep]')) && !!(await page.$('[data-drv=sheet-back]')) && !!(await page.$('[data-drv=sheet-drop]')));
+  await ctx.grantPermissions(['clipboard-read', 'clipboard-write'], { origin: BASE }).catch(() => {});
+  await page.click('[data-drv=sheet-keep]');
+  await until(() => state().proposals.get(ids.follow).state === 'kept');
+  ok('W3 Keep records the keep (by the PM) and the sheet closes', state().proposals.get(ids.follow).decided_by === 'pm:wawan' && !!(await until(async () => !(await page.$('[data-drv="work-sheet"]')))));
+  const clip = await page.evaluate(() => navigator.clipboard.readText().catch(() => null));
+  ok('W4 the draft text was copied to the clipboard (or the browser refused, and the text was selected)', (clip && /Quick follow-up on the sandbox access/.test(clip)) || clip === null, String(clip));
+  await page.click('[data-pm-lenses] [data-lens=inbox]');
+  await sel(`[data-drv-line="${fx.itemDue.id}"]`);
+  ok('W5 a task with a next-step shows the suggestion with Keep and Drop in the line', /Agent suggests a next step: Send the list to Lina, due Thu 15 Oct/.test(await st((id) => document.querySelector(`[data-drv-line="${id}"]`).textContent, fx.itemDue.id)) && !!(await page.$('[data-drv-wnote-act=keep]')) && !!(await page.$('[data-drv-wnote-act=drop]')));
+  await page.click('[data-drv-wnote-act=drop]');
+  await until(() => state().proposals.get(ids.step).state === 'dropped');
+  ok('W6 Drop in the line drops the proposal and the line goes', !!(await until(async () => !(await page.$(`[data-drv-line="${fx.itemDue.id}"]`)))));
+
+  /* ── briefing ── */
+  await page.goto(BASE + '/c3.html?tab=brief', { waitUntil: 'load' });
+  await sel('[data-drv-need]');
+  const needs = await st(() => [...document.querySelectorAll('[data-drv-need]')].map((r) => r.dataset.drvNeed + ':' + r.textContent.replace(/\s+/g, ' ')));
+  ok('B1 Needs you shows the agent\'s rows: the drafts left on the initiative, and the initiative waiting on you', needs.some((t) => /^driver-drafts:Agent has 1 draft on Partner API onboarding/.test(t)) && needs.some((t) => /^driver-blocked:.*Partner API onboarding is waiting on you/.test(t)), needs.join(' | '));
+  await page.click('[data-drv-need="driver-drafts"] .tt');
+  await until(() => page.$('[data-drv="strip"]'));
+  ok('B2 a press on the row opens the initiative with its Agent strip', !!(await page.$('[data-drv="strip"]')));
+
+  /* ── phone ── */
+  await page.setViewportSize({ width: 400, height: 900 });
+  await page.goto(BASE + INI, { waitUntil: 'load' });
+  await sel('[data-drv-row]');
+  ok('M1 at 400 wide the page has no horizontal scroll', await st(() => document.documentElement.scrollWidth <= window.innerWidth + 1), await st(() => document.documentElement.scrollWidth));
+  ok('N1 no page error was thrown', errors.length === 0, errors.join(' | '));
+  await finish();
+})().catch((e) => { console.error(e); finish(1); });

package/workspace/extension/README.md

@@ -0,0 +1,33 @@
+---
+type: Guide
+title: "PMOS for Google Meet: the Chrome extension"
+timestamp: 2026-10-12
+---
+
+# PMOS for Google Meet
+
+A small panel over a Google Meet call. It shows the PMOS meeting companion: the topic the room is on, the time left, what is being said, the notes from PMOS and a line to ask PMOS quietly. Only you see it. The extension has no build step and no remote code. It runs only on `https://meet.google.com/*`, reads the address and the title of the Meet tab, and talks only to the PMOS on your own computer.
+
+## Load it in Chrome
+
+1. Open `chrome://extensions`.
+2. Turn on **Developer mode** (top right).
+3. Press **Load unpacked** and pick this folder. `pmos extension` prints its path.
+
+If PMOS does not run on `http://localhost:7433`, open the extension's **Options** and set the address that `pmos` printed. A Meet tab that is already open picks up the new address when you reload it.
+
+## Use it
+
+Open a Meet call, for example `meet.google.com/abc-defg-hij`. The panel shows at the bottom right of the call. It finds the meeting on your PMOS calendar by the Meet link in the invite, then by the title of the tab, then by the meeting that is under way now. If none fits, the panel says so and lists today's meetings to pick from. **Fold** shrinks the panel to a pill, and the same button opens it again. **Open focus in PMOS** opens the full Meeting focus page in a new tab. When PMOS does not answer, the panel says "PMOS is not running at <address>" and links to the options.
+
+## Files
+
+| File | What it is |
+|---|---|
+| `manifest.json` | Manifest V3. Permission: `storage` only. Content script on `https://meet.google.com/*`. |
+| `content.js` | Adds the panel on a call page (`/abc-defg-hij`) and removes it when you leave. |
+| `panel.html`, `panel.js`, `panel.css` | The page inside the panel. It checks that PMOS answers, then frames PMOS's compact Meeting focus page. |
+| `options.html`, `options.js`, `options.css`, `address.js` | The one setting: where PMOS is. |
+| `icons/` | The PMOS icon at four sizes. |
+
+The extension ships in the workspace package. Publishing it in the Chrome Web Store is not part of it yet.

package/workspace/extension/address.js

@@ -0,0 +1,20 @@
+/* address.js — where PMOS is. Shared by panel.js and options.js (classic script; no build step).
+ * The address is kept in chrome.storage.sync under `pmosAddress`. The default is the workspace's default port.
+ * normalizeAddress('localhost:7500') → 'http://localhost:7500'; anything that is not an http or https address → ''. */
+(function () {
+  'use strict';
+  var DEFAULT_ADDRESS = 'http://localhost:7433';
+  var KEY = 'pmosAddress';
+  function normalizeAddress(text) {
+    var t = String(text == null ? '' : text).trim();
+    if (!t) return '';
+    if (!/^[a-z][a-z0-9+.-]*:\/\//i.test(t)) t = 'http://' + t;
+    var u;
+    try { u = new URL(t); } catch (e) { return ''; }
+    if (u.protocol !== 'http:' && u.protocol !== 'https:') return '';
+    return u.origin;
+  }
+  var api = { DEFAULT_ADDRESS: DEFAULT_ADDRESS, KEY: KEY, normalizeAddress: normalizeAddress };
+  if (typeof module !== 'undefined' && module.exports) module.exports = api;
+  else window.PMOS_ADDRESS = api;
+})();

package/workspace/extension/content.js

@@ -0,0 +1,76 @@
+/* content.js — the PMOS panel over a Google Meet call. Runs only on https://meet.google.com/* (manifest.json).
+ *
+ * On a call path (/abc-defg-hij) it puts a fixed host element at the bottom right of the page. Its shadow root holds one iframe: panel.html of this
+ * extension, with the Meet code and the tab's title in the address. When the panel folds, the page inside it sends { pmosFocus: 'fold' } (and 'open'
+ * when it unfolds) and the host shrinks to a pill. On any other Meet page (the home page, a lobby list) there is no panel.
+ *
+ * Meet is a single-page app, so the address is watched: it is read again every second and on popstate. The only things read from the page are
+ * the address and the title. Nothing is sent from here. No call audio or captions are read. */
+(function () {
+  'use strict';
+  var CALL_PATH = /^\/[a-z]{3}-[a-z]{4}-[a-z]{3}$/;
+  var HOST_ID = 'pmos-meet-panel';
+  var OPEN = { width: 360, height: 520 };
+  var PILL_HEIGHT = 44;
+  var TITLE_WAIT_MS = 3000;   // Meet sets a title like "Meet - <name>" a moment after the call opens
+
+  /** The Meet code of a path, or '' when the path is not a call. */
+  function callCode(pathname) { return CALL_PATH.test(String(pathname || '')) ? String(pathname).slice(1) : ''; }
+  /** The panel's address: panel.html with the Meet code and the tab title. */
+  function panelSrc(base, code, title) { return base + '?meet=' + encodeURIComponent(code) + '&title=' + encodeURIComponent(title || ''); }
+
+  var api = { CALL_PATH: CALL_PATH, callCode: callCode, panelSrc: panelSrc };
+  if (typeof module !== 'undefined' && module.exports) { module.exports = api; return; }
+  if (typeof document === 'undefined' || typeof chrome === 'undefined' || !chrome.runtime || !chrome.runtime.getURL) return;
+  if (window.top !== window) return;
+
+  var CSS = [
+    ':host { position: fixed; right: 16px; bottom: 16px; z-index: 2147483647; width: ' + OPEN.width + 'px; height: ' + OPEN.height + 'px; max-width: calc(100vw - 32px); max-height: calc(100vh - 32px); }',
+    ':host([data-folded]) { height: ' + PILL_HEIGHT + 'px; }',
+    'iframe { display: block; width: 100%; height: 100%; border: 1px solid rgba(128, 128, 128, 0.35); border-radius: 12px; background: Canvas; color-scheme: light dark; box-shadow: 0 8px 24px rgba(0, 0, 0, 0.3); }',
+    ':host([data-folded]) iframe { border-radius: 22px; }',
+  ].join('\n');
+
+  var mounted = null;   // { code, host, frame }
+  var seenAt = 0;       // when this call path was first seen
+
+  function unmount() {
+    if (mounted && mounted.host.parentNode) mounted.host.parentNode.removeChild(mounted.host);
+    mounted = null;
+  }
+  function mount(code) {
+    var host = document.createElement('div');
+    host.id = HOST_ID;
+    var root = host.attachShadow({ mode: 'closed' });
+    try { var sheet = new CSSStyleSheet(); sheet.replaceSync(CSS); root.adoptedStyleSheets = [sheet]; }
+    catch (e) { var st = document.createElement('style'); st.textContent = CSS; root.appendChild(st); }
+    var frame = document.createElement('iframe');
+    frame.title = 'PMOS meeting helper';
+    frame.src = panelSrc(chrome.runtime.getURL('panel.html'), code, document.title);
+    root.appendChild(frame);
+    document.documentElement.appendChild(host);
+    mounted = { code: code, host: host, frame: frame };
+  }
+
+  window.addEventListener('message', function (e) {
+    if (!mounted || e.source !== mounted.frame.contentWindow) return;
+    if (e.origin !== chrome.runtime.getURL('').replace(/\/$/, '')) return;   // the panel's own origin, chrome-extension://<id>
+    var m = e.data && e.data.pmosFocus;
+    if (m === 'fold') mounted.host.setAttribute('data-folded', '');
+    else if (m === 'open') mounted.host.removeAttribute('data-folded');
+  });
+
+  function check() {
+    var code = callCode(location.pathname);
+    if (!code) { seenAt = 0; unmount(); return; }
+    if (mounted && mounted.code === code) return;
+    if (mounted) unmount();
+    if (!seenAt) seenAt = Date.now();
+    var titled = document.title && !/^\s*(Google )?Meet\s*$/i.test(document.title);
+    if (titled || Date.now() - seenAt >= TITLE_WAIT_MS) mount(code);
+  }
+  window.addEventListener('popstate', check);
+  window.addEventListener('hashchange', check);
+  setInterval(check, 1000);
+  check();
+})();

package/workspace/extension/manifest.json

@@ -0,0 +1,15 @@
+{
+  "manifest_version": 3,
+  "name": "PMOS for Google Meet",
+  "version": "0.1.0",
+  "description": "Shows your PMOS meeting companion in a small panel over a Google Meet call. Only you see it. It talks only to the PMOS on your own computer.",
+  "icons": { "16": "icons/icon-16.png", "32": "icons/icon-32.png", "48": "icons/icon-48.png", "128": "icons/icon-128.png" },
+  "permissions": ["storage"],
+  "content_scripts": [
+    { "matches": ["https://meet.google.com/*"], "js": ["content.js"], "run_at": "document_idle" }
+  ],
+  "web_accessible_resources": [
+    { "resources": ["panel.html"], "matches": ["https://meet.google.com/*"] }
+  ],
+  "options_ui": { "page": "options.html", "open_in_tab": true }
+}

package/workspace/extension/options.css

@@ -0,0 +1,33 @@
+/* options.css — the options page. PMOS does not serve this file, so the colours are PMOS's tokens by value. */
+:root {
+  color-scheme: light dark;
+  --background: oklch(1 0 0);
+  --foreground: oklch(0.148 0.004 228.8);
+  --muted-foreground: oklch(0.48 0.021 213.5);
+  --border: oklch(0.925 0.005 214.3);
+  --accent: oklch(0.488 0.243 264.376);
+  --destructive: oklch(0.577 0.245 27.325);
+}
+@media (prefers-color-scheme: dark) {
+  :root {
+    --background: oklch(0.148 0.004 228.8);
+    --foreground: oklch(0.987 0.002 197.1);
+    --muted-foreground: oklch(0.723 0.014 214.4);
+    --border: oklch(1 0 0 / 10%);
+    --accent: oklch(0.623 0.214 259.815);
+    --destructive: oklch(0.704 0.191 22.216);
+  }
+}
+body { margin: 0; background: var(--background); color: var(--foreground); font: 14px/1.5 system-ui, -apple-system, "Segoe UI", sans-serif; }
+main { max-width: 560px; margin: 0 auto; padding: 32px 16px; }
+h1 { margin: 0 0 8px; font-size: 20px; font-weight: 600; }
+.lede { margin: 0 0 24px; color: var(--muted-foreground); }
+code { font: 12px ui-monospace, SFMono-Regular, Menlo, monospace; }
+label { display: block; margin-bottom: 6px; font-weight: 600; }
+.row { display: flex; gap: 8px; }
+input { flex: 1; min-width: 0; height: 32px; padding: 0 12px; border: 1px solid var(--border); border-radius: 6px; background: var(--background); color: var(--foreground); font: inherit; }
+input:focus-visible, button:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
+button { height: 32px; padding: 0 16px; border: 0; border-radius: 6px; background: var(--foreground); color: var(--background); font: inherit; font-weight: 600; cursor: pointer; }
+.status { min-height: 21px; margin: 8px 0 0; color: var(--muted-foreground); }
+.status.bad { color: var(--destructive); }
+.fine { margin: 24px 0 0; color: var(--muted-foreground); font-size: 12px; }

package/workspace/extension/options.html

@@ -0,0 +1,26 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>PMOS for Google Meet: options</title>
+<link rel="stylesheet" href="options.css">
+</head>
+<body>
+<main>
+  <h1>PMOS for Google Meet</h1>
+  <p class="lede">The panel over a Meet call is a page of PMOS on your own computer. Type the address where your PMOS runs. The default is <code>http://localhost:7433</code>, the port the workspace starts on. If <code>pmos</code> printed another port, use that one.</p>
+  <form id="form">
+    <label for="addr">PMOS address</label>
+    <div class="row">
+      <input id="addr" name="addr" type="text" inputmode="url" autocomplete="off" spellcheck="false" placeholder="http://localhost:7433">
+      <button type="submit">Save</button>
+    </div>
+    <p id="status" class="status" role="status" aria-live="polite"></p>
+  </form>
+  <p class="fine">The extension runs only on meet.google.com. It reads the address and the title of the Meet tab, and it talks only to this PMOS address. It does not read the call's audio or captions.</p>
+</main>
+<script src="address.js"></script>
+<script src="options.js"></script>
+</body>
+</html>

package/workspace/extension/options.js

@@ -0,0 +1,24 @@
+/* options.js — the one setting: where PMOS is (chrome.storage.sync, key pmosAddress). */
+(function () {
+  'use strict';
+  var A = window.PMOS_ADDRESS;
+  var input = document.getElementById('addr');
+  var status = document.getElementById('status');
+  var say = function (t, bad) { status.textContent = t; status.className = 'status' + (bad ? ' bad' : ''); };
+
+  try {
+    var o = {}; o[A.KEY] = A.DEFAULT_ADDRESS;
+    chrome.storage.sync.get(o, function (v) { input.value = A.normalizeAddress(v && v[A.KEY]) || A.DEFAULT_ADDRESS; });
+  } catch (e) { input.value = A.DEFAULT_ADDRESS; }
+
+  document.getElementById('form').addEventListener('submit', function (e) {
+    e.preventDefault();
+    var addr = A.normalizeAddress(input.value) || (input.value.trim() === '' ? A.DEFAULT_ADDRESS : '');
+    if (!addr) { say('That is not an address. Use a form like http://localhost:7433.', true); return; }
+    var o = {}; o[A.KEY] = addr;
+    chrome.storage.sync.set(o, function () {
+      input.value = addr;
+      say('Saved. A Meet tab that is open picks it up when you reload the tab.');
+    });
+  });
+})();

package/workspace/extension/panel.css

@@ -0,0 +1,21 @@
+/* panel.css — the panel's own page, shown only while PMOS is being looked for. PMOS does not serve this file, so the colours are PMOS's tokens by value. */
+:root {
+  color-scheme: light dark;
+  --background: oklch(1 0 0);
+  --foreground: oklch(0.148 0.004 228.8);
+  --muted-foreground: oklch(0.48 0.021 213.5);
+  --accent: oklch(0.488 0.243 264.376);
+}
+@media (prefers-color-scheme: dark) {
+  :root {
+    --background: oklch(0.148 0.004 228.8);
+    --foreground: oklch(0.987 0.002 197.1);
+    --muted-foreground: oklch(0.723 0.014 214.4);
+    --accent: oklch(0.623 0.214 259.815);
+  }
+}
+html, body { height: 100%; margin: 0; }
+body { background: var(--background); color: var(--foreground); font: 14px/1.5 system-ui, -apple-system, "Segoe UI", sans-serif; }
+.msg { margin: 0; padding: 16px; color: var(--muted-foreground); }
+.msg a { color: var(--accent); text-underline-offset: 2px; }
+iframe { display: block; width: 100%; height: 100%; border: 0; background: var(--background); }

package/workspace/extension/panel.html

@@ -0,0 +1,14 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>PMOS meeting helper</title>
+<link rel="stylesheet" href="panel.css">
+</head>
+<body>
+<main id="msg" class="msg" role="status" aria-live="polite">Looking for PMOS.</main>
+<script src="address.js"></script>
+<script src="panel.js"></script>
+</body>
+</html>