bluekiwi 1.0.0 → 1.0.1

package/dist/assets/app-runtime/public/vs/components.css

@@ -169,6 +169,80 @@ h2 {
   pointer-events: none;
 }
 
+/* ─── Form Inputs ─── */
+
+.bk-input,
+.bk-textarea,
+.bk-option-comment {
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+  margin-top: 1rem;
+}
+
+.bk-field-label {
+  font-size: 0.85rem;
+  font-weight: 600;
+  color: var(--bk-text);
+}
+
+.bk-field-label .required {
+  color: var(--bk-danger);
+  margin-left: 0.25rem;
+}
+
+.bk-field-help {
+  font-size: 0.78rem;
+  color: var(--bk-text-muted);
+}
+
+.bk-input-control,
+.bk-textarea-control {
+  width: 100%;
+  border: 1.5px solid var(--bk-border);
+  border-radius: var(--bk-radius);
+  background: var(--bk-surface);
+  color: var(--bk-text);
+  font: inherit;
+  padding: 0.8rem 0.9rem;
+  transition:
+    border-color 0.15s,
+    box-shadow 0.15s,
+    background 0.15s;
+}
+
+.bk-input-control::placeholder,
+.bk-textarea-control::placeholder {
+  color: var(--bk-text-muted);
+}
+
+.bk-input-control:focus,
+.bk-textarea-control:focus {
+  outline: none;
+  border-color: var(--bk-primary);
+  box-shadow: 0 0 0 3px rgba(65, 105, 225, 0.15);
+}
+
+.bk-textarea-control {
+  min-height: 7rem;
+  resize: vertical;
+  line-height: 1.55;
+}
+
+.bk-field-error {
+  font-size: 0.78rem;
+  color: var(--bk-danger);
+}
+
+.bk-option-comment[hidden] {
+  display: none;
+}
+
+.bk-option-comment {
+  border-top: 1px dashed var(--bk-border);
+  padding-top: 0.9rem;
+}
+
 /* ─── 1. bk-options (A/B/C single select) ─── */
 
 .bk-options {

package/dist/assets/app-runtime/public/vs/helper.js

@@ -6,13 +6,30 @@
 (function () {
   "use strict";
 
+  const COMMENTABLE_SELECTOR =
+    ".bk-option, .bk-card, .bk-code-option, .bk-mockup-item, .bk-check-item";
+
   /* ── i18n ── */
   const UI_TEXT = {
-    ko: { submit: "확인", submitted: "✓ 제출됨", selected: "{n}개 선택됨" },
+    ko: {
+      submit: "확인",
+      submitted: "✓ 제출됨",
+      selected: "{n}개 선택됨",
+      detailsLabel: "추가 요청사항",
+      detailsPlaceholder: "선택 이유나 보완 요청을 적어주세요",
+      required: "필수",
+      requiredComment: "선택한 항목에 대한 코멘트를 입력해 주세요",
+      requiredField: "필수 입력 항목을 채워 주세요",
+    },
     en: {
       submit: "Submit",
       submitted: "✓ Submitted",
       selected: "{n} selected",
+      detailsLabel: "Additional details",
+      detailsPlaceholder: "Add your reasoning or requested changes",
+      required: "Required",
+      requiredComment: "Add a comment for the selected option",
+      requiredField: "Fill in the required fields",
     },
   };
   const lang = document.documentElement.dataset.lang || "en";
@@ -32,6 +49,8 @@
     bindSliders();
     bindRanking();
     bindMatrix();
+    bindFields();
+    bindOptionComments();
 
     const btn = document.querySelector(".bk-vs-submit");
     if (btn) {
@@ -60,6 +79,7 @@
     });
     if (!wasSelected) item.classList.add("selected");
     hasInteracted = true;
+    syncConditionalFields();
     updateSubmitState();
   }
 
@@ -78,6 +98,7 @@
         });
         if (!wasSelected) item.classList.add("selected");
         hasInteracted = true;
+        syncConditionalFields();
         updateSubmitState();
       });
     });
@@ -99,9 +120,201 @@
   function toggleCheck(item) {
     item.classList.toggle("checked");
     hasInteracted = true;
+    syncConditionalFields();
     updateSubmitState();
   }
 
