quiver-cli 1.3.0 → 2.0.0

package/template/.agents/skills/design/impeccable/scripts/live/insert-ui.mjs

@@ -1,458 +0,0 @@
-/**
- * Pure helpers for live-mode insert UI (browser + tests).
- * Kept separate from live-browser.js so insert logic is unit-testable.
- */
-
-export const PLACEHOLDER_DEFAULT_HEIGHT = 80;
-export const PLACEHOLDER_MIN_HEIGHT = 48;
-export const PLACEHOLDER_MIN_WIDTH = 120;
-
-/** @typedef {'before' | 'after'} InsertPosition */
-/** @typedef {'row' | 'column'} InsertAxis */
-
-/**
- * Infer sibling flow axis from a container's computed layout styles.
- * @param {{ display?: string, flexDirection?: string, gridTemplateColumns?: string, gridAutoFlow?: string }} style
- * @returns {InsertAxis}
- */
-export function detectInsertAxisFromStyle(style) {
-  const display = style?.display || 'block';
-  if (display.includes('flex')) {
-    const dir = style.flexDirection || 'row';
-    return dir.startsWith('row') ? 'row' : 'column';
-  }
-  if (display === 'grid' || display === 'inline-grid') {
-    const flow = style.gridAutoFlow || 'row';
-    if (flow.includes('column')) return 'column';
-    const cols = (style.gridTemplateColumns || '').trim();
-    if (cols && cols !== 'none') {
-      const colCount = cols.split(/\s+/).filter(Boolean).length;
-      if (colCount > 1) return 'row';
-    }
-    return 'row';
-  }
-  return 'column';
-}
-
-/**
- * Pick insertion side from pointer position against an anchor element box.
- * @param {number} clientX
- * @param {number} clientY
- * @param {{ top: number, left: number, width: number, height: number, bottom?: number, right?: number }} rect
- * @param {InsertAxis} [axis]
- * @returns {InsertPosition}
- */
-export function computeInsertPosition(clientX, clientY, rect, axis = 'column') {
-  if (!rect) return 'after';
-  if (axis === 'row') {
-    if (!Number.isFinite(rect.left) || !Number.isFinite(rect.width) || rect.width <= 0) return 'after';
-    const mid = rect.left + rect.width / 2;
-    return clientX < mid ? 'before' : 'after';
-  }
-  if (!Number.isFinite(rect.top) || !Number.isFinite(rect.height) || rect.height <= 0) return 'after';
-  const mid = rect.top + rect.height / 2;
-  return clientY < mid ? 'before' : 'after';
-}
-
-/**
- * Whether Create is allowed for an insert session.
- * Requires a non-empty prompt OR at least one annotation.
- */
-export function canCreateInsert({ prompt, comments, strokes }) {
-  const hasPrompt = typeof prompt === 'string' && prompt.trim().length > 0;
-  const hasComments = Array.isArray(comments) && comments.length > 0;
-  const hasStrokes = Array.isArray(strokes) && strokes.some(
-    (s) => Array.isArray(s?.points) && s.points.length >= 2,
-  );
-  return hasPrompt || hasComments || hasStrokes;
-}
-
-/** Tooltip/title when Create is disabled. */
-export function insertCreateDisabledReason({ prompt, comments, strokes }) {
-  if (canCreateInsert({ prompt, comments, strokes })) return null;
-  return 'Add a prompt or annotate the placeholder to create';
-}
-
-/**
- * Fixed-position insert line coordinates (viewport px).
- * @param {{ top: number, left: number, width: number, height: number, bottom?: number, right?: number }} rect
- * @param {InsertPosition} position
- * @param {InsertAxis} [axis]
- */
-export function insertLineCoords(rect, position, axis = 'column') {
-  if (axis === 'row') {
-    const right = rect.right ?? rect.left + rect.width;
-    const x = position === 'before' ? rect.left - 2 : right + 2;
-    return { axis: 'row', top: rect.top, left: x, width: 0, height: rect.height };
-  }
-  const bottom = rect.bottom ?? rect.top + rect.height;
-  const y = position === 'before' ? rect.top - 2 : bottom + 2;
-  return { axis: 'column', top: y, left: rect.left, width: rect.width, height: 0 };
-}
-
-/** Cursor while hovering an insert boundary. */
-export function cursorForInsertAxis(axis) {
-  return axis === 'row' ? 'ew-resize' : 'ns-resize';
-}
-
-function groupSiblingRows(siblings, rowThreshold = 8) {
-  const sorted = [...siblings].sort((a, b) => a.rect.top - b.rect.top || a.rect.left - b.rect.left);
-  const rows = [];
-  for (const entry of sorted) {
-    let placed = false;
-    for (const row of rows) {
-      if (Math.abs(entry.rect.top - row[0].rect.top) <= rowThreshold) {
-        row.push(entry);
-        placed = true;
-        break;
-      }
-    }
-    if (!placed) rows.push([entry]);
-  }
-  return rows;
-}
-
-function horizontalOverlap(a, b) {
-  const left = Math.max(a.left, b.left);
-  const right = Math.min(a.right ?? a.left + a.width, b.right ?? b.left + b.width);
-  return Math.max(0, right - left);
-}
-
-/**
- * Hit-test the gap between adjacent siblings (flex rows, grid columns, stacked blocks).
- * @param {number} clientX
- * @param {number} clientY
- * @param {Array<{ el: unknown, rect: { top: number, left: number, width: number, height: number, bottom?: number, right?: number } }>} siblings
- * @param {{ slop?: number, minOverlap?: number }} [opts]
- */
-export function hitSiblingInsertGap(clientX, clientY, siblings, opts = {}) {
-  if (!Array.isArray(siblings) || siblings.length < 2) return null;
-  const slop = opts.slop ?? 12;
-  const minOverlap = opts.minOverlap ?? 0.25;
-
-  for (const row of groupSiblingRows(siblings)) {
-    if (row.length < 2) continue;
-    const sorted = [...row].sort((a, b) => a.rect.left - b.rect.left);
-    for (let i = 0; i < sorted.length - 1; i++) {
-      const a = sorted[i];
-      const b = sorted[i + 1];
-      const aRight = a.rect.right ?? a.rect.left + a.rect.width;
-      const bLeft = b.rect.left;
-      if (bLeft <= aRight) continue;
-      const top = Math.max(a.rect.top, b.rect.top);
-      const aBottom = a.rect.bottom ?? a.rect.top + a.rect.height;
-      const bBottom = b.rect.bottom ?? b.rect.top + b.rect.height;
-      const bottom = Math.min(aBottom, bBottom);
-      const span = bottom - top;
-      const minH = Math.min(a.rect.height, b.rect.height);
-      if (span < minH * minOverlap) continue;
-
-      const inX = clientX >= aRight - slop && clientX <= bLeft + slop;
-      const inY = clientY >= top - slop && clientY <= bottom + slop;
-      if (!inX || !inY) continue;
-
-      const midX = (aRight + bLeft) / 2;
-      return {
-        anchor: b.el,
-        position: 'before',
-        axis: 'row',
-        line: { axis: 'row', left: midX, top, width: 0, height: span },
-      };
-    }
-  }
-
-  const sortedCol = [...siblings].sort((a, b) => a.rect.top - b.rect.top || a.rect.left - b.rect.left);
-  for (let i = 0; i < sortedCol.length - 1; i++) {
-    const a = sortedCol[i];
-    const b = sortedCol[i + 1];
-    const overlap = horizontalOverlap(a.rect, b.rect);
-    const minW = Math.min(a.rect.width, b.rect.width);
-    if (overlap < minW * minOverlap) continue;
-
-    const aBottom = a.rect.bottom ?? a.rect.top + a.rect.height;
-    const gapTop = aBottom;
-    const gapBottom = b.rect.top;
-    if (gapBottom <= gapTop) continue;
-
-    const overlapLeft = Math.max(a.rect.left, b.rect.left);
-    const overlapRight = Math.min(
-      a.rect.right ?? a.rect.left + a.rect.width,
-      b.rect.right ?? b.rect.left + b.rect.width,
-    );
-    const inY = clientY >= gapTop - slop && clientY <= gapBottom + slop;
-    const inX = clientX >= overlapLeft - slop && clientX <= overlapRight + slop;
-    if (!inY || !inX) continue;
-
-    const midY = (gapTop + gapBottom) / 2;
-    return {
-      anchor: b.el,
-      position: 'before',
-      axis: 'column',
-      line: { axis: 'column', top: midY, left: overlapLeft, width: overlap, height: 0 },
-    };
-  }
-
-  return null;
-}
-
-/**
- * Resolve insert hover target, side, axis, and indicator line for the pointer.
- */
-export function resolveInsertHover({ clientX, clientY, target, rect, axis, siblings }) {
-  const gap = hitSiblingInsertGap(clientX, clientY, siblings);
-  if (gap) return gap;
-
-  const position = computeInsertPosition(clientX, clientY, rect, axis);
-  const line = insertLineCoords(rect, position, axis);
-  return { anchor: target, position, axis, line };
-}
-
-/**
- * How the in-flow placeholder should participate in layout.
- * Prefer implicit sizing (flex / %) so row inserts don't inherit the full parent width in px.
- * @returns {{ kind: 'flex', flex: string, minWidth: number } | { kind: 'percent' } | { kind: 'auto' } | { kind: 'explicit', width: number }}
- */
-export function placeholderSizing({ axis, parentDisplay, parentWidth, anchorFlex }) {
-  const display = parentDisplay || 'block';
-  const w = Number.isFinite(parentWidth) ? parentWidth : 0;
-
-  if (axis === 'row') {
-    if (display.includes('flex')) {
-      const flex = anchorFlex && anchorFlex !== 'none' && anchorFlex !== '0 1 auto'
-        ? anchorFlex
-        : '1 1 0';
-      return { kind: 'flex', flex, minWidth: 0 };
-    }
-    if (display === 'grid' || display === 'inline-grid') {
-      return { kind: 'auto' };
-    }
-  }
-
-  if (w >= PLACEHOLDER_MIN_WIDTH) {
-    return { kind: 'percent' };
-  }
-
-  return {
-    kind: 'explicit',
-    width: Math.max(PLACEHOLDER_MIN_WIDTH, w || PLACEHOLDER_MIN_WIDTH),
-  };
-}
-
-/** Width kinds that need materializing to px before edge-resize. */
-export function placeholderWidthIsImplicit(kind) {
-  return kind === 'flex' || kind === 'percent' || kind === 'auto';
-}
-
-/**
- * Clamp user-resized placeholder dimensions.
- */
-export function clampPlaceholderSize(width, height, parentWidth, opts = {}) {
-  const minW = opts.minWidth ?? PLACEHOLDER_MIN_WIDTH;
-  const minH = opts.minHeight ?? PLACEHOLDER_MIN_HEIGHT;
-  const maxW = opts.maxWidth ?? Math.max(minW, parentWidth || minW);
-  return {
-    width: Math.min(maxW, Math.max(minW, Math.round(width))),
-    height: Math.max(minH, Math.round(height)),
-  };
-}
-
-/** CSS cursor for a placeholder edge resize handle. */
-export function cursorForPlaceholderEdge(edge) {
-  if (edge === 'n' || edge === 's') return 'ns-resize';
-  if (edge === 'e' || edge === 'w') return 'ew-resize';
-  return 'default';
-}
-
-/**
- * Compute placeholder box after dragging one edge (in-flow margins shift for n/w).
- * @param {{ width: number, height: number, marginLeft?: number, marginTop?: number }} start
- * @param {'n'|'e'|'s'|'w'} edge
- * @param {number} dx pointer delta X since drag start
- * @param {number} dy pointer delta Y since drag start
- * @param {number} parentWidth
- */
-export function resizePlaceholderFromEdge(start, edge, dx, dy, parentWidth, opts = {}) {
-  const base = {
-    width: start.width,
-    height: start.height,
-    marginLeft: start.marginLeft ?? 0,
-    marginTop: start.marginTop ?? 0,
-  };
-  if (edge === 'e') base.width = start.width + dx;
-  else if (edge === 'w') {
-    base.width = start.width - dx;
-    base.marginLeft = start.marginLeft + dx;
-  } else if (edge === 's') base.height = start.height + dy;
-  else if (edge === 'n') {
-    base.height = start.height - dy;
-    base.marginTop = start.marginTop + dy;
-  }
-
-  const clamped = clampPlaceholderSize(base.width, base.height, parentWidth, opts);
-  if (edge === 'w') {
-    base.marginLeft = start.marginLeft + start.width - clamped.width;
-  } else if (edge === 'n') {
-    base.marginTop = start.marginTop + start.height - clamped.height;
-  }
-
-  return {
-    width: clamped.width,
-    height: clamped.height,
-    marginLeft: Math.round(base.marginLeft),
-    marginTop: Math.round(base.marginTop),
-  };
-}
-
-/** Pick and insert toggles are independent but turning one ON turns the other OFF. */
-export function applyPickToggle(pickActive, insertActive) {
-  const nextPick = !pickActive;
-  return {
-    pickActive: nextPick,
-    insertActive: nextPick ? false : insertActive,
-  };
-}
-
-export function applyInsertToggle(pickActive, insertActive) {
-  const nextInsert = !insertActive;
-  return {
-    pickActive: nextInsert ? false : pickActive,
-    insertActive: nextInsert,
-  };
-}
-
-/**
- * Build the browser generate payload for insert mode.
- */
-export function buildInsertGeneratePayload({
-  id,
-  count,
-  pageUrl,
-  anchorContext,
-  position,
-  placeholder,
-  freeformPrompt,
-  comments,
-  strokes,
-  screenshotPath,
-}) {
-  const payload = {
-    type: 'generate',
-    mode: 'insert',
-    id,
-    count,
-    pageUrl,
-    insert: {
-      position,
-      anchor: anchorContext,
-    },
-    placeholder,
-    freeformPrompt: freeformPrompt?.trim() || undefined,
-  };
-  if (comments?.length) payload.comments = comments;
-  if (strokes?.length) payload.strokes = strokes;
-  if (screenshotPath) payload.screenshotPath = screenshotPath;
-  return payload;
-}
-
-/**
- * Whether a variant wrapper is currently shown (handles `hidden` and display:none).
- * @param {{ hidden?: boolean, style?: { display?: string } } | null | undefined} el
- */
-export function isVariantShown(el) {
-  if (!el) return false;
-  if (el.hidden) return false;
-  if (el.style?.display === 'none') return false;
-  return true;
-}
-
-/**
- * Show or hide a variant wrapper for cycling.
- * @param {{ hidden?: boolean, style?: { display?: string }, removeAttribute?: (name: string) => void, setAttribute?: (name: string, value?: string) => void } | null | undefined} el
- * @param {boolean} shown
- */
-export function setVariantShown(el, shown) {
-  if (!el) return;
-  if (shown) {
-    el.removeAttribute?.('hidden');
-    if (el.style) el.style.display = '';
-  } else {
-    el.setAttribute?.('hidden', '');
-    if (el.style) el.style.display = 'none';
-  }
-}
-
-/**
- * Pick the best live anchor during an insert session (placeholder until variants land).
- * @param {{
- *   wrapper?: unknown,
- *   variantCount?: number,
- *   visibleVariant?: number,
- *   placeholder?: unknown,
- *   insertAnchor?: unknown,
- *   pickVariantContent?: (wrapper: unknown, index: number) => unknown,
- * }} opts
- */
-export function resolveInsertSessionAnchor(opts) {
-  const {
-    wrapper,
-    variantCount = 0,
-    visibleVariant = 0,
-    placeholder,
-    insertAnchor,
-    pickVariantContent,
-  } = opts || {};
-  if (wrapper && variantCount > 0 && visibleVariant > 0 && pickVariantContent) {
-    const vis = pickVariantContent(wrapper, visibleVariant);
-    if (vis) return vis;
-  }
-  return placeholder || insertAnchor || null;
-}
-
-/**
- * Snapshot placeholder geometry + anchor fingerprint so HMR can recreate the box.
- * @param {{
- *   tagName?: string,
- *   className?: string,
- *   textContent?: string,
- * }} anchor
- * @param {{
- *   offsetWidth?: number,
- *   offsetHeight?: number,
- *   style?: { marginLeft?: string, marginTop?: string },
- * }} placeholder
- * @param {{ position: 'before' | 'after', layoutAxis?: 'row' | 'column' }} meta
- */
-export function buildInsertPlaceholderSnapshot(anchor, placeholder, { position, layoutAxis }) {
-  return {
-    width: Math.round(placeholder.offsetWidth || 0),
-    height: Math.round(placeholder.offsetHeight || PLACEHOLDER_DEFAULT_HEIGHT),
-    marginLeft: parseFloat(placeholder.style?.marginLeft || '') || 0,
-    marginTop: parseFloat(placeholder.style?.marginTop || '') || 0,
-    position,
-    layoutAxis: layoutAxis || 'column',
-    anchorTag: anchor.tagName || 'DIV',
-    anchorClasses: anchor.className || '',
-    anchorText: (anchor.textContent || '').trim().slice(0, 120),
-  };
-}
-
-/**
- * Re-find an insert anchor after framework HMR replaced the live DOM node.
- * @param {Pick<Document, 'body' | 'querySelectorAll'>} doc
- * @param {ReturnType<typeof buildInsertPlaceholderSnapshot> | null | undefined} snapshot
- * @param {Element | null | undefined} liveAnchor
- */
-export function findInsertAnchorInDom(doc, snapshot, liveAnchor = null) {
-  if (liveAnchor && doc.body.contains(liveAnchor)) return liveAnchor;
-  if (!snapshot) return null;
-  const tag = (snapshot.anchorTag || 'div').toLowerCase();
-  const cls = (snapshot.anchorClasses || '').split(/\s+/).filter(Boolean)[0];
-  const needle = snapshot.anchorText || '';
-  const sel = cls ? `${tag}.${cls}` : tag;
-  const candidates = doc.querySelectorAll(sel);
-  for (const candidate of candidates) {
-    if (needle && !(candidate.textContent || '').includes(needle.slice(0, 40))) continue;
-    return candidate;
-  }
-  return null;
-}

