neozip-cli 0.90.0 → 0.95.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "neozip-cli",
-  "version": "0.90.0",
-  "release_date": "2026-03-18",
+  "version": "0.95.1",
+  "release_date": "2026-07-07",
   "description": "A full-featured command-line ZIP application with NeoZipKit integration",
   "main": "dist/src/index.js",
   "bin": {
@@ -17,82 +17,86 @@
     "LICENSE",
     "CHANGELOG.md",
     "DOCUMENTATION.md",
-    "WHY_NEOZIP.md"
+    "WHY_NEOZIP.md",
+    "AGENTS.md",
+    "skills/"
   ],
   "preferGlobal": true,
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
-    "start": "npx ts-node src/neozip.ts tests/output/calgary.nzip tests/fixtures/calgary/*",
-    "dev": "npx ts-node --inspect src/neozip.ts tests/output/calgary.nzip tests/fixtures/calgary/*",
+    "start": "pnpm exec ts-node src/neozip.ts tests/output/calgary.nzip tests/fixtures/calgary/*",
+    "dev": "pnpm exec ts-node --inspect src/neozip.ts tests/output/calgary.nzip tests/fixtures/calgary/*",
     "build": "echo '🔨 Building TypeScript...' && tsc --pretty && echo '🧹 Removing neozipkit from dist (if present)...' && rm -rf dist/neozipkit && echo '✅ Build completed successfully!'",
     "build:clean": "echo '🧹 Cleaning dist directory...' && rm -rf dist && echo '🔨 Building TypeScript...' && tsc --pretty && echo '✅ Clean build completed successfully!'",
     "type-check": "tsc --noEmit",
     "clean": "rm -rf dist/* tests/output/*",
-    "pack": "npm run build && echo '📦 Creating package tarball...' && npm pack && echo '✅ Package created successfully!'",
-    "pack:dry-run": "npm run build && echo '📦 Previewing package contents...' && npm pack --dry-run",
+    "pack": "pnpm run build && echo '📦 Creating package tarball...' && pnpm pack && echo '✅ Package created successfully!'",
+    "pack:dry-run": "pnpm run build && echo '📦 Previewing package contents...' && pnpm exec npm pack --dry-run",
     "pack:clean": "rm -f neozip-cli-*.tgz && echo '🧹 Cleaned up package tarballs'",
-    "package": "npm run build && npm run pack",
-    "prepublishOnly": "npm run build",
-    "neozip": "npx ts-node src/neozip.ts -b -T tests/output/calgary.nzip tests/fixtures/calgary/*",
-    "neozip-sepolia": "npx ts-node src/neozip.ts -b -T --network sepolia-testnet tests/output/calgary.nzip tests/fixtures/calgary/*",
-    "neozip-base-sepolia": "npx ts-node src/neozip.ts -b -T --network base-sepolia tests/output/calgary.nzip tests/fixtures/calgary/*",
-    "neozip-base": "npx ts-node src/neozip.ts -b -T --network base-mainnet tests/output/calgary.nzip tests/fixtures/calgary/*",
-    "neozip-arbitrum-sepolia": "npx ts-node src/neozip.ts -b -T --network arbitrum-sepolia tests/output/calgary.nzip tests/fixtures/calgary/*",
-    "neozip-arbitrum": "npx ts-node src/neozip.ts -b -T --network arbitrum-one tests/output/calgary.nzip tests/fixtures/calgary/*",
-    "neozip-deflate": "npx ts-node src/neozip.ts --deflate -T tests/output/calgary.nzip tests/fixtures/calgary/*",
-    "neozip-inmem": "npx ts-node src/neozip.ts -b --in-memory -T tests/output/calgary.nzip tests/fixtures/calgary/*",
-    "neozip-store": "npx ts-node src/neozip.ts --level 0 -T tests/output/calgary-stored.nzip tests/fixtures/calgary/*",
-    "neozip-ots": "npx ts-node src/neozip.ts -ots -T tests/output/calgary-ots.nzip tests/fixtures/calgary/*",
-    "neozip-stamp": "npx ts-node src/neozip.ts -ts -T tests/output/calgary-stamp.nzip tests/fixtures/calgary/*",
+    "package": "pnpm run build && pnpm run pack",
+    "prepublishOnly": "pnpm run build",
+    "neozip": "pnpm exec ts-node src/neozip.ts -b -T tests/output/calgary.nzip tests/fixtures/calgary/*",
+    "neozip-sepolia": "pnpm exec ts-node src/neozip.ts -b -T --network sepolia-testnet tests/output/calgary.nzip tests/fixtures/calgary/*",
+    "neozip-base-sepolia": "pnpm exec ts-node src/neozip.ts -b -T --network base-sepolia tests/output/calgary.nzip tests/fixtures/calgary/*",
+    "neozip-base": "pnpm exec ts-node src/neozip.ts -b -T --network base-mainnet tests/output/calgary.nzip tests/fixtures/calgary/*",
+    "neozip-arbitrum-sepolia": "pnpm exec ts-node src/neozip.ts -b -T --network arbitrum-sepolia tests/output/calgary.nzip tests/fixtures/calgary/*",
+    "neozip-arbitrum": "pnpm exec ts-node src/neozip.ts -b -T --network arbitrum-one tests/output/calgary.nzip tests/fixtures/calgary/*",
+    "neozip-deflate": "pnpm exec ts-node src/neozip.ts --deflate -T tests/output/calgary.nzip tests/fixtures/calgary/*",
+    "neozip-inmem": "pnpm exec ts-node src/neozip.ts -b --in-memory -T tests/output/calgary.nzip tests/fixtures/calgary/*",
+    "neozip-store": "pnpm exec ts-node src/neozip.ts --level 0 -T tests/output/calgary-stored.nzip tests/fixtures/calgary/*",
+    "neozip-ots": "pnpm exec ts-node src/neozip.ts -ots -T tests/output/calgary-ots.nzip tests/fixtures/calgary/*",
+    "neozip-stamp": "pnpm exec ts-node src/neozip.ts -ts -T tests/output/calgary-stamp.nzip tests/fixtures/calgary/*",
     "neozip-mint": "node dist/src/neozip.js mint -o tests/output/calgary-stamp-upgrade.nzip tests/output/calgary-stamp-nft.nzip",
