@xqyz/xq-cli 0.1.0

package/README.md

@@ -0,0 +1,159 @@
+# @xqyz/xq-cli
+
+Standalone CLI project for xique brand task workflows.
+
+Project execution rules for agents live in [AGENTS.md](./AGENTS.md). That file defines the mandatory config-confirmation flow before any bid generation run.
+
+## Install from this repo
+
+```bash
+npm install -g D:\code\xq-cli
+```
+
+## Pack and share
+
+```bash
+cd D:\code\xq-cli
+npm pack
+```
+
+That command produces a `.tgz` tarball which can be shared and installed with:
+
+```bash
+npm install -g .\xqyz-xq-cli-0.1.0.tgz
+```
+
+## Usage
+
+```bash
+xq-cli login --base-url https://xqai.atest.qianlima.com/api
+xq-cli login --base-url https://xqai.atest.qianlima.com/api --name mahao3 --password 123456
+xq-cli wizard
+xq-cli wizard --file D:\bids\tender.docx
+xq-cli init --file D:\bids\tender.docx --wait
+xq-cli outline --cid <cid> --interactive --wait
+xq-cli outline --cid <cid> --wait
+xq-cli write --cid <cid> --wait
+xq-cli status --cid <cid> --content --json
+xq-cli export --cid <cid> --interactive --out D:\output
+xq-cli export --cid <cid> --out D:\output
+```
+
+`login` now defaults to browser authorization. If you explicitly pass `--name` and `--password`, the CLI falls back to password login.
+
+When `outline --wait` or `write --wait` hits a required response-basis step, the CLI will pause and ask you to choose `0/1/2` before continuing. It no longer auto-selects a default when you just press Enter.
+
+`write --wait` now also retries `sequelForOutline` when the directory phase stalls at the outline-complete step, and auto-calls `generateAllUnfinished` if the backend reports `100%` but still leaves unfinished chapters behind.
+
+`write` follows the frontend flow:
+
+`order/charge -> c/viewStep(101) -> task/autoGenerateContent`
+
+## Interactive menus
+
+Use the full wizard if you want a CLI flow close to the frontend configuration panel:
+
+```bash
+xq-cli wizard
+xq-cli wizard --file D:\bids\tender.docx
+```
+
+The wizard will prompt for:
+
+- source bid file
+- article length
+- writing mode
+- visual style
+- table quantity / color / style
+- planning mode
+- optional image-source toggles
+- export template / layout / output path
+
+You can also open menus for a single phase:
+
+```bash
+xq-cli outline --cid <cid> --interactive --wait
+xq-cli export --cid <cid> --interactive --out D:\output
+```
+
+## Config choices
+
+`xq-cli` now exposes the same major bid-book generation settings that the frontend outline/download flow uses.
+
+Inspect the selectable enums with:
+
+```bash
+xq-cli choices
+xq-cli choices outline
+xq-cli choices export --json
+```
+
+Outline generation now supports frontend-backed options such as:
+
+- `--page-scope` / `--page-scope-code`
+- `--base`
+- `--theme-style`
+- `--table-quantity`
+- `--table-color`
+- `--table-style`
+- `--info-img`, `--scene-img`, `--online-img`, `--mermaid-img`, `--knowledge-img`
+- `--mermaid-style`
+- `--plan-mode`
+- `--multi-bid-id`, `--multi-bid-type`
+- `--epc-engineer-type`
+
+Export now supports frontend-backed style options such as:
+
+- `--template`
+- `--style-json`
+- `--start-index`
+- `--auto-number`
+- `--add-mark`
+- `--layout`
+- `--top-margin`, `--bottom-margin`, `--left-margin`, `--right-margin`
+- `--table-color`, `--table-style`
+- `--skeleton-color`
+- `--img-title-color`, `--heading4-color`, `--heading5-color`
+- `--content-title-color`, `--content-color`
+- `--heading4-text-color`, `--heading5-text-color`, `--content-title-text-color`, `--img-title-text-color`
+
+Example outline config:
+
+```bash
+xq-cli outline --cid <cid> --page-scope 3 --base expert --theme-style 4 --table-quantity rich --table-color blue --table-style zebra --mermaid-style blue --knowledge-img 1 --scene-img 1 --plan-mode quick --wait
+```
+
+Example export config:
+
+```bash
+xq-cli export --cid <cid> --template 2 --layout enhanced --table-color green --table-style header --auto-number 1 --add-mark 0 --top-margin 2.54 --bottom-margin 2.54 --left-margin 3.18 --right-margin 3.18 --skeleton-color 1276C1 --img-title-color 1276C1 --out D:\output
+```
+
+Advanced export style JSON can mirror the frontend custom format dialog payload:
+
+```json
+{
+  "startIndex": 1,
+  "directorySettings": [
+    { "type": 1, "serialNumber": "1", "fontName": "SimSun", "fontSize": "16", "alignment": "1", "bold": "1", "level": "1" }
+  ],
+  "contentSettings": {
+    "serialNumber1": "10",
+    "serialNumber2": "11",
+    "serialNumber3": "12",
+    "serialNumber4": "13",
+    "fontName": "SimSun",
+    "fontSize": "12",
+    "alignment": "3",
+    "bold": "0"
+  }
+}
+```
+
+```bash
+xq-cli export --cid <cid> --template 5 --style-json D:\styles\custom-style.json --out D:\output
+```
+
+## OpenCLI plugin
+
+This repo also includes a local OpenCLI plugin in `opencli-plugin-xique/`.

package/bin/xq-cli.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import '../src/cli.mjs';

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@xqyz/xq-cli",
+  "version": "0.1.0",
+  "description": "CLI for xique bid-book task workflows",
+  "type": "module",
+  "scripts": {
+    "pack": "npm pack"
+  },
+  "bin": {
+    "xq-cli": "./bin/xq-cli.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "axios": "^0.27.2",
+    "form-data": "^4.0.4"
+  }
+}