create-pmos 0.61.0 → 0.62.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pmos",
-  "version": "0.61.0",
+  "version": "0.62.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@33595f8
+kernel-source: pmos@ff2e983
 assembled: 2026-10-06
 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-06T16:25:40Z"}
+generated: {by: process:create-pmos, at: "2026-10-06T17:04:03Z"}
 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-06T16:25:40Z"}
+generated: {by: process:create-pmos, at: "2026-10-06T17:04:03Z"}
 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-06T16:25:40Z"}
+generated: {by: process:create-pmos, at: "2026-10-06T17:04:03Z"}
 status: stable
 ---
 

package/workspace/first-paint-audit.js

@@ -20,10 +20,15 @@
 // The budgets start at specimen A's counts. reports: 14 → 15 in Run 6 for Present, the one control the PM asked to keep
 // with the slides (2026-10-06). Every place +1 for Docs in the top bar (the PM, 2026-10-06, docs-three-way-sync): the
 // budget is for the whole screen and the bar is on every screen. The calibration stays specimen A's own count: the
-// specimen did not change.
+// specimen did not change. Every place +1 again for People in the top bar (the PM, 2026-10-06, people-directory).
 const SPECIMEN_A = Object.freeze({ today: 17, initiatives: 24, board: 33, reports: 14 });
 const BAR_DOCS = 1;
-const EXPECT = Object.freeze({ today: 17 + BAR_DOCS, initiatives: 24 + BAR_DOCS, board: 33 + BAR_DOCS, reports: 15 + BAR_DOCS });
+const BAR_PEOPLE = 1;
+const BAR = BAR_DOCS + BAR_PEOPLE;
+// Agenda opens on the month (the PM's Agenda mockup v5, 2026-10-06): the month adds its own controls to Today's budget,
+// at most six week rows of a week button and seven days, the two month arrows and the five lenses.
+const AGENDA_MONTH = 6 * 8 + 2 + 5;
+const EXPECT = Object.freeze({ today: 17 + BAR + AGENDA_MONTH, initiatives: 24 + BAR, board: 33 + BAR, reports: 15 + BAR });
 
 /* ── shoot.js audit(), copied verbatim (scratchpad/specimens2/shoot.js, 2026-10-05) ─────────────────────────────── */
 // runs in the page
@@ -149,4 +154,4 @@ function installCounter(page) {
   return page.addInitScript({ content: 'window.__countIn = ' + countIn.toString() + ';' });
 }
 
-module.exports = { EXPECT, SPECIMEN_A, audit, countIn, stableCount, installCounter };
+module.exports = { AGENDA_MONTH, EXPECT, SPECIMEN_A, audit, countIn, stableCount, installCounter };

package/workspace/guide/index.md

@@ -12,8 +12,8 @@ This guide describes the PMOS workspace as it works today. It ships with the app
 
 On a desktop the workspace is one frame. [Layout](layout.md) explains each part.
 
-1. **The top bar.** Repository ▾, the five places (Docs included), search (⌘K), Sync when the repository is not in sync, and Settings.
-2. **The place.** One of Agenda, Initiatives, Board or Reports, or Docs (⌘K or `g d`). It fills the screen under the bar.
+1. **The top bar.** Repository ▾, the six places (Docs and People included), search (⌘K), Sync when the repository is not in sync, and Settings.
+2. **The place.** One of Agenda, Initiatives, Board or Reports, or Docs (⌘K or `g d`), or People (⌘K or `g p`). It fills the screen under the bar.
 3. **The detail.** The item you opened: an initiative with its status, next steps and artifacts, or the profiles. It opens beside the place and closes with ×.
 4. **The agent dock.** Terminals, documents, conversations and web pages. It is open on Agenda and a thin rail elsewhere.
 
@@ -27,7 +27,8 @@ On a desktop the workspace is one frame. [Layout](layout.md) explains each part.
 | The items of an initiative | Board, or Breakdown in the initiative detail |
 | Run reports | Reports |
 | Whether a document is the same as its Google Docs or Confluence copy | Docs: ⌘K → **Docs**, or press `g d` |
