@embeddables/cli 0.6.11 → 0.7.0

package/dist/commands/init.js

@@ -6,6 +6,7 @@ import prompts from 'prompts';
 import { writeProjectConfig, readProjectConfig } from '../config/index.js';
 import { isLoggedIn } from '../auth/index.js';
 import { promptForProject } from '../prompts/index.js';
+import * as stdout from '../stdout.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 /** Recursively copy a directory, creating target dirs as needed. */
@@ -43,7 +44,7 @@ function writeTypeStubs(cwd) {
         fs.copyFileSync(typesBuilderDts, path.join(typesDir, 'types.d.ts'));
     }
     else {
-        console.warn(pc.yellow('  ⚠ Could not find types-builder.d.ts — run `npm run build` first'));
+        stdout.warn(pc.yellow('  ⚠ Could not find types-builder.d.ts — run `npm run build` first'));
     }
     // React JSX runtime types (needed for "jsx": "react-jsx" in tsconfig)
     fs.writeFileSync(path.join(typesDir, 'react-jsx-runtime.d.ts'), `export namespace JSX {
@@ -104,9 +105,9 @@ export async function runInit(opts) {
     const cwd = process.cwd();
     const gitignorePath = path.join(cwd, '.gitignore');
     const embeddablesDir = path.join(cwd, 'embeddables');
-    console.log('');
-    console.log(pc.bold(pc.cyan('  Embeddables Project Setup')));
-    console.log('');
+    stdout.print('');
+    stdout.print(pc.bold(pc.cyan('  Embeddables Project Setup')));
+    stdout.print('');
     const existingConfig = readProjectConfig();
     // Step 1: Get Embeddables project
     let projectId = opts.projectId;
@@ -115,7 +116,7 @@ export async function runInit(opts) {
     let selectedOrgTitle;
     if (!projectId && !opts.yes) {
         if (existingConfig?.project_id) {
-            console.log(pc.gray(`  Using existing project ID: ${existingConfig.project_id}`));
+            stdout.print(pc.gray(`  Using existing project ID: ${existingConfig.project_id}`));
             projectId = existingConfig.project_id;
             selectedProjectTitle = existingConfig.project_name || undefined;
             selectedOrgId = existingConfig.org_id || undefined;
@@ -123,7 +124,7 @@ export async function runInit(opts) {
         }
         else if (isLoggedIn()) {
             // Fetch and show project list
-            console.log(pc.gray('  Fetching projects...'));
+            stdout.print(pc.gray('  Fetching projects...'));
             const selectedProject = await promptForProject({
                 allowSkip: true,
                 message: 'Select your Embeddables project:',
@@ -137,7 +138,7 @@ export async function runInit(opts) {
         }
         else {
             // Not logged in - offer manual entry or skip
-            console.log(pc.gray('  (Login with "embeddables login" to select from your projects)'));
+            stdout.print(pc.gray('  (Login with "embeddables login" to select from your projects)'));
             const response = await prompts({
                 type: 'text',
                 name: 'projectId',
@@ -145,7 +146,7 @@ export async function runInit(opts) {
                 hint: 'e.g., proj_abc123 - leave empty to skip',
             }, {
                 onCancel: () => {
-                    console.log(pc.gray('\n  Cancelled.'));
+                    stdout.print(pc.gray('\n  Cancelled.'));
                     process.exit(0);
                 },
             });
@@ -160,7 +161,7 @@ export async function runInit(opts) {
             project_id: projectId,
             project_name: selectedProjectTitle,
         });
-        console.log(pc.green('  ✓ Created embeddables.json'));
+        stdout.print(pc.green('  ✓ Created embeddables.json'));
     }
     // Create or update .gitignore
     const gitignoreEntries = ['**/.generated/', '**/.types/', '.DS_Store'];
@@ -176,28 +177,28 @@ export async function runInit(opts) {
             : `# Embeddables\n${gitignoreEntries.join('\n')}\n`;
         fs.writeFileSync(gitignorePath, existingGitignore + embeddablesSection, 'utf8');
         if (existingGitignore) {
-            console.log(pc.green('  ✓ Updated .gitignore'));
+            stdout.print(pc.green('  ✓ Updated .gitignore'));
         }
         else {
-            console.log(pc.green('  ✓ Created .gitignore'));
+            stdout.print(pc.green('  ✓ Created .gitignore'));
         }
     }
     else {
-        console.log(pc.gray('  ✓ .gitignore already configured'));
+        stdout.print(pc.gray('  ✓ .gitignore already configured'));
     }
     // Create embeddables directory
     if (!fs.existsSync(embeddablesDir)) {
         fs.mkdirSync(embeddablesDir, { recursive: true });
-        console.log(pc.green('  ✓ Created embeddables/ directory'));
+        stdout.print(pc.green('  ✓ Created embeddables/ directory'));
     }
     else {
-        console.log(pc.gray('  ✓ embeddables/ directory exists'));
+        stdout.print(pc.gray('  ✓ embeddables/ directory exists'));
     }
