@context-forge/mcp 0.8.5 → 0.9.0

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+// MCP SDK: @modelcontextprotocol/sdk v1.26.0 (v1 monolithic package)
+// Zod: v4.1.5 — imported as `z` from 'zod'
+import { createRequire } from 'node:module';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { registerProjectTools } from './tools/projectTools.js';
+import { registerContextTools } from './tools/contextTools.js';
+import { registerStateTools } from './tools/stateTools.js';
+import { registerConfigTools } from './tools/configTools.js';
+import { registerIntrospectionTools } from './tools/introspectionTools.js';
+import { registerWorkflowTools } from './tools/workflowTools.js';
+import { registerWorktreeTools } from './tools/worktreeTools.js';
+import { registerVersionTool } from './tools/versionTool.js';
+import { registerGuideTools } from './tools/guideTools.js';
+import { registerAgentOnboardTool } from './tools/agentOnboardTool.js';
+import { registerAgentQuickstartTool } from './tools/agentQuickstartTool.js';
+const require = createRequire(import.meta.url);
+const { version: SERVER_VERSION } = require('../package.json');
+const SERVER_NAME = 'context-forge-mcp';
+function log(message) {
+    console.error(`[${SERVER_NAME}] ${message}`);
+}
+async function main() {
+    const server = new McpServer({
+        name: SERVER_NAME,
+        version: SERVER_VERSION,
+    });
+    // Registration order matters — some MCP clients truncate tool lists.
+    // High-priority tools first to maximize usability on limited clients.
+    registerAgentOnboardTool(server); // onboarding recipe for new projects
+    registerAgentQuickstartTool(server, SERVER_VERSION); // structured schema for machine consumers
+    registerProjectTools(server, SERVER_VERSION); // core: list, get, create, update
+    registerWorkflowTools(server); // what to do next
+    registerContextTools(server); // build prompts
+    registerGuideTools(server); // install/check guides
+    registerIntrospectionTools(server); // read project artifacts
+    registerWorktreeTools(server); // parallel work
+    registerConfigTools(server, SERVER_VERSION); // rarely needed
+    registerStateTools(server); // backup
+    registerVersionTool(server, SERVER_NAME, SERVER_VERSION);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    log('Server started');
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`[${SERVER_NAME}] Fatal error: ${message}`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,qEAAqE;AACrE,2CAA2C;AAE3C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAE7E,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AACtF,MAAM,WAAW,GAAG,mBAAmB,CAAC;AAExC,SAAS,GAAG,CAAC,OAAe;IAC1B,OAAO,CAAC,KAAK,CAAC,IAAI,WAAW,KAAK,OAAO,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,cAAc;KACxB,CAAC,CAAC;IAEH,qEAAqE;IACrE,sEAAsE;IACtE,wBAAwB,CAAC,MAAM,CAAC,CAAC,CAAK,qCAAqC;IAC3E,2BAA2B,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,0CAA0C;IAC/F,oBAAoB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,kCAAkC;IAChF,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAQ,kBAAkB;IACxD,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAS,gBAAgB;IACtD,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAW,uBAAuB;IAC7D,0BAA0B,CAAC,MAAM,CAAC,CAAC,CAAG,yBAAyB;IAC/D,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAQ,gBAAgB;IACtD,mBAAmB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,gBAAgB;IAC7D,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAW,SAAS;IAC/C,mBAAmB,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;IAEzD,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AACxB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,KAAK,CAAC,IAAI,WAAW,kBAAkB,OAAO,EAAE,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools/agentGuideTool.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerAgentGuideTool(server: McpServer): void;
+//# sourceMappingURL=agentGuideTool.d.ts.map

package/dist/tools/agentGuideTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentGuideTool.d.ts","sourceRoot":"","sources":["../../src/tools/agentGuideTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA2EpE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAc9D"}

package/dist/tools/agentGuideTool.js

@@ -0,0 +1,83 @@
+const AGENT_GUIDE = `# Context Forge — Agent Guide
+
+Context Forge manages AI-assisted development projects through structured phases:
+Concept → Architecture → Slice Planning → Slice Design → Task Breakdown → Implementation
+
+Call this tool first to understand what's available and how to use it.
+
+## Quick Start
+
+- **New user / no project yet?** Call **agent_onboard** — it returns step-by-step instructions to create a project and start working.
+- **Existing project?** Follow this sequence:
+
+1. **project_list** — See all registered projects. Find the one matching the user's current directory.
+2. **project_get** — Get full details for a project (phase, active slice, task file, etc.).
+3. **workflow_next** — Get the recommended next action with rationale and suggested command.
+4. **context_build** — Generate a structured context prompt for the current project state.
+
+## Tool Categories
+
+### Project (start here)
+- **project_list** — List all projects (use to find project by path)
+- **project_get** — Full project details with introspection
+- **project_create** — Create a new project (name + path required)
+- **project_update** — Update project fields
+- **project_schema** — Show all available project fields and valid values
+- **project_structure** — Show project directory structure
+
+### Workflow (what to do next)
+- **workflow_next** — Recommended next action based on project state
+- **workflow_status** — Current phase, slice, and task progress
+- **workflow_check** — Run consistency checks on project artifacts
+- **workflow_future** — Consolidated future work across slice plans
+
+### Context (build prompts)
+- **context_build** — Assemble a full context prompt for an AI session
+- **context_summarize** — Summarize project context
+- **template_preview** — Preview a prompt template with variables
+- **prompt_list** — List available prompt templates
+- **prompt_get** — Get a specific prompt template
+
+### Introspection (read project artifacts)
+- **introspection_documents** — Detect documents for a slice index
+- **introspection_frontmatter** — Parse YAML frontmatter from a document
+- **introspection_slice_plan** — Parse a slice plan file
+- **introspection_tasks** — Parse task files with completion state
+- **introspection_future_work** — Future work items across plans
+
+### Guides
+- **guide_status** — Check if the AI project guide is installed
+- **guide_install** — Install the methodology guide
+- **guide_update** — Update to latest guide version
+
+### Worktrees (parallel work in git worktrees)
+- **worktree_list**, **worktree_get**, **worktree_init**, **worktree_update**, **worktree_rm**
+
+### Configuration
+- **config_get** — Get a single config key, or omit key to list all settings (rarely needed)
+- **config_set** — Set a config value at user or project scope
+
+### Meta
+- **agent_onboard** — Step-by-step onboarding recipe for new projects
+- **server_version** — Server name and version
+- **storage_backup** — Create a versioned backup of project data
+
+## Common Mistakes
+
+- Do NOT start with config_get — configuration is rarely relevant to the user's task.
+- Do NOT call project_update without the user asking to change something.
+- Do NOT guess project IDs — call project_list first to find the right one.
+- If the user says "what's next" or "what should I do", call workflow_next.
+- If the user wants to start a session, call context_build for a full context prompt.
+`;
+export function registerAgentGuideTool(server) {
+    server.registerTool('agent_guide', {
+        title: 'Agent Guide',
+        description: 'How to use Context Forge tools. Call this first to understand available tools, common workflows, and what to avoid.',
+        inputSchema: {},
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async () => ({
+        content: [{ type: 'text', text: AGENT_GUIDE }],
+    }));
+}
+//# sourceMappingURL=agentGuideTool.js.map

package/dist/tools/agentGuideTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentGuideTool.js","sourceRoot":"","sources":["../../src/tools/agentGuideTool.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuEnB,CAAC;AAEF,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,KAAK,EAAE,aAAa;QACpB,WAAW,EACT,qHAAqH;QACvH,WAAW,EAAE,EAAE;QACf,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KAC1D,EACD,KAAK,IAAI,EAAE,CAAC,CAAC;QACX,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;KACxD,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/tools/agentOnboardTool.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerAgentOnboardTool(server: McpServer): void;
+//# sourceMappingURL=agentOnboardTool.d.ts.map

package/dist/tools/agentOnboardTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentOnboardTool.d.ts","sourceRoot":"","sources":["../../src/tools/agentOnboardTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiEpE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0BhE"}

package/dist/tools/agentOnboardTool.js

@@ -0,0 +1,85 @@
+import { z } from 'zod';
+const ONBOARD_GUIDE = `# Context Forge Onboarding
+
+Follow these steps in order to set up a new Context Forge project and guide the
+user into their first phase of work. Skip any step whose precondition is already met.
+
+## Step 1 — Detect existing project
+
+Check whether a Context Forge project is already registered at the current
+working directory.
+
+Call \`project_list\`. Scan results for a project whose \`projectPath\` matches
+the current directory.
+
+- If a project exists at this path → skip to Step 3.
+- If no project exists → continue to Step 2.
+
+## Step 2 — Create project
+
+Ask the user what they'd like to name their project. If a project name argument
+was provided, use that. If the user declines to choose, default to the current
+directory name.
+
+Run \`cf init <name>\` via the shell. This single command handles everything:
+git initialization, project registration, guide installation, command
+installation, and IDE setup.
+
+**Important:** Do not rely on environment context (like "Is a git repository")
+to determine git status — \`cf init\` checks the actual directory and handles
+git initialization itself.
+
+If shell access is unavailable, fall back to the MCP path:
+1. Call \`project_create\` with \`name\` and \`projectPath\` (the CWD).
+2. Call \`guide_install\` to install the AI Project Guide.
+Note: the MCP fallback cannot initialize git. If the directory is not a git
+repository, inform the user they need to run \`git init\` first.
+
+## Step 3 — Transition to concept discussion
+
+The project is set up. Now begin the Phase 0 (Concept) conversation.
+
+Call \`context_build\` to generate the concept-phase context prompt. Use the
+returned prompt as your working context to guide the conversation.
+
+Begin by asking the user to describe what they want to build. Guide them through
+the concept exploration naturally — the context prompt provides the structure.
+The goal is a concept document at the end of this conversation.
+
+## Step 4 — Mention ongoing guidance
+
+After the concept conversation concludes (or if the user wants to pause),
+mention that \`workflow_next\` (or \`cf next\` on the CLI) provides ongoing
+guidance that adapts as the project progresses.
+
+## Notes
+
+- If the user already has a project but is in a later phase (not Phase 0),
+  acknowledge this and call \`workflow_next\` instead of starting a concept
+  discussion.
+- Keep the conversation natural. This is onboarding, not a checklist.
+  Adapt to what the user is telling you.
+`;
+export function registerAgentOnboardTool(server) {
+    server.registerTool('agent_onboard', {
+        title: 'Onboard New Project',
+        description: 'Step-by-step instructions for setting up a new Context Forge project and guiding the user into their first phase of work. ' +
+            'Returns an onboarding recipe the agent should follow. Optionally accepts a project name.',
+        inputSchema: {
+            projectName: z
+                .string()
+                .optional()
+                .describe('Optional project name. If omitted, the agent should use the directory name or ask the user.'),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async ({ projectName }) => {
+        let text = ONBOARD_GUIDE;
+        if (projectName) {
+            text += `\n**Project name provided:** ${projectName}\n`;
+        }
+        return {
+            content: [{ type: 'text', text }],
+        };
+    });
+}
+//# sourceMappingURL=agentOnboardTool.js.map

package/dist/tools/agentOnboardTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentOnboardTool.js","sourceRoot":"","sources":["../../src/tools/agentOnboardTool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4DrB,CAAC;AAEF,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACxD,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACT,4HAA4H;YAC5H,0FAA0F;QAC5F,WAAW,EAAE;YACX,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,6FAA6F,CAAC;SAC3G;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KAC1D,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;QACxB,IAAI,IAAI,GAAG,aAAa,CAAC;QACzB,IAAI,WAAW,EAAE,CAAC;YAChB,IAAI,IAAI,gCAAgC,WAAW,IAAI,CAAC;QAC1D,CAAC;QACD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC;SAC3C,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/agentQuickstartTool.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerAgentQuickstartTool(server: McpServer, version: string): void;
+//# sourceMappingURL=agentQuickstartTool.d.ts.map

package/dist/tools/agentQuickstartTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentQuickstartTool.d.ts","sourceRoot":"","sources":["../../src/tools/agentQuickstartTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAoDpE,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAcpF"}

package/dist/tools/agentQuickstartTool.js

@@ -0,0 +1,60 @@
+function buildQuickstartSchema(version) {
+    return {
+        server: '@context-forge/mcp',
+        version,
+        capabilities: {
+            projectManagement: {
+                description: 'Create, read, update projects with persistent state',
+                tools: ['project_list', 'project_get', 'project_create', 'project_update', 'project_schema', 'project_structure'],
+            },
+            contextGeneration: {
+                description: 'Build structured prompts from project state',
+                tools: ['context_build', 'context_summarize', 'template_preview', 'prompt_list', 'prompt_get'],
+            },
+            workflowGuidance: {
+                description: 'Phase-aware recommendations and consistency checks',
+                tools: ['workflow_next', 'workflow_status', 'workflow_check', 'workflow_future'],
+            },
+            introspection: {
+                description: 'Read project artifacts, slice plans, task state',
+                tools: ['introspection_documents', 'introspection_frontmatter', 'introspection_slice_plan', 'introspection_tasks', 'introspection_future_work'],
+            },
+            guides: {
+                description: 'Install and manage the AI project methodology guide',
+                tools: ['guide_status', 'guide_install', 'guide_update'],
+            },
+            worktrees: {
+                description: 'Parallel work in git worktrees with slice range isolation',
+                tools: ['worktree_list', 'worktree_get', 'worktree_init', 'worktree_update', 'worktree_rm'],
+            },
+            configuration: {
+                description: 'Two-tier config (user + project scope)',
+                tools: ['config_get', 'config_set'],
+            },
+        },
+        quickStart: [
+            'Call project_list to find or verify the target project',
+            'Call project_get with the project ID for full state',
+            'Call workflow_next for the recommended action',
+            'Call context_build to generate a session prompt',
+        ],
+        cliEquivalents: {
+            project_list: 'cf list projects --json',
+            project_get: 'cf get --json',
+            workflow_next: 'cf next --json',
+            workflow_status: 'cf status --json',
+            context_build: 'cf build --json',
+        },
+    };
+}
+export function registerAgentQuickstartTool(server, version) {
+    server.registerTool('agent_quickstart', {
+        title: 'Agent Quickstart',
+        description: 'Structured capability schema for machine consumers. Returns tool groupings, quickstart sequence, and CLI equivalents — designed for orchestrators and CI pipelines, not human-supervised sessions.',
+        inputSchema: {},
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async () => ({
+        content: [{ type: 'text', text: JSON.stringify(buildQuickstartSchema(version), null, 2) }],
+    }));
+}
+//# sourceMappingURL=agentQuickstartTool.js.map

package/dist/tools/agentQuickstartTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentQuickstartTool.js","sourceRoot":"","sources":["../../src/tools/agentQuickstartTool.ts"],"names":[],"mappings":"AAEA,SAAS,qBAAqB,CAAC,OAAe;IAC5C,OAAO;QACL,MAAM,EAAE,oBAAoB;QAC5B,OAAO;QACP,YAAY,EAAE;YACZ,iBAAiB,EAAE;gBACjB,WAAW,EAAE,qDAAqD;gBAClE,KAAK,EAAE,CAAC,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,mBAAmB,CAAC;aAClH;YACD,iBAAiB,EAAE;gBACjB,WAAW,EAAE,6CAA6C;gBAC1D,KAAK,EAAE,CAAC,eAAe,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,aAAa,EAAE,YAAY,CAAC;aAC/F;YACD,gBAAgB,EAAE;gBAChB,WAAW,EAAE,oDAAoD;gBACjE,KAAK,EAAE,CAAC,eAAe,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,iBAAiB,CAAC;aACjF;YACD,aAAa,EAAE;gBACb,WAAW,EAAE,iDAAiD;gBAC9D,KAAK,EAAE,CAAC,yBAAyB,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,2BAA2B,CAAC;aAChJ;YACD,MAAM,EAAE;gBACN,WAAW,EAAE,qDAAqD;gBAClE,KAAK,EAAE,CAAC,cAAc,EAAE,eAAe,EAAE,cAAc,CAAC;aACzD;YACD,SAAS,EAAE;gBACT,WAAW,EAAE,2DAA2D;gBACxE,KAAK,EAAE,CAAC,eAAe,EAAE,cAAc,EAAE,eAAe,EAAE,iBAAiB,EAAE,aAAa,CAAC;aAC5F;YACD,aAAa,EAAE;gBACb,WAAW,EAAE,wCAAwC;gBACrD,KAAK,EAAE,CAAC,YAAY,EAAE,YAAY,CAAC;aACpC;SACF;QACD,UAAU,EAAE;YACV,wDAAwD;YACxD,qDAAqD;YACrD,+CAA+C;YAC/C,iDAAiD;SAClD;QACD,cAAc,EAAE;YACd,YAAY,EAAE,yBAAyB;YACvC,WAAW,EAAE,eAAe;YAC5B,aAAa,EAAE,gBAAgB;YAC/B,eAAe,EAAE,kBAAkB;YACnC,aAAa,EAAE,iBAAiB;SACjC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,MAAiB,EAAE,OAAe;IAC5E,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,KAAK,EAAE,kBAAkB;QACzB,WAAW,EACT,oMAAoM;QACtM,WAAW,EAAE,EAAE;QACf,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KAC1D,EACD,KAAK,IAAI,EAAE,CAAC,CAAC;QACX,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,qBAAqB,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KACpG,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/tools/configTools.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerConfigTools(server: McpServer, serverVersion?: string): void;
+//# sourceMappingURL=configTools.d.ts.map

package/dist/tools/configTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configTools.d.ts","sourceRoot":"","sources":["../../src/tools/configTools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAiFnF"}

package/dist/tools/configTools.js

@@ -0,0 +1,76 @@
+import { z } from 'zod';
+import { ConfigManager, getUserConfigPath, getProjectConfigPath } from '@context-forge/core/node';
+import { errorResult, jsonResult } from './contextTools.js';
+export function registerConfigTools(server, serverVersion) {
+    // --- config_get ---
+    server.registerTool('config_get', {
+        title: 'Get Config Value',
+        description: 'Get configuration. With a key, returns that key\'s value, source, and description. ' +
+            'Without a key, returns all keys with current values, sources, and defaults. ' +
+            'Resolution order: project config → user config → built-in default.',
+        inputSchema: {
+            key: z.string().optional().describe('Config key to retrieve (e.g. "guide.source", "guide.git_strategy"). Omit to list all keys.'),
+            projectPath: z
+                .string()
+                .optional()
+                .describe('Absolute path to project root, to include project-level config in resolution'),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async ({ key, projectPath }) => {
+        try {
+            const cm = new ConfigManager(projectPath);
+            const serverInfo = serverVersion
+                ? { serverVersion, hint: 'Call agent_quickstart for tool orientation, agent_onboard for new project setup.' }
+                : undefined;
+            if (key) {
+                const result = await cm.get(key);
+                return jsonResult({ ...result, ...(serverInfo && { serverInfo }) });
+            }
+            const entries = await cm.list();
+            return jsonResult({
+                entries,
+                configPaths: {
+                    user: getUserConfigPath(),
+                    project: projectPath ? getProjectConfigPath(projectPath) : null,
+                },
+                ...(serverInfo && { serverInfo }),
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return errorResult(message);
+        }
+    });
+    // --- config_set ---
+    server.registerTool('config_set', {
+        title: 'Set Config Value',
+        description: 'Set a configuration key to a new value at user or project scope. ' +
+            'Use scope="user" for machine-wide defaults, scope="project" to override for a specific project.',
+        inputSchema: {
+            key: z.string().describe('Config key to set (e.g. "guide.source", "guide.auto_update")'),
+            value: z
+                .union([z.string(), z.boolean(), z.number()])
+                .describe('Value to set. Must match the key\'s expected type.'),
+            scope: z
+                .enum(['user', 'project'])
+                .describe('Scope: "user" writes to user-level config, "project" writes to project-level config'),
+            projectPath: z
+                .string()
+                .optional()
+                .describe('Absolute path to project root. Required when scope is "project".'),
+        },
+        annotations: { destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async ({ key, value, scope, projectPath }) => {
+        try {
+            const cm = new ConfigManager(projectPath);
+            await cm.set(key, value, scope);
+            const result = await cm.get(key);
+            return jsonResult({ success: true, ...result });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return errorResult(message);
+        }
+    });
+}
+//# sourceMappingURL=configTools.js.map

package/dist/tools/configTools.js.map

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

package/dist/tools/contextTools.d.ts

@@ -0,0 +1,28 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ProjectData } from '@context-forge/core';
+export declare function errorResult(message: string): {
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    isError: true;
+};
+export declare function textResult(text: string): {
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+};
+export declare function jsonResult(data: unknown): {
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+};
+/**
+ * Shared context generation helper used by context_build and template_preview.
+ * Loads a project, applies optional overrides, generates context via core pipeline.
+ */
+export declare function generateContext(projectId: string, overrides?: Partial<ProjectData>, additionalInstructions?: string, worktreeId?: string): Promise<string>;
+export declare function registerContextTools(server: McpServer): void;
+//# sourceMappingURL=contextTools.d.ts.map

package/dist/tools/contextTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextTools.d.ts","sourceRoot":"","sources":["../../src/tools/contextTools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAKvD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,CAEzG;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,CAEtF;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,CAEvF;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,EAChC,sBAAsB,CAAC,EAAE,MAAM,EAC/B,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAkCjB;AAsCD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2M5D"}