@projitive/mcp 2.1.1 → 2.1.3

package/output/source/tools/task.js

@@ -12,7 +12,9 @@ export const TASK_RESEARCH_DIR = 'designs/research';
 export const TASK_RESEARCH_FILE_SUFFIX = '.implementation-research.md';
 export const CORE_DESIGN_DOCS_DIR = 'designs/core';
 export const CORE_ARCHITECTURE_DOC_FILE = `${CORE_DESIGN_DOCS_DIR}/architecture.md`;
-export const CORE_STYLE_DOC_FILE = `${CORE_DESIGN_DOCS_DIR}/style-guide.md`;
+export const CORE_CODE_STYLE_DOC_FILE = `${CORE_DESIGN_DOCS_DIR}/code-style.md`;
+export const CORE_UI_STYLE_DOC_FILE = `${CORE_DESIGN_DOCS_DIR}/ui-style.md`;
+export const CORE_STYLE_DOC_FILE = CORE_UI_STYLE_DOC_FILE;
 function taskStatusGuidance(task) {
     if (task.status === 'TODO') {
         return [
@@ -220,7 +222,8 @@ const DEFAULT_NO_TASK_DISCOVERY_GUIDANCE = [
     '- Prefer slices that unlock multiple downstream tasks before isolated refactors or low-impact cleanups.',
     '- Skip duplicate scope: do not create tasks that overlap existing TODO/IN_PROGRESS/BLOCKED task intent.',
     '- Use quality gates for discovery candidates: user value, delivery risk reduction, or measurable throughput improvement.',
-    '- Review and update project architecture docs under designs/core/ (architecture.md, style-guide.md) if they are missing or outdated.',
+    '- Review and update core governance docs under designs/core/ (architecture.md, code-style.md, ui-style.md) if they are missing or outdated.',
+    '- If a task changes module boundaries, engineering conventions, or UI patterns, create follow-up TODO work or update the matching core doc before closing the loop.',
     '- Keep each discovery round small (1-3 tasks), then rerun taskNext immediately for re-ranking and execution.',
 ];
 const DEFAULT_TASK_CONTEXT_READING_GUIDANCE = [
@@ -232,14 +235,6 @@ const DEFAULT_TASK_CONTEXT_READING_GUIDANCE = [
     '- Read process guides under templates/docs/project guidelines to align with local governance rules.',
     '- If available, read docs/ architecture or migration guides before major structural changes.',
 ];
-export async function resolveNoTaskDiscoveryGuidance(governanceDir) {
-    void governanceDir;
-    return DEFAULT_NO_TASK_DISCOVERY_GUIDANCE;
-}
-export async function resolveTaskContextReadingGuidance(governanceDir) {
-    void governanceDir;
-    return DEFAULT_TASK_CONTEXT_READING_GUIDANCE;
-}
 async function readRoadmapIds(governanceDir) {
     const dbPath = path.join(governanceDir, '.projitive');
     try {
@@ -285,9 +280,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 +309,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,44 +318,56 @@ 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 [];
 }
-function inspectProjectContextDocsFromArtifacts(files) {
+export function inspectProjectContextDocsFromArtifacts(files) {
     const markdownFiles = files
         .map((item) => item.replace(/\\/g, '/'))
         .filter((item) => item.toLowerCase().endsWith('.md'));
     const architectureDocSuffix = `/${CORE_ARCHITECTURE_DOC_FILE}`.toLowerCase();
-    const styleDocSuffix = `/${CORE_STYLE_DOC_FILE}`.toLowerCase();
+    const codeStyleDocSuffix = `/${CORE_CODE_STYLE_DOC_FILE}`.toLowerCase();
+    const uiStyleDocSuffix = `/${CORE_UI_STYLE_DOC_FILE}`.toLowerCase();
     const architectureDocs = markdownFiles.filter((item) => item.toLowerCase().endsWith(architectureDocSuffix));
-    const styleDocs = markdownFiles.filter((item) => item.toLowerCase().endsWith(styleDocSuffix));
+    const codeStyleDocs = markdownFiles.filter((item) => item.toLowerCase().endsWith(codeStyleDocSuffix));
+    const uiStyleDocs = markdownFiles.filter((item) => item.toLowerCase().endsWith(uiStyleDocSuffix));
     const missingArchitectureDocs = architectureDocs.length === 0;
-    const missingStyleDocs = styleDocs.length === 0;
+    const missingCodeStyleDocs = codeStyleDocs.length === 0;
+    const missingUiStyleDocs = uiStyleDocs.length === 0;
     return {
         architectureDocs,
-        styleDocs,
+        codeStyleDocs,
+        uiStyleDocs,
         missingArchitectureDocs,
-        missingStyleDocs,
-        ready: !missingArchitectureDocs && !missingStyleDocs,
+        missingCodeStyleDocs,
+        missingUiStyleDocs,
+        ready: !missingArchitectureDocs && !missingCodeStyleDocs && !missingUiStyleDocs,
     };
 }
-function collectProjectContextDocsLintSuggestions(state) {
+export function collectProjectContextDocsLintSuggestions(state) {
     const suggestions = [];
     if (state.missingArchitectureDocs) {
         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.missingCodeStyleDocs) {
+        suggestions.push({
+            code: PROJECT_LINT_CODES.CODE_STYLE_DOC_MISSING,
+            message: 'Project context is missing code style documentation.',
+            fixHint: `Add required file under governanceDir: ${CORE_CODE_STYLE_DOC_FILE}.`,
         });
     }
-    if (state.missingStyleDocs) {
+    if (state.missingUiStyleDocs) {
         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}.`,
+            code: PROJECT_LINT_CODES.UI_STYLE_DOC_MISSING,
+            message: 'Project context is missing UI style documentation.',
+            fixHint: `Add required file under governanceDir: ${CORE_UI_STYLE_DOC_FILE}.`,
         });
     }
     return suggestions;
@@ -1000,7 +1003,7 @@ export function registerTaskTools(server) {
                 }));
                 const preferredProject = projectSnapshots[0];
                 const preferredRoadmapRef = preferredProject?.roadmapIds[0] ?? 'ROADMAP-0001';
-                const noTaskDiscoveryGuidance = await resolveNoTaskDiscoveryGuidance(preferredProject?.governanceDir);
+                const noTaskDiscoveryGuidance = DEFAULT_NO_TASK_DISCOVERY_GUIDANCE;
                 return { isEmpty: true, roots, depth, projects, projectSnapshots, preferredProject, preferredRoadmapRef, noTaskDiscoveryGuidance };
             }
             const selected = rankedCandidates[0];
@@ -1107,15 +1110,20 @@ export function registerTaskTools(server) {
             return [
                 ...(!data.projectContextDocsState.ready
                     ? [
-                        '- Project context docs are incomplete. Complete missing project architecture/style docs before deep implementation.',
+                        '- Project context docs are incomplete. Complete missing project architecture, code style, and UI style docs before deep implementation.',
+                        `- Rerun projectInit to backfill missing governance artifacts first: projectInit(projectPath="${toProjectPath(data.selected.governanceDir)}")`,
                         ...(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.missingCodeStyleDocs
+                            ? [`- Missing code style doc: create required file under governanceDir: ${CORE_CODE_STYLE_DOC_FILE}.`]
                             : []),
-                        ...(data.projectContextDocsState.missingStyleDocs
-                            ? [`- Missing design style doc: create required file ${CORE_STYLE_DOC_FILE}.`]
+                        ...(data.projectContextDocsState.missingUiStyleDocs
+                            ? [`- Missing UI style doc: create required file under governanceDir: ${CORE_UI_STYLE_DOC_FILE}.`]
                             : []),
                     ]
                     : []),
+                '- Governance state updates MUST go through tools; NEVER directly edit tasks.md/roadmap.md generated views.',
                 '- Start immediately with Suggested Read Order and execute the selected task.',
                 '- Update markdown artifacts directly while keeping TASK/ROADMAP IDs unchanged.',
                 '- Re-run `taskContext` for the selectedTaskId after edits to verify evidence consistency.',
@@ -1163,7 +1171,7 @@ export function registerTaskTools(server) {
                 throw new ToolExecutionError(`Task not found: ${taskId}`, ['run `taskList` to discover available IDs', 'retry with an existing task ID'], `taskList(projectPath="${toProjectPath(governanceDir)}")`);
             }
             const researchBriefState = await inspectTaskResearchBrief(governanceDir, task);
-            const contextReadingGuidance = await resolveTaskContextReadingGuidance(governanceDir);
+            const contextReadingGuidance = DEFAULT_TASK_CONTEXT_READING_GUIDANCE;
             const taskLocation = (await findTextReferences(markdownPath, taskId))[0];
             const artifacts = await discoverGovernanceArtifacts(governanceDir);
             const fileCandidates = candidateFilesFromArtifacts(artifacts);
@@ -1192,8 +1200,9 @@ export function registerTaskTools(server) {
                 `- roadmapRefs: ${task.roadmapRefs.join(', ') || '(none)'}`,
                 `- researchBriefPath: ${researchBriefState.relativePath}`,
                 `- researchBriefStatus: ${researchBriefState.ready ? 'READY' : 'MISSING'}`,
-                `- architectureDocsStatus: ${projectContextDocsState.missingArchitectureDocs ? 'MISSING' : 'READY'}`,
-                `- styleDocsStatus: ${projectContextDocsState.missingStyleDocs ? 'MISSING' : 'READY'}`,
+                `- projectArchitectureDocsStatus: ${projectContextDocsState.missingArchitectureDocs ? 'MISSING' : 'READY'}`,
+                `- codeStyleDocsStatus: ${projectContextDocsState.missingCodeStyleDocs ? 'MISSING' : 'READY'}`,
+                `- uiStyleDocsStatus: ${projectContextDocsState.missingUiStyleDocs ? 'MISSING' : 'READY'}`,
                 `- taskLocation: ${taskLocation ? `${taskLocation.filePath}#L${taskLocation.line}` : markdownPath}`,
             ];
             if (task.subState && task.status === 'IN_PROGRESS') {
@@ -1235,11 +1244,15 @@ 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}.`]),
-            `- 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}.`]),
+                : [`- architecture: add required file under governanceDir: ${CORE_ARCHITECTURE_DOC_FILE}.`]),
+            `- code style docs: ${projectContextDocsState.codeStyleDocs.length > 0 ? 'found' : 'missing'}`,
+            ...(projectContextDocsState.codeStyleDocs.length > 0
+                ? projectContextDocsState.codeStyleDocs.map((item) => `- code-style: ${item}`)
+                : [`- code-style: add required file under governanceDir: ${CORE_CODE_STYLE_DOC_FILE}.`]),
+            `- UI style docs: ${projectContextDocsState.uiStyleDocs.length > 0 ? 'found' : 'missing'}`,
+            ...(projectContextDocsState.uiStyleDocs.length > 0
+                ? projectContextDocsState.uiStyleDocs.map((item) => `- ui-style: ${item}`)
+                : [`- ui-style: add required file under governanceDir: ${CORE_UI_STYLE_DOC_FILE}.`]),
             '',
             '### Related Artifacts',
             ...(relatedArtifacts.length > 0 ? relatedArtifacts.map((file) => `- ${file}`) : ['- (none)']),
@@ -1252,31 +1265,35 @@ export function registerTaskTools(server) {
             '### Suggested Read Order',
             ...suggestedReadOrder.map((item, index) => `${index + 1}. ${item}`),
         ],
-        guidance: ({ researchBriefState, projectContextDocsState, contextReadingGuidance, task }) => [
+        guidance: ({ normalizedProjectPath, researchBriefState, projectContextDocsState, contextReadingGuidance, task }) => [
             ...(!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.',
+                    '- Project context docs gate is NOT satisfied. Complete missing project architecture, code style, and UI style docs first.',
+                    `- Rerun projectInit to repair missing governance artifacts first: projectInit(projectPath="${normalizedProjectPath}")`,
                     ...(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.missingCodeStyleDocs
+                        ? [`- Missing code style doc. Add required file under governanceDir: ${CORE_CODE_STYLE_DOC_FILE} and include naming, module boundaries, testing expectations, and review rules.`]
                         : []),
-                    ...(projectContextDocsState.missingStyleDocs
-                        ? [`- Missing design style doc. Add required file ${CORE_STYLE_DOC_FILE} and include style language, tokens/themes, and UI consistency rules.`]
+                    ...(projectContextDocsState.missingUiStyleDocs
+                        ? [`- Missing UI style doc. Add required file under governanceDir: ${CORE_UI_STYLE_DOC_FILE} and include style language, tokens/themes, accessibility expectations, and UI consistency rules.`]
                         : []),
-                    '- Re-run taskContext and confirm both architectureDocsStatus/styleDocsStatus are READY.',
+                    '- Re-run taskContext and confirm projectArchitectureDocsStatus/codeStyleDocsStatus/uiStyleDocsStatus are READY.',
                 ]
                 : [
-                    '- Project context docs gate satisfied. Architecture/style docs are available for execution alignment.',
+                    '- Project context docs gate satisfied. Architecture, code style, and UI style docs are available for execution alignment.',
                 ]),
             '- Read the files in Suggested Read Order.',
             '',
@@ -1285,7 +1302,8 @@ export function registerTaskTools(server) {
             '',
             '- Verify whether current status and evidence are consistent.',
             ...taskStatusGuidance(task),
-            '- If updates are needed, use tool writes for governance store (`taskUpdate` / `roadmapUpdate`) and keep TASK IDs unchanged.',
+            '- If updates are needed, use tool writes for governance store (`taskCreate` / `taskUpdate` / `roadmapCreate` / `roadmapUpdate`) and keep TASK IDs unchanged.',
+            '- NEVER directly edit tasks.md/roadmap.md; they are generated views and will be overwritten.',
             '- After editing, re-run `taskContext` to verify references and context consistency.',
         ],
         suggestions: ({ task, researchBriefState, projectContextDocsState }) => [
@@ -1414,11 +1432,21 @@ 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.']
+                ? [
+                    '- Verify evidence links are attached and reflect completed work.',
+                    '- Core docs review checklist (required):',
+                    '- [ ] architecture.md reviewed (designs/core/architecture.md)',
+                    '- [ ] code-style.md reviewed (designs/core/code-style.md)',
+                    '- [ ] ui-style.md reviewed (designs/core/ui-style.md)',
+                    '- Re-check whether this task changed module boundaries or system behavior, and update architecture.md if needed.',
+                    '- Re-check whether this task introduced or normalized engineering conventions, and update code-style.md if needed.',
+                    '- Re-check whether this task changed UI patterns, tokens, accessibility expectations, or interaction rules, and update ui-style.md if needed.',
+                ]
                 : []),
+            '- Governance state changes must use task/roadmap tools only; never manually edit tasks.md/roadmap.md views.',
             '.projitive governance store is source of truth; tasks.md is a generated view and may be overwritten.',
         ],
         suggestions: async ({ previewTask, governanceDir }) => [

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

@@ -1,5 +1,5 @@
 import { describe, expect, it, vi } from 'vitest';
-import { collectTaskLintSuggestions, isValidTaskId, normalizeTask, rankActionableTaskCandidates, resolveNoTaskDiscoveryGuidance, renderTaskSeedTemplate, renderTasksMarkdown, loadTasksDocument, registerTaskTools, saveTasks, taskPriority, toTaskUpdatedAtMs, validateTransition, } from './task.js';
+import { collectTaskLintSuggestions, isValidTaskId, normalizeTask, rankActionableTaskCandidates, renderTaskSeedTemplate, renderTasksMarkdown, loadTasksDocument, registerTaskTools, saveTasks, taskPriority, toTaskUpdatedAtMs, validateTransition, } from './task.js';
 import fs from 'node:fs/promises';
 import os from 'node:os';
 import path from 'node:path';
@@ -159,15 +159,6 @@ describe('tasks module', () => {
         const markdown = lines.join('\n');
         expect(markdown).toContain('- roadmapRefs: ROADMAP-0099');
     });
-    it('uses default no-task guidance when hook file is absent', async () => {
-        const guidance = await resolveNoTaskDiscoveryGuidance('/path/that/does/not/exist');
-        expect(guidance.length).toBeGreaterThan(3);
-    });
-    it('returns same default no-task guidance regardless of path', async () => {
-        const guidanceA = await resolveNoTaskDiscoveryGuidance('/path/that/does/not/exist');
-        const guidanceB = await resolveNoTaskDiscoveryGuidance('/another/path');
-        expect(guidanceA).toEqual(guidanceB);
-    });
     it('loads and saves tasks from governance store and keeps newest-first order', async () => {
         const root = await fs.mkdtemp(path.join(os.tmpdir(), 'projitive-mcp-task-'));
         const governanceDir = path.join(root, '.projitive');
@@ -284,11 +275,14 @@ describe('tasks module', () => {
         expect(contextResult.content[0].text).toContain('### Pre-Execution Research Brief');
         expect(contextResult.content[0].text).toContain('researchBriefStatus: MISSING');
         expect(contextResult.content[0].text).toContain('designs/research/TASK-0001.implementation-research.md');
-        expect(contextResult.content[0].text).toContain('architectureDocsStatus: MISSING');
-        expect(contextResult.content[0].text).toContain('styleDocsStatus: MISSING');
+        expect(contextResult.content[0].text).toContain('projectArchitectureDocsStatus: MISSING');
+        expect(contextResult.content[0].text).toContain('codeStyleDocsStatus: MISSING');
+        expect(contextResult.content[0].text).toContain('uiStyleDocsStatus: MISSING');
         expect(contextResult.content[0].text).toContain('Project context docs gate is NOT satisfied');
         expect(contextResult.content[0].text).toContain('PROJECT_ARCHITECTURE_DOC_MISSING');
-        expect(contextResult.content[0].text).toContain('PROJECT_STYLE_DOC_MISSING');
+        expect(contextResult.content[0].text).toContain('PROJECT_CODE_STYLE_DOC_MISSING');
+        expect(contextResult.content[0].text).toContain('PROJECT_UI_STYLE_DOC_MISSING');
+        expect(contextResult.content[0].text).toContain('projectInit(projectPath="');
         await fs.rm(projectRoot, { recursive: true, force: true });
     });
     it('taskUpdate allows TODO -> IN_PROGRESS when research brief is missing, with lint guidance', async () => {
@@ -313,14 +307,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',
@@ -353,19 +347,22 @@ describe('tasks module', () => {
         ]);
         await fs.mkdir(path.join(projectRoot, 'designs'), { recursive: true });
         await fs.writeFile(path.join(projectRoot, 'designs', 'architecture.md'), '# Architecture\n', 'utf-8');
-        await fs.writeFile(path.join(projectRoot, 'designs', 'style-guide.md'), '# Style\n', 'utf-8');
+        await fs.writeFile(path.join(projectRoot, 'designs', 'code-style.md'), '# Code Style\n', 'utf-8');
+        await fs.writeFile(path.join(projectRoot, 'designs', 'ui-style.md'), '# UI Style\n', 'utf-8');
         const mockServer = { registerTool: vi.fn() };
         registerTaskTools(mockServer);
         const taskContext = getToolHandler(mockServer, 'taskContext');
         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('projectArchitectureDocsStatus: MISSING');
+        expect(contextResult.content[0].text).toContain('codeStyleDocsStatus: MISSING');
+        expect(contextResult.content[0].text).toContain('uiStyleDocsStatus: MISSING');
         expect(contextResult.content[0].text).toContain('designs/core/architecture.md');
         expect(contextResult.content[0].text).toContain('PROJECT_ARCHITECTURE_DOC_MISSING');
-        expect(contextResult.content[0].text).toContain('PROJECT_STYLE_DOC_MISSING');
+        expect(contextResult.content[0].text).toContain('PROJECT_CODE_STYLE_DOC_MISSING');
+        expect(contextResult.content[0].text).toContain('PROJECT_UI_STYLE_DOC_MISSING');
         await fs.rm(projectRoot, { recursive: true, force: true });
     });
-    it('taskContext marks project core docs ready when architecture/style docs exist under designs/core', async () => {
+    it('taskContext marks project core docs ready when architecture/code-style/ui-style docs exist under designs/core', async () => {
         const { projectRoot, governanceDir, dbPath } = await createGovernanceWorkspace();
         await replaceRoadmapsInStore(dbPath, [
             { id: 'ROADMAP-0001', title: 'Roadmap', status: 'active', updatedAt: '2026-03-14T00:00:00.000Z' },
@@ -376,13 +373,15 @@ describe('tasks module', () => {
         const coreDir = path.join(governanceDir, 'designs', 'core');
         await fs.mkdir(coreDir, { recursive: true });
         await fs.writeFile(path.join(coreDir, 'architecture.md'), '# Architecture\n', 'utf-8');
-        await fs.writeFile(path.join(coreDir, 'style-guide.md'), '# Style\n', 'utf-8');
+        await fs.writeFile(path.join(coreDir, 'code-style.md'), '# Code Style\n', 'utf-8');
+        await fs.writeFile(path.join(coreDir, 'ui-style.md'), '# UI Style\n', 'utf-8');
         const mockServer = { registerTool: vi.fn() };
         registerTaskTools(mockServer);
         const taskContext = getToolHandler(mockServer, 'taskContext');
         const contextResult = await taskContext({ projectPath: projectRoot, taskId: 'TASK-0001' });
-        expect(contextResult.content[0].text).toContain('architectureDocsStatus: READY');
-        expect(contextResult.content[0].text).toContain('styleDocsStatus: READY');
+        expect(contextResult.content[0].text).toContain('projectArchitectureDocsStatus: READY');
+        expect(contextResult.content[0].text).toContain('codeStyleDocsStatus: READY');
+        expect(contextResult.content[0].text).toContain('uiStyleDocsStatus: READY');
         expect(contextResult.content[0].text).toContain('Project context docs gate satisfied');
         await fs.rm(projectRoot, { recursive: true, force: true });
     });
@@ -397,15 +396,19 @@ describe('tasks module', () => {
         const coreDir = path.join(governanceDir, 'designs', 'core');
         await fs.mkdir(coreDir, { recursive: true });
         await fs.writeFile(path.join(coreDir, 'system-architecture.md'), '# Architecture\n', 'utf-8');
-        await fs.writeFile(path.join(coreDir, 'visual-style.md'), '# Style\n', 'utf-8');
+        await fs.writeFile(path.join(coreDir, 'engineering-style.md'), '# Code Style\n', 'utf-8');
+        await fs.writeFile(path.join(coreDir, 'visual-style.md'), '# UI Style\n', 'utf-8');
         const mockServer = { registerTool: vi.fn() };
         registerTaskTools(mockServer);
         const taskContext = getToolHandler(mockServer, 'taskContext');
         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('projectArchitectureDocsStatus: MISSING');
+        expect(contextResult.content[0].text).toContain('codeStyleDocsStatus: MISSING');
+        expect(contextResult.content[0].text).toContain('uiStyleDocsStatus: MISSING');
+        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/code-style.md');
+        expect(contextResult.content[0].text).toContain('add required file under governanceDir: designs/core/ui-style.md');
+        expect(contextResult.content[0].text).toContain('projectInit(projectPath="');
         await fs.rm(projectRoot, { recursive: true, force: true });
     });
     it('taskUpdate allows IN_PROGRESS -> DONE with lint guidance when conformance fails', async () => {
@@ -423,7 +426,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',
@@ -437,7 +440,8 @@ describe('tasks module', () => {
         const coreDir = path.join(governanceDir, 'designs', 'core');
         await fs.mkdir(coreDir, { recursive: true });
         await fs.writeFile(path.join(coreDir, 'architecture.md'), '# Architecture\n', 'utf-8');
-        await fs.writeFile(path.join(coreDir, 'style-guide.md'), '# Style\n', 'utf-8');
+        await fs.writeFile(path.join(coreDir, 'code-style.md'), '# Code Style\n', 'utf-8');
+        await fs.writeFile(path.join(coreDir, 'ui-style.md'), '# UI Style\n', 'utf-8');
         const mockServer = { registerTool: vi.fn() };
         registerTaskTools(mockServer);
         const taskUpdate = getToolHandler(mockServer, 'taskUpdate');
@@ -449,6 +453,10 @@ describe('tasks module', () => {
         expect(result.isError).toBeUndefined();
         expect(result.content[0].text).toContain('newStatus: DONE');
         expect(result.content[0].text).toContain('TASK_DONE_LINKS_MISSING');
+        expect(result.content[0].text).toContain('Core docs review checklist (required):');
+        expect(result.content[0].text).toContain('- [ ] architecture.md reviewed (designs/core/architecture.md)');
+        expect(result.content[0].text).toContain('- [ ] code-style.md reviewed (designs/core/code-style.md)');
+        expect(result.content[0].text).toContain('- [ ] ui-style.md reviewed (designs/core/ui-style.md)');
         await fs.rm(projectRoot, { recursive: true, force: true });
     });
     it('taskUpdate allows IN_PROGRESS -> DONE when conformance re-check passes', async () => {
@@ -467,7 +475,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',
@@ -481,7 +489,8 @@ describe('tasks module', () => {
         const coreDir = path.join(governanceDir, 'designs', 'core');
         await fs.mkdir(coreDir, { recursive: true });
         await fs.writeFile(path.join(coreDir, 'architecture.md'), '# Architecture\n', 'utf-8');
-        await fs.writeFile(path.join(coreDir, 'style-guide.md'), '# Style\n', 'utf-8');
+        await fs.writeFile(path.join(coreDir, 'code-style.md'), '# Code Style\n', 'utf-8');
+        await fs.writeFile(path.join(coreDir, 'ui-style.md'), '# UI Style\n', 'utf-8');
         const mockServer = { registerTool: vi.fn() };
         registerTaskTools(mockServer);
         const taskUpdate = getToolHandler(mockServer, 'taskUpdate');
@@ -492,6 +501,7 @@ describe('tasks module', () => {
         });
         expect(result.isError).toBeUndefined();
         expect(result.content[0].text).toContain('newStatus: DONE');
+        expect(result.content[0].text).toContain('Core docs review checklist (required):');
         await fs.rm(projectRoot, { recursive: true, force: true });
     });
 });

package/output/source/types.js

@@ -50,5 +50,6 @@ export const TASK_LINT_CODES = {
 };
 export const PROJECT_LINT_CODES = {
     ARCHITECTURE_DOC_MISSING: 'PROJECT_ARCHITECTURE_DOC_MISSING',
-    STYLE_DOC_MISSING: 'PROJECT_STYLE_DOC_MISSING',
+    CODE_STYLE_DOC_MISSING: 'PROJECT_CODE_STYLE_DOC_MISSING',
+    UI_STYLE_DOC_MISSING: 'PROJECT_UI_STYLE_DOC_MISSING',
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@projitive/mcp",
-  "version": "2.1.1",
+  "version": "2.1.3",
   "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",