neozip-cli 0.90.0 → 0.95.1

package/dist/src/skills/command.js

@@ -0,0 +1,256 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.skillsUsage = skillsUsage;
+exports.runSkillsCommand = runSkillsCommand;
+/**
+ * neozip skills — install bundled Agent Skills for Claude, Cursor, and Cowork.
+ */
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const locate_1 = require("./locate");
+const TARGETS = {
+    claude: path.join(os.homedir(), '.claude', 'skills'),
+    cursor: path.join(os.homedir(), '.cursor', 'skills'),
+};
+function parseArgs(argv) {
+    let command = null;
+    let force = false;
+    let target = 'all';
+    let outputDir;
+    let json = false;
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === '--force') {
+            force = true;
+        }
+        else if (arg === '--json') {
+            json = true;
+        }
+        else if (arg === '--target' && argv[i + 1]) {
+            const t = argv[++i];
+            if (t !== 'claude' && t !== 'cursor' && t !== 'all') {
+                throw new Error('--target must be claude, cursor, or all');
+            }
+            target = t;
+        }
+        else if (arg === '--output-dir' && argv[i + 1]) {
+            outputDir = argv[++i];
+        }
+        else if (arg === '--help' || arg === '-h') {
+            command = 'help';
+        }
+        else if (arg.startsWith('-')) {
+            throw new Error(`Unknown flag: ${arg}`);
+        }
+        else if (command === null) {
+            command = arg;
+        }
+        else {
+            throw new Error(`Unexpected argument: ${arg}`);
+        }
+    }
+    return { command: command ?? 'help', force, target, outputDir, json };
+}
+function symlinkSkill(source, dest, force) {
+    if (fs.existsSync(dest)) {
+        if (!force) {
+            const stat = fs.lstatSync(dest);
+            if (stat.isSymbolicLink()) {
+                const existing = fs.realpathSync(dest);
+                if (existing === fs.realpathSync(source))
+                    return 'skipped';
+            }
+            throw new Error(`Already exists: ${dest} (use --force to replace)`);
+        }
+        fs.rmSync(dest, { recursive: true, force: true });
+    }
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    const linkType = process.platform === 'win32' ? 'junction' : 'dir';
+    fs.symlinkSync(source, dest, linkType);
+    return 'linked';
+}
+function installSkills(options) {
+    const targets = options.target === 'all'
+        ? Object.keys(TARGETS)
+        : [options.target];
+    const results = [];
+    for (const targetKey of targets) {
+        const destRoot = TARGETS[targetKey];
+        for (const name of options.names) {
+            const source = path.join(options.skillsDir, name);
+            const dest = path.join(destRoot, name);
+            const action = symlinkSkill(source, dest, options.force);
+            results.push({ skill: name, target: targetKey, dest, action });
+        }
+    }
+    return results;
+}
+function packSkills(skillsDir, names, outputDir) {
+    if ((0, child_process_1.spawnSync)('zip', ['-h'], { encoding: 'utf8' }).status !== 0) {
+        throw new Error('The zip command is not available. Install zip (macOS: built-in) or pack skills manually.');
+    }
+    fs.mkdirSync(outputDir, { recursive: true });
+    const created = [];
+    for (const name of names) {
+        const zipPath = path.join(outputDir, `${name}.zip`);
+        if (fs.existsSync(zipPath))
+            fs.rmSync(zipPath);
+        const result = (0, child_process_1.spawnSync)('zip', ['-r', zipPath, name], {
+            cwd: skillsDir,
+            encoding: 'utf8',
+        });
+        if (result.status !== 0) {
+            throw new Error(`Failed to create ${zipPath}: ${result.stderr?.trim() || result.stdout?.trim() || 'zip failed'}`);
+        }
+        created.push(zipPath);
+    }
+    return created;
+}
+function skillsUsage() {
+    console.error(`NeoZip Agent Skills
+
+Bundled skills teach Claude, Cursor, and other agents how to use neozip, neounzip,
+and neolist with JSON output, schema introspection, and connect setup.
+
+Usage:
+  neozip skills path                         Print bundled skills directory
+  neozip skills list [--json]                  List bundled skill names
+  neozip skills install [--target TARGET]      Symlink skills into agent folders
+  neozip skills pack [--output-dir DIR]        Create Cowork/claude.ai upload ZIPs
+
+Options:
+  --target claude|cursor|all   Install destination (default: all)
+  --force                      Replace existing symlinks
+  --output-dir <dir>           Output directory for pack (default: ./neozip-skills-zips)
+  --json                       Machine-readable output (list/install/pack)
+  -h, --help                   Show this help
+
+Install targets:
+  claude   ~/.claude/skills/     Claude Code
+  cursor   ~/.cursor/skills/     Cursor personal skills
+
+Alternative (skills registry):
+  npx skills add <repo-url>
+  npx skills add <repo-url>/tree/main/skills/neozip-create
+
+Cowork / claude.ai:
+  Upload ZIPs from 'neozip skills pack' via Customize > Skills > Upload a skill.
+  Each ZIP must contain one skill folder at the root (e.g. neozip-create/SKILL.md).
+
+See also: AGENTS.md, skills/, README.md#for-ai-agents
+`);
+}
+function runSkillsCommand(argv) {
+    try {
+        const { command, force, target, outputDir, json } = parseArgs(argv);
+        const skillsDir = (0, locate_1.resolveBundledSkillsDir)();
+        const names = (0, locate_1.listSkillNames)(skillsDir);
+        const repoUrl = (0, locate_1.resolveSkillsAddUrl)();
+        switch (command) {
+            case 'help':
+                skillsUsage();
+                return 0;
+            case 'path': {
+                if (json) {
+                    console.log(JSON.stringify({ ok: true, skillsDir, repoUrl, skills: names }, null, 2));
+                }
+                else {
+                    console.log(skillsDir);
+                    console.error(`\nInstall: neozip skills install`);
+                    console.error(`Registry: npx skills add ${repoUrl}`);
+                }
+                return 0;
+            }
+            case 'list': {
+                if (json) {
+                    console.log(JSON.stringify({ ok: true, skillsDir, skills: names }, null, 2));
+                }
+                else {
+                    console.log(`Bundled skills (${names.length}) in ${skillsDir}:\n`);
+                    for (const name of names)
+                        console.log(`  ${name}`);
+                }
+                return 0;
+            }
+            case 'install': {
+                const results = installSkills({ skillsDir, names, target, force });
+                if (json) {
+                    console.log(JSON.stringify({ ok: true, skillsDir, results }, null, 2));
+                }
+                else {
+                    console.log(`Installed NeoZip skills from ${skillsDir}\n`);
+                    for (const row of results) {
+                        const verb = row.action === 'linked' ? 'Linked' : 'Skipped (already linked)';
+                        console.log(`  ${verb}: ${row.skill} → ${row.dest}`);
+                    }
+                    console.log('\nReload your agent session so new skills are discovered.');
+                    console.log(`Or use: npx skills add ${repoUrl}`);
+                }
+                return 0;
+            }
+            case 'pack': {
+                const outDir = path.resolve(outputDir ?? 'neozip-skills-zips');
+                const zips = packSkills(skillsDir, names, outDir);
+                if (json) {
+                    console.log(JSON.stringify({ ok: true, outputDir: outDir, zips }, null, 2));
+                }
+                else {
+                    console.log(`Created ${zips.length} skill ZIP(s) in ${outDir}:\n`);
+                    for (const zip of zips)
+                        console.log(`  ${zip}`);
+                    console.log('\nUpload each ZIP in Claude Cowork or claude.ai: Customize > Skills > Upload a skill.');
+                }
+                return 0;
+            }
+            default:
+                throw new Error(`Unknown subcommand: ${command}. Run: neozip skills --help`);
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (argv.includes('--json')) {
+            console.log(JSON.stringify({ ok: false, error: { message } }, null, 2));
+        }
+        else {
+            console.error(`Error: ${message}`);
+            console.error('Run: neozip skills --help');
+        }
+        return 1;
+    }
+}
+//# sourceMappingURL=command.js.map

package/dist/src/skills/locate.js

@@ -0,0 +1,99 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvePackageRoot = resolvePackageRoot;
+exports.resolveBundledSkillsDir = resolveBundledSkillsDir;
+exports.listSkillNames = listSkillNames;
+exports.resolveSkillsAddUrl = resolveSkillsAddUrl;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const PACKAGE_NAME = 'neozip-cli';
+/** Walk upward from startDir to find the installed neozip-cli package root. */
+function resolvePackageRoot(startDir = __dirname) {
+    let dir = startDir;
+    for (;;) {
+        const pkgPath = path.join(dir, 'package.json');
+        if (fs.existsSync(pkgPath)) {
+            try {
+                const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+                if (pkg.name === PACKAGE_NAME)
+                    return dir;
+            }
+            catch {
+                // keep walking
+            }
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    throw new Error(`Could not locate ${PACKAGE_NAME} installation. Reinstall with: npm install -g ${PACKAGE_NAME}`);
+}
+/** Absolute path to the bundled skills/ directory shipped with the package. */
+function resolveBundledSkillsDir() {
+    const skillsDir = path.join(resolvePackageRoot(), 'skills');
+    if (!fs.existsSync(skillsDir)) {
+        throw new Error(`Bundled skills directory not found at ${skillsDir}`);
+    }
+    return skillsDir;
+}
+/** Skill folder names that contain a SKILL.md entrypoint. */
+function listSkillNames(skillsDir) {
+    return fs
+        .readdirSync(skillsDir, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory())
+        .map((entry) => entry.name)
+        .filter((name) => fs.existsSync(path.join(skillsDir, name, 'SKILL.md')))
+        .sort();
+}
+/** GitHub URL for npx skills add (from package.json repository). */
+function resolveSkillsAddUrl() {
+    try {
+        const pkgPath = path.join(resolvePackageRoot(), 'package.json');
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+        const raw = typeof pkg.repository === 'string'
+            ? pkg.repository
+            : pkg.repository?.url ?? '';
+        const normalized = raw.replace(/^git\+/, '').replace(/\.git$/, '');
+        if (normalized.startsWith('http'))
+            return normalized;
+    }
+    catch {
+        // fall through
+    }
+    return 'https://github.com/NeoWareInc/neozip-cli';
+}
+//# sourceMappingURL=locate.js.map

package/dist/src/util/mask.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.maskEmail = maskEmail;
+exports.maskPublicKey = maskPublicKey;
+const recipient_lookup_1 = require("../archive/recipient-lookup");
+function maskEmail(email) {
+    const normalized = email.trim();
+    const at = normalized.indexOf("@");
+    if (at <= 0)
+        return "***";
+    const local = normalized.slice(0, at);
+    const domain = normalized.slice(at);
+    if (local.length <= 2)
+        return `${local[0] ?? ""}***${domain}`;
+    return `${local.slice(0, 2)}***${domain}`;
+}
+/** Short fingerprint for X25519 SPKI (base64) or 64-char raw hex. */
+function maskPublicKey(spkiOrHex) {
+    const trimmed = spkiOrHex.trim();
+    let rawHex;
+    try {
+        if (/^[0-9a-fA-F]{64}$/.test(trimmed.replace(/^0x/i, ""))) {
+            rawHex = trimmed.replace(/^0x/i, "").toLowerCase();
+        }
+        else {
+            rawHex = (0, recipient_lookup_1.spkiBase64ToRawHex)(trimmed);
+        }
+    }
+    catch {
+        return "invalid";
+    }
+    return `${rawHex.slice(0, 8)}…`;
+}
+//# sourceMappingURL=mask.js.map

package/dist/src/util/token-service-fetch.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatTokenServiceFetchError = formatTokenServiceFetchError;
+function fetchCauseCode(err) {
+    if (err == null || typeof err !== "object")
+        return null;
+    const cause = err.cause;
+    if (cause == null || typeof cause !== "object")
+        return null;
+    const code = cause.code;
+    return typeof code === "string" ? code : null;
+}
+/** User-facing message when Token Service HTTP calls fail (e.g. local server not running). */
+function formatTokenServiceFetchError(baseUrl, err) {
+    const message = err instanceof Error ? err.message : String(err);
+    const causeCode = fetchCauseCode(err);
+    if (message === "fetch failed" ||
+        causeCode === "ECONNREFUSED" ||
+        causeCode === "ENOTFOUND" ||
+        causeCode === "ECONNRESET" ||
+        causeCode === "EHOSTUNREACH") {
+        return `Token Service unreachable at ${baseUrl}. Is it running?`;
+    }
+    return `Token Service request failed (${baseUrl}): ${message}`;
+}
+//# sourceMappingURL=token-service-fetch.js.map

package/env.example

@@ -1,111 +1,44 @@
 # NeoZip CLI Environment Configuration
-# ⚠️  DEPRECATED: This method is still supported but wallet.json is now preferred
-# 
-# For new setups, use the interactive configuration wizard:
-#   $ neozip init
 #
-# See dev_doc/WALLET_CONFIG.md for complete configuration guide
+# Wallet and Token Service identity: use `neozip connect` (~/.neozip/connection/)
+# See dev_doc/CONNECTION_CLI_PREFS.md for on-chain preference fields.
 
 # =============================================================================
-# REQUIRED: Wallet Configuration
+# OPTIONAL: Network override (session)
 # =============================================================================
-
-# Your wallet private key (64-character hex string starting with 0x)
-# This is required for blockchain operations like token minting and verification
-# Get testnet ETH from: https://www.coinbase.com/faucets/base-ethereum-sepolia-faucet
-# 
-# ⚠️  DEPRECATED: Use 'neozip init' or 'neozip config set wallet.privateKey 0x...' instead
-NEOZIP_WALLET_PASSKEY=0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef
-
-# =============================================================================
-# OPTIONAL: Network Configuration
-# =============================================================================
-
-# Blockchain network to use (default: base-sepolia)
-# 
-# Supported network names:
-#   - base-sepolia       (Base Sepolia Testnet, Chain ID: 84532) - RECOMMENDED for testing
-#   - base-mainnet       (Base Mainnet, Chain ID: 8453)
-#   - arbitrum-sepolia   (Arbitrum Sepolia Testnet, Chain ID: 421614)
-#   - arbitrum-one       (Arbitrum One Mainnet, Chain ID: 42161)
-#   - sepolia-testnet    (Ethereum Sepolia Testnet, Chain ID: 11155111) - WARNING: Network instability issues
 #
-# Example:
+# Default network is stored on the active connection (public.json).
+# NEOZIP_NETWORK overrides for this process only.
+#
 # NEOZIP_NETWORK=base-sepolia
 
 # =============================================================================
-# OPTIONAL: RPC Configuration (if using custom RPC endpoints)
+# OPTIONAL: RPC overrides (session)
 # =============================================================================
-
-# Custom RPC endpoint for Base Sepolia testnet (optional)
-# Default: https://sepolia.base.org
 # NEOZIP_BASE_SEPOLIA_RPC_URL=https://sepolia.base.org
-
-# Custom RPC endpoint for Base Mainnet (optional)
-# Default: https://mainnet.base.org
 # NEOZIP_BASE_MAINNET_RPC_URL=https://mainnet.base.org
 
-# Note: RPC configuration for Arbitrum and Ethereum networks should be configured via:
-#   - Interactive wizard: neozip init
-#   - Config command: neozip config
-#   - wallet.json file: ~/.neozip/wallet.json
-#
-# Default RPC endpoints for other networks:
-#   - Arbitrum Sepolia: https://sepolia-rollup.arbitrum.io/rpc
-#   - Arbitrum One: https://arb1.arbitrum.io/rpc
-#   - Ethereum Sepolia: https://rpc.sepolia.ethpandaops.io
-
 # =============================================================================
-# OPTIONAL: Zipstamp Timestamp Configuration
+# Connection store
 # =============================================================================
-
-# Zipstamp server URL for Ethereum timestamping (default: https://zipstamp-dev.neozip.io)
-# ZIPSTAMP_SERVER_URL=https://zipstamp-dev.neozip.io
-
-# Email for Zipstamp server (some servers require verified email for stamping)
-# NEOZIP_TIMESTAMP_EMAIL=your@email.com
+#
+# neozip connect — account, wallet, Token Service credentials
+# Store: ~/.neozip/connection/
+# NEOZIP_CONNECTION_DIR=/custom/path/to/connection
+# NEOZIP_UNLOCK_PASSPHRASE=your-passphrase
 
 # =============================================================================
-# OPTIONAL: Debug Configuration
+# OPTIONAL: Debug / gas (session overrides)
 # =============================================================================
-
-# Enable verbose logging (true/false)
 # NEOZIP_VERBOSE=false
-
-# Enable debug mode for blockchain operations (true/false)
 # NEOZIP_DEBUG=false
-
-# =============================================================================
-# OPTIONAL: Gas Configuration
-# =============================================================================
-
-# Gas price multiplier (default: 1.0)
 # NEOZIP_GAS_MULTIPLIER=1.0
-
-# Maximum gas price in gwei (default: 100)
 # NEOZIP_MAX_GAS_PRICE=100
 
 # =============================================================================
-# USAGE INSTRUCTIONS
+# USAGE
 # =============================================================================
 #
-# 1. Copy this file to .env.local:
-#    cp .env.example .env.local
-#
-# 2. Set your wallet private key:
-#    export NEOZIP_WALLET_PASSKEY="0x..."
-#
-# 3. For testnet, get free ETH from:
-#    https://www.coinbase.com/faucets/base-ethereum-sepolia-faucet
-#
-# 4. Install dependencies and build:
-#    npm install
-#    npm run build
-#
-# 5. Run neozip commands:
-#    neozip zip output/test.nzip file1.txt file2.txt
-#    neozip list output/test.nzip
-#    neozip unzip output/test.nzip
-#    neozip config
-#
-# =============================================================================
+# 1. neozip connect
+# 2. neozip connect settings   # default network, RPC, gas
+# 3. neozip -b archive.nzip files/