create-pmos 0.52.0 → 0.53.0

package/workspace/public/pm/portfolio-report.js

@@ -0,0 +1,61 @@
+/* pm/portfolio-report.js — the portfolio report, as three ⌘K commands (pm-os-absorb Run 3, slice 3D; PRD R29).
+ *
+ * The Portfolio mode is cut (R29): "All repositories" is a choice in Repository ▾ and the per-repository numbers are in Today and
+ * Initiatives. What the mode still did that nothing else does is write a report across every repository into the hub repository
+ * (`POST /api/reports`: weekly, OKR, or the initiatives that match a question). That call keeps its one caller here, on a press:
+ *
+ *   Portfolio report: weekly       writes the weekly report
+ *   Portfolio report: OKR          writes the OKR report
+ *   Portfolio report: matching…    asks which initiatives to report on, then writes it
+ *
+ * Each command reads the server's answer and says what happened: the path it wrote and a note for anything it could not read, or
+ * the server's own reason (for example, no hub repository is set up). The file opens as a document tab. Nothing is written
+ * until the PM runs a command. Registered when this module loads (panel-cockpit.js imports it); never in fixture mode.
+ */
+
+import { state, FIXTURE } from './state.js';
+import { pmPost } from './http.js';
+import { toast } from './primitives.js';
+import { askText } from './dialogs.js';
+import { registerCommand } from './registry.js';
+import { openDoc } from './panel-initiatives.js';
+
+export const REPORT_COPY = Object.freeze({
+  weekly: 'Portfolio report: weekly',
+  okr: 'Portfolio report: OKR',
+  query: 'Portfolio report: matching…',
+  hint: 'all repositories',
+  askTitle: 'Report on matching initiatives',
+  askLabel: 'Which initiatives? Type words from their names.',
+  askConfirm: 'Write report',
+  writing: 'Writing the report…',
+  written: (path) => 'Report written to ' + path,
+  unread: (names) => 'Not fully read: ' + names.join(', '),
+  failed: 'The report was not written.',
+});
+
+/** Write one report. Resolves to the server's answer, or null when the PM backed out of the question. */
+export async function writeReport(kind) {
+  let q = '';
+  if (kind === 'query') {
+    const asked = await askText({ title: REPORT_COPY.askTitle, label: REPORT_COPY.askLabel, value: state.q || '', confirmLabel: REPORT_COPY.askConfirm });
+    if (asked === null || !String(asked).trim()) return null;
+    q = String(asked).trim();
+  }
+  toast({ text: REPORT_COPY.writing, timeout: 2000 });
+  const out = await pmPost('/api/reports', { kind, q });
+  if (!out || out.ok === false) {
+    toast({ text: (out && out.error) || REPORT_COPY.failed, tone: 'error' });
+    return out || { ok: false };
+  }
+  const unread = Array.isArray(out.unread) ? out.unread : [];
+  toast({ text: REPORT_COPY.written(out.path) + (unread.length ? '. ' + REPORT_COPY.unread(unread) : '') });
+  if (out.path) openDoc(null, out.path, 'FILE', out.ws ? { ws: out.ws, branch: null, linked: true } : null);
+  return out;
+}
+
+if (!FIXTURE) {
+  for (const kind of ['weekly', 'okr', 'query']) {
+    registerCommand({ id: 'portfolio-report-' + kind, label: REPORT_COPY[kind], hint: REPORT_COPY.hint, run: () => writeReport(kind) });
+  }
+}