-| Repositories, Profiles, New sessions (the default CLI and model), Validate consent, Theme | Settings |
+| The people you work with: who they are, your interactions, their tone, your notes and shared work | People: ⌘K → **People**, or press `g p` |
+| Repositories, Profiles, New sessions (the default CLI and model), Validate consent, People (calendar names), Theme | Settings |
 | Validate | Settings, under Validate consent: **Open Validate** |
 | A document, a decision record, a memory entry, a page of this guide | ⌘K, with its scope: Knowledge, Memory or Guide |
 | A report across every repository | ⌘K: Portfolio report |
@@ -37,6 +38,7 @@ On a desktop the workspace is one frame. [Layout](layout.md) explains each part.
 
 - [Start the workspace without a terminal](launcher.md): the PMOS app, the login item and `pmos launcher`.
 - [Jira tickets](jira.md): Jira tickets drafted from the PRD, pushed when you select them, and their status.
+- [People](people.md): the people you work with in a repository, how they get there, and `pmos people`.
 - [Docs](docs.md): whether each linked document is the same as, ahead of or behind its Google Docs and Confluence copy.
 - [Layout](layout.md): the frame, the keys and the rule for where a list or a detail opens.
 - [Statuses](statuses.md): what each status means, where it comes from, and what you can change.

package/workspace/guide/layout.md

@@ -15,7 +15,7 @@ The top bar has these parts, from left to right:
 
 - **Repository ▾** names the current repository. Press it to choose another repository, or **All repositories** to see the work of every repository at once. All repositories replaces the old Portfolio mode.
 - **Branches and sessions** is in ⌘K. It opens a sheet with every branch of the repository (main first) and how many sessions run in each. Press a branch to see its sessions, open one, end one, or start a session there. **＋ branch** makes a branch, and **＋ session** starts one with a branch, an agent and a profile. With All repositories, the sheet lists every repository.
-- **Agenda, Initiatives, Board, Reports and Docs** are the five places. Press one to show it. The Agenda count shows how many items need you. Docs shows whether each document is the same as its Google Docs and Confluence copy.
+- **Agenda, Initiatives, Board, Reports, Docs and People** are the six places. Press one to show it. The Agenda count shows how many items need you. Docs shows whether each document is the same as its Google Docs and Confluence copy. People shows the people you work with in the repository ([People](people.md)).
 - **Search or capture ⌘K** opens the command palette. Type to find an initiative, a repository, an open tab or a command.
 - **Sync** shows only when the current repository is not in sync with its remote. Press it to fetch, bring in the work of the other machine, record your changes and push. If the repository has not fetched in the last 10 minutes, Sync also shows, because a push from another machine is not visible until a fetch. When the repository fetched recently and is in sync, Sync is not shown. If Sync stops, the message names the step that stopped.
 - **Sync on its own.** If you forget to press Sync, the workspace syncs for you. It syncs each repository once when the workspace starts. It also syncs a repository that has records not yet pushed when no record changed for 5 minutes. In a document repository it syncs every changed file on any branch. In a code repository it syncs only on the default branch (for example `main`), and only when every commit not yet pushed changes records and no code. If you close the tab while records are not yet pushed, the browser asks you first. To turn automatic sync off, start the workspace with `PMOS_AUTO_SYNC=0`.
@@ -25,12 +25,13 @@ Each place is drawn when its run is built. Until then the place says which run b
 
 ## Settings
 
-Settings holds settings only, in seven sections:
+Settings holds settings only, in eight sections:
 
 - **Repositories**: every registered repository. Press a repository to make it the current one. Press its ⋯ for **Rename** or **Remove from PMOS**. Each asks in a sheet, and a remove asks you to confirm. **Add repository** shows the scan of a folder before you add it.
 - **Profiles**: the Claude profiles a session can start with. They open in the detail.
 - **New sessions**: the default CLI and the default model for a new session in the dock.
 - **Validate consent**: the consent of the current repository. Turn it on or off here. **Open Validate** opens the Validate page as a tab.
