@projitive/mcp 1.0.3 → 1.0.4

package/README.md

@@ -2,7 +2,7 @@
 
 Language: English | [简体中文](README_CN.md)
 
-**Current Spec Version: projitive-spec v1.0.0 | MCP Version: 1.0.3**
+**Current Spec Version: projitive-spec v1.0.0 | MCP Version: 1.0.4**
 
 Projitive MCP server (semantic interface edition) helps agents discover projects, select tasks, locate evidence, and execute under governance workflows.
 
@@ -92,10 +92,10 @@ MCP client config example (`mcp.json`):
 }
 ```
 
-Environment variables:
+Environment variables (required):
 
-- `PROJITIVE_SCAN_ROOT_PATH`: fallback scan root for discovery methods when `rootPath` is omitted.
-- `PROJITIVE_SCAN_MAX_DEPTH`: fallback scan depth when `maxDepth` is omitted (`0-8`, default `3`).
+- `PROJITIVE_SCAN_ROOT_PATH`: required scan root for discovery methods.
+- `PROJITIVE_SCAN_MAX_DEPTH`: required scan depth for discovery methods (integer `0-8`).
 
 Local path startup is not the recommended usage mode in this README.
 
@@ -149,14 +149,14 @@ npm run test
 #### `projectInit`
 
 - **Purpose**: manually initialize governance directory structure for a project (default `.projitive`).
-- **Input**: `rootPath?`, `governanceDir?`, `force?`
+- **Input**: `projectPath?`, `governanceDir?`, `force?`
 - **Output Example (Markdown)**:
 
 ```markdown
 # projectInit
 
 ## Summary
-- rootPath: /workspace/proj-a
+- projectPath: /workspace/proj-a
 - governanceDir: /workspace/proj-a/.projitive
 - markerPath: /workspace/proj-a/.projitive/.projitive
 - force: false
@@ -206,7 +206,7 @@ npm run test
 #### `projectScan`
 
 - **Purpose**: scan directories and discover governable projects.