-    "neozip-encrypt": "npx ts-node src/neozip.ts --pkzip -P 'pass123' -T tests/output/calgary-encrypted.nzip tests/fixtures/calgary/*",
-    "neozip-encrypt-sm": "npx ts-node src/neozip.ts --pkzip -P 'pass123' -T tests/output/encrypted-sm.nzip tests/fixtures/test-sm/*",
-    "neozip-encrypt-aes": "npx ts-node src/neozip.ts -e -P 'pass123' tests/output/calgary-encrypted-aes.nzip tests/fixtures/calgary/*",
-    "neozip-encrypt-aes-sm": "npx ts-node src/neozip.ts -e -P 'pass123' tests/output/encrypted-aes-sm.nzip tests/fixtures/test-sm/*",
-    "neozip-encrypt-aes-explicit": "npx ts-node src/neozip.ts --aes256 -P 'pass123' tests/output/calgary-encrypted-aes-explicit.nzip tests/fixtures/calgary/*",
+    "neozip-encrypt": "pnpm exec ts-node src/neozip.ts --pkzip -P 'pass123' -T tests/output/calgary-encrypted.nzip tests/fixtures/calgary/*",
+    "neozip-encrypt-sm": "pnpm exec ts-node src/neozip.ts --pkzip -P 'pass123' -T tests/output/encrypted-sm.nzip tests/fixtures/test-sm/*",
+    "neozip-encrypt-aes": "pnpm exec ts-node src/neozip.ts -e -P 'pass123' tests/output/calgary-encrypted-aes.nzip tests/fixtures/calgary/*",
+    "neozip-encrypt-aes-sm": "pnpm exec ts-node src/neozip.ts -e -P 'pass123' tests/output/encrypted-aes-sm.nzip tests/fixtures/test-sm/*",
+    "neozip-encrypt-aes-explicit": "pnpm exec ts-node src/neozip.ts --aes256 -P 'pass123' tests/output/calgary-encrypted-aes-explicit.nzip tests/fixtures/calgary/*",
     "neozip-update": "node tests/scripts/test-update-option.js",
