mcp-spec-cli 1.1.0 → 1.2.0

package/dist/features/task/taskGuidancePresenter.d.ts

@@ -0,0 +1,20 @@
+/**
+ * TaskGuidancePresenter handles the construction of complex UI guidance strings
+ * for "Next Step" and model prompts during task implementation.
+ */
+export declare class TaskGuidancePresenter {
+    private static get template();
+    /**
+     * Build task guidance text after task completion.
+     */
+    static buildNextStepGuidance(tasksContent: string, completedTaskNumber?: string, isFirstTask?: boolean): string;
+    /**
+     * Extract the first uncompleted task with its context using TaskLexer.
+     */
+    static extractFirstUncompletedSubtask(tasksContent: string): string;
+    /**
+     * Get formatted completion message.
+     */
+    static getCompletionMessage(type: 'taskCompleted' | 'allCompleted' | 'alreadyCompleted' | 'batchSucceeded' | 'batchCompleted', taskNumber?: string): string;
+}
+//# sourceMappingURL=taskGuidancePresenter.d.ts.map

package/dist/features/task/taskGuidancePresenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskGuidancePresenter.d.ts","sourceRoot":"","sources":["../../../src/features/task/taskGuidancePresenter.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,KAAK,QAAQ,GAG1B;IAED;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAC1B,YAAY,EAAE,MAAM,EACpB,mBAAmB,CAAC,EAAE,MAAM,EAC5B,WAAW,GAAE,OAAe,GAC3B,MAAM;IA8CT;;OAEG;IACH,MAAM,CAAC,8BAA8B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAcnE;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,IAAI,EAAE,eAAe,GAAG,cAAc,GAAG,kBAAkB,GAAG,gBAAgB,GAAG,gBAAgB,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM;CAY5J"}

package/dist/features/task/taskGuidancePresenter.js

@@ -0,0 +1,84 @@
+import { openApiLoader, OpenApiLoader } from '../shared/openApiLoader.js';
+import { TaskLexer } from '../shared/taskLexer.js';
+/**
+ * TaskGuidancePresenter handles the construction of complex UI guidance strings
+ * for "Next Step" and model prompts during task implementation.
+ */
+export class TaskGuidancePresenter {
+    static get template() {
+        openApiLoader.loadSpec();
+        return openApiLoader.getTaskGuidanceTemplate();
+    }
+    /**
+     * Build task guidance text after task completion.
+     */
+    static buildNextStepGuidance(tasksContent, completedTaskNumber, isFirstTask = false) {
+        const template = this.template;
+        if (!template) {
+            throw new Error('Failed to load task guidance template from OpenAPI specification');
+        }
+        const firstSubtask = this.extractFirstUncompletedSubtask(tasksContent);
+        const parts = [];
+        // Add separator line
+        parts.push(template.separator);
+        parts.push('');
+        // Add task header
+        parts.push(template.header);
+        parts.push(tasksContent);
+        parts.push('');
+        // Add model instructions
+        parts.push(template.instructions.prefix);
+        const taskFocusText = OpenApiLoader.replaceVariables(template.instructions.taskFocus, { firstSubtask });
+        parts.push(taskFocusText);
+        parts.push('');
+        parts.push(template.instructions.progressTracking);
+        parts.push(template.instructions.workflow);
+        parts.push('');
+        // Add model prompt based on scenario
+        let prompt;
+        if (isFirstTask) {
+            prompt = OpenApiLoader.replaceVariables(template.prompts.firstTask, { firstSubtask });
+        }
+        else if (completedTaskNumber) {
+            if (completedTaskNumber.includes('.')) {
+                prompt = OpenApiLoader.replaceVariables(template.prompts.continueTask, { taskNumber: completedTaskNumber, firstSubtask });
+            }
+            else {
+                prompt = OpenApiLoader.replaceVariables(template.prompts.nextTask, { taskNumber: completedTaskNumber, firstSubtask });
+            }
+        }
+        else {
+            prompt = OpenApiLoader.replaceVariables(template.prompts.batchContinue, { firstSubtask });
+        }
+        parts.push(prompt);
+        return parts.join('\n');
+    }
+    /**
+     * Extract the first uncompleted task with its context using TaskLexer.
+     */
+    static extractFirstUncompletedSubtask(tasksContent) {
+        const tokens = TaskLexer.lex(tasksContent);
+        // Find the first list item that is NOT checked
+        const uncompletedTaskToken = tokens.find(token => token.type === 'list_item' && !token.checked);
+        if (uncompletedTaskToken) {
+            // Clean the text to return only the task description
+            return uncompletedTaskToken.text.replace(/\[\s?\]\s*/, '').trim();
+        }
+        return 'Next task';
+    }
+    /**
+     * Get formatted completion message.
+     */
+    static getCompletionMessage(type, taskNumber) {
+        const template = this.template;
+        if (!template) {
+            throw new Error('Failed to load task guidance template from OpenAPI specification');
+        }
+        const message = template.completionMessages[type];
+        if (taskNumber && message.includes('${taskNumber}')) {
+            return OpenApiLoader.replaceVariables(message, { taskNumber });
+        }
+        return message;
+    }
+}
+//# sourceMappingURL=taskGuidancePresenter.js.map

package/dist/features/task/taskGuidancePresenter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskGuidancePresenter.js","sourceRoot":"","sources":["../../../src/features/task/taskGuidancePresenter.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-spec-cli",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "MCP server for managing spec workflow (requirements, design, implementation)",
   "type": "module",
   "main": "dist/index.js",