@anyforge/mcp-server 2.2.0 → 2.3.0

package/README.md

@@ -74,6 +74,28 @@ Use the equivalent stdio MCP config (`command: npx`, `args: ["tsx",
 | `anyforge_resume_crew` | approve | Resume a PAUSED/HALTED crew |
 | `anyforge_halt_crew` | approve | Halt a crew |
 | `anyforge_amend_crew` | approve | Continue & finish — send a crew at its HIL gate back to the engineer with guidance |
+| `anyforge_create_program` | write | Create a program (cross-initiative grouping) |
+| `anyforge_write_program_brief` | write | Write/update a program's brief (charter) — seeds each initiative's architect context |
+| `anyforge_create_initiative` | write | Create a (DRAFT) initiative, optionally under a program |
+| `anyforge_dispatch_architect` | write | Decompose an initiative into a backlog (→ HIL #1) |
+| `anyforge_list_repo_index` | read | List the org repo index (activity, coverage, analyzed) — discover codebases to scope |
+| `anyforge_get_repo_analysis` | read | One repo's coverage / architecture / gap summary |
+| `anyforge_analyze_repos` | write | Start Phase-1 analysis for one or more repos |
+| `anyforge_start_coverage_sweep` | write | Paced Phase 1→2 analysis sweep over a program/repo set |
+| `anyforge_refresh_repo_index` | write | Refresh the repo index + committed-coverage detection now |
+
+## Prompts (guided flows)
+
+MCP clients that support server prompts (e.g. Claude Code surfaces them as
+`/mcp__anyforge__<name>` slash commands) get:
+
+| Prompt | Args | What it does |
+|--------|------|--------------|
+| `genesis` | `programId?`, `goal?` | Turns the client into the **Program Genesis agent**: it interviews you to scope a program across your codebases (using `anyforge_list_repo_index` / `anyforge_get_repo_analysis`), writes the program brief, then creates one initiative per in-scope codebase and offers to dispatch the architect on each. |
+
+The Genesis flow runs entirely in *your* agent — there's no server-side
+chat-in-a-tool. The prompt gives your client the persona + interview script;
+it drives the conversation and calls the tools above as it goes.
 
 ## Example prompts
 
@@ -81,6 +103,7 @@ Use the equivalent stdio MCP config (`command: npx`, `args: ["tsx",
 - "Show me the plan for approval `abc123` then approve it." → `anyforge_get_approval_detail` → `anyforge_submit_approval`
 - "Add a P1 bug: rate-limit the export endpoint." → `anyforge_create_work_item`
 - "What did crew `xyz` produce? Post a comment asking it to add tests." → `anyforge_get_crew` → `anyforge_post_crew_comment`
+- "Scope a coverage program across our Go services." → run the `genesis` prompt → it lists repos, scopes, and creates an initiative per service.
 
 ## How it works
 

package/dist/index.js

@@ -19,20 +19,41 @@
  */
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
 import { hilTools } from './tools/hil.js';
 import { workTools } from './tools/work.js';
 import { initiativeTools } from './tools/initiatives.js';
 import { programTools } from './tools/programs.js';
 import { crewTools } from './tools/crews.js';
 import { coverageTools } from './tools/coverage.js';
+import { repoTools } from './tools/repos.js';
+import { prompts as PROMPTS } from './prompts/genesis.js';
 // ─── Assemble the tool registry ──────────────────────────────────────
-const MODULES = [hilTools, workTools, initiativeTools, programTools, crewTools, coverageTools];
+const MODULES = [hilTools, workTools, initiativeTools, programTools, crewTools, coverageTools, repoTools];
 const TOOLS = MODULES.flatMap(m => m.tools);
 const HANDLERS = Object.assign({}, ...MODULES.map(m => m.handlers));
+const PROMPT_BY_NAME = Object.fromEntries(PROMPTS.map(p => [p.name, p]));
 // ─── Server setup ────────────────────────────────────────────────────
-const server = new Server({ name: 'anyforge', version: '2.1.0' }, { capabilities: { tools: {} } });
+const server = new Server({ name: 'anyforge', version: '2.3.0' }, { capabilities: { tools: {}, prompts: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+// ─── Prompts (guided flows: `genesis`) ───────────────────────────────
+// Prompts turn the MCP client itself into the Genesis agent — see
+// prompts/genesis.ts for the rationale.
+server.setRequestHandler(ListPromptsRequestSchema, async () => ({
+    prompts: PROMPTS.map(p => ({ name: p.name, description: p.description, arguments: p.arguments })),
+}));
+server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+    const prompt = PROMPT_BY_NAME[request.params.name];
+    if (!prompt)
+        throw new Error(`unknown prompt "${request.params.name}"`);
+    const args = (request.params.arguments ?? {});
+    return {
+        description: prompt.description,
+        messages: [
+            { role: 'user', content: { type: 'text', text: prompt.render(args) } },
+        ],
+    };
+});
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
     const { name, arguments: args } = request.params;
     const handler = HANDLERS[name];
@@ -66,7 +87,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.error(`AnyForge MCP Server started (stdio, ${TOOLS.length} tools)`);
+    console.error(`AnyForge MCP Server started (stdio, ${TOOLS.length} tools, ${PROMPTS.length} prompts)`);
 }
 main().catch(err => {
     console.error('MCP Server failed to start:', err);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAA;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAA;AAE3C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAGnD,wEAAwE;AAExE,MAAM,OAAO,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,CAAC,CAAA;AAE9F,MAAM,KAAK,GAAc,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;AACtD,MAAM,QAAQ,GAAgC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;AAEhG,wEAAwE;AAExE,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,EACtC,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAA;AAED,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;AAEhF,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAA;IAChD,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC9B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,wBAAwB,IAAI,GAAG,EAAE,CAAC;YAClE,OAAO,EAAE,IAAI;SACd,CAAA;IACH,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC,CAAA;QACrE,sEAAsE;QACtE,wEAAwE;QACxE,oEAAoE;QACpE,mEAAmE;QACnE,mEAAmE;QACnE,qEAAqE;QACrE,MAAM,IAAI,GAAG,OAAO,MAAM,KAAK,QAAQ;YACrC,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;QACnD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAA;IAC9C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YAC/F,OAAO,EAAE,IAAI;SACd,CAAA;IACH,CAAC;AACH,CAAC,CAAC,CAAA;AAEF,wEAAwE;AAExE,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAA;IAC5C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IAC/B,OAAO,CAAC,KAAK,CAAC,uCAAuC,KAAK,CAAC,MAAM,SAAS,CAAC,CAAA;AAC7E,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;IACjB,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAA;IACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}

package/dist/prompts/genesis.d.ts

@@ -0,0 +1,3 @@
+import type { PromptDef } from '../tools/types.js';
+export declare const genesisPrompt: PromptDef;
+export declare const prompts: PromptDef[];

package/dist/prompts/genesis.js

@@ -0,0 +1,68 @@
+/**
+ * The `genesis` prompt — the discoverable entry point that turns the MCP
+ * client (Claude Code, Cursor, …) INTO the AnyForge Program Genesis agent.
+ *
+ * We deliberately do NOT pipe a server-side agent through a chat-in-a-tool:
+ * the user already has a capable conversational agent (the MCP client), so
+ * we give it the Genesis persona + the interview script and let it drive the
+ * conversation, calling the AnyForge control tools as it goes. This reads as
+ * a natural chat — "talk to Genesis" — and works in any MCP client.
+ *
+ * Flow it encodes: gather objective → scope codebases (list_repo_index) →
+ * gather per-codebase functionality/details (get_repo_analysis to ground) →
+ * persist the program brief → propose + confirm one initiative per codebase →
+ * create them (create_initiative w/ programId) → dispatch the architect per
+ * initiative (dispatch_architect → backlog → approve_backlog).
+ */
+function header(args) {
+    const lines = ['You are the **AnyForge Program Genesis agent**, running inside the user\'s terminal via the AnyForge MCP server.'];
+    if (args.programId)
+        lines.push(`\nYou are scoping the existing program \`${args.programId}\`. Call \`anyforge_get_program\` on it first to load its current name, status, and brief.`);
+    else
+        lines.push('\nNo program exists yet. Once you understand the objective, create one with `anyforge_create_program` and use its id for everything below.');
+    if (args.goal)
+        lines.push(`\nThe user's stated goal to start from: "${args.goal}"`);
+    return lines.join('\n');
+}
+export const genesisPrompt = {
+    name: 'genesis',
+    description: 'Start a Program Genesis session: chat with the AnyForge Genesis agent to scope a program ' +
+        'across your codebases and create one initiative per codebase, then dispatch the architect on each.',
+    arguments: [
+        { name: 'programId', description: 'Existing program to scope (omit to create a new one during the chat).', required: false },
+        { name: 'goal', description: 'One-line program goal to seed the conversation (optional).', required: false },
+    ],
+    render: (args) => `${header(args)}
+
+Your job is to interview the user until you have enough to define **proper, codebase-scoped initiatives** under this program, then create them and (on the user's go-ahead) dispatch the architect on each. Initiatives are always scoped to a single codebase — one program fans out into one initiative per in-scope codebase.
+
+## How to run the conversation
+Ask questions in small clusters — never dump the whole questionnaire at once. Listen, then go deeper where the answer is thin. Use the tools to ground every step in real data rather than guessing.
+
+**1. Objective & outcome.** What is this program trying to achieve, and what's the business outcome / definition of done? (e.g. "raise test coverage above 90% across the payments services", "migrate the Go services off the deprecated auth SDK".)
+
+**2. Scope the codebases.** Call \`anyforge_list_repo_index\` to show real candidates (default = active repos; for a coverage/quality program pass \`belowCoverage\` to get the repos below the target, worst-first). Present them and ask the user which are in scope. For the handful you or the user are unsure about, call \`anyforge_get_repo_analysis\` to see coverage, architecture health, gap count, and languages — that tells you how far each repo is from the goal. Confirm the final in-scope set explicitly.
+
+**3. Per-codebase detail.** For each in-scope codebase, gather what the program actually means *there*: which functionality/areas, the specific work expected, constraints, and any nuances. Pull \`anyforge_get_repo_analysis\` to anchor this in the repo's real state. Keep asking until each codebase has enough for an architect to decompose it into real work — not a vague one-liner.
+
+**4. Success criteria & guardrails.** Coverage target, deadlines, priorities/ordering across codebases, anything explicitly out of scope.
+
+## When scope is clear
+**5. Persist the brief.** Call \`anyforge_write_program_brief\` with a markdown charter (Purpose, Goals, Rationale, Scope in/out, Success metrics, Key context & sources). This grounds the program and seeds every initiative's architect context — so write it well.
+
+**6. Propose initiatives — then STOP for confirmation.** Present a table: one initiative per in-scope codebase, each with a name, the repo, and a 1–2 sentence intent derived from the objective + that repo's analysis. Do **not** create anything yet. Ask the user to confirm, edit names/intents, drop or add codebases.
+
+**7. Create them.** On confirmation, call \`anyforge_create_initiative\` once per codebase with: \`programId\`, \`name\`, \`description\`, \`defaultGithubRepo\` (the repo), \`defaultGithubBranch\` (its default branch from the index), and a \`brdContent\` that captures that codebase's slice of the program (objective + specific functionality/details + success criteria). It's idempotent — it de-dupes on name within the program/repo. Report the created initiative ids/codes.
+
+**8. Dispatch the architect.** Tell the user each initiative starts in DRAFT and the architect decomposes it into a backlog that lands at HIL #1 for approval. Offer to dispatch — call \`anyforge_dispatch_architect\` per initiative (one at a time, or all of them, the user's choice). After review, \`anyforge_approve_backlog\` moves an initiative to IN_PROGRESS and crews pick it up.
+
+## Rules
+- Ground every claim in tool output — never invent repos, coverage numbers, or codebase facts.
+- Never write (create program/initiative, write brief) before the user has confirmed the relevant step.
+- One initiative per codebase; reflect the program brief into each initiative's \`brdContent\`.
+- If the user gives you everything up front, still confirm the proposed initiative list before creating.
+
+Begin by ${args.programId ? 'loading the program, then confirming the objective' : 'asking for the program objective'}.`,
+};
+export const prompts = [genesisPrompt];
+//# sourceMappingURL=genesis.js.map

package/dist/prompts/genesis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"genesis.js","sourceRoot":"","sources":["../../prompts/genesis.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AAEH,SAAS,MAAM,CAAC,IAA4B;IAC1C,MAAM,KAAK,GAAG,CAAC,kHAAkH,CAAC,CAAA;IAClI,IAAI,IAAI,CAAC,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,4CAA4C,IAAI,CAAC,SAAS,4FAA4F,CAAC,CAAA;;QACjL,KAAK,CAAC,IAAI,CAAC,4IAA4I,CAAC,CAAA;IAC7J,IAAI,IAAI,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,4CAA4C,IAAI,CAAC,IAAI,GAAG,CAAC,CAAA;IACnF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAc;IACtC,IAAI,EAAE,SAAS;IACf,WAAW,EACT,2FAA2F;QAC3F,oGAAoG;IACtG,SAAS,EAAE;QACT,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,uEAAuE,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC5H,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,4DAA4D,EAAE,QAAQ,EAAE,KAAK,EAAE;KAC7G;IACD,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WA8BxB,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,oDAAoD,CAAC,CAAC,CAAC,kCAAkC,GAAG;CACvH,CAAA;AAED,MAAM,CAAC,MAAM,OAAO,GAAgB,CAAC,aAAa,CAAC,CAAA"}

package/dist/tools/initiatives.js

@@ -50,6 +50,41 @@ export const initiativeTools = {
                 required: ['initiativeId', 'crewId', 'messageId'],
             },
         },
+        {
+            name: 'anyforge_create_initiative',
+            description: 'Create an initiative (optionally under a program). De-dupes on name within the same ' +
+                'codebase or program+repo, so re-runs return the existing one. Starts in DRAFT; dispatch ' +
+                'the architect to decompose it into a backlog. Requires `write` scope.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: 'Initiative name.' },
+                    description: { type: 'string', description: 'What needs to be done (the intent).' },
+                    programId: { type: 'string', description: 'Parent program id (links it under a program).' },
+                    defaultGithubRepo: { type: 'string', description: 'Repo the crews run on, "owner/name".' },
+                    defaultGithubBranch: { type: 'string', description: 'Base branch (default "main").' },
+                    priority: { type: 'string', description: 'P0 / P1 (default) / P2 / P3.' },
+                    tokenBudget: { type: 'number', description: 'Token budget cap (default 50000).' },
+                    contextNotes: { type: 'string', description: 'Extra context for the architect.' },
+                    brdContent: { type: 'string', description: 'Business-requirements doc text (seeds decomposition).' },
+                    codebaseId: { type: 'string', description: 'Linked codebase id, when created from a gap finding.' },
+                    tags: { type: 'array', items: { type: 'string' }, description: 'Free-form tags.' },
+                },
+                required: ['name', 'description'],
+            },
+        },
+        {
+            name: 'anyforge_dispatch_architect',
+            description: 'Run (or re-run) the architect decomposition for an initiative: (re)creates the ' +
+                'decomposition crew, clears any prior error, and starts the architect, which proposes a ' +
+                'backlog for HIL #1 approval. Use after creating an initiative, or to retry a failed ' +
+                'decomposition. Requires `write` scope.',
+            inputSchema: {
+                type: 'object',
+                properties: { initiativeId: { type: 'string', description: 'The initiative id.' } },
+                required: ['initiativeId'],
+            },
+        },
     ],
     handlers: {
         anyforge_list_initiatives: args => callControl('GET', `/initiatives${qs({ status: args.status })}`),
@@ -59,6 +94,20 @@ export const initiativeTools = {
             crewId: args.crewId,
             messageId: args.messageId,
         }),
