contribbot-mcp 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,219 @@
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+//#region src/core/enums.d.ts
+declare const TodoStatus: {
+  readonly Idea: "idea";
+  readonly Backlog: "backlog";
+  readonly Active: "active";
+  readonly PrSubmitted: "pr_submitted";
+  readonly Done: "done";
+};
+type TodoStatus = typeof TodoStatus[keyof typeof TodoStatus];
+declare const TODO_STATUSES: [TodoStatus, ...TodoStatus[]];
+declare const TodoType: {
+  readonly Bug: "bug";
+  readonly Feature: "feature";
+  readonly Docs: "docs";
+  readonly Chore: "chore";
+};
+type TodoType = typeof TodoType[keyof typeof TodoType];
+declare const TODO_TYPES: [TodoType, ...TodoType[]];
+declare const TodoDifficulty: {
+  readonly Easy: "easy";
+  readonly Medium: "medium";
+  readonly Hard: "hard";
+};
+type TodoDifficulty = typeof TodoDifficulty[keyof typeof TodoDifficulty];
+declare const TODO_DIFFICULTIES: [TodoDifficulty, ...TodoDifficulty[]];
+declare const UpstreamItemStatus: {
+  readonly Active: "active";
+  readonly PrSubmitted: "pr_submitted";
+  readonly Done: "done";
+};
+type UpstreamItemStatus = typeof UpstreamItemStatus[keyof typeof UpstreamItemStatus];
+declare const UPSTREAM_ITEM_STATUSES: [UpstreamItemStatus, ...UpstreamItemStatus[]];
+declare const UpstreamVersionStatus: {
+  readonly Active: "active";
+  readonly Done: "done";
+};
+type UpstreamVersionStatus = typeof UpstreamVersionStatus[keyof typeof UpstreamVersionStatus];
+declare const DailyCommitAction: {
+  readonly Skip: "skip";
+  readonly Todo: "todo";
+  readonly Issue: "issue";
+  readonly Pr: "pr";
+  readonly Synced: "synced";
+};
+type DailyCommitAction = typeof DailyCommitAction[keyof typeof DailyCommitAction];
+declare const DAILY_COMMIT_ACTIONS: [DailyCommitAction, ...DailyCommitAction[]];
+declare const RepoRole: {
+  readonly Admin: "admin";
+  readonly Maintain: "maintain";
+  readonly Write: "write";
+  readonly Triage: "triage";
+  readonly Read: "read";
+};
+type RepoRole = typeof RepoRole[keyof typeof RepoRole];
+declare const PRType: {
+  readonly Feat: "feat";
+  readonly Fix: "fix";
+  readonly Other: "other";
+};
+type PRType = typeof PRType[keyof typeof PRType];
+//#endregion
+//#region src/core/tools/issue-detail.d.ts
+declare function issueDetail(issueNumber: number, repo?: string): Promise<string>;
+//#endregion
+//#region src/core/tools/pr-summary.d.ts
+declare function prSummary(prNumber: number, repo?: string): Promise<string>;
+//#endregion
+//#region src/core/tools/project-dashboard.d.ts
+declare function projectDashboard(repo?: string): Promise<string>;
+//#endregion
+//#region src/core/tools/upstream-sync-check.d.ts
+declare function upstreamSyncCheck(version?: string, upstreamRepo?: string, targetRepo?: string, save?: boolean, targetBranch?: string): Promise<string>;
+declare function syncHistory(targetRepo?: string): Promise<string>;
+//#endregion
+//#region src/core/tools/todos.d.ts
+declare function todoList(repo?: string, status?: string): Promise<string>;
+declare function todoAdd(text: string, ref?: string, repo?: string): Promise<string>;
+declare function todoDelete(indexOrText: string, repo?: string): Promise<string>;
+declare function todoDone(indexOrText: string, repo?: string): Promise<string>;
+declare function todoArchive(repo?: string): Promise<string>;
+//#endregion
+//#region src/core/tools/todo-activate.d.ts
+declare function todoActivate(item: string, repo?: string): Promise<string>;
+//#endregion
+//#region src/core/tools/todo-detail.d.ts
+declare function todoDetail(item: string, repo?: string): Promise<string>;
+//#endregion
+//#region src/core/tools/todo-update.d.ts
+declare function todoUpdate(item: string, fields: {
+  status?: string;
+  pr?: number;
+  branch?: string;
+  note?: string;
+}, repo?: string): Promise<string>;
+//#endregion
+//#region src/core/tools/comment-create.d.ts
+declare function commentCreate(number: number, body: string, repo?: string): Promise<string>;
+//#endregion
+//#region src/core/tools/issue-close.d.ts
+declare function issueClose(issueNumber: number, comment?: string, todoItem?: string, repo?: string): Promise<string>;
+//#endregion
+//#region src/core/tools/issue-create.d.ts
+declare function issueCreate(title: string, body?: string, labels?: string, upstreamSha?: string, upstreamRepo?: string, autoTodo?: boolean, repo?: string): Promise<string>;
+//#endregion
+//#region src/core/tools/pr-update.d.ts
+declare function prUpdate(prNumber: number, fields: {
+  title?: string;
+  body?: string;
+  state?: string;
+  draft?: boolean;
+}, repo?: string): Promise<string>;
+//#endregion
+//#region src/core/tools/pr-create.d.ts
+declare function prCreate(title: string, head?: string, base?: string, body?: string, draft?: boolean, todoItem?: string, repo?: string): Promise<string>;
+//#endregion
+//#region src/core/tools/pr-review-comments.d.ts
+declare function prReviewComments(prNumber: number, repo?: string): Promise<string>;
+//#endregion
+//#region src/core/tools/pr-review-reply.d.ts
+declare function prReviewReply(prNumber: number, commentId: number, body: string, repo?: string): Promise<string>;
+//#endregion
+//#region src/core/tools/upstream-manage.d.ts
+declare function upstreamList(repo?: string, upstreamRepo?: string): Promise<string>;
+declare function upstreamDetail(upstreamRepo: string, version: string, repo?: string): Promise<string>;
+declare function upstreamUpdate(upstreamRepo: string, version: string, itemIndex: number, fields: {
+  status?: string;
+  pr?: number;
+  difficulty?: string;
+}, repo?: string): Promise<string>;
+//#endregion
+//#region src/core/tools/upstream-daily.d.ts
+declare function upstreamDaily(upstreamRepo: string, repo?: string, sinceTag?: string): Promise<string>;
+declare function upstreamDailyAct(upstreamRepo: string, sha: string, action: string, ref?: string, repo?: string): Promise<string>;
+/**
+ * Batch skip all commits that are suggested as noise.
+ */
+declare function upstreamDailySkipNoise(upstreamRepo: string, repo?: string): Promise<string>;
+//#endregion
+//#region src/core/tools/project-list.d.ts
+declare function projectList(): string;
+//#endregion
+//#region src/core/tools/contribution-stats.d.ts
+declare function contributionStats(days?: number, author?: string, repo?: string): Promise<string>;
+//#endregion
+//#region src/core/tools/issue-list.d.ts
+declare function issueList(repo?: string, state?: string, labels?: string, query?: string): Promise<string>;
+declare function prList(repo?: string, state?: string, query?: string): Promise<string>;
+//#endregion
+//#region src/core/storage/repo-config.d.ts
+interface RepoConfigData {
+  role: RepoRole;
+  org: string | null;
+  fork: string | null;
+  upstream: string | null;
+}
+/**
+ * ProjectMode — 项目的上下游对齐关系，和 role（权限）正交。
+ * 由 config.yaml 的 fork + upstream 字段自动推断。
+ */
+type ProjectMode = 'none' | 'fork' | 'upstream' | 'fork+upstream';
+declare function inferMode(config: RepoConfigData): ProjectMode;
+//#endregion
+//#region src/core/tools/repo-config-tool.d.ts
+/**
+ * View or update repo config.
+ */
+declare function repoConfig(repo?: string, upstream?: string): Promise<string>;
+//#endregion
+//#region src/core/tools/skills.d.ts
+declare function skillList(repo?: string): Promise<string>;
+declare function skillRead(skillName: string, repo?: string): Promise<string>;
+declare function skillWrite(skillName: string, content: string, repo?: string): Promise<string>;
+//#endregion
+//#region src/core/tools/skill-resources.d.ts
+interface SkillEntry {
+  repo: string;
+  name: string;
+  description: string;
+}
+declare function listAllSkills(): SkillEntry[];
+declare function readSkill(repo: string, skillName: string): string | null;
+//#endregion
+//#region src/core/utils/fs.d.ts
+declare function safeWriteFileSync(filePath: string, content: string): void;
+//#endregion
+//#region src/core/utils/resolve-repo.d.ts
+/**
+ * If the given repo is a fork, resolve to its parent repo.
+ * This ensures data is always stored under the upstream/parent owner.
+ */
+declare function resolveToParent(owner: string, name: string): Promise<{
+  owner: string;
+  name: string;
+  fork: string | null;
+}>;
+/**
+ * Resolve a repo string to the canonical owner/name for data storage.
+ *
+ * Resolution order (fast to slow):
+ * 1. In-memory cache hit
+ * 2. Config already exists at the given owner/name path (it IS the parent)
+ * 3. Scan existing configs to find one that lists this repo as its fork
+ * 4. GitHub API call to check if it's a fork and resolve to parent
+ *
+ * This ensures all data for a project lives in ONE directory,
+ * regardless of whether the user passes their fork name or the parent name.
+ */
+declare function resolveRepo(repo?: string): Promise<{
+  owner: string;
+  name: string;
+}>;
+//#endregion
+//#region src/mcp/server.d.ts
+declare function createServer(): McpServer;
+//#endregion
+export { DAILY_COMMIT_ACTIONS, DailyCommitAction, PRType, type ProjectMode, type RepoRole, TODO_DIFFICULTIES, TODO_STATUSES, TODO_TYPES, TodoDifficulty, TodoStatus, TodoType, UPSTREAM_ITEM_STATUSES, UpstreamItemStatus, UpstreamVersionStatus, commentCreate, contributionStats, createServer, inferMode, issueClose, issueCreate, issueDetail, issueList, listAllSkills, prCreate, prList, prReviewComments, prReviewReply, prSummary, prUpdate, projectDashboard, projectList, readSkill, repoConfig, resolveRepo, resolveToParent, safeWriteFileSync, skillList, skillRead, skillWrite, syncHistory, todoActivate, todoAdd, todoArchive, todoDelete, todoDetail, todoDone, todoList, todoUpdate, upstreamDaily, upstreamDailyAct, upstreamDailySkipNoise, upstreamDetail, upstreamList, upstreamSyncCheck, upstreamUpdate };

