create-pmos 0.116.0 → 0.117.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pmos",
-  "version": "0.116.0",
+  "version": "0.117.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@affb04c
+kernel-source: pmos@fc4f107
 assembled: 2026-10-08
 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-08T06:17:49Z"}
+generated: {by: process:create-pmos, at: "2026-10-08T06:49:50Z"}
 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-08T06:17:49Z"}
+generated: {by: process:create-pmos, at: "2026-10-08T06:49:50Z"}
 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-08T06:17:49Z"}
+generated: {by: process:create-pmos, at: "2026-10-08T06:49:50Z"}
 status: stable
 ---
 

package/workspace/guide/today.md

@@ -16,7 +16,7 @@ Above the cards, Today shows the day in two columns.
 
 Press **Prepare my day** to start the day. It runs from the brief to the delivery of each agent job, and you do not press anything else until a draft is ready for you. The page [Guide: Today and the proactive engine](proactive-engine.md) describes each step.
 
-The bar at the top of the day is one line. It shows the greeting, the date and how many goals are unfinished. While **Prepare my day** runs, it also shows the four steps (Read, Sort, Agents work, You approve) as a small progress bar; press a step to see its detail. When nothing runs, it says when the day was last prepared. **Sources** and **Check now** are icon buttons in the bar.
+The bar at the top of the day is one line. It shows the greeting, the date and **Prepare my day** (**Prepare again** when the day is prepared). While **Prepare my day** runs, it also shows the four steps (Read, Sort, Agents work, You approve) as a small progress bar; press a step to see its detail. The **⋯** menu holds the rest: when the day was last prepared, how many agent jobs are in each state, the next daytime check, **Check now**, **Settings** (the sources) and, when Today shows one repository, **Show items with no repository**.
 
 If the morning-brief session stops before it submits a brief, the Read step says so and gives the reason. **Prepare my day** is then ready again, so press it to try once more. If the session says that its folder is not there, open the repository again from its current folder first.
 
@@ -32,27 +32,20 @@ An agent job can stop with its session still open, for example when the agent as
 
 Each job session is named "Job ·" and the first words of the job, so the session list stays short.
 
-The left column shows one section at a time. A row of tabs at the top chooses it: **Agenda**, **Goals**, **Jobs**, **Mentions** and **Result**. Agenda is the first one shown. The column remembers your last choice in this browser. When you select a job, a goal or a mention, the column goes to its tab. The Agenda tab holds the month. **Result** counts the jobs and lists each finished one with its draft summary or the reason it failed. The **Goals** tab holds your goals for today. The day is open when you go to Agenda, also before you press **Prepare my day**. The other things that wait for you, such as outcome checks, report drafts and sessions, are jobs too. Each one is a row of **Needs you** in the jobs. Press it to see its card, with its own buttons (for example **Draft now**), in the detail column. When the day is folded, they show as cards under it.
+The left column shows one section at a time. A row of tabs at the top chooses it: **Agenda**, **Goals**, **Jobs** and **Mentions**. Agenda is the first one shown. The column remembers your last choice in this browser. When you select a job, a goal or a mention, the column goes to its tab. The Agenda tab holds the day's meetings and, on a press, the month. A finished job shows its draft summary, or the reason it failed, inside the job. The **Goals** tab holds your goals, and each goal lists its jobs (see [Goals own jobs](#goals-own-jobs)). The day is open when you go to Agenda, also before you press **Prepare my day**. The other things that wait for you, such as outcome checks, report drafts and sessions, are jobs too. Each one is a row of **Needs you** in the jobs. Press it to see its card, with its own buttons (for example **Draft now**), in the detail column. When the day is folded, they show as cards under it.
 
 ### The Agenda month
 
-The menu calls this page **Agenda**. At the top of the left column is the month, with today marked. When a day shows no meetings yet, press **Prepare my day** (or **Prepare again**): the morning-brief session reads your calendar and fills the month. Each week starts with its number, for example W41.
+The menu calls this page **Agenda**. It opens on the meetings of the day, with the arrows to go to another day. The month is hidden. Press **Calendar** to show it across the full width, and **Hide calendar** to put it away. Picking a day closes the month and shows that day's meetings. The page does not remember the day you picked or whether the month was open. When a day shows no meetings yet, press **Prepare my day** (or **Prepare again**): the morning-brief session reads your calendar and fills the month. Each week starts with its number, for example W41.
 
-- Press a day to see its agenda under the month. Three tiles open the agenda: the time in meetings, the meeting that matters most, and your prep.
 - Press a week number to see the agenda of that week, day by day.
 - Press a meeting to see its memory in the right column. The month marks every day of the same meeting, so you see when it happens again.
 
 Meetings that repeat and have nothing for you fold into one line, for example "+4 repeating, nothing for you". Press it to see them.
 
-Each day of the month answers three questions:
+A day in the month holds three things: the day number, a tint that is darker when the day has more meetings, and a ★ when the day has a key meeting. A meeting matters when you present or decide, when people from outside the company or leadership join, or when 8 people or more join. Meeting titles, the prep badge and the notes count are in the day's agenda, not in the month.
 
