oasis_test_v2 2.2.119 → 2.2.120

package/dist/index.js

@@ -138818,7 +138818,7 @@ ${block}
       }
       return out;
     }
-    var DEFAULT_BATCH = {
+    var DEFAULT_BATCH2 = {
       delayMs: 600,
       longThresholdChars: 1e3,
       longDelayMs: 2e3,
@@ -138837,11 +138837,11 @@ ${block}
       var _a2, _b, _c5, _d, _e5, _f, _g;
       const t = (_b = (_a2 = cfg === null || cfg === void 0 ? void 0 : cfg.batch) === null || _a2 === void 0 ? void 0 : _a2.text) !== null && _b !== void 0 ? _b : {};
       return {
-        delayMs: (_c5 = t.delayMs) !== null && _c5 !== void 0 ? _c5 : DEFAULT_BATCH.delayMs,
-        longThresholdChars: (_d = t.longThresholdChars) !== null && _d !== void 0 ? _d : DEFAULT_BATCH.longThresholdChars,
-        longDelayMs: (_e5 = t.longDelayMs) !== null && _e5 !== void 0 ? _e5 : DEFAULT_BATCH.longDelayMs,
-        maxMessages: (_f = t.maxMessages) !== null && _f !== void 0 ? _f : DEFAULT_BATCH.maxMessages,
-        maxChars: (_g = t.maxChars) !== null && _g !== void 0 ? _g : DEFAULT_BATCH.maxChars
+        delayMs: (_c5 = t.delayMs) !== null && _c5 !== void 0 ? _c5 : DEFAULT_BATCH2.delayMs,
+        longThresholdChars: (_d = t.longThresholdChars) !== null && _d !== void 0 ? _d : DEFAULT_BATCH2.longThresholdChars,
+        longDelayMs: (_e5 = t.longDelayMs) !== null && _e5 !== void 0 ? _e5 : DEFAULT_BATCH2.longDelayMs,
+        maxMessages: (_f = t.maxMessages) !== null && _f !== void 0 ? _f : DEFAULT_BATCH2.maxMessages,
+        maxChars: (_g = t.maxChars) !== null && _g !== void 0 ? _g : DEFAULT_BATCH2.maxChars
       };
     }
     var SeenCache = class {
@@ -279920,7 +279920,7 @@ async function drainToBuffer(body2) {
   for await (const chunk of body2) parts.push(chunk);
   return new Uint8Array(Buffer.concat(parts));
 }
-var import_node_crypto87, fs36, BLOB_NAME2, ExternalizedBlobStore, ObjectBlobStore;
+var import_node_crypto87, fs36, BLOB_NAME2, MIGRATION_SELECTORS, ExternalizedBlobStore, ObjectBlobStore;
 var init_externalized_blobs = __esm({
   "../storage/src/externalized-blobs.ts"() {
     "use strict";
@@ -279930,6 +279930,12 @@ var init_externalized_blobs = __esm({
     init_blob_object_backend();
     init_postgres();
     BLOB_NAME2 = /^[0-9a-f]{64}$/;
+    MIGRATION_SELECTORS = {
+      pg: `location = 'pg'`,
+      ext: `location = 'ext'`,
+      "ext-with-bytes": `location = 'ext' AND bytes IS NOT NULL`,
+      internalize: `location = 'ext' OR bytes IS NULL`
+    };
     ExternalizedBlobStore = class _ExternalizedBlobStore {
       constructor(pool, t, namespace, backend, opts) {
         this.pool = pool;
@@ -280137,13 +280143,45 @@ var init_externalized_blobs = __esm({
       }
       /** 列出待处理的 hash（分批、按 hash 升序，便于中断续跑）。 */
       async listHashes(where, after, limit) {
-        const cond = where === "pg" ? `location = 'pg'` : where === "ext" ? `location = 'ext'` : `location = 'ext' AND bytes IS NOT NULL`;
         const res = await this.pool.query(
-          `SELECT hash FROM ${this.t} WHERE ${cond} AND hash > $1 ORDER BY hash LIMIT $2`,
+          `SELECT hash FROM ${this.t} WHERE (${MIGRATION_SELECTORS[where]}) AND hash > $1 ORDER BY hash LIMIT $2`,
           [after, limit]
         );
         return res.rows.map((r5) => r5.hash);
       }
+      /** 待处理的行数与字节数（`oasis blobs … --dry-run` 与进度分母）。 */
+      async pendingStats(where) {
+        const res = await this.pool.query(
+          `SELECT count(*)::bigint AS rows, coalesce(sum(size), 0)::bigint AS bytes FROM ${this.t} WHERE ${MIGRATION_SELECTORS[where]}`
+        );
+        const r5 = res.rows[0] ?? {};
+        return { rows: Number(r5.rows ?? 0), bytes: Number(r5.bytes ?? 0) };
+      }
+      /**
+       * 清空给定行的 bytea（§6.2 第 6 步 `--purge-pg-bytes` 的一批）：**先确认对象在后端、大小与行一致**，
+       * 只清这些——bytea 是清掉前最后一份副本，对象丢了（误删、恢复不全）时宁可留着。
+       * 返回清掉的行数、这些行的字节数与未通过核对的 hash。
+       */
+      async purgePgBytesVerified(hashes) {
+        if (hashes.length === 0) return { purged: 0, bytes: 0, unverified: [] };
+        const res = await this.pool.query(
+          `SELECT hash, size FROM ${this.t} WHERE hash = ANY($1::text[]) AND location = 'ext' AND bytes IS NOT NULL`,
+          [hashes]
+        );
+        const ok3 = [];
+        const unverified = [];
+        for (const row of res.rows) {
+          const head = await this.backend.head(this.key(row.hash));
+          if (head && head.size === Number(row.size)) ok3.push(row.hash);
+          else unverified.push(row.hash);
+        }
+        if (ok3.length === 0) return { purged: 0, bytes: 0, unverified };
+        const upd = await this.pool.query(
+          `UPDATE ${this.t} SET bytes = NULL WHERE hash = ANY($1::text[]) AND location = 'ext' AND bytes IS NOT NULL RETURNING size`,
+          [ok3]
+        );
+        return { purged: upd.rowCount ?? 0, bytes: upd.rows.reduce((n3, r5) => n3 + Number(r5.size), 0), unverified };
+      }
       /** 观察期后清空已外部化行的 bytea（§6.2 第 6 步），一批一条语句。返回本批清掉的行数。 */
       async purgePgBytes(limit) {
         const res = await this.pool.query(
@@ -320180,7 +320218,7 @@ var s3_object_backend_exports = {};
 __export(s3_object_backend_exports, {
   S3ObjectBackend: () => S3ObjectBackend
 });
-var fs37, import_client_s3, import_lib_storage, import_s3_request_presigner, MULTIPART_THRESHOLD, isNotFound, S3ObjectBackend;
+var fs37, import_client_s3, import_lib_storage, import_s3_request_presigner, MULTIPART_THRESHOLD, MULTIPART_PART_SIZE, MULTIPART_QUEUE_SIZE, isNotFound, S3ObjectBackend;
 var init_s3_object_backend = __esm({
   "../storage/src/s3-object-backend.ts"() {
     "use strict";
@@ -320191,6 +320229,8 @@ var init_s3_object_backend = __esm({
     init_blob_object_backend();
     init_blob_backend_config();
     MULTIPART_THRESHOLD = 16 * 1024 * 1024;
+    MULTIPART_PART_SIZE = 8 * 1024 * 1024;
+    MULTIPART_QUEUE_SIZE = 2;
     isNotFound = (err) => {
       const e5 = err;
       return e5?.name === "NotFound" || e5?.name === "NoSuchKey" || e5?.$metadata?.httpStatusCode === 404;
@@ -320289,8 +320329,8 @@ var init_s3_object_backend = __esm({
             await new import_lib_storage.Upload({
               client: this.client,
               params: { Bucket: this.bucket, Key, Body: fs37.createReadStream(staged.file), ContentType, ChecksumAlgorithm: "SHA256" },
-              partSize: MULTIPART_THRESHOLD,
-              queueSize: 2,
+              partSize: MULTIPART_PART_SIZE,
+              queueSize: MULTIPART_QUEUE_SIZE,
               leavePartsOnError: false
             }).done();
           }
@@ -320476,6 +320516,99 @@ var init_blob_backend_config = __esm({
   }
 });
 
+// ../storage/src/blob-migration.ts
+async function migrateBlobs(store, op2, opts) {
+  const selector = SELECTOR[op2];
+  const pending = await store.pendingStats(selector);
+  const report = {
+    op: op2,
+    dryRun: opts.dryRun === true,
+    interrupted: false,
+    batches: 0,
+    candidateRows: pending.rows,
+    candidateBytes: pending.bytes,
+    rows: 0,
+    bytes: 0,
+    failed: 0,
+    failures: [],
+    counts: { pg: 0, ext: 0, extWithBytes: 0 }
+  };
+  const fail = (hash3, err) => {
+    report.failed++;
+    if (report.failures.length < MAX_FAILURES_KEPT) {
+      const cause = err instanceof Error && err.cause instanceof Error ? `\uFF1A${err.cause.message}` : "";
+      report.failures.push({ hash: hash3, error: `${err instanceof Error ? err.message : String(err)}${cause}` });
+    }
+  };
+  const stop = () => opts.shouldStop?.() === true;
+  const sleep7 = opts.sleep ?? defaultSleep2;
+  const batch = Math.max(1, Math.floor(opts.batch));
+  if (!report.dryRun) {
+    let after = "";
+    for (; ; ) {
+      if (stop()) {
+        report.interrupted = true;
+        break;
+      }
+      const hashes = await store.listHashes(selector, after, batch);
+      if (hashes.length === 0) break;
+      if (op2 === "purge-pg-bytes") {
+        const r5 = await store.purgePgBytesVerified(hashes);
+        report.rows += r5.purged;
+        report.bytes += r5.bytes;
+        for (const h5 of r5.unverified) fail(h5, new Error("\u5BF9\u8C61\u4E0D\u5728\u540E\u7AEF\u6216\u5927\u5C0F\u4E0E\u884C\u4E0D\u7B26\uFF0Cbytea \u4FDD\u7559"));
+        after = hashes[hashes.length - 1];
+      } else {
+        for (const hash3 of hashes) {
+          if (stop()) {
+            report.interrupted = true;
+            break;
+          }
+          try {
+            const n3 = op2 === "externalize" ? await store.externalizeOne(hash3) : await store.internalizeOne(hash3);
+            report.rows++;
+            report.bytes += n3;
+          } catch (err) {
+            fail(hash3, err);
+          }
+          after = hash3;
+        }
+      }
+      report.batches++;
+      opts.onProgress?.(progressOf(report));
+      if (report.interrupted || hashes.length < batch) break;
+      if (opts.pauseMs > 0) await sleep7(opts.pauseMs);
+    }
+  }
+  report.counts = await store.locationCounts();
+  return report;
+}
+function progressOf(r5) {
+  return { batches: r5.batches, candidateRows: r5.candidateRows, candidateBytes: r5.candidateBytes, rows: r5.rows, bytes: r5.bytes, failed: r5.failed };
+}
+async function listBlobSchemas(pool) {
+  const res = await pool.query(
+    `SELECT table_schema AS s FROM information_schema.tables
+      WHERE table_name = 'blobs' AND table_type = 'BASE TABLE'
+        AND table_schema NOT IN ('pg_catalog', 'information_schema')
+      ORDER BY table_schema`
+  );
+  return res.rows.map((r5) => r5.s);
+}
+var SELECTOR, MAX_FAILURES_KEPT, defaultSleep2;
+var init_blob_migration = __esm({
+  "../storage/src/blob-migration.ts"() {
+    "use strict";
+    SELECTOR = {
+      externalize: "pg",
+      "purge-pg-bytes": "ext-with-bytes",
+      internalize: "internalize"
+    };
+    MAX_FAILURES_KEPT = 50;
+    defaultSleep2 = (ms) => new Promise((r5) => setTimeout(r5, ms));
+  }
+});
+
 // ../storage/src/index.ts
 var src_exports = {};
 __export(src_exports, {
@@ -320608,10 +320741,12 @@ __export(src_exports, {
   inventoryZeroTenantTables: () => inventoryZeroTenantTables,
   isUniqueViolation: () => isUniqueViolation2,
   legacyTurnId: () => legacyTurnId,
+  listBlobSchemas: () => listBlobSchemas,
   listChatItemsSchemas: () => listChatItemsSchemas,
   listTenancyCompanies: () => listTenancyCompanies,
   loadKnownCompanies: () => loadKnownCompanies,
   maxGate: () => maxGate,
+  migrateBlobs: () => migrateBlobs,
   missingTypeNames: () => missingTypeNames,
   moveDefaultCompanySchema: () => moveDefaultCompanySchema,
   moveTenancyRows: () => moveTenancyRows,
@@ -320702,6 +320837,7 @@ var init_src10 = __esm({
     init_blob_object_backend();
     init_externalized_blobs();
     init_blob_backend_config();
+    init_blob_migration();
   }
 });
 
@@ -323213,6 +323349,146 @@ var init_usage_ledger_backfill_command = __esm({
   }
 });
 
+// ../cli/src/blobs-command.ts
+var blobs_command_exports = {};
+__export(blobs_command_exports, {
+  BLOBS_USAGE: () => BLOBS_USAGE,
+  BlobsArgError: () => BlobsArgError,
+  parseBlobsArgs: () => parseBlobsArgs,
+  runBlobs: () => runBlobs
+});
+function parseBlobsArgs(positional, flags) {
+  const on = (k6) => flags.has(k6) && flags.get(k6) !== "false";
+  const sub = positional[0];
+  if (sub !== "externalize" && sub !== "internalize") throw new BlobsArgError("\u5B50\u547D\u4EE4\u5FC5\u987B\u662F externalize \u6216 internalize");
+  if (on("purge-pg-bytes") && sub !== "externalize") throw new BlobsArgError("--purge-pg-bytes \u53EA\u914D externalize");
+  const op2 = on("purge-pg-bytes") ? "purge-pg-bytes" : sub;
+  const schema = flags.get("schema");
+  const all2 = on("all-schemas");
+  if (schema !== void 0 && all2) throw new BlobsArgError("--schema \u4E0E --all-schemas \u53EA\u80FD\u9009\u4E00\u4E2A");
+  if (schema === void 0 && !all2) throw new BlobsArgError("\u5FC5\u987B\u6307\u5B9A --schema <schema> \u6216 --all-schemas");
+  if (schema !== void 0 && (schema === "" || schema === "true")) throw new BlobsArgError("--schema \u9700\u8981 schema \u540D\uFF08\u5982 company_oasis-prod\u3001public\uFF09");
+  const int2 = (k6, dflt, min2) => {
+    const raw = flags.get(k6);
+    if (raw === void 0) return dflt;
+    const n3 = Number(raw);
+    if (!Number.isInteger(n3) || n3 < min2) throw new BlobsArgError(`--${k6} \u9700\u8981\u4E0D\u5C0F\u4E8E ${min2} \u7684\u6574\u6570`);
+    return n3;
+  };
+  return {
+    op: op2,
+    scope: schema !== void 0 ? { schema } : { all: true },
+    batch: int2("batch", DEFAULT_BATCH[op2], 1),
+    pauseMs: int2("pause-ms", DEFAULT_PAUSE_MS, 0),
+    dryRun: on("dry-run")
+  };
+}
+async function runBlobs(positional, flags, io) {
+  let args;
+  try {
+    args = parseBlobsArgs(positional, flags);
+  } catch (err) {
+    if (!(err instanceof BlobsArgError)) throw err;
+    io.err(`${err.message}
+${BLOBS_USAGE}`);
+    return 2;
+  }
+  const tag = `[blobs ${args.op}]`;
+  const pgDsn = io.env["OASIS_PG_DSN"] ?? io.env["DATABASE_URL"];
+  if (!pgDsn) {
+    io.err(`${tag} \u9700\u8981 OASIS_PG_DSN\uFF08\u6216 DATABASE_URL\uFF09\u2014\u2014\u8BF7\u4EE5 serve \u7684\u73AF\u5883\u6267\u884C\u672C\u547D\u4EE4\u3002`);
+    return 2;
+  }
+  const storage = await Promise.resolve().then(() => (init_src10(), src_exports));
+  let config2;
+  try {
+    config2 = storage.readBlobBackendConfig(io.env, { hasPg: true, dataDir: io.dir });
+  } catch (err) {
+    io.err(`${tag} \u5BF9\u8C61\u540E\u7AEF\u914D\u7F6E\u6709\u8BEF\uFF1A${err instanceof Error ? err.message : String(err)}`);
+    return 2;
+  }
+  if (config2.kind === "pg") {
+    io.err(`${tag} \u5F53\u524D OASIS_BLOB_BACKEND=pg\uFF08\u6216\u672A\u8BBE\uFF09\uFF1A\u672C\u547D\u4EE4\u8981\u4E0E serve \u540C\u4E00\u4E2A\u5BF9\u8C61\u540E\u7AEF\uFF08fs / s3\uFF09\u3002` + (args.op === "internalize" ? "\u56DE\u6EDA\u987B\u5728\u5207\u56DE pg \u4E4B\u524D\u3001\u4ECD\u662F fs / s3 \u914D\u7F6E\u65F6\u6267\u884C\uFF08ADR 0638 \xA76.3\uFF09\u3002" : ""));
+    return 2;
+  }
+  if (args.op === "purge-pg-bytes" && config2.dualWrite && !args.dryRun) {
+    io.err(`${tag} OASIS_BLOB_PG_DUAL_WRITE=on\uFF1A\u89C2\u5BDF\u671F\u8FD8\u6CA1\u7ED3\u675F\u3002\u5148\u5173\u53CC\u5199\u5E76\u91CD\u542F serve\uFF0C\u518D\u6E05 bytea\uFF08ADR 0638 \xA76.2 \u7B2C 6 \u6B65\uFF09\u3002`);
+    return 2;
+  }
+  if (args.op === "internalize" && !config2.dualWrite) {
+    io.out(`${tag} \u63D0\u793A\uFF1AOASIS_BLOB_PG_DUAL_WRITE \u672A\u5F00\u3002\u56DE\u6EDA\u671F\u95F4 serve \u65B0\u5199\u5165\u7684\u6587\u4EF6\u53EA\u5728\u5BF9\u8C61\u540E\u7AEF\uFF0C\u5207\u56DE pg \u540E\u4F1A\u8BFB\u4E0D\u5230\uFF1B\u5EFA\u8BAE\u5148\u5F00\u53CC\u5199\u5E76\u91CD\u542F serve\uFF0C\u518D\u8DD1\u672C\u547D\u4EE4\uFF08\u89C1 docs/oasis-dev-storage.md \xA72.5.4\uFF09\u3002`);
+  }
+  const pool = storage.createPgPool(pgDsn);
+  try {
+    const existing = await storage.listBlobSchemas(pool);
+    let schemas;
+    if ("schema" in args.scope) {
+      if (!existing.includes(args.scope.schema)) {
+        io.err(`${tag} schema ${args.scope.schema} \u6CA1\u6709 blobs \u8868\u3002\u6709 blobs \u8868\u7684 schema\uFF1A${existing.join(" ") || "\uFF08\u65E0\uFF09"}`);
+        return 2;
+      }
+      schemas = [args.scope.schema];
+    } else {
+      schemas = existing;
+    }
+    const backend = await storage.createObjectBackend(config2);
+    if (!backend) throw new Error("\u5BF9\u8C61\u540E\u7AEF\u88C5\u914D\u5931\u8D25");
+    io.out(`${tag} \u540E\u7AEF ${storage.describeBlobBackend(config2)}\uFF1B${schemas.length} \u4E2A schema\uFF1A${schemas.join(" ")}\uFF1B\u6BCF\u6279 ${args.batch} \u884C\u3001\u6279\u95F4 ${args.pauseMs}ms${args.dryRun ? "\uFF1Bdry-run\uFF08\u4E00\u884C\u4E0D\u52A8\uFF09" : ""}`);
+    const total = { rows: 0, bytes: 0, failed: 0 };
+    for (const schema of schemas) {
+      const store = await storage.ExternalizedBlobStore.open(pool, schema, backend, { dualWrite: config2.dualWrite });
+      const r5 = await storage.migrateBlobs(store, args.op, {
+        batch: args.batch,
+        pauseMs: args.pauseMs,
+        dryRun: args.dryRun,
+        ...io.shouldStop ? { shouldStop: io.shouldStop } : {},
+        ...io.sleep ? { sleep: io.sleep } : {},
+        onProgress: (p4) => io.out(`${tag} ${schema} \u7B2C ${p4.batches} \u6279\uFF1A\u5DF2\u5904\u7406 ${p4.rows}/${p4.candidateRows} \u884C\u3001${fmtBytes(p4.bytes)}/${fmtBytes(p4.candidateBytes)}\uFF0C\u5931\u8D25 ${p4.failed}`)
+      });
+      const c5 = r5.counts;
+      const tail = `\uFF08location\uFF1Apg ${c5.pg}\u3001ext ${c5.ext}\uFF0C\u5176\u4E2D bytea \u672A\u6E05 ${c5.extWithBytes}\uFF09`;
+      if (r5.dryRun) {
+        io.out(`${tag} ${schema} dry-run\uFF1A\u5F85\u5904\u7406 ${r5.candidateRows} \u884C\u3001${fmtBytes(r5.candidateBytes)}${tail}`);
+      } else {
+        io.out(`${tag} ${schema} ${r5.interrupted ? "\u5DF2\u4E2D\u65AD" : "\u5B8C\u6210"}\uFF1A\u5904\u7406 ${r5.rows} \u884C\u3001${fmtBytes(r5.bytes)}\uFF0C\u5931\u8D25 ${r5.failed}${tail}`);
+        for (const f6 of r5.failures) io.out(`  \u2717 ${f6.hash}\uFF1A${f6.error}`);
+        if (r5.failed > r5.failures.length) io.out(`  \u2026\u53E6\u6709 ${r5.failed - r5.failures.length} \u6761\u5931\u8D25\u672A\u5217\u51FA`);
+      }
+      total.rows += r5.rows;
+      total.bytes += r5.bytes;
+      total.failed += r5.failed;
+      if (r5.interrupted) {
+        io.err(`${tag} \u5DF2\u4E2D\u65AD\uFF1A\u5DF2\u5904\u7406\u7684\u884C\u4E0D\u4F1A\u91CD\u505A\uFF0C\u91CD\u8DD1\u540C\u4E00\u6761\u547D\u4EE4\u4ECE\u5269\u4E0B\u7684\u63A5\u7740\u505A\u3002`);
+        return 130;
+      }
+    }
+    if (!args.dryRun) {
+      io.out(`${tag} \u5408\u8BA1\uFF1A\u5904\u7406 ${total.rows} \u884C\u3001${fmtBytes(total.bytes)}\uFF0C\u5931\u8D25 ${total.failed}\u3002` + (total.failed > 0 ? "\u5931\u8D25\u7684\u884C\u4FDD\u6301\u539F\u72B6\uFF0C\u6392\u67E5\u540E\u91CD\u8DD1\u540C\u4E00\u547D\u4EE4\u53EA\u91CD\u8BD5\u5B83\u4EEC\u3002" : ""));
+    }
+    return total.failed > 0 ? 1 : 0;
+  } finally {
+    await pool.end().catch(() => void 0);
+  }
+}
+var BLOBS_USAGE, BlobsArgError, DEFAULT_BATCH, DEFAULT_PAUSE_MS, MB, fmtBytes;
+var init_blobs_command = __esm({
+  "../cli/src/blobs-command.ts"() {
+    "use strict";
+    BLOBS_USAGE = [
+      "\u7528\u6CD5\uFF1A",
+      "  oasis blobs externalize (--schema <s> | --all-schemas) [--batch 50] [--pause-ms 200] [--dry-run]",
+      "  oasis blobs externalize --purge-pg-bytes (--schema <s> | --all-schemas) [--batch 500] [--pause-ms 200] [--dry-run]",
+      "  oasis blobs internalize (--schema <s> | --all-schemas) [--batch 50] [--pause-ms 200] [--dry-run]"
+    ].join("\n");
+    BlobsArgError = class extends Error {
+    };
+    DEFAULT_BATCH = { externalize: 50, "purge-pg-bytes": 500, internalize: 50 };
+    DEFAULT_PAUSE_MS = 200;
+    MB = 1024 * 1024;
+    fmtBytes = (n3) => n3 >= MB ? `${(n3 / MB).toFixed(1)} MiB` : `${n3} B`;
+  }
+});
+
 // src/index.ts
 var fs55 = __toESM(require("node:fs"));
 init_src();
@@ -337190,6 +337466,46 @@ var COMMAND_DECLS = {
       "oasis usage-ledger-backfill --all --verify"
     ]
   },
+  blobs: {
+    group: "\u57FA\u7840\u8BBE\u65BD",
+    usage: "oasis blobs <externalize|internalize> (--schema <s> | --all-schemas) ...",
+    description: "\u4E8B\u5B9E\u67DC bytea \u8FC1\u51FA / \u6E05\u7A7A / \u56DE\u6EDA\uFF08ADR 0638 \xA76.2\u3001\xA76.3\uFF09\u3002\u4EE5 serve \u7684\u73AF\u5883\u5728\u90E8\u7F72\u673A\u4E0A\u6267\u884C\uFF0C\u5BF9\u8C61\u540E\u7AEF\u4E0E serve \u540C\u4E00\u5957\u88C5\u914D\u3002",
+    subCommands: ["blobs externalize", "blobs internalize"]
+  },
+  "blobs externalize": {
+    group: "\u57FA\u7840\u8BBE\u65BD",
+    usage: "oasis blobs externalize [--purge-pg-bytes] (--schema <s> | --all-schemas) [--batch 50] [--pause-ms 200] [--dry-run]",
+    description: "\u628A location='pg' \u7684\u884C\u9010\u4E2A\u5199\u8FDB\u5BF9\u8C61\u540E\u7AEF\uFF08\u8BFB\u56DE\u6821\u9A8C sha256 \u540E\u6539 location='ext'\uFF0C\u4FDD\u7559 bytea\uFF09\uFF1B\u5E26 --purge-pg-bytes \u65F6\u6539\u4E3A\u5206\u6279\u6E05\u7A7A\u5DF2\u5916\u90E8\u5316\u884C\u7684 bytea\uFF08\u5148\u6838\u5BF9\u5BF9\u8C61\u5728\u4E14\u5927\u5C0F\u4E00\u81F4\uFF09\u3002\u5206\u6279\u3001\u6279\u95F4\u9650\u901F\u3001\u6BCF\u6279\u8F93\u51FA\u8FDB\u5EA6\uFF1BCtrl-C \u5904\u7406\u5B8C\u5F53\u524D\u4E00\u884C\u518D\u505C\uFF0C\u91CD\u8DD1\u540C\u4E00\u547D\u4EE4\u7EED\u8DD1\u3002\u9000\u51FA\u7801\uFF1A0 \u5B8C\u6210\u30011 \u6709\u884C\u5931\u8D25\u30012 \u53C2\u6570/\u73AF\u5883\u9519\u8BEF\u3001130 \u88AB\u4E2D\u65AD\u3002",
+    flags: [
+      { name: "schema", desc: "\u53EA\u5904\u7406\u8FD9\u4E2A schema\uFF08\u5982 company_oasis-prod\u3001public\uFF09\uFF1B\u987B\u5DF2\u6709 blobs \u8868" },
+      { name: "all-schemas", desc: "\u6240\u6709\u6709 blobs \u8868\u7684 schema\uFF0C\u542B\u5171\u4EAB schema public", boolean: true },
+      { name: "purge-pg-bytes", desc: "\u6E05\u7A7A\u5DF2\u5916\u90E8\u5316\u884C\u7684 bytea\uFF08\u89C2\u5BDF\u671F\u7ED3\u675F\u3001\u5173\u53CC\u5199\u5E76\u91CD\u542F serve \u4E4B\u540E\uFF1B\u53CC\u5199\u5F00\u7740\u65F6\u62D2\u7EDD\uFF09", boolean: true },
+      { name: "batch", desc: "\u6BCF\u6279\u884C\u6570\uFF08\u7F3A\u7701 50\uFF1B--purge-pg-bytes \u7F3A\u7701 500\uFF09" },
+      { name: "pause-ms", desc: "\u6279\u95F4\u505C\u987F\u6BEB\u79D2\u6570\uFF08\u7F3A\u7701 200\uFF09" },
+      { name: "dry-run", desc: "\u53EA\u62A5\u6BCF\u4E2A schema \u5F85\u5904\u7406\u7684\u884C\u6570\u548C\u5B57\u8282\u6570\uFF0C\u4E00\u884C\u4E0D\u52A8", boolean: true }
+    ],
+    examples: [
+      "oasis blobs externalize --all-schemas --dry-run",
+      "oasis blobs externalize --schema company_oasis-prod --batch 50",
+      "oasis blobs externalize --purge-pg-bytes --all-schemas"
+    ]
+  },
+  "blobs internalize": {
+    group: "\u57FA\u7840\u8BBE\u65BD",
+    usage: "oasis blobs internalize (--schema <s> | --all-schemas) [--batch 50] [--pause-ms 200] [--dry-run]",
+    description: "\u56DE\u6EDA\uFF1A\u628A\u5BF9\u8C61\u5199\u56DE bytea\uFF08\u6821\u9A8C sha256\uFF09\u5E76\u6539 location='pg'\u3002\u987B\u5728\u5207\u56DE OASIS_BLOB_BACKEND=pg \u4E4B\u524D\u3001\u4ECD\u662F fs / s3 \u914D\u7F6E\u65F6\u6267\u884C\uFF1B\u5EFA\u8BAE\u5148\u5F00\u53CC\u5199\u5E76\u91CD\u542F serve\u3002\u5206\u6279\u3001\u9650\u901F\u3001\u8FDB\u5EA6\u3001\u53EF\u4E2D\u65AD\u7EED\u8DD1\uFF0C\u9000\u51FA\u7801\u540C externalize\u3002",
+    flags: [
+      { name: "schema", desc: "\u53EA\u5904\u7406\u8FD9\u4E2A schema\uFF1B\u987B\u5DF2\u6709 blobs \u8868" },
+      { name: "all-schemas", desc: "\u6240\u6709\u6709 blobs \u8868\u7684 schema\uFF0C\u542B\u5171\u4EAB schema public", boolean: true },
+      { name: "batch", desc: "\u6BCF\u6279\u884C\u6570\uFF08\u7F3A\u7701 50\uFF09" },
+      { name: "pause-ms", desc: "\u6279\u95F4\u505C\u987F\u6BEB\u79D2\u6570\uFF08\u7F3A\u7701 200\uFF09" },
+      { name: "dry-run", desc: "\u53EA\u62A5\u5F85\u5199\u56DE\u7684\u884C\u6570\u548C\u5B57\u8282\u6570\uFF0C\u4E00\u884C\u4E0D\u52A8", boolean: true }
+    ],
+    examples: [
+      "oasis blobs internalize --all-schemas --dry-run",
+      "oasis blobs internalize --all-schemas"
+    ]
+  },
   kb: {
     group: "\u77E5\u8BC6\u5E93",
     usage: "oasis kb <ask|ingest|status|maintain|lint> ...",
@@ -339615,7 +339931,7 @@ async function waitForCommandAuthorization(base, headers, draftId, fallback2) {
     }
   }
 }
-var CLI_VERSION = "2.2.119" ? "2.2.119" : "dev";
+var CLI_VERSION = "2.2.120" ? "2.2.120" : "dev";
 function apiHeaders(token2, company) {
   const headers = {
     authorization: `Bearer ${token2}`,
@@ -339977,6 +340293,31 @@ async function runCli(argv, println = console.log, progressln = console.error) {
     });
     return;
   }
+  if (command6 === "blobs") {
+    const { runBlobs: runBlobs2 } = await Promise.resolve().then(() => (init_blobs_command(), blobs_command_exports));
+    let stopRequested = false;
+    const onSignal = () => {
+      if (stopRequested) process.exit(130);
+      stopRequested = true;
+      process.stderr.write("[blobs] \u6536\u5230\u4E2D\u65AD\uFF1A\u5904\u7406\u5B8C\u5F53\u524D\u8FD9\u4E00\u884C\u540E\u505C\u6B62\uFF08\u518D\u6309\u4E00\u6B21\u7ACB\u5373\u9000\u51FA\uFF09\n");
+    };
+    process.on("SIGINT", onSignal);
+    process.on("SIGTERM", onSignal);
+    try {
+      process.exitCode = await runBlobs2(positional, flags, {
+        out: (line2) => println(line2),
+        err: (line2) => process.stderr.write(`${line2}
+`),
+        env: process.env,
+        dir,
+        shouldStop: () => stopRequested
+      });
+    } finally {
+      process.off("SIGINT", onSignal);
+      process.off("SIGTERM", onSignal);
+    }
+    return;
+  }
   if (command6 === "node-token") {
     const store = createNodeTokenStore(path42.join(dir, "node-tokens.json"));
     const sub = positional[0];
@@ -343793,7 +344134,7 @@ function shimScript() {
 }
 
 // src/index.ts
-var PKG_VERSION = true ? "2.2.119" : "dev";
+var PKG_VERSION = true ? "2.2.120" : "dev";
 var LOCAL_BIN = localBin();
 var NPM_PREFIX = npmPrefix();
 var INSTANCE = DEFAULT_INSTANCE;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oasis_test_v2",
-  "version": "2.2.119",
+  "version": "2.2.120",
   "description": "Oasis node daemon + CLI — background daemon, auto-start, full server CLI",
   "bin": {
     "oasis": "./dist/index.js"
@@ -26,6 +26,6 @@
     "node": ">=20"
   },
   "oasisRelease": {
-    "sourceHead": "4f51168d5c54f729336eeef57637cda2fa6372b8"
+    "sourceHead": "5cbcb042286da9da2e41e738c8d76bfbe2324d57"
   }
 }