@foldspace_npm/harness 0.1.20 → 0.1.21

package/CLAUDE.md

@@ -77,8 +77,9 @@ at the app or testing in it, run `npx foldspace badge working` (a bar across
 the top of the window says Foldspace is building here, leave it alone) and say
 so in chat: *"I'm going to work in that Chrome window for a few minutes -
 please leave it alone until I tell you it's ready."* When it is their turn,
-`npx foldspace badge ready --text "<the question this experience answers>"` -
-the bar adds "Try asking:" and a Copy button itself - and say the same in chat. `foldspace badge label` puts the small
+`npx foldspace badge ready` takes the pill away (the small corner tag comes
+back) and in chat you say what to try. No bar for their turn: they may type
+whatever, whenever; the pill only ever asks them to wait. `foldspace badge label` puts the small
 corner tag back; `off` removes it, for a screenshot they will share.
 
 Navigation, uploads, extraction and anything that writes are a later session.

package/bin/attach.mjs

@@ -225,7 +225,8 @@ const SDK_PATTERNS = [
 //   label   - the small corner tag (default): who is attached, which mode
 //   working - a pill at the foot of the window: the agent is building in this
 //             window, please leave it alone
-//   ready   - the same pill: it is the human's turn, with the question to try
+//   ready   - the pill goes away and the small tag comes back: their turn.
+//             No bar for that - they may type whatever, whenever
 // The pill sits bottom-left, never across the top: a bar there covered the
 // app's own header and menu (seen on a CRM, 2026-09-22). The agent's panel
 // is on the right, so bottom-left is the corner nothing else uses.
@@ -252,34 +253,18 @@ const badgeSrc = `(() => {
     if (s.state === "working") {
       // Attention, not decoration: a pulsing marker, the ask in bold, and an
       // animated line underneath so it reads as "in progress" at a glance.
-      b.style.cssText = base + "top:auto;bottom:16px;left:16px;right:auto;max-width:min(560px,calc(100vw - 32px));border-radius:8px;overflow:hidden;background:#1F2A8A;padding:10px 14px 13px;font-size:13px;letter-spacing:.02em;text-align:left;line-height:1.3;";
+      b.style.cssText = base + "top:auto;bottom:16px;left:16px;right:auto;max-width:min(560px,calc(100vw - 32px));border-radius:8px;overflow:hidden;background:#3247F2;padding:10px 14px 13px;font-size:13px;letter-spacing:.02em;text-align:left;line-height:1.3;";
       b.innerHTML =
         '<style>@keyframes fsPulse{0%,100%{opacity:1}50%{opacity:.25}}@keyframes fsSweep{0%{left:-30%}100%{left:100%}}' +
-        '#foldspace-dev-badge .fs-dot{display:inline-block;width:10px;height:10px;border-radius:50%;background:#FFB300;margin-right:10px;vertical-align:middle;animation:fsPulse 1s ease-in-out infinite}' +
+        '#foldspace-dev-badge .fs-dot{display:inline-block;width:10px;height:10px;border-radius:50%;background:#FFD314;margin-right:10px;vertical-align:middle;animation:fsPulse 1s ease-in-out infinite}' +
         '#foldspace-dev-badge .fs-line{position:absolute;left:0;right:0;bottom:0;height:3px;background:rgba(255,255,255,.15);overflow:hidden}' +
-        '#foldspace-dev-badge .fs-line::after{content:"";position:absolute;top:0;width:30%;height:100%;background:#FFB300;animation:fsSweep 1.4s linear infinite}</style>' +
-        '<span class="fs-dot"></span>Foldspace is building your agent on this page. <b style="color:#FFD54F">Please leave this window alone</b> until Claude says it is ready.' +
+        '#foldspace-dev-badge .fs-line::after{content:"";position:absolute;top:0;width:30%;height:100%;background:#FFD314;animation:fsSweep 1.4s linear infinite}</style>' +
+        '<span class="fs-dot"></span>Foldspace is building your agent on this page. <b style="color:#FFD314">Please leave this window alone</b> until the agent says it is ready.' +
         (s.text ? " " + s.text.replace(/[<>&]/g, (c) => ({ "<": "&lt;", ">": "&gt;", "&": "&amp;" })[c]) : "") +
         '<span class="fs-line"></span>';
-    } else if (s.state === "ready") {
-      // Calm, and useful: the question to try, with a Copy button so nobody
-      // retypes it into the panel. The bar accepts clicks only on that button.
-      const esc = (t) => String(t).replace(/[<>&"]/g, (c) => ({ "<": "&lt;", ">": "&gt;", "&": "&amp;", '"': "&quot;" })[c]);
-      const question = s.text ? esc(s.text) : "";
-      b.style.cssText = base + "top:auto;bottom:16px;left:16px;right:auto;max-width:min(560px,calc(100vw - 32px));border-radius:8px;overflow:hidden;background:#0F9D58;padding:10px 14px;font-size:13px;letter-spacing:.02em;text-align:left;line-height:1.3;pointer-events:none;";
-      b.innerHTML =
-        '<style>#foldspace-dev-badge .fs-copy{pointer-events:auto;margin-left:12px;padding:4px 10px;border:1px solid rgba(255,255,255,.7);border-radius:4px;background:transparent;color:#fff;font:inherit;font-size:12px;cursor:pointer;letter-spacing:0}' +
-        '#foldspace-dev-badge .fs-copy:hover{background:rgba(255,255,255,.15)}</style>' +
-        '<b>Ready - your turn.</b> ' +
-        (question ? 'Try asking: <span class="fs-q">' + question + '</span><button class="fs-copy" type="button">Copy</button>' : "Open your agent and try it.");
-      const btn = b.querySelector(".fs-copy");
-      if (btn) btn.addEventListener("click", () => {
-        const q = b.querySelector(".fs-q")?.textContent || "";
-        const done = () => { btn.textContent = "Copied"; setTimeout(() => { btn.textContent = "Copy"; }, 1500); };
-        if (navigator.clipboard?.writeText) navigator.clipboard.writeText(q).then(done, done);
-        else { const ta = document.createElement("textarea"); ta.value = q; document.body.appendChild(ta); ta.select(); try { document.execCommand("copy"); } catch (e) {} ta.remove(); done(); }
-      });
     } else {
+      // "ready" and "label" both draw the small tag: their turn needs no bar -
+      // they may type whatever, whenever. Only the wait ever gets a pill.
       b.style.cssText = base + "background:#3247F2;padding:5px 10px;border-bottom-right-radius:4px;";
       b.textContent = LABEL;
     }

package/bin/badge.mjs

@@ -2,14 +2,14 @@
 /**
  * foldspace badge <working|ready|label|off> [--text "<what to show>"]
  *
- * Sets the banner the attach badge draws across the top of the test window.
- * The agent and the human share that one Chrome window, so the banner says
- * whose turn it is:
+ * Sets the pill the attach badge draws at the foot of the test window.
+ * The agent and the human share that one Chrome window, so the pill says
+ * when to wait:
  *   working - "Foldspace is building your agent on this page. Please leave
- *             this window alone until Claude says it is ready."
- *   ready   - "Ready - your turn. Open your agent and try it." (pass --text
- *             with the question to try)
- *   label   - back to the small corner tag
+ *             this window alone until the agent says it is ready."
+ *   ready   - the pill goes away, the small corner tag comes back: their
+ *             turn. No bar for that - they may type whatever, whenever.
+ *   label   - the small corner tag
  *   off     - remove it
  * The state is kept in the page's sessionStorage, so it survives navigation;
  * attach's badge script redraws within a second. Nothing else on the page is

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foldspace_npm/harness",
-  "version": "0.1.20",
+  "version": "0.1.21",
   "description": "Build and verify portable Foldspace action artifacts against a live app.",
   "type": "module",
   "bin": {

package/src/badge-core.mjs

@@ -10,8 +10,8 @@ export function badgePayload(state, text) {
   }
   const payload = { state: wanted };
   if (text !== undefined) {
-    if (wanted !== "working" && wanted !== "ready") {
-      throw new Error(`--text only applies to working or ready (got ${wanted}).`);
+    if (wanted !== "working") {
+      throw new Error(`--text only applies to working (got ${wanted}); their turn needs no bar.`);
     }
     const clean = String(text).replace(/\s+/g, " ").trim();
     if (!clean) throw new Error("--text is empty.");

package/src/cli-registry.mjs

@@ -321,7 +321,7 @@ export const CLI_COMMANDS = Object.freeze([
     name: "badge",
     entry: "badge.mjs",
     group: "verify",
-    summary: "Set the banner across the top of the test window: working, ready, label or off",
+    summary: "Set the pill at the foot of the test window: working (leave it alone), ready (pill away), label or off",
     usage: 'foldspace badge <working|ready|label|off> [--text "<what to show>"]',
     risk: "browser-session",
     environment: "local-chrome",
@@ -332,18 +332,18 @@ export const CLI_COMMANDS = Object.freeze([
         name: "state",
         required: true,
         description:
-          "working: the agent is building here, leave the window alone | ready: the human's turn | label: the small corner tag | off: remove it",
+          "working: the agent is building here, leave the window alone | ready: the pill goes away, their turn | label: the small corner tag | off: remove it",
       }),
     ],
     options: [
-      value("--text", "text", "working/ready: the line to show, e.g. the question to try (one line, up to 160 characters)"),
+      value("--text", "text", "working only: one extra line under the ask (up to 160 characters)"),
     ],
     prerequisites: ["foldspace attach is running (it draws the badge)"],
     effects: [
       "Writes one key to the test window's sessionStorage; touches nothing else on the page",
-      "The banner survives navigation inside the test window",
+      "The pill survives navigation inside the test window",
     ],
-    next: ["Tell the human in chat what the banner says"],
+    next: ["Say in chat whose turn it is and what to try"],
   }),
   Object.freeze({
     name: "deploy",