@projitive/mcp 2.0.3 → 2.0.4

package/output/source/prompts/quickStart.js

@@ -1,11 +1,11 @@
-import { z } from "zod";
+import { z } from 'zod';
 function asUserPrompt(text) {
     return {
         messages: [
             {
-                role: "user",
+                role: 'user',
                 content: {
-                    type: "text",
+                    type: 'text',
                     text,
                 },
             },
@@ -13,108 +13,108 @@ function asUserPrompt(text) {
     };
 }
 export function registerQuickStartPrompt(server) {
-    server.registerPrompt("quickStart", {
-        title: "Quick Start",
-        description: "Complete workflow to discover project, load context, and start task execution",
+    server.registerPrompt('quickStart', {
+        title: 'Quick Start',
+        description: 'Complete workflow to discover project, load context, and start task execution',
         argsSchema: {
             projectPath: z.string().optional(),
         },
     }, async ({ projectPath }) => {
         const text = [
-            "# How to Govern a Project",
-            "",
-            "You are a Projitive governance assistant. Here is the complete workflow:",
-            "",
-            "## Step 1: Discover the Project",
-            "",
+            '# How to Govern a Project',
+            '',
+            'You are a Projitive governance assistant. Here is the complete workflow:',
+            '',
+            '## Step 1: Discover the Project',
+            '',
             projectPath
                 ? [
                     `- Known project path: "${projectPath}"`,
-                    "- Call `projectContext(projectPath=\"" + projectPath + "\")` directly to load project overview",
-                ].join("\n")
+                    '- Call `projectContext(projectPath="' + projectPath + '")` directly to load project overview',
+                ].join('\n')
                 : [
-                    "- Unknown project path:",
-                    "  1. Call `projectScan()` to discover all governance roots",
-                    "  2. Select a target project",
-                    "  3. Call `projectLocate(inputPath=\"<selected-path>\")` to lock governance root",
-                    "  4. Call `projectContext(projectPath=\"<project-path>\")` to load project overview",
-                ].join("\n"),
-            "",
-            "## Step 2: Understand the Project",
-            "",
-            "After loading project context, read these resources:",
-            "- projitive://governance/workspace - Project overview",
-            "- projitive://governance/tasks - Current task pool",
-            "- projitive://governance/roadmap - Project roadmap",
-            "- projitive://designs/* - Design documents",
-            "",
-            "## Step 3: Discover Tasks",
-            "",
-            "Two ways to discover tasks:",
-            "",
-            "### Option A: Auto-select (Recommended)",
-            "Call `taskNext()` to get highest-priority actionable task.",
-            "If no actionable tasks are returned and roadmap has active goals, analyze roadmap context and create 1-3 TODO tasks via `taskCreate()`.",
-            "Then call `taskNext()` again to re-rank.",
-            "",
-            "### Option B: Manual select",
-            "1. Call `taskList()` to list all tasks",
-            "2. Select a task based on status and priority",
-            "3. Call `taskContext(projectPath=\"...\", taskId=\"...\")` for details",
-            "",
-            "## Step 4: Execute the Task",
-            "",
-            "After getting task context:",
-            "1. Read evidence links in Suggested Read Order",
-            "2. Understand task requirements and acceptance criteria",
-            "3. Write governance source via tools (`taskCreate` / `taskUpdate` / `roadmapCreate` / `roadmapUpdate`) instead of editing tasks.md/roadmap.md directly",
-            "4. Update docs (`designs/` / `reports/`) as required by evidence",
-            "5. taskCreate/taskUpdate/roadmapCreate/roadmapUpdate will auto-sync corresponding markdown views",
-            "6. Update task status:",
-            "   - TODO → IN_PROGRESS (when starting execution)",
-            "   - IN_PROGRESS → DONE (when completed)",
-            "   - IN_PROGRESS → BLOCKED (when blocked)",
-            "7. Re-run taskContext() to verify changes",
-            "",
-            "## Autonomous Operating Loop",
-            "",
-            "Keep this loop until no high-value actionable work remains:",
-            "1. Discover: `taskNext()`",
-            "2. Execute: update governance store + docs + report evidence",
-            "3. Verify: `taskContext()`",
-            "4. Re-prioritize: `taskNext()`",
-            "",
-            "Stop and re-discover only when:",
-            "- Current task is BLOCKED with a clear blocker description and unblock condition",
-            "- Acceptance criteria are met and status is DONE",
-            "- Project has no actionable tasks and requires roadmap-driven task creation",
-            "",
-            "## Special Cases",
-            "",
-            "### Case 1: No .projitive directory",
-            "Call `projectInit(projectPath=\"<project-dir>\")` to initialize governance structure.",
-            "",
-            "### Case 2: No actionable tasks",
-            "1. Check if .projitive database is missing",
-            "2. If roadmap has active goals, split milestones into 1-3 executable TODO tasks",
-            "3. Apply task creation gate before adding each task:",
-            "   - Clear outcome: one-sentence done condition",
-            "   - Verifiable evidence: at least one report/designs/readme link target",
-            "   - Small slice: should be completable in one focused execution cycle",
-            "   - Traceability: include at least one roadmapRefs item when applicable",
-            "   - Distinct scope: avoid overlap with existing DONE/BLOCKED tasks",
-            "4. Prefer unblocking tasks that unlock multiple follow-up tasks",
-            "5. Re-run `taskNext()` to pick the new tasks",
-            "6. If still no tasks, read design documents in projitive://designs/ and create TODO tasks via `taskCreate()`",
-            "",
-            "## Hard Rules",
-            "",
-            "- **NEVER modify TASK/ROADMAP IDs** - Keep them immutable once assigned",
-            "- **Every status transition must have report evidence** - Create execution reports in reports/ directory",
-            "- **.projitive governance store is source of truth** - tasks.md/roadmap.md are generated views and may be overwritten",
-            "- **Prefer tool writes over manual table/view edits** - Use taskCreate/taskUpdate/roadmapCreate/roadmapUpdate",
-            "- **Always verify after updates** - Re-run taskContext() to confirm reference consistency",
-        ].join("\n");
+                    '- Unknown project path:',
+                    '  1. Call `projectScan()` to discover all governance roots',
+                    '  2. Select a target project',
+                    '  3. Call `projectLocate(inputPath="<selected-path>")` to lock governance root',
+                    '  4. Call `projectContext(projectPath="<project-path>")` to load project overview',
+                ].join('\n'),
+            '',
+            '## Step 2: Understand the Project',
+            '',
+            'After loading project context, read these resources:',
+            '- projitive://governance/workspace - Project overview',
+            '- projitive://governance/tasks - Current task pool',
+            '- projitive://governance/roadmap - Project roadmap',
+            '- projitive://designs/* - Design documents',
+            '',
+            '## Step 3: Discover Tasks',
+            '',
+            'Two ways to discover tasks:',
+            '',
+            '### Option A: Auto-select (Recommended)',
+            'Call `taskNext()` to get highest-priority actionable task.',
+            'If no actionable tasks are returned and roadmap has active goals, analyze roadmap context and create 1-3 TODO tasks via `taskCreate()`.',
+            'Then call `taskNext()` again to re-rank.',
+            '',
+            '### Option B: Manual select',
+            '1. Call `taskList()` to list all tasks',
+            '2. Select a task based on status and priority',
+            '3. Call `taskContext(projectPath="...", taskId="...")` for details',
+            '',
+            '## Step 4: Execute the Task',
+            '',
+            'After getting task context:',
+            '1. Read evidence links in Suggested Read Order',
+            '2. Understand task requirements and acceptance criteria',
+            '3. Write governance source via tools (`taskCreate` / `taskUpdate` / `roadmapCreate` / `roadmapUpdate`) instead of editing tasks.md/roadmap.md directly',
+            '4. Update docs (`designs/` / `reports/`) as required by evidence',
+            '5. taskCreate/taskUpdate/roadmapCreate/roadmapUpdate will auto-sync corresponding markdown views',
+            '6. Update task status:',
+            '   - TODO → IN_PROGRESS (when starting execution)',
+            '   - IN_PROGRESS → DONE (when completed)',
+            '   - IN_PROGRESS → BLOCKED (when blocked)',
+            '7. Re-run taskContext() to verify changes',
+            '',
+            '## Autonomous Operating Loop',
+            '',
+            'Keep this loop until no high-value actionable work remains:',
+            '1. Discover: `taskNext()`',
+            '2. Execute: update governance store + docs + report evidence',
+            '3. Verify: `taskContext()`',
+            '4. Re-prioritize: `taskNext()`',
+            '',
+            'Stop and re-discover only when:',
+            '- Current task is BLOCKED with a clear blocker description and unblock condition',
+            '- Acceptance criteria are met and status is DONE',
+            '- Project has no actionable tasks and requires roadmap-driven task creation',
+            '',
+            '## Special Cases',
+            '',
+            '### Case 1: No .projitive directory',
+            'Call `projectInit(projectPath="<project-dir>")` to initialize governance structure.',
+            '',
+            '### Case 2: No actionable tasks',
+            '1. Check if .projitive database is missing',
+            '2. If roadmap has active goals, split milestones into 1-3 executable TODO tasks',
+            '3. Apply task creation gate before adding each task:',
+            '   - Clear outcome: one-sentence done condition',
+            '   - Verifiable evidence: at least one report/designs/readme link target',
+            '   - Small slice: should be completable in one focused execution cycle',
+            '   - Traceability: include at least one roadmapRefs item when applicable',
+            '   - Distinct scope: avoid overlap with existing DONE/BLOCKED tasks',
+            '4. Prefer unblocking tasks that unlock multiple follow-up tasks',
+            '5. Re-run `taskNext()` to pick the new tasks',
+            '6. If still no tasks, read design documents in projitive://designs/ and create TODO tasks via `taskCreate()`',
+            '',
+            '## Hard Rules',
+            '',
+            '- **NEVER modify TASK/ROADMAP IDs** - Keep them immutable once assigned',
+            '- **Every status transition must have report evidence** - Create execution reports in reports/ directory',
+            '- **.projitive governance store is source of truth** - tasks.md/roadmap.md are generated views and may be overwritten',
+            '- **Prefer tool writes over manual table/view edits** - Use taskCreate/taskUpdate/roadmapCreate/roadmapUpdate',
+            '- **Always verify after updates** - Re-run taskContext() to confirm reference consistency',
+        ].join('\n');
         return asUserPrompt(text);
     });
 }

package/output/source/prompts/taskDiscovery.js

@@ -1,11 +1,11 @@
-import { z } from "zod";
+import { z } from 'zod';
 function asUserPrompt(text) {
     return {
         messages: [
             {
-                role: "user",
+                role: 'user',
                 content: {
-                    type: "text",
+                    type: 'text',
                     text,
                 },
             },
@@ -13,196 +13,196 @@ function asUserPrompt(text) {
     };
 }
 export function registerTaskDiscoveryPrompt(server) {
-    server.registerPrompt("taskDiscovery", {
-        title: "Task Discovery",
-        description: "Minimal steps to find, context, and execute the first actionable task",
+    server.registerPrompt('taskDiscovery', {
+        title: 'Task Discovery',
+        description: 'Minimal steps to find, context, and execute the first actionable task',
         argsSchema: {
             projectPath: z.string().optional(),
         },
     }, async ({ projectPath }) => {
         const text = [
-            "# How to Discover Tasks",
-            "",
-            "You are a Projitive task discovery assistant. Here is the complete workflow to discover and execute your first task:",
-            "",
-            "## Step 1: Locate the Project",
-            "",
+            '# How to Discover Tasks',
+            '',
+            'You are a Projitive task discovery assistant. Here is the complete workflow to discover and execute your first task:',
+            '',
+            '## Step 1: Locate the Project',
+            '',
             projectPath
                 ? [
                     `- Known project path: "${projectPath}"`,
-                    "- Call `projectContext(projectPath=\"" + projectPath + "\")` directly to load project context",
-                ].join("\n")
+                    '- Call `projectContext(projectPath="' + projectPath + '")` directly to load project context',
+                ].join('\n')
                 : [
-                    "- Unknown project path:",
-                    "  1. Call `projectScan()` to discover all governance roots",
-                    "  2. Select a project",
-                    "  3. Call `projectLocate(inputPath=\"<selected-path>\")` to lock governance root",
-                    "  4. Call `projectContext(projectPath=\"<project-path>\")` to load project context",
-                ].join("\n"),
-            "",
-            "## Step 2: Read Project Context",
-            "",
-            "After loading project context, focus on:",
-            "",
-            "### Task Summary",
-            "- total: Total tasks",
-            "- TODO: Pending tasks (highest priority)",
-            "- IN_PROGRESS: In-progress tasks (priority to continue)",
-            "- BLOCKED: Blocked tasks (need to resolve first)",
-            "- DONE: Completed tasks",
-            "",
-            "### Artifacts",
-            "Check if these files exist:",
-            "- \u2705 .projitive - Governance store file (required)",
-            "- \u2705 tasks.md - Generated task view",
-            "- \u2705 roadmap.md - Generated roadmap view",
-            "- \u2705 README.md - Project description",
-            "- \u2705 designs/ - Design documents directory",
-            "- \u2705 reports/ - Reports directory",
-            "",
-            "## Step 3: Select a Task",
-            "",
-            "### Priority Order",
-            "Select tasks in this priority order:",
-            "",
-            "1. **IN_PROGRESS** - Priority to continue in-progress tasks first",
-            "   - These tasks have already started, should continue to finish",
-            "   - Check updatedAt time, most recent first",
-            "",
-            "2. **TODO** - Next select pending tasks",
-            "   - Tasks with roadmapRefs first",
-            "   - Tasks with explicit owner first",
-            "",
-            "3. **BLOCKED** - Last consider blocked tasks",
-            "   - Need to analyze blocker reason first",
-            "   - May need to create sub-task to resolve blocker",
-            "",
-            "### Discovery Methods",
-            "",
-            "#### Method A: Auto-select with taskNext() (Recommended)",
-            "",
-            "Call `taskNext()`, the tool will automatically:",
-            "- Sort all tasks by priority",
-            "- Select highest-priority actionable task",
-            "- Return task ID and summary",
-            "",
-            "Then call `taskContext(projectPath=\"...\", taskId=\"<task-id>\")` for task details.",
-            "",
-            "### Discovery Quality Gate (before creating new tasks)",
-            "Only create a TODO when all conditions are true:",
-            "- It can be finished in one focused execution cycle",
-            "- It has explicit done condition and measurable evidence output",
-            "- It links to roadmap/readme/report/design context",
-            "- It does not duplicate an existing TODO/IN_PROGRESS/BLOCKED task",
-            "- It improves project throughput (unblocks or delivers user-visible value)",
-            "",
-            "#### Method B: Manual select with taskList()",
-            "",
-            "1. Call `taskList()` to get all tasks",
-            "2. Select based on these factors:",
-            "   - status (IN_PROGRESS > TODO > BLOCKED)",
-            "   - updatedAt time (most recent first)",
-            "   - owner assigned (with owner first)",
-            "   - roadmapRefs (with refs first)",
-            "3. Call `taskContext(projectPath=\"...\", taskId=\"<selected-id>\")` for details",
-            "",
-            "## Step 4: Understand Task Context",
-            "",
-            "After getting taskContext, read carefully:",
-            "",
-            "### Summary",
-            "- taskId: Task ID (NEVER modify this)",
-            "- status: Current status",
-            "- owner: Assignee",
-            "- roadmapRefs: Related roadmap",
-            "- updatedAt: Last updated time",
-            "",
-            "### Evidence",
-            "- Candidate Files - Related file list",
-            "- Reference Locations - Reference locations",
-            "",
-            "### Suggested Read Order",
-            "Read files in order, understand:",
-            "- Task background and motivation",
-            "- Task acceptance criteria",
-            "- Related design decisions",
-            "- Previous execution history",
-            "",
-            "### Lint Suggestions",
-            "Check if any warnings need to be resolved first.",
-            "",
-            "## Step 5: Execute the Task",
-            "",
-            "After understanding the task:",
-            "",
-            "1. **If status is TODO",
-            "   - First call `taskUpdate()` to change status to IN_PROGRESS",
-            "   - Set owner (if empty)",
-            "   - Fill subState (optional, Spec v1.1.0)",
-            "",
-            "2. **If status is IN_PROGRESS",
-            "   - Continue previous work",
-            "   - Reference history reports in reports/",
-            "",
-            "3. **Execute task content**",
-            "   - Update governance store via MCP tools; edit designs/*.md and reports/*.md as needed",
-            "   - If immediate markdown snapshots are required by another agent/session, call syncViews(force=true)",
-            "   - Create execution report (reports/ directory)",
-            "   - Update task status to DONE",
-            "",
-            "4. **Verify changes**",
-            "   - Re-run `taskContext()`",
-            "   - Confirm all references still valid",
-            "   - Confirm no new lint suggestions",
-            "",
-            "## Special Cases",
-            "",
-            "### Case 1: No tasks at all",
-            "",
-            "If taskNext() returns empty:",
-            "1. Check if .projitive exists",
-            "2. Analyze active roadmap milestones and derive 1-3 executable TODO tasks",
-            "3. Prioritize milestone slices that unblock multiple downstream tasks",
-            "3.5 If roadmap milestone is missing, create it first via `roadmapCreate()`",
-            "4. Create tasks via `taskCreate(projectPath=\"...\", taskId=\"TASK-xxxx\", title=\"...\", roadmapRefs=[\"ROADMAP-xxxx\"], summary=\"...\")`",
-            "5. Re-run taskNext() and continue execution if tasks are available",
-            "6. If still empty, read design documents in designs/ directory",
-            "7. Read roadmap.md to understand project goals",
-            "8. Create 1-3 new TODO tasks",
-            "9. Each task must have:",
-            "   - Unique TASK-xxxx ID",
-            "   - Clear title",
-            "   - Detailed summary",
-            "   - Linked roadmapRefs (if applicable)",
-            "",
-            "### Case 2: All tasks are BLOCKED",
-            "",
-            "1. Select one blocked task and call `taskContext()`",
-            "2. Understand blocker reason (check blocker field, Spec v1.1.0)",
-            "3. Create a new TODO task via `taskCreate()` to resolve blocker",
-            "4. Execute this new task first",
-            "",
-            "### Case 3: Missing required governance files",
-            "",
-            "If .projitive does not exist:",
-            "1. Call `projectInit(projectPath=\"...\")` to initialize governance structure",
-            "2. Then restart discovery flow",
-            "",
-            "## Quick Reference",
-            "",
-            "| Tool | Purpose |",
-            "|------|---------|",
-            "| `projectScan()` | Discover all governance roots |",
-            "| `projectLocate()` | Lock governance root |",
-            "| `projectContext()` | Load project overview |",
-            "| `taskNext()` | Auto-select best task |",
-            "| `taskList()` | List all tasks |",
-            "| `taskContext()` | Get task details |",
-            "| `taskCreate()` | Create a new task |",
-            "| `taskUpdate()` | Update task status |",
-            "| `roadmapCreate()` | Create a new roadmap milestone |",
-            "| `syncViews()` | Force materialize tasks.md/roadmap.md from governance store |",
-        ].join("\n");
+                    '- Unknown project path:',
+                    '  1. Call `projectScan()` to discover all governance roots',
+                    '  2. Select a project',
+                    '  3. Call `projectLocate(inputPath="<selected-path>")` to lock governance root',
+                    '  4. Call `projectContext(projectPath="<project-path>")` to load project context',
+                ].join('\n'),
+            '',
+            '## Step 2: Read Project Context',
+            '',
+            'After loading project context, focus on:',
+            '',
+            '### Task Summary',
+            '- total: Total tasks',
+            '- TODO: Pending tasks (highest priority)',
+            '- IN_PROGRESS: In-progress tasks (priority to continue)',
+            '- BLOCKED: Blocked tasks (need to resolve first)',
+            '- DONE: Completed tasks',
+            '',
+            '### Artifacts',
+            'Check if these files exist:',
+            '- \u2705 .projitive - Governance store file (required)',
+            '- \u2705 tasks.md - Generated task view',
+            '- \u2705 roadmap.md - Generated roadmap view',
+            '- \u2705 README.md - Project description',
+            '- \u2705 designs/ - Design documents directory',
+            '- \u2705 reports/ - Reports directory',
+            '',
+            '## Step 3: Select a Task',
+            '',
+            '### Priority Order',
+            'Select tasks in this priority order:',
+            '',
+            '1. **IN_PROGRESS** - Priority to continue in-progress tasks first',
+            '   - These tasks have already started, should continue to finish',
+            '   - Check updatedAt time, most recent first',
+            '',
+            '2. **TODO** - Next select pending tasks',
+            '   - Tasks with roadmapRefs first',
+            '   - Tasks with explicit owner first',
+            '',
+            '3. **BLOCKED** - Last consider blocked tasks',
+            '   - Need to analyze blocker reason first',
+            '   - May need to create sub-task to resolve blocker',
+            '',
+            '### Discovery Methods',
+            '',
+            '#### Method A: Auto-select with taskNext() (Recommended)',
+            '',
+            'Call `taskNext()`, the tool will automatically:',
+            '- Sort all tasks by priority',
+            '- Select highest-priority actionable task',
+            '- Return task ID and summary',
+            '',
+            'Then call `taskContext(projectPath="...", taskId="<task-id>")` for task details.',
+            '',
+            '### Discovery Quality Gate (before creating new tasks)',
+            'Only create a TODO when all conditions are true:',
+            '- It can be finished in one focused execution cycle',
+            '- It has explicit done condition and measurable evidence output',
+            '- It links to roadmap/readme/report/design context',
+            '- It does not duplicate an existing TODO/IN_PROGRESS/BLOCKED task',
+            '- It improves project throughput (unblocks or delivers user-visible value)',
+            '',
+            '#### Method B: Manual select with taskList()',
+            '',
+            '1. Call `taskList()` to get all tasks',
+            '2. Select based on these factors:',
+            '   - status (IN_PROGRESS > TODO > BLOCKED)',
+            '   - updatedAt time (most recent first)',
+            '   - owner assigned (with owner first)',
+            '   - roadmapRefs (with refs first)',
+            '3. Call `taskContext(projectPath="...", taskId="<selected-id>")` for details',
+            '',
+            '## Step 4: Understand Task Context',
+            '',
+            'After getting taskContext, read carefully:',
+            '',
+            '### Summary',
+            '- taskId: Task ID (NEVER modify this)',
+            '- status: Current status',
+            '- owner: Assignee',
+            '- roadmapRefs: Related roadmap',
+            '- updatedAt: Last updated time',
+            '',
+            '### Evidence',
+            '- Candidate Files - Related file list',
+            '- Reference Locations - Reference locations',
+            '',
+            '### Suggested Read Order',
+            'Read files in order, understand:',
+            '- Task background and motivation',
+            '- Task acceptance criteria',
+            '- Related design decisions',
+            '- Previous execution history',
+            '',
+            '### Lint Suggestions',
+            'Check if any warnings need to be resolved first.',
+            '',
+            '## Step 5: Execute the Task',
+            '',
+            'After understanding the task:',
+            '',
+            '1. **If status is TODO',
+            '   - First call `taskUpdate()` to change status to IN_PROGRESS',
+            '   - Set owner (if empty)',
+            '   - Fill subState (optional, Spec v1.1.0)',
+            '',
+            '2. **If status is IN_PROGRESS',
+            '   - Continue previous work',
+            '   - Reference history reports in reports/',
+            '',
+            '3. **Execute task content**',
+            '   - Update governance store via MCP tools; edit designs/*.md and reports/*.md as needed',
+            '   - If immediate markdown snapshots are required by another agent/session, call syncViews(force=true)',
+            '   - Create execution report (reports/ directory)',
+            '   - Update task status to DONE',
+            '',
+            '4. **Verify changes**',
+            '   - Re-run `taskContext()`',
+            '   - Confirm all references still valid',
+            '   - Confirm no new lint suggestions',
+            '',
+            '## Special Cases',
+            '',
+            '### Case 1: No tasks at all',
+            '',
+            'If taskNext() returns empty:',
+            '1. Check if .projitive exists',
+            '2. Analyze active roadmap milestones and derive 1-3 executable TODO tasks',
+            '3. Prioritize milestone slices that unblock multiple downstream tasks',
+            '3.5 If roadmap milestone is missing, create it first via `roadmapCreate()`',
+            '4. Create tasks via `taskCreate(projectPath="...", taskId="TASK-xxxx", title="...", roadmapRefs=["ROADMAP-xxxx"], summary="...")`',
+            '5. Re-run taskNext() and continue execution if tasks are available',
+            '6. If still empty, read design documents in designs/ directory',
+            '7. Read roadmap.md to understand project goals',
+            '8. Create 1-3 new TODO tasks',
+            '9. Each task must have:',
+            '   - Unique TASK-xxxx ID',
+            '   - Clear title',
+            '   - Detailed summary',
+            '   - Linked roadmapRefs (if applicable)',
+            '',
+            '### Case 2: All tasks are BLOCKED',
+            '',
+            '1. Select one blocked task and call `taskContext()`',
+            '2. Understand blocker reason (check blocker field, Spec v1.1.0)',
+            '3. Create a new TODO task via `taskCreate()` to resolve blocker',
+            '4. Execute this new task first',
+            '',
+            '### Case 3: Missing required governance files',
+            '',
+            'If .projitive does not exist:',
+            '1. Call `projectInit(projectPath="...")` to initialize governance structure',
+            '2. Then restart discovery flow',
+            '',
+            '## Quick Reference',
+            '',
+            '| Tool | Purpose |',
+            '|------|---------|',
+            '| `projectScan()` | Discover all governance roots |',
+            '| `projectLocate()` | Lock governance root |',
+            '| `projectContext()` | Load project overview |',
+            '| `taskNext()` | Auto-select best task |',
+            '| `taskList()` | List all tasks |',
+            '| `taskContext()` | Get task details |',
+            '| `taskCreate()` | Create a new task |',
+            '| `taskUpdate()` | Update task status |',
+            '| `roadmapCreate()` | Create a new roadmap milestone |',
+            '| `syncViews()` | Force materialize tasks.md/roadmap.md from governance store |',
+        ].join('\n');
         return asUserPrompt(text);
     });
 }