@jiggai/kitchen 0.3.1 → 0.3.3

package/src/app/api/swarms/start/route.ts

@@ -1,100 +0,0 @@
-import fs from "node:fs/promises";
-import os from "node:os";
-import path from "node:path";
-
-import { NextResponse } from "next/server";
-
-import { errorMessage } from "@/lib/errors";
-import { getKitchenApi } from "@/lib/kitchen-api";
-import { normalizeId, resolveAgentWorkspace } from "@/lib/swarms";
-
-export async function POST(req: Request) {
-  try {
-    const body = (await req.json()) as {
-      orchestratorAgentId?: string;
-      agentId?: string; // compat
-      taskId?: string;
-      spec?: string;
-      specFile?: string;
-      baseRef?: string;
-      branch?: string;
-      tmuxSession?: string;
-      agent?: "codex" | "claude";
-      model?: string;
-      reasoning?: "low" | "medium" | "high";
-      timeoutMs?: number;
-    };
-
-    const orchestratorAgentId = normalizeId("orchestratorAgentId", String(body.orchestratorAgentId ?? body.agentId ?? ""));
-    const taskId = normalizeId("taskId", String(body.taskId ?? ""));
-
-    const spec = typeof body.spec === "string" ? body.spec : "";
-    const specFile = typeof body.specFile === "string" ? body.specFile : "";
-    if (!!spec === !!specFile) {
-      throw new Error("Provide exactly one of spec or specFile");
-    }
-
-    const orchestratorWs = await resolveAgentWorkspace(orchestratorAgentId);
-    const cliPath = path.join(orchestratorWs, ".clawdbot", "task.sh");
-
-    // Prefer spec-file to avoid shell quoting surprises.
-    let effectiveSpecFile = specFile;
-    let tmpToCleanup: string | null = null;
-
-    if (spec) {
-      const tmp = path.join(os.tmpdir(), `clawkitchen-swarm-${taskId}-${Date.now()}.md`);
-      await fs.writeFile(tmp, spec, "utf8");
-      effectiveSpecFile = tmp;
-      tmpToCleanup = tmp;
-    }
-
-    // Basic existence checks for actionable errors.
-    await fs.access(cliPath);
-
-    const timeoutMs = Number.isFinite(body.timeoutMs) ? Number(body.timeoutMs) : 120000;
-
-    const args: string[] = [
-      "bash",
-      cliPath,
-      "start",
-      "--task-id",
-      taskId,
-      "--spec-file",
-      effectiveSpecFile,
-    ];
-
-    if (typeof body.baseRef === "string" && body.baseRef.trim()) {
-      args.push("--base-ref", body.baseRef.trim());
-    }
-    if (typeof body.branch === "string" && body.branch.trim()) {
-      args.push("--branch", body.branch.trim());
-    }
-    if (typeof body.tmuxSession === "string" && body.tmuxSession.trim()) {
-      args.push("--tmux-session", body.tmuxSession.trim());
-    }
-    if (typeof body.agent === "string" && body.agent.trim()) {
-      args.push("--agent", body.agent.trim());
-    }
-    if (typeof body.model === "string" && body.model.trim()) {
-      args.push("--model", body.model.trim());
-    }
-    if (typeof body.reasoning === "string" && body.reasoning.trim()) {
-      args.push("--reasoning", body.reasoning.trim());
-    }
-
-    const api = getKitchenApi();
-    const res = await api.runtime.system.runCommandWithTimeout(args, { timeoutMs });
-
-    // best-effort tmp cleanup (fire-and-forget)
-    if (tmpToCleanup) {
-      fs.unlink(tmpToCleanup).catch(() => {});
-    }
-
-    return NextResponse.json({ ok: true, orchestratorWorkspace: orchestratorWs, stdout: res.stdout, stderr: res.stderr });
-  } catch (err: unknown) {
-    const msg = errorMessage(err);
-    const isClientError = /required|match \//i.test(msg) || msg.includes("Provide exactly one");
-    const status = isClientError ? 400 : 500;
-    return NextResponse.json({ ok: false, error: msg }, { status });
-  }
-}

package/src/app/api/swarms/status/route.ts

