npm - bluekiwi - Versions diffs - 0.2.5 → 0.3.1 - Mend

bluekiwi 0.2.5 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (14) hide show

package/dist/assets/index.js +0 -1
package/dist/assets/mcp/server.js +434 -7
package/dist/assets/skills/bk-approve/SKILL.md +18 -6
package/dist/assets/skills/bk-design/SKILL.md +220 -14
package/dist/assets/skills/bk-improve/SKILL.md +106 -20
package/dist/assets/skills/bk-instruction/SKILL.md +21 -0
package/dist/assets/skills/bk-report/SKILL.md +18 -0
package/dist/assets/skills/bk-rewind/SKILL.md +2 -2
package/dist/assets/skills/bk-share/SKILL.md +5 -5
package/dist/assets/skills/bk-start/SKILL.md +282 -19
package/dist/assets/skills/bk-status/SKILL.md +35 -5
package/dist/commands/dev-link.js +1 -1
package/package.json +1 -1
package/dist/assets/skills/bk-next/SKILL.md +0 -228

package/dist/assets/index.js CHANGED Viewed

@@ -5,7 +5,6 @@ const here = dirname(fileURLToPath(import.meta.url));
 const SKILLS_ROOT = join(here, "skills");
 export const BUNDLED_SKILLS = [
     "bk-start",
-    "bk-next",
     "bk-status",
     "bk-rewind",
     "bk-approve",

package/dist/assets/mcp/server.js CHANGED Viewed

@@ -20908,6 +20908,50 @@ var BlueKiwiClient = class {
     }
     throw new BlueKiwiNetworkError("Unreachable", lastError);
   }
+  async requestFormData(method, path2, formData) {
+    const url2 = `${this.baseUrl.replace(/\/$/, "")}${path2}`;
+    const init = {
+      method,
+      headers: {
+        Authorization: `Bearer ${this.apiKey}`
+      },
+      body: formData
+    };
+    let lastError;
+    for (let attempt = 0; attempt <= RETRY_DELAYS_MS.length; attempt++) {
+      try {
+        const res = await fetch(url2, init);
+        if (res.status === 401) {
+          throw new BlueKiwiAuthError();
+        }
+        if (!res.ok) {
+          const text2 = await res.text().catch(() => "");
+          if (res.status >= 500 && attempt < RETRY_DELAYS_MS.length) {
+            lastError = new BlueKiwiApiError(res.status, text2);
+            await sleep(RETRY_DELAYS_MS[attempt]);
+            continue;
+          }
+          throw new BlueKiwiApiError(res.status, text2);
+        }
+        const text = await res.text();
+        return text ? JSON.parse(text) : null;
+      } catch (err) {
+        if (err instanceof BlueKiwiAuthError || err instanceof BlueKiwiApiError) {
+          throw err;
+        }
+        lastError = err;
+        if (attempt < RETRY_DELAYS_MS.length) {
+          await sleep(RETRY_DELAYS_MS[attempt]);
+          continue;
+        }
+        throw new BlueKiwiNetworkError(
+          `Failed to reach ${url2} after ${RETRY_DELAYS_MS.length + 1} attempts`,
+          err
+        );
+      }
+    }
+    throw new BlueKiwiNetworkError("Unreachable", lastError);
+  }
 };
 function sleep(ms) {
   return new Promise((r) => setTimeout(r, ms));
@@ -21022,6 +21066,15 @@ var tools = [
       folder_id: { type: "number" }
     }
   ),
+  tool(
+    "list_tasks",
+    "List tasks visible to the current user. Optionally filter by workflow_id, status (running/completed/failed), or search query. Returns task id, workflow_title, status, current_step, total_steps, and logs.",
+    {
+      workflow_id: { type: "number" },
+      status: { type: "string" },
+      q: { type: "string" }
+    }
+  ),
   tool(
     "list_workflow_versions",
     "List every version in the same family as the given workflow id, including active and archived ones. Returns the active_version_id and an ordered versions array.",
@@ -21135,9 +21188,10 @@ var tools = [
   ),
   tool(
     "get_web_response",
-    "Fetch the pending web response payload for a task",
+    "Fetch VS response for a task. Without node_id: returns the latest response. With node_id: returns the response history for that node across all loop iterations (web_response only, no visual_html). Useful for tracking how user preferences evolved across iterations.",
     {
-      task_id: { type: "number" }
+      task_id: { type: "number" },
+      node_id: { type: "number" }
     },
     ["task_id"]
   ),
@@ -21151,6 +21205,48 @@ var tools = [
     },
     ["task_id", "node_id", "visual_html"]
   ),