+  function bindFields() {
+    document.querySelectorAll(".bk-textarea").forEach(function (container) {
+      if (container.querySelector("textarea")) return;
+      var textarea = document.createElement("textarea");
+      textarea.className = "bk-textarea-control";
+      textarea.name = container.dataset.name || "";
+      textarea.placeholder = container.dataset.placeholder || "";
+      textarea.rows = Number(container.dataset.rows || 4);
+      textarea.maxLength = container.dataset.maxlength
+        ? Number(container.dataset.maxlength)
+        : -1;
+      mountField(container, textarea);
+    });
+
+    document.querySelectorAll(".bk-input").forEach(function (container) {
+      if (container.querySelector("input")) return;
+      var input = document.createElement("input");
+      input.className = "bk-input-control";
+      input.name = container.dataset.name || "";
+      input.type = container.dataset.type || "text";
+      input.placeholder = container.dataset.placeholder || "";
+      input.maxLength = container.dataset.maxlength
+        ? Number(container.dataset.maxlength)
+        : -1;
+      mountField(container, input);
+    });
+  }
+
+  function mountField(container, control) {
+    container.classList.add("bk-field");
+
+    if (container.dataset.label) {
+      var label = document.createElement("label");
+      label.className = "bk-field-label";
+      label.textContent = container.dataset.label;
+      if (container.hasAttribute("data-required")) {
+        var required = document.createElement("span");
+        required.className = "required";
+        required.textContent = "*";
+        label.appendChild(required);
+      }
+      container.appendChild(label);
+    }
+
+    if (container.dataset.help) {
+      var help = document.createElement("div");
+      help.className = "bk-field-help";
+      help.textContent = container.dataset.help;
+      container.appendChild(help);
+    }
+
+    control.addEventListener("click", function (e) {
+      e.stopPropagation();
+    });
+    control.addEventListener("input", function () {
+      hasInteracted = true;
+      updateSubmitState();
+    });
+
+    container.appendChild(control);
+  }
+
+  function bindOptionComments() {
+    document.querySelectorAll(COMMENTABLE_SELECTOR).forEach(function (item) {
+      var needsComment =
+        item.hasAttribute("data-requires-comment") || !!item.dataset.commentName;
+      if (!needsComment || item.querySelector(".bk-option-comment")) return;
+
+      var wrapper = document.createElement("div");
+      wrapper.className = "bk-option-comment";
+      wrapper.hidden = true;
+
+      var label = document.createElement("label");
+      label.className = "bk-field-label";
+      label.textContent = item.dataset.commentLabel || t.detailsLabel;
+      if (item.hasAttribute("data-requires-comment")) {
+        var required = document.createElement("span");
+        required.className = "required";
+        required.textContent = "*";
+        label.appendChild(required);
+      }
+      wrapper.appendChild(label);
+
+      var textarea = document.createElement("textarea");
+      textarea.className = "bk-textarea-control";
+      textarea.placeholder =
+        item.dataset.commentPlaceholder || t.detailsPlaceholder;
+      textarea.rows = Number(item.dataset.commentRows || 3);
+      textarea.addEventListener("click", function (e) {
+        e.stopPropagation();
+      });
+      textarea.addEventListener("input", function () {
+        hasInteracted = true;
+        updateSubmitState();
+      });
+      wrapper.appendChild(textarea);
+
+      item.appendChild(wrapper);
+    });
+
+    syncConditionalFields();
+  }
+
+  function syncConditionalFields() {
+    document.querySelectorAll(COMMENTABLE_SELECTOR).forEach(function (item) {
+      var comment = item.querySelector(".bk-option-comment");
+      if (!comment) return;
+      var selected =
+        item.classList.contains("selected") || item.classList.contains("checked");
+      comment.hidden = !selected;
+    });
+  }
+
+  function readControlValue(container) {
+    var control = container.querySelector("input, textarea");
+    if (!control) return "";
+    return String(control.value || "").trim();
+  }
+
+  function collectStandaloneFields(state) {
+    var fields = {};
+    var hasFields = false;
+
+    document.querySelectorAll(".bk-textarea, .bk-input").forEach(function (el) {
+      var name = el.dataset.name;
+      if (!name) return;
+      var value = readControlValue(el);
+      if (!value) return;
+      if (el.dataset.responseKey === "comment" || name === "comment") {
+        state.comment = value;
+        return;
+      }
+      fields[name] = value;
+      hasFields = true;
+    });
+
+    if (hasFields) state.fields = fields;
+  }
+
+  function collectOptionComments(state) {
+    var optionComments = {};
+    var optionCommentCount = 0;
+    var fields = state.fields || {};
+    var hasFields = !!state.fields;
+
+    document.querySelectorAll(COMMENTABLE_SELECTOR).forEach(function (item) {
+      var selected =
+        item.classList.contains("selected") || item.classList.contains("checked");
+      if (!selected) return;
+      var commentWrap = item.querySelector(".bk-option-comment");
+      if (!commentWrap) return;
+      var textarea = commentWrap.querySelector("textarea");
+      var value = textarea ? String(textarea.value || "").trim() : "";
+      if (!value) return;
+      if (item.dataset.value) {
+        optionComments[item.dataset.value] = value;
+        optionCommentCount += 1;
+      }
+      if (item.dataset.commentName) {
+        fields[item.dataset.commentName] = value;
+        hasFields = true;
+      }
+    });
+
+    if (optionCommentCount > 0) state.option_comments = optionComments;
+    if (hasFields) state.fields = fields;
+  }
+
+  function getValidationError() {
+    var requiredFieldMissing = false;
+    document.querySelectorAll(".bk-textarea, .bk-input").forEach(function (el) {
+      if (!el.hasAttribute("data-required")) return;
+      if (!readControlValue(el)) requiredFieldMissing = true;
+    });
+    if (requiredFieldMissing) return t.requiredField;
+
+    var requiredCommentMissing = false;
+    document.querySelectorAll(COMMENTABLE_SELECTOR).forEach(function (item) {
+      var selected =
+        item.classList.contains("selected") || item.classList.contains("checked");
+      if (!selected || !item.hasAttribute("data-requires-comment")) return;
+      var commentWrap = item.querySelector(".bk-option-comment");
+      if (!commentWrap || !readControlValue(commentWrap)) {
+        requiredCommentMissing = true;
+      }
+    });
+    if (requiredCommentMissing) return t.requiredComment;
+
+    return "";
+  }
+
   /* ── Sliders ── */
   function bindSliders() {
     document.querySelectorAll(".bk-slider").forEach(function (container) {
@@ -345,6 +558,9 @@
     });
     if (hasMatrix) state.matrix = matrix;
 
+    collectStandaloneFields(state);
+    collectOptionComments(state);
+
     return state;
   }
 
