skillpond-cli 0.1.0

package/README.md

@@ -0,0 +1,164 @@
+# Skillpond CLI
+
+Go CLI for Yunmai RPA. Auth, script market, browser, and task CRUD commands call the remote API. The CLI mirrors remote task metadata and CLI launch payloads into local SQLite, stores run records locally, and writes all logs to files while `run start` executes `server-rpa-agent`.
+
+## Build
+
+```powershell
+.\build.ps1
+```
+
+The standalone CLI is written to `dist\skillpond-cli.exe`. No installer is generated.
+
+To build it directly with Go:
+
+```powershell
+go build -buildvcs=false -trimpath -o dist\skillpond-cli.exe ./cmd/skillpond-cli
+```
+
+## Run with npx
+
+The npm package currently contains the Windows x64 Go executable. Node.js is only used as a launcher; the CLI implementation remains in Go.
+
+After the package is published:
+
+```powershell
+npx skillpond-cli --help
+npx skillpond-cli config show
+```
+
+For a permanent global command:
+
+```powershell
+npm install --global skillpond-cli
+skillpond-cli --help
+```
+
+Build and inspect the npm package locally:
+
+```powershell
+npm.cmd pack --dry-run
+npm.cmd pack
+npx.cmd --yes .\skillpond-cli-0.1.0.tgz --help
+```
+
+Publish it after logging in to npm:
+
+```powershell
+npm.cmd login
+npm.cmd publish
+```
+
+The package name and version come from `package.json`. Each subsequent publish requires a new version, for example `npm.cmd version patch`.
+
+## Configure
+
+```powershell
+.\dist\skillpond-cli.exe config set base-url https://api.example.com
+.\dist\skillpond-cli.exe config set db-path D:\tmp\skillpond-cli.db
+.\dist\skillpond-cli.exe config set executor-command "D:\workspace\server_rpa_agent\dist\server-rpa-agent.exe"
+.\dist\skillpond-cli.exe auth login --email user@example.com --password 123456
+```
+
+Global flags:
+
+```text
+--base-url <url>   API base URL override
+--token <token>    Bearer token override
+--config <path>    config file path
+--db <path>        local SQLite database path
+--json             pretty-print JSON
+--debug            print remote request method and URL
+```
+
+## Remote Task, Local Run
+
+Default local database:
+
+```text
+%APPDATA%\skillpond\skillpond-cli.db
+```
+
+Create a remote task, cache its CLI launch payload locally, and run it:
+
+```powershell
+.\dist\skillpond-cli.exe task create --name 采集任务 --browser-id <browser-id> --script-id <script-id> --type local
+.\dist\skillpond-cli.exe task refresh --id <task-id>
+.\dist\skillpond-cli.exe run start --task-id <task-id>
+.\dist\skillpond-cli.exe run list --task-id <task-id>
+.\dist\skillpond-cli.exe run logs --run-id <run-id>
+```
+
+`task create` calls `POST /v1/tasks`, then `POST /v1/tasks/{id}/cli`, and stores both the remote task summary and launch payload in SQLite. `run start` uses the cached CLI payload, so the actual execution path is local.
+
+`task create`, `task get`, `run start`, `run list`, and `run get` print compact summaries by default so PowerShell pipelines can safely use `ConvertFrom-Json`. Use `task get --full` or `run get --full` to inspect cached payloads.
+
+The executor command is called as:
+
+```text
+<executor-command> execute <task.json> --log-output
+```
+
+`executor-command` should be the `server-rpa-agent.exe` path plus any global agent flags. For browser tasks, put global flags before `execute` by storing them in the command:
+
+```powershell
+.\dist\skillpond-cli.exe config set executor-command "D:\workspace\server_rpa_agent\dist\server-rpa-agent.exe --browser-executable ""C:\Program Files\Google\Chrome\Application\chrome.exe"""
+```
+
+Exit code `0` marks the run as `SUCCESS`; any non-zero exit code marks it as `FAILED`.
+
+Lifecycle logs and agent stdout/stderr are written to files under:
+
+```text
+%APPDATA%\Skillpond\tasks\<task-id>\runs\<run-id>\
+```
+
+Files:
+
+```text
+task.json    task payload passed to server-rpa-agent
+lifecycle.jsonl
+stdout.log   agent stdout
+stderr.log   agent stderr
+agent.log    combined stdout/stderr with stream prefixes
+```
+
+## Command Mapping
+
+| Command | Backend |
+| --- | --- |
+| `auth register --email --password [--client-id]` | `POST /v1/users/register` |
+| `auth login --email --password [--client-id]` | `POST /v1/users/login` |
+| `auth logout` | `DELETE /v1/users/logout` |
+| `auth kick-platform --platform cli` | `DELETE /v1/users/tokens/{platform}` |
+| `auth kick-client --platform cli --client-id <id>` | `DELETE /v1/users/tokens/{platform}/{clientId}` |
+| `auth device` | `POST /v1/auth/device/authorize` then poll `POST /v1/auth/device/token` |
+| `auth device-authorize --device-name --client-id` | `POST /v1/auth/device/authorize` |
+| `auth device-token --device-code` | `POST /v1/auth/device/token` |
+| `auth device-confirm --user-code` | `POST /v1/auth/device/confirm` |
+| `script create --name --description --code-file` | `POST /v1/script-market` |
+| `script update --id --name --description --code-file` | `PUT /v1/script-market/{id}` |
+| `script delete --id` | `DELETE /v1/script-market/{id}` |
+| `script get --id` | `GET /v1/script-market/{id}` |
+| `script list --search --page --size` | `GET /v1/script-market` |
+| `script import --file examples/script-import.json` | `POST /v1/script-market/import` |
+| `script add-my --id` | `POST /v1/script-market/{id}/my` |
+| `script remove-my --id` | `DELETE /v1/script-market/{id}/my` |
+| `script my --page --size` | `GET /v1/script-market/my` |
+| `browser template --file examples/browser-template.json` | `POST /v1/browser/template` |
+| `browser create --file examples/browser.json` | `POST /v1/browser` |
+| `browser list --search --page --size` | `GET /v1/browser` |
+| `browser update --id --file examples/browser.json` | `PUT /v1/browser/{id}` |
+| `browser delete --id` | `DELETE /v1/browser/{id}` |
+| `browser launch --id [--script-id]` | `POST /v1/browser/{id}/launcher` |
+| `task create --name --browser-id --script-id --type local` | `POST /v1/tasks` + `POST /v1/tasks/{id}/cli` + local SQLite cache |
+| `task update --id --name --browser-id --script-id --type local` | `PUT /v1/tasks/{id}` + refresh local CLI payload |
+| `task list --page --size` | `GET /v1/tasks` + sync local SQLite cache |
+| `task get --id` | local SQLite task mirror |
+| `task refresh --id` | `POST /v1/tasks/{id}/cli` + update local SQLite payload |
+| `task delete --id` | active-run check + `DELETE /v1/tasks/{id}` + local SQLite delete |
+| `run start --task-id [--executor-command]` | local SQLite cached CLI payload + server-rpa-agent CLI |
+| `run list --task-id --page --size` | local SQLite `task_runs` |
+| `run get --run-id` | local SQLite `task_runs` |
+| `run logs --run-id` | local lifecycle log file |
+| `run cancel --run-id` | local process kill attempt + local SQLite status update |

