@clawcipes/recipes 0.1.5 → 0.1.8

package/README.md

@@ -8,7 +8,7 @@
 
 Clawcipes is an OpenClaw plugin that provides **CLI-first recipes** for scaffolding specialist agents and teams from Markdown.
 
-If you like durable workflows: Clawcipes is built around a **file-first team workspace** (inbox/backlog/in-progress/done) that plays nicely with git.
+If you like durable workflows: Clawcipes is built around a **file-first team workspace** (inbox/backlog/in-progress/testing/done) that plays nicely with git.
 
 ## Quickstart
 ### 1) Install
@@ -55,8 +55,9 @@ openclaw recipes dispatch \
 - `openclaw recipes scaffold` (agent → `workspace-<agentId>`)
 - `openclaw recipes scaffold-team` (team → `workspace-<teamId>` + `roles/<role>/`)
 - `openclaw recipes install <idOrSlug> [--yes] [--global|--agent-id <id>|--team-id <id>]` (skills: global or scoped)
-- `openclaw recipes bind|bindings` (multi-agent routing)
+- `openclaw recipes bind|unbind|bindings` (multi-agent routing)
 - `openclaw recipes dispatch ...` (request → inbox + ticket + assignment)
+- `openclaw recipes tickets|move-ticket|assign|take|complete` (file-first ticket workflow)
 
 For full details, see `docs/COMMANDS.md`.
 
@@ -127,4 +128,4 @@ Clawcipes is meant to be *installed* and then used to build **agents + teams**.
 Most users should focus on:
 - authoring recipes in their OpenClaw workspace (`<workspace>/recipes/*.md`)
 - scaffolding teams (`openclaw recipes scaffold-team ...`)
-- running the file-first workflow (dispatch → backlog → in-progress → done)
+- running the file-first workflow (dispatch → backlog → in-progress → testing → done)

package/docs/COMMANDS.md

@@ -66,7 +66,7 @@ Creates a shared team workspace root:
 
 Standard folders:
 - `inbox/`, `outbox/`, `shared/`, `notes/`
-- `work/{backlog,in-progress,done,assignments}`
+- `work/{backlog,in-progress,testing,done,assignments}`
 - `roles/<role>/...` (role-specific recipe files)
 
 Also creates agent config entries under `agents.list[]` (when `--apply-config`), with agent ids:
@@ -114,6 +114,19 @@ Notes:
 - `peer.kind` must be one of: `dm|group|channel`.
 - Peer-specific bindings are inserted first (more specific wins).
 
+## `unbind`
+Remove routing binding(s) from OpenClaw config (`bindings[]`).
+
+Examples:
+
+```bash
+# Remove a specific DM binding for an agent
+openclaw recipes unbind --agent-id dev --channel telegram --peer-kind dm --peer-id 6477250615
+
+# Remove ALL bindings that match this peer (any agent)
+openclaw recipes unbind --channel telegram --peer-kind dm --peer-id 6477250615
+```
+
 ## `bindings`
 Print the current `bindings[]` from OpenClaw config.
 
@@ -137,6 +150,53 @@ Options:
 ## `dispatch`
 Convert a natural-language request into file-first execution artifacts.
 
