newo 1.6.0 → 1.7.0

package/CHANGELOG.md

@@ -5,6 +5,100 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.7.0] - 2025-09-15
+
+### Added
+- **Customer Attributes Synchronization**: Complete pull/push functionality for customer attributes
+  - `GET /api/v1/bff/customer/attributes?include_hidden=true` - Fetches all 233 customer attributes including hidden system attributes
+  - `PUT /api/v1/customer/attributes/{attributeId}` - Updates individual customer attributes
+  - Saves to `newo_customers/{customerIdn}/attributes.yaml` in customer root directory
+  - YAML format matches reference specification exactly with literal blocks, enum types, and proper multi-line formatting
+  - Separate ID mapping stored in `.newo/{customerIdn}/attributes-map.json` for push operations
+  - Integrated into existing `pull` and `push` commands seamlessly
+  - Full TypeScript type safety with `CustomerAttribute` and `CustomerAttributesResponse` interfaces
+
+### Enhanced
+- **YAML Format Compliance**: Perfect format matching with reference files
+  - Literal block scalars (`|-`) for multi-line strings
+  - Proper enum format (`!enum "AttributeValueTypes.string"`)
+  - Complex JSON string formatting with proper line breaks
+  - No escaped quotes in output for better readability
+- **Metadata Generation**: Removed legacy JSON metadata files, YAML-only approach
+  - Eliminates redundant `metadata.json` files
+  - Cleaner file structure with single source of truth
+  - Improved performance with fewer file operations
+
+### Technical
+- **API Layer**: Added `updateCustomerAttribute()` and enhanced `getCustomerAttributes()` with `includeHidden` parameter
+- **Sync Engine**: Integrated attributes handling into `pullAll()` and `pushChanged()` functions
+- **File System**: Added `customerAttributesPath()` and `customerAttributesMapPath()` utilities
+- **Type Safety**: Extended type definitions with proper customer attribute interfaces
+- **Error Handling**: Comprehensive error handling for attributes operations with graceful fallbacks
+
+## [1.6.1] - 2025-09-13
+
+### Fixed
+- **YAML Enum Formatting**: Fixed enum formatting in `flows.yaml` generation to properly handle NEWO enum types
+  - Corrected enum value serialization from quoted strings to proper YAML enum format
+  - Fixed issue where enum values like `!enum "RunnerType.guidance"` were incorrectly quoted
+  - Ensures generated `flows.yaml` files are properly formatted for NEWO platform consumption
+
+### Enhanced
+- **ES Module Support**: Added `"type": "module"` to package.json for proper ES module handling
+  - Resolves Node.js warnings about module type detection
+  - Improves performance by eliminating module type guessing
+  - Ensures consistent ES module behavior across all environments
+
+## [1.6.0] - 2025-09-13
+
+### Added
+- **Multi-Customer Auto-Pull**: Revolutionary workflow improvement for multi-customer environments
+  - `newo pull` now automatically pulls from ALL customers when no default customer is set
+  - Eliminates the need to specify `--customer` flag or set `NEWO_DEFAULT_CUSTOMER` for bulk operations
+  - Maintains backward compatibility - individual customer selection still works with `--customer` flag
+  - Smart detection: single customer setup works as before, multi-customer setup auto-pulls all
+- **Publishing Infrastructure**: Complete automated publishing system for professional releases
+  - `scripts/publish-github.sh`: Automated GitHub publishing with releases, tags, and version management
+  - `scripts/publish-npm.sh`: Automated NPM publishing with validation and safety checks
+  - Comprehensive Makefile with 40+ commands for development and publishing workflows
+  - Version bump helpers (patch/minor/major) with semantic versioning support
+- **Enhanced Documentation**: Professional publishing and development documentation
+  - Complete "Publishing & Release Management" section with step-by-step workflows
+  - "Local Testing" section with comprehensive testing procedures
+  - Makefile command reference with organized development workflows
+  - Troubleshooting guides for common development and publishing issues
+
+### Enhanced
+- **Customer Configuration Logic**: New functions for flexible customer handling
+  - `tryGetDefaultCustomer()`: Non-throwing version that returns null for multi-customer scenarios
+  - `getAllCustomers()`: Returns array of all configured customers for batch operations
+  - Improved error handling and user feedback for customer selection scenarios
+- **CLI User Experience**: Enhanced command behavior and help documentation
+  - Updated help text to reflect auto-pull behavior: "uses default or all for pull"
+  - Clear progress indicators for multi-customer operations
+  - Better error messages and troubleshooting guidance
+- **Development Workflow**: Professional development and publishing infrastructure
+  - Makefile with color-coded output and comprehensive command organization
+  - Automated validation pipelines for publishing (build, test, lint, typecheck)
+  - Publishing scripts with safety checks and rollback procedures
+
+### Changed
+- **Pull Command Behavior**: Breaking change in multi-customer environments (improvement)
+  - Previously: Required explicit customer selection or default customer configuration
+  - Now: Automatically pulls from all customers when no default is set
+  - Single customer setups: No change in behavior
+  - Multi-customer setups: Significantly improved user experience
+- **Help Documentation**: Updated command descriptions and examples
+  - `newo pull` now shows "(all customers if no default)" in help text
+  - Enhanced multi-customer examples with auto-pull scenarios
+  - Updated usage patterns to reflect new workflow capabilities
+
+### Developer Experience
+- **Publishing Automation**: One-command publishing to both GitHub and NPM with full validation
+- **Comprehensive Testing**: Enhanced local testing documentation with step-by-step procedures
+- **Professional Infrastructure**: Industry-standard publishing pipeline with version management
+- **Quality Gates**: Automated validation before publishing (TypeScript, linting, building, package validation)
+
 ## [1.5.2] - 2025-01-15
 
 ### Enhanced

