@xano/sdk 1.0.5 → 1.0.6

package/dist/{chunk-SQPIECXD.js → chunk-CJDPSCMX.js}

@@ -1,14 +1,15 @@
 import {
   applyLanding,
   withoutPrunedObjects
-} from "./chunk-5YBNXNKU.js";
+} from "./chunk-MFWF2NZJ.js";
 import {
   atomicWrite
 } from "./chunk-LLNZGEFK.js";
 import {
   parseLockReport,
-  serializeLock
-} from "./chunk-OKNE3TWU.js";
+  serializeLock,
+  withSyncedOf
+} from "./chunk-5KJBWIDZ.js";
 import {
   tagLockSource
 } from "./chunk-4BW2SG2N.js";
@@ -16,6 +17,37 @@ import {
 // src/lock/io.ts
 import { readFileSync, existsSync } from "fs";
 import { resolve } from "path";
+
+// src/lock/synced.ts
+function syncedOn(lock, destKey, branch) {
+  const record = lock?.synced?.[destKey];
+  return record !== void 0 && Object.hasOwn(record, branch) ? record[branch] : void 0;
+}
+function withSyncBaseline(lock, destKey, branch, baseline) {
+  const synced = { ...lock.synced ?? {} };
+  synced[destKey] = { ...synced[destKey] ?? {}, [branch]: baseline };
+  const { synced: _old, ...rest } = lock;
+  return withSyncedOf(rest, { synced });
+}
+function nextBaseline(previous, digests, by, complete, now = () => /* @__PURE__ */ new Date()) {
+  if (previous !== void 0 && previous.complete === complete && previous.scheme === digests.scheme && sameDigests(previous.objects, digests.objects) && sameDigests(previous.others ?? {}, digests.others)) {
+    return previous;
+  }
+  return {
+    at: now().toISOString(),
+    by,
+    scheme: digests.scheme,
+    complete,
+    objects: { ...digests.objects },
+    ...Object.keys(digests.others).length > 0 ? { others: { ...digests.others } } : {}
+  };
+}
+function sameDigests(a, b) {
+  const keys = Object.keys(a);
+  return keys.length === Object.keys(b).length && keys.every((k) => Object.hasOwn(b, k) && a[k] === b[k]);
+}
+
+// src/lock/io.ts
 function readLockFile(path, opts = {}) {
   return readLockFileReport(path, opts).lock;
 }
@@ -62,12 +94,20 @@ function forgetPrunedInLockFile(path, update) {
   writeLockFile(path, { ...lock, objects });
   return Object.keys(lock.objects).filter((key) => !(key in objects));
 }
+function recordSyncInLockFile(path, destKey, branch, sync) {
+  if (!existsSync(path)) return void 0;
+  const lock = readLockFile(path);
+  const baseline = nextBaseline(syncedOn(lock, destKey, branch), sync.digests, sync.by, sync.complete);
+  return { changed: writeLockFile(path, withSyncBaseline(lock, destKey, branch, baseline)) };
+}
 
 export {
+  syncedOn,
   readLockFile,
   readLockFileReport,
   writeLockFile,
   recordLandingInLockFile,
-  forgetPrunedInLockFile
+  forgetPrunedInLockFile,
+  recordSyncInLockFile
 };
-//# sourceMappingURL=chunk-SQPIECXD.js.map
+//# sourceMappingURL=chunk-CJDPSCMX.js.map

package/dist/{chunk-3HOGFGKG.js → chunk-D3KEPRRN.js}

@@ -1,6 +1,6 @@
 import {
   impliedInputs
-} from "./chunk-7GX445AE.js";
+} from "./chunk-4XHAT7C5.js";
 
 // src/validate/normalize.ts
 var STRIP_KEYS = /* @__PURE__ */ new Set([
@@ -1062,4 +1062,4 @@ export {
   filledContext,
   normalize
 };
-//# sourceMappingURL=chunk-3HOGFGKG.js.map
+//# sourceMappingURL=chunk-D3KEPRRN.js.map

package/dist/{chunk-XNZURZ7T.js → chunk-D7BUMOKU.js}

@@ -1,6 +1,6 @@
 import {
   setDiagnosticSink
-} from "./chunk-GPI3OWRE.js";
+} from "./chunk-YHB34BN6.js";
 import {
   suggest
 } from "./chunk-UTI5G6OJ.js";
@@ -3040,4 +3040,4 @@ export {
   movedVerb,
   installCliDiagnosticSink
 };
-//# sourceMappingURL=chunk-XNZURZ7T.js.map
+//# sourceMappingURL=chunk-D7BUMOKU.js.map

package/dist/{chunk-WRBKLYSJ.js → chunk-DNBP4GJN.js}

@@ -201,8 +201,9 @@ function removeArgs(manager, pkg) {
   return [manager === "npm" ? "uninstall" : "remove", pkg];
 }
 function addArgs(manager, spec, dev = false) {
-  if (manager === "npm") return ["install", spec, ...dev ? ["--save-dev"] : []];
-  return ["add", spec, ...dev ? [manager === "pnpm" ? "--save-dev" : "--dev"] : []];
+  const specs = typeof spec === "string" ? [spec] : [...spec];
+  if (manager === "npm") return ["install", ...specs, ...dev ? ["--save-dev"] : []];
+  return ["add", ...specs, ...dev ? [manager === "pnpm" ? "--save-dev" : "--dev"] : []];
 }
 
 export {
@@ -221,4 +222,4 @@ export {
   removeArgs,
   addArgs
 };
-//# sourceMappingURL=chunk-WRBKLYSJ.js.map
+//# sourceMappingURL=chunk-DNBP4GJN.js.map

package/dist/{chunk-XMDDBEEM.js → chunk-E763QI3G.js}

@@ -9,7 +9,7 @@ import {
 } from "./chunk-A2AOUBJS.js";
 import {
   RAW_FIELD
-} from "./chunk-4DJTQ6W4.js";
+} from "./chunk-JIKGT7DO.js";
 import {
   describeEntry
 } from "./chunk-4MIV244X.js";
@@ -139,4 +139,4 @@ export {
   rawField,
   codegen_entry_exports
 };
-//# sourceMappingURL=chunk-XMDDBEEM.js.map
+//# sourceMappingURL=chunk-E763QI3G.js.map

package/dist/{chunk-4NEBBKOP.js → chunk-EADVVTDK.js}

@@ -1,28 +1,28 @@
 import {
   retryCommand,
   withheldNote
-} from "./chunk-Z4VN347O.js";
+} from "./chunk-6X3MY2JP.js";
 import {
   contextFlags
-} from "./chunk-G57RYMKB.js";
+} from "./chunk-N5I37JFB.js";
 import {
   READ_AFTERMATH,
   SENT_AFTERMATH,
   closeSentence
-} from "./chunk-HLQH3AXB.js";
+} from "./chunk-YR2I5HGE.js";
 import {
   UsageError,
   detail,
   pastePath,
   warn
-} from "./chunk-XNZURZ7T.js";
+} from "./chunk-D7BUMOKU.js";
 import {
   shellQuote
 } from "./chunk-5ZSO4T2G.js";
 
 // src/emit/static-teardown.ts
 async function readStaticTeardown(auth, target, recorded) {
-  const { listServingStaticHosts } = await import("./static-host-UIR2OLPQ.js");
+  const { listServingStaticHosts } = await import("./static-host-ONEHA4LI.js");
   try {
     const serving = await listServingStaticHosts({ ...target, accessToken: auth.access_token });
     const urls = serving.map((s) => s.url);
@@ -130,7 +130,7 @@ function survivingRemedy(args, command) {
 async function assertStaticHostExists(args, auth, target) {
   const host = namedStaticHost(args);
   if (host === void 0) return;
-  const { listStaticHostNames, StaticHostNotFoundError } = await import("./static-host-UIR2OLPQ.js");
+  const { listStaticHostNames, StaticHostNotFoundError } = await import("./static-host-ONEHA4LI.js");
   let names;
   try {
     names = await listStaticHostNames({ ...target, accessToken: auth.access_token });
@@ -215,4 +215,4 @@ export {
   EXIT_STATIC_FAILED,
   unknownStaticOutcome
 };
-//# sourceMappingURL=chunk-4NEBBKOP.js.map
+//# sourceMappingURL=chunk-EADVVTDK.js.map

package/dist/{chunk-N6BWB35H.js → chunk-ENMBEXOP.js}

@@ -1,13 +1,13 @@
 import {
   ensureExportGitignored
-} from "./chunk-3WHWOKU4.js";
+} from "./chunk-UD2Z7K6W.js";
 import {
   andList
 } from "./chunk-622HUCZT.js";
 import {
   UsageError,
   warn
-} from "./chunk-XNZURZ7T.js";
+} from "./chunk-D7BUMOKU.js";
 
 // src/emit/output-target.ts
 import { accessSync, chmodSync, constants, mkdirSync, statSync, writeFileSync } from "fs";
@@ -125,4 +125,4 @@ export {
   secretsPhrase,
   assertWritableTarget
 };
-//# sourceMappingURL=chunk-N6BWB35H.js.map
+//# sourceMappingURL=chunk-ENMBEXOP.js.map

package/dist/{chunk-57HMNJGB.js → chunk-EQFYOOO6.js}

@@ -4,10 +4,12 @@ import {
   reactPreset
 } from "./chunk-M6ZFSTIZ.js";
 import {
+  blockVersion,
   composeBlock,
   gitattributesSpec,
+  htmlDialect,
   upsertBlock
-} from "./chunk-DGWHAVRG.js";
+} from "./chunk-3EDSPMXN.js";
 import {
   colorTokens,
   defaultThemeChoice,
@@ -412,25 +414,45 @@ VITE_XANO_HOST=https://your-instance.xano.io
 `;
 }
 var XANO_BADGE = "[![Built on Xano](https://img.shields.io/badge/built_on-Xano-0055FF)](https://xano.com)";
-function renderReadmeLearnMore() {
-  return `## Learn more
+var README_PATH = "README.md";
+var README_BUILT_WITH_BLOCK = {
+  dialect: htmlDialect("xanosdk-built-with"),
+  pkg: "xanosdk-built-with",
+  file: README_PATH
+};
+var README_BUILT_WITH_BODY = `## Built with
 
-- [Xano SDK guides](https://github.com/xano-sdk/sdk/blob/main/guides/README.md) \u2014 signing in
-  and deploying, releasing to production, the typed frontend, every CLI command.
-- [Xano](https://xano.com) is the platform this app deploys to: the database, APIs, auth,
-  background tasks, realtime, file storage and AI agents behind \`xano/\`, with
-  [docs](https://docs.xano.com) and a [community](https://community.xano.com).`;
+- [Xano](https://xano.com) hosts everything under [\`xano/\`](xano/): the database, APIs,
+  auth, background tasks, realtime, file storage and AI agents. It runs on your machine as
+  the Xano Engine and in the cloud from the same command. [Docs](https://docs.xano.com) \xB7
+  [Community](https://community.xano.com)
+- [Xano SDK](https://github.com/xano-sdk/sdk) is the TypeScript the backend is authored in.
+  The [guides](https://github.com/xano-sdk/sdk/blob/main/guides/README.md) cover signing in
+  and deploying, releasing to production, the typed frontend, and every CLI command.`;
+function renderReadmeBuiltWith(sdkVersion) {
+  return composeBlock(README_BUILT_WITH_BLOCK, [README_BUILT_WITH_BODY], sdkVersion);
+}
+function readmeBuiltWithVersion(text) {
+  return blockVersion(text, README_BUILT_WITH_BLOCK);
+}
+function refreshReadmeBuiltWith(existing, sdkVersion) {
+  return upsertBlock(existing, README_BUILT_WITH_BLOCK, renderReadmeBuiltWith(sdkVersion)).text;
 }
-function renderReadme({ appName, install }, preset, choice = defaultThemeChoice()) {
+function renderReadmeDescriptionSlot(appName) {
+  return `_Describe ${appName} here: what it does and who it is for._`;
+}
+function renderReadme({ appName, install, sdkVersion }, preset, choice = defaultThemeChoice()) {
   return `# ${appName}
 
 ${XANO_BADGE}
 
-A full-stack app on [Xano](https://xano.com). The backend is TypeScript under
-[\`xano/\`](xano/), authored with the [Xano SDK](https://github.com/xano-sdk/sdk). It runs on
-your machine on the **Xano Engine**, and one command deploys it to Xano's cloud. The
+${renderReadmeDescriptionSlot(appName)}
+
+The backend under [\`xano/\`](xano/) is TypeScript, authored with the
+[Xano SDK](https://github.com/xano-sdk/sdk) and running on [Xano](https://xano.com). It runs
+on your machine as the **Xano Engine** and ships to Xano's cloud with the same command. The
 ${preset.label} frontend under [\`frontend/\`](frontend/) takes its request paths and types
-from the backend defs, so the two can't drift.
+from the backend defs rather than hand-typing them.
 
 ## Quick start
 
@@ -529,8 +551,9 @@ export again. Every \`lock\` subcommand finds \`xano/xano.lock\` from the projec
 ## The one contract
 
 [\`frontend/src/lib/api.ts\`](frontend/src/lib/api.ts) takes request paths from
-\`xano/routes.gen.ts\` (\`routePath("GET notes/{id}", { id })\`) and request/response
-types from the query defs (\`import type\` + \`InferInput\` / \`InferResponse\`).
+\`xano/routes.gen.ts\` (\`routePath("GET notes/{id}", { id })\`), request types from the
+same file (\`RouteInputs["POST create_note"]\`, \`MessageInputs[...]\` for realtime), and
+response types from the query defs (\`import type\` + \`InferResponse\`).
 Never hand-type a URL or a request body \u2014 change a def and the frontend follows.
 
 \`npm run xano:routes\` writes \`xano/routes.gen.ts\` from the defs; \`dev\`, \`build\`
@@ -572,7 +595,7 @@ Xano SDK is composable with other \`@xano-sdk/*\` packages:
 None of these ship with the scaffold. Install one only when you need it \u2014 an
 add-on you never register is weight in \`package.json\` for nothing.
 
-${renderReadmeLearnMore()}
+${renderReadmeBuiltWith(sdkVersion)}
 `;
 }
 function renderXanoIndex({ appName }) {
@@ -743,8 +766,11 @@ URL or a request body:
   groups share is keyed \`"<group>:<VERB> <name>"\`). Run
   \`npm run xano:routes\` after adding or renaming an endpoint (\`dev\`, \`build\` and
   \`typecheck\` also run it) and commit the file.
-- **Shapes** come from the defs with \`import type\` \u2014 \`InferInput\`/\`InferResponse\`
-  erase to nothing.
+- **Request types** come from the same file: \`RouteInputs["POST create_note"]\`
+  (\`ChannelInputs\`/\`MessageInputs\` for realtime). For runtime validation,
+  \`npx xanosdk marketplace install zod\` adds zod schemas under the same keys.
+- **Response types** come from the defs with \`import type\` \u2014 \`InferResponse\`
+  erases to nothing.
 - Never import a def as a value in the frontend. Its \`s.*\`/\`c.*\` stack calls run
   at module load, so one import for its \`getPath()\` pulls the backend graph it
   references and the SDK runtime into the bundle.
@@ -785,7 +811,7 @@ function renderCodegenMarker({ sdkVersion }, origin, generatedAt, report, files)
   };
   return JSON.stringify(files === void 0 ? head : decodeMarkerWith(head, files), null, 2) + "\n";
 }
-function renderCodegenReadme({ appName }, origin, envNames, preset) {
+function renderCodegenReadme({ appName, sdkVersion }, origin, envNames, preset) {
   const secrets = envNames.length === 0 ? "" : `
 ## Fill in the backend env values
 
@@ -814,10 +840,12 @@ cleartext, which is why it is gitignored too.
 
 ${XANO_BADGE}
 
-A full-stack app on [Xano](https://xano.com), pulled from
-${describeCommittedOrigin(origin)} with the [Xano SDK](https://github.com/xano-sdk/sdk). The Xano
-backend lives in [\`xano/\`](xano/) as readable TypeScript; the ${preset.label} frontend
-under [\`frontend/\`](frontend/) is a starter \u2014 the pull carries a backend, not a UI.
+${renderReadmeDescriptionSlot(appName)}
+
+The backend under [\`xano/\`](xano/) is TypeScript pulled from ${describeCommittedOrigin(origin)}
+with the [Xano SDK](https://github.com/xano-sdk/sdk), and runs on [Xano](https://xano.com). The
+${preset.label} frontend under [\`frontend/\`](frontend/) is a starter \u2014 the pull carries a
+backend, not a UI.
 
 ## Run it
 
@@ -851,13 +879,13 @@ ${secrets}
 npm run dev            # run the starter frontend
 npm run typecheck      # the whole project, both halves
 npm run xano:export    # compile the backend to workspace.json (don't commit it)
-npm run xano:routes    # regenerate xano/routes.gen.ts, the frontend's paths
+npm run xano:routes    # regenerate xano/routes.gen.ts: the frontend's paths and request types
 \`\`\`
 
 [\`frontend/src/lib/api.ts\`](frontend/src/lib/api.ts) shows the one contract: paths
-from \`routePath()\` in \`xano/routes.gen.ts\`, types from the query defs in \`xano/\`.
+and request types from \`xano/routes.gen.ts\`, response types from the query defs in \`xano/\`.
 
-${renderReadmeLearnMore()}
+${renderReadmeBuiltWith(sdkVersion)}
 `;
 }
 function renderReadmeThemingSection(choice) {
@@ -1107,9 +1135,9 @@ export function cn(...inputs: ClassValue[]) {
 ${extra}`;
 }
 function renderApiTs() {
-  return `// The one contract: endpoint paths come from the generated route manifest, and
-// request/response *types* from your xanosdk query defs. Never hand-type a URL
-// or a request body: change a def and everything here follows.
+  return `// The one contract: endpoint paths and request types come from the generated
+// route manifest, and response *types* from your xanosdk query defs. Never
+// hand-type a URL or a request body: change a def and everything here follows.
 //
 // Keep the backend out of the browser bundle:
 //   \u2022 Paths and verbs: \`routePath()\` / \`ROUTES\` from xano/routes.gen.ts, plain data
@@ -1117,16 +1145,20 @@ function renderApiTs() {
 //     regenerate it). Never import a def as a VALUE for its getPath()/verb:
 //     its s.*/c.* factory calls run at module load, so one import pulls in the
 //     backend graph it references and the SDK runtime that builds it.
-//   \u2022 Shapes: \`import type\` only. InferInput/InferResponse erase to nothing.
+//   \u2022 Request types: \`RouteInputs["<VERB> <name>"]\` from the same file
+//     (\`ChannelInputs\` / \`MessageInputs\` for realtime), types only. For
+//     runtime validation, \`npx xanosdk marketplace install zod\` adds zod
+//     schemas under the same keys.
+//   \u2022 Response types: \`import type\` the def. InferResponse erases to nothing.
 //
 // Nothing here imports the manifest yet \u2014 an add-on's endpoints may already be
 // in it. Wire an endpoint (one in xano/, or an add-on's) like:
 //
-//   import type { InferInput, InferResponse } from "@xano/sdk";
+//   import type { InferResponse } from "@xano/sdk";
 //   import type { createNoteQuery } from "../../../xano/api/create-note.js";
-//   import { ROUTES, routePath } from "../../../xano/routes.gen.js";
+//   import { ROUTES, routePath, type RouteInputs } from "../../../xano/routes.gen.js";
 //
-//   export type CreateNoteBody = InferInput<typeof createNoteQuery>;
+//   export type CreateNoteBody = RouteInputs["POST create_note"];
 //   export type Note = InferResponse<typeof createNoteQuery>;
 //
 //   export async function createNote(body: CreateNoteBody): Promise<Note> {
@@ -2013,6 +2045,9 @@ export {
   checkWorkflowPath,
   renderCheckWorkflow,
   renderEnvExample,
+  README_PATH,
+  readmeBuiltWithVersion,
+  refreshReadmeBuiltWith,
   renderReadme,
   renderXanoIndex,
   renderXanoExampleMd,
@@ -2031,4 +2066,4 @@ export {
   allFrontendPresets,
   resolveFrameworkFlag
 };
-//# sourceMappingURL=chunk-57HMNJGB.js.map
+//# sourceMappingURL=chunk-EQFYOOO6.js.map

package/dist/{chunk-WOGJB2F6.js → chunk-FNLTFOUD.js}

@@ -25,11 +25,11 @@ import {
   isDeadResultItem,
   isEmptyCustomize,
   normalize
-} from "./chunk-3HOGFGKG.js";
+} from "./chunk-D3KEPRRN.js";
 import {
   f,
   input
-} from "./chunk-37FBPMNE.js";
+} from "./chunk-S56YBYMN.js";
 import {
   TAGS,
   auth,
@@ -59,7 +59,7 @@ import {
   defaultNullable,
   encodeField,
   parseMethod
-} from "./chunk-4DJTQ6W4.js";
+} from "./chunk-JIKGT7DO.js";
 
 // src/codegen/report.ts
 var AUDIENCE_ORDER = [
@@ -505,11 +505,6 @@ var DecodeContext = class {
    * for `generate --out`. Only the caller knows the directory.
    */
   secretsFile = WORKSPACE_SECRETS_FILE;
-  /**
-   * Whether the caller writes that sidecar at all. `--no-secrets` does not, and
-   * the report has to say so rather than promise a file and a restored gate.
-   */
-  writesSecrets = true;
   /** The barrel's `workspace("…")` name when the payload carries no workspace object. */
   fallbackWorkspaceName = "workspace";
   /** The import block of the file currently being generated. */
@@ -2026,4 +2021,4 @@ export {
   decodeTableSchema,
   decodeResponse
 };
-//# sourceMappingURL=chunk-WOGJB2F6.js.map
+//# sourceMappingURL=chunk-FNLTFOUD.js.map

package/dist/{chunk-FV55SRQU.js → chunk-FQ53GTII.js}

@@ -7,7 +7,7 @@ import {
   parsePathParams,
   queryKind,
   warnUnboundReturn
-} from "./chunk-3IYVHVM6.js";
+} from "./chunk-VJFMUJWZ.js";
 import {
   workspaceKind
 } from "./chunk-6JAEMMZ7.js";
@@ -16,7 +16,7 @@ import {
   encodeMcpOauth,
   refuseUnknown,
   standaloneDefKind
-} from "./chunk-SRX6B544.js";
+} from "./chunk-5QMJOE2K.js";
 import {
   resolveAuthRef
 } from "./chunk-45ZUMF4E.js";
@@ -68,7 +68,7 @@ import {
   registerSpec,
   resolveEnumValue,
   throwError
-} from "./chunk-JSEVKRVJ.js";
+} from "./chunk-T4LJ5UR2.js";
 import {
   assertCanonical,
   assertStoredName,
@@ -83,7 +83,7 @@ import {
   encodeExpression,
   encodeRuntimeCondition,
   tableKind
-} from "./chunk-VZ22VUAS.js";
+} from "./chunk-SLGJIWCY.js";
 import {
   brandDef
 } from "./chunk-ERVIASGL.js";
@@ -99,10 +99,10 @@ import {
 } from "./chunk-WTPZRR4I.js";
 import {
   emitDiagnostic
-} from "./chunk-GPI3OWRE.js";
+} from "./chunk-YHB34BN6.js";
 import {
   lockKey
-} from "./chunk-OKNE3TWU.js";
+} from "./chunk-5KJBWIDZ.js";
 import {
   HOSTED_FILE_SCHEME,
   isHostedFile,
@@ -121,10 +121,10 @@ import {
 import {
   impliedInputs,
   isTriggerObjType
-} from "./chunk-7GX445AE.js";
+} from "./chunk-4XHAT7C5.js";
 import {
   encodeInput
-} from "./chunk-37FBPMNE.js";
+} from "./chunk-S56YBYMN.js";
 import {
   barePatternRefusal,
   c,
@@ -3058,4 +3058,4 @@ export {
   serializeBundle,
   emitBundle
 };
-//# sourceMappingURL=chunk-FV55SRQU.js.map
+//# sourceMappingURL=chunk-FQ53GTII.js.map

package/dist/{chunk-TUEFTRC2.js → chunk-FU3VCE5A.js}

@@ -4,13 +4,16 @@ import {
   managedBlockVersion,
   renderAgentsMd,
   upsertManagedBlock
-} from "./chunk-F6IKWAIU.js";
+} from "./chunk-LL7SGTRC.js";
 import {
   detectPackageManager
-} from "./chunk-WRBKLYSJ.js";
+} from "./chunk-DNBP4GJN.js";
 import {
-  allFrontendPresets
-} from "./chunk-57HMNJGB.js";
+  README_PATH,
+  allFrontendPresets,
+  readmeBuiltWithVersion,
+  refreshReadmeBuiltWith
+} from "./chunk-EQFYOOO6.js";
 import {
   allIconLibraries
 } from "./chunk-M6ZFSTIZ.js";
@@ -18,7 +21,7 @@ import {
   projectFileCli,
   projectSdkDir,
   warn
-} from "./chunk-XNZURZ7T.js";
+} from "./chunk-D7BUMOKU.js";
 import {
   DEFAULT_DARK_MODE
 } from "./chunk-TFFGOFVZ.js";
@@ -149,33 +152,49 @@ function appNameFor(projectDir) {
   }
   return basename(projectDir);
 }
+function managedFiles(opts) {
+  return [
+    {
+      path: AGENTS_MD_PATH,
+      stampedVersion: managedBlockVersion,
+      refreshed: (existing) => {
+        const manager = detectPackageManager(opts.projectDir);
+        return upsertManagedBlock(
+          existing,
+          renderAgentsMd(opts.appName ?? appNameFor(opts.projectDir), opts.mode ?? guidanceModeFor(opts.projectDir), {
+            version: opts.sdkVersion,
+            frontend: opts.frontend ?? detectFrontendGuidance(opts.projectDir),
+            cli: projectFileCli(opts.projectDir, manager),
+            sdkDir: projectSdkDir(opts.projectDir, manager)
+          })
+        );
+      }
+    },
+    {
+      path: README_PATH,
+      stampedVersion: readmeBuiltWithVersion,
+      refreshed: (existing) => refreshReadmeBuiltWith(existing, opts.sdkVersion)
+    }
+  ];
+}
 function refreshAgentFiles(opts) {
   const env = opts.env ?? process.env;
   if (opts.explicit !== true && (isCI(env) || !codingAgentDetected(env))) return [];
-  const path = AGENTS_MD_PATH;
-  const absolute = join2(opts.projectDir, path);
-  if (!existsSync2(absolute)) return [];
+  return managedFiles(opts).filter((file) => refreshFile(opts, file)).map((file) => file.path);
+}
+function refreshFile(opts, file) {
+  const absolute = join2(opts.projectDir, file.path);
+  if (!existsSync2(absolute)) return false;
   try {
     const existing = readFileSync2(absolute, "utf8");
-    if (managedBlockVersion(existing) === null) return [];
-    const manager = detectPackageManager(opts.projectDir);
-    const rendered = renderAgentsMd(
-      opts.appName ?? appNameFor(opts.projectDir),
-      opts.mode ?? guidanceModeFor(opts.projectDir),
-      {
-        version: opts.sdkVersion,
-        frontend: opts.frontend ?? detectFrontendGuidance(opts.projectDir),
-        cli: projectFileCli(opts.projectDir, manager),
-        sdkDir: projectSdkDir(opts.projectDir, manager)
-      }
-    );
-    const updated = upsertManagedBlock(existing, rendered);
-    if (updated === existing) return [];
+    if (file.stampedVersion(existing) === null) return false;
+    const updated = file.refreshed(existing);
+    if (updated === existing) return false;
     if (opts.write !== false) writeFileSync(absolute, updated);
-    return [path];
+    return true;
   } catch (err) {
-    warn(`could not refresh ${path}: ${err instanceof Error ? err.message : String(err)}`, "agents.refresh-failed");
-    return [];
+    warn(`could not refresh ${file.path}: ${err instanceof Error ? err.message : String(err)}`, "agents.refresh-failed");
+    return false;
   }
 }
 
@@ -186,4 +205,4 @@ export {
   isCI,
   refreshAgentFiles
 };
-//# sourceMappingURL=chunk-TUEFTRC2.js.map
+//# sourceMappingURL=chunk-FU3VCE5A.js.map