@jiggai/recipes 0.4.21 → 0.4.22

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "recipes",
   "name": "Recipes",
   "description": "Markdown recipes that scaffold agents and teams (workspace-local).",
-  "version": "0.4.21",
+  "version": "0.4.22",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jiggai/recipes",
-  "version": "0.4.21",
+  "version": "0.4.22",
   "description": "ClawRecipes plugin for OpenClaw (markdown recipes -> scaffold agents/teams)",
   "main": "index.ts",
   "type": "commonjs",

package/recipes/default/business-team.md

@@ -237,8 +237,8 @@ templates:
   ops.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: ops
 
     ## Guardrails (read → act → write)
@@ -267,8 +267,8 @@ templates:
   sales.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: sales
 
     ## Guardrails (read → act → write)
@@ -297,8 +297,8 @@ templates:
   marketing.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: marketing
 
     ## Guardrails (read → act → write)
@@ -327,8 +327,8 @@ templates:
   finance.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: finance
 
     ## Guardrails (read → act → write)
@@ -357,7 +357,28 @@ templates:
   analyst.agents: |
     # AGENTS.md
 
-    Output:
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
+    Role: analyst
+
+    ## Guardrails (read → act → write)
+    Before you act:
+    1) Read:
+       - `../notes/plan.md`
+       - `../notes/status.md`
+       - relevant ticket(s) in `work/in-progress/`
+       - any relevant shared context under `shared-context/`
+
+    After you act:
+    1) Write back:
+       - Put outputs in the agreed folder (usually `outbox/` or a ticket file).
+       - Update the ticket with what you did and where the artifact is.
+
+    ## Workflow
+    - Prefer a pull model: wait for a clear task from the lead, or propose a scoped task.
+    - Keep work small and reversible.
+
+    ## Output locations
     - Research briefs → outbox/research/
     - Metrics definitions/dashboards notes → shared-context/metrics/
 
@@ -491,6 +512,9 @@ files:
   - path: shared-context/priorities.md
     template: sharedContext.priorities
     mode: createOnly
+  - path: shared-context/MEMORY_PLAN.md
+    template: sharedContext.memoryPlan
+    mode: createOnly
   - path: shared-context/agent-outputs/README.md
     template: sharedContext.agentOutputsReadme
     mode: createOnly

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

@@ -209,8 +209,8 @@ templates:
   triage.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: triage
 
     ## Guardrails (read → act → write)
@@ -239,8 +239,8 @@ templates:
   resolver.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: resolver
 
     ## Guardrails (read → act → write)
@@ -269,8 +269,8 @@ templates:
   kb-writer.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: kb-writer
 
     ## Guardrails (read → act → write)
@@ -380,6 +380,9 @@ files:
   - path: shared-context/priorities.md
     template: sharedContext.priorities
     mode: createOnly
+  - path: shared-context/MEMORY_PLAN.md
+    template: sharedContext.memoryPlan
+    mode: createOnly
   - path: shared-context/agent-outputs/README.md
     template: sharedContext.agentOutputsReadme
     mode: createOnly

package/recipes/default/marketing-team.md

@@ -92,6 +92,12 @@ cronJobs:
     message: "Safe-idle loop: check for lifecycle/email work, make progress, and write outputs under roles/lifecycle/agent-outputs/."
     enabledByDefault: false
 
+  # NOTE: Workflow worker crons are NOT defined here.
+  # ClawKitchen installs them on-demand when the user visits a workflow editor
+  # and clicks "Install worker cron(s)" or triggers a run. This avoids duplicate
+  # crons between recipe scaffolding and Kitchen's reconciliation.
+  # Kitchen stores provenance in workspace-<teamId>/notes/cron-jobs.json.
+
   # Optional team-wide loop (off by default): can be enabled later if you want an extra generic executor.
   - id: execution-loop
     name: "Execution loop"

package/recipes/default/product-team.md

@@ -212,8 +212,8 @@ templates:
   pm.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: pm
 
     ## Guardrails (read → act → write)
@@ -242,8 +242,8 @@ templates:
   designer.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: designer
 
     ## Guardrails (read → act → write)
@@ -272,8 +272,8 @@ templates:
   engineer.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: engineer
 
     ## Guardrails (read → act → write)
