@x-otto/install 0.0.1-alpha.0 → 0.0.1-alpha.2

package/README.md

@@ -65,7 +65,7 @@ await manager.install('./dir', { as: 'plugin' })
 - `sanitizeSourceUrl()` — Strip credentials from stored URLs
 
 ### Registry Discovery
-- `RegistryClient` — Multi-source registry index fetch/cache/aggregation (RFC-201)
+- `RegistryClient` — Multi-source registry index fetch/cache/aggregation
 - `parseRegistry()` — Zod-validated registry JSON parsing with fail-soft per-entry handling
 
 ## Dependencies

package/dist/index.d.ts

@@ -2402,8 +2402,20 @@ declare class RegistryClient {
   });
   private get registriesPath();
   private get cacheDir();
-  /** 读源清单（官方源恒在首位；用户文件坏/缺时退化为仅官方源）。 */
+  /** 读源清单（官方源恒在首位；用户文件坏/缺时退化为仅官方源）。不含内网源——同步场景
+   *  （如 `/registry remove` 参数补全）不该为一次可能的网络探测阻塞输入响应，见 `listSourcesAsync`。 */
   listSources(): RegistrySourceConfig[];
+  /**
+   * 读源清单 + 内网可达时自动追加内网官方源（RFC-341 G2）——`otto-official`（公网）恒在
+   * 首位，`otto-official-internal`（内网）紧随其后（仅内网可达 + `OTTO_INTERNAL_REGISTRY_URL`
+   * 已配置时才出现），随后是用户自定义源。
+   *
+   * 与 `listSources()` 的取舍：本方法可能触发一次网络探测（`isIntranetReachable()` 内部
+   * 5 分钟缓存，非首次调用通常走缓存零延迟）——`loadAll()`/`/registry` 面板等本就是
+   * 异步流程的场景改用它；纯同步场景（如参数补全建议器）继续用 `listSources()`，
+   * 不因偶发探测延迟阻塞按键响应。
+   */
+  listSourcesAsync(): Promise<RegistrySourceConfig[]>;
   addSource(name: string, url: string): void;
   removeSource(name: string): void;
   /**
@@ -2412,7 +2424,9 @@ declare class RegistryClient {
    * - 第三方源：改写用户配置中该条目的 disabled 字段；条目不存在则抛错。
    */
   setSourceEnabled(name: string, enabled: boolean): void;
-  /** 拉取全部启用源（缓存优先 → fetch → 陈旧缓存降级）。坏源跳过并记 warning。 */
+  /** 拉取全部启用源（缓存优先 → fetch → 陈旧缓存降级）。坏源跳过并记 warning。
+   *  RFC-341 G2：内网可达时自动含内网官方源（`listSourcesAsync`），公网用户/公网环境
+   *  不受影响（探测目标未配置时零网络请求、零延迟，见 `isIntranetReachable` doc）。 */
   loadAll(): Promise<{
     registries: LoadedRegistry[];
     warnings: string[];