@tailor-platform/sdk 1.71.0 → 1.73.0

package/dist/cli/shared/config-loader.d.mts

@@ -0,0 +1,44 @@
+import { Plugin } from "../../plugin/types.mjs";
+import { AppConfig } from "../../configure/config/types.mjs";
+import { z } from "zod";
+
+//#region src/cli/shared/config-loader.d.ts
+/**
+ * Loaded configuration with resolved path
+ */
+type LoadedConfig = AppConfig & {
+  path: string;
+};
+interface LoadConfigOptions {
+  /** Import cache-busting value for watch-mode reloads. */
+  importNonce?: string;
+}
+declare const GeneratorConfigSchema: z.core.$ZodBranded<z.ZodObject<{
+  id: z.ZodString;
+  description: z.ZodString;
+  dependencies: z.ZodArray<z.ZodEnum<{
+    executor: "executor";
+    tailordb: "tailordb";
+    resolver: "resolver";
+  }>>;
+  processType: z.ZodOptional<z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>>;
+  processResolver: z.ZodOptional<z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>>;
+  processExecutor: z.ZodOptional<z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>>;
+  processTailorDBNamespace: z.ZodOptional<z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>>;
+  processResolverNamespace: z.ZodOptional<z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>>;
+  aggregate: z.ZodFunction<z.core.$ZodFunctionArgs, z.ZodAny>;
+}, z.core.$strip>, "CodeGenerator", "out">;
+type Generator = z.output<typeof GeneratorConfigSchema>;
+/**
+ * Load Tailor configuration file and associated generators and plugins.
+ * @param configPath - Optional explicit config path
+ * @param options - Optional module import behavior.
+ * @returns Loaded config, generators, plugins, and config path
+ */
+declare function loadConfig(configPath?: string, options?: LoadConfigOptions): Promise<{
+  config: LoadedConfig;
+  generators: Generator[];
+  plugins: Plugin[];
+}>;
+//#endregion
+export { Generator, LoadConfigOptions, LoadedConfig, loadConfig };

package/dist/cli/shared/context.d.mts

@@ -0,0 +1,28 @@
+import { z } from "zod";
+
+//#region src/cli/shared/context.d.ts
+type LoadWorkspaceIdOptions = {
+  workspaceId?: string;
+  profile?: string;
+};
+type LoadAccessTokenOptions = {
+  profile?: string;
+};
+/**
+ * Load workspace ID from command options, environment variables, or platform config.
+ * In CLI context, env fallback is also handled by politty's arg env option.
+ * Priority: opts/workspaceId > env/workspaceId > opts/profile > error
+ * @param opts - Workspace and profile options
+ * @returns Resolved workspace ID
+ */
+declare function loadWorkspaceId(opts?: LoadWorkspaceIdOptions): Promise<string>;
+/**
+ * Load access token from environment variables, command options, or platform config.
+ * In CLI context, profile env fallback is also handled by politty's arg env option.
+ * Priority: env/TAILOR_PLATFORM_TOKEN > env/TAILOR_TOKEN (deprecated) > opts/profile > env/profile > config/currentUser > error
+ * @param opts - Profile options
+ * @returns Resolved access token
+ */
+declare function loadAccessToken(opts?: LoadAccessTokenOptions): Promise<string>;
+//#endregion
+export { loadAccessToken, loadWorkspaceId };

package/dist/cli/shared/script-executor.d.mts

