npm - @patze/code-cli - Versions diffs - 0.55.1 → 0.55.3 - Mend

@patze/code-cli 0.55.1 → 0.55.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/CHANGELOG.md +13 -0
package/README.md +45 -202
package/VERSION +1 -1
package/docs/beta-release-handoff.md +1 -1
package/docs/beta-tester-checklist.md +2 -2
package/docs/install-beta.md +47 -30
package/docs/known-limitations.md +1 -1
package/package.json +1 -1

package/CHANGELOG.md CHANGED Viewed

@@ -4,6 +4,19 @@ All notable changes to `@patze/code-cli` are documented here.
 Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+## [0.55.3] - 2026-05-31
+### Changed
+- **README** — removed UI mockup / “What you see” section (npm page stays install + commands only).
+## [0.55.2] - 2026-05-31
+### Docs
+- **README** — Codex-style rewrite: install/start/auth/commands only; moved maintainer tables to `docs/`.
+- **`docs/install-beta.md`** + **`beta-tester-checklist.md`** — synced to 0.55.x; `--pair` install path.
 ## [0.55.1] - 2026-05-31
 ### Fixed (Codex-clean composer)

package/README.md CHANGED Viewed

@@ -1,248 +1,91 @@
 # Patze Code CLI
-Professional local terminal client for Patze Code / PatzeAgents.
+Terminal coding agent for [PatzeAgents](https://github.com/patzelife/patzelife-plugin-agentdiscord). Runs in your workspace; server handles auth, policy, runs, and artifacts.
-Patze Code runs coding tasks against your workspace while keeping **PatzeAgents server** as the authority for auth, entitlements, run records, artifacts, verification, and policy.
+**Internal beta** — install `@beta`, not `latest`. Details: [`docs/internal-beta.md`](docs/internal-beta.md).
-> **Internal beta (0.55.x):** Codex/cookbook-style composer, trust loop, runs automation, and gated agent execute. See [`docs/internal-beta.md`](docs/internal-beta.md) and [`docs/known-limitations.md`](docs/known-limitations.md). Not yet `npm latest` / 1.0.
-## Requirements
-- **Node.js** 20+
-- Patze API reachable from your machine (optional — for server-backed preview)
-## Install (internal beta)
+## Install
 ```bash
-# Helper script (monorepo)
-cd packages/patze-code-cli
-./scripts/install-beta.sh local
-# Or manual tarball
-npm run build && npm pack
-npm install -g ./patze-code-cli-0.55.0.tgz
+npm install -g @patze/code-cli@beta
 patze --version
 ```
-Registry:
+Pinned release: `@patze/code-cli@0.55.3`
+Requires **Node.js 20+**.
+## Start
 ```bash
-npm install -g @patze/code-cli@beta
-# or pinned: @patze/code-cli@0.10.5
-patze --version
+cd your-project
+patze
 ```
-Full guide: [`docs/install-beta.md`](docs/install-beta.md) · Checklist: [`docs/beta-tester-checklist.md`](docs/beta-tester-checklist.md)
-## Quick start (beta tester)
+One-shot (non-interactive):
 ```bash
-# 1. Clean fixture workspace
-mkdir -p /tmp/patze-beta && cd /tmp/patze-beta
-git init
+patze "summarize this repo in one paragraph"
+patze exec "fix the typo in README" --json   # JSONL stream for scripts
+```
-# 2. Optional — server auth (use env, never commit secrets)
-export PATZE_CODE_API=https://api.example.com
-export PATZE_CODE_TOKEN=<internal-api-key>
-export PATZE_CODE_USER_ID=<user-uuid>
+## Sign in
-# Or dashboard pairing (recommended for humans)
-# patze login --pair --api https://api.example.com [--web https://app.example.com]
+Agent tasks need Patze API credentials.
-# Optional — live Cursor model list in /model picker (OpenTUI + TTY)
-# export CURSOR_API_KEY=crsr_...
+```bash
+patze login --pair --api https://api.example.com
+```
-# 3. Read-only checks
-patze status
-patze doctor
-patze code inspect
-patze goal "Review README" --dry-run
+Or inside the shell: `/login`. Manual: `patze login <api> <token> [userId]`.
-# 4. Interactive trust loop
-patze
-```
+Env vars (optional): `PATZE_CODE_API`, `PATZE_CODE_TOKEN`, `PATZE_CODE_USER_ID`.
-Running `patze` shows a status card and tips:
+Optional: `CURSOR_API_KEY` adds live models to `/model` (bundled catalog always available).
-```text
-╭─ Patze Code · v0.55.0 ────────────────────────────────────╮
-│ workspace   /mnt/d/pat-test                               │
-│ auth        incomplete                                    │
-│ permission  Read-only                                     │
-│ safety      preview-first · read-only                     │
-╰───────────────────────────────────────────────────────────╯
-Beta · Dev demo — for internal testing only
-! auth incomplete — run `patze login --pair --api <url>` or set PATZE_CODE_* env
-Type a task, or /help for commands.
-Tips
-  • /inspect scans the workspace (read-only)
-  • /plan then /diff previews changes before any write
-  • /apply needs typed approval — it never auto-applies
-Type / for commands · ↑↓ to navigate · Tab/Enter to select
-›
-```
+## Commands
-Type `/` to open a live command palette that filters as you type:
+**Shell (`patze`)** — `/help`, `/status`, `/login`, `/logout`, `/model`, `/local`, `/cloud`, `/reset`, `/clear`, `/runs`, `/inspect`, `/goal`, `/plan`, `/diff`, `/permissions`, `/tools`, `/approve`, `/apply`, `/verify`, `/reject`, `/exit`
-```text
-› /p
-  /plan         Server preview only (no apply)
-❯ /permissions  Open permission mode selector
-  /help         Show slash commands
-  …
-```
+**CLI** — `patze status`, `patze doctor`, `patze config`, `patze runs list|open|cancel`, `patze goal … --dry-run`, `patze code inspect|plan|diff`
-Navigate with ↑↓, complete with Tab, run with Enter. Commands that need an
-argument (e.g. `/goal <task>`) complete to `/goal ` and wait for your input.
-When the palette is closed, ↑↓ recalls in-session history. The composer is
-TTY-only; piped / scripted input stays on readline and remains deterministic.
-Authenticate with **`patze login --pair --api <url>`** (dashboard device-code), **`/login`**
-inside the shell, or **`patze login <api> <token> [userId]`**. Environment variables
-`PATZE_CODE_API` / `PATZE_CODE_TOKEN` / `PATZE_CODE_USER_ID` also work. Tokens are
-masked in output and never kept in transcript or recall history.
-## Cookbook parity ([Cursor coding-agent-cli](https://github.com/cursor/cookbook/tree/main/sdk/coding-agent-cli))
-Patze Code is a **PatzeAgents-backed** hybrid (server authority + Codex/cookbook UX):
-| Cookbook capability | Patze CLI |
-|---------------------|-----------|
-| Interactive TUI (`patze`) | ✅ OpenTUI (Bun) or Node TTY fallback |
-| One-shot + stdin pipe | ✅ `patze "task"`, `patze agent`, `patze exec` |
-| `/` slash menu (inline palette) | ✅ filter-as-you-type; composer stays focused |
-| `/local`, `/cloud`, `/model`, `/reset` | ✅ + Patze trust loop commands |
-| Model picker search + T/F prefs | ✅ OpenTUI + Node TTY |
-| Live model catalog | ✅ bundled + `Cursor.models.list` when `CURSOR_API_KEY` set |
-| Plain pipe feed (stderr meta) | ✅ Codex feed on `patze exec` / non-TTY agent |
-| Direct `@cursor/sdk` runtime | ⚠️ Patze uses FastAPI execute + policy (by design) |
-## Command status (0.55.0)
-### Interactive (`patze` shell)
-| Command | Status | Notes |
-|---------|--------|-------|
-| free-text prompt | ✅ | Agent execute + SSE when auth ready |
-| `/help` | ✅ | |
-| `/status [--check]` | ✅ | Trust-loop snapshot + auth posture |
-| `/login`, `/logout` | ✅ | Save or clear credentials |
-| `/local`, `/cloud` | ✅ | Execution mode (cloud gated by server) |
-| `/model` | ✅ | Searchable picker + T/F thinking/fast (TTY + OpenTUI) |
-| `/runs`, `/run` | ✅ | List/open/cancel server runs |
-| `/reset`, `/clear` | ✅ | Fresh agent / clear transcript |
-| `/context` | ✅ | Session state (digests masked) |
-| `/goal`, `/inspect`, `/plan` | ✅ | Trust loop + preview |
-| `/permissions`, `/tools` | ✅ | Mode selector + tool catalog |
-| `/diff`, `/approve`, `/apply`, `/verify`, `/reject` | ✅ | Gated local apply loop |
-| `/exit` | ✅ | |
-### Top-level CLI
-| Command | Status | Notes |
-|---------|--------|-------|
-| `patze` | ✅ | Interactive shell (OpenTUI or Node TTY) |
-| `patze "<task>"` / `patze agent` | ✅ | One-shot agent; pipe uses Codex plain feed |
-| `patze exec "<task>" [--json]` | ✅ | CI/automation JSONL stream |
-| `patze --version` | ✅ | |
-| `patze status [--check]` | ✅ | |
-| `patze doctor [--check]` | ✅ | Read-only; e2e + cloud hints when dev env present |
-| `patze login --pair --api <url>` | ✅ | Dashboard device-code (recommended) |
-| `patze login <api> <token> [id]` | ✅ | Manual token paste |
-| `patze goal "<task>" --dry-run` | ✅ | Non-interactive plan |
-| `patze code inspect|plan|diff` | ✅ | Workspace / preview commands |
-| `patze code apply` | 🚫 disabled | Interactive `/apply` only |
-| `patze code verify` | ℹ️ help-only | No session apply → summary only |
-| `patze runs list|open|cancel` | ✅ | Server run history; `--json` on list/open |
-| `patze config` | ✅ | Resolved config paths + `web` URL |
-### Permission modes
-| Mode | Status | Capabilities |
-|------|--------|--------------|
-| `read-only` | ✅ | inspect, plan, diff |
-| `suggest` | ✅ | + approval gate |
-| `edit-with-approval` | ✅ | + gated `/apply` |
-| `full-auto` | 🚫 forbidden | Never enabled |
-Legend: ✅ implemented · 🚫 explicitly disabled · ℹ️ informational only
-## Trust loop
+**Disabled by design** — `patze code apply` (use interactive `/apply`), `full-auto` permission mode
-```
-prompt → inspect → plan → diff → permissions → approve → apply → verify
-```
+## Local apply (trust loop)
-Example inside `patze`:
+Preview first, then gated write:
 ```text
-/goal Update README quickstart
+/goal <task>
 /plan
 /diff
-/permissions suggest
-/approve
 /permissions edit-with-approval
+/approve
 /apply
-APPLY artifa…90ab
+APPLY <masked-digest>
 /verify
-/status
 ```
-Docs: [`docs/trust-loop.md`](docs/trust-loop.md) · [`docs/safety-model.md`](docs/safety-model.md)
+No auto-apply. No `--yes`. Verify does not run shell tests.
-## Safety model (summary)
+More: [`docs/trust-loop.md`](docs/trust-loop.md) · [`docs/safety-model.md`](docs/safety-model.md)
-- No auto-apply, no `--yes`, no shell execution from verify
-- Apply is interactive-only with explicit `APPLY <masked-digest>` confirmation
-- All session digests masked; tokens never printed in full
-- Verify fail-closed; drift recovery blocks stale approve/apply
-- **`full-auto` forbidden permanently**
+## Limits
-Full detail: [`docs/safety-model.md`](docs/safety-model.md)
-## Development & release verify
-```bash
-cd packages/patze-code-cli
-npm run verify        # version + pack + typecheck + tests + smoke + PTY suite
-npm run verify:all    # verify + gated verify:e2e (needs dev API up)
-npm run verify:pack   # tarball audit (--verbose for JSON summary)
-npm run smoke         # temp workspace + local npm pack install
-```
-Optional live-agent checks (repo root API + `server/.env`):
-```bash
-npm run verify:e2e           # smart-agent smoke when /health is up
-npm run e2e:cloud            # cloud preview → execute → SSE (GitHub origin required)
-npm run e2e:cloud:interactive # /cloud flow inside interactive shell
-npm run verify:ci-e2e-cloud  # CI gate for cloud execute (skip when API/cloud flag absent)
-```
+Session transcript is in-memory. Cloud execute needs GitHub `origin` + server flag. Not production `latest` yet.
-## Release blockers (before npm `latest` / 1.0)
+Full list: [`docs/known-limitations.md`](docs/known-limitations.md)
-- [ ] Public npm publish policy + scoped access review
-- [ ] Shell-based verify (npm test/lint) as optional gated capability
-- [ ] Server apply receipt correlation (read-only)
-- [ ] Cross-restart session persistence decision
-- [ ] OAuth polish beyond `login --pair` (token refresh, production redirect UX)
-- [ ] Production error telemetry without leaking secrets
-- [x] Cloud execute e2e in CI (optional gated job `cloud-e2e-gated`; needs secrets + `FEATURE_PATZE_CODE_CLI_CLOUD_EXECUTE`)
+## More docs
-## Documentation
+| Topic | Doc |
+|-------|-----|
+| Install & testers | [`docs/install-beta.md`](docs/install-beta.md) |
+| Architecture | [`docs/patze-cli-architecture.md`](docs/patze-cli-architecture.md) |
+| Changelog | [`CHANGELOG.md`](CHANGELOG.md) |
-- Architecture: [`docs/patze-cli-architecture.md`](docs/patze-cli-architecture.md)
-- Internal beta: [`docs/internal-beta.md`](docs/internal-beta.md)
-- Install: [`docs/install-beta.md`](docs/install-beta.md)
-- Beta checklist: [`docs/beta-tester-checklist.md`](docs/beta-tester-checklist.md)
-- Feedback template: [`docs/beta-feedback-template.md`](docs/beta-feedback-template.md)
-- Known limits: [`docs/known-limitations.md`](docs/known-limitations.md)
-- Release checklist: [`docs/release-checklist.md`](docs/release-checklist.md)
-- Changelog: [`CHANGELOG.md`](CHANGELOG.md)
+Maintainers: [`docs/beta-release-handoff.md`](docs/beta-release-handoff.md) · [`docs/release-checklist.md`](docs/release-checklist.md)
 ## License
-Proprietary — see [`NOTICE.md`](NOTICE.md).
+Proprietary — [`NOTICE.md`](NOTICE.md)

package/VERSION CHANGED Viewed

	@@ -1 +1 @@
1	- 0.55.1
1	+ 0.55.3

package/docs/beta-release-handoff.md CHANGED Viewed

@@ -95,7 +95,7 @@ npm install -g ./patze-code-cli-<version>.tgz
 ```bash
 npm install -g @patze/code-cli@beta
 # or pinned:
-npm install -g @patze/code-cli@0.55.0
+npm install -g @patze/code-cli@0.55.2
 patze --version
 patze doctor

package/docs/beta-tester-checklist.md CHANGED Viewed

@@ -1,11 +1,11 @@
 # Beta tester checklist
-Use this before reporting feedback. Safety posture must match **0.10.1+** — no new mutation shortcuts.
+Use this before reporting feedback. Safety posture matches **0.55.x** — no auto-apply, no `--yes`, no `full-auto`.
 ## Environment
 - [ ] Node 20+ (`node --version`)
-- [ ] `@patze/code-cli` 0.10.x (`patze --version`)
+- [ ] `@patze/code-cli` 0.55.x (`patze --version`)
 - [ ] Clean git workspace for apply tests (`git init` in a temp dir is fine)
 - [ ] `patze doctor` — dist ok, trust loop posture lines present

package/docs/install-beta.md CHANGED Viewed

@@ -1,57 +1,69 @@
 # Install — internal beta
-Audience: Patze team and trusted beta testers. Package: `@patze/code-cli@0.10.x`.
+For Patze team and trusted testers. Current line: **`@patze/code-cli@0.55.x`** (`@beta` on npm).
+Overview: [README](../README.md) · Limits: [`known-limitations.md`](known-limitations.md)
 ## Prerequisites
-- **Node.js 20+**
-- Optional: PatzeAgents API credentials via env (never commit secrets)
+- Node.js **20+**
+- A git workspace (recommended for apply tests)
+- Patze API access for agent tasks (optional for read-only smoke)
-## Option A — npm registry (when published)
+## Install from npm
 ```bash
 npm install -g @patze/code-cli@beta
-# or pinned:
-npm install -g @patze/code-cli@0.10.2
+patze --version
 ```
-## Option B — local tarball (maintainers / monorepo)
+Pinned example:
+```bash
+npm install -g @patze/code-cli@0.55.3
+```
+Use `@beta`, not `latest` — `latest` is an older stable tag until 1.0.
+## Install from monorepo (maintainers)
 ```bash
 cd packages/patze-code-cli
 ./scripts/install-beta.sh local
 ```
-Manual equivalent:
+Manual:
 ```bash
 cd packages/patze-code-cli
-npm run build
-npm pack
-npm install -g ./patze-code-cli-0.10.2.tgz
+npm run build && npm pack
+npm install -g ./patze-code-cli-0.55.3.tgz
 ```
-## Option C — development link
+Dev link:
 ```bash
 cd packages/patze-code-cli
-npm run build
-npm link
+npm run build && npm link
 ```
-## Verify install
+## Sign in
+Recommended (dashboard device code):
 ```bash
-patze --version          # expect @patze/code-cli 0.10.x
-patze status             # auth may be incomplete (exit 1) — OK for first run
-patze doctor             # read-only diagnostics, no network
-patze doctor --check     # optional /health probe (needs auth + api)
-patze                    # interactive shell — trust loop entry
+patze login --pair --api https://api.example.com
 ```
-## Optional auth (server preview)
+Inside `patze`: `/login`
-Use env vars — do not paste tokens into issue reports:
+Manual:
+```bash
+patze login <api-url> <token> [user-uuid]
+```
+Env (never paste into issues):
 ```bash
 export PATZE_CODE_API=https://api.example.com
@@ -60,18 +72,23 @@ export PATZE_CODE_USER_ID=<user-uuid>
 patze status --check
 ```
-Or one-time local config:
+Optional — live models in `/model`: `CURSOR_API_KEY`
+## Verify install
 ```bash
-patze login <api-url> <token> <user-uuid>
+patze --version          # expect 0.55.x
+patze doctor             # read-only; no network required
+patze status             # exit 1 without auth is OK on first run
+patze                    # interactive shell
 ```
-## Uninstall / reset
+## Uninstall
-See [`uninstall-reset.md`](uninstall-reset.md).
+[`uninstall-reset.md`](uninstall-reset.md)
-## Related
+## Next steps
-- [`beta-tester-checklist.md`](beta-tester-checklist.md)
-- [`internal-beta.md`](internal-beta.md)
-- [`known-limitations.md`](known-limitations.md)
+- Tester checklist: [`beta-tester-checklist.md`](beta-tester-checklist.md)
+- Feedback template: [`beta-feedback-template.md`](beta-feedback-template.md)
+- Maintainer publish: [`beta-release-handoff.md`](beta-release-handoff.md)

package/docs/known-limitations.md CHANGED Viewed

@@ -1,7 +1,7 @@
 # Known limitations — Patze Code CLI (0.55.x)
 These are **intentional** for the current slice unless behavior contradicts this list.
-Last aligned with **`npm run verify`** (unit + smoke + PTY suite) at **0.55.0**.
+Last aligned with **`npm run verify`** at **0.55.2** (README + install docs).
 ## Authentication

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@patze/code-cli",
-  "version": "0.55.1",
+  "version": "0.55.3",
   "description": "Patze Code — local terminal coding agent client for PatzeAgents",
   "license": "UNLICENSED",
   "type": "module",