@projitive/mcp 1.0.5 → 1.0.6

package/README.md

@@ -2,7 +2,7 @@
 
 Language: English | [简体中文](README_CN.md)
 
-**Current Spec Version: projitive-spec v1.0.0 | MCP Version: 1.0.5**
+**Current Spec Version: projitive-spec v1.0.0 | MCP Version: 1.0.6**
 
 Projitive MCP server (semantic interface edition) helps agents discover projects, select tasks, locate evidence, and execute under governance workflows.
 
@@ -149,7 +149,7 @@ npm run test
 #### `projectInit`
 
 - **Purpose**: manually initialize governance directory structure for a project (default `.projitive`).
-- **Input**: `projectPath?`, `governanceDir?`, `force?`
+- **Input**: `projectPath`, `governanceDir?`, `force?`
 - **Output Example (Markdown)**:
 
 ```markdown
@@ -177,7 +177,7 @@ npm run test
 #### `projectNext`
 
 - **Purpose**: directly list recently actionable projects (ranked by actionable task count and recency).
-- **Input**: `rootPath?`, `maxDepth?`, `limit?`
+- **Input**: `maxDepth?`, `limit?`
 - **Output Example (Markdown)**:
 
 ```markdown
@@ -294,7 +294,7 @@ npm run test
 #### `taskNext`
 
 - **Purpose**: one-step workflow for project discovery + best task selection + evidence/read-order output.
