@bonesofspring/ai-rules 0.2.25 → 0.2.27

package/scripts/lib/generate-adapter-common.mjs

@@ -0,0 +1,404 @@
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+
+export function walkFiles(root) {
+  const files = [];
+  const visit = (dir) => {
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+      const full = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        visit(full);
+      } else if (entry.isFile()) {
+        files.push(path.relative(root, full).split(path.sep).join('/'));
+      }
+    }
+  };
+  visit(root);
+  return files.sort();
+}
+
+export function stripFrontmatter(text) {
+  if (!text.startsWith('---\n')) {
+    return { frontmatter: '', body: text };
+  }
+  const end = text.indexOf('\n---\n', 4);
+  if (end < 0) {
+    return { frontmatter: '', body: text };
+  }
+  return {
+    frontmatter: text.slice(4, end),
+    body: text.slice(end + 5).replace(/^\n/, ''),
+  };
+}
+
+export function parseFrontmatterFields(frontmatter) {
+  const fields = {};
+  for (const line of frontmatter.split('\n')) {
+    const match = line.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
+    if (!match) {
+      continue;
+    }
+    const raw = match[2].trim();
+    fields[match[1]] = raw.replace(/^["']|["']$/g, '');
+  }
+  return fields;
+}
+
+export function sha256(content) {
+  return crypto.createHash('sha256').update(content).digest('hex');
+}
+
+export function sharedCoreStem(text) {
+  const match = text.match(/<!--\s*shared-core:\s*([^\s>]+)\s*-->/);
+  return match ? match[1] : undefined;
+}
+
+/**
+ * Adapter-local prose after the shared-core body: everything from the first
+ * `## Stack notes` heading to the end. Mirrors `sync-shared-core-embeds.sh`, which
+ * preserves this section when propagating core bodies into Cursor/Claude.
+ * Returns `''` when the body has no `## Stack notes` section.
+ */
+export function extractStackNotesSection(body) {
+  const match = body.match(/(^|\n)(## Stack notes[^\n]*\n[\s\S]*)$/);
+  return match ? match[2].trimEnd() : '';
+}
+
+export function isEmbedEntryBody(body) {
+  const first = body
+    .split('\n')
+    .map((line) => line.trim())
+    .find((line) => line.length > 0);
+  return Boolean(first && /^<!--\s*shared-core:\s*[^\s>]+\s*-->\s*$/.test(first));
+}
+
+export function entry({
+  source,
+  target,
+  category,
+  disposition,
+  loadMode,
+  reason,
+  sourceText,
+}) {
+  const item = {
+    source,
+    target,
+    category,
+    disposition,
+    loadMode,
+    reason,
+  };
+  const stem = sourceText ? sharedCoreStem(sourceText) : undefined;
+  if (stem) {
+    item.sharedCoreStem = stem;
+  }
+  return item;
+}
+
+export function readSiblingReadme(cursorRoot, rel) {
+  const filePath = path.join(cursorRoot, rel);
+  return fs.existsSync(filePath) ? fs.readFileSync(filePath, 'utf8') : `# ${rel}\n`;
+}
+
+/**
+ * Shared derive loop for the `mavis` and `opencode` adapters: reset the platform
+ * tree, walk the Cursor SoT, apply the omit list, dispatch each source to the first
+ * matching rule, then assemble `adapter-map.json`.
+ *
+ * Platform differences (targets, transforms, load modes, README prose) stay with the
+ * caller: `rules` is an ordered `[{ match(source), map(context) }]` table whose `map`
+ * returns `{ target, content, category, disposition, loadMode, reason }`, and
+ * `finalize` writes the platform's own README set.
+ */
+export function deriveAdapterStack({ platform, stack, root, omit, rules, finalize }) {
+  const cursorRoot = path.join(root, 'presets', 'cursor', stack);
+  const platformRoot = path.join(root, 'presets', platform, stack);
+  if (!fs.existsSync(cursorRoot)) {
+    throw new Error(`missing Cursor SoT ${cursorRoot}`);
+  }
+
+  const writeFile = (relPath, content) => {
+    const dest = path.join(platformRoot, relPath);
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    fs.writeFileSync(dest, content);
+  };
+
+  fs.rmSync(platformRoot, { recursive: true, force: true });
+  fs.mkdirSync(platformRoot, { recursive: true });
+
+  const cursorFiles = walkFiles(cursorRoot);
+  const entries = [];
+  const digestParts = [];
+
+  for (const source of cursorFiles.filter((rel) => path.basename(rel) !== 'README.md')) {
+    const sourceText = fs.readFileSync(path.join(cursorRoot, source), 'utf8');
+    digestParts.push(`${source}\t${sha256(sourceText)}`);
+
+    if (omit.has(source)) {
+      entries.push(
+        entry({
+          source,
+          target: null,
+          category: source.startsWith('hooks') ? 'hooks' : 'platform',
+          disposition: 'omit',
+          loadMode: 'not-installed',
+          reason: omit.get(source),
+          sourceText,
+        }),
+      );
+      continue;
+    }
+
+    const rule = rules.find((candidate) => candidate.match(source));
+    if (!rule) {
+      throw new Error(`unmapped cursor source: ${source}`);
+    }
+    const mapped = rule.map({ source, sourceText, cursorRoot, cursorFiles });
+    writeFile(mapped.target, mapped.content);
+    entries.push(
+      entry({
+        source,
+        target: mapped.target,
+        category: mapped.category,
+        disposition: mapped.disposition,
+        loadMode: mapped.loadMode,
+        reason: mapped.reason,
+        sourceText,
+      }),
+    );
+  }
+
+  finalize({ writeFile, cursorRoot, cursorFiles });
+
+  digestParts.sort();
+  const adapterMap = {
+    schemaVersion: 1,
+    platform,
+    stack,
+    semanticSource: `cursor/${stack}`,
+    sourceRevision: sha256(digestParts.join('\n')),
+    entries,
+  };
+  writeFile('adapter-map.json', `${JSON.stringify(adapterMap, null, 2)}\n`);
+  console.log(
+    `generated presets/${platform}/${stack} (${entries.length} mapped sources, revision ${adapterMap.sourceRevision.slice(0, 12)})`,
+  );
+  return adapterMap;
+}
+
+export function dropLeadingHeading(text) {
+  return text
+    .replace(/^# [^\n]+\n+/, '')
+    .replace(/^Short Cursor entry point\.[^\n]*\n+/, '');
+}
+
+export function stripInstallSection(body) {
+  const index = body.search(/^## Install\r?\n/m);
+  if (index < 0) {
+    return body.trimEnd();
+  }
+  return body.slice(0, index).trimEnd();
+}
+
+export function extractSkillsFragment(agentsMd) {
+  const match = agentsMd.match(/Skills: [^\n]+/);
+  return match ? match[0].trim() : '';
+}
+
+export function listOnDiskAdapterMapStacks(presetsRoot, platform) {
+  const platformDir = path.join(presetsRoot, platform);
+  if (!fs.existsSync(platformDir)) {
+    throw new Error(`missing presets/${platform}`);
+  }
+  return fs
+    .readdirSync(platformDir, { withFileTypes: true })
+    .filter(
+      (entry) =>
+        entry.isDirectory() &&
+        fs.existsSync(path.join(platformDir, entry.name, 'adapter-map.json')),
+    )
+    .map((entry) => entry.name)
+    .sort();
+}
+
+export function assertReleasedStacksMatchOnDisk(presetsRoot, platform) {
+  const released = loadReleasedStacks(presetsRoot, platform);
+  const onDisk = listOnDiskAdapterMapStacks(presetsRoot, platform);
+  const releasedSet = new Set(released);
+  const extra = onDisk.filter((stack) => !releasedSet.has(stack));
+  if (extra.length > 0) {
+    throw new Error(
+      `presets/${platform}/ has adapter-map.json for stacks not in releasedStacks: ${extra.join(', ')}`,
+    );
+  }
+}
+
+export function rewriteMdcToMd(text) {
+  return text
+    .replace(/`([^`\n]+)\.mdc`/g, '`$1.md`')
+    .replace(/(?<![\w./-])([\w-]+)\.mdc\b/g, '$1.md');
+}
+
+export function rewriteConsumerRoot(text, fromRoot, toRoot) {
+  return text
+    // Living conventions live at `.ai.local/conventions.md`; `.ai.local/team/**`
+    // is pipeline artifacts and is never loaded as rules. Rewrite the conventions
+    // path before the generic `<tool>/team` → `.ai.local/team` replacements below.
+    .replaceAll('.cursor/team/conventions.md', '.ai.local/conventions.md')
+    .replaceAll('.claude/team/conventions.md', '.ai.local/conventions.md')
+    .replaceAll('.mavis/team/conventions.md', '.ai.local/conventions.md')
+    .replaceAll('.opencode/team/conventions.md', '.ai.local/conventions.md')
+    .replaceAll('.tool/team/conventions.md', '.ai.local/conventions.md')
+    .replaceAll('.cursor/team', '.ai.local/team')
+    .replaceAll('.claude/team', '.ai.local/team')
+    .replaceAll('.mavis/team', '.ai.local/team')
+    .replaceAll('.opencode/team', '.ai.local/team')
+    .replaceAll('.tool/team', '.ai.local/team')
+    .replaceAll(`path.join(process.cwd(), '.${fromRoot}', 'team')`, "path.join(process.cwd(), '.ai.local', 'team')")
+    .replaceAll("path.join(process.cwd(), '.cursor', 'team')", "path.join(process.cwd(), '.ai.local', 'team')")
+    .replaceAll("path.join(process.cwd(), '.claude', 'team')", "path.join(process.cwd(), '.ai.local', 'team')")
+    .replaceAll("path.join(process.cwd(), '.mavis', 'team')", "path.join(process.cwd(), '.ai.local', 'team')")
+    .replaceAll("path.join(process.cwd(), '.opencode', 'team')", "path.join(process.cwd(), '.ai.local', 'team')")
+    .replaceAll(`.${fromRoot}/rules`, `.${toRoot}/rules`)
+    .replaceAll(`.${fromRoot}/skills`, `.${toRoot}/skills`)
+    .replaceAll(`.${fromRoot}/agents`, `.${toRoot}/agents`)
+    .replaceAll(`.${fromRoot}/commands`, `.${toRoot}/commands`)
+    .replaceAll(`.${fromRoot}/hooks`, `.${toRoot}/hooks`)
+    .replaceAll(`.${fromRoot}/AGENTS.md`, `.${toRoot}/AGENTS.md`)
+    .replaceAll(`'.${fromRoot}'`, `'.${toRoot}'`)
+    .replaceAll(`".${fromRoot}"`, `".${toRoot}"`)
+    .replaceAll(`const PLATFORM = '${fromRoot}'`, `const PLATFORM = '${toRoot}'`);
+}
+
+export function loadReleasedStacks(presetsRoot, platform) {
+  const contractPath = path.join(presetsRoot, platform, 'platform-contract.json');
+  if (!fs.existsSync(contractPath)) {
+    throw new Error(`missing presets/${platform}/platform-contract.json`);
+  }
+  const contract = JSON.parse(fs.readFileSync(contractPath, 'utf8'));
+  const released = contract.releasedStacks;
+  if (!Array.isArray(released) || released.length === 0) {
+    throw new Error(`presets/${platform}/platform-contract.json has empty releasedStacks`);
+  }
+  return released;
+}
+
+export function countAgentRoleFiles(relativePaths) {
+  return relativePaths.filter(
+    (rel) =>
+      rel.startsWith('agents/') &&
+      rel.endsWith('.md') &&
+      path.basename(rel) !== 'README.md',
+  ).length;
+}
+
+export function rewriteAgentRosterCount(text, count, label = 'commands/README.md') {
+  const pattern = /(- Subagents: `\.\.\/agents\/` \()(\*\*)?(\d+)(\*\*)?( roles)/;
+  const match = text.match(pattern);
+  if (!match) {
+    return text;
+  }
+  const found = Number(match[3]);
+  if (found !== count) {
+    throw new Error(
+      `${label}: Subagents roster count ${found} !== ${count} agent files; fix the Cursor SoT`,
+    );
+  }
+  return text;
+}
+
+export function rewriteCursorPipelineIntro(text, replacement) {
+  return text.replace(
+    /Role(?:-based)? subagents for the Cursor (?:agent-)?team pipeline(?: \([^)]+\))?/g,
+    replacement,
+  );
+}
+
+export function rewriteCursorModelPinBullet(text, replacement) {
+  return text.replace(
+    /- omit on `standard` → agent frontmatter \(`fast` \/ `inherit` \/ `claude-opus-4-8\[effort=high]`\)/g,
+    replacement,
+  );
+}
+
+export function rewriteOrchestratorCursorNotes(markdown, { frontmatterLine, stackNotes }) {
+  let next = markdown.replace(/\*\*Cursor frontmatter:\*\*[^\n]+/, frontmatterLine);
+  next = next.replace(
+    '## Team artifact I/O (Cursor Shell sandbox)',
+    '## Team artifact I/O',
+  );
+  if (stackNotes && !next.includes('## Stack notes')) {
+    next = next.replace(
+      '## Dynamic pipeline',
+      `## Stack notes\n\n${stackNotes}\n\n## Dynamic pipeline`,
+    );
+  }
+  return next;
+}
+
+function leakedCursorPackaging(text) {
+  return (
+    /^## Frontmatter `readonly`/m.test(text) ||
+    /claude-opus/.test(text) ||
+    /\[effort=/.test(text)
+  );
+}
+
+export function replaceCursorFrontmatterReadonlyBlock(text, replacement, label) {
+  const block = replacement.replace(/\n+$/, '\n\n');
+  let start = -1;
+  let end = -1;
+  if (/^## Frontmatter `readonly`/m.test(text)) {
+    start = text.search(/^## Frontmatter `readonly`/m);
+    const fromNext = text.slice(start + 1);
+    const rel = fromNext.search(/^## (?!Model matrix)/m);
+    end = rel < 0 ? text.length : start + 1 + rel;
+  } else if (/^## Model tiers \(mirror ios-swift\)/m.test(text)) {
+    start = text.search(/^## Model tiers \(mirror ios-swift\)/m);
+    const fromNext = text.slice(start + 1);
+    const rel = fromNext.search(/^## /m);
+    end = rel < 0 ? text.length : start + 1 + rel;
+  } else {
+    const next = `${text.replace(/\s+$/, '\n\n')}${block}`;
+    if (leakedCursorPackaging(next)) {
+      throw new Error(`${label}: agents/README.md packaging rewrite leaked Cursor model pins`);
+    }
+    return next;
+  }
+  const next = `${text.slice(0, start)}${block}${text.slice(end)}`;
+  if (leakedCursorPackaging(next)) {
+    throw new Error(`${label}: agents/README.md packaging rewrite did not apply`);
+  }
+  return next;
+}
+
+export function standardTierCell(profile) {
+  if (profile.family === 'frontend') {
+    return '`feature-developer`, `debugger`, `ci-investigator`, `api-contract-reviewer`, `accessibility-reviewer`, `qa-tester`, `unit-test-*`, `playwright-test-*`, `openspec-author`';
+  }
+  if (profile.family === 'ios') {
+    return '`feature-developer`, `debugger`, `ci-investigator`, `api-contract-reviewer`, `accessibility-reviewer`, `qa-tester`, `unit-test-*`, `xcuitest-test-*`, `openspec-author`';
+  }
+  if (profile.family === 'android') {
+    return '`feature-developer`, `debugger`, `ci-investigator`, `api-contract-reviewer`, `accessibility-reviewer`, `qa-tester`, `unit-test-*`, `instrumentation-test-*`, `openspec-author`';
+  }
+  if (profile.family === 'mcp-ts') {
+    return '`feature-developer`';
+  }
+  return '`feature-developer`, `debugger`, `ci-investigator`, `api-contract-reviewer`, `qa-tester`, `unit-test-*`, `integration-test-*`, `openspec-author`';
+}
+
+export function strongTierCell(profile) {
+  const base =
+    '`solution-architect`, `migration-specialist`, `security-reviewer`, `performance-auditor`';
+  if (
+    profile.family === 'frontend' ||
+    profile.family === 'ios' ||
+    profile.family === 'android'
+  ) {
+    return `${base}, \`mockup-reviewer\``;
+  }
+  return base;
+}