newo 1.5.2 → 1.6.1

package/CHANGELOG.md

@@ -5,6 +5,70 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.6.1] - 2025-09-13
+
+### Fixed
+- **YAML Enum Formatting**: Fixed enum formatting in `flows.yaml` generation to properly handle NEWO enum types
+  - Corrected enum value serialization from quoted strings to proper YAML enum format
+  - Fixed issue where enum values like `!enum "RunnerType.guidance"` were incorrectly quoted
+  - Ensures generated `flows.yaml` files are properly formatted for NEWO platform consumption
+
+### Enhanced
+- **ES Module Support**: Added `"type": "module"` to package.json for proper ES module handling
+  - Resolves Node.js warnings about module type detection
+  - Improves performance by eliminating module type guessing
+  - Ensures consistent ES module behavior across all environments
+
+## [1.6.0] - 2025-09-13
+
+### Added
+- **Multi-Customer Auto-Pull**: Revolutionary workflow improvement for multi-customer environments
+  - `newo pull` now automatically pulls from ALL customers when no default customer is set
+  - Eliminates the need to specify `--customer` flag or set `NEWO_DEFAULT_CUSTOMER` for bulk operations
+  - Maintains backward compatibility - individual customer selection still works with `--customer` flag
+  - Smart detection: single customer setup works as before, multi-customer setup auto-pulls all
+- **Publishing Infrastructure**: Complete automated publishing system for professional releases
+  - `scripts/publish-github.sh`: Automated GitHub publishing with releases, tags, and version management
+  - `scripts/publish-npm.sh`: Automated NPM publishing with validation and safety checks
+  - Comprehensive Makefile with 40+ commands for development and publishing workflows
+  - Version bump helpers (patch/minor/major) with semantic versioning support
+- **Enhanced Documentation**: Professional publishing and development documentation
+  - Complete "Publishing & Release Management" section with step-by-step workflows
+  - "Local Testing" section with comprehensive testing procedures
+  - Makefile command reference with organized development workflows
+  - Troubleshooting guides for common development and publishing issues
+
+### Enhanced
+- **Customer Configuration Logic**: New functions for flexible customer handling
+  - `tryGetDefaultCustomer()`: Non-throwing version that returns null for multi-customer scenarios
+  - `getAllCustomers()`: Returns array of all configured customers for batch operations
+  - Improved error handling and user feedback for customer selection scenarios
+- **CLI User Experience**: Enhanced command behavior and help documentation
+  - Updated help text to reflect auto-pull behavior: "uses default or all for pull"
+  - Clear progress indicators for multi-customer operations
+  - Better error messages and troubleshooting guidance
+- **Development Workflow**: Professional development and publishing infrastructure
+  - Makefile with color-coded output and comprehensive command organization
+  - Automated validation pipelines for publishing (build, test, lint, typecheck)
+  - Publishing scripts with safety checks and rollback procedures
+
+### Changed
+- **Pull Command Behavior**: Breaking change in multi-customer environments (improvement)
+  - Previously: Required explicit customer selection or default customer configuration
+  - Now: Automatically pulls from all customers when no default is set
+  - Single customer setups: No change in behavior
+  - Multi-customer setups: Significantly improved user experience
+- **Help Documentation**: Updated command descriptions and examples
+  - `newo pull` now shows "(all customers if no default)" in help text
+  - Enhanced multi-customer examples with auto-pull scenarios
+  - Updated usage patterns to reflect new workflow capabilities
+
+### Developer Experience
+- **Publishing Automation**: One-command publishing to both GitHub and NPM with full validation
+- **Comprehensive Testing**: Enhanced local testing documentation with step-by-step procedures
+- **Professional Infrastructure**: Industry-standard publishing pipeline with version management
+- **Quality Gates**: Automated validation before publishing (TypeScript, linting, building, package validation)
+
 ## [1.5.2] - 2025-01-15
 
 ### Enhanced

package/README.md

@@ -25,7 +25,7 @@ Mirror NEWO "Project → Agent → Flow → Skills" structure to local files wit
 
 **Option 1: Global Installation (Recommended)**
 ```bash
-npm install -g newo
+npm install -g newo@latest
 ```
 
 **Option 2: Local Project Installation**
