feat(cli): agent templates with spawn export and --repo

[AhmedTMM]

Summary

• spawn export — SSHes into a running spawn, scans installed MCP servers, CLI auths, and tools, generates a spawn.md recipe (no secrets), pushes to GitHub, and prints a shareable one-liner
• spawn <agent> <cloud> --repo user/repo — clones the template repo onto the VM, reads spawn.md, merges built-in steps, guides through custom auth (OAuth, CLI login, API keys), installs MCP servers, runs setup commands, and launches in the project directory
• spawn.md format supports built-in steps (github, auto-update, browser) and custom setup steps (oauth, cli_auth, api_key, command)

New files

• packages/cli/src/shared/spawn-md.ts — YAML frontmatter parser, valibot schemas, spawn.md generation/application
• packages/cli/src/commands/export.ts — export command (VM scan, repo creation, shareable link)

Modified files

• packages/cli/src/index.ts — --repo flag extraction, export command dispatch
• packages/cli/src/shared/orchestrate.ts — repo clone + spawn.md application in postInstall
• packages/cli/src/flags.ts — added --repo to KNOWN_FLAGS
• packages/cli/src/commands/help.ts — updated help text
• packages/cli/src/commands/index.ts — barrel export
• packages/cli/package.json — version bump to 0.28.0

Test plan

• bunx @biomejs/biome check src/ — zero errors
• bun test — 1951 pass (1 pre-existing failure unrelated)
• Manual: create a repo with spawn.md, run spawn claude digitalocean --repo user/repo
• Manual: run spawn export on a running spawn

🤖 Generated with Claude Code

[la14-1]

Rebased onto main and resolved merge conflicts:

1. packages/cli/package.json — version conflict: took main's 1.0.21 and bumped to 1.0.22 for this feature
2. packages/cli/src/shared/orchestrate.ts (2 conflicts):
   • Skill installation block (from main) + spawn.md application (from this branch) — kept both, placed spawn.md setup after skill installation
   • Funnel tracking trackFunnel("funnel_handoff") (from main) + repo-aware launch command cd ~/project && (from this branch) — kept both

Verification:

• bunx @biomejs/biome check src/ — 0 errors
• bun test — 2106 pass, 2 fail (same pre-existing failures as main, tracked in fix(tests): use URL-aware fetch mocks to fix concurrent test pollution #3341)

-- refactor/pr-maintainer

[la14-1]

Rebased onto main (3e6c876) and resolved merge conflicts:

1. packages/cli/src/shared/orchestrate.ts (3 conflicts):

   • Kept main's repoCloned flag pattern (gates launch cd ~/project on actual clone success, not just env var)
   • Kept main's getErrorMessage() for clone failure logging
   • Preserved repoCloned = true; assignment from main

2. packages/cli/src/shared/spawn-md.ts (5 conflicts):

   • Header: merged branch's "generate" mention with main's detailed comment
   • Schema: kept branch's steps field (then correctly removed by commit 2, matching main's approach)
   • generateSpawnMd(): kept branch's new function (feature addition)
   • escapedName regex: took main's [^A-Za-z0-9_] (more permissive, handles lowercase env var names)
   • MCP installation: took main's extracted helpers (installClaudeMcpServers etc. from skills.js) over branch's inline require() approach

Verification:

• bunx @biomejs/biome check src/ — 0 errors
• bun test — 2110 pass, 2 fail (same pre-existing failures as main, tracked in fix(tests): use URL-aware fetch mocks to fix concurrent test pollution #3341)

-- refactor/pr-maintainer

[la14-1]

Rebased on main — merge conflict resolved. Lint clean, tests pass (2 pre-existing failures unrelated to this PR).

-- refactor/pr-maintainer