@@ -365,11 +581,13 @@
   function updateSubmitState() {
     var btn = document.querySelector(".bk-vs-submit");
     if (!btn || btn.classList.contains("submitted")) return;
-    /* Enable if user has interacted with any interactable component */
+    var status = document.querySelector(".bk-vs-status");
+    var validationError = getValidationError();
     var hasInteractable = document.querySelector(
-      ".bk-options, .bk-cards, .bk-checklist, .bk-code-compare, .bk-slider, .bk-ranking, .bk-matrix, .bk-mockup-gallery, .bk-mockup-item",
+      ".bk-options, .bk-cards, .bk-checklist, .bk-code-compare, .bk-slider, .bk-ranking, .bk-matrix, .bk-mockup-gallery, .bk-mockup-item, .bk-textarea, .bk-input",
     );
-    btn.disabled = !(hasInteractable && hasInteracted);
+    btn.disabled = !(hasInteractable && hasInteracted) || !!validationError;
+    if (status) status.textContent = validationError;
   }
 
   /* ── Boot ── */

package/dist/assets/mcp/server.js

@@ -21228,9 +21228,16 @@ SELECTION (collect choices):
 
 INPUT (collect values):
 - bk-slider: Numeric. data-name, data-min, data-max, data-value, data-unit on .bk-slider. Contains label.
+- bk-input: Short text input. data-name, data-label, data-placeholder, optional data-required, and optional data-response-key="comment".
+- bk-textarea: Long-form memo field. data-name, data-label, data-placeholder, optional data-required, and optional data-response-key="comment".
 - 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.
 
+OPTION-LEVEL FEEDBACK:
+- Any selectable item (.bk-option, .bk-card, .bk-code-option, .bk-mockup-item, .bk-check-item) may add data-requires-comment to force a memo before submit.
+- Optional data-comment-name stores that memo into response.fields[data-comment-name].
+- Optional data-comment-label and data-comment-placeholder customize the inline memo UI.
+
 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.
