sensorium-mcp 3.1.3-board.4 → 3.1.3-board.5

package/dist/board/components/Card.js

@@ -6,6 +6,7 @@
 
 import StatusChip from "./StatusChip.js";
 import PriorityChip from "./PriorityChip.js";
+import { providerLabel, retryLabel } from "./rateLimit.js";
 
 export default {
   name: "Card",
@@ -21,7 +22,11 @@ export default {
       const mins = Math.max(0, Math.round((Date.now() - new Date(props.card.startedAt)) / 60000));
       return mins >= 60 ? Math.floor(mins / 60) + "h " + (mins % 60) + "m" : mins + "m";
     }
-    return { emit, elapsed };
+    function rlText() {
+      const p = providerLabel(props.card);
+      return (p ? p + " · " : "") + retryLabel(props.card);
+    }
+    return { emit, elapsed, rlText };
   },
   template: `
     <article class="card" role="listitem" tabindex="0"
@@ -29,6 +34,10 @@ export default {
       @keydown.enter="emit('open', card)">
       <h3 class="card__title">{{ card.title }}</h3>
       <p v-if="card.description" class="card__desc">{{ card.description }}</p>
+      <div v-if="card.status === 'rate_limited'" class="card__rl">
+        <svg viewBox="0 0 12 12" width="11" height="11" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round" aria-hidden="true"><circle cx="6" cy="6" r="4.6"></circle><path d="M6 3.6V6l1.8 1.2"></path></svg>
+        <span>rate limited · {{ rlText() }}</span>
+      </div>
       <div class="card__foot">
         <PriorityChip :priority="card.priority" />
         <span class="chip chip--muted">{{ card.type }}</span>

package/dist/board/components/Combobox.js

@@ -0,0 +1,78 @@
+/**
+ * Combobox — ✅ EDITABLE. Editable dropdown: free-text input + curated
+ * suggestions (optionally grouped). Pure: modelValue in, update:modelValue out.
+ * `groups`: [{ label|null, options: string[] }] — label null renders flat.
+ * The user may pick a suggestion OR type any value.
+ */
+
+import { computed, onMounted, onUnmounted, ref } from "../vendor/vue.esm-browser.js";
+
+export default {
+  name: "Combobox",
+  props: {
+    modelValue: { type: String, default: "" },
+    groups: { type: Array, default: () => [] },
+    placeholder: { type: String, default: "" },
+  },
+  emits: ["update:modelValue"],
+  setup(props, { emit }) {
+    const open = ref(false);
+    const rootEl = ref(null);
+    const filtered = computed(() => {
+      const q = (props.modelValue || "").trim().toLowerCase();
+      const out = [];
+      for (const g of props.groups) {
+        const opts = q ? g.options.filter((o) => o.toLowerCase().includes(q)) : g.options;
+        if (opts.length) out.push({ label: g.label || null, options: opts });
+      }
+      return out;
+    });
+    function onInput(e) {
+      emit("update:modelValue", e.target.value);
+      open.value = true;
+    }
+    function pick(o) {
+      emit("update:modelValue", o);
+      open.value = false;
+    }
+    function onDoc(e) {
+      if (rootEl.value && !rootEl.value.contains(e.target)) open.value = false;
+    }
+    function onKey(e) {
+      if (e.key === "Escape") open.value = false;
+    }
+    onMounted(() => {
+      document.addEventListener("click", onDoc, true);
+      document.addEventListener("keydown", onKey);
+    });
+    onUnmounted(() => {
+      document.removeEventListener("click", onDoc, true);
+      document.removeEventListener("keydown", onKey);
+    });
+    return { open, rootEl, filtered, onInput, pick };
+  },
+  template: `
+    <div class="dropdown combobox" ref="rootEl">
+      <div class="combobox__wrap">
+        <input class="input combobox__input" :value="modelValue" :placeholder="placeholder"
+          role="combobox" :aria-expanded="open" aria-autocomplete="list"
+          @input="onInput" @focus="open = true" />
+        <button type="button" class="combobox__toggle" :class="{ 'is-open': open }"
+          aria-label="Show suggestions" tabindex="-1" @click="open = !open">▾</button>
+      </div>
+      <ul v-if="open && filtered.length" class="dropdown__menu" role="listbox">
+        <template v-for="g in filtered" :key="g.label || '_'">
+          <li v-if="g.label" class="combobox__group" role="presentation">{{ g.label }}</li>
+          <li v-for="o in g.options" :key="o">
+            <button type="button" class="dropdown__opt" role="option"
+              :aria-selected="o === modelValue" :class="{ 'is-selected': o === modelValue }"
+              @click="pick(o)">
+              <span class="dropdown__optlabel">{{ o }}</span>
+              <span v-if="o === modelValue" class="dropdown__check">✓</span>
+            </button>
+          </li>
+        </template>
+      </ul>
+    </div>
+  `,
+};

package/dist/board/components/CommentComposer.js

@@ -6,6 +6,9 @@ import { ref } from "../vendor/vue.esm-browser.js";
 
 export default {
   name: "CommentComposer",
+  props: {
+    busy: { type: Boolean, default: false },
+  },
   emits: ["submit"],
   setup(props, { emit }) {
     const text = ref("");
@@ -20,7 +23,7 @@ export default {
   template: `
     <form class="composer" @submit.prevent="send">
       <textarea class="input input--area" v-model="text" rows="2" placeholder="Add a comment…"></textarea>
