@rness/cli 0.17.0 → 0.17.2

package/README.md

@@ -114,7 +114,8 @@ the files a given agent needs, for the agents the team declares in
   it asks, one question at a time. The skill stays in the conversation for
   the next turns, and the file carries the work to the next session
   (`/rness:adr 0010` reopens it). The agent may start one itself — an ADR
-  when a choice is expensive to reverse — but writes nothing without a yes.
+  when a choice is expensive to reverse — but writes nothing without a yes,
+  except `/rness:done` on a plan whose last task has just passed.
   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
@@ -122,7 +123,13 @@ the files a given agent needs, for the agents the team declares in
   `{ id: <session id>, agent: <model> }` to `sessions:` in the front matter
   of what it writes or closes. The agent is the model it runs as, as Claude
   Code names it (`Claude Opus 5.5`): no variable gives it to a skill. An
-  edit made without a skill leaves none. No skill commits.
+  edit made without a skill leaves none. The agent moves a status with the
+  work (a plan `In progress`, then `Completed`; a specification
+  `Implemented`) and whenever the developer says so; accepting an ADR or
+  approving a specification stays the developer's unless they asked it to
+  go ahead. Each skill ends in a commit of the files the agent alone
+  changed, added by name; a file someone else changed too is left
+  uncommitted and named. No skill pushes.
 - 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
@@ -388,7 +395,7 @@ repository, the board).
   `"projects": { "pulse": <number> }`; both at once are refused.
 - 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.17.0 (supported:
+  `provider "gitlab" is not supported by @rness/cli 0.17.1 (supported:
 github)`. `add`, `sync` and the local commands never refuse. `null` is not a
   value: an absent key means none.
 
@@ -565,6 +572,33 @@ 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.17.2 — the lifecycle skills move statuses and commit their files
+
+- `/rness:adr`, `/rness:spec`, `/rness:plan` and `/rness:done` let the
+  agent move a status as the work does — a plan `In progress` as its tasks
+  start, `Completed` once they pass, a specification `Implemented` with its
+  last plan — and whenever the developer says so. Accepting an ADR or
+  approving a specification stays the developer's unless they asked the
+  agent to go ahead. `/rness:done` closes a plan whose last task has just
+  passed without asking first.
+- Each of them ends in a commit of the files the agent alone changed, in
+  their repository, added by name. A file that had uncommitted changes
+  before the agent's first edit, or that someone else changed since, is
+  left out and named. Nothing is pushed. Until now they committed nothing,
+  which left their files for someone else to find.
+- `rness upgrade` rewrites the four skills under `.claude/skills/rness/`;
+  commit them in each repository, as its next steps list.
+
+## 0.17.1 — pulse shows it is at work
+
+- `pulse create` and `pulse sync` show a transient line while they write a
+  project's items and bodies: each item is a few requests, one at a time,
+  and 34 cards took minutes with nothing on screen.
+- A collection's label is made only when a document carries it: a
+  directory with no card (`assets/`) is no label.
+- `pulse create <collection>` says `linked Marketing to <org>/.rness`, not
+  `Agent Pulse`.
+
 ## 0.17.0 — a collection on its own GitHub Project
 
 - `rness pulse create <collection>` gives a collection of `.rness/` a

package/dist/bin/rness.js

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

package/dist/{chunk-X52SHBRY.js → chunk-REDELHNC.js}

@@ -508,7 +508,7 @@ function parseRepoSpec(spec, org, host) {
 }
 
 // src/version.ts
-var VERSION = "0.17.0";
+var VERSION = "0.17.2";
 
 // src/core/pm.ts
 import { execFile as execFile2 } from "child_process";
@@ -1642,7 +1642,9 @@ function layoutOf(tabs, own) {
         ...want.map((w) => w.values[f.name]).filter((v) => typeof v === "string")
       ]) : []
     })),
-    labels: once(want.flatMap((w) => [...w.labels, ...w.unlabels]))
+    // Made only when a document carries it: a directory with no card is no
+    // label, though one carrying it once is taken off (`unlabels`).
+    labels: once(want.flatMap((w) => w.labels))
   };
 }
 var sessionsOf2 = (row) => row.sessions?.map((e) => e.agent === void 0 ? e.id : `${e.agent} \xB7 ${e.id}`).join(", ") ?? null;
@@ -4343,6 +4345,17 @@ then \`npx @rness/cli status\` (q to close), then \`fg\`; or in another
 terminal, from the workspace's \`.rness/\`: \`${localRunner(pm)} rness status\`._
 `;
 }