@@ -0,0 +1,74 @@
+import { AuthInvoker } from "../../tailor-proto/src/tailor/v1/auth_resource_pb.mjs";
+import { FunctionExecution_Status } from "../../tailor-proto/src/tailor/v1/function_resource_pb.mjs";
+import { OperatorClient } from "./client.mjs";
+
+//#region src/cli/shared/script-executor.d.ts
+/**
+ * Options for script execution
+ */
+interface ScriptExecutionOptions {
+  /** Operator client instance */
+  client: OperatorClient;
+  /** Workspace ID */
+  workspaceId: string;
+  /** Script name (for identification) */
+  name: string;
+  /** Bundled script code to execute */
+  code: string;
+  /** Optional JSON string argument to pass to the script */
+  arg?: string;
+  /** Auth invoker for script execution */
+  invoker: AuthInvoker;
+  /** Polling interval in milliseconds (default: 1000ms) */
+  pollInterval?: number;
+}
+/**
+ * Result of script execution
+ */
+interface ScriptExecutionResult {
+  /** Whether the script executed successfully */
+  success: boolean;
+  /** Logs output from the script execution */
+  logs: string;
+  /** Result value from the script execution */
+  result: string;
+  /** Error message if execution failed */
+  error?: string;
+}
+/**
+ * Result from waiting for execution completion
+ */
+interface ExecutionWaitResult {
+  /** Execution status */
+  status: FunctionExecution_Status;
+  /** Logs output from the execution */
+  logs: string;
+  /** Result value from the execution */
+  result: string;
+}
+/**
+ * Wait for a function execution to complete
+ *
+ * Polls the getFunctionExecution API until the execution reaches a terminal state
+ * (SUCCESS or FAILED).
+ * @param {OperatorClient} client - Operator client instance
+ * @param {string} workspaceId - Workspace ID
+ * @param {string} executionId - Execution ID to wait for
+ * @param {number} [pollInterval] - Polling interval in milliseconds (default: 1000ms)
+ * @returns {Promise<ExecutionWaitResult>} Execution result
+ * @throws {Error} If execution is not found
+ */
+declare function waitForExecution(client: OperatorClient, workspaceId: string, executionId: string, pollInterval?: number): Promise<ExecutionWaitResult>;
+/**
+ * Execute a script via TestExecScript API and wait for completion
+ *
+ * This function:
+ * 1. Calls testExecScript API to start execution
+ * 2. Polls getFunctionExecution until completion
+ * 3. Returns structured result with success/failure status
+ * @param {ScriptExecutionOptions} options - Execution options
+ * @returns {Promise<ScriptExecutionResult>} Execution result
+ */
+declare function executeScript(options: ScriptExecutionOptions): Promise<ScriptExecutionResult>;
+//#endregion
+export { ExecutionWaitResult, ScriptExecutionOptions, ScriptExecutionResult, executeScript, waitForExecution };

package/dist/cli/shared/seed-chunker.d.mts

@@ -0,0 +1,46 @@
+//#region src/cli/shared/seed-chunker.d.ts
+/**
+ * Seed data chunker for splitting large seed data into manageable message sizes.
+ *
+ * When seed data exceeds the gRPC message size limit, this module splits the data
+ * into multiple chunks at type boundaries (or record boundaries for large types).
+ */
+/**
+ * Seed data keyed by type name, with an array of records per type.
+ */
+type SeedData = Record<string, Record<string, unknown>[]>;
+/**
+ * A single chunk of seed data with metadata for ordered execution.
+ */
+type SeedChunk = {
+  data: SeedData;
+  order: string[];
+  index: number;
+  total: number;
+};
+/**
+ * Options for chunking seed data.
+ */
+type ChunkSeedDataOptions = {
+  /** Seed data keyed by type name */data: SeedData; /** Ordered list of type names (dependency order) */
+  order: string[]; /** Byte size of the bundled seed script code */
+  codeByteSize: number; /** Maximum gRPC message size in bytes (default: 3.5MB) */
+  maxMessageSize?: number;
+};
+/**
+ * Split seed data into chunks that fit within the gRPC message size limit.
+ *
+ * Algorithm:
+ * 1. Calculate the available budget for the arg field (maxMessageSize - codeByteSize - overhead)
+ * 2. If all data fits in one message, return a single chunk
+ * 3. Otherwise, iterate through types in dependency order:
+ *    - If a type fits in the current chunk, add it
+ *    - If adding a type would exceed the budget, finalize the current chunk and start a new one
+ *    - If a single type exceeds the budget, split its records across multiple chunks
+ *    - If a single record exceeds the budget, throw an error
+ * @param options - Chunking options
+ * @returns Array of seed chunks
+ */
+declare function chunkSeedData(options: ChunkSeedDataOptions): SeedChunk[];
+//#endregion
+export { ChunkSeedDataOptions, SeedChunk, SeedData, chunkSeedData };

package/dist/cli/shared/trigger-context.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/cli/shared/type-generator.d.mts

@@ -0,0 +1,20 @@
+import { AppConfig } from "../../configure/config/types.mjs";
+
+//#region src/cli/shared/type-generator.d.ts
+/**
+ * Options for generating user type definitions
+ */
+interface GenerateUserTypesOptions {
+  /** Application config */
+  config: AppConfig;
+  /** Path to Tailor config file */
+  configPath: string;
+}
+/**
+ * Generate user type definitions from the app config and write them to disk.
+ * @param options - Generation options
+ * @returns Promise that resolves when types are generated
+ */
+declare function generateUserTypes(options: GenerateUserTypesOptions): Promise<void>;
+//#endregion
+export { generateUserTypes };

package/dist/cli/skills.mjs

@@ -1,6 +1,5 @@
 #!/usr/bin/env node
-
-import { n as logger } from "../logger-DKF-JsAK.mjs";
+import { n as logger } from "../logger-BEiZZ3qT.mjs";
 import { dirname, resolve } from "pathe";
 import { fileURLToPath } from "node:url";
 import { spawn } from "node:child_process";

