create-pmos 0.239.0 → 0.241.0

package/workspace/lib/routes-mentions.js

@@ -0,0 +1,37 @@
+'use strict';
+/* routes-mentions.js — POST /api/mentions/read { id, read } → { ok }   (initiative c3-brief-summary-mentions)
+ *
+ * The PM marked a mention of today's brief read on the Briefing (read: false undoes it). One appended line in <runtime>/mentions/read.jsonl:
+ * { id, read, at }. GET /api/brief-page reads the file back (routes-brief-page.js readMarks: the last line for an id wins).
+ * The page press only (pm-guard requirePagePress). Nothing is sent to Slack, Jira, Confluence or mail. */
+const path = require('path');
+const guard = require('./pm-guard.js');
+const pmItems = require('./pm-items.js');
+const { MENTION_ID } = require('./routes-brief-page.js');
+
+/** The check of a body: null when it is good, else the reason. Pure. */
+function badBody(b) {
+  if (!b || !MENTION_ID.test(String(b.id || ''))) return 'id must be a mention id (12 hex characters)';
+  if (typeof b.read !== 'boolean') return 'read must be true or false';
+  return null;
+}
+
+module.exports = {
+  prefixes: ['/api/mentions'],
+  badBody,
+  handle: async (req, res, url, ctx) => {
+    if (url.pathname !== '/api/mentions/read') return false;
+    if (req.method !== 'POST') { ctx.json(res, { ok: false, error: 'POST only' }, 405); return true; }
+    const got = await ctx.readJson(req);
+    if (!got.ok) { ctx.json(res, { ok: false, error: 'invalid JSON body' }, 400); return true; }
+    const b = got.body || {};
+    const g = guard.requirePagePress(req, b);
+    if (!g.ok) { ctx.json(res, { ok: false, error: g.error }, g.status); return true; }
+    const err = badBody(b);
+    if (err) { ctx.json(res, { ok: false, error: err }, 400); return true; }
+    if (!ctx.runtimeDir) { ctx.json(res, { ok: false, error: 'no runtime folder' }, 500); return true; }
+    pmItems.appendEvent(path.join(ctx.runtimeDir, 'mentions', 'read.jsonl'), { id: b.id, read: b.read }, new Date());
+    ctx.json(res, { ok: true });
+    return true;
+  },
+};

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

@@ -2,7 +2,8 @@
 /* routes-report-setups.js — the Reports workspace's routes (initiative report-workspace, PRD sections 2 to 6).
  *
  *   GET  /api/report-setups?ws        → { setups: [{ id, name, purpose, audience, source, output, schedule, label, next_draft, last_issued, status, cycles,
- *                                                     copy: { kind, state: none|in-step|pmos-ahead|copy-changed|not-checked, url } }],
+ *                                                     copy: { kind, state: none|in-step|pmos-ahead|copy-changed|not-checked, url },
+ *                                                     structure: { saved, at, charts, sections } | null   the saved report structure (initiative report-structure) }],
  *                                         findings: [{ id, name, why, evidence: [{ kind, text }], confidence: likely|not-sure, proposal }],
  *                                         asks: [{ id, text, state: running|ready|failed, changed, proposal, error }],
  *                                         finder: { cadence, sources: { calendar, slack, mail, drive }, last_run, next_run } }
@@ -119,7 +120,10 @@ function documentsOf(ctx, w) {
   return { docs, reports: r.reports };
 }
 
-function setupOut(s, now, docsOf, idx) {
+/** The saved structure of a report (initiative report-structure): { saved, at, charts, sections }, else null. */
+function structureOf(root, id) { try { return require('./report-structure.js').savedOf(root, id); } catch { return null; } }
+
+function setupOut(s, now, docsOf, idx, root) {
   const mine = (docsOf.reports || []).filter((x) => x.cadence === s.id);
   const issued = mine.filter((x) => x.issued).map((x) => x.slot).sort().pop() || null;
   const latest = mine.slice().sort((a, b) => (a.slot < b.slot ? 1 : -1))[0] || null;
@@ -129,6 +133,7 @@ function setupOut(s, now, docsOf, idx) {
     id: s.id, name: s.name, purpose: s.purpose, audience: s.audience, source: s.source, output: s.output, schedule: s.schedule, label: RS.scheduleLabel(s.schedule),
     next_draft: next, last_issued: issued, status: s.status, cycles: mine.length,
     copy: copyOf(latest ? linkFor(idx, latest.path, s.output) : null, docSync.copyKindOf(s.output)),
+    structure: structureOf(root, s.id),
   };
 }
 
@@ -157,7 +162,7 @@ function listAnswer(ctx, w, now) {
   const docsOf = documentsOf(ctx, w);
   const idx = copyIndex(w.root);
   return {
-    setups: [...st.setups.values()].map((s) => setupOut(s, new Date(now), docsOf, idx)),
+    setups: [...st.setups.values()].map((s) => setupOut(s, new Date(now), docsOf, idx, w.root)),
     findings: RS.openFindings(st).map((f) => ({ id: f.id, name: f.name, why: f.why, evidence: f.evidence, confidence: f.confidence, proposal: f.proposal })),
     asks: [...st.asks.values()].map((a) => ({ id: a.id, text: a.text, state: a.state, changed: !!a.changed, proposal: a.proposal, error: a.error })),
     finder: finderOut(ctx, st, now),
@@ -341,7 +346,7 @@ async function handle(req, res, url, ctx) {
     // in place and says why; Draft it now on the row tries again.
     const drafted = firstDraft(root, r, g.actor);
     if (drafted.path) ctx.invalidateNeedsAgg && ctx.invalidateNeedsAgg();
-    return send({ status: 200, body: { ok: true, setup: setupOut(r.setup, new Date(), documentsOf(ctx, w), copyIndex(root)), first_draft: r.first_draft, drafted } });
+    return send({ status: 200, body: { ok: true, setup: setupOut(r.setup, new Date(), documentsOf(ctx, w), copyIndex(root), root), first_draft: r.first_draft, drafted } });
   }
   if (sub === 'dismiss') {
     const r = RS.dismissFinding(file, { id: text(body.finding), by: g.actor });
@@ -363,7 +368,7 @@ async function handle(req, res, url, ctx) {
   if (sub === 'pause' || sub === 'resume') {
     const r = RS[sub](root, text(body.id), opts);
     if (!r.ok) return fail(r);
-    return send({ status: 200, body: { ok: true, setup: setupOut(r.setup, new Date(), documentsOf(ctx, w), copyIndex(root)) } });
+    return send({ status: 200, body: { ok: true, setup: setupOut(r.setup, new Date(), documentsOf(ctx, w), copyIndex(root), root) } });
   }
   if (sub === 'from-dashboard') {
     const key = text(body.key);
@@ -376,7 +381,7 @@ async function handle(req, res, url, ctx) {
       schedule: body.schedule, sources: [`The ${name} dashboard`], sections: RS.FRAME.slice(), learned_from: 'Set up from the dashboard.', fixes: [] };
     const r = RS.setUp(root, proposal, opts);
     if (!r.ok) return fail(r);
-    return send({ status: 200, body: { ok: true, setup: setupOut(r.setup, new Date(), { reports: [] }, new Map()) } });
+    return send({ status: 200, body: { ok: true, setup: setupOut(r.setup, new Date(), { reports: [] }, new Map(), root) } });
   }
   if (sub === 'finder') {
     const r = RS.setFinder(file, { cadence: body.cadence, sources: body.sources, by: g.actor });