-    "neozip-sm": "npx ts-node src/neozip.ts -T tests/output/test-sm.nzip tests/fixtures/test-sm/*",
-    "neozip-init": "npx ts-node src/neozip.ts init",
-    "neozip-config": "npx ts-node src/neozip.ts config",
-    "verify-email": "node dist/src/neozip.js verify-email",
-    "neozip-help": "npx ts-node src/neozip.ts --help",
-    "neounzip": "npx ts-node src/neounzip.ts tests/output/calgary.nzip -t",
-    "neounzip-inmem": "npx ts-node src/neounzip.ts --in-memory -l tests/output/calgary.nzip -t",
-    "neounzip-bad": "npx ts-node src/neounzip.ts tests/output/calgary-bad.nzip -t",
-    "neounzip-bad-inmem": "npx ts-node src/neounzip.ts --in-memory tests/output/calgary-bad.nzip -t",
-    "neounzip-sm": "npx ts-node src/neounzip.ts -o tests/output/test-sm.nzip",
-    "neounzip-skip-blockchain": "npx ts-node src/neounzip.ts --skip-blockchain tests/output/calgary.nzip -t",
-    "neounzip-lg": "npx ts-node src/neounzip.ts tests/output/large.nzip -t",
-    "neounzip-stamp": "npx ts-node src/neounzip.ts tests/output/calgary-stamp.nzip -t",
-    "neounzip-stamp-upgrade": "npx ts-node src/neounzip.ts tests/output/calgary-stamp-upgrade.nzip -t",
-    "neounzip-ots": "npx ts-node src/neounzip.ts tests/output/calgary-ots.nzip -t",
-    "neounzip-ots-skip-blockchain": "npx ts-node src/neounzip.ts --skip-blockchain tests/output/calgary-ots.nzip -t",
-    "neounzip-streaming": "npx ts-node src/neounzip.ts --buffer-size 16384 --verbose tests/output/merged-test.nzip -t",
-    "neounzip-decrypt": "npx ts-node src/neounzip.ts --password 'pass123' tests/output/calgary-encrypted.nzip -t",
-    "neounzip-decrypt-inmem": "npx ts-node src/neounzip.ts --in-memory --password 'pass123' tests/output/calgary-encrypted.nzip -t",
-    "neounzip-decrypt-stored": "npx ts-node src/neounzip.ts --in-memory --password 'pass123' tests/output/calgary-encrypted-stored.nzip -t",
-    "neounzip-decrypt-sm": "npx ts-node src/neounzip.ts --password 'pass123' tests/output/encrypted-sm.nzip -t",
-    "neounzip-decrypt-sm-inmem": "npx ts-node src/neounzip.ts --in-memory --password 'pass123' tests/output/encrypted-sm.nzip -t",
-    "neounzip-decrypt-pkzip": "npx ts-node src/neounzip.ts --pkzip-decrypt --password 'legacy-test-123' tests/output/calgary-pkzip.nzip -t",
-    "neounzip-decrypt-aes": "npx ts-node src/neounzip.ts --password 'pass123' tests/output/calgary-encrypted-aes.nzip -t",
-    "neounzip-decrypt-aes-inmem": "npx ts-node src/neounzip.ts --in-memory --password 'pass123' tests/output/calgary-encrypted-aes.nzip -t",
-    "neounzip-decrypt-aes-sm": "npx ts-node src/neounzip.ts --password 'pass123' tests/output/encrypted-aes-sm.nzip -t",
-    "neounzip-help": "npx ts-node src/neounzip.ts --help",
-    "neolist": "npx ts-node src/neolist.ts tests/output/calgary.nzip",
-    "neolist-inmem": "npx ts-node src/neolist.ts --in-memory tests/output/calgary.nzip",
-    "neolist-basic": "npx ts-node src/neolist.ts -b tests/output/calgary.nzip",
-    "neolist-verbose": "npx ts-node src/neolist.ts -v tests/output/calgary.nzip",
-    "neolist-demo": "npx ts-node src/neolist.ts tests/output/calgary.nzip",
-    "neolist-short": "npx ts-node src/neolist.ts -s tests/output/calgary.nzip",
-    "neolist-unix": "npx ts-node src/neolist.ts -u tests/output/calgary.nzip",
-    "neolist-json": "npx ts-node src/neolist.ts -j tests/output/calgary.nzip",
-    "neolist-zip64": "npx ts-node src/neolist.ts tests/fixtures/calgary-zip64.zip",
-    "neolist-stamp": "npx ts-node src/neolist.ts tests/output/calgary-stamp.nzip",
-    "neolist-stamp-upgrade": "npx ts-node src/neolist.ts tests/output/calgary-stamp-upgrade.nzip",
-    "neolist-encrypted-aes": "npx ts-node src/neolist.ts -v tests/output/calgary-encrypted-aes.nzip",
-    "neolist-help": "npx ts-node src/neolist.ts --help",
+    "neozip-sm": "pnpm exec ts-node src/neozip.ts -T tests/output/test-sm.nzip tests/fixtures/test-sm/*",
+    "neozip-init": "pnpm exec ts-node src/neozip.ts init",
+    "neozip-connect": "pnpm exec ts-node src/neozip.ts connect",
+    "neozip-skills": "pnpm exec ts-node src/neozip.ts skills",
+    "neozip-config": "pnpm exec ts-node src/neozip.ts config",
+    "neozip-fund": "pnpm exec ts-node src/neozip.ts connect fund",
+    "neozip-help": "pnpm exec ts-node src/neozip.ts --help",
+    "neounzip": "pnpm exec ts-node src/neounzip.ts tests/output/calgary.nzip -t",
+    "neounzip-inmem": "pnpm exec ts-node src/neounzip.ts --in-memory -l tests/output/calgary.nzip -t",
+    "neounzip-bad": "pnpm exec ts-node src/neounzip.ts tests/output/calgary-bad.nzip -t",
+    "neounzip-bad-inmem": "pnpm exec ts-node src/neounzip.ts --in-memory tests/output/calgary-bad.nzip -t",
+    "neounzip-sm": "pnpm exec ts-node src/neounzip.ts -o tests/output/test-sm.nzip",
+    "neounzip-skip-blockchain": "pnpm exec ts-node src/neounzip.ts --skip-blockchain tests/output/calgary.nzip -t",
+    "neounzip-lg": "pnpm exec ts-node src/neounzip.ts tests/output/large.nzip -t",
+    "neounzip-stamp": "pnpm exec ts-node src/neounzip.ts tests/output/calgary-stamp.nzip -t",
+    "neounzip-stamp-upgrade": "pnpm exec ts-node src/neounzip.ts tests/output/calgary-stamp-upgrade.nzip -t",
+    "neounzip-ots": "pnpm exec ts-node src/neounzip.ts tests/output/calgary-ots.nzip -t",
+    "neounzip-ots-skip-blockchain": "pnpm exec ts-node src/neounzip.ts --skip-blockchain tests/output/calgary-ots.nzip -t",
+    "neounzip-streaming": "pnpm exec ts-node src/neounzip.ts --buffer-size 16384 --verbose tests/output/merged-test.nzip -t",
+    "neounzip-decrypt": "pnpm exec ts-node src/neounzip.ts --password 'pass123' tests/output/calgary-encrypted.nzip -t",
+    "neounzip-decrypt-inmem": "pnpm exec ts-node src/neounzip.ts --in-memory --password 'pass123' tests/output/calgary-encrypted.nzip -t",
+    "neounzip-decrypt-stored": "pnpm exec ts-node src/neounzip.ts --in-memory --password 'pass123' tests/output/calgary-encrypted-stored.nzip -t",
+    "neounzip-decrypt-sm": "pnpm exec ts-node src/neounzip.ts --password 'pass123' tests/output/encrypted-sm.nzip -t",
+    "neounzip-decrypt-sm-inmem": "pnpm exec ts-node src/neounzip.ts --in-memory --password 'pass123' tests/output/encrypted-sm.nzip -t",
+    "neounzip-decrypt-pkzip": "pnpm exec ts-node src/neounzip.ts --pkzip-decrypt --password 'legacy-test-123' tests/output/calgary-pkzip.nzip -t",
+    "neounzip-decrypt-aes": "pnpm exec ts-node src/neounzip.ts --password 'pass123' tests/output/calgary-encrypted-aes.nzip -t",
+    "neounzip-decrypt-aes-inmem": "pnpm exec ts-node src/neounzip.ts --in-memory --password 'pass123' tests/output/calgary-encrypted-aes.nzip -t",
+    "neounzip-decrypt-aes-sm": "pnpm exec ts-node src/neounzip.ts --password 'pass123' tests/output/encrypted-aes-sm.nzip -t",
+    "neounzip-help": "pnpm exec ts-node src/neounzip.ts --help",
+    "neolist": "pnpm exec ts-node src/neolist.ts tests/output/calgary.nzip",
+    "neolist-inmem": "pnpm exec ts-node src/neolist.ts --in-memory tests/output/calgary.nzip",
+    "neolist-basic": "pnpm exec ts-node src/neolist.ts -b tests/output/calgary.nzip",
+    "neolist-verbose": "pnpm exec ts-node src/neolist.ts -v tests/output/calgary.nzip",
+    "neolist-demo": "pnpm exec ts-node src/neolist.ts tests/output/calgary.nzip",
+    "neolist-short": "pnpm exec ts-node src/neolist.ts -s tests/output/calgary.nzip",
+    "neolist-unix": "pnpm exec ts-node src/neolist.ts -u tests/output/calgary.nzip",
+    "neolist-json": "pnpm exec ts-node src/neolist.ts -j tests/output/calgary.nzip",
+    "neolist-zip64": "pnpm exec ts-node src/neolist.ts tests/fixtures/calgary-zip64.zip",
+    "neolist-stamp": "pnpm exec ts-node src/neolist.ts tests/output/calgary-stamp.nzip",
+    "neolist-stamp-upgrade": "pnpm exec ts-node src/neolist.ts tests/output/calgary-stamp-upgrade.nzip",
+    "neolist-encrypted-aes": "pnpm exec ts-node src/neolist.ts -v tests/output/calgary-encrypted-aes.nzip",
+    "neolist-help": "pnpm exec ts-node src/neolist.ts --help",
     "infozip-encrypt-zip": "zip -e -P 'pass123' -r tests/fixtures/infozip/calgary-encrypted.zip tests/fixtures/calgary/*",
     "infozip-encrypt-sm": "zip -e -P 'pass123' -0 tests/fixtures/infozip/encrypted-sm.zip tests/fixtures/test-sm/*",
     "infozip-encrypt-stored": "zip -e -P 'pass123' -0 tests/fixtures/infozip/calgary-encrypted-stored.zip tests/fixtures/calgary/bib",
@@ -105,20 +109,20 @@
     "test:neozip": "node tests/scripts/comprehensive/test-neozip-options.js",
     "test:neounzip": "node tests/scripts/comprehensive/test-neounzip-options.js",
     "test:neolist": "node tests/scripts/comprehensive/test-neolist-options.js",
