@rness/cli 0.12.0 → 0.14.0

package/dist/{chunk-AEW7ZDFS.js → chunk-AXTFDXN2.js}

@@ -139,6 +139,36 @@ async function changedPaths(dir, paths) {
   }
   return changed;
 }
+async function seenPaths(dir, paths) {
+  const seen = /* @__PURE__ */ new Set();
+  for (const path of new Set(paths)) {
+    try {
+      const commit = await git(
+        [
+          "log",
+          "-1",
+          "--full-history",
+          "--format=%H",
+          "HEAD",
+          "--",
+          `:(literal)${path}`
+        ],
+        dir
+      );
+      if (commit.trim() !== "") seen.add(path);
+    } catch {
+    }
+  }
+  return seen;
+}
+async function gitPath(dir, name) {
+  try {
+    const path = (await git(["rev-parse", "--git-path", name], dir)).trim();
+    return path === "" ? null : resolve(dir, path);
+  } catch {
+    return null;
+  }
+}
 async function pullFastForward(dir, credentials) {
   await git(["pull", "--ff-only", "--quiet"], dir, credentials);
 }
@@ -360,9 +390,9 @@ function readScopes(value) {
     scopes[name] = { path, extends: ext };
   }
   for (const [name, entry] of Object.entries(scopes)) {
-    for (const target of entry.extends) {
-      if (!Object.hasOwn(scopes, target))
-        fail(`scope "${name}" extends unknown scope "${target}"`);
+    for (const target2 of entry.extends) {
+      if (!Object.hasOwn(scopes, target2))
+        fail(`scope "${name}" extends unknown scope "${target2}"`);
     }
   }
   return scopes;
@@ -456,7 +486,7 @@ function parseRepoSpec(spec, org, host) {
 }
 
 // src/version.ts
-var VERSION = "0.12.0";
+var VERSION = "0.14.0";
 
 // src/core/pm.ts
 import { execFile as execFile2 } from "child_process";
@@ -493,6 +523,12 @@ function rnessRunner(pm, version) {
     return "yarn dlx @rness/cli";
   return "npx @rness/cli";
 }
+function localRunner(pm) {
+  if (pm === "pnpm") return "pnpm";
+  if (pm === "yarn") return "yarn";
+  if (pm === "bun") return "bunx";
+  return "npx";
+}
 function rnessCommand(env = process.env) {
   const agent = env["npm_config_user_agent"] ?? "";
   if (agent === "") return "rness";
@@ -599,8 +635,8 @@ async function collectMarkdown(dir) {
 }
 
 // src/core/scope.ts
-function isPrefix(prefix, target) {
-  return prefix === target || target.startsWith(`${prefix}/`);
+function isPrefix(prefix, target2) {
+  return prefix === target2 || target2.startsWith(`${prefix}/`);
 }
 function resolveScope(manifest, relDir) {
   let best = null;
@@ -624,7 +660,7 @@ function scopeChain(manifest, scope) {
     chain.push(name);
     stack.add(name);
     const entry = Object.hasOwn(manifest.scopes, name) ? manifest.scopes[name] : void 0;
-    for (const target of entry?.extends ?? []) visit(target, stack);
+    for (const target2 of entry?.extends ?? []) visit(target2, stack);
     stack.delete(name);
   };
   visit(scope, /* @__PURE__ */ new Set());
@@ -1116,6 +1152,158 @@ function statusMarkdown(workspace, tabs) {
   return out.join("\n");
 }
 
+// src/pulse/body.ts
+import { createHash } from "crypto";
+import { posix as posix4 } from "path";
+var BODY_LIMIT = 65536;
+var blobUrl = (org, path) => `https://github.com/${org}/.rness/blob/main/${encodeURI(path)}`;
+var issueUrl = (org, number) => `https://github.com/${org}/.rness/issues/${number}`;
+function headerOf(path, org) {
+  return `\`${path}\` \xB7 [on GitHub](${blobUrl(org, path)})`;
+}
+var digest = (text) => createHash("sha256").update(text, "utf8").digest("hex").slice(0, 12);
+var comment = (d) => `<!-- rness ${d} -->`;
+var TAIL = `
+
+${comment("0".repeat(12))}`.length;
+var LAST_LINE = /\n\n<!-- rness ([0-9a-f]{12}) -->\s*$/;
+function digestOf(body) {
+  const text = body.replace(/\r\n?/g, "\n");
+  const m = LAST_LINE.exec(text);
+  const d = m?.[1];
+  if (m === null || d === void 0) return null;
+  return digest(text.slice(0, m.index)) === d ? d : null;
+}
+var OPENER = /^[ \t]*(`{3,}|~{3,})(.*)$/;
+var CLOSER = /^[ \t]*(`{3,}|~{3,})[ \t]*$/;
+function fenced(lines) {
+  const code = [];
+  let run3 = null;
+  for (const line3 of lines) {
+    if (run3 === null) {
+      const m = OPENER.exec(line3);
+      const fence2 = m?.[1];
+      if (fence2 !== void 0 && !(fence2.startsWith("`") && (m?.[2] ?? "").includes("`")))
+        run3 = fence2;
+      code.push(run3 !== null);
+      continue;
+    }
+    code.push(true);
+    const fence = CLOSER.exec(line3)?.[1];
+    if (fence !== void 0 && fence[0] === run3[0] && fence.length >= run3.length)
+      run3 = null;
+  }
+  return code;
+}
+var TITLE = /^ {0,3}#(?:[ \t]|$)/;
+function withoutTitle(lines) {
+  const code = fenced(lines);
+  const at = lines.findIndex((line3, i) => code[i] !== true && TITLE.test(line3));
+  if (at < 0) return [...lines];
+  let end = at + 1;
+  while (end < lines.length && (lines[end] ?? "").trim() === "") end++;
+  return [...lines.slice(0, at), ...lines.slice(end)];
+}
+var SCHEME = /^[a-zA-Z][a-zA-Z0-9+.-]*:/;
+var IMAGE = /\.(?:png|jpe?g|gif|svg|webp|avif)$/i;
+var decoded = (path) => {
+  try {
+    return decodeURI(path);
+  } catch {
+    return path;
+  }
+};
+function target(dest, s) {
+  const raw = dest.startsWith("<") ? dest.slice(1, -1) : dest;
+  if (raw === "" || SCHEME.test(raw) || raw.startsWith("//") || raw.startsWith("#"))
+    return dest;
+  const hash = raw.indexOf("#");
+  const pathPart = hash < 0 ? raw : raw.slice(0, hash);
+  const anchor = hash < 0 ? "" : raw.slice(hash);
+  const file = decoded(
+    posix4.normalize(
+      pathPart.startsWith("/") ? pathPart.slice(1) : posix4.join(posix4.dirname(s.path), pathPart)
+    )
+  );
+  const number = s.numbers.get(file);
+  if (number !== void 0) return issueUrl(s.org, number);
+  if (!s.files.has(file)) return dest;
+  return `${blobUrl(s.org, file)}${IMAGE.test(file) ? "?raw=true" : ""}${anchor}`;
+}
+var PROTECTED = new RegExp(
+  [
+    /(?<!`)(`+)(?!`)[\s\S]*?(?<!`)\1(?!`)/.source,
+    /<!--[\s\S]*?-->/.source,
+    /<[a-zA-Z][a-zA-Z0-9+.-]*:[^\s<>]*>/.source,
+    /^ {0,3}\[(?:[^\]\\\n]|\\.)+\]:[ \t]*(?<def><[^>\n]*>|\S+)/.source,
+    /\]\([ \t]*(?<dest><[^>\n]*>|[^\s()]+)/.source,
+    /\b(?:https?:\/\/|www\.)[^\s<>]*[^\s<>.,:;"')\]]/.source
+  ].join("|"),
+  "gm"
+);
+var MENTION = /(^|[^A-Za-z0-9`\\])@([A-Za-z0-9][A-Za-z0-9-]*)/g;
+var REFERENCE = /(^|[^A-Za-z0-9&#/])#(\d+)(?![A-Za-z0-9])/g;
+var ZWSP = "\u200B";
+var neutral = (text) => text.replace(MENTION, "$1\\@$2").replace(REFERENCE, `$1#${ZWSP}$2`);
+function inline(text, s) {
+  let out = "";
+  let from = 0;
+  for (const m of text.matchAll(PROTECTED)) {
+    const at = m.index ?? 0;
+    out += neutral(text.slice(from, at));
+    const dest = m.groups?.["dest"] ?? m.groups?.["def"];
+    out += dest === void 0 ? m[0] : `${m[0].slice(0, m[0].length - dest.length)}${target(dest, s)}`;
+    from = at + m[0].length;
+  }
+  return out + neutral(text.slice(from));
+}
+function rewrite(lines, s) {
+  const code = fenced(lines);
+  const out = [];
+  let paragraph = [];
+  const flush = () => {
+    if (paragraph.length > 0) out.push(inline(paragraph.join("\n"), s));
+    paragraph = [];
+  };
+  lines.forEach((line3, i) => {
+    if (code[i] === true || line3.trim() === "") {
+      flush();
+      out.push(line3);
+    } else paragraph.push(line3);
+  });
+  flush();
+  return out;
+}
+function cut(text, rest) {
+  const room = BODY_LIMIT - TAIL - 2 - rest.length;
+  const lines = text.split("\n");
+  const code = fenced(lines);
+  let length = -1;
+  let at = 1;
+  for (let k = 1; k < lines.length; k++) {
+    length += 1 + (lines[k - 1] ?? "").length;
+    if (length > room) break;
+    if (code[k] !== true && (lines[k] ?? "").trim() === "") at = k;
+  }
+  return `${lines.slice(0, at).join("\n").trimEnd()}
+
+${rest}`;
+}
+function issueBody(s) {
+  const lines = withoutTitle(
+    stripFrontMatter(s.text.replace(/\r\n?/g, "\n")).split("\n")
+  );
+  const content = rewrite(lines, s).join("\n").replace(/^(?:[ \t]*\n)+/, "").trimEnd();
+  const header2 = headerOf(s.path, s.org);
+  const whole = content === "" ? header2 : `${header2}
+
+${content}`;
+  const text = whole.length + TAIL <= BODY_LIMIT ? whole : cut(whole, `The rest: ${blobUrl(s.org, s.path)}`);
+  return `${text}
+
+${comment(digest(text))}`;
+}
+
 // src/pulse/layout.ts
 var statusOf2 = (status2) => status2 === null || status2 === "?" ? null : status2;
 var LIFECYCLE = [
@@ -1142,8 +1330,8 @@ var STATUS_COLORS = {
   Accepted: "green",
   Implemented: "green",
   Completed: "green",
-  Rejected: "gray",
-  Superseded: "gray",
+  Rejected: "red",
+  Superseded: "yellow",
   Abandoned: "gray"
 };
 var COLLECTION_COLORS = {
@@ -1208,9 +1396,7 @@ function desiredOf(tabs, org) {
     (tab) => tab.rows.map((row) => ({
       path: row.path,
       title: `${row.id} \u2014 ${row.title}`,
-      body: `${row.path}
-
-https://github.com/${org}/.rness/blob/main/${row.path}`,
+      body: headerOf(row.path, org),
       status: statusOf2(row.status),
       type: tab.label,
       statusField: fields2.get(tab.label)?.name ?? null
@@ -1219,6 +1405,7 @@ https://github.com/${org}/.rness/blob/main/${row.path}`,
 }
 
 // src/core/github.ts
+import { setTimeout as delay } from "timers/promises";
 var DEFAULT_GITHUB_API = "https://api.github.com";
 var MAX_PAGES = 50;
 var PER_PAGE = 100;
@@ -1353,6 +1540,39 @@ async function listRepositories(owner, options) {
     truncated: true
   };
 }
+var WAIT_BUDGET_MS = 6e5;
+var DEFAULT_WAIT_MS = 6e4;
+var MIN_WAIT_MS = 1e3;
+var RATE_LIMIT_OUTLASTED = "GitHub's rate limit outlasted the 10 minutes rness waits";
+function rateWait(sleep = (ms) => delay(ms)) {
+  return { left: WAIT_BUDGET_MS, now: () => Date.now(), sleep };
+}
+var PROCESS_WAIT = rateWait();
+var RateLimitError = class extends Error {
+};
+var messageOf = (body) => {
+  const m = body !== null && typeof body === "object" ? body["message"] : void 0;
+  return typeof m === "string" ? m : "";
+};
+function rateDelay(page, now, limited = false) {
+  const h = page.headers;
+  const spent = h.get("x-ratelimit-remaining") === "0";
+  const hit = limited || page.status === 429 || page.status === 403 && (h.has("retry-after") || spent || /rate limit/i.test(messageOf(page.body)));
+  if (!hit) return null;
+  const after = (h.get("retry-after") ?? "").trim();
+  if (/^\d+$/.test(after)) return Number(after) * 1e3;
+  const reset = (h.get("x-ratelimit-reset") ?? "").trim();
+  if (spent && /^\d+$/.test(reset))
+    return Math.max(0, Number(reset) * 1e3 - now);
+  return DEFAULT_WAIT_MS;
+}
+async function waitOut(options, ms) {
+  const wait = options.wait ?? PROCESS_WAIT;
+  const spent = Math.max(ms, MIN_WAIT_MS);
+  if (spent > wait.left) throw new RateLimitError(RATE_LIMIT_OUTLASTED);
+  wait.left -= spent;
+  await wait.sleep(spent);
+}
 function apiHeaders(token) {
   return {
     Accept: "application/vnd.github+json",
@@ -1375,23 +1595,34 @@ async function getJson(path, options) {
   const body = await res.json().catch(() => void 0);
   return { status: res.status, body };
 }
-async function postJson(path, payload, options, explain = false) {
+async function postJson(path, payload, options, explain = false, limited = () => false) {
   const base = (options.apiBase ?? DEFAULT_GITHUB_API).replace(/\/+$/, "");
-  const page = await getPage(
-    `${base}${path}`,
-    { ...apiHeaders(options.token), "Content-Type": "application/json" },
-    options.timeoutMs ?? 15e3,
-    { method: "POST", body: JSON.stringify(payload), errorBody: explain }
-  );
-  if (page.status < 200 || page.status >= 300) {
-    const message2 = explain && page.status !== 401 && page.status !== 429 && page.body !== null && typeof page.body === "object" ? page.body.message : void 0;
-    if (typeof message2 === "string" && message2 !== "")
-      throw new GitHubMessageError(message2, {
-        cause: { status: page.status, path }
-      });
-    throw httpError(page, path);
+  const clock = options.wait ?? PROCESS_WAIT;
+  for (; ; ) {
+    const page = await getPage(
+      `${base}${path}`,
+      { ...apiHeaders(options.token), "Content-Type": "application/json" },
+      options.timeoutMs ?? 15e3,
+      // A refusal's body says whether it is a rate limit. A timeout throws
+      // above and is never retried: the write may have been made.
+      { method: "POST", body: JSON.stringify(payload), errorBody: true }
+    );
+    const ok = page.status >= 200 && page.status < 300;
+    const wait = rateDelay(page, clock.now(), ok && limited(page.body));
+    if (wait !== null) {
+      await waitOut(options, wait);
+      continue;
+    }
+    if (!ok) {
+      const message2 = explain && page.status !== 401 && page.status !== 429 && page.body !== null && typeof page.body === "object" ? page.body.message : void 0;
+      if (typeof message2 === "string" && message2 !== "")
+        throw new GitHubMessageError(message2, {
+          cause: { status: page.status, path }
+        });
+      throw httpError(page, path);
+    }
+    return page.body;
   }
-  return page.body;
 }
 async function getScopes(options) {
   const base = (options.apiBase ?? DEFAULT_GITHUB_API).replace(/\/+$/, "");
@@ -1489,8 +1720,17 @@ async function createRepository(owner, name, options) {
 function isRecord2(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"
+);
 async function graphqlRaw(query, variables, options) {
-  const body = await postJson("/graphql", { query, variables }, options, true);
+  const body = await postJson(
+    "/graphql",
+    { query, variables },
+    options,
+    true,
+    rateLimited
+  );
   return isRecord2(body) ? body : {};
 }
 function firstError(answer) {
@@ -1505,6 +1745,15 @@ async function graphql(query, variables, options) {
     throw new Error("GitHub GraphQL answered without data");
   return answer.data;
 }
+async function graphqlFound(query, variables, options) {
+  const answer = await graphqlRaw(query, variables, options);
+  const errors = answer.errors ?? [];
+  if (errors.length > 0 && errors.every((e) => e.type === "NOT_FOUND"))
+    return null;
+  const error = firstError(answer);
+  if (error !== null) throw error;
+  return answer.data ?? null;
+}
 async function orgId(org, o) {
   const d = await graphql(
     "query($login: String!) { organization(login: $login) { id } }",
@@ -1541,7 +1790,9 @@ async function findProject(org, number, o) {
     { login: org, number },
     o
   );
-  if (answer.errors?.every((e) => e.type === "NOT_FOUND") === true) return null;
+  const errors = answer.errors ?? [];
+  if (errors.length > 0 && errors.every((e) => e.type === "NOT_FOUND"))
+    return null;
   const error = firstError(answer);
   if (error !== null) throw error;
   return answer.data?.organization?.projectV2 ?? null;
@@ -1621,7 +1872,7 @@ async function setOptions(field, options, o) {
   );
   return toField(d.updateProjectV2Field.projectV2Field);
 }
-async function listItems(projectId, o) {
+async function listItems(projectId, o, { bodies = true } = {}) {
   const items = [];
   let cursor = null;
   for (; ; ) {
@@ -1639,8 +1890,23 @@ async function listItems(projectId, o) {
                       id
                       title
                     }
+                    ... on Issue {
+                      id
+                      number
+                      title
+                      state
+                      ${bodies ? "body" : ""}
+                      repository {
+                        nameWithOwner
+                      }
+                      labels(first: 20) {
+                        nodes {
+                          name
+                        }
+                      }
+                    }
                   }
-                  fieldValues(first: 20) {
+                  fieldValues(first: 50) {
                     nodes {
                       ... on ProjectV2ItemFieldTextValue {
                         text
@@ -1680,10 +1946,20 @@ async function listItems(projectId, o) {
         const value = v.text ?? v.name;
         if (field !== void 0 && value !== void 0) values2[field] = value;
       }
+      const c = n.content;
+      const issue = c?.id !== void 0 && c.number !== void 0 ? {
+        id: c.id,
+        number: c.number,
+        open: c.state === "OPEN",
+        repository: c.repository?.nameWithOwner ?? "",
+        body: bodies ? c.body ?? "" : null,
+        labels: (c.labels?.nodes ?? []).map((l) => l.name ?? "").filter((l) => l !== "")
+      } : null;
       items.push({
         id: n.id,
-        draftId: n.content?.id ?? null,
-        title: n.content?.title ?? "",
+        draftId: issue === null ? c?.id ?? null : null,
+        issue,
+        title: c?.title ?? "",
         archived: n.isArchived === true,
         values: values2
       });
@@ -1693,41 +1969,6 @@ async function listItems(projectId, o) {
     cursor = endCursor;
   }
 }
-async function addDraft(projectId, title, body, o) {
-  const d = await graphql(
-    `
-      mutation ($projectId: ID!, $title: String!, $body: String) {
-        addProjectV2DraftIssue(
-          input: { projectId: $projectId, title: $title, body: $body }
-        ) {
-          projectItem {
-            id
-          }
-        }
-      }
-    `,
-    { projectId, title, body },
-    o
-  );
-  return d.addProjectV2DraftIssue.projectItem.id;
-}
-async function editDraft(draftId, title, body, o) {
-  await graphql(
-    `
-      mutation ($draftIssueId: ID!, $title: String!, $body: String) {
-        updateProjectV2DraftIssue(
-          input: { draftIssueId: $draftIssueId, title: $title, body: $body }
-        ) {
-          draftIssue {
-            id
-          }
-        }
-      }
-    `,
-    { draftIssueId: draftId, title, body },
-    o
-  );
-}
 async function setValue(projectId, itemId, fieldId, value, o) {
   if (value === null) {
     await graphql(
@@ -1795,6 +2036,90 @@ async function archive(projectId, itemId, o) {
     o
   );
 }
+async function addItem(projectId, contentId, o) {
+  const d = await graphql(
+    `
+      mutation ($projectId: ID!, $contentId: ID!) {
+        addProjectV2ItemById(
+          input: { projectId: $projectId, contentId: $contentId }
+        ) {
+          item {
+            id
+          }
+        }
+      }
+    `,
+    { projectId, contentId },
+    o
+  );
+  return d.addProjectV2ItemById.item.id;
+}
+async function convertDraft(itemId, repositoryId, o) {
+  const d = await graphql(
+    `
+      mutation ($itemId: ID!, $repositoryId: ID!) {
+        convertProjectV2DraftIssueItemToIssue(
+          input: { itemId: $itemId, repositoryId: $repositoryId }
+        ) {
+          item {
+            id
+            content {
+              ... on Issue {
+                id
+                number
+              }
+            }
+          }
+        }
+      }
+    `,
+    { itemId, repositoryId },
+    o
+  );
+  const content = d.convertProjectV2DraftIssueItemToIssue.item.content;
+  const id = content?.id;
+  const number = content?.number;
+  if (id === void 0 || number === void 0)
+    throw new Error(`GitHub converted the item ${itemId} without an issue`);
+  return { id, number };
+}
+async function linkedRepositories(projectId, o) {
+  const d = await graphql(
+    `
+      query ($projectId: ID!) {
+        node(id: $projectId) {
+          ... on ProjectV2 {
+            repositories(first: 100) {
+              nodes {
+                nameWithOwner
+              }
+            }
+          }
+        }
+      }
+    `,
+    { projectId },
+    o
+  );
+  return (d.node?.repositories.nodes ?? []).map((r) => r.nameWithOwner);
+}
+async function linkRepository(projectId, repositoryId, o) {
+  await graphql(
+    `
+      mutation ($projectId: ID!, $repositoryId: ID!) {
+        linkProjectV2ToRepository(
+          input: { projectId: $projectId, repositoryId: $repositoryId }
+        ) {
+          repository {
+            id
+          }
+        }
+      }
+    `,
+    { projectId, repositoryId },
+    o
+  );
+}
 async function createView(org, number, view, o) {
   const body = {
     name: view.name,
@@ -1889,10 +2214,127 @@ async function renameView(viewId, name, visibleFieldIds, o) {
   );
 }
 
+// src/core/github-issues.ts
+async function repository(owner, name, label, o) {
+  const d = await graphqlFound(
+    `query($owner: String!, $name: String!, $label: String!) {
+      repository(owner: $owner, name: $name) { id hasIssuesEnabled label(name: $label) { id } }
+    }`,
+    { owner, name, label },
+    o
+  );
+  const r = d?.repository ?? null;
+  return r === null ? null : { id: r.id, issues: r.hasIssuesEnabled, labelId: r.label?.id ?? null };
+}
+async function createLabel(owner, name, label, o) {
+  const body = await postJson(
+    `/repos/${encodeURIComponent(owner)}/${encodeURIComponent(name)}/labels`,
+    label,
+    o,
+    true
+  );
+  const id = body !== null && typeof body === "object" ? body["node_id"] : void 0;
+  if (typeof id !== "string")
+    throw new Error(`GitHub created the label ${label.name} without a node id`);
+  return id;
+}
+async function createIssue(repositoryId, issue, o) {
+  const d = await graphql(
+    `
+      mutation (
+        $repositoryId: ID!
+        $title: String!
+        $body: String
+        $labelIds: [ID!]
+      ) {
+        createIssue(
+          input: {
+            repositoryId: $repositoryId
+            title: $title
+            body: $body
+            labelIds: $labelIds
+          }
+        ) {
+          issue {
+            id
+            number
+          }
+        }
+      }
+    `,
+    { repositoryId, ...issue },
+    o
+  );
+  return d.createIssue.issue;
+}
+async function updateIssue(id, change, o) {
+  await graphql(
+    `
+      mutation ($id: ID!, $title: String, $body: String) {
+        updateIssue(input: { id: $id, title: $title, body: $body }) {
+          issue {
+            id
+          }
+        }
+      }
+    `,
+    { id, ...change },
+    o
+  );
+}
+async function closeIssue(id, o) {
+  await graphql(
+    `
+      mutation ($id: ID!) {
+        closeIssue(input: { issueId: $id, stateReason: NOT_PLANNED }) {
+          issue {
+            id
+          }
+        }
+      }
+    `,
+    { id },
+    o
+  );
+}
+async function reopenIssue(id, o) {
+  await graphql(
+    `
+      mutation ($id: ID!) {
+        reopenIssue(input: { issueId: $id }) {
+          issue {
+            id
+          }
+        }
+      }
+    `,
+    { id },
+    o
+  );
+}
+async function addLabels(id, labelIds, o) {
+  await graphql(
+    `
+      mutation ($id: ID!, $labelIds: [ID!]!) {
+        addLabelsToLabelable(input: { labelableId: $id, labelIds: $labelIds }) {
+          clientMutationId
+        }
+      }
+    `,
+    { id, labelIds },
+    o
+  );
+}
+
 // src/core/github-board.ts
 var PROJECT_TITLE = "Agent Pulse";
 var WORKING = "working";
 var WORKING_VIEW = "Working";
+var MEMORY = ".rness";
+var LABEL = "rness";
+var LABEL_COLOR = "5319e7";
+var LABEL_DESCRIPTION = "A document of .rness, on Agent Pulse";
+var labelled = (labels) => labels.some((l) => l.toLowerCase() === LABEL.toLowerCase());
 var STATUS_FIELD = "Status";
 var ALL_VIEW = "All";
 var DEFAULT_VIEW = "View 1";
@@ -1921,6 +2363,8 @@ var orderedFirst = (wanted, all) => {
 var GitHubBoards = class {
   #o;
   #cache = /* @__PURE__ */ new Map();
+  /** Each organization's `.rness`, as first read: its id, its Issues, its label. */
+  #memories = /* @__PURE__ */ new Map();
   constructor(options) {
     this.#o = options;
   }
@@ -1943,6 +2387,23 @@ var GitHubBoards = class {
     cache.fields ??= await fields(cache.projectId, this.#o);
     return cache.fields;
   }
+  async #memory(org) {
+    const known = this.#memories.get(org);
+    if (known !== void 0) return known;
+    const found = await repository(org, MEMORY, LABEL, this.#o);
+    if (found === null)
+      throw new Error(
+        `the pulse needs ${org}/${MEMORY} on GitHub: it is not there, or this login cannot see it`
+      );
+    this.#memories.set(org, found);
+    return found;
+  }
+  async checkIssues(org) {
+    if (!(await this.#memory(org)).issues)
+      throw new Error(
+        `the pulse needs Issues on ${org}/${MEMORY}: turn them on in its Settings`
+      );
+  }
   /** The project only: the caller declares it before `ensureLayout` builds it. */
   async createBoard(org) {
     const project = await createProject(
@@ -2079,89 +2540,186 @@ var GitHubBoards = class {
         this.#o
       );
     }
+    const memory = await this.#memory(board.org);
+    if (memory.labelId === null) {
+      memory.labelId = await createLabel(
+        board.org,
+        MEMORY,
+        { name: LABEL, color: LABEL_COLOR, description: LABEL_DESCRIPTION },
+        this.#o
+      );
+      added.push(`label ${LABEL}`);
+    }
+    const repository2 = `${board.org}/${MEMORY}`;
+    const linked = await linkedRepositories(cache.projectId, this.#o);
+    if (!linked.some((r) => r.toLowerCase() === repository2.toLowerCase())) {
+      await linkRepository(cache.projectId, memory.id, this.#o);
+      added.push(`link ${repository2}`);
+    }
     cache.fields = [status2, collection, ...own.values(), agent, session, path];
     return added;
   }
-  async items(board) {
+  async items(board, options = {}) {
     const cache = await this.#cacheOf(board);
-    const raw = await listItems(cache.projectId, this.#o);
+    const raw = await listItems(cache.projectId, this.#o, options);
     cache.known = new Map(raw.map((r) => [r.id, r]));
-    return raw.filter((r) => !r.archived).map((r) => ({
-      id: r.id,
-      // No longer a draft issue (converted by hand): the team's, like an
-      // item without Path — the plan leaves it alone (spec 0017 §4).
-      path: r.draftId === null ? null : r.values["Path"] ?? null,
-      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: r.values["Session"] ?? null
-    }));
+    const memory = `${board.org}/${MEMORY}`.toLowerCase();
+    return raw.filter((r) => !r.archived).map((r) => {
+      const issue = r.issue !== null && r.issue.repository.toLowerCase() === memory ? r.issue : null;
+      const ours = r.draftId !== null || issue !== null;
+      return {
+        id: r.id,
+        path: ours ? r.values["Path"] ?? null : null,
+        issue: issue === null ? null : {
+          number: issue.number,
+          open: issue.open,
+          labelled: labelled(issue.labels),
+          body: issue.body
+        },
+        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: r.values["Session"] ?? null
+      };
+    });
   }
   async #set(board, itemId, name, value) {
     const cache = await this.#cacheOf(board);
     const field = (await this.#fields(board)).find((f) => f.name === name);
     if (field === void 0) throw new Error(`the board has no field ${name}`);
-    if (value === null) {
-      await setValue(cache.projectId, itemId, field.id, null, this.#o);
-      return;
-    }
-    if (field.options === null) {
-      await setValue(
-        cache.projectId,
-        itemId,
-        field.id,
-        { text: value },
-        this.#o
-      );
-      return;
+    let sent = null;
+    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)
+        throw new Error(`the field ${name} has no option ${value}`);
+      sent = { optionId: option.id };
     }
-    const option = field.options.find((opt) => opt.name === value);
-    if (option === void 0)
-      throw new Error(`the field ${name} has no option ${value}`);
-    await setValue(
-      cache.projectId,
-      itemId,
-      field.id,
-      { optionId: option.id },
-      this.#o
-    );
+    await setValue(cache.projectId, itemId, field.id, sent, this.#o);
+    const known = cache.known.get(itemId);
+    if (known === void 0) return;
+    if (value === null) delete known.values[name];
+    else known.values[name] = value;
   }
   async apply(board, step2) {
-    if (step2.kind === "unchanged") return;
+    if (step2.kind === "unchanged") return null;
     const cache = await this.#cacheOf(board);
-    if (step2.kind === "archive") {
+    if (step2.kind === "create") return this.#create(board, cache, step2.want);
+    const known = await this.#known(board, step2.id);
+    if (step2.kind === "archive" || step2.kind === "close") {
+      if (step2.kind === "close" && known.issue?.open === true)
+        await closeIssue(known.issue.id, this.#o);
       await archive(cache.projectId, step2.id, this.#o);
       cache.known.delete(step2.id);
-      return;
+      return null;
+    }
+    if (step2.kind === "body") {
+      const issue2 = this.#issueOf(known);
+      await updateIssue(issue2.id, { body: step2.body }, this.#o);
+      issue2.body = step2.body;
+      return null;
+    }
+    const labelId = await this.#labelId(board);
+    if (step2.kind === "convert") {
+      const made = await convertDraft(
+        step2.id,
+        (await this.#memory(board.org)).id,
+        this.#o
+      );
+      known.draftId = null;
+      known.issue = {
+        ...made,
+        open: true,
+        repository: `${board.org}/${MEMORY}`,
+        body: "",
+        labels: []
+      };
+      await this.#issue(known, step2.want, labelId);
+      await this.#values(board, step2.id, step2.want);
+      return { id: step2.id, number: made.number };
+    }
+    const issue = this.#issueOf(known);
+    if (step2.reopen) {
+      await reopenIssue(issue.id, this.#o);
+      issue.open = true;
+    }
+    await this.#issue(known, step2.want, labelId);
+    await this.#values(board, step2.id, step2.want);
+    return null;
+  }
+  /** A new document's issue: labelled, the first line as body, added to the board, Path first. */
+  async #create(board, cache, want) {
+    const memory = await this.#memory(board.org);
+    const labelId = await this.#labelId(board);
+    const made = await createIssue(
+      memory.id,
+      { title: want.title, body: want.body, labelIds: [labelId] },
+      this.#o
+    );
+    const id = await addItem(cache.projectId, made.id, this.#o);
+    cache.known.set(id, {
+      id,
+      draftId: null,
+      issue: {
+        ...made,
+        open: true,
+        repository: `${board.org}/${MEMORY}`,
+        body: want.body,
+        labels: [LABEL]
+      },
+      title: want.title,
+      archived: false,
+      values: {}
+    });
+    await this.#values(board, id, want);
+    return { id, number: made.number };
+  }
+  /** The label and the title an issue of the board carries. */
+  async #issue(known, want, labelId) {
+    const issue = this.#issueOf(known);
+    if (!labelled(issue.labels)) {
+      await addLabels(issue.id, [labelId], this.#o);
+      issue.labels.push(LABEL);
+    }
+    if (known.title !== want.title) {
+      await updateIssue(issue.id, { title: want.title }, this.#o);
+      known.title = want.title;
     }
-    const { want } = step2;
-    const values2 = [
+  }
+  /** 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 wanted = [
       ["Path", want.path],
       [COLLECTION_FIELD, want.type],
       [STATUS_FIELD, want.status],
       ...want.statusField === null ? [] : [[want.statusField, want.status]]
     ];
-    if (step2.kind === "create") {
-      const id = await addDraft(
-        cache.projectId,
-        want.title,
-        want.body,
-        this.#o
+    for (const [name, value] of wanted)
+      if ((values2[name] ?? null) !== value)
+        await this.#set(board, id, name, value);
+  }
+  async #known(board, id) {
+    const cache = await this.#cacheOf(board);
+    if (!cache.known.has(id)) await this.items(board);
+    const known = cache.known.get(id);
+    if (known === void 0) throw new Error(`the board has no item ${id}`);
+    return known;
+  }
+  #issueOf(known) {
+    if (known.issue === null)
+      throw new Error(`the board's item ${known.id} is no issue`);
+    return known.issue;
+  }
+  async #labelId(board) {
+    const id = (await this.#memory(board.org)).labelId;
+    if (id === null)
+      throw new Error(
+        `${board.org}/${MEMORY} has no label ${LABEL}: run rness pulse sync`
       );
-      for (const [name, value] of values2)
-        if (value !== null) await this.#set(board, id, name, value);
-      return;
-    }
-    if (!cache.known.has(step2.id)) await this.items(board);
-    const known = cache.known.get(step2.id);
-    if (known?.draftId == null)
-      throw new Error(`the board has no draft item ${step2.id}`);
-    await editDraft(known.draftId, want.title, want.body, this.#o);
-    for (const [name, value] of values2)
-      if ((known.values[name] ?? null) !== value)
-        await this.#set(board, step2.id, name, value);
+    return id;
   }
   async mark(board, itemIds, session) {
     for (const id of itemIds) {
@@ -2176,6 +2734,7 @@ var GITHUB_HTTPS = "https://github.com/";
 var GitHubOAuthProvider = class {
   #token;
   #apiBase;
+  #wait;
   #login;
   #boardClient;
   get authenticated() {
@@ -2184,11 +2743,16 @@ var GitHubOAuthProvider = class {
   constructor(options) {
     this.#token = options.token;
     this.#apiBase = options.apiBase;
+    this.#wait = options.wait;
   }
   #api(token) {
-    return this.#apiBase === void 0 ? { token } : { token, apiBase: this.#apiBase };
-  }
-  identity() {
+    return {
+      token,
+      ...this.#apiBase === void 0 ? {} : { apiBase: this.#apiBase },
+      ...this.#wait === void 0 ? {} : { wait: this.#wait }
+    };
+  }
+  identity() {
     this.#login ??= (async () => {
       const t = this.#token;
       if (t === null) return null;
@@ -2240,6 +2804,9 @@ var GitHubOAuthProvider = class {
     return this.#boardClient;
   }
   // The board methods are async so that a missing login rejects, never throws.
+  async checkIssues(org) {
+    return this.#boards().checkIssues(org);
+  }
   async createBoard(org) {
     return this.#boards().createBoard(org);
   }
@@ -2249,8 +2816,8 @@ var GitHubOAuthProvider = class {
   async ensureLayout(board, layout) {
     return this.#boards().ensureLayout(board, layout);
   }
-  async items(board) {
-    return this.#boards().items(board);
+  async items(board, options) {
+    return this.#boards().items(board, options);
   }
   async apply(board, step2) {
     return this.#boards().apply(board, step2);
@@ -2263,16 +2830,17 @@ var GitHubOAuthProvider = class {
     return { username: "x-access-token", password: this.#token.token };
   }
 };
-async function githubProvider(apiBase) {
+async function githubProvider(apiBase, wait) {
   return new GitHubOAuthProvider({
     token: await resolveToken(),
-    ...apiBase === void 0 ? {} : { apiBase }
+    ...apiBase === void 0 ? {} : { apiBase },
+    ...wait === void 0 ? {} : { wait }
   });
 }
 
 // src/core/repos.ts
 import { glob as glob2, readFile as readFile5, rm as rm3 } from "fs/promises";
-import { join as join8, posix as posix4, sep as sep2 } from "path";
+import { join as join8, 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);
@@ -2352,8 +2920,8 @@ async function workspaceDirs(repoDir) {
   const dirs = /* @__PURE__ */ new Set();
   for (const pattern of patterns) {
     for await (const match of glob2(pattern, { cwd: repoDir })) {
-      const rel = match.split(sep2).join(posix4.sep);
-      if (await exists(join8(repoDir, ...rel.split(posix4.sep), "package.json")))
+      const rel = match.split(sep2).join(posix5.sep);
+      if (await exists(join8(repoDir, ...rel.split(posix5.sep), "package.json")))
         dirs.add(rel);
     }
   }
@@ -2649,8 +3217,56 @@ function reportError(e) {
   return 1;
 }
 
+// src/core/delegate.ts
+import { readFile as readFile6 } from "fs/promises";
+import { join as join10 } 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");
+  let pkg;
+  try {
+    pkg = JSON.parse(await readFile6(join10(dir, "package.json"), "utf8"));
+  } catch {
+    return null;
+  }
+  const declared2 = pkg.bin;
+  let bin = DEFAULT_BIN;
+  if (typeof declared2 === "string") bin = declared2;
+  else if (declared2 !== null && typeof declared2 === "object") {
+    const named = declared2["rness"];
+    if (typeof named === "string") bin = named;
+  }
+  return {
+    dir,
+    bin,
+    version: typeof pkg.version === "string" ? pkg.version : null
+  };
+}
+async function pinnedBinPath(rnessDir) {
+  const pinned = await readPinnedCli(rnessDir);
+  if (pinned === null) return null;
+  return join10(pinned.dir, ...pinned.bin.split("/"));
+}
+async function findDelegate(cwd, ownVersion) {
+  let root;
+  let rnessDir;
+  try {
+    const ws = await findWorkspace(cwd);
+    root = ws.root;
+    rnessDir = ws.rnessDir;
+  } catch {
+    return null;
+  }
+  const pinned = await readPinnedCli(rnessDir);
+  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 };
+}
+
 // src/core/block.ts
-import { createHash } from "crypto";
+import { createHash as createHash2 } from "crypto";
 var BEGIN = "<!-- BEGIN rness -->";
 var END = "<!-- END rness -->";
 var BLOCK_SIZE_WARNING = 32 * 1024;
@@ -2659,7 +3275,7 @@ function toLf(s) {
   return s.replace(/\r\n?/g, "\n");
 }
 function blockHash(body) {
-  return createHash("sha256").update(toLf(body), "utf8").digest("hex").slice(0, 12);
+  return createHash2("sha256").update(toLf(body), "utf8").digest("hex").slice(0, 12);
 }
 function intro(scope, org, depth) {
   if (scope === null) {
@@ -2713,7 +3329,7 @@ function isCurrentBlock(blockLines, freshHash) {
 }
 
 // src/core/merge.ts
-import { join as join10 } from "path";
+import { join as join11 } from "path";
 function findBlock(lines) {
   const begins = [];
   const ends = [];
@@ -2772,7 +3388,7 @@ function claudeMdAtRoot(existing, block) {
   return merged.ok ? { ...merged, changed: merged.text !== existing } : merged;
 }
 async function ensureClaudeMd(dir) {
-  const file = join10(dir, "CLAUDE.md");
+  const file = join11(dir, "CLAUDE.md");
   if (await isSymlink(file)) return "unchanged";
   const existing = await readOrNull(file);
   if (existing === null) {
@@ -2787,14 +3403,222 @@ async function ensureClaudeMd(dir) {
 }
 
 // src/commands/sync.ts
-import { join as join12 } from "path";
+import { join as join14 } from "path";
 
 // src/core/agent-targets.ts
 import { mkdir as mkdir2 } from "fs/promises";
-import { dirname as dirname4, join as join11 } from "path";
+import { dirname as dirname4, join as join13 } from "path";
+
+// src/core/claude-skills.ts
+var PLUGIN = ".claude/skills/rness";
+var PLUGIN_JSON = `${JSON.stringify(
+  {
+    name: "rness",
+    description: "The rness workspace in Claude Code: /rness:status, /rness:adr, /rness:spec, /rness:plan, /rness:done."
+  },
+  null,
+  2
+)}
+`;
+function statusSkill(rness, pm) {
+  const command = `node "\${CLAUDE_PROJECT_DIR}/${rness}/${PINNED_BIN}" status --cwd "\${CLAUDE_PROJECT_DIR}"`;
+  return `---
+name: status
+description: The status of every decision, specification, plan and other tracked document of the rness workspace, one table per directory. Read-only.
+argument-hint: '[tab]'
+disable-model-invocation: true
+allowed-tools: Bash(${command})
+---
+
+!\`${command}\`
+
+Show the output above to the user as it is: the heading and the tables,
+nothing added, nothing summarised, no other tool. Arguments: \`$ARGUMENTS\`.
+When they name a tab, show only that tab's section. If the output says the
+module cannot be found, say instead that ${rness} is not installed next to
+this repository.
+
+End with this line: _For the view with tabs and scrolling: here, Ctrl+Z,
+then \`npx @rness/cli status\` (q to close), then \`fg\`; or in another
+terminal, from the workspace's \`.rness/\`: \`${localRunner(pm)} rness status\`._
+`;
+}
+var LIFECYCLE2 = [
+  {
+    name: "adr",
+    description: "Record a decision of the rness workspace as an ADR in .rness/adr/ \u2014 a choice expensive to reverse or that creates a lasting constraint. Use when the developer asks for an ADR, or when the conversation reaches such a decision.",
+    hint: "[subject | NNNN]",
+    tab: "adr",
+    body: (rness) => `You record a decision of this workspace as an ADR in \`${rness}/adr/\`. The table
+above lists the existing ADRs, newest first. Arguments: \`$ARGUMENTS\`.
+
+Before writing:
+
+1. If the developer did not ask for an ADR in so many words, propose one in
+   a single line \u2014 its title, and why the choice is hard to reverse \u2014 and
+   wait for a yes.
+2. Read \`${rness}/CONVENTIONS.md\` and \`${rness}/adr/0000-template.md\`: they hold the
+   rules and the sections; this skill is only the procedure.
+3. Arguments naming an ADR (\`NNNN\`): reopen that file. An \`Accepted\` ADR is
+   never edited: offer a new ADR that supersedes it.
+4. Otherwise the subject is the arguments, else the decision just
+   discussed. Context, alternatives or consequences missing from the
+   conversation: ask for them, one question at a time. Never invent them.
+
+Writing:
+
+- \`${rness}/adr/NNNN-<slug>.md\`, NNNN the highest number above plus one.
+- The template's front matter and sections, filled in, its guidance lines
+  removed: \`date\` today, \`status: Proposed\`, \`repo\` the repositories under
+  \`org/\` it affects.
+- An ADR it replaces is named in Context. That one becomes \`Superseded\`,
+  with \`superseded_by:\`, only once the new ADR is \`Accepted\`.
+- The rness hook checks every edit under \`${rness}/\`: fix what it reports.
+
+After writing: give the path and the Decision section, and say the ADR
+stays \`Proposed\` until the developer accepts it. Change a status only when
+the developer says so. Do not commit.
+`
+  },
+  {
+    name: "spec",
+    description: "Write a specification of the rness workspace in .rness/specs/ \u2014 the outcome wanted and its scope, before any plan. Use when the developer asks for a spec, or when agreed work is too large to start without one.",
+    hint: "[subject | NNNN]",
+    tab: "specs",
+    body: (rness) => `You write a specification of this workspace in \`${rness}/specs/\`. The table above
+lists the existing ones, newest first. Arguments: \`$ARGUMENTS\`.
+
+Before writing:
+
+1. If the developer did not ask for a specification in so many words,
+   propose one in a single line and wait for a yes.
+2. Read \`${rness}/CONVENTIONS.md\`, then the most recent specification above: match
+   its front matter, sections and tone.
+3. Arguments naming a specification (\`NNNN\`): reopen it. One that is
+   \`Implemented\`, \`Superseded\` or \`Rejected\` is not edited: offer a new one.
+4. Otherwise the subject is the arguments, else the work just discussed.
+   The problem, what is in and out of scope, the ADRs it rests on: ask what
+   the conversation does not say, one question at a time.
+
+Writing:
+
+- \`${rness}/specs/NNNN-<slug>.md\`, NNNN the highest number above plus one.
+- \`date\` and \`updated\` today, \`status: Draft\`, \`repo\`, and \`adr:\` linking
+  the decisions it rests on \u2014 or the rationale in the body when none does.
+- No specification yet to follow: Summary, Scope, Out of scope,
+  Alternatives considered, To verify, Tests.
+- What was checked in this session (a document read, a command run) is
+  written as verified, with the date; everything else as a proposal or an
+  open question.
+- The rness hook checks every edit under \`${rness}/\`: fix what it reports.
+
+After writing: give the path and the summary. It stays \`Draft\` until the
+developer moves it (\`Proposed\` for review, \`Approved\` to plan it). No plan
+here: \`/rness:plan NNNN\` once approved. Do not commit.
+`
+  },
+  {
+    name: "plan",
+    description: "Turn an approved specification of the rness workspace into a plan in .rness/plans/ \u2014 ordered tasks, each with the command that proves it done. Use when the developer asks for a plan, or when a specification has just been approved.",
+    hint: "<spec NNNN>",
+    tab: "plans",
+    body: (rness) => `You turn a specification into a plan in \`${rness}/plans/\`. The table above lists
+the existing plans, newest first. Arguments, the specification:
+\`$ARGUMENTS\`.
+
+Before writing:
+
+1. If the developer did not ask for a plan in so many words, propose one in
+   a single line and wait for a yes.
+2. No specification named: ask which. Read it, \`${rness}/CONVENTIONS.md\`, and the
+   most recent plan above: match its front matter and sections.
+3. A specification that is not \`Approved\`: say so, and plan it only if the
+   developer confirms. A plan of it that is neither \`Completed\` nor
+   \`Abandoned\`: reopen it rather than write a second.
+4. Read the code and the repositories the specification touches: every
+   task names real files and real commands.
+
+Writing:
+
+- \`${rness}/plans/NNNN-<slug>.md\`, NNNN the highest plan number above plus one \u2014
+  not the specification's.
+- \`date\` and \`updated\` today, \`status: Draft\`, \`repo\`, \`spec:\` linking the
+  specification.
+- Tasks in order, as checkboxes. Each gives the files, what changes, and
+  the command that proves it (a test, a build, a run). The last tasks:
+  the documentation the work makes inaccurate, then the release when the
+  repository has one.
+- Where the plan decides something the specification leaves open, a
+  section says so.
+- The rness hook checks every edit under \`${rness}/\`: fix what it reports.
+
+After writing: give the path and the list of tasks. It becomes \`Ready\` when
+the developer agrees. Do not commit.
+`
+  },
+  {
+    name: "done",
+    description: "Close a piece of work of the rness workspace \u2014 check each task of its plan on evidence, then move the plan and its specification to their final status and correct the documents the work made inaccurate. Use when the developer says the work is done, or when the last task of a plan passes.",
+    hint: "[plan NNNN]",
+    tab: "plans",
+    body: (rness) => `You close a piece of work: its plan in \`${rness}/plans/\`, its specification, and
+what they made inaccurate. The table above lists the plans, newest first.
+Arguments: \`$ARGUMENTS\`.
+
+1. The plan: the one named, else the one \`In progress\`. Several or none:
+   ask.
+2. If the developer did not ask to close it in so many words, propose it in
+   a single line and wait for a yes.
+3. Read the plan, its specification and \`${rness}/CONVENTIONS.md\`.
+4. Evidence first. For each task, what shows it done: a test, a build, a
+   command's output in this session. A task without evidence: run its
+   check now, or report it. Never mark a task done on belief.
+5. All tasks proven:
+   - the plan: \`status: Completed\`, \`updated\` today, the checkboxes of the
+     proven tasks ticked, and a section \`Verification (YYYY-MM-DD)\` \u2014 what
+     ran, what it showed, what could not run and why;
+   - the specification: \`Implemented\` once every plan of it is
+     \`Completed\`; \`updated\` today;
+   - the smallest set of documents the work makes inaccurate: \`${rness}/docs/\`,
+     the READMEs of the repositories it changed.
+6. A task not proven: the plan stays \`In progress\` \u2014 or \`Blocked\`, the
+   blocker written in it. Say what remains.
+7. The rness hook checks every edit under \`${rness}/\`: fix what it reports.
+
+After: list the files changed and the statuses moved. Do not commit.
+`
+  }
+];
+function lifecycleSkill(rness, s) {
+  const command = `node "\${CLAUDE_PROJECT_DIR}/${rness}/${PINNED_BIN}" status ${s.tab} --cwd "\${CLAUDE_PROJECT_DIR}"`;
+  return `---
+name: ${s.name}
+description: ${s.description}
+argument-hint: '${s.hint}'
+allowed-tools: Bash(${command})
+---
+
+!\`${command}\`
+
+${s.body(rness)}`;
+}
+function pluginFiles(rness, at, ctx) {
+  return [
+    { file: `${PLUGIN}/.claude-plugin/plugin.json`, at, content: PLUGIN_JSON },
+    {
+      file: `${PLUGIN}/skills/status/SKILL.md`,
+      at,
+      content: statusSkill(rness, ctx.packageManager)
+    },
+    ...LIFECYCLE2.map((s) => ({
+      file: `${PLUGIN}/skills/${s.name}/SKILL.md`,
+      at,
+      content: lifecycleSkill(rness, s)
+    }))
+  ];
+}
 
 // src/core/agents.ts
-var PINNED_BIN = "node_modules/@rness/cli/dist/bin/rness.js";
 function hookLine(rness, event) {
   const run3 = `f="$CLAUDE_PROJECT_DIR/${rness}/${PINNED_BIN}"; if [ -f "$f" ]; then node "$f" hook ${event};`;
   if (event !== "session-start") return `${run3} fi`;
@@ -2847,53 +3671,11 @@ function hooks(rness) {
     }
   ];
 }
-var PLUGIN = ".claude/skills/rness";
-var PLUGIN_JSON = `${JSON.stringify(
-  {
-    name: "rness",
-    description: "The rness workspace in Claude Code: /rness:status."
-  },
-  null,
-  2
-)}
-`;
-function statusSkill(rness) {
-  const command = `node "\${CLAUDE_PROJECT_DIR}/${rness}/${PINNED_BIN}" status --cwd "\${CLAUDE_PROJECT_DIR}"`;
-  return `---
-name: status
-description: The status of every decision, specification, plan and other tracked document of the rness workspace, one table per directory. Read-only.
-argument-hint: '[tab]'
-disable-model-invocation: true
-allowed-tools: Bash(${command})
----
-
-!\`${command}\`
-
-Show the output above to the user as it is: the heading and the tables,
-nothing added, nothing summarised, no other tool. Arguments: \`$ARGUMENTS\`.
-When they name a tab, show only that tab's section. If the output says the
-module cannot be found, say instead that ${rness} is not installed next to
-this repository.
-
-End with this line: _For the view with tabs and scrolling: Ctrl+Z, then
-\`npx @rness/cli status\` (q to close), then \`fg\`._
-`;
-}
-function plugin(rness, at) {
-  return [
-    { file: `${PLUGIN}/.claude-plugin/plugin.json`, at, content: PLUGIN_JSON },
-    {
-      file: `${PLUGIN}/skills/status/SKILL.md`,
-      at,
-      content: statusSkill(rness)
-    }
-  ];
-}
 var TARGETS = {
   claude: {
     name: "claude",
     label: "Claude Code",
-    files: [
+    files: (ctx) => [
       {
         file: ".claude/settings.json",
         at: "clones",
@@ -2929,7 +3711,7 @@ var TARGETS = {
           }
         ]
       },
-      ...plugin("../../.rness", "clones"),
+      ...pluginFiles("../../.rness", "clones", ctx),
       // A session opened at the workspace root reads this file, one opened
       // in a clone does not (spec 0011 §1): the hooks only, `.rness` inside.
       {
@@ -2937,7 +3719,7 @@ var TARGETS = {
         at: "root",
         guarantees: hooks(".rness")
       },
-      ...plugin(".rness", "root")
+      ...pluginFiles(".rness", "root", ctx)
     ]
   }
 };
@@ -3051,52 +3833,310 @@ function describeGuarantee(g) {
   return `${g.path.join(".")} lacks ${what}`;
 }
 
-// src/core/agent-targets.ts
-function wholeDiff(existing, content) {
-  if (existing === content) return null;
-  return existing === null ? "missing" : "differs from what rness writes";
+// 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 { promisify as promisify3 } from "util";
+var execFileP3 = promisify3(execFile3);
+var PACKAGE = "@rness/cli";
+var EXACT_VERSION = /^\d+\.\d+\.\d+(-[0-9A-Za-z.-]+)?$/;
+function compareVersions(a, b) {
+  const split = (v) => {
+    const dash = v.indexOf("-");
+    const core = dash === -1 ? v : v.slice(0, dash);
+    return [core.split(".").map(Number), dash === -1 ? null : v.slice(dash + 1)];
+  };
+  const [coreA, preA] = split(a);
+  const [coreB, preB] = split(b);
+  for (let i = 0; i < 3; i += 1) {
+    const diff = (coreA[i] ?? 0) - (coreB[i] ?? 0);
+    if (diff !== 0) return diff;
+  }
+  if (preA === preB) return 0;
+  if (preA === null) return 1;
+  if (preB === null) return -1;
+  return preA.localeCompare(preB, "en", { numeric: true });
 }
-async function filesOf(root, manifest, targets) {
-  const files = [];
-  if (!await exists(join11(root, "org"))) return files;
-  for (const target of targets)
-    for (const owned of target.files)
-      if (owned.at === "root")
-        files.push({
-          ...owned,
-          file: join11(root, ...owned.file.split("/")),
-          label: owned.file
-        });
-  for (const repo of Object.keys(manifest.repos)) {
-    if (!await exists(join11(root, "org", repo))) continue;
-    for (const target of targets)
-      for (const owned of target.files)
-        if (owned.at === "clones")
-          files.push({
-            ...owned,
-            file: join11(root, "org", repo, ...owned.file.split("/")),
-            label: `org/${repo}/${owned.file}`
-          });
+async function readPackageJson(rnessDir) {
+  try {
+    const parsed = JSON.parse(
+      await readFile7(join12(rnessDir, "package.json"), "utf8")
+    );
+    return parsed !== null && typeof parsed === "object" ? parsed : null;
+  } catch {
+    return null;
   }
-  return files;
 }
-function declared(manifest) {
-  return (manifest.agents ?? []).flatMap(
-    (name) => Object.hasOwn(TARGETS, name) ? [TARGETS[name]] : []
+async function readPin(rnessDir) {
+  const pkg = await readPackageJson(rnessDir);
+  if (pkg === null) return null;
+  for (const field of ["devDependencies", "dependencies"]) {
+    const deps = pkg[field];
+    if (deps === null || typeof deps !== "object") continue;
+    const spec = deps[PACKAGE];
+    if (typeof spec === "string") return { spec, field };
+  }
+  return null;
+}
+async function writePin(rnessDir, from, to) {
+  const file = join12(rnessDir, "package.json");
+  const text = await readFile7(file, "utf8");
+  const entry = new RegExp(
+    `("${PACKAGE}"\\s*:\\s*")${from.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}(")`
   );
+  if (!entry.test(text))
+    throw new Error(`"${PACKAGE}": "${from}" not found in package.json`);
+  await writeFileAtomic(file, text.replace(entry, `$1${to}$2`));
 }
-var BLOCK_FILES = ["AGENTS.md", "CLAUDE.md"];
-function writtenFiles(manifest) {
-  return [
-    ...BLOCK_FILES,
-    ...declared(manifest).flatMap(
-      (t) => t.files.filter((f) => f.at === "clones").map((f) => f.file)
-    )
-  ];
+var LOCKFILES = [
+  ["pnpm-lock.yaml", "pnpm"],
+  ["yarn.lock", "yarn"],
+  ["bun.lock", "bun"],
+  ["bun.lockb", "bun"],
+  ["package-lock.json", "npm"]
+];
+async function workspacePackageManager(rnessDir) {
+  const declared2 = (await readPackageJson(rnessDir))?.["packageManager"];
+  if (typeof declared2 === "string") {
+    const name = declared2.split("@")[0] ?? "";
+    if (isPackageManager(name)) return name;
+  }
+  for (const [lockfile, pm] of LOCKFILES)
+    if (await exists(join12(rnessDir, lockfile))) return pm;
+  return "npm";
 }
-async function agentTargets(root, manifest, opts) {
-  const outcomes = [];
-  for (const owned of await filesOf(root, manifest, declared(manifest))) {
+async function hasLockfile(rnessDir, pm) {
+  for (const [lockfile, owner] of LOCKFILES)
+    if (owner === pm && await exists(join12(rnessDir, lockfile))) return true;
+  return false;
+}
+async function pinDrift(rnessDir) {
+  const pin = await readPin(rnessDir);
+  if (pin === null || !EXACT_VERSION.test(pin.spec)) return null;
+  const installed = (await readPinnedCli(rnessDir))?.version ?? null;
+  return installed === pin.spec ? null : { pin: pin.spec, installed };
+}
+async function driftWarning(cwd) {
+  let root;
+  let rnessDir;
+  try {
+    const ws = await findWorkspace(cwd);
+    root = ws.root;
+    rnessDir = ws.rnessDir;
+  } catch {
+    return null;
+  }
+  const drift = await pinDrift(rnessDir);
+  if (drift === null) return null;
+  const pm = await workspacePackageManager(rnessDir);
+  return warn(
+    `${basename3(root)}/.rness pins @rness/cli ${drift.pin} but ${drift.installed ?? "nothing"} is installed \u2014 run ${pm} install in .rness`
+  );
+}
+var CHILD_DEADLINE_MS = 12e4;
+function childEnv(env = process.env) {
+  return {
+    ...env,
+    GIT_SSH_COMMAND: `${env["GIT_SSH_COMMAND"] ?? "ssh"} -o BatchMode=yes`,
+    GIT_TERMINAL_PROMPT: "0"
+  };
+}
+async function ensureInstalled(rnessDir, opts = {}) {
+  const drift = await pinDrift(rnessDir);
+  if (drift === null) return null;
+  const env = opts.env ?? process.env;
+  if (env["RNESS_NO_INSTALL"] === "1")
+    return { installed: false, pin: drift.pin, reason: "RNESS_NO_INSTALL=1" };
+  const pm = await workspacePackageManager(rnessDir);
+  const frozen = await hasLockfile(rnessDir, pm);
+  const install = opts.install ?? installDependencies;
+  opts.announce?.(drift.pin);
+  try {
+    await install(pm, rnessDir, { frozen });
+    return { installed: true, pin: drift.pin, reason: null };
+  } catch (e) {
+    return {
+      installed: false,
+      pin: drift.pin,
+      reason: e instanceof Error ? e.message : String(e)
+    };
+  }
+}
+async function runPinnedSync(root) {
+  const installed = await readPinnedCli(join12(root, ".rness"));
+  if (installed === null) return null;
+  const pinned = join12(installed.dir, ...installed.bin.split("/"));
+  if (!await exists(pinned))
+    return {
+      code: 1,
+      stdout: "",
+      stderr: `@rness/cli in .rness is not installed correctly (missing ${installed.bin}); reinstall in .rness/
+`
+    };
+  try {
+    const { stdout, stderr } = await execFileP3(
+      process.execPath,
+      [pinned, "sync", "--yes"],
+      {
+        cwd: root,
+        maxBuffer: 16 * 1024 * 1024,
+        env: childEnv(),
+        timeout: CHILD_DEADLINE_MS,
+        killSignal: "SIGKILL"
+      }
+    );
+    return { code: 0, stdout, stderr };
+  } catch (e) {
+    const err = e;
+    const deadline = err.killed === true ? `rness sync in .rness did not finish within ${CHILD_DEADLINE_MS / 1e3}s and was stopped
+` : "";
+    return {
+      code: typeof err.code === "number" ? err.code : 1,
+      stdout: err.stdout ?? "",
+      stderr: `${err.stderr ?? ""}${deadline}`
+    };
+  }
+}
+var SYNC_VERBS = ["updated", "unchanged", "stale"];
+function counted(noun, counts) {
+  const total = [...counts.values()].reduce((a, b) => a + b, 0);
+  const detail = SYNC_VERBS.filter((verb) => counts.has(verb)).map((verb) => `${counts.get(verb) ?? 0} ${verb}`).join(", ");
+  return `${total} ${noun}${total === 1 ? "" : "s"}${detail === "" ? "" : `: ${detail}`}`;
+}
+function summariseSync(stdout) {
+  const blocks = /* @__PURE__ */ new Map();
+  const agentFiles = /* @__PURE__ */ new Map();
+  const others = [];
+  for (const line3 of stdout.split("\n")) {
+    if (line3.trim() === "") continue;
+    const m = /^(updated|unchanged|stale)\s+(\S+)/.exec(line3);
+    if (m === null) {
+      others.push(line3);
+      continue;
+    }
+    const [, verb = "", path = ""] = m;
+    const counts = /(^|\/)(AGENTS|CLAUDE)\.md$/.test(path) ? blocks : agentFiles;
+    counts.set(verb, (counts.get(verb) ?? 0) + 1);
+  }
+  return {
+    summary: [
+      counted("block", blocks),
+      ...agentFiles.size > 0 ? [counted("agent file", agentFiles)] : []
+    ].join("; "),
+    others
+  };
+}
+function syncOutcome(result, opts = {}) {
+  const { others } = summariseSync(result.stdout);
+  const wrote = /^(updated|unchanged|stale)\s/m.test(result.stdout);
+  const stderr = result.stderr.split("\n").map((l) => l.trimEnd()).filter((l) => l.trim() !== "");
+  const hints = wrote ? [...others, ...stderr] : others;
+  if (opts.sshWorks === true && /Permission denied \(publickey\)/.test(result.stderr))
+    hints.push(...agentHintLines());
+  return {
+    code: wrote ? 0 : result.code,
+    hints,
+    errors: wrote ? [] : stderr
+  };
+}
+async function syncPinned(root, shown, fallback) {
+  const rnessDir = join12(root, ".rness");
+  const installed = await readPinnedCli(rnessDir);
+  if (installed === null) {
+    if (fallback !== void 0) return fallback();
+    process.stderr.write(
+      `@rness/cli is not installed in ${shown}/.rness; install in .rness/, then ${rnessCommand()} sync
+`
+    );
+    return 1;
+  }
+  const pinned = join12(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/
+`
+    );
+    return 1;
+  }
+  try {
+    const { stdout, stderr } = await execFileP3(
+      process.execPath,
+      [pinned, "sync", "--yes"],
+      {
+        cwd: root,
+        maxBuffer: 16 * 1024 * 1024,
+        env: childEnv(),
+        timeout: CHILD_DEADLINE_MS,
+        killSignal: "SIGKILL"
+      }
+    );
+    process.stdout.write(stdout);
+    if (stderr !== "") process.stderr.write(stderr);
+    return 0;
+  } catch (e) {
+    const err = e;
+    if (err.stdout !== void 0 && err.stdout !== "")
+      process.stdout.write(err.stdout);
+    if (err.stderr !== void 0 && err.stderr !== "")
+      process.stderr.write(err.stderr);
+    return typeof err.code === "number" ? err.code : 1;
+  }
+}
+
+// src/core/agent-targets.ts
+function wholeDiff(existing, content) {
+  if (existing === content) return null;
+  return existing === null ? "missing" : "differs from what rness writes";
+}
+async function contextOf(root) {
+  return {
+    packageManager: await workspacePackageManager(join13(root, ".rness"))
+  };
+}
+var PATHS_ONLY = { packageManager: "npm" };
+async function filesOf(root, manifest, targets) {
+  const files = [];
+  if (!await exists(join13(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("/")),
+          label: owned.file
+        });
+  for (const repo of Object.keys(manifest.repos)) {
+    if (!await exists(join13(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("/")),
+            label: `org/${repo}/${owned.file}`
+          });
+  }
+  return files;
+}
+function declared(manifest) {
+  return (manifest.agents ?? []).flatMap(
+    (name) => Object.hasOwn(TARGETS, name) ? [TARGETS[name]] : []
+  );
+}
+var BLOCK_FILES = ["AGENTS.md", "CLAUDE.md"];
+function writtenFiles(manifest) {
+  return [
+    ...BLOCK_FILES,
+    ...declared(manifest).flatMap(
+      (t) => t.files(PATHS_ONLY).filter((f) => f.at === "clones").map((f) => f.file)
+    )
+  ];
+}
+async function agentTargets(root, manifest, opts) {
+  const outcomes = [];
+  for (const owned of await filesOf(root, manifest, declared(manifest))) {
     const { file, label } = owned;
     const existing = await readOrNull(file);
     if ("content" in owned) {
@@ -3183,7 +4223,7 @@ var PROVIDERS = {
     name: "github",
     label: "GitHub",
     available: true,
-    open: ({ apiBase }) => githubProvider(apiBase)
+    open: ({ apiBase, wait }) => githubProvider(apiBase, wait)
   },
   gitlab: { name: "gitlab", label: "GitLab", available: false },
   atlassian: {
@@ -3398,7 +4438,7 @@ function targetsOf(manifest, root, only) {
     const segments = entry.path.split("/");
     targets.push({
       scope: name,
-      dir: join12(root, ...segments),
+      dir: join14(root, ...segments),
       depth: segments.length,
       label: `${entry.path}/AGENTS.md`
     });
@@ -3557,7 +4597,7 @@ async function syncCommand(opts, deps = {}) {
     try {
       const notCloned = /* @__PURE__ */ new Set();
       for (const [name, repo] of Object.entries(manifest.repos)) {
-        const dir = join12(ws.root, "org", name);
+        const dir = join14(ws.root, "org", name);
         const label = `org/${name}`;
         if (!await exists(dir)) {
           if (!toClone.has(name)) {
@@ -3609,7 +4649,7 @@ async function syncCommand(opts, deps = {}) {
         lines.push(
           `not in rness.json: ${undeclared.join(", ")} (${rnessCommand()} add <name> declares it)`
         );
-      if (!await exists(join12(ws.root, "org"))) {
+      if (!await exists(join14(ws.root, "org"))) {
         lines.push(["skipped", "blocks (no org/ directory here)"]);
       } else {
         let differences = 0;
@@ -3621,7 +4661,7 @@ async function syncCommand(opts, deps = {}) {
             continue;
           }
           const [agentsLinked, claudeLinked] = await Promise.all(
-            BLOCK_FILES.map((f) => isSymlink(join12(t.dir, f)))
+            BLOCK_FILES.map((f) => isSymlink(join14(t.dir, f)))
           );
           const atRoot = t.scope === null;
           if (!atRoot && (agentsLinked === true || claudeLinked === true)) {
@@ -3644,7 +4684,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(join12(t.dir, "AGENTS.md"), block, check);
+          const agents = agentsLinked === true ? "skipped" : await syncBlockFile(join14(t.dir, "AGENTS.md"), block, check);
           if (typeof agents === "object") {
             problems.push(`${t.label}: ${agents.error}`);
             continue;
@@ -3659,7 +4699,7 @@ async function syncCommand(opts, deps = {}) {
           }
           if (claudeLinked === true) continue;
           const claude = await syncBlockFile(
-            join12(t.dir, "CLAUDE.md"),
+            join14(t.dir, "CLAUDE.md"),
             block,
             check,
             true
@@ -3716,7 +4756,7 @@ async function syncCommand(opts, deps = {}) {
 }
 
 // src/commands/add.ts
-import { basename as basename3, join as join13 } from "path";
+import { basename as basename4, join as join15 } from "path";
 function printDeclared(ui, result, already) {
   for (const name of result.declared) {
     if (already.has(name)) continue;
@@ -3751,7 +4791,7 @@ async function addCommand(spec, opts, deps = {}) {
     }
     if (parsed.name === CONTEXT_REPO) {
       process.stderr.write(
-        `${CONTEXT_REPO} is the workspace context, not a member repository \u2014 it is already cloned at ${basename3(ws.root)}/${CONTEXT_REPO}
+        `${CONTEXT_REPO} is the workspace context, not a member repository \u2014 it is already cloned at ${basename4(ws.root)}/${CONTEXT_REPO}
 `
       );
       return 2;
@@ -3809,7 +4849,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 = join13(ws.root, "org", parsed.name);
+    const dir = join15(ws.root, "org", parsed.name);
     const present = await exists(dir);
     if (interactive) {
       const { confirm, isCancel } = await terminal.prompts();
@@ -3885,7 +4925,7 @@ async function addCommand(spec, opts, deps = {}) {
 }
 
 // src/commands/context.ts
-import { posix as posix5, relative, sep as sep3 } from "path";
+import { posix as posix6, relative, sep as sep3 } from "path";
 function renderMarkdown(ctx) {
   const parts = [];
   for (const collection of ctx.collections) {
@@ -3917,7 +4957,7 @@ async function contextCommand(opts) {
       }
       scope = opts.scope;
     } else {
-      const rel = relative(ws.root, cwd).split(sep3).join(posix5.sep);
+      const rel = relative(ws.root, cwd).split(sep3).join(posix6.sep);
       scope = resolveScope(manifest, rel);
     }
     const ctx = await assembleContext({
@@ -3935,56 +4975,9 @@ async function contextCommand(opts) {
   }
 }
 
-// src/core/delegate.ts
-import { readFile as readFile6 } from "fs/promises";
-import { join as join14 } from "path";
-var DEFAULT_BIN = "dist/bin/rness.js";
-async function readPinnedCli(rnessDir) {
-  const dir = join14(rnessDir, "node_modules", "@rness", "cli");
-  let pkg;
-  try {
-    pkg = JSON.parse(await readFile6(join14(dir, "package.json"), "utf8"));
-  } catch {
-    return null;
-  }
-  const declared2 = pkg.bin;
-  let bin = DEFAULT_BIN;
-  if (typeof declared2 === "string") bin = declared2;
-  else if (declared2 !== null && typeof declared2 === "object") {
-    const named = declared2["rness"];
-    if (typeof named === "string") bin = named;
-  }
-  return {
-    dir,
-    bin,
-    version: typeof pkg.version === "string" ? pkg.version : null
-  };
-}
-async function pinnedBinPath(rnessDir) {
-  const pinned = await readPinnedCli(rnessDir);
-  if (pinned === null) return null;
-  return join14(pinned.dir, ...pinned.bin.split("/"));
-}
-async function findDelegate(cwd, ownVersion) {
-  let root;
-  let rnessDir;
-  try {
-    const ws = await findWorkspace(cwd);
-    root = ws.root;
-    rnessDir = ws.rnessDir;
-  } catch {
-    return null;
-  }
-  const pinned = await readPinnedCli(rnessDir);
-  if (pinned === null) return null;
-  const { version } = pinned;
-  if (version === null || version === ownVersion) return null;
-  return { entry: join14(pinned.dir, "dist", "index.js"), version, root };
-}
-
 // src/core/scaffold.ts
 import { statSync } from "fs";
-import { dirname as dirname5, join as join15 } from "path";
+import { dirname as dirname5, join as join16 } from "path";
 import { fileURLToPath } from "url";
 var SCAFFOLD_FILES = [
   "AGENTS.md",
@@ -4008,9 +5001,9 @@ var SCAFFOLD_FILES = [
 function scaffoldDir() {
   let dir = dirname5(fileURLToPath(import.meta.url));
   for (let i = 0; i < 4; i += 1) {
-    const candidate = join15(dir, "scaffold");
+    const candidate = join16(dir, "scaffold");
     try {
-      if (statSync(join15(candidate, "rness.json")).isFile()) return candidate;
+      if (statSync(join16(candidate, "rness.json")).isFile()) return candidate;
     } catch {
     }
     dir = dirname5(dir);
@@ -4019,15 +5012,15 @@ function scaffoldDir() {
 }
 
 // src/core/scaffold-copy.ts
-import { chmod as chmod2, mkdir as mkdir3, readFile as readFile7, stat as stat2, writeFile as writeFile2 } from "fs/promises";
-import { dirname as dirname6, join as join16 } from "path";
+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";
 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 = join16(source, ...rel.split("/"));
-    let content = await readFile7(from, "utf8");
+    const from = join17(source, ...rel.split("/"));
+    let content = await readFile8(from, "utf8");
     if (TOKENISED.has(rel)) {
       content = content.replaceAll("__RNESS_VERSION__", tokens.version).replaceAll("__RNESS_PM__", tokens.packageManager);
     }
@@ -4041,7 +5034,7 @@ async function renderScaffold(source, tokens) {
 }
 async function copyScaffold(dest, tokens) {
   for (const file of await renderScaffold(scaffoldDir(), tokens)) {
-    const to = join16(dest, ...file.path.split("/"));
+    const to = join17(dest, ...file.path.split("/"));
     await mkdir3(dirname6(to), { recursive: true });
     await writeFile2(to, file.content, "utf8");
     if (file.executable) await chmod2(to, 493);
@@ -4053,16 +5046,16 @@ import { spawn as spawn3 } from "child_process";
 import { realpath } from "fs/promises";
 
 // src/core/setup-git.ts
-import { execFile as execFile3 } from "child_process";
-import { promisify as promisify3 } from "util";
-var execFileP3 = promisify3(execFile3);
+import { execFile as execFile4 } from "child_process";
+import { promisify as promisify4 } from "util";
+var execFileP4 = promisify4(execFile4);
 var KEY = "credential.https://github.com.helper";
 function helperValue(node, bin) {
   return `!'${node}' '${bin}' git-credential`;
 }
 var isOurs = (value) => /^!'[^']+' '[^']*rness[^']*' git-credential$/.test(value);
 async function config(args) {
-  const { stdout } = await execFileP3("git", ["config", "--global", ...args]);
+  const { stdout } = await execFileP4("git", ["config", "--global", ...args]);
   return stdout;
 }
 async function values() {
@@ -4096,400 +5089,149 @@ async function removeGitSetup() {
 }
 
 // src/commands/login.ts
-function openInBrowser(url) {
-  const [command, args] = process.platform === "darwin" ? ["open", [url]] : process.platform === "win32" ? ["cmd", ["/c", "start", "", url]] : ["xdg-open", [url]];
-  try {
-    const child = spawn3(command, args, { stdio: "ignore", detached: true });
-    child.on("error", () => void 0);
-    child.unref();
-  } catch {
-  }
-}
-async function offerSetupGit(opts, terminal, bin, ui) {
-  if (opts.setupGit === false) return;
-  if (!isStableInstall(bin)) {
-    ui.hint(
-      "install rness globally to let git use your login: npm i -g @rness/cli"
-    );
-    return;
-  }
-  if (opts.setupGit !== true) {
-    if (!terminal.isTty()) return;
-    const p = await terminal.prompts();
-    const ok = await p.confirm({
-      message: "Use rness to authenticate git over HTTPS for github.com?",
-      initialValue: true
-    });
-    if (p.isCancel(ok) || ok !== true) return;
-  }
-  const changed = await setupGit(process.execPath, bin);
-  ui.line(
-    changed ? "updated" : "unchanged",
-    `git: rness answers for https://github.com (${rnessCommand()} logout undoes it)`,
-    `git now asks rness for your github.com login over HTTPS (${rnessCommand()} logout undoes it)`
-  );
-}
-async function manifestAround(cwd) {
-  try {
-    return await loadManifest((await findWorkspace(cwd)).rnessDir);
-  } catch {
-    return null;
-  }
-}
-function splitScopes(scopes) {
-  return scopes.split(/[\s,]+/).filter((s) => s !== "");
-}
-async function loginCommand(opts, deps = {}) {
-  const terminal = deps.terminal ?? defaultTerminal;
-  const own = deps.ui === void 0;
-  const ui = deps.ui ?? await makeUi(terminal);
-  if (own) ui.intro("Log in to GitHub");
-  try {
-    const manifest = await manifestAround(deps.cwd ?? process.cwd());
-    if (manifest?.provider != null && !PROVIDERS[manifest.provider].available) {
-      ui.error(unsupportedProviderMessage(manifest.provider));
-      return 1;
-    }
-    const needsProject = opts.project === true || manifest?.pulse != null;
-    const bin = deps.bin ?? await realpath(process.argv[1] ?? "").catch(() => "");
-    const env = envToken();
-    if (env !== null)
-      ui.hint(`${env.source} is set and wins over a stored login`);
-    const stored = await readAuth();
-    const resolved = stored === null ? null : await resolveToken();
-    const lacksProject = needsProject && resolved?.source === "login" && !splitScopes(stored?.tokens.scopes ?? "").includes(PULSE_SCOPE);
-    if (stored !== null && resolved !== null && !lacksProject) {
-      ui.line(
-        "logged in",
-        `as ${stored.login} (github.com); ${rnessCommand()} logout to switch`
-      );
-      await offerSetupGit(opts, terminal, bin, ui);
-      if (own) ui.outro("Nothing to do", "idle");
-      return 0;
-    }
-    if (lacksProject) ui.line("login", "logging in again for the project scope");
-    const code = await requestDeviceCode(
-      needsProject ? `${SCOPES} ${PULSE_SCOPE}` : SCOPES
-    );
-    if (ui.session)
-      ui.line(
-        "open",
-        code.verificationUri,
-        `Open ${code.verificationUri} and enter the code ${code.userCode}`
-      );
-    else {
-      ui.line("open", code.verificationUri);
-      ui.line("code", code.userCode);
-    }
-    if (terminal.isTty() && process.env["SSH_CONNECTION"] === void 0)
-      (deps.open ?? openInBrowser)(code.verificationUri);
-    if (!ui.session)
-      ui.line("waiting", "for you to approve rness on github.com\u2026");
-    const login = await ui.step(
-      {
-        doing: "waiting  for you to approve rness on github.com",
-        sentence: "Waiting for your approval on github.com",
-        quiet: true
-      },
-      async () => {
-        const tokens = await pollForToken(code, deps);
-        const user = await getUser({
-          token: tokens.accessToken,
-          apiBase: opts.githubApi ?? DEFAULT_GITHUB_API
-        });
-        await writeAuth({ login: user.login, tokens });
-        return user.login;
-      },
-      (name) => ["logged in", `as ${name} (github.com)`]
-    );
-    if (!ui.session) ui.line("logged in", `as ${login} (github.com)`);
-    await offerSetupGit(opts, terminal, bin, ui);
-    if (own) ui.outro(`You are logged in as ${login}`);
-    return 0;
-  } catch (e) {
-    if (e instanceof LoginError) {
-      ui.error(e.message);
-      return 1;
-    }
-    return reportError(e);
-  }
-}
-function revokeUrl() {
-  return `https://github.com/settings/connections/applications/${clientId()}`;
-}
-
-// 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";
-
-// src/core/ask-provider.ts
-var PROVIDER_QUESTION = "Where does your organization live?";
-async function askProvider(p) {
-  return p.select({
-    message: PROVIDER_QUESTION,
-    options: Object.values(PROVIDERS).map((entry) => ({
-      value: entry.name,
-      label: entry.available ? entry.label : `${entry.label} (coming later)`,
-      disabled: !entry.available
-    }))
-  });
-}
-
-// 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";
-
-// src/core/pinned.ts
-import { execFile as execFile4 } from "child_process";
-import { readFile as readFile8 } from "fs/promises";
-import { basename as basename4, join as join17 } from "path";
-import { promisify as promisify4 } from "util";
-var execFileP4 = promisify4(execFile4);
-var PACKAGE = "@rness/cli";
-var EXACT_VERSION = /^\d+\.\d+\.\d+(-[0-9A-Za-z.-]+)?$/;
-function compareVersions(a, b) {
-  const split = (v) => {
-    const dash = v.indexOf("-");
-    const core = dash === -1 ? v : v.slice(0, dash);
-    return [core.split(".").map(Number), dash === -1 ? null : v.slice(dash + 1)];
-  };
-  const [coreA, preA] = split(a);
-  const [coreB, preB] = split(b);
-  for (let i = 0; i < 3; i += 1) {
-    const diff = (coreA[i] ?? 0) - (coreB[i] ?? 0);
-    if (diff !== 0) return diff;
-  }
-  if (preA === preB) return 0;
-  if (preA === null) return 1;
-  if (preB === null) return -1;
-  return preA.localeCompare(preB, "en", { numeric: true });
-}
-async function readPackageJson(rnessDir) {
-  try {
-    const parsed = JSON.parse(
-      await readFile8(join17(rnessDir, "package.json"), "utf8")
-    );
-    return parsed !== null && typeof parsed === "object" ? parsed : null;
-  } catch {
-    return null;
-  }
-}
-async function readPin(rnessDir) {
-  const pkg = await readPackageJson(rnessDir);
-  if (pkg === null) return null;
-  for (const field of ["devDependencies", "dependencies"]) {
-    const deps = pkg[field];
-    if (deps === null || typeof deps !== "object") continue;
-    const spec = deps[PACKAGE];
-    if (typeof spec === "string") return { spec, field };
-  }
-  return null;
-}
-async function writePin(rnessDir, from, to) {
-  const file = join17(rnessDir, "package.json");
-  const text = await readFile8(file, "utf8");
-  const entry = new RegExp(
-    `("${PACKAGE}"\\s*:\\s*")${from.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}(")`
-  );
-  if (!entry.test(text))
-    throw new Error(`"${PACKAGE}": "${from}" not found in package.json`);
-  await writeFileAtomic(file, text.replace(entry, `$1${to}$2`));
-}
-var LOCKFILES = [
-  ["pnpm-lock.yaml", "pnpm"],
-  ["yarn.lock", "yarn"],
-  ["bun.lock", "bun"],
-  ["bun.lockb", "bun"],
-  ["package-lock.json", "npm"]
-];
-async function workspacePackageManager(rnessDir) {
-  const declared2 = (await readPackageJson(rnessDir))?.["packageManager"];
-  if (typeof declared2 === "string") {
-    const name = declared2.split("@")[0] ?? "";
-    if (isPackageManager(name)) return name;
-  }
-  for (const [lockfile, pm] of LOCKFILES)
-    if (await exists(join17(rnessDir, lockfile))) return pm;
-  return "npm";
-}
-async function hasLockfile(rnessDir, pm) {
-  for (const [lockfile, owner] of LOCKFILES)
-    if (owner === pm && await exists(join17(rnessDir, lockfile))) return true;
-  return false;
-}
-async function pinDrift(rnessDir) {
-  const pin = await readPin(rnessDir);
-  if (pin === null || !EXACT_VERSION.test(pin.spec)) return null;
-  const installed = (await readPinnedCli(rnessDir))?.version ?? null;
-  return installed === pin.spec ? null : { pin: pin.spec, installed };
-}
-async function driftWarning(cwd) {
-  let root;
-  let rnessDir;
-  try {
-    const ws = await findWorkspace(cwd);
-    root = ws.root;
-    rnessDir = ws.rnessDir;
-  } catch {
-    return null;
-  }
-  const drift = await pinDrift(rnessDir);
-  if (drift === null) return null;
-  const pm = await workspacePackageManager(rnessDir);
-  return warn(
-    `${basename4(root)}/.rness pins @rness/cli ${drift.pin} but ${drift.installed ?? "nothing"} is installed \u2014 run ${pm} install in .rness`
-  );
-}
-var CHILD_DEADLINE_MS = 12e4;
-function childEnv(env = process.env) {
-  return {
-    ...env,
-    GIT_SSH_COMMAND: `${env["GIT_SSH_COMMAND"] ?? "ssh"} -o BatchMode=yes`,
-    GIT_TERMINAL_PROMPT: "0"
-  };
-}
-async function ensureInstalled(rnessDir, opts = {}) {
-  const drift = await pinDrift(rnessDir);
-  if (drift === null) return null;
-  const env = opts.env ?? process.env;
-  if (env["RNESS_NO_INSTALL"] === "1")
-    return { installed: false, pin: drift.pin, reason: "RNESS_NO_INSTALL=1" };
-  const pm = await workspacePackageManager(rnessDir);
-  const frozen = await hasLockfile(rnessDir, pm);
-  const install = opts.install ?? installDependencies;
-  opts.announce?.(drift.pin);
-  try {
-    await install(pm, rnessDir, { frozen });
-    return { installed: true, pin: drift.pin, reason: null };
-  } catch (e) {
-    return {
-      installed: false,
-      pin: drift.pin,
-      reason: e instanceof Error ? e.message : String(e)
-    };
-  }
-}
-async function runPinnedSync(root) {
-  const installed = await readPinnedCli(join17(root, ".rness"));
-  if (installed === null) return null;
-  const pinned = join17(installed.dir, ...installed.bin.split("/"));
-  if (!await exists(pinned))
-    return {
-      code: 1,
-      stdout: "",
-      stderr: `@rness/cli in .rness is not installed correctly (missing ${installed.bin}); reinstall in .rness/
-`
-    };
-  try {
-    const { stdout, stderr } = await execFileP4(
-      process.execPath,
-      [pinned, "sync", "--yes"],
-      {
-        cwd: root,
-        maxBuffer: 16 * 1024 * 1024,
-        env: childEnv(),
-        timeout: CHILD_DEADLINE_MS,
-        killSignal: "SIGKILL"
-      }
-    );
-    return { code: 0, stdout, stderr };
-  } catch (e) {
-    const err = e;
-    const deadline = err.killed === true ? `rness sync in .rness did not finish within ${CHILD_DEADLINE_MS / 1e3}s and was stopped
-` : "";
-    return {
-      code: typeof err.code === "number" ? err.code : 1,
-      stdout: err.stdout ?? "",
-      stderr: `${err.stderr ?? ""}${deadline}`
-    };
-  }
-}
-var SYNC_VERBS = ["updated", "unchanged", "stale"];
-function counted(noun, counts) {
-  const total = [...counts.values()].reduce((a, b) => a + b, 0);
-  const detail = SYNC_VERBS.filter((verb) => counts.has(verb)).map((verb) => `${counts.get(verb) ?? 0} ${verb}`).join(", ");
-  return `${total} ${noun}${total === 1 ? "" : "s"}${detail === "" ? "" : `: ${detail}`}`;
-}
-function summariseSync(stdout) {
-  const blocks = /* @__PURE__ */ new Map();
-  const agentFiles = /* @__PURE__ */ new Map();
-  const others = [];
-  for (const line3 of stdout.split("\n")) {
-    if (line3.trim() === "") continue;
-    const m = /^(updated|unchanged|stale)\s+(\S+)/.exec(line3);
-    if (m === null) {
-      others.push(line3);
-      continue;
-    }
-    const [, verb = "", path = ""] = m;
-    const counts = /(^|\/)(AGENTS|CLAUDE)\.md$/.test(path) ? blocks : agentFiles;
-    counts.set(verb, (counts.get(verb) ?? 0) + 1);
-  }
-  return {
-    summary: [
-      counted("block", blocks),
-      ...agentFiles.size > 0 ? [counted("agent file", agentFiles)] : []
-    ].join("; "),
-    others
-  };
-}
-function syncOutcome(result, opts = {}) {
-  const { others } = summariseSync(result.stdout);
-  const wrote = /^(updated|unchanged|stale)\s/m.test(result.stdout);
-  const stderr = result.stderr.split("\n").map((l) => l.trimEnd()).filter((l) => l.trim() !== "");
-  const hints = wrote ? [...others, ...stderr] : others;
-  if (opts.sshWorks === true && /Permission denied \(publickey\)/.test(result.stderr))
-    hints.push(...agentHintLines());
-  return {
-    code: wrote ? 0 : result.code,
-    hints,
-    errors: wrote ? [] : stderr
-  };
+function openInBrowser(url) {
+  const [command, args] = process.platform === "darwin" ? ["open", [url]] : process.platform === "win32" ? ["cmd", ["/c", "start", "", url]] : ["xdg-open", [url]];
+  try {
+    const child = spawn3(command, args, { stdio: "ignore", detached: true });
+    child.on("error", () => void 0);
+    child.unref();
+  } catch {
+  }
 }
-async function syncPinned(root, shown, fallback) {
-  const rnessDir = join17(root, ".rness");
-  const installed = await readPinnedCli(rnessDir);
-  if (installed === null) {
-    if (fallback !== void 0) return fallback();
-    process.stderr.write(
-      `@rness/cli is not installed in ${shown}/.rness; install in .rness/, then ${rnessCommand()} sync
-`
+async function offerSetupGit(opts, terminal, bin, ui) {
+  if (opts.setupGit === false) return;
+  if (!isStableInstall(bin)) {
+    ui.hint(
+      "install rness globally to let git use your login: npm i -g @rness/cli"
     );
-    return 1;
+    return;
   }
-  const pinned = join17(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/
-`
-    );
-    return 1;
+  if (opts.setupGit !== true) {
+    if (!terminal.isTty()) return;
+    const p = await terminal.prompts();
+    const ok = await p.confirm({
+      message: "Use rness to authenticate git over HTTPS for github.com?",
+      initialValue: true
+    });
+    if (p.isCancel(ok) || ok !== true) return;
   }
+  const changed = await setupGit(process.execPath, bin);
+  ui.line(
+    changed ? "updated" : "unchanged",
+    `git: rness answers for https://github.com (${rnessCommand()} logout undoes it)`,
+    `git now asks rness for your github.com login over HTTPS (${rnessCommand()} logout undoes it)`
+  );
+}
+async function manifestAround(cwd) {
   try {
-    const { stdout, stderr } = await execFileP4(
-      process.execPath,
-      [pinned, "sync", "--yes"],
+    return await loadManifest((await findWorkspace(cwd)).rnessDir);
+  } catch {
+    return null;
+  }
+}
+function splitScopes(scopes) {
+  return scopes.split(/[\s,]+/).filter((s) => s !== "");
+}
+async function loginCommand(opts, deps = {}) {
+  const terminal = deps.terminal ?? defaultTerminal;
+  const own = deps.ui === void 0;
+  const ui = deps.ui ?? await makeUi(terminal);
+  if (own) ui.intro("Log in to GitHub");
+  try {
+    const manifest = await manifestAround(deps.cwd ?? process.cwd());
+    if (manifest?.provider != null && !PROVIDERS[manifest.provider].available) {
+      ui.error(unsupportedProviderMessage(manifest.provider));
+      return 1;
+    }
+    const needsProject = opts.project === true || manifest?.pulse != null;
+    const bin = deps.bin ?? await realpath(process.argv[1] ?? "").catch(() => "");
+    const env = envToken();
+    if (env !== null)
+      ui.hint(`${env.source} is set and wins over a stored login`);
+    const stored = await readAuth();
+    const resolved = stored === null ? null : await resolveToken();
+    const lacksProject = needsProject && resolved?.source === "login" && !splitScopes(stored?.tokens.scopes ?? "").includes(PULSE_SCOPE);
+    if (stored !== null && resolved !== null && !lacksProject) {
+      ui.line(
+        "logged in",
+        `as ${stored.login} (github.com); ${rnessCommand()} logout to switch`
+      );
+      await offerSetupGit(opts, terminal, bin, ui);
+      if (own) ui.outro("Nothing to do", "idle");
+      return 0;
+    }
+    if (lacksProject) ui.line("login", "logging in again for the project scope");
+    const code = await requestDeviceCode(
+      needsProject ? `${SCOPES} ${PULSE_SCOPE}` : SCOPES
+    );
+    if (ui.session)
+      ui.line(
+        "open",
+        code.verificationUri,
+        `Open ${code.verificationUri} and enter the code ${code.userCode}`
+      );
+    else {
+      ui.line("open", code.verificationUri);
+      ui.line("code", code.userCode);
+    }
+    if (terminal.isTty() && process.env["SSH_CONNECTION"] === void 0)
+      (deps.open ?? openInBrowser)(code.verificationUri);
+    if (!ui.session)
+      ui.line("waiting", "for you to approve rness on github.com\u2026");
+    const login = await ui.step(
       {
-        cwd: root,
-        maxBuffer: 16 * 1024 * 1024,
-        env: childEnv(),
-        timeout: CHILD_DEADLINE_MS,
-        killSignal: "SIGKILL"
-      }
+        doing: "waiting  for you to approve rness on github.com",
+        sentence: "Waiting for your approval on github.com",
+        quiet: true
+      },
+      async () => {
+        const tokens = await pollForToken(code, deps);
+        const user = await getUser({
+          token: tokens.accessToken,
+          apiBase: opts.githubApi ?? DEFAULT_GITHUB_API
+        });
+        await writeAuth({ login: user.login, tokens });
+        return user.login;
+      },
+      (name) => ["logged in", `as ${name} (github.com)`]
     );
-    process.stdout.write(stdout);
-    if (stderr !== "") process.stderr.write(stderr);
+    if (!ui.session) ui.line("logged in", `as ${login} (github.com)`);
+    await offerSetupGit(opts, terminal, bin, ui);
+    if (own) ui.outro(`You are logged in as ${login}`);
     return 0;
   } catch (e) {
-    const err = e;
-    if (err.stdout !== void 0 && err.stdout !== "")
-      process.stdout.write(err.stdout);
-    if (err.stderr !== void 0 && err.stderr !== "")
-      process.stderr.write(err.stderr);
-    return typeof err.code === "number" ? err.code : 1;
+    if (e instanceof LoginError) {
+      ui.error(e.message);
+      return 1;
+    }
+    return reportError(e);
   }
 }
+function revokeUrl() {
+  return `https://github.com/settings/connections/applications/${clientId()}`;
+}
+
+// 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";
+
+// src/core/ask-provider.ts
+var PROVIDER_QUESTION = "Where does your organization live?";
+async function askProvider(p) {
+  return p.select({
+    message: PROVIDER_QUESTION,
+    options: Object.values(PROVIDERS).map((entry) => ({
+      value: entry.name,
+      label: entry.available ? entry.label : `${entry.label} (coming later)`,
+      disabled: !entry.available
+    }))
+  });
+}
+
+// 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";
 
 // src/core/scaffold-git.ts
 import { execFile as execFile5 } from "child_process";
@@ -5782,9 +6524,9 @@ async function clonesToCommit(root, cwd, manifest) {
   }
   return clones;
 }
-function finish(ui, cwd, rnessDir, label, target, ending) {
+function finish(ui, cwd, rnessDir, label, target2, ending) {
   const rel = relative5(cwd, rnessDir) || ".";
-  const message2 = `chore: rness ${target}`;
+  const message2 = `chore: rness ${target2}`;
   const next = [];
   if (ending.commit === "committed") next.push(`git -C ${rel} push`);
   if (ending.commit === "refused")
@@ -5797,12 +6539,12 @@ function finish(ui, cwd, rnessDir, label, target, ending) {
     next.push("# teammates: git pull \u2014 the next rness command installs it");
   if (ui.session) {
     if (next.length > 0) ui.note("Next steps", next);
-    ui.outro(`${label} runs @rness/cli ${target}`);
+    ui.outro(`${label} runs @rness/cli ${target2}`);
   } else
     process.stdout.write(
       [
         "",
-        status("upgraded", `${label} to @rness/cli ${target}`),
+        status("upgraded", `${label} to @rness/cli ${target2}`),
         "",
         ...next.length > 0 ? ["Next:", ...next.map((line3) => `  ${line3}`), ""] : []
       ].join("\n")
@@ -5838,12 +6580,12 @@ async function upgradeCommand(version, opts, terminal = defaultTerminal, deps =
     }
     const ui = interactive ? await makeUi(terminal) : { ...plainUi };
     ui.intro(`Upgrade workspace ${basename5(ws.root)}`);
-    const target = version ?? await ui.step(
+    const target2 = version ?? await ui.step(
       { doing: "asking   the registry for the latest release", quiet: true },
       () => latestVersion(),
       (v) => v === null ? null : ["latest", `@rness/cli ${v}`]
     );
-    if (target === null) {
+    if (target2 === null) {
       process.stderr.write(
         `cannot reach the registry; name the version: ${rnessCommand()} upgrade <version>
 `
@@ -5871,44 +6613,44 @@ async function upgradeCommand(version, opts, terminal = defaultTerminal, deps =
       return 1;
     }
     const base = await findScaffoldBase(ws.rnessDir);
-    const scaffoldCurrent = base !== null && base.version === target;
-    if (pin.spec === target && installed === target && scaffoldCurrent) {
-      if (ui.session) ui.outro(`Already at ${target}`);
-      else process.stdout.write(`already at ${target}
+    const scaffoldCurrent = base !== null && base.version === target2;
+    if (pin.spec === target2 && installed === target2 && scaffoldCurrent) {
+      if (ui.session) ui.outro(`Already at ${target2}`);
+      else process.stdout.write(`already at ${target2}
 `);
       return 0;
     }
-    const downgrading = EXACT_VERSION.test(pin.spec) && compareVersions(target, pin.spec) < 0;
+    const downgrading = EXACT_VERSION.test(pin.spec) && compareVersions(target2, pin.spec) < 0;
     if (downgrading && version === void 0) {
       process.stderr.write(
-        `${label} pins @rness/cli ${pin.spec}, newer than the latest release ${target}; to downgrade: ${rnessCommand()} upgrade ${target}
+        `${label} pins @rness/cli ${pin.spec}, newer than the latest release ${target2}; to downgrade: ${rnessCommand()} upgrade ${target2}
 `
       );
       return 1;
     }
     const pm = await workspacePackageManager(ws.rnessDir);
-    if (pin.spec === target && installed === target)
+    if (pin.spec === target2 && installed === target2)
       ui.line(
         "scaffold",
-        `@rness/cli ${target} \u2014 merging it into ${label}`,
-        `Merging the @rness/cli ${target} scaffold into ${label}`
+        `@rness/cli ${target2} \u2014 merging it into ${label}`,
+        `Merging the @rness/cli ${target2} scaffold into ${label}`
       );
-    else if (pin.spec === target)
+    else if (pin.spec === target2)
       ui.line(
         "install",
-        `@rness/cli ${target} in ${label} (${pm}) \u2014 ${installed ?? "nothing"} is installed`
+        `@rness/cli ${target2} in ${label} (${pm}) \u2014 ${installed ?? "nothing"} is installed`
       );
     else {
       ui.line(
         "upgrade",
-        `@rness/cli ${pin.spec} \u2192 ${target} in ${label} (${pm})${downgrading ? " \u2014 downgrading" : ""}`
+        `@rness/cli ${pin.spec} \u2192 ${target2} in ${label} (${pm})${downgrading ? " \u2014 downgrading" : ""}`
       );
       ui.line("notes", NOTES, `Release notes: ${NOTES}`);
     }
     if (interactive) {
       const p = await terminal.prompts();
       const ok = await p.confirm({
-        message: `Upgrade @rness/cli to ${target}?`
+        message: `Upgrade @rness/cli to ${target2}?`
       });
       if (p.isCancel(ok) || ok !== true) {
         ui.cancelled();
@@ -5918,31 +6660,31 @@ async function upgradeCommand(version, opts, terminal = defaultTerminal, deps =
     let merged = false;
     if (!scaffoldCurrent) {
       const source = await (deps.scaffoldFor ?? scaffoldFor)(
-        target,
+        target2,
         ws.rnessDir
       );
       try {
         const files = await renderScaffold(source.dir, {
-          version: target,
+          version: target2,
           packageManager: await declaredManager(ws.rnessDir, pm)
         });
         if (base === null)
           ui.line(
             "adopting",
-            `the @rness/cli ${target} scaffold (no scaffold commit in ${label} yet)`,
-            `Adopting the @rness/cli ${target} scaffold \u2014 ${label} has no scaffold commit yet`
+            `the @rness/cli ${target2} scaffold (no scaffold commit in ${label} yet)`,
+            `Adopting the @rness/cli ${target2} scaffold \u2014 ${label} has no scaffold commit yet`
           );
         else
           ui.line(
             "merging",
-            `the @rness/cli ${target} scaffold`,
-            `Merging the @rness/cli ${target} scaffold`
+            `the @rness/cli ${target2} scaffold`,
+            `Merging the @rness/cli ${target2} scaffold`
           );
         const commit = await buildScaffoldCommit(
           ws.rnessDir,
           base?.commit ?? null,
           base === null ? await withoutRedundantKeeps(ws.rnessDir, files) : files,
-          target
+          target2
         );
         const result = await mergeScaffold(
           ws.rnessDir,
@@ -5969,9 +6711,9 @@ async function upgradeCommand(version, opts, terminal = defaultTerminal, deps =
       [packageFile, await readFile9(packageFile, "utf8")]
     ]);
     const moved = await readPin(ws.rnessDir);
-    if (moved !== null && moved.spec !== target)
-      await writePin(ws.rnessDir, moved.spec, target);
-    const mustInstall = !(pin.spec === target && installed === target);
+    if (moved !== null && moved.spec !== target2)
+      await writePin(ws.rnessDir, moved.spec, target2);
+    const mustInstall = !(pin.spec === target2 && installed === target2);
     if (mustInstall) {
       try {
         await ui.step(
@@ -6002,9 +6744,9 @@ async function upgradeCommand(version, opts, terminal = defaultTerminal, deps =
         return 1;
       }
       const now = (await readPinnedCli(ws.rnessDir))?.version ?? null;
-      if (now !== target) {
+      if (now !== target2) {
         process.stderr.write(
-          `${pm} install left @rness/cli ${now ?? "not installed"} in ${label}, not ${target}
+          `${pm} install left @rness/cli ${now ?? "not installed"} in ${label}, not ${target2}
 `
         );
         return 1;
@@ -6013,7 +6755,7 @@ async function upgradeCommand(version, opts, terminal = defaultTerminal, deps =
     ui.gitIsSilent = true;
     const code = await syncBlocks(ui, ws.root, basename5(ws.root));
     if (code !== 0) return code;
-    const message2 = `chore: rness ${target}`;
+    const message2 = `chore: rness ${target2}`;
     const committed = await commitUpgrade(ws.rnessDir, message2);
     if (committed.kind === "committed")
       ui.line(
@@ -6028,7 +6770,7 @@ async function upgradeCommand(version, opts, terminal = defaultTerminal, deps =
       for (const line3 of committed.output.split("\n"))
         if (line3.trim() !== "") ui.hint(line3, "stderr");
     }
-    return finish(ui, cwd, ws.rnessDir, label, target, {
+    return finish(ui, cwd, ws.rnessDir, label, target2, {
       commit: committed.kind,
       clones: await clonesToCommit(
         ws.root,
@@ -6153,11 +6895,11 @@ password=${resolved.token}
 
 // src/commands/hook.ts
 import { realpath as realpath4 } from "fs/promises";
-import { isAbsolute as isAbsolute2, posix as posix7, relative as relative7, resolve as resolve7, sep as sep5 } from "path";
+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 posix6, relative as relative6, resolve as resolve6, sep as sep4 } from "path";
+import { isAbsolute, join as join24, posix as posix7, relative as relative6, resolve as resolve6, sep as sep4 } from "path";
 var LABELS = {
   standards: "Standards",
   adr: "Decisions",
@@ -6197,7 +6939,7 @@ async function documents(rnessDir, only) {
         scope: ownerScope(item.rel),
         id,
         status: typeof status2 === "string" ? status2 : null,
-        title: documentTitle(item.title ?? posix6.basename(item.rel, ".md"), id),
+        title: documentTitle(item.title ?? posix7.basename(item.rel, ".md"), id),
         text: item.body
       });
     }
@@ -6227,7 +6969,7 @@ async function context(cwd, args) {
   } else
     scope = resolveScope(
       manifest,
-      relative6(ws.root, cwd).split(sep4).join(posix6.sep)
+      relative6(ws.root, cwd).split(sep4).join(posix7.sep)
     );
   const summary = await scopeSummary(ws, manifest, scope);
   return {
@@ -6416,8 +7158,9 @@ function mcpTools(cwd) {
 
 // src/pulse/detached.ts
 import { spawn as nodeSpawn } from "child_process";
-import { mkdir as mkdir7, readFile as readFile11, rm as rm8, writeFile as writeFile4 } from "fs/promises";
+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 { setTimeout as delay2 } from "timers/promises";
 var detached = (args, cwd) => {
   const bin = process.argv[1];
   if (bin === void 0) return;
@@ -6452,6 +7195,33 @@ async function takeFailure() {
     return null;
   }
 }
+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`);
+  for (; ; ) {
+    try {
+      const handle = await open2(file, "wx");
+      await handle.close();
+      break;
+    } catch (e) {
+      if (e.code !== "EEXIST") throw e;
+      const age = await stat5(file).then(
+        (s) => Date.now() - s.mtimeMs,
+        () => 0
+      );
+      if (age > PULSE_LOCK_STALE_MS) await rm8(file, { force: true });
+      else if (options.wait !== true) return false;
+      else await (options.sleep ?? ((ms) => delay2(ms)))(1e3);
+    }
+  }
+  try {
+    await work();
+    return true;
+  } finally {
+    await rm8(file, { force: true });
+  }
+}
 
 // src/commands/hook.ts
 var NOUNS = {
@@ -6479,7 +7249,7 @@ function cwdOf(input, env) {
   if (typeof cwd === "string" && cwd !== "") return cwd;
   return env["CLAUDE_PROJECT_DIR"] ?? process.cwd();
 }
-var toPosix2 = (p) => p.split(sep5).join(posix7.sep);
+var toPosix2 = (p) => p.split(sep5).join(posix8.sep);
 function count(n, [one, many]) {
   return `${n} ${n === 1 ? one : many}`;
 }
@@ -6823,29 +7593,162 @@ async function mcpCommand(opts, io = {
   return 0;
 }
 
+// src/commands/pulse.ts
+import { readFile as readFile13, readdir as readdir4 } from "fs/promises";
+import { join as join26 } 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 { dirname as dirname9 } from "path";
+var NAME2 = "rness/opened";
+function openedFile(rnessDir) {
+  return gitPath(rnessDir, NAME2);
+}
+var NUMBER = /^[1-9][0-9]*$/;
+async function readOpened(file) {
+  const opened = /* @__PURE__ */ new Map();
+  if (file === null) return opened;
+  let data;
+  try {
+    data = JSON.parse(await readFile12(file, "utf8"));
+  } catch {
+    return opened;
+  }
+  if (data === null || typeof data !== "object" || Array.isArray(data))
+    return opened;
+  for (const [key, path] of Object.entries(data))
+    if (NUMBER.test(key) && typeof path === "string" && path !== "")
+      opened.set(Number(key), path);
+  return opened;
+}
+async function writeOpened(file, opened) {
+  if (file === null) return;
+  try {
+    if (opened.size === 0) {
+      await rm9(file, { force: true });
+      return;
+    }
+    const entries = [...opened].sort(([a], [b]) => a - b);
+    await mkdir8(dirname9(file), { recursive: true });
+    const temporary = `${file}.${process.pid}`;
+    await writeFile5(
+      temporary,
+      `${JSON.stringify(Object.fromEntries(entries), null, 2)}
+`
+    );
+    await rename3(temporary, file);
+  } catch {
+  }
+}
+
 // src/pulse/plan.ts
-function planSync(want, have) {
+var differs = (item, w) => item.title !== w.title || item.status !== w.status || w.statusField !== null && item.collectionStatus !== w.status || item.type !== w.type;
+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 };
+var firstLine5 = (body) => body.split(/\r\n?|\n/, 1)[0] ?? "";
+function strays(have) {
+  const byLine = /* @__PURE__ */ new Map();
+  for (const item of have) {
+    if (item.path !== null || item.issue === null || item.issue.body === null || !item.issue.labelled)
+      continue;
+    const line3 = firstLine5(item.issue.body);
+    byLine.set(line3, [...byLine.get(line3) ?? [], item]);
+  }
+  for (const items of byLine.values()) items.sort(keptFirst);
+  return byLine;
+}
+function unwantedPaths(want, have) {
+  const wanted = new Set(want.map((w) => w.path));
+  const paths = /* @__PURE__ */ new Set();
+  for (const item of have)
+    if (item.path !== null && !wanted.has(item.path)) paths.add(item.path);
+  return [...paths];
+}
+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()) {
   const byPath = /* @__PURE__ */ new Map();
-  const steps = [];
+  for (const item of have)
+    if (item.path !== null)
+      byPath.set(item.path, [...byPath.get(item.path) ?? [], item]);
+  const kept = /* @__PURE__ */ new Map();
   const surplus = [];
-  for (const item of have) {
-    if (item.path === null) continue;
-    if (byPath.has(item.path)) surplus.push({ kind: "archive", id: item.id });
-    else byPath.set(item.path, item);
+  for (const [path, items] of byPath) {
+    const [keep, ...rest] = [...items].sort(keptFirst);
+    if (keep !== void 0) kept.set(path, keep);
+    surplus.push(...rest.map(gone));
   }
+  const left = strays(have);
+  const steps = [];
   const wanted = /* @__PURE__ */ new Set();
   for (const w of want) {
     wanted.add(w.path);
-    const item = byPath.get(w.path);
+    const item = kept.get(w.path) ?? left.get(w.body)?.[0];
     if (item === void 0) steps.push({ kind: "create", want: w });
-    else if (item.title !== w.title || item.status !== w.status || w.statusField !== null && item.collectionStatus !== w.status || item.type !== w.type)
-      steps.push({ kind: "update", id: item.id, want: w });
+    else if (item.issue === null)
+      steps.push({ kind: "convert", id: item.id, want: w });
+    else if (item.path === null || !item.issue.open || !item.issue.labelled || differs(item, w))
+      steps.push({
+        kind: "update",
+        id: item.id,
+        want: w,
+        reopen: !item.issue.open
+      });
     else steps.push({ kind: "unchanged", id: item.id });
   }
-  for (const [path, item] of byPath)
-    if (!wanted.has(path)) steps.push({ kind: "archive", id: item.id });
+  for (const [path, item] of kept)
+    if (!wanted.has(path))
+      steps.push(
+        isGone(path, item, seen, opened) ? gone(item) : { kind: "unchanged", id: item.id }
+      );
   return [...steps, ...surplus];
 }
+function stillOpened(opened, have, seen, closed, created) {
+  const items = /* @__PURE__ */ new Map();
+  for (const item of have)
+    if (item.issue !== null) items.set(item.issue.number, item.id);
+  const next = /* @__PURE__ */ new Map();
+  for (const [number, path] of opened) {
+    const id = items.get(number);
+    if (id !== void 0 && !closed.has(id) && !seen.has(path))
+      next.set(number, path);
+  }
+  for (const [path, placed] of created) next.set(placed.number, path);
+  return next;
+}
+function issuedAfter(steps, have, placed) {
+  const byId = new Map(have.map((i) => [i.id, i]));
+  const issued = /* @__PURE__ */ new Map();
+  for (const step2 of steps) {
+    if (step2.kind === "create" || step2.kind === "convert") {
+      const p = placed.get(step2.want.path);
+      if (p !== void 0) issued.set(step2.want.path, { ...p, body: null });
+    } else if (step2.kind === "update" || step2.kind === "unchanged") {
+      const item = byId.get(step2.id);
+      const path = step2.kind === "update" ? step2.want.path : item?.path;
+      if (item === void 0 || path == null || item.issue === null) continue;
+      issued.set(path, {
+        id: item.id,
+        number: item.issue.number,
+        body: item.issue.body
+      });
+    }
+  }
+  return issued;
+}
+function planBodies(bodies, issued) {
+  const steps = [];
+  for (const [path, body] of bodies) {
+    const i = issued.get(path);
+    if (i === void 0) continue;
+    if (i.body === null || digestOf(i.body) !== digestOf(body))
+      steps.push({ kind: "body", id: i.id, body });
+  }
+  return steps;
+}
 
 // src/commands/pulse.ts
 var PROJECT_SCOPE = "project";
@@ -6861,15 +7764,23 @@ async function fromGithub(work) {
     throw e;
   }
 }
-async function context2(opts) {
+var apiOf = (opts) => opts.githubApi === void 0 ? {} : { apiBase: opts.githubApi };
+var providerOptions = (opts, wait) => ({
+  ...apiOf(opts),
+  ...wait === void 0 ? {} : { wait }
+});
+async function context2(opts, wait) {
   const ws = await findWorkspace(opts.cwd ?? process.cwd());
   const manifest = await loadManifest(ws.rnessDir);
-  const provider = await openProvider(manifest, apiOf(opts));
+  const provider = await openProvider(manifest, providerOptions(opts, wait));
   if (manifest.org === null)
     throw new Error('the pulse needs an organization: rness.json has no "org"');
   return { rnessDir: ws.rnessDir, manifest, org: manifest.org, provider };
 }
-var apiOf = (opts) => opts.githubApi === void 0 ? {} : { apiBase: opts.githubApi };
+var waitSaid = (opts, ui) => rateWait(async (ms) => {
+  ui.line("waiting", `${Math.round(ms / 1e3)} s \u2014 GitHub's rate limit`);
+  await (opts.sleep ?? ((n) => delay3(n)))(ms);
+});
 async function missingAccess(provider) {
   if (!provider.authenticated) return NEEDS_LOGIN;
   const scopes = await fromGithub(provider.scopes());
@@ -6895,33 +7806,131 @@ var createdByKind = (ui, added) => {
     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(", ")}`);
   }
+  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)}`);
+  }
 };
+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 path = rel === "" ? e.name : `${rel}/${e.name}`;
+      if (e.isDirectory()) {
+        if (e.name !== ".git" && e.name !== "node_modules") await walk(path);
+      } else if (e.isFile()) files.add(path);
+    }
+  };
+  await walk("");
+  return files;
+}
+var count2 = (n, word) => `${n} ${word}${n === 1 ? "" : "s"}`;
+function sayDone(ui, org, documents2, steps, writes) {
+  const n = (kind) => steps.filter((s) => s.kind === kind).length;
+  const reopened = steps.filter((s) => s.kind === "update" && s.reopen).length;
+  if (n("create") > 0) ui.line("created", count2(n("create"), "issue"));
+  if (n("convert") > 0)
+    ui.line(
+      "converted",
+      `${count2(n("convert"), "draft")} into issues of ${org}/.rness`
+    );
+  if (reopened > 0) ui.line("reopened", count2(reopened, "issue"));
+  const written = new Set(writes.map((w) => w.id));
+  const bodyOnly = steps.filter(
+    (s) => s.kind === "unchanged" && written.has(s.id)
+  ).length;
+  const parts = [
+    ["created", n("create")],
+    ["converted", n("convert")],
+    ["updated", n("update") + bodyOnly],
+    [
+      "unchanged",
+      documents2 - n("create") - n("convert") - n("update") - bodyOnly
+    ],
+    ["archived", n("close") + n("archive")]
+  ].filter(([, k]) => k > 0).map(([word, k]) => `${k} ${word}`);
+  ui.line(
+    "synced",
+    `${plural(documents2)}${parts.length > 0 ? `: ${parts.join(", ")}` : ""}`
+  );
+}
 async function syncBoard(c, board, ui, sayLayout) {
+  await fromGithub(c.provider.checkIssues(c.org));
   const tabs = await statusTabs(c.rnessDir);
   const want = desiredOf(tabs, c.org);
   sayLayout(
     ui,
     await fromGithub(c.provider.ensureLayout(board, layoutOf(tabs)))
   );
-  const steps = planSync(want, await fromGithub(c.provider.items(board)));
-  for (const step2 of steps) await fromGithub(c.provider.apply(board, step2));
-  const count2 = (kind) => steps.filter((s) => s.kind === kind).length;
-  const parts = [
-    ["created", "create"],
-    ["updated", "update"],
-    ["unchanged", "unchanged"],
-    ["archived", "archive"]
-  ].map(([word, kind]) => [word, count2(kind)]).filter(([, n]) => n > 0).map(([word, n]) => `${n} ${word}`);
-  ui.line(
-    "synced",
-    `${plural(want.length)}${parts.length > 0 ? `: ${parts.join(", ")}` : ""}`
-  );
+  const have = await fromGithub(c.provider.items(board));
+  const record = await openedFile(c.rnessDir);
+  const opened = await readOpened(record);
+  const seen = await seenPaths(c.rnessDir, [
+    ...unwantedPaths(want, have),
+    ...opened.values()
+  ]);
+  const steps = planSync(want, have, seen, opened);
+  const changes = steps.filter((s) => s.kind !== "unchanged").length;
+  let writes = [];
+  let made = 0;
+  try {
+    const placed = /* @__PURE__ */ new Map();
+    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 !== 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)
+      );
+    }
+    const issued = issuedAfter(steps, have, placed);
+    const numbers = new Map([...issued].map(([path, i]) => [path, i.number]));
+    const files = await filesOf2(c.rnessDir);
+    const bodies = /* @__PURE__ */ new Map();
+    for (const w of want)
+      bodies.set(
+        w.path,
+        issueBody({
+          path: w.path,
+          text: await readFile13(join26(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++;
+    }
+  } catch (e) {
+    if (!(e instanceof RateLimitError)) throw e;
+    const total = changes + writes.length;
+    throw new Error(
+      `${e.message}: ${total - made} of ${total} changes not made \u2014 the next rness pulse sync makes them`,
+      { cause: e }
+    );
+  }
+  sayDone(ui, c.org, want.length, steps, writes);
 }
 async function pulseCreateCommand(opts, deps = {}) {
   try {
     const terminal = deps.terminal ?? defaultTerminal;
     const ui = deps.ui ?? await makeUi(terminal);
-    let c = await context2(opts);
+    const wait = waitSaid(opts, ui);
+    let c = await context2(opts, wait);
     if (c.manifest.pulse !== null)
       throw new Error(
         `already declared: ${boardUrl(c.org, c.manifest.pulse.project)} \u2014 rness pulse sync`
@@ -6949,10 +7958,14 @@ async function pulseCreateCommand(opts, deps = {}) {
         { terminal, ui, ...opts.cwd === void 0 ? {} : { cwd: opts.cwd } }
       );
       if (code !== 0) return code;
-      c = { ...c, provider: await openProvider(c.manifest, apiOf(opts)) };
+      c = {
+        ...c,
+        provider: await openProvider(c.manifest, providerOptions(opts, wait))
+      };
       const still = await missingAccess(c.provider);
       if (still !== null) throw new Error(still);
     }
+    await fromGithub(c.provider.checkIssues(c.org));
     const login = (await c.provider.identity())?.login ?? "unknown";
     ui.line(
       "checked",
@@ -6981,7 +7994,7 @@ async function pulseCreateCommand(opts, deps = {}) {
 async function pulseSyncCommand(opts, deps = {}) {
   try {
     const ui = deps.ui ?? await makeUi(deps.terminal ?? defaultTerminal);
-    const c = await context2(opts);
+    const c = await context2(opts, waitSaid(opts, ui));
     await syncBoard(c, await declaredBoard(c), ui, eachAdded);
     return 0;
   } catch (e) {
@@ -6999,17 +8012,37 @@ async function pulseMarkCommand(opts) {
 async function mark(opts) {
   const c = await context2(opts);
   const board = await declaredBoard(c);
-  const items = await fromGithub(c.provider.items(board));
+  const key = `${c.org}-${board.number}`;
+  const lock = opts.sleep === void 0 ? {} : { sleep: opts.sleep };
+  const listed = () => fromGithub(c.provider.items(board, { bodies: false }));
+  let items = await listed();
   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 syncBoard(c, board, plainUi, eachAdded);
+    await oneSyncAtATime(key, () => syncBoard(c, board, plainUi, eachAdded), {
+      ...lock,
+      wait: true
+    });
     return 0;
   }
   const wanted = new Set(opts.paths);
+  const documents2 = new Set(
+    (await statusTabs(c.rnessDir)).flatMap((t) => t.rows.map((r) => r.path))
+  );
+  const onBoard = new Set(
+    items.flatMap((i) => i.path === null ? [] : [i.path])
+  );
+  if ([...wanted].some((p) => documents2.has(p) && !onBoard.has(p))) {
+    const synced = await oneSyncAtATime(
+      key,
+      () => syncBoard(c, board, plainUi, eachAdded),
+      lock
+    );
+    if (synced) items = await listed();
+  }
   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;
@@ -7500,6 +8533,7 @@ export {
   defaultTransport,
   findWorkspace,
   reportError,
+  findDelegate,
   BEGIN,
   END,
   BLOCK_SIZE_WARNING,
@@ -7514,7 +8548,6 @@ export {
   addCommand,
   renderMarkdown,
   contextCommand,
-  findDelegate,
   SCAFFOLD_FILES,
   scaffoldDir,
   copyScaffold,
@@ -7528,4 +8561,4 @@ export {
   OWN_COMMANDS,
   catchUp
 };
-//# sourceMappingURL=chunk-AEW7ZDFS.js.map
+//# sourceMappingURL=chunk-AXTFDXN2.js.map