@clawcipes/recipes 0.2.4 → 0.2.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawcipes/recipes",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "Clawcipes recipes plugin for OpenClaw (markdown recipes -> scaffold agents/teams)",
   "main": "index.ts",
   "type": "commonjs",
@@ -14,6 +14,7 @@
   },
   "files": [
     "index.ts",
+    "src/",
     "openclaw.plugin.json",
     "recipes/",
     "docs/",
@@ -21,8 +22,10 @@
     "README.md"
   ],
   "scripts": {
-    "test": "npm run smoke",
-    "smoke": "node scripts/scaffold-smoke.mjs"
+    "test": "vitest run",
+    "test:smoke": "node scripts/scaffold-smoke.mjs",
+    "smoke": "node scripts/scaffold-smoke.mjs",
+    "scaffold:smoke": "node scripts/scaffold-smoke.mjs"
   },
   "keywords": [
     "openclaw",
@@ -36,5 +39,8 @@
     "@sinclair/typebox": "^0.34.48",
     "json5": "^2.2.3",
     "yaml": "^2.8.2"
+  },
+  "devDependencies": {
+    "vitest": "^3.2.4"
   }
 }

package/recipes/default/customer-support-team.md

@@ -4,6 +4,20 @@ name: Customer Support Team
 version: 0.1.0
 description: A support workflow team (triage, resolver, kb-writer) that turns cases into replies and knowledge base articles.
 kind: team
+cronJobs:
+  - id: lead-triage-loop
+    name: "Lead triage loop"
+    schedule: "*/30 7-23 * * 1-5"
+    timezone: "America/New_York"
+    message: "Automated lead triage loop: triage inbox/tickets, assign work, and update notes/status.md."
+    enabledByDefault: false
+  - id: execution-loop
+    name: "Execution loop"
+    schedule: "*/30 7-23 * * 1-5"
+    timezone: "America/New_York"
+    message: "Automated execution loop: make progress on in-progress tickets, keep changes small/safe, and update notes/status.md."
+    enabledByDefault: false
+  # pr-watcher omitted (enable only when a real PR integration exists)
 requiredSkills: []
 team:
   teamId: customer-support-team
@@ -55,17 +69,19 @@ templates:
     - inbox/ — incoming cases / requests
     - work/backlog/ — tickets (filename ordered: 0001-...)
     - work/in-progress/ — active tickets
+    - work/testing/ — verification / customer-ready review
     - work/done/ — completed tickets + DONE notes
     - work/cases/ — case records (one per customer issue)
     - work/replies/ — draft replies
     - work/kb/ — KB drafts and macros
     - outbox/ — finalized replies + KB articles
 
-    ## Dispatch loop
+    ## Dispatch loop (mapped to canonical lanes)
     1) Create a case file in work/cases/
-    2) Create a ticket in work/backlog/
-    3) Assign triage → resolver → kb-writer as needed
-    4) Finalize into outbox/
+    2) Create a ticket in work/backlog/ (triage queue)
+    3) Move to work/in-progress/ for resolution + drafting reply
+    4) Move to work/testing/ for verification (customer-ready review)
+    5) Move to work/done/ and finalize into outbox/
 
     ## Quality bar
     - Ask for missing info early.
@@ -117,6 +133,12 @@ templates:
       - step-by-step
     - Include links to docs when relevant.
 
+    ## Verification
+    Before the ticket is moved to done/outbox:
+    - Move the ticket to work/testing/ for verification.
+    - Record verification using notes/QA_CHECKLIST.md.
+    - Preferred: create work/testing/<ticket>.testing-verified.md.
+
   kb-writer.soul: |
     # SOUL.md
 

package/recipes/default/development-team.md

@@ -4,6 +4,20 @@ name: Development Team
 version: 0.2.0
 description: A small engineering team with a shared workspace (lead, dev, devops, test) using file-first tickets.
 kind: team