-    "test:encryption": "npm run neozip-encrypt-aes && npm run neounzip-decrypt-aes && npm run neozip-encrypt && npm run neounzip-decrypt && echo '✅ All encryption tests (AES-256 + PKZIP) completed successfully!'",
-    "test:encryption-aes": "npm run neozip-encrypt-aes && npm run neounzip-decrypt-aes && npm run neounzip-decrypt-aes-inmem && echo '✅ AES-256 encryption tests completed successfully!'",
-    "test:stamp": "echo '=== Testing Timestamp Support ===' && npm run neozip-ots && npm run neounzip-ots && echo '' && echo '--- Zipstamp (may fail if server unreachable) ---' && (npm run neozip-zipstamp && npm run neounzip-zipstamp && echo '✅ Zipstamp tests completed') || echo '⚠️ Zipstamp skipped (server may be unreachable)' && echo '' && echo '✅ Timestamp tests completed successfully!'",
-    "test:infozip-decrypt": "npx ts-node tests/scripts/test-infozip-decrypt.ts",
+    "test:encryption": "pnpm run neozip-encrypt-aes && pnpm run neounzip-decrypt-aes && pnpm run neozip-encrypt && pnpm run neounzip-decrypt && echo '✅ All encryption tests (AES-256 + PKZIP) completed successfully!'",
+    "test:encryption-aes": "pnpm run neozip-encrypt-aes && pnpm run neounzip-decrypt-aes && pnpm run neounzip-decrypt-aes-inmem && echo '✅ AES-256 encryption tests completed successfully!'",
+    "test:stamp": "echo '=== Testing Timestamp Support ===' && pnpm run neozip-ots && pnpm run neounzip-ots && echo '' && echo '--- Token Service (may fail if server unreachable) ---' && (pnpm run neozip-stamp && pnpm run neounzip-stamp && echo '✅ Token Service tests completed') || echo '⚠️ Token Service skipped (server may be unreachable)' && echo '' && echo '✅ Timestamp tests completed successfully!'",
+    "test:infozip-decrypt": "pnpm exec ts-node tests/scripts/test-infozip-decrypt.ts",
     "test:comments": "node tests/scripts/comprehensive/test-comments-options.js",
     "test:update": "node tests/scripts/test-update-option.js",
