@solarains/va-cli 0.1.1

package/dist/features/usage/usage-output.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderUsageSummary = renderUsageSummary;
+const output_1 = require("../../shared/output");
+function formatQuotaLine(label, quota) {
+    if (!quota) {
+        return `${label}: not enabled`;
+    }
+    return `${label}: ${quota.used}/${quota.limit} used, ${quota.remaining} remaining`;
+}
+function formatSelectedReportKey(key) {
+    if (!key) {
+        return undefined;
+    }
+    const [assetId, date] = key.split(':');
+    if (!assetId || !date) {
+        return key;
+    }
+    return `${assetId} on ${date}`;
+}
+function renderUsageSummary(logger, summary) {
+    (0, output_1.printSection)(logger, 'Plan');
+    (0, output_1.printKeyValue)(logger, 'Current plan', summary.plan.name);
+    (0, output_1.printKeyValue)(logger, 'Commercial status', summary.subscriptionSummary.statusLabel);
+    if (summary.subscriptionSummary.providerLabel) {
+        (0, output_1.printKeyValue)(logger, 'Provider', summary.subscriptionSummary.providerLabel);
+    }
+    if (summary.subscriptionSummary.billingIntervalLabel) {
+        (0, output_1.printKeyValue)(logger, 'Billing interval', summary.subscriptionSummary.billingIntervalLabel);
+    }
+    if (summary.subscriptionSummary.currentPeriodEnd) {
+        (0, output_1.printKeyValue)(logger, 'Current period end', summary.subscriptionSummary.currentPeriodEnd);
+    }
+    (0, output_1.printKeyValue)(logger, 'Cancellation', summary.subscriptionSummary.cancellationLabel);
+    (0, output_1.printSection)(logger, 'Daily report');
+    (0, output_1.printKeyValue)(logger, 'Status', summary.dailyReport.statusLabel);
+    (0, output_1.printKeyValue)(logger, 'Product day', summary.dailyReport.productDay);
+    (0, output_1.printKeyValue)(logger, 'Remaining selections today', summary.dailyReport.remainingToday === null
+        ? 'not limited'
+        : String(summary.dailyReport.remainingToday));
+    const selectedReport = formatSelectedReportKey(summary.dailyReport.selectedReportKey);
+    if (selectedReport) {
+        (0, output_1.printKeyValue)(logger, 'Locked report', selectedReport);
+    }
+    (0, output_1.printSection)(logger, 'Intelligence quota');
+    (0, output_1.printKeyValue)(logger, 'Status', summary.intelligence.statusLabel);
+    (0, output_1.printList)(logger, [
+        formatQuotaLine('Calls', summary.intelligence.calls),
+        formatQuotaLine('Rows', summary.intelligence.rows),
+        `Reset cadence: ${summary.intelligence.resetCadence} (${summary.intelligence.resetTimezone})`,
+    ]);
+}

package/dist/main.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const run_cli_1 = require("./cli/run-cli");
+void (0, run_cli_1.runCli)(process.argv.slice(2), process.env).then((exitCode) => {
+    process.exitCode = exitCode;
+});

package/dist/shared/argv.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseCommandArgs = parseCommandArgs;
+exports.getStringOption = getStringOption;
+exports.getBooleanOption = getBooleanOption;
+exports.getNumberOption = getNumberOption;
+function parseCommandArgs(args) {
+    const positionals = [];
+    const options = {};
+    for (let index = 0; index < args.length; index += 1) {
+        const token = args[index];
+        if (!token.startsWith('--')) {
+            positionals.push(token);
+            continue;
+        }
+        const trimmed = token.slice(2);
+        const equalsIndex = trimmed.indexOf('=');
+        if (equalsIndex >= 0) {
+            const key = trimmed.slice(0, equalsIndex);
+            const value = trimmed.slice(equalsIndex + 1);
+            options[key] = value;
+            continue;
+        }
+        const next = args[index + 1];
+        if (next && !next.startsWith('--')) {
+            options[trimmed] = next;
+            index += 1;
+            continue;
+        }
+        options[trimmed] = true;
+    }
+    return {
+        positionals,
+        options,
+    };
+}
+function getStringOption(parsed, key) {
+    const value = parsed.options[key];
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed ? trimmed : undefined;
+}
+function getBooleanOption(parsed, key) {
+    const value = parsed.options[key];
+    if (typeof value === 'boolean') {
+        return value;
+    }
+    if (typeof value === 'string') {
+        return value === 'true' || value === '1';
+    }
+    return false;
+}
+function getNumberOption(parsed, key) {
+    const value = getStringOption(parsed, key);
+    if (value === undefined) {
+        return undefined;
+    }
+    const parsedNumber = Number(value);
+    if (!Number.isFinite(parsedNumber)) {
+        throw new Error(`Option "--${key}" must be a number.`);
+    }
+    return parsedNumber;
+}

