goalstory_update_step
Update step details such as name, completion status, evidence, and outcomes to track progress and insights effectively within a goal management system.
Instructions
Update step details including the name, completion status, evidence, and outcome. Use this to track progress and insights.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| evidence | No | Concrete proof or observations of step completion. | |
| id | Yes | Unique identifier of the step to update. | |
| name | No | Refined or clarified step description. | |
| outcome | No | Results and impact achieved through completing this step. | |
| status | No | Step completion status: 0 = pending/in progress, 1 = completed. |
Implementation Reference
- src/index.ts:534-560 (handler)MCP server.tool registration and inline handler function that executes the tool logic by making a PATCH request to /steps/{id} with the provided update fields (name, status, outcome, evidence).* Update Step */ server.tool( UPDATE_STEP_TOOL.name, UPDATE_STEP_TOOL.description, UPDATE_STEP_TOOL.inputSchema.shape, async (args) => { const url = `${GOALSTORY_API_BASE_URL}/steps/${args.id}`; const body = { id: args.id, ...(args.name ? { name: args.name } : {}), ...(typeof args.status === "number" ? { status: args.status } : {}), ...(args.outcome ? { outcome: args.outcome } : {}), ...(args.evidence ? { evidence: args.evidence } : {}), }; const result = await doRequest(url, "PATCH", body); return { content: [ { type: "text", text: `Step updated:\n${JSON.stringify(result, null, 2)}`, }, ], isError: false, }; }, );
- src/tools.ts:273-298 (schema)Tool definition object including name, description, and Zod inputSchema for validation.export const UPDATE_STEP_TOOL = { name: "goalstory_update_step", description: "Update step details including the name, completion status, evidence, and outcome. Use this to track progress and insights.", inputSchema: z.object({ id: z.string().describe("Unique identifier of the step to update."), name: z .string() .optional() .describe("Refined or clarified step description."), status: z .number() .optional() .describe( "Step completion status: 0 = pending/in progress, 1 = completed.", ), outcome: z .string() .optional() .describe("Results and impact achieved through completing this step."), evidence: z .string() .optional() .describe("Concrete proof or observations of step completion."), }), };
- src/types.ts:80-87 (schema)TypeScript interface defining the input shape for the goalstory_update_step tool.export interface GoalstoryUpdateStepInput { id: string; name?: string; status?: number; // 0=Pending, 1=Complete outcome?: string; evidence?: string; notes?: string; }