create-pmos 0.55.4 → 0.56.0

package/workspace/public/pm/today-day.js

@@ -130,7 +130,10 @@ function deriveStage(run, brief) {
   return 'done';
 }
 
-function model(d) {
+/* One day for every repository. `view` is { here: the repository Today was opened from (a workspace id), all: the
+ * Show switch is on All repositories }. An item, a goal or a place carries a repository or none; with the switch on one
+ * repository, the day keeps that repository's items and the ones with none. The calendar is never narrowed. */
+function model(d, view) {
   const today = d && d.today;
   const brief = d && d.brief && (!today || d.brief.date === today) ? d.brief : null;
   const plan = (d && d.plan) || null;
@@ -156,17 +159,31 @@ function model(d) {
   const level = (svc, name) => (scopes[svc] && scopes[svc][name]) || 'search';
   const digests = ((brief && Array.isArray(brief.digests)) ? brief.digests : []).map((g) => ({ ...g, id: g.source + '|' + g.name, level: level(g.source, g.name) }));
   const places = (brief && Array.isArray(brief.places)) ? brief.places : [];
+  const placeRepos = (settings && settings.placeRepos) || {};
+  const placeRepo = (svc, name) => (placeRepos[svc] && placeRepos[svc][name]) || null;
+  const itemRepos = (d && d.item_repos) || {};
+  const repos = (d && Array.isArray(d.repos)) ? d.repos : [];
+  const repoName = (id) => { const r = repos.find((x) => x.id === id); return r ? r.name : id; };
+  for (const j of jobs) j.repo = itemRepos[j.id] || null;
+  for (const g of digests) g.repo = placeRepo(g.source, g.name);
+  const v = view || {};
+  const narrow = !v.all && !!v.here;
+  const inView = (r) => !narrow || !r || r === v.here;
+  const shownJobs = jobs.filter((j) => inView(j.repo));
+  const shownIds = new Set(shownJobs.map((j) => j.task && j.task.id).filter(Boolean));
+  const shownTasks = narrow ? tasks.filter((t) => shownIds.has(t.id)) : tasks;
   return {
-    d, brief, plan, goals, goalNo, run, tasks, jobs, events, now, settings, scopes, level, digests, places,
+    d, brief, plan, goals: goals.filter((g) => inView(g.repo)), allGoals: goals, goalNo, run, tasks: shownTasks, jobs: shownJobs, events, now, settings, scopes, level,
+    digests: digests.filter((g) => inView(g.repo)), places, placeRepo, repos, repoName, here: v.here || null, narrow,
     stage: run ? (d.stage || deriveStage(run, brief)) : null,
-    mentions: jobs.filter((j) => j.item && j.item.mention),
+    mentions: shownJobs.filter((j) => j.item && j.item.mention),
     sources: (d && Array.isArray(d.sources)) ? d.sources : [],
     check: (d && d.check) || null,
     readFailed: (d && d.read_failed) || null,
     free: plan && plan.time ? plan.time.free_minutes : null,
     maxGoals: (d && d.max_goals) || 7,
-    needs: jobs.filter((j) => j.group === 'needs').length,
-    done: jobs.filter((j) => j.group === 'done').length,
+    needs: shownJobs.filter((j) => j.group === 'needs').length,
+    done: shownJobs.filter((j) => j.group === 'done').length,
   };
 }
 
@@ -179,6 +196,20 @@ const TONE = { '': 'muted', ok: 'outline', info: 'outline', goal: 'outline', war
 function pill(text, tone, attrs) {
   return badge({ text, tone: TONE[tone || ''] || 'muted', attrs });
 }
+/** The repository a row belongs to, as a small tag. A row with none (yours) carries no tag. */
+function repoTag(m, r) {
+  return r ? badge({ text: m.repoName(r), tone: 'outline', attrs: { 'data-day-repo': r, title: COPY.day.repo.label } }) : null;
+}
+/** A picker of the repository: none, or one of the registered repositories. `onPick(id|null)`. */
+export function repoPicker(m, cur, onPick, attrs) {
+  const sel = el('select', { class: 'td-day__repo', 'aria-label': COPY.day.repo.label, ...(attrs || {}) },
+    el('option', { value: '' }, COPY.day.repo.none), ...m.repos.map((r) => el('option', { value: r.id }, r.name)),
+    // a repository that is no longer registered stays shown, so the picker never hides what is stored
+    cur && !m.repos.some((r) => r.id === cur) ? el('option', { value: cur }, cur) : null);
+  sel.value = cur || '';
+  sel.addEventListener('change', () => onPick(sel.value || null));
+  return sel;
+}
 function statusPill(j) {
   const s = D.status2;
   const map = {
@@ -365,7 +396,7 @@ function jobRow(ctx, j) {
   const n = j.goal ? ctx.m.goalNo.get(j.goal) : null;
   const sub = j.status === 'failed' && j.task && j.task.error ? j.task.error
     : [j.item && j.item.where, srcName(j.source)].filter(Boolean).join(' · ');
-  return rowBtn(ctx, 'job', j.id, { lead: n ? D.pill.goal(n) : '·', title: j.title, meta: sub, trail: statusPill(j),
+  return rowBtn(ctx, 'job', j.id, { lead: n ? D.pill.goal(n) : '·', title: j.title, meta: sub, trail: el('span', { class: 'td-day__chips' }, repoTag(ctx.m, j.repo), statusPill(j)),
     dot: j.isNew && !seen.has(j.id) ? el('span', { class: 'td-day__newdot', 'data-day': 'new', role: 'img', 'aria-label': D.newItem }) : null });
 }
 
@@ -412,7 +443,7 @@ function waitingPanel(owed) {
 
 function goalsPanel(ctx) {
   const { m } = ctx;
-  return panel('goals', D.goalsCount(m.goals.filter((g) => g.status === 'open').length, m.maxGoals), goalRows(ctx), goalAdd(ctx));
+  return panel('goals', D.goalsCount(m.allGoals.filter((g) => g.status === 'open').length, m.maxGoals), goalRows(ctx), goalAdd(ctx));
 }
 
 function mentionStatus(j) {
@@ -423,7 +454,7 @@ function mentionStatus(j) {
 
 function digestRow(ctx, g) {
   const sub = D.digestLine(D.levelWord[g.level] || g.level, (g.decisions || []).length, (g.open || []).length);
-  return rowBtn(ctx, 'channel', g.id, { lead: el('span', { class: 'td-day__chip' }, srcName(g.source)), title: g.name, meta: sub });
+  return rowBtn(ctx, 'channel', g.id, { lead: el('span', { class: 'td-day__chip' }, srcName(g.source)), title: g.name, meta: sub, trail: repoTag(ctx.m, g.repo) });
 }
 
 function mentionsPanel(ctx) {
@@ -438,7 +469,7 @@ function mentionsPanel(ctx) {
   const rows = shown.length ? el('ul', { class: 'td-day__rows', 'data-day-list': 'mentions' }, ...shown.map((j) => {
     const it = j.item;
     return rowBtn(ctx, 'mention', j.id, { lead: el('span', { class: 'td-day__chip' }, srcName(j.source)),
-      title: it.about && it.ask ? `${it.about}: ${it.ask}` : it.ask || j.title, meta: D.fromWho(it.who, it.where) || it.why_now || '', trail: mentionStatus(j) });
+      title: it.about && it.ask ? `${it.about}: ${it.ask}` : it.ask || j.title, meta: D.fromWho(it.who, it.where) || it.why_now || '', trail: el('span', { class: 'td-day__chips' }, repoTag(ctx.m, j.repo), mentionStatus(j)) });
   })) : note(D.noMentions);
   const live = m.digests.filter((g) => g.level !== 'ignore');
   const ign = m.digests.filter((g) => g.level === 'ignore');
@@ -469,7 +500,7 @@ function stepItem(st) {
 function eventDetail(ctx, e) {
   const { m } = ctx;
   const n = e.goal ? m.goalNo.get(e.goal) : null;
-  const g = n ? m.goals[n - 1] : null;
+  const g = n ? m.allGoals[n - 1] : null;
   const ini = e.initiative && e.initiative.id ? e.initiative : null;
   const steps = e.steps || {};
   const notes = e.notes || {};
@@ -484,7 +515,7 @@ function eventDetail(ctx, e) {
       list(D.actions, (w.actions || []).map((a) => (typeof a === 'string' ? a : stepItem(a))))] : note(D.noWispr),
     mailBlock || note(D.noMail)) : null;
   const tie = g ? el('p', { class: 'td-day__goalline', 'data-day': 'tie' }, D.countsToward(n, g.text))
-    : [note(D.tieHow, { 'data-day': 'tie' }), m.goals.length < m.maxGoals ? el('div', { class: 'td-day__acts' }, button({ label: D.addAsGoal, size: 'sm', attrs: { 'data-day-act': 'add-goal' },
+    : [note(D.tieHow, { 'data-day': 'tie' }), m.allGoals.length < m.maxGoals ? el('div', { class: 'td-day__acts' }, button({ label: D.addAsGoal, size: 'sm', attrs: { 'data-day-act': 'add-goal' },
       onClick: async () => { if (await addGoal(ctx, e.title, ini ? ini.id : null)) toast({ text: D.goalAdded }); } })) : null];
   return [
     dhead(D.kind.meeting, e.title),
@@ -557,6 +588,7 @@ function jobDetail(ctx, j) {
   const mention = j.item && j.item.mention;
   return [
     dhead(n ? D.kind.jobGoal(n) : D.kind.job, null),
+    j.repo ? el('div', { class: 'td-day__acts' }, repoTag(m, j.repo)) : null,
     jobCard(ctx, j),
     meets.length || mention ? el('div', { class: 'td-day__rel' }, el('h4', null, D.related), el('ul', { class: 'td-day__rows' },
       ...meets.map((e) => relRow(ctx, 'event', e.id, e.title, e.time)),
@@ -586,6 +618,10 @@ function setLevel(ctx, svc, name, lvl) {
   return setSettings(ctx.ws, { scopes });
 }
 
+function setPlaceRepo(ctx, svc, name, repo) {
+  return setSettings(ctx.ws, { placeRepos: { [svc]: { [name]: repo } } });
+}
+
 function channelDetail(ctx, id) {
   const g = ctx.m.digests.find((x) => x.id === id);
   if (!g) return null;
@@ -594,6 +630,7 @@ function channelDetail(ctx, id) {
     dhead(D.kind.place(srcName(g.source), D.place[g.source] || '', D.levelWord[g.level] || g.level), g.name),
     sec(D.decisions, g.decisions), sec(D.open, g.open), sec(D.forGoals, g.goals),
     el('div', { class: 'td-day__ch' }, el('span', null, D.changeLevel), levelSeg(ctx, g.source, g.name)),
+    el('div', { class: 'td-day__ch' }, el('span', null, D.repo.label), repoPicker(ctx.m, g.repo, (r) => setPlaceRepo(ctx, g.source, g.name, r), { 'data-day-place-repo': g.source + ':' + g.name })),
     note(D.levelHelp),
     el('div', { class: 'td-day__acts' }, extLink(D.openIn(srcName(g.source)), g.link, { 'data-day-link': 'place' }),
       button({ label: D.manageSources, size: 'sm', variant: 'ghost', onClick: () => select('sources', 'all') })),
@@ -619,7 +656,7 @@ function stepDetail(ctx, i) {
   if (i === 1) {
     const live = m.jobs.filter((j) => !j.worth);
     return [head, el('p', null, D.madeJobs(live.length, live.filter((j) => j.kind === 'you').length, live.filter((j) => j.kind !== 'you').length)),
-      m.goals.length ? el('ul', { class: 'td-day__rows' }, ...m.goals.map((g, k) => relRow(ctx, 'goal', g.id, g.text, String(k + 1)))) : null];
+      m.goals.length ? el('ul', { class: 'td-day__rows' }, ...m.goals.map((g) => relRow(ctx, 'goal', g.id, g.text, String(m.goalNo.get(g.id))))) : null];
   }
   if (i === 2) {
     const ts = m.jobs.filter((j) => j.task);
@@ -641,7 +678,8 @@ function placeControls(ctx, svc) {
   // every place the last read found you in, then any you set a level for or that has a digest
   const names = [...new Set([...m.places.filter((x) => x.source === svc).map((x) => x.name), ...Object.keys(m.scopes[svc] || {}),
     ...m.digests.filter((g) => g.source === svc).map((g) => g.name)])];
-  const row = (name) => el('div', { class: 'td-day__ch', 'data-day-place': svc + ':' + name }, el('span', null, name), levelSeg(ctx, svc, name));
+  const row = (name) => el('div', { class: 'td-day__ch', 'data-day-place': svc + ':' + name }, el('span', null, name),
+    el('span', { class: 'td-day__chips' }, repoPicker(m, m.placeRepo(svc, name), (r) => setPlaceRepo(ctx, svc, name, r), { 'data-day-place-repo': svc + ':' + name }), levelSeg(ctx, svc, name)));
   const live = names.filter((x) => m.level(svc, x) !== 'ignore');
   const ign = names.filter((x) => m.level(svc, x) === 'ignore');
   const input = field({ label: D.placeAdd[svc], value: '', placeholder: D.placeHint, hideLabel: true, attrs: { maxlength: '120', 'data-day-input': 'place-' + svc },
@@ -663,6 +701,7 @@ function placeControls(ctx, svc) {
     ui.showIgn[svc] ? ign.map(row) : null,
     input,
     note(D.levelHelp),
+    note(D.repo.placeHint),
   ];
 }
 
@@ -753,14 +792,14 @@ function fold(open) {
 }
 
 /** The section. `ws` is the repository the day run belongs to; `openIni(id)` opens an initiative of it. */
-export function daySection({ ws, setState, openIni, owed } = {}) {
+export function daySection({ ws, setState, openIni, owed, here, all } = {}) {
   if (FIXTURE) return null;
   // like Today's own feeds, a read that lands re-renders only while the section is on the page: a hidden Today must not
   // cause a whole-page render under whatever the PM is doing elsewhere
   if (setState) rerender = () => { if (document.querySelector('[data-today="day"]')) setState({}); };
   ensure(ws);
   const c = cache.get(ws) || {};
-  const m = model(c.data);
+  const m = model(c.data, { here: here || null, all: !!all });
   const open = ui.open !== null ? ui.open : !!m.run;
   if (!open) {
     return el('section', { class: 'td-day', 'data-today': 'day', 'data-open': 'false', 'aria-label': D.title },
@@ -768,7 +807,7 @@ export function daySection({ ws, setState, openIni, owed } = {}) {
   }
   const sel = ui.sel;
   const ctx = {
-    ws, m, sel, openIni, reload: () => load(ws), rerender: () => rerender(), select,
+    ws, m, sel, openIni, reload: () => load(ws), rerender: () => rerender(), select, repoPicker,
     cur: (type, id) => { const s = sel || defaultSel(m); return s.type === type && s.id === String(id) ? 'true' : 'false'; },
   };
   ctx.sel = sel || defaultSel(m);
@@ -784,10 +823,11 @@ export function daySection({ ws, setState, openIni, owed } = {}) {
   return el('section', { class: 'td-day', 'data-today': 'day', 'data-open': 'true', 'aria-label': D.title },
     topBar(ctx),
     runLine(ctx),
+    m.narrow && m.repos.length > 1 ? note(D.repo.only(m.repoName(m.here)), { 'data-day': 'repo-view' }) : null,
     c.error ? el('p', { class: 'td-day__run td-day__run--failed', role: 'status', 'data-day': 'error' }, D.refused(c.error)) : null,
     m.d && m.d.legacy ? note(D.oldServer) : null,
     el('div', { class: 'td-day__cols' },
-      el('div', { class: 'td-day__left' }, summaryPanel(ctx), calendar(ctx), jobsPanel(ctx), goalsPanel(ctx), mentionsPanel(ctx), waitingPanel(owed)),
+      el('div', { class: 'td-day__left' }, summaryPanel(ctx), goalsPanel(ctx), calendar(ctx), jobsPanel(ctx), mentionsPanel(ctx), waitingPanel(owed)),
       detail(ctx)));
 }
 

package/workspace/public/pm/today-goals.js

@@ -5,7 +5,8 @@
  *   goalDetail(ctx, goalId)  → the right column's detail of one goal: its meetings, its jobs, the steps found, and the
  *                              presses done, drop, reopen and remove; on an agent step that names an initiative, Prepare
  *                              then Queue it (the shipped background prepare: one approval is one prompt hash)
- *   addGoal(ctx, text, ini)  → POST the add; true when the goal is on the list
+ *   addGoal(ctx, text, ini)  → POST the add; true when the goal is on the list. While Today shows one repository, the
+ *                              goal belongs to it (repo); the goal's detail can change that.
  *   goalsSig()               → a string that changes whenever what this module draws changes on its own
  *
  * `ctx` is the day section's (today-day.js): { ws, m (the day model), select(type, id), reload(), rerender(), cur(type, id) }.
@@ -33,6 +34,8 @@ async function press(ctx, body) {
 export function addGoal(ctx, text, ini) {
   const body = { action: 'add', text: String(text || '').trim().slice(0, 140) };
   if (ini) body.initiative_id = ini;
+  // one day for every repository: a goal added while Today shows one repository belongs to it; otherwise to none
+  if (ctx.m && ctx.m.narrow && ctx.m.here) body.repo = ctx.m.here;
   return press(ctx, body);
 }
 
@@ -42,7 +45,7 @@ const jobsOf = (m, id) => m.jobs.filter((j) => j.goal === id && !j.worth);
 export function goalRows(ctx) {
   const { m } = ctx;
   if (!m.goals.length) return null;
-  return el('ul', { class: 'td-day__rows', 'data-day-list': 'goals' }, ...m.goals.map((g, i) => {
+  return el('ul', { class: 'td-day__rows', 'data-day-list': 'goals' }, ...m.goals.map((g) => {
     const js = jobsOf(m, g.id);
     const done = js.filter((j) => j.group === 'done').length;
     const need = js.filter((j) => j.group === 'needs').length;
@@ -51,8 +54,8 @@ export function goalRows(ctx) {
     const cur = ctx.cur('goal', g.id);
     return el('li', null, row({
       title: g.text, meta: [sub], done: closed, onOpen: () => ctx.select('goal', g.id),
-      lead: [el('span', { class: 'td-day__lead' }, String(i + 1))],
-      trail: [meter({ done: js.length ? done : g.status === 'done' ? 1 : 0, total: js.length || 1, label: '' })],
+      lead: [el('span', { class: 'td-day__lead' }, String(m.goalNo.get(g.id)))],
+      trail: [el('span', { class: 'td-day__chips' }, g.repo ? badge({ text: m.repoName(g.repo), tone: 'outline', attrs: { 'data-day-repo': g.repo } }) : null), meter({ done: js.length ? done : g.status === 'done' ? 1 : 0, total: js.length || 1, label: '' })],
       attrs: { class: 'td-day__r', 'data-day-sel': 'goal:' + g.id, 'data-goal': g.id, 'data-goal-coverage': g.coverage, 'data-cur': cur },
       openAttrs: { 'aria-current': cur },
     }));
@@ -62,7 +65,7 @@ export function goalRows(ctx) {
 export function goalAdd(ctx) {
   const { m } = ctx;
   const max = m.maxGoals;
-  if (m.goals.length >= max) return el('p', { class: 'td-day__note' }, G.full(max));
+  if (m.allGoals.length >= max) return el('p', { class: 'td-day__note' }, G.full(max));
   const f = field({ label: G.inputLabel, value: '', placeholder: G.inputHint, hideLabel: true, attrs: { 'data-goals': 'input', 'data-day-input': 'goal', maxlength: '140' },
     onCommit: async (v) => {
       if (!String(v).trim()) { draft = v; return; }
@@ -111,9 +114,9 @@ function stepNode(ctx, st) {
 /** The detail of one goal. `row(type, id, label, lead, trail)` draws a selectable row (today-day.js). */
 export function goalDetail(ctx, id, row) {
   const { m } = ctx;
-  const i = m.goals.findIndex((g) => g.id === id);
+  const i = m.allGoals.findIndex((g) => g.id === id);
   if (i < 0) return null;
-  const g = m.goals[i];
+  const g = m.allGoals[i];
   const closed = g.status !== 'open';
   const js = jobsOf(m, g.id);
   const meets = m.events.filter((e) => e.goal === g.id);
@@ -128,6 +131,9 @@ export function goalDetail(ctx, id, row) {
     el('div', { class: 'td-day__dhead' }, el('span', { class: 'td-day__kind' }, D.kind.goal(i + 1)), el('h3', null, g.text)),
     el('div', { class: 'td-day__acts' }, badge({ text: G.coverage[g.coverage] || g.coverage, tone: g.coverage === 'needs-plan' ? 'warning' : 'outline' }),
       g.initiative_id ? el('span', { class: 'td-day__mono' }, g.initiative_id) : null),
+    ctx.repoPicker && m.repos.length ? el('div', { class: 'td-day__ch', 'data-goals': 'repo' }, el('span', null, D.repo.label),
+      ctx.repoPicker(m, g.repo, (r) => press(ctx, { action: 'tag', id: g.id, repo: r }), { 'data-goal-repo': g.id })) : null,
+    ctx.repoPicker && m.repos.length ? el('p', { class: 'td-day__note' }, D.repo.goalHint) : null,
     js.length ? el('p', null, D.goalJobs(js.filter((j) => j.group === 'done').length, js.length)) : el('p', { class: 'td-day__note' }, G.noStep),
     meets.length ? el('div', { class: 'td-day__rel' }, el('h4', null, D.meetings), el('ul', { class: 'td-day__rows' }, ...meets.map((e) => row('event', e.id, e.title, e.time)))) : null,
     js.length ? el('div', { class: 'td-day__rel' }, el('h4', null, D.jobs), el('ul', { class: 'td-day__rows' }, ...js.map((j) => row('job', j.id, j.title, '', j)))) : null,

package/workspace/replaced-tests.json

@@ -2904,6 +2904,20 @@
       "names": [
         "E3b: an outcome check recorded ONLY in planning/runs/ disposes its initiative"
       ]
+    },
+    {
+      "id": "E72",
+      "group": "E",
+      "file": "workspace/d86-seams.test.js",
+      "section": "assertion 7: the registry's destination modules",
+      "change": "replaced",
+      "slice": "docs-three-way-sync",
+      "reason": "docs-three-way-sync adds a sixth destination, Docs (dest-docs.js), opened from ⌘K and g d. The assertion counted exactly five destination modules, so its name and count change.",
+      "replacement": "The same assertion 7 under a new name counts six destination modules; the three extensions and provider-cards.js first are unchanged.",
+      "pm_approval": null,
+      "names": [
+        "7 registry.js lists the five destination modules and the three extensions (provider-cards.js first)"
+      ]
     }
   ]
 }

package/workspace/server.js

@@ -128,6 +128,12 @@ const profilesLib = require('./lib/profiles');         // readProfiles(homeDir)
 const focus = require('./lib/focus');                  // buildFocus(input) → FocusView (cross-product)
 const handoff = require('./lib/handoff');              // readLinks(parsedFrontmatterObject) — never a path
 const fourPanel = require('./lib/four-panel');         // GET /api/initiative — the one-initiative join + the declaration stores
+const docSyncStore = require('./lib/doc-sync-store');
+// The session each repository's Check now started (workspace id → session id), so a second press while it runs refuses.
+const docCheckSessions = new Map();
+// The session each Use … version press started (workspace id|path|kind → { session, use }), so the line says "Updating…"
+// before the session has opened its sync, and a second press on the same copy refuses.
+const docSyncSessions = new Map();
 const planItems = require('./lib/plan-items.js');      // pm-os-absorb Run 1 — the ONE writer and fold of plan-items.jsonl (control graph)
 const planTree = require('./lib/plan-tree.js');        // …and the Breakdown layout: derived stages, owed rows, the Board columns
 const routeModules = require('./lib/route-modules.js'); // pm-os-absorb Runs 2–5 — each run's routes in its own lib/routes-<name>.js
@@ -6389,6 +6395,103 @@ async function handleRequest(req, res) {
     pushSessions();
     return json(res, { ok: true, id: s.id, initiative: next, attributed_by: s.attributedBy, previous });
   }
+  // ── Docs: the sync signal for documents linked to Google Docs and Confluence (docs-three-way-sync) ──────────────
+  // GET reads the links (the artifact-link store), the check readings and the files, and decides one signal per copy in
+  // lib/doc-sync.js. The POSTs add or remove a link, or start the read-only `doc-check` skill as a session — the same
+  // path a scheduled agent skill takes. No route here reads Google or Confluence: a session holding the PM's own
+  // connectors does, and records what it read (D53). There is no sync and no schedule: the PM asked for a signal.
+  if (p === '/api/docs' && req.method === 'GET') {
+    const w = getWs(url.searchParams.get('ws'));
+    const root = w ? w.root : SELF_ROOT;
+    const v = docSyncStore.view(root);
+    if (!v.ok) return json(res, v, 500);
+    const alive = (id) => !!(id && sessions.get(id) && sessions.get(id).state !== 'exited');
+    const sess = docCheckSessions.get(w ? w.id : '') || null;
+    const live = alive(sess) ? sess : null;
+    // Group by initiative: the library's own attribution of each file (pmos-shaped repositories only).
+    const owner = new Map();
+    try {
+      if (wsShape(root) === 'pmos') {
+        for (const g of initiativeIndex(root).initiatives) for (const a of g.artifacts) if (!owner.has(a.path)) owner.set(a.path, { id: g.id, title: g.title || g.id });
+      }
+    } catch { /* no grouping: every document is under Other */ }
+    const wid = w ? w.id : '';
+    const docs = v.docs.map((d) => ({
+      ...d,
+      initiative: owner.get(d.path) || (d.initiative_id ? { id: d.initiative_id, title: d.initiative_id } : null),
+      links: d.links.map((l) => {
+        if (l.syncing) return l;
+        const ps = docSyncSessions.get(`${wid}|${d.path}|${l.kind}`);
+        return ps && alive(ps.session) ? { ...l, syncing: { run: null, use: ps.use, started_at: ps.at } } : l;
+      }),
+    }));
+    return json(res, { ...v, docs, ws: w ? w.id : null, session: live, connectors: fourPanel.connectors(os.homedir()) });
+  }
+  if (p === '/api/docs/files' && req.method === 'GET') {
+    const w = getWs(url.searchParams.get('ws'));
+    const root = w ? w.root : SELF_ROOT;
+    const found = docSyncStore.findFiles(root, String(url.searchParams.get('q') || '').slice(0, 200));
+    const v = docSyncStore.view(root);
+    const linked = new Set(v.ok ? v.docs.map((d) => d.path) : []);
+    return json(res, { ok: true, files: found.filter((f) => !linked.has(f.path)) });
+  }
+  if ((p === '/api/docs/link' || p === '/api/docs/unlink' || p === '/api/docs/check' || p === '/api/docs/sync') && req.method === 'POST') {
+    let body = {}; try { body = JSON.parse((await readBody(req)) || '{}'); } catch { return json(res, { ok: false, error: 'invalid JSON body' }, 400); }
+    const g = pmGuard.requirePagePress(req, body);
+    if (!g.ok) return json(res, { ok: false, error: g.error }, g.status);
+    const w = body.ws ? workspaces.get(String(body.ws)) : getWs(null);
+    if (!w) return json(res, { ok: false, error: 'no such workspace' }, 404);
+    if (p === '/api/docs/link') {
+      const r = docSyncStore.addLink(w.root, { path: String(body.path || '').trim(), kind: body.kind, target: String(body.target || '').trim() });
+      return json(res, r.ok ? { ok: true } : { ok: false, error: r.error }, r.ok ? 200 : 400);
+    }
+    if (p === '/api/docs/unlink') {
+      const r = docSyncStore.removeLink(w.root, { path: String(body.path || ''), kind: body.kind });
+      return json(res, r.ok ? { ok: true } : { ok: false, error: r.error }, r.ok ? 200 : 400);
+    }
+    // Use … version (amended 2026-10-06): one doc-sync session for one copy, in the direction the PM pressed. The page
+    // holds the press for five seconds behind Undo before it posts here. The session writes one side with the PM's own
+    // connectors and records it through `pmos docs sync-start|sync-finish|sync-fail`; nothing here touches a copy.
+    if (p === '/api/docs/sync') {
+      const rel = String(body.path || '').trim();
+      const kind = String(body.kind || '');
+      const use = String(body.use || '');
+      if (!['pmos', 'copy'].includes(use)) return json(res, { ok: false, error: 'say which version to use: pmos or copy' }, 400);
+      const v = docSyncStore.view(w.root);
+      if (!v.ok) return json(res, v, 500);
+      const doc = v.docs.find((d) => d.path === rel);
+      const link = doc && doc.links.find((l) => l.kind === kind);
+      if (!link) return json(res, { ok: false, error: `${rel} has no such copy` }, 404);
+      const key = `${w.id}|${rel}|${kind}`;
+      const prevSync = docSyncSessions.get(key);
+      if (link.syncing || (prevSync && sessions.get(prevSync.session) && sessions.get(prevSync.session).state !== 'exited')) {
+        return json(res, { ok: false, error: 'that copy is already being synced' }, 409);
+      }
+      const task = taskById('doc-sync', w.root);
+      if (!task || !task.prompt) return json(res, { ok: false, error: 'the doc-sync skill is not installed' }, 500);
+      const ask = `\n\nThis sync:\n- file: ${rel}\n- copy: ${kind} (${link.target})\n- use: ${use}`;
+      const s = spawnSession({ name: 'Doc sync', agent: task.agent || 'claude', ws: w.id, origin: 'docs:sync',
+        initialInput: task.prompt + ask + '\r', modelAsk: { skillTier: task.tier || null, skill: task.skill } });
+      const started = s.state !== 'exited';
+      if (started) docSyncSessions.set(key, { session: s.id, use, at: new Date().toISOString() });
+      return json(res, { ok: started, session: s.id, error: started ? undefined : (s.note || 'could not start the session') }, started ? 200 : 500);
+    }
+    // Check now: one check per repository. A session already running, or a check the ledger still holds open, refuses.
+    const prev = docCheckSessions.get(w.id);
+    if (prev && sessions.get(prev) && sessions.get(prev).state !== 'exited') {
+      return json(res, { ok: false, error: 'a check is already running', session: prev }, 409);
+    }
+    const v = docSyncStore.view(w.root);
+    if (v.ok && v.open) return json(res, { ok: false, error: `a check is already running (started ${v.open.started_at})` }, 409);
+    if (v.ok && !v.docs.length) return json(res, { ok: false, error: 'no document is linked yet — add a link first' }, 400);
+    const task = taskById('doc-check', w.root);
+    if (!task || !task.prompt) return json(res, { ok: false, error: 'the doc-check skill is not installed' }, 500);
+    const s = spawnSession({ name: 'Doc check', agent: task.agent || 'claude', ws: w.id, origin: 'docs:check',
+      initialInput: task.prompt + '\r', modelAsk: { skillTier: task.tier || null, skill: task.skill } });
+    const started = s.state !== 'exited';
+    if (started) docCheckSessions.set(w.id, s.id);
+    return json(res, { ok: started, session: s.id, error: started ? undefined : (s.note || 'could not start the session') }, started ? 200 : 500);
+  }
   if (p === '/api/initiative/link' && req.method === 'POST') {
     // Recording that an artifact corresponds to an external page. This writes a DECLARATION and
     // makes no request: PMOS holds no credential, so it can state what the PM says the mapping is
@@ -7257,7 +7360,10 @@ async function handleRequest(req, res) {
       : (!!bs.ended_at || !bsess || bsess.state === 'exited') ? { session: bs.id, why: (bsess && bsess.note) || 'the session ended without submitting a brief.' }
       : briefSessionDone(run, date, now) === 'idle' ? { session: bs.id, idle: true, why: 'the session has printed nothing for two minutes and has not submitted a brief.' } : null;
     return json(res, { ok: true, ws: w ? w.id : null, today: date, now: new Date(now).toISOString(), run, stage: dayRunLib.stage(run, brief), brief, plan, cards_error: cardsError, read_failed: readFailed,
-      settings: { briefSources: st.briefSources, scopes: st.scopes, dayCheck: st.dayCheck, websites: st.websites }, sources,
+      settings: { briefSources: st.briefSources, scopes: st.scopes, placeRepos: st.placeRepos, dayCheck: st.dayCheck, websites: st.websites }, sources,
+      // one day for every repository: the repositories it can be narrowed to, and the repository of each tagged item
+      repos: [...workspaces.values()].map((x) => ({ id: x.id, name: x.name || path.basename(x.root) })),
+      item_repos: goalsLib.itemRepos({ day: readGoalsDay(date), brief, placeRepos: st.placeRepos || {} }),
       check: { every: st.dayCheck.every, last: run ? run.checks.last : null, next: due.next, running: !!(run && run.checks.session_id), log: run ? run.checks.log : [] } });
   }
   if (p.startsWith('/api/proactive/day/') && req.method === 'POST') {
@@ -7396,7 +7502,9 @@ async function handleRequest(req, res) {
       const bs = body.scopes && typeof body.scopes === 'object' && !Array.isArray(body.scopes) ? body.scopes : null;
       const scopes = bs ? { ...cur.scopes, ...Object.fromEntries(Object.entries(bs).map(([k, v]) => [k, v && typeof v === 'object' && !Array.isArray(v) ? { ...(cur.scopes[k] || {}), ...v } : v])) } : cur.scopes;
       const dayCheck = body.dayCheck && typeof body.dayCheck === 'object' && !Array.isArray(body.dayCheck) ? { ...cur.dayCheck, ...body.dayCheck } : (body.dayCheck === undefined ? cur.dayCheck : body.dayCheck);
-      const n = proactiveLib.normalizeSettings({ ...cur, ...body, triggers: { ...cur.triggers, ...(body.triggers || {}) }, briefSources: { ...cur.briefSources, ...(body.briefSources || {}) }, scopes, dayCheck });
+      const bpr = body.placeRepos && typeof body.placeRepos === 'object' && !Array.isArray(body.placeRepos) ? body.placeRepos : null;
+      const placeRepos = bpr ? { ...cur.placeRepos, ...Object.fromEntries(Object.entries(bpr).map(([k, v]) => [k, v && typeof v === 'object' && !Array.isArray(v) ? { ...((cur.placeRepos || {})[k] || {}), ...v } : v])) } : cur.placeRepos;
+      const n = proactiveLib.normalizeSettings({ ...cur, ...body, placeRepos, triggers: { ...cur.triggers, ...(body.triggers || {}) }, briefSources: { ...cur.briefSources, ...(body.briefSources || {}) }, scopes, dayCheck });
       if (!n.ok) return json(res, { ok: false, error: n.error }, 400);
       try { fs.mkdirSync(STATE, { recursive: true }); fs.writeFileSync(PRO_SETTINGS(), JSON.stringify(n.settings) + '\n'); }
       catch (e) { warnWriteFail('proactive-settings.json', e); return json(res, { ok: false, error: 'could not save — nothing changed' }, 500); }

package/workspace/skills/doc-check.skill

@@ -0,0 +1,40 @@
+---
+name: doc-check
+label: "Check linked documents against Google Docs and Confluence"
+description: "Read the Google Docs and Confluence copies of every linked document and record whether each is the same as the repository file. Read-only: it writes no document, page or file."
+run: agent
+agent: claude
+output:
+  - Same
+  - Ahead or behind
+  - Edited in both
+  - Could not check
+---
+
+/doc-check — read every Google Docs and Confluence copy of a linked document in THIS repository and record what you saw. PMOS then shows the PM, per document, whether the repository copy is the same as, ahead of or behind each copy.
+
+The PM asked for a signal, not a sync. You read; you never write.
+
+Rules that always hold:
+1. READ-ONLY EVERYWHERE. Never create, update, move, rename, comment on, share or delete a Google Doc, a Drive file or a Confluence page. Never edit, create or delete a file in this repository. Never commit or push.
+2. THE ONLY WRITES are `pmos docs check-start`, `pmos docs record` and `pmos docs check-finish`. Never write a `*.jsonl` file by hand.
+3. RECORD ONLY WHAT YOU READ. A version, a modified time or a title that you did not read from the copy is not recorded. If you cannot read a copy, record the error. Do not guess.
+4. USE THE PM'S CONNECTORS. Google Docs: the Google Drive tools (file metadata and file content). Confluence: the Atlassian tools (get the page, with its version). If a connector is missing or refuses, record that as the error for each of its copies and go on with the others.
+5. "SAME" MEANS THE SAME DOCUMENT. Compare the copy's text with the repository file's body as documents: the same headings, paragraphs, lists and tables, in the same order. Ignore formatting, whitespace, the YAML frontmatter of the repository file and the copy's title. If any sentence, item or row differs, it is not the same. If you cannot tell, it is not the same: set `same: false` and say why in `note`.
+
+Procedure:
+1. Run `pmos docs check-start --json`. Keep `run` (the check id) and `links`. Each link has `path`, `kind` (google or confluence), `target` (the address), `remote_id` and `repo_hash`. If it says a check is already running, stop and report that.
+2. For each link, in order:
+   a. Read the copy's metadata. Google: the file's `modifiedTime`, its revision or version, who last modified it, and whether it is trashed. Confluence: the page's `version.number`, its last-modified time and who made that version.
+   b. If the copy does not exist or is in the trash, the reading is `{"path","kind","remote_id","exists":false}`.
+   c. If reading failed for any other reason (no access, no connector, an error), the reading is `{"path","kind","remote_id","error":"<the error, in one line>"}`.
+   d. Otherwise read the copy's content and the repository file `path` (skip this when `repo_hash` is null: the file is not in the repository). Decide `same` by rule 5. The reading is `{"path","kind","remote_id","exists":true,"version":"<version>","modified_at":"<ISO time>","modified_by":"<the person's name, when the copy says it>","title":"<the copy's title>","url":"<its address>","same":true|false,"repo_hash":"<repo_hash from step 1>","note":"<one line when same is false: the first difference>"}`.
+3. Write all readings as a JSON list to a file outside the repository (for example in /tmp) and run `pmos docs record <run> --file <that file>`. If a reading is refused, fix that reading from what you actually read and record it again; never invent a value to get it accepted.
+4. Run `pmos docs check-finish <run> --summary "<n> same, <n> ahead or behind, <n> edited in both, <n> could not check"`.
+5. Run `pmos docs list` and report it in the output sections below.
+
+Output contract — produce EXACTLY these sections, the same shape every run, one short line per document and copy:
+- Same
+- Ahead or behind
+- Edited in both
+- Could not check

package/workspace/skills/doc-sync.skill

@@ -0,0 +1,34 @@
+---
+name: doc-sync
+label: "Sync one linked document with its Google Docs or Confluence copy"
+description: "Write one version of a linked document over the other, in the direction the PM pressed: the PMOS version to the copy, or the copy's version to the repository file. One copy, one side, nothing else."
+run: agent
+agent: claude
+output:
+  - Written
+  - Not written
+---
+
+/doc-sync — the PM pressed "Use … version" for ONE copy of ONE document in Docs. Write that version over the other side, record it, and stop. The lines after this procedure name the file, the copy and the version to use.
+
+Rules that always hold:
+1. ONE COPY, ONE SIDE. With `use: pmos`, write the repository file's text to the copy, and change nothing in the repository. With `use: copy`, write the copy's text to the repository file, and change nothing in Google Docs or Confluence. Never write the other side, another copy, or another file.
+2. NEVER CREATE, MOVE, RENAME, SHARE OR DELETE. Update the existing Google Doc or Confluence page in place. If it does not exist or is in the trash, do not create it: record the sync as failed.
+3. KEEP THE FRONTMATTER. The repository file may start with a YAML frontmatter block (between two `---` lines). With `use: copy`, keep that block exactly as it is and replace only the text after it. With `use: pmos`, do not write the frontmatter to the copy.
+4. KEEP THE DOCUMENT. Convert between markdown and the copy's format faithfully: the same headings, paragraphs, lists, tables and links, in the same order. Do not add a summary, a note or a heading of your own.
+5. THE ONLY RECORDS are `pmos docs sync-start`, `pmos docs sync-finish` and `pmos docs sync-fail`. Never write a `*.jsonl` file by hand. Never commit or push: the PM's own Sync does that.
+6. USE THE PM'S CONNECTORS. Google Docs: the Google Drive tools. Confluence: the Atlassian tools. If the PM is asked to allow the write, that is expected; wait for their answer. If the connector is missing or refuses, record the sync as failed with the error.
+
+Procedure:
+1. Run `pmos docs sync-start <file> <google|confluence> --use <pmos|copy> --json` with the values below. Keep `run`, `target` and `remote_id`. If it is refused (for example, the copy is already being synced), stop and report the reason.
+2. Read the copy (its content, its version and its last-modified time) and the repository file.
+3. Write, by rule 1 to rule 4:
+   - `use: pmos`: update the copy's content with the repository file's body. Confluence: update the page with its next version number and keep its title. Google Docs: replace the document's content.
+   - `use: copy`: replace the repository file's body with the copy's content, converted to markdown. Keep the frontmatter.
+4. Read the copy again and take its version and last-modified time AFTER the write (with `use: copy` the copy did not change; take what you read in step 2).
+5. Run `pmos docs sync-finish <run> --version "<version>" --modified-at "<ISO time>" --url "<the copy's address>"`.
+6. If any step failed, run `pmos docs sync-fail <run> --reason "<the error, in one line>"` instead of step 5, and say what was and was not written.
+
+Output contract — produce EXACTLY these sections, one short line each:
+- Written
+- Not written

package/workspace/test-lists/docs-three-way-sync.json

@@ -0,0 +1,6 @@
+{
+  "_comment": "docs-three-way-sync: the sync signal for documents linked to Google Docs and Confluence.",
+  "modules": ["doc-sync.test.js", "docs-cli.test.js"],
+  "panels": ["pm-docs-test.js"],
+  "seconds": { "doc-sync.test.js": 1, "docs-cli.test.js": 6, "pm-docs-test.js": 60 }
+}