@brms/ai-skills 0.1.0

package/skills/brms-prototype-generator/scripts/check-project.mjs

@@ -0,0 +1,228 @@
+#!/usr/bin/env node
+import fs from 'node:fs'
+import path from 'node:path'
+
+function parseArgs(argv) {
+  const args = {
+    repoRoot: process.cwd(),
+    targetProject: '',
+    format: 'markdown',
+  }
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i]
+    if (arg === '--repo-root') {
+      args.repoRoot = argv[i + 1] || ''
+      i += 1
+    }
+    else if (arg === '--target-project') {
+      args.targetProject = argv[i + 1] || ''
+      i += 1
+    }
+    else if (arg === '--format') {
+      args.format = argv[i + 1] || ''
+      i += 1
+    }
+    else if (arg === '--help' || arg === '-h') {
+      args.help = true
+    }
+    else {
+      throw new Error(`Unknown argument: ${arg}`)
+    }
+  }
+
+  if (!['json', 'markdown', 'both'].includes(args.format))
+    throw new Error('--format must be one of: json, markdown, both')
+
+  return args
+}
+
+function existsDir(filePath) {
+  return fs.existsSync(filePath) && fs.statSync(filePath).isDirectory()
+}
+
+function existsFile(filePath) {
+  return fs.existsSync(filePath) && fs.statSync(filePath).isFile()
+}
+
+function readJson(filePath) {
+  if (!existsFile(filePath))
+    return null
+  try {
+    return JSON.parse(fs.readFileSync(filePath, 'utf8'))
+  }
+  catch {
+    return null
+  }
+}
+
+function rel(filePath, root) {
+  return path.relative(root, filePath).replaceAll(path.sep, '/')
+}
+
+function hasAnyDependency(pkg, names) {
+  const deps = {
+    ...(pkg?.dependencies || {}),
+    ...(pkg?.devDependencies || {}),
+  }
+  return names.some(name => Object.prototype.hasOwnProperty.call(deps, name))
+}
+
+function findProjects(repoRoot, targetProject) {
+  const projectRoot = path.join(repoRoot, 'project')
+  if (!existsDir(projectRoot))
+    return []
+
+  const explicitTarget = Boolean(targetProject)
+  const requested = targetProject
+    ? [targetProject.replaceAll('\\', '/').replace(/^project\//, '')]
+    : fs.readdirSync(projectRoot, { withFileTypes: true }).filter(entry => entry.isDirectory()).map(entry => entry.name)
+
+  return requested.flatMap((name) => {
+    const projectDir = path.join(projectRoot, name)
+    const packageJson = path.join(projectDir, 'package.json')
+    const pkg = readJson(packageJson)
+    const srcDir = path.join(projectDir, 'src')
+    const viewsDir = path.join(srcDir, 'views')
+    const routeConfig = path.join(srcDir, 'routers', 'config', 'index.ts')
+    const localMenu = path.join(srcDir, 'routers', 'localMenuList.json')
+    const dynamicRouter = path.join(srcDir, 'routers', 'modules', 'dynamicRouter.ts')
+
+    if (!explicitTarget && !existsDir(viewsDir))
+      return []
+
+    return [{
+      id: name,
+      exists: existsDir(projectDir),
+      packageName: pkg?.name || '',
+      projectDir: existsDir(projectDir) ? rel(projectDir, repoRoot) : `project/${name}`,
+      srcDir: existsDir(srcDir) ? rel(srcDir, repoRoot) : '',
+      viewsDir: existsDir(viewsDir) ? rel(viewsDir, repoRoot) : '',
+      hasVueVite: hasAnyDependency(pkg, ['vue', 'vite', '@vitejs/plugin-vue']),
+      hasVxePlus: hasAnyDependency(pkg, ['@vxe-plus/components', 'vxe-table', 'vxe-pc-ui']),
+      hasEiInfo: hasAnyDependency(pkg, ['@eplat/ei']),
+      routeStyle: existsFile(routeConfig)
+        ? 'config'
+        : existsFile(localMenu)
+          ? 'local-menu'
+          : existsFile(dynamicRouter)
+            ? 'dynamic-router'
+            : 'unknown',
+      routeFile: existsFile(routeConfig)
+        ? rel(routeConfig, repoRoot)
+        : existsFile(localMenu)
+          ? rel(localMenu, repoRoot)
+          : existsFile(dynamicRouter)
+            ? rel(dynamicRouter, repoRoot)
+            : '',
+    }]
+  })
+}
+
+function check(repoRoot, targetProject) {
+  const rootPkg = readJson(path.join(repoRoot, 'package.json'))
+  const workspaceFile = path.join(repoRoot, 'pnpm-workspace.yaml')
+  const blockers = []
+  const warnings = []
+  const signals = []
+
+  if (!rootPkg)
+    blockers.push('repo root is missing a readable package.json')
+  else
+    signals.push(`repo package: ${rootPkg.name || '(unnamed)'}`)
+
+  if (!existsFile(workspaceFile))
+    blockers.push('repo root is missing pnpm-workspace.yaml')
+  else
+    signals.push('pnpm workspace detected')
+
+  if (rootPkg?.volta?.node && rootPkg.volta.node !== '18.17.0')
+    warnings.push(`repo Volta node is ${rootPkg.volta.node}; skill was validated on 18.17.0`)
+  if (rootPkg?.volta?.pnpm && rootPkg.volta.pnpm !== '8.10.4')
+    warnings.push(`repo Volta pnpm is ${rootPkg.volta.pnpm}; skill was validated on 8.10.4`)
+
+  if (!hasAnyDependency(rootPkg, ['@eplat/ei']))
+    warnings.push('root package does not declare @eplat/ei; prototype can still use mock mode')
+
+  const hasExplicitTarget = Boolean(targetProject)
+  const projects = findProjects(repoRoot, targetProject)
+  if (!projects.length)
+    blockers.push('no project candidates found under project/*')
+  if (!hasExplicitTarget && projects.length > 1)
+    blockers.push('multiple project candidates found; ask the user to choose one and rerun with --target-project project/<name>')
+
+  for (const project of projects) {
+    if (!project.exists) {
+      blockers.push(`${project.projectDir} does not exist`)
+      continue
+    }
+    if (!project.srcDir)
+      blockers.push(`${project.projectDir} is missing src/`)
+    if (!project.viewsDir)
+      blockers.push(`${project.projectDir} is missing src/views/`)
+    if (!project.hasVueVite)
+      warnings.push(`${project.projectDir} does not clearly declare Vue/Vite dependencies`)
+    if (!project.hasVxePlus)
+      warnings.push(`${project.projectDir} does not clearly declare VxePlus/Vxe dependencies`)
+    if (project.routeStyle === 'unknown')
+      warnings.push(`${project.projectDir} route/menu registration style was not detected; plan route handoff manually`)
+    else
+      signals.push(`${project.projectDir} route style: ${project.routeStyle} (${project.routeFile})`)
+  }
+
+  return {
+    ok: blockers.length === 0,
+    repoRoot,
+    skill: 'brms-prototype-generator',
+    needsTargetProject: !hasExplicitTarget && projects.length > 1,
+    blockers,
+    warnings,
+    signals,
+    projects,
+  }
+}
+
+function toMarkdown(report) {
+  const lines = [`# ${report.skill} Project Check`, '', `- Status: ${report.ok ? 'ok' : 'blocked'}`]
+  if (report.blockers.length) {
+    lines.push('', '## Blockers', ...report.blockers.map(item => `- ${item}`))
+  }
+  if (report.warnings.length) {
+    lines.push('', '## Warnings', ...report.warnings.map(item => `- ${item}`))
+  }
+  if (report.signals.length) {
+    lines.push('', '## Signals', ...report.signals.map(item => `- ${item}`))
+  }
+  if (report.projects.length) {
+    lines.push('', '## Projects')
+    for (const project of report.projects) {
+      lines.push(`- ${project.projectDir}: ${project.packageName || '(no package name)'}`)
+    }
+  }
+  return lines.join('\n')
+}
+
+function main() {
+  const args = parseArgs(process.argv.slice(2))
+  if (args.help) {
+    console.log('Usage: node scripts/check-project.mjs [--repo-root <repo>] [--target-project project/name] [--format json|markdown|both]')
+    process.exit(0)
+  }
+
+  const report = check(path.resolve(args.repoRoot), args.targetProject)
+  if (args.format === 'json' || args.format === 'both')
+    console.log(JSON.stringify(report, null, 2))
+  if (args.format === 'both')
+    console.log('\n---\n')
+  if (args.format === 'markdown' || args.format === 'both')
+    console.log(toMarkdown(report))
+  process.exit(report.ok ? 0 : 1)
+}
+
+try {
+  main()
+}
+catch (error) {
+  console.error(error instanceof Error ? error.message : String(error))
+  process.exit(1)
+}

package/skills/brms-prototype-generator/scripts/discover-targets.mjs

@@ -0,0 +1,158 @@
+#!/usr/bin/env node
+import fs from 'node:fs'
+import path from 'node:path'
+
+function parseArgs(argv) {
+  const args = {
+    repoRoot: process.cwd(),
+    format: 'markdown',
+  }
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i]
+    if (arg === '--repo-root') {
+      args.repoRoot = argv[i + 1] || ''
+      i += 1
+    }
+    else if (arg === '--format') {
+      args.format = argv[i + 1] || ''
+      i += 1
+    }
+    else if (arg === '--help' || arg === '-h') {
+      args.help = true
+    }
+    else {
+      throw new Error(`Unknown argument: ${arg}`)
+    }
+  }
+
+  if (!['json', 'markdown', 'both'].includes(args.format))
+    throw new Error('--format must be one of: json, markdown, both')
+
+  return args
+}
+
+function existsDir(filePath) {
+  return fs.existsSync(filePath) && fs.statSync(filePath).isDirectory()
+}
+
+function existsFile(filePath) {
+  return fs.existsSync(filePath) && fs.statSync(filePath).isFile()
+}
+
+function toRepoRelative(filePath, repoRoot) {
+  return path.relative(repoRoot, filePath).replaceAll(path.sep, '/')
+}
+
+function readPackageName(projectDir) {
+  const packageJson = path.join(projectDir, 'package.json')
+  if (!existsFile(packageJson))
+    return ''
+
+  try {
+    return JSON.parse(fs.readFileSync(packageJson, 'utf8')).name || ''
+  }
+  catch {
+    return ''
+  }
+}
+
+function discover(repoRoot) {
+  const projectRoot = path.join(repoRoot, 'project')
+  const candidates = []
+
+  if (!existsDir(projectRoot))
+    return { repoRoot, candidates }
+
+  for (const entry of fs.readdirSync(projectRoot, { withFileTypes: true })) {
+    if (!entry.isDirectory())
+      continue
+
+    const projectDir = path.join(projectRoot, entry.name)
+    const srcDir = path.join(projectDir, 'src')
+    const viewsDir = path.join(srcDir, 'views')
+    if (!existsDir(srcDir) && !existsDir(viewsDir))
+      continue
+
+    const routeConfigDir = path.join(srcDir, 'routers', 'config')
+    const routeIndex = path.join(routeConfigDir, 'index.ts')
+    const localMenu = path.join(srcDir, 'routers', 'localMenuList.json')
+    const dynamicRouter = path.join(srcDir, 'routers', 'modules', 'dynamicRouter.ts')
+    const routeStyle = existsFile(routeIndex)
+      ? 'config'
+      : existsFile(localMenu)
+        ? 'local-menu'
+        : existsFile(dynamicRouter)
+          ? 'dynamic-router'
+          : 'unknown'
+    const routeFile = existsFile(routeIndex)
+      ? routeIndex
+      : existsFile(localMenu)
+        ? localMenu
+        : existsFile(dynamicRouter)
+          ? dynamicRouter
+          : ''
+
+    candidates.push({
+      id: entry.name,
+      packageName: readPackageName(projectDir),
+      projectDir: toRepoRelative(projectDir, repoRoot),
+      srcDir: existsDir(srcDir) ? toRepoRelative(srcDir, repoRoot) : '',
+      viewsDir: existsDir(viewsDir) ? toRepoRelative(viewsDir, repoRoot) : '',
+      routeConfigDir: existsDir(routeConfigDir) ? toRepoRelative(routeConfigDir, repoRoot) : '',
+      routeConfigIndex: existsFile(routeIndex) ? toRepoRelative(routeIndex, repoRoot) : '',
+      routeStyle,
+      routeFile: routeFile ? toRepoRelative(routeFile, repoRoot) : '',
+      canRegisterStaticRoute: routeStyle === 'config',
+    })
+  }
+
+  return { repoRoot, candidates }
+}
+
+function toMarkdown(report) {
+  const lines = ['# BRMS Prototype Target Discovery', '']
+  if (!report.candidates.length) {
+    lines.push('- No project candidates found under `project/*`.')
+    return lines.join('\n')
+  }
+
+  report.candidates.forEach((candidate, index) => {
+    lines.push(`## ${index + 1}. ${candidate.id}`)
+    lines.push(`- Project: \`${candidate.projectDir}\``)
+    if (candidate.packageName)
+      lines.push(`- Package: \`${candidate.packageName}\``)
+    lines.push(`- Views: ${candidate.viewsDir ? `\`${candidate.viewsDir}\`` : 'missing'}`)
+    lines.push(`- Route style: \`${candidate.routeStyle}\`${candidate.routeFile ? ` (\`${candidate.routeFile}\`)` : ''}`)
+    if (candidate.routeStyle !== 'config')
+      lines.push('- Menu handoff: inspect this route/menu style before writing route files; permission-center or local-menu projects may not use static route config.')
+    lines.push('')
+  })
+
+  return lines.join('\n')
+}
+
+function main() {
+  const args = parseArgs(process.argv.slice(2))
+  if (args.help) {
+    console.log('Usage: node scripts/discover-targets.mjs [--repo-root <repo>] [--format json|markdown|both]')
+    process.exit(0)
+  }
+
+  const repoRoot = path.resolve(args.repoRoot)
+  const report = discover(repoRoot)
+  if (args.format === 'json' || args.format === 'both')
+    console.log(JSON.stringify(report, null, 2))
+  if (args.format === 'both')
+    console.log('\n---\n')
+  if (args.format === 'markdown' || args.format === 'both')
+    console.log(toMarkdown(report))
+}
+
+try {
+  main()
+}
+catch (error) {
+  console.error(error instanceof Error ? error.message : String(error))
+  process.exit(1)
+}

package/skills/brms-prototype-generator/scripts/install-codex.mjs

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+function parseArgs(argv) {
+  const args = { target: '' }
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i]
+    if (arg === '--target') {
+      args.target = argv[i + 1] || ''
+      i += 1
+    }
+    else if (arg === '--help' || arg === '-h') {
+      args.help = true
+    }
+    else {
+      throw new Error(`Unknown argument: ${arg}`)
+    }
+  }
+
+  return args
+}
+
+function defaultTargetRoot() {
+  if (process.env.CODEX_HOME)
+    return path.join(process.env.CODEX_HOME, 'skills')
+
+  return path.join(os.homedir(), '.codex', 'skills')
+}
+
+function copySkill(sourceDir, targetDir) {
+  const source = path.resolve(sourceDir)
+  const target = path.resolve(targetDir)
+
+  if (source === target)
+    throw new Error('Source and target are the same directory.')
+
+  if (target.startsWith(`${source}${path.sep}`))
+    throw new Error('Target cannot be inside the source skill directory.')
+
+  fs.rmSync(target, { recursive: true, force: true })
+  fs.mkdirSync(path.dirname(target), { recursive: true })
+  fs.cpSync(source, target, {
+    recursive: true,
+    filter: src => !src.includes(`${path.sep}.DS_Store`),
+  })
+}
+
+function main() {
+  const args = parseArgs(process.argv.slice(2))
+  if (args.help) {
+    console.log('Usage: node scripts/install-codex.mjs [--target <codex-skills-dir>]')
+    process.exit(0)
+  }
+
+  const scriptPath = fileURLToPath(import.meta.url)
+  const skillDir = path.resolve(path.dirname(scriptPath), '..')
+  const targetRoot = path.resolve(args.target || defaultTargetRoot())
+  const targetDir = path.join(targetRoot, path.basename(skillDir))
+
+  copySkill(skillDir, targetDir)
+  console.log(`Installed ${path.basename(skillDir)} to ${targetDir}`)
+}
+
+try {
+  main()
+}
+catch (error) {
+  console.error(error instanceof Error ? error.message : String(error))
+  process.exit(1)
+}