+cronJobs:
+  - id: lead-triage-loop
+    name: "Lead triage loop"
+    schedule: "*/30 7-23 * * 1-5"
+    timezone: "America/New_York"
+    message: "Automated lead triage loop: triage inbox/tickets, assign work, and update notes/status.md."
+    enabledByDefault: false
+  - id: execution-loop
+    name: "Execution loop"
+    schedule: "*/30 7-23 * * 1-5"
+    timezone: "America/New_York"
+    message: "Automated execution loop: make progress on in-progress tickets, keep changes small/safe, and update notes/status.md."
+    enabledByDefault: false
+  # pr-watcher omitted (enable only when a real PR integration exists)
 requiredSkills: []
 team:
   teamId: development-team

package/recipes/default/product-team.md

@@ -4,6 +4,20 @@ name: Product Team
 version: 0.1.0
 description: A product delivery team (pm, designer, engineer, qa) that turns ideas into shipped features.
 kind: team
+cronJobs:
+  - id: lead-triage-loop
+    name: "Lead triage loop"
+    schedule: "*/30 7-23 * * 1-5"
+    timezone: "America/New_York"
+    message: "Automated lead triage loop: triage inbox/tickets, assign work, and update notes/status.md."
+    enabledByDefault: false
+  - id: execution-loop
+    name: "Execution loop"
+    schedule: "*/30 7-23 * * 1-5"
+    timezone: "America/New_York"
+    message: "Automated execution loop: make progress on in-progress tickets, keep changes small/safe, and update notes/status.md."
+    enabledByDefault: false
+  # pr-watcher omitted (enable only when a real PR integration exists)
 requiredSkills: []
 team:
   teamId: product-team
@@ -32,8 +46,8 @@ agents:
       profile: "coding"
       allow: ["group:fs", "group:web", "group:runtime"]
       deny: []
-  - role: qa
-    name: QA / Test Planner
+  - role: test
+    name: QA / Tester
     tools:
       profile: "coding"
       allow: ["group:fs", "group:web"]
@@ -134,24 +148,27 @@ templates:
     - Implement
     - Write a DONE note with how to test
 
-  qa.soul: |
+  test.soul: |
     # SOUL.md
 
-    You are QA / Test Planner on {{teamId}}.
+    You are QA / Testing on {{teamId}}.
 
-    You create pragmatic test plans and catch edge cases.
+    You verify acceptance criteria, catch edge cases, and document verification results.
 
-  qa.agents: |
+  test.agents: |
     # AGENTS.md
 
     Team directory: {{teamDir}}
 
+    How you work:
+    1) Look in work/testing/ for tickets assigned to you (Owner: test).
+    2) Follow the ticket's "How to test" steps and validate acceptance criteria.
+    3) Record verification using notes/QA_CHECKLIST.md (preferred: a sibling *.testing-verified.md note).
+    4) If PASS: move ticket to work/done/.
+    5) If FAIL: move ticket back to work/in-progress/ with clear repro steps.
+
     Output conventions:
-    - Test plans go in work/test-plans/
-    - Include:
-      - happy path
-      - edge cases
-      - regression checklist
+    - Test plans (optional) go in work/test-plans/
 
   lead.tools: |
     # TOOLS.md
@@ -213,17 +230,17 @@ templates:
 
     - (empty)
 
-  qa.tools: |
+  test.tools: |
     # TOOLS.md
 
-    # Agent-local notes for qa (paths, conventions, env quirks).
+    # Agent-local notes for test (paths, conventions, env quirks).
 
-  qa.status: |
+  test.status: |
     # STATUS.md
 
     - (empty)
 
-  qa.notes: |
+  test.notes: |
     # NOTES.md
 
     - (empty)

package/recipes/default/research-team.md

@@ -4,6 +4,20 @@ name: Research Team
 version: 0.1.0
 description: A research team (lead, researcher, fact-checker, summarizer) that produces sourced briefs and notes.
 kind: team
