@applift/core 0.5.0 → 0.7.0

package/dist/{plugin-CTt0LO8c.d.mts → frameworks-D83HVg8t.d.mts}

@@ -9,20 +9,21 @@ interface FrameworkAdapter {
   detect(cwd: string): boolean;
   /** 各平台产物 glob（相对项目根，支持 * 简单通配） */
   artifactPatterns(platform: Platform): string[];
-  /** 缺省构建命令（null=不构建，仅用已有产物） */
-  buildCommand(platform: Platform): string[] | null;
   /** 展示名细化（如 RN 检出 Expo），可选 */
   expoAwareLabel?(cwd: string): string;
 }
-declare const rnAdapter: FrameworkAdapter;
-declare const flutterAdapter: FrameworkAdapter;
-declare const nativeAndroidAdapter: FrameworkAdapter;
-declare const nativeIosAdapter: FrameworkAdapter;
-declare const nativeHarmonyAdapter: FrameworkAdapter;
-declare const electronAdapter: FrameworkAdapter;
-declare const tauriAdapter: FrameworkAdapter;
-/** 探测项目框架（可注入额外适配器，插件自定义框架的扩展点） */
-declare function detectFramework(cwd: string, extra?: FrameworkAdapter[]): FrameworkAdapter | null;
+/** 一层子目录列表（探测用，跳过隐藏目录与 node_modules/Pods） */
+declare function subdirs(cwd: string, depth: number): string[];
+/** package.json 读取（容错） */
+declare function readJson(filePath: string): Record<string, unknown> | null;
+declare function deps(pkg: Record<string, unknown> | null): Record<string, unknown>;
+/**
+ * 声明式框架解析：插件注册的 adapter 是唯一来源（不再回退内置探测表）。
+ * - 未注册 → null（CLI 层负责提示声明 framework 插件）
+ * - 注册多个 → 报错（声明即意图，多个意图是配置错误）
+ * - 注册一个 → detect 降级为校验（声明与工程不符时显式报错，而非静默跳过）
+ */
+declare function resolveFramework(cwd: string, registered: FrameworkAdapter[]): FrameworkAdapter | null;
 /** 按 pattern 扫描产物（支持 ** 与 * 简单通配，返回绝对路径，多产物按 mtime 新者在前） */
 declare function findArtifacts(cwd: string, patterns: string[]): string[];
 /** 自动推导的三端应用标识（配置缺省时的兜底来源，全部可选） */
