1688-cli 0.1.13 → 0.1.15

package/CHANGELOG.md

@@ -3,6 +3,21 @@
 All notable changes to this project are documented here.
 This project follows [Semantic Versioning](https://semver.org/).
 
+## [0.1.15] - 2026-05-13
+
+### Fixed
+- Auto-clean stale `.lock.lock` directory when no daemon is alive. Previously,
+  killing a `--headed` flow with Ctrl+C left a lock that blocked every
+  subsequent command with `LOCK_BUSY` until manually `rm -rf`'d. The probe
+  is safe: if a daemon process actually holds the lock, the original
+  "Another 1688 command is running" error is preserved.
+
+## [0.1.14] - 2026-05-13
+
+### Changed
+- Description in `package.json` and the GitHub repo "About" updated to reflect
+  the actual core flow (sourcing + orders) instead of niche shortcuts.
+
 ## [0.1.13] - 2026-05-13
 
 ### Added

package/README.md

@@ -6,9 +6,14 @@
 [![node](https://img.shields.io/node/v/1688-cli.svg)](https://nodejs.org/)
 
 **1688.com CLI for humans, Codex, and Claude Code.**
-Search, browse, cart, place orders, track logistics, and talk to sellers — all
-from your terminal. Outputs human text on a TTY and JSON when piped, so AI
-agents can drive it without parsing.
+
+Two core flows from the terminal:
+
+- **Sourcing** — search / image-search / product detail / pre-sale inquiry
+- **Orders** — list / detail / logistics tracking / post-sale chat with sellers
+
+Outputs human text on a TTY and JSON when piped, so AI agents can drive it
+without parsing.
 
 ```bash
 npm i -g 1688-cli
@@ -44,6 +49,14 @@ agent's tooling. `1688-cli` is a single command:
   in your terminal pretty-prints.
 - **Designed for AI agents.** See [AGENTS.md](./AGENTS.md) for the contract.
 
+### Not in scope
+
+This is not a marketing / scraping tool for bulk-listing the whole site, and
+not a checkout automation farm. It mirrors what a buyer does manually: pick
+a product, ask the seller a question, place an order, track shipping. Place
+order (`checkout confirm`) is gated behind TTY prompts or an explicit
+`--agent` flag so agents can't move money silently.
+
 ---
 
 ## Install

package/dist/session/lock.js

@@ -1,23 +1,51 @@
 import fs from 'node:fs/promises';
+import path from 'node:path';
 import lockfile from 'proper-lockfile';
-import { lockFile, ensureRoot } from './paths.js';
+import { lockFile, ensureRoot, root } from './paths.js';
 import { CliError } from '../io/errors.js';
 export async function acquireLock() {
     await ensureRoot();
     // proper-lockfile requires the target file to exist
     await fs.writeFile(lockFile(), '', { flag: 'a' });
+    const lockOpts = { retries: 0, stale: 5 * 60 * 1000 };
     try {
-        const release = await lockfile.lock(lockFile(), {
-            retries: 0,
-            stale: 5 * 60 * 1000,
-        });
-        return release;
+        return await lockfile.lock(lockFile(), lockOpts);
     }
     catch (e) {
-        if (e.code === 'ELOCKED') {
+        if (e.code !== 'ELOCKED')
+            throw e;
+        // Lock is held. Probe whether it's a real holder (daemon alive) or
+        // a stale dir left over by an abruptly-killed process (Ctrl+C in
+        // --headed flow, SIGKILL on the daemon, etc.). If no daemon is running,
+        // we can safely clean up and retry — the dead process can't be using it.
+        if (await daemonIsAlive()) {
             throw new CliError(5, 'LOCK_BUSY', 'Another 1688 command is running. Close it and retry.');
         }
-        throw e;
+        await fs.rm(lockFile() + '.lock', { recursive: true, force: true });
+        try {
+            return await lockfile.lock(lockFile(), lockOpts);
+        }
+        catch {
+            throw new CliError(5, 'LOCK_BUSY', 'Another 1688 command is running. Close it and retry.');
+        }
+    }
+}
+async function daemonIsAlive() {
+    const pidFile = path.join(root(), 'daemon.pid');
+    try {
+        const pid = parseInt((await fs.readFile(pidFile, 'utf8')).trim(), 10);
+        if (!Number.isFinite(pid) || pid <= 0)
+            return false;
+        try {
+            process.kill(pid, 0); // signal 0 = existence check, no signal sent
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    catch {
+        return false;
     }
 }
 //# sourceMappingURL=lock.js.map

package/dist/session/lock.js.map

@@ -1 +1 @@
-{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../src/session/lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,QAAQ,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,UAAU,EAAE,CAAC;IACnB,oDAAoD;IACpD,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;IAClD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE;YAC9C,OAAO,EAAE,CAAC;YACV,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI;SACrB,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAK,CAAuB,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAChD,MAAM,IAAI,QAAQ,CAChB,CAAC,EACD,WAAW,EACX,sDAAsD,CACvD,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC"}
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../src/session/lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,QAAQ,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,UAAU,EAAE,CAAC;IACnB,oDAAoD;IACpD,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;IAElD,MAAM,QAAQ,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;IAEtD,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAK,CAAuB,CAAC,IAAI,KAAK,SAAS;YAAE,MAAM,CAAC,CAAC;QAEzD,mEAAmE;QACnE,iEAAiE;QACjE,wEAAwE;QACxE,yEAAyE;QACzE,IAAI,MAAM,aAAa,EAAE,EAAE,CAAC;YAC1B,MAAM,IAAI,QAAQ,CAChB,CAAC,EACD,WAAW,EACX,sDAAsD,CACvD,CAAC;QACJ,CAAC;QAED,MAAM,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACpE,IAAI,CAAC;YACH,OAAO,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,QAAQ,CAAC,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,QAAQ,CAChB,CAAC,EACD,WAAW,EACX,sDAAsD,CACvD,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,aAAa;IAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,YAAY,CAAC,CAAC;IAChD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACtE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QACpD,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,6CAA6C;YACnE,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "1688-cli",
-  "version": "0.1.13",
-  "description": "1688.com CLI for humans, Codex, and Claude Code — search, cart, orders, logistics, seller IM, fake-shipping detection.",
+  "version": "0.1.15",
+  "description": "1688.com CLI for humans, Codex, and Claude Code. Sourcing (search / image-search / offer / inquire) and orders (list / detail / logistics / seller chat).",
   "license": "MIT",
   "author": "nobodyjack",
   "homepage": "https://github.com/superjack2050/1688-cli#readme",