package/dist/index.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { A as todoList, B as DAILY_COMMIT_ACTIONS, C as todoUpdate, D as todoArchive, E as todoAdd, F as projectDashboard, G as TODO_STATUSES, H as PRType, I as listAllSkills, J as TodoStatus, K as TODO_TYPES, L as readSkill, M as upstreamSyncCheck, N as resolveRepo, O as todoDelete, P as resolveToParent, Q as UpstreamVersionStatus, R as prSummary, S as commentCreate, T as todoActivate, U as RepoRole, V as DailyCommitAction, W as TODO_DIFFICULTIES, X as UPSTREAM_ITEM_STATUSES, Y as TodoType, Z as UpstreamItemStatus, _ as prReviewComments, a as repoConfig, b as issueCreate, c as contributionStats, d as upstreamDailyAct, f as upstreamDailySkipNoise, g as prReviewReply, h as upstreamUpdate, i as skillWrite, j as syncHistory, k as todoDone, l as projectList, m as upstreamList, n as skillList, o as issueList, p as upstreamDetail, q as TodoDifficulty, r as skillRead, s as prList, t as createServer, u as upstreamDaily, v as prCreate, w as todoDetail, x as issueClose, y as prUpdate, z as issueDetail } from "./server-BUY4k2DS.js";
+import { n as inferMode, r as safeWriteFileSync } from "./repo-config-D-7B7yP_.js";
+
+export { DAILY_COMMIT_ACTIONS, DailyCommitAction, PRType, RepoRole, TODO_DIFFICULTIES, TODO_STATUSES, TODO_TYPES, TodoDifficulty, TodoStatus, TodoType, UPSTREAM_ITEM_STATUSES, UpstreamItemStatus, UpstreamVersionStatus, commentCreate, contributionStats, createServer, inferMode, issueClose, issueCreate, issueDetail, issueList, listAllSkills, prCreate, prList, prReviewComments, prReviewReply, prSummary, prUpdate, projectDashboard, projectList, readSkill, repoConfig, resolveRepo, resolveToParent, safeWriteFileSync, skillList, skillRead, skillWrite, syncHistory, todoActivate, todoAdd, todoArchive, todoDelete, todoDetail, todoDone, todoList, todoUpdate, upstreamDaily, upstreamDailyAct, upstreamDailySkipNoise, upstreamDetail, upstreamList, upstreamSyncCheck, upstreamUpdate };

