@coralai/sps-cli 0.90.1 → 0.90.2

package/dist/providers/storage/keys.d.ts

@@ -1,33 +0,0 @@
-/**
- * @module        providers/storage/keys
- * @description   桶 key 的拼法。**与 coral `src/storage/keys.ts` 逐字对齐** —— 这是移交的对账面。
- *
- * @layer         providers
- *
- * 🔴 **为什么要一个模块而不是各处拼字符串**(照抄 coral 头注里的理由,它是对的):
- *    桶里**没有"路径不存在"这种错误**。写方把 key 拼错一个字符,PUT 照样 200,
- *    只是那个对象从此没人读得到;读方拼错,拿到 404 却无法区分"没同步上来"和"key 写法不一致"。
- *    文件系统会用 ENOENT 立刻告诉你,桶不会。
- *
- * 🔴 **移交期间这是两份实现。** 两份实现的安全做法不是"小心点",是**拿真桶内容对账**:
- *    切换前跑一轮并行比对,逐 key 逐 etag 一致才算数(实施计划任务 5 的验收物)。
- *    > 判据:一条安全/正确性规则**做对过一次,不代表它在第二条路上也在**。
- *
- * ⚠️ 这里只有**同步**这条路用得到的三个(assetKey / assetPrefix / thumbKey)。
- *    `published/` 与 `library/` 是别的路的写方,**不在本模块** —— 免得看起来像"sps 管着整个桶布局"。
- */
-/** `./x` → `x`;去掉前导 `/`;`..` 一律抛(围栏在 `syncable`,这里是最后一道形状校验)。 */
-export declare function normalizeRel(rel: string): string;
-/** 项目在共享树下的相对路径(`t<租户>/<产品>/<项目>`),去掉尾部斜杠。 */
-export declare function normalizeProject(projectPath: string): string;
-export declare function assetKey(projectPath: string, rel: string): string;
-/** 某项目全部资源的前缀(对账列举用)。 */
-export declare function assetPrefix(projectPath: string): string;
-/**
- * 缩略图:与原图同一棵树下的 `.thumbs/`,**后缀直接追加而不是替换**。
- *
- * 追加(`hero.png.webp`)而不是替换(`hero.webp`)是有意的:替换会让
- * `hero.png` 与 `hero.jpg` 撞成同一个缩略图 key,而撞了不报错 —— 后写的赢,预览图随机。
- */
-export declare function thumbKey(projectPath: string, rel: string): string;
-//# sourceMappingURL=keys.d.ts.map

package/dist/providers/storage/keys.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../../src/providers/storage/keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,iEAAiE;AACjE,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKhD;AAED,8CAA8C;AAC9C,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,yBAAyB;AACzB,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAMjE"}

package/dist/providers/storage/keys.js

