feat(blueprint): support blueprint create metadata (#141)

## Description

upport blueprint create metadata

**Note:** PR titles should follow [Conventional
Commits](https://www.conventionalcommits.org/) format (e.g.,
`feat(devbox): add support for custom env vars` or `fix(snapshot):
resolve pagination issue`) as they are used for automatic release notes
generation.

## Type of Change

<!-- Mark the relevant option with an 'x' -->

- [ ] Bug fix (non-breaking change which fixes an issue)
- [x] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to not work as expected)
- [ ] Documentation update
- [ ] Code refactoring
- [ ] Performance improvement
- [ ] Test updates

## Related Issues

<!-- Link to related issues using #issue-number -->
Closes #

## Changes Made

<!-- Describe the changes in detail -->

## Testing

<!-- Describe how you tested your changes -->

- [ ] I have tested locally
- [ ] I have added/updated tests
- [ ] All existing tests pass

## Checklist

- [ ] My code follows the code style of this project
- [ ] I have performed a self-review of my own code
- [ ] I have commented my code, particularly in hard-to-understand areas
- [ ] I have updated the documentation accordingly
- [ ] My changes generate no new warnings
- [ ] I have added tests that prove my fix is effective or that my
feature works
- [ ] New and existing unit tests pass locally with my changes
- [ ] Any dependent changes have been merged and published

## Screenshots (if applicable)

<!-- Add screenshots to help explain your changes -->

## Additional Notes

<!-- Any additional information that reviewers should know -->

Author: ross-rl

src/commands/blueprint/create.ts

@@ -16,9 +16,25 @@ interface CreateBlueprintOptions {
   availablePorts?: string[];
   root?: boolean;
   user?: string;
+  metadata?: string[];
   output?: string;
 }
 
+// Parse metadata from key=value format
+function parseMetadata(metadata: string[]): Record<string, string> {
+  const result: Record<string, string> = {};
+  for (const item of metadata) {
+    const eqIndex = item.indexOf("=");
+    if (eqIndex === -1) {
+      throw new Error(`Invalid metadata format: ${item}. Expected key=value`);
+    }
+    const key = item.substring(0, eqIndex);
+    const value = item.substring(eqIndex + 1);
+    result[key] = value;
+  }
+  return result;
+}
+
 export async function createBlueprint(options: CreateBlueprintOptions) {
   try {
     const client = getClient();
@@ -60,13 +76,19 @@ export async function createBlueprint(options: CreateBlueprintOptions) {
       launchParameters.user_parameters = userParameters;
     }
 
+    // Parse metadata if provided
+    const metadata = options.metadata
+      ? parseMetadata(options.metadata)
+      : undefined;
+
     const blueprint = await client.blueprints.create({
       name: options.name,
       dockerfile: dockerfileContents,
       system_setup_commands: options.systemSetupCommands,
       launch_parameters: launchParameters as Parameters<
         typeof client.blueprints.create
       >[0]["launch_parameters"],
+      metadata,
     });
 
     // Default: output JSON

src/commands/blueprint/from-dockerfile.ts

@@ -24,11 +24,27 @@ interface FromDockerfileOptions {
   availablePorts?: string[];
   root?: boolean;
   user?: string;
+  metadata?: string[];
   ttl?: string;
   noWait?: boolean;
   output?: string;
 }
 
+// Parse metadata from key=value format
+function parseMetadata(metadata: string[]): Record<string, string> {
+  const result: Record<string, string> = {};
+  for (const item of metadata) {
+    const eqIndex = item.indexOf("=");
+    if (eqIndex === -1) {
+      throw new Error(`Invalid metadata format: ${item}. Expected key=value`);
+    }
+    const key = item.substring(0, eqIndex);
+    const value = item.substring(eqIndex + 1);
+    result[key] = value;
+  }
+  return result;
+}
+
 // Helper to check if we should show progress
 function shouldShowProgress(options: FromDockerfileOptions): boolean {
   return !options.output || options.output === "text";
@@ -161,6 +177,11 @@ export async function createBlueprintFromDockerfile(
     logProgress(`\n⏳ [2/3] Creating blueprint...`, options);
     const createStart = Date.now();
 
+    // Parse metadata if provided
+    const metadata = options.metadata
+      ? parseMetadata(options.metadata)
+      : undefined;
+
     const createParams: BlueprintCreateParams = {
       name: options.name,
       dockerfile: dockerfileContents,
@@ -171,6 +192,7 @@ export async function createBlueprintFromDockerfile(
         type: "object",
         object_id: storageObject.id,
       },
+      metadata,
     };
 
     const blueprintResponse = await client.blueprints.create(createParams);

src/utils/commands.ts

@@ -462,6 +462,7 @@ export function createProgram(): Command {
     .option("--available-ports <ports...>", "Available ports")
     .option("--root", "Run as root")
     .option("--user <user:uid>", "Run as this user (format: username:uid)")
+    .option("--metadata <tags...>", "Metadata tags (format: key=value)")
     .option(
       "-o, --output [format]",
       "Output format: text|json|yaml (default: json)",
@@ -552,6 +553,7 @@ export function createProgram(): Command {
     .option("--available-ports <ports...>", "Available ports")
     .option("--root", "Run as root")
     .option("--user <user:uid>", "Run as this user (format: username:uid)")
+    .option("--metadata <tags...>", "Metadata tags (format: key=value)")
     .option(
       "--ttl <seconds>",
       "TTL in seconds for the build context object (default: 3600)",