@@ -127,7 +127,7 @@ NEWO_REFRESH_URL=custom_refresh_endpoint   # Custom refresh endpoint
 
 | Command | Description | Examples |
 |---------|-------------|----------|
-| `newo pull` | Download projects from NEWO | `newo pull`<br>`newo pull --customer=ACME`<br>`newo pull --project=uuid` |
+| `newo pull` | Download projects from NEWO | `newo pull` (all customers if no default)<br>`newo pull --customer=ACME`<br>`newo pull --project=uuid` |
 | `newo push` | Upload local changes to NEWO | `newo push`<br>`newo push --customer=BETA` |
 | `newo status` | Show modified files | `newo status`<br>`newo status --verbose` |
 | `newo list-customers` | List configured customers | `newo list-customers` |
@@ -146,8 +146,8 @@ newo pull --customer=NEWO_ABC123
 # Push changes to specific customer
 newo push --customer=NEWO_XYZ789
 
-# Work with default customer (all projects)
-newo pull    # Uses default or prompts for selection
+# Work with default customer (or auto multi-customer)
+newo pull    # Uses default customer OR pulls from all customers if no default set
 newo push    # Pushes to appropriate customers based on file origin
 ```
 
@@ -493,6 +493,176 @@ npm run dev push    # Build and run push
 | `npm run test:unit` | Run unit tests only |
 | `npm run test:coverage` | Generate coverage report |
 
+### Makefile Commands
+
+The project includes a comprehensive Makefile for streamlined development:
+
+#### Quick Commands
+```bash
+make help           # Show all available commands
+make setup          # Initial project setup
+make build          # Build TypeScript
+make test           # Run tests
+make dev            # Development mode
+make publish        # Publish to GitHub and NPM
+```
+
+#### Development Workflow
+```bash
+make fresh-start    # Clean + install + build + test
+make dev-pull       # Test pull command in development
+make dev-push       # Test push command in development
+make test-local     # Comprehensive local testing
+```
+
+#### Publishing Workflow
+```bash
+make pre-publish    # Complete validation before publishing
+make publish-github # Publish to GitHub with release
+make publish-npm    # Publish to NPM
+make publish        # Publish to both platforms
+```
+
+#### Quality Assurance
+```bash
+make typecheck      # TypeScript type checking
+make lint           # Code linting
+make check-all      # All quality checks
+make deps-audit     # Security audit
+```
+
+### Local Testing
+
+After making changes to the CLI code, proper testing is essential to ensure functionality works correctly.
+
+#### Quick Testing Commands
+
+```bash
+# Build and test core functionality
+npm run build                                    # Compile TypeScript
+node ./dist/cli.js --help                       # Test CLI loads correctly
+node ./dist/cli.js list-customers                # Test customer configuration
+
+# Test single customer operations
+node ./dist/cli.js pull --customer=CUSTOMER_IDN  # Test specific customer pull
+node ./dist/cli.js status --customer=CUSTOMER_IDN # Test specific customer status
+
+# Test multi-customer operations (if multiple API keys configured)
+node ./dist/cli.js pull                          # Test auto multi-customer pull
+node ./dist/cli.js pull --verbose                # Test with detailed logging
+```
+
+#### Complete Testing Workflow
+
+1. **Environment Setup**
+   ```bash
+   # Ensure clean environment
+   cp .env.example .env
+   # Edit .env with your API key(s)
+   ```
+
+2. **Build & Syntax Check**
+   ```bash
+   npm run build              # Must complete without TypeScript errors
+   npm run typecheck          # Verify type safety
+   ```
+
+3. **Basic CLI Tests**
+   ```bash
+   node ./dist/cli.js --help                    # Should show updated help text
+   node ./dist/cli.js list-customers            # Should show configured customers
+   ```
+
+4. **Authentication Tests**
+   ```bash
+   # Test API key exchange and token generation
+   node ./dist/cli.js meta --verbose            # Forces authentication
+   ```
+
+5. **Pull Operation Tests**
+   ```bash
+   # Single customer (if specific customer configured)
+   node ./dist/cli.js pull --customer=YOUR_CUSTOMER_IDN --verbose
+
+   # Multi-customer (if multiple API keys configured)
+   node ./dist/cli.js pull --verbose            # Should pull from all customers
+
+   # Check file structure was created correctly
+   ls -la newo_customers/                       # Should show customer folders
+   ```
+
+6. **Status & Push Tests**
+   ```bash
+   node ./dist/cli.js status --verbose          # Should show no changes initially
+
+   # Make a test change to a .guidance or .jinja file
+   echo "# Test comment" >> newo_customers/*/projects/*/*/*/*.guidance
+
+   node ./dist/cli.js status                    # Should detect the change
+   node ./dist/cli.js push --verbose            # Should upload the change
+   ```
+
+#### Testing Multi-Customer Functionality
+
+If you have multiple API keys configured, test the new auto-pull behavior:
+
+```bash
+# Test that pull works without specifying customer
+node ./dist/cli.js pull                          # Should pull from ALL customers
+
+# Test individual customer selection still works
+node ./dist/cli.js pull --customer=CUSTOMER_A    # Should pull from specific customer
+node ./dist/cli.js push --customer=CUSTOMER_B    # Should push to specific customer
+```
+
+#### Common Testing Issues & Solutions
+
+**Issue: "Multiple customers configured but no default specified" error**
+- **Cause**: You're using `npx newo` instead of the local build
+- **Solution**: Use `node ./dist/cli.js` instead of `npx newo`
+
+**Issue: Changes not reflected in CLI behavior**
+- **Cause**: TypeScript not compiled or using cached version
+- **Solution**: Run `npm run build` first, then test with `node ./dist/cli.js`
+
+**Issue: Authentication errors during testing**
+- **Cause**: Invalid API keys or network issues
+- **Solution**: Verify API keys in `.env`, test with `--verbose` flag for details
+
+**Issue: File permission errors**
+- **Cause**: Insufficient permissions in project directory
+- **Solution**: Ensure write permissions: `chmod 755 .` and check disk space
+
+#### Performance Testing
+
+For testing with large projects or multiple customers:
+
+```bash
+# Test with timeout to avoid hanging
+timeout 30s node ./dist/cli.js pull --verbose   # Should complete or show progress
+
+# Test memory usage
+node --max-old-space-size=512 ./dist/cli.js pull # Test with limited memory
+```
+
+#### Integration Testing
+
+Test complete workflows that users would actually perform:
+
+```bash
+# Complete development workflow
+node ./dist/cli.js pull                          # Download latest
+# Edit some .guidance/.jinja files
+node ./dist/cli.js status                        # Check changes
+node ./dist/cli.js push                          # Upload changes
+
+# Multi-customer workflow
+node ./dist/cli.js list-customers                # See available customers
+node ./dist/cli.js pull --customer=CUSTOMER_A    # Work with specific customer
+# Make changes
+node ./dist/cli.js push --customer=CUSTOMER_A    # Push to specific customer
+```
+
 ### Project Architecture
 
 ```
@@ -535,6 +705,157 @@ NEWO CLI includes comprehensive test coverage:
 
 ---
 
+## Publishing & Release Management
+
+The project includes automated scripts for publishing to GitHub and NPM with proper validation and release management.
+
+### Prerequisites for Publishing
+
+1. **GitHub Setup**
+   ```bash
+   # Ensure GitHub remote is configured
+   git remote -v  # Should show origin pointing to sabbah13/newo-cli
+
+   # Install GitHub CLI (optional, for automatic releases)
+   brew install gh  # macOS
+   # or
+   sudo apt install gh  # Ubuntu
+   ```
+
+2. **NPM Setup**
+   ```bash
+   # Login to NPM
+   npm login
+   npm whoami  # Verify you're logged in
+   ```
+
+### Publishing Workflow
+
+#### Option 1: Full Automated Publishing (Recommended)
+```bash
+# Complete validation and publish to both platforms
+make publish
+```
+
+This command will:
+- Run all tests and quality checks
+- Build the project
+- Prompt for version bump (patch/minor/major)
+- Publish to GitHub with release notes
+- Publish to NPM with proper tags
+- Verify publication success
+
+#### Option 2: Step-by-Step Publishing
+```bash
+# 1. Validate everything is ready
+make pre-publish
+
+# 2. Publish to GitHub first
+make publish-github
+
+# 3. Publish to NPM
+make publish-npm
+```
+
+#### Option 3: Manual Publishing
+```bash
+# Run individual scripts
+./scripts/publish-github.sh
+./scripts/publish-npm.sh
+```
+
+### Version Management
+
+Use semantic versioning with the Makefile helpers:
+
+```bash
+make version-patch  # 1.5.2 → 1.5.3 (bug fixes)
+make version-minor  # 1.5.2 → 1.6.0 (new features)
+make version-major  # 1.5.2 → 2.0.0 (breaking changes)
+```
+
+### Pre-Release Publishing
+
+For beta/alpha releases:
+```bash
+# Set pre-release version manually
+npm version 1.6.0-beta.1 --no-git-tag-version
+
+# Publish with beta tag
+make publish-npm  # Automatically detects pre-release and uses beta tag
+```
+
+### Publishing Checklist
+
+Before publishing, ensure:
+- ✅ All tests pass (`make test`)
+- ✅ TypeScript compiles without errors (`make build`)
+- ✅ Local testing completed (`make test-local`)
+- ✅ Documentation is up to date
+- ✅ CHANGELOG.md is updated (if exists)
+- ✅ Version number is appropriate
+- ✅ No uncommitted changes (or committed)
+
+### Automated Validation
+
+The publish scripts include comprehensive validation:
+- **TypeScript compilation** and type checking
+- **Test suite execution** with coverage requirements
+- **Package size analysis** and content verification
+- **Authentication verification** for GitHub and NPM
+- **Version conflict detection** to prevent duplicate publishes
+- **Security audit** of dependencies
+
+### GitHub Release Features
+
+The GitHub publish script automatically:
+- Creates semantic version tags (`v1.5.3`)
+- Generates comprehensive release notes
+- Marks releases as "latest" on GitHub
+- Links to NPM package and documentation
+- Includes installation instructions
+
+### NPM Package Features
+
+The NPM publish script ensures:
+- Proper package.json validation
+- Binary CLI availability verification
+- File inclusion/exclusion validation
+- Pre-release tag detection (`beta`, `alpha`, `rc`)
+- Post-publish verification
+
+### Rollback Procedures
+
+If issues are discovered after publishing:
+
+**NPM Rollback:**
+```bash
+# Deprecate problematic version
+npm deprecate newo@1.5.3 "Version has known issues, use 1.5.2 instead"
+
+# Publish fixed version immediately
+make version-patch
+make publish-npm
+```
+
+**GitHub Rollback:**
+```bash
+# Delete tag and release (if needed)
+git tag -d v1.5.3
+git push origin :refs/tags/v1.5.3
+gh release delete v1.5.3
+```
+
+### Monitoring Post-Publication
+
+After publishing, monitor:
+- **NPM downloads**: https://npmjs.com/package/newo
+- **GitHub releases**: https://github.com/sabbah13/newo-cli/releases
+- **Issue reports**: https://github.com/sabbah13/newo-cli/issues
+- **Badge updates**: README badges should reflect new version
+
+---
+
 ## Contributing
 
 We welcome contributions to NEWO CLI! Here's how to get involved:

package/dist/cli.js

@@ -5,7 +5,7 @@ import { makeClient, getProjectMeta, importAkbArticle } from './api.js';
 import { pullAll, pushChanged, status } from './sync.js';
 import { parseAkbFile, prepareArticlesForImport } from './akb.js';
 import { initializeEnvironment, ENV, EnvValidationError } from './env.js';
-import { parseCustomerConfigAsync, listCustomers, getCustomer, getDefaultCustomer, validateCustomerConfig } from './customerAsync.js';
+import { parseCustomerConfigAsync, listCustomers, getCustomer, getDefaultCustomer, tryGetDefaultCustomer, getAllCustomers, validateCustomerConfig } from './customerAsync.js';
 import { getValidAccessToken } from './auth.js';
 import path from 'path';
 // Enhanced error logging for CLI
@@ -126,7 +126,7 @@ async function main() {
     const args = minimist(process.argv.slice(2));
     const cmd = args._[0];
     const verbose = Boolean(args.verbose || args.v);
-    // Parse customer configuration (async for API key array support)  
+    // Parse customer configuration (async for API key array support)
     let customerConfig;
     try {
         customerConfig = await parseCustomerConfigAsync(ENV, verbose);
@@ -140,7 +140,8 @@ async function main() {
         process.exit(1);
     }
     // Handle customer selection
-    let selectedCustomer;
+    let selectedCustomer = null;
+    let allCustomers = [];
     if (cmd === 'list-customers') {
         const customers = listCustomers(customerConfig);
         console.log('Available customers:');
@@ -160,13 +161,33 @@ async function main() {
         selectedCustomer = customer;
     }
     else {
-        try {
-            selectedCustomer = getDefaultCustomer(customerConfig);
+        // For pull command, try to get default but fall back to all customers if multiple exist
+        if (cmd === 'pull') {
+            try {
+                selectedCustomer = tryGetDefaultCustomer(customerConfig);
+                if (!selectedCustomer) {
+                    // Multiple customers exist with no default, pull from all
+                    allCustomers = getAllCustomers(customerConfig);
+                    if (verbose)
+                        console.log(`📥 No default customer specified, pulling from all ${allCustomers.length} customers`);
+                }
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                console.error(message);
+                process.exit(1);
+            }
         }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            console.error(message);
-            process.exit(1);
+        else {
+            // For other commands, require explicit customer selection
+            try {
+                selectedCustomer = getDefaultCustomer(customerConfig);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                console.error(message);
+                process.exit(1);
+            }
         }
     }
     if (!cmd || ['help', '-h', '--help'].includes(cmd)) {
@@ -178,28 +199,29 @@ Usage:
   newo list-customers                           # list available customers
   newo meta [--customer <idn>]                  # get project metadata (debug)
   newo import-akb <file> <persona_id> [--customer <idn>]  # import AKB articles from file
-  
+
 Flags:
-  --customer <idn>             # specify customer (if not set, uses default)
+  --customer <idn>             # specify customer (if not set, uses default or all for pull)
   --verbose, -v                # enable detailed logging
-  
+
 Environment Variables:
   NEWO_BASE_URL                                 # NEWO API base URL (default: https://app.newo.ai)
   NEWO_CUSTOMER_<IDN>_API_KEY                   # API key for customer <IDN>
   NEWO_CUSTOMER_<IDN>_PROJECT_ID               # Optional: specific project ID for customer
   NEWO_DEFAULT_CUSTOMER                        # Optional: default customer to use
-  
+
 Multi-Customer Examples:
   # Configure customers in .env:
   NEWO_CUSTOMER_acme_API_KEY=your_acme_api_key
   NEWO_CUSTOMER_globex_API_KEY=your_globex_api_key
   NEWO_DEFAULT_CUSTOMER=acme
-  
+
   # Commands:
-  newo pull --customer acme                    # Pull projects for Acme
+  newo pull                                    # Pull from all customers (if no default set)
+  newo pull --customer acme                    # Pull projects for Acme only
   newo push --customer globex                  # Push changes for Globex
   newo status                                  # Status for default customer
-  
+
 File Structure:
   newo_customers/
   ├── acme/
@@ -211,15 +233,37 @@ File Structure:
 `);
         return;
     }
+    if (cmd === 'pull') {
+        if (selectedCustomer) {
+            // Single customer pull
+            const accessToken = await getValidAccessToken(selectedCustomer);
+            const client = await makeClient(verbose, accessToken);
+            const projectId = selectedCustomer.projectId || null;
+            await pullAll(client, selectedCustomer, projectId, verbose);
+        }
+        else if (allCustomers.length > 0) {
+            // Multi-customer pull
+            console.log(`🔄 Pulling from ${allCustomers.length} customers...`);
+            for (const customer of allCustomers) {
+                console.log(`\n📥 Pulling from customer: ${customer.idn}`);
+                const accessToken = await getValidAccessToken(customer);
+                const client = await makeClient(verbose, accessToken);
+                const projectId = customer.projectId || null;
+                await pullAll(client, customer, projectId, verbose);
+            }
+            console.log(`\n✅ Pull completed for all ${allCustomers.length} customers`);
+        }
+        return;
+    }
+    // For all other commands, require a single selected customer
+    if (!selectedCustomer) {
+        console.error('Customer selection required for this command');
+        process.exit(1);
+    }
     // Get access token for the selected customer
     const accessToken = await getValidAccessToken(selectedCustomer);
     const client = await makeClient(verbose, accessToken);
-    if (cmd === 'pull') {
-        // Use customer-specific project ID if set, otherwise pull all projects
-        const projectId = selectedCustomer.projectId || null;
-        await pullAll(client, selectedCustomer, projectId, verbose);
-    }
-    else if (cmd === 'push') {
+    if (cmd === 'push') {
         await pushChanged(client, selectedCustomer, verbose);
     }
     else if (cmd === 'status') {

package/dist/customerAsync.d.ts

@@ -15,6 +15,14 @@ export declare function getCustomer(config: MultiCustomerConfig, customerIdn: st
  * Get default customer or throw error if none
  */
 export declare function getDefaultCustomer(config: MultiCustomerConfig): CustomerConfig;