-    "test:symlinks": "echo '=== Testing Symbolic Links ===' && rm -rf tests/output/symlinks-temp && rm -rf tests/output/symlinks* 2>/dev/null; rm -rf tests/output/symlinks*.nzip 2>/dev/null; mkdir -p tests/output/symlinks-temp && echo 'This is the target file content' > tests/output/symlinks-temp/target.txt && ln -sf target.txt tests/output/symlinks-temp/symlink.txt && echo -e '\\n--- Original files ---' && ls -la tests/output/symlinks-temp/ && echo -e '\\n--- Creating ZIP with -y (store symlinks) ---' && npx ts-node src/neozip.ts -y tests/output/symlinks-test.nzip tests/output/symlinks-temp/* && echo -e '\\n--- Extracting with -y (restore symlinks) ---' && mkdir -p tests/output/symlinks && npx ts-node src/neounzip.ts -y tests/output/symlinks-test.nzip tests/output/symlinks/ && echo -e '\\n--- Extracted files ---' && ls -la tests/output/symlinks/tests/output/symlinks-temp/ 2>/dev/null || ls -la tests/output/symlinks/ && echo -e '\\n--- Testing symlink functionality ---' && (test -L tests/output/symlinks/tests/output/symlinks-temp/symlink.txt 2>/dev/null && cat tests/output/symlinks/tests/output/symlinks-temp/symlink.txt > /dev/null 2>&1 && echo '✅ PASS: Symlink test completed successfully') || (test -L tests/output/symlinks/symlink.txt 2>/dev/null && cat tests/output/symlinks/symlink.txt > /dev/null 2>&1 && echo '✅ PASS: Symlink test completed successfully') || echo '❌ FAIL: Symlink was not created or does not work' && echo -e '\\n--- Creating ZIP without -y (follow symlinks) ---' && npx ts-node src/neozip.ts tests/output/symlinks-follow.nzip tests/output/symlinks-temp/* && echo -e '\\n--- Extracting without -y (regular files) ---' && mkdir -p tests/output/symlinks-follow && npx ts-node src/neounzip.ts tests/output/symlinks-follow.nzip tests/output/symlinks-follow/ && echo -e '\\n--- Extracted files (no symlinks) ---' && ls -la tests/output/symlinks-follow/tests/output/symlinks-temp/ 2>/dev/null || ls -la tests/output/symlinks-follow/ && rm -rf tests/output/symlinks-temp && rm -rf tests/output/symlinks* 2>/dev/null; rm -rf tests/output/symlinks*.nzip 2>/dev/null",
-    "test:hardlinks": "echo '=== Testing Hard Links ===' && rm -rf tests/output/hardlinks-temp && rm -rf tests/output/hardlinks* 2>/dev/null; rm -rf tests/output/hardlinks*.nzip 2>/dev/null; mkdir -p tests/output/hardlinks-temp && echo 'This is the original file content for hard link testing' > tests/output/hardlinks-temp/original.txt && ln tests/output/hardlinks-temp/original.txt tests/output/hardlinks-temp/hardlink1.txt && ln tests/output/hardlinks-temp/original.txt tests/output/hardlinks-temp/hardlink2.txt && echo -e '\\n--- Original files (note same inode numbers) ---' && ls -li tests/output/hardlinks-temp/ && echo -e '\\n--- Creating ZIP with -H (detect hard links) ---' && npx ts-node src/neozip.ts -H tests/output/hardlinks-test.nzip tests/output/hardlinks-temp/* && echo -e '\\n--- Extracting with -H (restore hard links) ---' && mkdir -p tests/output/hardlinks && npx ts-node src/neounzip.ts -H tests/output/hardlinks-test.nzip tests/output/hardlinks/ && echo -e '\\n--- Extracted files (note same inode numbers) ---' && ls -li tests/output/hardlinks/tests/output/hardlinks-temp/ 2>/dev/null || ls -li tests/output/hardlinks/ && echo -e '\\n--- Testing hard link functionality ---' && HARD_LINK1=\"tests/output/hardlinks/tests/output/hardlinks-temp/hardlink1.txt\"; HARD_LINK2=\"tests/output/hardlinks/tests/output/hardlinks-temp/hardlink2.txt\"; ORIGINAL=\"tests/output/hardlinks/tests/output/hardlinks-temp/original.txt\"; test -f \"$HARD_LINK1\" || HARD_LINK1=\"tests/output/hardlinks/hardlink1.txt\"; test -f \"$HARD_LINK2\" || HARD_LINK2=\"tests/output/hardlinks/hardlink2.txt\"; test -f \"$ORIGINAL\" || ORIGINAL=\"tests/output/hardlinks/original.txt\"; (test -f \"$HARD_LINK1\" && test -f \"$ORIGINAL\" && echo 'Modified content' >> \"$HARD_LINK1\" 2>/dev/null && cat \"$ORIGINAL\" > /dev/null 2>&1 && echo '✅ PASS: Hard links test (with -H) completed') || echo '⚠️  WARN: Hard links extraction may have issues' && echo -e '\\n--- Creating ZIP without -H (store as copies) ---' && npx ts-node src/neozip.ts tests/output/hardlinks-copies.nzip tests/output/hardlinks-temp/* && echo -e '\\n--- Extracting without -H (separate files) ---' && mkdir -p tests/output/hardlinks-copies && npx ts-node src/neounzip.ts tests/output/hardlinks-copies.nzip tests/output/hardlinks-copies/ && echo -e '\\n--- Extracted files (different inodes) ---' && ls -li tests/output/hardlinks-copies/tests/output/hardlinks-temp/ 2>/dev/null || ls -li tests/output/hardlinks-copies/ && echo -e '\\n=== TEST SUMMARY ===' && (test -f tests/output/hardlinks-copies/tests/output/hardlinks-temp/original.txt 2>/dev/null || test -f tests/output/hardlinks-copies/original.txt 2>/dev/null) && echo '✅ PASS: Hard links test completed successfully' || echo '❌ FAIL: Some hard link tests failed' && rm -rf tests/output/hardlinks-temp && rm -rf tests/output/hardlinks* 2>/dev/null; rm -rf tests/output/hardlinks*.nzip 2>/dev/null",
-    "test:stdin": "echo '=== Testing Stdin Filenames ===' && mkdir -p tests/output/stdin-temp && echo 'Test file 1' > tests/output/stdin-temp/file1.txt && echo 'Test file 2' > tests/output/stdin-temp/file2.txt && echo 'Test file 3' > tests/output/stdin-temp/file3.txt && echo '' && echo '--- Testing stdin filenames with -@ ---' && printf 'tests/output/stdin-temp/file1.txt\\ntests/output/stdin-temp/file2.txt\\ntests/output/stdin-temp/file3.txt\\n' | npx ts-node src/neozip.ts -@ tests/output/test-stdin.zip && echo '' && echo '--- Verifying archive contents ---' && npx ts-node src/neolist.ts tests/output/test-stdin.zip && echo '' && echo '--- Testing with find command ---' && find tests/output/stdin-temp -name '*.txt' | npx ts-node src/neozip.ts -@ tests/output/test-stdin-find.zip && npx ts-node src/neolist.ts tests/output/test-stdin-find.zip && echo '' && echo '--- Cleanup ---' && rm -rf tests/output/stdin-temp tests/output/test-stdin.zip tests/output/test-stdin-find.zip && echo '✅ Stdin filenames test completed successfully!'",
-    "test:eocd": "npx ts-node tests/scripts/test-eocd-loading.ts",
-    "test:copy-entry": "npx ts-node tests/scripts/test-copy-entry-streaming.ts",
-    "test:tampered-zip": "npx ts-node tests/scripts/test-tampered-verification.ts",
-    "test:upgrade-zip": "echo '=== Testing ZIP Upgrade ===' && mkdir -p tests/output && echo '' && echo '--- Creating initial ZIP with Calgary corpus files (deflate compression) ---' && npx ts-node src/neozip.ts --deflate tests/output/test-upgrade.nzip tests/fixtures/calgary/bib tests/fixtures/calgary/book1 tests/fixtures/calgary/book2 && echo '' && echo '--- Upgrading ZIP for tokenization ---' && npx ts-node src/neozip.ts --upgrade tests/output/test-upgrade.nzip && echo '' && echo '--- Listing upgraded ZIP contents ---' && npx ts-node src/neolist.ts tests/output/test-upgrade-tokenized.nzip && echo '' && echo '--- Verifying upgraded ZIP with neounzip -t ---' && npx ts-node src/neounzip.ts -t tests/output/test-upgrade-tokenized.nzip && echo '' && echo '✅ ZIP upgrade test completed successfully!'",
-    "test:pre-verify": "echo '=== Testing Pre-Verify Option (-T) ===' && echo '' && echo '--- Testing pre-verify on tokenized ZIP ---' && npx ts-node src/neounzip.ts -T tests/output/test-upgrade-tokenized.nzip tests/output/preverify/ && echo '' && echo '--- Testing pre-verify on non-tokenized ZIP ---' && npx ts-node src/neozip.ts --deflate tests/output/test-preverify-nontoken.nzip tests/fixtures/calgary/bib tests/fixtures/calgary/book1 tests/fixtures/calgary/book2 && npx ts-node src/neounzip.ts -T tests/output/test-preverify-nontoken.nzip tests/output/preverify-nontoken/ && rm -rf tests/output/preverify* tests/output/test-preverify-nontoken.nzip 2>/dev/null && echo '' && echo '✅ Pre-verify test completed successfully!'",
+    "test:symlinks": "echo '=== Testing Symbolic Links ===' && rm -rf tests/output/symlinks-temp && rm -rf tests/output/symlinks* 2>/dev/null; rm -rf tests/output/symlinks*.nzip 2>/dev/null; mkdir -p tests/output/symlinks-temp && echo 'This is the target file content' > tests/output/symlinks-temp/target.txt && ln -sf target.txt tests/output/symlinks-temp/symlink.txt && echo -e '\\n--- Original files ---' && ls -la tests/output/symlinks-temp/ && echo -e '\\n--- Creating ZIP with -y (store symlinks) ---' && pnpm exec ts-node src/neozip.ts -y tests/output/symlinks-test.nzip tests/output/symlinks-temp/* && echo -e '\\n--- Extracting with -y (restore symlinks) ---' && mkdir -p tests/output/symlinks && pnpm exec ts-node src/neounzip.ts -y tests/output/symlinks-test.nzip tests/output/symlinks/ && echo -e '\\n--- Extracted files ---' && ls -la tests/output/symlinks/tests/output/symlinks-temp/ 2>/dev/null || ls -la tests/output/symlinks/ && echo -e '\\n--- Testing symlink functionality ---' && (test -L tests/output/symlinks/tests/output/symlinks-temp/symlink.txt 2>/dev/null && cat tests/output/symlinks/tests/output/symlinks-temp/symlink.txt > /dev/null 2>&1 && echo '✅ PASS: Symlink test completed successfully') || (test -L tests/output/symlinks/symlink.txt 2>/dev/null && cat tests/output/symlinks/symlink.txt > /dev/null 2>&1 && echo '✅ PASS: Symlink test completed successfully') || echo '❌ FAIL: Symlink was not created or does not work' && echo -e '\\n--- Creating ZIP without -y (follow symlinks) ---' && pnpm exec ts-node src/neozip.ts tests/output/symlinks-follow.nzip tests/output/symlinks-temp/* && echo -e '\\n--- Extracting without -y (regular files) ---' && mkdir -p tests/output/symlinks-follow && pnpm exec ts-node src/neounzip.ts tests/output/symlinks-follow.nzip tests/output/symlinks-follow/ && echo -e '\\n--- Extracted files (no symlinks) ---' && ls -la tests/output/symlinks-follow/tests/output/symlinks-temp/ 2>/dev/null || ls -la tests/output/symlinks-follow/ && rm -rf tests/output/symlinks-temp && rm -rf tests/output/symlinks* 2>/dev/null; rm -rf tests/output/symlinks*.nzip 2>/dev/null",
+    "test:hardlinks": "echo '=== Testing Hard Links ===' && rm -rf tests/output/hardlinks-temp && rm -rf tests/output/hardlinks* 2>/dev/null; rm -rf tests/output/hardlinks*.nzip 2>/dev/null; mkdir -p tests/output/hardlinks-temp && echo 'This is the original file content for hard link testing' > tests/output/hardlinks-temp/original.txt && ln tests/output/hardlinks-temp/original.txt tests/output/hardlinks-temp/hardlink1.txt && ln tests/output/hardlinks-temp/original.txt tests/output/hardlinks-temp/hardlink2.txt && echo -e '\\n--- Original files (note same inode numbers) ---' && ls -li tests/output/hardlinks-temp/ && echo -e '\\n--- Creating ZIP with -H (detect hard links) ---' && pnpm exec ts-node src/neozip.ts -H tests/output/hardlinks-test.nzip tests/output/hardlinks-temp/* && echo -e '\\n--- Extracting with -H (restore hard links) ---' && mkdir -p tests/output/hardlinks && pnpm exec ts-node src/neounzip.ts -H tests/output/hardlinks-test.nzip tests/output/hardlinks/ && echo -e '\\n--- Extracted files (note same inode numbers) ---' && ls -li tests/output/hardlinks/tests/output/hardlinks-temp/ 2>/dev/null || ls -li tests/output/hardlinks/ && echo -e '\\n--- Testing hard link functionality ---' && HARD_LINK1=\"tests/output/hardlinks/tests/output/hardlinks-temp/hardlink1.txt\"; HARD_LINK2=\"tests/output/hardlinks/tests/output/hardlinks-temp/hardlink2.txt\"; ORIGINAL=\"tests/output/hardlinks/tests/output/hardlinks-temp/original.txt\"; test -f \"$HARD_LINK1\" || HARD_LINK1=\"tests/output/hardlinks/hardlink1.txt\"; test -f \"$HARD_LINK2\" || HARD_LINK2=\"tests/output/hardlinks/hardlink2.txt\"; test -f \"$ORIGINAL\" || ORIGINAL=\"tests/output/hardlinks/original.txt\"; (test -f \"$HARD_LINK1\" && test -f \"$ORIGINAL\" && echo 'Modified content' >> \"$HARD_LINK1\" 2>/dev/null && cat \"$ORIGINAL\" > /dev/null 2>&1 && echo '✅ PASS: Hard links test (with -H) completed') || echo '⚠️  WARN: Hard links extraction may have issues' && echo -e '\\n--- Creating ZIP without -H (store as copies) ---' && pnpm exec ts-node src/neozip.ts tests/output/hardlinks-copies.nzip tests/output/hardlinks-temp/* && echo -e '\\n--- Extracting without -H (separate files) ---' && mkdir -p tests/output/hardlinks-copies && pnpm exec ts-node src/neounzip.ts tests/output/hardlinks-copies.nzip tests/output/hardlinks-copies/ && echo -e '\\n--- Extracted files (different inodes) ---' && ls -li tests/output/hardlinks-copies/tests/output/hardlinks-temp/ 2>/dev/null || ls -li tests/output/hardlinks-copies/ && echo -e '\\n=== TEST SUMMARY ===' && (test -f tests/output/hardlinks-copies/tests/output/hardlinks-temp/original.txt 2>/dev/null || test -f tests/output/hardlinks-copies/original.txt 2>/dev/null) && echo '✅ PASS: Hard links test completed successfully' || echo '❌ FAIL: Some hard link tests failed' && rm -rf tests/output/hardlinks-temp && rm -rf tests/output/hardlinks* 2>/dev/null; rm -rf tests/output/hardlinks*.nzip 2>/dev/null",
+    "test:stdin": "echo '=== Testing Stdin Filenames ===' && mkdir -p tests/output/stdin-temp && echo 'Test file 1' > tests/output/stdin-temp/file1.txt && echo 'Test file 2' > tests/output/stdin-temp/file2.txt && echo 'Test file 3' > tests/output/stdin-temp/file3.txt && echo '' && echo '--- Testing stdin filenames with -@ ---' && printf 'tests/output/stdin-temp/file1.txt\\ntests/output/stdin-temp/file2.txt\\ntests/output/stdin-temp/file3.txt\\n' | pnpm exec ts-node src/neozip.ts -@ tests/output/test-stdin.zip && echo '' && echo '--- Verifying archive contents ---' && pnpm exec ts-node src/neolist.ts tests/output/test-stdin.zip && echo '' && echo '--- Testing with find command ---' && find tests/output/stdin-temp -name '*.txt' | pnpm exec ts-node src/neozip.ts -@ tests/output/test-stdin-find.zip && pnpm exec ts-node src/neolist.ts tests/output/test-stdin-find.zip && echo '' && echo '--- Cleanup ---' && rm -rf tests/output/stdin-temp tests/output/test-stdin.zip tests/output/test-stdin-find.zip && echo '✅ Stdin filenames test completed successfully!'",
+    "test:eocd": "pnpm exec ts-node tests/scripts/test-eocd-loading.ts",
+    "test:copy-entry": "pnpm exec ts-node tests/scripts/test-copy-entry-streaming.ts",
+    "test:tampered-zip": "pnpm exec ts-node tests/scripts/test-tampered-verification.ts",
+    "test:upgrade-zip": "echo '=== Testing ZIP Upgrade ===' && mkdir -p tests/output && echo '' && echo '--- Creating initial ZIP with Calgary corpus files (deflate compression) ---' && pnpm exec ts-node src/neozip.ts --deflate tests/output/test-upgrade.nzip tests/fixtures/calgary/bib tests/fixtures/calgary/book1 tests/fixtures/calgary/book2 && echo '' && echo '--- Upgrading ZIP for tokenization ---' && pnpm exec ts-node src/neozip.ts --upgrade tests/output/test-upgrade.nzip && echo '' && echo '--- Listing upgraded ZIP contents ---' && pnpm exec ts-node src/neolist.ts tests/output/test-upgrade-tokenized.nzip && echo '' && echo '--- Verifying upgraded ZIP with neounzip -t ---' && pnpm exec ts-node src/neounzip.ts -t tests/output/test-upgrade-tokenized.nzip && echo '' && echo '✅ ZIP upgrade test completed successfully!'",
+    "test:pre-verify": "echo '=== Testing Pre-Verify Option (-T) ===' && echo '' && echo '--- Testing pre-verify on tokenized ZIP ---' && pnpm exec ts-node src/neounzip.ts -T tests/output/test-upgrade-tokenized.nzip tests/output/preverify/ && echo '' && echo '--- Testing pre-verify on non-tokenized ZIP ---' && pnpm exec ts-node src/neozip.ts --deflate tests/output/test-preverify-nontoken.nzip tests/fixtures/calgary/bib tests/fixtures/calgary/book1 tests/fixtures/calgary/book2 && pnpm exec ts-node src/neounzip.ts -T tests/output/test-preverify-nontoken.nzip tests/output/preverify-nontoken/ && rm -rf tests/output/preverify* tests/output/test-preverify-nontoken.nzip 2>/dev/null && echo '' && echo '✅ Pre-verify test completed successfully!'",
     "test:package": "node tests/scripts/test-package.js",
     "switch:neozipkit:dev": "node scripts/switch-neozip-blockchain.js dev neozipkit",
     "switch:neozipkit:prod": "node scripts/switch-neozip-blockchain.js prod neozipkit",
