@netlify/agent-runner-cli 2.17.0-PAW-612.0 → 2.18.0

package/scripts/build-skills.js

@@ -1,4 +1,5 @@
-import { appendFile, cp, mkdir, readdir, readFile, rm } from 'node:fs/promises'
+import { existsSync } from 'node:fs'
+import { cp, mkdir, readdir, readFile, rm, writeFile } from 'node:fs/promises'
 import { createRequire } from 'node:module'
 import path from 'node:path'
 import process from 'node:process'
@@ -8,34 +9,55 @@ const localSkillsDir = new URL('../src/skills/', import.meta.url)
 const sharedPackagePath = createRequire(import.meta.url).resolve('@netlify/skills/package.json')
 const sharedSkillsDir = path.join(path.dirname(sharedPackagePath), 'skills')
 export const bundledSkillsDir = fileURLToPath(new URL('../dist/skills/', import.meta.url))
-const selectedSharedSkills = [
-  { name: 'netlify-access-control' },
-  {
-    name: 'netlify-forms',
-    instructions: new URL('../src/skill-instructions/netlify-forms.md', import.meta.url),
-    assets: new URL('../src/skill-assets/netlify-forms/', import.meta.url),
-  },
-  {
-    name: 'netlify-image-cdn',
-    instructions: new URL('../src/skill-instructions/netlify-image-cdn.md', import.meta.url),
-  },
-]
+const skillOverridesDir = fileURLToPath(new URL('../src/skill-overrides/', import.meta.url))
+export const selectedSharedSkills = ['netlify-access-control', 'netlify-forms', 'netlify-image-cdn', 'netlify-identity']
+
+const readOptionalFile = async (filePath) => {
+  try {
+    return await readFile(filePath, 'utf8')
+  } catch (error) {
+    if (error.code === 'ENOENT') return undefined
+    throw error
+  }
+}
+
+export const applySkillReplacements = (content, replacements) => {
+  let result = content
+  for (const { from, to } of replacements) {
+    if (!from || result.split(from).length !== 2) {
+      throw new Error(`Expected exactly one occurrence of shared skill text: ${JSON.stringify(from)}`)
+    }
+    result = result.replace(from, () => to)
+  }
+  return result
+}
 
 export const buildSkills = async (targetDir = bundledSkillsDir) => {
   await rm(targetDir, { recursive: true, force: true })
   await cp(localSkillsDir, targetDir, { recursive: true })
 
-  for (const { name, instructions, assets } of selectedSharedSkills) {
+  for (const name of selectedSharedSkills) {
     await cp(path.join(sharedSkillsDir, name), path.join(targetDir, name), {
       recursive: true,
       force: false,
       errorOnExist: true,
     })
-    if (instructions) {
-      await appendFile(path.join(targetDir, name, 'SKILL.md'), `\n\n${await readFile(instructions, 'utf8')}`)
+    const overrideDir = path.join(skillOverridesDir, name)
+    const replacements = await readOptionalFile(path.join(overrideDir, 'replacements.json'))
+    const instructions = await readOptionalFile(path.join(overrideDir, 'instructions.md'))
+    if (instructions !== undefined || replacements !== undefined) {
+      const skillPath = path.join(targetDir, name, 'SKILL.md')
+      let content = await readFile(skillPath, 'utf8')
+      if (replacements !== undefined) {
+        content = applySkillReplacements(content, JSON.parse(replacements))
+      }
+      if (instructions !== undefined) {
+        content += `\n\n${instructions}`
+      }
+      await writeFile(skillPath, content)
     }
-    if (assets) {
-      const assetsDir = fileURLToPath(assets)
+    const assetsDir = path.join(overrideDir, 'assets')
+    if (existsSync(assetsDir)) {
       for (const entry of await readdir(assetsDir, { recursive: true, withFileTypes: true })) {
         if (!entry.isFile()) continue
         const source = path.join(entry.parentPath, entry.name)