omgbase 0.30.3 → 0.31.0

package/dist/build-info.json

@@ -1,4 +1,4 @@
 {
-  "commit": "0ccc9cf4",
-  "built": "2026-11-03T07:35:43.622Z"
+  "commit": "d2dfacc4",
+  "built": "2026-11-07T02:08:43.770Z"
 }

package/dist/src/cmd/oqx.js

@@ -1,7 +1,7 @@
 import { parseArgs } from "node:util";
 import { readFileSync } from "node:fs";
 import { oqxRun, oqxRunAsync, collectSemanticPhrases } from "@omgbase/core";
-import { truncationFooter, CliUsageError, EngineErrorLike, EXIT_OK, emitMachine, renderHelp, renderHits, renderBareHits } from "../output.js";
+import { truncationFooter, CliUsageError, EngineErrorLike, EXIT_OK, emitMachine, renderHelp, renderHits, renderBareHits, hasEnvelope } from "../output.js";
 import { loadEmbedding } from "./_embed.js";
 import { remoteCall } from "./_remote.js";
 import { readStdin } from "./_mutate.js";
@@ -171,7 +171,7 @@ export function renderOqxResult(cli, result, bare = false) {
         const list = result.values ?? (result.consumer === "collect" || result.consumer === "first" || result.consumer === "single" ? result.hits : undefined);
         return emitMachine(cli, result, {
             ...(list ? { items: list } : {}),
-            ...(list && !result.values && !bare ? { ids: result.hits.map((h) => h._id) } : {}),
+            ...(list && !result.values && !bare && hasEnvelope(result.hits) ? { ids: result.hits.map((h) => h._id) } : {}),
             cursor,
         });
     }

package/dist/src/output.d.ts

@@ -82,11 +82,18 @@ interface MachineIO {
 }
 /** Print `doc` in the current machine mode (`--json`/`--jsonl`/`--ids`); returns EXIT_OK. */
 export declare function emitMachine(cli: MachineIO, doc: unknown, shape?: MachineShape): number;
+/** `_id`/`_path` are optional: a grouped row (spec/surface §1.4) carries
+ *  neither — "a grouped row is not a store row" — so every renderer below
+ *  must check before assuming the envelope. */
 export interface HitLike {
-    _id: string;
-    _path: string;
+    _id?: string;
+    _path?: string;
     [k: string]: unknown;
 }
+/** Does every hit carry the store envelope (`_id`/`_path`)? False for a
+ *  grouped query's hits (spec/surface §1.4) — empty counts as enveloped
+ *  (nothing to contradict it), matching the bare-render decision below. */
+export declare function hasEnvelope(hits: readonly HitLike[]): boolean;
 export declare const HIT_CELL_MAX = 60;
 /** Clip `s` to `max` visible characters, marking the cut with `…`. */
 export declare function truncateCell(s: string, max?: number): string;

package/dist/src/output.js

@@ -171,6 +171,12 @@ function indent(s, pad) {
         .map((l) => pad + l)
         .join("\n");
 }
+/** Does every hit carry the store envelope (`_id`/`_path`)? False for a
+ *  grouped query's hits (spec/surface §1.4) — empty counts as enveloped
+ *  (nothing to contradict it), matching the bare-render decision below. */
+export function hasEnvelope(hits) {
+    return hits.every((h) => h._id !== undefined);
+}
 export const HIT_CELL_MAX = 60;
 /** Clip `s` to `max` visible characters, marking the cut with `…`. */
 export function truncateCell(s, max = HIT_CELL_MAX) {
@@ -211,8 +217,14 @@ export function hitColumns(hits) {
  *  (header `_id`, `_path`, then the projected keys — spec/cli §4, 5.0). */
 export function renderHits(cli, hits) {
     const { io, style } = cli;
+    // A grouped query's hits carry no envelope at all (spec/surface §1.4) — the
+    // projection-only table is the only correct rendering for them, same as
+    // `--bare` chooses explicitly for an enveloped result.
+    if (!hasEnvelope(hits))
+        return renderBareHits(cli, hits);
     const projected = hitColumns(hits);
     if (projected.length === 0) {
+        // hasEnvelope guarantees every hit's `_id`/`_path` are defined here.
         for (const h of hits)
             io.out(`${style.id(h._id)}  ${style.accent(h._path)}`.trimEnd());
         return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omgbase",
-  "version": "0.30.3",
+  "version": "0.31.0",
   "description": "Open Markdown Graph Base — CLI",
   "license": "MIT",
   "repository": {
@@ -45,10 +45,10 @@
     "omg": "./dist/src/main.js"
   },
   "dependencies": {
-    "@omgbase/core": "^0.35.1",
+    "@omgbase/core": "^0.36.0",
     "@omgbase/fs-adapter": "^0.2.0",
-    "@omgbase/git-adapter": "^0.1.3",
-    "@omgbase/sync": "^0.7.6",
+    "@omgbase/git-adapter": "^0.1.5",
+    "@omgbase/sync": "^0.7.8",
     "yaml": "^2.9.0"
   },
   "devDependencies": {