-- **Input**: `rootPath?`, `maxDepth?`, `topCandidates?`
+- **Input**: `maxDepth?`, `topCandidates?`
 - **Output Example (Markdown)**:
 
 ```markdown

package/output/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@projitive/mcp",
-    "version": "1.0.5",
+    "version": "1.0.6",
     "description": "Projitive MCP Server for project and task discovery/update",
     "license": "ISC",
     "author": "",

package/output/source/design-context.js

@@ -84,8 +84,11 @@ export function registerDesignContextPrompts(server) {
                     text: [
                         "Execute Projitive task with minimal calls:",
                         "",
+                        "Prerequisite:",
+                        "- If target project has no `.projitive`, run: projectInit(projectPath=<project-dir>)",
+                        "",
                         "STEP 1: Get task (1 call)",
-                        "- Run: taskNext(rootPath=workspace)",
+                        "- Run: taskNext()",
                         "- Result: selectedTaskId, suggestedReadOrder",
                         "",
                         "STEP 2: Load context (1-2 calls)",

package/output/source/index.js

@@ -47,7 +47,7 @@ function renderMethodCatalogMarkdown() {
         "## Start Here",
         "- Unknown project path: `projectScan` -> `projectLocate` -> `projectContext` -> `taskNext`.",
         "- Known project path: `projectContext` -> `taskNext` (or `taskList`) -> `taskContext`.",
-        "- Need to bootstrap governance: call `projectInit` only when `.projitive` is missing.",
+        "- Need to bootstrap governance: call `projectInit(projectPath=\"<project-dir>\")` only when `.projitive` is missing.",
         "",
         "## Methods",
         "| Order | Group | Method | Agent Use |",
@@ -61,7 +61,7 @@ function renderMethodCatalogMarkdown() {
         "| 7 | Roadmap | roadmapList | inspect roadmap-task linkage |",
         "| 8 | Roadmap | roadmapContext | inspect one roadmap with references |",
         "| 9 | Project | projectNext | rank actionable projects across workspace |",
-        "| 10 | Project | projectInit | bootstrap governance files if missing |",
+        "| 10 | Project | projectInit | bootstrap governance files if missing |"
     ].join("\n");
 }
 function registerGovernanceResources() {
@@ -132,14 +132,13 @@ function registerGovernancePrompts() {
         title: "Execute Task Workflow",
         description: "Primary execution prompt: select one task, execute, and verify evidence consistency",
         argsSchema: {
-            rootPath: z.string().optional(),
             projectPath: z.string().optional(),
             taskId: z.string().optional(),
         },
-    }, async ({ rootPath, projectPath, taskId }) => {
+    }, async ({ projectPath, taskId }) => {
         const taskEntry = taskId && projectPath
             ? `1) Run taskContext(projectPath=\"${projectPath}\", taskId=\"${taskId}\").`
-            : `1) Run taskNext(${rootPath ? `rootPath=\"${rootPath}\"` : ""}).`;
+            : "1) Run taskNext().";
         const text = [
             "You are executing Projitive governance workflow in agent-first mode.",
             "",
@@ -150,6 +149,7 @@ function registerGovernancePrompts() {
             "4) Re-run taskContext for the selected task and verify references.",
             "",
             "Fallbacks:",
+            "- If `.projitive` is missing for a known project, run `projectInit(projectPath=\"<project-dir>\")` first.",
             "- If taskNext returns no actionable task, follow its no-task checklist and create 1-3 TODO tasks.",
             "- If project is unknown, run projectScan -> projectLocate -> projectContext before task tools.",
             "",
@@ -189,17 +189,16 @@ function registerGovernancePrompts() {
     server.registerPrompt("triageProjectGovernance", {
         title: "Triage Project Governance",
         description: "Discovery-first triage prompt to pick project and next executable task",
-        argsSchema: {
-            rootPath: z.string().optional(),
-        },
-    }, async ({ rootPath }) => {
+        argsSchema: {},
+    }, async () => {
         const text = [
             "Triage governance and pick one execution target quickly.",
             "",
+            "0) If known project has no `.projitive`, run projectInit(projectPath=<project-dir>) first.",
             "1) If project path is unknown, run projectScan() and pick one discovered project.",
-            `2) Run projectNext(${rootPath ? `rootPath=\"${rootPath}\"` : ""}) to rank projects.`,
+            "2) Run projectNext() to rank projects.",
             "3) Run projectContext(projectPath=<selectedProject>).",
-            "4) Run taskNext(rootPath=<workspaceRootIfNeeded>) for best actionable task.",
+            "4) Run taskNext() for best actionable task.",
             "5) If manual filtering is needed, run taskList(projectPath=<selectedProject>, status=IN_PROGRESS).",
             "6) Continue with taskContext(projectPath=<selectedProject>, taskId=<selectedTaskId>).",
         ].join("\n");

package/output/source/projitive.js

@@ -276,7 +276,7 @@ export function registerProjectTools(server) {
         title: "Project Init",
         description: "Bootstrap governance files when a project has no .projitive yet",
         inputSchema: {
-            projectPath: z.string().optional(),
+            projectPath: z.string(),
             governanceDir: z.string().optional(),
             force: z.boolean().optional(),
         },
@@ -356,12 +356,11 @@ export function registerProjectTools(server) {
         title: "Project Next",
         description: "Rank actionable projects and return the best execution target",
         inputSchema: {
-            rootPath: z.string().optional(),
             maxDepth: z.number().int().min(0).max(8).optional(),
             limit: z.number().int().min(1).max(50).optional(),
         },
-    }, async ({ rootPath, maxDepth, limit }) => {
-        const root = resolveScanRoot(rootPath);
+    }, async ({ maxDepth, limit }) => {
+        const root = resolveScanRoot();
         const depth = resolveScanDepth(maxDepth);
         const projects = await discoverProjects(root, depth);
         const snapshots = await Promise.all(projects.map(async (governanceDir) => {

package/output/source/tasks.js

@@ -545,12 +545,11 @@ export function registerTaskTools(server) {
         title: "Task Next",
         description: "Start here to auto-select the highest-priority actionable task",
         inputSchema: {
-            rootPath: z.string().optional(),
             maxDepth: z.number().int().min(0).max(8).optional(),
             topCandidates: z.number().int().min(1).max(20).optional(),
         },
-    }, async ({ rootPath, maxDepth, topCandidates }) => {
-        const root = resolveScanRoot(rootPath);
+    }, async ({ maxDepth, topCandidates }) => {
+        const root = resolveScanRoot();
         const depth = resolveScanDepth(maxDepth);
         const projects = await discoverProjects(root, depth);
         const rankedCandidates = rankActionableTaskCandidates(await readActionableTaskCandidates(projects));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@projitive/mcp",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "Projitive MCP Server for project and task discovery/update",
   "license": "ISC",
   "author": "",