@monoes/monomindcli 2.16.2 → 2.16.4

package/.claude/helpers/org-skill-index.cjs

@@ -0,0 +1,230 @@
+'use strict';
+/**
+ * The Org skill library, read from CommonJS so the skill index
+ * (build-skill-registry.cjs) and the Jev catalog loader (jev-catalog.cjs) see
+ * the same Org skills `monomind org skills` does (src/orgrt/skill-library.ts):
+ *
+ *   1. <project>/.monomind/org-skills          origin 'project'
+ *   2. $MONOMIND_HOME|~/.monomind/org-skills    origin 'user'
+ *   3. <package>/org-skills                     origin 'bundled'
+ *   then active catalog skills/archetypes that target `org`, with their
+ *   package digest verified (before the roots when `replacesLegacy`).
+ *
+ * First match wins by name. Body-free: only name, description and tags.
+ */
+var fs = require('fs');
+var os = require('os');
+var path = require('path');
+var crypto = require('crypto');
+
+var SKILL_NAME_RE = /^[a-z0-9][a-z0-9-]{0,63}$/;
+var MAX_FILE_BYTES = 512 * 1024;
+
+function unquote(s) {
+  if (s.length >= 2 && s[0] === '"' && s[s.length - 1] === '"') {
+    try { return JSON.parse(s); } catch (e) { return s.slice(1, -1); }
+  }
+  if (s.length >= 2 && s[0] === "'" && s[s.length - 1] === "'") return s.slice(1, -1).replace(/''/g, "'");
+  return s;
+}
+
+/** description + tags from a SKILL.md frontmatter (scalars, block scalars,
+ *  flow lists and block lists — the shapes skill-library.ts reads). */
+function readMeta(text) {
+  var m = /^---\r?\n([\s\S]*?)\r?\n---/.exec(text);
+  var data = {};
+  if (!m) return { description: '', tags: [] };
+  var lines = m[1].split(/\r?\n/);
+  for (var i = 0; i < lines.length; i++) {
+    var kv = /^([A-Za-z_][\w-]*):\s*(.*)$/.exec(lines[i]);
+    if (!kv) continue;
+    var val = kv[2].trim();
+    var cont = [];
+    while (i + 1 < lines.length && (/^\s+\S/.test(lines[i + 1]) || lines[i + 1].trim() === '')) cont.push(lines[++i]);
+    if (val === '' && cont.some(function (l) { return /^\s*-\s+/.test(l); })) {
+      data[kv[1]] = cont.filter(function (l) { return /^\s*-\s+/.test(l); })
+        .map(function (l) { return unquote(l.replace(/^\s*-\s+/, '').trim()); });
+    } else if (/^[>|][+-]?$/.test(val)) {
+      var parts = cont.map(function (l) { return l.trim(); });
+      data[kv[1]] = (val[0] === '>' ? parts.join(' ') : parts.join('\n')).trim();
+    } else if (val[0] === '[' && val[val.length - 1] === ']') {
+      data[kv[1]] = val.slice(1, -1).split(',').map(function (s) { return unquote(s.trim()); }).filter(Boolean);
+    } else if (val !== '') {
+      data[kv[1]] = unquote([val].concat(cont.map(function (l) { return l.trim(); })).join(' ').trim());
+    }
+  }
+  var d = data.description;
+  var t = data.tags;
+  return {
+    description: Array.isArray(d) ? d.join(', ') : d || '',
+    tags: Array.isArray(t) ? t : typeof t === 'string' ? t.split(/[,\s]+/).filter(Boolean) : [],
+  };
+}
+
+function readSkill(dir) {
+  var file = path.join(dir, 'SKILL.md');
+  try {
+    if (fs.statSync(file).size > MAX_FILE_BYTES) return null;
+    return readMeta(fs.readFileSync(file, 'utf-8'));
+  } catch (e) {
+    return null;
+  }
+}
+
+var CLI_PACKAGE = '@monoes/monomindcli';
+
+function isCliPackage(dir) {
+  try {
+    return JSON.parse(fs.readFileSync(path.join(dir, 'package.json'), 'utf-8')).name === CLI_PACKAGE;
+  } catch (e) {
+    return false;
+  }
+}
+
+/** The shipped library: opts.bundledDir (recorded by the CLI), else
+ *  <package>/org-skills when this helper runs from the CLI package's
+ *  .claude/helpers, else the CLI package the project resolves. Null if none. */
+function bundledOrgSkillsDir(root, opts) {
+  opts = opts || {};
+  var pkg = path.join(__dirname, '..', '..');
+  var candidates = [opts.bundledDir, isCliPackage(pkg) ? path.join(pkg, 'org-skills') : null];
+  [CLI_PACKAGE, 'monomind'].forEach(function (name) {
+    try {
+      var found = path.dirname(require.resolve(name + '/package.json', { paths: [root] }));
+      if (name === 'monomind') {
+        found = path.dirname(require.resolve(CLI_PACKAGE + '/package.json', { paths: [found] }));
+      }
+      candidates.push(path.join(found, 'org-skills'));
+    } catch (e) { /* not installed there */ }
+  });
+  for (var i = 0; i < candidates.length; i++) {
+    var c = candidates[i];
+    try {
+      if (c && fs.statSync(c).isDirectory()) return path.resolve(c);
+    } catch (e) { /* next */ }
+  }
+  return null;
+}
+
+function orgSkillRoots(root, opts) {
+  opts = opts || {};
+  var env = opts.env || process.env;
+  var home = env.MONOMIND_HOME || path.join(opts.home || os.homedir(), '.monomind');
+  var roots = [
+    { dir: path.join(root, '.monomind', 'org-skills'), origin: 'project' },
+    { dir: path.join(home, 'org-skills'), origin: 'user' },
+  ];
+  var bundled = bundledOrgSkillsDir(root, opts);
+  if (bundled) roots.push({ dir: bundled, origin: 'bundled' });
+  return roots;
+}
+
+// ── Catalog (.monomind/catalog) ────────────────────────────────────────────
+
+/** state.json entries, or null when there is no state file; [] + ok:false when unreadable. */
+function readCatalogState(root) {
+  var file = path.join(root, '.monomind', 'catalog', 'state.json');
+  if (!fs.existsSync(file)) return null;
+  try {
+    var state = JSON.parse(fs.readFileSync(file, 'utf-8'));
+    return Array.isArray(state && state.entries) ? { ok: true, entries: state.entries } : { ok: false, entries: [] };
+  } catch (e) {
+    return { ok: false, entries: [] };
+  }
+}
+
+function packageFiles(dir, prefix, out) {
+  fs.readdirSync(path.join(dir, prefix), { withFileTypes: true }).forEach(function (e) {
+    var rel = prefix ? prefix + '/' + e.name : e.name;
+    if (e.isSymbolicLink()) throw new Error('symlink in package: ' + rel);
+    if (e.isDirectory()) packageFiles(dir, rel, out);
+    else if (e.isFile()) out.push(rel);
+  });
+  return out;
+}
+
+/** Same digest as src/catalog/digest.ts packageDigest. */
+function packageDigest(dir) {
+  var h = crypto.createHash('sha256');
+  packageFiles(dir, '', []).sort().forEach(function (rel) {
+    var bytes = fs.readFileSync(path.join(dir, rel));
+    var p = Buffer.from(rel, 'utf8');
+    var lens = Buffer.alloc(12);
+    lens.writeUInt32BE(p.length, 0);
+    lens.writeBigUInt64BE(BigInt(bytes.length), 4);
+    h.update(lens.subarray(0, 4)).update(p).update(lens.subarray(4)).update(bytes);
+  });
+  return h.digest('hex');
+}
+
+/** The verified package dir of a catalog entry, or null (missing, escaping, tampered). */
+function verifyCatalogPackage(root, entry) {
+  try {
+    if (typeof entry.id !== 'string' || typeof entry.sha256 !== 'string') return null;
+    var store = fs.realpathSync(path.join(root, '.monomind', 'catalog', 'packages'));
+    var dir = fs.realpathSync(path.join(store, entry.id.split(':')[1] || '', entry.sha256.slice(0, 12)));
+    var rel = path.relative(store, dir);
+    if (rel.indexOf('..') === 0 || path.isAbsolute(rel)) return null;
+    return packageDigest(dir) === entry.sha256 ? dir : null;
+  } catch (e) {
+    return null;
+  }
+}
+
+function isActiveFor(e, target) {
+  return !!e && e.status === 'active' && Array.isArray(e.targets) && e.targets.indexOf(target) !== -1;
+}
+
+/** Active, verified, org-target catalog skills (not blueprints) as index entries. */
+function catalogOrgSkills(root) {
+  var state = readCatalogState(root);
+  if (!state || !state.ok) return [];
+  var out = [];
+  state.entries.forEach(function (e) {
+    if (!isActiveFor(e, 'org') || e.kind === 'blueprint' || typeof e.id !== 'string') return;
+    var name = e.id.slice(e.id.indexOf(':') + 1);
+    if (!SKILL_NAME_RE.test(name)) return;
+    var dir = verifyCatalogPackage(root, e);
+    var meta = dir && readSkill(dir);
+    if (!meta) return;
+    out.push({
+      name: name, description: meta.description, tags: meta.tags, origin: 'catalog',
+      catalogId: e.id, sha256: e.sha256, replacesLegacy: e.replacesLegacy === true,
+    });
+  });
+  return out;
+}
+
+/** Every Org skill (overrides resolved), sorted by name — listSkills() parity. */
+function scanOrgSkills(root, opts) {
+  var seen = new Map();
+  var catalog = catalogOrgSkills(root);
+  orgSkillRoots(root, opts).forEach(function (r) {
+    var names;
+    try { names = fs.readdirSync(r.dir); } catch (e) { return; }
+    names.forEach(function (name) {
+      if (seen.has(name) || !SKILL_NAME_RE.test(name)) return;
+      var meta = readSkill(path.join(r.dir, name));
+      if (meta) seen.set(name, { name: name, description: meta.description, tags: meta.tags, origin: r.origin });
+    });
+  });
+  catalog.forEach(function (c) {
+    if (seen.has(c.name) && !c.replacesLegacy) return;
+    var entry = Object.assign({}, c);
+    delete entry.replacesLegacy;
+    seen.set(c.name, entry);
+  });
+  return Array.from(seen.values()).sort(function (a, b) { return a.name.localeCompare(b.name); });
+}
+
+module.exports = {
+  SKILL_NAME_RE: SKILL_NAME_RE,
+  readMeta: readMeta,
+  bundledOrgSkillsDir: bundledOrgSkillsDir,
+  orgSkillRoots: orgSkillRoots,
+  readCatalogState: readCatalogState,
+  packageDigest: packageDigest,
+  verifyCatalogPackage: verifyCatalogPackage,
+  isActiveFor: isActiveFor,
+  scanOrgSkills: scanOrgSkills,
+};