+- **People**: whether the morning brief keeps attendee names from the calendar for the current repository. It is off until you turn it on. Turning it off also hides the names recorded before.
 - **Online**: puts this workspace at your own address, such as `pmos.pm-os.app`, through a Cloudflare tunnel. Enter the public address, the tunnel name, your Cloudflare team domain, the Access audience (AUD) tag and your email, then press **Turn on**. The workspace runs the tunnel and remembers the switch when it restarts. On your phone, open the address and sign in with Cloudflare Access (Google or an email code). The workspace does not ask for its token there. Only the computer that runs the workspace can change this section. A phone sees whether it is on. When a sign-in at the address is refused, this section names the check that failed, such as the email or the AUD tag. [REMOTE.md](../REMOTE.md) has the one-time Cloudflare steps.
 - **Theme**: Dark or Light.
 - **Updates**: the version of the workspace app and the version of the kit in the current repository. Press **Check for updates** to compare them with the latest published version of PMOS. This is the only time the workspace asks the internet for a version, and it asks only when you press. When a newer version is available, one button shows: **Update to** and the version. It updates every part that is older, in this order:
@@ -75,7 +76,7 @@ The workspace is neutral. A primary button is the text colour on the page colour
 
 | Key | What it does |
 |---|---|
-| g t, g i, g b, g r, g d | Show Agenda, Initiatives, Board, Reports or Docs. |
+| g t, g i, g b, g r, g d, g p | Show Agenda, Initiatives, Board, Reports, Docs or People. |
 | ⌘K (Ctrl-K) | Open or close the command palette. |
 | ⌘J (Ctrl-J) | Open or fold the dock. |
 | ⌘⇧J (Ctrl-Shift-J) | Focus: give the dock the whole window, or show the place again. |

package/workspace/guide/people.md

@@ -0,0 +1,70 @@
+---
+type: Guide
+title: "People: the people you work with in a repository, their interactions, tone, notes and shared work"
+timestamp: 2026-10-06
+---
+
+# People
+
+Open People from the top bar, from ⌘K (**People**), or press `g p`.
+
+People lists the people you work with in the current repository. For each person it shows who they are, your interactions with them and where each one came from, the tone of those interactions, your own notes, and the work you share.
+
+## How people get into People
+
+The workspace does not read your mail, chat, calendar or Jira. Agent sessions that already read them with your own connectors record the people they see:
+
+- **Gather requirements** records the author of each item it gathers.
+- **Live notes** records each named speaker.
+- **Jira sync** records assignees and reporters by their Jira name.
+- **Morning brief** records meeting attendees, but only when **Keep attendee names from the calendar** is on (see Settings below).
+
+Each record is a sighting: a name, a handle (a mail address, a chat or Jira name, a transcript speaker, or only a name), and at most one interaction line in the agent's words with a pointer to where it came from. No message body is kept. Private, personal, confidential and HR material is skipped.
+
+A sighting does not make a person. New people wait for you in **Waiting for you** at the top of People.
+
+## Waiting for you
+
+- **A new person.** Press **Add to People** to add them, or **Ignore** to hide them. Later sightings of an ignored handle stay hidden.
+- **A possible duplicate.** When a session thinks two handles are one person, it says why. Press **Merge** to join the handle to that person, or **Keep separate** to close the question.
+- **Tones to confirm.** The count of people whose tone you have not confirmed. Open the person to confirm it.
+
+## The list
+
+Type in **Find a person** to search names, handles and initiatives. **All**, **Team** and **External** filter the list. **Latest**, **Most** and **Name** sort it by the last interaction, the number of interactions or the name. Press a person to open their page beside the list.
+
+## A person's page
+
+- **Interactions.** Newest first. Each line shows the date, the kind (Mail, Chat, Meeting, 1:1, Jira, Doc, Call or Mention), the line, and where it came from with its pointer and tone.
+- **Tone.** The mix of tones (warm, neutral, cautious, tense) and a proposed overall tone: the most frequent tone of the latest 10 interactions. When two tones are tied, the latest one wins. Press **Confirm** to keep the proposal, **Set another** to choose a different tone, or **Change** to clear your choice. Tone describes the exchanges, not the person.
+- **Shared work.** The initiatives your interactions name, the plan items the person owns (with **Blocked** when the item is blocked), and the coming meetings that name them when calendar names are on. Nothing here is typed by hand.
+- **Notes.** Type a note and press **Add note**. Press **Remove** to remove one. Only you can add or remove a note. No command writes one.
+- **Identity and sources.** The person's handles, how many interactions each source gave, and the file the person lives in.
+
+## Ways in from other places
+
+- **Agenda.** A meeting's detail shows a link for each person its attendee line names.
+- **Initiative sheet.** The **People** tab lists the people whose interactions name the initiative or who own one of its items.
+- **Item sheet.** When an item's owner is a person in People, the owner is a link to their page.
+
+A link matches a full name, a first name of three letters or more, or a handle, as a whole word. Two people with the same first name both match.
+
+## Settings
+
+Settings has a **People** section for the current repository. **Keep attendee names from the calendar** is off until you turn it on. While it is off, the morning brief records nobody from the calendar, `pmos people record` refuses calendar sightings, and names recorded before stay hidden.
+
+## Where People keeps its records
+
+People keeps one append-only file, `people.jsonl`, in the repository's state directory (`pmos/state/` in a product repository). Sync sends it with your other records, so People is the same on every machine that syncs the repository. Every clone of the repository can read your tone choices and notes. Keep them to work context.
+
+## Commands
+
+- `pmos people list` lists each person with their role, interactions and tone, and the new people waiting for you. Add `--json` for the whole view.
+- `pmos people show <person>` shows one person's page: interactions, tone, shared work, notes and handles. `<person>` is the id from the list or the full name.
+- `pmos people record --file <sightings.json>` records the people a session saw. Agent sessions run it. It must name who recorded it: in a workspace session the session token does this; outside the workspace, add `--by <profile>`. A sighting already recorded is skipped and counted.
+- `pmos people settings` prints `calendar names: on` or `calendar names: off`. The morning brief reads it before it records attendees.
+- `pmos people help` prints the commands.
+
+The sightings file holds `{ "sightings": [...], "merges": [...] }`. A sighting is `{ "source": "gather" | "calendar" | "live" | "jira", "handle": { "kind": "mail" | "slack" | "jira" | "confluence" | "speaker" | "name", "value": "…" }, "name": "…", "role"?, "org"?, "external"?: true, "interaction"?: { "date": "YYYY-MM-DD", "kind": "Mail", "text": "one line, at most 200 characters", "pointer": "where it came from, at most 200 characters", "tone"?: "warm", "initiative"?: "<id>" } }`. A merge is `{ "a": <handle>, "b": <handle>, "why": "one line" }`.
+
+No command adds a person, ignores or merges a handle, sets a tone or writes a note. Do those in People.

