@playcraft/cli 0.0.40 → 0.0.42

package/dist/commands/create.js

@@ -0,0 +1,337 @@
+import { execSync } from 'child_process';
+import inquirer from 'inquirer';
+import fs from 'fs/promises';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import pc from 'picocolors';
+import ora from 'ora';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/** 生成一个本地占位 Project ID（99xxxxxx），后续可通过 playcraft config set 更新为真实 ID */
+function generateMockProjectId() {
+    const suffix = Math.floor(Math.random() * 90_000_000) + 10_000_000;
+    return `99${suffix}`;
+}
+/** 将项目名转为合法的 npm package name */
+function toPackageName(name) {
+    return name
+        .toLowerCase()
+        .replace(/\s+/g, '-')
+        .replace(/[^a-z0-9\-]/g, '')
+        .replace(/^-+|-+$/g, '');
+}
+/** 初始化 git 仓库并创建初始提交（供 Claude Code 子 agent worktree 隔离使用） */
+async function initGitRepository(targetDir) {
+    const gitDir = path.join(targetDir, '.git');
+    try {
+        await fs.access(gitDir);
+        return;
+    }
+    catch {
+        // 尚未初始化，继续
+    }
+    const gitEnv = {
+        ...process.env,
+        GIT_AUTHOR_NAME: process.env.GIT_AUTHOR_NAME ?? 'PlayCraft',
+        GIT_AUTHOR_EMAIL: process.env.GIT_AUTHOR_EMAIL ?? 'playcraft@local',
+        GIT_COMMITTER_NAME: process.env.GIT_COMMITTER_NAME ?? 'PlayCraft',
+        GIT_COMMITTER_EMAIL: process.env.GIT_COMMITTER_EMAIL ?? 'playcraft@local',
+    };
+    execSync('git init -b main', { cwd: targetDir, stdio: 'pipe', env: gitEnv });
+    execSync('git add -A', { cwd: targetDir, stdio: 'pipe', env: gitEnv });
+    execSync('git commit -m "chore: initial commit from playcraft create"', {
+        cwd: targetDir,
+        stdio: 'pipe',
+        env: gitEnv,
+    });
+}
+/** 递归复制目录，跳过 .DS_Store */
+async function copyDir(src, dest) {
+    await fs.mkdir(dest, { recursive: true });
+    const entries = await fs.readdir(src, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.name === '.DS_Store')
+            continue;
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            await copyDir(srcPath, destPath);
+        }
+        else {
+            await fs.copyFile(srcPath, destPath);
+        }
+    }
+}
+/**
+ * 在新项目的 .claude/skills/ 下为每个 playcraft-* Platform Tool Skill 创建软连接。
+ *
+ * 软连接目标优先级：
+ *   1. 从 CLI 安装包的相对路径（monorepo dev 模式 / npm pack 后结构）
+ *   2. 相对于项目的 node_modules（运行时解析，npm install 后生效）
+ *
+ * 无论在 monorepo 开发还是全局安装场景，两种路径至少有一个能工作。
+ * 相对路径软连接（node_modules 指向）在 npm install 后自动激活。
+ */
+async function setupPlatformSkillLinks(targetDir, cliCommandsDir) {
+    const skillsLinkDir = path.join(targetDir, '.claude', 'skills');
+    await fs.mkdir(skillsLinkDir, { recursive: true });
+    // 以下 Skill 在项目模板中以静态目录形式存在，不创建软连接覆盖它们。
+    // 这些是仅供可玩广告工作流使用的 Agent 文档类 Skill，不在 @playcraft/skills 包中发布。
+    const staticSkills = new Set([
+        'playcraft-workflow', // 工作流入口（静态，无包版本）
+        'playcraft-research', // 研究协议（静态，无包版本）
+        'playcraft-ad-psychology', // 广告心理设计（静态，无包版本）
+        'playcraft-batch-pipeline', // 批处理管线（静态，无包版本）
+        'playcraft-build-optimizer', // 构建优化（静态，无包版本）
+        'playcraft-image-ops', // 图形操作（静态，无包版本）
+        'playcraft-masking', // 蒙版/抠图（静态，无包版本）
+        'playcraft-storyboard', // 故事板生成（静态，无包版本）
+        'playcraft-style-qa', // 风格质量验证（静态，无包版本）
+        'playcraft-vfx-animation', // VFX/动画预设（静态，无包版本）
+        // 以下两个在 @playcraft/skills 包中也有同名版本，模板静态版本优先
+        'playcraft-image-generation',
+        'playcraft-audio-generation',
+    ]);
+    // 尝试从 CLI 安装包的位置定位 @playcraft/skills/skills 目录
+    // 打包结构：packages/cli/dist/commands/ → 向上 4 层 → packages/skills/skills（monorepo）
+    //           dist/commands/ → 向上 3 层 → 与 CLI 包同级的 skills/skills（已不适用）
+    const candidateDirs = [
+        path.resolve(cliCommandsDir, '..', '..', '..', '..', 'skills', 'skills'),
+        path.resolve(cliCommandsDir, '..', '..', '..', 'skills', 'skills'),
+        path.resolve(cliCommandsDir, '..', '..', 'skills', 'skills'),
+    ];
+    let resolvedSkillsDir = null;
+    for (const dir of candidateDirs) {
+        try {
+            await fs.access(dir);
+            resolvedSkillsDir = dir;
+            break;
+        }
+        catch {
+            // 继续下一个候选
+        }
+    }
+    // 相对路径（指向 npm install 后的 node_modules）始终创建，作为安装后激活的备用
+    const relativeSkillsBase = path.join('..', '..', 'node_modules', '@playcraft', 'skills', 'skills');
+    if (resolvedSkillsDir) {
+        // 能立即解析 → 创建指向绝对路径的软连接，当下即可使用
+        const entries = await fs.readdir(resolvedSkillsDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.name.startsWith('playcraft-') || staticSkills.has(entry.name))
+                continue;
+            const linkPath = path.join(skillsLinkDir, entry.name);
+            const targetPath = path.join(resolvedSkillsDir, entry.name);
+            try {
+                await fs.symlink(targetPath, linkPath, 'dir');
+            }
+            catch {
+                // 已存在则跳过
+            }
+        }
+    }
+    else {
+        // 无法立即解析 → 创建指向 node_modules 的相对路径软连接，npm install 后自动激活
+        // 预置已知的 Platform Tool 名称列表，以便在未安装时也能提前创建软连接骨架
+        const knownPlatformTools = [
+            'playcraft-asset-management',
+            'playcraft-audio-generation',
+            'playcraft-build',
+            'playcraft-code-editor',
+            'playcraft-create-remix',
+            'playcraft-deploy',
+            'playcraft-image-generation',
+            'playcraft-image-processing',
+            'playcraft-platform-intro',
+            'playcraft-prefab',
+            'playcraft-project-management',
+            'playcraft-remix-workflow',
+            'playcraft-save',
+            'playcraft-skill-recommender',
+            'playcraft-sprite-generation',
+            'playcraft-sprite-remix',
+            'playcraft-sprite-sheet',
+            'playcraft-3d-flip-sprite',
+            'playcraft-prefab',
+        ];
+        for (const name of knownPlatformTools) {
+            if (staticSkills.has(name))
+                continue;
+            const linkPath = path.join(skillsLinkDir, name);
+            const linkTarget = path.join(relativeSkillsBase, name);
+            try {
+                await fs.symlink(linkTarget, linkPath, 'dir');
+            }
+            catch {
+                // 已存在则跳过
+            }
+        }
+    }
+}
+export async function createCommand(projectName, options) {
+    console.log(pc.cyan('\n🎮 PlayCraft 可玩广告项目创建\n'));
+    const baseDir = options.dir ? path.resolve(options.dir) : process.cwd();
+    const answers = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'projectName',
+            message: '项目目录名:',
+            default: projectName,
+            when: !projectName,
+            validate: (input) => {
+                if (!input.trim())
+                    return '项目名称不能为空';
+                if (/[/\\:*?"<>|]/.test(input))
+                    return '项目名称不能包含特殊字符';
+                return true;
+            },
+        },
+        {
+            type: 'input',
+            name: 'port',
+            message: '本地 Agent 端口:',
+            default: '2468',
+            validate: (input) => {
+                const port = parseInt(input, 10);
+                if (isNaN(port) || port < 1 || port > 65535) {
+                    return '端口号必须是 1-65535 之间的数字';
+                }
+                return true;
+            },
+        },
+        {
+            type: 'input',
+            name: 'skillsDir',
+            message: 'Skills 目录路径 (可选，供 playcraft skills 命令使用，直接回车跳过):',
+            default: '',
+            validate: async (input) => {
+                if (!input.trim())
+                    return true;
+                try {
+                    const stat = await fs.stat(path.resolve(input));
+                    if (!stat.isDirectory())
+                        return '路径不是一个目录';
+                    return true;
+                }
+                catch {
+                    return '目录不存在，请检查路径';
+                }
+            },
+        },
+        {
+            type: 'input',
+            name: 'token',
+            message: '认证令牌 (可选，可稍后通过 playcraft config set 更新):',
+            default: '',
+        },
+    ]);
+    const name = projectName || answers.projectName;
+    const port = parseInt(answers.port, 10);
+    const skillsDir = answers.skillsDir?.trim() || '';
+    const token = answers.token;
+    const projectId = generateMockProjectId();
+    const targetDir = path.join(baseDir, name);
+    // 检查目标目录是否已存在
+    try {
+        const stat = await fs.stat(targetDir);
+        if (stat.isDirectory()) {
+            const entries = await fs.readdir(targetDir);
+            if (entries.length > 0) {
+                const { overwrite } = await inquirer.prompt([
+                    {
+                        type: 'confirm',
+                        name: 'overwrite',
+                        message: pc.yellow(`目录 ${name} 已存在且非空，继续会覆盖同名文件，是否继续？`),
+                        default: false,
+                    },
+                ]);
+                if (!overwrite) {
+                    console.log(pc.yellow('已取消'));
+                    process.exit(0);
+                }
+            }
+        }
+    }
+    catch {
+        // 目录不存在，正常继续
+    }
+    const spinner = ora('复制项目模板...').start();
+    try {
+        // 定位 project-template 目录（打包后路径：dist/commands/ → ../../project-template）
+        const templateDir = path.resolve(__dirname, '..', '..', 'project-template');
+        try {
+            await fs.access(templateDir);
+        }
+        catch {
+            spinner.fail(`找不到项目模板目录: ${templateDir}`);
+            process.exit(1);
+        }
+        // 复制模板
+        await copyDir(templateDir, targetDir);
+        spinner.succeed('项目模板复制完成');
+        // 动态生成 package.json
+        const pkgSpinner = ora('生成 package.json...').start();
+        const packageJson = {
+            name: toPackageName(name),
+            version: '0.1.0',
+            description: 'PlayCraft Playable Ads project',
+            private: true,
+            scripts: {
+                start: 'playcraft start',
+                build: `playcraft build . -p facebook`,
+                'build:all': `playcraft build-all .`,
+            },
+            devDependencies: {
+                '@playcraft/cli': 'latest',
+                '@playcraft/skills': 'latest',
+            },
+        };
+        await fs.writeFile(path.join(targetDir, 'package.json'), JSON.stringify(packageJson, null, 2) + '\n', 'utf-8');
+        pkgSpinner.succeed('package.json 生成完成');
+        // 生成 playcraft.config.json
+        const configSpinner = ora('生成 playcraft.config.json...').start();
+        const config = {
+            agent: {
+                projectId,
+                dir: '.',
+                port,
+                ...(skillsDir && { skillsDir }),
+                ...(token && { token }),
+            },
+        };
+        await fs.writeFile(path.join(targetDir, 'playcraft.config.json'), JSON.stringify(config, null, 2) + '\n', 'utf-8');
+        configSpinner.succeed('playcraft.config.json 生成完成');
+        // 为 Platform Tool skills 创建 .claude/skills/ 软连接
+        await setupPlatformSkillLinks(targetDir, __dirname);
+        const gitSpinner = ora('初始化 Git 仓库...').start();
+        try {
+            await initGitRepository(targetDir);
+            gitSpinner.succeed('Git 仓库初始化完成');
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            gitSpinner.warn(`Git 初始化跳过: ${message}`);
+            console.log(pc.dim('  提示: 安装 git 后可在项目目录执行 git init && git add -A && git commit -m "initial"'));
+        }
+        // 完成提示
+        console.log(pc.green(`\n✅ 项目创建完成！\n`));
+        console.log(pc.bold('  目录:   ') + pc.cyan(targetDir));
+        console.log(pc.bold('  项目ID: ') + pc.cyan(projectId) + pc.dim('  （临时占位 ID，正式接入 PlayCraft 后请更新）'));
+        console.log(pc.bold('  端口:   ') + pc.cyan(String(port)));
+        if (skillsDir) {
+            console.log(pc.bold('  Skills: ') + pc.cyan(skillsDir));
+        }
+        console.log();
+        console.log(pc.dim('下一步：'));
+        console.log(`  ${pc.cyan(`cd ${name}`)}`);
+        console.log(`  ${pc.cyan('playcraft start')}`);
+        console.log();
+        console.log(pc.dim('正式接入 PlayCraft 后，替换项目 ID：'));
+        console.log(`  ${pc.cyan(`playcraft config set --key projectId --value <真实项目ID>`)}`);
+        console.log();
+    }
+    catch (error) {
+        spinner.fail('项目创建失败');
+        console.error(pc.red(`错误: ${error.message}`));
+        process.exit(1);
+    }
+}