@voxos-ai/clink-mcp-server 0.4.0

package/dist/tools/complete_checkpoint.d.ts

@@ -0,0 +1,33 @@
+/**
+ * complete_checkpoint tool - Mark a checkpoint as completed
+ */
+export declare const definition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            milestone_id: {
+                type: string;
+                description: string;
+            };
+            order: {
+                type: string;
+                description: string;
+            };
+            hil_expiry_seconds: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+interface CompleteCheckpointArgs {
+    milestone_id: string;
+    order: number;
+    hil_expiry_seconds?: number;
+}
+export declare function handler(args: CompleteCheckpointArgs): Promise<string>;
+export {};
+//# sourceMappingURL=complete_checkpoint.d.ts.map

package/dist/tools/complete_checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"complete_checkpoint.d.ts","sourceRoot":"","sources":["../../src/tools/complete_checkpoint.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;CAqBtB,CAAC;AAEF,UAAU,sBAAsB;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsH3E"}

package/dist/tools/complete_checkpoint.js

@@ -0,0 +1,143 @@
+/**
+ * complete_checkpoint tool - Mark a checkpoint as completed
+ */
+import { completeCheckpoint } from '../client.js';
+import { ClinkApiError, isHILRequired } from '../types.js';
+export const definition = {
+    name: 'complete_checkpoint',
+    description: 'Mark a milestone checkpoint as completed. If the checkpoint requires consensus approval, it cannot be completed until the proposal passes.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            milestone_id: {
+                type: 'string',
+                description: 'The milestone ID',
+            },
+            order: {
+                type: 'number',
+                description: 'The checkpoint order number (1-based)',
+            },
+            hil_expiry_seconds: {
+                type: 'number',
+                description: 'Optional: Custom expiry time for HIL verification email link in seconds (min 60, max 172800 = 48 hours). Default is 300 (5 minutes).',
+            },
+        },
+        required: ['milestone_id', 'order'],
+    },
+};
+export async function handler(args) {
+    try {
+        const { milestone_id, order, hil_expiry_seconds } = args;
+        if (!milestone_id) {
+            return 'Please provide a milestone_id.';
+        }
+        if (!order || order < 1) {
+            return 'Please provide a valid checkpoint order (1 or greater).';
+        }
+        const response = await completeCheckpoint(milestone_id, order, hil_expiry_seconds);
+        // Check if HIL verification is required
+        if (isHILRequired(response)) {
+            const isPending = response.verification_status === 'pending';
+            const wasExpired = response.previous_verification_expired;
+            let output;
+            if (isPending) {
+                // Existing verification already in progress
+                output = `⏳ Human-in-the-Loop verification already pending.\n\n`;
+                output += `A verification email was already sent and is awaiting human approval.\n`;
+                output += `No new email was sent.\n\n`;
+                output += `Verification ID: ${response.verification_id}\n`;
+                if (response.expires_at) {
+                    output += `Expires at: ${new Date(response.expires_at).toLocaleString()}\n`;
+                }
+            }
+            else if (wasExpired) {
+                // Previous verification expired, new one sent
+                output = `⏳ Previous verification expired - new email sent.\n\n`;
+                output += `The previous verification link expired without being used.\n`;
+                output += `A new verification email has been sent to the designated approver.\n\n`;
+                output += `Verification ID: ${response.verification_id}\n`;
+                if (response.expires_in_seconds) {
+                    output += `Expires in: ${Math.floor(response.expires_in_seconds / 60)} minutes\n`;
+                }
+                if (response.sent_to && response.sent_to.length > 0) {
+                    output += `Email sent to: ${response.sent_to.join(', ')}\n`;
+                }
+            }
+            else {
+                // New verification created
+                output = `⏳ Human-in-the-Loop verification required.\n\n`;
+                output += `A verification email has been sent to the designated approver.\n`;
+                output += `The checkpoint will be marked complete once they verify via the email link.\n\n`;
+                output += `Verification ID: ${response.verification_id}\n`;
+                if (response.expires_in_seconds) {
+                    output += `Expires in: ${Math.floor(response.expires_in_seconds / 60)} minutes\n`;
+                }
+                if (response.sent_to && response.sent_to.length > 0) {
+                    output += `Email sent to: ${response.sent_to.join(', ')}\n`;
+                }
+            }
+            output += `\nUse list_pending_verifications to see all pending HIL verifications.`;
+            return output;
+        }
+        // Normal completion - cast to milestone type
+        const milestone = response;
+        const completedCheckpoint = milestone.checkpoints?.find(cp => cp.order === order);
+        let output = `Checkpoint ${order} completed!\n\n`;
+        output += `Milestone: ${milestone.title}\n`;
+        output += `Progress: ${milestone.progress}\n`;
+        output += `Status: ${milestone.status}\n`;
+        if (completedCheckpoint) {
+            output += `\nCompleted checkpoint: ${completedCheckpoint.title}`;
+            if (completedCheckpoint.git_branch_url)
+                output += `\n  Branch: ${completedCheckpoint.git_branch_url}`;
+            if (completedCheckpoint.git_pr_url)
+                output += `\n  PR: ${completedCheckpoint.git_pr_url}`;
+            if (completedCheckpoint.git_commit_url)
+                output += `\n  Commit: ${completedCheckpoint.git_commit_url}`;
+        }
+        if (milestone.status === 'closed') {
+            output += '\n\nAll checkpoints completed! Milestone is now closed.';
+        }
+        else {
+            const remaining = (milestone.checkpoints || []).filter(cp => cp.status === 'pending');
+            if (remaining.length > 0) {
+                output += `\n\nRemaining checkpoints:\n`;
+                for (const cp of remaining) {
+                    const blockers = [];
+                    if (cp.requires_proposal_id && cp.proposal_status !== 'approved') {
+                        blockers.push('waiting for consensus');
+                    }
+                    if (cp.depends_on && cp.depends_on.length > 0) {
+                        const unmetDeps = cp.depends_on.filter(depOrder => {
+                            const depCp = milestone.checkpoints?.find(c => c.order === depOrder);
+                            return depCp?.status !== 'completed';
+                        });
+                        if (unmetDeps.length > 0) {
+                            blockers.push(`depends on: ${unmetDeps.join(', ')}`);
+                        }
+                    }
+                    const suffix = blockers.length > 0 ? ` [${blockers.join('; ')}]` : '';
+                    output += `  ${cp.order}. ${cp.title}${suffix}\n`;
+                }
+            }
+        }
+        return output;
+    }
+    catch (error) {
+        if (error instanceof ClinkApiError) {
+            // Handle specific error cases
+            if (error.statusCode === 409) {
+                return `Error: This checkpoint has already been completed.`;
+            }
+            if (error.statusCode === 403 && error.message.includes('consensus')) {
+                return `Error: This checkpoint requires consensus approval before it can be completed. Vote on the associated proposal first.`;
+            }
+            if (error.statusCode === 403 && error.message.includes('depends on')) {
+                return `Error: ${error.message}. Complete the required checkpoint first.`;
+            }
+            return `Error: ${error.message}`;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=complete_checkpoint.js.map

package/dist/tools/complete_checkpoint.js.map

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

package/dist/tools/complete_clink.d.ts

@@ -0,0 +1,28 @@
+/**
+ * complete_clink tool - Mark a claimed clink as completed
+ */
+export declare const definition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            clink_id: {
+                type: string;
+                description: string;
+            };
+            response: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+interface CompleteClinkArgs {
+    clink_id: string;
+    response?: string;
+}
+export declare function handler(args: CompleteClinkArgs): Promise<string>;
+export {};
+//# sourceMappingURL=complete_clink.d.ts.map

package/dist/tools/complete_clink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"complete_clink.d.ts","sourceRoot":"","sources":["../../src/tools/complete_clink.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;CAiBtB,CAAC;AAEF,UAAU,iBAAiB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CA6BtE"}

package/dist/tools/complete_clink.js

@@ -0,0 +1,50 @@
+/**
+ * complete_clink tool - Mark a claimed clink as completed
+ */
+import { completeClink } from '../client.js';
+import { ClinkApiError } from '../types.js';
+export const definition = {
+    name: 'complete_clink',
+    description: 'Mark a claimed clink as completed. You must have claimed the clink first. Optionally send a reply to the original sender.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            clink_id: {
+                type: 'string',
+                description: 'The clink ID to complete',
+            },
+            response: {
+                type: 'string',
+                description: 'Optional reply clink to send to the original sender',
+            },
+        },
+        required: ['clink_id'],
+    },
+};
+export async function handler(args) {
+    try {
+        const { clink_id, response } = args;
+        if (!clink_id) {
+            return 'Please provide a clink_id to complete.';
+        }
+        const result = await completeClink(clink_id, { response });
+        let output = `Clink completed successfully!\n\nClink ID: ${result.clink.clink_id}\nStatus: ${result.clink.status}`;
+        if (result.response_clink_id) {
+            output += `\n\nReply sent (ID: ${result.response_clink_id})`;
+        }
+        return output;
+    }
+    catch (error) {
+        if (error instanceof ClinkApiError) {
+            if (error.statusCode === 403) {
+                return `Cannot complete: This clink is claimed by another user.`;
+            }
+            if (error.statusCode === 400) {
+                return `Cannot complete: ${error.message}. Make sure you have claimed the clink first.`;
+            }
+            return `Error: ${error.message}`;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=complete_clink.js.map

package/dist/tools/complete_clink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"complete_clink.js","sourceRoot":"","sources":["../../src/tools/complete_clink.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,2HAA2H;IACxI,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0BAA0B;aACxC;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qDAAqD;aACnE;SACF;QACD,QAAQ,EAAE,CAAC,UAAU,CAAC;KACvB;CACF,CAAC;AAOF,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAuB;IACnD,IAAI,CAAC;QACH,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAEpC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,wCAAwC,CAAC;QAClD,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QAE3D,IAAI,MAAM,GAAG,8CAA8C,MAAM,CAAC,KAAK,CAAC,QAAQ,aAAa,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAEnH,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;YAC7B,MAAM,IAAI,uBAAuB,MAAM,CAAC,iBAAiB,GAAG,CAAC;QAC/D,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;YACnC,IAAI,KAAK,CAAC,UAAU,KAAK,GAAG,EAAE,CAAC;gBAC7B,OAAO,yDAAyD,CAAC;YACnE,CAAC;YACD,IAAI,KAAK,CAAC,UAAU,KAAK,GAAG,EAAE,CAAC;gBAC7B,OAAO,oBAAoB,KAAK,CAAC,OAAO,+CAA+C,CAAC;YAC1F,CAAC;YACD,OAAO,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC;QACnC,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/tools/complete_project.d.ts

@@ -0,0 +1,23 @@
+/**
+ * complete_project tool - Mark a project as completed
+ */
+export declare const definition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            project_id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+interface CompleteProjectArgs {
+    project_id: string;
+}
+export declare function handler(args: CompleteProjectArgs): Promise<string>;
+export {};
+//# sourceMappingURL=complete_project.d.ts.map

package/dist/tools/complete_project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"complete_project.d.ts","sourceRoot":"","sources":["../../src/tools/complete_project.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,eAAO,MAAM,UAAU;;;;;;;;;;;;;CAatB,CAAC;AAEF,UAAU,mBAAmB;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CA0BxE"}

package/dist/tools/complete_project.js

@@ -0,0 +1,44 @@
+/**
+ * complete_project tool - Mark a project as completed
+ */
+import { completeProject } from '../client.js';
+import { ClinkApiError } from '../types.js';
+export const definition = {
+    name: 'complete_project',
+    description: 'Mark a project as completed. Completed projects remain visible but indicate all work is done.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            project_id: {
+                type: 'string',
+                description: 'The project ID',
+            },
+        },
+        required: ['project_id'],
+    },
+};
+export async function handler(args) {
+    try {
+        const { project_id } = args;
+        if (!project_id) {
+            return 'Please provide a project_id.';
+        }
+        const project = await completeProject(project_id);
+        let output = `Project marked as completed!\n\n`;
+        output += `Title: ${project.title}\n`;
+        output += `ID: ${project.project_id}\n`;
+        output += `Status: ${project.status}\n`;
+        if (project.completed_at) {
+            output += `Completed at: ${new Date(project.completed_at).toLocaleString()}\n`;
+        }
+        output += `\nUse reopen_project to re-open this project if needed.`;
+        return output;
+    }
+    catch (error) {
+        if (error instanceof ClinkApiError) {
+            return `Error: ${error.message}`;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=complete_project.js.map

package/dist/tools/complete_project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"complete_project.js","sourceRoot":"","sources":["../../src/tools/complete_project.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,+FAA+F;IAC5G,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gBAAgB;aAC9B;SACF;QACD,QAAQ,EAAE,CAAC,YAAY,CAAC;KACzB;CACF,CAAC;AAMF,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAyB;IACrD,IAAI,CAAC;QACH,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;QAE5B,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,8BAA8B,CAAC;QACxC,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC;QAElD,IAAI,MAAM,GAAG,kCAAkC,CAAC;QAChD,MAAM,IAAI,UAAU,OAAO,CAAC,KAAK,IAAI,CAAC;QACtC,MAAM,IAAI,OAAO,OAAO,CAAC,UAAU,IAAI,CAAC;QACxC,MAAM,IAAI,WAAW,OAAO,CAAC,MAAM,IAAI,CAAC;QACxC,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YACzB,MAAM,IAAI,iBAAiB,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,cAAc,EAAE,IAAI,CAAC;QACjF,CAAC;QACD,MAAM,IAAI,yDAAyD,CAAC;QAEpE,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;YACnC,OAAO,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC;QACnC,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/tools/create_milestone.d.ts

@@ -0,0 +1,91 @@
+/**
+ * create_milestone tool - Create a milestone with checkpoints
+ */
+export declare const definition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            group: {
+                type: string;
+                description: string;
+            };
+            title: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            project_id: {
+                type: string;
+                description: string;
+            };
+            checkpoints: {
+                type: string;
+                description: string;
+                items: {
+                    type: string;
+                    properties: {
+                        title: {
+                            type: string;
+                            description: string;
+                        };
+                        description: {
+                            type: string;
+                            description: string;
+                        };
+                        requires_consensus: {
+                            type: string;
+                            description: string;
+                        };
+                        depends_on: {
+                            type: string;
+                            items: {
+                                oneOf: {
+                                    type: string;
+                                }[];
+                            };
+                            description: string;
+                        };
+                        git_branch_url: {
+                            type: string;
+                            description: string;
+                        };
+                        git_pr_url: {
+                            type: string;
+                            description: string;
+                        };
+                        git_commit_url: {
+                            type: string;
+                            description: string;
+                        };
+                    };
+                    required: string[];
+                };
+            };
+        };
+        required: string[];
+    };
+};
+interface CheckpointInput {
+    title: string;
+    description?: string;
+    requires_consensus?: boolean;
+    depends_on?: (number | string)[];
+    git_branch_url?: string;
+    git_pr_url?: string;
+    git_commit_url?: string;
+}
+interface CreateMilestoneArgs {
+    group: string;
+    title: string;
+    description?: string;
+    project_id?: string;
+    checkpoints: CheckpointInput[];
+}
+export declare function handler(args: CreateMilestoneArgs): Promise<string>;
+export {};
+//# sourceMappingURL=create_milestone.d.ts.map

package/dist/tools/create_milestone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create_milestone.d.ts","sourceRoot":"","sources":["../../src/tools/create_milestone.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8CtB,CAAC;AAEF,UAAU,eAAe;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,UAAU,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,UAAU,mBAAmB;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,eAAe,EAAE,CAAC;CAChC;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CA+DxE"}

package/dist/tools/create_milestone.js

@@ -0,0 +1,114 @@
+/**
+ * create_milestone tool - Create a milestone with checkpoints
+ */
+import { createMilestone, listGroups, resolveGroup } from '../client.js';
+import { ClinkApiError } from '../types.js';
+export const definition = {
+    name: 'create_milestone',
+    description: 'Create a milestone with checkpoints to track multi-step collaborative tasks. Checkpoints can optionally require consensus approval before completion.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            group: {
+                type: 'string',
+                description: 'The group slug (e.g., "backend-team") or group ID',
+            },
+            title: {
+                type: 'string',
+                description: 'Milestone title',
+            },
+            description: {
+                type: 'string',
+                description: 'Milestone description (optional)',
+            },
+            project_id: {
+                type: 'string',
+                description: 'Project ID to assign this milestone to (optional). If not provided, uses the group\'s default "General" project.',
+            },
+            checkpoints: {
+                type: 'array',
+                description: 'List of checkpoints. Each checkpoint has: title (required), description, requires_consensus, depends_on, git_branch_url, git_pr_url, git_commit_url (all optional)',
+                items: {
+                    type: 'object',
+                    properties: {
+                        title: { type: 'string', description: 'Checkpoint title' },
+                        description: { type: 'string', description: 'Checkpoint description' },
+                        requires_consensus: { type: 'boolean', description: 'If true, requires group vote before completion' },
+                        depends_on: {
+                            type: 'array',
+                            items: { oneOf: [{ type: 'number' }, { type: 'string' }] },
+                            description: 'Dependencies. Use number for same-milestone (e.g., 1), or "milestone_id:order" for cross-milestone (e.g., "ms_abc123:4"). Same-milestone deps must reference earlier checkpoints.',
+                        },
+                        git_branch_url: { type: 'string', description: 'Git branch URL (full URL, e.g., https://github.com/org/repo/tree/feature/auth)' },
+                        git_pr_url: { type: 'string', description: 'Git pull request URL (full URL, e.g., https://github.com/org/repo/pull/123)' },
+                        git_commit_url: { type: 'string', description: 'Git commit URL (full URL, e.g., https://github.com/org/repo/commit/abc123)' },
+                    },
+                    required: ['title'],
+                },
+            },
+        },
+        required: ['group', 'title', 'checkpoints'],
+    },
+};
+export async function handler(args) {
+    try {
+        const { group, title, description, project_id, checkpoints } = args;
+        if (!group) {
+            const groups = await listGroups();
+            if (groups.length > 0) {
+                const groupList = groups.map((g) => `• ${g.slug} - "${g.name}"`).join('\n');
+                return `Please provide a group slug. Your groups:\n\n${groupList}`;
+            }
+            return 'Please provide a group slug. You are not a member of any groups.';
+        }
+        if (!title) {
+            return 'Please provide a milestone title.';
+        }
+        if (!checkpoints || checkpoints.length === 0) {
+            return 'Please provide at least one checkpoint.';
+        }
+        if (checkpoints.length > 50) {
+            return 'Maximum 50 checkpoints per milestone.';
+        }
+        // Resolve slug or ID to group ID
+        const groupId = await resolveGroup(group);
+        const milestone = await createMilestone(groupId, {
+            title,
+            description,
+            project_id,
+            checkpoints,
+        });
+        let output = `Milestone created successfully!\n\n`;
+        output += `Title: ${milestone.title}\n`;
+        output += `ID: ${milestone.milestone_id}\n`;
+        if (milestone.project_id) {
+            output += `Project ID: ${milestone.project_id}\n`;
+        }
+        output += `Status: ${milestone.status}\n`;
+        output += `Progress: ${milestone.progress}\n\n`;
+        output += `Checkpoints:\n`;
+        for (const cp of milestone.checkpoints || []) {
+            let annotations = [];
+            if (cp.requires_proposal_id)
+                annotations.push('requires consensus');
+            if (cp.depends_on && cp.depends_on.length > 0)
+                annotations.push(`depends on: ${cp.depends_on.join(', ')}`);
+            const annotationStr = annotations.length > 0 ? ` [${annotations.join('; ')}]` : '';
+            output += `  ${cp.order}. ${cp.title}${annotationStr} - ${cp.status}\n`;
+            if (cp.git_branch_url)
+                output += `     Branch: ${cp.git_branch_url}\n`;
+            if (cp.git_pr_url)
+                output += `     PR: ${cp.git_pr_url}\n`;
+            if (cp.git_commit_url)
+                output += `     Commit: ${cp.git_commit_url}\n`;
+        }
+        return output;
+    }
+    catch (error) {
+        if (error instanceof ClinkApiError) {
+            return `Error: ${error.message}`;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=create_milestone.js.map

package/dist/tools/create_milestone.js.map

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

package/dist/tools/create_project.d.ts

@@ -0,0 +1,43 @@
+/**
+ * create_project tool - Create a project in a group
+ */
+export declare const definition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            group: {
+                type: string;
+                description: string;
+            };
+            title: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            slug: {
+                type: string;
+                description: string;
+            };
+            color: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+interface CreateProjectArgs {
+    group: string;
+    title: string;
+    description?: string;
+    slug?: string;
+    color?: string;
+}
+export declare function handler(args: CreateProjectArgs): Promise<string>;
+export {};
+//# sourceMappingURL=create_project.d.ts.map

package/dist/tools/create_project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create_project.d.ts","sourceRoot":"","sources":["../../src/tools/create_project.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BtB,CAAC;AAEF,UAAU,iBAAiB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CA6CtE"}