@@ -46,16 +47,6 @@ interface BundleIds {
 declare function detectBundleIds(cwd: string): BundleIds;
 //#endregion
 //#region src/channel.d.ts
-/**
- * 渠道适配器统一接口 —— applift 可扩展性的核心。
- *
- * 每个渠道（六商店/AGC/ASC/蒲公英…）实现本接口并注册到 registry；
- * 编排引擎（pipeline）只面对本接口，不感知任何渠道细节。
- *
- * 两段式安全模型：
- *   stage  = 只把包送到渠道草稿区，不动线上（iOS 上传构建≈只进 TestFlight）
- *   submit = 提审；除 iOS（默认 manual 发布）外，审核通过即自动上架 —— 不可逆，需计划确认
- */
 /** 渠道能力声明（编排与确认界面据此渲染/拦截） */
 interface ChannelCapabilities {
   /** 支持只传包不提审（小米 push 一体 → false，submit 即上传） */
@@ -145,8 +136,12 @@ interface Channel {
   plan(ctx: ChannelContext): Promise<ReleasePlanEntry>;
   /** 传包到草稿（capabilities.stage=false 的渠道返回明确错误） */
   stage(ctx: ChannelContext): Promise<StageResult>;
-  /** 提审（=审核通过自动上架，L3 不可逆操作） */
-  submit(ctx: ChannelContext): Promise<SubmitResult>;
+  /**
+   * 提审（=审核通过自动上架，L3 不可逆操作）。
+   * stagedRef = 同渠道 stage 成功返回的 ref（如 googleplay 的 `editId:versionCode`），
+   * 供实现复用 stage 已上传的草稿、避免重复上传；实现方可忽略。
+   */
+  submit(ctx: ChannelContext, stagedRef?: string): Promise<SubmitResult>;
   /** 查询审核状态（capabilities.status=false 时抛 NotSupported） */
   status(ctx: Pick<ChannelContext, "credentials" | "target">): Promise<ReviewStatus>;
 }
@@ -167,13 +162,7 @@ type CredentialsFile = z.infer<typeof CredentialsFileSchema>;
 /** 单渠道配置（appId、pkgName 等渠道侧键） */
 declare const StoreConfigSchema: z.ZodRecord<z.ZodString, z.ZodString>;
 type StoreConfig = z.infer<typeof StoreConfigSchema>;
-/**
- * stores 三种等价写法，统一规范化为 record：
- * ① 对象：{ huawei: { appId: 'x' } }（原有写法，原样保留）
- * ② 数组：['oppo', 'vivo'] → { oppo: {}, vivo: {} }（无配置渠道）
- * ③ 字符串值：{ huawei: '10xxx' } → { huawei: { appId: '10xxx' } }（appId 简写）
- */
-declare const StoresSchema: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodString>, z.ZodString]>>, z.ZodArray<z.ZodString>]>, z.ZodTransform<Record<string, Record<string, string>>, string[] | Record<string, string | Record<string, string>>>>>;
+declare const StoresSchema: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodString>, z.ZodString]>>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>]>, z.ZodTransform<Record<string, Record<string, string>>, (string | Record<string, string>)[] | Record<string, string | Record<string, string>>>>>;
 type Stores = z.infer<typeof StoresSchema>;
 /** 项目级配置（applift.config.ts 的形状）；beta 段见上方 BetaConfigSchema */
 /**
@@ -183,7 +172,6 @@ type Stores = z.infer<typeof StoresSchema>;
  * - testflight: App Store Connect 上传（ipa 进 TestFlight）
  */
 declare const BetaConfigSchema: z.ZodObject<{
-  bump: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
   pgyer: z.ZodOptional<z.ZodObject<{
     platforms: z.ZodDefault<z.ZodArray<z.ZodEnum<{
       android: "android";
@@ -214,33 +202,22 @@ declare const VersionConfigSchema: z.ZodObject<{
   }, z.core.$strip>]>>;
 }, z.core.$strip>;
 type VersionConfig = z.infer<typeof VersionConfigSchema>;
-/** 正式发版段的自动 version 开关（语义同 beta.bump） */
-declare const ReleaseConfigSchema: z.ZodObject<{
-  bump: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
-}, z.core.$strip>;
-type ReleaseConfig = z.infer<typeof ReleaseConfigSchema>;
 declare const ProjectConfigSchema: z.ZodObject<{
   name: z.ZodOptional<z.ZodString>;
   profile: z.ZodDefault<z.ZodString>;
   android: z.ZodOptional<z.ZodObject<{
-    pkgName: z.ZodString;
-    stores: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodString>, z.ZodString]>>, z.ZodArray<z.ZodString>]>, z.ZodTransform<Record<string, Record<string, string>>, string[] | Record<string, string | Record<string, string>>>>>;
+    pkgName: z.ZodOptional<z.ZodString>;
+    stores: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodString>, z.ZodString]>>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>]>, z.ZodTransform<Record<string, Record<string, string>>, (string | Record<string, string>)[] | Record<string, string | Record<string, string>>>>>;
   }, z.core.$strip>>;
   harmony: z.ZodOptional<z.ZodObject<{
-    bundleName: z.ZodString;
+    bundleName: z.ZodOptional<z.ZodString>;
     appId: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>>;
   ios: z.ZodOptional<z.ZodObject<{
-    scheme: z.ZodString;
+    scheme: z.ZodOptional<z.ZodString>;
     workspace: z.ZodOptional<z.ZodString>;
     bundleId: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>>;
-  build: z.ZodOptional<z.ZodObject<{
-    android: z.ZodOptional<z.ZodString>;
-    harmony: z.ZodOptional<z.ZodString>;
-    harmonyApp: z.ZodOptional<z.ZodString>;
-    ios: z.ZodOptional<z.ZodString>;
-  }, z.core.$strip>>;
   artifacts: z.ZodOptional<z.ZodObject<{
     android: z.ZodOptional<z.ZodArray<z.ZodString>>;
     harmony: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -255,11 +232,7 @@ declare const ProjectConfigSchema: z.ZodObject<{
       platforms: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>]>>;
   }, z.core.$strip>>;
-  release: z.ZodOptional<z.ZodObject<{
-    bump: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
-  }, z.core.$strip>>;
   beta: z.ZodOptional<z.ZodObject<{
-    bump: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
     pgyer: z.ZodOptional<z.ZodObject<{
       platforms: z.ZodDefault<z.ZodArray<z.ZodEnum<{
         android: "android";
@@ -352,6 +325,69 @@ declare function runSubmit(input: PipelineInput, options: {
   skipStage: boolean;
 }): Promise<PipelineSummary>;
 //#endregion
+//#region src/update.d.ts
+/** 判定结论：推荐值 + 置信度 + 逐文件证据（透明可审计，不是黑盒） */
+interface DeliveryJudgement {
+  recommendation: "ota" | "native" | "uncertain";
+  confidence: "high" | "medium" | "low";
+  evidence: Array<{
+    path: string;
+    rule: string;
+    note: string;
+  }>;
+}
+/** judge 的上下文：core 已解析的生效 framework（声明式），provider 不自行探测工程结构 */
+interface FrameworkContext {
+  cwd: string;
+  framework: FrameworkAdapter;
+  /** 上个发版锚点 tag（依赖变更对比 git show 用）；无锚点时缺省 */
+  anchor?: string;
+}
+interface UpdateProvider {
+  id: string;
+  /** 支持的 framework adapter id（如 ['rn']）；与项目声明的 framework 不匹配时 core 不采纳 */
+  frameworks: string[];
+  /** 已接入热更的平台（如 ['harmony']）；缺省视为全部。未接入平台的路由直接走原生 */
+  platforms?: string[];
+  /** 判定本次 diff 能否走热更（diff = 上个发版锚点到工作区的文件列表，含未提交与未跟踪） */
+  judge(diff: string[], ctx: FrameworkContext): Promise<DeliveryJudgement> | DeliveryJudgement;
+  /** beta 热更路径：构建热更包并发到测试通道（测试设备验证用） */
+  publishToTest(ctx: PublishContext): Promise<{
+    versionName: string;
+    versionId: number;
+  }>;
+  /** release 热更路径：测试通道最新已验证热更 promote 到正式（重绑正式原生版本 + 灰度） */
+  promoteToProd(ctx: PublishContext): Promise<{
+    versionName: string;
+    rollout?: number;
+  }>;
+}
+interface DeliveryRoute {
+  provider: UpdateProvider;
+  judgement: DeliveryJudgement;
+}
+/** 发布上下文：判定/发布共用（platform 为本次发布目标平台） */
+interface PublishContext extends FrameworkContext {
+  platform: string;
+  /** 更新说明（热更版本的 description） */
+  note?: string;
+  /** release 热更的灰度比例（CLI 确认时收集；缺省用 provider 默认） */
+  rollout?: number;
+}
+/**
+ * 投递路由：按当前 framework 匹配 provider 并执行判定。
+ * - 无 provider / 无匹配 → null（走原生包路径，原始行为不受影响）
+ * - 多个 provider 匹配同一 framework → 配置错误（一个框架一个热更实现）
+ * 结论是推荐值：最终投递方式由用户在确认界面拍板，CI 非交互时 uncertain 中止
+ */
+declare function routeDelivery(providers: UpdateProvider[], ctx: FrameworkContext, diff: string[], platform?: string): Promise<DeliveryRoute | null>;
+/**
+ * 收集上个发版锚点（最新 semver tag）到工作区的变更文件列表。
+ * 含未提交改动与未跟踪文件（pushy bundle 打包的是工作区内容，判定口径必须一致）。
+ * 无锚点 / 非 git 仓库 → null（调用方按 uncertain 处理，不猜）。
+ */
+declare function collectReleaseDiff(cwd: string): Promise<string[] | null>;
+//#endregion
 //#region src/plugin.d.ts
 interface HookContext {
   /** 触发钩子的渠道 id（channel 级钩子才有） */
@@ -359,12 +395,14 @@ interface HookContext {
   /** 项目根目录 */
   cwd: string;
 }
-interface QypubPlugin {
+interface AppliftPlugin {
   name: string;
   "config:resolved"?(config: ProjectConfig, ctx: HookContext): Promise<ProjectConfig | void> | ProjectConfig | void;
   "channel:register"?(registry: ChannelRegistry, ctx: HookContext): Promise<void> | void;
-  /** 注册自定义框架适配器（detect/artifactPatterns/buildCommand——扩展新框架的入口，与渠道扩展对称） */
+  /** 注册自定义框架适配器（detect/artifactPatterns——扩展新框架的入口，与渠道扩展对称） */
   "framework:register"?(adapters: FrameworkAdapter[], ctx: HookContext): Promise<void> | void;
+  /** 注册热更能力 provider（beta/release 投递路由的消费方，与框架/渠道扩展对称） */
+  "update:register"?(providers: UpdateProvider[], ctx: HookContext): Promise<void> | void;
   "plan:before"?(plans: ReleasePlanEntry[], ctx: HookContext): Promise<ReleasePlanEntry[] | false | void> | ReleasePlanEntry[] | false | void;
   "stage:before"?(channelCtx: ChannelContext, ctx: HookContext): Promise<ChannelContext | false | void> | ChannelContext | false | void;
   "stage:after"?(result: {
@@ -372,17 +410,20 @@ interface QypubPlugin {
     ok: boolean;
     ref?: string;
     error?: string;
+    artifactPath?: string;
   }, ctx: HookContext): Promise<void> | void;
   "submit:before"?(plans: ReleasePlanEntry[], ctx: HookContext): Promise<ReleasePlanEntry[] | false | void> | ReleasePlanEntry[] | false | void;
   "submit:after"?(summary: PipelineSummary, ctx: HookContext): Promise<void> | void;
   notify?(summary: PipelineSummary, ctx: HookContext): Promise<void> | void;
 }
-type PluginHookName = Exclude<keyof QypubPlugin, "name">;
+type PluginHookName = Exclude<keyof AppliftPlugin, "name">;
 declare class PluginHost {
   private readonly plugins;
-  constructor(plugins: QypubPlugin[]);
+  constructor(plugins: AppliftPlugin[]);
   /**
    * 顺序执行某钩子；支持「链式替换」（返回对象则替换后继续传给下一插件）与「拦截」（返回 false 立即中止）。
+   * 信任边界：返回值按 T 强转、不做形状校验（vite 同款取舍）——插件作者自负其责，
+   * 坏形状会在后续消费点显式抛错，宿主不代为静默兜底。
    * @returns {[被拦截?, 最终值]} false 表示被某插件拦截
    */
   apply<T>(hook: PluginHookName, value: T, ctx: HookContext): Promise<{
@@ -396,11 +437,31 @@ declare class PluginHost {
  * defineConfig —— vite 同款体验：applift.config.ts 导出时提供类型提示。
  * plugins 中允许嵌套工厂函数（如 dingtalkNotify({...}) 直接返回插件对象）。
  */
-interface QypubUserConfig extends Partial<ProjectConfig> {
-  plugins?: Array<QypubPlugin | (() => QypubPlugin)>;
+interface AppliftUserConfig extends Partial<ProjectConfig> {
+  plugins?: Array<AppliftPlugin | (() => AppliftPlugin)>;
 }
-declare function defineConfig(config: QypubUserConfig): QypubUserConfig;
+declare function defineConfig(config: AppliftUserConfig): AppliftUserConfig;
 /** 解析用户配置中的插件（工厂惰性求值），供 PluginHost 构造 */
-declare function resolvePlugins(userConfig: QypubUserConfig): QypubPlugin[];
+declare function resolvePlugins(userConfig: AppliftUserConfig): AppliftPlugin[];
+//#endregion
+//#region src/plugins/frameworks.d.ts
+/** 生态通用 RN adapter：产物 pattern 按 RN 社区惯例；构建命令无统一标准（项目覆盖） */
+declare const rnAdapter: FrameworkAdapter;
+declare function rnFramework(): AppliftPlugin;
+declare const flutterAdapter: FrameworkAdapter;
+declare function flutterFramework(): AppliftPlugin;
+declare const nativeAndroidAdapter: FrameworkAdapter;
+declare function nativeAndroidFramework(): AppliftPlugin;
+declare const nativeIosAdapter: FrameworkAdapter;
+declare function nativeIosFramework(): AppliftPlugin;
+declare const nativeHarmonyAdapter: FrameworkAdapter;
+declare function nativeHarmonyFramework(): AppliftPlugin;
+declare const electronAdapter: FrameworkAdapter;
+declare function electronFramework(): AppliftPlugin;
+declare const tauriAdapter: FrameworkAdapter;
+declare const knownFrameworkAdapters: FrameworkAdapter[];
+/** 按已知框架表探测建议（仅供 init/doctor 展示，不是发布依据） */
+declare function suggestFramework(cwd: string): FrameworkAdapter | null;
+declare function tauriFramework(): AppliftPlugin;
 //#endregion
-export { electronAdapter as $, ReleaseConfigSchema as A, ChannelCapabilities as B, CredentialsProfile as C, ProjectConfig as D, GlobalConfigSchema as E, VersionCodeConfig as F, ReviewStatus as G, ChannelEvent as H, VersionCodeConfigSchema as I, BundleIds as J, StageResult as K, VersionConfig as L, StoreConfigSchema as M, Stores as N, ProjectConfigSchema as O, StoresSchema as P, detectFramework as Q, VersionConfigSchema as R, CredentialsFileSchema as S, GlobalConfig as T, ChannelRegistry as U, ChannelContext as V, ReleasePlanEntry as W, Platform as X, FrameworkAdapter as Y, detectBundleIds as Z, appendEntry as _, QypubUserConfig as a, rnAdapter as at, BetaConfigSchema as b, PipelineInput as c, runStage as d, findArtifacts as et, runSubmit as f, HistoryQuery as g, HistoryEvent as h, QypubPlugin as i, nativeIosAdapter as it, StoreConfig as j, ReleaseConfig as k, PipelineSummary as l, HistoryEntry as m, PluginHookName as n, nativeAndroidAdapter as nt, defineConfig as o, tauriAdapter as ot, HISTORY_PATH as p, SubmitResult as q, PluginHost as r, nativeHarmonyAdapter as rt, resolvePlugins as s, HookContext as t, flutterAdapter as tt, PipelineSummaryEntry as u, readEntries as v, CredentialsProfileSchema as w, CredentialsFile as x, BetaConfig as y, Channel as z };
+export { StoreConfigSchema as $, routeDelivery as A, appendEntry as B, resolvePlugins as C, subdirs as Ct, PublishContext as D, FrameworkContext as E, runSubmit as F, CredentialsFileSchema as G, BetaConfig as H, HISTORY_PATH as I, GlobalConfig as J, CredentialsProfile as K, HistoryEntry as L, PipelineSummary as M, PipelineSummaryEntry as N, UpdateProvider as O, runStage as P, StoreConfig as Q, HistoryEvent as R, defineConfig as S, resolveFramework as St, DeliveryRoute as T, BetaConfigSchema as U, readEntries as V, CredentialsFile as W, ProjectConfig as X, GlobalConfigSchema as Y, ProjectConfigSchema as Z, AppliftPlugin as _, Platform as _t, knownFrameworkAdapters as a, VersionConfigSchema as at, PluginHookName as b, findArtifacts as bt, nativeHarmonyAdapter as c, ChannelContext as ct, nativeIosFramework as d, ReleasePlanEntry as dt, Stores as et, rnAdapter as f, ReviewStatus as ft, tauriFramework as g, FrameworkAdapter as gt, tauriAdapter as h, BundleIds as ht, flutterFramework as i, VersionConfig as it, PipelineInput as j, collectReleaseDiff as k, nativeHarmonyFramework as l, ChannelEvent as lt, suggestFramework as m, SubmitResult as mt, electronFramework as n, VersionCodeConfig as nt, nativeAndroidAdapter as o, Channel as ot, rnFramework as p, StageResult as pt, CredentialsProfileSchema as q, flutterAdapter as r, VersionCodeConfigSchema as rt, nativeAndroidFramework as s, ChannelCapabilities as st, electronAdapter as t, StoresSchema as tt, nativeIosAdapter as u, ChannelRegistry as ut, AppliftUserConfig as v, deps as vt, DeliveryJudgement as w, PluginHost as x, readJson as xt, HookContext as y, detectBundleIds as yt, HistoryQuery as z };

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { $ as electronAdapter, A as ReleaseConfigSchema, B as ChannelCapabilities, C as CredentialsProfile, D as ProjectConfig, E as GlobalConfigSchema, F as VersionCodeConfig, G as ReviewStatus, H as ChannelEvent, I as VersionCodeConfigSchema, J as BundleIds, K as StageResult, L as VersionConfig, M as StoreConfigSchema, N as Stores, O as ProjectConfigSchema, P as StoresSchema, Q as detectFramework, R as VersionConfigSchema, S as CredentialsFileSchema, T as GlobalConfig, U as ChannelRegistry, V as ChannelContext, W as ReleasePlanEntry, X as Platform, Y as FrameworkAdapter, Z as detectBundleIds, _ as appendEntry, a as QypubUserConfig, at as rnAdapter, b as BetaConfigSchema, c as PipelineInput, d as runStage, et as findArtifacts, f as runSubmit, g as HistoryQuery, h as HistoryEvent, i as QypubPlugin, it as nativeIosAdapter, j as StoreConfig, k as ReleaseConfig, l as PipelineSummary, m as HistoryEntry, n as PluginHookName, nt as nativeAndroidAdapter, o as defineConfig, ot as tauriAdapter, p as HISTORY_PATH, q as SubmitResult, r as PluginHost, rt as nativeHarmonyAdapter, s as resolvePlugins, t as HookContext, tt as flutterAdapter, u as PipelineSummaryEntry, v as readEntries, w as CredentialsProfileSchema, x as CredentialsFile, y as BetaConfig, z as Channel } from "./plugin-CTt0LO8c.mjs";
+import { $ as StoreConfigSchema, A as routeDelivery, B as appendEntry, C as resolvePlugins, Ct as subdirs, D as PublishContext, E as FrameworkContext, F as runSubmit, G as CredentialsFileSchema, H as BetaConfig, I as HISTORY_PATH, J as GlobalConfig, K as CredentialsProfile, L as HistoryEntry, M as PipelineSummary, N as PipelineSummaryEntry, O as UpdateProvider, P as runStage, Q as StoreConfig, R as HistoryEvent, S as defineConfig, St as resolveFramework, T as DeliveryRoute, U as BetaConfigSchema, V as readEntries, W as CredentialsFile, X as ProjectConfig, Y as GlobalConfigSchema, Z as ProjectConfigSchema, _ as AppliftPlugin, _t as Platform, a as knownFrameworkAdapters, at as VersionConfigSchema, b as PluginHookName, bt as findArtifacts, c as nativeHarmonyAdapter, ct as ChannelContext, d as nativeIosFramework, dt as ReleasePlanEntry, et as Stores, f as rnAdapter, ft as ReviewStatus, g as tauriFramework, gt as FrameworkAdapter, h as tauriAdapter, ht as BundleIds, i as flutterFramework, it as VersionConfig, j as PipelineInput, k as collectReleaseDiff, l as nativeHarmonyFramework, lt as ChannelEvent, m as suggestFramework, mt as SubmitResult, n as electronFramework, nt as VersionCodeConfig, o as nativeAndroidAdapter, ot as Channel, p as rnFramework, pt as StageResult, q as CredentialsProfileSchema, r as flutterAdapter, rt as VersionCodeConfigSchema, s as nativeAndroidFramework, st as ChannelCapabilities, t as electronAdapter, tt as StoresSchema, u as nativeIosAdapter, ut as ChannelRegistry, v as AppliftUserConfig, vt as deps, w as DeliveryJudgement, x as PluginHost, xt as readJson, y as HookContext, yt as detectBundleIds, z as HistoryQuery } from "./frameworks-D83HVg8t.mjs";
 //#region src/registry.d.ts
 export declare class DefaultChannelRegistry implements ChannelRegistry {
   private readonly channels;
@@ -30,8 +30,13 @@ export declare function loadCredentials(filePath?: string): CredentialsFile;
  * knownKeys 提供时其裸键名（如 PGYER_API_KEY）也认（向后兼容），未提供的裸大写键不捡（避免误吸无关变量）。
  */
 export declare function resolveProfile(creds: CredentialsFile, profile: string, knownKeys?: string[]): Record<string, string>;
-/** 全局配置装载（缺失/损坏降级默认值并警告，不阻断） */
-export declare function loadGlobalConfig(filePath?: string): GlobalConfig;
+export interface GlobalConfigLoadResult {
+  config: GlobalConfig;
+  /** 配置文件损坏降级默认值时的警告（调用方决定呈现方式；core 保持 headless 不写 stderr） */
+  warning?: string;
+}
+/** 全局配置装载（缺失/损坏降级默认值；警告经返回值交给调用方，不阻断） */
+export declare function loadGlobalConfig(filePath?: string): GlobalConfigLoadResult;
 /** 写凭据（目录自动创建，文件强制 0600） */
 export declare function saveCredentials(data: CredentialsFile, filePath?: string): void;
 //#endregion
@@ -42,7 +47,7 @@ export interface LoadedProjectConfig {
    * c12 原始配置（保留 plugins 等 schema 外键）——插件发现（resolvePlugins）用；
    * 业务字段一律以 config（zod 解析后）为准。
    */
-  raw: QypubUserConfig;
+  raw: AppliftUserConfig;
   /** 配置文件所在目录（解析相对路径用），无配置文件时为 cwd */
   cwd: string;
 }
@@ -56,10 +61,17 @@ export declare function loadProjectProfileMap(filePath?: string): Record<string,
 export declare function saveProjectProfileMap(map: Record<string, string>, filePath?: string): void;
 /** 记录某项目使用的 profile（键统一绝对路径；合并保留其他项目的条目） */
 export declare function setProjectProfile(cwd: string, profile: string, filePath?: string): void;
+/** 生效 profile 的来源（诊断展示用；--profile 旗标在调用方，最高优先级，不经此函数） */
+export type ProfileSource = "applift use（个人）" | "项目配置 profile（团队默认）" | "默认 default";
 /**
- * 解析项目生效 profile：projects.json 个人选择 > 项目配置 profile（团队默认）> 'default' 全局默认。
- * CLI 的 --profile 旗标在调用方以 `opts.profile ?? resolveProfileFor(...)` 再盖一层（最高优先级）。
+ * 解析项目生效 profile 及其来源：projects.json 个人选择 > 项目配置 profile（团队默认）> 'default'。
+ * CLI 的 --profile 旗标在调用方以 `opts.profile ?? ...` 再盖一层（最高优先级，来源即"旗标"）。
  */
+export declare function resolveProfileSource(cwd: string, projectCfgProfile?: string, filePath?: string): {
+  profile: string;
+  source: ProfileSource;
+};
+/** 解析项目生效 profile（只取名不问来源；来源用 resolveProfileSource） */
 export declare function resolveProfileFor(cwd: string, projectCfgProfile?: string, filePath?: string): string;
 //#endregion
 //#region src/channels/shared/sign.d.ts
@@ -80,6 +92,10 @@ export declare class PgyerChannel implements Channel {
   readonly id = "pgyer";
   readonly label = "蒲公英";
   readonly capabilities: ChannelCapabilities;
+  /** 平台错误码 → 人话（1247：源码注释已证 = buildKey 尚未就绪/COS 仍在入库） */
+  readonly errorHints: {
+    "1247": string;
+  };
   plan(ctx: ChannelContext): Promise<ReleasePlanEntry>;
   stage(ctx: ChannelContext): Promise<StageResult>;
   submit(): Promise<SubmitResult>;
@@ -172,6 +188,11 @@ export declare class XiaomiChannel implements Channel {
   readonly id = "xiaomi";
   readonly label = "小米应用商店";
   readonly capabilities: ChannelCapabilities;
+  /** 平台错误码 → 人话（result 码：依据为本仓测试已固化的真实失败路径文案） */
+  readonly errorHints: {
+    "401": string;
+    "1005": string;
+  };
   plan(_ctx: ChannelContext): Promise<ReleasePlanEntry>;
   /** 小米不支持只传包：push 接口上传即提审 */
   stage(_ctx: ChannelContext): Promise<StageResult>;
@@ -286,6 +307,10 @@ export declare class YybChannel implements Channel {
   readonly id = "yyb";
   readonly label = "腾讯应用宝";
   readonly capabilities: ChannelCapabilities;
+  /** 平台错误码 → 人话（ret 码：依据为本仓测试已固化的真实失败路径） */
+  readonly errorHints: {
+    "10010": string;
+  };
   /** stage 产物暂存（serial_number + md5），submit 按 appId 取回 */
   private readonly staged;
   private required;
@@ -329,8 +354,9 @@ export declare class AgcHarmonyChannel implements Channel {
   plan(ctx: ChannelContext): Promise<ReleasePlanEntry>;
   /** stage = 上传+绑定（不提审）：正式 .app 走 v3 绑定；ctx.target.releaseType==='6' 走测试发布（.hap） */
   stage(ctx: ChannelContext): Promise<StageResult>;
-  /** submit = v1 releaseHarmonyApp 完整链路：上传+绑定+文案 → 等编译轮询 → 提审（带重试） */
-  submit(ctx: ChannelContext): Promise<SubmitResult>;
+  /** submit = v1 releaseHarmonyApp 完整链路：上传+绑定+文案 → 等编译轮询 → 提审（带重试）。
+   *  stagedRef = stage() 返回的 packageId：包已在草稿区，跳过重传直接等编译+提审（.app 常为数百 MB~GB，双倍上传不可接受） */
+  submit(ctx: ChannelContext, stagedRef?: string): Promise<SubmitResult>;
   /** 轮询软件包云端编译：successStatus 0=成功 2=拒绝（终态，多为签名/证书/bundleName 不匹配）其他=编译中 */
   private awaitCompile;
   status(): Promise<ReviewStatus>;
@@ -384,11 +410,24 @@ export declare class GooglePlayChannel implements Channel {
   readonly id = "googleplay";
   readonly label = "Google Play";
   readonly capabilities: ChannelCapabilities;
+  /** 平台错误码 → 人话（HTTP 状态：依据为本仓测试已固化的失败路径） */
+  readonly errorHints: {
+    "403": string;
+  };
   plan(_ctx: ChannelContext): Promise<ReleasePlanEntry>;
   stage(ctx: ChannelContext): Promise<StageResult>;
-  submit(ctx: ChannelContext): Promise<SubmitResult>;
+  submit(ctx: ChannelContext, stagedRef?: string): Promise<SubmitResult>;
+  /** 复用 stage 已上传的 versionCode：开新 edit（仍需 auth）→ 部署 production → commit，跳过上传 */
+  private assignExisting;
   /** 上传 + 部署到指定轨道 + commit，返回 `editId:versionCode` */
   private uploadAndAssign;
+  /**
+   * 部署 versionCode 到指定轨道并 commit：
+   * 先 GET 轨道现有 releases 再合并 PUT——目标 release（同 status=completed 配置）追加新 versionCode，
+   * 其余 releases 原样保留（status/userFraction 不变），避免整轨覆盖把旧版本从轨道剔除；
+   * :commit 冒号语法（对拍 apkgo googleplay.go 权威；对 production 含提交审核语义，internal 即生效）
+   */
+  private deployAndCommit;
   status(ctx: Pick<ChannelContext, "credentials" | "target">): Promise<ReviewStatus>;
   private requirePkgName;
 }
@@ -400,9 +439,19 @@ export declare function sha256File(filePath: string): string;
 //#region src/channels/shared/error-codes.d.ts
 /**
  * 错误码人话化：消费各渠道自带 errorHints（平台内聚——表与渠道实现同文件）。
+ * 网络类故障（AbortSignal 超时/断连/DNS）渠道层不转译，统一在此兜底提示。
  */
 export declare function humanizeError(hints: Record<string, string> | undefined, message: string): string;
 //#endregion
+//#region src/channels/shared/redact.d.ts
+/**
+ * 文本脱敏（三层层叠，逐层尝试）：
+ *   1) http(s) URL 带 query/userinfo → query 按名脱敏 + 剥 userinfo
+ *   2) { / [ 开头且整串为合法 JSON → 递归按键名脱敏
+ *   3) 其余 → name=value 正则扫（错误消息等无结构文本）
+ */
+export declare function redactText(v: string): string;
+//#endregion
 //#region src/version/project.d.ts
 export type VersionFileKind = "gradle" | "pbxproj" | "app-json5" | "pubspec" | "package-json" | "tauri" | "expo-app-json";
 export interface PlatformVersionInfo {
@@ -579,6 +628,18 @@ export declare function commitsSince(cwd: string, ref?: string): string[];
 /** 工作区状态（--porcelain）。注意：不走通用 git()——其 stdout.trim() 会剥掉首行前导空格，
  *  破坏 porcelain 的两列状态位（" M file" → "M file"），此处保留原始行仅去行尾。 */
 export declare function statusShort(cwd: string): string[];
+export interface TagResult {
+  tagged: boolean;
+  reason?: string;
+}
+/**
+ * release 分发成功后补 tag（tag = 实际已发布的正式版本；beta 不打 tag，追溯走 history）。
+ * - tag 已存在（多端发布，前一端已打）→ 跳过
+ * - dryRun / 无版本 / 非 git 仓库 → 不动、不炸（tag 失败不阻断发布主流程）
+ */
+export declare function tagReleaseVersion(cwd: string, version: string | undefined, opts?: {
+  dryRun?: boolean;
+}): TagResult;
 //#endregion
 //#region src/version/artifact.d.ts
 export interface ArtifactVersion {
@@ -589,4 +650,4 @@ export interface ArtifactVersion {
 }
 export declare function readArtifactVersion(artifactPath: string): ArtifactVersion | undefined;
 //#endregion
-export { BetaConfig, BetaConfigSchema, BundleIds, Channel, ChannelCapabilities, ChannelContext, ChannelEvent, ChannelRegistry, CredentialsFile, CredentialsFileSchema, CredentialsProfile, CredentialsProfileSchema, FrameworkAdapter, GlobalConfig, GlobalConfigSchema, HISTORY_PATH, HistoryEntry, HistoryEvent, HistoryQuery, HookContext, PipelineInput, PipelineSummary, PipelineSummaryEntry, Platform, PluginHookName, PluginHost, ProjectConfig, ProjectConfigSchema, QypubPlugin, QypubUserConfig, ReleaseConfig, ReleaseConfigSchema, ReleasePlanEntry, ReviewStatus, StageResult, StoreConfig, StoreConfigSchema, Stores, StoresSchema, SubmitResult, VersionCodeConfig, VersionCodeConfigSchema, VersionConfig, VersionConfigSchema, appendEntry, defineConfig, detectBundleIds, detectFramework, electronAdapter, findArtifacts, flutterAdapter, nativeAndroidAdapter, nativeHarmonyAdapter, nativeIosAdapter, readEntries, resolvePlugins, rnAdapter, runStage, runSubmit, tauriAdapter };
+export { AppliftPlugin, AppliftUserConfig, BetaConfig, BetaConfigSchema, BundleIds, Channel, ChannelCapabilities, ChannelContext, ChannelEvent, ChannelRegistry, CredentialsFile, CredentialsFileSchema, CredentialsProfile, CredentialsProfileSchema, DeliveryJudgement, DeliveryRoute, FrameworkAdapter, FrameworkContext, GlobalConfig, GlobalConfigSchema, HISTORY_PATH, HistoryEntry, HistoryEvent, HistoryQuery, HookContext, PipelineInput, PipelineSummary, PipelineSummaryEntry, Platform, PluginHookName, PluginHost, ProjectConfig, ProjectConfigSchema, PublishContext, ReleasePlanEntry, ReviewStatus, StageResult, StoreConfig, StoreConfigSchema, Stores, StoresSchema, SubmitResult, UpdateProvider, VersionCodeConfig, VersionCodeConfigSchema, VersionConfig, VersionConfigSchema, appendEntry, collectReleaseDiff, defineConfig, deps, detectBundleIds, electronAdapter, electronFramework, findArtifacts, flutterAdapter, flutterFramework, knownFrameworkAdapters, nativeAndroidAdapter, nativeAndroidFramework, nativeHarmonyAdapter, nativeHarmonyFramework, nativeIosAdapter, nativeIosFramework, readEntries, readJson, resolveFramework, resolvePlugins, rnAdapter, rnFramework, routeDelivery, runStage, runSubmit, subdirs, suggestFramework, tauriAdapter, tauriFramework };