@@ -154,9 +158,8 @@
     "minimatch": "^10.0.3",
     "moment": "^2.29.4",
     "moment-timezone": "^0.5.43",
-    "neozip-blockchain": "npm:neozip-blockchain@latest",
-    "neozip-cli": "^0.80.0",
-    "neozipkit": "npm:neozipkit@latest",
+    "neozip-blockchain": "^0.8.0",
+    "neozipkit": "^0.8.0",
     "opentimestamps": "^0.4.9",
     "ora": "^5.4.1",
     "pako": "^2.1.0",
@@ -175,7 +178,8 @@
     "esbuild": "^0.27.0"
   },
   "engines": {
-    "node": ">=16.0.0"
+    "node": ">=16.0.0",
+    "pnpm": ">=10.0.0"
   },
   "repository": {
     "type": "git",
@@ -185,5 +189,8 @@
     "url": "https://github.com/NeoWareInc/neozip-support/issues"
   },
   "homepage": "https://github.com/NeoWareInc/neozip-cli#readme",
-  "packageManager": "yarn@4.12.0"
+  "packageManager": "pnpm@10.12.1",
+  "pnpm": {
+    "overrides": {}
+  }
 }

package/skills/neozip-connect/SKILL.md

@@ -0,0 +1,95 @@
+---
+name: neozip-connect
+description: "Set up the NeoZip Token Service account and wallet via neozip connect, required before blockchain tokenization/timestamping operations."
+metadata:
+  version: 0.90.0
+  openclaw:
+    category: "productivity"
+    requires:
+      bins:
+        - neozip
+      skills:
+        - neozip-shared
+    cliHelp: "neozip connect --help"
+---
+
+# Token Service setup (`neozip connect`)
+
+Blockchain features (`neozip -b`, `-ts`, `mint`) require a connection in
+`~/.neozip/connection/` (shared with NeoZip Desktop and the neozip-mcp server).
+
+## Structured output
+
+Pass `--json` to any non-interactive subcommand for a `ConnectCliResult`:
+
+```json
+{ "phase": "...", "connectionId": "...", "message": "...", "nextCommand": "..." }
+```
+
+The bare wizard (`neozip connect` with no subcommand) requires a TTY — do not
+call it from a non-interactive agent; use the explicit subcommands instead.
+
+## Common subcommands
+
+```bash
+neozip connect status --json
+neozip connect register --email you@example.com --json
+neozip connect verify --email you@example.com --code 123456 --json
+neozip connect refresh --email you@example.com --json            # sends a code
+neozip connect refresh --email you@example.com --code 123456 --json
+neozip connect wallet create --ack-backup --json
+neozip connect finish --json
+neozip connect migrate --json
+neozip connect fund --json                                       # request gas (default)
+neozip connect fund status --json                                # eligibility, no spend
+neozip connect fund policy --json                                # grant size/cooldown, no auth
+```
+
+## Funding the Data Wallet (`neozip connect fund`)
+
+On-chain operations (`-b`, `-ts`, `-ots`, `mint`) need native gas in the local
+Data Wallet. The Token Service can send a small fixed grant to your **primary
+linked wallet** (recipient is server-authoritative — the client cannot redirect
+funds). Policy is fixed per chain (e.g. 0.001 ETH per grant, 4-hour cooldown).
+
+```bash
+neozip connect fund policy --json            # grant size + cooldown (no auth)
+neozip connect fund status --json            # recipient, last/next-eligible, recent grants
+neozip connect fund --json                   # request a grant (default action)
+neozip connect fund --chain 84532 --json     # target a specific chain id
+neozip connect fund --network base-sepolia --json
+```
+
+- The chain defaults to the connection's `defaultNetwork` (override with
+  `--network NAME` or `--chain ID`).
+- `status` and `request` need a current access token; an expired one is silently
+  renewed via wallet signature first (same as `connect refresh`).
+- A second `request` inside the cooldown returns a non-zero exit with an
+  `errorCode: "COOLDOWN"` and `nextEligibleAt` — not a double spend.
+- Older Token Service deployments without funding return a clear message and
+  point to the public faucet as a fallback.
+
+## Expired access tokens
+
+The Token Service access token expires over time. `connect status --json --verbose`
+reports it per account as `accessTokenExpired` / `accessTokenExpiresAt`.
+
+- An expired token blocks **`-ts`** (Token Service timestamp) but **not** `-b`
+  tokenization or `mint`, which sign on-chain with the local wallet key.
+- `connect refresh` prefers a **silent wallet-signature login**: it signs a
+  challenge with the local Data Wallet key and receives a fresh token with no
+  email round-trip. Just run `neozip connect refresh --json` (no code needed).
+- `-ts` also auto-renews an expired token via wallet signature before failing,
+  so timestamping usually needs no manual step.
+- Fallback (older Token Service without wallet login, or no local wallet key):
+  the email OTP flow. `connect refresh --email …` sends a 6-digit code, then
+  `connect refresh --email … --code 123456` completes it (or pass `--magic-token`).
+- Either way only the access token is replaced, so a `ready` account stays
+  `ready` (wallet and identity are untouched).
+
+## Rules
+
+1. When a `neozip`/`neounzip` blockchain operation fails with a config error,
+   the JSON `error.nextCommand` will point here (`neozip connect`).
+2. Follow `result.nextCommand` to advance the setup phase step by step.
+3. `connect dump` prints a no-secrets snapshot of the connection store.

