@remixmate/cli 0.9.72 → 0.9.74

package/dist/template/project.js

@@ -1,161 +1,6 @@
-/**
- * Starter-project discovery, template identity (K4) and the shared output helper.
- */
-import { randomBytes } from 'node:crypto';
-import { existsSync, readFileSync, writeFileSync } from 'node:fs';
-import path from 'node:path';
-import { EXIT, SkillError } from '../errors.js';
-import { CHECK_ENTRY, IDENTITY_FILE, RULES_VERSION_FILE, STARTER_PACKAGE, STARTER_VERSION } from './constants.js';
-import { usageError } from './args.js';
-// ── project root ─────────────────────────────────────────────────────────────
-/** Walk up from `start` to the directory holding `.remixmate/check/index.mjs`. */
-export function findProjectRoot(start = process.cwd()) {
-    let dir = path.resolve(start);
-    for (;;) {
-        if (existsSync(path.join(dir, CHECK_ENTRY)))
-            return dir;
-        const parent = path.dirname(dir);
-        if (parent === dir)
-            return null;
-        dir = parent;
-    }
-}
-export function requireProjectRoot(start) {
-    const root = findProjectRoot(start);
-    if (!root) {
-        throw new SkillError(`❌ 当前目录不在模板工程内（找不到 ${CHECK_ENTRY}）。\n` +
-            '   先运行 remixmate template init <dir>，再进入该目录执行。', EXIT.USAGE);
-    }
-    return root;
-}
-/** A template name is a single directory under templates/ — never a path. */
-export function validateTemplateName(name) {
-    if (!name)
-        throw usageError('缺少模板名：remixmate template <command> <name>');
-    if (name === '.' || name === '..' || /[\\/]/.test(name) || name.startsWith('-')) {
-        throw usageError(`模板名不合法: ${name}（应为 templates/ 下的目录名）`);
-    }
-    return name;
-}
-export function requireTemplateDir(root, name) {
-    const dir = path.join(root, 'templates', name);
-    if (!existsSync(path.join(dir, 'template.json'))) {
-        throw new SkillError(`❌ 找不到 templates/${name}/template.json`, EXIT.USAGE);
-    }
-    return dir;
-}
-export function readJsonFile(file) {
-    try {
-        return JSON.parse(readFileSync(file, 'utf8'));
-    }
-    catch (err) {
-        throw new SkillError(`❌ ${path.basename(file)} 解析失败: ${err.message}`);
-    }
-}
-/** kebab-case slug of a directory name; falls back to `template` when nothing survives. */
-export function kebabSlug(input) {
-    const slug = input
-        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, '-')
-        .replace(/^-+|-+$/g, '');
-    return slug || 'template';
-}
-/** First-publish key: `my-<slug>-<6 hex>`. */
-export function generateTemplateKey(dirName, hex = randomBytes(3).toString('hex')) {
-    return `my-${kebabSlug(dirName)}-${hex}`;
-}
-export function readIdentity(templateDir) {
-    const file = path.join(templateDir, IDENTITY_FILE);
-    if (!existsSync(file))
-        return null;
-    const raw = readJsonFile(file);
-    if (typeof raw.templateKey !== 'string' || !raw.templateKey) {
-        throw new SkillError(`❌ ${IDENTITY_FILE} 缺少 templateKey，请修复或删除该文件后重试`);
-    }
-    return { templateKey: raw.templateKey, version: typeof raw.version === 'number' ? raw.version : 0 };
-}
-/** Stable key: the identity file wins, so renaming the directory never forks a template. */
-export function resolveTemplateKey(templateDir) {
-    const id = readIdentity(templateDir);
-    if (id)
-        return { templateKey: id.templateKey, existing: true };
-    return { templateKey: generateTemplateKey(path.basename(templateDir)), existing: false };
-}
-export function writeIdentity(templateDir, identity) {
-    writeFileSync(path.join(templateDir, IDENTITY_FILE), JSON.stringify(identity, null, 2) + '\n', 'utf8');
-}
-// ── rules version (template upgrade) ─────────────────────────────────────────
-/** Numeric dotted compare (prerelease tags ignored): <0 / 0 / >0. */
-export function compareVersions(a, b) {
-    const parse = (v) => v.replace(/^v/, '').split(/[-+]/)[0].split('.').map((n) => Number(n) || 0);
-    const pa = parse(a);
-    const pb = parse(b);
-    for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
-        const d = (pa[i] ?? 0) - (pb[i] ?? 0);
-        if (d !== 0)
-            return d;
-    }
-    return 0;
-}
-/**
- * The starter version whose rules this project's `.remixmate/` holds.
- * `.remixmate/version.json` wins; 0.1.0 projects fall back to package.json
- * (copied verbatim from the starter at init). null = unknown.
- */
-export function readRulesVersion(root) {
-    const marker = path.join(root, RULES_VERSION_FILE);
-    if (existsSync(marker)) {
-        try {
-            const v = JSON.parse(readFileSync(marker, 'utf8')).starterVersion;
-            if (typeof v === 'string' && v)
-                return v;
-        }
-        catch {
-            /* fall through */
-        }
-    }
-    const pkgFile = path.join(root, 'package.json');
-    if (existsSync(pkgFile)) {
-        try {
-            const pkg = JSON.parse(readFileSync(pkgFile, 'utf8'));
-            if (pkg.name === STARTER_PACKAGE && typeof pkg.version === 'string')
-                return pkg.version;
-        }
-        catch {
-            /* unknown */
-        }
-    }
-    return null;
-}
-/** Hint line when the project's rules are older than what this cli ships with, else null. */
-export function staleRulesHint(root) {
-    const have = readRulesVersion(root);
-    if (have && compareVersions(have, STARTER_VERSION) >= 0)
-        return null;
-    return (`⚠ 本地校验规则来自 starter ${have ?? '(未知版本)'}，当前 cli 对应 ${STARTER_VERSION}。` +
-        '平台规则可能已更新，本地通过不代表发布能过。运行 remixmate template upgrade 更新规则（不会改动 templates/）。');
-}
-// ── output ───────────────────────────────────────────────────────────────────
-/**
- * Human text goes to stdout by default. With --json it moves to stderr so the
- * last stdout line is the JSON result (progress lines still go to stdout —
- * hosts parse them by their `__progress__` marker).
- */
-export class Output {
-    json;
-    constructor(json) {
-        this.json = json;
-    }
-    info(line = '') {
-        ;
-        (this.json ? process.stderr : process.stdout).write(line + '\n');
-    }
-    warn(line) {
-        process.stderr.write(line + '\n');
-    }
-    result(obj) {
-        if (this.json)
-            process.stdout.write(JSON.stringify(obj) + '\n');
-    }
-}
+var x=Object.defineProperty;var n=(e,t)=>x(e,"name",{value:t,configurable:!0});import{randomBytes as h}from"node:crypto";import{existsSync as a,readFileSync as u,writeFileSync as w}from"node:fs";import o from"node:path";import{EXIT as m,SkillError as l}from"../errors.js";import{CHECK_ENTRY as y,IDENTITY_FILE as c,RULES_VERSION_FILE as S,STARTER_PACKAGE as j,STARTER_VERSION as g}from"./constants.js";import{usageError as d}from"./args.js";function E(e=process.cwd()){let t=o.resolve(e);for(;;){if(a(o.join(t,y)))return t;const r=o.dirname(t);if(r===t)return null;t=r}}n(E,"findProjectRoot");function _(e){const t=E(e);if(!t)throw new l(`❌ 当前目录不在模板工程内（找不到 ${y}）。
+   先运行 remixmate template init <dir>，再进入该目录执行。`,m.USAGE);return t}n(_,"requireProjectRoot");function V(e){if(!e)throw d("缺少模板名：remixmate template <command> <name>");if(e==="."||e===".."||/[\\/]/.test(e)||e.startsWith("-"))throw d(`模板名不合法: ${e}（应为 templates/ 下的目录名）`);return e}n(V,"validateTemplateName");function C(e,t){const r=o.join(e,"templates",t);if(!a(o.join(r,"template.json")))throw new l(`❌ 找不到 templates/${t}/template.json`,m.USAGE);return r}n(C,"requireTemplateDir");function $(e){try{return JSON.parse(u(e,"utf8"))}catch(t){throw new l(`❌ ${o.basename(e)} 解析失败: ${t.message}`)}}n($,"readJsonFile");function K(e){return e.replace(/([a-z0-9])([A-Z])/g,"$1-$2").toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-+|-+$/g,"")||"template"}n(K,"kebabSlug");function R(e,t=h(3).toString("hex")){return`my-${K(e)}-${t}`}n(R,"generateTemplateKey");function T(e){const t=o.join(e,c);if(!a(t))return null;const r=$(t);if(typeof r.templateKey!="string"||!r.templateKey)throw new l(`❌ ${c} 缺少 templateKey，请修复或删除该文件后重试`);return{templateKey:r.templateKey,version:typeof r.version=="number"?r.version:0}}n(T,"readIdentity");function L(e){const t=T(e);return t?{templateKey:t.templateKey,existing:!0}:{templateKey:R(o.basename(e)),existing:!1}}n(L,"resolveTemplateKey");function G(e,t){w(o.join(e,c),JSON.stringify(t,null,2)+`
+`,"utf8")}n(G,"writeIdentity");function v(e,t){const r=n(s=>s.replace(/^v/,"").split(/[-+]/)[0].split(".").map(p=>Number(p)||0),"parse"),i=r(e),f=r(t);for(let s=0;s<Math.max(i.length,f.length);s++){const p=(i[s]??0)-(f[s]??0);if(p!==0)return p}return 0}n(v,"compareVersions");function N(e){const t=o.join(e,S);if(a(t))try{const i=JSON.parse(u(t,"utf8")).starterVersion;if(typeof i=="string"&&i)return i}catch{}const r=o.join(e,"package.json");if(a(r))try{const i=JSON.parse(u(r,"utf8"));if(i.name===j&&typeof i.version=="string")return i.version}catch{}return null}n(N,"readRulesVersion");function P(e){const t=N(e);return t&&v(t,g)>=0?null:`⚠ 本地校验规则来自 starter ${t??"(未知版本)"}，当前 cli 对应 ${g}。平台规则可能已更新，本地通过不代表发布能过。运行 remixmate template upgrade 更新规则（不会改动 templates/）。`}n(P,"staleRulesHint");class U{static{n(this,"Output")}json;constructor(t){this.json=t}info(t=""){(this.json?process.stderr:process.stdout).write(t+`
+`)}warn(t){process.stderr.write(t+`
+`)}result(t){this.json&&process.stdout.write(JSON.stringify(t)+`
+`)}}export{U as Output,v as compareVersions,E as findProjectRoot,R as generateTemplateKey,K as kebabSlug,T as readIdentity,$ as readJsonFile,N as readRulesVersion,_ as requireProjectRoot,C as requireTemplateDir,L as resolveTemplateKey,P as staleRulesHint,V as validateTemplateName,G as writeIdentity};