@@ -1,31 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-
-import { NextResponse } from "next/server";
-
-import { errorMessage } from "@/lib/errors";
-import { getKitchenApi } from "@/lib/kitchen-api";
-import { normalizeId, resolveAgentWorkspace } from "@/lib/swarms";
-
-export async function GET(req: Request) {
-  try {
-    const url = new URL(req.url);
-    const orchestratorAgentId = normalizeId(
-      "orchestratorAgentId",
-      url.searchParams.get("orchestratorAgentId") || url.searchParams.get("agentId") || "",
-    );
-
-    const orchestratorWs = await resolveAgentWorkspace(orchestratorAgentId);
-    const cliPath = path.join(orchestratorWs, ".clawdbot", "task.sh");
-    await fs.access(cliPath);
-
-    const api = getKitchenApi();
-    const res = await api.runtime.system.runCommandWithTimeout(["bash", cliPath, "status"], { timeoutMs: 30000 });
-
-    return NextResponse.json({ ok: true, orchestratorWorkspace: orchestratorWs, stdout: res.stdout, stderr: res.stderr });
-  } catch (err: unknown) {
-    const msg = errorMessage(err);
-    const status = /required|match \//i.test(msg) ? 400 : 500;
-    return NextResponse.json({ ok: false, error: msg }, { status });
-  }
-}

package/src/app/api/teams/[teamId]/tickets/assign/route.ts

@@ -1,105 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-import { NextResponse } from "next/server";
-import { getTicketByIdOrNumber, listTickets, stageDir, type TicketStage } from "@/lib/tickets";
-import { getWorkspaceDir, teamDirFromBaseWorkspace } from "@/lib/paths";
-
-export const dynamic = "force-dynamic";
-
-type TicketFlowConfig = {
-  laneByOwner?: Record<string, TicketStage>;
-  defaultLane?: TicketStage;
-};
-
-async function loadTicketFlowConfig(teamDir: string): Promise<TicketFlowConfig | null> {
-  const p = path.join(teamDir, "shared-context", "ticket-flow.json");
-  try {
-    const raw = await fs.readFile(p, "utf8");
-    const parsed = JSON.parse(raw) as TicketFlowConfig;
-    // Best-effort validation.
-    if (!parsed || typeof parsed !== "object") return null;
-    return parsed;
-  } catch {
-    return null;
-  }
-}
-
-async function desiredStageForAssignee(opts: {
-  teamDir: string;
-  assignee: string | null;
-  currentStage: TicketStage;
-}): Promise<TicketStage> {
-  const config = await loadTicketFlowConfig(opts.teamDir);
-  if (!config) return opts.currentStage;
-
-  const key = (opts.assignee ?? "").trim();
-  if (key && config.laneByOwner && typeof config.laneByOwner[key] === "string") {
-    return config.laneByOwner[key] as TicketStage;
-  }
-
-  if (config.defaultLane) return config.defaultLane;
-  return opts.currentStage;
-}
-
-function upsertField(md: string, field: string, value: string) {
-  const re = new RegExp(`^${field}:\\s*.*$`, "mi");
-  if (re.test(md)) return md.replace(re, `${field}: ${value}`);
-
-  // Insert after the first header line, or at top if no header.
-  const lines = md.split("\n");
-  const headerIdx = lines.findIndex((l) => l.startsWith("# "));
-  const insertAt = headerIdx >= 0 ? headerIdx + 1 : 0;
-  lines.splice(insertAt, 0, `${field}: ${value}`);
-  return lines.join("\n");
-}
-
-async function ensureDir(p: string) {
-  await fs.mkdir(p, { recursive: true });
-}
-
-export async function POST(
-  req: Request,
-  { params }: { params: Promise<{ teamId: string }> },
-) {
-  const { teamId } = await params;
-
-  const body = (await req.json().catch(() => null)) as null | {
-    ticket: string;
-    assignee: string;
-  };
-
-  if (!body?.ticket || !body?.assignee) {
-    return NextResponse.json({ error: "Missing ticket or assignee" }, { status: 400 });
-  }
-
-  const baseWorkspace = await getWorkspaceDir();
-  const teamDir = teamDirFromBaseWorkspace(baseWorkspace, teamId);
-
-  const ticket = await getTicketByIdOrNumber(body.ticket, teamDir);
-  if (!ticket) {
-    return NextResponse.json({ error: "Ticket not found" }, { status: 404 });
-  }
-
-  const assignee = body.assignee.trim();
-  const nextStage = await desiredStageForAssignee({ teamDir, assignee, currentStage: ticket.stage });
-
-  const currentMd = await fs.readFile(ticket.file, "utf8");
-  let updatedMd = upsertField(currentMd, "Owner", assignee);
-  updatedMd = upsertField(updatedMd, "Status", nextStage);
-
-  const filename = path.basename(ticket.file);
-  const nextPath = path.join(stageDir(nextStage, teamDir), filename);
-
-  await ensureDir(stageDir(nextStage, teamDir));
-
-  if (ticket.file !== nextPath) {
-    await fs.rename(ticket.file, nextPath);
-  }
-
-  await fs.writeFile(nextPath, updatedMd, "utf8");
-
-  // Assignment stubs are deprecated; do not create/update work/assignments/*.md.
-
-  const refreshed = (await listTickets(teamDir)).find((t) => t.number === ticket.number);
-  return NextResponse.json({ ok: true, ticket: refreshed ?? null });
-}

