@monoes/monomindcli 2.15.6 → 2.16.0

package/.claude/skills/monodesign/scripts/lib/monodesign-paths.mjs

@@ -1,129 +0,0 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { resolveProjectRoot } from '../context.mjs';
-export { MONODESIGN_COMMAND_PREFIX } from './provider.mjs';
-
-export const MONODESIGN_DIR = '.monodesign';
-export const LIVE_DIR = 'live';
-export const CRITIQUE_DIR = 'critique';
-
-export function getMonodesignDir(cwd = process.cwd(), options = {}) {
-  return path.join(resolveProjectRoot(cwd, options), MONODESIGN_DIR);
-}
-
-export function getDesignSidecarPath(cwd = process.cwd(), options = {}) {
-  return path.join(getMonodesignDir(cwd, options), 'design.json');
-}
-
-export function getDesignSidecarCandidates(cwd = process.cwd(), contextDir = cwd, options = {}) {
-  const projectRoot = resolveProjectRoot(cwd, options);
-  const candidates = [
-    getDesignSidecarPath(cwd, options),
-    path.join(projectRoot, 'DESIGN.json'),
-  ];
-  const contextLegacy = path.join(contextDir, 'DESIGN.json');
-  if (!candidates.includes(contextLegacy)) candidates.push(contextLegacy);
-  return candidates;
-}
-
-export function resolveDesignSidecarPath(cwd = process.cwd(), contextDir = cwd, options = {}) {
-  return firstExisting(getDesignSidecarCandidates(cwd, contextDir, options));
-}
-
-export function getLiveDir(cwd = process.cwd(), options = {}) {
-  return path.join(getMonodesignDir(cwd, options), LIVE_DIR);
-}
-
-export function getLiveConfigPath(cwd = process.cwd(), options = {}) {
-  return path.join(getLiveDir(cwd, options), 'config.json');
-}
-
-export function getLegacyLiveConfigPath(scriptsDir) {
-  return path.join(scriptsDir, 'config.json');
-}
-
-export function resolveLiveConfigPath({ cwd = process.cwd(), scriptsDir, env = process.env, targetPath } = {}) {
-  if (env.MONODESIGN_LIVE_CONFIG?.trim()) {
-    const configured = env.MONODESIGN_LIVE_CONFIG.trim();
-    return path.isAbsolute(configured) ? configured : path.resolve(cwd, configured);
-  }
-  const primary = getLiveConfigPath(cwd, { targetPath });
-  if (fs.existsSync(primary)) return primary;
-  if (scriptsDir) {
-    const legacy = getLegacyLiveConfigPath(scriptsDir);
-    if (fs.existsSync(legacy)) return legacy;
-  }
-  return primary;
-}
-
-export function getLiveServerPath(cwd = process.cwd(), options = {}) {
-  return path.join(getLiveDir(cwd, options), 'server.json');
-}
-
-export function getLegacyLiveServerPath(cwd = process.cwd(), options = {}) {
-  return path.join(resolveProjectRoot(cwd, options), '.monodesign-live.json');
-}
-
-export function readLiveServerInfo(cwd = process.cwd(), options = {}) {
-  for (const filePath of [getLiveServerPath(cwd, options), getLegacyLiveServerPath(cwd, options)]) {
-    try {
-      const info = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
-      if (info && typeof info.pid === 'number' && !isLiveServerPidReachable(info.pid)) {
-        try { fs.unlinkSync(filePath); } catch {}
-        continue;
-      }
-      return { info, path: filePath };
-    } catch {
-      /* try next */
-    }
-  }
-  return null;
-}
-
-export function isLiveServerPidReachable(pid) {
-  try {
-    process.kill(pid, 0);
-    return true;
-  } catch (err) {
-    // ESRCH means "no such process". EPERM means the process exists but this
-    // user cannot signal it, so the live server info is still valid.
-    return err?.code !== 'ESRCH';
-  }
-}
-
-export function writeLiveServerInfo(cwd = process.cwd(), info, options = {}) {
-  const filePath = getLiveServerPath(cwd, options);
-  fs.mkdirSync(path.dirname(filePath), { recursive: true });
-  fs.writeFileSync(filePath, JSON.stringify(info));
-  return filePath;
-}
-
-export function removeLiveServerInfo(cwd = process.cwd(), options = {}) {
-  for (const filePath of [getLiveServerPath(cwd, options), getLegacyLiveServerPath(cwd, options)]) {
-    try { fs.unlinkSync(filePath); } catch {}
-  }
-}
-
-export function getLiveSessionsDir(cwd = process.cwd(), options = {}) {
-  return path.join(getLiveDir(cwd, options), 'sessions');
-}
-
-export function getLegacyLiveSessionsDir(cwd = process.cwd(), options = {}) {
-  return path.join(resolveProjectRoot(cwd, options), '.monodesign-live', 'sessions');
-}
-
-export function getLiveAnnotationsDir(cwd = process.cwd(), options = {}) {
-  return path.join(getLiveDir(cwd, options), 'annotations');
-}
-
-export function getCritiqueDir(cwd = process.cwd(), options = {}) {
-  return path.join(getMonodesignDir(cwd, options), CRITIQUE_DIR);
-}
-
-export function getLegacyLiveAnnotationsDir(cwd = process.cwd(), options = {}) {
-  return path.join(resolveProjectRoot(cwd, options), '.monodesign-live', 'annotations');
-}
-
-function firstExisting(paths) {
-  return paths.find((filePath) => fs.existsSync(filePath)) || null;
-}

