@tailor-platform/sdk 1.17.0 → 1.18.0

package/dist/utils/test/index.d.mts

@@ -1,7 +1,7 @@
 /// <reference path="./../../user-defined.d.ts" />
-import { M as TailorDBType, st as TailorField } from "../../types-DzvazVmg.mjs";
-import "../../types-BeNtD-fA.mjs";
-import { G as WORKFLOW_TEST_ENV_KEY, n as output } from "../../index-qQXpN674.mjs";
+import { Ot as TailorField, s as TailorDBType } from "../../types-DdvTxFiD.mjs";
+import "../../types-Bhl_wAM2.mjs";
+import { G as WORKFLOW_TEST_ENV_KEY, K as WORKFLOW_TEST_USER_KEY, n as output } from "../../index-DP8EB9FK.mjs";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 
 //#region src/utils/test/index.d.ts
@@ -41,5 +41,5 @@ declare function createStandardSchema<T = Record<string, unknown>>(schemaType: T
   };
 };
 //#endregion
-export { WORKFLOW_TEST_ENV_KEY, createStandardSchema, createTailorDBHook, unauthenticatedTailorUser };
+export { WORKFLOW_TEST_ENV_KEY, WORKFLOW_TEST_USER_KEY, createStandardSchema, createTailorDBHook, unauthenticatedTailorUser };
 //# sourceMappingURL=index.d.mts.map

package/dist/utils/test/index.mjs

@@ -1,4 +1,5 @@
-import { t as WORKFLOW_TEST_ENV_KEY } from "../../job-CULA2Pvf.mjs";
+import { n as WORKFLOW_TEST_USER_KEY, t as WORKFLOW_TEST_ENV_KEY } from "../../job-2Q82qQ6N.mjs";
+import "../../brand-BZJCv6UY.mjs";
 
 //#region src/utils/test/index.ts
 /** Represents an unauthenticated user in the Tailor platform. */
@@ -62,5 +63,5 @@ function createStandardSchema(schemaType, hook) {
 }
 
 //#endregion
-export { WORKFLOW_TEST_ENV_KEY, createStandardSchema, createTailorDBHook, unauthenticatedTailorUser };
+export { WORKFLOW_TEST_ENV_KEY, WORKFLOW_TEST_USER_KEY, createStandardSchema, createTailorDBHook, unauthenticatedTailorUser };
 //# sourceMappingURL=index.mjs.map