+cronJobs:
+  - id: lead-triage-loop
+    name: "Lead triage loop"
+    schedule: "*/30 7-23 * * 1-5"
+    timezone: "America/New_York"
+    message: "Automated lead triage loop: triage inbox/tickets, assign work, and update notes/status.md."
+    enabledByDefault: false
+  - id: execution-loop
+    name: "Execution loop"
+    schedule: "*/30 7-23 * * 1-5"
+    timezone: "America/New_York"
+    message: "Automated execution loop: make progress on in-progress tickets, keep changes small/safe, and update notes/status.md."
+    enabledByDefault: false
+  # pr-watcher omitted (enable only when a real PR integration exists)
 requiredSkills: []
 team:
   teamId: research-team
@@ -55,6 +69,7 @@ templates:
     - inbox/ — intake requests
     - work/backlog/ — tickets (filename ordered: 0001-...)
     - work/in-progress/ — active tickets
+    - work/testing/ — verification / fact-check / review
     - work/done/ — completed tickets + DONE notes
     - work/sources/ — source links + captured quotes
     - work/notes/ — working notes
@@ -70,7 +85,8 @@ templates:
     1) Read new items in inbox/
     2) Create a normalized ticket in work/backlog/
     3) Assign an owner (researcher/fact-checker/summarizer)
-    4) When done, consolidate into outbox/
+    4) When ready for verification, move the ticket to work/testing/
+    5) After verification, move to work/done/ and consolidate into outbox/
 
   researcher.soul: |
     # SOUL.md
@@ -117,6 +133,10 @@ templates:
 
     - Write results in work/notes/fact-check-<ticket>.md.
 
+    ## QA verification
+    - When verification is complete, record results using notes/QA_CHECKLIST.md.
+    - Preferred: create work/testing/<ticket>.testing-verified.md.
+
   summarizer.soul: |
     # SOUL.md
 

package/recipes/default/social-team.md

@@ -4,6 +4,20 @@ name: Social Media Team
 version: 0.1.0
 description: A small social media team with a shared workspace (lead, research, writer, editor).
 kind: team
+cronJobs:
+  - id: lead-triage-loop
+    name: "Lead triage loop"
+    schedule: "*/30 7-23 * * 1-5"
+    timezone: "America/New_York"
+    message: "Automated lead triage loop: triage inbox/tickets, assign work, and update notes/status.md."
+    enabledByDefault: false
+  - id: execution-loop
+    name: "Execution loop"
+    schedule: "*/30 7-23 * * 1-5"
+    timezone: "America/New_York"
+    message: "Automated execution loop: make progress on in-progress tickets, keep changes small/safe, and update notes/status.md."
+    enabledByDefault: false
+  # pr-watcher omitted (enable only when a real PR integration exists)
 requiredSkills: []
 team:
   teamId: social-team
@@ -42,11 +56,16 @@ templates:
     Team: {{teamId}}
     Team directory: {{teamDir}}
 
-    Workflow:
-    - Intake: check `inbox/`
-    - Assign: write tasks into `work/assignments/`
-    - Review: consolidate drafts from `work/`
-    - Deliver: finalize into `outbox/`
+    Workflow (mapped to canonical lanes):
+    - backlog → in-progress → testing → done
+    - Intake: check `inbox/` and write tickets into work/backlog/
+    - Drafting: use work/in-progress/ for active drafting
+    - Approval/review: use work/testing/ for review + final checks
+    - Done: move to work/done/ and publish/schedule into outbox/
+
+    QA verification:
+    - Use notes/QA_CHECKLIST.md
+    - Preferred record: work/testing/<ticket>.testing-verified.md
 
   research.soul: |
     # SOUL.md
@@ -93,6 +112,71 @@ templates:
     - Edited drafts go in `work/edited/`.
     - Provide a short changelog at the top.
 