-      <button class="btn btn--primary" type="submit" :disabled="!text.trim()">Comment</button>
+      <button class="btn btn--primary" type="submit" :disabled="!text.trim() || busy">{{ busy ? 'Sending…' : 'Comment' }}</button>
     </form>
   `,
 };

package/dist/board/components/Lane.js

@@ -4,6 +4,7 @@
  */
 
 import Card from "./Card.js";
+import { computed } from "../vendor/vue.esm-browser.js";
 
 export default {
   name: "Lane",
@@ -16,13 +17,17 @@ export default {
   },
   emits: ["open"],
   setup(props, { emit }) {
-    return { emit };
+    const rateLimited = computed(() => props.cards.filter((c) => c.status === "rate_limited").length);
+    return { emit, rateLimited };
   },
   template: `
     <section class="lane" :class="'lane--' + status" role="listitem">
       <header class="lane__head">
         <span class="lane__dot"></span>
         <h2 class="lane__title">{{ title }}</h2>
+        <span v-if="rateLimited" class="lane__rl" :title="rateLimited + ' card(s) waiting on a provider rate limit'">
+          <svg viewBox="0 0 12 12" width="10" height="10" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round" aria-hidden="true"><circle cx="6" cy="6" r="4.6"></circle><path d="M6 3.6V6l1.8 1.2"></path></svg>{{ rateLimited }}
+        </span>
         <span class="lane__count">{{ cards.length }}</span>
       </header>
       <div class="lane__body">

package/dist/board/components/StateBanner.js

