newo 3.4.2 → 3.6.0

package/.env.example

@@ -19,6 +19,11 @@ NEWO_API_KEYS=["api_key_1", "api_key_2", "api_key_3"]
 # NEWO_API_KEY=put_api_key_here
 # NEWO_PROJECT_ID=b78188ba-0df0-46a8-8713-f0d7cff0a06e
 
+# Project format (default: cli_v1, only affects NEW pulls where no local files exist)
+# cli_v1 = Native CLI format (full feature support, per-entity metadata)
+# newo_v2 = NEWO platform export format (compatible with platform UI exports)
+# NEWO_FORMAT=cli_v1
+
 # Optional bootstrap tokens (for legacy mode or manual setup)
 NEWO_ACCESS_TOKEN=
 NEWO_REFRESH_TOKEN=

package/CHANGELOG.md

@@ -7,6 +7,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.6.0] - 2026-04-13
+
+### Added
+
+- **NEWO V2 Format Support** - Dual format support: `cli_v1` (native, default) and `newo_v2` (NEWO platform import/export compatible). Format is auto-detected per customer from filesystem (`import_version.txt` = newo_v2, `projects/` dir = cli_v1). Multiple formats coexist in the same workspace.
+- **Libraries** - New entity type for shared reusable skills across agents within a project. Full pull/push/status support in both cli_v1 and newo_v2 formats via `GET/POST /api/v1/designer/projects/{id}/libraries` and `PATCH /api/v1/designer/libraries/{id}/skills/{id}`.
+- **`newo export` command** - Bulk download V2 export ZIP from NEWO platform via `POST /api/v2/designer/customer/export`. Usage: `newo export [--output file.zip] [--customer idn]`.
+- **`--format` flag** - Per-command format override for `pull`, `push`, and `status` commands. Values: `cli_v1`, `newo_v2`.
+- **`NEWO_FORMAT` environment variable** - Persistent default format for new pulls (only affects customers without existing local files).
+- **Format auto-detection** - Automatic per-customer format detection from filesystem markers. Existing projects always auto-detect; env var only applies to fresh pulls.
+- **V2ProjectSyncStrategy** - New sync strategy using same V1 APIs but writing newo_v2 file layout (agents/flows/skills structure, .nsl/.nslg extensions, inline flow YAML with skills/events/states).
+- **Format module** (`src/format/`) - Types, detection, extension mapping, V2 paths, V2 YAML parsers/generators, and pyyaml-compatible formatting.
+
+### Changed
+
+- `pull`, `push`, and `status` commands now support `--format` flag and auto-detect format per customer
+- DI bootstrap conditionally registers V2ProjectSyncStrategy when format is newo_v2
+- `skill-files.ts` now recognizes `.nslg` extension alongside `.guidance`, `.jinja`, `.nsl`
+- `env.ts` validates `NEWO_FORMAT` environment variable
+- API client factory passes customer config to `getValidAccessToken()` for correct multi-customer auth
+
 ## [3.4.2] - 2026-04-12
 
 ### Added

package/dist/api.d.ts