+## `tickets`
+List tickets for a team across the standard workflow stages.
+
+```bash
+openclaw recipes tickets --team-id <teamId>
+openclaw recipes tickets --team-id <teamId> --json
+```
+
+## `move-ticket`
+Move a ticket file between workflow stages and update the ticket’s `Status:` field.
+
+```bash
+openclaw recipes move-ticket --team-id <teamId> --ticket 0007 --to in-progress
+openclaw recipes move-ticket --team-id <teamId> --ticket 0007 --to testing
+openclaw recipes move-ticket --team-id <teamId> --ticket 0007 --to done --completed
+```
+
+Stages:
+- `backlog` → `Status: queued`
+- `in-progress` → `Status: in-progress`
+- `testing` → `Status: testing`
+- `done` → `Status: done` (optional `Completed:` timestamp)
+
+## `assign`
+Assign a ticket to an owner (updates `Owner:` and creates an assignment stub).
+
+```bash
+openclaw recipes assign --team-id <teamId> --ticket 0007 --owner dev
+openclaw recipes assign --team-id <teamId> --ticket 0007 --owner lead
+```
+
+Owners (current): `dev|devops|lead`.
+
+## `take`
+Shortcut: assign + move to in-progress.
+
+```bash
+openclaw recipes take --team-id <teamId> --ticket 0007 --owner dev
+```
+
+## `complete`
+Shortcut: move to done + ensure `Status: done` + add `Completed:` timestamp.
+
+```bash
+openclaw recipes complete --team-id <teamId> --ticket 0007
+```
+
 ```bash
 openclaw recipes dispatch \
   --team-id development-team-team \
@@ -151,12 +211,12 @@ Options:
 - `--yes` (skip review prompt)
 
 Creates (createOnly):
-- `teams/<teamId>/inbox/<timestamp>-<slug>.md`
-- `teams/<teamId>/work/backlog/<NNNN>-<slug>.md`
-- `teams/<teamId>/work/assignments/<NNNN>-assigned-<owner>.md`
+- `workspace-<teamId>/inbox/<timestamp>-<slug>.md`
+- `workspace-<teamId>/work/backlog/<NNNN>-<slug>.md`
+- `workspace-<teamId>/work/assignments/<NNNN>-assigned-<owner>.md`
 
 Ticket numbering:
-- Scans `work/backlog`, `work/in-progress`, `work/done` and uses max+1.
+- Scans `work/backlog`, `work/in-progress`, `work/testing`, `work/done` and uses max+1.
 
 Review-before-write:
 - Prints a JSON plan and asks for confirmation unless `--yes`.

package/docs/TEAM_WORKFLOW.md

@@ -6,7 +6,7 @@ Clawcipes’ differentiator is the **shared team workspace** + a simple, durable
 When you scaffold a team:
 
 ```
-teams/<teamId>/
+~/.openclaw/workspace-<teamId>/
   inbox/
   outbox/
   shared/
@@ -14,9 +14,9 @@ teams/<teamId>/
   work/
     backlog/
     in-progress/
+    testing/
     done/
     assignments/