package/dist/utils/test/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/utils/test/index.ts"],"sourcesContent":["import type { output, TailorUser } from \"@/configure\";\nimport type { TailorDBType } from \"@/configure/services/tailordb/schema\";\nimport type { TailorField } from \"@/configure/types/type\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\n\nexport { WORKFLOW_TEST_ENV_KEY } from \"@/configure/services/workflow/job\";\n\n/** Represents an unauthenticated user in the Tailor platform. */\nexport const unauthenticatedTailorUser = {\n  id: \"00000000-0000-0000-0000-000000000000\",\n  type: \"\",\n  workspaceId: \"00000000-0000-0000-0000-000000000000\",\n  attributes: null,\n  attributeList: [],\n} as const satisfies TailorUser;\n\n/**\n * Creates a hook function that processes TailorDB type fields\n * - Uses existing id from data if provided, otherwise generates UUID for id fields\n * - Recursively processes nested types\n * - Executes hooks.create for fields with create hooks\n * @template T - The output type of the hook function\n * @param type - TailorDB type definition\n * @returns A function that transforms input data according to field hooks\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function createTailorDBHook<T extends TailorDBType<any, any>>(type: T) {\n  return (data: unknown) => {\n    return Object.entries(type.fields).reduce(\n      (hooked, [key, value]) => {\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        const field = value as TailorField<any, any, any>;\n        if (key === \"id\") {\n          // Use existing id from data if provided, otherwise generate new UUID\n          const existingId =\n            data && typeof data === \"object\" ? (data as Record<string, unknown>)[key] : undefined;\n          hooked[key] = existingId ?? crypto.randomUUID();\n        } else if (field.type === \"nested\") {\n          // eslint-disable-next-line @typescript-eslint/no-explicit-any\n          hooked[key] = createTailorDBHook({ fields: field.fields } as any)(\n            (data as Record<string, unknown>)[key],\n          );\n        } else if (field.metadata.hooks?.create) {\n          hooked[key] = field.metadata.hooks.create({\n            value: (data as Record<string, unknown>)[key],\n            data: data,\n            user: unauthenticatedTailorUser,\n          });\n          if (hooked[key] instanceof Date) {\n            hooked[key] = hooked[key].toISOString();\n          }\n        } else if (data && typeof data === \"object\") {\n          hooked[key] = (data as Record<string, unknown>)[key];\n        }\n        return hooked;\n      },\n      {} as Record<string, unknown>,\n    ) as Partial<output<T>>;\n  };\n}\n\n/**\n * Creates the standard schema definition for lines-db\n * This returns the first argument for defineSchema with the ~standard section\n * @template T - The output type after validation\n * @param schemaType - TailorDB field schema for validation\n * @param hook - Hook function to transform data before validation\n * @returns Schema object with ~standard section for defineSchema\n */\nexport function createStandardSchema<T = Record<string, unknown>>(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  schemaType: TailorField<any, T>,\n  hook: (data: unknown) => Partial<T>,\n) {\n  return {\n    \"~standard\": {\n      version: 1,\n      vendor: \"@tailor-platform/sdk\",\n      validate: (value: unknown) => {\n        const hooked = hook(value);\n        const result = schemaType.parse({\n          value: hooked,\n          data: hooked,\n          user: unauthenticatedTailorUser,\n        });\n        if (result.issues) {\n          return result;\n        }\n        return { value: hooked as T };\n      },\n    },\n  } as const satisfies StandardSchemaV1<T>;\n}\n"],"mappings":";;;;AAQA,MAAa,4BAA4B;CACvC,IAAI;CACJ,MAAM;CACN,aAAa;CACb,YAAY;CACZ,eAAe,EAAE;CAClB;;;;;;;;;;AAYD,SAAgB,mBAAqD,MAAS;AAC5E,SAAQ,SAAkB;AACxB,SAAO,OAAO,QAAQ,KAAK,OAAO,CAAC,QAChC,QAAQ,CAAC,KAAK,WAAW;GAExB,MAAM,QAAQ;AACd,OAAI,QAAQ,KAIV,QAAO,QADL,QAAQ,OAAO,SAAS,WAAY,KAAiC,OAAO,WAClD,OAAO,YAAY;YACtC,MAAM,SAAS,SAExB,QAAO,OAAO,mBAAmB,EAAE,QAAQ,MAAM,QAAQ,CAAQ,CAC9D,KAAiC,KACnC;YACQ,MAAM,SAAS,OAAO,QAAQ;AACvC,WAAO,OAAO,MAAM,SAAS,MAAM,OAAO;KACxC,OAAQ,KAAiC;KACnC;KACN,MAAM;KACP,CAAC;AACF,QAAI,OAAO,gBAAgB,KACzB,QAAO,OAAO,OAAO,KAAK,aAAa;cAEhC,QAAQ,OAAO,SAAS,SACjC,QAAO,OAAQ,KAAiC;AAElD,UAAO;KAET,EAAE,CACH;;;;;;;;;;;AAYL,SAAgB,qBAEd,YACA,MACA;AACA,QAAO,EACL,aAAa;EACX,SAAS;EACT,QAAQ;EACR,WAAW,UAAmB;GAC5B,MAAM,SAAS,KAAK,MAAM;GAC1B,MAAM,SAAS,WAAW,MAAM;IAC9B,OAAO;IACP,MAAM;IACN,MAAM;IACP,CAAC;AACF,OAAI,OAAO,OACT,QAAO;AAET,UAAO,EAAE,OAAO,QAAa;;EAEhC,EACF"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/utils/test/index.ts"],"sourcesContent":["import type { output, TailorUser } from \"@/configure\";\nimport type { TailorDBType } from \"@/configure/services/tailordb/schema\";\nimport type { TailorField } from \"@/configure/types/type\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\n\nexport { WORKFLOW_TEST_ENV_KEY, WORKFLOW_TEST_USER_KEY } from \"@/configure/services/workflow/job\";\n\n/** Represents an unauthenticated user in the Tailor platform. */\nexport const unauthenticatedTailorUser = {\n  id: \"00000000-0000-0000-0000-000000000000\",\n  type: \"\",\n  workspaceId: \"00000000-0000-0000-0000-000000000000\",\n  attributes: null,\n  attributeList: [],\n} as const satisfies TailorUser;\n\n/**\n * Creates a hook function that processes TailorDB type fields\n * - Uses existing id from data if provided, otherwise generates UUID for id fields\n * - Recursively processes nested types\n * - Executes hooks.create for fields with create hooks\n * @template T - The output type of the hook function\n * @param type - TailorDB type definition\n * @returns A function that transforms input data according to field hooks\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function createTailorDBHook<T extends TailorDBType<any, any>>(type: T) {\n  return (data: unknown) => {\n    return Object.entries(type.fields).reduce(\n      (hooked, [key, value]) => {\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        const field = value as TailorField<any, any, any>;\n        if (key === \"id\") {\n          // Use existing id from data if provided, otherwise generate new UUID\n          const existingId =\n            data && typeof data === \"object\" ? (data as Record<string, unknown>)[key] : undefined;\n          hooked[key] = existingId ?? crypto.randomUUID();\n        } else if (field.type === \"nested\") {\n          // eslint-disable-next-line @typescript-eslint/no-explicit-any\n          hooked[key] = createTailorDBHook({ fields: field.fields } as any)(\n            (data as Record<string, unknown>)[key],\n          );\n        } else if (field.metadata.hooks?.create) {\n          hooked[key] = field.metadata.hooks.create({\n            value: (data as Record<string, unknown>)[key],\n            data: data,\n            user: unauthenticatedTailorUser,\n          });\n          if (hooked[key] instanceof Date) {\n            hooked[key] = hooked[key].toISOString();\n          }\n        } else if (data && typeof data === \"object\") {\n          hooked[key] = (data as Record<string, unknown>)[key];\n        }\n        return hooked;\n      },\n      {} as Record<string, unknown>,\n    ) as Partial<output<T>>;\n  };\n}\n\n/**\n * Creates the standard schema definition for lines-db\n * This returns the first argument for defineSchema with the ~standard section\n * @template T - The output type after validation\n * @param schemaType - TailorDB field schema for validation\n * @param hook - Hook function to transform data before validation\n * @returns Schema object with ~standard section for defineSchema\n */\nexport function createStandardSchema<T = Record<string, unknown>>(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  schemaType: TailorField<any, T>,\n  hook: (data: unknown) => Partial<T>,\n) {\n  return {\n    \"~standard\": {\n      version: 1,\n      vendor: \"@tailor-platform/sdk\",\n      validate: (value: unknown) => {\n        const hooked = hook(value);\n        const result = schemaType.parse({\n          value: hooked,\n          data: hooked,\n          user: unauthenticatedTailorUser,\n        });\n        if (result.issues) {\n          return result;\n        }\n        return { value: hooked as T };\n      },\n    },\n  } as const satisfies StandardSchemaV1<T>;\n}\n"],"mappings":";;;;;AAQA,MAAa,4BAA4B;CACvC,IAAI;CACJ,MAAM;CACN,aAAa;CACb,YAAY;CACZ,eAAe,EAAE;CAClB;;;;;;;;;;AAYD,SAAgB,mBAAqD,MAAS;AAC5E,SAAQ,SAAkB;AACxB,SAAO,OAAO,QAAQ,KAAK,OAAO,CAAC,QAChC,QAAQ,CAAC,KAAK,WAAW;GAExB,MAAM,QAAQ;AACd,OAAI,QAAQ,KAIV,QAAO,QADL,QAAQ,OAAO,SAAS,WAAY,KAAiC,OAAO,WAClD,OAAO,YAAY;YACtC,MAAM,SAAS,SAExB,QAAO,OAAO,mBAAmB,EAAE,QAAQ,MAAM,QAAQ,CAAQ,CAC9D,KAAiC,KACnC;YACQ,MAAM,SAAS,OAAO,QAAQ;AACvC,WAAO,OAAO,MAAM,SAAS,MAAM,OAAO;KACxC,OAAQ,KAAiC;KACnC;KACN,MAAM;KACP,CAAC;AACF,QAAI,OAAO,gBAAgB,KACzB,QAAO,OAAO,OAAO,KAAK,aAAa;cAEhC,QAAQ,OAAO,SAAS,SACjC,QAAO,OAAQ,KAAiC;AAElD,UAAO;KAET,EAAE,CACH;;;;;;;;;;;AAYL,SAAgB,qBAEd,YACA,MACA;AACA,QAAO,EACL,aAAa;EACX,SAAS;EACT,QAAQ;EACR,WAAW,UAAmB;GAC5B,MAAM,SAAS,KAAK,MAAM;GAC1B,MAAM,SAAS,WAAW,MAAM;IAC9B,OAAO;IACP,MAAM;IACN,MAAM;IACP,CAAC;AACF,OAAI,OAAO,OACT,QAAO;AAET,UAAO,EAAE,OAAO,QAAa;;EAEhC,EACF"}

