Function createCommands

packages/admin-cli/src/commandDefinitions.ts:131–2224

(yargs: Argv)

}

export function createCommands(yargs: Argv): Argv {
  return yargs
    .command(
      "bootstrap",
      "Initialize the dittofeed application and creates a workspace.",
      boostrapOptions,
      bootstrapHandler,
    )
    .command(
      "refresh-not-exists-segment-definition-updated-at",
      "Refreshes definitionUpdatedAt for segments that contain Trait NotExists nodes to force recomputation.",
      (y) => y,
      async () => {
        await refreshNotExistsSegmentDefinitionUpdatedAt();
      },
    )
    .command(
      "print-transfer-computed-property-state-v2-v3-query",
      "Prints the ClickHouse query used to copy computed_property_state_v2 rows into computed_property_state_v3.",
      (cmd) =>
        cmd
          .option("state-exclude-workspace-id", {
            type: "string",
            describe:
              "Workspace ID to exclude from the state transfer (repeatable).",
            array: true,
          })
          .option("state-limit", {
            type: "number",
            describe:
              "Maximum number of distinct workspaces to include per state transfer batch (default 64).",
            default: 64,
          })
          .option("state-offset", {
            type: "number",
            describe:
              "Number of distinct workspaces to skip before selecting the state transfer batch (default 0).",
            default: 0,
          }),
      ({ stateExcludeWorkspaceId, stateLimit, stateOffset }) => {
        let excludeWorkspaceIds: string[] | undefined;
        if (Array.isArray(stateExcludeWorkspaceId)) {
          excludeWorkspaceIds = stateExcludeWorkspaceId.filter(
            (id): id is string => typeof id === "string" && id.length > 0,
          );
        }

        const parsedStateLimit = parseIntStrict(String(stateLimit));
        if (parsedStateLimit <= 0) {
          throw new Error("state-limit must be a positive number");
        }

        const parsedStateOffset = parseIntStrict(String(stateOffset));
        if (parsedStateOffset < 0) {
          throw new Error("state-offset must be a non-negative number");
        }

        logger().info(