@@ -1,52 +0,0 @@
-/**
- * @module        providers/storage/keys
- * @description   桶 key 的拼法。**与 coral `src/storage/keys.ts` 逐字对齐** —— 这是移交的对账面。
- *
- * @layer         providers
- *
- * 🔴 **为什么要一个模块而不是各处拼字符串**(照抄 coral 头注里的理由,它是对的):
- *    桶里**没有"路径不存在"这种错误**。写方把 key 拼错一个字符,PUT 照样 200,
- *    只是那个对象从此没人读得到;读方拼错,拿到 404 却无法区分"没同步上来"和"key 写法不一致"。
- *    文件系统会用 ENOENT 立刻告诉你,桶不会。
- *
- * 🔴 **移交期间这是两份实现。** 两份实现的安全做法不是"小心点",是**拿真桶内容对账**:
- *    切换前跑一轮并行比对,逐 key 逐 etag 一致才算数(实施计划任务 5 的验收物)。
- *    > 判据:一条安全/正确性规则**做对过一次,不代表它在第二条路上也在**。
- *
- * ⚠️ 这里只有**同步**这条路用得到的三个(assetKey / assetPrefix / thumbKey)。
- *    `published/` 与 `library/` 是别的路的写方,**不在本模块** —— 免得看起来像"sps 管着整个桶布局"。
- */
-/** `./x` → `x`;去掉前导 `/`;`..` 一律抛(围栏在 `syncable`,这里是最后一道形状校验)。 */
-export function normalizeRel(rel) {
-    const clean = rel.replace(/^\.\//, '').replace(/^\/+/, '');
-    if (!clean)
-        throw new Error('相对路径为空');
-    if (clean.split('/').includes('..'))
-        throw new Error(`相对路径含 ..:${rel}`);
-    return clean;
-}
-/** 项目在共享树下的相对路径(`t<租户>/<产品>/<项目>`),去掉尾部斜杠。 */
-export function normalizeProject(projectPath) {
-    return normalizeRel(projectPath).replace(/\/+$/, '');
-}
-export function assetKey(projectPath, rel) {
-    return `assets/${normalizeProject(projectPath)}/${normalizeRel(rel)}`;
-}
-/** 某项目全部资源的前缀(对账列举用)。 */
-export function assetPrefix(projectPath) {
-    return `assets/${normalizeProject(projectPath)}/`;
-}
-/**
- * 缩略图:与原图同一棵树下的 `.thumbs/`,**后缀直接追加而不是替换**。
- *
- * 追加(`hero.png.webp`)而不是替换(`hero.webp`)是有意的:替换会让
- * `hero.png` 与 `hero.jpg` 撞成同一个缩略图 key,而撞了不报错 —— 后写的赢,预览图随机。
- */
-export function thumbKey(projectPath, rel) {
-    const clean = normalizeRel(rel);
-    const i = clean.lastIndexOf('/');
-    const dir = i < 0 ? '' : `${clean.slice(0, i)}/`;
-    const base = i < 0 ? clean : clean.slice(i + 1);
-    return `assets/${normalizeProject(projectPath)}/.thumbs/${dir}${base}.webp`;
-}
-//# sourceMappingURL=keys.js.map

package/dist/providers/storage/keys.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../../src/providers/storage/keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,iEAAiE;AACjE,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC3D,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;IACtC,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC;IACxE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,gBAAgB,CAAC,WAAmB;IAClD,OAAO,YAAY,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,WAAmB,EAAE,GAAW;IACvD,OAAO,UAAU,gBAAgB,CAAC,WAAW,CAAC,IAAI,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;AACxE,CAAC;AAED,yBAAyB;AACzB,MAAM,UAAU,WAAW,CAAC,WAAmB;IAC7C,OAAO,UAAU,gBAAgB,CAAC,WAAW,CAAC,GAAG,CAAC;AACpD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,WAAmB,EAAE,GAAW;IACvD,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC;IACjD,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAChD,OAAO,UAAU,gBAAgB,CAAC,WAAW,CAAC,YAAY,GAAG,GAAG,IAAI,OAAO,CAAC;AAC9E,CAAC"}

package/dist/providers/storage/storageConfig.d.ts

@@ -1,46 +0,0 @@
-export interface StorageConfig {
-    /** S3 兼容端点,如 `http://127.0.0.1:9000`。 */
-    endpoint: string;
-    /** 桶名。sps 只认这一个名字,不认识桶里的语义分区。 */
-    bucket: string;
-    accessKey: string;
-    secretKey: string;
-    /** S3 region;MinIO 通常用 `us-east-1`,给默认值只是为了签名能算出来。 */
-    region?: string;
-    /**
-     * 路径式寻址(`http://host/bucket/key`)。MinIO 默认需要它;
-     * 虚拟主机式(`http://bucket.host/key`)要求 DNS 配合,自建部署一般没有。
-     */
-    pathStyle?: boolean;
-    /** 🔴 默认关:缺这个字段或为 false ⇒ 同步路径完全不存在。 */
-    enabled: boolean;
-}
-/** 对外可见的形状 —— **没有** secretKey,accessKey 也只留尾段用于"配的是哪一把"。 */
-export interface RedactedStorageConfig {
-    endpoint: string;
-    bucket: string;
-    accessKeyTail: string;
-    region: string;
-    pathStyle: boolean;
-    enabled: boolean;
-}
-export declare function storageConfigFile(): string;
-/**
- * 读配置。文件不存在 → `null`(**不是**一个"默认配置")。
- *
- * 🔴 不给缺省对象:缺省成 `{enabled:false, …}` 会让"没配过"和"配了但关着"变得无法区分,
- * 而这两者对调用方的意义不同(前者要引导去配,后者是有意关掉)。同族的坑今天在
- * `template.json` 的 `publish` 上刚记过一次。
- */
-export declare function readStorageConfig(): StorageConfig | null;
-export declare function writeStorageConfig(cfg: StorageConfig): void;
-/** 脱敏视图。**任何 HTTP 响应只能给这个**,不能给 `StorageConfig`。 */
-export declare function redact(cfg: StorageConfig): RedactedStorageConfig;
-/**
- * 同步路径的**唯一入口判据**:配了、而且开着,才回配置;否则 `null`。
- *
- * 调用方拿到 `null` 必须**什么都不做**(不是"用默认桶"、也不是"报错") ——
- * 未配置是一个合法状态:sps 是通用工具,别人装它不需要对象存储。
- */
-export declare function activeStorageConfig(): StorageConfig | null;
-//# sourceMappingURL=storageConfig.d.ts.map

package/dist/providers/storage/storageConfig.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"storageConfig.d.ts","sourceRoot":"","sources":["../../../src/providers/storage/storageConfig.ts"],"names":[],"mappings":"AA+BA,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,6DAA6D;AAC7D,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,aAAa,GAAG,IAAI,CAuBxD;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAE3D;AAED,oDAAoD;AACpD,wBAAgB,MAAM,CAAC,GAAG,EAAE,aAAa,GAAG,qBAAqB,CAUhE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,GAAG,IAAI,CAG1D"}

