omgbase 0.16.0 → 0.18.0

package/dist/build-info.json

@@ -1,4 +1,4 @@
 {
-  "commit": "b5bb9c1",
-  "built": "2026-10-13T09:12:01.162Z"
+  "commit": "66abf7c",
+  "built": "2026-10-14T06:35:28.357Z"
 }

package/dist/src/cmd/_mutate.js

@@ -159,7 +159,7 @@ export function runSugar(cli, ws, repo, sugar, opts = {}) {
  */
 export async function runSugarRemote(cli, tool, toolArgs, effects, refs = []) {
     if (cli.flags.dryRun)
-        return renderPlan(cli, await remoteCall(cli, "plan", { effects: await effects() }));
+        return renderPlan(cli, await remoteCall(cli, "plan", { effects: await effects(), diffs: true }));
     return renderReceipt(cli, await remoteSugar(cli, tool, toolArgs, effects, refs));
 }
 /** A ref as an effect target for a remote `plan`: a `b_` id is the block, a `d_` id the document, anything else a document path. */
@@ -198,7 +198,7 @@ export function runEffects(cli, ws, repo, effects, opts = {}) {
 /** Remote peer of `runEffects`: the `apply` tool with `effects` (the Receipt), or on a dry run the `plan` tool (the Plan). */
 export async function runEffectsRemote(cli, effects, reason) {
     if (cli.flags.dryRun)
-        return renderPlan(cli, await remoteCall(cli, "plan", { effects }));
+        return renderPlan(cli, await remoteCall(cli, "plan", { effects, diffs: true }));
     return renderReceipt(cli, await remoteCall(cli, "apply", { effects, ...(reason ? { reason } : {}) }));
 }
 /** `execute`: commit exactly a Plan (the plan form, spec/mutate §11.7 — admission, then the one transaction), rendered as a Receipt. */

package/dist/src/cmd/admin.js

@@ -40,7 +40,7 @@ function runGcCmd(cli, args) {
     if (values.help) {
         return renderHelp(cli, {
             name: "gc",
-            summary: "Mark-and-sweep unreferenced blobs and tree nodes (refuses unless gc.enabled is set in repo settings)",
+            summary: "Mark-and-sweep unreferenced blobs and tree nodes, and the `same` disposition rows a pre-14.2 store wrote (refuses unless gc.enabled is set in repo settings)",
             usage: "gc [--dry-run] [--vacuum]",
             options: [
                 ["--dry-run", "report what would be swept, sweep nothing (allowed even when gc is disabled)"],
@@ -57,7 +57,9 @@ function runGcCmd(cli, args) {
     if (!enabled && !dryRun) {
         throw new EngineErrorLike("target_missing", "gc is disabled; set gc.enabled=true (or use --dry-run)");
     }
-    const swept = runGc(ws.store, { enabled: enabled || dryRun });
+    // A dry run counts every sweep — blobs, tree nodes and the `same` disposition
+    // rows a 14.1 store wrote (spec/store §7, 14.2) — and deletes nothing.
+    const swept = runGc(ws.store, { enabled: enabled || dryRun, dryRun });
     // `--vacuum` runs after the sweep (the sweep's freed pages are what it returns);
     // a dry run measures the free pages and vacuums nothing (spec/store §7).
     const vac = values.vacuum
@@ -68,7 +70,7 @@ function runGcCmd(cli, args) {
     const result = vac ? { ...swept, vacuum: vac } : swept;
     if (cli.flags.mode !== "human")
         return emitMachine(cli, result);
-    cli.io.err(cli.style.dim(`  swept ${swept.blobsSwept} blobs, ${swept.treeNodesSwept} tree nodes`));
+    cli.io.err(cli.style.dim(`  swept ${swept.blobsSwept} blobs, ${swept.treeNodesSwept} tree nodes, ${swept.sameDispositionsSwept} same dispositions`));
     if (vac)
         cli.io.err(cli.style.dim(vac.applied ? `  vacuumed, reclaimed ${humanBytes(vac.reclaimable)}` : `  would vacuum ${humanBytes(vac.reclaimable)}`));
     return EXIT_OK;
@@ -83,7 +85,7 @@ function runDoctor(cli, args) {
             usage: ["doctor [--json]", "doctor --size [--json]"],
             options: [
                 ["--size", "instead of the checks: what the database is made of — bytes and rows per category (content, history, search, sync) and table, the file's pages, what VACUUM would reclaim, advice"],
-                ["--json", "`{ ok, checks: [{ name, ok, detail }] }`; with --size `{ file, categories, advice }`"],
+                ["--json", "`{ ok, checks: [{ name, ok, detail }] }`; with --size `{ file, categories, same_dispositions, advice }`"],
             ],
         });
     }

package/dist/src/cmd/oqx.js

@@ -167,10 +167,20 @@ export function renderOqxResult(cli, result, bare = false) {
             cursor,
         });
     }
+    // Unknown names (spec/surface §1.5, spec/cli §6 `query`): the result's `hints`
+    // — names the query reads that no row of their kind carries — print LAST on
+    // stderr, one dim `  hint: …` line each, in every human rendering (the
+    // machine modes carry the member itself).
+    const { style, io } = cli;
+    const hints = () => {
+        for (const h of result.hints ?? [])
+            io.err(style.dim(`  hint: ${h}`));
+    };
     // Scalar consumers (count/exists/none) have no hits — render the reduction itself.
     if (result.consumer === "count" || result.consumer === "exists" || result.consumer === "none") {
         const scalar = result.consumer === "count" ? String(result.count) : result.consumer === "exists" ? String(result.exists) : String(result.none);
         cli.io.out(scalar);
+        hints();
         return EXIT_OK;
     }
     // A `values` projection has no hits — one bare value per line (strings
@@ -180,11 +190,12 @@ export function renderOqxResult(cli, result, bare = false) {
             cli.io.out(typeof v === "string" ? v : JSON.stringify(v));
         if (cursor !== null)
             truncationFooter(cli.io, cli.style, cursor);
+        hints();
         return EXIT_OK;
     }
-    const { style, io } = cli;
     if (result.hits.length === 0) {
         io.err(style.dim("  no hits"));
+        hints();
         return EXIT_OK;
     }
     if (bare)
@@ -193,6 +204,7 @@ export function renderOqxResult(cli, result, bare = false) {
         renderHits(cli, result.hits);
     if (result.truncated)
         truncationFooter(io, style, result.cursor ?? "");
+    hints();
     return EXIT_OK;
 }
 // `query` (alias `q`) is the single, default query surface — the OQX engine.

package/dist/src/cmd/retarget.js

@@ -29,7 +29,7 @@ async function runRetarget(cli, args) {
     // Remote: the `plan` tool previews, `links_retarget` commits server-side.
     if (cli.flags.server) {
         if (!values.apply || cli.flags.dryRun) {
-            const plan = await remoteCall(cli, "plan", { effects: sugar.effects });
+            const plan = await remoteCall(cli, "plan", { effects: sugar.effects, diffs: true });
             return values.apply ? renderPlanDiffs(cli, plan) : renderHits(cli, from, to, retargetOf(plan).hits);
         }
         // `links_retarget` where listed (its result adds `hits`/`pairs`), else `apply { retarget }` (spec/cli §2.3, 4.2).

package/dist/src/cmd/update.js

@@ -62,7 +62,7 @@ async function runDocUpdate(cli, args) {
         // A server without `docs_update` (a minimal profile) gets `apply` over the same effect (spec/cli §2.3, 4.2).
         const setContent = { op: "set", target: { kind: "document", ...docLocator(doc) }, field: "content", value: bytes };
         if (dryRun)
-            plan = await remoteCall(cli, "plan", { effects: [setContent] });
+            plan = await remoteCall(cli, "plan", { effects: [setContent], diffs: true });
         else
             receipt = await remoteSugar(cli, "docs_update", { ...docLocator(doc), content: bytes, ...(values.reason ? { reason: values.reason } : {}) }, () => [setContent]);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omgbase",
-  "version": "0.16.0",
+  "version": "0.18.0",
   "description": "Open Markdown Graph Base — CLI",
   "license": "MIT",
   "repository": {
@@ -45,9 +45,9 @@
     "omg": "./dist/src/main.js"
   },
   "dependencies": {
-    "@omgbase/core": "^0.19.0",
+    "@omgbase/core": "^0.21.0",
     "@omgbase/fs-adapter": "^0.2.0",
-    "@omgbase/sync": "^0.5.12",
+    "@omgbase/sync": "^0.5.14",
     "yaml": "^2.9.0"
   },
   "devDependencies": {