package/src/app/api/teams/[teamId]/tickets/assignees/route.ts

@@ -1,27 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-import { NextResponse } from "next/server";
-import { getWorkspaceDir, teamDirFromBaseWorkspace } from "@/lib/paths";
-
-export const dynamic = "force-dynamic";
-
-export async function GET(
-  _req: Request,
-  { params }: { params: Promise<{ teamId: string }> },
-) {
-  const { teamId } = await params;
-
-  const baseWorkspace = await getWorkspaceDir();
-  const teamDir = teamDirFromBaseWorkspace(baseWorkspace, teamId);
-  const rolesDir = path.join(teamDir, "roles");
-
-  let entries: string[] = [];
-  try {
-    entries = await fs.readdir(rolesDir);
-  } catch {
-    entries = [];
-  }
-
-  const assignees = entries.filter((e) => !e.startsWith(".")).sort();
-  return NextResponse.json({ assignees });
-}

package/src/app/api/teams/[teamId]/tickets/delete/route.ts

@@ -1,55 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-
-import { NextResponse } from "next/server";
-
-import { errorMessage } from "@/lib/errors";
-import { resolveTicket, teamWorkspace } from "@/lib/tickets";
-
-function pad4(n: number) {
-  return String(n).padStart(4, "0");
-}
-
-export async function POST(req: Request, ctx: { params: Promise<{ teamId: string }> }) {
-  try {
-    const { teamId } = await ctx.params;
-    const body = await req.json();
-    const ticket = String(body.ticket ?? "").trim();
-
-    if (!ticket) {
-      return NextResponse.json({ ok: false, error: "Missing ticket" }, { status: 400 });
-    }
-
-    const hit = await resolveTicket(teamId, ticket);
-    if (!hit) {
-      return NextResponse.json({ ok: false, error: `Ticket not found: ${ticket}` }, { status: 404 });
-    }
-
-    // Remove ticket file.
-    await fs.unlink(hit.file);
-
-    // Archive any assignment stubs (safer than deleting outright).
-    const assignmentsDir = path.join(teamWorkspace(teamId), "work/assignments");
-    const deletedDir = path.join(assignmentsDir, "deleted");
-    await fs.mkdir(deletedDir, { recursive: true });
-
-    const moved: string[] = [];
-    try {
-      const files = await fs.readdir(assignmentsDir);
-      const prefix = `${pad4(hit.number)}-assigned-`;
-      for (const f of files) {
-        if (!f.startsWith(prefix) || !f.endsWith(".md")) continue;
-        const from = path.join(assignmentsDir, f);
-        const to = path.join(deletedDir, f);
-        await fs.rename(from, to);
-        moved.push(f);
-      }
-    } catch {
-      // ignore
-    }
-
-    return NextResponse.json({ ok: true, archivedAssignments: moved });
-  } catch (e: unknown) {
-    return NextResponse.json({ ok: false, error: errorMessage(e) }, { status: 500 });
-  }
-}

package/src/app/api/teams/[teamId]/tickets/move/route.ts

