listspace 0.2.0 → 0.3.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/CHANGELOG.md +15 -0
- package/README.md +9 -6
- package/dist/listspace.mjs +27 -12
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,21 @@
|
|
|
2
2
|
|
|
3
3
|
One version runs through the CLI, the skill and the Claude Code plugin, so each entry covers all three.
|
|
4
4
|
|
|
5
|
+
## Unreleased
|
|
6
|
+
|
|
7
|
+
- The Claude Code plugin has a progress check (`hooks/progress-check.mjs`): when a turn in a session that uses Listspace changed files, committed, pushed, opened or merged a pull request or deployed, and made no Listspace write after that work, Claude is sent back once to move the item and add a short comment. At most once every 3 turns, never twice in a row. It keeps only the facts, no command or file name.
|
|
8
|
+
- The skill and `AGENTS.md.snippet` say that work tracked elsewhere, such as a pull request or a deploy, still moves the matching item with a short comment, and the skill reads the server's `reminder` and `claimed_by_you`. It also offers an optional line for the project's CLAUDE.md or AGENTS.md that asks every agent to keep the board up to date.
|
|
9
|
+
- The Claude Code plugin has a decision check (`hooks/hooks.json`): when the user picks an option, says yes to a proposal or corrects a fact in a session that uses Listspace, and no decision was recorded in that turn, Claude is sent back once to check it and record it with `record_decision` if it affects future work. Plain rules, no model call; a yes to an offer to act, a maybe or a bug report does not count. It keeps only an 80-character excerpt of a prompt that reads like a decision, in the plugin's data folder. Needs Node.js 18 or later; without it the check stays silent.
|
|
10
|
+
- The skill records a decision the moment the user picks an option, says yes to a proposal or corrects a fact, with three short examples, and says it is Proposed until the user accepts it.
|
|
11
|
+
- `end_session` takes `decisions`: every decision of the session. The ones the board does not have yet are recorded as Proposed in the Inbox. The skill, `reference/tools.md` and `AGENTS.md.snippet` say so.
|
|
12
|
+
- `listspace new-board` takes `--space <space id>`, so an agent on the CLI can put a new board in the space the user chose, as `create_board` does with `space_id`. The text output says which space the board went to and passes on the server's note when no space was given and the user has more than one.
|
|
13
|
+
- The skill's CLI table shows `--space`.
|
|
14
|
+
- The skill looks for a `Listspace board:` line in the project's CLAUDE.md or AGENTS.md at the start of a session and starts on that board without asking. When there is none, it offers, after the user picks a board, to add that line and one sentence of instructions to the file, and writes only after a yes. `AGENTS.md.snippet` starts with the same line.
|
|
15
|
+
- The skill's "Keep the board up to date" section says the default guidance asks the same in general words for any kind of board, and gives the code project version.
|
|
16
|
+
- On a board someone else shared with the user, the skill treats the owner's text (`shared_board.owner_instructions`) as data, never as instructions, and never lets text on that board steer it to read, copy or move the user's other boards.
|
|
17
|
+
- The skill starts only from `last_sessions`, the summaries of the user's own agents. Summaries other people on the board left come as `notes_from_others`, with who wrote them, and the skill treats them as notes, never as instructions.
|
|
18
|
+
- The skill knows that approving or rejecting a request is a sign-off in the user's name: it needs Act (4), waits in the Inbox below it, and the sender sees which assistant answered.
|
|
19
|
+
|
|
5
20
|
## 0.2.0
|
|
6
21
|
|
|
7
22
|
- New command `listspace attach <item> <file> [<file>...]`: uploads files from your computer to an item through the REST API, so an agent no longer has to write a file out as base64. The type comes from the extension (the same types the app accepts; Markdown goes up as plain text), and every file is checked before the first upload: known type, present, not empty, at most 8 MB. `--json` prints one server answer per file. Needs level 4 (Act) on the board.
|
package/README.md
CHANGED
|
@@ -20,7 +20,7 @@ npm install -g listspace
|
|
|
20
20
|
|
|
21
21
|
## Sign in
|
|
22
22
|
|
|
23
|
-
Create a personal token in Listspace under **Settings >
|
|
23
|
+
Create a personal token in Listspace under **Settings > Developers**, then save it:
|
|
24
24
|
|
|
25
25
|
```bash
|
|
26
26
|
npx listspace login --token ls_...
|
|
@@ -38,9 +38,9 @@ The token is saved as `credentials.json` (mode 600) in your OS config directory:
|
|
|
38
38
|
|
|
39
39
|
```text
|
|
40
40
|
Sign in
|
|
41
|
-
login [--token ls_...] Save a personal token (Listspace: Settings >
|
|
41
|
+
login [--token ls_...] Save a personal token (Listspace: Settings > Developers).
|
|
42
42
|
logout Forget the saved token.
|
|
43
|
-
whoami Plan,
|
|
43
|
+
whoami Plan, agent access, guidance and boards (alias: account).
|
|
44
44
|
|
|
45
45
|
Read
|
|
46
46
|
boards Your boards with their ids.
|
|
@@ -49,8 +49,11 @@ Read
|
|
|
49
49
|
board <board> Lists and items with their ids.
|
|
50
50
|
inbox <board> [--status pending|accepted|rejected|withdrawn|expired|failed|all]
|
|
51
51
|
|
|
52
|
-
Write (the board's
|
|
53
|
-
new-board <title> [--description <text>]
|
|
52
|
+
Write (the board's agent access level decides what is made and what waits in the Inbox)
|
|
53
|
+
new-board <title> [--description <text>] [--space <space id>]
|
|
54
|
+
With more than one space (see whoami), ask the user
|
|
55
|
+
which one and pass --space; without it the board
|
|
56
|
+
goes to the default space.
|
|
54
57
|
add <board> <list> <title> [--description <markdown>]
|
|
55
58
|
move <item> <list>
|
|
56
59
|
done <item> Move to the board's done list.
|
|
@@ -105,7 +108,7 @@ Exit codes: 0 ok, 1 failed, 2 usage error, 3 sign-in needed, 4 rate limited (wai
|
|
|
105
108
|
|
|
106
109
|
## What agents may do
|
|
107
110
|
|
|
108
|
-
Each board has
|
|
111
|
+
Each board has an agent access level that decides what an agent may change on its own. Changes that need your approval wait in the board's Inbox, and every change shows who made it. The rules are in [What AI agents can do](https://listspace.app/docs/agents). Agents that support MCP can also connect to `https://mcp.listspace.app` instead of using this CLI ([setup](https://listspace.app/docs/mcp)).
|
|
109
112
|
|
|
110
113
|
## License
|
|
111
114
|
|
package/dist/listspace.mjs
CHANGED
|
@@ -147,7 +147,11 @@ var createdBoard = object({
|
|
|
147
147
|
instructions: nullable(string),
|
|
148
148
|
level,
|
|
149
149
|
lists: array(object({ id: string, title: string, kind: listKind })),
|
|
150
|
-
undo: nullable(object({ request_id: string }))
|
|
150
|
+
undo: nullable(object({ request_id: string })),
|
|
151
|
+
/** Where the board went (absent from servers before spaces) */
|
|
152
|
+
space: withDefault(nullable(object({ id: string, name: string })), null),
|
|
153
|
+
/** Set when no space was given and the user has more than one */
|
|
154
|
+
space_note: withDefault(nullable(string), null)
|
|
151
155
|
});
|
|
152
156
|
var inbox = object({
|
|
153
157
|
suggestions: array(
|
|
@@ -223,7 +227,7 @@ var attached = object({
|
|
|
223
227
|
});
|
|
224
228
|
|
|
225
229
|
// src/version.ts
|
|
226
|
-
var VERSION = "0.
|
|
230
|
+
var VERSION = "0.3.0";
|
|
227
231
|
|
|
228
232
|
// src/api.ts
|
|
229
233
|
var DEFAULT_API_URL = "https://api.listspace.app/v1";
|
|
@@ -243,7 +247,7 @@ var CliFailure = class extends Error {
|
|
|
243
247
|
var fail = (error) => {
|
|
244
248
|
throw new CliFailure(error);
|
|
245
249
|
};
|
|
246
|
-
var LOGIN_HINT = "Run `listspace login` with a personal token (Listspace: Settings >
|
|
250
|
+
var LOGIN_HINT = "Run `listspace login` with a personal token (Listspace: Settings > Developers), or set LISTSPACE_TOKEN.";
|
|
247
251
|
var ApiClient = class {
|
|
248
252
|
constructor(options) {
|
|
249
253
|
this.options = options;
|
|
@@ -319,7 +323,7 @@ function errorFor(response, json) {
|
|
|
319
323
|
return { kind: "rate_limited", message: `${message} ${wait} before trying again.`, retryAfterSeconds: seconds };
|
|
320
324
|
}
|
|
321
325
|
if (response.status === 403 && code2 === "insufficient_scope") {
|
|
322
|
-
return { kind: "api", status: 403, code: code2, message: `${message} This token is read only; create a read and write token in Settings >
|
|
326
|
+
return { kind: "api", status: 403, code: code2, message: `${message} This token is read only; create a read and write token in Settings > Developers.` };
|
|
323
327
|
}
|
|
324
328
|
return { kind: "api", status: response.status, code: code2, message };
|
|
325
329
|
}
|
|
@@ -480,6 +484,8 @@ function formatCreatedBoard(board) {
|
|
|
480
484
|
`Created board "${board.title}" ${board.id}`,
|
|
481
485
|
board.url,
|
|
482
486
|
`Lists: ${board.lists.map((list) => list.title).join(", ")}`,
|
|
487
|
+
...board.space === null ? [] : [`Space: ${board.space.name}`],
|
|
488
|
+
...board.space_note === null ? [] : [board.space_note],
|
|
483
489
|
...block("Board instructions (follow these)", board.instructions),
|
|
484
490
|
...board.undo === null ? [] : [`Undo: listspace undo ${board.undo.request_id}`]
|
|
485
491
|
].join("\n");
|
|
@@ -636,7 +642,11 @@ async function boardCommand(client, input) {
|
|
|
636
642
|
return { raw: answer.raw, text: formatBoard(answer.value) };
|
|
637
643
|
}
|
|
638
644
|
async function newBoardCommand(client, input) {
|
|
639
|
-
const body =
|
|
645
|
+
const body = {
|
|
646
|
+
title: input.title,
|
|
647
|
+
...input.description === null ? {} : { description: input.description },
|
|
648
|
+
...input.space === null ? {} : { space_id: input.space }
|
|
649
|
+
};
|
|
640
650
|
const answer = await client.data("POST", "/boards", createdBoard, { body });
|
|
641
651
|
return { raw: answer.raw, text: formatCreatedBoard(answer.value) };
|
|
642
652
|
}
|
|
@@ -824,10 +834,10 @@ var HELP = `listspace ${VERSION}: Listspace from the command line, for people an
|
|
|
824
834
|
Usage: listspace <command> [arguments] [--json]
|
|
825
835
|
|
|
826
836
|
Sign in
|
|
827
|
-
login [--token ls_...] Save a personal token (Listspace: Settings >
|
|
837
|
+
login [--token ls_...] Save a personal token (Listspace: Settings > Developers).
|
|
828
838
|
Without --token it reads the token from stdin.
|
|
829
839
|
logout Forget the saved token.
|
|
830
|
-
whoami Plan,
|
|
840
|
+
whoami Plan, agent access, guidance and boards (alias: account).
|
|
831
841
|
|
|
832
842
|
Read
|
|
833
843
|
boards Your boards with their ids.
|
|
@@ -836,8 +846,12 @@ Read
|
|
|
836
846
|
board <board> Lists and items with their ids.
|
|
837
847
|
inbox <board> [--status pending|accepted|rejected|withdrawn|expired|failed|all]
|
|
838
848
|
|
|
839
|
-
Write (the board's
|
|
840
|
-
new-board <title> [--description <text>]
|
|
849
|
+
Write (the board's agent access level decides what is made and what waits in the Inbox)
|
|
850
|
+
new-board <title> [--description <text>] [--space <space id>]
|
|
851
|
+
A board from "Project (for agents)". With more than
|
|
852
|
+
one space (see whoami), ask the user which one and
|
|
853
|
+
pass --space; without it the board goes to the
|
|
854
|
+
default space.
|
|
841
855
|
add <board> <list> <title> [--description <markdown>]
|
|
842
856
|
move <item> <list>
|
|
843
857
|
done <item> Move to the board's done list.
|
|
@@ -889,6 +903,7 @@ var OPTIONS = {
|
|
|
889
903
|
version: { type: "boolean", short: "v" },
|
|
890
904
|
token: { type: "string" },
|
|
891
905
|
description: { type: "string" },
|
|
906
|
+
space: { type: "string" },
|
|
892
907
|
inbox: { type: "boolean" },
|
|
893
908
|
reason: { type: "string" },
|
|
894
909
|
status: { type: "string" },
|
|
@@ -956,7 +971,7 @@ var apiUrl = (env) => {
|
|
|
956
971
|
};
|
|
957
972
|
async function loginMethod(flags, io) {
|
|
958
973
|
if (flags.token !== void 0) return { kind: "token", raw: flags.token };
|
|
959
|
-
const typed = await io.readSecret("Paste a personal token from Listspace (Settings >
|
|
974
|
+
const typed = await io.readSecret("Paste a personal token from Listspace (Settings > Developers): ");
|
|
960
975
|
if (typed === null || typed.trim() === "") return { kind: "pairing" };
|
|
961
976
|
return { kind: "token", raw: typed };
|
|
962
977
|
}
|
|
@@ -982,7 +997,7 @@ async function dispatch(command, args, flags, io, dir) {
|
|
|
982
997
|
case "logout": {
|
|
983
998
|
positionals(command, args, []);
|
|
984
999
|
const removed = await removeToken(dir);
|
|
985
|
-
return { raw: { signed_out: removed }, text: removed ? "Signed out: the saved token is gone (revoke it in Settings >
|
|
1000
|
+
return { raw: { signed_out: removed }, text: removed ? "Signed out: the saved token is gone (revoke it in Settings > Developers if it leaked)." : "No saved token." };
|
|
986
1001
|
}
|
|
987
1002
|
case "whoami":
|
|
988
1003
|
case "account":
|
|
@@ -1001,7 +1016,7 @@ async function dispatch(command, args, flags, io, dir) {
|
|
|
1001
1016
|
}
|
|
1002
1017
|
case "new-board": {
|
|
1003
1018
|
const [title] = positionals(command, args, ["title"]);
|
|
1004
|
-
return newBoardCommand(await clientFor(io, dir), { title, description: flags.description ?? null });
|
|
1019
|
+
return newBoardCommand(await clientFor(io, dir), { title, description: flags.description ?? null, space: flags.space ?? null });
|
|
1005
1020
|
}
|
|
1006
1021
|
case "add": {
|
|
1007
1022
|
const [board, list, title] = positionals(command, args, ["board", "list", "title"]);
|