@projitive/mcp 2.0.3 → 2.1.0

package/output/source/index.test.js

@@ -1,46 +1,46 @@
-import { describe, it, expect, beforeAll, afterAll, vi, beforeEach } from "vitest";
-import fs from "node:fs/promises";
-import path from "node:path";
-import os from "node:os";
-import { fileURLToPath } from "node:url";
+import { describe, it, expect, beforeAll, afterAll, vi, beforeEach } from 'vitest';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import os from 'node:os';
+import { fileURLToPath } from 'node:url';
 const currentFilePath = fileURLToPath(import.meta.url);
 const sourceDir = path.dirname(currentFilePath);
 // Mock McpServer and StdioServerTransport
-vi.mock("@modelcontextprotocol/sdk/server/mcp.js", () => ({
+vi.mock('@modelcontextprotocol/sdk/server/mcp.js', () => ({
     McpServer: vi.fn().mockImplementation(() => ({
         registerResource: vi.fn(),
         registerPrompt: vi.fn(),
         connect: vi.fn().mockResolvedValue(undefined),
     })),
 }));
-vi.mock("@modelcontextprotocol/sdk/server/stdio.js", () => ({
+vi.mock('@modelcontextprotocol/sdk/server/stdio.js', () => ({
     StdioServerTransport: vi.fn().mockImplementation(() => ({})),
 }));
 // Mock the registration functions
-vi.mock("./tools/project.js", () => ({
+vi.mock('./tools/project.js', () => ({
     registerProjectTools: vi.fn(),
 }));
-vi.mock("./tools/task.js", () => ({
+vi.mock('./tools/task.js', () => ({
     registerTaskTools: vi.fn(),
 }));
-vi.mock("./tools/roadmap.js", () => ({
+vi.mock('./tools/roadmap.js', () => ({
     registerRoadmapTools: vi.fn(),
 }));
-vi.mock("./resources/governance.js", () => ({
+vi.mock('./resources/governance.js', () => ({
     registerGovernanceResources: vi.fn(),
 }));
-vi.mock("./resources/designs.js", () => ({
+vi.mock('./resources/designs.js', () => ({
     registerDesignFilesResources: vi.fn(),
 }));
-vi.mock("./prompts/governance.js", () => ({
+vi.mock('./prompts/governance.js', () => ({
     registerGovernancePrompts: vi.fn(),
 }));
-describe("index module", () => {
+describe('index module', () => {
     let tempDir;
     let testProjectDir;
     beforeAll(async () => {
-        tempDir = await fs.mkdtemp(path.join(os.tmpdir(), "projitive-index-test-"));
-        testProjectDir = path.join(tempDir, "test-project");
+        tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'projitive-index-test-'));
+        testProjectDir = path.join(tempDir, 'test-project');
         await fs.mkdir(testProjectDir);
     });
     afterAll(async () => {
@@ -49,62 +49,62 @@ describe("index module", () => {
     beforeEach(() => {
         vi.clearAllMocks();
     });
-    it("should export the main server entry point", async () => {
-        const indexPath = path.join(sourceDir, "index.ts");
+    it('should export the main server entry point', async () => {
+        const indexPath = path.join(sourceDir, 'index.ts');
         const exists = await fs.access(indexPath).then(() => true).catch(() => false);
         expect(exists).toBe(true);
     });
-    it("should have the correct shebang and imports", async () => {
-        const indexPath = path.join(sourceDir, "index.ts");
-        const content = await fs.readFile(indexPath, "utf-8");
-        expect(content.startsWith("#!/usr/bin/env node")).toBe(true);
-        expect(content).toContain("McpServer");
-        expect(content).toContain("StdioServerTransport");
-        expect(content).toContain("registerTools");
-        expect(content).toContain("registerResources");
-        expect(content).toContain("registerPrompts");
+    it('should have the correct shebang and imports', async () => {
+        const indexPath = path.join(sourceDir, 'index.ts');
+        const content = await fs.readFile(indexPath, 'utf-8');
+        expect(content.startsWith('#!/usr/bin/env node')).toBe(true);
+        expect(content).toContain('McpServer');
+        expect(content).toContain('StdioServerTransport');
+        expect(content).toContain('registerTools');
+        expect(content).toContain('registerResources');
+        expect(content).toContain('registerPrompts');
     });
-    it("should define PROJITIVE_SPEC_VERSION as 1.1.0", async () => {
-        const indexPath = path.join(sourceDir, "index.ts");
-        const content = await fs.readFile(indexPath, "utf-8");
-        expect(content).toContain("PROJITIVE_SPEC_VERSION");
-        expect(content).toContain('"1.1.0"');
+    it('should define PROJITIVE_SPEC_VERSION as 1.1.0', async () => {
+        const indexPath = path.join(sourceDir, 'index.ts');
+        const content = await fs.readFile(indexPath, 'utf-8');
+        expect(content).toContain('PROJITIVE_SPEC_VERSION');
+        expect(content).toContain("'1.1.0'");
     });
-    it("should have main function with server startup", async () => {
-        const indexPath = path.join(sourceDir, "index.ts");
-        const content = await fs.readFile(indexPath, "utf-8");
-        expect(content).toContain("async function main");
-        expect(content).toContain("server.connect");
-        expect(content).toContain("StdioServerTransport");
+    it('should have main function with server startup', async () => {
+        const indexPath = path.join(sourceDir, 'index.ts');
+        const content = await fs.readFile(indexPath, 'utf-8');
+        expect(content).toContain('async function main');
+        expect(content).toContain('server.connect');
+        expect(content).toContain('StdioServerTransport');
     });
-    it("should register all tool categories", async () => {
-        const indexPath = path.join(sourceDir, "index.ts");
-        const content = await fs.readFile(indexPath, "utf-8");
-        expect(content).toContain("registerTools(server)");
-        expect(content).toContain("registerResources(server, repoRoot)");
-        expect(content).toContain("registerPrompts(server)");
+    it('should register all tool categories', async () => {
+        const indexPath = path.join(sourceDir, 'index.ts');
+        const content = await fs.readFile(indexPath, 'utf-8');
+        expect(content).toContain('registerTools(server)');
+        expect(content).toContain('registerResources(server, repoRoot)');
+        expect(content).toContain('registerPrompts(server)');
     });
-    it("should have proper error handling in main", async () => {
-        const indexPath = path.join(sourceDir, "index.ts");
-        const content = await fs.readFile(indexPath, "utf-8");
-        expect(content).toContain("void main().catch");
-        expect(content).toContain("console.error(\"Server error:\", error)");
-        expect(content).toContain("process.exit(1)");
+    it('should have proper error handling in main', async () => {
+        const indexPath = path.join(sourceDir, 'index.ts');
+        const content = await fs.readFile(indexPath, 'utf-8');
+        expect(content).toContain('void main().catch');
+        expect(content).toContain("console.error('Server error:', error)");
+        expect(content).toContain('process.exit(1)');
     });
-    it("should log server startup information", async () => {
-        const indexPath = path.join(sourceDir, "index.ts");
-        const content = await fs.readFile(indexPath, "utf-8");
-        expect(content).toContain("console.error(`[projitive-mcp] starting server`)");
-        expect(content).toContain("console.error(`[projitive-mcp] version=");
-        expect(content).toContain("spec=");
-        expect(content).toContain("transport=stdio");
-        expect(content).toContain("pid=");
+    it('should log server startup information', async () => {
+        const indexPath = path.join(sourceDir, 'index.ts');
+        const content = await fs.readFile(indexPath, 'utf-8');
+        expect(content).toContain("console.error('[projitive-mcp] starting server')");
+        expect(content).toContain('console.error(`[projitive-mcp] version=');
+        expect(content).toContain('spec=');
+        expect(content).toContain('transport=stdio');
+        expect(content).toContain('pid=');
     });
-    it("should define MCP server with correct metadata", async () => {
-        const indexPath = path.join(sourceDir, "index.ts");
-        const content = await fs.readFile(indexPath, "utf-8");
-        expect(content).toContain("name: \"projitive\"");
-        expect(content).toContain("version: MCP_RUNTIME_VERSION");
-        expect(content).toContain("description:");
+    it('should define MCP server with correct metadata', async () => {
+        const indexPath = path.join(sourceDir, 'index.ts');
+        const content = await fs.readFile(indexPath, 'utf-8');
+        expect(content).toContain("name: 'projitive'");
+        expect(content).toContain('version: MCP_RUNTIME_VERSION');
+        expect(content).toContain('description:');
     });
 });

package/output/source/prompts/index.js

@@ -1,7 +1,7 @@
 // Governance workflow prompts
-import { registerQuickStartPrompt } from "./quickStart.js";
-import { registerTaskDiscoveryPrompt } from "./taskDiscovery.js";
-import { registerTaskExecutionPrompt } from "./taskExecution.js";
+import { registerQuickStartPrompt } from './quickStart.js';
+import { registerTaskDiscoveryPrompt } from './taskDiscovery.js';
+import { registerTaskExecutionPrompt } from './taskExecution.js';
 export function registerPrompts(server) {
     registerQuickStartPrompt(server);
     registerTaskDiscoveryPrompt(server);

package/output/source/prompts/index.test.js

@@ -0,0 +1,23 @@
+import { describe, expect, it, vi } from 'vitest';
+vi.mock('./quickStart.js', () => ({
+    registerQuickStartPrompt: vi.fn(),
+}));
+vi.mock('./taskDiscovery.js', () => ({
+    registerTaskDiscoveryPrompt: vi.fn(),
+}));
+vi.mock('./taskExecution.js', () => ({
+    registerTaskExecutionPrompt: vi.fn(),
+}));
+import { registerQuickStartPrompt } from './quickStart.js';
+import { registerTaskDiscoveryPrompt } from './taskDiscovery.js';
+import { registerTaskExecutionPrompt } from './taskExecution.js';
+import { registerPrompts } from './index.js';
+describe('prompts index module', () => {
+    it('registers all prompt categories', () => {
+        const server = {};
+        registerPrompts(server);
+        expect(registerQuickStartPrompt).toHaveBeenCalledWith(server);
+        expect(registerTaskDiscoveryPrompt).toHaveBeenCalledWith(server);
+        expect(registerTaskExecutionPrompt).toHaveBeenCalledWith(server);
+    });
+});

package/output/source/prompts/quickStart.js

@@ -1,11 +1,11 @@
-import { z } from "zod";
+import { z } from 'zod';
 function asUserPrompt(text) {
     return {
         messages: [
             {
-                role: "user",
+                role: 'user',
                 content: {
-                    type: "text",
+                    type: 'text',
                     text,
                 },
             },
@@ -13,108 +13,108 @@ function asUserPrompt(text) {
     };
 }
 export function registerQuickStartPrompt(server) {
-    server.registerPrompt("quickStart", {
-        title: "Quick Start",
-        description: "Complete workflow to discover project, load context, and start task execution",
+    server.registerPrompt('quickStart', {
+        title: 'Quick Start',
+        description: 'Complete workflow to discover project, load context, and start task execution',
         argsSchema: {
             projectPath: z.string().optional(),
         },
     }, async ({ projectPath }) => {
         const text = [
-            "# How to Govern a Project",
-            "",
-            "You are a Projitive governance assistant. Here is the complete workflow:",
-            "",
-            "## Step 1: Discover the Project",
-            "",
+            '# How to Govern a Project',
+            '',
+            'You are a Projitive governance assistant. Here is the complete workflow:',
+            '',
+            '## Step 1: Discover the Project',
+            '',
             projectPath
                 ? [
                     `- Known project path: "${projectPath}"`,
-                    "- Call `projectContext(projectPath=\"" + projectPath + "\")` directly to load project overview",
-                ].join("\n")
+                    '- Call `projectContext(projectPath="' + projectPath + '")` directly to load project overview',
+                ].join('\n')
                 : [
-                    "- Unknown project path:",
-                    "  1. Call `projectScan()` to discover all governance roots",
-                    "  2. Select a target project",
-                    "  3. Call `projectLocate(inputPath=\"<selected-path>\")` to lock governance root",
-                    "  4. Call `projectContext(projectPath=\"<project-path>\")` to load project overview",
-                ].join("\n"),
-            "",
-            "## Step 2: Understand the Project",
-            "",
-            "After loading project context, read these resources:",
-            "- projitive://governance/workspace - Project overview",
-            "- projitive://governance/tasks - Current task pool",
-            "- projitive://governance/roadmap - Project roadmap",
-            "- projitive://designs/* - Design documents",
-            "",
-            "## Step 3: Discover Tasks",
-            "",
-            "Two ways to discover tasks:",
-            "",
-            "### Option A: Auto-select (Recommended)",
-            "Call `taskNext()` to get highest-priority actionable task.",
-            "If no actionable tasks are returned and roadmap has active goals, analyze roadmap context and create 1-3 TODO tasks via `taskCreate()`.",
-            "Then call `taskNext()` again to re-rank.",
-            "",
-            "### Option B: Manual select",
-            "1. Call `taskList()` to list all tasks",
-            "2. Select a task based on status and priority",
-            "3. Call `taskContext(projectPath=\"...\", taskId=\"...\")` for details",
-            "",
-            "## Step 4: Execute the Task",
-            "",
-            "After getting task context:",
-            "1. Read evidence links in Suggested Read Order",
-            "2. Understand task requirements and acceptance criteria",
-            "3. Write governance source via tools (`taskCreate` / `taskUpdate` / `roadmapCreate` / `roadmapUpdate`) instead of editing tasks.md/roadmap.md directly",
-            "4. Update docs (`designs/` / `reports/`) as required by evidence",
-            "5. taskCreate/taskUpdate/roadmapCreate/roadmapUpdate will auto-sync corresponding markdown views",
-            "6. Update task status:",
-            "   - TODO → IN_PROGRESS (when starting execution)",
-            "   - IN_PROGRESS → DONE (when completed)",
-            "   - IN_PROGRESS → BLOCKED (when blocked)",
-            "7. Re-run taskContext() to verify changes",
-            "",
-            "## Autonomous Operating Loop",
-            "",
-            "Keep this loop until no high-value actionable work remains:",
-            "1. Discover: `taskNext()`",
-            "2. Execute: update governance store + docs + report evidence",
-            "3. Verify: `taskContext()`",
-            "4. Re-prioritize: `taskNext()`",
-            "",
-            "Stop and re-discover only when:",
-            "- Current task is BLOCKED with a clear blocker description and unblock condition",
-            "- Acceptance criteria are met and status is DONE",
-            "- Project has no actionable tasks and requires roadmap-driven task creation",
-            "",
-            "## Special Cases",
-            "",
-            "### Case 1: No .projitive directory",
-            "Call `projectInit(projectPath=\"<project-dir>\")` to initialize governance structure.",
-            "",
-            "### Case 2: No actionable tasks",
-            "1. Check if .projitive database is missing",
-            "2. If roadmap has active goals, split milestones into 1-3 executable TODO tasks",
-            "3. Apply task creation gate before adding each task:",
-            "   - Clear outcome: one-sentence done condition",
-            "   - Verifiable evidence: at least one report/designs/readme link target",
-            "   - Small slice: should be completable in one focused execution cycle",
-            "   - Traceability: include at least one roadmapRefs item when applicable",
-            "   - Distinct scope: avoid overlap with existing DONE/BLOCKED tasks",
-            "4. Prefer unblocking tasks that unlock multiple follow-up tasks",
-            "5. Re-run `taskNext()` to pick the new tasks",
-            "6. If still no tasks, read design documents in projitive://designs/ and create TODO tasks via `taskCreate()`",
-            "",
-            "## Hard Rules",
-            "",
-            "- **NEVER modify TASK/ROADMAP IDs** - Keep them immutable once assigned",
-            "- **Every status transition must have report evidence** - Create execution reports in reports/ directory",
-            "- **.projitive governance store is source of truth** - tasks.md/roadmap.md are generated views and may be overwritten",
-            "- **Prefer tool writes over manual table/view edits** - Use taskCreate/taskUpdate/roadmapCreate/roadmapUpdate",
-            "- **Always verify after updates** - Re-run taskContext() to confirm reference consistency",
-        ].join("\n");
+                    '- Unknown project path:',
+                    '  1. Call `projectScan()` to discover all governance roots',
+                    '  2. Select a target project',
+                    '  3. Call `projectLocate(inputPath="<selected-path>")` to lock governance root',
+                    '  4. Call `projectContext(projectPath="<project-path>")` to load project overview',
+                ].join('\n'),
+            '',
+            '## Step 2: Understand the Project',
+            '',
+            'After loading project context, read these resources:',
+            '- projitive://governance/workspace - Project overview',
+            '- projitive://governance/tasks - Current task pool',
+            '- projitive://governance/roadmap - Project roadmap',
+            '- projitive://designs/* - Design documents',
+            '',
+            '## Step 3: Discover Tasks',
+            '',
+            'Two ways to discover tasks:',
+            '',
+            '### Option A: Auto-select (Recommended)',
+            'Call `taskNext()` to get highest-priority actionable task.',
+            'If no actionable tasks are returned and roadmap has active goals, analyze roadmap context and create 1-3 TODO tasks via `taskCreate()`.',
+            'Then call `taskNext()` again to re-rank.',
+            '',
+            '### Option B: Manual select',
+            '1. Call `taskList()` to list all tasks',
+            '2. Select a task based on status and priority',
+            '3. Call `taskContext(projectPath="...", taskId="...")` for details',
+            '',
+            '## Step 4: Execute the Task',
+            '',
+            'After getting task context:',
+            '1. Read evidence links in Suggested Read Order',
+            '2. Understand task requirements and acceptance criteria',
+            '3. Write governance source via tools (`taskCreate` / `taskUpdate` / `roadmapCreate` / `roadmapUpdate`) instead of editing tasks.md/roadmap.md directly',
+            '4. Update docs (`designs/` / `reports/`) as required by evidence',
+            '5. taskCreate/taskUpdate/roadmapCreate/roadmapUpdate will auto-sync corresponding markdown views',
+            '6. Update task status:',
+            '   - TODO → IN_PROGRESS (when starting execution)',
+            '   - IN_PROGRESS → DONE (when completed)',
+            '   - IN_PROGRESS → BLOCKED (when blocked)',
+            '7. Re-run taskContext() to verify changes',
+            '',
+            '## Autonomous Operating Loop',
+            '',
+            'Keep this loop until no high-value actionable work remains:',
+            '1. Discover: `taskNext()`',
+            '2. Execute: update governance store + docs + report evidence',
+            '3. Verify: `taskContext()`',
+            '4. Re-prioritize: `taskNext()`',
+            '',
+            'Stop and re-discover only when:',
+            '- Current task is BLOCKED with a clear blocker description and unblock condition',
+            '- Acceptance criteria are met and status is DONE',
+            '- Project has no actionable tasks and requires roadmap-driven task creation',
+            '',
+            '## Special Cases',
+            '',
+            '### Case 1: No .projitive directory',
+            'Call `projectInit(projectPath="<project-dir>")` to initialize governance structure.',
+            '',
+            '### Case 2: No actionable tasks',
+            '1. Check if .projitive database is missing',
+            '2. If roadmap has active goals, split milestones into 1-3 executable TODO tasks',
+            '3. Apply task creation gate before adding each task:',
+            '   - Clear outcome: one-sentence done condition',
+            '   - Verifiable evidence: at least one report/designs/readme link target',
+            '   - Small slice: should be completable in one focused execution cycle',
+            '   - Traceability: include at least one roadmapRefs item when applicable',
+            '   - Distinct scope: avoid overlap with existing DONE/BLOCKED tasks',
+            '4. Prefer unblocking tasks that unlock multiple follow-up tasks',
+            '5. Re-run `taskNext()` to pick the new tasks',
+            '6. If still no tasks, read design documents in projitive://designs/ and create TODO tasks via `taskCreate()`',
+            '',
+            '## Hard Rules',
+            '',
+            '- **NEVER modify TASK/ROADMAP IDs** - Keep them immutable once assigned',
+            '- **Every status transition must have report evidence** - Create execution reports in reports/ directory',
+            '- **.projitive governance store is source of truth** - tasks.md/roadmap.md are generated views and may be overwritten',
+            '- **Prefer tool writes over manual table/view edits** - Use taskCreate/taskUpdate/roadmapCreate/roadmapUpdate',
+            '- **Always verify after updates** - Re-run taskContext() to confirm reference consistency',
+        ].join('\n');
         return asUserPrompt(text);
     });
 }

package/output/source/prompts/quickStart.test.js

@@ -0,0 +1,24 @@
+import { describe, expect, it, vi } from 'vitest';
+import { registerQuickStartPrompt } from './quickStart.js';
+describe('quickStart prompt', () => {
+    it('registers the prompt and renders known project guidance', async () => {
+        const server = { registerPrompt: vi.fn() };
+        registerQuickStartPrompt(server);
+        const handler = server.registerPrompt.mock.calls[0][2];
+        const result = await handler({ projectPath: '/workspace/app' });
+        const text = result.messages[0].content.text;
+        expect(server.registerPrompt.mock.calls[0][0]).toBe('quickStart');
+        expect(text).toContain('Known project path: "/workspace/app"');
+        expect(text).toContain('taskCreate');
+        expect(text).toContain('.projitive governance store is source of truth');
+    });
+    it('renders discovery workflow when project path is unknown', async () => {
+        const server = { registerPrompt: vi.fn() };
+        registerQuickStartPrompt(server);
+        const handler = server.registerPrompt.mock.calls[0][2];
+        const result = await handler({});
+        const text = result.messages[0].content.text;
+        expect(text).toContain('Call `projectScan()` to discover all governance roots');
+        expect(text).toContain('Call `projectLocate(inputPath="<selected-path>")` to lock governance root');
+    });
+});