-  TICKETS.md
   TEAM.md
 ```
 
@@ -29,12 +29,16 @@ teams/<teamId>/
 - Filename ordering is the priority queue.
 
 3) **Execute**
-- Move ticket file to `work/in-progress/`.
+- Move ticket file to `work/in-progress/` (or use `take`).
 - Do work; write artifacts into `shared/` or agent workspaces.
 
-4) **Complete**
-- Move ticket to `work/done/`.
-- Add a `*.DONE.md` report next to it.
+4) **Test**
+- Move ticket to `work/testing/`.
+- Optionally assign to a tester/lead for verification.
+
+5) **Complete**
+- Move ticket to `work/done/` (or use `complete`).
+- Add `Completed:` timestamp (automated by `complete` or `move-ticket --completed`).
 
 ## Dispatcher command
 The lead can convert a natural-language request into artifacts with:

package/index.ts

@@ -293,6 +293,27 @@ function upsertBindingInConfig(cfgObj: any, binding: BindingSnippet) {
   return { changed: true, note: "added" as const };
 }
 
+function removeBindingsInConfig(cfgObj: any, opts: { agentId?: string; match: BindingMatch }) {
+  if (!Array.isArray(cfgObj.bindings)) cfgObj.bindings = [];
+  const list: any[] = cfgObj.bindings;
+
+  const targetMatchSig = stableStringify(opts.match);
+
+  const before = list.length;
+  const kept: any[] = [];
+  const removed: any[] = [];
+
+  for (const b of list) {
+    const sameAgent = opts.agentId ? String(b?.agentId ?? "") === opts.agentId : true;
+    const sameMatch = stableStringify(b?.match ?? {}) === targetMatchSig;
+    if (sameAgent && sameMatch) removed.push(b);
+    else kept.push(b);
+  }
+
+  cfgObj.bindings = kept;
+  return { removedCount: before - kept.length, removed };
+}
+
 async function applyAgentSnippetsToOpenClawConfig(api: OpenClawPluginApi, snippets: AgentConfigSnippet[]) {
   // Load the latest config from disk (not the snapshot in api.config).
   const current = (api.runtime as any).config?.loadConfig?.();
@@ -469,6 +490,34 @@ const recipesPlugin = {
             console.log(JSON.stringify(out, null, 2));
           });
 
+        const parseMatchFromOptions = (options: any): BindingMatch => {
+          if (options.match) {
+            return JSON5.parse(String(options.match)) as BindingMatch;
+          }
+
+          const match: BindingMatch = {
+            channel: String(options.channel),
+          };
+          if (options.accountId) match.accountId = String(options.accountId);
+          if (options.guildId) match.guildId = String(options.guildId);
+          if (options.teamId) match.teamId = String(options.teamId);
+
+          if (options.peerKind || options.peerId) {
+            if (!options.peerKind || !options.peerId) {
+              throw new Error("--peer-kind and --peer-id must be provided together");
+            }
+            let kind = String(options.peerKind);
+            // Back-compat alias
+            if (kind === "direct") kind = "dm";
+            if (kind !== "dm" && kind !== "group" && kind !== "channel") {
+              throw new Error("--peer-kind must be dm|group|channel (or direct as alias for dm)");
+            }
+            match.peer = { kind, id: String(options.peerId) };
+          }
+
+          return match;
+        };
+
         cmd
           .command("bind")
           .description("Add/update a multi-agent routing binding (writes openclaw.json bindings[])")
@@ -482,32 +531,7 @@ const recipesPlugin = {
           .option("--match <json>", "Full match object as JSON/JSON5 (overrides flags)")
           .action(async (options: any) => {
             const agentId = String(options.agentId);
-            let match: BindingMatch;
-
-            if (options.match) {
-              match = JSON5.parse(String(options.match)) as BindingMatch;
-            } else {
-              match = {
-                channel: String(options.channel),
-              };
-              if (options.accountId) match.accountId = String(options.accountId);
-              if (options.guildId) match.guildId = String(options.guildId);
-              if (options.teamId) match.teamId = String(options.teamId);
-
-              if (options.peerKind || options.peerId) {
-                if (!options.peerKind || !options.peerId) {
-                  throw new Error("--peer-kind and --peer-id must be provided together");
-                }
-                let kind = String(options.peerKind);
-                // Back-compat alias
-                if (kind === "direct") kind = "dm";
-                if (kind !== "dm" && kind !== "group" && kind !== "channel") {
-                  throw new Error("--peer-kind must be dm|group|channel (or direct as alias for dm)");
-                }
-                match.peer = { kind, id: String(options.peerId) };
-              }
-            }
-
+            const match = parseMatchFromOptions(options);
             if (!match?.channel) throw new Error("match.channel is required");
 
             const res = await applyBindingSnippetsToOpenClawConfig(api, [{ agentId, match }]);
@@ -515,6 +539,33 @@ const recipesPlugin = {
             console.error("Binding written. Restart gateway if required for changes to take effect.");
           });
 
+        cmd
+          .command("unbind")
+          .description("Remove routing binding(s) from openclaw.json bindings[]")
+          .requiredOption("--channel <channel>", "Channel name")
+          .option("--agent-id <agentId>", "Optional agent id; when set, removes only bindings for this agent")
+          .option("--account-id <accountId>", "Channel accountId")
+          .option("--peer-kind <kind>", "Peer kind (dm|group|channel)")
+          .option("--peer-id <id>", "Peer id")
+          .option("--guild-id <guildId>", "Discord guildId")
+          .option("--team-id <teamId>", "Slack teamId")
+          .option("--match <json>", "Full match object as JSON/JSON5 (overrides flags)")
+          .action(async (options: any) => {
+            const agentId = typeof options.agentId === "string" ? String(options.agentId) : undefined;
+            const match = parseMatchFromOptions(options);
+            if (!match?.channel) throw new Error("match.channel is required");
+
+            const current = (api.runtime as any).config?.loadConfig?.();
+            if (!current) throw new Error("Failed to load config via api.runtime.config.loadConfig()");
+            const cfgObj = (current.cfg ?? current) as any;
+
+            const res = removeBindingsInConfig(cfgObj, { agentId, match });
+            await (api.runtime as any).config?.writeConfigFile?.(cfgObj);
+
+            console.log(JSON.stringify({ ok: true, ...res }, null, 2));
+            console.error("Binding(s) removed. Restart gateway if required for changes to take effect.");
+          });
+
         cmd
           .command("bindings")
           .description("Show current bindings from openclaw config")
@@ -843,6 +894,7 @@ const recipesPlugin = {
               const dirs = [
                 backlogDir,
                 path.join(teamDir, "work", "in-progress"),
+                path.join(teamDir, "work", "testing"),
                 path.join(teamDir, "work", "done"),
               ];
               let max = 0;
@@ -882,11 +934,13 @@ const recipesPlugin = {
             const ticketPath = path.join(backlogDir, `${ticketNumStr}-${baseSlug}.md`);
             const assignmentPath = path.join(assignmentsDir, `${ticketNumStr}-assigned-${owner}.md`);
 
-            const inboxMd = `# Inbox — ${teamId}\n\nReceived: ${new Date().toISOString()}\n\n## Request\n${requestText}\n\n## Proposed work\n- Ticket: ${ticketNumStr}-${baseSlug}\n- Owner: ${owner}\n`;
+            const receivedIso = new Date().toISOString();
+
+            const inboxMd = `# Inbox — ${teamId}\n\nReceived: ${receivedIso}\n\n## Request\n${requestText}\n\n## Proposed work\n- Ticket: ${ticketNumStr}-${baseSlug}\n- Owner: ${owner}\n\n## Links\n- Ticket: ${path.relative(teamDir, ticketPath)}\n- Assignment: ${path.relative(teamDir, assignmentPath)}\n`;
 
