@omgbase/core 0.23.0 → 0.27.0

package/dist/src/oqx-js/sql/translate.js

@@ -56,18 +56,20 @@ export const NON_PROPERTY_NAMES = {
     docs: new Set(["doc", "nodes", "blocks", "out_links", "in_links", "revisions", "data", "frontmatter", "inline"]),
     blocks: new Set(["block", "doc", "children", "nodes", "out_links", "section", "attrs"]),
     nodes: new Set(["section", "doc", "block", "blocks", "subsections", "children", "attrs"]),
-    links: new Set(["doc", "dst"]),
+    links: new Set(["doc", "dst", "block"]),
 };
 // ---- engine attributes ------------------------------------------------------
 // The engine attributes (spec/surface §1.2, 3.0: bare, snake_case, winning on
-// collision — `id`, `path`, `raw`, `hash`, `updated_at` on docs and blocks,
-// `title`/`tags` on docs, `id`/`path` on nodes and edges) → a param-free SQL
+// collision — `id`, `path`, `raw`, `hash`, `updated_at`, `created_at` on docs
+// and blocks, `title`/`tags` on docs, `id`/`path` on nodes and edges) → a param-free SQL
 // scalar, per target, with its kind. The structural columns and foreign keys are
 // translated in `translateOperand`. Anything not mapped (`raw`, reconstructed or
 // a blob; `title`, computed; `tags`, the union of the authored list and the
 // computed hashtags) returns null → residual, and the caller must NOT fall
 // through to a property read of the same name (the attribute wins in memory).
-// `updated_at` is a correlated subquery. `path` (and the edge field `dst_path`)
+// `updated_at` and `created_at` (4.10) are correlated subqueries over the
+// document's revisions (`current_rev` / `seq = 1`); a block's are residual, as
+// before. `path` (and the edge field `dst_path`)
 // is the REFERENCE form on the surface (spec/surface §1 "Paths", 2.0) — `'/' ||
 // <storage column>` in SQL — so every comparison, `startsWith`, `contains`,
 // `lower()`… sees exactly the string the in-memory attribute yields;