package/.claude/skills/monodesign/scripts/lib/provider.mjs

@@ -1,4 +0,0 @@
-// Source scripts default to slash commands. The provider build replaces only
-// this exact declaration, avoiding heuristic rewrites across executable code.
-export const MONODESIGN_COMMAND_PREFIX = '/'; // @monodesign-provider-command-prefix
-export const MONODESIGN_COMMAND = `${MONODESIGN_COMMAND_PREFIX}monodesign`;

package/.claude/skills/monodesign/scripts/lib/target-args.mjs

@@ -1,42 +0,0 @@
-class TargetArgError extends Error {
-  constructor(message, code) {
-    super(message);
-    this.name = 'TargetArgError';
-    this.code = code;
-  }
-}
-
-export function parseTargetPath(args = [], { strict = false } = {}) {
-  let targetPath = null;
-  for (let i = 0; i < args.length; i++) {
-    const arg = String(args[i]);
-    if (arg === '--target' || arg === '-t') {
-      const next = args[i + 1];
-      if (next && !String(next).startsWith('-')) {
-        targetPath = String(next);
-        i++;
-        continue;
-      }
-      if (strict) {
-        throw new TargetArgError('--target requires a path value.', 'TARGET_VALUE_MISSING');
-      }
-      continue;
-    }
-    if (arg.startsWith('--target=')) {
-      const value = arg.slice('--target='.length);
-      if (value) {
-        targetPath = value;
-        continue;
-      }
-      if (strict) {
-        throw new TargetArgError('--target requires a path value.', 'TARGET_VALUE_MISSING');
-      }
-    }
-  }
-  return targetPath;
-}
-
-export function parseTargetOptions(args = [], options = {}) {
-  const targetPath = parseTargetPath(args, options);
-  return targetPath ? { targetPath } : {};
-}

package/.claude/skills/monodesign/scripts/live/browser-script-parts.mjs

@@ -1,50 +0,0 @@
-import fs from 'node:fs';
-import path from 'node:path';
-
-export const LIVE_BROWSER_SCRIPT_PARTS = Object.freeze([
-  Object.freeze({ name: 'session-state', file: 'live-browser-session.js' }),
-  Object.freeze({ name: 'dom-helpers', file: 'live-browser-dom.js' }),
-  Object.freeze({ name: 'browser-ui', file: 'live-browser.js' }),
-]);
-
-export function resolveLiveBrowserScriptParts(scriptsDir, parts = LIVE_BROWSER_SCRIPT_PARTS) {
-  if (!scriptsDir) throw new Error('scriptsDir is required');
-  return parts.map((part, index) => ({
-    ...part,
-    index,
-    path: path.join(scriptsDir, part.file),
-  }));
-}
-
-export function assertLiveBrowserScriptParts(parts, exists = fs.existsSync) {
-  for (const part of parts) {
-    if (!exists(part.path)) {
-      throw new Error(`Live browser script part missing: ${part.name} (${part.path})`);
-    }
-  }
-  return parts;
-}
-
-export function readLiveBrowserScriptParts(parts, readFile = (filePath) => fs.readFileSync(filePath, 'utf-8')) {
-  return parts.map((part) => ({
-    ...part,
-    source: readFile(part.path),
-  }));
-}
-
-export function assembleLiveBrowserScript({ token, port, vocabulary, commandPrefix = '/', parts }) {
-  const prelude =
-    `window.__MONODESIGN_TOKEN__ = '${token}';\n` +
-    `window.__MONODESIGN_PORT__ = ${port};\n` +
-    `window.__MONODESIGN_COMMAND_PREFIX__ = ${JSON.stringify(commandPrefix)};\n` +
-    // Canonical command vocabulary (values + labels + icons). live-browser.js
-    // builds its action picker from this instead of an inline copy.
-    `window.__MONODESIGN_VOCAB__ = ${JSON.stringify(vocabulary)};\n`;
-
-  const body = parts.map((part) => {
-    const file = part.file || path.basename(part.path || '');
-    return `// --- monodesign live script part: ${part.name} (${file}) ---\n${part.source}`;
-  }).join('\n');
-
-  return prelude + body;
-}

