monomind 2.7.9 → 2.7.11

package/packages/@monomind/cli/.claude/skills/monodesign/scripts/context-signals.mjs

@@ -1,260 +0,0 @@
-#!/usr/bin/env node
-/**
- * Context-signals gatherer for the bare Monodesign invocation
- * (no-argument) path. Collects cheap, deterministic signals about the current
- * project and emits them as JSON.
- *
- * It does NOT score or rank. The agent reasons over the raw signals using its
- * knowledge of the command catalog (see SKILL.md routing rule 1). Deliberately
- * light: no LLM calls, no detector run (`monomind design detect` is heavier and
- * opt-in), no file writes. Every probe is best-effort and never throws; the
- * output is always valid JSON.
- *
- * Signals:
- *   - setup:     PRODUCT.md / DESIGN.md presence, register, whether code exists
- *   - critique:  the latest cached critique score (.monodesign/critique)
- *   - git:       branch + files changed vs the default branch (a scope hint)
- *   - devServer: whether a local dev server answers on a common port (gates live)
- */
-import fs from 'node:fs';
-import net from 'node:net';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { execFileSync } from 'node:child_process';
-import { loadContext, extractRegister, extractPlatform } from './context.mjs';
-import { getCritiqueDir } from './lib/monodesign-paths.mjs';
-import { readTrend, extractIssueLines, trendDirection } from './critique-storage.mjs';
-
-/** Is there code here at all, or just context files / an empty repo? */
-function hasCode(cwd) {
-  if (fs.existsSync(path.join(cwd, 'package.json'))) return true;
-  for (const d of ['src', 'app', 'pages', 'site', 'public', 'components', 'lib']) {
-    if (fs.existsSync(path.join(cwd, d))) return true;
-  }
-  return false;
-}
-
-/**
- * The most recent critique snapshot across all targets. Filenames are
- * timestamp-prefixed (`<iso>__<slug>.md`), so a lexical sort is chronological.
- * Parses the small frontmatter for score + P0/P1 counts, plus two "design
- * health" extras: the score trend for the same slug (last 3 runs, with a
- * direction) and the open [P0] issue titles from the snapshot body — enough
- * for a session to start design-health-aware without an LLM pass.
- */
-function latestCritique(cwd) {
-  try {
-    const dir = getCritiqueDir(cwd);
-    if (!fs.existsSync(dir)) return null;
-    const files = fs.readdirSync(dir).filter((f) => f.endsWith('.md')).sort();
-    if (!files.length) return null;
-    const newest = files[files.length - 1];
-    const text = fs.readFileSync(path.join(dir, newest), 'utf-8');
-    const front = text.split('---')[1] || '';
-    const get = (k) => {
-      const m = front.match(new RegExp(`^${k}:\\s*(.+)$`, 'm'));
-      return m ? m[1].trim() : null;
-    };
-    const num = (v) => {
-      const n = Number(v);
-      return Number.isFinite(n) ? n : null;
-    };
-    const slug = get('slug');
-    // Trend across the last 3 runs for the same slug. Frontmatter written by
-    // critique-storage carries `total_score`; older/hand-written snapshots may
-    // carry `score` — accept either. Best-effort: never let this probe throw.
-    let trend = null;
-    try {
-      if (slug) {
-        const rows = readTrend(slug, { limit: 3, cwd });
-        const scores = rows
-          .map((r) => num(r.total_score ?? r.score))
-          .filter((n) => n !== null);
-        if (scores.length) trend = { scores, direction: trendDirection(scores) };
-      }
-    } catch { /* trend stays null */ }
-    let openP0 = [];
-    try {
-      openP0 = extractIssueLines(text).p0;
-    } catch { /* openP0 stays empty */ }
-    // Frontmatter key fallbacks: context fixtures use score/p0/p1, the
-    // critique flow's MONODESIGN_CRITIQUE_META uses total_score/p0_count/
-    // p1_count. `get` returns null for missing keys; keep null (not 0).
-    const numKey = (...keys) => {
-      for (const k of keys) {
-        const v = get(k);
-        if (v !== null) return num(v);
-      }
-      return null;
-    };
-    return {
-      slug,
-      score: numKey('score', 'total_score'),
-      p0: numKey('p0', 'p0_count'),
-      p1: numKey('p1', 'p1_count'),
-      timestamp: get('timestamp'),
-      file: path.relative(cwd, path.join(dir, newest)),
-      trend,
-      openP0,
-    };
-  } catch {
-    return null;
-  }
-}
-
-/** Branch + a scope hint: files changed vs the default branch, else working tree. */
-function gitSignals(cwd) {
-  const run = (args, { trim = true } = {}) => {
-    try {
-      const out = execFileSync('git', args, {
-        cwd,
-        encoding: 'utf-8',
-        stdio: ['ignore', 'pipe', 'ignore'],
-      });
-      return trim ? out.trim() : out;
-    } catch {
-      return null;
-    }
-  };
-  if (run(['rev-parse', '--is-inside-work-tree']) !== 'true') {
-    return { isRepo: false, branch: null, base: null, changedFiles: [], changedCount: 0 };
-  }
-  const branch = run(['rev-parse', '--abbrev-ref', 'HEAD']);
-  let base = null;
-  for (const b of ['main', 'master']) {
-    if (run(['rev-parse', '--verify', '--quiet', b]) !== null) {
-      base = b;
-      break;
-    }
-  }
-  const diffBase = base && branch && branch !== base ? base : null;
-  const fromDiff = diffBase ? run(['diff', '--name-only', `${diffBase}...HEAD`]) : null;
-  // porcelain lines are `XY PATH`: a 2-char status + a space, then the path.
-  // Don't trim the combined output — an unstaged-modified line starts with a
-  // leading space (` M path`), and a global trim would eat the first line's
-  // status column and shift the slice. Renames render as `old -> new`.
-  const fromStatus = run(['-c', 'core.quotepath=false', 'status', '--porcelain'], { trim: false });
-  let changed = [];
-  if (fromDiff) {
-    changed = fromDiff.split('\n').filter(Boolean);
-  } else if (fromStatus) {
-    changed = fromStatus.split(/\r?\n/).filter(Boolean).map((l) => {
-      const p = l.slice(3);
-      const arrow = p.indexOf(' -> ');
-      return arrow === -1 ? p : p.slice(arrow + 4);
-    });
-  }
-  return {
-    isRepo: true,
-    branch,
-    base: diffBase,
-    changedFiles: changed.slice(0, 50),
-    changedCount: changed.length,
-  };
-}
-
-const COMMON_DEV_PORTS = [4321, 3000, 5173, 5174, 8080, 8000, 4200];
-
-function probePort(port, timeout = 250) {
-  return new Promise((resolve) => {
-    const sock = new net.Socket();
-    let settled = false;
-    const finish = (ok) => {
-      if (settled) return;
-      settled = true;
-      try { sock.destroy(); } catch { /* ignore */ }
-      resolve(ok);
-    };
-    sock.setTimeout(timeout);
-    sock.once('connect', () => finish(true));
-    sock.once('timeout', () => finish(false));
-    sock.once('error', () => finish(false));
-    sock.connect(port, '127.0.0.1');
-  });
-}
-
-async function devServerSignals() {
-  const open = [];
-  await Promise.all(
-    COMMON_DEV_PORTS.map(async (p) => {
-      if (await probePort(p)) open.push(p);
-    }),
-  );
-  open.sort((a, b) => a - b);
-  return { running: open.length > 0, ports: open };
-}
-
-// Extensions the detector scans (mirrors the engine's walkDir set + HTML).
-const SCANNABLE_EXT = new Set([
-  '.html', '.htm', '.css', '.scss',
-  '.jsx', '.tsx', '.js', '.ts', '.vue', '.svelte', '.astro',
-]);
-// Where UI source typically lives. The detector walks these and skips
-// node_modules / dist / build / .next / .nuxt automatically.
-const SOURCE_DIRS = ['src', 'app', 'components', 'pages', 'public'];
-
-/**
- * Local paths the agent should point the bundled detector at — never a URL.
- * A URL means a costly Puppeteer browser render, and a probed dev-server port
- * may not even belong to this project. An HTML *file* or a source tree is
- * scanned by the cheap, jsdom-free static engine. This script does NOT run the
- * detector; it just surfaces the target(s) so the agent can run
- * `node <scripts>/detect.mjs --json <targets>` and fold the hits in.
- */
-function scanTargets(cwd, git) {
-  // 1. Dirty tree wins: scan exactly the markup/style files in flight. It's
-  //    what the user is working on, it's a small set, and it's local.
-  if (git.isRepo && git.changedFiles.length) {
-    const changed = git.changedFiles
-      .filter((f) => SCANNABLE_EXT.has(path.extname(f).toLowerCase()))
-      .filter((f) => fs.existsSync(path.join(cwd, f)));
-    if (changed.length) return { targets: changed.slice(0, 50), via: 'git-changes' };
-  }
-  // 2. Otherwise scan the local source dirs that exist.
-  const dirs = SOURCE_DIRS.filter((d) => fs.existsSync(path.join(cwd, d)));
-  if (dirs.length) return { targets: dirs, via: 'source-dir' };
-  // 3. A root HTML entry, or the project root as a last resort when there's
-  //    code but no conventional source dir (walkDir still skips heavy dirs).
-  if (fs.existsSync(path.join(cwd, 'index.html'))) return { targets: ['index.html'], via: 'html' };
-  if (hasCode(cwd)) return { targets: ['.'], via: 'root' };
-  return { targets: [], via: null };
-}
-
-export async function gatherSignals(cwd = process.cwd()) {
-  const ctx = loadContext(cwd);
-  const git = gitSignals(cwd);
-  return {
-    setup: {
-      hasProduct: ctx.hasProduct,
-      productPath: ctx.productPath,
-      hasDesign: ctx.hasDesign,
-      designPath: ctx.designPath,
-      hasCode: hasCode(cwd),
-      register: extractRegister(ctx.product),
-      platform: extractPlatform(ctx.product),
-    },
-    critique: { latest: latestCritique(cwd) },
-    git,
-    devServer: await devServerSignals(),
-    scan: scanTargets(cwd, git),
-  };
-}
-
-async function cli() {
-  const signals = await gatherSignals(process.cwd());
-  process.stdout.write(`${JSON.stringify(signals, null, 2)}\n`);
-}
-
-function invokedAsScript() {
-  const arg = process.argv[1];
-  if (!arg) return false;
-  try {
-    return fs.realpathSync(arg) === fs.realpathSync(fileURLToPath(import.meta.url));
-  } catch {
-    return false;
-  }
-}
-
-if (invokedAsScript()) {
-  cli();
-}