@pqpo/pragma 0.1.0-next.23 → 0.1.0-next.24

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.
package/README.md CHANGED
@@ -43,6 +43,28 @@ compiled CLI and one native keychain dependency only; it does not
43
43
  download a payload, install a second Node.js runtime, or publish a consumer
44
44
  lockfile.
45
45
 
46
+ ## Shared Desktop configuration
47
+
48
+ Configure Runtime Environments, model connections and credentials, and import resources in Desktop
49
+ first. Use the same OS user and `PRAGMA_HOME` for both apps, then close Desktop and run an imported
50
+ Expert, Team or Flow with the CLI. The CLI reads the saved Environment revisions and model connections;
51
+ PI uses the saved SecretRefs through the existing OS keychain, while Harness runtimes retain their
52
+ native authentication. Model or credential failures are reported instead of selecting another model.
53
+ If credentials require migration, open the current Desktop once and resolve the reported migration
54
+ before retrying. Existing Sessions retain their pinned Runtime identity and Environment revision.
55
+
56
+ ```bash
57
+ pragma expert discover --format=json --interactive=never
58
+ pragma expert run expert:<16-char-id> --workspace /absolute/workspace \
59
+ --prompt "Complete the task" --format=json --interactive=never
60
+ pragma mission get <MISSION_ID> --view result --format=json
61
+ ```
62
+
63
+ No CLI environment editor, Bundle manager or alternative credential backend is added. Memory Evidence
64
+ capture, durable enrichment queueing and recall remain available when policy permits. Enrichment,
65
+ index maintenance and Learning require a live, configured Desktop on the same home; capturing Evidence
66
+ does not mean a Memory was generated. Knowledge/Skill publication still requires approval.
67
+
46
68
  ## Use
47
69
 
48
70
  Run `pragma --help` for the current command list. Read-only Mission and Board