@anyforge/mcp-server 3.14.2 → 3.14.3
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/dist/index.js +2 -2
- package/package.json +1 -1
package/dist/index.js
CHANGED
|
@@ -399,5 +399,5 @@ Do not place API keys, tokens, credentials, private tenant records, or customer
|
|
|
399
399
|
data in a reusable skill, prompt, log, or generated example. Use the client's
|
|
400
400
|
credential mechanism and let the server enforce access.
|
|
401
401
|
`,"references/tool-map.md":'# AnyForge MCP tool map\n\nTool names can grow as the platform grows. Use `tools/list` and the current\ntool description as the contract. The names below are representative entry\npoints in the public MCP server.\n\n## Discover and inspect\n\n- `anyforge_list_repo_index` and `anyforge_get_repo_analysis` discover connected\n repositories and their analysis.\n- `anyforge_list_programs` and `anyforge_get_program` inspect program records.\n- `anyforge_list_initiatives` and `anyforge_get_initiative` inspect scoped work.\n- `anyforge_list_work_items` and `anyforge_get_work_item` inspect delivery\n units.\n- `anyforge_list_crews` and `anyforge_get_crew` inspect Crew runs and output.\n For where one crew stands, call `anyforge_get_crew` with `messages: 0`: the\n crew leads with `status`, the halt reason, its work item and pull request,\n and the default summary shape leaves out the large snapshots (named in\n `omittedFields`). Pass `shape: "full"` only for a left-out field.\n- `anyforge_list_pending_approvals` and `anyforge_get_approval_detail` inspect\n human gates.\n- `anyforge_ask_oracle` asks a read-oriented cross-workspace question. A long investigation returns `running` with an `askId`; collect it with `anyforge_get_oracle_answer` rather than asking again. A turn that runs out of time is continued server-side under the same `askId` (`maxContinuations`, default 2), so a long answer arrives whole without a "continue" ask.\n\n### Find a work item by code\n\nFor a known full code, call `anyforge_list_work_items` with `itemId`:\n\n```json\n{ "itemId": "WBA-004", "limit": 5 }\n```\n\nUse the returned item\'s `id` with `anyforge_get_work_item` for its full details.\nFor a partial code or title, use `search` instead, for example\n`{ "search": "WBA-", "limit": 20 }`. Search is case-insensitive and matches\nsubstrings, so check the returned code and title before selecting a record.\nArchived items are excluded by default, including code lookups; add\n`"includeArchived": true` when looking for archived work. Check `hasMore` and\nfollow `nextCursor` with unchanged filters when there are more results.\n\n## Plan and write\n\n- `anyforge_create_program` and `anyforge_update_program` manage program\n records, including the lead and whether the program is long-lived;\n `anyforge_set_program_request_intake` switches its incoming requests, and\n `anyforge_set_program_status_line` writes its status line.\n- `anyforge_create_initiative`, `anyforge_update_initiative`, and\n `anyforge_dispatch_architect` manage initiative planning and dispatch.\n- `anyforge_create_work_item` and `anyforge_update_work_item` manage concrete\n delivery units. Labels are `tags`: set them on create, and change them with\n `action: \'update\'` and `addTags` / `removeTags` (no revision needed, at any\n status, finished items included). Replacing the whole list with `tags` needs\n `ifClassificationRevision`, the item\'s `classificationRevision`.\n `anyforge_get_work_item` returns `nextActions`, every status move the key can\n make now with the arguments to send; `status` with no action moves an item\n back to BACKLOG, REFINED or READY.\n- Program Genesis also exposes tools for the structured brief and reconciling\n program delivery. Read their schemas before use.\n\n## Approve and control\n\n- `anyforge_approve_backlog` and `anyforge_approve_task_proposal` advance\n approval-gated planning.\n- `anyforge_submit_approval` records a human decision when the caller has the\n required approval scope.\n- `anyforge_resume_crew`, `anyforge_halt_crew`,\n `anyforge_message_crew`, and `anyforge_amend_crew` control a Crew run.\n `anyforge_fix_crew_ci`, `anyforge_resume_crew_with_pr` and\n `anyforge_decide_crew_permission` are the Build view\'s recovery actions.\n Explain the effect before calling them.\n\n## Selection rules\n\n1. Prefer the narrowest read tool that answers the question.\n2. Use a detail tool after a list result when a decision depends on fields not\n present in the list.\n3. Filter and page large lists. Do not request an unbounded workspace dump.\n4. Treat names and descriptions as hints; use the tool schema for required\n fields and allowed values.\n5. Before a mutation, restate the target, change, and likely side effect.\n6. After a mutation, read the target again and report the resulting state.\n'},$e=Object.entries(Me).map(([e,i])=>({uri:e==="SKILL.md"?O:`${O}/${e}`,name:e==="SKILL.md"?Fe:`${Fe}/${e.replace(/^references\//,"")}`,title:e==="SKILL.md"?"AnyForge platform guide":e,description:e==="SKILL.md"?B:`Reference for the ${Fe} skill: ${e}`,mimeType:oi,size:new TextEncoder().encode(i).byteLength}));function Ge(e){let i=Object.entries(Me).find(([r])=>(r==="SKILL.md"?O:`${O}/${r}`)===e);if(!i)throw new Error(`unknown resource "${e}"`);return{uri:e,mimeType:oi,text:i[1]}}var Ir=Me["SKILL.md"],Be=Ir.replace(/^---[\s\S]*?\r?\n---[ \t]*(?:\r?\n|$)/,"");var ni={name:"platform_guide",description:`${B} Load it when platform context is needed.`,arguments:[{name:"topic",description:"Optional AnyForge topic to explain or apply after loading the guide.",required:!1}],render:e=>["Use the following AnyForge platform guide to orient your answer.","It is static guidance, not tenant state or authorization. For current records, use the live AnyForge tools and say when evidence is missing.",e.topic?`The user wants to focus on: ${e.topic}`:void 0,"",Be].filter(i=>i!==void 0).join(`
|
|
402
|
-
`)};var Tr={type:"object"},Sr=new Set(["anyforge_ask_oracle","anyforge_investigate_repository","anyforge_triage_ticket","anyforge_search_pages","anyforge_preview_report_query","anyforge_describe_report_catalog"]),Rr=new Set(["anyforge_ask_oracle","anyforge_investigate_repository"]),Er={requiredScope:"read",sideEffect:"none",requiresConfirmation:!1,supportsDryRun:!1,idempotent:!0},xr={anyforge_submit_approval:{requiredScope:"approve",sideEffect:"mutation",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!1},anyforge_approve_backlog:{requiredScope:"approve",sideEffect:"mutation",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!1},anyforge_approve_task_proposal:{requiredScope:"approve",sideEffect:"mutation",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!1},anyforge_dispatch_architect:{requiredScope:"write",sideEffect:"mutation",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!1},anyforge_resume_crew:{requiredScope:"approve",sideEffect:"mutation",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!1},anyforge_halt_crew:{requiredScope:"approve",sideEffect:"destructive",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!0},anyforge_message_crew:{requiredScope:"approve",sideEffect:"mutation",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!1},anyforge_amend_crew:{requiredScope:"approve",sideEffect:"mutation",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!1},anyforge_run_workflow:{requiredScope:"write",sideEffect:"mutation",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!1},anyforge_resolve_workflow_gate:{requiredScope:"approve",sideEffect:"mutation",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!1},anyforge_retry_workflow_run:{requiredScope:"write",sideEffect:"mutation",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!1},anyforge_analyze_repos:{requiredScope:"write",sideEffect:"mutation",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!0},anyforge_start_coverage_sweep:{requiredScope:"write",sideEffect:"mutation",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!0},anyforge_generate_escrow_deposit:{requiredScope:"write",sideEffect:"mutation",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!1},anyforge_deliver_escrow_deposit:{requiredScope:"write",sideEffect:"destructive",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!1},anyforge_promote_opportunity:{requiredScope:"write",sideEffect:"mutation",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!1},anyforge_delete_program:{requiredScope:"write",sideEffect:"destructive",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!0},anyforge_delete_initiative:{requiredScope:"write",sideEffect:"destructive",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!0}};function Ar(e){return/^anyforge_(list|get)_/.test(e)||Sr.has(e)?Er:/^anyforge_(submit|approve|resume|halt|amend|resolve)_/.test(e)?{requiredScope:"approve",sideEffect:e.includes("halt")?"destructive":"mutation",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!1}:{requiredScope:"write",sideEffect:/^anyforge_delete_/.test(e)?"destructive":"mutation",requiresConfirmation:!0,supportsDryRun:!1,idempotent:/^anyforge_(update|set|delete|upsert)_/.test(e)}}function si(e){return e.policy??xr[e.name]??Ar(e.name)}function Cr(e){let i=e.replace(/^anyforge_/,"").split("_").filter(Boolean);if(i.length===0)return e;let[r,...o]=i;return[r.charAt(0).toUpperCase()+r.slice(1),...o].join(" ")}function Pr(e){let i=si({name:e});return{title:Cr(e),readOnlyHint:i.sideEffect==="none",destructiveHint:i.sideEffect==="
|
|
403
|
-
`);function mi(e){let r=[{type:"text",text:typeof e=="string"?e:Dr(e??{ok:!0})}],o;return e==null?o={ok:!0}:Array.isArray(e)?o={items:e}:typeof e=="object"?o=e:typeof e=="string"?o={text:e}:o={result:e},{content:r,structuredContent:o}}function Dr(e){let i=JSON.stringify(e);return i===void 0?"null":Buffer.byteLength(i,"utf8")>262144?i:JSON.stringify(e,null,2)}var W={name:"@anyforge/mcp-server",version:"3.14.
|
|
402
|
+
`)};var Tr={type:"object"},Sr=new Set(["anyforge_ask_oracle","anyforge_investigate_repository","anyforge_triage_ticket","anyforge_search_pages","anyforge_preview_report_query","anyforge_describe_report_catalog"]),Rr=new Set(["anyforge_ask_oracle","anyforge_investigate_repository"]),Er={requiredScope:"read",sideEffect:"none",requiresConfirmation:!1,supportsDryRun:!1,idempotent:!0},xr={anyforge_submit_approval:{requiredScope:"approve",sideEffect:"mutation",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!1},anyforge_approve_backlog:{requiredScope:"approve",sideEffect:"mutation",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!1},anyforge_approve_task_proposal:{requiredScope:"approve",sideEffect:"mutation",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!1},anyforge_dispatch_architect:{requiredScope:"write",sideEffect:"mutation",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!1},anyforge_resume_crew:{requiredScope:"approve",sideEffect:"mutation",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!1},anyforge_halt_crew:{requiredScope:"approve",sideEffect:"destructive",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!0},anyforge_message_crew:{requiredScope:"approve",sideEffect:"mutation",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!1},anyforge_amend_crew:{requiredScope:"approve",sideEffect:"mutation",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!1},anyforge_run_workflow:{requiredScope:"write",sideEffect:"mutation",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!1},anyforge_resolve_workflow_gate:{requiredScope:"approve",sideEffect:"mutation",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!1},anyforge_retry_workflow_run:{requiredScope:"write",sideEffect:"mutation",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!1},anyforge_analyze_repos:{requiredScope:"write",sideEffect:"mutation",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!0},anyforge_start_coverage_sweep:{requiredScope:"write",sideEffect:"mutation",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!0},anyforge_generate_escrow_deposit:{requiredScope:"write",sideEffect:"mutation",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!1},anyforge_deliver_escrow_deposit:{requiredScope:"write",sideEffect:"destructive",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!1},anyforge_promote_opportunity:{requiredScope:"write",sideEffect:"mutation",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!1},anyforge_delete_program:{requiredScope:"write",sideEffect:"destructive",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!0},anyforge_delete_initiative:{requiredScope:"write",sideEffect:"destructive",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!0}};function Ar(e){return/^anyforge_(list|get)_/.test(e)||Sr.has(e)?Er:/^anyforge_(submit|approve|resume|halt|amend|resolve)_/.test(e)?{requiredScope:"approve",sideEffect:e.includes("halt")?"destructive":"mutation",requiresConfirmation:!0,supportsDryRun:!1,idempotent:!1}:{requiredScope:"write",sideEffect:/^anyforge_delete_/.test(e)?"destructive":"mutation",requiresConfirmation:!0,supportsDryRun:!1,idempotent:/^anyforge_(update|set|delete|upsert)_/.test(e)}}function si(e){return e.policy??xr[e.name]??Ar(e.name)}function Cr(e){let i=e.replace(/^anyforge_/,"").split("_").filter(Boolean);if(i.length===0)return e;let[r,...o]=i;return[r.charAt(0).toUpperCase()+r.slice(1),...o].join(" ")}function Pr(e){let i=si({name:e});return{title:Cr(e),readOnlyHint:i.sideEffect==="none",destructiveHint:i.sideEffect==="destructive",idempotentHint:i.idempotent,openWorldHint:Rr.has(e)}}function qr(e){let{policy:i,...r}=e,o=si(e),s=Pr(e.name);return{...r,title:e.title??s.title,annotations:{...s,...e.annotations},outputSchema:e.outputSchema??Tr,_meta:{...e._meta,anyforge:{...typeof e._meta?.anyforge=="object"&&e._meta.anyforge!==null?e._meta.anyforge:{},policy:o}}}}function ai(e){return e.map(qr)}var di=[Mt,Je,nt,dt,ct,ht,gt,ft,bt,kt,It,Tt,St,Rt,Et,xt,At,Ct,Pt,qt,Ot,Dt,Nt,Lt,Ht,zt,Qt,ii],He=ai(di.flatMap(e=>e.tools)),pi=Object.assign({},...di.map(e=>e.handlers)),H=[...ri,ni],ci=Object.fromEntries(H.map(e=>[e.name,e]));var li="https://crew.anyforge.ai";var Or={crew:"/studio?crew={crewId}",workItem:"/work?item={workItemId}",initiative:"/initiatives/{initiativeId}",program:"/programs/{programId}",codebase:"/codebases/{codebaseId}",releases:"/releases?codebase={codebaseId}&range=all",workflow:"/workflows/{workflowId}",workflowRun:"/workflows/runs/{runId}",report:"/insights/reports/{reportId}",approvals:"/approvals"},ui=["When you present AnyForge entities to the user \u2014 crews, work items, initiatives, programs,","codebases, workflows, runs, reports \u2014 render every entity id as a clickable markdown link to","its AnyForge Console view, never as a bare id. Prefer the absolute `url` field when a tool","result carries one. Otherwise build the link from the entity id with these Console paths,",`prefixed with the operator's Console origin (${li} unless they use a`,"self-hosted deployment):",...Object.entries(Or).map(([e,i])=>`- ${e}: ${i}`),"The Console enforces the viewer's permissions when a link is opened, so linking is always safe.","When you need platform orientation, use the `platform_guide` prompt or read the `anyforge://guide/platform` resource.","That guide is static and contains no tenant state or authority; use the live AnyForge tools for current records and confirm mutations or approvals with the user."].join(`
|
|
403
|
+
`);function mi(e){let r=[{type:"text",text:typeof e=="string"?e:Dr(e??{ok:!0})}],o;return e==null?o={ok:!0}:Array.isArray(e)?o={items:e}:typeof e=="object"?o=e:typeof e=="string"?o={text:e}:o={result:e},{content:r,structuredContent:o}}function Dr(e){let i=JSON.stringify(e);return i===void 0?"null":Buffer.byteLength(i,"utf8")>262144?i:JSON.stringify(e,null,2)}var W={name:"@anyforge/mcp-server",version:"3.14.3",mcpName:"ai.anyforge/anyforge",description:"AnyForge MCP Server \u2014 drive AnyForge (HIL approvals, initiatives, work items, crews) from Claude CLI, Cursor, and other MCP clients",type:"module",main:"./dist/index.js",bin:{"anyforge-mcp-server":"dist/index.js"},files:["dist","README.md"],engines:{node:">=22"},scripts:{build:"esbuild index.ts --bundle --minify --platform=node --format=esm --outfile=dist/index.js --packages=external","type-check":"tsc --noEmit",prepublishOnly:"npm run build",start:"npx tsx index.ts",dev:"npx tsx index.ts"},publishConfig:{access:"public"},keywords:["anyforge","mcp","model-context-protocol","claude","claude-code"],license:"UNLICENSED",dependencies:{"@modelcontextprotocol/sdk":"^1.30.0"},devDependencies:{"@types/node":"^22.20.0",esbuild:"^0.28.2",typescript:"^7.0.2"}};var v=new Lr({name:"anyforge",version:W.version},{capabilities:{tools:{},prompts:{},resources:{}},instructions:ui});v.setRequestHandler(Fr,async()=>({tools:He}));v.setRequestHandler(Mr,async()=>({prompts:H.map(e=>({name:e.name,description:e.description,arguments:e.arguments}))}));v.setRequestHandler($r,async e=>{let i=ci[e.params.name];if(!i)throw new Error(`unknown prompt "${e.params.name}"`);let r=e.params.arguments??{};return{description:i.description,messages:[{role:"user",content:{type:"text",text:i.render(r)}}]}});v.setRequestHandler(Gr,async()=>({resources:$e}));v.setRequestHandler(Br,async e=>({contents:[Ge(e.params.uri)]}));v.setRequestHandler(jr,async e=>{let{name:i,arguments:r}=e.params,o=pi[i];if(!o)return{content:[{type:"text",text:`Error: unknown tool "${i}"`}],isError:!0};try{let s=await Xe(i,()=>o(r??{}));return mi(s)}catch(s){return{content:[{type:"text",text:`Error: ${s instanceof Error?s.message:String(s)}`}],isError:!0}}});Y(W.version);v.oninitialized=()=>{Y(W.version,v.getClientVersion())};async function Hr(){let e=new Ur;await v.connect(e),console.error(`AnyForge MCP Server started (stdio, ${He.length} tools, ${H.length} prompts)`)}Hr().catch(e=>{console.error("MCP Server failed to start:",e),process.exit(1)});
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@anyforge/mcp-server",
|
|
3
|
-
"version": "3.14.
|
|
3
|
+
"version": "3.14.3",
|
|
4
4
|
"mcpName": "ai.anyforge/anyforge",
|
|
5
5
|
"description": "AnyForge MCP Server — drive AnyForge (HIL approvals, initiatives, work items, crews) from Claude CLI, Cursor, and other MCP clients",
|
|
6
6
|
"type": "module",
|