@morehao/dsh-github-trending 0.4.4 → 0.5.0

package/lib/internal.d.ts

@@ -1,4 +1,4 @@
-import { ErrorCode, FileArtifact, ErrorInfo, RunRequest, RunResult, State, StateRun } from '@morehao/trendradar-contract';
+import { ErrorCode, FileArtifact, Usage, ReleasesReport, ErrorInfo, RunRequest, RunResult, State, StateRun, SubscriptionList } from '@morehao/trendradar-contract';
 import http from 'node:http';
 import { Updater, PluginMeta, Logger } from '@morehao/dsh-plugin-kit/update';
 
@@ -13,7 +13,7 @@ import { Updater, PluginMeta, Logger } from '@morehao/dsh-plugin-kit/update';
  */
 
 /** 插件在核心之外新增的码。前缀统一避免与核心码冲突。 */
-declare const PLUGIN_CODES: readonly ["CORE_UNAVAILABLE", "CORE_INCOMPATIBLE", "CORE_SPAWN_FAILED", "CORE_TIMEOUT", "CORE_CANCELLED", "CORE_CONFIG_CHANNEL_FAILED", "CORE_NOT_DOWNLOADED", "CORE_CHECKSUM_MISMATCH", "IPC_INVALID", "MODEL_KEY_MISSING", "MODEL_NOT_FOUND", "MODEL_PROVIDER_UNSUPPORTED", "GITHUB_AUTH", "PUSH_FAILED", "REPO_DIRTY"];
+declare const PLUGIN_CODES: readonly ["CORE_UNAVAILABLE", "CORE_INCOMPATIBLE", "CORE_SPAWN_FAILED", "CORE_TIMEOUT", "CORE_CANCELLED", "CORE_CONFIG_CHANNEL_FAILED", "CORE_NOT_DOWNLOADED", "CORE_CHECKSUM_MISMATCH", "IPC_INVALID", "MODEL_KEY_MISSING", "MODEL_NOT_FOUND", "MODEL_PROVIDER_UNSUPPORTED", "GITHUB_AUTH", "PUSH_FAILED", "REPO_DIRTY", "SUBSCRIBE_FAILED"];
 type PluginCode = (typeof PLUGIN_CODES)[number];
 type AnyCode = ErrorCode | PluginCode;
 interface ClassifiedError {
@@ -101,6 +101,10 @@ interface RunOutcome {
     prUrl?: string;
     /** 核心给出的跳过原因：merged | pr-closed | unchanged（可选，旧核心没有）。 */
     skipReason?: string;
+    /** 榜单阶段 token 用量（契约 Usage，可选；旧核心没有）。不拆维度，只取 totalTokens。 */
+    usage?: Usage;
+    /** 发版订阅阶段报告（契约 ReleasesReport，可选；旧核心/releases.enabled=false 时没有）。 */
+    releases?: ReleasesReport;
     error?: RunError;
     warnings: string[];
     startedAt: string;
@@ -135,6 +139,26 @@ interface ParseRunOptions {
  * 当成功写进状态。
  */
 declare function parseRunResult(text: string, options: ParseRunOptions): RunOutcome;
+/** 订阅命令的结果：list 带回 repos，add/remove 只看 ok/error。 */
+interface SubscribeOutcome {
+    ok: boolean;
+    repos: string[];
+    error?: RunError;
+}
+/** 订阅命令的一个动作（契约 `RunRequest.action`）。 */
+type SubscribeAction = 'list' | 'add' | 'remove';
+/**
+ * 解析核心 `subscribe --json` 的 stdout。
+ *
+ * 核心先由 `runSubscribe` 把 `list` 的结果**逐行**打到 stdout（每行一个 owner/repo），
+ * 再由 `emitSubscribeResult` 把契约 RunResult 信封打到 stdout（`command:"subscribe"`，
+ * 只带 `ok/error`，**不含 repos**）。因此：
+ *   - 信封是**最后一段 JSON**；它前面的非空行才是 list 的仓库列表；
+ *   - 信封 `command` 是 `"subscribe"`（不在契约 RunResult 枚举里，故不能直接用
+ *     `validators.runResult` 校验），这里只按 envelope 必需字段做轻量校验。
+ * 任何形状不对都抛 `IPC_INVALID`：订阅结果读错会把失败当成功。
+ */
+declare function parseSubscribeResult(text: string): SubscribeOutcome;
 
 declare const ipc_ErrorCode: typeof ErrorCode;
 declare const ipc_ErrorInfo: typeof ErrorInfo;
@@ -143,6 +167,7 @@ declare const ipc_IPC_SCHEMA_VERSION: typeof IPC_SCHEMA_VERSION;
 type ipc_IpcError = IpcError;
 declare const ipc_IpcError: typeof IpcError;
 type ipc_ParseRunOptions = ParseRunOptions;
+declare const ipc_ReleasesReport: typeof ReleasesReport;
 type ipc_RunError = RunError;
 type ipc_RunOutcome = RunOutcome;
 declare const ipc_RunRequest: typeof RunRequest;
@@ -151,13 +176,18 @@ declare const ipc_SUPPORTED_CONTRACT_MAJOR: typeof SUPPORTED_CONTRACT_MAJOR;
 declare const ipc_SUPPORTED_DIGEST_SCHEMA: typeof SUPPORTED_DIGEST_SCHEMA;
 declare const ipc_State: typeof State;
 declare const ipc_StateRun: typeof StateRun;
+type ipc_SubscribeAction = SubscribeAction;
+type ipc_SubscribeOutcome = SubscribeOutcome;
+declare const ipc_SubscriptionList: typeof SubscriptionList;
+declare const ipc_Usage: typeof Usage;
 type ipc_VersionInfo = VersionInfo;
 declare const ipc_isVersionInfo: typeof isVersionInfo;
 declare const ipc_parseJsonObject: typeof parseJsonObject;
 declare const ipc_parseRunResult: typeof parseRunResult;
+declare const ipc_parseSubscribeResult: typeof parseSubscribeResult;
 declare const ipc_parseVersionInfo: typeof parseVersionInfo;
 declare namespace ipc {
-  export { ipc_ErrorCode as ErrorCode, ipc_ErrorInfo as ErrorInfo, ipc_FileArtifact as FileArtifact, ipc_IPC_SCHEMA_VERSION as IPC_SCHEMA_VERSION, ipc_IpcError as IpcError, type ipc_ParseRunOptions as ParseRunOptions, type ipc_RunError as RunError, type ipc_RunOutcome as RunOutcome, ipc_RunRequest as RunRequest, ipc_RunResult as RunResult, ipc_SUPPORTED_CONTRACT_MAJOR as SUPPORTED_CONTRACT_MAJOR, ipc_SUPPORTED_DIGEST_SCHEMA as SUPPORTED_DIGEST_SCHEMA, ipc_State as State, ipc_StateRun as StateRun, type ipc_VersionInfo as VersionInfo, ipc_isVersionInfo as isVersionInfo, ipc_parseJsonObject as parseJsonObject, ipc_parseRunResult as parseRunResult, ipc_parseVersionInfo as parseVersionInfo };
+  export { ipc_ErrorCode as ErrorCode, ipc_ErrorInfo as ErrorInfo, ipc_FileArtifact as FileArtifact, ipc_IPC_SCHEMA_VERSION as IPC_SCHEMA_VERSION, ipc_IpcError as IpcError, type ipc_ParseRunOptions as ParseRunOptions, ipc_ReleasesReport as ReleasesReport, type ipc_RunError as RunError, type ipc_RunOutcome as RunOutcome, ipc_RunRequest as RunRequest, ipc_RunResult as RunResult, ipc_SUPPORTED_CONTRACT_MAJOR as SUPPORTED_CONTRACT_MAJOR, ipc_SUPPORTED_DIGEST_SCHEMA as SUPPORTED_DIGEST_SCHEMA, ipc_State as State, ipc_StateRun as StateRun, type ipc_SubscribeAction as SubscribeAction, type ipc_SubscribeOutcome as SubscribeOutcome, ipc_SubscriptionList as SubscriptionList, ipc_Usage as Usage, type ipc_VersionInfo as VersionInfo, ipc_isVersionInfo as isVersionInfo, ipc_parseJsonObject as parseJsonObject, ipc_parseRunResult as parseRunResult, ipc_parseSubscribeResult as parseSubscribeResult, ipc_parseVersionInfo as parseVersionInfo };
 }
 
 type Provider = string;
@@ -174,6 +204,7 @@ type Since = Period;
 /** 规范顺序（索引分组、去重、UI 展示都以它为准）。 */
 declare const PERIODS: readonly Period[];
 declare function isPeriod(value: unknown): value is Period;
+declare function isEnrich(value: unknown): value is Enrich;
 interface ModelSettings {
     provider: Provider;
     /** `direct` = 密钥经配置通道直传核心；`proxy` = 宿主 provider 无可导出密钥，走回环代理。 */
@@ -214,6 +245,38 @@ interface TrendingSettings {
 interface OutputSettings {
     dir: string;
 }
+/** 摘要生成的外部上下文增强选项（核心 `summarize.enrich`）。 */
+type Enrich = 'none' | 'repo' | 'readme';
+/**
+ * 摘要与用量阶段参数（核心 `summarize.*`）。
+ * 只映射核心真实字段；插件不加核心没有的开关（不造「点了没反应」的配置）。
+ */
+interface SummarizeSettings {
+    batchSize: number;
+    maxRetries: number;
+    enrich: Enrich;
+    readmeChars: number;
+    enrichCacheTTLHours: number;
+    enrichConcurrency: number;
+    enrichTimeoutSeconds: number;
+    enrichBudgetSeconds: number;
+}
+/**
+ * 发版订阅阶段的行为开关（核心 `releases.*`）。
+ * **订阅列表本身不落 settings.json**：它版本化在数据仓 `<output.dir>/subscriptions.yaml`，
+ * 经核心 `subscribe` IPC 读改。这里只放全局行为旋钮。
+ */
+interface ReleasesSettings {
+    enabled: boolean;
+    includePrerelease: boolean;
+    includeDrafts: boolean;
+    fallbackToTags: boolean;
+    baselineOnFirstRun: boolean;
+    perRepoLimit: number;
+    maxNotesChars: number;
+    /** 发版摘要周期，独立默认 daily，不与 trending.since 联动。 */
+    period: Period;
+}
 interface ScheduleSettings {
     enabled: boolean;
     /** `HH:MM:SS`（本地墙钟，按 timezone 解释）。 */
@@ -233,6 +296,8 @@ interface Settings {
     pr: PRSettings;
     github: GithubSettings;
     trending: TrendingSettings;
+    summarize: SummarizeSettings;
+    releases: ReleasesSettings;
     output: OutputSettings;
     schedule: ScheduleSettings;
     /** 核心二进制覆盖；只在开发/排障时用，对应 TRENDING_DIGEST_CORE。 */
@@ -245,7 +310,7 @@ declare const DEFAULT_SETTINGS: Settings;
 declare const PROVIDER_BASE_URLS: Record<string, string>;
 declare const CORE_PROVIDERS: readonly ["deepseek", "openai-compatible"];
 /** 设置页分区；分段保存时只提交并校验对应分区，互不牵连。 */
-declare const SETTINGS_SECTIONS: readonly ["source", "model", "repo", "auth", "scope", "schedule"];
+declare const SETTINGS_SECTIONS: readonly ["source", "model", "repo", "auth", "scope", "summarize", "releases", "schedule"];
 type SettingsSection = (typeof SETTINGS_SECTIONS)[number];
 /** 校验问题字段 → 所属分区（用于分段保存时只把本分区的问题回给界面）。 */
 declare function sectionOfField(field: string): SettingsSection | undefined;
@@ -301,6 +366,26 @@ interface CoreConfig {
         since: string;
         perLanguage: number;
     };
+    summarize: {
+        batchSize: number;
+        maxRetries: number;
+        enrich: string;
+        readmeChars: number;
+        enrichCacheTTLHours: number;
+        enrichConcurrency: number;
+        enrichTimeoutSeconds: number;
+        enrichBudgetSeconds: number;
+    };
+    releases: {
+        enabled: boolean;
+        includePrerelease: boolean;
+        includeDrafts: boolean;
+        fallbackToTags: boolean;
+        baselineOnFirstRun: boolean;
+        perRepoLimit: number;
+        maxNotesChars: number;
+        period: string;
+    };
     output: {
         dir: string;
         branchPrefix: string;
@@ -325,6 +410,7 @@ declare const config_CORE_PROVIDERS: typeof CORE_PROVIDERS;
 type config_CommitMode = CommitMode;
 type config_CoreConfig = CoreConfig;
 declare const config_DEFAULT_SETTINGS: typeof DEFAULT_SETTINGS;
+type config_Enrich = Enrich;
 type config_GithubSettings = GithubSettings;
 type config_ModelSettings = ModelSettings;
 type config_OutputSettings = OutputSettings;
@@ -334,14 +420,17 @@ type config_PRSettings = PRSettings;
 type config_Period = Period;
 type config_Problem = Problem;
 type config_Provider = Provider;
+type config_ReleasesSettings = ReleasesSettings;
 type config_RepoSettings = RepoSettings;
 declare const config_SETTINGS_SECTIONS: typeof SETTINGS_SECTIONS;
 type config_ScheduleSettings = ScheduleSettings;
 type config_Settings = Settings;
 type config_SettingsSection = SettingsSection;
 type config_Since = Since;
+type config_SummarizeSettings = SummarizeSettings;
 type config_TrendingSettings = TrendingSettings;
 declare const config_effectiveBaseURL: typeof effectiveBaseURL;
+declare const config_isEnrich: typeof isEnrich;
 declare const config_isPeriod: typeof isPeriod;
 declare const config_isValidTimezone: typeof isValidTimezone;
 declare const config_mergeSettingsSection: typeof mergeSettingsSection;
@@ -351,7 +440,7 @@ declare const config_toCoreConfig: typeof toCoreConfig;
 declare const config_toYaml: typeof toYaml;
 declare const config_validateSettings: typeof validateSettings;
 declare namespace config {
-  export { type config_AuthMode as AuthMode, config_CORE_PROVIDERS as CORE_PROVIDERS, type config_CommitMode as CommitMode, type config_CoreConfig as CoreConfig, config_DEFAULT_SETTINGS as DEFAULT_SETTINGS, type config_GithubSettings as GithubSettings, type config_ModelSettings as ModelSettings, type config_OutputSettings as OutputSettings, config_PERIODS as PERIODS, config_PROVIDER_BASE_URLS as PROVIDER_BASE_URLS, type config_PRSettings as PRSettings, type config_Period as Period, type config_Problem as Problem, type config_Provider as Provider, type config_RepoSettings as RepoSettings, config_SETTINGS_SECTIONS as SETTINGS_SECTIONS, type config_ScheduleSettings as ScheduleSettings, type config_Settings as Settings, type config_SettingsSection as SettingsSection, type config_Since as Since, type config_TrendingSettings as TrendingSettings, config_effectiveBaseURL as effectiveBaseURL, config_isPeriod as isPeriod, config_isValidTimezone as isValidTimezone, config_mergeSettingsSection as mergeSettingsSection, config_normalizeSettings as normalizeSettings, config_sectionOfField as sectionOfField, config_toCoreConfig as toCoreConfig, config_toYaml as toYaml, config_validateSettings as validateSettings };
+  export { type config_AuthMode as AuthMode, config_CORE_PROVIDERS as CORE_PROVIDERS, type config_CommitMode as CommitMode, type config_CoreConfig as CoreConfig, config_DEFAULT_SETTINGS as DEFAULT_SETTINGS, type config_Enrich as Enrich, type config_GithubSettings as GithubSettings, type config_ModelSettings as ModelSettings, type config_OutputSettings as OutputSettings, config_PERIODS as PERIODS, config_PROVIDER_BASE_URLS as PROVIDER_BASE_URLS, type config_PRSettings as PRSettings, type config_Period as Period, type config_Problem as Problem, type config_Provider as Provider, type config_ReleasesSettings as ReleasesSettings, type config_RepoSettings as RepoSettings, config_SETTINGS_SECTIONS as SETTINGS_SECTIONS, type config_ScheduleSettings as ScheduleSettings, type config_Settings as Settings, type config_SettingsSection as SettingsSection, type config_Since as Since, type config_SummarizeSettings as SummarizeSettings, type config_TrendingSettings as TrendingSettings, config_effectiveBaseURL as effectiveBaseURL, config_isEnrich as isEnrich, config_isPeriod as isPeriod, config_isValidTimezone as isValidTimezone, config_mergeSettingsSection as mergeSettingsSection, config_normalizeSettings as normalizeSettings, config_sectionOfField as sectionOfField, config_toCoreConfig as toCoreConfig, config_toYaml as toYaml, config_validateSettings as validateSettings };
 }
 
 declare const PLUGIN_DIR_NAME = "github-trending";
@@ -432,9 +521,26 @@ interface RunRecord {
     languages: string[];
     warnings: string[];
     logFile?: string;
+    /**
+     * 本次任务 token 总量（= usage.totalTokens + releases.usage.totalTokens，含订阅阶段）。
+     * 两个来源都缺省时该字段缺省（历史显示 `—`）。不拆维度。
+     */
+    tokens?: number;
+    /** 发版订阅阶段摘要（只存展示需要的字段）；未启用/旧核心则缺省。 */
+    releases?: ReleasesSummary;
     /** true = 契约 v1 时代留下的旧记录（contentHash 算法不同，不可与 v2 比较）。 */
     legacy?: boolean;
 }
+/** 发版订阅阶段在历史里保留的展示字段（来自契约 `ReleasesReport`）。 */
+interface ReleasesSummary {
+    enabled: boolean;
+    repos: number;
+    newReleases: number;
+    summarized?: number;
+    degraded?: number;
+    failed?: number;
+    skipped?: number;
+}
 interface PendingPr {
     url: string;
     createdAt: string;
@@ -508,6 +614,11 @@ declare class Store {
 }
 /** 运行 id：时间前缀便于按时间排序，随机后缀避免同毫秒撞车。 */
 declare function newRunId(now?: Date): string;
+/**
+ * 历史里全部运行的 token 累计（不落盘，读时求和）。
+ * 缺省 `tokens` 的旧记录按 0 计；全部都没有则返回 undefined（界面显示 `—`）。
+ */
+declare function sumTokens(records: readonly RunRecord[]): number | undefined;
 
 declare const state_CONTENT_HASH_ALGO_V2: typeof CONTENT_HASH_ALGO_V2;
 type state_DigestIdentity = DigestIdentity;
@@ -519,14 +630,16 @@ declare const state_PREVIEW_MAX_BYTES: typeof PREVIEW_MAX_BYTES;
 type state_PendingPr = PendingPr;
 type state_PluginState = PluginState;
 type state_PreviewMeta = PreviewMeta;
+type state_ReleasesSummary = ReleasesSummary;
 type state_RunRecord = RunRecord;
 type state_Store = Store;
 declare const state_Store: typeof Store;
 type state_StoreOptions = StoreOptions;
 declare const state_newRunId: typeof newRunId;
+declare const state_sumTokens: typeof sumTokens;
 declare const state_writeJsonAtomic: typeof writeJsonAtomic;
 declare namespace state {
-  export { state_CONTENT_HASH_ALGO_V2 as CONTENT_HASH_ALGO_V2, type state_DigestIdentity as DigestIdentity, state_HISTORY_LIMIT as HISTORY_LIMIT, type state_HistoryFile as HistoryFile, type state_LegacyMigrationResult as LegacyMigrationResult, state_PREVIEW_LIMIT as PREVIEW_LIMIT, state_PREVIEW_MAX_BYTES as PREVIEW_MAX_BYTES, type state_PendingPr as PendingPr, type state_PluginState as PluginState, type state_PreviewMeta as PreviewMeta, type state_RunRecord as RunRecord, state_Store as Store, type state_StoreOptions as StoreOptions, state_newRunId as newRunId, state_writeJsonAtomic as writeJsonAtomic };
+  export { state_CONTENT_HASH_ALGO_V2 as CONTENT_HASH_ALGO_V2, type state_DigestIdentity as DigestIdentity, state_HISTORY_LIMIT as HISTORY_LIMIT, type state_HistoryFile as HistoryFile, type state_LegacyMigrationResult as LegacyMigrationResult, state_PREVIEW_LIMIT as PREVIEW_LIMIT, state_PREVIEW_MAX_BYTES as PREVIEW_MAX_BYTES, type state_PendingPr as PendingPr, type state_PluginState as PluginState, type state_PreviewMeta as PreviewMeta, type state_ReleasesSummary as ReleasesSummary, type state_RunRecord as RunRecord, state_Store as Store, type state_StoreOptions as StoreOptions, state_newRunId as newRunId, state_sumTokens as sumTokens, state_writeJsonAtomic as writeJsonAtomic };
 }
 
 interface CoreRelease {
@@ -728,6 +841,8 @@ interface ExecOptions {
     signal?: AbortSignal;
     maxStdout?: number;
     maxStderr?: number;
+    /** 写入子进程 stdin 的内容（写完即关闭）；省略则 stdin 为 ignore。 */
+    input?: string;
 }
 /**
  * 执行一次短命令并收集输出（握手、共存探测都走这里）。
@@ -1245,6 +1360,10 @@ interface RunSummary {
     logFile?: string;
     channel?: 'fifo' | 'tmpfile';
     proxy?: boolean;
+    /** 本次任务 token 总量（榜单 + 订阅阶段，含订阅）；两者都缺省则缺省。 */
+    tokens?: number;
+    /** 发版订阅阶段摘要；未启用/旧核心则缺省。 */
+    releases?: ReleasesSummary;
     /** 核心从哪来：env/settings 覆盖、缓存、还是本次下载。 */
     coreSource?: 'settings' | 'env' | 'cache' | 'download';
     coreTag?: string;
@@ -1272,6 +1391,16 @@ interface RunnerDeps {
  */
 declare function isoWeekName(date: string): string;
 declare function periodFileBase(period: Period, date: string): string;
+/**
+ * 从契约 `RunOutcome` 投影出「token 总量」与「发版摘要」：
+ * - `tokens` = usage.totalTokens + releases.usage.totalTokens（含订阅阶段）；
+ *   两个来源都缺省则 `tokens` 缺省（历史显示 `—`）。
+ * - `releases` 只在 outcome 带 `releases` 块时才有（旧核心或 enabled=false 都无）。
+ */
+declare function projectUsage(outcome: RunOutcome): {
+    tokens?: number;
+    releases?: ReleasesSummary;
+};
 declare class Runner {
     private active;
     /** 批量运行（一次触发跑多个周期）期间为 true，挡住外部并发触发。 */
@@ -1316,8 +1445,35 @@ declare const runner_Runner: typeof Runner;
 type runner_RunnerDeps = RunnerDeps;
 declare const runner_isoWeekName: typeof isoWeekName;
 declare const runner_periodFileBase: typeof periodFileBase;
+declare const runner_projectUsage: typeof projectUsage;
 declare namespace runner {
-  export { type runner_RunRequestOptions as RunRequestOptions, type runner_RunSummary as RunSummary, runner_Runner as Runner, type runner_RunnerDeps as RunnerDeps, runner_isoWeekName as isoWeekName, runner_periodFileBase as periodFileBase };
+  export { type runner_RunRequestOptions as RunRequestOptions, type runner_RunSummary as RunSummary, runner_Runner as Runner, type runner_RunnerDeps as RunnerDeps, runner_isoWeekName as isoWeekName, runner_periodFileBase as periodFileBase, runner_projectUsage as projectUsage };
+}
+
+/** 订阅命令超时：核心只做一次 GitHub 请求/本地文件读写，8 s 足够。 */
+declare const SUBSCRIBE_TIMEOUT_MS = 8000;
+declare function isValidRepo(repo: string): boolean;
+interface SubscribeDeps {
+    store: Store;
+    env?: NodeJS.ProcessEnv;
+    /** 测试注入：跳过 locateCore，直接用给定二进制。 */
+    corePath?: string;
+}
+/**
+ * 执行一次 subscribe 命令：`action=list` 读列表，`add/remove` 改 pending 队列。
+ * 返回 `{ ok, repos, error? }`；非 ok 由调用方（路由）决定转成 `SUBSCRIBE_FAILED`。
+ */
+declare function runSubscribe(input: {
+    action: SubscribeAction;
+    repo?: string;
+}, deps: SubscribeDeps): Promise<SubscribeOutcome>;
+
+declare const subscribe_SUBSCRIBE_TIMEOUT_MS: typeof SUBSCRIBE_TIMEOUT_MS;
+type subscribe_SubscribeDeps = SubscribeDeps;
+declare const subscribe_isValidRepo: typeof isValidRepo;
+declare const subscribe_runSubscribe: typeof runSubscribe;
+declare namespace subscribe {
+  export { subscribe_SUBSCRIBE_TIMEOUT_MS as SUBSCRIBE_TIMEOUT_MS, type subscribe_SubscribeDeps as SubscribeDeps, subscribe_isValidRepo as isValidRepo, subscribe_runSubscribe as runSubscribe };
 }
 
 interface PluginInfo {
@@ -1596,12 +1752,16 @@ declare function createTrendingRunTool(runner: Runner): {
         errorCode?: string | undefined;
         errorMessage?: string | undefined;
         errorHint?: string | undefined;
+        warnings: string[];
+        tokens: number;
         ok: boolean;
         summaries: {
             errorCode?: string | undefined;
             errorMessage?: string | undefined;
             prUrl?: string | undefined;
             branch?: string | undefined;
+            releases?: ReleasesSummary | undefined;
+            tokens?: number | undefined;
             id: string;
             period: Period | undefined;
             ok: boolean;
@@ -1615,7 +1775,34 @@ declare function createTrendingRunTool(runner: Runner): {
         dryRun: boolean;
         durationMs: number;
         files: number;
+    } | {
+        markdown: string;
+        errorCode?: string | undefined;
+        errorMessage?: string | undefined;
+        errorHint?: string | undefined;
         warnings: string[];
+        tokens?: undefined;
+        ok: boolean;
+        summaries: {
+            errorCode?: string | undefined;
+            errorMessage?: string | undefined;
+            prUrl?: string | undefined;
+            branch?: string | undefined;
+            releases?: ReleasesSummary | undefined;
+            tokens?: number | undefined;
+            id: string;
+            period: Period | undefined;
+            ok: boolean;
+            skipped: boolean;
+            dryRun: boolean;
+            durationMs: number;
+            files: number;
+        }[];
+        id: string | undefined;
+        skipped: boolean;
+        dryRun: boolean;
+        durationMs: number;
+        files: number;
     }>;
 };
 declare function createTrendingHistoryTool(store: Store, scheduler: Scheduler): {
@@ -1719,4 +1906,4 @@ declare namespace tools {
   export { tools_createTrendingHistoryTool as createTrendingHistoryTool, tools_createTrendingRunTool as createTrendingRunTool };
 }
 
-export { channel, config, core, credentials, errors, exec, github, handshake$1 as handshake, importCli, ipc, locate, paths, pendingPr, pluginInfo, preflight, proxy, quickfill, release, repo, routes, run, runner, schedule, state, tools, update as updateService };
+export { channel, config, core, credentials, errors, exec, github, handshake$1 as handshake, importCli, ipc, locate, paths, pendingPr, pluginInfo, preflight, proxy, quickfill, release, repo, routes, run, runner, schedule, state, subscribe, tools, update as updateService };

package/lib/internal.js

@@ -22,12 +22,13 @@ import {
   runner_exports,
   schedule_exports,
   state_exports,
+  subscribe_exports,
   tools_exports,
   update_exports
-} from "./chunk-GBXP2NGW.js";
+} from "./chunk-WFCULY72.js";
 import {
   exec_exports
-} from "./chunk-XLIFTAVL.js";
+} from "./chunk-R7BK7SJK.js";
 export {
   channel_exports as channel,
   config_exports as config,
@@ -53,6 +54,7 @@ export {
   runner_exports as runner,
   schedule_exports as schedule,
   state_exports as state,
+  subscribe_exports as subscribe,
   tools_exports as tools,
   update_exports as updateService
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morehao/dsh-github-trending",
-  "version": "0.4.4",
+  "version": "0.5.0",
   "description": "GitHub 趋势日报插件：每天定时 spawn 本地 trendradar 核心，抓取 Trending、生成中文简介与总结，提交到你的仓库并自动合并 PR。",
   "type": "module",
   "main": "lib/index.js",
@@ -51,7 +51,7 @@
   },
   "dependencies": {
     "@morehao/dsh-plugin-kit": "0.1.0",
-    "@morehao/trendradar-contract": "0.2.0"
+    "@morehao/trendradar-contract": "0.3.0"
   },
   "dsh": {
     "bundle": {
@@ -59,7 +59,7 @@
     },
     "core": {
       "repo": "morehao/trendradar",
-      "version": "0.4.0"
+      "version": "0.6.0"
     },
     "client": {
       "platform": "web",