sunpeak 0.10.7 → 0.12.1

package/README.md

@@ -17,13 +17,14 @@
 
 The ChatGPT App framework.
 
-Quickstart, build, test, and ship your ChatGPT App locally!
+Quickstart, build, test, and ship your ChatGPT App—locally!
 
 [Demo (Hosted)](https://sunpeak.ai/#simulator) ~
 [Demo (Video)](https://d10djik02wlf6x.cloudfront.net/sunpeak-demo-prod.mp4) ~
 [Discord (NEW)](https://discord.gg/FB2QNXqRnw) ~
 [Documentation](https://docs.sunpeak.ai/) ~
-[GitHub](https://github.com/Sunpeak-AI/sunpeak)
+[GitHub](https://github.com/Sunpeak-AI/sunpeak) ~
+[Resource Repository](https://app.sunpeak.ai/)
 
 <div align="center">
   <a href="https://docs.sunpeak.ai/library/chatgpt-simulator">
@@ -35,8 +36,6 @@ Quickstart, build, test, and ship your ChatGPT App locally!
 
 ## Quickstart
 
-### New Projects
-
 Requirements: Node (20+), pnpm (10+)
 
 ```bash
@@ -48,29 +47,69 @@ To add sunpeak to an existing project, refer to the [documentation](https://docs
 
 ## Overview
 
-sunpeak is an npm package consisting of:
+sunpeak is an npm package that helps you build ChatGPT Apps (MCP Resources) while keeping your MCP server client-agnostic. sunpeak consists of:
+
+### The `sunpeak` library (`./src`)
+
+1. Runtime APIs: Strongly typed APIs for interacting with the ChatGPT runtime, **architected to support future platforms** (Gemini, Claude, etc.).
+2. ChatGPT simulator: React component replicating ChatGPT's runtime to **test Apps locally and automatically**.
+3. MCP server: Serve Resources with mock data to the real ChatGPT with HMR (**no more cache issues or 5-click manual refreshes**).
+
+### The `sunpeak` framework (`./template`)
+
+Next.js for ChatGPT Apps. Using a Review page as an example, sunpeak projects look like:
+
+```bash
+my-app/
+├── src/resources/
+│   └── review/
+│       ├── review-resource.tsx                 # Review UI component.
+│       └── review-resource.json                # Review UI MCP metadata.
+├── tests/simulations/
+│   └── review/
+│       ├── review-{scenario1}-simulation.json  # Mock state for testing.
+│       └── review-{scenario2}-simulation.json  # Mock state for testing.
+└── package.json
+```
+
+1. Project scaffold: Complete development setup with the sunpeak library.
+2. UI components: Production-ready components following ChatGPT design guidelines and using OpenAI apps-sdk-ui React components.
+3. Convention over configuration:
+   1. Create UIs by creating a `-resource.tsx` component file ([example](#resource-component)) and `-resource.json` MCP metadata file ([example](#resource-mcp-metadata)).
+   2. Create test state (simulations) for local dev, ChatGPT dev, automated testing, and demos by creating a `-simulation.json` file. ([example](#simulation))
 
-1. **The `sunpeak` library** (`./src`). An npm package for running & testing ChatGPT Apps. This standalone library contains:
-   1. Runtime APIs - Strongly typed, multi-platform APIs for interacting with the ChatGPT runtime, architected to support future platforms (Gemini, Claude).
-   2. ChatGPT simulator - React component replicating ChatGPT's runtime.
-   3. MCP server - Mock data MCP server for testing local UIs (resources) in the real ChatGPT.
-2. **The `sunpeak` framework** (`./template`). Next.js for ChatGPT Apps. This templated npm package includes:
-   1. Project scaffold - Complete development setup with build, test, and mcp tooling, including the sunpeak library.
-   2. UI components - Production-ready components following ChatGPT design guidelines and using OpenAI apps-sdk-ui React components.
-   3. Convention over configuration - Create UIs (resources) by simply creating a `src/resources/NAME/NAME-resource.tsx` React file and `src/resources/NAME/NAME-resource.json` metadata file.
-3. **The `sunpeak` CLI** (`./bin`). Commands for managing ChatGPT Apps. Includes a client for the [sunpeak Resource Repository](https://app.sunpeak.ai/) (ECR for ChatGPT Apps). The repository helps you & your CI/CD decouple your App from your client-agnostic MCP server:
-   1. Tag your app builds with version numbers and environment names (like `v1.0.0` and `prod`)
-   2. `push` built Apps to a central location
-   3. `pull` built Apps to be run in different environments
+### The `sunpeak` CLI (`./bin`)
 
-Note that each `sunpeak` component can be used in isolation if preferred, though the most seamless experience combines all 3.
+Commands for managing ChatGPT Apps. Includes a client for the [sunpeak Resource Repository](https://app.sunpeak.ai/). The repository helps you & your CI/CD decouple your App from your client-agnostic MCP server while also providing a hosted runtime to collaborate, demo, and share your ChatGPT Apps.
 
-## Example Component
+Think Docker Hub for ChatGPT Apps:
+
+<div align="center">
+  <a href="https://docs.sunpeak.ai/library/chatgpt-simulator">
+    <picture>
+      <img alt="ChatGPT Resource Repository" src="https://d10djik02wlf6x.cloudfront.net/blog/storybook-for-chatgpt-apps.png">
+    </picture>
+  </a>
+</div>
+
+1. Tag your app builds with version numbers and environment names (like `v1.0.0` and `prod`)
+2. `push` built Apps to a central location
+3. `pull` built Apps to be run in different environments, like your production MCP server.
+4. Share your fully-functional demo Apps with teammates, prospects, and strangers!
+
+## Examples
+
+Example sunpeak resource & simulation files for an MCP Resource called "Review".
+
+### Resource Component
+
+React component defining a UI (MCP Resource) in your ChatGPT App.
 
 ```tsx
+// src/resources/review-resource.tsx
 import { Card } from './components';
 
-export function MCPResource() {
+export function ReviewResource() {
   return (
     <Card
       image="https://images.unsplash.com/photo-1520950237264-dfe336995c34"
@@ -86,6 +125,64 @@ export function MCPResource() {
 }
 ```
 
+### Resource MCP Metadata
+
+MCP metadata for your UI. Version your resource metadata alongside the resource itself.
+
+This is just an official [MCP Resource object](https://modelcontextprotocol.io/specification/2025-11-25/server/resources#resource).
+
+```json
+{
+  // src/resources/review-resource.json
+  "name": "review",
+  "title": "Review",
+  "description": "Visualize and review a proposed set of changes or actions",
+  "mimeType": "text/html+skybridge",
+  "_meta": {
+    "openai/widgetDomain": "https://sunpeak.ai",
+    "openai/widgetCSP": {
+      "resource_domains": ["https://cdn.openai.com"]
+    }
+  }
+}
+```
+
+### Simulation
+
+`sunpeak` object. Testing a ChatGPT App require setting a lot of state: state in your backend (accessed via MCP tool), the stored widget runtime, and ChatGPT itself.
+
+Simulation files let you define key App states for development, automated testing, and demo purposes.
+
+Simulation files contain an [official MCP Tool object](https://modelcontextprotocol.io/specification/2025-11-25/server/tools#tool) and an [official MCP CallToolResult object](https://modelcontextprotocol.io/specification/2025-11-25/server/tools#structured-content). ChatGPT state (like light/dark mode) is not set on the simulation, but rather on the sunpeak `ChatGPTSimulator` itself via UI, props, or URL params.
+
+```json
+{
+  // tests/simulations/review-diff-simulation.json
+  "userMessage": "Refactor the authentication module", // Simulator styling.
+  "tool": {
+    // Official MCP Tool object.
+    "name": "diff-review",
+    "description": "Show a review dialog for a proposed code diff",
+    "inputSchema": { "type": "object", "properties": {}, "additionalProperties": false },
+    "title": "Diff Review",
+    "annotations": { "readOnlyHint": false },
+    "_meta": {
+      "openai/toolInvocation/invoking": "Preparing changes",
+      "openai/toolInvocation/invoked": "Changes ready for review",
+      "openai/widgetAccessible": true,
+      "openai/resultCanProduceWidget": true
+    }
+  },
+  "callToolResult": {
+    // Official MCP CallToolResult object.
+    "structuredContent": {
+      // ...
+    },
+    "_meta": {}
+  }
+}
+```
+
 ## Resources
 
 - [ChatGPT Apps SDK Design Guidelines](https://developers.openai.com/apps-sdk/concepts/design-guidelines)

package/bin/commands/build.mjs

@@ -4,7 +4,7 @@ import react from '@vitejs/plugin-react';
 import tailwindcss from '@tailwindcss/vite';
 import { existsSync, rmSync, readdirSync, readFileSync, writeFileSync, mkdirSync, copyFileSync, unlinkSync } from 'fs';
 import path from 'path';
-import { toPascalCase, isSimulationFile } from '../lib/patterns.mjs';
+import { toPascalCase } from '../lib/patterns.mjs';
 
 /**
  * Build all resources for a Sunpeak project
@@ -241,16 +241,6 @@ export async function build(projectRoot = process.cwd()) {
       process.exit(1);
     }
 
-    // Copy affiliated simulation files (matching {resource}-*-simulation.json pattern)
-    const simulationFiles = readdirSync(resourceDir)
-      .filter(file => isSimulationFile(file, kebabName));
-
-    for (const simFile of simulationFiles) {
-      const srcSim = path.join(resourceDir, simFile);
-      const destSim = path.join(distOutDir, simFile);
-      copyFileSync(srcSim, destSim);
-      console.log(`✓ Copied ${kebabName}/${simFile}`);
-    }
   }
 
   // Clean up temp and build directories

package/bin/commands/deploy.mjs

@@ -28,6 +28,7 @@ Usage:
 Options:
   -r, --repository <owner/repo>  Repository name (defaults to git remote origin)
   -t, --tag <name>               Additional tag(s) to assign (always includes "prod")
+  --no-simulations               Skip pushing simulations, only push resources
   -h, --help                     Show this help message
 
 Arguments:
@@ -40,6 +41,7 @@ Examples:
   sunpeak deploy dist/carousel   Deploy a single resource
   sunpeak deploy -r myorg/my-app Deploy to "myorg/my-app" repository
   sunpeak deploy -t v1.0         Deploy with "prod" and "v1.0" tags
+  sunpeak deploy --no-simulations Deploy without simulations
 
 This command is equivalent to: sunpeak push --tag prod
 `);
@@ -75,7 +77,7 @@ This command is equivalent to: sunpeak push --tag prod
 /**
  * Parse command line arguments
  */
-function parseArgs(args) {
+export function parseArgs(args) {
   const options = { tags: [] };
   let i = 0;
 
@@ -86,6 +88,8 @@ function parseArgs(args) {
       options.repository = args[++i];
     } else if (arg === '--tag' || arg === '-t') {
       options.tags.push(args[++i]);
+    } else if (arg === '--no-simulations') {
+      options.noSimulations = true;
     } else if (arg === '--help' || arg === '-h') {
       console.log(`
 sunpeak deploy - Deploy resources to production (push with "prod" tag)
@@ -96,6 +100,7 @@ Usage:
 Options:
   -r, --repository <owner/repo>  Repository name (defaults to git remote origin)
   -t, --tag <name>               Additional tag(s) to assign (always includes "prod")
+  --no-simulations               Skip pushing simulations, only push resources
   -h, --help                     Show this help message
 
 Arguments:
@@ -108,6 +113,7 @@ Examples:
   sunpeak deploy dist/carousel   Deploy a single resource
   sunpeak deploy -r myorg/my-app Deploy to "myorg/my-app" repository
   sunpeak deploy -t v1.0         Deploy with "prod" and "v1.0" tags
+  sunpeak deploy --no-simulations Deploy without simulations
 
 This command is equivalent to: sunpeak push --tag prod
 `);

package/bin/commands/dev.mjs

@@ -1,6 +1,8 @@
 #!/usr/bin/env node
-import { existsSync } from 'fs';
-import { join, resolve, basename, dirname } from 'path';
+import * as fs from 'fs';
+import * as path from 'path';
+const { existsSync, readFileSync } = fs;
+const { join, resolve, basename, dirname } = path;
 import { createRequire } from 'module';
 import { pathToFileURL } from 'url';
 
@@ -81,16 +83,51 @@ export async function dev(projectRoot = process.cwd(), args = []) {
     port = parseInt(args[portArgIndex + 1]);
   }
 
+  // Parse --no-begging flag
+  const noBegging = args.includes('--no-begging');
+
   console.log(`Starting Vite dev server on port ${port}...`);
 
   // Check if we're in the sunpeak workspace (directory is named "template")
   const isTemplate = basename(projectRoot) === 'template';
   const parentSrc = resolve(projectRoot, '../src');
 
+  // Import sunpeak modules (MCP server and discovery utilities)
+  let sunpeakMcp, sunpeak;
+  if (isTemplate) {
+    // In workspace dev mode, import from local dist folder
+    sunpeakMcp = await import(pathToFileURL(resolve(projectRoot, '../dist/mcp/index.js')).href);
+    sunpeak = await import(pathToFileURL(resolve(projectRoot, '../dist/index.js')).href);
+  } else {
+    // Import from installed sunpeak package
+    const sunpeakBase = require.resolve('sunpeak').replace(/dist\/index\.(c)?js$/, '');
+    sunpeakMcp = await import(pathToFileURL(join(sunpeakBase, 'dist/mcp/index.js')).href);
+    sunpeak = await import(pathToFileURL(join(sunpeakBase, 'dist/index.js')).href);
+  }
+  const { FAVICON_BUFFER: faviconBuffer, runMCPServer } = sunpeakMcp;
+  const { findResourceDirs, findSimulationFiles } = sunpeak;
+
+  // Vite plugin to serve the sunpeak favicon
+  const sunpeakFaviconPlugin = () => ({
+    name: 'sunpeak-favicon',
+    configureServer(server) {
+      server.middlewares.use((req, res, next) => {
+        if (req.url === '/favicon.ico') {
+          res.setHeader('Content-Type', 'image/png');
+          res.setHeader('Content-Length', faviconBuffer.length);
+          res.setHeader('Cache-Control', 'public, max-age=86400');
+          res.end(faviconBuffer);
+          return;
+        }
+        next();
+      });
+    },
+  });
+
   // Create and start Vite dev server programmatically
   const server = await createServer({
     root: projectRoot,
-    plugins: [react(), tailwindcss()],
+    plugins: [react(), tailwindcss(), sunpeakFaviconPlugin()],
     resolve: {
       alias: {
         // In workspace dev mode, use local sunpeak source
@@ -109,16 +146,142 @@ export async function dev(projectRoot = process.cwd(), args = []) {
   server.printUrls();
   server.bindCLIShortcuts({ print: true });
 
-  // Handle signals
-  process.on('SIGINT', async () => {
-    await server.close();
-    process.exit(0);
-  });
+  // Print star-begging message unless --no-begging is set
+  if (!noBegging) {
+    // #FFB800 in 24-bit ANSI color
+    console.log('\n\n\x1b[38;2;255;184;0m\u2b50\ufe0f \u2192 \u2764\ufe0f  https://github.com/Sunpeak-AI/sunpeak\x1b[0m\n');
+  }
 
-  process.on('SIGTERM', async () => {
-    await server.close();
-    process.exit(0);
-  });
+  // Discover simulations using sunpeak's discovery utilities
+  const resourcesDir = join(projectRoot, 'src/resources');
+  const simulationsDir = join(projectRoot, 'tests/simulations');
+  const resourceDirs = findResourceDirs(resourcesDir, (key) => `${key}-resource.json`, fs);
+
+  const simulations = [];
+  for (const { key: resourceKey, dir: resourceDir, resourcePath } of resourceDirs) {
+    const resource = JSON.parse(readFileSync(resourcePath, 'utf-8'));
+    const resourceSimDir = join(simulationsDir, resourceKey);
+    const simulationFiles = findSimulationFiles(resourceSimDir, resourceKey, fs);
+
+    for (const { filename, path: simPath } of simulationFiles) {
+      const simulationKey = filename.replace(/-simulation\.json$/, '');
+      const simulation = JSON.parse(readFileSync(simPath, 'utf-8'));
+
+      simulations.push({
+        ...simulation,
+        name: simulationKey,
+        distPath: join(projectRoot, `dist/${resourceKey}/${resourceKey}.js`),
+        srcPath: `/src/resources/${resourceKey}/${resourceKey}-resource.tsx`,
+        resource,
+      });
+    }
+  }
+
+  // Start MCP server with its own Vite instance
+  if (simulations.length > 0) {
+    console.log(`\nStarting MCP server with ${simulations.length} simulation(s)...`);
+
+    // Virtual entry module plugin for MCP
+    const sunpeakEntryPlugin = () => ({
+      name: 'sunpeak-entry',
+      resolveId(id) {
+        if (id.startsWith('virtual:sunpeak-entry')) {
+          return id;
+        }
+      },
+      load(id) {
+        if (id.startsWith('virtual:sunpeak-entry')) {
+          const url = new URL(id.replace('virtual:sunpeak-entry', 'http://x'));
+          const srcPath = url.searchParams.get('src');
+          const componentName = url.searchParams.get('component');
+
+          if (!srcPath || !componentName) {
+            return 'console.error("Missing src or component param");';
+          }
+
+          return `
+import { createElement } from 'react';
+import { createRoot } from 'react-dom/client';
+import * as ResourceModule from '${srcPath}';
+
+const Component = ResourceModule.default || ResourceModule['${componentName}'];
+if (!Component) {
+  document.getElementById('root').innerHTML = '<pre style="color:red;padding:16px">Component not found: ${componentName}\\nExports: ' + Object.keys(ResourceModule).join(', ') + '</pre>';
+} else {
+  createRoot(document.getElementById('root')).render(createElement(Component));
+}
+`;
+        }
+      },
+    });
+
+    // Create Vite dev server in middleware mode for MCP
+    // Use separate cache directory to avoid conflicts with main dev server
+    const mcpViteServer = await createServer({
+      root: projectRoot,
+      cacheDir: 'node_modules/.vite-mcp',
+      plugins: [react(), tailwindcss(), sunpeakEntryPlugin()],
+      resolve: {
+        alias: {
+          ...(isTemplate && {
+            sunpeak: parentSrc,
+          }),
+        },
+      },
+      server: {
+        middlewareMode: true,
+        allowedHosts: true,
+        watch: {
+          // Only watch files that affect the UI bundle (not JSON, tests, etc.)
+          // MCP resources reload on next tool call, not on file change
+          ignored: (filePath) => {
+            if (!filePath.includes('.')) return false; // Watch directories
+            if (/\.(tsx?|css)$/.test(filePath)) {
+              return /\.(test|spec)\.tsx?$/.test(filePath); // Ignore tests
+            }
+            return true; // Ignore everything else
+          },
+        },
+      },
+      optimizeDeps: {
+        include: ['react', 'react-dom/client'],
+      },
+      appType: 'custom',
+    });
+
+    const pkg = JSON.parse(readFileSync(pkgJsonPath, 'utf-8'));
+    runMCPServer({
+      name: pkg.name || 'Sunpeak',
+      version: pkg.version || '0.1.0',
+      simulations,
+      port: 6766,
+      viteServer: mcpViteServer,
+    });
+
+    // Handle signals - close both servers
+    process.on('SIGINT', async () => {
+      await mcpViteServer.close();
+      await server.close();
+      process.exit(0);
+    });
+
+    process.on('SIGTERM', async () => {
+      await mcpViteServer.close();
+      await server.close();
+      process.exit(0);
+    });
+  } else {
+    // No simulations - just handle signals for the dev server
+    process.on('SIGINT', async () => {
+      await server.close();
+      process.exit(0);
+    });
+
+    process.on('SIGTERM', async () => {
+      await server.close();
+      process.exit(0);
+    });
+  }
 }
 
 // Allow running directly

package/bin/commands/new.mjs

@@ -0,0 +1,211 @@
+#!/usr/bin/env node
+import { existsSync, mkdirSync, cpSync, readFileSync, writeFileSync, renameSync } from 'fs';
+import { join, dirname, basename } from 'path';
+import { fileURLToPath } from 'url';
+import { createInterface } from 'readline';
+import { discoverResources } from '../lib/patterns.mjs';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+/**
+ * Default prompt implementation using readline
+ * @param {string} question
+ * @returns {Promise<string>}
+ */
+function defaultPrompt(question) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+
+/**
+ * Default dependencies (real implementations)
+ */
+export const defaultDeps = {
+  discoverResources,
+  existsSync,
+  mkdirSync,
+  cpSync,
+  readFileSync,
+  writeFileSync,
+  renameSync,
+  prompt: defaultPrompt,
+  console,
+  process,
+  cwd: () => process.cwd(),
+  templateDir: join(__dirname, '..', '..', 'template'),
+  rootPkgPath: join(__dirname, '..', '..', 'package.json'),
+};
+
+/**
+ * Parse and validate resources input
+ * @param {string} input - Comma or space separated resource names
+ * @param {string[]} validResources - List of valid resource names
+ * @param {Object} deps - Dependencies for testing
+ * @returns {string[]} - Validated and deduplicated resource names
+ */
+export function parseResourcesInput(input, validResources, deps = defaultDeps) {
+  const d = { ...defaultDeps, ...deps };
+
+  // If no input, return all resources
+  if (!input || input.trim() === '') {
+    return validResources;
+  }
+
+  // Split by comma or space and trim
+  const tokens = input
+    .toLowerCase()
+    .split(/[,\s]+/)
+    .map((s) => s.trim())
+    .filter((s) => s.length > 0);
+
+  // Validate tokens
+  const invalid = tokens.filter((t) => !validResources.includes(t));
+  if (invalid.length > 0) {
+    d.console.error(`Error: Invalid resource(s): ${invalid.join(', ')}`);
+    d.console.error(`Valid resources are: ${validResources.join(', ')}`);
+    d.process.exit(1);
+  }
+
+  // Remove duplicates
+  return [...new Set(tokens)];
+}
+
+/**
+ * Create a new Sunpeak project
+ * @param {string} projectName - Name of the project directory
+ * @param {string} resourcesArg - Optional comma/space separated resources to include
+ * @param {Object} deps - Dependencies for testing
+ */
+export async function init(projectName, resourcesArg, deps = defaultDeps) {
+  const d = { ...defaultDeps, ...deps };
+
+  // Discover available resources from template
+  const availableResources = d.discoverResources();
+  if (availableResources.length === 0) {
+    d.console.error('Error: No resources found in template/src/resources/');
+    d.process.exit(1);
+  }
+
+  if (!projectName) {
+    projectName = await d.prompt('☀️ 🏔️ Project name [my-app]: ');
+    if (!projectName) {
+      projectName = 'my-app';
+    }
+  }
+
+  if (projectName === 'template') {
+    d.console.error('Error: "template" is a reserved name. Please choose another name.');
+    d.process.exit(1);
+  }
+
+  // Use resources from args or ask for them
+  let resourcesInput;
+  if (resourcesArg) {
+    resourcesInput = resourcesArg;
+    d.console.log(`☀️ 🏔️ Resources: ${resourcesArg}`);
+  } else {
+    resourcesInput = await d.prompt(
+      `☀️ 🏔️ Resources (UIs) to include [${availableResources.join(', ')}]: `
+    );
+  }
+  const selectedResources = parseResourcesInput(resourcesInput, availableResources, d);
+
+  const targetDir = join(d.cwd(), projectName);
+
+  if (d.existsSync(targetDir)) {
+    d.console.error(`Error: Directory "${projectName}" already exists`);
+    d.process.exit(1);
+  }
+
+  d.console.log(`☀️ 🏔️ Creating ${projectName}...`);
+
+  d.mkdirSync(targetDir, { recursive: true });
+
+  // Filter resource directories based on selection
+  const excludedResources = availableResources.filter((r) => !selectedResources.includes(r));
+
+  d.cpSync(d.templateDir, targetDir, {
+    recursive: true,
+    filter: (src) => {
+      const name = basename(src);
+
+      // Skip node_modules and lock file
+      if (name === 'node_modules' || name === 'pnpm-lock.yaml') {
+        return false;
+      }
+
+      for (const resource of excludedResources) {
+        // Skip entire resource directory: src/resources/{resource}/
+        if (src.includes('/resources/') && name === resource) {
+          return false;
+        }
+        // Skip simulation directories for excluded resources: tests/simulations/{resource}/
+        if (src.includes('/tests/simulations/') && name === resource) {
+          return false;
+        }
+        // Skip e2e test files for excluded resources
+        if (src.includes('/tests/e2e/') && name === `${resource}.spec.ts`) {
+          return false;
+        }
+      }
+
+      return true;
+    },
+  });
+
+  // Rename underscore-prefixed files to dotfiles
+  const dotfiles = ['_gitignore', '_prettierignore', '_prettierrc'];
+  for (const file of dotfiles) {
+    const srcPath = join(targetDir, file);
+    const destPath = join(targetDir, file.replace(/^_/, '.'));
+    if (d.existsSync(srcPath)) {
+      d.renameSync(srcPath, destPath);
+    }
+  }
+
+  // Read sunpeak version from root package.json
+  const rootPkg = JSON.parse(d.readFileSync(d.rootPkgPath, 'utf-8'));
+  const sunpeakVersion = `^${rootPkg.version}`;
+
+  // Update project package.json
+  const pkgPath = join(targetDir, 'package.json');
+  const pkg = JSON.parse(d.readFileSync(pkgPath, 'utf-8'));
+  pkg.name = projectName;
+
+  // Replace workspace:* with actual version
+  if (pkg.dependencies?.sunpeak === 'workspace:*') {
+    pkg.dependencies.sunpeak = sunpeakVersion;
+  }
+
+  d.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
+
+  d.console.log(`
+Done! To get started:
+
+  cd ${projectName}
+  pnpm install
+  sunpeak dev
+
+That's it! Your project commands:
+
+  sunpeak dev       # Start dev server + MCP endpoint
+  sunpeak build     # Build for production
+  pnpm test         # Run tests
+
+See README.md for more details.
+`);
+}
+
+// Allow running directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+  const [projectName, resources] = process.argv.slice(2);
+  init(projectName, resources).catch((error) => {
+    console.error('Error:', error.message);
+    process.exit(1);
+  });
+}

package/bin/commands/pull.mjs

@@ -216,7 +216,7 @@ Examples:
 /**
  * Parse command line arguments
  */
-function parseArgs(args) {
+export function parseArgs(args) {
   const options = {};
   let i = 0;