package/dist/cli/skills.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"skills.mjs","names":[],"sources":["../../src/cli/skills.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { spawn } from \"node:child_process\";\nimport { fileURLToPath } from \"node:url\";\nimport { dirname, resolve } from \"pathe\";\nimport { logger } from \"./shared/logger\";\n\nlogger.warn(\n  \"`tailor-sdk-skills` is deprecated and will be removed in v2. Use `tailor-sdk skills install` instead.\",\n);\n\nconst here = dirname(fileURLToPath(import.meta.url));\nconst mainCli = resolve(here, \"index.mjs\");\n\nconst child = spawn(process.execPath, [mainCli, \"skills\", \"install\", ...process.argv.slice(2)], {\n  stdio: \"inherit\",\n});\n\nchild.on(\"exit\", (code) => {\n  process.exit(code ?? 1);\n});\n"],"mappings":";;;;;;;;AAOA,OAAO,KACL,uGACF;AAGA,MAAM,UAAU,QADH,QAAQ,cAAc,OAAO,KAAK,GAAG,CACvB,GAAG,WAAW;AAE3B,MAAM,QAAQ,UAAU;CAAC;CAAS;CAAU;CAAW,GAAG,QAAQ,KAAK,MAAM,CAAC;AAAC,GAAG,EAC9F,OAAO,UACT,CAEI,CAAC,CAAC,GAAG,SAAS,SAAS;CACzB,QAAQ,KAAK,QAAQ,CAAC;AACxB,CAAC"}
+{"version":3,"file":"skills.mjs","names":[],"sources":["../../src/cli/skills.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { spawn } from \"node:child_process\";\nimport { fileURLToPath } from \"node:url\";\nimport { dirname, resolve } from \"pathe\";\nimport { logger } from \"./shared/logger\";\n\nlogger.warn(\n  \"`tailor-sdk-skills` is deprecated and will be removed in v2. Use `tailor-sdk skills install` instead.\",\n);\n\nconst here = dirname(fileURLToPath(import.meta.url));\nconst mainCli = resolve(here, \"index.mjs\");\n\nconst child = spawn(process.execPath, [mainCli, \"skills\", \"install\", ...process.argv.slice(2)], {\n  stdio: \"inherit\",\n});\n\nchild.on(\"exit\", (code) => {\n  process.exit(code ?? 1);\n});\n"],"mappings":";;;;;;;AAOA,OAAO,KACL,uGACF;AAGA,MAAM,UAAU,QADH,QAAQ,cAAc,OAAO,KAAK,GAAG,CACvB,GAAG,WAAW;AAE3B,MAAM,QAAQ,UAAU;CAAC;CAAS;CAAU;CAAW,GAAG,QAAQ,KAAK,MAAM,CAAC;AAAC,GAAG,EAC9F,OAAO,UACT,CAEI,CAAC,CAAC,GAAG,SAAS,SAAS;CACzB,QAAQ,KAAK,QAAQ,CAAC;AACxB,CAAC"}

package/dist/completion/zsh-worker.zsh

@@ -1,5 +1,5 @@
 # politty-completion-version: 1
-# politty-bin-sig: 1782903555
+# politty-bin-sig: 1782971080
 # politty-bin-path: /home/runner/work/sdk/sdk/node_modules/.bin/tailor-sdk
 # program: tailor-sdk
 # shell: zsh
@@ -686,12 +686,27 @@ __tailor_sdk_worker_opt_takes_value() {
         secret:delete:--profile|secret:delete:-p|secret:delete:--p) return 0 ;;
         secret:delete:--vault-name|secret:delete:--vaultName|secret:delete:-V|secret:delete:--V) return 0 ;;
         secret:delete:--name|secret:delete:-n|secret:delete:--n) return 0 ;;
