import { tool, ToolContext } from "@opencode-ai/plugin"; import path from "path"; function resolveWorklaneDir(context: ToolContext): string { return path.join(context.worktree || context.directory || "."); } export const init = tool({ description: "Initialize worklane in the current project. Creates the .worklane/ directory with backlog, committed, reviewing, and done subdirectories.", args: {}, async execute(_args: Record, context: ToolContext) { const workdir = resolveWorklaneDir(context); try { const result = await Bun.$`worklane init`.cwd(workdir).text(); return result.trim(); } catch (err: any) { return `Error initializing worklane: ${err.message}`; } }, }); export const add = tool({ description: "Add a new ticket to the worklane backlog. Requires a title. Description, acceptance criteria, and plan each support multiple lines (one item per line). Tags are comma-separated.", args: { title: tool.schema .string() .describe("Ticket title (required)"), description: tool.schema .string() .describe("Description text. Use newlines between paragraphs."), acceptance: tool.schema .string() .describe("Acceptance criteria, one per line. Put each criterium on its own line."), plan: tool.schema .string() .describe("Implementation plan steps, one per line. Put each step on its own line."), tags: tool.schema .string() .describe("Comma-separated tags, e.g. 'bug,frontend,urgent'"), due: tool.schema .string() .describe("Due date in YYYY-MM-DD format"), owner: tool.schema .string() .describe("Ticket owner name. If omitted, defaults to the git user."), }, async execute(args: Record, context: ToolContext) { if (!args.title) { return "Error adding ticket: title is required"; } const cmd: (string | number)[] = ["add", "--title", args.title]; if (args.description) { args.description .split("\n") .map((l: string) => l.trim()) .filter(Boolean) .forEach((line: string) => cmd.push("--description", line)); } if (args.acceptance) { args.acceptance .split("\n") .map((l: string) => l.trim()) .filter(Boolean) .forEach((line: string) => cmd.push("--acceptance", line)); } if (args.plan) { args.plan .split("\n") .map((l: string) => l.trim()) .filter(Boolean) .forEach((line: string) => cmd.push("--plan", line)); } if (args.tags) cmd.push("--tags", args.tags); if (args.due) cmd.push("--due", args.due); if (args.owner) cmd.push("--owner", args.owner); const workdir = resolveWorklaneDir(context); try { const proc = Bun.spawn(["worklane", ...cmd], { cwd: workdir, stdout: "pipe", stderr: "pipe", }); const [stdout, stderr, exitCode] = await Promise.all([ new Response(proc.stdout).text(), new Response(proc.stderr).text(), proc.exited, ]); if (exitCode !== 0) { throw new Error( stderr.trim() || `Exit code ${exitCode}, stderr: ${stderr}`, ); } return stdout; } catch (err: any) { return `Error adding ticket: ${err.message}, cmd: ${cmd}`; } }, }); export const ls = tool({ description: "List all worklane tickets. Optionally filter by status (backlog, committed, reviewing, done).", args: { status: tool.schema .enum(["backlog", "committed", "reviewing", "done"]) .describe("Filter by status") .optional(), }, async execute(args: Record, context: ToolContext) { const workdir = resolveWorklaneDir(context); try { if (args.status) { const result = await Bun.$`worklane ls ${args.status}` .cwd(workdir) .text(); return result.trim(); } else { const result = await Bun.$`worklane ls`.cwd(workdir).text(); return result.trim(); } } catch (err: any) { return `Error listing tickets: ${err.message}, Dir: ${workdir}`; } }, }); export const show = tool({ description: "Show a complete ticket by UUID or title. Displays title, description, acceptance criteria, implementation plan, metadata, and comments.", args: { id: tool.schema .string() .describe("Ticket UUID (8+ chars) or title substring (required)"), }, async execute(args: Record, context: ToolContext) { if (!args.id) { return "Error showing ticket: id is required"; } const workdir = resolveWorklaneDir(context); try { const result = await Bun.$`worklane show ${args.id}`.cwd(workdir).text(); return result.trim(); } catch (err: any) { return `Error showing ticket: ${err.message}`; } }, }); export const mv = tool({ description: "Move a ticket to a different status in the workflow (backlog -> committed -> reviewing -> done).", args: { ticket: tool.schema .string() .describe("Ticket UUID (8+ chars) or title substring (required)"), status: tool.schema .enum(["backlog", "committed", "reviewing", "done"]) .describe("Target status (required)"), force: tool.schema .boolean() .describe("Force move (allows non-sequential moves like done -> backlog). Use with caution.") .optional(), }, async execute(args: Record, context: ToolContext) { if (!args.ticket) { return "Error moving ticket: ticket is required"; } if (!args.status) { return "Error moving ticket: status is required. Must be one of: backlog, committed, reviewing, done"; } const cmd: (string | number)[] = [ "mv", args.ticket, "--status", args.status, ]; if (args.force) cmd.push("--force"); const workdir = resolveWorklaneDir(context); try { const proc = Bun.spawn(["worklane", ...cmd], { cwd: workdir }); const [stdout, stderr, exitCode] = await Promise.all([ new Response(proc.stdout).text(), new Response(proc.stderr).text(), proc.exited, ]); if (exitCode !== 0) { throw new Error(stderr.trim() || `Exit code ${exitCode}`); } return stdout.trim(); } catch (err: any) { return `Error moving ticket: ${err.message}`; } }, }); export const comment = tool({ description: "Add a comment to an existing ticket. The comment body supports markdown and newlines. Use it to add review feedback, notes, or status updates.", args: { ticket: tool.schema .string() .describe("Ticket UUID (8+ chars) or title substring (required)"), body: tool.schema .string() .describe("Comment body text (required). Supports markdown formatting and multiple paragraphs separated by newlines."), owner: tool.schema .string() .describe("Comment author. If omitted, defaults to the git user.") .optional(), }, async execute(args: Record, context: ToolContext) { if (!args.ticket) { return "Error adding comment: ticket is required"; } if (!args.body) { return "Error adding comment: body is required"; } const cmd: (string | number)[] = ["comment", args.ticket, args.body]; if (args.owner) cmd.push("--owner", args.owner); const workdir = resolveWorklaneDir(context); try { const proc = Bun.spawn(["worklane", ...cmd], { cwd: workdir }); const [stdout, stderr, exitCode] = await Promise.all([ new Response(proc.stdout).text(), new Response(proc.stderr).text(), proc.exited, ]); if (exitCode !== 0) { throw new Error(stderr.trim() || `Exit code ${exitCode}`); } return stdout.trim(); } catch (err: any) { return `Error adding comment: ${err.message}`; } }, });