package/docs/cli/application.md

@@ -2,44 +2,72 @@
 
 Commands for managing Tailor Platform applications. These commands work with `tailor.config.ts`.
 
-<!-- politty:command:init:start -->
+<!-- politty:command:init:heading:start -->
 
 ## init
 
+<!-- politty:command:init:heading:end -->
+
+<!-- politty:command:init:description:start -->
+
 Initialize a new project using create-sdk.
 
+<!-- politty:command:init:description:end -->
+
+<!-- politty:command:init:usage:start -->
+
 **Usage**
 
 ```
 tailor-sdk init [options] [name]
 ```
 
+<!-- politty:command:init:usage:end -->
+
+<!-- politty:command:init:arguments:start -->
+
 **Arguments**
 
 | Argument | Description  | Required |
 | -------- | ------------ | -------- |
 | `name`   | Project name | No       |
 
+<!-- politty:command:init:arguments:end -->
+
+<!-- politty:command:init:options:start -->
+
 **Options**
 
 | Option                  | Alias | Description   | Required | Default |
 | ----------------------- | ----- | ------------- | -------- | ------- |
 | `--template <TEMPLATE>` | `-t`  | Template name | No       | -       |
 
-<!-- politty:command:init:end -->
+<!-- politty:command:init:options:end -->
 