package/dist/shared/logger.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+class Logger {
+    debugEnabled;
+    constructor(debugEnabled) {
+        this.debugEnabled = debugEnabled;
+    }
+    setDebugMode(value) {
+        this.debugEnabled = value;
+    }
+    plain(message) {
+        process.stdout.write(`${message}\n`);
+    }
+    info(message) {
+        this.plain(message);
+    }
+    error(message) {
+        process.stderr.write(`Error: ${message}\n`);
+    }
+    debug(message, payload) {
+        if (!this.debugEnabled) {
+            return;
+        }
+        if (payload === undefined) {
+            this.plain(`[debug] ${message}`);
+            return;
+        }
+        this.plain(`[debug] ${message} ${JSON.stringify(payload, null, 2)}`);
+    }
+}
+exports.Logger = Logger;

package/dist/shared/output.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printSection = printSection;
+exports.printList = printList;
+exports.printKeyValue = printKeyValue;
+exports.printEmptyLine = printEmptyLine;
+function printSection(logger, title) {
+    logger.plain('');
+    logger.plain(title);
+    logger.plain('-'.repeat(title.length));
+}
+function printList(logger, items) {
+    for (const item of items) {
+        logger.plain(`- ${item}`);
+    }
+}
+function printKeyValue(logger, key, value) {
+    logger.plain(`${key}: ${value}`);
+}
+function printEmptyLine(logger) {
+    logger.plain('');
+}

package/dist/state/paths.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCliPaths = createCliPaths;
+exports.ensureCliDirectories = ensureCliDirectories;
+const promises_1 = require("node:fs/promises");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+function expandHomePath(value) {
+    if (value === '~') {
+        return (0, node_os_1.homedir)();
+    }
+    if (value.startsWith('~/')) {
+        return value.replace('~', (0, node_os_1.homedir)());
+    }
+    return value;
+}
+function createCliPaths(env) {
+    const rootDir = expandHomePath(env.VAONE_HOME ?? (0, node_path_1.join)((0, node_os_1.homedir)(), '.vaone'));
+    const stateDir = (0, node_path_1.join)(rootDir, 'state');
+    return {
+        rootDir,
+        stateDir,
+        configFile: (0, node_path_1.join)(rootDir, 'config.json'),
+        authStateFile: (0, node_path_1.join)(stateDir, 'auth.json'),
+        installationStateFile: (0, node_path_1.join)(stateDir, 'installation.json'),
+        intelligenceQueryStateFile: (0, node_path_1.join)(stateDir, 'intelligence-query.json'),
+    };
+}
+async function ensureCliDirectories(paths) {
+    await (0, promises_1.mkdir)(paths.rootDir, { recursive: true });
+    await (0, promises_1.mkdir)(paths.stateDir, { recursive: true });
+}

package/dist/state/stores/file-json-store.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileJsonStore = void 0;
+const promises_1 = require("node:fs/promises");
+class FileJsonStore {
+    filePath;
+    constructor(filePath) {
+        this.filePath = filePath;
+    }
+    async read() {
+        try {
+            const raw = await (0, promises_1.readFile)(this.filePath, 'utf8');
+            return JSON.parse(raw);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return null;
+            }
+            throw error;
+        }
+    }
+    async write(data) {
+        await (0, promises_1.writeFile)(this.filePath, `${JSON.stringify(data, null, 2)}\n`, 'utf8');
+    }
+    async clear() {
+        await (0, promises_1.rm)(this.filePath, { force: true });
+    }
+}
+exports.FileJsonStore = FileJsonStore;

package/dist/state/stores/installation-store.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstallationStore = void 0;
+const file_json_store_1 = require("./file-json-store");
+class InstallationStore {
+    store;
+    constructor(filePath) {
+        this.store = new file_json_store_1.FileJsonStore(filePath);
+    }
+    async read() {
+        return this.store.read();
+    }
+    async save(installation) {
+        await this.store.write(installation);
+    }
+    async clear() {
+        await this.store.clear();
+    }
+}
+exports.InstallationStore = InstallationStore;

