@projitive/mcp 1.0.1 → 1.0.2

package/output/roadmap.js

@@ -1,39 +1,60 @@
 import fs from "node:fs/promises";
 import path from "node:path";
 import { z } from "zod";
+import { candidateFilesFromArtifacts } from "./helpers/artifacts/index.js";
 import { discoverGovernanceArtifacts } from "./helpers/files/index.js";
+import { ROADMAP_LINT_CODES, renderLintSuggestions } from "./helpers/linter/index.js";
 import { findTextReferences } from "./helpers/markdown/index.js";
+import { asText, evidenceSection, guidanceSection, lintSection, nextCallSection, renderErrorMarkdown, renderToolResponseMarkdown, summarySection, } from "./helpers/response/index.js";
 import { resolveGovernanceDir } from "./projitive.js";
 import { loadTasks } from "./tasks.js";
 export const ROADMAP_ID_REGEX = /^ROADMAP-\d{4}$/;
-function asText(markdown) {
-    return {
-        content: [{ type: "text", text: markdown }],
-    };
-}
-function renderErrorMarkdown(toolName, cause, nextSteps, retryExample) {
-    return [
-        `# ${toolName}`,
-        "",
-        "## Error",
-        `- cause: ${cause}`,
-        "",
-        "## Next Step",
-        ...(nextSteps.length > 0 ? nextSteps : ["- (none)"]),
-        "",
-        "## Retry Example",
-        `- ${retryExample ?? "(none)"}`,
-    ].join("\n");
+function collectRoadmapLintSuggestionItems(roadmapIds, tasks) {
+    const suggestions = [];
+    if (roadmapIds.length === 0) {
+        suggestions.push({
+            code: ROADMAP_LINT_CODES.IDS_EMPTY,
+            message: "No roadmap IDs found in roadmap.md.",
+            fixHint: "Add at least one ROADMAP-xxxx milestone.",
+        });
+    }
+    if (tasks.length === 0) {
+        suggestions.push({
+            code: ROADMAP_LINT_CODES.TASKS_EMPTY,
+            message: "No tasks found in tasks.md.",
+            fixHint: "Add task cards and bind roadmapRefs for traceability.",
+        });
+        return suggestions;
+    }
+    const roadmapSet = new Set(roadmapIds);
+    const unboundTasks = tasks.filter((task) => task.roadmapRefs.length === 0);
+    if (unboundTasks.length > 0) {
+        suggestions.push({
+            code: ROADMAP_LINT_CODES.TASK_REFS_EMPTY,
+            message: `${unboundTasks.length} task(s) have empty roadmapRefs.`,
+            fixHint: "Bind ROADMAP-xxxx where applicable.",
+        });
+    }
+    const unknownRefs = Array.from(new Set(tasks.flatMap((task) => task.roadmapRefs).filter((id) => !roadmapSet.has(id))));
+    if (unknownRefs.length > 0) {
+        suggestions.push({
+            code: ROADMAP_LINT_CODES.UNKNOWN_REFS,
+            message: `Unknown roadmapRefs detected: ${unknownRefs.join(", ")}.`,
+            fixHint: "Add missing roadmap IDs or fix task references.",
+        });
+    }
+    const noLinkedRoadmaps = roadmapIds.filter((id) => !tasks.some((task) => task.roadmapRefs.includes(id)));
+    if (noLinkedRoadmaps.length > 0) {
+        suggestions.push({
+            code: ROADMAP_LINT_CODES.ZERO_LINKED_TASKS,
+            message: `${noLinkedRoadmaps.length} roadmap ID(s) have zero linked tasks.`,
+            fixHint: `Consider binding tasks to: ${noLinkedRoadmaps.slice(0, 3).join(", ")}${noLinkedRoadmaps.length > 3 ? ", ..." : ""}.`,
+        });
+    }
+    return suggestions;
 }
-function candidateFilesFromArtifacts(artifacts) {
-    return artifacts
-        .filter((item) => item.exists)
-        .flatMap((item) => {
-        if (item.kind === "file") {
-            return [item.path];
-        }
-        return (item.markdownFiles ?? []).map((entry) => entry.path);
-    });
+export function collectRoadmapLintSuggestions(roadmapIds, tasks) {
+    return renderLintSuggestions(collectRoadmapLintSuggestionItems(roadmapIds, tasks));
 }
 export function isValidRoadmapId(id) {
     return ROADMAP_ID_REGEX.test(id);
@@ -60,30 +81,28 @@ export function registerRoadmapTools(server) {
         const governanceDir = await resolveGovernanceDir(projectPath);
         const roadmapIds = await readRoadmapIds(governanceDir);
         const { tasks } = await loadTasks(governanceDir);
-        const markdown = [
-            "# roadmapList",
-            "",
-            "## Summary",
-            `- governanceDir: ${governanceDir}`,
-            `- roadmapCount: ${roadmapIds.length}`,
-            "",
-            "## Evidence",
-            "- roadmaps:",
-            ...(roadmapIds.length > 0
-                ? roadmapIds.map((id) => {
-                    const linkedTasks = tasks.filter((task) => task.roadmapRefs.includes(id));
-                    return `- ${id} | linkedTasks=${linkedTasks.length}`;
-                })
-                : ["- (none)"]),
-            "",
-            "## Agent Guidance",
-            "- Pick one roadmap ID and call `roadmapContext`.",
-            "",
-            "## Next Call",
-            ...(roadmapIds.length > 0
-                ? [`- roadmapContext(projectPath=\"${governanceDir}\", roadmapId=\"${roadmapIds[0]}\")`]
-                : ["- (none)"]),
-        ].join("\n");
+        const lintSuggestions = collectRoadmapLintSuggestions(roadmapIds, tasks);
+        const markdown = renderToolResponseMarkdown({
+            toolName: "roadmapList",
+            sections: [
+                summarySection([
+                    `- governanceDir: ${governanceDir}`,
+                    `- roadmapCount: ${roadmapIds.length}`,
+                ]),
+                evidenceSection([
+                    "- roadmaps:",
+                    ...roadmapIds.map((id) => {
+                        const linkedTasks = tasks.filter((task) => task.roadmapRefs.includes(id));
+                        return `- ${id} | linkedTasks=${linkedTasks.length}`;
+                    }),
+                ]),
+                guidanceSection(["- Pick one roadmap ID and call `roadmapContext`."]),
+                lintSection(lintSuggestions),
+                nextCallSection(roadmapIds[0]
+                    ? `roadmapContext(projectPath=\"${governanceDir}\", roadmapId=\"${roadmapIds[0]}\")`
+                    : undefined),
+            ],
+        });
         return asText(markdown);
     });
     server.registerTool("roadmapContext", {
@@ -96,7 +115,7 @@ export function registerRoadmapTools(server) {
     }, async ({ projectPath, roadmapId }) => {
         if (!isValidRoadmapId(roadmapId)) {
             return {
-                ...asText(renderErrorMarkdown("roadmapContext", `Invalid roadmap ID format: ${roadmapId}`, ["- expected format: ROADMAP-0001", "- retry with a valid roadmap ID"], `roadmapContext(projectPath=\"${projectPath}\", roadmapId=\"ROADMAP-0001\")`)),
+                ...asText(renderErrorMarkdown("roadmapContext", `Invalid roadmap ID format: ${roadmapId}`, ["expected format: ROADMAP-0001", "retry with a valid roadmap ID"], `roadmapContext(projectPath=\"${projectPath}\", roadmapId=\"ROADMAP-0001\")`)),
                 isError: true,
             };
         }
@@ -106,34 +125,41 @@ export function registerRoadmapTools(server) {
         const referenceLocations = (await Promise.all(fileCandidates.map((file) => findTextReferences(file, roadmapId)))).flat();
         const { tasks } = await loadTasks(governanceDir);
         const relatedTasks = tasks.filter((task) => task.roadmapRefs.includes(roadmapId));
-        const markdown = [
-            "# roadmapContext",
-            "",
-            "## Summary",
-            `- governanceDir: ${governanceDir}`,
-            `- roadmapId: ${roadmapId}`,
-            `- relatedTasks: ${relatedTasks.length}`,
-            `- references: ${referenceLocations.length}`,
-            "",
-            "## Evidence",
-            "### Related Tasks",
-            ...(relatedTasks.length > 0
-                ? relatedTasks.map((task) => `- ${task.id} | ${task.status} | ${task.title}`)
-                : ["- (none)"]),
-            "",
-            "### Reference Locations",
-            ...(referenceLocations.length > 0
-                ? referenceLocations.map((item) => `- ${item.filePath}#L${item.line}: ${item.text}`)
-                : ["- (none)"]),
-            "",
-            "## Agent Guidance",
-            "- Read roadmap references first, then related tasks.",
-            "- Keep ROADMAP/TASK IDs unchanged while updating markdown files.",
-            "- Re-run `roadmapContext` after edits to confirm references remain consistent.",
-            "",
-            "## Next Call",
-            `- roadmapContext(projectPath=\"${governanceDir}\", roadmapId=\"${roadmapId}\")`,
-        ].join("\n");
+        const roadmapIds = await readRoadmapIds(governanceDir);
+        const lintSuggestionItems = collectRoadmapLintSuggestionItems(roadmapIds, tasks);
+        if (relatedTasks.length === 0) {
+            lintSuggestionItems.push({
+                code: ROADMAP_LINT_CODES.CONTEXT_RELATED_TASKS_EMPTY,
+                message: `relatedTasks=0 for ${roadmapId}.`,
+                fixHint: "Batch bind task roadmapRefs to improve execution traceability.",
+            });
+        }
+        const lintSuggestions = renderLintSuggestions(lintSuggestionItems);
+        const markdown = renderToolResponseMarkdown({
+            toolName: "roadmapContext",
+            sections: [
+                summarySection([
+                    `- governanceDir: ${governanceDir}`,
+                    `- roadmapId: ${roadmapId}`,
+                    `- relatedTasks: ${relatedTasks.length}`,
+                    `- references: ${referenceLocations.length}`,
+                ]),
+                evidenceSection([
+                    "### Related Tasks",
+                    ...relatedTasks.map((task) => `- ${task.id} | ${task.status} | ${task.title}`),
+                    "",
+                    "### Reference Locations",
+                    ...referenceLocations.map((item) => `- ${item.filePath}#L${item.line}: ${item.text}`),
+                ]),
+                guidanceSection([
+                    "- Read roadmap references first, then related tasks.",
+                    "- Keep ROADMAP/TASK IDs unchanged while updating markdown files.",
+                    "- Re-run `roadmapContext` after edits to confirm references remain consistent.",
+                ]),
+                lintSection(lintSuggestions),
+                nextCallSection(`roadmapContext(projectPath=\"${governanceDir}\", roadmapId=\"${roadmapId}\")`),
+            ],
+        });
         return asText(markdown);
     });
 }

package/output/roadmap.test.js

@@ -0,0 +1,11 @@
+import { describe, expect, it } from "vitest";
+import { collectRoadmapLintSuggestions } from "./roadmap.js";
+import { normalizeTask } from "./tasks.js";
+describe("roadmap lint rendering alignment", () => {
+    it("renders roadmap lint in code-prefixed markdown lines", () => {
+        const lint = collectRoadmapLintSuggestions(["ROADMAP-0001"], [
+            normalizeTask({ id: "TASK-0001", title: "x", status: "TODO", roadmapRefs: [] }),
+        ]);
+        expect(lint.some((line) => line.startsWith("- [ROADMAP_TASK_REFS_EMPTY]"))).toBe(true);
+    });
+});

package/output/smoke-reports/2026-02-18T13-18-19-740Z/projectContext.md

@@ -0,0 +1,48 @@
+# projectContext
+
+- passed: true
+- args: {"projectPath":"/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive"}
+
+## Output
+
+# projectContext
+
+## Summary
+- governanceDir: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive
+- tasksFile: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/tasks.md
+- roadmapIds: 1
+
+## Evidence
+### Task Summary
+- total: 1
+- TODO: 1
+- IN_PROGRESS: 0
+- BLOCKED: 0
+- DONE: 0
+
+### Artifacts
+- ✅ README.md  
+  path: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/README.md  
+  lineCount: 8
+- ✅ roadmap.md  
+  path: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/roadmap.md  
+  lineCount: 4
+- ✅ tasks.md  
+  path: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/tasks.md  
+  lineCount: 11
+- ✅ designs/  
+  path: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/designs
+- ✅ reports/  
+  path: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/reports
+- ✅ hooks/  
+  path: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/hooks
+
+## Agent Guidance
+- Start from `taskList` to choose a target task.
+- Then call `taskContext` with a task ID to retrieve evidence locations and reading order.
+
+## Lint Suggestions
+- (none)
+
+## Next Call
+- taskList(projectPath="/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive")

package/output/smoke-reports/2026-02-18T13-18-19-740Z/projectInit.md

@@ -0,0 +1,40 @@
+# projectInit
+
+- passed: true
+- args: {"rootPath":"/Users/yinxulai/Documents/Github/projitive-mcp-smoke","governanceDir":".projitive","force":true}
+
+## Output
+
+# projectInit
+
+## Summary
+- rootPath: /Users/yinxulai/Documents/Github/projitive-mcp-smoke
+- governanceDir: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive
+- markerPath: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/.projitive
+- force: true
+
+## Evidence
+- createdFiles: 4
+- updatedFiles: 0
+- skippedFiles: 0
+- directories:
+  - created: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive
+  - created: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/designs
+  - created: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/reports
+  - created: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/hooks
+- files:
+  - created: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/.projitive
+  - created: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/README.md
+  - created: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/roadmap.md
+  - created: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/tasks.md
+
+## Agent Guidance
+- If files were skipped and you want to overwrite templates, rerun with force=true.
+- Continue with projectContext and taskList for execution.
+
+## Lint Suggestions
+- After init, fill owner/roadmapRefs/links in tasks.md before marking DONE.
+- Keep task source-of-truth inside marker block only.
+
+## Next Call
+- projectContext(projectPath="/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive")

package/output/smoke-reports/2026-02-18T13-18-19-740Z/projectLocate.md

@@ -0,0 +1,22 @@
+# projectLocate
+
+- passed: true
+- args: {"inputPath":"/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/designs"}
+
+## Output
+
+# projectLocate
+
+## Summary
+- resolvedFrom: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/designs
+- governanceDir: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive
+- markerPath: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/.projitive
+
+## Agent Guidance
+- Call `projectContext` with this governanceDir to get task and roadmap summaries.
+
+## Lint Suggestions
+- Run `projectContext` to get governance/module lint suggestions for this project.
+
+## Next Call
+- projectContext(projectPath="/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive")

package/output/smoke-reports/2026-02-18T13-18-19-740Z/projectNext.md

@@ -0,0 +1,31 @@
+# projectNext
+
+- passed: true
+- args: {"rootPath":"/Users/yinxulai/Documents/Github","maxDepth":2,"limit":5}
+
+## Output
+
+# projectNext
+
+## Summary
+- rootPath: /Users/yinxulai/Documents/Github
+- maxDepth: 2
+- matchedProjects: 2
+- actionableProjects: 2
+- limit: 5
+
+## Evidence
+- rankedProjects:
+1. /Users/yinxulai/Documents/Github/projitive/.projitive | actionable=3 | in_progress=1 | todo=2 | blocked=0 | done=0 | latest=2026-02-17T23:50:00.000Z | tasksPath=/Users/yinxulai/Documents/Github/projitive/.projitive/tasks.md
+2. /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive | actionable=1 | in_progress=0 | todo=1 | blocked=0 | done=0 | latest=2026-02-18T13:18:19.890Z | tasksPath=/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/tasks.md
+
+## Agent Guidance
+- Pick top 1 project and call `projectContext` with its governanceDir.
+- Then call `taskList` and `taskContext` to continue execution.
+- If `tasksPath` is missing, create tasks.md using project convention before task-level operations.
+
+## Lint Suggestions
+- (none)
+
+## Next Call
+- projectContext(projectPath="/Users/yinxulai/Documents/Github/projitive/.projitive")

package/output/smoke-reports/2026-02-18T13-18-19-740Z/projectScan.md

@@ -0,0 +1,28 @@
+# projectScan
+
+- passed: true
+- args: {"rootPath":"/Users/yinxulai/Documents/Github","maxDepth":2}
+
+## Output
+
+# projectScan
+
+## Summary
+- rootPath: /Users/yinxulai/Documents/Github
+- maxDepth: 2
+- discoveredCount: 2
+
+## Evidence
+- projects:
+1. /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive
+2. /Users/yinxulai/Documents/Github/projitive/.projitive
+
+## Agent Guidance
+- Use one discovered project path and call `projectLocate` to lock governance root.
+- Then call `projectContext` to inspect current governance state.
+
+## Lint Suggestions
+- Run `projectContext` on a discovered project to receive module-level lint suggestions.
+
+## Next Call
+- projectLocate(inputPath="/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive")

package/output/smoke-reports/2026-02-18T13-18-19-740Z/roadmapContext.md

@@ -0,0 +1,33 @@
+# roadmapContext
+
+- passed: true
+- args: {"projectPath":"/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive","roadmapId":"ROADMAP-0001"}
+
+## Output
+
+# roadmapContext
+
+## Summary
+- governanceDir: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive
+- roadmapId: ROADMAP-0001
+- relatedTasks: 1
+- references: 2
+
+## Evidence
+### Related Tasks
+- TASK-0001 | TODO | Bootstrap governance workspace
+
+### Reference Locations
+- /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/roadmap.md#L4: - [ ] ROADMAP-0001: Bootstrap governance baseline (time: 2026-Q1)
+- /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/tasks.md#L9: - roadmapRefs: ROADMAP-0001
+
+## Agent Guidance
+- Read roadmap references first, then related tasks.
+- Keep ROADMAP/TASK IDs unchanged while updating markdown files.
+- Re-run `roadmapContext` after edits to confirm references remain consistent.
+
+## Lint Suggestions
+- (none)
+
+## Next Call
+- roadmapContext(projectPath="/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive", roadmapId="ROADMAP-0001")

package/output/smoke-reports/2026-02-18T13-18-19-740Z/roadmapList.md

@@ -0,0 +1,25 @@
+# roadmapList
+
+- passed: true
+- args: {"projectPath":"/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive","limit":5}
+
+## Output
+
+# roadmapList
+
+## Summary
+- governanceDir: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive
+- roadmapCount: 1
+
+## Evidence
+- roadmaps:
+- ROADMAP-0001 | linkedTasks=1
+
+## Agent Guidance
+- Pick one roadmap ID and call `roadmapContext`.
+
+## Lint Suggestions
+- (none)
+
+## Next Call
+- roadmapContext(projectPath="/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive", roadmapId="ROADMAP-0001")

package/output/smoke-reports/2026-02-18T13-18-19-740Z/summary.json

@@ -0,0 +1,90 @@
+{
+  "root": "/Users/yinxulai/Documents/Github",
+  "workspace": "/Users/yinxulai/Documents/Github/projitive",
+  "sandbox": "/Users/yinxulai/Documents/Github/projitive-mcp-smoke",
+  "reportDir": "/Users/yinxulai/Documents/Github/projitive/packages/mcp/output/smoke-reports/2026-02-18T13-18-19-740Z",
+  "generatedAt": "2026-02-18T13:18:20.412Z",
+  "results": [
+    {
+      "methodName": "projectInit",
+      "passed": true,
+      "args": {
+        "rootPath": "/Users/yinxulai/Documents/Github/projitive-mcp-smoke",
+        "governanceDir": ".projitive",
+        "force": true
+      }
+    },
+    {
+      "methodName": "projectScan",
+      "passed": true,
+      "args": {
+        "rootPath": "/Users/yinxulai/Documents/Github",
+        "maxDepth": 2
+      }
+    },
+    {
+      "methodName": "projectNext",
+      "passed": true,
+      "args": {
+        "rootPath": "/Users/yinxulai/Documents/Github",
+        "maxDepth": 2,
+        "limit": 5
+      }
+    },
+    {
+      "methodName": "projectLocate",
+      "passed": true,
+      "args": {
+        "inputPath": "/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/designs"
+      }
+    },
+    {
+      "methodName": "projectContext",
+      "passed": true,
+      "args": {
+        "projectPath": "/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive"
+      }
+    },
+    {
+      "methodName": "taskList",
+      "passed": true,
+      "args": {
+        "projectPath": "/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive",
+        "limit": 5
+      }
+    },
+    {
+      "methodName": "taskNext",
+      "passed": true,
+      "args": {
+        "rootPath": "/Users/yinxulai/Documents/Github",
+        "maxDepth": 2,
+        "topCandidates": 5
+      }
+    },
+    {
+      "methodName": "taskContext",
+      "passed": true,
+      "args": {
+        "projectPath": "/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive",
+        "taskId": "TASK-0001"
+      }
+    },
+    {
+      "methodName": "roadmapList",
+      "passed": true,
+      "args": {
+        "projectPath": "/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive",
+        "limit": 5
+      }
+    },
+    {
+      "methodName": "roadmapContext",
+      "passed": true,
+      "args": {
+        "projectPath": "/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive",
+        "roadmapId": "ROADMAP-0001"
+      }
+    }
+  ]
+}

package/output/smoke-reports/2026-02-18T13-18-19-740Z/summary.md

@@ -0,0 +1,17 @@
+# MCP Smoke Summary
+
+- root: /Users/yinxulai/Documents/Github
+- workspace: /Users/yinxulai/Documents/Github/projitive
+- sandbox: /Users/yinxulai/Documents/Github/projitive-mcp-smoke
+
+## Results
+- PASS | projectInit
+- PASS | projectScan
+- PASS | projectNext
+- PASS | projectLocate
+- PASS | projectContext
+- PASS | taskList
+- PASS | taskNext
+- PASS | taskContext
+- PASS | roadmapList
+- PASS | roadmapContext

package/output/smoke-reports/2026-02-18T13-18-19-740Z/taskContext.md

@@ -0,0 +1,47 @@
+# taskContext
+
+- passed: true
+- args: {"projectPath":"/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive","taskId":"TASK-0001"}
+
+## Output
+
+# taskContext
+
+## Summary
+- governanceDir: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive
+- taskId: TASK-0001
+- title: Bootstrap governance workspace
+- status: TODO
+- owner: unassigned
+- updatedAt: 2026-02-18T13:18:19.890Z
+- roadmapRefs: ROADMAP-0001
+- taskLocation: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/tasks.md#L4
+- hookStatus: head=missing, footer=missing
+
+## Evidence
+### Related Artifacts
+- /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/tasks.md
+
+### Reference Locations
+- /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/tasks.md#L4: ## TASK-0001 | TODO | Bootstrap governance workspace
+
+### Hook Paths
+- (none)
+
+### Suggested Read Order
+1. /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/tasks.md
+
+## Agent Guidance
+- Read the files in Suggested Read Order.
+- Verify whether current status and evidence are consistent.
+- This task is TODO: confirm scope and set execution plan before edits.
+- Move to IN_PROGRESS only after owner and initial evidence are ready.
+- If updates are needed, edit tasks/designs/reports markdown directly and keep TASK IDs unchanged.
+- After editing, re-run `taskContext` to verify references and context consistency.
+
+## Lint Suggestions
+- [TASK_CONTEXT_HOOK_HEAD_MISSING] Missing /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/hooks/task_get_head.md. Add a task context head hook template if you need standardized preface.
+- [TASK_CONTEXT_HOOK_FOOTER_MISSING] Missing /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/hooks/task_get_footer.md. Add a task context footer hook template for standardized close-out checks.
+
+## Next Call
+- taskContext(projectPath="/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive", taskId="TASK-0001")

package/output/smoke-reports/2026-02-18T13-18-19-740Z/taskList.md

@@ -0,0 +1,27 @@
+# taskList
+
+- passed: true
+- args: {"projectPath":"/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive","limit":5}
+
+## Output
+
+# taskList
+
+## Summary
+- governanceDir: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive
+- tasksPath: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/tasks.md
+- filter.status: (none)
+- returned: 1
+
+## Evidence
+- tasks:
+- TASK-0001 | TODO | Bootstrap governance workspace | owner=unassigned | updatedAt=2026-02-18T13:18:19.890Z
+
+## Agent Guidance
+- Pick one task ID and call `taskContext`.
+
+## Lint Suggestions
+- (none)
+
+## Next Call
+- taskContext(projectPath="/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive", taskId="TASK-0001")