@polderlabs/bizar 6.2.4 → 6.3.0

package/plugins/bizar/src/tools/read-glyph-feedback.ts

@@ -1,191 +0,0 @@
-/**
- * read-glyph-feedback.ts
- *
- * `read_glyph_feedback` tool (v3.22.0).
- *
- * Reads the structured `feedback.md` file the user wrote when they
- * clicked "Submit to agent" on a glyph in the dashboard. Returns:
- *   - parsed frontmatter (glyph, submittedAt, submittedBy, commentCount, questionCount)
- *   - the markdown body (Free-placed comments / Open-question answers / Full MDX source)
- *   - the parsed counts
- *
- * File location: `<worktree>/artifacts/<slug>/feedback.md`. The dashboard
- * writes this file via `POST /api/artifacts/:slug/submit` and marks the
- * artifact's `meta.json` `status` as `review`.
- *
- * Companion tools:
- *   - `bizar_get_plan_comments` — legacy canvas comment reader
- *   - `bizar_plan_action`      — CRUD on the v2 canvas
- *
- * Read-only — available to ALL agents. Never throws.
- *
- * Cline SDK port (Phase 2):
- *   - Uses `createTool` from `@cline/sdk` directly.
- *   - Adds `name: BIZAR_READ_GLYPH_FEEDBACK_TOOL_NAME`.
- *   - `inputSchema` is `z.object(...).shape` over the same fields as before.
- *   - Returns structured `{ ok: true, found, ... }` / `{ ok: false, error, ... }`
- *     instead of `{ output: JSON.stringify(...) }`.
- */
-
-import { createTool, type AgentTool } from "@cline/sdk";
-import { z } from "zod";
-import { existsSync, readFileSync } from "node:fs";
-import { join } from "node:path";
-
-import type { Logger } from "../logger.js";
-
-export const BIZAR_READ_GLYPH_FEEDBACK_TOOL_NAME = "bizar_read_glyph_feedback";
-
-export interface ReadGlyphFeedbackDeps {
-  /** The project's working directory (e.g. /home/user/proj). `artifacts/` is here. */
-  worktree: string;
-  logger: Logger;
-}
-
-// --- Constants -----------------------------------------------------------
-
-/** Same slug rule used everywhere in the project. */
-const SLUG_REGEX = /^[a-z0-9][a-z0-9-]{0,63}$/;
-
-// --- Return type ---------------------------------------------------------
-
-export interface ReadGlyphFeedbackResult {
-  ok: true;
-  found: true;
-  slug: string;
-  meta: Record<string, string>;
-  body: string;
-  feedbackFile: string;
-  commentCount: number;
-  questionCount: number;
-}
-
-export interface ReadGlyphFeedbackMissing {
-  ok: true;
-  found: false;
-  slug: string;
-  message: string;
-  feedbackFile: string;
-}
-
-export interface ReadGlyphFeedbackError {
-  ok: false;
-  error: string;
-  slug: string;
-}
-
-export type ReadGlyphFeedbackOutcome =
-  | ReadGlyphFeedbackResult
-  | ReadGlyphFeedbackMissing
-  | ReadGlyphFeedbackError;
-
-export type BizarReadGlyphFeedbackInput = z.infer<typeof bizarReadGlyphFeedbackSchema>;
-export type BizarReadGlyphFeedbackOutput = ReadGlyphFeedbackOutcome;
-
-const bizarReadGlyphFeedbackSchema = z.object({
-  slug: z
-    .string()
-    .min(1)
-    .max(64)
-    .regex(/^[a-z0-9][a-z0-9-]{0,63}$/, "Must match ^[a-z0-9][a-z0-9-]{0,63}$")
-    .describe("The artifact slug (e.g., 'dashboard-stale-pid-fix')."),
-});
-
-// --- Pure core: readGlyphFeedback ----------------------------------------
-
-/**
- * Read `artifacts/<slug>/feedback.md` from disk and parse it. Exported
- * so tests can drive the same code path the real tool uses.
- *
- * Behavior:
- *   - Invalid slug         → returns `{ ok: false, error }`
- *   - File missing         → returns `{ ok: true, found: false, message }`
- *   - File present, parseable → returns `{ ok: true, found: true, meta, body, ... }`
- *   - File present, corrupt   → returns `{ ok: true, found: true, meta: {}, body: raw }`
- *
- * Never throws.
- */
-export function readGlyphFeedback(
-  worktree: string,
-  slug: string,
-): ReadGlyphFeedbackOutcome {
-  if (!SLUG_REGEX.test(slug)) {
-    return {
-      ok: false,
-      error: `Invalid slug: "${slug}". Must match ^[a-z0-9][a-z0-9-]{0,63}$.`,
-      slug,
-    };
-  }
-
-  const feedbackFile = join(worktree, "artifacts", slug, "feedback.md");
-  if (!existsSync(feedbackFile)) {
-    return {
-      ok: true,
-      found: false,
-      slug,
-      message: `No feedback.md in artifacts/${slug}/ — has the user submitted feedback yet?`,
-      feedbackFile,
-    };
-  }
-
-  const raw = readFileSync(feedbackFile, "utf-8");
-
-  // Parse the YAML frontmatter. We only support scalar values (string /
-  // number) because the dashboard's writer only emits scalars.
-  const meta: Record<string, string> = {};
-  const fm = raw.match(/^---\n([\s\S]+?)\n---/);
-  let body = raw;
-  if (fm) {
-    const yaml = fm[1] ?? "";
-    for (const line of yaml.split("\n")) {
-      const m = line.match(/^(\w+):\s*(.*)$/);
-      if (m) meta[m[1]!] = m[2]!;
-    }
-    if (fm[0]) body = raw.slice(fm[0].length).replace(/^\s+/, "");
-  }
-
-  const commentCount = parseInt(meta.commentCount || "0", 10) || 0;
-  const questionCount = parseInt(meta.questionCount || "0", 10) || 0;
-
-  return {
-    ok: true,
-    found: true,
-    slug,
-    meta,
-    body,
-    feedbackFile,
-    commentCount,
-    questionCount,
-  };
-}
-
-// --- Tool factory --------------------------------------------------------
-
-/**
- * Build the `bizar_read_glyph_feedback` tool. The plugin wires the
- * result into `api.registerTool()` from `AgentExtensionApi`. The
- * `deps` closure carries the worktree and logger.
- */
-export function createReadGlyphFeedbackTool(
-  deps: ReadGlyphFeedbackDeps,
-): AgentTool<BizarReadGlyphFeedbackInput, BizarReadGlyphFeedbackOutput> {
-  return createTool({
-    name: BIZAR_READ_GLYPH_FEEDBACK_TOOL_NAME,
-    description:
-      "Reads feedback.md for a glyph the user submitted for review. " +
-      "Returns free-placed comments with (x, y) coordinates, answers to " +
-      "OpenQuestions, and the original MDX source. Use this to understand " +
-      "exactly what the user wants changed before regenerating the glyph.",
-    inputSchema: bizarReadGlyphFeedbackSchema.shape,
-    execute: async (input) => {
-      const result = readGlyphFeedback(deps.worktree, input.slug);
-      if (!result.ok) {
-        deps.logger.warn(
-          `bizar: read_glyph_feedback(${input.slug}) failed: ${result.error}`,
-        );
-      }
-      return result;
-    },
-  });
-}
-