-            const ticketMd = `# ${ticketNumStr}-${baseSlug}\n\nOwner: ${owner}\nStatus: queued\n\n## Context\n${requestText}\n\n## Requirements\n- (fill in)\n\n## Acceptance criteria\n- (fill in)\n`;
+            const ticketMd = `# ${ticketNumStr}-${baseSlug}\n\nCreated: ${receivedIso}\nOwner: ${owner}\nStatus: queued\nInbox: ${path.relative(teamDir, inboxPath)}\nAssignment: ${path.relative(teamDir, assignmentPath)}\n\n## Context\n${requestText}\n\n## Requirements\n- (fill in)\n\n## Acceptance criteria\n- (fill in)\n\n## Tasks\n- [ ] (fill in)\n`;
 
-            const assignmentMd = `# Assignment — ${ticketNumStr}-${baseSlug}\n\nAssigned: ${owner}\n\n## Goal\n${title}\n\n## Ticket\n${path.relative(teamDir, ticketPath)}\n\n## Notes\n- Created by: openclaw recipes dispatch\n`;
+            const assignmentMd = `# Assignment — ${ticketNumStr}-${baseSlug}\n\nCreated: ${receivedIso}\nAssigned: ${owner}\n\n## Goal\n${title}\n\n## Ticket\n${path.relative(teamDir, ticketPath)}\n\n## Notes\n- Created by: openclaw recipes dispatch\n`;
 
             const plan = {
               teamId,
@@ -940,6 +994,396 @@ const recipesPlugin = {
             console.log(JSON.stringify({ ok: true, wrote: plan.files.map((f) => f.path) }, null, 2));
           });
 
