@projitive/mcp 2.1.1 → 2.1.2

package/output/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@projitive/mcp",
-    "version": "2.1.1",
+    "version": "2.1.2",
     "description": "Projitive MCP Server for project and task discovery/update",
     "license": "ISC",
     "author": "",
@@ -12,6 +12,10 @@
     "publishConfig": {
         "access": "public"
     },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/yinxulai/projitive"
+    },
     "scripts": {
         "test": "vitest run",
         "test:coverage": "vitest run --coverage",

package/output/source/prompts/taskExecution.js

@@ -47,7 +47,8 @@ export function registerTaskExecutionPrompt(server) {
             '- If status is MISSING/INCOMPLETE, complete it before any implementation',
             '',
             '### Pre-Execution Research Brief (Mandatory Gate)',
-            '- Fixed file name: `designs/research/<TASK-ID>.implementation-research.md`',
+            '- Fixed file name (relative to governanceDir): `designs/research/<TASK-ID>.implementation-research.md`',
+            '- Absolute location: `<governanceDir>/designs/research/<TASK-ID>.implementation-research.md`',
             '- Required sections:',
             '  - `## Design Guidelines and Specs`',
             '  - `## Code Architecture and Implementation Findings`',
@@ -224,7 +225,7 @@ export function registerTaskExecutionPrompt(server) {
             '',
             '6. **Pre-execution research brief is mandatory**',
             '   - `TODO -> IN_PROGRESS` is not allowed until research brief is READY',
-            '   - Always read `designs/research/<TASK-ID>.implementation-research.md` before implementation',
+            '   - Always read `<governanceDir>/designs/research/<TASK-ID>.implementation-research.md` before implementation',
         ].join('\n');
         return asUserPrompt(text);
     });

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