+/**
+ * Attempt to get default customer, return null if multiple customers exist without default
+ */
+export declare function tryGetDefaultCustomer(config: MultiCustomerConfig): CustomerConfig | null;
+/**
+ * Get all customers as an array
+ */
+export declare function getAllCustomers(config: MultiCustomerConfig): CustomerConfig[];
 /**
  * Validate customer configuration
  */

package/dist/customerAsync.js

@@ -49,6 +49,34 @@ export function getDefaultCustomer(config) {
     throw new Error(`Multiple customers configured but no default specified. Available: ${customerIdns.join(', ')}. ` +
         `Set NEWO_DEFAULT_CUSTOMER or use --customer flag.`);
 }
+/**
+ * Attempt to get default customer, return null if multiple customers exist without default
+ */
+export function tryGetDefaultCustomer(config) {
+    if (config.defaultCustomer) {
+        const customer = getCustomer(config, config.defaultCustomer);
+        if (customer)
+            return customer;
+    }
+    const customerIdns = listCustomers(config);
+    if (customerIdns.length === 1) {
+        const firstCustomerIdn = customerIdns[0];
+        if (firstCustomerIdn) {
+            return config.customers[firstCustomerIdn];
+        }
+    }
+    if (customerIdns.length === 0) {
+        throw new Error('No customers configured. Please set NEWO_API_KEYS or NEWO_CUSTOMER_[IDN]_API_KEY in your .env file.');
+    }
+    // Return null if multiple customers exist without default (don't throw)
+    return null;
+}
+/**
+ * Get all customers as an array
+ */
+export function getAllCustomers(config) {
+    return listCustomers(config).map(idn => getCustomer(config, idn));
+}
 /**
  * Validate customer configuration
  */