+var STATUS_RULE = `Move a status yourself when the work calls for it, and whenever the
+developer says so: a plan \`In progress\` as you start its tasks,
+\`Completed\` once they pass; a specification \`Implemented\` with its last
+plan; a document \`Superseded\` by the one that replaces it. Accepting a
+decision \u2014 an ADR \`Accepted\`, a specification \`Approved\` \u2014 is the
+developer's, unless they asked you to go ahead with the work.`;
+var COMMIT_RULE = `Commit each file you changed, in its own repository, and only the files
+you alone changed: add them by name, never \`git add -A\` nor \`commit -a\`.
+A file that had uncommitted changes before your first edit (\`git status\`
+tells you), or that someone else changed since, stays uncommitted: say
+which. Never push.`;
 var LIFECYCLE2 = [
   {
     name: "adr",
@@ -4379,9 +4392,12 @@ Writing:
   \`Claude\`: for example \`Claude Opus 5.5\`.
 - 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.
+After writing: give the path and the Decision section. The ADR stays
+\`Proposed\` until it is accepted.
+
+${STATUS_RULE}
+
+${COMMIT_RULE}
 `
   },
   {
@@ -4420,9 +4436,13 @@ Writing:
   \`Claude\`: for example \`Claude Opus 5.5\`.
 - 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.
+After writing: give the path and the summary. It starts \`Draft\`:
+\`Proposed\` for review, \`Approved\` to plan it. No plan here:
+\`/rness:plan NNNN\` once approved.
+
+${STATUS_RULE}
+
+${COMMIT_RULE}
 `
   },
   {
@@ -4464,8 +4484,13 @@ Writing:
   \`Claude\`: for example \`Claude Opus 5.5\`.
 - 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.
+After writing: give the path and the list of tasks. It starts \`Draft\`, and
+becomes \`Ready\` once the developer agrees with it or asks you to carry it
+out.
+
+${STATUS_RULE}
+
+${COMMIT_RULE}
 `
   },
   {
@@ -4479,8 +4504,9 @@ 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.
+2. The developer asked to close it, or its last task has just passed in
+   this session: close it. Otherwise 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
@@ -4502,7 +4528,9 @@ Arguments: \`$ARGUMENTS\`.
    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.
+After: list the files changed and the statuses moved.
+
+${COMMIT_RULE}
 `
   }
 ];
@@ -8695,7 +8723,7 @@ var eachAdded = (ui, added) => {
     if (a.startsWith("renamed ")) ui.line("renamed", a.slice("renamed ".length));
     else ui.line("added", a);
 };
-var createdByKind = (ui, added) => {
+var createdByKind = (ui, added, project) => {
   for (const kind of ["field", "option", "view"]) {
     const names = added.filter((a) => a.startsWith(`${kind} `)).map((a) => a.slice(kind.length + 1));
     if (names.length > 0) ui.line("created", `${kind}s ${names.join(", ")}`);
@@ -8703,9 +8731,13 @@ var createdByKind = (ui, added) => {
   for (const a of added) {
     if (a.startsWith("label ")) ui.line("created", a);
     else if (a.startsWith("link "))
-      ui.line("linked", `Agent Pulse to ${a.slice("link ".length)}`);
+      ui.line("linked", `${project} to ${a.slice("link ".length)}`);
   }
 };
+async function working(ui, doing, count3, work) {
+  if (count3 === 0) return work();
+  await ui.step({ doing, quiet: true }, work, () => null);
+}
 async function filesOf2(rnessDir) {
   const files = /* @__PURE__ */ new Set();
   const walk = async (rel) => {
@@ -8761,7 +8793,11 @@ function sayDone(ui, org, documents2, steps, writes, adopted, on) {
 async function syncBoard(c, board, ui, sayLayout, scope) {
   await fromGithub(c.provider.checkIssues(c.org));
   const { want } = scope;
-  sayLayout(ui, await fromGithub(c.provider.ensureLayout(board, scope.layout)));
+  sayLayout(
+    ui,
+    await fromGithub(c.provider.ensureLayout(board, scope.layout)),
+    scope.label
+  );
   const have = await fromGithub(c.provider.items(board));
   const record = await openedFile(c.rnessDir);
   const all = await readOpened(record);
@@ -8781,17 +8817,24 @@ async function syncBoard(c, board, ui, sayLayout, scope) {
     const created = /* @__PURE__ */ new Map();
     const closed = /* @__PURE__ */ new Set();
     try {
-      for (const step2 of steps) {
-        const p = await fromGithub(c.provider.apply(board, step2));
-        if (p !== null && (step2.kind === "create" || step2.kind === "convert"))
-          placed.set(step2.want.path, p);
-        if (p?.adopted === true) adopted++;
-        else if (p !== null && step2.kind === "create")
-          created.set(step2.want.path, p);
-        if (step2.kind === "close" || step2.kind === "archive")
-          closed.add(step2.id);
-        if (step2.kind !== "unchanged") made++;
-      }
+      await working(
+        ui,
+        `writing  ${plural(changes)} on ${scope.label}`,
+        changes,
+        async () => {
+          for (const step2 of steps) {
+            const p = await fromGithub(c.provider.apply(board, step2));
+            if (p !== null && (step2.kind === "create" || step2.kind === "convert"))
+              placed.set(step2.want.path, p);
+            if (p?.adopted === true) adopted++;
+            else if (p !== null && step2.kind === "create")
+              created.set(step2.want.path, p);
+            if (step2.kind === "close" || step2.kind === "archive")
+              closed.add(step2.id);
+            if (step2.kind !== "unchanged") made++;
+          }
+        }
+      );
     } finally {
       await writeOpened(
         record,
@@ -8817,10 +8860,17 @@ async function syncBoard(c, board, ui, sayLayout, scope) {
         })
       );
     writes = planBodies(bodies, issued);
-    for (const step2 of writes) {
-      await fromGithub(c.provider.apply(board, step2));
-      made++;
-    }
+    await working(
+      ui,
+      `writing  ${plural(writes.length)} bodies on ${scope.label}`,
+      writes.length,
+      async () => {
+        for (const step2 of writes) {
+          await fromGithub(c.provider.apply(board, step2));
+          made++;
+        }
+      }
+    );
   } catch (e) {
     if (!(e instanceof RateLimitError)) throw e;
     const total = changes + writes.length;
@@ -9555,4 +9605,4 @@ export {
   OWN_COMMANDS,
   catchUp
 };
-//# sourceMappingURL=chunk-X52SHBRY.js.map
+//# sourceMappingURL=chunk-REDELHNC.js.map