package/plugins/bizar/src/tools/team-spawn.ts

@@ -1,73 +0,0 @@
-/**
- * team-spawn.ts
- *
- * `bizar_spawn_team` tool — spawn a Cline agent team (multi-agent
- * collaboration). Uses ClineCore in-process with `enableAgentTeams: true`.
- *
- * A team is a set of agents that collaborate on a shared mission. The
- * lead agent coordinates; teammates execute sub-tasks. The team runs
- * until the mission is complete or the team is stopped.
- *
- * v6.0.0 — New tool for Cline agent teams integration. The runtime
- * config sets `enableAgentTeams: true` so the team coordinator + tools
- * (TeamSpawnTeammate, TeamRunTask, TeamSendMessage, etc.) are available.
- */
-
-import { createTool, type AgentTool } from "@cline/sdk";
-import { z } from "zod";
-
-import type { ClineRuntime, StartSessionOpts } from "../clineruntime.js";
-import type { Logger } from "../logger.js";
-
-export const BIZAR_SPAWN_TEAM_TOOL_NAME = "bizar_spawn_team";
-
-export interface TeamSpawnDeps {
-  runtime: ClineRuntime;
-  logger: Logger;
-}
-
-export type BizarTeamSpawnInput = z.infer<typeof bizarTeamSpawnSchema>;
-export type BizarTeamSpawnOutput =
-  | { ok: true; sessionId: string; teamName: string; missionPreview: string }
-  | { ok: false; error: string; message: string };
-
-const bizarTeamSpawnSchema = z.object({
-  teamName: z.string().min(1).describe("Name of the team (e.g. 'bizar-build-team')."),
-  mission: z.string().min(1).describe("The mission/goal for the team. The lead agent will coordinate teammates to achieve this."),
-  providerId: z.string().optional().describe("Provider ID (default 'anthropic')."),
-  modelId: z.string().optional().describe("Model ID (default 'claude-sonnet-4-6')."),
-  workspaceRoot: z.string().optional().describe("Workspace root (default worktree)."),
-});
-
-export function createTeamSpawnTool(
-  deps: TeamSpawnDeps,
-): AgentTool<BizarTeamSpawnInput, BizarTeamSpawnOutput> {
-  return createTool({
-    name: BIZAR_SPAWN_TEAM_TOOL_NAME,
-    description:
-      "Spawn a Cline agent team. The lead agent coordinates teammates " +
-      "to complete the mission. Returns the team sessionId. Available to " +
-      "Odin and coordinating agents.",
-    inputSchema: bizarTeamSpawnSchema.shape,
-    execute: async (input) => {
-      const opts: StartSessionOpts = {
-        providerId: input.providerId ?? "anthropic",
-        modelId: input.modelId ?? "claude-sonnet-4-6",
-        workspaceRoot: input.workspaceRoot ?? process.cwd(),
-        systemPrompt: `You are the lead agent of the "${input.teamName}" team. Your mission:\n\n${input.mission}\n\nUse Cline's team tools to coordinate teammates: spawn teammates, run tasks, send messages, review outcomes, and finalize. Use the team progress event stream to track work.`,
-        prompt: `Start the "${input.teamName}" team. Mission: ${input.mission}`,
-        source: "bizar-team-spawn",
-        sessionMetadata: { bizarTeam: input.teamName, bizarMission: input.mission.slice(0, 500) },
-      };
-      try {
-        const sessionId = await deps.runtime.startSession(opts);
-        deps.logger.info(`bizar: team spawned (teamName=${input.teamName}, sessionId=${sessionId})`);
-        return { ok: true as const, sessionId, teamName: input.teamName, missionPreview: input.mission.slice(0, 200) };
-      } catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        deps.logger.warn(`bizar: team spawn failed: ${msg}`);
-        return { ok: false as const, error: "spawn_failed", message: msg };
-      }
-    },
-  });
-}

