create-pmos 0.252.0 → 0.254.0

package/workspace/lib/briefing-premium-writes.js

@@ -0,0 +1,138 @@
+'use strict';
+/* briefing-premium-writes.js — what the premium Briefing's buttons record (initiative briefing-premium-writes).
+ *
+ *   decide({ root, key, choice, why, now })      → { ok, heading } | { ok: false, status, error }   appends one entry to <root>/pm-decisions.md
+ *   putOff({ runtimeDir, key, until, now })      → { ok, until } | …                                 appends one line to briefing-premium-deferred.jsonl
+ *   returnRun({ root, runtimeDir, run, reason, now }) → { ok } | …                                   appends one correction to corrections.jsonl
+ *   readDefers(runtimeDir, now) · decidedPrototypes(root)
+ *
+ * The caller has already proved the actor is the PM (lib/pm-guard.js requirePagePress). Every writer appends and never rewrites a line.
+ * File names are fixed here; no request chooses a path. A refused request changes no file. Nothing here sends anything outward. */
+const fs = require('fs');
+const path = require('path');
+
+const refuse = (status, error) => ({ ok: false, status, error });
+const ID_RE = /^[A-Za-z0-9][A-Za-z0-9._-]{0,80}$/;
+const KEY_RE = /^(decision|blocked|waited|ev):[A-Za-z0-9][A-Za-z0-9._:-]{0,100}$/;
+const PROTO_CHOICES = ['promote', 'iterate', 'kill'];
+const TRIPWIRE_CHOICES = ['reshape', 'extend', 'retire'];
+const UNTIL = ['later', 'tomorrow', 'nextweek'];
+const DEFERRED = 'briefing-premium-deferred.jsonl';
+const iso = (ms) => new Date(ms).toISOString();
+const day = (ms) => { const d = new Date(ms); return d.getFullYear() + '-' + String(d.getMonth() + 1).padStart(2, '0') + '-' + String(d.getDate()).padStart(2, '0'); };
+const oneLine = (s) => String(s == null ? '' : s).replace(/\s+/g, ' ').trim();
+
+function appendLine(file, obj) {
+  fs.mkdirSync(path.dirname(file), { recursive: true });
+  fs.appendFileSync(file, JSON.stringify(obj) + '\n');
+}
+function readLines(file) {
+  let t; try { t = fs.readFileSync(file, 'utf8'); } catch { return []; }
+  return t.split('\n').map((l) => l.trim()).filter(Boolean).map((l) => { try { return JSON.parse(l); } catch { return null; } }).filter(Boolean);
+}
+function readText(file) { try { return fs.readFileSync(file, 'utf8'); } catch { return ''; } }
+
+/** The prototype ids that have a disposition entry in pm-decisions.md (heading "## YYYY-MM-DD — Prototype disposition: <id> — <choice>"). */
+function decidedPrototypes(root) {
+  const out = new Set();
+  const re = /^## \d{4}-\d{2}-\d{2} — Prototype disposition: ([A-Za-z0-9._-]+) — (promote|iterate|kill)\s*$/gm;
+  const t = readText(path.join(root, 'pm-decisions.md'));
+  for (let m; (m = re.exec(t));) out.add(m[1]);
+  return out;
+}
+
+function frontLane(root, id) {
+  const t = readText(path.join(root, 'planning', 'initiatives', id + '.md'));
+  const m = /^---\n([\s\S]*?)\n---/.exec(t);
+  if (!m) return null;
+  const l = /^lane:\s*(.+)$/m.exec(m[1]);
+  return l ? l[1].trim().replace(/^"(.*)"$/, '$1') : '';
+}
+/** The date a tripwire fired on (its row in kill-conditions.md, the bold date), or null when the row is not there. */
+function tripwireDate(root, id) {
+  const t = readText(path.join(root, 'planning', 'okrs', 'kill-conditions.md'));
+  const m = new RegExp('^\\|\\s*' + id + '\\s*\\|\\s*[^|]+?\\s*\\|\\s*[^|]+?\\*\\*(\\d{4}-\\d{2}-\\d{2})\\*\\*', 'm').exec(t);
+  return m ? m[1] : null;
+}
+function tripwireDecided(root, id, date) {
+  // The page's own reading: an entry dated on or after the fire date that names the id.
+  const t = readText(path.join(root, 'pm-decisions.md'));
+  return t.split(/^## /m).slice(1).some((b) => /^\d{4}-\d{2}-\d{2}/.test(b) && b.slice(0, 10) >= date && new RegExp('\\b' + id + '\\b').test(b));
+}
+
+function decide({ root, key, choice, why, now }) {
+  now = now || Date.now();
+  const m = /^decision:([A-Za-z0-9._-]+)$/.exec(String(key || ''));
+  if (!m || !ID_RE.test(m[1])) return refuse(400, 'key must name a decision row');
+  const id = m[1];
+  const reason = oneLine(why);
+  if (reason.length < 3) return refuse(400, 'a decision needs your reason');
+  if (reason.length > 1200) return refuse(400, 'the reason is too long (1200 characters at most)');
+  const isTrip = /^KC\d+$/.test(id);
+  if (isTrip) {
+    if (!TRIPWIRE_CHOICES.includes(choice)) return refuse(400, 'choose one of: ' + TRIPWIRE_CHOICES.join(', '));
+    const fired = tripwireDate(root, id);
+    if (!fired) return refuse(404, id + ' has no dated row in planning/okrs/kill-conditions.md');
+    if (tripwireDecided(root, id, fired)) return refuse(409, 'a decision that names ' + id + ' is already on record');
+  } else {
+    if (!PROTO_CHOICES.includes(choice)) return refuse(400, 'choose one of: ' + PROTO_CHOICES.join(', '));
+    const lane = frontLane(root, id);
+    if (lane === null) return refuse(404, id + ' is not an initiative in this repository');
+    if (lane !== 'prototype') return refuse(409, id + ' is not a prototype, so it takes no disposition');
+    if (decidedPrototypes(root).has(id)) return refuse(409, 'a disposition for ' + id + ' is already on record');
+  }
+  const file = path.join(root, 'pm-decisions.md');
+  const heading = day(now) + ' — ' + (isTrip ? 'Tripwire ' + id + ' decided' : 'Prototype disposition: ' + id) + ' — ' + choice;
+  const block = [
+    '## ' + heading,
+    '- context: ' + (isTrip ? 'tripwire ' + id + ' passed its date with no decision on record; recorded from the premium Briefing' : 'prototype ' + id + ' waited for a disposition (D60); recorded from the premium Briefing'),
+    '- decision: ' + (isTrip ? id + ' ' + choice : choice) + ' (chosen by the PM)',
+    '- rationale: ' + reason,
+    '- supersedes: none',
+    '',
+  ].join('\n');
+  let cur = readText(file);
+  const lead = cur === '' || cur.endsWith('\n\n') ? '' : cur.endsWith('\n') ? '\n' : '\n\n';
+  fs.appendFileSync(file, lead + block);
+  return { ok: true, heading };
+}
+
+function untilMs(until, now) {
+  const d = new Date(now);
+  if (until === 'later') return now + 3 * 3600 * 1000;
+  if (until === 'tomorrow') { d.setDate(d.getDate() + 1); d.setHours(9, 0, 0, 0); return d.getTime(); }
+  const add = ((8 - d.getDay()) % 7) || 7;   // the next Monday
+  d.setDate(d.getDate() + add); d.setHours(9, 0, 0, 0); return d.getTime();
+}
+function putOff({ runtimeDir, key, until, now }) {
+  now = now || Date.now();
+  if (!runtimeDir) return refuse(409, 'this workspace has no state folder to keep the answer in');
+  if (!KEY_RE.test(String(key || ''))) return refuse(400, 'key must name a row');
+  if (!UNTIL.includes(until)) return refuse(400, 'choose one of: ' + UNTIL.join(', '));
+  const at = untilMs(until, now);
+  appendLine(path.join(runtimeDir, DEFERRED), { key, until: at, choice: until, at: iso(now), by: 'pm' });
+  return { ok: true, until: at };
+}
+/** key → the time (ms) the row returns, for lines still in the future. The latest line for a key wins. */
+function readDefers(runtimeDir, now) {
+  const out = new Map();
+  if (!runtimeDir) return out;
+  for (const l of readLines(path.join(runtimeDir, DEFERRED))) if (l && typeof l.key === 'string' && Number.isFinite(l.until)) out.set(l.key, l.until);
+  for (const [k, v] of [...out]) if (v <= (now || Date.now())) out.delete(k);
+  return out;
+}
+
+const RETURN_REASONS = ['wrong facts', 'wrong scope', 'not now', 'too long'];   // the reply contract's closed list (scripts/reply-contract)
+function returnRun({ root, runtimeDir, run, reason, now, correctionEvent, appendOutbox }) {
+  now = now || Date.now();
+  if (!runtimeDir) return refuse(409, 'this workspace has no state folder to keep the correction in');
+  if (typeof run !== 'string' || !ID_RE.test(run)) return refuse(400, 'run must be a run id');
+  if (!RETURN_REASONS.includes(reason)) return refuse(400, 'choose one reason: ' + RETURN_REASONS.join(', '));
+  if (!readLines(path.join(root, 'planning', 'runs', 'agent-runs.jsonl')).some((r) => r && r.run_id === run)) return refuse(404, run + ' is not in planning/runs/agent-runs.jsonl');
+  let ev;
+  try { ev = correctionEvent('reject', reason, run, new Date(now)); } catch (e) { return refuse(400, e.message); }
+  appendOutbox(path.join(runtimeDir, 'corrections.jsonl'), ev);
+  return { ok: true };
+}
+
+module.exports = { decide, putOff, returnRun, readDefers, decidedPrototypes, untilMs, PROTO_CHOICES, TRIPWIRE_CHOICES, UNTIL, RETURN_REASONS };