@deepraxis/cli 0.0.0-stage → 0.1.0-dev.244cd7e

package/LICENSE

@@ -0,0 +1,67 @@
+Deepractice Commercial Proprietary License
+
+Copyright (c) 2026 南京深度实践人工智能科技有限公司.
+Unified Social Credit Code: 91430104MAEDATJ09G.
+All rights reserved.
+
+IMPORTANT: THIS IS NOT AN OPEN SOURCE LICENSE.
+
+This repository and its source code, documentation, architecture, tests,
+scripts, configuration, prompts, agent designs, protocols, workflows, and other
+accompanying materials are proprietary commercial assets owned by 南京深度实践
+人工智能科技有限公司 (the "Copyright Holder").
+The Copyright Holder's Unified Social Credit Code is 91430104MAEDATJ09G.
+
+The purpose of this license is to bind this repository and the project code to
+the Copyright Holder as closed-source commercial intellectual property.
+
+No rights are granted by default. Access to this repository, possession of a
+copy of the source code, visibility into commit history, participation in
+business discussions, employment, consulting, shareholder status, investment,
+or cooperation with any related entity does not grant any ownership interest,
+copyright license, patent license, trademark license, trade secret license, or
+other intellectual property right.
+
+Without a separate written commercial agreement signed by the Copyright Holder,
+no person or entity may, directly or indirectly:
+
+1. use, run, deploy, host, or provide the software as a service;
+2. copy, modify, merge, adapt, translate, or create derivative works;
+3. publish, distribute, sublicense, lease, sell, transfer, or disclose the
+   software or any substantial part of it;
+4. reverse engineer, decompile, disassemble, or otherwise attempt to derive
+   source, structure, architecture, protocols, prompts, trade secrets, or
+   implementation details;
+5. use the software, code, documentation, architecture, protocols, prompts, or
+   repository history to train, fine-tune, evaluate, or improve any AI model,
+   coding agent, software-generation system, or competing product;
+6. remove, obscure, or alter copyright, license, ownership, confidentiality, or
+   attribution notices.
+
+All commercial use, internal business use, customer delivery, private
+deployment, SaaS operation, resale, redistribution, integration into another
+product, or access by third parties requires prior written authorization from
+the Copyright Holder.
+
+Contributions are accepted only on the basis that the contributor has the right
+to contribute them and assigns, or agrees to assign, all applicable rights in
+those contributions to the Copyright Holder unless a separate written agreement
+signed by the Copyright Holder states otherwise.
+
+This license applies to this repository as a whole. No part of this repository
+may be treated as public domain, community property, jointly owned project
+property, or an implied asset of any company, shareholder, collaborator,
+customer, investor, or business partner other than the Copyright Holder without
+a separate written agreement signed by the Copyright Holder.
+
+The Chinese legal name "南京深度实践人工智能科技有限公司" is the authoritative
+identity of the Copyright Holder. Any English rendering of that name is for
+identification convenience only and does not create a separate legal entity or
+alter ownership.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE, TITLE, AND NON-INFRINGEMENT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY ARISING
+FROM OR IN CONNECTION WITH THE SOFTWARE OR THE USE OF OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,56 @@
-# Temporary Holding Version
+# @deepraxis/cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Praxis commands for the Deepraxis public API. Requires Node.js 20 or newer.
+
+```sh
+npm i -g @deepraxis/cli@dev
+praxis --help
+praxis login
+praxis model list
+```
+
+The dev package defaults to Develop. Set `PRAXIS_ENV=develop|production` to
+select an environment; the stable package defaults to production. For scripts,
+set `PRAXIS_API_KEY` in the environment instead of using `praxis login`.
+
+Output modes:
+
+- `--format human`: tables and readable details.
+- `--format agent`: compact text for agents.
+- `--json` (or `--format json`): JSON for scripts.
+
+```sh
+praxis model list --json
+praxis model list --format agent
+praxis model list --limit 8
+```
+
+`--limit` uses the API's page-size parameter only for SDK-paginated operations.
+For other lists, human and agent modes show the first N items and the original
+total without sending the global limit to the API. The operation's own
+`--param-limit` still sends its API parameter when available.
+JSON output remains complete. `--all` follows supported pagination and cannot
+be combined with `--limit`.
+
+Generate instructions for an AI agent:
+
+```sh
+praxis skill > SKILL.md
+praxis skill --install ./skills
+```
+
+The install command creates `./skills/praxis-cli/SKILL.md`, or overwrites it
+with a notice. The command reference uses OpenAPI summaries; when absent, it
+uses the first sentence of the description or a description from command words.
+
+Login records are stored in the macOS Keychain or, on Linux, through
+`secret-tool`. If the system keychain is unavailable, login reports file storage
+at `~/.praxis/cli/<env>.json` (mode 0600). Existing files migrate automatically
+when keychain storage succeeds. `praxis whoami` shows the storage location;
+`praxis logout` removes both copies. On macOS, writes use `security -i` with
+the secret on stdin, never in process arguments. Records exceeding the tool's
+4096-byte interactive command limit also use the file fallback.
+
+From this repository, use `bun run praxis`. Run `bun run commands` in `apps/cli`
+to regenerate `COMMANDS.md` and the sample `SKILL.md`; `bun run commands:check`
+checks both. OpenAPI sync regenerates these documents after the SDK manifest.