245 lines
7.8 KiB
TypeScript
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}`;
|
|
}
|
|
},
|
|
});
|