package/README.md

@@ -25,7 +25,7 @@ Mirror NEWO "Project → Agent → Flow → Skills" structure to local files wit
 
 **Option 1: Global Installation (Recommended)**
 ```bash
-npm install -g newo
+npm install -g newo@latest
 ```
 
 **Option 2: Local Project Installation**

package/dist/api.d.ts

@@ -1,5 +1,5 @@
 import { type AxiosInstance } from 'axios';
-import type { ProjectMeta, Agent, Skill, FlowEvent, FlowState, AkbImportArticle, CustomerProfile } from './types.js';
+import type { ProjectMeta, Agent, Skill, FlowEvent, FlowState, AkbImportArticle, CustomerProfile, CustomerAttribute, CustomerAttributesResponse } from './types.js';
 export declare function makeClient(verbose?: boolean, token?: string): Promise<AxiosInstance>;
 export declare function listProjects(client: AxiosInstance): Promise<ProjectMeta[]>;
 export declare function listAgents(client: AxiosInstance, projectId: string): Promise<Agent[]>;
@@ -11,4 +11,6 @@ export declare function listFlowEvents(client: AxiosInstance, flowId: string): P
 export declare function listFlowStates(client: AxiosInstance, flowId: string): Promise<FlowState[]>;
 export declare function importAkbArticle(client: AxiosInstance, articleData: AkbImportArticle): Promise<unknown>;
 export declare function getCustomerProfile(client: AxiosInstance): Promise<CustomerProfile>;
+export declare function getCustomerAttributes(client: AxiosInstance, includeHidden?: boolean): Promise<CustomerAttributesResponse>;
+export declare function updateCustomerAttribute(client: AxiosInstance, attribute: CustomerAttribute): Promise<void>;
 //# sourceMappingURL=api.d.ts.map

package/dist/api.js

@@ -100,4 +100,25 @@ export async function getCustomerProfile(client) {
     const response = await client.get('/api/v1/customer/profile');
     return response.data;
 }
+export async function getCustomerAttributes(client, includeHidden = true) {
+    const response = await client.get('/api/v1/bff/customer/attributes', {
+        params: { include_hidden: includeHidden }
+    });
+    return response.data;
+}
+export async function updateCustomerAttribute(client, attribute) {
+    if (!attribute.id) {
+        throw new Error(`Attribute ${attribute.idn} is missing ID - cannot update`);
+    }
+    await client.put(`/api/v1/customer/attributes/${attribute.id}`, {
+        idn: attribute.idn,
+        value: attribute.value,
+        title: attribute.title,
+        description: attribute.description,
+        group: attribute.group,
+        is_hidden: attribute.is_hidden,
+        possible_values: attribute.possible_values,
+        value_type: attribute.value_type
+    });
+}
 //# sourceMappingURL=api.js.map

package/dist/cli.js

@@ -2,7 +2,7 @@
 import minimist from 'minimist';
 import dotenv from 'dotenv';
 import { makeClient, getProjectMeta, importAkbArticle } from './api.js';
-import { pullAll, pushChanged, status } from './sync.js';
+import { pullAll, pushChanged, status, saveCustomerAttributes } from './sync.js';
 import { parseAkbFile, prepareArticlesForImport } from './akb.js';
 import { initializeEnvironment, ENV, EnvValidationError } from './env.js';
 import { parseCustomerConfigAsync, listCustomers, getCustomer, getDefaultCustomer, tryGetDefaultCustomer, getAllCustomers, validateCustomerConfig } from './customerAsync.js';
@@ -278,6 +278,11 @@ File Structure:
         const meta = await getProjectMeta(client, selectedCustomer.projectId);
         console.log(JSON.stringify(meta, null, 2));
     }