package/workspace/guide/today.md

@@ -30,11 +30,11 @@ 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.
 
-**Agent results**, at the top of the left column, counts the jobs and lists each finished one with its draft summary or the reason it failed. Your goals for today come under it, above the calendar. The other things that wait for you, such as outcome checks, report drafts and sessions, are in **Also waiting for you** at the end of the left column. When the day is folded, they show under it.
+The Agenda month is at the top of the left column. **Agent results** comes under it, counts the jobs and lists each finished one with its draft summary or the reason it failed. Your goals for today come under Agent results. 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 in **Also waiting for you** at the end of the left column. When the day is folded, they show under it.
 
 ### The Agenda month
 
-The menu calls this page **Agenda**. At the top of the left column is the month, with today marked. Each week starts with its number, for example W41.
+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.
 
 - 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.

package/workspace/lib/calendar-memory.js

@@ -90,6 +90,7 @@ function validateMemory(raw, { now = Date.now() } = {}) {
     if (e.series !== undefined && !str(e.series, 200)) return { ok: false, error: `${at}: series is a text of at most 200 characters` };
     if (e.attendees !== undefined && !(Number.isInteger(e.attendees) && e.attendees >= 0 && e.attendees <= 1000)) return { ok: false, error: `${at}: attendees is a whole number from 0 to 1000` };
     for (const b of ['external', 'exec']) if (e[b] !== undefined && typeof e[b] !== 'boolean') return { ok: false, error: `${at}: ${b} is true or false` };
+    if (e.with !== undefined && !str(e.with, 120)) return { ok: false, error: `${at}: with is one line of at most 120 characters` };
     if (e.role !== undefined && !ROLES.includes(e.role)) return { ok: false, error: `${at}: role is one of ${ROLES.join(', ')}` };
     const past = f <= now;
     if (e.notes !== undefined) {
@@ -107,7 +108,7 @@ function validateMemory(raw, { now = Date.now() } = {}) {
     if (ids.has(id)) return { ok: false, error: `${at}: two events have the same start and title` };
     ids.add(id);
     const out = { id, start: new Date(s).toISOString(), end: new Date(f).toISOString(), title };
-    for (const k of ['series', 'attendees', 'external', 'exec', 'role', 'notes', 'open', 'prep', 'prep_done']) if (e[k] !== undefined) out[k] = e[k];
+    for (const k of ['series', 'attendees', 'external', 'exec', 'role', 'with', 'notes', 'open', 'prep', 'prep_done']) if (e[k] !== undefined) out[k] = e[k];
     events.push(out);
   }
   events.sort((a, b) => Date.parse(a.start) - Date.parse(b.start));

package/workspace/lib/people-cli.js

@@ -0,0 +1,135 @@
+'use strict';
+/* people-cli.js — `pmos people`: the people the PM works with in this repository, from a terminal
+ * (initiative people-directory, PRD R2, R9, R14, proposed D90).
+ *
+ *   pmos people [list] [--json]                       each person: name, role, last interaction, tone; and the review list
+ *   pmos people show <person> [--json]                one person's page: interactions, tone, shared work, notes, handles
+ *   pmos people record --file <sightings.json>        (agent session) append what the session saw
+ *   pmos people settings [--json]                     whether calendar attendee names are kept
+ *
+ * The same module the People place reads (lib/people-store.js), so a terminal line and the page cannot disagree.
+ * No command adds a person, merges, sets a tone or writes a note: those are the PM's presses in People (D90).
+ * `record` must name who recorded: the session's PMOS_SESSION token, or `--by <profile>` outside the workspace.
+ *
+ * Exit codes: 0 done, 1 refused, 2 usage.
+ */
+const fs = require('fs');
+const path = require('path');
+const store = require('./people-store');
+const { parseArgs } = require('./schedule-cli');
+
+const COMMANDS = { people: ['list', 'show', 'record', 'settings'] };
+const USAGE = [
+  'usage: pmos people [list|show|record|settings] — the people you work with in this repository',
+  '  pmos people [list] [--json]                 each person, and what waits for you in the review list',
+  '  pmos people show <person> [--json]          one person: interactions, tone, shared work, notes and handles',
+  '  pmos people record --file <sightings.json>  (agent session) record the people a session saw',
+  '  pmos people settings [--json]               whether calendar attendee names are kept (calendar names: on|off)',
+  'Nothing here adds a person, merges, sets a tone or writes a note. Do that in People.',
+];
+const BOOL = new Set(['json', 'help']);
+
+function parse(argv) {
+  const rest = []; const bools = {};
+  for (const a of argv) {
+    if (a.startsWith('--') && BOOL.has(a.slice(2))) bools[a.slice(2)] = true;
+    else if (a === '-h') bools.help = true;
+    else rest.push(a);
+  }
+  const { pos, flags } = parseArgs(rest);
+  return { pos, flags: { ...flags, ...bools } };
+}
+/** The repository holding `cwd`: the nearest folder with a .git entry. No process is started (R16). */
+function repoRoot(cwd) {
+  for (let d = path.resolve(cwd); ; d = path.dirname(d)) {
+    if (fs.existsSync(path.join(d, '.git'))) return d;
+    if (path.dirname(d) === d) return cwd;
+  }
+}
+/** Who is recording: the workspace session's token names it; outside the workspace, the profile the PM names. */
+function whoOf(flags, env) {
+  const tok = String(env.PMOS_SESSION || '').trim();
+  if (tok) return 'session:' + tok.split('.')[0].slice(0, 60);
+  if (flags.by) return 'profile:' + String(flags.by).slice(0, 60);
+  return null;
+}
+const toneWord = (t) => (t.confirmed ? t.confirmed : t.proposed ? `${t.proposed} (proposed)` : 'no tone yet');
+const handleText = (h) => `${h.kind} ${h.value}`;
+
+async function run(argv, { say = console.log, cwd = process.cwd(), env = process.env, now = Date.now() } = {}) {
+  const { pos, flags } = parse(argv.slice(1));
+  const sub = pos[0] || 'list';
+  if (flags.help || sub === 'help') { USAGE.forEach((l) => say(l)); return 0; }
+  const json = !!flags.json;
+  const root = flags.root ? path.resolve(cwd, flags.root) : repoRoot(cwd);
+  const fail = (error, code = 1) => { if (json) say(JSON.stringify({ ok: false, error })); else say(`✗ ${error}`); return code; };
+
+  if (sub === 'list') {
+    const v = store.view(root, { now });
+    if (!v.ok) return fail(v.error);
+    if (json) { say(JSON.stringify({ ok: true, people: v.people, review: v.review, settings: v.settings, counts: v.counts })); return 0; }
+    const r = v.review;
+    say(`People · ${v.people.length} ${v.people.length === 1 ? 'person' : 'people'} · ${r.new.length} new · ${r.merges.length} possible duplicate${r.merges.length === 1 ? '' : 's'} · ${r.tones.length} tone${r.tones.length === 1 ? '' : 's'} to confirm`);
+    if (!v.people.length && !r.new.length) { say('Nobody yet. Agent sessions record the people they see; you add them in People.'); return 0; }
+    for (const p of v.people) {
+      say(`${p.name}  (${p.id})  ${[p.role, p.org].filter(Boolean).join(' · ') || p.group}  · ${p.count} interaction${p.count === 1 ? '' : 's'}${p.last ? ' · last ' + p.last : ''} · ${toneWord(p.tone)}`);
+    }
+    if (r.new.length) {
+      say('New, waiting for you in People:');
+      for (const f of r.new) say(`  ${f.name}  ${handleText(f.handle)}  · ${f.count} sighting${f.count === 1 ? '' : 's'} from ${f.sources.join(', ')}`);
+    }
+    return 0;
+  }
+
+  if (sub === 'show') {
+    const id = pos[1];
+    if (!id) return fail('usage: pmos people show <person>', 2);
+    const v = store.view(root, { now });
+    if (!v.ok) return fail(v.error);
+    const q = String(id).toLowerCase();
+    const p = v.people.find((x) => x.id === q) || v.people.find((x) => x.name.toLowerCase() === q);
+    if (!p) return fail(`no person ${id} — pmos people list names everyone`);
+    if (json) { say(JSON.stringify({ ok: true, person: p })); return 0; }
+    say(`${p.name}  (${p.id})  ${[p.role, p.org].filter(Boolean).join(' · ')}  ${p.group}`);
+    const mix = Object.entries(p.tone.mix).map(([t, n]) => `${n} ${t}`).join(', ');
+    say(`Tone: ${toneWord(p.tone)}${mix ? ' · ' + mix : ''}`);
+    say(`Interactions (${p.count}):`);
+    for (const i of p.interactions.slice(0, 20)) say(`  ${i.date}  ${i.kind.padEnd(7)} ${i.text}${i.tone ? ' [' + i.tone + ']' : ''}  — ${i.source}: ${i.pointer}`);
+    const s = p.shared;
+    if (s.initiatives.length) say(`Initiatives: ${s.initiatives.map((g) => `${g.id} (${g.count})`).join(', ')}`);
+    for (const it of s.items) say(`  Owns ${it.id} ${it.title || ''} · ${it.state}${it.blocked ? ' · Blocked' + (it.reason ? ': ' + it.reason : '') : ''}`);
+    for (const m of s.meetings) say(`  Meeting ${String(m.start).slice(0, 16).replace('T', ' ')} ${m.title}`);
+    if (p.notes.length) { say('Notes:'); for (const n of p.notes) say(`  ${n.text}`); }
+    say(`Handles: ${p.handles.map(handleText).join(' · ')}`);
+    return 0;
+  }
+
+  if (sub === 'settings') {
+    const s = store.settings(root);
+    if (!s.ok) return fail(s.error);
+    if (json) say(JSON.stringify({ ok: true, calendar_names: s.calendar_names }));
+    else say(`calendar names: ${s.calendar_names ? 'on' : 'off'}`);
+    return 0;
+  }
+
+  if (sub === 'record') {
+    if (!flags.file) return fail('usage: pmos people record --file <sightings.json>', 2);
+    const by = whoOf(flags, env);
+    if (!by) return fail('a sighting must name who recorded it: run it in a workspace session, or add --by <profile>');
+    let parsed;
+    try { parsed = JSON.parse(fs.readFileSync(path.resolve(cwd, flags.file), 'utf8')); }
+    catch (e) { return fail(`could not read ${flags.file}: ${String((e && e.message) || e).slice(0, 160)}`); }
+    const sightings = Array.isArray(parsed) ? parsed : (parsed && parsed.sightings) || [];
+    const merges = (!Array.isArray(parsed) && parsed && parsed.merges) || [];
+    const r = store.record(root, { by, sightings, merges, now });
+    if (json) { say(JSON.stringify(r)); return r.ok ? 0 : 1; }
+    if (!r.ok && r.recorded === undefined) return fail(r.error);
+    say(`${r.recorded || 0} sighting(s) recorded · ${r.duplicates || 0} already recorded · ${r.proposals || 0} merge proposal(s) · ${(r.refused || []).length} refused`);
+    for (const x of r.refused || []) say(`✗ ${x.index !== undefined ? 'sighting ' + x.index : 'merge ' + x.merge}: ${x.error}`);
+    if (!r.ok) say(`✗ ${r.error}`);
+    return r.ok ? 0 : 1;
+  }
+  return fail(`pmos people ${sub} is not a command. ${USAGE[0]}`, 2);
+}
+
+module.exports = { run, COMMANDS, USAGE };

package/workspace/lib/people-store.js

@@ -0,0 +1,123 @@
+'use strict';
+/* people-store.js — the file side of People (initiative people-directory, PRD R1 to R10, proposed D90).
+ *
+ * lib/people.js decides; this module reads and appends. The `pmos people` verb and the /api/people routes both call
+ * it, so the terminal and the People place cannot hold two opinions about a person.
+ *
+ *   view(root, { now, meetings })            → { ok, people, review, settings, counts, file }
+ *   record(root, { by, sightings, merges, now }) → { ok, recorded, duplicates, refused[], error? }
+ *   decide(root, { actor, body, now })       → { ok, row } | { ok:false, error }   one PM page press
+ *   settings(root)                           → { ok, calendar_names, file }
+ *
+ * Every write is an append through people.js's validators, so a refused row is never on disk. No network, no process.
+ */
+const crypto = require('crypto');
+const P = require('./people');
+const fourPanel = require('./four-panel');
+const consoleState = require('./console-state');
+
+const MAX_PER_RECORD = 500;
+
+function stateDir(root) {
+  const e = consoleState.loadEngine();
+  if (!e.ok) return { ok: false, error: e.error };
+  const dir = fourPanel.storeDir(e.engine, root);
+  return dir ? { ok: true, dir } : { ok: false, error: 'this repository has no file-mode state directory' };
+}
+function readRows(root) {
+  const s = stateDir(root);
+  if (!s.ok) return s;
+  const r = fourPanel.readDeclarations(s.dir, P.LEDGER);
+  if (!r.ok) return { ok: false, error: r.error };
+  return { ok: true, dir: s.dir, file: r.file, rows: r.rows };
+}
+/** The plan items, for shared work (R10). A repository without a plan gives none. */
+function planItems(root) {
+  try { return Object.values(require('./plan-items').readFold(root).items || {}); } catch { return []; }
+}
+
+function view(root, { now = Date.now(), meetings = [] } = {}) {
+  const r = readRows(root);
+  if (!r.ok) return r;
+  const v = P.fold(r.rows, { now, items: planItems(root), meetings });
+  return { ok: true, ...v, file: r.file };
+}
+
+function settings(root) {
+  const r = readRows(root);
+  if (!r.ok) return r;
+  return { ok: true, calendar_names: P.fold(r.rows).settings.calendar_names, file: r.file };
+}
+
+const stamp = (row, by, now) => ({ v: 1, ...row, by, at: new Date(now).toISOString() });
+const sightKey = (r) => [P.handleKey(r.handle), r.interaction ? r.interaction.date : '', r.interaction ? r.interaction.pointer : '', r.interaction ? r.interaction.text : ''].join('\u0000');
+
+/**
+ * Append what an agent session saw. `by` names who recorded it (a session token or a profile); it is required.
+ * A calendar sighting is refused while the PM's calendar setting is off (R3). A sighting already on disk is skipped.
+ */
+function record(root, { by, sightings = [], merges = [], now = Date.now() } = {}) {
+  if (typeof by !== 'string' || !/^(session|profile):\S{1,60}$/.test(by)) return { ok: false, error: 'a sighting must name who recorded it' };
+  if (!Array.isArray(sightings) || !Array.isArray(merges)) return { ok: false, error: 'sightings and merges must be lists' };
+  if (sightings.length + merges.length > MAX_PER_RECORD) return { ok: false, error: `at most ${MAX_PER_RECORD} rows in one record` };
+  const r = readRows(root);
+  if (!r.ok) return r;
+  const calendarOn = P.fold(r.rows).settings.calendar_names;
+  const seen = new Set(r.rows.filter((x) => x && x.kind === 'sighting').map(sightKey));
+  const refused = [];
+  let recorded = 0; let duplicates = 0;
+  for (let i = 0; i < sightings.length; i++) {
+    const c = P.checkSighting(sightings[i]);
+    if (!c.ok) { refused.push({ index: i, error: c.error }); continue; }
+    if (c.row.source === 'calendar' && !calendarOn) { refused.push({ index: i, error: 'calendar names are off for this repository (Settings → People)' }); continue; }
+    const k = sightKey(c.row);
+    if (seen.has(k)) { duplicates++; continue; }
+    const w = fourPanel.appendDeclaration(r.dir, P.LEDGER, stamp(c.row, by, now));
+    if (!w.ok) return { ok: false, error: w.error, recorded, duplicates, refused };
+    seen.add(k); recorded++;
+  }
+  let proposals = 0;
+  for (let i = 0; i < merges.length; i++) {
+    const c = P.checkMergeProposal(merges[i]);
+    if (!c.ok) { refused.push({ merge: i, error: c.error }); continue; }
+    const w = fourPanel.appendDeclaration(r.dir, P.LEDGER, stamp(c.row, by, now));
+    if (!w.ok) return { ok: false, error: w.error, recorded, duplicates, refused };
+    proposals++;
+  }
+  return { ok: true, recorded, proposals, duplicates, refused };
+}
+
+/** A new note id: n- and eight letters or digits. */
+const noteId = () => 'n-' + crypto.randomBytes(6).toString('base64').replace(/[^0-9a-z]/gi, '').toLowerCase().slice(0, 8).padEnd(8, '0');
+
+/**
+ * One PM press. `actor` is requirePagePress's actor ({ by: 'pm:<slug>' }); the route has already checked the press.
+ * Add refuses a handle that a person already holds; merge, tone and notes refuse a person who does not exist.
+ */
+function decide(root, { actor, body, now = Date.now() } = {}) {
+  const by = actor && typeof actor.by === 'string' ? actor.by : null;
+  if (!by || !/^pm:/.test(by)) return { ok: false, error: 'only the PM decides who is a person' };
+  const b = body && typeof body === 'object' ? { ...body } : {};
+  if (b.act === 'note' && !b.id) b.id = noteId();
+  const c = P.checkDecision(b);
+  if (!c.ok) return c;
+  const r = readRows(root);
+  if (!r.ok) return r;
+  const v = P.fold(r.rows);
+  const row = c.row;
+  if (row.person && !v.people.some((p) => p.id === row.person)) return { ok: false, error: `no person ${row.person}` };
+  if (row.kind === 'add' && v.people.some((p) => p.handles.some((h) => P.handleKey(h) === P.handleKey(row.handle)))) {
+    return { ok: false, error: 'a person already holds that handle' };
+  }
+  const w = fourPanel.appendDeclaration(r.dir, P.LEDGER, stamp(row, by, now));
+  if (!w.ok) return { ok: false, error: w.error };
+  let person = row.person || null;
+  if (row.kind === 'add') {
+    const after = P.fold([...r.rows, stamp(row, by, now)]);
+    const p = after.people.find((x) => x.handles.some((h) => P.handleKey(h) === P.handleKey(row.handle)));
+    person = p ? p.id : null;
+  }
+  return { ok: true, row: w.recorded, person };
+}
+
+module.exports = { view, record, decide, settings, stateDir, readRows };