@alteriom/mqtt-schema 0.3.1 → 0.3.2

package/README.md

@@ -226,7 +226,38 @@ Backward‑compatible additions: new optional properties or enums, documented in
 
 Issues & PRs welcome. Ensure firmware repo schemas remain the authoritative source—do not manually edit generated `schema_data.ts`.
 
-**Before opening a PR:** Run `npm run verify` to validate schemas, changelog, and tests.
+### Development Workflow
+
+**Before opening a PR:** Run the comprehensive validation suite:
+
+```bash
+npm run verify        # Schema sync + changelog + fixtures
+npm run verify:all    # Additional schema compilation + OTA manifest validation  
+npm test              # Enhanced fixture validation with detailed reporting
+```
+
+**Available validation scripts:**
+- `npm run test` - Cross-platform fixture validation (CJS/ESM) with enhanced error reporting
+- `npm run test:ota` - OTA manifest fixture validation
+- `npm run verify:schemas` - Ensure schemas are synced from source directory
+- `npm run verify:release` - Check changelog contains current version
+- `npm run verify:all` - Comprehensive schema compilation and fixture validation
+
+### Script Organization
+
+Scripts are organized by category in `package.json`:
+- **Build Scripts**: `build`, `build:cjs`, `build:esm`, `clean`, etc.
+- **Testing & Validation**: `test`, `verify:*`, etc.  
+- **Release Management**: `release:prepare`, `wiki:generate`
+- **Repository Metadata**: `metadata:*` (organization compliance)
+
+### Release Process
+
+See `PUBLISH_CHECKLIST.md` for detailed release procedures. Quick summary:
+1. Update schemas in `docs/mqtt_schema/`
+2. Run `npm run verify` to ensure everything is valid
+3. Use `npm run release:prepare -- patch|minor|major` for version bumping
+4. Follow checklist for tagging and publishing
 
 ## Security
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alteriom/mqtt-schema",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Alteriom MQTT v1 schemas, TypeScript types, and validation helpers for web integration",
   "license": "MIT",
   "author": "Alteriom Development Team",
@@ -87,25 +87,35 @@
     "node": ">=16.0.0"
   },
   "scripts": {
+    "// Build Scripts": "====================",
     "prebuild": "npm run clean && node scripts/copy-schemas.cjs",
     "build:cjs": "tsc -p tsconfig.json",
     "build:esm": "tsc -p tsconfig.esm.json && node scripts/post-esm.cjs",
     "build": "npm run build:cjs && npm run build:esm && node scripts/copy-schemas.cjs",
     "clean": "rimraf dist schemas",
     "prepare": "npm run build",
-    "lint": "echo 'No linter configured'",
+    
+    "// Testing & Validation": "====================",
+    "lint": "echo 'No linter configured - consider adding ESLint for future releases'",
     "test": "node test/validate-fixtures.cjs",
+    "test:ota": "node scripts/validate-ota-manifest.js",
     "verify:schemas": "node scripts/check-schema-sync.cjs",
     "verify:release": "node scripts/check-release-integrity.cjs",
     "verify": "npm run verify:schemas && npm run verify:release && npm test",
     "verify:all": "node scripts/verify_all.cjs",
+    
+    "// Release Management": "====================",
     "release:prepare": "node scripts/release-prepare.cjs",
     "wiki:generate": "node scripts/generate-wiki.cjs",
+    
+    "// Repository Metadata": "====================",
     "metadata:report": "alteriom-metadata report --org-tag alteriom || echo 'metadata report failed'",
     "metadata:validate": "alteriom-metadata validate --org-tag alteriom || echo 'metadata validate failed'",
     "metadata:apply": "alteriom-metadata apply --org-tag alteriom",
     "metadata:apply:dry": "alteriom-metadata dry-run --org-tag alteriom",
-    "validate:ota": "node scripts/validate-ota-manifest.js"
+    
+    "// Legacy Aliases": "====================",
+    "validate:ota": "npm run test:ota"
   },
   "keywords": [
     "alteriom",