@@ -7,6 +7,7 @@ export default {
   props: {
     loading: { type: Boolean, default: false },
     error: { type: [String, null], default: null },
+    retryable: { type: Boolean, default: true },
   },
   emits: ["retry"],
   setup(props, { emit }) {
@@ -14,9 +15,10 @@ export default {
   },
   template: `
     <div v-if="error" class="notice notice--error">
-      <span>{{ error }}</span>
-      <button class="btn btn--ghost btn--sm" type="button" @click="emit('retry')">Retry</button>
+      <svg viewBox="0 0 16 16" width="15" height="15" fill="none" stroke="currentColor" stroke-width="1.4" stroke-linecap="round" aria-hidden="true" style="flex:none"><circle cx="8" cy="8" r="6.2"></circle><path d="M8 4.8V8.6M8 11.2v.1"></path></svg>
+      <span class="notice__msg">{{ error }}</span>
+      <button v-if="retryable" class="btn btn--ghost btn--sm" type="button" @click="emit('retry')">Retry</button>
     </div>
-    <div v-else-if="loading" class="notice notice--info">Loading…</div>
+    <div v-else-if="loading" class="notice notice--info"><span class="spinner" aria-hidden="true"></span>Loading…</div>
   `,
 };

package/dist/board/components/StatusChip.js

@@ -9,6 +9,7 @@ const LABELS = {
   decision_needed: "Decision needed",
   blocked: "Blocked",
   done: "Done",
+  rate_limited: "Rate limited",
 };
 
 export default {

package/dist/board/components/rateLimit.js

@@ -0,0 +1,19 @@
+/**
+ * rate_limited helpers — ✅ EDITABLE. Shared by Card tile, Lane badge and the
+ * card detail notice. Pure functions: card in, display strings out.
+ */
+
+export const PROVIDER_LABELS = { claude: "Claude", copilot: "Copilot" };
+
+/** Live countdown text derived from retryAt (null = unknown reset window). */
+export function retryLabel(card, now = Date.now()) {
+  if (!card.retryAt) return "retrying when limit resets";
+  const mins = Math.ceil((new Date(card.retryAt).getTime() - now) / 60000);
+  if (mins <= 0) return "retrying\u2026";
+  if (mins >= 60) return `retry in ~${Math.floor(mins / 60)}h ${mins % 60}m`;
+  return `retry in ~${mins}m`;
+}
+
+export function providerLabel(card) {
+  return PROVIDER_LABELS[card.rateLimitProvider] || "";
+}

package/dist/board/mock/fixtures.js

@@ -12,6 +12,8 @@
 const T0 = "2026-08-08T09:00:00.000Z";
 const T1 = "2026-08-08T12:30:00.000Z";
 const T2 = "2026-08-08T14:05:00.000Z";
+/** rate_limited demo: auto-retry ~30 minutes from page load. */
+const RETRY_AT = new Date(Date.now() + 30 * 60000).toISOString();
 
 /** @param {Partial<import('../api/contract.js').BoardCard>} o */
 function card(o) {
@@ -31,6 +33,8 @@ function card(o) {
     nextSpawnAt: null,
     workerThreadId: null,
     blockedReason: null,
+    rateLimitProvider: null,
+    retryAt: null,
     archivedAt: null,
     createdAt: T0,
     updatedAt: T0,
@@ -135,6 +139,36 @@ export const fixtures = {
       archivedAt: T1,
       profile: {},
     }),
+    card({
+      cardId: 8,
+      title: "Refactor comment threading into a tree view",
+      description: "Worker paused mid-run: Claude usage limit reached. Auto-retries when the window resets.",
+      acceptance: "Nested replies render as a collapsible tree; existing flat view unaffected.",
+      type: "feature",
+      laneThreadId: 101,
+      priority: 1,
+      status: "rate_limited",
+      workerThreadId: 9902,
+      startedAt: T1,
+      rateLimitProvider: "claude",
+      retryAt: RETRY_AT,
+      profile: { agentType: "claude", createBranch: true, runTests: true },
+    }),
+    card({
+      cardId: 9,
+      title: "Generate API usage examples for the docs site",
+      description: "Copilot credits exhausted for this billing window; card is parked until they replenish.",
+      acceptance: "Each public endpoint has a runnable example snippet.",
+      type: "chore",
+      laneThreadId: 202,
+      priority: 0,
+      status: "rate_limited",
+      workerThreadId: 9903,
+      startedAt: T2,
+      rateLimitProvider: "copilot",
+      retryAt: null,
+      profile: { agentType: "copilot" },
+    }),
   ],
 
   /** Keyed by cardId. */

package/dist/board/schema/policy.js

@@ -1,38 +1,40 @@
 /**
  * Card-builder "How" policy schema.  ✅ EDITABLE design-layer data.
  *
- * This is the single source of truth for the builder Step 2 ("How") controls.
- * A designer (Claude Design) edits the option lists / presets / phases here and
- * sees them live in the buildless preview — no build step, no code change in the
- * view. views/BuilderView.js renders this GENERICALLY: only the widget *types*
- * below are hardcoded (in the view's dispatch), never the options themselves.
+ * Single source of truth for the builder Step 2 ("How") controls, rendered
+ * GENERICALLY by views/BuilderView.js — only the widget *types* are hardcoded
+ * in the view's dispatch, never the options.
  *
- * It flows to the view through the frozen seam (mock/api.mock.js → useBuilder()),
- * so this file is design-tier just like views/ and components/ — NOT frozen.
- *
- * ── Widget vocabulary (the only hardcoded part) ──────────────────────────────
+ * ── Widget vocabulary ────────────────────────────────────────────────────────
  *   "select"    — single choice from `options` (dropdown)
+ *   "combobox"  — free-text input + curated per-provider suggestions
+ *                 (`suggestionsBy` maps the value of `dependsOn` to grouped lists)
  *   "segmented" — single choice from `options` (button group)
  *   "chips"     — multi-select subset of `options` (value is an array)
  *   "toggle"    — boolean on/off switch
- *   "phases"    — ordered list of [name, reviewFlag] pairs (editable in place)
+ *   "phases"    — ordered list of phase objects {name, review, provider, model}
+ *                 (per-phase provider/model override the card-level pick; "Inherit" / "" = card default)
+ *   "text"      — single-line free text
+ *   "textarea"  — multiline free text
+ *   "dirpicker" — directory-dialog button + chosen-path display (supports `required`)
+ *   "memory"    — 3-mode memory selector with a conditional sub-field:
+ *                 Ephemeral (none) / Existing thread (thread dropdown) /
+ *                 New persistent thread (name text input).
+ *                 Value: { mode, threadId, name }
  *
  * ── Field shape ──────────────────────────────────────────────────────────────
- *   { key, widget, label, desc?, options?, default }
- *   - key      unique id; also the value key on the compiled policy
- *   - widget   one of the vocabulary above
- *   - label    shown to the operator; also the compiled-policy row heading
- *   - desc     optional helper line (rendered under the label / switch)
- *   - options  choices for select / segmented / chips (ignored otherwise)
- *   - default  initial value (chips → array, phases → array of [name, bool])
+ *   { key, widget, label, desc?, options?, default, placeholder?, required?,
+ *     group?, inline? (rendered inside a parent accordion, skipped by the generic loop),
+ *     visibleIf?: {key, equals} — conditional visibility }
  */
 
-/** @typedef {"select"|"segmented"|"chips"|"toggle"|"phases"} PolicyWidget */
+/** @typedef {"select"|"segmented"|"chips"|"toggle"|"phases"|"text"|"textarea"|"dirpicker"|"memory"} PolicyWidget */
+
+export const MEMORY_MODES = ["Ephemeral", "Existing thread", "New persistent thread"];
 
 /**
- * Ordered list of How-step fields. Reorder / add / edit freely — the view
- * iterates this array in order and dispatches on `widget`.
- * @type {Array<{key:string, widget:PolicyWidget, label:string, desc?:string, options?:string[], default:*}>}
+ * Ordered list of How-step fields.
+ * @type {Array<{key:string, widget:PolicyWidget, label:string, desc?:string, options?:string[], default:*, placeholder?:string, required?:boolean}>}
  */
 export const POLICY_SCHEMA = [
   {
@@ -40,14 +42,37 @@ export const POLICY_SCHEMA = [
     widget: "segmented",
     label: "Provider",
     options: ["Claude", "Copilot", "Codex"],
-    default: "Claude",
+    default: "Copilot",
   },
   {
     key: "model",
-    widget: "select",
-    label: "Worker model",
-    options: ["Claude Haiku · fast", "Claude Sonnet · balanced", "Claude Opus · deep"],
-    default: "Claude Sonnet · balanced",
+    widget: "combobox",
+    label: "Model (optional)",
+    desc: "pick a suggestion or type any alias; empty = provider default",
+    placeholder: "e.g. claude-opus-4.8",
+    default: "",
+    dependsOn: "provider",
+    // Curated static suggestions per provider — no live API fetch.
+    suggestionsBy: {
+      Claude: [
+        { label: null, options: ["claude-opus-4-8", "claude-sonnet-4-6", "claude-haiku-4-5"] },
+      ],
+      Copilot: [
+        { label: "Anthropic (via Copilot)", options: ["claude-opus-4.8", "claude-sonnet-4.6"] },
+        { label: "OpenAI (via Copilot)", options: ["gpt-5.2", "gpt-5.2-codex", "o5-mini"] },
+      ],
+      Codex: [
+        { label: null, options: ["gpt-5.2-codex", "gpt-5.2", "o5-mini"] },
+      ],
+    },
+  },
+  {
+    key: "workdir",
+    widget: "dirpicker",
+    label: "Working directory",
+    desc: "the repo path this card's worker runs against",
+    required: true,
+    default: "",
   },
   {
     key: "skills",
@@ -57,13 +82,19 @@ export const POLICY_SCHEMA = [
     default: ["Git"],
   },
   {
-    key: "runIn",
-    widget: "select",
-    label: "Run in",
-    desc: "Where the worker executes",
-    // Base run targets; existing threads are appended by the seam in P1.
-    options: ["New worker", "New persistent thread"],
-    default: "New worker",
+    key: "autonomy",
+    widget: "segmented",
+    label: "Autonomy",
+    desc: "how often the worker checks in with you",
+    options: ["Autonomous", "Checkpoints", "Collaborative"],
+    default: "Autonomous",
+  },
+  {
+    key: "memory",
+    widget: "memory",
+    label: "Memory",
+    desc: "Where this card's worker (and any sub-workers it spawns) keep memory",
+    default: { mode: "Ephemeral", threadId: null, name: "" },
   },
   {
     key: "worktree",
@@ -71,34 +102,58 @@ export const POLICY_SCHEMA = [
     label: "Run in a git worktree",
     desc: "Isolated branch — nothing touches main until you merge",
     default: true,
-    // Compiled-policy phrasing (optional; falls back to "on"/"off").
     onText: "git worktree, merge on approval",
     offText: "direct on main",
   },
   {
-    key: "review",
+    key: "verifyDone",
     widget: "toggle",
-    label: "Expert code review",
-    desc: "A second model reviews the diff before completion",
+    label: "Verify acceptance (separate worker)",
+    desc: "A separate worker checks the acceptance criteria before moving to Done",
+    default: true,
+    onText: "verify acceptance → move to Done → notify you",
+    offText: "off",
+  },
+  {
+    key: "openPr",
+    widget: "toggle",
+    label: "Create pull request",
+    desc: "Open a PR when the work is ready (compiles into the worker prompt)",
     default: false,
-    onText: "expert pass before completion",
+    group: "pr",
+    onText: "create",
     offText: "off",
   },
   {
-    key: "verifyDone",
+    key: "prDraft",
     widget: "toggle",
-    label: "Verify on done",
-    desc: "Check the acceptance criteria before moving to Done (else an ephemeral check)",
+    label: "Draft PR",
+    desc: "Open as draft; mark ready after review",
     default: true,
-    onText: "verify acceptance → move to Done → notify you",
-    offText: "off",
+    group: "pr",
+    inline: true,
+    onText: "draft",
+    offText: "ready",
+  },
+  {
+    key: "prProvider",
+    widget: "select",
+    label: "Target",
+    desc: "Auto: detected from repo remote",
+    options: ["Auto", "GitHub", "Azure DevOps"],
+    default: "Auto",
+    group: "pr",
+    inline: true,
   },
   {
     key: "phases",
     widget: "phases",
     label: "Phases",
-    desc: "run in order",
-    default: [["Plan", true], ["Implement", false]],
+    desc: "run in order; each phase may toggle its own review and override provider/model",
+    default: [
+      { name: "Plan", review: true, provider: "Inherit", model: "" },
+      { name: "Implement", review: false, provider: "Inherit", model: "" },
+    ],
   },
 ];
 
@@ -106,10 +161,8 @@ export const POLICY_SCHEMA = [
  * Presets seed the whole How step (and the card `type`) in one click.
  * `values` is keyed by POLICY_SCHEMA field `key`; any key omitted falls back to
  * that field's `default`. Editing a control after applying a preset clears it.
- *
- * "Research" demonstrates a phase-less run (`phases: []` → "single pass").
- * "Full delivery" carries the canonical
- * Analysis → Plan → Implementation → Expert code review → Commit pipeline.
+ * (Adapted to the current field set: model is a free-text alias, memory
+ * replaces the old runIn.)
  * @type {Array<{name:string, type?:string, values:Object}>}
  */
 export const PRESETS = [
@@ -118,13 +171,17 @@ export const PRESETS = [
     type: "bug",
     values: {
       provider: "Claude",
-      model: "Claude Sonnet · balanced",
+      model: "",
       skills: ["Git", "Tests"],
-      runIn: "New worker",
+      autonomy: "Autonomous",
+      memory: { mode: "Ephemeral", threadId: null, name: "" },
       worktree: true,
-      review: true,
       verifyDone: true,
-      phases: [["Reproduce", false], ["Fix root cause", true], ["Verify", false]],
+      phases: [
+        { name: "Reproduce", review: false, provider: "Inherit", model: "" },
+        { name: "Fix root cause", review: true, provider: "Inherit", model: "" },
+        { name: "Verify", review: false, provider: "Inherit", model: "" },
+      ],
     },
   },
   {
@@ -132,13 +189,18 @@ export const PRESETS = [
     type: "feature",
     values: {
       provider: "Claude",
-      model: "Claude Opus · deep",
+      model: "claude-opus-4.8",
       skills: ["Git", "Tests", "Docs"],
-      runIn: "New worker",
+      autonomy: "Checkpoints",
+      memory: { mode: "Ephemeral", threadId: null, name: "" },
       worktree: true,
-      review: true,
       verifyDone: true,
-      phases: [["Plan", true], ["Implement", false], ["Test & document", true]],
+      phases: [
+        { name: "Plan", review: true, provider: "Inherit", model: "" },
+        { name: "Implement", review: false, provider: "Inherit", model: "" },
+        { name: "Test & document", review: true, provider: "Inherit", model: "" },
+        { name: "Final review", review: false, provider: "Inherit", model: "" },
+      ],
     },
   },
   {
@@ -146,18 +208,18 @@ export const PRESETS = [
     type: "feature",
     values: {
       provider: "Claude",
-      model: "Claude Opus · deep",
+      model: "claude-opus-4.8",
       skills: ["Git", "Tests", "Docs"],
-      runIn: "New persistent thread",
+      autonomy: "Checkpoints",
+      memory: { mode: "New persistent thread", threadId: null, name: "" },
       worktree: true,
-      review: true,
       verifyDone: true,
       phases: [
-        ["Analysis", false],
-        ["Plan", true],
-        ["Implementation", false],
-        ["Expert code review", true],
-        ["Commit", false],
+        { name: "Analysis", review: false, provider: "Inherit", model: "" },
+        { name: "Plan", review: true, provider: "Inherit", model: "" },
+        { name: "Implementation", review: false, provider: "Inherit", model: "" },
+        { name: "Final review", review: true, provider: "Inherit", model: "" },
+        { name: "Commit", review: false, provider: "Inherit", model: "" },
       ],
     },
   },
@@ -166,11 +228,11 @@ export const PRESETS = [
     type: "research",
     values: {
       provider: "Claude",
-      model: "Claude Sonnet · balanced",
+      model: "",
       skills: ["Web search", "Docs"],
-      runIn: "New worker",
+      autonomy: "Collaborative",
+      memory: { mode: "Ephemeral", threadId: null, name: "" },
       worktree: false,
-      review: false,
       verifyDone: false,
       phases: [],
     },
@@ -180,13 +242,16 @@ export const PRESETS = [
     type: "tech-debt",
     values: {
       provider: "Codex",
-      model: "Claude Sonnet · balanced",
+      model: "",
       skills: ["Git", "Tests"],
-      runIn: "New worker",
+      autonomy: "Autonomous",
+      memory: { mode: "Ephemeral", threadId: null, name: "" },
       worktree: true,
-      review: false,
       verifyDone: true,
-      phases: [["Map current structure", false], ["Migrate incrementally", true]],
+      phases: [
+        { name: "Map current structure", review: false, provider: "Inherit", model: "" },
+        { name: "Migrate incrementally", review: true, provider: "Inherit", model: "" },
+      ],
     },
   },
 ];