+        cmd
+          .command("tickets")
+          .description("List tickets for a team (backlog / in-progress / testing / done)")
+          .requiredOption("--team-id <teamId>", "Team id")
+          .option("--json", "Output JSON")
+          .action(async (options: any) => {
+            const workspaceRoot = api.config.agents?.defaults?.workspace;
+            if (!workspaceRoot) throw new Error("agents.defaults.workspace is not set in config");
+            const teamId = String(options.teamId);
+            const teamDir = path.resolve(workspaceRoot, "..", `workspace-${teamId}`);
+
+            const dirs = {
+              backlog: path.join(teamDir, "work", "backlog"),
+              inProgress: path.join(teamDir, "work", "in-progress"),
+              testing: path.join(teamDir, "work", "testing"),
+              done: path.join(teamDir, "work", "done"),
+            } as const;
+
+            const readTickets = async (dir: string, stage: "backlog" | "in-progress" | "testing" | "done") => {
+              if (!(await fileExists(dir))) return [] as any[];
+              const files = (await fs.readdir(dir)).filter((f) => f.endsWith(".md")).sort();
+              return files.map((f) => {
+                const m = f.match(/^(\d{4})-(.+)\.md$/);
+                return {
+                  stage,
+                  number: m ? Number(m[1]) : null,
+                  id: m ? `${m[1]}-${m[2]}` : f.replace(/\.md$/, ""),
+                  file: path.join(dir, f),
+                };
+              });
+            };
+
+            const out = {
+              teamId,
+              backlog: await readTickets(dirs.backlog, "backlog"),
+              inProgress: await readTickets(dirs.inProgress, "in-progress"),
+              testing: await readTickets(dirs.testing, "testing"),
+              done: await readTickets(dirs.done, "done"),
+            };
+
+            if (options.json) {
+              console.log(JSON.stringify(out, null, 2));
+              return;
+            }
+
+            const print = (label: string, items: any[]) => {
+              console.log(`\n${label} (${items.length})`);
+              for (const t of items) console.log(`- ${t.id}`);
+            };
+            console.log(`Team: ${teamId}`);
+            print("Backlog", out.backlog);
+            print("In progress", out.inProgress);
+            print("Testing", out.testing);
+            print("Done", out.done);
+          });
+
+        cmd
+          .command("move-ticket")
+          .description("Move a ticket between backlog/in-progress/testing/done (updates Status: line)")
+          .requiredOption("--team-id <teamId>", "Team id")
+          .requiredOption("--ticket <ticket>", "Ticket id or number (e.g. 0007 or 0007-some-slug)")
+          .requiredOption("--to <stage>", "Destination stage: backlog|in-progress|testing|done")
+          .option("--completed", "When moving to done, add Completed: timestamp")
+          .option("--yes", "Skip confirmation")
+          .action(async (options: any) => {
+            const workspaceRoot = api.config.agents?.defaults?.workspace;
+            if (!workspaceRoot) throw new Error("agents.defaults.workspace is not set in config");
+            const teamId = String(options.teamId);
+            const teamDir = path.resolve(workspaceRoot, "..", `workspace-${teamId}`);
+
+            const dest = String(options.to);
+            if (!['backlog','in-progress','testing','done'].includes(dest)) {
+              throw new Error("--to must be one of: backlog, in-progress, testing, done");
+            }
+
+            const ticketArg = String(options.ticket);
+            const ticketNum = ticketArg.match(/^\d{4}$/) ? ticketArg : (ticketArg.match(/^(\d{4})-/)?.[1] ?? null);
+
+            const stageDir = (stage: string) => {
+              if (stage === 'backlog') return path.join(teamDir, 'work', 'backlog');
+              if (stage === 'in-progress') return path.join(teamDir, 'work', 'in-progress');
+              if (stage === 'testing') return path.join(teamDir, 'work', 'testing');
+              if (stage === 'done') return path.join(teamDir, 'work', 'done');
+              throw new Error(`Unknown stage: ${stage}`);
+            };
+
+            const searchDirs = [stageDir('backlog'), stageDir('in-progress'), stageDir('testing'), stageDir('done')];
+
+            const findTicketFile = async () => {
+              for (const dir of searchDirs) {
+                if (!(await fileExists(dir))) continue;
+                const files = await fs.readdir(dir);
+                for (const f of files) {
+                  if (!f.endsWith('.md')) continue;
+                  if (ticketNum && f.startsWith(`${ticketNum}-`)) return path.join(dir, f);
+                  if (!ticketNum && f.replace(/\.md$/, '') === ticketArg) return path.join(dir, f);
+                }
+              }
+              return null;
+            };
+
+            const srcPath = await findTicketFile();
+            if (!srcPath) throw new Error(`Ticket not found: ${ticketArg}`);
+
+            const destDir = stageDir(dest);
+            await ensureDir(destDir);
+            const filename = path.basename(srcPath);
+            const destPath = path.join(destDir, filename);
+
+            const patchStatus = (md: string) => {
+              const nextStatus =
+                dest === 'backlog'
+                  ? 'queued'
+                  : dest === 'in-progress'
+                    ? 'in-progress'
+                    : dest === 'testing'
+                      ? 'testing'
+                      : 'done';
+
+              let out = md;
+              if (out.match(/^Status:\s.*$/m)) out = out.replace(/^Status:\s.*$/m, `Status: ${nextStatus}`);
+              else out = out.replace(/^(# .+\n)/, `$1\nStatus: ${nextStatus}\n`);
+
+              if (dest === 'done' && options.completed) {
+                const completed = new Date().toISOString();
+                if (out.match(/^Completed:\s.*$/m)) out = out.replace(/^Completed:\s.*$/m, `Completed: ${completed}`);
+                else out = out.replace(/^Status:.*$/m, (m) => `${m}\nCompleted: ${completed}`);
+              }
+
+              return out;
+            };
+
+            const plan = { from: srcPath, to: destPath };
+
+            if (!options.yes && process.stdin.isTTY) {
+              console.log(JSON.stringify({ plan }, null, 2));
+              const readline = await import('node:readline/promises');
+              const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+              try {
+                const ans = await rl.question(`Move ticket to ${dest}? (y/N) `);
+                const ok = ans.trim().toLowerCase() === 'y' || ans.trim().toLowerCase() === 'yes';
+                if (!ok) {
+                  console.error('Aborted; no changes made.');
+                  return;
+                }
+              } finally {
+                rl.close();
+              }
+            } else if (!options.yes && !process.stdin.isTTY) {
+              console.error('Refusing to move without confirmation in non-interactive mode. Re-run with --yes.');
+              process.exitCode = 2;
+              console.log(JSON.stringify({ ok: false, plan }, null, 2));
+              return;
+            }
+
+            const md = await fs.readFile(srcPath, 'utf8');
+            const nextMd = patchStatus(md);
+            await fs.writeFile(srcPath, nextMd, 'utf8');
+
+            if (srcPath !== destPath) {
+              await fs.rename(srcPath, destPath);
+            }
+
+            console.log(JSON.stringify({ ok: true, moved: plan }, null, 2));
+          });
+
+        cmd
+          .command("assign")
+          .description("Assign a ticket to an owner (writes assignment stub + updates Owner: in ticket)")
+          .requiredOption("--team-id <teamId>", "Team id")
+          .requiredOption("--ticket <ticket>", "Ticket id or number (e.g. 0007 or 0007-some-slug)")
+          .requiredOption("--owner <owner>", "Owner: dev|devops|lead")
+          .option("--overwrite", "Overwrite existing assignment file")
+          .option("--yes", "Skip confirmation")
+          .action(async (options: any) => {
+            const workspaceRoot = api.config.agents?.defaults?.workspace;
+            if (!workspaceRoot) throw new Error("agents.defaults.workspace is not set in config");
+            const teamId = String(options.teamId);
+            const teamDir = path.resolve(workspaceRoot, "..", `workspace-${teamId}`);
+
+            const owner = String(options.owner);
+            if (!['dev','devops','lead'].includes(owner)) {
+              throw new Error("--owner must be one of: dev, devops, lead");
+            }
+
+            const stageDir = (stage: string) => {
+              if (stage === 'backlog') return path.join(teamDir, 'work', 'backlog');
+              if (stage === 'in-progress') return path.join(teamDir, 'work', 'in-progress');
+              if (stage === 'done') return path.join(teamDir, 'work', 'done');
+              throw new Error(`Unknown stage: ${stage}`);
+            };
+            const searchDirs = [stageDir('backlog'), stageDir('in-progress'), stageDir('done')];
+
+            const ticketArg = String(options.ticket);
+            const ticketNum = ticketArg.match(/^\d{4}$/) ? ticketArg : (ticketArg.match(/^(\d{4})-/)?.[1] ?? null);
+
+            const findTicketFile = async () => {
+              for (const dir of searchDirs) {
+                if (!(await fileExists(dir))) continue;
+                const files = await fs.readdir(dir);
+                for (const f of files) {
+                  if (!f.endsWith('.md')) continue;
+                  if (ticketNum && f.startsWith(`${ticketNum}-`)) return path.join(dir, f);
+                  if (!ticketNum && f.replace(/\.md$/, '') === ticketArg) return path.join(dir, f);
+                }
+              }
+              return null;
+            };
+
+            const ticketPath = await findTicketFile();
+            if (!ticketPath) throw new Error(`Ticket not found: ${ticketArg}`);
+
+            const filename = path.basename(ticketPath);
+            const m = filename.match(/^(\d{4})-(.+)\.md$/);
+            const ticketNumStr = m?.[1] ?? (ticketNum ?? '0000');
+            const slug = m?.[2] ?? (ticketArg.replace(/^\d{4}-?/, '') || 'ticket');
+
+            const assignmentsDir = path.join(teamDir, 'work', 'assignments');
+            await ensureDir(assignmentsDir);
+            const assignmentPath = path.join(assignmentsDir, `${ticketNumStr}-assigned-${owner}.md`);
+
+            const patchOwner = (md: string) => {
+              if (md.match(/^Owner:\s.*$/m)) return md.replace(/^Owner:\s.*$/m, `Owner: ${owner}`);
+              return md.replace(/^(# .+\n)/, `$1\nOwner: ${owner}\n`);
+            };
+
+            const plan = { ticketPath, assignmentPath, owner };
+
+            if (!options.yes && process.stdin.isTTY) {
+              console.log(JSON.stringify({ plan }, null, 2));
+              const readline = await import('node:readline/promises');
+              const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+              try {
+                const ans = await rl.question(`Assign ticket to ${owner}? (y/N) `);
+                const ok = ans.trim().toLowerCase() === 'y' || ans.trim().toLowerCase() === 'yes';
+                if (!ok) {
+                  console.error('Aborted; no changes made.');
+                  return;
+                }
+              } finally {
+                rl.close();
+              }
+            } else if (!options.yes && !process.stdin.isTTY) {
+              console.error('Refusing to assign without confirmation in non-interactive mode. Re-run with --yes.');
+              process.exitCode = 2;
+              console.log(JSON.stringify({ ok: false, plan }, null, 2));
+              return;
+            }
+
+            const md = await fs.readFile(ticketPath, 'utf8');
+            const nextMd = patchOwner(md);
+            await fs.writeFile(ticketPath, nextMd, 'utf8');
+
+            const assignmentMd = `# Assignment — ${ticketNumStr}-${slug}\n\nAssigned: ${owner}\n\n## Ticket\n${path.relative(teamDir, ticketPath)}\n\n## Notes\n- Created by: openclaw recipes assign\n`;
+            await writeFileSafely(assignmentPath, assignmentMd, options.overwrite ? 'overwrite' : 'createOnly');
+
+            console.log(JSON.stringify({ ok: true, plan }, null, 2));
+          });
+
+        cmd
+          .command("take")
+          .description("Shortcut: assign ticket to owner + move to in-progress")
+          .requiredOption("--team-id <teamId>", "Team id")
+          .requiredOption("--ticket <ticket>", "Ticket id or number")
+          .option("--owner <owner>", "Owner: dev|devops|lead", "dev")
+          .option("--yes", "Skip confirmation")
+          .action(async (options: any) => {
+            const workspaceRoot = api.config.agents?.defaults?.workspace;
+            if (!workspaceRoot) throw new Error("agents.defaults.workspace is not set in config");
+            const teamId = String(options.teamId);
+            const teamDir = path.resolve(workspaceRoot, "..", `workspace-${teamId}`);
+
+            const owner = String(options.owner ?? 'dev');
+            if (!['dev','devops','lead'].includes(owner)) {
+              throw new Error("--owner must be one of: dev, devops, lead");
+            }
+
+            const stageDir = (stage: string) => {
+              if (stage === 'backlog') return path.join(teamDir, 'work', 'backlog');
+              if (stage === 'in-progress') return path.join(teamDir, 'work', 'in-progress');
+              if (stage === 'done') return path.join(teamDir, 'work', 'done');
+              throw new Error(`Unknown stage: ${stage}`);
+            };
+            const searchDirs = [stageDir('backlog'), stageDir('in-progress'), stageDir('done')];
+
+            const ticketArg = String(options.ticket);
+            const ticketNum = ticketArg.match(/^\d{4}$/) ? ticketArg : (ticketArg.match(/^(\d{4})-/)?.[1] ?? null);
+
+            const findTicketFile = async () => {
+              for (const dir of searchDirs) {
+                if (!(await fileExists(dir))) continue;
+                const files = await fs.readdir(dir);
+                for (const f of files) {
+                  if (!f.endsWith('.md')) continue;
+                  if (ticketNum && f.startsWith(`${ticketNum}-`)) return path.join(dir, f);
+                  if (!ticketNum && f.replace(/\.md$/, '') === ticketArg) return path.join(dir, f);
+                }
+              }
+              return null;
+            };
+
+            const srcPath = await findTicketFile();
+            if (!srcPath) throw new Error(`Ticket not found: ${ticketArg}`);
+
+            const destDir = stageDir('in-progress');
+            await ensureDir(destDir);
+            const filename = path.basename(srcPath);
+            const destPath = path.join(destDir, filename);
+
+            const patch = (md: string) => {
+              let out = md;
+              if (out.match(/^Owner:\s.*$/m)) out = out.replace(/^Owner:\s.*$/m, `Owner: ${owner}`);
+              else out = out.replace(/^(# .+\n)/, `$1\nOwner: ${owner}\n`);
+
+              if (out.match(/^Status:\s.*$/m)) out = out.replace(/^Status:\s.*$/m, `Status: in-progress`);
+              else out = out.replace(/^(# .+\n)/, `$1\nStatus: in-progress\n`);
+
+              return out;
+            };
+
+            const plan = { from: srcPath, to: destPath, owner };
+
+            if (!options.yes && process.stdin.isTTY) {
+              console.log(JSON.stringify({ plan }, null, 2));
+              const readline = await import('node:readline/promises');
+              const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+              try {
+                const ans = await rl.question(`Assign to ${owner} and move to in-progress? (y/N) `);
+                const ok = ans.trim().toLowerCase() === 'y' || ans.trim().toLowerCase() === 'yes';
+                if (!ok) {
+                  console.error('Aborted; no changes made.');
+                  return;
+                }
+              } finally {
+                rl.close();
+              }
+            } else if (!options.yes && !process.stdin.isTTY) {
+              console.error('Refusing to take without confirmation in non-interactive mode. Re-run with --yes.');
+              process.exitCode = 2;
+              console.log(JSON.stringify({ ok: false, plan }, null, 2));
+              return;
+            }
+
+            const md = await fs.readFile(srcPath, 'utf8');
+            const nextMd = patch(md);
+            await fs.writeFile(srcPath, nextMd, 'utf8');
+
+            if (srcPath !== destPath) {
+              await fs.rename(srcPath, destPath);
+            }
+
+            const m = filename.match(/^(\d{4})-(.+)\.md$/);
+            const ticketNumStr = m?.[1] ?? (ticketNum ?? '0000');
+            const slug = m?.[2] ?? (ticketArg.replace(/^\d{4}-?/, '') || 'ticket');
+            const assignmentsDir = path.join(teamDir, 'work', 'assignments');
+            await ensureDir(assignmentsDir);
+            const assignmentPath = path.join(assignmentsDir, `${ticketNumStr}-assigned-${owner}.md`);
+            const assignmentMd = `# Assignment — ${ticketNumStr}-${slug}\n\nAssigned: ${owner}\n\n## Ticket\n${path.relative(teamDir, destPath)}\n\n## Notes\n- Created by: openclaw recipes take\n`;
+            await writeFileSafely(assignmentPath, assignmentMd, 'createOnly');
+
+            console.log(JSON.stringify({ ok: true, plan, assignmentPath }, null, 2));
+          });
+
+        cmd
+          .command("complete")
+          .description("Complete a ticket (move to done, set Status: done, and add Completed: timestamp)")
+          .requiredOption("--team-id <teamId>", "Team id")
+          .requiredOption("--ticket <ticket>", "Ticket id or number")
+          .option("--yes", "Skip confirmation")
+          .action(async (options: any) => {
+            const args = [
+              'recipes',
+              'move-ticket',
+              '--team-id',
+              String(options.teamId),
+              '--ticket',
+              String(options.ticket),
+              '--to',
+              'done',
+              '--completed',
+            ];
+            if (options.yes) args.push('--yes');
+
+            const { spawnSync } = await import('node:child_process');
+            const res = spawnSync('openclaw', args, { stdio: 'inherit' });
+            if (res.status !== 0) {
+              process.exitCode = res.status ?? 1;
+            }
+          });
+
         cmd
           .command("scaffold")
           .description("Scaffold an agent from a recipe")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawcipes/recipes",
-  "version": "0.1.5",
+  "version": "0.1.8",
   "description": "Clawcipes recipes plugin for OpenClaw (markdown recipes -> scaffold agents/teams)",
   "main": "index.ts",
   "type": "commonjs",