@@ -21240,7 +21247,7 @@ DISPLAY (no values):
 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}}}
+{selections: ["a"], values: {budget: 70}, ranking: ["security","ux"], matrix: {auth: {x:0.8,y:0.9}}, comment: "Tighten the pricing section", fields: {change_request: "Add rainy-day fallback"}, option_comments: {b: "Keep this option but improve lodging details"}}
 Only populated fields are included.`,
     {
       task_id: { type: "number" },
@@ -21859,10 +21866,31 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           args
         );
         const createdId = created?.data?.id;
+        let nodeVerification;
+        if (createdId !== void 0 && Array.isArray(args.nodes)) {
+          const expectedCount = args.nodes.length;
+          const createdCount = Array.isArray(
+            created?.data?.nodes
+          ) ? (created.data?.nodes ?? []).length : 0;
+          const verified = await client.request(
+            "GET",
+            `/api/workflows/${createdId}`
+          );
+          const verifiedCount = Array.isArray(verified?.data?.nodes) ? verified.data.nodes.length : 0;
+          nodeVerification = {
+            expected_count: expectedCount,
+            created_count: createdCount,
+            verified_count: verifiedCount,
+            mismatch: createdCount !== expectedCount || verifiedCount !== expectedCount
+          };
+        }
         return wrap({
           ...created,
           ...createdId !== void 0 && {
             webui_url: `${apiUrl.replace(/\/$/, "")}/workflows/${createdId}`
+          },
+          ...nodeVerification && {
+            node_verification: nodeVerification
           }
         });
       }
@@ -21884,13 +21912,42 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         const workflowId = requireNumberArg(args, "workflow_id");
         const body = { ...args };
         delete body.workflow_id;
-        return wrap(
-          await client.request(
-            "POST",
-            `/api/workflows/${workflowId}/nodes`,
-            body
-          )
+        logNodeMutationAudit("append_node.request", {
+          workflow_id: workflowId,
+          payload: sanitizeNodeMutationPayload(body)
+        });
+        const beforeNodes = await fetchWorkflowNodeSnapshot(workflowId);
+        const appended = await client.request(
+          "POST",
+          `/api/workflows/${workflowId}/nodes`,
+          body
         );
+        const afterNodes = await fetchWorkflowNodeSnapshot(workflowId);
+        const verification = buildNodeMutationVerification({
+          mutation: "append_node",
+          beforeNodes,
+          afterNodes,
+          expectedDelta: 1,
+          expectedNodeId: appended?.data?.id ?? null
+        });
+        logNodeMutationAudit("append_node.verification", {
+          workflow_id: workflowId,
+          verification
+        });
+        if (verification.mismatch) {
+          logNodeMutationAudit("append_node.mismatch", {
+            workflow_id: workflowId,
+            payload: sanitizeNodeMutationPayload(body),
+            verification
+          });
+          throw new Error(
+            `append_node verification failed for workflow ${workflowId}: ${JSON.stringify(verification)}`
+          );
+        }
+        return wrap({
+          ...appended,
+          node_verification: verification
+        });
       }
       case "insert_node": {
         const workflowId = requireNumberArg(args, "workflow_id");
@@ -21898,13 +21955,45 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         const body = { ...args };
         delete body.workflow_id;
         delete body.after_step;
-        return wrap(
-          await client.request(
-            "POST",
-            `/api/workflows/${workflowId}/nodes?after=${afterStep}`,
-            body
-          )
+        logNodeMutationAudit("insert_node.request", {
+          workflow_id: workflowId,
+          after_step: afterStep,
+          payload: sanitizeNodeMutationPayload(body)
+        });
+        const beforeNodes = await fetchWorkflowNodeSnapshot(workflowId);
+        const inserted = await client.request(
+          "POST",
+          `/api/workflows/${workflowId}/nodes?after=${afterStep}`,
+          body
         );
+        const afterNodes = await fetchWorkflowNodeSnapshot(workflowId);
+        const verification = buildNodeMutationVerification({
+          mutation: "insert_node",
+          beforeNodes,
+          afterNodes,
+          expectedDelta: 1,
+          expectedNodeId: inserted?.data?.id ?? null
+        });
+        logNodeMutationAudit("insert_node.verification", {
+          workflow_id: workflowId,
+          after_step: afterStep,
+          verification
+        });
+        if (verification.mismatch) {
+          logNodeMutationAudit("insert_node.mismatch", {
+            workflow_id: workflowId,
+            after_step: afterStep,
+            payload: sanitizeNodeMutationPayload(body),
+            verification
+          });
+          throw new Error(
+            `insert_node verification failed for workflow ${workflowId}: ${JSON.stringify(verification)}`
+          );
+        }
+        return wrap({
+          ...inserted,
+          node_verification: verification
+        });
       }
       case "update_node": {
         const workflowId = requireNumberArg(args, "workflow_id");
@@ -21915,7 +22004,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         return wrap(
           await client.request(
             "PATCH",
-            `/api/workflows/${workflowId}/node-items/${nodeId}`,
+            `/api/workflows/${workflowId}/nodes/${nodeId}`,
             body
           )
         );
@@ -21926,7 +22015,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         return wrap(
           await client.request(
             "DELETE",
-            `/api/workflows/${workflowId}/node-items/${nodeId}`
+            `/api/workflows/${workflowId}/nodes/${nodeId}`
           )
         );
       }
@@ -22184,6 +22273,72 @@ function wrapError(message) {
     isError: true
   };
 }
+function logNodeMutationAudit(event, data) {
+  const record2 = {
+    ts: (/* @__PURE__ */ new Date()).toISOString(),
+    scope: "node-mutation-audit",
+    event,
+    ...data
+  };
+  console.error(JSON.stringify(record2));
+}
+function sanitizeNodeMutationPayload(payload) {
+  const out = {};
+  const allowedKeys = [
+    "title",
+    "node_type",
+    "instruction",
+    "instruction_id",
+    "credential_id",
+    "hitl",
+    "visual_selection",
+    "loop_back_to"
+  ];
+  for (const key of allowedKeys) {
+    if (key in payload) {
+      out[key] = payload[key];
+    }
+  }
+  if (typeof out["instruction"] === "string") {
+    out["instruction_preview"] = String(out["instruction"]).slice(0, 160);
+    delete out["instruction"];
+  }
+  return out;
+}
+async function fetchWorkflowNodeSnapshot(workflowId) {
+  const workflow = await client.request("GET", `/api/workflows/${workflowId}`);
+  const nodes = Array.isArray(workflow?.data?.nodes) ? workflow.data.nodes : [];
+  return nodes.map((node) => ({
+    id: Number(node["id"]),
+    step_order: typeof node["step_order"] === "number" ? node["step_order"] : null,
+    title: typeof node["title"] === "string" ? node["title"] : null,
+    node_type: typeof node["node_type"] === "string" ? node["node_type"] : null
+  }));
+}
+function buildNodeMutationVerification(input) {
+  const beforeIds = new Set(input.beforeNodes.map((node) => node.id));
+  const addedNodes = input.afterNodes.filter((node) => !beforeIds.has(node.id));
+  const expectedCount = input.beforeNodes.length + input.expectedDelta;
+  const countDelta = input.afterNodes.length - input.beforeNodes.length;
+  const mismatch = input.afterNodes.length !== expectedCount || countDelta !== input.expectedDelta || addedNodes.length !== input.expectedDelta || input.expectedNodeId !== null && !addedNodes.some((node) => node.id === input.expectedNodeId);
+  return {
+    mutation: input.mutation,
+    before_count: input.beforeNodes.length,
+    after_count: input.afterNodes.length,
+    expected_count: expectedCount,
+    delta: countDelta,
+    expected_delta: input.expectedDelta,
+    expected_node_id: input.expectedNodeId,
+    added_node_ids: addedNodes.map((node) => node.id),
+    added_nodes: addedNodes.map((node) => ({
+      id: node.id,
+      step_order: node.step_order,
+      title: node.title,
+      node_type: node.node_type
+    })),
+    mismatch
+  };
+}
 async function scanRepoLocal(args) {
   const scanPath = args["path"];
   if (typeof scanPath !== "string" || scanPath.trim().length === 0) {

package/dist/assets/skills/bk-design/SKILL.md

@@ -108,6 +108,15 @@ Call `create_workflow`:
 }
 ```
 