package/.claude/helpers/pick-rank.cjs

@@ -0,0 +1,307 @@
+'use strict';
+/**
+ * Keyword ranking of catalog items (agents, skills, org roles) against a task.
+ * It is the no-model fallback of every picker and builds the Jev candidate
+ * shortlist, so jev-picker.cjs requires it and re-exports `shortlist`.
+ *
+ * Scoring is BM25-style: query words (stopwords dropped, lightly stemmed) are
+ * weighted by their rarity across the catalog (IDF), description matches
+ * saturate and are normalised by description length (so a long description
+ * does not win by sheer size), a word in an item's name or id adds a fixed
+ * bonus unless it is a category prefix shared by many ids (`engineering-`,
+ * `mastermind-`, ...), and the total is scaled by the share of query words
+ * the item matches. An item marked `pick: 'low'` (admin/meta skills, from
+ * `pick: low` frontmatter) keeps LOW_PICK_FACTOR of its score, so it surfaces
+ * only when the task names it. Equal scores keep catalog order.
+ *
+ * Exclusions (English only, query side only): words the task explicitly
+ * rules out do not count ("anything pending rather than release" must not
+ * pick release-manager). withoutExclusions() drops each cue and the words in
+ * its scope before tokenizing. Cues: "rather than", "other than", "instead
+ * of", "apart from", "aside from", "except", "besides", "excluding",
+ * "without", "not", "no", "nor", "don't"/"dont". The scope ends at clause
+ * punctuation (. , ; : ! ? brackets, dashes), at "but"/"then"/"so", at
+ * "and" once a word was dropped ("or"/"nor" keep excluding: "without CI or
+ * staging"), or after SCOPE_WORDS content words. Problem descriptions are not
+ * exclusions: "not"/"no" after a copula or auxiliary ("is not loading",
+ * "are no tests", "does not"), "not only", and "don't know/see/get/..." stay.
+ */
+
+var K1 = 1.2;
+var B = 0.75;
+// Bonus (in IDF units) for a query word found in the item's name or id.
+var STRONG_WEIGHT = 2;
+// An id's leading segment shared by this many ids is a category prefix.
+var PREFIX_MIN_SHARED = 3;
+// Share of its score a `pick: 'low'` item keeps.
+var LOW_PICK_FACTOR = 0.35;
+
+var STOPWORDS = new Set(
+  (
+    'a about above after again against all also am an and any anything are as at be because been before being below ' +
+    'between both but by can could did do does doing down during each else etc every everything few for from further had has ' +
+    'have having he her here hers him his how i if in into is it its itself just me more most must my no nor ' +
+    'not nothing now of off on once only or other our ours out over own per please same she should so some something such than ' +
+    'that the their theirs them then there these they this those through to too under until up upon us very ' +
+    'via was we were what when where which while who whom why will with within without would you your yours'
+  ).split(' '),
+);
+
+// Words that name a product family or a role in general, never a skill.
+var GENERIC_WORDS = new Set('agent agents mastermind monoswarm monomind specialized specialist expert'.split(' '));
+
+function undouble(s) {
+  var n = s.length;
+  if (n > 3 && s[n - 1] === s[n - 2] && 'aeioulsz'.indexOf(s[n - 1]) === -1) return s.slice(0, -1);
+  return s;
+}
+
+function strip(tok, suffix, min) {
+  if (tok.length - suffix.length < min || tok.slice(-suffix.length) !== suffix) return null;
+  return tok.slice(0, -suffix.length);
+}
+
+/** Light stemmer: test/tests/testing/tester/tested all meet at "test",
+ *  optimize/optimization/optimizing at "optimiz". Deliberately crude — it
+ *  only has to make a word's forms collide, never produce a real word. */
+function stem(tok) {
+  if (tok.length <= 3 || /^[0-9]/.test(tok)) return tok;
+  var s = tok;
+  var r;
+  // Inflection.
+  if ((r = strip(s, 'ies', 2))) s = r + 'y';
+  else if ((r = strip(s, 'sses', 2))) s = r + 'ss';
+  else if (/(ch|sh|x|z)es$/.test(s) && (r = strip(s, 'es', 3))) s = r;
+  else if (s.slice(-1) === 's' && !/(ss|us|is)$/.test(s) && (r = strip(s, 's', 3))) s = r;
+  if ((r = strip(s, 'ing', 3))) s = undouble(r);
+  else if ((r = strip(s, 'ed', 3))) s = undouble(r);
+  // Derivation.
+  if ((r = strip(s, 'ation', 3))) s = r;
+  else if ((r = strip(s, 'er', 3))) s = undouble(r);
+  else if ((r = strip(s, 'e', 3))) s = r;
+  return s;
+}
+
+// Scripts written without spaces between words: a run of them is indexed as
+// overlapping character pairs (安全审计 -> 安全 全审 审计), the usual
+// dictionary-free approximation of their words.
+var CJK_RUN = /([\p{scx=Han}\p{scx=Hiragana}\p{scx=Katakana}\p{scx=Hangul}]+)/u;
+
+function bigrams(run) {
+  var chars = Array.from(run);
+  if (chars.length < 2) return chars;
+  var out = [];
+  for (var i = 0; i < chars.length - 1; i++) out.push(chars[i] + chars[i + 1]);
+  return out;
+}
+
+/** Lowercased letter/digit words of any script. Latin, Greek and Cyrillic
+ *  accents are folded (résumé -> resume); CJK runs become bigrams. */
+function words(text) {
+  var folded = String(text || '')
+    .normalize('NFKD')
+    .replace(/[\u0300-\u036f]/g, '')
+    .normalize('NFC')
+    .toLowerCase();
+  var out = [];
+  (folded.match(/[\p{L}\p{N}]+/gu) || []).forEach(function (run) {
+    run.split(CJK_RUN).forEach(function (piece, i) {
+      if (!piece) return;
+      if (i % 2 === 1) out.push.apply(out, bigrams(piece));
+      else out.push(piece);
+    });
+  });
+  return out;
+}
+
+function isContent(w) {
+  return w.length > 1 && !STOPWORDS.has(w);
+}
+
+/** Stemmed content words of `text`, stopwords and 1-letter words removed. */
+function tokens(text) {
+  return words(text).filter(isContent).map(stem);
+}
+
+// Content words an exclusion cue rules out at most.
+var SCOPE_WORDS = 4;
+var CLAUSE_SPLIT = /[.,;:!?()[\]{}<>|\n\r\u2013\u2014]+|\s-+\s/;
+var SINGLE_CUES = new Set('except besides excluding without not no nor dont'.split(' '));
+var PAIR_CUES = { rather: 'than', other: 'than', instead: 'of', apart: 'from', aside: 'from', don: 't' };
+// "is not loading", "are no tests", "does not work": a description, not an exclusion.
+var DESCRIBES = new Set(
+  ('am is are was were be been being does did has have had can could will would get gets got ' +
+    'isn aren wasn weren doesn didn hasn haven hadn won wouldn couldn there').split(' '),
+);
+// "don't know why the build fails" describes a problem too.
+var DONT_DESCRIBES = new Set('know understand see get think remember why how'.split(' '));
+var SCOPE_ENDS = new Set('but then so'.split(' '));
+
+/** Words the cue at ws[i] spans (0: no cue there). */
+function cueAt(ws, i) {
+  var w = ws[i];
+  var next = ws[i + 1];
+  if (PAIR_CUES[w] && next === PAIR_CUES[w]) {
+    if (w === 'don' && DONT_DESCRIBES.has(ws[i + 2])) return 0;
+    return 2;
+  }
+  if (!SINGLE_CUES.has(w)) return 0;
+  if ((w === 'dont' || (w === 'not' && ws[i - 1] === 'do')) && DONT_DESCRIBES.has(next)) return 0;
+  if ((w === 'not' || w === 'no') && (DESCRIBES.has(ws[i - 1]) || next === 'only')) return 0;
+  return 1;
+}
+
+/** `text` minus the exclusion cues and the words they rule out (see the file
+ *  header), clause breaks kept as ". ". Lowercased; a text without cues keeps
+ *  every word. */
+function withoutExclusions(text) {
+  return String(text || '')
+    .toLowerCase()
+    .replace(/\u2019/g, "'")
+    .split(CLAUSE_SPLIT)
+    .map(function (clause) {
+      var ws = clause.match(/[\p{L}\p{N}]+/gu) || [];
+      var out = [];
+      var left = 0;
+      var dropped = 0;
+      for (var i = 0; i < ws.length; i++) {
+        var n = cueAt(ws, i);
+        if (n) {
+          i += n - 1;
+          left = SCOPE_WORDS;
+          dropped = 0;
+          continue;
+        }
+        var w = ws[i];
+        if (left > 0) {
+          if (SCOPE_ENDS.has(w) || (w === 'and' && dropped > 0)) left = 0;
+          else {
+            if (isContent(w)) {
+              left--;
+              dropped++;
+            }
+            continue;
+          }
+        }
+        out.push(w);
+      }
+      return out.join(' ');
+    })
+    .join('. ');
+}
+
+/** tokens() of a task: the words it rules out dropped first. */
+function queryTokens(text) {
+  return tokens(withoutExclusions(text));
+}
+
+/** Leading id segments ("engineering-", "mastermind:", "analysis:") that are
+ *  shared by >= PREFIX_MIN_SHARED ids or equal the item's category. */
+function categoryPrefixes(items) {
+  var counts = new Map();
+  items.forEach(function (item) {
+    var first = String(item.id).toLowerCase().split(/[-:_/]/)[0];
+    counts.set(first, (counts.get(first) || 0) + 1);
+  });
+  return function isPrefix(item, first) {
+    return (counts.get(first) || 0) >= PREFIX_MIN_SHARED || String(item.category || '').toLowerCase() === first;
+  };
+}
+
+/** Name/id words that identify the item: the id minus a category prefix (kept
+ *  when it is the whole id) plus the name, minus family words. */
+function strongTerms(item, isPrefix) {
+  var segments = String(item.id).toLowerCase().split(/[-:_/]/);
+  var idPart = segments.length > 1 && isPrefix(item, segments[0]) ? segments.slice(1) : segments;
+  var list = words(idPart.join(' ') + ' ' + (item.name || '')).filter(function (w) {
+    return isContent(w) && !GENERIC_WORDS.has(w);
+  });
+  return new Set(list.map(stem));
+}
+
+function termCounts(list) {
+  var m = new Map();
+  list.forEach(function (t) {
+    m.set(t, (m.get(t) || 0) + 1);
+  });
+  return m;
+}
+
+/** Per-catalog index: strong/weak term maps, lengths and document frequency. */
+function indexFor(items) {
+  var isPrefix = categoryPrefixes(items);
+  var df = new Map();
+  var total = 0;
+  var docs = items.map(function (item) {
+    var strong = strongTerms(item, isPrefix);
+    var weakList = tokens((item.description || '') + ' ' + (item.text || ''));
+    var weak = termCounts(weakList);
+    new Set(Array.from(strong).concat(Array.from(weak.keys()))).forEach(function (t) {
+      df.set(t, (df.get(t) || 0) + 1);
+    });
+    total += weakList.length;
+    return { strong: strong, weak: weak, len: weakList.length, low: item.pick === 'low' };
+  });
+  return { size: items.length, docs: docs, df: df, avg: total / items.length || 1 };
+}
+
+function idf(index, term) {
+  var n = index.df.get(term) || 0;
+  return Math.log(1 + (index.size - n + 0.5) / (n + 0.5));
+}
+
+function scoreDoc(index, doc, query) {
+  var score = 0;
+  var matched = 0;
+  for (var i = 0; i < query.length; i++) {
+    var t = query[i];
+    var tf = doc.weak.get(t) || 0;
+    var hit = doc.strong.has(t) ? STRONG_WEIGHT : 0;
+    if (tf) hit += (tf * (K1 + 1)) / (tf + K1 * (1 - B + (B * doc.len) / index.avg));
+    if (hit) {
+      score += idf(index, t) * hit;
+      matched++;
+    }
+  }
+  // Coordination: an item matching more of the task's words ranks higher.
+  if (query.length) score *= matched / query.length;
+  if (doc.low) score *= LOW_PICK_FACTOR;
+  return Math.round(score * 1000) / 1000;
+}
+
+/** Items ranked by keyword relevance to `query`, forced `include` ids first,
+ *  capped at `limit`. Each returned item is a copy with a `score` (0 = no
+ *  overlap). Equal scores keep catalog order. */
+function shortlist(query, items, limit, include) {
+  var index = indexFor(items);
+  var q = Array.from(new Set(queryTokens(query)));
+  var scored = items.map(function (item, i) {
+    return { item: item, index: i, score: scoreDoc(index, index.docs[i], q) };
+  });
+  scored.sort(function (a, b) {
+    return b.score - a.score || a.index - b.index;
+  });
+  var out = [];
+  var seen = new Set();
+  function take(entry) {
+    if (seen.has(entry.item.id) || out.length >= limit) return;
+    seen.add(entry.item.id);
+    out.push(Object.assign({}, entry.item, { score: entry.score }));
+  }
+  (include || []).forEach(function (id) {
+    var hit = scored.find(function (s) {
+      return s.item.id === id;
+    });
+    if (hit) take(hit);
+  });
+  scored.forEach(take);
+  return out;
+}
+
+module.exports = {
+  stem: stem,
+  tokens: tokens,
+  queryTokens: queryTokens,
+  withoutExclusions: withoutExclusions,
+  shortlist: shortlist,
+};