+  tool(
+    "set_visual_html",
+    `Submit a VS content fragment for a visual_selection=true gate node. Write HTML fragments using bk-* component classes \u2014 the frame (CSS, JS, submit button) is added automatically. Do NOT include <html>, <head>, or <body> tags.
+DIALOG SIZE DIRECTIVE (optional, add as first line):
+<!-- @bk size=sm -->   default (448px) \u2014 simple options, checklist
+<!-- @bk size=md -->   medium (672px)  \u2014 cards, code-compare
+<!-- @bk size=lg -->   large (896px)   \u2014 pros-cons, ranking, timeline
+<!-- @bk size=xl -->   wide (1152px)   \u2014 mockups, matrix, side-by-side wireframes
+<!-- @bk size=full --> fullscreen (95vw) \u2014 dashboard previews, complex layouts
+If omitted, defaults to sm. Use xl or full for any content that benefits from horizontal space.
+Built-in components (use class names directly):
+SELECTION (collect choices):
+- bk-options: A/B/C cards. Wrap in .bk-options, each .bk-option with data-value. Optional data-recommended badge. Contains .bk-option-letter + .bk-option-body with h3+p.
+- bk-cards: Visual cards. Wrap in .bk-cards, each .bk-card with data-value. Contains .bk-card-image + .bk-card-body.
+- bk-checklist: Multi-select. Wrap in .bk-checklist, each .bk-check-item with data-value. Optional data-checked for defaults.
+- bk-code-compare: Code selection. Wrap in .bk-code-compare, each .bk-code-option with data-value. Contains .bk-code-label + pre.bk-code.
+INPUT (collect values):
+- bk-slider: Numeric. data-name, data-min, data-max, data-value, data-unit on .bk-slider. Contains label.
+- bk-ranking: Drag reorder. Wrap in .bk-ranking, each .bk-rank-item with data-value.
+- bk-matrix: 2x2 placement. .bk-matrix with data-x-label, data-y-label. Each .bk-matrix-item with data-value.
+DISPLAY (no values):
+- bk-split: Side-by-side. Two .bk-split-panel inside .bk-split.
+- bk-pros-cons: .bk-pros + .bk-cons inside .bk-pros-cons.
+- bk-mockup: .bk-mockup-header + .bk-mockup-body inside .bk-mockup.
+- bk-timeline: .bk-timeline-item with data-status="done|current|pending".
+Layout: h2 for title, .bk-subtitle, .bk-section for breaks, .bk-label for category.
+Response format (JSON via get_web_response):
+{selections: ["a"], values: {budget: 70}, ranking: ["security","ux"], matrix: {auth: {x:0.8,y:0.9}}}
+Only populated fields are included.`,
+    {
+      task_id: { type: "number" },
+      node_id: { type: "number" },
+      html: { type: "string" }
+    },
+    ["task_id", "node_id", "html"]
+  ),
   tool(
     "save_artifacts",
     "Save artifacts for a task step",
@@ -21286,6 +21382,114 @@ var tools = [
     },
     ["workflow_id"]
   ),