@@ -302,8 +302,8 @@ templates:
   test.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: test
 
     ## Guardrails (read → act → write)
@@ -428,6 +428,9 @@ files:
   - path: shared-context/priorities.md
     template: sharedContext.priorities
     mode: createOnly
+  - path: shared-context/MEMORY_PLAN.md
+    template: sharedContext.memoryPlan
+    mode: createOnly
   - path: shared-context/agent-outputs/README.md
     template: sharedContext.agentOutputsReadme
     mode: createOnly

package/recipes/default/research-team.md

@@ -209,8 +209,8 @@ templates:
   researcher.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: researcher
 
     ## Guardrails (read → act → write)
@@ -239,8 +239,8 @@ templates:
   fact-checker.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: fact-checker
 
     ## Guardrails (read → act → write)
@@ -269,8 +269,8 @@ templates:
   summarizer.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: summarizer
 
     ## Guardrails (read → act → write)
@@ -380,6 +380,9 @@ files:
   - path: shared-context/priorities.md
     template: sharedContext.priorities
     mode: createOnly
+  - path: shared-context/MEMORY_PLAN.md
+    template: sharedContext.memoryPlan
+    mode: createOnly
   - path: shared-context/agent-outputs/README.md
     template: sharedContext.agentOutputsReadme
     mode: createOnly

package/recipes/default/social-team.md

@@ -224,8 +224,8 @@ templates:
   research.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: research
 
     ## Guardrails (read → act → write)
@@ -259,8 +259,8 @@ templates:
   listening.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: listening
 
     ## Guardrails (read → act → write)
@@ -294,8 +294,8 @@ templates:
   social-seo.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: social-seo
 
     ## Guardrails (read → act → write)
@@ -329,8 +329,8 @@ templates:
   editorial.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: editorial
 
     ## Guardrails (read → act → write)
@@ -364,8 +364,8 @@ templates:
   community.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: community
 
     ## Guardrails (read → act → write)
@@ -399,8 +399,8 @@ templates:
   distributor.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: distributor
 
     ## Guardrails (read → act → write)
@@ -434,8 +434,8 @@ templates:
   tiktok.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: tiktok
 
     ## Guardrails (read → act → write)
@@ -469,8 +469,8 @@ templates:
   instagram.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: instagram
 
     ## Guardrails (read → act → write)
@@ -504,8 +504,8 @@ templates:
   youtube.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: youtube
 
     ## Guardrails (read → act → write)
@@ -539,8 +539,8 @@ templates:
   facebook.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: facebook
 
     ## Guardrails (read → act → write)
@@ -574,8 +574,8 @@ templates:
   x.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: x
 
     ## Guardrails (read → act → write)
@@ -609,8 +609,8 @@ templates:
   linkedin.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: linkedin
 
     ## Guardrails (read → act → write)
@@ -856,6 +856,9 @@ files:
   - path: shared-context/priorities.md
     template: sharedContext.priorities
     mode: createOnly
+  - path: shared-context/MEMORY_PLAN.md
+    template: sharedContext.memoryPlan
+    mode: createOnly
   - path: shared-context/agent-outputs/README.md
     template: sharedContext.agentOutputsReadme
     mode: createOnly

package/recipes/default/writing-team.md

@@ -206,8 +206,8 @@ templates:
   outliner.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: outliner
 
     ## Guardrails (read → act → write)
@@ -236,8 +236,8 @@ templates:
   writer.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: writer
 
     ## Guardrails (read → act → write)
@@ -266,8 +266,8 @@ templates:
   editor.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: editor
 
     ## Guardrails (read → act → write)
@@ -377,6 +377,9 @@ files:
   - path: shared-context/priorities.md
     template: sharedContext.priorities
     mode: createOnly
+  - path: shared-context/MEMORY_PLAN.md
+    template: sharedContext.memoryPlan
+    mode: createOnly
   - path: shared-context/agent-outputs/README.md
     template: sharedContext.agentOutputsReadme
     mode: createOnly

package/src/handlers/cron.ts

