@rness/cli 0.13.0 → 0.14.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +50 -11
- package/dist/bin/rness.js +1 -1
- package/dist/{chunk-4VTYSPZW.js → chunk-AXTFDXN2.js} +566 -386
- package/dist/chunk-AXTFDXN2.js.map +1 -0
- package/dist/index.js +1 -1
- package/package.json +1 -1
- package/dist/chunk-4VTYSPZW.js.map +0 -1
package/README.md
CHANGED
|
@@ -60,11 +60,15 @@ when dropped, red `?` when missing.
|
|
|
60
60
|
screen back. Read-only.
|
|
61
61
|
- Off a terminal — a pipe, CI, an agent's tool — Markdown: a table per tab.
|
|
62
62
|
- From Claude Code, `/rness:status [tab]` shows those tables (see "Agent
|
|
63
|
-
targets").
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
(
|
|
63
|
+
targets"). Nothing started from inside Claude Code gets the terminal, so
|
|
64
|
+
the view cannot open from there (verified with Claude Code 2.1.284 on
|
|
65
|
+
2026-09-29). Two ways to reach it, and the skill ends with both: in the
|
|
66
|
+
same terminal, `Ctrl+Z` suspends Claude Code, run `npx @rness/cli status`
|
|
67
|
+
(or `rness status` with a global install), `q`, then `fg` resumes it
|
|
68
|
+
(Unix only); or in another terminal, from the workspace's `.rness/`, with
|
|
69
|
+
the manager it installs with — `pnpm rness status`, `npx rness status`,
|
|
70
|
+
`yarn rness status` or `bunx rness status` — which runs the pinned copy
|
|
71
|
+
without the network (verified with each manager on 2026-09-30).
|
|
68
72
|
|
|
69
73
|
### Agent targets
|
|
70
74
|
|
|
@@ -91,11 +95,30 @@ the files a given agent needs, for the agents the team declares in
|
|
|
91
95
|
which registers the MCP server; see "MCP server". The same settings file
|
|
92
96
|
carries three hooks, and so does `.claude/settings.json` at the workspace
|
|
93
97
|
root, which `sync` writes on every machine; see "Hooks". Both places also
|
|
94
|
-
get a Claude Code plugin, `.claude/skills/rness/`, with
|
|
95
|
-
`/rness:status [tab]`, the tables of `rness status
|
|
96
|
-
files whole — an edit by hand is reported
|
|
97
|
-
|
|
98
|
-
|
|
98
|
+
get a Claude Code plugin, `.claude/skills/rness/`, with five commands:
|
|
99
|
+
`/rness:status [tab]`, the tables of `rness status`, and the lifecycle
|
|
100
|
+
skills below. rness owns those files whole — an edit by hand is reported
|
|
101
|
+
by `sync --check` and written back by `sync`. Nothing in them depends on
|
|
102
|
+
the version; the last line of the status skill names the workspace's
|
|
103
|
+
package manager, so changing `packageManager` in `.rness/package.json`
|
|
104
|
+
leaves it stale until the next `sync`. Claude Code loads the plugin once
|
|
105
|
+
the folder is trusted, in a session started there.
|
|
106
|
+
- **The lifecycle skills**: `/rness:adr [subject | NNNN]` records a decision
|
|
107
|
+
as an ADR, `/rness:spec [subject | NNNN]` writes a specification,
|
|
108
|
+
`/rness:plan <spec>` turns an approved specification into a plan, and
|
|
109
|
+
`/rness:done [plan]` closes a piece of work — each task checked on
|
|
110
|
+
evidence, then the plan `Completed`, its specification `Implemented`, and
|
|
111
|
+
the documents the work made inaccurate corrected. Each is a procedure
|
|
112
|
+
loaded into the conversation, not a file generator: after a decision has
|
|
113
|
+
been discussed, `/rness:adr` writes it from the conversation; otherwise
|
|
114
|
+
it asks, one question at a time. The skill stays in the conversation for
|
|
115
|
+
the next turns, and the file carries the work to the next session
|
|
116
|
+
(`/rness:adr 0010` reopens it). The agent may start one itself — an ADR
|
|
117
|
+
when a choice is expensive to reverse — but writes nothing without a yes.
|
|
118
|
+
The rules stay in `.rness/CONVENTIONS.md`; the skills only add the steps.
|
|
119
|
+
A new document takes the collection's first status (`Proposed` for an
|
|
120
|
+
ADR, `Draft` otherwise) and the next number of the local checkout; two
|
|
121
|
+
branches can pick the same one. No skill commits.
|
|
99
122
|
- rness owns values, not files: what is missing is added, nothing else is
|
|
100
123
|
touched, and a file it cannot parse is reported, never rewritten.
|
|
101
124
|
`sync --check` and `validate` report a missing value. Removing an agent
|
|
@@ -313,7 +336,7 @@ repository, the board).
|
|
|
313
336
|
`contract`, `provider`, `org`, `agents`, `pulse`, `repos`, `scopes`.
|
|
314
337
|
- A provider _written_ in `rness.json` that this version cannot talk to
|
|
315
338
|
(`gitlab`) is refused by `validate`, `create`, `login` and `pulse`:
|
|
316
|
-
`provider "gitlab" is not supported by @rness/cli 0.
|
|
339
|
+
`provider "gitlab" is not supported by @rness/cli 0.14.0 (supported:
|
|
317
340
|
github)`. `add`, `sync` and the local commands never refuse. `null` is not a
|
|
318
341
|
value: an absent key means none.
|
|
319
342
|
|
|
@@ -490,6 +513,22 @@ per repository, the files to commit there.
|
|
|
490
513
|
Exit codes: 0 success, 1 failure, 2 usage — or a refusal without a TTY.
|
|
491
514
|
`RNESS_DEBUG=1` adds stack traces; `RNESS_NO_DELEGATE=1` skips the delegation.
|
|
492
515
|
|
|
516
|
+
## 0.14.0 — the lifecycle skills; `/rness:status` names a second terminal
|
|
517
|
+
|
|
518
|
+
- The `rness` plugin of Claude Code gains `/rness:adr`, `/rness:spec`,
|
|
519
|
+
`/rness:plan` and `/rness:done`: the workspace's lifecycle as procedures
|
|
520
|
+
the developer or the agent starts, which write nothing without a yes. See
|
|
521
|
+
"Agent targets".
|
|
522
|
+
- `/rness:status` ends with two ways to the full-screen view: `Ctrl+Z` in
|
|
523
|
+
the same terminal, or another terminal from `.rness/` —
|
|
524
|
+
`pnpm rness status`, or the command of the workspace's package manager.
|
|
525
|
+
See "Status".
|
|
526
|
+
- `rness upgrade` syncs, so it writes the four skills and rewrites
|
|
527
|
+
`plugin.json` and the status skill; then commit `.claude/skills/rness/` in
|
|
528
|
+
each repository, as its next steps list. Until then `sync --check` and
|
|
529
|
+
`validate` report them.
|
|
530
|
+
- Blocks are unchanged.
|
|
531
|
+
|
|
493
532
|
## 0.13.0 — Agent Pulse: each document an issue of `.rness`, its content on the card
|
|
494
533
|
|
|
495
534
|
- Each item of Agent Pulse is an issue of `<org>/.rness`, labelled
|