+        anyforge_create_initiative: args => callControl('POST', '/initiatives', {
+            name: args.name,
+            description: args.description,
+            programId: args.programId,
+            defaultGithubRepo: args.defaultGithubRepo,
+            defaultGithubBranch: args.defaultGithubBranch,
+            priority: args.priority,
+            tokenBudget: args.tokenBudget,
+            contextNotes: args.contextNotes,
+            brdContent: args.brdContent,
+            codebaseId: args.codebaseId,
+            tags: args.tags,
+        }),
+        anyforge_dispatch_architect: args => callControl('POST', `/initiatives/${encodeURIComponent(String(args.initiativeId))}/dispatch-architect`),
     },
 };
 //# sourceMappingURL=initiatives.js.map

package/dist/tools/initiatives.js.map

@@ -1 +1 @@
-{"version":3,"file":"initiatives.js","sourceRoot":"","sources":["../../tools/initiatives.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAA;AAGrD;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAe;IACzC,KAAK,EAAE;QACL;YACE,IAAI,EAAE,2BAA2B;YACjC,WAAW,EACT,qFAAqF;gBACrF,yFAAyF;YAC3F,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0CAA0C,EAAE;iBACpF;aACF;SACF;QACD;YACE,IAAI,EAAE,yBAAyB;YAC/B,WAAW,EAAE,+EAA+E;YAC5F,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE,EAAE;gBACnF,QAAQ,EAAE,CAAC,cAAc,CAAC;aAC3B;SACF;QACD;YACE,IAAI,EAAE,0BAA0B;YAChC,WAAW,EACT,yFAAyF;gBACzF,0EAA0E;YAC5E,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE,EAAE;gBACnF,QAAQ,EAAE,CAAC,cAAc,CAAC;aAC3B;SACF;QACD;YACE,IAAI,EAAE,gCAAgC;YACtC,WAAW,EACT,qFAAqF;gBACrF,kBAAkB;YACpB,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;oBACnE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8CAA8C,EAAE;oBACvF,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oCAAoC,EAAE;iBACjF;gBACD,QAAQ,EAAE,CAAC,cAAc,EAAE,QAAQ,EAAE,WAAW,CAAC;aAClD;SACF;KACF;IACD,QAAQ,EAAE;QACR,yBAAyB,EAAE,IAAI,CAAC,EAAE,CAChC,WAAW,CAAC,KAAK,EAAE,eAAe,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAA4B,EAAE,CAAC,EAAE,CAAC;QACxF,uBAAuB,EAAE,IAAI,CAAC,EAAE,CAC9B,WAAW,CAAC,KAAK,EAAE,gBAAgB,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;QACrF,wBAAwB,EAAE,IAAI,CAAC,EAAE,CAC/B,WAAW,CAAC,MAAM,EAAE,gBAAgB,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,kBAAkB,CAAC;QACtG,8BAA8B,EAAE,IAAI,CAAC,EAAE,CACrC,WAAW,CAAC,MAAM,EAAE,gBAAgB,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,wBAAwB,EAAE;YACzG,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;KACL;CACF,CAAA"}
+{"version":3,"file":"initiatives.js","sourceRoot":"","sources":["../../tools/initiatives.ts"],"names":[],"mappings":"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"}

package/dist/tools/programs.js

@@ -24,10 +24,59 @@ export const programTools = {
                 required: ['programId'],
             },
         },
