glab-agent 0.2.4 → 0.2.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "glab-agent",
-  "version": "0.2.4",
+  "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

@@ -91,10 +91,14 @@ export interface GitlabClient {
   updateUserStatus(emoji: string, message: string, availability?: "busy" | "not_set"): Promise<void>;
   updateUserBio(bio: string): Promise<void>;
   listAllPendingTodos(): Promise<GitlabTodoItem[]>;
-  listWikiPages(projectId: number): Promise<WikiPage[]>;
-  getWikiPage(projectId: number, slug: string): Promise<WikiPage>;
-  createWikiPage(projectId: number, title: string, content: string): Promise<WikiPage>;
-  updateWikiPage(projectId: number, slug: string, title: string, content: string): Promise<WikiPage>;
+  listWikiPages(projectId: number | string): Promise<WikiPage[]>;
+  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 {
@@ -632,7 +636,7 @@ export class GitlabGlabClient implements GitlabClient {
       });
   }
 
-  async listWikiPages(projectId: number): Promise<WikiPage[]> {
+  async listWikiPages(projectId: number | string): Promise<WikiPage[]> {
     const endpoint = this.withQuery(`projects/${projectId}/wikis`, { with_content: "0" });
     let payload: unknown;
     try {
@@ -656,7 +660,7 @@ export class GitlabGlabClient implements GitlabClient {
       .filter((w): w is WikiPage => w !== undefined);
   }
 
-  async getWikiPage(projectId: number, slug: string): Promise<WikiPage> {
+  async getWikiPage(projectId: number | string, slug: string): Promise<WikiPage> {
     const payload = await this.readJson(`projects/${projectId}/wikis/${encodeURIComponent(slug)}`);
     const p = (payload ?? {}) as Payload;
     return {
@@ -666,7 +670,7 @@ export class GitlabGlabClient implements GitlabClient {
     };
   }
 
-  async createWikiPage(projectId: number, title: string, content: string): Promise<WikiPage> {
+  async createWikiPage(projectId: number | string, title: string, content: string): Promise<WikiPage> {
     const stdout = await this.request(`projects/${projectId}/wikis`, {
       method: "POST",
       fields: { title, content }
@@ -679,7 +683,7 @@ export class GitlabGlabClient implements GitlabClient {
     };
   }
 
-  async updateWikiPage(projectId: number, slug: string, title: string, content: string): Promise<WikiPage> {
+  async updateWikiPage(projectId: number | string, slug: string, title: string, content: string): Promise<WikiPage> {
     // title must be passed to preserve directory prefix in slug (GitLab API quirk)
     const stdout = await this.request(`projects/${projectId}/wikis/${encodeURIComponent(slug)}`, {
       method: "PUT",
@@ -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

@@ -803,7 +803,22 @@ async function publishAgentProfileWiki(
 ): Promise<void> {
   const logger = dependencies.logger ?? console;
   const def = config.agentDefinition;
-  if (!def || !config.gitlabProjectId) return;
+  if (!def) return;
+
+  // Resolve project identifier: explicit/inferred ID, or encoded path from git remote
+  let projectRef: number | string | undefined = config.gitlabProjectId;
+  if (!projectRef) {
+    const remoteUrl = readOriginRemote(config.agentRepoPath, execFileSync);
+    const remote = remoteUrl ? parseGitRemoteUrl(remoteUrl) : undefined;
+    if (remote) {
+      // GitLab API accepts URL-encoded project path as project ID
+      const projectPath = remote.projectPath.startsWith("git/")
+        ? remote.projectPath.replace(/^git\//, "")
+        : remote.projectPath;
+      projectRef = encodeURIComponent(projectPath);
+    }
+  }
+  if (!projectRef) return;
 
   const agentName = def.name;
   const slug = `agents/${agentName}`;
@@ -854,12 +869,12 @@ async function publishAgentProfileWiki(
   const content = lines.join("\n");
 
   try {
-    const pages = await dependencies.gitlabClient.listWikiPages(config.gitlabProjectId);
+    const pages = await dependencies.gitlabClient.listWikiPages(projectRef);
     const existing = pages.find(p => p.slug === slug || p.slug === `agents-${agentName}`);
     if (existing) {
-      await dependencies.gitlabClient.updateWikiPage(config.gitlabProjectId, existing.slug, slug, content);
+      await dependencies.gitlabClient.updateWikiPage(projectRef, existing.slug, slug, content);
     } else {
-      await dependencies.gitlabClient.createWikiPage(config.gitlabProjectId, slug, content);
+      await dependencies.gitlabClient.createWikiPage(projectRef, slug, content);
     }
     logger.info(`Wiki profile published: agents/${agentName}`);
   } catch (error) {
@@ -867,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,
@@ -1249,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)}`);