@ultime/codecraft 1.0.3 → 1.2.0

package/src/install.mjs

@@ -0,0 +1,100 @@
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const PACKAGE_ROOT = fileURLToPath(new URL('..', import.meta.url))
+const SKILL_FILES = ['SKILL.md']
+const SKILL_DIRS = ['docs', 'scenarios', 'prompts']
+
+const AGENT_DIRS = {
+  claude: '.claude/skills',
+  trae: '.trae/skills',
+  cursor: '.cursor/skills',
+  generic: '.agents/skills',
+}
+
+const AGENT_MARKERS = {
+  claude: ['.claude', 'CLAUDE.md'],
+  trae: ['.trae'],
+  cursor: ['.cursor'],
+  generic: ['.agents'],
+}
+
+export const AGENTS = Object.keys(AGENT_DIRS)
+
+export function parseAgents(value) {
+  if (!value || value === 'auto') return []
+  const agents = [...new Set(value.split(',').map((item) => item.trim()).filter(Boolean))]
+  const invalid = agents.filter((agent) => !AGENTS.includes(agent))
+  if (invalid.length) {
+    throw new Error(`unknown agent: ${invalid.join(', ')}（可选：auto, ${AGENTS.join(', ')}）`)
+  }
+  return agents
+}
+
+export function buildInstallPlan(root, options = {}) {
+  const base = options.global ? os.homedir() : path.resolve(root)
+  const explicit = options.agents ?? []
+  const invalid = explicit.filter((agent) => !AGENTS.includes(agent))
+  if (invalid.length) {
+    throw new Error(`unknown agent: ${invalid.join(', ')}（可选：${AGENTS.join(', ')}）`)
+  }
+
+  const agents = explicit.length ? explicit : detectAgents(base, options.global)
+  const destinations = options.dest
+    ? [{ agent: 'custom', dir: path.resolve(base, options.dest) }]
+    : agents.map((agent) => ({ agent, dir: path.join(base, AGENT_DIRS[agent]) }))
+
+  assertSource()
+
+  return destinations.map(({ agent, dir }) => {
+    const target = path.join(dir, 'codecraft')
+    const exists = fs.existsSync(target)
+    return { agent, target, exists, action: exists ? 'exists' : 'create' }
+  })
+}
+
+export function applyInstallPlan(plan, options = {}) {
+  const created = []
+  const skipped = []
+  const replaced = []
+
+  for (const entry of plan) {
+    if (entry.exists && !options.force) {
+      skipped.push(entry.target)
+      continue
+    }
+    if (entry.exists) {
+      fs.rmSync(entry.target, { recursive: true, force: true })
+      replaced.push(entry.target)
+    }
+
+    fs.mkdirSync(entry.target, { recursive: true })
+    for (const file of SKILL_FILES) {
+      fs.copyFileSync(path.join(PACKAGE_ROOT, file), path.join(entry.target, file))
+    }
+    for (const dir of SKILL_DIRS) {
+      fs.cpSync(path.join(PACKAGE_ROOT, dir), path.join(entry.target, dir), { recursive: true })
+    }
+    created.push(entry.target)
+  }
+
+  return { created, skipped, replaced }
+}
+
+function detectAgents(base, global) {
+  const found = AGENTS.filter((agent) =>
+    AGENT_MARKERS[agent].some((marker) => fs.existsSync(path.join(base, marker))),
+  )
+  if (global) return found.length ? found : ['generic']
+  return [...new Set([...found, 'generic'])]
+}
+
+function assertSource() {
+  for (const file of SKILL_FILES) {
+    if (!fs.existsSync(path.join(PACKAGE_ROOT, file))) {
+      throw new Error(`skill source is incomplete: missing ${file}`)
+    }
+  }
+}

package/templates/app/README.md

@@ -8,7 +8,7 @@
 |---|---|
 | `src/pages` | 页面：一个页面一个编排入口，只编排 |
 | `src/components` | 展示与交互组件；原语薄、业务组件按域 |
-| `src/behavior` | 页面无关行为（hooks / composables） |
+| `src/behavior` | 页面无关行为：默认纯 TS core，框架绑定作薄适配（hooks / composables） |
 | `src/api` | 请求收口；唯一可接触 `external/` 的层 |
 | `src/adapters` | 平台适配（请求 / 存储 / 路由 / 导出） |
 | `src/types` | 内部类型：通用层与业务层 |
@@ -17,6 +17,7 @@
 ## 规则
 
 - `pages / components / behavior` 不 import `external/` 或 `generated/`。
+- 原生能表达的先写原生；Vue / React 只作页面与组件的落点。
 - 外部类型只在 `api` / `adapters` 内转成内部类型。
 - 鉴权失效、错误提示、分页各一处收口。
 - 状态用联合类型；非法状态不可表示。