i-plane 1.1.2 → 1.2.0

package/AGENTS.md

@@ -152,3 +152,22 @@ Keep project task statuses aligned with the work. Move a task into progress when
 starting, close it after its checks, and reopen it when a confirmed review finding
 invalidates completion. Report whether a change is local, installed or published;
 these are separate states. Keep commits and public metadata provider-agnostic.
+
+## Page command invariants
+
+Page commands use SessionClient, never the API-key client. Load Yjs, the live
+provider and WebSocket dependencies lazily; keep their exact versions external
+in both build paths. Session cookies and passwords join the API token in the
+secret guard, including old cookies after a refresh.
+
+Live success means acknowledged delivery, not a database commit. Never replay a
+mutation automatically. Complete asynchronous conversion before resolving a
+block anchor and checking its content fingerprint inside one transaction. Read
+commands never stamp. Only page stamp assigns missing top-level anchors.
+
+--yes confirms deletion; --force bypasses a stale fingerprint; --allow-loss
+accepts reported conversion losses. These decisions must stay separate. Empty
+--block must fail before a whole-page mutation can be selected.
+
+Page fixtures and wire tests live under tests/page*. Unsupported rich content
+must remain visible or produce an explicit loss warning.

package/README.md

@@ -25,6 +25,8 @@ comments, and `--json` whenever you need structured data. Nothing prompts for in
   and group related work in modules that can span multiple cycles.
 - **Triage requests:** collect reports in intake, then accept, reject, snooze
   or mark them as duplicates before committing to the work.
+- **Maintain project knowledge:** read pages, inspect live blocks and edit only
+  the section you need, with fingerprints to detect concurrent changes.
 - **Automate:** use concise lists, JSON output and distinct exit codes in
   agent workflows and shell scripts.
 
@@ -81,6 +83,10 @@ to any command for its structured result. Exit code `2` means an invalid call;
 For supported fields, compatibility details and development checks, see the
 [capability reference](docs/api-coverage.md).
 
+Pages use a Plane login and password instead of an API token. See the
+[page workflow](docs/pages.md) for session setup, block edits and delivery semantics.
+`i-plane page --help` carries the same command examples into your terminal.
+
 ## License
 
 MIT