newo 3.4.1 → 3.6.0

package/src/cli/commands/export.ts

@@ -0,0 +1,78 @@
+/**
+ * Export command handler - downloads V2 bulk export ZIP from platform
+ *
+ * Usage:
+ *   newo export                           # Export to temp/export-{customerIdn}-{timestamp}.zip
+ *   newo export --output my-export.zip    # Export to specific file
+ *   newo export --no-akb                  # Exclude AKB from export
+ *   newo export --no-attributes           # Exclude customer attributes
+ */
+import { makeClient, exportCustomerV2 } from '../../api.js';
+import { getValidAccessToken } from '../../auth.js';
+import { selectSingleCustomer } from '../customer-selection.js';
+import fs from 'fs-extra';
+import path from 'path';
+import type { MultiCustomerConfig, CliArgs } from '../../types.js';
+
+export async function handleExportCommand(
+  customerConfig: MultiCustomerConfig,
+  args: CliArgs,
+  verbose: boolean
+): Promise<void> {
+  const { selectedCustomer } = selectSingleCustomer(
+    customerConfig,
+    args.customer as string | undefined
+  );
+
+  if (!selectedCustomer) {
+    console.error('Please specify a customer with --customer');
+    process.exit(1);
+  }
+
+  const accessToken = await getValidAccessToken(selectedCustomer);
+  const client = await makeClient(verbose, accessToken);
+
+  // Get customer ID from token (needed for V2 export API)
+  const customerId = await getCustomerIdFromToken(accessToken);
+  if (!customerId) {
+    console.error('Could not determine customer ID from token');
+    process.exit(1);
+  }
+
+  const exportAkb = !args['no-akb'];
+  const exportAttributes = !args['no-attributes'];
+
+  console.log(`Downloading V2 export for customer ${selectedCustomer.idn}...`);
+
+  const zipBuffer = await exportCustomerV2(client, customerId, {
+    export_akb: exportAkb,
+    export_customer_attributes: exportAttributes,
+  });
+
+  // Determine output path
+  const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+  const defaultName = `export-${selectedCustomer.idn}-${timestamp}.zip`;
+  const outputPath = (args.output as string | undefined) || (args.o as string | undefined)
+    || path.join(process.cwd(), 'temp', defaultName);
+
+  await fs.ensureDir(path.dirname(outputPath));
+  await fs.writeFile(outputPath, zipBuffer);
+
+  console.log(`Exported ${(zipBuffer.length / 1024 / 1024).toFixed(1)}MB to ${outputPath}`);
+}
+
+/**
+ * Extract customer_id from JWT token payload
+ */
+function getCustomerIdFromToken(token: string): string | null {
+  try {
+    const parts = token.split('.');
+    if (parts.length < 2) return null;
+    const payload = parts[1]!;
+    const padded = payload + '='.repeat(4 - (payload.length % 4));
+    const decoded = JSON.parse(Buffer.from(padded, 'base64').toString('utf8')) as Record<string, unknown>;
+    return (decoded['customer_id'] as string) || (decoded['sub'] as string) || null;
+  } catch {
+    return null;
+  }
+}

package/src/cli/commands/help.ts

