@wooksjs/event-wf 0.6.3 → 0.6.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wooksjs/event-wf",
-  "version": "0.6.3",
+  "version": "0.6.4",
   "description": "@wooksjs/event-wf",
   "keywords": [
     "app",
@@ -47,13 +47,13 @@
   "devDependencies": {
     "typescript": "^5.9.3",
     "vitest": "^3.2.4",
-    "@wooksjs/event-core": "^0.6.3",
-    "wooks": "^0.6.3"
+    "@wooksjs/event-core": "^0.6.4",
+    "wooks": "^0.6.4"
   },
   "peerDependencies": {
     "@prostojs/logger": "^0.4.3",
-    "@wooksjs/event-core": "^0.6.3",
-    "wooks": "^0.6.3"
+    "@wooksjs/event-core": "^0.6.4",
+    "wooks": "^0.6.4"
   },
   "scripts": {
     "build": "rolldown -c ../../rolldown.config.mjs",

package/scripts/setup-skills.js

@@ -1,70 +1,77 @@
 #!/usr/bin/env node
-// @ts-check
-/**
- * Copies the event-wf skill files into the consuming project's
- * agent-skills directory so that AI coding agents (Claude Code, Cursor,
- * Windsurf, Codex, etc.) can discover and load them.
- *
- * Runs automatically on `postinstall` or manually via:
- *   npx @wooksjs/event-wf setup-skills
- */
+/* prettier-ignore */
+'use strict'
 
 const fs = require('fs')
 const path = require('path')
+const os = require('os')
 
 const SKILL_NAME = 'wooksjs-event-wf'
+const SKILL_SRC = path.join(__dirname, '..', 'skills', SKILL_NAME)
 
-/* ── locate the project root (first dir above node_modules) ──────── */
-function findProjectRoot() {
-  let dir = __dirname
-  while (dir !== path.dirname(dir)) {
-    dir = path.dirname(dir)
-    if (path.basename(dir) === 'node_modules') {
-      return path.dirname(dir)
-    }
-  }
-  return process.cwd()
+if (!fs.existsSync(SKILL_SRC)) {
+  console.error(`No skills found at ${SKILL_SRC}`)
+  console.error('Add your SKILL.md files to the skills/' + SKILL_NAME + '/ directory first.')
+  process.exit(1)
 }
 
-const projectRoot = findProjectRoot()
-const srcDir = path.join(__dirname, '..', 'skills', SKILL_NAME)
-const agents = [
-  { dir: '.claude', file: 'SKILL.md' },
-  { dir: '.cursor', file: 'SKILL.md' },
-  { dir: '.windsurf', file: 'SKILL.md' },
-  { dir: '.codex', file: 'SKILL.md' },
-]
+const AGENTS = {
+  'Claude Code': { dir: '.claude/skills',   global: path.join(os.homedir(), '.claude', 'skills') },
+  'Cursor':      { dir: '.cursor/skills',   global: path.join(os.homedir(), '.cursor', 'skills') },
+  'Windsurf':    { dir: '.windsurf/skills', global: path.join(os.homedir(), '.windsurf', 'skills') },
+  'Codex':       { dir: '.codex/skills',    global: path.join(os.homedir(), '.codex', 'skills') },
+  'OpenCode':    { dir: '.opencode/skills', global: path.join(os.homedir(), '.opencode', 'skills') },
+}
 
-/* ── copy skill files ────────────────────────────────────────────── */
-function copySkills() {
-  if (!fs.existsSync(srcDir)) {
-    console.log(`[${SKILL_NAME}] skills source not found, skipping.`)
-    return
-  }
+const args = process.argv.slice(2)
+const isGlobal = args.includes('--global') || args.includes('-g')
+const isPostinstall = args.includes('--postinstall')
+let installed = 0, skipped = 0
+const installedDirs = []
 
-  const files = fs.readdirSync(srcDir)
-  let copied = 0
+for (const [agentName, cfg] of Object.entries(AGENTS)) {
+  const targetBase = isGlobal ? cfg.global : path.join(process.cwd(), cfg.dir)
+  const agentRootDir = path.dirname(cfg.global) // Check if the agent has ever been installed globally
 
-  for (const agent of agents) {
-    const destDir = path.join(projectRoot, agent.dir, 'skills', SKILL_NAME)
-    fs.mkdirSync(destDir, { recursive: true })
+  // In postinstall mode: silently skip agents that aren't set up globally
+  if (isPostinstall || isGlobal) {
+    if (!fs.existsSync(agentRootDir)) { skipped++; continue }
+  }
 
-    for (const file of files) {
-      const src = path.join(srcDir, file)
-      const dest = path.join(destDir, file)
-      if (fs.statSync(src).isFile()) {
-        fs.copyFileSync(src, dest)
-        copied++
-      }
-    }
+  const dest = path.join(targetBase, SKILL_NAME)
+  try {
+    fs.mkdirSync(dest, { recursive: true })
+    fs.cpSync(SKILL_SRC, dest, { recursive: true })
+    console.log(`✅  ${agentName}: installed to ${dest}`)
+    installed++
+    if (!isGlobal) installedDirs.push(cfg.dir + '/' + SKILL_NAME)
+  } catch (err) {
+    console.warn(`⚠️   ${agentName}: failed — ${err.message}`)
   }
+}
 
-  console.log(`[${SKILL_NAME}] copied ${files.length} skill files to ${agents.length} agent dirs (${copied} total).`)
+// Add locally-installed skill dirs to .gitignore
+if (!isGlobal && installedDirs.length > 0) {
+  const gitignorePath = path.join(process.cwd(), '.gitignore')
+  let gitignoreContent = ''
+  try { gitignoreContent = fs.readFileSync(gitignorePath, 'utf8') } catch {}
+  const linesToAdd = installedDirs.filter(d => !gitignoreContent.includes(d))
+  if (linesToAdd.length > 0) {
+    const hasHeader = gitignoreContent.includes('# AI agent skills')
+    const block = (gitignoreContent && !gitignoreContent.endsWith('\n') ? '\n' : '')
+      + (hasHeader ? '' : '\n# AI agent skills (auto-generated by setup-skills)\n')
+      + linesToAdd.join('\n') + '\n'
+    fs.appendFileSync(gitignorePath, block)
+    console.log(`📝  Added ${linesToAdd.length} entries to .gitignore`)
+  }
 }
 
-try {
-  copySkills()
-} catch (err) {
-  // Non-fatal — don't break installs
-  console.log(`[${SKILL_NAME}] skill setup skipped: ${err.message}`)
+if (installed === 0 && isPostinstall) {
+  // Silence is fine — no agents present, nothing to do
+} else if (installed === 0 && skipped === Object.keys(AGENTS).length) {
+  console.log('No agent directories detected. Try --global or run without it for project-local install.')
+} else if (installed === 0) {
+  console.log('Nothing installed. Run without --global to install project-locally.')
+} else {
+  console.log(`\n✨  Done! Restart your AI agent to pick up the "${SKILL_NAME}" skill.`)
 }