package/dist/providers/storage/storageConfig.js

@@ -1,94 +0,0 @@
-/**
- * @module        providers/storage/storageConfig
- * @description   对象存储接入的**节点级**配置(`~/.coral/storage.json`)。
- *
- * @layer         providers
- *
- * 设计见 `docs/design/object-storage-and-workspace-sync.md` §2.1。四条钉死的规则里,本模块负责三条:
- *
- * 🔴 **① 配置里放"去哪儿",不放"同步什么"。**
- *    endpoint / bucket / 凭据 / 前缀 —— 全是"去哪儿"。
- *    "哪些相对路径算用户资产"是**产品知识**,来自 `template.json` 的声明,**不在这里**。
- *    反面教材:coral sidecar 的 `scan.ts:38` 用「目录下含 assets/」当发现判据,
- *    于是"只有 docs/、还没有 assets/"的设计师阶段项目**整批静默缺席**(实测 36 个)。
- *
- * 🔴 **③ 单节点级,不做多租户。** 与媒体 provider 同一条:**多租户归应用层,不做进引擎**。
- *    "这台节点用哪个桶" = 一份配置;"哪个租户进哪个桶"是平台的活。
- *    ⇒ 所以这里是**一个对象**而不是一张表。名字用 `storage.json` 而不是 `storage-providers.json`:
- *    **名字要跟着职责走** —— 复数名字装一个对象,会让下一个人以为可以配多份。
- *
- * 🔴 **④ 默认关。** 没有配置文件 ⇒ `enabled` 为 false ⇒ **整条同步路径不存在**,
- *    而不是"用一个缺省的桶"。缺省被解释成"最宽松"是最危险的缺省。
- *
- * 凭据落盘走 `writeSecretFile`(tmp 0600 → rename → **chmod**,顺序不能反);
- * 读侧永不回显 —— 对外一律走 `redact()`,与 `GET /:project/agent` 同一条规矩
- * (那条的理由是:读者是消费方,不是密钥的所有者)。
- */
-import { existsSync, readFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { hardenSecretFile, writeSecretFile } from '../../infra/secretFile.js';
-import { coralRoot } from '../../shared/runtimePaths.js';
-export function storageConfigFile() {
-    return join(coralRoot(), 'storage.json');
-}
-/**
- * 读配置。文件不存在 → `null`(**不是**一个"默认配置")。
- *
- * 🔴 不给缺省对象:缺省成 `{enabled:false, …}` 会让"没配过"和"配了但关着"变得无法区分,
- * 而这两者对调用方的意义不同(前者要引导去配,后者是有意关掉)。同族的坑今天在
- * `template.json` 的 `publish` 上刚记过一次。
- */
-export function readStorageConfig() {
-    const p = storageConfigFile();
-    if (!existsSync(p))
-        return null;
-    // 读路径上顺手收权限:存量文件不需要迁移脚本。
-    hardenSecretFile(p);
-    try {
-        const raw = JSON.parse(readFileSync(p, 'utf-8'));
-        if (typeof raw.endpoint !== 'string' || typeof raw.bucket !== 'string')
-            return null;
-        if (typeof raw.accessKey !== 'string' || typeof raw.secretKey !== 'string')
-            return null;
-        return {
-            endpoint: raw.endpoint,
-            bucket: raw.bucket,
-            accessKey: raw.accessKey,
-            secretKey: raw.secretKey,
-            region: raw.region ?? 'us-east-1',
-            pathStyle: raw.pathStyle ?? true,
-            enabled: raw.enabled === true,
-        };
-    }
-    catch {
-        // 坏文件当成"没配" —— 但**不静默**:调用方拿到 null 会走"未配置"的响亮路径,
-        // 而不是拿着半个配置去连一个猜出来的端点。
-        return null;
-    }
-}
-export function writeStorageConfig(cfg) {
-    writeSecretFile(storageConfigFile(), `${JSON.stringify(cfg, null, 2)}\n`);
-}
-/** 脱敏视图。**任何 HTTP 响应只能给这个**,不能给 `StorageConfig`。 */
-export function redact(cfg) {
-    return {
-        endpoint: cfg.endpoint,
-        bucket: cfg.bucket,
-        // 只留尾 4 位:够回答"配的是哪一把",不够拿去用。
-        accessKeyTail: cfg.accessKey.length > 4 ? cfg.accessKey.slice(-4) : '',
-        region: cfg.region ?? 'us-east-1',
-        pathStyle: cfg.pathStyle ?? true,
-        enabled: cfg.enabled,
-    };
-}
-/**
- * 同步路径的**唯一入口判据**:配了、而且开着,才回配置;否则 `null`。
- *
- * 调用方拿到 `null` 必须**什么都不做**(不是"用默认桶"、也不是"报错") ——
- * 未配置是一个合法状态:sps 是通用工具,别人装它不需要对象存储。
- */
-export function activeStorageConfig() {
-    const cfg = readStorageConfig();
-    return cfg?.enabled ? cfg : null;
-}
-//# sourceMappingURL=storageConfig.js.map

package/dist/providers/storage/storageConfig.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"storageConfig.js","sourceRoot":"","sources":["../../../src/providers/storage/storageConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AA8BzD,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,CAAC,SAAS,EAAE,EAAE,cAAc,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,CAAC,GAAG,iBAAiB,EAAE,CAAC;IAC9B,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,yBAAyB;IACzB,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAA2B,CAAC;QAC3E,IAAI,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACpF,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACxF,OAAO;YACL,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,WAAW;YACjC,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,IAAI;YAChC,OAAO,EAAE,GAAG,CAAC,OAAO,KAAK,IAAI;SAC9B,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,iDAAiD;QACjD,uBAAuB;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAkB;IACnD,eAAe,CAAC,iBAAiB,EAAE,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AAC5E,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,MAAM,CAAC,GAAkB;IACvC,OAAO;QACL,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,6BAA6B;QAC7B,aAAa,EAAE,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;QACtE,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,WAAW;QACjC,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,IAAI;QAChC,OAAO,EAAE,GAAG,CAAC,OAAO;KACrB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,GAAG,GAAG,iBAAiB,EAAE,CAAC;IAChC,OAAO,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACnC,CAAC"}

package/dist/providers/storage/syncProject.d.ts

@@ -1,67 +0,0 @@
-/**
- * @module        providers/storage/syncProject
- * @description   一个项目的一轮对账同步:枚举 → 过下限 → 与桶对账 → 上传(缩略图先、原图后)。
- *
- * @layer         providers
- *
- * 九条不变量见 `docs/design/storage-sync-implementation.md` §〇。落在代码里的要害是这几条:
- *
- * 🔴 **对账基准是桶本身,不是本地状态文件。** 本地清单一旦与桶脱节(桶被清过 / 上轮崩在一半 /
- *    换了机器)会**永久跳过**某些文件且不报错;以桶的实际内容为准,一轮巡检就自愈。
- *
- * 🔴 **不删。** 本地文件没了 ≠ 用户要删桶里那份(工作区可能被重建、节点可能换了)。
- *    `StorageBackend` 接口上**根本没有 delete** —— 比"记得别调"可靠。
- *
- * 🔴 **幂等判据的覆盖面必须等于产物面。** 这一轮产出两样(原图 + 缩略图),判据就得同时问两样:
- *    只问原图 ⇒ 一张生成失败过的缩略图**永远不会被补上**,表现是"同步很成功、预览是空的"。
- *
- * 🔴 **缩略图先写、原图后写**,且缩略图**上传**失败时本轮不写原图 ——
- *    原图 etag 与本地相等是这条流水线的**提交点**,顺序反了会永久停留在旧缩略图且不报错。
- *    ⚠️ 区分**生成**失败(确定性:图坏了,照常传原图,否则坏文件把自己永远挡在桶外)
- *       与**上传**失败(会留下陈旧缩略图 ⇒ 必须回退)。
- *
- * 🔴 **枚举完再判下限,再推第一个字节。** 下限若写在上传循环里,
- *    排在拒绝项前面的文件**已经进桶了** —— 「整体失败」是关于**副作用**的断言,不是返回码。
- *
- * 🔴🔴 **但被拒的文件是"跳过并报出来",不是"整趟不推"**(coral 2026-08-19 指出,已改):
- *    同一条下限用在**发布**路上,"整趟失败"是对的 —— 半个包比拒绝更难查;
- *    用在**周期性**的同步路上就变成**那个项目永久停止同步**,而且理由看起来像安全事件。
- *    > 判据:**同一条规则,在"一次性动作"和"周期性动作"上后果完全不同。**
- *    > 周期性的路上,任何"整趟失败"都要能自己恢复,否则它等于一个**不报警的开关**。
- *    而下限要防的事(凭据进桶)本来就是**逐文件**的 —— 跳过那一个就够了,
- *    赔上整个项目既不更安全,又制造了一个静默停摆。
- */
-import type { StorageBackend } from './StorageBackend.js';
-import { type ProjectDir } from './scanWorkspace.js';
-import { type SyncRejection } from './syncable.js';
-export declare const contentTypeOf: (rel: string) => string | undefined;
-export declare const thumbnailable: (rel: string) => boolean;
-export interface SyncStats {
-    project: string;
-    scanned: number;
-    uploaded: number;
-    /** 与 uploaded **分开计** —— 合在一起就看不出预览到底有没有产出。 */
-    thumbs: number;
-    skipped: number;
-    failed: number;
-    unreadable: number;
-    /** 声明里有、盘上没有 —— **不是错误**(设计师还没写 PRD 也走这里)。与 unreadable 分开。 */
-    missing: number;
-    /** 枚举阶段跳过的点开头条目(中间产物)。不触发整趟拒绝。 */
-    skippedDot: number;
-    oversized: number;
-    /** 被安全下限拒的项。**整趟不推**(见模块头)。 */
-    rejected: SyncRejection[];
-    /** 用了窄兜底(该产品没有声明)。**必须被报出来**。 */
-    usedDefaultScope: boolean;
-    errors: string[];
-}
-export interface SyncDeps {
-    storage: StorageBackend;
-    /** 缩略图生成。注入是为了让用例不必依赖 sharp 的原生二进制。 */
-    makeThumb: (input: Buffer) => Promise<Buffer>;
-    /** 单文件上限(字节)。显式给,不靠运气。 */
-    maxBytes: number;
-}
-export declare function syncProject(deps: SyncDeps, project: ProjectDir, include: string[], usedDefaultScope: boolean): Promise<SyncStats>;
-//# sourceMappingURL=syncProject.d.ts.map

package/dist/providers/storage/syncProject.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"syncProject.d.ts","sourceRoot":"","sources":["../../../src/providers/storage/syncProject.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,KAAK,UAAU,EAAe,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,KAAK,aAAa,EAAa,MAAM,eAAe,CAAC;AAS9D,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,SAA6C,CAAC;AAInG,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,KAAG,OAAiD,CAAC;AAE9F,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,iCAAiC;IACjC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,cAAc,CAAC;IACxB,uCAAuC;IACvC,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9C,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,MAAM,EAAE,EACjB,gBAAgB,EAAE,OAAO,GACxB,OAAO,CAAC,SAAS,CAAC,CAmFpB"}

package/dist/providers/storage/syncProject.js

@@ -1,136 +0,0 @@
-/**
- * @module        providers/storage/syncProject
- * @description   一个项目的一轮对账同步:枚举 → 过下限 → 与桶对账 → 上传(缩略图先、原图后)。
- *
- * @layer         providers
- *
- * 九条不变量见 `docs/design/storage-sync-implementation.md` §〇。落在代码里的要害是这几条:
- *
- * 🔴 **对账基准是桶本身,不是本地状态文件。** 本地清单一旦与桶脱节(桶被清过 / 上轮崩在一半 /
- *    换了机器)会**永久跳过**某些文件且不报错;以桶的实际内容为准,一轮巡检就自愈。
- *
- * 🔴 **不删。** 本地文件没了 ≠ 用户要删桶里那份(工作区可能被重建、节点可能换了)。
- *    `StorageBackend` 接口上**根本没有 delete** —— 比"记得别调"可靠。
- *
- * 🔴 **幂等判据的覆盖面必须等于产物面。** 这一轮产出两样(原图 + 缩略图),判据就得同时问两样:
- *    只问原图 ⇒ 一张生成失败过的缩略图**永远不会被补上**,表现是"同步很成功、预览是空的"。
- *
- * 🔴 **缩略图先写、原图后写**,且缩略图**上传**失败时本轮不写原图 ——
- *    原图 etag 与本地相等是这条流水线的**提交点**,顺序反了会永久停留在旧缩略图且不报错。
- *    ⚠️ 区分**生成**失败(确定性:图坏了,照常传原图,否则坏文件把自己永远挡在桶外)
- *       与**上传**失败(会留下陈旧缩略图 ⇒ 必须回退)。
- *
- * 🔴 **枚举完再判下限,再推第一个字节。** 下限若写在上传循环里,
- *    排在拒绝项前面的文件**已经进桶了** —— 「整体失败」是关于**副作用**的断言,不是返回码。
- *
- * 🔴🔴 **但被拒的文件是"跳过并报出来",不是"整趟不推"**(coral 2026-08-19 指出,已改):
- *    同一条下限用在**发布**路上,"整趟失败"是对的 —— 半个包比拒绝更难查;
- *    用在**周期性**的同步路上就变成**那个项目永久停止同步**,而且理由看起来像安全事件。
- *    > 判据:**同一条规则,在"一次性动作"和"周期性动作"上后果完全不同。**
- *    > 周期性的路上,任何"整趟失败"都要能自己恢复,否则它等于一个**不报警的开关**。
- *    而下限要防的事(凭据进桶)本来就是**逐文件**的 —— 跳过那一个就够了,
- *    赔上整个项目既不更安全,又制造了一个静默停摆。
- */
-import { readFile } from 'node:fs/promises';
-import { extname } from 'node:path';
-import { assetKey, assetPrefix, thumbKey } from './keys.js';
-import { scanByScope } from './scanWorkspace.js';
-import { screenAll } from './syncable.js';
-/** 桶是直连的 —— **没有一层服务器能在返回时补救**,缺省的 octet-stream 会让预览图变成一次下载。 */
-const MIME = {
-    '.png': 'image/png', '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg', '.webp': 'image/webp',
-    '.gif': 'image/gif', '.svg': 'image/svg+xml', '.json': 'application/json', '.txt': 'text/plain',
-    '.mp3': 'audio/mpeg', '.wav': 'audio/wav', '.ogg': 'audio/ogg', '.m4a': 'audio/mp4',
-    '.html': 'text/html', '.js': 'text/javascript', '.css': 'text/css', '.md': 'text/markdown',
-};
-export const contentTypeOf = (rel) => MIME[extname(rel).toLowerCase()];
-/** 能缩略的栅格图。**不认识的类型一律否**,别去猜;SVG 不缩(本来就小,且避开服务端光栅化任意 SVG)。 */
-const RASTER = new Set(['.png', '.jpg', '.jpeg', '.webp', '.gif', '.bmp', '.tiff', '.avif']);
-export const thumbnailable = (rel) => RASTER.has(extname(rel).toLowerCase());
-export async function syncProject(deps, project, include, usedDefaultScope) {
-    const stats = {
-        project: project.rel, scanned: 0, uploaded: 0, thumbs: 0, skipped: 0, failed: 0,
-        unreadable: 0, missing: 0, skippedDot: 0, oversized: 0, rejected: [], usedDefaultScope, errors: [],
-    };
-    const scan = await scanByScope(project.abs, include, deps.maxBytes);
-    stats.scanned = scan.files.length;
-    stats.unreadable = scan.unreadable.length;
-    stats.missing = scan.missing.length;
-    stats.skippedDot = scan.skippedDot.length;
-    stats.oversized = scan.oversized.length;
-    for (const rel of scan.unreadable.slice(0, 3))
-        stats.errors.push(`权限读不到(已跳过) ${rel}`);
-    for (const rel of scan.oversized.slice(0, 3))
-        stats.errors.push(`超过单文件上限(未同步) ${rel}`);
-    // 🔴 下限在**推第一个字节之前**整趟判完(不是边推边判)。
-    //    但结果是**把被拒的那些从名单里摘掉**,不是整趟不推 —— 理由见模块头。
-    stats.rejected = await screenAll(scan.files.map((f) => ({ rel: f.rel, abs: f.abs })), project.abs);
-    const blocked = new Set(stats.rejected.map((r) => r.rel));
-    // 拒绝项要把名字报出去:清单会过期,而**漏掉的必须能被看见**。
-    for (const r of stats.rejected.slice(0, 5))
-        stats.errors.push(`安全下限拒绝 ${r.code}: ${r.rel}`);
-    const allowed = scan.files.filter((f) => !blocked.has(f.rel));
-    let remote;
-    try {
-        remote = new Map((await deps.storage.list(assetPrefix(project.rel))).map((o) => [o.key, o.etag]));
-    }
-    catch (e) {
-        stats.failed++;
-        stats.errors.push(`列举桶失败:${e instanceof Error ? e.message : String(e)}`);
-        return stats;
-    }
-    for (const f of allowed) {
-        const key = assetKey(project.rel, f.rel);
-        const changed = remote.get(key) !== f.md5; // ETag == md5,**不看 mtime**
-        const tKey = thumbnailable(f.rel) ? thumbKey(project.rel, f.rel) : null;
-        const thumbMissing = tKey !== null && !remote.has(tKey);
-        if (!changed && !thumbMissing) {
-            stats.skipped++;
-            continue;
-        }
-        const fail = (e, what) => {
-            stats.failed++;
-            if (stats.errors.length < 8)
-                stats.errors.push(`${what} ${f.rel}: ${e instanceof Error ? e.message : String(e)}`);
-        };
-        let bytes;
-        try {
-            bytes = await readFile(f.abs);
-        }
-        catch (e) {
-            fail(e, '读文件');
-            continue;
-        }
-        let thumbUploadFailed = false;
-        if (tKey !== null && (changed || thumbMissing)) {
-            let thumb = null;
-            try {
-                thumb = await deps.makeThumb(bytes);
-            }
-            catch (e) {
-                fail(e, '生成缩略图'); // 生成失败是确定性的 ⇒ 照常传原图
-            }
-            if (thumb) {
-                try {
-                    await deps.storage.put(tKey, thumb, 'image/webp');
-                    stats.thumbs++;
-                }
-                catch (e) {
-                    fail(e, '上传缩略图');
-                    thumbUploadFailed = true; // ⇒ 本轮不写原图,免得下一轮判"没变"而永远停在旧缩略图
-                }
-            }
-        }
-        if (!changed || thumbUploadFailed)
-            continue;
-        try {
-            await deps.storage.put(key, bytes, contentTypeOf(f.rel));
-            stats.uploaded++;
-        }
-        catch (e) {
-            fail(e, '上传'); // 单文件失败不中断整轮 —— 下轮对账会再试,但原因要留下
-        }
-    }
-    return stats;
-}
-//# sourceMappingURL=syncProject.js.map

package/dist/providers/storage/syncProject.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"syncProject.js","sourceRoot":"","sources":["../../../src/providers/storage/syncProject.ts"],"names":[],"mappings":"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"}

