diff --git a/.opencode/skill/worklane-kanban-skill/SKILL.md b/.opencode/skill/worklane-kanban-skill/SKILL.md index 4db3e58..c1dbf76 100644 --- a/.opencode/skill/worklane-kanban-skill/SKILL.md +++ b/.opencode/skill/worklane-kanban-skill/SKILL.md @@ -35,12 +35,15 @@ Add a new ticket to the backlog. - `--acceptance` (or `-a`): Acceptance criteria (repeat flag for each criterium) - `--plan` (or `-p`): Implementation plan steps (repeat flag for each step) - `--tags` (or `-g`): Tags (comma-separated) -- `--due` (or `--due`): Due date in YYYY-MM-DD format +- `--due`: Due date in YYYY-MM-DD format. No short form - `--owner` (or `-o`): Owner name -- `--priority`: Priority level, 1 (most urgent) to 5 (least). Unset if omitted +- `--priority`: Priority level, 1 (most urgent) to 5 (least). Unset if omitted. No short form + +Tags are `-g`, not `-t`: `-t` is the title, and passing it twice is an error. Each +plan step needs its own `-p`, since a bare value after one is not a second step. ```bash -worklane add -t "Implement login" -d "Add user login page" -t login,auth -p "Design UI" "Build backend" "Write tests" --due 2026-06-01 --owner "ilya" +worklane add -t "Implement login" -d "Add user login page" -g login,auth -p "Design UI" -p "Build backend" -p "Write tests" --due 2026-06-01 --owner "ilya" ``` When there's multiple acceptance criteria, add each using a separate `--acceptance` or `-a` flag. diff --git a/.opencode/tools/worklane.ts b/.opencode/tools/worklane.ts index 7b19404..b17be1b 100644 --- a/.opencode/tools/worklane.ts +++ b/.opencode/tools/worklane.ts @@ -87,28 +87,37 @@ export const init = tool({ 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.", + // Title is the only required field. Every other flag is left off entirely when + // the field is omitted, so an unmarked schema only forced the model to invent a + // value for fields it had nothing to say about. args: { title: tool.schema .string() .describe("Ticket title (required)"), description: tool.schema .string() - .describe("Description text. Use newlines between paragraphs."), + .describe("Description text. Use newlines between paragraphs.") + .optional(), acceptance: tool.schema .string() - .describe("Acceptance criteria, one per line. Put each criterium on its own line."), + .describe("Acceptance criteria, one per line. Put each criterium on its own line.") + .optional(), plan: tool.schema .string() - .describe("Implementation plan steps, one per line. Put each step on its own line."), + .describe("Implementation plan steps, one per line. Put each step on its own line.") + .optional(), tags: tool.schema .string() - .describe("Comma-separated tags, e.g. 'bug,frontend,urgent'"), + .describe("Comma-separated tags, e.g. 'bug,frontend,urgent'") + .optional(), due: tool.schema .string() - .describe("Due date in YYYY-MM-DD format"), + .describe("Due date in YYYY-MM-DD format") + .optional(), owner: tool.schema .string() - .describe("Ticket owner name. If omitted, defaults to the git user."), + .describe("Ticket owner name. If omitted, defaults to the git user.") + .optional(), priority: tool.schema .string() .describe("Priority level, 1 (most urgent) to 5 (least). Left unset if omitted.") diff --git a/README.md b/README.md index bb37e4a..f3e2fc1 100644 --- a/README.md +++ b/README.md @@ -24,3 +24,8 @@ Worklane is a local Kanban flow for agentic software development. the default signal disposition so a truncated pipe is quiet, the way `head` and `sort` are, rather than printing a panic. A script using `set -o pipefail` will see 141 for a case that is not a failure, so guard for it there. + +Whether a truncated pipe reports 141 or 0 depends on the size of the output, not on +the command. A pipe holds 64 KiB, so a listing that fits lands in the buffer whole +and the writer never learns the reader left, giving 0. Only output past that gets far +enough to be cut off. Either way nothing is printed to stderr.