@nvwa-os/cli 0.1.0

package/README.md

@@ -0,0 +1,64 @@
+# `@nvwa-os/cli`
+
+Unified Nvwa developer CLI. Terminal command: **`nvwa-os`** (npm package `@nvwa-os/cli`).
+
+## Install
+
+```bash
+# one-shot (after npm publish)
+npx @nvwa-os/cli login --project <code> --studio https://studio.example.com
+
+# global
+npm install -g @nvwa-os/cli
+nvwa-os whoami
+```
+
+Monorepo development:
+
+```bash
+bun run --cwd packages/cli build
+packages/cli/bin/nvwa-os whoami
+```
+
+Requires **Bun ≥ 1.x** at runtime (same as Agent Pod image).
+
+## Configure
+
+Recommended: device login writes `.nvwa/config.json` (see Studio **Agent 接入**).
+
+Config resolution priority (via `@nvwa-os/common`):
+
+1. `NVWA_INTEGRATION_DOCS_TOKEN` + API base env
+2. env token + `job.json` `integrationDocsHints` (Agent Pod)
+3. `~/.nvwa/config.json` + repo `.nvwa/config.json`
+
+## Commands
+
+| Group | Command | Audience |
+|-------|---------|----------|
+| Auth | `login` `logout` `whoami` `config path` | External developers |
+| Integration docs | `integration-docs contracts\|documents\|guides\|guide\|apis\|api` | External + Agent Pod |
+| Deploy ops | `ops deploy-status\|deploy-tree\|deploy-logs\|release-build-log` | Agent Pod (Phase 3: external dev key) |
+| Agent run | `run --mode cursor\|claude\|opencode` | **Agent Pod only** |
+
+### Examples
+
+```bash
+nvwa-os login --project demo --studio https://studio.example.com
+nvwa-os integration-docs apis --contract my-vendor --json
+nvwa-os ops deploy-status
+```
+
+`run` is injected in K8s Agent Jobs; external users normally do not need it.
+
+## Optional MCP
+
+[`@nvwa-os/integration-docs-mcp`](../integration-docs-mcp) is a separate package for Cursor MCP. It reads the same config file or env when started from your business repo.
+
+## Build
+
+```bash
+bun run build   # → dist/cli.js (bundled for npm / local bin)
+```
+
+Agent image also bundles this entry via `packages/agent/scripts/build-runtime.ts`.

package/bin/nvwa-os

@@ -0,0 +1,7 @@
+#!/usr/bin/env bun
+import { main } from "../dist/cli.js";
+
+await main(process.argv.slice(2)).catch((err) => {
+  console.error(err instanceof Error ? err.message : String(err));
+  process.exit(1);
+});

package/dist/cli-z1w83f81.js

@@ -0,0 +1,7 @@
+// @bun
+var __require = import.meta.require;
+
+export { __require };
+
+//# debugId=F4A8CA6A8DAF5FD664756E2164756E21
+//# sourceMappingURL=cli-z1w83f81.js.map

package/dist/cli-z1w83f81.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "F4A8CA6A8DAF5FD664756E2164756E21",
+  "names": []
+}