-<!-- politty:command:generate:start -->
+<!-- politty:command:generate:heading:start -->
 
 ## generate
 
+<!-- politty:command:generate:heading:end -->
+
+<!-- politty:command:generate:description:start -->
+
 Generate files using Tailor configuration.
 
+<!-- politty:command:generate:description:end -->
+
+<!-- politty:command:generate:usage:start -->
+
 **Usage**
 
 ```
 tailor-sdk generate [options]
 ```
 
+<!-- politty:command:generate:usage:end -->
+
+<!-- politty:command:generate:options:start -->
+
 **Options**
 
 | Option              | Alias | Description                                    | Required | Default              |
@@ -47,20 +75,32 @@ tailor-sdk generate [options]
 | `--config <CONFIG>` | `-c`  | Path to SDK config file                        | No       | `"tailor.config.ts"` |
 | `--watch`           | `-W`  | Watch for type/resolver changes and regenerate | No       | `false`              |
 
-<!-- politty:command:generate:end -->
+<!-- politty:command:generate:options:end -->
 
-<!-- politty:command:apply:start -->
+<!-- politty:command:apply:heading:start -->
 
 ## apply
 
+<!-- politty:command:apply:heading:end -->
+
+<!-- politty:command:apply:description:start -->
+
 Apply Tailor configuration to deploy your application.
 
+<!-- politty:command:apply:description:end -->
+
+<!-- politty:command:apply:usage:start -->
+
 **Usage**
 
 ```
 tailor-sdk apply [options]
 ```
 
+<!-- politty:command:apply:usage:end -->
+
+<!-- politty:command:apply:options:start -->
+
 **Options**
 
 | Option                          | Alias | Description                                        | Required | Default              |
@@ -72,7 +112,7 @@ tailor-sdk apply [options]
 | `--dry-run`                     | `-d`  | Run the command without making any changes         | No       | -                    |
 | `--no-schema-check`             | -     | Skip schema diff check against migration snapshots | No       | -                    |
 
-<!-- politty:command:apply:end -->
+<!-- politty:command:apply:options:end -->
 
 **Migration Handling:**
 
@@ -96,18 +136,30 @@ If remote schema drift is detected, the apply will fail with an error showing th
 
 Use `--no-schema-check` to skip both verifications (not recommended for production).
 
-<!-- politty:command:remove:start -->
+<!-- politty:command:remove:heading:start -->
 
 ## remove
 
+<!-- politty:command:remove:heading:end -->
+
+<!-- politty:command:remove:description:start -->
+
 Remove all resources managed by the application from the workspace.
 