-        setup:--provider|setup:-p|setup:--p) return 0 ;;
-        setup:--workspace-name|setup:--workspaceName|setup:-n|setup:--n) return 0 ;;
-        setup:--branch) return 0 ;;
-        setup:--tag-pattern|setup:--tagPattern) return 0 ;;
-        setup:--environment) return 0 ;;
-        setup:--dir|setup:-d|setup:--d) return 0 ;;
+        setup:branch:--name|setup:branch:-n|setup:branch:--n) return 0 ;;
+        setup:branch:--branch) return 0 ;;
+        setup:branch:--environment) return 0 ;;
+        setup:branch:--dir|setup:branch:-d|setup:branch:--d) return 0 ;;
+        setup:tag:--name|setup:tag:-n|setup:tag:--n) return 0 ;;
+        setup:tag:--tag-pattern|setup:tag:--tagPattern) return 0 ;;
+        setup:tag:--branch) return 0 ;;
+        setup:tag:--environment) return 0 ;;
+        setup:tag:--dir|setup:tag:-d|setup:tag:--d) return 0 ;;
+        setup:preview:--name|setup:preview:-n|setup:preview:--n) return 0 ;;
+        setup:preview:--branch) return 0 ;;
+        setup:preview:--region) return 0 ;;
+        setup:preview:--environment) return 0 ;;
+        setup:preview:--dir|setup:preview:-d|setup:preview:--d) return 0 ;;
+        setup:action:--name|setup:action:-n|setup:action:--n) return 0 ;;
+        setup:action:--dir|setup:action:-d|setup:action:--d) return 0 ;;
+        setup:action:--environment) return 0 ;;
+        setup:coordinate:--name|setup:coordinate:-n|setup:coordinate:--n) return 0 ;;
+        setup:coordinate:--action) return 0 ;;
+        setup:coordinate:--branch) return 0 ;;
+        setup:coordinate:--environment) return 0 ;;
         show:--workspace-id|show:--workspaceId|show:-w|show:--w) return 0 ;;
         show:--profile|show:-p|show:--p) return 0 ;;
         show:--config|show:-c|show:--c) return 0 ;;
@@ -912,6 +927,11 @@ __tailor_sdk_worker_is_subcmd() {
         secret:list) return 0 ;;
         secret:delete) return 0 ;;
         :secret) return 0 ;;
+        setup:branch) return 0 ;;
+        setup:tag) return 0 ;;
+        setup:preview) return 0 ;;
+        setup:action) return 0 ;;
+        setup:coordinate) return 0 ;;
         setup:check) return 0 ;;
         :setup) return 0 ;;
         :show) return 0 ;;
@@ -2524,12 +2544,102 @@ __tailor_sdk_worker_complete_secret() {
     __tailor_sdk_worker_cdescribe 'subcommands' _subs
 }
 
