@playcraft/cli 0.0.43 → 0.0.46

package/dist/atom-plan/validate-atom-plan.js

@@ -1,298 +0,0 @@
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { loadConfig } from '../config.js';
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const SKILL_REF_EMPTY = new Set(['', '—', '-', '–', 'null', 'none', 'n/a']);
-const PROTECTED_SKILL_PREFIX = 'playcraft-';
-const SKILL_REF_SUFFIX_RE = /\.(aigameplay|aiconfig)$/;
-function normalizeSkillRef(ref) {
-    if (ref === null || ref === undefined)
-        return null;
-    const s = String(ref).trim();
-    if (SKILL_REF_EMPTY.has(s) || s.startsWith('{{'))
-        return null;
-    return s;
-}
-/** 与 skills match 命令相同的 skills 目录发现逻辑（精简版） */
-export function resolveSkillsDirs(customDir, configDir) {
-    if (customDir)
-        return [path.resolve(customDir)];
-    const dirs = [];
-    if (configDir)
-        dirs.push(path.resolve(configDir));
-    const envPaths = process.env.AGENT_SKILLS_PATHS?.split(',').map((p) => p.trim()).filter(Boolean) ?? [];
-    dirs.push(...envPaths);
-    const cwdModulesPath = path.join(process.cwd(), 'node_modules', '@playcraft', 'skills', 'skills');
-    if (fs.existsSync(cwdModulesPath))
-        dirs.push(cwdModulesPath);
-    const monoSkillsPath = path.resolve(__dirname, '..', '..', '..', '..', 'skills', 'skills');
-    if (fs.existsSync(monoSkillsPath))
-        dirs.push(monoSkillsPath);
-    return [...new Set(dirs)];
-}
-/** 从项目根解析 skills 目录（与 playcraft skills 命令同源） */
-export async function resolveProjectSkillsDirs(projectDir, skillsDirOverride) {
-    const root = path.resolve(projectDir);
-    const config = await loadConfig({ dir: root }).catch(() => ({ skillsDir: undefined }));
-    return resolveSkillsDirs(skillsDirOverride, config.skillsDir);
-}
-export function loadSkillAtomIdSet(skillsDirs) {
-    const ids = new Set();
-    for (const dir of skillsDirs) {
-        if (!fs.existsSync(dir) || !fs.statSync(dir).isDirectory())
-            continue;
-        for (const name of fs.readdirSync(dir, { withFileTypes: true })) {
-            if (!name.isDirectory())
-                continue;
-            const manifestPath = path.join(dir, name.name, 'manifest.json');
-            if (!fs.existsSync(manifestPath))
-                continue;
-            try {
-                const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf-8'));
-                if (manifest.atomId)
-                    ids.add(manifest.atomId);
-            }
-            catch {
-                // skip invalid manifest
-            }
-        }
-    }
-    return ids;
-}
-function snapshotItemAtomIds(plan) {
-    const ids = new Set();
-    for (const item of plan.skillsMatch?.items ?? []) {
-        if (item.atomId)
-            ids.add(item.atomId);
-    }
-    return ids;
-}
-export function parseAtomPlanJson(content) {
-    const parsed = JSON.parse(content);
-    if (!parsed || typeof parsed !== 'object') {
-        throw new Error('atom-plan JSON 必须是对象');
-    }
-    if (!Array.isArray(parsed.atoms)) {
-        throw new Error('atom-plan JSON 缺少 atoms 数组');
-    }
-    return parsed;
-}
-/** 从 atom-plan.md Atom List 表解析 skillRef（兼容旧项目） */
-export function parseSkillRefsFromAtomPlanMarkdown(content) {
-    const lines = content.split('\n');
-    let inAtomList = false;
-    let skillRefIdx = -1;
-    const refs = new Set();
-    for (const line of lines) {
-        if (/^##\s+Atom List\b/i.test(line)) {
-            inAtomList = true;
-            skillRefIdx = -1;
-            continue;
-        }
-        if (inAtomList && /^##\s+/.test(line))
-            break;
-        if (!inAtomList || !line.trim().startsWith('|'))
-            continue;
-        const cols = line
-            .split('|')
-            .slice(1, -1)
-            .map((c) => c.trim());
-        if (cols.length === 0)
-            continue;
-        if (skillRefIdx < 0) {
-            if (cols.includes('skillRef'))
-                skillRefIdx = cols.indexOf('skillRef');
-            continue;
-        }
-        if (cols.every((c) => /^:?-+:?$/.test(c) || c === ''))
-            continue;
-        if (cols.includes('atomId') && cols.includes('assignTo'))
-            continue;
-        const ref = normalizeSkillRef(cols[skillRefIdx]);
-        if (ref)
-            refs.add(ref);
-    }
-    return [...refs];
-}
-function extractSnapshotAtomIdsFromMarkdown(content) {
-    const ids = new Set();
-    const jsonBlock = content.match(/```json\s*([\s\S]*?)```/);
-    if (!jsonBlock)
-        return ids;
-    try {
-        const snap = JSON.parse(jsonBlock[1]);
-        for (const item of snap?.items ?? []) {
-            if (item.atomId)
-                ids.add(item.atomId);
-        }
-    }
-    catch {
-        // ignore parse errors — validated separately
-    }
-    return ids;
-}
-export function validateSkillRefs(options) {
-    const errors = [];
-    const warnings = [];
-    const { skillRefs, skillIndex, snapshotItemIds, atomBySkillRef } = options;
-    for (const ref of skillRefs) {
-        if (!SKILL_REF_SUFFIX_RE.test(ref)) {
-            errors.push(`skillRef 格式非法（须为 *.aigameplay 或 *.aiconfig）：${ref}`);
-            continue;
-        }
-        if (ref.startsWith(PROTECTED_SKILL_PREFIX)) {
-            errors.push(`skillRef 不得使用平台 skill（playcraft-*）：${ref}`);
-            continue;
-        }
-        if (!skillIndex.has(ref)) {
-            errors.push(`skillRef 不在 skills 库中：${ref}（运行 playcraft skills list --json 核对）`);
-            continue;
-        }
-        if (snapshotItemIds && snapshotItemIds.size > 0 && !snapshotItemIds.has(ref)) {
-            const owner = atomBySkillRef?.get(ref);
-            const who = owner ? `（production atomId: ${owner.atomId}）` : '';
-            errors.push(`skillRef 未出现在 skillsMatch.items 中：${ref}${who}`);
-        }
-    }
-    if (skillRefs.length === 0) {
-        warnings.push('未找到任何非空 skillRef');
-    }
-    return { errors, warnings };
-}
-/** 从项目 docs/ 读取 atom-plan（JSON 优先，否则 Markdown）中的 skillRef */
-export function parseSkillRefsFromAtomPlanProject(projectDir) {
-    const root = path.resolve(projectDir);
-    const jsonPath = path.join(root, 'docs', 'atom-plan.json');
-    if (fs.existsSync(jsonPath)) {
-        const plan = parseAtomPlanJson(fs.readFileSync(jsonPath, 'utf-8'));
-        const refs = [];
-        for (const atom of plan.atoms) {
-            const ref = normalizeSkillRef(atom.skillRef);
-            if (ref)
-                refs.push(ref);
-        }
-        return refs;
-    }
-    const mdPath = path.join(root, 'docs', 'atom-plan.md');
-    if (fs.existsSync(mdPath)) {
-        return parseSkillRefsFromAtomPlanMarkdown(fs.readFileSync(mdPath, 'utf-8'));
-    }
-    return [];
-}
-export async function validateAtomPlanProject(options) {
-    const projectDir = path.resolve(options.projectDir);
-    const jsonPath = path.join(projectDir, 'docs', 'atom-plan.json');
-    const mdPath = path.join(projectDir, 'docs', 'atom-plan.md');
-    const dirs = await resolveProjectSkillsDirs(projectDir, options.skillsDir);
-    const skillIndex = loadSkillAtomIdSet(dirs);
-    if (dirs.length === 0) {
-        return {
-            ok: false,
-            errors: ['未找到 skills 目录。请安装 @playcraft/skills 或设置 AGENT_SKILLS_PATHS / playcraft.config.json skillsDir'],
-            warnings: [],
-            skillRefsChecked: [],
-            source: 'json',
-        };
-    }
-    if (fs.existsSync(jsonPath)) {
-        let plan;
-        try {
-            plan = parseAtomPlanJson(fs.readFileSync(jsonPath, 'utf-8'));
-        }
-        catch (e) {
-            return {
-                ok: false,
-                errors: [`docs/atom-plan.json 解析失败：${e.message}`],
-                warnings: [],
-                skillRefsChecked: [],
-                source: 'json',
-            };
-        }
-        if (plan.schemaVersion !== 1) {
-            return {
-                ok: false,
-                errors: [`docs/atom-plan.json schemaVersion 须为 1，当前：${plan.schemaVersion}`],
-                warnings: [],
-                skillRefsChecked: [],
-                source: 'json',
-            };
-        }
-        const skillRefs = [];
-        const atomBySkillRef = new Map();
-        for (const atom of plan.atoms) {
-            const ref = normalizeSkillRef(atom.skillRef);
-            if (!ref)
-                continue;
-            skillRefs.push(ref);
-            atomBySkillRef.set(ref, atom);
-            if (atom.type !== 'GameplayAtom' && atom.type !== 'ConfigAtom' && ref) {
-                return {
-                    ok: false,
-                    errors: [`${atom.atomId}：仅 GameplayAtom/ConfigAtom 允许 skillRef，当前 type=${atom.type}`],
-                    warnings: [],
-                    skillRefsChecked: skillRefs,
-                    source: 'json',
-                };
-            }
-        }
-        const snapshotIds = snapshotItemAtomIds(plan);
-        const { errors, warnings } = validateSkillRefs({
-            skillRefs,
-            skillIndex,
-            snapshotItemIds: snapshotIds,
-            atomBySkillRef,
-        });
-        if (!plan.skillsMatch?.items?.length) {
-            warnings.push('skillsMatch.items 为空 — Gate #1 应先运行 playcraft skills match --json 并写入 skillsMatch');
-        }
-        const configuredRoot = dirs[0];
-        if (plan.packageSkillsRoot?.trim()) {
-            const declared = path.resolve(projectDir, plan.packageSkillsRoot.trim());
-            if (configuredRoot && path.resolve(configuredRoot) !== declared) {
-                warnings.push(`packageSkillsRoot 与 playcraft.config.json 解析结果不一致；请删除 atom-plan 中的 packageSkillsRoot，或改为 skillsDir：${configuredRoot}`);
-            }
-        }
-        return {
-            ok: errors.length === 0,
-            errors,
-            warnings,
-            skillRefsChecked: skillRefs,
-            source: 'json',
-        };
-    }
-    if (options.preferJson !== false) {
-        return {
-            ok: false,
-            errors: ['缺少 docs/atom-plan.json（Gate #1 请使用 templates/atom-plan.template.json）'],
-            warnings: fs.existsSync(mdPath) ? ['检测到 docs/atom-plan.md，请迁移为 JSON 主格式'] : [],
-            skillRefsChecked: [],
-            source: 'json',
-        };
-    }
-    if (!fs.existsSync(mdPath)) {
-        return {
-            ok: false,
-            errors: ['缺少 docs/atom-plan.json 与 docs/atom-plan.md'],
-            warnings: [],
-            skillRefsChecked: [],
-            source: 'markdown',
-        };
-    }
-    const md = fs.readFileSync(mdPath, 'utf-8');
-    const skillRefs = parseSkillRefsFromAtomPlanMarkdown(md);
-    const snapshotIds = extractSnapshotAtomIdsFromMarkdown(md);
-    const { errors, warnings } = validateSkillRefs({
-        skillRefs,
-        skillIndex,
-        snapshotItemIds: snapshotIds,
-    });
-    warnings.push('使用 Markdown atom-plan（已弃用为主格式，请改用 docs/atom-plan.json）');
-    return {
-        ok: errors.length === 0,
-        errors,
-        warnings,
-        skillRefsChecked: skillRefs,
-        source: 'markdown',
-    };
-}

package/dist/playable/base-builder.js

@@ -1,265 +0,0 @@
-import fs from 'fs/promises';
-import path from 'path';
-import { fileURLToPath } from 'url';
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-/**
- * 基础构建器 - 生成可运行的多文件构建产物
- *
- * 职责：
- * 1. 从源代码或构建产物加载项目
- * 2. 确保所有必需文件存在且格式正确
- * 3. 输出可直接运行的多文件版本
- * 4. 不做任何内联或压缩
- */
-export class BaseBuilder {
-    projectDir;
-    options;
-    constructor(projectDir, options) {
-        this.projectDir = projectDir;
-        this.options = options;
-    }
-    /**
-     * 执行基础构建
-     */
-    async build() {
-        // 1. 检测项目类型
-        const projectType = await this.detectProjectType();
-        if (projectType === 'official-build') {
-            // 官方构建产物 - 直接复制并验证
-            return await this.buildFromOfficial();
-        }
-        else {
-            // 源代码 - 需要编译
-            throw new Error('源代码构建暂未实现，请使用官方构建产物。\n' +
-                '💡 推荐：先使用 PlayCanvas REST API 下载构建版本，然后再打包为 Playable Ad。');
-        }
-    }
-    /**
-     * 检测项目类型
-     */
-    async detectProjectType() {
-        // 检查是否是官方构建产物
-        const buildIndicators = [
-            path.join(this.projectDir, 'index.html'),
-            path.join(this.projectDir, 'config.json'),
-        ];
-        try {
-            await fs.access(buildIndicators[0]);
-            await fs.access(buildIndicators[1]);
-            return 'official-build';
-        }
-        catch (error) {
-            return 'source';
-        }
-    }
-    /**
-     * 从官方构建产物构建
-     */
-    async buildFromOfficial() {
-        // 验证必需文件存在
-        await this.validateOfficialBuild();
-        // 创建输出目录
-        await fs.mkdir(this.options.outputDir, { recursive: true });
-        // 复制所有文件到输出目录
-        const files = await this.copyBuildFiles();
-        return {
-            outputDir: this.options.outputDir,
-            files,
-        };
-    }
-    /**
-     * 验证官方构建产物
-     */
-    async validateOfficialBuild() {
-        const requiredFiles = [
-            'index.html',
-            'config.json',
-            '__start__.js',
-        ];
-        const missingFiles = [];
-        for (const file of requiredFiles) {
-            try {
-                await fs.access(path.join(this.projectDir, file));
-            }
-            catch (error) {
-                missingFiles.push(file);
-            }
-        }
-        if (missingFiles.length > 0) {
-            throw new Error(`官方构建产物缺少必需文件: ${missingFiles.join(', ')}\n` +
-                `请确保项目目录包含完整的构建产物。`);
-        }
-    }
-    /**
-     * 复制构建文件到输出目录
-     */
-    async copyBuildFiles() {
-        const files = {
-            html: '',
-            engine: null,
-            config: '',
-            settings: null,
-            modules: null,
-            start: '',
-            scenes: [],
-            assets: [],
-        };
-        // 复制 index.html
-        const htmlPath = path.join(this.projectDir, 'index.html');
-        const outputHtmlPath = path.join(this.options.outputDir, 'index.html');
-        await fs.copyFile(htmlPath, outputHtmlPath);
-        files.html = outputHtmlPath;
-        // 复制 config.json
-        const configPath = path.join(this.projectDir, 'config.json');
-        const outputConfigPath = path.join(this.options.outputDir, 'config.json');
-        await fs.copyFile(configPath, outputConfigPath);
-        files.config = outputConfigPath;
-        // 读取 config.json 以获取场景信息
-        const configContent = await fs.readFile(configPath, 'utf-8');
-        const configJson = JSON.parse(configContent);
-        // 复制 __start__.js
-        const startPath = path.join(this.projectDir, '__start__.js');
-        const outputStartPath = path.join(this.options.outputDir, '__start__.js');
-        await fs.copyFile(startPath, outputStartPath);
-        files.start = outputStartPath;
-        // 复制 __settings__.js（如果存在）
-        const settingsPath = path.join(this.projectDir, '__settings__.js');
-        try {
-            await fs.access(settingsPath);
-            const outputSettingsPath = path.join(this.options.outputDir, '__settings__.js');
-            await fs.copyFile(settingsPath, outputSettingsPath);
-            files.settings = outputSettingsPath;
-        }
-        catch (error) {
-            // __settings__.js 不是必需的
-        }
-        // 复制 __modules__.js（如果存在）
-        const modulesPath = path.join(this.projectDir, '__modules__.js');
-        try {
-            await fs.access(modulesPath);
-            const outputModulesPath = path.join(this.options.outputDir, '__modules__.js');
-            await fs.copyFile(modulesPath, outputModulesPath);
-            files.modules = outputModulesPath;
-        }
-        catch (error) {
-            // __modules__.js 不是必需的
-        }
-        // 复制 PlayCanvas Engine（查找可能的文件名）
-        const engineNames = [
-            'playcanvas-stable.min.js',
-            'playcanvas.min.js',
-            '__lib__.js',
-        ];
-        for (const engineName of engineNames) {
-            const enginePath = path.join(this.projectDir, engineName);
-            try {
-                await fs.access(enginePath);
-                const outputEnginePath = path.join(this.options.outputDir, engineName);
-                await fs.copyFile(enginePath, outputEnginePath);
-                files.engine = outputEnginePath;
-                break;
-            }
-            catch (error) {
-                // 继续尝试下一个
-            }
-        }
-        // 复制场景文件
-        if (configJson.scenes && Array.isArray(configJson.scenes)) {
-            for (const scene of configJson.scenes) {
-                if (scene.url && !scene.url.startsWith('data:')) {
-                    const scenePath = path.join(this.projectDir, scene.url);
-                    try {
-                        await fs.access(scenePath);
-                        const sceneDir = path.dirname(scene.url);
-                        if (sceneDir && sceneDir !== '.') {
-                            const outputSceneDir = path.join(this.options.outputDir, sceneDir);
-                            await fs.mkdir(outputSceneDir, { recursive: true });
-                        }
-                        const outputScenePath = path.join(this.options.outputDir, scene.url);
-                        await fs.copyFile(scenePath, outputScenePath);
-                        files.scenes.push(outputScenePath);
-                    }
-                    catch (error) {
-                        console.warn(`警告: 场景文件不存在: ${scene.url}`);
-                    }
-                }
-            }
-        }
-        // 复制资产文件（从 config.json 中的 assets）
-        if (configJson.assets) {
-            const assetsDir = path.join(this.options.outputDir, 'files');
-            await fs.mkdir(assetsDir, { recursive: true });
-            for (const [assetId, assetData] of Object.entries(configJson.assets)) {
-                const asset = assetData;
-                if (asset.file && asset.file.url && !asset.file.url.startsWith('data:')) {
-                    const assetPath = path.join(this.projectDir, asset.file.url);
-                    try {
-                        await fs.access(assetPath);
-                        const assetDir = path.dirname(asset.file.url);
-                        if (assetDir && assetDir !== '.') {
-                            const outputAssetDir = path.join(this.options.outputDir, assetDir);
-                            await fs.mkdir(outputAssetDir, { recursive: true });
-                        }
-                        const outputAssetPath = path.join(this.options.outputDir, asset.file.url);
-                        await fs.copyFile(assetPath, outputAssetPath);
-                        files.assets.push(outputAssetPath);
-                    }
-                    catch (error) {
-                        // 资产文件可能不存在（可能是内联的）
-                    }
-                }
-            }
-        }
-        // 复制 files/ 目录（如果存在）
-        const filesDir = path.join(this.projectDir, 'files');
-        try {
-            const filesDirStat = await fs.stat(filesDir);
-            if (filesDirStat.isDirectory()) {
-                const outputFilesDir = path.join(this.options.outputDir, 'files');
-                await this.copyDirectory(filesDir, outputFilesDir);
-            }
-        }
-        catch (error) {
-            // files/ 目录可能不存在
-        }
-        // 复制 styles.css（如果存在）
-        const stylesPath = path.join(this.projectDir, 'styles.css');
-        try {
-            await fs.access(stylesPath);
-            const outputStylesPath = path.join(this.options.outputDir, 'styles.css');
-            await fs.copyFile(stylesPath, outputStylesPath);
-        }
-        catch (error) {
-            // styles.css 可能不存在
-        }
-        // 复制 manifest.json（如果存在）
-        const manifestPath = path.join(this.projectDir, 'manifest.json');
-        try {
-            await fs.access(manifestPath);
-            const outputManifestPath = path.join(this.options.outputDir, 'manifest.json');
-            await fs.copyFile(manifestPath, outputManifestPath);
-        }
-        catch (error) {
-            // manifest.json 可能不存在
-        }
-        return files;
-    }
-    /**
-     * 递归复制目录
-     */
-    async copyDirectory(src, dest) {
-        await fs.mkdir(dest, { recursive: true });
-        const entries = await fs.readdir(src, { withFileTypes: true });
-        for (const entry of entries) {
-            const srcPath = path.join(src, entry.name);
-            const destPath = path.join(dest, entry.name);
-            if (entry.isDirectory()) {
-                await this.copyDirectory(srcPath, destPath);
-            }
-            else {
-                await fs.copyFile(srcPath, destPath);
-            }
-        }
-    }
-}