@warmhub/cli 0.49.0 → 0.50.0

package/dist/wh.js

@@ -19527,7 +19527,7 @@ function findSystemComponent(componentId) {
 // ../../packages/sdk-ts/package.json
 var package_default = {
   name: "@warmhub/sdk-ts",
-  version: "0.48.0",
+  version: "0.50.0",
   private: false,
   type: "module",
   description: "The TypeScript SDK for WarmHub — create repos, commit and query data, and compound knowledge with your AI agents.",
@@ -19825,9 +19825,6 @@ async function submitOperationsViaStream(client, args) {
   if (args.operations.length === 0) {
     throw new StreamValidationError("At least one operation is required for stream submission.");
   }
-  if ((args.allocatedTokens?.length ?? 0) > 0 && args.streamId === undefined) {
-    throw new StreamValidationError("Manual stream resume with allocatedTokens requires the original streamId.");
-  }
   const operations = args.operations.map((operation, index) => {
     let streamOperation;
     try {
@@ -19843,9 +19840,8 @@ async function submitOperationsViaStream(client, args) {
   });
   const chunkSize = normalizeChunkSize(args.chunkSize);
   let streamId = args.streamId ?? createStreamId();
-  const isManualResume = args.streamId !== undefined || (args.allocatedTokens?.length ?? 0) > 0;
-  const policy = isManualResume ? false : resolveRetryPolicy(args.retry);
-  let allocatedTokens = args.allocatedTokens ?? [];
+  const policy = args.streamId !== undefined ? false : resolveRetryPolicy(args.retry);
+  let allocatedTokenRanges = [];
   let createdByEmail;
   const chunkResults = [];
   let sawAmbiguousAttempt = false;
@@ -19857,7 +19853,7 @@ async function submitOperationsViaStream(client, args) {
     while (true) {
       try {
         const appendResult = await client.stream.append({
-          allocatedTokens,
+          allocatedTokenRanges,
           orgName: args.orgName,
           repoName: args.repoName,
           streamId,
@@ -19866,7 +19862,7 @@ async function submitOperationsViaStream(client, args) {
           message: args.message,
           operations: chunk
         });
-        allocatedTokens = appendResult.allocatedTokens;
+        allocatedTokenRanges = appendResult.allocatedTokenRanges;
         if (appendResult.createdByEmail !== undefined) {
           createdByEmail = appendResult.createdByEmail;
         }
@@ -19882,7 +19878,7 @@ async function submitOperationsViaStream(client, args) {
           priorAttemptAmbiguous = true;
           sawAmbiguousAttempt = true;
           streamId = createStreamId();
-          allocatedTokens = [];
+          allocatedTokenRanges = [];
           continue;
         }
         const completedOperations = completedOperationsFrom(toSubmittedStreamResult({
@@ -20059,6 +20055,27 @@ function toSubmittedStreamResult(writeResult, committer, createdByEmail, message
   };
 }
 // ../../packages/sdk-ts/src/index.ts
+var WARMHUB_CLIENT_OPTION_NAMES = [
+  "apiUrl",
+  "fetch",
+  "accessToken",
+  "auth",
+  "functionLogs"
+];
+var WARMHUB_CLIENT_OPTION_NAME_SET = new Set(WARMHUB_CLIENT_OPTION_NAMES);
+var ACCESS_TOKEN_OPTION_ALIASES = new Set(["token", "apiKey", "bearer"]);
+function validateWarmHubClientOptions(options) {
+  if (!options) {
+    return;
+  }
+  for (const key of Object.keys(options)) {
+    if (WARMHUB_CLIENT_OPTION_NAME_SET.has(key)) {
+      continue;
+    }
+    const hint = ACCESS_TOKEN_OPTION_ALIASES.has(key) ? '; did you mean "accessToken"?' : `. Valid options are: ${WARMHUB_CLIENT_OPTION_NAMES.join(", ")}.`;
+    throw new TypeError(`Unknown WarmHubClient option "${key}"${hint}`);
+  }
+}
 var SDK_VERSION = typeof __SDK_VERSION__ !== "undefined" ? __SDK_VERSION__ : package_default.version;
 var DEFAULT_API_URL = "https://api.warmhub.ai";
 var UNBATCHED_TRPC_PATHS = new Set([
@@ -20162,16 +20179,18 @@ class WarmHubError extends Error {
   status;
   hint;
   retryAfter;
+  errorCode;
   backendCode;
   details;
-  constructor(code, message, status, hint, retryAfter, backendCode, details) {
+  constructor(code, message, status, hint, retryAfter, errorCode, details) {
     super(message);
     this.name = "WarmHubError";
     this.code = code;
     this.status = status;
     this.hint = hint;
     this.retryAfter = retryAfter;
-    this.backendCode = backendCode;
+    this.errorCode = errorCode;
+    this.backendCode = errorCode;
     this.details = details;
   }
   get kind() {
@@ -20202,7 +20221,7 @@ function toWarmHubError(error) {
   if (error instanceof Error) {
     const warmhubLike = error;
     if (error.name === "WarmHubError" && typeof warmhubLike.code === "string") {
-      return new WarmHubError(warmhubLike.code, sanitizeErrorMessage(error.message), typeof warmhubLike.status === "number" ? warmhubLike.status : undefined, typeof warmhubLike.hint === "string" ? warmhubLike.hint : undefined, typeof warmhubLike.retryAfter === "number" ? warmhubLike.retryAfter : undefined, typeof warmhubLike.backendCode === "string" ? warmhubLike.backendCode : undefined, warmhubLike.details);
+      return new WarmHubError(warmhubLike.code, sanitizeErrorMessage(error.message), typeof warmhubLike.status === "number" ? warmhubLike.status : undefined, typeof warmhubLike.hint === "string" ? warmhubLike.hint : undefined, typeof warmhubLike.retryAfter === "number" ? warmhubLike.retryAfter : undefined, typeof warmhubLike.errorCode === "string" ? warmhubLike.errorCode : typeof warmhubLike.backendCode === "string" ? warmhubLike.backendCode : undefined, warmhubLike.details);
     }
     if (error.name === "AbortError") {
       return new WarmHubError("CANCELLED", error.message);
@@ -20545,7 +20564,6 @@ class WarmHubClient {
           chunkSize: opts?.chunkSize,
           skipExisting: opts?.skipExisting,
           streamId: opts?.streamId,
-          allocatedTokens: opts?.allocatedTokens,
           retry: opts?.retry,
           operations
         });
@@ -20896,19 +20914,19 @@ class WarmHubClient {
         throw toWarmHubError(error);
       }
     },
-    getReadme: async (orgName, repoName) => {
+    listForCaller: async (opts) => {
       try {
-        return await this.trpc.repo.getReadme.query({
-          orgName,
-          repoName
+        return await this.trpc.repo.listForCaller.query({
+          limit: opts?.limit,
+          sort: opts?.sort
         });
       } catch (error) {
         throw toWarmHubError(error);
       }
     },
-    generateReadme: async (orgName, repoName) => {
+    getReadme: async (orgName, repoName) => {
       try {
-        return await this.trpc.repo.generateReadme.mutate({
+        return await this.trpc.repo.getReadme.query({
           orgName,
           repoName
         });
@@ -20950,16 +20968,6 @@ class WarmHubClient {
         throw toWarmHubError(error);
       }
     },
-    generateAgents: async (orgName, repoName) => {
-      try {
-        return await this.trpc.repo.generateAgents.mutate({
-          orgName,
-          repoName
-        });
-      } catch (error) {
-        throw toWarmHubError(error);
-      }
-    },
     getLlmsTxt: async (orgName, repoName) => {
       try {
         return await this.trpc.repo.getLlmsTxt.query({
@@ -21263,6 +21271,18 @@ class WarmHubClient {
         throw toWarmHubError(error);
       }
     },
+    runStats: async (orgName, repoName, opts) => {
+      try {
+        return await this.trpc.action.runStats.query({
+          orgName,
+          repoName,
+          subscriptionName: opts?.subscriptionName,
+          since: opts?.since
+        });
+      } catch (error) {
+        throw toWarmHubError(error);
+      }
+    },
     getRunAttempts: async (orgName, repoName, runId) => {
       try {
         return await this.trpc.action.getRunAttempts.query({
@@ -21785,6 +21805,7 @@ class WarmHubClient {
   credentials = this.credential;
   constructor(apiUrlOrOptions, maybeOptions) {
     const options = typeof apiUrlOrOptions === "string" ? maybeOptions : apiUrlOrOptions;
+    validateWarmHubClientOptions(options);
     const apiUrl = typeof apiUrlOrOptions === "string" ? apiUrlOrOptions : apiUrlOrOptions?.apiUrl ?? DEFAULT_API_URL;
     this.apiUrl = apiUrl;
     this.fetchImpl = options?.fetch;
@@ -21920,7 +21941,7 @@ class WarmHubClient {
     if (!response.ok) {
       let message = `Request failed with status ${response.status}`;
       let code = httpStatusToWarmHubCode(response.status);
-      let backendCode;
+      let errorCode;
       let hint;
       let retryAfter;
       try {
@@ -21930,7 +21951,7 @@ class WarmHubClient {
         }
         if (typeof body.error?.code === "string") {
           code = body.error.code;
-          backendCode = body.error.code;
+          errorCode = body.error.code;
         }
         if (typeof body.error?.hint === "string") {
           hint = body.error.hint;
@@ -21939,7 +21960,7 @@ class WarmHubClient {
           retryAfter = body.error.retryAfter;
         }
       } catch {}
-      throw new WarmHubError(code, message, response.status, hint, retryAfter, backendCode);
+      throw new WarmHubError(code, message, response.status, hint, retryAfter, errorCode);
     }
     return response;
   }
@@ -22068,6 +22089,9 @@ class CliError extends Error {
     this.backendCode = backendCode;
     this.context = context;
   }
+  get errorCode() {
+    return this.backendCode;
+  }
 }
 function unauthenticatedHint(message) {
   if (message.includes("Authentication required")) {
@@ -22153,7 +22177,7 @@ var CONFLICT_SHAPED_CODES = new Set([
   "LEASE_UNAVAILABLE"
 ]);
 function fromWh(exit, kind, err, hint = err.hint) {
-  return new CliError(exit, kind, err.message, err, hint, undefined, err.backendCode);
+  return new CliError(exit, kind, err.message, err, hint, undefined, err.errorCode);
 }
 function usageError(usage, example) {
   throw new CliError(2 /* UserInput */, "USER_INPUT", usage, undefined, `Example: ${example}`);
@@ -22180,7 +22204,7 @@ function toCliError(err) {
       return fromWh(exit, err.code, err);
     }
     if (CONFLICT_SHAPED_CODES.has(err.code)) {
-      return fromWh(2 /* UserInput */, "CONFLICT", err, err.hint ?? conflictHint(err.message, err.backendCode ?? err.code));
+      return fromWh(2 /* UserInput */, "CONFLICT", err, err.hint ?? conflictHint(err.message, err.errorCode ?? err.code));
     }
     if (err.code === "RATE_LIMITED") {
       const retryAfter = err.retryAfter;
@@ -22224,7 +22248,7 @@ function isAlreadyExistsError(err, seen = new WeakSet) {
   }
   return isAlreadyExistsError(err.cause, seen);
 }
-function generateSuggestions(code, message, context, backendCode) {
+function generateSuggestions(code, message, context, errorCode) {
   const suggestions = [];
   if (code === "CONFIG" && (message.includes("repo") || message.includes("WARMHUB_REPO"))) {
     suggestions.push({
@@ -22281,7 +22305,7 @@ function generateSuggestions(code, message, context, backendCode) {
     }
   }
   if (code === "CONFLICT") {
-    switch (classifyConflict(message, backendCode)) {
+    switch (classifyConflict(message, errorCode)) {
       case "already-exists":
         suggestions.push({
           action: "Update the existing item instead of creating a new one"
@@ -22436,8 +22460,8 @@ var OP_USER_INPUT_CODES = new Set([
 function cliErrorFromOpFailure(failure) {
   const code = failure.error?.code ?? "BACKEND";
   const message = failure.error?.message ?? `Operation on "${failure.name}" failed`;
-  const backendCode = failure.error?.code;
-  const make = (exit, kind, hint) => new CliError(exit, kind, message, undefined, hint, undefined, backendCode);
+  const errorCode = failure.error?.code;
+  const make = (exit, kind, hint) => new CliError(exit, kind, message, undefined, hint, undefined, errorCode);
   if (code === "FORBIDDEN" || code === "UNAUTHENTICATED") {
     return make(5 /* Auth */, "AUTH");
   }
@@ -22491,11 +22515,11 @@ function assertSingleOpSuccess(result) {
 function printCliError(err, errWriter, opts = {}) {
   const debugEnabled = opts.debug || process.env.WARMHUB_DEBUG === "1";
   if (opts.format === "json" || opts.format === "jsonl") {
-    const suggestions = generateSuggestions(err.kind, err.message, err.context, err.backendCode);
+    const suggestions = generateSuggestions(err.kind, err.message, err.context, err.errorCode);
     const envelope = {
       error: {
         code: err.kind,
-        ...err.backendCode ? { backendCode: err.backendCode } : {},
+        ...err.errorCode ? { errorCode: err.errorCode, backendCode: err.errorCode } : {},
         message: err.message,
         ...err.hint ? { hint: err.hint } : {},
         ...suggestions.length > 0 ? { suggestions } : {},
@@ -23647,25 +23671,11 @@ function accessTokenExpiry(accessToken) {
 var BENCHMARK_HEADER = "x-warmhub-benchmark-id";
 var REQUEST_TOTAL_MS_HEADER = "x-warmhub-request-total-ms";
 var REQUEST_DB_QUERY_COUNT_HEADER = "x-warmhub-request-db-query-count";
-var REQUEST_PEAK_HEAP_USED_HEADER = "x-warmhub-request-peak-heap-used-bytes";
-var REQUEST_PEAK_RSS_HEADER = "x-warmhub-request-peak-rss-bytes";
-var REQUEST_PEAK_EXTERNAL_HEADER = "x-warmhub-request-peak-external-bytes";
-var REQUEST_RETAINED_CAPTURE_MS_HEADER = "x-warmhub-request-retained-capture-ms";
-var REQUEST_RETAINED_HEAP_USED_HEADER = "x-warmhub-request-retained-heap-used-bytes";
-var REQUEST_RETAINED_RSS_HEADER = "x-warmhub-request-retained-rss-bytes";
-var REQUEST_RETAINED_EXTERNAL_HEADER = "x-warmhub-request-retained-external-bytes";
 var benchmarkTelemetry = emptyBenchmarkTelemetry();
 function emptyBenchmarkTelemetry() {
   return {
     requestCount: 0,
     requestDbQueryCountSum: 0,
-    requestRetainedCaptureMsMax: 0,
-    requestRetainedExternalBytesMax: 0,
-    requestRetainedHeapUsedBytesMax: 0,
-    requestRetainedRssBytesMax: 0,
-    requestPeakExternalBytesMax: 0,
-    requestPeakHeapUsedBytesMax: 0,
-    requestPeakRssBytesMax: 0,
     requestTotalMsMax: 0,
     requestTotalMsSum: 0
   };
@@ -23683,14 +23693,7 @@ function recordBenchmarkResponse(response, benchmarkId) {
     return;
   const requestTotalMs = parseHeaderNumber(response.headers.get(REQUEST_TOTAL_MS_HEADER));
   const requestDbQueryCount = parseHeaderNumber(response.headers.get(REQUEST_DB_QUERY_COUNT_HEADER));
-  const requestPeakHeapUsedBytes = parseHeaderNumber(response.headers.get(REQUEST_PEAK_HEAP_USED_HEADER));
-  const requestPeakRssBytes = parseHeaderNumber(response.headers.get(REQUEST_PEAK_RSS_HEADER));
-  const requestPeakExternalBytes = parseHeaderNumber(response.headers.get(REQUEST_PEAK_EXTERNAL_HEADER));
-  const requestRetainedCaptureMs = parseHeaderNumber(response.headers.get(REQUEST_RETAINED_CAPTURE_MS_HEADER));
-  const requestRetainedHeapUsedBytes = parseHeaderNumber(response.headers.get(REQUEST_RETAINED_HEAP_USED_HEADER));
-  const requestRetainedRssBytes = parseHeaderNumber(response.headers.get(REQUEST_RETAINED_RSS_HEADER));
-  const requestRetainedExternalBytes = parseHeaderNumber(response.headers.get(REQUEST_RETAINED_EXTERNAL_HEADER));
-  if (requestTotalMs === null && requestDbQueryCount === null && requestPeakHeapUsedBytes === null && requestPeakRssBytes === null && requestPeakExternalBytes === null && requestRetainedCaptureMs === null && requestRetainedHeapUsedBytes === null && requestRetainedRssBytes === null && requestRetainedExternalBytes === null) {
+  if (requestTotalMs === null && requestDbQueryCount === null) {
     return;
   }
   benchmarkTelemetry.requestCount += 1;
@@ -23701,27 +23704,6 @@ function recordBenchmarkResponse(response, benchmarkId) {
   if (requestDbQueryCount !== null) {
     benchmarkTelemetry.requestDbQueryCountSum += requestDbQueryCount;
   }
-  if (requestPeakHeapUsedBytes !== null) {
-    benchmarkTelemetry.requestPeakHeapUsedBytesMax = Math.max(benchmarkTelemetry.requestPeakHeapUsedBytesMax, requestPeakHeapUsedBytes);
-  }
-  if (requestPeakRssBytes !== null) {
-    benchmarkTelemetry.requestPeakRssBytesMax = Math.max(benchmarkTelemetry.requestPeakRssBytesMax, requestPeakRssBytes);
-  }
-  if (requestPeakExternalBytes !== null) {
-    benchmarkTelemetry.requestPeakExternalBytesMax = Math.max(benchmarkTelemetry.requestPeakExternalBytesMax, requestPeakExternalBytes);
-  }
-  if (requestRetainedCaptureMs !== null) {
-    benchmarkTelemetry.requestRetainedCaptureMsMax = Math.max(benchmarkTelemetry.requestRetainedCaptureMsMax, requestRetainedCaptureMs);
-  }
-  if (requestRetainedHeapUsedBytes !== null) {
-    benchmarkTelemetry.requestRetainedHeapUsedBytesMax = Math.max(benchmarkTelemetry.requestRetainedHeapUsedBytesMax, requestRetainedHeapUsedBytes);
-  }
-  if (requestRetainedRssBytes !== null) {
-    benchmarkTelemetry.requestRetainedRssBytesMax = Math.max(benchmarkTelemetry.requestRetainedRssBytesMax, requestRetainedRssBytes);
-  }
-  if (requestRetainedExternalBytes !== null) {
-    benchmarkTelemetry.requestRetainedExternalBytesMax = Math.max(benchmarkTelemetry.requestRetainedExternalBytesMax, requestRetainedExternalBytes);
-  }
 }
 function createBenchmarkAwareFetch(benchmarkId) {
   if (!benchmarkId)
@@ -27866,6 +27848,7 @@ import { createInterface } from "node:readline";
 class StreamProgressReporter {
   ctx;
   active;
+  jsonl;
   requested;
   sourceKind;
   totalOps;
@@ -27874,10 +27857,12 @@ class StreamProgressReporter {
   startedAtMs = 0;
   opsAppended = 0;
   chunksAppended = 0;
+  summaryEmitted = false;
   constructor(ctx, opts) {
     this.ctx = ctx;
     this.requested = opts.requested;
     this.active = opts.requested && ctx.stderrIsTTY === true;
+    this.jsonl = opts.requested && ctx.stderrIsTTY !== true;
     this.sourceKind = opts.sourceKind;
     this.totalOps = opts.totalOps;
   }
@@ -27885,7 +27870,7 @@ class StreamProgressReporter {
     return this.requested;
   }
   get enabled() {
-    return this.active;
+    return this.requested;
   }
   start(startedAtMs) {
     this.startedAtMs = startedAtMs;
@@ -27896,11 +27881,32 @@ class StreamProgressReporter {
   onChunkAppended(args) {
     this.opsAppended = args.opsAppended;
     this.chunksAppended = args.chunksAppended;
+    if (this.jsonl) {
+      this.writeJsonl({
+        type: "stream.progress",
+        chunksAppended: this.chunksAppended,
+        elapsedMs: Math.round(args.nowMs - this.startedAtMs),
+        opsAppended: this.opsAppended,
+        sourceKind: this.sourceKind,
+        ...this.totalOps === undefined ? {} : { totalOps: this.totalOps }
+      });
+      return;
+    }
     if (!this.active)
       return;
     this.renderLine(this.renderReading(args.nowMs));
   }
   onComplete(args) {
+    if (this.jsonl) {
+      this.emitSummary({
+        appendMs: args.appendMs,
+        chunkCount: args.chunkCount,
+        nowMs: args.nowMs,
+        opCount: args.opCount,
+        status: "success"
+      });
+      return;
+    }
     if (!this.active)
       return;
     this.clearLine();
@@ -27909,10 +27915,37 @@ class StreamProgressReporter {
     this.ctx.err(`progress: ${args.opCount} ops, ${args.chunkCount} chunks, ${elapsedSeconds}s, ${appendThroughput} ops/s append`);
   }
   onError() {
+    if (this.jsonl) {
+      this.emitSummary({
+        chunkCount: this.chunksAppended,
+        nowMs: performance.now(),
+        opCount: this.opsAppended,
+        status: "error"
+      });
+      return;
+    }
     if (!this.active)
       return;
     this.clearLine();
   }
+  emitSummary(args) {
+    if (this.summaryEmitted)
+      return;
+    this.summaryEmitted = true;
+    const elapsedMs = Math.round(args.nowMs - this.startedAtMs);
+    const appendThroughput = args.appendMs === undefined ? undefined : Math.round(args.opCount / Math.max(args.appendMs / 1000, 0.001));
+    this.writeJsonl({
+      type: "stream.summary",
+      chunkCount: args.chunkCount,
+      elapsedMs,
+      opCount: args.opCount,
+      sourceKind: this.sourceKind,
+      status: args.status,
+      ...appendThroughput === undefined ? {} : { appendThroughput },
+      ...args.appendMs === undefined ? {} : { appendMs: Math.round(args.appendMs) },
+      ...this.totalOps === undefined ? {} : { totalOps: this.totalOps }
+    });
+  }
   renderReading(nowMs) {
     const elapsed = formatElapsed(nowMs - this.startedAtMs);
     if (this.sourceKind === "file" && this.totalOps != null) {
@@ -27940,6 +27973,9 @@ class StreamProgressReporter {
   writeRaw(chunk) {
     (this.ctx.stderrWrite ?? ((value) => process.stderr.write(value)))(chunk);
   }
+  writeJsonl(payload) {
+    this.ctx.err(JSON.stringify(payload));
+  }
 }
 async function countNonEmptyJsonlLines(path2) {
   const lines = createInterface({
@@ -28022,8 +28058,7 @@ function toCommitSubmitResult(args) {
     const status = streamAppendResultStatus(operation);
     if (status === "error") {
       statusCounts.error++;
-      const submittedIndex = opIndex - (args.submittedOperationOffset ?? 0);
-      const submittedOperation = submittedIndex >= 0 ? args.submittedOperations?.[submittedIndex] : undefined;
+      const submittedOperation = args.submittedOperations?.[opIndex];
       return {
         opIndex,
         name: operation.name ?? "",
@@ -28056,25 +28091,6 @@ function toCommitSubmitResult(args) {
     operations
   };
 }
-function createStreamId2() {
-  return globalThis.crypto.randomUUID();
-}
-function parseAllocatedTokensFlag(raw) {
-  if (raw === undefined)
-    return;
-  const parsed = safeParseJson(raw, "--allocated-tokens");
-  if (!Array.isArray(parsed) || !parsed.every((entry) => {
-    if (!isPlainObject(entry))
-      return false;
-    const tokenNumber = entry.tokenNumber;
-    return Number.isInteger(tokenNumber) && Number(tokenNumber) > 0;
-  })) {
-    throw new CliError(2 /* UserInput */, "USER_INPUT", '--allocated-tokens must be a JSON array like [{"tokenNumber":1}].');
-  }
-  return parsed.map((entry) => ({
-    tokenNumber: entry.tokenNumber
-  }));
-}
 function backendErrorCode(error) {
   if (typeof error !== "object" || error === null) {
     return;
@@ -28128,14 +28144,13 @@ async function applyJsonlCommit(ctx, args) {
   });
   resetBenchmarkTelemetry();
   const t0 = performance.now();
-  const streamId = args.streamId ?? createStreamId2();
-  const operationOffset = Math.max(0, Math.trunc(args.operationOffset ?? 0));
+  const streamId = args.streamId;
   const tAppendStart = performance.now();
   progress.start(t0);
   try {
     const operations = [];
     const submittedOperations = [];
-    let allocatedTokens = args.allocatedTokens ?? [];
+    let allocatedTokenRanges = [];
     let createdByEmail;
     let opCount = 0;
     let parsedOpCount = 0;
@@ -28149,7 +28164,7 @@ async function applyJsonlCommit(ctx, args) {
       let appendResult;
       try {
         appendResult = await ctx.client.stream.append({
-          allocatedTokens,
+          allocatedTokenRanges,
           orgName: args.org,
           repoName: args.repo,
           streamId,
@@ -28158,7 +28173,7 @@ async function applyJsonlCommit(ctx, args) {
           operations: operationsChunk
         });
       } catch (cause) {
-        const completed = operationOffset + opCount;
+        const completed = opCount;
         if (opCount > 0 || firstJsonlAppendErrorMayHaveCommitted(cause)) {
           const backendCode = toWarmHubError(cause).backendCode;
           const suffix = backendCode ? ` (backend: ${backendCode})` : "";
@@ -28166,7 +28181,7 @@ async function applyJsonlCommit(ctx, args) {
         }
         throw cause;
       }
-      allocatedTokens = appendResult.allocatedTokens ?? allocatedTokens;
+      allocatedTokenRanges = appendResult.allocatedTokenRanges;
       if (appendResult.createdByEmail !== undefined) {
         createdByEmail = appendResult.createdByEmail;
       }
@@ -28198,7 +28213,7 @@ async function applyJsonlCommit(ctx, args) {
         refInsertMs: subphases?.refInsertMs,
         refSourceCount: subphases?.refSourceCount
       });
-      operations.push(...offsetChunkResultIndexes2(appendResult.results, operationOffset + opCount));
+      operations.push(...offsetChunkResultIndexes2(appendResult.results, opCount));
       submittedOperations.push(...operationsChunk);
       opCount += operationsChunk.length;
       chunkCount++;
@@ -28226,13 +28241,8 @@ async function applyJsonlCommit(ctx, args) {
           } catch (cause) {
             if (cause instanceof CliError) {
               if (opCount > 0) {
-                const completed = operationOffset + opCount;
-                const baseHint = cause.hint && cause.hint.length > 0 ? `${cause.hint} ` : "";
-                throw new CliError(4 /* Backend */, "BACKEND", `${cause.message} (${completed} earlier operation(s) already acknowledged by the server before this NUL-byte rejection).`, undefined, `${baseHint}The earlier chunks have landed; inspect repository state before submitting any remaining JSONL operations.`);
-              }
-              if (operationOffset > 0) {
                 const baseHint = cause.hint && cause.hint.length > 0 ? `${cause.hint} ` : "";
-                throw new CliError(cause.code, cause.kind, `${cause.message} (${operationOffset} earlier operation(s) already acknowledged by the server in a prior run; this run made no backend writes before the NUL-byte rejection).`, undefined, `${baseHint}Fix the offending input; the prior-run chunks remain landed and unaffected by this local validation failure.`);
+                throw new CliError(4 /* Backend */, "BACKEND", `${cause.message} (${opCount} earlier operation(s) already acknowledged by the server before this NUL-byte rejection).`, undefined, `${baseHint}The earlier chunks have landed; inspect repository state before submitting any remaining JSONL operations.`);
               }
             }
             throw cause;
@@ -28342,13 +28352,6 @@ async function applyJsonlCommit(ctx, args) {
         requestTotalMsSum: benchmarkTelemetry2.requestTotalMsSum,
         requestTotalMsMax: benchmarkTelemetry2.requestTotalMsMax,
         requestDbQueryCountSum: benchmarkTelemetry2.requestDbQueryCountSum,
-        requestRetainedCaptureMsMax: benchmarkTelemetry2.requestRetainedCaptureMsMax,
-        requestRetainedHeapUsedBytesMax: benchmarkTelemetry2.requestRetainedHeapUsedBytesMax,
-        requestRetainedRssBytesMax: benchmarkTelemetry2.requestRetainedRssBytesMax,
-        requestRetainedExternalBytesMax: benchmarkTelemetry2.requestRetainedExternalBytesMax,
-        requestPeakHeapUsedBytesMax: benchmarkTelemetry2.requestPeakHeapUsedBytesMax,
-        requestPeakRssBytesMax: benchmarkTelemetry2.requestPeakRssBytesMax,
-        requestPeakExternalBytesMax: benchmarkTelemetry2.requestPeakExternalBytesMax,
         appendServerSamples,
         appendServerTotals
       };
@@ -28364,8 +28367,7 @@ async function applyJsonlCommit(ctx, args) {
       message: args.message,
       operationCount: operations.length,
       operations,
-      submittedOperations,
-      submittedOperationOffset: operationOffset
+      submittedOperations
     });
   } catch (error) {
     progress.onError();
@@ -28376,7 +28378,7 @@ async function applyJsonlFileCommit(ctx, args) {
   try {
     const countedOps = await countNonEmptyJsonlLines(args.opsFile);
     assertWithinStreamOpLimit(countedOps);
-    const totalOps = args.progressRequested && ctx.stderrIsTTY === true ? countedOps : undefined;
+    const totalOps = args.progressRequested ? countedOps : undefined;
     return await applyJsonlCommit(ctx, {
       ...args,
       input: createReadStream2(args.opsFile, { encoding: "utf-8" }),
@@ -28395,14 +28397,14 @@ async function applyJsonlFileCommit(ctx, args) {
 async function applyJsonlStdinCommit(ctx, args) {
   const input = ctx.stdin ?? process.stdin;
   if (isTTY(input)) {
-    throw new CliError(2 /* UserInput */, "USER_INPUT", "No JSONL operations provided on stdin.", undefined, 'Pipe JSONL operations via stdin: producer | wh commit submit --stream -m "message"');
+    throw new CliError(2 /* UserInput */, "USER_INPUT", "No JSONL operations provided on stdin.", undefined, 'Pipe JSONL operations via stdin: producer | wh commit submit --stream --stream-id bulk-2026-06-04 --skip-existing -m "message"');
   }
   return applyJsonlCommit(ctx, {
     ...args,
     input,
     lineLabel: "--stream",
     emptyInputMessage: "No JSONL operations provided on stdin.",
-    emptyInputHint: 'Pipe JSONL operations via stdin: producer | wh commit submit --stream -m "message"',
+    emptyInputHint: 'Pipe JSONL operations via stdin: producer | wh commit submit --stream --stream-id bulk-2026-06-04 --skip-existing -m "message"',
     progressSourceKind: "stream"
   });
 }
@@ -28531,7 +28533,7 @@ var createFlags3 = {
     description: "Read newline-delimited operations from stdin"
   }),
   progress: flag.boolean({
-    description: "Show interactive stream-append progress on TTY stderr"
+    description: "Show stream-append progress on stderr (TTY status or JSONL events)."
   }),
   "skip-existing": flag.boolean({
     description: "Skip add operations when the target shape, thing, assertion, or collection already exists."
@@ -28548,12 +28550,6 @@ var createFlags3 = {
   "stream-id": flag.string({
     description: "Use a caller-managed stream id for JSONL token continuity."
   }),
-  "allocated-tokens": flag.string({
-    description: `Continue JSONL $N/#N token state as JSON, e.g. '[{"tokenNumber":1}]'.`
-  }),
-  "operation-offset": flag.number({
-    description: "Zero-based original operation index for the first JSONL operation in this input."
-  }),
   message: flag.string({ short: "m", description: "Commit message" }),
   committer: flag.string({
     description: "Committer thing wref (e.g. Agent/bot-1)"
@@ -28612,9 +28608,7 @@ var handleSubmit = async (ctx, { flags, args }) => {
   const chunkSize = flags["chunk-size"];
   const allowNulBytes = flags["allow-nul-bytes"] === true;
   const timingOut = flags["timing-out"];
-  const resumeStreamId = flags["stream-id"];
-  const resumeAllocatedTokens = parseAllocatedTokensFlag(flags["allocated-tokens"]);
-  const resumeOperationOffset = flags["operation-offset"] === undefined ? undefined : Math.max(0, Math.trunc(flags["operation-offset"]));
+  const streamId = flags["stream-id"];
   const c = ctx.colors;
   const addNames = flags.add ?? [];
   const reviseName = flags.revise;
@@ -28658,11 +28652,14 @@ var handleSubmit = async (ctx, { flags, args }) => {
   if (progressRequested && !streamInput && !jsonlFile) {
     throw new CliError(2 /* UserInput */, "USER_INPUT", "--progress requires --stream or a .jsonl --file.");
   }
-  if ((resumeStreamId !== undefined || resumeAllocatedTokens !== undefined || resumeOperationOffset !== undefined) && !streamInput && !jsonlFile) {
-    throw new CliError(2 /* UserInput */, "USER_INPUT", "--stream-id, --allocated-tokens, and --operation-offset require --stream or a .jsonl --file.");
+  if (streamId !== undefined && !streamInput && !jsonlFile) {
+    throw new CliError(2 /* UserInput */, "USER_INPUT", "--stream-id requires --stream or a .jsonl --file.");
+  }
+  if ((streamInput || jsonlFile) && streamId === undefined) {
+    throw new CliError(2 /* UserInput */, "USER_INPUT", "JSONL streaming requires --stream-id.", undefined, "Choose a stable id up front so add streams can rebuild token state on full rerun: --stream-id bulk-2026-06-04.");
   }
-  if (resumeAllocatedTokens !== undefined && resumeAllocatedTokens.length > 0 && resumeStreamId === undefined) {
-    throw new CliError(2 /* UserInput */, "USER_INPUT", "--allocated-tokens requires the original --stream-id when resuming a stream.");
+  if ((streamInput || jsonlFile) && !skipExisting) {
+    throw new CliError(2 /* UserInput */, "USER_INPUT", "JSONL streaming requires --skip-existing.", undefined, "Full-input rerun recovery depends on idempotent add operations; pass --skip-existing with --stream-id.");
   }
   const shorthandModeCount = (addNames.length > 0 ? 1 : 0) + (reviseName !== undefined ? 1 : 0) + (retractNames.length > 0 ? 1 : 0) + (collectionType !== undefined ? 1 : 0);
   if (!streamInput && !opsJson && !opsFile && shorthandModeCount > 1) {
@@ -28773,9 +28770,7 @@ var handleSubmit = async (ctx, { flags, args }) => {
       chunkSize,
       progressRequested,
       skipExisting,
-      streamId: resumeStreamId,
-      allocatedTokens: resumeAllocatedTokens,
-      operationOffset: resumeOperationOffset,
+      streamId,
       allowNulBytes
     }) : jsonlFile ? await applyJsonlFileCommit(ctx, {
       org,
@@ -28787,9 +28782,7 @@ var handleSubmit = async (ctx, { flags, args }) => {
       progressRequested,
       timingOut,
       skipExisting,
-      streamId: resumeStreamId,
-      allocatedTokens: resumeAllocatedTokens,
-      operationOffset: resumeOperationOffset,
+      streamId,
       allowNulBytes
     }) : await ctx.client.commit.apply(org, repo, message, operations, {
       committer,
@@ -28981,8 +28974,8 @@ var COMMIT_DOMAIN = defineDomain({
         `wh commit submit --add alice --data '{"score":1}' --add bob --data '{"score":2}' --shape Player -m "seed players"`,
         'wh commit submit -f operations.json -m "Batch update"',
         `wh commit submit --ops '[{"operation":"add","kind":"thing","name":"Session/run-001","data":{}},{"operation":"add","kind":"assertion","name":"HypothesisCandidate/run-001-claim","about":"Session/run-001","data":{}}]' -m "Create session + assertion"`,
-        `printf '%s\\n' '{"operation":"add","kind":"thing","name":"Player/alice","data":{"score":1}}' | wh commit submit --stream --repo acme/world -m "stdin stream"`,
-        'wh commit submit --file dataset.jsonl --progress -m "bulk stream"',
+        `printf '%s\\n' '{"operation":"add","kind":"thing","name":"Player/alice","data":{"score":1}}' | wh commit submit --stream --stream-id bulk-2026-06-04 --skip-existing --repo acme/world -m "stdin stream"`,
+        'wh commit submit --file dataset.jsonl --stream-id bulk-2026-06-04 --skip-existing --progress -m "bulk stream"',
         "wh shape template Session HypothesisCandidate -o ops.json",
         "wh commit submit --type pair --members Location/a,Location/b",
         'wh commit submit --type set --members Location/a,Location/b,Location/c -m "Create location set"'
@@ -30364,7 +30357,7 @@ function crossValidate(pkg) {
     findings.push({
       level: "warning",
       code: "MISSING_SCHEMA",
-      message: 'manifest.json is missing "$schema". Add "$schema": "https://warmhub.dev/schema/component-manifest.v1.json" for IDE autocomplete and validation.'
+      message: 'manifest.json is missing "$schema". Add "$schema": "https://docs.warmhub.ai/schema/component-manifest.v1.json" for IDE autocomplete and validation.'
     });
   }
   const hasErrors = findings.some((f) => f.level === "error");
@@ -30582,18 +30575,36 @@ async function reconcileComponent(client, org, repo, pkg, source, existingInstal
       continue;
     }
     try {
-      await client.subscription.create({
-        orgName: org,
-        repoName: repo,
-        name: compiled.name,
-        kind: compiled.kind,
-        shapeName: compiled.shapeName,
-        filterJson: compiled.filterJson,
-        cronConfig: compiled.cronConfig,
-        webhookUrl: compiled.webhookUrl,
-        fallbackWebhookUrl: compiled.fallbackWebhookUrl,
-        componentId
-      });
+      if (compiled.kind === "cron") {
+        const cronConfig = compiled.cronConfig;
+        if (!cronConfig) {
+          throw new Error(`Compiled cron subscription "${compiled.name}" is missing cronConfig`);
+        }
+        await client.subscription.create({
+          orgName: org,
+          repoName: repo,
+          name: compiled.name,
+          kind: compiled.kind,
+          shapeName: compiled.shapeName,
+          filterJson: compiled.filterJson,
+          cronConfig,
+          webhookUrl: compiled.webhookUrl,
+          fallbackWebhookUrl: compiled.fallbackWebhookUrl,
+          componentId
+        });
+      } else {
+        await client.subscription.create({
+          orgName: org,
+          repoName: repo,
+          name: compiled.name,
+          kind: compiled.kind,
+          shapeName: compiled.shapeName,
+          filterJson: compiled.filterJson,
+          webhookUrl: compiled.webhookUrl,
+          fallbackWebhookUrl: compiled.fallbackWebhookUrl,
+          componentId
+        });
+      }
       steps.push({ step: `add-sub-${sub.name}`, status: "ok" });
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
@@ -30949,18 +30960,36 @@ async function installComponent(client, org, repo, pkg, source) {
       continue;
     }
     try {
-      await client.subscription.create({
-        orgName: org,
-        repoName: repo,
-        name: compiled.name,
-        kind: compiled.kind,
-        shapeName: compiled.shapeName,
-        filterJson: compiled.filterJson,
-        cronConfig: compiled.cronConfig,
-        webhookUrl: compiled.webhookUrl,
-        fallbackWebhookUrl: compiled.fallbackWebhookUrl,
-        componentId
-      });
+      if (compiled.kind === "cron") {
+        const cronConfig = compiled.cronConfig;
+        if (!cronConfig) {
+          throw new Error(`Compiled cron subscription "${compiled.name}" is missing cronConfig`);
+        }
+        await client.subscription.create({
+          orgName: org,
+          repoName: repo,
+          name: compiled.name,
+          kind: compiled.kind,
+          shapeName: compiled.shapeName,
+          filterJson: compiled.filterJson,
+          cronConfig,
+          webhookUrl: compiled.webhookUrl,
+          fallbackWebhookUrl: compiled.fallbackWebhookUrl,
+          componentId
+        });
+      } else {
+        await client.subscription.create({
+          orgName: org,
+          repoName: repo,
+          name: compiled.name,
+          kind: compiled.kind,
+          shapeName: compiled.shapeName,
+          filterJson: compiled.filterJson,
+          webhookUrl: compiled.webhookUrl,
+          fallbackWebhookUrl: compiled.fallbackWebhookUrl,
+          componentId
+        });
+      }
       steps.push({ step: `create-sub-${sub.name}`, status: "ok" });
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
@@ -31923,7 +31952,7 @@ function renderValidationResult(ctx, result) {
   }
   if (result.valid && result.errors.length === 0) {
     ctx.out(`${c.green}Valid component package${c.reset}`);
-    ctx.out(`${c.dim}Schema: https://warmhub.dev/schema/component-manifest.v1.json${c.reset}`);
+    ctx.out(`${c.dim}Schema: https://docs.warmhub.ai/schema/component-manifest.v1.json${c.reset}`);
   }
 }
 var handleDoctor = async (ctx, { args }) => {
@@ -33965,7 +33994,7 @@ cat wrefs.txt | wh thing view --format jsonl        # one JSON line per *deduped
 - \`wh thing about <wref> [--shape] [--match] [--depth] [--resolve-collections] [--limit] [--include-retracted]\` — Show assertions about the target identity; \`--resolve-collections\` expands collection members for bare/@HEAD/@ALL inputs, not pinned @vN
 
 ### commit — Write operations
-- \`wh commit submit [--ops|--file|--add|--revise|--retract] [--kind] [--data] [--reason] [--expected-version] [--chunk-size] [--skip-existing] [--progress] [--stream-id] [--allocated-tokens] [--operation-offset]\` — Submit operations (bare \`wh commit\` is equivalent). Use \`--file ops.jsonl --chunk-size 5000 --skip-existing\` for bulk ingest.
+- \`wh commit submit [--ops|--file|--add|--revise|--retract] [--kind] [--data] [--reason] [--expected-version] [--chunk-size] [--skip-existing] [--progress] [--stream-id]\` — Submit operations (bare \`wh commit\` is equivalent). Use \`--file ops.jsonl --stream-id <id> --chunk-size 5000 --skip-existing\` for bulk ingest.
 - \`wh shape template <shape> [shape2 ...] [--kind] [--operation add|revise|retract] [-o file]\` — Generate sample ops
 
 ### assertion — Assertion operations
@@ -34079,11 +34108,12 @@ wh commit submit --file ops.jsonl --stream-id "$ID" --chunk-size 5000 \\
   --skip-existing --progress -m "bulk ingest" --repo org/repo
 # --chunk-size: ops per append chunk (default 1000, max 10000); chunk≈1 is ~60× slower
 # --skip-existing: skips already-written add ops (drops per-row read-before-write)
-# Restart safety: re-run the WHOLE file from the start with the SAME --stream-id.
-# Fixed-name ops are idempotent via --skip-existing; tokenized ($N/#N) names derive
-# deterministically from streamId, so a full rerun rebuilds token state (no allocatedTokens
-# carry-over). Omitting --stream-id mints a random one that is never emitted, so a rerun
-# DUPLICATES tokenized identities. Mid-stream --operation-offset resume is NOT CLI-recoverable.
+# Add-stream restart: rerun the WHOLE file with the SAME --stream-id.
+# Fixed-name adds are idempotent via --skip-existing; tokenized ($N/#N) names
+# derive from streamId, so rerun rebuilds token state. Omitting --stream-id is
+# rejected because reruns must reuse the same token namespace. Mid-stream resume
+# is not a CLI mode. Mixed revise/retract JSONL streams are not full-rerun safe
+# after an ambiguous append; inspect repo state and reconcile explicitly.
 \`\`\`
 
 **Create collections:**
@@ -34205,6 +34235,73 @@ var PRIME_DOMAIN = defineDomain({
   handler: handlePrime
 });
 
+// ../../packages/warmhub-cli/src/domains/content-prompt.ts
+var PROMPT_BUDGET = {
+  maxChars: 14000,
+  maxLines: 260
+};
+var TARGET_FILE = {
+  readme: "README.md",
+  agents: "AGENTS.md"
+};
+var GUIDANCE = {
+  readme: "Write a 100–200 word Markdown README. Start with a `#` heading using the " + "repo name. Cover the purpose, the key shapes, and how to get started.",
+  agents: "Write 100–250 words of Markdown AGENTS.md guidance for an AI agent working " + "with this WarmHub repo. Cover how to navigate the repo, the most important " + "shapes, common workflows, and any gotchas."
+};
+function buildContextLines(ctx) {
+  const sampled = ctx.sampleThingNames.slice(0, 20);
+  const moreThings = ctx.sampleThingNames.length - sampled.length;
+  const byShapeEntries = Object.entries(ctx.byShape).filter(([, count]) => count > 0);
+  return [
+    `Repository: ${ctx.org}/${ctx.repo}`,
+    ctx.description ? `Description: ${ctx.description}` : null,
+    `Total items: ${ctx.byKind.thing} things, ${ctx.byKind.assertion} assertions, ${ctx.byKind.shape} shapes`,
+    ctx.shapeNames.length > 0 ? `Shapes (data schemas): ${ctx.shapeNames.join(", ")}` : null,
+    sampled.length > 0 ? `Sample things: ${sampled.join(", ")}${moreThings > 0 ? ` ... and ${moreThings} more` : ""}` : null,
+    byShapeEntries.length > 0 ? `Things by shape: ${byShapeEntries.map(([name, count]) => `${name} (${count})`).join(", ")}` : null
+  ].filter((line) => line !== null);
+}
+function applyBudget(text, reservedChars, reservedLines) {
+  const maxChars = Math.max(0, PROMPT_BUDGET.maxChars - reservedChars);
+  const maxLines = Math.max(0, PROMPT_BUDGET.maxLines - reservedLines);
+  let lines = text.split(`
+`);
+  let truncated = false;
+  if (lines.length > maxLines) {
+    lines = lines.slice(0, maxLines);
+    truncated = true;
+  }
+  let out = lines.join(`
+`);
+  if (out.length > maxChars) {
+    out = out.slice(0, maxChars);
+    truncated = true;
+  }
+  return truncated ? `${out}
+[context truncated to fit the prompt budget]` : out;
+}
+function buildContentPrompt(ctx) {
+  const file = TARGET_FILE[ctx.kind];
+  const saveCommand = `wh repo content set ${ctx.org}/${ctx.repo} --kind ${ctx.kind} --file ${file}`;
+  const head = [GUIDANCE[ctx.kind], "", "Repository context:"].join(`
+`);
+  const tail = [
+    "",
+    "Write only the content markdown, nothing else. Then save it with:",
+    `  ${saveCommand}`,
+    `(or pipe it: cat ${file} | wh repo content set ${ctx.org}/${ctx.repo} --kind ${ctx.kind})`
+  ].join(`
+`);
+  const reservedChars = head.length + tail.length + 2;
+  const reservedLines = head.split(`
+`).length + tail.split(`
+`).length;
+  const context = applyBudget(buildContextLines(ctx).join(`
+`), reservedChars, reservedLines);
+  return { prompt: [head, context, tail].join(`
+`), saveCommand };
+}
+
 // ../../packages/warmhub-cli/src/domains/repo.ts
 function usageError8(usage, example) {
   throw new CliError(2 /* UserInput */, "USER_INPUT", usage, undefined, `Example: ${example}`);
@@ -34454,6 +34551,9 @@ var handleUpdate3 = async (ctx, { args, flags }) => {
     ctx.out(`${c.green}Updated${c.reset} ${c.cyan}${orgName}/${repoName}${c.reset} description`);
   });
 };
+function nameStrings(items) {
+  return items.map((item) => item.name).filter((name) => typeof name === "string");
+}
 var describeFlags = {
   "indexed-fields": flag.boolean({
     description: "Show typed field index state (building, ready, failed) for each shape"
@@ -34472,7 +34572,7 @@ var handleDescribe = async (ctx, { args, flags }) => {
   ]);
   const shapes = shapesPage.items;
   const byShape = Object.fromEntries([
-    ...shapes.map((shape) => shape.name).filter((name) => typeof name === "string").map((name) => [name, 0]),
+    ...nameStrings(shapes).map((name) => [name, 0]),
     ...Object.entries(stats.byShape)
   ]);
   function stripShapeThingId(bucket) {
@@ -34693,11 +34793,8 @@ var contentSetFlags = {
     description: "Inline markdown content"
   })
 };
-var generateSaveFlags = {
-  kind: kindFlagDef,
-  save: flag.boolean({
-    description: "Commit the generated content after generation"
-  })
+var promptFlags = {
+  kind: kindFlagDef
 };
 function requireKind(kind) {
   if (!kind) {
@@ -34710,7 +34807,7 @@ function requireKind(kind) {
 }
 var handleContentGet = async (ctx, { args, flags }) => {
   const kind = requireKind(flags.kind);
-  const { org, repo } = parseOrgRepo(args[0], ctx.config);
+  const { org, repo } = parseOrgRepo(getRepoRef(ctx) ?? args[0], ctx.config);
   switch (kind) {
     case "readme": {
       const result = await ctx.client.repo.getReadme(org, repo);
@@ -34742,9 +34839,9 @@ var handleContentGet = async (ctx, { args, flags }) => {
 var handleContentSet = async (ctx, { args, flags }) => {
   const kind = requireKind(flags.kind);
   if (READ_ONLY_KINDS.has(kind)) {
-    throw new CliError(2 /* UserInput */, "USER_INPUT", `--kind ${kind} is read-only; \`set\` is rejected.`, undefined, `Use \`wh repo content get <org/repo> --kind ${kind}\``);
+    throw new CliError(2 /* UserInput */, "USER_INPUT", `--kind ${kind} is read-only; \`set\` is rejected.`, undefined, `Use \`wh repo content get [org/repo] --kind ${kind}\` (or set --repo)`);
   }
-  const { org, repo } = parseOrgRepo(args[0], ctx.config);
+  const { org, repo } = parseOrgRepo(getRepoRef(ctx) ?? args[0], ctx.config);
   const inputContent = await readContentInput(flags.file, flags.content, ctx.stdin);
   switch (kind) {
     case "readme": {
@@ -34765,36 +34862,37 @@ var handleContentSet = async (ctx, { args, flags }) => {
       throw new CliError(2 /* UserInput */, "USER_INPUT", `--kind ${kind} does not support \`set\`.`);
   }
 };
-var handleContentGenerate = async (ctx, { args, flags }) => {
+var handleContentPrompt = async (ctx, { args, flags }) => {
   const kind = requireKind(flags.kind);
   if (READ_ONLY_KINDS.has(kind)) {
-    throw new CliError(2 /* UserInput */, "USER_INPUT", `--kind ${kind} is read-only; \`generate\` is rejected.`, undefined, `Use \`wh repo content get <org/repo> --kind ${kind}\``);
-  }
-  const { org, repo } = parseOrgRepo(args[0], ctx.config);
-  switch (kind) {
-    case "readme": {
-      const generated = await ctx.client.repo.generateReadme(org, repo);
-      if (flags.save) {
-        await ctx.client.repo.setReadme(org, repo, generated.content);
-      }
-      writeOutput(ctx, generated, () => {
-        ctx.out(generated.content);
-      });
-      break;
-    }
-    case "agents": {
-      const generated = await ctx.client.repo.generateAgents(org, repo);
-      if (flags.save) {
-        await ctx.client.repo.setAgents(org, repo, generated.content);
-      }
-      writeOutput(ctx, generated, () => {
-        ctx.out(generated.content);
-      });
-      break;
-    }
-    default:
-      throw new CliError(2 /* UserInput */, "USER_INPUT", `--kind ${kind} does not support \`generate\`.`);
+    throw new CliError(2 /* UserInput */, "USER_INPUT", `--kind ${kind} is read-only; \`prompt\` is rejected.`, undefined, `Use \`wh repo content get [org/repo] --kind ${kind}\` (or set --repo)`);
   }
+  const promptKind = kind;
+  const { org, repo } = parseOrgRepo(getRepoRef(ctx) ?? args[0], ctx.config);
+  const [repoInfo, shapesPage, stats, thingsPage] = await Promise.all([
+    ctx.client.repo.get(org, repo),
+    ctx.client.shape.list(org, repo),
+    ctx.client.repo.getStats(org, repo),
+    ctx.client.thing.query(org, repo, { limit: 30 })
+  ]);
+  const { prompt, saveCommand } = buildContentPrompt({
+    kind: promptKind,
+    org,
+    repo,
+    description: repoInfo.description ?? null,
+    byKind: stats.byKind,
+    byShape: stats.byShape,
+    shapeNames: nameStrings(shapesPage.items),
+    sampleThingNames: nameStrings(thingsPage.items)
+  });
+  writeOutput(ctx, { kind: promptKind, org, repo, prompt, saveCommand }, () => {
+    ctx.out(prompt);
+  });
+  ctx.status(`Next: draft the content, then run:
+  ${saveCommand}`);
+};
+var handleContentGenerate = async () => {
+  throw new CliError(2 /* UserInput */, "USER_INPUT", "wh repo content generate is no longer supported — WarmHub no longer hosts README/AGENTS generation.", undefined, "Draft locally with your own agent: wh repo content prompt [org/repo] --kind readme");
 };
 var CONTENT_SUBDOMAIN = defineDomain({
   name: "content",
@@ -34802,7 +34900,7 @@ var CONTENT_SUBDOMAIN = defineDomain({
   verbs: {
     get: {
       summary: "Fetch repo content by kind",
-      args: "<org/repo>",
+      args: "[org/repo]",
       flags: contentGetFlags,
       examples: [
         "wh repo content get myorg/myrepo --kind readme",
@@ -34813,7 +34911,7 @@ var CONTENT_SUBDOMAIN = defineDomain({
     },
     set: {
       summary: "Set repo content by kind",
-      args: "<org/repo>",
+      args: "[org/repo]",
       flags: contentSetFlags,
       examples: [
         'wh repo content set myorg/myrepo --kind readme --content "# Hello"',
@@ -34822,14 +34920,21 @@ var CONTENT_SUBDOMAIN = defineDomain({
       ],
       handler: handleContentSet
     },
-    generate: {
-      summary: "AI-generate repo content by kind",
-      args: "<org/repo>",
-      flags: generateSaveFlags,
+    prompt: {
+      summary: "Print an agent-ready prompt to draft repo content locally (no hosted LLM)",
+      args: "[org/repo]",
+      flags: promptFlags,
       examples: [
-        "wh repo content generate myorg/myrepo --kind readme",
-        "wh repo content generate myorg/myrepo --kind agents --save"
+        "wh repo content prompt myorg/myrepo --kind readme",
+        "wh repo content prompt myorg/myrepo --kind agents"
       ],
+      handler: handleContentPrompt
+    },
+    generate: {
+      summary: "Deprecated — use `wh repo content prompt` (no hosted LLM)",
+      args: "<org/repo>",
+      flags: promptFlags,
+      examples: ["wh repo content prompt myorg/myrepo --kind readme"],
       handler: handleContentGenerate
     }
   }
@@ -35466,7 +35571,9 @@ var createFlags8 = {
   timezone: flag.string({
     description: "IANA timezone (e.g., America/New_York). Default: UTC"
   }),
-  "webhook-url": flag.string({ description: "Webhook URL for webhook kind" }),
+  "webhook-url": flag.string({
+    description: "Webhook destination URL (required for webhook and cron)"
+  }),
   url: flag.string({ description: "Alias for --webhook-url" }),
   "fallback-webhook-url": flag.string({
     description: "Optional fallback webhook URL for terminal action failures"
@@ -35478,7 +35585,7 @@ var createFlags8 = {
     description: "Subscription name (deprecated; use positional <name>)"
   }),
   source: flag.string({
-    description: 'Source repo to watch (same-org shorthand "repoName" or "orgName/repoName")'
+    description: 'Source repo to watch for webhook subscriptions (same-org shorthand "repoName" or "orgName/repoName")'
   })
 };
 var updateFlags4 = {
@@ -35487,7 +35594,9 @@ var updateFlags4 = {
   filter: createFlags8.filter,
   cronspec: createFlags8.cronspec,
   timezone: createFlags8.timezone,
-  "webhook-url": createFlags8["webhook-url"],
+  "webhook-url": flag.string({
+    description: "Webhook destination URL"
+  }),
   url: createFlags8.url,
   "fallback-webhook-url": createFlags8["fallback-webhook-url"],
   "clear-fallback-webhook-url": flag.boolean({
@@ -35584,19 +35693,42 @@ var handleCreate7 = async (ctx, { flags, args }) => {
   const kind = parseKind(flags.kind, usage, example);
   const { org, repo } = resolveRepoContext2(ctx);
   const createArgs = buildSubscriptionMutationArgs(kind, flags, usage, example);
-  const result = await ctx.client.subscription.create({
+  const sourceRepoRef = typeof flags.source === "string" ? flags.source : undefined;
+  if (kind === "cron" && sourceRepoRef) {
+    throw new CliError(2 /* UserInput */, "USER_INPUT", "--source is only supported for webhook subscriptions", undefined, `Example: wh sub create signal-hook --repo myorg/myrepo --on Signal --kind webhook --filter '{"shape":"Signal"}' --webhook-url https://example.com/hook --source myorg/source-repo`);
+  }
+  const webhookUrl = createArgs.webhookUrl;
+  if (!webhookUrl) {
+    usageError10(usage, example);
+  }
+  const commonArgs = {
     orgName: org,
     repoName: repo,
-    shapeName: createArgs.shapeName,
     name,
-    filterJson: createArgs.filterJson,
-    kind,
-    webhookUrl: createArgs.webhookUrl,
+    webhookUrl,
     fallbackWebhookUrl: createArgs.fallbackWebhookUrl,
-    cronConfig: createArgs.cronConfig,
-    ...createArgs.allowTraceReentry === true ? { allowTraceReentry: true } : {},
-    sourceRepoRef: typeof flags.source === "string" ? flags.source : undefined
-  });
+    ...createArgs.allowTraceReentry === true ? { allowTraceReentry: true } : {}
+  };
+  let result;
+  if (kind === "cron") {
+    const cronConfig = createArgs.cronConfig;
+    if (!cronConfig) {
+      usageError10("Usage: wh sub create <name> --repo org/repo --kind cron --cronspec <expr> --webhook-url <url>", 'wh sub create health-check --repo org/repo --kind cron --cronspec "*/15 * * * *" --webhook-url https://example.com/health');
+    }
+    result = await ctx.client.subscription.create({
+      ...commonArgs,
+      kind,
+      cronConfig
+    });
+  } else {
+    result = await ctx.client.subscription.create({
+      ...commonArgs,
+      kind,
+      shapeName: createArgs.shapeName,
+      filterJson: createArgs.filterJson,
+      sourceRepoRef
+    });
+  }
   writeOutput(ctx, result, () => {
     const c = ctx.colors;
     ctx.status(`${c.green}Created subscription${c.reset} ${c.cyan}${name}${c.reset} on ${c.cyan}${org}/${repo}${c.reset}`);
@@ -36044,7 +36176,7 @@ var createFlags9 = {
   name: flag.string({ short: "n", description: "Token name" }),
   scope: flag.string({
     short: "s",
-    description: "Scope entry: org/repo=perms, org=perms, or perms for global scope. Repeatable.",
+    description: "Scope entry: org/repo=perms, org=perms, or perms for global scope. " + "A role: shorthand (role:owner|admin|editor|viewer, e.g. org/repo=role:editor) " + "expands to that role's scopes. Repeatable.",
     multiple: true
   }),
   "scopes-json": flag.string({
@@ -36095,7 +36227,7 @@ function formatScopes(scopes) {
 }
 var handleCreate8 = async (ctx, { flags }) => {
   if (!flags.name) {
-    usageError11("Usage: wh token create --name <name> [flags]", "wh token create --name ci-bot --scope myorg/myrepo=repo:read,repo:write --expires 90d");
+    usageError11("Usage: wh token create --name <name> [flags]", "wh token create --name ci-bot --scope myorg/myrepo=role:editor --expires 90d");
   }
   const hasScopesJson = flags["scopes-json"] !== undefined;
   if (flags.scope && hasScopesJson) {
@@ -36207,6 +36339,7 @@ var TOKEN_DOMAIN = defineDomain({
       flags: createFlags9,
       examples: [
         "wh token create --name ci-bot --scope myorg/myrepo=repo:read,repo:write",
+        "wh token create --name ci-bot --scope myorg/myrepo=role:editor",
         'wh token create -n deploy -s myorg=repo:write -d "Deploy pipeline" --expires 90d',
         "wh token create --name reader --scope repo:read",
         `wh token create --name scoped --scopes-json '[{"resource":"myorg/myrepo","permissions":["repo:read"],"allowedMatches":["Signal/*"]}]'`,
@@ -37419,8 +37552,8 @@ var package_default2 = {
   scripts: {
     "check:contract": "node ../../scripts/lint/external-identity-contracts.mjs cli",
     "check:boundary": "node ../../scripts/lint/boundary-imports.mjs src tests",
-    test: "vitest run",
-    "test:watch": "vitest",
+    test: "bun run --filter @warmhub/sdk-ts build && vitest run",
+    "test:watch": "bun run --filter @warmhub/sdk-ts build && vitest",
     typecheck: "bun run check:boundary && bun run check:contract && tsc --noEmit"
   },
   dependencies: {
@@ -37733,7 +37866,7 @@ function resolveLogLevel(flags, env) {
 // package.json
 var package_default3 = {
   name: "@warmhub/cli",
-  version: "0.49.0",
+  version: "0.50.0",
   private: false,
   type: "module",
   description: "The wh CLI for WarmHub — create repos, commit and query data, and compound knowledge with your AI agents.",
@@ -38760,4 +38893,4 @@ if (!updateCheckSuppressedByArgv && shouldRunUpdateCheck(updateEligibility)) {
 var interceptedExitCode = await maybeHandleComponentShellBoundary(dispatchArgv);
 process.exitCode = interceptedExitCode === undefined ? await runCli(dispatchArgv, { version: package_default3.version }) : interceptedExitCode;
 
-//# debugId=7BEE2CF049FB035564756E2164756E21
+//# debugId=C77C7A7F52472BC464756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warmhub/cli",
-  "version": "0.49.0",
+  "version": "0.50.0",
   "private": false,
   "type": "module",
   "description": "The wh CLI for WarmHub — create repos, commit and query data, and compound knowledge with your AI agents.",