@@ -11,7 +11,8 @@ describe('taskExecution prompt', () => {
         expect(text).toContain('1) Run taskContext(projectPath="/workspace/app", taskId="TASK-0007").');
         expect(text).toContain('Every status transition must have report evidence');
         expect(text).toContain('Pre-Execution Research Brief (Mandatory Gate)');
-        expect(text).toContain('designs/research/<TASK-ID>.implementation-research.md');
+        expect(text).toContain('Fixed file name (relative to governanceDir): `designs/research/<TASK-ID>.implementation-research.md`');
+        expect(text).toContain('Always read `<governanceDir>/designs/research/<TASK-ID>.implementation-research.md` before implementation');
     });
     it('falls back to taskNext when task is not provided', async () => {
         const server = { registerPrompt: vi.fn() };

package/output/source/tools/task.js

@@ -285,9 +285,6 @@ function normalizeTaskLink(link) {
     const withoutDotPrefix = slashNormalized.replace(/^\.\//, '');
     return withoutDotPrefix.replace(/^\/+/, '');
 }
-function resolveTaskLinkPath(projectPath, link) {
-    return path.join(projectPath, link);
-}
 function taskResearchBriefRelativePath(taskId) {
     return `${TASK_RESEARCH_DIR}/${taskId}${TASK_RESEARCH_FILE_SUFFIX}`;
 }
@@ -317,9 +314,8 @@ function renderTaskResearchBriefTemplate(task) {
     ];
 }
 async function inspectTaskResearchBrief(governanceDir, task) {
-    const projectPath = toProjectPath(governanceDir);
     const relativePath = taskResearchBriefRelativePath(task.id);
-    const absolutePath = resolveTaskLinkPath(projectPath, relativePath);
+    const absolutePath = path.join(governanceDir, relativePath);
     const exists = await fs.access(absolutePath).then(() => true).catch(() => false);
     return { relativePath, absolutePath, exists, ready: exists };
 }
@@ -327,8 +323,8 @@ function collectTaskResearchBriefLintSuggestions(state) {
     if (!state.exists) {
         return [{
                 code: TASK_LINT_CODES.RESEARCH_BRIEF_MISSING,
-                message: `Pre-execution research brief missing: ${state.relativePath}.`,
-                fixHint: 'Create the file and fill required sections before implementation.',
+                message: `Pre-execution research brief missing under governanceDir: ${state.relativePath}.`,
+                fixHint: 'Create the file under governanceDir and fill required sections before implementation.',
             }];
     }
     return [];
@@ -357,14 +353,14 @@ function collectProjectContextDocsLintSuggestions(state) {
         suggestions.push({
             code: PROJECT_LINT_CODES.ARCHITECTURE_DOC_MISSING,
             message: 'Project context is missing architecture design documentation.',
-            fixHint: `Add required file: ${CORE_ARCHITECTURE_DOC_FILE}.`,
+            fixHint: `Add required file under governanceDir: ${CORE_ARCHITECTURE_DOC_FILE}.`,
         });
     }
     if (state.missingStyleDocs) {
         suggestions.push({
             code: PROJECT_LINT_CODES.STYLE_DOC_MISSING,
             message: 'Project context is missing design style documentation.',
-            fixHint: `Add required file: ${CORE_STYLE_DOC_FILE}.`,
+            fixHint: `Add required file under governanceDir: ${CORE_STYLE_DOC_FILE}.`,
         });
     }
     return suggestions;
@@ -1109,10 +1105,10 @@ export function registerTaskTools(server) {
                     ? [
                         '- Project context docs are incomplete. Complete missing project architecture/style docs before deep implementation.',
                         ...(data.projectContextDocsState.missingArchitectureDocs
-                            ? [`- Missing architecture design doc: create required file ${CORE_ARCHITECTURE_DOC_FILE}.`]
+                            ? [`- Missing architecture design doc: create required file under governanceDir: ${CORE_ARCHITECTURE_DOC_FILE}.`]
                             : []),
                         ...(data.projectContextDocsState.missingStyleDocs
-                            ? [`- Missing design style doc: create required file ${CORE_STYLE_DOC_FILE}.`]
+                            ? [`- Missing design style doc: create required file under governanceDir: ${CORE_STYLE_DOC_FILE}.`]
                             : []),
                     ]
                     : []),
@@ -1235,11 +1231,11 @@ export function registerTaskTools(server) {
             `- architecture docs: ${projectContextDocsState.architectureDocs.length > 0 ? 'found' : 'missing'}`,
             ...(projectContextDocsState.architectureDocs.length > 0
                 ? projectContextDocsState.architectureDocs.map((item) => `- architecture: ${item}`)
-                : [`- architecture: add required file ${CORE_ARCHITECTURE_DOC_FILE}.`]),
+                : [`- architecture: add required file under governanceDir: ${CORE_ARCHITECTURE_DOC_FILE}.`]),
             `- design style docs: ${projectContextDocsState.styleDocs.length > 0 ? 'found' : 'missing'}`,
             ...(projectContextDocsState.styleDocs.length > 0
                 ? projectContextDocsState.styleDocs.map((item) => `- style: ${item}`)
-                : [`- style: add required file ${CORE_STYLE_DOC_FILE}.`]),
+                : [`- style: add required file under governanceDir: ${CORE_STYLE_DOC_FILE}.`]),
             '',
             '### Related Artifacts',
             ...(relatedArtifacts.length > 0 ? relatedArtifacts.map((file) => `- ${file}`) : ['- (none)']),
@@ -1256,22 +1252,22 @@ export function registerTaskTools(server) {
             ...(!researchBriefState.ready
                 ? [
                     '- Pre-execution gate is NOT satisfied. Complete research brief first, then proceed with implementation.',
-                    `- Create or update ${researchBriefState.relativePath} with design guidelines + code architecture findings before code changes.`,
+                    `- Create or update ${researchBriefState.relativePath} under governanceDir with design guidelines + code architecture findings before code changes.`,
                     '- Include exact file/line locations in the brief (for example path/to/file.ts#L120).',
                     '- Re-run taskContext after writing the brief and confirm researchBriefStatus becomes READY.',
                 ]
                 : [
                     '- Pre-execution gate satisfied. Read the research brief first, then continue implementation.',
-                    `- Must read ${researchBriefState.relativePath} before any task execution changes.`,
+                    `- Must read ${researchBriefState.relativePath} under governanceDir before any task execution changes.`,
                 ]),
             ...(!projectContextDocsState.ready
                 ? [
                     '- Project context docs gate is NOT satisfied. Complete missing project architecture/style docs first.',
                     ...(projectContextDocsState.missingArchitectureDocs
-                        ? [`- Missing architecture design doc. Add required file ${CORE_ARCHITECTURE_DOC_FILE} and include architecture boundaries and module responsibilities.`]
+                        ? [`- Missing architecture design doc. Add required file under governanceDir: ${CORE_ARCHITECTURE_DOC_FILE} and include architecture boundaries and module responsibilities.`]
                         : []),
                     ...(projectContextDocsState.missingStyleDocs
-                        ? [`- Missing design style doc. Add required file ${CORE_STYLE_DOC_FILE} and include style language, tokens/themes, and UI consistency rules.`]
+                        ? [`- Missing design style doc. Add required file under governanceDir: ${CORE_STYLE_DOC_FILE} and include style language, tokens/themes, and UI consistency rules.`]
                         : []),
                     '- Re-run taskContext and confirm both architectureDocsStatus/styleDocsStatus are READY.',
                 ]
@@ -1414,7 +1410,7 @@ export function registerTaskTools(server) {
         guidance: ({ updates, originalStatus }) => [
             'Task updated successfully and tasks.md has been synced. Run `taskContext` to verify the changes.',
             ...(updates.status === 'IN_PROGRESS' && originalStatus === 'TODO'
-                ? ['- Ensure pre-execution research brief exists before deep implementation.']
+                ? ['- Ensure pre-execution research brief exists under governanceDir before deep implementation.']
                 : []),
             ...(updates.status === 'DONE'
                 ? ['- Verify evidence links are attached and reflect completed work.']

package/output/source/tools/task.test.js

@@ -313,14 +313,14 @@ describe('tasks module', () => {
         await fs.rm(projectRoot, { recursive: true, force: true });
     });
     it('taskUpdate allows TODO -> IN_PROGRESS when research brief is ready', async () => {
-        const { projectRoot, dbPath } = await createGovernanceWorkspace();
+        const { projectRoot, governanceDir, dbPath } = await createGovernanceWorkspace();
         await replaceRoadmapsInStore(dbPath, [
             { id: 'ROADMAP-0001', title: 'Bootstrap', status: 'active', updatedAt: '2026-03-14T00:00:00.000Z' },
         ]);
         await saveTasks(dbPath, [
             normalizeTask({ id: 'TASK-0001', title: 'gate test pass', status: 'TODO', roadmapRefs: ['ROADMAP-0001'] }),
         ]);
-        const researchDir = path.join(projectRoot, 'designs', 'research');
+        const researchDir = path.join(governanceDir, 'designs', 'research');
         await fs.mkdir(researchDir, { recursive: true });
         await fs.writeFile(path.join(researchDir, 'TASK-0001.implementation-research.md'), [
             '# TASK-0001 Implementation Research Brief',
@@ -404,8 +404,8 @@ describe('tasks module', () => {
         const contextResult = await taskContext({ projectPath: projectRoot, taskId: 'TASK-0001' });
         expect(contextResult.content[0].text).toContain('architectureDocsStatus: MISSING');
         expect(contextResult.content[0].text).toContain('styleDocsStatus: MISSING');
-        expect(contextResult.content[0].text).toContain('add required file designs/core/architecture.md');
-        expect(contextResult.content[0].text).toContain('add required file designs/core/style-guide.md');
+        expect(contextResult.content[0].text).toContain('add required file under governanceDir: designs/core/architecture.md');
+        expect(contextResult.content[0].text).toContain('add required file under governanceDir: designs/core/style-guide.md');
         await fs.rm(projectRoot, { recursive: true, force: true });
     });
     it('taskUpdate allows IN_PROGRESS -> DONE with lint guidance when conformance fails', async () => {
@@ -423,7 +423,7 @@ describe('tasks module', () => {
                 links: [],
             }),
         ]);
-        const researchDir = path.join(projectRoot, 'designs', 'research');
+        const researchDir = path.join(governanceDir, 'designs', 'research');
         await fs.mkdir(researchDir, { recursive: true });
         await fs.writeFile(path.join(researchDir, 'TASK-0001.implementation-research.md'), [
             '# TASK-0001 Implementation Research Brief',
@@ -467,7 +467,7 @@ describe('tasks module', () => {
                 links: ['README.md'],
             }),
         ]);
-        const researchDir = path.join(projectRoot, 'designs', 'research');
+        const researchDir = path.join(governanceDir, 'designs', 'research');
         await fs.mkdir(researchDir, { recursive: true });
         await fs.writeFile(path.join(researchDir, 'TASK-0001.implementation-research.md'), [
             '# TASK-0001 Implementation Research Brief',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@projitive/mcp",
-  "version": "2.1.1",
+  "version": "2.1.2",
   "description": "Projitive MCP Server for project and task discovery/update",
   "license": "ISC",
   "author": "",
@@ -12,6 +12,10 @@
   "publishConfig": {
     "access": "public"
   },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yinxulai/projitive"
+  },
   "scripts": {
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",