package/skills/neozip-create/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: neozip-create
+description: "Create or update ZIP archives with NeoZip: compression levels, AES/PKZIP encryption, include/exclude, and optional blockchain tokenization."
+metadata:
+  version: 0.90.0
+  openclaw:
+    category: "productivity"
+    requires:
+      bins:
+        - neozip
+      skills:
+        - neozip-shared
+    cliHelp: "neozip --help"
+---
+
+# Create archives with `neozip`
+
+## Quick reference
+
+```bash
+neozip [options] <archive> <files...>
+```
+
+Agent-style (JSON-driven):
+
+```bash
+neozip --format json \
+  --params '{"level":9,"recurse":true}' \
+  --json '{"archive":"out.zip","files":["src/","README.md"],"exclude":["*.log"]}'
+```
+
+## Key `--params` fields
+
+- `level` (0-9, 0=store), `compression` ("zstd" | "deflate")
+- `encrypt` (bool), `password` (string), `encryptionMethod` ("aes256" | "pkzip")
+- `recurse`, `junkPaths`, `include[]`, `exclude[]`
+- `blockchain`, `blockchainOts`, `blockchainTokenService`, `network`
+- `legacy` (bool) — see the `neozip-legacy` skill
+
+## Rules
+
+1. Run `neozip schema neozip` first if unsure of a field.
+2. Always `--dry-run` before creating to confirm the resolved plan.
+3. Default compression is zstd (not InfoZip-readable). Use `legacy` for stock
+   `unzip` compatibility.
+4. Blockchain features (`blockchain`, `-ots`, `-ts`) require `neozip connect`
+   first; on a config error the JSON `error.nextCommand` will be `neozip connect`.
+5. Passwords on the command line are visible in the process list — prefer
+   interactive prompts for sensitive data when a human is present.
+
+## Success output
+
+```json
+{ "ok": true, "command": "neozip", "action": "create", "archive": "out.zip",
+  "size": 1234, "fileCount": 2, "legacy": false, "compression": "zstd",
+  "encrypted": false, "blockchain": false }
+```