+__tailor_sdk_worker_complete_setup_branch() {
+    local -a _vals=()
+    if __tailor_sdk_worker_opt_takes_value "setup:branch" "${words[CURRENT-1]}"; then return 0; fi
+    if (( _after_dd )); then return 0; fi
+    if [[ "${words[CURRENT]}" == -* ]]; then
+        local -a _opts=()
+        __tailor_sdk_worker_not_used "--name" "-n" "--n" && _opts+=("--name:Name (defaults to the config 'name')")
+        __tailor_sdk_worker_not_used "--branch" && _opts+=("--branch:Deploy trigger branch (defaults to the detected default branch)")
+        __tailor_sdk_worker_not_used "--environment" && _opts+=("--environment:GitHub Environment for the plan/deploy jobs (defaults to the workspace name)")
+        __tailor_sdk_worker_not_used "--erd-preview" "--erdPreview" && _opts+=("--erd-preview:Add PR ERD viewer artifacts with current/diff previews for TailorDB namespaces")
+        __tailor_sdk_worker_not_used "--dir" "-d" "--d" && _opts+=("--dir:App directory (for monorepo setups)")
+        __tailor_sdk_worker_not_used "--force" && _opts+=("--force:Discard hand edits / take over unmanaged files and regenerate")
+        __tailor_sdk_worker_not_used "--help" && _opts+=("--help:Show help")
+        __tailor_sdk_worker_cdescribe 'options' _opts
+        return 0
+    fi
+}
+
+__tailor_sdk_worker_complete_setup_tag() {
+    local -a _vals=()
+    if __tailor_sdk_worker_opt_takes_value "setup:tag" "${words[CURRENT-1]}"; then return 0; fi
+    if (( _after_dd )); then return 0; fi
+    if [[ "${words[CURRENT]}" == -* ]]; then
+        local -a _opts=()
+        __tailor_sdk_worker_not_used "--name" "-n" "--n" && _opts+=("--name:Name (defaults to the config 'name')")
+        __tailor_sdk_worker_not_used "--tag-pattern" "--tagPattern" && _opts+=("--tag-pattern:Tag glob to match (defaults to v*)")
+        __tailor_sdk_worker_not_used "--branch" && _opts+=("--branch:Tag-reachability guard branch (no guard when omitted)")
+        __tailor_sdk_worker_not_used "--environment" && _opts+=("--environment:GitHub Environment for the plan/deploy jobs (defaults to the workspace name)")
+        __tailor_sdk_worker_not_used "--dir" "-d" "--d" && _opts+=("--dir:App directory (for monorepo setups)")
+        __tailor_sdk_worker_not_used "--force" && _opts+=("--force:Discard hand edits / take over unmanaged files and regenerate")
+        __tailor_sdk_worker_not_used "--help" && _opts+=("--help:Show help")
+        __tailor_sdk_worker_cdescribe 'options' _opts
+        return 0
+    fi
+}
+
+__tailor_sdk_worker_complete_setup_preview() {
+    local -a _vals=()
+    if __tailor_sdk_worker_opt_takes_value "setup:preview" "${words[CURRENT-1]}"; then return 0; fi
+    if (( _after_dd )); then return 0; fi
+    if [[ "${words[CURRENT]}" == -* ]]; then
+        local -a _opts=()
+        __tailor_sdk_worker_not_used "--name" "-n" "--n" && _opts+=("--name:Name (defaults to the config 'name')")
+        __tailor_sdk_worker_not_used "--branch" && _opts+=("--branch:Branch to filter PRs by (defaults to the detected default branch)")
+        __tailor_sdk_worker_not_used "--region" && _opts+=("--region:Workspace region for preview workspace creation (e.g. us-west). Required.")
+        __tailor_sdk_worker_not_used "--require-preview-label" "--requirePreviewLabel" && _opts+=("--require-preview-label:Deploy preview only for PRs labeled \`tailor\:preview\` instead of all PRs.")
+        __tailor_sdk_worker_not_used "--environment" && _opts+=("--environment:GitHub Environment for the preview jobs (defaults to the workspace name)")
+        __tailor_sdk_worker_not_used "--dir" "-d" "--d" && _opts+=("--dir:App directory (for monorepo setups)")
+        __tailor_sdk_worker_not_used "--force" && _opts+=("--force:Discard hand edits / take over unmanaged files and regenerate")
+        __tailor_sdk_worker_not_used "--help" && _opts+=("--help:Show help")
+        __tailor_sdk_worker_cdescribe 'options' _opts
+        return 0
+    fi
+}
+
+__tailor_sdk_worker_complete_setup_action() {
+    local -a _vals=()
+    if __tailor_sdk_worker_opt_takes_value "setup:action" "${words[CURRENT-1]}"; then return 0; fi
+    if (( _after_dd )); then return 0; fi
+    if [[ "${words[CURRENT]}" == -* ]]; then
+        local -a _opts=()
+        __tailor_sdk_worker_not_used "--name" "-n" "--n" && _opts+=("--name:Name (defaults to the config 'name')")
+        __tailor_sdk_worker_not_used "--dir" "-d" "--d" && _opts+=("--dir:App directory")
+        __tailor_sdk_worker_not_used "--environment" && _opts+=("--environment:GitHub Environment (defaults to the workspace name)")
+        __tailor_sdk_worker_not_used "--force" && _opts+=("--force:Discard hand edits and regenerate")
+        __tailor_sdk_worker_not_used "--help" && _opts+=("--help:Show help")
+        __tailor_sdk_worker_cdescribe 'options' _opts
+        return 0
+    fi
+}
+
+__tailor_sdk_worker_complete_setup_coordinate() {
+    local -a _vals=()
+    if __tailor_sdk_worker_opt_takes_value "setup:coordinate" "${words[CURRENT-1]}"; then return 0; fi
+    if (( _after_dd )); then return 0; fi
+    if [[ "${words[CURRENT]}" == -* ]]; then
+        local -a _opts=()
+        __tailor_sdk_worker_not_used "--name" "-n" "--n" && _opts+=("--name:Coordinator name (used in the generated workflow file name and job names)")
+        _opts+=("--action:Composite action to include (can be specified multiple times). tailor- prefix optional.")
+        __tailor_sdk_worker_not_used "--branch" && _opts+=("--branch:Branch target\: deploy trigger branch (defaults to the detected default branch)")
+        __tailor_sdk_worker_not_used "--tag" && _opts+=("--tag:Generate a tag target coordinator")
+        __tailor_sdk_worker_not_used "--environment" && _opts+=("--environment:GitHub Environment for the plan/deploy jobs")
+        __tailor_sdk_worker_not_used "--force" && _opts+=("--force:Discard hand edits and regenerate")
+        __tailor_sdk_worker_not_used "--help" && _opts+=("--help:Show help")
+        __tailor_sdk_worker_cdescribe 'options' _opts
+        return 0
+    fi
+}
+
 __tailor_sdk_worker_complete_setup_check() {
     local -a _vals=()
     if __tailor_sdk_worker_opt_takes_value "setup:check" "${words[CURRENT-1]}"; then return 0; fi
     if (( _after_dd )); then return 0; fi
     if [[ "${words[CURRENT]}" == -* ]]; then
         local -a _opts=()
+        __tailor_sdk_worker_not_used "--ci" && _opts+=("--ci:Run in CI mode\: skip checks that are handled by the runtime (e.g. TAILOR_PLATFORM_WORKSPACE_ID).")
         __tailor_sdk_worker_not_used "--help" && _opts+=("--help:Show help")
         __tailor_sdk_worker_cdescribe 'options' _opts
         return 0
@@ -2538,31 +2648,15 @@ __tailor_sdk_worker_complete_setup_check() {
 
 __tailor_sdk_worker_complete_setup() {
     local -a _vals=()
-    case "${words[CURRENT-1]}" in
-            --provider|-p|--p)
-                _vals=("github")
-                __tailor_sdk_worker_cdescribe 'completions' _vals
-                return 0 ;;
-    esac
     if __tailor_sdk_worker_opt_takes_value "setup" "${words[CURRENT-1]}"; then return 0; fi
     if (( _after_dd )); then return 0; fi
     if [[ "${words[CURRENT]}" == -* ]]; then
         local -a _opts=()
-        __tailor_sdk_worker_not_used "--provider" "-p" "--p" && _opts+=("--provider:CI provider to generate for (only 'github' is supported)")
-        __tailor_sdk_worker_not_used "--workspace-name" "--workspaceName" "-n" "--n" && _opts+=("--workspace-name:Workspace name (defaults to the config 'name')")
-        __tailor_sdk_worker_not_used "--branch" && _opts+=("--branch:Branch target\: deploy trigger branch (defaults to the detected default branch). Tag target\: tag-reachability guard branch (no guard when omitted)")
-        __tailor_sdk_worker_not_used "--tag" && _opts+=("--tag:Generate a tag target (deploy on tag push)")
-        __tailor_sdk_worker_not_used "--tag-pattern" "--tagPattern" && _opts+=("--tag-pattern:Tag glob to match (requires --tag; defaults to v*)")
-        __tailor_sdk_worker_not_used "--environment" && _opts+=("--environment:GitHub Environment for the plan/deploy jobs (defaults to the workspace name)")
-        __tailor_sdk_worker_not_used "--no-plan" "--noPlan" && _opts+=("--no-plan:Disable the plan job for a branch target (cannot be combined with --tag)")
-        __tailor_sdk_worker_not_used "--erd-preview" "--erdPreview" && _opts+=("--erd-preview:Add PR ERD viewer artifacts with current/diff previews for TailorDB namespaces")
-        __tailor_sdk_worker_not_used "--dir" "-d" "--d" && _opts+=("--dir:App directory (for monorepo setups)")
-        __tailor_sdk_worker_not_used "--force" && _opts+=("--force:Discard hand edits / take over unmanaged files and regenerate")
         __tailor_sdk_worker_not_used "--help" && _opts+=("--help:Show help")
         __tailor_sdk_worker_cdescribe 'options' _opts
         return 0
     fi
-    local -a _subs=("check:Audit generated workflows for drift against the current config/repo (read-only).")
+    local -a _subs=("branch:Generate a branch-target deploy workflow (push to branch triggers deploy)." "tag:Generate a tag-target deploy workflow (tag push triggers deploy)." "preview:Generate a preview workflow (PR open/sync triggers deploy to a per-PR workspace)." "action:Generate a per-app composite action for use with setup coordinate (monorepo multi-app deploys)." "coordinate:Generate a coordinator workflow that orchestrates multiple --action-generated composite actions." "check:Audit generated workflows for drift against the current config/repo (read-only).")
     __tailor_sdk_worker_cdescribe 'subcommands' _subs
 }
 
@@ -4097,7 +4191,7 @@ __tailor_sdk_worker_complete_root() {
         __tailor_sdk_worker_not_used "--help" && _opts+=("--help:Show help")
         __tailor_sdk_worker_cdescribe 'options' _opts
     else
-        local -a _subs=("api:Call Tailor Platform API endpoints directly." "authconnection:Manage auth connections." "crashreport:Manage crash reports." "crash-report:Manage crash reports." "deploy:Deploy your application by applying the Tailor configuration." "apply:Deploy your application by applying the Tailor configuration." "executor:Manage executors" "function:Manage functions" "generate:Generate files using Tailor configuration." "init:Initialize a new project using create-sdk." "login:Login to Tailor Platform." "logout:Logout from Tailor Platform." "machineuser:Manage machine users in your Tailor Platform application." "oauth2client:Manage OAuth2 clients in your Tailor Platform application." "open:Open Tailor Platform Console." "organization:Manage Tailor Platform organizations." "profile:Manage workspace profiles (user + workspace combinations)." "query:Run SQL/GraphQL query." "remove:Remove all resources managed by the application from the workspace." "secret:Manage Secret Manager vaults and secrets." "setup:Generate a CI deploy workflow for your project. (beta)" "show:Show information about the deployed application." "skills:Manage Tailor SDK agent skills." "staticwebsite:Manage static websites in your workspace." "tailordb:Manage TailorDB tables and data." "upgrade:Run codemods to upgrade your project to a newer SDK version." "user:Manage Tailor Platform users." "workflow:Manage workflows and workflow executions." "workspace:Manage Tailor Platform workspaces." "completion:Generate shell completion script")
+        local -a _subs=("api:Call Tailor Platform API endpoints directly." "authconnection:Manage auth connections." "crashreport:Manage crash reports." "crash-report:Manage crash reports." "deploy:Deploy your application by applying the Tailor configuration." "apply:Deploy your application by applying the Tailor configuration." "executor:Manage executors" "function:Manage functions" "generate:Generate files using Tailor configuration." "init:Initialize a new project using create-sdk." "login:Login to Tailor Platform." "logout:Logout from Tailor Platform." "machineuser:Manage machine users in your Tailor Platform application." "oauth2client:Manage OAuth2 clients in your Tailor Platform application." "open:Open Tailor Platform Console." "organization:Manage Tailor Platform organizations." "profile:Manage workspace profiles (user + workspace combinations)." "query:Run SQL/GraphQL query." "remove:Remove all resources managed by the application from the workspace." "secret:Manage Secret Manager vaults and secrets." "setup:Generate CI deploy workflows for your project. (beta)" "show:Show information about the deployed application." "skills:Manage Tailor SDK agent skills." "staticwebsite:Manage static websites in your workspace." "tailordb:Manage TailorDB tables and data." "upgrade:Run codemods to upgrade your project to a newer SDK version." "user:Manage Tailor Platform users." "workflow:Manage workflows and workflow executions." "workspace:Manage Tailor Platform workspaces." "completion:Generate shell completion script")
         __tailor_sdk_worker_cdescribe 'subcommands' _subs
     fi
 }
@@ -4211,6 +4305,11 @@ _tailor_sdk_worker_completions() {
         secret:list) __tailor_sdk_worker_complete_secret_list ;;
         secret:delete) __tailor_sdk_worker_complete_secret_delete ;;
         secret) __tailor_sdk_worker_complete_secret ;;