+    else if (cmd === 'pull-attributes') {
+        console.log(`🔍 Fetching customer attributes for ${selectedCustomer.idn}...`);
+        await saveCustomerAttributes(client, selectedCustomer, verbose);
+        console.log(`✅ Customer attributes saved to newo_customers/${selectedCustomer.idn}/attributes.yaml`);
+    }
     else if (cmd === 'import-akb') {
         const akbFile = args._[1];
         const personaId = args._[2];

package/dist/fsutil.d.ts

@@ -9,7 +9,15 @@ export declare function hashesPath(customerIdn: string): string;
 export declare function ensureState(customerIdn: string): Promise<void>;
 export declare function projectDir(customerIdn: string, projectIdn: string): string;
 export declare function flowsYamlPath(customerIdn: string): string;
+export declare function customerAttributesPath(customerIdn: string): string;
+export declare function customerAttributesMapPath(customerIdn: string): string;
 export declare function skillPath(customerIdn: string, projectIdn: string, agentIdn: string, flowIdn: string, skillIdn: string, runnerType?: RunnerType): string;
+export declare function skillFolderPath(customerIdn: string, projectIdn: string, agentIdn: string, flowIdn: string, skillIdn: string): string;
+export declare function skillScriptPath(customerIdn: string, projectIdn: string, agentIdn: string, flowIdn: string, skillIdn: string, runnerType?: RunnerType): string;
+export declare function projectMetadataPath(customerIdn: string, projectIdn: string): string;
+export declare function agentMetadataPath(customerIdn: string, projectIdn: string, agentIdn: string): string;
+export declare function flowMetadataPath(customerIdn: string, projectIdn: string, agentIdn: string, flowIdn: string): string;
+export declare function skillMetadataPath(customerIdn: string, projectIdn: string, agentIdn: string, flowIdn: string, skillIdn: string): string;
 export declare function metadataPath(customerIdn: string, projectIdn: string): string;
 export declare const ROOT_DIR: string;
 export declare const MAP_PATH: string;

package/dist/fsutil.js

@@ -28,10 +28,39 @@ export function projectDir(customerIdn, projectIdn) {
 export function flowsYamlPath(customerIdn) {
     return path.posix.join(customerProjectsDir(customerIdn), 'flows.yaml');
 }
+export function customerAttributesPath(customerIdn) {
+    return path.posix.join(customerDir(customerIdn), 'attributes.yaml');
+}
+export function customerAttributesMapPath(customerIdn) {
+    return path.join(customerStateDir(customerIdn), 'attributes-map.json');
+}
+// Legacy skill path - direct file
 export function skillPath(customerIdn, projectIdn, agentIdn, flowIdn, skillIdn, runnerType = 'guidance') {
     const extension = runnerType === 'nsl' ? '.jinja' : '.guidance';
     return path.posix.join(customerProjectsDir(customerIdn), projectIdn, agentIdn, flowIdn, `${skillIdn}${extension}`);
 }
+// New hierarchical structure paths
+export function skillFolderPath(customerIdn, projectIdn, agentIdn, flowIdn, skillIdn) {
+    return path.posix.join(customerProjectsDir(customerIdn), projectIdn, agentIdn, flowIdn, skillIdn);
+}
+export function skillScriptPath(customerIdn, projectIdn, agentIdn, flowIdn, skillIdn, runnerType = 'guidance') {
+    const extension = runnerType === 'nsl' ? '.jinja' : '.guidance';
+    return path.posix.join(skillFolderPath(customerIdn, projectIdn, agentIdn, flowIdn, skillIdn), `skill${extension}`);
+}
+// Metadata paths for hierarchical structure
+export function projectMetadataPath(customerIdn, projectIdn) {
+    return path.posix.join(customerProjectsDir(customerIdn), projectIdn, 'metadata.yaml');
+}
+export function agentMetadataPath(customerIdn, projectIdn, agentIdn) {
+    return path.posix.join(customerProjectsDir(customerIdn), projectIdn, agentIdn, 'metadata.yaml');
+}
+export function flowMetadataPath(customerIdn, projectIdn, agentIdn, flowIdn) {
+    return path.posix.join(customerProjectsDir(customerIdn), projectIdn, agentIdn, flowIdn, 'metadata.yaml');
+}
+export function skillMetadataPath(customerIdn, projectIdn, agentIdn, flowIdn, skillIdn) {
+    return path.posix.join(skillFolderPath(customerIdn, projectIdn, agentIdn, flowIdn, skillIdn), 'metadata.yaml');
+}
+// Legacy metadata path - keep for backwards compatibility
 export function metadataPath(customerIdn, projectIdn) {
     return path.posix.join(customerProjectsDir(customerIdn), projectIdn, 'metadata.json');
 }

package/dist/sync.d.ts

@@ -1,5 +1,6 @@
 import type { AxiosInstance } from 'axios';
 import type { ProjectData, CustomerConfig } from './types.js';
+export declare function saveCustomerAttributes(client: AxiosInstance, customer: CustomerConfig, verbose?: boolean): Promise<void>;
 export declare function pullSingleProject(client: AxiosInstance, customer: CustomerConfig, projectId: string, projectIdn: string, verbose?: boolean): Promise<ProjectData>;
 export declare function pullAll(client: AxiosInstance, customer: CustomerConfig, projectId?: string | null, verbose?: boolean): Promise<void>;
 export declare function pushChanged(client: AxiosInstance, customer: CustomerConfig, verbose?: boolean): Promise<void>;