@@ -7,19 +7,20 @@ export function handleHelpCommand(): void {
 A professional command-line tool for NEWO AI Agent development with modular architecture and comprehensive multi-customer support.
 
 Core Commands:
-  newo pull [--customer <idn>]                  # download projects + attributes -> ./newo_customers/<idn>/
-  newo push [--customer <idn>] [--no-publish]    # upload modified *.guidance/*.jinja + attributes back to NEWO, publish flows by default
-  newo status [--customer <idn>]                # show modified files that would be pushed
-  newo watch [--customer <idn>]                 # watch for file changes and auto-push (NEW)
-  newo diff [--customer <idn>]                  # show differences between local and remote (NEW)
-  newo logs [--customer <idn>]                  # fetch and display analytics logs from platform (NEW)
-  newo conversations [--customer <idn>] [--all] # download user conversations -> ./newo_customers/<idn>/conversations.yaml
+  newo pull [--customer <idn>] [--format <fmt>]  # download projects + attributes + libraries
+  newo push [--customer <idn>] [--format <fmt>]  # upload modified skills + attributes, publish flows
+  newo status [--customer <idn>] [--format <fmt>] # show modified files that would be pushed
+  newo export [--customer <idn>] [--output <file>] # download V2 bulk export ZIP from platform
+  newo watch [--customer <idn>]                 # watch for file changes and auto-push
+  newo diff [--customer <idn>]                  # show differences between local and remote
+  newo logs [--customer <idn>]                  # fetch and display analytics logs from platform
+  newo conversations [--customer <idn>] [--all] # download user conversations -> conversations.yaml
   newo sandbox "<message>" [--customer <idn>]   # test agent in sandbox - single message mode
-  newo sandbox --actor <id> "message"           # continue existing sandbox conversation with chat ID
+  newo sandbox --actor <id> "message"           # continue existing sandbox conversation
   newo pull-attributes [--customer <idn>]       # download customer + project attributes
-  newo list-customers                           # list available customers and their configuration
-  newo meta [--customer <idn>]                  # get project metadata (debug command)
-  newo import-akb <file> <persona_id> [--customer <idn>]  # import AKB articles from structured text file
+  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
 
 Project Management:
   newo create-project <idn> [--title <title>] [--description <desc>] [--version <version>] [--auto-update]  # create empty project on platform
@@ -75,6 +76,7 @@ Account & Customer Management:
 
 Flags:
   --customer <idn>             # specify customer (if not set, uses default or interactive selection)
+  --format <cli_v1|newo_v2>    # project format (auto-detected from filesystem, or set NEWO_FORMAT in .env)
   --all                        # include all available data (for conversations: all personas and acts)
   --force, -f                  # force overwrite without prompting (for pull command)
   --verbose, -v                # enable detailed logging and progress information
@@ -82,6 +84,7 @@ Flags:
   --actor <id>                 # continue existing sandbox chat with actor/chat ID
   --confirm                    # confirm destructive operations without prompting
   --no-publish                 # skip automatic flow publishing during push operations
+  --output, -o <file>          # output file path (for export command)
 
 Selective Sync Flags (NEW):
   --only <resources>           # sync only specified resources (comma-separated)
@@ -99,6 +102,7 @@ Selective Sync Flags (NEW):
 
 Environment Variables:
   NEWO_BASE_URL                                 # NEWO API base URL (default: https://app.newo.ai)
+  NEWO_FORMAT                                   # Default format for new pulls: cli_v1 (default) or newo_v2
 
 Single Customer:
   NEWO_API_KEY                                  # API key for single customer setup
@@ -200,37 +204,45 @@ Usage Examples:
   newo create-customer "Test Co" --email test@test.com --status temporal  # Temporal (trial) customer
   newo create-customer "Partner" --email p@p.com --project nac_integration --auto-update  # With project template
 
-File Structure:
-  newo_customers/
-  ├── <customer-idn>/
-  │   ├── attributes.yaml                      # Customer attributes (pull-attributes)
-  │   ├── conversations.yaml                   # User conversations and personas
-  │   ├── akb/                                 # AKB knowledge base articles (pull-akb)
-  │   │   └── <agent-idn>.yaml                # AKB articles per agent persona
-  │   ├── integrations/                        # Integration configurations (pull-integrations)
-  │   │   ├── integrations.yaml               # Master integrations list
-  │   │   └── <integration-idn>/
-  │   │       ├── <integration-idn>.yaml      # Integration metadata + settings (combined)
-  │   │       └── connectors/
-  │   │           └── <connector-idn>/        # Each connector in own directory
-  │   │               ├── <connector-idn>.yaml  # Connector config
-  │   │               └── webhooks/           # Webhooks subdirectory (if any)
-  │   │                   ├── outgoing.yaml   # Outgoing webhooks
-  │   │                   └── incoming.yaml   # Incoming webhooks
-  │   └── projects/
-  │       └── <project-idn>/
-  │           ├── attributes.yaml              # Project attributes (pull-attributes)
-  │           ├── flows.yaml                   # Auto-generated project structure
-  │           ├── metadata.yaml                # Project metadata
-  │           └── <agent-idn>/
-  │               ├── metadata.yaml            # Agent metadata
-  │               └── <flow-idn>/
-  │                   ├── metadata.yaml        # Flow metadata
-  │                   └── <skill-idn>/
-  │                       ├── skill.guidance   # AI guidance scripts
-  │                       ├── skill.jinja      # NSL/Jinja template scripts
-  │                       └── metadata.yaml    # Skill metadata
-  └── .newo/                                   # CLI state and mappings (auto-generated)
+File Structure (cli_v1 - default):
+  newo_customers/<customer-idn>/
+  ├── attributes.yaml                        # Customer attributes
+  ├── conversations.yaml                     # User conversations
+  ├── akb/<agent-idn>.yaml                   # AKB knowledge base
+  ├── integrations/                          # Integration configurations
+  └── projects/<project-idn>/
+      ├── metadata.yaml                      # Project metadata
+      ├── flows.yaml                         # Auto-generated structure
+      ├── attributes.yaml                    # Project attributes
+      ├── libraries/<lib-idn>/               # Shared skill libraries
+      │   ├── metadata.yaml
+      │   └── <skill-idn>/<skill>.jinja|.guidance
+      └── <agent-idn>/<flow-idn>/<skill-idn>/
+          ├── <skill>.guidance|.jinja        # Skill scripts
+          └── metadata.yaml                  # Skill metadata
+
+File Structure (newo_v2 - platform compatible):
+  newo_customers/<customer-idn>/
+  ├── import_version.txt                     # Format marker (v2.0.0)
+  ├── attributes.yaml                        # Customer attributes
+  ├── akb/<agent-idn>.yaml                   # AKB knowledge base
+  └── <project-idn>/
+      ├── <project-idn>.yaml                # Project metadata
+      ├── attributes.yaml                    # Project attributes
+      ├── libraries/<lib-idn>/               # Shared skill libraries
+      │   ├── <lib-idn>.yaml                # Library + inline skill defs
+      │   └── skills/<skill>.nsl|.nslg
+      └── agents/<agent-idn>/
+          ├── agent.yaml                     # Agent metadata
+          └── flows/<flow-idn>/
+              ├── <flow-idn>.yaml           # Flow + inline skill defs + events
+              └── skills/<skill>.nsl|.nslg  # Skill scripts
+
+Format Detection:
+  Format is auto-detected per customer from the filesystem:
+  - import_version.txt present -> newo_v2
+  - projects/ directory present -> cli_v1
+  Set NEWO_FORMAT=newo_v2 in .env for new pulls, or use --format flag
 
 For more information, visit: https://github.com/sabbah13/newo-cli
 `);

package/src/cli/commands/pull.ts

@@ -15,6 +15,8 @@ import { selectSingleCustomer } from '../customer-selection.js';
 import { setupCli } from '../../cli-new/bootstrap.js';
 import { ALL_RESOURCE_TYPES, RESOURCE_TYPES } from '../../cli-new/di/tokens.js';
 import type { MultiCustomerConfig, CliArgs, CustomerConfig } from '../../types.js';
+import { resolveFormat } from '../../format/detect.js';
+import type { FormatVersion } from '../../format/types.js';
 
 /**
  * Parse resource list from comma-separated string
@@ -44,16 +46,17 @@ function validateResources(resources: string[]): { valid: string[]; invalid: str
 }
 
 /**
- * Pull using V2 SyncEngine with selective sync
+ * Pull using SyncEngine with selective sync and format support
  */
-async function pullWithV2Engine(
+async function pullWithSyncEngine(
   customerConfig: MultiCustomerConfig,
   customer: CustomerConfig,
   resources: string[] | 'all',
   verbose: boolean,
-  silentOverwrite: boolean
+  silentOverwrite: boolean,
+  formatVersion?: FormatVersion
 ): Promise<void> {
-  const { syncEngine, logger } = setupCli(customerConfig, verbose);
+  const { syncEngine, logger } = setupCli(customerConfig, verbose, formatVersion);
 
   const pullOptions = {
     verbose,
@@ -126,28 +129,56 @@ export async function handlePullCommand(
     console.log(`📦 Pulling ALL resources`);
   }
 
-  // Use V2 engine if selective sync requested, otherwise use legacy for backward compatibility
-  const useV2Engine = onlyResources.length > 0 || excludeResources.length > 0 || pullAllResources;
+  // Use SyncEngine if selective sync requested, otherwise use legacy for backward compatibility
+  const useSyncEngine = onlyResources.length > 0 || excludeResources.length > 0 || pullAllResources;
+
+  // Explicit --format flag (applies to all customers in this run)
+  const explicitFormat = args.format as string | undefined;
 
   if (selectedCustomer) {
-    if (useV2Engine) {
-      await pullWithV2Engine(customerConfig, selectedCustomer, resourcesToFetch, verbose, silentOverwrite);
+    // Resolve format for this customer
+    const formatConfig = resolveFormat(selectedCustomer.idn, explicitFormat);
+    const isV2Format = formatConfig.version === 'newo_v2';
+
+    if (verbose || isV2Format) {
+      const sourceLabel = formatConfig.source === 'auto-detected' ? 'auto-detected'
+        : formatConfig.source === 'env-var' ? 'from .env'
+        : formatConfig.source === 'explicit-flag' ? '--format flag'
+        : 'default';
+      console.log(`Format: ${formatConfig.version} [${sourceLabel}]`);
+    }
+
+    // If format is newo_v2, always use SyncEngine (which will use V2ProjectSyncStrategy)
+    if (useSyncEngine || isV2Format) {
+      await pullWithSyncEngine(customerConfig, selectedCustomer, resourcesToFetch, verbose, silentOverwrite, formatConfig.version);
     } else {
-      // Legacy behavior: pull projects + attributes only
+      // Legacy behavior: pull projects + attributes only (cli_v1)
       const accessToken = await getValidAccessToken(selectedCustomer);
       const client = await makeClient(verbose, accessToken);
       const projectId = selectedCustomer.projectId || null;
       await pullAll(client, selectedCustomer, projectId, verbose, silentOverwrite);
     }
   } else if (isMultiCustomer) {
-    if (verbose) console.log(`📥 No default customer specified, pulling from all ${allCustomers.length} customers`);
-    console.log(`🔄 Pulling from ${allCustomers.length} customers...`);
+    if (verbose) console.log(`No default customer specified, pulling from all ${allCustomers.length} customers`);
+    console.log(`Pulling from ${allCustomers.length} customers...`);
 
     for (const customer of allCustomers) {
-      console.log(`\n📥 Pulling from customer: ${customer.idn}`);
+      console.log(`\nPulling from customer: ${customer.idn}`);
+
+      // Resolve format per customer (auto-detect from filesystem)
+      const formatConfig = resolveFormat(customer.idn, explicitFormat);
+      const isV2Format = formatConfig.version === 'newo_v2';
+
+      if (verbose || isV2Format) {
+        const sourceLabel = formatConfig.source === 'auto-detected' ? 'auto-detected'
+          : formatConfig.source === 'env-var' ? 'from .env'
+          : formatConfig.source === 'explicit-flag' ? '--format flag'
+          : 'default';
+        console.log(`  Format: ${formatConfig.version} [${sourceLabel}]`);
+      }
 
-      if (useV2Engine) {
-        await pullWithV2Engine(customerConfig, customer, resourcesToFetch, verbose, silentOverwrite);
+      if (useSyncEngine || isV2Format) {
+        await pullWithSyncEngine(customerConfig, customer, resourcesToFetch, verbose, silentOverwrite, formatConfig.version);
       } else {
         const accessToken = await getValidAccessToken(customer);
         const client = await makeClient(verbose, accessToken);
@@ -155,6 +186,6 @@ export async function handlePullCommand(
         await pullAll(client, customer, projectId, verbose, silentOverwrite);
       }
     }
-    console.log(`\n✅ Pull completed for all ${allCustomers.length} customers`);
+    console.log(`\nPull completed for all ${allCustomers.length} customers`);
   }
 }

package/src/cli/commands/push.ts

@@ -16,6 +16,8 @@ import { selectSingleCustomer, interactiveCustomerSelection } from '../customer-
 import { setupCli } from '../../cli-new/bootstrap.js';
 import { PUSHABLE_RESOURCE_TYPES } from '../../cli-new/di/tokens.js';
 import type { MultiCustomerConfig, CliArgs, CustomerConfig } from '../../types.js';
+import { resolveFormat } from '../../format/detect.js';
+import type { FormatVersion } from '../../format/types.js';
 
 /**
  * Parse resource list from comma-separated string
@@ -47,15 +49,16 @@ function validateResources(resources: string[]): { valid: string[]; invalid: str
 }
 
 /**
- * Push using V2 SyncEngine with selective sync
+ * Push using SyncEngine with selective sync and format support
  */
-async function pushWithV2Engine(
+async function pushWithSyncEngine(
   customerConfig: MultiCustomerConfig,
   customer: CustomerConfig,
   resources: string[] | 'all',
-  verbose: boolean
+  verbose: boolean,
+  formatVersion?: FormatVersion
 ): Promise<void> {
-  const { syncEngine, logger } = setupCli(customerConfig, verbose);
+  const { syncEngine, logger } = setupCli(customerConfig, verbose, formatVersion);
 
   if (resources === 'all') {
     const result = await syncEngine.pushAll(customer);
@@ -124,44 +127,48 @@ export async function handlePushCommand(
     console.log(`📦 Pushing ALL resources`);
   }
 
-  // Use V2 engine if selective sync requested, otherwise use legacy for backward compatibility
-  const useV2Engine = onlyResources.length > 0 || excludeResources.length > 0 || pushAllResources;
+  // Use SyncEngine if selective sync requested, otherwise use legacy for backward compatibility
+  const useSyncEngine = onlyResources.length > 0 || excludeResources.length > 0 || pushAllResources;
+  const explicitFormat = args.format as string | undefined;
+
+  /**
+   * Push for a single customer with format detection
+   */
+  async function pushForCustomer(customer: CustomerConfig): Promise<void> {
+    const formatConfig = resolveFormat(customer.idn, explicitFormat);
+    const isV2Format = formatConfig.version === 'newo_v2';
+
+    if (verbose || isV2Format) {
+      const sourceLabel = formatConfig.source === 'auto-detected' ? 'auto-detected'
+        : formatConfig.source === 'env-var' ? 'from .env'
+        : formatConfig.source === 'explicit-flag' ? '--format flag'
+        : 'default';
+      console.log(`Format: ${formatConfig.version} [${sourceLabel}]`);
+    }
 
-  if (selectedCustomer) {
-    if (useV2Engine) {
-      await pushWithV2Engine(customerConfig, selectedCustomer, resourcesToPush, verbose);
+    if (useSyncEngine || isV2Format) {
+      await pushWithSyncEngine(customerConfig, customer, resourcesToPush, verbose, formatConfig.version);
     } else {
-      // Legacy behavior
-      const accessToken = await getValidAccessToken(selectedCustomer);
+      const accessToken = await getValidAccessToken(customer);
       const client = await makeClient(verbose, accessToken);
-      await pushChanged(client, selectedCustomer, verbose, shouldPublish);
+      await pushChanged(client, customer, verbose, shouldPublish);
     }
+  }
+
+  if (selectedCustomer) {
+    await pushForCustomer(selectedCustomer);
   } else if (isMultiCustomer) {
-    // Multiple customers exist with no default, ask user
     const customersToProcess = await interactiveCustomerSelection(allCustomers);
 
     if (customersToProcess.length === 1) {
-      const customer = customersToProcess[0]!;
-      if (useV2Engine) {
-        await pushWithV2Engine(customerConfig, customer, resourcesToPush, verbose);
-      } else {
-        const accessToken = await getValidAccessToken(customer);
-        const client = await makeClient(verbose, accessToken);
-        await pushChanged(client, customer, verbose, shouldPublish);
-      }
+      await pushForCustomer(customersToProcess[0]!);
     } else {
-      console.log(`🔄 Pushing to ${customersToProcess.length} customers...`);
+      console.log(`Pushing to ${customersToProcess.length} customers...`);
       for (const customer of customersToProcess) {
-        console.log(`\n📤 Pushing for customer: ${customer.idn}`);
-        if (useV2Engine) {
-          await pushWithV2Engine(customerConfig, customer, resourcesToPush, verbose);
-        } else {
-          const accessToken = await getValidAccessToken(customer);
-          const client = await makeClient(verbose, accessToken);
-          await pushChanged(client, customer, verbose, shouldPublish);
-        }
+        console.log(`\nPushing for customer: ${customer.idn}`);
+        await pushForCustomer(customer);
       }
-      console.log(`\n✅ Push completed for all ${customersToProcess.length} customers`);
+      console.log(`\nPush completed for all ${customersToProcess.length} customers`);
     }
   }
 }

package/src/cli/commands/status.ts

@@ -1,9 +1,59 @@
 /**
  * Status command handler
+ *
+ * Supports format-aware status with --format flag:
+ *   newo status                     # auto-detect format per customer
+ *   newo status --format newo_v2    # force V2 format
  */
 import { status } from '../../sync.js';
 import { selectSingleCustomer } from '../customer-selection.js';
-import type { MultiCustomerConfig, CliArgs } from '../../types.js';
+import { setupCli } from '../../cli-new/bootstrap.js';
+import { resolveFormat } from '../../format/detect.js';
+import type { MultiCustomerConfig, CliArgs, CustomerConfig } from '../../types.js';
+
+async function statusForCustomer(
+  customerConfig: MultiCustomerConfig,
+  customer: CustomerConfig,
+  explicitFormat: string | undefined,
+  verbose: boolean
+): Promise<void> {
+  const formatConfig = resolveFormat(customer.idn, explicitFormat);
+  const isV2Format = formatConfig.version === 'newo_v2';
+
+  if (verbose || isV2Format) {
+    const sourceLabel = formatConfig.source === 'auto-detected' ? 'auto-detected'
+      : formatConfig.source === 'env-var' ? 'from .env'
+      : formatConfig.source === 'explicit-flag' ? '--format flag'
+      : 'default';
+    console.log(`Format: ${formatConfig.version} [${sourceLabel}]`);
+  }
+
+  if (isV2Format) {
+    // Use SyncEngine with V2ProjectSyncStrategy
+    const { syncEngine, logger } = setupCli(customerConfig, verbose, formatConfig.version);
+    const report = await syncEngine.getStatus(customer);
+
+    logger.info(`\nStatus for customer: ${report.customer}`);
+    logger.info(`Total changes: ${report.totalChanges}\n`);
+
+    for (const resource of report.resources) {
+      if (resource.changedCount > 0) {
+        logger.info(`${resource.displayName}: ${resource.changedCount} change(s)`);
+        for (const change of resource.changes) {
+          const op = change.operation.toUpperCase().charAt(0);
+          logger.info(`  ${op} ${change.path}`);
+        }
+      }
+    }
+
+    if (report.totalChanges === 0) {
+      logger.info('No changes to push.');
+    }
+  } else {
+    // Legacy V1 status
+    await status(customer, verbose);
+  }
+}
 
 export async function handleStatusCommand(
   customerConfig: MultiCustomerConfig,
@@ -15,16 +65,16 @@ export async function handleStatusCommand(
     args.customer as string | undefined
   );
 
+  const explicitFormat = args.format as string | undefined;
+
   if (selectedCustomer) {
-    // Single customer status
-    await status(selectedCustomer, verbose);
+    await statusForCustomer(customerConfig, selectedCustomer, explicitFormat, verbose);
   } else if (isMultiCustomer) {
-    // Multi-customer status
-    console.log(`🔄 Checking status for ${allCustomers.length} customers...`);
+    console.log(`Checking status for ${allCustomers.length} customers...`);
     for (const customer of allCustomers) {
-      console.log(`\n📋 Status for customer: ${customer.idn}`);
-      await status(customer, verbose);
+      console.log(`\nStatus for customer: ${customer.idn}`);
+      await statusForCustomer(customerConfig, customer, explicitFormat, verbose);
     }
-    console.log(`\n✅ Status check completed for all ${allCustomers.length} customers`);
+    console.log(`\nStatus check completed for all ${allCustomers.length} customers`);
   }
-}
+}

package/src/cli/commands/update-attribute.ts

@@ -0,0 +1,82 @@
+/**
+ * Update Customer Attribute Command Handler
+ */
+import { makeClient, getCustomerAttributes, updateCustomerAttribute } from '../../api.js';
+import { getValidAccessToken } from '../../auth.js';
+import { requireSingleCustomer } from '../customer-selection.js';
+import type { MultiCustomerConfig, CliArgs, CustomerAttribute } from '../../types.js';
+
+export async function handleUpdateAttributeCommand(
+  customerConfig: MultiCustomerConfig,
+  args: CliArgs,
+  verbose: boolean = false
+): Promise<void> {
+  try {
+    const selectedCustomer = requireSingleCustomer(customerConfig, args.customer as string | undefined);
+
+    // Parse arguments
+    const idn = args._[1] as string;
+
+    if (!idn) {
+      console.error('Error: Attribute IDN is required');
+      console.error('Usage: newo update-attribute <idn> [--value <value>] [--title <title>] [--description <desc>] [--group <group>] [--hidden] [--value-type <type>] [--possible-values <val1,val2>]');
+      process.exit(1);
+    }
+
+    // Get access token and create client
+    const accessToken = await getValidAccessToken(selectedCustomer);
+    const client = await makeClient(verbose, accessToken);
+
+    // Fetch existing attributes to find the one to update
+    const response = await getCustomerAttributes(client, true);
+    const existing = response.attributes.find((a: CustomerAttribute) => a.idn === idn);
+
+    if (!existing) {
+      console.error(`❌ Attribute '${idn}' not found. Use 'newo create-attribute' to create it.`);
+      process.exit(1);
+    }
+
+    if (!existing.id) {
+      console.error(`❌ Attribute '${idn}' has no ID. Cannot update.`);
+      process.exit(1);
+    }
+
+    // Build updated attribute - only override fields that were explicitly provided
+    const updated: CustomerAttribute = {
+      id: existing.id,
+      idn: existing.idn,
+      value: args.value !== undefined ? String(args.value) : existing.value,
+      title: (args.title as string) || existing.title,
+      description: (args.description as string) || existing.description,
+      group: (args.group as string) || existing.group,
+      is_hidden: args.hidden !== undefined ? Boolean(args.hidden) : existing.is_hidden,
+      possible_values: args['possible-values']
+        ? (args['possible-values'] as string).split(',').map(v => v.trim())
+        : existing.possible_values,
+      value_type: (args['value-type'] as string) || existing.value_type
+    };
+
+    if (verbose) {
+      console.log(`📝 Updating customer attribute: ${idn} (ID: ${existing.id})`);
+      if (args.value !== undefined) console.log(`   Value: ${existing.value} -> ${updated.value}`);
+      if (args.title) console.log(`   Title: ${existing.title} -> ${updated.title}`);
+      if (args.description) console.log(`   Description: updated`);
+      if (args.group) console.log(`   Group: ${existing.group} -> ${updated.group}`);
+      if (args['value-type']) console.log(`   Type: ${existing.value_type} -> ${updated.value_type}`);
+      if (args.hidden !== undefined) console.log(`   Hidden: ${existing.is_hidden} -> ${updated.is_hidden}`);
+    }
+
+    await updateCustomerAttribute(client, updated);
+
+    console.log(`✅ Customer attribute updated: ${idn}`);
+    if (args.value !== undefined) console.log(`   Value: ${updated.value}`);
+    if (args['value-type']) console.log(`   Type: ${updated.value_type}`);
+    if (args.title) console.log(`   Title: ${updated.title}`);
+    if (args.description) console.log(`   Description: updated`);
+    if (args.group) console.log(`   Group: ${updated.group}`);
+
+  } catch (error: unknown) {
+    console.error('❌ Failed to update customer attribute:', error instanceof Error ? error.message : String(error));
+    process.exit(1);
+  }
+}