+<!-- politty:command:remove:description:end -->
+
+<!-- politty:command:remove:usage:start -->
+
 **Usage**
 
 ```
 tailor-sdk remove [options]
 ```
 
+<!-- politty:command:remove:usage:end -->
+
+<!-- politty:command:remove:options:start -->
+
 **Options**
 
 | Option                          | Alias | Description               | Required | Default              |
@@ -117,20 +169,32 @@ tailor-sdk remove [options]
 | `--config <CONFIG>`             | `-c`  | Path to SDK config file   | No       | `"tailor.config.ts"` |
 | `--yes`                         | `-y`  | Skip confirmation prompts | No       | `false`              |
 
-<!-- politty:command:remove:end -->
+<!-- politty:command:remove:options:end -->
 
-<!-- politty:command:show:start -->
+<!-- politty:command:show:heading:start -->
 
 ## show
 
+<!-- politty:command:show:heading:end -->
+
+<!-- politty:command:show:description:start -->
+
 Show information about the deployed application.
 
+<!-- politty:command:show:description:end -->
+
+<!-- politty:command:show:usage:start -->
+
 **Usage**
 
 ```
 tailor-sdk show [options]
 ```
 
+<!-- politty:command:show:usage:end -->
+
+<!-- politty:command:show:options:start -->
+
 **Options**
 
 | Option                          | Alias | Description             | Required | Default              |
@@ -140,20 +204,32 @@ tailor-sdk show [options]
 | `--profile <PROFILE>`           | `-p`  | Workspace profile       | No       | -                    |
 | `--config <CONFIG>`             | `-c`  | Path to SDK config file | No       | `"tailor.config.ts"` |
 
-<!-- politty:command:show:end -->
+<!-- politty:command:show:options:end -->
 
-<!-- politty:command:open:start -->
+<!-- politty:command:open:heading:start -->
 
 ## open
 
+<!-- politty:command:open:heading:end -->
+
+<!-- politty:command:open:description:start -->
+
 Open Tailor Platform Console.
 
+<!-- politty:command:open:description:end -->
+
+<!-- politty:command:open:usage:start -->
+
 **Usage**
 
 ```
 tailor-sdk open [options]
 ```
 
+<!-- politty:command:open:usage:end -->
+
+<!-- politty:command:open:options:start -->
+
 **Options**
 
 | Option                          | Alias | Description             | Required | Default              |
@@ -162,26 +238,42 @@ tailor-sdk open [options]
 | `--profile <PROFILE>`           | `-p`  | Workspace profile       | No       | -                    |
 | `--config <CONFIG>`             | `-c`  | Path to SDK config file | No       | `"tailor.config.ts"` |
 
-<!-- politty:command:open:end -->
+<!-- politty:command:open:options:end -->
 
-<!-- politty:command:api:start -->
+<!-- politty:command:api:heading:start -->
 
 ## api
 
+<!-- politty:command:api:heading:end -->
+
+<!-- politty:command:api:description:start -->
+
 Call Tailor Platform API endpoints directly.
 
+<!-- politty:command:api:description:end -->
+
+<!-- politty:command:api:usage:start -->
+
 **Usage**
 
 ```
 tailor-sdk api [options] <endpoint>
 ```
 
+<!-- politty:command:api:usage:end -->
+
+<!-- politty:command:api:arguments:start -->
+
 **Arguments**
 
 | Argument   | Description                                                                                 | Required |
 | ---------- | ------------------------------------------------------------------------------------------- | -------- |
 | `endpoint` | API endpoint to call (e.g., 'GetApplication' or 'tailor.v1.OperatorService/GetApplication') | Yes      |
 
+<!-- politty:command:api:arguments:end -->
+
+<!-- politty:command:api:options:start -->
+
 **Options**
 
 | Option                          | Alias | Description          | Required | Default |
@@ -191,4 +283,4 @@ tailor-sdk api [options] <endpoint>
 | `--profile <PROFILE>`           | `-p`  | Workspace profile    | No       | -       |
 | `--body <BODY>`                 | `-b`  | Request body as JSON | No       | `"{}"`  |
 
-<!-- politty:command:api:end -->
+<!-- politty:command:api:options:end -->

package/docs/cli/auth.md

@@ -2,18 +2,30 @@
 
 Commands for managing Auth service resources (machine users and OAuth2 clients).
 