+        {
+            name: 'anyforge_create_program',
+            description: 'Create a program (the cross-initiative grouping). Use this to set up a body of work ' +
+                'before adding initiatives under it. Requires `write` scope.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: 'Program name.' },
+                    description: { type: 'string', description: 'What the program is for.' },
+                    status: { type: 'string', description: 'PLANNING (default), IN_PROGRESS, COMPLETE, or CANCELLED.' },
+                    ownerId: { type: 'string', description: 'Owning operator uid. Defaults to the key user.' },
+                    targetDate: { type: 'string', description: 'Target completion date (ISO yyyy-mm-dd).' },
+                    coverageTarget: { type: 'number', description: 'Test-coverage goal 0–100 (e.g. 90).' },
+                    brief: { type: 'string', description: 'Program charter / brief (markdown).' },
+                    tags: { type: 'array', items: { type: 'string' }, description: 'Free-form tags.' },
+                },
+                required: ['name'],
+            },
+        },
+        {
+            name: 'anyforge_write_program_brief',
+            description: "Write or update a program's Brief — the canonical markdown charter (Purpose, Goals, Rationale, " +
+                'Scope (in/out), Success metrics, Key context & sources). Synthesize it from the program goal, the ' +
+                'codebases scoped in, this conversation, and any documents the user shared. The brief grounds future ' +
+                "Genesis chats and seeds each initiative's architect context, so a clear program purpose flows down " +
+                'to work-item decomposition. Call it once scope is clear, before creating the per-codebase ' +
+                'initiatives. Requires `write` scope.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    programId: { type: 'string', description: 'The program to write the brief on.' },
+                    brief: { type: 'string', description: 'The full program brief in markdown (≤16000 chars). Replaces the current brief.' },
+                },
+                required: ['programId', 'brief'],
+            },
+        },
     ],
     handlers: {
+        anyforge_write_program_brief: args => callControl('PATCH', `/programs/${encodeURIComponent(String(args.programId))}`, {
+            brief: args.brief,
+        }),
         anyforge_list_programs: args => callControl('GET', `/programs${qs({ status: args.status })}`),
         anyforge_get_program: args => callControl('GET', `/programs/${encodeURIComponent(String(args.programId))}`),
+        anyforge_create_program: args => callControl('POST', '/programs', {
+            name: args.name,
+            description: args.description,
+            status: args.status,
+            ownerId: args.ownerId,
+            targetDate: args.targetDate,
+            coverageTarget: args.coverageTarget,
+            brief: args.brief,
+            tags: args.tags,
+        }),
     },
 };
 //# sourceMappingURL=programs.js.map