package/dist/state/stores/token-store.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenStore = void 0;
+const file_json_store_1 = require("./file-json-store");
+class TokenStore {
+    store;
+    constructor(filePath) {
+        this.store = new file_json_store_1.FileJsonStore(filePath);
+    }
+    async read() {
+        return this.store.read();
+    }
+    async save(tokens) {
+        await this.store.write(tokens);
+    }
+    async clear() {
+        await this.store.clear();
+    }
+}
+exports.TokenStore = TokenStore;

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@solarains/va-cli",
+  "version": "0.1.1",
+  "description": "Bootstrap CLI for the VAOne product.",
+  "bin": {
+    "vaone": "dist/main.js"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@inquirer/core": "^10.2.2",
+    "@inquirer/prompts": "^7.8.0",
+    "chalk": "^5.5.0",
+    "ora": "^8.2.0",
+    "qrcode-terminal": "^0.12.0"
+  },
+  "license": "MIT"
+}

package/skills/visionalpha-operator/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: visionalpha-operator
+description: Use when the user asks in Chinese or English to use VA or VisionAlpha for daily reports, usage summary, auth recovery, asset intelligence, or asset listing. Route all supported work through the local `vaone` CLI and send installation or billing requests to the web portal.
+---
+
+# VisionAlpha Operator
+
+Use this skill as the single VisionAlpha umbrella entrypoint. It is for brand-led requests such as "用va看下今日日报", "use visionalpha to check usage", "用 VA 查资产列表", or "query VisionAlpha intelligence".
+
+## Trigger contract
+
+Use this skill when the user:
+
+- Mentions `va`, `VA`, `VisionAlpha`, or `visionalpha`
+- Asks for daily reports, usage, login recovery, asset intelligence, or asset listing through that brand entrypoint
+- Writes the request in Chinese or English
+
+## Operating rules
+
+1. Use only the local `vaone` CLI for product operations. Do not call private HTTP APIs directly from the skill.
+2. Do not ask the user for access tokens, refresh tokens, verification codes, or copied secrets. Keep auth inside the CLI flow.
+3. If the CLI is missing, not initialized, or the managed skill looks stale, tell the user to run `vaone init`.
+4. If a supported command says login is required, use `vaone auth login`.
+5. Before quota-sensitive work such as daily reports or intelligence queries, you may run `vaone usage`, but summarize readiness in one short line unless the user explicitly asked for detailed usage.
+
+## Routing
+
+- Daily reports: read [references/daily-reports.md](references/daily-reports.md)
+- Usage summary: read [references/usage-summary.md](references/usage-summary.md)
+- Auth recovery or logout: read [references/auth-recovery.md](references/auth-recovery.md)
+- Asset intelligence query: read [references/asset-intelligence.md](references/asset-intelligence.md)
+- Asset catalog listing: read [references/assets.md](references/assets.md)
+
+## Unsupported in this version
+
+- Installations or device-slot management: explain that this currently routes through the web portal. Do not invent CLI steps.
+- Billing or subscription actions: explain that this currently routes through the web portal. Do not invent CLI steps.
+

package/skills/visionalpha-operator/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "VisionAlpha Operator"
+  short_description: "Operate VisionAlpha through the vaone CLI"
+  default_prompt: "Use $visionalpha-operator to handle a VisionAlpha report, usage, auth, or asset request through the local vaone CLI."

package/skills/visionalpha-operator/references/asset-intelligence.md

@@ -0,0 +1,35 @@
+# Asset Intelligence
+
+Use this reference when the user wants paid intelligence results, intelligence narratives, or filtered research results through VA or VisionAlpha.
+
+## Command
+
+- `vaone intelligence query --query` is not available.
+- Use the supported filter arguments on `vaone intelligence query`:
+  - `--asset-id <id>`
+  - `--category <category>`
+  - `--issuer <issuer>`
+  - `--publish-date-from <yyyy-mm-dd>`
+  - `--publish-date-to <yyyy-mm-dd>`
+  - `--min-relevance-score <n>`
+  - `--limit <n>`
+  - `--next`
+
+## Workflow
+
+1. If the user gives clear structured filters, run `vaone intelligence query` with those filters.
+2. If the user asks an open-ended intelligence question without structured filters, ask a short clarification rather than inventing a free-text query mode.
+3. Use `--limit` to keep the first result set tight.
+4. Use `--next` only when continuing the immediately previous intelligence query.
+
+## Usage preflight
+
+- You may run `vaone usage` before the intelligence query.
+- Keep that usage summary to one short line unless the user explicitly asked for usage details.
+
+## Recovery notes
+
+- If the CLI says the account lacks paid intelligence access, say that directly.
+- If the CLI says quota is exceeded, explain that the current intelligence query would exceed the daily paid quota.
+- If the cursor is invalid, restart the query without `--next`.
+

