newo 3.4.2 → 3.6.1

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,33 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.6.1] - 2026-04-14
+
+### Documentation
+
+- Update README.md with V2 format, libraries, and `newo export` documentation for npm package page
+
+## [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/README.md

@@ -8,22 +8,22 @@
 **NEWO CLI** - Professional command-line tool for NEWO AI Agent development. Features **modular architecture**, **IDN-based file management**, and **comprehensive multi-customer support**.
 
 Sync NEWO "Project → Agent → Flow → Skills" structure to local files with:
+- 🆕 **Dual format support** (v3.6.0) - `cli_v1` (native) and `newo_v2` (platform compatible), auto-detected per customer
+- 🆕 **Libraries** (v3.6.0) - Pull/push shared reusable skills across agents within a project
+- 🆕 **Bulk export** (v3.6.0) - `newo export` downloads complete V2 ZIP from platform
 - 🚀 **Account migration** - Fully automated account copying with 100% accuracy
 - 🏗️ **Complete entity management** - Create, edit, and delete agents, flows, skills, events, and states
 - 🔄 **Intelligent synchronization** - Pull projects, attributes, and conversations automatically
-- 🎯 **IDN-based naming** - Skills named as `{skillIdn}.jinja/.guidance` for better organization
+- 🎯 **IDN-based naming** - Skills named as `{skillIdn}.jinja/.guidance` or `{skillIdn}.nsl/.nslg`
 - 📊 **Real-time progress** - Live progress tracking during large operations (1,000+ skills)
 - 🏢 **Multi-customer workspaces** - Work with multiple NEWO accounts simultaneously
-- 📁 **Hierarchical structure** - Complete project metadata and organized file structure
 - 🔐 **Secure authentication** - API key-based auth with automatic token refresh
 - ⚡ **Smart change detection** - SHA256-based efficient sync with hash consistency
-- 🛡️ **File validation** - Multiple file detection with clear warnings and safe handling
-- 🧠 **AI skill formats** - Support for `.guidance` (AI prompts) and `.jinja` (NSL templates)
+- 🧠 **AI skill formats** - Support for `.guidance`/`.jinja` (V1) and `.nslg`/`.nsl` (V2)
 - 📡 **Webhook automation** - Automatic webhook creation from YAML configuration
 - 📊 **Knowledge base import** - Bulk import AKB articles from structured text files
 - 💬 **Conversation history** - Extract and sync user conversations and personas
 - 🧪 **Sandbox testing** - Interactive agent testing with conversation continuation
-- ✅ **Migration verification** - Automated validation of migration completeness
 - 🔧 **CI/CD ready** - GitHub Actions integration for automated deployments
 
 ---
@@ -143,15 +143,33 @@ NEWO_REFRESH_URL=custom_refresh_endpoint   # Custom refresh endpoint
 
 | Command | Description | Features |
 |---------|-------------|----------|
-| `newo pull` | Download projects + attributes + metadata | • Real-time progress tracking (966+ skills)<br>• IDN-based file naming<br>• Automatic attributes.yaml generation<br>• `--force` for silent overwrite |
-| `newo push` | Upload local changes to NEWO | • Smart file validation<br>• Multiple file detection<br>• Hash-based change detection<br>• Safe error handling |
-| `newo status` | Show modified files with details | • Multiple file warnings<br>• Detailed change analysis<br>• Clean state validation<br>• Per-customer status |
-| `newo sandbox` | Test agents in sandbox chat mode | • Single-command mode for automation<br>• Multi-turn conversation support<br>• Debug info for agent development<br>• Conversation continuation |
+| `newo pull [--format <fmt>]` | Download projects + attributes + libraries | • Dual format: `cli_v1` / `newo_v2`<br>• Auto-detects format per customer<br>• Real-time progress tracking (1,000+ skills)<br>• IDN-based file naming<br>• `--force` for silent overwrite |
+| `newo push [--format <fmt>]` | Upload local changes to NEWO | • Works with both formats<br>• Hash-based change detection<br>• Library skill updates<br>• Publishes flows automatically |
+| `newo status [--format <fmt>]` | Show modified files | • Format-aware status<br>• Multiple file warnings<br>• Per-customer status |
+| `newo export [--output <file>]` | Download V2 bulk ZIP from platform | • Complete organization export<br>• Projects, agents, flows, skills, attributes, AKB<br>• Compatible with platform UI import |
+| `newo sandbox` | Test agents in sandbox chat mode | • Single-command mode for automation<br>• Multi-turn conversation support<br>• Debug info for agent development |
 | `newo conversations` | Pull conversation history | • User personas and chat history<br>• YAML format output<br>• Pagination support |
 | `newo list-customers` | List configured customers | • Shows default customer<br>• Multi-customer discovery |
 | `newo import-akb` | Import knowledge base articles | • Structured text parsing<br>• Bulk article import<br>• Validation and error reporting |
 | `newo meta` | Get project metadata (debug) | • Project structure analysis<br>• Metadata validation |
 
+### V2 Format Support (NEW v3.6.0)
+
+The CLI supports two formats that coexist in the same workspace:
+
+- **`cli_v1`** (default) - Native CLI format with per-entity metadata files, `.guidance`/`.jinja` extensions
+- **`newo_v2`** - Platform import/export format, `.nslg`/`.nsl` extensions, compatible with SuperAgent repository and NEWO platform export ZIPs
+
+**Format is auto-detected per customer** from filesystem markers (`import_version.txt` = V2, `projects/` dir = V1). Override per-command with `--format newo_v2` or set persistent default with `NEWO_FORMAT=newo_v2` in `.env`.
+
+```bash
+newo pull --format newo_v2      # Pull in V2 format
+newo export --output backup.zip  # Bulk V2 ZIP download
+newo push --format newo_v2       # Push from V2 format project
+```
+
+Round-trip tested against real SuperAgent export: 1426/1426 files, 1331 scripts byte-identical, zero data loss on platform import.
+
 ### Account Migration Commands
 
 **Enterprise-grade account migration with 100% automation:**

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