@loopable/mcp 0.4.1 → 0.4.2

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 CHANGED
@@ -76,7 +76,7 @@ gets this server, and most of them do not have a token.
76
76
  | `revise` | correct an item's title or body |
77
77
  | `link_items` | say one item blocks another |
78
78
  | `write_brief` | the spec of one item — the ask, the acceptance criteria, what is out of scope. Written directly on a studio token, proposed on any other |
79
- | `report_progress` | move an item to any status — todo / ready / in_progress / in_review / verifying / done / blocked / awaiting_input / dropped — on your own judgement; the trail names you and the token. `ready` still needs the item to have nothing missing |
79
+ | `report_progress` | move an item to any status — todo / ready / in_progress / in_review / verifying / done / blocked / awaiting_input / dropped — on your own judgement; the trail names you and the token. `ready_blockers` reports what is missing; it never refuses a move |
80
80
  | `open_session` | say you have started on an item — opens the live record of this piece of work |
81
81
  | `post_activity` | one line into an open session: thought, action, question, result or error |
82
82
  | `close_session` | end it — `error` takes a summary; `complete` is a claim and carries its evidence (brief revision, HEAD sha, verdict, every criterion, screenshots, cost, and optionally the pull request url — open it first, because a closed session is never updated again), and moves the item to `in_review` |
@@ -142,11 +142,11 @@ open the session — and until it lands, doing it by hand in that order is the
142
142
  same thing.
143
143
 
144
144
  `ready_blockers` is the one field to read before anything else. A non-empty
145
- list means nobody has groomed the item — no brief has been written, there is
146
- no criterion carrying a verify method, or the project has no registered
147
- environment — and it is not work to pick up yet. It is judged when you read a
148
- `todo` or `ready` item, not only when the clock last groomed it, and while it
149
- is not empty no agent token may move the item to `ready`.
145
+ list is a report on the item — no brief has been written, there is no
146
+ criterion carrying a verify method, or a browser or http criterion has no
147
+ registered environment. It is judged when you read a `todo` or `ready` item,
148
+ not only when the clock last groomed it. Nothing refuses a state edge or a
149
+ start because of it: say what is missing, and start anyway if you decide to.
150
150
 
151
151
  ## Which kind
152
152
 
package/lib/tools.mjs CHANGED
@@ -623,7 +623,9 @@ export const TOOLS = [
623
623
  'criteria with how each will be checked, what is around it in the graph ' +
624
624
  'BY TITLE, the standing decisions that govern it, the registered ' +
625
625
  'environments to point at, and `ready_blockers` — which, if it is not ' +
626
- 'empty, means the item is not groomed and is not work to pick up yet. ' +
626
+ 'empty, says what is missing from it (no brief, no criterion with a ' +
627
+ 'verify method, no environment for a browser or http criterion) — a ' +
628
+ 'report, never a bar: nothing refuses a start for it. ' +
627
629
  'Prefer this over get_item plus neighbourhood plus list_decisions: it is ' +
628
630
  'the same reads, assembled once and capped. `truncated` with `trimmed` ' +
629
631
  'says what was cut to make it fit — the neighbourhood goes first, the ' +
@@ -651,9 +653,8 @@ export const TOOLS = [
651
653
  description:
652
654
  'What to pick up next: the oldest `ready` item nobody has an open ' +
653
655
  'session on, as the same pack pull_item returns. `ready` means a person ' +
654
- 'or a grooming pass judged it startable — criteria somebody can act on, ' +
655
- 'and somewhere to run them — so an item this hands back needs no ' +
656
- 'further check before starting. `null` is an ordinary answer and not an ' +
656
+ 'or a grooming pass said it was startable; read its `ready_blockers` ' +
657
+ 'all the same. `null` is an ordinary answer and not an ' +
657
658
  'error: it means everything is either not ready or already being ' +
658
659
  'worked. IT DOES NOT CLAIM THE ITEM. Two harnesses asking at the same ' +
659
660
  'moment are told the same thing; claiming is open_session, and ' +
@@ -1121,8 +1122,8 @@ export const TOOLS = [
1121
1122
  /*
1122
1123
  * EVERY STATUS IS OFFERED (410). A studio token takes any edge a studio
1123
1124
  * person takes, `done` and `dropped` included, and the trail names the
1124
- * person and the token for each move. The one condition that remains is
1125
- * a token's `ready` meeting readiness (380).
1125
+ * person and the token for each move. Readiness is no condition (411):
1126
+ * `ready_blockers` is read on the item, never enforced.
1126
1127
  */
1127
1128
  description:
1128
1129
  'Move a work item to any status: todo, ready, in_progress, in_review, ' +
@@ -1135,8 +1136,8 @@ export const TOOLS = [
1135
1136
  'person and this token, and that record is the control. Say blocked ' +
1136
1137
  'when something outside the item is stopping you and awaiting_input ' +
1137
1138
  'when you need an answer — both beat leaving the item claiming work is ' +
1138
- 'happening. ready is refused while get_item shows ready_blockers: write ' +
1139
- 'what is missing first. To change what an item SAYS rather than where ' +
1139
+ 'happening. ready is never refused for ready_blockers: they are what get_item ' +
1140
+ 'reports is missing, so say what you decided. To change what an item SAYS rather than where ' +
1140
1141
  'it is, use revise.',
1141
1142
  input: {
1142
1143
  type: 'object',
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@loopable/mcp",
3
- "version": "0.4.1",
3
+ "version": "0.4.2",
4
4
  "description": "The Loopable MCP server: an agent reads the backlog it is meant to build, proposes work, asks the studio a question, and says when it is done.",
5
5
  "license": "MIT",
6
6
  "homepage": "https://loopable.ai",