-- **Input**: `rootPath?`, `maxDepth?`
+- **Input**: `(none)`
 - **Output Example (Markdown)**:
 
 ```markdown

package/output/package.json

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

package/output/source/projitive.js

@@ -41,15 +41,27 @@ function parseDepthFromEnv(rawDepth) {
     }
     return Math.min(MAX_SCAN_DEPTH, Math.max(0, parsed));
 }
+function requireEnvVar(name) {
+    const value = process.env[name];
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new Error(`Missing required environment variable: ${name}`);
+    }
+    return value.trim();
+}
 export function resolveScanRoot(inputPath) {
-    const fallback = process.env.PROJITIVE_SCAN_ROOT_PATH;
-    return normalizePath(inputPath ?? fallback);
+    const configuredRoot = requireEnvVar("PROJITIVE_SCAN_ROOT_PATH");
+    return normalizePath(inputPath ?? configuredRoot);
 }
 export function resolveScanDepth(inputDepth) {
+    const configuredDepthRaw = requireEnvVar("PROJITIVE_SCAN_MAX_DEPTH");
+    const configuredDepth = parseDepthFromEnv(configuredDepthRaw);
+    if (typeof configuredDepth !== "number") {
+        throw new Error("Invalid PROJITIVE_SCAN_MAX_DEPTH: expected integer in range 0-8");
+    }
     if (typeof inputDepth === "number") {
         return inputDepth;
     }
-    return parseDepthFromEnv(process.env.PROJITIVE_SCAN_MAX_DEPTH) ?? DEFAULT_SCAN_DEPTH;
+    return configuredDepth;
 }
 function renderArtifactsMarkdown(artifacts) {
     const rows = artifacts.map((item) => {
@@ -226,16 +238,16 @@ function defaultNoTaskDiscoveryHookMarkdown() {
     ].join("\n");
 }
 export async function initializeProjectStructure(inputPath, governanceDir, force = false) {
-    const rootPath = normalizePath(inputPath);
+    const projectPath = normalizePath(inputPath);
     const governanceDirName = normalizeGovernanceDirName(governanceDir);
-    const rootStat = await catchIt(fs.stat(rootPath));
+    const rootStat = await catchIt(fs.stat(projectPath));
     if (rootStat.isError()) {
-        throw new Error(`Path not found: ${rootPath}`);
+        throw new Error(`Path not found: ${projectPath}`);
     }
     if (!rootStat.value.isDirectory()) {
-        throw new Error(`rootPath must be a directory: ${rootPath}`);
+        throw new Error(`projectPath must be a directory: ${projectPath}`);
     }
-    const governancePath = path.join(rootPath, governanceDirName);
+    const governancePath = path.join(projectPath, governanceDirName);
     const directories = [];
     const requiredDirectories = [governancePath, path.join(governancePath, "designs"), path.join(governancePath, "reports"), path.join(governancePath, "hooks")];
     for (const dirPath of requiredDirectories) {
@@ -252,7 +264,7 @@ export async function initializeProjectStructure(inputPath, governanceDir, force
         writeTextFile(path.join(governancePath, "hooks", "task_no_actionable.md"), defaultNoTaskDiscoveryHookMarkdown(), force),
     ]);
     return {
-        rootPath,
+        projectPath,
         governanceDir: governancePath,
         markerPath,
         directories,
@@ -264,12 +276,12 @@ export function registerProjectTools(server) {
         title: "Project Init",
         description: "Initialize Projitive governance directory structure manually (default .projitive)",
         inputSchema: {
-            rootPath: z.string().optional(),
+            projectPath: z.string().optional(),
             governanceDir: z.string().optional(),
             force: z.boolean().optional(),
         },
-    }, async ({ rootPath, governanceDir, force }) => {
-        const initialized = await initializeProjectStructure(rootPath, governanceDir, force ?? false);
+    }, async ({ projectPath, governanceDir, force }) => {
+        const initialized = await initializeProjectStructure(projectPath, governanceDir, force ?? false);
         const filesByAction = {
             created: initialized.files.filter((item) => item.action === "created"),
             updated: initialized.files.filter((item) => item.action === "updated"),
@@ -279,7 +291,7 @@ export function registerProjectTools(server) {
             toolName: "projectInit",
             sections: [
                 summarySection([
-                    `- rootPath: ${initialized.rootPath}`,
+                    `- projectPath: ${initialized.projectPath}`,
                     `- governanceDir: ${initialized.governanceDir}`,
                     `- markerPath: ${initialized.markerPath}`,
                     `- force: ${force === true ? "true" : "false"}`,
@@ -309,13 +321,10 @@ export function registerProjectTools(server) {
     server.registerTool("projectScan", {
         title: "Project Scan",
         description: "Scan filesystem and discover project governance roots marked by .projitive",
-        inputSchema: {
-            rootPath: z.string().optional(),
-            maxDepth: z.number().int().min(0).max(8).optional(),
-        },
-    }, async ({ rootPath, maxDepth }) => {
-        const root = resolveScanRoot(rootPath);
-        const depth = resolveScanDepth(maxDepth);
+        inputSchema: {},
+    }, async () => {
+        const root = resolveScanRoot();
+        const depth = resolveScanDepth();
         const projects = await discoverProjects(root, depth);
         const markdown = renderToolResponseMarkdown({
             toolName: "projectScan",

package/output/source/tasks.js

@@ -611,7 +611,7 @@ export function registerTaskTools(server) {
                     ]),
                     nextCallSection(preferredProject
                         ? `projectContext(projectPath=\"${preferredProject.governanceDir}\")`
-                        : `projectScan(rootPath=\"${root}\", maxDepth=${depth})`),
+                        : "projectScan()"),
                 ],
             });
             return asText(markdown);

package/package.json

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