Files
worklane/.opencode/tools/worklane.ts
T
2026-08-20 13:20:15 +02:00

245 lines
7.8 KiB
TypeScript

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<string, any>, 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<string, any>, 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<string, any>, 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<string, any>, 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<string, any>, 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<string, any>, 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}`;
}
},
});