@@ -1,70 +0,0 @@
-import fs from "node:fs/promises";
-
-import { NextResponse } from "next/server";
-
-import { runOpenClaw } from "@/lib/openclaw";
-import { getTicketMarkdown } from "@/lib/tickets";
-
-function todayUtc() {
-  return new Date().toISOString().slice(0, 10);
-}
-
-async function appendDoneAuditComment(teamId: string, ticketIdOrNumber: string) {
-  const hit = await getTicketMarkdown(teamId, ticketIdOrNumber);
-  if (!hit) return;
-
-  const line = `- ${todayUtc()} (ClawKitchen UI): Marked done from ClawKitchen UI.`;
-  if (hit.markdown.includes(line)) return;
-
-  const hasComments = /\n## Comments\n/i.test(hit.markdown) || /^## Comments\n/im.test(hit.markdown);
-
-  let next = hit.markdown;
-  if (!hasComments) {
-    next = next.replace(/\s*$/, "\n\n## Comments\n");
-  }
-
-  // Append at end; this keeps the operation simple and avoids brittle section parsing.
-  next = next.replace(/\s*$/, "\n" + line + "\n");
-
-  await fs.writeFile(hit.file, next, "utf8");
-}
-
-export async function POST(req: Request, ctx: { params: Promise<{ teamId: string }> }) {
-  try {
-    const { teamId } = await ctx.params;
-    const body = await req.json();
-    const ticket = String(body.ticket ?? "").trim();
-    const to = String(body.to ?? "").trim();
-
-    if (!ticket) {
-      return NextResponse.json({ ok: false, error: "Missing ticket" }, { status: 400 });
-    }
-    if (!to || !["backlog", "in-progress", "testing", "done"].includes(to)) {
-      return NextResponse.json({ ok: false, error: "Invalid destination stage" }, { status: 400 });
-    }
-
-    const args = [
-      "recipes",
-      "move-ticket",
-      "--team-id",
-      teamId,
-      "--ticket",
-      ticket,
-      "--to",
-      to,
-      "--yes",
-    ];
-
-    const res = await runOpenClaw(args);
-    if (!res.ok) throw new Error(res.stderr || `openclaw exit ${res.exitCode}`);
-
-    if (to === "done") {
-      await appendDoneAuditComment(teamId, ticket);
-    }
-
-    return NextResponse.json({ ok: true });
-  } catch (err: unknown) {
-    const message = err instanceof Error ? err.message : String(err);
-    return NextResponse.json({ ok: false, error: message }, { status: 500 });
-  }
-}

package/src/app/api/teams/[teamId]/tickets/move-to-goals/route.ts

@@ -1,56 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-
-import { NextResponse } from "next/server";
-
-import { errorMessage } from "@/lib/errors";
-import { resolveTicket, teamWorkspace } from "@/lib/tickets";
-
-function todayUtc() {
-  return new Date().toISOString().slice(0, 10);
-}
-
-async function appendGoalsAuditComment(file: string) {
-  const md = await fs.readFile(file, "utf8");
-  const line = `- ${todayUtc()} (ClawKitchen UI): Moved to Goals from ClawKitchen UI.`;
-  if (md.includes(line)) return;
-
-  const hasComments = /\n## Comments\n/i.test(md) || /^## Comments\n/im.test(md);
-
-  let next = md;
-  if (!hasComments) {
-    next = next.replace(/\s*$/, "\n\n## Comments\n");
-  }
-  next = next.replace(/\s*$/, "\n" + line + "\n");
-
-  await fs.writeFile(file, next, "utf8");
-}
-
-export async function POST(req: Request, ctx: { params: Promise<{ teamId: string }> }) {
-  try {
-    const { teamId } = await ctx.params;
-    const body = await req.json();
-    const ticket = String(body.ticket ?? "").trim();
-
-    if (!ticket) {
-      return NextResponse.json({ ok: false, error: "Missing ticket" }, { status: 400 });
-    }
-
-    const hit = await resolveTicket(teamId, ticket);
-    if (!hit) {
-      return NextResponse.json({ ok: false, error: `Ticket not found: ${ticket}` }, { status: 404 });
-    }
-
-    const goalsDir = path.join(teamWorkspace(teamId), "work/goals");
-    await fs.mkdir(goalsDir, { recursive: true });
-
-    const dest = path.join(goalsDir, path.basename(hit.file));
-    await fs.rename(hit.file, dest);
-
-    await appendGoalsAuditComment(dest);
-
-    return NextResponse.json({ ok: true, to: dest });
-  } catch (e: unknown) {
-    return NextResponse.json({ ok: false, error: errorMessage(e) }, { status: 500 });
-  }
-}

package/src/app/api/teams/file/route.ts