+<HARD-RULE>
+Immediately validate the `create_workflow` result before doing anything else:
+
+- If the response includes `node_verification`, require `node_verification.mismatch === false`.
+- If `nodes` were supplied to `create_workflow`, treat that call as the only allowed initial node creation step.
+- Never append the same planned nodes after `create_workflow(nodes=[...])` because an older server response showed `data.nodes=[]`.
+- If verification fails, STOP and investigate. Do not continue with `append_node` or `insert_node`.
+</HARD-RULE>
+
 ### Step 6: Report Result + Open in Browser
 
 On success, open the workflow detail page in the browser:
@@ -336,11 +345,14 @@ Place two mockup cards side by side using display:grid;grid-template-columns:1fr
 ## Node Modification Strategy
 
 <HARD-RULE>
+- Before any structural edit, refresh the current workflow structure from the server and use the latest node ids / step orders as the source of truth.
 - Update a single node → `update_node(workflow_id, node_id, ...only changed fields)`
 - Append a node (at the end) → `append_node(workflow_id, title, instruction, node_type, loop_back_to?, visual_selection?)`
 - Insert a node (in the middle) → `insert_node(workflow_id, after_step=N, title, instruction, node_type, loop_back_to?, visual_selection?)`
 - Delete a node → `remove_node(workflow_id, node_id)`
 - Never use `update_workflow(nodes=[...])` for full replacement unless a complete redesign is intended
