@cavelang/cli 0.36.10 → 0.38.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cavelang/cli",
-  "version": "0.36.10",
+  "version": "0.38.0",
   "type": "module",
   "description": "cave — CLI for parsing, storing, querying and exporting CAVE knowledge.",
   "keywords": [
@@ -100,26 +100,26 @@
     "mdast-util-from-markdown": "2.0.3",
     "mdast-util-gfm-footnote": "2.1.0",
     "micromark-extension-gfm-footnote": "2.1.0",
-    "@cavelang/canonical": "0.36.10",
-    "@cavelang/core": "0.36.10",
-    "@cavelang/highlight": "0.36.10",
-    "@cavelang/fusion": "0.36.10",
-    "@cavelang/parser": "0.36.10",
-    "@cavelang/query": "0.36.10",
-    "@cavelang/store": "0.36.10"
+    "@cavelang/canonical": "0.38.0",
+    "@cavelang/core": "0.38.0",
+    "@cavelang/fusion": "0.38.0",
+    "@cavelang/highlight": "0.38.0",
+    "@cavelang/query": "0.38.0",
+    "@cavelang/parser": "0.38.0",
+    "@cavelang/store": "0.38.0"
   },
   "devDependencies": {
-    "@cavelang/act": "0.36.10",
-    "@cavelang/connect": "0.36.10",
-    "@cavelang/automate": "0.36.10",
-    "@cavelang/ingest": "0.36.10",
-    "@cavelang/loop": "0.36.10",
-    "@cavelang/mcp": "0.36.10",
-    "@cavelang/rules": "0.36.10",
-    "@cavelang/eval": "0.36.10",
-    "@cavelang/shape": "0.36.10",
-    "@cavelang/sync": "0.36.10",
-    "@cavelang/view": "0.36.10"
+    "@cavelang/act": "0.38.0",
+    "@cavelang/automate": "0.38.0",
+    "@cavelang/connect": "0.38.0",
+    "@cavelang/eval": "0.38.0",
+    "@cavelang/ingest": "0.38.0",
+    "@cavelang/rules": "0.38.0",
+    "@cavelang/loop": "0.38.0",
+    "@cavelang/sync": "0.38.0",
+    "@cavelang/shape": "0.38.0",
+    "@cavelang/mcp": "0.38.0",
+    "@cavelang/view": "0.38.0"
   },
   "scripts": {
     "build": "tsc -b && node scripts/consolidate.mjs",

package/src/cli.ts

@@ -119,7 +119,7 @@ Usage:
   cave highlight [file...]                 print CAVE text with ANSI syntax colors
   cave add [--db <path>] [file...]         ingest into a store [--strict] [--check] [--no-prelude] [--no-src]
   cave import [--db <path>] [file...]      restore/merge from CAVE text (add without @src: stamping)
-  cave query [--db <path>] <pattern>       run a bounded CAVE-Q page [--limit <n>] [--cursor <token>] [--json]
+  cave query [--db <path>] <pattern>       run a bounded CAVE-Q page [--limit <n>] [--cursor <token>] [--json | --jsonl]
   cave search [--db <path>] <terms..>      full-text search over claims and comments (FTS5) [--raw] [--limit <n>] [--json]
   cave resolve [--db <path>]               contested facts + winners (spec §26) [--aliases] [--policy] [--json]
   cave derive [--db <path>] [rules.cave..] declare + fire rules (spec §24) [--dry-run] [--full] [--list] [--retract <rule>]
@@ -256,11 +256,13 @@ Examples:
   query: `cave query — run a CAVE-Q pattern against a store
 
 Usage:
-  cave query [--db <path>] <pattern> [WHERE <filter>] [--limit <n>] [--cursor <token>] [--json] [--all] [--aliases] [--as-of <t>] [--at <t>] [--resolve] [--sources] [--no-prelude]
+  cave query [--db <path>] <pattern> [WHERE <filter>] [--limit <n>] [--cursor <token>] [--json | --jsonl] [--all] [--aliases] [--as-of <t>] [--at <t>] [--resolve] [--sources] [--no-prelude]
 
 Options:
   ${dbHelp}
   --json         emit a versioned cave.query-page/v1 JSON object
+  --jsonl        emit one bindings object per match; next cursor goes to stderr
+                 (exclusive with --json; no matches produce no output)
   --limit <n>    matches per page (default ${defaultQueryLimit}, maximum 1000)
   --cursor <t>   continue the same frozen query snapshot
   --all          match all beliefs, not just current ones
@@ -1016,6 +1018,7 @@ export const addCommand = ingestCommand('add')
 export const importCommand = ingestCommand('import')
 
 const queryOptions = {
+  jsonl: { type: 'boolean' },
   db: { type: 'string' },
   json: { type: 'boolean' },
   all: { type: 'boolean' },
@@ -1030,6 +1033,7 @@ const queryOptions = {
 } as const
 
 type QueryValues = {
+  jsonl?: boolean
   db?: string
   json?: boolean
   all?: boolean
@@ -1048,6 +1052,9 @@ const parseQuery = (argv: readonly string[]): { values: QueryValues, pattern: st
   if (positionals.length === 0) {
     return { failure: fail('cave query: a pattern is required (spec §12.1)\n') }
   }
+  if (values.json === true && values.jsonl === true) {
+    return { failure: fail('cave query: --json and --jsonl are mutually exclusive\n') }
+  }
   if (values.sources === true && values.cursor !== undefined) {
     return { failure: fail('cave query: --cursor does not apply to --sources — the overlay exists for one invocation and is answered whole\n') }
   }
@@ -1151,6 +1158,13 @@ const renderQueryPage = (
 ): Output => {
   {
     const result = page()
+    if (values.jsonl === true) {
+      return {
+        code: 0,
+        out: result.matches.map(match => `${JSON.stringify(match.bindings)}\n`).join(''),
+        err: result.next === undefined ? '' : `next: ${result.next}\n`
+      }
+    }
     if (values.json === true) {
       return ok(`${JSON.stringify(result, undefined, 2)}\n`)
     }

package/src/commands.ts

@@ -18,7 +18,7 @@ export const commandRegistry = [
   { name: 'highlight', importantOptions: [] },
   { name: 'add', importantOptions: ['--strict', '--check', '--no-prelude', '--no-src'] },
   { name: 'import', importantOptions: ['--strict', '--no-prelude'] },
-  { name: 'query', importantOptions: ['--json', '--limit', '--cursor', '--all', '--aliases', '--as-of', '--at', '--resolve', '--sources', '--no-prelude'] },
+  { name: 'query', importantOptions: ['--json', '--jsonl', '--limit', '--cursor', '--all', '--aliases', '--as-of', '--at', '--resolve', '--sources', '--no-prelude'] },
   { name: 'search', importantOptions: ['--raw', '--limit', '--json', '--no-prelude'] },
   { name: 'resolve', importantOptions: ['--aliases', '--policy', '--json', '--no-prelude'] },
   { name: 'derive', importantOptions: ['--dry-run', '--full', '--aliases', '--min-conf', '--max-passes', '--list', '--retract', '--json', '--no-prelude'] },

package/src/main.ts

@@ -1,6 +1,19 @@
 #!/usr/bin/env node
 /** `cave` binary entry point — one lifecycle for every command. */
 
-import { runCli } from './dispatch.ts'
+// Keep runtime warnings out of normal CLI output; debug mode retains Node's
+// warning diagnostics. Install before loading SQLite and delegated commands.
+if (process.env['CAVE_DEBUG'] !== '1') {
+  // Node exposes its default printer as an ordinary listener. Its name alone
+  // is ambiguous: preload scripts can register their own `onWarning`. Match
+  // the printer's internal formatting call too, and preserve every subscriber
+  // if Node changes this implementation (covered on each supported runtime).
+  const printer = process.listeners('warning').find(listener =>
+    listener.name === 'onWarning' &&
+    Function.prototype.toString.call(listener).includes('ErrorPrototypeToString(warning)'))
+  if (printer !== undefined) process.removeListener('warning', printer)
+}
+
+const { runCli } = await import('./dispatch.ts')
 
 process.exitCode = await runCli(process.argv.slice(2))