@meetkai/mka1 0.54.71 → 0.54.72

package/dist/esm/lib/config.js

@@ -31,8 +31,8 @@ export function serverURLFromOptions(options) {
 export const SDK_METADATA = {
     language: "typescript",
     openapiDocVersion: "1.1.0",
-    sdkVersion: "0.54.71",
+    sdkVersion: "0.54.72",
     genVersion: "2.943.0",
-    userAgent: "speakeasy-sdk/typescript 0.54.71 2.943.0 1.1.0 @meetkai/mka1",
+    userAgent: "speakeasy-sdk/typescript 0.54.72 2.943.0 1.1.0 @meetkai/mka1",
 };
 //# sourceMappingURL=config.js.map

package/dist/esm/mcp-server/mcp-server.js

@@ -16,7 +16,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
     name: "mcp",
     versionInfo: {
-        currentVersion: "0.54.71",
+        currentVersion: "0.54.72",
     },
 });
 run(app, process.argv.slice(2), buildContext(process));

package/dist/esm/mcp-server/server.js

@@ -458,7 +458,7 @@ import { tool$usageSandbox } from "./tools/usageSandbox.js";
 export function createMCPServer(deps) {
     const server = new McpServer({
         name: "SDK",
-        version: "0.54.71",
+        version: "0.54.72",
     });
     const client = new SDKCore({
         bearerAuth: deps.bearerAuth,

package/dist/esm/mcp-server/tools/reposCreate.js

@@ -11,11 +11,11 @@ export const tool$reposCreate = {
     name: "repos-create",
     description: `Create a repository
 
-Provisions a repository (org owner/admin only): DB insert
-(authoritative) → Gitea create (rolled back on failure). The repository
-belongs to the caller's org. \`kind\` says what it will hold and defaults
-to \`repo\` (a plain git repository); it decides which protocol planes
-answer for the name (see the \`Repo\` schema).
+Provisions a repository (org owner/admin only); a failed provision is
+rolled back best-effort (see the \`502\`). The repository belongs to the
+caller's org. \`kind\` says what it will hold and defaults to \`repo\` (a
+plain git repository); it decides which protocol planes answer for the
+name (see the \`Repo\` schema).
 `,
     args,
     tool: async (client, args, ctx) => {

package/dist/esm/mcp-server/tools/reposDelete.js

@@ -11,8 +11,8 @@ export const tool$reposDelete = {
     name: "repos-delete",
     description: `Delete a repository
 
-Removes a repository; org owner/admin only. The DB delete is
-authoritative; the Gitea teardown is best-effort cleanup.
+Removes a repository; org owner/admin only. The deletion is
+authoritative; the contents are cleaned up best-effort.
 `,
     args,
     tool: async (client, args, ctx) => {

package/dist/esm/mcp-server/tools/reposList.js

@@ -12,7 +12,7 @@ export const tool$reposList = {
     description: `List the caller's org's repositories
 
 Returns every repository in the caller's org (org owner/admin only).
-Pure DB read. With \`kind\`, only repositories of that kind; an untyped
+Read-only. With \`kind\`, only repositories of that kind; an untyped
 (legacy, \`kind: null\`) repository appears in the unfiltered listing
 only.
 `,

package/dist/esm/mcp-server/tools/reposUpdate.js

@@ -12,15 +12,15 @@ export const tool$reposUpdate = {
     description: `Update a repository's labels
 
 Applies a label-only update (name/description/kind); org owner/admin
-only. The repository id is stable, so a rename is a one-row DB update
-— no Gitea write. Omitted fields are left unchanged.
+only. The repository id is stable, so a rename touches no contents.
+Omitted fields are left unchanged.
 
 \`kind\` is the ONE way a repository's kind changes after creation (the
 protocol planes never change it): it types a legacy \`kind: null\`
 repository and corrects a wrong kind. \`repo\`, \`model\` and \`dataset\`
 convert freely and any repository may become \`image\`; a repository
 whose container images are still named by a tag can be given no
-other kind — leaving \`image\`, or typing a legacy \`null\` row as
+other kind — leaving \`image\`, or typing a legacy \`null\` repository as
 anything else, is refused with \`409 kind_has_content\` (list and
 delete the tags through this API first). A switch away from \`image\`
 collects every image no tag reaches before it is judged, so an image

package/dist/esm/models/components/repo.d.ts

@@ -11,7 +11,7 @@ export type Repo = {
      * (the API, `git push`, the HF client, the OCI registry). It is the
      * same id the platform session and mk-authentication's members
      * directory use, so a name is one directory lookup away. `null`
-     * for a row that records no user id; never an empty string.
+     * for a repository that records no user id; never an empty string.
      */
     creator: string | null;
     description: string;

package/dist/esm/react-query/reposCreate.d.ts

@@ -19,11 +19,11 @@ export type ReposCreateMutationError = errors.RepoError | SDKError | ResponseVal
  * Create a repository
  *
  * @remarks
- * Provisions a repository (org owner/admin only): DB insert
- * (authoritative) → Gitea create (rolled back on failure). The repository
- * belongs to the caller's org. `kind` says what it will hold and defaults
- * to `repo` (a plain git repository); it decides which protocol planes
- * answer for the name (see the `Repo` schema).
+ * Provisions a repository (org owner/admin only); a failed provision is
+ * rolled back best-effort (see the `502`). The repository belongs to the
+ * caller's org. `kind` says what it will hold and defaults to `repo` (a
+ * plain git repository); it decides which protocol planes answer for the
+ * name (see the `Repo` schema).
  */
 export declare function useReposCreateMutation(options?: MutationHookOptions<ReposCreateMutationData, ReposCreateMutationError, ReposCreateMutationVariables>): UseMutationResult<ReposCreateMutationData, ReposCreateMutationError, ReposCreateMutationVariables>;
 export declare function mutationKeyReposCreate(): MutationKey;

package/dist/esm/react-query/reposCreate.js

@@ -10,11 +10,11 @@ import { useSDKContext } from "./_context.js";
  * Create a repository
  *
  * @remarks
- * Provisions a repository (org owner/admin only): DB insert
- * (authoritative) → Gitea create (rolled back on failure). The repository
- * belongs to the caller's org. `kind` says what it will hold and defaults
- * to `repo` (a plain git repository); it decides which protocol planes
- * answer for the name (see the `Repo` schema).
+ * Provisions a repository (org owner/admin only); a failed provision is
+ * rolled back best-effort (see the `502`). The repository belongs to the
+ * caller's org. `kind` says what it will hold and defaults to `repo` (a
+ * plain git repository); it decides which protocol planes answer for the
+ * name (see the `Repo` schema).
  */
 export function useReposCreateMutation(options) {
     const client = useSDKContext();

package/dist/esm/react-query/reposDelete.d.ts

@@ -18,8 +18,8 @@ export type ReposDeleteMutationError = errors.RepoError | SDKError | ResponseVal
  * Delete a repository
  *
  * @remarks
- * Removes a repository; org owner/admin only. The DB delete is
- * authoritative; the Gitea teardown is best-effort cleanup.
+ * Removes a repository; org owner/admin only. The deletion is
+ * authoritative; the contents are cleaned up best-effort.
  */
 export declare function useReposDeleteMutation(options?: MutationHookOptions<ReposDeleteMutationData, ReposDeleteMutationError, ReposDeleteMutationVariables>): UseMutationResult<ReposDeleteMutationData, ReposDeleteMutationError, ReposDeleteMutationVariables>;
 export declare function mutationKeyReposDelete(): MutationKey;

package/dist/esm/react-query/reposDelete.js

@@ -10,8 +10,8 @@ import { useSDKContext } from "./_context.js";
  * Delete a repository
  *
  * @remarks
- * Removes a repository; org owner/admin only. The DB delete is
- * authoritative; the Gitea teardown is best-effort cleanup.
+ * Removes a repository; org owner/admin only. The deletion is
+ * authoritative; the contents are cleaned up best-effort.
  */
 export function useReposDeleteMutation(options) {
     const client = useSDKContext();

package/dist/esm/react-query/reposList.d.ts

@@ -15,7 +15,7 @@ export type ReposListQueryError = errors.RepoError | SDKError | ResponseValidati
  *
  * @remarks
  * Returns every repository in the caller's org (org owner/admin only).
- * Pure DB read. With `kind`, only repositories of that kind; an untyped
+ * Read-only. With `kind`, only repositories of that kind; an untyped
  * (legacy, `kind: null`) repository appears in the unfiltered listing
  * only.
  */
@@ -25,7 +25,7 @@ export declare function useReposList(request: operations.ListReposRequest, optio
  *
  * @remarks
  * Returns every repository in the caller's org (org owner/admin only).
- * Pure DB read. With `kind`, only repositories of that kind; an untyped
+ * Read-only. With `kind`, only repositories of that kind; an untyped
  * (legacy, `kind: null`) repository appears in the unfiltered listing
  * only.
  */

package/dist/esm/react-query/reposList.js

@@ -10,7 +10,7 @@ export { buildReposListQuery, prefetchReposList, queryKeyReposList, };
  *
  * @remarks
  * Returns every repository in the caller's org (org owner/admin only).
- * Pure DB read. With `kind`, only repositories of that kind; an untyped
+ * Read-only. With `kind`, only repositories of that kind; an untyped
  * (legacy, `kind: null`) repository appears in the unfiltered listing
  * only.
  */
@@ -26,7 +26,7 @@ export function useReposList(request, options) {
  *
  * @remarks
  * Returns every repository in the caller's org (org owner/admin only).
- * Pure DB read. With `kind`, only repositories of that kind; an untyped
+ * Read-only. With `kind`, only repositories of that kind; an untyped
  * (legacy, `kind: null`) repository appears in the unfiltered listing
  * only.
  */

package/dist/esm/react-query/reposUpdate.d.ts

@@ -20,15 +20,15 @@ export type ReposUpdateMutationError = errors.RepoError | SDKError | ResponseVal
  *
  * @remarks
  * Applies a label-only update (name/description/kind); org owner/admin
- * only. The repository id is stable, so a rename is a one-row DB update
- * — no Gitea write. Omitted fields are left unchanged.
+ * only. The repository id is stable, so a rename touches no contents.
+ * Omitted fields are left unchanged.
  *
  * `kind` is the ONE way a repository's kind changes after creation (the
  * protocol planes never change it): it types a legacy `kind: null`
  * repository and corrects a wrong kind. `repo`, `model` and `dataset`
  * convert freely and any repository may become `image`; a repository
  * whose container images are still named by a tag can be given no
- * other kind — leaving `image`, or typing a legacy `null` row as
+ * other kind — leaving `image`, or typing a legacy `null` repository as
  * anything else, is refused with `409 kind_has_content` (list and
  * delete the tags through this API first). A switch away from `image`
  * collects every image no tag reaches before it is judged, so an image

package/dist/esm/react-query/reposUpdate.js

@@ -11,15 +11,15 @@ import { useSDKContext } from "./_context.js";
  *
  * @remarks
  * Applies a label-only update (name/description/kind); org owner/admin
- * only. The repository id is stable, so a rename is a one-row DB update
- * — no Gitea write. Omitted fields are left unchanged.
+ * only. The repository id is stable, so a rename touches no contents.
+ * Omitted fields are left unchanged.
  *
  * `kind` is the ONE way a repository's kind changes after creation (the
  * protocol planes never change it): it types a legacy `kind: null`
  * repository and corrects a wrong kind. `repo`, `model` and `dataset`
  * convert freely and any repository may become `image`; a repository
  * whose container images are still named by a tag can be given no
- * other kind — leaving `image`, or typing a legacy `null` row as
+ * other kind — leaving `image`, or typing a legacy `null` repository as
  * anything else, is refused with `409 kind_has_content` (list and
  * delete the tags through this API first). A switch away from `image`
  * collects every image no tag reaches before it is judged, so an image

package/dist/esm/sdk/repos.d.ts

@@ -10,7 +10,7 @@ export declare class Repos extends ClientSDK {
      *
      * @remarks
      * Returns every repository in the caller's org (org owner/admin only).
-     * Pure DB read. With `kind`, only repositories of that kind; an untyped
+     * Read-only. With `kind`, only repositories of that kind; an untyped
      * (legacy, `kind: null`) repository appears in the unfiltered listing
      * only.
      */
@@ -19,19 +19,19 @@ export declare class Repos extends ClientSDK {
      * Create a repository
      *
      * @remarks
-     * Provisions a repository (org owner/admin only): DB insert
-     * (authoritative) → Gitea create (rolled back on failure). The repository
-     * belongs to the caller's org. `kind` says what it will hold and defaults
-     * to `repo` (a plain git repository); it decides which protocol planes
-     * answer for the name (see the `Repo` schema).
+     * Provisions a repository (org owner/admin only); a failed provision is
+     * rolled back best-effort (see the `502`). The repository belongs to the
+     * caller's org. `kind` says what it will hold and defaults to `repo` (a
+     * plain git repository); it decides which protocol planes answer for the
+     * name (see the `Repo` schema).
      */
     create(request: operations.CreateRepoRequest, options?: RequestOptions): Promise<components.Repo>;
     /**
      * Delete a repository
      *
      * @remarks
-     * Removes a repository; org owner/admin only. The DB delete is
-     * authoritative; the Gitea teardown is best-effort cleanup.
+     * Removes a repository; org owner/admin only. The deletion is
+     * authoritative; the contents are cleaned up best-effort.
      */
     delete(request: operations.DeleteRepoRequest, options?: RequestOptions): Promise<void>;
     /**
@@ -47,15 +47,15 @@ export declare class Repos extends ClientSDK {
      *
      * @remarks
      * Applies a label-only update (name/description/kind); org owner/admin
-     * only. The repository id is stable, so a rename is a one-row DB update
-     * — no Gitea write. Omitted fields are left unchanged.
+     * only. The repository id is stable, so a rename touches no contents.
+     * Omitted fields are left unchanged.
      *
      * `kind` is the ONE way a repository's kind changes after creation (the
      * protocol planes never change it): it types a legacy `kind: null`
      * repository and corrects a wrong kind. `repo`, `model` and `dataset`
      * convert freely and any repository may become `image`; a repository
      * whose container images are still named by a tag can be given no
-     * other kind — leaving `image`, or typing a legacy `null` row as
+     * other kind — leaving `image`, or typing a legacy `null` repository as
      * anything else, is refused with `409 kind_has_content` (list and
      * delete the tags through this API first). A switch away from `image`
      * collects every image no tag reaches before it is judged, so an image

package/dist/esm/sdk/repos.js

@@ -18,7 +18,7 @@ export class Repos extends ClientSDK {
      *
      * @remarks
      * Returns every repository in the caller's org (org owner/admin only).
-     * Pure DB read. With `kind`, only repositories of that kind; an untyped
+     * Read-only. With `kind`, only repositories of that kind; an untyped
      * (legacy, `kind: null`) repository appears in the unfiltered listing
      * only.
      */
@@ -29,11 +29,11 @@ export class Repos extends ClientSDK {
      * Create a repository
      *
      * @remarks
-     * Provisions a repository (org owner/admin only): DB insert
-     * (authoritative) → Gitea create (rolled back on failure). The repository
-     * belongs to the caller's org. `kind` says what it will hold and defaults
-     * to `repo` (a plain git repository); it decides which protocol planes
-     * answer for the name (see the `Repo` schema).
+     * Provisions a repository (org owner/admin only); a failed provision is
+     * rolled back best-effort (see the `502`). The repository belongs to the
+     * caller's org. `kind` says what it will hold and defaults to `repo` (a
+     * plain git repository); it decides which protocol planes answer for the
+     * name (see the `Repo` schema).
      */
     async create(request, options) {
         return unwrapAsync(reposCreate(this, request, options));
@@ -42,8 +42,8 @@ export class Repos extends ClientSDK {
      * Delete a repository
      *
      * @remarks
-     * Removes a repository; org owner/admin only. The DB delete is
-     * authoritative; the Gitea teardown is best-effort cleanup.
+     * Removes a repository; org owner/admin only. The deletion is
+     * authoritative; the contents are cleaned up best-effort.
      */
     async delete(request, options) {
         return unwrapAsync(reposDelete(this, request, options));
@@ -63,15 +63,15 @@ export class Repos extends ClientSDK {
      *
      * @remarks
      * Applies a label-only update (name/description/kind); org owner/admin
-     * only. The repository id is stable, so a rename is a one-row DB update
-     * — no Gitea write. Omitted fields are left unchanged.
+     * only. The repository id is stable, so a rename touches no contents.
+     * Omitted fields are left unchanged.
      *
      * `kind` is the ONE way a repository's kind changes after creation (the
      * protocol planes never change it): it types a legacy `kind: null`
      * repository and corrects a wrong kind. `repo`, `model` and `dataset`
      * convert freely and any repository may become `image`; a repository
      * whose container images are still named by a tag can be given no
-     * other kind — leaving `image`, or typing a legacy `null` row as
+     * other kind — leaving `image`, or typing a legacy `null` repository as
      * anything else, is refused with `409 kind_has_content` (list and
      * delete the tags through this API first). A switch away from `image`
      * collects every image no tag reaches before it is judged, so an image

package/jsr.json

@@ -2,7 +2,7 @@
 
 {
   "name": "@meetkai/mka1",
-  "version": "0.54.71",
+  "version": "0.54.72",
   "exports": {
     ".": "./src/index.ts",    
     "./models/errors": "./src/models/errors/index.ts",    

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meetkai/mka1",
-  "version": "0.54.71",
+  "version": "0.54.72",
   "author": "Daniel Wilder <dauncy@gmail.com>",
   "homepage": "https://docs.mka1.com",
   "publishConfig": {

package/src/funcs/reposCreate.ts

@@ -31,11 +31,11 @@ import { Result } from "../types/fp.js";
  * Create a repository
  *
  * @remarks
- * Provisions a repository (org owner/admin only): DB insert
- * (authoritative) → Gitea create (rolled back on failure). The repository
- * belongs to the caller's org. `kind` says what it will hold and defaults
- * to `repo` (a plain git repository); it decides which protocol planes
- * answer for the name (see the `Repo` schema).
+ * Provisions a repository (org owner/admin only); a failed provision is
+ * rolled back best-effort (see the `502`). The repository belongs to the
+ * caller's org. `kind` says what it will hold and defaults to `repo` (a
+ * plain git repository); it decides which protocol planes answer for the
+ * name (see the `Repo` schema).
  *
  * If set, this operation will use {@link Security.bearerAuth} from the global security.
  */

package/src/funcs/reposDelete.ts

@@ -31,8 +31,8 @@ import { Result } from "../types/fp.js";
  * Delete a repository
  *
  * @remarks
- * Removes a repository; org owner/admin only. The DB delete is
- * authoritative; the Gitea teardown is best-effort cleanup.
+ * Removes a repository; org owner/admin only. The deletion is
+ * authoritative; the contents are cleaned up best-effort.
  *
  * If set, this operation will use {@link Security.bearerAuth} from the global security.
  */

package/src/funcs/reposList.ts

@@ -31,7 +31,7 @@ import { Result } from "../types/fp.js";
  *
  * @remarks
  * Returns every repository in the caller's org (org owner/admin only).
- * Pure DB read. With `kind`, only repositories of that kind; an untyped
+ * Read-only. With `kind`, only repositories of that kind; an untyped
  * (legacy, `kind: null`) repository appears in the unfiltered listing
  * only.
  *

package/src/funcs/reposUpdate.ts

@@ -32,15 +32,15 @@ import { Result } from "../types/fp.js";
  *
  * @remarks
  * Applies a label-only update (name/description/kind); org owner/admin
- * only. The repository id is stable, so a rename is a one-row DB update
- * — no Gitea write. Omitted fields are left unchanged.
+ * only. The repository id is stable, so a rename touches no contents.
+ * Omitted fields are left unchanged.
  *
  * `kind` is the ONE way a repository's kind changes after creation (the
  * protocol planes never change it): it types a legacy `kind: null`
  * repository and corrects a wrong kind. `repo`, `model` and `dataset`
  * convert freely and any repository may become `image`; a repository
  * whose container images are still named by a tag can be given no
- * other kind — leaving `image`, or typing a legacy `null` row as
+ * other kind — leaving `image`, or typing a legacy `null` repository as
  * anything else, is refused with `409 kind_has_content` (list and
  * delete the tags through this API first). A switch away from `image`
  * collects every image no tag reaches before it is judged, so an image

package/src/lib/config.ts

@@ -65,7 +65,7 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "1.1.0",
-  sdkVersion: "0.54.71",
+  sdkVersion: "0.54.72",
   genVersion: "2.943.0",
-  userAgent: "speakeasy-sdk/typescript 0.54.71 2.943.0 1.1.0 @meetkai/mka1",
+  userAgent: "speakeasy-sdk/typescript 0.54.72 2.943.0 1.1.0 @meetkai/mka1",
 } as const;

package/src/mcp-server/mcp-server.ts

@@ -19,7 +19,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.54.71",
+    currentVersion: "0.54.72",
   },
 });
 

package/src/mcp-server/server.ts

@@ -473,7 +473,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "SDK",
-    version: "0.54.71",
+    version: "0.54.72",
   });
 
   const client = new SDKCore({

package/src/mcp-server/tools/reposCreate.ts

@@ -14,11 +14,11 @@ export const tool$reposCreate: ToolDefinition<typeof args> = {
   name: "repos-create",
   description: `Create a repository
 
-Provisions a repository (org owner/admin only): DB insert
-(authoritative) → Gitea create (rolled back on failure). The repository
-belongs to the caller's org. \`kind\` says what it will hold and defaults
-to \`repo\` (a plain git repository); it decides which protocol planes
-answer for the name (see the \`Repo\` schema).
+Provisions a repository (org owner/admin only); a failed provision is
+rolled back best-effort (see the \`502\`). The repository belongs to the
+caller's org. \`kind\` says what it will hold and defaults to \`repo\` (a
+plain git repository); it decides which protocol planes answer for the
+name (see the \`Repo\` schema).
 `,
   args,
   tool: async (client, args, ctx) => {

package/src/mcp-server/tools/reposDelete.ts

@@ -14,8 +14,8 @@ export const tool$reposDelete: ToolDefinition<typeof args> = {
   name: "repos-delete",
   description: `Delete a repository
 
-Removes a repository; org owner/admin only. The DB delete is
-authoritative; the Gitea teardown is best-effort cleanup.
+Removes a repository; org owner/admin only. The deletion is
+authoritative; the contents are cleaned up best-effort.
 `,
   args,
   tool: async (client, args, ctx) => {

package/src/mcp-server/tools/reposList.ts

@@ -15,7 +15,7 @@ export const tool$reposList: ToolDefinition<typeof args> = {
   description: `List the caller's org's repositories
 
 Returns every repository in the caller's org (org owner/admin only).
-Pure DB read. With \`kind\`, only repositories of that kind; an untyped
+Read-only. With \`kind\`, only repositories of that kind; an untyped
 (legacy, \`kind: null\`) repository appears in the unfiltered listing
 only.
 `,

package/src/mcp-server/tools/reposUpdate.ts

@@ -15,15 +15,15 @@ export const tool$reposUpdate: ToolDefinition<typeof args> = {
   description: `Update a repository's labels
 
 Applies a label-only update (name/description/kind); org owner/admin
-only. The repository id is stable, so a rename is a one-row DB update
-— no Gitea write. Omitted fields are left unchanged.
+only. The repository id is stable, so a rename touches no contents.
+Omitted fields are left unchanged.
 
 \`kind\` is the ONE way a repository's kind changes after creation (the
 protocol planes never change it): it types a legacy \`kind: null\`
 repository and corrects a wrong kind. \`repo\`, \`model\` and \`dataset\`
 convert freely and any repository may become \`image\`; a repository
 whose container images are still named by a tag can be given no
-other kind — leaving \`image\`, or typing a legacy \`null\` row as
+other kind — leaving \`image\`, or typing a legacy \`null\` repository as
 anything else, is refused with \`409 kind_has_content\` (list and
 delete the tags through this API first). A switch away from \`image\`
 collects every image no tag reaches before it is judged, so an image

package/src/models/components/repo.ts

@@ -22,7 +22,7 @@ export type Repo = {
    * (the API, `git push`, the HF client, the OCI registry). It is the
    * same id the platform session and mk-authentication's members
    * directory use, so a name is one directory lookup away. `null`
-   * for a row that records no user id; never an empty string.
+   * for a repository that records no user id; never an empty string.
    */
   creator: string | null;
   description: string;

package/src/react-query/reposCreate.ts

@@ -50,11 +50,11 @@ export type ReposCreateMutationError =
  * Create a repository
  *
  * @remarks
- * Provisions a repository (org owner/admin only): DB insert
- * (authoritative) → Gitea create (rolled back on failure). The repository
- * belongs to the caller's org. `kind` says what it will hold and defaults
- * to `repo` (a plain git repository); it decides which protocol planes
- * answer for the name (see the `Repo` schema).
+ * Provisions a repository (org owner/admin only); a failed provision is
+ * rolled back best-effort (see the `502`). The repository belongs to the
+ * caller's org. `kind` says what it will hold and defaults to `repo` (a
+ * plain git repository); it decides which protocol planes answer for the
+ * name (see the `Repo` schema).
  */
 export function useReposCreateMutation(
   options?: MutationHookOptions<

package/src/react-query/reposDelete.ts

@@ -49,8 +49,8 @@ export type ReposDeleteMutationError =
  * Delete a repository
  *
  * @remarks
- * Removes a repository; org owner/admin only. The DB delete is
- * authoritative; the Gitea teardown is best-effort cleanup.
+ * Removes a repository; org owner/admin only. The deletion is
+ * authoritative; the contents are cleaned up best-effort.
  */
 export function useReposDeleteMutation(
   options?: MutationHookOptions<

package/src/react-query/reposList.ts

@@ -58,7 +58,7 @@ export type ReposListQueryError =
  *
  * @remarks
  * Returns every repository in the caller's org (org owner/admin only).
- * Pure DB read. With `kind`, only repositories of that kind; an untyped
+ * Read-only. With `kind`, only repositories of that kind; an untyped
  * (legacy, `kind: null`) repository appears in the unfiltered listing
  * only.
  */
@@ -82,7 +82,7 @@ export function useReposList(
  *
  * @remarks
  * Returns every repository in the caller's org (org owner/admin only).
- * Pure DB read. With `kind`, only repositories of that kind; an untyped
+ * Read-only. With `kind`, only repositories of that kind; an untyped
  * (legacy, `kind: null`) repository appears in the unfiltered listing
  * only.
  */

package/src/react-query/reposUpdate.ts

@@ -51,15 +51,15 @@ export type ReposUpdateMutationError =
  *
  * @remarks
  * Applies a label-only update (name/description/kind); org owner/admin
- * only. The repository id is stable, so a rename is a one-row DB update
- * — no Gitea write. Omitted fields are left unchanged.
+ * only. The repository id is stable, so a rename touches no contents.
+ * Omitted fields are left unchanged.
  *
  * `kind` is the ONE way a repository's kind changes after creation (the
  * protocol planes never change it): it types a legacy `kind: null`
  * repository and corrects a wrong kind. `repo`, `model` and `dataset`
  * convert freely and any repository may become `image`; a repository
  * whose container images are still named by a tag can be given no
- * other kind — leaving `image`, or typing a legacy `null` row as
+ * other kind — leaving `image`, or typing a legacy `null` repository as
  * anything else, is refused with `409 kind_has_content` (list and
  * delete the tags through this API first). A switch away from `image`
  * collects every image no tag reaches before it is judged, so an image