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 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 > API**, then save it:
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 > API).
41
+ login [--token ls_...] Save a personal token (Listspace: Settings > Developers).
42
42
  logout Forget the saved token.
43
- whoami Plan, freedom levels, guidance and boards (alias: account).
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 freedom level decides what is made and what waits in the Inbox)
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 a freedom 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)).
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
 
@@ -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.2.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 > API), or set LISTSPACE_TOKEN.";
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 > API.` };
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 = input.description === null ? { title: input.title } : { title: input.title, description: input.description };
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 > API).
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, freedom levels, guidance and boards (alias: account).
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 freedom level decides what is made and what waits in the Inbox)
840
- new-board <title> [--description <text>] A board from "Project (for agents)".
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 > API): ");
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 > API if it leaked)." : "No saved token." };
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"]);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "listspace",
3
- "version": "0.2.0",
3
+ "version": "0.3.0",
4
4
  "description": "Listspace from the command line: the agentic project memory, for people and coding agents.",
5
5
  "keywords": [
6
6
  "listspace",