@opengsd/gsd-pi 1.8.1 → 1.9.0-dev.97ef11e3

package/packages/mcp-server/dist/workflow-tools.js

@@ -216,6 +216,8 @@ function isWorkflowToolExecutors(value) {
         "executePlanMilestone",
         "executePlanSlice",
         "executeReplanSlice",
+        "executeReplanTask",
+        "executeReworkBriefSave",
         "executeSliceComplete",
         "executeCompleteMilestone",
         "executeValidateMilestone",
@@ -610,6 +612,18 @@ async function handleReplanSlice(projectDir, args) {
     const { projectDir: _projectDir, ...params } = args;
     return adaptExecutorResult(await runSerializedWorkflowOperation(() => executeReplanSlice(params, projectDir)));
 }
+async function handleReplanTask(projectDir, args) {
+    await enforceWorkflowWriteGate("gsd_replan_task", projectDir, args.milestoneId);
+    const { executeReplanTask } = await getWorkflowToolExecutors();
+    const { projectDir: _projectDir, ...params } = args;
+    return adaptExecutorResult(await runSerializedWorkflowOperation(() => executeReplanTask(params, projectDir)));
+}
+async function handleReworkBriefSave(projectDir, args) {
+    await enforceWorkflowWriteGate("gsd_rework_brief_save", projectDir, args.milestoneId);
+    const { executeReworkBriefSave } = await getWorkflowToolExecutors();
+    const { projectDir: _projectDir, ...params } = args;
+    return adaptExecutorResult(await runSerializedWorkflowOperation(() => executeReworkBriefSave(params, projectDir)));
+}
 async function handleCompleteMilestone(projectDir, args) {
     await enforceWorkflowWriteGate("gsd_complete_milestone", projectDir, args.milestoneId);
     const { executeCompleteMilestone } = await getWorkflowToolExecutors();
@@ -1085,6 +1099,40 @@ const replanSliceParams = {
     removedTaskIds: z.array(z.string()).describe("Task IDs to remove from the slice"),
 };
 const replanSliceSchema = z.object(replanSliceParams);
+const replanTaskParams = {
+    projectDir: projectDirParam,
+    milestoneId: nonEmptyString("milestoneId").describe("Milestone ID (e.g. M001)"),
+    sliceId: nonEmptyString("sliceId").describe("Slice ID (e.g. S01)"),
+    taskId: nonEmptyString("taskId").describe("Task ID (e.g. T01)"),
+    title: nonEmptyString("title").describe("Updated task title"),
+    description: nonEmptyString("description").describe("Updated task description incorporating rework scope"),
+    estimate: nonEmptyString("estimate").describe("Updated task estimate"),
+    files: z.array(z.string()).describe("Updated files likely touched"),
+    verify: nonEmptyString("verify").describe("Updated verification command or block"),
+    inputs: z.array(z.string()).describe("Updated input files or references"),
+    expectedOutput: z.array(z.string()).describe("Updated files this task creates or overwrites"),
+    reworkBriefRef: z.string().optional().describe("Rework brief ID/reference that triggered this task replan"),
+};
+const replanTaskSchema = z.object(replanTaskParams);
+const reworkFindingSchema = z.object({
+    findingId: nonEmptyString("findingId"),
+    severity: z.enum(["blocking", "advisory"]),
+    description: nonEmptyString("description"),
+    requiredFix: nonEmptyString("requiredFix"),
+    verificationCommands: z.array(z.string()),
+    status: z.enum(["pending", "resolved", "deferred-with-override"]).optional(),
+    evidence: z.string().optional(),
+    decisionRef: z.string().optional(),
+});
+const reworkBriefSaveParams = {
+    projectDir: projectDirParam,
+    briefId: z.string().optional().describe("Stable brief ID"),
+    milestoneId: nonEmptyString("milestoneId").describe("Milestone ID (e.g. M001)"),
+    sliceId: nonEmptyString("sliceId").describe("Slice ID (e.g. S01)"),
+    taskId: nonEmptyString("taskId").describe("Task ID (e.g. T01)"),
+    findings: z.array(reworkFindingSchema).min(1).describe("Structured rework findings for this task"),
+};
+const reworkBriefSaveSchema = z.object(reworkBriefSaveParams);
 const sliceCompleteParams = {
     projectDir: projectDirParam,
     sliceId: nonEmptyString("sliceId").describe("Slice ID (e.g. S01)"),
@@ -1242,6 +1290,12 @@ const taskCompleteParams = {
         continueWithDefault: z.boolean().describe("When true, the recommendation is recorded as the default, but auto-mode still pauses until the user resolves via /gsd escalate resolve."),
     }).optional().describe("ADR-011 Phase 2: optional escalation payload. Only honored when phases.mid_execution_escalation is true."),
     verificationEvidence: z.array(verificationEvidenceItemSchema).optional().describe("Verification evidence entries"),
+    reworkResolution: z.array(z.object({
+        findingId: nonEmptyString("findingId"),
+        status: z.enum(["resolved", "deferred-with-override"]),
+        evidence: nonEmptyString("evidence"),
+        decisionRef: z.string().optional(),
+    })).optional().describe("Resolution evidence for structured rework findings linked to this task"),
 };
 const taskCompleteSchema = z.object(taskCompleteParams);
 const taskReopenParams = {
@@ -1538,7 +1592,7 @@ export function registerWorkflowTools(realServer, options = {}) {
         const { executePlanSlice } = await getWorkflowToolExecutors();
         return adaptExecutorResult(await runSerializedWorkflowOperation(() => executePlanSlice(params, projectDir)));
     });
-    server.tool("gsd_plan_task", "Write task planning state to the GSD database and render tasks/T##-PLAN.md from DB.", planTaskParams, async (args) => {
+    server.tool("gsd_plan_task", "Write task planning state to the GSD database and render the slice PLAN from DB.", planTaskParams, async (args) => {
         const parsed = parseWorkflowArgs(planTaskSchema, args);
         const { projectDir, ...params } = parsed;
         await enforceWorkflowWriteGate("gsd_plan_task", projectDir, params.milestoneId);
@@ -1553,7 +1607,7 @@ export function registerWorkflowTools(realServer, options = {}) {
             content: [{ type: "text", text: `Planned task ${result.taskId} (${result.sliceId}/${result.milestoneId})` }],
         };
     });
-    server.tool("gsd_task_plan", "Alias for gsd_plan_task. Write task planning state to the GSD database and render tasks/T##-PLAN.md from DB.", planTaskParams, async (args) => {
+    server.tool("gsd_task_plan", "Alias for gsd_plan_task. Write task planning state to the GSD database and render the slice PLAN from DB.", planTaskParams, async (args) => {
         logAliasUsage("gsd_task_plan", "gsd_plan_task");
         const parsed = parseWorkflowArgs(planTaskSchema, args);
         const { projectDir, ...params } = parsed;
@@ -1578,6 +1632,14 @@ export function registerWorkflowTools(realServer, options = {}) {
         const parsed = parseWorkflowArgs(replanSliceSchema, args);
         return handleReplanSlice(parsed.projectDir, parsed);
     });
+    server.tool("gsd_replan_task", "Update one pending task's planning contract after rework without touching sibling tasks.", replanTaskParams, async (args) => {
+        const parsed = parseWorkflowArgs(replanTaskSchema, args);
+        return handleReplanTask(parsed.projectDir, parsed);
+    });
+    server.tool("gsd_rework_brief_save", "Persist a structured task rework brief whose blocking findings gate gsd_task_complete.", reworkBriefSaveParams, async (args) => {
+        const parsed = parseWorkflowArgs(reworkBriefSaveSchema, args);
+        return handleReworkBriefSave(parsed.projectDir, parsed);
+    });
     server.tool("gsd_slice_complete", "Record a completed slice to the GSD database, render SUMMARY.md + UAT.md, and update roadmap projection.", sliceCompleteParams, async (args) => {
         const parsed = parseWorkflowArgs(sliceCompleteSchema, args);
         return handleSliceComplete(parsed.projectDir, parsed);