-- **How full is the day?** The bar covers 09:00 to 18:00. Each block is a meeting. A dark block is an important meeting.
-- **What matters?** The ★ line names the one meeting of the day that matters. A meeting matters when you present or decide, when people from outside the company or leadership join, or when 8 people or more join. A meeting whose prep is at risk also shows.
-- **How ready are you?** The badge shows the prep steps done out of the steps needed, for example 1/3. It is red when the free time before the meeting is shorter than 30 minutes for each step left. A past day shows how many one-to-ones and important meetings have no notes.
-
-The switch above the month shows one answer at a time: **Overview** (all three), **Full** (the time in meetings), **Key** (the meeting that matters), **Prep** (how ready you are) or **Free** (the free blocks of 90 minutes or more).
-
-A meeting's detail shows one focus. Under the title is one line: the time, how many people join, and a star when the meeting is key. Under it are the goal of the meeting and, for a meeting with prep, one line of progress (the steps done, a bar, the free minutes before the meeting). Only the first open step is expanded, with what its source says, its link and, for a note step, a box for your note. The one primary button follows it: **I have read it**, **Mark done** or **Done**, then **Mark ready** when every step is done, then **Take notes** once the meeting has started. Press the arrow at the end of another step to open it. **More** holds the rare presses: **Mark ready** while steps are left, **Remind me**, **Skip prep**, the key mark and **Add as a goal for today**. **Details** holds the people, the kind of meeting and how often it met, the initiative, the goal it counts toward, During and After, the mail and the links.
+A meeting's detail shows one focus. Under the title is one line: the time, how many people join, and a star when the meeting is key. Under it are the goal of the meeting and, for a meeting with prep, one line of progress (the steps done, a bar, the free minutes before the meeting). Only the first open step is expanded, with what its source says, its link and, for a note step, a box for your note. The one primary button follows it: **I have read it**, **Mark done** or **Done**, then **Mark ready** when every step is done, then **Take notes** once the meeting has started. Press the arrow at the end of another step to open it. **More** holds the rare presses: **Mark ready** while steps are left, **Remind me**, **Skip prep**, the key mark and **Add as a goal for today**. **Details** holds the people, the kind of meeting and how often it met, the initiative, During and After, the mail and the links. When the meeting has a goal, the detail also shows what the goal is done when and the goal's jobs, with the buttons to add a job and to link one.
 
 A meeting's detail ends with **Meeting notes**. Press **Take notes** to start a note linked to the meeting, and to its initiative when the brief names one. PMOS starts to listen at once and keeps the note small at the bottom right. Press it to open the note as a pop-up. When the meeting has a note, the detail shows its summary and **Open notes**, which opens it in the pop-up, and the meeting's row shows **notes**. See [Notes](notes.md).
 
@@ -92,6 +85,22 @@ Each job has one of three kinds.
 
 A draft that waits for you shows its summary, its text and the link of the place it is for. **Approve** sends only that text, to that place. **Revise** takes a note of at most 500 characters and asks for a new draft. You can revise a job 3 times. A fourth revise is refused, so do the job yourself or drop it. A failed job shows its reason and **Retry**.
 
+### Goals own jobs
+
+A goal is something you want to finish. Add one in the **Goals** tab: type it and press Enter. **Add context** is optional and takes three fields: what is true when the goal is done (**done when**), what the goal serves (a key result or a health budget), and when it is due. A goal with no **done when** shows **Add done when**.
+
+Each goal lists its jobs. A job belongs to one goal at most, and a job can have no goal. A job comes from a step of the goal, from preparing, from a mention, or from you. Its detail names where it came from and has a **Goal** list: pick a goal to link the job, or **No goal** to unlink it. The **Goals** tab ends with **Jobs without a goal**, each with the same list. To add a job to a goal, type it in the goal and press **Add job**. A job you add this way is yours: you check it and remove it, and no agent works on it.
+
+The goal row shows how many jobs are done, for example "2 of 4 jobs done". That is information only. A goal is never closed for you. Press **Done** when the goal is finished, or **Drop** to give it up. **Add as a goal** in a meeting's **More** menu makes a goal from the meeting.
+
+### Who acts on a job
+
+Each job says who acts: **Waiting on you**, **Agent is working** or **Agent finished**. A filled square marks the agent and an open square marks you. Every button on a job has a small **YOU** or **AGENT** tag. A button with **AGENT** starts the agent in a session, for example **Have the agent draft it**, **Revise** and **Retry**. A button with **YOU** is a press that you do yourself, for example **Approve** and **Mark done**. When a job has a session, whoever acted last, **Open session** opens it. A finished job shows its result inside the job.
+
+### Mentions
+
+The **Mentions** tab lists what people asked of you. A mention from Slack, Confluence or Figma shows as a card in the layout of that service: a Slack message with the sender and the text; a Confluence comment with the page and, when the brief has one, the passage it is about; a Figma comment with the file it is on. The card shows only what the brief has. It never invents a reaction, a reply count or a picture. Press a mention to open its job. **Open in …** opens the conversation in the service. Nothing in PMOS posts to Slack, Confluence or Figma, resolves a comment or reacts. Mentions from other places show as a plain row.
+
 ### Jobs you do and meetings you prepare for
 
 A job that only you can do starts with a verb, such as **Reply**, **Review** or **Sign off**, and one sentence that says what to do. Under the sentence are who asked, why it is for today, and the steps. Check each step when you finish it. The first button opens the place where you do the job, for example **Reply in Slack**. **Have the agent draft it** gives the job to an agent. The draft then waits for your approval, as for any approve job.