+    ## QA verification (approval)
+    Before moving a deliverable to done/scheduled:
+    - Record verification using notes/QA_CHECKLIST.md.
+    - Preferred: create work/testing/<ticket>.testing-verified.md.
+
+  lead.tools: |
+    # TOOLS.md
+
+    (empty)
+
+  lead.status: |
+    # STATUS.md
+
+    - (empty)
+
+  lead.notes: |
+    # NOTES.md
+
+    - (empty)
+
+  research.tools: |
+    # TOOLS.md
+
+    (empty)
+
+  research.status: |
+    # STATUS.md
+
+    - (empty)
+
+  research.notes: |
+    # NOTES.md
+
+    - (empty)
+
+  writer.tools: |
+    # TOOLS.md
+
+    (empty)
+
+  writer.status: |
+    # STATUS.md
+
+    - (empty)
+
+  writer.notes: |
+    # NOTES.md
+
+    - (empty)
+
+  editor.tools: |
+    # TOOLS.md
+
+    (empty)
+
+  editor.status: |
+    # STATUS.md
+
+    - (empty)
+
+  editor.notes: |
+    # NOTES.md
+
+    - (empty)
+
 
 files:
   - path: SOUL.md

package/recipes/default/writing-team.md

@@ -4,6 +4,20 @@ name: Writing Team
 version: 0.1.0
 description: A writing pipeline (lead, outliner, writer, editor) that produces drafts and polished deliverables.
 kind: team
+cronJobs:
+  - id: lead-triage-loop
+    name: "Lead triage loop"
+    schedule: "*/30 7-23 * * 1-5"
+    timezone: "America/New_York"
+    message: "Automated lead triage loop: triage inbox/tickets, assign work, and update notes/status.md."
+    enabledByDefault: false
+  - id: execution-loop
+    name: "Execution loop"
+    schedule: "*/30 7-23 * * 1-5"
+    timezone: "America/New_York"
+    message: "Automated execution loop: make progress on in-progress tickets, keep changes small/safe, and update notes/status.md."
+    enabledByDefault: false
+  # pr-watcher omitted (enable only when a real PR integration exists)
 requiredSkills: []
 team:
   teamId: writing-team
@@ -54,6 +68,7 @@ templates:
     - inbox/ — requests
     - work/backlog/ — tickets (0001-...)
     - work/in-progress/ — active tickets
+    - work/testing/ — review/edit/QA (verification before publishing)
     - work/done/ — completed tickets + DONE notes
     - work/briefs/ — writing briefs
     - work/outlines/ — outlines
@@ -64,8 +79,9 @@ templates:
     ## Dispatch loop
     1) Intake in inbox/
     2) Brief in work/briefs/
-    3) Assign outline → draft → edit
-    4) Finalize to outbox/
+    3) Assign outline → draft
+    4) Move to work/testing/ for edit/review
+    5) After verification (see notes/QA_CHECKLIST.md), move to work/done/ and finalize to outbox/
 
   outliner.soul: |
     # SOUL.md
@@ -120,6 +136,11 @@ templates:
     - Provide a short changelog at the top.
     - Flag any factual claims that need citations.
 
+    ## QA verification
+    Before a deliverable is marked done/published:
+    - Record verification using notes/QA_CHECKLIST.md.
+    - Preferred: create work/testing/<ticket>.testing-verified.md.
+
   lead.tools: |
     # TOOLS.md
 

package/src/lib/bindings.ts

