glab-agent 0.2.5 → 0.2.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "glab-agent",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "type": "module",
   "description": "Multi-agent GitLab To-Do watcher with YAML-defined agents, skills, and GitLab registry.",
   "license": "MIT",

package/src/local-agent/gitlab-glab-client.ts

@@ -95,6 +95,10 @@ export interface GitlabClient {
   getWikiPage(projectId: number | string, slug: string): Promise<WikiPage>;
   createWikiPage(projectId: number | string, title: string, content: string): Promise<WikiPage>;
   updateWikiPage(projectId: number | string, slug: string, title: string, content: string): Promise<WikiPage>;
+  getProject(projectIdOrPath: number | string): Promise<{ id: number } | undefined>;
+  createProject(name: string, options?: { visibility?: string; initializeWithReadme?: boolean }): Promise<{ id: number }>;
+  getRepositoryFile(projectId: number | string, filePath: string, ref?: string): Promise<{ content: string } | undefined>;
+  createOrUpdateRepositoryFile(projectId: number | string, filePath: string, content: string, commitMessage: string, options?: { create?: boolean }): Promise<void>;
 }
 
 interface GitlabGlabClientOptions {
@@ -693,6 +697,58 @@ export class GitlabGlabClient implements GitlabClient {
     };
   }
 
+  async getProject(projectIdOrPath: number | string): Promise<{ id: number } | undefined> {
+    try {
+      const encoded = typeof projectIdOrPath === "string" ? encodeURIComponent(projectIdOrPath) : projectIdOrPath;
+      const payload = await this.readJson(`projects/${encoded}`);
+      const p = (payload ?? {}) as Payload;
+      const id = Number(p.id);
+      return Number.isNaN(id) ? undefined : { id };
+    } catch {
+      return undefined;
+    }
+  }
+
+  async createProject(name: string, options?: { visibility?: string; initializeWithReadme?: boolean }): Promise<{ id: number }> {
+    const stdout = await this.request("projects", {
+      method: "POST",
+      fields: {
+        name,
+        path: name,
+        visibility: options?.visibility ?? "public",
+        initialize_with_readme: options?.initializeWithReadme ? "true" : "false"
+      }
+    });
+    const payload = JSON.parse(stdout) as Payload;
+    return { id: Number(payload.id) };
+  }
+
+  async getRepositoryFile(projectId: number | string, filePath: string, ref?: string): Promise<{ content: string } | undefined> {
+    try {
+      const encoded = typeof projectId === "string" ? encodeURIComponent(projectId) : projectId;
+      const endpoint = this.withQuery(`projects/${encoded}/repository/files/${encodeURIComponent(filePath)}`, { ref: ref ?? "main" });
+      const payload = await this.readJson(endpoint);
+      const p = (payload ?? {}) as Payload;
+      const content = typeof p.content === "string" ? Buffer.from(p.content, "base64").toString("utf8") : "";
+      return { content };
+    } catch {
+      return undefined;
+    }
+  }
+
+  async createOrUpdateRepositoryFile(projectId: number | string, filePath: string, content: string, commitMessage: string, options?: { create?: boolean }): Promise<void> {
+    const encoded = typeof projectId === "string" ? encodeURIComponent(projectId) : projectId;
+    const method = options?.create ? "POST" : "PUT";
+    await this.request(`projects/${encoded}/repository/files/${encodeURIComponent(filePath)}`, {
+      method,
+      fields: {
+        branch: "main",
+        content,
+        commit_message: commitMessage
+      }
+    });
+  }
+
   /**
    * Direct HTTP call using Node's built-in fetch.
    * Used for endpoints where glab CLI's response parsing has issues (e.g. PUT /user/status).

package/src/local-agent/watcher.ts

@@ -882,6 +882,81 @@ async function publishAgentProfileWiki(
   }
 }
 
+async function publishProfileReadme(
+  config: LocalAgentConfig,
+  dependencies: WatcherDependencies
+): Promise<void> {
+  const logger = dependencies.logger ?? console;
+  const def = config.agentDefinition;
+  const username = config.botUsername;
+  if (!def || !username) return;
+
+  const projectPath = `${username}/${username}`;
+
+  // Build README content
+  const displayName = def.display_name || def.name;
+  const lines: string[] = [
+    `## 👋 Hi, I'm ${displayName}`,
+    "",
+  ];
+
+  if (def.description) {
+    lines.push(def.description, "");
+  }
+
+  const skillNames = def.skill_refs.length > 0 ? def.skill_refs : def.skills.map(s => s.name);
+  if (skillNames.length > 0) {
+    lines.push("### 🛠 Skills", "", ...skillNames.map(s => `- ${s}`), "");
+  }
+
+  if (def.prompt.preamble) {
+    lines.push("### 📋 What I Do", "", def.prompt.preamble.trim(), "");
+  }
+
+  lines.push(
+    "### 💬 How to Use",
+    "",
+    `在任意 issue 或 MR 中评论 \`@${username} <你的需求>\`，我会自动接单处理。`,
+    "",
+    "### 📊 Status",
+    "",
+    `- Provider: \`${def.provider}\``,
+    `- Poll interval: ${def.poll_interval_seconds ?? 30}s`,
+    "",
+    "---",
+    `*Auto-updated by [glab-agent](https://www.npmjs.com/package/glab-agent)*`,
+  );
+
+  const content = lines.join("\n");
+
+  try {
+    // Check if profile project exists
+    let project = await dependencies.gitlabClient.getProject(projectPath);
+
+    if (!project) {
+      // Create profile project
+      project = await dependencies.gitlabClient.createProject(username, {
+        visibility: "public",
+        initializeWithReadme: true
+      });
+      logger.info(`Created profile project: ${projectPath}`);
+    }
+
+    // Update or create README
+    const existing = await dependencies.gitlabClient.getRepositoryFile(project.id, "README.md");
+    await dependencies.gitlabClient.createOrUpdateRepositoryFile(
+      project.id,
+      "README.md",
+      content,
+      "Update profile README",
+      { create: !existing }
+    );
+    logger.info(`Profile README updated: ${projectPath}`);
+  } catch (error) {
+    logger.info?.(`Profile README update skipped: ${String(error).slice(0, 150)}`);
+  }
+}
+
 export async function markAgentOffline(
   _config: LocalAgentConfig,
   gitlabClient: GitlabClient,
@@ -1264,6 +1339,7 @@ export async function main(argv: string[] = process.argv.slice(2)): Promise<void
     // Update GitLab user bio with agent profile (P1: Agent = 员工)
     await updateAgentUserBio(config, dependencies);
     await publishAgentProfileWiki(config, dependencies);
+    await publishProfileReadme(config, dependencies);
     await updateAgentUserStatus(dependencies, "idle", undefined, config);
   } catch (error) {
     logger.error(`Token validation failed for agent "${agentName}": ${String(error)}`);