package/workspace/lib/brief.js

@@ -173,10 +173,10 @@ function eventExtras(e, at, sources) {
 function itemExtras(x, at) {
   const f = {};
   const err = optLink(x.link, `${at}: link`) || optText(x.where, 120, `${at}: where`) || optText(x.who, 120, `${at}: who`) || optText(x.about, 480, `${at}: about`)
-    || optText(x.ask, 240, `${at}: ask`) || optText(x.how, 480, `${at}: how`);
+    || optText(x.ask, 240, `${at}: ask`) || optText(x.quote, 280, `${at}: quote`) || optText(x.how, 480, `${at}: how`);
   if (err) return { error: err };
   if (x.link) f.link = x.link;
-  for (const [k, n] of [['where', 120], ['who', 120], ['about', 480], ['ask', 240], ['how', 480]]) if (typeof x[k] === 'string' && x[k].trim()) f[k] = clip(x[k], n);
+  for (const [k, n] of [['where', 120], ['who', 120], ['about', 480], ['ask', 240], ['quote', 280], ['how', 480]]) if (typeof x[k] === 'string' && x[k].trim()) f[k] = clip(x[k], n);
   if (x.reply_needed !== undefined && x.reply_needed !== null) {
     if (typeof x.reply_needed !== 'boolean') return { error: `${at}: reply_needed must be true or false` };
     f.reply_needed = x.reply_needed;

package/workspace/lib/day-marks.js

@@ -19,18 +19,24 @@
  *            | { action: 'step', id, step, done }         step: the step's text, done: true | false
  *            | { action: 'note', id, text }               the PM's own note, written in the card (at most 1000
  *                                                               characters; empty clears it). It stays on this machine.
+ *            | { action: 'link', id, goal }               goal: the id of one of today's open goals, or null for "no goal".
+ *                                                               It overrides the goal the item or task came with (initiative
+ *                                                               today-goals-jobs, PRD L1). An item or a task, never a meeting.
  *            | { action: 'restore', id, mark }            mark: a `prev` an earlier edit returned, or null (Undo)
- *        known: Map of today's ids → 'item' | 'event'. An id not in it is refused.
+ *        known: Map of today's ids → 'item' | 'event' | 'task'. An id not in it is refused.
+ *        goals: Set of the ids of today's open goals, for `link`.
  *   effective(rec, now)                    → { id: mark } with a snooze or hold whose time has passed read as open
+ *   links(rec)                             → { id: goalId | '' } for the marks that link a job ('' is "no goal")
  *
  * A mark lasts for its day: brief item ids are per day (lib/brief.js), so a snooze or a hold ends at midnight.
  */
 
 const STATES = ['done', 'snoozed', 'waiting', 'dismissed'];
-const ACTIONS = ['done', 'reopen', 'snooze', 'hold', 'dismiss', 'step', 'note', 'restore'];
-const KINDS = ['item', 'event'];
+const ACTIONS = ['done', 'reopen', 'snooze', 'hold', 'dismiss', 'step', 'note', 'link', 'restore'];
+const KINDS = ['item', 'event', 'task'];
+const GOAL_ID_RE = /^g-[0-9a-f]{8}$/;
 const REASONS = { item: ['no-action', 'someone-else', 'done-elsewhere'], event: ['nothing', 'elsewhere'] };
-const ID_RE = /^[0-9a-f]{12}$/;
+const ID_RE = /^(t-)?[0-9a-f]{12}$/;
 const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
 const MAX_IDS = 400;
 const MAX_STEPS = 12;
@@ -57,7 +63,8 @@ function cleanMark(m, date) {
     out.until = iso(t);
   }
   if (state === 'waiting') { const on = clip(m.on, MAX_ON); if (!on) return null; out.on = on; }
-  if (state === 'dismissed') { if (!REASONS[m.kind].includes(m.why)) return null; out.why = m.why; }
+  if (state === 'dismissed') { if (!(REASONS[m.kind] || []).includes(m.why)) return null; out.why = m.why; }
+  if (m.kind !== 'event' && (m.goal === '' || GOAL_ID_RE.test(String(m.goal)))) out.goal = m.goal;
   const steps = Array.isArray(m.steps) ? [...new Set(m.steps.map((s) => clip(s, MAX_STEP)).filter(Boolean))].slice(0, MAX_STEPS) : [];
   if (steps.length) out.steps = steps;
   if (typeof m.note === 'string' && m.note.trim()) out.note = m.note.trim().slice(0, MAX_NOTE);
@@ -85,7 +92,7 @@ function laterToday(v, now, date) {
   return { at: t };
 }
 
-function edit(rec, op, { now = Date.now(), known } = {}) {
+function edit(rec, op, { now = Date.now(), known, goals } = {}) {
   if (!rec || !DATE_RE.test(String(rec.date)) || !rec.marks || typeof rec.marks !== 'object') return { ok: false, error: 'no marks record to edit' };
   if (!op || typeof op !== 'object' || !ACTIONS.includes(op.action)) return { ok: false, error: `action must be one of ${ACTIONS.join(', ')}` };
   const id = String(op.id || '');
@@ -93,6 +100,7 @@ function edit(rec, op, { now = Date.now(), known } = {}) {
   const kind = known && typeof known.get === 'function' ? known.get(id) : null;
   if (!KINDS.includes(kind)) return { ok: false, error: 'no item or meeting with that id in today\'s brief' };
   if (localDate(now) !== rec.date) return { ok: false, error: `the marks are for ${rec.date}, and today is ${localDate(now)}` };
+  if (kind === 'task' && !['link', 'restore'].includes(op.action)) return { ok: false, error: 'only a link is kept for a task' };
   const marks = { ...rec.marks };
   const prev = marks[id] ? JSON.parse(JSON.stringify(marks[id])) : null;
   const cur = prev ? { ...prev } : { kind, state: null, at: null };
@@ -110,7 +118,12 @@ function edit(rec, op, { now = Date.now(), known } = {}) {
     marks[id] = c;
     return { ok: true, rec: { date: rec.date, marks }, mark: c, prev };
   }
-  if (op.action === 'step') {
+  if (op.action === 'link') {
+    if (kind === 'event') return { ok: false, error: 'a meeting is not linked to a goal here: make the meeting a goal instead' };
+    const goal = op.goal === null || op.goal === undefined || op.goal === '' ? '' : String(op.goal);
+    if (goal && (!GOAL_ID_RE.test(goal) || !(goals && typeof goals.has === 'function' && goals.has(goal)))) return { ok: false, error: 'goal must be the id of an open goal of today, or null' };
+    cur.goal = goal;
+  } else if (op.action === 'step') {
     const step = clip(op.step, MAX_STEP);
     if (!step) return { ok: false, error: 'step must be the text of a step' };
     if (typeof op.done !== 'boolean') return { ok: false, error: 'done must be true or false' };
@@ -146,7 +159,7 @@ function edit(rec, op, { now = Date.now(), known } = {}) {
   }
   if (!marks[id] && Object.keys(marks).length >= MAX_IDS) return { ok: false, error: `at most ${MAX_IDS} marks a day` };
   const clean = cleanMark(cur, rec.date);
-  if (clean.state === null && !clean.steps && !clean.note) delete marks[id]; else marks[id] = clean;
+  if (clean.state === null && !clean.steps && !clean.note && clean.goal === undefined) delete marks[id]; else marks[id] = clean;
   return { ok: true, rec: { date: rec.date, marks }, mark: marks[id] || null, prev };
 }
 
@@ -160,4 +173,11 @@ function effective(rec, now = Date.now()) {
   return out;
 }
 
-module.exports = { STATES, ACTIONS, REASONS, MAX_ON, MAX_STEPS, MAX_NOTE, emptyMarks, readMarks, edit, effective };
+/** { id: goalId | '' } for the marks that link a job to a goal (or, with '', unlink it from the goal it came with). */
+function links(rec) {
+  const out = {};
+  for (const [id, m] of Object.entries((rec && rec.marks) || {})) if (m.goal !== undefined) out[id] = m.goal;
+  return out;
+}
+
+module.exports = { STATES, ACTIONS, REASONS, MAX_ON, MAX_STEPS, MAX_NOTE, emptyMarks, readMarks, edit, effective, links };

package/workspace/lib/goals.js

@@ -35,7 +35,14 @@ const crypto = require('crypto');
 const MAX_GOALS = 7;
 const MAX_TEXT = 140;
 const STATUSES = ['open', 'done', 'dropped'];
-const ACTIONS = ['add', 'done', 'drop', 'reopen', 'remove', 'tag'];
+const ACTIONS = ['add', 'done', 'drop', 'reopen', 'remove', 'tag', 'context', 'job-add', 'job-done', 'job-reopen', 'job-remove'];
+const MAX_JOBS = 12;           // jobs the PM types on one goal (initiative today-goals-jobs, PRD G3)
+const MAX_JOB = 140;
+const MAX_DONE_WHEN = 200;
+const MAX_ANCHOR = 80;
+const MAX_DUE = 40;
+const JOB_ID_RE = /^j-[0-9a-f]{8}$/;
+const EVENT_ID_RE = /^[0-9a-f]{12}$/;
 const REPO_RE = /^[A-Za-z0-9._-]{1,80}$/;
 const repoOrNull = (r) => (typeof r === 'string' && REPO_RE.test(r) ? r : null);
 const INI_RE = /^[a-z0-9][a-z0-9._-]*$/i;
@@ -47,6 +54,22 @@ const clip = (s, n) => String(s == null ? '' : s).replace(/\s+/g, ' ').trim().sl
 
 const emptyDay = (date) => ({ date, goals: [] });
 
+/** The jobs the PM typed on a goal, checked: { id, text, done, added_at }. */
+function cleanJobs(raw) {
+  if (!Array.isArray(raw)) return [];
+  return raw.filter((j) => j && typeof j === 'object' && JOB_ID_RE.test(j.id) && typeof j.text === 'string' && j.text.trim()).slice(0, MAX_JOBS)
+    .map((j) => ({ id: j.id, text: clip(j.text, MAX_JOB), done: j.done === true, added_at: typeof j.added_at === 'string' ? j.added_at : null }));
+}
+/** The optional context of a goal (PRD G1): what finished looks like, what it serves, when, and the meeting it came from. */
+function cleanContext(g) {
+  const out = {};
+  const dw = clip(g.done_when, MAX_DONE_WHEN); if (dw) out.done_when = dw;
+  const an = clip(g.anchor, MAX_ANCHOR); if (an) out.anchor = an;
+  const du = clip(g.due, MAX_DUE); if (du) out.due = du;
+  if (typeof g.event_id === 'string' && EVENT_ID_RE.test(g.event_id)) out.event_id = g.event_id;
+  return out;
+}
+
 /** A day record read from disk, checked. Anything that is not a day record for `date` reads as an empty day. */
 function readDay(raw, date) {
   if (!raw || typeof raw !== 'object' || raw.date !== date || !Array.isArray(raw.goals)) return emptyDay(date);
@@ -54,7 +77,7 @@ function readDay(raw, date) {
     && STATUSES.includes(g.status)).slice(0, MAX_GOALS).map((g) => ({
     id: g.id, text: clip(g.text, MAX_TEXT), initiative_id: typeof g.initiative_id === 'string' && INI_RE.test(g.initiative_id) ? g.initiative_id : null,
     status: g.status, added_at: typeof g.added_at === 'string' ? g.added_at : null, closed_at: typeof g.closed_at === 'string' ? g.closed_at : null,
-    repo: repoOrNull(g.repo),
+    repo: repoOrNull(g.repo), ...cleanContext(g), jobs: cleanJobs(g.jobs),
   }));
   return { date, goals };
 }
@@ -63,7 +86,7 @@ function readDay(raw, date) {
  *  dropped, not until midnight. `prev` is that day's record (readDay); a day with its own file never takes these. */
 function carryOver(prev, date) {
   if (!prev || !Array.isArray(prev.goals) || !prev.date || prev.date >= date) return emptyDay(date);
-  return { date, goals: prev.goals.filter((g) => g.status === 'open').slice(0, MAX_GOALS).map((g) => ({ ...g, closed_at: null })) };
+  return { date, goals: prev.goals.filter((g) => g.status === 'open').slice(0, MAX_GOALS).map((g) => ({ ...g, closed_at: null, jobs: cleanJobs(g.jobs).filter((j) => !j.done) })) };
 }
 
 /** One edit of the day's goals. A refused edit returns the reason and the caller writes nothing. */
@@ -79,10 +102,14 @@ function edit(day, op, { now = Date.now() } = {}) {
     const ini = op.initiative_id == null || op.initiative_id === '' ? null : op.initiative_id;
     if (ini !== null && (typeof ini !== 'string' || !INI_RE.test(ini))) return { ok: false, error: 'initiative_id is not an initiative id' };
     if (op.repo != null && op.repo !== '' && !repoOrNull(op.repo)) return { ok: false, error: 'repo is not a workspace id' };
+    for (const [k, n] of [['done_when', MAX_DONE_WHEN], ['anchor', MAX_ANCHOR], ['due', MAX_DUE]]) {
+      if (op[k] != null && (typeof op[k] !== 'string' || op[k].trim().length > n)) return { ok: false, error: `${k} is text of at most ${n} characters` };
+    }
+    if (op.event_id != null && op.event_id !== '' && !EVENT_ID_RE.test(String(op.event_id))) return { ok: false, error: 'event_id is not a meeting id' };
     const text = clip(op.text, MAX_TEXT);
     if (goals.some((g) => g.text.toLowerCase() === text.toLowerCase())) return { ok: false, error: 'that goal is already on the list' };
     const id = 'g-' + crypto.createHash('sha1').update(`${day.date}|${text}|${at}|${goals.length}`).digest('hex').slice(0, 8);
-    goals.push({ id, text, initiative_id: ini, status: 'open', added_at: at, closed_at: null, repo: repoOrNull(op.repo) });
+    goals.push({ id, text, initiative_id: ini, status: 'open', added_at: at, closed_at: null, repo: repoOrNull(op.repo), ...cleanContext(op), jobs: [] });
     return { ok: true, day: { date: day.date, goals }, goal: goals[goals.length - 1] };
   }
   const i = goals.findIndex((g) => g.id === op.id);
@@ -94,6 +121,34 @@ function edit(day, op, { now = Date.now() } = {}) {
     g.repo = repoOrNull(op.repo);
     return { ok: true, day: { date: day.date, goals }, goal: g };
   }
+  if (op.action === 'context') {
+    for (const [k, n] of [['done_when', MAX_DONE_WHEN], ['anchor', MAX_ANCHOR], ['due', MAX_DUE]]) {
+      if (op[k] === undefined) continue;
+      if (typeof op[k] !== 'string' || op[k].trim().length > n) return { ok: false, error: `${k} is text of at most ${n} characters` };
+      const v = clip(op[k], n); if (v) g[k] = v; else delete g[k];
+    }
+    return { ok: true, day: { date: day.date, goals }, goal: g };
+  }
+  if (op.action.startsWith('job-')) {
+    g.jobs = cleanJobs(g.jobs);
+    if (op.action === 'job-add') {
+      if (typeof op.text !== 'string' || !op.text.trim()) return { ok: false, error: 'a job needs text' };
+      if (op.text.trim().length > MAX_JOB) return { ok: false, error: `a job is at most ${MAX_JOB} characters` };
+      if (g.jobs.length >= MAX_JOBS) return { ok: false, error: `a goal has at most ${MAX_JOBS} jobs you typed` };
+      const text = clip(op.text, MAX_JOB);
+      if (g.jobs.some((j) => j.text.toLowerCase() === text.toLowerCase())) return { ok: false, error: 'that job is already on this goal' };
+      const id = 'j-' + crypto.createHash('sha1').update(`${g.id}|${text}|${at}|${g.jobs.length}`).digest('hex').slice(0, 8);
+      g.jobs.push({ id, text, done: false, added_at: at });
+      return { ok: true, day: { date: day.date, goals }, goal: g, job: g.jobs[g.jobs.length - 1] };
+    }
+    const j = g.jobs.find((x) => x.id === op.job);
+    if (!j) return { ok: false, error: 'no job with that id on this goal' };
+    if (op.action === 'job-remove') { g.jobs = g.jobs.filter((x) => x !== j); return { ok: true, day: { date: day.date, goals }, goal: g, job: j }; }
+    const want = op.action === 'job-done';
+    if (j.done === want) return { ok: false, error: `that job is already ${want ? 'done' : 'open'}` };
+    j.done = want;
+    return { ok: true, day: { date: day.date, goals }, goal: g, job: j };
+  }
   const to = { done: 'done', drop: 'dropped', reopen: 'open' }[op.action];
   if (g.status === to) return { ok: false, error: `that goal is already ${to}` };
   g.status = to; g.closed_at = to === 'open' ? null : at;
@@ -127,6 +182,9 @@ function freeTime(events, at, endOfDay = END_OF_DAY) {
   return { free_minutes: Math.max(0, Math.round((end - now - busy) / 60000)), until: endOfDay, next: upcoming ? { start: upcoming.start, title: upcoming.title } : null };
 }
 
+/** The goal id an item is under: the PM's link mark when there is one ('' is "no goal"), else the item's own. */
+const goalOf = (x, links) => (links && Object.prototype.hasOwnProperty.call(links, x.id) ? links[x.id] || null : x.goal || null);
+
 const stepOrder = (a, b) => (a.owner === b.owner ? 0 : a.owner === 'pm' ? -1 : 1) || (b.confidence - a.confidence) || a.title.localeCompare(b.title);
 
 // The context a job carries (G18) rides on its step unchanged, so Today and the CLI show what the brief said.
@@ -153,7 +211,7 @@ function cardStep(c) {
  *   now      ms; the clock the server passes
  * A brief for another day is not joined: it is named as out of date, and only the Today cards plan the goals.
  */
-function planDay({ day, brief = null, cards = [], now = Date.now(), endOfDay = END_OF_DAY } = {}) {
+function planDay({ day, brief = null, cards = [], now = Date.now(), endOfDay = END_OF_DAY, links = {} } = {}) {
   const date = day && day.date;
   const fresh = !!brief && brief.date === date;
   const items = fresh ? [...(brief.priorities || []), ...(brief.worth_asking || [])] : [];
@@ -168,8 +226,8 @@ function planDay({ day, brief = null, cards = [], now = Date.now(), endOfDay = E
   // G9: a step goes only under an OPEN goal. A done or dropped goal draws no steps, so an item that names one is
   // placed as if it named no goal (by initiative, else "also" or "worth asking"); it is never lost under a closed goal.
   for (const x of items) {
-    const g = (x.goal && openById.get(x.goal)) || byIni(x.initiative_id);
-    if (g) g.steps.push(itemStep(x)); else unplaced.items.push(x);
+    const g = (goalOf(x, links) && openById.get(goalOf(x, links))) || byIni(x.initiative_id);
+    if (g) g.steps.push(itemStep({ ...x, goal: goalOf(x, links) })); else unplaced.items.push(x);
   }
   for (const c of cards || []) {
     const g = byIni(c.initiative_id);
@@ -217,14 +275,14 @@ const placeNameKeys = (n) => { const t = String(n || '').trim().toLowerCase().re
 
 /** { itemId: repo } for today's brief items: the repository of the open goal an item is under, else of the initiative
  *  it names (`iniRepos`: { initiativeId: repo }, only the ids one repository holds), else of its place. */
-function itemRepos({ day, brief, placeRepos = {}, iniRepos = {} } = {}) {
+function itemRepos({ day, brief, placeRepos = {}, iniRepos = {}, links = {} } = {}) {
   const out = {};
   if (!brief || !day || brief.date !== day.date) return out;
   const open = (day.goals || []).filter((g) => g.status === 'open');
   const byId = new Map(open.map((g) => [g.id, g]));
   const byIni = (ini) => (ini ? open.find((g) => g.initiative_id === ini) || null : null);
   for (const x of [...(brief.priorities || []), ...(brief.worth_asking || [])]) {
-    const g = (x.goal && byId.get(x.goal)) || byIni(x.initiative_id);
+    const g = (goalOf(x, links) && byId.get(goalOf(x, links))) || byIni(x.initiative_id);
     let r = g ? repoOrNull(g.repo) || (g.initiative_id ? repoOrNull(iniRepos[g.initiative_id]) : null) : null;
     if (!r && x.initiative_id) r = repoOrNull(iniRepos[x.initiative_id]);
     if (!r && x.where) {
@@ -243,4 +301,4 @@ function goalRepos({ day, iniRepos = {} } = {}) {
   return out;
 }
 
-module.exports = { MAX_GOALS, MAX_TEXT, STATUSES, ACTIONS, GOAL_ID_RE, START_OF_DAY, END_OF_DAY, emptyDay, readDay, carryOver, edit, freeTime, planDay, itemRepos, goalRepos };
+module.exports = { MAX_GOALS, MAX_TEXT, MAX_JOBS, MAX_JOB, MAX_DONE_WHEN, MAX_ANCHOR, MAX_DUE, STATUSES, ACTIONS, GOAL_ID_RE, START_OF_DAY, END_OF_DAY, emptyDay, readDay, carryOver, edit, freeTime, planDay, itemRepos, goalRepos };

package/workspace/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "pmos-workspace",
-  "version": "0.116.0",
+  "version": "0.117.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "pmos-workspace",
-      "version": "0.116.0",
+      "version": "0.117.0",
       "license": "MIT",
       "dependencies": {
         "@xterm/addon-fit": "^0.11.0",

package/workspace/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmos-workspace",
-  "version": "0.116.0",
+  "version": "0.117.0",
   "private": true,
   "description": "PMOS Terminal Workspace — local companion hosting real PTYs beside the library and gates (D62)",
   "license": "MIT",

package/workspace/public/pm/components.css

@@ -3499,6 +3499,7 @@
 .td-day__ts[data-step-state="done"] .td-day__seg { background: currentColor; }
 .td-day__ts[data-step-state="now"] .td-day__seg { background: var(--foreground); animation: td-day-pulse 1.2s infinite; }
 @media (prefers-reduced-motion: reduce) { .td-day__ts[data-step-state="now"] .td-day__seg { animation: none; } }
+.td-day__spacer { flex: 1 1 0; align-self: stretch; min-width: 0; }
 .td-day__status { flex: 1 1 0; min-width: 80px; text-align: right; font-size: 12px; color: var(--muted-foreground); white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
 .td-day__check { display: inline-flex; align-items: center; gap: 6px; font-size: 12px; color: var(--muted-foreground); }
 .td-day__run { margin: 0; font-size: 12px; line-height: 16px; color: var(--foreground); }
@@ -3549,6 +3550,19 @@
 .td-day__group { display: grid; gap: 2px; }
 .td-day__newdot { display: inline-block; flex: none; width: 7px; height: 7px; border-radius: 50%; background: var(--warning); }
 .td-day__chip { min-width: 84px; padding: 3px 8px; font: 500 11px/1.2 var(--mono); text-align: center; background: var(--muted); color: var(--foreground); }
+/* a mention drawn as a card of its source (initiative today-goals-jobs, PRD M1): layout only, no brand colour */
+.td-day__mc { display: grid; gap: 4px; min-width: 0; text-align: left; font-weight: 400; }
+.td-day__mc > span { display: block; min-width: 0; }
+.td-day__mc-head { display: inline-flex; align-items: center; gap: 6px; font: 11px var(--mono); letter-spacing: 0.04em; color: var(--muted-foreground); }
+.td-day__mc-main { display: flex; align-items: flex-start; gap: 8px; }
+.td-day__av { display: grid; place-items: center; flex: none; width: 32px; height: 32px; background: var(--muted); color: var(--foreground); font: 600 12px var(--mono); }
+.td-day__mc-col { display: grid; gap: 2px; min-width: 0; }
+.td-day__mc-name { font-size: 14px; line-height: 20px; font-weight: 600; color: var(--foreground); }
+.td-day__mc-time { margin-left: 6px; font: 12px var(--mono); color: var(--muted-foreground); }
+.td-day__mc-text { font-size: 14px; line-height: 20px; color: var(--foreground); overflow-wrap: anywhere; }
+.td-day__mc-quote { padding: 2px 8px; border-left: 3px solid var(--border); font-size: 12px; line-height: 16px; color: var(--muted-foreground); overflow-wrap: anywhere; }
+.td-day__mc-frame { display: grid; place-items: center; flex: none; width: 64px; height: 44px; border: 1px solid var(--border); background: var(--muted); color: var(--foreground); }
+.td-day__mcbox { padding: 8px; border: 1px solid var(--border); }
 
 /* the detail */
 .td-day__dhead { display: grid; gap: 4px; }
@@ -3659,33 +3673,32 @@
 /* the Agenda month (today-agenda.js, G25 to G27): weeks of 8 columns, the week number and seven day cells */
 .td-ag__mhead { display: flex; align-items: center; gap: 6px; }
 .td-ag__mlabel { min-width: 120px; font-size: 14px; text-align: center; color: var(--foreground); }
-.td-ag__lens { flex-wrap: wrap; max-width: 100%; }
+.td-ag__bar { display: flex; align-items: center; gap: 8px; }
+.td-ag__month { display: grid; gap: 6px; width: 100%; min-width: 0; }
 .td-ag__grid { display: grid; gap: 2px; }
 .td-ag__wk { display: grid; grid-template-columns: 36px repeat(7, minmax(0, 1fr)); gap: 2px; }
 .td-ag__wk--head { font: 11px var(--mono); color: var(--muted-foreground); text-transform: uppercase; }
 .td-ag__wd { padding: 0 4px; }
-.td-day .td-ag__wno { height: auto; min-height: 64px; padding: 0; font: 11px var(--mono); letter-spacing: 0; color: var(--muted-foreground); }
+.td-day .td-ag__wno { height: auto; min-height: 44px; padding: 0; font: 11px var(--mono); letter-spacing: 0; color: var(--muted-foreground); }
 .td-day .td-ag__wno[aria-pressed="true"] { background: var(--accent); color: var(--foreground); border-color: var(--ring); }
 .td-day .td-ag__cell {
-  display: grid; align-items: start; justify-content: stretch; height: auto; min-height: 64px; padding: 4px;
+  display: grid; align-items: start; justify-content: stretch; height: auto; min-height: 44px; padding: 4px;
   border: 1px solid var(--border); background: var(--background); text-align: left; text-transform: none; letter-spacing: 0;
   font-weight: 400; white-space: normal;
 }
+.td-day .td-ag__cell[data-load="1"] { background: color-mix(in oklab, var(--background) 85%, var(--ring)); }
+.td-day .td-ag__cell[data-load="2"] { background: color-mix(in oklab, var(--background) 65%, var(--ring)); }
+.td-day .td-ag__cell[data-load="3"] { background: color-mix(in oklab, var(--background) 40%, var(--ring)); }
 .td-day .td-ag__cell[data-out="true"] { opacity: 0.45; }
 .td-day .td-ag__cell[data-weekend="true"] { background: var(--muted); }
 .td-day .td-ag__cell[data-today="true"] { border: 2px solid var(--foreground); }
 .td-day .td-ag__cell[aria-pressed="true"] { background: var(--accent); border-color: var(--ring); }
 .td-day .td-ag__cell[data-lit="true"] { box-shadow: inset 0 0 0 2px var(--warning); }
-.td-ag__in { display: grid; gap: 3px; min-width: 0; }
+.td-ag__in { display: flex; align-items: center; justify-content: space-between; gap: 3px; min-width: 0; width: 100%; }
+.td-ag__star { font-size: 12px; line-height: 16px; color: var(--foreground); }
 .td-ag__num { font: 12px var(--mono); color: var(--foreground); font-variant-numeric: tabular-nums; }
 .td-ag__cell[data-past="true"] .td-ag__num { color: var(--muted-foreground); }
-.td-ag__strip { position: relative; height: 6px; background: var(--muted); }
-.td-ag__blk { position: absolute; top: 0; bottom: 0; left: var(--td-ag-l, 0); width: var(--td-ag-w, 0); background: var(--muted-foreground); }
-.td-ag__blk--imp { background: var(--foreground); }
-.td-ag__blk--free { background: var(--ring); }
-.td-ag__key, .td-ag__meta, .td-ag__nonotes { min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; font-size: 11px; line-height: 14px; }
-.td-ag__key { font-weight: 600; color: var(--foreground); }
-.td-ag__meta { color: var(--muted-foreground); }
+.td-ag__nonotes { min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; font-size: 11px; line-height: 14px; }
 .td-ag__nonotes { color: var(--warning); }
 .td-ag__ready { justify-self: start; padding: 0 4px; font: 11px/16px var(--mono); border: 1px solid var(--border); color: var(--foreground); }
 .td-ag__ready[data-ag-ready="warn"] { border-color: var(--warning); color: var(--warning); }
@@ -3714,6 +3727,21 @@
   margin: 0;
 }
 .td-goal__prep { display: inline-flex; align-items: center; gap: 8px; }
+/* goals own jobs (initiative today-goals-jobs): the square for who acts, the YOU and AGENT tags, a goal's context and jobs */
+.td-day__sq { display: inline-block; flex: none; width: 10px; height: 10px; border: 1.5px solid var(--foreground); }
+.td-day__sq[data-who="agent"] { background: var(--foreground); }
+.td-day__marks2 { display: inline-flex; align-items: center; gap: 6px; }
+.td-day__tag { display: inline-block; margin-left: 4px; padding: 0 4px; border: 1px solid currentColor; font: 600 10px/1.4 var(--mono); letter-spacing: 0.04em; vertical-align: middle; }
+.td-day__tag[data-who="agent"] { background: color-mix(in oklab, currentColor 18%, transparent); }
+.td-day__who2 { display: flex; align-items: center; gap: 8px; margin: 0; font-size: 14px; color: var(--foreground); }
+.td-day__jobmeta { display: grid; gap: 8px; padding: 10px 12px; border: 1px solid var(--border); background: var(--background); }
+.td-day__goaladd { display: grid; gap: 6px; }
+.td-goal__jobs { gap: 6px; }
+.td-goal__donewhen { margin: 0; font-size: 14px; color: var(--foreground); }
+.td-goal__ctxfields { display: grid; gap: 6px; }
+.td-goal__ctxfold { margin-top: 6px; }
+.td-goal__nogoal { margin-top: 12px; padding-top: 8px; border-top: 1px solid var(--border); }
+.td-goal__pick { display: block; min-width: 140px; max-width: 220px; }
 .td-card {
   display: flex;
   flex-direction: column;