@@ -0,0 +1,59 @@
+// Minimal extracted binding helper so we can test precedence without running the CLI.
+
+import crypto from 'node:crypto';
+
+export type BindingMatch = {
+  channel?: string;
+  peer?: string;
+  [k: string]: any;
+};
+
+export type BindingSnippet = {
+  agentId: string;
+  match: BindingMatch;
+  to: any;
+  enabled?: boolean;
+};
+
+function stableStringify(obj: any) {
+  const seen = new WeakSet();
+  const walk = (x: any): any => {
+    if (x && typeof x === 'object') {
+      if (seen.has(x)) return '[Circular]';
+      seen.add(x);
+      if (Array.isArray(x)) return x.map(walk);
+      const keys = Object.keys(x).sort();
+      const out: any = {};
+      for (const k of keys) out[k] = walk(x[k]);
+      return out;
+    }
+    return x;
+  };
+  return JSON.stringify(walk(obj));
+}
+
+export function upsertBindingInConfig(cfgObj: any, binding: BindingSnippet) {
+  if (!Array.isArray(cfgObj.bindings)) cfgObj.bindings = [];
+  const list: any[] = cfgObj.bindings;
+
+  const sigPayload = stableStringify({ agentId: binding.agentId, match: binding.match });
+  const sig = crypto.createHash('sha256').update(sigPayload).digest('hex');
+
+  const idx = list.findIndex((b: any) => {
+    const payload = stableStringify({ agentId: b.agentId, match: b.match });
+    const bsig = crypto.createHash('sha256').update(payload).digest('hex');
+    return bsig === sig;
+  });
+
+  if (idx >= 0) {
+    // Update in place (preserve ordering)
+    list[idx] = { ...list[idx], ...binding };
+    return { changed: false as const, note: 'already-present' as const };
+  }
+
+  // Most-specific-first: if a peer match is specified, insert at front so it wins.
+  if (binding.match?.peer) list.unshift(binding);
+  else list.push(binding);
+
+  return { changed: true as const, note: 'added' as const };
+}

package/src/lib/cleanup-workspaces.ts

