@dsh-plus/agent-preset-rea 0.1.1 → 0.1.2

package/lib/index.d.ts

@@ -11,7 +11,12 @@ declare const Config: z<Schemastery.ObjectS<NoInfer<{
   description: z<string, string, "defined">;
   order: z<number, number, "defined">;
   personaPrefix: z<string, string, "volatile-defined">;
-  mcpEnabled: z<boolean, boolean, "defined">;
+  mcpEnabled: z<boolean, boolean, "volatile-defined">;
+  skillEnabled: z<boolean, boolean, "volatile-defined">;
+  reverseSkillEnabled: z<boolean, boolean, "volatile-defined">;
+  reverseSkillRepo: z<string, string, "defined">;
+  reverseSkillRef: z<string, string, "defined">;
+  reverseSkillGroups: z<string[], string[], "defined">;
   mcpServerName: z<string, string, "defined">;
   reaVersion: z<string, string, "defined">;
   installRoot: z<string, string, "defined">;
@@ -29,7 +34,12 @@ declare const Config: z<Schemastery.ObjectS<NoInfer<{
   description: z<string, string, "defined">;
   order: z<number, number, "defined">;
   personaPrefix: z<string, string, "volatile-defined">;
-  mcpEnabled: z<boolean, boolean, "defined">;
+  mcpEnabled: z<boolean, boolean, "volatile-defined">;
+  skillEnabled: z<boolean, boolean, "volatile-defined">;
+  reverseSkillEnabled: z<boolean, boolean, "volatile-defined">;
+  reverseSkillRepo: z<string, string, "defined">;
+  reverseSkillRef: z<string, string, "defined">;
+  reverseSkillGroups: z<string[], string[], "defined">;
   mcpServerName: z<string, string, "defined">;
   reaVersion: z<string, string, "defined">;
   installRoot: z<string, string, "defined">;
@@ -76,17 +86,83 @@ interface JobOperation {
   phases: string[];
   run(ctx: JobTaskContext): Promise<string>;
 }
+/** 作业依赖：生效配置、命令执行面、作业完成后的现探刷新。 */
+interface JobDeps {
+  config: AgentPresetReaConfig;
+  runner: CommandRunner;
+  refresh(): void;
+}
 /** 实际 runner：spawn 子进程、逐行回调、AbortSignal 触发即杀。 */
 declare const spawnRunner: CommandRunner;
-/**
- * npm 子进程环境：继承宿主环境，附带代理端口（port > 0 时同时给 npm 与
- * prebuild-install 注入代理——后者只认 `https_proxy` 系列环境变量，
- * 这是原生依赖 prebuild 下载卡死的正解）。
- */
+/** npm 子进程环境（{@link commandEnv} 的 npm 形态）。 */
 declare function npmEnv(config: AgentPresetReaConfig): Record<string, string>;
 /** 版本收窄：进命令前把配置里的钉版校验成纯版本号。 */
 declare function safeVersion(version: string): string;
 //#endregion
+//#region src/reverse.d.ts
+/** 本技能源在插件数据目录下的子目录名。 */
+declare const REVERSE_DIR = "reverse-skill";
+/** 仓库树目录名（换目录作业的替换单元是它的父目录）。 */
+declare const REVERSE_TREE_DIR = "repo";
+/** 默认仓库。 */
+declare const REVERSE_DEFAULT_REPO = "zhaoxuya520/reverse-skill";
+/** 手动更新作业阶段名。 */
+declare const REVERSE_PHASES: string[];
+/** 受管路径。 */
+interface ReversePaths {
+  /** 技能源根（`repo/` 与 `manifest.json` 的父目录）。 */
+  root: string;
+  /** 仓库树根。 */
+  tree: string;
+}
+/** 清单（溯源事实；sha 已是内容级溯源，故不再逐文件复算哈希）。 */
+interface ReverseManifest {
+  source: string;
+  repo: string;
+  /** 配置里的 ref（空串 = 仓库默认分支）。 */
+  ref: string;
+  /** GitHub 机构 API 解析到的提交 sha。 */
+  sha: string;
+  /** 仓库 `VERSION` 文件内容（无则 null）。 */
+  version: string | null;
+  /** 树内文件数。 */
+  files: number;
+  /** 树内发现的技能组（相对路径）。 */
+  groups: string[];
+  updatedAt: string;
+}
+/** 技能源现状。 */
+interface ReverseState {
+  installed: boolean;
+  repo: string;
+  ref: string | null;
+  sha: string | null;
+  version: string | null;
+  files: number;
+  /** 树内发现的全部技能组（相对路径）。 */
+  groups: string[];
+  updatedAt: string | null;
+}
+/** 受管路径（固定落插件数据目录，无部署方可调项）。 */
+declare function reversePaths(): ReversePaths;
+/** 发现树内的技能组：直接子目录带 SKILL.md 的目录（排除树根与 SKIP_DIRS）。 */
+declare function discoverSkillGroups(tree: string): string[];
+/** 现探技能源（清单可读 + 树在 + 至少一个技能组才算可用）。 */
+declare function probeReverse(config: AgentPresetReaConfig, repo?: string): ReverseState;
+/**
+ * 挂进本预设的技能组目录：配置选中 ∩ 树内发现。
+ *
+ * 组是否真实存在由现探的 {@link discoverSkillGroups} 负责（发现即存在），这里不再
+ * 二次查盘——否则「未安装/组缺席」两种语义会在两处各判一遍。
+ * @param config - 插件配置。
+ * @param state - 现探现状。
+ */
+declare function reverseSkillDirs(config: AgentPresetReaConfig, state: ReverseState): string[];
+/** 作业依赖（与 manager 的作业同形：配置 + 命令执行面 + 现探刷新）。 */
+type ReverseDeps = JobDeps;
+/** 手动更新作业：拉默认分支/指定 ref 的最新提交，解包后换目录并写清单。 */
+declare function runReverseSkillJob(deps: ReverseDeps, ctx: JobTaskContext): Promise<string>;
+//#endregion
 //#region src/manager.d.ts
 /** npm 包名。 */
 declare const REA_PACKAGE = "rea-agents";
@@ -119,6 +195,8 @@ interface SkillState {
 interface RuntimeSnapshot {
   install: ReaInstall | null;
   skill: SkillState;
+  /** GitHub 技能源（zhaoxuya520/reverse-skill）现状。 */
+  reverse: ReverseState;
 }
 /** skill 清单（与随包夹具同形；更新副本多写入 updatedAt）。 */
 interface SkillManifest {
@@ -146,10 +224,11 @@ interface ReaManager {
   snapshot(): RuntimeSnapshot;
   /** 重新现探并更新快照（作业完成、volatile 变更后调用）。 */
   refresh(): RuntimeSnapshot;
-  /** 受管作业（安装/更新 REA 包、更新 skill）。 */
+  /** 受管作业（安装/更新 REA 包、更新 REA skill、更新 reverse-skill）。 */
   operations(overrides?: JobOverrides): {
     install: JobOperation;
     skill: JobOperation;
+    reverse: JobOperation;
   };
 }
 /** 安装作业阶段名。 */
@@ -170,12 +249,6 @@ declare function probeInstall(paths: ManagerPaths): ReaInstall | null;
 declare function probeSkill(paths: ManagerPaths, bundledRoot: string, bundledVersion: string): SkillState;
 /** 现探运行期事实。 */
 declare function probeRuntime(config: AgentPresetReaConfig, bundledRoot: string, bundledVersion: string): RuntimeSnapshot;
-/** 作业依赖：生效配置、命令执行面、作业完成后的现探刷新。 */
-interface JobDeps {
-  config: AgentPresetReaConfig;
-  runner: CommandRunner;
-  refresh(): void;
-}
 /** 生效配置：作业可带一次性覆盖（卡片未保存的代理端口即时可用）。 */
 declare function configWith(base: AgentPresetReaConfig, overrides?: JobOverrides): AgentPresetReaConfig;
 /** 建一个 REA 管理器。 */
@@ -214,8 +287,8 @@ declare function reaPresetDefinition(config: AgentPresetReaConfig, runtime?: Run
  * 两端共用同一份字段定义，避免「宿主改了字段、卡片还在读老名字」的静默漂移。
  * @module @dsh-plus/agent-preset-rea/dto
  */
-/** 作业种类。 */
-type JobKind = 'install' | 'skill';
+/** 作业种类：REA 包安装/更新、REA skill 更新、reverse-skill 更新。 */
+type JobKind = 'install' | 'skill' | 'reverse';
 /** 作业状态。 */
 type JobState = 'running' | 'ok' | 'error' | 'cancelled';
 /** 作业进度（按阶段推进；percent 为进入该阶段时的完成度）。 */
@@ -265,20 +338,46 @@ interface McpDto {
   command: string | null;
   args: string[];
 }
+/** GitHub 技能源（zhaoxuya520/reverse-skill）事实。 */
+interface ReverseSkillDto {
+  installed: boolean;
+  repo: string;
+  /** 清单记录的 ref（空串 = 安装时取的默认分支）。 */
+  ref: string | null;
+  /** 提交 sha（内容级溯源）。 */
+  sha: string | null;
+  /** 仓库 VERSION 文件内容。 */
+  version: string | null;
+  root: string;
+  tree: string;
+  files: number;
+  /** 树内发现的全部技能组（相对安装树根）。 */
+  groups: string[];
+  /** 配置选中且实际挂进预设的组。 */
+  activeGroups: string[];
+  updatedAt: string | null;
+}
 /** `GET /status` 响应。 */
 interface StatusDto {
   config: {
     reaVersion: string;
     proxyPort: number;
     mcpEnabled: boolean;
+    skillEnabled: boolean;
+    reverseSkillEnabled: boolean;
+    reverseSkillRepo: string;
+    reverseSkillRef: string;
+    reverseSkillGroups: string[];
     installRoot: string;
   };
   install: InstallDto;
   skill: SkillDto;
+  reverse: ReverseSkillDto;
   mcp: McpDto;
   paths: {
     installRoot: string;
     skillRoot: string;
+    reverseRoot: string;
   };
   job: JobDto | null;
 }
@@ -408,11 +507,19 @@ declare function registerReaRoutes(ctx: Context, options: ReaRoutesOptions): voi
  */
 declare const BUNDLED_SKILL_ROOT: string;
 /**
- * skill-filesystem 的追加根清单。
+ * REA skill 根（随包副本，或手动更新副本——后者存在即替代前者）。
+ * @param updatedRoot - 手动更新副本根（来自 manager 现探）。
+ */
+declare function reaSkillDirs(updatedRoot?: string | null): string[];
+/**
+ * 本预设 `skill-filesystem` 行的完整追加根清单，按三个开关裁剪：
+ * - `skillEnabled=false` → 不挂 REA 官方 skill（安装副本仍留在磁盘）；
+ * - `reverseSkillEnabled=false` → 不挂 reverse-skill 的技能组；
+ * - `extraSkillDirs` 是部署方追加项，不受开关影响（关掉的是本插件自带的两个源）。
  * @param config - 插件配置。
- * @param updatedRoot - 手动更新副本根（存在即替代随包根；来自 manager 现探）。
+ * @param runtime - 现探运行期事实。
  */
-declare function reaSkillDirs(config: AgentPresetReaConfig, updatedRoot?: string | null): string[];
+declare function presetSkillDirs(config: AgentPresetReaConfig, runtime: RuntimeSnapshot): string[];
 //#endregion
 //#region src/index.d.ts
 declare const name = "dsh-plus-agent-preset-rea";
@@ -428,4 +535,4 @@ declare const inject: readonly [];
  */
 declare function apply(ctx: Context, config: AgentPresetReaConfigFields): void;
 //#endregion
-export { ADDED_ROWS, type AgentPresetReaConfig, type AgentPresetReaConfigFields, BUNDLED_SKILL_ROOT, CONFIG_DELTAS, type CommandRunner, Config, DEFAULT_MCP_COMMAND, INPUT_SCHEMA_PROFILES, INSTALL_PHASES, type InstallDto, type InstalledEntry, type JobActionDto, type JobBoard, JobCancelled, type JobDeps, type JobDto, type JobKind, type JobOperation, type JobOverrides, type JobProgressDto, type JobSnapshot, type JobState, type JobTaskContext, type ManagerPaths, type McpDto, type McpLaunch, NPM, OUTPUT_SCHEMA_PROFILES, PLAN_MODE_SECTION, type PresetRegistrar, REA_INSTALL_DIR, REA_PACKAGE, REA_PINNED_VERSION, REA_PRESET_ID, REA_SKILL_DIR, REA_SKILL_NAME, ROUTE_BASE, type ReaInstall, type ReaManager, type RuntimeSnapshot, SETTINGS_NS, SKILL_PHASES, type SkillDto, type SkillManifest, type SkillState, type StatusDto, type Unregister, apply, configWith, createJobBoard, createManager, createPresetRegistrar, emptyRuntime, inject, managerPaths, name, npmEnv, probeInstall, probeRuntime, probeSkill, reaMcpArgs, reaMcpEnv, reaMcpLaunch, reaPresetDefinition, reaSkillDirs, registerReaRoutes, safeVersion, spawnRunner, statusPayload };
+export { ADDED_ROWS, type AgentPresetReaConfig, type AgentPresetReaConfigFields, BUNDLED_SKILL_ROOT, CONFIG_DELTAS, type CommandRunner, Config, DEFAULT_MCP_COMMAND, INPUT_SCHEMA_PROFILES, INSTALL_PHASES, type InstallDto, type InstalledEntry, type JobActionDto, type JobBoard, JobCancelled, type JobDeps, type JobDto, type JobKind, type JobOperation, type JobOverrides, type JobProgressDto, type JobSnapshot, type JobState, type JobTaskContext, type ManagerPaths, type McpDto, type McpLaunch, NPM, OUTPUT_SCHEMA_PROFILES, PLAN_MODE_SECTION, type PresetRegistrar, REA_INSTALL_DIR, REA_PACKAGE, REA_PINNED_VERSION, REA_PRESET_ID, REA_SKILL_DIR, REA_SKILL_NAME, REVERSE_DEFAULT_REPO, REVERSE_DIR, REVERSE_PHASES, REVERSE_TREE_DIR, ROUTE_BASE, type ReaInstall, type ReaManager, type ReverseManifest, type ReversePaths, type ReverseSkillDto, type ReverseState, type RuntimeSnapshot, SETTINGS_NS, SKILL_PHASES, type SkillDto, type SkillManifest, type SkillState, type StatusDto, type Unregister, apply, configWith, createJobBoard, createManager, createPresetRegistrar, discoverSkillGroups, emptyRuntime, inject, managerPaths, name, npmEnv, presetSkillDirs, probeInstall, probeReverse, probeRuntime, probeSkill, reaMcpArgs, reaMcpEnv, reaMcpLaunch, reaPresetDefinition, reaSkillDirs, registerReaRoutes, reversePaths, reverseSkillDirs, runReverseSkillJob, safeVersion, spawnRunner, statusPayload };