package/dist/mcp/index.d.ts

@@ -0,0 +1,2 @@
+
+export { };

package/dist/mcp/index.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+import { t as createServer } from "../server-BUY4k2DS.js";
+import "../repo-config-D-7B7yP_.js";
+import { execFileSync } from "node:child_process";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+
+//#region src/mcp/index.ts
+function checkAuth() {
+	if (process.env.GITHUB_TOKEN) return "token";
+	try {
+		execFileSync("gh", ["auth", "status"], { stdio: "ignore" });
+		return "gh-cli";
+	} catch {
+		console.error(`
+[contribbot] GitHub auth not configured. Please set up one of:
+
+  Option A - gh CLI (recommended):
+    gh auth login
+
+  Option B - GitHub Token:
+    Set GITHUB_TOKEN environment variable in .mcp.json:
+    {
+      "mcpServers": {
+        "contribbot": {
+          "command": "npx",
+          "args": ["tsx", "packages/contribbot/src/mcp/index.ts"],
+          "env": { "GITHUB_TOKEN": "<your-token>" }
+        }
+      }
+    }
+`);
+		process.exit(1);
+	}
+}
+async function main() {
+	const authMode = checkAuth();
+	const server = createServer();
+	const transport = new StdioServerTransport();
+	await server.connect(transport);
+	console.error(`contribbot MCP server running (auth: ${authMode})`);
+}
+main().catch((error) => {
+	console.error("Fatal error:", error);
+	process.exit(1);
+});
+
+//#endregion
+export {  };