package/dist/template/publish.js

@@ -1,185 +1,5 @@
-/**
- * `remixmate template publish <name> [--name <displayName>] [--dry-run]`
- *
- * Ported from template-library `scripts/publish-private.mjs` — same ab-api
- * contract (prepareSave → presignUpload → PUT → save, isBuiltin=false), same
- * tar excludes. Differences, all from the spec:
- *   - the key is stable per template directory (K4 `.remixmate.json`), so a
- *     re-publish updates instead of forking, and renaming the dir is harmless;
- *   - the starter's own `check` runs first (requirement 6.2);
- *   - the project files stay read-only except for `.remixmate.json` — server
- *     normalization only touches a staging copy.
- *
- * Never printed: the token and the presigned upload URL.
- */
-import { cpSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { EXIT, SkillError } from '../errors.js';
-import { mmPost, resolveHttpContext } from '../http.js';
-import { emitProgress } from '../progress.js';
-import { IDENTITY_FILE, TAR_EXCLUDES } from './constants.js';
-import { runCheck } from './check.js';
-import { Output, readJsonFile, requireProjectRoot, requireTemplateDir, resolveTemplateKey, validateTemplateName, writeIdentity, } from './project.js';
-import { runProcess } from './proc.js';
-import { fetchCoreSurface, resolveRenderBaseUrl } from './render-client.js';
-/** tar argv with the shared exclude list — exported for tests. */
-export function tarArgs(srcDir, outFile) {
-    const args = ['-czf', outFile];
-    for (const ex of TAR_EXCLUDES)
-        args.push(`--exclude=${ex}`);
-    args.push('-C', srcDir, '.');
-    return args;
-}
-/**
- * Core preflight: the template's declared coreExports must all exist on the
- * target ab-render (the tar never carries core). Returns a block reason or null.
- * "Couldn't check" is a block, not a pass.
- */
-export function evaluateCoreSurface(manifest, surface, warn = () => { }) {
-    if (!surface)
-        return 'ab-render /health 未返回 coreSurface —— 该实例版本过旧，无法校验 core 契约';
-    if (!surface.available)
-        return `ab-render 无法读取 template-core：${surface.error ?? '未知原因'}`;
-    if (!Array.isArray(manifest.coreExports)) {
-        return 'template.json 缺少 coreExports —— 先运行 remixmate template check 生成';
-    }
-    const have = new Set(surface.exports ?? []);
-    const missing = manifest.coreExports.filter((n) => !have.has(n));
-    const declared = typeof manifest.coreVersion === 'string' ? manifest.coreVersion : null;
-    // `versions` is a K5 addition; older instances only expose packageVersion.
-    const offered = Array.isArray(surface.versions) && surface.versions.length > 0
-        ? surface.versions
-        : surface.packageVersion ? [surface.packageVersion] : [];
-    if (missing.length > 0) {
-        return (`目标 ab-render 的 template-core 缺少导出：${missing.join(', ')}。` +
-            `模板声明需要 core@${declared ?? '(未声明)'}，平台当前提供 ${offered.length ? offered.map((v) => `core@${v}`).join(', ') : '(未知版本)'}。` +
-            '请改用平台已有的导出，或等平台升级 core 后再发布。');
-    }
-    if (declared && offered.length > 0 && !offered.includes(declared)) {
-        warn(`  ⚠ 模板声明 core@${declared}，平台提供 ${offered.join(', ')} —— 导出齐全可以渲染，但效果未必与本地完全一致`);
-    }
-    return null;
-}
-function tarball(srcDir, outFile) {
-    return runProcess('tar', tarArgs(srcDir, outFile), { stdio: 'pipe' }).then((r) => {
-        if (r.code !== 0)
-            throw new SkillError(`❌ 打包失败（tar 退出码 ${r.code}）: ${r.stderr.trim().slice(0, 300)}`);
-    });
-}
-async function putToOss(uploadUrl, bytes) {
-    let res;
-    try {
-        // Content-Type must equal what ab-api signed, or OSS answers SignatureDoesNotMatch.
-        res = await fetch(uploadUrl, { method: 'PUT', headers: { 'Content-Type': 'application/gzip' }, body: new Uint8Array(bytes) });
-    }
-    catch (err) {
-        throw new SkillError(`❌ 上传模板包失败（网络错误）: ${err.message}`, EXIT.BACKEND_UNREACHABLE);
-    }
-    if (res.status >= 300) {
-        // Body/URL intentionally omitted: the URL is presigned.
-        throw new SkillError(`❌ 上传模板包失败（OSS HTTP ${res.status}）`, res.status >= 500 ? EXIT.BACKEND_UNREACHABLE : EXIT.ERROR);
-    }
-}
-export async function runPublish(opts) {
-    const out = new Output(Boolean(opts.json));
-    const name = validateTemplateName(opts.name);
-    const root = requireProjectRoot(opts.cwd);
-    const tplDir = requireTemplateDir(root, name);
-    emitProgress({ phase: 'template-publish:check', progress: 0.05 });
-    const checkCode = await runCheck({ name, cwd: root, stdio: opts.json ? 'stderr' : 'inherit' });
-    if (checkCode !== 0) {
-        throw new SkillError(`❌ 本地校验未通过（check 退出码 ${checkCode}），已中止发布。`, checkCode === 2 ? EXIT.USAGE : EXIT.ERROR);
-    }
-    // Re-read after check: it refreshes coreVersion / coreExports.
-    const templateJson = readJsonFile(path.join(tplDir, 'template.json'));
-    const { templateKey, existing } = resolveTemplateKey(tplDir);
-    const displayName = opts.displayName ?? (typeof templateJson.name === 'string' && templateJson.name ? templateJson.name : name);
-    const coreVersion = typeof templateJson.coreVersion === 'string' ? templateJson.coreVersion : '';
-    // Credentials before any network call, so a missing login is exit 4 rather
-    // than a confusing preflight failure. Dry-run needs none.
-    let ctx = null;
-    if (!opts.dryRun) {
-        ctx = await resolveHttpContext('template-publish', { privateToken: opts.token, apiBaseUrl: opts.apiBaseUrl });
-    }
-    const renderBase = resolveRenderBaseUrl();
-    out.info(`模板          ${name}`);
-    out.info(`templateKey   ${templateKey}${existing ? '' : '（首次发布，新生成）'}`);
-    out.info(`名称          ${displayName}`);
-    out.info(`coreVersion   ${coreVersion || '(未声明)'}`);
-    emitProgress({ phase: 'template-publish:preflight', progress: 0.15 });
-    const surface = await fetchCoreSurface(renderBase);
-    const blocked = evaluateCoreSurface(templateJson, surface, (m) => out.warn(m));
-    if (blocked)
-        throw new SkillError(`❌ core 预检未通过：${blocked}`);
-    out.info(`core 预检     通过（${surface?.exports.length ?? 0} 个导出）`);
-    if (opts.dryRun) {
-        out.info('\n[dry-run] 将依次调用 prepareSave → presignUpload → 上传 → save（isBuiltin=false）');
-        out.info(`[dry-run] 打包排除：${TAR_EXCLUDES.join(', ')}（保留 dsl-example.json）`);
-        const result = { ok: true, name, templateKey, version: null, dryRun: true, created: !existing };
-        out.result({ ...result });
-        return result;
-    }
-    const http = ctx;
-    let staging;
-    try {
-        emitProgress({ phase: 'template-publish:prepare', progress: 0.3 });
-        const prepared = await mmPost(http, '/remotionTemplate/prepareSave', {
-            templateJson,
-            name: displayName,
-            templateKey,
-            ...(coreVersion ? { coreVersion } : {}),
-        });
-        const resolvedKey = prepared?.templateKey || templateKey;
-        // ab-api save 要求制品里 template.json 的 templateId === 登记的 templateKey
-        // （templateregistry.ValidateManifestInvariants）。工程里的 templateId 是本地目录级标识
-        // （Studio 注册用），平台身份是 templateKey —— 只改暂存副本，工程文件不动。
-        const normalized = { ...(prepared?.templateJson || templateJson), templateId: resolvedKey };
-        // Staging copy: server normalization never touches the project files.
-        staging = mkdtempSync(path.join(os.tmpdir(), 'remixmate-publish-'));
-        const pkgDir = path.join(staging, 'pkg');
-        cpSync(tplDir, pkgDir, { recursive: true });
-        rmSync(path.join(pkgDir, IDENTITY_FILE), { force: true });
-        writeFileSync(path.join(pkgDir, 'template.json'), JSON.stringify(normalized, null, 2) + '\n', 'utf8');
-        if (JSON.stringify(normalized) !== JSON.stringify(templateJson)) {
-            out.warn('  ⚠ 服务端规范化后的 template.json 与本地不同；本次上传使用规范化版本，本地文件未改动。');
-        }
-        emitProgress({ phase: 'template-publish:pack', progress: 0.45 });
-        const tarPath = path.join(staging, `${resolvedKey}.tar.gz`);
-        await tarball(pkgDir, tarPath);
-        const bytes = readFileSync(tarPath);
-        out.info(`打包          ${(bytes.length / 1024).toFixed(0)} KB`);
-        emitProgress({ phase: 'template-publish:presign', progress: 0.55 });
-        const grant = await mmPost(http, '/remotionTemplate/presignUpload', { templateKey: resolvedKey });
-        if (!grant?.uploadUrl)
-            throw new SkillError('❌ presignUpload 未返回 uploadUrl');
-        emitProgress({ phase: 'template-publish:upload', progress: 0.7 });
-        await putToOss(String(grant.uploadUrl), bytes);
-        emitProgress({ phase: 'template-publish:save', progress: 0.85 });
-        await mmPost(http, '/remotionTemplate/save', {
-            templateKey: resolvedKey,
-            name: displayName,
-            isBuiltin: false,
-            sourceOssKey: grant.sourceOssKey,
-            version: grant.version,
-            templateJson: normalized,
-            ...(coreVersion ? { coreVersion } : {}),
-        });
-        const version = typeof grant.version === 'number' ? grant.version : Number(grant.version) || 0;
-        writeIdentity(tplDir, { templateKey: resolvedKey, version });
-        emitProgress({ phase: 'template-publish:done', progress: 1, templateKey: resolvedKey });
-        out.info(`\n✅ 已发布为你的私有模板`);
-        out.info(`  templateKey  ${resolvedKey}`);
-        out.info(`  version      ${version}`);
-        out.info(`  （已写入 templates/${name}/${IDENTITY_FILE}，再次发布会更新同一个模板）`);
-        out.info('\n出片：');
-        out.info(`  remixmate render-video --template-id ${resolvedKey} …`);
-        const result = { ok: true, name, templateKey: resolvedKey, version, dryRun: false, created: !existing };
-        out.result({ ...result });
-        return result;
-    }
-    finally {
-        if (staging)
-            rmSync(staging, { recursive: true, force: true });
-    }
-}
+var O=Object.defineProperty;var u=(r,e)=>O(r,"name",{value:e,configurable:!0});import{cpSync as P,mkdtempSync as V,readFileSync as D,rmSync as A,writeFileSync as J}from"node:fs";import I from"node:os";import f from"node:path";import{EXIT as g,SkillError as d}from"../errors.js";import{mmPost as x,resolveHttpContext as F}from"../http.js";import{emitProgress as p}from"../progress.js";import{IDENTITY_FILE as B,TAR_EXCLUDES as C}from"./constants.js";import{runCheck as z}from"./check.js";import{Output as H,readJsonFile as L,requireProjectRoot as _,requireTemplateDir as q,resolveTemplateKey as X,validateTemplateName as G,writeIdentity as Y}from"./project.js";import{runProcess as M}from"./proc.js";import{fetchCoreSurface as Q,resolveRenderBaseUrl as W}from"./render-client.js";function Z(r,e){const t=["-czf",e];for(const i of C)t.push(`--exclude=${i}`);return t.push("-C",r,"."),t}u(Z,"tarArgs");function ee(r,e,t=()=>{}){if(!e)return"ab-render /health 未返回 coreSurface —— 该实例版本过旧，无法校验 core 契约";if(!e.available)return`ab-render 无法读取 template-core：${e.error??"未知原因"}`;if(!Array.isArray(r.coreExports))return"template.json 缺少 coreExports —— 先运行 remixmate template check 生成";const i=new Set(e.exports??[]),l=r.coreExports.filter(a=>!i.has(a)),s=typeof r.coreVersion=="string"?r.coreVersion:null,o=Array.isArray(e.versions)&&e.versions.length>0?e.versions:e.packageVersion?[e.packageVersion]:[];return l.length>0?`目标 ab-render 的 template-core 缺少导出：${l.join(", ")}。模板声明需要 core@${s??"(未声明)"}，平台当前提供 ${o.length?o.map(a=>`core@${a}`).join(", "):"(未知版本)"}。请改用平台已有的导出，或等平台升级 core 后再发布。`:(s&&o.length>0&&!o.includes(s)&&t(`  ⚠ 模板声明 core@${s}，平台提供 ${o.join(", ")} —— 导出齐全可以渲染，但效果未必与本地完全一致`),null)}u(ee,"evaluateCoreSurface");function re(r,e){return M("tar",Z(r,e),{stdio:"pipe"}).then(t=>{if(t.code!==0)throw new d(`❌ 打包失败（tar 退出码 ${t.code}）: ${t.stderr.trim().slice(0,300)}`)})}u(re,"tarball");async function te(r,e){let t;try{t=await fetch(r,{method:"PUT",headers:{"Content-Type":"application/gzip"},body:new Uint8Array(e)})}catch(i){throw new d(`❌ 上传模板包失败（网络错误）: ${i.message}`,g.BACKEND_UNREACHABLE)}if(t.status>=300)throw new d(`❌ 上传模板包失败（OSS HTTP ${t.status}）`,t.status>=500?g.BACKEND_UNREACHABLE:g.ERROR)}u(te,"putToOss");async function he(r){const e=new H(!!r.json),t=G(r.name),i=_(r.cwd),l=q(i,t);p({phase:"template-publish:check",progress:.05});const s=await z({name:t,cwd:i,stdio:r.json?"stderr":"inherit"});if(s!==0)throw new d(`❌ 本地校验未通过（check 退出码 ${s}），已中止发布。`,s===2?g.USAGE:g.ERROR);const o=L(f.join(l,"template.json")),{templateKey:a,existing:v}=X(l),$=r.displayName??(typeof o.name=="string"&&o.name?o.name:t),h=typeof o.coreVersion=="string"?o.coreVersion:"";let E=null;r.dryRun||(E=await F("template-publish",{privateToken:r.token,apiBaseUrl:r.apiBaseUrl}));const N=W();e.info(`模板          ${t}`),e.info(`templateKey   ${a}${v?"":"（首次发布，新生成）"}`),e.info(`名称          ${$}`),e.info(`coreVersion   ${h||"(未声明)"}`),p({phase:"template-publish:preflight",progress:.15});const k=await Q(N),K=ee(o,k,c=>e.warn(c));if(K)throw new d(`❌ core 预检未通过：${K}`);if(e.info(`core 预检     通过（${k?.exports.length??0} 个导出）`),r.dryRun){e.info(`
+[dry-run] 将依次调用 prepareSave → presignUpload → 上传 → save（isBuiltin=false）`),e.info(`[dry-run] 打包排除：${C.join(", ")}（保留 dsl-example.json）`);const c={ok:!0,name:t,templateKey:a,version:null,dryRun:!0,created:!v};return e.result({...c}),c}const b=E;let y;try{p({phase:"template-publish:prepare",progress:.3});const c=await x(b,"/remotionTemplate/prepareSave",{templateJson:o,name:$,templateKey:a,...h?{coreVersion:h}:{}}),n=c?.templateKey||a,S={...c?.templateJson||o,templateId:n};y=V(f.join(I.tmpdir(),"remixmate-publish-"));const w=f.join(y,"pkg");P(l,w,{recursive:!0}),A(f.join(w,B),{force:!0}),J(f.join(w,"template.json"),JSON.stringify(S,null,2)+`
+`,"utf8"),JSON.stringify(S)!==JSON.stringify(o)&&e.warn("  ⚠ 服务端规范化后的 template.json 与本地不同；本次上传使用规范化版本，本地文件未改动。"),p({phase:"template-publish:pack",progress:.45});const T=f.join(y,`${n}.tar.gz`);await re(w,T);const R=D(T);e.info(`打包          ${(R.length/1024).toFixed(0)} KB`),p({phase:"template-publish:presign",progress:.55});const m=await x(b,"/remotionTemplate/presignUpload",{templateKey:n});if(!m?.uploadUrl)throw new d("❌ presignUpload 未返回 uploadUrl");p({phase:"template-publish:upload",progress:.7}),await te(String(m.uploadUrl),R),p({phase:"template-publish:save",progress:.85}),await x(b,"/remotionTemplate/save",{templateKey:n,name:$,isBuiltin:!1,sourceOssKey:m.sourceOssKey,version:m.version,templateJson:S,...h?{coreVersion:h}:{}});const j=typeof m.version=="number"?m.version:Number(m.version)||0;Y(l,{templateKey:n,version:j}),p({phase:"template-publish:done",progress:1,templateKey:n}),e.info(`
+✅ 已发布为你的私有模板`),e.info(`  templateKey  ${n}`),e.info(`  version      ${j}`),e.info(`  （已写入 templates/${t}/${B}，再次发布会更新同一个模板）`),e.info(`
+出片：`),e.info(`  remixmate render-video --template-id ${n} …`);const U={ok:!0,name:t,templateKey:n,version:j,dryRun:!1,created:!v};return e.result({...U}),U}finally{y&&A(y,{recursive:!0,force:!0})}}u(he,"runPublish");export{ee as evaluateCoreSurface,he as runPublish,Z as tarArgs};

package/dist/template/render-client.js

@@ -1,79 +1,2 @@
-/**
- * Minimal ab-render client for preview (/renderDraft) and publish preflight (/health).
- *
- * ab-render is a different origin from ab-api but verifies the same PrivToken,
- * so the token is resolved against the ab-api base (where `remixmate login`
- * stored it) and sent to ab-render as X-Priv-Token. All routes are POST.
- */
-import { traceHeaders } from '../diagnostics.js';
-import { NOT_AUTHENTICATED_HINT } from '../auth/resolve.js';
-import { EXIT, SkillError } from '../errors.js';
-import { DEFAULT_RENDER_BASE_URL } from './constants.js';
-export function resolveRenderBaseUrl() {
-    return ((process.env.AB_RENDER_URL ?? '').trim() || DEFAULT_RENDER_BASE_URL).replace(/\/+$/, '');
-}
-/** Business error from ab-render (`code != 0`), payload kept for issue rendering. */
-export class RenderBusinessError extends SkillError {
-    code;
-    payload;
-    constructor(message, code, payload) {
-        super(message, EXIT.ERROR);
-        this.code = code;
-        this.payload = payload;
-    }
-}
-export async function renderPost(base, route, body, opts) {
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), opts.timeoutMs ?? 60_000);
-    const headers = {
-        'Content-Type': 'application/json',
-        'x-invoke-skill': opts.skillName,
-        ...traceHeaders(),
-    };
-    if (opts.token)
-        headers['X-Priv-Token'] = opts.token;
-    let res;
-    try {
-        res = await fetch(`${base}${route}`, {
-            method: 'POST',
-            headers,
-            body: JSON.stringify(body ?? {}),
-            signal: controller.signal,
-        });
-    }
-    catch (err) {
-        const why = err.name === 'AbortError' ? '请求超时' : err.message;
-        throw new SkillError(`❌ ab-render 不可达（${base}${route}）：${why}`, EXIT.BACKEND_UNREACHABLE);
-    }
-    finally {
-        clearTimeout(timer);
-    }
-    const text = await res.text();
-    if (res.status === 401)
-        throw new SkillError(NOT_AUTHENTICATED_HINT, EXIT.NOT_AUTHENTICATED);
-    if (res.status >= 500) {
-        throw new SkillError(`❌ ab-render ${route} HTTP ${res.status}`, EXIT.BACKEND_UNREACHABLE);
-    }
-    let json;
-    try {
-        json = JSON.parse(text);
-    }
-    catch {
-        throw new SkillError(`❌ ab-render ${route} 返回非 JSON（HTTP ${res.status}）`);
-    }
-    if (json.code !== undefined && json.code !== 0) {
-        if (json.code === 401) {
-            throw new SkillError(`${NOT_AUTHENTICATED_HINT}\n   （ab-render: ${json.msg ?? 'code=401'}）`, EXIT.NOT_AUTHENTICATED);
-        }
-        throw new RenderBusinessError(`❌ ab-render ${route} code=${json.code}: ${json.msg ?? 'unknown'}`, json.code, json);
-    }
-    return (json.data ?? json);
-}
-/** /health → coreSurface, or null when the instance predates the core contract. */
-export async function fetchCoreSurface(base) {
-    const data = await renderPost(base, '/health', {}, {
-        skillName: 'template-publish',
-        timeoutMs: 15_000,
-    });
-    return data?.coreSurface ?? null;
-}
+var h=Object.defineProperty;var s=(r,t)=>h(r,"name",{value:t,configurable:!0});import{traceHeaders as w}from"../diagnostics.js";import{NOT_AUTHENTICATED_HINT as E}from"../auth/resolve.js";import{EXIT as i,SkillError as a}from"../errors.js";import{DEFAULT_RENDER_BASE_URL as N}from"./constants.js";function b(){return((process.env.AB_RENDER_URL??"").trim()||N).replace(/\/+$/,"")}s(b,"resolveRenderBaseUrl");class A extends a{static{s(this,"RenderBusinessError")}code;payload;constructor(t,c,o){super(t,i.ERROR),this.code=c,this.payload=o}}async function p(r,t,c,o){const l=new AbortController,m=setTimeout(()=>l.abort(),o.timeoutMs??6e4),d={"Content-Type":"application/json","x-invoke-skill":o.skillName,...w()};o.token&&(d["X-Priv-Token"]=o.token);let n;try{n=await fetch(`${r}${t}`,{method:"POST",headers:d,body:JSON.stringify(c??{}),signal:l.signal})}catch(T){const u=T.name==="AbortError"?"请求超时":T.message;throw new a(`❌ ab-render 不可达（${r}${t}）：${u}`,i.BACKEND_UNREACHABLE)}finally{clearTimeout(m)}const f=await n.text();if(n.status===401)throw new a(E,i.NOT_AUTHENTICATED);if(n.status>=500)throw new a(`❌ ab-render ${t} HTTP ${n.status}`,i.BACKEND_UNREACHABLE);let e;try{e=JSON.parse(f)}catch{throw new a(`❌ ab-render ${t} 返回非 JSON（HTTP ${n.status}）`)}if(e.code!==void 0&&e.code!==0)throw e.code===401?new a(`${E}
+   （ab-render: ${e.msg??"code=401"}）`,i.NOT_AUTHENTICATED):new A(`❌ ab-render ${t} code=${e.code}: ${e.msg??"unknown"}`,e.code,e);return e.data??e}s(p,"renderPost");async function k(r){return(await p(r,"/health",{},{skillName:"template-publish",timeoutMs:15e3}))?.coreSurface??null}s(k,"fetchCoreSurface");export{A as RenderBusinessError,k as fetchCoreSurface,p as renderPost,b as resolveRenderBaseUrl};