package/dist/tools/programs.js.map

@@ -1 +1 @@
-{"version":3,"file":"programs.js","sourceRoot":"","sources":["../../tools/programs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAA;AAGrD;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAe;IACtC,KAAK,EAAE;QACL;YACE,IAAI,EAAE,wBAAwB;YAC9B,WAAW,EACT,gFAAgF;gBAChF,2FAA2F;YAC7F,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uCAAuC,EAAE;iBACjF;aACF;SACF;QACD;YACE,IAAI,EAAE,sBAAsB;YAC5B,WAAW,EAAE,6BAA6B;YAC1C,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE,EAAE;gBAC7E,QAAQ,EAAE,CAAC,WAAW,CAAC;aACxB;SACF;KACF;IACD,QAAQ,EAAE;QACR,sBAAsB,EAAE,IAAI,CAAC,EAAE,CAC7B,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAA4B,EAAE,CAAC,EAAE,CAAC;QACrF,oBAAoB,EAAE,IAAI,CAAC,EAAE,CAC3B,WAAW,CAAC,KAAK,EAAE,aAAa,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;KAChF;CACF,CAAA"}
+{"version":3,"file":"programs.js","sourceRoot":"","sources":["../../tools/programs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAA;AAGrD;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAe;IACtC,KAAK,EAAE;QACL;YACE,IAAI,EAAE,wBAAwB;YAC9B,WAAW,EACT,gFAAgF;gBAChF,2FAA2F;YAC7F,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uCAAuC,EAAE;iBACjF;aACF;SACF;QACD;YACE,IAAI,EAAE,sBAAsB;YAC5B,WAAW,EAAE,6BAA6B;YAC1C,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE,EAAE;gBAC7E,QAAQ,EAAE,CAAC,WAAW,CAAC;aACxB;SACF;QACD;YACE,IAAI,EAAE,yBAAyB;YAC/B,WAAW,EACT,sFAAsF;gBACtF,6DAA6D;YAC/D,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE;oBACtD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;oBACxE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0DAA0D,EAAE;oBACnG,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gDAAgD,EAAE;oBAC1F,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0CAA0C,EAAE;oBACvF,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qCAAqC,EAAE;oBACtF,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qCAAqC,EAAE;oBAC7E,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,iBAAiB,EAAE;iBACnF;gBACD,QAAQ,EAAE,CAAC,MAAM,CAAC;aACnB;SACF;QACD;YACE,IAAI,EAAE,8BAA8B;YACpC,WAAW,EACT,iGAAiG;gBACjG,oGAAoG;gBACpG,sGAAsG;gBACtG,qGAAqG;gBACrG,4FAA4F;gBAC5F,sCAAsC;YACxC,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oCAAoC,EAAE;oBAChF,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gFAAgF,EAAE;iBACzH;gBACD,QAAQ,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC;aACjC;SACF;KACF;IACD,QAAQ,EAAE;QACR,4BAA4B,EAAE,IAAI,CAAC,EAAE,CACnC,WAAW,CAAC,OAAO,EAAE,aAAa,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE;YAC9E,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;QACJ,sBAAsB,EAAE,IAAI,CAAC,EAAE,CAC7B,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAA4B,EAAE,CAAC,EAAE,CAAC;QACrF,oBAAoB,EAAE,IAAI,CAAC,EAAE,CAC3B,WAAW,CAAC,KAAK,EAAE,aAAa,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QAC/E,uBAAuB,EAAE,IAAI,CAAC,EAAE,CAC9B,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE;YAC/B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC;KACL;CACF,CAAA"}

package/dist/tools/repos.d.ts

@@ -0,0 +1,11 @@
+import type { ToolModule } from './types.js';
+/**
+ * Repo tools — read the org repo index and a single repo's analysis
+ * (the READ primitives Program Genesis uses to scope a program), kick
+ * codebase analysis directly, or launch the server-side paced coverage
+ * sweep that walks every repo through Phase 1 then Phase 2 without
+ * exhausting the operator's token window. Analysis/sweep run on the key
+ * user's credential (per-user OAuth → company key) and require `write`
+ * scope; the reads need only `read`.
+ */
+export declare const repoTools: ToolModule;

package/dist/tools/repos.js

@@ -0,0 +1,120 @@
+import { callControl, qs } from '../lib/apiClient.js';
+/**
+ * Repo tools — read the org repo index and a single repo's analysis
+ * (the READ primitives Program Genesis uses to scope a program), kick
+ * codebase analysis directly, or launch the server-side paced coverage
+ * sweep that walks every repo through Phase 1 then Phase 2 without
+ * exhausting the operator's token window. Analysis/sweep run on the key
+ * user's credential (per-user OAuth → company key) and require `write`
+ * scope; the reads need only `read`.
+ */
+export const repoTools = {
+    tools: [
+        {
+            name: 'anyforge_list_repo_index',
+            description: "List the repositories in this company's org-level repo index, with activity classification " +
+                '(active = pushed recently, stable = no recent pushes, deprecated = archived), whether each repo ' +
+                'already has an AnyForge analysis, and its known coverage %. Use this FIRST when scoping a ' +
+                'program to discover candidate codebases. Defaults to active repos. To scope a coverage/quality ' +
+                'program in one shot, pass belowCoverage (e.g. 90) — returns only repos with known coverage ' +
+                'below it, worst-first. The result includes total counts so you know how many were omitted by the cap.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    activityStatus: {
+                        type: 'string',
+                        enum: ['active', 'stable', 'deprecated', 'all'],
+                        description: 'Activity filter. Default "active".',
+                    },
+                    language: { type: 'string', description: 'Primary-language filter (exact, case-insensitive), e.g. "Go".' },
+                    belowCoverage: { type: 'number', description: 'Only repos with KNOWN coverage below this % (worst-first). Repos with unknown coverage are excluded.' },
+                    limit: { type: 'number', description: 'Max repos to return (default 100, max 200).' },
+                },
+            },
+        },
+        {
+            name: 'anyforge_get_repo_analysis',
+            description: 'Get the AnyForge analysis summary for a single repo (coverage %, architecture red/amber/green ' +
+                'counts, open gap count, languages) to assess its relevance and distance from the program goal. ' +
+                'Returns `analyzed: false` with a note when the repo has no analysis yet — it can still be scoped ' +
+                'in. Call this for the handful of repos you are unsure about, NOT for every repo in a large org.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    repoFullName: { type: 'string', description: 'The "owner/name" repo, exactly as listed by anyforge_list_repo_index.' },
+                },
+                required: ['repoFullName'],
+            },
+        },
+        {
+            name: 'anyforge_analyze_repos',
+            description: 'Start Phase-1 codebase analysis for one or more repos. Idempotent — already-analyzed ' +
+                'repos return `already_analyzed`, in-flight ones `already_running` (never re-run). Up to ' +
+                '25 repos per call; chunk larger sets or use anyforge_start_coverage_sweep instead. ' +
+                'Requires `write` scope.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    repos: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Repo full names ("owner/name"), max 25 per call.',
+                    },
+                },
+                required: ['repos'],
+            },
+        },
+        {
+            name: 'anyforge_start_coverage_sweep',
+            description: 'Launch a hands-off, paced analysis sweep: runs Phase 1 across every repo, then Phase 2, ' +
+                'keeping at most `concurrency` analyses in flight so the operator OAuth token window is ' +
+                'never exhausted. Seed from a programId (derives repos from its initiatives) or an explicit ' +
+                'repos list. Re-seeding overwrites the current sweep. Requires `write` scope.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    programId: {
+                        type: 'string',
+                        description: 'Derive the repo set from this program’s initiatives.',
+                    },
+                    repos: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Explicit repo full names ("owner/name"). Used when programId is omitted.',
+                    },
+                    concurrency: {
+                        type: 'number',
+                        description: 'Max in-flight analyses per phase (default 5, 1–10).',
+                    },
+                },
+            },
+        },
+        {
+            name: 'anyforge_refresh_repo_index',
+            description: 'Refresh the org repo index now instead of waiting for the nightly sweep. Re-lists every ' +
+                "repo's metadata AND auto-detects COMMITTED coverage: for repos with no crew/CI coverage, it " +
+                'reads the repo tree for a checked-in coverage report (lcov.info, coverage-summary.json, ' +
+                'cobertura, clover) and records the parsed %, so a repo that publishes coverage in git shows ' +
+                'a number without a crew run or a manual upload. Runs in the background — re-read the repo ' +
+                'index / coverage panel shortly after. Requires `write` scope.',
+            inputSchema: { type: 'object', properties: {} },
+        },
+    ],
+    handlers: {
+        anyforge_list_repo_index: args => callControl('GET', `/repos${qs({
+            activityStatus: args.activityStatus,
+            language: args.language,
+            belowCoverage: args.belowCoverage,
+            limit: args.limit,
+        })}`),
+        anyforge_get_repo_analysis: args => callControl('GET', `/repos/analysis${qs({ repo: args.repoFullName })}`),
+        anyforge_analyze_repos: args => callControl('POST', '/repos/analyze', { repos: args.repos }),
+        anyforge_start_coverage_sweep: args => callControl('POST', '/repos/analyze-sweep', {
+            programId: args.programId,
+            repos: args.repos,
+            concurrency: args.concurrency,
+        }),
+        anyforge_refresh_repo_index: () => callControl('POST', '/repos/index-refresh', {}),
+    },
+};
+//# sourceMappingURL=repos.js.map

package/dist/tools/repos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repos.js","sourceRoot":"","sources":["../../tools/repos.ts"],"names":[],"mappings":"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"}

package/dist/tools/types.d.ts

@@ -19,3 +19,21 @@ export interface ToolModule {
     tools: ToolDef[];
     handlers: Record<string, ToolHandler>;
 }
+/**
+ * MCP prompt — a server-provided, parameterised conversation starter.
+ * Claude Code surfaces these as slash commands (e.g.
+ * `/mcp__anyforge__genesis`), so they're the discoverable entry point
+ * for a guided flow. `render` turns the invocation arguments into the
+ * user-message text the client injects to kick off the conversation.
+ */
+export interface PromptArg {
+    name: string;
+    description: string;
+    required?: boolean;
+}
+export interface PromptDef {
+    name: string;
+    description: string;
+    arguments: PromptArg[];
+    render: (args: Record<string, string>) => string;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anyforge/mcp-server",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "AnyForge MCP Server — drive AnyForge (HIL approvals, initiatives, work items, crews) from Claude CLI, Cursor, and other MCP clients",
   "type": "module",
   "main": "./dist/index.js",