@@ -19,7 +19,7 @@ function interpolateTemplate(input: string | undefined, vars: Record<string, str
 
 function applyCronJobVars(
   scope: CronReconcileScope,
-  j: { id: string; name?: string; schedule?: string; timezone?: string; channel?: string; to?: string; agentId?: string; description?: string; message?: string; enabledByDefault?: boolean },
+  j: { id: string; name?: string; schedule?: string; timezone?: string; channel?: string; to?: string; agentId?: string; description?: string; message?: string; enabledByDefault?: boolean; delivery?: 'none' | 'announce' },
 ): typeof j {
   const vars: Record<string, string> = {
     recipeId: scope.recipeId,
@@ -64,7 +64,7 @@ type CronReconcileScope =
 
 function buildCronJobForCreate(
   scope: CronReconcileScope,
-  j: { id: string; name?: string; schedule?: string; timezone?: string; channel?: string; to?: string; agentId?: string; description?: string; message?: string; enabledByDefault?: boolean },
+  j: { id: string; name?: string; schedule?: string; timezone?: string; channel?: string; to?: string; agentId?: string; description?: string; message?: string; enabledByDefault?: boolean; delivery?: 'none' | 'announce' },
   wantEnabled: boolean
 ): Record<string, unknown> {
   const name =
@@ -91,21 +91,23 @@ function buildCronJobForCreate(
     sessionTarget,
     schedule: { kind: "cron", expr: j.schedule, ...(j.timezone ? { tz: j.timezone } : {}) },
     payload: effectiveAgentId ? { kind: "agentTurn", message: j.message } : { kind: "systemEvent", text: j.message },
-    ...(j.channel || j.to
-      ? {
-          delivery: {
-            mode: "announce",
-            ...(j.channel ? { channel: j.channel } : {}),
-            ...(j.to ? { to: j.to } : {}),
-            bestEffort: true,
-          },
-        }
-      : {}),
+    ...(j.delivery === 'none'
+      ? { delivery: { mode: "none" } }
+      : j.channel || j.to
+        ? {
+            delivery: {
+              mode: "announce",
+              ...(j.channel ? { channel: j.channel } : {}),
+              ...(j.to ? { to: j.to } : {}),
+              bestEffort: true,
+            },
+          }
+        : {}),
   };
 }
 
 function buildCronJobPatch(
-  j: { name?: string; schedule?: string; timezone?: string; channel?: string; to?: string; agentId?: string; description?: string; message?: string },
+  j: { name?: string; schedule?: string; timezone?: string; channel?: string; to?: string; agentId?: string; description?: string; message?: string; delivery?: 'none' | 'announce' },
   name: string
 ): CronJobPatch {
   const effectiveAgentId = typeof j.agentId === "string" && j.agentId.trim() ? j.agentId.trim() : undefined;
@@ -119,7 +121,9 @@ function buildCronJobPatch(
     schedule: { kind: "cron", expr: j.schedule, ...(j.timezone ? { tz: j.timezone } : {}) },
     payload: effectiveAgentId ? { kind: "agentTurn", message: j.message } : { kind: "systemEvent", text: j.message },
   };
-  if (j.channel || j.to) {
+  if (j.delivery === 'none') {
+    patch.delivery = { mode: "none" };
+  } else if (j.channel || j.to) {
     patch.delivery = {
       mode: "announce",
       ...(j.channel ? { channel: j.channel } : {}),
@@ -229,11 +233,16 @@ async function cronAdd(api: OpenClawPluginApi, job: Record<string, unknown>): Pr
 
   // delivery
   const delivery = j.delivery;
-  if (delivery && typeof delivery === "object" && String(delivery.mode ?? "") === "announce") {
-    argv.push("--announce");
-    if (delivery.channel) argv.push("--channel", String(delivery.channel));
-    if (delivery.to) argv.push("--to", String(delivery.to));
-    if (delivery.bestEffort) argv.push("--best-effort-deliver");
+  if (delivery && typeof delivery === "object") {
+    const deliveryMode = String(delivery.mode ?? "");
+    if (deliveryMode === "announce") {
+      argv.push("--announce");
+      if (delivery.channel) argv.push("--channel", String(delivery.channel));
+      if (delivery.to) argv.push("--to", String(delivery.to));
+      if (delivery.bestEffort) argv.push("--best-effort-deliver");
+    } else if (deliveryMode === "none") {
+      argv.push("--no-deliver");
+    }
   }
 
   const result = await api.runtime.system.runCommandWithTimeout(argv, { timeoutMs: 30_000 });

package/src/handlers/team.ts

@@ -140,6 +140,45 @@ Default behavior: **quiet**. If there is nothing to report, do nothing.
   await writeFileSafely(path.join(teamDir, "TICKETS.md"), ticketsMd, mode);
 }
 
+/**
+ * Write team-level files from the recipe files[] array.
+ *
+ * Per-role scaffolding (scaffoldTeamAgents) filters out paths starting with
+ * "shared-context/" and "notes/" because those belong to the team workspace root,
+ * not individual role directories. This function picks up those filtered paths
+ * and writes them to teamDir using the recipe's templates.
+ */
+async function writeTeamLevelRecipeFiles(opts: {
+  recipe: RecipeFrontmatter;
+  teamId: string;
+  teamDir: string;
+  overwrite: boolean;
+}) {
+  const { recipe, teamId, teamDir, overwrite } = opts;
+  const files = recipe.files ?? [];
+  if (!files.length) return;
+  const mode = overwrite ? "overwrite" : "createOnly";
+  const templates = (recipe.templates ?? {}) as Record<string, unknown>;
+  const vars = { teamId, teamDir };
+
+  for (const f of files) {
+    const filePath = String(f.path ?? "").trim();
+    if (!filePath) continue;
+    // Only process paths that are team-scoped (filtered out of per-role scaffolding).
+    if (!filePath.startsWith("shared-context/") && !filePath.startsWith("notes/")) continue;
+
+    const templateKey = String(f.template ?? "").trim();
+    if (!templateKey) continue;
+
+    const templateContent = templates[templateKey];
+    if (typeof templateContent !== "string") continue;
+
+    const rendered = renderTemplate(templateContent, vars);
+    const target = path.join(teamDir, filePath);
+    await writeFileSafely(target, rendered, mode);
+  }
+}
+
 async function writeTeamMetadataAndConfig(opts: {
   api: OpenClawPluginApi;
   teamId: string;
@@ -392,6 +431,8 @@ export async function handleScaffoldTeam(
   const { loaded, recipe, cfg, workspaceRoot: baseWorkspace } = validation;
 
   // Lint (warn-only) for common team scaffolding pitfalls.
+  // NOTE: console.warn/error used throughout src/ for [recipes]-prefixed diagnostics.
+  // No plugin SDK logger available; these go to stderr which the host captures.
   for (const issue of lintRecipe(recipe)) {
     if (issue.level === "warn") console.warn(`[recipes] WARN ${issue.code}: ${issue.message}`);
     else console.warn(`[recipes] ${issue.code}: ${issue.message}`);
@@ -439,6 +480,11 @@ export async function handleScaffoldTeam(
     overwrite,
     qaChecklist,
   });
+  // Write team-level files from the recipe files[] array.
+  // Per-role scaffolding filters out shared-context/ and notes/ paths (those belong to teamDir).
+  // We render and write them here so recipe-defined team assets are not silently dropped.
+  await writeTeamLevelRecipeFiles({ recipe, teamId, teamDir, overwrite });
+
   const heartbeat = buildHeartbeatCronJobsFromTeamRecipe({
     teamId,
     recipe,

package/src/lib/recipe-frontmatter.ts

@@ -11,6 +11,8 @@ export type CronJobSpec = {
   to?: string;
   agentId?: string;
   enabledByDefault?: boolean;
+  /** Delivery mode: "none" suppresses announce; "announce" delivers to chat. Omit to use gateway default. */
+  delivery?: 'none' | 'announce';
 };
 
 /** Raw input for a cron job from YAML (supports message/task/prompt for backward compat). */
@@ -27,6 +29,7 @@ type CronJobInput = {
   to?: unknown;
   agentId?: unknown;
   enabledByDefault?: unknown;
+  delivery?: unknown;
 };
 
 export type RecipeFrontmatter = {
@@ -83,6 +86,7 @@ function buildCronJobSpec(j: CronJobInput, id: string): CronJobSpec {
     to: j.to != null ? String(j.to) : undefined,
     agentId: j.agentId != null ? String(j.agentId) : undefined,
     enabledByDefault: Boolean(j.enabledByDefault ?? false),
+    delivery: j.delivery === 'none' || j.delivery === 'announce' ? j.delivery : undefined,
   };
 }