package/bin/skillpond-cli.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+
+"use strict";
+
+const path = require("node:path");
+const { spawnSync } = require("node:child_process");
+
+if (process.platform !== "win32" || process.arch !== "x64") {
+  console.error(
+    `skillpond-cli currently supports Windows x64 only (current: ${process.platform}/${process.arch}).`,
+  );
+  process.exit(1);
+}
+
+const executable = path.resolve(__dirname, "..", "dist", "skillpond-cli.exe");
+const result = spawnSync(executable, process.argv.slice(2), {
+  stdio: "inherit",
+  windowsHide: false,
+});
+
+if (result.error) {
+  console.error(`Failed to start skillpond-cli: ${result.error.message}`);
+  process.exit(1);
+}
+
+process.exit(result.status ?? 1);

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "skillpond-cli",
+  "version": "0.1.0",
+  "description": "Command-line client for Skillpond automation workflows",
+  "license": "UNLICENSED",
+  "type": "commonjs",
+  "bin": {
+    "skillpond-cli": "bin/skillpond-cli.js"
+  },
+  "files": [
+    "bin/skillpond-cli.js",
+    "dist/skillpond-cli.exe",
+    "README.md"
+  ],
+  "os": [
+    "win32"
+  ],
+  "cpu": [
+    "x64"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build:cli": "set \"GOCACHE=%CD%\\.gocache\" && go build -buildvcs=false -trimpath -o dist/skillpond-cli.exe ./cmd/skillpond-cli",
+    "prepack": "npm run build:cli && node --check bin/skillpond-cli.js",
+    "test:package": "node bin/skillpond-cli.js --help"
+  }
+}