package/skills/neozip-extract/SKILL.md

@@ -0,0 +1,58 @@
+---
+name: neozip-extract
+description: "Extract, test, and verify ZIP archives with neounzip: target directory, overwrite policy, entry filters, password, and zip-slip-safe extraction."
+metadata:
+  version: 0.90.0
+  openclaw:
+    category: "productivity"
+    requires:
+      bins:
+        - neounzip
+      skills:
+        - neozip-shared
+    cliHelp: "neounzip --help"
+---
+
+# Extract archives with `neounzip`
+
+## Quick reference
+
+```bash
+neounzip [options] <archive> [destination]
+```
+
+Agent-style:
+
+```bash
+neounzip --format json \
+  --params '{"exdir":"out","overwrite":true}' \
+  --json '{"archive":"in.zip","filePatterns":["docs/*"]}'
+```
+
+## Modes (via `--params`)
+
+- `testOnly` — verify integrity without extracting
+- `listOnly` — list contents (JSON entries when `--format json`)
+- `preVerify` — verify integrity + blockchain before extracting (abort on fail)
+- default — extract
+
+## Key `--params` fields
+
+- `exdir` (target dir), `overwrite`, `never`, `junkPaths`
+- `include[]`, `exclude[]`, `password`
+- `skipBlockchain`, `inMemory`
+
+## Rules
+
+1. Always `--dry-run` first: it returns the exact output path of every entry.
+2. Extraction is **zip-slip-safe** — entries that would escape `exdir` are
+   refused with a `ZIP_FORMAT_ERROR` (exit 2/3). Do not try to bypass this.
+3. For encrypted archives provide `password`, or expect exit `82` (bad password).
+4. Prefer a dedicated `exdir` (e.g. a temp dir) over extracting into the CWD.
+
+## Success output (extract)
+
+```json
+{ "ok": true, "command": "neounzip", "action": "extract", "archive": "in.zip",
+  "destination": "out", "allFilesValid": true, "failedFiles": [] }
+```

package/skills/neozip-legacy/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: neozip-legacy
+description: "Produce InfoZip/PKZIP-compatible archives with neozip --legacy so stock unzip and other standard tools can read them."
+metadata:
+  version: 0.90.0
+  openclaw:
+    category: "productivity"
+    requires:
+      bins:
+        - neozip
+      skills:
+        - neozip-create
+    cliHelp: "neozip --help"
+---
+
+# InfoZip / PKZIP compatibility (`--legacy`)
+
+By default `neozip` uses **zstd** compression (method 93), which stock InfoZip
+`unzip` cannot read. When the consumer is a standard ZIP tool, use `--legacy`.
+
+## What `--legacy` does
+
+- Forces **deflate** (method 8), or **store** (method 0) at `-0`.
+- Forces **PKZIP** (ZipCrypto) encryption when encrypting (AES-256 is not
+  InfoZip-readable).
+- Disables all NeoZip extensions: zstd, blockchain (`-b`/`-bd`/`-bm`),
+  OpenTimestamps (`-ots`), Token Service (`-ts`).
+
+## Use it
+
+```bash
+# Standard, broadly-compatible archive
+neozip --legacy -9 out.zip src/
+
+# JSON-driven
+neozip --format json --params '{"legacy":true,"level":9}' \
+  --json '{"archive":"out.zip","files":["src/"]}'
+
+# Legacy + encryption (PKZIP)
+neozip --legacy -e -P 's3cret' out.zip secret.txt
+```
+
+## Rules
+
+1. `--legacy` with any blockchain feature is a hard error (exit 10). Choose one.
+2. To confirm compatibility, the resulting archive opens with stock `unzip`:
+   `unzip -t out.zip`.
+3. If you need both tokenization and broad compatibility, produce two archives.

package/skills/neozip-list/SKILL.md

@@ -0,0 +1,56 @@
+---
+name: neozip-list
+description: "List ZIP archive contents as JSON with neolist: file metadata, sizes, compression method, encryption flags, and tokenization status."
+metadata:
+  version: 0.90.0
+  openclaw:
+    category: "productivity"
+    requires:
+      bins:
+        - neolist
+      skills:
+        - neozip-shared
+    cliHelp: "neolist --help"
+---
+
+# List archives with `neolist`
+
+## Quick reference
+
+```bash
+neolist --format json <archive>
+# equivalent legacy flag:
+neolist -j <archive>
+```
+
+With options as JSON:
+
+```bash
+neolist --format json --params '{"sortBy":"size","exclude":["*.tmp"]}' in.zip
+```
+
+## Key `--params` fields
+
+- `sortBy` ("name" | "size" | "date")
+- `include[]`, `exclude[]`
+- `noComments`, `inMemory`, `verbose`
+
+## Output shape
+
+```json
+{
+  "archive": "in.zip",
+  "size": 278,
+  "fileCount": 2,
+  "files": [ { "name": "a.txt", "size": 12, "compressedSize": 14,
+              "method": "deflate", "isEncrypted": false } ],
+  "summary": { "totalSize": 24, "compressionRatio": 0 },
+  "tokenized": false
+}
+```
+
+## Notes
+
+- `neolist` is the richest JSON listing surface; prefer it over `neounzip -l`
+  for metadata.
+- On `neolist`, `-j` / `--json` is the legacy alias for `--format json`.