+        setup:branch) __tailor_sdk_worker_complete_setup_branch ;;
+        setup:tag) __tailor_sdk_worker_complete_setup_tag ;;
+        setup:preview) __tailor_sdk_worker_complete_setup_preview ;;
+        setup:action) __tailor_sdk_worker_complete_setup_action ;;
+        setup:coordinate) __tailor_sdk_worker_complete_setup_coordinate ;;
         setup:check) __tailor_sdk_worker_complete_setup_check ;;
         setup) __tailor_sdk_worker_complete_setup ;;
         show) __tailor_sdk_worker_complete_show ;;

package/dist/configure/config/index.d.mts

@@ -0,0 +1,29 @@
+import { BaseGeneratorConfig } from "../../types/generator-config.generated.mjs";
+import { GeneratorConfig, Plugin } from "../../plugin/types.mjs";
+import { AppConfig } from "./types.mjs";
+
+//#region src/configure/config/index.d.ts
+/**
+ * Define a Tailor SDK application configuration with shallow exactness.
+ * @template Config
+ * @param config - Application configuration
+ * @returns The same configuration object
+ */
+declare function defineConfig<const Config extends AppConfig & Record<Exclude<keyof Config, keyof AppConfig>, never>>(config: Config): Config;
+/**
+ * Define generators to be used with the Tailor SDK.
+ * @deprecated Use definePlugins() with generation hooks (onTypeLoaded, generate, etc.) instead.
+ * @param configs - Generator configurations
+ * @returns Generator configurations as given
+ */
+declare function defineGenerators(...configs: GeneratorConfig[]): BaseGeneratorConfig[];
+/**
+ * Define plugins to be used with the Tailor SDK.
+ * Plugins can generate additional types, resolvers, and executors
+ * based on existing TailorDB types.
+ * @param configs - Plugin configurations
+ * @returns Plugin configurations as given
+ */
+declare function definePlugins(...configs: Plugin<any, any>[]): Plugin<any, any>[];
+//#endregion
+export { defineConfig, defineGenerators, definePlugins };

