@cavelang/cli 0.27.14 → 0.29.0

package/dist/internal/connect/main.js

@@ -0,0 +1,330 @@
+/**
+ * `cave connect` entry — argument parsing, pass orchestration (single,
+ * `--watch`, `--query`), and report rendering around `run.ts`.
+ */
+import { existsSync, readFileSync, watch as watchFs } from 'node:fs';
+import { basename, dirname, resolve } from 'node:path';
+import { parseArgs } from 'node:util';
+import { Registry } from '@cavelang/canonical';
+import { defaultDbPath, open } from '@cavelang/store';
+import { Record as QueryRecord } from '@cavelang/query';
+import * as Source from "./source.js";
+import * as Template from "./template.js";
+import { connect, federatedQuery } from "./run.js";
+const usage = `cave connect — deterministic structured ingestion through a mapping template (spec §23)
+
+Usage:
+  cave connect [--db <path>] <source> --map <file> [options]
+
+The source is a .csv/.tsv/.json/.jsonl/.ndjson file, a SQLite database
+(with --table or --sql), or an http(s) URL serving JSON or CSV. The
+mapping is an ordinary CAVE document whose ?field variables stand for
+record fields; variable-free blocks append once per run, variable blocks
+instantiate once per record — no LLM in the loop, same input, same claims.
+Mapped claims retain the physical source; CSV/TSV and JSONL records also carry
+their exact one-based inclusive line span (spec §9.8).
+
+Options:
+  --db <path>          knowledge database (default: $CAVE_DB, or cave.db)
+  --map <file>         mapping template (required)
+  --name <name>        source name for record identity (default: file basename)
+  --key <field>        record key field — keyed records diff against their
+                       previous claims on change; unkeyed records are
+                       content-addressed
+  --format <fmt>       csv | tsv | json | jsonl | sqlite (default: by extension)
+  --delimiter <char>   CSV field delimiter (default , — tab for .tsv)
+  --table <name>       SQLite table to read (SELECT *)
+  --sql <query>        SQLite query (alternative to --table)
+  --records <path>     dot path to the record array inside a JSON document
+  --force              re-map records whose digest is unchanged
+  --prune              retract claims of records that disappeared from the source
+  --dry-run            print the instantiated claims, write nothing
+  --watch              keep running; re-map when the source or mapping changes
+  --query <pattern>    federation-lite (spec §23.3): map, query the union,
+                       roll back — nothing persists; uses an in-memory store
+                       when the database file does not exist
+  --json               with --query: emit matches as JSON
+  --all                with --query: match all beliefs, not just current ones
+  --aliases            with --query: resolve entities through ALIAS claims
+  --no-prelude         open the store without the standard §5.5 registry
+
+Examples:
+  cave connect people.csv --map people.map.cave --db k.db --key id
+  cave connect crm.sqlite --table contacts --map contacts.map.cave --key email
+  cave connect https://api.example.com/deps.json --records data.items --map deps.map.cave
+  cave connect events.jsonl --map events.map.cave --watch
+  cave connect people.csv --map people.map.cave --query '?who WORKS-AT acme'`;
+const waitForAbort = (signal) => signal?.aborted === true ? Promise.resolve() : new Promise(resolve => signal?.addEventListener('abort', () => resolve(), { once: true }));
+const renderReport = (report) => {
+    const lines = [
+        `connect: ${report.records} record(s): ${report.mapped} mapped, ${report.skipped} skipped (unchanged)` +
+            `${report.failures.length > 0 ? `, ${report.failures.length} failed` : ''}` +
+            `; +${report.added} claim(s)` +
+            `${report.retracted > 0 ? `, ${report.retracted} retracted` : ''}` +
+            `${report.pruned > 0 ? `, ${report.pruned} record(s) pruned` : ''}` +
+            `${report.dropped > 0 ? `, ${report.dropped} line(s) dropped` : ''}`
+    ];
+    for (const note of report.notes) {
+        lines.push(`  note: ${note}`);
+    }
+    for (const failure of report.failures) {
+        lines.push(`  ${failure.record}: FAILED`);
+        lines.push(...failure.problems.map(problem => `    ${problem}`));
+    }
+    return lines.join('\n');
+};
+const loadMapping = (path) => Template.parse(readFileSync(path, 'utf8'));
+const sourceOptions = (values, context) => ({
+    ...values.format === undefined ? {} : { format: values.format },
+    ...values.delimiter === undefined ? {} : { delimiter: values.delimiter },
+    ...values.table === undefined ? {} : { table: values.table },
+    ...values.sql === undefined ? {} : { sql: values.sql },
+    ...values.records === undefined ? {} : { records: values.records },
+    ...context.fetchImpl === undefined ? {} : { fetchImpl: context.fetchImpl }
+});
+const loadSource = async (source, values, context) => {
+    try {
+        return await Source.load(source, sourceOptions(values, context));
+    }
+    catch (error) {
+        throw new Error(`load ${source}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+};
+const runPass = async (store, source, values, name, io, context) => {
+    const { mapping, problems } = loadMapping(values.map);
+    if (mapping === undefined) {
+        io.stderr.write(`${problems.join('\n')}\n`);
+        return 1;
+    }
+    const loaded = await loadSource(source, values, context);
+    const report = connect(store, mapping, loaded.records, {
+        name,
+        source,
+        ...loaded.spans === undefined ? {} : { spans: loaded.spans },
+        ...values.key === undefined ? {} : { key: values.key },
+        force: values.force === true,
+        prune: values.prune === true
+    });
+    io.stdout.write(`${renderReport(report)}\n`);
+    return report.failures.length > 0 ? 1 : 0;
+};
+const runDry = async (source, values, io, context) => {
+    const { mapping, problems } = loadMapping(values.map);
+    if (mapping === undefined) {
+        io.stderr.write(`${problems.join('\n')}\n`);
+        return 1;
+    }
+    const loaded = await loadSource(source, values, context);
+    const out = [];
+    if (mapping.prelude !== '') {
+        out.push('; --- prelude', mapping.prelude.trimEnd());
+    }
+    let failures = 0;
+    loaded.records.forEach((record, at) => {
+        const instantiation = Template.instantiate(mapping.templates, name => Template.fieldOf(record, name));
+        out.push(`; --- record ${at + 1}`);
+        if (instantiation.problems.length > 0) {
+            failures += 1;
+            out.push(...instantiation.problems.map(problem => `; FAILED — ${problem}`));
+            return;
+        }
+        out.push(instantiation.text.trimEnd());
+    });
+    io.stdout.write(`${out.join('\n')}\n`);
+    return failures > 0 ? 1 : 0;
+};
+const runQuery = async (source, values, name, io, context) => {
+    const { mapping, problems } = loadMapping(values.map);
+    if (mapping === undefined) {
+        io.stderr.write(`${problems.join('\n')}\n`);
+        return 1;
+    }
+    const loaded = await loadSource(source, values, context);
+    const db = values.db ?? defaultDbPath();
+    const registry = values['no-prelude'] === true ? { registry: Registry.empty } : {};
+    const store = existsSync(db) ? open(db, registry) : open(':memory:', registry);
+    try {
+        const { matches, report } = federatedQuery(store, mapping, loaded.records, {
+            name,
+            source,
+            ...loaded.spans === undefined ? {} : { spans: loaded.spans },
+            ...values.key === undefined ? {} : { key: values.key }
+        }, values.query, { all: values.all === true, aliases: values.aliases === true });
+        // A failed record means the union was incomplete — matches still print
+        // as partial results, but the exit code must not read as success.
+        const code = report.failures.length > 0 ? 1 : 0;
+        if (code !== 0) {
+            io.stderr.write(`${renderReport(report)}\n`);
+        }
+        if (values.json === true) {
+            io.stdout.write(`${JSON.stringify(matches.map(match => QueryRecord.of(store, match)), undefined, 2)}\n`);
+            return code;
+        }
+        if (matches.length === 0) {
+            io.stdout.write('no matches\n');
+            return code;
+        }
+        const lines = matches.map(match => {
+            const bindings = Object.entries(match.bindings)
+                .map(([variable, value]) => `?${variable} = ${value}`)
+                .join('  ');
+            return bindings !== '' ? bindings : match.row?.raw_line ?? values.query;
+        });
+        io.stdout.write(`${lines.join('\n')}\n`);
+        return code;
+    }
+    finally {
+        store.close();
+    }
+};
+const runWatch = async (store, source, values, name, io, context) => {
+    const passOnce = async () => {
+        try {
+            await runPass(store, source, values, name, io, context);
+        }
+        catch (error) {
+            io.stderr.write(`cave connect watch pass: ${error instanceof Error ? error.message : String(error)}\n`);
+        }
+    };
+    let running = false;
+    let queued = false;
+    let timer;
+    let active;
+    const fire = async () => {
+        if (running) {
+            queued = true;
+            return;
+        }
+        running = true;
+        do {
+            queued = false;
+            await passOnce();
+        } while (queued);
+        running = false;
+    };
+    const schedule = context.schedule ?? ((callback, delayMs) => setTimeout(() => { void callback(); }, delayMs));
+    const cancelScheduled = context.cancelScheduled ?? (handle => clearTimeout(handle));
+    const trigger = () => {
+        if (running) {
+            queued = true;
+            return;
+        }
+        if (timer !== undefined)
+            cancelScheduled(timer);
+        timer = schedule(async () => {
+            timer = undefined;
+            const pass = fire();
+            active = pass;
+            await pass;
+            if (active === pass)
+                active = undefined;
+        }, 200);
+    };
+    // Watch the parent directories — editors replace files on save, and a
+    // watcher on the file itself dies with the old inode.
+    const targets = [...new Set([resolve(source), resolve(values.map)])];
+    const watch = context.watch ?? ((path, listener) => watchFs(path, listener));
+    const watchers = targets.map(target => watch(dirname(target), (_event, filename) => {
+        // Some platforms and watcher backends cannot identify the changed
+        // directory entry. A filename-less event is therefore a rescan signal,
+        // while Buffer filenames retain the same exact target filtering.
+        if (filename === null || filename.toString() === basename(target)) {
+            trigger();
+        }
+    }));
+    try {
+        // Install watchers before the initial pass. A save during startup is
+        // therefore either read by this pass or queued for the next one.
+        await passOnce();
+        io.stdout.write('watching (ctrl-c to stop)\n');
+        await waitForAbort(io.signal);
+        return 0;
+    }
+    finally {
+        if (timer !== undefined)
+            cancelScheduled(timer);
+        watchers.forEach(watcher => watcher.close());
+        await active;
+    }
+};
+export const runConnect = async (argv, context = {}) => {
+    const io = {
+        stdout: context.stdout ?? process.stdout,
+        stderr: context.stderr ?? process.stderr,
+        ...context.signal === undefined ? {} : { signal: context.signal }
+    };
+    const { values, positionals } = parseArgs({
+        args: [...argv],
+        options: {
+            db: { type: 'string' },
+            map: { type: 'string' },
+            name: { type: 'string' },
+            key: { type: 'string' },
+            format: { type: 'string' },
+            delimiter: { type: 'string' },
+            table: { type: 'string' },
+            sql: { type: 'string' },
+            records: { type: 'string' },
+            force: { type: 'boolean' },
+            prune: { type: 'boolean' },
+            'dry-run': { type: 'boolean' },
+            watch: { type: 'boolean' },
+            query: { type: 'string' },
+            json: { type: 'boolean' },
+            all: { type: 'boolean' },
+            aliases: { type: 'boolean' },
+            'no-prelude': { type: 'boolean' },
+            help: { type: 'boolean', short: 'h' }
+        },
+        allowPositionals: true
+    });
+    if (values.help === true) {
+        io.stdout.write(`${usage}\n`);
+        return 0;
+    }
+    const [source] = positionals;
+    if (source === undefined || positionals.length !== 1) {
+        io.stderr.write(`cave connect: exactly one source is required\n\n${usage}\n`);
+        return 1;
+    }
+    if (values.map === undefined) {
+        io.stderr.write(`cave connect: --map <file> is required\n\n${usage}\n`);
+        return 1;
+    }
+    if (values.format !== undefined && !['csv', 'tsv', 'json', 'jsonl', 'sqlite'].includes(values.format)) {
+        io.stderr.write(`cave connect: unknown format ${JSON.stringify(values.format)}\n`);
+        return 1;
+    }
+    if (values.delimiter !== undefined && values.delimiter.length !== 1) {
+        io.stderr.write('cave connect: --delimiter must be a single character\n');
+        return 1;
+    }
+    if (values.watch === true && (values.query !== undefined || values['dry-run'] === true || Source.isUrl(source))) {
+        io.stderr.write('cave connect: --watch takes a local file source and excludes --query/--dry-run\n');
+        return 1;
+    }
+    const name = values.name ?? Source.nameOf(source);
+    try {
+        if (values['dry-run'] === true) {
+            return await runDry(source, values, io, context);
+        }
+        if (values.query !== undefined) {
+            return await runQuery(source, values, name, io, context);
+        }
+        const store = open(values.db ?? defaultDbPath(), values['no-prelude'] === true ? { registry: Registry.empty } : {});
+        try {
+            if (values.watch === true) {
+                return await runWatch(store, source, values, name, io, context);
+            }
+            return await runPass(store, source, values, name, io, context);
+        }
+        finally {
+            store.close();
+        }
+    }
+    catch (error) {
+        io.stderr.write(`cave connect: ${error instanceof Error ? error.message : String(error)}\n`);
+        return 1;
+    }
+};
+//# sourceMappingURL=main.js.map

package/dist/internal/connect/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/main.ts"],"names":[],"mappings":"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"}

package/dist/internal/connect/run.d.ts

@@ -0,0 +1,85 @@
+/**
+ * The connect pass (spec §23.2) — instantiate the mapping per record, append
+ * through the standard pipeline with record provenance, and keep re-runs
+ * row-level incremental via per-record digest claims:
+ *
+ * ```cave
+ * connect/people/42 HAS connect-digest: 93a01c626b3f @src:cave-connect
+ * ```
+ *
+ * Every claim a record produces is auto-stamped `@src:connect/<name>/<key>`
+ * (spec §9.5), so a changed record diffs against itself: current claims
+ * still carrying the record's stamp but no longer produced by it are
+ * retracted (`@ 0%`). `--prune` extends the diff to records that vanished
+ * from the source. Explicit `run` provenance is the lifecycle identity;
+ * the compatibility stamp is also applied when a template names its own
+ * `@src:` context (both are kept).
+ */
+import type { LineSpan } from '@cavelang/core';
+import type { Store } from '@cavelang/store';
+import type { Match, Options as QueryOptions } from '@cavelang/query';
+import * as Template from './template.ts';
+export declare const digestAttribute = "connect-digest";
+export declare const provenanceContext = "src:cave-connect";
+/** First 12 hex chars of SHA-256, mirroring `@cavelang/cli/ingest` (spec §9.5). */
+export declare const digestOf: (content: string) => string;
+/** @returns `true` when the unit's current digest claim matches `digest`. */
+export declare const isConnected: (store: Store, subject: string, digest: string) => boolean;
+export type ConnectOptions = {
+    /** Source name for record identity (spec §23.2): `connect/<name>/<key>`. */
+    readonly name: string;
+    /** Record key field; unkeyed records are content-addressed by digest. */
+    readonly key?: string;
+    /** Underlying file/URL identity attached to generated record claims. */
+    readonly source?: string;
+    /** Record-aligned source line spans, when the source format provides them. */
+    readonly spans?: readonly LineSpan[];
+    /** Re-map records whose digest is unchanged. */
+    readonly force?: boolean;
+    /** Retract claims of records that disappeared from the source. */
+    readonly prune?: boolean;
+};
+export type Failure = {
+    /** Record position (1-based) or key, whichever identifies it better. */
+    readonly record: string;
+    readonly problems: readonly string[];
+};
+export type Report = {
+    /** Records in the source. */
+    readonly records: number;
+    /** Records whose claims were (re-)appended. */
+    readonly mapped: number;
+    /** Records skipped — digest unchanged (spec §23.2). */
+    readonly skipped: number;
+    /** Claims appended (record claims + prelude, excluding digest bookkeeping). */
+    readonly added: number;
+    /** Claims retracted because a changed record no longer yields them. */
+    readonly retracted: number;
+    /** Records retracted by `--prune`. */
+    readonly pruned: number;
+    /** Claim lines dropped over missing/empty fields. */
+    readonly dropped: number;
+    readonly failures: readonly Failure[];
+    /** Run-level notes (duplicate keys, prelude state). */
+    readonly notes: readonly string[];
+};
+/**
+ * One connect pass: prelude (digest-skipped as a unit under
+ * `connect/<name>`), then each record (digest-skipped under
+ * `connect/<name>/<key>`), then optional pruning. Each unit appends inside
+ * its own transaction — a failing record rolls back cleanly and never
+ * poisons the rest of the run.
+ */
+export declare const connect: (store: Store, mapping: Template.Mapping, records: readonly Record<string, unknown>[], options: ConnectOptions) => Report;
+export type FederatedOutcome = {
+    readonly matches: readonly Match[];
+    readonly report: Report;
+};
+/**
+ * Federation-lite (spec §23.3): appends the mapped claims inside a
+ * transaction, runs the CAVE-Q pattern over the union of store and source,
+ * and rolls back — external data is consulted at query time, nothing
+ * persists (digest bookkeeping included).
+ */
+export declare const federatedQuery: (store: Store, mapping: Template.Mapping, records: readonly Record<string, unknown>[], options: ConnectOptions, pattern: string, queryOptions?: QueryOptions) => FederatedOutcome;
+//# sourceMappingURL=run.d.ts.map

package/dist/internal/connect/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,KAAK,EAAO,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAEjD,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACrE,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AAEzC,eAAO,MAAM,eAAe,mBAAmB,CAAA;AAE/C,eAAO,MAAM,iBAAiB,qBAAqB,CAAA;AAEnD,+EAA+E;AAC/E,eAAO,MAAM,QAAQ,GAAI,SAAS,MAAM,KAAG,MACsB,CAAA;AAcjE,6EAA6E;AAC7E,eAAO,MAAM,WAAW,GAAI,OAAO,KAAK,EAAE,SAAS,MAAM,EAAE,QAAQ,MAAM,KAAG,OAG3E,CAAA;AAMD,MAAM,MAAM,cAAc,GAAG;IAC3B,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,yEAAyE;IACzE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,wEAAwE;IACxE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAA;IACpC,gDAAgD;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;IACxB,kEAAkE;IAClE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CACzB,CAAA;AAED,MAAM,MAAM,OAAO,GAAG;IACpB,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CACrC,CAAA;AAED,MAAM,MAAM,MAAM,GAAG;IACnB,6BAA6B;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,+CAA+C;IAC/C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,uEAAuE;IACvE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,sCAAsC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAA;IACrC,uDAAuD;IACvD,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAClC,CAAA;AAgED;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,GAClB,OAAO,KAAK,EACZ,SAAS,QAAQ,CAAC,OAAO,EACzB,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC3C,SAAS,cAAc,KACtB,MAsHF,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,KAAK,EAAE,CAAA;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB,CAAA;AAID;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,KAAK,EACZ,SAAS,QAAQ,CAAC,OAAO,EACzB,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC3C,SAAS,cAAc,EACvB,SAAS,MAAM,EACf,eAAc,YAAiB,KAC9B,gBAcF,CAAA"}