package/dist/sync.js

@@ -368,7 +368,7 @@ async function generateFlowsYaml(client, customer, agents, verbose = false) {
         forceQuotes: false
     });
     // Post-process to fix enum formatting
-    yamlContent = yamlContent.replace(/"(!enum "[^"]+")"/g, '$1');
+    yamlContent = yamlContent.replace(/"(!enum \\"([^"]+)\\")"/g, '!enum "$2"');
     const yamlPath = flowsYamlPath(customer.idn);
     await writeFileSafe(yamlPath, yamlContent);
     console.log(`✓ Generated flows.yaml`);

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "newo",
-  "version": "1.5.2",
+  "version": "1.6.1",
   "description": "NEWO CLI: sync AI Agent skills between NEWO platform and local files. Multi-customer workspaces, Git-first workflows, comprehensive project management.",
+  "type": "module",
   "bin": {
     "newo": "dist/cli.js"
   },

package/src/cli.ts

@@ -5,7 +5,7 @@ import { makeClient, getProjectMeta, importAkbArticle } from './api.js';
 import { pullAll, pushChanged, status } from './sync.js';
 import { parseAkbFile, prepareArticlesForImport } from './akb.js';
 import { initializeEnvironment, ENV, EnvValidationError } from './env.js';
-import { parseCustomerConfigAsync, listCustomers, getCustomer, getDefaultCustomer, validateCustomerConfig } from './customerAsync.js';
+import { parseCustomerConfigAsync, listCustomers, getCustomer, getDefaultCustomer, tryGetDefaultCustomer, getAllCustomers, validateCustomerConfig } from './customerAsync.js';
 import { getValidAccessToken } from './auth.js';
 import path from 'path';
 import type { CliArgs, NewoApiError, CustomerConfig } from './types.js';
@@ -131,7 +131,7 @@ async function main(): Promise<void> {
   const cmd = args._[0];
   const verbose = Boolean(args.verbose || args.v);
   
-  // Parse customer configuration (async for API key array support)  
+  // Parse customer configuration (async for API key array support)
   let customerConfig;
   try {
     customerConfig = await parseCustomerConfigAsync(ENV as any, verbose);
@@ -145,8 +145,9 @@ async function main(): Promise<void> {
   }
   
   // Handle customer selection
-  let selectedCustomer: CustomerConfig;
-  
+  let selectedCustomer: CustomerConfig | null = null;
+  let allCustomers: CustomerConfig[] = [];
+
   if (cmd === 'list-customers') {
     const customers = listCustomers(customerConfig);
     console.log('Available customers:');
@@ -156,7 +157,7 @@ async function main(): Promise<void> {
     }
     return;
   }
-  
+
   if (args.customer) {
     const customer = getCustomer(customerConfig, args.customer as string);
     if (!customer) {
@@ -166,12 +167,29 @@ async function main(): Promise<void> {
     }
     selectedCustomer = customer;
   } else {
-    try {
-      selectedCustomer = getDefaultCustomer(customerConfig);
-    } catch (error: unknown) {
-      const message = error instanceof Error ? error.message : String(error);
-      console.error(message);
-      process.exit(1);
+    // For pull command, try to get default but fall back to all customers if multiple exist
+    if (cmd === 'pull') {
+      try {
+        selectedCustomer = tryGetDefaultCustomer(customerConfig);
+        if (!selectedCustomer) {
+          // Multiple customers exist with no default, pull from all
+          allCustomers = getAllCustomers(customerConfig);
+          if (verbose) console.log(`📥 No default customer specified, pulling from all ${allCustomers.length} customers`);
+        }
+      } catch (error: unknown) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(message);
+        process.exit(1);
+      }
+    } else {
+      // For other commands, require explicit customer selection
+      try {
+        selectedCustomer = getDefaultCustomer(customerConfig);
+      } catch (error: unknown) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(message);
+        process.exit(1);
+      }
     }
   }
 
@@ -184,28 +202,29 @@ Usage:
   newo list-customers                           # list available customers
   newo meta [--customer <idn>]                  # get project metadata (debug)
   newo import-akb <file> <persona_id> [--customer <idn>]  # import AKB articles from file
-  
+
 Flags:
-  --customer <idn>             # specify customer (if not set, uses default)
+  --customer <idn>             # specify customer (if not set, uses default or all for pull)
   --verbose, -v                # enable detailed logging
-  
+
 Environment Variables:
   NEWO_BASE_URL                                 # NEWO API base URL (default: https://app.newo.ai)
   NEWO_CUSTOMER_<IDN>_API_KEY                   # API key for customer <IDN>
   NEWO_CUSTOMER_<IDN>_PROJECT_ID               # Optional: specific project ID for customer
   NEWO_DEFAULT_CUSTOMER                        # Optional: default customer to use
-  
+
 Multi-Customer Examples:
   # Configure customers in .env:
   NEWO_CUSTOMER_acme_API_KEY=your_acme_api_key
   NEWO_CUSTOMER_globex_API_KEY=your_globex_api_key
   NEWO_DEFAULT_CUSTOMER=acme
-  
+
   # Commands:
-  newo pull --customer acme                    # Pull projects for Acme
+  newo pull                                    # Pull from all customers (if no default set)
+  newo pull --customer acme                    # Pull projects for Acme only
   newo push --customer globex                  # Push changes for Globex
   newo status                                  # Status for default customer
-  
+
 File Structure:
   newo_customers/
   ├── acme/
@@ -218,15 +237,39 @@ File Structure:
     return;
   }
 
+  if (cmd === 'pull') {
+    if (selectedCustomer) {
+      // Single customer pull
+      const accessToken = await getValidAccessToken(selectedCustomer);
+      const client = await makeClient(verbose, accessToken);
+      const projectId = selectedCustomer.projectId || null;
+      await pullAll(client, selectedCustomer, projectId, verbose);
+    } else if (allCustomers.length > 0) {
+      // Multi-customer pull
+      console.log(`🔄 Pulling from ${allCustomers.length} customers...`);
+      for (const customer of allCustomers) {
+        console.log(`\n📥 Pulling from customer: ${customer.idn}`);
+        const accessToken = await getValidAccessToken(customer);
+        const client = await makeClient(verbose, accessToken);
+        const projectId = customer.projectId || null;
+        await pullAll(client, customer, projectId, verbose);
+      }
+      console.log(`\n✅ Pull completed for all ${allCustomers.length} customers`);
+    }
+    return;
+  }
+
+  // For all other commands, require a single selected customer
+  if (!selectedCustomer) {
+    console.error('Customer selection required for this command');
+    process.exit(1);
+  }
+
   // Get access token for the selected customer
   const accessToken = await getValidAccessToken(selectedCustomer);
   const client = await makeClient(verbose, accessToken);
 
-  if (cmd === 'pull') {
-    // Use customer-specific project ID if set, otherwise pull all projects
-    const projectId = selectedCustomer.projectId || null;
-    await pullAll(client, selectedCustomer, projectId, verbose);
-  } else if (cmd === 'push') {
+  if (cmd === 'push') {
     await pushChanged(client, selectedCustomer, verbose);
   } else if (cmd === 'status') {
     await status(selectedCustomer, verbose);

package/src/customerAsync.ts

@@ -40,7 +40,7 @@ export function getDefaultCustomer(config: MultiCustomerConfig): CustomerConfig
     const customer = getCustomer(config, config.defaultCustomer);
     if (customer) return customer;
   }
-  
+
   const customerIdns = listCustomers(config);
   if (customerIdns.length === 1) {
     const firstCustomerIdn = customerIdns[0];
@@ -48,17 +48,49 @@ export function getDefaultCustomer(config: MultiCustomerConfig): CustomerConfig
       return config.customers[firstCustomerIdn]!;
     }
   }
-  
+
   if (customerIdns.length === 0) {
     throw new Error('No customers configured. Please set NEWO_API_KEYS or NEWO_CUSTOMER_[IDN]_API_KEY in your .env file.');
   }
-  
+
   throw new Error(
     `Multiple customers configured but no default specified. Available: ${customerIdns.join(', ')}. ` +
     `Set NEWO_DEFAULT_CUSTOMER or use --customer flag.`
   );
 }
 
+/**
+ * Attempt to get default customer, return null if multiple customers exist without default
+ */
+export function tryGetDefaultCustomer(config: MultiCustomerConfig): CustomerConfig | null {
+  if (config.defaultCustomer) {
+    const customer = getCustomer(config, config.defaultCustomer);
+    if (customer) return customer;
+  }
+
+  const customerIdns = listCustomers(config);
+  if (customerIdns.length === 1) {
+    const firstCustomerIdn = customerIdns[0];
+    if (firstCustomerIdn) {
+      return config.customers[firstCustomerIdn]!;
+    }
+  }
+
+  if (customerIdns.length === 0) {
+    throw new Error('No customers configured. Please set NEWO_API_KEYS or NEWO_CUSTOMER_[IDN]_API_KEY in your .env file.');
+  }
+
+  // Return null if multiple customers exist without default (don't throw)
+  return null;
+}
+
+/**
+ * Get all customers as an array
+ */
+export function getAllCustomers(config: MultiCustomerConfig): CustomerConfig[] {
+  return listCustomers(config).map(idn => getCustomer(config, idn)!);
+}
+
 /**
  * Validate customer configuration
  */

package/src/sync.ts

@@ -439,7 +439,7 @@ async function generateFlowsYaml(
   });
   
   // Post-process to fix enum formatting
-  yamlContent = yamlContent.replace(/"(!enum "[^"]+")"/g, '$1');
+  yamlContent = yamlContent.replace(/"(!enum \\"([^"]+)\\")"/g, '!enum "$2"');
   
   const yamlPath = flowsYamlPath(customer.idn);
   await writeFileSafe(yamlPath, yamlContent);