package/dist/providers/storage/syncRunner.d.ts

@@ -1,59 +0,0 @@
-/**
- * @module        providers/storage/syncRunner
- * @description   对账循环:发现项目 → 新鲜度过滤 → 逐项目同步 → 汇总。
- *
- * @layer         providers
- *
- * 🔴 **它是对账循环,不是事件驱动**(照抄 coral 的判断,它是对的):
- *    文件事件会漏(worker 在别的用户下写 / 容器里写 / 进程崩在一半),
- *    而漏掉的表现是"桶里少了一个文件",**没有任何报错**。对账每轮都会自愈。
- *
- * 🔴 **跑在 daemon,不在 console 的请求路径。**
- *    sidecar 是独立进程,而 console 是**共享事件循环** —— 同一段代码换了宿主就会开始
- *    阻塞 `/api/health` 探针与 SSE 心跳。
- *    > 判据:**同步在移交件里是对的 —— 它本来跑在 CLI 里;换了宿主之后才变错。**
- *
- * 🔴 **每一类"没做"都要有自己的计数**,别合并成一个"跳过":
- *    超期跳过 / 范围内一个路径都不存在 / 权限读不到 / 超大 / 被下限拒 —— 五种原因,五个数。
- *    合并的代价今天实测过:coral 那个 `0` 同时表示"从没改过"和"目录不存在",吃掉了 36 个项目。
- */
-import type { StorageBackend } from './StorageBackend.js';
-import { type SyncStats } from './syncProject.js';
-export interface SyncPassOptions {
-    root: string;
-    /** 只同步近 N 天动过的项目;0 = 全部。 */
-    sinceDays: number;
-    /** 单文件上限。 */
-    maxBytes: number;
-    /** 只跑一个项目(相对共享根),排障用。 */
-    onlyProject?: string;
-    log?: (line: string) => void;
-    /** 注入点:用例用假后端 / 假缩略图,不碰 minio 与 sharp 的原生依赖。 */
-    storage?: StorageBackend;
-    makeThumb?: (input: Buffer) => Promise<Buffer>;
-    now?: number;
-}
-export interface PassSummary {
-    projects: number;
-    scanned: number;
-    uploaded: number;
-    thumbs: number;
-    skipped: number;
-    failed: number;
-    unreadable: number;
-    missing: number;
-    skippedDot: number;
-    oversized: number;
-    rejected: number;
-    /** 因超过 sinceDays 没动而跳过。 */
-    skippedOld: number;
-    /** 🔴 范围内**一个路径都不存在** —— 与"很旧"分开数(它多半意味着声明写错了)。 */
-    skippedEmptyScope: number;
-    /** 用了窄兜底(该产品没有声明)的项目数。 */
-    defaultScope: number;
-    perProject: SyncStats[];
-}
-export declare function runSyncPass(opts: SyncPassOptions): Promise<PassSummary | null>;
-/** 汇总行。每一类"没做"都占一格 —— 一个悄悄缩小了范围的同步器,和一个坏掉的同步器,日志上一模一样。 */
-export declare function formatSummary(sum: PassSummary, started: number, opts: SyncPassOptions): string;
-//# sourceMappingURL=syncRunner.d.ts.map

package/dist/providers/storage/syncRunner.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"syncRunner.d.ts","sourceRoot":"","sources":["../../../src/providers/storage/syncRunner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,EAAiB,KAAK,SAAS,EAAe,MAAM,kBAAkB,CAAC;AAG9E,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,gDAAgD;IAChD,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,0BAA0B;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB;AAQD,wBAAsB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAyEpF;AAED,0DAA0D;AAC1D,wBAAgB,aAAa,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,MAAM,CAgB9F"}