# @accio-ai/ecommerce-cli npm package

This is the platform-independent launcher package for `ecomctl`.

It declares six exact-version optional dependencies. npm uses each dependency's `os` and `cpu` fields to install only the matching platform package, so users do not download binaries for other operating systems or architectures.

The platform package contains one statically compiled binary; this main package contains only the Node.js launcher, the shared target manifest, install checksum verification, README, and changelog. After checksum verification, `postinstall` best-effort initializes the local SQLite databases for a normal user. It does not read or write account state, credentials, user configuration, Agent skills, telemetry, or remote services.

Supported targets:

- macOS: arm64 and x64
- Linux: arm64 and x64
- Windows: arm64 and x64

Database setup is best-effort. Installs that disable lifecycle scripts, use an unsafe service identity, or encounter a database warning must run `ecomctl setup` before using read-only database commands. Domestic imports can initialize their own domain before writing; read-only commands do not initialize databases. Run `ecomctl doctor` after installation to verify the local environment.

The launcher invokes the platform binary with an argument array and no command shell. Release scripts invoke npm on Windows through `node.exe` and `npm-cli.js`. Package JSON readers accept a UTF-8 BOM and CRLF, while the executable launcher itself is packaged only with an LF shebang and no BOM.