pi-supernova 0.10.0 → 0.10.1

package/README.md

@@ -12,6 +12,13 @@ Ordinary JavaScript control flow remains available; the guest command bindings
 are only `read`, `edit`, `write`, and `bash`. Supernova supplies retrieval,
 transactional file operations, batching, bounded results and the grouped nova UI.
 
+## What is new in 0.10.1
+
+- JSON reads that still send a leftover `selector` key (the standing schema's
+  `json:true|selector` union, misread as a second option) fold into `json`.
+  `json:true` plus `selector:".field"` or `selector:"field"` is `.field`.
+  Two real projections (`json:".a"` and `selector:".b"`) still fail.
+
 ## What is new in 0.10.0
 
 - Background bash sessions support launch, polling, input and stop with bounded
@@ -640,7 +647,9 @@ return {verdict, values};
 ```
 
 Selectors support "." (root), .field, .nested[0], .items[0:10], and .["quoted.key"].
-Use json:true for the complete parsed value. Selectors are not full jq: pipes,
+Use json:true for the complete parsed value. Put the selector in `json`
+(`json:".field"`), not a second `selector` key; a leftover `selector` folds
+when `json` is absent, `true`, or `"."`. Selectors are not full jq: pipes,
 filters, wildcards and negative indices fail explicitly. Missing keys and indices
 fail; false, zero and null remain values. Slices use an exclusive end and clamp to
 array length. Only own JSON properties are traversed; nothing is evaluated.

package/docs/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [0.10.1] - 2026-09-23
+
+### Fixed
+
+- JSON `read` folds a leftover `selector` key into `json`. The standing schema
+  wrote `json:true|selector` as a union on `json`'s value; models sent a second
+  option and hit `read does not accept option "selector"`. `json:true` plus
+  `selector:".field"` or `selector:"field"` now projects `.field`. Two real
+  projections still fail.
+
 ## [0.9.0] - 2026-09-20
 
 ### Changed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-supernova",
-  "version": "0.10.0",
+  "version": "0.10.1",
   "description": "CodeMode for Pi and OMP: read, edit, write and bash, with transactional files, source views and shared-input program batches.",
   "type": "module",
   "author": "AdityaVG13",

package/src/contract/read.js

@@ -1,5 +1,5 @@
 import { errorMessage, isString, isObject, isNumber, looksLikePath } from "../shared/decode.js";
-import { sessionJsonArgs, validateJsonRead } from "../fs/json-read.js";
+import { foldJsonSelectorAlias, sessionJsonArgs, validateJsonRead } from "../fs/json-read.js";
 
 export const SESSION_URI = /^(?:agent|artifact):\/\//i;
 
@@ -79,11 +79,13 @@ function autoResolve(args) {
 export function normalizeRead(params) {
   if (!isObject(params)) throw new Error("read requires an options object");
 
-  if (params.path !== undefined && params.target !== undefined && params.path !== params.target) {
+  const folded = foldJsonSelectorAlias(params);
+
+  if (folded.path !== undefined && folded.target !== undefined && folded.path !== folded.target) {
     throw new Error("read accepts either path or target, not both");
   }
 
-  const args = sessionJsonArgs({ ...params, path: params.path ?? params.target });
+  const args = sessionJsonArgs({ ...folded, path: folded.path ?? folded.target });
   validateJsonRead(args);
   assertReadOptions(args);
   assertReadFlags(args);

package/src/fs/json-read.js

@@ -96,6 +96,48 @@ export function jsonProjector(json) {
   };
 }
 
+function isWholeJson(json) {
+  return json === true || json === ".";
+}
+
+function coerceOneSelector(value) {
+  if (!isString(value) || value.length === 0 || value.length > 2048) throw new Error(SELECTOR_HELP);
+  const selector = value.startsWith(".") ? value : "." + value;
+
+  parseSelector(selector);
+
+  return selector;
+}
+
+function coerceSelector(value) {
+  if (Array.isArray(value)) {
+    if (!value.length || value.length > 64) throw new Error("JSON selector list requires 1 to 64 selectors");
+
+    return value.map(coerceOneSelector);
+  }
+
+  return coerceOneSelector(value);
+}
+
+/**
+ * Standing copy writes json:true|selector as a union on json's value.
+ * Models still send a leftover selector key (often with json:true).
+ * Fold it when json is absent or the whole document; reject two real projections.
+ */
+export function foldJsonSelectorAlias(args) {
+  if (!isObject(args) || args.selector === undefined) return args;
+
+  if (args.json !== undefined && !isWholeJson(args.json)) {
+    throw new Error("read accepts json or selector, not both; put the selector in json (json:\".field\")");
+  }
+
+  const next = { ...args, json: coerceSelector(args.selector) };
+
+  delete next.selector;
+
+  return next;
+}
+
 export function sessionJsonArgs(args) {
   if (!isString(args.path) || !/^(agent|artifact):\/\//i.test(args.path) || !args.path.includes("?")) return args;
   const [uri, query] = args.path.split("?");

package/src/runtime/reference.js

@@ -2,7 +2,7 @@
 export const REFERENCE = `JS body/async arrow; read/write/edit/bash, no fs/import/require. file: workspace JS; data: literals ≤48000 JSON chars.
 read(path|paths,offset=1,limit?) → text/text[]; dirs→entries; PNG/JPEG/GIF/WebP ≤16/20MiB.
 Text ≤64 MiB internally; complete:true requires whole file. Display capped: summarize or read(path,{offset:1,limit:80}); larger files via bash.
-read({path,json:true|selector}) → JSON, no jq (16MiB input/64MiB selection). Values retain their types.
+read({path,json:true}) or json:".field" or json:[".a"] → JSON, no jq (16MiB input/64MiB selection). Values retain their types. selector is json's value; a leftover selector key folds.
 read("symbol or question") = read({query,resolve:true}) → view; check status; view.text is a span. read(path,{about}) windows; read({query,evidence:true}) evidence; read({path,outline:true}) declarations.
 write/edit workspace-only; external changes need separately authorized command. write(path,text) or {path,content,append:true}; after read edit or replace:true.
 edit(path,oldText,newText) or {path,edits:[{oldText,newText}]}; unique exact match; numbered windows. edit(view,text) or edit(view,old,new). edit(async()=>{...}) checkpoint: no bash; merge/rollback+rethrow.