@geml/geml 1.7.3 → 1.7.4

package/dist/cli.js

@@ -147,7 +147,8 @@ Usage:
                                              (call this first — its addresses are what every verb below takes)
   geml find   <pattern> [<file|dir> …] [--json] [--case] [--head]   search block content -> file#address
                                              (an address, not a line number, so a hit pastes into get/set;
-                                              a dir is walked for *.geml; exit 1 when nothing matched)
+                                              a named file is searched whatever its extension, a dir walks
+                                              *.geml only; exit 1 when nothing matched)
   geml get    <file.geml|-> [#id] [--json] [--head|--intro|--body]   with #id: print that block
                                              (a heading id = its whole section; --head = head line;
                                              --json = model node). Without #id: list all addressable
@@ -201,7 +202,7 @@ const SUBHELP = {
     delete: "usage: geml delete <file.geml|-> #id [#id2 …] [-o out.geml]  (remove one or more blocks; a missing id is skipped with a note, not an error; a reference left dangling is a warning, not a refusal — delete never fails on a live reference)",
     rename: "usage: geml rename <file.geml|-> #old #new [-o out.geml]  (rewrite an id's declaration AND every reference — [[#id]], [text](#id), chart data=#id, footnote [^id] — id-boundary safe, skipping raw block bodies; #new must be free; refused if it breaks the doc)",
     list: "usage: geml list <file.geml|-> [--json]  (list every addressable block with its shortest unique address, its kind and its line range — the same listing `geml get <file>` prints with no selector, under the name the MCP surface already uses. Call it FIRST: the addresses it prints are what get/set/add/delete/rename/revert all take)",
-    find: "usage: geml find <pattern> [<file.geml|dir> …] [--json] [--case] [--head]  (search block CONTENT and print `<file>TAB<address>` per hit — an address, never a line number, so a hit is `geml get <file> '<address>'` with no editing. The address is the INNERMOST block holding the match, never its enclosing section, and a block is reported once however many lines in it matched. Substring, case-insensitive unless --case; a directory is walked for *.geml; no path = the current directory; --head adds the matching line as a third column. Exit 1 when nothing matched, so `if geml find …` works in a script)",
+    find: "usage: geml find <pattern> [<file|dir> …] [--json] [--case] [--head]  (search block CONTENT and print `<file>TAB<address>` per hit — an address, never a line number, so a hit is `geml get <file> '<address>'` with no editing. The address is the INNERMOST block holding the match, never its enclosing section, and a block is reported once however many lines in it matched. Substring, case-insensitive unless --case; a file you NAME is searched whatever its extension, including Markdown, while a directory is walked for *.geml only; no path = the current directory; --head adds the matching line as a third column. Exit 1 when nothing matched, so `if geml find …` works in a script)",
     replace: "usage: geml replace <file.geml|-> <old> <new> [--within <selector>] [-o out.geml]  (EXPERIMENTAL — this verb MAY BE WITHDRAWN in a later release; it is here to find out whether an addressed, checked replacement earns its place beside `sed`, and if it does not, it goes. Build nothing on it you cannot change, and say so in a discussion if it is doing real work for you. Swaps a LITERAL string — never a pattern, that is what `sed` is for and where the footguns are. Without --within the whole document; with it, only inside the blocks that selector matches, and unlike `set` it may match several: `--within '=== table'` means every table. What this buys over `sed -i`, at the same cost of two short strings and nothing read: the result is re-parsed and refused if it would break the document, the blocks it touched are NAMED on stderr, and the write lands in .gemlhistory where `revert` can undo it. An id is not text — a replacement that would rename one is refused and points at `geml rename`, which fixes every reference too. Exit 1 when nothing matched, so `if geml replace …` works in a script)",
     check: "usage: geml check <file.geml|-> [--root <dir>] [--json]  (--root: resolve cross-doc refs within <dir> instead of the file's own directory)",
     revert: "usage: geml revert <file.geml> #id [--rev <sel>] [--append|--before #x|--after #x] [--head] [--dry-run] [-o out]  (reconcile #id to a revision: splice / resurrect / remove; sel: 0 | -N | id-prefix | changed; default -1)",
@@ -1100,7 +1101,14 @@ function runList(args) {
 // platforms — a listing that reorders between machines is a listing nobody can
 // diff. Hidden directories and `node_modules` are skipped: a search verb that
 // dredges up vendored copies trains people to stop reading its output.
-function gemlFilesUnder(path, out) {
+// `explicit` marks a path the caller NAMED, as opposed to one this walk found.
+// A named file is searched whatever it is called: `get` and `list` already read
+// a `.md` this way, and having only `find` refuse meant
+// `geml find GEML README.md` exited 1 against a file holding forty-four
+// matches — a search that answers "no" about a file you pointed straight at.
+// The `.geml` filter belongs to the DIRECTORY walk, where taking every file
+// would drag the whole source tree through the parser.
+function gemlFilesUnder(path, out, explicit = false) {
     let dir = false;
     try {
         dir = statSync(path).isDirectory();
@@ -1109,7 +1117,7 @@ function gemlFilesUnder(path, out) {
         return;
     }
     if (!dir) {
-        if (path.endsWith(".geml"))
+        if (explicit || path.endsWith(".geml"))
             out.push(path);
         return;
     }
@@ -1136,8 +1144,9 @@ function runFind(args) {
     const json = args.includes("--json");
     const needle = sensitive ? pattern : pattern.toLowerCase();
     const files = [];
-    for (const p of pos.slice(1).length ? pos.slice(1) : ["."])
-        gemlFilesUnder(p, files);
+    const named = pos.slice(1);
+    for (const p of named.length ? named : ["."])
+        gemlFilesUnder(p, files, named.length > 0);
     const hits = [];
     for (const f of files) {
         let source;

package/dist/mcp.js

@@ -275,7 +275,7 @@ export const TOOLS = [
     },
     {
         name: "geml_find",
-        description: "Search block CONTENT across the served documents and get back ADDRESSES, one row of `<file>\\t<address>` per hit. This is the other half of geml_list: `list` says what a document contains, `find` says which block holds the words you are looking for — and it answers with an address that pastes straight into geml_get or geml_set, never a line number that the next edit invalidates. The address is the innermost block holding the match, and a block that matches on many lines is reported once. Substring, case-insensitive unless `case` is true. Omit `path` to search every `*.geml` under the server root, or give a file or directory to narrow it. No match is not an error: the result is empty.",
+        description: "Search block CONTENT across the served documents and get back ADDRESSES, one row of `<file>\\t<address>` per hit. This is the other half of geml_list: `list` says what a document contains, `find` says which block holds the words you are looking for — and it answers with an address that pastes straight into geml_get or geml_set, never a line number that the next edit invalidates. The address is the innermost block holding the match, and a block that matches on many lines is reported once. Substring, case-insensitive unless `case` is true. Omit `path` to search every `*.geml` under the server root, or give a file or directory to narrow it — a file you name is searched whatever its extension, Markdown included, while a directory walks `*.geml` only. No match is not an error: the result is empty.",
         inputSchema: {
             type: "object",
             properties: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geml/geml",
-  "version": "1.7.3",
+  "version": "1.7.4",
   "mcpName": "io.github.geml-spec/geml",
   "publishConfig": {
     "access": "public"

package/skill/SKILL.md

@@ -58,7 +58,9 @@ already; none is ever created for you. `--dry-run` shows what it would do.
 
 ```sh
 geml list    file.geml                # CALL THIS FIRST — every block, its address, kind, lines
-geml find    "text" file.geml|dir     # search block CONTENT -> file<TAB>address (exit 1 = no hit)
+geml find    "text" file|dir          # search block CONTENT -> file<TAB>address (exit 1 = no hit)
+                                      # a NAMED file is searched whatever its extension (.md too);
+                                      # a directory walks *.geml only
 geml get     file.geml '#id'          # read ONE block (a heading id = its whole section)
 geml set     file.geml '#id' --in f   # replace ONE block (re-parsed; never writes a broken doc)
 geml replace file.geml OLD NEW        # EXPERIMENTAL literal swap; --within '#id' to narrow

package/skill/references/authoring.geml

@@ -215,7 +215,10 @@ All commands accept `-` to read from stdin.
 === code {#cli-verbs lang=sh}
 geml file.geml                        # document-model JSON (default --to json)
 geml list    file.geml                # CALL FIRST: every block, its address, kind, line range
-geml find    "text" file.geml|dir     # search block CONTENT -> file<TAB>address; exit 1 = no hit
+geml find    "text" file|dir          # search block CONTENT -> file<TAB>address; exit 1 = no hit
+                                      # a NAMED file is searched whatever its extension — `list`,
+                                      # `get` and `find` all read Markdown, so this addresses a
+                                      # plain README without converting it; a DIRECTORY walks *.geml
 geml get     file.geml                # same listing as `list` (the no-selector default)
 geml get     file.geml '#id'          # print ONE block (raw span; --json = model node)
 geml get     file.geml '=== note'     # every block of a type; '@a3f9c1d2' = a block with no #id