@rness/cli 0.14.0 → 0.15.0

package/README.md

@@ -118,7 +118,10 @@ the files a given agent needs, for the agents the team declares in
   The rules stay in `.rness/CONVENTIONS.md`; the skills only add the steps.
   A new document takes the collection's first status (`Proposed` for an
   ADR, `Draft` otherwise) and the next number of the local checkout; two
-  branches can pick the same one. No skill commits.
+  branches can pick the same one. Each skill records its session: it adds
+  the Claude Code session id to `sessions:` in the front matter of what it
+  writes or closes — an edit made without a skill leaves none. No skill
+  commits.
 - rness owns values, not files: what is missing is added, nothing else is
   touched, and a file it cannot parse is reported, never rewritten.
   `sync --check` and `validate` report a missing value. Removing an agent
@@ -232,7 +235,11 @@ in its Settings`.
   `.rness/`, in lifecycle order, at most 50), `Collection` (one option per tab of
   `rness status`; not `Type`, which is GitHub's own issue-type field and
   filter), `Agent` (`working`), `Session` (`claude · 1a2b3c4d`, plus the
-  agent type for a subagent) and `Path`. A board per directory, named as
+  agent type for a subagent), `Path` and `Sessions` — the document's
+  `sessions:` (see "Agent targets"), joined by `, `, written by sync and
+  never cleared: which sessions wrote a specification or implemented a plan,
+  after they ended (`claude --resume <id>` reopens one on the machine it ran
+  on). A board made before 0.15.0 gains `Sessions` at its next sync. A board per directory, named as
   `rness status` names its tab, filtered on its `Collection`, its columns
   that collection's own steps: each collection has its own status field
   (`ADR status`, `Specs status`, …; a directory without statuses is columned
@@ -287,7 +294,9 @@ added to project`) may change a field of rness's items; the next sync
 - **Hooks**, with `claude` in `agents` and a pulse declared: session start
   marks the `In progress` plans of the session's scope `Agent: working`, with
   the session; an edit of a document of `.rness/` marks it — one the agent has just written, with no item yet, gets its issue first
-  through a sync, and an edit of any other file of `.rness/` costs no sync;
+  through a sync, and so does one whose status the edit changed, so its
+  card moves within seconds rather than at the session's end; an edit that
+  leaves the status alone, or of any other file of `.rness/`, costs no sync;
   the hooks' syncs run one at a time, an edit's skipped while another runs,
   the session end's waiting its turn; session end clears
   the marks of that session (its subagents' included) and syncs. Each one
@@ -302,7 +311,7 @@ added to project`) may change a field of rness's items; the next sync
   `cannot reach GitHub: …`. Two sessions marking one plan both write; the
   last wins.
 - **Rate**: rness sends one request at a time. A new document costs an
-  issue, its addition to the board, up to four fields, then its body. An
+  issue, its addition to the board, up to five fields, then its body. An
   unchanged document costs nothing but its share of the listing, which
   reads every item's body. On one of GitHub's rate limits rness waits as
   long as GitHub says (`waiting  60 s — GitHub's rate limit`), 10 minutes
@@ -336,7 +345,7 @@ repository, the board).
   `contract`, `provider`, `org`, `agents`, `pulse`, `repos`, `scopes`.
 - A provider _written_ in `rness.json` that this version cannot talk to
   (`gitlab`) is refused by `validate`, `create`, `login` and `pulse`:
-  `provider "gitlab" is not supported by @rness/cli 0.14.0 (supported:
+  `provider "gitlab" is not supported by @rness/cli 0.15.0 (supported:
 github)`. `add`, `sync` and the local commands never refuse. `null` is not a
   value: an absent key means none.
 
@@ -513,6 +522,20 @@ per repository, the files to commit there.
 Exit codes: 0 success, 1 failure, 2 usage — or a refusal without a TTY.
 `RNESS_DEBUG=1` adds stack traces; `RNESS_NO_DELEGATE=1` skips the delegation.
 
+## 0.15.0 — Agent Pulse follows a status change; the sessions are kept
+
+- An edit that changes a document's status syncs Agent Pulse at once: its
+  card moves within seconds, not at the session's end. An edit that leaves
+  the status alone still costs nothing. See "Pulse".
+- `sessions:` in a document's front matter lists the Claude Code sessions
+  that wrote or changed it. The lifecycle skills add theirs; the board
+  shows them in a new field, `Sessions`, which a session's end never
+  clears. A board gains the field at its first sync with 0.15.0. See
+  "Pulse" and "Agent targets".
+- `rness upgrade` rewrites the four lifecycle skills; commit
+  `.claude/skills/rness/` in each repository.
+- Blocks are unchanged.
+
 ## 0.14.0 — the lifecycle skills; `/rness:status` names a second terminal
 
 - The `rness` plugin of Claude Code gains `/rness:adr`, `/rness:spec`,

package/dist/bin/rness.js

@@ -6,7 +6,7 @@ import {
   findDelegate,
   reportError,
   run
-} from "../chunk-AXTFDXN2.js";
+} from "../chunk-HGT7BIWK.js";
 
 // src/bin/rness.ts
 import { pathToFileURL } from "url";

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

@@ -486,7 +486,7 @@ function parseRepoSpec(spec, org, host) {
 }
 
 // src/version.ts
-var VERSION = "0.14.0";
+var VERSION = "0.15.0";
 
 // src/core/pm.ts
 import { execFile as execFile2 } from "child_process";
@@ -1070,15 +1070,25 @@ function statusOf(item) {
   const status2 = item.fields?.["status"];
   return typeof status2 === "string" && status2 !== "" ? status2 : null;
 }
+function sessionsOf(item) {
+  const listed = item.fields?.["sessions"];
+  if (!Array.isArray(listed)) return [];
+  const ids = listed.filter(
+    (s) => typeof s === "string" && s !== ""
+  );
+  return [...new Set(ids)];
+}
 function rowOf(dir, item) {
   const base = posix3.basename(item.rel, ".md");
   const date = /^(\d{4}-\d{2}-\d{2})-/.exec(base)?.[1] ?? null;
   const number = date === null ? documentNumber(item.rel) : null;
+  const sessions = sessionsOf(item);
   return {
     id: date ?? number ?? base,
     title: documentTitle(item.title ?? base, number),
     status: statusOf(item),
-    path: `${dir}/${item.rel}`
+    path: `${dir}/${item.rel}`,
+    ...sessions.length > 0 ? { sessions } : {}
   };
 }
 function newestFirst(a, b) {
@@ -1399,7 +1409,8 @@ function desiredOf(tabs, org) {
       body: headerOf(row.path, org),
       status: statusOf2(row.status),
       type: tab.label,
-      statusField: fields2.get(tab.label)?.name ?? null
+      statusField: fields2.get(tab.label)?.name ?? null,
+      sessions: row.sessions?.join(", ") ?? null
     }))
   );
 }
@@ -2488,6 +2499,7 @@ var GitHubBoards = class {
     const agent = await single("Agent", "Agent", [WORKING]);
     const session = await text("Session");
     const path = await text("Path");
+    const sessions = await text("Sessions");
     const current = await views(cache.projectId, this.#o);
     const first = current[0];
     if (first !== void 0 && first.name === DEFAULT_VIEW && !current.some((v) => v.name === ALL_VIEW)) {
@@ -2556,7 +2568,15 @@ var GitHubBoards = class {
       await linkRepository(cache.projectId, memory.id, this.#o);
       added.push(`link ${repository2}`);
     }
-    cache.fields = [status2, collection, ...own.values(), agent, session, path];
+    cache.fields = [
+      status2,
+      collection,
+      ...own.values(),
+      agent,
+      session,
+      path,
+      sessions
+    ];
     return added;
   }
   async items(board, options = {}) {
@@ -2581,7 +2601,8 @@ var GitHubBoards = class {
         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
+        session: r.values["Session"] ?? null,
+        sessions: r.values["Sessions"] ?? null
       };
     });
   }
@@ -2695,7 +2716,8 @@ var GitHubBoards = class {
       ["Path", want.path],
       [COLLECTION_FIELD, want.type],
       [STATUS_FIELD, want.status],
-      ...want.statusField === null ? [] : [[want.statusField, want.status]]
+      ...want.statusField === null ? [] : [[want.statusField, want.status]],
+      ["Sessions", want.sessions]
     ];
     for (const [name, value] of wanted)
       if ((values2[name] ?? null) !== value)
@@ -3473,6 +3495,8 @@ Writing:
   \`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\`.
+- Add \`\${CLAUDE_SESSION_ID}\` at the end of \`sessions:\` in the front matter,
+  unless it is already there.
 - 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
@@ -3510,6 +3534,8 @@ Writing:
 - 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.
+- Add \`\${CLAUDE_SESSION_ID}\` at the end of \`sessions:\` in the front matter,
+  unless it is already there.
 - 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
@@ -3550,6 +3576,8 @@ Writing:
   repository has one.
 - Where the plan decides something the specification leaves open, a
   section says so.
+- Add \`\${CLAUDE_SESSION_ID}\` at the end of \`sessions:\` in the front matter,
+  unless it is already there.
 - 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
@@ -3579,6 +3607,8 @@ Arguments: \`$ARGUMENTS\`.
      ran, what it showed, what could not run and why;
    - the specification: \`Implemented\` once every plan of it is
      \`Completed\`; \`updated\` today;
+   - the plan and the specification: add \`\${CLAUDE_SESSION_ID}\` at the end
+     of \`sessions:\` in their front matter, unless it is already there;
    - 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
@@ -7643,7 +7673,7 @@ async function writeOpened(file, opened) {
 }
 
 // src/pulse/plan.ts
-var differs = (item, w) => item.title !== w.title || item.status !== w.status || w.statusField !== null && item.collectionStatus !== w.status || item.type !== w.type;
+var differs = (item, w) => item.title !== w.title || item.status !== w.status || w.statusField !== null && item.collectionStatus !== w.status || item.type !== w.type || item.sessions !== w.sessions;
 var 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 };
@@ -8029,13 +8059,16 @@ async function mark(opts) {
     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 documents2 = new Map(
+    (await statusTabs(c.rnessDir)).flatMap(
+      (t) => t.rows.map((r) => [r.path, r.status])
+    )
   );
-  const onBoard = new Set(
-    items.flatMap((i) => i.path === null ? [] : [i.path])
+  const onBoard = new Map(
+    items.flatMap((i) => i.path === null ? [] : [[i.path, i.status]])
   );
-  if ([...wanted].some((p) => documents2.has(p) && !onBoard.has(p))) {
+  const stale = (path) => documents2.has(path) && (!onBoard.has(path) || onBoard.get(path) !== documents2.get(path));
+  if ([...wanted].some(stale)) {
     const synced = await oneSyncAtATime(
       key,
       () => syncBoard(c, board, plainUi, eachAdded),
@@ -8561,4 +8594,4 @@ export {
   OWN_COMMANDS,
   catchUp
 };
-//# sourceMappingURL=chunk-AXTFDXN2.js.map
+//# sourceMappingURL=chunk-HGT7BIWK.js.map