@cavelang/cli 0.34.0 → 0.36.0

package/dist/internal/view/scope.js

@@ -1,7 +1,8 @@
 /** Reusable read-only sensitivity projections for data-leaving views. */
-import { Uuidv7 } from '@cavelang/core';
-import { Sensitivity } from '@cavelang/store';
+import { Key, Uuidv7 } from '@cavelang/core';
+import { Row, Sensitivity } from '@cavelang/store';
 import { openWith } from '@cavelang/store/adapter';
+import { errorMessage } from "./error-message.js";
 const caches = new WeakMap();
 const emptyStats = {
     projections: 0,
@@ -16,7 +17,7 @@ const emptyStats = {
 export const scopedStoreCacheStats = (source) => {
     const cache = caches.get(source);
     if (cache === undefined)
-        return emptyStats;
+        return { ...emptyStats };
     const projections = [...cache.projections.values()];
     return {
         projections: projections.length,
@@ -34,10 +35,23 @@ export const clearScopedStoreCache = (source) => {
     const cache = caches.get(source);
     if (cache === undefined)
         return;
-    for (const projection of cache.projections.values())
-        projection.store.close();
-    cache.projections.clear();
+    cache.unsubscribe();
     caches.delete(source);
+    const projections = [...cache.projections.values()];
+    cache.projections.clear();
+    const errors = [];
+    for (const projection of projections) {
+        try {
+            projection.store.close();
+        }
+        catch (error) {
+            errors.push(error);
+        }
+    }
+    if (errors.length === 1)
+        throw errors[0];
+    if (errors.length > 1)
+        throw new AggregateError(errors, `CAVE view: projection cleanup failed: ${errors.map(errorMessage).join('; ')}`);
 };
 /**
  * SQLite's data_version changes after commits from other connections, while
@@ -67,12 +81,36 @@ const buildProjection = (source, maximum, revision) => Uuidv7.withStatePreserved
             const child = index.get(edge.child_id);
             return parent === undefined || child === undefined ? [] : [{ parent, role: edge.role, child }];
         });
+        const contextsQuery = source.db.prepare('SELECT context FROM cave_context WHERE claim_id = ?');
+        const tagsQuery = source.db.prepare('SELECT key, value FROM cave_tag WHERE claim_id = ?');
         target.insertResult({
-            claims: rows.map(row => ({ claim: source.toClaim(row), line: 0 })),
+            claims: rows.map(row => {
+                if (typeof row.id !== 'string' || !Uuidv7.is(row.id) || row.tx !== row.id) {
+                    throw new Error(`CAVE view projection failed for claim ${row.id}: stored transaction identity must be a canonical lowercase UUIDv7 with id = tx`);
+                }
+                const contexts = contextsQuery.all(row.id).map(entry => entry.context);
+                const tags = tagsQuery.all(row.id);
+                const claim = Row.toClaim(row, contexts, tags);
+                if (Key.of(claim) !== row.claim_key) {
+                    throw new Error(`CAVE view projection failed for claim ${row.id}: stored claim key does not agree with its semantic identity`);
+                }
+                return { claim, line: 0 };
+            }),
             edges,
             registry: source.baseRegistry(),
             problems: []
         }, { ids: rows.map(row => row.id) });
+        // insertResult infers compatibility attribution from contexts. A scoped
+        // copy must retain the source's explicit dimensions, including no entries.
+        target.db.exec('DELETE FROM cave_provenance');
+        const provenance = source.db.prepare(`
+        SELECT p.claim_id, p.dimension, p.value FROM cave_provenance p
+        JOIN cave_claim c ON c.id = p.claim_id
+        WHERE ${Sensitivity.sql('c', maximum)}
+      `).all();
+        const insertProvenance = target.db.prepare('INSERT INTO cave_provenance (claim_id, dimension, value) VALUES (?, ?, ?)');
+        for (const entry of provenance)
+            insertProvenance.run(entry.claim_id, entry.dimension, entry.value);
         target.reloadRegistry();
         // Cached projections are shared across callbacks. Make their database
         // representation immutable so an accidental write cannot taint later reads.
@@ -80,14 +118,14 @@ const buildProjection = (source, maximum, revision) => Uuidv7.withStatePreserved
         return { revision, store: target, claims: rows.length, edges: edges.length, bytes: sizeOf(target) };
     }
     catch (error) {
-        target.close();
-        throw error;
+        return withReadCleanup(() => { throw error; }, () => target.close(), 'CAVE view projection construction failed and close also failed');
     }
 });
 const projectionOf = (source, maximum) => {
     let cache = caches.get(source);
     if (cache === undefined) {
-        cache = { projections: new Map(), hits: 0, builds: 0, invalidations: 0, retries: 0 };
+        cache = { unsubscribe: source.onClose(() => clearScopedStoreCache(source)),
+            projections: new Map(), hits: 0, builds: 0, invalidations: 0, retries: 0 };
         caches.set(source, cache);
     }
     // An external writer can commit while a projection is being copied. Retry
@@ -100,26 +138,71 @@ const projectionOf = (source, maximum) => {
             return existing.store;
         }
         const candidate = buildProjection(source, maximum, before);
-        if (revisionOf(source) !== before) {
-            candidate.store.close();
-            cache.retries += 1;
-            continue;
-        }
-        cache.builds += 1;
-        if (existing !== undefined)
-            cache.invalidations += 1;
-        cache.projections.set(maximum, candidate);
-        existing?.store.close();
-        return candidate.store;
+        let published = false;
+        const ready = withReadCleanup(() => {
+            if (revisionOf(source) !== before) {
+                cache.retries += 1;
+                return undefined;
+            }
+            cache.builds += 1;
+            if (existing !== undefined)
+                cache.invalidations += 1;
+            cache.projections.set(maximum, candidate);
+            published = true;
+            existing?.store.close();
+            return candidate.store;
+        }, () => { if (!published)
+            candidate.store.close(); }, 'CAVE view projection publication failed and close also failed');
+        if (ready !== undefined)
+            return ready;
     }
     throw new Error('CAVE view: source changed continuously while building a sensitivity projection');
 };
+/** Preserve the primary failure when releasing an owned read resource also fails. */
+const withReadCleanup = (body, cleanup, message) => {
+    let result;
+    try {
+        result = body();
+    }
+    catch (error) {
+        try {
+            cleanup();
+        }
+        catch (cleanupError) {
+            throw new AggregateError([error, cleanupError], `${message}: ${errorMessage(error)}; ${errorMessage(cleanupError)}`, { cause: error });
+        }
+        throw error;
+    }
+    cleanup();
+    return result;
+};
+/** A synchronous read snapshot that can nest inside a caller-owned transaction. */
+export const readSnapshot = (source, body) => {
+    source.db.exec('SAVEPOINT cave_view_read');
+    return withReadCleanup(body, () => source.db.exec('RELEASE cave_view_read'), 'CAVE view snapshot failed and release also failed');
+};
 /**
  * Runs `body` against rows at or below `maximum`. Restricted includes every
- * row and uses the source directly. Narrower audiences share an immutable,
+ * row and uses the source directly within a read snapshot. Narrower audiences share an immutable,
  * indexed projection keyed by policy and source revision; appends invalidate
- * it before the next read. Hidden rows and edges never enter that projection,
+ * it before the next read. Inside transactions, or without adapter transaction
+ * inspection, a disposable projection lives only for the synchronous callback.
+ * Hidden rows and edges never enter that projection,
  * preserving the fail-closed boundary for every downstream query.
  */
-export const withScopedStore = (source, maximum, body) => maximum === 'restricted' ? body(source) : body(projectionOf(source, maximum));
+export const withScopedStore = (source, maximum, body) => {
+    if (maximum === 'restricted')
+        return readSnapshot(source, () => body(source));
+    // total_changes does not rewind on rollback, including ROLLBACK TO a
+    // savepoint. Never reuse or retain a projection of uncommitted state.
+    if (source.adapter.capabilities.backup?.inTransaction(source.db) !== false) {
+        // Without transaction inspection the caller may have no snapshot yet.
+        // Keep claims and edges coherent even if a peer commits during copying.
+        return readSnapshot(source, () => {
+            const projection = buildProjection(source, maximum, revisionOf(source));
+            return withReadCleanup(() => body(projection.store), () => projection.store.close(), 'CAVE view projection failed and close also failed');
+        });
+    }
+    return body(projectionOf(source, maximum));
+};
 //# sourceMappingURL=scope.js.map

package/dist/internal/view/scope.js.map

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

package/dist/internal/view/sensitivity.d.ts

@@ -0,0 +1,4 @@
+import { Sensitivity } from '@cavelang/store';
+/** Validate a caller-selected ceiling before projection or listener work. */
+export declare const maximumSensitivity: (value: unknown) => Sensitivity.Level;
+//# sourceMappingURL=sensitivity.d.ts.map

package/dist/internal/view/sensitivity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sensitivity.d.ts","sourceRoot":"","sources":["../../src/sensitivity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAE7C,6EAA6E;AAC7E,eAAO,MAAM,kBAAkB,GAAI,OAAO,OAAO,KAAG,WAAW,CAAC,KAM/D,CAAA"}

package/dist/internal/view/sensitivity.js

@@ -0,0 +1,11 @@
+import { Sensitivity } from '@cavelang/store';
+/** Validate a caller-selected ceiling before projection or listener work. */
+export const maximumSensitivity = (value) => {
+    if (value === undefined)
+        return Sensitivity.defaultMaximum;
+    if (typeof value !== 'string' || Sensitivity.parse(value) === undefined) {
+        throw new TypeError(`maxSensitivity must be one of: ${Sensitivity.levels.join(', ')}`);
+    }
+    return value;
+};
+//# sourceMappingURL=sensitivity.js.map

package/dist/internal/view/sensitivity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sensitivity.js","sourceRoot":"","sources":["../../src/sensitivity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAE7C,6EAA6E;AAC7E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAc,EAAqB,EAAE;IACtE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC,cAAc,CAAA;IAC1D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC;QACxE,MAAM,IAAI,SAAS,CAAC,kCAAkC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACxF,CAAC;IACD,OAAO,KAA0B,CAAA;AACnC,CAAC,CAAA"}

package/dist/internal/view/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAmB,MAAM,EAAkB,MAAM,WAAW,CAAA;AAExE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAI5C,gCAAgC;AAChC,eAAO,MAAM,WAAW,OAAO,CAAA;AAC/B,eAAO,MAAM,WAAW,cAAc,CAAA;AAEtC,MAAM,MAAM,YAAY,GAAG;IACzB,wEAAwE;IACxE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,wEAAwE;IACxE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,iEAAiE;IACjE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,wEAAwE;IACxE,QAAQ,CAAC,cAAc,CAAC,EAAE,WAAW,CAAC,KAAK,CAAA;CAC5C,CAAA;AAED,MAAM,MAAM,MAAM,GAAG;IACnB,kEAAkE;IAClE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB,CAAA;AA+GD,gEAAgE;AAChE,eAAO,MAAM,KAAK,GAAI,OAAO,KAAK,EAAE,UAAS,YAAiB,KAAG,OAAO,CAAC,MAAM,CAsB9E,CAAA"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAmB,MAAM,EAAkB,MAAM,WAAW,CAAA;AAExE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAK5C,gCAAgC;AAChC,eAAO,MAAM,WAAW,OAAO,CAAA;AAC/B,eAAO,MAAM,WAAW,cAAc,CAAA;AAEtC,MAAM,MAAM,YAAY,GAAG;IACzB,wEAAwE;IACxE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,wEAAwE;IACxE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,iEAAiE;IACjE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,wEAAwE;IACxE,QAAQ,CAAC,cAAc,CAAC,EAAE,WAAW,CAAC,KAAK,CAAA;CAC5C,CAAA;AAED,MAAM,MAAM,MAAM,GAAG;IACnB,kEAAkE;IAClE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB,CAAA;AAyID,gEAAgE;AAChE,eAAO,MAAM,KAAK,GAAI,OAAO,KAAK,EAAE,UAAS,YAAiB,KAAG,OAAO,CAAC,MAAM,CAgC9E,CAAA"}

package/dist/internal/view/server.js

@@ -8,11 +8,13 @@
  * Binds 127.0.0.1 by default: the store is one person's knowledge on
  * one machine (§19), and serving it wider is an explicit `--host` act.
  */
+import { maximumSensitivity } from "./sensitivity.js";
 import { createServer } from 'node:http';
 import { Version } from '@cavelang/core';
 import { Sensitivity } from '@cavelang/store';
 import { entity, history, lineage, overview, search, topic } from "./api.js";
 import { page } from "./page.js";
+import { errorMessage } from "./error-message.js";
 /** `cave` on a phone keypad. */
 export const defaultPort = 2283;
 export const defaultHost = '127.0.0.1';
@@ -25,24 +27,39 @@ const json = (res, status, body) => {
     });
     res.end(JSON.stringify(body));
 };
+const requiredParameters = new Map([
+    ['/api/entity', 'name'], ['/api/topic', 'name'], ['/api/history', 'key'],
+    ['/api/lineage', 'id'], ['/api/search', 'q']
+]);
 /** A required query parameter, `undefined` when absent or blank. */
 const param = (url, name) => {
     const value = url.searchParams.get(name);
     return value === null || value === '' ? undefined : value;
 };
 const handler = (store, label, maximum) => {
-    const html = page
-        .replaceAll('__CAVE_DB__', escapeHtml(label))
-        .replaceAll('__CAVE_VERSION__', escapeHtml(Version.current()))
-        .replaceAll('__CAVE_SENSITIVITY__', escapeHtml(maximum));
+    const values = {
+        DB: label, VERSION: Version.current(), SENSITIVITY: maximum
+    };
+    const html = page.replace(/__CAVE_(DB|VERSION|SENSITIVITY)__/g, (_marker, name) => escapeHtml(values[name]));
     return (req, res) => {
         try {
             if (req.method !== 'GET' && req.method !== 'HEAD') {
-                res.writeHead(405, { allow: 'GET, HEAD', 'content-type': 'application/json; charset=utf-8' });
-                res.end(req.method === 'HEAD' ? undefined : JSON.stringify({ error: 'read-only surface — GET only (spec §30.3)' }));
+                res.setHeader('allow', 'GET, HEAD');
+                json(res, 405, { error: 'read-only surface — GET/HEAD only (spec §30.3)' });
+                return;
+            }
+            let url;
+            try {
+                url = new URL(req.url ?? '/', 'http://cave.local');
+                // URLSearchParams replaces malformed UTF-8 instead of rejecting it.
+                // Validate the encoded query first, without decoding its delimiters
+                // or double-decoding values passed to the normal parameter parser.
+                decodeURIComponent(url.search);
+            }
+            catch {
+                json(res, 400, { error: 'invalid request URL' });
                 return;
             }
-            const url = new URL(req.url ?? '/', 'http://cave.local');
             const head = req.method === 'HEAD';
             if (url.pathname === '/') {
                 res.writeHead(200, {
@@ -60,7 +77,17 @@ const handler = (store, label, maximum) => {
                 json(res, 404, { error: `no such path: ${url.pathname}` });
                 return;
             }
-            const aliases = url.searchParams.get('aliases') === '1';
+            const required = requiredParameters.get(url.pathname);
+            if (required !== undefined && url.searchParams.getAll(required).length > 1) {
+                json(res, 400, { error: `${required} must be supplied at most once` });
+                return;
+            }
+            const aliasValues = url.searchParams.getAll('aliases');
+            if (aliasValues.length > 1 || aliasValues.some(value => value !== '0' && value !== '1')) {
+                json(res, 400, { error: 'aliases must be supplied at most once as 0 or 1' });
+                return;
+            }
+            const aliases = aliasValues[0] === '1';
             const body = (() => {
                 switch (url.pathname) {
                     case '/api/overview':
@@ -99,6 +126,9 @@ const handler = (store, label, maximum) => {
                     }
                     case '/api/search': {
                         const text = param(url, 'q');
+                        if (text?.includes('\0')) {
+                            return { status: 400, body: { error: 'search query must not contain NUL characters' } };
+                        }
                         return text === undefined ?
                             { status: 400, body: { error: 'search requires ?q=' } } :
                             { status: 200, body: search(store, text, { maxSensitivity: maximum }) };
@@ -107,33 +137,40 @@ const handler = (store, label, maximum) => {
                         return { status: 404, body: { error: `no such endpoint: ${url.pathname}` } };
                 }
             })();
-            if (head) {
-                res.writeHead(body.status, { 'content-type': 'application/json; charset=utf-8' });
-                res.end();
-                return;
-            }
+            // Node suppresses HEAD bodies; retain the same cache and content headers
+            // as GET, including validation errors and unknown endpoints.
             json(res, body.status, body.body);
         }
         catch (error) {
-            json(res, 500, { error: error instanceof Error ? error.message : String(error) });
+            json(res, 500, { error: errorMessage(error) });
         }
     };
 };
 /** Starts the read surface; resolves once the port is bound. */
 export const serve = (store, options = {}) => {
-    const host = options.host ?? defaultHost;
-    const server = createServer(handler(store, options.label ?? 'cave.db', options.maxSensitivity ?? Sensitivity.defaultMaximum));
+    const { port = defaultPort } = options;
+    if (!Number.isInteger(port) || port < 0 || port > 65535) {
+        throw new TypeError('port must be an integer in 0..65535');
+    }
+    const maximum = maximumSensitivity(options.maxSensitivity);
+    const { host = defaultHost } = options;
+    if (typeof host !== 'string' || host.trim() === '') {
+        throw new TypeError('host must be a non-empty string');
+    }
+    const server = createServer(handler(store, options.label ?? 'cave.db', maximum));
     return new Promise((resolve, reject) => {
         server.once('error', reject);
-        server.listen(options.port ?? defaultPort, host, () => {
+        server.listen(port, host, () => {
+            server.removeListener('error', reject);
             const address = server.address();
-            const port = typeof address === 'object' && address !== null ? address.port : options.port ?? defaultPort;
+            const boundPort = typeof address === 'object' && address !== null ? address.port : port;
             // Bracket IPv6 hosts; the default is IPv4 loopback.
             const shown = host.includes(':') ? `[${host}]` : host;
+            let closing;
             resolve({
-                url: `http://${shown}:${port}/`,
+                url: `http://${shown}:${boundPort}/`,
                 server,
-                close: () => new Promise((done, fail) => server.close(error => error === undefined ? done() : fail(error)))
+                close: () => closing ??= new Promise((done, fail) => server.close(error => error === undefined ? done() : fail(error)))
             });
         });
     });

package/dist/internal/view/server.js.map

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

package/dist/src/atomic-output.d.ts

@@ -0,0 +1,3 @@
+/** Publish complete text; failures before rename leave the destination intact. */
+export declare const writeOutput: (path: string, text: string) => void;
+//# sourceMappingURL=atomic-output.d.ts.map

package/dist/src/atomic-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-output.d.ts","sourceRoot":"","sources":["../../src/atomic-output.ts"],"names":[],"mappings":"AAIA,kFAAkF;AAClF,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,EAAE,MAAM,MAAM,KAAG,IAyCxD,CAAA"}

package/dist/src/atomic-output.js

@@ -0,0 +1,67 @@
+import fs from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { errorMessage } from "./error-message.js";
+/** Publish complete text; failures before rename leave the destination intact. */
+export const writeOutput = (path, text) => {
+    let target = resolve(path);
+    let mode;
+    let entry;
+    try {
+        entry = fs.lstatSync(target);
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT')
+            throw error;
+    }
+    if (entry !== undefined) {
+        // Follow existing symlinks without replacing the link itself. A dangling
+        // link fails resolution rather than publishing over an unexpected path.
+        if (entry.isSymbolicLink())
+            target = fs.realpathSync(target);
+        const stat = fs.statSync(target);
+        if (!stat.isFile())
+            throw new Error(`output destination is not a regular file: ${path}`);
+        fs.accessSync(target, fs.constants.W_OK);
+        mode = stat.mode & 0o777;
+    }
+    const directory = fs.mkdtempSync(join(dirname(target), '.cave-export-'));
+    const temporary = join(directory, 'output');
+    const errors = [];
+    let published = false;
+    try {
+        const fd = fs.openSync(temporary, 'wx', mode ?? 0o666);
+        try {
+            fs.writeFileSync(fd, text);
+            if (mode !== undefined)
+                fs.fchmodSync(fd, mode);
+            fs.fsyncSync(fd);
+        }
+        catch (error) {
+            errors.push(error);
+        }
+        try {
+            fs.closeSync(fd);
+        }
+        catch (error) {
+            errors.push(error);
+        }
+        if (errors.length === 0) {
+            fs.renameSync(temporary, target);
+            published = true;
+        }
+    }
+    catch (error) {
+        errors.push(error);
+    }
+    try {
+        fs.rmSync(directory, { recursive: true, force: true });
+    }
+    catch (error) {
+        errors.push(published ? new Error(`output published to ${target}, but temporary directory cleanup failed: ${directory}: ${errorMessage(error)}`, { cause: error }) : error);
+    }
+    if (errors.length === 1)
+        throw errors[0];
+    if (errors.length > 1)
+        throw new AggregateError(errors, `file output failed: ${errors.map(error => errorMessage(error)).join('; ')}`, { cause: errors[0] });
+};
+//# sourceMappingURL=atomic-output.js.map

package/dist/src/atomic-output.js.map

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

package/dist/src/cli.d.ts

@@ -34,6 +34,7 @@
  * `file` defaults to stdin (`-`); `--db` defaults to `$CAVE_DB`, then
  * `cave.db`. Every command answers `--help` with options and examples.
  */
+import { Declared } from '@cavelang/cli/connect';
 export type Output = {
     readonly code: number;
     readonly out: string;
@@ -62,6 +63,19 @@ export declare const addCommand: (argv: readonly string[]) => Output;
  * identity.
  */
 export declare const importCommand: (argv: readonly string[]) => Output;
+/**
+ * `cave query --sources` — the store with its declared sources overlaid
+ * (spec §23.4). Asynchronous because the sources load first, URLs
+ * included, before the overlay appends inside a transaction that rolls
+ * back; the dispatcher routes `--sources` here. A text store followed its
+ * local sources on open, so only what assembly could not follow — URL
+ * sources and what they declare — is loaded. The overlay exists for this
+ * invocation alone, so the answer is whole: pages are followed inside the
+ * transaction and no cursor is handed out.
+ */
+export declare const querySourcesCommand: (argv: readonly string[], runtime?: {
+    readonly fetchImpl?: Declared.DiscoverOptions["fetchImpl"];
+}) => Promise<Output>;
 export declare const queryCommand: (argv: readonly string[]) => Output;
 export declare const searchFormat: "cave.search";
 export declare const searchVersion: 1;
@@ -101,8 +115,9 @@ export declare const suggestAliasCommand: (argv: readonly string[], runtime?: {
 export declare const syncCommand: (argv: readonly string[]) => Output;
 /**
  * `cave report` — the §31 deliverable: a markdown template's cave-q
- * blocks and inline splices render from the store, every stated fact
- * cited back to its claim. Problems mark the text, land on stderr with
+ * blocks and inline splices render from the store, with matched rows
+ * cited back to their claims. Ordinary prose is not automatically checked
+ * or cited. Problems mark the text, land on stderr with
  * template line numbers, and fail the exit code — the render never
  * silently drops a fact.
  */

package/dist/src/cli.d.ts.map

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