package/dist/template/upgrade.js

@@ -1,123 +1,4 @@
-/**
- * `remixmate template upgrade [--dry-run] [--with-docs] [--force] [--json]`
- *
- * 只更新工程里的本地校验规则（`.remixmate/`：check 脚本、template.schema.json、
- * template-security-policy.json），来源是本 cli 钉死的 starter 版本（STARTER_VERSION）。
- *
- * 为什么需要：starter 在 init 时整份复制进用户工程，之后平台收紧规则，老工程的
- * 本地 check 还是旧规则 —— 本地通过、服务端拒绝。一个 starter 版本 = 一套规则版本，
- * 所以升级 cli 后跑一次 upgrade 就能对齐。
- *
- * 刻意不动的东西：templates/（用户的模板）、src/、package.json 与依赖、examples/。
- * core 版本变化只提示不自动改 —— 升 core 可能影响模板渲染，必须是用户的决定。
- * `--with-docs` 额外刷新 AGENTS.md / CLAUDE.md（内容不同时旧文件备份为 *.orig）。
- */
-import { cpSync, existsSync, mkdirSync, mkdtempSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { EXIT, SkillError } from '../errors.js';
-import { emitProgress } from '../progress.js';
-import { DOC_FILES, RULES_DIR, RULES_VERSION_FILE, STARTER_VERSION } from './constants.js';
-import { obtainStarterTarball } from './init.js';
-import { Output, compareVersions, readRulesVersion, requireProjectRoot } from './project.js';
-import { runProcess } from './proc.js';
-/** Dependencies whose pinned version the starter changed — reported, never auto-applied. */
-export function diffDependencies(project, starter) {
-    const mine = { ...project.devDependencies, ...project.dependencies };
-    const theirs = { ...starter.devDependencies, ...starter.dependencies };
-    return Object.entries(theirs)
-        .filter(([name, v]) => mine[name] !== v)
-        .map(([name, v]) => ({ name, project: mine[name] ?? null, starter: v }))
-        .sort((a, b) => a.name.localeCompare(b.name));
-}
-function readPkg(file) {
-    try {
-        return JSON.parse(readFileSync(file, 'utf8'));
-    }
-    catch {
-        return {};
-    }
-}
-export async function runUpgrade(opts = {}) {
-    const out = new Output(Boolean(opts.json));
-    const root = requireProjectRoot(opts.cwd);
-    const from = readRulesVersion(root);
-    const to = STARTER_VERSION;
-    if (from && compareVersions(from, to) >= 0 && !opts.force) {
-        out.info(`✅ 本地校验规则已是最新（starter ${from}，当前 cli 对应 ${to}）。`);
-        const result = { ok: true, from, to, upgraded: false, dryRun: Boolean(opts.dryRun), docs: [], dependencyHints: [] };
-        out.result({ ...result });
-        return result;
-    }
-    const tmp = mkdtempSync(path.join(os.tmpdir(), 'remixmate-upgrade-'));
-    try {
-        emitProgress({ phase: 'template-upgrade:fetch', progress: 0.2 });
-        const { file, label } = await obtainStarterTarball(tmp, out);
-        const unpacked = path.join(tmp, 'starter');
-        mkdirSync(unpacked, { recursive: true });
-        const tar = await runProcess('tar', ['-xzf', file, '-C', unpacked, '--strip-components=1'], { stdio: 'pipe' });
-        if (tar.code !== 0) {
-            throw new SkillError(`❌ 解压 starter 失败（tar 退出码 ${tar.code}）: ${tar.stderr.trim().slice(0, 300)}`);
-        }
-        const newRules = path.join(unpacked, RULES_DIR);
-        if (!existsSync(path.join(newRules, 'check', 'index.mjs'))) {
-            throw new SkillError(`❌ ${label} 里没有 ${RULES_DIR}/check/index.mjs，不是有效的 starter 包`);
-        }
-        const docs = opts.withDocs
-            ? DOC_FILES.filter((f) => existsSync(path.join(unpacked, f)))
-            : [];
-        const dependencyHints = diffDependencies(readPkg(path.join(root, 'package.json')), readPkg(path.join(unpacked, 'package.json')));
-        out.info(`升级本地校验规则：starter ${from ?? '(未知版本)'} → ${to}（${label}）`);
-        out.info(`  替换 ${RULES_DIR}/（check 脚本、schema、安全策略）`);
-        for (const d of docs)
-            out.info(`  刷新 ${d}（内容不同时旧文件备份为 ${d}.orig）`);
-        out.info('  不改动 templates/、src/、examples/、package.json');
-        if (!opts.dryRun) {
-            emitProgress({ phase: 'template-upgrade:apply', progress: 0.6 });
-            // 先放到旁边再整体换名，避免复制到一半中断留下半新半旧的规则目录。
-            const target = path.join(root, RULES_DIR);
-            const staged = path.join(root, `${RULES_DIR}.upgrading`);
-            const old = path.join(root, `${RULES_DIR}.previous`);
-            rmSync(staged, { recursive: true, force: true });
-            rmSync(old, { recursive: true, force: true });
-            cpSync(newRules, staged, { recursive: true });
-            // 老 starter 包（0.1.0）没有 version.json：补写，之后 cli 才认得出版本。
-            const marker = path.join(staged, path.relative(RULES_DIR, RULES_VERSION_FILE));
-            if (!existsSync(marker)) {
-                writeFileSync(marker, JSON.stringify({ starterVersion: to }, null, 2) + '\n', 'utf8');
-            }
-            if (existsSync(target))
-                renameSync(target, old);
-            renameSync(staged, target);
-            rmSync(old, { recursive: true, force: true });
-            for (const d of docs) {
-                const dest = path.join(root, d);
-                const next = readFileSync(path.join(unpacked, d), 'utf8');
-                if (existsSync(dest)) {
-                    const prev = readFileSync(dest, 'utf8');
-                    if (prev === next)
-                        continue;
-                    writeFileSync(`${dest}.orig`, prev, 'utf8');
-                }
-                writeFileSync(dest, next, 'utf8');
-            }
-        }
-        for (const h of dependencyHints) {
-            out.warn(`  ⚠ 新 starter 钉的 ${h.name}@${h.starter}，你的工程是 ${h.project ?? '(未安装)'}。` +
-                `需要时手动执行 npm i ${h.name}@${h.starter}（升级 core 可能影响模板效果，先 check + preview 再发布）。`);
-        }
-        emitProgress({ phase: 'template-upgrade:done', progress: 1 });
-        out.info(opts.dryRun ? '\n[dry-run] 未写入任何文件。' : '\n✅ 已更新。接着运行 remixmate template check 看新规则下是否还有问题。');
-        const result = { ok: true, from, to, upgraded: !opts.dryRun, dryRun: Boolean(opts.dryRun), docs, dependencyHints };
-        out.result({ ...result });
-        return result;
-    }
-    catch (err) {
-        if (err instanceof SkillError)
-            throw err;
-        throw new SkillError(`❌ 升级失败: ${err.message}`, EXIT.ERROR);
-    }
-    finally {
-        rmSync(tmp, { recursive: true, force: true });
-    }
-}
+var F=Object.defineProperty;var l=(e,r)=>F(e,"name",{value:r,configurable:!0});import{cpSync as L,existsSync as p,mkdirSync as N,mkdtempSync as P,readFileSync as R,renameSync as _,rmSync as y,writeFileSync as S}from"node:fs";import T from"node:os";import n from"node:path";import{EXIT as B,SkillError as g}from"../errors.js";import{emitProgress as k}from"../progress.js";import{DOC_FILES as C,RULES_DIR as u,RULES_VERSION_FILE as U,STARTER_VERSION as H}from"./constants.js";import{obtainStarterTarball as J}from"./init.js";import{Output as q,compareVersions as z,readRulesVersion as A,requireProjectRoot as X}from"./project.js";import{runProcess as G}from"./proc.js";function K(e,r){const i={...e.devDependencies,...e.dependencies},c={...r.devDependencies,...r.dependencies};return Object.entries(c).filter(([o,s])=>i[o]!==s).map(([o,s])=>({name:o,project:i[o]??null,starter:s})).sort((o,s)=>o.name.localeCompare(s.name))}l(K,"diffDependencies");function b(e){try{return JSON.parse(R(e,"utf8"))}catch{return{}}}l(b,"readPkg");async function ie(e={}){const r=new q(!!e.json),i=X(e.cwd),c=A(i),o=H;if(c&&z(c,o)>=0&&!e.force){r.info(`✅ 本地校验规则已是最新（starter ${c}，当前 cli 对应 ${o}）。`);const a={ok:!0,from:c,to:o,upgraded:!1,dryRun:!!e.dryRun,docs:[],dependencyHints:[]};return r.result({...a}),a}const s=P(n.join(T.tmpdir(),"remixmate-upgrade-"));try{k({phase:"template-upgrade:fetch",progress:.2});const{file:a,label:w}=await J(s,r),f=n.join(s,"starter");N(f,{recursive:!0});const j=await G("tar",["-xzf",a,"-C",f,"--strip-components=1"],{stdio:"pipe"});if(j.code!==0)throw new g(`❌ 解压 starter 失败（tar 退出码 ${j.code}）: ${j.stderr.trim().slice(0,300)}`);const v=n.join(f,u);if(!p(n.join(v,"check","index.mjs")))throw new g(`❌ ${w} 里没有 ${u}/check/index.mjs，不是有效的 starter 包`);const $=e.withDocs?C.filter(t=>p(n.join(f,t))):[],x=K(b(n.join(i,"package.json")),b(n.join(f,"package.json")));r.info(`升级本地校验规则：starter ${c??"(未知版本)"} → ${o}（${w}）`),r.info(`  替换 ${u}/（check 脚本、schema、安全策略）`);for(const t of $)r.info(`  刷新 ${t}（内容不同时旧文件备份为 ${t}.orig）`);if(r.info("  不改动 templates/、src/、examples/、package.json"),!e.dryRun){k({phase:"template-upgrade:apply",progress:.6});const t=n.join(i,u),d=n.join(i,`${u}.upgrading`),h=n.join(i,`${u}.previous`);y(d,{recursive:!0,force:!0}),y(h,{recursive:!0,force:!0}),L(v,d,{recursive:!0});const O=n.join(d,n.relative(u,U));p(O)||S(O,JSON.stringify({starterVersion:o},null,2)+`
+`,"utf8"),p(t)&&_(t,h),_(d,t),y(h,{recursive:!0,force:!0});for(const D of $){const m=n.join(i,D),I=R(n.join(f,D),"utf8");if(p(m)){const V=R(m,"utf8");if(V===I)continue;S(`${m}.orig`,V,"utf8")}S(m,I,"utf8")}}for(const t of x)r.warn(`  ⚠ 新 starter 钉的 ${t.name}@${t.starter}，你的工程是 ${t.project??"(未安装)"}。需要时手动执行 npm i ${t.name}@${t.starter}（升级 core 可能影响模板效果，先 check + preview 再发布）。`);k({phase:"template-upgrade:done",progress:1}),r.info(e.dryRun?`
+[dry-run] 未写入任何文件。`:`
+✅ 已更新。接着运行 remixmate template check 看新规则下是否还有问题。`);const E={ok:!0,from:c,to:o,upgraded:!e.dryRun,dryRun:!!e.dryRun,docs:$,dependencyHints:x};return r.result({...E}),E}catch(a){throw a instanceof g?a:new g(`❌ 升级失败: ${a.message}`,B.ERROR)}finally{y(s,{recursive:!0,force:!0})}}l(ie,"runUpgrade");export{K as diffDependencies,ie as runUpgrade};

package/dist/text.js

@@ -1,15 +1 @@
-/**
- * Terminal text helpers shared by the human-facing commands.
- */
-// Ranges covering the CJK / fullwidth blocks the CLI's Chinese output uses.
-const WIDE = /[ᄀ-ᅟ⺀-䳿一-鿿가-힣豈-﫿︰-﹏＀-｠￠-￦]/;
-/**
- * Pad to a target terminal width. CJK characters occupy two columns but count as
- * one code unit, so String.padEnd misaligns any column that contains them.
- */
-export function padDisplay(text, width) {
-    let cols = 0;
-    for (const ch of text)
-        cols += WIDE.test(ch) ? 2 : 1;
-    return text + ' '.repeat(Math.max(1, width - cols));
-}
+var n=Object.defineProperty;var c=(t,o)=>n(t,"name",{value:o,configurable:!0});const r=/[ᄀ-ᅟ⺀-䳿一-鿿가-힣豈-﫿︰-﹏＀-｠￠-￦]/;function p(t,o){let a=0;for(const e of t)a+=r.test(e)?2:1;return t+" ".repeat(Math.max(1,o-a))}c(p,"padDisplay");export{p as padDisplay};