+  tool(
+    "append_node",
+    "Append a new node at the end of a workflow. node_type determines auto_advance automatically (action=auto, gate/loop=manual). Use hitl=true for action nodes that require human approval. For loop nodes, set loop_back_to to the target step_order (usually self). For gate nodes, set visual_selection=true for click-based HTML selection UI.",
+    {
+      workflow_id: { type: "number" },
+      title: { type: "string" },
+      instruction: { type: "string" },
+      node_type: { type: "string" },
+      hitl: { type: "boolean" },
+      visual_selection: { type: "boolean" },
+      loop_back_to: { type: "number" },
+      credential_id: { type: "number" },
+      instruction_id: { type: "number" }
+    },
+    ["workflow_id", "title", "node_type"]
+  ),
+  tool(
+    "insert_node",
+    "Insert a new node after a specific step_order in a workflow. Nodes after the insertion point are shifted by +1. For loop nodes, set loop_back_to. For gate nodes, set visual_selection=true for click-based selection.",
+    {
+      workflow_id: { type: "number" },
+      after_step: { type: "number" },
+      title: { type: "string" },
+      instruction: { type: "string" },
+      node_type: { type: "string" },
+      hitl: { type: "boolean" },
+      visual_selection: { type: "boolean" },
+      loop_back_to: { type: "number" },
+      credential_id: { type: "number" },
+      instruction_id: { type: "number" }
+    },
+    ["workflow_id", "after_step", "title", "node_type"]
+  ),
+  tool(
+    "update_node",
+    "Partially update a single node. Only provided fields are changed. If node_type changes, auto_advance is re-enforced automatically.",
+    {
+      workflow_id: { type: "number" },
+      node_id: { type: "number" },
+      title: { type: "string" },
+      instruction: { type: "string" },
+      node_type: { type: "string" },
+      hitl: { type: "boolean" },
+      credential_id: { type: "number" },
+      instruction_id: { type: "number" },
+      loop_back_to: { type: "number" }
+    },
+    ["workflow_id", "node_id"]
+  ),
+  tool(
+    "remove_node",
+    "Delete a single node and reindex step_order for subsequent nodes (all nodes after the deleted one shift by -1).",
+    {
+      workflow_id: { type: "number" },
+      node_id: { type: "number" }
+    },
+    ["workflow_id", "node_id"]
+  ),
+  tool(
+    "list_attachments",
+    "List file attachments for a workflow node. Returns metadata only (id, filename, mime_type, size_bytes).",
+    {
+      workflow_id: { type: "number" },
+      node_id: { type: "number" }
+    },
+    ["workflow_id", "node_id"]
+  ),
+  tool(
+    "get_attachment",
+    "Download attachment content. Returns text content directly for text files. For binary files, returns metadata with binary=true.",
+    {
+      workflow_id: { type: "number" },
+      node_id: { type: "number" },
+      attachment_id: { type: "number" }
+    },
+    ["workflow_id", "node_id", "attachment_id"]
+  ),
+  tool(
+    "upload_attachment",
+    "Upload a text file as an attachment to a workflow node. Text-only \u2014 binary uploads must use the web UI. Use this after creating a workflow to attach scripts, reference docs, or config files that agents can download during execution.",
+    {
+      workflow_id: { type: "number" },
+      node_id: { type: "number" },
+      filename: { type: "string" },
+      content: { type: "string" },
+      mime_type: { type: "string" }
+    },
+    ["workflow_id", "node_id", "filename", "content"]
+  ),
+  tool(
+    "delete_attachment",
+    "Delete an attachment from a workflow node.",
+    {
+      workflow_id: { type: "number" },
+      node_id: { type: "number" },
+      attachment_id: { type: "number" }
+    },
+    ["workflow_id", "node_id", "attachment_id"]
+  ),
+  tool(
+    "save_feedback",
+    "Save post-workflow feedback for a completed task. Call this after collecting user survey responses and before calling complete_task. feedback is an array of {question, answer} objects.",
+    {
+      task_id: { type: "number" },
+      feedback: { type: "array" }
+    },
+    ["task_id", "feedback"]
+  ),
   tool(
     "save_findings",
     "Save one or more compliance findings for a task",
@@ -21323,7 +21527,7 @@ var tools = [
   ),
   tool(
     "share_folder",
-    "Share a folder with a user group at the given access level (viewer or editor). Owner or admin only.",
+    "Share a folder with a user group at the given access level (reader or contributor). Owner or admin only.",
     {
       folder_id: { type: "number" },
       group_id: { type: "number" },
@@ -21340,6 +21544,24 @@ var tools = [
     },
     ["folder_id", "group_id"]
   ),
+  tool(
+    "update_folder",
+    "Rename or change the description of a folder. Cannot rename system folders. Only the owner or an admin can edit.",
+    {
+      folder_id: { type: "number" },
+      name: { type: "string" },
+      description: { type: "string" }
+    },
+    ["folder_id"]
+  ),
+  tool(
+    "delete_folder",
+    "Delete an empty folder. Returns an error if the folder contains any workflows, instructions, credentials, or child folders.",
+    {
+      folder_id: { type: "number" }
+    },
+    ["folder_id"]
+  ),
   tool(
     "move_workflow",
     "Move a workflow into a different folder. Caller must have edit permission on the destination folder.",
@@ -21405,6 +21627,15 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         const suffix = qs.toString() ? `?${qs.toString()}` : "";
         return wrap(await client.request("GET", `/api/workflows${suffix}`));
       }
+      case "list_tasks": {
+        const qs = new URLSearchParams();
+        if (typeof args.workflow_id === "number")
+          qs.set("workflow_id", String(args.workflow_id));
+        if (typeof args.status === "string") qs.set("status", args.status);
+        if (typeof args.q === "string") qs.set("q", args.q);
+        const suffix = qs.toString() ? `?${qs.toString()}` : "";
+        return wrap(await client.request("GET", `/api/tasks${suffix}`));
+      }
       case "list_workflow_versions": {
         const workflowId = requireNumberArg(args, "workflow_id");
         return wrap(
@@ -21426,12 +21657,37 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           )
         );
       }
-      case "start_workflow":
+      case "start_workflow": {
+        const MODEL_NAME_RE = /^(claude|gpt|gemini|o\d|llama|mistral|qwen|deepseek)[-/.]/i;
+        const clientName = server.getClientVersion()?.name ?? null;
+        let providerSlug = null;
+        let modelSlug = null;
+        try {
+          const meta3 = JSON.parse(
+            typeof args.session_meta === "string" ? args.session_meta : "{}"
+          );
+          providerSlug = meta3.agent ?? null;
+          modelSlug = meta3.model_id ?? null;
+        } catch {
+        }
+        if (clientName) {
+          if (MODEL_NAME_RE.test(clientName)) {
+            if (!modelSlug) modelSlug = clientName;
+          } else if (!providerSlug) {
+            providerSlug = clientName;
+          }
+        }
+        args.provider_slug = providerSlug;
+        args.model_slug = modelSlug;
         return wrap(await client.request("POST", "/api/tasks/start", args));
+      }
       case "execute_step": {
         const taskId = requireNumberArg(args, "task_id");
         const body = { ...args };
         delete body.task_id;
+        if (body.model_id && !body.model_slug) {
+          body.model_slug = body.model_id;
+        }
         return wrap(
           await client.request("POST", `/api/tasks/${taskId}/execute`, body)
         );
@@ -21488,9 +21744,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       }
       case "get_web_response": {
         const taskId = requireNumberArg(args, "task_id");
-        return wrap(
-          await client.request("GET", `/api/tasks/${taskId}/respond`)
-        );
+        const nodeId = typeof args.node_id === "number" ? args.node_id : null;
+        const url2 = nodeId ? `/api/tasks/${taskId}/respond?node_id=${nodeId}` : `/api/tasks/${taskId}/respond`;
+        return wrap(await client.request("GET", url2));
       }
       case "submit_visual": {
         const taskId = requireNumberArg(args, "task_id");
@@ -21500,6 +21756,16 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           await client.request("POST", `/api/tasks/${taskId}/visual`, body)
         );
       }
