glab-agent 0.2.1 → 0.2.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "glab-agent",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "type": "module",
   "description": "Multi-agent GitLab To-Do watcher with YAML-defined agents, skills, and GitLab registry.",
   "license": "MIT",
@@ -31,6 +31,7 @@
     "access": "public"
   },
   "scripts": {
+    "prepare": "git config core.hooksPath scripts/hooks",
     "build": "tsc -p tsconfig.build.json",
     "test": "vitest run",
     "agent": "tsx src/local-agent/cli.ts",

package/src/local-agent/cli.ts

@@ -713,6 +713,41 @@ Do not skip tests or use --no-verify to bypass hooks.
       await writeFile(readmePath, readmeContent, "utf8");
       console.log("Created README.md — product landing page for AI agents.");
     }
+
+    // Auto-run wiki setup if remote and token are available
+    if (remote) {
+      const token = process.env[options?.tokenEnv ?? "GITLAB_TOKEN"];
+      if (token) {
+        console.log("\nPopulating GitLab Wiki with documentation...");
+        try {
+          const client = new GitlabGlabClient({ host: remote.host, token });
+          const { stdout } = await execFileAsync("glab", ["api", `projects/${encodeURIComponent(remote.projectPath)}`], {
+            encoding: "utf8",
+            env: { ...process.env, GITLAB_HOST: remote.host, GITLAB_TOKEN: token }
+          });
+          const projectId = JSON.parse(stdout).id as number;
+          const pages = buildWikiPages(remote.host, remote.projectPath);
+          const existingPages = await client.listWikiPages(projectId);
+          const existingSlugs = new Set(existingPages.map(p => p.slug));
+          let created = 0;
+          let updated = 0;
+          for (const page of pages) {
+            try {
+              if (existingSlugs.has(page.title)) {
+                await client.updateWikiPage(projectId, page.title, page.title, page.content);
+                updated++;
+              } else {
+                await client.createWikiPage(projectId, page.title, page.content);
+                created++;
+              }
+            } catch { /* skip failed pages */ }
+          }
+          console.log(`✅ Wiki: ${created} created, ${updated} updated. ${wikiUrl(remote.host, remote.projectPath, "home")}`);
+        } catch {
+          console.log(`Skipped wiki setup (run 'glab-agent wiki setup' manually after pushing to GitLab).`);
+        }
+      }
+    }
   }
 
   // Also append to README.md for universal AI tool compatibility (non-repo mode)

package/src/local-agent/watcher.ts

@@ -50,6 +50,7 @@ const ACCEPTED_TODO_ACTIONS = new Set(["mentioned", "directly_addressed"]);
 export interface LocalAgentConfig {
   gitlabHost: string;
   gitlabProjectId?: number;
+  gitlabProjectIdExplicit: boolean;  // true when YAML explicitly sets project_id
   gitlabToken: string;
   agentProvider: AgentProvider;
   agentRepoPath: string;
@@ -334,7 +335,7 @@ export async function runWatcherCycle(
 
   await updateAgentUserStatus(dependencies, "idle", undefined, config);
 
-  const todos = config.gitlabProjectId
+  const todos = config.gitlabProjectIdExplicit && config.gitlabProjectId
     ? await dependencies.gitlabClient.listPendingTodos(config.gitlabProjectId)
     : await dependencies.gitlabClient.listAllPendingTodos();
   logger.info(`Polled ${todos.length} pending todo(s).`);
@@ -823,7 +824,7 @@ async function notifyPendingTodosWhileBusy(
   let todos: GitlabTodoItem[];
 
   try {
-    todos = config.gitlabProjectId
+    todos = (config.gitlabProjectIdExplicit && config.gitlabProjectId)
       ? await dependencies.gitlabClient.listMentionedIssueTodos(config.gitlabProjectId)
       : await dependencies.gitlabClient.listAllPendingTodos();
   } catch (error) {
@@ -980,7 +981,8 @@ function createDependencies(config: LocalAgentConfig, logger?: Logger): WatcherD
     stateStore: new FileStateStore(config.statePath),
     worktreeManager: new WorktreeManager({
       repoPath: config.agentRepoPath,
-      worktreeRoot: config.agentWorktreeRoot
+      worktreeRoot: config.agentWorktreeRoot,
+      agentName: config.agentDefinition?.name
     }),
     agentRunner,
     logger
@@ -1039,14 +1041,16 @@ export function loadConfigFromAgentDefinition(
     throw new Error(`gitlab.host is required for agent "${def.name}" or must be inferable from git remote.`);
   }
 
+  const explicitProjectId = def.gitlab.project_id;
   const gitlabProjectId =
-    def.gitlab.project_id ??
+    explicitProjectId ??
     inferGitlabProjectId(gitlabHost, gitlabToken, agentRepoPath, execFileSyncImpl) ??
     undefined;
 
   return {
     gitlabHost,
     gitlabProjectId,
+    gitlabProjectIdExplicit: explicitProjectId != null,
     gitlabToken,
     agentProvider: def.provider,
     agentRepoPath,
@@ -1181,7 +1185,7 @@ export async function main(argv: string[] = process.argv.slice(2)): Promise<void
     process.exit(1);
   }
 
-  logger.info(`Watcher started. mode=${mode} provider=${config.agentProvider} host=${config.gitlabHost}${config.gitlabProjectId ? ` project=${config.gitlabProjectId}` : " project=auto (from todos)"}`);
+  logger.info(`Watcher started. mode=${mode} provider=${config.agentProvider} host=${config.gitlabHost}${config.gitlabProjectId ? ` project=${config.gitlabProjectId}${config.gitlabProjectIdExplicit ? "" : " (inferred, todo polling unfiltered)"}` : " project=auto (from todos)"}`);
 
   if (mode === "run-once") {
     await runWatcherCycle(config, dependencies);

package/src/local-agent/worktree-manager.ts

@@ -13,6 +13,7 @@ export interface WorktreeInfo {
 interface WorktreeManagerOptions {
   repoPath: string;
   worktreeRoot: string;
+  agentName?: string;
   execFileImpl?: typeof execFileAsync;
 }
 
@@ -28,8 +29,9 @@ export function slugifyTitle(title: string): string {
   return (slug || "task").slice(0, 48);
 }
 
-export function branchNameForIssue(issueIid: number, title: string): string {
-  return `agent/issue-${issueIid}-${slugifyTitle(title)}`;
+export function branchNameForIssue(issueIid: number, title: string, agentName?: string): string {
+  const prefix = agentName ?? "agent";
+  return `${prefix}/issue-${issueIid}-${slugifyTitle(title)}`;
 }
 
 export function worktreePathForIssue(worktreeRoot: string, issueIid: number, title: string): string {
@@ -41,16 +43,19 @@ export class WorktreeManager {
 
   private readonly worktreeRoot: string;
 
+  private readonly agentName: string | undefined;
+
   private readonly execFileImpl: typeof execFileAsync;
 
   constructor(options: WorktreeManagerOptions) {
     this.repoPath = options.repoPath;
     this.worktreeRoot = options.worktreeRoot;
+    this.agentName = options.agentName;
     this.execFileImpl = options.execFileImpl ?? execFileAsync;
   }
 
   async ensureWorktree(issueIid: number, title: string): Promise<WorktreeInfo> {
-    const branch = branchNameForIssue(issueIid, title);
+    const branch = branchNameForIssue(issueIid, title, this.agentName);
     const worktreePath = worktreePathForIssue(this.worktreeRoot, issueIid, title);
 
     await mkdir(this.worktreeRoot, { recursive: true });