@@ -90,4 +90,22 @@ export declare function listRegistryItems(client: AxiosInstance, registryId: str
 export declare function addProjectFromRegistry(client: AxiosInstance, projectData: AddProjectFromRegistryRequest): Promise<CreateProjectResponse>;
 export declare function createNewoCustomer(client: AxiosInstance, customerData: CreateNewoCustomerRequest): Promise<CreateNewoCustomerResponse>;
 export declare function getLogs(client: AxiosInstance, params: LogsQueryParams): Promise<LogsResponse>;
+export interface LibraryResponse {
+    id: string;
+    idn: string;
+    project_id: string;
+    skills: Skill[];
+}
+export declare function listLibraries(client: AxiosInstance, projectId: string): Promise<LibraryResponse[]>;
+export declare function listLibrarySkills(client: AxiosInstance, libraryId: string): Promise<Skill[]>;
+export declare function updateLibrarySkill(client: AxiosInstance, libraryId: string, skillId: string, data: {
+    prompt_script: string;
+    [key: string]: unknown;
+}): Promise<void>;
+export interface V2ExportOptions {
+    export_akb?: boolean;
+    export_customer_attributes?: boolean;
+    exclude_projects_idn?: string[];
+}
+export declare function exportCustomerV2(client: AxiosInstance, customerId: string, options?: V2ExportOptions): Promise<Buffer>;
 //# sourceMappingURL=api.d.ts.map

package/dist/api.js

@@ -418,4 +418,32 @@ export async function getLogs(client, params) {
     const response = await client.get(`/api/v1/analytics/logs?${queryParams.toString()}`);
     return response.data;
 }
+export async function listLibraries(client, projectId) {
+    const response = await client.get(`/api/v1/designer/projects/${projectId}/libraries`);
+    return response.data;
+}
+export async function listLibrarySkills(client, libraryId) {
+    const response = await client.get(`/api/v1/designer/libraries/${libraryId}/skills`);
+    return response.data;
+}
+export async function updateLibrarySkill(client, libraryId, skillId, data) {
+    await client.patch(`/api/v1/designer/libraries/${libraryId}/skills/${skillId}`, data);
+}
+export async function exportCustomerV2(client, customerId, options = {}) {
+    const params = new URLSearchParams();
+    params.set('customer_id', customerId);
+    if (options.export_akb !== undefined)
+        params.set('export_akb', String(options.export_akb));
+    if (options.export_customer_attributes !== undefined)
+        params.set('export_customer_attributes', String(options.export_customer_attributes));
+    if (options.exclude_projects_idn && options.exclude_projects_idn.length > 0) {
+        for (const idn of options.exclude_projects_idn) {
+            params.append('exclude_projects_idn', idn);
+        }
+    }
+    const response = await client.post(`/api/v2/designer/customer/export?${params.toString()}`, null, {
+        responseType: 'arraybuffer',
+    });
+    return Buffer.from(response.data);
+}
 //# sourceMappingURL=api.js.map

package/dist/cli/commands/export.d.ts

@@ -0,0 +1,3 @@
+import type { MultiCustomerConfig, CliArgs } from '../../types.js';
+export declare function handleExportCommand(customerConfig: MultiCustomerConfig, args: CliArgs, verbose: boolean): Promise<void>;
+//# sourceMappingURL=export.d.ts.map

package/dist/cli/commands/export.js

@@ -0,0 +1,62 @@
+/**
+ * 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';
+export async function handleExportCommand(customerConfig, args, verbose) {
+    const { selectedCustomer } = selectSingleCustomer(customerConfig, args.customer);
+    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 || args.o
+        || 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) {
+    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'));
+        return decoded['customer_id'] || decoded['sub'] || null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=export.js.map

package/dist/cli/commands/help.js

@@ -6,19 +6,20 @@ export function handleHelpCommand() {
 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
@@ -74,6 +75,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
@@ -81,6 +83,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)
@@ -98,6 +101,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
@@ -199,37 +203,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/dist/cli/commands/pull.js

@@ -14,6 +14,7 @@ import { getValidAccessToken } from '../../auth.js';
 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 { resolveFormat } from '../../format/detect.js';
 /**
  * Parse resource list from comma-separated string
  */
@@ -40,10 +41,10 @@ function validateResources(resources) {
     return { valid, invalid };
 }
 /**
- * Pull using V2 SyncEngine with selective sync
+ * Pull using SyncEngine with selective sync and format support
  */
-async function pullWithV2Engine(customerConfig, customer, resources, verbose, silentOverwrite) {
-    const { syncEngine, logger } = setupCli(customerConfig, verbose);
+async function pullWithSyncEngine(customerConfig, customer, resources, verbose, silentOverwrite, formatVersion) {
+    const { syncEngine, logger } = setupCli(customerConfig, verbose, formatVersion);
     const pullOptions = {
         verbose,
         silentOverwrite
@@ -102,14 +103,27 @@ export async function handlePullCommand(customerConfig, args, verbose) {
         resourcesToFetch = 'all';
         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;
     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;
@@ -118,12 +132,22 @@ export async function handlePullCommand(customerConfig, args, verbose) {
     }
     else if (isMultiCustomer) {
         if (verbose)
-            console.log(`📥 No default customer specified, pulling from all ${allCustomers.length} customers`);
-        console.log(`🔄 Pulling from ${allCustomers.length} customers...`);
+            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}`);
-            if (useV2Engine) {
-                await pullWithV2Engine(customerConfig, customer, resourcesToFetch, verbose, silentOverwrite);
+            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 (useSyncEngine || isV2Format) {
+                await pullWithSyncEngine(customerConfig, customer, resourcesToFetch, verbose, silentOverwrite, formatConfig.version);
             }
             else {
                 const accessToken = await getValidAccessToken(customer);
@@ -132,7 +156,7 @@ export async function handlePullCommand(customerConfig, args, verbose) {
                 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`);
     }
 }
 //# sourceMappingURL=pull.js.map

package/dist/cli/commands/push.js

@@ -15,6 +15,7 @@ import { getValidAccessToken } from '../../auth.js';
 import { selectSingleCustomer, interactiveCustomerSelection } from '../customer-selection.js';
 import { setupCli } from '../../cli-new/bootstrap.js';
 import { PUSHABLE_RESOURCE_TYPES } from '../../cli-new/di/tokens.js';
+import { resolveFormat } from '../../format/detect.js';
 /**
  * Parse resource list from comma-separated string
  */
@@ -44,10 +45,10 @@ function validateResources(resources) {
     return { valid, invalid };
 }
 /**
- * Push using V2 SyncEngine with selective sync
+ * Push using SyncEngine with selective sync and format support
  */
-async function pushWithV2Engine(customerConfig, customer, resources, verbose) {
-    const { syncEngine, logger } = setupCli(customerConfig, verbose);
+async function pushWithSyncEngine(customerConfig, customer, resources, verbose, formatVersion) {
+    const { syncEngine, logger } = setupCli(customerConfig, verbose, formatVersion);
     if (resources === 'all') {
         const result = await syncEngine.pushAll(customer);
         logger.info(`✅ Pushed: ${result.totalCreated} created, ${result.totalUpdated} updated, ${result.totalDeleted} deleted`);
@@ -103,47 +104,46 @@ export async function handlePushCommand(customerConfig, args, verbose) {
         resourcesToPush = 'all';
         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;
-    if (selectedCustomer) {
-        if (useV2Engine) {
-            await pushWithV2Engine(customerConfig, selectedCustomer, resourcesToPush, verbose);
+    // 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;
+    /**
+     * Push for a single customer with format detection
+     */
+    async function pushForCustomer(customer) {
+        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 (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/dist/cli/commands/status.js

@@ -1,22 +1,61 @@
 /**
  * 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 { setupCli } from '../../cli-new/bootstrap.js';
+import { resolveFormat } from '../../format/detect.js';
+async function statusForCustomer(customerConfig, customer, explicitFormat, verbose) {
+    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, args, verbose) {
     const { selectedCustomer, allCustomers, isMultiCustomer } = selectSingleCustomer(customerConfig, args.customer);
+    const explicitFormat = args.format;
     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`);
     }
 }
 //# sourceMappingURL=status.js.map

package/dist/cli-new/bootstrap.d.ts

@@ -8,6 +8,7 @@ import { ServiceContainer } from './di/Container.js';
 import { type ILogger, type CustomerConfig, type MultiCustomerConfig } from '../domain/resources/common/types.js';
 import { SyncEngine, type SyncEngineOptions } from '../application/sync/SyncEngine.js';
 import { MigrationEngine } from '../application/migration/MigrationEngine.js';
+import type { FormatVersion } from '../format/types.js';
 import type { AxiosInstance } from 'axios';
 /**
  * API Client Factory that creates authenticated clients
@@ -25,6 +26,11 @@ export interface BootstrapOptions {
      * Sync engine options
      */
     syncEngineOptions?: SyncEngineOptions;
+    /**
+     * Format version for project sync strategy
+     * 'newo_v2' uses V2ProjectSyncStrategy, 'cli_v1' (default) uses ProjectSyncStrategy
+     */
+    formatVersion?: FormatVersion | undefined;
 }
 /**
  * Create and configure the service container
@@ -47,7 +53,7 @@ export declare function getLogger(container: ServiceContainer): ILogger;
  *
  * Creates a configured container with all services ready to use.
  */
-export declare function setupCli(customerConfig: MultiCustomerConfig, verbose?: boolean): {
+export declare function setupCli(customerConfig: MultiCustomerConfig, verbose?: boolean, formatVersion?: FormatVersion): {
     container: ServiceContainer;
     syncEngine: SyncEngine;
     migrationEngine: MigrationEngine;

package/dist/cli-new/bootstrap.js

@@ -10,6 +10,7 @@ import { ConsoleLogger } from '../domain/resources/common/types.js';
 import { SyncEngine } from '../application/sync/SyncEngine.js';
 import { MigrationEngine, TransformService } from '../application/migration/MigrationEngine.js';
 import { ProjectSyncStrategy, createProjectSyncStrategy } from '../domain/strategies/sync/ProjectSyncStrategy.js';
+import { createV2ProjectSyncStrategy } from '../domain/strategies/sync/V2ProjectSyncStrategy.js';
 import { AttributeSyncStrategy, createAttributeSyncStrategy } from '../domain/strategies/sync/AttributeSyncStrategy.js';
 import { IntegrationSyncStrategy, createIntegrationSyncStrategy } from '../domain/strategies/sync/IntegrationSyncStrategy.js';
 import { AkbSyncStrategy, createAkbSyncStrategy } from '../domain/strategies/sync/AkbSyncStrategy.js';
@@ -25,7 +26,7 @@ export async function createApiClient(customer, verbose) {
     if (customer.projectId) {
         process.env.NEWO_PROJECT_ID = customer.projectId;
     }
-    const token = await getValidAccessToken();
+    const token = await getValidAccessToken(customer);
     return makeClient(verbose, token);
 }
 /**
@@ -43,8 +44,13 @@ export function createServiceContainer(customerConfig, options = {}) {
     // API Client Factory
     container.registerValue(TOKENS.API_CLIENT_FACTORY, createApiClient);
     // === Domain Layer - Sync Strategies ===
-    // Project Sync Strategy
-    container.registerSingleton(TOKENS.PROJECT_SYNC_STRATEGY, () => createProjectSyncStrategy(createApiClient, container.get(TOKENS.LOGGER)));
+    // Project Sync Strategy (format-conditional: cli_v1 or newo_v2)
+    container.registerSingleton(TOKENS.PROJECT_SYNC_STRATEGY, () => {
+        if (options.formatVersion === 'newo_v2') {
+            return createV2ProjectSyncStrategy(createApiClient, container.get(TOKENS.LOGGER));
+        }
+        return createProjectSyncStrategy(createApiClient, container.get(TOKENS.LOGGER));
+    });
     // Attribute Sync Strategy
     container.registerSingleton(TOKENS.ATTRIBUTE_SYNC_STRATEGY, () => createAttributeSyncStrategy(createApiClient, container.get(TOKENS.LOGGER)));
     // Integration Sync Strategy
@@ -96,8 +102,8 @@ export function getLogger(container) {
  *
  * Creates a configured container with all services ready to use.
  */
-export function setupCli(customerConfig, verbose = false) {
-    const container = createServiceContainer(customerConfig, { verbose });
+export function setupCli(customerConfig, verbose = false, formatVersion) {
+    const container = createServiceContainer(customerConfig, { verbose, formatVersion });
     return {
         container,
         syncEngine: getSyncEngine(container),