package/.claude/skills/monodesign/scripts/live/completion.mjs

@@ -1,19 +0,0 @@
-export function completionTypeForAcceptResult(eventType, acceptResult) {
-  if (eventType === 'discard') return acceptResult?.handled === true ? 'discarded' : 'error';
-  if (acceptResult?.handled === true && acceptResult?.carbonize === true) return 'agent_done';
-  if (acceptResult?.handled === true) return 'complete';
-  if (acceptResult?.mode === 'error') return 'error';
-  if (eventType === 'accept' && acceptResult?.previewMode === 'svelte-component') return 'error';
-  return 'agent_done';
-}
-
-export function completionAckForAcceptResult(eventId, completionType, acceptResult) {
-  const ack = { ok: true, type: completionType };
-  if (acceptResult?.handled === true && acceptResult?.carbonize === true) {
-    ack.final = false;
-    ack.requiresComplete = true;
-    ack.nextCommand = `live-complete.mjs --id ${eventId}`;
-    ack.message = 'Carbonize cleanup must be verified, then the session must be completed explicitly before polling again.';
-  }
-  return ack;
-}

package/.claude/skills/monodesign/scripts/live/event-validation.mjs

@@ -1,137 +0,0 @@
-/**
- * Shared event validation for the live helper server.
- * Extracted for unit testing (insert mode rules).
- */
-
-import { canCreateInsert } from './insert-ui.mjs';
-
-// The accepted visual action values come from the canonical vocabulary so the
-// validator, the picker UI, and the marketing demo never drift. Imported (not
-// just re-exported) so it is also in scope for the validators below.
-import { VISUAL_ACTIONS } from './vocabulary.mjs';
-export { VISUAL_ACTIONS };
-
-const ID_PATTERN = /^[0-9a-f]{8}$/;
-const VARIANT_ID_PATTERN = /^[0-9]{1,3}$/;
-const INSERT_POSITIONS = new Set(['before', 'after']);
-const FORBIDDEN_MANUAL_EDIT_TEXT_CHARS = ['<', '{', '}', '`'];
-
-function isValidId(v) { return typeof v === 'string' && ID_PATTERN.test(v); }
-function isValidVariantId(v) { return typeof v === 'string' && VARIANT_ID_PATTERN.test(v); }
-
-function validateManualEditText(newText) {
-  if (typeof newText !== 'string') return null;
-  const hits = FORBIDDEN_MANUAL_EDIT_TEXT_CHARS.filter((char) => newText.includes(char));
-  return hits.length > 0 ? hits : null;
-}
-
-function validateAnnotationFields(msg) {
-  if (msg.screenshotPath !== undefined && typeof msg.screenshotPath !== 'string') {
-    return 'generate: screenshotPath must be string';
-  }
-  if (msg.comments !== undefined && !Array.isArray(msg.comments)) {
-    return 'generate: comments must be array';
-  }
-  if (msg.strokes !== undefined && !Array.isArray(msg.strokes)) {
-    return 'generate: strokes must be array';
-  }
-  return null;
-}
-
-function validateInsertGenerate(msg) {
-  if (!msg.insert || typeof msg.insert !== 'object') return 'generate: insert mode requires insert object';
-  if (!INSERT_POSITIONS.has(msg.insert.position)) return 'generate: insert.position must be before or after';
-  const anchor = msg.insert.anchor;
-  if (!anchor || typeof anchor !== 'object') return 'generate: insert.anchor required';
-  if (!anchor.tagName && !anchor.outerHTML && !(Array.isArray(anchor.classes) && anchor.classes.length)) {
-    return 'generate: insert.anchor needs tagName, classes, or outerHTML';
-  }
-  if (!msg.placeholder || typeof msg.placeholder !== 'object') return 'generate: insert mode requires placeholder dimensions';
-  if (!Number.isFinite(msg.placeholder.width) || !Number.isFinite(msg.placeholder.height)) {
-    return 'generate: placeholder width and height must be numbers';
-  }
-  if (!canCreateInsert({
-    prompt: msg.freeformPrompt,
-    comments: msg.comments,
-    strokes: msg.strokes,
-  })) {
-    return 'generate: insert requires freeformPrompt or annotations';
-  }
-  return validateAnnotationFields(msg);
-}
-
-function validateReplaceGenerate(msg) {
-  if (!msg.action || !VISUAL_ACTIONS.includes(msg.action)) return 'generate: invalid action';
-  if (!msg.element?.outerHTML) return 'generate: missing element context';
-  return validateAnnotationFields(msg);
-}
-
-function validateManualEditEvent(msg, label) {
-  if (!isValidId(msg.id)) return `${label}: missing or malformed id`;
-  if (!msg.pageUrl || typeof msg.pageUrl !== 'string') return `${label}: missing pageUrl`;
-  if (!msg.element || typeof msg.element !== 'object') return `${label}: missing element`;
-  if (!Array.isArray(msg.ops) || msg.ops.length === 0) return `${label}: ops must be non-empty array`;
-  if (msg.ops.length > 100) return `${label}: too many ops (max 100)`;
-  for (const op of msg.ops) {
-    if (typeof op.ref !== 'string') return `${label}: op.ref required`;
-    if (typeof op.tag !== 'string') return `${label}: op.tag required`;
-    if (typeof op.originalText !== 'string') return `${label}: op.originalText required`;
-    if (op.deleted !== true && typeof op.newText !== 'string') {
-      return `${label}: text op requires newText`;
-    }
-    if (typeof op.newText === 'string') {
-      if (op.deleted !== true && op.newText.trim().length === 0) {
-        return `${label}: newText cannot be empty`;
-      }
-      const forbidden = validateManualEditText(op.newText);
-      if (forbidden) {
-        return `${label}: newText cannot contain ${forbidden.join(' ')} (plain text only; ask the AI to insert markup)`;
-      }
-    }
-  }
-  return null;
-}
-
-export function validateEvent(msg) {
-  if (!msg || typeof msg !== 'object' || !msg.type) return 'Missing or invalid message';
-  switch (msg.type) {
-    case 'generate':
-      if (!isValidId(msg.id)) return 'generate: missing or malformed id';
-      if (!Number.isInteger(msg.count) || msg.count < 1 || msg.count > 8) return 'generate: count must be 1-8';
-      if (msg.mode === 'insert') return validateInsertGenerate(msg);
-      return validateReplaceGenerate(msg);
-    case 'accept':
-      if (!isValidId(msg.id)) return 'accept: missing or malformed id';
-      if (!isValidVariantId(msg.variantId)) return 'accept: missing or malformed variantId';
-      if (msg.paramValues !== undefined) {
-        if (typeof msg.paramValues !== 'object' || msg.paramValues === null || Array.isArray(msg.paramValues)) {
-          return 'accept: paramValues must be an object';
-        }
-      }
-      return null;
-    case 'discard':
-      return isValidId(msg.id) ? null : 'discard: missing or malformed id';
-    case 'checkpoint':
-      if (!isValidId(msg.id)) return 'checkpoint: missing or malformed id';
-      if (!Number.isInteger(msg.revision) || msg.revision < 0) return 'checkpoint: revision must be a non-negative integer';
-      if (msg.paramValues !== undefined && (typeof msg.paramValues !== 'object' || msg.paramValues === null || Array.isArray(msg.paramValues))) {
-        return 'checkpoint: paramValues must be an object';
-      }
-      return null;
-    case 'exit':
-      return null;
-    case 'prefetch':
-      if (!msg.pageUrl || typeof msg.pageUrl !== 'string') return 'prefetch: missing pageUrl';
-      return null;
-    case 'manual_edits':
-      return validateManualEditEvent(msg, 'manual_edits');
-    case 'steer':
-      if (!isValidId(msg.id)) return 'steer: missing or malformed id';
-      if (typeof msg.message !== 'string' || !msg.message.trim()) return 'steer: message required';
-      if (msg.message.length > 4000) return 'steer: message too long';
-      if (msg.pageUrl !== undefined && typeof msg.pageUrl !== 'string') return 'steer: pageUrl must be string';
-      return null;
-    default:
-      return `Unknown event type: ${msg.type}`;
-  }
-}