package/plugins/bizar/src/tools/team-status.ts

@@ -1,76 +0,0 @@
-/**
- * team-status.ts
- *
- * `bizar_team_status` tool — get the current status of a Cline agent team.
- * Subscribes to team events and returns a snapshot of progress.
- *
- * v6.0.0 — Cline agent teams integration. The dashboard's kanban board
- * consumes these events to show team progress in real time.
- */
-
-import { createTool, type AgentTool } from "@cline/sdk";
-import { z } from "zod";
-import type { CoreSessionEvent } from "@cline/core";
-
-import type { ClineRuntime } from "../clineruntime.js";
-import type { Logger } from "../logger.js";
-
-export const BIZAR_TEAM_STATUS_TOOL_NAME = "bizar_team_status";
-
-export interface TeamStatusDeps {
-  runtime: ClineRuntime;
-  logger: Logger;
-}
-
-export type BizarTeamStatusInput = z.infer<typeof bizarTeamStatusSchema>;
-export type BizarTeamStatusOutput =
-  | { ok: true; sessionId: string; teamProgress: unknown }
-  | { ok: false; error: string; message: string };
-
-const bizarTeamStatusSchema = z.object({
-  sessionId: z.string().min(1).describe("Team session ID returned by bizar_spawn_team."),
-  timeoutMs: z.number().int().positive().optional().describe("Max time to wait for a progress event (default 1000ms)."),
-});
-
-/**
- * Subscribe to team events for a session and return the most recent
- * team_progress_projection event. If no progress event is available
- * within the timeout, returns what we have (or null).
- */
-export function createTeamStatusTool(
-  deps: TeamStatusDeps,
-): AgentTool<BizarTeamStatusInput, BizarTeamStatusOutput> {
-  return createTool({
-    name: BIZAR_TEAM_STATUS_TOOL_NAME,
-    description:
-      "Get the current status of a Cline agent team. Returns the latest " +
-      "team progress projection. Available to Odin and coordinating agents.",
-    inputSchema: bizarTeamStatusSchema.shape,
-    execute: async (input) => {
-      const timeoutMs = input.timeoutMs ?? 1000;
-      let lastProgress: unknown = null;
-      let done = false;
-      const handler = (event: CoreSessionEvent) => {
-        const t = (event as { type?: string }).type;
-        if (t === "team_progress_projection" || t === "team.lifecycle" || t === "team.progress" || t === "team.lifecycle.v1") {
-          lastProgress = event;
-          done = true;
-        }
-      };
-      let unsubscribe: (() => void) | null = null;
-      try {
-        unsubscribe = deps.runtime.subscribe({ sessionId: input.sessionId }, handler);
-        const start = Date.now();
-        while (!done && Date.now() - start < timeoutMs) {
-          await new Promise((r) => setTimeout(r, 50));
-        }
-      } catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        deps.logger.warn(`bizar: team-status subscribe failed: ${msg}`);
-      } finally {
-        try { unsubscribe?.(); } catch { /* ignore */ }
-      }
-      return { ok: true as const, sessionId: input.sessionId, teamProgress: lastProgress };
-    },
-  });
-}