@anyforge/mcp-server 3.16.0 → 3.18.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 +25 -5
- package/dist/index.js +9 -9
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -189,6 +189,9 @@ complete capability and local/remote workspace boundary.
|
|
|
189
189
|
| `anyforge_update_program` | write | Update a program's name / status / owner / lead / long-lived flag / target date / coverage goal / tags / change freezes |
|
|
190
190
|
| `anyforge_set_program_status_line` | write | Write or clear a program's status line, shown on a report's program status board |
|
|
191
191
|
| `anyforge_set_program_request_intake` | write | Turn a program's incoming requests on (creates its Incoming Requests initiative) or off |
|
|
192
|
+
| `anyforge_get_program_access` | read | Who may read a program (`GET /programs/{id}/access`): visibility, reader people and teams, the access `revision`, `capacityVisibility`, `canManage` |
|
|
193
|
+
| `anyforge_set_program_access` | write | Replace a program's visibility and reader lists (`PUT /programs/{id}/access`) under `ifRevision` = the access revision; opening a private program is refused (`declassification_unconfirmed`) until a person confirms and you send `confirmDeclassify: true` |
|
|
194
|
+
| `anyforge_set_program_capacity_visibility` | write | Set how a program's time shows outside it (`PATCH /programs/{id}/access`, `restricted` or `unavailable`) |
|
|
192
195
|
| `anyforge_delete_program` | write | Delete a program; `deleteChildren: true` also deletes child initiatives + work items (else they're detached) |
|
|
193
196
|
| `anyforge_set_program_milestones` | write | Set a program's milestones/waves and the initiatives assigned to each (whole-array replace; an initiative sits in at most one wave) |
|
|
194
197
|
| `anyforge_get_program_rollup` | read | Read a program's rolled-up progress, initiative/work-item counts, token budget/spend, and risks — the console program header numbers |
|
|
@@ -206,8 +209,11 @@ complete capability and local/remote workspace boundary.
|
|
|
206
209
|
| `anyforge_publish_initiative_spec` | approve | Publish a pending submission (`submissionId`) as the active spec, exactly as submitted, once the person has read it and asked for it. Only over the hosted MCP (OAuth): a Control API key is refused with `spec_publish_requires_person` |
|
|
207
210
|
| `anyforge_update_initiative` | write | Update a (non-system) initiative — only the fields you pass change, including its owning team (`teamId`); an argument the tool does not declare is refused and nothing is changed |
|
|
208
211
|
| `anyforge_delete_initiative` | write | Delete a DRAFT initiative (archive via update once it's past DRAFT) |
|
|
212
|
+
| `anyforge_get_initiative_status` | read | Read an initiative's Status description — the one current line program reports show beside it |
|
|
213
|
+
| `anyforge_set_initiative_status` | write | Set or clear an initiative's Status description, the same write as Save status in the console (client-visible on shared reports; audited as the key owner) |
|
|
209
214
|
| `anyforge_list_initiative_comments` | read | List an initiative's Discussion comments — the same threaded comments the console shows |
|
|
210
|
-
| `anyforge_post_initiative_comment` | write | Post a Discussion comment on an initiative (reply with `parentId`), into the thread the console renders |
|
|
215
|
+
| `anyforge_post_initiative_comment` | write | Post a Discussion comment on an initiative (reply with `parentId`, pick a section with `anchor`, `mentions`, `clientVisible: true` to share with the client), into the thread the console renders; a reply into a resolved thread is refused |
|
|
216
|
+
| `anyforge_resolve_initiative_comment` | write | Resolve or reopen an initiative Discussion thread, as the console's Resolve and Reopen |
|
|
211
217
|
| `anyforge_list_opportunities` | read | List opportunities in the Discovery (product-planning) layer |
|
|
212
218
|
| `anyforge_create_opportunity` | write | Create an opportunity (bridges raw signals to themed roadmap work). Send `rice` (`reach`, `impact`, `confidence`, `operatorLoad`, `rationale`) in the same call; optional `evidence` is stored on the record |
|
|
213
219
|
| `anyforge_update_opportunity` | write | Edit an opportunity's RICE inputs, `evidence`, stage, theme assignment, or program link (`programId`; `null` unlinks) |
|
|
@@ -252,8 +258,11 @@ complete capability and local/remote workspace boundary.
|
|
|
252
258
|
| `anyforge_update_work_item` | write | Edit, assign, begin, expedite, dispatch, confirm, drop (with optional `droppedReason`), archive, close, or reopen a work item. Each action takes only its own fields: one it does not read is refused (`unsupported_fields`) and nothing is changed. `status` with no action is the plain move to BACKLOG, REFINED or READY (how an item moves back) |
|
|
253
259
|
| `anyforge_retry_work_item` | write | Terminate a work item's crew and dispatch a fresh one on the same branch; recovers missing/phantom crew records from work-item + initiative defaults |
|
|
254
260
|
| `anyforge_list_work_item_comments` | read | List the work item's discussion thread, separate from crew transcripts; every comment carries a boolean `clientVisible`. `since` (ISO 8601 with a time zone, a date, or epoch ms) returns only comments created after it |
|
|
255
|
-
| `anyforge_post_work_item_comment` | write | Add a discussion comment to a work item; internal unless `clientVisible: true` shares it with the client as it is written |
|
|
261
|
+
| `anyforge_post_work_item_comment` | write | Add a discussion comment to a work item; internal unless `clientVisible: true` shares it with the client as it is written; `mentions` (member uids from `anyforge_list_members`) notify those members |
|
|
256
262
|
| `anyforge_share_work_item_comment` | write | Share an existing work-item comment with the client (`clientVisible: true`) or take it back to internal (`false`) |
|
|
263
|
+
| `anyforge_edit_work_item_comment` | write | Edit your own work-item comment (`body`) |
|
|
264
|
+
| `anyforge_delete_work_item_comment` | write | Delete your own work-item comment (409 `comment_has_replies` while it has replies) |
|
|
265
|
+
| `anyforge_resolve_work_item_comment` | write | Resolve or reopen a comment's thread (`resolved`); returns `rootId` |
|
|
257
266
|
| `anyforge_list_work_item_files` | read | List the files attached to a work item (`GET /work/{id}/files`), one page at a time |
|
|
258
267
|
| `anyforge_add_work_item_files` | write | Attach up to 5 files to a work item (`text`, `contentBase64`, or a local `path` on the stdio server); added internal, Console types and limits, all or nothing, about 7 MB of files per call; optional `idempotencyKey` for safe retries, per-file `originalCreatedAt`, and `onNameConflict` |
|
|
259
268
|
| `anyforge_upload_local_file` | write | stdio only: read a file from this machine and direct-upload it (≤ 1 GB) to a work item, initiative or program; refused on the hosted transport (`local_files_unavailable`) |
|
|
@@ -266,10 +275,10 @@ complete capability and local/remote workspace boundary.
|
|
|
266
275
|
| `anyforge_list_crews` | read | Discover crews by status and active state, newest first. Returns 25 rows unless you pass `limit` (up to 200) |
|
|
267
276
|
| `anyforge_get_crew` | read | Crew state + recent outputs + comments. Leads with status, halt reason, work item, PR and timestamps; `shape: "summary"` (default) excerpts long text and leaves out large snapshots, naming each; `messages: 0` is the status read; `shape: "full"` for every field |
|
|
268
277
|
| `anyforge_post_crew_comment` | write | Comment on / @-mention people on a crew (the crew does not read comments; use `anyforge_message_crew` to steer a running crew, `anyforge_amend_crew` for one at a gate) |
|
|
269
|
-
| `anyforge_message_crew` | approve | Message a running crew's Engineer ("skip X", "check Z first"). It reads the message before its next step and confirms in the crew chat; a crew not yet started or stopped inside the Engineer reads it on its first step or on resume. Refused with `crew_not_reading_messages` at a gate,
|
|
270
|
-
| `anyforge_resume_crew` | approve | Resume a PAUSED/HALTED crew. Optional `guidance` (up to 4000 characters) resumes with guidance: the Engineer's first resumed round runs with it, in the same call.
|
|
278
|
+
| `anyforge_message_crew` | approve | Message a running crew's Engineer ("skip X", "check Z first"). It reads the message before its next step and confirms in the crew chat; a crew not yet started or stopped inside the Engineer reads it on its first step or on resume. A crew working outside its Engineer (an amend on its way in, review) queues it for the next round (`delivery: next_round`). Refused with `crew_not_reading_messages` at a gate, when stopped outside the Engineer or when finished; the refusal's `nextStep` says what to do. Optional `idempotencyKey` makes a retry safe |
|
|
279
|
+
| `anyforge_resume_crew` | approve | Resume a PAUSED/HALTED crew where it stopped: the same action as the Console's Resume button, so a crew whose Engineer declared itself blocked runs the Engineer again with the messages queued for it. `anyforge_resume_crew_with_pr` is the one that sends an open pull request to review with no Engineer round. Optional `guidance` (up to 4000 characters) resumes with guidance: the Engineer's first resumed round runs with it and the queued messages, in the same call. On a crew halted at its ship gate, guidance is that gate's amend and is refused as amend refuses it. A crew the guidance cannot reach is refused with `not_resumable` and the guidance is not stored: one that is not PAUSED/HALTED, or one paused at a gate; use `anyforge_amend_crew` there. Requires `approve` scope. |
|
|
271
280
|
| `anyforge_halt_crew` | approve | Halt a crew |
|
|
272
|
-
| `anyforge_amend_crew` | approve | Continue & finish — send a crew at its HIL gate back to the engineer with guidance. Optional `postToPullRequest` also posts the notes on the pull request; left out, the organization setting decides (off by default) |
|
|
281
|
+
| `anyforge_amend_crew` | approve | Continue & finish — send a crew at its HIL gate back to the engineer with guidance. A crew halted at its ship gate is resumed with the notes; refused with `pr_merged` or `pr_closed` when its pull request merged or closed after the halt. A crew already running gets the amend queued (`queued: true`, `appliesAt`: `next_step`, or `ship_card` for a pending Resume on its next ship card). Optional `postToPullRequest` also posts the notes on the pull request; left out, the organization setting decides (off by default) |
|
|
273
282
|
| `anyforge_fix_crew_ci` | approve | Fix CI: send a crew whose pull request has failing checks back to the Engineer to fix them on the same PR. Works from PR review (HIL_SHIP) or a HALTED/PAUSED crew that has a PR; refused when GitHub does not report CI as failing. Requires `approve` scope and spends crew tokens. Only call when the operator asks. |
|
|
274
283
|
| `anyforge_resume_crew_with_pr` | approve | Review & approve: take a HALTED or PAUSED crew's already-open pull request through the specialist reviews to the approve & merge gate, without re-running the Engineer. Omit prUrl to use the PR stored on the crew. A merged PR is refused. Requires `approve` scope. |
|
|
275
284
|
| `anyforge_decide_crew_permission` | approve | Approve or deny the permission a crew in PERMISSION_PENDING is waiting on (see pendingPermissionRequest on anyforge_get_crew). A tool permission applies for the rest of the run; an MCP write approval decides that one call. Pass approvalId to refuse a decision on a newer request. Requires `approve` scope. Only call when the operator decides. |
|
|
@@ -305,6 +314,7 @@ complete capability and local/remote workspace boundary.
|
|
|
305
314
|
| `anyforge_accept_observability_signal` | write | Accept a signal into a governed incident under the KTLO program |
|
|
306
315
|
| `anyforge_dismiss_observability_signal` | write | Dismiss a production-error signal as noise |
|
|
307
316
|
| `anyforge_list_audit_events` | audit:read | Read one page of the hash-chained audit trail, oldest first, with each entry's `sequence`, `hash` and `prevHash` (filter by `eventType`, `actor`, `from`, `to`; page with `cursor`). Needs a key minted with the explicit `audit:read` scope by an owner |
|
|
317
|
+
| `anyforge_whoami` | read | Who this connection acts as: the key owner's uid, name and current role, the credential's scopes and the workspace |
|
|
308
318
|
| `anyforge_list_members` | read | List the workspace's approved members with uid, name, email, role and whether they can be assigned work. Assignment takes the uid, not an email; `q` finds a person by name or email |
|
|
309
319
|
| `anyforge_invite_person` | people:invite | Invite one person, or refresh their pending invitation: `role` is operator, editor, viewer or filer (never owner), `email` on a verified company domain, optional `teamIds` and `notify`. Needs an owner's key with the `people:invite` scope |
|
|
310
320
|
| `anyforge_list_people_invitations` | people:invite | List the invitations a `people:invite` key could have written, pending and accepted |
|
|
@@ -334,7 +344,10 @@ complete capability and local/remote workspace boundary.
|
|
|
334
344
|
| `anyforge_list_risks` | read | List accepted risks for a program (`programId`) or one subject (`subjectKind` + `subjectId`); closed risks only with `includeClosed` |
|
|
335
345
|
| `anyforge_update_risk` | write | Change a risk's status (for example `MATERIALISED` or `CLOSED`), owner, review date, mitigation or follow-up work items; only the fields passed change |
|
|
336
346
|
| `anyforge_list_skills` | read | The company skill library: id, name, category, one-line description, length and source, without the text (`q` narrows) |
|
|
347
|
+
| `anyforge_get_skill` | read | One company skill with its full text, `revision` and `updatedAt`, by `skillId` or exact `name` (ignoring case). An unknown one is `skill_not_found`; a name two skills share is `ambiguous_skill_name` with their ids. Company library only, not skill sources; a Viewer's key may read |
|
|
337
348
|
| `anyforge_create_skill` | write | Add one skill (`name`, `category`, `content`, optional `description`, `languages`, `force`) through the Skills page's create path: unique name, content scan, similar-intent check. Never exposed to the Oracle from here. Needs an Owner, Operator or Editor |
|
|
349
|
+
| `anyforge_search_context_library` | read | Search the Context Library (uploaded documents and published meetings) by meaning: `q`, optional `limit` (1–12, default 6). Returns `mode` (`semantic`, or `title` when embeddings are not provisioned, with no excerpts) and `matches` with `docId`, `title`, `excerpt` and `untrusted` (a published meeting: untrusted speech). A Viewer's key may read |
|
|
350
|
+
| `anyforge_read_library_doc` | read | One Context Library document's text by `docId`, in pages of up to 30,000 characters (`offset`, `limit`, `expectedRevision`; a replaced document is `document_changed`), or `list: true` for every document. An unknown or archived id is `library_doc_not_found` |
|
|
338
351
|
| `anyforge_list_connected_tools` | read | The company MCP servers an owner opened to local agents, and the tools on them you may use (`access` read or write, `needsApproval`, `actsAs` company or you). Pass `server` for input schemas. Needs an Owner, Operator or Editor on a personal key |
|
|
339
352
|
| `anyforge_call_connected_tool` | read | Call one listed tool (`server`, `tool`, `arguments`). A read runs with the stored credential and returns its result; a write, or a tool marked `needsApproval`, is raised for a person's approval and returns `pending_approval` with a `callId`. Writes need an Owner or Operator and the `write` scope. Every call is audited without its arguments or result |
|
|
340
353
|
| `anyforge_get_connected_tool_call` | read | Where your approval-gated call stands (`pending_approval`, `approved`, `executed`, `failed`, `rejected`, `expired`) and, once settled, what happened |
|
|
@@ -448,6 +461,13 @@ upload then carries no `uploadUrl`, so `anyforge_start_file_upload` returns no
|
|
|
448
461
|
`curl` and `anyforge_upload_local_file` sends nothing. A same-name file of
|
|
449
462
|
another size is `file_name_exists` unless `onNameConflict` is `keep_both`.
|
|
450
463
|
|
|
464
|
+
Comments can be changed after posting with `anyforge_edit_work_item_comment`,
|
|
465
|
+
`anyforge_delete_work_item_comment` and `anyforge_resolve_work_item_comment`
|
|
466
|
+
(resolve and reopen). Edit and delete act only on your own comment; resolve
|
|
467
|
+
needs Editor or above. Deleting a root
|
|
468
|
+
with replies is refused (`comment_has_replies`). Thread roots in
|
|
469
|
+
`anyforge_list_work_item_comments` carry `resolved`. See the MCP server docs.
|
|
470
|
+
|
|
451
471
|
The structured Program Genesis writes are program-scoped. Brief saves are full
|
|
452
472
|
versioned replacements through `anyforge_save_program_brief_version`. Initiative
|
|
453
473
|
closures and batch close-as-fixed operations use `preview` followed by
|