+      case "set_visual_html": {
+        const taskId = requireNumberArg(args, "task_id");
+        const nodeId = requireNumberArg(args, "node_id");
+        return wrap(
+          await client.request("POST", `/api/tasks/${taskId}/visual`, {
+            node_id: nodeId,
+            html: args.html
+          })
+        );
+      }
       case "save_artifacts": {
         const taskId = requireNumberArg(args, "task_id");
         const body = { ...args };
@@ -21581,6 +21847,146 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           await client.request("DELETE", `/api/workflows/${workflowId}`)
         );
       }
+      case "append_node": {
+        const workflowId = requireNumberArg(args, "workflow_id");
+        const body = { ...args };
+        delete body.workflow_id;
+        return wrap(
+          await client.request(
+            "POST",
+            `/api/workflows/${workflowId}/nodes`,
+            body
+          )
+        );
+      }
+      case "insert_node": {
+        const workflowId = requireNumberArg(args, "workflow_id");
+        const afterStep = requireNumberArg(args, "after_step");
+        const body = { ...args };
+        delete body.workflow_id;
+        delete body.after_step;
+        return wrap(
+          await client.request(
+            "POST",
+            `/api/workflows/${workflowId}/nodes?after=${afterStep}`,
+            body
+          )
+        );
+      }
+      case "update_node": {
+        const workflowId = requireNumberArg(args, "workflow_id");
+        const nodeId = requireNumberArg(args, "node_id");
+        const body = { ...args };
+        delete body.workflow_id;
+        delete body.node_id;
+        return wrap(
+          await client.request(
+            "PATCH",
+            `/api/workflows/${workflowId}/nodes/${nodeId}`,
+            body
+          )
+        );
+      }
+      case "remove_node": {
+        const workflowId = requireNumberArg(args, "workflow_id");
+        const nodeId = requireNumberArg(args, "node_id");
+        return wrap(
+          await client.request(
+            "DELETE",
+            `/api/workflows/${workflowId}/nodes/${nodeId}`
+          )
+        );
+      }
+      case "list_attachments": {
+        const workflowId = requireNumberArg(args, "workflow_id");
+        const nodeId = requireNumberArg(args, "node_id");
+        return wrap(
+          await client.request(
+            "GET",
+            `/api/workflows/${workflowId}/nodes/${nodeId}/attachments`
+          )
+        );
+      }
+      case "get_attachment": {
+        const workflowId = requireNumberArg(args, "workflow_id");
+        const nodeId = requireNumberArg(args, "node_id");
+        const attachmentId = requireNumberArg(args, "attachment_id");
+        const url2 = `${apiUrl.replace(/\/$/, "")}/api/workflows/${workflowId}/nodes/${nodeId}/attachments/${attachmentId}`;
+        const res = await fetch(url2, {
+          method: "GET",
+          headers: {
+            Authorization: `Bearer ${apiKey}`
+          }
+        });
+        if (res.status === 401) {
+          throw new BlueKiwiAuthError();
+        }
+        if (!res.ok) {
+          throw new BlueKiwiApiError(
+            res.status,
+            await res.text().catch(() => "")
+          );
+        }
+        const contentType = res.headers.get("content-type") ?? "";
+        if (contentType.includes("application/json")) {
+          const text = await res.text();
+          return wrap(text ? JSON.parse(text) : null);
+        }
+        const disposition = res.headers.get("content-disposition") ?? "";
+        const filenameMatch = /filename\*=UTF-8''([^;]+)|filename=\"?([^\";]+)\"?/i.exec(
+          disposition
+        );
+        const filename = decodeURIComponent(
+          filenameMatch?.[1] ?? filenameMatch?.[2] ?? ""
+        );
+        const sizeHeader = res.headers.get("content-length");
+        const sizeBytes = typeof sizeHeader === "string" ? Number(sizeHeader) : void 0;
+        return wrap({
+          data: {
+            id: attachmentId,
+            filename: filename || void 0,
+            mime_type: contentType || void 0,
+            size_bytes: typeof sizeBytes === "number" && Number.isFinite(sizeBytes) ? sizeBytes : void 0,
+            binary: true
+          }
+        });
+      }
+      case "upload_attachment": {
+        const workflowId = requireNumberArg(args, "workflow_id");
+        const nodeId = requireNumberArg(args, "node_id");
+        const filename = requireStringArg(args, "filename");
+        const content = requireStringArg(args, "content");
+        const mimeType = typeof args.mime_type === "string" && args.mime_type.length > 0 ? args.mime_type : "text/plain";
+        const blob = new Blob([content], { type: mimeType });
+        const formData = new FormData();
+        formData.append("file", blob, filename);
+        return wrap(
+          await client.requestFormData(
+            "POST",
+            `/api/workflows/${workflowId}/nodes/${nodeId}/attachments`,
+            formData
+          )
+        );
+      }
+      case "delete_attachment": {
+        const workflowId = requireNumberArg(args, "workflow_id");
+        const nodeId = requireNumberArg(args, "node_id");
+        const attachmentId = requireNumberArg(args, "attachment_id");
+        return wrap(
+          await client.request(
+            "DELETE",
+            `/api/workflows/${workflowId}/nodes/${nodeId}/attachments/${attachmentId}`
+          )
+        );
+      }
+      case "save_feedback": {
+        const taskId = requireNumberArg(args, "task_id");
+        return wrap(
+          await client.request("POST", `/api/tasks/${taskId}/feedback`, {
+            feedback: args.feedback
+          })
+        );
+      }
       case "save_findings": {
         const taskId = requireNumberArg(args, "task_id");
         const body = { findings: args.findings };
@@ -21629,6 +22035,20 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           )
         );
       }