package/dist/repo-config-C0SUu1Lx.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { n as inferMode, t as RepoConfig } from "./repo-config-D-7B7yP_.js";
+
+export { RepoConfig };

package/dist/repo-config-D-7B7yP_.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { parse, stringify } from "yaml";
+
+//#region src/core/utils/fs.ts
+function safeWriteFileSync(filePath, content) {
+	const tmp = `${filePath}.tmp`;
+	writeFileSync(tmp, content, "utf-8");
+	renameSync(tmp, filePath);
+}
+
+//#endregion
+//#region src/core/storage/repo-config.ts
+function inferMode(config) {
+	const hasFork = config.fork !== null;
+	const hasUpstream = config.upstream !== null;
+	if (hasFork && hasUpstream) return "fork+upstream";
+	if (hasFork) return "fork";
+	if (hasUpstream) return "upstream";
+	return "none";
+}
+var RepoConfig = class {
+	configPath;
+	constructor(baseDir) {
+		this.baseDir = baseDir;
+		this.configPath = join(baseDir, "config.yaml");
+	}
+	exists() {
+		return existsSync(this.configPath);
+	}
+	load() {
+		if (!this.exists()) return null;
+		return parse(readFileSync(this.configPath, "utf-8")) ?? null;
+	}
+	save(config) {
+		if (!existsSync(this.baseDir)) mkdirSync(this.baseDir, { recursive: true });
+		safeWriteFileSync(this.configPath, stringify(config));
+	}
+	update(fields) {
+		const config = this.load();
+		if (!config) return null;
+		if (fields.role !== void 0) config.role = fields.role;
+		if (fields.org !== void 0) config.org = fields.org;
+		if (fields.fork !== void 0) config.fork = fields.fork;
+		if (fields.upstream !== void 0) config.upstream = fields.upstream;
+		this.save(config);
+		return config;
+	}
+};
+
+//#endregion
+export { inferMode as n, safeWriteFileSync as r, RepoConfig as t };