package/skills/visionalpha-operator/references/assets.md

@@ -0,0 +1,29 @@
+# Assets
+
+Use this reference when the user wants the asset catalog, a filtered asset list, or asks VA or VisionAlpha to show supported assets.
+
+## Command
+
+- `vaone assets list`
+
+## Supported filters
+
+The first version is a filterable list, not a search workflow. Use only:
+
+- `--category <category>`
+- `--enabled true|false`
+
+## Workflow
+
+1. If the user asks for the asset list without filters, run `vaone assets list`.
+2. If the user asks for a filtered list, pass only the supported filters above.
+3. If the user asks for fuzzy search, issuer search, or unsupported filter fields, explain that the current CLI only supports category and enabled filters.
+
+## Response style
+
+- Keep the first response compact.
+- If the returned list is long, summarize the most relevant assets and mention the filters used.
+
+## Recovery notes
+
+- If asset listing says login is required, run `vaone auth login`.

package/skills/visionalpha-operator/references/auth-recovery.md

@@ -0,0 +1,26 @@
+# Auth Recovery
+
+Use this reference when the user wants to log in, recover access, verify that the current machine is authenticated, or log out of VA or VisionAlpha.
+
+## Commands
+
+- Log in: `vaone auth login`
+- Log out: `vaone auth logout`
+- Check access after login: `vaone usage`
+
+## Workflow
+
+1. If a supported command fails because authentication is missing or expired, run `vaone auth login`.
+2. If the user explicitly asks to sign out, run `vaone auth logout`.
+3. After login or logout, use `vaone usage` only when the user needs confirmation or when another workflow depends on it.
+
+## Important behavior
+
+- `vaone auth logout` is best-effort remote logout plus guaranteed local cleanup.
+- If remote logout fails, local logout still succeeds. Report that clearly.
+- Do not ask the user to paste tokens, cookies, or secret values into chat.
+
+## When to redirect
+
+- If the request is really about installation or device-slot management, explain that it currently belongs in the web portal rather than the CLI.
+

package/skills/visionalpha-operator/references/daily-reports.md

@@ -0,0 +1,30 @@
+# Daily Reports
+
+Use this reference when the user wants a report list, a specific report, or "today's report" through VA or VisionAlpha.
+
+## Commands
+
+- List reports: `vaone reports list`
+- Filter by asset or category: `vaone reports list --asset-id <id> --category <category>`
+- Limit rows: `vaone reports list --limit <n>`
+- Get a report by asset id: `vaone reports get <asset-id>`
+- Get a report for a specific date: `vaone reports get <asset-id> --date <yyyy-mm-dd>`
+
+## Workflow
+
+1. If the user asked for a list, run `vaone reports list` with the smallest useful filters.
+2. If the user asked for one report and did not give the asset id clearly, list first and clarify from the returned choices.
+3. If the user asked for "today's" report, prefer the current product-day report via `vaone reports get <asset-id>` without forcing a date.
+4. If the user asked for a historical date, pass `--date`.
+5. Keep summaries concise first. Expand only if the user wants the full report body or detailed interpretation.
+
+## Usage preflight
+
+- You may run `vaone usage` before a report fetch.
+- Default output should be one short readiness line, not the full usage dump.
+
+## Recovery notes
+
+- If the CLI says login is required, run `vaone auth login`.
+- If the CLI reports the daily report selection is already locked, explain that free accounts can keep only one report selection for the current product day.
+

package/skills/visionalpha-operator/references/usage-summary.md

@@ -0,0 +1,24 @@
+# Usage Summary
+
+Use this reference when the user asks for usage, plan state, entitlement, quota, or asks whether VA can still run a quota-sensitive action.
+
+## Command
+
+- `vaone usage`
+
+## Workflow
+
+1. Run `vaone usage`.
+2. If the user asked a direct usage question, return the relevant fields from the CLI output.
+3. If usage is just a preflight for another task, compress it to one short line.
+
+## Default response style
+
+- Good: "Usage ready: daily report available, intelligence quota still open."
+- Avoid dumping the full usage output unless the user asked for detailed usage or troubleshooting.
+
+## Recovery notes
+
+- If usage says login is required, run `vaone auth login`.
+- If the user is troubleshooting access, show the full usage output instead of the one-line summary.
+