+- After every `append_node` or `insert_node`, inspect the returned `node_verification`.
+- If `node_verification.mismatch === true`, STOP immediately and do not continue issuing more structural edits from the current plan snapshot.
 </HARD-RULE>
 
 ## Inline vs Template Instructions

package/dist/assets/skills/bk-import/SKILL.md

@@ -191,6 +191,15 @@ Call `create_workflow`:
 }
 ```
 
+<HARD-RULE>
+Immediately validate the `create_workflow` result:
+
+- If the response includes `node_verification`, require `node_verification.mismatch === false`.
+- If `nodes` were supplied to `create_workflow`, do not follow with `append_node` for the same imported step set.
+- Never treat an older `data.nodes=[]` response shape as evidence that the initial nodes were not created.
+- If verification fails, STOP and investigate instead of patching the workflow incrementally.
+</HARD-RULE>
+
 ## Step 8: Report Result + Open in Browser
 
 On success:

package/dist/assets/skills/bk-improve/SKILL.md

@@ -119,6 +119,15 @@ remove_node(workflow_id=67, node_id=115)
 When editing in place, apply each change as a separate `update_node`, `insert_node`, `append_node`, or `remove_node` call. Never use `update_workflow(nodes=[...])` for in-place edits — it replaces ALL nodes and loses node IDs.
 </HARD-RULE>
 
+<HARD-RULE>
+Before any structural edit session:
+
+- Refresh the current workflow structure from the server and use the latest node ids / step orders as the source of truth.
+- Do not rely on a stale node snapshot captured before other edits or user actions.
+- After every `append_node` or `insert_node`, inspect the returned `node_verification`.
+- If `node_verification.mismatch === true`, STOP immediately and do not continue applying edits from the current plan.
+</HARD-RULE>
+
 After all changes, report:
 
 ```
@@ -186,9 +195,12 @@ When improving a node with `visual_selection: true`:
 ## Node Modification Strategy
 
 <HARD-RULE>
+- Before any structural edit, refresh the current workflow structure from the server and use the latest node ids / step orders as the source of truth.
 - Update a single node → `update_node(workflow_id, node_id, ...only changed fields)`
 - Append a node (at the end) → `append_node(workflow_id, title, instruction, node_type, loop_back_to?, visual_selection?)`
 - Insert a node (in the middle) → `insert_node(workflow_id, after_step=N, title, instruction, node_type, loop_back_to?, visual_selection?)`
 - Delete a node → `remove_node(workflow_id, node_id)`
 - Never use `update_workflow(nodes=[...])` for full replacement unless a complete redesign is intended
+- After every `append_node` or `insert_node`, inspect the returned `node_verification`.
+- If `node_verification.mismatch === true`, STOP immediately and do not continue issuing more structural edits from the current plan snapshot.
 </HARD-RULE>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bluekiwi",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "BlueKiwi CLI — install MCP client and skills into your agent runtime",
   "license": "MIT",
   "repository": {