+      case "update_folder": {
+        const folderId = requireNumberArg(args, "folder_id");
+        const body = {};
+        if (typeof args.name === "string") body.name = args.name;
+        if (typeof args.description === "string")
+          body.description = args.description;
+        return wrap(
+          await client.request("PUT", `/api/folders/${folderId}`, body)
+        );
+      }
+      case "delete_folder": {
+        const folderId = requireNumberArg(args, "folder_id");
+        return wrap(await client.request("DELETE", `/api/folders/${folderId}`));
+      }
       case "move_workflow": {
         const workflowId = requireNumberArg(args, "workflow_id");
         const folderId = requireNumberArg(args, "folder_id");
@@ -21711,6 +22131,13 @@ function requireNumberArg(args, key) {
   }
   return value;
 }
+function requireStringArg(args, key) {
+  const value = args[key];
+  if (typeof value !== "string") {
+    throw new Error(`${key} must be a string`);
+  }
+  return value;
+}
 function wrap(data) {
   return {
     content: [{ type: "text", text: JSON.stringify(data) }]

package/dist/assets/skills/bk-approve/SKILL.md CHANGED Viewed

@@ -1,6 +1,6 @@
 ---
 name: bk-approve
-description: BlueKiwi approval skill. Handles pending approvals when resuming a session that was interrupted mid-HITL, or when the user explicitly wants to approve a paused step. During normal execution, HITL approval is handled inline by bk-start/bk-next. Use this skill when the user says "/bk-approve", "approve this", "approve step", or returns to a session where a HITL step is already waiting.
+description: BlueKiwi approval skill. Handles pending approvals when resuming a session that was interrupted mid-HITL, or when the user explicitly wants to approve a paused step. During normal execution, HITL approval is handled inline by bk-start. Use this skill when the user says "/bk-approve", "approve this", "approve step", or returns to a session where a HITL step is already waiting.
 user_invocable: true
 ---
@@ -9,7 +9,7 @@ user_invocable: true
 Handle pending approvals in a running workflow. Covers two scenarios:
 - **Gate step** (`node_type: gate`): Agent asked the human a question; collect the answer.
-- **HITL step** (`node_type: action`, `auto_advance: false`): Agent completed work and called `request_approval`; human reviews and approves before the workflow continues.
+- **HITL step** (`node_type: action`, `hitl: true`): Agent completed work and called `request_approval`; human reviews and approves before the workflow continues.
 ## Argument Handling
@@ -36,11 +36,23 @@ Check `log_status` and `node_type` to determine scenario:
 1. Show the gate question from `instruction`.
 2. Check `get_web_response` for a pre-submitted web response. If found, show it and ask to confirm.
+   If the web response is a JSON object from bk-\* components, display a readable summary instead of raw JSON:
+   ```text
+   VS Response:
+   - Selected: [option names from selections array]
+   - Values: budget = 70%, confidence = 85%
+   - Ranking: 1. Security, 2. Performance, 3. UX
+   - Matrix: auth -> high urgency / high importance
+   ```
+   Map `selections` values back to the option labels shown in the VS screen. Present `values` with their units, `ranking` as a numbered list, and `matrix` positions as quadrant descriptions using high/low language for each axis.
 3. Collect decision via AskUserQuestion:
    - header: "Gate decision"
    - options: ["Approve (Recommended)", "Approve with edits", "Reject and revise", "Rewind to previous step"]
 4. Call `execute_step` with the decision as `output`, status `"success"`.
-5. Call `advance` to move to the next step and follow the auto_advance loop (see `/bk-next`).
+5. Call `advance` to move to the next step and follow the auto-advance loop (see bk-start auto-advance loop).
 ### Step 2b: HITL Step
@@ -61,12 +73,12 @@ Check `log_status` and `node_type` to determine scenario:
 3. **If Approved**:
    - Call `approve_step(task_id=<id>)` MCP tool.
    - Call `advance` to move to the next step.
-   - Follow the auto_advance loop (see `/bk-next`).
+   - Follow the auto-advance loop (see bk-start auto-advance loop).
 4. **If Rejected**:
    - Ask the user for the reason.
    - Call `rewind` to return to this step so the agent can redo it.
-   - Tell the user: "Rewound to step {N}. Type `/bk-next` to retry."
+   - Tell the user: "Rewound to step {N}. Type `/bk-start` to retry."
 5. **If Rewind to earlier step**:
    - Switch to `/bk-rewind` flow.
@@ -74,5 +86,5 @@ Check `log_status` and `node_type` to determine scenario:
 ## Notes
 - `approve_step` MCP tool handles authentication automatically using the configured API key.
-- After approving a HITL step, always follow the auto_advance loop — the next step may auto-proceed.
+- After approving a HITL step, always follow the auto-advance loop — the next step may auto-proceed.
 - If `advance` still returns 403 after approval, wait a moment and retry — the approval write may not have propagated yet.