-<!-- politty:command:machineuser:start -->
+<!-- politty:command:machineuser:heading:start -->
 
 ## machineuser
 
+<!-- politty:command:machineuser:heading:end -->
+
+<!-- politty:command:machineuser:description:start -->
+
 Manage machine users in your Tailor Platform application.
 
+<!-- politty:command:machineuser:description:end -->
+
+<!-- politty:command:machineuser:usage:start -->
+
 **Usage**
 
 ```
 tailor-sdk machineuser [command]
 ```
 
+<!-- politty:command:machineuser:usage:end -->
+
+<!-- politty:command:machineuser:subcommands:start -->
+
 **Commands**
 
 | Command                                   | Description                                |
@@ -21,19 +33,31 @@ tailor-sdk machineuser [command]
 | [`machineuser list`](#machineuser-list)   | List all machine users in the application. |
 | [`machineuser token`](#machineuser-token) | Get an access token for a machine user.    |
 
-<!-- politty:command:machineuser:end -->
-<!-- politty:command:machineuser list:start -->
+<!-- politty:command:machineuser:subcommands:end -->
+<!-- politty:command:machineuser list:heading:start -->
 
 ### machineuser list
 
+<!-- politty:command:machineuser list:heading:end -->
+
+<!-- politty:command:machineuser list:description:start -->
+
 List all machine users in the application.
 
+<!-- politty:command:machineuser list:description:end -->
+
+<!-- politty:command:machineuser list:usage:start -->
+
 **Usage**
 
 ```
 tailor-sdk machineuser list [options]
 ```
 
+<!-- politty:command:machineuser list:usage:end -->
+
+<!-- politty:command:machineuser list:options:start -->
+
 **Options**
 
 | Option                          | Alias | Description             | Required | Default              |
@@ -43,25 +67,41 @@ tailor-sdk machineuser list [options]
 | `--profile <PROFILE>`           | `-p`  | Workspace profile       | No       | -                    |
 | `--config <CONFIG>`             | `-c`  | Path to SDK config file | No       | `"tailor.config.ts"` |
 
-<!-- politty:command:machineuser list:end -->
-<!-- politty:command:machineuser token:start -->
+<!-- politty:command:machineuser list:options:end -->
+<!-- politty:command:machineuser token:heading:start -->
 
 ### machineuser token
 
+<!-- politty:command:machineuser token:heading:end -->
+
+<!-- politty:command:machineuser token:description:start -->
+
 Get an access token for a machine user.
 
+<!-- politty:command:machineuser token:description:end -->
+
+<!-- politty:command:machineuser token:usage:start -->
+
 **Usage**
 
 ```
 tailor-sdk machineuser token [options] <name>
 ```
 
+<!-- politty:command:machineuser token:usage:end -->
+
+<!-- politty:command:machineuser token:arguments:start -->
+
 **Arguments**
 
 | Argument | Description       | Required |
 | -------- | ----------------- | -------- |
 | `name`   | Machine user name | Yes      |
 
+<!-- politty:command:machineuser token:arguments:end -->
+
+<!-- politty:command:machineuser token:options:start -->
+
 **Options**
 
 | Option                          | Alias | Description             | Required | Default              |
@@ -71,19 +111,31 @@ tailor-sdk machineuser token [options] <name>
 | `--profile <PROFILE>`           | `-p`  | Workspace profile       | No       | -                    |
 | `--config <CONFIG>`             | `-c`  | Path to SDK config file | No       | `"tailor.config.ts"` |
 
-<!-- politty:command:machineuser token:end -->
-<!-- politty:command:oauth2client:start -->
+<!-- politty:command:machineuser token:options:end -->
+<!-- politty:command:oauth2client:heading:start -->
 
 ## oauth2client
 
+<!-- politty:command:oauth2client:heading:end -->
+
+<!-- politty:command:oauth2client:description:start -->
+
 Manage OAuth2 clients in your Tailor Platform application.
 
+<!-- politty:command:oauth2client:description:end -->
+
+<!-- politty:command:oauth2client:usage:start -->
+
 **Usage**
 
 ```
 tailor-sdk oauth2client [command]
 ```
 
+<!-- politty:command:oauth2client:usage:end -->
+
+<!-- politty:command:oauth2client:subcommands:start -->
+
 **Commands**
 
 | Command                                   | Description                                              |
@@ -91,19 +143,31 @@ tailor-sdk oauth2client [command]
 | [`oauth2client get`](#oauth2client-get)   | Get OAuth2 client credentials (including client secret). |
 | [`oauth2client list`](#oauth2client-list) | List all OAuth2 clients in the application.              |
 
-<!-- politty:command:oauth2client:end -->
-<!-- politty:command:oauth2client list:start -->
+<!-- politty:command:oauth2client:subcommands:end -->
+<!-- politty:command:oauth2client list:heading:start -->
 
 ### oauth2client list
 
+<!-- politty:command:oauth2client list:heading:end -->
+
+<!-- politty:command:oauth2client list:description:start -->
+
 List all OAuth2 clients in the application.
 
+<!-- politty:command:oauth2client list:description:end -->
+
+<!-- politty:command:oauth2client list:usage:start -->
+
 **Usage**
 
 ```
 tailor-sdk oauth2client list [options]
 ```
 
+<!-- politty:command:oauth2client list:usage:end -->
+
+<!-- politty:command:oauth2client list:options:start -->
+
 **Options**
 
 | Option                          | Alias | Description             | Required | Default              |
@@ -113,25 +177,41 @@ tailor-sdk oauth2client list [options]
 | `--profile <PROFILE>`           | `-p`  | Workspace profile       | No       | -                    |
 | `--config <CONFIG>`             | `-c`  | Path to SDK config file | No       | `"tailor.config.ts"` |
 
-<!-- politty:command:oauth2client list:end -->
-<!-- politty:command:oauth2client get:start -->
+<!-- politty:command:oauth2client list:options:end -->
+<!-- politty:command:oauth2client get:heading:start -->
 
 ### oauth2client get
 
+<!-- politty:command:oauth2client get:heading:end -->
+
+<!-- politty:command:oauth2client get:description:start -->
+
 Get OAuth2 client credentials (including client secret).
 
+<!-- politty:command:oauth2client get:description:end -->
+
+<!-- politty:command:oauth2client get:usage:start -->
+
 **Usage**
 
 ```
 tailor-sdk oauth2client get [options] <name>
 ```
 
+<!-- politty:command:oauth2client get:usage:end -->
+
+<!-- politty:command:oauth2client get:arguments:start -->
+
 **Arguments**
 
 | Argument | Description        | Required |
 | -------- | ------------------ | -------- |
 | `name`   | OAuth2 client name | Yes      |
 
+<!-- politty:command:oauth2client get:arguments:end -->
+
+<!-- politty:command:oauth2client get:options:start -->
+
 **Options**
 
 | Option                          | Alias | Description             | Required | Default              |
@@ -141,7 +221,7 @@ tailor-sdk oauth2client get [options] <name>
 | `--profile <PROFILE>`           | `-p`  | Workspace profile       | No       | -                    |
 | `--config <CONFIG>`             | `-c`  | Path to SDK config file | No       | `"tailor.config.ts"` |
 
-<!-- politty:command:oauth2client get:end -->
+<!-- politty:command:oauth2client get:options:end -->
 
 **Output:**
 

package/docs/cli/completion.md

@@ -1,27 +1,43 @@
 # Completion
 
-<!-- politty:command:completion:start -->
+<!-- politty:command:completion:heading:start -->
 
 ## completion
 
+<!-- politty:command:completion:heading:end -->
+
+<!-- politty:command:completion:description:start -->
+
 Generate shell completion script
 
+<!-- politty:command:completion:description:end -->
+
+<!-- politty:command:completion:usage:start -->
+
 **Usage**
 
 ```
 tailor-sdk completion [options] [shell]
 ```
 
+<!-- politty:command:completion:usage:end -->
+
+<!-- politty:command:completion:arguments:start -->
+
 **Arguments**
 
 | Argument | Description                     | Required |
 | -------- | ------------------------------- | -------- |
 | `shell`  | Shell type (bash, zsh, or fish) | No       |
 
+<!-- politty:command:completion:arguments:end -->
+
+<!-- politty:command:completion:options:start -->
+
 **Options**
 
 | Option           | Alias | Description                    | Required | Default |
 | ---------------- | ----- | ------------------------------ | -------- | ------- |
 | `--instructions` | `-i`  | Show installation instructions | No       | `false` |
 
-<!-- politty:command:completion:end -->
+<!-- politty:command:completion:options:end -->