@rness/cli 0.16.0 → 0.17.1

package/dist/{chunk-ABCO6D6B.js → chunk-GAZDKEOH.js}

@@ -292,6 +292,7 @@ var KEYS = [
   "org",
   "agents",
   "pulse",
+  "projects",
   "repos",
   "scopes"
 ];
@@ -352,7 +353,26 @@ function readPulse(value) {
     fail(
       `"pulse" must be { "project": <number> } (got ${JSON.stringify(value)})`
     );
-  return { project: value.project };
+  return { [PULSE]: value.project };
+}
+var PULSE = "pulse";
+var PROJECT_NAME = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
+function readProjects(value) {
+  if (value === void 0) return null;
+  const entries = isRecord(value) ? Object.entries(value) : [];
+  const numbers = entries.map(([, n]) => n);
+  if (entries.length === 0 || !entries.every(
+    ([name, n]) => PROJECT_NAME.test(name) && typeof n === "number" && Number.isInteger(n) && n >= 1
+  ) || new Set(numbers).size !== numbers.length)
+    fail(
+      `"projects" must map names to distinct project numbers, as { "pulse": 4, "marketing": 5 } (got ${JSON.stringify(value)})`
+    );
+  return Object.fromEntries(entries);
+}
+function readProjectsOrPulse(data) {
+  if (data.pulse !== void 0 && data.projects !== void 0)
+    fail('"pulse" and "projects" at once: keep "projects" only');
+  return data.projects !== void 0 ? readProjects(data.projects) : readPulse(data.pulse);
 }
 function providerOf(manifest) {
   if (manifest.provider !== null) return manifest.provider;
@@ -421,7 +441,7 @@ async function loadManifest(rnessDir) {
     provider: readProvider(data.provider),
     org: readOrg(data.org),
     agents: readAgents(data.agents),
-    pulse: readPulse(data.pulse),
+    projects: readProjectsOrPulse(data),
     repos: readRepos(data.repos),
     scopes: readScopes(data.scopes)
   };
@@ -443,8 +463,10 @@ async function writeManifest(rnessDir, manifest) {
     lines.push(
       `  "agents": [${manifest.agents.map((a) => JSON.stringify(a)).join(", ")}],`
     );
-  if (manifest.pulse !== null)
-    lines.push(`  "pulse": { "project": ${manifest.pulse.project} },`);
+  if (manifest.projects !== null)
+    lines.push(
+      `  "projects": { ${Object.entries(manifest.projects).map(([name, n]) => `${JSON.stringify(name)}: ${n}`).join(", ")} },`
+    );
   lines.push(
     '  "repos": {',
     repos.join(",\n"),
@@ -486,7 +508,7 @@ function parseRepoSpec(spec, org, host) {
 }
 
 // src/version.ts
-var VERSION = "0.16.0";
+var VERSION = "0.17.1";
 
 // src/core/pm.ts
 import { execFile as execFile2 } from "child_process";
@@ -1321,6 +1343,196 @@ ${content}`;
 ${comment(digest(text))}`;
 }
 
+// src/pulse/collection.ts
+import { readFile as readFile5, readdir as readdir2 } from "fs/promises";
+import { join as join8 } from "path";
+var FIELD_TYPES = ["text", "date", "select", "number"];
+var TAKEN = new Set(
+  [
+    "Status",
+    "Collection",
+    "Agent",
+    "Working session",
+    "Path",
+    "Session history",
+    "Title",
+    "Assignees",
+    "Labels",
+    "Linked pull requests",
+    "Milestone",
+    "Repository",
+    "Reviewers",
+    "Type",
+    "Parent issue",
+    "Sub-issues progress"
+  ].map((n) => n.toLowerCase())
+);
+var isRecord2 = (v) => v !== null && typeof v === "object" && !Array.isArray(v);
+var isNames = (v) => Array.isArray(v) && v.every((s) => typeof s === "string" && s.trim() !== "") && new Set(v).size === v.length;
+async function readText(path) {
+  try {
+    return await readFile5(path, "utf8");
+  } catch (e) {
+    if (e.code === "ENOENT") return null;
+    throw e;
+  }
+}
+function readField(where, name, value) {
+  const key = `fields.${name}`;
+  if (TAKEN.has(name.toLowerCase()))
+    throw new Error(`${where}: "${key}" is a field of rness: name it otherwise`);
+  if (!isRecord2(value))
+    throw new Error(`${where}: "fields" must map names to { type, from }`);
+  const type = FIELD_TYPES.find((t) => t === value["type"]);
+  if (type === void 0)
+    throw new Error(
+      `${where}: "${key}.type" must be one of ${FIELD_TYPES.join(", ")}`
+    );
+  const raw = value["from"];
+  const from = typeof raw === "string" && raw !== "" ? [raw] : raw;
+  if (!isNames(from) || from.length === 0)
+    throw new Error(
+      `${where}: "${key}.from" must be a front-matter key or a list of them`
+    );
+  const options = value["options"] ?? [];
+  if (!isNames(options) && !(Array.isArray(options) && options.length === 0))
+    throw new Error(`${where}: "${key}.options" must be a list of names`);
+  return { name, type, from, options: [...options] };
+}
+function readLabels(where, value) {
+  if (value === void 0 || value === null) return null;
+  if (typeof value !== "string" || value.trim() === "")
+    throw new Error(
+      `${where}: "labels" must be directory or a front-matter key`
+    );
+  return value === "directory" ? { kind: "directory" } : { kind: "key", key: value };
+}
+async function readShape(rnessDir, collection) {
+  const where = `${collection}/README.md`;
+  const text = await readText(join8(rnessDir, collection, "README.md"));
+  if (text === null)
+    return {
+      readme: null,
+      description: null,
+      statuses: null,
+      fields: [],
+      labels: null
+    };
+  let front;
+  try {
+    front = parseFrontMatter(text);
+  } catch (e) {
+    throw new Error(`${where}: ${e instanceof Error ? e.message : String(e)}`, {
+      cause: e
+    });
+  }
+  const f = front ?? {};
+  const description = f["description"] ?? null;
+  if (description !== null && typeof description !== "string")
+    throw new Error(`${where}: "description" must be text`);
+  const statuses = f["statuses"] ?? null;
+  if (statuses !== null && !isNames(statuses))
+    throw new Error(`${where}: "statuses" must be a list of names`);
+  const fields2 = f["fields"] ?? {};
+  if (!isRecord2(fields2))
+    throw new Error(`${where}: "fields" must map names to { type, from }`);
+  return {
+    readme: stripFrontMatter(text),
+    description: description === null ? null : description.trim(),
+    statuses: statuses === null ? null : [...statuses],
+    fields: Object.entries(fields2).map(
+      ([name, v]) => readField(where, name, v)
+    ),
+    labels: readLabels(where, f["labels"])
+  };
+}
+function dayOf(value) {
+  if (value instanceof Date && !Number.isNaN(value.getTime()))
+    return value.toISOString().slice(0, 10);
+  if (typeof value !== "string") return null;
+  const day = /^(\d{4}-\d{2}-\d{2})(?:$|[T ])/.exec(value.trim())?.[1];
+  return day ?? null;
+}
+function valueOf(field, fields2) {
+  const key = field.from.find(
+    (k) => fields2[k] !== void 0 && fields2[k] !== null && fields2[k] !== ""
+  );
+  if (key === void 0) return null;
+  const raw = fields2[key];
+  switch (field.type) {
+    case "date":
+      return dayOf(raw);
+    case "number": {
+      const n = typeof raw === "number" ? raw : Number(raw);
+      return typeof raw !== "boolean" && Number.isFinite(n) ? String(n) : null;
+    }
+    default:
+      if (Array.isArray(raw)) return raw.map(String).join(", ");
+      return typeof raw === "object" ? null : String(raw);
+  }
+}
+function valuesOf(shape, fields2, rel) {
+  const values2 = Object.fromEntries(
+    shape.fields.map((f) => [f.name, valueOf(f, fields2)])
+  );
+  const labels = [];
+  if (shape.labels?.kind === "directory") {
+    const slash = rel.indexOf("/");
+    if (slash > 0) labels.push(rel.slice(0, slash));
+  } else if (shape.labels?.kind === "key") {
+    const raw = fields2[shape.labels.key];
+    for (const v of Array.isArray(raw) ? raw : [raw])
+      if (typeof v === "string" && v.trim() !== "" && !labels.includes(v))
+        labels.push(v.trim());
+  }
+  return { values: values2, labels };
+}
+var HEALTHS = [
+  "on-track",
+  "at-risk",
+  "off-track",
+  "complete",
+  "inactive"
+];
+async function readUpdates(rnessDir, collection) {
+  let names;
+  try {
+    names = (await readdir2(join8(rnessDir, collection, "updates"), {
+      withFileTypes: true
+    })).filter((e) => e.isFile() && e.name.endsWith(".md")).map((e) => e.name).sort();
+  } catch (e) {
+    if (e.code === "ENOENT") return [];
+    throw e;
+  }
+  const updates = [];
+  for (const name of names) {
+    const path = `${collection}/updates/${name}`;
+    const text = await readText(join8(rnessDir, collection, "updates", name)) ?? "";
+    let front;
+    try {
+      front = parseFrontMatter(text);
+    } catch (e) {
+      throw new Error(
+        `${path}: ${e instanceof Error ? e.message : String(e)}`,
+        {
+          cause: e
+        }
+      );
+    }
+    const health = HEALTHS.find((h) => h === front?.["health"]);
+    if (health === void 0)
+      throw new Error(`${path}: "health" must be one of ${HEALTHS.join(", ")}`);
+    updates.push({
+      path,
+      health,
+      startDate: dayOf(front?.["start_date"]),
+      targetDate: dayOf(front?.["target_date"]),
+      body: stripFrontMatter(text)
+    });
+  }
+  return updates;
+}
+
 // src/pulse/layout.ts
 var statusOf2 = (status2) => status2 === null || status2 === "?" ? null : status2;
 var LIFECYCLE = [
@@ -1394,36 +1606,92 @@ function fieldsOf(tabs) {
   }
   return fields2;
 }
-function layoutOf(tabs) {
-  const fields2 = fieldsOf(tabs);
+var once = (values2) => [...new Set(values2)];
+function layoutOf(tabs, own) {
+  if (own === void 0) {
+    const fields2 = fieldsOf(tabs);
+    return {
+      statuses: inLifecycleOrder(
+        [...fields2.values()].flatMap((f) => f.statuses)
+      ),
+      fields: [...fields2.values()],
+      types: tabs.map((t) => t.label),
+      views: tabs.map((t) => ({
+        name: t.label,
+        type: t.label,
+        field: fields2.get(t.label)?.name ?? null
+      })),
+      declared: [],
+      labels: []
+    };
+  }
+  const { shape, want } = own;
   return {
-    statuses: inLifecycleOrder([...fields2.values()].flatMap((f) => f.statuses)),
-    fields: [...fields2.values()],
+    statuses: once([
+      ...shape.statuses ?? [],
+      ...tabs.flatMap(collectionStatuses)
+    ]),
+    fields: [],
     types: tabs.map((t) => t.label),
-    views: tabs.map((t) => ({
-      name: t.label,
-      type: t.label,
-      field: fields2.get(t.label)?.name ?? null
-    }))
+    views: tabs.map((t) => ({ name: t.label, type: t.label, field: null })),
+    declared: shape.fields.map((f) => ({
+      name: f.name,
+      type: f.type,
+      options: f.type === "select" ? once([
+        ...f.options,
+        ...want.map((w) => w.values[f.name]).filter((v) => typeof v === "string")
+      ]) : []
+    })),
+    // Made only when a document carries it: a directory with no card is no
+    // label, though one carrying it once is taken off (`unlabels`).
+    labels: once(want.flatMap((w) => w.labels))
   };
 }
-function desiredOf(tabs, org) {
-  const fields2 = fieldsOf(tabs);
-  return tabs.flatMap(
-    (tab) => tab.rows.map((row) => ({
-      path: row.path,
-      title: `${row.id} \u2014 ${row.title}`,
-      body: headerOf(row.path, org),
-      status: statusOf2(row.status),
-      type: tab.label,
-      statusField: fields2.get(tab.label)?.name ?? null,
-      sessions: row.sessions?.map((e) => e.agent === void 0 ? e.id : `${e.agent} \xB7 ${e.id}`).join(", ") ?? null
-    }))
+var sessionsOf2 = (row) => row.sessions?.map((e) => e.agent === void 0 ? e.id : `${e.agent} \xB7 ${e.id}`).join(", ") ?? null;
+function desiredOf(tabs, org, own) {
+  const fields2 = own === void 0 ? fieldsOf(tabs) : /* @__PURE__ */ new Map();
+  const wanted = tabs.flatMap(
+    (tab) => tab.rows.map((row) => {
+      const { values: values2, labels } = own === void 0 ? { values: {}, labels: [] } : valuesOf(
+        own.shape,
+        own.fronts.get(row.path) ?? {},
+        row.path.slice(tab.name.length + 1)
+      );
+      return {
+        path: row.path,
+        title: `${row.id} \u2014 ${row.title}`,
+        body: headerOf(row.path, org),
+        status: statusOf2(row.status),
+        type: tab.label,
+        statusField: fields2.get(tab.label)?.name ?? null,
+        sessions: sessionsOf2(row),
+        values: values2,
+        labels,
+        unlabels: []
+      };
+    })
   );
+  if (own === void 0) return wanted;
+  const made = once([
+    ...wanted.flatMap((w) => w.labels),
+    ...own.shape.labels?.kind === "directory" ? own.directories ?? [] : []
+  ]);
+  return wanted.map((w) => ({
+    ...w,
+    unlabels: made.filter((l) => !w.labels.includes(l))
+  }));
 }
 
 // src/pulse/plan.ts
-var differs = (item, w) => item.title !== w.title || item.status !== w.status || w.statusField !== null && item.collectionStatus !== w.status || item.type !== w.type || item.sessions !== w.sessions;
+var lower = (labels) => new Set(labels.map((l) => l.toLowerCase()));
+function labelsDiffer(item, w) {
+  if (w.labels.length === 0 && w.unlabels.length === 0) return false;
+  const carried = lower(item.issue?.labels ?? []);
+  return w.labels.some((l) => !carried.has(l.toLowerCase())) || w.unlabels.some((l) => carried.has(l.toLowerCase()));
+}
+var differs = (item, w) => item.title !== w.title || item.status !== w.status || w.statusField !== null && item.collectionStatus !== w.status || item.type !== w.type || item.sessions !== w.sessions || Object.entries(w.values).some(
+  ([name, value]) => (item.values[name] ?? null) !== value
+) || labelsDiffer(item, w);
 var rank = (i) => i.issue === null ? 2 : i.issue.open ? 0 : 1;
 var keptFirst = (a, b) => rank(a) - rank(b) || (a.issue?.number ?? 0) - (b.issue?.number ?? 0);
 var gone = (item) => item.issue === null ? { kind: "archive", id: item.id } : { kind: "close", id: item.id };
@@ -1449,7 +1717,7 @@ function unwantedPaths(want, have) {
 function isGone(path, item, seen, opened) {
   return seen.has(path) || item.issue !== null && opened.get(item.issue.number) === path;
 }
-function planSync(want, have, seen = /* @__PURE__ */ new Set(), opened = /* @__PURE__ */ new Map()) {
+function planSync(want, have, seen = /* @__PURE__ */ new Set(), opened = /* @__PURE__ */ new Map(), elsewhere = () => false) {
   const byPath = /* @__PURE__ */ new Map();
   for (const item of have)
     if (item.path !== null)
@@ -1482,7 +1750,8 @@ function planSync(want, have, seen = /* @__PURE__ */ new Set(), opened = /* @__P
   for (const [path, item] of kept)
     if (!wanted.has(path))
       steps.push(
-        isGone(path, item, seen, opened) ? gone(item) : { kind: "unchanged", id: item.id }
+        // Its own project holds it now: off this board, not closed.
+        elsewhere(path) ? { kind: "remove", id: item.id } : isGone(path, item, seen, opened) ? gone(item) : { kind: "unchanged", id: item.id }
       );
   return [...steps, ...surplus];
 }
@@ -1843,11 +2112,11 @@ async function createRepository(owner, name, options) {
 }
 
 // src/core/github-projects.ts
-function isRecord2(v) {
+function isRecord3(v) {
   return v !== null && typeof v === "object";
 }
-var rateLimited = (body) => isRecord2(body) && Array.isArray(body["errors"]) && body["errors"].some(
-  (e) => isRecord2(e) && e["type"] === "RATE_LIMITED"
+var rateLimited = (body) => isRecord3(body) && Array.isArray(body["errors"]) && body["errors"].some(
+  (e) => isRecord3(e) && e["type"] === "RATE_LIMITED"
 );
 async function graphqlRaw(query, variables, options) {
   const body = await postJson(
@@ -1857,7 +2126,7 @@ async function graphqlRaw(query, variables, options) {
     true,
     rateLimited
   );
-  return isRecord2(body) ? body : {};
+  return isRecord3(body) ? body : {};
 }
 function firstError(answer) {
   const first = answer.errors?.[0];
@@ -1933,6 +2202,7 @@ function toField(raw) {
     id: raw.id ?? "",
     databaseId,
     name: raw.name ?? "",
+    dataType: raw.dataType ?? (raw.options === void 0 ? "TEXT" : "SINGLE_SELECT"),
     options: raw.options ?? null
   };
 }
@@ -1962,10 +2232,10 @@ var optionInput = (o, id) => ({
   color: o.color,
   description: ""
 });
-var FIELD_SELECTION = `... on ProjectV2FieldCommon { id databaseId name }
+var FIELD_SELECTION = `... on ProjectV2FieldCommon { id databaseId name dataType }
   ... on ProjectV2SingleSelectField { options { id name color } }`;
 async function createField(projectId, name, kind, o) {
-  const single = kind !== "TEXT";
+  const single = typeof kind !== "string";
   const d = await graphql(
     `mutation($projectId: ID!, $name: String!, $dataType: ProjectV2CustomFieldType!${single ? ", $options: [ProjectV2SingleSelectFieldOptionInput!]" : ""}) {
       createProjectV2Field(input: {
@@ -1975,7 +2245,7 @@ async function createField(projectId, name, kind, o) {
     {
       projectId,
       name,
-      dataType: single ? "SINGLE_SELECT" : "TEXT",
+      dataType: single ? "SINGLE_SELECT" : kind,
       ...single ? { options: kind.options.map((n) => optionInput(n)) } : {}
     },
     o
@@ -2062,6 +2332,22 @@ async function listItems(projectId, o, { bodies = true } = {}) {
                           }
                         }
                       }
+                      ... on ProjectV2ItemFieldDateValue {
+                        date
+                        field {
+                          ... on ProjectV2FieldCommon {
+                            name
+                          }
+                        }
+                      }
+                      ... on ProjectV2ItemFieldNumberValue {
+                        number
+                        field {
+                          ... on ProjectV2FieldCommon {
+                            name
+                          }
+                        }
+                      }
                     }
                   }
                 }
@@ -2081,7 +2367,7 @@ async function listItems(projectId, o, { bodies = true } = {}) {
       const values2 = {};
       for (const v of n.fieldValues?.nodes ?? []) {
         const field = v.field?.name;
-        const value = v.text ?? v.name;
+        const value = v.text ?? v.name ?? v.date ?? (v.number === void 0 ? void 0 : String(v.number));
         if (field !== void 0 && value !== void 0) values2[field] = value;
       }
       const c = n.content;
@@ -2152,7 +2438,7 @@ async function setValue(projectId, itemId, fieldId, value, o) {
       projectId,
       itemId,
       fieldId,
-      value: "text" in value ? { text: value.text } : { singleSelectOptionId: value.optionId }
+      value: "optionId" in value ? { singleSelectOptionId: value.optionId } : value
     },
     o
   );
@@ -2351,6 +2637,142 @@ async function renameView(viewId, name, visibleFieldIds, o) {
     o
   );
 }
+async function deleteItem(projectId, itemId, o) {
+  await graphql(
+    `
+      mutation ($projectId: ID!, $itemId: ID!) {
+        deleteProjectV2Item(input: { projectId: $projectId, itemId: $itemId }) {
+          deletedItemId
+        }
+      }
+    `,
+    { projectId, itemId },
+    o
+  );
+}
+async function projectText(projectId, o) {
+  const d = await graphql(
+    `
+      query ($projectId: ID!) {
+        node(id: $projectId) {
+          ... on ProjectV2 {
+            projectReadme: readme
+            projectDescription: shortDescription
+          }
+        }
+      }
+    `,
+    { projectId },
+    o
+  );
+  return {
+    readme: d.node?.projectReadme ?? "",
+    shortDescription: d.node?.projectDescription ?? ""
+  };
+}
+async function updateProjectText(projectId, text, o) {
+  await graphql(
+    `
+      mutation ($projectId: ID!, $readme: String, $shortDescription: String) {
+        updateProjectV2(
+          input: {
+            projectId: $projectId
+            readme: $readme
+            shortDescription: $shortDescription
+          }
+        ) {
+          projectV2 {
+            id
+          }
+        }
+      }
+    `,
+    { projectId, ...text },
+    o
+  );
+}
+async function statusUpdates(projectId, o) {
+  const d = await graphql(
+    `
+      query ($projectId: ID!) {
+        node(id: $projectId) {
+          ... on ProjectV2 {
+            statusUpdates(first: 100) {
+              nodes {
+                id
+                body
+                status
+                startDate
+                targetDate
+              }
+            }
+          }
+        }
+      }
+    `,
+    { projectId },
+    o
+  );
+  return d.node?.statusUpdates.nodes ?? [];
+}
+async function createStatusUpdate(projectId, update, o) {
+  await graphql(
+    `
+      mutation (
+        $projectId: ID!
+        $body: String!
+        $status: ProjectV2StatusUpdateStatus!
+        $startDate: Date
+        $targetDate: Date
+      ) {
+        createProjectV2StatusUpdate(
+          input: {
+            projectId: $projectId
+            body: $body
+            status: $status
+            startDate: $startDate
+            targetDate: $targetDate
+          }
+        ) {
+          statusUpdate {
+            id
+          }
+        }
+      }
+    `,
+    { projectId, ...update },
+    o
+  );
+}
+async function updateStatusUpdate(statusUpdateId, update, o) {
+  await graphql(
+    `
+      mutation (
+        $statusUpdateId: ID!
+        $body: String!
+        $status: ProjectV2StatusUpdateStatus!
+        $startDate: Date
+        $targetDate: Date
+      ) {
+        updateProjectV2StatusUpdate(
+          input: {
+            statusUpdateId: $statusUpdateId
+            body: $body
+            status: $status
+            startDate: $startDate
+            targetDate: $targetDate
+          }
+        ) {
+          statusUpdate {
+            id
+          }
+        }
+      }
+    `,
+    { statusUpdateId, ...update },
+    o
+  );
+}
 
 // src/core/github-issues.ts
 async function repository(owner, name, label, o) {
@@ -2489,7 +2911,7 @@ async function reopenIssue(id, o) {
     o
   );
 }
-async function addLabels(id, labelIds, o) {
+async function addLabels(id, labelIds2, o) {
   await graphql(
     `
       mutation ($id: ID!, $labelIds: [ID!]!) {
@@ -2498,7 +2920,53 @@ async function addLabels(id, labelIds, o) {
         }
       }
     `,
-    { id, labelIds },
+    { id, labelIds: labelIds2 },
+    o
+  );
+}
+async function labelIds(owner, name, o) {
+  const ids = /* @__PURE__ */ new Map();
+  let after = null;
+  for (; ; ) {
+    const d = await graphql(
+      `
+        query ($owner: String!, $name: String!, $after: String) {
+          repository(owner: $owner, name: $name) {
+            labelList: labels(first: 100, after: $after) {
+              nodes {
+                id
+                name
+              }
+              pageInfo {
+                hasNextPage
+                endCursor
+              }
+            }
+          }
+        }
+      `,
+      { owner, name, after },
+      o
+    );
+    const list2 = d.repository?.labelList;
+    for (const l of list2?.nodes ?? []) ids.set(l.name, l.id);
+    if (list2?.pageInfo.hasNextPage !== true || list2.pageInfo.endCursor === null)
+      return ids;
+    after = list2.pageInfo.endCursor;
+  }
+}
+async function removeLabels(id, labelIds2, o) {
+  await graphql(
+    `
+      mutation ($id: ID!, $labelIds: [ID!]!) {
+        removeLabelsFromLabelable(
+          input: { labelableId: $id, labelIds: $labelIds }
+        ) {
+          clientMutationId
+        }
+      }
+    `,
+    { id, labelIds: labelIds2 },
     o
   );
 }
@@ -2515,9 +2983,19 @@ var FORMERLY = {
   [WORKING_SESSION]: "Session",
   [SESSION_HISTORY]: "Sessions"
 };
-var valueOf = (values2, name) => values2[name] ?? values2[FORMERLY[name] ?? ""] ?? null;
+var valueOf2 = (values2, name) => values2[name] ?? values2[FORMERLY[name] ?? ""] ?? null;
 var LABEL_COLOR = "5319e7";
 var LABEL_DESCRIPTION = "A document of .rness, on Agent Pulse";
+var OWN_LABEL_COLOR = "ededed";
+var OWN_LABEL_DESCRIPTION = "A label a collection of .rness gives its documents";
+var CALENDAR_VIEW = "Calendar";
+var markerOf = (path) => `<!-- rness: ${path} -->`;
+var DATA_TYPE = {
+  text: "TEXT",
+  date: "DATE",
+  number: "NUMBER",
+  select: "SINGLE_SELECT"
+};
 var labelled = (labels) => labels.some((l) => l.toLowerCase() === LABEL.toLowerCase());
 var STATUS_FIELD = "Status";
 var ALL_VIEW = "All";
@@ -2549,6 +3027,8 @@ var GitHubBoards = class {
   #cache = /* @__PURE__ */ new Map();
   /** Each organization's `.rness`, as first read: its id, its Issues, its label. */
   #memories = /* @__PURE__ */ new Map();
+  /** Each organization's `.rness` labels by name, read when a collection needs one. */
+  #labels = /* @__PURE__ */ new Map();
   constructor(options) {
     this.#o = options;
   }
@@ -2589,10 +3069,10 @@ var GitHubBoards = class {
       );
   }
   /** The project only: the caller declares it before `ensureLayout` builds it. */
-  async createBoard(org) {
+  async createBoard(org, title = PROJECT_TITLE) {
     const project = await createProject(
       await orgId(org, this.#o),
-      PROJECT_TITLE,
+      title,
       this.#o
     );
     const board = { org, number: project.number, url: project.url };
@@ -2603,7 +3083,7 @@ var GitHubBoards = class {
     const project = await findProject(org, number, this.#o);
     if (project === null) return null;
     const board = { org, number, url: project.url };
-    this.#remember(board, project.id);
+    if (!this.#cache.has(this.#key(board))) this.#remember(board, project.id);
     return board;
   }
   async ensureLayout(board, layout) {
@@ -2678,6 +3158,60 @@ var GitHubBoards = class {
     const session = await text(WORKING_SESSION);
     const path = await text("Path");
     const sessions = await text(SESSION_HISTORY);
+    const declared2 = [];
+    for (const d of layout.declared) {
+      const type = DATA_TYPE[d.type];
+      const field = fields2.find((f) => f.name === d.name);
+      if (field !== void 0 && field.dataType !== type)
+        throw new Error(
+          `the project's field ${d.name} is not a ${d.type} field: rename it on the project, or in the collection's README`
+        );
+      if (d.type !== "select") {
+        if (field !== void 0) declared2.push(field);
+        else {
+          added.push(`field ${d.name}`);
+          declared2.push(
+            await createField(
+              cache.projectId,
+              d.name,
+              DATA_TYPE[d.type],
+              this.#o
+            )
+          );
+        }
+        continue;
+      }
+      if (field === void 0 && d.options.length === 0) continue;
+      const options = (names) => names.map((name) => ({
+        name,
+        color: field?.options?.find((o) => o.name === name)?.color ?? "GRAY"
+      }));
+      if (field === void 0) {
+        added.push(`field ${d.name}`);
+        declared2.push(
+          await createField(
+            cache.projectId,
+            d.name,
+            { options: options(d.options) },
+            this.#o
+          )
+        );
+        continue;
+      }
+      const now = namesOf(field);
+      const next = orderedFirst(d.options, [
+        ...now,
+        ...d.options.filter((n) => !now.includes(n))
+      ]);
+      if (next.every((n, i) => n === now[i]) && next.length === now.length)
+        declared2.push(field);
+      else {
+        added.push(
+          ...d.options.filter((n) => !now.includes(n)).map((n) => `option ${n}`)
+        );
+        declared2.push(await setOptions(field, options(next), this.#o));
+      }
+    }
     const current = await views(cache.projectId, this.#o);
     const first = current[0];
     if (first !== void 0 && first.name === DEFAULT_VIEW && !current.some((v) => v.name === ALL_VIEW)) {
@@ -2710,6 +3244,19 @@ var GitHubBoards = class {
         this.#o
       );
     }
+    if (layout.declared.some((d) => d.type === "date") && !current.some((v) => v.name === CALENDAR_VIEW)) {
+      added.push(`view ${CALENDAR_VIEW}`);
+      await createView(
+        board.org,
+        board.number,
+        {
+          name: CALENDAR_VIEW,
+          layout: "roadmap",
+          filter: viewFilter(layout.types[0] ?? "")
+        },
+        this.#o
+      );
+    }
     if (!current.some((v) => v.name === WORKING_VIEW)) {
       added.push(`view ${WORKING_VIEW}`);
       await createView(
@@ -2740,6 +3287,9 @@ var GitHubBoards = class {
       );
       added.push(`label ${LABEL}`);
     }
+    for (const name of layout.labels)
+      if ((await this.#ownLabel(board.org, name)).made)
+        added.push(`label ${name}`);
     const repository2 = `${board.org}/${MEMORY}`;
     const linked = await linkedRepositories(cache.projectId, this.#o);
     if (!linked.some((r) => r.toLowerCase() === repository2.toLowerCase())) {
@@ -2753,10 +3303,33 @@ var GitHubBoards = class {
       agent,
       session,
       path,
-      sessions
+      sessions,
+      ...declared2
     ];
     return added;
   }
+  /** A collection's label on `.rness`, made when missing; its id, and whether this made it. */
+  async #ownLabel(org, name) {
+    let ids = this.#labels.get(org);
+    if (ids === void 0) {
+      ids = await labelIds(org, MEMORY, this.#o);
+      this.#labels.set(org, ids);
+    }
+    const known = [...ids].find(([n]) => n.toLowerCase() === name.toLowerCase());
+    if (known !== void 0) return { id: known[1], made: false };
+    const id = await createLabel(
+      org,
+      MEMORY,
+      {
+        name,
+        color: OWN_LABEL_COLOR,
+        description: OWN_LABEL_DESCRIPTION
+      },
+      this.#o
+    );
+    ids.set(name, id);
+    return { id, made: true };
+  }
   async items(board, options = {}) {
     const cache = await this.#cacheOf(board);
     const raw = await listItems(cache.projectId, this.#o, options);
@@ -2772,15 +3345,17 @@ var GitHubBoards = class {
           number: issue.number,
           open: issue.open,
           labelled: labelled(issue.labels),
-          body: issue.body
+          body: issue.body,
+          labels: [...issue.labels]
         },
         title: r.title,
         status: r.values[STATUS_FIELD] ?? null,
         collectionStatus: r.values[statusFieldName(r.values[COLLECTION_FIELD] ?? "")] ?? null,
         type: r.values[COLLECTION_FIELD] ?? null,
         agent: r.values["Agent"] ?? null,
-        session: valueOf(r.values, WORKING_SESSION),
-        sessions: valueOf(r.values, SESSION_HISTORY)
+        session: valueOf2(r.values, WORKING_SESSION),
+        sessions: valueOf2(r.values, SESSION_HISTORY),
+        values: { ...r.values }
       };
     });
   }
@@ -2790,7 +3365,10 @@ var GitHubBoards = class {
     const field = fields2.find((f) => f.name === name) ?? fields2.find((f) => f.name === FORMERLY[name]);
     if (field === void 0) throw new Error(`the board has no field ${name}`);
     let sent = null;
-    if (value !== null && field.options === null) sent = { text: value };
+    if (value !== null && field.dataType === "DATE") sent = { date: value };
+    else if (value !== null && field.dataType === "NUMBER")
+      sent = { number: Number(value) };
+    else if (value !== null && field.options === null) sent = { text: value };
     else if (value !== null) {
       const option = field.options?.find((opt) => opt.name === value);
       if (option === void 0)
@@ -2807,6 +3385,11 @@ var GitHubBoards = class {
     if (step2.kind === "unchanged") return null;
     const cache = await this.#cacheOf(board);
     if (step2.kind === "create") return this.#create(board, cache, step2.want);
+    if (step2.kind === "remove") {
+      await deleteItem(cache.projectId, step2.id, this.#o);
+      cache.known.delete(step2.id);
+      return null;
+    }
     const known = await this.#known(board, step2.id);
     if (step2.kind === "archive" || step2.kind === "close") {
       if (step2.kind === "close" && known.issue?.open === true)
@@ -2837,6 +3420,7 @@ var GitHubBoards = class {
         labels: []
       };
       await this.#issue(known, step2.want, labelId);
+      await this.#ownLabels(board.org, known, step2.want);
       await this.#values(board, step2.id, step2.want);
       return { id: step2.id, number: made.number };
     }
@@ -2846,6 +3430,7 @@ var GitHubBoards = class {
       issue.open = true;
     }
     await this.#issue(known, step2.want, labelId);
+    await this.#ownLabels(board.org, known, step2.want);
     await this.#values(board, step2.id, step2.want);
     return null;
   }
@@ -2889,6 +3474,7 @@ var GitHubBoards = class {
       };
       cache.known.set(id2, known);
       await this.#issue(known, want, labelId);
+      await this.#ownLabels(board.org, known, want);
       await this.#values(board, id2, want);
       return { id: id2, number: found.number, adopted: true };
     }
@@ -2912,6 +3498,7 @@ var GitHubBoards = class {
       archived: false,
       values: {}
     });
+    await this.#ownLabels(board.org, cache.known.get(id), want);
     await this.#values(board, id, want);
     return { id, number: made.number };
   }
@@ -2927,18 +3514,45 @@ var GitHubBoards = class {
       known.title = want.title;
     }
   }
+  /** The labels a collection gives the issue, and those it takes off (spec 0025 §4). */
+  async #ownLabels(org, known, want) {
+    if (want.labels.length === 0 && want.unlabels.length === 0) return;
+    const issue = this.#issueOf(known);
+    const carried = (name) => issue.labels.find((l) => l.toLowerCase() === name.toLowerCase());
+    const add = want.labels.filter((l) => carried(l) === void 0);
+    const off = want.unlabels.filter((l) => carried(l) !== void 0);
+    if (add.length > 0) {
+      const ids = [];
+      for (const name of add) ids.push((await this.#ownLabel(org, name)).id);
+      await addLabels(issue.id, ids, this.#o);
+      issue.labels.push(...add);
+    }
+    if (off.length > 0) {
+      const ids = [];
+      for (const name of off) ids.push((await this.#ownLabel(org, name)).id);
+      await removeLabels(issue.id, ids, this.#o);
+      issue.labels = issue.labels.filter(
+        (l) => !off.some((o) => o.toLowerCase() === l.toLowerCase())
+      );
+    }
+  }
   /** Path first — an issue on the board without it is the team's — then the fields, each only when it differs. */
   async #values(board, id, want) {
     const values2 = (await this.#known(board, id)).values;
+    const fields2 = await this.#fields(board);
     const wanted = [
       ["Path", want.path],
       [COLLECTION_FIELD, want.type],
       [STATUS_FIELD, want.status],
       ...want.statusField === null ? [] : [[want.statusField, want.status]],
-      [SESSION_HISTORY, want.sessions]
+      [SESSION_HISTORY, want.sessions],
+      // A select with no option yet has no field yet: nothing to write.
+      ...Object.entries(want.values).filter(
+        ([name]) => fields2.some((f) => f.name === name)
+      )
     ];
     for (const [name, value] of wanted)
-      if (valueOf(values2, name) !== value)
+      if (valueOf2(values2, name) !== value)
         await this.#set(board, id, name, value);
   }
   async #known(board, id) {
@@ -2967,6 +3581,48 @@ var GitHubBoards = class {
       await this.#set(board, id, WORKING_SESSION, session);
     }
   }
+  async describe(board, text) {
+    const cache = await this.#cacheOf(board);
+    const now = await projectText(cache.projectId, this.#o);
+    const next = {};
+    if (text.readme !== null && now.readme.trimEnd() !== text.readme.trimEnd())
+      next.readme = text.readme.trimEnd();
+    if (text.description !== null && now.shortDescription !== text.description)
+      next.shortDescription = text.description;
+    if (next.readme === void 0 && next.shortDescription === void 0)
+      return [];
+    await updateProjectText(cache.projectId, next, this.#o);
+    return [
+      ...next.readme === void 0 ? [] : ["readme"],
+      ...next.shortDescription === void 0 ? [] : ["short description"]
+    ];
+  }
+  async postUpdates(board, updates) {
+    if (updates.length === 0) return [];
+    const cache = await this.#cacheOf(board);
+    const there = await statusUpdates(cache.projectId, this.#o);
+    const written = [];
+    for (const u of updates) {
+      const marker = markerOf(u.path);
+      const input = {
+        body: `${u.body.trimEnd()}
+
+${marker}`,
+        status: u.health.toUpperCase().replace("-", "_"),
+        startDate: u.startDate,
+        targetDate: u.targetDate
+      };
+      const posted = there.find((p) => p.body.includes(marker));
+      if (posted === void 0) {
+        await createStatusUpdate(cache.projectId, input, this.#o);
+        written.push(`posted ${u.path}`);
+      } else if (posted.body.trimEnd() !== input.body || posted.status !== input.status || (posted.startDate ?? null) !== input.startDate || (posted.targetDate ?? null) !== input.targetDate) {
+        await updateStatusUpdate(posted.id, input, this.#o);
+        written.push(`updated ${u.path}`);
+      }
+    }
+    return written;
+  }
 };
 
 // src/core/github-oauth-provider.ts
@@ -3047,8 +3703,8 @@ var GitHubOAuthProvider = class {
   async checkIssues(org) {
     return this.#boards().checkIssues(org);
   }
-  async createBoard(org) {
-    return this.#boards().createBoard(org);
+  async createBoard(org, title) {
+    return this.#boards().createBoard(org, title);
   }
   async board(org, number) {
     return this.#boards().board(org, number);
@@ -3065,6 +3721,12 @@ var GitHubOAuthProvider = class {
   async mark(board, itemIds, session) {
     return this.#boards().mark(board, itemIds, session);
   }
+  async describe(board, text) {
+    return this.#boards().describe(board, text);
+  }
+  async postUpdates(board, updates) {
+    return this.#boards().postUpdates(board, updates);
+  }
   credentialsFor(url) {
     if (this.#token === null || !url.startsWith(GITHUB_HTTPS)) return null;
     return { username: "x-access-token", password: this.#token.token };
@@ -3079,11 +3741,11 @@ async function githubProvider(apiBase, wait) {
 }
 
 // src/core/repos.ts
-import { glob as glob2, readFile as readFile5, rm as rm3 } from "fs/promises";
-import { join as join8, posix as posix5, sep as sep2 } from "path";
+import { glob as glob2, readFile as readFile6, rm as rm3 } from "fs/promises";
+import { join as join9, posix as posix5, sep as sep2 } from "path";
 async function addRepository(input) {
   const { name, url } = parseRepoSpec(input.spec, input.org, input.host);
-  const dir = join8(input.root, "org", name);
+  const dir = join9(input.root, "org", name);
   const repoPath = `org/${name}`;
   const current = input.manifest.scopes[name];
   if (current !== void 0 && current.path !== repoPath)
@@ -3126,7 +3788,7 @@ async function addRepository(input) {
   }
   const declared2 = [name];
   for (const { path, base } of subs) {
-    if (!await exists(join8(input.root, ...path.split("/")))) {
+    if (!await exists(join9(input.root, ...path.split("/")))) {
       if (action === "cloned") await rm3(dir, { recursive: true, force: true });
       throw new Error(`${path} does not exist`);
     }
@@ -3144,7 +3806,7 @@ async function workspaceDirs(repoDir) {
   let patterns = [];
   try {
     const pkg = JSON.parse(
-      await readFile5(join8(repoDir, "package.json"), "utf8")
+      await readFile6(join9(repoDir, "package.json"), "utf8")
     );
     const w = pkg.workspaces;
     if (Array.isArray(w))
@@ -3161,7 +3823,7 @@ async function workspaceDirs(repoDir) {
   for (const pattern of patterns) {
     for await (const match of glob2(pattern, { cwd: repoDir })) {
       const rel = match.split(sep2).join(posix5.sep);
-      if (await exists(join8(repoDir, ...rel.split(posix5.sep), "package.json")))
+      if (await exists(join9(repoDir, ...rel.split(posix5.sep), "package.json")))
         dirs.add(rel);
     }
   }
@@ -3412,8 +4074,8 @@ function httpsFlagLine(spec) {
 }
 
 // src/core/workspace.ts
-import { readdir as readdir2 } from "fs/promises";
-import { dirname as dirname3, join as join9, parse as parse2, resolve as resolve2 } from "path";
+import { readdir as readdir3 } from "fs/promises";
+import { dirname as dirname3, join as join10, parse as parse2, resolve as resolve2 } from "path";
 async function findWorkspace(startDir) {
   const start = resolve2(startDir);
   const { root: fsRoot } = parse2(start);
@@ -3423,18 +4085,18 @@ async function findWorkspace(startDir) {
     if (dir === fsRoot) break;
   }
   for (const dir of ancestors) {
-    if (await exists(join9(dir, ".rness", "rness.json")))
-      return { root: dir, rnessDir: join9(dir, ".rness") };
+    if (await exists(join10(dir, ".rness", "rness.json")))
+      return { root: dir, rnessDir: join10(dir, ".rness") };
   }
   for (const dir of ancestors) {
-    if (await exists(join9(dir, "rness.json")))
+    if (await exists(join10(dir, "rness.json")))
       return { root: dirname3(dir), rnessDir: dir };
   }
   throw new Error(`no rness workspace found above ${startDir}`);
 }
 async function clonesIn(root) {
   try {
-    const entries = await readdir2(join9(root, "org"), { withFileTypes: true });
+    const entries = await readdir3(join10(root, "org"), { withFileTypes: true });
     return new Set(
       entries.filter((e) => e.isDirectory() && isWorkspaceClone(e.name)).map((e) => e.name)
     );
@@ -3458,15 +4120,15 @@ function reportError(e) {
 }
 
 // src/core/delegate.ts
-import { readFile as readFile6 } from "fs/promises";
-import { join as join10 } from "path";
+import { readFile as readFile7 } from "fs/promises";
+import { join as join11 } from "path";
 var DEFAULT_BIN = "dist/bin/rness.js";
 var PINNED_BIN = `node_modules/@rness/cli/${DEFAULT_BIN}`;
 async function readPinnedCli(rnessDir) {
-  const dir = join10(rnessDir, "node_modules", "@rness", "cli");
+  const dir = join11(rnessDir, "node_modules", "@rness", "cli");
   let pkg;
   try {
-    pkg = JSON.parse(await readFile6(join10(dir, "package.json"), "utf8"));
+    pkg = JSON.parse(await readFile7(join11(dir, "package.json"), "utf8"));
   } catch {
     return null;
   }
@@ -3486,7 +4148,7 @@ async function readPinnedCli(rnessDir) {
 async function pinnedBinPath(rnessDir) {
   const pinned = await readPinnedCli(rnessDir);
   if (pinned === null) return null;
-  return join10(pinned.dir, ...pinned.bin.split("/"));
+  return join11(pinned.dir, ...pinned.bin.split("/"));
 }
 async function findDelegate(cwd, ownVersion) {
   let root;
@@ -3502,7 +4164,7 @@ async function findDelegate(cwd, ownVersion) {
   if (pinned === null) return null;
   const { version } = pinned;
   if (version === null || version === ownVersion) return null;
-  return { entry: join10(pinned.dir, "dist", "index.js"), version, root };
+  return { entry: join11(pinned.dir, "dist", "index.js"), version, root };
 }
 
 // src/core/block.ts
@@ -3569,7 +4231,7 @@ function isCurrentBlock(blockLines, freshHash) {
 }
 
 // src/core/merge.ts
-import { join as join11 } from "path";
+import { join as join12 } from "path";
 function findBlock(lines) {
   const begins = [];
   const ends = [];
@@ -3628,7 +4290,7 @@ function claudeMdAtRoot(existing, block) {
   return merged.ok ? { ...merged, changed: merged.text !== existing } : merged;
 }
 async function ensureClaudeMd(dir) {
-  const file = join11(dir, "CLAUDE.md");
+  const file = join12(dir, "CLAUDE.md");
   if (await isSymlink(file)) return "unchanged";
   const existing = await readOrNull(file);
   if (existing === null) {
@@ -3643,11 +4305,11 @@ async function ensureClaudeMd(dir) {
 }
 
 // src/commands/sync.ts
-import { join as join14 } from "path";
+import { join as join15 } from "path";
 
 // src/core/agent-targets.ts
 import { mkdir as mkdir2 } from "fs/promises";
-import { dirname as dirname4, join as join13 } from "path";
+import { dirname as dirname4, join as join14 } from "path";
 
 // src/core/claude-skills.ts
 var PLUGIN = ".claude/skills/rness";
@@ -4092,8 +4754,8 @@ function describeGuarantee(g) {
 
 // src/core/pinned.ts
 import { execFile as execFile3 } from "child_process";
-import { readFile as readFile7 } from "fs/promises";
-import { basename as basename3, join as join12 } from "path";
+import { readFile as readFile8 } from "fs/promises";
+import { basename as basename3, join as join13 } from "path";
 import { promisify as promisify3 } from "util";
 var execFileP3 = promisify3(execFile3);
 var PACKAGE = "@rness/cli";
@@ -4118,7 +4780,7 @@ function compareVersions(a, b) {
 async function readPackageJson(rnessDir) {
   try {
     const parsed = JSON.parse(
-      await readFile7(join12(rnessDir, "package.json"), "utf8")
+      await readFile8(join13(rnessDir, "package.json"), "utf8")
     );
     return parsed !== null && typeof parsed === "object" ? parsed : null;
   } catch {
@@ -4137,8 +4799,8 @@ async function readPin(rnessDir) {
   return null;
 }
 async function writePin(rnessDir, from, to) {
-  const file = join12(rnessDir, "package.json");
-  const text = await readFile7(file, "utf8");
+  const file = join13(rnessDir, "package.json");
+  const text = await readFile8(file, "utf8");
   const entry = new RegExp(
     `("${PACKAGE}"\\s*:\\s*")${from.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}(")`
   );
@@ -4160,12 +4822,12 @@ async function workspacePackageManager(rnessDir) {
     if (isPackageManager(name)) return name;
   }
   for (const [lockfile, pm] of LOCKFILES)
-    if (await exists(join12(rnessDir, lockfile))) return pm;
+    if (await exists(join13(rnessDir, lockfile))) return pm;
   return "npm";
 }
 async function hasLockfile(rnessDir, pm) {
   for (const [lockfile, owner] of LOCKFILES)
-    if (owner === pm && await exists(join12(rnessDir, lockfile))) return true;
+    if (owner === pm && await exists(join13(rnessDir, lockfile))) return true;
   return false;
 }
 async function pinDrift(rnessDir) {
@@ -4221,9 +4883,9 @@ async function ensureInstalled(rnessDir, opts = {}) {
   }
 }
 async function runPinnedSync(root) {
-  const installed = await readPinnedCli(join12(root, ".rness"));
+  const installed = await readPinnedCli(join13(root, ".rness"));
   if (installed === null) return null;
-  const pinned = join12(installed.dir, ...installed.bin.split("/"));
+  const pinned = join13(installed.dir, ...installed.bin.split("/"));
   if (!await exists(pinned))
     return {
       code: 1,
@@ -4298,7 +4960,7 @@ function syncOutcome(result, opts = {}) {
   };
 }
 async function syncPinned(root, shown, fallback) {
-  const rnessDir = join12(root, ".rness");
+  const rnessDir = join13(root, ".rness");
   const installed = await readPinnedCli(rnessDir);
   if (installed === null) {
     if (fallback !== void 0) return fallback();
@@ -4308,7 +4970,7 @@ async function syncPinned(root, shown, fallback) {
     );
     return 1;
   }
-  const pinned = join12(installed.dir, ...installed.bin.split("/"));
+  const pinned = join13(installed.dir, ...installed.bin.split("/"));
   if (!await exists(pinned)) {
     process.stderr.write(
       `@rness/cli in ${shown}/.rness is not installed correctly (missing ${installed.bin}); reinstall in .rness/
@@ -4348,30 +5010,30 @@ function wholeDiff(existing, content) {
 }
 async function contextOf(root) {
   return {
-    packageManager: await workspacePackageManager(join13(root, ".rness"))
+    packageManager: await workspacePackageManager(join14(root, ".rness"))
   };
 }
 var PATHS_ONLY = { packageManager: "npm" };
 async function filesOf(root, manifest, targets) {
   const files = [];
-  if (!await exists(join13(root, "org"))) return files;
+  if (!await exists(join14(root, "org"))) return files;
   const ctx = await contextOf(root);
   for (const target2 of targets)
     for (const owned of target2.files(ctx))
       if (owned.at === "root")
         files.push({
           ...owned,
-          file: join13(root, ...owned.file.split("/")),
+          file: join14(root, ...owned.file.split("/")),
           label: owned.file
         });
   for (const repo of Object.keys(manifest.repos)) {
-    if (!await exists(join13(root, "org", repo))) continue;
+    if (!await exists(join14(root, "org", repo))) continue;
     for (const target2 of targets)
       for (const owned of target2.files(ctx))
         if (owned.at === "clones")
           files.push({
             ...owned,
-            file: join13(root, "org", repo, ...owned.file.split("/")),
+            file: join14(root, "org", repo, ...owned.file.split("/")),
             label: `org/${repo}/${owned.file}`
           });
   }
@@ -4695,7 +5357,7 @@ function targetsOf(manifest, root, only) {
     const segments = entry.path.split("/");
     targets.push({
       scope: name,
-      dir: join14(root, ...segments),
+      dir: join15(root, ...segments),
       depth: segments.length,
       label: `${entry.path}/AGENTS.md`
     });
@@ -4854,7 +5516,7 @@ async function syncCommand(opts, deps = {}) {
     try {
       const notCloned = /* @__PURE__ */ new Set();
       for (const [name, repo] of Object.entries(manifest.repos)) {
-        const dir = join14(ws.root, "org", name);
+        const dir = join15(ws.root, "org", name);
         const label = `org/${name}`;
         if (!await exists(dir)) {
           if (!toClone.has(name)) {
@@ -4906,7 +5568,7 @@ async function syncCommand(opts, deps = {}) {
         lines.push(
           `not in rness.json: ${undeclared.join(", ")} (${rnessCommand()} add <name> declares it)`
         );
-      if (!await exists(join14(ws.root, "org"))) {
+      if (!await exists(join15(ws.root, "org"))) {
         lines.push(["skipped", "blocks (no org/ directory here)"]);
       } else {
         let differences = 0;
@@ -4918,7 +5580,7 @@ async function syncCommand(opts, deps = {}) {
             continue;
           }
           const [agentsLinked, claudeLinked] = await Promise.all(
-            BLOCK_FILES.map((f) => isSymlink(join14(t.dir, f)))
+            BLOCK_FILES.map((f) => isSymlink(join15(t.dir, f)))
           );
           const atRoot = t.scope === null;
           if (!atRoot && (agentsLinked === true || claudeLinked === true)) {
@@ -4941,7 +5603,7 @@ async function syncCommand(opts, deps = {}) {
               `${t.label}: block is ${Math.round(block.bytes / 1024)} KB (over 32 KB)`
             );
           }
-          const agents = agentsLinked === true ? "skipped" : await syncBlockFile(join14(t.dir, "AGENTS.md"), block, check);
+          const agents = agentsLinked === true ? "skipped" : await syncBlockFile(join15(t.dir, "AGENTS.md"), block, check);
           if (typeof agents === "object") {
             problems.push(`${t.label}: ${agents.error}`);
             continue;
@@ -4956,7 +5618,7 @@ async function syncCommand(opts, deps = {}) {
           }
           if (claudeLinked === true) continue;
           const claude = await syncBlockFile(
-            join14(t.dir, "CLAUDE.md"),
+            join15(t.dir, "CLAUDE.md"),
             block,
             check,
             true
@@ -5013,7 +5675,7 @@ async function syncCommand(opts, deps = {}) {
 }
 
 // src/commands/add.ts
-import { basename as basename4, join as join15 } from "path";
+import { basename as basename4, join as join16 } from "path";
 function printDeclared(ui, result, already) {
   for (const name of result.declared) {
     if (already.has(name)) continue;
@@ -5106,7 +5768,7 @@ async function addCommand(spec, opts, deps = {}) {
     }
     parsed = parseRepoSpec(spec, org, host);
     const scopes = (opts.scopes ?? "").split(",").map((s) => s.trim()).filter((s) => s !== "");
-    const dir = join15(ws.root, "org", parsed.name);
+    const dir = join16(ws.root, "org", parsed.name);
     const present = await exists(dir);
     if (interactive) {
       const { confirm, isCancel } = await terminal.prompts();
@@ -5234,7 +5896,7 @@ async function contextCommand(opts) {
 
 // src/core/scaffold.ts
 import { statSync } from "fs";
-import { dirname as dirname5, join as join16 } from "path";
+import { dirname as dirname5, join as join17 } from "path";
 import { fileURLToPath } from "url";
 var SCAFFOLD_FILES = [
   "AGENTS.md",
@@ -5258,9 +5920,9 @@ var SCAFFOLD_FILES = [
 function scaffoldDir() {
   let dir = dirname5(fileURLToPath(import.meta.url));
   for (let i = 0; i < 4; i += 1) {
-    const candidate = join16(dir, "scaffold");
+    const candidate = join17(dir, "scaffold");
     try {
-      if (statSync(join16(candidate, "rness.json")).isFile()) return candidate;
+      if (statSync(join17(candidate, "rness.json")).isFile()) return candidate;
     } catch {
     }
     dir = dirname5(dir);
@@ -5269,15 +5931,15 @@ function scaffoldDir() {
 }
 
 // src/core/scaffold-copy.ts
-import { chmod as chmod2, mkdir as mkdir3, readFile as readFile8, stat as stat2, writeFile as writeFile2 } from "fs/promises";
-import { dirname as dirname6, join as join17 } from "path";
+import { chmod as chmod2, mkdir as mkdir3, readFile as readFile9, stat as stat2, writeFile as writeFile2 } from "fs/promises";
+import { dirname as dirname6, join as join18 } from "path";
 var TOKENISED = /* @__PURE__ */ new Set(["package.json"]);
 async function renderScaffold(source, tokens) {
   const files = [];
   for (const rel of SCAFFOLD_FILES) {
     if (rel === "rness.json") continue;
-    const from = join17(source, ...rel.split("/"));
-    let content = await readFile8(from, "utf8");
+    const from = join18(source, ...rel.split("/"));
+    let content = await readFile9(from, "utf8");
     if (TOKENISED.has(rel)) {
       content = content.replaceAll("__RNESS_VERSION__", tokens.version).replaceAll("__RNESS_PM__", tokens.packageManager);
     }
@@ -5291,7 +5953,7 @@ async function renderScaffold(source, tokens) {
 }
 async function copyScaffold(dest, tokens) {
   for (const file of await renderScaffold(scaffoldDir(), tokens)) {
-    const to = join17(dest, ...file.path.split("/"));
+    const to = join18(dest, ...file.path.split("/"));
     await mkdir3(dirname6(to), { recursive: true });
     await writeFile2(to, file.content, "utf8");
     if (file.executable) await chmod2(to, 493);
@@ -5400,7 +6062,7 @@ async function loginCommand(opts, deps = {}) {
       ui.error(unsupportedProviderMessage(manifest.provider));
       return 1;
     }
-    const needsProject = opts.project === true || manifest?.pulse != null;
+    const needsProject = opts.project === true || manifest?.projects != null;
     const bin = deps.bin ?? await realpath(process.argv[1] ?? "").catch(() => "");
     const env = envToken();
     if (env !== null)
@@ -5471,7 +6133,7 @@ function revokeUrl() {
 // src/commands/create.ts
 import { mkdir as mkdir6, mkdtemp as mkdtemp2, rename as rename2, rm as rm6 } from "fs/promises";
 import { tmpdir as tmpdir2 } from "os";
-import { join as join21, relative as relative4, resolve as resolve5 } from "path";
+import { join as join22, relative as relative4, resolve as resolve5 } from "path";
 
 // src/core/ask-provider.ts
 var PROVIDER_QUESTION = "Where does your organization live?";
@@ -5487,14 +6149,14 @@ async function askProvider(p) {
 }
 
 // src/core/new-workspace.ts
-import { mkdir as mkdir4, readdir as readdir3, rm as rm5, stat as stat3 } from "fs/promises";
-import { dirname as dirname8, join as join19, relative as relative2 } from "path";
+import { mkdir as mkdir4, readdir as readdir4, rm as rm5, stat as stat3 } from "fs/promises";
+import { dirname as dirname8, join as join20, relative as relative2 } from "path";
 
 // src/core/scaffold-git.ts
 import { execFile as execFile5 } from "child_process";
 import { mkdtemp, realpath as realpath2, rm as rm4, writeFile as writeFile3 } from "fs/promises";
 import { tmpdir } from "os";
-import { dirname as dirname7, join as join18, resolve as resolve3 } from "path";
+import { dirname as dirname7, join as join19, resolve as resolve3 } from "path";
 import { promisify as promisify5 } from "util";
 var execFileP5 = promisify5(execFile5);
 var CREATE_SUBJECT = "chore: rness workspace context";
@@ -5582,8 +6244,8 @@ async function findScaffoldBase(rnessDir) {
   };
 }
 async function buildScaffoldCommit(rnessDir, base, files, version) {
-  const scratch = await mkdtemp(join18(tmpdir(), "rness-scaffold-"));
-  const env = { GIT_INDEX_FILE: join18(scratch, "index") };
+  const scratch = await mkdtemp(join19(tmpdir(), "rness-scaffold-"));
+  const env = { GIT_INDEX_FILE: join19(scratch, "index") };
   try {
     await must(
       rnessDir,
@@ -5591,7 +6253,7 @@ async function buildScaffoldCommit(rnessDir, base, files, version) {
       env
     );
     for (const [i, file] of files.entries()) {
-      const tmp = join18(scratch, `blob-${i}`);
+      const tmp = join19(scratch, `blob-${i}`);
       await writeFile3(tmp, file.content, "utf8");
       const blob = await must(rnessDir, [
         "hash-object",
@@ -5691,7 +6353,7 @@ async function withoutRedundantKeeps(rnessDir, files) {
 
 // src/core/new-workspace.ts
 async function isEmptyDir(dir) {
-  return (await readdir3(dir)).length === 0;
+  return (await readdir4(dir)).length === 0;
 }
 async function insideWorkspace(dir) {
   try {
@@ -5706,8 +6368,8 @@ async function targetProblem(cwd, root, pm) {
   if (await insideWorkspace(cwd) || await insideWorkspace(dirname8(root)))
     return "already inside an rness workspace; create runs from outside one";
   if (!await exists(root)) return null;
-  if (await exists(join19(root, ".rness", "rness.json"))) {
-    if (!await exists(join19(root, ".rness", "node_modules")))
+  if (await exists(join20(root, ".rness", "rness.json"))) {
+    if (!await exists(join20(root, ".rness", "node_modules")))
       return `${shown} holds an rness workspace whose dependencies are not installed; cd ${shown}/.rness && ${pm} install, then ${rnessCommand()} sync`;
     return `${shown} already holds an rness workspace (.rness/); run ${rnessCommand()} add inside it to add repositories`;
   }
@@ -5730,7 +6392,7 @@ async function installContext(input) {
 }
 async function buildContext(input) {
   const { ui, root, shown, pm } = input;
-  const rnessDir = join19(root, ".rness");
+  const rnessDir = join20(root, ".rness");
   const pmVersion = await packageManagerVersion(pm);
   await mkdir4(root, { recursive: true });
   try {
@@ -5802,7 +6464,7 @@ async function syncBlocks(ui, root, shown, inPlace, sshWorks) {
 
 // src/commands/create-blank.ts
 import { mkdir as mkdir5 } from "fs/promises";
-import { join as join20, relative as relative3, resolve as resolve4 } from "path";
+import { join as join21, relative as relative3, resolve as resolve4 } from "path";
 var WORKSPACE_NAME = /^(?!\.{1,2}$)[A-Za-z0-9._][A-Za-z0-9._-]*$/;
 function workspaceNameError(name) {
   return `workspace name "${name}" may only contain letters, digits, '.', '_' and '-', not starting with '-'`;
@@ -5875,7 +6537,7 @@ async function createBlank(input) {
       provider: null,
       org: null,
       agents,
-      pulse: null,
+      projects: null,
       repos: {},
       scopes: {}
     },
@@ -5884,8 +6546,8 @@ async function createBlank(input) {
     kind: "blank workspace"
   });
   if (!built) return 1;
-  await mkdir5(join20(root, "org"), { recursive: true });
-  await commitContext({ ui, rnessDir: join20(root, ".rness"), shown });
+  await mkdir5(join21(root, "org"), { recursive: true });
+  await commitContext({ ui, rnessDir: join21(root, ".rness"), shown });
   const code = await syncBlocks(
     ui,
     root,
@@ -6045,7 +6707,7 @@ async function cloneSelection(input) {
           { doing: `cloning  org/${repo}`, git: true },
           () => clone(
             entry.url,
-            join21(input.root, "org", repo),
+            join22(input.root, "org", repo),
             input.provider.credentialsFor(entry.url)
           ),
           () => ["cloned", `org/${repo}`]
@@ -6390,13 +7052,13 @@ async function createCommand(opts, deps = {}) {
       provider: chosenProvider,
       org,
       agents: null,
-      pulse: null,
+      projects: null,
       repos: {},
       scopes: {}
     };
     const staged = async () => {
-      staging ??= await mkdtemp2(join21(tmpdir2(), "rness-join-"));
-      return join21(staging, ".rness");
+      staging ??= await mkdtemp2(join22(tmpdir2(), "rness-join-"));
+      return join22(staging, ".rness");
     };
     if (joining) {
       const stagedDir = await staged();
@@ -6458,7 +7120,7 @@ async function createCommand(opts, deps = {}) {
       });
       if (p.isCancel(ok) || ok !== true) return cancelled(ui);
     }
-    const rnessDir = join21(root, ".rness");
+    const rnessDir = join22(root, ".rness");
     const install = () => installContext({ ui, pm, rnessDir, skip: opts.skipInstall === true });
     if (joining) {
       await mkdir6(root, { recursive: true });
@@ -6471,7 +7133,7 @@ async function createCommand(opts, deps = {}) {
       ui.line("cloned", `${shown}/.rness (joined ${org})`);
       if (opts.pm === void 0) pm = await workspacePackageManager(rnessDir);
       await install();
-      await mkdir6(join21(root, "org"), { recursive: true });
+      await mkdir6(join22(root, "org"), { recursive: true });
       const failures2 = await cloneSelection({
         root,
         rnessDir,
@@ -6524,7 +7186,7 @@ ${next2.map((l) => `  ${l}`).join("\n")}
       kind: "new workspace"
     });
     if (!built) return 1;
-    await mkdir6(join21(root, "org"), { recursive: true });
+    await mkdir6(join22(root, "org"), { recursive: true });
     const failures = await cloneSelection({
       root,
       rnessDir,
@@ -6596,7 +7258,7 @@ ${next2.map((l) => `  ${l}`).join("\n")}
 }
 
 // src/core/blocks.ts
-import { join as join22 } from "path";
+import { join as join23 } from "path";
 var PROBLEM = /* @__PURE__ */ new Set(["stale", "malformed"]);
 async function checkBlocks({
   root,
@@ -6613,7 +7275,7 @@ async function checkBlocks({
     warnings: checks.filter((c) => !PROBLEM.has(c.status) && c.message !== null).map((c) => c.message),
     checks
   });
-  if (!await exists(join22(root, "org"))) return derive();
+  if (!await exists(join23(root, "org"))) return derive();
   const targets = [
     { scope: null, dir: root, depth: 0, file: "AGENTS.md", label: "AGENTS.md" },
     { scope: null, dir: root, depth: 0, file: "CLAUDE.md", label: "CLAUDE.md" }
@@ -6622,7 +7284,7 @@ async function checkBlocks({
     const segments = entry.path.split("/");
     targets.push({
       scope: name,
-      dir: join22(root, ...segments),
+      dir: join23(root, ...segments),
       depth: segments.length,
       file: "AGENTS.md",
       label: `${entry.path}/AGENTS.md`
@@ -6637,7 +7299,7 @@ async function checkBlocks({
       );
       continue;
     }
-    const text = await readOrNull(join22(t.dir, t.file));
+    const text = await readOrNull(join23(t.dir, t.file));
     const lines = text === null ? [] : text.split(/\r?\n/);
     const found = findBlock(lines);
     if (found.kind === "none") {
@@ -6706,9 +7368,9 @@ async function logoutCommand() {
 
 // src/commands/upgrade.ts
 import { execFile as execFile6 } from "child_process";
-import { mkdtemp as mkdtemp3, readFile as readFile9, rm as rm7 } from "fs/promises";
+import { mkdtemp as mkdtemp3, readFile as readFile10, rm as rm7 } from "fs/promises";
 import { tmpdir as tmpdir3 } from "os";
-import { basename as basename5, join as join23, relative as relative5 } from "path";
+import { basename as basename5, join as join24, relative as relative5 } from "path";
 import { promisify as promisify6 } from "util";
 var execFileP6 = promisify6(execFile6);
 var NOTES = "https://github.com/rness-dev/rness/tree/main/packages/cli#readme";
@@ -6728,10 +7390,10 @@ async function latestVersion() {
 async function scaffoldFor(version, rnessDir) {
   if (version === VERSION) return { dir: scaffoldDir() };
   const installed = await readPinnedCli(rnessDir);
-  const inside2 = installed === null ? null : join23(installed.dir, "scaffold");
-  if (installed?.version === version && inside2 !== null && await exists(join23(inside2, "package.json")))
+  const inside2 = installed === null ? null : join24(installed.dir, "scaffold");
+  if (installed?.version === version && inside2 !== null && await exists(join24(inside2, "package.json")))
     return { dir: inside2 };
-  const scratch = await mkdtemp3(join23(tmpdir3(), "rness-pack-"));
+  const scratch = await mkdtemp3(join24(tmpdir3(), "rness-pack-"));
   const cleanup = () => rm7(scratch, { recursive: true, force: true });
   try {
     const { stdout } = await execFileP6(
@@ -6746,8 +7408,8 @@ async function scaffoldFor(version, rnessDir) {
       { timeout: 6e4 }
     );
     const tarball = stdout.trim().split("\n").at(-1) ?? "";
-    await execFileP6("tar", ["-xzf", join23(scratch, tarball), "-C", scratch]);
-    return { dir: join23(scratch, "package", "scaffold"), cleanup };
+    await execFileP6("tar", ["-xzf", join24(scratch, tarball), "-C", scratch]);
+    return { dir: join24(scratch, "package", "scaffold"), cleanup };
   } catch (e) {
     await cleanup();
     throw new Error(
@@ -6759,7 +7421,7 @@ async function scaffoldFor(version, rnessDir) {
 async function declaredManager(rnessDir, pm) {
   try {
     const pkg = JSON.parse(
-      await readFile9(join23(rnessDir, "package.json"), "utf8")
+      await readFile10(join24(rnessDir, "package.json"), "utf8")
     );
     if (typeof pkg.packageManager === "string") return pkg.packageManager;
   } catch {
@@ -6769,7 +7431,7 @@ async function declaredManager(rnessDir, pm) {
 async function clonesToCommit(root, cwd, manifest, files) {
   const clones = [];
   for (const repo of Object.keys(manifest.repos)) {
-    const dir = join23(root, "org", repo);
+    const dir = join24(root, "org", repo);
     if (!await exists(dir)) continue;
     try {
       const paths = await changedPaths(dir, files);
@@ -6787,7 +7449,7 @@ async function filesTheSyncWrites(root, rnessDir, manifest) {
   try {
     const { stdout } = await execFileP6(
       process.execPath,
-      [join23(pinned.dir, pinned.bin), "written-files", "--cwd", root],
+      [join24(pinned.dir, pinned.bin), "written-files", "--cwd", root],
       {
         cwd: root,
         env: { ...process.env, NO_COLOR: "1", RNESS_NO_INSTALL: "1" },
@@ -6983,9 +7645,9 @@ async function upgradeCommand(version, opts, terminal = defaultTerminal, deps =
         await source.cleanup?.();
       }
     }
-    const packageFile = join23(ws.rnessDir, "package.json");
+    const packageFile = join24(ws.rnessDir, "package.json");
     const restore = /* @__PURE__ */ new Map([
-      [packageFile, await readFile9(packageFile, "utf8")]
+      [packageFile, await readFile10(packageFile, "utf8")]
     ]);
     const moved = await readPin(ws.rnessDir);
     if (moved !== null && moved.spec !== target2)
@@ -7179,8 +7841,8 @@ import { realpath as realpath4 } from "fs/promises";
 import { isAbsolute as isAbsolute2, posix as posix8, relative as relative7, resolve as resolve7, sep as sep5 } from "path";
 
 // src/mcp/tools.ts
-import { readFile as readFile10, realpath as realpath3, stat as stat4 } from "fs/promises";
-import { isAbsolute, join as join24, posix as posix7, relative as relative6, resolve as resolve6, sep as sep4 } from "path";
+import { readFile as readFile11, realpath as realpath3, stat as stat4 } from "fs/promises";
+import { isAbsolute, join as join25, posix as posix7, relative as relative6, resolve as resolve6, sep as sep4 } from "path";
 var LABELS = {
   standards: "Standards",
   adr: "Decisions",
@@ -7209,7 +7871,7 @@ async function documents(rnessDir, only) {
   const docs = [];
   for (const collection of COLLECTIONS) {
     if (only !== void 0 && collection !== only) continue;
-    for (const item of await collectMarkdown(join24(rnessDir, collection))) {
+    for (const item of await collectMarkdown(join25(rnessDir, collection))) {
       const path = `${collection}/${item.rel}`;
       if (path === TEMPLATE2) continue;
       const status2 = item.fields?.["status"];
@@ -7331,7 +7993,7 @@ async function read(cwd, args) {
     return refuse(
       `${path}: ${info.size} bytes, over the 256 KiB rness_read returns`
     );
-  return { text: await readFile10(real, "utf8") };
+  return { text: await readFile11(real, "utf8") };
 }
 async function search(cwd, args) {
   const { ws } = await workspaceAt(cwd);
@@ -7439,8 +8101,8 @@ function mcpTools(cwd) {
 
 // src/pulse/detached.ts
 import { spawn as nodeSpawn } from "child_process";
-import { mkdir as mkdir7, open as open2, readFile as readFile11, rm as rm8, stat as stat5, writeFile as writeFile4 } from "fs/promises";
-import { join as join25 } from "path";
+import { mkdir as mkdir7, open as open2, readFile as readFile12, rm as rm8, stat as stat5, writeFile as writeFile4 } from "fs/promises";
+import { join as join26 } from "path";
 import { setTimeout as delay2 } from "timers/promises";
 var detached = (args, cwd) => {
   const bin = process.argv[1];
@@ -7454,7 +8116,7 @@ var detached = (args, cwd) => {
   child.on("error", () => void 0);
   child.unref();
 };
-var failureFile = () => join25(configDir(), "pulse.json");
+var failureFile = () => join26(configDir(), "pulse.json");
 async function recordFailure(reason3) {
   try {
     await mkdir7(configDir(), { recursive: true, mode: 448 });
@@ -7468,7 +8130,7 @@ async function recordFailure(reason3) {
 }
 async function takeFailure() {
   try {
-    const data = JSON.parse(await readFile11(failureFile(), "utf8"));
+    const data = JSON.parse(await readFile12(failureFile(), "utf8"));
     await rm8(failureFile(), { force: true });
     const reason3 = data !== null && typeof data === "object" ? data["reason"] : void 0;
     return typeof reason3 === "string" && reason3 !== "" ? reason3 : null;
@@ -7479,7 +8141,7 @@ async function takeFailure() {
 var PULSE_LOCK_STALE_MS = 15 * 6e4;
 async function oneSyncAtATime(key, work, options = {}) {
   await mkdir7(configDir(), { recursive: true, mode: 448 });
-  const file = join25(configDir(), `pulse-${key}.lock`);
+  const file = join26(configDir(), `pulse-${key}.lock`);
   for (; ; ) {
     try {
       const handle = await open2(file, "wx");
@@ -7565,7 +8227,7 @@ function sessionOf(input) {
 }
 async function hasPulse(ws) {
   try {
-    return (await loadManifest(ws.rnessDir)).pulse !== null;
+    return (await loadManifest(ws.rnessDir)).projects !== null;
   } catch {
     return false;
   }
@@ -7875,12 +8537,12 @@ async function mcpCommand(opts, io = {
 }
 
 // src/commands/pulse.ts
-import { readFile as readFile13, readdir as readdir4 } from "fs/promises";
-import { join as join26 } from "path";
+import { readFile as readFile14, readdir as readdir5 } from "fs/promises";
+import { join as join27 } from "path";
 import { setTimeout as delay3 } from "timers/promises";
 
 // src/pulse/opened.ts
-import { mkdir as mkdir8, readFile as readFile12, rename as rename3, rm as rm9, writeFile as writeFile5 } from "fs/promises";
+import { mkdir as mkdir8, readFile as readFile13, rename as rename3, rm as rm9, writeFile as writeFile5 } from "fs/promises";
 import { dirname as dirname9 } from "path";
 var NAME2 = "rness/opened";
 function openedFile(rnessDir) {
@@ -7892,7 +8554,7 @@ async function readOpened(file) {
   if (file === null) return opened;
   let data;
   try {
-    data = JSON.parse(await readFile12(file, "utf8"));
+    data = JSON.parse(await readFile13(file, "utf8"));
   } catch {
     return opened;
   }
@@ -7959,16 +8621,75 @@ async function missingAccess(provider) {
   const scopes = await fromGithub(provider.scopes());
   return scopes?.includes(PROJECT_SCOPE) === true ? null : NEEDS_SCOPE;
 }
-async function declaredBoard(c) {
-  if (c.manifest.pulse === null)
+async function declaredBoards(c) {
+  const projects = c.manifest.projects;
+  if (projects === null)
     throw new Error("no pulse declared \u2014 rness pulse create");
   const missing = await missingAccess(c.provider);
   if (missing !== null) throw new Error(missing);
-  const number = c.manifest.pulse.project;
-  const board = await fromGithub(c.provider.board(c.org, number));
-  if (board === null)
-    throw new Error(`GitHub has no project ${number} in ${c.org}`);
-  return board;
+  const names = Object.keys(projects).sort(
+    (a, b) => Number(a === PULSE) - Number(b === PULSE)
+  );
+  const declared2 = [];
+  for (const name of names) {
+    const number = projects[name];
+    const board = await fromGithub(c.provider.board(c.org, number));
+    if (board === null)
+      throw new Error(`GitHub has no project ${number} in ${c.org}`);
+    declared2.push({ name, board });
+  }
+  return declared2;
+}
+var labelOf = (name) => `${name.charAt(0).toUpperCase()}${name.slice(1)}`;
+async function directoriesOf(dir) {
+  try {
+    return (await readdir5(dir, { withFileTypes: true })).filter(
+      (e) => e.isDirectory() && !e.name.startsWith(".") && e.name !== "updates"
+    ).map((e) => e.name).sort();
+  } catch {
+    return [];
+  }
+}
+async function scopeOf(c, name, tabs, owners) {
+  const within = (collection) => (path) => path.startsWith(`${collection}/`);
+  if (name === PULSE) {
+    const shown = tabs.filter((t) => !owners.includes(t.name));
+    const elsewhere = (path) => owners.some((o) => within(o)(path));
+    return {
+      label: "Agent Pulse",
+      want: desiredOf(shown, c.org),
+      layout: layoutOf(shown),
+      elsewhere,
+      mine: (path) => !elsewhere(path),
+      own: null
+    };
+  }
+  const tab = tabs.find((t) => t.name === name) ?? {
+    name,
+    label: labelOf(name),
+    rows: []
+  };
+  const dir = join27(c.rnessDir, name);
+  const shape = await readShape(c.rnessDir, name);
+  const fronts = new Map(
+    (await collectMarkdown(dir)).map((item) => [
+      `${name}/${item.rel}`,
+      item.fields ?? {}
+    ])
+  );
+  const want = desiredOf([tab], c.org, {
+    shape,
+    fronts,
+    directories: await directoriesOf(dir)
+  });
+  return {
+    label: tab.label,
+    want,
+    layout: layoutOf([tab], { shape, want }),
+    elsewhere: () => false,
+    mine: within(name),
+    own: { shape, updates: await readUpdates(c.rnessDir, name) }
+  };
 }
 var plural = (n) => `${n} item${n === 1 ? "" : "s"}`;
 var eachAdded = (ui, added) => {
@@ -7976,7 +8697,7 @@ var eachAdded = (ui, added) => {
     if (a.startsWith("renamed ")) ui.line("renamed", a.slice("renamed ".length));
     else ui.line("added", a);
 };
-var createdByKind = (ui, added) => {
+var createdByKind = (ui, added, project) => {
   for (const kind of ["field", "option", "view"]) {
     const names = added.filter((a) => a.startsWith(`${kind} `)).map((a) => a.slice(kind.length + 1));
     if (names.length > 0) ui.line("created", `${kind}s ${names.join(", ")}`);
@@ -7984,14 +8705,18 @@ var createdByKind = (ui, added) => {
   for (const a of added) {
     if (a.startsWith("label ")) ui.line("created", a);
     else if (a.startsWith("link "))
-      ui.line("linked", `Agent Pulse to ${a.slice("link ".length)}`);
+      ui.line("linked", `${project} to ${a.slice("link ".length)}`);
   }
 };
+async function working(ui, doing, count3, work) {
+  if (count3 === 0) return work();
+  await ui.step({ doing, quiet: true }, work, () => null);
+}
 async function filesOf2(rnessDir) {
   const files = /* @__PURE__ */ new Set();
   const walk = async (rel) => {
-    const dir = rel === "" ? rnessDir : join26(rnessDir, ...rel.split("/"));
-    for (const e of await readdir4(dir, { withFileTypes: true })) {
+    const dir = rel === "" ? rnessDir : join27(rnessDir, ...rel.split("/"));
+    for (const e of await readdir5(dir, { withFileTypes: true })) {
       const path = rel === "" ? e.name : `${rel}/${e.name}`;
       if (e.isDirectory()) {
         if (e.name !== ".git" && e.name !== "node_modules") await walk(path);
@@ -8002,7 +8727,7 @@ async function filesOf2(rnessDir) {
   return files;
 }
 var count2 = (n, word) => `${n} ${word}${n === 1 ? "" : "s"}`;
-function sayDone(ui, org, documents2, steps, writes, adopted) {
+function sayDone(ui, org, documents2, steps, writes, adopted, on) {
   const n = (kind) => steps.filter((s) => s.kind === kind).length - (kind === "create" ? adopted : 0);
   const reopened = steps.filter((s) => s.kind === "update" && s.reopen).length;
   if (n("create") > 0) ui.line("created", count2(n("create"), "issue"));
@@ -8017,6 +8742,8 @@ function sayDone(ui, org, documents2, steps, writes, adopted) {
       `${count2(n("convert"), "draft")} into issues of ${org}/.rness`
     );
   if (reopened > 0) ui.line("reopened", count2(reopened, "issue"));
+  if (n("remove") > 0)
+    ui.line("moved", `${plural(n("remove"))} to their collection's project`);
   const written = new Set(writes.map((w) => w.id));
   const bodyOnly = steps.filter(
     (s) => s.kind === "unchanged" && written.has(s.id)
@@ -8034,25 +8761,27 @@ function sayDone(ui, org, documents2, steps, writes, adopted) {
   ].filter(([, k]) => k > 0).map(([word, k]) => `${k} ${word}`);
   ui.line(
     "synced",
-    `${plural(documents2)}${parts.length > 0 ? `: ${parts.join(", ")}` : ""}`
+    `${plural(documents2)}${on === void 0 ? "" : ` on ${on}`}${parts.length > 0 ? `: ${parts.join(", ")}` : ""}`
   );
 }
-async function syncBoard(c, board, ui, sayLayout) {
+async function syncBoard(c, board, ui, sayLayout, scope) {
   await fromGithub(c.provider.checkIssues(c.org));
-  const tabs = await statusTabs(c.rnessDir);
-  const want = desiredOf(tabs, c.org);
+  const { want } = scope;
   sayLayout(
     ui,
-    await fromGithub(c.provider.ensureLayout(board, layoutOf(tabs)))
+    await fromGithub(c.provider.ensureLayout(board, scope.layout)),
+    scope.label
   );
   const have = await fromGithub(c.provider.items(board));
   const record = await openedFile(c.rnessDir);
-  const opened = await readOpened(record);
+  const all = await readOpened(record);
+  const opened = new Map([...all].filter(([, path]) => scope.mine(path)));
+  const others = [...all].filter(([, path]) => !scope.mine(path));
   const seen = await seenPaths(c.rnessDir, [
     ...unwantedPaths(want, have),
     ...opened.values()
   ]);
-  const steps = planSync(want, have, seen, opened);
+  const steps = planSync(want, have, seen, opened, scope.elsewhere);
   const changes = steps.filter((s) => s.kind !== "unchanged").length;
   let writes = [];
   let made = 0;
@@ -8062,21 +8791,31 @@ async function syncBoard(c, board, ui, sayLayout) {
     const created = /* @__PURE__ */ new Map();
     const closed = /* @__PURE__ */ new Set();
     try {
-      for (const step2 of steps) {
-        const p = await fromGithub(c.provider.apply(board, step2));
-        if (p !== null && (step2.kind === "create" || step2.kind === "convert"))
-          placed.set(step2.want.path, p);
-        if (p?.adopted === true) adopted++;
-        else if (p !== null && step2.kind === "create")
-          created.set(step2.want.path, p);
-        if (step2.kind === "close" || step2.kind === "archive")
-          closed.add(step2.id);
-        if (step2.kind !== "unchanged") made++;
-      }
+      await working(
+        ui,
+        `writing  ${plural(changes)} on ${scope.label}`,
+        changes,
+        async () => {
+          for (const step2 of steps) {
+            const p = await fromGithub(c.provider.apply(board, step2));
+            if (p !== null && (step2.kind === "create" || step2.kind === "convert"))
+              placed.set(step2.want.path, p);
+            if (p?.adopted === true) adopted++;
+            else if (p !== null && step2.kind === "create")
+              created.set(step2.want.path, p);
+            if (step2.kind === "close" || step2.kind === "archive")
+              closed.add(step2.id);
+            if (step2.kind !== "unchanged") made++;
+          }
+        }
+      );
     } finally {
       await writeOpened(
         record,
-        stillOpened(opened, have, seen, closed, created)
+        new Map([
+          ...others,
+          ...stillOpened(opened, have, seen, closed, created)
+        ])
       );
     }
     const issued = issuedAfter(steps, have, placed);
@@ -8088,17 +8827,24 @@ async function syncBoard(c, board, ui, sayLayout) {
         w.path,
         issueBody({
           path: w.path,
-          text: await readFile13(join26(c.rnessDir, ...w.path.split("/")), "utf8"),
+          text: await readFile14(join27(c.rnessDir, ...w.path.split("/")), "utf8"),
           org: c.org,
           numbers,
           files
         })
       );
     writes = planBodies(bodies, issued);
-    for (const step2 of writes) {
-      await fromGithub(c.provider.apply(board, step2));
-      made++;
-    }
+    await working(
+      ui,
+      `writing  ${plural(writes.length)} bodies on ${scope.label}`,
+      writes.length,
+      async () => {
+        for (const step2 of writes) {
+          await fromGithub(c.provider.apply(board, step2));
+          made++;
+        }
+      }
+    );
   } catch (e) {
     if (!(e instanceof RateLimitError)) throw e;
     const total = changes + writes.length;
@@ -8107,7 +8853,43 @@ async function syncBoard(c, board, ui, sayLayout) {
       { cause: e }
     );
   }
-  sayDone(ui, c.org, want.length, steps, writes, adopted);
+  sayDone(
+    ui,
+    c.org,
+    want.length,
+    steps,
+    writes,
+    adopted,
+    scope.own === null ? void 0 : scope.label
+  );
+  if (scope.own !== null) {
+    const { shape, updates } = scope.own;
+    for (const what of await fromGithub(
+      c.provider.describe(board, {
+        readme: shape.readme,
+        description: shape.description
+      })
+    ))
+      ui.line("wrote", `${what} of ${scope.label}`);
+    for (const line3 of await fromGithub(
+      c.provider.postUpdates(board, updates)
+    )) {
+      const [verb, ...rest] = line3.split(" ");
+      ui.line(verb ?? "posted", rest.join(" "));
+    }
+  }
+}
+async function syncAll(c, declared2, ui, sayLayout) {
+  const tabs = await statusTabs(c.rnessDir);
+  const owners = declared2.map((d) => d.name).filter((n) => n !== PULSE);
+  for (const { name, board } of declared2)
+    await syncBoard(
+      c,
+      board,
+      ui,
+      sayLayout(name),
+      await scopeOf(c, name, tabs, owners)
+    );
 }
 async function pulseCreateCommand(opts, deps = {}) {
   try {
@@ -8115,9 +8897,20 @@ async function pulseCreateCommand(opts, deps = {}) {
     const ui = deps.ui ?? await makeUi(terminal);
     const wait = waitSaid(opts, ui);
     let c = await context2(opts, wait);
-    if (c.manifest.pulse !== null)
+    const name = opts.collection ?? PULSE;
+    const declared2 = c.manifest.projects?.[name];
+    if (opts.collection === PULSE)
+      throw new Error('"pulse" names Agent Pulse: rness pulse create');
+    if (declared2 !== void 0)
+      throw new Error(
+        `already declared: ${boardUrl(c.org, declared2)} \u2014 rness pulse sync`
+      );
+    const tab = opts.collection === void 0 ? null : (await statusTabs(c.rnessDir)).find(
+      (t) => t.name === opts.collection
+    ) ?? null;
+    if (opts.collection !== void 0 && tab === null)
       throw new Error(
-        `already declared: ${boardUrl(c.org, c.manifest.pulse.project)} \u2014 rness pulse sync`
+        `${opts.collection} is no collection of .rness: none of its documents carries a status`
       );
     const detected = providerOf(c.manifest);
     if (!PROVIDERS[detected].available)
@@ -8155,19 +8948,26 @@ async function pulseCreateCommand(opts, deps = {}) {
       "checked",
       `${detected}, logged in as ${login}, scope ${PROJECT_SCOPE}`
     );
-    const board = await fromGithub(c.provider.createBoard(c.org));
-    await writeManifest(c.rnessDir, {
+    const board = await fromGithub(c.provider.createBoard(c.org, tab?.label));
+    const manifest = {
       ...c.manifest,
       provider: detected,
-      pulse: { project: board.number }
-    });
-    ui.line("created", `Agent Pulse \u2014 ${board.url}`);
+      projects: { ...c.manifest.projects, [name]: board.number }
+    };
+    await writeManifest(c.rnessDir, manifest);
+    c = { ...c, manifest };
+    ui.line("created", `${tab?.label ?? "Agent Pulse"} \u2014 ${board.url}`);
     try {
-      await syncBoard(c, board, ui, createdByKind);
+      await syncAll(
+        c,
+        await declaredBoards(c),
+        ui,
+        (n) => n === name ? createdByKind : eachAdded
+      );
     } finally {
       ui.line(
         "declared",
-        'pulse in .rness/rness.json \u2014 commit it: git -C .rness commit -am "chore: rness pulse"'
+        `${name} in .rness/rness.json \u2014 commit it: git -C .rness commit -am "chore: rness pulse${opts.collection === void 0 ? "" : ` ${opts.collection}`}"`
       );
     }
     return 0;
@@ -8179,7 +8979,7 @@ async function pulseSyncCommand(opts, deps = {}) {
   try {
     const ui = deps.ui ?? await makeUi(deps.terminal ?? defaultTerminal);
     const c = await context2(opts, waitSaid(opts, ui));
-    await syncBoard(c, await declaredBoard(c), ui, eachAdded);
+    await syncAll(c, await declaredBoards(c), ui, () => eachAdded);
     return 0;
   } catch (e) {
     return reportError(e);
@@ -8195,43 +8995,47 @@ async function pulseMarkCommand(opts) {
 }
 async function mark(opts) {
   const c = await context2(opts);
-  const board = await declaredBoard(c);
-  const key = `${c.org}-${board.number}`;
+  const declared2 = await declaredBoards(c);
+  const key = `${c.org}-${declared2.map((d) => d.board.number).join("-")}`;
   const lock = opts.sleep === void 0 ? {} : { sleep: opts.sleep };
-  const listed = () => fromGithub(c.provider.items(board, { bodies: false }));
-  let items = await listed();
+  const syncEvery = () => syncAll(c, declared2, plainUi, () => eachAdded);
+  const listed = (board) => fromGithub(c.provider.items(board, { bodies: false }));
   if (opts.end === true) {
     const id = opts.session.split(" \xB7 ").pop() ?? opts.session;
-    const ids2 = items.filter(
-      (i) => i.session === opts.session || i.session?.endsWith(` \xB7 ${id}`)
-    ).map((i) => i.id);
-    await fromGithub(c.provider.mark(board, ids2, null));
-    await oneSyncAtATime(key, () => syncBoard(c, board, plainUi, eachAdded), {
-      ...lock,
-      wait: true
-    });
+    for (const { board } of declared2) {
+      const ids = (await listed(board)).filter(
+        (i) => i.session === opts.session || i.session?.endsWith(` \xB7 ${id}`)
+      ).map((i) => i.id);
+      await fromGithub(c.provider.mark(board, ids, null));
+    }
+    await oneSyncAtATime(key, syncEvery, { ...lock, wait: true });
     return 0;
   }
-  const wanted = new Set(opts.paths);
+  const held = (path) => declared2.some((d) => d.name === PULSE || path.startsWith(`${d.name}/`));
+  const wanted = new Set(opts.paths.filter(held));
   const documents2 = new Map(
     (await statusTabs(c.rnessDir)).flatMap(
       (t) => t.rows.map((r) => [r.path, r.status])
     )
   );
+  let items = /* @__PURE__ */ new Map();
+  const listAll = async () => {
+    items = /* @__PURE__ */ new Map();
+    for (const { name, board } of declared2) items.set(name, await listed(board));
+  };
+  await listAll();
   const onBoard = new Map(
-    items.flatMap((i) => i.path === null ? [] : [[i.path, i.status]])
+    [...items.values()].flat().flatMap((i) => i.path === null ? [] : [[i.path, i.status]])
   );
   const stale = (path) => documents2.has(path) && (!onBoard.has(path) || onBoard.get(path) !== documents2.get(path));
   if ([...wanted].some(stale)) {
-    const synced = await oneSyncAtATime(
-      key,
-      () => syncBoard(c, board, plainUi, eachAdded),
-      lock
-    );
-    if (synced) items = await listed();
+    if (await oneSyncAtATime(key, syncEvery, lock)) await listAll();
+  }
+  for (const { name, board } of declared2) {
+    const ids = (items.get(name) ?? []).filter((i) => i.path !== null && wanted.has(i.path)).map((i) => i.id);
+    if (ids.length > 0)
+      await fromGithub(c.provider.mark(board, ids, opts.session));
   }
-  const ids = items.filter((i) => i.path !== null && wanted.has(i.path)).map((i) => i.id);
-  await fromGithub(c.provider.mark(board, ids, opts.session));
   return 0;
 }
 
@@ -8533,10 +9337,19 @@ function buildProgram(state) {
     state.code = await syncCommand(opts);
   });
   const pulse = program.command("pulse").description("Show the agent's work on the organization's board");
-  pulse.command("create").description("Create the organization's Agent Pulse board and sync it").option("-y, --yes", "do not ask for confirmation").addOption(new Option("--github-api <base>").hideHelp()).addOption(new Option("--cwd <dir>").hideHelp()).action(async (opts) => {
-    state.code = await pulseCreateCommand(opts);
+  pulse.command("create").description(
+    "Create the organization's Agent Pulse board, or a collection's own project, and sync"
+  ).argument(
+    "[collection]",
+    "a directory of .rness/ whose documents get a project of their own"
+  ).option("-y, --yes", "do not ask for confirmation").addOption(new Option("--github-api <base>").hideHelp()).addOption(new Option("--cwd <dir>").hideHelp()).action(async (collection, opts) => {
+    state.code = await pulseCreateCommand(
+      collection === void 0 ? opts : { ...opts, collection }
+    );
   });
-  pulse.command("sync").description("Bring the board up to date with the documents of .rness/").addOption(new Option("--github-api <base>").hideHelp()).addOption(new Option("--cwd <dir>").hideHelp()).action(async (opts) => {
+  pulse.command("sync").description(
+    "Bring every declared project up to date with the documents of .rness/"
+  ).addOption(new Option("--github-api <base>").hideHelp()).addOption(new Option("--cwd <dir>").hideHelp()).action(async (opts) => {
     state.code = await pulseSyncCommand(opts);
   });
   pulse.command("mark", { hidden: true }).requiredOption("--session <id>").option(
@@ -8766,4 +9579,4 @@ export {
   OWN_COMMANDS,
   catchUp
 };
-//# sourceMappingURL=chunk-ABCO6D6B.js.map
+//# sourceMappingURL=chunk-GAZDKEOH.js.map