@projitive/mcp 2.0.3 → 2.0.4

package/output/source/prompts/taskExecution.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,9 +13,9 @@ function asUserPrompt(text) {
     };
 }
 export function registerTaskExecutionPrompt(server) {
-    server.registerPrompt("taskExecution", {
-        title: "Task Execution",
-        description: "Primary execution prompt: select one task, execute, and verify evidence consistency",
+    server.registerPrompt('taskExecution', {
+        title: 'Task Execution',
+        description: 'Primary execution prompt: select one task, execute, and verify evidence consistency',
         argsSchema: {
             projectPath: z.string().optional(),
             taskId: z.string().optional(),
@@ -23,150 +23,150 @@ export function registerTaskExecutionPrompt(server) {
     }, async ({ projectPath, taskId }) => {
         const taskEntry = taskId && projectPath
             ? `1) Run taskContext(projectPath="${projectPath}", taskId="${taskId}").`
-            : "1) Run taskNext().";
+            : '1) Run taskNext().';
         const text = [
-            "# Execute Task Workflow",
-            "",
-            "You are a Projitive task execution assistant. Here is the complete workflow:",
-            "",
-            "## Step 1: Get the Task",
-            "",
+            '# Execute Task Workflow',
+            '',
+            'You are a Projitive task execution assistant. Here is the complete workflow:',
+            '',
+            '## Step 1: Get the Task',
+            '',
             taskEntry,
-            "",
-            "## Step 2: Understand the Task",
-            "",
-            "After getting task context, read carefully:",
-            "",
-            "### Suggested Read Order",
-            "Read each file in order:",
-            "- Note content and location of each file",
-            "- Understand task background and motivation",
-            "- Identify task acceptance criteria",
-            "- Look for related design decisions",
-            "",
-            "### Evidence",
-            "- Candidate Files - Related file list",
-            "- Reference Locations - Where TASK/ROADMAP IDs appear",
-            "",
-            "### Lint Suggestions",
-            "Resolve any warnings before starting task execution.",
-            "",
-            "## Step 3: Execute the Task",
-            "",
-            "### Status Management",
-            "",
-            "| Current Status | Next Step | Description |",
-            "|----------------|-----------|-------------|",
-            "| TODO | \u2192 IN_PROGRESS | When starting execution |",
-            "| IN_PROGRESS | \u2192 DONE | When task is complete |",
-            "| IN_PROGRESS | \u2192 BLOCKED | When blocked |",
-            "| BLOCKED | \u2192 TODO | When blocker is resolved |",
-            "",
-            "### Execution Steps",
-            "",
-            "1. **Prepare (if status is TODO)",
-            "   - Call `taskUpdate()` to change status to IN_PROGRESS",
-            "   - Set owner (if empty)",
-            "   - Fill subState (optional, Spec v1.1.0)",
-            "",
-            "2. **Execute task content**",
-            "   - Prefer MCP tool writes for governance store (`taskUpdate` / `roadmapUpdate`)",
-            "   - .projitive (task table) - Update task status and metadata",
-            "   - designs/*.md - Add or update design documents",
-            "   - reports/*.md - Create execution reports",
-            "   - .projitive (roadmap table) - Update roadmap (if needed)",
-            "   - taskCreate/taskUpdate/roadmapCreate/roadmapUpdate auto-sync corresponding markdown views",
-            "",
-            "3. **Create execution report**",
-            "   - Create new report file in reports/ directory",
-            "   - Record what changes were made",
-            "   - Record why changes were made",
-            "   - Record verification results",
-            "",
-            "4. **Complete task (if status is IN_PROGRESS)",
-            "   - Confirm all acceptance criteria are met",
-            "   - Call `taskUpdate()` to change status to DONE",
-            "   - Update updatedAt timestamp",
-            "",
-            "## Step 4: Verify Changes",
-            "",
-            "After execution:",
-            "",
-            "1. **Re-run taskContext()",
-            "   - Confirm task status updated correctly",
-            "   - Confirm updatedAt timestamp updated",
-            "",
-            "2. **Check reference consistency",
-            "   - Confirm all TASK/ROADMAP IDs still valid",
-            "   - Confirm no broken links in Reference Locations",
-            "",
-            "3. **Check Lint Suggestions",
-            "   - Confirm no new warnings",
-            "   - If there are warnings, resolve them first",
-            "",
-            "4. **Continue to next task (optional)",
-            "   - Call `taskNext()` for next task",
-            "   - Repeat above workflow",
-            "",
-            "## Autonomous Progress Rules",
-            "",
-            "- Keep WIP small: drive one task to DONE before starting another unless blocker requires branching.",
-            "- Prefer unblock-first execution: if one small task unlocks multiple tasks, do it first.",
-            "- Avoid churn: do not repeatedly flip status without producing new evidence.",
-            "- Every loop should leave one durable artifact update (task status, report, or roadmap progress).",
-            "",
-            "## Special Cases",
-            "",
-            "### Case 1: Encountered a blocker",
-            "",
-            "If unable to continue task execution:",
-            "1. Call `taskUpdate()` to change status to BLOCKED",
-            "2. Fill blocker field (Spec v1.1.0):",
-            "   - type: Blocker type (dependency/missing-info/technical-debt/other)",
-            "   - description: Blocker description",
-            "   - relatedLinks: Related links (optional)",
-            "3. Create a new TODO task via `taskCreate()` to resolve blocker",
-            "",
-            "### Case 2: No actionable tasks",
-            "",
-            "If taskNext() returns empty:",
-            "1. Call `projectContext()` to recheck project state",
-            "2. Analyze active roadmap milestones and find smallest executable slices",
-            "2.5 If roadmap milestones are missing, create them via `roadmapCreate()`",
-            "3. Read design documents in designs/ directory to find delivery gaps",
-            "4. Create 1-3 new TODO tasks via `taskCreate()` only if each task has clear done condition and evidence output",
-            "5. Re-run `taskNext()` and continue",
-            "",
-            "### Case 3: Need to initialize governance",
-            "",
-            "If .projitive directory does not exist:",
-            "1. Call `projectInit(projectPath=\"<project-dir>\")`",
-            "2. Then restart",
-            "",
-            "## Hard Rules (NEVER violate)",
-            "",
-            "1. **NEVER modify TASK/ROADMAP IDs**",
-            "   - Keep them immutable once assigned",
-            "   - If you need to reference, keep them as-is",
-            "",
-            "2. **Every status transition must have report evidence**",
-            "   - TODO \u2192 IN_PROGRESS: Report not required",
-            "   - IN_PROGRESS \u2192 DONE: Report REQUIRED",
-            "   - IN_PROGRESS \u2192 BLOCKED: Report recommended to explain blocker",
-            "",
-            "3. **Governance-store-first writes only**",
-            "   - tasks.md/roadmap.md are generated views, not authoritative source",
-            "   - Use taskUpdate/roadmapUpdate as primary write path",
-            "",
-            "4. **Always verify after updates**",
-            "   - After every taskUpdate() call",
-            "   - Re-run taskContext()",
-            "   - Confirm reference consistency",
-            "",
-            "5. **Keep updatedAt in sync**",
-            "   - Every time you update a task",
-            "   - Must update updatedAt to current time (ISO 8601 format)",
-        ].join("\n");
+            '',
+            '## Step 2: Understand the Task',
+            '',
+            'After getting task context, read carefully:',
+            '',
+            '### Suggested Read Order',
+            'Read each file in order:',
+            '- Note content and location of each file',
+            '- Understand task background and motivation',
+            '- Identify task acceptance criteria',
+            '- Look for related design decisions',
+            '',
+            '### Evidence',
+            '- Candidate Files - Related file list',
+            '- Reference Locations - Where TASK/ROADMAP IDs appear',
+            '',
+            '### Lint Suggestions',
+            'Resolve any warnings before starting task execution.',
+            '',
+            '## Step 3: Execute the Task',
+            '',
+            '### Status Management',
+            '',
+            '| Current Status | Next Step | Description |',
+            '|----------------|-----------|-------------|',
+            '| TODO | \u2192 IN_PROGRESS | When starting execution |',
+            '| IN_PROGRESS | \u2192 DONE | When task is complete |',
+            '| IN_PROGRESS | \u2192 BLOCKED | When blocked |',
+            '| BLOCKED | \u2192 TODO | When blocker is resolved |',
+            '',
+            '### Execution Steps',
+            '',
+            '1. **Prepare (if status is TODO)',
+            '   - Call `taskUpdate()` to change status to IN_PROGRESS',
+            '   - Set owner (if empty)',
+            '   - Fill subState (optional, Spec v1.1.0)',
+            '',
+            '2. **Execute task content**',
+            '   - Prefer MCP tool writes for governance store (`taskUpdate` / `roadmapUpdate`)',
+            '   - .projitive (task table) - Update task status and metadata',
+            '   - designs/*.md - Add or update design documents',
+            '   - reports/*.md - Create execution reports',
+            '   - .projitive (roadmap table) - Update roadmap (if needed)',
+            '   - taskCreate/taskUpdate/roadmapCreate/roadmapUpdate auto-sync corresponding markdown views',
+            '',
+            '3. **Create execution report**',
+            '   - Create new report file in reports/ directory',
+            '   - Record what changes were made',
+            '   - Record why changes were made',
+            '   - Record verification results',
+            '',
+            '4. **Complete task (if status is IN_PROGRESS)',
+            '   - Confirm all acceptance criteria are met',
+            '   - Call `taskUpdate()` to change status to DONE',
+            '   - Update updatedAt timestamp',
+            '',
+            '## Step 4: Verify Changes',
+            '',
+            'After execution:',
+            '',
+            '1. **Re-run taskContext()',
+            '   - Confirm task status updated correctly',
+            '   - Confirm updatedAt timestamp updated',
+            '',
+            '2. **Check reference consistency',
+            '   - Confirm all TASK/ROADMAP IDs still valid',
+            '   - Confirm no broken links in Reference Locations',
+            '',
+            '3. **Check Lint Suggestions',
+            '   - Confirm no new warnings',
+            '   - If there are warnings, resolve them first',
+            '',
+            '4. **Continue to next task (optional)',
+            '   - Call `taskNext()` for next task',
+            '   - Repeat above workflow',
+            '',
+            '## Autonomous Progress Rules',
+            '',
+            '- Keep WIP small: drive one task to DONE before starting another unless blocker requires branching.',
+            '- Prefer unblock-first execution: if one small task unlocks multiple tasks, do it first.',
+            '- Avoid churn: do not repeatedly flip status without producing new evidence.',
+            '- Every loop should leave one durable artifact update (task status, report, or roadmap progress).',
+            '',
+            '## Special Cases',
+            '',
+            '### Case 1: Encountered a blocker',
+            '',
+            'If unable to continue task execution:',
+            '1. Call `taskUpdate()` to change status to BLOCKED',
+            '2. Fill blocker field (Spec v1.1.0):',
+            '   - type: Blocker type (dependency/missing-info/technical-debt/other)',
+            '   - description: Blocker description',
+            '   - relatedLinks: Related links (optional)',
+            '3. Create a new TODO task via `taskCreate()` to resolve blocker',
+            '',
+            '### Case 2: No actionable tasks',
+            '',
+            'If taskNext() returns empty:',
+            '1. Call `projectContext()` to recheck project state',
+            '2. Analyze active roadmap milestones and find smallest executable slices',
+            '2.5 If roadmap milestones are missing, create them via `roadmapCreate()`',
+            '3. Read design documents in designs/ directory to find delivery gaps',
+            '4. Create 1-3 new TODO tasks via `taskCreate()` only if each task has clear done condition and evidence output',
+            '5. Re-run `taskNext()` and continue',
+            '',
+            '### Case 3: Need to initialize governance',
+            '',
+            'If .projitive directory does not exist:',
+            '1. Call `projectInit(projectPath="<project-dir>")`',
+            '2. Then restart',
+            '',
+            '## Hard Rules (NEVER violate)',
+            '',
+            '1. **NEVER modify TASK/ROADMAP IDs**',
+            '   - Keep them immutable once assigned',
+            '   - If you need to reference, keep them as-is',
+            '',
+            '2. **Every status transition must have report evidence**',
+            '   - TODO \u2192 IN_PROGRESS: Report not required',
+            '   - IN_PROGRESS \u2192 DONE: Report REQUIRED',
+            '   - IN_PROGRESS \u2192 BLOCKED: Report recommended to explain blocker',
+            '',
+            '3. **Governance-store-first writes only**',
+            '   - tasks.md/roadmap.md are generated views, not authoritative source',
+            '   - Use taskUpdate/roadmapUpdate as primary write path',
+            '',
+            '4. **Always verify after updates**',
+            '   - After every taskUpdate() call',
+            '   - Re-run taskContext()',
+            '   - Confirm reference consistency',
+            '',
+            '5. **Keep updatedAt in sync**',
+            '   - Every time you update a task',
+            '   - Must update updatedAt to current time (ISO 8601 format)',
+        ].join('\n');
         return asUserPrompt(text);
     });
 }

package/output/source/resources/designs.js

@@ -1,28 +1,28 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-import { isValidRoadmapId } from "../tools/roadmap.js";
-import { isValidTaskId } from "../tools/task.js";
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { isValidRoadmapId } from '../tools/roadmap.js';
+import { isValidTaskId } from '../tools/task.js';
 export function parseDesignMetadata(markdown) {
     const lines = markdown.split(/\r?\n/);
     const metadata = {};
     for (const line of lines) {
         // Remove markdown bold markers (**)
-        const cleanLine = line.replace(/\*\*/g, "");
-        const [rawKey, ...rawValue] = cleanLine.split(":");
+        const cleanLine = line.replace(/\*\*/g, '');
+        const [rawKey, ...rawValue] = cleanLine.split(':');
         if (!rawKey || rawValue.length === 0) {
             continue;
         }
         const key = rawKey.trim().toLowerCase();
-        const value = rawValue.join(":").trim();
-        if (key === "task")
+        const value = rawValue.join(':').trim();
+        if (key === 'task')
             metadata.task = value;
-        if (key === "roadmap")
+        if (key === 'roadmap')
             metadata.roadmap = value;
-        if (key === "owner")
+        if (key === 'owner')
             metadata.owner = value;
-        if (key === "status")
+        if (key === 'status')
             metadata.status = value;
-        if (key === "last updated")
+        if (key === 'last updated')
             metadata.lastUpdated = value;
     }
     return metadata;
@@ -30,7 +30,7 @@ export function parseDesignMetadata(markdown) {
 export function validateDesignMetadata(metadata) {
     const errors = [];
     if (!metadata.task) {
-        errors.push("Missing Task metadata");
+        errors.push('Missing Task metadata');
     }
     else if (!isValidTaskId(metadata.task)) {
         errors.push(`Invalid Task metadata format: ${metadata.task}`);
@@ -49,7 +49,7 @@ async function findAllMarkdownFiles(dir) {
             if (entry.isDirectory()) {
                 await walk(fullPath, path.join(relativeBase, entry.name));
             }
-            else if (entry.isFile() && entry.name.endsWith(".md")) {
+            else if (entry.isFile() && entry.name.endsWith('.md')) {
                 result.push({
                     filePath: fullPath,
                     relativePath: path.join(relativeBase, entry.name),
@@ -57,11 +57,11 @@ async function findAllMarkdownFiles(dir) {
             }
         }
     }
-    await walk(dir, "");
+    await walk(dir, '');
     return result;
 }
 export async function registerDesignFilesResources(server, repoRoot) {
-    const designsDir = path.join(repoRoot, ".projitive", "designs");
+    const designsDir = path.join(repoRoot, '.projitive', 'designs');
     try {
         // Check if design documents directory exists
         await fs.access(designsDir);
@@ -72,13 +72,13 @@ export async function registerDesignFilesResources(server, repoRoot) {
             // Generate designId from relative path, replace path separators with '-'
             const designId = relativePath
                 .slice(0, -3) // Remove .md suffix
-                .replace(/[\\/]/g, "-"); // Replace path separators with '-'
-            const content = await fs.readFile(filePath, "utf-8");
+                .replace(/[\\/]/g, '-'); // Replace path separators with '-'
+            const content = await fs.readFile(filePath, 'utf-8');
             // Register resource
             server.registerResource(`design-${designId}`, `projitive://designs/${designId}`, {
                 title: designId,
                 description: `Design document: ${relativePath}`,
-                mimeType: "text/markdown",
+                mimeType: 'text/markdown',
             }, async () => ({
                 contents: [
                     {
@@ -89,18 +89,18 @@ export async function registerDesignFilesResources(server, repoRoot) {
             }));
         }
     }
-    catch (error) {
+    catch {
         // If design documents directory doesn't exist, register a default resource
         console.warn(`Designs directory not found at ${designsDir}, registering default design resource`);
-        server.registerResource("designs", "projitive://designs", {
-            title: "Designs",
-            description: "Design documents directory",
-            mimeType: "text/markdown",
+        server.registerResource('designs', 'projitive://designs', {
+            title: 'Designs',
+            description: 'Design documents directory',
+            mimeType: 'text/markdown',
         }, async () => ({
             contents: [
                 {
-                    uri: "projitive://designs",
-                    text: `# Designs Directory\n\nDesign documents not found. Please create design files in .projitive/designs/ directory.`,
+                    uri: 'projitive://designs',
+                    text: '# Designs Directory\n\nDesign documents not found. Please create design files in .projitive/designs/ directory.',
                 },
             ],
         }));