pzero-operator 0.1.0 → 0.1.2

package/LICENSE

@@ -1,5 +1,21 @@
-All rights reserved.
+MIT License
 
-This software is provided as a packaged product release.
-No permission is granted to copy, modify, redistribute, sublicense, or publish
-this software without explicit permission from the author.
+Copyright (c) 2026 Yernur
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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 AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,6 +1,40 @@
 # Operator
 
-`operator` is a terminal AI agent for coding, shell work, and technical workflows.
+`operator` is a coding-first terminal AI agent from the `ProjectZero` ecosystem.
+
+It starts with software development, repository work, shell execution, and technical workflows, but it is not meant to stop there. The longer direction is a stronger operator layer for your machine: local projects, execution flows, infrastructure-style tasks, model routing, and broader on-device control.
+
+This is the path toward a more capable `operator` surface, not just another chat wrapper.
+
+## What it is
+
+- coding-first terminal intelligence
+- real CLI, installed through npm
+- built for repository work, patching, shell execution, and session continuity
+- supports hosted and local model rails
+- keeps user state in a hidden local directory instead of polluting the package itself
+
+## Product direction
+
+`operator` begins as a serious coding agent.
+
+That means:
+
+- reading code
+- editing files
+- running commands
+- resuming technical sessions
+- working across local repositories
+
+But the broader direction is larger than coding alone:
+
+- terminal execution
+- technical operations
+- localhost project control
+- dev workflows
+- model-flexible runtime selection
+
+The long-term goal is a stronger device-level operator surface inside the `ProjectZero` ecosystem.
 
 ## Install
 
@@ -10,34 +44,100 @@ From npm:
 npm install -g pzero-operator
 ```
 
-From a release tarball:
-
-```bash
-npm install -g ./pzero-operator-0.1.0.tgz
-```
-
 After install:
 
 ```bash
 operator
 ```
 
-## First Run
+## Platform status
+
+- Linux: primary supported path
+- macOS: expected path, should be validated per environment
+- Windows: install path exists, but runtime support should currently be treated as experimental until the Windows startup path is fully hardened
+
+## Model rails
+
+`operator` currently works with two main runtime paths:
+
+### Alem AI Plus
+
+Hosted path for fast startup.
+
+- site: `https://plus.alem.ai/`
+- services: `https://plus.alem.ai/services`
+- current hosted profiles in `operator`:
+  - `gpt-oss`
+  - `qwen3.6 27b`
+  - `gemma4`
+
+The first time a hosted model is selected, `operator` asks for the relevant API key and stores local state in the hidden agent directory.
 
-- `alem ai plus` models ask for an API key the first time you select them
-- `ollama` is optional and can be selected with:
+### Ollama
+
+Optional local or cloud model path.
+
+You can switch into Ollama with:
 
 ```bash
 operator use ollama
 ```
 
-## Data Layout
+This path is useful when you want a more local-first runtime or want to move between local and cloud Ollama models.
+
+## First-run flow
+
+Typical first use:
+
+1. install the package from npm
+2. run `operator`
+3. choose a runtime rail
+4. if using `Alem AI Plus`, enter the API key when asked
+5. start working inside the terminal
+
+## What `operator` can do now
+
+- inspect repositories
+- patch and write files
+- execute shell commands
+- continue prior sessions
+- route between hosted and local model paths
+- work as a coding-first assistant for technical workflows
+
+## Data layout
+
+Package runtime:
+
+- installed by npm
+
+User state:
+
+- stored in the hidden directory `~/.operator/agent`
+
+This includes:
+
+- sessions
+- model settings
+- local auth state
+
+That separation keeps the package cleaner and makes user state easier to manage independently.
+
+## ProjectZero
+
+`operator` is part of `ProjectZero`, a Kazakhstan startup building a broader ecosystem around AI products, AI agents, execution layers, and technical operator surfaces.
+
+`operator` is the public terminal command layer inside that ecosystem.
+
+## Release posture
+
+This package is intended to be installed as a real product surface, not just read as source.
+
+Release packages do not ship:
 
-- package runtime is installed by npm
-- user state lives in the hidden directory `~/.operator/agent`
-- sessions, model settings, and local auth stay outside the package itself
+- local sessions
+- local auth files
+- user machine state
 
-## Release Notes
+## License
 
-- release tarballs are built as self-contained npm packages
-- source maps, local sessions, and local auth files are not shipped
+MIT

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "pzero-operator",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "private": false,
   "type": "module",
-  "description": "Operator is a coding-first terminal AI agent for vibe coding, software development, shell execution, and broader technical work.",
-  "license": "UNLICENSED",
+  "description": "Operator is a coding-first terminal AI agent from ProjectZero for software development, shell execution, local project workflows, and broader device-level operator control.",
+  "license": "MIT",
   "engines": {
     "node": ">=20"
   },