@becklabs/beck-mcp-server 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,281 @@
+export interface User {
+    _id: string;
+    name?: string;
+    email?: string;
+    imageUrl?: string;
+}
+export interface Epic {
+    _id: string;
+    title: string;
+    color?: string;
+}
+export interface AcceptanceCriterion {
+    text: string;
+    completed: boolean;
+}
+export interface RelevantFile {
+    path: string;
+    purpose?: string;
+}
+export interface Task {
+    _id: string;
+    workspaceId: string;
+    epicId?: string;
+    title: string;
+    description?: string;
+    type: "feature" | "bug" | "chore";
+    status: "not_started" | "started" | "ready_for_review" | "completed";
+    points?: number;
+    assigneeId?: string;
+    createdBy: string;
+    createdAt: number;
+    startedAt?: number;
+    completedAt?: number;
+    priority: number;
+    isBlocked?: boolean;
+    blockedReason?: string;
+    isDelivered?: boolean;
+    isIcebox?: boolean;
+    acceptanceCriteria?: AcceptanceCriterion[];
+    tags?: string[];
+    relevantFiles?: RelevantFile[];
+    assignee?: User | null;
+    epic?: Epic | null;
+}
+export interface Comment {
+    _id: string;
+    taskId: string;
+    content: string;
+    authorId: string;
+    authorTokenId?: string;
+    createdAt: number;
+    updatedAt?: number;
+    author?: User | null;
+}
+export interface WorkspaceStats {
+    totalTasks: number;
+    completedTasks: number;
+    inProgressTasks: number;
+    notStartedTasks: number;
+    iceboxTasks: number;
+}
+export interface Workspace {
+    _id: string;
+    name: string;
+    description?: string;
+    clerkOrgId: string;
+    createdBy: string;
+    createdAt: number;
+    stats?: WorkspaceStats;
+}
+export interface ApiResponse<T> {
+    data?: T;
+    error?: string;
+}
+export interface TaskResponse {
+    task: Task;
+}
+export interface TasksResponse {
+    tasks: Task[];
+}
+export interface WorkspacesResponse {
+    workspaces: Workspace[];
+}
+export interface CommentsResponse {
+    comments: Comment[];
+}
+export interface CreateCommentResponse {
+    id: string;
+}
+export interface ProgressUpdate {
+    _id: string;
+    taskId: string;
+    authorId: string;
+    authorTokenId?: string;
+    whatAttempted: string;
+    whatSucceeded?: string;
+    whatFailed?: string;
+    questions?: string[];
+    blockers?: string[];
+    createdAt: number;
+    author?: User | null;
+    token?: {
+        _id: string;
+        name: string;
+    } | null;
+}
+export interface ProgressUpdatesResponse {
+    progressUpdates: ProgressUpdate[];
+}
+export interface CreateProgressUpdateResponse {
+    id: string;
+}
+export interface Document {
+    _id: string;
+    workspaceId: string;
+    path: string;
+    title: string;
+    body: string;
+    etag: string;
+    updatedAt: number;
+    updatedByUser?: {
+        _id: string;
+        name?: string;
+        email?: string;
+    } | null;
+    updatedByToken?: {
+        _id: string;
+        name: string;
+    } | null;
+}
+export interface EpicLastPlan {
+    plannedAt: number;
+    composedSpec?: string;
+    documentIds?: string[];
+    documentEtags?: string[];
+    sourceDocuments?: Array<{
+        _id: string;
+        path: string;
+        title: string;
+        etag: string;
+    }>;
+}
+export interface EpicSummary {
+    _id: string;
+    title: string;
+    description?: string;
+    spec?: string;
+    status: string;
+    color?: string;
+    githubBranch?: string | null;
+    githubPrUrl?: string | null;
+    totalTasks?: number;
+    completedTasks?: number;
+    totalPoints?: number;
+    completedPoints?: number;
+    lastPlan?: EpicLastPlan;
+}
+export interface EpicTaskSummary {
+    _id: string;
+    title: string;
+    status: string;
+    type: string;
+    points?: number;
+    isBlocked?: boolean;
+    assignee?: User | null;
+}
+export interface EpicBreakdownTask {
+    title: string;
+    type: string;
+    points?: number;
+    imported?: boolean;
+}
+export interface EpicDetail extends EpicSummary {
+    workspaceId: string;
+    tasks?: EpicTaskSummary[];
+    aiBreakdowns?: Array<{
+        timestamp: number;
+        taskCount?: number;
+        tasks: EpicBreakdownTask[];
+    }>;
+}
+export interface DocumentVersion {
+    _id: string;
+    title: string;
+    path: string;
+    etag: string;
+    body?: string;
+    createdAt: number;
+    actor?: {
+        _id: string;
+        name?: string;
+        email?: string;
+    } | null;
+    token?: {
+        name: string;
+    } | null;
+}
+export interface Me {
+    id: string;
+    clerkId?: string;
+    email?: string;
+    name?: string;
+}
+export interface TaskContext {
+    task: Task;
+    epic?: {
+        _id: string;
+        title: string;
+        description?: string;
+        spec?: string;
+        status: string;
+        color?: string;
+        lastPlan?: {
+            plannedAt: number;
+            sourceDocuments?: Array<{
+                _id: string;
+                path: string;
+                title: string;
+                etag: string;
+            }>;
+        };
+    } | null;
+    relatedTasks: Array<{
+        _id: string;
+        title: string;
+        status: string;
+        type: string;
+        points?: number;
+        assignee?: {
+            _id: string;
+            name?: string;
+            email?: string;
+        } | null;
+    }>;
+    recentComments: Array<{
+        _id: string;
+        content: string;
+        createdAt: number;
+        author?: {
+            _id: string;
+            name?: string;
+            email?: string;
+        } | null;
+    }>;
+    recentActivity: Array<{
+        _id: string;
+        action: string;
+        oldValue?: string;
+        newValue?: string;
+        reason?: string;
+        createdAt: number;
+        actor?: {
+            _id: string;
+            name?: string;
+            email?: string;
+        } | null;
+    }>;
+    recentProgressUpdates: Array<{
+        _id: string;
+        whatAttempted: string;
+        whatSucceeded?: string;
+        whatFailed?: string;
+        questions?: string[];
+        blockers?: string[];
+        createdAt: number;
+        author?: {
+            _id: string;
+            name?: string;
+            email?: string;
+        } | null;
+    }>;
+}
+export interface TaskRecommendation {
+    task: Task;
+    score: number;
+    reason: string;
+}
+export interface RecommendationsResponse {
+    recommendations: TaskRecommendation[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,3 @@
+// Beck API types
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,iBAAiB"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@becklabs/beck-mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for Beck — documents, Plan it, and task execution for Claude Code",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "beck-mcp": "dist/index.js",
+    "beck-mcp-server": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.9.3"
+  },
+  "keywords": [
+    "mcp",
+    "claude",
+    "beck",
+    "project-management"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/unsugarcoat/beck.git",
+    "directory": "packages/mcp-server"
+  }
+}