@@ -0,0 +1,173 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+
+export type CleanupDecision =
+  | { kind: 'candidate'; teamId: string; dirName: string; absPath: string }
+  | { kind: 'skip'; teamId?: string; dirName: string; absPath: string; reason: string };
+
+export type CleanupPlan = {
+  rootDir: string;
+  prefixes: string[];
+  protectedTeamIds: string[];
+  decisions: CleanupDecision[];
+};
+
+export const DEFAULT_ALLOWED_PREFIXES = ['smoke-', 'qa-', 'tmp-', 'test-'] as const;
+export const DEFAULT_PROTECTED_TEAM_IDS = ['development-team'] as const;
+
+async function isDir(p: string) {
+  try {
+    const st = await fs.stat(p);
+    return st.isDirectory();
+  } catch {
+    return false;
+  }
+}
+
+/** Refuse to operate on symlinks (for safety). */
+async function isSymlink(p: string) {
+  try {
+    const st = await fs.lstat(p);
+    return st.isSymbolicLink();
+  } catch {
+    return false;
+  }
+}
+
+export function parseTeamIdFromWorkspaceDirName(dirName: string) {
+  if (!dirName.startsWith('workspace-')) return null;
+  const teamId = dirName.slice('workspace-'.length);
+  return teamId || null;
+}
+
+export function isEligibleTeamId(opts: { teamId: string; prefixes: string[]; protectedTeamIds: string[] }) {
+  const { teamId, prefixes, protectedTeamIds } = opts;
+
+  if (!teamId.endsWith('-team')) return { ok: false, reason: 'teamId does not end with -team' } as const;
+
+  if (protectedTeamIds.includes(teamId.replace(/-team$/, ''))) {
+    // Back-compat: protect by base id too if someone passes development-team-team etc.
+    return { ok: false, reason: 'protected teamId' } as const;
+  }
+  if (protectedTeamIds.includes(teamId)) return { ok: false, reason: 'protected teamId' } as const;
+
+  const okPrefix = prefixes.some((p) => teamId.startsWith(p));
+  if (!okPrefix) return { ok: false, reason: `teamId does not start with an allowed prefix (${prefixes.join(', ')})` } as const;
+
+  return { ok: true } as const;
+}
+
+/**
+ * Build a safe cleanup plan for workspace-<teamId> directories under rootDir.
+ *
+ * Safety rails:
+ * - only directories named workspace-<teamId>
+ * - teamId must end with -team and start with an allowed prefix
+ * - protected teamIds are always skipped
+ * - refuses symlinks
+ * - resolved path must remain within rootDir
+ */
+export async function planWorkspaceCleanup(opts: {
+  rootDir: string;
+  prefixes?: string[];
+  protectedTeamIds?: string[];
+}) {
+  const rootDir = path.resolve(opts.rootDir);
+  const prefixes = (opts.prefixes?.length ? opts.prefixes : [...DEFAULT_ALLOWED_PREFIXES]) as string[];
+  const protectedTeamIds = (opts.protectedTeamIds?.length ? opts.protectedTeamIds : [...DEFAULT_PROTECTED_TEAM_IDS]) as string[];
+
+  const decisions: CleanupDecision[] = [];
+
+  let entries: string[] = [];
+  try {
+    entries = await fs.readdir(rootDir);
+  } catch (e: any) {
+    return {
+      rootDir,
+      prefixes,
+      protectedTeamIds,
+      decisions: [
+        {
+          kind: 'skip',
+          dirName: rootDir,
+          absPath: rootDir,
+          reason: `failed to read rootDir: ${e?.message ? String(e.message) : String(e)}`,
+        },
+      ],
+    } satisfies CleanupPlan;
+  }
+
+  for (const dirName of entries) {
+    if (!dirName.startsWith('workspace-')) continue;
+
+    const absPath = path.join(rootDir, dirName);
+
+    if (!(await isDir(absPath))) continue;
+
+    const teamId = parseTeamIdFromWorkspaceDirName(dirName);
+    if (!teamId) {
+      decisions.push({ kind: 'skip', dirName, absPath, reason: 'could not parse teamId' });
+      continue;
+    }
+
+    if (await isSymlink(absPath)) {
+      decisions.push({ kind: 'skip', teamId, dirName, absPath, reason: 'refusing to operate on symlink' });
+      continue;
+    }
+
+    const real = await fs.realpath(absPath);
+    const rootReal = await fs.realpath(rootDir);
+    if (!real.startsWith(rootReal + path.sep) && real !== rootReal) {
+      decisions.push({ kind: 'skip', teamId, dirName, absPath, reason: 'resolved path escapes rootDir' });
+      continue;
+    }
+
+    const elig = isEligibleTeamId({ teamId, prefixes, protectedTeamIds });
+    if (!elig.ok) {
+      decisions.push({ kind: 'skip', teamId, dirName, absPath, reason: elig.reason });
+      continue;
+    }
+
+    decisions.push({ kind: 'candidate', teamId, dirName, absPath });
+  }
+
+  return { rootDir, prefixes, protectedTeamIds, decisions } satisfies CleanupPlan;
+}
+
+export async function executeWorkspaceCleanup(plan: CleanupPlan, opts: { yes: boolean }) {
+  const candidates = plan.decisions.filter((d): d is Extract<CleanupDecision, { kind: 'candidate' }> => d.kind === 'candidate');
+  const skipped = plan.decisions.filter((d): d is Extract<CleanupDecision, { kind: 'skip' }> => d.kind === 'skip');
+
+  if (!opts.yes) {
+    return {
+      ok: true,
+      dryRun: true,
+      rootDir: plan.rootDir,
+      candidates,
+      skipped,
+      deleted: [] as string[],
+    };
+  }
+
+  const deleted: string[] = [];
+  const deleteErrors: Array<{ path: string; error: string }> = [];
+
+  for (const c of candidates) {
+    try {
+      await fs.rm(c.absPath, { recursive: true, force: true });
+      deleted.push(c.absPath);
+    } catch (e: any) {
+      deleteErrors.push({ path: c.absPath, error: e?.message ? String(e.message) : String(e) });
+    }
+  }
+
+  return {
+    ok: deleteErrors.length === 0,
+    dryRun: false,
+    rootDir: plan.rootDir,
+    candidates,
+    skipped,
+    deleted,
+    deleteErrors,
+  };
+}

package/src/lib/index.ts

@@ -0,0 +1,5 @@
+export * from './scaffold-templates';
+export * from './bindings';
+export * from './ticket-workflow';
+export * from './recipe-frontmatter';
+export * from './shared-context';