-    // Inject .cursor/ and .claudefiles/ from source .prompts/embeddables-cli.md (or copy if pre-built dirs exist)
+    // Inject .cursor/ and .claude/ from source .prompts/embeddables-cli.md (or copy if pre-built dirs exist)
     const packageRoot = path.resolve(__dirname, '..', '..');
     const promptsSource = path.join(packageRoot, '.prompts', 'embeddables-cli.md');
     const sourceCursorDir = path.join(packageRoot, '.cursor');
-    const sourceClaudefilesDir = path.join(packageRoot, '.claudefiles');
+    const sourceClaudeDir = path.join(packageRoot, '.claude');
     if (fs.existsSync(promptsSource)) {
         const content = fs.readFileSync(promptsSource, 'utf8');
         const cursorFrontmatter = `---
@@ -212,28 +213,28 @@ This is an Embeddables project managed by the Embeddables CLI. The CLI transform
 
 For full context when editing embeddables (pages, components, styles, actions, computed fields), see:
 
-- **.claudefiles/embeddables-cli.md** — Embeddables CLI structure, types, file layout, and conventions.
+- **.claude/embeddables-cli.md** — Embeddables CLI structure, types, file layout, and conventions.
 
 All TypeScript types are in \`.types/\` (generated by \`embeddables init\`). Use \`embeddables dev\` to run the dev server and \`embeddables pull\` / \`embeddables save\` to sync with the project.
 `;
         const cursorRulesDir = path.join(cwd, '.cursor', 'rules');
-        const claudefilesDir = path.join(cwd, '.claudefiles');
+        const claudeDir = path.join(cwd, '.claude');
         fs.mkdirSync(cursorRulesDir, { recursive: true });
-        fs.mkdirSync(claudefilesDir, { recursive: true });
+        fs.mkdirSync(claudeDir, { recursive: true });
         fs.writeFileSync(path.join(cursorRulesDir, 'embeddables-cli.md'), cursorFrontmatter + content, 'utf8');
-        fs.writeFileSync(path.join(claudefilesDir, 'CLAUDE.md'), claudeIntro, 'utf8');
-        fs.writeFileSync(path.join(claudefilesDir, 'embeddables-cli.md'), content, 'utf8');
-        console.log(pc.green('  ✓ Injected .cursor/ rules'));
-        console.log(pc.green('  ✓ Injected .claudefiles/'));
+        fs.writeFileSync(path.join(claudeDir, 'CLAUDE.md'), claudeIntro, 'utf8');
+        fs.writeFileSync(path.join(claudeDir, 'embeddables-cli.md'), content, 'utf8');
+        stdout.print(pc.green('  ✓ Injected .cursor/ rules'));
+        stdout.print(pc.green('  ✓ Injected .claude/'));
     }
