woobe-cli 0.13.4 → 0.13.6

package/USAGE.md

@@ -389,6 +389,11 @@ Use `woobe package validate`, `plan`, `import`, `status`, `resume`, `cancel`, an
 `export agent|network` for complete native author definitions. A Package requires
 the matching backend capability catalog; it does not fall back to Manifest.
 `--destination` optionally overrides the export directory (default: ./normalized-resource-name), while `--output` selects text/JSON/JSONL. Export accepts a name or UUID; `--env` defaults to draft, staging/production resolve current versions, and release requires `--version`. Import checkpoints are automatic unless explicitly specified. Use `package bindings SOURCE` for a destination YAML template.
+
+Project, operation and registry UUIDs accept either letter case. For example,
+`package status OPERATION_UUID --project PROJECT_UUID` also accepts uppercase
+UUIDs, including when recovering with `--checkpoint`. Opaque identifiers,
+aliases and idempotency keys retain their exact spelling.
 Knowledge can be rebuilt from portable documents or resolved through an external
 binding. See [PACKAGES.md](PACKAGES.md) for flags, lifecycle, protection, recovery
 and the supported CLI/server pair. Existing resource projections and Manifest
@@ -472,7 +477,34 @@ woobe network "@helpdesk" push
 ```
 
 Edit the registered `agent.yaml`, `network.yaml` and dependency descriptors in
-between pull and push. Reference-first `sync` aliases `pull`, and `update` aliases
+between pull and push. Generated descriptors use block YAML with two-space
+indentation and literal blocks for multiline instructions:
+
+```yaml
+format: woobe-package
+schema_version: "1.0"
+kind: Agent
+metadata:
+  key: support
+  name: Technical Support Specialist
+spec:
+  behavior:
+    additional_instructions: |-
+      Establish observable symptoms first.
+      Separate symptoms from root cause.
+```
+
+This excerpt illustrates formatting; the complete descriptor retains all fields,
+references, exact numbers, nulls and empty collections. Strings requiring escaped
+line separators remain quoted to preserve their content. Registered `.json` paths
+remain indented JSON, including after pull and clone. Moving between YAML and JSON
+converts only the descriptor; declared support files and resource identities stay
+intact. Format-only edits do not produce semantic changes in `diff`.
+Existing author files are reformatted when pull successfully writes them; review
+local edits with `diff` first. Portable exports keep their server-issued lock and
+downloaded bytes; editing them requires a new artifact/lock for locked validation.
+
+Reference-first `sync` aliases `pull`, and `update` aliases
 `push`: `woobe agent UUID update --path ./.woobe/agents/support`. Canonical API
 `woobe agent update UUID --file patch.yaml` still accepts a raw request payload.
 Quote aliases in PowerShell (`"@support"`). UUID, exact remote name on the first

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "woobe-cli",
-  "version": "0.13.4",
+  "version": "0.13.6",
   "description": "Woobe CLI for the public control plane and runtime",
   "license": "UNLICENSED",
   "repository": {