package/dist/configure/config/types.d.mts

@@ -0,0 +1,103 @@
+import { TailorDBServiceInput } from "../services/tailordb/types.mjs";
+import { AuthConfig } from "../services/auth/types.mjs";
+import { AIGatewayConfig } from "../services/aigateway/types.mjs";
+import { IdPConfig } from "../services/idp/types.mjs";
+import { SecretsConfig } from "../services/secrets/types.mjs";
+import { StaticWebsiteConfig } from "../services/staticwebsite/types.mjs";
+import { LogLevelEnum } from "../../types/app-config.generated.mjs";
+
+//#region src/configure/config/types.d.ts
+type LogLevel = LogLevelEnum;
+type LogLevelInput = LogLevel | (string & {});
+type ExecutorServiceConfig = {
+  files: string[];
+  ignores?: string[];
+};
+type ExecutorServiceInput = ExecutorServiceConfig;
+type HttpAdapterServiceInput = {
+  files: string[];
+  ignores?: string[];
+};
+type ResolverServiceConfig = {
+  files: string[];
+  ignores?: string[];
+};
+type ResolverExternalConfig = {
+  external: true;
+};
+type ResolverServiceInput = {
+  [namespace: string]: ResolverServiceConfig | ResolverExternalConfig;
+};
+type WorkflowServiceConfig = {
+  files: string[];
+  job_files?: string[];
+  ignores?: string[];
+  job_ignores?: string[];
+};
+type WorkflowServiceInput = WorkflowServiceConfig;
+/**
+ * Application configuration for `defineConfig()`.
+ *
+ * Key fields:
+ * - `name` (required): Application name
+ * - `cors`: Array of allowed origins, e.g. `["https://example.com"]`
+ * - `auth`: Single auth config object (not an array)
+ * - `idp`: Array of IdP configs, e.g. `[myIdp]`
+ * - `staticWebsites`: Array of static website configs, e.g. `[website]`
+ * - `aiGateways`: Array of AI Gateway configs, e.g. `[gateway]`
+ * - `db`, `resolver`, `executor`, `workflow`: Service configs with file globs
+ */
+interface AppConfig<Auth extends AuthConfig = AuthConfig, Idp extends IdPConfig[] = IdPConfig[], StaticWebsites extends StaticWebsiteConfig[] = StaticWebsiteConfig[], AIGateways extends AIGatewayConfig[] = AIGatewayConfig[], Env extends Record<string, string | number | boolean> = Record<string, string | number | boolean>> {
+  /** Application name (required). */
+  name: string;
+  /**
+   * Stable identifier used to track the application across renames.
+   * Managed by the SDK: auto-generated and written into `tailor.config.ts`
+   * on first `deploy`. Delete this field if you want the SDK to assign a
+   * new id on the next `deploy` — typical case: `tailor.config.ts` was
+   * copied from another project and the new application should not share
+   * the original's id. Existing resources are re-tagged with the new id;
+   * data is preserved.
+   */
+  id?: string;
+  /** Environment variables accessible via `context.env` in resolvers and via the second argument `{ env }` in workflow job bodies. */
+  env?: Env;
+  /** Allowed CORS origins. Must be an array of strings, e.g. `["https://example.com"]`. */
+  cors?: string[];
+  /** IP addresses allowed to access the application. */
+  allowedIpAddresses?: string[];
+  /** Disable GraphQL introspection in production. */
+  disableIntrospection?: boolean;
+  /** TailorDB service configuration with type definition files. */
+  db?: TailorDBServiceInput;
+  /** Resolver service configuration with resolver files. */
+  resolver?: ResolverServiceInput;
+  /** Identity Provider configurations. Must be an array, e.g. `[myIdp]`. */
+  idp?: Idp;
+  /** Auth configuration (single object, not an array). */
+  auth?: Auth;
+  /** Executor service configuration with executor files. */
+  executor?: ExecutorServiceInput;
+  /** Workflow service configuration with workflow files. */
+  workflow?: WorkflowServiceInput;
+  /** HTTP adapter service configuration with adapter files. */
+  httpAdapter?: HttpAdapterServiceInput;
+  /** Static website configurations. Must be an array, e.g. `[website]`. */
+  staticWebsites?: StaticWebsites;
+  /** AI Gateway configurations. Must be an array, e.g. `[gateway]`. */
+  aiGateways?: AIGateways;
+  /** Secret Manager vault configurations. Keys are vault names, values are records of secret names to values. */
+  secrets?: SecretsConfig;
+  /**
+   * Enable inline sourcemaps in bundled functions for better error stack traces.
+   * @default true
+   */
+  inlineSourcemap?: boolean;
+  /**
+   * Controls which `console.*` calls remain in bundled functions.
+   * @default "DEBUG"
+   */
+  logLevel?: LogLevelInput;
+}
+//#endregion
+export { AppConfig, ExecutorServiceConfig, ExecutorServiceInput, HttpAdapterServiceInput, LogLevel, LogLevelInput, ResolverExternalConfig, ResolverServiceConfig, ResolverServiceInput, WorkflowServiceConfig, WorkflowServiceInput };