-    else if (fs.existsSync(sourceCursorDir) || fs.existsSync(sourceClaudefilesDir)) {
+    else if (fs.existsSync(sourceCursorDir) || fs.existsSync(sourceClaudeDir)) {
         if (fs.existsSync(sourceCursorDir)) {
             copyDirSync(sourceCursorDir, path.join(cwd, '.cursor'));
-            console.log(pc.green('  ✓ Injected .cursor/ rules'));
+            stdout.print(pc.green('  ✓ Injected .cursor/ rules'));
         }
-        if (fs.existsSync(sourceClaudefilesDir)) {
-            copyDirSync(sourceClaudefilesDir, path.join(cwd, '.claudefiles'));
-            console.log(pc.green('  ✓ Injected .claudefiles/'));
+        if (fs.existsSync(sourceClaudeDir)) {
+            copyDirSync(sourceClaudeDir, path.join(cwd, '.claude'));
+            stdout.print(pc.green('  ✓ Injected .claude/'));
         }
     }
     // Create tsconfig.json for editor support (JSX, type checking)
@@ -259,16 +260,16 @@ All TypeScript types are in \`.types/\` (generated by \`embeddables init\`). Use
             include: ['embeddables'],
         };
         fs.writeFileSync(tsconfigPath, JSON.stringify(tsconfig, null, 2) + '\n', 'utf8');
-        console.log(pc.green('  ✓ Created tsconfig.json'));
+        stdout.print(pc.green('  ✓ Created tsconfig.json'));
     }
     else {
-        console.log(pc.gray('  ✓ tsconfig.json already exists'));
+        stdout.print(pc.gray('  ✓ tsconfig.json already exists'));
     }
     // Migrate .types from old location (embeddables/.types/) to project root (.types/)
     const oldTypesDir = path.join(embeddablesDir, '.types');
     if (fs.existsSync(oldTypesDir)) {
         fs.rmSync(oldTypesDir, { recursive: true });
-        console.log(pc.green('  ✓ Removed old embeddables/.types/'));
+        stdout.print(pc.green('  ✓ Removed old embeddables/.types/'));
     }
     // Fix tsconfig paths from older versions
     if (fs.existsSync(tsconfigPath)) {
@@ -286,7 +287,7 @@ All TypeScript types are in \`.types/\` (generated by \`embeddables init\`). Use
         }
         if (updated) {
             fs.writeFileSync(tsconfigPath, tsconfigContent, 'utf8');
-            console.log(pc.green('  ✓ Updated tsconfig.json paths'));
+            stdout.print(pc.green('  ✓ Updated tsconfig.json paths'));
         }
     }
     // Remove old .types/types-builder.d.ts (now named .types/types.d.ts)
@@ -296,25 +297,25 @@ All TypeScript types are in \`.types/\` (generated by \`embeddables init\`). Use
     }
     // Generate type declaration stubs for editor support (no npm install needed)
     writeTypeStubs(cwd);
-    console.log(pc.green('  ✓ Generated type declarations'));
+    stdout.print(pc.green('  ✓ Generated type declarations'));
     // Print next steps
-    console.log('');
-    console.log(pc.bold('  Next steps:'));
-    console.log('');
-    console.log(pc.cyan('    1. Login to Embeddables:'));
-    console.log(pc.white('       embeddables login'));
-    console.log('');
+    stdout.print('');
+    stdout.print(pc.bold('  Next steps:'));
+    stdout.print('');
+    stdout.print(pc.cyan('    1. Login to Embeddables:'));
+    stdout.print(pc.white('       embeddables login'));
+    stdout.print('');
     if (projectId) {
-        console.log(pc.cyan('    2. Pull an embeddable:'));
-        console.log(pc.white('       embeddables pull'));
-        console.log(pc.gray('       (will show a list of embeddables in your project)'));
+        stdout.print(pc.cyan('    2. Pull an embeddable:'));
+        stdout.print(pc.white('       embeddables pull'));
+        stdout.print(pc.gray('       (will show a list of embeddables in your project)'));
     }
     else {
-        console.log(pc.cyan('    2. Pull an existing embeddable:'));
-        console.log(pc.white('       embeddables pull --id <embeddable-id>'));
+        stdout.print(pc.cyan('    2. Pull an existing embeddable:'));
+        stdout.print(pc.white('       embeddables pull --id <embeddable-id>'));
     }
-    console.log('');
-    console.log(pc.cyan('    3. Start developing:'));
-    console.log(pc.white('       embeddables dev'));
-    console.log('');
+    stdout.print('');
+    stdout.print(pc.cyan('    3. Start developing:'));
+    stdout.print(pc.white('       embeddables dev'));
+    stdout.print('');
 }

package/dist/commands/login.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../src/commands/login.ts"],"names":[],"mappings":"AAUA,wBAAsB,QAAQ,kBAyH7B"}
+{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../src/commands/login.ts"],"names":[],"mappings":"AAYA,wBAAsB,QAAQ,kBAiI7B"}

package/dist/commands/login.js

@@ -1,7 +1,10 @@
 import prompts from 'prompts';
 import pc from 'picocolors';
 import { getSupabaseClient, writeAuthConfig, readAuthConfig, SUPABASE_URL, SUPABASE_ANON_KEY, } from '../auth/index.js';
+import { captureException, createLogger, exit } from '../logger.js';
+import * as stdout from '../stdout.js';
 export async function runLogin() {
+    const logger = createLogger('runLogin');
     try {
         const supabase = getSupabaseClient();
         // Check if already logged in
@@ -14,7 +17,7 @@ export async function runLogin() {
                 initial: false,
             });
             if (!overwrite) {
-                console.log(pc.green('Login cancelled.'));
+                stdout.print(pc.green('Login cancelled.'));
                 return;
             }
         }
@@ -33,23 +36,24 @@ export async function runLogin() {
             },
         });
         if (!email) {
-            console.log(pc.red('Login cancelled.'));
+            stdout.print(pc.red('Login cancelled.'));
             return;
         }
-        console.log('');
-        console.log(pc.cyan('Sending verification code to your email...'));
+        stdout.print('');
+        stdout.print(pc.cyan('Sending verification code to your email...'));
         // Send OTP code
         const { error: sendError } = await supabase.auth.signInWithOtp({
             email,
         });
         if (sendError) {
-            console.error(pc.red(`Error sending verification code: ${sendError.message}`));
-            process.exit(1);
+            stdout.error(pc.red(`Error sending verification code: ${sendError.message}`));
+            logger.error('failed to send OTP', { message: sendError.message });
+            await exit(1);
         }
-        console.log('');
-        console.log(pc.green('✓ Verification code sent!'));
-        console.log(pc.dim('Please check your email for the code.'));
-        console.log('');
+        stdout.print('');
+        stdout.print(pc.green('✓ Verification code sent!'));
+        stdout.print(pc.dim('Please check your email for the code.'));
+        stdout.print('');
         // Prompt for OTP code
         const { code } = await prompts({
             type: 'text',
@@ -65,11 +69,11 @@ export async function runLogin() {
             },
         });
         if (!code) {
-            console.log(pc.red('Login cancelled.'));
+            stdout.print(pc.red('Login cancelled.'));
             return;
         }
-        console.log('');
-        console.log(pc.cyan('Verifying code...'));
+        stdout.print('');
+        stdout.print(pc.cyan('Verifying code...'));
         // Verify OTP code
         const { data, error: verifyError } = await supabase.auth.verifyOtp({
             email,
@@ -77,12 +81,15 @@ export async function runLogin() {
             type: 'email',
         });
         if (verifyError) {
-            console.error(pc.red(`Error verifying code: ${verifyError.message}`));
-            process.exit(1);
+            stdout.error(pc.red(`Error verifying code: ${verifyError.message}`));
+            logger.error('failed to verify OTP', { message: verifyError.message });
+            await exit(1);
         }
         if (!data.session) {
-            console.error(pc.red('No session returned from verification'));
-            process.exit(1);
+            stdout.error(pc.red('No session returned from verification'));
+            logger.error('no session returned from verification');
+            await exit(1);
+            return;
         }
         // Store auth config
         const config = {
@@ -93,20 +100,23 @@ export async function runLogin() {
             supabase_anon_key: SUPABASE_ANON_KEY,
         };
         writeAuthConfig(config);
-        console.log('');
-        console.log(pc.green('✓ Successfully logged in!'));
-        console.log('');
+        stdout.print('');
+        stdout.print(pc.green('✓ Successfully logged in!'));
+        logger.info('login complete');
+        stdout.print('');
     }
     catch (error) {
         if (error.name === 'ExitPrompt') {
             // User cancelled prompt (Ctrl+C)
-            console.log('');
-            console.log(pc.red('Login cancelled.'));
-            process.exit(0);
+            stdout.print('');
+            stdout.print(pc.red('Login cancelled.'));
+            await exit(0);
         }
         else {
-            console.error(pc.red(`Error during login: ${error.message}`));
-            process.exit(1);
+            captureException(error);
+            stdout.error(pc.red(`Error during login: ${error.message}`));
+            logger.error('login failed', { message: error.message });
+            await exit(1);
         }
     }
 }

package/dist/commands/logout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logout.d.ts","sourceRoot":"","sources":["../../src/commands/logout.ts"],"names":[],"mappings":"AAGA,wBAAsB,SAAS,kBAe9B"}
+{"version":3,"file":"logout.d.ts","sourceRoot":"","sources":["../../src/commands/logout.ts"],"names":[],"mappings":"AAKA,wBAAsB,SAAS,kBAiB9B"}

package/dist/commands/logout.js

@@ -1,18 +1,22 @@
 import pc from 'picocolors';
 import { deleteAuthConfig, isLoggedIn } from '../auth/index.js';
+import { createLogger, exit } from '../logger.js';
+import * as stdout from '../stdout.js';
 export async function runLogout() {
+    const logger = createLogger('runLogout');
     try {
         if (!isLoggedIn()) {
-            console.log(pc.yellow('You are not currently logged in.'));
+            stdout.print(pc.yellow('You are not currently logged in.'));
             return;
         }
         deleteAuthConfig();
-        console.log('');
-        console.log(pc.green('✓ Successfully logged out!'));
-        console.log('');
+        stdout.print('');
+        stdout.print(pc.green('✓ Successfully logged out!'));
+        stdout.print('');
     }
     catch (error) {
-        console.error(pc.red(`Error during logout: ${error.message}`));
-        process.exit(1);
+        stdout.error(pc.red(`Error during logout: ${error.message}`));
+        logger.error('logout failed', { message: error.message });
+        await exit(1);
     }
 }

package/dist/commands/pull.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../src/commands/pull.ts"],"names":[],"mappings":"AAgHA,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iHAAiH;IACjH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,cAAc,iBAkQjD"}
+{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../src/commands/pull.ts"],"names":[],"mappings":"AAkHA,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iHAAiH;IACjH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,cAAc,iBA8QjD"}

package/dist/commands/pull.js

@@ -6,6 +6,8 @@ import { reverseCompile } from '../compiler/reverse.js';
 import { getAccessToken, isLoggedIn } from '../auth/index.js';
 import { getProjectId, writeProjectConfig } from '../config/index.js';
 import { promptForProject, promptForEmbeddable, fetchEmbeddableMetadata } from '../prompts/index.js';
+import { captureException, createLogger, exit } from '../logger.js';
+import * as stdout from '../stdout.js';
 import { inferEmbeddableFromCwd } from '../helpers/utils.js';
 /**
  * Normalize custom_validation_function strings so literal "\\n" (backslash-n) becomes real newline.
@@ -105,10 +107,11 @@ function writePullMetadataToConfig(embeddableId, version, branch, branchName) {
         fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf8');
     }
     catch (err) {
-        console.warn(pc.yellow(`Could not write config.json: ${err instanceof Error ? err.message : err}`));
+        stdout.warn(pc.yellow(`Could not write config.json: ${err instanceof Error ? err.message : err}`));
     }
 }
 export async function runPull(opts) {
+    const logger = createLogger('runPull');
     const inferred = inferEmbeddableFromCwd();
     let embeddableId = opts.id ?? inferred?.embeddableId;
     if (inferred && !opts.id && embeddableId) {
@@ -117,20 +120,24 @@ export async function runPull(opts) {
     // If no ID provided, try to get it interactively
     if (!embeddableId) {
         if (!isLoggedIn()) {
-            console.error(pc.red('No embeddable ID provided and not logged in.'));
-            console.log('');
-            console.log(pc.gray('Either:'));
-            console.log(pc.gray('  1. Use --id <embeddable-id> to specify an embeddable'));
-            console.log(pc.gray('  2. Run "embeddables login" first for interactive selection'));
-            process.exit(1);
+            stdout.error(pc.red('No embeddable ID provided and not logged in.'));
+            stdout.print('');
+            stdout.print(pc.gray('Either:'));
+            stdout.print(pc.gray('  1. Use --id <embeddable-id> to specify an embeddable'));
+            stdout.print(pc.gray('  2. Run "embeddables login" first for interactive selection'));
+            logger.error('not logged in and no embeddable id');
+            await exit(1);
+            return;
         }
         let projectId = getProjectId();
         // If no project ID configured, prompt for project selection
         if (!projectId) {
-            console.log(pc.cyan('Fetching projects...'));
+            stdout.print(pc.cyan('Fetching projects...'));
             const selectedProject = await promptForProject();
             if (!selectedProject) {
-                process.exit(1);
+                logger.error('project selection failed');
+                await exit(1);
+                return;
             }
             projectId = selectedProject.id;
             // Save the selected project to config
@@ -140,18 +147,20 @@ export async function runPull(opts) {
                 project_id: projectId,
                 project_name: selectedProject.title || undefined,
             });
-            console.log(pc.green(`✓ Wrote project config to embeddables.json`));
-            console.log('');
+            stdout.print(pc.green(`✓ Wrote project config to embeddables.json`));
+            stdout.print('');
         }
-        console.log(pc.cyan('Fetching embeddables from project...'));
+        stdout.print(pc.cyan('Fetching embeddables from project...'));
         const selected = await promptForEmbeddable(projectId, {
             message: 'Select an embeddable to pull:',
         });
         if (!selected) {
-            process.exit(1);
+            logger.error('embeddable selection failed');
+            await exit(1);
+            return;
         }
         embeddableId = selected;
-        console.log('');
+        stdout.print('');
     }
     // When useMain, pull main and ignore/clear saved branch. Otherwise stay on current branch when no --branch.
     const currentFromConfig = opts.useMain || opts.branch != null ? null : getCurrentBranchFromConfig(embeddableId);
@@ -167,8 +176,9 @@ export async function runPull(opts) {
             ? `${effectiveBranchName} (${effectiveBranch})`
             : effectiveBranch
         : 'main';
-    console.log(pc.cyan(`Pulling branch: ${pc.bold(branchLabel)}`));
-    console.log(`Fetching embeddable from ${url}...`);
+    logger.info('pull started', { embeddableId, branch: effectiveBranch ?? 'main' });
+    stdout.print(pc.cyan(`Pulling branch: ${pc.bold(branchLabel)}`));
+    stdout.print(`Fetching embeddable from ${url}...`);
     let pullVersion;
     try {
         // Add authentication header if available
@@ -194,7 +204,7 @@ export async function runPull(opts) {
         fs.mkdirSync(path.dirname(outPath), { recursive: true });
         const flowJson = JSON.stringify(flow, null, 2);
         fs.writeFileSync(outPath, flowJson, 'utf8');
-        console.log(pc.cyan(`✓ Wrote embeddable JSON to ${outPath}`));
+        stdout.print(pc.cyan(`✓ Wrote embeddable JSON to ${outPath}`));
         // Also save version-specific file (e.g. embeddable-main@135.json or embeddable-my_branch@135.json)
         pullVersion =
             data.version ?? data.embeddable_version ?? flow.version;
@@ -205,7 +215,7 @@ export async function runPull(opts) {
             const versionedBasename = getVersionedBasename(versionStr, branchSlug);
             const versionedPath = path.join(path.dirname(outPath), versionedBasename);
             fs.writeFileSync(versionedPath, flowJson, 'utf8');
-            console.log(pc.cyan(`✓ Wrote versioned embeddable JSON to ${versionedPath}`));
+            stdout.print(pc.cyan(`✓ Wrote versioned embeddable JSON to ${versionedPath}`));
         }
         // Persist _version and _branch_id in config.json immediately so they survive reverseCompile
         writePullMetadataToConfig(embeddableId, version, effectiveBranch, effectiveBranchName);
@@ -215,7 +225,7 @@ export async function runPull(opts) {
             const metadataPath = path.join('embeddables', embeddableId, 'metadata.json');
             fs.mkdirSync(path.dirname(metadataPath), { recursive: true });
             fs.writeFileSync(metadataPath, JSON.stringify(metadata, null, 2) + '\n', 'utf8');
-            console.log(pc.cyan(`✓ Wrote flow metadata to ${metadataPath}`));
+            stdout.print(pc.cyan(`✓ Wrote flow metadata to ${metadataPath}`));
         }
         // Clear existing pages, styles, computed-fields, actions, and global-components before generating new ones
         const pagesDir = path.join('embeddables', embeddableId, 'pages');
@@ -228,28 +238,28 @@ export async function runPull(opts) {
             for (const page of existingPages) {
                 fs.unlinkSync(path.join(pagesDir, page));
             }
-            console.log(`${pc.gray(`Cleared ${existingPages.length} existing page(s)`)}`);
+            stdout.print(`${pc.gray(`Cleared ${existingPages.length} existing page(s)`)}`);
         }
         if (fs.existsSync(stylesDir)) {
             const existingStyles = fs.readdirSync(stylesDir).filter((f) => f.endsWith('.css'));
             for (const style of existingStyles) {
                 fs.unlinkSync(path.join(stylesDir, style));
             }
-            console.log(`${pc.gray(`Cleared ${existingStyles.length} existing style file(s)`)}`);
+            stdout.print(`${pc.gray(`Cleared ${existingStyles.length} existing style file(s)`)}`);
         }
         if (fs.existsSync(computedFieldsDir)) {
             const existingFields = fs.readdirSync(computedFieldsDir).filter((f) => f.endsWith('.js'));
             for (const field of existingFields) {
                 fs.unlinkSync(path.join(computedFieldsDir, field));
             }
-            console.log(`${pc.gray(`Cleared ${existingFields.length} existing computed field(s)`)}`);
+            stdout.print(`${pc.gray(`Cleared ${existingFields.length} existing computed field(s)`)}`);
         }
         if (fs.existsSync(actionsDir)) {
             const existingActions = fs.readdirSync(actionsDir).filter((f) => f.endsWith('.js'));
             for (const action of existingActions) {
                 fs.unlinkSync(path.join(actionsDir, action));
             }
-            console.log(`${pc.gray(`Cleared ${existingActions.length} existing action(s)`)}`);
+            stdout.print(`${pc.gray(`Cleared ${existingActions.length} existing action(s)`)}`);
         }
         if (fs.existsSync(globalComponentsDir)) {
             const existingGlobalComponents = fs
@@ -258,7 +268,7 @@ export async function runPull(opts) {
             for (const component of existingGlobalComponents) {
                 fs.unlinkSync(path.join(globalComponentsDir, component));
             }
-            console.log(`${pc.gray(`Cleared ${existingGlobalComponents.length} existing global component(s)`)}`);
+            stdout.print(`${pc.gray(`Cleared ${existingGlobalComponents.length} existing global component(s)`)}`);
         }
         // Run reverse compiler (pass pullMetadata so config.json gets _version and _branch_id even on fix retry)
         const versionNum = version != null && !isNaN(Number(version)) ? Number(version) : undefined;
@@ -278,10 +288,10 @@ export async function runPull(opts) {
         catch (compileError) {
             // If fix mode wasn't already enabled, offer to retry with fix mode
             if (!opts.fix && compileError instanceof Error) {
-                console.log('');
-                console.error(pc.red('Error during reverse compile:'));
-                console.error(pc.yellow(`  ${compileError.message}`));
-                console.log('');
+                stdout.print('');
+                stdout.error(pc.red('Error during reverse compile:'));
+                stdout.error(pc.yellow(`  ${compileError.message}`));
+                stdout.print('');
                 const response = await prompts({
                     type: 'confirm',
                     name: 'fix',
@@ -294,9 +304,9 @@ export async function runPull(opts) {
                 });
                 if (response.fix) {
                     usedFix = true;
-                    console.log('');
-                    console.log(pc.cyan('Retrying with auto-fix enabled...'));
-                    console.log('');
+                    stdout.print('');
+                    stdout.print(pc.cyan('Retrying with auto-fix enabled...'));
+                    stdout.print('');
                     await reverseCompile(flow, embeddableId, {
                         fix: true,
                         preserve: opts.preserve,
@@ -304,7 +314,7 @@ export async function runPull(opts) {
                     });
                 }
                 else {
-                    process.exit(1);
+                    await exit(1);
                 }
             }
             else {
@@ -315,19 +325,22 @@ export async function runPull(opts) {
         if (usedFix) {
             const flowJson = JSON.stringify(flow, null, 2);
             fs.writeFileSync(outPath, flowJson, 'utf8');
-            console.log(pc.cyan(`✓ Wrote embeddable JSON to ${outPath} (with fixes applied)`));
+            stdout.print(pc.cyan(`✓ Wrote embeddable JSON to ${outPath} (with fixes applied)`));
             if (version != null) {
                 const versionStr = typeof version === 'string' ? version : String(version);
                 const versionedBasename = getVersionedBasename(versionStr, branchSlug);
                 const versionedPath = path.join(path.dirname(outPath), versionedBasename);
                 fs.writeFileSync(versionedPath, flowJson, 'utf8');
-                console.log(pc.cyan(`✓ Wrote versioned embeddable JSON to ${versionedPath} (with fixes applied)`));
+                stdout.print(pc.cyan(`✓ Wrote versioned embeddable JSON to ${versionedPath} (with fixes applied)`));
             }
         }
+        logger.info('pull complete', { embeddableId, version: String(pullVersion ?? 'unknown') });
     }
     catch (error) {
-        console.error('Error pulling embeddable:', error);
-        process.exit(1);
+        captureException(error);
+        stdout.error(`Error pulling embeddable: ${error instanceof Error ? error.message : String(error)}`);
+        logger.error('pull failed', { message: error instanceof Error ? error.message : String(error) });
+        await exit(1);
     }
     finally {
         // Always persist _version and _branch_id once we've fetched (so config is correct even if reverseCompile failed or was retried with fix)

package/dist/commands/save.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"save.d.ts","sourceRoot":"","sources":["../../src/commands/save.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAGV,cAAc,EACf,MAAM,qBAAqB,CAAA;AAgC5B,MAAM,MAAM,sBAAsB,GAC9B;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,UAAU,EAAE,OAAO,CAAA;CAAE,CAAA;AAE3B,MAAM,MAAM,2BAA2B,GAAG;IACxC,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iBAAiB,EAAE,MAAM,CAAA;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,uBAAuB,CAAC,EAAE,sBAAsB,EAAE,CAAA;IAClD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,WAAW,CAAC,EAAE,cAAc,EAAE,CAAA;IAC9B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B,CAAA;AAkND,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAClC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,iBAoBA"}
+{"version":3,"file":"save.d.ts","sourceRoot":"","sources":["../../src/commands/save.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAGV,cAAc,EACf,MAAM,qBAAqB,CAAA;AAkC5B,MAAM,MAAM,sBAAsB,GAC9B;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,UAAU,EAAE,OAAO,CAAA;CAAE,CAAA;AAE3B,MAAM,MAAM,2BAA2B,GAAG;IACxC,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iBAAiB,EAAE,MAAM,CAAA;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,uBAAuB,CAAC,EAAE,sBAAsB,EAAE,CAAA;IAClD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,WAAW,CAAC,EAAE,cAAc,EAAE,CAAA;IAC9B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B,CAAA;AAkND,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAClC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,iBAqBA"}