package/template/.agents/skills/design/impeccable/scripts/live/instructions.mjs

@@ -1,142 +0,0 @@
-/**
- * Just-in-time agent instructions for live mode.
- *
- * The live scripts, not the reference doc, own situational plumbing: every
- * event printed by live-poll carries an `_instructions` string describing
- * exactly what to do NEXT, with real ids, paths, and line numbers already
- * substituted and only the active path's rules included (a svelte-component
- * session never sees JSX guidance, and vice versa). live.md stays lean: the
- * session contract, harness policy, and design-quality guidance that is not
- * situational (identity lock, variation axes, parameter budgets).
- *
- * Keep these strings imperative, concrete, and short. They are read by an
- * agent mid-session; every sentence must earn its tokens. Instructions are
- * versioned with the scripts, so they cannot drift from behavior the way a
- * hand-maintained doc can.
- */
-
-const PLAN_POINTER = 'Plan per live.md section 4: extract the identity lock, pick default vs departure mode, commit each variant to a DIFFERENT primary axis, squint-test the trio. Size parameter knobs per section 7 budgets.';
-
-function pollCmd(scriptsPath) {
-  return `node ${scriptsPath}/live-poll.mjs`;
-}
-
-function replyCmd(scriptsPath, id, rest) {
-  return `${pollCmd(scriptsPath)} --reply ${id} ${rest}`;
-}
-
-export function instructionsForEvent(event, { scriptsPath = '{{scripts_path}}' } = {}) {
-  if (!event || typeof event !== 'object') return undefined;
-  switch (event.type) {
-    case 'generate':
-      return generateInstructions(event, scriptsPath);
-    case 'steer':
-      return `Do what the message asks (page edits, navigation help, or a short answer). Then reply exactly once: ${replyCmd(scriptsPath, event.id, 'steer_done ["optional short toast"]')} (on failure: --reply ${event.id} error "Short reason"). No pickup ack; poll again immediately after.`;
-    case 'prefetch':
-      return `Speculative pre-read, no reply owed: resolve ${JSON.stringify(event.pageUrl || '/')} to its source file (root "/" is usually the boot's pageFile; multi-page sites map /foo to public/foo/index.html; SPAs map all routes to one entry), read it into context, then poll again. Skip if you cannot resolve it confidently.`;
-    case 'variant_mount_failed':
-      return `The browser could NOT render variant ${event.variant}${event.url ? ` (module: ${event.url})` : ''}${event.error ? `: ${String(event.error).slice(0, 200)}` : ''}. The user sees a persistent error card, not variants. Fix the variant source files, then reply ${replyCmd(scriptsPath, event.id, 'done --file <manifest or source path>')}; the browser retries on its own. Poll again after the reply.`;
-    case 'accept':
-      return acceptInstructions(event, scriptsPath);
-    case 'discard':
-      return event?._completionAck?.ok === true
-        ? 'Original restored and durable completion acknowledged; nothing to do. Poll again.'
-        : `Completion was not acknowledged: run node ${scriptsPath}/live-complete.mjs --id ${event.id} --discarded, then poll again.`;
-    case 'manual_edit_apply':
-      return `The user already clicked Apply; never ask, discard, or redirect. Delegate the source edits to the impeccable_manual_edit_applier subagent when available (pass cwd, scripts path, event id, page URL, chunk/deadline, batch, evidencePath); it must not poll or reply. ${event.repair ? 'A `repair` payload is present: the previous Apply changed source but validation failed; fix the CURRENT source, never roll back yourself. ' : ''}Reply exactly once: ${replyCmd(scriptsPath, event.id, `done --data '{"status":"done","appliedEntryIds":[...],"failed":[],"files":[...],"notes":[]}'`)} (status "partial"/"error" with failed[] when not every entry applied). Then poll again.`;
-    case 'timeout':
-      return 'No event arrived; poll again immediately.';
-    case 'exit':
-      return `Session over: kill any background poll, then node ${scriptsPath}/live-server.mjs stop (removes the injected script tag). Sweep leftover impeccable-variants-start / impeccable-carbonize-start markers from source.`;
-    default:
-      return undefined;
-  }
-}
-
-function generateInstructions(event, scriptsPath) {
-  const id = event.id;
-  const scaffold = event.scaffold;
-  const steps = [];
-
-  if (event.screenshotPath) {
-    steps.push(`Read the annotated screenshot first: ${event.screenshotPath}. Comment {x,y} positions bind text to the child under that point; strokes read by shape (loop = emphasis on this thing, arrow = direction, cross = delete).`);
-  } else {
-    steps.push('No screenshot was sent (the user did not annotate); do not ask for one and do not screenshot the page. Work from element.outerHTML, the computed styles, and the prompt.');
-  }
-
-  if (event.mode === 'insert') {
-    steps.push(insertScaffoldInstructions(event, scriptsPath));
-  } else if (scaffold?.previewMode === 'svelte-component') {
-    steps.push(svelteComponentInstructions(event, scaffold, scriptsPath));
-  } else if (scaffold && scaffold.sourceWritten === false) {
-    steps.push(deferredWrapperInstructions(event, scaffold, scriptsPath));
-  } else if (scaffold) {
-    steps.push(`The wrapper is already written into ${scaffold.file}. Splice preview CSS plus all ${event.count} variants at line ${scaffold.insertLine} in ONE edit, following the returned cssAuthoring contract (styleTag, selector strategy, forbidden patterns). Each variant div holds exactly ONE top-level element (same tag as the original); first visible, others display: none.`);
-  } else {
-    steps.push(`Preflight could not scaffold${event.scaffoldError ? ` (${event.scaffoldError})` : ''}. Run node ${scriptsPath}/live-wrap.mjs --id ${id} --count ${event.count} --element-id "${event.element?.id || ''}" --classes "${(event.element?.classes || []).join(',')}" --tag "${event.element?.tagName || ''}" --text "<first ~80 chars of the picked element's textContent>". Keep the flags separate; --text disambiguates repeated siblings. On a fallback error, follow live.md's Handle fallback.`);
-  }
-
-  steps.push(event.action && event.action !== 'impeccable'
-    ? `Action is "${event.action}": read reference/${event.action}.md before planning; its MUST params are non-negotiable. ${PLAN_POINTER}`
-    : `Freeform action: work from SKILL.md rules plus craft-floor.md; no sub-command file. ${PLAN_POINTER}`);
-
-  steps.push(`When all ${event.count} variants are delivered: ${replyCmd(scriptsPath, id, 'done --file <project-root-relative path you wrote>')}. Then poll again. If generation fails after the browser flipped to GENERATING, reply --reply ${id} error "Short reason" so the bar resets (never live-accept --discard for this).`);
-
-  return steps.map((s, i) => `${i + 1}. ${s}`).join('\n');
-}
-
-function svelteComponentInstructions(event, scaffold, scriptsPath) {
-  const dir = scaffold.componentDir;
-  const count = event.count;
-  return `Svelte component preview. EDIT the existing stubs ${dir}/v1.svelte ... v${count}.svelte in place; never delete or recreate them; do not read them back (the prop-substituted markup is in scaffold.componentStubMarkup). Keep the stub's control flow ({#each}, {#if}) and propContract prop names exactly; never flatten a loop into literal items. The stub <style> is seeded with the source rules that style the selection; restyle or delete freely, and know that any seeded rule you do not re-declare is REMOVED from source on accept (the preview never applied it). ALL your CSS goes inside that ONE existing <style> block: Svelte forbids a second top-level style element, and a publish with a non-compiling variant is bounced back to you with file and line. Semantic class selectors only: no @scope, no data-impeccable-* attributes. Params go in ${dir}/params.json keyed by variant number (never an attribute); author knob CSS against var(--p-<id>, default) and :global([data-p-<id>="..."]). Reply with --file ${scaffold.file}. Accept later merges everything into ${scaffold.sourceFile} mechanically; you have no post-accept cleanup.`;
-}
-
-function deferredWrapperInstructions(event, scaffold, scriptsPath) {
-  const insertNote = Number(scaffold.replaceEndLine) < Number(scaffold.replaceStartLine)
-    ? ` (replaceEndLine < replaceStartLine: this is an INSERTION at line ${scaffold.replaceStartLine}; remove nothing)`
-    : '';
-  return `The wrapper is NOT in source yet. In ONE edit to ${scaffold.file}: splice preview CSS plus all ${event.count} variants into scaffold.wrapperBlock at the "Variants: insert below this line" marker, then replace lines ${scaffold.replaceStartLine}-${scaffold.replaceEndLine}${insertNote} with the result. Two separate writes reload the framework mid-publish and strand the browser at 0/N. Author CSS per the returned cssAuthoring contract; each variant div holds exactly ONE top-level element (same tag as the original); first visible, others display: none. On JSX/TSX wrap the <style> content in a template literal and use className / style={{...}}.`;
-}
-
-function insertScaffoldInstructions(event, scriptsPath) {
-  const scaffold = event.scaffold;
-  const base = `Insert mode: net-new content sized around ${event.placeholder?.width || '?'}x${event.placeholder?.height || '?'} at the chosen anchor; load craft-floor.md before writing net-new markup.`;
-  if (scaffold?.previewMode === 'svelte-component') {
-    return `${base} Write each inserted variant as a single-root Svelte component under ${scaffold.componentDir} (no data-impeccable-* attributes, CSS in each component's <style>). Never edit the route during generation; reply with --file ${scaffold.file}.`;
-  }
-  if (scaffold && scaffold.sourceWritten === false) {
-    return `${base} Splice your variants into scaffold.wrapperBlock at the marker and insert the result at line ${scaffold.replaceStartLine} of ${scaffold.file} in ONE edit.`;
-  }
-  return `${base} If no scaffold payload is present, run node ${scriptsPath}/live-insert.mjs --id ${event.id} --count ${event.count} --position ${event.insert?.position || 'after'} with the anchor flags from event.insert.anchor, then splice variants at the returned insertLine.`;
-}
-
-function acceptInstructions(event, scriptsPath) {
-  const result = event._acceptResult || {};
-  const ackOk = event._completionAck?.ok === true;
-  const prefix = ackOk ? '' : `Completion was NOT acknowledged: run node ${scriptsPath}/live-status.mjs, finish any cleanup, then node ${scriptsPath}/live-complete.mjs --id ${event.id}. `;
-
-  if (result.handled === true && result.carbonize === true) {
-    return `${prefix}Carbonize cleanup is REQUIRED now, before the next poll, in ${result.file}: (1) locate the impeccable-carbonize-start/end block and read the impeccable-param-values comment; (2) move the CSS rules into the stylesheet that owns this area; (3) bake params while rewriting selectors (@scope wrappers to semantic classes, keep only the chosen data-p branch, substitute range literals); (4) unwrap the accepted content and drop every data-impeccable-* / data-p-* attribute; (5) delete the inline <style>, the param-values comment, and both markers plus dead @scope rules. Then run node ${scriptsPath}/live-complete.mjs --id ${event.id} and verify phase "completed"; it refuses with source_dirty while leftovers remain. Poll again only after that.`;
-  }
-  if (result.handled === true) {
-    return `${prefix}Accept was merged into source mechanically; nothing to clean up. Poll again.`;
-  }
-  if (result.mode === 'fallback') {
-    return `${prefix}The session lived in a generated file, so accept refused to persist there. Write the accepted variant into the true source you identified during Handle fallback, remove the temporary wrapper from the served file, then poll again.`;
-  }
-  if (result.mode === 'error') {
-    if (result.error === 'source_locked') {
-      return `${prefix}The source file is briefly locked by a publisher. Re-run the exact same live-accept.mjs command (idempotent); do NOT hand-edit the file, and do not poll past this.`;
-    }
-    if (result.error === 'accept_receipt_conflict') {
-      return `${prefix}This session already resolved as ${result.priorOperation || 'a prior operation'}; do not edit anything. Run node ${scriptsPath}/live-status.mjs and tell the user what the session resolved to.`;
-    }
-    return `${prefix}Accept failed: ${result.error || 'unknown error'}. Source was not touched; do not hand-edit. Run node ${scriptsPath}/live-status.mjs before continuing.`;
-  }
-  return `${prefix}No mechanical accept result; read ${result.file || 'the session source file'}, find the impeccable markers, and finish the merge by hand. Poll again after.`;
-}
-
-/** Boot instructions attached to live.mjs's success payload. */
-export function bootInstructions({ scriptsPath = '{{scripts_path}}' } = {}) {
-  return `Open the app URL that serves a pageFiles entry (never serverPort; that is the helper). Then start the poll loop per your harness policy in live.md and re-run ${pollCmd(scriptsPath)} immediately after every event or reply. Every event carries _instructions: follow them; they are the authoritative next step with real ids and paths filled in. A poll that is running is a poll you are SERVICING: never announce you are waiting and idle your turn; stay on the exec session until it returns an event, and never end a turn while a poll is outstanding.`;
-}