@@ -79,8 +81,8 @@ export function pathColumn(col) {
 /** The identity/bytes/time attributes per kind — the names `attributeSql` owns
  * (the structural columns are handled per target in `translateOperand`). */
 export const ROW_ATTRIBUTES = {
-    docs: new Set(["id", "path", "raw", "hash", "updated_at", "title", "tags"]),
-    blocks: new Set(["id", "path", "raw", "hash", "updated_at"]),
+    docs: new Set(["id", "path", "raw", "hash", "updated_at", "created_at", "title", "tags"]),
+    blocks: new Set(["id", "path", "raw", "hash", "updated_at", "created_at"]),
     nodes: new Set(["id", "path"]),
     links: new Set(["id", "path"]),
 };
@@ -93,6 +95,7 @@ function attributeSql(name, ctx) {
             case "path": return pathColumn(`${doc}.path`);
             case "hash": return text(`lower(hex(${self}.file_hash))`);
             case "updated_at": return text(`(SELECT c.ts FROM revisions r JOIN commits c ON c.commit_id = r.commit_id WHERE r.rev_id = ${self}.current_rev)`);
+            case "created_at": return text(`(SELECT c.ts FROM revisions r JOIN commits c ON c.commit_id = r.commit_id WHERE r.doc_id = ${self}.doc_id AND r.seq = 1)`);
         }
     else if (target === "blocks")
         switch (name) {
@@ -300,6 +303,8 @@ export function translateOperand(e, ctx) {
                     return text(`lower(hex(${doc}.file_hash))`);
                 if (k === "updated_at")
                     return text(`(SELECT c.ts FROM revisions r JOIN commits c ON c.commit_id = r.commit_id WHERE r.rev_id = ${doc}.current_rev)`);
+                if (k === "created_at")
+                    return text(`(SELECT c.ts FROM revisions r JOIN commits c ON c.commit_id = r.commit_id WHERE r.doc_id = ${doc}.doc_id AND r.seq = 1)`);
                 if (k === "format")
                     return text(`${doc}.format`);
                 if (k.startsWith("$"))
@@ -334,6 +339,8 @@ export function translateOperand(e, ctx) {
                     return probe("lower(hex(dd.file_hash))");
                 if (k === "updated_at")
                     return probe("(SELECT c.ts FROM revisions r JOIN commits c ON c.commit_id = r.commit_id WHERE r.rev_id = dd.current_rev)");
+                if (k === "created_at")
+                    return probe("(SELECT c.ts FROM revisions r JOIN commits c ON c.commit_id = r.commit_id WHERE r.doc_id = dd.doc_id AND r.seq = 1)");
                 if (k === "format")
                     return probe("dd.format");
                 if (k.startsWith("$"))
@@ -358,6 +365,26 @@ export function translateOperand(e, ctx) {
                     return text(`(SELECT bb.${k} FROM blocks bb WHERE bb.block_id = ${self}.block_id)`);
                 return null;
             }
+            // block.<x> reach-through from a link (spec/surface §1.2, 4.11): the SOURCE
+            // block, keyed by the row's own `src_block` — `block.id` is that FK column
+            // (NULL for a frontmatter link, exactly where `block` is absent in memory);
+            // everything else is a primary-key probe of the block row, NULL for the
+            // same rows (`block.path` reads the scan's joined source document inside
+            // the probe, so it too is NULL when there is no block). `raw`, `hash`,
+            // `updated_at`, `attrs` and the relations stay residual.
+            if (head === "block" && target === "links" && rest.length === 1) {
+                const k = rest[0];
+                const probe = (col) => text(`(SELECT ${col} FROM blocks bb WHERE bb.block_id = ${self}.src_block)`);
+                if (k === "id")
+                    return text(`${self}.src_block`);
+                if (k === "path")
+                    return probe(`'/' || ${doc}.path`);
+                if (k === "doc_id")
+                    return probe("bb.doc_id");
+                if (k === "type" || k === "text")
+                    return probe(`bb.${k}`);
+                return null;
+            }
             return null;
         }
         case "call": {

package/dist/src/oqx-js/store-index.js

@@ -79,7 +79,7 @@ function probeFor(target, path) {
     // relation / handle (`out_links`, `data`, `frontmatter`, …), not the `format` column
     // (not indexed), not an OQX `$` name, and of the engine attributes only
     // `title` (the computed `$title` row, a scalar property the author's `title:`
-    // never reaches — `data.title` does): `raw`, `hash`, `updated_at` and `tags`
+    // never reaches — `data.title` does): `raw`, `hash`, `updated_at`, `created_at` and `tags`
     // (authored ∪ hashtags) have no index and are never property probes.
     if (key === "title")
         return { kind: "property", key: "$title", source: "computed" };

package/dist/src/search/cel/parser.d.ts

@@ -2,6 +2,8 @@ import type { Node } from "./ast.js";
 export declare class FilterInvalid extends Error {
     reason: string;
     hint: string;
-    constructor(reason: string, hint?: string);
+    /** (spec/surface 4.11) a literal corrected call, canonical JSON, when the surface can spell one (`data.fix`). */
+    fix: string | undefined;
+    constructor(reason: string, hint?: string, fix?: string);
 }
 export declare function parseFilter(src: string): Node;

package/dist/src/search/cel/parser.js

@@ -4,10 +4,13 @@ import { lex, LexError } from "./lexer.js";
 export class FilterInvalid extends Error {
     reason;
     hint;
-    constructor(reason, hint = "see query-language.md §3") {
+    /** (spec/surface 4.11) a literal corrected call, canonical JSON, when the surface can spell one (`data.fix`). */
+    fix;
+    constructor(reason, hint = "see query-language.md §3", fix) {
         super(reason);
         this.reason = reason;
         this.hint = hint;
+        this.fix = fix;
     }
 }
 const RELOPS = new Set(["==", "!=", "<", "<=", ">", ">="]);

package/dist/src/spec-versions.d.ts

@@ -1,14 +1,14 @@
 export declare const SPEC_VERSIONS: {
-    readonly oqx: "0.24";
+    readonly oqx: "0.25";
     readonly format: "0.2";
     readonly reconcile: "2.3";
-    readonly store: "15.0";
-    readonly properties: "1.1";
+    readonly store: "16.0";
+    readonly properties: "1.2";
     readonly graph: "1.1";
     readonly search: "2.0";
-    readonly mutate: "3.5";
+    readonly mutate: "3.6";
     readonly sync: "2.2";
-    readonly surface: "4.9";
+    readonly surface: "4.11";
     readonly cli: "4.6";
 };
 export type SpecName = keyof typeof SPEC_VERSIONS;

package/dist/src/spec-versions.js

@@ -13,13 +13,13 @@ export const SPEC_VERSIONS = {
     oqx: LANGUAGE_VERSION,
     format: "0.2",
     reconcile: "2.3",
-    store: "15.0",
-    properties: "1.1",
+    store: "16.0",
+    properties: "1.2",
     graph: "1.1",
     search: "2.0",
-    mutate: "3.5",
+    mutate: "3.6",
     sync: "2.2",
-    surface: "4.9",
+    surface: "4.11",
     cli: "4.6",
 };
 //# sourceMappingURL=spec-versions.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omgbase/core",
-  "version": "0.23.0",
+  "version": "0.27.0",
   "description": "Open Markdown Graph Base — embedded engine",
   "license": "MIT",
   "repository": {
@@ -55,7 +55,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
-    "@omgbase/oqx": "^0.24.0",
+    "@omgbase/oqx": "^0.25.0",
     "better-sqlite3": "^13.0.3",
     "mdast-util-from-markdown": "^2.0.2",
     "mdast-util-frontmatter": "^2.0.1",