@bastani/atomic 0.9.13 → 0.9.14-alpha.2

package/dist/builtin/workflows/builtin/open-claude-design-feedback.ts

@@ -1,359 +0,0 @@
-/**
- * open-claude-design feedback threading.
- *
- * The `user-feedback-*` stages capture Playwright annotation feedback (user
- * notes + annotated snapshot) from the user. This module is the durable carrier
- * for that feedback: it parses the feedback-stage output, persists it as a
- * workflow artifact, and renders the user annotations that the next `generate-*`
- * stage must honor. cross-ref: issue #1464.
- */
-
-import { copyFileSync, existsSync, mkdirSync, statSync, writeFileSync } from "node:fs";
-import { isAbsolute, dirname, join, resolve, sep } from "node:path";
-
-/** A single captured user-feedback round. */
-export type PreviewFeedback = {
-  /** 1..N for generate/user-feedback loop iterations. */
-  readonly iteration: number;
-  /** Originating stage name, e.g. `user-feedback-1`. */
-  readonly stageName: string;
-  /** Full markdown result text emitted by the user-feedback stage. */
-  readonly text: string;
-  /** Extracted user annotation notes when the user actually annotated. */
-  readonly userNotes?: string;
-  /** Extracted annotated-snapshot artifact path when one was captured. */
-  readonly annotatedSnapshot?: string;
-  /** Extracted summary of the variants/edits the user accepted in the live QA session. */
-  readonly liveChanges?: string;
-  /** ISO timestamp when the feedback was captured. */
-  readonly capturedAt: string;
-};
-
-type PreviewResultLike = { readonly text?: string };
-
-/**
- * Field labels the user-feedback stages are instructed to emit, stored in
- * canonical (alphanumeric-only, lowercase) form. Used to bound multi-line value
- * extraction (a value ends when the next known field starts).
- */
-const FIELD_LABELS = new Set<string>([
-  "displaymethod",
-  "previewpath",
-  "previewfileurl",
-  "annotatedsnapshot",
-  "usernotes",
-  "livechanges",
-  "nextactionhint",
-  "manualopeninstructions",
-  "specpath",
-]);
-
-const PLACEHOLDER_TOKENS = new Set<string>([
-  "none",
-  "na",
-  "null",
-  "undefined",
-  "notavailable",
-  "unavailable",
-  "notcaptured",
-  "nonotes",
-  "nousernotes",
-  "nofeedback",
-  "noannotations",
-  "nonecaptured",
-  "tbd",
-  "pending",
-]);
-
-function isPlaceholderValue(value: string): boolean {
-  const compact = value
-    .replace(/\//g, "")
-    .replace(/[\s().,*_`~–—\-:]/g, "")
-    .toLowerCase();
-  if (compact.length === 0) return true;
-  return PLACEHOLDER_TOKENS.has(compact);
-}
-
-/** Canonicalize a label to lowercase alphanumerics so `user_notes`, `User Notes`,
- * and `**user_notes**` all compare equal. */
-function canonicalLabel(value: string): string {
-  return value.toLowerCase().replace(/[^a-z0-9]/g, "");
-}
-
-/** Normalize a candidate label line into a canonical key (or undefined). */
-function labelOf(line: string): string | undefined {
-  const stripped = line
-    .replace(/^\s*#{1,6}\s+/, "")
-    .replace(/^\s*[-*+]\s+/, "")
-    .replace(/^\s*\d+\.\s+/, "");
-  const colonIdx = stripped.indexOf(":");
-  const candidate = colonIdx >= 0 ? stripped.slice(0, colonIdx) : stripped;
-  const key = canonicalLabel(candidate);
-  return key.length > 0 ? key : undefined;
-}
-
-/** Inline value following a `label:` on the same line. */
-function inlineValueOf(line: string): string {
-  const stripped = line
-    .replace(/^\s*#{1,6}\s+/, "")
-    .replace(/^\s*[-*+]\s+/, "")
-    .replace(/^\s*\d+\.\s+/, "");
-  const colonIdx = stripped.indexOf(":");
-  if (colonIdx < 0) return "";
-  return stripped.slice(colonIdx + 1).replace(/[`*]/g, "").trim();
-}
-
-function isHorizontalRule(line: string): boolean {
-  return /^\s*([-*_])(\s*\1){2,}\s*$/.test(line);
-}
-
-/**
- * Extract the value of a labeled field (e.g. `user_notes`) from a user-feedback
- * markdown blob, tolerating heading / bullet / bold / backtick label styles and
- * multi-line values that run until the next known field label or a rule.
- */
-export function extractField(text: string, field: string): string | undefined {
-  if (text.trim().length === 0) return undefined;
-  const target = canonicalLabel(field);
-  const lines = text.split(/\r?\n/);
-  let collecting = false;
-  const collected: string[] = [];
-  for (const line of lines) {
-    if (collecting) {
-      const label = labelOf(line);
-      if (label !== undefined && label !== target && FIELD_LABELS.has(label)) break;
-      if (isHorizontalRule(line)) break;
-      collected.push(line);
-      continue;
-    }
-    if (labelOf(line) === target) {
-      const inline = inlineValueOf(line);
-      if (inline.length > 0) collected.push(inline);
-      collecting = true;
-    }
-  }
-  const value = collected.join("\n").trim();
-  if (value.length === 0 || isPlaceholderValue(value)) return undefined;
-  return value;
-}
-
-export function extractUserNotes(text: string): string | undefined {
-  return extractField(text, "user_notes");
-}
-
-export function extractAnnotatedSnapshot(text: string): string | undefined {
-  return extractField(text, "annotated_snapshot");
-}
-
-export function extractLiveChanges(text: string): string | undefined {
-  return extractField(text, "live_changes");
-}
-
-/** Build a PreviewFeedback record from a (possibly missing) stage result. */
-export function toPreviewFeedback(input: {
-  readonly iteration: number;
-  readonly stageName: string;
-  readonly result: PreviewResultLike | undefined;
-}): PreviewFeedback {
-  const text = (input.result?.text ?? "").trim();
-  const userNotes = extractUserNotes(text);
-  const annotatedSnapshot = extractAnnotatedSnapshot(text);
-  const liveChanges = extractLiveChanges(text);
-  return {
-    iteration: input.iteration,
-    stageName: input.stageName,
-    text,
-    capturedAt: new Date().toISOString(),
-    ...(userNotes !== undefined ? { userNotes } : {}),
-    ...(annotatedSnapshot !== undefined ? { annotatedSnapshot } : {}),
-    ...(liveChanges !== undefined ? { liveChanges } : {}),
-  };
-}
-
-export function hasMeaningfulUserNotes(feedback: PreviewFeedback): boolean {
-  return typeof feedback.userNotes === "string" && feedback.userNotes.length > 0;
-}
-
-export function hasMeaningfulLiveChanges(feedback: PreviewFeedback): boolean {
-  return typeof feedback.liveChanges === "string" && feedback.liveChanges.length > 0;
-}
-
-/** Whether a feedback round carries any meaningful user signal: typed notes or accepted live variants. */
-export function hasMeaningfulFeedback(feedback: PreviewFeedback): boolean {
-  return hasMeaningfulUserNotes(feedback) || hasMeaningfulLiveChanges(feedback);
-}
-
-function feedbackLabel(feedback: PreviewFeedback): string {
-  return feedback.iteration === 0
-    ? "the initial preview"
-    : "the live design review";
-}
-
-/**
- * Render the captured user annotations (latest first) as a markdown section.
- * Returns "" when no iteration captured meaningful user notes.
- */
-export function buildUserAnnotationsSection(history: readonly PreviewFeedback[]): string {
-  const withFeedback = history.filter(
-    (feedback) => hasMeaningfulUserNotes(feedback) || hasMeaningfulLiveChanges(feedback),
-  );
-  if (withFeedback.length === 0) return "";
-  return [...withFeedback]
-    .reverse()
-    .map((feedback) => {
-      const lines = [
-        `### User annotations from ${feedbackLabel(feedback)}`,
-        "",
-      ];
-      if (hasMeaningfulUserNotes(feedback)) {
-        lines.push(feedback.userNotes ?? "");
-      }
-      if (hasMeaningfulLiveChanges(feedback)) {
-        lines.push("", "Accepted live variants/edits:", feedback.liveChanges ?? "");
-      }
-      if (feedback.annotatedSnapshot !== undefined) {
-        lines.push("", `Annotated snapshot: ${feedback.annotatedSnapshot}`);
-      }
-      return lines.join("\n");
-    })
-    .join("\n\n");
-}
-
-/**
- * The user-annotations block injected into refinement prompts, plus whether any
- * real annotations exist. When none exist, downstream stages are told to fall
- * back to an impeccable critique rather than fabricating user feedback.
- */
-export function userAnnotationsBlock(history: readonly PreviewFeedback[]): {
-  readonly hasNotes: boolean;
-  readonly text: string;
-} {
-  const section = buildUserAnnotationsSection(history);
-  if (section.length === 0) {
-    return {
-      hasNotes: false,
-      text: "No interactive user annotations were captured in the user-feedback stage. There is no user feedback to honor for this refinement.",
-    };
-  }
-  return { hasNotes: true, text: section };
-}
-
-/**
- * Guardrail: every captured user annotation must be present verbatim in the
- * next generate prompt. If a `user-feedback-*` stage captured `user_notes` but
- * they did not thread through, fail loudly instead of silently generating
- * without user feedback. cross-ref: issue #1464 fix (6).
- */
-export function assertUserAnnotationsThreaded(
-  prompt: string,
-  history: readonly PreviewFeedback[],
-  stageName: string,
-): void {
-  for (const feedback of history) {
-    if (hasMeaningfulUserNotes(feedback)) {
-      const notes = (feedback.userNotes ?? "").trim();
-      if (notes.length > 0 && !prompt.includes(notes)) {
-        throw new Error(
-          `open-claude-design ${stageName}: user annotations captured in ${feedback.stageName} were not threaded into the refinement context. Refusing to refine without user feedback (see issue #1464).`,
-        );
-      }
-    }
-    if (hasMeaningfulLiveChanges(feedback)) {
-      const changes = (feedback.liveChanges ?? "").trim();
-      if (changes.length > 0 && !prompt.includes(changes)) {
-        throw new Error(
-          `open-claude-design ${stageName}: accepted live variants captured in ${feedback.stageName} were not threaded into the refinement context. Refusing to refine without user feedback.`,
-        );
-      }
-    }
-  }
-}
-
-/** Whether `childPath` resolves to `parentDir` itself or somewhere beneath it. */
-function isWithin(childPath: string, parentDir: string): boolean {
-  const child = resolve(childPath);
-  const parent = resolve(parentDir);
-  return child === parent || child.startsWith(parent + sep);
-}
-
-function copyAnnotationArtifacts(
-  feedbackDir: string,
-  slug: string,
-  feedback: PreviewFeedback,
-  workflowCwd: string,
-): void {
-  if (feedback.annotatedSnapshot === undefined) return;
-  const raw = feedback.annotatedSnapshot.trim();
-  if (raw.length === 0) return;
-  const source = isAbsolute(raw) ? raw : resolve(workflowCwd, raw);
-  // Constrain the model-supplied path to within the project or the run's
-  // artifact dir before copying, so an absolute path outside the project (e.g.
-  // an arbitrary file the model emitted) is never copied in.
-  const artifactDir = dirname(feedbackDir);
-  if (!isWithin(source, workflowCwd) && !isWithin(source, artifactDir)) return;
-  try {
-    if (!existsSync(source) || !statSync(source).isFile()) return;
-  } catch {
-    return;
-  }
-  const extMatch = source.match(/\.[A-Za-z0-9]+$/);
-  const ext = extMatch ? extMatch[0] : ".png";
-  try {
-    copyFileSync(source, join(feedbackDir, `${slug}-annotations${ext}`));
-  } catch {
-    /* best-effort */
-  }
-  for (const yamlExt of [".yaml", ".yml"]) {
-    const sibling = source.replace(/\.[A-Za-z0-9]+$/, yamlExt);
-    try {
-      if (existsSync(sibling) && statSync(sibling).isFile()) {
-        copyFileSync(sibling, join(feedbackDir, `${slug}-annotations${yamlExt}`));
-        break;
-      }
-    } catch {
-      /* best-effort */
-    }
-  }
-}
-
-/**
- * Persist captured annotations as durable workflow artifacts under
- * `<artifactDir>/feedback/`. Only writes when the user actually provided
- * annotations (notes or an annotated snapshot). Best-effort: never throws.
- * cross-ref: issue #1464 fix (5).
- */
-export function persistPreviewFeedback(input: {
-  readonly artifactDir: string;
-  readonly workflowCwd: string;
-  readonly feedback: PreviewFeedback;
-}): void {
-  const { feedback } = input;
-  if (
-    !hasMeaningfulUserNotes(feedback) &&
-    !hasMeaningfulLiveChanges(feedback) &&
-    feedback.annotatedSnapshot === undefined
-  ) {
-    return;
-  }
-  try {
-    const feedbackDir = join(input.artifactDir, "feedback");
-    mkdirSync(feedbackDir, { recursive: true });
-    const slug = `iteration-${feedback.iteration}`;
-    writeFileSync(join(feedbackDir, `${slug}.md`), `${feedback.text}\n`);
-    writeFileSync(
-      join(feedbackDir, `${slug}.json`),
-      `${JSON.stringify(
-        {
-          ...feedback,
-          hasUserNotes: hasMeaningfulUserNotes(feedback),
-          hasLiveChanges: hasMeaningfulLiveChanges(feedback),
-        },
-        null,
-        2,
-      )}\n`,
-    );
-    copyAnnotationArtifacts(feedbackDir, slug, feedback, input.workflowCwd);
-  } catch {
-    /* best-effort durability; never block the workflow */
-  }
-}

package/dist/builtin/workflows/skills/impeccable/scripts/live/ui-core.mjs

@@ -1,180 +0,0 @@
-/**
- * Framework-neutral Impeccable live chrome contract.
- *
- * The production browser bundle is intentionally plain DOM so Svelte, React,
- * Vue, and static adapters can all mount the same chrome. This module is the
- * testable contract/inventory for that bundle; live-browser.js mirrors these
- * values at runtime because it is served as a standalone script.
- */
-
-export const LIVE_CHROME_MOUNT_CONTRACT = Object.freeze([
-  'root',
-  'transport',
-  'state',
-  'actions',
-]);
-
-export const LIVE_UI_SURFACES = Object.freeze([
-  {
-    key: 'global-bottom-bar',
-    ids: [
-      'impeccable-live-global-bar',
-      'impeccable-live-global-bar-brand',
-      'impeccable-live-pick-toggle',
-      'impeccable-live-insert-toggle',
-      'impeccable-live-detect-toggle',
-      'impeccable-live-detect-badge',
-      'impeccable-live-design-toggle',
-      'impeccable-live-page-chat',
-      'impeccable-live-page-chat-input',
-      'impeccable-live-page-chat-voice',
-    ],
-    states: ['rest', 'hover', 'focus-visible', 'pressed', 'active', 'tooltip'],
-  },
-  {
-    key: 'pending-copy-edit-dock',
-    ids: ['impeccable-live-pending-dock'],
-    states: ['closed', 'open', 'hover', 'pressed', 'loading', 'rollback', 'keep-fixing'],
-  },
-  {
-    key: 'element-selection-chrome',
-    ids: [
-      'impeccable-live-highlight',
-      'impeccable-live-tooltip',
-      'impeccable-live-bar',
-      'impeccable-live-selection-pill',
-      'impeccable-live-input',
-      'impeccable-live-configure-voice',
-      'impeccable-live-configure-bar-tooltip',
-    ],
-    states: ['rest', 'hover', 'focus-visible', 'pressed', 'disabled'],
-  },
-  {
-    key: 'action-picker',
-    ids: ['impeccable-live-picker'],
-    states: ['closed', 'open', 'option-hover', 'option-focus'],
-  },
-  {
-    key: 'edit-chrome',
-    ids: ['impeccable-live-edit-badge'],
-    states: ['enabled', 'disabled', 'editing', 'cancel', 'save', 'edited-content'],
-  },
-  {
-    key: 'generating-row',
-    ids: ['impeccable-live-bar', 'impeccable-live-shader'],
-    states: ['action-label', 'animated-dots', 'generating', 'done'],
-  },
-  {
-    key: 'variant-cycling-row',
-    ids: ['impeccable-live-bar', 'impeccable-live-params-panel'],
-    states: ['variant-1', 'variant-2', 'variant-3', 'left-disabled', 'right-disabled', 'dot-click', 'accept', 'discard'],
-  },
-  {
-    key: 'variant-params-panel',
-    ids: ['impeccable-live-params-panel'],
-    states: ['closed', 'open-above', 'open-below', 'range', 'steps', 'toggle'],
-  },
-  {
-    key: 'saving-confirmed-rows',
-    ids: ['impeccable-live-bar'],
-    states: ['saving', 'applying-variant', 'confirmed'],
-  },
-  {
-    key: 'insert-mode-chrome',
-    ids: [
-      'impeccable-live-insert-line',
-      'impeccable-live-insert-placeholder',
-      'impeccable-live-placeholder-resize',
-      'impeccable-live-insert-input',
-      'impeccable-live-insert-voice',
-      'impeccable-live-insert-create',
-      'impeccable-live-insert-create-tooltip',
-    ],
-    states: ['toggle-active', 'line', 'placeholder', 'resize', 'enabled', 'disabled', 'tooltip'],
-  },
-  {
-    key: 'annotation-chrome',
-    ids: [
-      'impeccable-live-annot',
-      'impeccable-live-annot-svg',
-      'impeccable-live-annot-pins',
-      'impeccable-live-annot-clear',
-    ],
-    states: ['overlay', 'drawing', 'pin', 'pin-edit', 'clear'],
-  },
-  {
-    key: 'design-system-panel',
-    ids: ['impeccable-live-design-host'],
-    states: ['closed', 'open', 'tabs', 'token-tiles', 'copy'],
-  },
-  {
-    key: 'toasts-and-errors',
-    ids: ['impeccable-live-toast'],
-    states: ['normal', 'error', 'no-variants-mounted'],
-  },
-  {
-    key: 'css-isolation-boundary',
-    ids: ['impeccable-live-root'],
-    states: ['shadow-root', 'style-tags', 'hostile-css'],
-  },
-]);
-
-export const LIVE_UI_COMPONENT_IDS = Object.freeze([
-  ...new Set(LIVE_UI_SURFACES.flatMap((surface) => surface.ids)),
-]);
-
-export function resolveLiveUiRoot(env = globalThis) {
-  const doc = env?.document;
-  const explicit = env?.__IMPECCABLE_LIVE_UI_ROOT__
-    || env?.window?.__IMPECCABLE_LIVE_UI_ROOT__;
-  if (explicit && typeof explicit.appendChild === 'function') return explicit;
-  return doc?.body || null;
-}
-
-export function getLiveUiElementById(id, env = globalThis) {
-  const doc = env?.document;
-  const root = resolveLiveUiRoot(env);
-  if (!id) return null;
-  if (root?.getElementById) {
-    const found = root.getElementById(id);
-    if (found) return found;
-  }
-  if (root?.querySelector) {
-    const found = root.querySelector('#' + escapeCssIdent(id));
-    if (found) return found;
-  }
-  return doc?.getElementById?.(id) || null;
-}
-
-export function appendToLiveUiRoot(el, env = globalThis) {
-  const root = resolveLiveUiRoot(env);
-  if (!root) throw new Error('Impeccable live UI root is not available');
-  root.appendChild(el);
-  return el;
-}
-
-export function appendStyleToLiveUiRoot(styleEl, env = globalThis) {
-  const doc = env?.document;
-  const root = resolveLiveUiRoot(env);
-  if (root && root !== doc?.body) {
-    root.appendChild(styleEl);
-  } else {
-    (doc?.head || doc?.body || root).appendChild(styleEl);
-  }
-  return styleEl;
-}
-
-export function activeElementDeep(doc = globalThis.document) {
-  let active = doc?.activeElement || null;
-  while (active?.shadowRoot?.activeElement) {
-    active = active.shadowRoot.activeElement;
-  }
-  return active;
-}
-
-function escapeCssIdent(value) {
-  if (typeof CSS !== 'undefined' && typeof CSS.escape === 'function') {
-    return CSS.escape(String(value));
-  }
-  return String(value).replace(/([ !"#$%&'()*+,./:;<=>?@[\\\]^`{|}~])/g, '\\$1');
-}

package/docs/i-have-adhd.md

@@ -1,36 +0,0 @@
----
-title: "i-have-adhd"
-description: "ADHD-friendly response style bundled with Atomic"
----
-
-# i-have-adhd
-
-Atomic bundles `@bastani/i-have-adhd` as a first-party extension. It keeps responses easy to act on: lead with the next action, number multi-step work, show progress, and cut filler. The rules are loaded from the bundled `i-have-adhd` skill.
-
-ADHD-friendly output is enabled by default for new sessions. Atomic injects the rules once as a hidden message, so the transcript stays clean while the style remains active across turns, restarts, branches, and compaction.
-
-## Control the mode
-
-Use the session command:
-
-```text
-/i-have-adhd on
-/i-have-adhd off
-```
-
-With no argument, `/i-have-adhd` toggles the current session. The saved session setting wins when that session is resumed or branched.
-
-To opt out before a new session starts, use `--no-adhd`:
-
-```bash
-atomic --no-adhd
-```
-
-For a persistent default opt-out, create `.i-have-adhd-off` in the active agent directory (`~/.atomic/agent/` by default). A saved session state still wins over that default.
-
-You can also say either exact stop phrase:
-
-- `stop adhd mode`
-- `normal mode`
-
-Atomic turns the mode off, saves that choice for the session, and confirms it. Use `/i-have-adhd on` to enable it again.