@playcraft/cli 0.0.44 → 0.0.46

package/project-template/.claude/hooks/validate-atom-plan.mjs

@@ -1,224 +0,0 @@
-#!/usr/bin/env node
-/**
- * PM SubagentStop — 校验 docs/atom-plan.json 中 skillRef 均存在于 skills 库。
- * 优先调用 `playcraft skills validate-atom-plan`；若 CLI 不可用则内嵌最小校验。
- *
- * Exit 0 = pass
- * Exit 2 = block (Claude / Cursor subagent stop)
- */
-
-import { spawnSync } from 'node:child_process';
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const __filename = fileURLToPath(import.meta.url);
-
-const SKILL_REF_EMPTY = new Set(['', '—', '-', '–']);
-const SKILL_REF_SUFFIX_RE = /\.(aigameplay|aiconfig)$/;
-
-/** @param {string} raw */
-function parseHookInput(raw) {
-  if (!raw.trim()) return {};
-  try {
-    return JSON.parse(raw);
-  } catch {
-    return {};
-  }
-}
-
-/** @param {string} s */
-function normalizeRole(s) {
-  return String(s || '')
-    .toLowerCase()
-    .replace(/\s+/g, '-')
-    .replace(/_/g, '-');
-}
-
-/**
- * @param {Record<string, unknown>} input
- * @returns {'pm' | null}
- */
-function detectRole(input) {
-  const candidates = [
-    input.agent_type,
-    input.agent_name,
-    input.subagent_name,
-    input.subagent_type,
-    input.subagent,
-    input.role,
-  ].filter(Boolean);
-
-  for (const c of candidates) {
-    const n = normalizeRole(String(c));
-    if (n === 'pm' || n.includes('project-manager')) return 'pm';
-  }
-
-  const blobs = [input.last_assistant_message, input.last_message, input.message, input.output]
-    .filter(Boolean)
-    .join('\n');
-  if (/---\s*PLAYCRAFT_STOP\s*---/i.test(blobs) && /role:\s*pm\b/i.test(blobs)) return 'pm';
-  return null;
-}
-
-/** @param {string} projectDir */
-function loadSkillAtomIds(projectDir) {
-  const dirs = [];
-  const envPaths = process.env.AGENT_SKILLS_PATHS?.split(',').map((p) => p.trim()).filter(Boolean) ?? [];
-  dirs.push(...envPaths);
-
-  const nm = path.join(projectDir, 'node_modules', '@playcraft', 'skills', 'skills');
-  if (fs.existsSync(nm)) dirs.push(nm);
-
-  const ids = new Set();
-  for (const dir of dirs) {
-    if (!fs.existsSync(dir) || !fs.statSync(dir).isDirectory()) continue;
-    for (const ent of fs.readdirSync(dir, { withFileTypes: true })) {
-      if (!ent.isDirectory()) continue;
-      const mp = path.join(dir, ent.name, 'manifest.json');
-      if (!fs.existsSync(mp)) continue;
-      try {
-        const m = JSON.parse(fs.readFileSync(mp, 'utf8'));
-        if (m.atomId) ids.add(m.atomId);
-      } catch {
-        // skip
-      }
-    }
-  }
-  return ids;
-}
-
-/**
- * @param {string} projectDir
- * @returns {{ errors: string[], warnings: string[] }}
- */
-function validateInline(projectDir) {
-  const jsonPath = path.join(projectDir, 'docs', 'atom-plan.json');
-  const errors = [];
-  const warnings = [];
-
-  if (!fs.existsSync(jsonPath)) {
-    errors.push('缺少 docs/atom-plan.json（从 templates/atom-plan.template.json 创建）');
-    return { errors, warnings };
-  }
-
-  let plan;
-  try {
-    plan = JSON.parse(fs.readFileSync(jsonPath, 'utf8'));
-  } catch (e) {
-    errors.push(`atom-plan.json 解析失败：${e.message}`);
-    return { errors, warnings };
-  }
-
-  if (plan.schemaVersion !== 1) {
-    errors.push(`schemaVersion 须为 1，当前：${plan.schemaVersion}`);
-  }
-  if (!Array.isArray(plan.atoms)) {
-    errors.push('atoms 须为数组');
-    return { errors, warnings };
-  }
-
-  const skillIndex = loadSkillAtomIds(projectDir);
-  if (skillIndex.size === 0) {
-    errors.push('未找到 skills 库（请 npm install @playcraft/skills 或设置 AGENT_SKILLS_PATHS）');
-    return { errors, warnings };
-  }
-
-  const snapshotIds = new Set((plan.skillsMatch?.items ?? []).map((i) => i.atomId).filter(Boolean));
-
-  for (const atom of plan.atoms) {
-    const ref = atom.skillRef == null ? '' : String(atom.skillRef).trim();
-    if (!ref || SKILL_REF_EMPTY.has(ref) || ref.startsWith('{{')) continue;
-
-    if (!SKILL_REF_SUFFIX_RE.test(ref)) {
-      errors.push(`${atom.atomId}: skillRef 须为 *.aigameplay 或 *.aiconfig：${ref}`);
-    } else if (ref.startsWith('playcraft-')) {
-      errors.push(`${atom.atomId}: 禁止 playcraft-* 平台 skill：${ref}`);
-    } else if (!skillIndex.has(ref)) {
-      errors.push(`${atom.atomId}: skillRef 不在 skills 库：${ref}`);
-    } else if (snapshotIds.size > 0 && !snapshotIds.has(ref)) {
-      errors.push(`${atom.atomId}: skillRef ${ref} 不在 skillsMatch.items 中`);
-    }
-
-    if (atom.type !== 'GameplayAtom' && atom.type !== 'ConfigAtom') {
-      errors.push(`${atom.atomId}: 仅 GameplayAtom/ConfigAtom 可有 skillRef`);
-    }
-  }
-
-  if (!(plan.skillsMatch?.items?.length > 0)) {
-    warnings.push('skillsMatch.items 为空 — 请先 playcraft skills match --json 并写入 skillsMatch');
-  }
-
-  return { errors, warnings };
-}
-
-/** @param {string} projectDir */
-function runCliValidator(projectDir) {
-  const r = spawnSync('playcraft', ['skills', 'validate-atom-plan', '--project-dir', projectDir], {
-    encoding: 'utf8',
-    cwd: projectDir,
-  });
-  return { status: r.status ?? 1, stdout: r.stdout ?? '', stderr: r.stderr ?? '' };
-}
-
-function emitBlock(reason) {
-  const payload = { decision: 'block', reason };
-  process.stdout.write(`${JSON.stringify(payload)}\n`);
-  process.stderr.write(`[playcraft-atom-plan] ${reason}\n`);
-  process.exit(2);
-}
-
-async function readStdin() {
-  const chunks = [];
-  for await (const chunk of process.stdin) {
-    chunks.push(chunk);
-  }
-  return Buffer.concat(chunks).toString('utf8');
-}
-
-export { detectRole, validateInline };
-
-async function main() {
-  const stdin = await readStdin();
-  const input = parseHookInput(stdin);
-  const role = detectRole(input);
-
-  if (role !== 'pm') {
-    process.exit(0);
-  }
-
-  const projectDir =
-    process.env.CLAUDE_PROJECT_DIR ||
-    process.env.CURSOR_PROJECT_DIR ||
-    process.cwd();
-
-  const statePath = path.join(projectDir, 'docs', 'project-state.md');
-  if (!fs.existsSync(statePath)) {
-    process.exit(0);
-  }
-
-  let cli = runCliValidator(projectDir);
-  if (cli.status !== 0 && /ENOENT|not found/i.test(cli.stderr)) {
-    const { errors, warnings } = validateInline(projectDir);
-    for (const w of warnings) process.stderr.write(`[playcraft-atom-plan] warn: ${w}\n`);
-    if (errors.length > 0) {
-      emitBlock(`PM STOP blocked — atom-plan skillRef 校验失败：\n- ${errors.join('\n- ')}`);
-    }
-    process.exit(0);
-  }
-
-  if (cli.status !== 0) {
-    const detail = (cli.stderr || cli.stdout).trim() || 'playcraft skills validate-atom-plan failed';
-    emitBlock(`PM STOP blocked — ${detail}`);
-  }
-
-  process.exit(0);
-}
-
-const isMain = process.argv[1] && path.resolve(process.argv[1]) === __filename;
-if (isMain) {
-  main().catch((err) => {
-    process.stderr.write(`[playcraft-atom-plan] ${err.message}\n`);
-    process.exit(1);
-  });
-}