Function runCreate

packages/computer/src/artifacts/cli.ts:104–214

(
  client: ArtifactClient,
  args: string[],
  remoteAdd: RemoteAddFn | undefined,
)

// `--force`, so a half-finished previous run has a clear recovery.

async function runCreate(
  client: ArtifactClient,
  args: string[],
  remoteAdd: RemoteAddFn | undefined,
): Promise<ArtifactsCLIResult> {
  const parsed = parseFlags(args, {
    scope: { kind: "value" },
    ttl: { kind: "value" },
    remote: { kind: "value" },
    "default-branch": { kind: "value" },
    description: { kind: "value" },
    force: { kind: "bool" },
  });
  if ("error" in parsed) return argvError("create", parsed.error);
  const name = parsed.positional[0];
  if (name === undefined) return argvError("create", "missing <name>");
  if (parsed.positional.length > 1) {
    return argvError("create", `unexpected argument '${parsed.positional[1]}'`);
  }

  // Scope defaults to write: the point of the shorthand is to set up a
  // remote you can push to. A read default would register an origin
  // that rejects the first push.
  let scope: ArtifactScope = "write";
  if (parsed.flags.scope !== undefined) {
    const s = parsed.flags.scope as string;
    if (s !== "read" && s !== "write") {
      return argvError("create", `--scope must be 'read' or 'write' (got '${s}')`);
    }
    scope = s;
  }

  let ttl: number | undefined;
  if (parsed.flags.ttl !== undefined) {
    try {
      ttl = parseDuration(parsed.flags.ttl as string);
    } catch (cause) {
      return argvError("create", cause instanceof Error ? cause.message : String(cause));
    }
  }

  const force = parsed.flags.force === true;
  const gitRemote = (parsed.flags.remote as string | undefined) ?? name;
  const description = parsed.flags.description as string | undefined;
  const setDefaultBranch = parsed.flags["default-branch"] as string | undefined;

  // Step 1: create the repo, or adopt an existing one under --force.
  // `get` and `create` return different shapes; only the fields the
  // shorthand reports are needed, and both carry those.
  let info: { name: string; remote: string; defaultBranch: string };
  try {
    const existing = await tryGet(client, name);
    if (existing !== undefined) {
      if (!force) {
        return fail(
          `artifacts create: repo '${name}' already exists; re-run with --force to reuse it and refresh the remote`,
        );
      }