workpadsdev-cli

Workpads KaiOS developer toolchain — build, package, and conform.

Install

npm install -g .

Or run directly:

node bin/workpadsdev.js <command>

Commands

build:3.0

Package a KaiOS 3.x app from source. Requires a manifest.webmanifest or manifest.webapp in the target directory. Produces a dated .zip in the output directory.

workpadsdev build:3.0 --target ./workpadskaios --out ./dist

build:2.5

KaiOS 2.5 support is planned for v0.2. This command is a stub that documents the intent.

workpadsdev build:2.5 --target ./workpadskaios

set-keys

Read a softkeys.yaml profile and validate/report its screen key assignments. Key injection into app source is planned for v0.2.

workpadsdev set-keys --profile ./system/config/softkeys.yaml --target ./workpadskaios

conform

Run workpads-specific conformance checks on a target directory. Checks:

Rule	Description
WP-CONF-001	Manifest file present
WP-CONF-002	@workpads/codec declared in package.json
WP-CONF-003	softkeys.yaml present
WP-CONF-004	Codec encode/decode round-trip (if @workpads/codec installed)

workpadsdev conform --target ./workpadskaios --write-report ./conform-report.json

Exit codes follow the BASICS-cli convention: 0 OK, 10 config error, 20 discovery error, 30 eval error, 40 blocking failures, 50 runtime error.

Dependencies

• @workpads/codec (file:../workpads-codec) — encode/decode workpad records

Tests

npm test

Status

v0.1.0 — build:3.0, set-keys, conform implemented. build:2.5 is a stub (v0.2).