@@ -1,46 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-import { NextResponse } from "next/server";
-import { errorMessage } from "@/lib/errors";
-import { assertSafeRelativeFileName } from "@/lib/paths";
-import { getTeamContextFromBody, withTeamContextFromQuery } from "@/lib/api-route-helpers";
-
-export async function GET(req: Request) {
-  return withTeamContextFromQuery(req, async ({ teamId, teamDir }) => {
-    const { searchParams } = new URL(req.url);
-    const name = String(searchParams.get("name") ?? "").trim();
-    if (!name) return NextResponse.json({ ok: false, error: "name is required" }, { status: 400 });
-
-    const safe = assertSafeRelativeFileName(name);
-    const filePath = path.join(teamDir, safe);
-
-    try {
-      const content = await fs.readFile(filePath, "utf8");
-      return NextResponse.json({ ok: true, teamId, name: safe, filePath, content });
-    } catch (e: unknown) {
-      return NextResponse.json(
-        { ok: false, error: errorMessage(e) },
-        { status: 404 }
-      );
-    }
-  });
-}
-
-export async function PUT(req: Request) {
-  const body = (await req.json()) as { teamId?: string; name?: string; content?: string };
-  const ctx = await getTeamContextFromBody(body);
-  if (ctx instanceof NextResponse) return ctx;
-  const { teamId, teamDir } = ctx;
-
-  const name = String(body.name ?? "").trim();
-  const content = typeof body.content === "string" ? body.content : null;
-  if (!name) return NextResponse.json({ ok: false, error: "name is required" }, { status: 400 });
-  if (content === null) return NextResponse.json({ ok: false, error: "content is required" }, { status: 400 });
-
-  const safe = assertSafeRelativeFileName(name);
-  const filePath = path.join(teamDir, safe);
-
-  await fs.mkdir(path.dirname(filePath), { recursive: true });
-  await fs.writeFile(filePath, content, "utf8");
-  return NextResponse.json({ ok: true, teamId, name: safe, filePath });
-}

package/src/app/api/teams/files/route.ts

@@ -1,63 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-import { NextResponse } from "next/server";
-import { listWorkspaceFiles, withTeamContextFromQuery } from "@/lib/api-route-helpers";
-
-export async function GET(req: Request) {
-  return withTeamContextFromQuery(req, async ({ teamId, teamDir }) => {
-    // QA checklist should only be required when:
-  // - the team has a test role, and/or
-  // - the recipe opts in via frontmatter (qaChecklist: true)
-    const hasTestRole = await (async () => {
-    try {
-      const st = await fs.stat(path.join(teamDir, "roles", "test"));
-      return st.isDirectory();
-    } catch {
-      return false;
-    }
-    })();
-
-    const recipeOptsIn = await (async () => {
-    try {
-      const teamJsonPath = path.join(teamDir, "team.json");
-      const raw = await fs.readFile(teamJsonPath, "utf8");
-      const parsed = JSON.parse(raw) as { recipeId?: unknown };
-      const recipeId = String(parsed.recipeId ?? "").trim();
-      if (!recipeId) return false;
-
-      // Load recipe frontmatter via OpenClaw CLI and check for qaChecklist: true
-      const { runOpenClaw } = await import("@/lib/openclaw");
-      const shown = await runOpenClaw(["recipes", "show", recipeId]);
-      if (!shown.ok) return false;
-      const md = String(shown.stdout ?? "");
-      if (!md.startsWith("---\n")) return false;
-      const end = md.indexOf("\n---\n", 4);
-      if (end === -1) return false;
-      const yamlText = md.slice(4, end);
-      const { default: YAML } = await import("yaml");
-      const fm = (YAML.parse(yamlText) ?? {}) as { qaChecklist?: unknown };
-      return Boolean(fm.qaChecklist);
-    } catch {
-      return false;
-    }
-    })();
-
-    const qaChecklistRequired = hasTestRole || recipeOptsIn;
-
-    const candidates: Array<{ name: string; required: boolean; rationale: string }> = [
-    { name: "TEAM.md", required: true, rationale: "Team workspace overview" },
-    { name: "TICKETS.md", required: true, rationale: "Ticket workflow + format" },
-    { name: "notes/QA_CHECKLIST.md", required: qaChecklistRequired, rationale: "QA verification checklist" },
-
-    { name: "SOUL.md", required: false, rationale: "Optional team persona (some teams use role SOUL.md only)" },
-    { name: "USER.md", required: false, rationale: "Optional user profile" },
-    { name: "AGENTS.md", required: false, rationale: "Optional team notes (often role-scoped)" },
-    { name: "TOOLS.md", required: false, rationale: "Optional team-local tooling notes" },
-    { name: "MEMORY.md", required: false, rationale: "Optional curated memory" },
-    ];
-
-    const files = await listWorkspaceFiles(teamDir, candidates);
-
-    return NextResponse.json({ ok: true, teamId, teamDir, files });
-  });
-}